diff --git a/CHANGES.md b/CHANGES.md
index 874f0e5..d51bdb4 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,3 +1,273 @@
+## v2.48.0
+
+* Node v0.12.x users must run with --harmony. _This is the last release that
+    will support v0.12.x_
+* FIXED: (Promise/A+ compliance) When a promise is rejected with a thenable,
+    the promise adopts the thenable as its rejection reason instead of waiting
+    for it to settle. The previous (incorrect) behavior was hidden by bugs in
+    the `promises-aplus-tests` compliance test suite that were fixed in version
+    `2.1.1`.
+* FIXED: the `webdriver.promise.ControlFlow` now has a consistent execution
+    order for tasks/callbacks scheduled in different turns of the JS event loop.
+    Refer to the `webdriver.promise` documentation for more details.
+* FIXED: do not drop user auth from the WebDriver server URL.
+* FIXED: a single `firefox.Binary` instance may be used to configure and
+    launch multiple FirefoxDriver sessions.
+
+      var binary = new firefox.Binary();
+      var options = new firefox.Options().setBinary(binary);
+      var builder = new Builder().setFirefoxOptions(options);
+
+      var driver1 = builder.build();
+      var driver2 = builder.build();
+
+* FIXED: zip files created for transfer to a remote WebDriver server are no
+    longer compressed. If the zip contained a file that was already compressed,
+    the server would return an "invalid code lengths set" error.
+* FIXED: Surfaced the `loopback` option to `remote/SeleniumServer`. When set,
+    the server will be accessed using the current host's loopback address.
+
+## v2.47.0
+
+### Notice
+
+This is the last release for `selenium-webdriver` that will support ES5.
+Subsequent releases will depend on ES6 features that are enabled by
+[default](https://nodejs.org/en/docs/es6/) in Node v4.0.0. Node v0.12.x will
+continue to be supported, but will require setting the `--harmony` flag.
+
+### Change Summary
+
+* Add support for [Node v4.0.0](https://nodejs.org/en/blog/release/v4.0.0/)
+    * Updated `ws` dependency from `0.7.1` to `0.8.0`
+* Bumped the minimum supported version of Node from `0.10.x` to `0.12.x`. This
+    is in accordance with the Node support policy established in `v2.45.0`.
+
+## v2.46.1
+
+* Fixed internal module loading on Windows.
+* Fixed error message format on timeouts for `until.elementLocated()`
+    and `until.elementsLocated()`.
+
+## v2.46.0
+
+* Exposed a new logging API via the `webdriver.logging` module. For usage, see
+    `example/logging.js`.
+* Added support for using a proxy server for WebDriver commands.
+    See `Builder#usingWebDriverProxy()` for more info.
+* Removed deprecated functions:
+    * Capabilities#toJSON()
+    * UnhandledAlertError#getAlert()
+    * chrome.createDriver()
+    * phantomjs.createDriver()
+    * promise.ControlFlow#annotateError()
+    * promise.ControlFlow#await()
+    * promise.ControlFlow#clearHistory()
+    * promise.ControlFlow#getHistory()
+* Removed deprecated enum values: `ErrorCode.NO_MODAL_DIALOG_OPEN` and
+    `ErrorCode.MODAL_DIALOG_OPENED`. Use `ErrorCode.NO_SUCH_ALERT` and
+    `ErrorCode.UNEXPECTED_ALERT_OPEN`, respectively.
+* FIXED: The `promise.ControlFlow` will maintain state for promise chains
+    generated in a loop.
+* FIXED: Correct serialize target elements used in an action sequence.
+* FIXED: `promise.ControlFlow#wait()` now has consistent semantics for an
+    omitted or 0-timeout: it will wait indefinitely.
+* FIXED: `remote.DriverService#start()` will now fail if the child process dies
+    while waiting for the server to start accepting requests. Previously, start
+    would continue to poll the server address until the timeout expired.
+* FIXED: Skip launching Firefox with the `-silent` flag to preheat the profile.
+    Starting with Firefox 38, this would cause the browser to crash. This step,
+    which was first introduced for Selenium's java client back with Firefox 2,
+    no longer appears to be required.
+* FIXED: 8564: `firefox.Driver#quit()` will wait for the Firefox process to
+    terminate before deleting the temporary webdriver profile. This eliminates a
+    race condition where Firefox would write profile data during shutdown,
+    causing the `rm -rf` operation on the profile directory to fail.
+
+## v2.45.1
+
+* FIXED: 8548: Task callbacks are once again dropped if the task was cancelled
+    due to a previously uncaught error within the frame.
+* FIXED: 8496: Extended the `chrome.Options` API to cover all configuration
+    options (e.g. mobile emulation and performance logging) documented on the
+    ChromeDriver [project site](https://sites.google.com/a/chromium.org/chromedriver/capabilities).
+
+## v2.45.0
+
+### Important Policy Change
+
+Starting with the 2.45.0 release, selenium-webdriver will support the last
+two stable minor releases for Node. For 2.45.0, this means Selenium will
+support Node 0.10.x and 0.12.x. Support for the intermediate, un-stable release
+(0.11.x) is "best-effort". This policy will be re-evaluated once Node has a
+major version release (i.e. 1.0.0).
+
+### Change Summary
+
+* Added native browser support for Internet Explorer, Opera 26+, and Safari
+* With the release of [Node 0.12.0](http://blog.nodejs.org/2015/02/06/node-v0-12-0-stable/)
+    (finally!), the minimum supported version of Node is now `0.10.x`.
+* The `promise` module is now [Promises/A+](https://promisesaplus.com/)
+    compliant. The biggest compliance change is that promise callbacks are now
+    invoked in a future turn of the JS event loop. For example:
+
+        var promise = require('selenium-webdriver').promise;
+        console.log('start');
+        promise.fulfilled().then(function() {
+          console.log('middle');
+        });
+        console.log('end');
+
+        // Output in selenium-webdriver@2.44.0
+        // start
+        // middle
+        // end
+        //
+        // Output in selenium-webdriver@2.45.0
+        // start
+        // end
+        // middle
+
+    The `promise.ControlFlow` class has been updated to track the asynchronous
+    breaks required by Promises/A+, so there are no changes to task execution
+    order.
+* Updated how errors are annotated on failures. When a task fails, the
+    stacktrace from when that task was scheduled is appended to the rejection
+    reason with a `From: ` prefix (if it is an Error object). For example:
+
+        var driver = new webdriver.Builder().forBrowser('chrome').build();
+        driver.get('http://www.google.com/ncr');
+        driver.call(function() {
+          driver.wait(function() {
+            return driver.isElementPresent(webdriver.By.id('not-there'));
+          }, 2000, 'element not found');
+        });
+
+    This code will fail an error like:
+
+        Error: element not found
+        Wait timed out after 2002ms
+            at <stack trace>
+        From: Task: element not found
+            at <stack trace>
+        From: Task: WebDriver.call(function)
+            at <stack trace>
+
+* Changed the format of strings returned by `promise.ControlFlow#getSchedule`.
+    This function now accepts a boolean to control whether the returned string
+    should include the stacktraces for when each task was scheduled.
+* Deprecating `promise.ControlFlow#getHistory`,
+    `promise.ControlFlow#clearHistory`, and `promise.ControlFlow#annotateError`.
+    These functions were all intended for internal use and are no longer
+    necessary, so they have been made no-ops.
+* `WebDriver.wait()` may now be used to wait for a promise to resolve, with
+    an optional timeout. Refer to the API documentation for more information.
+* Added support for copying files to a remote Selenium via `sendKeys` to test
+    file uploads. Refer to the API documentation for more information. Sample
+    usage included in `test/upload_test.js`
+* Expanded the interactions API to include touch actions.
+    See `WebDriver.touchActions()`.
+* FIXED: 8380: `firefox.Driver` will delete its temporary profile on `quit`.
+* FIXED: 8306: Stack overflow in promise callbacks eliminated.
+* FIXED: 8221: Added support for defining custom command mappings. Includes
+    support for PhantomJS's `executePhantomJS` (requires PhantomJS 1.9.7 or
+    GhostDriver 1.1.0).
+* FIXED: 8128: When the FirefoxDriver marshals an object to the page for
+    `executeScript`, it defines additional properties (required by the driver's
+    implementation). These properties will no longer be enumerable and should
+    be omitted (i.e. they won't show up in JSON.stringify output).
+* FIXED: 8094: The control flow will no longer deadlock when a task returns
+    a promise that depends on the completion of sub-tasks.
+
+## v2.44.0
+
+* Added the `until` module, which defines common explicit wait conditions.
+    Sample usage:
+
+        var firefox = require('selenium-webdriver/firefox'),
+            until = require('selenium-webdriver/until');
+
+        var driver = new firefox.Driver();
+        driver.get('http://www.google.com/ncr');
+        driver.wait(until.titleIs('Google Search'), 1000);
+
+* FIXED: 8000: `Builder.forBrowser()` now accepts an empty string since some
+    WebDriver implementations ignore the value. A value must still be specified,
+    however, since it is a required field in WebDriver's wire protocol.
+* FIXED: 7994: The `stacktrace` module will not modify stack traces if the
+    initial parse fails (e.g. the user defined `Error.prepareStackTrace`)
+* FIXED: 5855: Added a module (`until`) that defines several common conditions
+    for use with explicit waits. See updated examples for usage.
+
+## v2.43.5
+
+* FIXED: 7905: `Builder.usingServer(url)` once again returns `this` for
+    chaining.
+
+## v2.43.2-4
+
+* No changes; version bumps while attempting to work around an issue with
+    publishing to npm (a version string may only be used once).
+
+## v2.43.1
+
+* Fixed an issue with flakiness when setting up the Firefox profile that could
+    prevent the driver from initializing properly.
+
+## v2.43.0
+
+* Added native support for Firefox - the Java Selenium server is no longer
+    required.
+* Added support for generator functions to `ControlFlow#execute` and
+    `ControlFlow#wait`. For more information, see documentation on
+    `webdriver.promise.consume`. Requires harmony support (run with
+    `node --harmony-generators` in `v0.11.x`).
+* Various improvements to the `Builder` API. Notably, the `build()` function
+    will no longer default to attempting to use a server at
+    `http://localhost:4444/wd/hub` if it cannot start a browser directly -
+    you must specify the WebDriver server with `usingServer(url)`. You can
+    also set the target browser and WebDriver server through a pair of
+    environment variables. See the documentation on the `Builder` constructor
+    for more information.
+* For consistency with the other language bindings, added browser specific
+    classes that can be used to start a browser without the builder.
+
+        var webdriver = require('selenium-webdriver')
+            chrome = require('selenium-webdriver/chrome');
+
+        // The following are equivalent.
+        var driver1 = new webdriver.Builder().forBrowser('chrome').build();
+        var driver2 = new chrome.Driver();
+
+* Promise A+ compliance: a promise may no longer resolve to itself.
+* For consistency with other language bindings, deprecated
+    `UnhandledAlertError#getAlert` and added `#getAlertText`.
+    `getAlert` will be removed in `2.45.0`.
+* FIXED: 7641: Deprecated `ErrorCode.NO_MODAL_DIALOG_OPEN` and
+    `ErrorCode.MODAL_DIALOG_OPENED` in favor of the new
+    `ErrorCode.NO_SUCH_ALERT` and `ErrorCode.UNEXPECTED_ALERT_OPEN`,
+    respectively.
+* FIXED: 7563: Mocha integration no longer disables timeouts. Default Mocha
+    timeouts apply (2000 ms) and may be changed using `this.timeout(ms)`.
+* FIXED: 7470: Make it easier to create WebDriver instances in custom flows for
+    parallel execution.
+
+## v2.42.1
+
+* FIXED: 7465: Fixed `net.getLoopbackAddress` on Windows
+* FIXED: 7277: Support `done` callback in Mocha's BDD interface
+* FIXED: 7156: `Promise#thenFinally` should not suppress original error
+
+## v2.42.0
+
+* Removed deprecated functions `Promise#addCallback()`,
+    `Promise#addCallbacks()`, `Promise#addErrback()`, and `Promise#addBoth()`.
+* Fail with a more descriptive error if the server returns a malformed redirect
+* FIXED: 7300: Connect to ChromeDriver using the loopback address since
+    ChromeDriver 2.10.267517 binds to localhost by default.
+* FIXED: 7339: Preserve wrapped test function's string representation for
+    Mocha's BDD interface.
+
 ## v2.41.0
 
 * FIXED: 7138: export logging API from webdriver module.
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..d645695
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/NOTICE b/NOTICE
new file mode 100644
index 0000000..38f6e61
--- /dev/null
+++ b/NOTICE
@@ -0,0 +1,2 @@
+Copyright 2011-2015 Software Freedom Conservancy
+Copyright 2004-2011 Selenium committers
diff --git a/README.md b/README.md
index c31e4de..a1e64b6 100644
--- a/README.md
+++ b/README.md
@@ -1,75 +1,100 @@
 # browserstack-webdriver
 
+Selenium is a browser automation library. Most often used for testing
+web-applications, Selenium may be used for any task that requires automating
+interaction with the browser.
+
 ## Installation
 
-Install the latest published version using `npm`:
+Install via npm with
 
     npm install browserstack-webdriver
 
-In addition to the npm package, you will to download the WebDriver
-implementations you wish to utilize. As of 2.34.0, `browserstack-webdriver`
-natively supports the [ChromeDriver](http://chromedriver.storage.googleapis.com/index.html).
-Simply download a copy and make sure it can be found on your `PATH`. The other
-drivers (e.g. Firefox, Internet Explorer, and Safari), still require the
-[standalone Selenium server](http://selenium-release.storage.googleapis.com/index.html).
-
-### Running the tests
-
-To run the tests, you will need to download a copy of the
-[ChromeDriver](http://chromedriver.storage.googleapis.com/index.html) and make
-sure it can be found on your `PATH`.
-
-    npm test browserstack-webdriver
-
-To run the tests against multiple browsers, download the
-[Selenium server](http://selenium-release.storage.googleapis.com/index.html) and
-specify its location through the `SELENIUM_SERVER_JAR` environment variable.
-You can use the `SELENIUM_BROWSER` environment variable to define a
-comma-separated list of browsers you wish to test against. For example:
-
-    export SELENIUM_SERVER_JAR=path/to/selenium-server-standalone-2.33.0.jar
-    SELENIUM_BROWSER=chrome,firefox npm test browserstack-webdriver
-
 ## Usage
 
+Below code is a sample test, which opens Google's homepage, searches for ‘browserstack’, and asks for the title of the search results page.
 
     var webdriver = require('browserstack-webdriver');
-
+    
+    // Input capabilities
+    var capabilities = {
+        'browserName' : 'firefox', 
+        'browserstack.user' : BROWSERSTACK_USERNAME,
+        'browserstack.key' : BROWSERSTACK_KEY
+    }
+    
     var driver = new webdriver.Builder().
-        withCapabilities(webdriver.Capabilities.chrome()).
-        build();
-
-    driver.get('http://www.google.com');
-    driver.findElement(webdriver.By.name('q')).sendKeys('webdriver');
+      usingServer('http://hub.browserstack.com/wd/hub').
+      withCapabilities(capabilities).
+      build();
+    
+    driver.get('http://www.google.com/ncr');
+    driver.findElement(webdriver.By.name('q')).sendKeys('BrowserStack');
     driver.findElement(webdriver.By.name('btnG')).click();
-    driver.wait(function() {
-      return driver.getTitle().then(function(title) {
-        return title === 'webdriver - Google Search';
-      });
-    }, 1000);
-
+    
+    driver.getTitle().then(function(title) {
+        console.log(title);
+    });
+    
     driver.quit();
 
 ## Documentation
 
-Full documentation is available on the [Selenium project wiki](http://code.google.com/p/selenium/wiki/WebDriverJs "User guide").
+API documentation is included in the `docs` directory and is also available
+online from the [Selenium project][api]. Addition resources include
+
+- the #selenium channel on freenode IRC
+- the [selenium-users@googlegroups.com][users] list
+- [SeleniumHQ](http://www.seleniumhq.org/docs/) documentation
 
 ## Issues
 
-Please report any issues using the [Selenium issue tracker](https://github.com/browserstack/selenium-webdriver-nodejs/issues).
+Please report any issues using the [Selenium issue tracker][issues]. When using
+the issue tracker
+
+- __Do__ include a detailed description of the problem.
+- __Do__ include a link to a [gist](http://gist.github.com/) with any
+    interesting stack traces/logs (you may also attach these directly to the bug
+    report).
+- __Do__ include a [reduced test case][reduction]. Reporting "unable to find
+    element on the page" is _not_ a valid report - there's nothing for us to
+    look into. Expect your bug report to be closed if you do not provide enough
+    information for us to investigate.
+- __Do not__ use the issue tracker to submit basic help requests. All help
+    inquiries should be directed to the [user forum][users] or #selenium IRC
+    channel.
+- __Do not__ post empty "I see this too" or "Any updates?" comments. These
+    provide no additional information and clutter the log.
+- __Do not__ report regressions on closed bugs as they are not actively
+    monitored for upates (especially bugs that are >6 months old). Please open a
+    new issue and reference the original bug in your report.
 
 ## License
 
-Copyright 2009-2014 Software Freedom Conservancy
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-     http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+Licensed to the Software Freedom Conservancy (SFC) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The SFC licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+
+[api]: http://selenium.googlecode.com/git/docs/api/javascript/index.html
+[cla]: http://goo.gl/qC50R
+[chrome]: http://chromedriver.storage.googleapis.com/index.html
+[gh]: https://github.com/SeleniumHQ/selenium/
+[issues]: https://github.com/SeleniumHQ/selenium/issues
+[opera]: https://github.com/operasoftware/operachromiumdriver/releases
+[phantomjs]: http://phantomjs.org/
+[reduction]: http://www.webkit.org/quality/reduction.html
+[release]: http://selenium-release.storage.googleapis.com/index.html
+[users]: https://groups.google.com/forum/#!forum/selenium-users
diff --git a/_base.js b/_base.js
index 6048179..6769c3c 100644
--- a/_base.js
+++ b/_base.js
@@ -1,17 +1,19 @@
-// Copyright 2012 Selenium committers
-// Copyright 2012 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview The base module responsible for bootstrapping the Closure
@@ -74,46 +76,78 @@ var DEPS_FILE_PATH = (function() {
 })();
 
 
-
 /**
- * Synchronously loads a script into the protected Closure context.
- * @param {string} src Path to the file to load.
+ * Maintains a unique context for Closure library-based code.
+ * @param {boolean=} opt_configureForTesting Whether to configure a fake DOM
+ *     for Closure-testing code that (incorrectly) assumes a DOM is always
+ *     present.
+ * @constructor
  */
-function loadScript(src) {
-  src = path.normalize(src);
-  var contents = fs.readFileSync(src, 'utf8');
-  vm.runInContext(contents, closure, src);
+function Context(opt_configureForTesting) {
+  var closure = this.closure = vm.createContext({
+    console: console,
+    setTimeout: setTimeout,
+    setInterval: setInterval,
+    clearTimeout: clearTimeout,
+    clearInterval: clearInterval,
+    process: process,
+    require: require,
+    Buffer: Buffer,
+    Error: Error,
+    TypeError: TypeError,
+    CLOSURE_BASE_PATH: path.dirname(CLOSURE_BASE_FILE_PATH) + '/',
+    CLOSURE_IMPORT_SCRIPT: function(src, opt_srcText) {
+      if (opt_srcText !== undefined) {
+        // Windows paths use backslashes, which must be properly escaped before
+        // evaluated with vm.runInContext.
+        opt_srcText = opt_srcText.replace(/\\/g, '/');
+        vm.runInContext(opt_srcText, closure, src);
+      } else {
+        loadScript(src);
+      }
+      return true;
+    },
+    CLOSURE_NO_DEPS: !isDevMode(),
+    CLOSURE_UNCOMPILED_DEFINES: {'goog.json.USE_NATIVE_JSON': true},
+    goog: {}
+  });
+  closure.window = closure.top = closure;
+
+  if (opt_configureForTesting) {
+    closure.document = {
+      body: {},
+      createElement: function() { return {}; },
+      getElementsByTagName: function() { return []; }
+    };
+    closure.document.body.ownerDocument = closure.document;
+  }
+
+  loadScript(CLOSURE_BASE_FILE_PATH);
+  loadScript(DEPS_FILE_PATH);
+
+  // Redefine retrieveAndExecModule_ to load modules. Closure's version
+  // assumes XMLHttpRequest is defined (and by extension that scripts
+  // are being loaded from a server).
+  closure.goog.retrieveAndExecModule_ = function(src) {
+    var normalizedSrc = path.normalize(src);
+    var contents = fs.readFileSync(normalizedSrc, 'utf8');
+    contents = closure.goog.wrapModule_(src, contents);
+    vm.runInContext(contents, closure, normalizedSrc);
+  };
+
+  /**
+   * Synchronously loads a script into the protected Closure context.
+   * @param {string} src Path to the file to load.
+   */
+  function loadScript(src) {
+    src = path.normalize(src);
+    var contents = fs.readFileSync(src, 'utf8');
+    vm.runInContext(contents, closure, src);
+  }
 }
 
 
-/**
- * The protected context to host the Closure library.
- * @type {!Object}
- * @const
- */
-var closure = vm.createContext({
-  console: console,
-  setTimeout: setTimeout,
-  setInterval: setInterval,
-  clearTimeout: clearTimeout,
-  clearInterval: clearInterval,
-  process: process,
-  require: require,
-  Buffer: Buffer,
-  Error: Error,
-  CLOSURE_BASE_PATH: path.dirname(CLOSURE_BASE_FILE_PATH) + '/',
-  CLOSURE_IMPORT_SCRIPT: function(src) {
-    loadScript(src);
-    return true;
-  },
-  CLOSURE_NO_DEPS: !isDevMode(),
-  goog: {}
-});
-closure.window = closure;
-
-
-loadScript(CLOSURE_BASE_FILE_PATH);
-loadScript(DEPS_FILE_PATH);
+var context = new Context();
 
 
 /**
@@ -123,8 +157,8 @@ loadScript(DEPS_FILE_PATH);
  * @throws {Error} If the symbol has not been defined.
  */
 function closureRequire(symbol) {
-  closure.goog.require(symbol);
-  return closure.goog.getObjectByName(symbol);
+  context.closure.goog.require(symbol);
+  return context.closure.goog.getObjectByName(symbol);
 }
 
 
@@ -159,7 +193,8 @@ exports.exportPublicApi = function(symbol) {
 
 
 if (isDevMode()) {
-  exports.closure = closure;
+  exports.closure = context.closure;
 }
+exports.Context = Context;
 exports.isDevMode = isDevMode;
 exports.require = closureRequire;
diff --git a/builder.js b/builder.js
index fc2f40b..788e6f4 100644
--- a/builder.js
+++ b/builder.js
@@ -1,109 +1,492 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 var base = require('./_base'),
     executors = require('./executors');
 
-var goog = base.require('goog'),
-    AbstractBuilder = base.require('webdriver.AbstractBuilder'),
-    Browser = base.require('webdriver.Browser'),
+// Use base.require to avoid circular references between index and this module.
+var Browser = base.require('webdriver.Browser'),
+    Capabilities = base.require('webdriver.Capabilities'),
     Capability = base.require('webdriver.Capability'),
     WebDriver = base.require('webdriver.WebDriver'),
     promise = base.require('webdriver.promise');
 
 
-/**
- * @param {!webdriver.Capabilities} capabilities The desired capabilities.
- * @return {webdriver.WebDriver} A new WebDriver instance or {@code null}
- *     if the requested browser is not natively supported in Node.
- */
-function createNativeDriver(capabilities) {
-  switch (capabilities.get(Capability.BROWSER_NAME)) {
-    case Browser.CHROME:
-      // Requiring 'chrome' above would create a cycle:
-      // index -> builder -> chrome -> index
-      var chrome = require('./chrome');
-      return chrome.createDriver(capabilities);
 
-    case Browser.PHANTOM_JS:
-      // Requiring 'phantomjs' would create a cycle:
-      // index -> builder -> phantomjs -> index
-      var phantomjs = require('./phantomjs');
-      return phantomjs.createDriver(capabilities);
+var seleniumServer;
 
-    default:
-      return null;
+/**
+ * Starts an instance of the Selenium server if not yet running.
+ * @param {string} jar Path to the server jar to use.
+ * @return {!webdriver.promise.Promise<string>} A promise for the server's
+ *     addrss once started.
+ */
+function startSeleniumServer(jar) {
+  if (!seleniumServer) {
+    // Requiring 'chrome' above would create a cycle:
+    // index -> builder -> chrome -> index
+    var remote = require('./remote');
+    seleniumServer = new remote.SeleniumServer(jar);
   }
+  return seleniumServer.start();
 }
 
 
-
 /**
- * Creates new {@link webdriver.WebDriver WebDriver} instances.
+ * Creates new {@link webdriver.WebDriver WebDriver} instances. The environment
+ * variables listed below may be used to override a builder's configuration,
+ * allowing quick runtime changes.
+ *
+ * - {@code SELENIUM_BROWSER}: defines the target browser in the form
+ *   {@code browser[:version][:platform]}.
+ *
+ * - {@code SELENIUM_REMOTE_URL}: defines the remote URL for all builder
+ *   instances. This environment variable should be set to a fully qualified
+ *   URL for a WebDriver server (e.g. http://localhost:4444/wd/hub). This
+ *   option always takes precedence over {@code SELENIUM_SERVER_JAR}.
+ *
+ * - {@code SELENIUM_SERVER_JAR}: defines the path to the
+ *   <a href="http://selenium-release.storage.googleapis.com/index.html">
+ *   standalone Selenium server</a> jar to use. The server will be started the
+ *   first time a WebDriver instance and be killed when the process exits.
+ *
+ * Suppose you had mytest.js that created WebDriver with
+ *
+ *     var driver = new webdriver.Builder()
+ *         .forBrowser('chrome')
+ *         .build();
+ *
+ * This test could be made to use Firefox on the local machine by running with
+ * `SELENIUM_BROWSER=firefox node mytest.js`. Rather than change the code to
+ * target Google Chrome on a remote machine, you can simply set the
+ * `SELENIUM_BROWSER` and `SELENIUM_REMOTE_URL` environment variables:
+ *
+ *     SELENIUM_BROWSER=chrome:36:LINUX \
+ *     SELENIUM_REMOTE_URL=http://www.example.com:4444/wd/hub \
+ *     node mytest.js
+ *
+ * You could also use a local copy of the standalone Selenium server:
+ *
+ *     SELENIUM_BROWSER=chrome:36:LINUX \
+ *     SELENIUM_SERVER_JAR=/path/to/selenium-server-standalone.jar \
+ *     node mytest.js
+ *
  * @constructor
- * @extends {webdriver.AbstractBuilder}
  */
 var Builder = function() {
-  goog.base(this);
+
+  /** @private {webdriver.promise.ControlFlow} */
+  this.flow_ = null;
+
+  /** @private {string} */
+  this.url_ = '';
+
+  /** @private {?string} */
+  this.proxy_ = null;
+
+  /** @private {!webdriver.Capabilities} */
+  this.capabilities_ = new Capabilities();
+
+  /** @private {chrome.Options} */
+  this.chromeOptions_ = null;
+
+  /** @private {firefox.Options} */
+  this.firefoxOptions_ = null;
+
+  /** @private {opera.Options} */
+  this.operaOptions_ = null;
+
+  /** @private {ie.Options} */
+  this.ieOptions_ = null;
+
+  /** @private {safari.Options} */
+  this.safariOptions_ = null;
+
+  /** @private {boolean} */
+  this.ignoreEnv_ = false;
+};
+
+
+/**
+ * Configures this builder to ignore any environment variable overrides and to
+ * only use the configuration specified through this instance's API.
+ *
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.disableEnvironmentOverrides = function() {
+  this.ignoreEnv_ = true;
+  return this;
+};
+
+
+/**
+ * Sets the URL of a remote WebDriver server to use. Once a remote URL has been
+ * specified, the builder direct all new clients to that server. If this method
+ * is never called, the Builder will attempt to create all clients locally.
+ *
+ * As an alternative to this method, you may also set the `SELENIUM_REMOTE_URL`
+ * environment variable.
+ *
+ * @param {string} url The URL of a remote server to use.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.usingServer = function(url) {
+  this.url_ = url;
+  return this;
+};
+
+
+/**
+ * @return {string} The URL of the WebDriver server this instance is configured
+ *     to use.
+ */
+Builder.prototype.getServerUrl = function() {
+  return this.url_;
+};
+
+
+/**
+ * Sets the URL of the proxy to use for the WebDriver's HTTP connections.
+ * If this method is never called, the Builder will create a connection without
+ * a proxy.
+ *
+ * @param {string} proxy The URL of a proxy to use.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.usingWebDriverProxy = function(proxy) {
+  this.proxy_ = proxy;
+  return this;
+};
+
+
+/**
+ * @return {string} The URL of the proxy server to use for the WebDriver's HTTP
+ *    connections.
+ */
+Builder.prototype.getWebDriverProxy = function() {
+  return this.proxy_;
+};
+
+
+/**
+ * Sets the desired capabilities when requesting a new session. This will
+ * overwrite any previously set capabilities.
+ * @param {!(Object|webdriver.Capabilities)} capabilities The desired
+ *     capabilities for a new session.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.withCapabilities = function(capabilities) {
+  this.capabilities_ = new Capabilities(capabilities);
+  return this;
+};
+
+
+/**
+ * Returns the base set of capabilities this instance is currently configured
+ * to use.
+ * @return {!webdriver.Capabilities} The current capabilities for this builder.
+ */
+Builder.prototype.getCapabilities = function() {
+  return this.capabilities_;
+};
+
+
+/**
+ * Configures the target browser for clients created by this instance.
+ * Any calls to {@link #withCapabilities} after this function will
+ * overwrite these settings.
+ *
+ * You may also define the target browser using the {@code SELENIUM_BROWSER}
+ * environment variable. If set, this environment variable should be of the
+ * form `browser[:[version][:platform]]`.
+ *
+ * @param {(string|webdriver.Browser)} name The name of the target browser;
+ *     common defaults are available on the {@link webdriver.Browser} enum.
+ * @param {string=} opt_version A desired version; may be omitted if any
+ *     version should be used.
+ * @param {string=} opt_platform The desired platform; may be omitted if any
+ *     version may be used.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.forBrowser = function(name, opt_version, opt_platform) {
+  this.capabilities_.set(Capability.BROWSER_NAME, name);
+  this.capabilities_.set(Capability.VERSION, opt_version || null);
+  this.capabilities_.set(Capability.PLATFORM, opt_platform || null);
+  return this;
 };
-goog.inherits(Builder, AbstractBuilder);
 
 
 /**
  * Sets the proxy configuration to use for WebDriver clients created by this
  * builder. Any calls to {@link #withCapabilities} after this function will
  * overwrite these settings.
- * @param {!proxy.ProxyConfig} config The configuration to use.
+ * @param {!webdriver.ProxyConfig} config The configuration to use.
  * @return {!Builder} A self reference.
  */
 Builder.prototype.setProxy = function(config) {
-  this.getCapabilities().set(Capability.PROXY, config);
+  this.capabilities_.setProxy(config);
   return this;
 };
 
 
 /**
- * Sets Chrome-specific options for drivers created by this builder.
+ * Sets the logging preferences for the created session. Preferences may be
+ * changed by repeated calls, or by calling {@link #withCapabilities}.
+ * @param {!(webdriver.logging.Preferences|Object.<string, string>)} prefs The
+ *     desired logging preferences.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setLoggingPrefs = function(prefs) {
+  this.capabilities_.setLoggingPrefs(prefs);
+  return this;
+};
+
+
+/**
+ * Sets whether native events should be used.
+ * @param {boolean} enabled Whether to enable native events.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setEnableNativeEvents = function(enabled) {
+  this.capabilities_.setEnableNativeEvents(enabled);
+  return this;
+};
+
+
+/**
+ * Sets how elements should be scrolled into view for interaction.
+ * @param {number} behavior The desired scroll behavior: either 0 to align with
+ *     the top of the viewport or 1 to align with the bottom.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setScrollBehavior = function(behavior) {
+  this.capabilities_.setScrollBehavior(behavior);
+  return this;
+};
+
+
+/**
+ * Sets the default action to take with an unexpected alert before returning
+ * an error.
+ * @param {string} beahvior The desired behavior; should be "accept", "dismiss",
+ *     or "ignore". Defaults to "dismiss".
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setAlertBehavior = function(behavior) {
+  this.capabilities_.setAlertBehavior(behavior);
+  return this;
+};
+
+
+/**
+ * Sets Chrome specific {@linkplain selenium-webdriver/chrome.Options options}
+ * for drivers created by this builder. Any logging or proxy settings defined
+ * on the given options will take precedence over those set through
+ * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.
+ *
  * @param {!chrome.Options} options The ChromeDriver options to use.
  * @return {!Builder} A self reference.
  */
 Builder.prototype.setChromeOptions = function(options) {
-  var newCapabilities = options.toCapabilities(this.getCapabilities());
-  return /** @type {!Builder} */(this.withCapabilities(newCapabilities));
+  this.chromeOptions_ = options;
+  return this;
 };
 
 
 /**
- * @override
+ * Sets Firefox specific {@linkplain selenium-webdriver/firefox.Options options}
+ * for drivers created by this builder. Any logging or proxy settings defined
+ * on the given options will take precedence over those set through
+ * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.
+ *
+ * @param {!firefox.Options} options The FirefoxDriver options to use.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setFirefoxOptions = function(options) {
+  this.firefoxOptions_ = options;
+  return this;
+};
+
+
+/**
+ * Sets Opera specific {@linkplain selenium-webdriver/opera.Options options} for
+ * drivers created by this builder. Any logging or proxy settings defined on the
+ * given options will take precedence over those set through
+ * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.
+ *
+ * @param {!opera.Options} options The OperaDriver options to use.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setOperaOptions = function(options) {
+  this.operaOptions_ = options;
+  return this;
+};
+
+
+/**
+ * Sets Internet Explorer specific
+ * {@linkplain selenium-webdriver/ie.Options options} for drivers created by
+ * this builder. Any proxy settings defined on the given options will take
+ * precedence over those set through {@link #setProxy}.
+ *
+ * @param {!ie.Options} options The IEDriver options to use.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setIeOptions = function(options) {
+  this.ieOptions_ = options;
+  return this;
+};
+
+
+/**
+ * Sets Safari specific {@linkplain selenium-webdriver/safari.Options options}
+ * for drivers created by this builder. Any logging settings defined on the
+ * given options will take precedence over those set through
+ * {@link #setLoggingPrefs}.
+ *
+ * @param {!safari.Options} options The Safari options to use.
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setSafariOptions = function(options) {
+  this.safariOptions_ = options;
+  return this;
+};
+
+
+/**
+ * Sets the control flow that created drivers should execute actions in. If
+ * the flow is never set, or is set to {@code null}, it will use the active
+ * flow at the time {@link #build()} is called.
+ * @param {webdriver.promise.ControlFlow} flow The control flow to use, or
+ *     {@code null} to
+ * @return {!Builder} A self reference.
+ */
+Builder.prototype.setControlFlow = function(flow) {
+  this.flow_ = flow;
+  return this;
+};
+
+
+/**
+ * Creates a new WebDriver client based on this builder's current
+ * configuration.
+ *
+ * @return {!webdriver.WebDriver} A new WebDriver instance.
+ * @throws {Error} If the current configuration is invalid.
  */
 Builder.prototype.build = function() {
-  var url = this.getServerUrl();
-
-  // If a remote server wasn't specified, check for browsers we support
-  // natively in node before falling back to using the java Selenium server.
-  if (!url) {
-    var driver = createNativeDriver(this.getCapabilities());
-    if (driver) {
-      return driver;
+  // Create a copy for any changes we may need to make based on the current
+  // environment.
+  var capabilities = new Capabilities(this.capabilities_);
+
+  var browser;
+  if (!this.ignoreEnv_ && process.env.SELENIUM_BROWSER) {
+    browser = process.env.SELENIUM_BROWSER.split(/:/, 3);
+    capabilities.set(Capability.BROWSER_NAME, browser[0]);
+    capabilities.set(Capability.VERSION, browser[1] || null);
+    capabilities.set(Capability.PLATFORM, browser[2] || null);
+  }
+
+  browser = capabilities.get(Capability.BROWSER_NAME) || capabilities.get(Capability.BROWSER);
+
+  if (typeof browser !== 'string') {
+    throw TypeError(
+        'Target browser must be a string, but is <' + (typeof browser) + '>;' +
+        ' did you forget to call forBrowser()?');
+  }
+
+  if (browser === 'ie') {
+    browser = Browser.INTERNET_EXPLORER;
+  }
+
+  // Apply browser specific overrides.
+  if (browser === Browser.CHROME && this.chromeOptions_) {
+    capabilities.merge(this.chromeOptions_.toCapabilities());
+
+  } else if (browser === Browser.FIREFOX && this.firefoxOptions_) {
+    capabilities.merge(this.firefoxOptions_.toCapabilities());
+
+  } else if (browser === Browser.INTERNET_EXPLORER && this.ieOptions_) {
+    capabilities.merge(this.ieOptions_.toCapabilities());
+
+  } else if (browser === Browser.OPERA && this.operaOptions_) {
+    capabilities.merge(this.operaOptions_.toCapabilities());
+
+  } else if (browser === Browser.SAFARI && this.safariOptions_) {
+    capabilities.merge(this.safariOptions_.toCapabilities());
+  }
+
+  // Check for a remote browser.
+  var url = this.url_;
+  if (!this.ignoreEnv_) {
+    if (process.env.SELENIUM_REMOTE_URL) {
+      url = process.env.SELENIUM_REMOTE_URL;
+    } else if (process.env.SELENIUM_SERVER_JAR) {
+      url = startSeleniumServer(process.env.SELENIUM_SERVER_JAR);
     }
+  }
 
-    // Nope, fall-back to using the default java server.
-    url = AbstractBuilder.DEFAULT_SERVER_URL;
+  if (url) {
+    var executor = executors.createExecutor(url, this.proxy_);
+    return WebDriver.createSession(executor, capabilities, this.flow_);
   }
 
-  var executor = executors.createExecutor(url);
-  return WebDriver.createSession(executor, this.getCapabilities());
+  // Check for a native browser.
+  switch (browser) {
+    case Browser.CHROME:
+      // Requiring 'chrome' above would create a cycle:
+      // index -> builder -> chrome -> index
+      var chrome = require('./chrome');
+      return new chrome.Driver(capabilities, null, this.flow_);
+
+    case Browser.FIREFOX:
+      // Requiring 'firefox' above would create a cycle:
+      // index -> builder -> firefox -> index
+      var firefox = require('./firefox');
+      return new firefox.Driver(capabilities, this.flow_);
+
+    case Browser.INTERNET_EXPLORER:
+      // Requiring 'ie' above would create a cycle:
+      // index -> builder -> ie -> index
+      var ie = require('./ie');
+      return new ie.Driver(capabilities, this.flow_);
+
+    case Browser.OPERA:
+      // Requiring 'opera' would create a cycle:
+      // index -> builder -> opera -> index
+      var opera = require('./opera');
+      return new opera.Driver(capabilities, this.flow_);
+
+    case Browser.PHANTOM_JS:
+      // Requiring 'phantomjs' would create a cycle:
+      // index -> builder -> phantomjs -> index
+      var phantomjs = require('./phantomjs');
+      return new phantomjs.Driver(capabilities, this.flow_);
+
+    case Browser.SAFARI:
+      // Requiring 'safari' would create a cycle:
+      // index -> builder -> safari -> index
+      var safari = require('./safari');
+      return new safari.Driver(capabilities, this.flow_);
+
+    default:
+      throw new Error('Do not know how to build driver: ' + browser
+          + '; did you forget to call usingServer(url)?');
+  }
 };
 
 
diff --git a/chrome.js b/chrome.js
index 6ac6f8e..b00d0c0 100644
--- a/chrome.js
+++ b/chrome.js
@@ -1,17 +1,116 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Defines a {@linkplain Driver WebDriver} client for the Chrome
+ * web browser. Before using this module, you must download the latest
+ * [ChromeDriver release] and ensure it can be found on your system [PATH].
+ *
+ * There are three primary classes exported by this module:
+ *
+ * 1. {@linkplain ServiceBuilder}: configures the
+ *     {@link selenium-webdriver/remote.DriverService remote.DriverService}
+ *     that manages the [ChromeDriver] child process.
+ *
+ * 2. {@linkplain Options}: defines configuration options for each new Chrome
+ *     session, such as which {@linkplain Options#setProxy proxy} to use,
+ *     what {@linkplain Options#addExtensions extensions} to install, or
+ *     what {@linkplain Options#addArguments command-line switches} to use when
+ *     starting the browser.
+ *
+ * 3. {@linkplain Driver}: the WebDriver client; each new instance will control
+ *     a unique browser session with a clean user profile (unless otherwise
+ *     configured through the {@link Options} class).
+ *
+ * __Customizing the ChromeDriver Server__ <a id="custom-server"></a>
+ *
+ * By default, every Chrome session will use a single driver service, which is
+ * started the first time a {@link Driver} instance is created and terminated
+ * when this process exits. The default service will inherit its environment
+ * from the current process and direct all output to /dev/null. You may obtain
+ * a handle to this default service using
+ * {@link #getDefaultService getDefaultService()} and change its configuration
+ * with {@link #setDefaultService setDefaultService()}.
+ *
+ * You may also create a {@link Driver} with its own driver service. This is
+ * useful if you need to capture the server's log output for a specific session:
+ *
+ *     var chrome = require('selenium-webdriver/chrome');
+ *
+ *     var service = new chrome.ServiceBuilder()
+ *         .loggingTo('/my/log/file.txt')
+ *         .enableVerboseLogging()
+ *         .build();
+ *
+ *     var options = new chrome.Options();
+ *     // configure browser options ...
+ *
+ *     var driver = new chrome.Driver(options, service);
+ *
+ * Users should only instantiate the {@link Driver} class directly when they
+ * need a custom driver service configuration (as shown above). For normal
+ * operation, users should start Chrome using the
+ * {@link selenium-webdriver.Builder}.
+ *
+ * __Working with Android__ <a id="android"></a>
+ *
+ * The [ChromeDriver][android] supports running tests on the Chrome browser as
+ * well as [WebView apps][webview] starting in Android 4.4 (KitKat). In order to
+ * work with Android, you must first start the adb
+ *
+ *     adb start-server
+ *
+ * By default, adb will start on port 5037. You may change this port, but this
+ * will require configuring a [custom server](#custom-server) that will connect
+ * to adb on the {@linkplain ServiceBuilder#setAdbPort correct port}:
+ *
+ *     var service = new chrome.ServiceBuilder()
+ *         .setAdbPort(1234)
+ *         build();
+ *     // etc.
+ *
+ * The ChromeDriver may be configured to launch Chrome on Android using
+ * {@link Options#androidChrome()}:
+ *
+ *     var driver = new Builder()
+ *         .forBrowser('chrome')
+ *         .setChromeOptions(new chrome.Options().androidChrome())
+ *         .build();
+ *
+ * Alternatively, you can configure the ChromeDriver to launch an app with a
+ * Chrome-WebView by setting the {@linkplain Options#androidActivity
+ * androidActivity} option:
+ *
+ *     var driver = new Builder()
+ *         .forBrowser('chrome')
+ *         .setChromeOptions(new chrome.Options()
+ *             .androidPackage('com.example')
+ *             .androidActivity('com.example.Activity'))
+ *         .build();
+ *
+ * [Refer to the ChromeDriver site] for more information on using the
+ * [ChromeDriver with Android][android].
+ *
+ * [ChromeDriver]: https://sites.google.com/a/chromium.org/chromedriver/
+ * [ChromeDriver release]: http://chromedriver.storage.googleapis.com/index.html
+ * [PATH]: http://en.wikipedia.org/wiki/PATH_%28variable%29
+ * [android]: https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android
+ * [webview]: https://developer.chrome.com/multidevice/webview/overview
+ */
 
 'use strict';
 
@@ -20,6 +119,7 @@ var fs = require('fs'),
 
 var webdriver = require('./index'),
     executors = require('./executors'),
+    http = require('./http'),
     io = require('./io'),
     portprober = require('./net/portprober'),
     remote = require('./remote');
@@ -35,8 +135,36 @@ var CHROMEDRIVER_EXE =
 
 
 /**
- * Creates {@link remote.DriverService} instances that manage a ChromeDriver
- * server.
+ * Custom command names supported by ChromeDriver.
+ * @enum {string}
+ */
+var Command = {
+  LAUNCH_APP: 'launchApp'
+};
+
+
+/**
+ * Creates a command executor with support for ChromeDriver's custom commands.
+ * @param {!webdriver.promise.Promise<string>} url The server's URL.
+ * @return {!webdriver.CommandExecutor} The new command executor.
+ */
+function createExecutor(url) {
+  return new executors.DeferredExecutor(url.then(function(url) {
+    var client = new http.HttpClient(url);
+    var executor = new http.Executor(client);
+    executor.defineCommand(
+        Command.LAUNCH_APP,
+        'POST', '/session/:sessionId/chromium/launch_app');
+    return executor;
+  }));
+}
+
+
+/**
+ * Creates {@link selenium-webdriver/remote.DriverService} instances that manage
+ * a [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/)
+ * server in a child process.
+ *
  * @param {string=} opt_exe Path to the server executable to use. If omitted,
  *     the builder will attempt to locate the chromedriver on the current
  *     PATH.
@@ -65,6 +193,9 @@ var ServiceBuilder = function(opt_exe) {
 };
 
 
+/** @private {string} */
+ServiceBuilder.prototype.path_ = null;
+
 /** @private {number} */
 ServiceBuilder.prototype.port_ = 0;
 
@@ -92,6 +223,20 @@ ServiceBuilder.prototype.usingPort = function(port) {
 };
 
 
+/**
+ * Sets which port adb is listening to. _The ChromeDriver will connect to adb
+ * if an {@linkplain Options#androidPackage Android session} is requested, but
+ * adb **must** be started beforehand._
+ *
+ * @param {number} port Which port adb is running on.
+ * @return {!ServiceBuilder} A self reference.
+ */
+ServiceBuilder.prototype.setAdbPort = function(port) {
+  this.args_.push('--adb-port=' + port);
+  return this;
+};
+
+
 /**
  * Sets the path of the log file the driver should log to. If a log file is
  * not specified, the driver will log to stderr.
@@ -134,6 +279,7 @@ ServiceBuilder.prototype.setNumHttpThreads = function(n) {
  */
 ServiceBuilder.prototype.setUrlBasePath = function(path) {
   this.args_.push('--url-base=' + path);
+  this.path_ = path;
   return this;
 };
 
@@ -175,6 +321,8 @@ ServiceBuilder.prototype.build = function() {
   var args = this.args_.concat();  // Defensive copy.
 
   return new remote.DriverService(this.exe_, {
+    loopback: true,
+    path: this.path_,
     port: port,
     args: webdriver.promise.when(port, function(port) {
       return args.concat('--port=' + port);
@@ -228,14 +376,24 @@ var OPTIONS_CAPABILITY_KEY = 'chromeOptions';
 /**
  * Class for managing ChromeDriver specific options.
  * @constructor
+ * @extends {webdriver.Serializable}
  */
 var Options = function() {
-  /** @private {!Array.<string>} */
-  this.args_ = [];
+  webdriver.Serializable.call(this);
+
+  /** @private {!Object} */
+  this.options_ = {};
 
   /** @private {!Array.<(string|!Buffer)>} */
   this.extensions_ = [];
+
+  /** @private {?webdriver.logging.Preferences} */
+  this.logPrefs_ = null;
+
+  /** @private {?webdriver.ProxyConfig} */
+  this.proxy_ = null;
 };
+util.inherits(Options, webdriver.Serializable);
 
 
 /**
@@ -254,11 +412,15 @@ Options.fromCapabilities = function(capabilities) {
     options.
         addArguments(o.args || []).
         addExtensions(o.extensions || []).
-        detachDriver(!!o.detach).
+        detachDriver(o.detach).
+        excludeSwitches(o.excludeSwitches || []).
         setChromeBinaryPath(o.binary).
-        setChromeLogFile(o.logFile).
+        setChromeLogFile(o.logPath).
+        setChromeMinidumpPath(o.minidumpPath).
         setLocalState(o.localState).
-        setUserPreferences(o.prefs);
+        setMobileEmulation(o.mobileEmulation).
+        setUserPreferences(o.prefs).
+        setPerfLoggingPrefs(o.perfLoggingPrefs);
   }
 
   if (capabilities.has(webdriver.Capability.PROXY)) {
@@ -266,7 +428,7 @@ Options.fromCapabilities = function(capabilities) {
   }
 
   if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {
-    options.setLoggingPreferences(
+    options.setLoggingPrefs(
         capabilities.get(webdriver.Capability.LOGGING_PREFS));
   }
 
@@ -283,7 +445,28 @@ Options.fromCapabilities = function(capabilities) {
  * @return {!Options} A self reference.
  */
 Options.prototype.addArguments = function(var_args) {
-  this.args_ = this.args_.concat.apply(this.args_, arguments);
+  var args = this.options_.args || [];
+  args = args.concat.apply(args, arguments);
+  if (args.length) {
+    this.options_.args = args;
+  }
+  return this;
+};
+
+
+/**
+ * List of Chrome command line switches to exclude that ChromeDriver by default
+ * passes when starting Chrome.  Do not prefix switches with "--".
+ *
+ * @param {...(string|!Array<string>)} var_args The switches to exclude.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.excludeSwitches = function(var_args) {
+  var switches = this.options_.excludeSwitches || [];
+  switches = switches.concat.apply(switches, arguments);
+  if (switches.length) {
+    this.options_.excludeSwitches = switches;
+  }
   return this;
 };
 
@@ -297,8 +480,7 @@ Options.prototype.addArguments = function(var_args) {
  * @return {!Options} A self reference.
  */
 Options.prototype.addExtensions = function(var_args) {
-  this.extensions_ = this.extensions_.concat.apply(
-      this.extensions_, arguments);
+  this.extensions_ = this.extensions_.concat.apply(this.extensions_, arguments);
   return this;
 };
 
@@ -315,7 +497,7 @@ Options.prototype.addExtensions = function(var_args) {
  * @return {!Options} A self reference.
  */
 Options.prototype.setChromeBinaryPath = function(path) {
-  this.binary_ = path;
+  this.options_.binary = path;
   return this;
 };
 
@@ -329,7 +511,7 @@ Options.prototype.setChromeBinaryPath = function(path) {
  * @return {!Options} A self reference.
  */
 Options.prototype.detachDriver = function(detach) {
-  this.detach_ = detach;
+  this.options_.detach = detach;
   return this;
 };
 
@@ -341,7 +523,7 @@ Options.prototype.detachDriver = function(detach) {
  * @return {!Options} A self reference.
  */
 Options.prototype.setUserPreferences = function(prefs) {
-  this.prefs_ = prefs;
+  this.options_.prefs = prefs;
   return this;
 };
 
@@ -351,12 +533,42 @@ Options.prototype.setUserPreferences = function(prefs) {
  * @param {!webdriver.logging.Preferences} prefs The logging preferences.
  * @return {!Options} A self reference.
  */
-Options.prototype.setLoggingPreferences = function(prefs) {
+Options.prototype.setLoggingPrefs = function(prefs) {
   this.logPrefs_ = prefs;
   return this;
 };
 
 
+/**
+ * Sets the performance logging preferences. Options include:
+ *
+ * - `enableNetwork`: Whether or not to collect events from Network domain.
+ * - `enablePage`: Whether or not to collect events from Page domain.
+ * - `enableTimeline`: Whether or not to collect events from Timeline domain.
+ *     Note: when tracing is enabled, Timeline domain is implicitly disabled,
+ *     unless `enableTimeline` is explicitly set to true.
+ * - `tracingCategories`: A comma-separated string of Chrome tracing categories
+ *     for which trace events should be collected. An unspecified or empty
+ *     string disables tracing.
+ * - `bufferUsageReportingInterval`: The requested number of milliseconds
+ *     between DevTools trace buffer usage events. For example, if 1000, then
+ *     once per second, DevTools will report how full the trace buffer is. If a
+ *     report indicates the buffer usage is 100%, a warning will be issued.
+ *
+ * @param {{enableNetwork: boolean,
+ *          enablePage: boolean,
+ *          enableTimeline: boolean,
+ *          tracingCategories: string,
+ *          bufferUsageReportingInterval: number}} prefs The performance
+ *     logging preferences.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setPerfLoggingPrefs = function(prefs) {
+  this.options_.perfLoggingPrefs = prefs;
+  return this;
+};
+
+
 /**
  * Sets preferences for the "Local State" file in Chrome's user data
  * directory.
@@ -364,7 +576,87 @@ Options.prototype.setLoggingPreferences = function(prefs) {
  * @return {!Options} A self reference.
  */
 Options.prototype.setLocalState = function(state) {
-  this.localState_ = state;
+  this.options_.localState = state;
+  return this;
+};
+
+
+/**
+ * Sets the name of the activity hosting a Chrome-based Android WebView. This
+ * option must be set to connect to an [Android WebView](
+ * https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android)
+ *
+ * @param {string} name The activity name.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.androidActivity = function(name) {
+  this.options_.androidActivity = name;
+  return this;
+};
+
+
+/**
+ * Sets the device serial number to connect to via ADB. If not specified, the
+ * ChromeDriver will select an unused device at random. An error will be
+ * returned if all devices already have active sessions.
+ *
+ * @param {string} serial The device serial number to connect to.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.androidDeviceSerial = function(serial) {
+  this.options_.androidDeviceSerial = serial;
+  return this;
+};
+
+
+/**
+ * Configures the ChromeDriver to launch Chrome on Android via adb. This
+ * function is shorthand for
+ * {@link #androidPackage options.androidPackage('com.android.chrome')}.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.androidChrome = function() {
+  return this.androidPackage('com.android.chrome');
+};
+
+
+/**
+ * Sets the package name of the Chrome or WebView app.
+ *
+ * @param {?string} pkg The package to connect to, or `null` to disable Android
+ *     and switch back to using desktop Chrome.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.androidPackage = function(pkg) {
+  this.options_.androidPackage = pkg;
+  return this;
+};
+
+
+/**
+ * Sets the process name of the Activity hosting the WebView (as given by `ps`).
+ * If not specified, the process name is assumed to be the same as
+ * {@link #androidPackage}.
+ *
+ * @param {string} processName The main activity name.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.androidProcess = function(processName) {
+  this.options_.androidProcess = processName;
+  return this;
+};
+
+
+/**
+ * Sets whether to connect to an already-running instead of the specified
+ * {@linkplain #androidProcess app} instead of launching the app with a clean
+ * data directory.
+ *
+ * @param {boolean} useRunning Whether to connect to a running instance.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.androidUseRunningApp = function(useRunning) {
+  this.options_.androidUseRunningApp = useRunning;
   return this;
 };
 
@@ -376,14 +668,68 @@ Options.prototype.setLocalState = function(state) {
  * @return {!Options} A self reference.
  */
 Options.prototype.setChromeLogFile = function(path) {
-  this.logFile_ = path;
+  this.options_.logPath = path;
+  return this;
+};
+
+
+/**
+ * Sets the directory to store Chrome minidumps in. This option is only
+ * supported when ChromeDriver is running on Linux.
+ * @param {string} path The directory path.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setChromeMinidumpPath = function(path) {
+  this.options_.minidumpPath = path;
+  return this;
+};
+
+
+/**
+ * Configures Chrome to emulate a mobile device. For more information, refer to
+ * the ChromeDriver project page on [mobile emulation][em]. Configuration
+ * options include:
+ *
+ * - `deviceName`: The name of a pre-configured [emulated device][devem]
+ * - `width`: screen width, in pixels
+ * - `height`: screen height, in pixels
+ * - `pixelRatio`: screen pixel ratio
+ *
+ * __Example 1: Using a Pre-configured Device__
+ *
+ *     var options = new chrome.Options().setMobileEmulation(
+ *         {deviceName: 'Google Nexus 5'});
+ *
+ *     var driver = new chrome.Driver(options);
+ *
+ * __Example 2: Using Custom Screen Configuration__
+ *
+ *     var options = new chrome.Options().setMobileEmulation({
+ *         width: 360,
+ *         height: 640,
+ *         pixelRatio: 3.0
+ *     });
+ *
+ *     var driver = new chrome.Driver(options);
+ *
+ *
+ * [em]: https://sites.google.com/a/chromium.org/chromedriver/mobile-emulation
+ * [devem]: https://developer.chrome.com/devtools/docs/device-mode
+ *
+ * @param {?({deviceName: string}|
+ *           {width: number, height: number, pixelRatio: number})} config The
+ *     mobile emulation configuration, or `null` to disable emulation.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setMobileEmulation = function(config) {
+  this.options_.mobileEmulation = config;
   return this;
 };
 
 
 /**
  * Sets the proxy settings for the new session.
- * @param {ProxyConfig} proxy The proxy configuration to use.
+ * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.
  * @return {!Options} A self reference.
  */
 Options.prototype.setProxy = function(proxy) {
@@ -414,59 +760,89 @@ Options.prototype.toCapabilities = function(opt_capabilities) {
  * @return {{args: !Array.<string>,
  *           binary: (string|undefined),
  *           detach: boolean,
- *           extensions: !Array.<string>,
+ *           extensions: !Array.<(string|!webdriver.promise.Promise.<string>)>,
  *           localState: (Object|undefined),
- *           logFile: (string|undefined),
+ *           logPath: (string|undefined),
  *           prefs: (Object|undefined)}} The JSON wire protocol representation
  *     of this instance.
+ * @override
  */
-Options.prototype.toJSON = function() {
-  return {
-    args: this.args_,
-    binary: this.binary_,
-    detach: !!this.detach_,
-    extensions: this.extensions_.map(function(extension) {
+Options.prototype.serialize = function() {
+  var json = {};
+  for (var key in this.options_) {
+    if (this.options_[key] != null) {
+      json[key] = this.options_[key];
+    }
+  }
+  if (this.extensions_.length) {
+    json.extensions = this.extensions_.map(function(extension) {
       if (Buffer.isBuffer(extension)) {
         return extension.toString('base64');
       }
-      return fs.readFileSync(extension, 'base64');
-    }),
-    localState: this.localState_,
-    logFile: this.logFile_,
-    prefs: this.prefs_
-  };
+      return webdriver.promise.checkedNodeCall(
+          fs.readFile, extension, 'base64');
+    });
+  }
+  return json;
 };
 
 
 /**
- * Creates a new ChromeDriver session.
- * @param {(webdriver.Capabilities|Options)=} opt_options The session options.
+ * Creates a new WebDriver client for Chrome.
+ *
+ * @param {(webdriver.Capabilities|Options)=} opt_config The configuration
+ *     options.
  * @param {remote.DriverService=} opt_service The session to use; will use
- *     the {@link getDefaultService default service} by default.
- * @return {!webdriver.WebDriver} A new WebDriver instance.
+ *     the {@linkplain #getDefaultService default service} by default.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or
+ *     {@code null} to use the currently active flow.
+ * @constructor
+ * @extends {webdriver.WebDriver}
  */
-function createDriver(opt_options, opt_service) {
+var Driver = function(opt_config, opt_service, opt_flow) {
   var service = opt_service || getDefaultService();
-  var executor = executors.createExecutor(service.start());
+  var executor = createExecutor(service.start());
 
-  var options = opt_options || new Options();
-  if (opt_options instanceof webdriver.Capabilities) {
-    // Extract the Chrome-specific options so we do not send unnecessary
-    // data across the wire.
-    options = Options.fromCapabilities(options);
-  }
+  var capabilities =
+      opt_config instanceof Options ? opt_config.toCapabilities() :
+      (opt_config || webdriver.Capabilities.chrome());
+
+  var driver = webdriver.WebDriver.createSession(
+      executor, capabilities, opt_flow);
+
+  webdriver.WebDriver.call(
+      this, driver.getSession(), executor, driver.controlFlow());
+};
+util.inherits(Driver, webdriver.WebDriver);
 
-  return webdriver.WebDriver.createSession(
-      executor, options.toCapabilities());
-}
 
+/**
+ * This function is a no-op as file detectors are not supported by this
+ * implementation.
+ * @override
+ */
+Driver.prototype.setFileDetector = function() {
+};
+
+
+/**
+ * Schedules a command to launch Chrome App with given ID.
+ * @param {string} id ID of the App to launch.
+ * @return {!webdriver.promise.Promise<void>} A promise that will be resolved
+ *     when app is launched.
+ */
+Driver.prototype.launchApp = function(id) {
+  return this.schedule(
+      new webdriver.Command(Command.LAUNCH_APP).setParameter('id', id),
+      'Driver.launchApp()');
+};
 
 
 // PUBLIC API
 
 
-exports.ServiceBuilder = ServiceBuilder;
+exports.Driver = Driver;
 exports.Options = Options;
-exports.createDriver = createDriver;
+exports.ServiceBuilder = ServiceBuilder;
 exports.getDefaultService = getDefaultService;
 exports.setDefaultService = setDefaultService;
diff --git a/docs/Changes.html b/docs/Changes.html
new file mode 100644
index 0000000..c0558f8
--- /dev/null
+++ b/docs/Changes.html
@@ -0,0 +1,351 @@
+<!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>Changes</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="indexfile"><h2>v2.48.0</h2>
+<ul><li>
+<p>Node v0.12.x users must run with --harmony. <em>This is the last release that
+will support v0.12.x</em></p>
+</li><li>
+<p>FIXED: (Promise/A&#43; compliance) When a promise is rejected with a thenable,
+the promise adopts the thenable as its rejection reason instead of waiting
+for it to settle. The previous (incorrect) behavior was hidden by bugs in
+the <code>promises-aplus-tests</code> compliance test suite that were fixed in version
+<code>2.1.1</code>.</p>
+</li><li>
+<p>FIXED: the <code>webdriver.promise.ControlFlow</code> now has a consistent execution
+order for tasks/callbacks scheduled in different turns of the JS event loop.
+Refer to the <code>webdriver.promise</code> documentation for more details.</p>
+</li><li>
+<p>FIXED: do not drop user auth from the WebDriver server URL.</p>
+</li><li>
+<p>FIXED: a single <code>firefox.Binary</code> instance may be used to configure and
+launch multiple FirefoxDriver sessions.</p>
+<pre><code>var binary &#61; new firefox.Binary();
+var options &#61; new firefox.Options().setBinary(binary);
+var builder &#61; new Builder().setFirefoxOptions(options);
+
+var driver1 &#61; builder.build();
+var driver2 &#61; builder.build();
+</code></pre>
+</li><li>
+<p>FIXED: zip files created for transfer to a remote WebDriver server are no
+longer compressed. If the zip contained a file that was already compressed,
+the server would return an &#34;invalid code lengths set&#34; error.</p>
+</li><li>
+<p>FIXED: Surfaced the <code>loopback</code> option to <code>remote/SeleniumServer</code>. When set,
+the server will be accessed using the current host&#39;s loopback address.</p>
+</li></ul>
+<h2>v2.47.0</h2>
+<h3>Notice</h3>
+<p>This is the last release for <code>selenium-webdriver</code> that will support ES5.
+Subsequent releases will depend on ES6 features that are enabled by
+<a href="https://nodejs.org/en/docs/es6/">default</a> in Node v4.0.0. Node v0.12.x will
+continue to be supported, but will require setting the <code>--harmony</code> flag.</p>
+<h3>Change Summary</h3>
+<ul><li>Add support for <a href="https://nodejs.org/en/blog/release/v4.0.0/">Node v4.0.0</a>
+<ul><li>Updated <code>ws</code> dependency from <code>0.7.1</code> to <code>0.8.0</code></li></ul>
+</li><li>Bumped the minimum supported version of Node from <code>0.10.x</code> to <code>0.12.x</code>. This
+is in accordance with the Node support policy established in <code>v2.45.0</code>.</li></ul>
+<h2>v2.46.1</h2>
+<ul><li>Fixed internal module loading on Windows.</li><li>Fixed error message format on timeouts for <code>until.elementLocated()</code>
+and <code>until.elementsLocated()</code>.</li></ul>
+<h2>v2.46.0</h2>
+<ul><li>Exposed a new logging API via the <code>webdriver.logging</code> module. For usage, see
+<code>example/logging.js</code>.</li><li>Added support for using a proxy server for WebDriver commands.
+See <code>Builder#usingWebDriverProxy()</code> for more info.</li><li>Removed deprecated functions:
+<ul><li>Capabilities#toJSON()</li><li>UnhandledAlertError#getAlert()</li><li>chrome.createDriver()</li><li>phantomjs.createDriver()</li><li>promise.ControlFlow#annotateError()</li><li>promise.ControlFlow#await()</li><li>promise.ControlFlow#clearHistory()</li><li>promise.ControlFlow#getHistory()</li></ul>
+</li><li>Removed deprecated enum values: <code>ErrorCode.NO_MODAL_DIALOG_OPEN</code> and
+<code>ErrorCode.MODAL_DIALOG_OPENED</code>. Use <code>ErrorCode.NO_SUCH_ALERT</code> and
+<code>ErrorCode.UNEXPECTED_ALERT_OPEN</code>, respectively.</li><li>FIXED: The <code>promise.ControlFlow</code> will maintain state for promise chains
+generated in a loop.</li><li>FIXED: Correct serialize target elements used in an action sequence.</li><li>FIXED: <code>promise.ControlFlow#wait()</code> now has consistent semantics for an
+omitted or 0-timeout: it will wait indefinitely.</li><li>FIXED: <code>remote.DriverService#start()</code> will now fail if the child process dies
+while waiting for the server to start accepting requests. Previously, start
+would continue to poll the server address until the timeout expired.</li><li>FIXED: Skip launching Firefox with the <code>-silent</code> flag to preheat the profile.
+Starting with Firefox 38, this would cause the browser to crash. This step,
+which was first introduced for Selenium&#39;s java client back with Firefox 2,
+no longer appears to be required.</li><li>FIXED: 8564: <code>firefox.Driver#quit()</code> will wait for the Firefox process to
+terminate before deleting the temporary webdriver profile. This eliminates a
+race condition where Firefox would write profile data during shutdown,
+causing the <code>rm -rf</code> operation on the profile directory to fail.</li></ul>
+<h2>v2.45.1</h2>
+<ul><li>FIXED: 8548: Task callbacks are once again dropped if the task was cancelled
+due to a previously uncaught error within the frame.</li><li>FIXED: 8496: Extended the <code>chrome.Options</code> API to cover all configuration
+options (e.g. mobile emulation and performance logging) documented on the
+ChromeDriver <a href="https://sites.google.com/a/chromium.org/chromedriver/capabilities">project site</a>.</li></ul>
+<h2>v2.45.0</h2>
+<h3>Important Policy Change</h3>
+<p>Starting with the 2.45.0 release, selenium-webdriver will support the last
+two stable minor releases for Node. For 2.45.0, this means Selenium will
+support Node 0.10.x and 0.12.x. Support for the intermediate, un-stable release
+(0.11.x) is &#34;best-effort&#34;. This policy will be re-evaluated once Node has a
+major version release (i.e. 1.0.0).</p>
+<h3>Change Summary</h3>
+<ul><li>
+<p>Added native browser support for Internet Explorer, Opera 26&#43;, and Safari</p>
+</li><li>
+<p>With the release of <a href="http://blog.nodejs.org/2015/02/06/node-v0-12-0-stable/">Node 0.12.0</a>
+(finally!), the minimum supported version of Node is now <code>0.10.x</code>.</p>
+</li><li>
+<p>The <code>promise</code> module is now <a href="https://promisesaplus.com/">Promises/A&#43;</a>
+compliant. The biggest compliance change is that promise callbacks are now
+invoked in a future turn of the JS event loop. For example:</p>
+<pre><code>  var promise &#61; require(&#39;selenium-webdriver&#39;).promise;
+  console.log(&#39;start&#39;);
+  promise.fulfilled().then(function() {
+    console.log(&#39;middle&#39;);
+  });
+  console.log(&#39;end&#39;);
+
+  // Output in selenium-webdriver&#64;2.44.0
+  // start
+  // middle
+  // end
+  //
+  // Output in selenium-webdriver&#64;2.45.0
+  // start
+  // end
+  // middle
+</code></pre>
+<p>The <code>promise.ControlFlow</code> class has been updated to track the asynchronous
+breaks required by Promises/A&#43;, so there are no changes to task execution
+order.</p>
+</li><li>
+<p>Updated how errors are annotated on failures. When a task fails, the
+stacktrace from when that task was scheduled is appended to the rejection
+reason with a <code>From:</code> prefix (if it is an Error object). For example:</p>
+<pre><code>  var driver &#61; new webdriver.Builder().forBrowser(&#39;chrome&#39;).build();
+  driver.get(&#39;http://www.google.com/ncr&#39;);
+  driver.call(function() {
+    driver.wait(function() {
+      return driver.isElementPresent(webdriver.By.id(&#39;not-there&#39;));
+    }, 2000, &#39;element not found&#39;);
+  });
+</code></pre>
+<p>This code will fail an error like:</p>
+<pre><code>  Error: element not found
+  Wait timed out after 2002ms
+      at &lt;stack trace&gt;
+  From: Task: element not found
+      at &lt;stack trace&gt;
+  From: Task: WebDriver.call(function)
+      at &lt;stack trace&gt;
+</code></pre>
+</li><li>
+<p>Changed the format of strings returned by <code>promise.ControlFlow#getSchedule</code>.
+This function now accepts a boolean to control whether the returned string
+should include the stacktraces for when each task was scheduled.</p>
+</li><li>
+<p>Deprecating <code>promise.ControlFlow#getHistory</code>,
+<code>promise.ControlFlow#clearHistory</code>, and <code>promise.ControlFlow#annotateError</code>.
+These functions were all intended for internal use and are no longer
+necessary, so they have been made no-ops.</p>
+</li><li>
+<p><code>WebDriver.wait()</code> may now be used to wait for a promise to resolve, with
+an optional timeout. Refer to the API documentation for more information.</p>
+</li><li>
+<p>Added support for copying files to a remote Selenium via <code>sendKeys</code> to test
+file uploads. Refer to the API documentation for more information. Sample
+usage included in <code>test/upload_test.js</code></p>
+</li><li>
+<p>Expanded the interactions API to include touch actions.
+See <code>WebDriver.touchActions()</code>.</p>
+</li><li>
+<p>FIXED: 8380: <code>firefox.Driver</code> will delete its temporary profile on <code>quit</code>.</p>
+</li><li>
+<p>FIXED: 8306: Stack overflow in promise callbacks eliminated.</p>
+</li><li>
+<p>FIXED: 8221: Added support for defining custom command mappings. Includes
+support for PhantomJS&#39;s <code>executePhantomJS</code> (requires PhantomJS 1.9.7 or
+GhostDriver 1.1.0).</p>
+</li><li>
+<p>FIXED: 8128: When the FirefoxDriver marshals an object to the page for
+<code>executeScript</code>, it defines additional properties (required by the driver&#39;s
+implementation). These properties will no longer be enumerable and should
+be omitted (i.e. they won&#39;t show up in JSON.stringify output).</p>
+</li><li>
+<p>FIXED: 8094: The control flow will no longer deadlock when a task returns
+a promise that depends on the completion of sub-tasks.</p>
+</li></ul>
+<h2>v2.44.0</h2>
+<ul><li>
+<p>Added the <code>until</code> module, which defines common explicit wait conditions.
+Sample usage:</p>
+<pre><code>  var firefox &#61; require(&#39;selenium-webdriver/firefox&#39;),
+      until &#61; require(&#39;selenium-webdriver/until&#39;);
+
+  var driver &#61; new firefox.Driver();
+  driver.get(&#39;http://www.google.com/ncr&#39;);
+  driver.wait(until.titleIs(&#39;Google Search&#39;), 1000);
+</code></pre>
+</li><li>
+<p>FIXED: 8000: <code>Builder.forBrowser()</code> now accepts an empty string since some
+WebDriver implementations ignore the value. A value must still be specified,
+however, since it is a required field in WebDriver&#39;s wire protocol.</p>
+</li><li>
+<p>FIXED: 7994: The <code>stacktrace</code> module will not modify stack traces if the
+initial parse fails (e.g. the user defined <code>Error.prepareStackTrace</code>)</p>
+</li><li>
+<p>FIXED: 5855: Added a module (<code>until</code>) that defines several common conditions
+for use with explicit waits. See updated examples for usage.</p>
+</li></ul>
+<h2>v2.43.5</h2>
+<ul><li>FIXED: 7905: <code>Builder.usingServer(url)</code> once again returns <code>this</code> for
+chaining.</li></ul>
+<h2>v2.43.2-4</h2>
+<ul><li>No changes; version bumps while attempting to work around an issue with
+publishing to npm (a version string may only be used once).</li></ul>
+<h2>v2.43.1</h2>
+<ul><li>Fixed an issue with flakiness when setting up the Firefox profile that could
+prevent the driver from initializing properly.</li></ul>
+<h2>v2.43.0</h2>
+<ul><li>
+<p>Added native support for Firefox - the Java Selenium server is no longer
+required.</p>
+</li><li>
+<p>Added support for generator functions to <code>ControlFlow#execute</code> and
+<code>ControlFlow#wait</code>. For more information, see documentation on
+<code>webdriver.promise.consume</code>. Requires harmony support (run with
+<code>node --harmony-generators</code> in <code>v0.11.x</code>).</p>
+</li><li>
+<p>Various improvements to the <code>Builder</code> API. Notably, the <code>build()</code> function
+will no longer default to attempting to use a server at
+<code>http://localhost:4444/wd/hub</code> if it cannot start a browser directly -
+you must specify the WebDriver server with <code>usingServer(url)</code>. You can
+also set the target browser and WebDriver server through a pair of
+environment variables. See the documentation on the <code>Builder</code> constructor
+for more information.</p>
+</li><li>
+<p>For consistency with the other language bindings, added browser specific
+classes that can be used to start a browser without the builder.</p>
+<pre><code>  var webdriver &#61; require(&#39;selenium-webdriver&#39;)
+      chrome &#61; require(&#39;selenium-webdriver/chrome&#39;);
+
+  // The following are equivalent.
+  var driver1 &#61; new webdriver.Builder().forBrowser(&#39;chrome&#39;).build();
+  var driver2 &#61; new chrome.Driver();
+</code></pre>
+</li><li>
+<p>Promise A&#43; compliance: a promise may no longer resolve to itself.</p>
+</li><li>
+<p>For consistency with other language bindings, deprecated
+<code>UnhandledAlertError#getAlert</code> and added <code>#getAlertText</code>.
+<code>getAlert</code> will be removed in <code>2.45.0</code>.</p>
+</li><li>
+<p>FIXED: 7641: Deprecated <code>ErrorCode.NO_MODAL_DIALOG_OPEN</code> and
+<code>ErrorCode.MODAL_DIALOG_OPENED</code> in favor of the new
+<code>ErrorCode.NO_SUCH_ALERT</code> and <code>ErrorCode.UNEXPECTED_ALERT_OPEN</code>,
+respectively.</p>
+</li><li>
+<p>FIXED: 7563: Mocha integration no longer disables timeouts. Default Mocha
+timeouts apply (2000 ms) and may be changed using <code>this.timeout(ms)</code>.</p>
+</li><li>
+<p>FIXED: 7470: Make it easier to create WebDriver instances in custom flows for
+parallel execution.</p>
+</li></ul>
+<h2>v2.42.1</h2>
+<ul><li>FIXED: 7465: Fixed <code>net.getLoopbackAddress</code> on Windows</li><li>FIXED: 7277: Support <code>done</code> callback in Mocha&#39;s BDD interface</li><li>FIXED: 7156: <code>Promise#thenFinally</code> should not suppress original error</li></ul>
+<h2>v2.42.0</h2>
+<ul><li>Removed deprecated functions <code>Promise#addCallback()</code>,
+<code>Promise#addCallbacks()</code>, <code>Promise#addErrback()</code>, and <code>Promise#addBoth()</code>.</li><li>Fail with a more descriptive error if the server returns a malformed redirect</li><li>FIXED: 7300: Connect to ChromeDriver using the loopback address since
+ChromeDriver 2.10.267517 binds to localhost by default.</li><li>FIXED: 7339: Preserve wrapped test function&#39;s string representation for
+Mocha&#39;s BDD interface.</li></ul>
+<h2>v2.41.0</h2>
+<ul><li>FIXED: 7138: export logging API from webdriver module.</li><li>FIXED: 7105: beforeEach/it/afterEach properly bind <code>this</code> for Mocha tests.</li></ul>
+<h2>v2.40.0</h2>
+<ul><li>API documentation is now included in the docs directory.</li><li>Added utility functions for working with an array of promises:
+<code>promise.all</code>, <code>promise.map</code>, and <code>promise.filter</code></li><li>Introduced <code>Promise#thenCatch()</code> and <code>Promise#thenFinally()</code>.</li><li>Deprecated <code>Promise#addCallback()</code>, <code>Promise#addCallbacks()</code>,
+<code>Promise#addErrback()</code>, and <code>Promise#addBoth()</code>.</li><li>Removed deprecated function <code>webdriver.WebDriver#getCapability</code>.</li><li>FIXED: 6826: Added support for custom locators.</li></ul>
+<h2>v2.39.0</h2>
+<ul><li>Version bump to stay in sync with the Selenium project.</li></ul>
+<h2>v2.38.1</h2>
+<ul><li>FIXED: 6686: Changed <code>webdriver.promise.Deferred#cancel()</code> to silently no-op
+if the deferred has already been resolved.</li></ul>
+<h2>v2.38.0</h2>
+<ul><li>When a promise is rejected, always annotate the stacktrace with the parent
+flow state so users can identify the source of an error.</li><li>Updated tests to reflect features not working correctly in the SafariDriver
+(cookie management and proxy support; see issues 5051, 5212, and 5503)</li><li>FIXED: 6284: For mouse moves, correctly omit the x/y offsets if not
+specified as a function argument (instead of passing (0,0)).</li><li>FIXED: 6471: Updated documentation on <code>webdriver.WebElement#getAttribute</code></li><li>FIXED: 6612: On Unix, use the default IANA ephemeral port range if unable to
+retrieve the current system&#39;s port range.</li><li>FIXED: 6617: Avoid triggering the node debugger when initializing the
+stacktrace module.</li><li>FIXED: 6627: Safely rebuild chrome.Options from a partial JSON spec.</li></ul>
+<h2>v2.37.0</h2>
+<ul><li>FIXED: 6346: The remote.SeleniumServer class now accepts JVM arguments using
+the <code>jvmArgs</code> option.</li></ul>
+<h2>v2.36.0</h2>
+<ul><li><em>Release skipped to stay in sync with main Selenium project.</em></li></ul>
+<h2>v2.35.2</h2>
+<ul><li>FIXED: 6200: Pass arguments to the Selenium server instead of to the JVM.</li></ul>
+<h2>v2.35.1</h2>
+<ul><li>FIXED: 6090: Changed example scripts to use chromedriver.</li></ul>
+<h2>v2.35.0</h2>
+<ul><li>Version bump to stay in sync with the Selenium project.</li></ul>
+<h2>v2.34.1</h2>
+<ul><li>FIXED: 6079: The parent process should not wait for spawn driver service
+processes (chromedriver, phantomjs, etc.)</li></ul>
+<h2>v2.34.0</h2>
+<ul><li>
+<p>Added the <code>selenium-webdriver/testing/assert</code> module. This module
+simplifies writing assertions against promised values (see
+example in module documentation).</p>
+</li><li>
+<p>Added the <code>webdriver.Capabilities</code> class.</p>
+</li><li>
+<p>Added native support for the ChromeDriver. When using the <code>Builder</code>,
+requesting chrome without specifying a remote server URL will default to
+the native ChromeDriver implementation.  The
+<a href="https://code.google.com/p/chromedriver/downloads/list">ChromeDriver server</a>
+must be downloaded separately.</p>
+<pre><code>  // Will start ChromeDriver locally.
+  var driver &#61; new webdriver.Builder().
+      withCapabilities(webdriver.Capabilities.chrome()).
+      build();
+
+  // Will start ChromeDriver using the remote server.
+  var driver &#61; new webdriver.Builder().
+      withCapabilities(webdriver.Capabilities.chrome()).
+      usingServer(&#39;http://server:1234/wd/hub&#39;).
+      build();
+</code></pre>
+</li><li>
+<p>Added support for configuring proxies through the builder. For examples, see
+<code>selenium-webdriver/test/proxy_test</code>.</p>
+</li><li>
+<p>Added native support for PhantomJS.</p>
+</li><li>
+<p>Changed signature of <code>SeleniumServer</code> to <code>SeleniumServer(jar, options)</code>.</p>
+</li><li>
+<p>Tests are now included in the npm published package. See <code>README.md</code> for
+execution instructions</p>
+</li><li>
+<p>Removed the deprecated <code>webdriver.Deferred#resolve</code> and
+<code>webdriver.promise.resolved</code> functions.</p>
+</li><li>
+<p>Removed the ability to connect to an existing session from the Builder. This
+feature is intended for use with the browser-based client.</p>
+</li></ul>
+<h2>v2.33.0</h2>
+<ul><li>Added support for WebDriver&#39;s logging API</li><li>FIXED: 5511: Added webdriver.manage().timeouts().pageLoadTimeout(ms)</li></ul>
+<h2>v2.32.1</h2>
+<ul><li>FIXED: 5541: Added missing return statement for windows in
+<code>portprober.findFreePort()</code></li></ul>
+<h2>v2.32.0</h2>
+<ul><li>Added the <code>selenium-webdriver/testing</code> package, which provides a basic
+framework for writing tests using Mocha. See
+<code>selenium-webdriver/example/google_search_test.js</code> for usage.</li><li>For Promises/A&#43; compatibility, backing out the change in 2.30.0 that ensured
+rejections were always Error objects. Rejection reasons are now left as is.</li><li>Removed deprecated functions originally scheduled for removal in 2.31.0
+<ul><li>promise.Application.getInstance()</li><li>promise.ControlFlow#schedule()</li><li>promise.ControlFlow#scheduleTimeout()</li><li>promise.ControlFlow#scheduleWait()</li></ul>
+</li><li>Renamed some functions for consistency with Promises/A&#43; terminology. The
+original functions have been deprecated and will be removed in 2.34.0:
+<ul><li>promise.resolved() -&gt; promise.fulfilled()</li><li>promise.Deferred#resolve() -&gt; promise.Deferred#fulfill()</li></ul>
+</li><li>FIXED: remote.SeleniumServer#stop now shuts down within the active control
+flow, allowing scripts to finish. Use #kill to shutdown immediately.</li><li>FIXED: 5321: cookie deletion commands</li></ul>
+<h2>v2.31.0</h2>
+<ul><li>Added an example script.</li><li>Added a class for controlling the standalone Selenium server (server
+available separately)</li><li>Added a portprober for finding free ports</li><li>FIXED: WebElements now belong to the same flow as their parent driver.</li></ul>
+<h2>v2.30.0</h2>
+<ul><li>Ensures promise rejections are always Error values.</li><li>Version bump to keep in sync with the Selenium project.</li></ul>
+<h2>v2.29.1</h2>
+<ul><li>Fixed a bug that could lead to an infinite loop.</li><li>Added a README.md</li></ul>
+<h2>v2.29.0</h2>
+<ul><li>
+<p>Initial release for npm:</p>
+<pre><code>  npm install selenium-webdriver
+</code></pre>
+</li></ul>
+</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>
\ No newline at end of file
diff --git a/docs/class_bot_Error.html b/docs/class_bot_Error.html
index 2171f78..80d2347 100644
--- a/docs/class_bot_Error.html
+++ b/docs/class_bot_Error.html
@@ -1,6 +1,15 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>bot.Error</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class bot.Error</h1><a class="source" href="source/lib/atoms/error.js.src.html#l77">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
-  &#x2514; bot.Error</code></pre></header><section><p>Error extension that includes error status codes from the WebDriver wire
- protocol:
- http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">bot.Error <span class="args">( code, opt_message )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>code: <code class="type">!<a href="enum_bot_ErrorCode.html">bot.ErrorCode</a></code><dd>The error's status code.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional error message.</dl></table></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_bot_Error_State.html">bot.Error.State</a><dd>Status strings enumerated in the W3C WebDriver working draft.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">bot.Error</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/error.js.src.html#l202">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>he string representation of this error.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">bot.Error</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/error.js.src.html#l197">code &raquo;</a><span class="member"><a name="isAutomationError">isAutomationError</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Flag used for duck-typing when this code is embedded in a Firefox extension.
- This is required since an Error thrown in one component and then reported
- to another will fail instanceof checks in the second component.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/error.js.src.html#l86">code &raquo;</a><span class="member"><a name="state">state</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/atoms/error.js.src.html#l156">code &raquo;</a><span class="member"><a name="bot.Error.CODE_TO_STATE_">bot.Error.CODE_TO_STATE_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="enum_bot_ErrorCode.html">bot.ErrorCode</a>, <a href="enum_bot_Error_State.html">bot.Error.State</a>&gt;</code></span></div><p>A map of error codes to state string.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/error.js.src.html#l77">code &raquo;</a><span class="member"><a name="bot.Error.superClass_">bot.Error.superClass_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>Error</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_bot.html">bot</a></div><div class="codelink"><a href="source/lib/atoms/error.js.src.html#l76">View Source</a></div><h1>class Error</h1><pre class="inheritance"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>
+  &#x2514; bot.Error</pre><p>Represents an error returned from a WebDriver command request.</p>
+<h3>new Error(<wbr>code, opt_message)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>code<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The error&#39;s status code.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Optional error message.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/atoms/error.js.src.html#l199">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string representation of this error.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="code" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l82">code</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>This error&#39;s status code.</p>
+</dl></div><div id="description" class="property"><dl><dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>IE-only.</p>
+</dl></div><div id="fileName" class="property"><dl><dt>fileName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Mozilla-only</p>
+</dl></div><div id="isAutomationError" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l194">isAutomationError</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Flag used for duck-typing when this code is embedded in a Firefox extension.
+This is required since an Error thrown in one component and then reported
+to another will fail instanceof checks in the second component.</p>
+</dl></div><div id="lineNumber" class="property"><dl><dt>lineNumber<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>Mozilla-only.</p>
+</dl></div><div id="message" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l89">message</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="name" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l104">name</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="sourceURL" class="property"><dl><dt>sourceURL<code>?</code><dd><p>Doesn&#39;t seem to exist, but closure/debug.js references it.</p>
+</dl></div><div id="stack" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l112">stack</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="state" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l85">state</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><h2>Types</h2><dl><dt><a href="enum_bot_Error_State.html">Error.State</a><dd><p>Status strings enumerated in the W3C WebDriver protocol.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_goog_Disposable.html b/docs/class_goog_Disposable.html
new file mode 100644
index 0000000..0ab639e
--- /dev/null
+++ b/docs/class_goog_Disposable.html
@@ -0,0 +1,37 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.Disposable</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.Disposable</h1><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l40">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_disposable_IDisposable.html">goog.disposable.IDisposable</a></code></dl></header><section><p>Class that provides the basic implementation for disposable objects. If your
+ class holds one or more references to COM objects, DOM nodes, or other
+ disposable objects, it should extend this class or implement the disposable
+ interface (defined in goog.disposable.IDisposable).<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.Disposable <span class="args">( )</span></span></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_Disposable_MonitoringMode.html">goog.Disposable.MonitoringMode</a><dd>No Description.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l214">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="addOnDisposeCallback">addOnDisposeCallback</a> <span class="args">( callback, opt_scope )</span></span></div><p>Invokes a callback function when this object is disposed. Callbacks are
+ invoked in the order in which they were added.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type">function(this: T): ?</code><dd>The callback function.<dt>opt_scope: <code class="type">T=</code><dd>An optional scope to call the callback in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l175">code &raquo;</a><span class="member"><a name="dispose">dispose</a> <span class="args">( )</span> &rArr; <code class="type">void</code></span></div><p>Disposes of the object. If the object hasn't already been disposed of, calls
+ <code  class="type"><a class="unresolved-link">#disposeInternal</a></code>. Classes that extend <code >goog.Disposable</code> should
+ override <code  class="type"><a class="unresolved-link">#disposeInternal</a></code> in order to delete references to COM
+ objects, DOM nodes, and other disposable objects. Reentrant.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Nothing.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l250">code &raquo;</a><span class="member"><a name="disposeInternal">disposeInternal</a> <span class="args">( )</span></span></div><p>Deletes or nulls out any references to COM objects, DOM nodes, or other
+ disposable objects. Classes that extend <code >goog.Disposable</code> should
+ override this method.
+ Not reentrant. To avoid calling it twice, it must only be called from the
+ subclass' <code >disposeInternal</code> method. Everywhere else the public
+ <code >dispose</code> method must be used.
+ For example:
+ <pre>
+   mypackage.MyClass = function() {
+     mypackage.MyClass.base(this, 'constructor');
+     // Constructor logic specific to MyClass.
+     ...
+   };
+   goog.inherits(mypackage.MyClass, goog.Disposable);
+
+   mypackage.MyClass.prototype.disposeInternal = function() {
+     // Dispose logic specific to MyClass.
+     ...
+     // Call superclass's disposeInternal at the end of the subclass's, like
+     // in C++, to avoid hard-to-catch issues.
+     mypackage.MyClass.base(this, 'disposeInternal');
+   };
+ </pre></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l163">code &raquo;</a><span class="member deprecation-notice"><a name="getDisposed">getDisposed</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#isDisposed</a></code> instead.</span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the object has been disposed of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l154">code &raquo;</a><span class="member"><a name="isDisposed">isDisposed</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the object has been disposed of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l202">code &raquo;</a><span class="member"><a name="registerDisposable">registerDisposable</a> <span class="args">( disposable )</span></span></div><p>Associates a disposable object with this object so that they will be disposed
+ together.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>disposable: <code class="type"><a href="interface_goog_disposable_IDisposable.html">goog.disposable.IDisposable</a></code><dd>that will be disposed when
+     this object is disposed.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l147">code &raquo;</a><span class="member"><a name="creationStack">creationStack</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>If monitoring the goog.Disposable instances is enabled, stores the creation
+ stack trace of the Disposable instance.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l131">code &raquo;</a><span class="member"><a name="disposed_">disposed_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object has been disposed of.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l139">code &raquo;</a><span class="member"><a name="onDisposeCallbacks_">onDisposeCallbacks_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Callbacks to invoke when this object is disposed.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l121">code &raquo;</a><span class="member"><a name="goog.Disposable.clearUndisposedObjects">goog.Disposable.clearUndisposedObjects</a> <span class="args">( )</span></span></div><p>Clears the registry of undisposed objects but doesn't dispose of them.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l107">code &raquo;</a><span class="member"><a name="goog.Disposable.getUndisposedObjects">goog.Disposable.getUndisposedObjects</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>All <code >goog.Disposable</code> objects that
+     haven't been disposed of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l266">code &raquo;</a><span class="member"><a name="goog.Disposable.isDisposed">goog.Disposable.isDisposed</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns True if we can verify the object is disposed.
+ Calls <code >isDisposed</code> on the argument if it supports it.  If obj
+ is not an object with an isDisposed() method, return false.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The object to investigate.</dl><tr><th>Returns<tr><td><dl>True if we can verify the object is disposed.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l100">code &raquo;</a><span class="member"><a name="goog.Disposable.instances_">goog.Disposable.instances_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code></span></div><p>Maps the unique ID of every undisposed <code >goog.Disposable</code> object to
+ the object itself.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l91">code &raquo;</a><span class="member"><a name="goog.Disposable.INCLUDE_STACK_ON_CREATION">goog.Disposable.INCLUDE_STACK_ON_CREATION</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l84">code &raquo;</a><span class="member"><a name="goog.Disposable.MONITORING_MODE">goog.Disposable.MONITORING_MODE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_Uri.html b/docs/class_goog_Uri.html
index b7fd597..1474bcb 100644
--- a/docs/class_goog_Uri.html
+++ b/docs/class_goog_Uri.html
@@ -1,8 +1,14 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.Uri</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.Uri</h1><a class="source" href="source/lib/goog/uri/uri.js.src.html#l66">code &raquo;</a></header><section><p>This class contains setters and getters for the parts of the URI.
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.Uri</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.Uri</h1><a class="source" href="source/lib/goog/uri/uri.js.src.html#l72">code &raquo;</a></header><section><p>This class contains setters and getters for the parts of the URI.
  The <code>getXyz</code>/<code>setXyz</code> methods return the decoded part
  -- so<code>goog.Uri.parse('/foo%20bar').getPath()</code> will return the
  decoded path, <code>/foo bar</code>.
 
+ Reserved characters (see RFC 3986 section 2.2) can be present in
+ their percent-encoded form in scheme, domain, and path URI components and
+ will not be auto-decoded. For example:
+ <code>goog.Uri.parse('rel%61tive/path%2fto/resource').getPath()</code> will
+ return <code>relative/path%2fto/resource</code>.
+
  The constructor accepts an optional unparsed, raw URI string.  The parser
  is relaxed, so special characters that aren't escaped but don't cause
  ambiguities will not cause parse failures.
@@ -11,16 +17,16 @@
  <code>goog.Uri.parse('/foo').setFragment('part').toString()</code>.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.Uri <span class="args">( opt_uri, opt_ignoreCase )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_uri: <code class="type">*=</code><dd>Optional string URI to parse
         (use goog.Uri.create() to create a URI from parts), or if
         a goog.Uri is passed, a clone is created.<dt>opt_ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, #getParameterValue will ignore
- the case of the parameter name.</dl></table></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a><dd>Class used to represent URI query parameters.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l344">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Clones the URI instance.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>New instance of the URI objcet.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l755">code &raquo;</a><span class="member"><a name="enforceReadOnly">enforceReadOnly</a> <span class="args">( )</span></span></div><p>Checks if this Uri has been marked as read only, and if so, throws an error.
- This should be called whenever any modifying function is called.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l567">code &raquo;</a><span class="member"><a name="getDecodedQuery">getDecodedQuery</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The decoded URI query, not including the ?.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l417">code &raquo;</a><span class="member"><a name="getDomain">getDomain</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The decoded domain.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l559">code &raquo;</a><span class="member"><a name="getEncodedQuery">getEncodedQuery</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The encoded URI query, not including the ?.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l665">code &raquo;</a><span class="member"><a name="getFragment">getFragment</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The URI fragment, not including the #.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l781">code &raquo;</a><span class="member"><a name="getIgnoreCase">getIgnoreCase</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether to ignore case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l654">code &raquo;</a><span class="member"><a name="getParameterValue">getParameterValue</a> <span class="args">( paramName )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns the first value for a given cgi parameter or undefined if the given
+ the case of the parameter name.</dl></table></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a><dd>Class used to represent URI query parameters.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l351">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Clones the URI instance.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>New instance of the URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l764">code &raquo;</a><span class="member"><a name="enforceReadOnly">enforceReadOnly</a> <span class="args">( )</span></span></div><p>Checks if this Uri has been marked as read only, and if so, throws an error.
+ This should be called whenever any modifying function is called.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l576">code &raquo;</a><span class="member"><a name="getDecodedQuery">getDecodedQuery</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The decoded URI query, not including the ?.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l425">code &raquo;</a><span class="member"><a name="getDomain">getDomain</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The decoded domain.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l568">code &raquo;</a><span class="member"><a name="getEncodedQuery">getEncodedQuery</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The encoded URI query, not including the ?.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l674">code &raquo;</a><span class="member"><a name="getFragment">getFragment</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The URI fragment, not including the #.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l790">code &raquo;</a><span class="member"><a name="getIgnoreCase">getIgnoreCase</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether to ignore case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l663">code &raquo;</a><span class="member"><a name="getParameterValue">getParameterValue</a> <span class="args">( paramName )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns the first value for a given cgi parameter or undefined if the given
  parameter name does not appear in the query string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>paramName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Unescaped parameter name.</dl><tr><th>Returns<tr><td><dl>The first value for a given cgi parameter or
      undefined if the given parameter name does not appear in the query
-     string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l641">code &raquo;</a><span class="member"><a name="getParameterValues">getParameterValues</a> <span class="args">( name )</span> &rArr; <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns the value<b>s</b> for a given cgi parameter as a list of decoded
+     string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l650">code &raquo;</a><span class="member"><a name="getParameterValues">getParameterValues</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns the value<b>s</b> for a given cgi parameter as a list of decoded
  query parameter values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter to get values for.</dl><tr><th>Returns<tr><td><dl>The values for a given cgi parameter as a list of
-     decoded query parameter values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l484">code &raquo;</a><span class="member"><a name="getPath">getPath</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The decoded path.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l446">code &raquo;</a><span class="member"><a name="getPort">getPort</a> <span class="args">( )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The port number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l587">code &raquo;</a><span class="member"><a name="getQuery">getQuery</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The encoded URI query, not including the ?.
+     decoded query parameter values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l493">code &raquo;</a><span class="member"><a name="getPath">getPath</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The decoded path.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l455">code &raquo;</a><span class="member"><a name="getPort">getPort</a> <span class="args">( )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The port number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l596">code &raquo;</a><span class="member"><a name="getQuery">getQuery</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The encoded URI query, not including the ?.
 
  Warning: This method, unlike other getter methods, returns encoded
- value, instead of decoded one.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l576">code &raquo;</a><span class="member"><a name="getQueryData">getQueryData</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Returns the query data.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>QueryData object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l352">code &raquo;</a><span class="member"><a name="getScheme">getScheme</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The encoded scheme/protocol for the URI.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l387">code &raquo;</a><span class="member"><a name="getUserInfo">getUserInfo</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The decoded user info.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l438">code &raquo;</a><span class="member"><a name="hasDomain">hasDomain</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the domain has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l687">code &raquo;</a><span class="member"><a name="hasFragment">hasFragment</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the URI has a fragment set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l505">code &raquo;</a><span class="member"><a name="hasPath">hasPath</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the path has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l476">code &raquo;</a><span class="member"><a name="hasPort">hasPort</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the port has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l513">code &raquo;</a><span class="member"><a name="hasQuery">hasQuery</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the query string has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l697">code &raquo;</a><span class="member"><a name="hasSameDomainAs">hasSameDomainAs</a> <span class="args">( uri2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if this has the same domain as that of uri2.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri2: <code class="type"><a href="class_goog_Uri.html">goog.Uri</a></code><dd>The URI object to compare to.</dl><tr><th>Returns<tr><td><dl>true if same domain; false otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l379">code &raquo;</a><span class="member"><a name="hasScheme">hasScheme</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the scheme has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l409">code &raquo;</a><span class="member"><a name="hasUserInfo">hasUserInfo</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user info has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l746">code &raquo;</a><span class="member"><a name="isReadOnly">isReadOnly</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the URI is read only.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l709">code &raquo;</a><span class="member"><a name="makeUnique">makeUnique</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Adds a random parameter to the Uri.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Reference to this Uri object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l723">code &raquo;</a><span class="member"><a name="removeParameter">removeParameter</a> <span class="args">( key )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Removes the named query parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter to remove.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l269">code &raquo;</a><span class="member"><a name="resolve">resolve</a> <span class="args">( relativeUri )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Resolves the given relative URI (a goog.Uri object), using the URI
+ value, instead of decoded one.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l585">code &raquo;</a><span class="member"><a name="getQueryData">getQueryData</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Returns the query data.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>QueryData object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l359">code &raquo;</a><span class="member"><a name="getScheme">getScheme</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The encoded scheme/protocol for the URI.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l395">code &raquo;</a><span class="member"><a name="getUserInfo">getUserInfo</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The decoded user info.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l447">code &raquo;</a><span class="member"><a name="hasDomain">hasDomain</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the domain has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l696">code &raquo;</a><span class="member"><a name="hasFragment">hasFragment</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the URI has a fragment set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l514">code &raquo;</a><span class="member"><a name="hasPath">hasPath</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the path has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l485">code &raquo;</a><span class="member"><a name="hasPort">hasPort</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the port has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l522">code &raquo;</a><span class="member"><a name="hasQuery">hasQuery</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the query string has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l706">code &raquo;</a><span class="member"><a name="hasSameDomainAs">hasSameDomainAs</a> <span class="args">( uri2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if this has the same domain as that of uri2.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri2: <code class="type"><a href="class_goog_Uri.html">goog.Uri</a></code><dd>The URI object to compare to.</dl><tr><th>Returns<tr><td><dl>true if same domain; false otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l387">code &raquo;</a><span class="member"><a name="hasScheme">hasScheme</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the scheme has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l417">code &raquo;</a><span class="member"><a name="hasUserInfo">hasUserInfo</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user info has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l755">code &raquo;</a><span class="member"><a name="isReadOnly">isReadOnly</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the URI is read only.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l718">code &raquo;</a><span class="member"><a name="makeUnique">makeUnique</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Adds a random parameter to the Uri.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Reference to this Uri object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l732">code &raquo;</a><span class="member"><a name="removeParameter">removeParameter</a> <span class="args">( key )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Removes the named query parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter to remove.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l276">code &raquo;</a><span class="member"><a name="resolve">resolve</a> <span class="args">( relativeUri )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Resolves the given relative URI (a goog.Uri object), using the URI
  represented by this instance as the base URI.
 
  There are several kinds of relative URIs:<br>
@@ -31,27 +37,29 @@
  5. #foo - replace the fragment only
 
  Additionally, if relative URI has a non-empty path, all ".." and "."
- segments will be resolved, as described in RFC 3986.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>relativeUri: <code class="type"><a href="class_goog_Uri.html">goog.Uri</a></code><dd>The relative URI to resolve.</dl><tr><th>Returns<tr><td><dl>The resolved URI.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l428">code &raquo;</a><span class="member"><a name="setDomain">setDomain</a> <span class="args">( newDomain, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the domain.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newDomain: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New domain value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l676">code &raquo;</a><span class="member"><a name="setFragment">setFragment</a> <span class="args">( newFragment, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the URI fragment.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newFragment: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New fragment value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l769">code &raquo;</a><span class="member"><a name="setIgnoreCase">setIgnoreCase</a> <span class="args">( ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets whether to ignore case.
+ segments will be resolved, as described in RFC 3986.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>relativeUri: <code class="type"><a href="class_goog_Uri.html">goog.Uri</a></code><dd>The relative URI to resolve.</dl><tr><th>Returns<tr><td><dl>The resolved URI.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l436">code &raquo;</a><span class="member"><a name="setDomain">setDomain</a> <span class="args">( newDomain, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the domain.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newDomain: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New domain value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l685">code &raquo;</a><span class="member"><a name="setFragment">setFragment</a> <span class="args">( newFragment, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the URI fragment.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newFragment: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New fragment value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l778">code &raquo;</a><span class="member"><a name="setIgnoreCase">setIgnoreCase</a> <span class="args">( ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets whether to ignore case.
  NOTE: If there are already key/value pairs in the QueryData, and
- ignoreCase_ is set to false, the keys will all be lower-cased.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>whether this goog.Uri should ignore case.</dl><tr><th>Returns<tr><td><dl>Reference to this Uri object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l600">code &raquo;</a><span class="member"><a name="setParameterValue">setParameterValue</a> <span class="args">( key, value )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the value of the named query parameters, clearing previous values for
- that key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter to set.<dt>value: <code class="type">*</code><dd>The new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l620">code &raquo;</a><span class="member"><a name="setParameterValues">setParameterValues</a> <span class="args">( key, values )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the values of the named query parameters, clearing previous values for
+ ignoreCase_ is set to false, the keys will all be lower-cased.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>whether this goog.Uri should ignore case.</dl><tr><th>Returns<tr><td><dl>Reference to this Uri object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l609">code &raquo;</a><span class="member"><a name="setParameterValue">setParameterValue</a> <span class="args">( key, value )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the value of the named query parameters, clearing previous values for
+ that key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter to set.<dt>value: <code class="type">*</code><dd>The new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l629">code &raquo;</a><span class="member"><a name="setParameterValues">setParameterValues</a> <span class="args">( key, values )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the values of the named query parameters, clearing previous values for
  that key.  Not new values will currently be moved to the end of the query
  string.
 
  So, <code>goog.Uri.parse('foo?a=b&c=d&e=f').setParameterValues('c', ['new'])
  </code> yields <tt>foo?a=b&e=f&c=new</tt>.</p></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter to set.<dt>values: <code class="type">*</code><dd>The new values. If values is a single
-     string then it will be treated as the sole value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l495">code &raquo;</a><span class="member"><a name="setPath">setPath</a> <span class="args">( newPath, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the path.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newPath: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New path value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l456">code &raquo;</a><span class="member"><a name="setPort">setPort</a> <span class="args">( newPort )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the port number.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newPort: <code class="type">*</code><dd>Port number. Will be explicitly casted to a number.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l551">code &raquo;</a><span class="member"><a name="setQuery">setQuery</a> <span class="args">( newQuery, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the URI query.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newQuery: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New query value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l525">code &raquo;</a><span class="member"><a name="setQueryData">setQueryData</a> <span class="args">( queryData, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the query data.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>queryData: <code class="type">(<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>QueryData object.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.
-     Applies only if queryData is a string.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l737">code &raquo;</a><span class="member"><a name="setReadOnly">setReadOnly</a> <span class="args">( isReadOnly )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets whether Uri is read only. If this goog.Uri is read-only,
+     string then it will be treated as the sole value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l504">code &raquo;</a><span class="member"><a name="setPath">setPath</a> <span class="args">( newPath, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the path.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newPath: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New path value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l465">code &raquo;</a><span class="member"><a name="setPort">setPort</a> <span class="args">( newPort )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the port number.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newPort: <code class="type">*</code><dd>Port number. Will be explicitly casted to a number.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l560">code &raquo;</a><span class="member"><a name="setQuery">setQuery</a> <span class="args">( newQuery, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the URI query.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newQuery: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New query value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l534">code &raquo;</a><span class="member"><a name="setQueryData">setQueryData</a> <span class="args">( queryData, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the query data.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>queryData: <code class="type">(<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>QueryData object.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.
+     Applies only if queryData is a string.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l746">code &raquo;</a><span class="member"><a name="setReadOnly">setReadOnly</a> <span class="args">( isReadOnly )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets whether Uri is read only. If this goog.Uri is read-only,
  enforceReadOnly_ will be called at the start of any function that may modify
- this Uri.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>isReadOnly: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>whether this goog.Uri should be read only.</dl><tr><th>Returns<tr><td><dl>Reference to this Uri object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l363">code &raquo;</a><span class="member"><a name="setScheme">setScheme</a> <span class="args">( newScheme, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the scheme/protocol.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newScheme: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New scheme value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l398">code &raquo;</a><span class="member"><a name="setUserInfo">setUserInfo</a> <span class="args">( newUserInfo, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the userInfo.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newUserInfo: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New userInfo value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l199">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The string form of the url.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l144">code &raquo;</a><span class="member"><a name="domain_">domain_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Domain part, e.g. "www.google.com".</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l176">code &raquo;</a><span class="member"><a name="fragment_">fragment_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The fragment without the #.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l192">code &raquo;</a><span class="member"><a name="ignoreCase_">ignoreCase_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether or not to ignore case when comparing query params.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l184">code &raquo;</a><span class="member"><a name="isReadOnly_">isReadOnly_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether or not this Uri should be treated as Read Only.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l160">code &raquo;</a><span class="member"><a name="path_">path_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Path, e.g. "/tests/img.png".</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l152">code &raquo;</a><span class="member"><a name="port_">port_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Port, e.g. 8080.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l168">code &raquo;</a><span class="member"><a name="queryData_">queryData_</a> : <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Object representing query data.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l128">code &raquo;</a><span class="member"><a name="scheme_">scheme_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Scheme such as "http".</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l136">code &raquo;</a><span class="member"><a name="userInfo_">userInfo_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>User credentials in the form "username:password".</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l822">code &raquo;</a><span class="member"><a name="goog.Uri.create">goog.Uri.create</a> <span class="args">( opt_scheme, opt_userInfo, opt_domain, opt_port, opt_path, opt_query, opt_fragment, opt_ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Creates a new goog.Uri object from unencoded parts.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_scheme: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Scheme/protocol or full URI to parse.<dt>opt_userInfo: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>username:password.<dt>opt_domain: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>www.google.com.<dt>opt_port: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>9830.<dt>opt_path: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>/some/path/to/a/file.html.<dt>opt_query: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a>)=</code><dd>a=1&b=2.<dt>opt_fragment: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The fragment without the #.<dt>opt_ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to ignore parameter name case in
-     #getParameterValue.</dl><tr><th>Returns<tr><td><dl>The new URI object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l914">code &raquo;</a><span class="member"><a name="goog.Uri.decodeOrEmpty_">goog.Uri.decodeOrEmpty_</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Decodes a value or returns the empty string if it isn't defined or empty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Value to decode.</dl><tr><th>Returns<tr><td><dl>Decoded value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l944">code &raquo;</a><span class="member"><a name="goog.Uri.encodeChar_">goog.Uri.encodeChar_</a> <span class="args">( ch )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a character in [\01-\177] to its unicode character equivalent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ch: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>One character string.</dl><tr><th>Returns<tr><td><dl>Encoded string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l930">code &raquo;</a><span class="member"><a name="goog.Uri.encodeSpecialChars_">goog.Uri.encodeSpecialChars_</a> <span class="args">( unescapedPart, extra )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>If unescapedPart is non null, then escapes any characters in it that aren't
+ this Uri.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>isReadOnly: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>whether this goog.Uri should be read only.</dl><tr><th>Returns<tr><td><dl>Reference to this Uri object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l370">code &raquo;</a><span class="member"><a name="setScheme">setScheme</a> <span class="args">( newScheme, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the scheme/protocol.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newScheme: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New scheme value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l406">code &raquo;</a><span class="member"><a name="setUserInfo">setUserInfo</a> <span class="args">( newUserInfo, opt_decode )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Sets the userInfo.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newUserInfo: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New userInfo value.<dt>opt_decode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional param for whether to decode new value.</dl><tr><th>Returns<tr><td><dl>Reference to this URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l205">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The string form of the url.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l150">code &raquo;</a><span class="member"><a name="domain_">domain_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Domain part, e.g. "www.google.com".</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l182">code &raquo;</a><span class="member"><a name="fragment_">fragment_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The fragment without the #.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l198">code &raquo;</a><span class="member"><a name="ignoreCase_">ignoreCase_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether or not to ignore case when comparing query params.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l190">code &raquo;</a><span class="member"><a name="isReadOnly_">isReadOnly_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether or not this Uri should be treated as Read Only.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l166">code &raquo;</a><span class="member"><a name="path_">path_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Path, e.g. "/tests/img.png".</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l158">code &raquo;</a><span class="member"><a name="port_">port_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Port, e.g. 8080.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l174">code &raquo;</a><span class="member"><a name="queryData_">queryData_</a> : <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Object representing query data.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l134">code &raquo;</a><span class="member"><a name="scheme_">scheme_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Scheme such as "http".</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l142">code &raquo;</a><span class="member"><a name="userInfo_">userInfo_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>User credentials in the form "username:password".</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l831">code &raquo;</a><span class="member"><a name="goog.Uri.create">goog.Uri.create</a> <span class="args">( opt_scheme, opt_userInfo, opt_domain, opt_port, opt_path, opt_query, opt_fragment, opt_ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Creates a new goog.Uri object from unencoded parts.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_scheme: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Scheme/protocol or full URI to parse.<dt>opt_userInfo: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>username:password.<dt>opt_domain: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>www.google.com.<dt>opt_port: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>9830.<dt>opt_path: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>/some/path/to/a/file.html.<dt>opt_query: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a>)=</code><dd>a=1&b=2.<dt>opt_fragment: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The fragment without the #.<dt>opt_ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to ignore parameter name case in
+     #getParameterValue.</dl><tr><th>Returns<tr><td><dl>The new URI object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l925">code &raquo;</a><span class="member"><a name="goog.Uri.decodeOrEmpty_">goog.Uri.decodeOrEmpty_</a> <span class="args">( val, opt_preserveReserved )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Decodes a value or returns the empty string if it isn't defined or empty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Value to decode.<dt>opt_preserveReserved: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, restricted characters will
+     not be decoded.</dl><tr><th>Returns<tr><td><dl>Decoded value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l969">code &raquo;</a><span class="member"><a name="goog.Uri.encodeChar_">goog.Uri.encodeChar_</a> <span class="args">( ch )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a character in [\01-\177] to its unicode character equivalent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ch: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>One character string.</dl><tr><th>Returns<tr><td><dl>Encoded string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l947">code &raquo;</a><span class="member"><a name="goog.Uri.encodeSpecialChars_">goog.Uri.encodeSpecialChars_</a> <span class="args">( unescapedPart, extra, opt_removeDoubleEncoding )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>If unescapedPart is non null, then escapes any characters in it that aren't
  valid characters in a url and also escapes any special characters that
- appear in extra.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>unescapedPart: <code class="type">*</code><dd>The string to encode.<dt>extra: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code><dd>A character set of characters in [\01-\177].</dl><tr><th>Returns<tr><td><dl>null iff unescapedPart == null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l997">code &raquo;</a><span class="member"><a name="goog.Uri.haveSameDomain">goog.Uri.haveSameDomain</a> <span class="args">( uri1String, uri2String )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks whether two URIs have the same domain.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri1String: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>First URI string.<dt>uri2String: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Second URI string.</dl><tr><th>Returns<tr><td><dl>true if the two URIs have the same domain; false otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l801">code &raquo;</a><span class="member"><a name="goog.Uri.parse">goog.Uri.parse</a> <span class="args">( uri, opt_ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Creates a uri from the string form.  Basically an alias of new goog.Uri().
+ appear in extra.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>unescapedPart: <code class="type">*</code><dd>The string to encode.<dt>extra: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code><dd>A character set of characters in [\01-\177].<dt>opt_removeDoubleEncoding: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, remove double percent
+     encoding.</dl><tr><th>Returns<tr><td><dl>null iff unescapedPart == null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1034">code &raquo;</a><span class="member"><a name="goog.Uri.haveSameDomain">goog.Uri.haveSameDomain</a> <span class="args">( uri1String, uri2String )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks whether two URIs have the same domain.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri1String: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>First URI string.<dt>uri2String: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Second URI string.</dl><tr><th>Returns<tr><td><dl>true if the two URIs have the same domain; false otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l810">code &raquo;</a><span class="member"><a name="goog.Uri.parse">goog.Uri.parse</a> <span class="args">( uri, opt_ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Creates a uri from the string form.  Basically an alias of new goog.Uri().
  If a Uri object is passed to parse then it will return a clone of the object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type">*</code><dd>Raw URI string or instance of Uri
      object.<dt>opt_ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to ignore the case of parameter
- names in #getParameterValue.</dl><tr><th>Returns<tr><td><dl>The new URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l868">code &raquo;</a><span class="member"><a name="goog.Uri.removeDotSegments">goog.Uri.removeDotSegments</a> <span class="args">( path )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes dot segments in given path component, as described in
- RFC 3986, section 5.2.4.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A non-empty path component.</dl><tr><th>Returns<tr><td><dl>Path component with removed dot segments.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l848">code &raquo;</a><span class="member"><a name="goog.Uri.resolve">goog.Uri.resolve</a> <span class="args">( base, rel )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Resolves a relative Uri against a base Uri, accepting both strings and
- Uri objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>base: <code class="type">*</code><dd>Base Uri.<dt>rel: <code class="type">*</code><dd>Relative Uri.</dl><tr><th>Returns<tr><td><dl>Resolved uri.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l120">code &raquo;</a><span class="member"><a name="goog.Uri.RANDOM_PARAM">goog.Uri.RANDOM_PARAM</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Parameter name added to stop caching.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l113">code &raquo;</a><span class="member"><a name="goog.Uri.preserveParameterTypesCompatibilityFlag">goog.Uri.preserveParameterTypesCompatibilityFlag</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>If true, we preserve the type of query parameters set programmatically.
+ names in #getParameterValue.</dl><tr><th>Returns<tr><td><dl>The new URI object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l877">code &raquo;</a><span class="member"><a name="goog.Uri.removeDotSegments">goog.Uri.removeDotSegments</a> <span class="args">( path )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes dot segments in given path component, as described in
+ RFC 3986, section 5.2.4.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A non-empty path component.</dl><tr><th>Returns<tr><td><dl>Path component with removed dot segments.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l981">code &raquo;</a><span class="member"><a name="goog.Uri.removeDoubleEncoding_">goog.Uri.removeDoubleEncoding_</a> <span class="args">( doubleEncodedString )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes double percent-encoding from a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doubleEncodedString: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>String</dl><tr><th>Returns<tr><td><dl>String with double encoding removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l857">code &raquo;</a><span class="member"><a name="goog.Uri.resolve">goog.Uri.resolve</a> <span class="args">( base, rel )</span> &rArr; <code class="type">!<a href="class_goog_Uri.html">goog.Uri</a></code></span></div><p>Resolves a relative Uri against a base Uri, accepting both strings and
+ Uri objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>base: <code class="type">*</code><dd>Base Uri.<dt>rel: <code class="type">*</code><dd>Relative Uri.</dl><tr><th>Returns<tr><td><dl>Resolved uri.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l126">code &raquo;</a><span class="member"><a name="goog.Uri.RANDOM_PARAM">goog.Uri.RANDOM_PARAM</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Parameter name added to stop caching.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l119">code &raquo;</a><span class="member"><a name="goog.Uri.preserveParameterTypesCompatibilityFlag">goog.Uri.preserveParameterTypesCompatibilityFlag</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>If true, we preserve the type of query parameters set programmatically.
 
  This means that if you set a parameter to a boolean, and then call
  getParameterValue, you will get a boolean back.
@@ -59,5 +67,6 @@
  If false, we will coerce parameters to strings, just as they would
  appear in real URIs.
 
- TODO(nicksantos): Remove this once people have time to fix all tests.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l972">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInAbsolutePath_">goog.Uri.reDisallowedInAbsolutePath_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in an absolute path.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l988">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInFragment_">goog.Uri.reDisallowedInFragment_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in the fragment.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l980">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInQuery_">goog.Uri.reDisallowedInQuery_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in the query.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l964">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInRelativePath_">goog.Uri.reDisallowedInRelativePath_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in a relative path.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l956">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInSchemeOrUserInfo_">goog.Uri.reDisallowedInSchemeOrUserInfo_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in the scheme or
- userInfo part of the URI.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ TODO(nicksantos): Remove this once people have time to fix all tests.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1009">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInAbsolutePath_">goog.Uri.reDisallowedInAbsolutePath_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in an absolute path.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1025">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInFragment_">goog.Uri.reDisallowedInFragment_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in the fragment.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1017">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInQuery_">goog.Uri.reDisallowedInQuery_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in the query.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1001">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInRelativePath_">goog.Uri.reDisallowedInRelativePath_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in a relative path.
+ Colon is included due to RFC 3986 3.3.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l992">code &raquo;</a><span class="member"><a name="goog.Uri.reDisallowedInSchemeOrUserInfo_">goog.Uri.reDisallowedInSchemeOrUserInfo_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for characters that are disallowed in the scheme or
+ userInfo part of the URI.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_Uri_QueryData.html b/docs/class_goog_Uri_QueryData.html
index 2af4722..f24f8dd 100644
--- a/docs/class_goog_Uri_QueryData.html
+++ b/docs/class_goog_Uri_QueryData.html
@@ -1,34 +1,34 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.Uri.QueryData</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.Uri.QueryData</h1><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1025">code &raquo;</a></header><section><p>Class used to represent URI query parameters.  It is essentially a hash of
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.Uri.QueryData</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.Uri.QueryData</h1><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1063">code &raquo;</a></header><section><p>Class used to represent URI query parameters.  It is essentially a hash of
  name-value pairs, though a name can be present more than once.
 
  Has the same interface as the collections in goog.structs.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.Uri.QueryData <span class="args">( opt_query, opt_uri, opt_ignoreCase )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_query: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional encoded query string to parse into
      the object.<dt>opt_uri: <code class="type"><a href="class_goog_Uri.html">goog.Uri</a>=</code><dd>Optional uri object that should have its
      cache invalidated when this object updates. Deprecated -- this
      is no longer required.<dt>opt_ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, ignore the case of the parameter
-     name in #get.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1169">code &raquo;</a><span class="member"><a name="add">add</a> <span class="args">( key, value )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Adds a key value pair.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name.<dt>value: <code class="type">*</code><dd>Value.</dl><tr><th>Returns<tr><td><dl>Instance of this object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1207">code &raquo;</a><span class="member"><a name="clear">clear</a> <span class="args">( )</span></span></div><p>Clears the parameters.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1434">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Clone the query data instance.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>New instance of the QueryData object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1228">code &raquo;</a><span class="member"><a name="containsKey">containsKey</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether there is a parameter with the given name</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter name to check for.</dl><tr><th>Returns<tr><td><dl>Whether there is a parameter with the given name.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1240">code &raquo;</a><span class="member"><a name="containsValue">containsValue</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether there is a parameter with the given value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check for.</dl><tr><th>Returns<tr><td><dl>Whether there is a parameter with the given value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1047">code &raquo;</a><span class="member"><a name="ensureKeyMapInitialized_">ensureKeyMapInitialized_</a> <span class="args">( )</span></span></div><p>If the underlying key map is not yet initialized, it parses the
- query string and fills the map with parsed data.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1493">code &raquo;</a><span class="member"><a name="extend">extend</a> <span class="args">( var_args )</span></span></div><p>Extends a query data object with another query data or map like object. This
+     name in #get.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1207">code &raquo;</a><span class="member"><a name="add">add</a> <span class="args">( key, value )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Adds a key value pair.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name.<dt>value: <code class="type">*</code><dd>Value.</dl><tr><th>Returns<tr><td><dl>Instance of this object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1245">code &raquo;</a><span class="member"><a name="clear">clear</a> <span class="args">( )</span></span></div><p>Clears the parameters.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1471">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Clone the query data instance.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>New instance of the QueryData object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1266">code &raquo;</a><span class="member"><a name="containsKey">containsKey</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether there is a parameter with the given name</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter name to check for.</dl><tr><th>Returns<tr><td><dl>Whether there is a parameter with the given name.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1278">code &raquo;</a><span class="member"><a name="containsValue">containsValue</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether there is a parameter with the given value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check for.</dl><tr><th>Returns<tr><td><dl>Whether there is a parameter with the given value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1085">code &raquo;</a><span class="member"><a name="ensureKeyMapInitialized_">ensureKeyMapInitialized_</a> <span class="args">( )</span></span></div><p>If the underlying key map is not yet initialized, it parses the
+ query string and fills the map with parsed data.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1529">code &raquo;</a><span class="member"><a name="extend">extend</a> <span class="args">( var_args )</span></span></div><p>Extends a query data object with another query data or map like object. This
  operates 'in-place', it does not create a new QueryData object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...(<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a>|<a href="class_goog_structs_Map.html">goog.structs.Map</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>The object
-     from which key value pairs will be copied.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1417">code &raquo;</a><span class="member"><a name="filterKeys">filterKeys</a> <span class="args">( keys )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Removes all keys that are not in the provided list. (Modifies this object.)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keys: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The desired keys.</dl><tr><th>Returns<tr><td><dl>a reference to this object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1330">code &raquo;</a><span class="member"><a name="get">get</a> <span class="args">( key, opt_default )</span> &rArr; <code class="type">*</code></span></div><p>Returns the first value associated with the key. If the query data has no
+     from which key value pairs will be copied.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1455">code &raquo;</a><span class="member"><a name="filterKeys">filterKeys</a> <span class="args">( keys )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Removes all keys that are not in the provided list. (Modifies this object.)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keys: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The desired keys.</dl><tr><th>Returns<tr><td><dl>a reference to this object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1368">code &raquo;</a><span class="member"><a name="get">get</a> <span class="args">( key, opt_default )</span> &rArr; <code class="type">*</code></span></div><p>Returns the first value associated with the key. If the query data has no
  such key this will return undefined or the optional default.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the parameter to get the value for.<dt>opt_default: <code class="type">*=</code><dd>The default value to return if the query data
      has no such key.</dl><tr><th>Returns<tr><td><dl>The first string value associated with the key, or opt_default
-     if there's no value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1157">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of parameters.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1452">code &raquo;</a><span class="member"><a name="getKeyName_">getKeyName_</a> <span class="args">( arg )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Helper function to get the key name from a JavaScript object. Converts
- the object to a string, and to lower case if necessary.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arg: <code class="type">*</code><dd>The object to get a key name from.</dl><tr><th>Returns<tr><td><dl>valid key name which can be looked up in #keyMap_.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1254">code &raquo;</a><span class="member"><a name="getKeys">getKeys</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns all the keys of the parameters. If a key is used multiple times
- it will be included multiple times in the returned array</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>All the keys of the parameters.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1277">code &raquo;</a><span class="member"><a name="getValues">getValues</a> <span class="args">( opt_key )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns all the values of the parameters with the given name. If the query
+     if there's no value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1195">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of parameters.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1489">code &raquo;</a><span class="member"><a name="getKeyName_">getKeyName_</a> <span class="args">( arg )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Helper function to get the key name from a JavaScript object. Converts
+ the object to a string, and to lower case if necessary.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arg: <code class="type">*</code><dd>The object to get a key name from.</dl><tr><th>Returns<tr><td><dl>valid key name which can be looked up in #keyMap_.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1292">code &raquo;</a><span class="member"><a name="getKeys">getKeys</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns all the keys of the parameters. If a key is used multiple times
+ it will be included multiple times in the returned array</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>All the keys of the parameters.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1315">code &raquo;</a><span class="member"><a name="getValues">getValues</a> <span class="args">( opt_key )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns all the values of the parameters with the given name. If the query
  data has no such key this will return an empty array. If no key is given
- all values wil be returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The name of the parameter to get the values for.</dl><tr><th>Returns<tr><td><dl>All the values of the parameters with the given name.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1407">code &raquo;</a><span class="member"><a name="invalidateCache_">invalidateCache_</a> <span class="args">( )</span></span></div><p>Invalidate the cache.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1217">code &raquo;</a><span class="member"><a name="isEmpty">isEmpty</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether we have any parameters.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1189">code &raquo;</a><span class="member"><a name="remove">remove</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes all the params with the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name.</dl><tr><th>Returns<tr><td><dl>Whether any parameter was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1302">code &raquo;</a><span class="member"><a name="set">set</a> <span class="args">( key, value )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Sets a key value pair and removes all other keys with the same value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name.<dt>value: <code class="type">*</code><dd>Value.</dl><tr><th>Returns<tr><td><dl>Instance of this object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1467">code &raquo;</a><span class="member"><a name="setIgnoreCase">setIgnoreCase</a> <span class="args">( ignoreCase )</span></span></div><p>Ignore case in parameter names.
+ all values wil be returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The name of the parameter to get the values for.</dl><tr><th>Returns<tr><td><dl>All the values of the parameters with the given name.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1445">code &raquo;</a><span class="member"><a name="invalidateCache_">invalidateCache_</a> <span class="args">( )</span></span></div><p>Invalidate the cache.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1255">code &raquo;</a><span class="member"><a name="isEmpty">isEmpty</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether we have any parameters.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1227">code &raquo;</a><span class="member"><a name="remove">remove</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes all the params with the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name.</dl><tr><th>Returns<tr><td><dl>Whether any parameter was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1340">code &raquo;</a><span class="member"><a name="set">set</a> <span class="args">( key, value )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Sets a key value pair and removes all other keys with the same value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name.<dt>value: <code class="type">*</code><dd>Value.</dl><tr><th>Returns<tr><td><dl>Instance of this object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1504">code &raquo;</a><span class="member"><a name="setIgnoreCase">setIgnoreCase</a> <span class="args">( ignoreCase )</span></span></div><p>Ignore case in parameter names.
  NOTE: If there are already key/value pairs in the QueryData, and
- ignoreCase_ is set to false, the keys will all be lower-cased.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>whether this goog.Uri should ignore case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1346">code &raquo;</a><span class="member"><a name="setValues">setValues</a> <span class="args">( key, values )</span></span></div><p>Sets the values for a key. If the key already exists, this will
- override all of the existing values that correspond to the key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to set values for.<dt>values: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The values to set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1398">code &raquo;</a><span class="member"><a name="toDecodedString">toDecodedString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Decoded query string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1361">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Encoded query string.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1151">code &raquo;</a><span class="member"><a name="count_">count_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of params, or null if it requires computing.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1031">code &raquo;</a><span class="member"><a name="encodedQuery_">encodedQuery_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Encoded query string, or null if it requires computing from the key map.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1038">code &raquo;</a><span class="member"><a name="ignoreCase_">ignoreCase_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>If true, ignore the case of the parameter name in #get.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1143">code &raquo;</a><span class="member"><a name="keyMap_">keyMap_</a> : <code class="type"><a href="class_goog_structs_Map.html">goog.structs.Map</a></code></span></div><p>The map containing name/value or name/array-of-values pairs.
+ ignoreCase_ is set to false, the keys will all be lower-cased.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>whether this goog.Uri should ignore case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1384">code &raquo;</a><span class="member"><a name="setValues">setValues</a> <span class="args">( key, values )</span></span></div><p>Sets the values for a key. If the key already exists, this will
+ override all of the existing values that correspond to the key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to set values for.<dt>values: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The values to set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1436">code &raquo;</a><span class="member"><a name="toDecodedString">toDecodedString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Decoded query string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1399">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Encoded query string.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1189">code &raquo;</a><span class="member"><a name="count_">count_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of params, or null if it requires computing.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1069">code &raquo;</a><span class="member"><a name="encodedQuery_">encodedQuery_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Encoded query string, or null if it requires computing from the key map.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1076">code &raquo;</a><span class="member"><a name="ignoreCase_">ignoreCase_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>If true, ignore the case of the parameter name in #get.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1181">code &raquo;</a><span class="member"><a name="keyMap_">keyMap_</a> : <code class="type"><a href="class_goog_structs_Map.html">goog.structs.Map</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>&gt;</code></span></div><p>The map containing name/value or name/array-of-values pairs.
  May be null if it requires parsing from the query string.
 
  We need to use a Map because we cannot guarantee that the key names will
- not be problematic for IE.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1120">code &raquo;</a><span class="member"><a name="goog.Uri.QueryData.createFromKeysValues">goog.Uri.QueryData.createFromKeysValues</a> <span class="args">( keys, values, opt_uri, opt_ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Creates a new query data instance from parallel arrays of parameter names
+ not be problematic for IE.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1158">code &raquo;</a><span class="member"><a name="goog.Uri.QueryData.createFromKeysValues">goog.Uri.QueryData.createFromKeysValues</a> <span class="args">( keys, values, opt_uri, opt_ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Creates a new query data instance from parallel arrays of parameter names
  and values. Allows for duplicate parameter names. Throws an error if the
  lengths of the arrays differ.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keys: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>Parameter names.<dt>values: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Parameter values.<dt>opt_uri: <code class="type"><a href="class_goog_Uri.html">goog.Uri</a>=</code><dd>URI object that should have its cache
      invalidated when this object updates.<dt>opt_ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, ignore the case of the parameter
-     name in #get.</dl><tr><th>Returns<tr><td><dl>The populated query data instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1086">code &raquo;</a><span class="member"><a name="goog.Uri.QueryData.createFromMap">goog.Uri.QueryData.createFromMap</a> <span class="args">( map, opt_uri, opt_ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Creates a new query data instance from a map of names and values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>map: <code class="type">(!<a href="class_goog_structs_Map.html">goog.structs.Map</a>|!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>Map of string parameter
+     name in #get.</dl><tr><th>Returns<tr><td><dl>The populated query data instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/uri.js.src.html#l1124">code &raquo;</a><span class="member"><a name="goog.Uri.QueryData.createFromMap">goog.Uri.QueryData.createFromMap</a> <span class="args">( map, opt_uri, opt_ignoreCase )</span> &rArr; <code class="type">!<a href="class_goog_Uri_QueryData.html">goog.Uri.QueryData</a></code></span></div><p>Creates a new query data instance from a map of names and values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>map: <code class="type">(!<a href="class_goog_structs_Map.html">goog.structs.Map</a>|!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>Map of string parameter
      names to parameter value. If parameter value is an array, it is
      treated as if the key maps to each individual value in the
      array.<dt>opt_uri: <code class="type"><a href="class_goog_Uri.html">goog.Uri</a>=</code><dd>URI object that should have its cache
      invalidated when this object updates.<dt>opt_ignoreCase: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, ignore the case of the parameter
-     name in #get.</dl><tr><th>Returns<tr><td><dl>The populated query data instance.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     name in #get.</dl><tr><th>Returns<tr><td><dl>The populated query data instance.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_asserts_AssertionError.html b/docs/class_goog_asserts_AssertionError.html
index 5ad5eab..9b81597 100644
--- a/docs/class_goog_asserts_AssertionError.html
+++ b/docs/class_goog_asserts_AssertionError.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.asserts.AssertionError</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.asserts.AssertionError</h1><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l57">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.asserts.AssertionError</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.asserts.AssertionError</h1><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l59">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
   &#x2514; <a href="class_goog_debug_Error.html">goog.debug.Error</a>
-      &#x2514; goog.asserts.AssertionError</code></pre></header><section><p>Error object for failed assertions.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.asserts.AssertionError <span class="args">( messagePattern, messageArgs )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>messagePattern: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The pattern that was used to form message.<dt>messageArgs: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The items to substitute into the pattern.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.asserts.AssertionError</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l69">code &raquo;</a><span class="member"><a name="messagePattern">messagePattern</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The message pattern used to format the error message. Error handlers can
- use this to uniquely identify the assertion.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l57">code &raquo;</a><span class="member"><a name="goog.asserts.AssertionError.superClass_">goog.asserts.AssertionError.superClass_</a> : <code class="type"><a href="class_goog_debug_Error.html">goog.debug.Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+      &#x2514; goog.asserts.AssertionError</code></pre></header><section><p>Error object for failed assertions.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.asserts.AssertionError <span class="args">( messagePattern, messageArgs )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>messagePattern: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The pattern that was used to form message.<dt>messageArgs: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The items to substitute into the pattern.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.asserts.AssertionError</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l71">code &raquo;</a><span class="member"><a name="messagePattern">messagePattern</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The message pattern used to format the error message. Error handlers can
+ use this to uniquely identify the assertion.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l59">code &raquo;</a><span class="member"><a name="goog.asserts.AssertionError.superClass_">goog.asserts.AssertionError.superClass_</a> : <code class="type"><a href="class_goog_debug_Error.html">goog.debug.Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_async_run_WorkItem_.html b/docs/class_goog_async_run_WorkItem_.html
new file mode 100644
index 0000000..4cb9c4d
--- /dev/null
+++ b/docs/class_goog_async_run_WorkItem_.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.async.run.WorkItem_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.async.run.WorkItem_</h1><a class="source" href="source/lib/goog/async/run.js.src.html#l147">code &raquo;</a></header><section><h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">goog.async.run.WorkItem_ <span class="args">( fn, scope )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn<dt>scope</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l148">code &raquo;</a><span class="member"><a name="fn">fn</a> <span class="args">( )</span></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l149">code &raquo;</a><span class="member"><a name="scope">scope</a> : <code class="type">(Object|null|undefined)</code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_debug_Error.html b/docs/class_goog_debug_Error.html
index 15eb56f..0cf370c 100644
--- a/docs/class_goog_debug_Error.html
+++ b/docs/class_goog_debug_Error.html
@@ -1,2 +1,2 @@
 <!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug.Error</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.debug.Error</h1><a class="source" href="source/lib/goog/debug/error.js.src.html#l34">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
-  &#x2514; goog.debug.Error</code></pre></header><section><p>Base class for custom error objects.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.debug.Error <span class="args">( opt_msg )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_msg: <code class="type">*=</code><dd>The message associated with the error.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/error.js.src.html#l34">code &raquo;</a><span class="member"><a name="goog.debug.Error.superClass_">goog.debug.Error.superClass_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+  &#x2514; goog.debug.Error</code></pre></header><section><p>Base class for custom error objects.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.debug.Error <span class="args">( opt_msg )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_msg: <code class="type">*=</code><dd>The message associated with the error.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/error.js.src.html#l34">code &raquo;</a><span class="member"><a name="goog.debug.Error.superClass_">goog.debug.Error.superClass_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_debug_LogBuffer.html b/docs/class_goog_debug_LogBuffer.html
new file mode 100644
index 0000000..51f289c
--- /dev/null
+++ b/docs/class_goog_debug_LogBuffer.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug.LogBuffer</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.debug.LogBuffer</h1><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l37">code &raquo;</a></header><section><p>Creates the log buffer.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.debug.LogBuffer <span class="args">( )</span></span></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_debug_LogBuffer.html">goog.debug.LogBuffer.instance_</a><dd>Creates the log buffer.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l98">code &raquo;</a><span class="member"><a name="addRecord">addRecord</a> <span class="args">( level, msg, loggerName )</span> &rArr; <code class="type">!<a href="class_goog_debug_LogRecord.html">goog.debug.LogRecord</a></code></span></div><p>Adds a log record to the buffer, possibly overwriting the oldest record.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code><dd>One of the level identifiers.<dt>msg: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string message.<dt>loggerName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the source logger.</dl><tr><th>Returns<tr><td><dl>The log record.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l123">code &raquo;</a><span class="member"><a name="clear">clear</a> <span class="args">( )</span></span></div><p>Removes all buffered log records.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l135">code &raquo;</a><span class="member"><a name="forEachRecord">forEachRecord</a> <span class="args">( func )</span></span></div><p>Calls the given function for each buffered log record, starting with the
+ oldest one.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>func: <code class="type">function(!<a href="class_goog_debug_LogRecord.html">goog.debug.LogRecord</a>)</code><dd>The function to call.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l72">code &raquo;</a><span class="member"><a name="buffer_">buffer_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>The array to store the records.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l80">code &raquo;</a><span class="member"><a name="curIndex_">curIndex_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The index of the most recently added record or -1 if there are no records.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l88">code &raquo;</a><span class="member"><a name="isFull_">isFull_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the buffer is at capacity.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l49">code &raquo;</a><span class="member"><a name="goog.debug.LogBuffer.getInstance">goog.debug.LogBuffer.getInstance</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_debug_LogBuffer.html">goog.debug.LogBuffer</a></code></span></div><p>A static method that always returns the same instance of LogBuffer.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The LogBuffer singleton instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l115">code &raquo;</a><span class="member"><a name="goog.debug.LogBuffer.isBufferingEnabled">goog.debug.LogBuffer.isBufferingEnabled</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the log buffer is enabled.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l54">code &raquo;</a><span class="member"><a name="goog.debug.LogBuffer.goog.debug.LogBuffer.instance_">goog.debug.LogBuffer.goog.debug.LogBuffer.instance_</a> : <code class="type"><a href="class_goog_debug_LogBuffer.html">goog.debug.LogBuffer</a></code></span></div><p>Creates the log buffer.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logbuffer.js.src.html#l64">code &raquo;</a><span class="member"><a name="goog.debug.LogBuffer.CAPACITY">goog.debug.LogBuffer.CAPACITY</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_debug_LogRecord.html b/docs/class_goog_debug_LogRecord.html
new file mode 100644
index 0000000..32c248e
--- /dev/null
+++ b/docs/class_goog_debug_LogRecord.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug.LogRecord</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.debug.LogRecord</h1><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l38">code &raquo;</a></header><section><p>LogRecord objects are used to pass logging requests between
+ the logging framework and individual log Handlers.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.debug.LogRecord <span class="args">( level, msg, loggerName, opt_time, opt_sequenceNumber )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code><dd>One of the level identifiers.<dt>msg: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string message.<dt>loggerName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the source logger.<dt>opt_time: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Time this log record was created if other than now.
+     If 0, we use #goog.now.<dt>opt_sequenceNumber: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Sequence number of this log record. This
+     should only be passed in when restoring a log record from persistence.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l157">code &raquo;</a><span class="member"><a name="getException">getException</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Get the exception that is part of the log record.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>the exception.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l177">code &raquo;</a><span class="member"><a name="getExceptionText">getExceptionText</a> <span class="args">( )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Get the exception text that is part of the log record.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Exception text.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l206">code &raquo;</a><span class="member"><a name="getLevel">getLevel</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>Get the logging message level, for example Level.SEVERE.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>the logging message level.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l147">code &raquo;</a><span class="member"><a name="getLoggerName">getLoggerName</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Get the source Logger's name.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>source logger name (may be null).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l225">code &raquo;</a><span class="member"><a name="getMessage">getMessage</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Get the "raw" log message, before localization or formatting.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>the raw message string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l245">code &raquo;</a><span class="member"><a name="getMillis">getMillis</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Get event time in milliseconds since 1970.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>event time in millis since 1970.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l268">code &raquo;</a><span class="member"><a name="getSequenceNumber">getSequenceNumber</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Get the sequence number.
+ <p>
+ Sequence numbers are normally assigned in the LogRecord
+ constructor, which assigns unique sequence numbers to
+ each new LogRecord in increasing order.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>the sequence number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l126">code &raquo;</a><span class="member"><a name="reset">reset</a> <span class="args">( level, msg, loggerName, opt_time, opt_sequenceNumber )</span></span></div><p>Sets all fields of the log record.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code><dd>One of the level identifiers.<dt>msg: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string message.<dt>loggerName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the source logger.<dt>opt_time: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Time this log record was created if other than now.
+     If 0, we use #goog.now.<dt>opt_sequenceNumber: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Sequence number of this log record. This
+     should only be passed in when restoring a log record from persistence.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l167">code &raquo;</a><span class="member"><a name="setException">setException</a> <span class="args">( exception )</span></span></div><p>Set the exception that is part of the log record.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>exception: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>the exception.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l187">code &raquo;</a><span class="member"><a name="setExceptionText">setExceptionText</a> <span class="args">( text )</span></span></div><p>Set the exception text that is part of the log record.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>text: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The exception text.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l215">code &raquo;</a><span class="member"><a name="setLevel">setLevel</a> <span class="args">( level )</span></span></div><p>Set the logging message level, for example Level.SEVERE.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code><dd>the logging message level.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l197">code &raquo;</a><span class="member"><a name="setLoggerName">setLoggerName</a> <span class="args">( loggerName )</span></span></div><p>Get the source Logger's name.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>loggerName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>source logger name (may be null).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l235">code &raquo;</a><span class="member"><a name="setMessage">setMessage</a> <span class="args">( msg )</span></span></div><p>Set the "raw" log message, before localization or formatting.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>the raw message string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l255">code &raquo;</a><span class="member"><a name="setMillis">setMillis</a> <span class="args">( time )</span></span></div><p>Set event time in milliseconds since 1970.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>time: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>event time in millis since 1970.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l98">code &raquo;</a><span class="member"><a name="exceptionText_">exceptionText_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Exception text associated with the record</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l90">code &raquo;</a><span class="member"><a name="exception_">exception_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Exception associated with the record</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l57">code &raquo;</a><span class="member"><a name="level_">level_</a> : <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>Level of the LogRecord</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l73">code &raquo;</a><span class="member"><a name="loggerName_">loggerName_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Name of the logger that created the record.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l65">code &raquo;</a><span class="member"><a name="msg_">msg_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Message associated with the record</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l82">code &raquo;</a><span class="member"><a name="sequenceNumber_">sequenceNumber_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Sequence number for the LogRecord. Each record has a unique sequence number
+ that is greater than all log records created before it.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l49">code &raquo;</a><span class="member"><a name="time_">time_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Time the LogRecord was created.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l113">code &raquo;</a><span class="member"><a name="goog.debug.LogRecord.nextSequenceNumber_">goog.debug.LogRecord.nextSequenceNumber_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>A sequence counter for assigning increasing sequence numbers to LogRecord
+ objects.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l104">code &raquo;</a><span class="member"><a name="goog.debug.LogRecord.ENABLE_SEQUENCE_NUMBERS">goog.debug.LogRecord.ENABLE_SEQUENCE_NUMBERS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_debug_Logger.html b/docs/class_goog_debug_Logger.html
new file mode 100644
index 0000000..6d70260
--- /dev/null
+++ b/docs/class_goog_debug_Logger.html
@@ -0,0 +1,59 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug.Logger</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.debug.Logger</h1><a class="source" href="source/lib/goog/debug/logger.js.src.html#l65">code &raquo;</a></header><section><p>The Logger is an object used for logging debug messages. Loggers are
+ normally named, using a hierarchical dot-separated namespace. Logger names
+ can be arbitrary strings, but they should normally be based on the package
+ name or class name of the logged component, such as goog.net.BrowserChannel.
+
+ The Logger object is loosely based on the java class
+ java.util.logging.Logger. It supports different levels of filtering for
+ different loggers.
+
+ The logger object should never be instantiated by application code. It
+ should always use the goog.debug.Logger.getLogger function.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.debug.Logger <span class="args">( name )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the Logger.</dl></table></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a><dd>The Level class defines a set of standard logging levels that
+ can be used to control logging output.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l765">code &raquo;</a><span class="member"><a name="addChild_">addChild_</a> <span class="args">( name, logger )</span></span></div><p>Adds a child to this logger. This is used for setting up the logger tree.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The leaf name of the child.<dt>logger: <code class="type"><a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code><dd>The child logger.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l400">code &raquo;</a><span class="member"><a name="addHandler">addHandler</a> <span class="args">( handler )</span></span></div><p>Adds a handler to the logger. This doesn't use the event system because
+ we want to be able to add logging to the event system.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>handler: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Handler function to add.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l740">code &raquo;</a><span class="member"><a name="callPublish_">callPublish_</a> <span class="args">( logRecord )</span></span></div><p>Calls the handlers for publish.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>logRecord: <code class="type"><a href="class_goog_debug_LogRecord.html">goog.debug.LogRecord</a></code><dd>The log record to publish.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l652">code &raquo;</a><span class="member"><a name="config">config</a> <span class="args">( msg, opt_exception )</span></span></div><p>Logs a message at the Logger.Level.CONFIG level.
+ If the logger is currently enabled for the given message level then the
+ given message is forwarded to all the registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>=</code><dd>An exception associated with the message.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l719">code &raquo;</a><span class="member"><a name="doLogRecord_">doLogRecord_</a> <span class="args">( logRecord )</span></span></div><p>Logs a LogRecord.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>logRecord: <code class="type"><a href="class_goog_debug_LogRecord.html">goog.debug.LogRecord</a></code><dd>A log record to log.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l666">code &raquo;</a><span class="member"><a name="fine">fine</a> <span class="args">( msg, opt_exception )</span></span></div><p>Logs a message at the Logger.Level.FINE level.
+ If the logger is currently enabled for the given message level then the
+ given message is forwarded to all the registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>=</code><dd>An exception associated with the message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l680">code &raquo;</a><span class="member"><a name="finer">finer</a> <span class="args">( msg, opt_exception )</span></span></div><p>Logs a message at the Logger.Level.FINER level.
+ If the logger is currently enabled for the given message level then the
+ given message is forwarded to all the registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>=</code><dd>An exception associated with the message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l694">code &raquo;</a><span class="member"><a name="finest">finest</a> <span class="args">( msg, opt_exception )</span></span></div><p>Logs a message at the Logger.Level.FINEST level.
+ If the logger is currently enabled for the given message level then the
+ given message is forwarded to all the registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>=</code><dd>An exception associated with the message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l448">code &raquo;</a><span class="member"><a name="getChildren">getChildren</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Returns the children of this logger as a map of the child name to the logger.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The map where the keys are the child leaf names and the
+     values are the Logger objects.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l498">code &raquo;</a><span class="member"><a name="getEffectiveLevel">getEffectiveLevel</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>Returns the effective level of the logger based on its ancestors' levels.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The level.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l488">code &raquo;</a><span class="member"><a name="getLevel">getLevel</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>Gets the log level specifying which message levels will be logged by this
+ logger. Message levels lower than this value will be discarded.
+ The level value Level.OFF can be used to turn off logging. If the level
+ is null, it means that this node should inherit its level from its nearest
+ ancestor with a specific (non-null) level value.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The level.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l564">code &raquo;</a><span class="member"><a name="getLogRecord">getLogRecord</a> <span class="args">( level, msg, opt_exception, opt_fnStackContext )</span> &rArr; <code class="type">!<a href="class_goog_debug_LogRecord.html">goog.debug.LogRecord</a></code></span></div><p>Creates a new log record and adds the exception (if present) to it.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code><dd>One of the level identifiers.<dt>msg: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string message.<dt>opt_exception: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)=</code><dd>An exception associated with the
+     message.<dt>opt_fnStackContext: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>A function to use as the base
+     of the stack trace used in the log record.</dl><tr><th>Returns<tr><td><dl>A log record.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l390">code &raquo;</a><span class="member"><a name="getName">getName</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the name of this logger.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The name of this logger.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l438">code &raquo;</a><span class="member"><a name="getParent">getParent</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code></span></div><p>Returns the parent of this logger.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The parent logger or null if this is the root.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l638">code &raquo;</a><span class="member"><a name="info">info</a> <span class="args">( msg, opt_exception )</span></span></div><p>Logs a message at the Logger.Level.INFO level.
+ If the logger is currently enabled for the given message level then the
+ given message is forwarded to all the registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>=</code><dd>An exception associated with the message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l524">code &raquo;</a><span class="member"><a name="isLoggable">isLoggable</a> <span class="args">( level )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a message of the given level would actually be logged by this
+ logger. This check is based on the Loggers effective level, which may be
+ inherited from its parent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code><dd>The level to check.</dl><tr><th>Returns<tr><td><dl>Whether the message would be logged.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l539">code &raquo;</a><span class="member"><a name="log">log</a> <span class="args">( level, msg, opt_exception )</span></span></div><p>Logs a message. If the logger is currently enabled for the
+ given message level then the given message is forwarded to all the
+ registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code><dd>One of the level identifiers.<dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)=</code><dd>An exception associated with the
+     message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l707">code &raquo;</a><span class="member"><a name="logRecord">logRecord</a> <span class="args">( logRecord )</span></span></div><p>Logs a LogRecord. If the logger is currently enabled for the
+ given message level then the given message is forwarded to all the
+ registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>logRecord: <code class="type"><a href="class_goog_debug_LogRecord.html">goog.debug.LogRecord</a></code><dd>A log record to log.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l423">code &raquo;</a><span class="member"><a name="removeHandler">removeHandler</a> <span class="args">( handler )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes a handler from the logger. This doesn't use the event system because
+ we want to be able to add logging to the event system.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>handler: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Handler function to remove.</dl><tr><th>Returns<tr><td><dl>Whether the handler was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l465">code &raquo;</a><span class="member"><a name="setLevel">setLevel</a> <span class="args">( level )</span></span></div><p>Set the log level specifying which message levels will be logged by this
+ logger. Message levels lower than this value will be discarded.
+ The level value Level.OFF can be used to turn off logging. If the new level
+ is null, it means that this node should inherit its level from its nearest
+ ancestor with a specific (non-null) level value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code><dd>The new level.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l754">code &raquo;</a><span class="member"><a name="setParent_">setParent_</a> <span class="args">( parent )</span></span></div><p>Sets the parent of this logger. This is used for setting up the logger tree.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code><dd>The parent logger.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l610">code &raquo;</a><span class="member"><a name="severe">severe</a> <span class="args">( msg, opt_exception )</span></span></div><p>Logs a message at the Logger.Level.SEVERE level.
+ If the logger is currently enabled for the given message level then the
+ given message is forwarded to all the registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>=</code><dd>An exception associated with the message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l596">code &raquo;</a><span class="member"><a name="shout">shout</a> <span class="args">( msg, opt_exception )</span></span></div><p>Logs a message at the Logger.Level.SHOUT level.
+ If the logger is currently enabled for the given message level then the
+ given message is forwarded to all the registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>=</code><dd>An exception associated with the message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l624">code &raquo;</a><span class="member"><a name="warning">warning</a> <span class="args">( msg, opt_exception )</span></span></div><p>Logs a message at the Logger.Level.WARNING level.
+ If the logger is currently enabled for the given message level then the
+ given message is forwarded to all the registered output Handler objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="namespace_goog_debug.html#goog.debug.Loggable">goog.debug.Loggable</a></code><dd>The message to log.<dt>opt_exception: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>=</code><dd>An exception associated with the message.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l90">code &raquo;</a><span class="member"><a name="children_">children_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of children loggers. The keys are the leaf names of the children and
+ the values are the child loggers.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l96">code &raquo;</a><span class="member"><a name="handlers_">handlers_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>&gt;</code></span></div><p>Handlers that are listening to this logger.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l83">code &raquo;</a><span class="member"><a name="level_">level_</a> : <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>Level that this logger only filters above. Null indicates it should
+ inherit from the parent.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l70">code &raquo;</a><span class="member"><a name="name_">name_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Name of the Logger. Generally a dot-separated namespace</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l76">code &raquo;</a><span class="member"><a name="parent_">parent_</a> : <code class="type"><a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code></span></div><p>Parent Logger.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l355">code &raquo;</a><span class="member deprecation-notice"><a name="goog.debug.Logger.getLogger">goog.debug.Logger.getLogger</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">use goog.log instead. http://go/goog-debug-logger-deprecated</span></div><p>Finds or creates a logger for a named subsystem. If a logger has already been
+ created with the given name it is returned. Otherwise a new logger is
+ created. If a new logger is created its log level will be configured based
+ on the LogManager configuration and it will configured to also send logging
+ output to its parent's handlers. It will be registered in the LogManager
+ global namespace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A name for the logger. This should be a dot-separated
+ name and should normally be based on the package name or class name of the
+ subsystem, such as goog.net.BrowserChannel.</dl><tr><th>Returns<tr><td><dl>The named logger.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l366">code &raquo;</a><span class="member"><a name="goog.debug.Logger.logToProfilers">goog.debug.Logger.logToProfilers</a> <span class="args">( msg )</span></span></div><p>Logs a message to profiling tools, if available.
+ https://developers.google.com/web-toolkit/speedtracer/logging-api
+ http://msdn.microsoft.com/en-us/library/dd433074(VS.85).aspx</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The message to log.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l101">code &raquo;</a><span class="member"><a name="goog.debug.Logger.ROOT_LOGGER_NAME">goog.debug.Logger.ROOT_LOGGER_NAME</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l117">code &raquo;</a><span class="member"><a name="goog.debug.Logger.rootHandlers_">goog.debug.Logger.rootHandlers_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>&gt;</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l124">code &raquo;</a><span class="member"><a name="goog.debug.Logger.rootLevel_">goog.debug.Logger.rootLevel_</a> : <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div></summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l109">code &raquo;</a><span class="member"><a name="goog.debug.Logger.ENABLE_HIERARCHY">goog.debug.Logger.ENABLE_HIERARCHY</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_debug_Logger_Level.html b/docs/class_goog_debug_Logger_Level.html
new file mode 100644
index 0000000..3454ffd
--- /dev/null
+++ b/docs/class_goog_debug_Logger_Level.html
@@ -0,0 +1,32 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug.Logger.Level</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.debug.Logger.Level</h1><a class="source" href="source/lib/goog/debug/logger.js.src.html#l157">code &raquo;</a></header><section><p>The Level class defines a set of standard logging levels that
+ can be used to control logging output.  The logging Level objects
+ are ordered and are specified by ordered integers.  Enabling logging
+ at a given level also enables logging at all higher levels.
+ <p>
+ Clients should normally use the predefined Level constants such
+ as Level.SEVERE.
+ <p>
+ The levels in descending order are:
+ <ul>
+ <li>SEVERE (highest value)
+ <li>WARNING
+ <li>INFO
+ <li>CONFIG
+ <li>FINE
+ <li>FINER
+ <li>FINEST  (lowest value)
+ </ul>
+ In addition there is a level OFF that can be used to turn
+ off logging, and a level ALL that can be used to enable
+ logging of all messages.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.debug.Logger.Level <span class="args">( name, value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the level.<dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The numeric value of the level.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l176">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>String representation of the logger level.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l162">code &raquo;</a><span class="member"><a name="name">name</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The name of the level</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l168">code &raquo;</a><span class="member"><a name="value">value</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The numeric value of the level</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l293">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.createPredefinedLevelsCache_">goog.debug.Logger.Level.createPredefinedLevelsCache_</a> <span class="args">( )</span></span></div><p>Creates the predefined levels cache and populates it.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l308">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.getPredefinedLevel">goog.debug.Logger.Level.getPredefinedLevel</a> <span class="args">( name )</span> &rArr; <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>Gets the predefined level with the given name.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the level.</dl><tr><th>Returns<tr><td><dl>The level, or null if none found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l322">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.getPredefinedLevelByValue">goog.debug.Logger.Level.getPredefinedLevelByValue</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>Gets the highest predefined level <= #value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Level value.</dl><tr><th>Returns<tr><td><dl>The level, or null if none found.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l259">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.ALL">goog.debug.Logger.Level.ALL</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>ALL indicates that all messages should be logged.
+ This level is initialized to <CODE>0</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l227">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.CONFIG">goog.debug.Logger.Level.CONFIG</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>CONFIG is a message level for static configuration messages.
+ This level is initialized to <CODE>700</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l235">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.FINE">goog.debug.Logger.Level.FINE</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>FINE is a message level providing tracing information.
+ This level is initialized to <CODE>500</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l243">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.FINER">goog.debug.Logger.Level.FINER</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>FINER indicates a fairly detailed tracing message.
+ This level is initialized to <CODE>400</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l251">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.FINEST">goog.debug.Logger.Level.FINEST</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>FINEST indicates a highly detailed tracing message.
+ This level is initialized to <CODE>300</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l219">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.INFO">goog.debug.Logger.Level.INFO</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>INFO is a message level for informational messages.
+ This level is initialized to <CODE>800</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l186">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.OFF">goog.debug.Logger.Level.OFF</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>OFF is a special level that can be used to turn off logging.
+ This level is initialized to <CODE>Infinity</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l267">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.PREDEFINED_LEVELS">goog.debug.Logger.Level.PREDEFINED_LEVELS</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>The predefined levels.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l203">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.SEVERE">goog.debug.Logger.Level.SEVERE</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>SEVERE is a message level indicating a serious failure.
+ This level is initialized to <CODE>1000</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l195">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.SHOUT">goog.debug.Logger.Level.SHOUT</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>SHOUT is a message level for extra debugging loudness.
+ This level is initialized to <CODE>1200</CODE>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l211">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.WARNING">goog.debug.Logger.Level.WARNING</a> : <code class="type">!<a href="class_goog_debug_Logger_Level.html">goog.debug.Logger.Level</a></code></span></div><p>WARNING is a message level indicating a potential problem.
+ This level is initialized to <CODE>900</CODE>.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l286">code &raquo;</a><span class="member"><a name="goog.debug.Logger.Level.predefinedLevelsCache_">goog.debug.Logger.Level.predefinedLevelsCache_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>A lookup map used to find the level object based on the name or value of
+ the level object.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_dom_DomHelper.html b/docs/class_goog_dom_DomHelper.html
new file mode 100644
index 0000000..caa6f2e
--- /dev/null
+++ b/docs/class_goog_dom_DomHelper.html
@@ -0,0 +1,104 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.dom.DomHelper</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.dom.DomHelper</h1><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2156">code &raquo;</a></header><section><p>Create an instance of a DOM helper with a new document object.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.dom.DomHelper <span class="args">( opt_document )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_document: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>=</code><dd>Document object to associate with this
+     DOM helper.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2223">code &raquo;</a><span class="member deprecation-notice"><a name="$">$</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="class_goog_dom_DomHelper.html#getElement">goog.dom.DomHelper.prototype.getElement</a></code> instead.</span></div><p>Alias for <code >getElement</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)</code><dd>Element ID or a DOM node.</dl><tr><th>Returns<tr><td><dl>The element with the given ID, or the node passed in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2302">code &raquo;</a><span class="member deprecation-notice"><a name="$$">$$</a> <span class="args">( opt_tag, opt_class, opt_el )</span> &rArr; <code class="type">{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use DomHelper getElementsByTagNameAndClass.</span></div><p>Alias for <code >getElementsByTagNameAndClass</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_tag: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Element tag name.<dt>opt_class: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional class name.<dt>opt_el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>Array-like list of elements (only a length
+     property and numerical indices are guaranteed to exist).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2387">code &raquo;</a><span class="member deprecation-notice"><a name="$dom">$dom</a> <span class="args">( tagName, opt_attributes, var_args )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="class_goog_dom_DomHelper.html#createDom">goog.dom.DomHelper.prototype.createDom</a></code> instead.</span></div><p>Alias for <code >createDom</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tagName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Tag to create.<dt>opt_attributes: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)=</code><dd>If object, then a map of name-value
+     pairs for attributes. If a string, then this is the className of the new
+     element.<dt>var_args: <code class="type">...<a href="namespace_goog_dom.html#goog.dom.Appendable">goog.dom.Appendable</a></code><dd>Further DOM nodes or strings for
+     text nodes.  If one of the var_args is an array, its children will be
+     added as childNodes instead.</dl><tr><th>Returns<tr><td><dl>Reference to a DOM node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2501">code &raquo;</a><span class="member"><a name="append">append</a> <span class="args">( parent, var_args )</span></span></div><p>Appends a node with text or other nodes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to append nodes to.<dt>var_args: <code class="type">...<a href="namespace_goog_dom.html#goog.dom.Appendable">goog.dom.Appendable</a></code><dd>The things to append to the node.
+     If this is a Node it is appended as is.
+     If this is a string then a text node is appended.
+     If this is an array like object then fields 0 to length - 1 are appended.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2490">code &raquo;</a><span class="member"><a name="appendChild">appendChild</a> <span class="args">( parent, child )</span></span></div><p>Appends a child to a node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Parent.<dt>child: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Child.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2511">code &raquo;</a><span class="member"><a name="canHaveChildren">canHaveChildren</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines if the given node can contain children, intended to be used for
+ HTML generation.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to check.</dl><tr><th>Returns<tr><td><dl>Whether the node can contain children.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2695">code &raquo;</a><span class="member"><a name="compareNodeOrder">compareNodeOrder</a> <span class="args">( node1, node2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Compares the document order of two nodes, returning 0 if they are the same
+ node, a negative number if node1 is before node2, and a positive number if
+ node2 is before node1.  Note that we compare the order the tags appear in the
+ document so in the tree <b><i>text</i></b> the B node is considered to be
+ before the I node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node1: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The first node to compare.<dt>node2: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The second node to compare.</dl><tr><th>Returns<tr><td><dl>0 if the nodes are the same node, a negative number if node1
+     is before node2, and a positive number if node2 is before node1.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2680">code &raquo;</a><span class="member"><a name="contains">contains</a> <span class="args">( parent, descendant )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether a node contains another node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node that should contain the other node.<dt>descendant: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to test presence of.</dl><tr><th>Returns<tr><td><dl>Whether the parent node contains the descendent node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2368">code &raquo;</a><span class="member"><a name="createDom">createDom</a> <span class="args">( tagName, opt_attributes, var_args )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns a dom node with a set of attributes.  This function accepts varargs
+ for subsequent nodes to be added.  Subsequent nodes will be added to the
+ first node as childNodes.
+
+ So:
+ <code>createDom('div', null, createDom('p'), createDom('p'));</code>
+ would return a div with two child paragraphs
+
+ An easy way to move all child nodes of an existing element to a new parent
+ element is:
+ <code>createDom('div', null, oldElement.childNodes);</code>
+ which will remove all child nodes from the old element and add them as
+ child nodes of the new DIV.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tagName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Tag to create.<dt>opt_attributes: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)=</code><dd>If object, then a map of name-value
+     pairs for attributes. If a string, then this is the className of the new
+     element.<dt>var_args: <code class="type">...<a href="namespace_goog_dom.html#goog.dom.Appendable">goog.dom.Appendable</a></code><dd>Further DOM nodes or
+     strings for text nodes. If one of the var_args is an array or
+     NodeList, its elements will be added as childNodes instead.</dl><tr><th>Returns<tr><td><dl>Reference to a DOM node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2395">code &raquo;</a><span class="member"><a name="createElement">createElement</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Creates a new element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Tag name.</dl><tr><th>Returns<tr><td><dl>The new element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2417">code &raquo;</a><span class="member"><a name="createTable">createTable</a> <span class="args">( rows, columns, opt_fillWithNbsp )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Create a table.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rows: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of rows in the table.  Must be >= 1.<dt>columns: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of columns in the table.  Must be >= 1.<dt>opt_fillWithNbsp: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, fills table entries with nsbps.</dl><tr><th>Returns<tr><td><dl>The created table.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2405">code &raquo;</a><span class="member"><a name="createTextNode">createTextNode</a> <span class="args">( content )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1312295772">Text</a></code></span></div><p>Creates a new text node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>content: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>Content.</dl><tr><th>Returns<tr><td><dl>The new text node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2705">code &raquo;</a><span class="member"><a name="findCommonAncestor">findCommonAncestor</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Find the deepest common ancestor of the given nodes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The nodes to find a common ancestor of.</dl><tr><th>Returns<tr><td><dl>The common ancestor of the nodes, or null if there is none.
+     null will only be returned if two or more of the nodes are from different
+     documents.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2758">code &raquo;</a><span class="member"><a name="findNode">findNode</a> <span class="args">( root, p )</span> &rArr; <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Finds the first descendant node that matches the filter function. This does
+ a depth first search.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>root: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The root of the tree to search.<dt>p: <code class="type">function(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The filter function.</dl><tr><th>Returns<tr><td><dl>The found node or undefined if none is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2768">code &raquo;</a><span class="member"><a name="findNodes">findNodes</a> <span class="args">( root, p )</span> &rArr; <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>&gt;</code></span></div><p>Finds all the descendant nodes that matches the filter function. This does a
+ depth first search.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>root: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The root of the tree to search.<dt>p: <code class="type">function(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The filter function.</dl><tr><th>Returns<tr><td><dl>The found nodes or an empty array if none are found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2575">code &raquo;</a><span class="member"><a name="flattenElement">flattenElement</a> <span class="args">( element )</span> &rArr; <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Flattens an element. That is, removes it and replace it with its children.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to flatten.</dl><tr><th>Returns<tr><td><dl>The original element, detached from the document
+     tree, sans children, or undefined if the element was already not in the
+     document.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2480">code &raquo;</a><span class="member"><a name="getActiveElement">getActiveElement</a> <span class="args">( opt_doc )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Determines the active element in the given document.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_doc: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>=</code><dd>The document to look in.</dl><tr><th>Returns<tr><td><dl>The active element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2910">code &raquo;</a><span class="member"><a name="getAncestor">getAncestor</a> <span class="args">( element, matcher, opt_includeNode, opt_maxSearchSteps )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Walks up the DOM hierarchy returning the first ancestor that passes the
+ matcher function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The DOM node to start with.<dt>matcher: <code class="type">function(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>A function that returns true if the
+     passed node matches the desired criteria.<dt>opt_includeNode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, the node itself is included in
+     the search (the first call to the matcher will pass startElement as
+     the node to test).<dt>opt_maxSearchSteps: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Maximum number of levels to search up the
+     dom.</dl><tr><th>Returns<tr><td><dl>DOM node that matched the matcher, or null if there was
+     no match.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2892">code &raquo;</a><span class="member"><a name="getAncestorByClass">getAncestorByClass</a> <span class="args">( element, class )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Walks up the DOM hierarchy returning the first ancestor that has the passed
+ class name. If the passed element matches the specified criteria, the
+ element itself is returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The DOM node to start with.<dt>class: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The class name to match.</dl><tr><th>Returns<tr><td><dl>The first ancestor that matches the passed criteria, or
+     null if none match.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2879">code &raquo;</a><span class="member"><a name="getAncestorByTagNameAndClass">getAncestorByTagNameAndClass</a> <span class="args">( element, opt_tag, opt_class )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Walks up the DOM hierarchy returning the first ancestor that has the passed
+ tag name and/or class name. If the passed element matches the specified
+ criteria, the element itself is returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The DOM node to start with.<dt>opt_tag: <code class="type">?(<a href="enum_goog_dom_TagName.html">goog.dom.TagName</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)=</code><dd>The tag name to match (or
+     null/undefined to match only based on class name).<dt>opt_class: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The class name to match (or null/undefined to
+     match only based on tag name).</dl><tr><th>Returns<tr><td><dl>The first ancestor that matches the passed criteria, or
+     null if no match is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2584">code &raquo;</a><span class="member"><a name="getChildren">getChildren</a> <span class="args">( element )</span> &rArr; <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-536297177">NodeList</a>)</code></span></div><p>Returns an array containing just the element children of the given element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element whose element children we want.</dl><tr><th>Returns<tr><td><dl>An array or array-like list of just the element
+     children of the given element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2187">code &raquo;</a><span class="member"><a name="getDocument">getDocument</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div><p>Gets the document object being used by the dom library.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Document object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2332">code &raquo;</a><span class="member"><a name="getDocumentHeight">getDocumentHeight</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Calculates the height of the document.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The height of the document.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2470">code &raquo;</a><span class="member"><a name="getDocumentScroll">getDocumentScroll</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Gets the document scroll distance as a coordinate object.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Object with properties 'x' and 'y'.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2461">code &raquo;</a><span class="member"><a name="getDocumentScrollElement">getDocumentScrollElement</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Gets the document scroll element.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Scrolling element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2171">code &raquo;</a><span class="member"><a name="getDomHelper">getDomHelper</a> <span class="args">( opt_node )</span> &rArr; <code class="type">!<a href="class_goog_dom_DomHelper.html">goog.dom.DomHelper</a></code></span></div><p>Gets the dom helper object for the document where the element resides.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>=</code><dd>If present, gets the DomHelper for this node.</dl><tr><th>Returns<tr><td><dl>The DomHelper.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2198">code &raquo;</a><span class="member"><a name="getElement">getElement</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Alias for <code >getElementById</code>. If a DOM node is passed in then we just
+ return that.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)</code><dd>Element ID or a DOM node.</dl><tr><th>Returns<tr><td><dl>The element with the given ID, or the node passed in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2268">code &raquo;</a><span class="member"><a name="getElementByClass">getElementByClass</a> <span class="args">( className, opt_el )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first element we find matching the provided class name.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>the name of the class to look for.<dt>opt_el: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>)=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>The first item found with the class name provided.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2255">code &raquo;</a><span class="member"><a name="getElementsByClass">getElementsByClass</a> <span class="args">( className, opt_el )</span> &rArr; <code class="type">{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code></span></div><p>Returns an array of all the elements with the provided className.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>the name of the class to look for.<dt>opt_el: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>)=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>The items found with the class name provided.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2240">code &raquo;</a><span class="member"><a name="getElementsByTagNameAndClass">getElementsByTagNameAndClass</a> <span class="args">( opt_tag, opt_class, opt_el )</span> &rArr; <code class="type">{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code></span></div><p>Looks up elements by both tag and class name, using browser native functions
+ (<code >querySelectorAll</code>, <code >getElementsByTagName</code> or
+ <code >getElementsByClassName</code>) where possible. The returned array is a live
+ NodeList or a static list depending on the code path taken.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_tag: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Element tag name or * for all tags.<dt>opt_class: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional class name.<dt>opt_el: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>Array-like list of elements (only a length
+     property and numerical indices are guaranteed to exist).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2592">code &raquo;</a><span class="member"><a name="getFirstElementChild">getFirstElementChild</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first child node that is an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the first child element of.</dl><tr><th>Returns<tr><td><dl>The first child node of <code >node</code> that is an element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2721">code &raquo;</a><span class="member"><a name="getFrameContentDocument">getFrameContentDocument</a> <span class="args">( iframe )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div><p>Cross browser function for getting the document element of an iframe.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iframe: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Iframe element.</dl><tr><th>Returns<tr><td><dl>The frame content document.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2730">code &raquo;</a><span class="member"><a name="getFrameContentWindow">getFrameContentWindow</a> <span class="args">( frame )</span> &rArr; <code class="type">Window</code></span></div><p>Cross browser function for getting the window of a frame or iframe.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frame: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Frame element.</dl><tr><th>Returns<tr><td><dl>The window associated with the given frame.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2601">code &raquo;</a><span class="member"><a name="getLastElementChild">getLastElementChild</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the last child node that is an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the last child element of.</dl><tr><th>Returns<tr><td><dl>The last child node of <code >node</code> that is an element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2609">code &raquo;</a><span class="member"><a name="getNextElementSibling">getNextElementSibling</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first next sibling that is an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the next sibling element of.</dl><tr><th>Returns<tr><td><dl>The next sibling of <code >node</code> that is an element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2629">code &raquo;</a><span class="member"><a name="getNextNode">getNextNode</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Returns the next node in source order from the given node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node.</dl><tr><th>Returns<tr><td><dl>The next node in the DOM tree, or null if this was the last
+     node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2854">code &raquo;</a><span class="member"><a name="getNodeAtOffset">getNodeAtOffset</a> <span class="args">( parent, offset, opt_result )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Returns the node at a given offset in a parent node.  If an object is
+ provided for the optional third parameter, the node and the remainder of the
+ offset will stored as properties of this object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The parent node.<dt>offset: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The offset into the parent node.<dt>opt_result: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object to be used to store the return value. The
+     return value will be stored in the form {node: Node, remainder: number}
+     if this object is provided.</dl><tr><th>Returns<tr><td><dl>The node at the given offset.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2828">code &raquo;</a><span class="member"><a name="getNodeTextLength">getNodeTextLength</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the text length of the text contained in a node, without markup. This
+ is equivalent to the selection length if the node was selected, or the number
+ of cursor movements to traverse the node. Images & BRs take one space.  New
+ lines are ignored.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node whose text content length is being calculated.</dl><tr><th>Returns<tr><td><dl>The length of <code >node</code>'s text content.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2840">code &raquo;</a><span class="member"><a name="getNodeTextOffset">getNodeTextOffset</a> <span class="args">( node, opt_offsetParent )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the text offset of a node relative to one of its ancestors. The text
+ length is the same as the length calculated by
+ <code >goog.dom.getNodeTextLength</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node whose offset is being calculated.<dt>opt_offsetParent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>=</code><dd>Defaults to the node's owner document's body.</dl><tr><th>Returns<tr><td><dl>The text offset.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2748">code &raquo;</a><span class="member"><a name="getOuterHtml">getOuterHtml</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the outerHTML of a node, which islike innerHTML, except that it
+ actually contains the HTML of the node itself.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the HTML of.</dl><tr><th>Returns<tr><td><dl>The outerHTML of the given element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2713">code &raquo;</a><span class="member"><a name="getOwnerDocument">getOwnerDocument</a> <span class="args">( node )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div><p>Returns the owner document for a node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the document for.</dl><tr><th>Returns<tr><td><dl>The document owning the node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2671">code &raquo;</a><span class="member"><a name="getParentElement">getParentElement</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns an element's parent, if it's an Element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The DOM element.</dl><tr><th>Returns<tr><td><dl>The parent, or null if not an Element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2619">code &raquo;</a><span class="member"><a name="getPreviousElementSibling">getPreviousElementSibling</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first previous sibling that is an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the previous sibling element of.</dl><tr><th>Returns<tr><td><dl>The first previous sibling of <code >node</code> that is
+     an element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2638">code &raquo;</a><span class="member"><a name="getPreviousNode">getPreviousNode</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Returns the previous node in source order from the given node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node.</dl><tr><th>Returns<tr><td><dl>The previous node in the DOM tree, or null if this was the
+     first node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2212">code &raquo;</a><span class="member"><a name="getRequiredElement">getRequiredElement</a> <span class="args">( id )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Gets an element by id, asserting that the element is found.
+
+ This is used when an element is expected to exist, and should fail with
+ an assertion error if it does not (if assertions are enabled).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>id: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Element ID.</dl><tr><th>Returns<tr><td><dl>The element with the given ID, if it exists.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2284">code &raquo;</a><span class="member"><a name="getRequiredElementByClass">getRequiredElementByClass</a> <span class="args">( className, opt_root )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Ensures an element with the given className exists, and then returns the
+ first element with the provided className.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>the name of the class to look for.<dt>opt_root: <code class="type">(!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>)=</code><dd>Optional element or document to look
+     in.</dl><tr><th>Returns<tr><td><dl>The first item found with the class name provided.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>Thrown if no element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2816">code &raquo;</a><span class="member"><a name="getTextContent">getTextContent</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the text contents of the current node, without markup. New lines are
+ stripped and whitespace is collapsed, such that each character would be
+ visible.
+
+ In browsers that support it, innerText is used.  Other browsers attempt to
+ simulate it via node traversal.  Line breaks are canonicalized in IE.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node from which we are getting content.</dl><tr><th>Returns<tr><td><dl>The text content.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2320">code &raquo;</a><span class="member"><a name="getViewportSize">getViewportSize</a> <span class="args">( opt_window )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Gets the dimensions of the viewport.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_window: <code class="type">Window=</code><dd>Optional window element to test. Defaults to
+     the window of the Dom Helper.</dl><tr><th>Returns<tr><td><dl>Object with values 'width' and 'height'.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2452">code &raquo;</a><span class="member"><a name="getWindow">getWindow</a> <span class="args">( )</span> &rArr; <code class="type">!Window</code></span></div><p>Gets the window object associated with the document.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The window associated with the given document.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2433">code &raquo;</a><span class="member"><a name="htmlToDocumentFragment">htmlToDocumentFragment</a> <span class="args">( htmlString )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Converts an HTML string into a node or a document fragment.  A single Node
+ is used if the <code >htmlString</code> only generates a single node.  If the
+ <code >htmlString</code> generates multiple nodes then these are put inside a
+ <code >DocumentFragment</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>htmlString: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The HTML string to convert.</dl><tr><th>Returns<tr><td><dl>The resulting node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2548">code &raquo;</a><span class="member"><a name="insertChildAt">insertChildAt</a> <span class="args">( parent, child, index )</span></span></div><p>Insert a child at a given index. If index is larger than the number of child
+ nodes that the parent currently has, the node is inserted as the last child
+ node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element into which to insert the child.<dt>child: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The element to insert.<dt>index: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index at which to insert the new child node. Must
+     not be negative.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2536">code &raquo;</a><span class="member"><a name="insertSiblingAfter">insertSiblingAfter</a> <span class="args">( newNode, refNode )</span></span></div><p>Inserts a new node after an existing reference node (i.e., as the next
+ sibling). If the reference node has no parent, then does nothing.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to insert.<dt>refNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Reference node to insert after.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2527">code &raquo;</a><span class="member"><a name="insertSiblingBefore">insertSiblingBefore</a> <span class="args">( newNode, refNode )</span></span></div><p>Inserts a new node before an existing reference node (i.e., as the previous
+ sibling). If the reference node has no parent, then does nothing.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to insert.<dt>refNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Reference node to insert before.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2443">code &raquo;</a><span class="member"><a name="isCss1CompatMode">isCss1CompatMode</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the browser is in "CSS1-compatible" (standards-compliant)
+ mode, false otherwise.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>True if in CSS1-compatible mode.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2654">code &raquo;</a><span class="member"><a name="isElement">isElement</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object looks like an Element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">?</code><dd>The object being tested for Element likeness.</dl><tr><th>Returns<tr><td><dl>Whether the object looks like an Element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2802">code &raquo;</a><span class="member"><a name="isFocusable">isFocusable</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element can be focused, i.e. it has a tab index that
+ allows it to receive keyboard focus (tabIndex >= 0), or it is an element
+ that natively supports keyboard focus.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element allows keyboard focus.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2779">code &raquo;</a><span class="member"><a name="isFocusableTabIndex">isFocusableTabIndex</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element has a tab index that allows it to receive
+ keyboard focus (tabIndex >= 0), false otherwise.  Note that some elements
+ natively support keyboard focus, even if they have no tab index.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element has a tab index that allows keyboard
+     focus.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2646">code &raquo;</a><span class="member"><a name="isNodeLike">isNodeLike</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object looks like a DOM node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">?</code><dd>The object being tested for node likeness.</dl><tr><th>Returns<tr><td><dl>Whether the object looks like a DOM node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2864">code &raquo;</a><span class="member"><a name="isNodeList">isNodeList</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the object is a <code >NodeList</code>.  To qualify as a NodeList,
+ the object must have a numeric length property and an item function (which
+ has type 'string' on IE for some reason).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object to test.</dl><tr><th>Returns<tr><td><dl>Whether the object is a NodeList.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2663">code &raquo;</a><span class="member"><a name="isWindow">isWindow</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a Window object. This includes the
+ global window for HTML pages, and iframe windows.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether the variable is a window.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2518">code &raquo;</a><span class="member"><a name="removeChildren">removeChildren</a> <span class="args">( node )</span></span></div><p>Removes all the child nodes on a DOM node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to remove children from.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2556">code &raquo;</a><span class="member"><a name="removeNode">removeNode</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Removes a node from its parent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to remove.</dl><tr><th>Returns<tr><td><dl>The node removed if removed; else, null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2565">code &raquo;</a><span class="member"><a name="replaceNode">replaceNode</a> <span class="args">( newNode, oldNode )</span></span></div><p>Replaces a node in the DOM tree. Will do nothing if <code >oldNode</code> has no
+ parent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to insert.<dt>oldNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to replace.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2178">code &raquo;</a><span class="member"><a name="setDocument">setDocument</a> <span class="args">( document )</span></span></div><p>Sets the document object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>document: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>Document object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2791">code &raquo;</a><span class="member"><a name="setFocusableTabIndex">setFocusableTabIndex</a> <span class="args">( element, enable )</span></span></div><p>Enables or disables keyboard focus support on the element via its tab index.
+ Only elements for which <code  class="type"><a href="namespace_goog_dom.html#goog.dom.isFocusableTabIndex">goog.dom.isFocusableTabIndex</a></code> returns true
+ (or elements that natively support keyboard focus, like form elements) can
+ receive keyboard focus.  See http://go/tabindex for more info.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element whose tab index is to be changed.<dt>enable: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether to set or remove a tab index on the element
+     that supports keyboard focus.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2311">code &raquo;</a><span class="member"><a name="setProperties">setProperties</a> <span class="args">( element, properties )</span></span></div><p>Sets a number of properties on a node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>DOM node to set properties on.<dt>properties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Hash of property:value pairs.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2739">code &raquo;</a><span class="member"><a name="setTextContent">setTextContent</a> <span class="args">( node, text )</span></span></div><p>Sets the text content of a node, with cross-browser support.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to change the text content of.<dt>text: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The value that should replace the node's content.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2162">code &raquo;</a><span class="member"><a name="document_">document_</a> : <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div><p>Reference to the document object to use</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_events_BrowserEvent.html b/docs/class_goog_events_BrowserEvent.html
new file mode 100644
index 0000000..ed9fdc9
--- /dev/null
+++ b/docs/class_goog_events_BrowserEvent.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.BrowserEvent</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.events.BrowserEvent</h1><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l66">code &raquo;</a><pre><code><a href="class_goog_events_Event.html">goog.events.Event</a>
+  &#x2514; goog.events.BrowserEvent</code></pre></header><section><p>Accepts a browser event object and creates a patched, cross browser event
+ object.
+ The content of this object will not be initialized if no event object is
+ provided. If this is the case, init() needs to be invoked separately.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.events.BrowserEvent <span class="args">( opt_e, opt_currentTarget )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_e: <code class="type">Event=</code><dd>Browser event object.<dt>opt_currentTarget: <code class="type">EventTarget=</code><dd>Current target for event.</dl></table></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_events_BrowserEvent_MouseButton.html">goog.events.BrowserEvent.MouseButton</a><dd>Normalized button constants for the mouse.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.events.BrowserEvent</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l389">code &raquo;</a><span class="member"><a name="disposeInternal">disposeInternal</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l383">code &raquo;</a><span class="member"><a name="getBrowserEvent">getBrowserEvent</a> <span class="args">( )</span> &rArr; <code class="type">Event</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The underlying browser event object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l222">code &raquo;</a><span class="member"><a name="init">init</a> <span class="args">( e, opt_currentTarget )</span></span></div><p>Accepts a browser event object and creates a patched, cross browser event
+ object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type">Event</code><dd>Browser event object.<dt>opt_currentTarget: <code class="type">EventTarget=</code><dd>Current target for event.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l297">code &raquo;</a><span class="member"><a name="isButton">isButton</a> <span class="args">( button )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests to see which button was pressed during the event. This is really only
+ useful in IE and Gecko browsers. And in IE, it's only useful for
+ mousedown/mouseup events, because click only fires for the left mouse button.
+
+ Safari 2 only reports the left button being clicked, and uses the value '1'
+ instead of 0. Opera only reports a mousedown event for the middle button, and
+ no mouse events for the right button. Opera has default behavior for left and
+ middle click that can only be overridden via a configuration setting.
+
+ There's a nice table of this mess at http://www.unixpapa.com/js/mouse.html.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>button: <code class="type"><a href="enum_goog_events_BrowserEvent_MouseButton.html">goog.events.BrowserEvent.MouseButton</a></code><dd>The button
+     to test for.</dl><tr><th>Returns<tr><td><dl>True if button was pressed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l319">code &raquo;</a><span class="member"><a name="isMouseActionButton">isMouseActionButton</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether this has an "action"-producing mouse button.
+
+ By definition, this includes left-click on windows/linux, and left-click
+ without the ctrl key on Macs.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l343">code &raquo;</a><span class="member"><a name="preventDefault">preventDefault</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l330">code &raquo;</a><span class="member"><a name="stopPropagation">stopPropagation</a> <span class="args">( )</span></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_events_Event.html">goog.events.Event</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l121">code &raquo;</a><span class="member deprecation-notice"><a name="dispose">dispose</a> <span class="args">( )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Events don't need to be disposed.</span></div><p>For backwards compatibility (goog.events.Event used to inherit
+ goog.Disposable).</summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.events.BrowserEvent</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l153">code &raquo;</a><span class="member"><a name="altKey">altKey</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether alt was pressed at time of event.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l129">code &raquo;</a><span class="member"><a name="button">button</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Which mouse button was pressed.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l141">code &raquo;</a><span class="member"><a name="charCode">charCode</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Keycode of key press.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l105">code &raquo;</a><span class="member"><a name="clientX">clientX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>X-coordinate relative to the window.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l111">code &raquo;</a><span class="member"><a name="clientY">clientY</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Y-coordinate relative to the window.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l147">code &raquo;</a><span class="member"><a name="ctrlKey">ctrlKey</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether control was pressed at time of event.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l81">code &raquo;</a><span class="member"><a name="currentTarget">currentTarget</a> : <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Node that had the listener attached.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l185">code &raquo;</a><span class="member"><a name="event_">event_</a> : <code class="type">Event</code></span></div><p>The browser event object.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l135">code &raquo;</a><span class="member"><a name="keyCode">keyCode</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Keycode of key press.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l165">code &raquo;</a><span class="member"><a name="metaKey">metaKey</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the meta key was pressed at time of event.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l93">code &raquo;</a><span class="member"><a name="offsetX">offsetX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>X-coordinate relative to target.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l99">code &raquo;</a><span class="member"><a name="offsetY">offsetY</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Y-coordinate relative to target.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l179">code &raquo;</a><span class="member"><a name="platformModifierKey">platformModifierKey</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the default platform modifier key was pressed at time of event.
+ (This is control for all platforms except Mac, where it's Meta.)</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l87">code &raquo;</a><span class="member"><a name="relatedTarget">relatedTarget</a> : <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>For mouseover and mouseout events, the related object for the event.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l117">code &raquo;</a><span class="member"><a name="screenX">screenX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>X-coordinate relative to the monitor.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l123">code &raquo;</a><span class="member"><a name="screenY">screenY</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Y-coordinate relative to the monitor.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l159">code &raquo;</a><span class="member"><a name="shiftKey">shiftKey</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether shift was pressed at time of event.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l172">code &raquo;</a><span class="member"><a name="state">state</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>History state object, only set for PopState events where it's a copy of the
+ state object provided to pushState or replaceState.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l74">code &raquo;</a><span class="member"><a name="target">target</a> : <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Target that fired the event.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_events_Event.html">goog.events.Event</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l94">code &raquo;</a><span class="member"><a name="defaultPrevented">defaultPrevented</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the default action has been prevented.
+ This is a property to match the W3C specification at
+ <code  class="type"><a class="unresolved-link">#events-event-type-defaultPrevented</a></code>.
+ Must be treated as read-only outside the class.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l84">code &raquo;</a><span class="member"><a name="propagationStopped_">propagationStopped_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether to cancel the event in internal capture/bubble processing for IE.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l103">code &raquo;</a><span class="member"><a name="returnValue_">returnValue_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Return value for in internal capture/bubble processing for IE.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l60">code &raquo;</a><span class="member"><a name="type">type</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Event type.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l209">code &raquo;</a><span class="member"><a name="goog.events.BrowserEvent.IEButtonMap">goog.events.BrowserEvent.IEButtonMap</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code></span></div><p>Static data for mapping mouse buttons.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l66">code &raquo;</a><span class="member"><a name="goog.events.BrowserEvent.superClass_">goog.events.BrowserEvent.superClass_</a> : <code class="type"><a href="class_goog_events_Event.html">goog.events.Event.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_events_Event.html b/docs/class_goog_events_Event.html
new file mode 100644
index 0000000..654a97d
--- /dev/null
+++ b/docs/class_goog_events_Event.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.Event</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.events.Event</h1><a class="source" href="source/lib/goog/events/event.js.src.html#l55">code &raquo;</a></header><section><p>A base class for event objects, so that they can support preventDefault and
+ stopPropagation.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.events.Event <span class="args">( type, opt_target )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>Event Type.<dt>opt_target: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Reference to the object that is the target of
+     this event. It has to implement the <code >EventTarget</code> interface
+     declared at <code  class="type"><a class="unresolved-link">http://developer.mozilla.org/en/DOM/EventTarget</a></code>.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l121">code &raquo;</a><span class="member deprecation-notice"><a name="dispose">dispose</a> <span class="args">( )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Events don't need to be disposed.</span></div><p>For backwards compatibility (goog.events.Event used to inherit
+ goog.Disposable).</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l112">code &raquo;</a><span class="member deprecation-notice"><a name="disposeInternal">disposeInternal</a> <span class="args">( )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Events don't need to be disposed.</span></div><p>For backwards compatibility (goog.events.Event used to inherit
+ goog.Disposable).</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l136">code &raquo;</a><span class="member"><a name="preventDefault">preventDefault</a> <span class="args">( )</span></span></div><p>Prevents the default action, for example a link redirecting to a url.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l128">code &raquo;</a><span class="member"><a name="stopPropagation">stopPropagation</a> <span class="args">( )</span></span></div><p>Stops event propagation.</summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l75">code &raquo;</a><span class="member"><a name="currentTarget">currentTarget</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Object that had the listener attached.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l94">code &raquo;</a><span class="member"><a name="defaultPrevented">defaultPrevented</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the default action has been prevented.
+ This is a property to match the W3C specification at
+ <code  class="type"><a class="unresolved-link">#events-event-type-defaultPrevented</a></code>.
+ Must be treated as read-only outside the class.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l84">code &raquo;</a><span class="member"><a name="propagationStopped_">propagationStopped_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether to cancel the event in internal capture/bubble processing for IE.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l103">code &raquo;</a><span class="member"><a name="returnValue_">returnValue_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Return value for in internal capture/bubble processing for IE.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l69">code &raquo;</a><span class="member"><a name="target">target</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>TODO(user): The type should probably be
+ EventTarget|goog.events.EventTarget.
+
+ Target of the event.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l60">code &raquo;</a><span class="member"><a name="type">type</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Event type.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l159">code &raquo;</a><span class="member"><a name="goog.events.Event.preventDefault">goog.events.Event.preventDefault</a> <span class="args">( e )</span></span></div><p>Prevents the default action. It is equivalent to
+ <code >e.preventDefault()</code>, but can be used as the callback argument of
+ <code  class="type"><a href="namespace_goog_events.html#goog.events.listen">goog.events.listen</a></code> without declaring another function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type">!<a href="class_goog_events_Event.html">goog.events.Event</a></code><dd>An event.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l148">code &raquo;</a><span class="member"><a name="goog.events.Event.stopPropagation">goog.events.Event.stopPropagation</a> <span class="args">( e )</span></span></div><p>Stops the propagation of the event. It is equivalent to
+ <code >e.stopPropagation()</code>, but can be used as the callback argument of
+ <code  class="type"><a href="namespace_goog_events.html#goog.events.listen">goog.events.listen</a></code> without declaring another function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type">!<a href="class_goog_events_Event.html">goog.events.Event</a></code><dd>An event.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_events_EventId.html b/docs/class_goog_events_EventId.html
new file mode 100644
index 0000000..4511526
--- /dev/null
+++ b/docs/class_goog_events_EventId.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.EventId</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.events.EventId.<code class="type">&lt;T&gt;</code></h1><a class="source" href="source/lib/goog/events/eventid.js.src.html#l37">code &raquo;</a></header><section><p>A templated class that is used when registering for events. Typical usage:
+ <code>
+   /** @type {goog.events.EventId.<MyEventObj>}
+   var myEventId = new goog.events.EventId(
+       goog.events.getUniqueId(('someEvent'));
+
+   // No need to cast or declare here since the compiler knows the correct
+   // type of 'evt' (MyEventObj).
+   something.listen(myEventId, function(evt) {});
+ </code><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.events.EventId <span class="args">( eventId )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>eventId</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventid.js.src.html#l45">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/eventid.js.src.html#l38">code &raquo;</a><span class="member"><a name="id">id</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_events_EventTarget.html b/docs/class_goog_events_EventTarget.html
new file mode 100644
index 0000000..2cc42c8
--- /dev/null
+++ b/docs/class_goog_events_EventTarget.html
@@ -0,0 +1,68 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.EventTarget</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.events.EventTarget</h1><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l70">code &raquo;</a><pre><code><a href="class_goog_Disposable.html">goog.Disposable</a>
+  &#x2514; goog.events.EventTarget</code></pre><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_disposable_IDisposable.html">goog.disposable.IDisposable</a></code>, <code><a href="interface_goog_events_Listenable.html">goog.events.Listenable</a></code></dl></header><section><p>An implementation of <code >goog.events.Listenable</code> with full W3C
+ EventTarget-like support (capture/bubble mechanism, stopping event
+ propagation, preventing default actions).
+
+ You may subclass this class to turn your class into a Listenable.
+
+ Unless propagation is stopped, an event dispatched by an
+ EventTarget will bubble to the parent returned by
+ <code >getParentEventTarget</code>. To set the parent, call
+ <code >setParentEventTarget</code>. Subclasses that don't support
+ changing the parent can override the setter to throw an error.
+
+ Example usage:
+ <pre>
+   var source = new goog.events.EventTarget();
+   function handleEvent(e) {
+     alert('Type: ' + e.type + '; Target: ' + e.target);
+   }
+   source.listen('foo', handleEvent);
+   // Or: goog.events.listen(source, 'foo', handleEvent);
+   ...
+   source.dispatchEvent('foo');  // will call handleEvent
+   ...
+   source.unlisten('foo', handleEvent);
+   // Or: goog.events.unlisten(source, 'foo', handleEvent);
+ </pre><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.events.EventTarget <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.events.EventTarget</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l151">code &raquo;</a><span class="member deprecation-notice"><a name="addEventListener">addEventListener</a> <span class="args">( type, handler, opt_capture, opt_handlerScope )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code >#listen</code> instead, when possible. Otherwise, use
+     <code >goog.events.listen</code> if you are passing Object
+     (instead of Function) as handler.</span></div><p>Adds an event listener to the event target. The same handler can only be
+ added once per the type. Even if you add the same handler multiple times
+ using the same type then it will only be called once when the event is
+ dispatched.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of the event to listen for.<dt>handler: <code class="type">(function(?): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code><dd>The function
+     to handle the event. The handler can also be an object that implements
+     the handleEvent method which takes the event object as argument.<dt>opt_capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>In DOM-compliant browsers, this determines
+     whether the listener is fired during the capture or bubble phase
+     of the event.<dt>opt_handlerScope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object in whose scope to call
+     the listener.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l330">code &raquo;</a><span class="member"><a name="assertInitialized_">assertInitialized_</a> <span class="args">( )</span></span></div><p>Asserts that the event target instance is initialized properly.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l182">code &raquo;</a><span class="member"><a name="dispatchEvent">dispatchEvent</a> <span class="args">( e )</span> &rArr; <code class="type">boolean</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l208">code &raquo;</a><span class="member"><a name="disposeInternal">disposeInternal</a> <span class="args">( )</span></span></div><p>Removes listeners from this object.  Classes that extend EventTarget may
+ need to override this method in order to remove references to DOM Elements
+ and additional listeners.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l262">code &raquo;</a><span class="member"><a name="fireListeners">fireListeners</a> <span class="args">( type, capture, eventObject )</span> &rArr; <code class="type">boolean</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type<dt>capture<dt>eventObject</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l300">code &raquo;</a><span class="member"><a name="getListener">getListener</a> <span class="args">( type, listener, capture, opt_listenerScope )</span> &rArr; <code class="type">(goog.events.ListenableKey|null)</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type<dt>listener<dt>capture<dt>opt_listenerScope</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l294">code &raquo;</a><span class="member"><a name="getListeners">getListeners</a> <span class="args">( type, capture )</span> &rArr; <code class="type">Array.<(goog.events.ListenableKey|null)></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type<dt>capture</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l117">code &raquo;</a><span class="member"><a name="getParentEventTarget">getParentEventTarget</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_events_EventTarget.html">goog.events.EventTarget</a></code></span></div><p>Returns the parent of this event target to use for bubbling.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The parent EventTarget or null if
+     there is no parent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l308">code &raquo;</a><span class="member"><a name="hasListener">hasListener</a> <span class="args">( opt_type, opt_capture )</span> &rArr; <code class="type">boolean</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_type<dt>opt_capture</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l217">code &raquo;</a><span class="member"><a name="listen">listen</a> <span class="args">( type, listener, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type">(goog.events.ListenableKey|null)</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type<dt>listener<dt>opt_useCapture<dt>opt_listenerScope</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l227">code &raquo;</a><span class="member"><a name="listenOnce">listenOnce</a> <span class="args">( type, listener, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type">(goog.events.ListenableKey|null)</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type<dt>listener<dt>opt_useCapture<dt>opt_listenerScope</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l250">code &raquo;</a><span class="member"><a name="removeAllListeners">removeAllListeners</a> <span class="args">( opt_type )</span> &rArr; <code class="type">number</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_type</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l175">code &raquo;</a><span class="member deprecation-notice"><a name="removeEventListener">removeEventListener</a> <span class="args">( type, handler, opt_capture, opt_handlerScope )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code >#unlisten</code> instead, when possible. Otherwise, use
+     <code >goog.events.unlisten</code> if you are passing Object
+     (instead of Function) as handler.</span></div><p>Removes an event listener from the event target. The handler must be the
+ same object as the one added. If the handler has not been added then
+ nothing is done.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of the event to listen for.<dt>handler: <code class="type">(function(?): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code><dd>The function
+     to handle the event. The handler can also be an object that implements
+     the handleEvent method which takes the event object as argument.<dt>opt_capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>In DOM-compliant browsers, this determines
+     whether the listener is fired during the capture or bubble phase
+     of the event.<dt>opt_handlerScope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object in whose scope to call
+     the listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l127">code &raquo;</a><span class="member"><a name="setParentEventTarget">setParentEventTarget</a> <span class="args">( parent )</span></span></div><p>Sets the parent of this event target to use for capture/bubble
+ mechanism.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="class_goog_events_EventTarget.html">goog.events.EventTarget</a></code><dd>Parent listenable (null if none).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l321">code &raquo;</a><span class="member"><a name="setTargetForTesting">setTargetForTesting</a> <span class="args">( target )</span></span></div><p>Sets the target to be used for <code >event.target</code> when firing
+ event. Mainly used for testing. For example, see
+ <code >goog.testing.events.mixinListenable</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The target.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l236">code &raquo;</a><span class="member"><a name="unlisten">unlisten</a> <span class="args">( type, listener, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type">boolean</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type<dt>listener<dt>opt_useCapture<dt>opt_listenerScope</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l244">code &raquo;</a><span class="member"><a name="unlistenByKey">unlistenByKey</a> <span class="args">( key )</span> &rArr; <code class="type">boolean</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_goog_Disposable.html">goog.Disposable</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l214">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="addOnDisposeCallback">addOnDisposeCallback</a> <span class="args">( callback, opt_scope )</span></span></div><p>Invokes a callback function when this object is disposed. Callbacks are
+ invoked in the order in which they were added.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type">function(this: T): ?</code><dd>The callback function.<dt>opt_scope: <code class="type">T=</code><dd>An optional scope to call the callback in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l175">code &raquo;</a><span class="member"><a name="dispose">dispose</a> <span class="args">( )</span> &rArr; <code class="type">void</code></span></div><p>Disposes of the object. If the object hasn't already been disposed of, calls
+ <code  class="type"><a class="unresolved-link">#disposeInternal</a></code>. Classes that extend <code >goog.Disposable</code> should
+ override <code  class="type"><a class="unresolved-link">#disposeInternal</a></code> in order to delete references to COM
+ objects, DOM nodes, and other disposable objects. Reentrant.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Nothing.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l163">code &raquo;</a><span class="member deprecation-notice"><a name="getDisposed">getDisposed</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#isDisposed</a></code> instead.</span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the object has been disposed of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l154">code &raquo;</a><span class="member"><a name="isDisposed">isDisposed</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the object has been disposed of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l202">code &raquo;</a><span class="member"><a name="registerDisposable">registerDisposable</a> <span class="args">( disposable )</span></span></div><p>Associates a disposable object with this object so that they will be disposed
+ together.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>disposable: <code class="type"><a href="interface_goog_disposable_IDisposable.html">goog.disposable.IDisposable</a></code><dd>that will be disposed when
+     this object is disposed.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.events.EventTarget</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l84">code &raquo;</a><span class="member"><a name="actualEventTarget_">actualEventTarget_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>The object to use for event.target. Useful when mixing in an
+ EventTarget to another object.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l77">code &raquo;</a><span class="member"><a name="eventTargetListeners_">eventTargetListeners_</a> : <code class="type">!<a href="class_goog_events_ListenerMap.html">goog.events.ListenerMap</a></code></span></div><p>Maps of event type to an array of listeners.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l95">code &raquo;</a><span class="member"><a name="parentEventTarget_">parentEventTarget_</a> : <code class="type"><a href="class_goog_events_EventTarget.html">goog.events.EventTarget</a></code></span></div><p>Parent event target, used during event bubbling.
+
+ TODO(user): Change this to goog.events.Listenable. This
+ currently breaks people who expect getParentEventTarget to return
+ goog.events.EventTarget.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_Disposable.html">goog.Disposable</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l147">code &raquo;</a><span class="member"><a name="creationStack">creationStack</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>If monitoring the goog.Disposable instances is enabled, stores the creation
+ stack trace of the Disposable instance.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l131">code &raquo;</a><span class="member"><a name="disposed_">disposed_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object has been disposed of.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l139">code &raquo;</a><span class="member"><a name="onDisposeCallbacks_">onDisposeCallbacks_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Callbacks to invoke when this object is disposed.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l350">code &raquo;</a><span class="member"><a name="goog.events.EventTarget.dispatchEventInternal_">goog.events.EventTarget.dispatchEventInternal_</a> <span class="args">( target, e, opt_ancestorsTree )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Dispatches the given event on the ancestorsTree.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The target to dispatch on.<dt>e: <code class="type">(<a href="class_goog_events_Event.html">goog.events.Event</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>The event object.<dt>opt_ancestorsTree: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>&gt;=</code><dd>The ancestors
+     tree of the target, in reverse order from the closest ancestor
+     to the root event target. May be null if the target has no ancestor.</dl><tr><th>Returns<tr><td><dl>If anyone called preventDefault on the event object (or
+     if any of the listeners returns false) this will also return false.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l107">code &raquo;</a><span class="member"><a name="goog.events.EventTarget.MAX_ANCESTORS_">goog.events.EventTarget.MAX_ANCESTORS_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>An artificial cap on the number of ancestors you can have. This is mainly
+ for loop detection.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/eventtarget.js.src.html#l70">code &raquo;</a><span class="member"><a name="goog.events.EventTarget.superClass_">goog.events.EventTarget.superClass_</a> : <code class="type"><a href="class_goog_Disposable.html">goog.Disposable.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_events_Listener.html b/docs/class_goog_events_Listener.html
new file mode 100644
index 0000000..7b718bc
--- /dev/null
+++ b/docs/class_goog_events_Listener.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.Listener</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.events.Listener</h1><a class="source" href="source/lib/goog/events/listener.js.src.html#l38">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code></dl></header><section><p>Simple class that stores information about a listener<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.events.Listener <span class="args">( listener, proxy, src, type, capture, opt_handler )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>listener: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Callback function.<dt>proxy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Wrapper for the listener that patches the event.<dt>src: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>Source object for
+     the event.<dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Event type.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether in capture or bubble phase.<dt>opt_handler: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object in whose context to execute the callback.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l125">code &raquo;</a><span class="member"><a name="markAsRemoved">markAsRemoved</a> <span class="args">( )</span></span></div><p>Marks this listener as removed. This also remove references held by
+ this listener object (such as listener and event source).</summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l93">code &raquo;</a><span class="member"><a name="callOnce">callOnce</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether to remove the listener after it has been called.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l74">code &raquo;</a><span class="member"><a name="capture">capture</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the listener is being called in the capture or bubble phase</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l118">code &raquo;</a><span class="member"><a name="creationStack">creationStack</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>If monitoring the goog.events.Listener instances is enabled, stores the
+ creation stack trace of the Disposable instance.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l80">code &raquo;</a><span class="member"><a name="handler">handler</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Optional object whose context to execute the listener in</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l87">code &raquo;</a><span class="member"><a name="key">key</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The key of the listener.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l48">code &raquo;</a><span class="member"><a name="listener">listener</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Callback function.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l56">code &raquo;</a><span class="member"><a name="proxy">proxy</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A wrapper over the original listener. This is used solely to
+ handle native browser events (it is used to simulate the capture
+ phase and to patch the event object).</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l99">code &raquo;</a><span class="member"><a name="removed">removed</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the listener has been removed.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l62">code &raquo;</a><span class="member"><a name="src">src</a> : <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code></span></div><p>Object or node that callback is listening to</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l68">code &raquo;</a><span class="member"><a name="type">type</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The event type.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listener.js.src.html#l110">code &raquo;</a><span class="member"><a name="goog.events.Listener.ENABLE_MONITORING">goog.events.Listener.ENABLE_MONITORING</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_events_ListenerMap.html b/docs/class_goog_events_ListenerMap.html
new file mode 100644
index 0000000..2e5abb3
--- /dev/null
+++ b/docs/class_goog_events_ListenerMap.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.ListenerMap</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.events.ListenerMap</h1><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l41">code &raquo;</a></header><section><p>Creates a new listener map.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.events.ListenerMap <span class="args">( src )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>The src object.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l98">code &raquo;</a><span class="member"><a name="add">add</a> <span class="args">( type, listener, callOnce, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code></span></div><p>Adds an event listener. A listener can only be added once to an
+ object and if it is added again the key for the listener is
+ returned.
+
+ Note that a one-off listener will not change an existing listener,
+ if any. On the other hand a normal listener will change existing
+ one-off listener to become a normal listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>The listener event type.<dt>listener: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>This listener callback method.<dt>callOnce: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether the listener is a one-off
+     listener.<dt>opt_useCapture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>The capture mode of the listener.<dt>opt_listenerScope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object in whose scope to call the
+     listener.</dl><tr><th>Returns<tr><td><dl>Unique key for the listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l243">code &raquo;</a><span class="member"><a name="getListener">getListener</a> <span class="args">( type, listener, capture, opt_listenerScope )</span> &rArr; <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code></span></div><p>Gets the goog.events.ListenableKey for the event or null if no such
+ listener is in use.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>The type of the listener
+     to retrieve.<dt>listener: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The listener function to get.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether the listener is a capturing listener.<dt>opt_listenerScope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object in whose scope to call the
+     listener.</dl><tr><th>Returns<tr><td><dl>the found listener or null if not found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l71">code &raquo;</a><span class="member"><a name="getListenerCount">getListenerCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Total number of registered listeners.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l216">code &raquo;</a><span class="member"><a name="getListeners">getListeners</a> <span class="args">( type, capture )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a>&gt;</code></span></div><p>Gets all listeners that match the given type and capture mode. The
+ returned array is a copy (but the listener objects are not).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>The type of the listeners
+     to retrieve.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The capture mode of the listeners to retrieve.</dl><tr><th>Returns<tr><td><dl>An array of matching
+     listeners.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l63">code &raquo;</a><span class="member"><a name="getTypeCount">getTypeCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The count of event types in this map that actually
+     have registered listeners.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l265">code &raquo;</a><span class="member"><a name="hasListener">hasListener</a> <span class="args">( opt_type, opt_capture )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether there is a matching listener. If either the type or capture
+ parameters are unspecified, the function will match on the
+ remaining criteria.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)=</code><dd>The type of the listener.<dt>opt_capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>The capture mode of the listener.</dl><tr><th>Returns<tr><td><dl>Whether there is an active listener matching
+     the requested type and/or capture phase.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l136">code &raquo;</a><span class="member"><a name="remove">remove</a> <span class="args">( type, listener, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes a matching listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>The listener event type.<dt>listener: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>This listener callback method.<dt>opt_useCapture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>The capture mode of the listener.<dt>opt_listenerScope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object in whose scope to call the
+     listener.</dl><tr><th>Returns<tr><td><dl>Whether any listener was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l189">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( opt_type )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Removes all listeners from this map. If opt_type is provided, only
+ listeners that match the given type are removed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)=</code><dd>Type of event to remove.</dl><tr><th>Returns<tr><td><dl>Number of listeners removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l165">code &raquo;</a><span class="member"><a name="removeByKey">removeByKey</a> <span class="args">( listener )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes the given listener object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>listener: <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code><dd>The listener to remove.</dl><tr><th>Returns<tr><td><dl>Whether the listener is removed.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l49">code &raquo;</a><span class="member"><a name="listeners">listeners</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Maps of event type to an array of listeners.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l43">code &raquo;</a><span class="member"><a name="src">src</a> : <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l55">code &raquo;</a><span class="member"><a name="typeCount_">typeCount_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The count of types in this map that have registered listeners.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenermap.js.src.html#l296">code &raquo;</a><span class="member"><a name="goog.events.ListenerMap.findListenerIndex_">goog.events.ListenerMap.findListenerIndex_</a> <span class="args">( listenerArray, listener, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Finds the index of a matching goog.events.Listener in the given
+ listenerArray.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>listenerArray: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array of listener.<dt>listener: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The listener function.<dt>opt_useCapture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>The capture flag for the listener.<dt>opt_listenerScope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The listener scope.</dl><tr><th>Returns<tr><td><dl>The index of the matching listener within the
+     listenerArray.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_iter_GroupByIterator_.html b/docs/class_goog_iter_GroupByIterator_.html
new file mode 100644
index 0000000..c2e0c02
--- /dev/null
+++ b/docs/class_goog_iter_GroupByIterator_.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.iter.GroupByIterator_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.iter.GroupByIterator_.<code class="type">&lt;KEY, VALUE&gt;</code></h1><a class="source" href="source/lib/goog/iter/iter.js.src.html#l910">code &raquo;</a><pre><code>goog.iter.Iterator.&lt;Array&gt;
+  &#x2514; goog.iter.GroupByIterator_</code></pre></header><section><p>Implements the <code >goog.iter.groupBy</code> iterator.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">goog.iter.GroupByIterator_ <span class="args">( iterable, opt_keyFunc )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to group.<dt>opt_keyFunc: <code class="type">function(VALUE): KEY=</code><dd>Optional function for
+     determining the key value for each group in the <code >iterable</code>. Default
+     is the identity function.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.iter.GroupByIterator_</code></h3><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l964">code &raquo;</a><span class="member"><a name="groupItems_">groupItems_</a> <span class="args">( targetKey )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;</code></span></div><p>Performs the grouping of objects using the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>targetKey: <code class="type">KEY</code><dd>The target key object for the group.</dl><tr><th>Returns<tr><td><dl>An array of grouped objects.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l924">code &raquo;</a><span class="member"><a name="keyFunc">keyFunc</a> <span class="args">( )</span> &rArr; <code class="type">KEY</code></span></div><p>A function for determining the key value for each element in the iterable.
+ If no function is provided, the identity function is used and returns the
+ element unchanged.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l948">code &raquo;</a><span class="member"><a name="next">next</a> <span class="args">( )</span> &rArr; <code class="type">Array</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_iter_Iterator.html#goog.iter.Iterator.&lt;Array&gt;">goog.iter.Iterator.&lt;Array&gt;</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l88">code &raquo;</a><span class="member"><a name="__iterator__">__iterator__</a> <span class="args">( opt_keys )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Returns the <code >Iterator</code> object itself.  This is used to implement
+ the iterator protocol in JavaScript 1.7</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_keys: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to return the keys or values. Default is
+     to only return the values.  This is being used by the for-in loop (true)
+     and the for-each-in loop (false).  Even though the param gives a hint
+     about what the iterator will return there is no guarantee that it will
+     return the keys when true is passed.</dl><tr><th>Returns<tr><td><dl>The object itself.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.iter.GroupByIterator_</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l936">code &raquo;</a><span class="member"><a name="currentKey">currentKey</a> : <code class="type">KEY</code></span></div><p>The current key visited during iteration.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l942">code &raquo;</a><span class="member"><a name="currentValue">currentValue</a> : <code class="type">VALUE</code></span></div><p>The current value being added to the group.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l916">code &raquo;</a><span class="member"><a name="iterator">iterator</a> : <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>The iterable to group, coerced to an iterator.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l930">code &raquo;</a><span class="member"><a name="targetKey">targetKey</a> : <code class="type">KEY</code></span></div><p>The target key for determining the start of a group.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l910">code &raquo;</a><span class="member"><a name="goog.iter.GroupByIterator_.superClass_">goog.iter.GroupByIterator_.superClass_</a> : <code class="type"><a href="class_goog_iter_Iterator.html">goog.iter.Iterator.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_iter_Iterator.html b/docs/class_goog_iter_Iterator.html
index 2d55016..c1ed2cd 100644
--- a/docs/class_goog_iter_Iterator.html
+++ b/docs/class_goog_iter_Iterator.html
@@ -1,11 +1,11 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.iter.Iterator</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.iter.Iterator</h1><a class="source" href="source/lib/goog/iter/iter.js.src.html#l65">code &raquo;</a></header><section><p>Class/interface for iterators.  An iterator needs to implement a <code >next</code>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.iter.Iterator</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.iter.Iterator.<code class="type">&lt;VALUE&gt;</code></h1><a class="source" href="source/lib/goog/iter/iter.js.src.html#l65">code &raquo;</a></header><section><p>Class/interface for iterators.  An iterator needs to implement a <code >next</code>
  method and it needs to throw a <code >goog.iter.StopIteration</code> when the
  iteration passes beyond the end.  Iterators have no <code >hasNext</code> method.
  It is recommended to always use the helper functions to iterate over the
- iterator or in case you are only targeting JavaScript 1.7 for in loops.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.iter.Iterator <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l88">code &raquo;</a><span class="member"><a name="__iterator__">__iterator__</a> <span class="args">( opt_keys )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns the <code >Iterator</code> object itself.  This is used to implement
+ iterator or in case you are only targeting JavaScript 1.7 for in loops.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.iter.Iterator <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l88">code &raquo;</a><span class="member"><a name="__iterator__">__iterator__</a> <span class="args">( opt_keys )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Returns the <code >Iterator</code> object itself.  This is used to implement
  the iterator protocol in JavaScript 1.7</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_keys: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to return the keys or values. Default is
      to only return the values.  This is being used by the for-in loop (true)
      and the for-each-in loop (false).  Even though the param gives a hint
      about what the iterator will return there is no guarantee that it will
-     return the keys when true is passed.</dl><tr><th>Returns<tr><td><dl>The object itself.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l73">code &raquo;</a><span class="member"><a name="next">next</a> <span class="args">( )</span> &rArr; <code class="type">*</code></span></div><p>Returns the next value of the iteration.  This will throw the object
- goog.iter#StopIteration when the iteration passes the end.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Any object or value.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     return the keys when true is passed.</dl><tr><th>Returns<tr><td><dl>The object itself.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l73">code &raquo;</a><span class="member"><a name="next">next</a> <span class="args">( )</span> &rArr; <code class="type">VALUE</code></span></div><p>Returns the next value of the iteration.  This will throw the object
+ goog.iter#StopIteration when the iteration passes the end.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Any object or value.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_json_Serializer.html b/docs/class_goog_json_Serializer.html
index 94211df..9b83d58 100644
--- a/docs/class_goog_json_Serializer.html
+++ b/docs/class_goog_json_Serializer.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.json.Serializer</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.json.Serializer</h1><a class="source" href="source/lib/goog/json/json.js.src.html#l158">code &raquo;</a></header><section><p>Class that is used to serialize JSON objects to a string.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.json.Serializer <span class="args">( opt_replacer )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_replacer: <code class="type">?<a href="namespace_goog_json.html#goog.json.Replacer">goog.json.Replacer</a>=</code><dd>Replacer.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l174">code &raquo;</a><span class="member"><a name="serialize">serialize</a> <span class="args">( object )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Serializes an object or a value to a JSON string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">*</code><dd>The object to serialize.</dl><tr><th>Returns<tr><td><dl>A JSON string representation of the input.</dl><tr><th>Throws<tr><td><dl><dt><dd>if there are loops in the object graph.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l303">code &raquo;</a><span class="member"><a name="serializeArray">serializeArray</a> <span class="args">( arr, sb )</span></span></div><p>Serializes an array to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The array to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l292">code &raquo;</a><span class="member"><a name="serializeNumber_">serializeNumber_</a> <span class="args">( n, sb )</span></span></div><p>Serializes a number to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>n: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l327">code &raquo;</a><span class="member"><a name="serializeObject_">serializeObject_</a> <span class="args">( obj, sb )</span></span></div><p>Serializes an object to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l263">code &raquo;</a><span class="member"><a name="serializeString_">serializeString_</a> <span class="args">( s, sb )</span></span></div><p>Serializes a string to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l188">code &raquo;</a><span class="member"><a name="serialize_">serialize_</a> <span class="args">( object, sb )</span></span></div><p>Serializes a generic value to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">*</code><dd>The object to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl><tr><th>Throws<tr><td><dl><dt><dd>if there are loops in the object graph.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l163">code &raquo;</a><span class="member"><a name="replacer_">replacer_</a> : <code class="type">(<a href="namespace_goog_json.html#goog.json.Replacer">goog.json.Replacer</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div></summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l231">code &raquo;</a><span class="member"><a name="goog.json.Serializer.charToJsonCharCache_">goog.json.Serializer.charToJsonCharCache_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Character mappings used internally for goog.string.quote</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l253">code &raquo;</a><span class="member"><a name="goog.json.Serializer.charsToReplace_">goog.json.Serializer.charsToReplace_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression used to match characters that need to be replaced.
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.json.Serializer</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.json.Serializer</h1><a class="source" href="source/lib/goog/json/json.js.src.html#l178">code &raquo;</a></header><section><p>Class that is used to serialize JSON objects to a string.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.json.Serializer <span class="args">( opt_replacer )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_replacer: <code class="type">?<a href="namespace_goog_json.html#goog.json.Replacer">goog.json.Replacer</a>=</code><dd>Replacer.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l194">code &raquo;</a><span class="member"><a name="serialize">serialize</a> <span class="args">( object )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Serializes an object or a value to a JSON string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">*</code><dd>The object to serialize.</dl><tr><th>Returns<tr><td><dl>A JSON string representation of the input.</dl><tr><th>Throws<tr><td><dl><dt><dd>if there are loops in the object graph.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l323">code &raquo;</a><span class="member"><a name="serializeArray">serializeArray</a> <span class="args">( arr, sb )</span></span></div><p>Serializes an array to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The array to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l208">code &raquo;</a><span class="member"><a name="serializeInternal">serializeInternal</a> <span class="args">( object, sb )</span></span></div><p>Serializes a generic value to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">*</code><dd>The object to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl><tr><th>Throws<tr><td><dl><dt><dd>if there are loops in the object graph.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l312">code &raquo;</a><span class="member"><a name="serializeNumber_">serializeNumber_</a> <span class="args">( n, sb )</span></span></div><p>Serializes a number to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>n: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l347">code &raquo;</a><span class="member"><a name="serializeObject_">serializeObject_</a> <span class="args">( obj, sb )</span></span></div><p>Serializes an object to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l283">code &raquo;</a><span class="member"><a name="serializeString_">serializeString_</a> <span class="args">( s, sb )</span></span></div><p>Serializes a string to a JSON string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to serialize.<dt>sb: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Array used as a string builder.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l183">code &raquo;</a><span class="member"><a name="replacer_">replacer_</a> : <code class="type">(<a href="namespace_goog_json.html#goog.json.Replacer">goog.json.Replacer</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div></summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l251">code &raquo;</a><span class="member"><a name="goog.json.Serializer.charToJsonCharCache_">goog.json.Serializer.charToJsonCharCache_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Character mappings used internally for goog.string.quote</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l273">code &raquo;</a><span class="member"><a name="goog.json.Serializer.charsToReplace_">goog.json.Serializer.charsToReplace_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression used to match characters that need to be replaced.
  The S60 browser has a bug where unicode characters are not matched by
  regular expressions. The condition below detects such behaviour and
- adjusts the regular expression accordingly.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ adjusts the regular expression accordingly.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_AllOfMatcher.html b/docs/class_goog_labs_testing_AllOfMatcher.html
index 72579bf..b407e60 100644
--- a/docs/class_goog_labs_testing_AllOfMatcher.html
+++ b/docs/class_goog_labs_testing_AllOfMatcher.html
@@ -1,2 +1,2 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.AllOfMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.AllOfMatcher</h1><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l39">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The AllOf matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.AllOfMatcher <span class="args">( matchers )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matchers: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Input matchers.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l66">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div><p>Describes why the matcher failed. The returned string is a concatenation of
- all the failed matchers' error strings.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l53">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if all of the matchers match the input value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l44">code &raquo;</a><span class="member"><a name="matchers_">matchers_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.AllOfMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.AllOfMatcher</h1><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l41">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The AllOf matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.AllOfMatcher <span class="args">( matchers )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matchers: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Input matchers.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l68">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div><p>Describes why the matcher failed. The returned string is a concatenation of
+ all the failed matchers' error strings.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l55">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if all of the matchers match the input value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l46">code &raquo;</a><span class="member"><a name="matchers_">matchers_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_AnyOfMatcher.html b/docs/class_goog_labs_testing_AnyOfMatcher.html
index 0cd3102..dfa3331 100644
--- a/docs/class_goog_labs_testing_AnyOfMatcher.html
+++ b/docs/class_goog_labs_testing_AnyOfMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.AnyOfMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.AnyOfMatcher</h1><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l88">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The AnyOf matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.AnyOfMatcher <span class="args">( matchers )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matchers: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Input matchers.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l114">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div><p>Describes why the matcher failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l102">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if any of the matchers matches the input value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l93">code &raquo;</a><span class="member"><a name="matchers_">matchers_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.AnyOfMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.AnyOfMatcher</h1><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l92">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The AnyOf matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.AnyOfMatcher <span class="args">( matchers )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matchers: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Input matchers.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l118">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div><p>Describes why the matcher failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l106">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if any of the matchers matches the input value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l97">code &raquo;</a><span class="member"><a name="matchers_">matchers_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_CloseToMatcher.html b/docs/class_goog_labs_testing_CloseToMatcher.html
index ac2e402..790d379 100644
--- a/docs/class_goog_labs_testing_CloseToMatcher.html
+++ b/docs/class_goog_labs_testing_CloseToMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.CloseToMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.CloseToMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l240">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The CloseTo matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.CloseToMatcher <span class="args">( value, range )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.<dt>range: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The range to check within.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l268">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l259">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is within a certain range of the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l250">code &raquo;</a><span class="member"><a name="range_">range_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l245">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.CloseToMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.CloseToMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l252">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The CloseTo matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.CloseToMatcher <span class="args">( value, range )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.<dt>range: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The range to check within.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l280">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l271">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is within a certain range of the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l262">code &raquo;</a><span class="member"><a name="range_">range_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l257">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_ContainsStringMatcher.html b/docs/class_goog_labs_testing_ContainsStringMatcher.html
index 66d6afb..772335e 100644
--- a/docs/class_goog_labs_testing_ContainsStringMatcher.html
+++ b/docs/class_goog_labs_testing_ContainsStringMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.ContainsStringMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.ContainsStringMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l45">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The ContainsString matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.ContainsStringMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l69">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l59">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string contains the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l50">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.ContainsStringMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.ContainsStringMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l47">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The ContainsString matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.ContainsStringMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l71">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l61">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string contains the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l52">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_EndsWithMatcher.html b/docs/class_goog_labs_testing_EndsWithMatcher.html
index 32b7c41..b6e434f 100644
--- a/docs/class_goog_labs_testing_EndsWithMatcher.html
+++ b/docs/class_goog_labs_testing_EndsWithMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.EndsWithMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.EndsWithMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l84">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The EndsWith matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.EndsWithMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l107">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l98">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string ends with the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l89">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.EndsWithMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.EndsWithMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l88">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The EndsWith matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.EndsWithMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l111">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l102">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string ends with the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l93">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_EqualToIgnoringWhitespaceMatcher.html b/docs/class_goog_labs_testing_EqualToIgnoringWhitespaceMatcher.html
index 04e6f59..f82d598 100644
--- a/docs/class_goog_labs_testing_EqualToIgnoringWhitespaceMatcher.html
+++ b/docs/class_goog_labs_testing_EqualToIgnoringWhitespaceMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.EqualToIgnoringWhitespaceMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.EqualToIgnoringWhitespaceMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l122">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The EqualToIgnoringWhitespace matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.EqualToIgnoringWhitespaceMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l148">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l136">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string contains the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l127">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.EqualToIgnoringWhitespaceMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.EqualToIgnoringWhitespaceMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l128">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The EqualToIgnoringWhitespace matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.EqualToIgnoringWhitespaceMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l154">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l142">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string contains the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l133">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_EqualToMatcher.html b/docs/class_goog_labs_testing_EqualToMatcher.html
index 4dd288f..81c5dcb 100644
--- a/docs/class_goog_labs_testing_EqualToMatcher.html
+++ b/docs/class_goog_labs_testing_EqualToMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.EqualToMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.EqualToMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l200">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The EqualTo matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.EqualToMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l223">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l214">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value is equal to the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l205">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.EqualToMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.EqualToMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l210">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The EqualTo matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.EqualToMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l233">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l224">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value is equal to the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l215">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_EqualsMatcher.html b/docs/class_goog_labs_testing_EqualsMatcher.html
index 3147f62..ab302cc 100644
--- a/docs/class_goog_labs_testing_EqualsMatcher.html
+++ b/docs/class_goog_labs_testing_EqualsMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.EqualsMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.EqualsMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l163">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The Equals matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.EqualsMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l186">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l177">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string is equal to the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l168">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.EqualsMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.EqualsMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l171">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The Equals matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.EqualsMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l194">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l185">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string is equal to the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l176">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_GreaterThanEqualToMatcher.html b/docs/class_goog_labs_testing_GreaterThanEqualToMatcher.html
index 8c1b81e..75cfdab 100644
--- a/docs/class_goog_labs_testing_GreaterThanEqualToMatcher.html
+++ b/docs/class_goog_labs_testing_GreaterThanEqualToMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.GreaterThanEqualToMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.GreaterThanEqualToMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l120">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The GreaterThanEqualTo matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.GreaterThanEqualToMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l144">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l134">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value is greater than equal to the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l125">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.GreaterThanEqualToMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.GreaterThanEqualToMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l126">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The GreaterThanEqualTo matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.GreaterThanEqualToMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l150">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l140">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value is greater than equal to the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l131">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_GreaterThanMatcher.html b/docs/class_goog_labs_testing_GreaterThanMatcher.html
index d54c332..841df16 100644
--- a/docs/class_goog_labs_testing_GreaterThanMatcher.html
+++ b/docs/class_goog_labs_testing_GreaterThanMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.GreaterThanMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.GreaterThanMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l42">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The GreaterThan matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.GreaterThanMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l65">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l56">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is greater than the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l47">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.GreaterThanMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.GreaterThanMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l44">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The GreaterThan matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.GreaterThanMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l67">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l58">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is greater than the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l49">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_HasPropertyMatcher.html b/docs/class_goog_labs_testing_HasPropertyMatcher.html
index c92f19f..457b6c5 100644
--- a/docs/class_goog_labs_testing_HasPropertyMatcher.html
+++ b/docs/class_goog_labs_testing_HasPropertyMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.HasPropertyMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.HasPropertyMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l81">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The HasProperty matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.HasPropertyMatcher <span class="args">( property )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>property: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name of the property to test.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l104">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualObject )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l95">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualObject )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if an object has a property.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l86">code &raquo;</a><span class="member"><a name="property_">property_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.HasPropertyMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.HasPropertyMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l85">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The HasProperty matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.HasPropertyMatcher <span class="args">( property )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>property: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name of the property to test.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l108">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualObject )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l99">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualObject )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if an object has a property.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l90">code &raquo;</a><span class="member"><a name="property_">property_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_InstanceOfMatcher.html b/docs/class_goog_labs_testing_InstanceOfMatcher.html
index f95c046..255bd2e 100644
--- a/docs/class_goog_labs_testing_InstanceOfMatcher.html
+++ b/docs/class_goog_labs_testing_InstanceOfMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.InstanceOfMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.InstanceOfMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l119">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The InstanceOf matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.InstanceOfMatcher <span class="args">( object )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The expected class object.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l142">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualObject )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l133">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualObject )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if an object is an instance of another object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l124">code &raquo;</a><span class="member"><a name="object_">object_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.InstanceOfMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.InstanceOfMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l125">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The InstanceOf matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.InstanceOfMatcher <span class="args">( object )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The expected class object.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l148">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualObject )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l139">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualObject )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if an object is an instance of another object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l130">code &raquo;</a><span class="member"><a name="object_">object_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_IsNotMatcher.html b/docs/class_goog_labs_testing_IsNotMatcher.html
index 90d8178..a36c7ce 100644
--- a/docs/class_goog_labs_testing_IsNotMatcher.html
+++ b/docs/class_goog_labs_testing_IsNotMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.IsNotMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.IsNotMatcher</h1><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l136">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The IsNot matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.IsNotMatcher <span class="args">( matcher )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matcher: <code class="type">!<a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code><dd>The matcher to negate.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l160">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div><p>Describes why the matcher failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l150">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value doesn't satisfy a matcher.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l141">code &raquo;</a><span class="member"><a name="matcher_">matcher_</a> : <code class="type">!<a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.IsNotMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.IsNotMatcher</h1><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l142">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The IsNot matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.IsNotMatcher <span class="args">( matcher )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matcher: <code class="type">!<a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code><dd>The matcher to negate.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l166">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div><p>Describes why the matcher failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l156">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value doesn't satisfy a matcher.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/logicmatcher.js.src.html#l147">code &raquo;</a><span class="member"><a name="matcher_">matcher_</a> : <code class="type">!<a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_IsNullMatcher.html b/docs/class_goog_labs_testing_IsNullMatcher.html
index 1517849..2873c4f 100644
--- a/docs/class_goog_labs_testing_IsNullMatcher.html
+++ b/docs/class_goog_labs_testing_IsNullMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.IsNullMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.IsNullMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l185">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The IsNull matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.IsNullMatcher <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l202">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l193">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is null.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.IsNullMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.IsNullMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l195">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The IsNull matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.IsNullMatcher <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l212">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l203">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is null.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_IsNullOrUndefinedMatcher.html b/docs/class_goog_labs_testing_IsNullOrUndefinedMatcher.html
index 513e9ce..40eff35 100644
--- a/docs/class_goog_labs_testing_IsNullOrUndefinedMatcher.html
+++ b/docs/class_goog_labs_testing_IsNullOrUndefinedMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.IsNullOrUndefinedMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.IsNullOrUndefinedMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l155">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The IsNullOrUndefined matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.IsNullOrUndefinedMatcher <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l172">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l163">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is null or undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.IsNullOrUndefinedMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.IsNullOrUndefinedMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l163">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The IsNullOrUndefined matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.IsNullOrUndefinedMatcher <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l180">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l171">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is null or undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_IsUndefinedMatcher.html b/docs/class_goog_labs_testing_IsUndefinedMatcher.html
index 7297062..e541471 100644
--- a/docs/class_goog_labs_testing_IsUndefinedMatcher.html
+++ b/docs/class_goog_labs_testing_IsUndefinedMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.IsUndefinedMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.IsUndefinedMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l215">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The IsUndefined matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.IsUndefinedMatcher <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l232">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l223">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.IsUndefinedMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.IsUndefinedMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l227">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The IsUndefined matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.IsUndefinedMatcher <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l244">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l235">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input value is undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_LessThanEqualToMatcher.html b/docs/class_goog_labs_testing_LessThanEqualToMatcher.html
index 33ae0fc..ffd26c3 100644
--- a/docs/class_goog_labs_testing_LessThanEqualToMatcher.html
+++ b/docs/class_goog_labs_testing_LessThanEqualToMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.LessThanEqualToMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.LessThanEqualToMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l160">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The LessThanEqualTo matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.LessThanEqualToMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l184">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l174">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value is less than or equal to the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l165">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.LessThanEqualToMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.LessThanEqualToMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l168">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The LessThanEqualTo matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.LessThanEqualToMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l192">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l182">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value is less than or equal to the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l173">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_LessThanMatcher.html b/docs/class_goog_labs_testing_LessThanMatcher.html
index 66195f9..3dc64a1 100644
--- a/docs/class_goog_labs_testing_LessThanMatcher.html
+++ b/docs/class_goog_labs_testing_LessThanMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.LessThanMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.LessThanMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l81">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The lessThan matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.LessThanMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l104">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l95">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value is less than the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l86">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.LessThanMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.LessThanMatcher</h1><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l85">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The lessThan matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.LessThanMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The value to compare.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l108">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l99">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if the input value is less than the expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/numbermatcher.js.src.html#l90">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_MatcherError.html b/docs/class_goog_labs_testing_MatcherError.html
index deb71c5..8edf8d8 100644
--- a/docs/class_goog_labs_testing_MatcherError.html
+++ b/docs/class_goog_labs_testing_MatcherError.html
@@ -1,3 +1,3 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.MatcherError</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.MatcherError</h1><a class="source" href="source/lib/goog/labs/testing/assertthat.js.src.html#l56">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.MatcherError</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.MatcherError</h1><a class="source" href="source/lib/goog/labs/testing/assertthat.js.src.html#l57">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
   &#x2514; <a href="class_goog_debug_Error.html">goog.debug.Error</a>
-      &#x2514; goog.labs.testing.MatcherError</code></pre></header><section><p>Error thrown when a Matcher fails to match the input value.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.MatcherError <span class="args">( opt_message )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The error message.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/assertthat.js.src.html#l56">code &raquo;</a><span class="member"><a name="goog.labs.testing.MatcherError.superClass_">goog.labs.testing.MatcherError.superClass_</a> : <code class="type"><a href="class_goog_debug_Error.html">goog.debug.Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+      &#x2514; goog.labs.testing.MatcherError</code></pre></header><section><p>Error thrown when a Matcher fails to match the input value.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.MatcherError <span class="args">( opt_message )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The error message.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/assertthat.js.src.html#l57">code &raquo;</a><span class="member"><a name="goog.labs.testing.MatcherError.superClass_">goog.labs.testing.MatcherError.superClass_</a> : <code class="type"><a href="class_goog_debug_Error.html">goog.debug.Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_ObjectEqualsMatcher.html b/docs/class_goog_labs_testing_ObjectEqualsMatcher.html
index 8d0dc16..12d8f28 100644
--- a/docs/class_goog_labs_testing_ObjectEqualsMatcher.html
+++ b/docs/class_goog_labs_testing_ObjectEqualsMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.ObjectEqualsMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.ObjectEqualsMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l43">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The Equals matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.ObjectEqualsMatcher <span class="args">( expectedObject )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectedObject: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The expected object.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l66">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualObject )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l57">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualObject )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if two objects are the same.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l48">code &raquo;</a><span class="member"><a name="object_">object_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.ObjectEqualsMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.ObjectEqualsMatcher</h1><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l45">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The Equals matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.ObjectEqualsMatcher <span class="args">( expectedObject )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectedObject: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The expected object.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l68">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualObject )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l59">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualObject )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if two objects are the same.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualObject</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/objectmatcher.js.src.html#l50">code &raquo;</a><span class="member"><a name="object_">object_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_RegexMatcher.html b/docs/class_goog_labs_testing_RegexMatcher.html
index 57c53c8..db2df2e 100644
--- a/docs/class_goog_labs_testing_RegexMatcher.html
+++ b/docs/class_goog_labs_testing_RegexMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.RegexMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.RegexMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l201">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The MatchesRegex matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.RegexMatcher <span class="args">( regex )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>regex: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code><dd>The expected regex.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l225">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l215">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string is equal to the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l206">code &raquo;</a><span class="member"><a name="regex_">regex_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.RegexMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.RegexMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l211">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The MatchesRegex matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.RegexMatcher <span class="args">( regex )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>regex: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code><dd>The expected regex.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l235">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l225">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string is equal to the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l216">code &raquo;</a><span class="member"><a name="regex_">regex_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_StartsWithMatcher.html b/docs/class_goog_labs_testing_StartsWithMatcher.html
index e73ad5a..df9f738 100644
--- a/docs/class_goog_labs_testing_StartsWithMatcher.html
+++ b/docs/class_goog_labs_testing_StartsWithMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.StartsWithMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.StartsWithMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l240">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The StartsWith matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.StartsWithMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l263">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l254">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string starts with the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l245">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.StartsWithMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.StartsWithMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l252">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The StartsWith matcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.StartsWithMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected string.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l275">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l266">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string starts with the expected string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l257">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_labs_testing_StringContainsInOrderMatcher.html b/docs/class_goog_labs_testing_StringContainsInOrderMatcher.html
index 183a59b..02b0b87 100644
--- a/docs/class_goog_labs_testing_StringContainsInOrderMatcher.html
+++ b/docs/class_goog_labs_testing_StringContainsInOrderMatcher.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.StringContainsInOrderMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.StringContainsInOrderMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l278">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The StringContainsInOrdermatcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.StringContainsInOrderMatcher <span class="args">( values )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>values: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The expected string values.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l310">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l292">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string contains, in order, the expected array of strings.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l283">code &raquo;</a><span class="member"><a name="values_">values_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.StringContainsInOrderMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.labs.testing.StringContainsInOrderMatcher</h1><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l292">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>The StringContainsInOrdermatcher.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.labs.testing.StringContainsInOrderMatcher <span class="args">( values )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>values: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The expected string values.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l324">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l306">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div><p>Determines if input string contains, in order, the expected array of strings.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/testing/stringmatcher.js.src.html#l297">code &raquo;</a><span class="member"><a name="values_">values_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_math_Box.html b/docs/class_goog_math_Box.html
new file mode 100644
index 0000000..84531c7
--- /dev/null
+++ b/docs/class_goog_math_Box.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.math.Box</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.math.Box</h1><a class="source" href="source/lib/goog/math/box.js.src.html#l39">code &raquo;</a></header><section><p>Class for representing a box. A box is specified as a top, right, bottom,
+ and left. A box is useful for representing margins and padding.
+
+ This class assumes 'screen coordinates': larger Y coordinates are further
+ from the top of the screen.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.math.Box <span class="args">( top, right, bottom, left )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>top: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Top.<dt>right: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Right.<dt>bottom: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Bottom.<dt>left: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Left.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l305">code &raquo;</a><span class="member"><a name="ceil">ceil</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Rounds the fields to the next larger integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This box with ceil'd fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l106">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Creates a copy of the box with the same dimensions.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A clone of this Box.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l130">code &raquo;</a><span class="member"><a name="contains">contains</a> <span class="args">( other )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether the box contains a coordinate or another box.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>other: <code class="type">(<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>|<a href="class_goog_math_Box.html">goog.math.Box</a>)</code><dd>A Coordinate or a Box.</dl><tr><th>Returns<tr><td><dl>Whether the box contains the coordinate or other box.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l144">code &raquo;</a><span class="member"><a name="expand">expand</a> <span class="args">( top, opt_right, opt_bottom, opt_left )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Expands box with the given margins.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>top: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_goog_math_Box.html">goog.math.Box</a>)</code><dd>Top margin or box with all margins.<dt>opt_right: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Right margin.<dt>opt_bottom: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Bottom margin.<dt>opt_left: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Left margin.</dl><tr><th>Returns<tr><td><dl>A reference to this Box.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l169">code &raquo;</a><span class="member"><a name="expandToInclude">expandToInclude</a> <span class="args">( box )</span></span></div><p>Expand this box to include another box.
+ NOTE(user): This is used in code that needs to be very fast, please don't
+ add functionality to this function at the expense of speed (variable
+ arguments, accepting multiple argument types, etc).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>box: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>The box to include in this one.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l319">code &raquo;</a><span class="member"><a name="floor">floor</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Rounds the fields to the next smaller integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This box with floored fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l97">code &raquo;</a><span class="member"><a name="getHeight">getHeight</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>height The height of this Box.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l89">code &raquo;</a><span class="member"><a name="getWidth">getWidth</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>width The width of this Box.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l333">code &raquo;</a><span class="member"><a name="round">round</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Rounds the fields to nearest integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This box with rounded fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l381">code &raquo;</a><span class="member"><a name="scale">scale</a> <span class="args">( sx, opt_sy )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Scales this coordinate by the given scale factors. The x and y dimension
+ values are scaled by <code >sx</code> and <code >opt_sy</code> respectively.
+ If <code >opt_sy</code> is not given, then <code >sx</code> is used for both x and y.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>sx: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The scale factor to use for the x dimension.<dt>opt_sy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The scale factor to use for the y dimension.</dl><tr><th>Returns<tr><td><dl>This box after scaling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l117">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a nice string representing the box.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>In the form (50t, 73r, 24b, 13l).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l354">code &raquo;</a><span class="member"><a name="translate">translate</a> <span class="args">( tx, opt_ty )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Translates this box by the given offsets. If a <code >goog.math.Coordinate</code>
+ is given, then the left and right values are translated by the coordinate's
+ x value and the top and bottom values are translated by the coordinate's y
+ value.  Otherwise, <code >tx</code> and <code >opt_ty</code> are used to translate the x
+ and y dimension values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tx: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>)</code><dd>The value to translate the x
+     dimension values by or the the coordinate to translate this box by.<dt>opt_ty: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The value to translate y dimension values by.</dl><tr><th>Returns<tr><td><dl>This box after translating.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l56">code &raquo;</a><span class="member"><a name="bottom">bottom</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Bottom</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l62">code &raquo;</a><span class="member"><a name="left">left</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Left</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l50">code &raquo;</a><span class="member"><a name="right">right</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Right</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l44">code &raquo;</a><span class="member"><a name="top">top</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Top</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l72">code &raquo;</a><span class="member"><a name="goog.math.Box.boundingBox">goog.math.Box.boundingBox</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Creates a Box by bounding a collection of goog.math.Coordinate objects</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>Coordinates to be included inside
+     the box.</dl><tr><th>Returns<tr><td><dl>A Box containing all the specified Coordinates.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l202">code &raquo;</a><span class="member"><a name="goog.math.Box.contains">goog.math.Box.contains</a> <span class="args">( box, other )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether a box contains a coordinate or another box.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>box: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A Box.<dt>other: <code class="type">(<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>|<a href="class_goog_math_Box.html">goog.math.Box</a>)</code><dd>A Coordinate or a Box.</dl><tr><th>Returns<tr><td><dl>Whether the box contains the coordinate or other box.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l266">code &raquo;</a><span class="member"><a name="goog.math.Box.distance">goog.math.Box.distance</a> <span class="args">( box, coord )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the distance between a coordinate and the nearest corner/side of a
+ box. Returns zero if the coordinate is inside the box.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>box: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A Box.<dt>coord: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>The distance between <code >coord</code> and the nearest
+     corner/side of <code >box</code>, or zero if <code >coord</code> is inside
+     <code >box</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l183">code &raquo;</a><span class="member"><a name="goog.math.Box.equals">goog.math.Box.equals</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares boxes for equality.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A Box.<dt>b: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A Box.</dl><tr><th>Returns<tr><td><dl>True iff the boxes are equal, or if both are null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l280">code &raquo;</a><span class="member"><a name="goog.math.Box.intersects">goog.math.Box.intersects</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether two boxes intersect.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A Box.<dt>b: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A second Box.</dl><tr><th>Returns<tr><td><dl>Whether the boxes intersect.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l294">code &raquo;</a><span class="member"><a name="goog.math.Box.intersectsWithPadding">goog.math.Box.intersectsWithPadding</a> <span class="args">( a, b, padding )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether two boxes would intersect with additional padding.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A Box.<dt>b: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A second Box.<dt>padding: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The additional padding.</dl><tr><th>Returns<tr><td><dl>Whether the boxes intersect.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l227">code &raquo;</a><span class="member"><a name="goog.math.Box.relativePositionX">goog.math.Box.relativePositionX</a> <span class="args">( box, coord )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the relative x position of a coordinate compared to a box.  Returns
+ zero if the coordinate is inside the box.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>box: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A Box.<dt>coord: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>The x position of <code >coord</code> relative to the nearest
+     side of <code >box</code>, or zero if <code >coord</code> is inside <code >box</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/box.js.src.html#l246">code &raquo;</a><span class="member"><a name="goog.math.Box.relativePositionY">goog.math.Box.relativePositionY</a> <span class="args">( box, coord )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the relative y position of a coordinate compared to a box.  Returns
+ zero if the coordinate is inside the box.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>box: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A Box.<dt>coord: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>The y position of <code >coord</code> relative to the nearest
+     side of <code >box</code>, or zero if <code >coord</code> is inside <code >box</code>.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_math_Coordinate.html b/docs/class_goog_math_Coordinate.html
new file mode 100644
index 0000000..c1e4989
--- /dev/null
+++ b/docs/class_goog_math_Coordinate.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.math.Coordinate</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.math.Coordinate</h1><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l32">code &raquo;</a></header><section><p>Class for representing coordinates and positions.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.math.Coordinate <span class="args">( opt_x, opt_y )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_x: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Left, defaults to 0.<dt>opt_y: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Top, defaults to 0.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l167">code &raquo;</a><span class="member"><a name="ceil">ceil</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Rounds the x and y fields to the next larger integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This coordinate with ceil'd fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l51">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns a new copy of the coordinate.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A clone of this coordinate.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l178">code &raquo;</a><span class="member"><a name="floor">floor</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Rounds the x and y fields to the next smaller integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This coordinate with floored fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l265">code &raquo;</a><span class="member"><a name="rotateDegrees">rotateDegrees</a> <span class="args">( degrees, opt_center )</span></span></div><p>Rotates this coordinate clockwise about the origin (or, optionally, the given
+ center) by the given angle, in degrees.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>degrees: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The angle by which to rotate this coordinate
+     clockwise about the given center, in degrees.<dt>opt_center: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>The center of rotation. Defaults
+     to (0, 0) if not given.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l244">code &raquo;</a><span class="member"><a name="rotateRadians">rotateRadians</a> <span class="args">( radians, opt_center )</span></span></div><p>Rotates this coordinate clockwise about the origin (or, optionally, the given
+ center) by the given angle, in radians.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>radians: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The angle by which to rotate this coordinate
+     clockwise about the given center, in radians.<dt>opt_center: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>The center of rotation. Defaults
+     to (0, 0) if not given.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l189">code &raquo;</a><span class="member"><a name="round">round</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Rounds the x and y fields to the nearest integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This coordinate with rounded fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l228">code &raquo;</a><span class="member"><a name="scale">scale</a> <span class="args">( sx, opt_sy )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Scales this coordinate by the given scale factors. The x and y values are
+ scaled by <code >sx</code> and <code >opt_sy</code> respectively.  If <code >opt_sy</code>
+ is not given, then <code >sx</code> is used for both x and y.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>sx: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The scale factor to use for the x dimension.<dt>opt_sy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The scale factor to use for the y dimension.</dl><tr><th>Returns<tr><td><dl>This coordinate after scaling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l62">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a nice string representing the coordinate.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>In the form (50, 73).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l206">code &raquo;</a><span class="member"><a name="translate">translate</a> <span class="args">( tx, opt_ty )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Translates this box by the given offsets. If a <code >goog.math.Coordinate</code>
+ is given, then the x and y values are translated by the coordinate's x and y.
+ Otherwise, x and y are translated by <code >tx</code> and <code >opt_ty</code>
+ respectively.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tx: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>)</code><dd>The value to translate x by or the
+     the coordinate to translate this coordinate by.<dt>opt_ty: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The value to translate y by.</dl><tr><th>Returns<tr><td><dl>This coordinate after translating.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l37">code &raquo;</a><span class="member"><a name="x">x</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>X-value</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l43">code &raquo;</a><span class="member"><a name="y">y</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Y-value</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l114">code &raquo;</a><span class="member"><a name="goog.math.Coordinate.azimuth">goog.math.Coordinate.azimuth</a> <span class="args">( a )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the angle from the origin to a coordinate.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>The angle, in degrees, clockwise from the positive X
+     axis to <code >a</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l146">code &raquo;</a><span class="member"><a name="goog.math.Coordinate.difference">goog.math.Coordinate.difference</a> <span class="args">( a, b )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns the difference between two coordinates as a new
+ goog.math.Coordinate.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.<dt>b: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>A Coordinate representing the difference
+     between <code >a</code> and <code >b</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l91">code &raquo;</a><span class="member"><a name="goog.math.Coordinate.distance">goog.math.Coordinate.distance</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the distance between two coordinates.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.<dt>b: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>The distance between <code >a</code> and <code >b</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l74">code &raquo;</a><span class="member"><a name="goog.math.Coordinate.equals">goog.math.Coordinate.equals</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares coordinates for equality.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.<dt>b: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>True iff the coordinates are equal, or if both are null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l103">code &raquo;</a><span class="member"><a name="goog.math.Coordinate.magnitude">goog.math.Coordinate.magnitude</a> <span class="args">( a )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the magnitude of a coordinate.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>The distance between the origin and <code >a</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l131">code &raquo;</a><span class="member"><a name="goog.math.Coordinate.squaredDistance">goog.math.Coordinate.squaredDistance</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the squared distance between two coordinates. Squared distances can
+ be used for comparisons when the actual value is not required.
+
+ Performance note: eliminating the square root is an optimization often used
+ in lower-level languages, but the speed difference is not nearly as
+ pronounced in JavaScript (only a few percent.)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.<dt>b: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>The squared distance between <code >a</code> and <code >b</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/coordinate.js.src.html#l158">code &raquo;</a><span class="member"><a name="goog.math.Coordinate.sum">goog.math.Coordinate.sum</a> <span class="args">( a, b )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns the sum of two coordinates as a new goog.math.Coordinate.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.<dt>b: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A Coordinate.</dl><tr><th>Returns<tr><td><dl>A Coordinate representing the sum of the two
+     coordinates.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_math_Rect.html b/docs/class_goog_math_Rect.html
new file mode 100644
index 0000000..3b077eb
--- /dev/null
+++ b/docs/class_goog_math_Rect.html
@@ -0,0 +1,34 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.math.Rect</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.math.Rect</h1><a class="source" href="source/lib/goog/math/rect.js.src.html#l35">code &raquo;</a></header><section><p>Class for representing rectangular regions.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.math.Rect <span class="args">( x, y, w, h )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>x: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Left.<dt>y: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Top.<dt>w: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Width.<dt>h: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Height.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l266">code &raquo;</a><span class="member"><a name="boundingRect">boundingRect</a> <span class="args">( rect )</span></span></div><p>Expand this rectangle to also include the area of the given rectangle.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rect: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>The other rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l388">code &raquo;</a><span class="member"><a name="ceil">ceil</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Rounds the fields to the next larger integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This rectangle with ceil'd fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l53">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new copy of this Rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l307">code &raquo;</a><span class="member"><a name="contains">contains</a> <span class="args">( another )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether this rectangle entirely contains another rectangle or
+ coordinate.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>another: <code class="type">(<a href="class_goog_math_Rect.html">goog.math.Rect</a>|<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>)</code><dd>The rectangle or
+     coordinate to test for containment.</dl><tr><th>Returns<tr><td><dl>Whether this rectangle contains given rectangle or
+     coordinate.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l257">code &raquo;</a><span class="member"><a name="difference">difference</a> <span class="args">( rect )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Computes the difference regions between this rectangle and <code >rect</code>. The
+ return value is an array of 0 to 4 rectangles defining the remaining regions
+ of this rectangle after the other has been subtracted.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rect: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.</dl><tr><th>Returns<tr><td><dl>An array with 0 to 4 rectangles which
+     together define the difference area of rectangle a minus rectangle b.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l342">code &raquo;</a><span class="member"><a name="distance">distance</a> <span class="args">( point )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>point: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A coordinate.</dl><tr><th>Returns<tr><td><dl>The distance between the point and the closest point
+     inside the rectangle. Returns 0 if the point is inside the rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l401">code &raquo;</a><span class="member"><a name="floor">floor</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Rounds the fields to the next smaller integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This rectangle with floored fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l378">code &raquo;</a><span class="member"><a name="getBottomRight">getBottomRight</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new coordinate for the bottom-right corner
+     of the rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l368">code &raquo;</a><span class="member"><a name="getCenter">getCenter</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new coordinate for the center of the
+     rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l350">code &raquo;</a><span class="member"><a name="getSize">getSize</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The size of this rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l359">code &raquo;</a><span class="member"><a name="getTopLeft">getTopLeft</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new coordinate for the top-left corner of
+     the rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l124">code &raquo;</a><span class="member"><a name="intersection">intersection</a> <span class="args">( rect )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Computes the intersection of this rectangle and the rectangle parameter.  If
+ there is no intersection, returns false and leaves this rectangle as is.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rect: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.</dl><tr><th>Returns<tr><td><dl>True iff this rectangle intersects with the parameter.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l193">code &raquo;</a><span class="member"><a name="intersects">intersects</a> <span class="args">( rect )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether a rectangle intersects this rectangle.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rect: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A rectangle.</dl><tr><th>Returns<tr><td><dl>Whether rect intersects this rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l414">code &raquo;</a><span class="member"><a name="round">round</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Rounds the fields to nearest integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This rectangle with rounded fields.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l456">code &raquo;</a><span class="member"><a name="scale">scale</a> <span class="args">( sx, opt_sy )</span> &rArr; <code class="type">!<a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Scales this rectangle by the given scale factors. The left and width values
+ are scaled by <code >sx</code> and the top and height values are scaled by
+ <code >opt_sy</code>.  If <code >opt_sy</code> is not given, then all fields are scaled
+ by <code >sx</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>sx: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The scale factor to use for the x dimension.<dt>opt_sy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The scale factor to use for the y dimension.</dl><tr><th>Returns<tr><td><dl>This rectangle after scaling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l328">code &raquo;</a><span class="member"><a name="squaredDistance">squaredDistance</a> <span class="args">( point )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>point: <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code><dd>A coordinate.</dl><tr><th>Returns<tr><td><dl>The squared distance between the point and the closest
+     point inside the rectangle. Returns 0 if the point is inside the
+     rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l63">code &raquo;</a><span class="member"><a name="toBox">toBox</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Returns a new Box object with the same position and dimensions as this
+ rectangle.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new Box representation of this Rectangle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l92">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a nice string representing size and dimensions of rectangle.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>In the form (50, 73 - 75w x 25h).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l433">code &raquo;</a><span class="member"><a name="translate">translate</a> <span class="args">( tx, opt_ty )</span> &rArr; <code class="type">!<a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Translates this rectangle by the given offsets. If a
+ <code >goog.math.Coordinate</code> is given, then the left and top values are
+ translated by the coordinate's x and y values. Otherwise, top and left are
+ translated by <code >tx</code> and <code >opt_ty</code> respectively.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tx: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>)</code><dd>The value to translate left by or the
+     the coordinate to translate this rect by.<dt>opt_ty: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The value to translate top by.</dl><tr><th>Returns<tr><td><dl>This rectangle after translating.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l46">code &raquo;</a><span class="member"><a name="height">height</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l37">code &raquo;</a><span class="member"><a name="left">left</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l40">code &raquo;</a><span class="member"><a name="top">top</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l43">code &raquo;</a><span class="member"><a name="width">width</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l286">code &raquo;</a><span class="member"><a name="goog.math.Rect.boundingRect">goog.math.Rect.boundingRect</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Returns a new rectangle which completely contains both input rectangles.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A rectangle.<dt>b: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A rectangle.</dl><tr><th>Returns<tr><td><dl>A new bounding rect, or null if either rect is
+     null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l80">code &raquo;</a><span class="member"><a name="goog.math.Rect.createFromBox">goog.math.Rect.createFromBox</a> <span class="args">( box )</span> &rArr; <code class="type">!<a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Creates a new Rect object with the same position and dimensions as a given
+ Box.  Note that this is only the inverse of toBox if left/top are defined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>box: <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code><dd>A box.</dl><tr><th>Returns<tr><td><dl>A new Rect initialized with the box's position
+     and size.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l207">code &raquo;</a><span class="member"><a name="goog.math.Rect.difference">goog.math.Rect.difference</a> <span class="args">( a, b )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Computes the difference regions between two rectangles. The return value is
+ an array of 0 to 4 rectangles defining the remaining regions of the first
+ rectangle after the second has been subtracted.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.<dt>b: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.</dl><tr><th>Returns<tr><td><dl>An array with 0 to 4 rectangles which
+     together define the difference area of rectangle a minus rectangle b.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l106">code &raquo;</a><span class="member"><a name="goog.math.Rect.equals">goog.math.Rect.equals</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares rectangles for equality.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.<dt>b: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.</dl><tr><th>Returns<tr><td><dl>True iff the rectangles have the same left, top, width,
+     and height, or if both are null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l154">code &raquo;</a><span class="member"><a name="goog.math.Rect.intersection">goog.math.Rect.intersection</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Returns the intersection of two rectangles. Two rectangles intersect if they
+ touch at all, for example, two zero width and height rectangles would
+ intersect if they had the same top and left.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.<dt>b: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.</dl><tr><th>Returns<tr><td><dl>A new intersection rect (even if width and height
+     are 0), or null if there is no intersection.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/rect.js.src.html#l182">code &raquo;</a><span class="member"><a name="goog.math.Rect.intersects">goog.math.Rect.intersects</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether two rectangles intersect. Two rectangles intersect if they
+ touch at all, for example, two zero width and height rectangles would
+ intersect if they had the same top and left.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.<dt>b: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>A Rectangle.</dl><tr><th>Returns<tr><td><dl>Whether a and b intersect.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_math_Size.html b/docs/class_goog_math_Size.html
new file mode 100644
index 0000000..efb7ff6
--- /dev/null
+++ b/docs/class_goog_math_Size.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.math.Size</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.math.Size</h1><a class="source" href="source/lib/goog/math/size.js.src.html#l31">code &raquo;</a></header><section><p>Class for representing sizes consisting of a width and height. Undefined
+ width and height support is deprecated and results in compiler warning.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.math.Size <span class="args">( width, height )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>width: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Width.<dt>height: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Height.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l103">code &raquo;</a><span class="member"><a name="area">area</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The area of the size (width * height).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l119">code &raquo;</a><span class="member"><a name="aspectRatio">aspectRatio</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The ratio of the size's width to its height.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l137">code &raquo;</a><span class="member"><a name="ceil">ceil</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Clamps the width and height parameters upward to integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This size with ceil'd components.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l67">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new copy of the Size.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l149">code &raquo;</a><span class="member"><a name="fitsInside">fitsInside</a> <span class="args">( target )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code><dd>The target size.</dl><tr><th>Returns<tr><td><dl>True if this Size is the same size or smaller than the
+     target size in both dimensions.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l158">code &raquo;</a><span class="member"><a name="floor">floor</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Clamps the width and height parameters downward to integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This size with floored components.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l87">code &raquo;</a><span class="member"><a name="getLongest">getLongest</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The longer of the two dimensions in the size.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l95">code &raquo;</a><span class="member"><a name="getShortest">getShortest</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The shorter of the two dimensions in the size.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l128">code &raquo;</a><span class="member"><a name="isEmpty">isEmpty</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>True if the size has zero area, false if both dimensions
+     are non-zero numbers.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l111">code &raquo;</a><span class="member"><a name="perimeter">perimeter</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The perimeter of the size (width + height) * 2.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l169">code &raquo;</a><span class="member"><a name="round">round</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Rounds the width and height parameters to integer values.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This size with rounded components.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l184">code &raquo;</a><span class="member"><a name="scale">scale</a> <span class="args">( sx, opt_sy )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Scales this size by the given scale factors. The width and height are scaled
+ by <code >sx</code> and <code >opt_sy</code> respectively.  If <code >opt_sy</code> is not
+ given, then <code >sx</code> is used for both the width and height.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>sx: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The scale factor to use for the width.<dt>opt_sy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The scale factor to use for the height.</dl><tr><th>Returns<tr><td><dl>This Size object after scaling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l200">code &raquo;</a><span class="member"><a name="scaleToFit">scaleToFit</a> <span class="args">( target )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Uniformly scales the size to fit inside the dimensions of a given size. The
+ original aspect ratio will be preserved.
+
+ This function assumes that both Sizes contain strictly positive dimensions.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code><dd>The target size.</dl><tr><th>Returns<tr><td><dl>This Size object, after optional scaling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l78">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a nice string representing size.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>In the form (50 x 73).</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l42">code &raquo;</a><span class="member"><a name="height">height</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Height</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l36">code &raquo;</a><span class="member"><a name="width">width</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Width</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/size.js.src.html#l53">code &raquo;</a><span class="member"><a name="goog.math.Size.equals">goog.math.Size.equals</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares sizes for equality.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="class_goog_math_Size.html">goog.math.Size</a></code><dd>A Size.<dt>b: <code class="type"><a href="class_goog_math_Size.html">goog.math.Size</a></code><dd>A Size.</dl><tr><th>Returns<tr><td><dl>True iff the sizes have equal widths and equal
+     heights, or if both are null.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_net_DefaultXmlHttpFactory.html b/docs/class_goog_net_DefaultXmlHttpFactory.html
index dbe1b20..054fd93 100644
--- a/docs/class_goog_net_DefaultXmlHttpFactory.html
+++ b/docs/class_goog_net_DefaultXmlHttpFactory.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.DefaultXmlHttpFactory</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.net.DefaultXmlHttpFactory</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l147">code &raquo;</a><pre><code><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.DefaultXmlHttpFactory</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.net.DefaultXmlHttpFactory</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l164">code &raquo;</a><pre><code><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a>
   &#x2514; goog.net.DefaultXmlHttpFactory</code></pre></header><section><p>Default factory to use when creating xhr objects.  You probably shouldn't be
- instantiating this directly, but rather using it via goog.net.XmlHttp.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.net.DefaultXmlHttpFactory <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.net.DefaultXmlHttpFactory</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l154">code &raquo;</a><span class="member"><a name="createInstance">createInstance</a> <span class="args">( )</span> &rArr; <code class="type">(GearsHttpRequest|XMLHttpRequest)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l189">code &raquo;</a><span class="member"><a name="getProgId_">getProgId_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Initialize the private state used by other functions.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The ActiveX PROG ID string to use to create xhr's in IE.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l165">code &raquo;</a><span class="member"><a name="internalGetOptions">internalGetOptions</a> <span class="args">( )</span> &rArr; <code class="type">(Object|null)</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l51">code &raquo;</a><span class="member"><a name="getOptions">getOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Options describing how xhr objects obtained from this
-     factory should be used.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.net.DefaultXmlHttpFactory</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l181">code &raquo;</a><span class="member"><a name="ieProgId_">ieProgId_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>The ActiveX PROG ID string to use to create xhr's in IE. Lazily initialized.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l38">code &raquo;</a><span class="member"><a name="cachedOptions_">cachedOptions_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Cache of options - we only actually call internalGetOptions once.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l147">code &raquo;</a><span class="member"><a name="goog.net.DefaultXmlHttpFactory.superClass_">goog.net.DefaultXmlHttpFactory.superClass_</a> : <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ instantiating this directly, but rather using it via goog.net.XmlHttp.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.net.DefaultXmlHttpFactory <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.net.DefaultXmlHttpFactory</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l171">code &raquo;</a><span class="member"><a name="createInstance">createInstance</a> <span class="args">( )</span> &rArr; <code class="type">(XMLHttpRequest|goog.net.XhrLike)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l206">code &raquo;</a><span class="member"><a name="getProgId_">getProgId_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Initialize the private state used by other functions.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The ActiveX PROG ID string to use to create xhr's in IE.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l182">code &raquo;</a><span class="member"><a name="internalGetOptions">internalGetOptions</a> <span class="args">( )</span> &rArr; <code class="type">(Object|null)</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l54">code &raquo;</a><span class="member"><a name="getOptions">getOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Options describing how xhr objects obtained from this
+     factory should be used.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.net.DefaultXmlHttpFactory</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l198">code &raquo;</a><span class="member"><a name="ieProgId_">ieProgId_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>The ActiveX PROG ID string to use to create xhr's in IE. Lazily initialized.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l41">code &raquo;</a><span class="member"><a name="cachedOptions_">cachedOptions_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Cache of options - we only actually call internalGetOptions once.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l164">code &raquo;</a><span class="member"><a name="goog.net.DefaultXmlHttpFactory.superClass_">goog.net.DefaultXmlHttpFactory.superClass_</a> : <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_net_WrapperXmlHttpFactory.html b/docs/class_goog_net_WrapperXmlHttpFactory.html
index caf95bc..927086d 100644
--- a/docs/class_goog_net_WrapperXmlHttpFactory.html
+++ b/docs/class_goog_net_WrapperXmlHttpFactory.html
@@ -1,8 +1,7 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.WrapperXmlHttpFactory</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.net.WrapperXmlHttpFactory</h1><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l38">code &raquo;</a><pre><code><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.WrapperXmlHttpFactory</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.net.WrapperXmlHttpFactory</h1><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l41">code &raquo;</a><pre><code><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a>
   &#x2514; goog.net.WrapperXmlHttpFactory</code></pre></header><section><p>An xhr factory subclass which can be constructed using two factory methods.
  This exists partly to allow the preservation of goog.net.XmlHttp.setFactory()
- with an unchanged signature.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.net.WrapperXmlHttpFactory <span class="args">( xhrFactory, optionsFactory )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>xhrFactory: <code class="type">function(): !(<a href="http://www.w3.org/TR/XMLHttpRequest/#xmlhttprequest-object">XMLHttpRequest</a>|GearsHttpRequest)</code><dd>A
-     function which returns a new XHR object.<dt>optionsFactory: <code class="type">function(): !<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>A function which returns the
-     options associated with xhr objects from this factory.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.net.WrapperXmlHttpFactory</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l59">code &raquo;</a><span class="member"><a name="createInstance">createInstance</a> <span class="args">( )</span> &rArr; <code class="type">(GearsHttpRequest|XMLHttpRequest)</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l65">code &raquo;</a><span class="member"><a name="getOptions">getOptions</a> <span class="args">( )</span> &rArr; <code class="type">(Object|null)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l53">code &raquo;</a><span class="member"><a name="optionsFactory_">optionsFactory_</a> <span class="args">( )</span> &rArr; <code class="type">Object</code></span></div><p>Options factory method.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l46">code &raquo;</a><span class="member"><a name="xhrFactory_">xhrFactory_</a> <span class="args">( )</span> &rArr; <code class="type">(GearsHttpRequest|XMLHttpRequest)</code></span></div><p>XHR factory method.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></h3><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l64">code &raquo;</a><span class="member"><a name="internalGetOptions">internalGetOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Override this method in subclasses to preserve the caching offered by
+ with an unchanged signature.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.net.WrapperXmlHttpFactory <span class="args">( xhrFactory, optionsFactory )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>xhrFactory: <code class="type">function(): !<a href="interface_goog_net_XhrLike.html#goog.net.XhrLike.OrNative">goog.net.XhrLike.OrNative</a></code><dd>A function which returns a new XHR object.<dt>optionsFactory: <code class="type">function(): !<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>A function which returns the
+     options associated with xhr objects from this factory.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.net.WrapperXmlHttpFactory</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l62">code &raquo;</a><span class="member"><a name="createInstance">createInstance</a> <span class="args">( )</span> &rArr; <code class="type">(XMLHttpRequest|goog.net.XhrLike)</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l68">code &raquo;</a><span class="member"><a name="getOptions">getOptions</a> <span class="args">( )</span> &rArr; <code class="type">(Object|null)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l56">code &raquo;</a><span class="member"><a name="optionsFactory_">optionsFactory_</a> <span class="args">( )</span> &rArr; <code class="type">Object</code></span></div><p>Options factory method.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l49">code &raquo;</a><span class="member"><a name="xhrFactory_">xhrFactory_</a> <span class="args">( )</span> &rArr; <code class="type">(XMLHttpRequest|goog.net.XhrLike)</code></span></div><p>XHR factory method.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></h3><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l67">code &raquo;</a><span class="member"><a name="internalGetOptions">internalGetOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Override this method in subclasses to preserve the caching offered by
  getOptions().</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Options describing how xhr objects obtained from this
-     factory should be used.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l38">code &raquo;</a><span class="member"><a name="cachedOptions_">cachedOptions_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Cache of options - we only actually call internalGetOptions once.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l38">code &raquo;</a><span class="member"><a name="goog.net.WrapperXmlHttpFactory.superClass_">goog.net.WrapperXmlHttpFactory.superClass_</a> : <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     factory should be used.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l41">code &raquo;</a><span class="member"><a name="cachedOptions_">cachedOptions_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Cache of options - we only actually call internalGetOptions once.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/wrapperxmlhttpfactory.js.src.html#l41">code &raquo;</a><span class="member"><a name="goog.net.WrapperXmlHttpFactory.superClass_">goog.net.WrapperXmlHttpFactory.superClass_</a> : <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_net_XmlHttpFactory.html b/docs/class_goog_net_XmlHttpFactory.html
index 7850a12..849e5ee 100644
--- a/docs/class_goog_net_XmlHttpFactory.html
+++ b/docs/class_goog_net_XmlHttpFactory.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttpFactory</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.net.XmlHttpFactory</h1><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l29">code &raquo;</a></header><section><p>Abstract base class for an XmlHttpRequest factory.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.net.XmlHttpFactory <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l44">code &raquo;</a><span class="member"><a name="createInstance">createInstance</a> <span class="args">( )</span> &rArr; <code class="type">!(<a href="http://www.w3.org/TR/XMLHttpRequest/#xmlhttprequest-object">XMLHttpRequest</a>|GearsHttpRequest)</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new XMLHttpRequest instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l51">code &raquo;</a><span class="member"><a name="getOptions">getOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Options describing how xhr objects obtained from this
-     factory should be used.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l64">code &raquo;</a><span class="member"><a name="internalGetOptions">internalGetOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Override this method in subclasses to preserve the caching offered by
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttpFactory</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.net.XmlHttpFactory</h1><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l32">code &raquo;</a></header><section><p>Abstract base class for an XmlHttpRequest factory.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.net.XmlHttpFactory <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l47">code &raquo;</a><span class="member"><a name="createInstance">createInstance</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="interface_goog_net_XhrLike.html#goog.net.XhrLike.OrNative">goog.net.XhrLike.OrNative</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new XhrLike instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l54">code &raquo;</a><span class="member"><a name="getOptions">getOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Options describing how xhr objects obtained from this
+     factory should be used.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l67">code &raquo;</a><span class="member"><a name="internalGetOptions">internalGetOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Override this method in subclasses to preserve the caching offered by
  getOptions().</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Options describing how xhr objects obtained from this
-     factory should be used.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l38">code &raquo;</a><span class="member"><a name="cachedOptions_">cachedOptions_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Cache of options - we only actually call internalGetOptions once.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     factory should be used.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l41">code &raquo;</a><span class="member"><a name="cachedOptions_">cachedOptions_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Cache of options - we only actually call internalGetOptions once.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_structs_Map.html b/docs/class_goog_structs_Map.html
index b3b0b7b..68fa850 100644
--- a/docs/class_goog_structs_Map.html
+++ b/docs/class_goog_structs_Map.html
@@ -1,21 +1,21 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.structs.Map</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.structs.Map</h1><a class="source" href="source/lib/goog/structs/map.js.src.html#l44">code &raquo;</a></header><section><p>Class for Hash Map datastructure.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.structs.Map <span class="args">( opt_map, var_args )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_map: <code class="type">*=</code><dd>Map or Object to initialize the map with.<dt>var_args: <code class="type">...*</code><dd>If 2 or more arguments are present then they
-     will be used as key-value pairs.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l412">code &raquo;</a><span class="member"><a name="__iterator__">__iterator__</a> <span class="args">( opt_keys )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns an iterator that iterates over the values or the keys in the map.
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.structs.Map</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.structs.Map.<code class="type">&lt;K, V&gt;</code></h1><a class="source" href="source/lib/goog/structs/map.js.src.html#l45">code &raquo;</a></header><section><p>Class for Hash Map datastructure.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.structs.Map <span class="args">( opt_map, var_args )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_map: <code class="type">*=</code><dd>Map or Object to initialize the map with.<dt>var_args: <code class="type">...*</code><dd>If 2 or more arguments are present then they
+     will be used as key-value pairs.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l424">code &raquo;</a><span class="member"><a name="__iterator__">__iterator__</a> <span class="args">( opt_keys )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns an iterator that iterates over the values or the keys in the map.
  This throws an exception if the map was mutated since the iterator was
  created.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_keys: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>True to iterate over the keys. False to iterate
-     over the values.  The default value is false.</dl><tr><th>Returns<tr><td><dl>An iterator over the values or keys in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l323">code &raquo;</a><span class="member"><a name="addAll">addAll</a> <span class="args">( map )</span></span></div><p>Adds multiple key-value pairs from another goog.structs.Map or Object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>map: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object containing the data to add.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l249">code &raquo;</a><span class="member"><a name="cleanupKeysArray_">cleanupKeysArray_</a> <span class="args">( )</span></span></div><p>Cleans up the temp keys array by removing entries that are no longer in the
- map.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l212">code &raquo;</a><span class="member"><a name="clear">clear</a> <span class="args">( )</span></span></div><p>Removes all key-value pairs from the map.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l344">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_structs_Map.html">goog.structs.Map</a></code></span></div><p>Clones a map and returns a new map.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new map with the same key-value pairs.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l139">code &raquo;</a><span class="member"><a name="containsKey">containsKey</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the map contains the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">*</code><dd>The key to check for.</dl><tr><th>Returns<tr><td><dl>Whether the map contains the key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l149">code &raquo;</a><span class="member"><a name="containsValue">containsValue</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the map contains the given value. This is O(n).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The value to check for.</dl><tr><th>Returns<tr><td><dl>Whether the map contains the value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l168">code &raquo;</a><span class="member"><a name="equals">equals</a> <span class="args">( otherMap, opt_equalityFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether this map is equal to the argument map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>otherMap: <code class="type"><a href="class_goog_structs_Map.html">goog.structs.Map</a></code><dd>The map against which to test equality.<dt>opt_equalityFn: <code class="type">function(?, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional equality function
+     over the values.  The default value is false.</dl><tr><th>Returns<tr><td><dl>An iterator over the values or keys in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l319">code &raquo;</a><span class="member"><a name="addAll">addAll</a> <span class="args">( map )</span></span></div><p>Adds multiple key-value pairs from another goog.structs.Map or Object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>map: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object containing the data to add.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l244">code &raquo;</a><span class="member"><a name="cleanupKeysArray_">cleanupKeysArray_</a> <span class="args">( )</span></span></div><p>Cleans up the temp keys array by removing entries that are no longer in the
+ map.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l207">code &raquo;</a><span class="member"><a name="clear">clear</a> <span class="args">( )</span></span></div><p>Removes all key-value pairs from the map.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l356">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_structs_Map.html">goog.structs.Map</a></code></span></div><p>Clones a map and returns a new map.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new map with the same key-value pairs.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l134">code &raquo;</a><span class="member"><a name="containsKey">containsKey</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the map contains the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">*</code><dd>The key to check for.</dl><tr><th>Returns<tr><td><dl>Whether the map contains the key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l144">code &raquo;</a><span class="member"><a name="containsValue">containsValue</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the map contains the given value. This is O(n).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">V</code><dd>The value to check for.</dl><tr><th>Returns<tr><td><dl>Whether the map contains the value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l163">code &raquo;</a><span class="member"><a name="equals">equals</a> <span class="args">( otherMap, opt_equalityFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether this map is equal to the argument map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>otherMap: <code class="type"><a href="class_goog_structs_Map.html">goog.structs.Map</a></code><dd>The map against which to test equality.<dt>opt_equalityFn: <code class="type">function(V, V): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Optional equality function
      to test equality of values. If not specified, this will test whether
-     the values contained in each map are identical objects.</dl><tr><th>Returns<tr><td><dl>Whether the maps are equal.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l294">code &raquo;</a><span class="member"><a name="get">get</a> <span class="args">( key, opt_val )</span> &rArr; <code class="type">*</code></span></div><p>Returns the value for the given key.  If the key is not found and the default
- value is not given this will return <code >undefined</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">*</code><dd>The key to get the value for.<dt>opt_val: <code class="type">*=</code><dd>The value to return if no item is found for the given
-     key, defaults to undefined.</dl><tr><th>Returns<tr><td><dl>The value for the given key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l103">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of key-value pairs in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l389">code &raquo;</a><span class="member"><a name="getKeyIterator">getKeyIterator</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns an iterator that iterates over the keys in the map.  Removal of keys
- while iterating might have undesired side effects.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>An iterator over the keys in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l128">code &raquo;</a><span class="member"><a name="getKeys">getKeys</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns the keys of the map.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Array of string values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l399">code &raquo;</a><span class="member"><a name="getValueIterator">getValueIterator</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns an iterator that iterates over the values in the map.  Removal of
- keys while iterating might have undesired side effects.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>An iterator over the values in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l112">code &raquo;</a><span class="member"><a name="getValues">getValues</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns the values of the map.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The values in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l204">code &raquo;</a><span class="member"><a name="isEmpty">isEmpty</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the map is empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l227">code &raquo;</a><span class="member"><a name="remove">remove</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes a key-value pair based on the key. This is O(logN) amortized due to
+     the values contained in each map are identical objects.</dl><tr><th>Returns<tr><td><dl>Whether the maps are equal.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l342">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="forEach">forEach</a> <span class="args">( f, opt_obj )</span></span></div><p>Calls the given function on each entry in the map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>f<dt>opt_obj: <code class="type">T=</code><dd>The value of "this" inside f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l290">code &raquo;</a><code class="type">&lt;DEFAULT&gt;</code> <span class="member"><a name="get">get</a> <span class="args">( key, opt_val )</span> &rArr; <code class="type">(V|DEFAULT)</code></span></div><p>Returns the value for the given key.  If the key is not found and the default
+ value is not given this will return <code >undefined</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">*</code><dd>The key to get the value for.<dt>opt_val: <code class="type">DEFAULT=</code><dd>The value to return if no item is found for the
+     given key, defaults to undefined.</dl><tr><th>Returns<tr><td><dl>The value for the given key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l98">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of key-value pairs in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l401">code &raquo;</a><span class="member"><a name="getKeyIterator">getKeyIterator</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns an iterator that iterates over the keys in the map.  Removal of keys
+ while iterating might have undesired side effects.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>An iterator over the keys in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l123">code &raquo;</a><span class="member"><a name="getKeys">getKeys</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns the keys of the map.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Array of string values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l411">code &raquo;</a><span class="member"><a name="getValueIterator">getValueIterator</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns an iterator that iterates over the values in the map.  Removal of
+ keys while iterating might have undesired side effects.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>An iterator over the values in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l107">code &raquo;</a><span class="member"><a name="getValues">getValues</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;V&gt;</code></span></div><p>Returns the values of the map.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The values in the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l199">code &raquo;</a><span class="member"><a name="isEmpty">isEmpty</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the map is empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l222">code &raquo;</a><span class="member"><a name="remove">remove</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes a key-value pair based on the key. This is O(logN) amortized due to
  updating the keys array whenever the count becomes half the size of the keys
- in the keys array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">*</code><dd>The key to remove.</dl><tr><th>Returns<tr><td><dl>Whether object was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l308">code &raquo;</a><span class="member"><a name="set">set</a> <span class="args">( key, value )</span> &rArr; <code class="type">*</code></span></div><p>Adds a key-value pair to the map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">*</code><dd>The key.<dt>value: <code class="type">*</code><dd>The value to add.</dl><tr><th>Returns<tr><td><dl>Some subclasses return a value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l373">code &raquo;</a><span class="member"><a name="toObject">toObject</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Object representation of the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l358">code &raquo;</a><span class="member"><a name="transpose">transpose</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_structs_Map.html">goog.structs.Map</a></code></span></div><p>Returns a new map in which all the keys and values are interchanged
+ in the keys array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">*</code><dd>The key to remove.</dl><tr><th>Returns<tr><td><dl>Whether object was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l304">code &raquo;</a><span class="member"><a name="set">set</a> <span class="args">( key, value )</span> &rArr; <code class="type">*</code></span></div><p>Adds a key-value pair to the map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">*</code><dd>The key.<dt>value: <code class="type">V</code><dd>The value to add.</dl><tr><th>Returns<tr><td><dl>Some subclasses return a value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l385">code &raquo;</a><span class="member"><a name="toObject">toObject</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Object representation of the map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l370">code &raquo;</a><span class="member"><a name="transpose">transpose</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_structs_Map.html">goog.structs.Map</a></code></span></div><p>Returns a new map in which all the keys and values are interchanged
  (keys become values and values become keys). If multiple keys map to the
  same value, the chosen transposed value is implementation-dependent.
 
- It acts very similarly to {goog.object.transpose(Object)}.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The transposed map.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l89">code &raquo;</a><span class="member"><a name="count_">count_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of key value pairs in the map.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l67">code &raquo;</a><span class="member"><a name="keys_">keys_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>An array of keys. This is necessary for two reasons:
+ It acts very similarly to {goog.object.transpose(Object)}.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The transposed map.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l72">code &raquo;</a><span class="member"><a name="count_">count_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of key value pairs in the map.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l66">code &raquo;</a><span class="member"><a name="keys_">keys_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>An array of keys. This is necessary for two reasons:
    1. Iterating the keys using for (var key in this.map_) allocates an
       object for every key in IE which is really bad for IE6 GC perf.
    2. Without a side data structure, we would need to escape all the keys
@@ -24,5 +24,5 @@
 
  This array can contain deleted keys so it's necessary to check the map
  as well to see if the key is still in the map (this doesn't require a
- memory allocation in IE).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l51">code &raquo;</a><span class="member"><a name="map_">map_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Underlying JS object used to implement the map.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l97">code &raquo;</a><span class="member"><a name="version_">version_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Version used to detect changes while iterating.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l196">code &raquo;</a><span class="member"><a name="goog.structs.Map.defaultEquals">goog.structs.Map.defaultEquals</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Default equality test for values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">*</code><dd>The first value.<dt>b: <code class="type">*</code><dd>The second value.</dl><tr><th>Returns<tr><td><dl>Whether a and b reference the same object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l447">code &raquo;</a><span class="member"><a name="goog.structs.Map.hasKey_">goog.structs.Map.hasKey_</a> <span class="args">( obj, key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Safe way to test for hasOwnProperty.  It even allows testing for
- 'hasOwnProperty'.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to test for presence of the given key.<dt>key: <code class="type">*</code><dd>The key to check for.</dl><tr><th>Returns<tr><td><dl>Whether the object has the key.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ memory allocation in IE).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l51">code &raquo;</a><span class="member"><a name="map_">map_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Underlying JS object used to implement the map.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l78">code &raquo;</a><span class="member"><a name="version_">version_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Version used to detect changes while iterating.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l191">code &raquo;</a><span class="member"><a name="goog.structs.Map.defaultEquals">goog.structs.Map.defaultEquals</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Default equality test for values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">*</code><dd>The first value.<dt>b: <code class="type">*</code><dd>The second value.</dl><tr><th>Returns<tr><td><dl>Whether a and b reference the same object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/map.js.src.html#l459">code &raquo;</a><span class="member"><a name="goog.structs.Map.hasKey_">goog.structs.Map.hasKey_</a> <span class="args">( obj, key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Safe way to test for hasOwnProperty.  It even allows testing for
+ 'hasOwnProperty'.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to test for presence of the given key.<dt>key: <code class="type">*</code><dd>The key to check for.</dl><tr><th>Returns<tr><td><dl>Whether the object has the key.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_structs_Set.html b/docs/class_goog_structs_Set.html
new file mode 100644
index 0000000..306ff30
--- /dev/null
+++ b/docs/class_goog_structs_Set.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.structs.Set</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.structs.Set.<code class="type">&lt;T&gt;</code></h1><a class="source" href="source/lib/goog/structs/set.js.src.html#l52">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="">goog.structs.Collection.&lt;(T|null)&gt;</a></code></dl></header><section><p>A set that can contain both primitives and objects.  Adding and removing
+ elements is O(1).  Primitives are treated as identical if they have the same
+ type and convert to the same string.  Objects are treated as identical only
+ if they are references to the same object.  WARNING: A goog.structs.Set can
+ contain both 1 and (new Number(1)), because they are not the same.  WARNING:
+ Adding (new Number(1)) twice will yield two distinct elements, because they
+ are two different objects.  WARNING: Any object that is added to a
+ goog.structs.Set will be modified!  Because goog.getUid() is used to
+ identify objects, every object in the set will be mutated.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.structs.Set <span class="args">( opt_values )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_values: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)=</code><dd>Initial values to start with.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l278">code &raquo;</a><span class="member"><a name="__iterator__">__iterator__</a> <span class="args">( opt_keys )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns an iterator that iterates over the elements in this set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_keys: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>This argument is ignored.</dl><tr><th>Returns<tr><td><dl>An iterator over the elements in this set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l92">code &raquo;</a><span class="member"><a name="add">add</a> <span class="args">( element )</span></span></div><p>Add a primitive or an object to the set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">T</code><dd>The primitive or object to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l102">code &raquo;</a><span class="member"><a name="addAll">addAll</a> <span class="args">( col )</span></span></div><p>Adds all the values in the given collection to this set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="interface_goog_structs_Collection.html">goog.structs.Collection</a>.&lt;T&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>A collection
+     containing the elements to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l139">code &raquo;</a><span class="member"><a name="clear">clear</a> <span class="args">( )</span></span></div><p>Removes all elements from this set.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l228">code &raquo;</a><span class="member"><a name="clone">clone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_structs_Set.html">goog.structs.Set</a>.&lt;T&gt;</code></span></div><p>Creates a shallow clone of this set.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new set containing all the same elements as
+     this set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l159">code &raquo;</a><span class="member"><a name="contains">contains</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether this set contains the given element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">T</code><dd>The primitive or object to test for.</dl><tr><th>Returns<tr><td><dl>True if this set contains the given element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l171">code &raquo;</a><span class="member"><a name="containsAll">containsAll</a> <span class="args">( col )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether this set contains all the values in a given collection.
+ Repeated elements in the collection are ignored, e.g.  (new
+ goog.structs.Set([1, 2])).containsAll([1, 1]) is True.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">(<a href="interface_goog_structs_Collection.html">goog.structs.Collection</a>.&lt;T&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>A collection-like object.</dl><tr><th>Returns<tr><td><dl>True if the set contains all elements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l207">code &raquo;</a><span class="member"><a name="difference">difference</a> <span class="args">( col )</span> &rArr; <code class="type">!<a href="class_goog_structs_Set.html">goog.structs.Set</a></code></span></div><p>Finds all values that are present in this set and not in the given
+ collection.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="interface_goog_structs_Collection.html">goog.structs.Collection</a>.&lt;T&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>A collection.</dl><tr><th>Returns<tr><td><dl>A new set containing all the values
+     (primitives or objects) present in this set but not in the given
+     collection.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l242">code &raquo;</a><span class="member"><a name="equals">equals</a> <span class="args">( col )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether the given collection consists of the same elements as this set,
+ regardless of order, without repetition.  Primitives are treated as equal if
+ they have the same type and convert to the same string; objects are treated
+ as equal if they are references to the same object.  This operation is O(n).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">(<a href="interface_goog_structs_Collection.html">goog.structs.Collection</a>.&lt;T&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>A collection.</dl><tr><th>Returns<tr><td><dl>True if the given collection consists of the same elements
+     as this set, regardless of order, without repetition.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l82">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of elements in the set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l218">code &raquo;</a><span class="member"><a name="getValues">getValues</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Returns an array containing all the elements in this set.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>An array containing all the elements in this set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l184">code &raquo;</a><code class="type">&lt;S&gt;</code> <span class="member"><a name="intersection">intersection</a> <span class="args">( col )</span> &rArr; <code class="type">!<a href="class_goog_structs_Set.html">goog.structs.Set</a></code></span></div><p>Finds all values that are present in both this set and the given collection.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;S&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>A collection.</dl><tr><th>Returns<tr><td><dl>A new set containing all the values
+     (primitives or objects) present in both this set and the given
+     collection.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l148">code &raquo;</a><span class="member"><a name="isEmpty">isEmpty</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether this set is empty.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>True if there are no elements in this set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l255">code &raquo;</a><span class="member"><a name="isSubsetOf">isSubsetOf</a> <span class="args">( col )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether the given collection contains all the elements in this set.
+ Primitives are treated as equal if they have the same type and convert to the
+ same string; objects are treated as equal if they are references to the same
+ object.  This operation is O(n).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">(<a href="interface_goog_structs_Collection.html">goog.structs.Collection</a>.&lt;T&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>A collection.</dl><tr><th>Returns<tr><td><dl>True if this set is a subset of the given collection.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l131">code &raquo;</a><span class="member"><a name="remove">remove</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes the given element from this set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">T</code><dd>The primitive or object to remove.</dl><tr><th>Returns<tr><td><dl>Whether the element was found and removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l116">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( col )</span></span></div><p>Removes all values in the given collection from this set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="interface_goog_structs_Collection.html">goog.structs.Collection</a>.&lt;T&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>A collection
+     containing the elements to remove.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l53">code &raquo;</a><span class="member"><a name="goog.structs.Set.prototype.map_">goog.structs.Set.prototype.map_</a> : <code class="type"><a href="class_goog_structs_Map.html">goog.structs.Map</a></code></span></div><p>Class for Hash Map datastructure.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/set.js.src.html#l68">code &raquo;</a><span class="member"><a name="goog.structs.Set.getKey_">goog.structs.Set.getKey_</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Obtains a unique key for an element of the set.  Primitives will yield the
+ same key if they have the same type and convert to the same string.  Object
+ references will yield the same key only if they refer to the same object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Object or primitive value to get a key for.</dl><tr><th>Returns<tr><td><dl>A unique key for this value/object.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_AsyncTestCase.html b/docs/class_goog_testing_AsyncTestCase.html
new file mode 100644
index 0000000..22a3b14
--- /dev/null
+++ b/docs/class_goog_testing_AsyncTestCase.html
@@ -0,0 +1,81 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.AsyncTestCase</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.AsyncTestCase</h1><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l125">code &raquo;</a><pre><code><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a>
+  &#x2514; goog.testing.AsyncTestCase</code></pre></header><section><p>A test case that is capable of running tests the contain asynchronous logic.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.AsyncTestCase <span class="args">( opt_name )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A descriptive name for the test case.</dl></table></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_testing_AsyncTestCase_ControlBreakingException.html">goog.testing.AsyncTestCase.ControlBreakingException</a><dd>An exception class used solely for control flow.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l136">code &raquo;</a><a class="member" name="goog.testing.AsyncTestCase.TopStackFuncResult_">goog.testing.AsyncTestCase.TopStackFuncResult_</a> : <code class="type">{controlBreakingExceptionThrown: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, message: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code></div><div>Represents result of top stack function call.</div></summary></details></div></div></section><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.testing.AsyncTestCase</code></h3><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l749">code &raquo;</a><span class="member"><a name="callTopOfStackFunc_">callTopOfStackFunc_</a> <span class="args">( func )</span> &rArr; <code class="type">!<a href="class_goog_testing_AsyncTestCase.html#goog.testing.AsyncTestCase.TopStackFuncResult_">goog.testing.AsyncTestCase.TopStackFuncResult_</a></code></span></div><p>Calls the given function, redirecting any exceptions to doAsyncError.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>func: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.</dl><tr><th>Returns<tr><td><dl>Returns a
+ TopStackFuncResult_.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l377">code &raquo;</a><span class="member"><a name="continueTesting">continueTesting</a> <span class="args">( )</span></span></div><p>Continue with the next step in the test cycle.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l512">code &raquo;</a><span class="member"><a name="cycleTests">cycleTests</a> <span class="args">( )</span></span></div><p>Starts the tests.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l544">code &raquo;</a><span class="member"><a name="dbgLog_">dbgLog_</a> <span class="args">( message )</span></span></div><p>Logs the given debug message to the console (when enabled).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The message to log.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l439">code &raquo;</a><span class="member"><a name="doAsyncError">doAsyncError</a> <span class="args">( opt_e )</span></span></div><p>Handles an exception thrown by a test.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_e: <code class="type">*=</code><dd>The exception object associated with the failure
+     or a string.</dl><tr><th>Throws<tr><td><dl><dt><dd>throws a ControlBreakingException.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l582">code &raquo;</a><span class="member"><a name="doAsyncErrorTearDown_">doAsyncErrorTearDown_</a> <span class="args">( )</span></span></div><p>Calls the tearDown function, catching any errors, and then moves on to
+ the next step in the testing cycle.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l872">code &raquo;</a><span class="member"><a name="doExecute_">doExecute_</a> <span class="args">( )</span></span></div><p>Step 3: Call test.execute().</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l836">code &raquo;</a><span class="member"><a name="doIteration_">doIteration_</a> <span class="args">( )</span></span></div><p>Step 1: Move to the next test.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l893">code &raquo;</a><span class="member"><a name="doNext_">doNext_</a> <span class="args">( )</span></span></div><p>Step 5: Call doSuccess()</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l826">code &raquo;</a><span class="member"><a name="doSetUpPage_">doSetUpPage_</a> <span class="args">( )</span></span></div><p>Sets up the test page and then waits untill the test case has been marked
+ as ready before executing the tests.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l860">code &raquo;</a><span class="member"><a name="doSetUp_">doSetUp_</a> <span class="args">( )</span></span></div><p>Step 2: Call setUp().</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l882">code &raquo;</a><span class="member"><a name="doTearDown_">doTearDown_</a> <span class="args">( )</span></span></div><p>Step 4: Call tearDown().</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l558">code &raquo;</a><span class="member"><a name="doTopOfStackAsyncError_">doTopOfStackAsyncError_</a> <span class="args">( opt_e )</span></span></div><p>Wraps doAsyncError() for when we are sure that the test runner has no user
+ code above it in the stack.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_e: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>)=</code><dd>The exception object associated with the
+     failure or a string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l534">code &raquo;</a><span class="member"><a name="enableDebugLogging">enableDebugLogging</a> <span class="args">( )</span></span></div><p>Enables verbose logging of what is happening inside of the AsyncTestCase.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l390">code &raquo;</a><span class="member"><a name="endCurrentStep_">endCurrentStep_</a> <span class="args">( )</span></span></div><p>Ends the current test step and queues the next test step to run.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l524">code &raquo;</a><span class="member"><a name="finalize">finalize</a> <span class="args">( )</span></span></div><p>Finalizes the test case, called when the tests have finished executing.</summary></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l341">code &raquo;</a><span class="member"><a name="getCurrentStepName">getCurrentStepName</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The current step name.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Step name.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l622">code &raquo;</a><span class="member"><a name="hookAssert_">hookAssert_</a> <span class="args">( )</span></span></div><p>Replaces the asserts.js assert_() and fail() functions with a wrappers to
+ catch the exceptions.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l654">code &raquo;</a><span class="member"><a name="hookOnError_">hookOnError_</a> <span class="args">( )</span></span></div><p>Sets a window.onerror handler for catching exceptions that happen in async
+ callbacks. Note that as of Safari 3.1, Safari does not support this.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l776">code &raquo;</a><span class="member"><a name="pump_">pump_</a> <span class="args">( opt_doFirst )</span></span></div><p>Calls the next callback when the isReady_ flag is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_doFirst: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>A function to call before pumping.</dl><tr><th>Throws<tr><td><dl><dt><dd>a ControlBreakingException if there were any failing steps.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l498">code &raquo;</a><span class="member"><a name="runTests">runTests</a> <span class="args">( )</span></span></div><p>Sets up the test page and then waits until the test case has been marked
+ as ready before executing the tests.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l736">code &raquo;</a><span class="member"><a name="setNextStep_">setNextStep_</a> <span class="args">( func, name )</span></span></div><p>Sets the next function to call in our sequence of async callbacks.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>func: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function that executes the next step.<dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A description of the next step.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l425">code &raquo;</a><span class="member"><a name="signal">signal</a> <span class="args">( )</span></span></div><p>Signals once to continue with the test. If this is the last signal that the
+ test was waiting on, call continueTesting.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l703">code &raquo;</a><span class="member"><a name="startTimeoutTimer_">startTimeoutTimer_</a> <span class="args">( )</span></span></div><p>Enables the timeout timer. This timer fires unless continueTesting is
+ called.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l721">code &raquo;</a><span class="member"><a name="stopTimeoutTimer_">stopTimeoutTimer_</a> <span class="args">( )</span></span></div><p>Disables the timeout timer.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l686">code &raquo;</a><span class="member"><a name="unhookAll_">unhookAll_</a> <span class="args">( )</span></span></div><p>Unhooks window.onerror and _assert.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l364">code &raquo;</a><span class="member"><a name="waitForAsync">waitForAsync</a> <span class="args">( opt_name )</span></span></div><p>Informs the testcase not to continue to the next step in the test cycle
+ until continueTesting is called.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A description of what we are waiting for.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l412">code &raquo;</a><span class="member"><a name="waitForSignals">waitForSignals</a> <span class="args">( times, opt_name )</span></span></div><p>Informs the testcase not to continue to the next step in the test cycle
+ until signal is called the specified number of times. Within a test, this
+ function behaves additively if called multiple times; the number of signals
+ to wait for will be the sum of all expected number of signals this function
+ was called with.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>times: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of signals to receive before
+    continuing testing.<dt>opt_name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A description of what we are waiting for.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l289">code &raquo;</a><span class="member"><a name="add">add</a> <span class="args">( test )</span></span></div><p>Adds a new test to the test case.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l310">code &raquo;</a><span class="member"><a name="addNewTest">addNewTest</a> <span class="args">( name, ref, opt_scope )</span></span></div><p>Creates and adds a new test.
+
+ Convenience function to make syntax less awkward when not using automatic
+ test discovery.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The test name.<dt>ref: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Reference to the test function.<dt>opt_scope: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Optional scope that the test function should be
+     called in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l751">code &raquo;</a><span class="member"><a name="autoDiscoverLifecycle">autoDiscoverLifecycle</a> <span class="args">( )</span></span></div><p>Adds any functions defined in the global scope that correspond to
+ lifecycle events for the test case. Overrides setUp, tearDown, setUpPage,
+ tearDownPage and runTests if they are defined.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l777">code &raquo;</a><span class="member"><a name="autoDiscoverTests">autoDiscoverTests</a> <span class="args">( )</span></span></div><p>Adds any functions defined in the global scope that are prefixed with "test"
+ to the test case.</summary></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l933">code &raquo;</a><span class="member"><a name="clearTimeout">clearTimeout</a> <span class="args">( id )</span></span></div><p>Clears a timeout created by <code >this.timeout()</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>id: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A timeout id.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l900">code &raquo;</a><span class="member"><a name="countNumFilesLoaded_">countNumFilesLoaded_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counts the number of files that were loaded for dependencies that are
+ required to run the test.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of files loaded.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l740">code &raquo;</a><span class="member"><a name="createTestFromAutoDiscoveredFunction">createTestFromAutoDiscoveredFunction</a> <span class="args">( name, ref )</span> &rArr; <code class="type">!<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code></span></div><p>Creates a <code >goog.testing.TestCase.Test</code> from an auto-discovered
+     function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function.<dt>ref: <code class="type">function(): void</code><dd>The auto-discovered function.</dl><tr><th>Returns<tr><td><dl>The newly created test.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1018">code &raquo;</a><span class="member"><a name="doError">doError</a> <span class="args">( test, opt_e )</span></span></div><p>Handles a test that failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test that failed.<dt>opt_e: <code class="type">*=</code><dd>The exception object associated with the
+     failure or a string.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l998">code &raquo;</a><span class="member"><a name="doSuccess">doSuccess</a> <span class="args">( test )</span></span></div><p>Handles a test that passed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test that passed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l404">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( )</span></span></div><p>Executes each of the tests.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l349">code &raquo;</a><span class="member"><a name="getActuallyRunCount">getActuallyRunCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of tests actually run in the test case, i.e. subtracting
+ any which are skipped.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of un-ignored tests.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l709">code &raquo;</a><span class="member"><a name="getAutoDiscoveryPrefix">getAutoDiscoveryPrefix</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The function name prefix used to auto-discover tests.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l718">code &raquo;</a><span class="member"><a name="getBatchTime">getBatchTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Time since the last batch of tests was started.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l339">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of tests contained in the test case.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of tests.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l648">code &raquo;</a><span class="member"><a name="getGlobals">getGlobals</a> <span class="args">( opt_prefix )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Gets list of objects that potentially contain test cases. For IE 8 and below,
+ this is the global "this" (for properties set directly on the global this or
+ window) and the RuntimeObject (for global variables and functions). For all
+ other browsers, the array simply contains the global this.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>An optional prefix. If specified, only get things
+     under this prefix. Note that the prefix is only honored in IE, since it
+     supports the RuntimeObject:
+     http://msdn.microsoft.com/en-us/library/ff521039%28VS.85%29.aspx
+     TODO: Remove this option.</dl><tr><th>Returns<tr><td><dl>A list of objects that should be inspected.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l153">code &raquo;</a><span class="member"><a name="getName">getName</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The name of the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l569">code &raquo;</a><span class="member"><a name="getNumFilesLoaded">getNumFilesLoaded</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of script files that were loaded in order to run the test.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of script files.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l528">code &raquo;</a><span class="member"><a name="getReport">getReport</a> <span class="args">( opt_verbose )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string detailing the results from the test.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_verbose: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true results will include data about all
+     tests, not just what failed.</dl><tr><th>Returns<tr><td><dl>The results from the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l560">code &raquo;</a><span class="member"><a name="getRunTime">getRunTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the amount of time it took for the test to run.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The run time, in milliseconds.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l579">code &raquo;</a><span class="member"><a name="getTestResults">getTestResults</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns the test results object: a map from test names to a list of test
+ failures (if any exist).</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Tests results object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l330">code &raquo;</a><span class="member"><a name="getTests">getTests</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code></span></div><p>Gets the tests.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The test array.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l957">code &raquo;</a><span class="member"><a name="getTimeStamp_">getTimeStamp_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the current time.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>HH:MM:SS.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l484">code &raquo;</a><span class="member"><a name="isInsideMultiTestRunner">isInsideMultiTestRunner</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test case is running inside the multi test
+     runner.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l517">code &raquo;</a><span class="member"><a name="isSuccess">isSuccess</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test was a success.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l494">code &raquo;</a><span class="member"><a name="log">log</a> <span class="args">( val )</span></span></div><p>Logs an object to the console, if available.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The value to log. Will be ToString'd.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1038">code &raquo;</a><span class="member"><a name="logError">logError</a> <span class="args">( name, opt_e )</span> &rArr; <code class="type">!<a href="class_goog_testing_TestCase_Error.html">goog.testing.TestCase.Error</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Failed test name.<dt>opt_e: <code class="type">*=</code><dd>The exception object associated with the
+     failure or a string.</dl><tr><th>Returns<tr><td><dl>Error object.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l830">code &raquo;</a><span class="member"><a name="maybeFailTestEarly">maybeFailTestEarly</a> <span class="args">( testCase )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks to see if the test should be marked as failed before it is run.
+
+ If there was an error in setUpPage, we treat that as a failure for all tests
+ and mark them all as having failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>testCase: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The current test case.</dl><tr><th>Returns<tr><td><dl>Whether the test was marked as failed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l358">code &raquo;</a><span class="member"><a name="next">next</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code></span></div><p>Returns the current test and increments the pointer.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current test case.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l945">code &raquo;</a><span class="member"><a name="now">now</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current time in milliseconds, don't use goog.now as some
+     tests override it.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l606">code &raquo;</a><span class="member"><a name="orderTests_">orderTests_</a> <span class="args">( tests )</span></span></div><p>Reorders the tests depending on the <code >order</code> field.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tests: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code><dd>An array of tests to
+     reorder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l977">code &raquo;</a><span class="member"><a name="pad_">pad_</a> <span class="args">( number )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Pads a number to make it have a leading zero if it's less than 10.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>number: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to pad.</dl><tr><th>Returns<tr><td><dl>The resulting string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l373">code &raquo;</a><span class="member"><a name="reset">reset</a> <span class="args">( )</span></span></div><p>Resets the test case pointer, so that next returns the first test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l475">code &raquo;</a><span class="member"><a name="saveMessage">saveMessage</a> <span class="args">( message )</span></span></div><p>Saves a message to the result set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The message to save.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l727">code &raquo;</a><span class="member"><a name="setBatchTime">setBatchTime</a> <span class="args">( batchTime )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>batchTime: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Time since the last batch of tests was started.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l384">code &raquo;</a><span class="member"><a name="setCompletedCallback">setCompletedCallback</a> <span class="args">( fn )</span></span></div><p>Sets the callback function that should be executed when the tests have
+ completed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The callback function.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l321">code &raquo;</a><span class="member"><a name="setTests">setTests</a> <span class="args">( tests )</span></span></div><p>Sets the tests.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tests: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code><dd>A new test array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l695">code &raquo;</a><span class="member"><a name="setUp">setUp</a> <span class="args">( )</span></span></div><p>Gets called before every goog.testing.TestCase.Test is been executed. Can be
+ overridden to add set up functionality to each test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l681">code &raquo;</a><span class="member"><a name="setUpPage">setUpPage</a> <span class="args">( )</span></span></div><p>Gets called before any tests are executed.  Can be overridden to set up the
+ environment for the whole test case.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l396">code &raquo;</a><span class="member"><a name="shouldRunTests">shouldRunTests</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Can be overridden in test classes to indicate whether the tests in a case
+ should be run in that particular situation.  For example, this could be used
+ to stop tests running in a particular browser, where browser support for
+ the class under test was absent.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether any of the tests in the case should be run.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l702">code &raquo;</a><span class="member"><a name="tearDown">tearDown</a> <span class="args">( )</span></span></div><p>Gets called after every goog.testing.TestCase.Test has been executed. Can be
+ overriden to add tear down functionality to each test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l688">code &raquo;</a><span class="member"><a name="tearDownPage">tearDownPage</a> <span class="args">( )</span></span></div><p>Gets called after all tests have been executed.  Can be overridden to tear
+ down the entire test case.</summary></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l919">code &raquo;</a><span class="member"><a name="timeout">timeout</a> <span class="args">( fn, time )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Calls a function after a delay, using the protected timeout.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.<dt>time: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Delay in milliseconds.</dl><tr><th>Returns<tr><td><dl>The timeout id.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l988">code &raquo;</a><span class="member"><a name="trimPath_">trimPath_</a> <span class="args">( path )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims a path to be only that after google3.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The path to trim.</dl><tr><th>Returns<tr><td><dl>The resulting string.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.testing.AsyncTestCase</code></h3><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l280">code &raquo;</a><span class="member"><a name="activeTest">activeTest</a> : <code class="type">(<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>The currently active test.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l272">code &raquo;</a><span class="member"><a name="cleanedUp_">cleanedUp_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Marks if the cleanUp() function has been called for the currently running
+ test.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l231">code &raquo;</a><span class="member"><a name="curStepFunc_">curStepFunc_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>The stage of the test we are currently on.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l239">code &raquo;</a><span class="member"><a name="curStepName_">curStepName_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The name of the stage of the test we are currently on.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l201">code &raquo;</a><span class="member"><a name="enableDebugLogs_">enableDebugLogs_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Turn on extra logging to help debug failing async. tests.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l305">code &raquo;</a><span class="member"><a name="expectedSignalCount_">expectedSignalCount_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Number of signals to wait for before continuing testing when waitForSignals
+ is used.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l288">code &raquo;</a><span class="member"><a name="inException_">inException_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>A flag to prevent recursive exception handling.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l296">code &raquo;</a><span class="member"><a name="isReady_">isReady_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Flag used to determine if we can move to the next step in the testing loop.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l247">code &raquo;</a><span class="member"><a name="nextStepFunc">nextStepFunc</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>The stage of the test we should run next.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l255">code &raquo;</a><span class="member"><a name="nextStepName_">nextStepName_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The name of the stage of the test we should run next.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l333">code &raquo;</a><span class="member"><a name="numControlExceptionsExpected_">numControlExceptionsExpected_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of times we have thrown a ControlBreakingException so that we
+ know not to complain in our window.onerror handler. In Webkit, window.onerror
+ is not supported, and so this counter will keep going up but we won't care
+ about it.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l691">code &raquo;</a><span class="member"><a name="origAssert_">origAssert_</a> : <code class="type">?</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l693">code &raquo;</a><span class="member"><a name="origFail_">origFail_</a> : <code class="type">?</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l223">code &raquo;</a><span class="member"><a name="origOnError_">origOnError_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>A reference to the original window.onerror function.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l313">code &raquo;</a><span class="member"><a name="receivedSignalCount_">receivedSignalCount_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Number of signals received.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l322">code &raquo;</a><span class="member"><a name="returnWillPump_">returnWillPump_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Flag that tells us if there is a function in the call stack that will make
+ a call to pump_().</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l184">code &raquo;</a><span class="member"><a name="stepTimeout">stepTimeout</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>How long to wait for a single step of a test to complete in milliseconds.
+ A step starts when a call to waitForAsync() is made.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l193">code &raquo;</a><span class="member"><a name="timeToSleepAfterFailure">timeToSleepAfterFailure</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>How long to wait after a failed test before moving onto the next one.
+ The purpose of this is to allow any pending async callbacks from the failing
+ test to finish up and not cause the next test to fail.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l263">code &raquo;</a><span class="member"><a name="timeoutHandle_">timeoutHandle_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The handle to the current setTimeout timer.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l266">code &raquo;</a><span class="member"><a name="batchTime_">batchTime_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Time since the last batch of tests was started, if batchTime exceeds
+ <code  class="type"><a class="unresolved-link">#maxRunTime</a></code> a timeout will be used to stop the tests blocking the
+ browser and a new batch will be started.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l274">code &raquo;</a><span class="member"><a name="currentTestPointer_">currentTestPointer_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Pointer to the current test.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l234">code &raquo;</a><span class="member"><a name="exceptionBeforeTest">exceptionBeforeTest</a> : <code class="type">*</code></span></div><p>Exception object that was detected before a test runs.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l63">code &raquo;</a><span class="member"><a name="name_">name_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A name for the test case.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l282">code &raquo;</a><span class="member"><a name="onCompleteCallback_">onCompleteCallback_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Optional callback that will be executed when the test has finalized.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l171">code &raquo;</a><span class="member"><a name="order">order</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The order to run the auto-discovered tests in.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l122">code &raquo;</a><span class="member"><a name="result_">result_</a> : <code class="type"><a href="class_goog_testing_TestCase_Result.html">goog.testing.TestCase.Result</a></code></span></div><p>Object used to encapsulate the test results.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l248">code &raquo;</a><span class="member"><a name="running">running</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the test case is running.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l256">code &raquo;</a><span class="member"><a name="startTime_">startTime_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Timestamp for when the test was started.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l241">code &raquo;</a><span class="member"><a name="started">started</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the test case has ever tried to execute.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l92">code &raquo;</a><span class="member"><a name="testsToRun_">testsToRun_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Set of test names and/or indices to execute, or null if all tests should
+ be executed.
+
+ Indices are included to allow automation tools to run a subset of the
+ tests without knowing the exact contents of the test file.
+
+ Indices should only be used with SORTED ordering.
+
+ Example valid values:
+ <ul>
+ <li>[testName]
+ <li>[testName1, testName2]
+ <li>[2] - will run the 3rd test in the order specified
+ <li>[1,3,5]
+ <li>[testName1, testName2, 3, 5] - will work
+ <ul></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l70">code &raquo;</a><span class="member"><a name="tests_">tests_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Array of test functions that can be executed.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l352">code &raquo;</a><span class="member"><a name="goog.testing.AsyncTestCase.createAndInstall">goog.testing.AsyncTestCase.createAndInstall</a> <span class="args">( opt_name )</span> &rArr; <code class="type">!<a href="class_goog_testing_AsyncTestCase.html">goog.testing.AsyncTestCase</a></code></span></div><p>Preferred way of creating an AsyncTestCase. Creates one and initializes it
+ with the G_testRunner.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A descriptive name for the test case.</dl><tr><th>Returns<tr><td><dl>The created AsyncTestCase.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l125">code &raquo;</a><span class="member"><a name="goog.testing.AsyncTestCase.superClass_">goog.testing.AsyncTestCase.superClass_</a> : <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_AsyncTestCase_ControlBreakingException.html b/docs/class_goog_testing_AsyncTestCase_ControlBreakingException.html
new file mode 100644
index 0000000..1336ae2
--- /dev/null
+++ b/docs/class_goog_testing_AsyncTestCase_ControlBreakingException.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.AsyncTestCase.ControlBreakingException</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.AsyncTestCase.ControlBreakingException</h1><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l146">code &raquo;</a></header><section><p>An exception class used solely for control flow.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.AsyncTestCase.ControlBreakingException <span class="args">( opt_message )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l172">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l167">code &raquo;</a><span class="member"><a name="isControlBreakingException">isControlBreakingException</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Marks this object as a ControlBreakingException</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l151">code &raquo;</a><span class="member"><a name="message">message</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The exception message.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asynctestcase.js.src.html#l159">code &raquo;</a><span class="member"><a name="goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING">goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Return value for .toString().</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_FunctionCall.html b/docs/class_goog_testing_FunctionCall.html
new file mode 100644
index 0000000..1b6b6e8
--- /dev/null
+++ b/docs/class_goog_testing_FunctionCall.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.FunctionCall</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.FunctionCall</h1><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l158">code &raquo;</a></header><section><p>Struct for a single function call.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.FunctionCall <span class="args">( func, thisContext, args, ret, error )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>func: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The called function.<dt>thisContext: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><code >this</code> context of called function.<dt>args: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments">Arguments</a></code><dd>Arguments of the called function.<dt>ret: <code class="type">*</code><dd>Return value of the function or undefined in case of error.<dt>error: <code class="type">*</code><dd>The error thrown by the function or null if none.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l197">code &raquo;</a><span class="member"><a name="getArgument">getArgument</a> <span class="args">( index )</span> &rArr; <code class="type">*</code></span></div><p>Returns the nth argument of the called function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>index: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>0-based index of the argument.</dl><tr><th>Returns<tr><td><dl>The argument value or undefined if there is no such argument.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l187">code &raquo;</a><span class="member"><a name="getArguments">getArguments</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Arguments of the called function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l213">code &raquo;</a><span class="member"><a name="getError">getError</a> <span class="args">( )</span> &rArr; <code class="type">*</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The error thrown by the function or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l170">code &raquo;</a><span class="member"><a name="getFunction">getFunction</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The called function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l205">code &raquo;</a><span class="member"><a name="getReturnValue">getReturnValue</a> <span class="args">( )</span> &rArr; <code class="type">*</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Return value of the function or undefined in case of error.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l179">code &raquo;</a><span class="member"><a name="getThis">getThis</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl><code >this</code> context of called function. It is the same as
+     the created object if the function is a constructor.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l161">code &raquo;</a><span class="member"><a name="goog.testing.FunctionCall.prototype.arguments_">goog.testing.FunctionCall.prototype.arguments_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l163">code &raquo;</a><span class="member"><a name="error_">error_</a> : <code class="type">*</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l162">code &raquo;</a><span class="member"><a name="returnValue_">returnValue_</a> : <code class="type">*</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l160">code &raquo;</a><span class="member"><a name="thisContext_">thisContext_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_JsUnitException.html b/docs/class_goog_testing_JsUnitException.html
new file mode 100644
index 0000000..2b0f8ae
--- /dev/null
+++ b/docs/class_goog_testing_JsUnitException.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.JsUnitException</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.JsUnitException</h1><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1205">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
+  &#x2514; goog.testing.JsUnitException</code></pre></header><section><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.JsUnitException <span class="args">( comment, opt_message )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>comment: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A summary for the exception.<dt>opt_message: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A description of the exception.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.testing.JsUnitException</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1226">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.testing.JsUnitException</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1212">code &raquo;</a><span class="member"><a name="comment">comment</a> : <code class="type">(null|string)</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1206">code &raquo;</a><span class="member"><a name="isJsUnitException">isJsUnitException</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1213">code &raquo;</a><span class="member"><a name="jsUnitMessage">jsUnitMessage</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1210">code &raquo;</a><span class="member"><a name="stackTrace">stackTrace</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1205">code &raquo;</a><span class="member"><a name="goog.testing.JsUnitException.superClass_">goog.testing.JsUnitException.superClass_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_LooseExpectationCollection.html b/docs/class_goog_testing_LooseExpectationCollection.html
new file mode 100644
index 0000000..cf6bd52
--- /dev/null
+++ b/docs/class_goog_testing_LooseExpectationCollection.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.LooseExpectationCollection</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.LooseExpectationCollection</h1><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l36">code &raquo;</a></header><section><p>This class is an ordered collection of expectations for one method. Since
+ the loose mock does most of its verification at the time of $verify, this
+ class is necessary to manage the return/throw behavior when the mock is
+ being called.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.LooseExpectationCollection <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l50">code &raquo;</a><span class="member"><a name="addExpectation">addExpectation</a> <span class="args">( expectation )</span></span></div><p>Adds an expectation to this collection.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l60">code &raquo;</a><span class="member"><a name="getExpectations">getExpectations</a> <span class="args">( )</span> &rArr; <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>&gt;</code></span></div><p>Gets the list of expectations in this collection.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The array of expectations.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l42">code &raquo;</a><span class="member"><a name="expectations_">expectations_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>&gt;</code></span></div><p>The list of expectations. All of these should have the same name.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_LooseMock.html b/docs/class_goog_testing_LooseMock.html
new file mode 100644
index 0000000..c08bb54
--- /dev/null
+++ b/docs/class_goog_testing_LooseMock.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.LooseMock</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.LooseMock</h1><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l82">code &raquo;</a><pre><code><a href="class_goog_testing_Mock.html">goog.testing.Mock</a>
+  &#x2514; goog.testing.LooseMock</code></pre><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></dl></header><section><p>This is a mock that does not care about the order of method calls. As a
+ result, it won't throw exceptions until verify() is called. The only
+ exception is that if a method is called that has no expectations, then an
+ exception will be thrown.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.LooseMock <span class="args">( objectToMock, opt_ignoreUnexpectedCalls, opt_mockStaticMethods, opt_createProxy )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>objectToMock: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The object that should be mocked, or
+    the constructor of an object to mock.<dt>opt_ignoreUnexpectedCalls: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to ignore unexpected
+     calls.<dt>opt_mockStaticMethods: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a mock should be constructed from the static functions of a class.<dt>opt_createProxy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a proxy for the target mock should be created.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.testing.LooseMock</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l138">code &raquo;</a><span class="member"><a name="$recordCall">$recordCall</a> <span class="args">( name, args )</span> &rArr; <code class="type">*</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name<dt>args</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l126">code &raquo;</a><span class="member"><a name="$recordExpectation">$recordExpectation</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l187">code &raquo;</a><span class="member"><a name="$replay">$replay</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l178">code &raquo;</a><span class="member"><a name="$reset">$reset</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l118">code &raquo;</a><span class="member"><a name="$setIgnoreUnexpectedCalls">$setIgnoreUnexpectedCalls</a> <span class="args">( ignoreUnexpectedCalls )</span> &rArr; <code class="type">!<a href="class_goog_testing_LooseMock.html">goog.testing.LooseMock</a></code></span></div><p>A setter for the ignoreUnexpectedCalls field.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ignoreUnexpectedCalls: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether to ignore unexpected calls.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l223">code &raquo;</a><span class="member"><a name="$verify">$verify</a> <span class="args">( )</span></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l487">code &raquo;</a><span class="member"><a name="$anyTimes">$anyTimes</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called any number of times.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l603">code &raquo;</a><span class="member"><a name="$argumentsAsString">$argumentsAsString</a> <span class="args">( args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Render the provided argument array to a string to help
+ clients with debugging tests.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments passed to the mock.</dl><tr><th>Returns<tr><td><dl>Human-readable string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l455">code &raquo;</a><span class="member"><a name="$atLeastOnce">$atLeastOnce</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called any number of times, as long as it's
+ called once.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l443">code &raquo;</a><span class="member"><a name="$atMostOnce">$atMostOnce</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called 0 or 1 times.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l394">code &raquo;</a><span class="member"><a name="$do">$do</a> <span class="args">( expectation, args )</span> &rArr; <code class="type">*</code></span></div><p>If this expectation defines a function to be called,
+ it will be called and its result will be returned.
+ Otherwise, if the expectation expects to throw, it will throw.
+ Otherwise, this method will return defined value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation.<dt>args: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments to the method.</dl><tr><th>Returns<tr><td><dl>The return value expected by the mock.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l433">code &raquo;</a><span class="member"><a name="$does">$does</a> <span class="args">( func )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a function to call for currently pending expectation.
+ Note, that using this method overrides declarations made
+ using $returns() and $throws() methods.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>func: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l282">code &raquo;</a><span class="member"><a name="$initializeFunctions_">$initializeFunctions_</a> <span class="args">( objectToMock )</span></span></div><p>Initializes the functions on the mock object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>objectToMock: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object being mocked.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l378">code &raquo;</a><span class="member"><a name="$maybeThrow">$maybeThrow</a> <span class="args">( expectation )</span></span></div><p>If the expectation expects to throw, this method will throw.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l333">code &raquo;</a><span class="member"><a name="$mockMethod">$mockMethod</a> <span class="args">( name )</span> &rArr; <code class="type">*</code></span></div><p>The function that replaces all methods on the mock object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the method being mocked.</dl><tr><th>Returns<tr><td><dl>In record mode, returns the mock object. In replay mode, returns
+    whatever the creator of the mock set as the return value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l476">code &raquo;</a><span class="member"><a name="$never">$never</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Disallows the expectation from being called.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l465">code &raquo;</a><span class="member"><a name="$once">$once</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called exactly once.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l545">code &raquo;</a><span class="member"><a name="$recordAndThrow">$recordAndThrow</a> <span class="args">( ex )</span></span></div><p>Throws an exception and records that an exception was thrown.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Exception.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>#ex.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l320">code &raquo;</a><span class="member"><a name="$registerArgumentListVerifier">$registerArgumentListVerifier</a> <span class="args">( methodName, fn )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Registers a verfifier function to use when verifying method argument lists.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>methodName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the method for which the verifierFn
+     should be used.<dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Argument list verifier function.  Should take 2 argument
+     arrays as arguments, and return true if they are considered equivalent.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l409">code &raquo;</a><span class="member"><a name="$returns">$returns</a> <span class="args">( val )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a return value for the currently pending expectation.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The return value.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l623">code &raquo;</a><span class="member"><a name="$throwCallException">$throwCallException</a> <span class="args">( name, args, opt_expectation )</span></span></div><p>Throw an exception based on an incorrect method call.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name of method called.<dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Arguments passed to the mock.<dt>opt_expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>Expected next call,
+     if any.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l534">code &raquo;</a><span class="member"><a name="$throwException">$throwException</a> <span class="args">( comment, opt_message )</span></span></div><p>Throws an exception and records that an exception was thrown.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>comment: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A short comment about the exception.<dt>opt_message: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A longer message about the exception.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>JsUnitException object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l420">code &raquo;</a><span class="member"><a name="$throws">$throws</a> <span class="args">( val )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a value for the currently pending expectation to throw.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The value to throw.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l499">code &raquo;</a><span class="member"><a name="$times">$times</a> <span class="args">( times )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies the number of times the expectation should be called.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>times: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of times this method will be called.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l584">code &raquo;</a><span class="member"><a name="$verifyCall">$verifyCall</a> <span class="args">( expectation, name, args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Verifies that a method call matches an expectation.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation to check.<dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the called method.<dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments passed to the mock.</dl><tr><th>Returns<tr><td><dl>Whether the call matches the expectation.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.testing.LooseMock</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l101">code &raquo;</a><span class="member"><a name="$calls_">$calls_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>&gt;</code></span></div><p>The calls that have been made; we cache them to verify at the end. Each
+ element is an array where the first element is the name, and the second
+ element is the arguments.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l92">code &raquo;</a><span class="member"><a name="$expectations_">$expectations_</a> : <code class="type"><a href="class_goog_structs_Map.html">goog.structs.Map</a></code></span></div><p>A map of method names to a LooseExpectationCollection for that method.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l108">code &raquo;</a><span class="member"><a name="$ignoreUnexpectedCalls_">$ignoreUnexpectedCalls_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether to ignore unexpected calls.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l248">code &raquo;</a><span class="member"><a name="$argumentListVerifiers_">$argumentListVerifiers_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of argument name to optional argument list verifier function.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l266">code &raquo;</a><span class="member"><a name="$pendingExpectation">$pendingExpectation</a> : <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code></span></div><p>The expectation currently being created. All methods that modify the
+ current expectation return the Mock object for easy chaining, so this is
+ where we keep track of the expectation that's currently being modified.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l241">code &raquo;</a><span class="member"><a name="$proxy">$proxy</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>A proxy for the mock.  This can be used for dependency injection in lieu of
+ the mock if the test requires a strict instanceof check.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l256">code &raquo;</a><span class="member"><a name="$recording_">$recording_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether or not we are in recording mode.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l274">code &raquo;</a><span class="member"><a name="$threwException_">$threwException_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>First exception thrown by this mock; used in $verify.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/loosemock.js.src.html#l82">code &raquo;</a><span class="member"><a name="goog.testing.LooseMock.superClass_">goog.testing.LooseMock.superClass_</a> : <code class="type"><a href="class_goog_testing_Mock.html">goog.testing.Mock.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_Mock.html b/docs/class_goog_testing_Mock.html
new file mode 100644
index 0000000..6cfe20d
--- /dev/null
+++ b/docs/class_goog_testing_Mock.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.Mock</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.Mock</h1><a class="source" href="source/lib/goog/testing/mock.js.src.html#l167">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></dl></header><section><p>The base class for a mock object.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.Mock <span class="args">( objectToMock, opt_mockStaticMethods, opt_createProxy )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>objectToMock: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The object that should be mocked, or
+    the constructor of an object to mock.<dt>opt_mockStaticMethods: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a mock should be constructed from the static functions of a class.<dt>opt_createProxy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a proxy for the target mock should be created.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l487">code &raquo;</a><span class="member"><a name="$anyTimes">$anyTimes</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called any number of times.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l603">code &raquo;</a><span class="member"><a name="$argumentsAsString">$argumentsAsString</a> <span class="args">( args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Render the provided argument array to a string to help
+ clients with debugging tests.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments passed to the mock.</dl><tr><th>Returns<tr><td><dl>Human-readable string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l455">code &raquo;</a><span class="member"><a name="$atLeastOnce">$atLeastOnce</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called any number of times, as long as it's
+ called once.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l443">code &raquo;</a><span class="member"><a name="$atMostOnce">$atMostOnce</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called 0 or 1 times.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l394">code &raquo;</a><span class="member"><a name="$do">$do</a> <span class="args">( expectation, args )</span> &rArr; <code class="type">*</code></span></div><p>If this expectation defines a function to be called,
+ it will be called and its result will be returned.
+ Otherwise, if the expectation expects to throw, it will throw.
+ Otherwise, this method will return defined value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation.<dt>args: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments to the method.</dl><tr><th>Returns<tr><td><dl>The return value expected by the mock.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l433">code &raquo;</a><span class="member"><a name="$does">$does</a> <span class="args">( func )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a function to call for currently pending expectation.
+ Note, that using this method overrides declarations made
+ using $returns() and $throws() methods.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>func: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l282">code &raquo;</a><span class="member"><a name="$initializeFunctions_">$initializeFunctions_</a> <span class="args">( objectToMock )</span></span></div><p>Initializes the functions on the mock object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>objectToMock: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object being mocked.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l378">code &raquo;</a><span class="member"><a name="$maybeThrow">$maybeThrow</a> <span class="args">( expectation )</span></span></div><p>If the expectation expects to throw, this method will throw.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l333">code &raquo;</a><span class="member"><a name="$mockMethod">$mockMethod</a> <span class="args">( name )</span> &rArr; <code class="type">*</code></span></div><p>The function that replaces all methods on the mock object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the method being mocked.</dl><tr><th>Returns<tr><td><dl>In record mode, returns the mock object. In replay mode, returns
+    whatever the creator of the mock set as the return value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l476">code &raquo;</a><span class="member"><a name="$never">$never</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Disallows the expectation from being called.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l465">code &raquo;</a><span class="member"><a name="$once">$once</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called exactly once.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l545">code &raquo;</a><span class="member"><a name="$recordAndThrow">$recordAndThrow</a> <span class="args">( ex )</span></span></div><p>Throws an exception and records that an exception was thrown.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Exception.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>#ex.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l369">code &raquo;</a><span class="member"><a name="$recordCall">$recordCall</a> <span class="args">( name, args )</span> &rArr; <code class="type">*</code></span></div><p>Records an actual method call, intended to be overridden by a
+ subclass. The subclass must find the pending expectation and return the
+ correct value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the method being called.<dt>args: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments to the method.</dl><tr><th>Returns<tr><td><dl>The return expected by the mock.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l357">code &raquo;</a><span class="member"><a name="$recordExpectation">$recordExpectation</a> <span class="args">( )</span></span></div><p>Records the currently pending expectation, intended to be overridden by a
+ subclass.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l320">code &raquo;</a><span class="member"><a name="$registerArgumentListVerifier">$registerArgumentListVerifier</a> <span class="args">( methodName, fn )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Registers a verfifier function to use when verifying method argument lists.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>methodName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the method for which the verifierFn
+     should be used.<dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Argument list verifier function.  Should take 2 argument
+     arrays as arguments, and return true if they are considered equivalent.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l510">code &raquo;</a><span class="member"><a name="$replay">$replay</a> <span class="args">( )</span></span></div><p>Switches from recording to replay mode.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l520">code &raquo;</a><span class="member"><a name="$reset">$reset</a> <span class="args">( )</span></span></div><p>Resets the state of this mock object. This clears all pending expectations
+ without verifying, and puts the mock in recording mode.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l409">code &raquo;</a><span class="member"><a name="$returns">$returns</a> <span class="args">( val )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a return value for the currently pending expectation.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The return value.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l623">code &raquo;</a><span class="member"><a name="$throwCallException">$throwCallException</a> <span class="args">( name, args, opt_expectation )</span></span></div><p>Throw an exception based on an incorrect method call.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name of method called.<dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Arguments passed to the mock.<dt>opt_expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>Expected next call,
+     if any.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l534">code &raquo;</a><span class="member"><a name="$throwException">$throwException</a> <span class="args">( comment, opt_message )</span></span></div><p>Throws an exception and records that an exception was thrown.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>comment: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A short comment about the exception.<dt>opt_message: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A longer message about the exception.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>JsUnitException object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l420">code &raquo;</a><span class="member"><a name="$throws">$throws</a> <span class="args">( val )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a value for the currently pending expectation to throw.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The value to throw.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l499">code &raquo;</a><span class="member"><a name="$times">$times</a> <span class="args">( times )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies the number of times the expectation should be called.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>times: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of times this method will be called.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l570">code &raquo;</a><span class="member"><a name="$verify">$verify</a> <span class="args">( )</span></span></div><p>Verify that all of the expectations were met. Should be overridden by
+ subclasses.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l584">code &raquo;</a><span class="member"><a name="$verifyCall">$verifyCall</a> <span class="args">( expectation, name, args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Verifies that a method call matches an expectation.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation to check.<dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the called method.<dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments passed to the mock.</dl><tr><th>Returns<tr><td><dl>Whether the call matches the expectation.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l248">code &raquo;</a><span class="member"><a name="$argumentListVerifiers_">$argumentListVerifiers_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of argument name to optional argument list verifier function.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l266">code &raquo;</a><span class="member"><a name="$pendingExpectation">$pendingExpectation</a> : <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code></span></div><p>The expectation currently being created. All methods that modify the
+ current expectation return the Mock object for easy chaining, so this is
+ where we keep track of the expectation that's currently being modified.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l241">code &raquo;</a><span class="member"><a name="$proxy">$proxy</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>A proxy for the mock.  This can be used for dependency injection in lieu of
+ the mock if the test requires a strict instanceof check.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l256">code &raquo;</a><span class="member"><a name="$recording_">$recording_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether or not we are in recording mode.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l274">code &raquo;</a><span class="member"><a name="$threwException_">$threwException_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>First exception thrown by this mock; used in $verify.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l204">code &raquo;</a><span class="member"><a name="goog.testing.Mock.LOOSE">goog.testing.Mock.LOOSE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Option that may be passed when constructing function, method, and
+ constructor mocks. Indicates that the expected calls should be accepted in
+ any order.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l225">code &raquo;</a><span class="member"><a name="goog.testing.Mock.PROTOTYPE_FIELDS_">goog.testing.Mock.PROTOTYPE_FIELDS_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>This array contains the name of the functions that are part of the base
+ Object prototype.
+ Basically a copy of goog.object.PROTOTYPE_FIELDS_.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l214">code &raquo;</a><span class="member"><a name="goog.testing.Mock.STRICT">goog.testing.Mock.STRICT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Option that may be passed when constructing function, method, and
+ constructor mocks. Indicates that the expected calls should be accepted in
+ the recorded order only.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_MockClock.html b/docs/class_goog_testing_MockClock.html
new file mode 100644
index 0000000..894cd55
--- /dev/null
+++ b/docs/class_goog_testing_MockClock.html
@@ -0,0 +1,66 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.MockClock</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.MockClock</h1><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l59">code &raquo;</a><pre><code><a href="class_goog_Disposable.html">goog.Disposable</a>
+  &#x2514; goog.testing.MockClock</code></pre><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_disposable_IDisposable.html">goog.disposable.IDisposable</a></code></dl></header><section><p>Class for unit testing code that uses setTimeout and clearTimeout.
+
+ NOTE: If you are using MockClock to test code that makes use of
+       goog.fx.Animation, then you must either:
+
+ 1. Install and dispose of the MockClock in setUpPage() and tearDownPage()
+    respectively (rather than setUp()/tearDown()).
+
+ or
+
+ 2. Ensure that every test clears the animation queue by calling
+    mockClock.tick(x) at the end of each test function (where `x` is large
+    enough to complete all animations).
+
+ Otherwise, if any animation is left pending at the time that
+ MockClock.dispose() is called, that will permanently prevent any future
+ animations from playing on the page.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.MockClock <span class="args">( opt_autoInstall )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_autoInstall: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Install the MockClock at construction time.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.testing.MockClock</code></h3><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l546">code &raquo;</a><span class="member"><a name="cancelRequestAnimationFrame_">cancelRequestAnimationFrame_</a> <span class="args">( timeoutKey )</span></span></div><p>Clears a requestAnimationFrame.
+ Mock implementation for cancelRequestAnimationFrame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>timeoutKey: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The requestAnimationFrame key to clear.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l535">code &raquo;</a><span class="member"><a name="clearInterval_">clearInterval_</a> <span class="args">( timeoutKey )</span></span></div><p>Clears an interval.
+ Mock implementation for clearInterval.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>timeoutKey: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The interval key to clear.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l508">code &raquo;</a><span class="member"><a name="clearTimeout_">clearTimeout_</a> <span class="args">( timeoutKey )</span></span></div><p>Clears a timeout.
+ Mock implementation for clearTimeout.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>timeoutKey: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The timeout key to clear.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l228">code &raquo;</a><span class="member"><a name="disposeInternal">disposeInternal</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l255">code &raquo;</a><span class="member"><a name="fireResetEvent">fireResetEvent</a> <span class="args">( )</span></span></div><p>Signals that the mock clock has been reset, allowing objects that
+ maintain their own internal state to reset.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l309">code &raquo;</a><span class="member"><a name="getCurrentTime">getCurrentTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The MockClock's current time in milliseconds.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l275">code &raquo;</a><span class="member"><a name="getTimeoutDelay">getTimeoutDelay</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>delay The amount of time between when a timeout is
+     scheduled to fire and when it actually fires, in milliseconds.  May
+     be negative.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l301">code &raquo;</a><span class="member"><a name="getTimeoutsMade">getTimeoutsMade</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of timeouts that have been scheduled.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l152">code &raquo;</a><span class="member"><a name="install">install</a> <span class="args">( )</span></span></div><p>Installs the MockClock by overriding the global object's implementation of
+ setTimeout, setInterval, clearTimeout and clearInterval.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l323">code &raquo;</a><span class="member"><a name="isTimeoutSet">isTimeoutSet</a> <span class="args">( timeoutKey )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>timeoutKey: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The timeout key.</dl><tr><th>Returns<tr><td><dl>Whether the timer has been set and not cleared,
+     independent of the timeout's expiration.  In other words, the timeout
+     could have passed or could be scheduled for the future.  Either way,
+     this function returns true or false depending only on whether the
+     provided timeoutKey represents a timeout that has been set and not
+     cleared.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l182">code &raquo;</a><span class="member"><a name="replaceRequestAnimationFrame_">replaceRequestAnimationFrame_</a> <span class="args">( )</span></span></div><p>Installs the mocks for requestAnimationFrame and cancelRequestAnimationFrame.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l476">code &raquo;</a><span class="member"><a name="requestAnimationFrame_">requestAnimationFrame_</a> <span class="args">( funcToCall )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Schedules a function to be called when an animation frame is triggered.
+ Mock implementation for requestAnimationFrame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>funcToCall: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.</dl><tr><th>Returns<tr><td><dl>The number of timeouts created.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l240">code &raquo;</a><span class="member"><a name="reset">reset</a> <span class="args">( )</span></span></div><p>Resets the MockClock, removing all timeouts that are scheduled and resets
+ the fake timer count.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l334">code &raquo;</a><span class="member"><a name="runFunctionsWithinRange_">runFunctionsWithinRange_</a> <span class="args">( endTime )</span></span></div><p>Runs any function that is scheduled before a certain time.  Timeouts can
+ be made to fire early or late if timeoutDelay_ is non-0.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>endTime: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The latest time in the range, in milliseconds.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l367">code &raquo;</a><span class="member"><a name="scheduleFunction_">scheduleFunction_</a> <span class="args">( timeoutKey, funcToCall, millis, recurring )</span></span></div><p>Schedules a function to be run at a certain time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>timeoutKey: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The timeout key.<dt>funcToCall: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.<dt>millis: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of milliseconds to call it in.<dt>recurring: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether to function call should recur.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l497">code &raquo;</a><span class="member"><a name="setImmediate_">setImmediate_</a> <span class="args">( funcToCall )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Schedules a function to be called immediately after the current JS
+ execution.
+ Mock implementation for setImmediate.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>funcToCall: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.</dl><tr><th>Returns<tr><td><dl>The number of timeouts created.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l462">code &raquo;</a><span class="member"><a name="setInterval_">setInterval_</a> <span class="args">( funcToCall, millis )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Schedules a function to be called every <code >millis</code> milliseconds.
+ Mock implementation for setInterval.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>funcToCall: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.<dt>millis: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of milliseconds between calls.</dl><tr><th>Returns<tr><td><dl>The number of timeouts created.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l265">code &raquo;</a><span class="member"><a name="setTimeoutDelay">setTimeoutDelay</a> <span class="args">( delay )</span></span></div><p>Sets the amount of time between when a timeout is scheduled to fire and when
+ it actually fires.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>delay: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The delay in milliseconds.  May be negative.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l441">code &raquo;</a><span class="member"><a name="setTimeout_">setTimeout_</a> <span class="args">( funcToCall, millis )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Schedules a function to be called after <code >millis</code> milliseconds.
+ Mock implementation for setTimeout.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>funcToCall: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.<dt>millis: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of milliseconds to call it after.</dl><tr><th>Returns<tr><td><dl>The number of timeouts created.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l287">code &raquo;</a><span class="member"><a name="tick">tick</a> <span class="args">( opt_millis )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Increments the MockClock's time by a given number of milliseconds, running
+ any functions that are now overdue.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_millis: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Number of milliseconds to increment the counter.
+     If not specified, clock ticks 1 millisecond.</dl><tr><th>Returns<tr><td><dl>Current mock time in milliseconds.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l216">code &raquo;</a><span class="member"><a name="uninstall">uninstall</a> <span class="args">( )</span></span></div><p>Removes the MockClock's hooks into the global object's functions and revert
+ to their original values.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_Disposable.html">goog.Disposable</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l214">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="addOnDisposeCallback">addOnDisposeCallback</a> <span class="args">( callback, opt_scope )</span></span></div><p>Invokes a callback function when this object is disposed. Callbacks are
+ invoked in the order in which they were added.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type">function(this: T): ?</code><dd>The callback function.<dt>opt_scope: <code class="type">T=</code><dd>An optional scope to call the callback in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l175">code &raquo;</a><span class="member"><a name="dispose">dispose</a> <span class="args">( )</span> &rArr; <code class="type">void</code></span></div><p>Disposes of the object. If the object hasn't already been disposed of, calls
+ <code  class="type"><a class="unresolved-link">#disposeInternal</a></code>. Classes that extend <code >goog.Disposable</code> should
+ override <code  class="type"><a class="unresolved-link">#disposeInternal</a></code> in order to delete references to COM
+ objects, DOM nodes, and other disposable objects. Reentrant.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Nothing.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l163">code &raquo;</a><span class="member deprecation-notice"><a name="getDisposed">getDisposed</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#isDisposed</a></code> instead.</span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the object has been disposed of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l154">code &raquo;</a><span class="member"><a name="isDisposed">isDisposed</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the object has been disposed of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l202">code &raquo;</a><span class="member"><a name="registerDisposable">registerDisposable</a> <span class="args">( disposable )</span></span></div><p>Associates a disposable object with this object so that they will be disposed
+ together.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>disposable: <code class="type"><a href="interface_goog_disposable_IDisposable.html">goog.disposable.IDisposable</a></code><dd>that will be disposed when
+     this object is disposed.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.testing.MockClock</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l126">code &raquo;</a><span class="member"><a name="deletedKeys_">deletedKeys_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of deleted keys.  These keys represents keys that were deleted in a
+ clearInterval, timeoutid -> object.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l134">code &raquo;</a><span class="member"><a name="nowMillis_">nowMillis_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The current simulated time in milliseconds.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l72">code &raquo;</a><span class="member"><a name="queue_">queue_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&gt;</code></span></div><p>Reverse-order queue of timers to fire.
+
+ The last item of the queue is popped off.  Insertion happens from the
+ right.  For example, the expiration times for each element of the queue
+ might be in the order 300, 200, 200.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l117">code &raquo;</a><span class="member"><a name="replacer_">replacer_</a> : <code class="type"><a href="class_goog_testing_PropertyReplacer.html">goog.testing.PropertyReplacer</a></code></span></div><p>PropertyReplacer instance which overwrites and resets setTimeout,
+ setInterval, etc. or null if the MockClock is not installed.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l145">code &raquo;</a><span class="member"><a name="timeoutDelay_">timeoutDelay_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Additional delay between the time a timeout was set to fire, and the time
+ it actually fires.  Useful for testing workarounds for this Firefox 2 bug:
+ https://bugzilla.mozilla.org/show_bug.cgi?id=291386
+ May be negative.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l108">code &raquo;</a><span class="member"><a name="timeoutsMade_">timeoutsMade_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Count of the number of timeouts made.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_Disposable.html">goog.Disposable</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l147">code &raquo;</a><span class="member"><a name="creationStack">creationStack</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>If monitoring the goog.Disposable instances is enabled, stores the creation
+ stack trace of the Disposable instance.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l131">code &raquo;</a><span class="member"><a name="disposed_">disposed_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object has been disposed of.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l139">code &raquo;</a><span class="member"><a name="onDisposeCallbacks_">onDisposeCallbacks_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Callbacks to invoke when this object is disposed.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l399">code &raquo;</a><span class="member"><a name="goog.testing.MockClock.insert_">goog.testing.MockClock.insert_</a> <span class="args">( timeout, queue )</span></span></div><p>Inserts a timer descriptor into a descending-order queue.
+
+ Later-inserted duplicates appear at lower indices.  For example, the
+ asterisk in (5,4,*,3,2,1) would be the insertion point for 3.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>timeout: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The timeout to insert, with numerical runAtMillis
+     property.<dt>queue: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&gt;</code><dd>The queue to insert into, with each element
+     having a numerical runAtMillis property.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l430">code &raquo;</a><span class="member"><a name="goog.testing.MockClock.MAX_INT_">goog.testing.MockClock.MAX_INT_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Maximum 32-bit signed integer.
+
+ Timeouts over this time return immediately in many browsers, due to integer
+ overflow.  Such known browsers include Firefox, Chrome, and Safari, but not
+ IE.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l100">code &raquo;</a><span class="member"><a name="goog.testing.MockClock.REQUEST_ANIMATION_FRAME_TIMEOUT">goog.testing.MockClock.REQUEST_ANIMATION_FRAME_TIMEOUT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Default wait timeout for mocking requestAnimationFrame (in milliseconds).</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockclock.js.src.html#l59">code &raquo;</a><span class="member"><a name="goog.testing.MockClock.superClass_">goog.testing.MockClock.superClass_</a> : <code class="type"><a href="class_goog_Disposable.html">goog.Disposable.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_MockControl.html b/docs/class_goog_testing_MockControl.html
new file mode 100644
index 0000000..661a96c
--- /dev/null
+++ b/docs/class_goog_testing_MockControl.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.MockControl</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.MockControl</h1><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l44">code &raquo;</a></header><section><p>Controls a set of mocks.  Controlled mocks are replayed, verified, and
+ cleaned-up at the same time.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.MockControl <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l69">code &raquo;</a><span class="member"><a name="$replayAll">$replayAll</a> <span class="args">( )</span></span></div><p>Calls replay on each controlled mock.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l79">code &raquo;</a><span class="member"><a name="$resetAll">$resetAll</a> <span class="args">( )</span></span></div><p>Calls reset on each controlled mock.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l99">code &raquo;</a><span class="member"><a name="$tearDown">$tearDown</a> <span class="args">( )</span></span></div><p>Calls tearDown on each controlled mock, if necesssary.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l89">code &raquo;</a><span class="member"><a name="$verifyAll">$verifyAll</a> <span class="args">( )</span></span></div><p>Calls verify on each controlled mock.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l60">code &raquo;</a><span class="member"><a name="addMock">addMock</a> <span class="args">( mock )</span> &rArr; <code class="type"><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Takes control of this mock.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>mock: <code class="type"><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code><dd>Mock to be controlled.</dl><tr><th>Returns<tr><td><dl>The same mock passed in,
+     for convenience.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l198">code &raquo;</a><span class="member"><a name="createConstructorMock">createConstructorMock</a> <span class="args">( scope, constructorName, opt_strictness )</span> &rArr; <code class="type">!<a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Creates a controlled MethodMock for a constructor.  Passes its arguments
+ through to the MethodMock constructor. See
+ <code  class="type"><a href="namespace_goog_testing.html#goog.testing.createConstructorMock">goog.testing.createConstructorMock</a></code> for details.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The scope of the constructor to be mocked out.<dt>constructorName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function we're going to mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked method.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l163">code &raquo;</a><span class="member"><a name="createFunctionMock">createFunctionMock</a> <span class="args">( opt_functionName, opt_strictness )</span> &rArr; <code class="type"><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Creates a controlled FunctionMock.  Passes its arguments through to the
+ FunctionMock constructor.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The optional name of the function to mock
+     set to '[anonymous mocked function]' if not passed in.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l215">code &raquo;</a><span class="member"><a name="createGlobalFunctionMock">createGlobalFunctionMock</a> <span class="args">( functionName, opt_strictness )</span> &rArr; <code class="type"><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Creates a controlled GlobalFunctionMock.  Passes its arguments through to the
+ GlobalFunctionMock constructor.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function we're going to mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l144">code &raquo;</a><span class="member"><a name="createLooseMock">createLooseMock</a> <span class="args">( objectToMock, opt_ignoreUnexpectedCalls, opt_mockStaticMethods, opt_createProxy )</span> &rArr; <code class="type">!<a href="class_goog_testing_LooseMock.html">goog.testing.LooseMock</a></code></span></div><p>Creates a controlled LooseMock.  Passes its arguments through to the
+ LooseMock constructor.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>objectToMock: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The object that should be mocked, or
+    the constructor of an object to mock.<dt>opt_ignoreUnexpectedCalls: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to ignore unexpected
+     calls.<dt>opt_mockStaticMethods: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a mock should be constructed from the static functions of a class.<dt>opt_createProxy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a proxy for the target mock should be created.</dl><tr><th>Returns<tr><td><dl>The mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l180">code &raquo;</a><span class="member"><a name="createMethodMock">createMethodMock</a> <span class="args">( scope, functionName, opt_strictness )</span> &rArr; <code class="type">!<a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Creates a controlled MethodMock.  Passes its arguments through to the
+ MethodMock constructor.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The scope of the method to be mocked out.<dt>functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function we're going to mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked method.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l122">code &raquo;</a><span class="member"><a name="createStrictMock">createStrictMock</a> <span class="args">( objectToMock, opt_mockStaticMethods, opt_createProxy )</span> &rArr; <code class="type">!<a href="class_goog_testing_StrictMock.html">goog.testing.StrictMock</a></code></span></div><p>Creates a controlled StrictMock.  Passes its arguments through to the
+ StrictMock constructor.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>objectToMock: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The object that should be mocked, or
+    the constructor of an object to mock.<dt>opt_mockStaticMethods: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a mock should be constructed from the static functions of a class.<dt>opt_createProxy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a proxy for the target mock should be created.</dl><tr><th>Returns<tr><td><dl>The mock object.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockcontrol.js.src.html#l50">code &raquo;</a><span class="member"><a name="mocks_">mocks_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a>&gt;</code></span></div><p>The list of mocks being controlled.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_MockExpectation.html b/docs/class_goog_testing_MockExpectation.html
new file mode 100644
index 0000000..2619180
--- /dev/null
+++ b/docs/class_goog_testing_MockExpectation.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.MockExpectation</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.MockExpectation</h1><a class="source" href="source/lib/goog/testing/mock.js.src.html#l55">code &raquo;</a></header><section><p>This is a class that represents an expectation.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.MockExpectation <span class="args">( name )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the method for this expectation.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l132">code &raquo;</a><span class="member"><a name="addErrorMessage">addErrorMessage</a> <span class="args">( message )</span></span></div><p>Allow expectation failures to include messages.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The failure message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l141">code &raquo;</a><span class="member"><a name="getErrorMessage">getErrorMessage</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Get the error messages seen so far.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Error messages separated by \n.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l150">code &raquo;</a><span class="member"><a name="getErrorMessageCount">getErrorMessageCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Get how many error messages have been seen so far.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Count of error messages.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l109">code &raquo;</a><span class="member"><a name="actualCalls">actualCalls</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of times this method is called by real code.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l102">code &raquo;</a><span class="member"><a name="argumentList">argumentList</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>The arguments that are expected to be passed to this function</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l66">code &raquo;</a><span class="member"><a name="errorMessages">errorMessages</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>An array of error messages for expectations not met.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l95">code &raquo;</a><span class="member"><a name="exceptionToThrow">exceptionToThrow</a> : <code class="type">*</code></span></div><p>The value that will be thrown when the method is called</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l81">code &raquo;</a><span class="member"><a name="maxCalls">maxCalls</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The maximum number of times this method should be called.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l74">code &raquo;</a><span class="member"><a name="minCalls">minCalls</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The minimum number of times this method should be called.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l60">code &raquo;</a><span class="member"><a name="name">name</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The name of the method that is expected to be called.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l88">code &raquo;</a><span class="member"><a name="returnValue">returnValue</a> : <code class="type">*</code></span></div><p>The value that this method should return.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l125">code &raquo;</a><span class="member"><a name="toDo">toDo</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>The function which will be executed when this method is called.
+ Method arguments will be passed to this function, and return value
+ of this function will be returned by the method.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l116">code &raquo;</a><span class="member"><a name="verificationCalls">verificationCalls</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of times this method is called during the verification phase.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_ObjectPropertyString.html b/docs/class_goog_testing_ObjectPropertyString.html
new file mode 100644
index 0000000..4195cc7
--- /dev/null
+++ b/docs/class_goog_testing_ObjectPropertyString.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.ObjectPropertyString</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.ObjectPropertyString</h1><a class="source" href="source/lib/goog/testing/objectpropertystring.js.src.html#l35">code &raquo;</a></header><section><p>Object to pass a property name as a string literal and its containing object
+ when the JSCompiler is rewriting these names. This should only be used in
+ test code.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.ObjectPropertyString <span class="args">( object, propertyString )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The containing object.<dt>propertyString: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>Property name as a string literal.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/objectpropertystring.js.src.html#l58">code &raquo;</a><span class="member"><a name="getObject">getObject</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/objectpropertystring.js.src.html#l66">code &raquo;</a><span class="member"><a name="getPropertyString">getPropertyString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The property string.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/objectpropertystring.js.src.html#l45">code &raquo;</a><span class="member"><a name="object_">object_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/objectpropertystring.js.src.html#l52">code &raquo;</a><span class="member"><a name="propertyString_">propertyString_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_PropertyReplacer.html b/docs/class_goog_testing_PropertyReplacer.html
new file mode 100644
index 0000000..14dd913
--- /dev/null
+++ b/docs/class_goog_testing_PropertyReplacer.html
@@ -0,0 +1,46 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.PropertyReplacer</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.PropertyReplacer</h1><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l65">code &raquo;</a></header><section><p>Helper class for stubbing out variables and object properties for unit tests.
+ This class can change the value of some variables before running the test
+ cases, and to reset them in the tearDown phase.
+ See googletest.StubOutForTesting as an analogy in Python:
+ http://protobuf.googlecode.com/svn/trunk/python/stubout.py
+
+ Example usage:
+ <pre>var stubs = new goog.testing.PropertyReplacer();
+
+ function setUp() {
+   // Mock functions used in all test cases.
+   stubs.set(Math, 'random', function() {
+     return 4;  // Chosen by fair dice roll. Guaranteed to be random.
+   });
+ }
+
+ function tearDown() {
+   stubs.reset();
+ }
+
+ function testThreeDice() {
+   // Mock a constant used only in this test case.
+   stubs.set(goog.global, 'DICE_COUNT', 3);
+   assertEquals(12, rollAllDice());
+ }</pre>
+
+ Constraints on altered objects:
+ <ul>
+   <li>DOM subclasses aren't supported.
+   <li>The value of the objects' constructor property must either be equal to
+       the real constructor or kept untouched.
+ </ul><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.PropertyReplacer <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l224">code &raquo;</a><span class="member"><a name="remove">remove</a> <span class="args">( obj, key )</span></span></div><p>Deletes the key from the object while saving its original value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The JavaScript or native object or function to
+     alter. See the constraints in the class description.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to delete.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l183">code &raquo;</a><span class="member"><a name="replace">replace</a> <span class="args">( obj, key, value )</span></span></div><p>Changes an existing value in an object to another one of the same type while
+ saving its original state. The advantage of <code >replace</code> over <code  class="type"><a class="unresolved-link">#set</a></code>
+ is that <code >replace</code> protects against typos and erroneously passing tests
+ after some members have been renamed during a refactoring.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The JavaScript or native object or function to
+     alter. See the constraints in the class description.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to change the value for. It has to be present
+     either in <code >obj</code> or in its prototype chain.<dt>value: <code class="type">*</code><dd>The new value to set. It has to have the same type as the
+     original value. The types are compared with <code  class="type"><a href="namespace_goog.html#goog.typeOf">goog.typeOf</a></code>.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>In case of missing key or type mismatch.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l235">code &raquo;</a><span class="member"><a name="reset">reset</a> <span class="args">( )</span></span></div><p>Resets all changes made by goog.testing.PropertyReplacer.prototype.set.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l162">code &raquo;</a><span class="member"><a name="set">set</a> <span class="args">( obj, key, value )</span></span></div><p>Adds or changes a value in an object while saving its original state.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The JavaScript or native object or function to
+     alter. See the constraints in the class description.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to change the value for.<dt>value: <code class="type">*</code><dd>The new value to set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l201">code &raquo;</a><span class="member"><a name="setPath">setPath</a> <span class="args">( path, value )</span></span></div><p>Builds an object structure for the provided namespace path.  Doesn't
+ overwrite those prefixes of the path that are already objects or functions.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The path to create or alter, e.g. 'goog.ui.Menu'.<dt>value: <code class="type">*</code><dd>The value to set.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l74">code &raquo;</a><span class="member"><a name="original_">original_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&gt;</code></span></div><p>Stores the values changed by the set() method in chronological order.
+ Its items are objects with 3 fields: 'object', 'key', 'value'. The
+ original value for the given key in the given object is stored under the
+ 'value' key.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l134">code &raquo;</a><span class="member"><a name="goog.testing.PropertyReplacer.deleteKey_">goog.testing.PropertyReplacer.deleteKey_</a> <span class="args">( obj, key )</span></span></div><p>Deletes a key from an object. Sets it to undefined or empty string if the
+ delete failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The object or function to delete a key from.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to delete.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l94">code &raquo;</a><span class="member"><a name="goog.testing.PropertyReplacer.hasKey_">goog.testing.PropertyReplacer.hasKey_</a> <span class="args">( obj, key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tells if the given key exists in the object. Ignores inherited fields.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The JavaScript or native object or function
+     whose key is to be checked.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to check.</dl><tr><th>Returns<tr><td><dl>Whether the object has the key as own key.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/propertyreplacer.js.src.html#l83">code &raquo;</a><span class="member"><a name="goog.testing.PropertyReplacer.NO_SUCH_KEY_">goog.testing.PropertyReplacer.NO_SUCH_KEY_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Indicates that a key didn't exist before having been set by the set() method.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_StrictMock.html b/docs/class_goog_testing_StrictMock.html
new file mode 100644
index 0000000..aae2814
--- /dev/null
+++ b/docs/class_goog_testing_StrictMock.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.StrictMock</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.StrictMock</h1><a class="source" href="source/lib/goog/testing/strictmock.js.src.html#l42">code &raquo;</a><pre><code><a href="class_goog_testing_Mock.html">goog.testing.Mock</a>
+  &#x2514; goog.testing.StrictMock</code></pre><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></dl></header><section><p>This is a mock that verifies that methods are called in the order that they
+ are specified during the recording phase. Since it verifies order, it
+ follows 'fail fast' semantics. If it detects a deviation from the
+ expectations, it will throw an exception and not wait for verify to be
+ called.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.StrictMock <span class="args">( objectToMock, opt_mockStaticMethods, opt_createProxy )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>objectToMock: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The object that should be mocked, or
+    the constructor of an object to mock.<dt>opt_mockStaticMethods: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a mock should be constructed from the static functions of a class.<dt>opt_createProxy: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>An optional argument denoting that
+     a proxy for the target mock should be created.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.testing.StrictMock</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/strictmock.js.src.html#l64">code &raquo;</a><span class="member"><a name="$recordCall">$recordCall</a> <span class="args">( name, args )</span> &rArr; <code class="type">*</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name<dt>args</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/strictmock.js.src.html#l58">code &raquo;</a><span class="member"><a name="$recordExpectation">$recordExpectation</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/strictmock.js.src.html#l105">code &raquo;</a><span class="member"><a name="$reset">$reset</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/strictmock.js.src.html#l113">code &raquo;</a><span class="member"><a name="$verify">$verify</a> <span class="args">( )</span></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l487">code &raquo;</a><span class="member"><a name="$anyTimes">$anyTimes</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called any number of times.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l603">code &raquo;</a><span class="member"><a name="$argumentsAsString">$argumentsAsString</a> <span class="args">( args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Render the provided argument array to a string to help
+ clients with debugging tests.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments passed to the mock.</dl><tr><th>Returns<tr><td><dl>Human-readable string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l455">code &raquo;</a><span class="member"><a name="$atLeastOnce">$atLeastOnce</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called any number of times, as long as it's
+ called once.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l443">code &raquo;</a><span class="member"><a name="$atMostOnce">$atMostOnce</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called 0 or 1 times.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l394">code &raquo;</a><span class="member"><a name="$do">$do</a> <span class="args">( expectation, args )</span> &rArr; <code class="type">*</code></span></div><p>If this expectation defines a function to be called,
+ it will be called and its result will be returned.
+ Otherwise, if the expectation expects to throw, it will throw.
+ Otherwise, this method will return defined value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation.<dt>args: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments to the method.</dl><tr><th>Returns<tr><td><dl>The return value expected by the mock.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l433">code &raquo;</a><span class="member"><a name="$does">$does</a> <span class="args">( func )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a function to call for currently pending expectation.
+ Note, that using this method overrides declarations made
+ using $returns() and $throws() methods.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>func: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l282">code &raquo;</a><span class="member"><a name="$initializeFunctions_">$initializeFunctions_</a> <span class="args">( objectToMock )</span></span></div><p>Initializes the functions on the mock object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>objectToMock: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object being mocked.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l378">code &raquo;</a><span class="member"><a name="$maybeThrow">$maybeThrow</a> <span class="args">( expectation )</span></span></div><p>If the expectation expects to throw, this method will throw.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l333">code &raquo;</a><span class="member"><a name="$mockMethod">$mockMethod</a> <span class="args">( name )</span> &rArr; <code class="type">*</code></span></div><p>The function that replaces all methods on the mock object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the method being mocked.</dl><tr><th>Returns<tr><td><dl>In record mode, returns the mock object. In replay mode, returns
+    whatever the creator of the mock set as the return value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l476">code &raquo;</a><span class="member"><a name="$never">$never</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Disallows the expectation from being called.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l465">code &raquo;</a><span class="member"><a name="$once">$once</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Allows the expectation to be called exactly once.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l545">code &raquo;</a><span class="member"><a name="$recordAndThrow">$recordAndThrow</a> <span class="args">( ex )</span></span></div><p>Throws an exception and records that an exception was thrown.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Exception.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>#ex.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l320">code &raquo;</a><span class="member"><a name="$registerArgumentListVerifier">$registerArgumentListVerifier</a> <span class="args">( methodName, fn )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Registers a verfifier function to use when verifying method argument lists.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>methodName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the method for which the verifierFn
+     should be used.<dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Argument list verifier function.  Should take 2 argument
+     arrays as arguments, and return true if they are considered equivalent.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l510">code &raquo;</a><span class="member"><a name="$replay">$replay</a> <span class="args">( )</span></span></div><p>Switches from recording to replay mode.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l409">code &raquo;</a><span class="member"><a name="$returns">$returns</a> <span class="args">( val )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a return value for the currently pending expectation.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The return value.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l623">code &raquo;</a><span class="member"><a name="$throwCallException">$throwCallException</a> <span class="args">( name, args, opt_expectation )</span></span></div><p>Throw an exception based on an incorrect method call.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Name of method called.<dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Arguments passed to the mock.<dt>opt_expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>Expected next call,
+     if any.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l534">code &raquo;</a><span class="member"><a name="$throwException">$throwException</a> <span class="args">( comment, opt_message )</span></span></div><p>Throws an exception and records that an exception was thrown.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>comment: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A short comment about the exception.<dt>opt_message: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A longer message about the exception.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>JsUnitException object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l420">code &raquo;</a><span class="member"><a name="$throws">$throws</a> <span class="args">( val )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies a value for the currently pending expectation to throw.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The value to throw.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l499">code &raquo;</a><span class="member"><a name="$times">$times</a> <span class="args">( times )</span> &rArr; <code class="type">!<a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></span></div><p>Specifies the number of times the expectation should be called.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>times: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of times this method will be called.</dl><tr><th>Returns<tr><td><dl>This mock object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l584">code &raquo;</a><span class="member"><a name="$verifyCall">$verifyCall</a> <span class="args">( expectation, name, args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Verifies that a method call matches an expectation.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectation: <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code><dd>The expectation to check.<dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the called method.<dt>args: <code class="type">?<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The arguments passed to the mock.</dl><tr><th>Returns<tr><td><dl>Whether the call matches the expectation.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.testing.StrictMock</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/strictmock.js.src.html#l52">code &raquo;</a><span class="member"><a name="$expectations_">$expectations_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>&gt;</code></span></div><p>An array of MockExpectations.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_Mock.html">goog.testing.Mock</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l248">code &raquo;</a><span class="member"><a name="$argumentListVerifiers_">$argumentListVerifiers_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of argument name to optional argument list verifier function.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l266">code &raquo;</a><span class="member"><a name="$pendingExpectation">$pendingExpectation</a> : <code class="type"><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a></code></span></div><p>The expectation currently being created. All methods that modify the
+ current expectation return the Mock object for easy chaining, so this is
+ where we keep track of the expectation that's currently being modified.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l241">code &raquo;</a><span class="member"><a name="$proxy">$proxy</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>A proxy for the mock.  This can be used for dependency injection in lieu of
+ the mock if the test requires a strict instanceof check.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l256">code &raquo;</a><span class="member"><a name="$recording_">$recording_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether or not we are in recording mode.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mock.js.src.html#l274">code &raquo;</a><span class="member"><a name="$threwException_">$threwException_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>First exception thrown by this mock; used in $verify.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/strictmock.js.src.html#l42">code &raquo;</a><span class="member"><a name="goog.testing.StrictMock.superClass_">goog.testing.StrictMock.superClass_</a> : <code class="type"><a href="class_goog_testing_Mock.html">goog.testing.Mock.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_TestCase.html b/docs/class_goog_testing_TestCase.html
new file mode 100644
index 0000000..cd35ab8
--- /dev/null
+++ b/docs/class_goog_testing_TestCase.html
@@ -0,0 +1,85 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.TestCase</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.TestCase</h1><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l57">code &raquo;</a></header><section><p>A class representing a JsUnit test case.  A TestCase is made up of a number
+ of test functions which can be run.  Individual test cases can override the
+ following functions to set up their test environment:
+   - runTests - completely override the test's runner
+   - setUpPage - called before any of the test functions are run
+   - tearDownPage - called after all tests are finished
+   - setUp - called before each of the test functions
+   - tearDown - called after each of the test functions
+   - shouldRunTests - called before a test run, all tests are skipped if it
+                      returns false.  Can be used to disable tests on browsers
+                      where they aren't expected to pass.
+
+ Use <code  class="type"><a class="unresolved-link">#autoDiscoverLifecycle</a></code> and <code  class="type"><a class="unresolved-link">#autoDiscoverTests</a></code><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.TestCase <span class="args">( opt_name )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The name of the test case, defaults to
+     'Untitled Test Case'.</dl></table></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_testing_TestCase_Error.html">goog.testing.TestCase.Error</a><dd>A class representing an error thrown by the test<dt><a href="class_goog_testing_TestCase_Result.html">goog.testing.TestCase.Result</a><dd>A class for representing test results.<dt><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a><dd>A class representing a single test function.<dt><a href="class_Date.html">goog.testing.TestCase.protectedDate_</a><dd>No Description.</dl></table></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_testing_TestCase_Order.html">goog.testing.TestCase.Order</a><dd>The order to run the auto-discovered tests.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l289">code &raquo;</a><span class="member"><a name="add">add</a> <span class="args">( test )</span></span></div><p>Adds a new test to the test case.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l310">code &raquo;</a><span class="member"><a name="addNewTest">addNewTest</a> <span class="args">( name, ref, opt_scope )</span></span></div><p>Creates and adds a new test.
+
+ Convenience function to make syntax less awkward when not using automatic
+ test discovery.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The test name.<dt>ref: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Reference to the test function.<dt>opt_scope: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Optional scope that the test function should be
+     called in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l751">code &raquo;</a><span class="member"><a name="autoDiscoverLifecycle">autoDiscoverLifecycle</a> <span class="args">( )</span></span></div><p>Adds any functions defined in the global scope that correspond to
+ lifecycle events for the test case. Overrides setUp, tearDown, setUpPage,
+ tearDownPage and runTests if they are defined.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l777">code &raquo;</a><span class="member"><a name="autoDiscoverTests">autoDiscoverTests</a> <span class="args">( )</span></span></div><p>Adds any functions defined in the global scope that are prefixed with "test"
+ to the test case.</summary></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l933">code &raquo;</a><span class="member"><a name="clearTimeout">clearTimeout</a> <span class="args">( id )</span></span></div><p>Clears a timeout created by <code >this.timeout()</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>id: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A timeout id.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l900">code &raquo;</a><span class="member"><a name="countNumFilesLoaded_">countNumFilesLoaded_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counts the number of files that were loaded for dependencies that are
+ required to run the test.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of files loaded.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l740">code &raquo;</a><span class="member"><a name="createTestFromAutoDiscoveredFunction">createTestFromAutoDiscoveredFunction</a> <span class="args">( name, ref )</span> &rArr; <code class="type">!<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code></span></div><p>Creates a <code >goog.testing.TestCase.Test</code> from an auto-discovered
+     function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function.<dt>ref: <code class="type">function(): void</code><dd>The auto-discovered function.</dl><tr><th>Returns<tr><td><dl>The newly created test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l845">code &raquo;</a><span class="member"><a name="cycleTests">cycleTests</a> <span class="args">( )</span></span></div><p>Cycles through the tests, breaking out using a setTimeout if the execution
+ time has execeeded <code  class="type"><a class="unresolved-link">#maxRunTime</a></code>.</summary></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1018">code &raquo;</a><span class="member"><a name="doError">doError</a> <span class="args">( test, opt_e )</span></span></div><p>Handles a test that failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test that failed.<dt>opt_e: <code class="type">*=</code><dd>The exception object associated with the
+     failure or a string.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l998">code &raquo;</a><span class="member"><a name="doSuccess">doSuccess</a> <span class="args">( test )</span></span></div><p>Handles a test that passed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test that passed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l404">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( )</span></span></div><p>Executes each of the tests.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l426">code &raquo;</a><span class="member"><a name="finalize">finalize</a> <span class="args">( )</span></span></div><p>Finalizes the test case, called when the tests have finished executing.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l349">code &raquo;</a><span class="member"><a name="getActuallyRunCount">getActuallyRunCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of tests actually run in the test case, i.e. subtracting
+ any which are skipped.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of un-ignored tests.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l709">code &raquo;</a><span class="member"><a name="getAutoDiscoveryPrefix">getAutoDiscoveryPrefix</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The function name prefix used to auto-discover tests.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l718">code &raquo;</a><span class="member"><a name="getBatchTime">getBatchTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Time since the last batch of tests was started.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l339">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of tests contained in the test case.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of tests.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l648">code &raquo;</a><span class="member"><a name="getGlobals">getGlobals</a> <span class="args">( opt_prefix )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Gets list of objects that potentially contain test cases. For IE 8 and below,
+ this is the global "this" (for properties set directly on the global this or
+ window) and the RuntimeObject (for global variables and functions). For all
+ other browsers, the array simply contains the global this.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>An optional prefix. If specified, only get things
+     under this prefix. Note that the prefix is only honored in IE, since it
+     supports the RuntimeObject:
+     http://msdn.microsoft.com/en-us/library/ff521039%28VS.85%29.aspx
+     TODO: Remove this option.</dl><tr><th>Returns<tr><td><dl>A list of objects that should be inspected.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l153">code &raquo;</a><span class="member"><a name="getName">getName</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The name of the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l569">code &raquo;</a><span class="member"><a name="getNumFilesLoaded">getNumFilesLoaded</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of script files that were loaded in order to run the test.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of script files.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l528">code &raquo;</a><span class="member"><a name="getReport">getReport</a> <span class="args">( opt_verbose )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string detailing the results from the test.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_verbose: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true results will include data about all
+     tests, not just what failed.</dl><tr><th>Returns<tr><td><dl>The results from the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l560">code &raquo;</a><span class="member"><a name="getRunTime">getRunTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the amount of time it took for the test to run.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The run time, in milliseconds.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l579">code &raquo;</a><span class="member"><a name="getTestResults">getTestResults</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns the test results object: a map from test names to a list of test
+ failures (if any exist).</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Tests results object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l330">code &raquo;</a><span class="member"><a name="getTests">getTests</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code></span></div><p>Gets the tests.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The test array.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l957">code &raquo;</a><span class="member"><a name="getTimeStamp_">getTimeStamp_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the current time.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>HH:MM:SS.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l484">code &raquo;</a><span class="member"><a name="isInsideMultiTestRunner">isInsideMultiTestRunner</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test case is running inside the multi test
+     runner.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l517">code &raquo;</a><span class="member"><a name="isSuccess">isSuccess</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test was a success.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l494">code &raquo;</a><span class="member"><a name="log">log</a> <span class="args">( val )</span></span></div><p>Logs an object to the console, if available.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The value to log. Will be ToString'd.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1038">code &raquo;</a><span class="member"><a name="logError">logError</a> <span class="args">( name, opt_e )</span> &rArr; <code class="type">!<a href="class_goog_testing_TestCase_Error.html">goog.testing.TestCase.Error</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Failed test name.<dt>opt_e: <code class="type">*=</code><dd>The exception object associated with the
+     failure or a string.</dl><tr><th>Returns<tr><td><dl>Error object.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l830">code &raquo;</a><span class="member"><a name="maybeFailTestEarly">maybeFailTestEarly</a> <span class="args">( testCase )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks to see if the test should be marked as failed before it is run.
+
+ If there was an error in setUpPage, we treat that as a failure for all tests
+ and mark them all as having failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>testCase: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The current test case.</dl><tr><th>Returns<tr><td><dl>Whether the test was marked as failed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l358">code &raquo;</a><span class="member"><a name="next">next</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code></span></div><p>Returns the current test and increments the pointer.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current test case.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l945">code &raquo;</a><span class="member"><a name="now">now</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current time in milliseconds, don't use goog.now as some
+     tests override it.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l606">code &raquo;</a><span class="member"><a name="orderTests_">orderTests_</a> <span class="args">( tests )</span></span></div><p>Reorders the tests depending on the <code >order</code> field.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tests: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code><dd>An array of tests to
+     reorder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l977">code &raquo;</a><span class="member"><a name="pad_">pad_</a> <span class="args">( number )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Pads a number to make it have a leading zero if it's less than 10.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>number: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to pad.</dl><tr><th>Returns<tr><td><dl>The resulting string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l373">code &raquo;</a><span class="member"><a name="reset">reset</a> <span class="args">( )</span></span></div><p>Resets the test case pointer, so that next returns the first test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l590">code &raquo;</a><span class="member"><a name="runTests">runTests</a> <span class="args">( )</span></span></div><p>Executes each of the tests.
+ Overridable by the individual test case.  This allows test cases to defer
+ when the test is actually started.  If overridden, finalize must be called
+ by the test to indicate it has finished.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l475">code &raquo;</a><span class="member"><a name="saveMessage">saveMessage</a> <span class="args">( message )</span></span></div><p>Saves a message to the result set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The message to save.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l727">code &raquo;</a><span class="member"><a name="setBatchTime">setBatchTime</a> <span class="args">( batchTime )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>batchTime: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Time since the last batch of tests was started.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l384">code &raquo;</a><span class="member"><a name="setCompletedCallback">setCompletedCallback</a> <span class="args">( fn )</span></span></div><p>Sets the callback function that should be executed when the tests have
+ completed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The callback function.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l321">code &raquo;</a><span class="member"><a name="setTests">setTests</a> <span class="args">( tests )</span></span></div><p>Sets the tests.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tests: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code><dd>A new test array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l695">code &raquo;</a><span class="member"><a name="setUp">setUp</a> <span class="args">( )</span></span></div><p>Gets called before every goog.testing.TestCase.Test is been executed. Can be
+ overridden to add set up functionality to each test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l681">code &raquo;</a><span class="member"><a name="setUpPage">setUpPage</a> <span class="args">( )</span></span></div><p>Gets called before any tests are executed.  Can be overridden to set up the
+ environment for the whole test case.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l396">code &raquo;</a><span class="member"><a name="shouldRunTests">shouldRunTests</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Can be overridden in test classes to indicate whether the tests in a case
+ should be run in that particular situation.  For example, this could be used
+ to stop tests running in a particular browser, where browser support for
+ the class under test was absent.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether any of the tests in the case should be run.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l702">code &raquo;</a><span class="member"><a name="tearDown">tearDown</a> <span class="args">( )</span></span></div><p>Gets called after every goog.testing.TestCase.Test has been executed. Can be
+ overriden to add tear down functionality to each test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l688">code &raquo;</a><span class="member"><a name="tearDownPage">tearDownPage</a> <span class="args">( )</span></span></div><p>Gets called after all tests have been executed.  Can be overridden to tear
+ down the entire test case.</summary></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l919">code &raquo;</a><span class="member"><a name="timeout">timeout</a> <span class="args">( fn, time )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Calls a function after a delay, using the protected timeout.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.<dt>time: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Delay in milliseconds.</dl><tr><th>Returns<tr><td><dl>The timeout id.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l988">code &raquo;</a><span class="member"><a name="trimPath_">trimPath_</a> <span class="args">( path )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims a path to be only that after google3.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The path to trim.</dl><tr><th>Returns<tr><td><dl>The resulting string.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l266">code &raquo;</a><span class="member"><a name="batchTime_">batchTime_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Time since the last batch of tests was started, if batchTime exceeds
+ <code  class="type"><a class="unresolved-link">#maxRunTime</a></code> a timeout will be used to stop the tests blocking the
+ browser and a new batch will be started.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l274">code &raquo;</a><span class="member"><a name="currentTestPointer_">currentTestPointer_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Pointer to the current test.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l234">code &raquo;</a><span class="member"><a name="exceptionBeforeTest">exceptionBeforeTest</a> : <code class="type">*</code></span></div><p>Exception object that was detected before a test runs.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l63">code &raquo;</a><span class="member"><a name="name_">name_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A name for the test case.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l282">code &raquo;</a><span class="member"><a name="onCompleteCallback_">onCompleteCallback_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Optional callback that will be executed when the test has finalized.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l171">code &raquo;</a><span class="member"><a name="order">order</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The order to run the auto-discovered tests in.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l122">code &raquo;</a><span class="member"><a name="result_">result_</a> : <code class="type"><a href="class_goog_testing_TestCase_Result.html">goog.testing.TestCase.Result</a></code></span></div><p>Object used to encapsulate the test results.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l248">code &raquo;</a><span class="member"><a name="running">running</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the test case is running.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l256">code &raquo;</a><span class="member"><a name="startTime_">startTime_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Timestamp for when the test was started.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l241">code &raquo;</a><span class="member"><a name="started">started</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the test case has ever tried to execute.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l92">code &raquo;</a><span class="member"><a name="testsToRun_">testsToRun_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Set of test names and/or indices to execute, or null if all tests should
+ be executed.
+
+ Indices are included to allow automation tools to run a subset of the
+ tests without knowing the exact contents of the test file.
+
+ Indices should only be used with SORTED ordering.
+
+ Example valid values:
+ <ul>
+ <li>[testName]
+ <li>[testName1, testName2]
+ <li>[2] - will run the 3rd test in the order specified
+ <li>[1,3,5]
+ <li>[testName1, testName2, 3, 5] - will work
+ <ul></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l70">code &raquo;</a><span class="member"><a name="tests_">tests_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Array of test functions that can be executed.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l666">code &raquo;</a><span class="member"><a name="goog.testing.TestCase.getGlobals">goog.testing.TestCase.getGlobals</a> <span class="args">( opt_prefix )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Gets list of objects that potentially contain test cases. For IE 8 and below,
+ this is the global "this" (for properties set directly on the global this or
+ window) and the RuntimeObject (for global variables and functions). For all
+ other browsers, the array simply contains the global this.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>An optional prefix. If specified, only get things
+     under this prefix. Note that the prefix is only honored in IE, since it
+     supports the RuntimeObject:
+     http://msdn.microsoft.com/en-us/library/ff521039%28VS.85%29.aspx
+     TODO: Remove this option.</dl><tr><th>Returns<tr><td><dl>A list of objects that should be inspected.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1227">code &raquo;</a><span class="member"><a name="goog.testing.TestCase.initializeTestRunner">goog.testing.TestCase.initializeTestRunner</a> <span class="args">( testCase )</span></span></div><p>Initializes the given test case with the global test runner 'G_testRunner'.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>testCase: <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code><dd>The test case to install.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l189">code &raquo;</a><span class="member"><a name="goog.testing.TestCase.protectedClearTimeout_">goog.testing.TestCase.protectedClearTimeout_</a> <span class="args">( )</span></span></div><p>Save a reference to <code >window.clearTimeout</code>, so any code that overrides
+ the default behavior (e.g. MockClock) doesn't affect our runner.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l180">code &raquo;</a><span class="member"><a name="goog.testing.TestCase.protectedSetTimeout_">goog.testing.TestCase.protectedSetTimeout_</a> <span class="args">( )</span> &rArr; <code class="type">number</code></span></div><p>Save a reference to <code >window.setTimeout</code>, so any code that overrides the
+ default behavior (the MockClock, for example) doesn't affect our runner.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l224">code &raquo;</a><span class="member"><a name="goog.testing.TestCase.IS_IE">goog.testing.TestCase.IS_IE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Avoid a dependency on goog.userAgent and keep our own reference of whether
+ the browser is IE.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l216">code &raquo;</a><span class="member"><a name="goog.testing.TestCase.currentTestName">goog.testing.TestCase.currentTestName</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>TODO(user) replace this with prototype.currentTest.
+ Name of the current test that is running, or null if none is running.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l164">code &raquo;</a><span class="member"><a name="goog.testing.TestCase.maxRunTime">goog.testing.TestCase.maxRunTime</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The maximum amount of time that the test can run before we force it to be
+ async.  This prevents the test runner from blocking the browser and
+ potentially hurting the Selenium test harness.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l208">code &raquo;</a><span class="member"><a name="goog.testing.TestCase.setTimeoutAsString_">goog.testing.TestCase.setTimeoutAsString_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Saved string referencing goog.global.setTimeout's string serialization.  IE
+ sometimes fails to uphold equality for setTimeout, but the string version
+ stays the same.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_TestCase_Error.html b/docs/class_goog_testing_TestCase_Error.html
new file mode 100644
index 0000000..dbe77b2
--- /dev/null
+++ b/docs/class_goog_testing_TestCase_Error.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.TestCase.Error</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.TestCase.Error</h1><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1248">code &raquo;</a></header><section><p>A class representing an error thrown by the test<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.TestCase.Error <span class="args">( source, message, opt_stack )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>source: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the test which threw the error.<dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The error message.<dt>opt_stack: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A string showing the execution stack.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1274">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string representing the error object.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A string representation of the error.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1259">code &raquo;</a><span class="member"><a name="message">message</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Reference to the test function.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1253">code &raquo;</a><span class="member"><a name="source">source</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The name of the test which threw the error.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1265">code &raquo;</a><span class="member"><a name="stack">stack</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Scope that the test function should be called in.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_TestCase_Result.html b/docs/class_goog_testing_TestCase_Result.html
new file mode 100644
index 0000000..094cf67
--- /dev/null
+++ b/docs/class_goog_testing_TestCase_Result.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.TestCase.Result</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.TestCase.Result</h1><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1113">code &raquo;</a></header><section><p>A class for representing test results.  A bag of public properties.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.TestCase.Result <span class="args">( testCase )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>testCase: <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code><dd>The test case that owns this result.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1198">code &raquo;</a><span class="member"><a name="getSummary">getSummary</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A summary of the tests, including total number of tests that
+     passed, failed, and the time taken.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1189">code &raquo;</a><span class="member"><a name="isSuccess">isSuccess</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test was successful.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1182">code &raquo;</a><span class="member"><a name="complete">complete</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the tests have completed.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1170">code &raquo;</a><span class="member"><a name="errors">errors</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Error.html">goog.testing.TestCase.Error</a>&gt;</code></span></div><p>Errors encountered while running the test.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1176">code &raquo;</a><span class="member"><a name="messages">messages</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Messages to show the user after running the test.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1149">code &raquo;</a><span class="member"><a name="numFilesLoaded">numFilesLoaded</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of files loaded to run this test.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1164">code &raquo;</a><span class="member"><a name="resultsByName">resultsByName</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Test results for each test that was run. The test name is always added
+ as the key in the map, and the array of strings is an optional list
+ of failure messages. If the array is empty, the test passed. Otherwise,
+ the test failed.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1131">code &raquo;</a><span class="member"><a name="runCount">runCount</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Total number of tests that were actually run.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1143">code &raquo;</a><span class="member"><a name="runTime">runTime</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The amount of time the tests took to run.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1137">code &raquo;</a><span class="member"><a name="successCount">successCount</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Number of successful tests.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1119">code &raquo;</a><span class="member"><a name="testCase_">testCase_</a> : <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code></span></div><p>The test case that owns this result.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1155">code &raquo;</a><span class="member"><a name="testSuppressed">testSuppressed</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether this test case was suppressed by shouldRunTests() returning false.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1125">code &raquo;</a><span class="member"><a name="totalCount">totalCount</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Total number of tests that should have been run.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_TestCase_Test.html b/docs/class_goog_testing_TestCase_Test.html
new file mode 100644
index 0000000..16aac26
--- /dev/null
+++ b/docs/class_goog_testing_TestCase_Test.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.TestCase.Test</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.TestCase.Test</h1><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1077">code &raquo;</a></header><section><p>A class representing a single test function.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.TestCase.Test <span class="args">( name, ref, opt_scope )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The test name.<dt>ref: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Reference to the test function.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Optional scope that the test function should be
+     called in.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1101">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( )</span></span></div><p>Executes the test function.</summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1082">code &raquo;</a><span class="member"><a name="name">name</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The name of the test.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1088">code &raquo;</a><span class="member"><a name="ref">ref</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Reference to the test function.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1094">code &raquo;</a><span class="member"><a name="scope">scope</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Scope that the test function should be called in.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_TestCase_protectedDate_.html b/docs/class_goog_testing_TestCase_protectedDate_.html
new file mode 100644
index 0000000..3087ec2
--- /dev/null
+++ b/docs/class_goog_testing_TestCase_protectedDate_.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.TestCase.protectedDate_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.TestCase.protectedDate_</h1><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l198">code &raquo;</a></header><section><p>Save a reference to <code >window.Date</code>, so any code that overrides
+ the default behavior doesn't affect our runner.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">goog.testing.TestCase.protectedDate_ <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1161">code &raquo;</a><span class="member"><a name="getDate">getDate</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1168">code &raquo;</a><span class="member"><a name="getDay">getDay</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1182">code &raquo;</a><span class="member"><a name="getFullYear">getFullYear</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1196">code &raquo;</a><span class="member"><a name="getHours">getHours</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1217">code &raquo;</a><span class="member"><a name="getMilliseconds">getMilliseconds</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1203">code &raquo;</a><span class="member"><a name="getMinutes">getMinutes</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1175">code &raquo;</a><span class="member"><a name="getMonth">getMonth</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1210">code &raquo;</a><span class="member"><a name="getSeconds">getSeconds</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1224">code &raquo;</a><span class="member"><a name="getTime">getTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1231">code &raquo;</a><span class="member"><a name="getTimezoneOffset">getTimezoneOffset</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1238">code &raquo;</a><span class="member"><a name="getUTCDate">getUTCDate</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1245">code &raquo;</a><span class="member"><a name="getUTCDay">getUTCDay</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1259">code &raquo;</a><span class="member"><a name="getUTCFullYear">getUTCFullYear</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1266">code &raquo;</a><span class="member"><a name="getUTCHours">getUTCHours</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1287">code &raquo;</a><span class="member"><a name="getUTCMilliseconds">getUTCMilliseconds</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1273">code &raquo;</a><span class="member"><a name="getUTCMinutes">getUTCMinutes</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1252">code &raquo;</a><span class="member"><a name="getUTCMonth">getUTCMonth</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1280">code &raquo;</a><span class="member"><a name="getUTCSeconds">getUTCSeconds</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1189">code &raquo;</a><span class="member"><a name="getYear">getYear</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1296">code &raquo;</a><span class="member"><a name="setDate">setDate</a> <span class="args">( dayValue )</span></span></div><p>Sets the day of the month for a specified date according to local time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>dayValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1317">code &raquo;</a><span class="member"><a name="setFullYear">setFullYear</a> <span class="args">( yearValue, opt_monthValue, opt_dayValue )</span></span></div><p>Sets the full year for a specified date according to local time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>yearValue<dt>opt_monthValue<dt>opt_dayValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1340">code &raquo;</a><span class="member"><a name="setHours">setHours</a> <span class="args">( hoursValue, opt_minutesValue, opt_secondsValue, opt_msValue )</span></span></div><p>Sets the hours for a specified date according to local time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>hoursValue<dt>opt_minutesValue<dt>opt_secondsValue<dt>opt_msValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1372">code &raquo;</a><span class="member"><a name="setMilliseconds">setMilliseconds</a> <span class="args">( millisecondsValue )</span></span></div><p>Sets the milliseconds for a specified date according to local time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>millisecondsValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1352">code &raquo;</a><span class="member"><a name="setMinutes">setMinutes</a> <span class="args">( minutesValue, opt_secondsValue, opt_msValue )</span></span></div><p>Sets the minutes for a specified date according to local time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>minutesValue<dt>opt_secondsValue<dt>opt_msValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1306">code &raquo;</a><span class="member"><a name="setMonth">setMonth</a> <span class="args">( monthValue, opt_dayValue )</span></span></div><p>Set the month for a specified date according to local time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>monthValue<dt>opt_dayValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1363">code &raquo;</a><span class="member"><a name="setSeconds">setSeconds</a> <span class="args">( secondsValue, opt_msValue )</span></span></div><p>Sets the seconds for a specified date according to local time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>secondsValue<dt>opt_msValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1382">code &raquo;</a><span class="member"><a name="setTime">setTime</a> <span class="args">( timeValue )</span></span></div><p>Sets the Date object to the time represented by a number of milliseconds
+ since January 1, 1970, 00:00:00 UTC.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>timeValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1391">code &raquo;</a><span class="member"><a name="setUTCDate">setUTCDate</a> <span class="args">( dayValue )</span></span></div><p>Sets the day of the month for a specified date according to universal time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>dayValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1412">code &raquo;</a><span class="member"><a name="setUTCFullYear">setUTCFullYear</a> <span class="args">( yearValue, opt_monthValue, opt_dayValue )</span></span></div><p>Sets the full year for a specified date according to universal time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>yearValue<dt>opt_monthValue<dt>opt_dayValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1425">code &raquo;</a><span class="member"><a name="setUTCHours">setUTCHours</a> <span class="args">( hoursValue, opt_minutesValue, opt_secondsValue, opt_msValue )</span></span></div><p>Sets the hour for a specified date according to universal time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>hoursValue<dt>opt_minutesValue<dt>opt_secondsValue<dt>opt_msValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1458">code &raquo;</a><span class="member"><a name="setUTCMilliseconds">setUTCMilliseconds</a> <span class="args">( millisecondsValue )</span></span></div><p>Sets the milliseconds for a specified date according to universal time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>millisecondsValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1437">code &raquo;</a><span class="member"><a name="setUTCMinutes">setUTCMinutes</a> <span class="args">( minutesValue, opt_secondsValue, opt_msValue )</span></span></div><p>Sets the minutes for a specified date according to universal time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>minutesValue<dt>opt_secondsValue<dt>opt_msValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1401">code &raquo;</a><span class="member"><a name="setUTCMonth">setUTCMonth</a> <span class="args">( monthValue, opt_dayValue )</span></span></div><p>Sets the month for a specified date according to universal time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>monthValue<dt>opt_dayValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1449">code &raquo;</a><span class="member"><a name="setUTCSeconds">setUTCSeconds</a> <span class="args">( secondsValue, opt_msValue )</span></span></div><p>Sets the seconds for a specified date according to universal time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>secondsValue<dt>opt_msValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1328">code &raquo;</a><span class="member deprecation-notice"><a name="setYear">setYear</a> <span class="args">( yearValue )</span></span></div><p>Sets the year for a specified date according to local time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>yearValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1473">code &raquo;</a><span class="member"><a name="toDateString">toDateString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1480">code &raquo;</a><span class="member"><a name="toGMTString">toGMTString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es5.js.src.html#l226">code &raquo;</a><span class="member"><a name="toISOString">toISOString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es5.js.src.html#l234">code &raquo;</a><span class="member"><a name="toJSON">toJSON</a> <span class="args">( opt_ignoredKey )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_ignoredKey</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1503">code &raquo;</a><span class="member"><a name="toLocaleDateString">toLocaleDateString</a> <span class="args">( opt_locales, opt_options )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_locales<dt>opt_options</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1511">code &raquo;</a><span class="member"><a name="toLocaleFormat">toLocaleFormat</a> <span class="args">( formatString )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>formatString</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1519">code &raquo;</a><span class="member"><a name="toLocaleString">toLocaleString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1528">code &raquo;</a><span class="member"><a name="toLocaleTimeString">toLocaleTimeString</a> <span class="args">( opt_locales, opt_options )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_locales<dt>opt_options</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1466">code &raquo;</a><span class="member"><a name="toSource">toSource</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1536">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1487">code &raquo;</a><span class="member"><a name="toTimeString">toTimeString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1494">code &raquo;</a><span class="member"><a name="toUTCString">toUTCString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/es3.js.src.html#l1543">code &raquo;</a><span class="member"><a name="valueOf">valueOf</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_TestRunner.html b/docs/class_goog_testing_TestRunner.html
new file mode 100644
index 0000000..c3cde33
--- /dev/null
+++ b/docs/class_goog_testing_TestRunner.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.TestRunner</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.TestRunner</h1><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l49">code &raquo;</a></header><section><p>Construct a test runner.
+
+ NOTE(user): This is currently pretty weird, I'm essentially trying to
+ create a wrapper that the Selenium test can hook into to query the state of
+ the running test case, while making goog.testing.TestCase general.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.TestRunner <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l251">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( )</span></span></div><p>Executes a test case and prints the results to the window.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l243">code &raquo;</a><span class="member"><a name="getNumFilesLoaded">getNumFilesLoaded</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of script files that were loaded in order to run the test.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of script files.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l215">code &raquo;</a><span class="member"><a name="getReport">getReport</a> <span class="args">( opt_verbose )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a report of the test case that ran.
+ Used by Selenium Hooks.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_verbose: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true results will include data about all
+     tests, not just what failed.</dl><tr><th>Returns<tr><td><dl>A report summary of the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l234">code &raquo;</a><span class="member"><a name="getRunTime">getRunTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the amount of time it took for the test to run.
+ Used by Selenium Hooks.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The run time, in milliseconds.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l420">code &raquo;</a><span class="member"><a name="getTestResults">getTestResults</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A map of test names to a list of
+ test failures (if any) to provide formatted data for the test runner.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l166">code &raquo;</a><span class="member"><a name="hasErrors">hasErrors</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the test case runner has errors that were caught outside of
+ the test case.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether there were JS errors.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l100">code &raquo;</a><span class="member"><a name="initialize">initialize</a> <span class="args">( testCase )</span></span></div><p>Initializes the test runner.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>testCase: <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code><dd>The test case to initialize with.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l144">code &raquo;</a><span class="member"><a name="isFinished">isFinished</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the test runner is finished.
+ Used by Selenium Hooks.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test runner is active.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l134">code &raquo;</a><span class="member"><a name="isInitialized">isInitialized</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the test runner is initialized.
+ Used by Selenium Hooks.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test runner is active.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l124">code &raquo;</a><span class="member"><a name="isStrict">isStrict</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test runner should fail on an empty
+     test case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l156">code &raquo;</a><span class="member"><a name="isSuccess">isSuccess</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the test case didn't fail.
+ Used by Selenium Hooks.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the current test returned successfully.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l407">code &raquo;</a><span class="member"><a name="log">log</a> <span class="args">( s )</span></span></div><p>Logs a message to the current test case.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The text to output to the log.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l176">code &raquo;</a><span class="member"><a name="logError">logError</a> <span class="args">( msg )</span></span></div><p>Logs an error that occurred.  Used in the case of environment setting up
+ an onerror handler.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Error message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l187">code &raquo;</a><span class="member"><a name="logTestFailure">logTestFailure</a> <span class="args">( ex )</span></span></div><p>Log failure in current running test.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ex: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>Exception.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l275">code &raquo;</a><span class="member"><a name="onComplete_">onComplete_</a> <span class="args">( )</span></span></div><p>Writes the results to the document when the test case completes.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l203">code &raquo;</a><span class="member"><a name="setErrorFilter">setErrorFilter</a> <span class="args">( fn )</span></span></div><p>Sets a function to use as a filter for errors.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>Filter function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l115">code &raquo;</a><span class="member"><a name="setStrict">setStrict</a> <span class="args">( strict )</span></span></div><p>By default, the test runner is strict, and fails if it runs an empty
+ test case.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>strict: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether the test runner should fail on an empty
+     test case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l312">code &raquo;</a><span class="member"><a name="writeLog">writeLog</a> <span class="args">( log )</span></span></div><p>Writes a nicely formatted log out to the document.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>log: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to write.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l85">code &raquo;</a><span class="member"><a name="errorFilter_">errorFilter_</a> : <code class="type">?(function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>))</code></span></div><p>Function to use when filtering errors.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l54">code &raquo;</a><span class="member"><a name="errors">errors</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Errors that occurred in the window.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l69">code &raquo;</a><span class="member"><a name="initialized">initialized</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the test runner has been initialized yet.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l77">code &raquo;</a><span class="member"><a name="logEl_">logEl_</a> : <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Element created in the document to add test results to.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l93">code &raquo;</a><span class="member"><a name="strict_">strict_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether an empty test case counts as an error.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testrunner.js.src.html#l62">code &raquo;</a><span class="member"><a name="testCase">testCase</a> : <code class="type">?<a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code></span></div><p>Reference to the active test case.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_events_Event.html b/docs/class_goog_testing_events_Event.html
new file mode 100644
index 0000000..4c0df8e
--- /dev/null
+++ b/docs/class_goog_testing_events_Event.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.events.Event</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.events.Event</h1><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l65">code &raquo;</a><pre><code>Event
+  &#x2514; goog.testing.events.Event</code></pre></header><section><p>goog.events.BrowserEvent expects an Event so we provide one for JSCompiler.
+
+ This clones a lot of the functionality of goog.events.Event. This used to
+ use a mixin, but the mixin results in confusing the two types when compiled.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.events.Event <span class="args">( type, opt_target )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Event Type.<dt>opt_target: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Reference to the object that is the target of
+     this event.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.testing.events.Event</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l105">code &raquo;</a><span class="member"><a name="preventDefault">preventDefault</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l99">code &raquo;</a><span class="member"><a name="stopPropagation">stopPropagation</a> <span class="args">( )</span></span></div></summary></details></div></div><h3>Defined in <code class="type">Event</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/w3c_event.js.src.html#l129">code &raquo;</a><span class="member"><a name="initEvent">initEvent</a> <span class="args">( eventTypeArg, canBubbleArg, cancelableArg )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>eventTypeArg<dt>canBubbleArg<dt>cancelableArg</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/../../../../externs.zip/w3c_event3.js.src.html#l63">code &raquo;</a><span class="member"><a name="stopImmediatePropagation">stopImmediatePropagation</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a></code></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.testing.events.Event</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l81">code &raquo;</a><span class="member"><a name="propagationStopped_">propagationStopped_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether to cancel the event in internal capture/bubble processing for IE.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l95">code &raquo;</a><span class="member"><a name="returnValue_">returnValue_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Return value for in internal capture/bubble processing for IE.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_mockmatchers_ArgumentMatcher.html b/docs/class_goog_testing_mockmatchers_ArgumentMatcher.html
new file mode 100644
index 0000000..ffc68fd
--- /dev/null
+++ b/docs/class_goog_testing_mockmatchers_ArgumentMatcher.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.mockmatchers.ArgumentMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.mockmatchers.ArgumentMatcher</h1><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l50">code &raquo;</a></header><section><p>A simple interface for executing argument matching.  A match in this case is
+ testing to see if a supplied object fits a given criteria.  True is returned
+ if the given criteria is met.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.mockmatchers.ArgumentMatcher <span class="args">( opt_matchFn, opt_matchName )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_matchFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>A function that evaluates a given argument
+     and returns true if it meets a given criteria.<dt>opt_matchName: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The name expressing intent as part of
+      an error message for when a match fails.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l78">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( toVerify, opt_expectation )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>A function that takes a match argument and an optional MockExpectation
+ which (if provided) will get error information and returns whether or
+ not it matches.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>toVerify: <code class="type">*</code><dd>The argument that should be verified.<dt>opt_expectation: <code class="type">?<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>The expectation
+     for this match.</dl><tr><th>Returns<tr><td><dl>Whether or not a given argument passes verification.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l58">code &raquo;</a><span class="member"><a name="matchFn_">matchFn_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A function that evaluates a given argument and returns true if it meets a
+ given criteria.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l65">code &raquo;</a><span class="member"><a name="matchName_">matchName_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A string indicating the match intent (e.g. isBoolean or isString).</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_mockmatchers_IgnoreArgument.html b/docs/class_goog_testing_mockmatchers_IgnoreArgument.html
new file mode 100644
index 0000000..4d325c4
--- /dev/null
+++ b/docs/class_goog_testing_mockmatchers_IgnoreArgument.html
@@ -0,0 +1,8 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.mockmatchers.IgnoreArgument</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.mockmatchers.IgnoreArgument</h1><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l166">code &raquo;</a><pre><code><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a>
+  &#x2514; goog.testing.mockmatchers.IgnoreArgument</code></pre></header><section><p>A matcher that always returns true. It is useful when the user does not care
+ for some arguments.
+ For example: mockFunction('username', 'password', IgnoreArgument);<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.mockmatchers.IgnoreArgument <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l78">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( toVerify, opt_expectation )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>A function that takes a match argument and an optional MockExpectation
+ which (if provided) will get error information and returns whether or
+ not it matches.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>toVerify: <code class="type">*</code><dd>The argument that should be verified.<dt>opt_expectation: <code class="type">?<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>The expectation
+     for this match.</dl><tr><th>Returns<tr><td><dl>Whether or not a given argument passes verification.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l58">code &raquo;</a><span class="member"><a name="matchFn_">matchFn_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A function that evaluates a given argument and returns true if it meets a
+ given criteria.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l65">code &raquo;</a><span class="member"><a name="matchName_">matchName_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A string indicating the match intent (e.g. isBoolean or isString).</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l166">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.IgnoreArgument.superClass_">goog.testing.mockmatchers.IgnoreArgument.superClass_</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_mockmatchers_InstanceOf.html b/docs/class_goog_testing_mockmatchers_InstanceOf.html
new file mode 100644
index 0000000..a5f073b
--- /dev/null
+++ b/docs/class_goog_testing_mockmatchers_InstanceOf.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.mockmatchers.InstanceOf</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.mockmatchers.InstanceOf</h1><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l107">code &raquo;</a><pre><code><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a>
+  &#x2514; goog.testing.mockmatchers.InstanceOf</code></pre></header><section><p>A matcher that verifies that an argument is an instance of a given class.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.mockmatchers.InstanceOf <span class="args">( ctor )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ctor: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The class that will be used for verification.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l78">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( toVerify, opt_expectation )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>A function that takes a match argument and an optional MockExpectation
+ which (if provided) will get error information and returns whether or
+ not it matches.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>toVerify: <code class="type">*</code><dd>The argument that should be verified.<dt>opt_expectation: <code class="type">?<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>The expectation
+     for this match.</dl><tr><th>Returns<tr><td><dl>Whether or not a given argument passes verification.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l58">code &raquo;</a><span class="member"><a name="matchFn_">matchFn_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A function that evaluates a given argument and returns true if it meets a
+ given criteria.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l65">code &raquo;</a><span class="member"><a name="matchName_">matchName_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A string indicating the match intent (e.g. isBoolean or isString).</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l107">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.InstanceOf.superClass_">goog.testing.mockmatchers.InstanceOf.superClass_</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_mockmatchers_ObjectEquals.html b/docs/class_goog_testing_mockmatchers_ObjectEquals.html
new file mode 100644
index 0000000..967af04
--- /dev/null
+++ b/docs/class_goog_testing_mockmatchers_ObjectEquals.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.mockmatchers.ObjectEquals</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.mockmatchers.ObjectEquals</h1><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l185">code &raquo;</a><pre><code><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a>
+  &#x2514; goog.testing.mockmatchers.ObjectEquals</code></pre></header><section><p>A matcher that verifies that the argument is an object that equals the given
+ expected object, using a deep comparison.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.mockmatchers.ObjectEquals <span class="args">( expectedObject )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectedObject: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>An object to match against when
+     verifying the argument.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.testing.mockmatchers.ObjectEquals</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l198">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( toVerify, opt_expectation )</span> &rArr; <code class="type">boolean</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>toVerify<dt>opt_expectation</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l58">code &raquo;</a><span class="member"><a name="matchFn_">matchFn_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A function that evaluates a given argument and returns true if it meets a
+ given criteria.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l65">code &raquo;</a><span class="member"><a name="matchName_">matchName_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A string indicating the match intent (e.g. isBoolean or isString).</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l185">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.ObjectEquals.superClass_">goog.testing.mockmatchers.ObjectEquals.superClass_</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_mockmatchers_RegexpMatch.html b/docs/class_goog_testing_mockmatchers_RegexpMatch.html
new file mode 100644
index 0000000..641c947
--- /dev/null
+++ b/docs/class_goog_testing_mockmatchers_RegexpMatch.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.mockmatchers.RegexpMatch</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.mockmatchers.RegexpMatch</h1><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l147">code &raquo;</a><pre><code><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a>
+  &#x2514; goog.testing.mockmatchers.RegexpMatch</code></pre></header><section><p>A matcher that verifies that an argument matches a given RegExp.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.mockmatchers.RegexpMatch <span class="args">( regexp )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>regexp: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code><dd>The regular expression that the argument must match.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l78">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( toVerify, opt_expectation )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>A function that takes a match argument and an optional MockExpectation
+ which (if provided) will get error information and returns whether or
+ not it matches.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>toVerify: <code class="type">*</code><dd>The argument that should be verified.<dt>opt_expectation: <code class="type">?<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>The expectation
+     for this match.</dl><tr><th>Returns<tr><td><dl>Whether or not a given argument passes verification.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l58">code &raquo;</a><span class="member"><a name="matchFn_">matchFn_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A function that evaluates a given argument and returns true if it meets a
+ given criteria.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l65">code &raquo;</a><span class="member"><a name="matchName_">matchName_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A string indicating the match intent (e.g. isBoolean or isString).</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l147">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.RegexpMatch.superClass_">goog.testing.mockmatchers.RegexpMatch.superClass_</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_mockmatchers_SaveArgument.html b/docs/class_goog_testing_mockmatchers_SaveArgument.html
new file mode 100644
index 0000000..54da271
--- /dev/null
+++ b/docs/class_goog_testing_mockmatchers_SaveArgument.html
@@ -0,0 +1,8 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.mockmatchers.SaveArgument</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.mockmatchers.SaveArgument</h1><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l229">code &raquo;</a><pre><code><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a>
+  &#x2514; goog.testing.mockmatchers.SaveArgument</code></pre></header><section><p>A matcher that saves the argument that it is verifying so that your unit test
+ can perform extra tests with this argument later.  For example, if the
+ argument is a callback method, the unit test can then later call this
+ callback to test the asynchronous portion of the call.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.mockmatchers.SaveArgument <span class="args">( opt_matcher, opt_matchName )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_matcher: <code class="type">(<a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)=</code><dd>Argument matcher or matching function that will be used to validate the
+     argument.  By default, argument will always be valid.<dt>opt_matchName: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The name expressing intent as part of
+      an error message for when a match fails.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">goog.testing.mockmatchers.SaveArgument</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l249">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( toVerify, opt_expectation )</span> &rArr; <code class="type">boolean</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>toVerify<dt>opt_expectation</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">goog.testing.mockmatchers.SaveArgument</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l264">code &raquo;</a><span class="member"><a name="arg">arg</a> : <code class="type">*</code></span></div><p>Saved argument that was verified.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l239">code &raquo;</a><span class="member"><a name="delegateMatcher_">delegateMatcher_</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>Delegate match requests to this matcher.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l58">code &raquo;</a><span class="member"><a name="matchFn_">matchFn_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A function that evaluates a given argument and returns true if it meets a
+ given criteria.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l65">code &raquo;</a><span class="member"><a name="matchName_">matchName_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A string indicating the match intent (e.g. isBoolean or isString).</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l229">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.SaveArgument.superClass_">goog.testing.mockmatchers.SaveArgument.superClass_</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_mockmatchers_TypeOf.html b/docs/class_goog_testing_mockmatchers_TypeOf.html
new file mode 100644
index 0000000..8835d33
--- /dev/null
+++ b/docs/class_goog_testing_mockmatchers_TypeOf.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.mockmatchers.TypeOf</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.mockmatchers.TypeOf</h1><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l129">code &raquo;</a><pre><code><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a>
+  &#x2514; goog.testing.mockmatchers.TypeOf</code></pre></header><section><p>A matcher that verifies that an argument is of a given type (e.g. "object").<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.mockmatchers.TypeOf <span class="args">( type )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type that a given argument must have.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l78">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( toVerify, opt_expectation )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>A function that takes a match argument and an optional MockExpectation
+ which (if provided) will get error information and returns whether or
+ not it matches.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>toVerify: <code class="type">*</code><dd>The argument that should be verified.<dt>opt_expectation: <code class="type">?<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>The expectation
+     for this match.</dl><tr><th>Returns<tr><td><dl>Whether or not a given argument passes verification.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l58">code &raquo;</a><span class="member"><a name="matchFn_">matchFn_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A function that evaluates a given argument and returns true if it meets a
+ given criteria.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l65">code &raquo;</a><span class="member"><a name="matchName_">matchName_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A string indicating the match intent (e.g. isBoolean or isString).</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l129">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.TypeOf.superClass_">goog.testing.mockmatchers.TypeOf.superClass_</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_goog_testing_stacktrace_Frame.html b/docs/class_goog_testing_stacktrace_Frame.html
new file mode 100644
index 0000000..460cb26
--- /dev/null
+++ b/docs/class_goog_testing_stacktrace_Frame.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.stacktrace.Frame</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class goog.testing.stacktrace.Frame</h1><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l39">code &raquo;</a></header><section><p>Class representing one stack frame.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">goog.testing.stacktrace.Frame <span class="args">( context, name, alias, args, path )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>context: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Context object, empty in case of global functions or
+     if the browser doesn't provide this information.<dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Function name, empty in case of anonymous functions.<dt>alias: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Alias of the function if available. For example the
+     function name will be 'c' and the alias will be 'b' if the function is
+     defined as <code>a.b = function c() {};</code>.<dt>args: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Arguments of the function in parentheses if available.<dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>File path or URL including line number and optionally
+     column number separated by colons.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l52">code &raquo;</a><span class="member"><a name="getName">getName</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The function name or empty string if the function is
+     anonymous and the object field which it's assigned to is unknown.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l60">code &raquo;</a><span class="member"><a name="isAnonymous">isAnonymous</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the stack frame contains an anonymous function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l69">code &raquo;</a><span class="member"><a name="toCanonicalString">toCanonicalString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Brings one frame of the stack trace into a common format across browsers.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Pretty printed stack frame.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l42">code &raquo;</a><span class="member"><a name="alias_">alias_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l43">code &raquo;</a><span class="member"><a name="args_">args_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l40">code &raquo;</a><span class="member"><a name="context_">context_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l41">code &raquo;</a><span class="member"><a name="name_">name_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l44">code &raquo;</a><span class="member"><a name="path_">path_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_AbstractBuilder.html b/docs/class_webdriver_AbstractBuilder.html
index a8dc544..1b1363e 100644
--- a/docs/class_webdriver_AbstractBuilder.html
+++ b/docs/class_webdriver_AbstractBuilder.html
@@ -5,10 +5,12 @@
    <dd>Defines the remote WebDriver server that should be used for command
        command execution; may be overridden using
        <code >webdriver.AbstractBuilder.prototype.usingServer</code>.</dd>
- </dl><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.AbstractBuilder <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l122">code &raquo;</a><span class="member"><a name="build">build</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div><p>Builds a new <code  class="type"><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code> instance using this builder's
+ </dl><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.AbstractBuilder <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l135">code &raquo;</a><span class="member"><a name="build">build</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div><p>Builds a new <code  class="type"><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code> instance using this builder's
  current configuration.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new WebDriver client.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l112">code &raquo;</a><span class="member"><a name="getCapabilities">getCapabilities</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current desired capabilities for this
      builder.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l90">code &raquo;</a><span class="member"><a name="getServerUrl">getServerUrl</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The URL of the WebDriver server this instance is configured
-     to use.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l80">code &raquo;</a><span class="member"><a name="usingServer">usingServer</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Configures which WebDriver server should be used for new sessions. Overrides
+     to use.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l124">code &raquo;</a><span class="member"><a name="setLoggingPreferences">setLoggingPreferences</a> <span class="args">( prefs )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Sets the logging preferences for the created session. Preferences may be
+ changed by repeated calls, or by calling <code  class="type"><a class="unresolved-link">#withCapabilities</a></code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>prefs: <code class="type">!(<a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd>The
+     desired logging preferences.</dl><tr><th>Returns<tr><td><dl>This Builder instance for chain calling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l80">code &raquo;</a><span class="member"><a name="usingServer">usingServer</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Configures which WebDriver server should be used for new sessions. Overrides
  the value loaded from the <code  class="type"><a href="class_webdriver_AbstractBuilder.html#webdriver.AbstractBuilder.SERVER_URL_ENV">webdriver.AbstractBuilder.SERVER_URL_ENV</a></code>
  upon creation of this instance.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL of the server to use.</dl><tr><th>Returns<tr><td><dl>This Builder instance for chain calling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l102">code &raquo;</a><span class="member"><a name="withCapabilities">withCapabilities</a> <span class="args">( capabilities )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Sets the desired capabilities when requesting a new session. This will
  overwrite any previously set desired capabilities.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>capabilities: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>)</code><dd>The desired
@@ -18,4 +20,4 @@
  <code  class="type"><a href="class_webdriver_AbstractBuilder.html#usingServer">webdriver.AbstractBuilder#usingServer</a></code>.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l70">code &raquo;</a><span class="member"><a name="webdriver.AbstractBuilder.DEFAULT_SERVER_URL">webdriver.AbstractBuilder.DEFAULT_SERVER_URL</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The default URL of the WebDriver server to use if
  <code  class="type"><a href="class_webdriver_AbstractBuilder.html#webdriver.AbstractBuilder.SERVER_URL_ENV">webdriver.AbstractBuilder.SERVER_URL_ENV</a></code> is not set.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l61">code &raquo;</a><span class="member"><a name="webdriver.AbstractBuilder.SERVER_URL_ENV">webdriver.AbstractBuilder.SERVER_URL_ENV</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Environment variable that defines the URL of the WebDriver server that
  should be used for all new WebDriver clients. This setting may be overridden
- using <code >#usingServer(url)</code>.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ using <code >#usingServer(url)</code>.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_ActionSequence.html b/docs/class_webdriver_ActionSequence.html
index 86ec373..aaf62c0 100644
--- a/docs/class_webdriver_ActionSequence.html
+++ b/docs/class_webdriver_ActionSequence.html
@@ -1,87 +1,115 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.ActionSequence</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.ActionSequence</h1><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l43">code &raquo;</a></header><section><p>Class for defining sequences of complex user interactions. Each sequence
- will not be executed until <code  class="type"><a class="unresolved-link">#perform</a></code> is called.
-
- <p>Example:<pre><code>
-   new webdriver.ActionSequence(driver).
-       keyDown(webdriver.Key.SHIFT).
-       click(element1).
-       click(element2).
-       dragAndDrop(element3, element4).
-       keyUp(webdriver.Key.SHIFT).
-       perform();
- </pre></code><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.ActionSequence <span class="args">( driver )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The driver instance to use.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l250">code &raquo;</a><span class="member"><a name="click">click</a> <span class="args">( opt_elementOrButton, opt_button )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Clicks a mouse button.
-
- <p>If an element is provided, the mouse will first be moved to the center
- of that element. This is equivalent to:
- <pre><code>sequence.mouseMove(element).click()</code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_elementOrButton: <code class="type">(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="enum_webdriver_Button.html">webdriver.Button</a>)=</code><dd>Either
-     the element to interact with or the button to click with.
-     Defaults to <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code> if neither an element nor
-     button is specified.<dt>opt_button: <code class="type"><a href="enum_webdriver_Button.html">webdriver.Button</a>=</code><dd>The button to use. Defaults to
-     <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code>. Ignored if a button is provided as the
-     first argument.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l276">code &raquo;</a><span class="member"><a name="doubleClick">doubleClick</a> <span class="args">( opt_elementOrButton, opt_button )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Double-clicks a mouse button.
-
- <p>If an element is provided, the mouse will first be moved to the center of
- that element. This is equivalent to:
- <pre><code>sequence.mouseMove(element).doubleClick()</code></pre>
-
- <p>Warning: this method currently only supports the left mouse button. See
- http://code.google.com/p/selenium/issues/detail?id=4047</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_elementOrButton: <code class="type">(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="enum_webdriver_Button.html">webdriver.Button</a>)=</code><dd>Either
-     the element to interact with or the button to click with.
-     Defaults to <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code> if neither an element nor
-     button is specified.<dt>opt_button: <code class="type"><a href="enum_webdriver_Button.html">webdriver.Button</a>=</code><dd>The button to use. Defaults to
-     <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code>. Ignored if a button is provided as the
-     first argument.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l229">code &raquo;</a><span class="member"><a name="dragAndDrop">dragAndDrop</a> <span class="args">( element, location )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Convenience function for performing a "drag and drop" manuever. The target
- element may be moved to the location of another element, or by an offset (in
- pixels).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">!<a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd>The element to drag.<dt>location: <code class="type">(!<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd>The
-     location to drag to, either as another WebElement or an offset in pixels.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l324">code &raquo;</a><span class="member"><a name="keyDown">keyDown</a> <span class="args">( key )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Performs a modifier key press. The modifier key is <em>not released</em>
- until <code  class="type"><a class="unresolved-link">#keyUp</a></code> or <code  class="type"><a class="unresolved-link">#sendKeys</a></code> is called. The key press will be
- targetted at the currently focused element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">!<a href="enum_webdriver_Key.html">webdriver.Key</a></code><dd>The modifier key to push. Must be one of
-     {ALT, CONTROL, SHIFT, COMMAND, META}.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the key is not a valid modifier key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l338">code &raquo;</a><span class="member"><a name="keyUp">keyUp</a> <span class="args">( key )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Performs a modifier key release. The release is targetted at the currently
- focused element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">!<a href="enum_webdriver_Key.html">webdriver.Key</a></code><dd>The modifier key to release. Must be one of
-     {ALT, CONTROL, SHIFT, COMMAND, META}.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the key is not a valid modifier key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l186">code &raquo;</a><span class="member"><a name="mouseDown">mouseDown</a> <span class="args">( opt_elementOrButton, opt_button )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Presses a mouse button. The mouse button will not be released until
- <code  class="type"><a class="unresolved-link">#mouseUp</a></code> is called, regardless of whether that call is made in this
- sequence or another. The behavior for out-of-order events (e.g. mouseDown,
- click) is undefined.
-
- <p>If an element is provided, the mouse will first be moved to the center
- of that element. This is equivalent to:
- <pre><code>sequence.mouseMove(element).mouseDown()</code></pre>
-
- <p>Warning: this method currently only supports the left mouse button. See
- http://code.google.com/p/selenium/issues/detail?id=4047</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_elementOrButton: <code class="type">(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="enum_webdriver_Button.html">webdriver.Button</a>)=</code><dd>Either
-     the element to interact with or the button to click with.
-     Defaults to <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code> if neither an element nor
-     button is specified.<dt>opt_button: <code class="type"><a href="enum_webdriver_Button.html">webdriver.Button</a>=</code><dd>The button to use. Defaults to
-     <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code>. Ignored if a button is provided as the
-     first argument.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l100">code &raquo;</a><span class="member"><a name="mouseMove">mouseMove</a> <span class="args">( location, opt_offset )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Moves the mouse.  The location to move to may be specified in terms of the
- mouse's current location, an offset relative to the top-left corner of an
- element, or an element (in which case the middle of the element is used).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>location: <code class="type">(!<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd>The
-     location to drag to, as either another WebElement or an offset in pixels.<dt>opt_offset: <code class="type">{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}=</code><dd>If the target <code >location</code>
-     is defined as a <code  class="type"><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code>, this parameter defines an
-     offset within that element. The offset should be specified in pixels
-     relative to the top-left corner of the element's bounding box. If
-     omitted, the element's center will be used as the target offset.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l213">code &raquo;</a><span class="member"><a name="mouseUp">mouseUp</a> <span class="args">( opt_elementOrButton, opt_button )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Releases a mouse button. Behavior is undefined for calling this function
- without a previous call to <code  class="type"><a class="unresolved-link">#mouseDown</a></code>.
-
- <p>If an element is provided, the mouse will first be moved to the center
- of that element. This is equivalent to:
- <pre><code>sequence.mouseMove(element).mouseUp()</code></pre>
-
- <p>Warning: this method currently only supports the left mouse button. See
- http://code.google.com/p/selenium/issues/detail?id=4047</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_elementOrButton: <code class="type">(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="enum_webdriver_Button.html">webdriver.Button</a>)=</code><dd>Either
-     the element to interact with or the button to click with.
-     Defaults to <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code> if neither an element nor
-     button is specified.<dt>opt_button: <code class="type"><a href="enum_webdriver_Button.html">webdriver.Button</a>=</code><dd>The button to use. Defaults to
-     <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code>. Ignored if a button is provided as the
-     first argument.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l73">code &raquo;</a><span class="member"><a name="perform">perform</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Executes this action sequence.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved once
-     this sequence has completed.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l291">code &raquo;</a><span class="member"><a name="scheduleKeyboardAction_">scheduleKeyboardAction_</a> <span class="args">( description, keys )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Schedules a keyboard action.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A simple descriptive label for the scheduled
-     action.<dt>keys: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The keys to send.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l144">code &raquo;</a><span class="member"><a name="scheduleMouseAction_">scheduleMouseAction_</a> <span class="args">( description, commandName, opt_elementOrButton, opt_button )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Schedules a mouse action.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A simple descriptive label for the scheduled
-     action.<dt>commandName: <code class="type">!<a href="enum_webdriver_CommandName.html">webdriver.CommandName</a></code><dd>The name of the command.<dt>opt_elementOrButton: <code class="type">(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="enum_webdriver_Button.html">webdriver.Button</a>)=</code><dd>Either
-     the element to interact with or the button to click with.
-     Defaults to <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code> if neither an element nor
-     button is specified.<dt>opt_button: <code class="type"><a href="enum_webdriver_Button.html">webdriver.Button</a>=</code><dd>The button to use. Defaults to
-     <code  class="type"><a href="enum_webdriver_Button.html#webdriver.Button.LEFT">webdriver.Button.LEFT</a></code>. Ignored if the previous argument is
-     provided as a button.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l60">code &raquo;</a><span class="member"><a name="schedule_">schedule_</a> <span class="args">( description, command )</span></span></div><p>Schedules an action to be executed each time <code  class="type"><a class="unresolved-link">#perform</a></code> is called on
- this instance.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A description of the command.<dt>command: <code class="type">!<a href="class_webdriver_Command.html">webdriver.Command</a></code><dd>The command.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l353">code &raquo;</a><span class="member"><a name="sendKeys">sendKeys</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Simulates typing multiple keys. Each modifier key encountered in the
- sequence will not be released until it is encountered again. All key events
- will be targetted at the currently focused element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="enum_webdriver_Key.html">webdriver.Key</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code><dd>The keys to type.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the key is not a valid modifier key.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l49">code &raquo;</a><span class="member"><a name="actions_">actions_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l46">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/actionsequence.js.src.html#l307">code &raquo;</a><span class="member"><a name="webdriver.ActionSequence.checkModifierKey_">webdriver.ActionSequence.checkModifierKey_</a> <span class="args">( key )</span></span></div><p>Checks that a key is a modifier key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type">!<a href="enum_webdriver_Key.html">webdriver.Key</a></code><dd>The key to check.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the key is not a modifier key.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>ActionSequence</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l45">View Source</a></div><h1>class ActionSequence</h1><p>Class for defining sequences of complex user interactions. Each sequence
+will not be executed until <a href="class_webdriver_ActionSequence.html#perform"><code>#perform</code></a> is called.</p>
+<p>Example:</p>
+<pre><code>new webdriver.ActionSequence(driver).
+    keyDown(webdriver.Key.SHIFT).
+    click(element1).
+    click(element2).
+    dragAndDrop(element3, element4).
+    keyUp(webdriver.Key.SHIFT).
+    perform();
+</code></pre>
+<h3>new ActionSequence(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver instance to use.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="click" class="function"><div><h3>click(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l249">code »</a></span></h3><p>Clicks a mouse button.</p>
+<p>If an element is provided, the mouse will first be moved to the center
+of that element. This is equivalent to:</p>
+<pre><code>sequence.mouseMove(element).click()
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
+the element to interact with or the button to click with.
+Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
+button is specified.</p>
+<dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
+<a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
+first argument.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="doubleClick" class="function"><div><h3>doubleClick(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l276">code »</a></span></h3><p>Double-clicks a mouse button.</p>
+<p>If an element is provided, the mouse will first be moved to the center of
+that element. This is equivalent to:</p>
+<pre><code>sequence.mouseMove(element).doubleClick()
+</code></pre>
+<p>Warning: this method currently only supports the left mouse button. See
+<a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
+the element to interact with or the button to click with.
+Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
+button is specified.</p>
+<dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
+<a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
+first argument.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="dragAndDrop" class="function"><div><h3>dragAndDrop(<wbr>element, location)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l227">code »</a></span></h3><p>Convenience function for performing a &#34;drag and drop&#34; manuever. The target
+element may be moved to the location of another element, or by an offset (in
+pixels).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to drag.</p>
+<dt>location<code>(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd><p>The
+location to drag to, either as another WebElement or an offset in pixels.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="keyDown" class="function"><div><h3>keyDown(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l324">code »</a></span></h3><p>Performs a modifier key press. The modifier key is <em>not released</em>
+until <a href="class_webdriver_ActionSequence.html#keyUp"><code>#keyUp</code></a> or <a href="class_webdriver_ActionSequence.html#sendKeys"><code>#sendKeys</code></a> is called. The key press will be
+targetted at the currently focused element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The modifier key to push. Must be one of
+{ALT, CONTROL, SHIFT, COMMAND, META}.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the key is not a valid modifier key.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="keyUp" class="function"><div><h3>keyUp(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l338">code »</a></span></h3><p>Performs a modifier key release. The release is targetted at the currently
+focused element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The modifier key to release. Must be one of
+{ALT, CONTROL, SHIFT, COMMAND, META}.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the key is not a valid modifier key.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="mouseDown" class="function"><div><h3>mouseDown(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l183">code »</a></span></h3><p>Presses a mouse button. The mouse button will not be released until
+<a href="class_webdriver_ActionSequence.html#mouseUp"><code>#mouseUp</code></a> is called, regardless of whether that call is made in this
+sequence or another. The behavior for out-of-order events (e.g. mouseDown,
+click) is undefined.</p>
+<p>If an element is provided, the mouse will first be moved to the center
+of that element. This is equivalent to:</p>
+<pre><code>sequence.mouseMove(element).mouseDown()
+</code></pre>
+<p>Warning: this method currently only supports the left mouse button. See
+<a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
+the element to interact with or the button to click with.
+Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
+button is specified.</p>
+<dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
+<a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
+first argument.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="mouseMove" class="function"><div><h3>mouseMove(<wbr>location, opt_offset)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l102">code »</a></span></h3><p>Moves the mouse.  The location to move to may be specified in terms of the
+mouse&#39;s current location, an offset relative to the top-left corner of an
+element, or an element (in which case the middle of the element is used).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>location<code>(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd><p>The
+location to drag to, as either another WebElement or an offset in pixels.</p>
+<dt>opt_offset<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}=</code><dd><p>If the target <code>location</code>
+is defined as a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, this parameter defines an
+offset within that element. The offset should be specified in pixels
+relative to the top-left corner of the element&#39;s bounding box. If
+omitted, the element&#39;s center will be used as the target offset.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="mouseUp" class="function"><div><h3>mouseUp(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l211">code »</a></span></h3><p>Releases a mouse button. Behavior is undefined for calling this function
+without a previous call to <a href="class_webdriver_ActionSequence.html#mouseDown"><code>#mouseDown</code></a>.</p>
+<p>If an element is provided, the mouse will first be moved to the center
+of that element. This is equivalent to:</p>
+<pre><code>sequence.mouseMove(element).mouseUp()
+</code></pre>
+<p>Warning: this method currently only supports the left mouse button. See
+<a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
+the element to interact with or the button to click with.
+Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
+button is specified.</p>
+<dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
+<a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
+first argument.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="perform" class="function"><div><h3>perform()<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l75">code »</a></span></h3><p>Executes this action sequence.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved once
+this sequence has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l353">code »</a></span></h3><p>Simulates typing multiple keys. Each modifier key encountered in the
+sequence will not be released until it is encountered again. All key events
+will be targetted at the currently focused element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The keys to type.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the key is not a valid modifier key.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_Alert.html b/docs/class_webdriver_Alert.html
index d40586f..398446e 100644
--- a/docs/class_webdriver_Alert.html
+++ b/docs/class_webdriver_Alert.html
@@ -1,109 +1,24 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Alert</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.Alert</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1996">code &raquo;</a><pre><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>
-  &#x2514; <a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a>
-      &#x2514; webdriver.Alert</code></pre></header><section><p>Represents a modal dialog such as <code >alert</code>, <code >confirm</code>, or
- <code >prompt</code>. Provides functions to retrieve the message displayed with
- the alert, accept or dismiss the alert, and set the response text (in the
- case of <code >prompt</code>).<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.Alert <span class="args">( driver, text )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The driver controlling the browser this
-     alert is attached to.<dt>text: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code><dd>Either the message text
-     displayed with this alert, or a promise that will be resolved to said
-     text.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.Alert</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2035">code &raquo;</a><span class="member"><a name="accept">accept</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Accepts this alert.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     this command has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2047">code &raquo;</a><span class="member"><a name="dismiss">dismiss</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Dismisses this alert.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     this command has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2025">code &raquo;</a><span class="member"><a name="getText">getText</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Retrieves the message text displayed with this alert. For instance, if the
- alert were opened with alert("hello"), then this would return "hello".</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved to the
-     text displayed with this alert.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2062">code &raquo;</a><span class="member"><a name="sendKeys">sendKeys</a> <span class="args">( text )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Sets the response text on this alert. This command will return an error if
- the underlying alert does not support response text (e.g. window.alert and
- window.confirm).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>text: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The text to set.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     this command has completed.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
- be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l527">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
- promise and not a reference to this deferred, this instance will wait for
- it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">*=</code><dd>The resolved value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
- be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l533">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l237">code &raquo;</a><span class="member deprecation-notice"><a name="addBoth">addBoth</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenFinally()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is either rejected or
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when this promise is
-     either resolved or rejected. The function should expect a single
-     argument: the resolved value or rejection error.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l199">code &raquo;</a><span class="member deprecation-notice"><a name="addCallback">addCallback</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is successfully
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l259">code &raquo;</a><span class="member deprecation-notice"><a name="addCallbacks">addCallbacks</a> <span class="args">( callback, errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>An alias for <code >webdriver.promise.Promise.prototype.then</code> that permits
- the scope of the invoked function to be specified. This function is provided
- for backwards compatibility with the Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l218">code &raquo;</a><span class="member deprecation-notice"><a name="addErrback">addErrback</a> <span class="args">( errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenCatch()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is rejected.
- This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l86">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div><p>Cancels the computation of this promise's value, rejecting the promise in the
- process.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason: <code class="type">*</code><dd>The reason this promise is being cancelled. If not an
-     <code >Error</code>, one will be created using the value's string
-     representation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l92">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether this promise's value is still being computed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l110">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers listeners for when this instance is resolved. This function most
- overridden by subtypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l139">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener for when this promise is rejected. This is synonymous
- with the <code >catch</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } catch (ex) {
-     console.error(ex);
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenCatch(function(ex) {
-     console.error(ex);
-   });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l180">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener to invoke when this promise is resolved, regardless
- of whether the promise's value was successfully computed. This function
- is synonymous with the <code >finally</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } finally {
-     cleanUp();
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenFinally(cleanUp);
- </code></pre>
-
- <b>Note:</b> similar to the <code >finally</code> clause, if the registered
- callback returns a rejected promise or throws an error, it will silently
- replace the rejection error (if any) from this promise:
- <pre><code>
-   try {
-     throw Error('one');
-   } finally {
-     throw Error('two');  // Hides Error: one
-   }
-
-   webdriver.promise.rejected(Error('one'))
-       .thenFinally(function() {
-         throw Error('two');  // Hides Error: one
-       });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.Alert</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2000">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2011">code &raquo;</a><span class="member"><a name="text_">text_</a> : <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l523">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
- in one of three states: pending, resolved, or rejected. Each promise starts
- in the pending state and may make a single transition to either a
- fulfilled or failed state.
-
- <p/>This class is based on the Promise/A proposal from CommonJS. Additional
- functions are provided for API compatibility with Dojo Deferred objects.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1996">code &raquo;</a><span class="member"><a name="webdriver.Alert.superClass_">webdriver.Alert.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Alert</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2283">View Source</a></div><h1>class Alert</h1><p>Represents a modal dialog such as <code>alert</code>, <code>confirm</code>, or
+<code>prompt</code>. Provides functions to retrieve the message displayed with
+the alert, accept or dismiss the alert, and set the response text (in the
+case of <code>prompt</code>).</p>
+<h3>new Alert(<wbr>driver, text)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver controlling the browser this
+alert is attached to.</p>
+<dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The message text displayed with this alert.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="accept" class="function"><div><h3>accept()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2308">code »</a></span></h3><p>Accepts this alert.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="dismiss" class="function"><div><h3>dismiss()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2320">code »</a></span></h3><p>Dismisses this alert.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getText" class="function"><div><h3>getText()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2298">code »</a></span></h3><p>Retrieves the message text displayed with this alert. For instance, if the
+alert were opened with alert(&#34;hello&#34;), then this would return &#34;hello&#34;.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the text displayed with this alert.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2335">code »</a></span></h3><p>Sets the response text on this alert. This command will return an error if
+the underlying alert does not support response text (e.g. window.alert and
+window.confirm).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The text to set.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_AlertPromise.html b/docs/class_webdriver_AlertPromise.html
new file mode 100644
index 0000000..9abc1b4
--- /dev/null
+++ b/docs/class_webdriver_AlertPromise.html
@@ -0,0 +1,92 @@
+<!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>AlertPromise</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2364">View Source</a></div><h1>class AlertPromise</h1><div class="tags"><span>final</span></div><pre class="inheritance"><a href="class_webdriver_Alert.html">webdriver.Alert</a>
+  &#x2514; webdriver.AlertPromise</pre><dl><dt>All implemented interfaces<dd><code>IThenable&lt;T&gt;</code><dd><code><a href="interface_webdriver_promise_Thenable.html">webdriver.promise.Thenable</a>&lt;<a href="class_webdriver_Alert.html">webdriver.Alert</a>&gt;</code></dl><p>AlertPromise is a promise that will be fulfilled with an Alert. This promise
+serves as a forward proxy on an Alert, allowing calls to be scheduled
+directly on this instance before the underlying Alert has been fulfilled. In
+other words, the following two statements are equivalent:</p>
+<pre><code>driver.switchTo().alert().dismiss();
+driver.switchTo().alert().then(function(alert) {
+  return alert.dismiss();
+});
+</code></pre>
+<h3>new AlertPromise(<wbr>driver, alert)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver controlling the browser this
+alert is attached to.</p>
+<dt>alert<code><a href="interface_webdriver_promise_Thenable.html">webdriver.promise.Thenable</a>&lt;<a href="class_webdriver_Alert.html">webdriver.Alert</a>&gt;</code><dd><p>A thenable
+that will be fulfilled with the promised alert.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="accept" class="function"><div><h3>accept()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2396">code »</a></span></h3><p>Defers action until the alert has been located.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Alert.html#accept">webdriver.Alert</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="cancel" class="function"><div><h3>cancel(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2368">code »</a></span></h3><p>Cancels the computation of this promise&#39;s value, rejecting the promise in
+the process. This method is a no-op if the promise has already been
+resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#cancel">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_CancellationError.html">webdriver.promise.CancellationError</a>)=</code><dd><p>The reason this
+promise is being cancelled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="dismiss" class="function"><div><h3>dismiss()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2406">code »</a></span></h3><p>Defers action until the alert has been located.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Alert.html#dismiss">webdriver.Alert</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getText" class="function"><div><h3>getText()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2386">code »</a></span></h3><p>Defer returning text until the promised alert has been resolved.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Alert.html#getText">webdriver.Alert</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the text displayed with this alert.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isPending" class="function"><div><h3>isPending()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2371">code »</a></span></h3><p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#isPending">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether this promise&#39;s value is still being computed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2416">code »</a></span></h3><p>Defers action until the alert has been located.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Alert.html#sendKeys">webdriver.Alert</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The text to set.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="then" class="function"><div><h3>then(<wbr>opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2374">code »</a></span></h3><p>Registers listeners for when this instance is resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#then">webdriver.promise.Thenable</a>, <a href="#then">IThenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_callback<code>?function(T): (R|IThenable&lt;R&gt;)=</code><dd><p>The
+function to call if this promise is successfully resolved. The function
+should expect a single argument: the promise&#39;s resolved value.</p>
+<dt>opt_errback<code>?function(*): (R|IThenable&lt;R&gt;)=</code><dd><p>The function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenCatch" class="function"><div><h3>thenCatch(<wbr>errback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2377">code »</a></span></h3><p>Registers a listener for when this promise is rejected. This is synonymous
+with the <code>catch</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} catch (ex) {
+  console.error(ex);
+}
+
+// Asynchronous promise API:
+doAsynchronousWork().thenCatch(function(ex) {
+  console.error(ex);
+});
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenCatch">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>errback<code>function(*): (R|IThenable&lt;R&gt;)</code><dd><p>The
+function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenFinally" class="function"><div><h3>thenFinally(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2380">code »</a></span></h3><p>Registers a listener to invoke when this promise is resolved, regardless
+of whether the promise&#39;s value was successfully computed. This function
+is synonymous with the <code>finally</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} finally {
+  cleanUp();
+}
+
+// Asynchronous promise API:
+doAsynchronousWork().thenFinally(cleanUp);
+</code></pre>
+<p><strong>Note:</strong> similar to the <code>finally</code> clause, if the registered
+callback returns a rejected promise or throws an error, it will silently
+replace the rejection error (if any) from this promise:</p>
+<pre><code>try {
+  throw Error(&#39;one&#39;);
+} finally {
+  throw Error(&#39;two&#39;);  // Hides Error: one
+}
+
+promise.rejected(Error(&#39;one&#39;))
+    .thenFinally(function() {
+      throw Error(&#39;two&#39;);  // Hides Error: one
+    });
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenFinally">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(): (R|IThenable&lt;R&gt;)</code><dd><p>The function
+to call when this promise is resolved.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be fulfilled
+with the callback result.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_Builder.html b/docs/class_webdriver_Builder.html
index f650658..a67f28c 100644
--- a/docs/class_webdriver_Builder.html
+++ b/docs/class_webdriver_Builder.html
@@ -3,7 +3,9 @@
      to reuse.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/builder.js.src.html#l69">code &raquo;</a><span class="member"><a name="usingSession">usingSession</a> <span class="args">( id )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Configures the builder to create a client that will use an existing WebDriver
  session.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>id: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The existing session ID to use.</dl><tr><th>Returns<tr><td><dl>This Builder instance for chain calling.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l112">code &raquo;</a><span class="member"><a name="getCapabilities">getCapabilities</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current desired capabilities for this
      builder.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l90">code &raquo;</a><span class="member"><a name="getServerUrl">getServerUrl</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The URL of the WebDriver server this instance is configured
-     to use.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l80">code &raquo;</a><span class="member"><a name="usingServer">usingServer</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Configures which WebDriver server should be used for new sessions. Overrides
+     to use.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l124">code &raquo;</a><span class="member"><a name="setLoggingPreferences">setLoggingPreferences</a> <span class="args">( prefs )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Sets the logging preferences for the created session. Preferences may be
+ changed by repeated calls, or by calling <code  class="type"><a class="unresolved-link">#withCapabilities</a></code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>prefs: <code class="type">!(<a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd>The
+     desired logging preferences.</dl><tr><th>Returns<tr><td><dl>This Builder instance for chain calling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l80">code &raquo;</a><span class="member"><a name="usingServer">usingServer</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Configures which WebDriver server should be used for new sessions. Overrides
  the value loaded from the <code  class="type"><a href="class_webdriver_AbstractBuilder.html#webdriver.AbstractBuilder.SERVER_URL_ENV">webdriver.AbstractBuilder.SERVER_URL_ENV</a></code>
  upon creation of this instance.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL of the server to use.</dl><tr><th>Returns<tr><td><dl>This Builder instance for chain calling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l102">code &raquo;</a><span class="member"><a name="withCapabilities">withCapabilities</a> <span class="args">( capabilities )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Sets the desired capabilities when requesting a new session. This will
  overwrite any previously set desired capabilities.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>capabilities: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>)</code><dd>The desired
@@ -19,4 +21,4 @@
  default to creating clients that use this session. To create a new session,
  use <code >#useExistingSession(boolean)</code>. The use of this environment
  variable requires that <code  class="type"><a href="class_webdriver_AbstractBuilder.html#webdriver.AbstractBuilder.SERVER_URL_ENV">webdriver.AbstractBuilder.SERVER_URL_ENV</a></code> also
- be set.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/builder.js.src.html#l32">code &raquo;</a><span class="member"><a name="webdriver.Builder.superClass_">webdriver.Builder.superClass_</a> : <code class="type"><a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ be set.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/builder.js.src.html#l32">code &raquo;</a><span class="member"><a name="webdriver.Builder.superClass_">webdriver.Builder.superClass_</a> : <code class="type"><a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_Capabilities.html b/docs/class_webdriver_Capabilities.html
index 12d3834..e301d52 100644
--- a/docs/class_webdriver_Capabilities.html
+++ b/docs/class_webdriver_Capabilities.html
@@ -1,9 +1,60 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Capabilities</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.Capabilities</h1><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l138">code &raquo;</a></header><section><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.Capabilities <span class="args">( opt_other )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_other: <code class="type">(<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)=</code><dd>Another set of
-     capabilities to merge into this instance.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l303">code &raquo;</a><span class="member"><a name="get">get</a> <span class="args">( key )</span> &rArr; <code class="type">*</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The capability to return.</dl><tr><th>Returns<tr><td><dl>The capability with the given key, or <code >null</code> if it has
-     not been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l316">code &raquo;</a><span class="member"><a name="has">has</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The capability to check.</dl><tr><th>Returns<tr><td><dl>Whether the specified capability is set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l270">code &raquo;</a><span class="member"><a name="merge">merge</a> <span class="args">( other )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div><p>Merges another set of capabilities into this instance. Any duplicates in
- the provided set will override those already set on this instance.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>other: <code class="type">!(<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>The capabilities to
-     merge into this instance.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l288">code &raquo;</a><span class="member"><a name="set">set</a> <span class="args">( key, value )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The capability to set.<dt>value: <code class="type">*</code><dd>The capability value.  Capability values must be JSON
-     serializable. Pass <code >null</code> to unset the capability.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l258">code &raquo;</a><span class="member"><a name="toJSON">toJSON</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The JSON representation of this instance.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l141">code &raquo;</a><span class="member"><a name="caps_">caps_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l152">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.android">webdriver.Capabilities.android</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for Android.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l162">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.chrome">webdriver.Capabilities.chrome</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for Chrome.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l171">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.firefox">webdriver.Capabilities.firefox</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for Firefox.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l240">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.htmlunit">webdriver.Capabilities.htmlunit</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for HTMLUnit.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l250">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.htmlunitwithjs">webdriver.Capabilities.htmlunitwithjs</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for HTMLUnit
-     with enabled Javascript.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l181">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.ie">webdriver.Capabilities.ie</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for
-     Internet Explorer.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l192">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.ipad">webdriver.Capabilities.ipad</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for iPad.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l202">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.iphone">webdriver.Capabilities.iphone</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for iPhone.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l212">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.opera">webdriver.Capabilities.opera</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for Opera.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l222">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.phantomjs">webdriver.Capabilities.phantomjs</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for
-     PhantomJS.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l231">code &raquo;</a><span class="member"><a name="webdriver.Capabilities.safari">webdriver.Capabilities.safari</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A basic set of capabilities for Safari.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Capabilities</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l170">View Source</a></div><h1>class Capabilities</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, ?&gt;&gt;
+  &#x2514; webdriver.Capabilities</pre><h3>new Capabilities(<wbr>opt_other)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_other<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>Another set of
+capabilities to merge into this instance.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="get" class="function"><div><h3>get(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l340">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The capability to return.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><p>The capability with the given key, or <code>null</code> if it has
+not been set.</p>
+</div></div></div></div><hr class="fn-sep"><div id="has" class="function"><div><h3>has(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l353">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The capability to check.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the specified capability is set.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="merge" class="function"><div><h3>merge(<wbr>other)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l307">code »</a></span></h3><p>Merges another set of capabilities into this instance. Any duplicates in
+the provided set will override those already set on this instance.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>other<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>The capabilities to
+merge into this instance.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l295">code »</a></span></h3><p>Returns either this instance&#39;s serialized represention, if immediately
+available, or a promise for its serialized representation. This function is
+conceptually equivalent to objects that have a <code>toJSON()</code> property,
+except the serialize() result may be a promise or an object containing a
+promise (which are not directly JSON friendly).</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, ?&gt;</code><dd><p>The JSON representation of this instance. Note,
+the returned object may contain nested promises that are promised values.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="set" class="function"><div><h3>set(<wbr>key, value)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l325">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The capability to set.</p>
+<dt>value<code>*</code><dd><p>The capability value.  Capability values must be JSON
+serializable. Pass <code>null</code> to unset the capability.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAlertBehavior" class="function"><div><h3>setAlertBehavior(<wbr>behavior)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l409">code »</a></span></h3><p>Sets the default action to take with an unexpected alert before returning
+an error.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>behavior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The desired behavior; should be &#34;accept&#34;, &#34;dismiss&#34;,
+or &#34;ignore&#34;. Defaults to &#34;dismiss&#34;.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setEnableNativeEvents" class="function"><div><h3>setEnableNativeEvents(<wbr>enabled)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l386">code »</a></span></h3><p>Sets whether native events should be used.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enabled<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable native events.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPrefs" class="function"><div><h3>setLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l366">code »</a></span></h3><p>Sets the logging preferences. Preferences may be specified as a
+<a href="class_webdriver_logging_Preferences.html"><code>webdriver.logging.Preferences</code></a> instance, or a as a map of log-type to
+log-level.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code>(<a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The
+logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>proxy)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l376">code »</a></span></h3><p>Sets the proxy configuration for this instance.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>The desired proxy configuration.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setScrollBehavior" class="function"><div><h3>setScrollBehavior(<wbr>behavior)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l397">code »</a></span></h3><p>Sets how elements should be scrolled into view for interaction.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>behavior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired scroll behavior: either 0 to align with
+the top of the viewport or 1 to align with the bottom.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="Capabilities.android" class="function"><div><h3>Capabilities.android()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l186">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Android.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.chrome" class="function"><div><h3>Capabilities.chrome()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l196">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Chrome.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.firefox" class="function"><div><h3>Capabilities.firefox()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l205">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Firefox.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.htmlunit" class="function"><div><h3>Capabilities.htmlunit()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l273">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for HTMLUnit.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.htmlunitwithjs" class="function"><div><h3>Capabilities.htmlunitwithjs()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l283">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for HTMLUnit
+with enabled Javascript.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.ie" class="function"><div><h3>Capabilities.ie()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l215">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for
+Internet Explorer.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.ipad" class="function"><div><h3>Capabilities.ipad()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l226">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for iPad.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.iphone" class="function"><div><h3>Capabilities.iphone()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l236">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for iPhone.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.opera" class="function"><div><h3>Capabilities.opera()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l246">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Opera.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.phantomjs" class="function"><div><h3>Capabilities.phantomjs()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l255">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for
+PhantomJS.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.safari" class="function"><div><h3>Capabilities.safari()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l264">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Safari.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_Command.html b/docs/class_webdriver_Command.html
index 77ec1da..b6f001a 100644
--- a/docs/class_webdriver_Command.html
+++ b/docs/class_webdriver_Command.html
@@ -1 +1,15 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Command</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.Command</h1><a class="source" href="source/lib/webdriver/command.js.src.html#l30">code &raquo;</a></header><section><p>Describes a command to be executed by the WebDriverJS framework.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.Command <span class="args">( name )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type">!<a href="enum_webdriver_CommandName.html">webdriver.CommandName</a></code><dd>The name of this command.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/command.js.src.html#l49">code &raquo;</a><span class="member"><a name="getName">getName</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="enum_webdriver_CommandName.html">webdriver.CommandName</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This command's name.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/command.js.src.html#l82">code &raquo;</a><span class="member"><a name="getParameter">getParameter</a> <span class="args">( key )</span> &rArr; <code class="type">*</code></span></div><p>Returns a named command parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter key to look up.</dl><tr><th>Returns<tr><td><dl>The parameter value, or undefined if it has not been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/command.js.src.html#l90">code &raquo;</a><span class="member"><a name="getParameters">getParameters</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The parameters to send with this command.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/command.js.src.html#l60">code &raquo;</a><span class="member"><a name="setParameter">setParameter</a> <span class="args">( name, value )</span> &rArr; <code class="type">!<a href="class_webdriver_Command.html">webdriver.Command</a></code></span></div><p>Sets a parameter to send with this command.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The parameter name.<dt>value: <code class="type">*</code><dd>The parameter value.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/command.js.src.html#l71">code &raquo;</a><span class="member"><a name="setParameters">setParameters</a> <span class="args">( parameters )</span> &rArr; <code class="type">!<a href="class_webdriver_Command.html">webdriver.Command</a></code></span></div><p>Sets the parameters for this command.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parameters: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The command parameters.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/command.js.src.html#l42">code &raquo;</a><span class="member"><a name="parameters_">parameters_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>The parameters to this command.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Command</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/command.js.src.html#l33">View Source</a></div><h1>class Command</h1><p>Describes a command to be executed by the WebDriverJS framework.</p>
+<h3>new Command(<wbr>name)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of this command.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getName" class="function"><div><h3>getName()<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l52">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>This command&#39;s name.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getParameter" class="function"><div><h3>getParameter(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l85">code »</a></span></h3><p>Returns a named command parameter.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The parameter key to look up.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><p>The parameter value, or undefined if it has not been set.</p>
+</div></div></div></div><hr class="fn-sep"><div id="getParameters" class="function"><div><h3>getParameters()<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l93">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, *&gt;</code><dd><p>The parameters to send with this command.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setParameter" class="function"><div><h3>setParameter(<wbr>name, value)<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l63">code »</a></span></h3><p>Sets a parameter to send with this command.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The parameter name.</p>
+<dt>value<code>*</code><dd><p>The parameter value.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setParameters" class="function"><div><h3>setParameters(<wbr>parameters)<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l74">code »</a></span></h3><p>Sets the parameters for this command.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>parameters<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, *&gt;</code><dd><p>The command parameters.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_EventEmitter.html b/docs/class_webdriver_EventEmitter.html
index 0289852..0a627b2 100644
--- a/docs/class_webdriver_EventEmitter.html
+++ b/docs/class_webdriver_EventEmitter.html
@@ -1,7 +1,35 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.EventEmitter</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.EventEmitter</h1><a class="source" href="source/lib/webdriver/events.js.src.html#l29">code &raquo;</a></header><section><p>Object that can emit events for others to listen for. This is used instead
- of Closure's event system because it is much more light weight. The API is
- based on Node's EventEmitters.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.EventEmitter <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l116">code &raquo;</a><span class="member"><a name="addListener">addListener</a> <span class="args">( type, listenerFn, opt_scope )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Registers a listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to listen for.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to invoke when the event is fired.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to invoke the listener.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l90">code &raquo;</a><span class="member"><a name="addListener_">addListener_</a> <span class="args">( type, listenerFn, opt_scope, opt_oneshot )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Registers a listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to listen for.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to invoke when the event is fired.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to invoke the listener.<dt>opt_oneshot: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether the listener should be removed after
-    the first event is fired.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l44">code &raquo;</a><span class="member"><a name="emit">emit</a> <span class="args">( type, var_args )</span></span></div><p>Fires an event and calls all listeners.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to emit.<dt>var_args: <code class="type">...*</code><dd>Any arguments to pass to each listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l71">code &raquo;</a><span class="member"><a name="listeners">listeners</a> <span class="args">( type )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns a mutable list of listeners for a specific type of event.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to retrieve the listeners for.</dl><tr><th>Returns<tr><td><dl>The registered listeners for
-     the given event type.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l142">code &raquo;</a><span class="member"><a name="on">on</a> <span class="args">( type, listenerFn, opt_scope )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>An alias for <code >#addListener()</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to listen for.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to invoke when the event is fired.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to invoke the listener.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l130">code &raquo;</a><span class="member"><a name="once">once</a> <span class="args">( type, listenerFn, opt_scope )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Registers a one-time listener which will be called only the first time an
- event is emitted, after which it will be removed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to listen for.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to invoke when the event is fired.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to invoke the listener.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l173">code &raquo;</a><span class="member"><a name="removeAllListeners">removeAllListeners</a> <span class="args">( opt_type )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Removes all listeners for a specific type of event. If no event is
- specified, all listeners across all types will be removed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The type of event to remove listeners from.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l152">code &raquo;</a><span class="member"><a name="removeListener">removeListener</a> <span class="args">( type, listenerFn )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Removes a previously registered event listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to unregister.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The handler function to remove.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l35">code &raquo;</a><span class="member"><a name="events_">events_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of events to registered listeners.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>EventEmitter</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/events.js.src.html#l32">View Source</a></div><h1>class EventEmitter</h1><p>Object that can emit events for others to listen for. This is used instead
+of Closure&#39;s event system because it is much more light weight. The API is
+based on Node&#39;s EventEmitters.</p>
+<h3>new EventEmitter()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="addListener" class="function"><div><h3>addListener(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l119">code »</a></span></h3><p>Registers a listener.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="emit" class="function"><div><h3>emit(<wbr>type, var_args)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l47">code »</a></span></h3><p>Fires an event and calls all listeners.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to emit.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to each listener.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="listeners" class="function"><div><h3>listeners(<wbr>type)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l74">code »</a></span></h3><p>Returns a mutable list of listeners for a specific type of event.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to retrieve the listeners for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;{fn: Function, oneshot: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, scope: ?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)}&gt;</code><dd><p>The registered listeners for
+the given event type.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="on" class="function"><div><h3>on(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l145">code »</a></span></h3><p>An alias for <code>#addListener()</code>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="once" class="function"><div><h3>once(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l133">code »</a></span></h3><p>Registers a one-time listener which will be called only the first time an
+event is emitted, after which it will be removed.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="removeAllListeners" class="function"><div><h3>removeAllListeners(<wbr>opt_type)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l176">code »</a></span></h3><p>Removes all listeners for a specific type of event. If no event is
+specified, all listeners across all types will be removed.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The type of event to remove listeners from.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="removeListener" class="function"><div><h3>removeListener(<wbr>type, listenerFn)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l155">code »</a></span></h3><p>Removes a previously registered event listener.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to unregister.</p>
+<dt>listenerFn<code>Function</code><dd><p>The handler function to remove.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_FileDetector.html b/docs/class_webdriver_FileDetector.html
new file mode 100644
index 0000000..678ec82
--- /dev/null
+++ b/docs/class_webdriver_FileDetector.html
@@ -0,0 +1,21 @@
+<!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>FileDetector</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2470">View Source</a></div><h1>class FileDetector</h1><p>Used with <a href="class_webdriver_WebElement.html#sendKeys"><code>WebElement#sendKeys</code></a> on file
+input elements (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>) to detect when the entered key
+sequence defines the path to a file.</p>
+<p>By default, <a href="class_webdriver_WebElement.html">WebElement&#39;s</a> will enter all
+key sequences exactly as entered. You may set a
+<a href="class_webdriver_WebDriver.html#setFileDetector">file detector</a> on the parent
+WebDriver instance to define custom behavior for handling file elements. Of
+particular note is the <a href="module_selenium-webdriver_remote_class_FileDetector.html"><code>selenium-webdriver/remote.FileDetector</code></a>, which
+should be used when running against a remote
+<a href="http://docs.seleniumhq.org/download/">Selenium Server</a>.</p>
+<h3>new FileDetector()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="handleFile" class="function"><div><h3>handleFile(<wbr>driver, path)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2489">code »</a></span></h3><p>Handles the file specified by the given path, preparing it for use with
+the current browser. If the path does not refer to a valid file, it will
+be returned unchanged, otherwisee a path suitable for use with the current
+browser will be returned.</p>
+<p>This default implementation is a no-op. Subtypes may override this
+function for custom tailored file handling.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver for the current browser.</p>
+<dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to process.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise for the processed
+file path.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_FirefoxDomExecutor.html b/docs/class_webdriver_FirefoxDomExecutor.html
index c36dcb1..6057523 100644
--- a/docs/class_webdriver_FirefoxDomExecutor.html
+++ b/docs/class_webdriver_FirefoxDomExecutor.html
@@ -1,2 +1,2 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.FirefoxDomExecutor</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.FirefoxDomExecutor</h1><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l29">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></dl></header><section><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.FirefoxDomExecutor <span class="args">( )</span></span></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_webdriver_FirefoxDomExecutor_Attribute_.html">webdriver.FirefoxDomExecutor.Attribute_</a><dd>Attributes used to communicate with the FirefoxDriver extension.<dt><a href="enum_webdriver_FirefoxDomExecutor_EventType_.html">webdriver.FirefoxDomExecutor.EventType_</a><dd>Events used to communicate with the FirefoxDriver extension.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l90">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( command, callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>command<dt>callback</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l136">code &raquo;</a><span class="member"><a name="onResponse_">onResponse_</a> <span class="args">( )</span></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l39">code &raquo;</a><span class="member"><a name="docElement_">docElement_</a> : <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l36">code &raquo;</a><span class="member"><a name="doc_">doc_</a> : <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l86">code &raquo;</a><span class="member"><a name="pendingCommand_">pendingCommand_</a> : <code class="type">?{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, callback: !<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>}</code></span></div><p>The pending command, if any.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l51">code &raquo;</a><span class="member"><a name="webdriver.FirefoxDomExecutor.isAvailable">webdriver.FirefoxDomExecutor.isAvailable</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the current environment supports the
-     FirefoxDomExecutor.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.FirefoxDomExecutor</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.FirefoxDomExecutor</h1><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l29">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></dl></header><section><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.FirefoxDomExecutor <span class="args">( )</span></span></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_webdriver_FirefoxDomExecutor_Attribute_.html">webdriver.FirefoxDomExecutor.Attribute_</a><dd>Attributes used to communicate with the FirefoxDriver extension.<dt><a href="enum_webdriver_FirefoxDomExecutor_EventType_.html">webdriver.FirefoxDomExecutor.EventType_</a><dd>Events used to communicate with the FirefoxDriver extension.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l90">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( command, callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>command<dt>callback</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l133">code &raquo;</a><span class="member"><a name="onResponse_">onResponse_</a> <span class="args">( )</span></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l39">code &raquo;</a><span class="member"><a name="docElement_">docElement_</a> : <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l36">code &raquo;</a><span class="member"><a name="doc_">doc_</a> : <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l86">code &raquo;</a><span class="member"><a name="pendingCommand_">pendingCommand_</a> : <code class="type">?{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, callback: !<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>}</code></span></div><p>The pending command, if any.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l51">code &raquo;</a><span class="member"><a name="webdriver.FirefoxDomExecutor.isAvailable">webdriver.FirefoxDomExecutor.isAvailable</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the current environment supports the
+     FirefoxDomExecutor.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_Locator.html b/docs/class_webdriver_Locator.html
index c6876e3..8960051 100644
--- a/docs/class_webdriver_Locator.html
+++ b/docs/class_webdriver_Locator.html
@@ -1,2 +1,12 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Locator</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.Locator</h1><a class="source" href="source/lib/webdriver/locators.js.src.html#l35">code &raquo;</a></header><section><p>An element locator.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.Locator <span class="args">( using, value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>using: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of strategy to use for this locator.<dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The search target of this locator.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l249">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l41">code &raquo;</a><span class="member"><a name="using">using</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The search strategy to use when searching for an element.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l47">code &raquo;</a><span class="member"><a name="value">value</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The search target for this locator.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l233">code &raquo;</a><span class="member"><a name="webdriver.Locator.checkLocator">webdriver.Locator.checkLocator</a> <span class="args">( value )</span> &rArr; <code class="type">!(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code></span></div><p>Verifies that a <code >value</code> is a valid locator to use for searching for
- elements on the page.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check is a valid locator.</dl><tr><th>Returns<tr><td><dl>A valid locator object or function.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/TypeError">TypeError</a></code><dd>If the given value is an invalid locator.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l57">code &raquo;</a><span class="member"><a name="webdriver.Locator.factory_">webdriver.Locator.factory_</a> <span class="args">( type )</span> &rArr; <code class="type">function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>): !<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Creates a factory function for a <code  class="type"><a href="class_webdriver_Locator.html">webdriver.Locator</a></code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of locator for the factory.</dl><tr><th>Returns<tr><td><dl>The new factory function.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Locator</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l38">View Source</a></div><h1>class Locator</h1><p>An element locator.</p>
+<h3>new Locator(<wbr>using, value)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>using<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of strategy to use for this locator.</p>
+<dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The search target of this locator.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l253">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></div></div></div></div><h2>Instance Properties</h2><div id="using" class="property"><dl><dt><a href="source/lib/webdriver/locators.js.src.html#l44">using</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The search strategy to use when searching for an element.</p>
+</dl></div><div id="value" class="property"><dl><dt><a href="source/lib/webdriver/locators.js.src.html#l50">value</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The search target for this locator.</p>
+</dl></div><h2>Static Functions</h2><div id="Locator.checkLocator" class="function"><div><h3>Locator.checkLocator(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l237">code »</a></span></h3><p>Verifies that a <code>value</code> is a valid locator to use for searching for
+elements on the page.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to check is a valid locator.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|Function)</code><dd><p>A valid locator object or function.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError">TypeError</a></code><dd><p>If the given value is an invalid locator.</p>
+</dl></div></div></div></div><h2>Static Properties</h2><div id="Locator.Strategy" class="property"><dl><dt><a href="source/lib/webdriver/locators.js.src.html#l216">Locator.Strategy</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>): (Function|<a href="class_webdriver_Locator.html">webdriver.Locator</a>)&gt;</code><dd><p>Maps <a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> keys to the appropriate factory function.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_Serializable.html b/docs/class_webdriver_Serializable.html
new file mode 100644
index 0000000..df789cf
--- /dev/null
+++ b/docs/class_webdriver_Serializable.html
@@ -0,0 +1,9 @@
+<!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>Serializable</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/serializable.js.src.html#l29">View Source</a></div><h1>class Serializable&lt;T&gt;</h1><p>Defines an object that can be asynchronously serialized to its WebDriver
+wire representation.</p>
+<h3>new Serializable()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/lib/webdriver/serializable.js.src.html#l41">code »</a></span></h3><p>Returns either this instance&#39;s serialized represention, if immediately
+available, or a promise for its serialized representation. This function is
+conceptually equivalent to objects that have a <code>toJSON()</code> property,
+except the serialize() result may be a promise or an object containing a
+promise (which are not directly JSON friendly).</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(T|IThenable&lt;T&gt;)</code><dd><p>This instance&#39;s serialized wire format.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_Session.html b/docs/class_webdriver_Session.html
index 5aa83a4..689fa4b 100644
--- a/docs/class_webdriver_Session.html
+++ b/docs/class_webdriver_Session.html
@@ -1,3 +1,13 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Session</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.Session</h1><a class="source" href="source/lib/webdriver/session.js.src.html#l28">code &raquo;</a></header><section><p>Contains information about a WebDriver session.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.Session <span class="args">( id, capabilities )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>id: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The session ID.<dt>capabilities: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>)</code><dd>The session
-     capabilities.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/session.js.src.html#l49">code &raquo;</a><span class="member"><a name="getCapabilities">getCapabilities</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This session's capabilities.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/session.js.src.html#l59">code &raquo;</a><span class="member"><a name="getCapability">getCapability</a> <span class="args">( key )</span> &rArr; <code class="type">*</code></span></div><p>Retrieves the value of a specific capability.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The capability to retrieve.</dl><tr><th>Returns<tr><td><dl>The capability value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/session.js.src.html#l41">code &raquo;</a><span class="member"><a name="getId">getId</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This session's ID.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/session.js.src.html#l69">code &raquo;</a><span class="member"><a name="toJSON">toJSON</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the JSON representation of this object, which is just the string
- session ID.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The JSON representation of this Session.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/session.js.src.html#l34">code &raquo;</a><span class="member"><a name="caps_">caps_</a> : <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/session.js.src.html#l31">code &raquo;</a><span class="member"><a name="id_">id_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Session</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/session.js.src.html#l31">View Source</a></div><h1>class Session</h1><p>Contains information about a WebDriver session.</p>
+<h3>new Session(<wbr>id, capabilities)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>id<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The session ID.</p>
+<dt>capabilities<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>The session
+capabilities.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/session.js.src.html#l52">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>This session&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapability" class="function"><div><h3>getCapability(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/session.js.src.html#l62">code »</a></span></h3><p>Retrieves the value of a specific capability.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The capability to retrieve.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><p>The capability value.</p>
+</div></div></div></div><hr class="fn-sep"><div id="getId" class="function"><div><h3>getId()<span class="codelink"><a href="source/lib/webdriver/session.js.src.html#l44">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>This session&#39;s ID.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toJSON" class="function"><div><h3>toJSON(<wbr>arg0)<span class="codelink"><a href="source/lib/webdriver/session.js.src.html#l72">code »</a></span></h3><p>Returns the JSON representation of this object, which is just the string
+session ID.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arg0<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The JSON representation of this Session.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_TouchSequence.html b/docs/class_webdriver_TouchSequence.html
new file mode 100644
index 0000000..5ea0593
--- /dev/null
+++ b/docs/class_webdriver_TouchSequence.html
@@ -0,0 +1,49 @@
+<!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>TouchSequence</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l41">View Source</a></div><h1>class TouchSequence</h1><p>Class for defining sequences of user touch interactions. Each sequence
+will not be executed until <a href="class_webdriver_TouchSequence.html#perform"><code>#perform</code></a> is called.</p>
+<p>Example:</p>
+<pre><code>new webdriver.TouchSequence(driver).
+    tapAndHold({x: 0, y: 0}).
+    move({x: 3, y: 4}).
+    release({x: 10, y: 10}).
+    perform();
+</code></pre>
+<h3>new TouchSequence(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver instance to use.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="doubleTap" class="function"><div><h3>doubleTap(<wbr>elem)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l106">code »</a></span></h3><p>Double taps an element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>elem<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to double tap.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="flick" class="function"><div><h3>flick(<wbr>speed)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l220">code »</a></span></h3><p>Flick, starting anywhere on the screen, at speed xspeed and yspeed.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>speed<code>{xspeed: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, yspeed: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code><dd><p>The speed to flick in each
+direction, in pixels per second.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="flickElement" class="function"><div><h3>flickElement(<wbr>elem, offset, speed)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l238">code »</a></span></h3><p>Flick starting at elem and moving by x and y at specified speed.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>elem<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element where flick starts.</p>
+<dt>offset<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code><dd><p>The offset to flick to.</p>
+<dt>speed<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The speed to flick at in pixels per second.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="longPress" class="function"><div><h3>longPress(<wbr>elem)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l121">code »</a></span></h3><p>Long press on an element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>elem<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to long press.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="move" class="function"><div><h3>move(<wbr>location)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l152">code »</a></span></h3><p>Move a held <a href="class_webdriver_TouchSequence.html#tapAndHold">touch</a> to the specified location.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>location<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code><dd><p>The location to move to.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="perform" class="function"><div><h3>perform()<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l71">code »</a></span></h3><p>Executes this action sequence.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved once
+this sequence has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="release" class="function"><div><h3>release(<wbr>location)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l168">code »</a></span></h3><p>Release a held <a href="class_webdriver_TouchSequence.html#tapAndHold">touch</a> at the specified location.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>location<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code><dd><p>The location to release at.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="scroll" class="function"><div><h3>scroll(<wbr>offset)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l184">code »</a></span></h3><p>Scrolls the touch screen by the given offset.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>offset<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code><dd><p>The offset to scroll to.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="scrollFromElement" class="function"><div><h3>scrollFromElement(<wbr>elem, offset)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l202">code »</a></span></h3><p>Scrolls the touch screen, starting on <code>elem</code> and moving by the specified
+offset.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>elem<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element where scroll starts.</p>
+<dt>offset<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code><dd><p>The offset to scroll to.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="tap" class="function"><div><h3>tap(<wbr>elem)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l91">code »</a></span></h3><p>Taps an element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>elem<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to tap.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="tapAndHold" class="function"><div><h3>tapAndHold(<wbr>location)<span class="codelink"><a href="source/lib/webdriver/touchsequence.js.src.html#l136">code »</a></span></h3><p>Touch down at the given location.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>location<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code><dd><p>The location to touch down at.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_UnhandledAlertError.html b/docs/class_webdriver_UnhandledAlertError.html
index c8c53b4..e2ea0ca 100644
--- a/docs/class_webdriver_UnhandledAlertError.html
+++ b/docs/class_webdriver_UnhandledAlertError.html
@@ -1,6 +1,18 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.UnhandledAlertError</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.UnhandledAlertError</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2079">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
+<!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>UnhandledAlertError</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2435">View Source</a></div><h1>class UnhandledAlertError</h1><pre class="inheritance"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>
   &#x2514; <a href="class_bot_Error.html">bot.Error</a>
-      &#x2514; webdriver.UnhandledAlertError</code></pre></header><section><p>An error returned to indicate that there is an unhandled modal dialog on the
- current page.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.UnhandledAlertError <span class="args">( message, alert )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The error message.<dt>alert: <code class="type">!<a href="class_webdriver_Alert.html">webdriver.Alert</a></code><dd>The alert handle.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.UnhandledAlertError</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2091">code &raquo;</a><span class="member"><a name="getAlert">getAlert</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Alert.html">webdriver.Alert</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The open alert.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_bot_Error.html">bot.Error</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/error.js.src.html#l202">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>he string representation of this error.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.UnhandledAlertError</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2083">code &raquo;</a><span class="member"><a name="alert_">alert_</a> : <code class="type">!<a href="class_webdriver_Alert.html">webdriver.Alert</a></code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_bot_Error.html">bot.Error</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/error.js.src.html#l197">code &raquo;</a><span class="member"><a name="isAutomationError">isAutomationError</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Flag used for duck-typing when this code is embedded in a Firefox extension.
- This is required since an Error thrown in one component and then reported
- to another will fail instanceof checks in the second component.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/error.js.src.html#l86">code &raquo;</a><span class="member"><a name="state">state</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l2079">code &raquo;</a><span class="member"><a name="webdriver.UnhandledAlertError.superClass_">webdriver.UnhandledAlertError.superClass_</a> : <code class="type"><a href="class_bot_Error.html">bot.Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+      &#x2514; webdriver.UnhandledAlertError</pre><p>An error returned to indicate that there is an unhandled modal dialog on the
+current page.</p>
+<h3>new UnhandledAlertError(<wbr>message, text, alert)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The error message.</p>
+<dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The text displayed with the unhandled alert.</p>
+<dt>alert<code><a href="class_webdriver_Alert.html">webdriver.Alert</a></code><dd><p>The alert handle.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getAlertText" class="function"><div><h3>getAlertText()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2451">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The text displayed with the unhandled alert.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/atoms/error.js.src.html#l199">code »</a></span></h3><p><b>Defined by: </b><a href="class_bot_Error.html#toString">bot.Error</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string representation of this error.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="code" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l82">code</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>This error&#39;s status code.</p>
+</dl></div><div id="description" class="property"><dl><dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>IE-only.</p>
+</dl></div><div id="fileName" class="property"><dl><dt>fileName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Mozilla-only</p>
+</dl></div><div id="isAutomationError" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l194">isAutomationError</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Flag used for duck-typing when this code is embedded in a Firefox extension.
+This is required since an Error thrown in one component and then reported
+to another will fail instanceof checks in the second component.</p>
+</dl></div><div id="lineNumber" class="property"><dl><dt>lineNumber<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>Mozilla-only.</p>
+</dl></div><div id="message" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l89">message</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="name" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l104">name</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="sourceURL" class="property"><dl><dt>sourceURL<code>?</code><dd><p>Doesn&#39;t seem to exist, but closure/debug.js references it.</p>
+</dl></div><div id="stack" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l112">stack</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="state" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l85">state</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebDriver.html b/docs/class_webdriver_WebDriver.html
index 4607477..9d778c4 100644
--- a/docs/class_webdriver_WebDriver.html
+++ b/docs/class_webdriver_WebDriver.html
@@ -1,251 +1,313 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.WebDriver</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.WebDriver</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l74">code &raquo;</a></header><section><p>Creates a new WebDriver client, which provides control over a browser.
+<!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>WebDriver</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l82">View Source</a></div><h1>class WebDriver</h1><p>Creates a new WebDriver client, which provides control over a browser.</p>
+<p>Every WebDriver command returns a <code>webdriver.promise.Promise</code> that
+represents the result of that command. Callbacks may be registered on this
+object to manipulate the command result or catch an expected error. Any
+commands scheduled with a callback are considered sub-commands and will
+execute before the next command in the current frame. For example:</p>
+<pre><code>var message &#61; [];
+driver.call(message.push, message, &#39;a&#39;).then(function() {
+  driver.call(message.push, message, &#39;b&#39;);
+});
+driver.call(message.push, message, &#39;c&#39;);
+driver.call(function() {
+  alert(&#39;message is abc? &#39; &#43; (message.join(&#39;&#39;) &#61;&#61; &#39;abc&#39;));
+});
+</code></pre>
+<h3>new WebDriver(<wbr>session, executor, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>session<code>(<a href="class_webdriver_Session.html">webdriver.Session</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code><dd><p>Either a
+known session or a promise that will be resolved to a session.</p>
+<dt>executor<code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd><p>The executor to use when
+sending commands to the browser.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The flow to
+schedule commands through. Defaults to the active flow object.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="actions" class="function"><div><h3>actions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l469">code »</a></span></h3><p>Creates a new action sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_ActionSequence.html#perform"><code>webdriver.ActionSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.actions().
+    mouseDown(element1).
+    mouseMove(element2).
+    mouseUp().
+    perform();
+</code></pre>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A new action sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="call" class="function"><div><h3><code>&lt;T&gt;</code> call(<wbr>fn, opt_scope, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l639">code »</a></span></h3><p>Schedules a command to execute a custom function.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(...?): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+execute.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to execute the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved&#39;
+with the function&#39;s result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="close" class="function"><div><h3>close()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l780">code »</a></span></h3><p>Schedules a command to close the current window.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l324">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow used by this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeAsyncScript" class="function"><div><h3><code>&lt;T&gt;</code> executeAsyncScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l617">code »</a></span></h3><p>Schedules a command to execute asynchronous JavaScript in the context of the
+currently selected frame or window. The script fragment will be executed as
+the body of an anonymous function. If the script is provided as a function
+object, that function will be converted to a string for injection into the
+target window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>Unlike executing synchronous JavaScript with <a href="class_webdriver_WebDriver.html#executeScript"><code>#executeScript</code></a>,
+scripts executed with this function must explicitly signal they are finished
+by invoking the provided callback. This callback will always be injected
+into the executed function as the last argument, and thus may be referenced
+with <code>arguments[arguments.length - 1]</code>. The following steps will be
+taken for resolving this functions return value against the first argument
+to the script&#39;s callback function:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><strong>Example #1:</strong> Performing a sleep that is synchronized with the currently
+selected window:</p>
+<pre><code>var start &#61; new Date().getTime();
+driver.executeAsyncScript(
+    &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).
+    then(function() {
+      console.log(
+          &#39;Elapsed time: &#39; &#43; (new Date().getTime() - start) &#43; &#39; ms&#39;);
+    });
+</code></pre>
+<p><strong>Example #2:</strong> Synchronizing a test with an AJAX application:</p>
+<pre><code>var button &#61; driver.findElement(By.id(&#39;compose-button&#39;));
+button.click();
+driver.executeAsyncScript(
+    &#39;var callback &#61; arguments[arguments.length - 1];&#39; &#43;
+    &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);
+driver.switchTo().frame(&#39;composeWidget&#39;);
+driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog&#64;example.com&#39;);
+</code></pre>
+<p><strong>Example #3:</strong> Injecting a XMLHttpRequest and waiting for the result. In
+this example, the inject script is specified with a function literal. When
+using this format, the function is converted to a string for injection, so it
+should not reference any symbols not defined in the scope of the page under
+test.</p>
+<pre><code>driver.executeAsyncScript(function() {
+  var callback &#61; arguments[arguments.length - 1];
+  var xhr &#61; new XMLHttpRequest();
+  xhr.open(&#34;GET&#34;, &#34;/resource/data.json&#34;, true);
+  xhr.onreadystatechange &#61; function() {
+    if (xhr.readyState &#61;&#61; 4) {
+      callback(xhr.responseText);
+    }
+  }
+  xhr.send(&#39;&#39;);
+}).then(function(str) {
+  console.log(JSON.parse(str)[&#39;food&#39;]);
+});
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeScript" class="function"><div><h3><code>&lt;T&gt;</code> executeScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l528">code »</a></span></h3><p>Schedules a command to execute JavaScript in the context of the currently
+selected frame or window. The script fragment will be executed as the body
+of an anonymous function. If the script is provided as a function object,
+that function will be converted to a string for injection into the target
+window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>The script may refer to any variables accessible from the current window.
+Furthermore, the script will execute in the window&#39;s context, thus
+<code>document</code> may be used to refer to the current document. Any local
+variables will not be available once the script has finished executing,
+though global variables will persist.</p>
+<p>If the script has a return value (i.e. if the script contains a return
+statement), then the following steps will be taken for resolving this
+functions return value:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l867">code »</a></span></h3><p>Schedule a command to find an element on the page. If the element cannot be
+found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will be returned
+by the driver. Unlike other commands, this error cannot be suppressed. In
+other words, scheduling a command to find an element doubles as an assert
+that the element is present on the page. To test whether an element is
+present on the page, use <a href="class_webdriver_WebDriver.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; driver.findElement(firstVisibleLink);
 
- Every WebDriver command returns a <code >webdriver.promise.Promise</code> that
- represents the result of that command. Callbacks may be registered on this
- object to manipulate the command result or catch an expected error. Any
- commands scheduled with a callback are considered sub-commands and will
- execute before the next command in the current frame. For example:
- <pre><code>
-   var message = [];
-   driver.call(message.push, message, 'a').then(function() {
-     driver.call(message.push, message, 'b');
-   });
-   driver.call(message.push, message, 'c');
-   driver.call(function() {
-     alert('message is abc? ' + (message.join('') == 'abc'));
-   });
- </code></pre><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.WebDriver <span class="args">( session, executor, opt_flow )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>session: <code class="type">!(<a href="class_webdriver_Session.html">webdriver.Session</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code><dd>Either a
-     known session or a promise that will be resolved to a session.<dt>executor: <code class="type">!<a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd>The executor to use when
-     sending commands to the browser.<dt>opt_flow: <code class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd>The flow to
-     schedule commands through. Defaults to the active flow object.</dl></table></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_WebDriver_Logs.html">webdriver.WebDriver.Logs</a><dd>Interface for managing WebDriver log records.<dt><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a><dd>Interface for navigating back and forth in the browser history.<dt><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a><dd>Provides methods for managing browser and driver state.<dt><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a><dd>An interface for changing the focus of the driver to another frame or window.<dt><a href="class_webdriver_WebDriver_Timeouts.html">webdriver.WebDriver.Timeouts</a><dd>An interface for managing timeout behavior for WebDriver instances.<dt><a href="class_webdriver_WebDriver_Window.html">webdriver.WebDriver.Window</a><dd>An interface for managing the current window.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l355">code &raquo;</a><span class="member"><a name="actions">actions</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></span></div><p>Creates a new action sequence using this driver. The sequence will not be
- scheduled for execution until <code  class="type"><a href="class_webdriver_ActionSequence.html#perform">webdriver.ActionSequence#perform</a></code> is
- called. Example:
- <pre><code>
-   driver.actions().
-       mouseDown(element1).
-       mouseMove(element2).
-       mouseUp().
-       perform();
- </code></pre></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new action sequence for this instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l508">code &raquo;</a><span class="member"><a name="call">call</a> <span class="args">( fn, opt_scope, var_args )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to execute a custom function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to execute.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to execute the function.<dt>var_args: <code class="type">...*</code><dd>Any arguments to pass to the function.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     function's result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l590">code &raquo;</a><span class="member"><a name="close">close</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to close the current window.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     this command has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l247">code &raquo;</a><span class="member"><a name="controlFlow">controlFlow</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The control flow used by this
-     instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l488">code &raquo;</a><span class="member"><a name="executeAsyncScript">executeAsyncScript</a> <span class="args">( script, var_args )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to execute asynchronous JavaScript in the context of the
- currently selected frame or window. The script fragment will be executed as
- the body of an anonymous function. If the script is provided as a function
- object, that function will be converted to a string for injection into the
- target window.
-
- Any arguments provided in addition to the script will be included as script
- arguments and may be referenced using the <code >arguments</code> object.
- Arguments may be a boolean, number, string, or <code >webdriver.WebElement</code>.
- Arrays and objects may also be used as script arguments as long as each item
- adheres to the types previously mentioned.
-
- Unlike executing synchronous JavaScript with
- <code >webdriver.WebDriver.prototype.executeScript</code>, scripts executed with
- this function must explicitly signal they are finished by invoking the
- provided callback. This callback will always be injected into the
- executed function as the last argument, and thus may be referenced with
- <code >arguments[arguments.length - 1]</code>. The following steps will be taken
- for resolving this functions return value against the first argument to the
- script's callback function:
- <ul>
- <li>For a HTML element, the value will resolve to a
-     <code >webdriver.WebElement</code></li>
- <li>Null and undefined return values will resolve to null</li>
- <li>Booleans, numbers, and strings will resolve as is</li>
- <li>Functions will resolve to their string representation</li>
- <li>For arrays and objects, each member item will be converted according to
-     the rules above</li>
- </ul>
-
- Example #1: Performing a sleep that is synchronized with the currently
- selected window:
- <code><pre>
- var start = new Date().getTime();
- driver.executeAsyncScript(
-     'window.setTimeout(arguments[arguments.length - 1], 500);').
-     then(function() {
-       console.log('Elapsed time: ' + (new Date().getTime() - start) + ' ms');
-     });
- </pre></code>
-
- Example #2: Synchronizing a test with an AJAX application:
- <code><pre>
- var button = driver.findElement(By.id('compose-button'));
- button.click();
- driver.executeAsyncScript(
-     'var callback = arguments[arguments.length - 1];' +
-     'mailClient.getComposeWindowWidget().onload(callback);');
- driver.switchTo().frame('composeWidget');
- driver.findElement(By.id('to')).sendKEys('dog@example.com');
- </pre></code>
-
- Example #3: Injecting a XMLHttpRequest and waiting for the result. In this
- example, the inject script is specified with a function literal. When using
- this format, the function is converted to a string for injection, so it
- should not reference any symbols not defined in the scope of the page under
- test.
- <code><pre>
- driver.executeAsyncScript(function() {
-   var callback = arguments[arguments.length - 1];
-   var xhr = new XMLHttpRequest();
-   xhr.open("GET", "/resource/data.json", true);
-   xhr.onreadystatechange = function() {
-     if (xhr.readyState == 4) {
-       callback(xhr.resposneText);
-     }
-   }
-   xhr.send('');
- }).then(function(str) {
-   console.log(JSON.parse(str)['food']);
- });
- </pre></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>script: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The script to execute.<dt>var_args: <code class="type">...*</code><dd>The arguments to pass to the script.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve to the
-    scripts return value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l397">code &raquo;</a><span class="member"><a name="executeScript">executeScript</a> <span class="args">( script, var_args )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to execute JavaScript in the context of the currently
- selected frame or window. The script fragment will be executed as the body
- of an anonymous function. If the script is provided as a function object,
- that function will be converted to a string for injection into the target
- window.
-
- Any arguments provided in addition to the script will be included as script
- arguments and may be referenced using the <code >arguments</code> object.
- Arguments may be a boolean, number, string, or <code >webdriver.WebElement</code>.
- Arrays and objects may also be used as script arguments as long as each item
- adheres to the types previously mentioned.
-
- The script may refer to any variables accessible from the current window.
- Furthermore, the script will execute in the window's context, thus
- <code >document</code> may be used to refer to the current document. Any local
- variables will not be available once the script has finished executing,
- though global variables will persist.
-
- If the script has a return value (i.e. if the script contains a return
- statement), then the following steps will be taken for resolving this
- functions return value:
- <ul>
- <li>For a HTML element, the value will resolve to a
-     <code >webdriver.WebElement</code></li>
- <li>Null and undefined return values will resolve to null</li>
- <li>Booleans, numbers, and strings will resolve as is</li>
- <li>Functions will resolve to their string representation</li>
- <li>For arrays and objects, each member item will be converted according to
-     the rules above</li>
- </ul></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>script: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The script to execute.<dt>var_args: <code class="type">...*</code><dd>The arguments to pass to the script.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve to the
-    scripts return value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l742">code &raquo;</a><span class="member"><a name="findDomElement_">findDomElement_</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Locates a DOM element so that commands may be issued against it using the
- <code  class="type"><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code> class. This is accomplished by storing a
- reference to the element in an object on the element's ownerDocument.
- <code  class="type"><a class="unresolved-link">#executeScript</a></code> will then be used to create a WebElement from this
- reference. This requires this driver to currently be focused on the
- ownerDocument's window+frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to locate.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved
-     with the located WebElement.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l679">code &raquo;</a><span class="member"><a name="findElement">findElement</a> <span class="args">( locator )</span> &rArr; <code class="type">!<a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code></span></div><p>Schedule a command to find an element on the page. If the element cannot be
- found, a <code  class="type"><a href="enum_bot_ErrorCode.html#bot.ErrorCode.NO_SUCH_ELEMENT">bot.ErrorCode.NO_SUCH_ELEMENT</a></code> result will be returned
- by the driver. Unlike other commands, this error cannot be suppressed. In
- other words, scheduling a command to find an element doubles as an assert
- that the element is present on the page. To test whether an element is
- present on the page, use <code  class="type"><a class="unresolved-link">#isElementPresent</a></code> instead.
-
- <p>The search criteria for an element may be defined using one of the
- factories in the <code  class="type"><a href="namespace_webdriver_By.html">webdriver.By</a></code> namespace, or as a short-hand
- <code  class="type"><a href="namespace_webdriver_By.html#webdriver.By.Hash">webdriver.By.Hash</a></code> object. For example, the following two statements
- are equivalent:
- <code><pre>
- var e1 = driver.findElement(By.id('foo'));
- var e2 = driver.findElement({id:'foo'});
- </pre></code>
-
- <p>You may also provide a custom locator function, which takes as input
- this WebDriver instance and returns a <code  class="type"><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code>, or a
- promise that will resolve to a WebElement. For example, to find the first
- visible link on a page, you could write:
- <code><pre>
- var link = driver.findElement(firstVisibleLink);
-
- function firstVisibleLink(driver) {
-   var links = driver.findElements(By.tagName('a'));
-   return webdriver.promise.filter(links, function(link) {
-     return links.isDisplayed();
-   }).then(function(visibleLinks) {
-     return visibleLinks[0];
-   });
- }
- </pre></code>
-
- <p>When running in the browser, a WebDriver cannot manipulate DOM elements
- directly; it may do so only through a <code  class="type"><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code> reference.
- This function may be used to generate a WebElement from a DOM element. A
- reference to the DOM element will be stored in a known location and this
- driver will attempt to retrieve it through <code  class="type"><a class="unresolved-link">#executeScript</a></code>. If the
- element cannot be found (eg, it belongs to a different document than the
- one this instance is currently focused on), a
- <code  class="type"><a href="enum_bot_ErrorCode.html#bot.ErrorCode.NO_SUCH_ELEMENT">bot.ErrorCode.NO_SUCH_ELEMENT</a></code> error will be returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>locator: <code class="type">!(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|<a href="namespace_webdriver_By.html#webdriver.By.Hash">webdriver.By.Hash</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The
-     locator to use.</dl><tr><th>Returns<tr><td><dl>A WebElement that can be used to issue
-     commands against the located element. If the element is not found, the
-     element will be invalidated and all scheduled commands aborted.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l715">code &raquo;</a><span class="member"><a name="findElementInternal_">findElementInternal_</a> <span class="args">( locatorFn, context )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>locatorFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The locator function to use.<dt>context: <code class="type">!(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>|<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>)</code><dd>The search
-     context.</dl><tr><th>Returns<tr><td><dl>A
-     promise that will resolve to a list of WebElements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l809">code &raquo;</a><span class="member"><a name="findElements">findElements</a> <span class="args">( locator )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedule a command to search for multiple elements on the page.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>locator: <code class="type">!(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|<a href="namespace_webdriver_By.html#webdriver.By.Hash">webdriver.By.Hash</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The locator
-     strategy to use when searching for the element.</dl><tr><th>Returns<tr><td><dl>A
-     promise that will resolve to an array of WebElements.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l830">code &raquo;</a><span class="member"><a name="findElementsInternal_">findElementsInternal_</a> <span class="args">( locatorFn, context )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>locatorFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The locator function to use.<dt>context: <code class="type">!(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>|<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>)</code><dd>The search
-     context.</dl><tr><th>Returns<tr><td><dl>A
-     promise that will resolve to an array of WebElements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l602">code &raquo;</a><span class="member"><a name="get">get</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to navigate to the given URL.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The fully qualified URL to open.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     document has finished loading.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l563">code &raquo;</a><span class="member"><a name="getAllWindowHandles">getAllWindowHandles</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve the current list of available window handles.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with an
-     array of window handles.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l316">code &raquo;</a><span class="member"><a name="getCapabilities">getCapabilities</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will resolve with the
-     this instance's capabilities.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l612">code &raquo;</a><span class="member"><a name="getCurrentUrl">getCurrentUrl</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve the URL of the current page.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     current URL.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l578">code &raquo;</a><span class="member"><a name="getPageSource">getPageSource</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve the current page's source. The page source
- returned is a representation of the underlying DOM: do not expect it to be
- formatted or escaped in the same way as the response sent from the web
- server.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     current page source.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l307">code &raquo;</a><span class="member"><a name="getSession">getSession</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise for this client's session.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l624">code &raquo;</a><span class="member"><a name="getTitle">getTitle</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve the current page's title.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     current page's title.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l551">code &raquo;</a><span class="member"><a name="getWindowHandle">getWindowHandle</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve they current window handle.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     current window handle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l790">code &raquo;</a><span class="member"><a name="isElementPresent">isElementPresent</a> <span class="args">( locatorOrElement )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code></span></div><p>Schedules a command to test if an element is present on the page.
-
- <p>If given a DOM element, this function will check if it belongs to the
- document the driver is currently focused on. Otherwise, the function will
- test if at least one element can be found with the given search criteria.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>locatorOrElement: <code class="type">!(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|<a href="namespace_webdriver_By.html#webdriver.By.Hash">webdriver.By.Hash</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The locator to use, or the actual
-     DOM element to be located by the server.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve
-     with whether the element is present on the page.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l871">code &raquo;</a><span class="member"><a name="manage">manage</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The options interface for this
-     instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l880">code &raquo;</a><span class="member"><a name="navigate">navigate</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The navigation interface for this
-     instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l330">code &raquo;</a><span class="member"><a name="quit">quit</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to quit the current session. After calling quit, this
- instance will be invalidated and may no longer be used to issue commands
- against the browser.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the command has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l260">code &raquo;</a><span class="member"><a name="schedule">schedule</a> <span class="args">( command, description )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a <code >webdriver.Command</code> to be executed by this driver's
- <code >webdriver.CommandExecutor</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>command: <code class="type">!<a href="class_webdriver_Command.html">webdriver.Command</a></code><dd>The command to schedule.<dt>description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A description of the command for debugging.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with
-     the command result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l541">code &raquo;</a><span class="member"><a name="sleep">sleep</a> <span class="args">( ms )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to make the driver sleep for the given amount of time.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ms: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The amount of time, in milliseconds, to sleep.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     sleep has finished.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l889">code &raquo;</a><span class="member"><a name="switchTo">switchTo</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The target locator interface for
-     this instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l861">code &raquo;</a><span class="member"><a name="takeScreenshot">takeScreenshot</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedule a command to take a screenshot. The driver makes a best effort to
- return a screenshot of the following, in order of preference:
- <ol>
-   <li>Entire page
-   <li>Current window
-   <li>Visible portion of the current frame
-   <li>The screenshot of the entire display containing the browser
- </ol></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved to the
-     screenshot as a base-64 encoded PNG.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l530">code &raquo;</a><span class="member"><a name="wait">wait</a> <span class="args">( fn, timeout, opt_message )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to wait for a condition to hold, as defined by some
- user supplied function. If any errors occur while evaluating the wait, they
- will be allowed to propagate.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to evaluate as a wait condition.<dt>timeout: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>How long to wait for the condition to be true.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>An optional message to use if the wait times
-     out.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     wait condition has been satisfied.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l80">code &raquo;</a><span class="member"><a name="executor_">executor_</a> : <code class="type">!<a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l83">code &raquo;</a><span class="member"><a name="flow_">flow_</a> : <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l77">code &raquo;</a><span class="member"><a name="session_">session_</a> : <code class="type">!(<a href="class_webdriver_Session.html">webdriver.Session</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code></span></div></summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l130">code &raquo;</a><span class="member"><a name="webdriver.WebDriver.acquireSession_">webdriver.WebDriver.acquireSession_</a> <span class="args">( executor, command, description )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div><p>Sends a command to the server that is expected to return the details for a
- <code  class="type"><a href="class_webdriver_Session.html">webdriver.Session</a></code>. This may either be an existing session, or a
- newly created one.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>executor: <code class="type">!<a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd>Command executor to use when
-     querying for session details.<dt>command: <code class="type">!<a href="class_webdriver_Command.html">webdriver.Command</a></code><dd>The command to send to fetch the session
-     details.<dt>description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A descriptive debug label for this action.</dl><tr><th>Returns<tr><td><dl>A new WebDriver client for the session.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l94">code &raquo;</a><span class="member"><a name="webdriver.WebDriver.attachToSession">webdriver.WebDriver.attachToSession</a> <span class="args">( executor, sessionId )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div><p>Creates a new WebDriver client for an existing session.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>executor: <code class="type">!<a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd>Command executor to use when
-     querying for session details.<dt>sessionId: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>ID of the session to attach to.</dl><tr><th>Returns<tr><td><dl>A new client for the specified session.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l110">code &raquo;</a><span class="member"><a name="webdriver.WebDriver.createSession">webdriver.WebDriver.createSession</a> <span class="args">( executor, desiredCapabilities )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div><p>Creates a new WebDriver session.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>executor: <code class="type">!<a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd>The executor to create the new
-     session with.<dt>desiredCapabilities: <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd>The desired
-     capabilities for the new session.</dl><tr><th>Returns<tr><td><dl>The driver for the newly created session.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l232">code &raquo;</a><span class="member"><a name="webdriver.WebDriver.executeCommand_">webdriver.WebDriver.executeCommand_</a> <span class="args">( executor, command )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Translates a command to its wire-protocol representation before passing it
- to the given <code >executor</code> for execution.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>executor: <code class="type">!<a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd>The executor to use.<dt>command: <code class="type">!<a href="class_webdriver_Command.html">webdriver.Command</a></code><dd>The command to execute.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve with the
-     command response.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l206">code &raquo;</a><span class="member"><a name="webdriver.WebDriver.fromWireValue_">webdriver.WebDriver.fromWireValue_</a> <span class="args">( driver, value )</span> &rArr; <code class="type">*</code></span></div><p>Converts a value from its JSON representation according to the WebDriver wire
- protocol. Any JSON object containing a
- <code >webdriver.WebElement.ELEMENT_KEY</code> key will be decoded to a
- <code >webdriver.WebElement</code> object. All other values will be passed through
- as is.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The driver instance to use as the
-     parent of any unwrapped <code >webdriver.WebElement</code> values.<dt>value: <code class="type">*</code><dd>The value to convert.</dl><tr><th>Returns<tr><td><dl>The converted value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l162">code &raquo;</a><span class="member"><a name="webdriver.WebDriver.toWireValue_">webdriver.WebDriver.toWireValue_</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Converts an object to its JSON representation in the WebDriver wire protocol.
- When converting values of type object, the following steps will be taken:
- <ol>
- <li>if the object provides a "toWireValue" function, the return value will
-     be returned in its fully resolved state (e.g. this function may return
-     promise values)</li>
- <li>if the object provides a "toJSON" function, the return value of this
-     function will be returned</li>
- <li>otherwise, the value of each key will be recursively converted according
-     to the rules above.</li>
- </ol></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The object to convert.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve to the
-     input value's JSON representation.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+function firstVisibleLink(driver) {
+  var links &#61; driver.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p>When running in the browser, a WebDriver cannot manipulate DOM elements
+directly; it may do so only through a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> reference.
+This function may be used to generate a WebElement from a DOM element. A
+reference to the DOM element will be stored in a known location and this
+driver will attempt to retrieve it through <a href="class_webdriver_WebDriver.html#executeScript"><code>#executeScript</code></a>. If the
+element cannot be found (eg, it belongs to a different document than the
+one this instance is currently focused on), a
+<a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error will be returned.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l994">code »</a></span></h3><p>Schedule a command to search for multiple elements on the page.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l792">code »</a></span></h3><p>Schedules a command to navigate to the given URL.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The fully qualified URL to open.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the document has finished loading.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAllWindowHandles" class="function"><div><h3>getAllWindowHandles()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l753">code »</a></span></h3><p>Schedules a command to retrieve the current list of available window handles.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;&gt;</code><dd><p>A promise that will
+be resolved with an array of window handles.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l430">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>&gt;</code><dd><p>A promise
+that will resolve with the this instance&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCurrentUrl" class="function"><div><h3>getCurrentUrl()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l802">code »</a></span></h3><p>Schedules a command to retrieve the URL of the current page.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current URL.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPageSource" class="function"><div><h3>getPageSource()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l768">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s source. The page source
+returned is a representation of the underlying DOM: do not expect it to be
+formatted or escaped in the same way as the response sent from the web
+server.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page source.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSession" class="function"><div><h3>getSession()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l421">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Session.html">webdriver.Session</a>&gt;</code><dd><p>A promise for this
+client&#39;s session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTitle" class="function"><div><h3>getTitle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l814">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s title.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page&#39;s title.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWindowHandle" class="function"><div><h3>getWindowHandle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l741">code »</a></span></h3><p>Schedules a command to retrieve they current window handle.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current window handle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locatorOrElement)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l974">code »</a></span></h3><p>Schedules a command to test if an element is present on the page.</p>
+<p>If given a DOM element, this function will check if it belongs to the
+document the driver is currently focused on. Otherwise, the function will
+test if at least one element can be found with the given search criteria.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locatorOrElement<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator to use, or the actual
+DOM element to be located by the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the element is present on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manage" class="function"><div><h3>manage()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1056">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code><dd><p>The options interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="navigate" class="function"><div><h3>navigate()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1065">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code><dd><p>The navigation interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="quit" class="function"><div><h3>quit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l444">code »</a></span></h3><p>Schedules a command to quit the current session. After calling quit, this
+instance will be invalidated and may no longer be used to issue commands
+against the browser.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="schedule" class="function"><div><h3><code>&lt;T&gt;</code> schedule(<wbr>command, description)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l338">code »</a></span></h3><p>Schedules a <code>webdriver.Command</code> to be executed by this driver&#39;s
+<code>webdriver.CommandExecutor</code>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to schedule.</p>
+<dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of the command for debugging.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the command result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFileDetector" class="function"><div><h3>setFileDetector(<wbr>detector)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l407">code »</a></span></h3><p>Sets the <a href="class_webdriver_FileDetector.html">file detector</a> that should be
+used with this instance.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detector<code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code><dd><p>The detector to use or <code>null</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sleep" class="function"><div><h3>sleep(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l731">code »</a></span></h3><p>Schedules a command to make the driver sleep for the given amount of time.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to sleep.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the sleep has finished.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="switchTo" class="function"><div><h3>switchTo()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1074">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code><dd><p>The target locator interface for
+this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="takeScreenshot" class="function"><div><h3>takeScreenshot()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1046">code »</a></span></h3><p>Schedule a command to take a screenshot. The driver makes a best effort to
+return a screenshot of the following, in order of preference:</p>
+<ol><li>Entire page
+  </li><li>Current window
+  </li><li>Visible portion of the current frame
+  </li><li>The screenshot of the entire display containing the browser
+</li></ol>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the screenshot as a base-64 encoded PNG.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="touchActions" class="function"><div><h3>touchActions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l486">code »</a></span></h3><p>Creates a new touch sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_TouchSequence.html#perform"><code>webdriver.TouchSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.touchActions().
+    tap(element1).
+    doubleTap(element2).
+    perform();
+</code></pre>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A new touch sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l700">code »</a></span></h3><p>Schedules a command to wait for a condition to hold. The condition may be
+specified by a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a>, as a custom function, or
+as a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>.</p>
+<p>For a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a> or function, the wait will repeatedly
+evaluate the condition until it returns a truthy value. If any errors occur
+while evaluating the condition, they will be allowed to propagate. In the
+event a condition returns a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>, the
+polling loop will wait for it to be resolved and use the resolved value for
+whether the condition has been satisified. Note the resolution time for
+a promise is factored into whether a wait has timed out.</p>
+<p><em>Example:</em> waiting up to 10 seconds for an element to be present and visible
+on the page.</p>
+<pre><code>var button &#61; driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);
+button.click();
+</code></pre>
+<p>This function may also be used to block the command flow on the resolution
+of a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>. When given a promise, the
+command will simply wait for its resolution before completing. A timeout may
+be provided to fail the command if the promise does not resolve before the
+timeout expires.</p>
+<p><em>Example:</em> Suppose you have a function, <code>startTestServer</code>, that returns a
+promise for when a server is ready for requests. You can block a <code>WebDriver</code>
+client on this promise with:</p>
+<pre><code>var started &#61; startTestServer();
+driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);
+driver.get(getServerUrl());
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|<a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;T&gt;|function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): T)</code><dd><p>The condition to
+wait on, defined as a promise, condition object, or  a function to
+evaluate as a condition.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait for the condition to be true.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional message to use if the wait times
+out.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+with the first truthy value returned by the condition function, or
+rejected if the condition times out.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="WebDriver.attachToSession" class="function"><div><h3>WebDriver.attachToSession(<wbr>executor, sessionId, opt_flow)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l108">code »</a></span></h3><p>Creates a new WebDriver client for an existing session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>executor<code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd><p>Command executor to use when
+querying for session details.</p>
+<dt>sessionId<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>ID of the session to attach to.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow all driver
+commands should execute under. Defaults to the
+<a href="namespace_webdriver_promise.html#controlFlow"><code>currently active</code></a>  control flow.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>A new client for the specified session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="WebDriver.createSession" class="function"><div><h3>WebDriver.createSession(<wbr>executor, desiredCapabilities, opt_flow)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l129">code »</a></span></h3><p>Creates a new WebDriver session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>executor<code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd><p>The executor to create the new
+session with.</p>
+<dt>desiredCapabilities<code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The desired
+capabilities for the new session.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow all driver
+commands should execute under, including the initial session creation.
+Defaults to the <a href="namespace_webdriver_promise.html#controlFlow"><code>currently active</code></a>
+control flow.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver for the newly created session.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_WebDriver_Logs.html">WebDriver.Logs</a><dd><p>Interface for managing WebDriver log records.</p>
+<dt><a href="class_webdriver_WebDriver_Navigation.html">WebDriver.Navigation</a><dd><p>Interface for navigating back and forth in the browser history.</p>
+<dt><a href="class_webdriver_WebDriver_Options.html">WebDriver.Options</a><dd><p>Provides methods for managing browser and driver state.</p>
+<dt><a href="class_webdriver_WebDriver_TargetLocator.html">WebDriver.TargetLocator</a><dd><p>An interface for changing the focus of the driver to another frame or window.</p>
+<dt><a href="class_webdriver_WebDriver_Timeouts.html">WebDriver.Timeouts</a><dd><p>An interface for managing timeout behavior for WebDriver instances.</p>
+<dt><a href="class_webdriver_WebDriver_Window.html">WebDriver.Window</a><dd><p>An interface for managing the current window.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebDriver_Logs.html b/docs/class_webdriver_WebDriver_Logs.html
index 7530f25..aeb76be 100644
--- a/docs/class_webdriver_WebDriver_Logs.html
+++ b/docs/class_webdriver_WebDriver_Logs.html
@@ -1,10 +1,15 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.WebDriver.Logs</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.WebDriver.Logs</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1285">code &raquo;</a></header><section><p>Interface for managing WebDriver log records.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.WebDriver.Logs <span class="args">( driver )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The parent driver.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1306">code &raquo;</a><span class="member"><a name="get">get</a> <span class="args">( type )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Fetches available log entries for the given type.
-
- <p/>Note that log buffers are reset after each call, meaning that
- available log entries correspond to those entries not yet returned for a
- given log type. In practice, this means that this call will return the
- available log entries since the last call, or from the start of the
- session.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">!<a href="enum_webdriver_logging_Type.html">webdriver.logging.Type</a></code><dd>The desired log type.</dl><tr><th>Returns<tr><td><dl>A
-   promise that will resolve to a list of log entries for the specified
-   type.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1328">code &raquo;</a><span class="member"><a name="getAvailableLogTypes">getAvailableLogTypes</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Retrieves the log types available to this driver.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A
-     promise that will resolve to a list of available log types.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1288">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>WebDriver.Logs</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1488">View Source</a></div><h1>class WebDriver.Logs</h1><p>Interface for managing WebDriver log records.</p>
+<h3>new WebDriver.Logs(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="get" class="function"><div><h3>get(<wbr>type)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1508">code »</a></span></h3><p>Fetches available log entries for the given type.</p>
+<p>Note that log buffers are reset after each call, meaning that available
+log entries correspond to those entries not yet returned for a given log
+type. In practice, this means that this call will return the available log
+entries since the last call, or from the start of the session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="enum_webdriver_logging_Type.html">webdriver.logging.Type</a></code><dd><p>The desired log type.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_logging_Entry.html">webdriver.logging.Entry</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to a list of log entries for the specified
+type.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAvailableLogTypes" class="function"><div><h3>getAvailableLogTypes()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1531">code »</a></span></h3><p>Retrieves the log types available to this driver.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="enum_webdriver_logging_Type.html">webdriver.logging.Type</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to a list of available log types.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebDriver_Navigation.html b/docs/class_webdriver_WebDriver_Navigation.html
index efe2114..16af66c 100644
--- a/docs/class_webdriver_WebDriver_Navigation.html
+++ b/docs/class_webdriver_WebDriver_Navigation.html
@@ -1,5 +1,16 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.WebDriver.Navigation</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.WebDriver.Navigation</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l900">code &raquo;</a></header><section><p>Interface for navigating back and forth in the browser history.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.WebDriver.Navigation <span class="args">( driver )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The parent driver.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l926">code &raquo;</a><span class="member"><a name="back">back</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to move backwards in the browser history.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     navigation event has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l938">code &raquo;</a><span class="member"><a name="forward">forward</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to move forwards in the browser history.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     navigation event has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l950">code &raquo;</a><span class="member"><a name="refresh">refresh</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to refresh the current page.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     navigation event has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l913">code &raquo;</a><span class="member"><a name="to">to</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to navigate to a new URL.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URL to navigate to.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     URL has been loaded.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l903">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>WebDriver.Navigation</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1085">View Source</a></div><h1>class WebDriver.Navigation</h1><p>Interface for navigating back and forth in the browser history.</p>
+<h3>new WebDriver.Navigation(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="back" class="function"><div><h3>back()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1111">code »</a></span></h3><p>Schedules a command to move backwards in the browser history.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the navigation event has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="forward" class="function"><div><h3>forward()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1123">code »</a></span></h3><p>Schedules a command to move forwards in the browser history.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the navigation event has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="refresh" class="function"><div><h3>refresh()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1135">code »</a></span></h3><p>Schedules a command to refresh the current page.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the navigation event has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="to" class="function"><div><h3>to(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1098">code »</a></span></h3><p>Schedules a command to navigate to a new URL.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL to navigate to.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the URL has been loaded.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebDriver_Options.html b/docs/class_webdriver_WebDriver_Options.html
index ee252eb..6e0cc55 100644
--- a/docs/class_webdriver_WebDriver_Options.html
+++ b/docs/class_webdriver_WebDriver_Options.html
@@ -1,16 +1,41 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.WebDriver.Options</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.WebDriver.Options</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l963">code &raquo;</a></header><section><p>Provides methods for managing browser and driver state.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.WebDriver.Options <span class="args">( driver )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The parent driver.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l982">code &raquo;</a><span class="member"><a name="addCookie">addCookie</a> <span class="args">( name, value, opt_path, opt_domain, opt_isSecure, opt_expiry )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to add a cookie.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The cookie name.<dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The cookie value.<dt>opt_path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The cookie path.<dt>opt_domain: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The cookie domain.<dt>opt_isSecure: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether the cookie is secure.<dt>opt_expiry: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Date">Date</a>)=</code><dd>When the cookie expires. If specified as
-     a number, should be in milliseconds since midnight, January 1, 1970 UTC.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     cookie has been added to the page.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1032">code &raquo;</a><span class="member"><a name="deleteAllCookies">deleteAllCookies</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to delete all cookies visible to the current page.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when all
-     cookies have been deleted.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1047">code &raquo;</a><span class="member"><a name="deleteCookie">deleteCookie</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to delete the cookie with the given name. This command is
- a no-op if there is no cookie with the given name visible to the current
- page.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the cookie to delete.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     cookie has been deleted.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1079">code &raquo;</a><span class="member"><a name="getCookie">getCookie</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve the cookie with the given name. Returns null
- if there is no such cookie. The cookie will be returned as a JSON object as
- described by the WebDriver wire protocol.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the cookie to retrieve.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     named cookie, or <code >null</code> if there is no such cookie.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1063">code &raquo;</a><span class="member"><a name="getCookies">getCookies</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve all cookies visible to the current page.
- Each cookie will be returned as a JSON object as described by the WebDriver
- wire protocol.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     cookies visible to the current page.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1092">code &raquo;</a><span class="member"><a name="logs">logs</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver_Logs.html">webdriver.WebDriver.Logs</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The interface for managing driver
-     logs.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1101">code &raquo;</a><span class="member"><a name="timeouts">timeouts</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver_Timeouts.html">webdriver.WebDriver.Timeouts</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The interface for managing driver
-     timeouts.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1110">code &raquo;</a><span class="member"><a name="window">window</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver_Window.html">webdriver.WebDriver.Window</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The interface for managing the
-     current window.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l966">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>WebDriver.Options</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1148">View Source</a></div><h1>class WebDriver.Options</h1><p>Provides methods for managing browser and driver state.</p>
+<h3>new WebDriver.Options(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="addCookie" class="function"><div><h3>addCookie(<wbr>name, value, opt_path, opt_domain, opt_isSecure, opt_expiry)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1182">code »</a></span></h3><p>Schedules a command to add a cookie.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The cookie name.</p>
+<dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The cookie value.</p>
+<dt>opt_path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The cookie path.</p>
+<dt>opt_domain<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The cookie domain.</p>
+<dt>opt_isSecure<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd><p>Whether the cookie is secure.</p>
+<dt>opt_expiry<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a>)=</code><dd><p>When the cookie expires. If specified as
+a number, should be in milliseconds since midnight, January 1, 1970 UTC.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the cookie has been added to the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="deleteAllCookies" class="function"><div><h3>deleteAllCookies()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1232">code »</a></span></h3><p>Schedules a command to delete all cookies visible to the current page.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when all cookies have been deleted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="deleteCookie" class="function"><div><h3>deleteCookie(<wbr>name)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1247">code »</a></span></h3><p>Schedules a command to delete the cookie with the given name. This command is
+a no-op if there is no cookie with the given name visible to the current
+page.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the cookie to delete.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the cookie has been deleted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCookie" class="function"><div><h3>getCookie(<wbr>name)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1281">code »</a></span></h3><p>Schedules a command to retrieve the cookie with the given name. Returns null
+if there is no such cookie. The cookie will be returned as a JSON object as
+described by the WebDriver wire protocol.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the cookie to retrieve.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;?{domain: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), expiry: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, path: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), secure: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), value: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;</code><dd><p>A
+promise that will be resolved with the named cookie, or <code>null</code>
+if there is no such cookie.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCookies" class="function"><div><h3>getCookies()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1264">code »</a></span></h3><p>Schedules a command to retrieve all cookies visible to the current page.
+Each cookie will be returned as a JSON object as described by the WebDriver
+wire protocol.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;{domain: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), expiry: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, path: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), secure: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), value: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;&gt;</code><dd><p>A promise that will be
+resolved with the cookies visible to the current page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="logs" class="function"><div><h3>logs()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1294">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Logs.html">webdriver.WebDriver.Logs</a></code><dd><p>The interface for managing driver
+logs.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="timeouts" class="function"><div><h3>timeouts()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1303">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Timeouts.html">webdriver.WebDriver.Timeouts</a></code><dd><p>The interface for managing driver
+timeouts.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="window" class="function"><div><h3>window()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1312">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Window.html">webdriver.WebDriver.Window</a></code><dd><p>The interface for managing the
+current window.</p>
+</dl></div></div></div></div><h2>Type Definitions</h2><div id="Options.Cookie" class="property"><dl><dt><a href="source/lib/webdriver/webdriver.js.src.html#l1167">Options.Cookie</a><code>{domain: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), expiry: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, path: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), secure: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), value: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>A JSON description of a browser cookie.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebDriver_TargetLocator.html b/docs/class_webdriver_WebDriver_TargetLocator.html
index 8ff60ef..fe6d1b0 100644
--- a/docs/class_webdriver_WebDriver_TargetLocator.html
+++ b/docs/class_webdriver_WebDriver_TargetLocator.html
@@ -1,27 +1,38 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.WebDriver.TargetLocator</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.WebDriver.TargetLocator</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1341">code &raquo;</a></header><section><p>An interface for changing the focus of the driver to another frame or window.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.WebDriver.TargetLocator <span class="args">( driver )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The parent driver.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1354">code &raquo;</a><span class="member"><a name="activeElement">activeElement</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code></span></div><p>Schedules a command retrieve the <code >document.activeElement</code> element on
- the current document, or <code >document.body</code> if activeElement is not
- available.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The active element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1428">code &raquo;</a><span class="member"><a name="alert">alert</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Alert.html">webdriver.Alert</a></code></span></div><p>Schedules a command to change focus to the active alert dialog. This command
- will return a <code  class="type"><a href="enum_bot_ErrorCode.html#bot.ErrorCode.NO_MODAL_DIALOG_OPEN">bot.ErrorCode.NO_MODAL_DIALOG_OPEN</a></code> error if a modal
- dialog is not currently open.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The open alert.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1368">code &raquo;</a><span class="member"><a name="defaultContent">defaultContent</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to switch focus of all future commands to the first frame
- on the page.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     driver has changed focus to the default content.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1394">code &raquo;</a><span class="member"><a name="frame">frame</a> <span class="args">( nameOrIndex )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to switch the focus of all future commands to another
- frame on the page.
- <p/>
- If the frame is specified by a number, the command will switch to the frame
- by its (zero-based) index into the <code >window.frames</code> collection.
- <p/>
- If the frame is specified by a string, the command will select the frame by
- its name or ID. To select sub-frames, simply separate the frame names/IDs by
- dots. As an example, "main.child" will select the frame with the name "main"
- and then its child "child".
- <p/>
- If the specified frame can not be found, the deferred result will errback
- with a <code >bot.ErrorCode.NO_SUCH_FRAME</code> error.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>nameOrIndex: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The frame locator.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     driver has changed focus to the specified frame.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1414">code &raquo;</a><span class="member"><a name="window">window</a> <span class="args">( nameOrHandle )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to switch the focus of all future commands to another
- window. Windows may be specified by their <code >window.name</code> attribute or
- by its handle (as returned by <code >webdriver.WebDriver#getWindowHandles</code>).
- <p/>
- If the specificed window can not be found, the deferred result will errback
- with a <code >bot.ErrorCode.NO_SUCH_WINDOW</code> error.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>nameOrHandle: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name or window handle of the window to
-     switch focus to.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     driver has changed focus to the specified window.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1344">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>WebDriver.TargetLocator</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1544">View Source</a></div><h1>class WebDriver.TargetLocator</h1><p>An interface for changing the focus of the driver to another frame or window.</p>
+<h3>new WebDriver.TargetLocator(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="activeElement" class="function"><div><h3>activeElement()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1557">code »</a></span></h3><p>Schedules a command retrieve the <code>document.activeElement</code> element on
+the current document, or <code>document.body</code> if activeElement is not
+available.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElementPromise.html">webdriver.WebElementPromise</a></code><dd><p>The active element.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="alert" class="function"><div><h3>alert()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1634">code »</a></span></h3><p>Schedules a command to change focus to the active alert dialog. This command
+will return a <a href="enum_bot_ErrorCode.html#NO_SUCH_ALERT"><code>bot.ErrorCode.NO_SUCH_ALERT</code></a> error if an alert dialog
+is not currently open.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_AlertPromise.html">webdriver.AlertPromise</a></code><dd><p>The open alert.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="defaultContent" class="function"><div><h3>defaultContent()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1571">code »</a></span></h3><p>Schedules a command to switch focus of all future commands to the first frame
+on the page.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the driver has changed focus to the default content.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="frame" class="function"><div><h3>frame(<wbr>nameOrIndex)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1599">code »</a></span></h3><p>Schedules a command to switch the focus of all future commands to another
+frame on the page.</p>
+<p>If the frame is specified by a number, the command will switch to the frame
+by its (zero-based) index into
+<a href="https://developer.mozilla.org/en-US/docs/Web/API/Window.frames">window.frames</a>.</p>
+<p>If the frame is specified by a string, the command will select the frame by
+its name or ID. To select sub-frames, simply separate the frame names/IDs by
+dots. As an example, &#34;main.child&#34; will select the frame with the name &#34;main&#34;
+and then its child &#34;child&#34;.</p>
+<p>If the specified frame can not be found, the deferred result will errback
+with a <a href="enum_bot_ErrorCode.html#NO_SUCH_FRAME"><code>bot.ErrorCode.NO_SUCH_FRAME</code></a> error.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>nameOrIndex<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd><p>The frame locator.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the driver has changed focus to the specified frame.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="window" class="function"><div><h3>window(<wbr>nameOrHandle)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1620">code »</a></span></h3><p>Schedules a command to switch the focus of all future commands to another
+window. Windows may be specified by their <code>window.name</code> attribute or
+by its handle (as returned by <a href="class_webdriver_WebDriver.html"><code>webdriver.WebDriver#getWindowHandles</code></a>).</p>
+<p>If the specificed window can not be found, the deferred result will errback
+with a <a href="enum_bot_ErrorCode.html#NO_SUCH_WINDOW"><code>bot.ErrorCode.NO_SUCH_WINDOW</code></a> error.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>nameOrHandle<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name or window handle of the window to
+switch focus to.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the driver has changed focus to the specified window.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebDriver_Timeouts.html b/docs/class_webdriver_WebDriver_Timeouts.html
index 39080e1..85926ca 100644
--- a/docs/class_webdriver_WebDriver_Timeouts.html
+++ b/docs/class_webdriver_WebDriver_Timeouts.html
@@ -1,21 +1,29 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.WebDriver.Timeouts</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.WebDriver.Timeouts</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1121">code &raquo;</a></header><section><p>An interface for managing timeout behavior for WebDriver instances.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.WebDriver.Timeouts <span class="args">( driver )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The parent driver.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1149">code &raquo;</a><span class="member"><a name="implicitlyWait">implicitlyWait</a> <span class="args">( ms )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Specifies the amount of time the driver should wait when searching for an
- element if it is not immediately present.
- <p/>
- When searching for a single element, the driver should poll the page
- until the element has been found, or this timeout expires before failing
- with a <code >bot.ErrorCode.NO_SUCH_ELEMENT</code> error. When searching
- for multiple elements, the driver should poll the page until at least one
- element has been found or this timeout has expired.
- <p/>
- Setting the wait timeout to 0 (its default value), disables implicit
- waiting.
- <p/>
- Increasing the implicit wait timeout should be used judiciously as it
- will have an adverse effect on test run time, especially when used with
- slower location strategies like XPath.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ms: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The amount of time to wait, in milliseconds.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     implicit wait timeout has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1181">code &raquo;</a><span class="member"><a name="pageLoadTimeout">pageLoadTimeout</a> <span class="args">( ms )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Sets the amount of time to wait for a page load to complete before returning
- an error.  If the timeout is negative, page loads may be indefinite.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ms: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The amount of time to wait, in milliseconds.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the timeout has been set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1166">code &raquo;</a><span class="member"><a name="setScriptTimeout">setScriptTimeout</a> <span class="args">( ms )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Sets the amount of time to wait, in milliseconds, for an asynchronous script
- to finish execution before returning an error. If the timeout is less than or
- equal to 0, the script will be allowed to run indefinitely.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ms: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The amount of time to wait, in milliseconds.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     script timeout has been set.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1124">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>WebDriver.Timeouts</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1323">View Source</a></div><h1>class WebDriver.Timeouts</h1><p>An interface for managing timeout behavior for WebDriver instances.</p>
+<h3>new WebDriver.Timeouts(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="implicitlyWait" class="function"><div><h3>implicitlyWait(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1351">code »</a></span></h3><p>Specifies the amount of time the driver should wait when searching for an
+element if it is not immediately present.</p>
+<p>When searching for a single element, the driver should poll the page
+until the element has been found, or this timeout expires before failing
+with a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error. When searching
+for multiple elements, the driver should poll the page until at least one
+element has been found or this timeout has expired.</p>
+<p>Setting the wait timeout to 0 (its default value), disables implicit
+waiting.</p>
+<p>Increasing the implicit wait timeout should be used judiciously as it
+will have an adverse effect on test run time, especially when used with
+slower location strategies like XPath.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time to wait, in milliseconds.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the implicit wait timeout has been set.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="pageLoadTimeout" class="function"><div><h3>pageLoadTimeout(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1383">code »</a></span></h3><p>Sets the amount of time to wait for a page load to complete before returning
+an error.  If the timeout is negative, page loads may be indefinite.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time to wait, in milliseconds.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the timeout has been set.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setScriptTimeout" class="function"><div><h3>setScriptTimeout(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1368">code »</a></span></h3><p>Sets the amount of time to wait, in milliseconds, for an asynchronous script
+to finish execution before returning an error. If the timeout is less than or
+equal to 0, the script will be allowed to run indefinitely.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time to wait, in milliseconds.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the script timeout has been set.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebDriver_Window.html b/docs/class_webdriver_WebDriver_Window.html
index 87e91b6..7d85985 100644
--- a/docs/class_webdriver_WebDriver_Window.html
+++ b/docs/class_webdriver_WebDriver_Window.html
@@ -1,10 +1,27 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.WebDriver.Window</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.WebDriver.Window</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1196">code &raquo;</a></header><section><p>An interface for managing the current window.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.WebDriver.Window <span class="args">( driver )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The parent driver.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1209">code &raquo;</a><span class="member"><a name="getPosition">getPosition</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Retrieves the window's current position, relative to the top left corner of
- the screen.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     window's position in the form of a {x:number, y:number} object literal.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1242">code &raquo;</a><span class="member"><a name="getSize">getSize</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Retrieves the window's current size.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     window's size in the form of a {width:number, height:number} object
-     literal.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1272">code &raquo;</a><span class="member"><a name="maximize">maximize</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Maximizes the current window.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     command has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1226">code &raquo;</a><span class="member"><a name="setPosition">setPosition</a> <span class="args">( x, y )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Repositions the current window.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>x: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The desired horizontal position, relative to the left side
-     of the screen.<dt>y: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The desired vertical position, relative to the top of the
-     of the screen.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     command has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1257">code &raquo;</a><span class="member"><a name="setSize">setSize</a> <span class="args">( width, height )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Resizes the current window.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>width: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The desired window width.<dt>height: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The desired window height.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     command has completed.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1199">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>WebDriver.Window</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1398">View Source</a></div><h1>class WebDriver.Window</h1><p>An interface for managing the current window.</p>
+<h3>new WebDriver.Window(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getPosition" class="function"><div><h3>getPosition()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1412">code »</a></span></h3><p>Retrieves the window&#39;s current position, relative to the top left corner of
+the screen.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A promise that
+will be resolved with the window&#39;s position in the form of a
+{x:number, y:number} object literal.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSize" class="function"><div><h3>getSize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1445">code »</a></span></h3><p>Retrieves the window&#39;s current size.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{height: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, width: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A
+promise that will be resolved with the window&#39;s size in the form of a
+{width:number, height:number} object literal.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="maximize" class="function"><div><h3>maximize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1475">code »</a></span></h3><p>Maximizes the current window.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setPosition" class="function"><div><h3>setPosition(<wbr>x, y)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1429">code »</a></span></h3><p>Repositions the current window.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>x<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired horizontal position, relative to the left side
+of the screen.</p>
+<dt>y<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired vertical position, relative to the top of the
+of the screen.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setSize" class="function"><div><h3>setSize(<wbr>width, height)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1460">code »</a></span></h3><p>Resizes the current window.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>width<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired window width.</p>
+<dt>height<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired window height.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebElement.html b/docs/class_webdriver_WebElement.html
index e2522cb..283d113 100644
--- a/docs/class_webdriver_WebElement.html
+++ b/docs/class_webdriver_WebElement.html
@@ -1,252 +1,216 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.WebElement</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.WebElement</h1><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1499">code &raquo;</a><pre><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>
-  &#x2514; <a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a>
-      &#x2514; webdriver.WebElement</code></pre></header><section><p>Represents a DOM element. WebElements can be found by searching from the
- document root using a <code >webdriver.WebDriver</code> instance, or by searching
- under another <code >webdriver.WebElement</code>:
- <pre><code>
-   driver.get('http://www.google.com');
-   var searchForm = driver.findElement(By.tagName('form'));
-   var searchBox = searchForm.findElement(By.name('q'));
-   searchBox.sendKeys('webdriver');
- </code></pre>
+<!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>WebElement</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1706">View Source</a></div><h1>class WebElement</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;
+  &#x2514; webdriver.WebElement</pre><p>Represents a DOM element. WebElements can be found by searching from the
+document root using a <a href="class_webdriver_WebDriver.html"><code>webdriver.WebDriver</code></a> instance, or by searching
+under another WebElement:</p>
+<pre><code>driver.get(&#39;http://www.google.com&#39;);
+var searchForm &#61; driver.findElement(By.tagName(&#39;form&#39;));
+var searchBox &#61; searchForm.findElement(By.name(&#39;q&#39;));
+searchBox.sendKeys(&#39;webdriver&#39;);
+</code></pre>
+<p>The WebElement is implemented as a promise for compatibility with the promise
+API. It will always resolve itself when its internal state has been fully
+resolved and commands may be issued against the element. This can be used to
+catch errors when an element cannot be located on the page:</p>
+<pre><code>driver.findElement(By.id(&#39;not-there&#39;)).then(function(element) {
+  alert(&#39;Found an element that was not expected to be there!&#39;);
+}, function(error) {
+  alert(&#39;The element was not found, as expected&#39;);
+});
+</code></pre>
+<h3>new WebElement(<wbr>driver, id)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent WebDriver instance for this
+element.</p>
+<dt>id<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;|{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The server-assigned opaque ID for the
+underlying DOM element.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="clear" class="function"><div><h3>clear()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2171">code »</a></span></h3><p>Schedules a command to clear the <code>value</code> of this element. This command
+has no effect if the underlying DOM element is neither a text INPUT element
+nor a TEXTAREA element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the element has been cleared.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="click" class="function"><div><h3>click()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1919">code »</a></span></h3><p>Schedules a command to click on this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the click command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1859">code »</a></span></h3><p>Schedule a command to find a descendant of this element. If the element
+cannot be found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will
+be returned by the driver. Unlike other commands, this error cannot be
+suppressed. In other words, scheduling a command to find an element doubles
+as an assert that the element is present on the page. To test whether an
+element is present on the page, use <a href="class_webdriver_WebElement.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; element.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; element.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; element.findElement(firstVisibleLink);
 
- The WebElement is implemented as a promise for compatibility with the promise
- API. It will always resolve itself when its internal state has been fully
- resolved and commands may be issued against the element. This can be used to
- catch errors when an element cannot be located on the page:
- <pre><code>
-   driver.findElement(By.id('not-there')).then(function(element) {
-     alert('Found an element that was not expected to be there!');
-   }, function(error) {
-     alert('The element was not found, as expected');
-   });
- </code></pre><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.WebElement <span class="args">( driver, id )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>driver: <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd>The parent WebDriver instance for this
-     element.<dt>id: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code><dd>Either the opaque ID for the
-     underlying DOM element assigned by the server, or a promise that will
-     resolve to that ID or another WebElement.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.WebElement</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1934">code &raquo;</a><span class="member"><a name="clear">clear</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to clear the <code >value</code> of this element. This command
- has no effect if the underlying DOM element is neither a text INPUT element
- nor a TEXTAREA element.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the element has been cleared.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1713">code &raquo;</a><span class="member"><a name="click">click</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to click on this element.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the click command has completed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1653">code &raquo;</a><span class="member"><a name="findElement">findElement</a> <span class="args">( locator )</span> &rArr; <code class="type">!<a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code></span></div><p>Schedule a command to find a descendant of this element. If the element
- cannot be found, a <code >bot.ErrorCode.NO_SUCH_ELEMENT</code> result will
- be returned by the driver. Unlike other commands, this error cannot be
- suppressed. In other words, scheduling a command to find an element doubles
- as an assert that the element is present on the page. To test whether an
- element is present on the page, use <code >#isElementPresent</code> instead.
-
- <p>The search criteria for an element may be defined using one of the
- factories in the <code  class="type"><a href="namespace_webdriver_By.html">webdriver.By</a></code> namespace, or as a short-hand
- <code  class="type"><a href="namespace_webdriver_By.html#webdriver.By.Hash">webdriver.By.Hash</a></code> object. For example, the following two statements
- are equivalent:
- <code><pre>
- var e1 = element.findElement(By.id('foo'));
- var e2 = element.findElement({id:'foo'});
- </pre></code>
-
- <p>You may also provide a custom locator function, which takes as input
- this WebDriver instance and returns a <code  class="type"><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code>, or a
- promise that will resolve to a WebElement. For example, to find the first
- visible link on a page, you could write:
- <code><pre>
- var link = element.findElement(firstVisibleLink);
-
- function firstVisibleLink(element) {
-   var links = element.findElements(By.tagName('a'));
-   return webdriver.promise.filter(links, function(link) {
-     return links.isDisplayed();
-   }).then(function(visibleLinks) {
-     return visibleLinks[0];
-   });
- }
- </pre></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>locator: <code class="type">!(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|<a href="namespace_webdriver_By.html#webdriver.By.Hash">webdriver.By.Hash</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The
-     locator strategy to use when searching for the element.</dl><tr><th>Returns<tr><td><dl>A WebElement that can be used to issue
-     commands against the located element. If the element is not found, the
-     element will be invalidated and all scheduled commands aborted.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1694">code &raquo;</a><span class="member"><a name="findElements">findElements</a> <span class="args">( locator )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to find all of the descendants of this element that
- match the given search criteria.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>locator: <code class="type">!(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|<a href="namespace_webdriver_By.html#webdriver.By.Hash">webdriver.By.Hash</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The
-     locator strategy to use when searching for the elements.</dl><tr><th>Returns<tr><td><dl>A
-     promise that will resolve to an array of WebElements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1842">code &raquo;</a><span class="member"><a name="getAttribute">getAttribute</a> <span class="args">( attributeName )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to query for the value of the given attribute of the
- element. Will return the current value, even if it has been modified after
- the page has been loaded. More exactly, this method will return the value of
- the given attribute, unless that attribute is not present, in which case the
- value of the property with the same name is returned. If neither value is
- set, null is returned (for example, the "value" property of a textarea
- element). The "style" attribute is converted as best can be to a
- text representation with a trailing semi-colon. The following are deemed to
- be "boolean" attributes and will return either "true" or null:
-
- <p>async, autofocus, autoplay, checked, compact, complete, controls, declare,
- defaultchecked, defaultselected, defer, disabled, draggable, ended,
- formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope,
- loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open,
- paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
- selected, spellcheck, truespeed, willvalidate
-
- <p>Finally, the following commonly mis-capitalized attribute/property names
- are evaluated as expected:
- <ul>
-   <li>"class"
-   <li>"readonly"
- </ul></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>attributeName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the attribute to query.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     attribute's value. The returned value will always be either a string or
-     null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1804">code &raquo;</a><span class="member"><a name="getCssValue">getCssValue</a> <span class="args">( cssStyleProperty )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to query for the computed style of the element
- represented by this instance. If the element inherits the named style from
- its parent, the parent will be queried for its value.  Where possible, color
- values will be converted to their hex representation (e.g. #00ff00 instead of
- rgb(0, 255, 0)).
- <p/>
- <em>Warning:</em> the value returned will be as the browser interprets it, so
- it may be tricky to form a proper assertion.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>cssStyleProperty: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the CSS style property to look
-     up.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     requested CSS value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1581">code &raquo;</a><span class="member"><a name="getDriver">getDriver</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The parent driver for this instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1977">code &raquo;</a><span class="member"><a name="getInnerHtml">getInnerHtml</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve the inner HTML of this element.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     element's inner HTML.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1881">code &raquo;</a><span class="member"><a name="getLocation">getLocation</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to compute the location of this element in page space.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved to the
-     element's location as a <code >{x:number, y:number}</code> object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1958">code &raquo;</a><span class="member"><a name="getOuterHtml">getOuterHtml</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to retrieve the outer HTML of this element.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with
-     the element's outer HTML.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1869">code &raquo;</a><span class="member"><a name="getSize">getSize</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to compute the size of this element's bounding box, in
- pixels.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     element's size as a <code >{width:number, height:number}</code> object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1782">code &raquo;</a><span class="member"><a name="getTagName">getTagName</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to query for the tag/node name of this element.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     element's tag name.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1856">code &raquo;</a><span class="member"><a name="getText">getText</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Get the visible (i.e. not hidden by CSS) innerText of this element, including
- sub-elements, without any leading or trailing whitespace.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     element's visible text.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1946">code &raquo;</a><span class="member"><a name="isDisplayed">isDisplayed</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to test whether this element is currently displayed.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with
-     whether this element is currently visible on the page.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1678">code &raquo;</a><span class="member"><a name="isElementPresent">isElementPresent</a> <span class="args">( locator )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code></span></div><p>Schedules a command to test if there is at least one descendant of this
- element that matches the given search criteria.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>locator: <code class="type">!(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|<a href="namespace_webdriver_By.html#webdriver.By.Hash">webdriver.By.Hash</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The
-     locator strategy to use when searching for the element.</dl><tr><th>Returns<tr><td><dl>A promise that will be
-     resolved with whether an element could be located on the page.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1894">code &raquo;</a><span class="member"><a name="isEnabled">isEnabled</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to query whether the DOM element represented by this
- instance is enabled, as dicted by the <code >disabled</code> attribute.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with
-     whether this element is currently enabled.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1906">code &raquo;</a><span class="member"><a name="isSelected">isSelected</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to query whether this element is selected.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved with
-     whether this element is currently selected.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1607">code &raquo;</a><span class="member"><a name="schedule_">schedule_</a> <span class="args">( command, description )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command that targets this element with the parent WebDriver
- instance. Will ensure this element's ID is included in the command parameters
- under the "id" key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>command: <code class="type">!<a href="class_webdriver_Command.html">webdriver.Command</a></code><dd>The command to schedule.<dt>description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A description of the command for debugging.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with
-     the command result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1760">code &raquo;</a><span class="member"><a name="sendKeys">sendKeys</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to type a sequence on the DOM element represented by this
- instance.
- <p/>
- Modifier keys (SHIFT, CONTROL, ALT, META) are stateful; once a modifier is
- processed in the keysequence, that key state is toggled until one of the
- following occurs:
- <ul>
- <li>The modifier key is encountered again in the sequence. At this point the
- state of the key is toggled (along with the appropriate keyup/down events).
- </li>
- <li>The <code >webdriver.Key.NULL</code> key is encountered in the sequence. When
- this key is encountered, all modifier keys current in the down state are
- released (with accompanying keyup events). The NULL key can be used to
- simulate common keyboard shortcuts:
- <code><pre>
-     element.sendKeys("text was",
-                      webdriver.Key.CONTROL, "a", webdriver.Key.NULL,
-                      "now text is");
-     // Alternatively:
-     element.sendKeys("text was",
-                      webdriver.Key.chord(webdriver.Key.CONTROL, "a"),
-                      "now text is");
- </pre></code></li>
- <li>The end of the keysequence is encountered. When there are no more keys
- to type, all depressed modifier keys are released (with accompanying keyup
- events).
- </li>
- </ul>
- <strong>Note:</strong> On browsers where native keyboard events are not yet
- supported (e.g. Firefox on OS X), key events will be synthesized. Special
- punctionation keys will be synthesized according to a standard QWERTY en-us
- keyboard layout.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The sequence of keys to
-     type. All arguments will be joined into a single sequence (var_args is
-     permitted for convenience).</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when all
-     keys have been typed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1920">code &raquo;</a><span class="member"><a name="submit">submit</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a command to submit the form containing this element (or this
- element if it is a FORM element). This command is a no-op if the element is
- not contained in a form.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the form has been submitted.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1591">code &raquo;</a><span class="member"><a name="toWireValue">toWireValue</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that resolves to this
-     element's JSON representation as defined by the WebDriver wire protocol.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
- be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l527">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
- promise and not a reference to this deferred, this instance will wait for
- it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">*=</code><dd>The resolved value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
- be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l533">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l237">code &raquo;</a><span class="member deprecation-notice"><a name="addBoth">addBoth</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenFinally()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is either rejected or
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when this promise is
-     either resolved or rejected. The function should expect a single
-     argument: the resolved value or rejection error.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l199">code &raquo;</a><span class="member deprecation-notice"><a name="addCallback">addCallback</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is successfully
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l259">code &raquo;</a><span class="member deprecation-notice"><a name="addCallbacks">addCallbacks</a> <span class="args">( callback, errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>An alias for <code >webdriver.promise.Promise.prototype.then</code> that permits
- the scope of the invoked function to be specified. This function is provided
- for backwards compatibility with the Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l218">code &raquo;</a><span class="member deprecation-notice"><a name="addErrback">addErrback</a> <span class="args">( errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenCatch()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is rejected.
- This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l86">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div><p>Cancels the computation of this promise's value, rejecting the promise in the
- process.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason: <code class="type">*</code><dd>The reason this promise is being cancelled. If not an
-     <code >Error</code>, one will be created using the value's string
-     representation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l92">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether this promise's value is still being computed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l110">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers listeners for when this instance is resolved. This function most
- overridden by subtypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l139">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener for when this promise is rejected. This is synonymous
- with the <code >catch</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } catch (ex) {
-     console.error(ex);
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenCatch(function(ex) {
-     console.error(ex);
-   });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l180">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener to invoke when this promise is resolved, regardless
- of whether the promise's value was successfully computed. This function
- is synonymous with the <code >finally</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } finally {
-     cleanUp();
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenFinally(cleanUp);
- </code></pre>
-
- <b>Note:</b> similar to the <code >finally</code> clause, if the registered
- callback returns a rejected promise or throws an error, it will silently
- replace the rejection error (if any) from this promise:
- <pre><code>
-   try {
-     throw Error('one');
-   } finally {
-     throw Error('two');  // Hides Error: one
-   }
-
-   webdriver.promise.rejected(Error('one'))
-       .thenFinally(function() {
-         throw Error('two');  // Hides Error: one
-       });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.WebElement</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1506">code &raquo;</a><span class="member"><a name="driver_">driver_</a> : <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div><p>The parent WebDriver instance for this element.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1522">code &raquo;</a><span class="member"><a name="id_">id_</a> : <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>A promise that resolves to the JSON representation of this WebElement's
- ID, as defined by the WebDriver wire protocol.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l523">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
- in one of three states: pending, resolved, or rejected. Each promise starts
- in the pending state and may make a single transition to either a
- fulfilled or failed state.
-
- <p/>This class is based on the Promise/A proposal from CommonJS. Additional
- functions are provided for API compatibility with Dojo Deferred objects.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1557">code &raquo;</a><span class="member"><a name="webdriver.WebElement.equals">webdriver.WebElement.equals</a> <span class="args">( a, b )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Compares to WebElements for equality.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">!<a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd>A WebElement.<dt>b: <code class="type">!<a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd>A WebElement.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved to
-     whether the two WebElements are equal.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1547">code &raquo;</a><span class="member"><a name="webdriver.WebElement.ELEMENT_KEY">webdriver.WebElement.ELEMENT_KEY</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The property key used in the wire protocol to indicate that a JSON object
- contains the ID of a WebElement.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1499">code &raquo;</a><span class="member"><a name="webdriver.WebElement.superClass_">webdriver.WebElement.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+function firstVisibleLink(element) {
+  var links &#61; element.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1900">code »</a></span></h3><p>Schedules a command to find all of the descendants of this element that
+match the given search criteria.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the elements.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAttribute" class="function"><div><h3>getAttribute(<wbr>attributeName)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2077">code »</a></span></h3><p>Schedules a command to query for the value of the given attribute of the
+element. Will return the current value, even if it has been modified after
+the page has been loaded. More exactly, this method will return the value of
+the given attribute, unless that attribute is not present, in which case the
+value of the property with the same name is returned. If neither value is
+set, null is returned (for example, the &#34;value&#34; property of a textarea
+element). The &#34;style&#34; attribute is converted as best can be to a
+text representation with a trailing semi-colon. The following are deemed to
+be &#34;boolean&#34; attributes and will return either &#34;true&#34; or null:</p>
+<p>async, autofocus, autoplay, checked, compact, complete, controls, declare,
+defaultchecked, defaultselected, defer, disabled, draggable, ended,
+formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope,
+loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open,
+paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
+selected, spellcheck, truespeed, willvalidate</p>
+<p>Finally, the following commonly mis-capitalized attribute/property names
+are evaluated as expected:</p>
+<ul><li>&#34;class&#34;</li><li>&#34;readonly&#34;</li></ul>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>attributeName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the attribute to query.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the attribute&#39;s value. The returned value will always be
+either a string or null.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCssValue" class="function"><div><h3>getCssValue(<wbr>cssStyleProperty)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2039">code »</a></span></h3><p>Schedules a command to query for the computed style of the element
+represented by this instance. If the element inherits the named style from
+its parent, the parent will be queried for its value.  Where possible, color
+values will be converted to their hex representation (e.g. #00ff00 instead of
+rgb(0, 255, 0)).</p>
+<p><em>Warning:</em> the value returned will be as the browser interprets it, so
+it may be tricky to form a proper assertion.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>cssStyleProperty<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the CSS style property to look
+up.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the requested CSS value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getDriver" class="function"><div><h3>getDriver()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1768">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getId" class="function"><div><h3>getId()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1779">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;</code><dd><p>A promise
+that resolves to this element&#39;s JSON representation as defined by the
+WebDriver wire protocol.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getInnerHtml" class="function"><div><h3>getInnerHtml()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2214">code »</a></span></h3><p>Schedules a command to retrieve the inner HTML of this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s inner HTML.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLocation" class="function"><div><h3>getLocation()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2118">code »</a></span></h3><p>Schedules a command to compute the location of this element in page space.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A promise that
+will be resolved to the element&#39;s location as a
+<code>{x:number, y:number}</code> object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getOuterHtml" class="function"><div><h3>getOuterHtml()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2195">code »</a></span></h3><p>Schedules a command to retrieve the outer HTML of this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s outer HTML.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getRawId" class="function"><div><h3>getRawId()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1790">code »</a></span></h3><p>Returns the raw ID string ID for this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that resolves to this
+element&#39;s raw ID as a string value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSize" class="function"><div><h3>getSize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2105">code »</a></span></h3><p>Schedules a command to compute the size of this element&#39;s bounding box, in
+pixels.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{height: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, width: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A
+promise that will be resolved with the element&#39;s size as a
+<code>{width:number, height:number}</code> object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTagName" class="function"><div><h3>getTagName()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2017">code »</a></span></h3><p>Schedules a command to query for the tag/node name of this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s tag name.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getText" class="function"><div><h3>getText()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2091">code »</a></span></h3><p>Get the visible (i.e. not hidden by CSS) innerText of this element, including
+sub-elements, without any leading or trailing whitespace.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s visible text.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isDisplayed" class="function"><div><h3>isDisplayed()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2183">code »</a></span></h3><p>Schedules a command to test whether this element is currently displayed.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently visible on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1884">code »</a></span></h3><p>Schedules a command to test if there is at least one descendant of this
+element that matches the given search criteria.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether an element could be located on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isEnabled" class="function"><div><h3>isEnabled()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2131">code »</a></span></h3><p>Schedules a command to query whether the DOM element represented by this
+instance is enabled, as dicted by the <code>disabled</code> attribute.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently enabled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isSelected" class="function"><div><h3>isSelected()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2143">code »</a></span></h3><p>Schedules a command to query whether this element is selected.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently selected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1979">code »</a></span></h3><p>Schedules a command to type a sequence on the DOM element represented by this
+instance.</p>
+<p>Modifier keys (SHIFT, CONTROL, ALT, META) are stateful; once a modifier is
+processed in the keysequence, that key state is toggled until one of the
+following occurs:</p>
+<ul><li>
+<p>The modifier key is encountered again in the sequence. At this point the
+state of the key is toggled (along with the appropriate keyup/down events).</p>
+</li><li>
+<p>The <a href="enum_webdriver_Key.html#NULL"><code>webdriver.Key.NULL</code></a> key is encountered in the sequence. When
+this key is encountered, all modifier keys current in the down state are
+released (with accompanying keyup events). The NULL key can be used to
+simulate common keyboard shortcuts:</p>
+<pre><code>  element.sendKeys(&#34;text was&#34;,
+                   webdriver.Key.CONTROL, &#34;a&#34;, webdriver.Key.NULL,
+                   &#34;now text is&#34;);
+  // Alternatively:
+  element.sendKeys(&#34;text was&#34;,
+                   webdriver.Key.chord(webdriver.Key.CONTROL, &#34;a&#34;),
+                   &#34;now text is&#34;);
+</code></pre>
+</li><li>
+<p>The end of the keysequence is encountered. When there are no more keys
+to type, all depressed modifier keys are released (with accompanying keyup
+events).</p>
+</li></ul>
+<p>If this element is a file input (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>), the
+specified key sequence should specify the path to the file to attach to
+the element. This is analgous to the user clicking &#34;Browse...&#34; and entering
+the path into the file select dialog.</p>
+<pre><code>var form &#61; driver.findElement(By.css(&#39;form&#39;));
+var element &#61; form.findElement(By.css(&#39;input[type&#61;file]&#39;));
+element.sendKeys(&#39;/path/to/file.txt&#39;);
+form.submit();
+</code></pre>
+<p>For uploads to function correctly, the entered path must reference a file
+on the <em>browser&#39;s</em> machine, not the local machine running this script. When
+running against a remote Selenium server, a <a href="class_webdriver_FileDetector.html"><code>webdriver.FileDetector</code></a>
+may be used to transparently copy files to the remote machine before
+attempting to upload them in the browser.</p>
+<p><strong>Note:</strong> On browsers where native keyboard events are not supported
+(e.g. Firefox on OS X), key events will be synthesized. Special
+punctionation keys will be synthesized according to a standard QWERTY en-us
+keyboard layout.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The sequence
+of keys to type. All arguments will be joined into a single sequence.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when all keys have been typed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1798">code »</a></span></h3><p>Returns either this instance&#39;s serialized represention, if immediately
+available, or a promise for its serialized representation. This function is
+conceptually equivalent to objects that have a <code>toJSON()</code> property,
+except the serialize() result may be a promise or an object containing a
+promise (which are not directly JSON friendly).</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(<a href="class_webdriver_WebElement.html#WebElement.Id">webdriver.WebElement.Id</a>|IThenable&lt;<a href="class_webdriver_WebElement.html#WebElement.Id">webdriver.WebElement.Id</a>&gt;)</code><dd><p>This instance&#39;s serialized wire format.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="submit" class="function"><div><h3>submit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2157">code »</a></span></h3><p>Schedules a command to submit the form containing this element (or this
+element if it is a FORM element). This command is a no-op if the element is
+not contained in a form.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the form has been submitted.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="WebElement.equals" class="function"><div><h3>WebElement.equals(<wbr>a, b)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1743">code »</a></span></h3><p>Compares to WebElements for equality.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>a<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement.</p>
+<dt>b<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved to whether the two WebElements are equal.</p>
+</dl></div></div></div></div><h2>Static Properties</h2><div id="WebElement.ELEMENT_KEY" class="property"><dl><dt><a href="source/lib/webdriver/webdriver.js.src.html#l1733">WebElement.ELEMENT_KEY</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The property key used in the wire protocol to indicate that a JSON object
+contains the ID of a WebElement.</p>
+</dl></div><h2>Type Definitions</h2><div id="WebElement.Id" class="property"><dl><dt><a href="source/lib/webdriver/webdriver.js.src.html#l1724">WebElement.Id</a><code>{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>Wire protocol definition of a WebElement ID.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_WebElementPromise.html b/docs/class_webdriver_WebElementPromise.html
new file mode 100644
index 0000000..077bf25
--- /dev/null
+++ b/docs/class_webdriver_WebElementPromise.html
@@ -0,0 +1,267 @@
+<!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>WebElementPromise</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2241">View Source</a></div><h1>class WebElementPromise</h1><div class="tags"><span>final</span></div><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;
+  &#x2514; <a href="class_webdriver_WebElement.html">webdriver.WebElement</a>
+      &#x2514; webdriver.WebElementPromise</pre><dl><dt>All implemented interfaces<dd><code>IThenable&lt;T&gt;</code><dd><code><a href="interface_webdriver_promise_Thenable.html">webdriver.promise.Thenable</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;</code></dl><p>WebElementPromise is a promise that will be fulfilled with a WebElement.
+This serves as a forward proxy on WebElement, allowing calls to be
+scheduled without directly on this instance before the underlying
+WebElement has been fulfilled. In other words, the following two statements
+are equivalent:</p>
+<pre><code>driver.findElement({id: &#39;my-button&#39;}).click();
+driver.findElement({id: &#39;my-button&#39;}).then(function(el) {
+  return el.click();
+});
+</code></pre>
+<h3>new WebElementPromise(<wbr>driver, el)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent WebDriver instance for this
+element.</p>
+<dt>el<code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;</code><dd><p>A promise
+that will resolve to the promised element.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="cancel" class="function"><div><h3>cancel(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2245">code »</a></span></h3><p>Cancels the computation of this promise&#39;s value, rejecting the promise in
+the process. This method is a no-op if the promise has already been
+resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#cancel">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_CancellationError.html">webdriver.promise.CancellationError</a>)=</code><dd><p>The reason this
+promise is being cancelled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="clear" class="function"><div><h3>clear()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2171">code »</a></span></h3><p>Schedules a command to clear the <code>value</code> of this element. This command
+has no effect if the underlying DOM element is neither a text INPUT element
+nor a TEXTAREA element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#clear">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the element has been cleared.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="click" class="function"><div><h3>click()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1919">code »</a></span></h3><p>Schedules a command to click on this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#click">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the click command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1859">code »</a></span></h3><p>Schedule a command to find a descendant of this element. If the element
+cannot be found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will
+be returned by the driver. Unlike other commands, this error cannot be
+suppressed. In other words, scheduling a command to find an element doubles
+as an assert that the element is present on the page. To test whether an
+element is present on the page, use <a href="class_webdriver_WebElementPromise.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; element.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; element.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; element.findElement(firstVisibleLink);
+
+function firstVisibleLink(element) {
+  var links &#61; element.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#findElement">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1900">code »</a></span></h3><p>Schedules a command to find all of the descendants of this element that
+match the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#findElements">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the elements.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAttribute" class="function"><div><h3>getAttribute(<wbr>attributeName)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2077">code »</a></span></h3><p>Schedules a command to query for the value of the given attribute of the
+element. Will return the current value, even if it has been modified after
+the page has been loaded. More exactly, this method will return the value of
+the given attribute, unless that attribute is not present, in which case the
+value of the property with the same name is returned. If neither value is
+set, null is returned (for example, the &#34;value&#34; property of a textarea
+element). The &#34;style&#34; attribute is converted as best can be to a
+text representation with a trailing semi-colon. The following are deemed to
+be &#34;boolean&#34; attributes and will return either &#34;true&#34; or null:</p>
+<p>async, autofocus, autoplay, checked, compact, complete, controls, declare,
+defaultchecked, defaultselected, defer, disabled, draggable, ended,
+formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope,
+loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open,
+paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
+selected, spellcheck, truespeed, willvalidate</p>
+<p>Finally, the following commonly mis-capitalized attribute/property names
+are evaluated as expected:</p>
+<ul><li>&#34;class&#34;</li><li>&#34;readonly&#34;</li></ul>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getAttribute">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>attributeName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the attribute to query.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the attribute&#39;s value. The returned value will always be
+either a string or null.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCssValue" class="function"><div><h3>getCssValue(<wbr>cssStyleProperty)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2039">code »</a></span></h3><p>Schedules a command to query for the computed style of the element
+represented by this instance. If the element inherits the named style from
+its parent, the parent will be queried for its value.  Where possible, color
+values will be converted to their hex representation (e.g. #00ff00 instead of
+rgb(0, 255, 0)).</p>
+<p><em>Warning:</em> the value returned will be as the browser interprets it, so
+it may be tricky to form a proper assertion.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getCssValue">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>cssStyleProperty<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the CSS style property to look
+up.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the requested CSS value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getDriver" class="function"><div><h3>getDriver()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1768">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getDriver">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getId" class="function"><div><h3>getId()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2264">code »</a></span></h3><p>Defers returning the element ID until the wrapped WebElement has been
+resolved.</p>
+<p><b>Overrides: </b><a href="class_webdriver_WebElement.html#getId">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;</code><dd><p>A promise
+that resolves to this element&#39;s JSON representation as defined by the
+WebDriver wire protocol.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getInnerHtml" class="function"><div><h3>getInnerHtml()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2214">code »</a></span></h3><p>Schedules a command to retrieve the inner HTML of this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getInnerHtml">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s inner HTML.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLocation" class="function"><div><h3>getLocation()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2118">code »</a></span></h3><p>Schedules a command to compute the location of this element in page space.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getLocation">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A promise that
+will be resolved to the element&#39;s location as a
+<code>{x:number, y:number}</code> object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getOuterHtml" class="function"><div><h3>getOuterHtml()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2195">code »</a></span></h3><p>Schedules a command to retrieve the outer HTML of this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getOuterHtml">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s outer HTML.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getRawId" class="function"><div><h3>getRawId()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1790">code »</a></span></h3><p>Returns the raw ID string ID for this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getRawId">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that resolves to this
+element&#39;s raw ID as a string value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSize" class="function"><div><h3>getSize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2105">code »</a></span></h3><p>Schedules a command to compute the size of this element&#39;s bounding box, in
+pixels.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getSize">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{height: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, width: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A
+promise that will be resolved with the element&#39;s size as a
+<code>{width:number, height:number}</code> object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTagName" class="function"><div><h3>getTagName()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2017">code »</a></span></h3><p>Schedules a command to query for the tag/node name of this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getTagName">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s tag name.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getText" class="function"><div><h3>getText()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2091">code »</a></span></h3><p>Get the visible (i.e. not hidden by CSS) innerText of this element, including
+sub-elements, without any leading or trailing whitespace.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getText">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s visible text.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isDisplayed" class="function"><div><h3>isDisplayed()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2183">code »</a></span></h3><p>Schedules a command to test whether this element is currently displayed.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#isDisplayed">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently visible on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1884">code »</a></span></h3><p>Schedules a command to test if there is at least one descendant of this
+element that matches the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#isElementPresent">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether an element could be located on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isEnabled" class="function"><div><h3>isEnabled()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2131">code »</a></span></h3><p>Schedules a command to query whether the DOM element represented by this
+instance is enabled, as dicted by the <code>disabled</code> attribute.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#isEnabled">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently enabled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isPending" class="function"><div><h3>isPending()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2248">code »</a></span></h3><p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#isPending">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether this promise&#39;s value is still being computed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isSelected" class="function"><div><h3>isSelected()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2143">code »</a></span></h3><p>Schedules a command to query whether this element is selected.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#isSelected">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently selected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1979">code »</a></span></h3><p>Schedules a command to type a sequence on the DOM element represented by this
+instance.</p>
+<p>Modifier keys (SHIFT, CONTROL, ALT, META) are stateful; once a modifier is
+processed in the keysequence, that key state is toggled until one of the
+following occurs:</p>
+<ul><li>
+<p>The modifier key is encountered again in the sequence. At this point the
+state of the key is toggled (along with the appropriate keyup/down events).</p>
+</li><li>
+<p>The <a href="enum_webdriver_Key.html#NULL"><code>webdriver.Key.NULL</code></a> key is encountered in the sequence. When
+this key is encountered, all modifier keys current in the down state are
+released (with accompanying keyup events). The NULL key can be used to
+simulate common keyboard shortcuts:</p>
+<pre><code>  element.sendKeys(&#34;text was&#34;,
+                   webdriver.Key.CONTROL, &#34;a&#34;, webdriver.Key.NULL,
+                   &#34;now text is&#34;);
+  // Alternatively:
+  element.sendKeys(&#34;text was&#34;,
+                   webdriver.Key.chord(webdriver.Key.CONTROL, &#34;a&#34;),
+                   &#34;now text is&#34;);
+</code></pre>
+</li><li>
+<p>The end of the keysequence is encountered. When there are no more keys
+to type, all depressed modifier keys are released (with accompanying keyup
+events).</p>
+</li></ul>
+<p>If this element is a file input (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>), the
+specified key sequence should specify the path to the file to attach to
+the element. This is analgous to the user clicking &#34;Browse...&#34; and entering
+the path into the file select dialog.</p>
+<pre><code>var form &#61; driver.findElement(By.css(&#39;form&#39;));
+var element &#61; form.findElement(By.css(&#39;input[type&#61;file]&#39;));
+element.sendKeys(&#39;/path/to/file.txt&#39;);
+form.submit();
+</code></pre>
+<p>For uploads to function correctly, the entered path must reference a file
+on the <em>browser&#39;s</em> machine, not the local machine running this script. When
+running against a remote Selenium server, a <a href="class_webdriver_FileDetector.html"><code>webdriver.FileDetector</code></a>
+may be used to transparently copy files to the remote machine before
+attempting to upload them in the browser.</p>
+<p><strong>Note:</strong> On browsers where native keyboard events are not supported
+(e.g. Firefox on OS X), key events will be synthesized. Special
+punctionation keys will be synthesized according to a standard QWERTY en-us
+keyboard layout.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#sendKeys">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The sequence
+of keys to type. All arguments will be joined into a single sequence.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when all keys have been typed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1798">code »</a></span></h3><p>Returns either this instance&#39;s serialized represention, if immediately
+available, or a promise for its serialized representation. This function is
+conceptually equivalent to objects that have a <code>toJSON()</code> property,
+except the serialize() result may be a promise or an object containing a
+promise (which are not directly JSON friendly).</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#serialize">webdriver.WebElement</a><br><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(<a href="class_webdriver_WebElement.html#WebElement.Id">webdriver.WebElement.Id</a>|IThenable&lt;<a href="class_webdriver_WebElement.html#WebElement.Id">webdriver.WebElement.Id</a>&gt;)</code><dd><p>This instance&#39;s serialized wire format.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="submit" class="function"><div><h3>submit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2157">code »</a></span></h3><p>Schedules a command to submit the form containing this element (or this
+element if it is a FORM element). This command is a no-op if the element is
+not contained in a form.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#submit">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the form has been submitted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="then" class="function"><div><h3>then(<wbr>opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2251">code »</a></span></h3><p>Registers listeners for when this instance is resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#then">webdriver.promise.Thenable</a>, <a href="#then">IThenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_callback<code>?function(T): (R|IThenable&lt;R&gt;)=</code><dd><p>The
+function to call if this promise is successfully resolved. The function
+should expect a single argument: the promise&#39;s resolved value.</p>
+<dt>opt_errback<code>?function(*): (R|IThenable&lt;R&gt;)=</code><dd><p>The function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenCatch" class="function"><div><h3>thenCatch(<wbr>errback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2254">code »</a></span></h3><p>Registers a listener for when this promise is rejected. This is synonymous
+with the <code>catch</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} catch (ex) {
+  console.error(ex);
+}
+
+// Asynchronous promise API:
+doAsynchronousWork().thenCatch(function(ex) {
+  console.error(ex);
+});
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenCatch">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>errback<code>function(*): (R|IThenable&lt;R&gt;)</code><dd><p>The
+function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenFinally" class="function"><div><h3>thenFinally(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2257">code »</a></span></h3><p>Registers a listener to invoke when this promise is resolved, regardless
+of whether the promise&#39;s value was successfully computed. This function
+is synonymous with the <code>finally</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} finally {
+  cleanUp();
+}
+
+// Asynchronous promise API:
+doAsynchronousWork().thenFinally(cleanUp);
+</code></pre>
+<p><strong>Note:</strong> similar to the <code>finally</code> clause, if the registered
+callback returns a rejected promise or throws an error, it will silently
+replace the rejection error (if any) from this promise:</p>
+<pre><code>try {
+  throw Error(&#39;one&#39;);
+} finally {
+  throw Error(&#39;two&#39;);  // Hides Error: one
+}
+
+promise.rejected(Error(&#39;one&#39;))
+    .thenFinally(function() {
+      throw Error(&#39;two&#39;);  // Hides Error: one
+    });
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenFinally">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(): (R|IThenable&lt;R&gt;)</code><dd><p>The function
+to call when this promise is resolved.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be fulfilled
+with the callback result.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_http_CorsClient.html b/docs/class_webdriver_http_CorsClient.html
index 7a7b1f1..cbffd87 100644
--- a/docs/class_webdriver_http_CorsClient.html
+++ b/docs/class_webdriver_http_CorsClient.html
@@ -30,4 +30,4 @@
      onerror handler, but without the corresponding response text returned by
      the server. This renders IE and Opera incapable of handling command
      failures in the standard JSON protocol.
- </ul><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.http.CorsClient <span class="args">( url )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL for the WebDriver server to send commands to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/corsclient.js.src.html#l96">code &raquo;</a><span class="member"><a name="send">send</a> <span class="args">( request, callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>request<dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/corsclient.js.src.html#l71">code &raquo;</a><span class="member"><a name="url_">url_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/corsclient.js.src.html#l88">code &raquo;</a><span class="member"><a name="webdriver.http.CorsClient.isAvailable">webdriver.http.CorsClient.isAvailable</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether the current environment supports cross-origin resource sharing.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether cross-origin resource sharing is supported.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/corsclient.js.src.html#l80">code &raquo;</a><span class="member"><a name="webdriver.http.CorsClient.XDRPC_ENDPOINT">webdriver.http.CorsClient.XDRPC_ENDPOINT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Resource URL to send commands to on the server.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ </ul><h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.http.CorsClient <span class="args">( url )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL for the WebDriver server to send commands to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/corsclient.js.src.html#l96">code &raquo;</a><span class="member"><a name="send">send</a> <span class="args">( request, callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>request<dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/corsclient.js.src.html#l71">code &raquo;</a><span class="member"><a name="url_">url_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/corsclient.js.src.html#l88">code &raquo;</a><span class="member"><a name="webdriver.http.CorsClient.isAvailable">webdriver.http.CorsClient.isAvailable</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether the current environment supports cross-origin resource sharing.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether cross-origin resource sharing is supported.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/corsclient.js.src.html#l80">code &raquo;</a><span class="member"><a name="webdriver.http.CorsClient.XDRPC_ENDPOINT">webdriver.http.CorsClient.XDRPC_ENDPOINT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Resource URL to send commands to on the server.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_http_Executor.html b/docs/class_webdriver_http_Executor.html
index 1e656a3..09b05c9 100644
--- a/docs/class_webdriver_http_Executor.html
+++ b/docs/class_webdriver_http_Executor.html
@@ -1,8 +1,22 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.http.Executor</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.http.Executor</h1><a class="source" href="source/lib/webdriver/http/http.js.src.html#l65">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></dl></header><section><p>A command executor that communicates with a server using the WebDriver
- command protocol.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.http.Executor <span class="args">( client )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>client: <code class="type">!<a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code><dd>The client to use when sending
-     requests to the server.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l76">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( command, callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>command<dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l71">code &raquo;</a><span class="member"><a name="client_">client_</a> : <code class="type">!<a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code></span></div><p>Client used to communicate with the server.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l112">code &raquo;</a><span class="member"><a name="webdriver.http.Executor.buildPath_">webdriver.http.Executor.buildPath_</a> <span class="args">( path, parameters )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Builds a fully qualified path using the given set of command parameters. Each
- path segment prefixed with ':' will be replaced by the value of the
- corresponding parameter. All parameters spliced into the path will be
- removed from the parameter map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The original resource path.<dt>parameters: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The parameters object to splice into
-     the path.</dl><tr><th>Returns<tr><td><dl>The modified path.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l145">code &raquo;</a><span class="member"><a name="webdriver.http.Executor.parseHttpResponse_">webdriver.http.Executor.parseHttpResponse_</a> <span class="args">( httpResponse )</span> &rArr; <code class="type">!<a href="namespace_bot_response.html#bot.response.ResponseObject">bot.response.ResponseObject</a></code></span></div><p>Callback used to parse <code  class="type"><a href="class_webdriver_http_Response.html">webdriver.http.Response</a></code> objects from a
- <code  class="type"><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>httpResponse: <code class="type">!<a href="class_webdriver_http_Response.html">webdriver.http.Response</a></code><dd>The HTTP response to parse.</dl><tr><th>Returns<tr><td><dl>The parsed response.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l176">code &raquo;</a><span class="member"><a name="webdriver.http.Executor.COMMAND_MAP_">webdriver.http.Executor.COMMAND_MAP_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Maps command names to resource locator.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Executor</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_http.html">webdriver.http</a></div><div class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l69">View Source</a></div><h1>class Executor</h1><dl><dt>All implemented interfaces<dd><code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></dl><p>A command executor that communicates with a server using the WebDriver
+command protocol.</p>
+<h3>new Executor(<wbr>client)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>client<code><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code><dd><p>The client to use when sending
+requests to the server.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="defineCommand" class="function"><div><h3>defineCommand(<wbr>name, method, path)<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l102">code »</a></span></h3><p>Defines a new command for use with this executor. When a command is sent,
+the <code>path</code> will be preprocessed using the command&#39;s parameters; any
+path segments prefixed with &#34;:&#34; will be replaced by the parameter of the
+same name. For example, given &#34;/person/:name&#34; and the parameters
+&#34;{name: &#39;Bob&#39;}&#34;, the final command path will be &#34;/person/Bob&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The command name.</p>
+<dt>method<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The HTTP method to use when sending this command.</p>
+<dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to send the command to, relative to
+the WebDriver server&#39;s command root and of the form
+&#34;/path/:variable/segment&#34;.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="execute" class="function"><div><h3>execute(<wbr>command, callback)<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l109">code »</a></span></h3><p>Executes the given <code>command</code>. If there is an error executing the
+command, the provided callback will be invoked with the offending error.
+Otherwise, the callback will be invoked with a null Error and non-null
+<a href="namespace_bot_response.html#response.ResponseObject"><code>bot.response.ResponseObject</code></a> object.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_CommandExecutor.html#execute">webdriver.CommandExecutor</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to execute.</p>
+<dt>callback<code>function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>, {status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}=): ?</code><dd><p>the function
+to invoke when the command response is ready.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_http_Request.html b/docs/class_webdriver_http_Request.html
index 2c4efb5..8f6392f 100644
--- a/docs/class_webdriver_http_Request.html
+++ b/docs/class_webdriver_http_Request.html
@@ -1,4 +1,12 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.http.Request</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.http.Request</h1><a class="source" href="source/lib/webdriver/http/http.js.src.html#l343">code &raquo;</a></header><section><p>Describes a partial HTTP request. This class is a "partial" request and only
- defines the path on the server to send a request to. It is each
- <code >webdriver.http.Client</code>'s responsibility to build the full URL for the
- final request.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.http.Request <span class="args">( method, path, opt_data )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>method: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The HTTP method to use for the request.<dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Path on the server to send the request to.<dt>opt_data: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>This request's JSON data.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l372">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l361">code &raquo;</a><span class="member"><a name="data">data</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>This request's body.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l367">code &raquo;</a><span class="member"><a name="headers">headers</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>The headers to send with the request.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l349">code &raquo;</a><span class="member"><a name="method">method</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The HTTP method to use for the request.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l355">code &raquo;</a><span class="member"><a name="path">path</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The path on the server to send the request to.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Request</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_http.html">webdriver.http</a></div><div class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l404">View Source</a></div><h1>class Request</h1><p>Describes a partial HTTP request. This class is a &#34;partial&#34; request and only
+defines the path on the server to send a request to. It is each
+<a href="interface_webdriver_http_Client.html"><code>webdriver.http.Client</code></a>&#39;s responsibility to build the full URL for the
+final request.</p>
+<h3>new Request(<wbr>method, path, opt_data)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>method<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The HTTP method to use for the request.</p>
+<dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path on the server to send the request to.</p>
+<dt>opt_data<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>This request&#39;s JSON data.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l433">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></div></div></div></div><h2>Instance Properties</h2><div id="data" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l422">data</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>This request&#39;s body.</p>
+</dl></div><div id="headers" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l428">headers</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)&gt;</code><dd><p>The headers to send with the request.</p>
+</dl></div><div id="method" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l410">method</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The HTTP method to use for the request.</p>
+</dl></div><div id="path" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l416">path</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path on the server to send the request to.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_http_Response.html b/docs/class_webdriver_http_Response.html
index c39d270..785057a 100644
--- a/docs/class_webdriver_http_Response.html
+++ b/docs/class_webdriver_http_Response.html
@@ -1,3 +1,13 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.http.Response</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.http.Response</h1><a class="source" href="source/lib/webdriver/http/http.js.src.html#l391">code &raquo;</a></header><section><p>Represents a HTTP response.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.http.Response <span class="args">( status, headers, body )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>status: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The response code.<dt>headers: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The response headers. All header
-     names will be converted to lowercase strings for consistent lookups.<dt>body: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The response body.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l449">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l403">code &raquo;</a><span class="member"><a name="body">body</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The response body.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l409">code &raquo;</a><span class="member"><a name="headers">headers</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>The response body.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l397">code &raquo;</a><span class="member"><a name="status">status</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The HTTP response code.</summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l422">code &raquo;</a><span class="member"><a name="webdriver.http.Response.fromXmlHttpRequest">webdriver.http.Response.fromXmlHttpRequest</a> <span class="args">( xhr )</span> &rArr; <code class="type">!<a href="class_webdriver_http_Response.html">webdriver.http.Response</a></code></span></div><p>Builds a <code >webdriver.http.Response</code> from a <code >XMLHttpRequest</code> or
- <code >XDomainRequest</code> response object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>xhr: <code class="type">!(<a href="http://msdn.microsoft.com/en-us/library/cc288060(v=vs.85).aspx">XDomainRequest</a>|<a href="http://www.w3.org/TR/XMLHttpRequest/#xmlhttprequest-object">XMLHttpRequest</a>)</code><dd>The request to parse.</dl><tr><th>Returns<tr><td><dl>The parsed response.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Response</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_http.html">webdriver.http</a></div><div class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l452">View Source</a></div><h1>class Response</h1><p>Represents a HTTP response.</p>
+<h3>new Response(<wbr>status, headers, body)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>status<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The response code.</p>
+<dt>headers<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>The response headers. All header
+names will be converted to lowercase strings for consistent lookups.</p>
+<dt>body<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The response body.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l510">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></div></div></div></div><h2>Instance Properties</h2><div id="body" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l464">body</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The response body.</p>
+</dl></div><div id="headers" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l470">headers</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>The response body.</p>
+</dl></div><div id="status" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l458">status</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The HTTP response code.</p>
+</dl></div><h2>Static Functions</h2><div id="Response.fromXmlHttpRequest" class="function"><div><h3>Response.fromXmlHttpRequest(<wbr>xhr)<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l483">code »</a></span></h3><p>Builds a <a href="class_webdriver_http_Response.html"><code>webdriver.http.Response</code></a> from a <code>XMLHttpRequest</code> or
+<code>XDomainRequest</code> response object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>xhr<code>(XDomainRequest|XMLHttpRequest)</code><dd><p>The request to parse.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_http_Response.html">webdriver.http.Response</a></code><dd><p>The parsed response.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_http_XhrClient.html b/docs/class_webdriver_http_XhrClient.html
index d53dfaa..1ed338f 100644
--- a/docs/class_webdriver_http_XhrClient.html
+++ b/docs/class_webdriver_http_XhrClient.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.http.XhrClient</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.http.XhrClient</h1><a class="source" href="source/lib/webdriver/http/xhrclient.js.src.html#l31">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code></dl></header><section><p>A HTTP client that sends requests using XMLHttpRequests.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.http.XhrClient <span class="args">( url )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL for the WebDriver server to send commands to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/xhrclient.js.src.html#l39">code &raquo;</a><span class="member"><a name="send">send</a> <span class="args">( request, callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>request<dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/xhrclient.js.src.html#l34">code &raquo;</a><span class="member"><a name="url_">url_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.http.XhrClient</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.http.XhrClient</h1><a class="source" href="source/lib/webdriver/http/xhrclient.js.src.html#l31">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code></dl></header><section><p>A HTTP client that sends requests using XMLHttpRequests.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.http.XhrClient <span class="args">( url )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL for the WebDriver server to send commands to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/xhrclient.js.src.html#l39">code &raquo;</a><span class="member"><a name="send">send</a> <span class="args">( request, callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>request<dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/http/xhrclient.js.src.html#l34">code &raquo;</a><span class="member"><a name="url_">url_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_logging_Entry.html b/docs/class_webdriver_logging_Entry.html
index c6f0822..acb8ad9 100644
--- a/docs/class_webdriver_logging_Entry.html
+++ b/docs/class_webdriver_logging_Entry.html
@@ -1,4 +1,15 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.logging.Entry</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.logging.Entry</h1><a class="source" href="source/lib/webdriver/logging.js.src.html#l103">code &raquo;</a></header><section><p>A single log entry.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.logging.Entry <span class="args">( level, message, opt_timestamp, opt_type )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>level: <code class="type">(!<a href="enum_webdriver_logging_Level.html">webdriver.logging.Level</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>The entry level.<dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The log message.<dt>opt_timestamp: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The time this entry was generated, in
-     milliseconds since 0:00:00, January 1, 1970 UTC. If omitted, the
-     current time will be used.<dt>opt_type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The log type, if known.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/logging.js.src.html#l124">code &raquo;</a><span class="member"><a name="toJSON">toJSON</a> <span class="args">( )</span> &rArr; <code class="type">{level: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, message: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, timestamp: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, type: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The JSON representation of this entry.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/logging.js.src.html#l110">code &raquo;</a><span class="member"><a name="message">message</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/logging.js.src.html#l113">code &raquo;</a><span class="member"><a name="timestamp">timestamp</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/logging.js.src.html#l116">code &raquo;</a><span class="member"><a name="type">type</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/logging.js.src.html#l141">code &raquo;</a><span class="member"><a name="webdriver.logging.Entry.fromClosureLogRecord">webdriver.logging.Entry.fromClosureLogRecord</a> <span class="args">( logRecord, opt_type )</span> &rArr; <code class="type">!<a href="class_webdriver_logging_Entry.html">webdriver.logging.Entry</a></code></span></div><p>Converts a <code  class="type"><a class="unresolved-link">goog.debug.LogRecord</a></code> into a
- <code  class="type"><a href="class_webdriver_logging_Entry.html">webdriver.logging.Entry</a></code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>logRecord: <code class="type">!goog.debug.LogRecord</code><dd>The record to convert.<dt>opt_type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The log type.</dl><tr><th>Returns<tr><td><dl>The converted entry.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Entry</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_logging.html">webdriver.logging</a></div><div class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l347">View Source</a></div><h1>class Entry</h1><p>A single log entry recorded by a WebDriver component, such as a remote
+WebDriver server.</p>
+<h3>new Entry(<wbr>level, message, opt_timestamp, opt_type)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code>(<a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The entry level.</p>
+<dt>message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The log message.</p>
+<dt>opt_timestamp<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The time this entry was generated, in
+milliseconds since 0:00:00, January 1, 1970 UTC. If omitted, the
+current time will be used.</p>
+<dt>opt_type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The log type, if known.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toJSON" class="function"><div><h3>toJSON(<wbr>arg0)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l338">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arg0<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{level: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, message: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, timestamp: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, type: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>The JSON representation of this entry.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="level" class="property"><dl><dt><a href="source/lib/webdriver/logging.js.src.html#l305">level</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd>No description.</dl></div><div id="message" class="property"><dl><dt><a href="source/lib/webdriver/logging.js.src.html#l308">message</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="timestamp" class="property"><dl><dt><a href="source/lib/webdriver/logging.js.src.html#l311">timestamp</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>No description.</dl></div><div id="type" class="property"><dl><dt><a href="source/lib/webdriver/logging.js.src.html#l314">type</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><h2>Static Functions</h2><div id="Entry.fromClosureLogRecord" class="function"><div><h3>Entry.fromClosureLogRecord(<wbr>logRecord, opt_type)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l325">code »</a></span></h3><p>Converts a <a href="class_webdriver_logging_LogRecord.html"><code>goog.debug.LogRecord</code></a> into a
+<a href="class_webdriver_logging_Entry.html"><code>webdriver.logging.Entry</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>logRecord<code><a href="class_webdriver_logging_LogRecord.html">webdriver.logging.LogRecord</a></code><dd><p>The record to convert.</p>
+<dt>opt_type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The log type.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Entry.html">webdriver.logging.Entry</a></code><dd><p>The converted entry.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_logging_Level.html b/docs/class_webdriver_logging_Level.html
new file mode 100644
index 0000000..1671f7e
--- /dev/null
+++ b/docs/class_webdriver_logging_Level.html
@@ -0,0 +1,55 @@
+<!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>Level</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_logging.html">webdriver.logging</a></div><div class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l86">View Source</a></div><h1>class Level</h1><p>The Level class defines a set of standard logging levels that
+can be used to control logging output.  The logging Level objects
+are ordered and are specified by ordered integers.  Enabling logging
+at a given level also enables logging at all higher levels.</p>
+<p>
+Clients should normally use the predefined Level constants such
+as Level.SEVERE.
+</p><p>
+The levels in descending order are:
+</p><ul><li>SEVERE (highest value)
+</li><li>WARNING
+</li><li>INFO
+</li><li>CONFIG
+</li><li>FINE
+</li><li>FINER
+</li><li>FINEST  (lowest value)
+</li></ul>
+In addition there is a level OFF that can be used to turn
+off logging, and a level ALL that can be used to enable
+logging of all messages.
+<h3>new Level(<wbr>name, value)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the level.</p>
+<dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The numeric value of the level.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l176">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>String representation of the logger level.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="name" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l162">name</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the level</p>
+</dl></div><div id="value" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l168">value</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The numeric value of the level</p>
+</dl></div><h2>Static Functions</h2><div id="Level.getPredefinedLevel" class="function"><div><h3>Level.getPredefinedLevel(<wbr>name)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l308">code »</a></span></h3><p>Gets the predefined level with the given name.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the level.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>The level, or null if none found.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Level.getPredefinedLevelByValue" class="function"><div><h3>Level.getPredefinedLevelByValue(<wbr>value)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l322">code »</a></span></h3><p>Gets the highest predefined level &lt;&#61; #value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>Level value.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>The level, or null if none found.</p>
+</dl></div></div></div></div><h2>Static Properties</h2><div id="Level.ALL" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l259">Level.ALL</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>ALL indicates that all messages should be logged.
+This level is initialized to <code>0</code>.</p>
+</dl></div><div id="Level.CONFIG" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l227">Level.CONFIG</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>CONFIG is a message level for static configuration messages.
+This level is initialized to <code>700</code>.</p>
+</dl></div><div id="Level.DEBUG" class="property"><dl><dt><a href="source/lib/webdriver/logging.js.src.html#l94">Level.DEBUG</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>DEBUG is a message level for debugging messages and has the same log level
+as the <a href="class_webdriver_logging_Level.html#Level.CONFIG"><code>Logger.Level.CONFIG</code></a> message level.</p>
+</dl></div><div id="Level.FINE" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l235">Level.FINE</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>FINE is a message level providing tracing information.
+This level is initialized to <code>500</code>.</p>
+</dl></div><div id="Level.FINER" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l243">Level.FINER</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>FINER indicates a fairly detailed tracing message.
+This level is initialized to <code>400</code>.</p>
+</dl></div><div id="Level.FINEST" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l251">Level.FINEST</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>FINEST indicates a highly detailed tracing message.
+This level is initialized to <code>300</code>.</p>
+</dl></div><div id="Level.INFO" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l219">Level.INFO</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>INFO is a message level for informational messages.
+This level is initialized to <code>800</code>.</p>
+</dl></div><div id="Level.OFF" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l186">Level.OFF</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>OFF is a special level that can be used to turn off logging.
+This level is initialized to <code>Infinity</code>.</p>
+</dl></div><div id="Level.PREDEFINED_LEVELS" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l267">Level.PREDEFINED_LEVELS</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a>&gt;</code><dd><p>The predefined levels.</p>
+</dl></div><div id="Level.SEVERE" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l203">Level.SEVERE</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>SEVERE is a message level indicating a serious failure.
+This level is initialized to <code>1000</code>.</p>
+</dl></div><div id="Level.SHOUT" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l195">Level.SHOUT</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>SHOUT is a message level for extra debugging loudness.
+This level is initialized to <code>1200</code>.</p>
+</dl></div><div id="Level.WARNING" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l211">Level.WARNING</a><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>WARNING is a message level indicating a potential problem.
+This level is initialized to <code>900</code>.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_logging_LogRecord.html b/docs/class_webdriver_logging_LogRecord.html
new file mode 100644
index 0000000..37154d7
--- /dev/null
+++ b/docs/class_webdriver_logging_LogRecord.html
@@ -0,0 +1,45 @@
+<!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>LogRecord</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_logging.html">webdriver.logging</a></div><div class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l78">View Source</a></div><h1>class LogRecord</h1><p>LogRecord objects are used to pass logging requests between
+the logging framework and individual log Handlers.</p>
+<h3>new LogRecord(<wbr>level, msg, loggerName, opt_time, opt_sequenceNumber)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>One of the level identifiers.</p>
+<dt>msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string message.</p>
+<dt>loggerName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the source logger.</p>
+<dt>opt_time<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>Time this log record was created if other than now.
+If 0, we use #goog.now.</p>
+<dt>opt_sequenceNumber<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>Sequence number of this log record. This
+should only be passed in when restoring a log record from persistence.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getException" class="function"><div><h3>getException()<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l148">code »</a></span></h3><p>Get the exception that is part of the log record.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>the exception.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLevel" class="function"><div><h3>getLevel()<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l177">code »</a></span></h3><p>Get the logging message level, for example Level.SEVERE.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>the logging message level.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLoggerName" class="function"><div><h3>getLoggerName()<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l138">code »</a></span></h3><p>Get the source Logger&#39;s name.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>source logger name (may be null).</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getMessage" class="function"><div><h3>getMessage()<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l196">code »</a></span></h3><p>Get the &#34;raw&#34; log message, before localization or formatting.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>the raw message string.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getMillis" class="function"><div><h3>getMillis()<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l216">code »</a></span></h3><p>Get event time in milliseconds since 1970.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>event time in millis since 1970.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSequenceNumber" class="function"><div><h3>getSequenceNumber()<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l239">code »</a></span></h3><p>Get the sequence number.</p>
+<p>
+Sequence numbers are normally assigned in the LogRecord
+constructor, which assigns unique sequence numbers to
+each new LogRecord in increasing order.
+</p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>the sequence number.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="reset" class="function"><div><h3>reset(<wbr>level, msg, loggerName, opt_time, opt_sequenceNumber)<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l118">code »</a></span></h3><p>Sets all fields of the log record.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>One of the level identifiers.</p>
+<dt>msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string message.</p>
+<dt>loggerName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the source logger.</p>
+<dt>opt_time<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>Time this log record was created if other than now.
+If 0, we use #goog.now.</p>
+<dt>opt_sequenceNumber<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>Sequence number of this log record. This
+should only be passed in when restoring a log record from persistence.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setException" class="function"><div><h3>setException(<wbr>exception)<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l158">code »</a></span></h3><p>Set the exception that is part of the log record.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>exception<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>the exception.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLevel" class="function"><div><h3>setLevel(<wbr>level)<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l186">code »</a></span></h3><p>Set the logging message level, for example Level.SEVERE.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>the logging message level.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggerName" class="function"><div><h3>setLoggerName(<wbr>loggerName)<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l168">code »</a></span></h3><p>Get the source Logger&#39;s name.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>loggerName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>source logger name (may be null).</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setMessage" class="function"><div><h3>setMessage(<wbr>msg)<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l206">code »</a></span></h3><p>Set the &#34;raw&#34; log message, before localization or formatting.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>the raw message string.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setMillis" class="function"><div><h3>setMillis(<wbr>time)<span class="codelink"><a href="source/lib/goog/debug/logrecord.js.src.html#l226">code »</a></span></h3><p>Set event time in milliseconds since 1970.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>time<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>event time in millis since 1970.</p>
+</dl></div></div></div></div><h2>Compiler Constants</h2><div id="LogRecord.ENABLE_SEQUENCE_NUMBERS" class="property"><dl><dt><a href="source/lib/goog/debug/logrecord.js.src.html#l96">LogRecord.ENABLE_SEQUENCE_NUMBERS</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable log sequence numbers.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_logging_Logger.html b/docs/class_webdriver_logging_Logger.html
new file mode 100644
index 0000000..f500dde
--- /dev/null
+++ b/docs/class_webdriver_logging_Logger.html
@@ -0,0 +1,119 @@
+<!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>Logger</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_logging.html">webdriver.logging</a></div><div class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l82">View Source</a></div><h1>class Logger</h1><p>The Logger is an object used for logging debug messages. Loggers are
+normally named, using a hierarchical dot-separated namespace. Logger names
+can be arbitrary strings, but they should normally be based on the package
+name or class name of the logged component, such as goog.net.BrowserChannel.</p>
+<p>The Logger object is loosely based on the java class
+java.util.logging.Logger. It supports different levels of filtering for
+different loggers.</p>
+<p>The logger object should never be instantiated by application code. It
+should always use the goog.debug.Logger.getLogger function.</p>
+<h3>new Logger(<wbr>name)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the Logger.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="addHandler" class="function"><div><h3>addHandler(<wbr>handler)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l400">code »</a></span></h3><p>Adds a handler to the logger. This doesn&#39;t use the event system because
+we want to be able to add logging to the event system.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>handler<code>Function</code><dd><p>Handler function to add.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="config" class="function"><div><h3>config(<wbr>msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l639">code »</a></span></h3><p>Logs a message at the Logger.Level.CONFIG level.
+If the logger is currently enabled for the given message level then the
+given message is forwarded to all the registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>=</code><dd><p>An exception associated with the message.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="fine" class="function"><div><h3>fine(<wbr>msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l653">code »</a></span></h3><p>Logs a message at the Logger.Level.FINE level.
+If the logger is currently enabled for the given message level then the
+given message is forwarded to all the registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>=</code><dd><p>An exception associated with the message.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="finer" class="function"><div><h3>finer(<wbr>msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l667">code »</a></span></h3><p>Logs a message at the Logger.Level.FINER level.
+If the logger is currently enabled for the given message level then the
+given message is forwarded to all the registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>=</code><dd><p>An exception associated with the message.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="finest" class="function"><div><h3>finest(<wbr>msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l681">code »</a></span></h3><p>Logs a message at the Logger.Level.FINEST level.
+If the logger is currently enabled for the given message level then the
+given message is forwarded to all the registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>=</code><dd><p>An exception associated with the message.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getChildren" class="function"><div><h3>getChildren()<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l448">code »</a></span></h3><p>Returns the children of this logger as a map of the child name to the logger.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>The map where the keys are the child leaf names and the
+values are the Logger objects.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getEffectiveLevel" class="function"><div><h3>getEffectiveLevel()<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l498">code »</a></span></h3><p>Returns the effective level of the logger based on its ancestors&#39; levels.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>The level.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLevel" class="function"><div><h3>getLevel()<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l488">code »</a></span></h3><p>Gets the log level specifying which message levels will be logged by this
+logger. Message levels lower than this value will be discarded.
+The level value Level.OFF can be used to turn off logging. If the level
+is null, it means that this node should inherit its level from its nearest
+ancestor with a specific (non-null) level value.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>The level.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLogRecord" class="function"><div><h3>getLogRecord(<wbr>level, msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l561">code »</a></span></h3><p>Creates a new log record and adds the exception (if present) to it.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>One of the level identifiers.</p>
+<dt>msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string message.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>An exception associated with the
+message.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_LogRecord.html">webdriver.logging.LogRecord</a></code><dd><p>A log record.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getName" class="function"><div><h3>getName()<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l390">code »</a></span></h3><p>Gets the name of this logger.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of this logger.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getParent" class="function"><div><h3>getParent()<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l438">code »</a></span></h3><p>Returns the parent of this logger.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Logger.html">webdriver.logging.Logger</a></code><dd><p>The parent logger or null if this is the root.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="info" class="function"><div><h3>info(<wbr>msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l625">code »</a></span></h3><p>Logs a message at the Logger.Level.INFO level.
+If the logger is currently enabled for the given message level then the
+given message is forwarded to all the registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>=</code><dd><p>An exception associated with the message.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isLoggable" class="function"><div><h3>isLoggable(<wbr>level)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l524">code »</a></span></h3><p>Checks if a message of the given level would actually be logged by this
+logger. This check is based on the Loggers effective level, which may be
+inherited from its parent.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>The level to check.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the message would be logged.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="log" class="function"><div><h3>log(<wbr>level, msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l539">code »</a></span></h3><p>Logs a message. If the logger is currently enabled for the
+given message level then the given message is forwarded to all the
+registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>One of the level identifiers.</p>
+<dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>An exception associated with the
+message.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="logRecord" class="function"><div><h3>logRecord(<wbr>logRecord)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l694">code »</a></span></h3><p>Logs a LogRecord. If the logger is currently enabled for the
+given message level then the given message is forwarded to all the
+registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>logRecord<code><a href="class_webdriver_logging_LogRecord.html">webdriver.logging.LogRecord</a></code><dd><p>A log record to log.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="removeHandler" class="function"><div><h3>removeHandler(<wbr>handler)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l423">code »</a></span></h3><p>Removes a handler from the logger. This doesn&#39;t use the event system because
+we want to be able to add logging to the event system.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>handler<code>Function</code><dd><p>Handler function to remove.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the handler was removed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLevel" class="function"><div><h3>setLevel(<wbr>level)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l465">code »</a></span></h3><p>Set the log level specifying which message levels will be logged by this
+logger. Message levels lower than this value will be discarded.
+The level value Level.OFF can be used to turn off logging. If the new level
+is null, it means that this node should inherit its level from its nearest
+ancestor with a specific (non-null) level value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>The new level.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="severe" class="function"><div><h3>severe(<wbr>msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l597">code »</a></span></h3><p>Logs a message at the Logger.Level.SEVERE level.
+If the logger is currently enabled for the given message level then the
+given message is forwarded to all the registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>=</code><dd><p>An exception associated with the message.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="shout" class="function"><div><h3>shout(<wbr>msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l583">code »</a></span></h3><p>Logs a message at the Logger.Level.SHOUT level.
+If the logger is currently enabled for the given message level then the
+given message is forwarded to all the registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>=</code><dd><p>An exception associated with the message.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="warning" class="function"><div><h3>warning(<wbr>msg, opt_exception)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l611">code »</a></span></h3><p>Logs a message at the Logger.Level.WARNING level.
+If the logger is currently enabled for the given message level then the
+given message is forwarded to all the registered output Handler objects.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The message to log.</p>
+<dt>opt_exception<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>=</code><dd><p>An exception associated with the message.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="Logger.getLogger" class="function"><div><h3>Logger.getLogger(<wbr>name)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l355">code »</a></span></h3><div class="tags"><span>deprecated</span></div><p>Finds or creates a logger for a named subsystem. If a logger has already been
+created with the given name it is returned. Otherwise a new logger is
+created. If a new logger is created its log level will be configured based
+on the LogManager configuration and it will configured to also send logging
+output to its parent&#39;s handlers. It will be registered in the LogManager
+global namespace.</p>
+<dl><dt>Deprecated<dd><p>use goog.log instead. http://go/goog-debug-logger-deprecated</p>
+</dl><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A name for the logger. This should be a dot-separated
+name and should normally be based on the package name or class name of the
+subsystem, such as goog.net.BrowserChannel.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Logger.html">webdriver.logging.Logger</a></code><dd><p>The named logger.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Logger.logToProfilers" class="function"><div><h3>Logger.logToProfilers(<wbr>msg)<span class="codelink"><a href="source/lib/goog/debug/logger.js.src.html#l366">code »</a></span></h3><p>Logs a message to profiling tools, if available.
+https://developers.google.com/web-toolkit/speedtracer/logging-api
+http://msdn.microsoft.com/en-us/library/dd433074(VS.85).aspx</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The message to log.</p>
+</dl></div></div></div></div><h2>Static Properties</h2><div id="Logger.ROOT_LOGGER_NAME" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l101">Logger.ROOT_LOGGER_NAME</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><h2>Compiler Constants</h2><div id="Logger.ENABLE_HIERARCHY" class="property"><dl><dt><a href="source/lib/goog/debug/logger.js.src.html#l109">Logger.ENABLE_HIERARCHY</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Toggles whether loggers other than the root logger can have
+log handlers attached to them and whether they can have their log level
+set. Logging is a bit faster when this is set to false.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_logging_Preferences.html b/docs/class_webdriver_logging_Preferences.html
new file mode 100644
index 0000000..baccf72
--- /dev/null
+++ b/docs/class_webdriver_logging_Preferences.html
@@ -0,0 +1,8 @@
+<!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>Preferences</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_logging.html">webdriver.logging</a></div><div class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l284">View Source</a></div><h1>class Preferences</h1><p>Describes the log preferences for a WebDriver session.</p>
+<h3>new Preferences()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="setLevel" class="function"><div><h3>setLevel(<wbr>type, level)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l265">code »</a></span></h3><p>Sets the desired logging level for a particular log type.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The log type.</p>
+<dt>level<code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>The desired log level.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toJSON" class="function"><div><h3>toJSON(<wbr>arg0)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l274">code »</a></span></h3><p>Converts this instance to its JSON representation.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arg0<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>The JSON representation of this set of
+preferences.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_CanceledTaskError_.html b/docs/class_webdriver_promise_CanceledTaskError_.html
index cd0697e..95c978b 100644
--- a/docs/class_webdriver_promise_CanceledTaskError_.html
+++ b/docs/class_webdriver_promise_CanceledTaskError_.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.CanceledTaskError_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.CanceledTaskError_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l2035">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.CanceledTaskError_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.CanceledTaskError_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l2078">code &raquo;</a><pre><code><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>
   &#x2514; <a href="class_goog_debug_Error.html">goog.debug.Error</a>
       &#x2514; webdriver.promise.CanceledTaskError_</code></pre></header><section><p>Special error used to signal when a task is canceled because a previous
- task in the same frame failed.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">webdriver.promise.CanceledTaskError_ <span class="args">( err )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>err: <code class="type">*</code><dd>The error that caused the task cancellation.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2035">code &raquo;</a><span class="member"><a name="webdriver.promise.CanceledTaskError_.superClass_">webdriver.promise.CanceledTaskError_.superClass_</a> : <code class="type"><a href="class_goog_debug_Error.html">goog.debug.Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ task in the same frame failed.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">webdriver.promise.CanceledTaskError_ <span class="args">( err )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>err: <code class="type">*</code><dd>The error that caused the task cancellation.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2078">code &raquo;</a><span class="member"><a name="webdriver.promise.CanceledTaskError_.superClass_">webdriver.promise.CanceledTaskError_.superClass_</a> : <code class="type"><a href="class_goog_debug_Error.html">goog.debug.Error.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_CancellationError.html b/docs/class_webdriver_promise_CancellationError.html
new file mode 100644
index 0000000..d1bc202
--- /dev/null
+++ b/docs/class_webdriver_promise_CancellationError.html
@@ -0,0 +1,17 @@
+<!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>CancellationError</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_promise.html">webdriver.promise</a></div><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l696">View Source</a></div><h1>class CancellationError</h1><pre class="inheritance"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>
+  &#x2514; goog.debug.Error
+      &#x2514; webdriver.promise.CancellationError</pre><p>Error used when the computation of a promise is cancelled.</p>
+<h3>new CancellationError(<wbr>opt_msg)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The cancellation message.</p>
+</dl></div></div><h2>Instance Properties</h2><div id="description" class="property"><dl><dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>IE-only.</p>
+</dl></div><div id="fileName" class="property"><dl><dt>fileName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Mozilla-only</p>
+</dl></div><div id="lineNumber" class="property"><dl><dt>lineNumber<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>Mozilla-only.</p>
+</dl></div><div id="message" class="property"><dl><dt><a href="source/lib/goog/debug/error.js.src.html#l47">message</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="name" class="property"><dl><dt><a href="source/lib/webdriver/promise.js.src.html#l704">name</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="reportErrorToServer" class="property"><dl><dt><a href="source/lib/goog/debug/error.js.src.html#l57">reportErrorToServer</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to report this error to the server. Setting this to false will
+cause the error reporter to not report the error back to the server,
+which can be useful if the client knows that the error has already been
+logged on the server.</p>
+</dl></div><div id="sourceURL" class="property"><dl><dt>sourceURL<code>?</code><dd><p>Doesn&#39;t seem to exist, but closure/debug.js references it.</p>
+</dl></div><div id="stack" class="property"><dl><dt><a href="source/lib/goog/debug/error.js.src.html#l42">stack</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><h2>Static Functions</h2><div id="CancellationError.wrap" class="function"><div><h3>CancellationError.wrap(<wbr>error, opt_msg)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l718">code »</a></span></h3><p>Wraps the given error in a CancellationError.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>error<code>*</code><dd><p>The error to wrap.</p>
+<dt>opt_msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The prefix message to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_CancellationError.html">webdriver.promise.CancellationError</a></code><dd><p>A cancellation error.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_ControlFlow.html b/docs/class_webdriver_promise_ControlFlow.html
index 1edb7cd..08ff2e7 100644
--- a/docs/class_webdriver_promise_ControlFlow.html
+++ b/docs/class_webdriver_promise_ControlFlow.html
@@ -1,116 +1,153 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.ControlFlow</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.ControlFlow</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l1004">code &raquo;</a><pre><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a>
-  &#x2514; webdriver.promise.ControlFlow</code></pre></header><section><p>Handles the execution of scheduled tasks, each of which may be an
- asynchronous operation. The control flow will ensure tasks are executed in
- the ordered scheduled, starting each task only once those before it have
- completed.
-
- <p>Each task scheduled within this flow may return a
- <code  class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code> to indicate it is an asynchronous
- operation. The ControlFlow will wait for such promises to be resolved before
- marking the task as completed.
-
- <p>Tasks and each callback registered on a <code  class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code>
- will be run in their own ControlFlow frame.  Any tasks scheduled within a
- frame will have priority over previously scheduled tasks. Furthermore, if
- any of the tasks in the frame fails, the remainder of the tasks in that frame
- will be discarded and the failure will be propagated to the user through the
- callback/task's promised result.
-
- <p>Each time a ControlFlow empties its task queue, it will fire an
- <code  class="type"><a href="enum_webdriver_promise_ControlFlow_EventType.html#webdriver.promise.ControlFlow.EventType.IDLE">webdriver.promise.ControlFlow.EventType.IDLE</a></code> event. Conversely,
- whenever the flow terminates due to an unhandled error, it will remove all
- remaining tasks in its queue and fire an
- <code  class="type"><a href="enum_webdriver_promise_ControlFlow_EventType.html#webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION">webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION</a></code> event. If
- there are no listeners registered with the flow, the error will be
- rethrown to the global error handler.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.promise.ControlFlow <span class="args">( opt_timer )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_timer: <code class="type"><a href="class_webdriver_promise_ControlFlow.html#webdriver.promise.ControlFlow.Timer">webdriver.promise.ControlFlow.Timer</a>=</code><dd>The timer object
-     to use. Should only be set for testing.</dl></table></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_webdriver_promise_ControlFlow_EventType.html">webdriver.promise.ControlFlow.EventType</a><dd>Events that may be emitted by an <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1031">code &raquo;</a><a class="member" name="webdriver.promise.ControlFlow.Timer">webdriver.promise.ControlFlow.Timer</a> : <code class="type">{clearInterval: function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>), clearTimeout: function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>), setInterval: function(!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, setTimeout: function(!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code></div><div>No description.</div></summary></details></div></div></section><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.promise.ControlFlow</code></h3><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1535">code &raquo;</a><span class="member"><a name="abortFrame_">abortFrame_</a> <span class="args">( error )</span></span></div><p>Aborts the current frame. The frame, and all of the tasks scheduled within it
- will be discarded. If this instance does not have an active frame, it will
- immediately terminate all execution.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>error: <code class="type">*</code><dd>The reason the frame is being aborted; typically either
-     an Error or string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1693">code &raquo;</a><span class="member"><a name="abortNow_">abortNow_</a> <span class="args">( error )</span></span></div><p>Aborts this flow, abandoning all remaining tasks. If there are
- listeners registered, an <code >UNCAUGHT_EXCEPTION</code> will be emitted with the
- offending <code >error</code>, otherwise, the <code >error</code> will be rethrown to the
- global error handler.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>error: <code class="type">*</code><dd>Object describing the error that caused the flow to
-     abort; usually either an Error or string value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1246">code &raquo;</a><span class="member"><a name="annotateError">annotateError</a> <span class="args">( e )</span> &rArr; <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|goog.testing.JsUnitException)</code></span></div><p>Appends a summary of this instance's recent task history to the given
- error's stack trace. This function will also ensure the error's stack trace
- is in canonical form.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|goog.testing.JsUnitException)</code><dd>The error to annotate.</dl><tr><th>Returns<tr><td><dl>The annotated error.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1388">code &raquo;</a><span class="member"><a name="await">await</a> <span class="args">( promise )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a task that will wait for another promise to resolve.  The resolved
- promise's value will be returned as the task result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>promise: <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd>The promise to wait on.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve when the
-     task has completed.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1412">code &raquo;</a><span class="member"><a name="cancelEventLoop_">cancelEventLoop_</a> <span class="args">( )</span></span></div><p>Cancels the event loop, if necessary.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1676">code &raquo;</a><span class="member"><a name="cancelShutdown_">cancelShutdown_</a> <span class="args">( )</span></span></div><p>Cancels the shutdown sequence if it is currently scheduled.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1208">code &raquo;</a><span class="member"><a name="clearHistory">clearHistory</a> <span class="args">( )</span></span></div><p>Clears this instance's task history.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1653">code &raquo;</a><span class="member"><a name="commenceShutdown_">commenceShutdown_</a> <span class="args">( )</span></span></div><p>Commences the shutdown sequence for this instance. After one turn of the
- event loop, this object will emit the
- <code  class="type"><a href="enum_webdriver_promise_ControlFlow_EventType.html#webdriver.promise.ControlFlow.EventType.IDLE">webdriver.promise.ControlFlow.EventType.IDLE</a></code> event to signal
- listeners that it has completed. During this wait, if another task is
- scheduled, the shutdown will be aborted.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1286">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( fn, opt_description )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a task for execution. If there is nothing currently in the
- queue, the task will be executed in the next turn of the event loop.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call to start the task. If the
-     function returns a <code  class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code>, this instance
-     will wait for it to be resolved before starting the next task.<dt>opt_description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A description of the task.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with
-     the result of the action.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1187">code &raquo;</a><span class="member"><a name="getHistory">getHistory</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns a summary of the recent task activity for this instance. This
- includes the most recently completed task, as well as any parent tasks. In
- the returned summary, the task at index N is considered a sub-task of the
- task at index N+1.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A summary of this instance's recent task
-     activity.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1484">code &raquo;</a><span class="member"><a name="getNextTask_">getNextTask_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The next task to execute, or
-     <code >null</code> if a frame was resolved.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1270">code &raquo;</a><span class="member"><a name="getSchedule">getSchedule</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The scheduled tasks still pending with this instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1170">code &raquo;</a><span class="member"><a name="reset">reset</a> <span class="args">( )</span></span></div><p>Resets this instance, clearing its queue and removing all event listeners.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1507">code &raquo;</a><span class="member"><a name="resolveFrame_">resolveFrame_</a> <span class="args">( frame )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frame: <code class="type">!<a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a></code><dd>The frame to resolve.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1427">code &raquo;</a><span class="member"><a name="runEventLoop_">runEventLoop_</a> <span class="args">( )</span></span></div><p>Executes the next task for the current frame. If the current frame has no
- more tasks, the frame's result will be resolved, returning control to the
- frame's creator. This will terminate the flow if the completed frame was at
- the top of the stack.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1576">code &raquo;</a><span class="member"><a name="runInNewFrame_">runInNewFrame_</a> <span class="args">( fn, callback, errback, opt_activate )</span></span></div><p>Executes a function in a new frame. If the function does not schedule any new
- tasks, the frame will be discarded and the function's result returned
- immediately. Otherwise, a promise will be returned. This promise will be
- resolved with the function's result once all of the tasks scheduled within
- the function have been completed. If the function's frame is aborted, the
- returned promise will be rejected.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to execute.<dt>callback: <code class="type">function(*)</code><dd>The function to call with a successful result.<dt>errback: <code class="type">function(*)</code><dd>The function to call if there is an error.<dt>opt_activate: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether the active frame should be updated to
-     the newly created frame so tasks are treated as sub-tasks.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1399">code &raquo;</a><span class="member"><a name="scheduleEventLoopStart_">scheduleEventLoopStart_</a> <span class="args">( )</span></span></div><p>Schedules the interval for this instance's event loop, if necessary.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1318">code &raquo;</a><span class="member"><a name="timeout">timeout</a> <span class="args">( ms, opt_description )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Inserts a <code >setTimeout</code> into the command queue. This is equivalent to
- a thread sleep in a synchronous programming language.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ms: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The timeout delay, in milliseconds.<dt>opt_description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A description to accompany the timeout.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with
-     the result of the action.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1218">code &raquo;</a><span class="member"><a name="trimHistory_">trimHistory_</a> <span class="args">( )</span></span></div><p>Removes a completed task from this instance's history record. If any
- tasks remain from aborted frames, those will be removed as well.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1350">code &raquo;</a><span class="member"><a name="wait">wait</a> <span class="args">( condition, timeout, opt_message )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a task that shall wait for a condition to hold. Each condition
- function may return any value, but it will always be evaluated as a boolean.
-
- <p>Condition functions may schedule sub-tasks with this instance, however,
- their execution time will be factored into whether a wait has timed out.
-
- <p>In the event a condition returns a Promise, the polling loop will wait for
- it to be resolved before evaluating whether the condition has been satisfied.
- The resolution time for a promise is factored into whether a wait has timed
- out.
-
- <p>If the condition function throws, or returns a rejected promise, the
- wait task will fail.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>condition: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The condition function to poll.<dt>timeout: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>How long to wait, in milliseconds, for the condition
-     to hold before timing out.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>An optional error message to include if the
-     wait times out; defaults to the empty string.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
-     condition has been satisified. The promise shall be rejected if the wait
-     times out waiting for the condition.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l116">code &raquo;</a><span class="member"><a name="addListener">addListener</a> <span class="args">( type, listenerFn, opt_scope )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Registers a listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to listen for.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to invoke when the event is fired.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to invoke the listener.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l90">code &raquo;</a><span class="member"><a name="addListener_">addListener_</a> <span class="args">( type, listenerFn, opt_scope, opt_oneshot )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Registers a listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to listen for.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to invoke when the event is fired.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to invoke the listener.<dt>opt_oneshot: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether the listener should be removed after
-    the first event is fired.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l44">code &raquo;</a><span class="member"><a name="emit">emit</a> <span class="args">( type, var_args )</span></span></div><p>Fires an event and calls all listeners.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to emit.<dt>var_args: <code class="type">...*</code><dd>Any arguments to pass to each listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l71">code &raquo;</a><span class="member"><a name="listeners">listeners</a> <span class="args">( type )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns a mutable list of listeners for a specific type of event.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to retrieve the listeners for.</dl><tr><th>Returns<tr><td><dl>The registered listeners for
-     the given event type.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l142">code &raquo;</a><span class="member"><a name="on">on</a> <span class="args">( type, listenerFn, opt_scope )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>An alias for <code >#addListener()</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to listen for.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to invoke when the event is fired.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to invoke the listener.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l130">code &raquo;</a><span class="member"><a name="once">once</a> <span class="args">( type, listenerFn, opt_scope )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Registers a one-time listener which will be called only the first time an
- event is emitted, after which it will be removed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to listen for.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to invoke when the event is fired.<dt>opt_scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object in whose scope to invoke the listener.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l173">code &raquo;</a><span class="member"><a name="removeAllListeners">removeAllListeners</a> <span class="args">( opt_type )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Removes all listeners for a specific type of event. If no event is
- specified, all listeners across all types will be removed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The type of event to remove listeners from.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l152">code &raquo;</a><span class="member"><a name="removeListener">removeListener</a> <span class="args">( type, listenerFn )</span> &rArr; <code class="type">!<a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></span></div><p>Removes a previously registered event listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The type of event to unregister.<dt>listenerFn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The handler function to remove.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.promise.ControlFlow</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1097">code &raquo;</a><span class="member"><a name="activeFrame_">activeFrame_</a> : <code class="type"><a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a></code></span></div><p>Tracks the active execution frame for this instance. Lazily initialized
- when the first task is scheduled.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1137">code &raquo;</a><span class="member"><a name="eventLoopId_">eventLoopId_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Interval ID for this instance's event loop.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1020">code &raquo;</a><span class="member"><a name="history_">history_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>A list of recent tasks. Each time a new task is started, or a frame is
- completed, the previously recorded task is removed from this list. If
- there are multiple tasks, task N+1 is considered a sub-task of task
- N.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1164">code &raquo;</a><span class="member"><a name="numAbortedFrames_">numAbortedFrames_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of aborted frames since the last time a task was executed or a
- frame completed successfully.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1156">code &raquo;</a><span class="member"><a name="pendingRejections_">pendingRejections_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The number of "pending" promise rejections.
-
- <p>Each time a promise is rejected and is not handled by a listener, it will
- schedule a 0-based timeout to check if it is still unrejected in the next
- turn of the JS-event loop. This allows listeners to attach to, and handle,
- the rejected promise at any point in same turn of the event loop that the
- promise was rejected.
-
- <p>When this flow's own event loop triggers, it will not run if there
- are any outstanding promise rejections. This allows unhandled promises to
- be reported before a new task is started, ensuring the error is reported to
- the current task queue.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1109">code &raquo;</a><span class="member"><a name="schedulingFrame_">schedulingFrame_</a> : <code class="type"><a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a></code></span></div><p>A reference to the frame in which new tasks should be scheduled. If
- <code >null</code>, tasks will be scheduled within the active frame. When forcing
- a function to run in the context of a new frame, this pointer is used to
- ensure tasks are scheduled within the newly created frame, even though it
- won't be active yet.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1130">code &raquo;</a><span class="member"><a name="shutdownId_">shutdownId_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Timeout ID set when the flow is about to shutdown without any errors
- being detected. Upon shutting down, the flow will emit an
- <code  class="type"><a href="enum_webdriver_promise_ControlFlow_EventType.html#webdriver.promise.ControlFlow.EventType.IDLE">webdriver.promise.ControlFlow.EventType.IDLE</a></code> event. Idle events
- always follow a brief timeout in order to catch latent errors from the last
- completed task. If this task had a callback registered, but no errback, and
- the task fails, the unhandled failure would not be reported by the promise
- system until the next turn of the event loop:
-
-   // Schedule 1 task that fails.
-   var result = webriver.promise.controlFlow().schedule('example',
-       function() { return webdriver.promise.rejected('failed'); });
-   // Set a callback on the result. This delays reporting the unhandled
-   // failure for 1 turn of the event loop.
-   result.then(goog.nullFunction);</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1011">code &raquo;</a><span class="member"><a name="timer">timer</a> : <code class="type"><a href="class_webdriver_promise_ControlFlow.html#webdriver.promise.ControlFlow.Timer">webdriver.promise.ControlFlow.Timer</a></code></span></div><p>The timer used by this instance.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/events.js.src.html#l35">code &raquo;</a><span class="member"><a name="events_">events_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of events to registered listeners.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1235">code &raquo;</a><span class="member"><a name="webdriver.promise.ControlFlow.ANNOTATION_PROPERTY_">webdriver.promise.ControlFlow.ANNOTATION_PROPERTY_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Property used to track whether an error has been annotated by
- <code  class="type"><a href="class_webdriver_promise_ControlFlow.html#annotateError">webdriver.promise.ControlFlow#annotateError</a></code>.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1089">code &raquo;</a><span class="member"><a name="webdriver.promise.ControlFlow.EVENT_LOOP_FREQUENCY">webdriver.promise.ControlFlow.EVENT_LOOP_FREQUENCY</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>How often, in milliseconds, the event loop should run.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1038">code &raquo;</a><span class="member"><a name="webdriver.promise.ControlFlow.defaultTimer">webdriver.promise.ControlFlow.defaultTimer</a> : <code class="type"><a href="class_webdriver_promise_ControlFlow.html#webdriver.promise.ControlFlow.Timer">webdriver.promise.ControlFlow.Timer</a></code></span></div><p>The default timer object, which uses the global timer functions.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1004">code &raquo;</a><span class="member"><a name="webdriver.promise.ControlFlow.superClass_">webdriver.promise.ControlFlow.superClass_</a> : <code class="type"><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>ControlFlow</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_promise.html">webdriver.promise</a></div><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1909">View Source</a></div><h1>class ControlFlow</h1><pre class="inheritance"><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a>
+  &#x2514; webdriver.promise.ControlFlow</pre><p>Handles the execution of scheduled tasks, each of which may be an
+asynchronous operation. The control flow will ensure tasks are executed in
+the ordered scheduled, starting each task only once those before it have
+completed.</p>
+<p>Each task scheduled within this flow may return a
+<a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a> to indicate it is an asynchronous
+operation. The ControlFlow will wait for such promises to be resolved before
+marking the task as completed.</p>
+<p>Tasks and each callback registered on a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>
+will be run in their own ControlFlow frame.  Any tasks scheduled within a
+frame will take priority over previously scheduled tasks. Furthermore, if any
+of the tasks in the frame fail, the remainder of the tasks in that frame will
+be discarded and the failure will be propagated to the user through the
+callback/task&#39;s promised result.</p>
+<p>Each time a ControlFlow empties its task queue, it will fire an
+<a href="enum_webdriver_promise_ControlFlow_EventType.html#IDLE"><code>IDLE</code></a> event. Conversely,
+whenever the flow terminates due to an unhandled error, it will remove all
+remaining tasks in its queue and fire an
+<a href="enum_webdriver_promise_ControlFlow_EventType.html#UNCAUGHT_EXCEPTION"><code>UNCAUGHT_EXCEPTION</code></a> event. If there are no listeners registered with the
+flow, the error will be rethrown to the global error handler.</p>
+<p>Refer to the <a href="namespace_webdriver_promise.html"><code>webdriver.promise</code></a> module documentation for a detailed
+explanation of how the ControlFlow coordinates task execution.</p>
+<h3>new ControlFlow()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="addListener" class="function"><div><h3>addListener(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l119">code »</a></span></h3><p>Registers a listener.</p>
+<p><b>Defined by: </b><a href="class_webdriver_EventEmitter.html#addListener">webdriver.EventEmitter</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="async" class="function"><div><h3>async(<wbr>fn, opt_self, var_args)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2276">code »</a></span></h3><p>Executes a function in the next available turn of the JavaScript event
+loop. This ensures the function runs with its own task queue and any
+scheduled tasks will run in &#34;parallel&#34; to those scheduled in the current
+function.</p>
+<pre><code>flow.execute(() &#61;&gt; console.log(&#39;a&#39;));
+flow.execute(() &#61;&gt; console.log(&#39;b&#39;));
+flow.execute(() &#61;&gt; console.log(&#39;c&#39;));
+flow.async(() &#61;&gt; {
+   flow.execute(() &#61;&gt; console.log(&#39;d&#39;));
+   flow.execute(() &#61;&gt; console.log(&#39;e&#39;));
+});
+flow.async(() &#61;&gt; {
+   flow.execute(() &#61;&gt; console.log(&#39;f&#39;));
+   flow.execute(() &#61;&gt; console.log(&#39;g&#39;));
+});
+flow.once(&#39;idle&#39;, () &#61;&gt; console.log(&#39;fin&#39;));
+// a
+// d
+// f
+// b
+// e
+// g
+// c
+// fin
+</code></pre>
+<p>If the function itself throws, the error will be treated the same as an
+unhandled rejection within the control flow.</p>
+<p><strong>NOTE</strong>: This function is considered <em>unstable</em>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>Function</code><dd><p>The function to execute.</p>
+<dt>opt_self<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose context to run the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="emit" class="function"><div><h3>emit(<wbr>type, var_args)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l47">code »</a></span></h3><p>Fires an event and calls all listeners.</p>
+<p><b>Defined by: </b><a href="class_webdriver_EventEmitter.html#emit">webdriver.EventEmitter</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to emit.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to each listener.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="execute" class="function"><div><h3><code>&lt;T&gt;</code> execute(<wbr>fn, opt_description)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2099">code »</a></span></h3><p>Schedules a task for execution. If there is nothing currently in the
+queue, the task will be executed in the next turn of the event loop. If
+the task function is a generator, the task will be executed using
+<a href="namespace_webdriver_promise.html#consume"><code>webdriver.promise.consume</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+call to start the task. If the function returns a
+<a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>, this instance will wait for it to be
+resolved before starting the next task.</p>
+<dt>opt_description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A description of the task.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the result of the action.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSchedule" class="function"><div><h3>getSchedule(<wbr>opt_includeStackTraces)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2011">code »</a></span></h3><p>Generates an annotated string describing the internal state of this control
+flow, including the currently executing as well as pending tasks. If
+<code>opt_includeStackTraces &#61;&#61;&#61; true</code>, the string will include the
+stack trace from when each task was scheduled.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_includeStackTraces<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Whether to include the stack traces
+from when each task was scheduled. Defaults to false.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>String representation of this flow&#39;s internal state.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isIdle" class="function"><div><h3>isIdle()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1988">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether this flow is currently idle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="listeners" class="function"><div><h3>listeners(<wbr>type)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l74">code »</a></span></h3><p>Returns a mutable list of listeners for a specific type of event.</p>
+<p><b>Defined by: </b><a href="class_webdriver_EventEmitter.html#listeners">webdriver.EventEmitter</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to retrieve the listeners for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;{fn: Function, oneshot: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, scope: ?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)}&gt;</code><dd><p>The registered listeners for
+the given event type.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="on" class="function"><div><h3>on(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l145">code »</a></span></h3><p>An alias for <code>#addListener()</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_EventEmitter.html#on">webdriver.EventEmitter</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="once" class="function"><div><h3>once(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l133">code »</a></span></h3><p>Registers a one-time listener which will be called only the first time an
+event is emitted, after which it will be removed.</p>
+<p><b>Defined by: </b><a href="class_webdriver_EventEmitter.html#once">webdriver.EventEmitter</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="removeAllListeners" class="function"><div><h3>removeAllListeners(<wbr>opt_type)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l176">code »</a></span></h3><p>Removes all listeners for a specific type of event. If no event is
+specified, all listeners across all types will be removed.</p>
+<p><b>Defined by: </b><a href="class_webdriver_EventEmitter.html#removeAllListeners">webdriver.EventEmitter</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The type of event to remove listeners from.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="removeListener" class="function"><div><h3>removeListener(<wbr>type, listenerFn)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l155">code »</a></span></h3><p>Removes a previously registered event listener.</p>
+<p><b>Defined by: </b><a href="class_webdriver_EventEmitter.html#removeListener">webdriver.EventEmitter</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to unregister.</p>
+<dt>listenerFn<code>Function</code><dd><p>The handler function to remove.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="reset" class="function"><div><h3>reset()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1995">code »</a></span></h3><p>Resets this instance, clearing its queue and removing all event listeners.</p>
+</div></div><hr class="fn-sep"><div id="setPropagateUnhandledRejections" class="function"><div><h3>setPropagateUnhandledRejections(<wbr>propagate)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1981">code »</a></span></h3><p>Sets whether any unhandled rejections should propagate up through the
+control flow stack and cause rejections within parent tasks. If error
+propagation is disabled, tasks will not be aborted when an unhandled
+promise rejection is detected, but the rejection <em>will</em> trigger an
+<a href="enum_webdriver_promise_ControlFlow_EventType.html#UNCAUGHT_EXCEPTION"><code>webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION</code></a>
+event.</p>
+<p>The default behavior is to propagate all unhandled rejections. <em>The use
+of this option is highly discouraged.</em></p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>propagate<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>whether to propagate errors.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="timeout" class="function"><div><h3>timeout(<wbr>ms, opt_description)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2128">code »</a></span></h3><p>Inserts a <code>setTimeout</code> into the command queue. This is equivalent to
+a thread sleep in a synchronous programming language.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The timeout delay, in milliseconds.</p>
+<dt>opt_description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A description to accompany the timeout.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved with
+the result of the action.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1964">code »</a></span></h3><p>Returns a string representation of this control flow, which is its current
+<a href="class_webdriver_promise_ControlFlow.html#getSchedule"><code>schedule</code></a>, sans task stack traces.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string representation of this contorl flow.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2171">code »</a></span></h3><p>Schedules a task that shall wait for a condition to hold. Each condition
+function may return any value, but it will always be evaluated as a
+boolean.</p>
+<p>Condition functions may schedule sub-tasks with this instance, however,
+their execution time will be factored into whether a wait has timed out.</p>
+<p>In the event a condition returns a Promise, the polling loop will wait for
+it to be resolved before evaluating whether the condition has been
+satisfied. The resolution time for a promise is factored into whether a
+wait has timed out.</p>
+<p>If the condition function throws, or returns a rejected promise, the
+wait task will fail.</p>
+<p>If the condition is defined as a promise, the flow will wait for it to
+settle. If the timeout expires before the promise settles, the promise
+returned by this function will be rejected.</p>
+<p>If this function is invoked with <code>timeout &#61;&#61;&#61; 0</code>, or the timeout is
+omitted, the flow will wait indefinitely for the condition to be satisfied.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|function(): ?)</code><dd><p>The condition to poll,
+or a promise to wait on.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait, in milliseconds, for the
+condition to hold before timing out. If omitted, the flow will wait
+indefinitely.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional error message to include if the
+wait times out; defaults to the empty string.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+when the condition has been satisified. The promise shall be rejected
+if the wait times out waiting for the condition.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError">TypeError</a></code><dd><p>If condition is not a function or promise or if timeout
+is not a number &gt;&#61; 0.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="enum_webdriver_promise_ControlFlow_EventType.html">ControlFlow.EventType</a><dd><p>Events that may be emitted by an <a href="class_webdriver_promise_ControlFlow.html"><code>webdriver.promise.ControlFlow</code></a>.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_Deferred.html b/docs/class_webdriver_promise_Deferred.html
index d98258e..3645e54 100644
--- a/docs/class_webdriver_promise_Deferred.html
+++ b/docs/class_webdriver_promise_Deferred.html
@@ -1,110 +1,84 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Deferred</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.Deferred</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l290">code &raquo;</a><pre><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>
-  &#x2514; webdriver.promise.Deferred</code></pre></header><section><p>Represents a value that will be resolved at some point in the future. This
- class represents the protected "producer" half of a Promise - each Deferred
- has a <code >promise</code> property that may be returned to consumers for
- registering callbacks, reserving the ability to resolve the deferred to the
- producer.
+<!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>Deferred</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_promise.html">webdriver.promise</a></div><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1350">View Source</a></div><h1>class Deferred&lt;T&gt;</h1><dl><dt>All implemented interfaces<dd><code>IThenable&lt;T&gt;</code><dd><code><a href="interface_webdriver_promise_Thenable.html">webdriver.promise.Thenable</a>&lt;T&gt;</code></dl><p>Represents a value that will be resolved at some point in the future. This
+class represents the protected &#34;producer&#34; half of a Promise - each Deferred
+has a <code>promise</code> property that may be returned to consumers for
+registering callbacks, reserving the ability to resolve the deferred to the
+producer.</p>
+<p>If this Deferred is rejected and there are no listeners registered before
+the next turn of the event loop, the rejection will be passed to the
+<a href="class_webdriver_promise_ControlFlow.html"><code>webdriver.promise.ControlFlow</code></a> as an unhandled failure.</p>
+<h3>new Deferred(<wbr>opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow this instance was
+created under. This should only be provided during unit tests.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="cancel" class="function"><div><h3>cancel(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1398">code »</a></span></h3><p>Cancels the computation of this promise&#39;s value, rejecting the promise in
+the process. This method is a no-op if the promise has already been
+resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#cancel">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_CancellationError.html">webdriver.promise.CancellationError</a>)=</code><dd><p>The reason this
+promise is being cancelled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="fulfill" class="function"><div><h3>fulfill(<wbr>opt_value)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1376">code »</a></span></h3><p>Resolves this deferred with the given value. It is safe to call this as a
+normal function (with no bound &#34;this&#34;).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_value<code>?(T|{then: ?})=</code><dd><p>The fulfilled value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isPending" class="function"><div><h3>isPending()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1393">code »</a></span></h3><p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#isPending">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether this promise&#39;s value is still being computed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="reject" class="function"><div><h3>reject(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1386">code »</a></span></h3><p>Rejects this promise with the given reason. It is safe to call this as a
+normal function (with no bound &#34;this&#34;).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>*=</code><dd><p>The rejection reason.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="then" class="function"><div><h3>then(<wbr>opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1406">code »</a></span></h3><div class="tags"><span>deprecated</span></div><p>Registers listeners for when this instance is resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#then">webdriver.promise.Thenable</a>, <a href="#then">IThenable</a></p><dl><dt>Deprecated<dd><p>Use <code>then</code> from the promise property directly.</p>
+</dl><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_callback<code>?function(T): (R|IThenable&lt;R&gt;)=</code><dd><p>The
+function to call if this promise is successfully resolved. The function
+should expect a single argument: the promise&#39;s resolved value.</p>
+<dt>opt_errback<code>?function(*): (R|IThenable&lt;R&gt;)=</code><dd><p>The function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenCatch" class="function"><div><h3>thenCatch(<wbr>errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1414">code »</a></span></h3><div class="tags"><span>deprecated</span></div><p>Registers a listener for when this promise is rejected. This is synonymous
+with the <code>catch</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} catch (ex) {
+  console.error(ex);
+}
 
- <p>If this Deferred is rejected and there are no listeners registered before
- the next turn of the event loop, the rejection will be passed to the
- <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code> as an unhandled failure.
+// Asynchronous promise API:
+doAsynchronousWork().thenCatch(function(ex) {
+  console.error(ex);
+});
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenCatch">webdriver.promise.Thenable</a></p><dl><dt>Deprecated<dd><p>Use <code>thenCatch</code> from the promise property directly.</p>
+</dl><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>errback<code>function(*): (R|IThenable&lt;R&gt;)</code><dd><p>The
+function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenFinally" class="function"><div><h3>thenFinally(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1422">code »</a></span></h3><div class="tags"><span>deprecated</span></div><p>Registers a listener to invoke when this promise is resolved, regardless
+of whether the promise&#39;s value was successfully computed. This function
+is synonymous with the <code>finally</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} finally {
+  cleanUp();
+}
 
- <p>If this Deferred is cancelled, the cancellation reason will be forward to
- the Deferred's canceller function (if provided). The canceller may return a
- truth-y value to override the reason provided for rejection.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.promise.Deferred <span class="args">( opt_canceller, opt_flow )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_canceller: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Function to call when cancelling the
-     computation of this instance's value.<dt>opt_flow: <code class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd>The control flow
-     this instance was created under. This should only be provided during
-     unit tests.</dl></table></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_webdriver_promise_Deferred_State_.html">webdriver.promise.Deferred.State_</a><dd>The three states a <code  class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code> object may be in.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l558">code &raquo;</a><a class="member" name="webdriver.promise.Deferred.Listener_">webdriver.promise.Deferred.Listener_</a> : <code class="type">{callback: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), errback: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), fulfill: function(*), reject: function(*)}</code></div><div>Type definition for a listener registered on a Deferred object.</div></summary></details></div></div></section><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.promise.Deferred</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
- be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l527">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
- promise and not a reference to this deferred, this instance will wait for
- it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">*=</code><dd>The resolved value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
- be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l533">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l237">code &raquo;</a><span class="member deprecation-notice"><a name="addBoth">addBoth</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenFinally()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is either rejected or
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when this promise is
-     either resolved or rejected. The function should expect a single
-     argument: the resolved value or rejection error.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l199">code &raquo;</a><span class="member deprecation-notice"><a name="addCallback">addCallback</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is successfully
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l259">code &raquo;</a><span class="member deprecation-notice"><a name="addCallbacks">addCallbacks</a> <span class="args">( callback, errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>An alias for <code >webdriver.promise.Promise.prototype.then</code> that permits
- the scope of the invoked function to be specified. This function is provided
- for backwards compatibility with the Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l218">code &raquo;</a><span class="member deprecation-notice"><a name="addErrback">addErrback</a> <span class="args">( errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenCatch()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is rejected.
- This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l86">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div><p>Cancels the computation of this promise's value, rejecting the promise in the
- process.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason: <code class="type">*</code><dd>The reason this promise is being cancelled. If not an
-     <code >Error</code>, one will be created using the value's string
-     representation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l92">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether this promise's value is still being computed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l110">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers listeners for when this instance is resolved. This function most
- overridden by subtypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l139">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener for when this promise is rejected. This is synonymous
- with the <code >catch</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } catch (ex) {
-     console.error(ex);
-   }
+// Asynchronous promise API:
+doAsynchronousWork().thenFinally(cleanUp);
+</code></pre>
+<p><strong>Note:</strong> similar to the <code>finally</code> clause, if the registered
+callback returns a rejected promise or throws an error, it will silently
+replace the rejection error (if any) from this promise:</p>
+<pre><code>try {
+  throw Error(&#39;one&#39;);
+} finally {
+  throw Error(&#39;two&#39;);  // Hides Error: one
+}
 
-   // Asynchronous promise API:
-   doAsynchronousWork().thenCatch(function(ex) {
-     console.error(ex);
-   });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l180">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener to invoke when this promise is resolved, regardless
- of whether the promise's value was successfully computed. This function
- is synonymous with the <code >finally</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } finally {
-     cleanUp();
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenFinally(cleanUp);
- </code></pre>
-
- <b>Note:</b> similar to the <code >finally</code> clause, if the registered
- callback returns a rejected promise or throws an error, it will silently
- replace the rejection error (if any) from this promise:
- <pre><code>
-   try {
-     throw Error('one');
-   } finally {
-     throw Error('two');  // Hides Error: one
-   }
-
-   webdriver.promise.rejected(Error('one'))
-       .thenFinally(function() {
-         throw Error('two');  // Hides Error: one
-       });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.promise.Deferred</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l523">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
- in one of three states: pending, resolved, or rejected. Each promise starts
- in the pending state and may make a single transition to either a
- fulfilled or failed state.
-
- <p/>This class is based on the Promise/A proposal from CommonJS. Additional
- functions are provided for API compatibility with Dojo Deferred objects.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l290">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.superClass_">webdriver.promise.Deferred.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+promise.rejected(Error(&#39;one&#39;))
+    .thenFinally(function() {
+      throw Error(&#39;two&#39;);  // Hides Error: one
+    });
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenFinally">webdriver.promise.Thenable</a></p><dl><dt>Deprecated<dd><p>Use <code>thenFinally</code> from the promise property directly.</p>
+</dl><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(): (R|IThenable&lt;R&gt;)</code><dd><p>The function
+to call when this promise is resolved.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be fulfilled
+with the callback result.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="promise" class="property"><dl><dt><a href="source/lib/webdriver/promise.js.src.html#l1359">promise</a><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd>No description.</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_Frame_.html b/docs/class_webdriver_promise_Frame_.html
index 798287f..19134a6 100644
--- a/docs/class_webdriver_promise_Frame_.html
+++ b/docs/class_webdriver_promise_Frame_.html
@@ -1,14 +1,14 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Frame_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.Frame_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l1775">code &raquo;</a><pre><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Frame_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.Frame_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l1818">code &raquo;</a><pre><code>webdriver.promise.Promise.&lt;(T|null)&gt;
   &#x2514; <a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a>
       &#x2514; <a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a>
-          &#x2514; webdriver.promise.Frame_</code></pre></header><section><p>An execution frame within a <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>.  Each
+          &#x2514; webdriver.promise.Frame_</code></pre><dl><dt>All implemented interfaces:<dd><code><a href="">webdriver.promise.Thenable.&lt;(T|null)&gt;</a></code></dl></header><section><p>An execution frame within a <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>.  Each
  frame represents the execution context for either a
  <code  class="type"><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a></code> or a callback on a
  <code  class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code>.
 
  <p>Each frame may contain sub-frames.  If child N is a sub-frame, then the
  items queued within it are given priority over child N+1.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">webdriver.promise.Frame_ <span class="args">( flow )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>flow: <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd>The flow this instance belongs
-     to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.promise.Frame_</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1912">code &raquo;</a><span class="member"><a name="addChild">addChild</a> <span class="args">( node )</span></span></div><p>Adds a new node to this frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type">!(<a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a>|<a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a>)</code><dd>The node to insert.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1867">code &raquo;</a><span class="member"><a name="cancelRemainingTasks">cancelRemainingTasks</a> <span class="args">( error )</span></span></div><p>Marks all of the tasks that are descendants of this frame in the execution
+     to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.promise.Frame_</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1955">code &raquo;</a><span class="member"><a name="addChild">addChild</a> <span class="args">( node )</span></span></div><p>Adds a new node to this frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type">!(<a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a>|<a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a>)</code><dd>The node to insert.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1910">code &raquo;</a><span class="member"><a name="cancelRemainingTasks">cancelRemainingTasks</a> <span class="args">( error )</span></span></div><p>Marks all of the tasks that are descendants of this frame in the execution
  tree as cancelled. This is necessary for callbacks scheduled asynchronous.
  For example:
 
@@ -27,95 +27,14 @@
      // flow failed: Error: boom
      // task failed! CanceledTaskError: Task discarded due to a previous
      // task failure: Error: boom</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>error: <code class="type">!<a href="class_webdriver_promise_CanceledTaskError_.html">webdriver.promise.CanceledTaskError_</a></code><dd>The cancellation
-     error.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1942">code &raquo;</a><span class="member"><a name="getFirstChild">getFirstChild</a> <span class="args">( )</span> &rArr; <code class="type">(<a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a>|<a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a>)</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This frame's
-     fist child.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1887">code &raquo;</a><span class="member"><a name="getPendingTask">getPendingTask</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The task currently executing
-     within this frame, if any.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1902">code &raquo;</a><span class="member"><a name="lockFrame">lockFrame</a> <span class="args">( )</span></span></div><p>Locks this frame.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1782">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1954">code &raquo;</a><span class="member"><a name="removeChild">removeChild</a> <span class="args">( child )</span></span></div><p>Removes a child from this frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>child: <code class="type">!(<a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a>|<a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a>)</code><dd>The child to remove.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1896">code &raquo;</a><span class="member"><a name="setPendingTask">setPendingTask</a> <span class="args">( task )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>task: <code class="type"><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a></code><dd>The task currently
-     executing within this frame, if any.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1965">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1734">code &raquo;</a><span class="member"><a name="getParent">getParent</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This node's parent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1750">code &raquo;</a><span class="member"><a name="getRoot">getRoot</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The root of this node's tree.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1742">code &raquo;</a><span class="member"><a name="setParent">setParent</a> <span class="args">( parent )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code><dd>This node's new parent.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
+     error.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1985">code &raquo;</a><span class="member"><a name="getFirstChild">getFirstChild</a> <span class="args">( )</span> &rArr; <code class="type">(<a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a>|<a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a>)</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This frame's
+     fist child.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1930">code &raquo;</a><span class="member"><a name="getPendingTask">getPendingTask</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The task currently executing
+     within this frame, if any.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1945">code &raquo;</a><span class="member"><a name="lockFrame">lockFrame</a> <span class="args">( )</span></span></div><p>Locks this frame.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1825">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1997">code &raquo;</a><span class="member"><a name="removeChild">removeChild</a> <span class="args">( child )</span></span></div><p>Removes a child from this frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>child: <code class="type">!(<a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a>|<a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a>)</code><dd>The child to remove.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1939">code &raquo;</a><span class="member"><a name="setPendingTask">setPendingTask</a> <span class="args">( task )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>task: <code class="type"><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a></code><dd>The task currently
+     executing within this frame, if any.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2008">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1777">code &raquo;</a><span class="member"><a name="getParent">getParent</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This node's parent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1793">code &raquo;</a><span class="member"><a name="getRoot">getRoot</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The root of this node's tree.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1785">code &raquo;</a><span class="member"><a name="setParent">setParent</a> <span class="args">( parent )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code><dd>This node's new parent.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l547">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
  be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l527">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
+     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l546">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
  promise and not a reference to this deferred, this instance will wait for
- it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">*=</code><dd>The resolved value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l533">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l237">code &raquo;</a><span class="member deprecation-notice"><a name="addBoth">addBoth</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenFinally()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is either rejected or
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when this promise is
-     either resolved or rejected. The function should expect a single
-     argument: the resolved value or rejection error.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l199">code &raquo;</a><span class="member deprecation-notice"><a name="addCallback">addCallback</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is successfully
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l259">code &raquo;</a><span class="member deprecation-notice"><a name="addCallbacks">addCallbacks</a> <span class="args">( callback, errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>An alias for <code >webdriver.promise.Promise.prototype.then</code> that permits
- the scope of the invoked function to be specified. This function is provided
- for backwards compatibility with the Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l218">code &raquo;</a><span class="member deprecation-notice"><a name="addErrback">addErrback</a> <span class="args">( errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenCatch()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is rejected.
- This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l86">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div><p>Cancels the computation of this promise's value, rejecting the promise in the
- process.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason: <code class="type">*</code><dd>The reason this promise is being cancelled. If not an
-     <code >Error</code>, one will be created using the value's string
-     representation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l92">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether this promise's value is still being computed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l110">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers listeners for when this instance is resolved. This function most
- overridden by subtypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l139">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener for when this promise is rejected. This is synonymous
- with the <code >catch</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } catch (ex) {
-     console.error(ex);
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenCatch(function(ex) {
-     console.error(ex);
-   });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l180">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener to invoke when this promise is resolved, regardless
- of whether the promise's value was successfully computed. This function
- is synonymous with the <code >finally</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } finally {
-     cleanUp();
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenFinally(cleanUp);
- </code></pre>
-
- <b>Note:</b> similar to the <code >finally</code> clause, if the registered
- callback returns a rejected promise or throws an error, it will silently
- replace the rejection error (if any) from this promise:
- <pre><code>
-   try {
-     throw Error('one');
-   } finally {
-     throw Error('two');  // Hides Error: one
-   }
-
-   webdriver.promise.rejected(Error('one'))
-       .thenFinally(function() {
-         throw Error('two');  // Hides Error: one
-       });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.promise.Frame_</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1790">code &raquo;</a><span class="member"><a name="children_">children_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1820">code &raquo;</a><span class="member"><a name="isActive_">isActive_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether this frame is active. A frame is considered active once one of its
+ it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">T=</code><dd>The fulfilled value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l552">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html#webdriver.promise.Promise.&lt;(T|null)&gt;">webdriver.promise.Promise.&lt;(T|null)&gt;</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l246">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l252">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type">boolean</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l258">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback<dt>opt_errback</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l265">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l271">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.promise.Frame_</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1833">code &raquo;</a><span class="member"><a name="children_">children_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1863">code &raquo;</a><span class="member"><a name="isActive_">isActive_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether this frame is active. A frame is considered active once one of its
  descendants has been removed for execution.
 
  Adding a sub-frame as a child to an active frame is an indication that
@@ -128,15 +47,13 @@
      flow.execute('this should execute 2nd', goog.nullFunction);
    });
    flow.execute('this should execute last', goog.nullFunction);
- </pre></code></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1833">code &raquo;</a><span class="member"><a name="isLocked_">isLocked_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether this frame is currently locked. A locked frame represents a callback
+ </pre></code></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1876">code &raquo;</a><span class="member"><a name="isLocked_">isLocked_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether this frame is currently locked. A locked frame represents a callback
  or task function which has run to completion and scheduled all of its tasks.
 
  <p>Once a frame becomes <code  class="type"><a class="unresolved-link">active</a></code>, any new frames which are
  added represent callbacks on a <code  class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code>, whose
- tasks must be given priority over previously scheduled tasks.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1840">code &raquo;</a><span class="member"><a name="lastInsertedChild_">lastInsertedChild_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div><p>A reference to the last node inserted in this frame.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1799">code &raquo;</a><span class="member"><a name="pendingTask_">pendingTask_</a> : <code class="type"><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a></code></span></div><p>The task currently being executed within this frame.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1730">code &raquo;</a><span class="member"><a name="parent_">parent_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div><p>This node's parent.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l523">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
+ tasks must be given priority over previously scheduled tasks.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1883">code &raquo;</a><span class="member"><a name="lastInsertedChild_">lastInsertedChild_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div><p>A reference to the last node inserted in this frame.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1842">code &raquo;</a><span class="member"><a name="pendingTask_">pendingTask_</a> : <code class="type"><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a></code></span></div><p>The task currently being executed within this frame.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1773">code &raquo;</a><span class="member"><a name="parent_">parent_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div><p>This node's parent.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l542">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type">webdriver.promise.Promise.<T></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
  in one of three states: pending, resolved, or rejected. Each promise starts
  in the pending state and may make a single transition to either a
- fulfilled or failed state.
-
- <p/>This class is based on the Promise/A proposal from CommonJS. Additional
- functions are provided for API compatibility with Dojo Deferred objects.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1775">code &raquo;</a><span class="member"><a name="webdriver.promise.Frame_.superClass_">webdriver.promise.Frame_.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ fulfilled or rejected state, at which point the promise is considered
+ resolved.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1818">code &raquo;</a><span class="member"><a name="webdriver.promise.Frame_.superClass_">webdriver.promise.Frame_.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html b/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html
new file mode 100644
index 0000000..5f52808
--- /dev/null
+++ b/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html
@@ -0,0 +1,14 @@
+<!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>MultipleUnhandledRejectionError</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_promise.html">webdriver.promise</a></div><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l791">View Source</a></div><h1>class MultipleUnhandledRejectionError</h1><pre class="inheritance"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>
+  &#x2514; goog.debug.Error
+      &#x2514; webdriver.promise.MultipleUnhandledRejectionError</pre><p>Error used when there are multiple unhandled promise rejections detected
+within a task or callback.</p>
+<h3>new MultipleUnhandledRejectionError(<wbr>errors)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>errors<code>Set&lt;*&gt;</code><dd><p>The errors to report.</p>
+</dl></div></div><h2>Instance Properties</h2><div id="description" class="property"><dl><dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>IE-only.</p>
+</dl></div><div id="errors" class="property"><dl><dt><a href="source/lib/webdriver/promise.js.src.html#l803">errors</a><code>Set&lt;*&gt;</code><dd>No description.</dl></div><div id="fileName" class="property"><dl><dt>fileName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Mozilla-only</p>
+</dl></div><div id="lineNumber" class="property"><dl><dt>lineNumber<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>Mozilla-only.</p>
+</dl></div><div id="message" class="property"><dl><dt><a href="source/lib/goog/debug/error.js.src.html#l47">message</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="name" class="property"><dl><dt><a href="source/lib/webdriver/promise.js.src.html#l800">name</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="reportErrorToServer" class="property"><dl><dt><a href="source/lib/goog/debug/error.js.src.html#l57">reportErrorToServer</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to report this error to the server. Setting this to false will
+cause the error reporter to not report the error back to the server,
+which can be useful if the client knows that the error has already been
+logged on the server.</p>
+</dl></div><div id="sourceURL" class="property"><dl><dt>sourceURL<code>?</code><dd><p>Doesn&#39;t seem to exist, but closure/debug.js references it.</p>
+</dl></div><div id="stack" class="property"><dl><dt><a href="source/lib/goog/debug/error.js.src.html#l42">stack</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_Node_.html b/docs/class_webdriver_promise_Node_.html
index f815628..666e39a 100644
--- a/docs/class_webdriver_promise_Node_.html
+++ b/docs/class_webdriver_promise_Node_.html
@@ -1,97 +1,14 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Node_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.Node_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l1720">code &raquo;</a><pre><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Node_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.Node_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l1763">code &raquo;</a><pre><code>webdriver.promise.Promise.&lt;(T|null)&gt;
   &#x2514; <a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a>
-      &#x2514; webdriver.promise.Node_</code></pre></header><section><p>A single node in an <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>'s task tree.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">webdriver.promise.Node_ <span class="args">( flow )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>flow: <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd>The flow this instance belongs
-     to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.promise.Node_</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1734">code &raquo;</a><span class="member"><a name="getParent">getParent</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This node's parent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1750">code &raquo;</a><span class="member"><a name="getRoot">getRoot</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The root of this node's tree.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1742">code &raquo;</a><span class="member"><a name="setParent">setParent</a> <span class="args">( parent )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code><dd>This node's new parent.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
+      &#x2514; webdriver.promise.Node_</code></pre><dl><dt>All implemented interfaces:<dd><code><a href="">webdriver.promise.Thenable.&lt;(T|null)&gt;</a></code></dl></header><section><p>A single node in an <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>'s task tree.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">webdriver.promise.Node_ <span class="args">( flow )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>flow: <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd>The flow this instance belongs
+     to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.promise.Node_</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1777">code &raquo;</a><span class="member"><a name="getParent">getParent</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This node's parent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1793">code &raquo;</a><span class="member"><a name="getRoot">getRoot</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The root of this node's tree.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1785">code &raquo;</a><span class="member"><a name="setParent">setParent</a> <span class="args">( parent )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code><dd>This node's new parent.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l547">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
  be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l527">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
+     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l546">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
  promise and not a reference to this deferred, this instance will wait for
- it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">*=</code><dd>The resolved value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
+ it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">T=</code><dd>The fulfilled value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l547">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
  be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l533">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l237">code &raquo;</a><span class="member deprecation-notice"><a name="addBoth">addBoth</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenFinally()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is either rejected or
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when this promise is
-     either resolved or rejected. The function should expect a single
-     argument: the resolved value or rejection error.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l199">code &raquo;</a><span class="member deprecation-notice"><a name="addCallback">addCallback</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is successfully
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l259">code &raquo;</a><span class="member deprecation-notice"><a name="addCallbacks">addCallbacks</a> <span class="args">( callback, errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>An alias for <code >webdriver.promise.Promise.prototype.then</code> that permits
- the scope of the invoked function to be specified. This function is provided
- for backwards compatibility with the Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l218">code &raquo;</a><span class="member deprecation-notice"><a name="addErrback">addErrback</a> <span class="args">( errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenCatch()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is rejected.
- This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l86">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div><p>Cancels the computation of this promise's value, rejecting the promise in the
- process.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason: <code class="type">*</code><dd>The reason this promise is being cancelled. If not an
-     <code >Error</code>, one will be created using the value's string
-     representation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l92">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether this promise's value is still being computed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l110">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers listeners for when this instance is resolved. This function most
- overridden by subtypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l139">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener for when this promise is rejected. This is synonymous
- with the <code >catch</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } catch (ex) {
-     console.error(ex);
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenCatch(function(ex) {
-     console.error(ex);
-   });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l180">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener to invoke when this promise is resolved, regardless
- of whether the promise's value was successfully computed. This function
- is synonymous with the <code >finally</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } finally {
-     cleanUp();
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenFinally(cleanUp);
- </code></pre>
-
- <b>Note:</b> similar to the <code >finally</code> clause, if the registered
- callback returns a rejected promise or throws an error, it will silently
- replace the rejection error (if any) from this promise:
- <pre><code>
-   try {
-     throw Error('one');
-   } finally {
-     throw Error('two');  // Hides Error: one
-   }
-
-   webdriver.promise.rejected(Error('one'))
-       .thenFinally(function() {
-         throw Error('two');  // Hides Error: one
-       });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.promise.Node_</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1730">code &raquo;</a><span class="member"><a name="parent_">parent_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div><p>This node's parent.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l523">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
+     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l552">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html#webdriver.promise.Promise.&lt;(T|null)&gt;">webdriver.promise.Promise.&lt;(T|null)&gt;</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l246">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l252">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type">boolean</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l258">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback<dt>opt_errback</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l265">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l271">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.promise.Node_</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1773">code &raquo;</a><span class="member"><a name="parent_">parent_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div><p>This node's parent.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l542">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type">webdriver.promise.Promise.<T></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
  in one of three states: pending, resolved, or rejected. Each promise starts
  in the pending state and may make a single transition to either a
- fulfilled or failed state.
-
- <p/>This class is based on the Promise/A proposal from CommonJS. Additional
- functions are provided for API compatibility with Dojo Deferred objects.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1720">code &raquo;</a><span class="member"><a name="webdriver.promise.Node_.superClass_">webdriver.promise.Node_.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ fulfilled or rejected state, at which point the promise is considered
+ resolved.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1763">code &raquo;</a><span class="member"><a name="webdriver.promise.Node_.superClass_">webdriver.promise.Node_.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_Promise.html b/docs/class_webdriver_promise_Promise.html
index 0bab2ee..a3ba277 100644
--- a/docs/class_webdriver_promise_Promise.html
+++ b/docs/class_webdriver_promise_Promise.html
@@ -1,88 +1,75 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Promise</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.Promise</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l75">code &raquo;</a></header><section><p>Represents the eventual value of a completed operation. Each promise may be
- in one of three states: pending, resolved, or rejected. Each promise starts
- in the pending state and may make a single transition to either a
- fulfilled or failed state.
+<!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>Promise</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_promise.html">webdriver.promise</a></div><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l997">View Source</a></div><h1>class Promise&lt;T&gt;</h1><dl><dt>All implemented interfaces<dd><code>IThenable&lt;T&gt;</code><dd><code><a href="interface_webdriver_promise_Thenable.html">webdriver.promise.Thenable</a>&lt;T&gt;</code></dl><p>Represents the eventual value of a completed operation. Each promise may be
+in one of three states: pending, fulfilled, or rejected. Each promise starts
+in the pending state and may make a single transition to either a
+fulfilled or rejected state, at which point the promise is considered
+resolved.</p>
+<h3>new Promise(<wbr>resolver, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>resolver<code>function(function(?(T|{then: ?})=): ?, function(*=): ?): ?</code><dd><p>Function that is invoked immediately to begin computation of this
+promise&#39;s value. The function should accept a pair of callback
+functions, one for fulfilling the promise and another for rejecting it.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow
+this instance was created under. Defaults to the currently active flow.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="cancel" class="function"><div><h3>cancel(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1199">code »</a></span></h3><p>Cancels the computation of this promise&#39;s value, rejecting the promise in
+the process. This method is a no-op if the promise has already been
+resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#cancel">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_CancellationError.html">webdriver.promise.CancellationError</a>)=</code><dd><p>The reason this
+promise is being cancelled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isPending" class="function"><div><h3>isPending()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1227">code »</a></span></h3><p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#isPending">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether this promise&#39;s value is still being computed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="then" class="function"><div><h3>then(<wbr>opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1232">code »</a></span></h3><p>Registers listeners for when this instance is resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#then">webdriver.promise.Thenable</a>, <a href="#then">IThenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_callback<code>?function(T): (R|IThenable&lt;R&gt;)=</code><dd><p>The
+function to call if this promise is successfully resolved. The function
+should expect a single argument: the promise&#39;s resolved value.</p>
+<dt>opt_errback<code>?function(*): (R|IThenable&lt;R&gt;)=</code><dd><p>The function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenCatch" class="function"><div><h3>thenCatch(<wbr>errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1238">code »</a></span></h3><p>Registers a listener for when this promise is rejected. This is synonymous
+with the <code>catch</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} catch (ex) {
+  console.error(ex);
+}
 
- <p/>This class is based on the Promise/A proposal from CommonJS. Additional
- functions are provided for API compatibility with Dojo Deferred objects.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.promise.Promise <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l237">code &raquo;</a><span class="member deprecation-notice"><a name="addBoth">addBoth</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenFinally()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is either rejected or
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when this promise is
-     either resolved or rejected. The function should expect a single
-     argument: the resolved value or rejection error.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l199">code &raquo;</a><span class="member deprecation-notice"><a name="addCallback">addCallback</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is successfully
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l259">code &raquo;</a><span class="member deprecation-notice"><a name="addCallbacks">addCallbacks</a> <span class="args">( callback, errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>An alias for <code >webdriver.promise.Promise.prototype.then</code> that permits
- the scope of the invoked function to be specified. This function is provided
- for backwards compatibility with the Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l218">code &raquo;</a><span class="member deprecation-notice"><a name="addErrback">addErrback</a> <span class="args">( errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenCatch()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is rejected.
- This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l86">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div><p>Cancels the computation of this promise's value, rejecting the promise in the
- process.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason: <code class="type">*</code><dd>The reason this promise is being cancelled. If not an
-     <code >Error</code>, one will be created using the value's string
-     representation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l92">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether this promise's value is still being computed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l110">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers listeners for when this instance is resolved. This function most
- overridden by subtypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l139">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener for when this promise is rejected. This is synonymous
- with the <code >catch</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } catch (ex) {
-     console.error(ex);
-   }
+// Asynchronous promise API:
+doAsynchronousWork().thenCatch(function(ex) {
+  console.error(ex);
+});
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenCatch">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>errback<code>function(*): (R|IThenable&lt;R&gt;)</code><dd><p>The
+function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenFinally" class="function"><div><h3>thenFinally(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1244">code »</a></span></h3><p>Registers a listener to invoke when this promise is resolved, regardless
+of whether the promise&#39;s value was successfully computed. This function
+is synonymous with the <code>finally</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} finally {
+  cleanUp();
+}
 
-   // Asynchronous promise API:
-   doAsynchronousWork().thenCatch(function(ex) {
-     console.error(ex);
-   });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l180">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener to invoke when this promise is resolved, regardless
- of whether the promise's value was successfully computed. This function
- is synonymous with the <code >finally</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } finally {
-     cleanUp();
-   }
+// Asynchronous promise API:
+doAsynchronousWork().thenFinally(cleanUp);
+</code></pre>
+<p><strong>Note:</strong> similar to the <code>finally</code> clause, if the registered
+callback returns a rejected promise or throws an error, it will silently
+replace the rejection error (if any) from this promise:</p>
+<pre><code>try {
+  throw Error(&#39;one&#39;);
+} finally {
+  throw Error(&#39;two&#39;);  // Hides Error: one
+}
 
-   // Asynchronous promise API:
-   doAsynchronousWork().thenFinally(cleanUp);
- </code></pre>
-
- <b>Note:</b> similar to the <code >finally</code> clause, if the registered
- callback returns a rejected promise or throws an error, it will silently
- replace the rejection error (if any) from this promise:
- <pre><code>
-   try {
-     throw Error('one');
-   } finally {
-     throw Error('two');  // Hides Error: one
-   }
-
-   webdriver.promise.rejected(Error('one'))
-       .thenFinally(function() {
-         throw Error('two');  // Hides Error: one
-       });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+promise.rejected(Error(&#39;one&#39;))
+    .thenFinally(function() {
+      throw Error(&#39;two&#39;);  // Hides Error: one
+    });
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenFinally">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(): (R|IThenable&lt;R&gt;)</code><dd><p>The function
+to call when this promise is resolved.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be fulfilled
+with the callback result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1055">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_promise_Task_.html b/docs/class_webdriver_promise_Task_.html
index bc36581..f226db6 100644
--- a/docs/class_webdriver_promise_Task_.html
+++ b/docs/class_webdriver_promise_Task_.html
@@ -1,101 +1,18 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Task_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.Task_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l1988">code &raquo;</a><pre><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Task_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.promise.Task_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l2031">code &raquo;</a><pre><code>webdriver.promise.Promise.&lt;(T|null)&gt;
   &#x2514; <a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a>
       &#x2514; <a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a>
-          &#x2514; webdriver.promise.Task_</code></pre></header><section><p>A task to be executed by a <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">webdriver.promise.Task_ <span class="args">( flow, fn, description, snapshot )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>flow: <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd>The flow this instances belongs
+          &#x2514; webdriver.promise.Task_</code></pre><dl><dt>All implemented interfaces:<dd><code><a href="">webdriver.promise.Thenable.&lt;(T|null)&gt;</a></code></dl></header><section><p>A task to be executed by a <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">webdriver.promise.Task_ <span class="args">( flow, fn, description, snapshot )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>flow: <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd>The flow this instances belongs
      to.<dt>fn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when the task executes. If it
      returns a <code >webdriver.promise.Promise</code>, the flow will wait
      for it to be resolved before starting the next task.<dt>description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A description of the task for debugging.<dt>snapshot: <code class="type">!<a href="class_webdriver_stacktrace_Snapshot.html">webdriver.stacktrace.Snapshot</a></code><dd>A snapshot of the stack
-     when this task was scheduled.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.promise.Task_</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1995">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( )</span></span></div><p>Executes this task.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2007">code &raquo;</a><span class="member"><a name="getDescription">getDescription</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This task's description.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2013">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1734">code &raquo;</a><span class="member"><a name="getParent">getParent</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This node's parent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1750">code &raquo;</a><span class="member"><a name="getRoot">getRoot</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The root of this node's tree.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1742">code &raquo;</a><span class="member"><a name="setParent">setParent</a> <span class="args">( parent )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code><dd>This node's new parent.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
+     when this task was scheduled.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.promise.Task_</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2038">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( )</span></span></div><p>Executes this task.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2050">code &raquo;</a><span class="member"><a name="getDescription">getDescription</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This task's description.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2056">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1777">code &raquo;</a><span class="member"><a name="getParent">getParent</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>This node's parent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1793">code &raquo;</a><span class="member"><a name="getRoot">getRoot</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The root of this node's tree.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1785">code &raquo;</a><span class="member"><a name="setParent">setParent</a> <span class="args">( parent )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code><dd>This node's new parent.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l547">code &raquo;</a><span class="member"><a name="errback">errback</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
  be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l527">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
+     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l546">code &raquo;</a><span class="member"><a name="fulfill">fulfill</a> <span class="args">( opt_value )</span></span></div><p>Resolves this promise with the given value. If the value is itself a
  promise and not a reference to this deferred, this instance will wait for
- it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">*=</code><dd>The resolved value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l528">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
+ it before resolving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">T=</code><dd>The fulfilled value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l547">code &raquo;</a><span class="member"><a name="reject">reject</a> <span class="args">( opt_error )</span></span></div><p>Rejects this promise. If the error is itself a promise, this instance will
  be chained to it and be rejected with the error's resolved value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_error: <code class="type">*=</code><dd>The rejection reason, typically either a
-     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l533">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l237">code &raquo;</a><span class="member deprecation-notice"><a name="addBoth">addBoth</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenFinally()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is either rejected or
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when this promise is
-     either resolved or rejected. The function should expect a single
-     argument: the resolved value or rejection error.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l199">code &raquo;</a><span class="member deprecation-notice"><a name="addCallback">addCallback</a> <span class="args">( callback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is successfully
- resolved. This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l259">code &raquo;</a><span class="member deprecation-notice"><a name="addCallbacks">addCallbacks</a> <span class="args">( callback, errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#then()</a></code> instead.</span></div><p>An alias for <code >webdriver.promise.Promise.prototype.then</code> that permits
- the scope of the invoked function to be specified. This function is provided
- for backwards compatibility with the Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l218">code &raquo;</a><span class="member deprecation-notice"><a name="addErrback">addErrback</a> <span class="args">( errback, opt_self )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a class="unresolved-link">#thenCatch()</a></code> instead.</span></div><p>Registers a function to be invoked when this promise is rejected.
- This function is provided for backwards compatibility with the
- Dojo Deferred API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.<dt>opt_self: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object which |this| should refer to when the
-     function is invoked.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l86">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div><p>Cancels the computation of this promise's value, rejecting the promise in the
- process.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason: <code class="type">*</code><dd>The reason this promise is being cancelled. If not an
-     <code >Error</code>, one will be created using the value's string
-     representation.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l92">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether this promise's value is still being computed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l110">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers listeners for when this instance is resolved. This function most
- overridden by subtypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     successfully resolved. The function should expect a single argument: the
-     promise's resolved value.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l139">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener for when this promise is rejected. This is synonymous
- with the <code >catch</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } catch (ex) {
-     console.error(ex);
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenCatch(function(ex) {
-     console.error(ex);
-   });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call if this promise is
-     rejected. The function should expect a single argument: the rejection
-     reason.</dl><tr><th>Returns<tr><td><dl>A new promise which will be resolved
-     with the result of the invoked callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l180">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers a listener to invoke when this promise is resolved, regardless
- of whether the promise's value was successfully computed. This function
- is synonymous with the <code >finally</code> clause in a synchronous API:
- <pre><code>
-   // Synchronous API:
-   try {
-     doSynchronousWork();
-   } finally {
-     cleanUp();
-   }
-
-   // Asynchronous promise API:
-   doAsynchronousWork().thenFinally(cleanUp);
- </code></pre>
-
- <b>Note:</b> similar to the <code >finally</code> clause, if the registered
- callback returns a rejected promise or throws an error, it will silently
- replace the rejection error (if any) from this promise:
- <pre><code>
-   try {
-     throw Error('one');
-   } finally {
-     throw Error('two');  // Hides Error: one
-   }
-
-   webdriver.promise.rejected(Error('one'))
-       .thenFinally(function() {
-         throw Error('two');  // Hides Error: one
-       });
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.promise.Task_</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1998">code &raquo;</a><span class="member"><a name="description_">description_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2001">code &raquo;</a><span class="member"><a name="snapshot_">snapshot_</a> : <code class="type">!<a href="class_webdriver_stacktrace_Snapshot.html">webdriver.stacktrace.Snapshot</a></code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1730">code &raquo;</a><span class="member"><a name="parent_">parent_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div><p>This node's parent.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l523">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
+     <code >Error</code> or a <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l552">code &raquo;</a><span class="member"><a name="removeAll">removeAll</a> <span class="args">( )</span></span></div><p>Removes all of the listeners previously registered on this deferred.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If this deferred has already been resolved.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Promise.html#webdriver.promise.Promise.&lt;(T|null)&gt;">webdriver.promise.Promise.&lt;(T|null)&gt;</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l246">code &raquo;</a><span class="member"><a name="cancel">cancel</a> <span class="args">( reason )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>reason</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l252">code &raquo;</a><span class="member"><a name="isPending">isPending</a> <span class="args">( )</span> &rArr; <code class="type">boolean</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l258">code &raquo;</a><span class="member"><a name="then">then</a> <span class="args">( opt_callback, opt_errback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_callback<dt>opt_errback</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l265">code &raquo;</a><span class="member"><a name="thenCatch">thenCatch</a> <span class="args">( errback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errback</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l271">code &raquo;</a><span class="member"><a name="thenFinally">thenFinally</a> <span class="args">( callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.promise.Task_</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2041">code &raquo;</a><span class="member"><a name="description_">description_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2044">code &raquo;</a><span class="member"><a name="snapshot_">snapshot_</a> : <code class="type">!<a href="class_webdriver_stacktrace_Snapshot.html">webdriver.stacktrace.Snapshot</a></code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1773">code &raquo;</a><span class="member"><a name="parent_">parent_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a></code></span></div><p>This node's parent.</summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l542">code &raquo;</a><span class="member"><a name="webdriver.promise.Deferred.prototype.promise">webdriver.promise.Deferred.prototype.promise</a> : <code class="type">webdriver.promise.Promise.<T></code></span></div><p>Represents the eventual value of a completed operation. Each promise may be
  in one of three states: pending, resolved, or rejected. Each promise starts
  in the pending state and may make a single transition to either a
- fulfilled or failed state.
-
- <p/>This class is based on the Promise/A proposal from CommonJS. Additional
- functions are provided for API compatibility with Dojo Deferred objects.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l1988">code &raquo;</a><span class="member"><a name="webdriver.promise.Task_.superClass_">webdriver.promise.Task_.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ fulfilled or rejected state, at which point the promise is considered
+ resolved.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2031">code &raquo;</a><span class="member"><a name="webdriver.promise.Task_.superClass_">webdriver.promise.Task_.superClass_</a> : <code class="type"><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_stacktrace_Frame.html b/docs/class_webdriver_stacktrace_Frame.html
index 68edecc..4b77d11 100644
--- a/docs/class_webdriver_stacktrace_Frame.html
+++ b/docs/class_webdriver_stacktrace_Frame.html
@@ -1,8 +1,20 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.stacktrace.Frame</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.stacktrace.Frame</h1><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l135">code &raquo;</a></header><section><p>Class representing one stack frame.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.stacktrace.Frame <span class="args">( context, name, alias, path )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>context: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Context object, empty in case of global
-     functions or if the browser doesn't provide this information.<dt>name: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Function name, empty in case of anonymous
-     functions.<dt>alias: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Alias of the function if available. For
-     example the function name will be 'c' and the alias will be 'b' if the
-     function is defined as <code>a.b = function c() {};</code>.<dt>path: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>File path or URL including line number and
-     optionally column number separated by colons.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l206">code &raquo;</a><span class="member"><a name="getColumn">getColumn</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The column number if known and -1 if it is unknown.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l198">code &raquo;</a><span class="member"><a name="getLine">getLine</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The line number if known or -1 if it is unknown.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l182">code &raquo;</a><span class="member"><a name="getName">getName</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The function name or empty string if the function is
-     anonymous and the object field which it's assigned to is unknown.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l190">code &raquo;</a><span class="member"><a name="getUrl">getUrl</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The url or empty string if it is unknown.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l214">code &raquo;</a><span class="member"><a name="isAnonymous">isAnonymous</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the stack frame contains an anonymous function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l225">code &raquo;</a><span class="member"><a name="toString">toString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts this frame to its string representation using V8's stack trace
- format: http://code.google.com/p/v8/wiki/JavaScriptStackTraceApi</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The string representation of this frame.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l144">code &raquo;</a><span class="member"><a name="alias_">alias_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l162">code &raquo;</a><span class="member"><a name="column">column</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Properties/NaN">NaN</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l156">code &raquo;</a><span class="member"><a name="column_">column_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l138">code &raquo;</a><span class="member"><a name="context_">context_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l153">code &raquo;</a><span class="member"><a name="line_">line_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l141">code &raquo;</a><span class="member"><a name="name_">name_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l147">code &raquo;</a><span class="member"><a name="path_">path_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l150">code &raquo;</a><span class="member"><a name="url_">url_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Frame</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_stacktrace.html">webdriver.stacktrace</a></div><div class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l135">View Source</a></div><h1>class Frame</h1><p>Class representing one stack frame.</p>
+<h3>new Frame(<wbr>context, name, alias, path)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>context<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd><p>Context object, empty in case of global
+functions or if the browser doesn&#39;t provide this information.</p>
+<dt>name<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd><p>Function name, empty in case of anonymous
+functions.</p>
+<dt>alias<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd><p>Alias of the function if available. For
+example the function name will be &#39;c&#39; and the alias will be &#39;b&#39; if the
+function is defined as <code>a.b &#61; function c() {};</code>.</p>
+<dt>path<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd><p>File path or URL including line number and
+optionally column number separated by colons.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getColumn" class="function"><div><h3>getColumn()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l206">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The column number if known and -1 if it is unknown.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLine" class="function"><div><h3>getLine()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l198">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The line number if known or -1 if it is unknown.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getName" class="function"><div><h3>getName()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l182">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The function name or empty string if the function is
+anonymous and the object field which it&#39;s assigned to is unknown.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getUrl" class="function"><div><h3>getUrl()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l190">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The url or empty string if it is unknown.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isAnonymous" class="function"><div><h3>isAnonymous()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l214">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the stack frame contains an anonymous function.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l225">code »</a></span></h3><p>Converts this frame to its string representation using V8&#39;s stack trace
+format: http://code.google.com/p/v8/wiki/JavaScriptStackTraceApi</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string representation of this frame.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="column" class="property"><dl><dt><a href="source/lib/webdriver/stacktrace.js.src.html#l162">column</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>No description.</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_stacktrace_Snapshot.html b/docs/class_webdriver_stacktrace_Snapshot.html
index 0484ea1..b623cdf 100644
--- a/docs/class_webdriver_stacktrace_Snapshot.html
+++ b/docs/class_webdriver_stacktrace_Snapshot.html
@@ -1,5 +1,6 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.stacktrace.Snapshot</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.stacktrace.Snapshot</h1><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l38">code &raquo;</a></header><section><p>Stores a snapshot of the stack trace at the time this instance was created.
- The stack trace will always be adjusted to exclude this function call.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.stacktrace.Snapshot <span class="args">( opt_slice )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_slice: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The number of frames to remove from the top of
-     the generated stack trace.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l108">code &raquo;</a><span class="member"><a name="getStacktrace">getStacktrace</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The parsed stack trace.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l102">code &raquo;</a><span class="member"><a name="parsedStack_">parsedStack_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>The parsed stack trace. This list is lazily generated the first time it is
- accessed.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l41">code &raquo;</a><span class="member"><a name="slice_">slice_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l67">code &raquo;</a><span class="member"><a name="stack_">stack_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The error's stacktrace.  This must be accessed immediately to ensure Opera
- computes the context correctly.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Snapshot</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_stacktrace.html">webdriver.stacktrace</a></div><div class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l39">View Source</a></div><h1>class Snapshot</h1><p>Stores a snapshot of the stack trace at the time this instance was created.
+The stack trace will always be adjusted to exclude this function call.</p>
+<h3>new Snapshot(<wbr>opt_slice)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_slice<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The number of frames to remove from the top of
+the generated stack trace.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getStacktrace" class="function"><div><h3>getStacktrace()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l108">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_stacktrace_Frame.html">webdriver.stacktrace.Frame</a>&gt;</code><dd><p>The parsed stack trace.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_testing_Assertion.html b/docs/class_webdriver_testing_Assertion.html
index 8aee79e..b19a1b1 100644
--- a/docs/class_webdriver_testing_Assertion.html
+++ b/docs/class_webdriver_testing_Assertion.html
@@ -1,32 +1,99 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.testing.Assertion</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.testing.Assertion</h1><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l87">code &raquo;</a></header><section><p>Utility for performing assertions against a given <code >value</code>. If the
- value is a <code  class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code>, this assertion will wait
- for it to resolve before applying any matchers.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.testing.Assertion <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to wrap and apply matchers to.</dl></table></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_testing_Assertion_DelegatingMatcher_.html">webdriver.testing.Assertion.DelegatingMatcher_</a><dd>Wraps an object literal implementing the Matcher interface.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l146">code &raquo;</a><span class="member"><a name="apply">apply</a> <span class="args">( matcher, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the given <code >matcher</code> accepts the value wrapped by this
- instance. If the wrapped value is a promise, this function will defer
- applying the assertion until the value has been resolved. Otherwise, it
- will be applied immediately.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matcher: <code class="type">!<a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code><dd>The matcher to apply<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The deferred assertion result, or
-     <code >null</code> if the assertion was immediately applied.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l228">code &raquo;</a><span class="member"><a name="closeTo">closeTo</a> <span class="args">( value, range, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a number within a given distance of an
- expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The expected value.<dt>range: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The maximum amount the actual value is permitted to
-     differ from the expected value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l291">code &raquo;</a><span class="member"><a name="contains">contains</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a string or array-like structure
- containing the given value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The expected value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l304">code &raquo;</a><span class="member"><a name="endsWith">endsWith</a> <span class="args">( suffix, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a string ending with the given suffix.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>suffix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected suffix.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l345">code &raquo;</a><span class="member"><a name="equalTo">equalTo</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is strictly equal to the
- given <code >value</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The expected value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l167">code &raquo;</a><span class="member"><a name="greaterThan">greaterThan</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is a number strictly
- greater than <code >value</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The minimum value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l182">code &raquo;</a><span class="member"><a name="greaterThanEqualTo">greaterThanEqualTo</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is a number >= the given
- value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The minimum value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l242">code &raquo;</a><span class="member"><a name="instanceOf">instanceOf</a> <span class="args">( ctor, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is an instance of the given class.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ctor: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The expected class constructor.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l363">code &raquo;</a><span class="member"><a name="isFalse">isFalse</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is strictly false.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l254">code &raquo;</a><span class="member"><a name="isNull">isNull</a> <span class="args">( opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is null.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l276">code &raquo;</a><span class="member"><a name="isNullOrUndefined">isNullOrUndefined</a> <span class="args">( opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is null or undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l354">code &raquo;</a><span class="member"><a name="isTrue">isTrue</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is strictly true.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l265">code &raquo;</a><span class="member"><a name="isUndefined">isUndefined</a> <span class="args">( opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l197">code &raquo;</a><span class="member"><a name="lessThan">lessThan</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is a number strictly less
- than the given value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The maximum value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l211">code &raquo;</a><span class="member"><a name="lessThanEqualTo">lessThanEqualTo</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is a number <= the given
- value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The maximum value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l332">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( regex, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a string that matches the given RegExp.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>regex: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code><dd>The regex to test.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l318">code &raquo;</a><span class="member"><a name="startsWith">startsWith</a> <span class="args">( prefix, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a string starting with the given prefix.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected prefix.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l98">code &raquo;</a><span class="member"><a name="is">is</a> : <code class="type">!<a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code></span></div><p>A self reference provided for writing fluent assertions:
-     webdriver.testing.assert(x).is.equalTo(y);</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l105">code &raquo;</a><span class="member"><a name="not">not</a> : <code class="type">!<a href="class_webdriver_testing_NegatedAssertion.html">webdriver.testing.NegatedAssertion</a></code></span></div><p>Negates any matchers applied to this instance's value:
-     webdriver.testing.assert(x).not.equalTo(y);</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l90">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type">*</code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Assertion</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_testing.html">webdriver.testing</a></div><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l90">View Source</a></div><h1>class Assertion</h1><p>Utility for performing assertions against a given <code>value</code>. If the
+value is a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>, this assertion will wait
+for it to resolve before applying any matchers.</p>
+<h3>new Assertion(<wbr>value)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to wrap and apply matchers to.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="apply" class="function"><div><h3>apply(<wbr>matcher, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l149">code »</a></span></h3><p>Asserts that the given <code>matcher</code> accepts the value wrapped by this
+instance. If the wrapped value is a promise, this function will defer
+applying the assertion until the value has been resolved. Otherwise, it
+will be applied immediately.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>matcher<code>goog.labs.testing.Matcher</code><dd><p>The matcher to apply</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The deferred assertion result, or
+<code>null</code> if the assertion was immediately applied.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="closeTo" class="function"><div><h3>closeTo(<wbr>value, range, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l231">code »</a></span></h3><p>Asserts that the wrapped value is a number within a given distance of an
+expected value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The expected value.</p>
+<dt>range<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The maximum amount the actual value is permitted to
+differ from the expected value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="contains" class="function"><div><h3>contains(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l294">code »</a></span></h3><p>Asserts that the wrapped value is a string or array-like structure
+containing the given value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The expected value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="endsWith" class="function"><div><h3>endsWith(<wbr>suffix, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l307">code »</a></span></h3><p>Asserts that the wrapped value is a string ending with the given suffix.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>suffix<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected suffix.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="equalTo" class="function"><div><h3>equalTo(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l348">code »</a></span></h3><p>Asserts that the value managed by this assertion is strictly equal to the
+given <code>value</code>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The expected value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="greaterThan" class="function"><div><h3>greaterThan(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l170">code »</a></span></h3><p>Asserts that the value managed by this assertion is a number strictly
+greater than <code>value</code>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The minimum value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="greaterThanEqualTo" class="function"><div><h3>greaterThanEqualTo(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l185">code »</a></span></h3><p>Asserts that the value managed by this assertion is a number &gt;&#61; the given
+value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The minimum value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="instanceOf" class="function"><div><h3>instanceOf(<wbr>ctor, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l245">code »</a></span></h3><p>Asserts that the wrapped value is an instance of the given class.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ctor<code>Function</code><dd><p>The expected class constructor.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isFalse" class="function"><div><h3>isFalse()<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l366">code »</a></span></h3><p>Asserts that the value managed by this assertion is strictly false.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isNull" class="function"><div><h3>isNull(<wbr>opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l257">code »</a></span></h3><p>Asserts that the wrapped value is null.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isNullOrUndefined" class="function"><div><h3>isNullOrUndefined(<wbr>opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l279">code »</a></span></h3><p>Asserts that the wrapped value is null or undefined.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isTrue" class="function"><div><h3>isTrue()<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l357">code »</a></span></h3><p>Asserts that the value managed by this assertion is strictly true.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isUndefined" class="function"><div><h3>isUndefined(<wbr>opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l268">code »</a></span></h3><p>Asserts that the wrapped value is undefined.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="lessThan" class="function"><div><h3>lessThan(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l200">code »</a></span></h3><p>Asserts that the value managed by this assertion is a number strictly less
+than the given value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The maximum value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="lessThanEqualTo" class="function"><div><h3>lessThanEqualTo(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l214">code »</a></span></h3><p>Asserts that the value managed by this assertion is a number &lt;&#61; the given
+value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The maximum value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="matches" class="function"><div><h3>matches(<wbr>regex, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l335">code »</a></span></h3><p>Asserts that the wrapped value is a string that matches the given RegExp.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>regex<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp">RegExp</a></code><dd><p>The regex to test.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="startsWith" class="function"><div><h3>startsWith(<wbr>prefix, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l321">code »</a></span></h3><p>Asserts that the wrapped value is a string starting with the given prefix.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefix<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected prefix.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="is" class="property"><dl><dt><a href="source/lib/webdriver/testing/asserts.js.src.html#l101">is</a><code><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code><dd><p>A self reference provided for writing fluent assertions:
+webdriver.testing.assert(x).is.equalTo(y);</p>
+</dl></div><div id="not" class="property"><dl><dt><a href="source/lib/webdriver/testing/asserts.js.src.html#l108">not</a><code><a href="class_webdriver_testing_NegatedAssertion.html">webdriver.testing.NegatedAssertion</a></code><dd><p>Negates any matchers applied to this instance&#39;s value:
+webdriver.testing.assert(x).not.equalTo(y);</p>
+</dl></div><h2>Types</h2><dl><dt><a href="class_webdriver_testing_Assertion_DelegatingMatcher_.html">Assertion.DelegatingMatcher_</a><dd><p>Wraps an object literal implementing the Matcher interface.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html b/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html
index 22a3d65..1d6baea 100644
--- a/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html
+++ b/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html
@@ -1,3 +1,13 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.testing.Assertion.DelegatingMatcher_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.testing.Assertion.DelegatingMatcher_</h1><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l120">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>Wraps an object literal implementing the Matcher interface. This is used
- to appease the Closure compiler, which will not treat an object literal as
- implementing an interface.<h2>Constructor</h2><div class="ctor wrap-details private"><div><div class="ctor"><span class="member">webdriver.testing.Assertion.DelegatingMatcher_ <span class="args">( obj )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">{matches: function(*): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, describe: function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd>The object literal to delegate to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l128">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l123">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( value )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Assertion.DelegatingMatcher_</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_testing.html">webdriver.testing</a></div><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l123">View Source</a></div><h1>class Assertion.DelegatingMatcher_</h1><dl><dt>All implemented interfaces<dd><code>goog.labs.testing.Matcher</code></dl><p>Wraps an object literal implementing the Matcher interface. This is used
+to appease the Closure compiler, which will not treat an object literal as
+implementing an interface.</p>
+<h3>new Assertion.DelegatingMatcher_(<wbr>obj)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>obj<code>{describe: function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, matches: function(*): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>}</code><dd><p>The object literal to delegate to.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="describe" class="function"><div><h3>describe(<wbr>value, opt_description)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l131">code »</a></span></h3><p>Describes why the matcher failed.</p>
+<p><b>Specified by: </b><a href="#describe">goog.labs.testing.Matcher</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value that didn&#39;t match.</p>
+<dt>opt_description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A partial description to which the reason
+will be appended.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Description of why the matcher failed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="matches" class="function"><div><h3>matches(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l126">code »</a></span></h3><p>Determines whether a value matches the constraints of the match.</p>
+<p><b>Specified by: </b><a href="#matches">goog.labs.testing.Matcher</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The object to match.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the input value matches this matcher.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_testing_ContainsMatcher.html b/docs/class_webdriver_testing_ContainsMatcher.html
index d56b8a3..898aed5 100644
--- a/docs/class_webdriver_testing_ContainsMatcher.html
+++ b/docs/class_webdriver_testing_ContainsMatcher.html
@@ -1 +1,11 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.testing.ContainsMatcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.testing.ContainsMatcher</h1><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l55">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></dl></header><section><p>Accepts strins or array-like structures that contain <code >value</code>.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.testing.ContainsMatcher <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check for.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l74">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( actualValue )</span> &rArr; <code class="type">string</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l62">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( actualValue )</span> &rArr; <code class="type">boolean</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actualValue</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l57">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type">*</code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>ContainsMatcher</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_testing.html">webdriver.testing</a></div><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l58">View Source</a></div><h1>class ContainsMatcher</h1><dl><dt>All implemented interfaces<dd><code>goog.labs.testing.Matcher</code></dl><p>Accepts strins or array-like structures that contain <code>value</code>.</p>
+<h3>new ContainsMatcher(<wbr>value)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to check for.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="describe" class="function"><div><h3>describe(<wbr>value, opt_description)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l77">code »</a></span></h3><p>Describes why the matcher failed.</p>
+<p><b>Specified by: </b><a href="#describe">goog.labs.testing.Matcher</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value that didn&#39;t match.</p>
+<dt>opt_description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A partial description to which the reason
+will be appended.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Description of why the matcher failed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="matches" class="function"><div><h3>matches(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l65">code »</a></span></h3><p>Determines whether a value matches the constraints of the match.</p>
+<p><b>Specified by: </b><a href="#matches">goog.labs.testing.Matcher</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The object to match.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the input value matches this matcher.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_testing_NegatedAssertion.html b/docs/class_webdriver_testing_NegatedAssertion.html
index 6a7d073..0bedb8f 100644
--- a/docs/class_webdriver_testing_NegatedAssertion.html
+++ b/docs/class_webdriver_testing_NegatedAssertion.html
@@ -1,26 +1,97 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.testing.NegatedAssertion</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.testing.NegatedAssertion</h1><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l375">code &raquo;</a><pre><code><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a>
-  &#x2514; webdriver.testing.NegatedAssertion</code></pre></header><section><p>An assertion that negates any applied matchers.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.testing.NegatedAssertion <span class="args">( value )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to perform assertions on.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.testing.NegatedAssertion</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l384">code &raquo;</a><span class="member"><a name="apply">apply</a> <span class="args">( matcher, opt_message )</span> &rArr; <code class="type">(null|webdriver.promise.Promise)</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matcher<dt>opt_message</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l228">code &raquo;</a><span class="member"><a name="closeTo">closeTo</a> <span class="args">( value, range, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a number within a given distance of an
- expected value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The expected value.<dt>range: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The maximum amount the actual value is permitted to
-     differ from the expected value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l291">code &raquo;</a><span class="member"><a name="contains">contains</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a string or array-like structure
- containing the given value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The expected value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l304">code &raquo;</a><span class="member"><a name="endsWith">endsWith</a> <span class="args">( suffix, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a string ending with the given suffix.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>suffix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected suffix.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l345">code &raquo;</a><span class="member"><a name="equalTo">equalTo</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is strictly equal to the
- given <code >value</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The expected value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l167">code &raquo;</a><span class="member"><a name="greaterThan">greaterThan</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is a number strictly
- greater than <code >value</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The minimum value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l182">code &raquo;</a><span class="member"><a name="greaterThanEqualTo">greaterThanEqualTo</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is a number >= the given
- value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The minimum value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l242">code &raquo;</a><span class="member"><a name="instanceOf">instanceOf</a> <span class="args">( ctor, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is an instance of the given class.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ctor: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The expected class constructor.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l363">code &raquo;</a><span class="member"><a name="isFalse">isFalse</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is strictly false.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l254">code &raquo;</a><span class="member"><a name="isNull">isNull</a> <span class="args">( opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is null.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l276">code &raquo;</a><span class="member"><a name="isNullOrUndefined">isNullOrUndefined</a> <span class="args">( opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is null or undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l354">code &raquo;</a><span class="member"><a name="isTrue">isTrue</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is strictly true.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l265">code &raquo;</a><span class="member"><a name="isUndefined">isUndefined</a> <span class="args">( opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l197">code &raquo;</a><span class="member"><a name="lessThan">lessThan</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is a number strictly less
- than the given value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The maximum value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l211">code &raquo;</a><span class="member"><a name="lessThanEqualTo">lessThanEqualTo</a> <span class="args">( value, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the value managed by this assertion is a number <= the given
- value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The maximum value.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l332">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( regex, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a string that matches the given RegExp.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>regex: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code><dd>The regex to test.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l318">code &raquo;</a><span class="member"><a name="startsWith">startsWith</a> <span class="args">( prefix, opt_message )</span> &rArr; <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Asserts that the wrapped value is a string starting with the given prefix.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The expected prefix.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A message to include if the matcher does not
-     accept the value wrapped by this assertion.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.testing.NegatedAssertion</code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l377">code &raquo;</a><span class="member"><a name="value">value</a> : <code class="type">*</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code></h3><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l98">code &raquo;</a><span class="member"><a name="is">is</a> : <code class="type">!<a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code></span></div><p>A self reference provided for writing fluent assertions:
-     webdriver.testing.assert(x).is.equalTo(y);</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l105">code &raquo;</a><span class="member"><a name="not">not</a> : <code class="type">!<a href="class_webdriver_testing_NegatedAssertion.html">webdriver.testing.NegatedAssertion</a></code></span></div><p>Negates any matchers applied to this instance's value:
-     webdriver.testing.assert(x).not.equalTo(y);</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l90">code &raquo;</a><span class="member"><a name="value_">value_</a> : <code class="type">*</code></span></div></summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l375">code &raquo;</a><span class="member"><a name="webdriver.testing.NegatedAssertion.superClass_">webdriver.testing.NegatedAssertion.superClass_</a> : <code class="type"><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>NegatedAssertion</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_testing.html">webdriver.testing</a></div><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l378">View Source</a></div><h1>class NegatedAssertion</h1><pre class="inheritance"><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a>
+  &#x2514; webdriver.testing.NegatedAssertion</pre><p>An assertion that negates any applied matchers.</p>
+<h3>new NegatedAssertion(<wbr>value)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to perform assertions on.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="apply" class="function"><div><h3>apply(<wbr>matcher, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l387">code »</a></span></h3><p>Asserts that the given <code>matcher</code> accepts the value wrapped by this
+instance. If the wrapped value is a promise, this function will defer
+applying the assertion until the value has been resolved. Otherwise, it
+will be applied immediately.</p>
+<p><b>Overrides: </b><a href="class_webdriver_testing_Assertion.html#apply">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>matcher<code>goog.labs.testing.Matcher</code><dd><p>The matcher to apply</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The deferred assertion result, or
+<code>null</code> if the assertion was immediately applied.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="closeTo" class="function"><div><h3>closeTo(<wbr>value, range, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l231">code »</a></span></h3><p>Asserts that the wrapped value is a number within a given distance of an
+expected value.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#closeTo">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The expected value.</p>
+<dt>range<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The maximum amount the actual value is permitted to
+differ from the expected value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="contains" class="function"><div><h3>contains(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l294">code »</a></span></h3><p>Asserts that the wrapped value is a string or array-like structure
+containing the given value.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#contains">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The expected value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="endsWith" class="function"><div><h3>endsWith(<wbr>suffix, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l307">code »</a></span></h3><p>Asserts that the wrapped value is a string ending with the given suffix.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#endsWith">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>suffix<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected suffix.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="equalTo" class="function"><div><h3>equalTo(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l348">code »</a></span></h3><p>Asserts that the value managed by this assertion is strictly equal to the
+given <code>value</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#equalTo">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The expected value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="greaterThan" class="function"><div><h3>greaterThan(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l170">code »</a></span></h3><p>Asserts that the value managed by this assertion is a number strictly
+greater than <code>value</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#greaterThan">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The minimum value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="greaterThanEqualTo" class="function"><div><h3>greaterThanEqualTo(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l185">code »</a></span></h3><p>Asserts that the value managed by this assertion is a number &gt;&#61; the given
+value.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#greaterThanEqualTo">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The minimum value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="instanceOf" class="function"><div><h3>instanceOf(<wbr>ctor, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l245">code »</a></span></h3><p>Asserts that the wrapped value is an instance of the given class.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#instanceOf">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ctor<code>Function</code><dd><p>The expected class constructor.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isFalse" class="function"><div><h3>isFalse()<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l366">code »</a></span></h3><p>Asserts that the value managed by this assertion is strictly false.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#isFalse">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isNull" class="function"><div><h3>isNull(<wbr>opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l257">code »</a></span></h3><p>Asserts that the wrapped value is null.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#isNull">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isNullOrUndefined" class="function"><div><h3>isNullOrUndefined(<wbr>opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l279">code »</a></span></h3><p>Asserts that the wrapped value is null or undefined.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#isNullOrUndefined">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isTrue" class="function"><div><h3>isTrue()<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l357">code »</a></span></h3><p>Asserts that the value managed by this assertion is strictly true.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#isTrue">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isUndefined" class="function"><div><h3>isUndefined(<wbr>opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l268">code »</a></span></h3><p>Asserts that the wrapped value is undefined.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#isUndefined">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="lessThan" class="function"><div><h3>lessThan(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l200">code »</a></span></h3><p>Asserts that the value managed by this assertion is a number strictly less
+than the given value.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#lessThan">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The maximum value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="lessThanEqualTo" class="function"><div><h3>lessThanEqualTo(<wbr>value, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l214">code »</a></span></h3><p>Asserts that the value managed by this assertion is a number &lt;&#61; the given
+value.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#lessThanEqualTo">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The maximum value.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="matches" class="function"><div><h3>matches(<wbr>regex, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l335">code »</a></span></h3><p>Asserts that the wrapped value is a string that matches the given RegExp.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#matches">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>regex<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp">RegExp</a></code><dd><p>The regex to test.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="startsWith" class="function"><div><h3>startsWith(<wbr>prefix, opt_message)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l321">code »</a></span></h3><p>Asserts that the wrapped value is a string starting with the given prefix.</p>
+<p><b>Defined by: </b><a href="class_webdriver_testing_Assertion.html#startsWith">webdriver.testing.Assertion</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefix<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected prefix.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A message to include if the matcher does not
+accept the value wrapped by this assertion.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="is" class="property"><dl><dt><a href="source/lib/webdriver/testing/asserts.js.src.html#l101">is</a><code><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code><dd><p>A self reference provided for writing fluent assertions:
+webdriver.testing.assert(x).is.equalTo(y);</p>
+</dl></div><div id="not" class="property"><dl><dt><a href="source/lib/webdriver/testing/asserts.js.src.html#l108">not</a><code><a href="class_webdriver_testing_NegatedAssertion.html">webdriver.testing.NegatedAssertion</a></code><dd><p>Negates any matchers applied to this instance&#39;s value:
+webdriver.testing.assert(x).not.equalTo(y);</p>
+</dl></div><div id="value" class="property"><dl><dt><a href="source/lib/webdriver/testing/asserts.js.src.html#l380">value</a><code>*</code><dd>No description.</dl></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>
\ No newline at end of file
diff --git a/docs/class_webdriver_testing_TestCase.html b/docs/class_webdriver_testing_TestCase.html
new file mode 100644
index 0000000..071792f
--- /dev/null
+++ b/docs/class_webdriver_testing_TestCase.html
@@ -0,0 +1,76 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.testing.TestCase</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class webdriver.testing.TestCase</h1><a class="source" href="source/lib/webdriver/testing/testcase.js.src.html#l48">code &raquo;</a><pre><code><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a>
+  &#x2514; webdriver.testing.TestCase</code></pre></header><section><p>Constructs a test case that synchronizes each test case with the singleton
+ <code >webdriver.promise.ControlFlow</code>.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">webdriver.testing.TestCase <span class="args">( client, opt_name )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>client: <code class="type">!webdriver.testing.Client</code><dd>The test client to use for
+     reporting test results.<dt>opt_name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The name of the test case, defaults to
+     'Untitled Test Case'.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">webdriver.testing.TestCase</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/testcase.js.src.html#l61">code &raquo;</a><span class="member"><a name="cycleTests">cycleTests</a> <span class="args">( )</span></span></div><p>Executes the next test inside its own <code >webdriver.Application</code>.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/testcase.js.src.html#l96">code &raquo;</a><span class="member"><a name="logError">logError</a> <span class="args">( name, opt_e )</span> &rArr; <code class="type">goog.testing.TestCase.Error</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name<dt>opt_e</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/testcase.js.src.html#l154">code &raquo;</a><span class="member"><a name="runSingleTest_">runSingleTest_</a> <span class="args">( test, onError )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Executes a single test, scheduling each phase with the global application.
+ Each phase will wait for the application to go idle before moving on to the
+ next test phase.  This function models the follow basic test flow:
+
+   try {
+     this.setUp.call(test.scope);
+     test.ref.call(test.scope);
+   } catch (ex) {
+     onError(ex);
+   } finally {
+     try {
+       this.tearDown.call(test.scope);
+     } catch (e) {
+       onError(e);
+     }
+   }</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type">!<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test to run.<dt>onError: <code class="type">function(*)</code><dd>The function to call each time an error is
+     detected.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved when the
+     test has finished running.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l289">code &raquo;</a><span class="member"><a name="add">add</a> <span class="args">( test )</span></span></div><p>Adds a new test to the test case.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l310">code &raquo;</a><span class="member"><a name="addNewTest">addNewTest</a> <span class="args">( name, ref, opt_scope )</span></span></div><p>Creates and adds a new test.
+
+ Convenience function to make syntax less awkward when not using automatic
+ test discovery.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The test name.<dt>ref: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Reference to the test function.<dt>opt_scope: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Optional scope that the test function should be
+     called in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l751">code &raquo;</a><span class="member"><a name="autoDiscoverLifecycle">autoDiscoverLifecycle</a> <span class="args">( )</span></span></div><p>Adds any functions defined in the global scope that correspond to
+ lifecycle events for the test case. Overrides setUp, tearDown, setUpPage,
+ tearDownPage and runTests if they are defined.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l777">code &raquo;</a><span class="member"><a name="autoDiscoverTests">autoDiscoverTests</a> <span class="args">( )</span></span></div><p>Adds any functions defined in the global scope that are prefixed with "test"
+ to the test case.</summary></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l933">code &raquo;</a><span class="member"><a name="clearTimeout">clearTimeout</a> <span class="args">( id )</span></span></div><p>Clears a timeout created by <code >this.timeout()</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>id: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A timeout id.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l900">code &raquo;</a><span class="member"><a name="countNumFilesLoaded_">countNumFilesLoaded_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counts the number of files that were loaded for dependencies that are
+ required to run the test.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of files loaded.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l740">code &raquo;</a><span class="member"><a name="createTestFromAutoDiscoveredFunction">createTestFromAutoDiscoveredFunction</a> <span class="args">( name, ref )</span> &rArr; <code class="type">!<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code></span></div><p>Creates a <code >goog.testing.TestCase.Test</code> from an auto-discovered
+     function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function.<dt>ref: <code class="type">function(): void</code><dd>The auto-discovered function.</dl><tr><th>Returns<tr><td><dl>The newly created test.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l1018">code &raquo;</a><span class="member"><a name="doError">doError</a> <span class="args">( test, opt_e )</span></span></div><p>Handles a test that failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test that failed.<dt>opt_e: <code class="type">*=</code><dd>The exception object associated with the
+     failure or a string.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l998">code &raquo;</a><span class="member"><a name="doSuccess">doSuccess</a> <span class="args">( test )</span></span></div><p>Handles a test that passed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>test: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The test that passed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l404">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( )</span></span></div><p>Executes each of the tests.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l426">code &raquo;</a><span class="member"><a name="finalize">finalize</a> <span class="args">( )</span></span></div><p>Finalizes the test case, called when the tests have finished executing.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l349">code &raquo;</a><span class="member"><a name="getActuallyRunCount">getActuallyRunCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of tests actually run in the test case, i.e. subtracting
+ any which are skipped.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of un-ignored tests.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l709">code &raquo;</a><span class="member"><a name="getAutoDiscoveryPrefix">getAutoDiscoveryPrefix</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The function name prefix used to auto-discover tests.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l718">code &raquo;</a><span class="member"><a name="getBatchTime">getBatchTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Time since the last batch of tests was started.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l339">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of tests contained in the test case.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of tests.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l648">code &raquo;</a><span class="member"><a name="getGlobals">getGlobals</a> <span class="args">( opt_prefix )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Gets list of objects that potentially contain test cases. For IE 8 and below,
+ this is the global "this" (for properties set directly on the global this or
+ window) and the RuntimeObject (for global variables and functions). For all
+ other browsers, the array simply contains the global this.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>An optional prefix. If specified, only get things
+     under this prefix. Note that the prefix is only honored in IE, since it
+     supports the RuntimeObject:
+     http://msdn.microsoft.com/en-us/library/ff521039%28VS.85%29.aspx
+     TODO: Remove this option.</dl><tr><th>Returns<tr><td><dl>A list of objects that should be inspected.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l153">code &raquo;</a><span class="member"><a name="getName">getName</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The name of the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l569">code &raquo;</a><span class="member"><a name="getNumFilesLoaded">getNumFilesLoaded</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of script files that were loaded in order to run the test.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of script files.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l528">code &raquo;</a><span class="member"><a name="getReport">getReport</a> <span class="args">( opt_verbose )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string detailing the results from the test.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_verbose: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true results will include data about all
+     tests, not just what failed.</dl><tr><th>Returns<tr><td><dl>The results from the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l560">code &raquo;</a><span class="member"><a name="getRunTime">getRunTime</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the amount of time it took for the test to run.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The run time, in milliseconds.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l579">code &raquo;</a><span class="member"><a name="getTestResults">getTestResults</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns the test results object: a map from test names to a list of test
+ failures (if any exist).</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Tests results object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l330">code &raquo;</a><span class="member"><a name="getTests">getTests</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code></span></div><p>Gets the tests.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The test array.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l957">code &raquo;</a><span class="member"><a name="getTimeStamp_">getTimeStamp_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the current time.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>HH:MM:SS.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l484">code &raquo;</a><span class="member"><a name="isInsideMultiTestRunner">isInsideMultiTestRunner</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test case is running inside the multi test
+     runner.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l517">code &raquo;</a><span class="member"><a name="isSuccess">isSuccess</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the test was a success.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l494">code &raquo;</a><span class="member"><a name="log">log</a> <span class="args">( val )</span></span></div><p>Logs an object to the console, if available.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>The value to log. Will be ToString'd.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l830">code &raquo;</a><span class="member"><a name="maybeFailTestEarly">maybeFailTestEarly</a> <span class="args">( testCase )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks to see if the test should be marked as failed before it is run.
+
+ If there was an error in setUpPage, we treat that as a failure for all tests
+ and mark them all as having failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>testCase: <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code><dd>The current test case.</dl><tr><th>Returns<tr><td><dl>Whether the test was marked as failed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l358">code &raquo;</a><span class="member"><a name="next">next</a> <span class="args">( )</span> &rArr; <code class="type"><a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a></code></span></div><p>Returns the current test and increments the pointer.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current test case.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l945">code &raquo;</a><span class="member"><a name="now">now</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current time in milliseconds, don't use goog.now as some
+     tests override it.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l606">code &raquo;</a><span class="member"><a name="orderTests_">orderTests_</a> <span class="args">( tests )</span></span></div><p>Reorders the tests depending on the <code >order</code> field.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tests: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code><dd>An array of tests to
+     reorder.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l977">code &raquo;</a><span class="member"><a name="pad_">pad_</a> <span class="args">( number )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Pads a number to make it have a leading zero if it's less than 10.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>number: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to pad.</dl><tr><th>Returns<tr><td><dl>The resulting string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l373">code &raquo;</a><span class="member"><a name="reset">reset</a> <span class="args">( )</span></span></div><p>Resets the test case pointer, so that next returns the first test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l590">code &raquo;</a><span class="member"><a name="runTests">runTests</a> <span class="args">( )</span></span></div><p>Executes each of the tests.
+ Overridable by the individual test case.  This allows test cases to defer
+ when the test is actually started.  If overridden, finalize must be called
+ by the test to indicate it has finished.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l475">code &raquo;</a><span class="member"><a name="saveMessage">saveMessage</a> <span class="args">( message )</span></span></div><p>Saves a message to the result set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The message to save.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l727">code &raquo;</a><span class="member"><a name="setBatchTime">setBatchTime</a> <span class="args">( batchTime )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>batchTime: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Time since the last batch of tests was started.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l384">code &raquo;</a><span class="member"><a name="setCompletedCallback">setCompletedCallback</a> <span class="args">( fn )</span></span></div><p>Sets the callback function that should be executed when the tests have
+ completed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The callback function.</dl></table></div></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l321">code &raquo;</a><span class="member"><a name="setTests">setTests</a> <span class="args">( tests )</span></span></div><p>Sets the tests.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tests: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_TestCase_Test.html">goog.testing.TestCase.Test</a>&gt;</code><dd>A new test array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l695">code &raquo;</a><span class="member"><a name="setUp">setUp</a> <span class="args">( )</span></span></div><p>Gets called before every goog.testing.TestCase.Test is been executed. Can be
+ overridden to add set up functionality to each test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l681">code &raquo;</a><span class="member"><a name="setUpPage">setUpPage</a> <span class="args">( )</span></span></div><p>Gets called before any tests are executed.  Can be overridden to set up the
+ environment for the whole test case.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l396">code &raquo;</a><span class="member"><a name="shouldRunTests">shouldRunTests</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Can be overridden in test classes to indicate whether the tests in a case
+ should be run in that particular situation.  For example, this could be used
+ to stop tests running in a particular browser, where browser support for
+ the class under test was absent.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether any of the tests in the case should be run.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l702">code &raquo;</a><span class="member"><a name="tearDown">tearDown</a> <span class="args">( )</span></span></div><p>Gets called after every goog.testing.TestCase.Test has been executed. Can be
+ overriden to add tear down functionality to each test.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l688">code &raquo;</a><span class="member"><a name="tearDownPage">tearDownPage</a> <span class="args">( )</span></span></div><p>Gets called after all tests have been executed.  Can be overridden to tear
+ down the entire test case.</summary></details></div></div><div class="wrap-details protected"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l919">code &raquo;</a><span class="member"><a name="timeout">timeout</a> <span class="args">( fn, time )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Calls a function after a delay, using the protected timeout.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call.<dt>time: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Delay in milliseconds.</dl><tr><th>Returns<tr><td><dl>The timeout id.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l988">code &raquo;</a><span class="member"><a name="trimPath_">trimPath_</a> <span class="args">( path )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims a path to be only that after google3.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The path to trim.</dl><tr><th>Returns<tr><td><dl>The resulting string.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type">webdriver.testing.TestCase</code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/testcase.js.src.html#l52">code &raquo;</a><span class="member"><a name="client_">client_</a> : <code class="type">!webdriver.testing.Client</code></span></div></summary></details></div></div><h3>Defined in <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l266">code &raquo;</a><span class="member"><a name="batchTime_">batchTime_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Time since the last batch of tests was started, if batchTime exceeds
+ <code  class="type"><a class="unresolved-link">#maxRunTime</a></code> a timeout will be used to stop the tests blocking the
+ browser and a new batch will be started.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l274">code &raquo;</a><span class="member"><a name="currentTestPointer_">currentTestPointer_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Pointer to the current test.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l234">code &raquo;</a><span class="member"><a name="exceptionBeforeTest">exceptionBeforeTest</a> : <code class="type">*</code></span></div><p>Exception object that was detected before a test runs.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l63">code &raquo;</a><span class="member"><a name="name_">name_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A name for the test case.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l282">code &raquo;</a><span class="member"><a name="onCompleteCallback_">onCompleteCallback_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Optional callback that will be executed when the test has finalized.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l171">code &raquo;</a><span class="member"><a name="order">order</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The order to run the auto-discovered tests in.</summary></details></div></div><div class="wrap-details protected"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l122">code &raquo;</a><span class="member"><a name="result_">result_</a> : <code class="type"><a href="class_goog_testing_TestCase_Result.html">goog.testing.TestCase.Result</a></code></span></div><p>Object used to encapsulate the test results.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l248">code &raquo;</a><span class="member"><a name="running">running</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the test case is running.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l256">code &raquo;</a><span class="member"><a name="startTime_">startTime_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Timestamp for when the test was started.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l241">code &raquo;</a><span class="member"><a name="started">started</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the test case has ever tried to execute.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l92">code &raquo;</a><span class="member"><a name="testsToRun_">testsToRun_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Set of test names and/or indices to execute, or null if all tests should
+ be executed.
+
+ Indices are included to allow automation tools to run a subset of the
+ tests without knowing the exact contents of the test file.
+
+ Indices should only be used with SORTED ordering.
+
+ Example valid values:
+ <ul>
+ <li>[testName]
+ <li>[testName1, testName2]
+ <li>[2] - will run the 3rd test in the order specified
+ <li>[1,3,5]
+ <li>[testName1, testName2, 3, 5] - will work
+ <ul></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l70">code &raquo;</a><span class="member"><a name="tests_">tests_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Array of test functions that can be executed.</summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/testing/testcase.js.src.html#l48">code &raquo;</a><span class="member"><a name="webdriver.testing.TestCase.superClass_">webdriver.testing.TestCase.superClass_</a> : <code class="type"><a href="class_goog_testing_TestCase.html">goog.testing.TestCase.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/class_webdriver_until_Condition.html b/docs/class_webdriver_until_Condition.html
new file mode 100644
index 0000000..3f942fc
--- /dev/null
+++ b/docs/class_webdriver_until_Condition.html
@@ -0,0 +1,7 @@
+<!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>Condition</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_until.html">webdriver.until</a></div><div class="codelink"><a href="source/lib/webdriver/until.js.src.html#l67">View Source</a></div><h1>class Condition&lt;OUT&gt;</h1><div class="tags"><span>final</span><span>struct</span></div><p>Defines a condition to</p>
+<h3>new Condition(<wbr>message, fn)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A descriptive error message. Should complete the
+sentence &#34;Waiting [...]&#34;</p>
+<dt>fn<code>function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): OUT</code><dd><p>The condition function to
+evaluate on each iteration of the wait loop.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="description" class="function"><div><h3>description()<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l77">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of this condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="fn" class="function"><div><h3>fn(<wbr>arg0)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l72">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arg0<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>OUT</code></dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/dossier.css b/docs/dossier.css
index 53ce031..1a6a134 100644
--- a/docs/dossier.css
+++ b/docs/dossier.css
@@ -1 +1 @@
-article,details,main,nav,section,summary{display:block}html{font-size:10px}html,body{height:100%}body{margin:0;padding:0;font-size:1.2rem;font-size:1.2em;font-family:sans-serif;background:#fff;color:#424242}a{text-decoration:none}a[href]{color:#66f}a[href]:hover{text-decoration:underline}code{font-size:1.2rem}code.type,code.type a[href],code.type a.unresolved-link{font-weight:normal;color:#080}code.type a.unresolved-link{border-bottom:1px dotted #080}pre,p{margin:1rem 0}.args{color:#828282;font-weight:normal}h1{border-bottom:1px solid #8f8f8f;margin:.2rem 0 0 0;padding:.5rem 0 .1rem;font-size:2.5rem}h1 code{font-size:1.85rem}h1 .deprecation-notice{color:#828282;font-weight:normal;font-style:italic;font-size:.66em}table{border-collapse:collapse;border-spacing:0;margin:0;padding:0;width:100%}tr{border:0;margin:0;padding:0}th{border-bottom:1px solid #8f8f8f;text-align:left;padding-top:.5rem}td>dl{margin-left:1rem}summary:focus{outline:0}summary::-webkit-details-marker{display:none}a.source{float:right}header>dl{margin-left:0}header>dl,header>pre,header>a.source{margin-top:.5rem}header+*{clear:right}dl{margin:0 0 0 1.25rem}dt{font-weight:bold}dd{margin-left:1.25rem}dd+dt{margin-top:.5rem}.type-summary{border-top:1px solid #8f8f8f;border-left:1px solid #8f8f8f}.type-summary dl{padding:.5rem 0 0 1rem;margin-left:0}.member{font-weight:bold}.member.deprecation-notice{text-decoration:line-through}#sidenav-toggle,#menubutton{display:none}#topnav{position:absolute;top:0;right:0;left:0;height:4rem;background:#424242;color:#fff;font-weight:bold;z-index:1}#topnav>div{position:relative;height:4rem;width:100%}#searchbox{position:absolute;right:1.5rem}#searchbox div{display:table-cell;vertical-align:middle;height:4rem}#searchbox input{width:25rem;box-shadow:inset 1px 2px rgba(0,0,0,0.18);border-radius:15px;border:1px solid #0f0f0f;padding:.2rem .5rem}.ac-renderer{position:absolute;background:#fcfcfc;border:1px solid #424242;-moz-box-shadow:2px 2px 2px rgba(102,102,102,0.4);-webkit-box-shadow:2px 2px 2px rgba(102,102,102,0.4);box-shadow:2px 2px 2px rgba(102,102,102,0.4);z-index:2;width:30rem;overflow:auto}.ac-row{cursor:pointer;padding:.5rem}.ac-highlighted{font-weight:bold}.ac-active{background-color:rgba(82,82,82,0.1)}main{margin-top:4rem;padding-bottom:2.5rem;padding-left:2rem;width:-webkit-calc(75% - 2rem);width:calc(75% - 2rem);float:left}.ctor{padding:.5rem 0 .5rem .5rem}dl.public{border-left:.7rem solid rgba(34,139,34,0.6)}dl.protected{border-left:.7rem solid rgba(218,165,32,0.6)}dl.private{border-left:.7rem solid rgba(255,0,0,0.5)}.wrap-details{border-top:1px solid #8f8f8f;border-left:1px solid #8f8f8f;margin-bottom:1px;display:none}.wrap-details.ctor{padding:0;display:block}main.public .wrap-details.public,main.protected .wrap-details.protected,main.private .wrap-details.private{display:block}.wrap-details.public>div:first-child{border-left:.7rem solid rgba(34,139,34,0.6)}.wrap-details.protected>div:first-child{border-left:.7rem solid rgba(218,165,32,0.6)}.wrap-details.private>div:first-child{border-left:.7rem solid rgba(255,0,0,0.5)}.wrap-details.inv{display:block}main.public .wrap-details.inv.public,main.protected .wrap-details.inv.protected,main.private .wrap-details.inv.private{display:none}.wrap-details.inv.public{color:#828282;font-weight:normal}.wrap-details.inv.public>div:first-child{border-left:.7rem solid rgba(34,139,34,0.4)}.wrap-details.inv.protected{color:#828282;font-weight:normal}.wrap-details.inv.protected>div:first-child{border-left:.7rem solid rgba(218,165,32,0.4)}.wrap-details.inv.private{color:#828282;font-weight:normal}.wrap-details.inv.private>div:first-child{border-left:.7rem solid rgba(255,0,0,0.4)}#visibility-controls{float:right}label{cursor:pointer}label[for=show-public]>span{border:1px outset #228b22;border-radius:5px;background:rgba(34,139,34,0.6);margin:0 .3rem}label[for=show-protected]>span{border:1px outset #daa520;border-radius:5px;background:rgba(218,165,32,0.6);margin:0 .3rem}label[for=show-private]>span{border:1px outset #f00;border-radius:5px;background:rgba(255,0,0,0.5);margin:0 .3rem}details>summary{padding-top:.5rem;margin-left:1.25rem;padding-bottom:.5rem}details>summary p{margin-top:.5rem;margin-bottom:0}details>summary pre:last-child{margin-bottom:0}details.function>summary:before{content:'\2b';float:left;margin-left:-1rem}details.function[open]>summary:before{content:'\2212'}details.function[open]>:last-child{padding-bottom:.5rem}header div.deprecation-notice{margin-top:1rem}h2{font-size:1.8rem;margin-top:1.25rem;margin-bottom:.15rem}section h3{margin:.75rem 0 .25rem;font-size:1.4rem}section+section{margin-top:1.75rem}div.deprecation-notice{font-weight:bold;margin:.25rem 0}h1 span.deprecation-notice,span.deprecation-reason{font-weight:normal;font-style:italic}.info{padding:0 1.25rem}table.srcfile,table.licensefile{border:1px solid #8f8f8f;font-size:1.1rem;width:auto}table.srcfile tr:first-child td,table.licensefile tr:first-child td{padding-top:.5rem}table.srcfile tr:last-child td,table.licensefile tr:last-child td{padding-bottom:.5rem}.licensefile td,.srcfile td,.srcfile a{color:#424242}.licensefile td,.srcfile td{padding:.15rem 1rem;background-color:#f4f4f4}.srcfile td:first-child{text-align:right;padding:0 .5rem 0 1rem;border-right:1px solid #8f8f8f;-webkit-touch-callout:none;-webkit-user-select:none;-khtml-user-select:none;-moz-user-select:-moz-none;-ms-user-select:none;user-select:none}#sidenav{width:24%;margin-top:4rem;float:right;overflow:hidden;line-height:1.5;font-size:1.2rem;background:#fff}#sidenav input{display:none}#sidenav>a[href]{color:#fff}#sidenav h4{color:#fff;width:100%;font-size:1.4rem;font-weight:500;padding:.5rem 1.2rem 0;height:3rem;margin:0;border-top:1px solid rgba(255,255,255,0.2);border-bottom:1px solid #292929;background:#424242}#sidenav h4:hover{background:#545454}#sidenav li{list-style:none}#sidenav li.link:hover{background:rgba(82,82,82,0.1)}#sidenav li ul{padding:0 0 0 1.5rem}#sidenav ul{margin:0;padding:0 0 0 1rem;overflow:hidden;-webkit-transition:height .25s ease;-moz-transition:height .25s ease;-o-transition:height .25s ease;-ms-transition:height .25s ease;transition:height .25s ease}#main-wrapper{min-height:100%;height:100%;margin-bottom:-3rem}footer,#push-footer{clear:both;height:2rem}footer{font-size:1rem;background:#424242;padding:.5rem 0 .5rem 2.25rem;width:-webkit-calc(100% - 2.25rem);width:calc(100% - 2.25rem)}footer a[href]{color:rgba(255,255,255,0.8)}
\ No newline at end of file
+@import url(https://fonts.googleapis.com/css?family=Roboto+Mono:400,400italic,700,700italic|Roboto);body,html{min-height:100vh;height:100%}body a[id],h1 a[id],h2 a[id],h3 a[id]{display:inline-block}body,h3 .codelink,h5{font-size:1.4rem}nav .interface,table caption{font-style:italic}*{margin:0;padding:0}html{font-size:10px;position:relative}body{color:#333;font-family:Roboto,sans-serif;line-height:1.6;word-wrap:break-word;background:#f0f0f0;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:column;-ms-flex-direction:column;flex-direction:column}body .function,body .property,body a[id]{padding-top:6.4rem;margin-top:-6.4rem}a,a:visited{color:#66f;text-decoration:none}a[href]:hover{text-decoration:underline}h1,h2,h3,h4,h5,h6{margin:1.5rem 0}h1,h2,h3{border-bottom:1px solid #8f8f8f}h1{font-size:2.5rem}h1 .function,h1 .property,h1 a[id]{padding-top:7.5rem;margin-top:-7.5rem}h1+.tags{margin-top:-1rem}h2{font-size:2.2rem;margin-top:4rem}h2 .function,h2 .property,h2 a[id]{padding-top:7.2rem;margin-top:-7.2rem}h3{font-size:1.8rem;border:0}h3 .function,h3 .property,h3 a[id]{padding-top:6.8rem;margin-top:-6.8rem}h3+.tags{margin-top:-1.5rem}h3 .codelink{font-weight:400;display:inline}.tags span,dt{font-weight:700}h3 .codelink:after{clear:none;display:none}h4 a[id],h5 a[id],h6 a[id]{display:inline-block}h3 code{font-size:75%}h4{font-size:1.6rem}h4 .function,h4 .property,h4 a[id]{padding-top:6.6rem;margin-top:-6.6rem}h5 .function,h5 .property,h5 a[id]{padding-top:6.4rem;margin-top:-6.4rem}h6{font-size:1.2rem}h6 .function,h6 .property,h6 a[id]{padding-top:6.2rem;margin-top:-6.2rem}.srcfile table,code,pre.inheritance{font-family:"Roboto Mono",Menlo,monospace;font-size:1.2rem}pre{background:#f8f8f8;border-radius:3px;border-left:.2rem solid #d2d2d2;line-height:1.45;word-wrap:normal;margin:1rem 3rem;padding:1rem;overflow:auto}pre.inheritance{border:0;background:initial;padding:0;margin:.5rem 0 1rem}h1+pre.inheritance{margin-top:-1rem}p{margin:0 0 1rem}li code,p code{background:#f8f8f8;padding:2px;border-radius:3px;border:1px solid #d2d2d2}pre code{border:0}.fn-details div:first-child{border-bottom:1px solid #c2c2c2;margin-top:.5rem}hr.fn-sep{border:0;border-top:1px solid #dcdcdc;width:50%;margin:2rem auto auto}.tags span{background:rgba(102,102,255,.25);border:1px solid #66f;border-radius:3px;color:#66f;font-size:75%;padding:2px 4px;line-height:1.4rem}.tags span+span{margin-left:2px}.function:target>div,.property:target>dl{border-left:3px solid rgba(102,102,255,.7);padding-left:9px;margin-left:-9pt}dt.deprecated{text-decoration:line-through}nav .current,nav .selectable:hover,nav :focus{text-decoration:underline}dt>code{font-weight:400;color:#66f;margin-left:.5rem}.ac-highlighted,.srcfile :target+a,nav .current{font-weight:700}dd{margin:0 0 0 3rem}ol,ul{margin:1rem 0 1rem 4rem}blockquote{margin:1rem 3rem}table{border-collapse:collapse;border-spacing:0;margin:0 auto}table tr{background:#fff;border-top:1px solid #ccc}table tr:nth-child(2n){background:#f8f8f8}td,th{padding:.6rem 1.3rem;border:1px solid #ddd}.parentlink{float:left}.codelink a{float:right}.codelink:after{clear:both;content:"";display:table}footer,header{background:#424242}header{position:fixed;top:0;left:0;right:0;height:5rem;box-shadow:0 1px 5px #888}header>div{display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-ms-flex-align:center;align-items:center;-webkit-justify-content:flex-end;-ms-flex-pack:end;justify-content:flex-end;height:100%}header input{height:3rem;width:30rem;padding:0 10px;border-radius:15px;border:0;-webkit-appearance:none;color:#fff;background:rgba(255,255,255,.25)}header input::-webkit-input-placeholder{color:#fff}header input::-moz-placeholder{color:#fff}header input:-ms-input-placeholder{color:#fff}header input:focus{background:#fff;color:#333;outline:0}.ac-renderer{position:absolute;background:#fff;border:1px solid #000;box-shadow:2px 2px 2px rgba(102,102,102,.4);z-index:2;overflow:auto;width:32rem;margin-left:-1rem}nav li,nav li label,nav li>a{text-overflow:ellipsis;overflow:hidden}.ac-row{cursor:pointer;padding:.5rem}.ac-active{background-color:rgba(82,82,82,.1)}@media (max-width:320px){.ac-renderer{width:30rem;margin:0}}@media (max-width:1000px){header>div{-webkit-justify-content:center;-ms-flex-pack:center;justify-content:center}}@media (min-width:1000px){header>div{width:100rem;margin:0 auto}}footer{padding:0;margin:0;font-size:1.1rem}footer div{display:table-cell;vertical-align:middle;height:4rem}footer a{padding-left:2.25rem}footer a,footer a:visited{color:rgba(255,255,255,.8)}#nav-modules,#nav-modules:checked~div,#nav-types,#nav-types:checked~div{display:none}#nav-modules~label h3:after,#nav-types~label h3:after{content:'\2335';display:inline-block;float:right;margin-right:1rem;-webkit-transform:rotate(0);transform:rotate(0)}#nav-modules:checked~label h3:after,#nav-types:checked~label h3:after{float:right;margin-right:1rem;-webkit-transform:rotate(-90deg);transform:rotate(-90deg)}nav{margin:0 0 3rem 1rem;font-size:1.3rem;-webkit-touch-callout:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}nav .selectable,nav a{-webkit-touch-callout:default;-webkit-user-select:text;-moz-user-select:text;-ms-user-select:text;user-select:text}nav :focus{outline:0}nav ul{margin:0;padding:0}nav ul.nav-tree{margin:0 0 0 .3rem;padding:0 0 0 .5rem;border-left:1px dotted rgba(66,66,66,.5)}nav li{list-style:none;word-wrap:initial}nav li input{display:none}nav li input~ul.nav-tree>li{display:block}nav li input:checked~ul.nav-tree>li{display:none}nav li label,nav li>a{display:block;width:100%;white-space:nowrap}nav li label.focused,nav li label:hover,nav li>a:focus,nav li>a:hover{background:rgba(102,102,255,.1)}nav li>a:before{visibility:hidden}nav li label:before,nav li>a:before{float:left;margin-right:1rem;content:'\2212';font-size:1.4rem}nav li input:checked+label:before{content:'\002b'}nav h3{font-size:2rem;border:0;border-top:1px solid #8f8f8f;margin-top:1.2rem}nav h3 a,nav h3 a:visited{color:#424242}nav>h3:first-child{border-top:0;margin-top:0}div.pre-footer>div,main{background:#fff}main{-webkit-flex:1 0 auto;-ms-flex:1 0 auto;flex:1 0 auto;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-direction:row-reverse;-ms-flex-direction:row-reverse;flex-direction:row-reverse}article{margin-top:2.5rem;padding:3rem}article.indexfile>h1,article.srcfile>h1{margin-top:0;white-space:nowrap;text-overflow:ellipsis;overflow:hidden}article.indexfile>h1:hover,article.srcfile>h1:hover{overflow:visible}.srcfile div{width:100%;overflow:auto}.srcfile table{background:#f8f8f8;border-radius:3px;border-left:.2rem solid #d2d2d2;line-height:1.45;word-wrap:normal;white-space:pre;margin:1rem 0;width:100%}.srcfile td{padding:0 .8rem;border:0}.srcfile td:first-child{text-align:right;padding-left:.8rem}.srcfile tr{background:#f8f8f8;border:0}.srcfile tr:first-child td{padding-top:1rem}.srcfile tr:last-child td{padding-bottom:1rem}.srcfile tr.hilite{background:rgba(102,102,255,.1)}@media (max-width:1000px){main{-webkit-flex-direction:column;-ms-flex-direction:column;flex-direction:column}article{padding:3rem 1rem}}@media (min-width:1000px){main{width:100rem;margin:0 auto}article{width:66rem}nav{margin-top:2.5rem;width:23rem;float:left;padding-top:3rem;padding-right:4rem}}
\ No newline at end of file
diff --git a/docs/dossier.js b/docs/dossier.js
index b2ebb52..9fdece5 100644
--- a/docs/dossier.js
+++ b/docs/dossier.js
@@ -1,135 +1,86 @@
-(function(){var h,m=this;function aa(){}
-function ba(a){var b=typeof a;if("object"==b)if(a){if(a instanceof Array)return"array";if(a instanceof Object)return b;var c=Object.prototype.toString.call(a);if("[object Window]"==c)return"object";if("[object Array]"==c||"number"==typeof a.length&&"undefined"!=typeof a.splice&&"undefined"!=typeof a.propertyIsEnumerable&&!a.propertyIsEnumerable("splice"))return"array";if("[object Function]"==c||"undefined"!=typeof a.call&&"undefined"!=typeof a.propertyIsEnumerable&&!a.propertyIsEnumerable("call"))return"function"}else return"null";else if("function"==
-b&&"undefined"==typeof a.call)return"object";return b}function r(a){return"array"==ba(a)}function ca(a){var b=ba(a);return"array"==b||"object"==b&&"number"==typeof a.length}function s(a){return"string"==typeof a}function da(a){return"number"==typeof a}function ea(a){return"function"==ba(a)}function fa(a){var b=typeof a;return"object"==b&&null!=a||"function"==b}function ga(a){return a[ha]||(a[ha]=++ia)}var ha="closure_uid_"+(1E9*Math.random()>>>0),ia=0;
-function ja(a,b,c){return a.call.apply(a.bind,arguments)}function ka(a,b,c){if(!a)throw Error();if(2<arguments.length){var d=Array.prototype.slice.call(arguments,2);return function(){var c=Array.prototype.slice.call(arguments);Array.prototype.unshift.apply(c,d);return a.apply(b,c)}}return function(){return a.apply(b,arguments)}}function t(a,b,c){t=Function.prototype.bind&&-1!=Function.prototype.bind.toString().indexOf("native code")?ja:ka;return t.apply(null,arguments)}
-function la(a,b){var c=Array.prototype.slice.call(arguments,1);return function(){var b=c.slice();b.push.apply(b,arguments);return a.apply(this,b)}}var w=Date.now||function(){return+new Date};function x(a,b){function c(){}c.prototype=b.prototype;a.i=b.prototype;a.prototype=new c};var ma;function na(a){return a.replace(/^[\s\xa0]+|[\s\xa0]+$/g,"")}function oa(a){if(!pa.test(a))return a;-1!=a.indexOf("&")&&(a=a.replace(qa,"&amp;"));-1!=a.indexOf("<")&&(a=a.replace(ra,"&lt;"));-1!=a.indexOf(">")&&(a=a.replace(sa,"&gt;"));-1!=a.indexOf('"')&&(a=a.replace(ta,"&quot;"));return a}var qa=/&/g,ra=/</g,sa=/>/g,ta=/\"/g,pa=/[&<>\"]/;function ua(a){return String(a).replace(/([-()\[\]{}+?*.$\^|,:#<!\\])/g,"\\$1").replace(/\x08/g,"\\x08")};var z=Array.prototype,va=z.indexOf?function(a,b,c){return z.indexOf.call(a,b,c)}:function(a,b,c){c=null==c?0:0>c?Math.max(0,a.length+c):c;if(s(a))return s(b)&&1==b.length?a.indexOf(b,c):-1;for(;c<a.length;c++)if(c in a&&a[c]===b)return c;return-1},A=z.forEach?function(a,b,c){z.forEach.call(a,b,c)}:function(a,b,c){for(var d=a.length,e=s(a)?a.split(""):a,f=0;f<d;f++)f in e&&b.call(c,e[f],f,a)},xa=z.filter?function(a,b,c){return z.filter.call(a,b,c)}:function(a,b,c){for(var d=a.length,e=[],f=0,g=s(a)?
-a.split(""):a,k=0;k<d;k++)if(k in g){var l=g[k];b.call(c,l,k,a)&&(e[f++]=l)}return e},ya=z.map?function(a,b,c){return z.map.call(a,b,c)}:function(a,b,c){for(var d=a.length,e=Array(d),f=s(a)?a.split(""):a,g=0;g<d;g++)g in f&&(e[g]=b.call(c,f[g],g,a));return e};function za(a,b){var c;a:{c=a.length;for(var d=s(a)?a.split(""):a,e=0;e<c;e++)if(e in d&&b.call(void 0,d[e],e,a)){c=e;break a}c=-1}return 0>c?null:s(a)?a.charAt(c):a[c]}function Aa(a){return z.concat.apply(z,arguments)}
-function Ba(a){var b=a.length;if(0<b){for(var c=Array(b),d=0;d<b;d++)c[d]=a[d];return c}return[]}var Ca=Ba;function Da(a,b,c){return 2>=arguments.length?z.slice.call(a,b):z.slice.call(a,b,c)};var Ea,Fa,Ga,Ha,B;function Ia(){return m.navigator?m.navigator.userAgent:null}function Ja(){return m.navigator}Ha=Ga=Fa=Ea=!1;var Ka;if(Ka=Ia()){var La=Ja();Ea=0==Ka.lastIndexOf("Opera",0);Fa=!Ea&&(-1!=Ka.indexOf("MSIE")||-1!=Ka.indexOf("Trident"));Ga=!Ea&&-1!=Ka.indexOf("WebKit");Ha=!Ea&&!Ga&&!Fa&&"Gecko"==La.product}var C=Ea,D=Fa,E=Ha,F=Ga,Ma=Ja();B=-1!=(Ma&&Ma.platform||"").indexOf("Mac");var Na=!!Ja()&&-1!=(Ja().appVersion||"").indexOf("X11");
-function Oa(){var a=m.document;return a?a.documentMode:void 0}var Pa;a:{var Qa="",Ra;if(C&&m.opera)var Sa=m.opera.version,Qa="function"==typeof Sa?Sa():Sa;else if(E?Ra=/rv\:([^\);]+)(\)|;)/:D?Ra=/\b(?:MSIE|rv)[: ]([^\);]+)(\)|;)/:F&&(Ra=/WebKit\/(\S+)/),Ra)var Ta=Ra.exec(Ia()),Qa=Ta?Ta[1]:"";if(D){var Ua=Oa();if(Ua>parseFloat(Qa)){Pa=String(Ua);break a}}Pa=Qa}var Va={};
-function G(a){var b;if(!(b=Va[a])){b=0;for(var c=na(String(Pa)).split("."),d=na(String(a)).split("."),e=Math.max(c.length,d.length),f=0;0==b&&f<e;f++){var g=c[f]||"",k=d[f]||"",l=/(\d*)(\D*)/g,n=/(\d*)(\D*)/g;do{var p=l.exec(g)||["","",""],q=n.exec(k)||["","",""];if(0==p[0].length&&0==q[0].length)break;b=((0==p[1].length?0:parseInt(p[1],10))<(0==q[1].length?0:parseInt(q[1],10))?-1:(0==p[1].length?0:parseInt(p[1],10))>(0==q[1].length?0:parseInt(q[1],10))?1:0)||((0==p[2].length)<(0==q[2].length)?-1:
-(0==p[2].length)>(0==q[2].length)?1:0)||(p[2]<q[2]?-1:p[2]>q[2]?1:0)}while(0==b)}b=Va[a]=0<=b}return b}var Wa=m.document,H=Wa&&D?Oa()||("CSS1Compat"==Wa.compatMode?parseInt(Pa,10):5):void 0;var Xa=!D||D&&9<=H;!E&&!D||D&&D&&9<=H||E&&G("1.9.1");D&&G("9");var Ya="H3";function Za(a,b){var c;c=a.className;c=s(c)&&c.match(/\S+/g)||[];for(var d=Da(arguments,1),e=c.length+d.length,f=c,g=0;g<d.length;g++)0<=va(f,d[g])||f.push(d[g]);a.className=c.join(" ");return c.length==e};function I(a,b){this.x=void 0!==a?a:0;this.y=void 0!==b?b:0}I.prototype.X=function(){return new I(this.x,this.y)};function $a(a,b){return new I(a.x-b.x,a.y-b.y)}I.prototype.round=function(){this.x=Math.round(this.x);this.y=Math.round(this.y);return this};function ab(a,b){this.width=a;this.height=b}ab.prototype.X=function(){return new ab(this.width,this.height)};ab.prototype.round=function(){this.width=Math.round(this.width);this.height=Math.round(this.height);return this};function bb(a,b){for(var c in a)b.call(void 0,a[c],c,a)}function cb(){var a=db,b;for(b in a)return!1;return!0}var eb="constructor hasOwnProperty isPrototypeOf propertyIsEnumerable toLocaleString toString valueOf".split(" ");function fb(a,b){for(var c,d,e=1;e<arguments.length;e++){d=arguments[e];for(c in d)a[c]=d[c];for(var f=0;f<eb.length;f++)c=eb[f],Object.prototype.hasOwnProperty.call(d,c)&&(a[c]=d[c])}};function J(a){return a?new gb(K(a)):ma||(ma=new gb)}function M(a){var b=document;return s(a)?b.getElementById(a):a}function hb(a,b){bb(b,function(b,d){"style"==d?a.style.cssText=b:"class"==d?a.className=b:"for"==d?a.htmlFor=b:d in ib?a.setAttribute(ib[d],b):0==d.lastIndexOf("aria-",0)||0==d.lastIndexOf("data-",0)?a.setAttribute(d,b):a[d]=b})}
-var ib={cellpadding:"cellPadding",cellspacing:"cellSpacing",colspan:"colSpan",frameborder:"frameBorder",height:"height",maxlength:"maxLength",role:"role",rowspan:"rowSpan",type:"type",usemap:"useMap",valign:"vAlign",width:"width"};function jb(a){return F||"CSS1Compat"!=a.compatMode?a.body||a.documentElement:a.documentElement}function kb(a,b,c){return lb(document,arguments)}
-function lb(a,b){var c=b[0],d=b[1];if(!Xa&&d&&(d.name||d.type)){c=["<",c];d.name&&c.push(' name="',oa(d.name),'"');if(d.type){c.push(' type="',oa(d.type),'"');var e={};fb(e,d);delete e.type;d=e}c.push(">");c=c.join("")}c=a.createElement(c);d&&(s(d)?c.className=d:r(d)?Za.apply(null,[c].concat(d)):hb(c,d));2<b.length&&mb(a,c,b);return c}
-function mb(a,b,c){function d(c){c&&b.appendChild(s(c)?a.createTextNode(c):c)}for(var e=2;e<c.length;e++){var f=c[e];if(!ca(f)||fa(f)&&0<f.nodeType)d(f);else{var g;a:{if(f&&"number"==typeof f.length){if(fa(f)){g="function"==typeof f.item||"string"==typeof f.item;break a}if(ea(f)){g="function"==typeof f.item;break a}}g=!1}A(g?Ba(f):f,d)}}}function nb(a,b){b.parentNode&&b.parentNode.insertBefore(a,b.nextSibling)}function ob(a){return a&&a.parentNode?a.parentNode.removeChild(a):null}
-function K(a){return 9==a.nodeType?a:a.ownerDocument||a.document}function gb(a){this.j=a||m.document||document}h=gb.prototype;h.Na=function(a,b,c){return lb(this.j,arguments)};h.createElement=function(a){return this.j.createElement(a)};h.createTextNode=function(a){return this.j.createTextNode(String(a))};function pb(a){return"CSS1Compat"==a.j.compatMode}
-function qb(a){var b=a.j;a=jb(b);b=b.parentWindow||b.defaultView;return D&&G("10")&&b.pageYOffset!=a.scrollTop?new I(a.scrollLeft,a.scrollTop):new I(b.pageXOffset||a.scrollLeft,b.pageYOffset||a.scrollTop)}h.appendChild=function(a,b){a.appendChild(b)};function rb(a){for(var b;b=a.firstChild;)a.removeChild(b)}h.removeNode=ob;
-h.contains=function(a,b){if(a.contains&&1==b.nodeType)return a==b||a.contains(b);if("undefined"!=typeof a.compareDocumentPosition)return a==b||Boolean(a.compareDocumentPosition(b)&16);for(;b&&a!=b;)b=b.parentNode;return b==a};D&&G(8);var sb={},tb={};function ub(a,b){var c=J(),d=vb(a(b||wb,void 0,void 0));var e=c.j,c=e.createElement("div");D?(c.innerHTML="<br>"+d,c.removeChild(c.firstChild)):c.innerHTML=d;if(1==c.childNodes.length)d=c.removeChild(c.firstChild);else for(d=e.createDocumentFragment();c.firstChild;)d.appendChild(c.firstChild);return d}function vb(a){return fa(a)?"zSoyz":String(a)}var wb={};/*
-
- Copyright 2008 Google Inc.
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-     http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
-*/
-function N(a){return a&&a.va&&a.va===sb?a.content:String(a).replace(xb,yb)}var zb={"\x00":"&#0;",'"':"&quot;","&":"&amp;","'":"&#39;","<":"&lt;",">":"&gt;","\t":"&#9;","\n":"&#10;","\x0B":"&#11;","\f":"&#12;","\r":"&#13;"," ":"&#32;","-":"&#45;","/":"&#47;","=":"&#61;","`":"&#96;","\u0085":"&#133;","\u00a0":"&#160;","\u2028":"&#8232;","\u2029":"&#8233;"};function yb(a){return zb[a]}var xb=/[\x00\x22\x26\x27\x3c\x3e]/g;function Ab(a){return'<div class="wrap-details inv '+N(a.visibility)+'"><div><details><summary><label for="show-'+N(a.visibility)+'">Show '+N(a.count)+" hidden item"+(1<a.count?"s":"")+"</label></summary></details></div></div>"}
-function Bb(a){var b="";if(a.types.length){for(var b=b+"<ul>",c=a.types,d=c.length,e=0;e<d;e++)var f=c[e],b=b+((f.$b?"":'<li class="link"><a href="'+N(a.I)+N(f.href)+'">'+(f.Zb?"<i>"+N(f.name)+"</i>":N(f.name))+"</a>")+(a.ya&&f.types&&f.types.length?Bb({types:f.types,I:a.I,ya:a.ya}):""));b+="</ul>"}return b}
-function Cb(a){var b,c=0<a.file.children.length;b=""+(a.parent?"":"<ul>");if(c){b+=a.file.name?"<li>"+N(a.file.name)+"/<ul>":"";for(var c=a.file.children,d=c.length,e=0;e<d;e++)b+=Cb({file:c[e],I:a.I,parent:a.file});b+=a.file.name?"</ul>":""}else a.file.name&&(b+='<li class="link"><a href="'+N(a.I)+N(a.file.href)+'">'+N(a.file.name)+"</a>");return b+=a.parent?"":"</ul>"};var Db=!D||D&&9<=H,Eb=D&&!G("9");!F||G("528");E&&G("1.9b")||D&&G("8")||C&&G("9.5")||F&&G("528");E&&!G("8")||D&&G("9");function O(){0!=Fb&&(Gb[ga(this)]=this)}var Fb=0,Gb={};O.prototype.Oa=!1;O.prototype.B=function(){if(!this.Oa&&(this.Oa=!0,this.e(),0!=Fb)){var a=ga(this);delete Gb[a]}};O.prototype.e=function(){if(this.bb)for(;this.bb.length;)this.bb.shift()()};function Hb(a){a&&"function"==typeof a.B&&a.B()};function P(a,b){this.type=a;this.currentTarget=this.target=b}h=P.prototype;h.e=function(){};h.B=function(){};h.G=!1;h.defaultPrevented=!1;h.nb=!0;h.stopPropagation=function(){this.G=!0};h.preventDefault=function(){this.defaultPrevented=!0;this.nb=!1};var Ib="change";function Jb(a){Jb[" "](a);return a}Jb[" "]=aa;function Q(a,b){a&&Kb(this,a,b)}x(Q,P);h=Q.prototype;h.target=null;h.relatedTarget=null;h.offsetX=0;h.offsetY=0;h.clientX=0;h.clientY=0;h.screenX=0;h.screenY=0;h.button=0;h.keyCode=0;h.charCode=0;h.ctrlKey=!1;h.altKey=!1;h.shiftKey=!1;h.metaKey=!1;h.O=null;
-function Kb(a,b,c){var d=a.type=b.type;P.call(a,d);a.target=b.target||b.srcElement;a.currentTarget=c;if(c=b.relatedTarget){if(E){var e;a:{try{Jb(c.nodeName);e=!0;break a}catch(f){}e=!1}e||(c=null)}}else"mouseover"==d?c=b.fromElement:"mouseout"==d&&(c=b.toElement);a.relatedTarget=c;a.offsetX=F||void 0!==b.offsetX?b.offsetX:b.layerX;a.offsetY=F||void 0!==b.offsetY?b.offsetY:b.layerY;a.clientX=void 0!==b.clientX?b.clientX:b.pageX;a.clientY=void 0!==b.clientY?b.clientY:b.pageY;a.screenX=b.screenX||0;
-a.screenY=b.screenY||0;a.button=b.button;a.keyCode=b.keyCode||0;a.charCode=b.charCode||("keypress"==d?b.keyCode:0);a.ctrlKey=b.ctrlKey;a.altKey=b.altKey;a.shiftKey=b.shiftKey;a.metaKey=b.metaKey;a.state=b.state;a.O=b;b.defaultPrevented&&a.preventDefault();delete a.G}h.stopPropagation=function(){Q.i.stopPropagation.call(this);this.O.stopPropagation?this.O.stopPropagation():this.O.cancelBubble=!0};
-h.preventDefault=function(){Q.i.preventDefault.call(this);var a=this.O;if(a.preventDefault)a.preventDefault();else if(a.returnValue=!1,Eb)try{if(a.ctrlKey||112<=a.keyCode&&123>=a.keyCode)a.keyCode=-1}catch(b){}};h.e=function(){};var Lb="closure_listenable_"+(1E6*Math.random()|0);function Mb(a){try{return!(!a||!a[Lb])}catch(b){return!1}}var Nb=0;function Ob(a,b,c,d,e){this.K=a;this.ma=null;this.src=b;this.type=c;this.capture=!!d;this.ga=e;this.key=++Nb;this.U=this.ea=!1}function Pb(a){a.U=!0;a.K=null;a.ma=null;a.src=null;a.ga=null};function Qb(a){this.src=a;this.l={};this.da=0}Qb.prototype.add=function(a,b,c,d,e){var f=this.l[a];f||(f=this.l[a]=[],this.da++);var g=Rb(f,b,d,e);-1<g?(a=f[g],c||(a.ea=!1)):(a=new Ob(b,this.src,a,!!d,e),a.ea=c,f.push(a));return a};Qb.prototype.remove=function(a,b,c,d){if(!(a in this.l))return!1;var e=this.l[a];b=Rb(e,b,c,d);return-1<b?(Pb(e[b]),z.splice.call(e,b,1),0==e.length&&(delete this.l[a],this.da--),!0):!1};
-function Sb(a,b){var c=b.type;if(!(c in a.l))return!1;var d=a.l[c],e=va(d,b),f;(f=0<=e)&&z.splice.call(d,e,1);f&&(Pb(b),0==a.l[c].length&&(delete a.l[c],a.da--));return f}Qb.prototype.na=function(a){var b=0,c;for(c in this.l)if(!a||c==a){for(var d=this.l[c],e=0;e<d.length;e++)++b,Pb(d[e]);delete this.l[c];this.da--}return b};Qb.prototype.Y=function(a,b,c,d){a=this.l[a];var e=-1;a&&(e=Rb(a,b,c,d));return-1<e?a[e]:null};
-function Rb(a,b,c,d){for(var e=0;e<a.length;++e){var f=a[e];if(!f.U&&f.K==b&&f.capture==!!c&&f.ga==d)return e}return-1};var Tb="closure_lm_"+(1E6*Math.random()|0),Ub={},Vb=0;function R(a,b,c,d,e){if(r(b)){for(var f=0;f<b.length;f++)R(a,b[f],c,d,e);return null}c=Wb(c);if(Mb(a))a=a.o(b,c,d,e);else{if(!b)throw Error("Invalid event type");var f=!!d,g=Xb(a);g||(a[Tb]=g=new Qb(a));c=g.add(b,c,!1,d,e);c.ma||(d=Yb(),c.ma=d,d.src=a,d.K=c,a.addEventListener?a.addEventListener(b,d,f):a.attachEvent(b in Ub?Ub[b]:Ub[b]="on"+b,d),Vb++);a=c}return a}
-function Yb(){var a=Zb,b=Db?function(c){return a.call(b.src,b.K,c)}:function(c){c=a.call(b.src,b.K,c);if(!c)return c};return b}function $b(a,b,c,d,e){if(r(b))for(var f=0;f<b.length;f++)$b(a,b[f],c,d,e);else c=Wb(c),Mb(a)?a.s(b,c,d,e):a&&(a=Xb(a))&&(b=a.Y(b,c,!!d,e))&&ac(b)}
-function ac(a){if(da(a)||!a||a.U)return!1;var b=a.src;if(Mb(b))return Sb(b.C,a);var c=a.type,d=a.ma;b.removeEventListener?b.removeEventListener(c,d,a.capture):b.detachEvent&&b.detachEvent(c in Ub?Ub[c]:Ub[c]="on"+c,d);Vb--;(c=Xb(b))?(Sb(c,a),0==c.da&&(c.src=null,b[Tb]=null)):Pb(a);return!0}function bc(a,b,c,d){var e=1;if(a=Xb(a))if(b=a.l[b])for(b=Ca(b),a=0;a<b.length;a++){var f=b[a];f&&f.capture==c&&!f.U&&(e&=!1!==cc(f,d))}return Boolean(e)}
-function cc(a,b){var c=a.K,d=a.ga||a.src;a.ea&&ac(a);return c.call(d,b)}
-function Zb(a,b){if(a.U)return!0;if(!Db){var c;if(!(c=b))a:{c=["window","event"];for(var d=m,e;e=c.shift();)if(null!=d[e])d=d[e];else{c=null;break a}c=d}e=c;c=new Q(e,this);d=!0;if(!(0>e.keyCode||void 0!=e.returnValue)){a:{var f=!1;if(0==e.keyCode)try{e.keyCode=-1;break a}catch(g){f=!0}if(f||void 0==e.returnValue)e.returnValue=!0}e=[];for(f=c.currentTarget;f;f=f.parentNode)e.push(f);for(var f=a.type,k=e.length-1;!c.G&&0<=k;k--)c.currentTarget=e[k],d&=bc(e[k],f,!0,c);for(k=0;!c.G&&k<e.length;k++)c.currentTarget=
-e[k],d&=bc(e[k],f,!1,c)}return d}return cc(a,new Q(b,this))}function Xb(a){a=a[Tb];return a instanceof Qb?a:null}var dc="__closure_events_fn_"+(1E9*Math.random()>>>0);function Wb(a){return ea(a)?a:a[dc]||(a[dc]=function(b){return a.handleEvent(b)})};var ec=!!m.DOMTokenList,fc=ec?function(a){return a.classList}:function(a){a=a.className;return s(a)&&a.match(/\S+/g)||[]},S=ec?function(a,b){return a.classList.contains(b)}:function(a,b){var c=fc(a);return 0<=va(c,b)},gc=ec?function(a,b){a.classList.add(b)}:function(a,b){S(a,b)||(a.className+=0<a.className.length?" "+b:b)},hc=ec?function(a,b){A(b,function(b){gc(a,b)})}:function(a,b){var c={};A(fc(a),function(a){c[a]=!0});A(b,function(a){c[a]=!0});a.className="";for(var d in c)a.className+=0<a.className.length?
-" "+d:d},ic=ec?function(a,b){a.classList.remove(b)}:function(a,b){S(a,b)&&(a.className=xa(fc(a),function(a){return a!=b}).join(" "))},jc=ec?function(a,b){A(b,function(b){ic(a,b)})}:function(a,b){a.className=xa(fc(a),function(a){return!(0<=va(b,a))}).join(" ")};function T(a,b,c,d){this.top=a;this.right=b;this.bottom=c;this.left=d}T.prototype.X=function(){return new T(this.top,this.right,this.bottom,this.left)};T.prototype.contains=function(a){return this&&a?a instanceof T?a.left>=this.left&&a.right<=this.right&&a.top>=this.top&&a.bottom<=this.bottom:a.x>=this.left&&a.x<=this.right&&a.y>=this.top&&a.y<=this.bottom:!1};
-T.prototype.round=function(){this.top=Math.round(this.top);this.right=Math.round(this.right);this.bottom=Math.round(this.bottom);this.left=Math.round(this.left);return this};function kc(a,b,c,d){this.left=a;this.top=b;this.width=c;this.height=d}kc.prototype.X=function(){return new kc(this.left,this.top,this.width,this.height)};kc.prototype.contains=function(a){return a instanceof kc?this.left<=a.left&&this.left+this.width>=a.left+a.width&&this.top<=a.top&&this.top+this.height>=a.top+a.height:a.x>=this.left&&a.x<=this.left+this.width&&a.y>=this.top&&a.y<=this.top+this.height};
-kc.prototype.round=function(){this.left=Math.round(this.left);this.top=Math.round(this.top);this.width=Math.round(this.width);this.height=Math.round(this.height);return this};function U(a,b){var c=K(a);return c.defaultView&&c.defaultView.getComputedStyle&&(c=c.defaultView.getComputedStyle(a,null))?c[b]||c.getPropertyValue(b)||"":""}function V(a,b){return U(a,b)||(a.currentStyle?a.currentStyle[b]:null)||a.style&&a.style[b]}
-function lc(a){var b;try{b=a.getBoundingClientRect()}catch(c){return{left:0,top:0,right:0,bottom:0}}D&&a.ownerDocument.body&&(a=a.ownerDocument,b.left-=a.documentElement.clientLeft+a.body.clientLeft,b.top-=a.documentElement.clientTop+a.body.clientTop);return b}
-function mc(a){if(D&&!(D&&8<=H))return a.offsetParent;var b=K(a),c=V(a,"position"),d="fixed"==c||"absolute"==c;for(a=a.parentNode;a&&a!=b;a=a.parentNode)if(c=V(a,"position"),d=d&&"static"==c&&a!=b.documentElement&&a!=b.body,!d&&(a.scrollWidth>a.clientWidth||a.scrollHeight>a.clientHeight||"fixed"==c||"absolute"==c||"relative"==c))return a;return null}
-function nc(a){for(var b=new T(0,Infinity,Infinity,0),c=J(a),d=c.j.body,e=c.j.documentElement,f=jb(c.j);a=mc(a);)if(!(D&&0==a.clientWidth||F&&0==a.clientHeight&&a==d||a==d||a==e||"visible"==V(a,"overflow"))){var g=W(a),k;k=a;if(E&&!G("1.9")){var l=parseFloat(U(k,"borderLeftWidth"));if(oc(k))var n=k.offsetWidth-k.clientWidth-l-parseFloat(U(k,"borderRightWidth")),l=l+n;k=new I(l,parseFloat(U(k,"borderTopWidth")))}else k=new I(k.clientLeft,k.clientTop);g.x+=k.x;g.y+=k.y;b.top=Math.max(b.top,g.y);b.right=
-Math.min(b.right,g.x+a.clientWidth);b.bottom=Math.min(b.bottom,g.y+a.clientHeight);b.left=Math.max(b.left,g.x)}d=f.scrollLeft;f=f.scrollTop;b.left=Math.max(b.left,d);b.top=Math.max(b.top,f);c=(c.j.parentWindow||c.j.defaultView||window).document;c="CSS1Compat"==c.compatMode?c.documentElement:c.body;c=new ab(c.clientWidth,c.clientHeight);b.right=Math.min(b.right,d+c.width);b.bottom=Math.min(b.bottom,f+c.height);return 0<=b.top&&0<=b.left&&b.bottom>b.top&&b.right>b.left?b:null}
-function W(a){var b,c=K(a),d=V(a,"position"),e=E&&c.getBoxObjectFor&&!a.getBoundingClientRect&&"absolute"==d&&(b=c.getBoxObjectFor(a))&&(0>b.screenX||0>b.screenY),f=new I(0,0),g;b=c?K(c):document;g=!D||D&&9<=H||pb(J(b))?b.documentElement:b.body;if(a==g)return f;if(a.getBoundingClientRect)b=lc(a),a=qb(J(c)),f.x=b.left+a.x,f.y=b.top+a.y;else if(c.getBoxObjectFor&&!e)b=c.getBoxObjectFor(a),a=c.getBoxObjectFor(g),f.x=b.screenX-a.screenX,f.y=b.screenY-a.screenY;else{b=a;do{f.x+=b.offsetLeft;f.y+=b.offsetTop;
-b!=a&&(f.x+=b.clientLeft||0,f.y+=b.clientTop||0);if(F&&"fixed"==V(b,"position")){f.x+=c.body.scrollLeft;f.y+=c.body.scrollTop;break}b=b.offsetParent}while(b&&b!=a);if(C||F&&"absolute"==d)f.y-=c.body.offsetTop;for(b=a;(b=mc(b))&&b!=c.body&&b!=g;)f.x-=b.scrollLeft,C&&"TR"==b.tagName||(f.y-=b.scrollTop)}return f}function pc(a,b){"number"==typeof a&&(a=(b?Math.round(a):a)+"px");return a}
-function qc(a){var b=rc;if("none"!=V(a,"display"))return b(a);var c=a.style,d=c.display,e=c.visibility,f=c.position;c.visibility="hidden";c.position="absolute";c.display="inline";a=b(a);c.display=d;c.position=f;c.visibility=e;return a}function rc(a){var b=a.offsetWidth,c=a.offsetHeight,d=F&&!b&&!c;return(void 0===b||d)&&a.getBoundingClientRect?(a=lc(a),new ab(a.right-a.left,a.bottom-a.top)):new ab(b,c)}function sc(a,b){a.style.display=b?"":"none"}function oc(a){return"rtl"==V(a,"direction")}
-var tc=E?"MozUserSelect":F?"WebkitUserSelect":null;function uc(a){var b=a.getElementsByTagName("*");if(tc){var c="none";a.style[tc]=c;if(b){a=0;for(var d;d=b[a];a++)d.style[tc]=c}}else if(D||C)if(c="on",a.setAttribute("unselectable",c),b)for(a=0;d=b[a];a++)d.setAttribute("unselectable",c)}
-function vc(a,b){if(/^\d+px?$/.test(b))return parseInt(b,10);var c=a.style.left,d=a.runtimeStyle.left;a.runtimeStyle.left=a.currentStyle.left;a.style.left=b;var e=a.style.pixelLeft;a.style.left=c;a.runtimeStyle.left=d;return e}function wc(a,b){var c=a.currentStyle?a.currentStyle[b]:null;return c?vc(a,c):0}var xc={thin:2,medium:4,thick:6};
-function yc(a,b){if("none"==(a.currentStyle?a.currentStyle[b+"Style"]:null))return 0;var c=a.currentStyle?a.currentStyle[b+"Width"]:null;return c in xc?xc[c]:vc(a,c)}function zc(a){if(D&&!(D&&9<=H)){var b=yc(a,"borderLeft"),c=yc(a,"borderRight"),d=yc(a,"borderTop");a=yc(a,"borderBottom");return new T(d,c,a,b)}b=U(a,"borderLeftWidth");c=U(a,"borderRightWidth");d=U(a,"borderTopWidth");a=U(a,"borderBottomWidth");return new T(parseFloat(d),parseFloat(c),parseFloat(a),parseFloat(b))}
-var Ac=/[^\d]+$/,Bc={cm:1,"in":1,mm:1,pc:1,pt:1},Cc={em:1,ex:1};function Dc(){var a=document.documentElement,b=V(a,"fontSize"),c;c=(c=b.match(Ac))&&c[0]||null;if(b&&"px"==c)return parseInt(b,10);if(D){if(c in Bc)return vc(a,b);if(a.parentNode&&1==a.parentNode.nodeType&&c in Cc)return a=a.parentNode,c=V(a,"fontSize"),vc(a,b==c?"1em":b)}c=kb("span",{style:"visibility:hidden;position:absolute;line-height:0;padding:0;margin:0;border:0;height:1em;"});a.appendChild(c);b=c.offsetHeight;ob(c);return b}
-var Ec=/matrix\([0-9\.\-]+, [0-9\.\-]+, [0-9\.\-]+, [0-9\.\-]+, ([0-9\.\-]+)p?x?, ([0-9\.\-]+)p?x?\)/;function Fc(a){this.c=a||[];this.Ub=!0}function Gc(a,b,c){var d=[];if(""!=a){a=ua(a);a=RegExp("(^|\\W+)"+a,"i");for(var e=0;e<c.length&&d.length<b;e++){var f=c[e];String(f).match(a)&&d.push(f)}}return d}
-function Hc(a,b,c){for(var d=[],e=0;e<c.length;e++){var f=c[e],g=a.toLowerCase(),k=String(f).toLowerCase(),l=0;if(-1!=k.indexOf(g))l=parseInt((k.indexOf(g)/4).toString(),10);else for(var n=g.split(""),p=-1,q=10,y=0,u;u=n[y];y++)u=k.indexOf(u),u>p?(p=u-p-1,p>q-5&&(p=q-5),l+=p,p=u):(l+=q,q+=5);l<6*g.length&&d.push({Rb:f,ob:l,index:e})}d.sort(function(a,b){var c=a.ob-b.ob;return 0!=c?c:a.index-b.index});a=[];for(y=0;y<b&&y<d.length;y++)a.push(d[y].Rb);return a};function X(){O.call(this);this.C=new Qb(this);this.ub=this}x(X,O);X.prototype[Lb]=!0;h=X.prototype;h.Fa=null;h.addEventListener=function(a,b,c,d){R(this,a,b,c,d)};h.removeEventListener=function(a,b,c,d){$b(this,a,b,c,d)};
-h.dispatchEvent=function(a){var b,c=this.Fa;if(c)for(b=[];c;c=c.Fa)b.push(c);var c=this.ub,d=a.type||a;if(s(a))a=new P(a,c);else if(a instanceof P)a.target=a.target||c;else{var e=a;a=new P(d,c);fb(a,e)}var e=!0,f;if(b)for(var g=b.length-1;!a.G&&0<=g;g--)f=a.currentTarget=b[g],e=Ic(f,d,!0,a)&&e;a.G||(f=a.currentTarget=c,e=Ic(f,d,!0,a)&&e,a.G||(e=Ic(f,d,!1,a)&&e));if(b)for(g=0;!a.G&&g<b.length;g++)f=a.currentTarget=b[g],e=Ic(f,d,!1,a)&&e;return e};
-h.e=function(){X.i.e.call(this);this.C&&this.C.na(void 0);this.Fa=null};h.o=function(a,b,c,d){return this.C.add(String(a),b,!1,c,d)};h.s=function(a,b,c,d){return this.C.remove(String(a),b,c,d)};function Ic(a,b,c,d){b=a.C.l[String(b)];if(!b)return!0;b=Ca(b);for(var e=!0,f=0;f<b.length;++f){var g=b[f];if(g&&!g.U&&g.capture==c){var k=g.K,l=g.ga||g.src;g.ea&&Sb(a.C,g);e=!1!==k.call(l,d)&&e}}return e&&!1!=d.nb}h.Y=function(a,b,c,d){return this.C.Y(String(a),b,c,d)};function Jc(a,b,c){X.call(this);this.R=a;this.aa=c;this.p=b;R(b,[Kc,Lc,Mc,Nc],this.handleEvent,!1,this);this.q=null;this.c=[];this.D=-1;this.k=0;this.J=this.g=null;this.Va={}}x(Jc,X);h=Jc.prototype;h.$a=10;h.wb=!0;h.Ma=!1;h.tb=!1;h.qb=!1;var Kc="hilite",Lc="select",Nc="dismiss",Mc="canceldismiss";h=Jc.prototype;
-h.handleEvent=function(a){if(a.target==this.p)switch(a.type){case Kc:this.A(a.V);break;case Lc:a=a.V;var b=this.c[Oc(this,a)],c=!!b&&this.R.za&&this.R.za(b);a&&b&&!c&&this.D!=a&&this.A(a);c||Pc(this);break;case Mc:Qc(this);break;case Nc:Rc(this)}};function Sc(a){for(var b=a.k+a.c.length-1,c=a.D,d=0;d<a.c.length;d++){if(c>=a.k&&c<b)c++;else if(-1==c)c=a.k;else if(a.Ma&&c==b){a.A(-1);break}else if(a.tb&&c==b)c=a.k;else break;if(a.A(c))break}}
-function Tc(a){for(var b=a.k+a.c.length-1,c=a.D,d=0;d<a.c.length;d++){if(c>a.k)c--;else if(a.Ma&&c==a.k){a.A(-1);break}else if(!a.tb||-1!=c&&c!=a.k)break;else c=b;if(a.A(c))break}}h.A=function(a){var b=Oc(this,a),c=this.c[b];return c&&this.R.za&&this.R.za(c)?!1:(this.D=a,this.p.A(a),-1!=b)};
-function Pc(a){var b=Oc(a,a.D);if(-1!=b){var b=a.c[b],c=a.aa,d=b.toString();if(c.S){var e=Uc(c,c.a.value,Vc(c.a)),f=Wc(c,c.a.value);c.Ob.test(d)||(d=d.replace(/[\s\xa0]+$/,"")+c.yb);c.Wb&&(0==e||/^[\s\xa0]*$/.test(f[e-1])||(d=" "+d),e==f.length-1&&(d+=" "));if(d!=f[e]){f[e]=d;d=c.a;(E||D&&G("9"))&&d.blur();d.value=f.join("");for(var g=0,k=0;k<=e;k++)g+=f[k].length;d.focus();e=g;f=c.a;d=e;Xc(f)?f.selectionStart=d:D&&(g=Yc(f),k=g[0],k.inRange(g[1])&&(d=Zc(f,d),k.collapse(!0),k.move("character",d),k.select()));
-f=c.a;Xc(f)?f.selectionEnd=e:D&&(g=Yc(f),d=g[1],g[0].inRange(d)&&(e=Zc(f,e),f=Zc(f,Vc(f)),d.collapse(!0),d.moveEnd("character",e-f),d.select()))}}else c.a.value=d;c.Ja=!0;a.qb?(a.q=null,Rc(a)):a.u();a.dispatchEvent({type:"update",V:b});a.qb&&a.aa.update(!0);return!0}a.u();a.dispatchEvent({type:"update",V:null});return!1}h.u=function(){this.D=-1;this.q=null;this.k+=this.c.length;this.c=[];window.clearTimeout(this.J);this.J=null;this.p.u();this.dispatchEvent("suggestionsupdate");this.dispatchEvent(Nc)};
-function Rc(a){a.J||(a.J=window.setTimeout(t(a.u,a),100))}h.Ua=function(){return this.J?(window.clearTimeout(this.J),this.J=null,!0):!1};function Qc(a){a.Ua()||window.setTimeout(t(a.Ua,a),10)}h.e=function(){Jc.i.e.call(this);delete this.Va;this.p.B();this.aa.B();this.R=null};h.Ib=function(a,b,c){this.q==a&&this.Ha(b,c)};
-h.Ha=function(a,b){var c="object"==ba(b)&&b,d=(c?c.Yb():b)?Oc(this,this.D):-1;this.k+=this.c.length;this.c=a;for(var e=[],f=0;f<a.length;++f)e.push({id:this.k+f,data:a[f]});f=null;this.g&&(f=this.Va[ga(this.g)]||this.g);this.p.vb=f;this.p.Ha(e,this.q,this.g);f=this.wb;c&&void 0!==c.Cb()&&(f=c.Cb());this.D=-1;(f||0<=d)&&0!=e.length&&this.q&&(0<=d?this.A(this.k+d):Sc(this));this.dispatchEvent("suggestionsupdate")};function Oc(a,b){var c=b-a.k;return 0>c||c>=a.c.length?-1:c}
-h.ta=function(a){var b=this.aa;b.ta.apply(b,arguments)};h.update=function(a){this.aa.update(a)};function $c(a,b){X.call(this);this.Q=a||1;this.W=b||m;this.ua=t(this.Sb,this);this.Ca=w()}x($c,X);h=$c.prototype;h.enabled=!1;h.f=null;h.Sb=function(){if(this.enabled){var a=w()-this.Ca;0<a&&a<0.8*this.Q?this.f=this.W.setTimeout(this.ua,this.Q-a):(this.f&&(this.W.clearTimeout(this.f),this.f=null),this.dispatchEvent(ad),this.enabled&&(this.f=this.W.setTimeout(this.ua,this.Q),this.Ca=w()))}};h.start=function(){this.enabled=!0;this.f||(this.f=this.W.setTimeout(this.ua,this.Q),this.Ca=w())};
-h.stop=function(){this.enabled=!1;this.f&&(this.W.clearTimeout(this.f),this.f=null)};h.e=function(){$c.i.e.call(this);this.stop();delete this.W};var ad="tick";var bd;function cd(a,b){b?a.setAttribute("role",b):a.removeAttribute("role")}function dd(a,b,c){ca(c)&&(c=c.join(" "));var d="aria-"+b;""===c||void 0==c?(bd||(bd={atomic:!1,autocomplete:"none",dropeffect:"none",haspopup:!1,live:"off",multiline:!1,multiselectable:!1,orientation:"vertical",readonly:!1,relevant:"additions text",required:!1,sort:"none",busy:!1,disabled:!1,hidden:!1,invalid:"false"}),c=bd,b in c?a.setAttribute(d,c[b]):a.removeAttribute(d)):a.setAttribute(d,c)}
-function ed(a,b){var c="";b&&(c=b.id);dd(a,"activedescendant",c)};function Vc(a){var b;a:{var c=0,d=0;if(Xc(a))c=a.selectionStart,d=-1;else if(D){var e=Yc(a);b=e[0];e=e[1];if(b.inRange(e)){b.setEndPoint("EndToStart",e);if("textarea"==a.type){e.duplicate();c=a=b.text;for(d=!1;!d;)0==b.compareEndPoints("StartToEnd",b)?d=!0:(b.moveEnd("character",-1),b.text==a?c+="\r\n":d=!0);b=[c.length,-1];break a}c=b.text.length;d=-1}}b=[c,d]}return b[0]}
-function Yc(a){var b=a.ownerDocument||a.document,c=b.selection.createRange();"textarea"==a.type?(b=b.body.createTextRange(),b.moveToElementText(a)):b=a.createTextRange();return[b,c]}function Zc(a,b){"textarea"==a.type&&(b=a.value.substring(0,b).replace(/(\r\n|\r|\n)/g,"\n").length);return b}function Xc(a){try{return"number"==typeof a.selectionStart}catch(b){return!1}};function fd(a){O.call(this);this.Z=a;this.ka={}}x(fd,O);var gd=[];h=fd.prototype;h.o=function(a,b,c,d,e){r(b)||(gd[0]=b,b=gd);for(var f=0;f<b.length;f++){var g=R(a,b[f],c||this.handleEvent,d||!1,e||this.Z||this);if(!g)break;this.ka[g.key]=g}return this};h.s=function(a,b,c,d,e){if(r(b))for(var f=0;f<b.length;f++)this.s(a,b[f],c,d,e);else c=c||this.handleEvent,e=e||this.Z||this,c=Wb(c),d=!!d,b=Mb(a)?a.Y(b,c,d,e):a?(a=Xb(a))?a.Y(b,c,d,e):null:null,b&&(ac(b),delete this.ka[b.key]);return this};
-h.na=function(){bb(this.ka,ac);this.ka={}};h.e=function(){fd.i.e.call(this);this.na()};h.handleEvent=function(){throw Error("EventHandler.handleEvent not implemented");};function hd(a,b,c,d,e){if(!(D||F&&G("525")))return!0;if(B&&e)return id(a);if(e&&!d)return!1;da(b)&&(b=jd(b));if(!c&&(17==b||18==b||B&&91==b))return!1;if(F&&d&&c)switch(a){case 220:case 219:case 221:case 192:case 186:case 189:case 187:case 188:case 190:case 191:case 192:case 222:return!1}if(D&&d&&b==a)return!1;switch(a){case 13:return!(D&&D&&9<=H);case 27:return!F}return id(a)}
-function id(a){if(48<=a&&57>=a||96<=a&&106>=a||65<=a&&90>=a||F&&0==a)return!0;switch(a){case 32:case 63:case 107:case 109:case 110:case 111:case 186:case 59:case 189:case 187:case 61:case 188:case 190:case 191:case 192:case 222:case 219:case 220:case 221:return!0;default:return!1}}function jd(a){if(E)a=kd(a);else if(B&&F)a:switch(a){case 93:a=91;break a}return a}
-function kd(a){switch(a){case 61:return 187;case 59:return 186;case 173:return 189;case 224:return 91;case 0:return 224;default:return a}};function ld(a,b){X.call(this);a&&md(this,a,b)}x(ld,X);h=ld.prototype;h.b=null;h.ia=null;h.Aa=null;h.ja=null;h.m=-1;h.F=-1;h.sa=!1;
-var nd={3:13,12:144,63232:38,63233:40,63234:37,63235:39,63236:112,63237:113,63238:114,63239:115,63240:116,63241:117,63242:118,63243:119,63244:120,63245:121,63246:122,63247:123,63248:44,63272:46,63273:36,63275:35,63276:33,63277:34,63289:144,63302:45},od={Up:38,Down:40,Left:37,Right:39,Enter:13,F1:112,F2:113,F3:114,F4:115,F5:116,F6:117,F7:118,F8:119,F9:120,F10:121,F11:122,F12:123,"U+007F":46,Home:36,End:35,PageUp:33,PageDown:34,Insert:45},pd=D||F&&G("525"),qd=B&&E;h=ld.prototype;
-h.Eb=function(a){F&&(17==this.m&&!a.ctrlKey||18==this.m&&!a.altKey||B&&91==this.m&&!a.metaKey)&&(this.F=this.m=-1);-1==this.m&&(a.ctrlKey&&17!=a.keyCode?this.m=17:a.altKey&&18!=a.keyCode?this.m=18:a.metaKey&&91!=a.keyCode&&(this.m=91));pd&&!hd(a.keyCode,this.m,a.shiftKey,a.ctrlKey,a.altKey)?this.handleEvent(a):(this.F=jd(a.keyCode),qd&&(this.sa=a.altKey))};h.Gb=function(a){this.F=this.m=-1;this.sa=a.altKey};
-h.handleEvent=function(a){var b=a.O,c,d,e=b.altKey;D&&"keypress"==a.type?(c=this.F,d=13!=c&&27!=c?b.keyCode:0):F&&"keypress"==a.type?(c=this.F,d=0<=b.charCode&&63232>b.charCode&&id(c)?b.charCode:0):C?(c=this.F,d=id(c)?b.keyCode:0):(c=b.keyCode||this.F,d=b.charCode||0,qd&&(e=this.sa),B&&63==d&&224==c&&(c=191));var f=c=jd(c),g=b.keyIdentifier;c?63232<=c&&c in nd?f=nd[c]:25==c&&a.shiftKey&&(f=9):g&&g in od&&(f=od[g]);a=f==this.m;this.m=f;b=new rd(f,d,a,b);b.altKey=e;this.dispatchEvent(b)};
-function md(a,b,c){a.ja&&a.detach();a.b=b;a.ia=R(a.b,"keypress",a,c);a.Aa=R(a.b,"keydown",a.Eb,c,a);a.ja=R(a.b,"keyup",a.Gb,c,a)}h.detach=function(){this.ia&&(ac(this.ia),ac(this.Aa),ac(this.ja),this.ja=this.Aa=this.ia=null);this.b=null;this.F=this.m=-1};h.e=function(){ld.i.e.call(this);this.detach()};function rd(a,b,c,d){d&&Kb(this,d,void 0);this.type="key";this.keyCode=a;this.charCode=b;this.repeat=c}x(rd,Q);var sd,td;td=sd=!1;var ud=Ia();ud&&(-1!=ud.indexOf("Firefox")||-1!=ud.indexOf("Camino")||(-1!=ud.indexOf("iPhone")||-1!=ud.indexOf("iPod")?sd=!0:-1!=ud.indexOf("iPad")&&(td=!0)));var vd=sd,wd=td;function xd(a,b,c,d){O.call(this);d=d||150;this.S=null!=c?c:!0;this.ba=a||",;";this.yb=this.ba.substring(0,1);a=this.S?"[\\s"+this.ba+"]+":"[\\s]+";this.rb=RegExp("^"+a+"|"+a+"$","g");this.Ob=RegExp("\\s*["+this.ba+"]$");this.Za=b||"";this.Lb=this.S;this.f=0<d?new $c(d):null;this.h=new fd(this);this.qa=new fd(this);this.$=new ld;this.Xa=-1}x(xd,O);var yd=(vd||wd)&&!G("533.17.9");h=xd.prototype;h.Wb=!0;h.Bb=!0;h.sb=!1;h.Qb=!0;h.Pb=!0;h.ra=null;h.a=null;h.Ba="";h.H=!1;h.Ja=!1;h.Tb=!0;
-h.ta=function(a){for(var b=0;b<arguments.length;b++){var c=arguments[b];fa(c)&&1==c.nodeType&&dd(c,"haspopup",!0);this.h.o(c,"focus",this.Ra);this.h.o(c,"blur",this.Db);if(!this.a&&(this.qa.o(c,"keydown",this.Kb),fa(c)&&1==c.nodeType)){var d;a:{var e=K(c);try{d=e&&e.activeElement;break a}catch(f){}d=null}d==c&&zd(this,c)}}};h.e=function(){xd.i.e.call(this);null!=this.ra&&window.clearTimeout(this.ra);this.h.B();delete this.h;this.qa.B();this.$.B();Hb(this.f)};
-function Ad(a,b){switch(b.keyCode){case 40:if(a.d.p.t){a.sb?Tc(a.d):Sc(a.d);b.preventDefault();return}if(!a.S){a.update(!0);b.preventDefault();return}break;case 38:if(a.d.p.t){a.sb?Sc(a.d):Tc(a.d);b.preventDefault();return}break;case 9:if(a.d.p.t&&!b.shiftKey){if(a.update(),Pc(a.d)&&a.Lb){b.preventDefault();return}}else a.d.u();break;case 13:if(a.d.p.t){if(a.update(),Pc(a.d)){b.preventDefault();b.stopPropagation();return}}else a.d.u();break;case 27:if(a.d.p.t){a.d.u();b.preventDefault();b.stopPropagation();
-return}break;case 229:if(!a.H){a.H||(a.h.o(a.a,"keyup",a.fb),a.h.o(a.a,"keypress",a.eb),a.H=!0);return}break;default:a.f&&!a.Tb&&(a.f.stop(),a.f.start())}Bd(a,b)}function Bd(a,b){var c=a.S&&b.charCode&&-1!=a.ba.indexOf(String.fromCharCode(b.charCode));a.Qb&&c&&a.update();a.Pb&&c&&Pc(a.d)&&b.preventDefault()}h.Fb=function(){return!1};h.Ra=function(a){zd(this,a.target||null)};
-function zd(a,b){a.qa.na();a.d&&Qc(a.d);b!=a.a&&(a.a=b,a.f&&(a.f.start(),a.h.o(a.f,ad,a.ib)),a.Ba=a.a.value,md(a.$,a.a),a.h.o(a.$,"key",a.gb),a.h.o(a.a,"mousedown",a.hb),D&&a.h.o(a.a,"keypress",a.cb))}h.Db=function(){yd?this.ra=window.setTimeout(t(this.kb,this),0):this.kb()};
-h.kb=function(){this.a&&(this.h.s(this.$,"key",this.gb),this.$.detach(),this.h.s(this.a,"keyup",this.Fb),this.h.s(this.a,"mousedown",this.hb),D&&this.h.s(this.a,"keypress",this.cb),this.H&&Cd(this),this.a=null,this.f&&(this.f.stop(),this.h.s(this.f,ad,this.ib)),this.d&&Rc(this.d))};h.ib=function(){this.update()};h.Kb=function(a){this.Ra(a)};h.gb=function(a){this.Xa=a.keyCode;this.d&&Ad(this,a)};h.eb=function(){this.H&&229!=this.Xa&&Cd(this)};
-h.fb=function(a){this.H&&(13==a.keyCode||77==a.keyCode&&a.ctrlKey)&&Cd(this)};h.hb=function(){};function Cd(a){a.H&&(a.H=!1,a.h.s(a.a,"keypress",a.eb),a.h.s(a.a,"keyup",a.fb))}h.cb=function(a){Bd(this,a)};
-h.update=function(a){if(this.a&&(a||this.a.value!=this.Ba)){if(a||!this.Ja){var b;a=Vc(this.a);b=this.a.value;a=Wc(this,b)[Uc(this,b,a)];b=this.rb?String(a).replace(this.rb,""):a;if(this.d&&(this.d.g=this.a,a=this.d,a.q!=b)){a.q=b;var c=a.R;b=a.q;var d=a.$a,e=t(a.Ib,a);if(c.Ub){var c=c.c,f=Gc(b,d,c);0==f.length&&(f=Hc(b,d,c));d=f}else d=Gc(b,d,c.c);e(b,d);Qc(a)}}this.Ba=this.a.value}this.Ja=!1};
-function Uc(a,b,c){a=Wc(a,b);if(c==b.length)return a.length-1;for(var d=b=0,e=0;d<a.length&&e<=c;d++)e+=a[d].length,b=d;return b}function Wc(a,b){if(!a.S)return[b];for(var c=String(b).split(""),d=[],e=[],f=0,g=!1;f<c.length;f++)a.Za&&-1!=a.Za.indexOf(c[f])?(a.Bb&&!g&&(d.push(e.join("")),e.length=0),e.push(c[f]),g=!g):g||-1==a.ba.indexOf(c[f])?e.push(c[f]):(e.push(c[f]),d.push(e.join("")),e.length=0);d.push(e.join(""));return d};function Dd(){X.call(this);this.r=Ed;this.Pa=this.startTime=null}x(Dd,X);var Ed=0;Dd.prototype.L=function(){this.v("begin")};Dd.prototype.T=function(){this.v("end")};Dd.prototype.v=function(a){this.dispatchEvent(a)};function Fd(a,b,c){O.call(this);this.Da=a;this.Q=b||0;this.Z=c;this.xb=t(this.zb,this)}x(Fd,O);h=Fd.prototype;h.P=0;h.e=function(){Fd.i.e.call(this);this.stop();delete this.Da;delete this.Z};h.start=function(a){this.stop();var b=this.xb;a=void 0!==a?a:this.Q;if(!ea(b))if(b&&"function"==typeof b.handleEvent)b=t(b.handleEvent,b);else throw Error("Invalid listener argument");this.P=2147483647<a?-1:m.setTimeout(b,a||0)};h.stop=function(){0!=this.P&&m.clearTimeout(this.P);this.P=0};
-h.zb=function(){this.P=0;this.Da&&this.Da.call(this.Z)};var db={},Gd=null;function Hd(a){a=ga(a);delete db[a];cb()&&Gd&&Gd.stop()}function Id(){Gd||(Gd=new Fd(function(){Jd()},20));var a=Gd;0!=a.P||a.start()}function Jd(){var a=w();bb(db,function(b){Kd(b,a)});cb()||Id()};function Ld(a,b,c,d){Dd.call(this);if(!r(a)||!r(b))throw Error("Start and end parameters must be arrays");if(a.length!=b.length)throw Error("Start and end points must be the same length");this.ca=a;this.Ab=b;this.duration=c;this.Ka=d;this.coords=[]}x(Ld,Dd);h=Ld.prototype;h.n=0;
-h.play=function(a){if(a||this.r==Ed)this.n=0,this.coords=this.ca;else if(1==this.r)return!1;Hd(this);this.startTime=a=w();-1==this.r&&(this.startTime-=this.duration*this.n);this.Pa=this.startTime+this.duration;this.n||this.L();this.v("play");-1==this.r&&this.v("resume");this.r=1;var b=ga(this);b in db||(db[b]=this);Id();Kd(this,a);return!0};h.stop=function(a){Hd(this);this.r=Ed;a&&(this.n=1);Md(this,this.n);this.v("stop");this.T()};h.e=function(){this.r==Ed||this.stop(!1);this.v("destroy");Ld.i.e.call(this)};
-function Kd(a,b){a.n=(b-a.startTime)/(a.Pa-a.startTime);1<=a.n&&(a.n=1);Md(a,a.n);1==a.n?(a.r=Ed,Hd(a),a.v("finish"),a.T()):1==a.r&&a.Ea()}function Md(a,b){ea(a.Ka)&&(b=a.Ka(b));a.coords=Array(a.ca.length);for(var c=0;c<a.ca.length;c++)a.coords[c]=(a.Ab[c]-a.ca[c])*b+a.ca[c]}h.Ea=function(){this.v("animate")};h.v=function(a){this.dispatchEvent(new Nd(a,this))};
-function Nd(a,b){P.call(this,a);this.coords=b.coords;this.x=b.coords[0];this.y=b.coords[1];this.z=b.coords[2];this.duration=b.duration;this.n=b.n;this.state=b.r}x(Nd,P);function Y(a,b,c,d,e){Ld.call(this,b,c,d,e);this.element=a}x(Y,Ld);Y.prototype.pa=aa;Y.prototype.Ea=function(){this.pa();Y.i.Ea.call(this)};Y.prototype.T=function(){this.pa();Y.i.T.call(this)};Y.prototype.L=function(){this.pa();Y.i.L.call(this)};function Od(a,b,c,d,e){da(b)&&(b=[b]);da(c)&&(c=[c]);Y.call(this,a,b,c,d,e);if(1!=b.length||1!=c.length)throw Error("Start and end points must be 1D");}x(Od,Y);
-Od.prototype.pa=function(){var a=this.coords[0],b=this.element.style;"opacity"in b?b.opacity=a:"MozOpacity"in b?b.MozOpacity=a:"filter"in b&&(b.filter=""===a?"":"alpha(opacity="+100*a+")")};Od.prototype.show=function(){this.element.style.display=""};function Pd(a,b,c){Od.call(this,a,1,0,b,c)}x(Pd,Od);Pd.prototype.L=function(){this.show();Pd.i.L.call(this)};Pd.prototype.T=function(){this.element.style.display="none";Pd.i.T.call(this)};function Qd(a,b,c){Od.call(this,a,0,1,b,c)}x(Qd,Od);
-Qd.prototype.L=function(){this.show();Qd.i.L.call(this)};function Z(){}Z.wa=function(){return Z.Wa?Z.Wa:Z.Wa=new Z};Z.prototype.ab=0;Z.wa();function Rd(a,b,c,d){X.call(this);this.Ga=a||document.body;this.w=J(this.Ga);this.Mb=!a;this.b=null;this.q="";this.c=[];this.M=[];this.pb=this.ha=-1;this.t=!1;this.className="ac-renderer";this.Ia="ac-row";this.Ya="active";this.La="ac-active";this.Hb="ac-highlighted";this.fa=b||null;this.Vb=null!=d?d:!0;this.Jb=!0;this.xa=!1;this.Nb=!!c;this.oa=!1;this.la=0}x(Rd,X);h=Rd.prototype;h.Ha=function(a,b,c){this.q=b;this.c=a;this.ha=-1;this.pb=w();this.g=c;this.M=[];Sd(this)};
-h.u=function(){this.g&&ed(this.g,null);this.t&&(this.t=!1,this.g&&dd(this.g,"haspopup",!1),0<this.la?(Hb(this.N),this.N=new Pd(this.b,this.la),this.N.play()):sc(this.b,!1))};h.show=function(){this.t||(this.t=!0,this.g&&(cd(this.g,"combobox"),dd(this.g,"autocomplete","list"),dd(this.g,"haspopup",!0)),0<this.la?(Hb(this.N),this.N=new Qd(this.b,this.la),this.N.play()):sc(this.b,!0))};
-function Td(a,b){var c=0<=b&&b<a.c.length?a.c[b]:void 0,d=0<=b&&b<a.M.length?a.M[b]:void 0;if(a.dispatchEvent({type:"rowhilite",cc:d,V:c?c.data:null})&&(0<=a.ha&&jc(a.M[a.ha],[a.La,a.Ya]),a.ha=b,d)){hc(d,[a.La,a.Ya]);a.g&&ed(a.g,d);var c=a.b,e=W(d),f=W(c),g=zc(c),k=e.x-f.x-g.left,e=e.y-f.y-g.top,f=c.clientHeight-d.offsetHeight,g=c.scrollLeft,l=c.scrollTop,g=g+Math.min(k,Math.max(k-(c.clientWidth-d.offsetWidth),0)),l=l+Math.min(e,Math.max(e-f,0)),d=new I(g,l);c.scrollLeft=d.x;c.scrollTop=d.y}}
-h.A=function(a){if(-1==a)Td(this,-1);else for(var b=0;b<this.c.length;b++)if(this.c[b].id==a){Td(this,b);break}};function Ud(a){if(!a.b){var b=a.w.Na("div",{style:"display:none"});a.b=b;hc(b,na(a.className).split(" "));cd(b,"listbox");b.id=":"+(Z.wa().ab++).toString(36);a.w.appendChild(a.Ga,b);R(b,"click",a.Qa,!1,a);R(b,"mousedown",a.Sa,!1,a);R(b,"mouseover",a.Ta,!1,a)}}
-function Sd(a){Ud(a);a.oa&&(a.b.style.visibility="hidden");a.Xb&&(a.b.style.minWidth=a.Xb.clientWidth+"px");a.M.length=0;rb(a.b);if(!a.fa||!a.fa.ac){var b=null;A(a.c,function(a){var d=this.q,e=this.w.Na("div",{className:this.Ia,id:":"+(Z.wa().ab++).toString(36)});cd(e,"option");this.fa&&this.fa.bc||(e.innerHTML=oa(a.data.toString()));d&&this.Vb&&Vd(this,e,d);gc(e,this.Ia);this.M.push(e);a=e;this.oa?this.b.insertBefore(a,b):this.w.appendChild(this.b,a);b=a},a)}0==a.c.length?a.u():(a.show(),Wd(a),uc(a.b))}
-function Wd(a){if(a.g&&a.Mb){var b,c=a.Nb?3:1;a.oa&&(c^=1);b=c;var d=a.vb||a.g,c=a.b,e=b^1,f,g;if(f=c.offsetParent){var k="HTML"==f.tagName||"BODY"==f.tagName;k&&"static"==V(f,"position")||(g=W(f),k||(k=(k=oc(f))&&E?-f.scrollLeft:!k||D&&G("8")||"visible"==V(f,"overflowX")?f.scrollLeft:f.scrollWidth-f.clientWidth-f.scrollLeft,g=$a(g,new I(k,f.scrollTop))))}f=g||new I;g=W(d);k=qc(d);g=new kc(g.x,g.y,k.width,k.height);if(k=nc(d)){var l=new kc(k.left,k.top,k.right-k.left,k.bottom-k.top),k=Math.max(g.left,
-l.left),n=Math.min(g.left+g.width,l.left+l.width);if(k<=n){var p=Math.max(g.top,l.top),l=Math.min(g.top+g.height,l.top+l.height);p<=l&&(g.left=k,g.top=p,g.width=n-k,g.height=l-p)}}k=J(d);p=J(c);if(k.j!=p.j){var n=k.j.body,p=p.j.parentWindow||p.j.defaultView,l=new I(0,0),q=K(n)?K(n).parentWindow||K(n).defaultView:window,y=n;do{var u;if(q==p)u=W(y);else{u=y;var L=void 0;if(u.getBoundingClientRect)L=lc(u),L=new I(L.left,L.top);else var L=qb(J(u)),v=W(u),L=new I(v.x-L.x,v.y-L.y);v=void 0;if(E&&!G(12)){v=
-void 0;v=void 0;D?v="-ms-transform":F?v="-webkit-transform":C?v="-o-transform":E&&(v="-moz-transform");var wa=void 0;v&&(wa=V(u,v));wa||(wa=V(u,"transform"));v=wa?(u=wa.match(Ec))?new I(parseFloat(u[1]),parseFloat(u[2])):new I(0,0):new I(0,0);v=new I(L.x+v.x,L.y+v.y)}else v=L;u=v}l.x+=u.x;l.y+=u.y}while(q&&q!=p&&(y=q.frameElement)&&(q=q.parent));n=$a(l,W(n));D&&!pb(k)&&(n=$a(n,qb(k)));g.left+=n.x;g.top+=n.y}b=(b&4&&oc(d)?b^2:b)&-5;b=new I(b&2?g.left+g.width:g.left,b&1?g.top+g.height:g.top);b=$a(b,
-f);if(d=nc(c))d.top-=f.y,d.right-=f.x,d.bottom-=f.y,d.left-=f.x;f=b.X();g=(e&4&&oc(c)?e^2:e)&-5;b=qc(c);e=b.X();0!=g&&(g&2&&(f.x-=e.width+0),g&1&&(f.y-=e.height+0));d?(g=f,k=65,n=0,65==(k&65)&&(g.x<d.left||g.x>=d.right)&&(k&=-2),132==(k&132)&&(g.y<d.top||g.y>=d.bottom)&&(k&=-5),g.x<d.left&&k&1&&(g.x=d.left,n|=1),g.x<d.left&&g.x+e.width>d.right&&k&16&&(e.width=Math.max(e.width-(g.x+e.width-d.right),0),n|=4),g.x+e.width>d.right&&k&1&&(g.x=Math.max(d.right-e.width,d.left),n|=1),k&2&&(n=n|(g.x<d.left?
-16:0)|(g.x+e.width>d.right?32:0)),g.y<d.top&&k&4&&(g.y=d.top,n|=2),g.y<=d.top&&g.y+e.height<d.bottom&&k&32&&(e.height=Math.max(e.height-(d.top-g.y),0),g.y=d.top,n|=8),g.y>=d.top&&g.y+e.height>d.bottom&&k&32&&(e.height=Math.max(e.height-(g.y+e.height-d.bottom),0),n|=8),g.y+e.height>d.bottom&&k&4&&(g.y=Math.max(d.bottom-e.height,d.top),n|=2),k&8&&(n=n|(g.y<d.top?64:0)|(g.y+e.height>d.bottom?128:0)),d=n):d=256;d&496||(g=f,f=E&&(B||Na)&&G("1.9"),g instanceof I?(d=g.x,g=g.y):(d=g,g=void 0),c.style.left=
-pc(d,f),c.style.top=pc(g,f),b==e||b&&e&&b.width==e.width&&b.height==e.height||(d=pb(J(K(c))),!D||d&&G("8")?(c=c.style,E?c.MozBoxSizing="border-box":F?c.WebkitBoxSizing="border-box":c.boxSizing="border-box",c.width=Math.max(e.width,0)+"px",c.height=Math.max(e.height,0)+"px"):(b=c.style,d?(D?(d=wc(c,"paddingLeft"),f=wc(c,"paddingRight"),g=wc(c,"paddingTop"),k=wc(c,"paddingBottom"),d=new T(g,f,k,d)):(d=U(c,"paddingLeft"),f=U(c,"paddingRight"),g=U(c,"paddingTop"),k=U(c,"paddingBottom"),d=new T(parseFloat(g),
-parseFloat(f),parseFloat(k),parseFloat(d))),c=zc(c),b.pixelWidth=e.width-c.left-d.left-d.right-c.right,b.pixelHeight=e.height-c.top-d.top-d.bottom-c.bottom):(b.pixelWidth=e.width,b.pixelHeight=e.height))));a.oa&&(a.b.style.visibility="visible")}}h.e=function(){this.b&&($b(this.b,"click",this.Qa,!1,this),$b(this.b,"mousedown",this.Sa,!1,this),$b(this.b,"mouseover",this.Ta,!1,this),this.w.removeNode(this.b),this.b=null,this.t=!1);Hb(this.N);this.Ga=null;Rd.i.e.call(this)};
-function Vd(a,b,c){if(3==b.nodeType){var d=null;r(c)&&1<c.length&&!a.xa&&(d=Da(c,1));c=Xd(a,c);if(0!=c.length){var e=b.nodeValue,f=a.Jb?RegExp("\\b(?:"+c+")","gi"):RegExp(c,"gi");c=[];for(var g=0,k=f.exec(e),l=0;k;)l++,c.push(e.substring(g,k.index)),c.push(e.substring(k.index,f.lastIndex)),g=f.lastIndex,k=f.exec(e);c.push(e.substring(g));if(1<c.length){d=a.xa?l:1;for(e=0;e<d;e++)f=2*e,b.nodeValue=c[f],g=a.w.createElement("b"),g.className=a.Hb,a.w.appendChild(g,a.w.createTextNode(c[f+1])),g=b.parentNode.insertBefore(g,
-b.nextSibling),b.parentNode.insertBefore(a.w.createTextNode(""),g.nextSibling),b=g.nextSibling;a=Da(c,2*d);b.nodeValue=a.join("")}else d&&Vd(a,b,d)}}else for(b=b.firstChild;b;)d=b.nextSibling,Vd(a,b,c),b=d}
-function Xd(a,b){var c="";if(!b)return c;r(b)&&(b=xa(b,function(a){return!/^[\s\xa0]*$/.test(null==a?"":String(a))}));a.xa?r(b)?c=ya(b,ua).join("|"):(c=b.replace(/[\s\xa0]+/g," ").replace(/^\s+|\s+$/g,""),c=ua(c),c=c.replace(/ /g,"|")):r(b)?c=0<b.length?ua(b[0]):"":/^\W/.test(b)||(c=ua(b));return c}function Yd(a,b){for(;b&&b!=a.b&&!S(b,a.Ia);)b=b.parentNode;return b?va(a.M,b):-1}h.Qa=function(a){var b=Yd(this,a.target);0<=b&&this.dispatchEvent({type:Lc,V:this.c[b].id});a.stopPropagation()};
-h.Sa=function(a){a.stopPropagation();a.preventDefault()};h.Ta=function(a){a=Yd(this,a.target);0<=a&&!(300>w()-this.pb)&&this.dispatchEvent({type:Kc,V:this.c[a].id})};function Zd(a,b){var c=new Fc(a),d=new Rd,e=new xd(null,null,!1),c=new Jc(c,d,e);e.d=c;e.ta(b);return c};/*
- Copyright 2013 Jason Leyba
-
-  Licensed under the Apache License, Version 2.0 (the "License");
-  you may not use this file except in compliance with the License.
-  You may obtain a copy of the License at
-
-  http://www.apache.org/licenses/LICENSE-2.0
-
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License.
-*/
-function $d(){var a=m.TYPES;ae(a);M("type-index")&&M("file-index")&&M("module-index")&&(be("file-index",a.files),ce("type-index",a.types),ce("module-index",a.modules,!0));de();setTimeout(la(ee,a),0);setTimeout(fe,0)}var ge=["init"],$=m;ge[0]in $||!$.execScript||$.execScript("var "+ge[0]);for(var he;ge.length&&(he=ge.shift());)ge.length||void 0===$d?$=$[he]?$[he]:$[he]={}:$[he]=$d;
-var ie=function(){var a="./";za(document.getElementsByTagName("script"),function(b){b=b.src;var c=b.length;return"dossier.js"===b.substr(c-10)?(a=b.substr(0,c-10),!0):!1});return a}();
-function ee(a){function b(){var a=c[e.value];a&&(window.location.href=ie+a)}var c={},d=Aa(ya(a.files,function(a){var b="file://"+a.name;c[b]=a.href;return b}),ya(a.types,function(a){c[a.name]=a.href;return a.name}));A(a.modules,function(a){c[a.name]=a.href;d=Aa(d,a.name,ya(a.types||[],function(b){var d=a.name+"."+b.name;c[d]=b.href;return d}))});a=M("searchbox");R(a,"submit",function(a){a.preventDefault();a.stopPropagation();b();return!1});var e=a.getElementsByTagName("input")[0];a=Zd(d,e);a.$a=15;
-R(a,"update",b)}
-function ae(a){function b(a,b,c,d){R(a,Ib,function(){b.style.height=pc(a.checked?c:0,!0);je(d,a)})}if(M("sidenav")){M("sidenav-overview").href=ie+"index.html";var c=M("sidenav-types-ctrl"),d=ce("sidenav-types",a.types),e=M("sidenav-modules-ctrl"),f=ce("sidenav-modules",a.modules),g=M("sidenav-files-ctrl");a=be("sidenav-files",a.files);var k=Dc(),l=qc(d).height/k+"rem",n=qc(a).height/k+"rem",k=qc(f).height/k+"rem";c.checked=ke("dossier.typesList");g.checked=ke("dossier.filesList");e.checked=ke("dossier.modulesList");
-d.style.height=pc(c.checked?l:0,!0);a.style.height=pc(g.checked?n:0,!0);f.style.height=pc(e.checked?k:0,!0);b(c,d,l,"dossier.typesList");b(g,a,n,"dossier.filesList");b(e,f,k,"dossier.modulesList")}}function le(a,b){this.name=a;this.href=b||"";this.children=[]}
-function me(a){function b(a){A(a.children,b);!a.href&&1===a.children.length&&a.children[0].children.length&&(a.name=(a.name?a.name+"/":"")+a.children[0].name,a.href=a.children[0].href,a.children=a.children[0].children)}var c=new le("");A(a,function(a){var b=a.name.split(/[\/\\]/),f=c;A(b,function(c,k){if(c)if(k===b.length-1)f.children.push(new le(c,a.href));else{var l=za(f.children,function(a){return a.name===c});l||(l=new le(c),f.children.push(l));f=l}})});b(c);return c}
-function be(a,b){var c=M(a),d=c.querySelector("i");if(!b.length)return d;var e=me(b),e=ub(Cb,{file:e,I:ie});ob(d);c.appendChild(e);return e}function ce(a,b,c){a=M(a);var d=a.querySelector("i");return(b=ub(Bb,{types:b,I:ie,ya:!!c}))&&b.childNodes.length?(ob(d),a.appendChild(b),b):d}
-function fe(){var a=document.getElementsByTagName("DETAILS");a.length&&!a[0].hasOwnProperty("open")&&A(a,function(a){function c(){(d=!d)?a.setAttribute("open",""):a.removeAttribute("open");A(a.childNodes,function(a){1===a.nodeType&&"SUMMARY"!==a.tagName.toUpperCase()&&sc(a,d)})}var d=!0;a.setAttribute("open","");R(a,"click",c);c()})}function je(a,b){window.localStorage&&(b.checked?window.localStorage.setItem(a,"1"):window.localStorage.removeItem(a))}
-function ke(a){return window.localStorage?!!window.localStorage.getItem(a):!1}var ne="public",oe="protected",pe="private";function qe(a){return"dossier.visibility."+a}
-function de(){function a(){var a=window.localStorage;a&&!a.getItem("dossier.visibility")&&(a.setItem("dossier.visibility","1"),a.setItem(qe(ne),"1"),a.removeItem(qe(oe)),a.removeItem(qe(pe)))}function b(a,b){var d=document.getElementById(a);if(d){var e=qe(b);d.checked=ke(e);c(d,b);R(d,Ib,function(){je(e,d);c(d,b)})}}function c(a,b){a.checked?gc(f,b):ic(f,b)}function d(a){function b(){for(var a=[],e=d=f=y=0,k=c.length;e<k;++e){var l=c.shift();if(l.tagName===Ya)break;a.push(l);S(l,"public")?(d++,g.mb++):
-S(l,"protected")?(f++,g.lb++):S(l,"private")&&(y++,g.jb++)}return a}if(a){var c=Ba(a.querySelectorAll(".wrap-details, h3")),d=0,f=0,y=0;do A(b(),function(a){S(a,"public")&&d?(nb(e("public",d),a),d=0):S(a,"protected")&&f?(nb(e("protected",f),a),f=0):S(a,"private")&&y&&(nb(e("private",y),a),y=0)});while(c.length)}}function e(a,b){return ub(Ab,{visibility:a,count:b})}if(document.getElementById("show-public")){var f=document.getElementsByTagName("main")[0],g={mb:0,lb:0,jb:0};a();b("show-public",ne);b("show-protected",
-oe);b("show-private",pe);d(document.getElementById("typedefs"));d(document.getElementById("instance-methods"));d(document.getElementById("instance-properties"));d(document.getElementById("static-functions"));d(document.getElementById("static-properties"));d(document.getElementById("compiler-constants"));sc(document.getElementById("visibility-controls"),g.mb||g.lb||g.jb)}};;init();})();
+(function(){var l,n=this;
+function q(a){var b=typeof a;if("object"==b)if(a){if(a instanceof Array)return"array";if(a instanceof Object)return b;var c=Object.prototype.toString.call(a);if("[object Window]"==c)return"object";if("[object Array]"==c||"number"==typeof a.length&&"undefined"!=typeof a.splice&&"undefined"!=typeof a.propertyIsEnumerable&&!a.propertyIsEnumerable("splice"))return"array";if("[object Function]"==c||"undefined"!=typeof a.call&&"undefined"!=typeof a.propertyIsEnumerable&&!a.propertyIsEnumerable("call"))return"function"}else return"null";else if("function"==
+b&&"undefined"==typeof a.call)return"object";return b}function r(a){return"array"==q(a)}function aa(a){var b=q(a);return"array"==b||"object"==b&&"number"==typeof a.length}function t(a){return"string"==typeof a}function ba(a){var b=typeof a;return"object"==b&&null!=a||"function"==b}var ca="closure_uid_"+(1E9*Math.random()>>>0),ea=0;function fa(a,b,c){return a.call.apply(a.bind,arguments)}
+function ga(a,b,c){if(!a)throw Error();if(2<arguments.length){var d=Array.prototype.slice.call(arguments,2);return function(){var c=Array.prototype.slice.call(arguments);Array.prototype.unshift.apply(c,d);return a.apply(b,c)}}return function(){return a.apply(b,arguments)}}function u(a,b,c){u=Function.prototype.bind&&-1!=Function.prototype.bind.toString().indexOf("native code")?fa:ga;return u.apply(null,arguments)}var ha=Date.now||function(){return+new Date};
+function v(a,b){function c(){}c.prototype=b.prototype;a.la=b.prototype;a.prototype=new c;a.prototype.constructor=a;a.Ea=function(a,c,f){for(var g=Array(arguments.length-2),h=2;h<arguments.length;h++)g[h-2]=arguments[h];return b.prototype[c].apply(a,g)}};var ia;function y(){0!=ja&&(this[ca]||(this[ca]=++ea));this.ja=this.ja;this.pa=this.pa}var ja=0;y.prototype.ja=!1;var ka;function z(a,b){this.type=a;this.a=this.target=b;this.f=!1;this.ia=!0}z.prototype.stopPropagation=function(){this.f=!0};z.prototype.preventDefault=function(){this.ia=!1};var la="closure_listenable_"+(1E6*Math.random()|0),ma=0;function na(a,b,c,d,e){this.listener=a;this.a=null;this.src=b;this.type=c;this.M=!!d;this.N=e;this.Z=++ma;this.H=this.L=!1}function oa(a){a.H=!0;a.listener=null;a.a=null;a.src=null;a.N=null};function A(a,b){this.width=a;this.height=b}A.prototype.clone=function(){return new A(this.width,this.height)};A.prototype.ceil=function(){this.width=Math.ceil(this.width);this.height=Math.ceil(this.height);return this};A.prototype.floor=function(){this.width=Math.floor(this.width);this.height=Math.floor(this.height);return this};A.prototype.round=function(){this.width=Math.round(this.width);this.height=Math.round(this.height);return this};function pa(a,b){for(var c in a)b.call(void 0,a[c],c,a)}var qa="constructor hasOwnProperty isPrototypeOf propertyIsEnumerable toLocaleString toString valueOf".split(" ");function ra(a,b){for(var c,d,e=1;e<arguments.length;e++){d=arguments[e];for(c in d)a[c]=d[c];for(var f=0;f<qa.length;f++)c=qa[f],Object.prototype.hasOwnProperty.call(d,c)&&(a[c]=d[c])}};function sa(a){sa[" "](a);return a}sa[" "]=function(){};function ta(a,b){var c=a.length-b.length;return 0<=c&&a.indexOf(b,c)==c}var ua=String.prototype.trim?function(a){return a.trim()}:function(a){return a.replace(/^[\s\xa0]+|[\s\xa0]+$/g,"")};
+function va(a){if(!wa.test(a))return a;-1!=a.indexOf("&")&&(a=a.replace(xa,"&amp;"));-1!=a.indexOf("<")&&(a=a.replace(ya,"&lt;"));-1!=a.indexOf(">")&&(a=a.replace(za,"&gt;"));-1!=a.indexOf('"')&&(a=a.replace(Aa,"&quot;"));-1!=a.indexOf("'")&&(a=a.replace(Ba,"&#39;"));-1!=a.indexOf("\x00")&&(a=a.replace(Ca,"&#0;"));return a}var xa=/&/g,ya=/</g,za=/>/g,Aa=/"/g,Ba=/'/g,Ca=/\x00/g,wa=/[\x00&<>"']/;
+function Da(a){return String(a).replace(/([-()\[\]{}+?*.$\^|,:#<!\\])/g,"\\$1").replace(/\x08/g,"\\x08")}function Ea(a,b){return a<b?-1:a>b?1:0};var B=Array.prototype,Fa=B.indexOf?function(a,b,c){return B.indexOf.call(a,b,c)}:function(a,b,c){c=null==c?0:0>c?Math.max(0,a.length+c):c;if(t(a))return t(b)&&1==b.length?a.indexOf(b,c):-1;for(;c<a.length;c++)if(c in a&&a[c]===b)return c;return-1},C=B.forEach?function(a,b,c){B.forEach.call(a,b,c)}:function(a,b,c){for(var d=a.length,e=t(a)?a.split(""):a,f=0;f<d;f++)f in e&&b.call(c,e[f],f,a)},Ga=B.filter?function(a,b,c){return B.filter.call(a,b,c)}:function(a,b,c){for(var d=a.length,e=[],f=0,g=t(a)?
+a.split(""):a,h=0;h<d;h++)if(h in g){var k=g[h];b.call(c,k,h,a)&&(e[f++]=k)}return e};function Ha(a,b){var c;a:{c=a.length;for(var d=t(a)?a.split(""):a,e=0;e<c;e++)if(e in d&&b.call(void 0,d[e],e,a)){c=e;break a}c=-1}return 0>c?null:t(a)?a.charAt(c):a[c]}function Ia(a,b){var c=Fa(a,b),d;(d=0<=c)&&B.splice.call(a,c,1);return d}function Ja(a){var b=a.length;if(0<b){for(var c=Array(b),d=0;d<b;d++)c[d]=a[d];return c}return[]}
+function Ka(a,b,c){return 2>=arguments.length?B.slice.call(a,b):B.slice.call(a,b,c)};function La(a,b,c,d){var e=document.createElement("li"),f=document.createElement("a");f.classList.add("nav-item");f.textContent=a.getKey();f.tabIndex=2;a.b&&(f.href=b+a.b.href,a.b.interface&&f.classList.add("interface"));var g=a.G();if(g){var h=document.createElement("input");h.type="checkbox";h.id=d+a.getKey();e.appendChild(h);d=document.createElement("label");d.setAttribute("for",h.id);d.appendChild(f);a.b&&a.b.href===c&&d.classList.add("current");e.appendChild(d);var k=document.createElement("ul");
+k.classList.add("nav-tree");e.appendChild(k);g.forEach(function(a){k.appendChild(La(a,b,c,h.id+"."))})}else a.b&&a.b.href===c&&f.classList.add("current"),e.appendChild(f);return e}function Ma(a){if(a=a.G())a.sort(function(a,c){return a.getKey()<c.getKey()?-1:a.getKey()>c.getKey()?1:0}),a.forEach(Ma)}
+function Na(a){var b=a.G();b&&(b.forEach(Na),b.filter(function(a){return null===a.b&&1==(a.a?a.a.length:0)}).forEach(function(b){a.removeChild(b);var d=Oa(b);d&&d.forEach(function(d){var f=b.getKey()+"."+d.getKey();d.f=f;Pa(a,d)})}),b.filter(function(a){return a.b&&!a.b.namespace&&!a.b.types&&(a.a?a.a.length:0)}).forEach(function(b){var d=Oa(b);d&&d.forEach(function(d){var f=b.getKey()+"."+d.getKey();d.f=f;Pa(a,d)})}))}function D(a,b){this.f=a;this.b=b;this.a=this.c=null}D.prototype.getKey=function(){return this.f};
+D.prototype.R=function(a){this.b=a};function Pa(a,b){a.a||(a.a=[]);b.c=a;a.a.push(b)}D.prototype.G=function(){return this.a};D.prototype.removeChild=function(a){a.c=null;Ia(this.a,a)};function Oa(a){var b=a.a;a.a&&(a.a.forEach(function(a){a.c=null}),a.a=null);return b}function Qa(a,b){return a.a?Ha(a.a,function(a){return a.f===b}):null}
+function Ra(a,b){var c=new D("",null);a.forEach(function(a){if(b){var e;a.types?(e=Ra(a.types,!1),e.f=a.name,e.R(a)):e=new D(a.name,a);Pa(c,e)}else{var f=c;a.name.split(/\./).forEach(function(a){var b=Qa(f,a);b||(b=new D(a,null),Pa(f,b));f=b});f.R(a)}});Na(c);Ma(c);return c}function Sa(a,b,c){var d=Ta;d&&!ta(d,"/")&&(d+="/");a=Ra(a,c);var e=document.createElement("ul");a.G()&&a.G().forEach(function(a){e.appendChild(La(a,d,b,c?".nav-module:":".nav:"))});return e};function Ua(a){if(a.classList)return a.classList;a=a.className;return t(a)&&a.match(/\S+/g)||[]}function Va(a,b){var c;a.classList?c=a.classList.contains(b):(c=Ua(a),c=0<=Fa(c,b));return c}function Wa(a,b){a.classList?a.classList.add(b):Va(a,b)||(a.className+=0<a.className.length?" "+b:b)}function Xa(a,b){if(a.classList)C(b,function(b){Wa(a,b)});else{var c={};C(Ua(a),function(a){c[a]=!0});C(b,function(a){c[a]=!0});a.className="";for(var d in c)a.className+=0<a.className.length?" "+d:d}}
+function Ya(a,b){a.classList?a.classList.remove(b):Va(a,b)&&(a.className=Ga(Ua(a),function(a){return a!=b}).join(" "))}function Za(a){var b=["ac-active","active"];a.classList?C(b,function(b){Ya(a,b)}):a.className=Ga(Ua(a),function(a){return!(0<=Fa(b,a))}).join(" ")};function $a(a){this.src=a;this.a={};this.b=0}$a.prototype.add=function(a,b,c,d,e){var f=a.toString();a=this.a[f];a||(a=this.a[f]=[],this.b++);var g=ab(a,b,d,e);-1<g?(b=a[g],c||(b.L=!1)):(b=new na(b,this.src,f,!!d,e),b.L=c,a.push(b));return b};$a.prototype.remove=function(a,b,c,d){a=a.toString();if(!(a in this.a))return!1;var e=this.a[a];b=ab(e,b,c,d);return-1<b?(oa(e[b]),B.splice.call(e,b,1),0==e.length&&(delete this.a[a],this.b--),!0):!1};
+function bb(a,b){var c=b.type;if(!(c in a.a))return!1;var d=Ia(a.a[c],b);d&&(oa(b),0==a.a[c].length&&(delete a.a[c],a.b--));return d}function cb(a,b,c,d,e){a=a.a[b.toString()];b=-1;a&&(b=ab(a,c,d,e));return-1<b?a[b]:null}function ab(a,b,c,d){for(var e=0;e<a.length;++e){var f=a[e];if(!f.H&&f.listener==b&&f.M==!!c&&f.N==d)return e}return-1};var db;a:{var eb=n.navigator;if(eb){var fb=eb.userAgent;if(fb){db=fb;break a}}db=""}function E(a){return-1!=db.indexOf(a)};function gb(){return E("Opera")||E("OPR")}function hb(){return E("Edge")||E("Trident")||E("MSIE")}function ib(){return(E("Chrome")||E("CriOS"))&&!gb()&&!hb()};function F(){return E("Edge")};function G(a,b){this.x=void 0!==a?a:0;this.y=void 0!==b?b:0}G.prototype.clone=function(){return new G(this.x,this.y)};function jb(a,b){return new G(a.x-b.x,a.y-b.y)}G.prototype.ceil=function(){this.x=Math.ceil(this.x);this.y=Math.ceil(this.y);return this};G.prototype.floor=function(){this.x=Math.floor(this.x);this.y=Math.floor(this.y);return this};G.prototype.round=function(){this.x=Math.round(this.x);this.y=Math.round(this.y);return this};function H(a,b,c,d){this.top=a;this.right=b;this.bottom=c;this.left=d}l=H.prototype;l.clone=function(){return new H(this.top,this.right,this.bottom,this.left)};l.contains=function(a){return this&&a?a instanceof H?a.left>=this.left&&a.right<=this.right&&a.top>=this.top&&a.bottom<=this.bottom:a.x>=this.left&&a.x<=this.right&&a.y>=this.top&&a.y<=this.bottom:!1};
+l.ceil=function(){this.top=Math.ceil(this.top);this.right=Math.ceil(this.right);this.bottom=Math.ceil(this.bottom);this.left=Math.ceil(this.left);return this};l.floor=function(){this.top=Math.floor(this.top);this.right=Math.floor(this.right);this.bottom=Math.floor(this.bottom);this.left=Math.floor(this.left);return this};l.round=function(){this.top=Math.round(this.top);this.right=Math.round(this.right);this.bottom=Math.round(this.bottom);this.left=Math.round(this.left);return this};function kb(a,b,c,d){this.left=a;this.top=b;this.width=c;this.height=d}l=kb.prototype;l.clone=function(){return new kb(this.left,this.top,this.width,this.height)};l.contains=function(a){return a instanceof kb?this.left<=a.left&&this.left+this.width>=a.left+a.width&&this.top<=a.top&&this.top+this.height>=a.top+a.height:a.x>=this.left&&a.x<=this.left+this.width&&a.y>=this.top&&a.y<=this.top+this.height};
+l.ceil=function(){this.left=Math.ceil(this.left);this.top=Math.ceil(this.top);this.width=Math.ceil(this.width);this.height=Math.ceil(this.height);return this};l.floor=function(){this.left=Math.floor(this.left);this.top=Math.floor(this.top);this.width=Math.floor(this.width);this.height=Math.floor(this.height);return this};l.round=function(){this.left=Math.round(this.left);this.top=Math.round(this.top);this.width=Math.round(this.width);this.height=Math.round(this.height);return this};function lb(a){this.a=a||[]}function mb(a,b,c){for(var d=[],e=0;e<c.length;e++){var f=c[e],g=a.toLowerCase(),h=String(f).toLowerCase(),k=0;if(-1!=h.indexOf(g))k=parseInt((h.indexOf(g)/4).toString(),10);else for(var m=g.split(""),p=-1,w=10,x=0,da;da=m[x];x++)da=h.indexOf(da),da>p?(p=da-p-1,p>w-5&&(p=w-5),k+=p,p=da):(k+=w,w+=5);k<6*g.length&&d.push({Da:f,ka:k,index:e})}d.sort(function(a,b){var c=a.ka-b.ka;return 0!=c?c:a.index-b.index});a=[];for(x=0;x<b&&x<d.length;x++)a.push(d[x].Da);return a};function I(){}I.a=function(){return I.b?I.b:I.b=new I};I.prototype.a=0;var nb=gb(),J=hb(),K=E("Gecko")&&!(-1!=db.toLowerCase().indexOf("webkit")&&!F())&&!(E("Trident")||E("MSIE"))&&!F(),L=-1!=db.toLowerCase().indexOf("webkit")&&!F(),M=E("Macintosh");function ob(){var a=db;if(K)return/rv\:([^\);]+)(\)|;)/.exec(a);if(J&&F())return/Edge\/([\d\.]+)/.exec(a);if(J)return/\b(?:MSIE|rv)[: ]([^\);]+)(\)|;)/.exec(a);if(L)return/WebKit\/(\S+)/.exec(a)}function pb(){var a=n.document;return a?a.documentMode:void 0}
+var qb=function(){if(nb&&n.opera){var a=n.opera.version;return"function"==q(a)?a():a}var a="",b=ob();b&&(a=b?b[1]:"");return J&&!F()&&(b=pb(),b>parseFloat(a))?String(b):a}(),rb={};
+function N(a){var b;if(!(b=rb[a])){b=0;for(var c=ua(String(qb)).split("."),d=ua(String(a)).split("."),e=Math.max(c.length,d.length),f=0;0==b&&f<e;f++){var g=c[f]||"",h=d[f]||"",k=/(\d*)(\D*)/g,m=/(\d*)(\D*)/g;do{var p=k.exec(g)||["","",""],w=m.exec(h)||["","",""];if(0==p[0].length&&0==w[0].length)break;b=Ea(0==p[1].length?0:parseInt(p[1],10),0==w[1].length?0:parseInt(w[1],10))||Ea(0==p[2].length,0==w[2].length)||Ea(p[2],w[2])}while(0==b)}b=rb[a]=0<=b}return b}
+function O(a){return J&&(F()||sb>=a)}var tb=n.document,ub=pb(),sb=!tb||!J||!ub&&F()?void 0:ub||("CSS1Compat"==tb.compatMode?parseInt(qb,10):5);var vb=!J||O(9),wb=!K&&!J||J&&O(9)||K&&N("1.9.1");J&&N("9");function P(a){return a?new xb(Q(a)):ka||(ka=new xb)}function yb(a){var b=document;return t(a)?b.getElementById(a):a}function zb(a,b){pa(b,function(b,d){"style"==d?a.style.cssText=b:"class"==d?a.className=b:"for"==d?a.htmlFor=b:d in Ab?a.setAttribute(Ab[d],b):0==d.lastIndexOf("aria-",0)||0==d.lastIndexOf("data-",0)?a.setAttribute(d,b):a[d]=b})}
+var Ab={cellpadding:"cellPadding",cellspacing:"cellSpacing",colspan:"colSpan",frameborder:"frameBorder",height:"height",maxlength:"maxLength",role:"role",rowspan:"rowSpan",type:"type",usemap:"useMap",valign:"vAlign",width:"width"};function Bb(a){var b=Cb(a);a=Db(a);return J&&N("10")&&a.pageYOffset!=b.scrollTop?new G(b.scrollLeft,b.scrollTop):new G(a.pageXOffset||b.scrollLeft,a.pageYOffset||b.scrollTop)}
+function Cb(a){return L||"CSS1Compat"!=a.compatMode?a.body||a.documentElement:a.documentElement}function Db(a){return a.parentWindow||a.defaultView}function Eb(a,b,c){function d(c){c&&b.appendChild(t(c)?a.createTextNode(c):c)}for(var e=2;e<c.length;e++){var f=c[e];if(!aa(f)||ba(f)&&0<f.nodeType)d(f);else{var g;a:{if(f&&"number"==typeof f.length){if(ba(f)){g="function"==typeof f.item||"string"==typeof f.item;break a}if("function"==q(f)){g="function"==typeof f.item;break a}}g=!1}C(g?Ja(f):f,d)}}}
+function Fb(a){for(var b;b=a.firstChild;)a.removeChild(b)}function Q(a){return 9==a.nodeType?a:a.ownerDocument||a.document}function Gb(a,b){a=a.parentNode;for(var c=0;a;){if(b(a))return a;a=a.parentNode;c++}return null}function xb(a){this.a=a||n.document||document}
+xb.prototype.b=function(a,b,c){var d=this.a,e=arguments,f=e[0],g=e[1];if(!vb&&g&&(g.name||g.type)){f=["<",f];g.name&&f.push(' name="',va(g.name),'"');if(g.type){f.push(' type="',va(g.type),'"');var h={};ra(h,g);delete h.type;g=h}f.push(">");f=f.join("")}f=d.createElement(f);g&&(t(g)?f.className=g:r(g)?f.className=g.join(" "):zb(f,g));2<e.length&&Eb(d,f,e);return f};function Hb(a){return"CSS1Compat"==a.a.compatMode}xb.prototype.f=Fb;
+xb.prototype.G=function(a){return wb&&void 0!=a.children?a.children:Ga(a.childNodes,function(a){return 1==a.nodeType})};xb.prototype.contains=function(a,b){if(a.contains&&1==b.nodeType)return a==b||a.contains(b);if("undefined"!=typeof a.compareDocumentPosition)return a==b||Boolean(a.compareDocumentPosition(b)&16);for(;b&&a!=b;)b=b.parentNode;return b==a};function Ib(a,b){b?a.setAttribute("role",b):a.removeAttribute("role")}function Jb(a,b,c){r(c)&&(c=c.join(" "));var d="aria-"+b;""===c||void 0==c?(ia||(ia={atomic:!1,autocomplete:"none",dropeffect:"none",haspopup:!1,live:"off",multiline:!1,multiselectable:!1,orientation:"vertical",readonly:!1,relevant:"additions text",required:!1,sort:"none",busy:!1,disabled:!1,hidden:!1,invalid:"false"}),c=ia,b in c?a.setAttribute(d,c[b]):a.removeAttribute(d)):a.setAttribute(d,c)}
+function Kb(a,b){var c="";b&&(c=b.id);Jb(a,"activedescendant",c)};function Lb(a){var b=0,c=0;if(Mb(a))b=a.selectionStart,c=-1;else if(J){var d=Nb(a),e=d[0],d=d[1];if(e.inRange(d)){e.setEndPoint("EndToStart",d);if("textarea"==a.type){d.duplicate();b=a=e.text;for(c=!1;!c;)0==e.compareEndPoints("StartToEnd",e)?c=!0:(e.moveEnd("character",-1),e.text==a?b+="\r\n":c=!0);e=[b.length,-1];return e}b=e.text.length;c=-1}}return[b,c]}
+function Nb(a){var b=a.ownerDocument||a.document,c=b.selection.createRange();"textarea"==a.type?(b=b.body.createTextRange(),b.moveToElementText(a)):b=a.createTextRange();return[b,c]}function Ob(a,b){"textarea"==a.type&&(b=a.value.substring(0,b).replace(/(\r\n|\r|\n)/g,"\n").length);return b}function Mb(a){try{return"number"==typeof a.selectionStart}catch(b){return!1}};var Pb=!J||O(9),Qb=J&&!N("9");!L||N("528");K&&N("1.9b")||J&&N("8")||nb&&N("9.5")||L&&N("528");K&&!N("8")||J&&N("9");function R(a,b){z.call(this,a?a.type:"");this.a=this.target=null;this.i=this.keyCode=this.screenY=this.screenX=this.clientY=this.clientX=0;this.metaKey=this.l=this.b=this.ctrlKey=!1;this.c=null;if(a){var c=this.type=a.type,d=null;if("touchstart"==c||"touchmove"==c)d=a.targetTouches[0];else if("touchend"==c||"touchcancel"==c)d=a.changedTouches[0];this.target=null===d?a.target||a.srcElement:d.target;this.a=b;var e=a.relatedTarget;if(e&&K)try{sa(e.nodeName)}catch(f){}null===d?(this.clientX=void 0!==
+a.clientX?a.clientX:a.pageX,this.clientY=void 0!==a.clientY?a.clientY:a.pageY,this.screenX=a.screenX||0,this.screenY=a.screenY||0):(this.clientX=void 0!==d.clientX?d.clientX:d.pageX,this.clientY=void 0!==d.clientY?d.clientY:d.pageY,this.screenX=d.screenX||0,this.screenY=d.screenY||0);this.keyCode=a.keyCode||0;this.i=a.charCode||("keypress"==c?a.keyCode:0);this.ctrlKey=a.ctrlKey;this.b=a.altKey;this.l=a.shiftKey;this.metaKey=a.metaKey;this.c=a;a.defaultPrevented&&this.preventDefault()}}v(R,z);
+R.prototype.stopPropagation=function(){R.la.stopPropagation.call(this);this.c.stopPropagation?this.c.stopPropagation():this.c.cancelBubble=!0};R.prototype.preventDefault=function(){R.la.preventDefault.call(this);var a=this.c;if(a.preventDefault)a.preventDefault();else if(a.returnValue=!1,Qb)try{if(a.ctrlKey||112<=a.keyCode&&123>=a.keyCode)a.keyCode=-1}catch(b){}};var Rb="closure_lm_"+(1E6*Math.random()|0),Sb={},Tb=0;function S(a,b,c,d,e){if(r(b)){for(var f=0;f<b.length;f++)S(a,b[f],c,d,e);return null}c=Ub(c);if(a&&a[la])a=a.f(b,c,d,e);else{if(!b)throw Error("Invalid event type");var f=!!d,g=Vb(a);g||(a[Rb]=g=new $a(a));c=g.add(b,c,!1,d,e);c.a||(d=Wb(),c.a=d,d.src=a,d.listener=c,a.addEventListener?a.addEventListener(b.toString(),d,f):a.attachEvent(Xb(b.toString()),d),Tb++);a=c}return a}
+function Wb(){var a=Yb,b=Pb?function(c){return a.call(b.src,b.listener,c)}:function(c){c=a.call(b.src,b.listener,c);if(!c)return c};return b}function Zb(a,b,c,d,e){if(r(b))for(var f=0;f<b.length;f++)Zb(a,b[f],c,d,e);else c=Ub(c),a&&a[la]?a.i(b,c,d,e):a&&(a=Vb(a))&&(b=cb(a,b,c,!!d,e))&&T(b)}
+function T(a){if("number"==typeof a||!a||a.H)return!1;var b=a.src;if(b&&b[la])return bb(b.F,a);var c=a.type,d=a.a;b.removeEventListener?b.removeEventListener(c,d,a.M):b.detachEvent&&b.detachEvent(Xb(c),d);Tb--;(c=Vb(b))?(bb(c,a),0==c.b&&(c.src=null,b[Rb]=null)):oa(a);return!0}function Xb(a){return a in Sb?Sb[a]:Sb[a]="on"+a}function $b(a,b,c,d){var e=!0;if(a=Vb(a))if(b=a.a[b.toString()])for(b=b.concat(),a=0;a<b.length;a++){var f=b[a];f&&f.M==c&&!f.H&&(f=ac(f,d),e=e&&!1!==f)}return e}
+function ac(a,b){var c=a.listener,d=a.N||a.src;a.L&&T(a);return c.call(d,b)}
+function Yb(a,b){if(a.H)return!0;if(!Pb){var c;if(!(c=b))a:{c=["window","event"];for(var d=n,e;e=c.shift();)if(null!=d[e])d=d[e];else{c=null;break a}c=d}e=c;c=new R(e,this);d=!0;if(!(0>e.keyCode||void 0!=e.returnValue)){a:{var f=!1;if(0==e.keyCode)try{e.keyCode=-1;break a}catch(g){f=!0}if(f||void 0==e.returnValue)e.returnValue=!0}e=[];for(f=c.a;f;f=f.parentNode)e.push(f);for(var f=a.type,h=e.length-1;!c.f&&0<=h;h--){c.a=e[h];var k=$b(e[h],f,!0,c),d=d&&k}for(h=0;!c.f&&h<e.length;h++)c.a=e[h],k=$b(e[h],
+f,!1,c),d=d&&k}return d}return ac(a,new R(b,this))}function Vb(a){a=a[Rb];return a instanceof $a?a:null}var bc="__closure_events_fn_"+(1E9*Math.random()>>>0);function Ub(a){if("function"==q(a))return a;a[bc]||(a[bc]=function(b){return a.handleEvent(b)});return a[bc]};function cc(a){y.call(this);this.b=a;this.a={}}v(cc,y);var dc=[];cc.prototype.f=function(a,b,c,d){r(b)||(b&&(dc[0]=b.toString()),b=dc);for(var e=0;e<b.length;e++){var f=S(a,b[e],c||this.handleEvent,d||!1,this.b||this);if(!f)break;this.a[f.Z]=f}return this};
+cc.prototype.i=function(a,b,c,d,e){if(r(b))for(var f=0;f<b.length;f++)this.i(a,b[f],c,d,e);else c=c||this.handleEvent,e=e||this.b||this,c=Ub(c),d=!!d,b=a&&a[la]?cb(a.F,String(b),c,d,e):a?(a=Vb(a))?cb(a,b,c,d,e):null:null,b&&(T(b),delete this.a[b.Z]);return this};cc.prototype.handleEvent=function(){throw Error("EventHandler.handleEvent not implemented");};function U(){y.call(this);this.F=new $a(this);this.ma=this;this.S=null}v(U,y);U.prototype[la]=!0;U.prototype.addEventListener=function(a,b,c,d){S(this,a,b,c,d)};U.prototype.removeEventListener=function(a,b,c,d){Zb(this,a,b,c,d)};
+function V(a,b){var c,d=a.S;if(d)for(c=[];d;d=d.S)c.push(d);var d=a.ma,e=b,f=e.type||e;if(t(e))e=new z(e,d);else if(e instanceof z)e.target=e.target||d;else{var g=e,e=new z(f,d);ra(e,g)}var g=!0,h;if(c)for(var k=c.length-1;!e.f&&0<=k;k--)h=e.a=c[k],g=ec(h,f,!0,e)&&g;e.f||(h=e.a=d,g=ec(h,f,!0,e)&&g,e.f||(g=ec(h,f,!1,e)&&g));if(c)for(k=0;!e.f&&k<c.length;k++)h=e.a=c[k],g=ec(h,f,!1,e)&&g;return g}U.prototype.f=function(a,b,c,d){return this.F.add(String(a),b,!1,c,d)};
+U.prototype.i=function(a,b,c,d){return this.F.remove(String(a),b,c,d)};function ec(a,b,c,d){b=a.F.a[String(b)];if(!b)return!0;b=b.concat();for(var e=!0,f=0;f<b.length;++f){var g=b[f];if(g&&!g.H&&g.M==c){var h=g.listener,k=g.N||g.src;g.L&&bb(a.F,g);e=!1!==h.call(k,d)&&e}}return e&&0!=d.ia};function fc(a,b,c,d,e){if(!(J||L&&N("525")))return!0;if(M&&e)return gc(a);if(e&&!d)return!1;"number"==typeof b&&(b=hc(b));if(!c&&(17==b||18==b||M&&91==b))return!1;if(L&&d&&c)switch(a){case 220:case 219:case 221:case 192:case 186:case 189:case 187:case 188:case 190:case 191:case 192:case 222:return!1}if(J&&d&&b==a)return!1;switch(a){case 13:return!0;case 27:return!L}return gc(a)}
+function gc(a){if(48<=a&&57>=a||96<=a&&106>=a||65<=a&&90>=a||L&&0==a)return!0;switch(a){case 32:case 63:case 107:case 109:case 110:case 111:case 186:case 59:case 189:case 187:case 61:case 188:case 190:case 191:case 192:case 222:case 219:case 220:case 221:return!0;default:return!1}}function hc(a){if(K)a=ic(a);else if(M&&L)a:switch(a){case 93:a=91;break a}return a}
+function ic(a){switch(a){case 61:return 187;case 59:return 186;case 173:return 189;case 224:return 91;case 0:return 224;default:return a}};function jc(a,b){U.call(this);a&&kc(this,a,b)}v(jc,U);l=jc.prototype;l.I=null;l.O=null;l.V=null;l.P=null;l.s=-1;l.w=-1;l.T=!1;
+var lc={3:13,12:144,63232:38,63233:40,63234:37,63235:39,63236:112,63237:113,63238:114,63239:115,63240:116,63241:117,63242:118,63243:119,63244:120,63245:121,63246:122,63247:123,63248:44,63272:46,63273:36,63275:35,63276:33,63277:34,63289:144,63302:45},mc={Up:38,Down:40,Left:37,Right:39,Enter:13,F1:112,F2:113,F3:114,F4:115,F5:116,F6:117,F7:118,F8:119,F9:120,F10:121,F11:122,F12:123,"U+007F":46,Home:36,End:35,PageUp:33,PageDown:34,Insert:45},nc=J||L&&N("525"),oc=M&&K;
+jc.prototype.a=function(a){L&&(17==this.s&&!a.ctrlKey||18==this.s&&!a.b||M&&91==this.s&&!a.metaKey)&&(this.w=this.s=-1);-1==this.s&&(a.ctrlKey&&17!=a.keyCode?this.s=17:a.b&&18!=a.keyCode?this.s=18:a.metaKey&&91!=a.keyCode&&(this.s=91));nc&&!fc(a.keyCode,this.s,a.l,a.ctrlKey,a.b)?this.handleEvent(a):(this.w=hc(a.keyCode),oc&&(this.T=a.b))};jc.prototype.b=function(a){this.w=this.s=-1;this.T=a.b};
+jc.prototype.handleEvent=function(a){var b=a.c,c,d,e=b.altKey;J&&"keypress"==a.type?(c=this.w,d=13!=c&&27!=c?b.keyCode:0):L&&"keypress"==a.type?(c=this.w,d=0<=b.charCode&&63232>b.charCode&&gc(c)?b.charCode:0):nb?(c=this.w,d=gc(c)?b.keyCode:0):(c=b.keyCode||this.w,d=b.charCode||0,oc&&(e=this.T),M&&63==d&&224==c&&(c=191));var f=c=hc(c),g=b.keyIdentifier;c?63232<=c&&c in lc?f=lc[c]:25==c&&a.l&&(f=9):g&&g in mc&&(f=mc[g]);this.s=f;a=new pc(f,d,0,b);a.b=e;V(this,a)};
+function kc(a,b,c){a.P&&qc(a);a.I=b;a.O=S(a.I,"keypress",a,c);a.V=S(a.I,"keydown",a.a,c,a);a.P=S(a.I,"keyup",a.b,c,a)}function qc(a){a.O&&(T(a.O),T(a.V),T(a.P),a.O=null,a.V=null,a.P=null);a.I=null;a.s=-1;a.w=-1}function pc(a,b,c,d){R.call(this,d);this.type="key";this.keyCode=a;this.i=b}v(pc,R);function W(a,b){var c=Q(a);return c.defaultView&&c.defaultView.getComputedStyle&&(c=c.defaultView.getComputedStyle(a,null))?c[b]||c.getPropertyValue(b)||"":""}function X(a,b){return W(a,b)||(a.currentStyle?a.currentStyle[b]:null)||a.style&&a.style[b]}
+function rc(a){var b;try{b=a.getBoundingClientRect()}catch(c){return{left:0,top:0,right:0,bottom:0}}J&&a.ownerDocument.body&&(a=a.ownerDocument,b.left-=a.documentElement.clientLeft+a.body.clientLeft,b.top-=a.documentElement.clientTop+a.body.clientTop);return b}
+function sc(a){if(J&&!O(8))return a.offsetParent;var b=Q(a),c=X(a,"position"),d="fixed"==c||"absolute"==c;for(a=a.parentNode;a&&a!=b;a=a.parentNode)if(11==a.nodeType&&a.host&&(a=a.host),c=X(a,"position"),d=d&&"static"==c&&a!=b.documentElement&&a!=b.body,!d&&(a.scrollWidth>a.clientWidth||a.scrollHeight>a.clientHeight||"fixed"==c||"absolute"==c||"relative"==c))return a;return null}
+function tc(a){for(var b=new H(0,Infinity,Infinity,0),c=P(a),d=c.a.body,e=c.a.documentElement,f=Cb(c.a);a=sc(a);)if(!(J&&0==a.clientWidth||L&&0==a.clientHeight&&a==d)&&a!=d&&a!=e&&"visible"!=X(a,"overflow")){var g=Y(a),h=new G(a.clientLeft,a.clientTop);g.x+=h.x;g.y+=h.y;b.top=Math.max(b.top,g.y);b.right=Math.min(b.right,g.x+a.clientWidth);b.bottom=Math.min(b.bottom,g.y+a.clientHeight);b.left=Math.max(b.left,g.x)}d=f.scrollLeft;f=f.scrollTop;b.left=Math.max(b.left,d);b.top=Math.max(b.top,f);c=(Db(c.a)||
+window).document;c="CSS1Compat"==c.compatMode?c.documentElement:c.body;c=new A(c.clientWidth,c.clientHeight);b.right=Math.min(b.right,d+c.width);b.bottom=Math.min(b.bottom,f+c.height);return 0<=b.top&&0<=b.left&&b.bottom>b.top&&b.right>b.left?b:null}function Y(a){var b=Q(a),c=new G(0,0),d;d=b?Q(b):document;d=!J||O(9)||Hb(P(d))?d.documentElement:d.body;if(a==d)return c;a=rc(a);b=P(b);b=Bb(b.a);c.x=a.left+b.x;c.y=a.top+b.y;return c}function uc(a){"number"==typeof a&&(a=a+"px");return a}
+function vc(a){var b=wc;if("none"!=X(a,"display"))return b(a);var c=a.style,d=c.display,e=c.visibility,f=c.position;c.visibility="hidden";c.position="absolute";c.display="inline";a=b(a);c.display=d;c.position=f;c.visibility=e;return a}function wc(a){var b=a.offsetWidth,c=a.offsetHeight,d=L&&!b&&!c;return(void 0===b||d)&&a.getBoundingClientRect?(a=rc(a),new A(a.right-a.left,a.bottom-a.top)):new A(b,c)}var xc=K?"MozUserSelect":L?"WebkitUserSelect":null;
+function yc(a){var b=a.getElementsByTagName("*");if(xc){var c="none";a.style[xc]=c;if(b){a=0;for(var d;d=b[a];a++)d.style[xc]=c}}else if(J||nb)if(c="on",a.setAttribute("unselectable",c),b)for(a=0;d=b[a];a++)d.setAttribute("unselectable",c)}function zc(a,b){if(/^\d+px?$/.test(b))return parseInt(b,10);var c=a.style.left,d=a.runtimeStyle.left;a.runtimeStyle.left=a.currentStyle.left;a.style.left=b;var e=a.style.pixelLeft;a.style.left=c;a.runtimeStyle.left=d;return e}
+function Ac(a,b){var c=a.currentStyle?a.currentStyle[b]:null;return c?zc(a,c):0}var Bc={thin:2,medium:4,thick:6};function Cc(a,b){if("none"==(a.currentStyle?a.currentStyle[b+"Style"]:null))return 0;var c=a.currentStyle?a.currentStyle[b+"Width"]:null;return c in Bc?Bc[c]:zc(a,c)}
+function Dc(a){if(J&&!O(9)){var b=Cc(a,"borderLeft"),c=Cc(a,"borderRight"),d=Cc(a,"borderTop");a=Cc(a,"borderBottom");return new H(d,c,a,b)}b=W(a,"borderLeftWidth");c=W(a,"borderRightWidth");d=W(a,"borderTopWidth");a=W(a,"borderBottomWidth");return new H(parseFloat(d),parseFloat(c),parseFloat(a),parseFloat(b))};function Ec(a,b){return(b&4&&"rtl"==X(a,"direction")?b^2:b)&-5};function Fc(a,b){U.call(this);this.c=a||1;this.b=b||n;this.j=u(this.o,this);this.m=ha()}v(Fc,U);Fc.prototype.h=!1;Fc.prototype.a=null;Fc.prototype.o=function(){if(this.h){var a=ha()-this.m;0<a&&a<.8*this.c?this.a=this.b.setTimeout(this.j,this.c-a):(this.a&&(this.b.clearTimeout(this.a),this.a=null),V(this,Gc),this.h&&(this.a=this.b.setTimeout(this.j,this.c),this.m=ha()))}};var Gc="tick";function Hc(a,b,c){U.call(this);this.v=a;this.J=c;this.c=b;S(b,[Ic,Jc,Kc,Lc],this.handleEvent,!1,this);this.m=null;this.b=[];this.h=-1;this.a=0;this.j=this.o=null;this.K={}}v(Hc,U);Hc.prototype.D=10;var Ic="hilite",Jc="select",Lc="dismiss",Kc="canceldismiss";l=Hc.prototype;
+l.handleEvent=function(a){var b=this.v;if(a.target==this.c)switch(a.type){case Ic:this.B(a.C);break;case Jc:var c=!1;if("number"==typeof a.C){a=a.C;var d=this.b[Mc(this,a)],c=!!d&&b.U&&b.U(d);d&&!c&&this.h!=a&&this.B(a)}c||Nc(this);break;case Kc:Oc(this);break;case Lc:Pc(this)}};function Qc(a){for(var b=a.a+a.b.length-1,c=a.h,d=0;d<a.b.length;d++){if(c>=a.a&&c<b)c++;else if(-1==c)c=a.a;else break;if(a.B(c))break}}
+l.B=function(a){var b=Mc(this,a),c=this.b[b];return c&&this.v.U&&this.v.U(c)?!1:(this.h=a,this.c.B(a),-1!=b)};
+function Nc(a){var b=Mc(a,a.h);if(-1!=b){var c=a.b[b],d=a.J;if(d.g){var e=c.toString();if(d.c){var f=Rc(d,d.g.value,Lb(d.g)[0]),g=Sc(d,d.g.value);d.S.test(e)||(e=e.replace(/[\s\xa0]+$/,"")+d.v);0==f||/^[\s\xa0]*$/.test(g[f-1])||(e=" "+e);f==g.length-1&&(e+=" ");if(e!=g[f]){g[f]=e;e=d.g;(K||J&&N("9"))&&e.blur();e.value=g.join("");for(var h=0,k=0;k<=f;k++)h+=g[k].length;e.focus();f=h;g=d.g;e=f;Mb(g)?g.selectionStart=e:J&&(h=Nb(g),k=h[0],k.inRange(h[1])&&(e=Ob(g,e),k.collapse(!0),k.move("character",
+e),k.select()));g=d.g;Mb(g)?g.selectionEnd=f:J&&(h=Nb(g),e=h[1],h[0].inRange(e)&&(f=Ob(g,f),g=Ob(g,Lb(g)[0]),e.collapse(!0),e.moveEnd("character",f-g),e.select()))}}else d.R(e);d.Y=!0}a.u();V(a,{type:"update",C:c,index:b});return!0}a.u();V(a,{type:"update",C:null,index:null});return!1}l.u=function(){this.h=-1;this.m=null;this.a+=this.b.length;this.b=[];window.clearTimeout(this.j);this.j=null;this.c.u();V(this,"suggestionsupdate");V(this,Lc)};
+function Pc(a){a.j||(a.j=window.setTimeout(u(a.u,a),100))}l.aa=function(){return this.j?(window.clearTimeout(this.j),this.j=null,!0):!1};function Oc(a){a.aa()||window.setTimeout(u(a.aa,a),10)}l.Ba=function(a,b,c){this.m==a&&this.X(b,c)};
+l.X=function(a,b){var c="object"==q(b)&&b,d=(c?c.Fa():b)?Mc(this,this.h):-1;this.a+=this.b.length;this.b=a;for(var e=[],f=0;f<a.length;++f)e.push({id:this.a+f,data:a[f]});f=null;if(this.o){var f=this.K,g;g=this.o;g=g[ca]||(g[ca]=++ea);f=f[g]||this.o}this.c.na=f;this.c.X(e,this.m,this.o);f=!0;c&&void 0!==c.ua()&&(f=c.ua());this.h=-1;(f||0<=d)&&0!=e.length&&this.m&&(0<=d?this.B(this.a+d):Qc(this));V(this,"suggestionsupdate")};function Mc(a,b){var c=b-a.a;return 0>c||c>=a.b.length?-1:c}l.update=function(a){this.J.update(a)};function Tc(a,b,c,d){U.call(this);this.v=a||document.body;this.j=P(this.v);this.qa=!a;this.b=null;this.D="";this.c=[];this.h=[];this.J=this.o=-1;this.l=!1;this.className="ac-renderer";this.oa="ac-highlighted";this.m=b||null;this.sa=null!=d?d:!0;this.ra=!!c}v(Tc,U);l=Tc.prototype;l.X=function(a,b,c){this.D=b;this.c=a;this.o=-1;this.J=ha();this.a=c;this.h=[];Uc(this)};l.u=function(){this.a&&Kb(this.a,null);this.l&&(this.l=!1,this.a&&Jb(this.a,"haspopup",!1),this.b.style.display="none")};
+function Vc(a){a.l||(a.l=!0,a.a&&(Ib(a.a,"combobox"),Jb(a.a,"autocomplete","list"),Jb(a.a,"haspopup",!0)),a.b.style.display="")}
+function Wc(a,b){var c=0<=b&&b<a.c.length?a.c[b]:void 0,d=0<=b&&b<a.h.length?a.h[b]:void 0;if(V(a,{type:"rowhilite",Ia:d,C:c?c.data:null})&&(0<=a.o&&Za(a.h[a.o]),a.o=b,d)){Xa(d,["ac-active","active"]);a.a&&Kb(a.a,d);var c=a.b,e,f=Y(d);e=Y(c);var g=Dc(c),h=f.x-e.x-g.left,f=f.y-e.y-g.top,k=c.clientWidth-d.offsetWidth,d=c.clientHeight-d.offsetHeight,m=c.scrollLeft,p=c.scrollTop;if(c==document.body||c==document.documentElement)m=e.x+g.left,p=e.y+g.top,J&&!O(10)&&(m+=g.left,p+=g.top);m+=Math.min(h,Math.max(h-
+k,0));p+=Math.min(f,Math.max(f-d,0));e=new G(m,p);c.scrollLeft=e.x;c.scrollTop=e.y}}l.B=function(a){if(-1==a)Wc(this,-1);else for(var b=0;b<this.c.length;b++)if(this.c[b].id==a){Wc(this,b);break}};function Xc(a){if(!a.b){var b=a.j.b("DIV",{style:"display:none"});a.b=b;Xa(b,ua(a.className).split(" "));Ib(b,"listbox");b.id=":"+(I.a().a++).toString(36);a.v.appendChild(b);S(b,"click",a.xa,!1,a);S(b,"mousedown",a.za,!1,a);S(b,"mouseover",a.Aa,!1,a)}}
+function Uc(a){Xc(a);a.ta&&(a.b.style.minWidth=a.ta.clientWidth+"px");a.h.length=0;a.j.f(a.b);a.m&&a.m.Ga||C(a.c,function(a){var c=a;a=this.D;var d=this.j.b("DIV",{className:"ac-row",id:":"+(I.a().a++).toString(36)});Ib(d,"option");if(!this.m||!this.m.Ha)if(c=c.data.toString(),"textContent"in d)d.textContent=c;else if(3==d.nodeType)d.data=c;else if(d.firstChild&&3==d.firstChild.nodeType){for(;d.lastChild!=d.firstChild;)d.removeChild(d.lastChild);d.firstChild.data=c}else Fb(d),d.appendChild(Q(d).createTextNode(String(c)));
+a&&this.sa&&(this.K=!1,Yc(this,d,a));Wa(d,"ac-row");this.h.push(d);this.b.appendChild(d)},a);0==a.c.length?a.u():(Vc(a),Zc(a),yc(a.b))}
+function Zc(a){if(a.a&&a.qa){var b=a.na||a.a,c;c=a.ra?3:1;a=a.b;var d=c^1,e,f;if(e=a.offsetParent){var g="HTML"==e.tagName||"BODY"==e.tagName;g&&"static"==X(e,"position")||(f=Y(e),g||(g=(g="rtl"==X(e,"direction"))&&K?-e.scrollLeft:!g||J&&N("8")||"visible"==X(e,"overflowX")?e.scrollLeft:e.scrollWidth-e.clientWidth-e.scrollLeft,f=jb(f,new G(g,e.scrollTop))))}e=f||new G;f=Y(b);g=vc(b);f=new kb(f.x,f.y,g.width,g.height);if(g=tc(b)){var h=new kb(g.left,g.top,g.right-g.left,g.bottom-g.top),g=Math.max(f.left,
+h.left),k=Math.min(f.left+f.width,h.left+h.width);if(g<=k){var m=Math.max(f.top,h.top),h=Math.min(f.top+f.height,h.top+h.height);m<=h&&(f.left=g,f.top=m,f.width=k-g,f.height=h-m)}}g=P(b);m=P(a);if(g.a!=m.a){var k=g.a.body,m=Db(m.a),h=new G(0,0),p;p=(p=Q(k))?Db(p):window;var w=k;do{var x;p==m?x=Y(w):(x=rc(w),x=new G(x.left,x.top));h.x+=x.x;h.y+=x.y}while(p&&p!=m&&p!=p.parent&&(w=p.frameElement)&&(p=p.parent));k=jb(h,Y(k));!J||O(9)||Hb(g)||(k=jb(k,Bb(g.a)));f.left+=k.x;f.top+=k.y}b=Ec(b,c);c=new G(b&
+2?f.left+f.width:f.left,b&1?f.top+f.height:f.top);c=jb(c,e);if(b=tc(a))b.top-=e.y,b.right-=e.x,b.bottom-=e.y,b.left-=e.x;c=c.clone();f=Ec(a,d);d=vc(a);e=d.clone();c=c.clone();e=e.clone();0!=f&&(f&2&&(c.x-=e.width+0),f&1&&(c.y-=e.height+0));b?(f=c,g=e,k=65,m=0,65==(k&65)&&(f.x<b.left||f.x>=b.right)&&(k&=-2),132==(k&132)&&(f.y<b.top||f.y>=b.bottom)&&(k&=-5),f.x<b.left&&k&1&&(f.x=b.left,m|=1),k&16&&(h=f.x,f.x<b.left&&(f.x=b.left,m|=4),f.x+g.width>b.right&&(g.width=Math.min(b.right-f.x,h+g.width-b.left),
+g.width=Math.max(g.width,0),m|=4)),f.x+g.width>b.right&&k&1&&(f.x=Math.max(b.right-g.width,b.left),m|=1),k&2&&(m=m|(f.x<b.left?16:0)|(f.x+g.width>b.right?32:0)),f.y<b.top&&k&4&&(f.y=b.top,m|=2),k&32&&(h=f.y,f.y<b.top&&(f.y=b.top,m|=8),f.y+g.height>b.bottom&&(g.height=Math.min(b.bottom-f.y,h+g.height-b.top),g.height=Math.max(g.height,0),m|=8)),f.y+g.height>b.bottom&&k&4&&(f.y=Math.max(b.bottom-g.height,b.top),m|=2),k&8&&(m=m|(f.y<b.top?64:0)|(f.y+g.height>b.bottom?128:0)),f=m):f=256;b=new kb(0,0,0,
+0);b.left=c.x;b.top=c.y;b.width=e.width;b.height=e.height;f&496||(e=new G(b.left,b.top),e instanceof G?(c=e.x,e=e.y):(c=e,e=void 0),a.style.left=uc(c),a.style.top=uc(e),e=new A(b.width,b.height),d==e||d&&e&&d.width==e.width&&d.height==e.height||(d=e,c=Hb(P(Q(a))),!J||N("10")||c&&N("8")?(a=a.style,K?a.MozBoxSizing="border-box":L?a.WebkitBoxSizing="border-box":a.boxSizing="border-box",a.width=Math.max(d.width,0)+"px",a.height=Math.max(d.height,0)+"px"):(b=a.style,c?(J?(c=Ac(a,"paddingLeft"),e=Ac(a,
+"paddingRight"),f=Ac(a,"paddingTop"),g=Ac(a,"paddingBottom"),c=new H(f,e,g,c)):(c=W(a,"paddingLeft"),e=W(a,"paddingRight"),f=W(a,"paddingTop"),g=W(a,"paddingBottom"),c=new H(parseFloat(f),parseFloat(e),parseFloat(g),parseFloat(c))),a=Dc(a),b.pixelWidth=d.width-a.left-c.left-c.right-a.right,b.pixelHeight=d.height-a.top-c.top-c.bottom-a.bottom):(b.pixelWidth=d.width,b.pixelHeight=d.height))))}}
+function Yc(a,b,c){if(!a.K)if(3==b.nodeType){var d=null;r(c)&&1<c.length&&(d=Ka(c,1));c=$c(c);if(0!=c.length){var e=b.nodeValue,f=new RegExp("\\b(?:"+c+")","gi");c=[];for(var g=0,h=f.exec(e),k=0;h;)k++,c.push(e.substring(g,h.index)),c.push(e.substring(h.index,f.lastIndex)),g=f.lastIndex,h=f.exec(e);c.push(e.substring(g));if(1<c.length){for(d=0;1>d;d++)e=2*d,b.nodeValue=c[e],f=a.j.a.createElement("B"),f.className=a.oa,f.appendChild(a.j.a.createTextNode(String(c[e+1]))),f=b.parentNode.insertBefore(f,
+b.nextSibling),b.parentNode.insertBefore(a.j.a.createTextNode(""),f.nextSibling),b=f.nextSibling;b.nodeValue=Ka(c,2).join("");a.K=!0}else d&&Yc(a,b,d)}}else for(b=b.firstChild;b;)d=b.nextSibling,Yc(a,b,c),b=d}function $c(a){var b="";if(!a)return b;r(a)&&(a=Ga(a,function(a){return!/^[\s\xa0]*$/.test(null==a?"":String(a))}));r(a)?b=0<a.length?Da(a[0]):"":/^\W/.test(a)||(b=Da(a));return b}function ad(a,b){for(;b&&b!=a.b&&!Va(b,"ac-row");)b=b.parentNode;return b?Fa(a.h,b):-1}
+l.xa=function(a){var b=ad(this,a.target);0<=b&&V(this,{type:Jc,C:this.c[b].id});a.stopPropagation()};l.za=function(a){a.stopPropagation();a.preventDefault()};l.Aa=function(a){a=ad(this,a.target);0<=a&&!(300>ha()-this.J)&&V(this,{type:Ic,C:this.c[a].id})};var bd=E("iPhone")&&!E("iPod")&&!E("iPad")||E("iPod"),cd=E("iPad");!E("Android")||ib()||E("Firefox")||gb();ib();function dd(a,b,c,d){y.call(this);d=d||150;this.c=null!=c?c:!0;this.i=a||",;";this.v=this.i.substring(0,1);a=this.c?"[\\s"+this.i+"]+":"[\\s]+";this.o=new RegExp("^"+a+"|"+a+"$","g");this.S=new RegExp("\\s*["+this.i+"]$");this.m=b||"";this.D=this.c;this.f=0<d?new Fc(d):null;this.b=new cc(this);this.h=new cc(this);this.l=new jc;this.j=-1}v(dd,y);var ed=(bd||cd)&&!N("533.17.9");l=dd.prototype;l.g=null;l.W="";l.A=!1;l.Y=!1;l.R=function(a){this.g.value=a};
+l.va=function(a){for(var b=0;b<arguments.length;b++){var c=arguments[b];ba(c)&&1==c.nodeType&&Jb(c,"haspopup",!0);this.b.f(c,"focus",this.$);this.b.f(c,"blur",this.wa);if(!this.g&&(this.h.f(c,"keydown",this.Ca),ba(c)&&1==c.nodeType)){var d;a:{var e=Q(c);try{d=e&&e.activeElement;break a}catch(f){}d=null}d==c&&fd(this,c)}}};
+function gd(a,b){switch(b.keyCode){case 40:if(a.a.c.l){Qc(a.a);b.preventDefault();return}if(!a.c){a.update(!0);b.preventDefault();return}break;case 38:if(a.a.c.l){a:for(var c=a.a,d=c.h,e=0;e<c.b.length;e++){if(d>c.a)d--;else break;if(c.B(d))break a}b.preventDefault();return}break;case 9:if(!a.a.c.l||b.l)a.a.u();else if(a.update(),Nc(a.a)&&a.D){b.preventDefault();return}break;case 13:if(a.a.c.l){if(a.update(),Nc(a.a)){b.preventDefault();b.stopPropagation();return}}else a.a.u();break;case 27:if(a.a.c.l){a.a.u();
+b.preventDefault();b.stopPropagation();return}break;case 229:if(!a.A){a.A||(a.b.f(a.g,"keyup",a.da),a.b.f(a.g,"keypress",a.ca),a.A=!0);return}}hd(a,b)}function hd(a,b){var c=a.c&&b.i&&-1!=a.i.indexOf(String.fromCharCode(b.i));c&&a.update();c&&Nc(a.a)&&b.preventDefault()}l.ya=function(){return!1};l.$=function(a){fd(this,a.target||null)};
+function fd(a,b){var c=a.h;pa(c.a,T);c.a={};a.a&&Oc(a.a);b!=a.g&&(a.g=b,a.f&&(c=a.f,c.h=!0,c.a||(c.a=c.b.setTimeout(c.j,c.c),c.m=ha()),a.b.f(a.f,Gc,a.ga)),a.W=a.g.value,kc(a.l,a.g),a.b.f(a.l,"key",a.ea),a.b.f(a.g,"mousedown",a.fa),J&&a.b.f(a.g,"keypress",a.ba))}l.wa=function(){ed?window.setTimeout(u(this.ha,this),0):this.ha()};
+l.ha=function(){if(this.g){this.b.i(this.l,"key",this.ea);qc(this.l);this.b.i(this.g,"keyup",this.ya);this.b.i(this.g,"mousedown",this.fa);J&&this.b.i(this.g,"keypress",this.ba);this.A&&id(this);this.g=null;if(this.f){var a=this.f;a.h=!1;a.a&&(a.b.clearTimeout(a.a),a.a=null);this.b.i(this.f,Gc,this.ga)}this.a&&Pc(this.a)}};l.ga=function(){this.update()};l.Ca=function(a){this.$(a)};l.ea=function(a){this.j=a.keyCode;this.a&&gd(this,a)};l.ca=function(){this.A&&229!=this.j&&id(this)};
+l.da=function(a){this.A&&(13==a.keyCode||77==a.keyCode&&a.ctrlKey)&&id(this)};l.fa=function(){};function id(a){a.A&&(a.A=!1,a.b.i(a.g,"keypress",a.ca),a.b.i(a.g,"keyup",a.da))}l.ba=function(a){hd(this,a)};
+l.update=function(a){if(this.g&&(a||this.g.value!=this.W)){if(a||!this.Y){var b;a=Lb(this.g)[0];b=this.g.value;a=Sc(this,b)[Rc(this,b,a)];b=this.o?String(a).replace(this.o,""):a;if(this.a&&(this.a.o=this.g,a=this.a,a.m!=b)){a.m=b;var c=a.v;b=a.m;var d=a.D,e=u(a.Ba,a),c=c.a,f;f=[];if(""!=b)for(var g=Da(b),g=new RegExp("(^|\\W+)"+g,"i"),h=0;h<c.length&&f.length<d;h++){var k=c[h];String(k).match(g)&&f.push(k)}0==f.length&&(f=mb(b,d,c));e(b,f);Oc(a)}}this.W=this.g.value}this.Y=!1};
+function Rc(a,b,c){a=Sc(a,b);if(c==b.length)return a.length-1;for(var d=b=0,e=0;d<a.length&&e<=c;d++)e+=a[d].length,b=d;return b}function Sc(a,b){if(!a.c)return[b];for(var c=String(b).split(""),d=[],e=[],f=0,g=!1;f<c.length;f++)a.m&&-1!=a.m.indexOf(c[f])?(g||(d.push(e.join("")),e.length=0),e.push(c[f]),g=!g):g||-1==a.i.indexOf(c[f])?e.push(c[f]):(e.push(c[f]),d.push(e.join("")),e.length=0);d.push(e.join(""));return d};function jd(a,b){var c=new lb(a),d=new Tc,e=new dd(null,null,!1),c=new Hc(c,d,e);e.a=c;e.va(b);return c};function kd(){var a=n.TYPES;ld(a);md(a);nd()}var od=["init"],Z=n;od[0]in Z||!Z.execScript||Z.execScript("var "+od[0]);for(var pd;od.length&&(pd=od.shift());)od.length||void 0===kd?Z[pd]?Z=Z[pd]:Z=Z[pd]={}:Z[pd]=kd;var Ta=function(){var a="";Ha(document.querySelectorAll("script"),function(b){b=b.getAttribute("src");var c=b.length;return"dossier.js"===b.slice(c-10)?(a=b.slice(0,c-10),!0):!1});return a}();
+function nd(){function a(a){a=Gb(a,function(a){return"TR"===a.nodeName});Wa(a,"hilite")}var b=document.querySelector("article.srcfile table");if(b){if(location.hash){var c=document.querySelector("tr > td a"+location.hash);c&&a(c)}S(window,"hashchange",function(){C(b.querySelectorAll("tr.hilite"),function(a){Ya(a,"hilite")});var c=b.querySelector("tr > td a:target");c&&a(c)})}}
+function ld(a){function b(){var a=c[e.value];a&&(window.location.href=Ta+a)}var c={},d=[];a.types&&C(a.types,function(a){qd(d,c,a)});a.modules&&C(a.modules,function(a){qd(d,c,a,!0)});a=document.querySelector("header form");S(a,"submit",function(a){a.preventDefault();a.stopPropagation();b();return!1});var e=a.querySelector("input");e.setAttribute("title","Search ("+(M?"⌘":"Ctrl+")+"E)");a=jd(d,e);a.D=20;S(a,"update",b);S(document.documentElement,"keydown",function(a){if(document.activeElement!==e&&
+69===a.keyCode&&(M?a.metaKey:a.ctrlKey))return e.focus(),a.preventDefault(),a.stopPropagation(),!1;document.activeElement===e&&27===a.keyCode&&e.blur()})}
+function qd(a,b,c,d,e){var f=c.name;e&&(f=e+(ta(e,")")?" ":".")+f);b[f]=c.href;a.push(f);d&&(f="("+f+")");d&&c.types&&C(c.types,function(c){qd(a,b,c,!1,f)});c.statics&&C(c.statics,function(d){var e=c.href+"#"+d;d=ta(f,")")?f+" "+d:-1===d.indexOf(".")?f+"."+d:f+d.slice(d.lastIndexOf("."));b[d]=e;a.push(d)});c.members&&C(c.members,function(d){b[f+"#"+d]=c.href+"#"+d;a.push(f+"#"+d)})}
+function md(a){function b(a){window.localStorage&&window.localStorage.setItem(a.id,a.checked?"closed":"open")}var c="";Ta?c=window.location.pathname.split("/").slice(Ta.split("/").length).join("/"):window.location.pathname&&"/"!==window.location.pathname&&(c=window.location.pathname.slice(window.location.pathname.lastIndexOf("/")+1));var d=yb("nav-types-view");d&&a.types&&d.appendChild(Sa(a.types,c,!1));(d=yb("nav-modules-view"))&&a.modules&&d.appendChild(Sa(a.modules,c,!0));a=document.querySelector("nav");
+S(a,"keydown",function(a){if(37===a.keyCode||39===a.keyCode||32===a.keyCode){var c=Gb(a.target,function(a){return"LABEL"===a.tagName});c&&(c=document.getElementById(c.getAttribute("for")))&&(32===a.keyCode?(c.checked=!c.checked,a.preventDefault()):c.checked=37===a.keyCode,b(c))}});S(a,["focus","blur"],function(a){if(a.target.classList.contains("nav-item")&&"LABEL"===a.target.parentNode.tagName){var b=a.target.parentNode;"focus"===a.type?b.classList.add("focused"):b.classList.remove("focused")}},!0);
+window.localStorage&&(C(a.querySelectorAll('input[type="checkbox"][id]'),function(a){var b=window.localStorage.getItem(a.id);a.checked=!t(b)||"closed"===b}),S(a,"change",function(a){b(a.target)}))};;init();})();
diff --git a/docs/enum_bot_ErrorCode.html b/docs/enum_bot_ErrorCode.html
index 69098d9..c2f43de 100644
--- a/docs/enum_bot_ErrorCode.html
+++ b/docs/enum_bot_ErrorCode.html
@@ -1,2 +1,3 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>bot.ErrorCode</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum bot.ErrorCode</h1><a class="source" href="source/lib/atoms/error.js.src.html#l31">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Error codes from the WebDriver wire protocol:
- http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="bot.ErrorCode.ELEMENT_NOT_SELECTABLE">ELEMENT_NOT_SELECTABLE</a><dt><a class="enum member" name="bot.ErrorCode.ELEMENT_NOT_VISIBLE">ELEMENT_NOT_VISIBLE</a><dt><a class="enum member" name="bot.ErrorCode.IME_ENGINE_ACTIVATION_FAILED">IME_ENGINE_ACTIVATION_FAILED</a><dt><a class="enum member" name="bot.ErrorCode.IME_NOT_AVAILABLE">IME_NOT_AVAILABLE</a><dt><a class="enum member" name="bot.ErrorCode.INVALID_COOKIE_DOMAIN">INVALID_COOKIE_DOMAIN</a><dt><a class="enum member" name="bot.ErrorCode.INVALID_ELEMENT_COORDINATES">INVALID_ELEMENT_COORDINATES</a><dt><a class="enum member" name="bot.ErrorCode.INVALID_ELEMENT_STATE">INVALID_ELEMENT_STATE</a><dt><a class="enum member" name="bot.ErrorCode.INVALID_SELECTOR_ERROR">INVALID_SELECTOR_ERROR</a><dt><a class="enum member" name="bot.ErrorCode.INVALID_XPATH_SELECTOR">INVALID_XPATH_SELECTOR</a><dt><a class="enum member" name="bot.ErrorCode.INVALID_XPATH_SELECTOR_RETURN_TYPE">INVALID_XPATH_SELECTOR_RETURN_TYPE</a><dt><a class="enum member" name="bot.ErrorCode.JAVASCRIPT_ERROR">JAVASCRIPT_ERROR</a><dt><a class="enum member" name="bot.ErrorCode.METHOD_NOT_ALLOWED">METHOD_NOT_ALLOWED</a><dt><a class="enum member" name="bot.ErrorCode.MODAL_DIALOG_OPENED">MODAL_DIALOG_OPENED</a><dt><a class="enum member" name="bot.ErrorCode.MOVE_TARGET_OUT_OF_BOUNDS">MOVE_TARGET_OUT_OF_BOUNDS</a><dt><a class="enum member" name="bot.ErrorCode.NO_MODAL_DIALOG_OPEN">NO_MODAL_DIALOG_OPEN</a><dt><a class="enum member" name="bot.ErrorCode.NO_SUCH_ELEMENT">NO_SUCH_ELEMENT</a><dt><a class="enum member" name="bot.ErrorCode.NO_SUCH_FRAME">NO_SUCH_FRAME</a><dt><a class="enum member" name="bot.ErrorCode.NO_SUCH_WINDOW">NO_SUCH_WINDOW</a><dt><a class="enum member" name="bot.ErrorCode.SCRIPT_TIMEOUT">SCRIPT_TIMEOUT</a><dt><a class="enum member" name="bot.ErrorCode.SESSION_NOT_CREATED">SESSION_NOT_CREATED</a><dt><a class="enum member" name="bot.ErrorCode.SQL_DATABASE_ERROR">SQL_DATABASE_ERROR</a><dt><a class="enum member" name="bot.ErrorCode.STALE_ELEMENT_REFERENCE">STALE_ELEMENT_REFERENCE</a><dt><a class="enum member" name="bot.ErrorCode.SUCCESS">SUCCESS</a><dt><a class="enum member" name="bot.ErrorCode.TIMEOUT">TIMEOUT</a><dt><a class="enum member" name="bot.ErrorCode.UNABLE_TO_SET_COOKIE">UNABLE_TO_SET_COOKIE</a><dt><a class="enum member" name="bot.ErrorCode.UNKNOWN_COMMAND">UNKNOWN_COMMAND</a><dt><a class="enum member" name="bot.ErrorCode.UNKNOWN_ERROR">UNKNOWN_ERROR</a><dt><a class="enum member" name="bot.ErrorCode.UNSUPPORTED_OPERATION">UNSUPPORTED_OPERATION</a><dt><a class="enum member" name="bot.ErrorCode.XPATH_LOOKUP_ERROR">XPATH_LOOKUP_ERROR</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>ErrorCode</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_bot.html">bot</a></div><div class="codelink"><a href="source/lib/atoms/error.js.src.html#l33">View Source</a></div><h1>enum ErrorCode</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl><p>Error codes from the Selenium WebDriver protocol:
+https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#response-status-codes</p>
+<h2>Values and Descriptions</h2><div id="ELEMENT_NOT_SELECTABLE" class="property"><dl><dt>ELEMENT_NOT_SELECTABLE</dl></div><div id="ELEMENT_NOT_VISIBLE" class="property"><dl><dt>ELEMENT_NOT_VISIBLE</dl></div><div id="IME_ENGINE_ACTIVATION_FAILED" class="property"><dl><dt>IME_ENGINE_ACTIVATION_FAILED</dl></div><div id="IME_NOT_AVAILABLE" class="property"><dl><dt>IME_NOT_AVAILABLE</dl></div><div id="INVALID_COOKIE_DOMAIN" class="property"><dl><dt>INVALID_COOKIE_DOMAIN</dl></div><div id="INVALID_ELEMENT_COORDINATES" class="property"><dl><dt>INVALID_ELEMENT_COORDINATES</dl></div><div id="INVALID_ELEMENT_STATE" class="property"><dl><dt>INVALID_ELEMENT_STATE</dl></div><div id="INVALID_SELECTOR_ERROR" class="property"><dl><dt>INVALID_SELECTOR_ERROR</dl></div><div id="INVALID_XPATH_SELECTOR" class="property"><dl><dt>INVALID_XPATH_SELECTOR</dl></div><div id="INVALID_XPATH_SELECTOR_RETURN_TYPE" class="property"><dl><dt>INVALID_XPATH_SELECTOR_RETURN_TYPE</dl></div><div id="JAVASCRIPT_ERROR" class="property"><dl><dt>JAVASCRIPT_ERROR</dl></div><div id="METHOD_NOT_ALLOWED" class="property"><dl><dt>METHOD_NOT_ALLOWED</dl></div><div id="MOVE_TARGET_OUT_OF_BOUNDS" class="property"><dl><dt>MOVE_TARGET_OUT_OF_BOUNDS</dl></div><div id="NO_SUCH_ALERT" class="property"><dl><dt>NO_SUCH_ALERT</dl></div><div id="NO_SUCH_ELEMENT" class="property"><dl><dt>NO_SUCH_ELEMENT</dl></div><div id="NO_SUCH_FRAME" class="property"><dl><dt>NO_SUCH_FRAME</dl></div><div id="NO_SUCH_WINDOW" class="property"><dl><dt>NO_SUCH_WINDOW</dl></div><div id="SCRIPT_TIMEOUT" class="property"><dl><dt>SCRIPT_TIMEOUT</dl></div><div id="SESSION_NOT_CREATED" class="property"><dl><dt>SESSION_NOT_CREATED</dl></div><div id="SQL_DATABASE_ERROR" class="property"><dl><dt>SQL_DATABASE_ERROR</dl></div><div id="STALE_ELEMENT_REFERENCE" class="property"><dl><dt>STALE_ELEMENT_REFERENCE</dl></div><div id="SUCCESS" class="property"><dl><dt>SUCCESS</dl></div><div id="TIMEOUT" class="property"><dl><dt>TIMEOUT</dl></div><div id="UNABLE_TO_SET_COOKIE" class="property"><dl><dt>UNABLE_TO_SET_COOKIE</dl></div><div id="UNEXPECTED_ALERT_OPEN" class="property"><dl><dt>UNEXPECTED_ALERT_OPEN</dl></div><div id="UNKNOWN_COMMAND" class="property"><dl><dt>UNKNOWN_COMMAND</dl></div><div id="UNKNOWN_ERROR" class="property"><dl><dt>UNKNOWN_ERROR</dl></div><div id="UNSUPPORTED_OPERATION" class="property"><dl><dt>UNSUPPORTED_OPERATION</dl></div><div id="XPATH_LOOKUP_ERROR" class="property"><dl><dt>XPATH_LOOKUP_ERROR</dl></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>
\ No newline at end of file
diff --git a/docs/enum_bot_Error_State.html b/docs/enum_bot_Error_State.html
index 49054c1..9038563 100644
--- a/docs/enum_bot_Error_State.html
+++ b/docs/enum_bot_Error_State.html
@@ -1 +1,2 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>bot.Error.State</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum bot.Error.State</h1><a class="source" href="source/lib/atoms/error.js.src.html#l123">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Status strings enumerated in the W3C WebDriver working draft.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="bot.Error.State.ELEMENT_NOT_SELECTABLE">ELEMENT_NOT_SELECTABLE</a><dt><a class="enum member" name="bot.Error.State.ELEMENT_NOT_VISIBLE">ELEMENT_NOT_VISIBLE</a><dt><a class="enum member" name="bot.Error.State.IME_ENGINE_ACTIVATION_FAILED">IME_ENGINE_ACTIVATION_FAILED</a><dt><a class="enum member" name="bot.Error.State.IME_NOT_AVAILABLE">IME_NOT_AVAILABLE</a><dt><a class="enum member" name="bot.Error.State.INVALID_COOKIE_DOMAIN">INVALID_COOKIE_DOMAIN</a><dt><a class="enum member" name="bot.Error.State.INVALID_ELEMENT_COORDINATES">INVALID_ELEMENT_COORDINATES</a><dt><a class="enum member" name="bot.Error.State.INVALID_ELEMENT_STATE">INVALID_ELEMENT_STATE</a><dt><a class="enum member" name="bot.Error.State.INVALID_SELECTOR">INVALID_SELECTOR</a><dt><a class="enum member" name="bot.Error.State.JAVASCRIPT_ERROR">JAVASCRIPT_ERROR</a><dt><a class="enum member" name="bot.Error.State.MOVE_TARGET_OUT_OF_BOUNDS">MOVE_TARGET_OUT_OF_BOUNDS</a><dt><a class="enum member" name="bot.Error.State.NO_SUCH_ALERT">NO_SUCH_ALERT</a><dt><a class="enum member" name="bot.Error.State.NO_SUCH_DOM">NO_SUCH_DOM</a><dt><a class="enum member" name="bot.Error.State.NO_SUCH_ELEMENT">NO_SUCH_ELEMENT</a><dt><a class="enum member" name="bot.Error.State.NO_SUCH_FRAME">NO_SUCH_FRAME</a><dt><a class="enum member" name="bot.Error.State.NO_SUCH_WINDOW">NO_SUCH_WINDOW</a><dt><a class="enum member" name="bot.Error.State.SCRIPT_TIMEOUT">SCRIPT_TIMEOUT</a><dt><a class="enum member" name="bot.Error.State.SESSION_NOT_CREATED">SESSION_NOT_CREATED</a><dt><a class="enum member" name="bot.Error.State.STALE_ELEMENT_REFERENCE">STALE_ELEMENT_REFERENCE</a><dt><a class="enum member" name="bot.Error.State.SUCCESS">SUCCESS</a><dt><a class="enum member" name="bot.Error.State.TIMEOUT">TIMEOUT</a><dt><a class="enum member" name="bot.Error.State.UNABLE_TO_SET_COOKIE">UNABLE_TO_SET_COOKIE</a><dt><a class="enum member" name="bot.Error.State.UNEXPECTED_ALERT_OPEN">UNEXPECTED_ALERT_OPEN</a><dt><a class="enum member" name="bot.Error.State.UNKNOWN_COMMAND">UNKNOWN_COMMAND</a><dt><a class="enum member" name="bot.Error.State.UNKNOWN_ERROR">UNKNOWN_ERROR</a><dt><a class="enum member" name="bot.Error.State.UNSUPPORTED_OPERATION">UNSUPPORTED_OPERATION</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>Error.State</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_bot.html">bot</a></div><div class="codelink"><a href="source/lib/atoms/error.js.src.html#l122">View Source</a></div><h1>enum Error.State</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl><p>Status strings enumerated in the W3C WebDriver protocol.</p>
+<h2>Values and Descriptions</h2><div id="ELEMENT_NOT_SELECTABLE" class="property"><dl><dt>ELEMENT_NOT_SELECTABLE</dl></div><div id="ELEMENT_NOT_VISIBLE" class="property"><dl><dt>ELEMENT_NOT_VISIBLE</dl></div><div id="INVALID_ARGUMENT" class="property"><dl><dt>INVALID_ARGUMENT</dl></div><div id="INVALID_COOKIE_DOMAIN" class="property"><dl><dt>INVALID_COOKIE_DOMAIN</dl></div><div id="INVALID_ELEMENT_COORDINATES" class="property"><dl><dt>INVALID_ELEMENT_COORDINATES</dl></div><div id="INVALID_ELEMENT_STATE" class="property"><dl><dt>INVALID_ELEMENT_STATE</dl></div><div id="INVALID_SELECTOR" class="property"><dl><dt>INVALID_SELECTOR</dl></div><div id="INVALID_SESSION_ID" class="property"><dl><dt>INVALID_SESSION_ID</dl></div><div id="JAVASCRIPT_ERROR" class="property"><dl><dt>JAVASCRIPT_ERROR</dl></div><div id="MOVE_TARGET_OUT_OF_BOUNDS" class="property"><dl><dt>MOVE_TARGET_OUT_OF_BOUNDS</dl></div><div id="NO_SUCH_ALERT" class="property"><dl><dt>NO_SUCH_ALERT</dl></div><div id="NO_SUCH_ELEMENT" class="property"><dl><dt>NO_SUCH_ELEMENT</dl></div><div id="NO_SUCH_FRAME" class="property"><dl><dt>NO_SUCH_FRAME</dl></div><div id="NO_SUCH_WINDOW" class="property"><dl><dt>NO_SUCH_WINDOW</dl></div><div id="SCRIPT_TIMEOUT" class="property"><dl><dt>SCRIPT_TIMEOUT</dl></div><div id="SESSION_NOT_CREATED" class="property"><dl><dt>SESSION_NOT_CREATED</dl></div><div id="STALE_ELEMENT_REFERENCE" class="property"><dl><dt>STALE_ELEMENT_REFERENCE</dl></div><div id="TIMEOUT" class="property"><dl><dt>TIMEOUT</dl></div><div id="UNABLE_TO_SET_COOKIE" class="property"><dl><dt>UNABLE_TO_SET_COOKIE</dl></div><div id="UNEXPECTED_ALERT_OPEN" class="property"><dl><dt>UNEXPECTED_ALERT_OPEN</dl></div><div id="UNKNOWN_COMMAND" class="property"><dl><dt>UNKNOWN_COMMAND</dl></div><div id="UNKNOWN_ERROR" class="property"><dl><dt>UNKNOWN_ERROR</dl></div><div id="UNKNOWN_METHOD" class="property"><dl><dt>UNKNOWN_METHOD</dl></div><div id="UNSUPPORTED_OPERATION" class="property"><dl><dt>UNSUPPORTED_OPERATION</dl></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>
\ No newline at end of file
diff --git a/docs/enum_goog_Disposable_MonitoringMode.html b/docs/enum_goog_Disposable_MonitoringMode.html
new file mode 100644
index 0000000..14cbf04
--- /dev/null
+++ b/docs/enum_goog_Disposable_MonitoringMode.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.Disposable.MonitoringMode</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.Disposable.MonitoringMode</h1><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l56">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.Disposable.MonitoringMode.INTERACTIVE">INTERACTIVE</a><dd>INTERACTIVE mode can be switched on and off on the fly without producing
+ errors. It also doesn't warn if the disposable objects don't call the
+ <code >goog.Disposable</code> base constructor.<dt><a class="enum member" name="goog.Disposable.MonitoringMode.OFF">OFF</a><dd>No monitoring.<dt><a class="enum member" name="goog.Disposable.MonitoringMode.PERMANENT">PERMANENT</a><dd>Creating and disposing the goog.Disposable instances is monitored. All
+ disposable objects need to call the <code >goog.Disposable</code> base
+ constructor. The PERMANENT mode must be switched on before creating any
+ goog.Disposable instances.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_dom_BrowserFeature.html b/docs/enum_goog_dom_BrowserFeature.html
new file mode 100644
index 0000000..9aa63db
--- /dev/null
+++ b/docs/enum_goog_dom_BrowserFeature.html
@@ -0,0 +1,8 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.dom.BrowserFeature</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.dom.BrowserFeature</h1><a class="source" href="source/lib/goog/dom/browserfeature.js.src.html#l30">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></dl></header><section><p>Enum of browser capabilities.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.dom.BrowserFeature.CAN_ADD_NAME_OR_TYPE_ATTRIBUTES">CAN_ADD_NAME_OR_TYPE_ATTRIBUTES</a><dd>Whether attributes 'name' and 'type' can be added to an element after it's
+ created. False in Internet Explorer prior to version 9.<dt><a class="enum member" name="goog.dom.BrowserFeature.CAN_USE_CHILDREN_ATTRIBUTE">CAN_USE_CHILDREN_ATTRIBUTE</a><dd>Whether we can use element.children to access an element's Element
+ children. Available since Gecko 1.9.1, IE 9. (IE<9 also includes comment
+ nodes in the collection.)<dt><a class="enum member" name="goog.dom.BrowserFeature.CAN_USE_INNER_TEXT">CAN_USE_INNER_TEXT</a><dd>Opera, Safari 3, and Internet Explorer 9 all support innerText but they
+ include text nodes in script and style tags. Not document-mode-dependent.<dt><a class="enum member" name="goog.dom.BrowserFeature.CAN_USE_PARENT_ELEMENT_PROPERTY">CAN_USE_PARENT_ELEMENT_PROPERTY</a><dd>MSIE, Opera, and Safari>=4 support element.parentElement to access an
+ element's parent if it is an Element.<dt><a class="enum member" name="goog.dom.BrowserFeature.INNER_HTML_NEEDS_SCOPED_ELEMENT">INNER_HTML_NEEDS_SCOPED_ELEMENT</a><dd>Whether NoScope elements need a scoped element written before them in
+ innerHTML.
+ MSDN: http://msdn.microsoft.com/en-us/library/ms533897(VS.85).aspx#1<dt><a class="enum member" name="goog.dom.BrowserFeature.LEGACY_IE_RANGES">LEGACY_IE_RANGES</a><dd>Whether we use legacy IE range API.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_dom_NodeType.html b/docs/enum_goog_dom_NodeType.html
new file mode 100644
index 0000000..d906098
--- /dev/null
+++ b/docs/enum_goog_dom_NodeType.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.dom.NodeType</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.dom.NodeType</h1><a class="source" href="source/lib/goog/dom/nodetype.js.src.html#l35">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Constants for the nodeType attribute in the Node interface.
+
+ These constants match those specified in the Node interface. These are
+ usually present on the Node object in recent browsers, but not in older
+ browsers (specifically, early IEs) and thus are given here.
+
+ In some browsers (early IEs), these are not defined on the Node object,
+ so they are provided here.
+
+ See http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1950641247<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.dom.NodeType.ATTRIBUTE">ATTRIBUTE</a><dt><a class="enum member" name="goog.dom.NodeType.CDATA_SECTION">CDATA_SECTION</a><dt><a class="enum member" name="goog.dom.NodeType.COMMENT">COMMENT</a><dt><a class="enum member" name="goog.dom.NodeType.DOCUMENT">DOCUMENT</a><dt><a class="enum member" name="goog.dom.NodeType.DOCUMENT_FRAGMENT">DOCUMENT_FRAGMENT</a><dt><a class="enum member" name="goog.dom.NodeType.DOCUMENT_TYPE">DOCUMENT_TYPE</a><dt><a class="enum member" name="goog.dom.NodeType.ELEMENT">ELEMENT</a><dt><a class="enum member" name="goog.dom.NodeType.ENTITY">ENTITY</a><dt><a class="enum member" name="goog.dom.NodeType.ENTITY_REFERENCE">ENTITY_REFERENCE</a><dt><a class="enum member" name="goog.dom.NodeType.NOTATION">NOTATION</a><dt><a class="enum member" name="goog.dom.NodeType.PROCESSING_INSTRUCTION">PROCESSING_INSTRUCTION</a><dt><a class="enum member" name="goog.dom.NodeType.TEXT">TEXT</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_dom_TagName.html b/docs/enum_goog_dom_TagName.html
new file mode 100644
index 0000000..7e46c2d
--- /dev/null
+++ b/docs/enum_goog_dom_TagName.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.dom.TagName</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.dom.TagName</h1><a class="source" href="source/lib/goog/dom/tagname.js.src.html#l33">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Enum of all html tag names specified by the W3C HTML4.01 and HTML5
+ specifications.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.dom.TagName.A">A</a><dt><a class="enum member" name="goog.dom.TagName.ABBR">ABBR</a><dt><a class="enum member" name="goog.dom.TagName.ACRONYM">ACRONYM</a><dt><a class="enum member" name="goog.dom.TagName.ADDRESS">ADDRESS</a><dt><a class="enum member" name="goog.dom.TagName.APPLET">APPLET</a><dt><a class="enum member" name="goog.dom.TagName.AREA">AREA</a><dt><a class="enum member" name="goog.dom.TagName.ARTICLE">ARTICLE</a><dt><a class="enum member" name="goog.dom.TagName.ASIDE">ASIDE</a><dt><a class="enum member" name="goog.dom.TagName.AUDIO">AUDIO</a><dt><a class="enum member" name="goog.dom.TagName.B">B</a><dt><a class="enum member" name="goog.dom.TagName.BASE">BASE</a><dt><a class="enum member" name="goog.dom.TagName.BASEFONT">BASEFONT</a><dt><a class="enum member" name="goog.dom.TagName.BDI">BDI</a><dt><a class="enum member" name="goog.dom.TagName.BDO">BDO</a><dt><a class="enum member" name="goog.dom.TagName.BIG">BIG</a><dt><a class="enum member" name="goog.dom.TagName.BLOCKQUOTE">BLOCKQUOTE</a><dt><a class="enum member" name="goog.dom.TagName.BODY">BODY</a><dt><a class="enum member" name="goog.dom.TagName.BR">BR</a><dt><a class="enum member" name="goog.dom.TagName.BUTTON">BUTTON</a><dt><a class="enum member" name="goog.dom.TagName.CANVAS">CANVAS</a><dt><a class="enum member" name="goog.dom.TagName.CAPTION">CAPTION</a><dt><a class="enum member" name="goog.dom.TagName.CENTER">CENTER</a><dt><a class="enum member" name="goog.dom.TagName.CITE">CITE</a><dt><a class="enum member" name="goog.dom.TagName.CODE">CODE</a><dt><a class="enum member" name="goog.dom.TagName.COL">COL</a><dt><a class="enum member" name="goog.dom.TagName.COLGROUP">COLGROUP</a><dt><a class="enum member" name="goog.dom.TagName.COMMAND">COMMAND</a><dt><a class="enum member" name="goog.dom.TagName.DATA">DATA</a><dt><a class="enum member" name="goog.dom.TagName.DATALIST">DATALIST</a><dt><a class="enum member" name="goog.dom.TagName.DD">DD</a><dt><a class="enum member" name="goog.dom.TagName.DEL">DEL</a><dt><a class="enum member" name="goog.dom.TagName.DETAILS">DETAILS</a><dt><a class="enum member" name="goog.dom.TagName.DFN">DFN</a><dt><a class="enum member" name="goog.dom.TagName.DIALOG">DIALOG</a><dt><a class="enum member" name="goog.dom.TagName.DIR">DIR</a><dt><a class="enum member" name="goog.dom.TagName.DIV">DIV</a><dt><a class="enum member" name="goog.dom.TagName.DL">DL</a><dt><a class="enum member" name="goog.dom.TagName.DT">DT</a><dt><a class="enum member" name="goog.dom.TagName.EM">EM</a><dt><a class="enum member" name="goog.dom.TagName.EMBED">EMBED</a><dt><a class="enum member" name="goog.dom.TagName.FIELDSET">FIELDSET</a><dt><a class="enum member" name="goog.dom.TagName.FIGCAPTION">FIGCAPTION</a><dt><a class="enum member" name="goog.dom.TagName.FIGURE">FIGURE</a><dt><a class="enum member" name="goog.dom.TagName.FONT">FONT</a><dt><a class="enum member" name="goog.dom.TagName.FOOTER">FOOTER</a><dt><a class="enum member" name="goog.dom.TagName.FORM">FORM</a><dt><a class="enum member" name="goog.dom.TagName.FRAME">FRAME</a><dt><a class="enum member" name="goog.dom.TagName.FRAMESET">FRAMESET</a><dt><a class="enum member" name="goog.dom.TagName.H1">H1</a><dt><a class="enum member" name="goog.dom.TagName.H2">H2</a><dt><a class="enum member" name="goog.dom.TagName.H3">H3</a><dt><a class="enum member" name="goog.dom.TagName.H4">H4</a><dt><a class="enum member" name="goog.dom.TagName.H5">H5</a><dt><a class="enum member" name="goog.dom.TagName.H6">H6</a><dt><a class="enum member" name="goog.dom.TagName.HEAD">HEAD</a><dt><a class="enum member" name="goog.dom.TagName.HEADER">HEADER</a><dt><a class="enum member" name="goog.dom.TagName.HGROUP">HGROUP</a><dt><a class="enum member" name="goog.dom.TagName.HR">HR</a><dt><a class="enum member" name="goog.dom.TagName.HTML">HTML</a><dt><a class="enum member" name="goog.dom.TagName.I">I</a><dt><a class="enum member" name="goog.dom.TagName.IFRAME">IFRAME</a><dt><a class="enum member" name="goog.dom.TagName.IMG">IMG</a><dt><a class="enum member" name="goog.dom.TagName.INPUT">INPUT</a><dt><a class="enum member" name="goog.dom.TagName.INS">INS</a><dt><a class="enum member" name="goog.dom.TagName.ISINDEX">ISINDEX</a><dt><a class="enum member" name="goog.dom.TagName.KBD">KBD</a><dt><a class="enum member" name="goog.dom.TagName.KEYGEN">KEYGEN</a><dt><a class="enum member" name="goog.dom.TagName.LABEL">LABEL</a><dt><a class="enum member" name="goog.dom.TagName.LEGEND">LEGEND</a><dt><a class="enum member" name="goog.dom.TagName.LI">LI</a><dt><a class="enum member" name="goog.dom.TagName.LINK">LINK</a><dt><a class="enum member" name="goog.dom.TagName.MAP">MAP</a><dt><a class="enum member" name="goog.dom.TagName.MARK">MARK</a><dt><a class="enum member" name="goog.dom.TagName.MATH">MATH</a><dt><a class="enum member" name="goog.dom.TagName.MENU">MENU</a><dt><a class="enum member" name="goog.dom.TagName.META">META</a><dt><a class="enum member" name="goog.dom.TagName.METER">METER</a><dt><a class="enum member" name="goog.dom.TagName.NAV">NAV</a><dt><a class="enum member" name="goog.dom.TagName.NOFRAMES">NOFRAMES</a><dt><a class="enum member" name="goog.dom.TagName.NOSCRIPT">NOSCRIPT</a><dt><a class="enum member" name="goog.dom.TagName.OBJECT">OBJECT</a><dt><a class="enum member" name="goog.dom.TagName.OL">OL</a><dt><a class="enum member" name="goog.dom.TagName.OPTGROUP">OPTGROUP</a><dt><a class="enum member" name="goog.dom.TagName.OPTION">OPTION</a><dt><a class="enum member" name="goog.dom.TagName.OUTPUT">OUTPUT</a><dt><a class="enum member" name="goog.dom.TagName.P">P</a><dt><a class="enum member" name="goog.dom.TagName.PARAM">PARAM</a><dt><a class="enum member" name="goog.dom.TagName.PRE">PRE</a><dt><a class="enum member" name="goog.dom.TagName.PROGRESS">PROGRESS</a><dt><a class="enum member" name="goog.dom.TagName.Q">Q</a><dt><a class="enum member" name="goog.dom.TagName.RP">RP</a><dt><a class="enum member" name="goog.dom.TagName.RT">RT</a><dt><a class="enum member" name="goog.dom.TagName.RUBY">RUBY</a><dt><a class="enum member" name="goog.dom.TagName.S">S</a><dt><a class="enum member" name="goog.dom.TagName.SAMP">SAMP</a><dt><a class="enum member" name="goog.dom.TagName.SCRIPT">SCRIPT</a><dt><a class="enum member" name="goog.dom.TagName.SECTION">SECTION</a><dt><a class="enum member" name="goog.dom.TagName.SELECT">SELECT</a><dt><a class="enum member" name="goog.dom.TagName.SMALL">SMALL</a><dt><a class="enum member" name="goog.dom.TagName.SOURCE">SOURCE</a><dt><a class="enum member" name="goog.dom.TagName.SPAN">SPAN</a><dt><a class="enum member" name="goog.dom.TagName.STRIKE">STRIKE</a><dt><a class="enum member" name="goog.dom.TagName.STRONG">STRONG</a><dt><a class="enum member" name="goog.dom.TagName.STYLE">STYLE</a><dt><a class="enum member" name="goog.dom.TagName.SUB">SUB</a><dt><a class="enum member" name="goog.dom.TagName.SUMMARY">SUMMARY</a><dt><a class="enum member" name="goog.dom.TagName.SUP">SUP</a><dt><a class="enum member" name="goog.dom.TagName.SVG">SVG</a><dt><a class="enum member" name="goog.dom.TagName.TABLE">TABLE</a><dt><a class="enum member" name="goog.dom.TagName.TBODY">TBODY</a><dt><a class="enum member" name="goog.dom.TagName.TD">TD</a><dt><a class="enum member" name="goog.dom.TagName.TEXTAREA">TEXTAREA</a><dt><a class="enum member" name="goog.dom.TagName.TFOOT">TFOOT</a><dt><a class="enum member" name="goog.dom.TagName.TH">TH</a><dt><a class="enum member" name="goog.dom.TagName.THEAD">THEAD</a><dt><a class="enum member" name="goog.dom.TagName.TIME">TIME</a><dt><a class="enum member" name="goog.dom.TagName.TITLE">TITLE</a><dt><a class="enum member" name="goog.dom.TagName.TR">TR</a><dt><a class="enum member" name="goog.dom.TagName.TRACK">TRACK</a><dt><a class="enum member" name="goog.dom.TagName.TT">TT</a><dt><a class="enum member" name="goog.dom.TagName.U">U</a><dt><a class="enum member" name="goog.dom.TagName.UL">UL</a><dt><a class="enum member" name="goog.dom.TagName.VAR">VAR</a><dt><a class="enum member" name="goog.dom.TagName.VIDEO">VIDEO</a><dt><a class="enum member" name="goog.dom.TagName.WBR">WBR</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_events_BrowserEvent_MouseButton.html b/docs/enum_goog_events_BrowserEvent_MouseButton.html
new file mode 100644
index 0000000..01bc09b
--- /dev/null
+++ b/docs/enum_goog_events_BrowserEvent_MouseButton.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.BrowserEvent.MouseButton</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.events.BrowserEvent.MouseButton</h1><a class="source" href="source/lib/goog/events/browserevent.js.src.html#l198">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Normalized button constants for the mouse.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.events.BrowserEvent.MouseButton.LEFT">LEFT</a><dt><a class="enum member" name="goog.events.BrowserEvent.MouseButton.MIDDLE">MIDDLE</a><dt><a class="enum member" name="goog.events.BrowserEvent.MouseButton.RIGHT">RIGHT</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_events_BrowserFeature.html b/docs/enum_goog_events_BrowserFeature.html
new file mode 100644
index 0000000..3bb8a01
--- /dev/null
+++ b/docs/enum_goog_events_BrowserFeature.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.BrowserFeature</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.events.BrowserFeature</h1><a class="source" href="source/lib/goog/events/browserfeature.js.src.html#l30">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></dl></header><section><p>Enum of browser capabilities.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.events.BrowserFeature.HAS_HTML5_NETWORK_EVENT_SUPPORT">HAS_HTML5_NETWORK_EVENT_SUPPORT</a><dd>Whether HTML5 network online/offline events are supported.<dt><a class="enum member" name="goog.events.BrowserFeature.HAS_NAVIGATOR_ONLINE_PROPERTY">HAS_NAVIGATOR_ONLINE_PROPERTY</a><dd>Whether the <code >navigator.onLine</code> property is supported.<dt><a class="enum member" name="goog.events.BrowserFeature.HAS_W3C_BUTTON">HAS_W3C_BUTTON</a><dd>Whether the button attribute of the event is W3C compliant.  False in
+ Internet Explorer prior to version 9; document-version dependent.<dt><a class="enum member" name="goog.events.BrowserFeature.HAS_W3C_EVENT_SUPPORT">HAS_W3C_EVENT_SUPPORT</a><dd>Whether the browser supports full W3C event model.<dt><a class="enum member" name="goog.events.BrowserFeature.HTML5_NETWORK_EVENTS_FIRE_ON_BODY">HTML5_NETWORK_EVENTS_FIRE_ON_BODY</a><dd>Whether HTML5 network events fire on document.body, or otherwise the
+ window.<dt><a class="enum member" name="goog.events.BrowserFeature.SET_KEY_CODE_TO_PREVENT_DEFAULT">SET_KEY_CODE_TO_PREVENT_DEFAULT</a><dd>To prevent default in IE7-8 for certain keydown events we need set the
+ keyCode to -1.<dt><a class="enum member" name="goog.events.BrowserFeature.TOUCH_ENABLED">TOUCH_ENABLED</a><dd>Whether touch is enabled in the browser.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_events_CaptureSimulationMode.html b/docs/enum_goog_events_CaptureSimulationMode.html
new file mode 100644
index 0000000..81b2ea6
--- /dev/null
+++ b/docs/enum_goog_events_CaptureSimulationMode.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.CaptureSimulationMode</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.events.CaptureSimulationMode</h1><a class="source" href="source/lib/goog/events/events.js.src.html#l111">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.events.CaptureSimulationMode.OFF_AND_FAIL">OFF_AND_FAIL</a><dd>Does not perform capture simulation. Will asserts in IE8- when you
+ add capture listeners.<dt><a class="enum member" name="goog.events.CaptureSimulationMode.OFF_AND_SILENT">OFF_AND_SILENT</a><dd>Does not perform capture simulation, silently ignore capture
+ listeners.<dt><a class="enum member" name="goog.events.CaptureSimulationMode.ON">ON</a><dd>Performs capture simulation.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_events_EventType.html b/docs/enum_goog_events_EventType.html
new file mode 100644
index 0000000..0315e7f
--- /dev/null
+++ b/docs/enum_goog_events_EventType.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.EventType</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.events.EventType</h1><a class="source" href="source/lib/goog/events/eventtype.js.src.html#l46">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Constants for event names.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.events.EventType.ANIMATIONEND">ANIMATIONEND</a><dt><a class="enum member" name="goog.events.EventType.ANIMATIONITERATION">ANIMATIONITERATION</a><dt><a class="enum member" name="goog.events.EventType.ANIMATIONSTART">ANIMATIONSTART</a><dt><a class="enum member" name="goog.events.EventType.BEFORECOPY">BEFORECOPY</a><dt><a class="enum member" name="goog.events.EventType.BEFORECUT">BEFORECUT</a><dt><a class="enum member" name="goog.events.EventType.BEFOREPASTE">BEFOREPASTE</a><dt><a class="enum member" name="goog.events.EventType.BEFOREUNLOAD">BEFOREUNLOAD</a><dt><a class="enum member" name="goog.events.EventType.BLUR">BLUR</a><dt><a class="enum member" name="goog.events.EventType.CHANGE">CHANGE</a><dt><a class="enum member" name="goog.events.EventType.CLICK">CLICK</a><dt><a class="enum member" name="goog.events.EventType.COMPOSITIONEND">COMPOSITIONEND</a><dt><a class="enum member" name="goog.events.EventType.COMPOSITIONSTART">COMPOSITIONSTART</a><dt><a class="enum member" name="goog.events.EventType.COMPOSITIONUPDATE">COMPOSITIONUPDATE</a><dt><a class="enum member" name="goog.events.EventType.CONNECT">CONNECT</a><dt><a class="enum member" name="goog.events.EventType.CONSOLEMESSAGE">CONSOLEMESSAGE</a><dt><a class="enum member" name="goog.events.EventType.CONTEXTMENU">CONTEXTMENU</a><dt><a class="enum member" name="goog.events.EventType.COPY">COPY</a><dt><a class="enum member" name="goog.events.EventType.CUT">CUT</a><dt><a class="enum member" name="goog.events.EventType.DBLCLICK">DBLCLICK</a><dt><a class="enum member" name="goog.events.EventType.DEACTIVATE">DEACTIVATE</a><dt><a class="enum member" name="goog.events.EventType.DOMATTRMODIFIED">DOMATTRMODIFIED</a><dt><a class="enum member" name="goog.events.EventType.DOMCHARACTERDATAMODIFIED">DOMCHARACTERDATAMODIFIED</a><dt><a class="enum member" name="goog.events.EventType.DOMCONTENTLOADED">DOMCONTENTLOADED</a><dt><a class="enum member" name="goog.events.EventType.DOMNODEINSERTED">DOMNODEINSERTED</a><dt><a class="enum member" name="goog.events.EventType.DOMNODEINSERTEDINTODOCUMENT">DOMNODEINSERTEDINTODOCUMENT</a><dt><a class="enum member" name="goog.events.EventType.DOMNODEREMOVED">DOMNODEREMOVED</a><dt><a class="enum member" name="goog.events.EventType.DOMNODEREMOVEDFROMDOCUMENT">DOMNODEREMOVEDFROMDOCUMENT</a><dt><a class="enum member" name="goog.events.EventType.DOMSUBTREEMODIFIED">DOMSUBTREEMODIFIED</a><dt><a class="enum member" name="goog.events.EventType.DRAG">DRAG</a><dt><a class="enum member" name="goog.events.EventType.DRAGEND">DRAGEND</a><dt><a class="enum member" name="goog.events.EventType.DRAGENTER">DRAGENTER</a><dt><a class="enum member" name="goog.events.EventType.DRAGLEAVE">DRAGLEAVE</a><dt><a class="enum member" name="goog.events.EventType.DRAGOVER">DRAGOVER</a><dt><a class="enum member" name="goog.events.EventType.DRAGSTART">DRAGSTART</a><dt><a class="enum member" name="goog.events.EventType.DROP">DROP</a><dt><a class="enum member" name="goog.events.EventType.ERROR">ERROR</a><dt><a class="enum member" name="goog.events.EventType.EXIT">EXIT</a><dt><a class="enum member" name="goog.events.EventType.FOCUS">FOCUS</a><dt><a class="enum member" name="goog.events.EventType.FOCUSIN">FOCUSIN</a><dt><a class="enum member" name="goog.events.EventType.FOCUSOUT">FOCUSOUT</a><dt><a class="enum member" name="goog.events.EventType.GOTPOINTERCAPTURE">GOTPOINTERCAPTURE</a><dt><a class="enum member" name="goog.events.EventType.HASHCHANGE">HASHCHANGE</a><dt><a class="enum member" name="goog.events.EventType.HELP">HELP</a><dt><a class="enum member" name="goog.events.EventType.INPUT">INPUT</a><dt><a class="enum member" name="goog.events.EventType.KEYDOWN">KEYDOWN</a><dt><a class="enum member" name="goog.events.EventType.KEYPRESS">KEYPRESS</a><dt><a class="enum member" name="goog.events.EventType.KEYUP">KEYUP</a><dt><a class="enum member" name="goog.events.EventType.LOAD">LOAD</a><dt><a class="enum member" name="goog.events.EventType.LOADABORT">LOADABORT</a><dt><a class="enum member" name="goog.events.EventType.LOADCOMMIT">LOADCOMMIT</a><dt><a class="enum member" name="goog.events.EventType.LOADREDIRECT">LOADREDIRECT</a><dt><a class="enum member" name="goog.events.EventType.LOADSTART">LOADSTART</a><dt><a class="enum member" name="goog.events.EventType.LOADSTOP">LOADSTOP</a><dt><a class="enum member" name="goog.events.EventType.LOSECAPTURE">LOSECAPTURE</a><dt><a class="enum member" name="goog.events.EventType.LOSTPOINTERCAPTURE">LOSTPOINTERCAPTURE</a><dt><a class="enum member" name="goog.events.EventType.MESSAGE">MESSAGE</a><dt><a class="enum member" name="goog.events.EventType.MOUSEDOWN">MOUSEDOWN</a><dt><a class="enum member" name="goog.events.EventType.MOUSEENTER">MOUSEENTER</a><dt><a class="enum member" name="goog.events.EventType.MOUSELEAVE">MOUSELEAVE</a><dt><a class="enum member" name="goog.events.EventType.MOUSEMOVE">MOUSEMOVE</a><dt><a class="enum member" name="goog.events.EventType.MOUSEOUT">MOUSEOUT</a><dt><a class="enum member" name="goog.events.EventType.MOUSEOVER">MOUSEOVER</a><dt><a class="enum member" name="goog.events.EventType.MOUSEUP">MOUSEUP</a><dt><a class="enum member" name="goog.events.EventType.MSGESTURECHANGE">MSGESTURECHANGE</a><dt><a class="enum member" name="goog.events.EventType.MSGESTUREEND">MSGESTUREEND</a><dt><a class="enum member" name="goog.events.EventType.MSGESTUREHOLD">MSGESTUREHOLD</a><dt><a class="enum member" name="goog.events.EventType.MSGESTURESTART">MSGESTURESTART</a><dt><a class="enum member" name="goog.events.EventType.MSGESTURETAP">MSGESTURETAP</a><dt><a class="enum member" name="goog.events.EventType.MSGOTPOINTERCAPTURE">MSGOTPOINTERCAPTURE</a><dt><a class="enum member" name="goog.events.EventType.MSINERTIASTART">MSINERTIASTART</a><dt><a class="enum member" name="goog.events.EventType.MSLOSTPOINTERCAPTURE">MSLOSTPOINTERCAPTURE</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTERCANCEL">MSPOINTERCANCEL</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTERDOWN">MSPOINTERDOWN</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTERENTER">MSPOINTERENTER</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTERHOVER">MSPOINTERHOVER</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTERLEAVE">MSPOINTERLEAVE</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTERMOVE">MSPOINTERMOVE</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTEROUT">MSPOINTEROUT</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTEROVER">MSPOINTEROVER</a><dt><a class="enum member" name="goog.events.EventType.MSPOINTERUP">MSPOINTERUP</a><dt><a class="enum member" name="goog.events.EventType.OFFLINE">OFFLINE</a><dt><a class="enum member" name="goog.events.EventType.ONLINE">ONLINE</a><dt><a class="enum member" name="goog.events.EventType.ORIENTATIONCHANGE">ORIENTATIONCHANGE</a><dt><a class="enum member" name="goog.events.EventType.PAGEHIDE">PAGEHIDE</a><dt><a class="enum member" name="goog.events.EventType.PAGESHOW">PAGESHOW</a><dt><a class="enum member" name="goog.events.EventType.PASTE">PASTE</a><dt><a class="enum member" name="goog.events.EventType.POINTERCANCEL">POINTERCANCEL</a><dt><a class="enum member" name="goog.events.EventType.POINTERDOWN">POINTERDOWN</a><dt><a class="enum member" name="goog.events.EventType.POINTERENTER">POINTERENTER</a><dt><a class="enum member" name="goog.events.EventType.POINTERLEAVE">POINTERLEAVE</a><dt><a class="enum member" name="goog.events.EventType.POINTERMOVE">POINTERMOVE</a><dt><a class="enum member" name="goog.events.EventType.POINTEROUT">POINTEROUT</a><dt><a class="enum member" name="goog.events.EventType.POINTEROVER">POINTEROVER</a><dt><a class="enum member" name="goog.events.EventType.POINTERUP">POINTERUP</a><dt><a class="enum member" name="goog.events.EventType.POPSTATE">POPSTATE</a><dt><a class="enum member" name="goog.events.EventType.PROPERTYCHANGE">PROPERTYCHANGE</a><dt><a class="enum member" name="goog.events.EventType.READYSTATECHANGE">READYSTATECHANGE</a><dt><a class="enum member" name="goog.events.EventType.RESIZE">RESIZE</a><dt><a class="enum member" name="goog.events.EventType.RESPONSIVE">RESPONSIVE</a><dt><a class="enum member" name="goog.events.EventType.RIGHTCLICK">RIGHTCLICK</a><dt><a class="enum member" name="goog.events.EventType.SCROLL">SCROLL</a><dt><a class="enum member" name="goog.events.EventType.SELECT">SELECT</a><dt><a class="enum member" name="goog.events.EventType.SELECTSTART">SELECTSTART</a><dt><a class="enum member" name="goog.events.EventType.SIZECHANGED">SIZECHANGED</a><dt><a class="enum member" name="goog.events.EventType.STORAGE">STORAGE</a><dt><a class="enum member" name="goog.events.EventType.SUBMIT">SUBMIT</a><dt><a class="enum member" name="goog.events.EventType.TEXTINPUT">TEXTINPUT</a><dt><a class="enum member" name="goog.events.EventType.TOUCHCANCEL">TOUCHCANCEL</a><dt><a class="enum member" name="goog.events.EventType.TOUCHEND">TOUCHEND</a><dt><a class="enum member" name="goog.events.EventType.TOUCHMOVE">TOUCHMOVE</a><dt><a class="enum member" name="goog.events.EventType.TOUCHSTART">TOUCHSTART</a><dt><a class="enum member" name="goog.events.EventType.TRANSITIONEND">TRANSITIONEND</a><dt><a class="enum member" name="goog.events.EventType.UNLOAD">UNLOAD</a><dt><a class="enum member" name="goog.events.EventType.UNRESPONSIVE">UNRESPONSIVE</a><dt><a class="enum member" name="goog.events.EventType.VISIBILITYCHANGE">VISIBILITYCHANGE</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_events_KeyCodes.html b/docs/enum_goog_events_KeyCodes.html
new file mode 100644
index 0000000..ffa4f95
--- /dev/null
+++ b/docs/enum_goog_events_KeyCodes.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.KeyCodes</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.events.KeyCodes</h1><a class="source" href="source/lib/goog/events/keycodes.js.src.html#l35">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Key codes for common characters.
+
+ This list is not localized and therefore some of the key codes are not
+ correct for non US keyboard layouts. See comments below.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.events.KeyCodes.A">A</a><dt><a class="enum member" name="goog.events.KeyCodes.ALT">ALT</a><dt><a class="enum member" name="goog.events.KeyCodes.APOSTROPHE">APOSTROPHE</a><dt><a class="enum member" name="goog.events.KeyCodes.B">B</a><dt><a class="enum member" name="goog.events.KeyCodes.BACKSLASH">BACKSLASH</a><dt><a class="enum member" name="goog.events.KeyCodes.BACKSPACE">BACKSPACE</a><dt><a class="enum member" name="goog.events.KeyCodes.C">C</a><dt><a class="enum member" name="goog.events.KeyCodes.CAPS_LOCK">CAPS_LOCK</a><dt><a class="enum member" name="goog.events.KeyCodes.CLOSE_SQUARE_BRACKET">CLOSE_SQUARE_BRACKET</a><dt><a class="enum member" name="goog.events.KeyCodes.COMMA">COMMA</a><dt><a class="enum member" name="goog.events.KeyCodes.CONTEXT_MENU">CONTEXT_MENU</a><dt><a class="enum member" name="goog.events.KeyCodes.CTRL">CTRL</a><dt><a class="enum member" name="goog.events.KeyCodes.D">D</a><dt><a class="enum member" name="goog.events.KeyCodes.DASH">DASH</a><dt><a class="enum member" name="goog.events.KeyCodes.DELETE">DELETE</a><dt><a class="enum member" name="goog.events.KeyCodes.DOWN">DOWN</a><dt><a class="enum member" name="goog.events.KeyCodes.E">E</a><dt><a class="enum member" name="goog.events.KeyCodes.EIGHT">EIGHT</a><dt><a class="enum member" name="goog.events.KeyCodes.END">END</a><dt><a class="enum member" name="goog.events.KeyCodes.ENTER">ENTER</a><dt><a class="enum member" name="goog.events.KeyCodes.EQUALS">EQUALS</a><dt><a class="enum member" name="goog.events.KeyCodes.ESC">ESC</a><dt><a class="enum member" name="goog.events.KeyCodes.F">F</a><dt><a class="enum member" name="goog.events.KeyCodes.F1">F1</a><dt><a class="enum member" name="goog.events.KeyCodes.F10">F10</a><dt><a class="enum member" name="goog.events.KeyCodes.F11">F11</a><dt><a class="enum member" name="goog.events.KeyCodes.F12">F12</a><dt><a class="enum member" name="goog.events.KeyCodes.F2">F2</a><dt><a class="enum member" name="goog.events.KeyCodes.F3">F3</a><dt><a class="enum member" name="goog.events.KeyCodes.F4">F4</a><dt><a class="enum member" name="goog.events.KeyCodes.F5">F5</a><dt><a class="enum member" name="goog.events.KeyCodes.F6">F6</a><dt><a class="enum member" name="goog.events.KeyCodes.F7">F7</a><dt><a class="enum member" name="goog.events.KeyCodes.F8">F8</a><dt><a class="enum member" name="goog.events.KeyCodes.F9">F9</a><dt><a class="enum member" name="goog.events.KeyCodes.FF_DASH">FF_DASH</a><dt><a class="enum member" name="goog.events.KeyCodes.FF_EQUALS">FF_EQUALS</a><dt><a class="enum member" name="goog.events.KeyCodes.FF_SEMICOLON">FF_SEMICOLON</a><dt><a class="enum member" name="goog.events.KeyCodes.FIRST_MEDIA_KEY">FIRST_MEDIA_KEY</a><dt><a class="enum member" name="goog.events.KeyCodes.FIVE">FIVE</a><dt><a class="enum member" name="goog.events.KeyCodes.FOUR">FOUR</a><dt><a class="enum member" name="goog.events.KeyCodes.G">G</a><dt><a class="enum member" name="goog.events.KeyCodes.H">H</a><dt><a class="enum member" name="goog.events.KeyCodes.HOME">HOME</a><dt><a class="enum member" name="goog.events.KeyCodes.I">I</a><dt><a class="enum member" name="goog.events.KeyCodes.INSERT">INSERT</a><dt><a class="enum member" name="goog.events.KeyCodes.J">J</a><dt><a class="enum member" name="goog.events.KeyCodes.K">K</a><dt><a class="enum member" name="goog.events.KeyCodes.L">L</a><dt><a class="enum member" name="goog.events.KeyCodes.LAST_MEDIA_KEY">LAST_MEDIA_KEY</a><dt><a class="enum member" name="goog.events.KeyCodes.LEFT">LEFT</a><dt><a class="enum member" name="goog.events.KeyCodes.M">M</a><dt><a class="enum member" name="goog.events.KeyCodes.MAC_ENTER">MAC_ENTER</a><dt><a class="enum member" name="goog.events.KeyCodes.MAC_FF_META">MAC_FF_META</a><dt><a class="enum member" name="goog.events.KeyCodes.MAC_WK_CMD_LEFT">MAC_WK_CMD_LEFT</a><dt><a class="enum member" name="goog.events.KeyCodes.MAC_WK_CMD_RIGHT">MAC_WK_CMD_RIGHT</a><dt><a class="enum member" name="goog.events.KeyCodes.META">META</a><dt><a class="enum member" name="goog.events.KeyCodes.N">N</a><dt><a class="enum member" name="goog.events.KeyCodes.NINE">NINE</a><dt><a class="enum member" name="goog.events.KeyCodes.NUMLOCK">NUMLOCK</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_CENTER">NUM_CENTER</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_DIVISION">NUM_DIVISION</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_EIGHT">NUM_EIGHT</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_FIVE">NUM_FIVE</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_FOUR">NUM_FOUR</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_MINUS">NUM_MINUS</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_MULTIPLY">NUM_MULTIPLY</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_NINE">NUM_NINE</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_ONE">NUM_ONE</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_PERIOD">NUM_PERIOD</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_PLUS">NUM_PLUS</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_SEVEN">NUM_SEVEN</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_SIX">NUM_SIX</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_THREE">NUM_THREE</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_TWO">NUM_TWO</a><dt><a class="enum member" name="goog.events.KeyCodes.NUM_ZERO">NUM_ZERO</a><dt><a class="enum member" name="goog.events.KeyCodes.O">O</a><dt><a class="enum member" name="goog.events.KeyCodes.ONE">ONE</a><dt><a class="enum member" name="goog.events.KeyCodes.OPEN_SQUARE_BRACKET">OPEN_SQUARE_BRACKET</a><dt><a class="enum member" name="goog.events.KeyCodes.P">P</a><dt><a class="enum member" name="goog.events.KeyCodes.PAGE_DOWN">PAGE_DOWN</a><dt><a class="enum member" name="goog.events.KeyCodes.PAGE_UP">PAGE_UP</a><dt><a class="enum member" name="goog.events.KeyCodes.PAUSE">PAUSE</a><dt><a class="enum member" name="goog.events.KeyCodes.PERIOD">PERIOD</a><dt><a class="enum member" name="goog.events.KeyCodes.PHANTOM">PHANTOM</a><dt><a class="enum member" name="goog.events.KeyCodes.PRINT_SCREEN">PRINT_SCREEN</a><dt><a class="enum member" name="goog.events.KeyCodes.Q">Q</a><dt><a class="enum member" name="goog.events.KeyCodes.QUESTION_MARK">QUESTION_MARK</a><dt><a class="enum member" name="goog.events.KeyCodes.R">R</a><dt><a class="enum member" name="goog.events.KeyCodes.RIGHT">RIGHT</a><dt><a class="enum member" name="goog.events.KeyCodes.S">S</a><dt><a class="enum member" name="goog.events.KeyCodes.SCROLL_LOCK">SCROLL_LOCK</a><dt><a class="enum member" name="goog.events.KeyCodes.SEMICOLON">SEMICOLON</a><dt><a class="enum member" name="goog.events.KeyCodes.SEVEN">SEVEN</a><dt><a class="enum member" name="goog.events.KeyCodes.SHIFT">SHIFT</a><dt><a class="enum member" name="goog.events.KeyCodes.SINGLE_QUOTE">SINGLE_QUOTE</a><dt><a class="enum member" name="goog.events.KeyCodes.SIX">SIX</a><dt><a class="enum member" name="goog.events.KeyCodes.SLASH">SLASH</a><dt><a class="enum member" name="goog.events.KeyCodes.SPACE">SPACE</a><dt><a class="enum member" name="goog.events.KeyCodes.T">T</a><dt><a class="enum member" name="goog.events.KeyCodes.TAB">TAB</a><dt><a class="enum member" name="goog.events.KeyCodes.THREE">THREE</a><dt><a class="enum member" name="goog.events.KeyCodes.TILDE">TILDE</a><dt><a class="enum member" name="goog.events.KeyCodes.TWO">TWO</a><dt><a class="enum member" name="goog.events.KeyCodes.U">U</a><dt><a class="enum member" name="goog.events.KeyCodes.UP">UP</a><dt><a class="enum member" name="goog.events.KeyCodes.V">V</a><dt><a class="enum member" name="goog.events.KeyCodes.W">W</a><dt><a class="enum member" name="goog.events.KeyCodes.WIN_IME">WIN_IME</a><dt><a class="enum member" name="goog.events.KeyCodes.WIN_KEY">WIN_KEY</a><dt><a class="enum member" name="goog.events.KeyCodes.WIN_KEY_FF_LINUX">WIN_KEY_FF_LINUX</a><dt><a class="enum member" name="goog.events.KeyCodes.WIN_KEY_RIGHT">WIN_KEY_RIGHT</a><dt><a class="enum member" name="goog.events.KeyCodes.X">X</a><dt><a class="enum member" name="goog.events.KeyCodes.Y">Y</a><dt><a class="enum member" name="goog.events.KeyCodes.Z">Z</a><dt><a class="enum member" name="goog.events.KeyCodes.ZERO">ZERO</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/keycodes.js.src.html#l243">code &raquo;</a><span class="member"><a name="goog.events.KeyCodes.firesKeyPressEvent">goog.events.KeyCodes.firesKeyPressEvent</a> <span class="args">( keyCode, opt_heldKeyCode, opt_shiftKey, opt_ctrlKey, opt_altKey )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the key fires a keypress event in the current browser.
+
+ Accoridng to MSDN [1] IE only fires keypress events for the following keys:
+ - Letters: A - Z (uppercase and lowercase)
+ - Numerals: 0 - 9
+ - Symbols: ! @ # $ % ^ & * ( ) _ - + = < [ ] { } , . / ? \ | ' ` " ~
+ - System: ESC, SPACEBAR, ENTER
+
+ That's not entirely correct though, for instance there's no distinction
+ between upper and lower case letters.
+
+ [1] http://msdn2.microsoft.com/en-us/library/ms536939(VS.85).aspx)
+
+ Safari is similar to IE, but does not fire keypress for ESC.
+
+ Additionally, IE6 does not fire keydown or keypress events for letters when
+ the control or alt keys are held down and the shift key is not. IE7 does
+ fire keydown in these cases, though, but not keypress.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A key code.<dt>opt_heldKeyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Key code of a currently-held key.<dt>opt_shiftKey: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether the shift key is held down.<dt>opt_ctrlKey: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether the control key is held down.<dt>opt_altKey: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether the alt key is held down.</dl><tr><th>Returns<tr><td><dl>Whether it's a key that fires a keypress event.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/keycodes.js.src.html#l316">code &raquo;</a><span class="member"><a name="goog.events.KeyCodes.isCharacterKey">goog.events.KeyCodes.isCharacterKey</a> <span class="args">( keyCode )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the key produces a character.
+ This does not cover characters on non-US keyboards (Russian, Hebrew, etc.).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A key code.</dl><tr><th>Returns<tr><td><dl>Whether it's a character key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/keycodes.js.src.html#l169">code &raquo;</a><span class="member"><a name="goog.events.KeyCodes.isTextModifyingKeyEvent">goog.events.KeyCodes.isTextModifyingKeyEvent</a> <span class="args">( e )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the event contains a text modifying key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type"><a href="class_goog_events_BrowserEvent.html">goog.events.BrowserEvent</a></code><dd>A key event.</dl><tr><th>Returns<tr><td><dl>Whether it's a text modifying key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/keycodes.js.src.html#l385">code &raquo;</a><span class="member"><a name="goog.events.KeyCodes.normalizeGeckoKeyCode">goog.events.KeyCodes.normalizeGeckoKeyCode</a> <span class="args">( keyCode )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Normalizes key codes from their Gecko-specific value to the general one.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The native key code.</dl><tr><th>Returns<tr><td><dl>The normalized key code.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/keycodes.js.src.html#l369">code &raquo;</a><span class="member"><a name="goog.events.KeyCodes.normalizeKeyCode">goog.events.KeyCodes.normalizeKeyCode</a> <span class="args">( keyCode )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Normalizes key codes from OS/Browser-specific value to the general one.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The native key code.</dl><tr><th>Returns<tr><td><dl>The normalized key code.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/keycodes.js.src.html#l408">code &raquo;</a><span class="member"><a name="goog.events.KeyCodes.normalizeMacWebKitKeyCode">goog.events.KeyCodes.normalizeMacWebKitKeyCode</a> <span class="args">( keyCode )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Normalizes key codes from their Mac WebKit-specific value to the general one.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The native key code.</dl><tr><th>Returns<tr><td><dl>The normalized key code.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_net_XmlHttp_OptionType.html b/docs/enum_goog_net_XmlHttp_OptionType.html
index d16e1ee..32b8726 100644
--- a/docs/enum_goog_net_XmlHttp_OptionType.html
+++ b/docs/enum_goog_net_XmlHttp_OptionType.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttp.OptionType</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.net.XmlHttp.OptionType</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l60">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Type of options that an XmlHttp object can have.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.net.XmlHttp.OptionType.LOCAL_REQUEST_ERROR">LOCAL_REQUEST_ERROR</a><dd>NOTE(user): In IE if send() errors on a *local* request the readystate
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttp.OptionType</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.net.XmlHttp.OptionType</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l77">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Type of options that an XmlHttp object can have.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.net.XmlHttp.OptionType.LOCAL_REQUEST_ERROR">LOCAL_REQUEST_ERROR</a><dd>NOTE(user): In IE if send() errors on a *local* request the readystate
  is still changed to COMPLETE.  We need to ignore it and allow the
  try/catch around send() to pick up the error.<dt><a class="enum member" name="goog.net.XmlHttp.OptionType.USE_NULL_FUNCTION">USE_NULL_FUNCTION</a><dd>Whether a goog.nullFunction should be used to clear the onreadystatechange
- handler instead of null.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ handler instead of null.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_net_XmlHttp_ReadyState.html b/docs/enum_goog_net_XmlHttp_ReadyState.html
index 41635c9..7c4404e 100644
--- a/docs/enum_goog_net_XmlHttp_ReadyState.html
+++ b/docs/enum_goog_net_XmlHttp_ReadyState.html
@@ -1,3 +1,3 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttp.ReadyState</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.net.XmlHttp.ReadyState</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l82">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Status constants for XMLHTTP, matches:
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttp.ReadyState</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.net.XmlHttp.ReadyState</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l99">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Status constants for XMLHTTP, matches:
  http://msdn.microsoft.com/library/default.asp?url=/library/
-   en-us/xmlsdk/html/0e6a34e4-f90c-489d-acff-cb44242fafc6.asp<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.COMPLETE">COMPLETE</a><dd>Constant for when xmlhttprequest.readyState is completed<dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.INTERACTIVE">INTERACTIVE</a><dd>Constant for when xmlhttprequest.readyState is in an interactive state.<dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.LOADED">LOADED</a><dd>Constant for when xmlhttprequest.readyState is loaded.<dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.LOADING">LOADING</a><dd>Constant for when xmlhttprequest.readyState is loading.<dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.UNINITIALIZED">UNINITIALIZED</a><dd>Constant for when xmlhttprequest.readyState is uninitialized</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+   en-us/xmlsdk/html/0e6a34e4-f90c-489d-acff-cb44242fafc6.asp<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.COMPLETE">COMPLETE</a><dd>Constant for when xmlhttprequest.readyState is completed<dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.INTERACTIVE">INTERACTIVE</a><dd>Constant for when xmlhttprequest.readyState is in an interactive state.<dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.LOADED">LOADED</a><dd>Constant for when xmlhttprequest.readyState is loaded.<dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.LOADING">LOADING</a><dd>Constant for when xmlhttprequest.readyState is loading.<dt><a class="enum member" name="goog.net.XmlHttp.ReadyState.UNINITIALIZED">UNINITIALIZED</a><dd>Constant for when xmlhttprequest.readyState is uninitialized</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_string_Unicode.html b/docs/enum_goog_string_Unicode.html
index 9dd3b43..e0c1683 100644
--- a/docs/enum_goog_string_Unicode.html
+++ b/docs/enum_goog_string_Unicode.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.string.Unicode</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.string.Unicode</h1><a class="source" href="source/lib/goog/string/string.js.src.html#l31">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Common Unicode string characters.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.string.Unicode.NBSP">NBSP</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.string.Unicode</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.string.Unicode</h1><a class="source" href="source/lib/goog/string/string.js.src.html#l38">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Common Unicode string characters.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.string.Unicode.NBSP">NBSP</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_testing_TestCase_Order.html b/docs/enum_goog_testing_TestCase_Order.html
new file mode 100644
index 0000000..efa7872
--- /dev/null
+++ b/docs/enum_goog_testing_TestCase_Order.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.TestCase.Order</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.testing.TestCase.Order</h1><a class="source" href="source/lib/goog/testing/testcase.js.src.html#l135">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>The order to run the auto-discovered tests.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.testing.TestCase.Order.NATURAL">NATURAL</a><dd>This is browser dependent and known to be different in FF and Safari
+ compared to others.<dt><a class="enum member" name="goog.testing.TestCase.Order.RANDOM">RANDOM</a><dd>Random order.<dt><a class="enum member" name="goog.testing.TestCase.Order.SORTED">SORTED</a><dd>Sorted based on the name.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_uri_utils_CharCode_.html b/docs/enum_goog_uri_utils_CharCode_.html
index 4c9fb9e..473287a 100644
--- a/docs/enum_goog_uri_utils_CharCode_.html
+++ b/docs/enum_goog_uri_utils_CharCode_.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri.utils.CharCode_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.uri.utils.CharCode_</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l64">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Character codes inlined to avoid object allocations due to charCode.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="private"><dt><a class="enum member" name="goog.uri.utils.CharCode_.AMPERSAND">AMPERSAND</a><dt><a class="enum member" name="goog.uri.utils.CharCode_.EQUAL">EQUAL</a><dt><a class="enum member" name="goog.uri.utils.CharCode_.HASH">HASH</a><dt><a class="enum member" name="goog.uri.utils.CharCode_.QUESTION">QUESTION</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri.utils.CharCode_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.uri.utils.CharCode_</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l64">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Character codes inlined to avoid object allocations due to charCode.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="private"><dt><a class="enum member" name="goog.uri.utils.CharCode_.AMPERSAND">AMPERSAND</a><dt><a class="enum member" name="goog.uri.utils.CharCode_.EQUAL">EQUAL</a><dt><a class="enum member" name="goog.uri.utils.CharCode_.HASH">HASH</a><dt><a class="enum member" name="goog.uri.utils.CharCode_.QUESTION">QUESTION</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_uri_utils_ComponentIndex.html b/docs/enum_goog_uri_utils_ComponentIndex.html
index 82afbbb..61588fe 100644
--- a/docs/enum_goog_uri_utils_ComponentIndex.html
+++ b/docs/enum_goog_uri_utils_ComponentIndex.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri.utils.ComponentIndex</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.uri.utils.ComponentIndex</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l212">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>The index of each URI component in the return value of goog.uri.utils.split.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.DOMAIN">DOMAIN</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.FRAGMENT">FRAGMENT</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.PATH">PATH</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.PORT">PORT</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.QUERY_DATA">QUERY_DATA</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.SCHEME">SCHEME</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.USER_INFO">USER_INFO</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri.utils.ComponentIndex</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.uri.utils.ComponentIndex</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l212">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>The index of each URI component in the return value of goog.uri.utils.split.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.DOMAIN">DOMAIN</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.FRAGMENT">FRAGMENT</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.PATH">PATH</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.PORT">PORT</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.QUERY_DATA">QUERY_DATA</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.SCHEME">SCHEME</a><dt><a class="enum member" name="goog.uri.utils.ComponentIndex.USER_INFO">USER_INFO</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_goog_uri_utils_StandardQueryParam.html b/docs/enum_goog_uri_utils_StandardQueryParam.html
index 255b326..2ae6cf5 100644
--- a/docs/enum_goog_uri_utils_StandardQueryParam.html
+++ b/docs/enum_goog_uri_utils_StandardQueryParam.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri.utils.StandardQueryParam</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.uri.utils.StandardQueryParam</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1037">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Standard supported query parameters.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.uri.utils.StandardQueryParam.RANDOM">RANDOM</a><dd>Unused parameter for unique-ifying.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri.utils.StandardQueryParam</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum goog.uri.utils.StandardQueryParam</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1068">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Standard supported query parameters.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="goog.uri.utils.StandardQueryParam.RANDOM">RANDOM</a><dd>Unused parameter for unique-ifying.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_webdriver_Browser.html b/docs/enum_webdriver_Browser.html
index a50d566..2b55b21 100644
--- a/docs/enum_webdriver_Browser.html
+++ b/docs/enum_webdriver_Browser.html
@@ -1 +1,2 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Browser</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.Browser</h1><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l29">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Recognized browser names.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.Browser.ANDROID">ANDROID</a><dt><a class="enum member" name="webdriver.Browser.CHROME">CHROME</a><dt><a class="enum member" name="webdriver.Browser.FIREFOX">FIREFOX</a><dt><a class="enum member" name="webdriver.Browser.HTMLUNIT">HTMLUNIT</a><dt><a class="enum member" name="webdriver.Browser.INTERNET_EXPLORER">INTERNET_EXPLORER</a><dt><a class="enum member" name="webdriver.Browser.IPAD">IPAD</a><dt><a class="enum member" name="webdriver.Browser.IPHONE">IPHONE</a><dt><a class="enum member" name="webdriver.Browser.OPERA">OPERA</a><dt><a class="enum member" name="webdriver.Browser.PHANTOM_JS">PHANTOM_JS</a><dt><a class="enum member" name="webdriver.Browser.SAFARI">SAFARI</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Browser</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l36">View Source</a></div><h1>enum Browser</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl><p>Recognized browser names.</p>
+<h2>Values and Descriptions</h2><div id="ANDROID" class="property"><dl><dt>ANDROID</dl></div><div id="CHROME" class="property"><dl><dt>CHROME</dl></div><div id="FIREFOX" class="property"><dl><dt>FIREFOX</dl></div><div id="HTMLUNIT" class="property"><dl><dt>HTMLUNIT</dl></div><div id="IE" class="property"><dl><dt>IE</dl></div><div id="INTERNET_EXPLORER" class="property"><dl><dt>INTERNET_EXPLORER</dl></div><div id="IPAD" class="property"><dl><dt>IPAD</dl></div><div id="IPHONE" class="property"><dl><dt>IPHONE</dl></div><div id="OPERA" class="property"><dl><dt>OPERA</dl></div><div id="PHANTOM_JS" class="property"><dl><dt>PHANTOM_JS</dl></div><div id="SAFARI" class="property"><dl><dt>SAFARI</dl></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>
\ No newline at end of file
diff --git a/docs/enum_webdriver_Button.html b/docs/enum_webdriver_Button.html
index 7b2018b..492d103 100644
--- a/docs/enum_webdriver_Button.html
+++ b/docs/enum_webdriver_Button.html
@@ -1 +1,2 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Button</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.Button</h1><a class="source" href="source/lib/webdriver/button.js.src.html#l23">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>Enumeration of the buttons used in the advanced interactions API.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.Button.LEFT">LEFT</a><dt><a class="enum member" name="webdriver.Button.MIDDLE">MIDDLE</a><dt><a class="enum member" name="webdriver.Button.RIGHT">RIGHT</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Button</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/button.js.src.html#l25">View Source</a></div><h1>enum Button</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl><p>Enumeration of the buttons used in the advanced interactions API.</p>
+<h2>Values and Descriptions</h2><div id="LEFT" class="property"><dl><dt>LEFT</dl></div><div id="MIDDLE" class="property"><dl><dt>MIDDLE</dl></div><div id="RIGHT" class="property"><dl><dt>RIGHT</dl></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>
\ No newline at end of file
diff --git a/docs/enum_webdriver_Capability.html b/docs/enum_webdriver_Capability.html
index a16afd9..6a15c11 100644
--- a/docs/enum_webdriver_Capability.html
+++ b/docs/enum_webdriver_Capability.html
@@ -1,14 +1,33 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Capability</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.Capability</h1><a class="source" href="source/lib/webdriver/capabilities.js.src.html#l48">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Common webdriver capability keys.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.Capability.ACCEPT_SSL_CERTS">ACCEPT_SSL_CERTS</a><dd>Indicates whether a driver should accept all SSL certs by default. This
- capability only applies when requesting a new session. To query whether
- a driver can handle insecure SSL certs, see
- <code  class="type"><a href="enum_webdriver_Capability.html#webdriver.Capability.SECURE_SSL">webdriver.Capability.SECURE_SSL</a></code>.<dt><a class="enum member" name="webdriver.Capability.BROWSER_NAME">BROWSER_NAME</a><dd>The browser name. Common browser names are defined in the
- <code  class="type"><a href="enum_webdriver_Browser.html">webdriver.Browser</a></code> enum.<dt><a class="enum member" name="webdriver.Capability.HANDLES_ALERTS">HANDLES_ALERTS</a><dd>Whether the driver is capable of handling modal alerts (e.g. alert,
- confirm, prompt). To define how a driver <i>should</i> handle alerts,
- use <code  class="type"><a href="enum_webdriver_Capability.html#webdriver.Capability.UNEXPECTED_ALERT_BEHAVIOR">webdriver.Capability.UNEXPECTED_ALERT_BEHAVIOR</a></code>.<dt><a class="enum member" name="webdriver.Capability.LOGGING_PREFS">LOGGING_PREFS</a><dd>Key for the logging driver logging preferences.<dt><a class="enum member" name="webdriver.Capability.PLATFORM">PLATFORM</a><dd>Describes the platform the browser is running on. Will be one of
- ANDROID, IOS, LINUX, MAC, UNIX, or WINDOWS. When <i>requesting</i> a
- session, ANY may be used to indicate no platform preference (this is
- semantically equivalent to omitting the platform capability).<dt><a class="enum member" name="webdriver.Capability.PROXY">PROXY</a><dd>Describes the proxy configuration to use for a new WebDriver session.<dt><a class="enum member" name="webdriver.Capability.ROTATABLE">ROTATABLE</a><dd>Whether the driver supports changing the brower's orientation.<dt><a class="enum member" name="webdriver.Capability.SECURE_SSL">SECURE_SSL</a><dd>Whether a driver is only capable of handling secure SSL certs. To request
- that a driver accept insecure SSL certs by default, use
- <code  class="type"><a href="enum_webdriver_Capability.html#webdriver.Capability.ACCEPT_SSL_CERTS">webdriver.Capability.ACCEPT_SSL_CERTS</a></code>.<dt><a class="enum member" name="webdriver.Capability.SUPPORTS_APPLICATION_CACHE">SUPPORTS_APPLICATION_CACHE</a><dd>Whether the driver supports manipulating the app cache.<dt><a class="enum member" name="webdriver.Capability.SUPPORTS_BROWSER_CONNECTION">SUPPORTS_BROWSER_CONNECTION</a><dd>Whether the driver supports controlling the browser's internet
- connectivity.<dt><a class="enum member" name="webdriver.Capability.SUPPORTS_CSS_SELECTORS">SUPPORTS_CSS_SELECTORS</a><dd>Whether the driver supports locating elements with CSS selectors.<dt><a class="enum member" name="webdriver.Capability.SUPPORTS_JAVASCRIPT">SUPPORTS_JAVASCRIPT</a><dd>Whether the browser supports JavaScript.<dt><a class="enum member" name="webdriver.Capability.SUPPORTS_LOCATION_CONTEXT">SUPPORTS_LOCATION_CONTEXT</a><dd>Whether the driver supports controlling the browser's location info.<dt><a class="enum member" name="webdriver.Capability.TAKES_SCREENSHOT">TAKES_SCREENSHOT</a><dd>Whether the driver supports taking screenshots.<dt><a class="enum member" name="webdriver.Capability.UNEXPECTED_ALERT_BEHAVIOR">UNEXPECTED_ALERT_BEHAVIOR</a><dd>Defines how the driver should handle unexpected alerts. The value should
- be one of "accept", "dismiss", or "ignore.<dt><a class="enum member" name="webdriver.Capability.VERSION">VERSION</a><dd>Defines the browser version.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Capability</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l73">View Source</a></div><h1>enum Capability</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl><p>Common webdriver capability keys.</p>
+<h2>Values and Descriptions</h2><div id="ACCEPT_SSL_CERTS" class="property"><dl><dt>ACCEPT_SSL_CERTS<dd><p>Indicates whether a driver should accept all SSL certs by default. This
+capability only applies when requesting a new session. To query whether
+a driver can handle insecure SSL certs, see <a href="enum_webdriver_Capability.html#SECURE_SSL"><code>#SECURE_SSL</code></a>.</p>
+</dl></div><div id="BROWSER_NAME" class="property"><dl><dt>BROWSER_NAME<dd><p>The browser name. Common browser names are defined in the
+<a href="enum_webdriver_Browser.html"><code>webdriver.Browser</code></a> enum.</p>
+</dl></div><div id="ELEMENT_SCROLL_BEHAVIOR" class="property"><dl><dt>ELEMENT_SCROLL_BEHAVIOR<dd><p>Defines how elements should be scrolled into the viewport for interaction.
+This capability will be set to zero (0) if elements are aligned with the
+top of the viewport, or one (1) if aligned with the bottom. The default
+behavior is to align with the top of the viewport.</p>
+</dl></div><div id="HANDLES_ALERTS" class="property"><dl><dt>HANDLES_ALERTS<dd><p>Whether the driver is capable of handling modal alerts (e.g. alert,
+confirm, prompt). To define how a driver <i>should</i> handle alerts,
+use <a href="enum_webdriver_Capability.html#UNEXPECTED_ALERT_BEHAVIOR"><code>#UNEXPECTED_ALERT_BEHAVIOR</code></a>.</p>
+</dl></div><div id="LOGGING_PREFS" class="property"><dl><dt>LOGGING_PREFS<dd><p>Key for the logging driver logging preferences.</p>
+</dl></div><div id="NATIVE_EVENTS" class="property"><dl><dt>NATIVE_EVENTS<dd><p>Whether this session generates native events when simulating user input.</p>
+</dl></div><div id="PLATFORM" class="property"><dl><dt>PLATFORM<dd><p>Describes the platform the browser is running on. Will be one of
+ANDROID, IOS, LINUX, MAC, UNIX, or WINDOWS. When <i>requesting</i> a
+session, ANY may be used to indicate no platform preference (this is
+semantically equivalent to omitting the platform capability).</p>
+</dl></div><div id="PROXY" class="property"><dl><dt>PROXY<dd><p>Describes the proxy configuration to use for a new WebDriver session.</p>
+</dl></div><div id="ROTATABLE" class="property"><dl><dt>ROTATABLE<dd><p>Whether the driver supports changing the brower&#39;s orientation.</p>
+</dl></div><div id="SECURE_SSL" class="property"><dl><dt>SECURE_SSL<dd><p>Whether a driver is only capable of handling secure SSL certs. To request
+that a driver accept insecure SSL certs by default, use
+<a href="enum_webdriver_Capability.html#ACCEPT_SSL_CERTS"><code>#ACCEPT_SSL_CERTS</code></a>.</p>
+</dl></div><div id="SUPPORTS_APPLICATION_CACHE" class="property"><dl><dt>SUPPORTS_APPLICATION_CACHE<dd><p>Whether the driver supports manipulating the app cache.</p>
+</dl></div><div id="SUPPORTS_CSS_SELECTORS" class="property"><dl><dt>SUPPORTS_CSS_SELECTORS<dd><p>Whether the driver supports locating elements with CSS selectors.</p>
+</dl></div><div id="SUPPORTS_JAVASCRIPT" class="property"><dl><dt>SUPPORTS_JAVASCRIPT<dd><p>Whether the browser supports JavaScript.</p>
+</dl></div><div id="SUPPORTS_LOCATION_CONTEXT" class="property"><dl><dt>SUPPORTS_LOCATION_CONTEXT<dd><p>Whether the driver supports controlling the browser&#39;s location info.</p>
+</dl></div><div id="TAKES_SCREENSHOT" class="property"><dl><dt>TAKES_SCREENSHOT<dd><p>Whether the driver supports taking screenshots.</p>
+</dl></div><div id="UNEXPECTED_ALERT_BEHAVIOR" class="property"><dl><dt>UNEXPECTED_ALERT_BEHAVIOR<dd><p>Defines how the driver should handle unexpected alerts. The value should
+be one of &#34;accept&#34;, &#34;dismiss&#34;, or &#34;ignore.</p>
+</dl></div><div id="VERSION" class="property"><dl><dt>VERSION<dd><p>Defines the browser version.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/enum_webdriver_CommandName.html b/docs/enum_webdriver_CommandName.html
index 51e2c1b..8cc80ea 100644
--- a/docs/enum_webdriver_CommandName.html
+++ b/docs/enum_webdriver_CommandName.html
@@ -1,2 +1,3 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.CommandName</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.CommandName</h1><a class="source" href="source/lib/webdriver/command.js.src.html#l101">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Enumeration of predefined names command names that all command processors
- will support.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.CommandName.ACCEPT_ALERT">ACCEPT_ALERT</a><dt><a class="enum member" name="webdriver.CommandName.ADD_COOKIE">ADD_COOKIE</a><dt><a class="enum member" name="webdriver.CommandName.CLEAR_APP_CACHE">CLEAR_APP_CACHE</a><dt><a class="enum member" name="webdriver.CommandName.CLEAR_ELEMENT">CLEAR_ELEMENT</a><dt><a class="enum member" name="webdriver.CommandName.CLEAR_LOCAL_STORAGE">CLEAR_LOCAL_STORAGE</a><dt><a class="enum member" name="webdriver.CommandName.CLEAR_SESSION_STORAGE">CLEAR_SESSION_STORAGE</a><dt><a class="enum member" name="webdriver.CommandName.CLICK">CLICK</a><dt><a class="enum member" name="webdriver.CommandName.CLICK_ELEMENT">CLICK_ELEMENT</a><dt><a class="enum member" name="webdriver.CommandName.CLOSE">CLOSE</a><dt><a class="enum member" name="webdriver.CommandName.DELETE_ALL_COOKIES">DELETE_ALL_COOKIES</a><dt><a class="enum member" name="webdriver.CommandName.DELETE_COOKIE">DELETE_COOKIE</a><dt><a class="enum member" name="webdriver.CommandName.DESCRIBE_SESSION">DESCRIBE_SESSION</a><dt><a class="enum member" name="webdriver.CommandName.DISMISS_ALERT">DISMISS_ALERT</a><dt><a class="enum member" name="webdriver.CommandName.DOUBLE_CLICK">DOUBLE_CLICK</a><dt><a class="enum member" name="webdriver.CommandName.ELEMENT_EQUALS">ELEMENT_EQUALS</a><dt><a class="enum member" name="webdriver.CommandName.EXECUTE_ASYNC_SCRIPT">EXECUTE_ASYNC_SCRIPT</a><dt><a class="enum member" name="webdriver.CommandName.EXECUTE_SCRIPT">EXECUTE_SCRIPT</a><dt><a class="enum member" name="webdriver.CommandName.EXECUTE_SQL">EXECUTE_SQL</a><dt><a class="enum member" name="webdriver.CommandName.FIND_CHILD_ELEMENT">FIND_CHILD_ELEMENT</a><dt><a class="enum member" name="webdriver.CommandName.FIND_CHILD_ELEMENTS">FIND_CHILD_ELEMENTS</a><dt><a class="enum member" name="webdriver.CommandName.FIND_ELEMENT">FIND_ELEMENT</a><dt><a class="enum member" name="webdriver.CommandName.FIND_ELEMENTS">FIND_ELEMENTS</a><dt><a class="enum member" name="webdriver.CommandName.GET">GET</a><dt><a class="enum member" name="webdriver.CommandName.GET_ACTIVE_ELEMENT">GET_ACTIVE_ELEMENT</a><dt><a class="enum member" name="webdriver.CommandName.GET_ALERT_TEXT">GET_ALERT_TEXT</a><dt><a class="enum member" name="webdriver.CommandName.GET_ALL_COOKIES">GET_ALL_COOKIES</a><dt><a class="enum member" name="webdriver.CommandName.GET_APP_CACHE">GET_APP_CACHE</a><dt><a class="enum member" name="webdriver.CommandName.GET_APP_CACHE_STATUS">GET_APP_CACHE_STATUS</a><dt><a class="enum member" name="webdriver.CommandName.GET_AVAILABLE_LOG_TYPES">GET_AVAILABLE_LOG_TYPES</a><dt><a class="enum member" name="webdriver.CommandName.GET_COOKIE">GET_COOKIE</a><dt><a class="enum member" name="webdriver.CommandName.GET_CURRENT_URL">GET_CURRENT_URL</a><dt><a class="enum member" name="webdriver.CommandName.GET_CURRENT_WINDOW_HANDLE">GET_CURRENT_WINDOW_HANDLE</a><dt><a class="enum member" name="webdriver.CommandName.GET_ELEMENT_ATTRIBUTE">GET_ELEMENT_ATTRIBUTE</a><dt><a class="enum member" name="webdriver.CommandName.GET_ELEMENT_LOCATION">GET_ELEMENT_LOCATION</a><dt><a class="enum member" name="webdriver.CommandName.GET_ELEMENT_LOCATION_IN_VIEW">GET_ELEMENT_LOCATION_IN_VIEW</a><dt><a class="enum member" name="webdriver.CommandName.GET_ELEMENT_SIZE">GET_ELEMENT_SIZE</a><dt><a class="enum member" name="webdriver.CommandName.GET_ELEMENT_TAG_NAME">GET_ELEMENT_TAG_NAME</a><dt><a class="enum member" name="webdriver.CommandName.GET_ELEMENT_TEXT">GET_ELEMENT_TEXT</a><dt><a class="enum member" name="webdriver.CommandName.GET_ELEMENT_VALUE_OF_CSS_PROPERTY">GET_ELEMENT_VALUE_OF_CSS_PROPERTY</a><dt><a class="enum member" name="webdriver.CommandName.GET_LOCAL_STORAGE_ITEM">GET_LOCAL_STORAGE_ITEM</a><dt><a class="enum member" name="webdriver.CommandName.GET_LOCAL_STORAGE_KEYS">GET_LOCAL_STORAGE_KEYS</a><dt><a class="enum member" name="webdriver.CommandName.GET_LOCAL_STORAGE_SIZE">GET_LOCAL_STORAGE_SIZE</a><dt><a class="enum member" name="webdriver.CommandName.GET_LOCATION">GET_LOCATION</a><dt><a class="enum member" name="webdriver.CommandName.GET_LOG">GET_LOG</a><dt><a class="enum member" name="webdriver.CommandName.GET_PAGE_SOURCE">GET_PAGE_SOURCE</a><dt><a class="enum member" name="webdriver.CommandName.GET_SCREEN_ORIENTATION">GET_SCREEN_ORIENTATION</a><dt><a class="enum member" name="webdriver.CommandName.GET_SERVER_STATUS">GET_SERVER_STATUS</a><dt><a class="enum member" name="webdriver.CommandName.GET_SESSIONS">GET_SESSIONS</a><dt><a class="enum member" name="webdriver.CommandName.GET_SESSION_LOGS">GET_SESSION_LOGS</a><dt><a class="enum member" name="webdriver.CommandName.GET_SESSION_STORAGE_ITEM">GET_SESSION_STORAGE_ITEM</a><dt><a class="enum member" name="webdriver.CommandName.GET_SESSION_STORAGE_KEYS">GET_SESSION_STORAGE_KEYS</a><dt><a class="enum member" name="webdriver.CommandName.GET_SESSION_STORAGE_SIZE">GET_SESSION_STORAGE_SIZE</a><dt><a class="enum member" name="webdriver.CommandName.GET_TITLE">GET_TITLE</a><dt><a class="enum member" name="webdriver.CommandName.GET_WINDOW_HANDLES">GET_WINDOW_HANDLES</a><dt><a class="enum member" name="webdriver.CommandName.GET_WINDOW_POSITION">GET_WINDOW_POSITION</a><dt><a class="enum member" name="webdriver.CommandName.GET_WINDOW_SIZE">GET_WINDOW_SIZE</a><dt><a class="enum member" name="webdriver.CommandName.GO_BACK">GO_BACK</a><dt><a class="enum member" name="webdriver.CommandName.GO_FORWARD">GO_FORWARD</a><dt><a class="enum member" name="webdriver.CommandName.IMPLICITLY_WAIT">IMPLICITLY_WAIT</a><dt><a class="enum member" name="webdriver.CommandName.IS_BROWSER_ONLINE">IS_BROWSER_ONLINE</a><dt><a class="enum member" name="webdriver.CommandName.IS_ELEMENT_DISPLAYED">IS_ELEMENT_DISPLAYED</a><dt><a class="enum member" name="webdriver.CommandName.IS_ELEMENT_ENABLED">IS_ELEMENT_ENABLED</a><dt><a class="enum member" name="webdriver.CommandName.IS_ELEMENT_SELECTED">IS_ELEMENT_SELECTED</a><dt><a class="enum member" name="webdriver.CommandName.MAXIMIZE_WINDOW">MAXIMIZE_WINDOW</a><dt><a class="enum member" name="webdriver.CommandName.MOUSE_DOWN">MOUSE_DOWN</a><dt><a class="enum member" name="webdriver.CommandName.MOUSE_UP">MOUSE_UP</a><dt><a class="enum member" name="webdriver.CommandName.MOVE_TO">MOVE_TO</a><dt><a class="enum member" name="webdriver.CommandName.NEW_SESSION">NEW_SESSION</a><dt><a class="enum member" name="webdriver.CommandName.QUIT">QUIT</a><dt><a class="enum member" name="webdriver.CommandName.REFRESH">REFRESH</a><dt><a class="enum member" name="webdriver.CommandName.REMOVE_LOCAL_STORAGE_ITEM">REMOVE_LOCAL_STORAGE_ITEM</a><dt><a class="enum member" name="webdriver.CommandName.REMOVE_SESSION_STORAGE_ITEM">REMOVE_SESSION_STORAGE_ITEM</a><dt><a class="enum member" name="webdriver.CommandName.SCREENSHOT">SCREENSHOT</a><dt><a class="enum member" name="webdriver.CommandName.SEND_KEYS_TO_ACTIVE_ELEMENT">SEND_KEYS_TO_ACTIVE_ELEMENT</a><dt><a class="enum member" name="webdriver.CommandName.SEND_KEYS_TO_ELEMENT">SEND_KEYS_TO_ELEMENT</a><dt><a class="enum member" name="webdriver.CommandName.SET_ALERT_TEXT">SET_ALERT_TEXT</a><dt><a class="enum member" name="webdriver.CommandName.SET_BROWSER_ONLINE">SET_BROWSER_ONLINE</a><dt><a class="enum member" name="webdriver.CommandName.SET_LOCAL_STORAGE_ITEM">SET_LOCAL_STORAGE_ITEM</a><dt><a class="enum member" name="webdriver.CommandName.SET_LOCATION">SET_LOCATION</a><dt><a class="enum member" name="webdriver.CommandName.SET_SCREEN_ORIENTATION">SET_SCREEN_ORIENTATION</a><dt><a class="enum member" name="webdriver.CommandName.SET_SCRIPT_TIMEOUT">SET_SCRIPT_TIMEOUT</a><dt><a class="enum member" name="webdriver.CommandName.SET_SESSION_STORAGE_ITEM">SET_SESSION_STORAGE_ITEM</a><dt><a class="enum member" name="webdriver.CommandName.SET_TIMEOUT">SET_TIMEOUT</a><dt><a class="enum member" name="webdriver.CommandName.SET_WINDOW_POSITION">SET_WINDOW_POSITION</a><dt><a class="enum member" name="webdriver.CommandName.SET_WINDOW_SIZE">SET_WINDOW_SIZE</a><dt><a class="enum member" name="webdriver.CommandName.SUBMIT_ELEMENT">SUBMIT_ELEMENT</a><dt><a class="enum member" name="webdriver.CommandName.SWITCH_TO_FRAME">SWITCH_TO_FRAME</a><dt><a class="enum member" name="webdriver.CommandName.SWITCH_TO_WINDOW">SWITCH_TO_WINDOW</a><dt><a class="enum member" name="webdriver.CommandName.TOUCH_DOUBLE_TAP">TOUCH_DOUBLE_TAP</a><dt><a class="enum member" name="webdriver.CommandName.TOUCH_DOWN">TOUCH_DOWN</a><dt><a class="enum member" name="webdriver.CommandName.TOUCH_FLICK">TOUCH_FLICK</a><dt><a class="enum member" name="webdriver.CommandName.TOUCH_LONG_PRESS">TOUCH_LONG_PRESS</a><dt><a class="enum member" name="webdriver.CommandName.TOUCH_MOVE">TOUCH_MOVE</a><dt><a class="enum member" name="webdriver.CommandName.TOUCH_SCROLL">TOUCH_SCROLL</a><dt><a class="enum member" name="webdriver.CommandName.TOUCH_SINGLE_TAP">TOUCH_SINGLE_TAP</a><dt><a class="enum member" name="webdriver.CommandName.TOUCH_UP">TOUCH_UP</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>CommandName</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/command.js.src.html#l104">View Source</a></div><h1>enum CommandName</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl><p>Enumeration of predefined names command names that all command processors
+will support.</p>
+<h2>Values and Descriptions</h2><div id="ACCEPT_ALERT" class="property"><dl><dt>ACCEPT_ALERT</dl></div><div id="ADD_COOKIE" class="property"><dl><dt>ADD_COOKIE</dl></div><div id="CLEAR_APP_CACHE" class="property"><dl><dt>CLEAR_APP_CACHE</dl></div><div id="CLEAR_ELEMENT" class="property"><dl><dt>CLEAR_ELEMENT</dl></div><div id="CLEAR_LOCAL_STORAGE" class="property"><dl><dt>CLEAR_LOCAL_STORAGE</dl></div><div id="CLEAR_SESSION_STORAGE" class="property"><dl><dt>CLEAR_SESSION_STORAGE</dl></div><div id="CLICK" class="property"><dl><dt>CLICK</dl></div><div id="CLICK_ELEMENT" class="property"><dl><dt>CLICK_ELEMENT</dl></div><div id="CLOSE" class="property"><dl><dt>CLOSE</dl></div><div id="DELETE_ALL_COOKIES" class="property"><dl><dt>DELETE_ALL_COOKIES</dl></div><div id="DELETE_COOKIE" class="property"><dl><dt>DELETE_COOKIE</dl></div><div id="DESCRIBE_SESSION" class="property"><dl><dt>DESCRIBE_SESSION</dl></div><div id="DISMISS_ALERT" class="property"><dl><dt>DISMISS_ALERT</dl></div><div id="DOUBLE_CLICK" class="property"><dl><dt>DOUBLE_CLICK</dl></div><div id="ELEMENT_EQUALS" class="property"><dl><dt>ELEMENT_EQUALS</dl></div><div id="EXECUTE_ASYNC_SCRIPT" class="property"><dl><dt>EXECUTE_ASYNC_SCRIPT</dl></div><div id="EXECUTE_SCRIPT" class="property"><dl><dt>EXECUTE_SCRIPT</dl></div><div id="EXECUTE_SQL" class="property"><dl><dt>EXECUTE_SQL</dl></div><div id="FIND_CHILD_ELEMENT" class="property"><dl><dt>FIND_CHILD_ELEMENT</dl></div><div id="FIND_CHILD_ELEMENTS" class="property"><dl><dt>FIND_CHILD_ELEMENTS</dl></div><div id="FIND_ELEMENT" class="property"><dl><dt>FIND_ELEMENT</dl></div><div id="FIND_ELEMENTS" class="property"><dl><dt>FIND_ELEMENTS</dl></div><div id="GET" class="property"><dl><dt>GET</dl></div><div id="GET_ACTIVE_ELEMENT" class="property"><dl><dt>GET_ACTIVE_ELEMENT</dl></div><div id="GET_ALERT_TEXT" class="property"><dl><dt>GET_ALERT_TEXT</dl></div><div id="GET_ALL_COOKIES" class="property"><dl><dt>GET_ALL_COOKIES</dl></div><div id="GET_APP_CACHE" class="property"><dl><dt>GET_APP_CACHE</dl></div><div id="GET_APP_CACHE_STATUS" class="property"><dl><dt>GET_APP_CACHE_STATUS</dl></div><div id="GET_AVAILABLE_LOG_TYPES" class="property"><dl><dt>GET_AVAILABLE_LOG_TYPES</dl></div><div id="GET_COOKIE" class="property"><dl><dt>GET_COOKIE</dl></div><div id="GET_CURRENT_URL" class="property"><dl><dt>GET_CURRENT_URL</dl></div><div id="GET_CURRENT_WINDOW_HANDLE" class="property"><dl><dt>GET_CURRENT_WINDOW_HANDLE</dl></div><div id="GET_ELEMENT_ATTRIBUTE" class="property"><dl><dt>GET_ELEMENT_ATTRIBUTE</dl></div><div id="GET_ELEMENT_LOCATION" class="property"><dl><dt>GET_ELEMENT_LOCATION</dl></div><div id="GET_ELEMENT_LOCATION_IN_VIEW" class="property"><dl><dt>GET_ELEMENT_LOCATION_IN_VIEW</dl></div><div id="GET_ELEMENT_SIZE" class="property"><dl><dt>GET_ELEMENT_SIZE</dl></div><div id="GET_ELEMENT_TAG_NAME" class="property"><dl><dt>GET_ELEMENT_TAG_NAME</dl></div><div id="GET_ELEMENT_TEXT" class="property"><dl><dt>GET_ELEMENT_TEXT</dl></div><div id="GET_ELEMENT_VALUE_OF_CSS_PROPERTY" class="property"><dl><dt>GET_ELEMENT_VALUE_OF_CSS_PROPERTY</dl></div><div id="GET_LOCAL_STORAGE_ITEM" class="property"><dl><dt>GET_LOCAL_STORAGE_ITEM</dl></div><div id="GET_LOCAL_STORAGE_KEYS" class="property"><dl><dt>GET_LOCAL_STORAGE_KEYS</dl></div><div id="GET_LOCAL_STORAGE_SIZE" class="property"><dl><dt>GET_LOCAL_STORAGE_SIZE</dl></div><div id="GET_LOCATION" class="property"><dl><dt>GET_LOCATION</dl></div><div id="GET_LOG" class="property"><dl><dt>GET_LOG</dl></div><div id="GET_PAGE_SOURCE" class="property"><dl><dt>GET_PAGE_SOURCE</dl></div><div id="GET_SCREEN_ORIENTATION" class="property"><dl><dt>GET_SCREEN_ORIENTATION</dl></div><div id="GET_SERVER_STATUS" class="property"><dl><dt>GET_SERVER_STATUS</dl></div><div id="GET_SESSIONS" class="property"><dl><dt>GET_SESSIONS</dl></div><div id="GET_SESSION_LOGS" class="property"><dl><dt>GET_SESSION_LOGS</dl></div><div id="GET_SESSION_STORAGE_ITEM" class="property"><dl><dt>GET_SESSION_STORAGE_ITEM</dl></div><div id="GET_SESSION_STORAGE_KEYS" class="property"><dl><dt>GET_SESSION_STORAGE_KEYS</dl></div><div id="GET_SESSION_STORAGE_SIZE" class="property"><dl><dt>GET_SESSION_STORAGE_SIZE</dl></div><div id="GET_TITLE" class="property"><dl><dt>GET_TITLE</dl></div><div id="GET_WINDOW_HANDLES" class="property"><dl><dt>GET_WINDOW_HANDLES</dl></div><div id="GET_WINDOW_POSITION" class="property"><dl><dt>GET_WINDOW_POSITION</dl></div><div id="GET_WINDOW_SIZE" class="property"><dl><dt>GET_WINDOW_SIZE</dl></div><div id="GO_BACK" class="property"><dl><dt>GO_BACK</dl></div><div id="GO_FORWARD" class="property"><dl><dt>GO_FORWARD</dl></div><div id="IMPLICITLY_WAIT" class="property"><dl><dt>IMPLICITLY_WAIT</dl></div><div id="IS_BROWSER_ONLINE" class="property"><dl><dt>IS_BROWSER_ONLINE</dl></div><div id="IS_ELEMENT_DISPLAYED" class="property"><dl><dt>IS_ELEMENT_DISPLAYED</dl></div><div id="IS_ELEMENT_ENABLED" class="property"><dl><dt>IS_ELEMENT_ENABLED</dl></div><div id="IS_ELEMENT_SELECTED" class="property"><dl><dt>IS_ELEMENT_SELECTED</dl></div><div id="MAXIMIZE_WINDOW" class="property"><dl><dt>MAXIMIZE_WINDOW</dl></div><div id="MOUSE_DOWN" class="property"><dl><dt>MOUSE_DOWN</dl></div><div id="MOUSE_UP" class="property"><dl><dt>MOUSE_UP</dl></div><div id="MOVE_TO" class="property"><dl><dt>MOVE_TO</dl></div><div id="NEW_SESSION" class="property"><dl><dt>NEW_SESSION</dl></div><div id="QUIT" class="property"><dl><dt>QUIT</dl></div><div id="REFRESH" class="property"><dl><dt>REFRESH</dl></div><div id="REMOVE_LOCAL_STORAGE_ITEM" class="property"><dl><dt>REMOVE_LOCAL_STORAGE_ITEM</dl></div><div id="REMOVE_SESSION_STORAGE_ITEM" class="property"><dl><dt>REMOVE_SESSION_STORAGE_ITEM</dl></div><div id="SCREENSHOT" class="property"><dl><dt>SCREENSHOT</dl></div><div id="SEND_KEYS_TO_ACTIVE_ELEMENT" class="property"><dl><dt>SEND_KEYS_TO_ACTIVE_ELEMENT</dl></div><div id="SEND_KEYS_TO_ELEMENT" class="property"><dl><dt>SEND_KEYS_TO_ELEMENT</dl></div><div id="SET_ALERT_TEXT" class="property"><dl><dt>SET_ALERT_TEXT</dl></div><div id="SET_BROWSER_ONLINE" class="property"><dl><dt>SET_BROWSER_ONLINE</dl></div><div id="SET_LOCAL_STORAGE_ITEM" class="property"><dl><dt>SET_LOCAL_STORAGE_ITEM</dl></div><div id="SET_LOCATION" class="property"><dl><dt>SET_LOCATION</dl></div><div id="SET_SCREEN_ORIENTATION" class="property"><dl><dt>SET_SCREEN_ORIENTATION</dl></div><div id="SET_SCRIPT_TIMEOUT" class="property"><dl><dt>SET_SCRIPT_TIMEOUT</dl></div><div id="SET_SESSION_STORAGE_ITEM" class="property"><dl><dt>SET_SESSION_STORAGE_ITEM</dl></div><div id="SET_TIMEOUT" class="property"><dl><dt>SET_TIMEOUT</dl></div><div id="SET_WINDOW_POSITION" class="property"><dl><dt>SET_WINDOW_POSITION</dl></div><div id="SET_WINDOW_SIZE" class="property"><dl><dt>SET_WINDOW_SIZE</dl></div><div id="SUBMIT_ELEMENT" class="property"><dl><dt>SUBMIT_ELEMENT</dl></div><div id="SWITCH_TO_FRAME" class="property"><dl><dt>SWITCH_TO_FRAME</dl></div><div id="SWITCH_TO_WINDOW" class="property"><dl><dt>SWITCH_TO_WINDOW</dl></div><div id="TOUCH_DOUBLE_TAP" class="property"><dl><dt>TOUCH_DOUBLE_TAP</dl></div><div id="TOUCH_DOWN" class="property"><dl><dt>TOUCH_DOWN</dl></div><div id="TOUCH_FLICK" class="property"><dl><dt>TOUCH_FLICK</dl></div><div id="TOUCH_LONG_PRESS" class="property"><dl><dt>TOUCH_LONG_PRESS</dl></div><div id="TOUCH_MOVE" class="property"><dl><dt>TOUCH_MOVE</dl></div><div id="TOUCH_SCROLL" class="property"><dl><dt>TOUCH_SCROLL</dl></div><div id="TOUCH_SINGLE_TAP" class="property"><dl><dt>TOUCH_SINGLE_TAP</dl></div><div id="TOUCH_UP" class="property"><dl><dt>TOUCH_UP</dl></div><div id="UPLOAD_FILE" class="property"><dl><dt>UPLOAD_FILE</dl></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>
\ No newline at end of file
diff --git a/docs/enum_webdriver_FirefoxDomExecutor_Attribute_.html b/docs/enum_webdriver_FirefoxDomExecutor_Attribute_.html
index 991d820..e8dddad 100644
--- a/docs/enum_webdriver_FirefoxDomExecutor_Attribute_.html
+++ b/docs/enum_webdriver_FirefoxDomExecutor_Attribute_.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.FirefoxDomExecutor.Attribute_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.FirefoxDomExecutor.Attribute_</h1><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l65">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Attributes used to communicate with the FirefoxDriver extension.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="private"><dt><a class="enum member" name="webdriver.FirefoxDomExecutor.Attribute_.COMMAND">COMMAND</a><dt><a class="enum member" name="webdriver.FirefoxDomExecutor.Attribute_.RESPONSE">RESPONSE</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.FirefoxDomExecutor.Attribute_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.FirefoxDomExecutor.Attribute_</h1><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l65">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Attributes used to communicate with the FirefoxDriver extension.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="private"><dt><a class="enum member" name="webdriver.FirefoxDomExecutor.Attribute_.COMMAND">COMMAND</a><dt><a class="enum member" name="webdriver.FirefoxDomExecutor.Attribute_.RESPONSE">RESPONSE</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_webdriver_FirefoxDomExecutor_EventType_.html b/docs/enum_webdriver_FirefoxDomExecutor_EventType_.html
index 77449eb..f59505e 100644
--- a/docs/enum_webdriver_FirefoxDomExecutor_EventType_.html
+++ b/docs/enum_webdriver_FirefoxDomExecutor_EventType_.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.FirefoxDomExecutor.EventType_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.FirefoxDomExecutor.EventType_</h1><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l76">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Events used to communicate with the FirefoxDriver extension.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="private"><dt><a class="enum member" name="webdriver.FirefoxDomExecutor.EventType_.COMMAND">COMMAND</a><dt><a class="enum member" name="webdriver.FirefoxDomExecutor.EventType_.RESPONSE">RESPONSE</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.FirefoxDomExecutor.EventType_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.FirefoxDomExecutor.EventType_</h1><a class="source" href="source/lib/webdriver/firefoxdomexecutor.js.src.html#l76">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Events used to communicate with the FirefoxDriver extension.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="private"><dt><a class="enum member" name="webdriver.FirefoxDomExecutor.EventType_.COMMAND">COMMAND</a><dt><a class="enum member" name="webdriver.FirefoxDomExecutor.EventType_.RESPONSE">RESPONSE</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_webdriver_Key.html b/docs/enum_webdriver_Key.html
index 04cb3f2..f10c503 100644
--- a/docs/enum_webdriver_Key.html
+++ b/docs/enum_webdriver_Key.html
@@ -1,9 +1,12 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.Key</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.Key</h1><a class="source" href="source/lib/webdriver/key.js.src.html#l25">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Representations of pressable keys that aren't text.  These are stored in
- the Unicode PUA (Private Use Area) code points, 0xE000-0xF8FF.  Refer to
- http://www.google.com.au/search?&q=unicode+pua&btnG=Search<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.Key.ADD">ADD</a><dt><a class="enum member" name="webdriver.Key.ALT">ALT</a><dt><a class="enum member" name="webdriver.Key.ARROW_DOWN">ARROW_DOWN</a><dt><a class="enum member" name="webdriver.Key.ARROW_LEFT">ARROW_LEFT</a><dt><a class="enum member" name="webdriver.Key.ARROW_RIGHT">ARROW_RIGHT</a><dt><a class="enum member" name="webdriver.Key.ARROW_UP">ARROW_UP</a><dt><a class="enum member" name="webdriver.Key.BACK_SPACE">BACK_SPACE</a><dt><a class="enum member" name="webdriver.Key.CANCEL">CANCEL</a><dt><a class="enum member" name="webdriver.Key.CLEAR">CLEAR</a><dt><a class="enum member" name="webdriver.Key.COMMAND">COMMAND</a><dt><a class="enum member" name="webdriver.Key.CONTROL">CONTROL</a><dt><a class="enum member" name="webdriver.Key.DECIMAL">DECIMAL</a><dt><a class="enum member" name="webdriver.Key.DELETE">DELETE</a><dt><a class="enum member" name="webdriver.Key.DIVIDE">DIVIDE</a><dt><a class="enum member" name="webdriver.Key.DOWN">DOWN</a><dt><a class="enum member" name="webdriver.Key.END">END</a><dt><a class="enum member" name="webdriver.Key.ENTER">ENTER</a><dt><a class="enum member" name="webdriver.Key.EQUALS">EQUALS</a><dt><a class="enum member" name="webdriver.Key.ESCAPE">ESCAPE</a><dt><a class="enum member" name="webdriver.Key.F1">F1</a><dt><a class="enum member" name="webdriver.Key.F10">F10</a><dt><a class="enum member" name="webdriver.Key.F11">F11</a><dt><a class="enum member" name="webdriver.Key.F12">F12</a><dt><a class="enum member" name="webdriver.Key.F2">F2</a><dt><a class="enum member" name="webdriver.Key.F3">F3</a><dt><a class="enum member" name="webdriver.Key.F4">F4</a><dt><a class="enum member" name="webdriver.Key.F5">F5</a><dt><a class="enum member" name="webdriver.Key.F6">F6</a><dt><a class="enum member" name="webdriver.Key.F7">F7</a><dt><a class="enum member" name="webdriver.Key.F8">F8</a><dt><a class="enum member" name="webdriver.Key.F9">F9</a><dt><a class="enum member" name="webdriver.Key.HELP">HELP</a><dt><a class="enum member" name="webdriver.Key.HOME">HOME</a><dt><a class="enum member" name="webdriver.Key.INSERT">INSERT</a><dt><a class="enum member" name="webdriver.Key.LEFT">LEFT</a><dt><a class="enum member" name="webdriver.Key.META">META</a><dt><a class="enum member" name="webdriver.Key.MULTIPLY">MULTIPLY</a><dt><a class="enum member" name="webdriver.Key.NULL">NULL</a><dt><a class="enum member" name="webdriver.Key.NUMPAD0">NUMPAD0</a><dt><a class="enum member" name="webdriver.Key.NUMPAD1">NUMPAD1</a><dt><a class="enum member" name="webdriver.Key.NUMPAD2">NUMPAD2</a><dt><a class="enum member" name="webdriver.Key.NUMPAD3">NUMPAD3</a><dt><a class="enum member" name="webdriver.Key.NUMPAD4">NUMPAD4</a><dt><a class="enum member" name="webdriver.Key.NUMPAD5">NUMPAD5</a><dt><a class="enum member" name="webdriver.Key.NUMPAD6">NUMPAD6</a><dt><a class="enum member" name="webdriver.Key.NUMPAD7">NUMPAD7</a><dt><a class="enum member" name="webdriver.Key.NUMPAD8">NUMPAD8</a><dt><a class="enum member" name="webdriver.Key.NUMPAD9">NUMPAD9</a><dt><a class="enum member" name="webdriver.Key.PAGE_DOWN">PAGE_DOWN</a><dt><a class="enum member" name="webdriver.Key.PAGE_UP">PAGE_UP</a><dt><a class="enum member" name="webdriver.Key.PAUSE">PAUSE</a><dt><a class="enum member" name="webdriver.Key.RETURN">RETURN</a><dt><a class="enum member" name="webdriver.Key.RIGHT">RIGHT</a><dt><a class="enum member" name="webdriver.Key.SEMICOLON">SEMICOLON</a><dt><a class="enum member" name="webdriver.Key.SEPARATOR">SEPARATOR</a><dt><a class="enum member" name="webdriver.Key.SHIFT">SHIFT</a><dt><a class="enum member" name="webdriver.Key.SPACE">SPACE</a><dt><a class="enum member" name="webdriver.Key.SUBTRACT">SUBTRACT</a><dt><a class="enum member" name="webdriver.Key.TAB">TAB</a><dt><a class="enum member" name="webdriver.Key.UP">UP</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/webdriver.js.src.html#l1449">code &raquo;</a><span class="member"><a name="webdriver.Key.chord">webdriver.Key.chord</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Simulate pressing many keys at once in a "chord". Takes a sequence of
- <code  class="type"><a href="enum_webdriver_Key.html">webdriver.Key</a></code>s or strings, appends each of the values to a string,
- and adds the chord termination key (<code  class="type"><a href="enum_webdriver_Key.html#webdriver.Key.NULL">webdriver.Key.NULL</a></code>) and returns
- the resultant string.
-
- Note: when the low-level webdriver key handlers see Keys.NULL, active
- modifier keys (CTRL/ALT/SHIFT/etc) release via a keyup event.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key sequence to concatenate.</dl><tr><th>Returns<tr><td><dl>The null-terminated key sequence.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Key</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/key.js.src.html#l28">View Source</a></div><h1>enum Key</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl><p>Representations of pressable keys that aren&#39;t text.  These are stored in
+the Unicode PUA (Private Use Area) code points, 0xE000-0xF8FF.  Refer to
+http://www.google.com.au/search?&amp;q&#61;unicode&#43;pua&amp;btnG&#61;Search</p>
+<h2>Values and Descriptions</h2><div id="ADD" class="property"><dl><dt>ADD</dl></div><div id="ALT" class="property"><dl><dt>ALT</dl></div><div id="ARROW_DOWN" class="property"><dl><dt>ARROW_DOWN</dl></div><div id="ARROW_LEFT" class="property"><dl><dt>ARROW_LEFT</dl></div><div id="ARROW_RIGHT" class="property"><dl><dt>ARROW_RIGHT</dl></div><div id="ARROW_UP" class="property"><dl><dt>ARROW_UP</dl></div><div id="BACK_SPACE" class="property"><dl><dt>BACK_SPACE</dl></div><div id="CANCEL" class="property"><dl><dt>CANCEL</dl></div><div id="CLEAR" class="property"><dl><dt>CLEAR</dl></div><div id="COMMAND" class="property"><dl><dt>COMMAND</dl></div><div id="CONTROL" class="property"><dl><dt>CONTROL</dl></div><div id="DECIMAL" class="property"><dl><dt>DECIMAL</dl></div><div id="DELETE" class="property"><dl><dt>DELETE</dl></div><div id="DIVIDE" class="property"><dl><dt>DIVIDE</dl></div><div id="DOWN" class="property"><dl><dt>DOWN</dl></div><div id="END" class="property"><dl><dt>END</dl></div><div id="ENTER" class="property"><dl><dt>ENTER</dl></div><div id="EQUALS" class="property"><dl><dt>EQUALS</dl></div><div id="ESCAPE" class="property"><dl><dt>ESCAPE</dl></div><div id="F1" class="property"><dl><dt>F1</dl></div><div id="F10" class="property"><dl><dt>F10</dl></div><div id="F11" class="property"><dl><dt>F11</dl></div><div id="F12" class="property"><dl><dt>F12</dl></div><div id="F2" class="property"><dl><dt>F2</dl></div><div id="F3" class="property"><dl><dt>F3</dl></div><div id="F4" class="property"><dl><dt>F4</dl></div><div id="F5" class="property"><dl><dt>F5</dl></div><div id="F6" class="property"><dl><dt>F6</dl></div><div id="F7" class="property"><dl><dt>F7</dl></div><div id="F8" class="property"><dl><dt>F8</dl></div><div id="F9" class="property"><dl><dt>F9</dl></div><div id="HELP" class="property"><dl><dt>HELP</dl></div><div id="HOME" class="property"><dl><dt>HOME</dl></div><div id="INSERT" class="property"><dl><dt>INSERT</dl></div><div id="LEFT" class="property"><dl><dt>LEFT</dl></div><div id="META" class="property"><dl><dt>META</dl></div><div id="MULTIPLY" class="property"><dl><dt>MULTIPLY</dl></div><div id="NULL" class="property"><dl><dt>NULL</dl></div><div id="NUMPAD0" class="property"><dl><dt>NUMPAD0</dl></div><div id="NUMPAD1" class="property"><dl><dt>NUMPAD1</dl></div><div id="NUMPAD2" class="property"><dl><dt>NUMPAD2</dl></div><div id="NUMPAD3" class="property"><dl><dt>NUMPAD3</dl></div><div id="NUMPAD4" class="property"><dl><dt>NUMPAD4</dl></div><div id="NUMPAD5" class="property"><dl><dt>NUMPAD5</dl></div><div id="NUMPAD6" class="property"><dl><dt>NUMPAD6</dl></div><div id="NUMPAD7" class="property"><dl><dt>NUMPAD7</dl></div><div id="NUMPAD8" class="property"><dl><dt>NUMPAD8</dl></div><div id="NUMPAD9" class="property"><dl><dt>NUMPAD9</dl></div><div id="PAGE_DOWN" class="property"><dl><dt>PAGE_DOWN</dl></div><div id="PAGE_UP" class="property"><dl><dt>PAGE_UP</dl></div><div id="PAUSE" class="property"><dl><dt>PAUSE</dl></div><div id="RETURN" class="property"><dl><dt>RETURN</dl></div><div id="RIGHT" class="property"><dl><dt>RIGHT</dl></div><div id="SEMICOLON" class="property"><dl><dt>SEMICOLON</dl></div><div id="SEPARATOR" class="property"><dl><dt>SEPARATOR</dl></div><div id="SHIFT" class="property"><dl><dt>SHIFT</dl></div><div id="SPACE" class="property"><dl><dt>SPACE</dl></div><div id="SUBTRACT" class="property"><dl><dt>SUBTRACT</dl></div><div id="TAB" class="property"><dl><dt>TAB</dl></div><div id="UP" class="property"><dl><dt>UP</dl></div><h2>Functions</h2><div id="Key.chord" class="function"><div><h3>Key.chord(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1658">code »</a></span></h3><p>Simulate pressing many keys at once in a &#34;chord&#34;. Takes a sequence of
+<a href="enum_webdriver_Key.html"><code>webdriver.Key</code></a>s or strings, appends each of the values to a string,
+and adds the chord termination key (<a href="enum_webdriver_Key.html#NULL"><code>webdriver.Key.NULL</code></a>) and returns
+the resultant string.</p>
+<p>Note: when the low-level webdriver key handlers see Keys.NULL, active
+modifier keys (CTRL/ALT/SHIFT/etc) release via a keyup event.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The key sequence to concatenate.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The null-terminated key sequence.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/enum_webdriver_logging_Level.html b/docs/enum_webdriver_logging_Level.html
index 96cce56..be4d555 100644
--- a/docs/enum_webdriver_logging_Level.html
+++ b/docs/enum_webdriver_logging_Level.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.logging.Level</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.logging.Level</h1><a class="source" href="source/lib/webdriver/logging.js.src.html#l40">code &raquo;</a><dl><dt>Type: <code class="type">{value: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, name: <a href="enum_webdriver_logging_LevelName.html">webdriver.logging.LevelName</a>}</code></dl></header><section><p>Logging levels.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.logging.Level.ALL">ALL</a><dt><a class="enum member" name="webdriver.logging.Level.DEBUG">DEBUG</a><dt><a class="enum member" name="webdriver.logging.Level.INFO">INFO</a><dt><a class="enum member" name="webdriver.logging.Level.OFF">OFF</a><dt><a class="enum member" name="webdriver.logging.Level.SEVERE">SEVERE</a><dt><a class="enum member" name="webdriver.logging.Level.WARNING">WARNING</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.logging.Level</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.logging.Level</h1><a class="source" href="source/lib/webdriver/logging.js.src.html#l26">code &raquo;</a><dl><dt>Type: <code class="type">{value: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code></dl></header><section><p>Logging levels.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.logging.Level.ALL">ALL</a><dt><a class="enum member" name="webdriver.logging.Level.DEBUG">DEBUG</a><dt><a class="enum member" name="webdriver.logging.Level.INFO">INFO</a><dt><a class="enum member" name="webdriver.logging.Level.OFF">OFF</a><dt><a class="enum member" name="webdriver.logging.Level.SEVERE">SEVERE</a><dt><a class="enum member" name="webdriver.logging.Level.WARNING">WARNING</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/enum_webdriver_logging_Type.html b/docs/enum_webdriver_logging_Type.html
index c69f777..af2f036 100644
--- a/docs/enum_webdriver_logging_Type.html
+++ b/docs/enum_webdriver_logging_Type.html
@@ -1 +1,6 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.logging.Type</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.logging.Type</h1><a class="source" href="source/lib/webdriver/logging.js.src.html#l72">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Common log types.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.logging.Type.BROWSER">BROWSER</a><dd>Logs originating from the browser.<dt><a class="enum member" name="webdriver.logging.Type.CLIENT">CLIENT</a><dd>Logs from a WebDriver client.<dt><a class="enum member" name="webdriver.logging.Type.DRIVER">DRIVER</a><dd>Logs from a WebDriver implementation.<dt><a class="enum member" name="webdriver.logging.Type.PERFORMANCE">PERFORMANCE</a><dd>Logs related to performance.<dt><a class="enum member" name="webdriver.logging.Type.SERVER">SERVER</a><dd>Logs from the remote server.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Type</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_logging.html">webdriver.logging</a></div><div class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l246">View Source</a></div><h1>enum Type</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl><h2>Values and Descriptions</h2><div id="BROWSER" class="property"><dl><dt>BROWSER<dd><p>Logs originating from the browser.</p>
+</dl></div><div id="CLIENT" class="property"><dl><dt>CLIENT<dd><p>Logs from a WebDriver client.</p>
+</dl></div><div id="DRIVER" class="property"><dl><dt>DRIVER<dd><p>Logs from a WebDriver implementation.</p>
+</dl></div><div id="PERFORMANCE" class="property"><dl><dt>PERFORMANCE<dd><p>Logs related to performance.</p>
+</dl></div><div id="SERVER" class="property"><dl><dt>SERVER<dd><p>Logs from the remote server.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/enum_webdriver_promise_ControlFlow_EventType.html b/docs/enum_webdriver_promise_ControlFlow_EventType.html
index 6947eb6..143fce8 100644
--- a/docs/enum_webdriver_promise_ControlFlow_EventType.html
+++ b/docs/enum_webdriver_promise_ControlFlow_EventType.html
@@ -1,4 +1,9 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.ControlFlow.EventType</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.promise.ControlFlow.EventType</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l1066">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></header><section><p>Events that may be emitted by an <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="public"><dt><a class="enum member" name="webdriver.promise.ControlFlow.EventType.IDLE">IDLE</a><dd>Emitted when all tasks have been successfully executed.<dt><a class="enum member" name="webdriver.promise.ControlFlow.EventType.SCHEDULE_TASK">SCHEDULE_TASK</a><dd>Emitted whenever a new task has been scheduled.<dt><a class="enum member" name="webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION">UNCAUGHT_EXCEPTION</a><dd>Emitted whenever a control flow aborts due to an unhandled promise
- rejection. This event will be emitted along with the offending rejection
- reason. Upon emitting this event, the control flow will empty its task
- queue and revert to its initial state.</dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>ControlFlow.EventType</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_promise.html">webdriver.promise</a></div><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2410">View Source</a></div><h1>enum ControlFlow.EventType</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl><p>Events that may be emitted by an <a href="class_webdriver_promise_ControlFlow.html"><code>webdriver.promise.ControlFlow</code></a>.</p>
+<h2>Values and Descriptions</h2><div id="IDLE" class="property"><dl><dt>IDLE<dd><p>Emitted when all tasks have been successfully executed.</p>
+</dl></div><div id="RESET" class="property"><dl><dt>RESET<dd><p>Emitted when a ControlFlow has been reset.</p>
+</dl></div><div id="SCHEDULE_TASK" class="property"><dl><dt>SCHEDULE_TASK<dd><p>Emitted whenever a new task has been scheduled.</p>
+</dl></div><div id="UNCAUGHT_EXCEPTION" class="property"><dl><dt>UNCAUGHT_EXCEPTION<dd><p>Emitted whenever a control flow aborts due to an unhandled promise
+rejection. This event will be emitted along with the offending rejection
+reason. Upon emitting this event, the control flow will empty its task
+queue and revert to its initial state.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/enum_webdriver_promise_Deferred_State_.html b/docs/enum_webdriver_promise_Deferred_State_.html
index 7468bf8..80ca09e 100644
--- a/docs/enum_webdriver_promise_Deferred_State_.html
+++ b/docs/enum_webdriver_promise_Deferred_State_.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Deferred.State_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.promise.Deferred.State_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l566">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>The three states a <code  class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code> object may be in.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="private"><dt><a class="enum member" name="webdriver.promise.Deferred.State_.BLOCKED">BLOCKED</a><dt><a class="enum member" name="webdriver.promise.Deferred.State_.PENDING">PENDING</a><dt><a class="enum member" name="webdriver.promise.Deferred.State_.REJECTED">REJECTED</a><dt><a class="enum member" name="webdriver.promise.Deferred.State_.RESOLVED">RESOLVED</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise.Deferred.State_</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Enum webdriver.promise.Deferred.State_</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l585">code &raquo;</a><dl><dt>Type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></dl></header><section><p>The three states a <code  class="type"><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code> object may be in.<h2>Values and Descriptions</h2><div class="type-summary"><dl class="private"><dt><a class="enum member" name="webdriver.promise.Deferred.State_.BLOCKED">BLOCKED</a><dt><a class="enum member" name="webdriver.promise.Deferred.State_.PENDING">PENDING</a><dt><a class="enum member" name="webdriver.promise.Deferred.State_.REJECTED">REJECTED</a><dt><a class="enum member" name="webdriver.promise.Deferred.State_.RESOLVED">RESOLVED</a></dl></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/index.html b/docs/index.html
index 4d91ae5..cd04035 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,60 +1,124 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>Index</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><main><p><h1>selenium-webdriver</h1>
+<!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>Index</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="indexfile"><h1>selenium-webdriver</h1>
+<p>Selenium is a browser automation library. Most often used for testing
+web-applications, Selenium may be used for any task that requires automating
+interaction with the browser.</p>
 <h2>Installation</h2>
-<p>Install the latest published version using <code>npm</code>:</p>
+<p>Install via npm with</p>
 <pre><code>npm install selenium-webdriver
 </code></pre>
-<p>In addition to the npm package, you will to download the WebDriver
-implementations you wish to utilize. As of 2.34.0, <code>selenium-webdriver</code>
-natively supports the <a href="http://chromedriver.storage.googleapis.com/index.html">ChromeDriver</a>.
-Simply download a copy and make sure it can be found on your <code>PATH</code>. The other
-drivers (e.g. Firefox, Internet Explorer, and Safari), still require the
-<a href="http://selenium-release.storage.googleapis.com/index.html">standalone Selenium server</a>.</p>
-<h3>Running the tests</h3>
-<p>To run the tests, you will need to download a copy of the
-<a href="http://chromedriver.storage.googleapis.com/index.html">ChromeDriver</a> and make
-sure it can be found on your <code>PATH</code>.</p>
-<pre><code>npm test selenium-webdriver
-</code></pre>
-<p>To run the tests against multiple browsers, download the
-<a href="http://selenium-release.storage.googleapis.com/index.html">Selenium server</a> and
-specify its location through the <code>SELENIUM_SERVER_JAR</code> environment variable.
-You can use the <code>SELENIUM_BROWSER</code> environment variable to define a
-comma-separated list of browsers you wish to test against. For example:</p>
-<pre><code>export SELENIUM_SERVER_JAR=path/to/selenium-server-standalone-2.33.0.jar
-SELENIUM_BROWSER=chrome,firefox npm test selenium-webdriver
-</code></pre>
+<p>Out of the box, Selenium includes everything you need to work with Firefox. You
+will need to download additional components to work with the other major
+browsers. The drivers for Chrome, IE, PhantomJS, and Opera are all standalone
+executables that should be placed on your
+<a href="http://en.wikipedia.org/wiki/PATH_%28variable%29">PATH</a>. The SafariDriver
+browser extension should be installed in your browser before using Selenium; we
+recommend disabling the extension when using the browser without Selenium or
+installing the extension in a profile only used for testing.</p>
+<table><thead><tr><th>Browser</th><th>Component</th></tr></thead><tbody><tr><td>Chrome</td><td><a href="http://chromedriver.storage.googleapis.com/index.html">chromedriver(.exe)</a></td></tr><tr><td>Internet Explorer</td><td><a href="http://selenium-release.storage.googleapis.com/index.html">IEDriverServer.exe</a></td></tr><tr><td>PhantomJS</td><td><a href="http://phantomjs.org/">phantomjs(.exe)</a></td></tr><tr><td>Opera</td><td><a href="https://github.com/operasoftware/operachromiumdriver/releases">operadriver(.exe)</a></td></tr><tr><td>Safari</td><td><a href="http://selenium-release.storage.googleapis.com/index.html">SafariDriver.safariextz</a></td></tr></tbody></table>
 <h2>Usage</h2>
-<pre><code>var webdriver = require('selenium-webdriver');
-
-var driver = new webdriver.Builder().
-    withCapabilities(webdriver.Capabilities.chrome()).
-    build();
+<p>The sample below and others are included in the <code>example</code> directory. You may
+also find the tests for selenium-webdriver informative.</p>
+<pre><code>var webdriver &#61; require(&#39;selenium-webdriver&#39;),
+    By &#61; require(&#39;selenium-webdriver&#39;).By,
+    until &#61; require(&#39;selenium-webdriver&#39;).until;
 
-driver.get('http://www.google.com');
-driver.findElement(webdriver.By.name('q')).sendKeys('webdriver');
-driver.findElement(webdriver.By.name('btnG')).click();
-driver.wait(function() {
-  return driver.getTitle().then(function(title) {
-    return title === 'webdriver - Google Search';
-  });
-}, 1000);
+var driver &#61; new webdriver.Builder()
+    .forBrowser(&#39;firefox&#39;)
+    .build();
 
+driver.get(&#39;http://www.google.com/ncr&#39;);
+driver.findElement(By.name(&#39;q&#39;)).sendKeys(&#39;webdriver&#39;);
+driver.findElement(By.name(&#39;btnG&#39;)).click();
+driver.wait(until.titleIs(&#39;webdriver - Google Search&#39;), 1000);
 driver.quit();
 </code></pre>
+<h3>Using the Builder API</h3>
+<p>The <code>Builder</code> class is your one-stop shop for configuring new WebDriver
+instances. Rather than clutter your code with branches for the various browsers,
+the builder lets you set all options in one flow. When you call
+<code>Builder#build()</code>, all options irrelevant to the selected browser are dropped:</p>
+<pre><code>var webdriver &#61; require(&#39;selenium-webdriver&#39;),
+    chrome &#61; require(&#39;selenium-webdriver/chrome&#39;),
+    firefox &#61; require(&#39;selenium-webdriver/firefox&#39;);
+
+var driver &#61; new webdriver.Builder()
+    .forBrowser(&#39;firefox&#39;)
+    .setChromeOptions(/* ... */)
+    .setFirefoxOptions(/* ... */)
+    .build();
+</code></pre>
+<p>Why would you want to configure options irrelevant to the target browser? The
+<code>Builder</code>&#39;s API defines your <em>default</em> configuration. You can change the target
+browser at runtime through the <code>SELENIUM_BROWSER</code> environment variable. For
+example, the <code>example/google_search.js</code> script is configured to run against
+Firefox. You can run the example against other browsers just by changing the
+runtime environment</p>
+<pre><code># cd node_modules/selenium-webdriver
+node example/google_search
+SELENIUM_BROWSER&#61;chrome node example/google_search
+SELENIUM_BROWSER&#61;safari node example/google_search
+</code></pre>
+<h3>The Standalone Selenium Server</h3>
+<p>The standalone Selenium Server acts as a proxy between your script and the
+browser-specific drivers. The server may be used when running locally, but it&#39;s
+not recommend as it introduces an extra hop for each request and will slow
+things down. The server is required, however, to use a browser on a remote host
+(most browser drivers, like the IEDriverServer, do not accept remote
+connections).</p>
+<p>To use the Selenium Server, you will need to install the
+<a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">JDK</a> and
+download the latest server from <a href="http://selenium-release.storage.googleapis.com/index.html">Selenium</a>. Once downloaded, run the
+server with</p>
+<pre><code>java -jar selenium-server-standalone-2.45.0.jar
+</code></pre>
+<p>You may configure your tests to run against a remote server through the Builder
+API:</p>
+<pre><code>var driver &#61; new webdriver.Builder()
+    .forBrowser(&#39;firefox&#39;)
+    .usingServer(&#39;http://localhost:4444/wd/hub&#39;)
+    .build();
+</code></pre>
+<p>Or change the Builder&#39;s configuration at runtime with the <code>SELENIUM_REMOTE_URL</code>
+environment variable:</p>
+<pre><code>SELENIUM_REMOTE_URL&#61;&#34;http://localhost:4444/wd/hub&#34; node script.js
+</code></pre>
+<p>You can experiment with these options using the <code>example/google_search.js</code>
+script provided with <code>selenium-webdriver</code>.</p>
 <h2>Documentation</h2>
-<p>Full documentation is available on the <a href="http://code.google.com/p/selenium/wiki/WebDriverJs" title="User guide">Selenium project wiki</a>.</p>
+<p>API documentation is included in the <code>docs</code> directory and is also available
+online from the <a href="http://selenium.googlecode.com/git/docs/api/javascript/index.html">Selenium project</a>. Addition resources include</p>
+<ul><li>the #selenium channel on freenode IRC</li><li>the <a href="https://groups.google.com/forum/#!forum/selenium-users">selenium-users&#64;googlegroups.com</a> list</li><li><a href="http://www.seleniumhq.org/docs/">SeleniumHQ</a> documentation</li></ul>
+<h2>Contributing</h2>
+<p>Contributions are accepted either through <a href="https://github.com/SeleniumHQ/selenium/">GitHub</a> pull requests or patches
+via the <a href="https://github.com/SeleniumHQ/selenium/issues">Selenium issue tracker</a>. You must sign our
+<a href="http://goo.gl/qC50R">Contributor License Agreement</a> before your changes will be accepted.</p>
 <h2>Issues</h2>
-<p>Please report any issues using the <a href="https://code.google.com/p/selenium/issues/list">Selenium issue tracker</a>.</p>
+<p>Please report any issues using the <a href="https://github.com/SeleniumHQ/selenium/issues">Selenium issue tracker</a>. When using
+the issue tracker</p>
+<ul><li><strong>Do</strong> include a detailed description of the problem.</li><li><strong>Do</strong> include a link to a <a href="http://gist.github.com/">gist</a> with any
+interesting stack traces/logs (you may also attach these directly to the bug
+report).</li><li><strong>Do</strong> include a <a href="http://www.webkit.org/quality/reduction.html">reduced test case</a>. Reporting &#34;unable to find
+element on the page&#34; is <em>not</em> a valid report - there&#39;s nothing for us to
+look into. Expect your bug report to be closed if you do not provide enough
+information for us to investigate.</li><li><strong>Do not</strong> use the issue tracker to submit basic help requests. All help
+inquiries should be directed to the <a href="https://groups.google.com/forum/#!forum/selenium-users">user forum</a> or #selenium IRC
+channel.</li><li><strong>Do not</strong> post empty &#34;I see this too&#34; or &#34;Any updates?&#34; comments. These
+provide no additional information and clutter the log.</li><li><strong>Do not</strong> report regressions on closed bugs as they are not actively
+monitored for upates (especially bugs that are &gt;6 months old). Please open a
+new issue and reference the original bug in your report.</li></ul>
 <h2>License</h2>
-<p>Copyright 2009-2014 Software Freedom Conservancy</p>
-<p>Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at</p>
-<pre><code> http://www.apache.org/licenses/LICENSE-2.0
-</code></pre>
-<p>Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.</p>
-</main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<p>Licensed to the Software Freedom Conservancy (SFC) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The SFC licenses this file
+to you under the Apache License, Version 2.0 (the
+&#34;License&#34;); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at</p>
+<p>http://www.apache.org/licenses/LICENSE-2.0</p>
+<p>Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+&#34;AS IS&#34; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.</p>
+</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>
\ No newline at end of file
diff --git a/docs/interface_goog_debug_EntryPointMonitor.html b/docs/interface_goog_debug_EntryPointMonitor.html
new file mode 100644
index 0000000..e730ac1
--- /dev/null
+++ b/docs/interface_goog_debug_EntryPointMonitor.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug.EntryPointMonitor</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface goog.debug.EntryPointMonitor</h1><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l38">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l66">code &raquo;</a><span class="member"><a name="unwrap">unwrap</a> <span class="args">( fn )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Try to remove an instrumentation wrapper created by this monitor.
+ If the function passed to unwrap is not a wrapper created by this
+ monitor, then we will do nothing.
+
+ Notice that some wrappers may not be unwrappable. For example, if other
+ monitors have applied their own wrappers, then it will be impossible to
+ unwrap them because their wrappers will have captured our wrapper.
+
+ So it is important that entry points are unwrapped in the reverse
+ order that they were wrapped.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function to unwrap.</dl><tr><th>Returns<tr><td><dl>The unwrapped function, or <code >fn</code> if it was not
+     a wrapped function created by this monitor.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l47">code &raquo;</a><span class="member"><a name="wrap">wrap</a> <span class="args">( fn )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Instruments a function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function to instrument.</dl><tr><th>Returns<tr><td><dl>The instrumented function.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/interface_goog_disposable_IDisposable.html b/docs/interface_goog_disposable_IDisposable.html
new file mode 100644
index 0000000..54a3411
--- /dev/null
+++ b/docs/interface_goog_disposable_IDisposable.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.disposable.IDisposable</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface goog.disposable.IDisposable</h1><a class="source" href="source/lib/goog/disposable/idisposable.js.src.html#l32">code &raquo;</a></header><section><p>Interface for a disposable object.  If a instance requires cleanup
+ (references COM objects, DOM notes, or other disposable objects), it should
+ implement this interface (it may subclass goog.Disposable).</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/idisposable.js.src.html#l39">code &raquo;</a><span class="member"><a name="dispose">dispose</a> <span class="args">( )</span> &rArr; <code class="type">void</code></span></div><p>Disposes of the object and its resources.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Nothing.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/idisposable.js.src.html#l45">code &raquo;</a><span class="member"><a name="isDisposed">isDisposed</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the object has been disposed of.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/interface_goog_events_Listenable.html b/docs/interface_goog_events_Listenable.html
new file mode 100644
index 0000000..e5837e8
--- /dev/null
+++ b/docs/interface_goog_events_Listenable.html
@@ -0,0 +1,84 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.Listenable</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface goog.events.Listenable</h1><a class="source" href="source/lib/goog/events/listenable.js.src.html#l54">code &raquo;</a></header><section><p>A listenable interface. A listenable is an object with the ability
+ to dispatch/broadcast events to "event listeners" registered via
+ listen/listenOnce.
+
+ The interface allows for an event propagation mechanism similar
+ to one offered by native browser event targets, such as
+ capture/bubble mechanism, stopping propagation, and preventing
+ default actions. Capture/bubble mechanism depends on the ancestor
+ tree constructed via <code >#getParentEventTarget</code>; this tree
+ must be directed acyclic graph. The meaning of default action(s)
+ in preventDefault is specific to a particular use case.
+
+ Implementations that do not support capture/bubble or can not have
+ a parent listenable can simply not implement any ability to set the
+ parent listenable (and have <code >#getParentEventTarget</code> return
+ null).
+
+ Implementation of this class can be used with or independently from
+ goog.events.
+
+ Implementation must call <code >#addImplementation(implClass)</code>.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l176">code &raquo;</a><span class="member"><a name="dispatchEvent">dispatchEvent</a> <span class="args">( e )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Dispatches an event (or event like object) and calls all listeners
+ listening for events of this type. The type of the event is decided by the
+ type property on the event object.
+
+ If any of the listeners returns false OR calls preventDefault then this
+ function will return false.  If one of the capture listeners calls
+ stopPropagation, then the bubble listeners won't fire.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type"><a href="namespace_goog_events.html#goog.events.EventLike">goog.events.EventLike</a></code><dd>Event object.</dl><tr><th>Returns<tr><td><dl>If anyone called preventDefault on the event object (or
+     if any of the listeners returns false) this will also return false.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l221">code &raquo;</a><code class="type">&lt;EVENTOBJ&gt;</code> <span class="member"><a name="fireListeners">fireListeners</a> <span class="args">( type, capture, eventObject )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Fires all registered listeners in this listenable for the given
+ type and capture mode, passing them the given eventObject. This
+ does not perform actual capture/bubble. Only implementors of the
+ interface should be using this.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;)</code><dd>The type of the
+     listeners to fire.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The capture mode of the listeners to fire.<dt>eventObject: <code class="type">EVENTOBJ</code><dd>The event object to fire.</dl><tr><th>Returns<tr><td><dl>Whether all listeners succeeded without
+     attempting to prevent default behavior. If any listener returns
+     false or called goog.events.Event#preventDefault, this returns
+     false.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l251">code &raquo;</a><code class="type">&lt;SCOPE, EVENTOBJ&gt;</code> <span class="member"><a name="getListener">getListener</a> <span class="args">( type, listener, capture, opt_listenerScope )</span> &rArr; <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code></span></div><p>Gets the goog.events.ListenableKey for the event or null if no such
+ listener is in use.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;)</code><dd>The name of the event
+     without the 'on' prefix.<dt>listener: <code class="type">function(this: SCOPE, EVENTOBJ): (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>The
+     listener function to get.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether the listener is a capturing listener.<dt>opt_listenerScope: <code class="type">SCOPE=</code><dd>Object in whose scope to call the
+     listener.</dl><tr><th>Returns<tr><td><dl>the found listener or null if not found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l234">code &raquo;</a><code class="type">&lt;EVENTOBJ&gt;</code> <span class="member"><a name="getListeners">getListeners</a> <span class="args">( type, capture )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a>&gt;</code></span></div><p>Gets all listeners in this listenable for the given type and
+ capture mode.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>The type of the listeners to fire.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The capture mode of the listeners to fire.</dl><tr><th>Returns<tr><td><dl>An array of registered
+     listeners.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l202">code &raquo;</a><span class="member"><a name="getParentEventTarget">getParentEventTarget</a> <span class="args">( )</span> &rArr; <code class="type"><a href="interface_goog_events_Listenable.html">goog.events.Listenable</a></code></span></div><p>Returns the parent of this event target to use for capture/bubble
+ mechanism.
+
+ NOTE(user): The name reflects the original implementation of
+ custom event target (<code >goog.events.EventTarget</code>). We decided
+ that changing the name is not worth it.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The parent EventTarget or null if
+     there is no parent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l266">code &raquo;</a><code class="type">&lt;EVENTOBJ&gt;</code> <span class="member"><a name="hasListener">hasListener</a> <span class="args">( opt_type, opt_capture )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether there is any active listeners matching the specified
+ signature. If either the type or capture parameters are
+ unspecified, the function will match on the remaining criteria.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;)=</code><dd>Event type.<dt>opt_capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to check for capture or bubble
+     listeners.</dl><tr><th>Returns<tr><td><dl>Whether there is any active listeners matching
+     the requested type and/or capture phase.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l109">code &raquo;</a><code class="type">&lt;SCOPE, EVENTOBJ&gt;</code> <span class="member"><a name="listen">listen</a> <span class="args">( type, listener, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code></span></div><p>Adds an event listener. A listener can only be added once to an
+ object and if it is added again the key for the listener is
+ returned. Note that if the existing listener is a one-off listener
+ (registered via listenOnce), it will no longer be a one-off
+ listener after a call to listen().</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;)</code><dd>The event type id.<dt>listener: <code class="type">function(this: SCOPE, EVENTOBJ): (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Callback
+     method.<dt>opt_useCapture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to fire in capture phase
+     (defaults to false).<dt>opt_listenerScope: <code class="type">SCOPE=</code><dd>Object in whose scope to call the
+     listener.</dl><tr><th>Returns<tr><td><dl>Unique key for the listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l133">code &raquo;</a><code class="type">&lt;SCOPE, EVENTOBJ&gt;</code> <span class="member"><a name="listenOnce">listenOnce</a> <span class="args">( type, listener, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code></span></div><p>Adds an event listener that is removed automatically after the
+ listener fired once.
+
+ If an existing listener already exists, listenOnce will do
+ nothing. In particular, if the listener was previously registered
+ via listen(), listenOnce() will not turn the listener into a
+ one-off listener. Similarly, if there is already an existing
+ one-off listener, listenOnce does not modify the listeners (it is
+ still a once listener).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;)</code><dd>The event type id.<dt>listener: <code class="type">function(this: SCOPE, EVENTOBJ): (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Callback
+     method.<dt>opt_useCapture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to fire in capture phase
+     (defaults to false).<dt>opt_listenerScope: <code class="type">SCOPE=</code><dd>Object in whose scope to call the
+     listener.</dl><tr><th>Returns<tr><td><dl>Unique key for the listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l188">code &raquo;</a><span class="member"><a name="removeAllListeners">removeAllListeners</a> <span class="args">( opt_type )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Removes all listeners from this listenable. If type is specified,
+ it will only remove listeners of the particular type. otherwise all
+ registered listeners will be removed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Type of event to remove, default is to
+     remove all types.</dl><tr><th>Returns<tr><td><dl>Number of listeners removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l149">code &raquo;</a><code class="type">&lt;SCOPE, EVENTOBJ&gt;</code> <span class="member"><a name="unlisten">unlisten</a> <span class="args">( type, listener, opt_useCapture, opt_listenerScope )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes an event listener which was added with listen() or listenOnce().</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;)</code><dd>The event type id.<dt>listener: <code class="type">function(this: SCOPE, EVENTOBJ): (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Callback
+     method.<dt>opt_useCapture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to fire in capture phase
+     (defaults to false).<dt>opt_listenerScope: <code class="type">SCOPE=</code><dd>Object in whose scope to call
+     the listener.</dl><tr><th>Returns<tr><td><dl>Whether any listener was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l160">code &raquo;</a><span class="member"><a name="unlistenByKey">unlistenByKey</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes an event listener which was added with listen() by the key
+ returned by listen().</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code><dd>The key returned by
+     listen() or listenOnce().</dl><tr><th>Returns<tr><td><dl>Whether any listener was removed.</dl></table></div></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l77">code &raquo;</a><span class="member"><a name="goog.events.Listenable.addImplementation">goog.events.Listenable.addImplementation</a> <span class="args">( cls )</span></span></div><p>Marks a given class (constructor) as an implementation of
+ Listenable, do that we can query that fact at runtime. The class
+ must have already implemented the interface.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>cls: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The class constructor. The corresponding
+     class must have already implemented the interface.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l87">code &raquo;</a><span class="member"><a name="goog.events.Listenable.isImplementedBy">goog.events.Listenable.isImplementedBy</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to check.</dl><tr><th>Returns<tr><td><dl>Whether a given instance implements Listenable. The
+     class/superclass of the instance must call addImplementation.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l66">code &raquo;</a><span class="member"><a name="goog.events.Listenable.IMPLEMENTED_BY_PROP">goog.events.Listenable.IMPLEMENTED_BY_PROP</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>An expando property to indicate that an object implements
+ goog.events.Listenable.
+
+ See addImplementation/isImplementedBy.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/interface_goog_events_ListenableKey.html b/docs/interface_goog_events_ListenableKey.html
new file mode 100644
index 0000000..53fd38b
--- /dev/null
+++ b/docs/interface_goog_events_ListenableKey.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events.ListenableKey</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface goog.events.ListenableKey</h1><a class="source" href="source/lib/goog/events/listenable.js.src.html#l274">code &raquo;</a></header><section><p>An interface that describes a single registered listener.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l320">code &raquo;</a><span class="member"><a name="capture">capture</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the listener works on capture phase.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l327">code &raquo;</a><span class="member"><a name="handler">handler</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>The 'this' object for the listener function's scope.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l334">code &raquo;</a><span class="member"><a name="key">key</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>A globally unique number to identify the key.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l313">code &raquo;</a><span class="member"><a name="listener">listener</a> : <code class="type">(function(?): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code></span></div><p>The listener function.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l299">code &raquo;</a><span class="member"><a name="src">src</a> : <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>|<a href="class_goog_events_EventTarget.html">goog.events.EventTarget</a>)</code></span></div><p>The source event target.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l306">code &raquo;</a><span class="member"><a name="type">type</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The event type the listener is listening to.</summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l290">code &raquo;</a><span class="member"><a name="goog.events.ListenableKey.reserveKey">goog.events.ListenableKey.reserveKey</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Reserves a key to be used for ListenableKey#key field.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A number to be used to fill ListenableKey#key
+     field.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/listenable.js.src.html#l282">code &raquo;</a><span class="member"><a name="goog.events.ListenableKey.counter_">goog.events.ListenableKey.counter_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counter used to create a unique key</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/interface_goog_labs_testing_Matcher.html b/docs/interface_goog_labs_testing_Matcher.html
index 1db4111..9495c9b 100644
--- a/docs/interface_goog_labs_testing_Matcher.html
+++ b/docs/interface_goog_labs_testing_Matcher.html
@@ -1,2 +1,2 @@
 <!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing.Matcher</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface goog.labs.testing.Matcher</h1><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l29">code &raquo;</a></header><section><p>A matcher object to be used in assertThat statements.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l50">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( value, opt_description )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Describes why the matcher failed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value that didn't match.<dt>opt_description: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A partial description to which the reason
-     will be appended.</dl><tr><th>Returns<tr><td><dl>Description of why the matcher failed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l38">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines whether a value matches the constraints of the match.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The object to match.</dl><tr><th>Returns<tr><td><dl>Whether the input value matches this matcher.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     will be appended.</dl><tr><th>Returns<tr><td><dl>Description of why the matcher failed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l38">code &raquo;</a><span class="member"><a name="matches">matches</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines whether a value matches the constraints of the match.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The object to match.</dl><tr><th>Returns<tr><td><dl>Whether the input value matches this matcher.</dl></table></div></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l61">code &raquo;</a><span class="member"><a name="goog.labs.testing.Matcher.makeMatcher">goog.labs.testing.Matcher.makeMatcher</a> <span class="args">( matchesFunction, opt_describeFunction )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Generates a Matcher from the ‘matches’ and ‘describe’ functions passed in.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>matchesFunction: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The ‘matches’ function.<dt>opt_describeFunction: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The ‘describe’ function.</dl><tr><th>Returns<tr><td><dl>The custom matcher.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/interface_goog_net_XhrLike.html b/docs/interface_goog_net_XhrLike.html
new file mode 100644
index 0000000..ebff7e3
--- /dev/null
+++ b/docs/interface_goog_net_XhrLike.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XhrLike</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface goog.net.XhrLike</h1><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l27">code &raquo;</a></header><section><p>Interface for the common parts of XMLHttpRequest.
+
+ Mostly copied from externs/w3c_xml.js.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l34">code &raquo;</a><a class="member" name="goog.net.XhrLike.OrNative">goog.net.XhrLike.OrNative</a> : <code class="type">(!<a href="interface_goog_net_XhrLike.html">goog.net.XhrLike</a>|!<a href="http://www.w3.org/TR/XMLHttpRequest/#xmlhttprequest-object">XMLHttpRequest</a>)</code></div><div>Typedef that refers to either native or custom-implemented XHR objects.</div></summary></details></div></div></section><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l101">code &raquo;</a><span class="member"><a name="abort">abort</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l124">code &raquo;</a><span class="member"><a name="getAllResponseHeaders">getAllResponseHeaders</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l117">code &raquo;</a><span class="member"><a name="getResponseHeader">getResponseHeader</a> <span class="args">( header )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>header</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l87">code &raquo;</a><span class="member"><a name="open">open</a> <span class="args">( method, url, opt_async, opt_user, opt_password )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>method<dt>url<dt>opt_async<dt>opt_user<dt>opt_password</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l95">code &raquo;</a><span class="member"><a name="send">send</a> <span class="args">( opt_data )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_data</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l109">code &raquo;</a><span class="member"><a name="setRequestHeader">setRequestHeader</a> <span class="args">( header, value )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>header<dt>value</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l41">code &raquo;</a><span class="member"><a name="onreadystatechange">onreadystatechange</a> : <code class="type">(function()|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l62">code &raquo;</a><span class="member"><a name="readyState">readyState</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l48">code &raquo;</a><span class="member"><a name="responseText">responseText</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l55">code &raquo;</a><span class="member"><a name="responseXML">responseXML</a> : <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l69">code &raquo;</a><span class="member"><a name="status">status</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l76">code &raquo;</a><span class="member"><a name="statusText">statusText</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/interface_goog_structs_Collection.html b/docs/interface_goog_structs_Collection.html
new file mode 100644
index 0000000..e94fe48
--- /dev/null
+++ b/docs/interface_goog_structs_Collection.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.structs.Collection</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface goog.structs.Collection.<code class="type">&lt;T&gt;</code></h1><a class="source" href="source/lib/goog/structs/collection.js.src.html#l30">code &raquo;</a></header><section><p>An interface for a collection of values.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/collection.js.src.html#l36">code &raquo;</a><span class="member"><a name="add">add</a> <span class="args">( value )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">T</code><dd>Value to add to the collection.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/collection.js.src.html#l49">code &raquo;</a><span class="member"><a name="contains">contains</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">T</code><dd>Value to find in the collection.</dl><tr><th>Returns<tr><td><dl>Whether the collection contains the specified value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/collection.js.src.html#l55">code &raquo;</a><span class="member"><a name="getCount">getCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of values stored in the collection.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/collection.js.src.html#l42">code &raquo;</a><span class="member"><a name="remove">remove</a> <span class="args">( value )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">T</code><dd>Value to remove from the collection.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/interface_goog_testing_MockInterface.html b/docs/interface_goog_testing_MockInterface.html
new file mode 100644
index 0000000..c5af2d4
--- /dev/null
+++ b/docs/interface_goog_testing_MockInterface.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.MockInterface</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface goog.testing.MockInterface</h1><a class="source" href="source/lib/goog/testing/mockinterface.js.src.html#l25">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockinterface.js.src.html#l33">code &raquo;</a><span class="member"><a name="$replay">$replay</a> <span class="args">( )</span></span></div><p>Write down all the expected functions that have been called on the
+ mock so far. From here on out, future function calls will be
+ compared against this list.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockinterface.js.src.html#l39">code &raquo;</a><span class="member"><a name="$reset">$reset</a> <span class="args">( )</span></span></div><p>Reset the mock.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockinterface.js.src.html#l45">code &raquo;</a><span class="member"><a name="$verify">$verify</a> <span class="args">( )</span></span></div><p>Assert that the expected function calls match the actual calls.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/interface_webdriver_CommandExecutor.html b/docs/interface_webdriver_CommandExecutor.html
index 9b45f41..88db5f1 100644
--- a/docs/interface_webdriver_CommandExecutor.html
+++ b/docs/interface_webdriver_CommandExecutor.html
@@ -1,5 +1,9 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.CommandExecutor</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface webdriver.CommandExecutor</h1><a class="source" href="source/lib/webdriver/command.js.src.html#l228">code &raquo;</a></header><section><p>Handles the execution of <code >webdriver.Command</code> objects.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/command.js.src.html#l240">code &raquo;</a><span class="member"><a name="execute">execute</a> <span class="args">( command, callback )</span></span></div><p>Executes the given <code >command</code>. If there is an error executing the
- command, the provided callback will be invoked with the offending error.
- Otherwise, the callback will be invoked with a null Error and non-null
- <code  class="type"><a href="namespace_bot_response.html#bot.response.ResponseObject">bot.response.ResponseObject</a></code> object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>command: <code class="type">!<a href="class_webdriver_Command.html">webdriver.Command</a></code><dd>The command to execute.<dt>callback: <code class="type">function(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>, !<a href="namespace_bot_response.html#bot.response.ResponseObject">bot.response.ResponseObject</a>==)</code><dd>the function
-     to invoke when the command response is ready.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>CommandExecutor</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver.html">webdriver</a></div><div class="codelink"><a href="source/lib/webdriver/command.js.src.html#l234">View Source</a></div><h1>interface CommandExecutor</h1><p>Handles the execution of WebDriver <a href="class_webdriver_Command.html"><code>commands</code></a>.</p>
+<h2>Instance Methods</h2><div id="execute" class="function"><div><h3>execute(<wbr>command, callback)<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l246">code »</a></span></h3><p>Executes the given <code>command</code>. If there is an error executing the
+command, the provided callback will be invoked with the offending error.
+Otherwise, the callback will be invoked with a null Error and non-null
+<a href="namespace_bot_response.html#response.ResponseObject"><code>bot.response.ResponseObject</code></a> object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to execute.</p>
+<dt>callback<code>function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>, {status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}=): ?</code><dd><p>the function
+to invoke when the command response is ready.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/interface_webdriver_http_Client.html b/docs/interface_webdriver_http_Client.html
index 68f0fcc..1f09a13 100644
--- a/docs/interface_webdriver_http_Client.html
+++ b/docs/interface_webdriver_http_Client.html
@@ -1,6 +1,10 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.http.Client</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Interface webdriver.http.Client</h1><a class="source" href="source/lib/webdriver/http/http.js.src.html#l37">code &raquo;</a></header><section><p>Interface used for sending individual HTTP requests to the server.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l52">code &raquo;</a><span class="member"><a name="send">send</a> <span class="args">( request, callback )</span></span></div><p>Sends a request to the server. If an error occurs while sending the request,
- such as a failure to connect to the server, the provided callback will be
- invoked with a non-null <code >Error</code> describing the error. Otherwise, when
- the server's response has been received, the callback will be invoked with a
- null Error and non-null <code >webdriver.http.Response</code> object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>request: <code class="type">!<a href="class_webdriver_http_Request.html">webdriver.http.Request</a></code><dd>The request to send.<dt>callback: <code class="type">function(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>, !<a href="class_webdriver_http_Response.html">webdriver.http.Response</a>==)</code><dd>the function to
-     invoke when the server's response is ready.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Client</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_http.html">webdriver.http</a></div><div class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l41">View Source</a></div><h1>interface Client</h1><p>Interface used for sending individual HTTP requests to the server.</p>
+<h2>Instance Methods</h2><div id="send" class="function"><div><h3>send(<wbr>request, callback)<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l56">code »</a></span></h3><p>Sends a request to the server. If an error occurs while sending the request,
+such as a failure to connect to the server, the provided callback will be
+invoked with a non-null <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error"><code>Error</code></a> describing the error. Otherwise, when
+the server&#39;s response has been received, the callback will be invoked with a
+null Error and non-null <a href="class_webdriver_http_Response.html"><code>webdriver.http.Response</code></a> object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>request<code><a href="class_webdriver_http_Request.html">webdriver.http.Request</a></code><dd><p>The request to send.</p>
+<dt>callback<code>function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>, <a href="class_webdriver_http_Response.html">webdriver.http.Response</a>=): ?</code><dd><p>the function to
+invoke when the server&#39;s response is ready.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/interface_webdriver_promise_Thenable.html b/docs/interface_webdriver_promise_Thenable.html
new file mode 100644
index 0000000..bdc10ca
--- /dev/null
+++ b/docs/interface_webdriver_promise_Thenable.html
@@ -0,0 +1,77 @@
+<!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>Thenable</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><div class="parentlink"><b>Namespace:</b> <a href="namespace_webdriver_promise.html">webdriver.promise</a></div><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l825">View Source</a></div><h1>interface Thenable&lt;T&gt;</h1><dl><dt>All extended interfaces<dd><code>IThenable&lt;T&gt;</code></dl><h2>Instance Methods</h2><div id="cancel" class="function"><div><h3>cancel(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l879">code »</a></span></h3><p>Cancels the computation of this promise&#39;s value, rejecting the promise in
+the process. This method is a no-op if the promise has already been
+resolved.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_CancellationError.html">webdriver.promise.CancellationError</a>)=</code><dd><p>The reason this
+promise is being cancelled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isPending" class="function"><div><h3>isPending()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l882">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether this promise&#39;s value is still being computed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="then" class="function"><div><h3><code>&lt;R&gt;</code> then(<wbr>opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l897">code »</a></span></h3><p>Registers listeners for when this instance is resolved.</p>
+<p><b>Specified by: </b><a href="#then">IThenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_callback<code>?function(T): (R|IThenable&lt;R&gt;)=</code><dd><p>The
+function to call if this promise is successfully resolved. The function
+should expect a single argument: the promise&#39;s resolved value.</p>
+<dt>opt_errback<code>?function(*): (R|IThenable&lt;R&gt;)=</code><dd><p>The function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenCatch" class="function"><div><h3><code>&lt;R&gt;</code> thenCatch(<wbr>errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l922">code »</a></span></h3><p>Registers a listener for when this promise is rejected. This is synonymous
+with the <code>catch</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} catch (ex) {
+  console.error(ex);
+}
+
+// Asynchronous promise API:
+doAsynchronousWork().thenCatch(function(ex) {
+  console.error(ex);
+});
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>errback<code>function(*): (R|IThenable&lt;R&gt;)</code><dd><p>The
+function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenFinally" class="function"><div><h3><code>&lt;R&gt;</code> thenFinally(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l960">code »</a></span></h3><p>Registers a listener to invoke when this promise is resolved, regardless
+of whether the promise&#39;s value was successfully computed. This function
+is synonymous with the <code>finally</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} finally {
+  cleanUp();
+}
+
+// Asynchronous promise API:
+doAsynchronousWork().thenFinally(cleanUp);
+</code></pre>
+<p><strong>Note:</strong> similar to the <code>finally</code> clause, if the registered
+callback returns a rejected promise or throws an error, it will silently
+replace the rejection error (if any) from this promise:</p>
+<pre><code>try {
+  throw Error(&#39;one&#39;);
+} finally {
+  throw Error(&#39;two&#39;);  // Hides Error: one
+}
+
+promise.rejected(Error(&#39;one&#39;))
+    .thenFinally(function() {
+      throw Error(&#39;two&#39;);  // Hides Error: one
+    });
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(): (R|IThenable&lt;R&gt;)</code><dd><p>The function
+to call when this promise is resolved.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be fulfilled
+with the callback result.</p>
+</dl></div></div></div></div><h2>Functions</h2><div id="Thenable.addImplementation" class="function"><div><h3>Thenable.addImplementation(<wbr>ctor)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l835">code »</a></span></h3><p>Adds a property to a class prototype to allow runtime checks of whether
+instances of that class implement the Thenable interface. This function
+will also ensure the prototype&#39;s <code>then</code> function is exported from
+compiled code.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ctor<code>function(new: <a href="interface_webdriver_promise_Thenable.html">webdriver.promise.Thenable</a>, ...?): ?</code><dd><p>The
+constructor whose prototype to modify.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Thenable.isImplementation" class="function"><div><h3>Thenable.isImplementation(<wbr>object)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l858">code »</a></span></h3><p>Checks if an object has been tagged for implementing the Thenable
+interface as defined by
+<a href="interface_webdriver_promise_Thenable.html#Thenable.addImplementation"><code>webdriver.promise.Thenable.addImplementation</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>object<code>*</code><dd><p>The object to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the object is an implementation of the Thenable
+interface.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/license.html b/docs/license.html
index 962258d..3c544de 100644
--- a/docs/license.html
+++ b/docs/license.html
@@ -202,4 +202,4 @@
    See the License for the specific language governing permissions and
    limitations under the License.
 
-</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver.html b/docs/module_selenium-webdriver.html
index 2764d07..5478878 100644
--- a/docs/module_selenium-webdriver.html
+++ b/docs/module_selenium-webdriver.html
@@ -1,4 +1,23 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/index.js.src.html">code &raquo;</a></header><section><p>The main user facing module. Exports WebDriver's primary
- public API and provides convenience assessors to certain sub-modules.</section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_ActionSequence.html">ActionSequence</a><dd>Class for defining sequences of complex user interactions.<dt><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a><dd>Creates new <code  class="type"><a href="class_webdriver_WebDriver.html">WebDriver</a></code> instances.<dt><a href="class_webdriver_Capabilities.html">Capabilities</a><dd>No Description.<dt><a href="class_webdriver_Command.html">Command</a><dd>Describes a command to be executed by the WebDriverJS framework.<dt><a href="class_webdriver_EventEmitter.html">EventEmitter</a><dd>Object that can emit events for others to listen for.<dt><a href="class_webdriver_Session.html">Session</a><dd>Contains information about a WebDriver session.<dt><a href="class_webdriver_WebDriver.html">WebDriver</a><dd>Creates a new WebDriver client, which provides control over a browser.<dt><a href="class_webdriver_WebElement.html">WebElement</a><dd>Represents a DOM element.</dl></table></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_webdriver_Browser.html">Browser</a><dd>Recognized browser names.<dt><a href="enum_webdriver_Button.html">Button</a><dd>Enumeration of the buttons used in the advanced interactions API.<dt><a href="enum_webdriver_Capability.html">Capability</a><dd>Common webdriver capability keys.<dt><a href="enum_webdriver_CommandName.html">CommandName</a><dd>Enumeration of predefined names command names that all command processors
- will support.<dt><a href="enum_webdriver_Key.html">Key</a><dd>Representations of pressable keys that aren't text.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-properties"><h2>Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/index.js.src.html#l40">code &raquo;</a><span class="member"><a name="By">By</a> : <code class="type"><a href="namespace_webdriver_By.html">webdriver.By</a></code></span></div><p>A collection of factory functions for creating <code  class="type"><a href="class_webdriver_Locator.html">webdriver.Locator</a></code>
- instances.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/index.js.src.html#l108">code &raquo;</a><span class="member"><a name="error">error</a> : <code class="type"><a href="module_selenium-webdriver_error.html">selenium-webdriver/error</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/index.js.src.html#l114">code &raquo;</a><span class="member"><a name="logging">logging</a> : <code class="type"><a href="namespace_webdriver_logging.html">webdriver.logging</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/index.js.src.html#l120">code &raquo;</a><span class="member"><a name="promise">promise</a> : <code class="type"><a href="namespace_webdriver_promise.html">webdriver.promise</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/index.js.src.html#l126">code &raquo;</a><span class="member"><a name="stacktrace">stacktrace</a> : <code class="type"><a href="namespace_webdriver_stacktrace.html">webdriver.stacktrace</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver</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><div class="codelink"><a href="source/index.js.src.html#l23">View Source</a></div><h1>module selenium-webdriver</h1><p>The main user facing module. Exports WebDriver&#39;s primary
+public API and provides convenience assessors to certain sub-modules.</p>
+<h2>Types</h2><dl><dt><a href="module_selenium-webdriver_class_ActionSequence.html">ActionSequence</a><dd><p>Class for defining sequences of complex user interactions.</p>
+<dt><a href="module_selenium-webdriver_enum_Browser.html">Browser</a><dd><p>Recognized browser names.</p>
+<dt><a href="module_selenium-webdriver_class_Builder.html">Builder</a><dd><p>Creates new <a href="class_webdriver_WebDriver.html"><code>WebDriver</code></a> instances.</p>
+<dt><a href="module_selenium-webdriver_enum_Button.html">Button</a><dd><p>Enumeration of the buttons used in the advanced interactions API.</p>
+<dt><a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a><dd><p>No description.</p>
+<dt><a href="module_selenium-webdriver_enum_Capability.html">Capability</a><dd><p>Common webdriver capability keys.</p>
+<dt><a href="module_selenium-webdriver_class_Command.html">Command</a><dd><p>Describes a command to be executed by the WebDriverJS framework.</p>
+<dt><a href="module_selenium-webdriver_enum_CommandName.html">CommandName</a><dd><p>Enumeration of predefined names command names that all command processors
+will support.</p>
+<dt><a href="module_selenium-webdriver_class_EventEmitter.html">EventEmitter</a><dd><p>Object that can emit events for others to listen for.</p>
+<dt><a href="module_selenium-webdriver_class_FileDetector.html">FileDetector</a><dd><p>Used with <a href="class_webdriver_WebElement.html#sendKeys"><code>WebElement#sendKeys</code></a> on file
+input elements (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>) to detect when the entered key
+sequence defines the path to a file.</p>
+<dt><a href="module_selenium-webdriver_enum_Key.html">Key</a><dd><p>Representations of pressable keys that aren&#39;t text.</p>
+<dt><a href="module_selenium-webdriver_class_Serializable.html">Serializable</a><dd><p>Defines an object that can be asynchronously serialized to its WebDriver
+wire representation.</p>
+<dt><a href="module_selenium-webdriver_class_Session.html">Session</a><dd><p>Contains information about a WebDriver session.</p>
+<dt><a href="module_selenium-webdriver_class_WebDriver.html">WebDriver</a><dd><p>Creates a new WebDriver client, which provides control over a browser.</p>
+<dt><a href="module_selenium-webdriver_class_WebElement.html">WebElement</a><dd><p>Represents a DOM element.</p>
+<dt><a href="module_selenium-webdriver_class_WebElementPromise.html">WebElementPromise</a><dd><p>WebElementPromise is a promise that will be fulfilled with a WebElement.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver__base.html b/docs/module_selenium-webdriver__base.html
index 02cc0a1..8806b9a 100644
--- a/docs/module_selenium-webdriver__base.html
+++ b/docs/module_selenium-webdriver__base.html
@@ -1,14 +1,23 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/_base</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/_base</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/_base.js.src.html">code &raquo;</a></header><section><p>The base module responsible for bootstrapping the Closure
- library and providing a means of loading Closure-based modules.
-
- <p>Each script loaded by this module will be granted access to this module's
- <code >require</code> function; all required non-native modules must be specified
- relative to <em>this</em> module.
-
- <p>This module will load all scripts from the "lib" subdirectory, unless the
- SELENIUM_DEV_MODE environment variable has been set to 1, in which case all
- scripts will be loaded from the Selenium client containing this script.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/_base.js.src.html#l144">code &raquo;</a><span class="member"><a name="exportPublicApi">exportPublicApi</a> <span class="args">( symbol )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Loads a symbol by name from the protected Closure context and exports its
- public API to the provided object. This function relies on Closure code
- conventions to define the public API of an object as those properties whose
- name does not end with "_".</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>symbol: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The symbol to load. This must resolve to an object.</dl><tr><th>Returns<tr><td><dl>An object with the exported API.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the symbol has not been defined or does not resolve to
-     an object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/_base.js.src.html#l164">code &raquo;</a><span class="member"><a name="isDevMode">isDevMode</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether this script was loaded in dev mode.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/_base.js.src.html#l165">code &raquo;</a><span class="member"><a name="require">require</a> <span class="args">( symbol )</span></span></div><p>Loads a symbol by name from the protected Closure context.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>symbol: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The symbol to load.</dl><tr><th>Returns<tr><td><dl>The loaded symbol, or <code >null</code> if not found.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the symbol has not been defined.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/_base.js.src.html#l162">code &raquo;</a><span class="member"><a name="closure">closure</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/_base</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><div class="codelink"><a href="source/_base.js.src.html#l31">View Source</a></div><h1>module selenium-webdriver/_base</h1><p>The base module responsible for bootstrapping the Closure
+library and providing a means of loading Closure-based modules.</p>
+<p>Each script loaded by this module will be granted access to this module&#39;s
+<code>require</code> function; all required non-native modules must be specified
+relative to <em>this</em> module.
+</p><p>This module will load all scripts from the &#34;lib&#34; subdirectory, unless the
+SELENIUM_DEV_MODE environment variable has been set to 1, in which case all
+scripts will be loaded from the Selenium client containing this script.
+</p><h2>Functions</h2><div id="exportPublicApi" class="function"><div><h3>exportPublicApi(<wbr>symbol)<span class="codelink"><a href="source/_base.js.src.html#l178">code »</a></span></h3><p>Loads a symbol by name from the protected Closure context and exports its
+public API to the provided object. This function relies on Closure code
+conventions to define the public API of an object as those properties whose
+name does not end with &#34;_&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>symbol<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The symbol to load. This must resolve to an object.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>An object with the exported API.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the symbol has not been defined or does not resolve to
+an object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isDevMode" class="function"><div><h3>isDevMode()<span class="codelink"><a href="source/_base.js.src.html#l199">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether this script was loaded in dev mode.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="require" class="function"><div><h3>require(<wbr>symbol)<span class="codelink"><a href="source/_base.js.src.html#l200">code »</a></span></h3><p>Loads a symbol by name from the protected Closure context.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>symbol<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The symbol to load.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><p>The loaded symbol, or <code>null</code> if not found.</p>
+</div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the symbol has not been defined.</p>
+</dl></div></div></div></div><h2>Properties</h2><div id="closure" class="property"><dl><dt><a href="source/_base.js.src.html#l196">closure</a><code>?</code><dd>No description.</dl></div><h2>Types</h2><dl><dt><a href="module_selenium-webdriver__base_class_Context.html">Context</a><dd><p>Maintains a unique context for Closure library-based code.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver__base_class_Context.html b/docs/module_selenium-webdriver__base_class_Context.html
new file mode 100644
index 0000000..03304a3
--- /dev/null
+++ b/docs/module_selenium-webdriver__base_class_Context.html
@@ -0,0 +1,5 @@
+<!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>Context</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver__base.html">selenium-webdriver/_base</a></div><div class="codelink"><a href="source/_base.js.src.html#l198">View Source</a></div><h1>class Context</h1><p>Maintains a unique context for Closure library-based code.</p>
+<h3>new Context(<wbr>opt_configureForTesting)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_configureForTesting<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd><p>Whether to configure a fake DOM
+for Closure-testing code that (incorrectly) assumes a DOM is always
+present.</p>
+</dl></div></div><h2>Instance Properties</h2><div id="closure" class="property"><dl><dt><a href="source/_base.js.src.html#l87">closure</a><code>?</code><dd>No description.</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_builder.html b/docs/module_selenium-webdriver_builder.html
index 6b20841..04aa449 100644
--- a/docs/module_selenium-webdriver_builder.html
+++ b/docs/module_selenium-webdriver_builder.html
@@ -1 +1,2 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/builder</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/builder</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/builder.js.src.html">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a><dd>Creates new <code  class="type"><a href="class_webdriver_WebDriver.html">WebDriver</a></code> instances.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/builder</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><div class="codelink"><a href="source/builder.js.src.html#l18">View Source</a></div><h1>module selenium-webdriver/builder</h1><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a><dd><p>Creates new <a href="class_webdriver_WebDriver.html"><code>WebDriver</code></a> instances.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_builder_class_Builder.html b/docs/module_selenium-webdriver_builder_class_Builder.html
index bac7e53..33a1d06 100644
--- a/docs/module_selenium-webdriver_builder_class_Builder.html
+++ b/docs/module_selenium-webdriver_builder_class_Builder.html
@@ -1,13 +1,138 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>Builder</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class Builder</h1><a class="source" href="source/builder.js.src.html#l113">code &raquo;</a><pre><code><a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a>
-  &#x2514; Builder</code></pre></header><section><p>Creates new <code  class="type"><a href="class_webdriver_WebDriver.html">WebDriver</a></code> instances.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">Builder <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><h3>Defined in <code class="type">Builder</code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/builder.js.src.html#l90">code &raquo;</a><span class="member"><a name="build">build</a> <span class="args">( )</span> &rArr; <code class="type">webdriver.WebDriver</code></span></div></summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/builder.js.src.html#l81">code &raquo;</a><span class="member"><a name="setChromeOptions">setChromeOptions</a> <span class="args">( options )</span> &rArr; <code class="type">!Builder</code></span></div><p>Sets Chrome-specific options for drivers created by this builder.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>options: <code class="type">!chrome.Options</code><dd>The ChromeDriver options to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/builder.js.src.html#l70">code &raquo;</a><span class="member"><a name="setProxy">setProxy</a> <span class="args">( config )</span> &rArr; <code class="type">!Builder</code></span></div><p>Sets the proxy configuration to use for WebDriver clients created by this
- builder. Any calls to <code  class="type"><a class="unresolved-link">#withCapabilities</a></code> after this function will
- overwrite these settings.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>config: <code class="type">!proxy.ProxyConfig</code><dd>The configuration to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><h3>Defined in <code class="type"><a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></h3><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l112">code &raquo;</a><span class="member"><a name="getCapabilities">getCapabilities</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The current desired capabilities for this
-     builder.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l90">code &raquo;</a><span class="member"><a name="getServerUrl">getServerUrl</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The URL of the WebDriver server this instance is configured
-     to use.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l80">code &raquo;</a><span class="member"><a name="usingServer">usingServer</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Configures which WebDriver server should be used for new sessions. Overrides
- the value loaded from the <code  class="type"><a href="class_webdriver_AbstractBuilder.html#webdriver.AbstractBuilder.SERVER_URL_ENV">webdriver.AbstractBuilder.SERVER_URL_ENV</a></code>
- upon creation of this instance.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL of the server to use.</dl><tr><th>Returns<tr><td><dl>This Builder instance for chain calling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l102">code &raquo;</a><span class="member"><a name="withCapabilities">withCapabilities</a> <span class="args">( capabilities )</span> &rArr; <code class="type">!<a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></span></div><p>Sets the desired capabilities when requesting a new session. This will
- overwrite any previously set desired capabilities.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>capabilities: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>)</code><dd>The desired
-     capabilities for a new session.</dl><tr><th>Returns<tr><td><dl>This Builder instance for chain calling.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><h3>Defined in <code class="type"><a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a></code></h3><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l49">code &raquo;</a><span class="member"><a name="capabilities_">capabilities_</a> : <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div><p>The desired capabilities to use when creating a new session.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/abstractbuilder.js.src.html#l42">code &raquo;</a><span class="member"><a name="serverUrl_">serverUrl_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>URL of the remote server to use for new clients; initialized from the
- value of the <code  class="type"><a href="class_webdriver_AbstractBuilder.html#webdriver.AbstractBuilder.SERVER_URL_ENV">webdriver.AbstractBuilder.SERVER_URL_ENV</a></code> environment
- variable, but may be overridden using
- <code  class="type"><a href="class_webdriver_AbstractBuilder.html#usingServer">webdriver.AbstractBuilder#usingServer</a></code>.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>Builder</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_builder.html">selenium-webdriver/builder</a></div><div class="codelink"><a href="source/builder.js.src.html#l496">View Source</a></div><h1>class Builder</h1><p>Creates new <a href="class_webdriver_WebDriver.html"><code>WebDriver</code></a> instances. The environment
+variables listed below may be used to override a builder&#39;s configuration,
+allowing quick runtime changes.</p>
+<ul><li>
+<p><code>SELENIUM_BROWSER</code>: defines the target browser in the form
+<code>browser[:version][:platform]</code>.</p>
+</li><li>
+<p><code>SELENIUM_REMOTE_URL</code>: defines the remote URL for all builder
+instances. This environment variable should be set to a fully qualified
+URL for a WebDriver server (e.g. http://localhost:4444/wd/hub). This
+option always takes precedence over <code>SELENIUM_SERVER_JAR</code>.</p>
+</li><li>
+<p><code>SELENIUM_SERVER_JAR</code>: defines the path to the
+<a href="http://selenium-release.storage.googleapis.com/index.html">
+standalone Selenium server</a> jar to use. The server will be started the
+first time a WebDriver instance and be killed when the process exits.</p>
+</li></ul>
+<p>Suppose you had mytest.js that created WebDriver with</p>
+<pre><code>var driver &#61; new webdriver.Builder()
+    .forBrowser(&#39;chrome&#39;)
+    .build();
+</code></pre>
+<p>This test could be made to use Firefox on the local machine by running with
+<code>SELENIUM_BROWSER&#61;firefox node mytest.js</code>. Rather than change the code to
+target Google Chrome on a remote machine, you can simply set the
+<code>SELENIUM_BROWSER</code> and <code>SELENIUM_REMOTE_URL</code> environment variables:</p>
+<pre><code>SELENIUM_BROWSER&#61;chrome:36:LINUX \
+SELENIUM_REMOTE_URL&#61;http://www.example.com:4444/wd/hub \
+node mytest.js
+</code></pre>
+<p>You could also use a local copy of the standalone Selenium server:</p>
+<pre><code>SELENIUM_BROWSER&#61;chrome:36:LINUX \
+SELENIUM_SERVER_JAR&#61;/path/to/selenium-server-standalone.jar \
+node mytest.js
+</code></pre>
+<h3>new Builder()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="build" class="function"><div><h3>build()<span class="codelink"><a href="source/builder.js.src.html#l391">code »</a></span></h3><p>Creates a new WebDriver client based on this builder&#39;s current
+configuration.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>A new WebDriver instance.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the current configuration is invalid.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="disableEnvironmentOverrides" class="function"><div><h3>disableEnvironmentOverrides()<span class="codelink"><a href="source/builder.js.src.html#l130">code »</a></span></h3><p>Configures this builder to ignore any environment variable overrides and to
+only use the configuration specified through this instance&#39;s API.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="forBrowser" class="function"><div><h3>forBrowser(<wbr>name, opt_version, opt_platform)<span class="codelink"><a href="source/builder.js.src.html#l225">code »</a></span></h3><p>Configures the target browser for clients created by this instance.
+Any calls to <a href="module_selenium-webdriver_builder_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a> after this function will
+overwrite these settings.</p>
+<p>You may also define the target browser using the <code>SELENIUM_BROWSER</code>
+environment variable. If set, this environment variable should be of the
+form <code>browser[:[version][:platform]]</code>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the target browser;
+common defaults are available on the <a href="enum_webdriver_Browser.html"><code>webdriver.Browser</code></a> enum.</p>
+<dt>opt_version<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A desired version; may be omitted if any
+version should be used.</p>
+<dt>opt_platform<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The desired platform; may be omitted if any
+version may be used.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/builder.js.src.html#l203">code »</a></span></h3><p>Returns the base set of capabilities this instance is currently configured
+to use.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The current capabilities for this builder.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getServerUrl" class="function"><div><h3>getServerUrl()<span class="codelink"><a href="source/builder.js.src.html#l157">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of the WebDriver server this instance is configured
+to use.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWebDriverProxy" class="function"><div><h3>getWebDriverProxy()<span class="codelink"><a href="source/builder.js.src.html#l180">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of the proxy server to use for the WebDriver&#39;s HTTP
+connections.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAlertBehavior" class="function"><div><h3>setAlertBehavior(<wbr>beahvior)<span class="codelink"><a href="source/builder.js.src.html#l289">code »</a></span></h3><p>Sets the default action to take with an unexpected alert before returning
+an error.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>beahvior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The desired behavior; should be &#34;accept&#34;, &#34;dismiss&#34;,
+or &#34;ignore&#34;. Defaults to &#34;dismiss&#34;.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setChromeOptions" class="function"><div><h3>setChromeOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l304">code »</a></span></h3><p>Sets Chrome specific <a href="module_selenium-webdriver_chrome_class_Options.html">options</a>
+for drivers created by this builder. Any logging or proxy settings defined
+on the given options will take precedence over those set through
+<a href="module_selenium-webdriver_builder_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_builder_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>chrome.Options</code><dd><p>The ChromeDriver options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setControlFlow" class="function"><div><h3>setControlFlow(<wbr>flow)<span class="codelink"><a href="source/builder.js.src.html#l378">code »</a></span></h3><p>Sets the control flow that created drivers should execute actions in. If
+the flow is never set, or is set to <code>null</code>, it will use the active
+flow at the time <a href="module_selenium-webdriver_builder_class_Builder.html#build"><code>#build()</code></a> is called.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>flow<code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow to use, or
+<code>null</code> to</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setEnableNativeEvents" class="function"><div><h3>setEnableNativeEvents(<wbr>enabled)<span class="codelink"><a href="source/builder.js.src.html#l264">code »</a></span></h3><p>Sets whether native events should be used.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enabled<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable native events.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFirefoxOptions" class="function"><div><h3>setFirefoxOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l319">code »</a></span></h3><p>Sets Firefox specific <a href="module_selenium-webdriver_firefox_class_Options.html">options</a>
+for drivers created by this builder. Any logging or proxy settings defined
+on the given options will take precedence over those set through
+<a href="module_selenium-webdriver_builder_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_builder_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>firefox.Options</code><dd><p>The FirefoxDriver options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setIeOptions" class="function"><div><h3>setIeOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l349">code »</a></span></h3><p>Sets Internet Explorer specific
+<a href="module_selenium-webdriver_ie_class_Options.html">options</a> for drivers created by
+this builder. Any proxy settings defined on the given options will take
+precedence over those set through <a href="module_selenium-webdriver_builder_class_Builder.html#setProxy"><code>#setProxy</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>ie.Options</code><dd><p>The IEDriver options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPrefs" class="function"><div><h3>setLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/builder.js.src.html#l253">code »</a></span></h3><p>Sets the logging preferences for the created session. Preferences may be
+changed by repeated calls, or by calling <a href="module_selenium-webdriver_builder_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code>(<a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The
+desired logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setOperaOptions" class="function"><div><h3>setOperaOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l334">code »</a></span></h3><p>Sets Opera specific <a href="module_selenium-webdriver_opera_class_Options.html">options</a> for
+drivers created by this builder. Any logging or proxy settings defined on the
+given options will take precedence over those set through
+<a href="module_selenium-webdriver_builder_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_builder_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>opera.Options</code><dd><p>The OperaDriver options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>config)<span class="codelink"><a href="source/builder.js.src.html#l240">code »</a></span></h3><p>Sets the proxy configuration to use for WebDriver clients created by this
+builder. Any calls to <a href="module_selenium-webdriver_builder_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a> after this function will
+overwrite these settings.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>config<code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>The configuration to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setSafariOptions" class="function"><div><h3>setSafariOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l364">code »</a></span></h3><p>Sets Safari specific <a href="module_selenium-webdriver_safari_class_Options.html">options</a>
+for drivers created by this builder. Any logging settings defined on the
+given options will take precedence over those set through
+<a href="module_selenium-webdriver_builder_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>safari.Options</code><dd><p>The Safari options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setScrollBehavior" class="function"><div><h3>setScrollBehavior(<wbr>behavior)<span class="codelink"><a href="source/builder.js.src.html#l276">code »</a></span></h3><p>Sets how elements should be scrolled into view for interaction.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>behavior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired scroll behavior: either 0 to align with
+the top of the viewport or 1 to align with the bottom.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="usingServer" class="function"><div><h3>usingServer(<wbr>url)<span class="codelink"><a href="source/builder.js.src.html#l147">code »</a></span></h3><p>Sets the URL of a remote WebDriver server to use. Once a remote URL has been
+specified, the builder direct all new clients to that server. If this method
+is never called, the Builder will attempt to create all clients locally.</p>
+<p>As an alternative to this method, you may also set the <code>SELENIUM_REMOTE_URL</code>
+environment variable.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of a remote server to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="usingWebDriverProxy" class="function"><div><h3>usingWebDriverProxy(<wbr>proxy)<span class="codelink"><a href="source/builder.js.src.html#l170">code »</a></span></h3><p>Sets the URL of the proxy to use for the WebDriver&#39;s HTTP connections.
+If this method is never called, the Builder will create a connection without
+a proxy.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of a proxy to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="withCapabilities" class="function"><div><h3>withCapabilities(<wbr>capabilities)<span class="codelink"><a href="source/builder.js.src.html#l192">code »</a></span></h3><p>Sets the desired capabilities when requesting a new session. This will
+overwrite any previously set capabilities.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>capabilities<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>The desired
+capabilities for a new session.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_chrome.html b/docs/module_selenium-webdriver_chrome.html
index f5d6a01..ce0ec26 100644
--- a/docs/module_selenium-webdriver_chrome.html
+++ b/docs/module_selenium-webdriver_chrome.html
@@ -1,5 +1,90 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/chrome</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/chrome</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/chrome.js.src.html">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a><dd>Class for managing ChromeDriver specific options.<dt><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a><dd>Creates <code  class="type"><a class="unresolved-link">remote.DriverService</a></code> instances that manage a ChromeDriver
- server.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l470">code &raquo;</a><span class="member"><a name="createDriver">createDriver</a> <span class="args">( opt_options, opt_service )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div><p>Creates a new ChromeDriver session.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_options: <code class="type">(<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>|Options)=</code><dd>The session options.<dt>opt_service: <code class="type">remote.DriverService=</code><dd>The session to use; will use
-     the <code  class="type"><a class="unresolved-link">default service</a></code> by default.</dl><tr><th>Returns<tr><td><dl>A new WebDriver instance.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l471">code &raquo;</a><span class="member"><a name="getDefaultService">getDefaultService</a> <span class="args">( )</span> &rArr; <code class="type">!remote.DriverService</code></span></div><p>Returns the default ChromeDriver service. If such a service has not been
- configured, one will be constructed using the default configuration for
- a ChromeDriver executable found on the system PATH.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The default ChromeDriver service.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l472">code &raquo;</a><span class="member"><a name="setDefaultService">setDefaultService</a> <span class="args">( service )</span></span></div><p>Sets the default service to use for new ChromeDriver instances.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>service: <code class="type">!remote.DriverService</code><dd>The service to use.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the default service is currently running.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/chrome</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><div class="codelink"><a href="source/chrome.js.src.html#l115">View Source</a></div><h1>module selenium-webdriver/chrome</h1><p>Defines a <a href="module_selenium-webdriver_chrome_class_Driver.html">WebDriver</a> client for the Chrome
+web browser. Before using this module, you must download the latest
+<a href="http://chromedriver.storage.googleapis.com/index.html">ChromeDriver release</a> and ensure it can be found on your system <a href="http://en.wikipedia.org/wiki/PATH_%28variable%29">PATH</a>.</p>
+<p>There are three primary classes exported by this module:</p>
+<ol><li>
+<p><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a>: configures the
+<a href="module_selenium-webdriver_remote_class_DriverService.html"><code>remote.DriverService</code></a>
+that manages the <a href="https://sites.google.com/a/chromium.org/chromedriver/">ChromeDriver</a> child process.</p>
+</li><li>
+<p><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a>: defines configuration options for each new Chrome
+session, such as which <a href="module_selenium-webdriver_chrome_class_Options.html#setProxy">proxy</a> to use,
+what <a href="module_selenium-webdriver_chrome_class_Options.html#addExtensions">extensions</a> to install, or
+what <a href="module_selenium-webdriver_chrome_class_Options.html#addArguments">command-line switches</a> to use when
+starting the browser.</p>
+</li><li>
+<p><a href="module_selenium-webdriver_chrome_class_Driver.html">Driver</a>: the WebDriver client; each new instance will control
+a unique browser session with a clean user profile (unless otherwise
+configured through the <a href="module_selenium-webdriver_chrome_class_Options.html"><code>Options</code></a> class).</p>
+</li></ol>
+<p><strong>Customizing the ChromeDriver Server</strong> <a id="custom-server"></a></p>
+<p>By default, every Chrome session will use a single driver service, which is
+started the first time a <a href="module_selenium-webdriver_chrome_class_Driver.html"><code>Driver</code></a> instance is created and terminated
+when this process exits. The default service will inherit its environment
+from the current process and direct all output to /dev/null. You may obtain
+a handle to this default service using
+<a href="module_selenium-webdriver_chrome.html#getDefaultService"><code>getDefaultService()</code></a> and change its configuration
+with <a href="module_selenium-webdriver_chrome.html#setDefaultService"><code>setDefaultService()</code></a>.</p>
+<p>You may also create a <a href="module_selenium-webdriver_chrome_class_Driver.html"><code>Driver</code></a> with its own driver service. This is
+useful if you need to capture the server&#39;s log output for a specific session:</p>
+<pre><code>var chrome &#61; require(&#39;selenium-webdriver/chrome&#39;);
+
+var service &#61; new chrome.ServiceBuilder()
+    .loggingTo(&#39;/my/log/file.txt&#39;)
+    .enableVerboseLogging()
+    .build();
+
+var options &#61; new chrome.Options();
+// configure browser options ...
+
+var driver &#61; new chrome.Driver(options, service);
+</code></pre>
+<p>Users should only instantiate the <a href="module_selenium-webdriver_chrome_class_Driver.html"><code>Driver</code></a> class directly when they
+need a custom driver service configuration (as shown above). For normal
+operation, users should start Chrome using the
+<a href="module_selenium-webdriver_class_Builder.html"><code>selenium-webdriver.Builder</code></a>.</p>
+<p><strong>Working with Android</strong> <a id="android"></a></p>
+<p>The <a href="https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android">ChromeDriver</a> supports running tests on the Chrome browser as
+well as <a href="https://developer.chrome.com/multidevice/webview/overview">WebView apps</a> starting in Android 4.4 (KitKat). In order to
+work with Android, you must first start the adb</p>
+<pre><code>adb start-server
+</code></pre>
+<p>By default, adb will start on port 5037. You may change this port, but this
+will require configuring a <a href="#custom-server">custom server</a> that will connect
+to adb on the <a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html#setAdbPort">correct port</a>:</p>
+<pre><code>var service &#61; new chrome.ServiceBuilder()
+    .setAdbPort(1234)
+    build();
+// etc.
+</code></pre>
+<p>The ChromeDriver may be configured to launch Chrome on Android using
+<a href="module_selenium-webdriver_chrome_class_Options.html#androidChrome"><code>Options#androidChrome()</code></a>:</p>
+<pre><code>var driver &#61; new Builder()
+    .forBrowser(&#39;chrome&#39;)
+    .setChromeOptions(new chrome.Options().androidChrome())
+    .build();
+</code></pre>
+<p>Alternatively, you can configure the ChromeDriver to launch an app with a
+Chrome-WebView by setting the <a href="module_selenium-webdriver_chrome_class_Options.html#androidActivity">androidActivity</a> option:</p>
+<pre><code>var driver &#61; new Builder()
+    .forBrowser(&#39;chrome&#39;)
+    .setChromeOptions(new chrome.Options()
+        .androidPackage(&#39;com.example&#39;)
+        .androidActivity(&#39;com.example.Activity&#39;))
+    .build();
+</code></pre>
+<p>[Refer to the ChromeDriver site] for more information on using the
+<a href="https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android">ChromeDriver with Android</a>.</p>
+<h2>Functions</h2><div id="getDefaultService" class="function"><div><h3>getDefaultService()<span class="codelink"><a href="source/chrome.js.src.html#l847">code »</a></span></h3><p>Returns the default ChromeDriver service. If such a service has not been
+configured, one will be constructed using the default configuration for
+a ChromeDriver executable found on the system PATH.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a></code><dd><p>The default ChromeDriver service.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setDefaultService" class="function"><div><h3>setDefaultService(<wbr>service)<span class="codelink"><a href="source/chrome.js.src.html#l848">code »</a></span></h3><p>Sets the default service to use for new ChromeDriver instances.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>service<code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a></code><dd><p>The service to use.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the default service is currently running.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_chrome_class_Driver.html">Driver</a><dd><p>Creates a new WebDriver client for Chrome.</p>
+<dt><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a><dd><p>Class for managing ChromeDriver specific options.</p>
+<dt><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a><dd><p>Creates <a href="module_selenium-webdriver_remote_class_DriverService.html"><code>selenium-webdriver/remote.DriverService</code></a> instances that manage
+a <a href="https://sites.google.com/a/chromium.org/chromedriver/">ChromeDriver</a>
+server in a child process.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_chrome_class_Driver.html b/docs/module_selenium-webdriver_chrome_class_Driver.html
new file mode 100644
index 0000000..61b84dc
--- /dev/null
+++ b/docs/module_selenium-webdriver_chrome_class_Driver.html
@@ -0,0 +1,280 @@
+<!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>Driver</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_chrome.html">selenium-webdriver/chrome</a></div><div class="codelink"><a href="source/chrome.js.src.html#l844">View Source</a></div><h1>class Driver</h1><pre class="inheritance"><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>
+  &#x2514; Driver</pre><p>Creates a new WebDriver client for Chrome.</p>
+<h3>new Driver(<wbr>opt_config, opt_service, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_config<code>?(<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>|<a href="module_selenium-webdriver_chrome_class_Options.html">Options</a>)=</code><dd><p>The configuration
+options.</p>
+<dt>opt_service<code>?<a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a>=</code><dd><p>The session to use; will use
+the default service by default.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow to use, or
+<code>null</code> to use the currently active flow.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="actions" class="function"><div><h3>actions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l469">code »</a></span></h3><p>Creates a new action sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_ActionSequence.html#perform"><code>webdriver.ActionSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.actions().
+    mouseDown(element1).
+    mouseMove(element2).
+    mouseUp().
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#actions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A new action sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="call" class="function"><div><h3><code>&lt;T&gt;</code> call(<wbr>fn, opt_scope, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l639">code »</a></span></h3><p>Schedules a command to execute a custom function.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#call">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(...?): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+execute.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to execute the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved&#39;
+with the function&#39;s result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="close" class="function"><div><h3>close()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l780">code »</a></span></h3><p>Schedules a command to close the current window.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#close">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l324">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#controlFlow">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow used by this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeAsyncScript" class="function"><div><h3><code>&lt;T&gt;</code> executeAsyncScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l617">code »</a></span></h3><p>Schedules a command to execute asynchronous JavaScript in the context of the
+currently selected frame or window. The script fragment will be executed as
+the body of an anonymous function. If the script is provided as a function
+object, that function will be converted to a string for injection into the
+target window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>Unlike executing synchronous JavaScript with <a href="module_selenium-webdriver_chrome_class_Driver.html#executeScript"><code>#executeScript</code></a>,
+scripts executed with this function must explicitly signal they are finished
+by invoking the provided callback. This callback will always be injected
+into the executed function as the last argument, and thus may be referenced
+with <code>arguments[arguments.length - 1]</code>. The following steps will be
+taken for resolving this functions return value against the first argument
+to the script&#39;s callback function:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><strong>Example #1:</strong> Performing a sleep that is synchronized with the currently
+selected window:</p>
+<pre><code>var start &#61; new Date().getTime();
+driver.executeAsyncScript(
+    &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).
+    then(function() {
+      console.log(
+          &#39;Elapsed time: &#39; &#43; (new Date().getTime() - start) &#43; &#39; ms&#39;);
+    });
+</code></pre>
+<p><strong>Example #2:</strong> Synchronizing a test with an AJAX application:</p>
+<pre><code>var button &#61; driver.findElement(By.id(&#39;compose-button&#39;));
+button.click();
+driver.executeAsyncScript(
+    &#39;var callback &#61; arguments[arguments.length - 1];&#39; &#43;
+    &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);
+driver.switchTo().frame(&#39;composeWidget&#39;);
+driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog&#64;example.com&#39;);
+</code></pre>
+<p><strong>Example #3:</strong> Injecting a XMLHttpRequest and waiting for the result. In
+this example, the inject script is specified with a function literal. When
+using this format, the function is converted to a string for injection, so it
+should not reference any symbols not defined in the scope of the page under
+test.</p>
+<pre><code>driver.executeAsyncScript(function() {
+  var callback &#61; arguments[arguments.length - 1];
+  var xhr &#61; new XMLHttpRequest();
+  xhr.open(&#34;GET&#34;, &#34;/resource/data.json&#34;, true);
+  xhr.onreadystatechange &#61; function() {
+    if (xhr.readyState &#61;&#61; 4) {
+      callback(xhr.responseText);
+    }
+  }
+  xhr.send(&#39;&#39;);
+}).then(function(str) {
+  console.log(JSON.parse(str)[&#39;food&#39;]);
+});
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeAsyncScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeScript" class="function"><div><h3><code>&lt;T&gt;</code> executeScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l528">code »</a></span></h3><p>Schedules a command to execute JavaScript in the context of the currently
+selected frame or window. The script fragment will be executed as the body
+of an anonymous function. If the script is provided as a function object,
+that function will be converted to a string for injection into the target
+window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>The script may refer to any variables accessible from the current window.
+Furthermore, the script will execute in the window&#39;s context, thus
+<code>document</code> may be used to refer to the current document. Any local
+variables will not be available once the script has finished executing,
+though global variables will persist.</p>
+<p>If the script has a return value (i.e. if the script contains a return
+statement), then the following steps will be taken for resolving this
+functions return value:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l867">code »</a></span></h3><p>Schedule a command to find an element on the page. If the element cannot be
+found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will be returned
+by the driver. Unlike other commands, this error cannot be suppressed. In
+other words, scheduling a command to find an element doubles as an assert
+that the element is present on the page. To test whether an element is
+present on the page, use <a href="module_selenium-webdriver_chrome_class_Driver.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; driver.findElement(firstVisibleLink);
+
+function firstVisibleLink(driver) {
+  var links &#61; driver.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p>When running in the browser, a WebDriver cannot manipulate DOM elements
+directly; it may do so only through a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> reference.
+This function may be used to generate a WebElement from a DOM element. A
+reference to the DOM element will be stored in a known location and this
+driver will attempt to retrieve it through <a href="module_selenium-webdriver_chrome_class_Driver.html#executeScript"><code>#executeScript</code></a>. If the
+element cannot be found (eg, it belongs to a different document than the
+one this instance is currently focused on), a
+<a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error will be returned.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElement">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l994">code »</a></span></h3><p>Schedule a command to search for multiple elements on the page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElements">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l792">code »</a></span></h3><p>Schedules a command to navigate to the given URL.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#get">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The fully qualified URL to open.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the document has finished loading.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAllWindowHandles" class="function"><div><h3>getAllWindowHandles()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l753">code »</a></span></h3><p>Schedules a command to retrieve the current list of available window handles.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getAllWindowHandles">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;&gt;</code><dd><p>A promise that will
+be resolved with an array of window handles.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l430">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCapabilities">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>&gt;</code><dd><p>A promise
+that will resolve with the this instance&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCurrentUrl" class="function"><div><h3>getCurrentUrl()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l802">code »</a></span></h3><p>Schedules a command to retrieve the URL of the current page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCurrentUrl">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current URL.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPageSource" class="function"><div><h3>getPageSource()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l768">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s source. The page source
+returned is a representation of the underlying DOM: do not expect it to be
+formatted or escaped in the same way as the response sent from the web
+server.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getPageSource">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page source.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSession" class="function"><div><h3>getSession()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l421">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getSession">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Session.html">webdriver.Session</a>&gt;</code><dd><p>A promise for this
+client&#39;s session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTitle" class="function"><div><h3>getTitle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l814">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s title.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getTitle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page&#39;s title.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWindowHandle" class="function"><div><h3>getWindowHandle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l741">code »</a></span></h3><p>Schedules a command to retrieve they current window handle.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getWindowHandle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current window handle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locatorOrElement)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l974">code »</a></span></h3><p>Schedules a command to test if an element is present on the page.</p>
+<p>If given a DOM element, this function will check if it belongs to the
+document the driver is currently focused on. Otherwise, the function will
+test if at least one element can be found with the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#isElementPresent">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locatorOrElement<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator to use, or the actual
+DOM element to be located by the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the element is present on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="launchApp" class="function"><div><h3>launchApp(<wbr>id)<span class="codelink"><a href="source/chrome.js.src.html#l834">code »</a></span></h3><p>Schedules a command to launch Chrome App with given ID.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>id<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>ID of the App to launch.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved
+when app is launched.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manage" class="function"><div><h3>manage()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1056">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#manage">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code><dd><p>The options interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="navigate" class="function"><div><h3>navigate()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1065">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#navigate">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code><dd><p>The navigation interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="quit" class="function"><div><h3>quit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l444">code »</a></span></h3><p>Schedules a command to quit the current session. After calling quit, this
+instance will be invalidated and may no longer be used to issue commands
+against the browser.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#quit">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="schedule" class="function"><div><h3><code>&lt;T&gt;</code> schedule(<wbr>command, description)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l338">code »</a></span></h3><p>Schedules a <code>webdriver.Command</code> to be executed by this driver&#39;s
+<code>webdriver.CommandExecutor</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#schedule">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to schedule.</p>
+<dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of the command for debugging.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the command result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFileDetector" class="function"><div><h3>setFileDetector(<wbr>detector)<span class="codelink"><a href="source/chrome.js.src.html#l824">code »</a></span></h3><p>This function is a no-op as file detectors are not supported by this
+implementation.</p>
+<p><b>Overrides: </b><a href="class_webdriver_WebDriver.html#setFileDetector">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detector<code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code><dd><p>The detector to use or <code>null</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sleep" class="function"><div><h3>sleep(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l731">code »</a></span></h3><p>Schedules a command to make the driver sleep for the given amount of time.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#sleep">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to sleep.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the sleep has finished.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="switchTo" class="function"><div><h3>switchTo()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1074">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#switchTo">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code><dd><p>The target locator interface for
+this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="takeScreenshot" class="function"><div><h3>takeScreenshot()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1046">code »</a></span></h3><p>Schedule a command to take a screenshot. The driver makes a best effort to
+return a screenshot of the following, in order of preference:</p>
+<ol><li>Entire page
+  </li><li>Current window
+  </li><li>Visible portion of the current frame
+  </li><li>The screenshot of the entire display containing the browser
+</li></ol>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#takeScreenshot">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the screenshot as a base-64 encoded PNG.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="touchActions" class="function"><div><h3>touchActions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l486">code »</a></span></h3><p>Creates a new touch sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_TouchSequence.html#perform"><code>webdriver.TouchSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.touchActions().
+    tap(element1).
+    doubleTap(element2).
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#touchActions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A new touch sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l700">code »</a></span></h3><p>Schedules a command to wait for a condition to hold. The condition may be
+specified by a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a>, as a custom function, or
+as a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>.</p>
+<p>For a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a> or function, the wait will repeatedly
+evaluate the condition until it returns a truthy value. If any errors occur
+while evaluating the condition, they will be allowed to propagate. In the
+event a condition returns a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>, the
+polling loop will wait for it to be resolved and use the resolved value for
+whether the condition has been satisified. Note the resolution time for
+a promise is factored into whether a wait has timed out.</p>
+<p><em>Example:</em> waiting up to 10 seconds for an element to be present and visible
+on the page.</p>
+<pre><code>var button &#61; driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);
+button.click();
+</code></pre>
+<p>This function may also be used to block the command flow on the resolution
+of a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>. When given a promise, the
+command will simply wait for its resolution before completing. A timeout may
+be provided to fail the command if the promise does not resolve before the
+timeout expires.</p>
+<p><em>Example:</em> Suppose you have a function, <code>startTestServer</code>, that returns a
+promise for when a server is ready for requests. You can block a <code>WebDriver</code>
+client on this promise with:</p>
+<pre><code>var started &#61; startTestServer();
+driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);
+driver.get(getServerUrl());
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#wait">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|<a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;T&gt;|function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): T)</code><dd><p>The condition to
+wait on, defined as a promise, condition object, or  a function to
+evaluate as a condition.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait for the condition to be true.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional message to use if the wait times
+out.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+with the first truthy value returned by the condition function, or
+rejected if the condition times out.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_chrome_class_Options.html b/docs/module_selenium-webdriver_chrome_class_Options.html
index 0e21c20..4b92901 100644
--- a/docs/module_selenium-webdriver_chrome_class_Options.html
+++ b/docs/module_selenium-webdriver_chrome_class_Options.html
@@ -1,22 +1,127 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>Options</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class Options</h1><a class="source" href="source/chrome.js.src.html#l469">code &raquo;</a></header><section><p>Class for managing ChromeDriver specific options.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">Options <span class="args">( )</span></span></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l285">code &raquo;</a><span class="member"><a name="addArguments">addArguments</a> <span class="args">( var_args )</span> &rArr; <code class="type">!Options</code></span></div><p>Add additional command line arguments to use when launching the Chrome
- browser.  Each argument may be specified with or without the "--" prefix
- (e.g. "--foo" and "foo"). Arguments with an associated value should be
- delimited by an "=": "foo=bar".</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd>The arguments to add.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l299">code &raquo;</a><span class="member"><a name="addExtensions">addExtensions</a> <span class="args">( var_args )</span> &rArr; <code class="type">!Options</code></span></div><p>Add additional extensions to install when launching Chrome. Each extension
- should be specified as the path to the packed CRX file, or a Buffer for an
- extension.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!Buffer|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code><dd>The
-     extensions to add.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l331">code &raquo;</a><span class="member"><a name="detachDriver">detachDriver</a> <span class="args">( detach )</span> &rArr; <code class="type">!Options</code></span></div><p>Sets whether to leave the started Chrome browser running if the controlling
- ChromeDriver service is killed before <code  class="type"><a href="class_webdriver_WebDriver.html#quit">webdriver.WebDriver#quit()</a></code> is
- called.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>detach: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether to leave the browser running if the
-     chromedriver service is killed before the session.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l317">code &raquo;</a><span class="member"><a name="setChromeBinaryPath">setChromeBinaryPath</a> <span class="args">( path )</span> &rArr; <code class="type">!Options</code></span></div><p>Sets the path to the Chrome binary to use. On Mac OS X, this path should
- reference the actual Chrome executable, not just the application binary
- (e.g. "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome").
+<!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>Options</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_chrome.html">selenium-webdriver/chrome</a></div><div class="codelink"><a href="source/chrome.js.src.html#l845">View Source</a></div><h1>class Options</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>
+  &#x2514; Options</pre><p>Class for managing ChromeDriver specific options.</p>
+<h3>new Options()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="addArguments" class="function"><div><h3>addArguments(<wbr>var_args)<span class="codelink"><a href="source/chrome.js.src.html#l447">code »</a></span></h3><p>Add additional command line arguments to use when launching the Chrome
+browser.  Each argument may be specified with or without the &#34;--&#34; prefix
+(e.g. &#34;--foo&#34; and &#34;foo&#34;). Arguments with an associated value should be
+delimited by an &#34;&#61;&#34;: &#34;foo&#61;bar&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The arguments to add.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="addExtensions" class="function"><div><h3>addExtensions(<wbr>var_args)<span class="codelink"><a href="source/chrome.js.src.html#l482">code »</a></span></h3><p>Add additional extensions to install when launching Chrome. Each extension
+should be specified as the path to the packed CRX file, or a Buffer for an
+extension.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Buffer|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Buffer)&gt;)</code><dd><p>The
+extensions to add.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="androidActivity" class="function"><div><h3>androidActivity(<wbr>name)<span class="codelink"><a href="source/chrome.js.src.html#l592">code »</a></span></h3><p>Sets the name of the activity hosting a Chrome-based Android WebView. This
+option must be set to connect to an <a href="https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android">Android WebView</a></p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The activity name.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="androidChrome" class="function"><div><h3>androidChrome()<span class="codelink"><a href="source/chrome.js.src.html#l618">code »</a></span></h3><p>Configures the ChromeDriver to launch Chrome on Android via adb. This
+function is shorthand for
+<a href="module_selenium-webdriver_chrome_class_Options.html#androidPackage"><code>options.androidPackage(&#39;com.android.chrome&#39;)</code></a>.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="androidDeviceSerial" class="function"><div><h3>androidDeviceSerial(<wbr>serial)<span class="codelink"><a href="source/chrome.js.src.html#l606">code »</a></span></h3><p>Sets the device serial number to connect to via ADB. If not specified, the
+ChromeDriver will select an unused device at random. An error will be
+returned if all devices already have active sessions.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>serial<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The device serial number to connect to.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="androidPackage" class="function"><div><h3>androidPackage(<wbr>pkg)<span class="codelink"><a href="source/chrome.js.src.html#l630">code »</a></span></h3><p>Sets the package name of the Chrome or WebView app.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>pkg<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The package to connect to, or <code>null</code> to disable Android
+and switch back to using desktop Chrome.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="androidProcess" class="function"><div><h3>androidProcess(<wbr>processName)<span class="codelink"><a href="source/chrome.js.src.html#l644">code »</a></span></h3><p>Sets the process name of the Activity hosting the WebView (as given by <code>ps</code>).
+If not specified, the process name is assumed to be the same as
+<a href="module_selenium-webdriver_chrome_class_Options.html#androidPackage"><code>#androidPackage</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>processName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The main activity name.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="androidUseRunningApp" class="function"><div><h3>androidUseRunningApp(<wbr>useRunning)<span class="codelink"><a href="source/chrome.js.src.html#l658">code »</a></span></h3><p>Sets whether to connect to an already-running instead of the specified
+<a href="module_selenium-webdriver_chrome_class_Options.html#androidProcess">app</a> instead of launching the app with a clean
+data directory.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>useRunning<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to connect to a running instance.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="detachDriver" class="function"><div><h3>detachDriver(<wbr>detach)<span class="codelink"><a href="source/chrome.js.src.html#l513">code »</a></span></h3><p>Sets whether to leave the started Chrome browser running if the controlling
+ChromeDriver service is killed before <a href="class_webdriver_WebDriver.html#quit"><code>webdriver.WebDriver#quit()</code></a> is
+called.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detach<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to leave the browser running if the
+chromedriver service is killed before the session.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="excludeSwitches" class="function"><div><h3>excludeSwitches(<wbr>var_args)<span class="codelink"><a href="source/chrome.js.src.html#l464">code »</a></span></h3><p>List of Chrome command line switches to exclude that ChromeDriver by default
+passes when starting Chrome.  Do not prefix switches with &#34;--&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The switches to exclude.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/chrome.js.src.html#l770">code »</a></span></h3><p>Converts this instance to its JSON wire protocol representation. Note this
+function is an implementation not intended for general use.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{args: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;, binary: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), detach: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, extensions: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)&gt;, localState: ?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>), logPath: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), prefs: ?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)}</code><dd><p>The JSON wire protocol representation
+of this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setChromeBinaryPath" class="function"><div><h3>setChromeBinaryPath(<wbr>path)<span class="codelink"><a href="source/chrome.js.src.html#l499">code »</a></span></h3><p>Sets the path to the Chrome binary to use. On Mac OS X, this path should
+reference the actual Chrome executable, not just the application binary
+(e.g. &#34;/Applications/Google Chrome.app/Contents/MacOS/Google Chrome&#34;).</p>
+<p>The binary path be absolute or relative to the chromedriver server
+executable, but it must exist on the machine that will launch Chrome.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to the Chrome binary to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setChromeLogFile" class="function"><div><h3>setChromeLogFile(<wbr>path)<span class="codelink"><a href="source/chrome.js.src.html#l670">code »</a></span></h3><p>Sets the path to Chrome&#39;s log file. This path should exist on the machine
+that will launch Chrome.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the log file to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setChromeMinidumpPath" class="function"><div><h3>setChromeMinidumpPath(<wbr>path)<span class="codelink"><a href="source/chrome.js.src.html#l682">code »</a></span></h3><p>Sets the directory to store Chrome minidumps in. This option is only
+supported when ChromeDriver is running on Linux.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The directory path.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLocalState" class="function"><div><h3>setLocalState(<wbr>state)<span class="codelink"><a href="source/chrome.js.src.html#l578">code »</a></span></h3><p>Sets preferences for the &#34;Local State&#34; file in Chrome&#39;s user data
+directory.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>state<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>Dictionary of local state preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPrefs" class="function"><div><h3>setLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/chrome.js.src.html#l536">code »</a></span></h3><p>Sets the logging preferences for the new session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code><a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a></code><dd><p>The logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setMobileEmulation" class="function"><div><h3>setMobileEmulation(<wbr>config)<span class="codelink"><a href="source/chrome.js.src.html#l724">code »</a></span></h3><p>Configures Chrome to emulate a mobile device. For more information, refer to
+the ChromeDriver project page on <a href="https://sites.google.com/a/chromium.org/chromedriver/mobile-emulation">mobile emulation</a>. Configuration
+options include:</p>
+<ul><li><code>deviceName</code>: The name of a pre-configured <a href="https://developer.chrome.com/devtools/docs/device-mode">emulated device</a></li><li><code>width</code>: screen width, in pixels</li><li><code>height</code>: screen height, in pixels</li><li><code>pixelRatio</code>: screen pixel ratio</li></ul>
+<p><strong>Example 1: Using a Pre-configured Device</strong></p>
+<pre><code>var options &#61; new chrome.Options().setMobileEmulation(
+    {deviceName: &#39;Google Nexus 5&#39;});
 
- The binary path be absolute or relative to the chromedriver server
- executable, but it must exist on the machine that will launch Chrome.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The path to the Chrome binary to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l378">code &raquo;</a><span class="member"><a name="setChromeLogFile">setChromeLogFile</a> <span class="args">( path )</span> &rArr; <code class="type">!Options</code></span></div><p>Sets the path to Chrome's log file. This path should exist on the machine
- that will launch Chrome.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Path to the log file to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l366">code &raquo;</a><span class="member"><a name="setLocalState">setLocalState</a> <span class="args">( state )</span> &rArr; <code class="type">!Options</code></span></div><p>Sets preferences for the "Local State" file in Chrome's user data
- directory.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>state: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Dictionary of local state preferences.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l354">code &raquo;</a><span class="member"><a name="setLoggingPreferences">setLoggingPreferences</a> <span class="args">( prefs )</span> &rArr; <code class="type">!Options</code></span></div><p>Sets the logging preferences for the new session.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>prefs: <code class="type">!<a href="namespace_webdriver_logging.html#webdriver.logging.Preferences">webdriver.logging.Preferences</a></code><dd>The logging preferences.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l389">code &raquo;</a><span class="member"><a name="setProxy">setProxy</a> <span class="args">( proxy )</span> &rArr; <code class="type">!Options</code></span></div><p>Sets the proxy settings for the new session.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>proxy: <code class="type">ProxyConfig</code><dd>The proxy configuration to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l343">code &raquo;</a><span class="member"><a name="setUserPreferences">setUserPreferences</a> <span class="args">( prefs )</span> &rArr; <code class="type">!Options</code></span></div><p>Sets the user preferences for Chrome's user profile. See the "Preferences"
- file in Chrome's user data directory for examples.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>prefs: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Dictionary of user preferences to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l401">code &raquo;</a><span class="member"><a name="toCapabilities">toCapabilities</a> <span class="args">( opt_capabilities )</span> &rArr; <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></span></div><p>Converts this options instance to a <code  class="type"><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code> object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_capabilities: <code class="type"><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>=</code><dd>The capabilities to merge
-     these options into, if any.</dl><tr><th>Returns<tr><td><dl>The capabilities.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l423">code &raquo;</a><span class="member"><a name="toJSON">toJSON</a> <span class="args">( )</span> &rArr; <code class="type">{args: !<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;, binary: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), detach: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, extensions: !<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;, localState: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), logFile: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), prefs: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}</code></span></div><p>Converts this instance to its JSON wire protocol representation. Note this
- function is an implementation not intended for general use.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The JSON wire protocol representation
-     of this instance.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/chrome.js.src.html#l234">code &raquo;</a><span class="member"><a name="args_">args_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/chrome.js.src.html#l237">code &raquo;</a><span class="member"><a name="extensions_">extensions_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div></section><section id="static-functions"><h2>Static Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l247">code &raquo;</a><span class="member"><a name="Options.fromCapabilities">Options.fromCapabilities</a> <span class="args">( capabilities )</span> &rArr; <code class="type">!Options</code></span></div><p>Extracts the ChromeDriver specific options from the given capabilities
- object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>capabilities: <code class="type">!<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd>The capabilities object.</dl><tr><th>Returns<tr><td><dl>The ChromeDriver options.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+var driver &#61; new chrome.Driver(options);
+</code></pre>
+<p><strong>Example 2: Using Custom Screen Configuration</strong></p>
+<pre><code>var options &#61; new chrome.Options().setMobileEmulation({
+    width: 360,
+    height: 640,
+    pixelRatio: 3.0
+});
+
+var driver &#61; new chrome.Driver(options);
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>config<code>?({deviceName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{height: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, pixelRatio: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, width: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd><p>The
+mobile emulation configuration, or <code>null</code> to disable emulation.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setPerfLoggingPrefs" class="function"><div><h3>setPerfLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/chrome.js.src.html#l566">code »</a></span></h3><p>Sets the performance logging preferences. Options include:</p>
+<ul><li><code>enableNetwork</code>: Whether or not to collect events from Network domain.</li><li><code>enablePage</code>: Whether or not to collect events from Page domain.</li><li><code>enableTimeline</code>: Whether or not to collect events from Timeline domain.
+Note: when tracing is enabled, Timeline domain is implicitly disabled,
+unless <code>enableTimeline</code> is explicitly set to true.</li><li><code>tracingCategories</code>: A comma-separated string of Chrome tracing categories
+for which trace events should be collected. An unspecified or empty
+string disables tracing.</li><li><code>bufferUsageReportingInterval</code>: The requested number of milliseconds
+between DevTools trace buffer usage events. For example, if 1000, then
+once per second, DevTools will report how full the trace buffer is. If a
+report indicates the buffer usage is 100%, a warning will be issued.</li></ul>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code>{bufferUsageReportingInterval: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, enableNetwork: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, enablePage: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, enableTimeline: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, tracingCategories: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>The performance
+logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>proxy)<span class="codelink"><a href="source/chrome.js.src.html#l735">code »</a></span></h3><p>Sets the proxy settings for the new session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code><a href="module_selenium-webdriver.html">selenium-webdriver.ProxyConfig</a></code><dd><p>The proxy configuration to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setUserPreferences" class="function"><div><h3>setUserPreferences(<wbr>prefs)<span class="codelink"><a href="source/chrome.js.src.html#l525">code »</a></span></h3><p>Sets the user preferences for Chrome&#39;s user profile. See the &#34;Preferences&#34;
+file in Chrome&#39;s user data directory for examples.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>Dictionary of user preferences to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toCapabilities" class="function"><div><h3>toCapabilities(<wbr>opt_capabilities)<span class="codelink"><a href="source/chrome.js.src.html#l747">code »</a></span></h3><p>Converts this options instance to a <a href="class_webdriver_Capabilities.html"><code>webdriver.Capabilities</code></a> object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_capabilities<code>?<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>=</code><dd><p>The capabilities to merge
+these options into, if any.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The capabilities.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="Options.fromCapabilities" class="function"><div><h3>Options.fromCapabilities(<wbr>capabilities)<span class="codelink"><a href="source/chrome.js.src.html#l405">code »</a></span></h3><p>Extracts the ChromeDriver specific options from the given capabilities
+object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>capabilities<code><a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a></code><dd><p>The capabilities object.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_Options.html">Options</a></code><dd><p>The ChromeDriver options.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html b/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html
index 3d478af..fad8b45 100644
--- a/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html
+++ b/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html
@@ -1,13 +1,46 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>ServiceBuilder</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class ServiceBuilder</h1><a class="source" href="source/chrome.js.src.html#l468">code &raquo;</a></header><section><p>Creates <code  class="type"><a class="unresolved-link">remote.DriverService</a></code> instances that manage a ChromeDriver
- server.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">ServiceBuilder <span class="args">( opt_exe )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_exe: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Path to the server executable to use. If omitted,
-     the builder will attempt to locate the chromedriver on the current
-     PATH.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If provided executable does not exist, or the chromedriver
-     cannot be found on the PATH.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l173">code &raquo;</a><span class="member"><a name="build">build</a> <span class="args">( )</span> &rArr; <code class="type">remote.DriverService</code></span></div><p>Creates a new DriverService using this instance's current configuration.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new driver service using this instance's
-     current configuration.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the driver exectuable was not specified and a default
-     could not be found on the current PATH.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l111">code &raquo;</a><span class="member"><a name="enableVerboseLogging">enableVerboseLogging</a> <span class="args">( )</span> &rArr; <code class="type">!ServiceBuilder</code></span></div><p>Enables verbose logging.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l101">code &raquo;</a><span class="member"><a name="loggingTo">loggingTo</a> <span class="args">( path )</span> &rArr; <code class="type">!ServiceBuilder</code></span></div><p>Sets the path of the log file the driver should log to. If a log file is
- not specified, the driver will log to stderr.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Path of the log file to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l123">code &raquo;</a><span class="member"><a name="setNumHttpThreads">setNumHttpThreads</a> <span class="args">( n )</span> &rArr; <code class="type">!ServiceBuilder</code></span></div><p>Sets the number of threads the driver should use to manage HTTP requests.
- By default, the driver will use 4 threads.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>n: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of threads to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l148">code &raquo;</a><span class="member"><a name="setStdio">setStdio</a> <span class="args">( config )</span> &rArr; <code class="type">!ServiceBuilder</code></span></div><p>Defines the stdio configuration for the driver service. See
- <code >child_process.spawn</code> for more information.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>config: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code><dd>The
-     configuration to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l135">code &raquo;</a><span class="member"><a name="setUrlBasePath">setUrlBasePath</a> <span class="args">( path )</span> &rArr; <code class="type">!ServiceBuilder</code></span></div><p>Sets the base path for WebDriver REST commands (e.g. "/wd/hub").
- By default, the driver will accept commands relative to "/".</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The base path to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l86">code &raquo;</a><span class="member"><a name="usingPort">usingPort</a> <span class="args">( port )</span> &rArr; <code class="type">!ServiceBuilder</code></span></div><p>Sets the port to start the ChromeDriver on.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>port: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The port to use, or 0 for any free port.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the port is invalid.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/chrome.js.src.html#l160">code &raquo;</a><span class="member"><a name="withEnvironment">withEnvironment</a> <span class="args">( env )</span> &rArr; <code class="type">!ServiceBuilder</code></span></div><p>Defines the environment to start the server under. This settings will be
- inherited by every browser session started by the server.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>env: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The environment to use.</dl><tr><th>Returns<tr><td><dl>A self reference.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/chrome.js.src.html#l63">code &raquo;</a><span class="member"><a name="args_">args_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/chrome.js.src.html#l77">code &raquo;</a><span class="member"><a name="env_">env_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/chrome.js.src.html#l49">code &raquo;</a><span class="member"><a name="exe_">exe_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/chrome.js.src.html#l69">code &raquo;</a><span class="member"><a name="port_">port_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/chrome.js.src.html#l73">code &raquo;</a><span class="member"><a name="stdio_">stdio_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>ServiceBuilder</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_chrome.html">selenium-webdriver/chrome</a></div><div class="codelink"><a href="source/chrome.js.src.html#l846">View Source</a></div><h1>class ServiceBuilder</h1><p>Creates <a href="module_selenium-webdriver_remote_class_DriverService.html"><code>selenium-webdriver/remote.DriverService</code></a> instances that manage
+a <a href="https://sites.google.com/a/chromium.org/chromedriver/">ChromeDriver</a>
+server in a child process.</p>
+<h3>new ServiceBuilder(<wbr>opt_exe)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_exe<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Path to the server executable to use. If omitted,
+the builder will attempt to locate the chromedriver on the current
+PATH.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If provided executable does not exist, or the chromedriver
+cannot be found on the PATH.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="build" class="function"><div><h3>build()<span class="codelink"><a href="source/chrome.js.src.html#l319">code »</a></span></h3><p>Creates a new DriverService using this instance&#39;s current configuration.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a></code><dd><p>A new driver service using this instance&#39;s
+current configuration.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the driver exectuable was not specified and a default
+could not be found on the current PATH.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="enableVerboseLogging" class="function"><div><h3>enableVerboseLogging()<span class="codelink"><a href="source/chrome.js.src.html#l256">code »</a></span></h3><p>Enables verbose logging.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="loggingTo" class="function"><div><h3>loggingTo(<wbr>path)<span class="codelink"><a href="source/chrome.js.src.html#l246">code »</a></span></h3><p>Sets the path of the log file the driver should log to. If a log file is
+not specified, the driver will log to stderr.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path of the log file to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAdbPort" class="function"><div><h3>setAdbPort(<wbr>port)<span class="codelink"><a href="source/chrome.js.src.html#l234">code »</a></span></h3><p>Sets which port adb is listening to. <em>The ChromeDriver will connect to adb
+if an <a href="module_selenium-webdriver_chrome_class_Options.html#androidPackage">Android session</a> is requested, but
+adb <strong>must</strong> be started beforehand.</em></p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>port<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>Which port adb is running on.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setNumHttpThreads" class="function"><div><h3>setNumHttpThreads(<wbr>n)<span class="codelink"><a href="source/chrome.js.src.html#l268">code »</a></span></h3><p>Sets the number of threads the driver should use to manage HTTP requests.
+By default, the driver will use 4 threads.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>n<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The number of threads to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setStdio" class="function"><div><h3>setStdio(<wbr>config)<span class="codelink"><a href="source/chrome.js.src.html#l294">code »</a></span></h3><p>Defines the stdio configuration for the driver service. See
+<code>child_process.spawn</code> for more information.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>config<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|Stream)&gt;)</code><dd><p>The
+configuration to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setUrlBasePath" class="function"><div><h3>setUrlBasePath(<wbr>path)<span class="codelink"><a href="source/chrome.js.src.html#l280">code »</a></span></h3><p>Sets the base path for WebDriver REST commands (e.g. &#34;/wd/hub&#34;).
+By default, the driver will accept commands relative to &#34;/&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The base path to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="usingPort" class="function"><div><h3>usingPort(<wbr>port)<span class="codelink"><a href="source/chrome.js.src.html#l217">code »</a></span></h3><p>Sets the port to start the ChromeDriver on.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>port<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The port to use, or 0 for any free port.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the port is invalid.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="withEnvironment" class="function"><div><h3>withEnvironment(<wbr>env)<span class="codelink"><a href="source/chrome.js.src.html#l306">code »</a></span></h3><p>Defines the environment to start the server under. This settings will be
+inherited by every browser session started by the server.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>env<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>The environment to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_chrome_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_ActionSequence.html b/docs/module_selenium-webdriver_class_ActionSequence.html
new file mode 100644
index 0000000..b1f433b
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_ActionSequence.html
@@ -0,0 +1,115 @@
+<!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>ActionSequence</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l34">View Source</a></div><h1>class ActionSequence</h1><dl><dt>Alias for <code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code></dl><p>Class for defining sequences of complex user interactions. Each sequence
+will not be executed until <a href="class_webdriver_ActionSequence.html#perform"><code>#perform</code></a> is called.</p>
+<p>Example:</p>
+<pre><code>new webdriver.ActionSequence(driver).
+    keyDown(webdriver.Key.SHIFT).
+    click(element1).
+    click(element2).
+    dragAndDrop(element3, element4).
+    keyUp(webdriver.Key.SHIFT).
+    perform();
+</code></pre>
+<h3>new ActionSequence(<wbr>driver)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver instance to use.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="click" class="function"><div><h3>click(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l249">code »</a></span></h3><p>Clicks a mouse button.</p>
+<p>If an element is provided, the mouse will first be moved to the center
+of that element. This is equivalent to:</p>
+<pre><code>sequence.mouseMove(element).click()
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
+the element to interact with or the button to click with.
+Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
+button is specified.</p>
+<dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
+<a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
+first argument.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="doubleClick" class="function"><div><h3>doubleClick(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l276">code »</a></span></h3><p>Double-clicks a mouse button.</p>
+<p>If an element is provided, the mouse will first be moved to the center of
+that element. This is equivalent to:</p>
+<pre><code>sequence.mouseMove(element).doubleClick()
+</code></pre>
+<p>Warning: this method currently only supports the left mouse button. See
+<a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
+the element to interact with or the button to click with.
+Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
+button is specified.</p>
+<dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
+<a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
+first argument.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="dragAndDrop" class="function"><div><h3>dragAndDrop(<wbr>element, location)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l227">code »</a></span></h3><p>Convenience function for performing a &#34;drag and drop&#34; manuever. The target
+element may be moved to the location of another element, or by an offset (in
+pixels).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to drag.</p>
+<dt>location<code>(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd><p>The
+location to drag to, either as another WebElement or an offset in pixels.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="keyDown" class="function"><div><h3>keyDown(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l324">code »</a></span></h3><p>Performs a modifier key press. The modifier key is <em>not released</em>
+until <a href="module_selenium-webdriver_class_ActionSequence.html#keyUp"><code>#keyUp</code></a> or <a href="module_selenium-webdriver_class_ActionSequence.html#sendKeys"><code>#sendKeys</code></a> is called. The key press will be
+targetted at the currently focused element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The modifier key to push. Must be one of
+{ALT, CONTROL, SHIFT, COMMAND, META}.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the key is not a valid modifier key.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="keyUp" class="function"><div><h3>keyUp(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l338">code »</a></span></h3><p>Performs a modifier key release. The release is targetted at the currently
+focused element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The modifier key to release. Must be one of
+{ALT, CONTROL, SHIFT, COMMAND, META}.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the key is not a valid modifier key.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="mouseDown" class="function"><div><h3>mouseDown(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l183">code »</a></span></h3><p>Presses a mouse button. The mouse button will not be released until
+<a href="module_selenium-webdriver_class_ActionSequence.html#mouseUp"><code>#mouseUp</code></a> is called, regardless of whether that call is made in this
+sequence or another. The behavior for out-of-order events (e.g. mouseDown,
+click) is undefined.</p>
+<p>If an element is provided, the mouse will first be moved to the center
+of that element. This is equivalent to:</p>
+<pre><code>sequence.mouseMove(element).mouseDown()
+</code></pre>
+<p>Warning: this method currently only supports the left mouse button. See
+<a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
+the element to interact with or the button to click with.
+Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
+button is specified.</p>
+<dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
+<a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
+first argument.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="mouseMove" class="function"><div><h3>mouseMove(<wbr>location, opt_offset)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l102">code »</a></span></h3><p>Moves the mouse.  The location to move to may be specified in terms of the
+mouse&#39;s current location, an offset relative to the top-left corner of an
+element, or an element (in which case the middle of the element is used).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>location<code>(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd><p>The
+location to drag to, as either another WebElement or an offset in pixels.</p>
+<dt>opt_offset<code>{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}=</code><dd><p>If the target <code>location</code>
+is defined as a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, this parameter defines an
+offset within that element. The offset should be specified in pixels
+relative to the top-left corner of the element&#39;s bounding box. If
+omitted, the element&#39;s center will be used as the target offset.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="mouseUp" class="function"><div><h3>mouseUp(<wbr>opt_elementOrButton, opt_button)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l211">code »</a></span></h3><p>Releases a mouse button. Behavior is undefined for calling this function
+without a previous call to <a href="module_selenium-webdriver_class_ActionSequence.html#mouseDown"><code>#mouseDown</code></a>.</p>
+<p>If an element is provided, the mouse will first be moved to the center
+of that element. This is equivalent to:</p>
+<pre><code>sequence.mouseMove(element).mouseUp()
+</code></pre>
+<p>Warning: this method currently only supports the left mouse button. See
+<a href="http://code.google.com/p/selenium/issues/detail?id&#61;4047">issue 4047</a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_elementOrButton<code>?(<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd><p>Either
+the element to interact with or the button to click with.
+Defaults to <a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a> if neither an element nor
+button is specified.</p>
+<dt>opt_button<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>The button to use. Defaults to
+<a href="enum_webdriver_Button.html#LEFT"><code>webdriver.Button.LEFT</code></a>. Ignored if a button is provided as the
+first argument.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="perform" class="function"><div><h3>perform()<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l75">code »</a></span></h3><p>Executes this action sequence.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved once
+this sequence has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/actionsequence.js.src.html#l353">code »</a></span></h3><p>Simulates typing multiple keys. Each modifier key encountered in the
+sequence will not be released until it is encountered again. All key events
+will be targetted at the currently focused element.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The keys to type.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A self reference.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the key is not a valid modifier key.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_Builder.html b/docs/module_selenium-webdriver_class_Builder.html
new file mode 100644
index 0000000..024bc6e
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_Builder.html
@@ -0,0 +1,138 @@
+<!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>Builder</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l38">View Source</a></div><h1>class Builder</h1><dl><dt>Alias for <code><a href="module_selenium-webdriver_builder_class_Builder.html">module(selenium-webdriver/builder).Builder</a></code></dl><p>Creates new <a href="class_webdriver_WebDriver.html"><code>WebDriver</code></a> instances. The environment
+variables listed below may be used to override a builder&#39;s configuration,
+allowing quick runtime changes.</p>
+<ul><li>
+<p><code>SELENIUM_BROWSER</code>: defines the target browser in the form
+<code>browser[:version][:platform]</code>.</p>
+</li><li>
+<p><code>SELENIUM_REMOTE_URL</code>: defines the remote URL for all builder
+instances. This environment variable should be set to a fully qualified
+URL for a WebDriver server (e.g. http://localhost:4444/wd/hub). This
+option always takes precedence over <code>SELENIUM_SERVER_JAR</code>.</p>
+</li><li>
+<p><code>SELENIUM_SERVER_JAR</code>: defines the path to the
+<a href="http://selenium-release.storage.googleapis.com/index.html">
+standalone Selenium server</a> jar to use. The server will be started the
+first time a WebDriver instance and be killed when the process exits.</p>
+</li></ul>
+<p>Suppose you had mytest.js that created WebDriver with</p>
+<pre><code>var driver &#61; new webdriver.Builder()
+    .forBrowser(&#39;chrome&#39;)
+    .build();
+</code></pre>
+<p>This test could be made to use Firefox on the local machine by running with
+<code>SELENIUM_BROWSER&#61;firefox node mytest.js</code>. Rather than change the code to
+target Google Chrome on a remote machine, you can simply set the
+<code>SELENIUM_BROWSER</code> and <code>SELENIUM_REMOTE_URL</code> environment variables:</p>
+<pre><code>SELENIUM_BROWSER&#61;chrome:36:LINUX \
+SELENIUM_REMOTE_URL&#61;http://www.example.com:4444/wd/hub \
+node mytest.js
+</code></pre>
+<p>You could also use a local copy of the standalone Selenium server:</p>
+<pre><code>SELENIUM_BROWSER&#61;chrome:36:LINUX \
+SELENIUM_SERVER_JAR&#61;/path/to/selenium-server-standalone.jar \
+node mytest.js
+</code></pre>
+<h3>new Builder()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="build" class="function"><div><h3>build()<span class="codelink"><a href="source/builder.js.src.html#l391">code »</a></span></h3><p>Creates a new WebDriver client based on this builder&#39;s current
+configuration.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>A new WebDriver instance.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the current configuration is invalid.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="disableEnvironmentOverrides" class="function"><div><h3>disableEnvironmentOverrides()<span class="codelink"><a href="source/builder.js.src.html#l130">code »</a></span></h3><p>Configures this builder to ignore any environment variable overrides and to
+only use the configuration specified through this instance&#39;s API.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="forBrowser" class="function"><div><h3>forBrowser(<wbr>name, opt_version, opt_platform)<span class="codelink"><a href="source/builder.js.src.html#l225">code »</a></span></h3><p>Configures the target browser for clients created by this instance.
+Any calls to <a href="module_selenium-webdriver_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a> after this function will
+overwrite these settings.</p>
+<p>You may also define the target browser using the <code>SELENIUM_BROWSER</code>
+environment variable. If set, this environment variable should be of the
+form <code>browser[:[version][:platform]]</code>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the target browser;
+common defaults are available on the <a href="enum_webdriver_Browser.html"><code>webdriver.Browser</code></a> enum.</p>
+<dt>opt_version<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>A desired version; may be omitted if any
+version should be used.</p>
+<dt>opt_platform<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The desired platform; may be omitted if any
+version may be used.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/builder.js.src.html#l203">code »</a></span></h3><p>Returns the base set of capabilities this instance is currently configured
+to use.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The current capabilities for this builder.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getServerUrl" class="function"><div><h3>getServerUrl()<span class="codelink"><a href="source/builder.js.src.html#l157">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of the WebDriver server this instance is configured
+to use.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWebDriverProxy" class="function"><div><h3>getWebDriverProxy()<span class="codelink"><a href="source/builder.js.src.html#l180">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of the proxy server to use for the WebDriver&#39;s HTTP
+connections.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAlertBehavior" class="function"><div><h3>setAlertBehavior(<wbr>beahvior)<span class="codelink"><a href="source/builder.js.src.html#l289">code »</a></span></h3><p>Sets the default action to take with an unexpected alert before returning
+an error.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>beahvior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The desired behavior; should be &#34;accept&#34;, &#34;dismiss&#34;,
+or &#34;ignore&#34;. Defaults to &#34;dismiss&#34;.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setChromeOptions" class="function"><div><h3>setChromeOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l304">code »</a></span></h3><p>Sets Chrome specific <a href="module_selenium-webdriver_chrome_class_Options.html">options</a>
+for drivers created by this builder. Any logging or proxy settings defined
+on the given options will take precedence over those set through
+<a href="module_selenium-webdriver_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>chrome.Options</code><dd><p>The ChromeDriver options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setControlFlow" class="function"><div><h3>setControlFlow(<wbr>flow)<span class="codelink"><a href="source/builder.js.src.html#l378">code »</a></span></h3><p>Sets the control flow that created drivers should execute actions in. If
+the flow is never set, or is set to <code>null</code>, it will use the active
+flow at the time <a href="module_selenium-webdriver_class_Builder.html#build"><code>#build()</code></a> is called.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>flow<code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow to use, or
+<code>null</code> to</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setEnableNativeEvents" class="function"><div><h3>setEnableNativeEvents(<wbr>enabled)<span class="codelink"><a href="source/builder.js.src.html#l264">code »</a></span></h3><p>Sets whether native events should be used.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enabled<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable native events.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFirefoxOptions" class="function"><div><h3>setFirefoxOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l319">code »</a></span></h3><p>Sets Firefox specific <a href="module_selenium-webdriver_firefox_class_Options.html">options</a>
+for drivers created by this builder. Any logging or proxy settings defined
+on the given options will take precedence over those set through
+<a href="module_selenium-webdriver_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>firefox.Options</code><dd><p>The FirefoxDriver options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setIeOptions" class="function"><div><h3>setIeOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l349">code »</a></span></h3><p>Sets Internet Explorer specific
+<a href="module_selenium-webdriver_ie_class_Options.html">options</a> for drivers created by
+this builder. Any proxy settings defined on the given options will take
+precedence over those set through <a href="module_selenium-webdriver_class_Builder.html#setProxy"><code>#setProxy</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>ie.Options</code><dd><p>The IEDriver options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPrefs" class="function"><div><h3>setLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/builder.js.src.html#l253">code »</a></span></h3><p>Sets the logging preferences for the created session. Preferences may be
+changed by repeated calls, or by calling <a href="module_selenium-webdriver_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code>(<a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The
+desired logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setOperaOptions" class="function"><div><h3>setOperaOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l334">code »</a></span></h3><p>Sets Opera specific <a href="module_selenium-webdriver_opera_class_Options.html">options</a> for
+drivers created by this builder. Any logging or proxy settings defined on the
+given options will take precedence over those set through
+<a href="module_selenium-webdriver_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a> and <a href="module_selenium-webdriver_class_Builder.html#setProxy"><code>#setProxy</code></a>, respectively.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>opera.Options</code><dd><p>The OperaDriver options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>config)<span class="codelink"><a href="source/builder.js.src.html#l240">code »</a></span></h3><p>Sets the proxy configuration to use for WebDriver clients created by this
+builder. Any calls to <a href="module_selenium-webdriver_class_Builder.html#withCapabilities"><code>#withCapabilities</code></a> after this function will
+overwrite these settings.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>config<code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>The configuration to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setSafariOptions" class="function"><div><h3>setSafariOptions(<wbr>options)<span class="codelink"><a href="source/builder.js.src.html#l364">code »</a></span></h3><p>Sets Safari specific <a href="module_selenium-webdriver_safari_class_Options.html">options</a>
+for drivers created by this builder. Any logging settings defined on the
+given options will take precedence over those set through
+<a href="module_selenium-webdriver_class_Builder.html#setLoggingPrefs"><code>#setLoggingPrefs</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>safari.Options</code><dd><p>The Safari options to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setScrollBehavior" class="function"><div><h3>setScrollBehavior(<wbr>behavior)<span class="codelink"><a href="source/builder.js.src.html#l276">code »</a></span></h3><p>Sets how elements should be scrolled into view for interaction.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>behavior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired scroll behavior: either 0 to align with
+the top of the viewport or 1 to align with the bottom.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="usingServer" class="function"><div><h3>usingServer(<wbr>url)<span class="codelink"><a href="source/builder.js.src.html#l147">code »</a></span></h3><p>Sets the URL of a remote WebDriver server to use. Once a remote URL has been
+specified, the builder direct all new clients to that server. If this method
+is never called, the Builder will attempt to create all clients locally.</p>
+<p>As an alternative to this method, you may also set the <code>SELENIUM_REMOTE_URL</code>
+environment variable.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of a remote server to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="usingWebDriverProxy" class="function"><div><h3>usingWebDriverProxy(<wbr>proxy)<span class="codelink"><a href="source/builder.js.src.html#l170">code »</a></span></h3><p>Sets the URL of the proxy to use for the WebDriver&#39;s HTTP connections.
+If this method is never called, the Builder will create a connection without
+a proxy.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL of a proxy to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="withCapabilities" class="function"><div><h3>withCapabilities(<wbr>capabilities)<span class="codelink"><a href="source/builder.js.src.html#l192">code »</a></span></h3><p>Sets the desired capabilities when requesting a new session. This will
+overwrite any previously set capabilities.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>capabilities<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>The desired
+capabilities for a new session.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_builder_class_Builder.html">Builder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_Capabilities.html b/docs/module_selenium-webdriver_class_Capabilities.html
new file mode 100644
index 0000000..2c78d90
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_Capabilities.html
@@ -0,0 +1,60 @@
+<!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>Capabilities</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l46">View Source</a></div><h1>class Capabilities</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, ?&gt;&gt;
+  &#x2514; Capabilities</pre><dl><dt>Alias for <code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code></dl><h3>new Capabilities(<wbr>opt_other)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_other<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>Another set of
+capabilities to merge into this instance.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="get" class="function"><div><h3>get(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l340">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The capability to return.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><p>The capability with the given key, or <code>null</code> if it has
+not been set.</p>
+</div></div></div></div><hr class="fn-sep"><div id="has" class="function"><div><h3>has(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l353">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The capability to check.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the specified capability is set.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="merge" class="function"><div><h3>merge(<wbr>other)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l307">code »</a></span></h3><p>Merges another set of capabilities into this instance. Any duplicates in
+the provided set will override those already set on this instance.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>other<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>The capabilities to
+merge into this instance.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l295">code »</a></span></h3><p>Returns either this instance&#39;s serialized represention, if immediately
+available, or a promise for its serialized representation. This function is
+conceptually equivalent to objects that have a <code>toJSON()</code> property,
+except the serialize() result may be a promise or an object containing a
+promise (which are not directly JSON friendly).</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, ?&gt;</code><dd><p>The JSON representation of this instance. Note,
+the returned object may contain nested promises that are promised values.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="set" class="function"><div><h3>set(<wbr>key, value)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l325">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The capability to set.</p>
+<dt>value<code>*</code><dd><p>The capability value.  Capability values must be JSON
+serializable. Pass <code>null</code> to unset the capability.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAlertBehavior" class="function"><div><h3>setAlertBehavior(<wbr>behavior)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l409">code »</a></span></h3><p>Sets the default action to take with an unexpected alert before returning
+an error.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>behavior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The desired behavior; should be &#34;accept&#34;, &#34;dismiss&#34;,
+or &#34;ignore&#34;. Defaults to &#34;dismiss&#34;.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setEnableNativeEvents" class="function"><div><h3>setEnableNativeEvents(<wbr>enabled)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l386">code »</a></span></h3><p>Sets whether native events should be used.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enabled<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable native events.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPrefs" class="function"><div><h3>setLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l366">code »</a></span></h3><p>Sets the logging preferences. Preferences may be specified as a
+<a href="class_webdriver_logging_Preferences.html"><code>webdriver.logging.Preferences</code></a> instance, or a as a map of log-type to
+log-level.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code>(<a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The
+logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>proxy)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l376">code »</a></span></h3><p>Sets the proxy configuration for this instance.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>The desired proxy configuration.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setScrollBehavior" class="function"><div><h3>setScrollBehavior(<wbr>behavior)<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l397">code »</a></span></h3><p>Sets how elements should be scrolled into view for interaction.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>behavior<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired scroll behavior: either 0 to align with
+the top of the viewport or 1 to align with the bottom.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="Capabilities.android" class="function"><div><h3>Capabilities.android()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l186">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Android.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.chrome" class="function"><div><h3>Capabilities.chrome()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l196">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Chrome.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.firefox" class="function"><div><h3>Capabilities.firefox()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l205">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Firefox.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.htmlunit" class="function"><div><h3>Capabilities.htmlunit()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l273">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for HTMLUnit.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.htmlunitwithjs" class="function"><div><h3>Capabilities.htmlunitwithjs()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l283">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for HTMLUnit
+with enabled Javascript.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.ie" class="function"><div><h3>Capabilities.ie()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l215">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for
+Internet Explorer.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.ipad" class="function"><div><h3>Capabilities.ipad()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l226">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for iPad.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.iphone" class="function"><div><h3>Capabilities.iphone()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l236">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for iPhone.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.opera" class="function"><div><h3>Capabilities.opera()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l246">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Opera.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.phantomjs" class="function"><div><h3>Capabilities.phantomjs()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l255">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for
+PhantomJS.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="Capabilities.safari" class="function"><div><h3>Capabilities.safari()<span class="codelink"><a href="source/lib/webdriver/capabilities.js.src.html#l264">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A basic set of capabilities for Safari.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_Command.html b/docs/module_selenium-webdriver_class_Command.html
new file mode 100644
index 0000000..8a50c03
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_Command.html
@@ -0,0 +1,15 @@
+<!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>Command</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l50">View Source</a></div><h1>class Command</h1><dl><dt>Alias for <code><a href="class_webdriver_Command.html">webdriver.Command</a></code></dl><p>Describes a command to be executed by the WebDriverJS framework.</p>
+<h3>new Command(<wbr>name)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of this command.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getName" class="function"><div><h3>getName()<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l52">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>This command&#39;s name.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getParameter" class="function"><div><h3>getParameter(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l85">code »</a></span></h3><p>Returns a named command parameter.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The parameter key to look up.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><p>The parameter value, or undefined if it has not been set.</p>
+</div></div></div></div><hr class="fn-sep"><div id="getParameters" class="function"><div><h3>getParameters()<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l93">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, *&gt;</code><dd><p>The parameters to send with this command.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setParameter" class="function"><div><h3>setParameter(<wbr>name, value)<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l63">code »</a></span></h3><p>Sets a parameter to send with this command.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The parameter name.</p>
+<dt>value<code>*</code><dd><p>The parameter value.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setParameters" class="function"><div><h3>setParameters(<wbr>parameters)<span class="codelink"><a href="source/lib/webdriver/command.js.src.html#l74">code »</a></span></h3><p>Sets the parameters for this command.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>parameters<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, *&gt;</code><dd><p>The command parameters.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_EventEmitter.html b/docs/module_selenium-webdriver_class_EventEmitter.html
new file mode 100644
index 0000000..57f15d6
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_EventEmitter.html
@@ -0,0 +1,35 @@
+<!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>EventEmitter</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l54">View Source</a></div><h1>class EventEmitter</h1><dl><dt>Alias for <code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code></dl><p>Object that can emit events for others to listen for. This is used instead
+of Closure&#39;s event system because it is much more light weight. The API is
+based on Node&#39;s EventEmitters.</p>
+<h3>new EventEmitter()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="addListener" class="function"><div><h3>addListener(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l119">code »</a></span></h3><p>Registers a listener.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="emit" class="function"><div><h3>emit(<wbr>type, var_args)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l47">code »</a></span></h3><p>Fires an event and calls all listeners.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to emit.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to each listener.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="listeners" class="function"><div><h3>listeners(<wbr>type)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l74">code »</a></span></h3><p>Returns a mutable list of listeners for a specific type of event.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to retrieve the listeners for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;{fn: Function, oneshot: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, scope: ?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)}&gt;</code><dd><p>The registered listeners for
+the given event type.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="on" class="function"><div><h3>on(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l145">code »</a></span></h3><p>An alias for <code>#addListener()</code>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="once" class="function"><div><h3>once(<wbr>type, listenerFn, opt_scope)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l133">code »</a></span></h3><p>Registers a one-time listener which will be called only the first time an
+event is emitted, after which it will be removed.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to listen for.</p>
+<dt>listenerFn<code>Function</code><dd><p>The function to invoke when the event is fired.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to invoke the listener.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="removeAllListeners" class="function"><div><h3>removeAllListeners(<wbr>opt_type)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l176">code »</a></span></h3><p>Removes all listeners for a specific type of event. If no event is
+specified, all listeners across all types will be removed.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The type of event to remove listeners from.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="removeListener" class="function"><div><h3>removeListener(<wbr>type, listenerFn)<span class="codelink"><a href="source/lib/webdriver/events.js.src.html#l155">code »</a></span></h3><p>Removes a previously registered event listener.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The type of event to unregister.</p>
+<dt>listenerFn<code>Function</code><dd><p>The handler function to remove.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_FileDetector.html b/docs/module_selenium-webdriver_class_FileDetector.html
new file mode 100644
index 0000000..e9c4fe4
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_FileDetector.html
@@ -0,0 +1,21 @@
+<!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>FileDetector</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l58">View Source</a></div><h1>class FileDetector</h1><dl><dt>Alias for <code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code></dl><p>Used with <a href="class_webdriver_WebElement.html#sendKeys"><code>WebElement#sendKeys</code></a> on file
+input elements (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>) to detect when the entered key
+sequence defines the path to a file.</p>
+<p>By default, <a href="class_webdriver_WebElement.html">WebElement&#39;s</a> will enter all
+key sequences exactly as entered. You may set a
+<a href="class_webdriver_WebDriver.html#setFileDetector">file detector</a> on the parent
+WebDriver instance to define custom behavior for handling file elements. Of
+particular note is the <a href="module_selenium-webdriver_remote_class_FileDetector.html"><code>selenium-webdriver/remote.FileDetector</code></a>, which
+should be used when running against a remote
+<a href="http://docs.seleniumhq.org/download/">Selenium Server</a>.</p>
+<h3>new FileDetector()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="handleFile" class="function"><div><h3>handleFile(<wbr>driver, path)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2489">code »</a></span></h3><p>Handles the file specified by the given path, preparing it for use with
+the current browser. If the path does not refer to a valid file, it will
+be returned unchanged, otherwisee a path suitable for use with the current
+browser will be returned.</p>
+<p>This default implementation is a no-op. Subtypes may override this
+function for custom tailored file handling.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver for the current browser.</p>
+<dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to process.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise for the processed
+file path.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_Serializable.html b/docs/module_selenium-webdriver_class_Serializable.html
new file mode 100644
index 0000000..b32c21f
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_Serializable.html
@@ -0,0 +1,9 @@
+<!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>Serializable</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l62">View Source</a></div><h1>class Serializable&lt;T&gt;</h1><dl><dt>Alias for <code><a href="class_webdriver_Serializable.html">webdriver.Serializable</a></code></dl><p>Defines an object that can be asynchronously serialized to its WebDriver
+wire representation.</p>
+<h3>new Serializable()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/lib/webdriver/serializable.js.src.html#l41">code »</a></span></h3><p>Returns either this instance&#39;s serialized represention, if immediately
+available, or a promise for its serialized representation. This function is
+conceptually equivalent to objects that have a <code>toJSON()</code> property,
+except the serialize() result may be a promise or an object containing a
+promise (which are not directly JSON friendly).</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(T|IThenable&lt;T&gt;)</code><dd><p>This instance&#39;s serialized wire format.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_Session.html b/docs/module_selenium-webdriver_class_Session.html
new file mode 100644
index 0000000..60f2a3d
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_Session.html
@@ -0,0 +1,13 @@
+<!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>Session</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l66">View Source</a></div><h1>class Session</h1><dl><dt>Alias for <code><a href="class_webdriver_Session.html">webdriver.Session</a></code></dl><p>Contains information about a WebDriver session.</p>
+<h3>new Session(<wbr>id, capabilities)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>id<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The session ID.</p>
+<dt>capabilities<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>The session
+capabilities.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/session.js.src.html#l52">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>This session&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapability" class="function"><div><h3>getCapability(<wbr>key)<span class="codelink"><a href="source/lib/webdriver/session.js.src.html#l62">code »</a></span></h3><p>Retrieves the value of a specific capability.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The capability to retrieve.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><p>The capability value.</p>
+</div></div></div></div><hr class="fn-sep"><div id="getId" class="function"><div><h3>getId()<span class="codelink"><a href="source/lib/webdriver/session.js.src.html#l44">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>This session&#39;s ID.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toJSON" class="function"><div><h3>toJSON(<wbr>arg0)<span class="codelink"><a href="source/lib/webdriver/session.js.src.html#l72">code »</a></span></h3><p>Returns the JSON representation of this object, which is just the string
+session ID.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arg0<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The JSON representation of this Session.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_WebDriver.html b/docs/module_selenium-webdriver_class_WebDriver.html
new file mode 100644
index 0000000..99951bc
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_WebDriver.html
@@ -0,0 +1,313 @@
+<!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>WebDriver</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l70">View Source</a></div><h1>class WebDriver</h1><dl><dt>Alias for <code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></dl><p>Creates a new WebDriver client, which provides control over a browser.</p>
+<p>Every WebDriver command returns a <code>webdriver.promise.Promise</code> that
+represents the result of that command. Callbacks may be registered on this
+object to manipulate the command result or catch an expected error. Any
+commands scheduled with a callback are considered sub-commands and will
+execute before the next command in the current frame. For example:</p>
+<pre><code>var message &#61; [];
+driver.call(message.push, message, &#39;a&#39;).then(function() {
+  driver.call(message.push, message, &#39;b&#39;);
+});
+driver.call(message.push, message, &#39;c&#39;);
+driver.call(function() {
+  alert(&#39;message is abc? &#39; &#43; (message.join(&#39;&#39;) &#61;&#61; &#39;abc&#39;));
+});
+</code></pre>
+<h3>new WebDriver(<wbr>session, executor, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>session<code>(<a href="class_webdriver_Session.html">webdriver.Session</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code><dd><p>Either a
+known session or a promise that will be resolved to a session.</p>
+<dt>executor<code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd><p>The executor to use when
+sending commands to the browser.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The flow to
+schedule commands through. Defaults to the active flow object.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="actions" class="function"><div><h3>actions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l469">code »</a></span></h3><p>Creates a new action sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_ActionSequence.html#perform"><code>webdriver.ActionSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.actions().
+    mouseDown(element1).
+    mouseMove(element2).
+    mouseUp().
+    perform();
+</code></pre>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A new action sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="call" class="function"><div><h3><code>&lt;T&gt;</code> call(<wbr>fn, opt_scope, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l639">code »</a></span></h3><p>Schedules a command to execute a custom function.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(...?): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+execute.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to execute the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved&#39;
+with the function&#39;s result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="close" class="function"><div><h3>close()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l780">code »</a></span></h3><p>Schedules a command to close the current window.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l324">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow used by this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeAsyncScript" class="function"><div><h3><code>&lt;T&gt;</code> executeAsyncScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l617">code »</a></span></h3><p>Schedules a command to execute asynchronous JavaScript in the context of the
+currently selected frame or window. The script fragment will be executed as
+the body of an anonymous function. If the script is provided as a function
+object, that function will be converted to a string for injection into the
+target window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>Unlike executing synchronous JavaScript with <a href="module_selenium-webdriver_class_WebDriver.html#executeScript"><code>#executeScript</code></a>,
+scripts executed with this function must explicitly signal they are finished
+by invoking the provided callback. This callback will always be injected
+into the executed function as the last argument, and thus may be referenced
+with <code>arguments[arguments.length - 1]</code>. The following steps will be
+taken for resolving this functions return value against the first argument
+to the script&#39;s callback function:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><strong>Example #1:</strong> Performing a sleep that is synchronized with the currently
+selected window:</p>
+<pre><code>var start &#61; new Date().getTime();
+driver.executeAsyncScript(
+    &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).
+    then(function() {
+      console.log(
+          &#39;Elapsed time: &#39; &#43; (new Date().getTime() - start) &#43; &#39; ms&#39;);
+    });
+</code></pre>
+<p><strong>Example #2:</strong> Synchronizing a test with an AJAX application:</p>
+<pre><code>var button &#61; driver.findElement(By.id(&#39;compose-button&#39;));
+button.click();
+driver.executeAsyncScript(
+    &#39;var callback &#61; arguments[arguments.length - 1];&#39; &#43;
+    &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);
+driver.switchTo().frame(&#39;composeWidget&#39;);
+driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog&#64;example.com&#39;);
+</code></pre>
+<p><strong>Example #3:</strong> Injecting a XMLHttpRequest and waiting for the result. In
+this example, the inject script is specified with a function literal. When
+using this format, the function is converted to a string for injection, so it
+should not reference any symbols not defined in the scope of the page under
+test.</p>
+<pre><code>driver.executeAsyncScript(function() {
+  var callback &#61; arguments[arguments.length - 1];
+  var xhr &#61; new XMLHttpRequest();
+  xhr.open(&#34;GET&#34;, &#34;/resource/data.json&#34;, true);
+  xhr.onreadystatechange &#61; function() {
+    if (xhr.readyState &#61;&#61; 4) {
+      callback(xhr.responseText);
+    }
+  }
+  xhr.send(&#39;&#39;);
+}).then(function(str) {
+  console.log(JSON.parse(str)[&#39;food&#39;]);
+});
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeScript" class="function"><div><h3><code>&lt;T&gt;</code> executeScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l528">code »</a></span></h3><p>Schedules a command to execute JavaScript in the context of the currently
+selected frame or window. The script fragment will be executed as the body
+of an anonymous function. If the script is provided as a function object,
+that function will be converted to a string for injection into the target
+window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>The script may refer to any variables accessible from the current window.
+Furthermore, the script will execute in the window&#39;s context, thus
+<code>document</code> may be used to refer to the current document. Any local
+variables will not be available once the script has finished executing,
+though global variables will persist.</p>
+<p>If the script has a return value (i.e. if the script contains a return
+statement), then the following steps will be taken for resolving this
+functions return value:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l867">code »</a></span></h3><p>Schedule a command to find an element on the page. If the element cannot be
+found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will be returned
+by the driver. Unlike other commands, this error cannot be suppressed. In
+other words, scheduling a command to find an element doubles as an assert
+that the element is present on the page. To test whether an element is
+present on the page, use <a href="module_selenium-webdriver_class_WebDriver.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; driver.findElement(firstVisibleLink);
+
+function firstVisibleLink(driver) {
+  var links &#61; driver.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p>When running in the browser, a WebDriver cannot manipulate DOM elements
+directly; it may do so only through a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> reference.
+This function may be used to generate a WebElement from a DOM element. A
+reference to the DOM element will be stored in a known location and this
+driver will attempt to retrieve it through <a href="module_selenium-webdriver_class_WebDriver.html#executeScript"><code>#executeScript</code></a>. If the
+element cannot be found (eg, it belongs to a different document than the
+one this instance is currently focused on), a
+<a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error will be returned.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l994">code »</a></span></h3><p>Schedule a command to search for multiple elements on the page.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l792">code »</a></span></h3><p>Schedules a command to navigate to the given URL.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The fully qualified URL to open.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the document has finished loading.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAllWindowHandles" class="function"><div><h3>getAllWindowHandles()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l753">code »</a></span></h3><p>Schedules a command to retrieve the current list of available window handles.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;&gt;</code><dd><p>A promise that will
+be resolved with an array of window handles.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l430">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>&gt;</code><dd><p>A promise
+that will resolve with the this instance&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCurrentUrl" class="function"><div><h3>getCurrentUrl()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l802">code »</a></span></h3><p>Schedules a command to retrieve the URL of the current page.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current URL.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPageSource" class="function"><div><h3>getPageSource()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l768">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s source. The page source
+returned is a representation of the underlying DOM: do not expect it to be
+formatted or escaped in the same way as the response sent from the web
+server.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page source.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSession" class="function"><div><h3>getSession()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l421">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Session.html">webdriver.Session</a>&gt;</code><dd><p>A promise for this
+client&#39;s session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTitle" class="function"><div><h3>getTitle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l814">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s title.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page&#39;s title.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWindowHandle" class="function"><div><h3>getWindowHandle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l741">code »</a></span></h3><p>Schedules a command to retrieve they current window handle.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current window handle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locatorOrElement)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l974">code »</a></span></h3><p>Schedules a command to test if an element is present on the page.</p>
+<p>If given a DOM element, this function will check if it belongs to the
+document the driver is currently focused on. Otherwise, the function will
+test if at least one element can be found with the given search criteria.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locatorOrElement<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator to use, or the actual
+DOM element to be located by the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the element is present on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manage" class="function"><div><h3>manage()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1056">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code><dd><p>The options interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="navigate" class="function"><div><h3>navigate()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1065">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code><dd><p>The navigation interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="quit" class="function"><div><h3>quit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l444">code »</a></span></h3><p>Schedules a command to quit the current session. After calling quit, this
+instance will be invalidated and may no longer be used to issue commands
+against the browser.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="schedule" class="function"><div><h3><code>&lt;T&gt;</code> schedule(<wbr>command, description)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l338">code »</a></span></h3><p>Schedules a <code>webdriver.Command</code> to be executed by this driver&#39;s
+<code>webdriver.CommandExecutor</code>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to schedule.</p>
+<dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of the command for debugging.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the command result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFileDetector" class="function"><div><h3>setFileDetector(<wbr>detector)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l407">code »</a></span></h3><p>Sets the <a href="class_webdriver_FileDetector.html">file detector</a> that should be
+used with this instance.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detector<code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code><dd><p>The detector to use or <code>null</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sleep" class="function"><div><h3>sleep(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l731">code »</a></span></h3><p>Schedules a command to make the driver sleep for the given amount of time.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to sleep.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the sleep has finished.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="switchTo" class="function"><div><h3>switchTo()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1074">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code><dd><p>The target locator interface for
+this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="takeScreenshot" class="function"><div><h3>takeScreenshot()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1046">code »</a></span></h3><p>Schedule a command to take a screenshot. The driver makes a best effort to
+return a screenshot of the following, in order of preference:</p>
+<ol><li>Entire page
+  </li><li>Current window
+  </li><li>Visible portion of the current frame
+  </li><li>The screenshot of the entire display containing the browser
+</li></ol>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the screenshot as a base-64 encoded PNG.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="touchActions" class="function"><div><h3>touchActions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l486">code »</a></span></h3><p>Creates a new touch sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_TouchSequence.html#perform"><code>webdriver.TouchSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.touchActions().
+    tap(element1).
+    doubleTap(element2).
+    perform();
+</code></pre>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A new touch sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l700">code »</a></span></h3><p>Schedules a command to wait for a condition to hold. The condition may be
+specified by a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a>, as a custom function, or
+as a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>.</p>
+<p>For a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a> or function, the wait will repeatedly
+evaluate the condition until it returns a truthy value. If any errors occur
+while evaluating the condition, they will be allowed to propagate. In the
+event a condition returns a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>, the
+polling loop will wait for it to be resolved and use the resolved value for
+whether the condition has been satisified. Note the resolution time for
+a promise is factored into whether a wait has timed out.</p>
+<p><em>Example:</em> waiting up to 10 seconds for an element to be present and visible
+on the page.</p>
+<pre><code>var button &#61; driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);
+button.click();
+</code></pre>
+<p>This function may also be used to block the command flow on the resolution
+of a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>. When given a promise, the
+command will simply wait for its resolution before completing. A timeout may
+be provided to fail the command if the promise does not resolve before the
+timeout expires.</p>
+<p><em>Example:</em> Suppose you have a function, <code>startTestServer</code>, that returns a
+promise for when a server is ready for requests. You can block a <code>WebDriver</code>
+client on this promise with:</p>
+<pre><code>var started &#61; startTestServer();
+driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);
+driver.get(getServerUrl());
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|<a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;T&gt;|function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): T)</code><dd><p>The condition to
+wait on, defined as a promise, condition object, or  a function to
+evaluate as a condition.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait for the condition to be true.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional message to use if the wait times
+out.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+with the first truthy value returned by the condition function, or
+rejected if the condition times out.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="WebDriver.attachToSession" class="function"><div><h3>WebDriver.attachToSession(<wbr>executor, sessionId, opt_flow)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l108">code »</a></span></h3><p>Creates a new WebDriver client for an existing session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>executor<code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd><p>Command executor to use when
+querying for session details.</p>
+<dt>sessionId<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>ID of the session to attach to.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow all driver
+commands should execute under. Defaults to the
+<a href="namespace_webdriver_promise.html#controlFlow"><code>currently active</code></a>  control flow.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>A new client for the specified session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="WebDriver.createSession" class="function"><div><h3>WebDriver.createSession(<wbr>executor, desiredCapabilities, opt_flow)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l129">code »</a></span></h3><p>Creates a new WebDriver session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>executor<code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code><dd><p>The executor to create the new
+session with.</p>
+<dt>desiredCapabilities<code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The desired
+capabilities for the new session.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow all driver
+commands should execute under, including the initial session creation.
+Defaults to the <a href="namespace_webdriver_promise.html#controlFlow"><code>currently active</code></a>
+control flow.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver for the newly created session.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_WebDriver_Logs.html">WebDriver.Logs</a><dd><p>Interface for managing WebDriver log records.</p>
+<dt><a href="class_webdriver_WebDriver_Navigation.html">WebDriver.Navigation</a><dd><p>Interface for navigating back and forth in the browser history.</p>
+<dt><a href="class_webdriver_WebDriver_Options.html">WebDriver.Options</a><dd><p>Provides methods for managing browser and driver state.</p>
+<dt><a href="class_webdriver_WebDriver_TargetLocator.html">WebDriver.TargetLocator</a><dd><p>An interface for changing the focus of the driver to another frame or window.</p>
+<dt><a href="class_webdriver_WebDriver_Timeouts.html">WebDriver.Timeouts</a><dd><p>An interface for managing timeout behavior for WebDriver instances.</p>
+<dt><a href="class_webdriver_WebDriver_Window.html">WebDriver.Window</a><dd><p>An interface for managing the current window.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_WebElement.html b/docs/module_selenium-webdriver_class_WebElement.html
new file mode 100644
index 0000000..9d195a1
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_WebElement.html
@@ -0,0 +1,216 @@
+<!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>WebElement</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l74">View Source</a></div><h1>class WebElement</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;
+  &#x2514; WebElement</pre><dl><dt>Alias for <code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code></dl><p>Represents a DOM element. WebElements can be found by searching from the
+document root using a <a href="class_webdriver_WebDriver.html"><code>webdriver.WebDriver</code></a> instance, or by searching
+under another WebElement:</p>
+<pre><code>driver.get(&#39;http://www.google.com&#39;);
+var searchForm &#61; driver.findElement(By.tagName(&#39;form&#39;));
+var searchBox &#61; searchForm.findElement(By.name(&#39;q&#39;));
+searchBox.sendKeys(&#39;webdriver&#39;);
+</code></pre>
+<p>The WebElement is implemented as a promise for compatibility with the promise
+API. It will always resolve itself when its internal state has been fully
+resolved and commands may be issued against the element. This can be used to
+catch errors when an element cannot be located on the page:</p>
+<pre><code>driver.findElement(By.id(&#39;not-there&#39;)).then(function(element) {
+  alert(&#39;Found an element that was not expected to be there!&#39;);
+}, function(error) {
+  alert(&#39;The element was not found, as expected&#39;);
+});
+</code></pre>
+<h3>new WebElement(<wbr>driver, id)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent WebDriver instance for this
+element.</p>
+<dt>id<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;|{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The server-assigned opaque ID for the
+underlying DOM element.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="clear" class="function"><div><h3>clear()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2171">code »</a></span></h3><p>Schedules a command to clear the <code>value</code> of this element. This command
+has no effect if the underlying DOM element is neither a text INPUT element
+nor a TEXTAREA element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the element has been cleared.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="click" class="function"><div><h3>click()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1919">code »</a></span></h3><p>Schedules a command to click on this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the click command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1859">code »</a></span></h3><p>Schedule a command to find a descendant of this element. If the element
+cannot be found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will
+be returned by the driver. Unlike other commands, this error cannot be
+suppressed. In other words, scheduling a command to find an element doubles
+as an assert that the element is present on the page. To test whether an
+element is present on the page, use <a href="module_selenium-webdriver_class_WebElement.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; element.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; element.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; element.findElement(firstVisibleLink);
+
+function firstVisibleLink(element) {
+  var links &#61; element.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1900">code »</a></span></h3><p>Schedules a command to find all of the descendants of this element that
+match the given search criteria.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the elements.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAttribute" class="function"><div><h3>getAttribute(<wbr>attributeName)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2077">code »</a></span></h3><p>Schedules a command to query for the value of the given attribute of the
+element. Will return the current value, even if it has been modified after
+the page has been loaded. More exactly, this method will return the value of
+the given attribute, unless that attribute is not present, in which case the
+value of the property with the same name is returned. If neither value is
+set, null is returned (for example, the &#34;value&#34; property of a textarea
+element). The &#34;style&#34; attribute is converted as best can be to a
+text representation with a trailing semi-colon. The following are deemed to
+be &#34;boolean&#34; attributes and will return either &#34;true&#34; or null:</p>
+<p>async, autofocus, autoplay, checked, compact, complete, controls, declare,
+defaultchecked, defaultselected, defer, disabled, draggable, ended,
+formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope,
+loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open,
+paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
+selected, spellcheck, truespeed, willvalidate</p>
+<p>Finally, the following commonly mis-capitalized attribute/property names
+are evaluated as expected:</p>
+<ul><li>&#34;class&#34;</li><li>&#34;readonly&#34;</li></ul>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>attributeName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the attribute to query.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the attribute&#39;s value. The returned value will always be
+either a string or null.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCssValue" class="function"><div><h3>getCssValue(<wbr>cssStyleProperty)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2039">code »</a></span></h3><p>Schedules a command to query for the computed style of the element
+represented by this instance. If the element inherits the named style from
+its parent, the parent will be queried for its value.  Where possible, color
+values will be converted to their hex representation (e.g. #00ff00 instead of
+rgb(0, 255, 0)).</p>
+<p><em>Warning:</em> the value returned will be as the browser interprets it, so
+it may be tricky to form a proper assertion.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>cssStyleProperty<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the CSS style property to look
+up.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the requested CSS value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getDriver" class="function"><div><h3>getDriver()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1768">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getId" class="function"><div><h3>getId()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1779">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;</code><dd><p>A promise
+that resolves to this element&#39;s JSON representation as defined by the
+WebDriver wire protocol.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getInnerHtml" class="function"><div><h3>getInnerHtml()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2214">code »</a></span></h3><p>Schedules a command to retrieve the inner HTML of this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s inner HTML.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLocation" class="function"><div><h3>getLocation()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2118">code »</a></span></h3><p>Schedules a command to compute the location of this element in page space.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A promise that
+will be resolved to the element&#39;s location as a
+<code>{x:number, y:number}</code> object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getOuterHtml" class="function"><div><h3>getOuterHtml()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2195">code »</a></span></h3><p>Schedules a command to retrieve the outer HTML of this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s outer HTML.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getRawId" class="function"><div><h3>getRawId()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1790">code »</a></span></h3><p>Returns the raw ID string ID for this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that resolves to this
+element&#39;s raw ID as a string value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSize" class="function"><div><h3>getSize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2105">code »</a></span></h3><p>Schedules a command to compute the size of this element&#39;s bounding box, in
+pixels.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{height: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, width: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A
+promise that will be resolved with the element&#39;s size as a
+<code>{width:number, height:number}</code> object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTagName" class="function"><div><h3>getTagName()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2017">code »</a></span></h3><p>Schedules a command to query for the tag/node name of this element.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s tag name.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getText" class="function"><div><h3>getText()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2091">code »</a></span></h3><p>Get the visible (i.e. not hidden by CSS) innerText of this element, including
+sub-elements, without any leading or trailing whitespace.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s visible text.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isDisplayed" class="function"><div><h3>isDisplayed()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2183">code »</a></span></h3><p>Schedules a command to test whether this element is currently displayed.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently visible on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1884">code »</a></span></h3><p>Schedules a command to test if there is at least one descendant of this
+element that matches the given search criteria.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether an element could be located on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isEnabled" class="function"><div><h3>isEnabled()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2131">code »</a></span></h3><p>Schedules a command to query whether the DOM element represented by this
+instance is enabled, as dicted by the <code>disabled</code> attribute.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently enabled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isSelected" class="function"><div><h3>isSelected()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2143">code »</a></span></h3><p>Schedules a command to query whether this element is selected.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently selected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1979">code »</a></span></h3><p>Schedules a command to type a sequence on the DOM element represented by this
+instance.</p>
+<p>Modifier keys (SHIFT, CONTROL, ALT, META) are stateful; once a modifier is
+processed in the keysequence, that key state is toggled until one of the
+following occurs:</p>
+<ul><li>
+<p>The modifier key is encountered again in the sequence. At this point the
+state of the key is toggled (along with the appropriate keyup/down events).</p>
+</li><li>
+<p>The <a href="enum_webdriver_Key.html#NULL"><code>webdriver.Key.NULL</code></a> key is encountered in the sequence. When
+this key is encountered, all modifier keys current in the down state are
+released (with accompanying keyup events). The NULL key can be used to
+simulate common keyboard shortcuts:</p>
+<pre><code>  element.sendKeys(&#34;text was&#34;,
+                   webdriver.Key.CONTROL, &#34;a&#34;, webdriver.Key.NULL,
+                   &#34;now text is&#34;);
+  // Alternatively:
+  element.sendKeys(&#34;text was&#34;,
+                   webdriver.Key.chord(webdriver.Key.CONTROL, &#34;a&#34;),
+                   &#34;now text is&#34;);
+</code></pre>
+</li><li>
+<p>The end of the keysequence is encountered. When there are no more keys
+to type, all depressed modifier keys are released (with accompanying keyup
+events).</p>
+</li></ul>
+<p>If this element is a file input (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>), the
+specified key sequence should specify the path to the file to attach to
+the element. This is analgous to the user clicking &#34;Browse...&#34; and entering
+the path into the file select dialog.</p>
+<pre><code>var form &#61; driver.findElement(By.css(&#39;form&#39;));
+var element &#61; form.findElement(By.css(&#39;input[type&#61;file]&#39;));
+element.sendKeys(&#39;/path/to/file.txt&#39;);
+form.submit();
+</code></pre>
+<p>For uploads to function correctly, the entered path must reference a file
+on the <em>browser&#39;s</em> machine, not the local machine running this script. When
+running against a remote Selenium server, a <a href="class_webdriver_FileDetector.html"><code>webdriver.FileDetector</code></a>
+may be used to transparently copy files to the remote machine before
+attempting to upload them in the browser.</p>
+<p><strong>Note:</strong> On browsers where native keyboard events are not supported
+(e.g. Firefox on OS X), key events will be synthesized. Special
+punctionation keys will be synthesized according to a standard QWERTY en-us
+keyboard layout.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The sequence
+of keys to type. All arguments will be joined into a single sequence.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when all keys have been typed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1798">code »</a></span></h3><p>Returns either this instance&#39;s serialized represention, if immediately
+available, or a promise for its serialized representation. This function is
+conceptually equivalent to objects that have a <code>toJSON()</code> property,
+except the serialize() result may be a promise or an object containing a
+promise (which are not directly JSON friendly).</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(<a href="class_webdriver_WebElement.html#WebElement.Id">webdriver.WebElement.Id</a>|IThenable&lt;<a href="class_webdriver_WebElement.html#WebElement.Id">webdriver.WebElement.Id</a>&gt;)</code><dd><p>This instance&#39;s serialized wire format.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="submit" class="function"><div><h3>submit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2157">code »</a></span></h3><p>Schedules a command to submit the form containing this element (or this
+element if it is a FORM element). This command is a no-op if the element is
+not contained in a form.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the form has been submitted.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="WebElement.equals" class="function"><div><h3>WebElement.equals(<wbr>a, b)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1743">code »</a></span></h3><p>Compares to WebElements for equality.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>a<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement.</p>
+<dt>b<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved to whether the two WebElements are equal.</p>
+</dl></div></div></div></div><h2>Static Properties</h2><div id="WebElement.ELEMENT_KEY" class="property"><dl><dt><a href="source/lib/webdriver/webdriver.js.src.html#l1733">WebElement.ELEMENT_KEY</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The property key used in the wire protocol to indicate that a JSON object
+contains the ID of a WebElement.</p>
+</dl></div><h2>Type Definitions</h2><div id="WebElement.Id" class="property"><dl><dt><a href="source/lib/webdriver/webdriver.js.src.html#l1724">WebElement.Id</a><code>{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>Wire protocol definition of a WebElement ID.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_class_WebElementPromise.html b/docs/module_selenium-webdriver_class_WebElementPromise.html
new file mode 100644
index 0000000..9905850
--- /dev/null
+++ b/docs/module_selenium-webdriver_class_WebElementPromise.html
@@ -0,0 +1,267 @@
+<!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>WebElementPromise</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l78">View Source</a></div><h1>class WebElementPromise</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;
+  &#x2514; <a href="class_webdriver_WebElement.html">webdriver.WebElement</a>
+      &#x2514; WebElementPromise</pre><dl><dt>Alias for <code><a href="class_webdriver_WebElementPromise.html">webdriver.WebElementPromise</a></code><dt>All implemented interfaces<dd><code>IThenable&lt;T&gt;</code><dd><code><a href="interface_webdriver_promise_Thenable.html">webdriver.promise.Thenable</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;</code></dl><p>WebElementPromise is a promise that will be fulfilled with a WebElement.
+This serves as a forward proxy on WebElement, allowing calls to be
+scheduled without directly on this instance before the underlying
+WebElement has been fulfilled. In other words, the following two statements
+are equivalent:</p>
+<pre><code>driver.findElement({id: &#39;my-button&#39;}).click();
+driver.findElement({id: &#39;my-button&#39;}).then(function(el) {
+  return el.click();
+});
+</code></pre>
+<h3>new WebElementPromise(<wbr>driver, el)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent WebDriver instance for this
+element.</p>
+<dt>el<code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;</code><dd><p>A promise
+that will resolve to the promised element.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="cancel" class="function"><div><h3>cancel(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2245">code »</a></span></h3><p>Cancels the computation of this promise&#39;s value, rejecting the promise in
+the process. This method is a no-op if the promise has already been
+resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#cancel">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_CancellationError.html">webdriver.promise.CancellationError</a>)=</code><dd><p>The reason this
+promise is being cancelled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="clear" class="function"><div><h3>clear()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2171">code »</a></span></h3><p>Schedules a command to clear the <code>value</code> of this element. This command
+has no effect if the underlying DOM element is neither a text INPUT element
+nor a TEXTAREA element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#clear">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the element has been cleared.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="click" class="function"><div><h3>click()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1919">code »</a></span></h3><p>Schedules a command to click on this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#click">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the click command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1859">code »</a></span></h3><p>Schedule a command to find a descendant of this element. If the element
+cannot be found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will
+be returned by the driver. Unlike other commands, this error cannot be
+suppressed. In other words, scheduling a command to find an element doubles
+as an assert that the element is present on the page. To test whether an
+element is present on the page, use <a href="module_selenium-webdriver_class_WebElementPromise.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; element.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; element.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; element.findElement(firstVisibleLink);
+
+function firstVisibleLink(element) {
+  var links &#61; element.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#findElement">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1900">code »</a></span></h3><p>Schedules a command to find all of the descendants of this element that
+match the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#findElements">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the elements.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAttribute" class="function"><div><h3>getAttribute(<wbr>attributeName)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2077">code »</a></span></h3><p>Schedules a command to query for the value of the given attribute of the
+element. Will return the current value, even if it has been modified after
+the page has been loaded. More exactly, this method will return the value of
+the given attribute, unless that attribute is not present, in which case the
+value of the property with the same name is returned. If neither value is
+set, null is returned (for example, the &#34;value&#34; property of a textarea
+element). The &#34;style&#34; attribute is converted as best can be to a
+text representation with a trailing semi-colon. The following are deemed to
+be &#34;boolean&#34; attributes and will return either &#34;true&#34; or null:</p>
+<p>async, autofocus, autoplay, checked, compact, complete, controls, declare,
+defaultchecked, defaultselected, defer, disabled, draggable, ended,
+formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope,
+loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open,
+paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
+selected, spellcheck, truespeed, willvalidate</p>
+<p>Finally, the following commonly mis-capitalized attribute/property names
+are evaluated as expected:</p>
+<ul><li>&#34;class&#34;</li><li>&#34;readonly&#34;</li></ul>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getAttribute">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>attributeName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the attribute to query.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the attribute&#39;s value. The returned value will always be
+either a string or null.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCssValue" class="function"><div><h3>getCssValue(<wbr>cssStyleProperty)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2039">code »</a></span></h3><p>Schedules a command to query for the computed style of the element
+represented by this instance. If the element inherits the named style from
+its parent, the parent will be queried for its value.  Where possible, color
+values will be converted to their hex representation (e.g. #00ff00 instead of
+rgb(0, 255, 0)).</p>
+<p><em>Warning:</em> the value returned will be as the browser interprets it, so
+it may be tricky to form a proper assertion.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getCssValue">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>cssStyleProperty<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name of the CSS style property to look
+up.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the requested CSS value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getDriver" class="function"><div><h3>getDriver()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1768">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getDriver">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The parent driver for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getId" class="function"><div><h3>getId()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2264">code »</a></span></h3><p>Defers returning the element ID until the wrapped WebElement has been
+resolved.</p>
+<p><b>Overrides: </b><a href="class_webdriver_WebElement.html#getId">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{ELEMENT: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}&gt;</code><dd><p>A promise
+that resolves to this element&#39;s JSON representation as defined by the
+WebDriver wire protocol.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getInnerHtml" class="function"><div><h3>getInnerHtml()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2214">code »</a></span></h3><p>Schedules a command to retrieve the inner HTML of this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getInnerHtml">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s inner HTML.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLocation" class="function"><div><h3>getLocation()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2118">code »</a></span></h3><p>Schedules a command to compute the location of this element in page space.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getLocation">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{x: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, y: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A promise that
+will be resolved to the element&#39;s location as a
+<code>{x:number, y:number}</code> object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getOuterHtml" class="function"><div><h3>getOuterHtml()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2195">code »</a></span></h3><p>Schedules a command to retrieve the outer HTML of this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getOuterHtml">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s outer HTML.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getRawId" class="function"><div><h3>getRawId()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1790">code »</a></span></h3><p>Returns the raw ID string ID for this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getRawId">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that resolves to this
+element&#39;s raw ID as a string value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSize" class="function"><div><h3>getSize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2105">code »</a></span></h3><p>Schedules a command to compute the size of this element&#39;s bounding box, in
+pixels.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getSize">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;{height: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, width: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}&gt;</code><dd><p>A
+promise that will be resolved with the element&#39;s size as a
+<code>{width:number, height:number}</code> object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTagName" class="function"><div><h3>getTagName()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2017">code »</a></span></h3><p>Schedules a command to query for the tag/node name of this element.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getTagName">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s tag name.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getText" class="function"><div><h3>getText()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2091">code »</a></span></h3><p>Get the visible (i.e. not hidden by CSS) innerText of this element, including
+sub-elements, without any leading or trailing whitespace.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#getText">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the element&#39;s visible text.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isDisplayed" class="function"><div><h3>isDisplayed()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2183">code »</a></span></h3><p>Schedules a command to test whether this element is currently displayed.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#isDisplayed">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently visible on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1884">code »</a></span></h3><p>Schedules a command to test if there is at least one descendant of this
+element that matches the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#isElementPresent">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether an element could be located on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isEnabled" class="function"><div><h3>isEnabled()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2131">code »</a></span></h3><p>Schedules a command to query whether the DOM element represented by this
+instance is enabled, as dicted by the <code>disabled</code> attribute.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#isEnabled">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently enabled.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isPending" class="function"><div><h3>isPending()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2248">code »</a></span></h3><p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#isPending">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether this promise&#39;s value is still being computed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isSelected" class="function"><div><h3>isSelected()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2143">code »</a></span></h3><p>Schedules a command to query whether this element is selected.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#isSelected">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will be
+resolved with whether this element is currently selected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sendKeys" class="function"><div><h3>sendKeys(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1979">code »</a></span></h3><p>Schedules a command to type a sequence on the DOM element represented by this
+instance.</p>
+<p>Modifier keys (SHIFT, CONTROL, ALT, META) are stateful; once a modifier is
+processed in the keysequence, that key state is toggled until one of the
+following occurs:</p>
+<ul><li>
+<p>The modifier key is encountered again in the sequence. At this point the
+state of the key is toggled (along with the appropriate keyup/down events).</p>
+</li><li>
+<p>The <a href="enum_webdriver_Key.html#NULL"><code>webdriver.Key.NULL</code></a> key is encountered in the sequence. When
+this key is encountered, all modifier keys current in the down state are
+released (with accompanying keyup events). The NULL key can be used to
+simulate common keyboard shortcuts:</p>
+<pre><code>  element.sendKeys(&#34;text was&#34;,
+                   webdriver.Key.CONTROL, &#34;a&#34;, webdriver.Key.NULL,
+                   &#34;now text is&#34;);
+  // Alternatively:
+  element.sendKeys(&#34;text was&#34;,
+                   webdriver.Key.chord(webdriver.Key.CONTROL, &#34;a&#34;),
+                   &#34;now text is&#34;);
+</code></pre>
+</li><li>
+<p>The end of the keysequence is encountered. When there are no more keys
+to type, all depressed modifier keys are released (with accompanying keyup
+events).</p>
+</li></ul>
+<p>If this element is a file input (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>), the
+specified key sequence should specify the path to the file to attach to
+the element. This is analgous to the user clicking &#34;Browse...&#34; and entering
+the path into the file select dialog.</p>
+<pre><code>var form &#61; driver.findElement(By.css(&#39;form&#39;));
+var element &#61; form.findElement(By.css(&#39;input[type&#61;file]&#39;));
+element.sendKeys(&#39;/path/to/file.txt&#39;);
+form.submit();
+</code></pre>
+<p>For uploads to function correctly, the entered path must reference a file
+on the <em>browser&#39;s</em> machine, not the local machine running this script. When
+running against a remote Selenium server, a <a href="class_webdriver_FileDetector.html"><code>webdriver.FileDetector</code></a>
+may be used to transparently copy files to the remote machine before
+attempting to upload them in the browser.</p>
+<p><strong>Note:</strong> On browsers where native keyboard events are not supported
+(e.g. Firefox on OS X), key events will be synthesized. Special
+punctionation keys will be synthesized according to a standard QWERTY en-us
+keyboard layout.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#sendKeys">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The sequence
+of keys to type. All arguments will be joined into a single sequence.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when all keys have been typed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1798">code »</a></span></h3><p>Returns either this instance&#39;s serialized represention, if immediately
+available, or a promise for its serialized representation. This function is
+conceptually equivalent to objects that have a <code>toJSON()</code> property,
+except the serialize() result may be a promise or an object containing a
+promise (which are not directly JSON friendly).</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#serialize">webdriver.WebElement</a><br><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(<a href="class_webdriver_WebElement.html#WebElement.Id">webdriver.WebElement.Id</a>|IThenable&lt;<a href="class_webdriver_WebElement.html#WebElement.Id">webdriver.WebElement.Id</a>&gt;)</code><dd><p>This instance&#39;s serialized wire format.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="submit" class="function"><div><h3>submit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2157">code »</a></span></h3><p>Schedules a command to submit the form containing this element (or this
+element if it is a FORM element). This command is a no-op if the element is
+not contained in a form.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebElement.html#submit">webdriver.WebElement</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the form has been submitted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="then" class="function"><div><h3>then(<wbr>opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2251">code »</a></span></h3><p>Registers listeners for when this instance is resolved.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#then">webdriver.promise.Thenable</a>, <a href="#then">IThenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_callback<code>?function(T): (R|IThenable&lt;R&gt;)=</code><dd><p>The
+function to call if this promise is successfully resolved. The function
+should expect a single argument: the promise&#39;s resolved value.</p>
+<dt>opt_errback<code>?function(*): (R|IThenable&lt;R&gt;)=</code><dd><p>The function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenCatch" class="function"><div><h3>thenCatch(<wbr>errback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2254">code »</a></span></h3><p>Registers a listener for when this promise is rejected. This is synonymous
+with the <code>catch</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} catch (ex) {
+  console.error(ex);
+}
+
+// Asynchronous promise API:
+doAsynchronousWork().thenCatch(function(ex) {
+  console.error(ex);
+});
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenCatch">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>errback<code>function(*): (R|IThenable&lt;R&gt;)</code><dd><p>The
+function to call if this promise is rejected. The function should
+expect a single argument: the rejection reason.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise which will be
+resolved with the result of the invoked callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="thenFinally" class="function"><div><h3>thenFinally(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l2257">code »</a></span></h3><p>Registers a listener to invoke when this promise is resolved, regardless
+of whether the promise&#39;s value was successfully computed. This function
+is synonymous with the <code>finally</code> clause in a synchronous API:</p>
+<pre><code>// Synchronous API:
+try {
+  doSynchronousWork();
+} finally {
+  cleanUp();
+}
+
+// Asynchronous promise API:
+doAsynchronousWork().thenFinally(cleanUp);
+</code></pre>
+<p><strong>Note:</strong> similar to the <code>finally</code> clause, if the registered
+callback returns a rejected promise or throws an error, it will silently
+replace the rejection error (if any) from this promise:</p>
+<pre><code>try {
+  throw Error(&#39;one&#39;);
+} finally {
+  throw Error(&#39;two&#39;);  // Hides Error: one
+}
+
+promise.rejected(Error(&#39;one&#39;))
+    .thenFinally(function() {
+      throw Error(&#39;two&#39;);  // Hides Error: one
+    });
+</code></pre>
+<p><b>Specified by: </b><a href="interface_webdriver_promise_Thenable.html#thenFinally">webdriver.promise.Thenable</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(): (R|IThenable&lt;R&gt;)</code><dd><p>The function
+to call when this promise is resolved.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be fulfilled
+with the callback result.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_enum_Browser.html b/docs/module_selenium-webdriver_enum_Browser.html
new file mode 100644
index 0000000..c2dbf58
--- /dev/null
+++ b/docs/module_selenium-webdriver_enum_Browser.html
@@ -0,0 +1,2 @@
+<!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>Browser</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l86">View Source</a></div><h1>enum Browser</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dt>Alias for <code><a href="enum_webdriver_Browser.html">webdriver.Browser</a></code></dl><p>Recognized browser names.</p>
+<h2>Values and Descriptions</h2><div id="ANDROID" class="property"><dl><dt>ANDROID</dl></div><div id="CHROME" class="property"><dl><dt>CHROME</dl></div><div id="FIREFOX" class="property"><dl><dt>FIREFOX</dl></div><div id="HTMLUNIT" class="property"><dl><dt>HTMLUNIT</dl></div><div id="IE" class="property"><dl><dt>IE</dl></div><div id="INTERNET_EXPLORER" class="property"><dl><dt>INTERNET_EXPLORER</dl></div><div id="IPAD" class="property"><dl><dt>IPAD</dl></div><div id="IPHONE" class="property"><dl><dt>IPHONE</dl></div><div id="OPERA" class="property"><dl><dt>OPERA</dl></div><div id="PHANTOM_JS" class="property"><dl><dt>PHANTOM_JS</dl></div><div id="SAFARI" class="property"><dl><dt>SAFARI</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_enum_Button.html b/docs/module_selenium-webdriver_enum_Button.html
new file mode 100644
index 0000000..0b0a57d
--- /dev/null
+++ b/docs/module_selenium-webdriver_enum_Button.html
@@ -0,0 +1,2 @@
+<!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>Button</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l92">View Source</a></div><h1>enum Button</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dt>Alias for <code><a href="enum_webdriver_Button.html">webdriver.Button</a></code></dl><p>Enumeration of the buttons used in the advanced interactions API.</p>
+<h2>Values and Descriptions</h2><div id="LEFT" class="property"><dl><dt>LEFT</dl></div><div id="MIDDLE" class="property"><dl><dt>MIDDLE</dl></div><div id="RIGHT" class="property"><dl><dt>RIGHT</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_enum_Capability.html b/docs/module_selenium-webdriver_enum_Capability.html
new file mode 100644
index 0000000..889d551
--- /dev/null
+++ b/docs/module_selenium-webdriver_enum_Capability.html
@@ -0,0 +1,33 @@
+<!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>Capability</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l98">View Source</a></div><h1>enum Capability</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dt>Alias for <code><a href="enum_webdriver_Capability.html">webdriver.Capability</a></code></dl><p>Common webdriver capability keys.</p>
+<h2>Values and Descriptions</h2><div id="ACCEPT_SSL_CERTS" class="property"><dl><dt>ACCEPT_SSL_CERTS<dd><p>Indicates whether a driver should accept all SSL certs by default. This
+capability only applies when requesting a new session. To query whether
+a driver can handle insecure SSL certs, see <a href="module_selenium-webdriver_enum_Capability.html#SECURE_SSL"><code>#SECURE_SSL</code></a>.</p>
+</dl></div><div id="BROWSER_NAME" class="property"><dl><dt>BROWSER_NAME<dd><p>The browser name. Common browser names are defined in the
+<a href="enum_webdriver_Browser.html"><code>webdriver.Browser</code></a> enum.</p>
+</dl></div><div id="ELEMENT_SCROLL_BEHAVIOR" class="property"><dl><dt>ELEMENT_SCROLL_BEHAVIOR<dd><p>Defines how elements should be scrolled into the viewport for interaction.
+This capability will be set to zero (0) if elements are aligned with the
+top of the viewport, or one (1) if aligned with the bottom. The default
+behavior is to align with the top of the viewport.</p>
+</dl></div><div id="HANDLES_ALERTS" class="property"><dl><dt>HANDLES_ALERTS<dd><p>Whether the driver is capable of handling modal alerts (e.g. alert,
+confirm, prompt). To define how a driver <i>should</i> handle alerts,
+use <a href="module_selenium-webdriver_enum_Capability.html#UNEXPECTED_ALERT_BEHAVIOR"><code>#UNEXPECTED_ALERT_BEHAVIOR</code></a>.</p>
+</dl></div><div id="LOGGING_PREFS" class="property"><dl><dt>LOGGING_PREFS<dd><p>Key for the logging driver logging preferences.</p>
+</dl></div><div id="NATIVE_EVENTS" class="property"><dl><dt>NATIVE_EVENTS<dd><p>Whether this session generates native events when simulating user input.</p>
+</dl></div><div id="PLATFORM" class="property"><dl><dt>PLATFORM<dd><p>Describes the platform the browser is running on. Will be one of
+ANDROID, IOS, LINUX, MAC, UNIX, or WINDOWS. When <i>requesting</i> a
+session, ANY may be used to indicate no platform preference (this is
+semantically equivalent to omitting the platform capability).</p>
+</dl></div><div id="PROXY" class="property"><dl><dt>PROXY<dd><p>Describes the proxy configuration to use for a new WebDriver session.</p>
+</dl></div><div id="ROTATABLE" class="property"><dl><dt>ROTATABLE<dd><p>Whether the driver supports changing the brower&#39;s orientation.</p>
+</dl></div><div id="SECURE_SSL" class="property"><dl><dt>SECURE_SSL<dd><p>Whether a driver is only capable of handling secure SSL certs. To request
+that a driver accept insecure SSL certs by default, use
+<a href="module_selenium-webdriver_enum_Capability.html#ACCEPT_SSL_CERTS"><code>#ACCEPT_SSL_CERTS</code></a>.</p>
+</dl></div><div id="SUPPORTS_APPLICATION_CACHE" class="property"><dl><dt>SUPPORTS_APPLICATION_CACHE<dd><p>Whether the driver supports manipulating the app cache.</p>
+</dl></div><div id="SUPPORTS_CSS_SELECTORS" class="property"><dl><dt>SUPPORTS_CSS_SELECTORS<dd><p>Whether the driver supports locating elements with CSS selectors.</p>
+</dl></div><div id="SUPPORTS_JAVASCRIPT" class="property"><dl><dt>SUPPORTS_JAVASCRIPT<dd><p>Whether the browser supports JavaScript.</p>
+</dl></div><div id="SUPPORTS_LOCATION_CONTEXT" class="property"><dl><dt>SUPPORTS_LOCATION_CONTEXT<dd><p>Whether the driver supports controlling the browser&#39;s location info.</p>
+</dl></div><div id="TAKES_SCREENSHOT" class="property"><dl><dt>TAKES_SCREENSHOT<dd><p>Whether the driver supports taking screenshots.</p>
+</dl></div><div id="UNEXPECTED_ALERT_BEHAVIOR" class="property"><dl><dt>UNEXPECTED_ALERT_BEHAVIOR<dd><p>Defines how the driver should handle unexpected alerts. The value should
+be one of &#34;accept&#34;, &#34;dismiss&#34;, or &#34;ignore.</p>
+</dl></div><div id="VERSION" class="property"><dl><dt>VERSION<dd><p>Defines the browser version.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_enum_CommandName.html b/docs/module_selenium-webdriver_enum_CommandName.html
new file mode 100644
index 0000000..cea56af
--- /dev/null
+++ b/docs/module_selenium-webdriver_enum_CommandName.html
@@ -0,0 +1,3 @@
+<!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>CommandName</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l104">View Source</a></div><h1>enum CommandName</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dt>Alias for <code><a href="enum_webdriver_CommandName.html">webdriver.CommandName</a></code></dl><p>Enumeration of predefined names command names that all command processors
+will support.</p>
+<h2>Values and Descriptions</h2><div id="ACCEPT_ALERT" class="property"><dl><dt>ACCEPT_ALERT</dl></div><div id="ADD_COOKIE" class="property"><dl><dt>ADD_COOKIE</dl></div><div id="CLEAR_APP_CACHE" class="property"><dl><dt>CLEAR_APP_CACHE</dl></div><div id="CLEAR_ELEMENT" class="property"><dl><dt>CLEAR_ELEMENT</dl></div><div id="CLEAR_LOCAL_STORAGE" class="property"><dl><dt>CLEAR_LOCAL_STORAGE</dl></div><div id="CLEAR_SESSION_STORAGE" class="property"><dl><dt>CLEAR_SESSION_STORAGE</dl></div><div id="CLICK" class="property"><dl><dt>CLICK</dl></div><div id="CLICK_ELEMENT" class="property"><dl><dt>CLICK_ELEMENT</dl></div><div id="CLOSE" class="property"><dl><dt>CLOSE</dl></div><div id="DELETE_ALL_COOKIES" class="property"><dl><dt>DELETE_ALL_COOKIES</dl></div><div id="DELETE_COOKIE" class="property"><dl><dt>DELETE_COOKIE</dl></div><div id="DESCRIBE_SESSION" class="property"><dl><dt>DESCRIBE_SESSION</dl></div><div id="DISMISS_ALERT" class="property"><dl><dt>DISMISS_ALERT</dl></div><div id="DOUBLE_CLICK" class="property"><dl><dt>DOUBLE_CLICK</dl></div><div id="ELEMENT_EQUALS" class="property"><dl><dt>ELEMENT_EQUALS</dl></div><div id="EXECUTE_ASYNC_SCRIPT" class="property"><dl><dt>EXECUTE_ASYNC_SCRIPT</dl></div><div id="EXECUTE_SCRIPT" class="property"><dl><dt>EXECUTE_SCRIPT</dl></div><div id="EXECUTE_SQL" class="property"><dl><dt>EXECUTE_SQL</dl></div><div id="FIND_CHILD_ELEMENT" class="property"><dl><dt>FIND_CHILD_ELEMENT</dl></div><div id="FIND_CHILD_ELEMENTS" class="property"><dl><dt>FIND_CHILD_ELEMENTS</dl></div><div id="FIND_ELEMENT" class="property"><dl><dt>FIND_ELEMENT</dl></div><div id="FIND_ELEMENTS" class="property"><dl><dt>FIND_ELEMENTS</dl></div><div id="GET" class="property"><dl><dt>GET</dl></div><div id="GET_ACTIVE_ELEMENT" class="property"><dl><dt>GET_ACTIVE_ELEMENT</dl></div><div id="GET_ALERT_TEXT" class="property"><dl><dt>GET_ALERT_TEXT</dl></div><div id="GET_ALL_COOKIES" class="property"><dl><dt>GET_ALL_COOKIES</dl></div><div id="GET_APP_CACHE" class="property"><dl><dt>GET_APP_CACHE</dl></div><div id="GET_APP_CACHE_STATUS" class="property"><dl><dt>GET_APP_CACHE_STATUS</dl></div><div id="GET_AVAILABLE_LOG_TYPES" class="property"><dl><dt>GET_AVAILABLE_LOG_TYPES</dl></div><div id="GET_COOKIE" class="property"><dl><dt>GET_COOKIE</dl></div><div id="GET_CURRENT_URL" class="property"><dl><dt>GET_CURRENT_URL</dl></div><div id="GET_CURRENT_WINDOW_HANDLE" class="property"><dl><dt>GET_CURRENT_WINDOW_HANDLE</dl></div><div id="GET_ELEMENT_ATTRIBUTE" class="property"><dl><dt>GET_ELEMENT_ATTRIBUTE</dl></div><div id="GET_ELEMENT_LOCATION" class="property"><dl><dt>GET_ELEMENT_LOCATION</dl></div><div id="GET_ELEMENT_LOCATION_IN_VIEW" class="property"><dl><dt>GET_ELEMENT_LOCATION_IN_VIEW</dl></div><div id="GET_ELEMENT_SIZE" class="property"><dl><dt>GET_ELEMENT_SIZE</dl></div><div id="GET_ELEMENT_TAG_NAME" class="property"><dl><dt>GET_ELEMENT_TAG_NAME</dl></div><div id="GET_ELEMENT_TEXT" class="property"><dl><dt>GET_ELEMENT_TEXT</dl></div><div id="GET_ELEMENT_VALUE_OF_CSS_PROPERTY" class="property"><dl><dt>GET_ELEMENT_VALUE_OF_CSS_PROPERTY</dl></div><div id="GET_LOCAL_STORAGE_ITEM" class="property"><dl><dt>GET_LOCAL_STORAGE_ITEM</dl></div><div id="GET_LOCAL_STORAGE_KEYS" class="property"><dl><dt>GET_LOCAL_STORAGE_KEYS</dl></div><div id="GET_LOCAL_STORAGE_SIZE" class="property"><dl><dt>GET_LOCAL_STORAGE_SIZE</dl></div><div id="GET_LOCATION" class="property"><dl><dt>GET_LOCATION</dl></div><div id="GET_LOG" class="property"><dl><dt>GET_LOG</dl></div><div id="GET_PAGE_SOURCE" class="property"><dl><dt>GET_PAGE_SOURCE</dl></div><div id="GET_SCREEN_ORIENTATION" class="property"><dl><dt>GET_SCREEN_ORIENTATION</dl></div><div id="GET_SERVER_STATUS" class="property"><dl><dt>GET_SERVER_STATUS</dl></div><div id="GET_SESSIONS" class="property"><dl><dt>GET_SESSIONS</dl></div><div id="GET_SESSION_LOGS" class="property"><dl><dt>GET_SESSION_LOGS</dl></div><div id="GET_SESSION_STORAGE_ITEM" class="property"><dl><dt>GET_SESSION_STORAGE_ITEM</dl></div><div id="GET_SESSION_STORAGE_KEYS" class="property"><dl><dt>GET_SESSION_STORAGE_KEYS</dl></div><div id="GET_SESSION_STORAGE_SIZE" class="property"><dl><dt>GET_SESSION_STORAGE_SIZE</dl></div><div id="GET_TITLE" class="property"><dl><dt>GET_TITLE</dl></div><div id="GET_WINDOW_HANDLES" class="property"><dl><dt>GET_WINDOW_HANDLES</dl></div><div id="GET_WINDOW_POSITION" class="property"><dl><dt>GET_WINDOW_POSITION</dl></div><div id="GET_WINDOW_SIZE" class="property"><dl><dt>GET_WINDOW_SIZE</dl></div><div id="GO_BACK" class="property"><dl><dt>GO_BACK</dl></div><div id="GO_FORWARD" class="property"><dl><dt>GO_FORWARD</dl></div><div id="IMPLICITLY_WAIT" class="property"><dl><dt>IMPLICITLY_WAIT</dl></div><div id="IS_BROWSER_ONLINE" class="property"><dl><dt>IS_BROWSER_ONLINE</dl></div><div id="IS_ELEMENT_DISPLAYED" class="property"><dl><dt>IS_ELEMENT_DISPLAYED</dl></div><div id="IS_ELEMENT_ENABLED" class="property"><dl><dt>IS_ELEMENT_ENABLED</dl></div><div id="IS_ELEMENT_SELECTED" class="property"><dl><dt>IS_ELEMENT_SELECTED</dl></div><div id="MAXIMIZE_WINDOW" class="property"><dl><dt>MAXIMIZE_WINDOW</dl></div><div id="MOUSE_DOWN" class="property"><dl><dt>MOUSE_DOWN</dl></div><div id="MOUSE_UP" class="property"><dl><dt>MOUSE_UP</dl></div><div id="MOVE_TO" class="property"><dl><dt>MOVE_TO</dl></div><div id="NEW_SESSION" class="property"><dl><dt>NEW_SESSION</dl></div><div id="QUIT" class="property"><dl><dt>QUIT</dl></div><div id="REFRESH" class="property"><dl><dt>REFRESH</dl></div><div id="REMOVE_LOCAL_STORAGE_ITEM" class="property"><dl><dt>REMOVE_LOCAL_STORAGE_ITEM</dl></div><div id="REMOVE_SESSION_STORAGE_ITEM" class="property"><dl><dt>REMOVE_SESSION_STORAGE_ITEM</dl></div><div id="SCREENSHOT" class="property"><dl><dt>SCREENSHOT</dl></div><div id="SEND_KEYS_TO_ACTIVE_ELEMENT" class="property"><dl><dt>SEND_KEYS_TO_ACTIVE_ELEMENT</dl></div><div id="SEND_KEYS_TO_ELEMENT" class="property"><dl><dt>SEND_KEYS_TO_ELEMENT</dl></div><div id="SET_ALERT_TEXT" class="property"><dl><dt>SET_ALERT_TEXT</dl></div><div id="SET_BROWSER_ONLINE" class="property"><dl><dt>SET_BROWSER_ONLINE</dl></div><div id="SET_LOCAL_STORAGE_ITEM" class="property"><dl><dt>SET_LOCAL_STORAGE_ITEM</dl></div><div id="SET_LOCATION" class="property"><dl><dt>SET_LOCATION</dl></div><div id="SET_SCREEN_ORIENTATION" class="property"><dl><dt>SET_SCREEN_ORIENTATION</dl></div><div id="SET_SCRIPT_TIMEOUT" class="property"><dl><dt>SET_SCRIPT_TIMEOUT</dl></div><div id="SET_SESSION_STORAGE_ITEM" class="property"><dl><dt>SET_SESSION_STORAGE_ITEM</dl></div><div id="SET_TIMEOUT" class="property"><dl><dt>SET_TIMEOUT</dl></div><div id="SET_WINDOW_POSITION" class="property"><dl><dt>SET_WINDOW_POSITION</dl></div><div id="SET_WINDOW_SIZE" class="property"><dl><dt>SET_WINDOW_SIZE</dl></div><div id="SUBMIT_ELEMENT" class="property"><dl><dt>SUBMIT_ELEMENT</dl></div><div id="SWITCH_TO_FRAME" class="property"><dl><dt>SWITCH_TO_FRAME</dl></div><div id="SWITCH_TO_WINDOW" class="property"><dl><dt>SWITCH_TO_WINDOW</dl></div><div id="TOUCH_DOUBLE_TAP" class="property"><dl><dt>TOUCH_DOUBLE_TAP</dl></div><div id="TOUCH_DOWN" class="property"><dl><dt>TOUCH_DOWN</dl></div><div id="TOUCH_FLICK" class="property"><dl><dt>TOUCH_FLICK</dl></div><div id="TOUCH_LONG_PRESS" class="property"><dl><dt>TOUCH_LONG_PRESS</dl></div><div id="TOUCH_MOVE" class="property"><dl><dt>TOUCH_MOVE</dl></div><div id="TOUCH_SCROLL" class="property"><dl><dt>TOUCH_SCROLL</dl></div><div id="TOUCH_SINGLE_TAP" class="property"><dl><dt>TOUCH_SINGLE_TAP</dl></div><div id="TOUCH_UP" class="property"><dl><dt>TOUCH_UP</dl></div><div id="UPLOAD_FILE" class="property"><dl><dt>UPLOAD_FILE</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_enum_Key.html b/docs/module_selenium-webdriver_enum_Key.html
new file mode 100644
index 0000000..18db2b6
--- /dev/null
+++ b/docs/module_selenium-webdriver_enum_Key.html
@@ -0,0 +1,12 @@
+<!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>Key</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l110">View Source</a></div><h1>enum Key</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dt>Alias for <code><a href="enum_webdriver_Key.html">webdriver.Key</a></code></dl><p>Representations of pressable keys that aren&#39;t text.  These are stored in
+the Unicode PUA (Private Use Area) code points, 0xE000-0xF8FF.  Refer to
+http://www.google.com.au/search?&amp;q&#61;unicode&#43;pua&amp;btnG&#61;Search</p>
+<h2>Values and Descriptions</h2><div id="ADD" class="property"><dl><dt>ADD</dl></div><div id="ALT" class="property"><dl><dt>ALT</dl></div><div id="ARROW_DOWN" class="property"><dl><dt>ARROW_DOWN</dl></div><div id="ARROW_LEFT" class="property"><dl><dt>ARROW_LEFT</dl></div><div id="ARROW_RIGHT" class="property"><dl><dt>ARROW_RIGHT</dl></div><div id="ARROW_UP" class="property"><dl><dt>ARROW_UP</dl></div><div id="BACK_SPACE" class="property"><dl><dt>BACK_SPACE</dl></div><div id="CANCEL" class="property"><dl><dt>CANCEL</dl></div><div id="CLEAR" class="property"><dl><dt>CLEAR</dl></div><div id="COMMAND" class="property"><dl><dt>COMMAND</dl></div><div id="CONTROL" class="property"><dl><dt>CONTROL</dl></div><div id="DECIMAL" class="property"><dl><dt>DECIMAL</dl></div><div id="DELETE" class="property"><dl><dt>DELETE</dl></div><div id="DIVIDE" class="property"><dl><dt>DIVIDE</dl></div><div id="DOWN" class="property"><dl><dt>DOWN</dl></div><div id="END" class="property"><dl><dt>END</dl></div><div id="ENTER" class="property"><dl><dt>ENTER</dl></div><div id="EQUALS" class="property"><dl><dt>EQUALS</dl></div><div id="ESCAPE" class="property"><dl><dt>ESCAPE</dl></div><div id="F1" class="property"><dl><dt>F1</dl></div><div id="F10" class="property"><dl><dt>F10</dl></div><div id="F11" class="property"><dl><dt>F11</dl></div><div id="F12" class="property"><dl><dt>F12</dl></div><div id="F2" class="property"><dl><dt>F2</dl></div><div id="F3" class="property"><dl><dt>F3</dl></div><div id="F4" class="property"><dl><dt>F4</dl></div><div id="F5" class="property"><dl><dt>F5</dl></div><div id="F6" class="property"><dl><dt>F6</dl></div><div id="F7" class="property"><dl><dt>F7</dl></div><div id="F8" class="property"><dl><dt>F8</dl></div><div id="F9" class="property"><dl><dt>F9</dl></div><div id="HELP" class="property"><dl><dt>HELP</dl></div><div id="HOME" class="property"><dl><dt>HOME</dl></div><div id="INSERT" class="property"><dl><dt>INSERT</dl></div><div id="LEFT" class="property"><dl><dt>LEFT</dl></div><div id="META" class="property"><dl><dt>META</dl></div><div id="MULTIPLY" class="property"><dl><dt>MULTIPLY</dl></div><div id="NULL" class="property"><dl><dt>NULL</dl></div><div id="NUMPAD0" class="property"><dl><dt>NUMPAD0</dl></div><div id="NUMPAD1" class="property"><dl><dt>NUMPAD1</dl></div><div id="NUMPAD2" class="property"><dl><dt>NUMPAD2</dl></div><div id="NUMPAD3" class="property"><dl><dt>NUMPAD3</dl></div><div id="NUMPAD4" class="property"><dl><dt>NUMPAD4</dl></div><div id="NUMPAD5" class="property"><dl><dt>NUMPAD5</dl></div><div id="NUMPAD6" class="property"><dl><dt>NUMPAD6</dl></div><div id="NUMPAD7" class="property"><dl><dt>NUMPAD7</dl></div><div id="NUMPAD8" class="property"><dl><dt>NUMPAD8</dl></div><div id="NUMPAD9" class="property"><dl><dt>NUMPAD9</dl></div><div id="PAGE_DOWN" class="property"><dl><dt>PAGE_DOWN</dl></div><div id="PAGE_UP" class="property"><dl><dt>PAGE_UP</dl></div><div id="PAUSE" class="property"><dl><dt>PAUSE</dl></div><div id="RETURN" class="property"><dl><dt>RETURN</dl></div><div id="RIGHT" class="property"><dl><dt>RIGHT</dl></div><div id="SEMICOLON" class="property"><dl><dt>SEMICOLON</dl></div><div id="SEPARATOR" class="property"><dl><dt>SEPARATOR</dl></div><div id="SHIFT" class="property"><dl><dt>SHIFT</dl></div><div id="SPACE" class="property"><dl><dt>SPACE</dl></div><div id="SUBTRACT" class="property"><dl><dt>SUBTRACT</dl></div><div id="TAB" class="property"><dl><dt>TAB</dl></div><div id="UP" class="property"><dl><dt>UP</dl></div><h2>Functions</h2><div id="Key.chord" class="function"><div><h3>Key.chord(<wbr>var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1658">code »</a></span></h3><p>Simulate pressing many keys at once in a &#34;chord&#34;. Takes a sequence of
+<a href="enum_webdriver_Key.html"><code>webdriver.Key</code></a>s or strings, appends each of the values to a string,
+and adds the chord termination key (<a href="enum_webdriver_Key.html#NULL"><code>webdriver.Key.NULL</code></a>) and returns
+the resultant string.</p>
+<p>Note: when the low-level webdriver key handlers see Keys.NULL, active
+modifier keys (CTRL/ALT/SHIFT/etc) release via a keyup event.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The key sequence to concatenate.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The null-terminated key sequence.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_error.html b/docs/module_selenium-webdriver_error.html
index dc4ba90..a8c05a9 100644
--- a/docs/module_selenium-webdriver_error.html
+++ b/docs/module_selenium-webdriver_error.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/error</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/error</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/error.js.src.html">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_bot_Error.html">Error</a><dd>Error extension that includes error status codes from the WebDriver wire
- protocol:
- http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes</dl></table></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_bot_ErrorCode.html">ErrorCode</a><dd>Error codes from the WebDriver wire protocol:
- http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/error</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><div class="codelink"><a href="source/error.js.src.html#l18">View Source</a></div><h1>module selenium-webdriver/error</h1><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_error_class_Error.html">Error</a><dd><p>Represents an error returned from a WebDriver command request.</p>
+<dt><a href="module_selenium-webdriver_error_enum_ErrorCode.html">ErrorCode</a><dd><p>Error codes from the Selenium WebDriver protocol:
+https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#response-status-codes</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_error_class_Error.html b/docs/module_selenium-webdriver_error_class_Error.html
new file mode 100644
index 0000000..d8f3d1c
--- /dev/null
+++ b/docs/module_selenium-webdriver_error_class_Error.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>Error</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_error.html">selenium-webdriver/error</a></div><div class="codelink"><a href="source/error.js.src.html#l24">View Source</a></div><h1>class Error</h1><pre class="inheritance"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>
+  &#x2514; Error</pre><dl><dt>Alias for <code><a href="class_bot_Error.html">bot.Error</a></code></dl><p>Represents an error returned from a WebDriver command request.</p>
+<h3>new Error(<wbr>code, opt_message)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>code<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The error&#39;s status code.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Optional error message.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/atoms/error.js.src.html#l199">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string representation of this error.</p>
+</dl></div></div></div></div><h2>Instance Properties</h2><div id="code" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l82">code</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>This error&#39;s status code.</p>
+</dl></div><div id="description" class="property"><dl><dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>IE-only.</p>
+</dl></div><div id="fileName" class="property"><dl><dt>fileName<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Mozilla-only</p>
+</dl></div><div id="isAutomationError" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l194">isAutomationError</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Flag used for duck-typing when this code is embedded in a Firefox extension.
+This is required since an Error thrown in one component and then reported
+to another will fail instanceof checks in the second component.</p>
+</dl></div><div id="lineNumber" class="property"><dl><dt>lineNumber<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>Mozilla-only.</p>
+</dl></div><div id="message" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l89">message</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="name" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l104">name</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="sourceURL" class="property"><dl><dt>sourceURL<code>?</code><dd><p>Doesn&#39;t seem to exist, but closure/debug.js references it.</p>
+</dl></div><div id="stack" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l112">stack</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><div id="state" class="property"><dl><dt><a href="source/lib/atoms/error.js.src.html#l85">state</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>No description.</dl></div><h2>Types</h2><dl><dt><a href="enum_bot_Error_State.html">Error.State</a><dd><p>Status strings enumerated in the W3C WebDriver protocol.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_error_enum_ErrorCode.html b/docs/module_selenium-webdriver_error_enum_ErrorCode.html
new file mode 100644
index 0000000..55e62ec
--- /dev/null
+++ b/docs/module_selenium-webdriver_error_enum_ErrorCode.html
@@ -0,0 +1,3 @@
+<!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>ErrorCode</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_error.html">selenium-webdriver/error</a></div><div class="codelink"><a href="source/error.js.src.html#l27">View Source</a></div><h1>enum ErrorCode</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dt>Alias for <code><a href="enum_bot_ErrorCode.html">bot.ErrorCode</a></code></dl><p>Error codes from the Selenium WebDriver protocol:
+https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#response-status-codes</p>
+<h2>Values and Descriptions</h2><div id="ELEMENT_NOT_SELECTABLE" class="property"><dl><dt>ELEMENT_NOT_SELECTABLE</dl></div><div id="ELEMENT_NOT_VISIBLE" class="property"><dl><dt>ELEMENT_NOT_VISIBLE</dl></div><div id="IME_ENGINE_ACTIVATION_FAILED" class="property"><dl><dt>IME_ENGINE_ACTIVATION_FAILED</dl></div><div id="IME_NOT_AVAILABLE" class="property"><dl><dt>IME_NOT_AVAILABLE</dl></div><div id="INVALID_COOKIE_DOMAIN" class="property"><dl><dt>INVALID_COOKIE_DOMAIN</dl></div><div id="INVALID_ELEMENT_COORDINATES" class="property"><dl><dt>INVALID_ELEMENT_COORDINATES</dl></div><div id="INVALID_ELEMENT_STATE" class="property"><dl><dt>INVALID_ELEMENT_STATE</dl></div><div id="INVALID_SELECTOR_ERROR" class="property"><dl><dt>INVALID_SELECTOR_ERROR</dl></div><div id="INVALID_XPATH_SELECTOR" class="property"><dl><dt>INVALID_XPATH_SELECTOR</dl></div><div id="INVALID_XPATH_SELECTOR_RETURN_TYPE" class="property"><dl><dt>INVALID_XPATH_SELECTOR_RETURN_TYPE</dl></div><div id="JAVASCRIPT_ERROR" class="property"><dl><dt>JAVASCRIPT_ERROR</dl></div><div id="METHOD_NOT_ALLOWED" class="property"><dl><dt>METHOD_NOT_ALLOWED</dl></div><div id="MOVE_TARGET_OUT_OF_BOUNDS" class="property"><dl><dt>MOVE_TARGET_OUT_OF_BOUNDS</dl></div><div id="NO_SUCH_ALERT" class="property"><dl><dt>NO_SUCH_ALERT</dl></div><div id="NO_SUCH_ELEMENT" class="property"><dl><dt>NO_SUCH_ELEMENT</dl></div><div id="NO_SUCH_FRAME" class="property"><dl><dt>NO_SUCH_FRAME</dl></div><div id="NO_SUCH_WINDOW" class="property"><dl><dt>NO_SUCH_WINDOW</dl></div><div id="SCRIPT_TIMEOUT" class="property"><dl><dt>SCRIPT_TIMEOUT</dl></div><div id="SESSION_NOT_CREATED" class="property"><dl><dt>SESSION_NOT_CREATED</dl></div><div id="SQL_DATABASE_ERROR" class="property"><dl><dt>SQL_DATABASE_ERROR</dl></div><div id="STALE_ELEMENT_REFERENCE" class="property"><dl><dt>STALE_ELEMENT_REFERENCE</dl></div><div id="SUCCESS" class="property"><dl><dt>SUCCESS</dl></div><div id="TIMEOUT" class="property"><dl><dt>TIMEOUT</dl></div><div id="UNABLE_TO_SET_COOKIE" class="property"><dl><dt>UNABLE_TO_SET_COOKIE</dl></div><div id="UNEXPECTED_ALERT_OPEN" class="property"><dl><dt>UNEXPECTED_ALERT_OPEN</dl></div><div id="UNKNOWN_COMMAND" class="property"><dl><dt>UNKNOWN_COMMAND</dl></div><div id="UNKNOWN_ERROR" class="property"><dl><dt>UNKNOWN_ERROR</dl></div><div id="UNSUPPORTED_OPERATION" class="property"><dl><dt>UNSUPPORTED_OPERATION</dl></div><div id="XPATH_LOOKUP_ERROR" class="property"><dl><dt>XPATH_LOOKUP_ERROR</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_executors.html b/docs/module_selenium-webdriver_executors.html
index 4cd5307..0f39862 100644
--- a/docs/module_selenium-webdriver_executors.html
+++ b/docs/module_selenium-webdriver_executors.html
@@ -1,3 +1,10 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/executors</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/executors</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/executors.js.src.html">code &raquo;</a></header><section><p>Various utilities for working with
- <code  class="type"><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code> implementations.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/executors.js.src.html#l54">code &raquo;</a><span class="member"><a name="createExecutor">createExecutor</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></span></div><p>Creates a command executor that uses WebDriver's JSON wire protocol.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd>The server's URL,
-     or a promise that will resolve to that URL.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/executors</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><div class="codelink"><a href="source/executors.js.src.html#l23">View Source</a></div><h1>module selenium-webdriver/executors</h1><p>Various utilities for working with
+<a href="interface_webdriver_CommandExecutor.html"><code>webdriver.CommandExecutor</code></a> implementations.</p>
+<h2>Functions</h2><div id="createExecutor" class="function"><div><h3>createExecutor(<wbr>url, opt_proxy)<span class="codelink"><a href="source/executors.js.src.html#l61">code »</a></span></h3><p>Creates a command executor that uses WebDriver&#39;s JSON wire protocol.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The server&#39;s URL,
+or a promise that will resolve to that URL.</p>
+<dt>opt_proxy<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>(optional) The URL of the HTTP proxy for the
+client to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></dl></div></div></div></div><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_executors_class_DeferredExecutor.html">DeferredExecutor</a><dd><p>Wraps a promised <a href="interface_webdriver_CommandExecutor.html"><code>webdriver.CommandExecutor</code></a>, ensuring no commands
+are executed until the wrapped executor has been fully built.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html b/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html
new file mode 100644
index 0000000..26ff73b
--- /dev/null
+++ b/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html
@@ -0,0 +1,12 @@
+<!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>DeferredExecutor</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_executors.html">selenium-webdriver/executors</a></div><div class="codelink"><a href="source/executors.js.src.html#l51">View Source</a></div><h1>class DeferredExecutor</h1><dl><dt>All implemented interfaces<dd><code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></dl><p>Wraps a promised <a href="interface_webdriver_CommandExecutor.html"><code>webdriver.CommandExecutor</code></a>, ensuring no commands
+are executed until the wrapped executor has been fully built.</p>
+<h3>new DeferredExecutor(<wbr>delegate)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>delegate<code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a>&gt;</code><dd><p>The
+promised delegate.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="execute" class="function"><div><h3>execute(<wbr>command, callback)<span class="codelink"><a href="source/executors.js.src.html#l40">code »</a></span></h3><p>Executes the given <code>command</code>. If there is an error executing the
+command, the provided callback will be invoked with the offending error.
+Otherwise, the callback will be invoked with a null Error and non-null
+<a href="namespace_bot_response.html#response.ResponseObject"><code>bot.response.ResponseObject</code></a> object.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_CommandExecutor.html#execute">webdriver.CommandExecutor</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to execute.</p>
+<dt>callback<code>function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>, {status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}=): ?</code><dd><p>the function
+to invoke when the command response is ready.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox.html b/docs/module_selenium-webdriver_firefox.html
new file mode 100644
index 0000000..cd6a2a2
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox.html
@@ -0,0 +1,68 @@
+<!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>selenium-webdriver/firefox</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><div class="codelink"><a href="source/firefox/index.js.src.html#l95">View Source</a></div><h1>module selenium-webdriver/firefox</h1><p>Defines the <a href="module_selenium-webdriver_firefox_class_Driver.html">WebDriver</a> client for Firefox.
+Each FirefoxDriver instance will be created with an anonymous profile,
+ensuring browser historys do not share session data (cookies, history, cache,
+offline storage, etc.)</p>
+<p><strong>Customizing the Firefox Profile</strong></p>
+<p>The <a href="module_selenium-webdriver_firefox_class_Profile.html"><code>Profile</code></a> class may be used to configure the browser profile used
+with WebDriver, with functions to install additional
+<a href="module_selenium-webdriver_firefox_class_Profile.html#addExtension">extensions</a>, configure browser
+<a href="module_selenium-webdriver_firefox_class_Profile.html#setPreference">preferences</a>, and more. For example, you
+may wish to include Firebug:</p>
+<pre><code>var firefox &#61; require(&#39;selenium-webdriver/firefox&#39;);
+
+var profile &#61; new firefox.Profile();
+profile.addExtension(&#39;/path/to/firebug.xpi&#39;);
+profile.setPreference(&#39;extensions.firebug.showChromeErrors&#39;, true);
+
+var options &#61; new firefox.Options().setProfile(profile);
+var driver &#61; new firefox.Driver(options);
+</code></pre>
+<p>The <a href="module_selenium-webdriver_firefox_class_Profile.html"><code>Profile</code></a> class may also be used to configure WebDriver based on a
+pre-existing browser profile:</p>
+<pre><code>var profile &#61; new firefox.Profile(
+    &#39;/usr/local/home/bob/.mozilla/firefox/3fgog75h.testing&#39;);
+var options &#61; new firefox.Options().setProfile(profile);
+var driver &#61; new firefox.Driver(options);
+</code></pre>
+<p>The FirefoxDriver will <em>never</em> modify a pre-existing profile; instead it will
+create a copy for it to modify. By extension, there are certain browser
+preferences that are required for WebDriver to function properly and they
+will always be overwritten.</p>
+<p><strong>Using a Custom Firefox Binary</strong></p>
+<p>On Windows and OSX, the FirefoxDriver will search for Firefox in its
+default installation location:</p>
+<ul><li>Windows: C:\Program Files and C:\Program Files (x86).</li><li>Mac OS X: /Applications/Firefox.app</li></ul>
+<p>For Linux, Firefox will be located on the PATH: <code>$(where firefox)</code>.</p>
+<p>You can configure WebDriver to start use a custom Firefox installation with
+the <a href="module_selenium-webdriver_firefox_class_Binary.html"><code>Binary</code></a> class:</p>
+<pre><code>var firefox &#61; require(&#39;selenium-webdriver/firefox&#39;);
+var binary &#61; new firefox.Binary(&#39;/my/firefox/install/dir/firefox-bin&#39;);
+var options &#61; new firefox.Options().setBinary(binary);
+var driver &#61; new firefox.Driver(options);
+</code></pre>
+<p><strong>Remote Testing</strong></p>
+<p>You may customize the Firefox binary and profile when running against a
+remote Selenium server. Your custom profile will be packaged as a zip and
+transfered to the remote host for use. The profile will be transferred
+<em>once for each new session</em>. The performance impact should be minimal if
+you&#39;ve only configured a few extra browser preferences. If you have a large
+profile with several extensions, you should consider installing it on the
+remote host and defining its path via the <a href="module_selenium-webdriver_firefox_class_Options.html"><code>Options</code></a> class. Custom
+binaries are never copied to remote machines and must be referenced by
+installation path.</p>
+<pre><code>var options &#61; new firefox.Options()
+    .setProfile(&#39;/profile/path/on/remote/host&#39;)
+    .setBinary(&#39;/install/dir/on/remote/host/firefox-bin&#39;);
+
+var driver &#61; new (require(&#39;selenium-webdriver&#39;)).Builder()
+    .forBrowser(&#39;firefox&#39;)
+    .usingServer(&#39;http://127.0.0.1:4444/wd/hub&#39;)
+    .setFirefoxOptions(options)
+    .build();
+</code></pre>
+<h2>Types</h2><dl><dt><a href="module_selenium-webdriver_firefox_class_Binary.html">Binary</a><dd><p>Provides a mechanism to configure and launch Firefox in a subprocess for
+use with WebDriver.</p>
+<dt><a href="module_selenium-webdriver_firefox_class_Driver.html">Driver</a><dd><p>A WebDriver client for Firefox.</p>
+<dt><a href="module_selenium-webdriver_firefox_class_Options.html">Options</a><dd><p>Configuration options for the FirefoxDriver.</p>
+<dt><a href="module_selenium-webdriver_firefox_class_Profile.html">Profile</a><dd><p>Models a Firefox proifle directory for use with the FirefoxDriver.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_binary.html b/docs/module_selenium-webdriver_firefox_binary.html
new file mode 100644
index 0000000..337332e
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_binary.html
@@ -0,0 +1,5 @@
+<!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>selenium-webdriver/firefox/binary</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><div class="codelink"><a href="source/firefox/binary.js.src.html#l23">View Source</a></div><h1>module selenium-webdriver/firefox/binary</h1><p>Manages Firefox binaries. This module is considered internal;
+users should use <a href="module_selenium-webdriver_firefox.html"><code>selenium-webdriver/firefox</code></a>.</p>
+<h2>Types</h2><dl><dt><a href="module_selenium-webdriver_firefox_binary_class_Binary.html">Binary</a><dd><p>Provides a mechanism to configure and launch Firefox in a subprocess for
+use with WebDriver.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_binary_class_Binary.html b/docs/module_selenium-webdriver_firefox_binary_class_Binary.html
new file mode 100644
index 0000000..0e4bf59
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_binary_class_Binary.html
@@ -0,0 +1,20 @@
+<!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>Binary</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_firefox_binary.html">selenium-webdriver/firefox/binary</a></div><div class="codelink"><a href="source/firefox/binary.js.src.html#l228">View Source</a></div><h1>class Binary</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>
+  &#x2514; Binary</pre><p>Provides a mechanism to configure and launch Firefox in a subprocess for
+use with WebDriver.</p>
+<h3>new Binary(<wbr>opt_exe)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_exe<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Path to the Firefox binary to use. If not
+specified, will attempt to locate Firefox on the current system.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="addArguments" class="function"><div><h3>addArguments(<wbr>var_args)<span class="codelink"><a href="source/firefox/binary.js.src.html#l170">code »</a></span></h3><p>Add arguments to the command line used to start Firefox.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>Either the arguments to add as
+varargs, or the arguments as an array.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="launch" class="function"><div><h3>launch(<wbr>profile)<span class="codelink"><a href="source/firefox/binary.js.src.html#l188">code »</a></span></h3><p>Launches Firefox and returns a promise that will be fulfilled when the
+process terminates.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>profile<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the profile directory to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the handle to the
+started subprocess.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/firefox/binary.js.src.html#l220">code »</a></span></h3><p>Returns a promise for the wire representation of this binary. Note: the
+FirefoxDriver only supports passing the path to the binary executable over
+the wire; all command line arguments and environment variables will be
+discarded.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for this binary&#39;s wire
+representation.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_class_Binary.html b/docs/module_selenium-webdriver_firefox_class_Binary.html
new file mode 100644
index 0000000..0d32712
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_class_Binary.html
@@ -0,0 +1,20 @@
+<!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>Binary</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_firefox.html">selenium-webdriver/firefox</a></div><div class="codelink"><a href="source/firefox/index.js.src.html#l317">View Source</a></div><h1>class Binary</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>
+  &#x2514; Binary</pre><dl><dt>Alias for <code><a href="module_selenium-webdriver_firefox_binary_class_Binary.html">module(selenium-webdriver/firefox/binary).Binary</a></code></dl><p>Provides a mechanism to configure and launch Firefox in a subprocess for
+use with WebDriver.</p>
+<h3>new Binary(<wbr>opt_exe)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_exe<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Path to the Firefox binary to use. If not
+specified, will attempt to locate Firefox on the current system.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="addArguments" class="function"><div><h3>addArguments(<wbr>var_args)<span class="codelink"><a href="source/firefox/binary.js.src.html#l170">code »</a></span></h3><p>Add arguments to the command line used to start Firefox.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>Either the arguments to add as
+varargs, or the arguments as an array.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="launch" class="function"><div><h3>launch(<wbr>profile)<span class="codelink"><a href="source/firefox/binary.js.src.html#l188">code »</a></span></h3><p>Launches Firefox and returns a promise that will be fulfilled when the
+process terminates.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>profile<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the profile directory to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the handle to the
+started subprocess.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/firefox/binary.js.src.html#l220">code »</a></span></h3><p>Returns a promise for the wire representation of this binary. Note: the
+FirefoxDriver only supports passing the path to the binary executable over
+the wire; all command line arguments and environment variables will be
+discarded.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for this binary&#39;s wire
+representation.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_class_Driver.html b/docs/module_selenium-webdriver_firefox_class_Driver.html
new file mode 100644
index 0000000..0c734e6
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_class_Driver.html
@@ -0,0 +1,276 @@
+<!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>Driver</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_firefox.html">selenium-webdriver/firefox</a></div><div class="codelink"><a href="source/firefox/index.js.src.html#l318">View Source</a></div><h1>class Driver</h1><pre class="inheritance"><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>
+  &#x2514; Driver</pre><p>A WebDriver client for Firefox.</p>
+<h3>new Driver(<wbr>opt_config, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_config<code>?(<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)=</code><dd><p>The
+configuration options for this driver, specified as either an
+<code>Options</code> or <a href="class_webdriver_Capabilities.html"><code>webdriver.Capabilities</code></a>, or as a raw hash
+object.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The flow to
+schedule commands through. Defaults to the active flow object.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="actions" class="function"><div><h3>actions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l469">code »</a></span></h3><p>Creates a new action sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_ActionSequence.html#perform"><code>webdriver.ActionSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.actions().
+    mouseDown(element1).
+    mouseMove(element2).
+    mouseUp().
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#actions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A new action sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="call" class="function"><div><h3><code>&lt;T&gt;</code> call(<wbr>fn, opt_scope, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l639">code »</a></span></h3><p>Schedules a command to execute a custom function.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#call">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(...?): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+execute.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to execute the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved&#39;
+with the function&#39;s result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="close" class="function"><div><h3>close()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l780">code »</a></span></h3><p>Schedules a command to close the current window.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#close">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l324">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#controlFlow">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow used by this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeAsyncScript" class="function"><div><h3><code>&lt;T&gt;</code> executeAsyncScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l617">code »</a></span></h3><p>Schedules a command to execute asynchronous JavaScript in the context of the
+currently selected frame or window. The script fragment will be executed as
+the body of an anonymous function. If the script is provided as a function
+object, that function will be converted to a string for injection into the
+target window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>Unlike executing synchronous JavaScript with <a href="module_selenium-webdriver_firefox_class_Driver.html#executeScript"><code>#executeScript</code></a>,
+scripts executed with this function must explicitly signal they are finished
+by invoking the provided callback. This callback will always be injected
+into the executed function as the last argument, and thus may be referenced
+with <code>arguments[arguments.length - 1]</code>. The following steps will be
+taken for resolving this functions return value against the first argument
+to the script&#39;s callback function:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><strong>Example #1:</strong> Performing a sleep that is synchronized with the currently
+selected window:</p>
+<pre><code>var start &#61; new Date().getTime();
+driver.executeAsyncScript(
+    &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).
+    then(function() {
+      console.log(
+          &#39;Elapsed time: &#39; &#43; (new Date().getTime() - start) &#43; &#39; ms&#39;);
+    });
+</code></pre>
+<p><strong>Example #2:</strong> Synchronizing a test with an AJAX application:</p>
+<pre><code>var button &#61; driver.findElement(By.id(&#39;compose-button&#39;));
+button.click();
+driver.executeAsyncScript(
+    &#39;var callback &#61; arguments[arguments.length - 1];&#39; &#43;
+    &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);
+driver.switchTo().frame(&#39;composeWidget&#39;);
+driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog&#64;example.com&#39;);
+</code></pre>
+<p><strong>Example #3:</strong> Injecting a XMLHttpRequest and waiting for the result. In
+this example, the inject script is specified with a function literal. When
+using this format, the function is converted to a string for injection, so it
+should not reference any symbols not defined in the scope of the page under
+test.</p>
+<pre><code>driver.executeAsyncScript(function() {
+  var callback &#61; arguments[arguments.length - 1];
+  var xhr &#61; new XMLHttpRequest();
+  xhr.open(&#34;GET&#34;, &#34;/resource/data.json&#34;, true);
+  xhr.onreadystatechange &#61; function() {
+    if (xhr.readyState &#61;&#61; 4) {
+      callback(xhr.responseText);
+    }
+  }
+  xhr.send(&#39;&#39;);
+}).then(function(str) {
+  console.log(JSON.parse(str)[&#39;food&#39;]);
+});
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeAsyncScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeScript" class="function"><div><h3><code>&lt;T&gt;</code> executeScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l528">code »</a></span></h3><p>Schedules a command to execute JavaScript in the context of the currently
+selected frame or window. The script fragment will be executed as the body
+of an anonymous function. If the script is provided as a function object,
+that function will be converted to a string for injection into the target
+window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>The script may refer to any variables accessible from the current window.
+Furthermore, the script will execute in the window&#39;s context, thus
+<code>document</code> may be used to refer to the current document. Any local
+variables will not be available once the script has finished executing,
+though global variables will persist.</p>
+<p>If the script has a return value (i.e. if the script contains a return
+statement), then the following steps will be taken for resolving this
+functions return value:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l867">code »</a></span></h3><p>Schedule a command to find an element on the page. If the element cannot be
+found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will be returned
+by the driver. Unlike other commands, this error cannot be suppressed. In
+other words, scheduling a command to find an element doubles as an assert
+that the element is present on the page. To test whether an element is
+present on the page, use <a href="module_selenium-webdriver_firefox_class_Driver.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; driver.findElement(firstVisibleLink);
+
+function firstVisibleLink(driver) {
+  var links &#61; driver.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p>When running in the browser, a WebDriver cannot manipulate DOM elements
+directly; it may do so only through a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> reference.
+This function may be used to generate a WebElement from a DOM element. A
+reference to the DOM element will be stored in a known location and this
+driver will attempt to retrieve it through <a href="module_selenium-webdriver_firefox_class_Driver.html#executeScript"><code>#executeScript</code></a>. If the
+element cannot be found (eg, it belongs to a different document than the
+one this instance is currently focused on), a
+<a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error will be returned.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElement">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l994">code »</a></span></h3><p>Schedule a command to search for multiple elements on the page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElements">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l792">code »</a></span></h3><p>Schedules a command to navigate to the given URL.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#get">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The fully qualified URL to open.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the document has finished loading.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAllWindowHandles" class="function"><div><h3>getAllWindowHandles()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l753">code »</a></span></h3><p>Schedules a command to retrieve the current list of available window handles.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getAllWindowHandles">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;&gt;</code><dd><p>A promise that will
+be resolved with an array of window handles.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l430">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCapabilities">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>&gt;</code><dd><p>A promise
+that will resolve with the this instance&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCurrentUrl" class="function"><div><h3>getCurrentUrl()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l802">code »</a></span></h3><p>Schedules a command to retrieve the URL of the current page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCurrentUrl">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current URL.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPageSource" class="function"><div><h3>getPageSource()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l768">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s source. The page source
+returned is a representation of the underlying DOM: do not expect it to be
+formatted or escaped in the same way as the response sent from the web
+server.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getPageSource">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page source.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSession" class="function"><div><h3>getSession()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l421">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getSession">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Session.html">webdriver.Session</a>&gt;</code><dd><p>A promise for this
+client&#39;s session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTitle" class="function"><div><h3>getTitle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l814">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s title.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getTitle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page&#39;s title.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWindowHandle" class="function"><div><h3>getWindowHandle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l741">code »</a></span></h3><p>Schedules a command to retrieve they current window handle.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getWindowHandle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current window handle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locatorOrElement)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l974">code »</a></span></h3><p>Schedules a command to test if an element is present on the page.</p>
+<p>If given a DOM element, this function will check if it belongs to the
+document the driver is currently focused on. Otherwise, the function will
+test if at least one element can be found with the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#isElementPresent">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locatorOrElement<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator to use, or the actual
+DOM element to be located by the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the element is present on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manage" class="function"><div><h3>manage()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1056">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#manage">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code><dd><p>The options interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="navigate" class="function"><div><h3>navigate()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1065">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#navigate">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code><dd><p>The navigation interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="quit" class="function"><div><h3>quit()<span class="codelink"><a href="source/firefox/index.js.src.html#l295">code »</a></span></h3><p>Schedules a command to quit the current session. After calling quit, this
+instance will be invalidated and may no longer be used to issue commands
+against the browser.</p>
+<p><b>Overrides: </b><a href="class_webdriver_WebDriver.html#quit">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="schedule" class="function"><div><h3><code>&lt;T&gt;</code> schedule(<wbr>command, description)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l338">code »</a></span></h3><p>Schedules a <code>webdriver.Command</code> to be executed by this driver&#39;s
+<code>webdriver.CommandExecutor</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#schedule">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to schedule.</p>
+<dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of the command for debugging.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the command result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFileDetector" class="function"><div><h3>setFileDetector(<wbr>detector)<span class="codelink"><a href="source/firefox/index.js.src.html#l290">code »</a></span></h3><p>This function is a no-op as file detectors are not supported by this
+implementation.</p>
+<p><b>Overrides: </b><a href="class_webdriver_WebDriver.html#setFileDetector">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detector<code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code><dd><p>The detector to use or <code>null</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sleep" class="function"><div><h3>sleep(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l731">code »</a></span></h3><p>Schedules a command to make the driver sleep for the given amount of time.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#sleep">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to sleep.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the sleep has finished.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="switchTo" class="function"><div><h3>switchTo()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1074">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#switchTo">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code><dd><p>The target locator interface for
+this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="takeScreenshot" class="function"><div><h3>takeScreenshot()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1046">code »</a></span></h3><p>Schedule a command to take a screenshot. The driver makes a best effort to
+return a screenshot of the following, in order of preference:</p>
+<ol><li>Entire page
+  </li><li>Current window
+  </li><li>Visible portion of the current frame
+  </li><li>The screenshot of the entire display containing the browser
+</li></ol>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#takeScreenshot">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the screenshot as a base-64 encoded PNG.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="touchActions" class="function"><div><h3>touchActions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l486">code »</a></span></h3><p>Creates a new touch sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_TouchSequence.html#perform"><code>webdriver.TouchSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.touchActions().
+    tap(element1).
+    doubleTap(element2).
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#touchActions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A new touch sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l700">code »</a></span></h3><p>Schedules a command to wait for a condition to hold. The condition may be
+specified by a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a>, as a custom function, or
+as a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>.</p>
+<p>For a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a> or function, the wait will repeatedly
+evaluate the condition until it returns a truthy value. If any errors occur
+while evaluating the condition, they will be allowed to propagate. In the
+event a condition returns a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>, the
+polling loop will wait for it to be resolved and use the resolved value for
+whether the condition has been satisified. Note the resolution time for
+a promise is factored into whether a wait has timed out.</p>
+<p><em>Example:</em> waiting up to 10 seconds for an element to be present and visible
+on the page.</p>
+<pre><code>var button &#61; driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);
+button.click();
+</code></pre>
+<p>This function may also be used to block the command flow on the resolution
+of a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>. When given a promise, the
+command will simply wait for its resolution before completing. A timeout may
+be provided to fail the command if the promise does not resolve before the
+timeout expires.</p>
+<p><em>Example:</em> Suppose you have a function, <code>startTestServer</code>, that returns a
+promise for when a server is ready for requests. You can block a <code>WebDriver</code>
+client on this promise with:</p>
+<pre><code>var started &#61; startTestServer();
+driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);
+driver.get(getServerUrl());
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#wait">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|<a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;T&gt;|function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): T)</code><dd><p>The condition to
+wait on, defined as a promise, condition object, or  a function to
+evaluate as a condition.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait for the condition to be true.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional message to use if the wait times
+out.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+with the first truthy value returned by the condition function, or
+rejected if the condition times out.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_class_Options.html b/docs/module_selenium-webdriver_firefox_class_Options.html
new file mode 100644
index 0000000..dd102dc
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_class_Options.html
@@ -0,0 +1,19 @@
+<!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>Options</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_firefox.html">selenium-webdriver/firefox</a></div><div class="codelink"><a href="source/firefox/index.js.src.html#l319">View Source</a></div><h1>class Options</h1><p>Configuration options for the FirefoxDriver.</p>
+<h3>new Options()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="setBinary" class="function"><div><h3>setBinary(<wbr>binary)<span class="codelink"><a href="source/firefox/index.js.src.html#l154">code »</a></span></h3><p>Sets the binary to use. The binary may be specified as the path to a Firefox
+executable, or as a <a href="module_selenium-webdriver_firefox_class_Binary.html"><code>Binary</code></a> object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>binary<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="module_selenium-webdriver_firefox_binary_class_Binary.html">Binary</a>)</code><dd><p>The binary to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_firefox_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPreferences" class="function"><div><h3>setLoggingPreferences(<wbr>prefs)<span class="codelink"><a href="source/firefox/index.js.src.html#l168">code »</a></span></h3><p>Sets the logging preferences for the new session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code><a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a></code><dd><p>The logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_firefox_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProfile" class="function"><div><h3>setProfile(<wbr>profile)<span class="codelink"><a href="source/firefox/index.js.src.html#l138">code »</a></span></h3><p>Sets the profile to use. The profile may be specified as a
+<a href="module_selenium-webdriver_firefox_class_Profile.html"><code>Profile</code></a> object or as the path to an existing Firefox profile to use
+as a template.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>profile<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="module_selenium-webdriver_firefox_profile_class_Profile.html">Profile</a>)</code><dd><p>The profile to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_firefox_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>proxy)<span class="codelink"><a href="source/firefox/index.js.src.html#l180">code »</a></span></h3><p>Sets the proxy to use.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code><a href="module_selenium-webdriver.html">selenium-webdriver.ProxyConfig</a></code><dd><p>The proxy configuration to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_firefox_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toCapabilities" class="function"><div><h3>toCapabilities(<wbr>opt_remote)<span class="codelink"><a href="source/firefox/index.js.src.html#l191">code »</a></span></h3><p>Converts these options to a <a href="class_webdriver_Capabilities.html"><code>webdriver.Capabilities</code></a> instance.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_remote<code>?</code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>A new capabilities object.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_class_Profile.html b/docs/module_selenium-webdriver_firefox_class_Profile.html
new file mode 100644
index 0000000..d672120
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_class_Profile.html
@@ -0,0 +1,50 @@
+<!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>Profile</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_firefox.html">selenium-webdriver/firefox</a></div><div class="codelink"><a href="source/firefox/index.js.src.html#l320">View Source</a></div><h1>class Profile</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>
+  &#x2514; Profile</pre><dl><dt>Alias for <code><a href="module_selenium-webdriver_firefox_profile_class_Profile.html">module(selenium-webdriver/firefox/profile).Profile</a></code></dl><p>Models a Firefox proifle directory for use with the FirefoxDriver. The
+<code>Proifle</code> directory uses an in-memory model until <a href="module_selenium-webdriver_firefox_profile_class_Profile.html#writeToDisk"><code>#writeToDisk</code></a>
+is called.</p>
+<h3>new Profile(<wbr>opt_dir)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_dir<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Path to an existing Firefox profile directory to
+use a template for this profile. If not specified, a blank profile will
+be used.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="acceptUntrustedCerts" class="function"><div><h3>acceptUntrustedCerts()<span class="codelink"><a href="source/firefox/profile.js.src.html#l315">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the FirefoxDriver is configured to automatically
+accept untrusted SSL certificates.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="addExtension" class="function"><div><h3>addExtension(<wbr>extension)<span class="codelink"><a href="source/firefox/profile.js.src.html#l257">code »</a></span></h3><p>Registers an extension to be included with this profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>extension<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the extension to include, as either an
+unpacked extension directory or the path to a xpi file.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="assumeUntrustedCertIssuer" class="function"><div><h3>assumeUntrustedCertIssuer()<span class="codelink"><a href="source/firefox/profile.js.src.html#l343">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to assume untrusted certs come from untrusted
+issuers.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="encode" class="function"><div><h3>encode()<span class="codelink"><a href="source/firefox/profile.js.src.html#l403">code »</a></span></h3><p>Encodes this profile as a zipped, base64 encoded directory.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the encoded profile.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPort" class="function"><div><h3>getPort()<span class="codelink"><a href="source/firefox/profile.js.src.html#l297">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The port this profile is currently configured to use, or
+0 if the port will be selected at random when the profile is written
+to disk.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPreference" class="function"><div><h3>getPreference(<wbr>key)<span class="codelink"><a href="source/firefox/profile.js.src.html#l287">code »</a></span></h3><p>Returns the currently configured value of a profile preference. This does
+not include any defaults defined in the profile&#39;s template directory user.js
+file (if a template were specified on construction).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The desired preference.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd><p>The current value of the
+requested preference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="nativeEventsEnabled" class="function"><div><h3>nativeEventsEnabled()<span class="codelink"><a href="source/firefox/profile.js.src.html#l361">code »</a></span></h3><p>Returns whether native events are enabled in this profile.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/firefox/profile.js.src.html#l423">code »</a></span></h3><p>Encodes this profile as a zipped, base64 encoded directory.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the encoded profile.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAcceptUntrustedCerts" class="function"><div><h3>setAcceptUntrustedCerts(<wbr>value)<span class="codelink"><a href="source/firefox/profile.js.src.html#l325">code »</a></span></h3><p>Sets whether the FirefoxDriver should automatically accept untrusted SSL
+certificates.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAssumeUntrustedCertIssuer" class="function"><div><h3>setAssumeUntrustedCertIssuer(<wbr>value)<span class="codelink"><a href="source/firefox/profile.js.src.html#l334">code »</a></span></h3><p>Sets whether to assume untrusted certificates come from untrusted issuers.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setNativeEventsEnabled" class="function"><div><h3>setNativeEventsEnabled(<wbr>enabled)<span class="codelink"><a href="source/firefox/profile.js.src.html#l352">code »</a></span></h3><p>Sets whether to use native events with this profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enabled<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setPort" class="function"><div><h3>setPort(<wbr>port)<span class="codelink"><a href="source/firefox/profile.js.src.html#l306">code »</a></span></h3><p>Sets the port to use for the WebDriver extension loaded by this profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>port<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired port, or 0 to use any free port.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setPreference" class="function"><div><h3>setPreference(<wbr>key, value)<span class="codelink"><a href="source/firefox/profile.js.src.html#l268">code »</a></span></h3><p>Sets a desired preference for this profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The preference key.</p>
+<dt>value<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)</code><dd><p>The preference value.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If attempting to set a frozen preference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="writeToDisk" class="function"><div><h3>writeToDisk(<wbr>opt_excludeWebDriverExt)<span class="codelink"><a href="source/firefox/profile.js.src.html#l375">code »</a></span></h3><p>Writes this profile to disk.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_excludeWebDriverExt<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd><p>Whether to exclude the WebDriver
+extension from the generated profile. Used to reduce the size of an
+<a href="module_selenium-webdriver_firefox_class_Profile.html#encode"><code>encoded profile</code></a> since the server will always install
+the extension itself.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the path to the new
+profile directory.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_extension.html b/docs/module_selenium-webdriver_firefox_extension.html
new file mode 100644
index 0000000..1dc08e4
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_extension.html
@@ -0,0 +1,8 @@
+<!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>selenium-webdriver/firefox/extension</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><div class="codelink"><a href="source/firefox/extension.js.src.html#l20">View Source</a></div><h1>module selenium-webdriver/firefox/extension</h1><p>Utilities for working with Firefox extensions.</p>
+<h2>Functions</h2><div id="install" class="function"><div><h3>install(<wbr>extension, dir)<span class="codelink"><a href="source/firefox/extension.js.src.html#l185">code »</a></span></h3><p>Installs an extension to the given directory.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>extension<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the extension to install, as either a xpi
+file or a directory.</p>
+<dt>dir<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the directory to install the extension in.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the add-on ID once
+installed.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_profile.html b/docs/module_selenium-webdriver_firefox_profile.html
new file mode 100644
index 0000000..2206a3a
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_profile.html
@@ -0,0 +1,13 @@
+<!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>selenium-webdriver/firefox/profile</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><div class="codelink"><a href="source/firefox/profile.js.src.html#l23">View Source</a></div><h1>module selenium-webdriver/firefox/profile</h1><p>Profile management module. This module is considered internal;
+users should use <a href="module_selenium-webdriver_firefox.html"><code>selenium-webdriver/firefox</code></a>.</p>
+<h2>Functions</h2><div id="decode" class="function"><div><h3>decode(<wbr>data)<span class="codelink"><a href="source/firefox/profile.js.src.html#l432">code »</a></span></h3><p>Decodes a base64 encoded profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>data<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The base64 encoded string.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the path to the decoded
+profile directory.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="loadUserPrefs" class="function"><div><h3>loadUserPrefs(<wbr>f)<span class="codelink"><a href="source/firefox/profile.js.src.html#l433">code »</a></span></h3><p>Parses a user.js file in a Firefox profile directory.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>f<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the file to parse.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the parsed preferences as
+a JSON object. If the file does not exist, an empty object will be
+returned.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_firefox_profile_class_Profile.html">Profile</a><dd><p>Models a Firefox proifle directory for use with the FirefoxDriver.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_firefox_profile_class_Profile.html b/docs/module_selenium-webdriver_firefox_profile_class_Profile.html
new file mode 100644
index 0000000..055d055
--- /dev/null
+++ b/docs/module_selenium-webdriver_firefox_profile_class_Profile.html
@@ -0,0 +1,50 @@
+<!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>Profile</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_firefox_profile.html">selenium-webdriver/firefox/profile</a></div><div class="codelink"><a href="source/firefox/profile.js.src.html#l431">View Source</a></div><h1>class Profile</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>
+  &#x2514; Profile</pre><p>Models a Firefox proifle directory for use with the FirefoxDriver. The
+<code>Proifle</code> directory uses an in-memory model until <a href="module_selenium-webdriver_firefox_profile_class_Profile.html#writeToDisk"><code>#writeToDisk</code></a>
+is called.</p>
+<h3>new Profile(<wbr>opt_dir)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_dir<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Path to an existing Firefox profile directory to
+use a template for this profile. If not specified, a blank profile will
+be used.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="acceptUntrustedCerts" class="function"><div><h3>acceptUntrustedCerts()<span class="codelink"><a href="source/firefox/profile.js.src.html#l315">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the FirefoxDriver is configured to automatically
+accept untrusted SSL certificates.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="addExtension" class="function"><div><h3>addExtension(<wbr>extension)<span class="codelink"><a href="source/firefox/profile.js.src.html#l257">code »</a></span></h3><p>Registers an extension to be included with this profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>extension<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the extension to include, as either an
+unpacked extension directory or the path to a xpi file.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="assumeUntrustedCertIssuer" class="function"><div><h3>assumeUntrustedCertIssuer()<span class="codelink"><a href="source/firefox/profile.js.src.html#l343">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to assume untrusted certs come from untrusted
+issuers.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="encode" class="function"><div><h3>encode()<span class="codelink"><a href="source/firefox/profile.js.src.html#l403">code »</a></span></h3><p>Encodes this profile as a zipped, base64 encoded directory.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the encoded profile.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPort" class="function"><div><h3>getPort()<span class="codelink"><a href="source/firefox/profile.js.src.html#l297">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The port this profile is currently configured to use, or
+0 if the port will be selected at random when the profile is written
+to disk.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPreference" class="function"><div><h3>getPreference(<wbr>key)<span class="codelink"><a href="source/firefox/profile.js.src.html#l287">code »</a></span></h3><p>Returns the currently configured value of a profile preference. This does
+not include any defaults defined in the profile&#39;s template directory user.js
+file (if a template were specified on construction).</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The desired preference.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd><p>The current value of the
+requested preference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="nativeEventsEnabled" class="function"><div><h3>nativeEventsEnabled()<span class="codelink"><a href="source/firefox/profile.js.src.html#l361">code »</a></span></h3><p>Returns whether native events are enabled in this profile.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/firefox/profile.js.src.html#l423">code »</a></span></h3><p>Encodes this profile as a zipped, base64 encoded directory.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the encoded profile.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAcceptUntrustedCerts" class="function"><div><h3>setAcceptUntrustedCerts(<wbr>value)<span class="codelink"><a href="source/firefox/profile.js.src.html#l325">code »</a></span></h3><p>Sets whether the FirefoxDriver should automatically accept untrusted SSL
+certificates.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setAssumeUntrustedCertIssuer" class="function"><div><h3>setAssumeUntrustedCertIssuer(<wbr>value)<span class="codelink"><a href="source/firefox/profile.js.src.html#l334">code »</a></span></h3><p>Sets whether to assume untrusted certificates come from untrusted issuers.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setNativeEventsEnabled" class="function"><div><h3>setNativeEventsEnabled(<wbr>enabled)<span class="codelink"><a href="source/firefox/profile.js.src.html#l352">code »</a></span></h3><p>Sets whether to use native events with this profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enabled<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setPort" class="function"><div><h3>setPort(<wbr>port)<span class="codelink"><a href="source/firefox/profile.js.src.html#l306">code »</a></span></h3><p>Sets the port to use for the WebDriver extension loaded by this profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>port<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The desired port, or 0 to use any free port.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setPreference" class="function"><div><h3>setPreference(<wbr>key, value)<span class="codelink"><a href="source/firefox/profile.js.src.html#l268">code »</a></span></h3><p>Sets a desired preference for this profile.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>key<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The preference key.</p>
+<dt>value<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)</code><dd><p>The preference value.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If attempting to set a frozen preference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="writeToDisk" class="function"><div><h3>writeToDisk(<wbr>opt_excludeWebDriverExt)<span class="codelink"><a href="source/firefox/profile.js.src.html#l375">code »</a></span></h3><p>Writes this profile to disk.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_excludeWebDriverExt<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd><p>Whether to exclude the WebDriver
+extension from the generated profile. Used to reduce the size of an
+<a href="module_selenium-webdriver_firefox_profile_class_Profile.html#encode"><code>encoded profile</code></a> since the server will always install
+the extension itself.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the path to the new
+profile directory.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_http.html b/docs/module_selenium-webdriver_http.html
index a5b2f98..bd3de77 100644
--- a/docs/module_selenium-webdriver_http.html
+++ b/docs/module_selenium-webdriver_http.html
@@ -1,4 +1,9 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/http</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/http</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/http/index.js.src.html">code &raquo;</a></header><section><p>Defines a the <code >webdriver.http.Client</code> for use with
- NodeJS.</section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_http_Executor.html">Executor</a><dd>A command executor that communicates with a server using the WebDriver
- command protocol.<dt><a href="module_selenium-webdriver_http_class_HttpClient.html">HttpClient</a><dd>A <code  class="type"><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code> implementation using Node's built-in http
- module.<dt><a href="class_webdriver_http_Request.html">Request</a><dd>Describes a partial HTTP request.<dt><a href="class_webdriver_http_Response.html">Response</a><dd>Represents a HTTP response.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/http</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><div class="codelink"><a href="source/http/index.js.src.html#l23">View Source</a></div><h1>module selenium-webdriver/http</h1><p>Defines the <code>webdriver.http.Client</code> for use with
+NodeJS.</p>
+<h2>Types</h2><dl><dt><a href="module_selenium-webdriver_http_class_Executor.html">Executor</a><dd><p>A command executor that communicates with a server using the WebDriver
+command protocol.</p>
+<dt><a href="module_selenium-webdriver_http_class_HttpClient.html">HttpClient</a><dd><p>A <a href="interface_webdriver_http_Client.html"><code>webdriver.http.Client</code></a> implementation using Node&#39;s built-in http
+module.</p>
+<dt><a href="module_selenium-webdriver_http_class_Request.html">Request</a><dd><p>Describes a partial HTTP request.</p>
+<dt><a href="module_selenium-webdriver_http_class_Response.html">Response</a><dd><p>Represents a HTTP response.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_http_class_Executor.html b/docs/module_selenium-webdriver_http_class_Executor.html
new file mode 100644
index 0000000..a884e88
--- /dev/null
+++ b/docs/module_selenium-webdriver_http_class_Executor.html
@@ -0,0 +1,22 @@
+<!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>Executor</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_http.html">selenium-webdriver/http</a></div><div class="codelink"><a href="source/http/index.js.src.html#l189">View Source</a></div><h1>class Executor</h1><dl><dt>Alias for <code><a href="class_webdriver_http_Executor.html">webdriver.http.Executor</a></code><dt>All implemented interfaces<dd><code><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a></code></dl><p>A command executor that communicates with a server using the WebDriver
+command protocol.</p>
+<h3>new Executor(<wbr>client)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>client<code><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code><dd><p>The client to use when sending
+requests to the server.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="defineCommand" class="function"><div><h3>defineCommand(<wbr>name, method, path)<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l102">code »</a></span></h3><p>Defines a new command for use with this executor. When a command is sent,
+the <code>path</code> will be preprocessed using the command&#39;s parameters; any
+path segments prefixed with &#34;:&#34; will be replaced by the parameter of the
+same name. For example, given &#34;/person/:name&#34; and the parameters
+&#34;{name: &#39;Bob&#39;}&#34;, the final command path will be &#34;/person/Bob&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The command name.</p>
+<dt>method<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The HTTP method to use when sending this command.</p>
+<dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to send the command to, relative to
+the WebDriver server&#39;s command root and of the form
+&#34;/path/:variable/segment&#34;.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="execute" class="function"><div><h3>execute(<wbr>command, callback)<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l109">code »</a></span></h3><p>Executes the given <code>command</code>. If there is an error executing the
+command, the provided callback will be invoked with the offending error.
+Otherwise, the callback will be invoked with a null Error and non-null
+<a href="namespace_bot_response.html#response.ResponseObject"><code>bot.response.ResponseObject</code></a> object.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_CommandExecutor.html#execute">webdriver.CommandExecutor</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to execute.</p>
+<dt>callback<code>function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>, {status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}=): ?</code><dd><p>the function
+to invoke when the command response is ready.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_http_class_HttpClient.html b/docs/module_selenium-webdriver_http_class_HttpClient.html
index 370359b..102cb7b 100644
--- a/docs/module_selenium-webdriver_http_class_HttpClient.html
+++ b/docs/module_selenium-webdriver_http_class_HttpClient.html
@@ -1,2 +1,16 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>HttpClient</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class HttpClient</h1><a class="source" href="source/http/index.js.src.html#l151">code &raquo;</a><dl><dt>All implemented interfaces:<dd><code><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code></dl></header><section><p>A <code  class="type"><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code> implementation using Node's built-in http
- module.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">HttpClient <span class="args">( serverUrl )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>serverUrl: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL for the WebDriver server to send commands to.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/http/index.js.src.html#l53">code &raquo;</a><span class="member"><a name="send">send</a> <span class="args">( httpRequest, callback )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>httpRequest<dt>callback</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/http/index.js.src.html#l44">code &raquo;</a><span class="member"><a name="options_">options_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Base options for each request.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>HttpClient</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_http.html">selenium-webdriver/http</a></div><div class="codelink"><a href="source/http/index.js.src.html#l197">View Source</a></div><h1>class HttpClient</h1><dl><dt>All implemented interfaces<dd><code><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a></code></dl><p>A <a href="interface_webdriver_http_Client.html"><code>webdriver.http.Client</code></a> implementation using Node&#39;s built-in http
+module.</p>
+<h3>new HttpClient(<wbr>serverUrl, opt_agent, opt_proxy)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>serverUrl<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>URL for the WebDriver server to send commands to.</p>
+<dt>opt_agent<code>?http.Agent=</code><dd><p>The agent to use for each request.
+Defaults to <code>http.globalAgent</code>.</p>
+<dt>opt_proxy<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The proxy to use for the connection to the server.
+Default is to use no proxy.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="send" class="function"><div><h3>send(<wbr>request, callback)<span class="codelink"><a href="source/http/index.js.src.html#l67">code »</a></span></h3><p>Sends a request to the server. If an error occurs while sending the request,
+such as a failure to connect to the server, the provided callback will be
+invoked with a non-null <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error"><code>Error</code></a> describing the error. Otherwise, when
+the server&#39;s response has been received, the callback will be invoked with a
+null Error and non-null <a href="class_webdriver_http_Response.html"><code>webdriver.http.Response</code></a> object.</p>
+<p><b>Specified by: </b><a href="interface_webdriver_http_Client.html#send">webdriver.http.Client</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>request<code><a href="class_webdriver_http_Request.html">webdriver.http.Request</a></code><dd><p>The request to send.</p>
+<dt>callback<code>function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a>, <a href="class_webdriver_http_Response.html">webdriver.http.Response</a>=): ?</code><dd><p>the function to
+invoke when the server&#39;s response is ready.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_http_class_Request.html b/docs/module_selenium-webdriver_http_class_Request.html
new file mode 100644
index 0000000..755cc7f
--- /dev/null
+++ b/docs/module_selenium-webdriver_http_class_Request.html
@@ -0,0 +1,12 @@
+<!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>Request</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_http.html">selenium-webdriver/http</a></div><div class="codelink"><a href="source/http/index.js.src.html#l192">View Source</a></div><h1>class Request</h1><dl><dt>Alias for <code><a href="class_webdriver_http_Request.html">webdriver.http.Request</a></code></dl><p>Describes a partial HTTP request. This class is a &#34;partial&#34; request and only
+defines the path on the server to send a request to. It is each
+<a href="interface_webdriver_http_Client.html"><code>webdriver.http.Client</code></a>&#39;s responsibility to build the full URL for the
+final request.</p>
+<h3>new Request(<wbr>method, path, opt_data)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>method<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The HTTP method to use for the request.</p>
+<dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path on the server to send the request to.</p>
+<dt>opt_data<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>This request&#39;s JSON data.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l433">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></div></div></div></div><h2>Instance Properties</h2><div id="data" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l422">data</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>This request&#39;s body.</p>
+</dl></div><div id="headers" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l428">headers</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)&gt;</code><dd><p>The headers to send with the request.</p>
+</dl></div><div id="method" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l410">method</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The HTTP method to use for the request.</p>
+</dl></div><div id="path" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l416">path</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path on the server to send the request to.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_http_class_Response.html b/docs/module_selenium-webdriver_http_class_Response.html
new file mode 100644
index 0000000..cbc19cc
--- /dev/null
+++ b/docs/module_selenium-webdriver_http_class_Response.html
@@ -0,0 +1,13 @@
+<!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>Response</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_http.html">selenium-webdriver/http</a></div><div class="codelink"><a href="source/http/index.js.src.html#l195">View Source</a></div><h1>class Response</h1><dl><dt>Alias for <code><a href="class_webdriver_http_Response.html">webdriver.http.Response</a></code></dl><p>Represents a HTTP response.</p>
+<h3>new Response(<wbr>status, headers, body)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>status<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The response code.</p>
+<dt>headers<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>The response headers. All header
+names will be converted to lowercase strings for consistent lookups.</p>
+<dt>body<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The response body.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="toString" class="function"><div><h3>toString()<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l510">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl></div></div></div></div><h2>Instance Properties</h2><div id="body" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l464">body</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The response body.</p>
+</dl></div><div id="headers" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l470">headers</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>The response body.</p>
+</dl></div><div id="status" class="property"><dl><dt><a href="source/lib/webdriver/http/http.js.src.html#l458">status</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The HTTP response code.</p>
+</dl></div><h2>Static Functions</h2><div id="Response.fromXmlHttpRequest" class="function"><div><h3>Response.fromXmlHttpRequest(<wbr>xhr)<span class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l483">code »</a></span></h3><p>Builds a <a href="class_webdriver_http_Response.html"><code>webdriver.http.Response</code></a> from a <code>XMLHttpRequest</code> or
+<code>XDomainRequest</code> response object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>xhr<code>(XDomainRequest|XMLHttpRequest)</code><dd><p>The request to parse.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_http_Response.html">webdriver.http.Response</a></code><dd><p>The parsed response.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_http_util.html b/docs/module_selenium-webdriver_http_util.html
index e85d100..76dc809 100644
--- a/docs/module_selenium-webdriver_http_util.html
+++ b/docs/module_selenium-webdriver_http_util.html
@@ -1,5 +1,17 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/http/util</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/http/util</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/http/util.js.src.html">code &raquo;</a></header><section><p>Various HTTP utilities.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/http/util.js.src.html#l62">code &raquo;</a><span class="member"><a name="getStatus">getStatus</a> <span class="args">( url )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Queries a WebDriver server for its current status.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Base URL of the server to query.</dl><tr><th>Returns<tr><td><dl>A promise that resolves with
-     a hash of the server status.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/http/util.js.src.html#l74">code &raquo;</a><span class="member"><a name="waitForServer">waitForServer</a> <span class="args">( url, timeout )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Waits for a WebDriver server to be healthy and accepting requests.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Base URL of the server to query.<dt>timeout: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>How long to wait for the server.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve when the
-     server is ready.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/http/util.js.src.html#l107">code &raquo;</a><span class="member"><a name="waitForUrl">waitForUrl</a> <span class="args">( url, timeout )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Polls a URL with GET requests until it returns a 2xx response or the
- timeout expires.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URL to poll.<dt>timeout: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>How long to wait, in milliseconds.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve when the
-     URL responds with 2xx.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/http/util</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><div class="codelink"><a href="source/http/util.js.src.html#l22">View Source</a></div><h1>module selenium-webdriver/http/util</h1><p>Various HTTP utilities.</p>
+<h2>Functions</h2><div id="getStatus" class="function"><div><h3>getStatus(<wbr>url)<span class="codelink"><a href="source/http/util.js.src.html#l64">code »</a></span></h3><p>Queries a WebDriver server for its current status.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Base URL of the server to query.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&gt;</code><dd><p>A promise that resolves with
+a hash of the server status.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="waitForServer" class="function"><div><h3>waitForServer(<wbr>url, timeout)<span class="codelink"><a href="source/http/util.js.src.html#l76">code »</a></span></h3><p>Waits for a WebDriver server to be healthy and accepting requests.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Base URL of the server to query.</p>
+<dt>timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>How long to wait for the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will resolve when the
+server is ready.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="waitForUrl" class="function"><div><h3>waitForUrl(<wbr>url, timeout)<span class="codelink"><a href="source/http/util.js.src.html#l109">code »</a></span></h3><p>Polls a URL with GET requests until it returns a 2xx response or the
+timeout expires.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The URL to poll.</p>
+<dt>timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>How long to wait, in milliseconds.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will resolve when the
+URL responds with 2xx.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_ie.html b/docs/module_selenium-webdriver_ie.html
new file mode 100644
index 0000000..315f73d
--- /dev/null
+++ b/docs/module_selenium-webdriver_ie.html
@@ -0,0 +1,11 @@
+<!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>selenium-webdriver/ie</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><div class="codelink"><a href="source/ie.js.src.html#l28">View Source</a></div><h1>module selenium-webdriver/ie</h1><p>Defines a <a href="module_selenium-webdriver_ie_class_Driver.html">WebDriver</a> client for Microsoft&#39;s
+Internet Explorer. Before using the IEDriver, you must download the latest
+<a href="http://selenium-release.storage.googleapis.com/index.html">IEDriverServer</a>
+and place it on your
+<a href="http://en.wikipedia.org/wiki/PATH_%28variable%29">PATH</a>. You must also apply
+the system configuration outlined on the Selenium project
+<a href="https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver">wiki</a></p>
+<h2>Types</h2><dl><dt><a href="module_selenium-webdriver_ie_class_Driver.html">Driver</a><dd><p>A WebDriver client for Microsoft&#39;s Internet Explorer.</p>
+<dt><a href="module_selenium-webdriver_ie_enum_Level.html">Level</a><dd><p>No description.</p>
+<dt><a href="module_selenium-webdriver_ie_class_Options.html">Options</a><dd><p>Class for managing IEDriver specific options.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_ie_class_Driver.html b/docs/module_selenium-webdriver_ie_class_Driver.html
new file mode 100644
index 0000000..08c9bae
--- /dev/null
+++ b/docs/module_selenium-webdriver_ie_class_Driver.html
@@ -0,0 +1,274 @@
+<!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>Driver</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_ie.html">selenium-webdriver/ie</a></div><div class="codelink"><a href="source/ie.js.src.html#l463">View Source</a></div><h1>class Driver</h1><pre class="inheritance"><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>
+  &#x2514; Driver</pre><p>A WebDriver client for Microsoft&#39;s Internet Explorer.</p>
+<h3>new Driver(<wbr>opt_config, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_config<code>?(<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>|<a href="module_selenium-webdriver_ie_class_Options.html">Options</a>)=</code><dd><p>The configuration
+options.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow to use, or
+<code>null</code> to use the currently active flow.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="actions" class="function"><div><h3>actions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l469">code »</a></span></h3><p>Creates a new action sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_ActionSequence.html#perform"><code>webdriver.ActionSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.actions().
+    mouseDown(element1).
+    mouseMove(element2).
+    mouseUp().
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#actions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A new action sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="call" class="function"><div><h3><code>&lt;T&gt;</code> call(<wbr>fn, opt_scope, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l639">code »</a></span></h3><p>Schedules a command to execute a custom function.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#call">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(...?): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+execute.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to execute the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved&#39;
+with the function&#39;s result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="close" class="function"><div><h3>close()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l780">code »</a></span></h3><p>Schedules a command to close the current window.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#close">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l324">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#controlFlow">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow used by this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeAsyncScript" class="function"><div><h3><code>&lt;T&gt;</code> executeAsyncScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l617">code »</a></span></h3><p>Schedules a command to execute asynchronous JavaScript in the context of the
+currently selected frame or window. The script fragment will be executed as
+the body of an anonymous function. If the script is provided as a function
+object, that function will be converted to a string for injection into the
+target window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>Unlike executing synchronous JavaScript with <a href="module_selenium-webdriver_ie_class_Driver.html#executeScript"><code>#executeScript</code></a>,
+scripts executed with this function must explicitly signal they are finished
+by invoking the provided callback. This callback will always be injected
+into the executed function as the last argument, and thus may be referenced
+with <code>arguments[arguments.length - 1]</code>. The following steps will be
+taken for resolving this functions return value against the first argument
+to the script&#39;s callback function:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><strong>Example #1:</strong> Performing a sleep that is synchronized with the currently
+selected window:</p>
+<pre><code>var start &#61; new Date().getTime();
+driver.executeAsyncScript(
+    &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).
+    then(function() {
+      console.log(
+          &#39;Elapsed time: &#39; &#43; (new Date().getTime() - start) &#43; &#39; ms&#39;);
+    });
+</code></pre>
+<p><strong>Example #2:</strong> Synchronizing a test with an AJAX application:</p>
+<pre><code>var button &#61; driver.findElement(By.id(&#39;compose-button&#39;));
+button.click();
+driver.executeAsyncScript(
+    &#39;var callback &#61; arguments[arguments.length - 1];&#39; &#43;
+    &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);
+driver.switchTo().frame(&#39;composeWidget&#39;);
+driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog&#64;example.com&#39;);
+</code></pre>
+<p><strong>Example #3:</strong> Injecting a XMLHttpRequest and waiting for the result. In
+this example, the inject script is specified with a function literal. When
+using this format, the function is converted to a string for injection, so it
+should not reference any symbols not defined in the scope of the page under
+test.</p>
+<pre><code>driver.executeAsyncScript(function() {
+  var callback &#61; arguments[arguments.length - 1];
+  var xhr &#61; new XMLHttpRequest();
+  xhr.open(&#34;GET&#34;, &#34;/resource/data.json&#34;, true);
+  xhr.onreadystatechange &#61; function() {
+    if (xhr.readyState &#61;&#61; 4) {
+      callback(xhr.responseText);
+    }
+  }
+  xhr.send(&#39;&#39;);
+}).then(function(str) {
+  console.log(JSON.parse(str)[&#39;food&#39;]);
+});
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeAsyncScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeScript" class="function"><div><h3><code>&lt;T&gt;</code> executeScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l528">code »</a></span></h3><p>Schedules a command to execute JavaScript in the context of the currently
+selected frame or window. The script fragment will be executed as the body
+of an anonymous function. If the script is provided as a function object,
+that function will be converted to a string for injection into the target
+window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>The script may refer to any variables accessible from the current window.
+Furthermore, the script will execute in the window&#39;s context, thus
+<code>document</code> may be used to refer to the current document. Any local
+variables will not be available once the script has finished executing,
+though global variables will persist.</p>
+<p>If the script has a return value (i.e. if the script contains a return
+statement), then the following steps will be taken for resolving this
+functions return value:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l867">code »</a></span></h3><p>Schedule a command to find an element on the page. If the element cannot be
+found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will be returned
+by the driver. Unlike other commands, this error cannot be suppressed. In
+other words, scheduling a command to find an element doubles as an assert
+that the element is present on the page. To test whether an element is
+present on the page, use <a href="module_selenium-webdriver_ie_class_Driver.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; driver.findElement(firstVisibleLink);
+
+function firstVisibleLink(driver) {
+  var links &#61; driver.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p>When running in the browser, a WebDriver cannot manipulate DOM elements
+directly; it may do so only through a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> reference.
+This function may be used to generate a WebElement from a DOM element. A
+reference to the DOM element will be stored in a known location and this
+driver will attempt to retrieve it through <a href="module_selenium-webdriver_ie_class_Driver.html#executeScript"><code>#executeScript</code></a>. If the
+element cannot be found (eg, it belongs to a different document than the
+one this instance is currently focused on), a
+<a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error will be returned.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElement">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l994">code »</a></span></h3><p>Schedule a command to search for multiple elements on the page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElements">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l792">code »</a></span></h3><p>Schedules a command to navigate to the given URL.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#get">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The fully qualified URL to open.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the document has finished loading.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAllWindowHandles" class="function"><div><h3>getAllWindowHandles()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l753">code »</a></span></h3><p>Schedules a command to retrieve the current list of available window handles.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getAllWindowHandles">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;&gt;</code><dd><p>A promise that will
+be resolved with an array of window handles.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l430">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCapabilities">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>&gt;</code><dd><p>A promise
+that will resolve with the this instance&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCurrentUrl" class="function"><div><h3>getCurrentUrl()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l802">code »</a></span></h3><p>Schedules a command to retrieve the URL of the current page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCurrentUrl">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current URL.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPageSource" class="function"><div><h3>getPageSource()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l768">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s source. The page source
+returned is a representation of the underlying DOM: do not expect it to be
+formatted or escaped in the same way as the response sent from the web
+server.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getPageSource">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page source.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSession" class="function"><div><h3>getSession()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l421">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getSession">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Session.html">webdriver.Session</a>&gt;</code><dd><p>A promise for this
+client&#39;s session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTitle" class="function"><div><h3>getTitle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l814">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s title.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getTitle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page&#39;s title.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWindowHandle" class="function"><div><h3>getWindowHandle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l741">code »</a></span></h3><p>Schedules a command to retrieve they current window handle.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getWindowHandle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current window handle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locatorOrElement)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l974">code »</a></span></h3><p>Schedules a command to test if an element is present on the page.</p>
+<p>If given a DOM element, this function will check if it belongs to the
+document the driver is currently focused on. Otherwise, the function will
+test if at least one element can be found with the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#isElementPresent">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locatorOrElement<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator to use, or the actual
+DOM element to be located by the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the element is present on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manage" class="function"><div><h3>manage()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1056">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#manage">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code><dd><p>The options interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="navigate" class="function"><div><h3>navigate()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1065">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#navigate">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code><dd><p>The navigation interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="quit" class="function"><div><h3>quit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l444">code »</a></span></h3><p>Schedules a command to quit the current session. After calling quit, this
+instance will be invalidated and may no longer be used to issue commands
+against the browser.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#quit">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="schedule" class="function"><div><h3><code>&lt;T&gt;</code> schedule(<wbr>command, description)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l338">code »</a></span></h3><p>Schedules a <code>webdriver.Command</code> to be executed by this driver&#39;s
+<code>webdriver.CommandExecutor</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#schedule">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to schedule.</p>
+<dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of the command for debugging.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the command result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFileDetector" class="function"><div><h3>setFileDetector(<wbr>detector)<span class="codelink"><a href="source/ie.js.src.html#l456">code »</a></span></h3><p>This function is a no-op as file detectors are not supported by this
+implementation.</p>
+<p><b>Overrides: </b><a href="class_webdriver_WebDriver.html#setFileDetector">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detector<code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code><dd><p>The detector to use or <code>null</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sleep" class="function"><div><h3>sleep(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l731">code »</a></span></h3><p>Schedules a command to make the driver sleep for the given amount of time.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#sleep">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to sleep.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the sleep has finished.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="switchTo" class="function"><div><h3>switchTo()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1074">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#switchTo">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code><dd><p>The target locator interface for
+this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="takeScreenshot" class="function"><div><h3>takeScreenshot()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1046">code »</a></span></h3><p>Schedule a command to take a screenshot. The driver makes a best effort to
+return a screenshot of the following, in order of preference:</p>
+<ol><li>Entire page
+  </li><li>Current window
+  </li><li>Visible portion of the current frame
+  </li><li>The screenshot of the entire display containing the browser
+</li></ol>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#takeScreenshot">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the screenshot as a base-64 encoded PNG.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="touchActions" class="function"><div><h3>touchActions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l486">code »</a></span></h3><p>Creates a new touch sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_TouchSequence.html#perform"><code>webdriver.TouchSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.touchActions().
+    tap(element1).
+    doubleTap(element2).
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#touchActions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A new touch sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l700">code »</a></span></h3><p>Schedules a command to wait for a condition to hold. The condition may be
+specified by a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a>, as a custom function, or
+as a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>.</p>
+<p>For a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a> or function, the wait will repeatedly
+evaluate the condition until it returns a truthy value. If any errors occur
+while evaluating the condition, they will be allowed to propagate. In the
+event a condition returns a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>, the
+polling loop will wait for it to be resolved and use the resolved value for
+whether the condition has been satisified. Note the resolution time for
+a promise is factored into whether a wait has timed out.</p>
+<p><em>Example:</em> waiting up to 10 seconds for an element to be present and visible
+on the page.</p>
+<pre><code>var button &#61; driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);
+button.click();
+</code></pre>
+<p>This function may also be used to block the command flow on the resolution
+of a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>. When given a promise, the
+command will simply wait for its resolution before completing. A timeout may
+be provided to fail the command if the promise does not resolve before the
+timeout expires.</p>
+<p><em>Example:</em> Suppose you have a function, <code>startTestServer</code>, that returns a
+promise for when a server is ready for requests. You can block a <code>WebDriver</code>
+client on this promise with:</p>
+<pre><code>var started &#61; startTestServer();
+driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);
+driver.get(getServerUrl());
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#wait">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|<a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;T&gt;|function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): T)</code><dd><p>The condition to
+wait on, defined as a promise, condition object, or  a function to
+evaluate as a condition.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait for the condition to be true.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional message to use if the wait times
+out.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+with the first truthy value returned by the condition function, or
+rejected if the condition times out.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_ie_class_Options.html b/docs/module_selenium-webdriver_ie_class_Options.html
new file mode 100644
index 0000000..b250383
--- /dev/null
+++ b/docs/module_selenium-webdriver_ie_class_Options.html
@@ -0,0 +1,89 @@
+<!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>Options</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_ie.html">selenium-webdriver/ie</a></div><div class="codelink"><a href="source/ie.js.src.html#l464">View Source</a></div><h1>class Options</h1><p>Class for managing IEDriver specific options.</p>
+<h3>new Options()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="addArguments" class="function"><div><h3>addArguments(<wbr>var_args)<span class="codelink"><a href="source/ie.js.src.html#l255">code »</a></span></h3><p>Specifies command-line switches to use when launching Internet Explorer.
+This is only valid when used with <a href="module_selenium-webdriver_ie_class_Options.html#forceCreateProcessApi"><code>#forceCreateProcessApi</code></a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The arguments to add.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="browserAttachTimeout" class="function"><div><h3>browserAttachTimeout(<wbr>timeout)<span class="codelink"><a href="source/ie.js.src.html#l227">code »</a></span></h3><p>Configures the timeout, in milliseconds, that the driver will attempt to
+located and attach to a newly opened instance of Internet Explorer. The
+default is zero, which indicates waiting indefinitely.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>How long to wait for IE.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="enableElementCacheCleanup" class="function"><div><h3>enableElementCacheCleanup(<wbr>enable)<span class="codelink"><a href="source/ie.js.src.html#l198">code »</a></span></h3><p>Configures whether the driver should attempt to remove obsolete
+<a href="class_webdriver_WebElement.html">WebElements</a> from its internal cache on
+page navigation (true by default). Disabling this option will cause the
+driver to run with a larger memory footprint.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enable<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable element reference cleanup.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="enablePersistentHover" class="function"><div><h3>enablePersistentHover(<wbr>enable)<span class="codelink"><a href="source/ie.js.src.html#l183">code »</a></span></h3><p>Configures whether to enable persistent mouse hovering (true by default).
+Persistent hovering is achieved by continuously firing mouse over events at
+the last location the mouse cursor has been moved to.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enable<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable persistent hovering.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="ensureCleanSession" class="function"><div><h3>ensureCleanSession(<wbr>cleanSession)<span class="codelink"><a href="source/ie.js.src.html#l286">code »</a></span></h3><p>Configures whether to clear the cache, cookies, history, and saved form data
+before starting the browser. <em>Using this capability will clear session data
+for all running instances of Internet Explorer, including those started
+manually.</em></p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>cleanSession<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to clear all session data on startup.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="forceCreateProcessApi" class="function"><div><h3>forceCreateProcessApi(<wbr>force)<span class="codelink"><a href="source/ie.js.src.html#l242">code »</a></span></h3><p>Configures whether to launch Internet Explorer using the CreateProcess API.
+If this option is not specified, IE is launched using IELaunchURL, if
+available. For IE 8 and above, this option requires the TabProcGrowth
+registry value to be set to 0.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>force<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to use the CreateProcess API.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="ignoreZoomSetting" class="function"><div><h3>ignoreZoomSetting(<wbr>ignore)<span class="codelink"><a href="source/ie.js.src.html#l153">code »</a></span></h3><p>Indicates whether to skip the check that the browser&#39;s zoom level is set to
+100%.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ignore<code>?</code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>ore Whether to ignore the browser&#39;s zoom level settings.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="initialBrowserUrl" class="function"><div><h3>initialBrowserUrl(<wbr>url)<span class="codelink"><a href="source/ie.js.src.html#l169">code »</a></span></h3><p>Sets the initial URL loaded when IE starts. This is intended to be used with
+<a href="module_selenium-webdriver_ie_class_Options.html"><code>#ignoreProtectedModeSettings</code></a> to allow the user to initialize IE in
+the proper Protected Mode zone. Setting this option may cause browser
+instability or flaky and unresponsive code. Only &#34;best effort&#34; support is
+provided when using this option.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The initial browser URL.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="introduceFlakinessByIgnoringProtectedModeSettings" class="function"><div><h3>introduceFlakinessByIgnoringProtectedModeSettings(<wbr>ignoreSettings)<span class="codelink"><a href="source/ie.js.src.html#l139">code »</a></span></h3><p>Whether to disable the protected mode settings check when the session is
+created. Disbling this setting may lead to significant instability as the
+browser may become unresponsive/hang. Only &#34;best effort&#34; support is provided
+when using this capability.</p>
+<p>For more information, refer to the IEDriver&#39;s
+<a href="http://goo.gl/eH0Yi3">required system configuration</a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ignoreSettings<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to ignore protected mode settings.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="requireWindowFocus" class="function"><div><h3>requireWindowFocus(<wbr>require)<span class="codelink"><a href="source/ie.js.src.html#l213">code »</a></span></h3><p>Configures whether to require the IE window to have input focus before
+performing any user interactions (i.e. mouse or keyboard events). This
+option is disabled by default, but delivers much more accurate interaction
+events when enabled.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>require<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to require window focus.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setExtractPath" class="function"><div><h3>setExtractPath(<wbr>path)<span class="codelink"><a href="source/ie.js.src.html#l330">code »</a></span></h3><p>Sets the path of the temporary data directory to use.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The log file path.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setHost" class="function"><div><h3>setHost(<wbr>host)<span class="codelink"><a href="source/ie.js.src.html#l319">code »</a></span></h3><p>Sets the IP address of the driver&#39;s host adapter.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>host<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The IP address to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLogFile" class="function"><div><h3>setLogFile(<wbr>path)<span class="codelink"><a href="source/ie.js.src.html#l297">code »</a></span></h3><p>Sets the path to the log file the driver should log to.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The log file path.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLogLevel" class="function"><div><h3>setLogLevel(<wbr>level)<span class="codelink"><a href="source/ie.js.src.html#l308">code »</a></span></h3><p>Sets the IEDriverServer&#39;s logging <a href="module_selenium-webdriver_ie_enum_Level.html">level</a>.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>level<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The logging level.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>proxy)<span class="codelink"><a href="source/ie.js.src.html#l352">code »</a></span></h3><p>Sets the proxy settings for the new session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code><a href="module_selenium-webdriver.html">selenium-webdriver.ProxyConfig</a></code><dd><p>The proxy configuration to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="silent" class="function"><div><h3>silent(<wbr>silent)<span class="codelink"><a href="source/ie.js.src.html#l341">code »</a></span></h3><p>Sets whether the driver should start in silent mode.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>silent<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to run in silent mode.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toCapabilities" class="function"><div><h3>toCapabilities(<wbr>opt_capabilities)<span class="codelink"><a href="source/ie.js.src.html#l364">code »</a></span></h3><p>Converts this options instance to a <a href="class_webdriver_Capabilities.html"><code>webdriver.Capabilities</code></a> object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_capabilities<code>?<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>=</code><dd><p>The capabilities to merge
+these options into, if any.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="usePerProcessProxy" class="function"><div><h3>usePerProcessProxy(<wbr>enable)<span class="codelink"><a href="source/ie.js.src.html#l271">code »</a></span></h3><p>Configures whether proxies should be configured on a per-process basis. If
+not set, setting a <a href="module_selenium-webdriver_ie_class_Options.html#setProxy">proxy</a> will configure the system
+proxy. The default behavior is to use the system proxy.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>enable<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to enable per-process proxy settings.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="Options.fromCapabilities" class="function"><div><h3>Options.fromCapabilities(<wbr>capabilities)<span class="codelink"><a href="source/ie.js.src.html#l108">code »</a></span></h3><p>Extracts the IEDriver specific options from the given capabilities
+object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>capabilities<code><a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a></code><dd><p>The capabilities object.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_ie_class_Options.html">Options</a></code><dd><p>The IEDriver options.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_ie_enum_Level.html b/docs/module_selenium-webdriver_ie_enum_Level.html
new file mode 100644
index 0000000..4c5bd53
--- /dev/null
+++ b/docs/module_selenium-webdriver_ie_enum_Level.html
@@ -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>Level</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_ie.html">selenium-webdriver/ie</a></div><div class="codelink"><a href="source/ie.js.src.html#l465">View Source</a></div><h1>enum Level</h1><dl><dt>Type<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></dl><h2>Values and Descriptions</h2><div id="DEBUG" class="property"><dl><dt>DEBUG</dl></div><div id="ERROR" class="property"><dl><dt>ERROR</dl></div><div id="FATAL" class="property"><dl><dt>FATAL</dl></div><div id="INFO" class="property"><dl><dt>INFO</dl></div><div id="TRACE" class="property"><dl><dt>TRACE</dl></div><div id="WARN" class="property"><dl><dt>WARN</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_io.html b/docs/module_selenium-webdriver_io.html
index aabdf7f..78f6b5e 100644
--- a/docs/module_selenium-webdriver_io.html
+++ b/docs/module_selenium-webdriver_io.html
@@ -1,4 +1,37 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/io</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/io</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/io/index.js.src.html">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/io/index.js.src.html#l35">code &raquo;</a><span class="member"><a name="findInPath">findInPath</a> <span class="args">( file, opt_checkCwd )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Searches the <code >PATH</code> environment variable for the given file.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>file: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The file to locate on the PATH.<dt>opt_checkCwd: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to always start with the search with
-     the current working directory, regardless of whether it is explicitly
-     listed on the PATH.</dl><tr><th>Returns<tr><td><dl>Path to the located file, or <code >null</code> if it could
-     not be found.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/io</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><div class="codelink"><a href="source/io/index.js.src.html#l18">View Source</a></div><h1>module selenium-webdriver/io</h1><h2>Functions</h2><div id="copy" class="function"><div><h3>copy(<wbr>src, dst)<span class="codelink"><a href="source/io/index.js.src.html#l66">code »</a></span></h3><p>Copies one file to another.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>src<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The source file.</p>
+<dt>dst<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The destination file.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the copied file&#39;s path.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="copyDir" class="function"><div><h3>copyDir(<wbr>src, dst, opt_exclude)<span class="codelink"><a href="source/io/index.js.src.html#l94">code »</a></span></h3><p>Recursively copies the contents of one directory to another.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>src<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The source directory to copy.</p>
+<dt>dst<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The directory to copy into.</p>
+<dt>opt_exclude<code>?(RegEx|function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)=</code><dd><p>An exclusion filter
+as either a regex or predicate function. All files matching this filter
+will not be copied.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the destination
+directory&#39;s path once all files have been copied.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="exists" class="function"><div><h3>exists(<wbr>path)<span class="codelink"><a href="source/io/index.js.src.html#l142">code »</a></span></h3><p>Tests if a file path exists.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for whether the file exists.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findInPath" class="function"><div><h3>findInPath(<wbr>file, opt_checkCwd)<span class="codelink"><a href="source/io/index.js.src.html#l204">code »</a></span></h3><p>Searches the <code>PATH</code> environment variable for the given file.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>file<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The file to locate on the PATH.</p>
+<dt>opt_checkCwd<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd><p>Whether to always start with the search with
+the current working directory, regardless of whether it is explicitly
+listed on the PATH.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the located file, or <code>null</code> if it could
+not be found.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="rmDir" class="function"><div><h3>rmDir(<wbr>path)<span class="codelink"><a href="source/io/index.js.src.html#l38">code »</a></span></h3><p>Recursively removes a directory and all of its contents. This is equivalent
+to <code>rm -rf</code> on a POSIX system.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the directory to remove.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise to be resolved when the operation has
+completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="tmpDir" class="function"><div><h3>tmpDir()<span class="codelink"><a href="source/io/index.js.src.html#l175">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the path to a temporary
+directory.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="tmpFile" class="function"><div><h3>tmpFile(<wbr>opt_options)<span class="codelink"><a href="source/io/index.js.src.html#l186">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_options<code>{postfix: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}=</code><dd><p>Temporary file options.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for the path to a temporary
+file.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="unlink" class="function"><div><h3>unlink(<wbr>path)<span class="codelink"><a href="source/io/index.js.src.html#l155">code »</a></span></h3><p>Deletes a name from the filesystem and possibly the file it refers to. Has
+no effect if the file does not exist.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to remove.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for when the file has been removed.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_io_exec.html b/docs/module_selenium-webdriver_io_exec.html
new file mode 100644
index 0000000..db2facd
--- /dev/null
+++ b/docs/module_selenium-webdriver_io_exec.html
@@ -0,0 +1,6 @@
+<!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>selenium-webdriver/io/exec</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><div class="codelink"><a href="source/io/exec.js.src.html#l108">View Source</a></div><h1>module selenium-webdriver/io/exec</h1><p>Spawns a child process. The returned <code>Command</code> may be used to wait
+for the process result or to send signals to the process.</p>
+<h2>exec(<wbr>command, opt_options)</h2><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The executable to spawn.</p>
+<dt>opt_options<code>{args: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), env: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), stdio: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|Stream)&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}=</code><dd><p>The command options.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>$jscomp.scope.Command$1</code><dd><p>The launched command.</p>
+</dl></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_namespace_By.html b/docs/module_selenium-webdriver_namespace_By.html
new file mode 100644
index 0000000..e01e60b
--- /dev/null
+++ b/docs/module_selenium-webdriver_namespace_By.html
@@ -0,0 +1,56 @@
+<!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>By</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l42">View Source</a></div><h1>namespace By</h1><dl><dt>Alias for <code><a href="namespace_webdriver_By.html">webdriver.By</a></code></dl><p>A collection of factory functions for creating <a href="class_webdriver_Locator.html"><code>webdriver.Locator</code></a>
+instances.</p>
+<h2>Functions</h2><div id="className" class="function"><div><h3>className(<wbr>className)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l110">code »</a></span></h3><p>Locates elements that have a specific class name. The returned locator
+is equivalent to searching for elements with the CSS selector &#34;.clazz&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>className<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The class name to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="css" class="function"><div><h3>css(<wbr>selector)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l123">code »</a></span></h3><p>Locates elements using a CSS selector. For browsers that do not support
+CSS selectors, WebDriver implementations may return an
+<a href="enum_bot_Error_State.html#INVALID_SELECTOR">invalid selector</a> error. An
+implementation may, however, emulate the CSS selector API.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>selector<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The CSS selector to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="id" class="function"><div><h3>id(<wbr>id)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l132">code »</a></span></h3><p>Locates an element by its ID.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>id<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The ID to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="js" class="function"><div><h3>js(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l155">code »</a></span></h3><p>Locates an elements by evaluating a
+<a href="class_webdriver_WebDriver.html#executeScript">JavaScript expression</a>.
+The result of this expression must be an element or list of elements.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): <a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new,
+JavaScript-based locator function.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="linkText" class="function"><div><h3>linkText(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l142">code »</a></span></h3><p>Locates link elements whose <a href="class_webdriver_WebElement.html#getText">visible
+text</a> matches the given string.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The link text to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="name" class="function"><div><h3>name(<wbr>name)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l169">code »</a></span></h3><p>Locates elements whose <code>name</code> attribute has the given value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name attribute to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="partialLinkText" class="function"><div><h3>partialLinkText(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l179">code »</a></span></h3><p>Locates link elements whose <a href="class_webdriver_WebElement.html#getText">visible
+text</a> contains the given substring.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring to check for in a link&#39;s visible text.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="tagName" class="function"><div><h3>tagName(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l193">code »</a></span></h3><p>Locates elements with a given tag name. The returned locator is
+equivalent to using the
+<a href="https://developer.mozilla.org/en-US/docs/Web/API/Element.getElementsByTagName">getElementsByTagName</a>
+DOM function.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring to check for in a link&#39;s visible text.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="xpath" class="function"><div><h3>xpath(<wbr>xpath)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l208">code »</a></span></h3><p>Locates elements matching a XPath selector. Care should be taken when
+using an XPath selector with a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> as WebDriver
+will respect the context in the specified in the selector. For example,
+given the selector <code>&#34;//div&#34;</code>, WebDriver will search from the
+document root regardless of whether the locator was used with a
+WebElement.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>xpath<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The XPath selector to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><h2>Type Definitions</h2><div id="By.Hash" class="property"><dl><dt><a href="source/lib/webdriver/locators.js.src.html#l98">By.Hash</a><code>({className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>Short-hand expressions for the primary element locator strategies.
+For example the following two statements are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(webdriver.By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id: &#39;foo&#39;});
+</code></pre>
+<p>Care should be taken when using JavaScript minifiers (such as the
+Closure compiler), as locator hashes will always be parsed using
+the un-obfuscated properties listed.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_namespace_error.html b/docs/module_selenium-webdriver_namespace_error.html
new file mode 100644
index 0000000..0ce22a3
--- /dev/null
+++ b/docs/module_selenium-webdriver_namespace_error.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>error</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l116">View Source</a></div><h1>namespace error</h1><dl><dt>Alias for <code><a href="module_selenium-webdriver_error.html">module(selenium-webdriver/error)</a></code></dl><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_error_class_Error.html">Error</a><dd><p>Represents an error returned from a WebDriver command request.</p>
+<dt><a href="module_selenium-webdriver_error_enum_ErrorCode.html">ErrorCode</a><dd><p>Error codes from the Selenium WebDriver protocol:
+https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#response-status-codes</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_namespace_logging.html b/docs/module_selenium-webdriver_namespace_logging.html
new file mode 100644
index 0000000..20df9d6
--- /dev/null
+++ b/docs/module_selenium-webdriver_namespace_logging.html
@@ -0,0 +1,18 @@
+<!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>logging</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l128">View Source</a></div><h1>namespace logging</h1><dl><dt>Alias for <code><a href="namespace_webdriver_logging.html">webdriver.logging</a></code></dl><h2>Functions</h2><div id="addConsoleHandler" class="function"><div><h3>addConsoleHandler(<wbr>opt_logger)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l149">code »</a></span></h3><p>Adds the console handler to the given logger. The console handler will log
+all messages using the JavaScript Console API.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_logger<code>?<a href="class_webdriver_logging_Logger.html">webdriver.logging.Logger</a>=</code><dd><p>The logger to add the handler to; defaults
+to the root logger.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLevel" class="function"><div><h3>getLevel(<wbr>arg0)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l199">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arg0<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code></dl></div></div></div></div><hr class="fn-sep"><div id="getLogger" class="function"><div><h3>getLogger(<wbr>arg0)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l107">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arg0<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code></dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Logger.html">webdriver.logging.Logger</a></code></dl></div></div></div></div><hr class="fn-sep"><div id="installConsoleHandler" class="function"><div><h3>installConsoleHandler()<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l159">code »</a></span></h3><p>Installs the console log handler on the root logger.</p>
+</div></div><hr class="fn-sep"><div id="removeConsoleHandler" class="function"><div><h3>removeConsoleHandler(<wbr>opt_logger)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l171">code »</a></span></h3><p>Removes the console log handler from the given logger.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_logger<code>?<a href="class_webdriver_logging_Logger.html">webdriver.logging.Logger</a>=</code><dd><p>The logger to remove the handler from; defaults
+to the root logger.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_logging_Entry.html">Entry</a><dd><p>A single log entry recorded by a WebDriver component, such as a remote
+WebDriver server.</p>
+<dt><a href="class_webdriver_logging_Level.html">Level</a><dd><p>The Level class defines a set of standard logging levels that
+can be used to control logging output.</p>
+<dt><a href="class_webdriver_logging_LogRecord.html">LogRecord</a><dd><p>LogRecord objects are used to pass logging requests between
+the logging framework and individual log Handlers.</p>
+<dt><a href="class_webdriver_logging_Logger.html">Logger</a><dd><p>The Logger is an object used for logging debug messages.</p>
+<dt><a href="class_webdriver_logging_Preferences.html">Preferences</a><dd><p>Describes the log preferences for a WebDriver session.</p>
+<dt><a href="enum_webdriver_logging_Type.html">Type</a><dd><p>No description.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_namespace_promise.html b/docs/module_selenium-webdriver_namespace_promise.html
new file mode 100644
index 0000000..4415168
--- /dev/null
+++ b/docs/module_selenium-webdriver_namespace_promise.html
@@ -0,0 +1,163 @@
+<!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>promise</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l134">View Source</a></div><h1>namespace promise</h1><dl><dt>Alias for <code><a href="namespace_webdriver_promise.html">webdriver.promise</a></code></dl><h2>Functions</h2><div id="all" class="function"><div><h3><code>&lt;T&gt;</code> all(<wbr>arr)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1614">code »</a></span></h3><p>Given an array of promises, will return a promise that will be fulfilled
+with the fulfillment values of the input array&#39;s values. If any of the
+input array&#39;s promises are rejected, the returned promise will be rejected
+with the same reason.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;(T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)&gt;</code><dd><p>An array of
+promises to wait on.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;T&gt;&gt;</code><dd><p>A promise that is
+fulfilled with an array containing the fulfilled values of the
+input array, or rejected with the same reason as the first
+rejected value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="asap" class="function"><div><h3>asap(<wbr>value, callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1584">code »</a></span></h3><p>Invokes the appropriate callback function as soon as a promised
+<code>value</code> is resolved. This function is similar to
+<a href="namespace_webdriver_promise.html#when"><code>webdriver.promise.when</code></a>, except it does not return a new promise.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to observe.</p>
+<dt>callback<code>Function</code><dd><p>The function to call when the value is
+resolved successfully.</p>
+<dt>opt_errback<code>?Function=</code><dd><p>The function to call when the value is
+rejected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="captureStackTrace" class="function"><div><h3>captureStackTrace(<wbr>name, msg, topFn)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l675">code »</a></span></h3><p>Generates an error to capture the current stack trace.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Error name for this stack trace.</p>
+<dt>msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Message to record.</p>
+<dt>topFn<code>Function</code><dd><p>The function that should appear at the top of the
+stack; only applicable in V8.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The generated error.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="checkedNodeCall" class="function"><div><h3>checkedNodeCall(<wbr>fn, var_args)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1537">code »</a></span></h3><p>Wraps a function that expects a node-style callback as its final
+argument. This callback expects two arguments: an error value (which will be
+null if the call succeeded), and the success value as the second argument.
+The callback will the resolve or reject the returned promise, based on its arguments.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>Function</code><dd><p>The function to wrap.</p>
+<dt>var_args<code>...?</code><dd><p>The arguments to apply to the function, excluding the
+final callback.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved with the
+result of the provided function&#39;s callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="consume" class="function"><div><h3>consume(<wbr>generatorFn, opt_self, var_args)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l3001">code »</a></span></h3><p>Consumes a <code>GeneratorFunction</code>. Each time the generator yields a
+promise, this function will wait for it to be fulfilled before feeding the
+fulfilled value back into <code>next</code>. Likewise, if a yielded promise is
+rejected, the rejection error will be passed to <code>throw</code>.</p>
+<p><strong>Example 1:</strong> the Fibonacci Sequence.</p>
+<pre><code>promise.consume(function* fibonacci() {
+  var n1 &#61; 1, n2 &#61; 1;
+  for (var i &#61; 0; i &lt; 4; &#43;&#43;i) {
+    var tmp &#61; yield n1 &#43; n2;
+    n1 &#61; n2;
+    n2 &#61; tmp;
+  }
+  return n1 &#43; n2;
+}).then(function(result) {
+  console.log(result);  // 13
+});
+</code></pre>
+<p><strong>Example 2:</strong> a generator that throws.</p>
+<pre><code>promise.consume(function* () {
+  yield promise.delayed(250).then(function() {
+    throw Error(&#39;boom&#39;);
+  });
+}).thenCatch(function(e) {
+  console.log(e.toString());  // Error: boom
+});
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>generatorFn<code>Function</code><dd><p>The generator function to execute.</p>
+<dt>opt_self<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object to use as &#34;this&#34; when invoking the
+initial generator.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the initial generator.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;?&gt;</code><dd><p>A promise that will resolve to the
+generator&#39;s final result.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError">TypeError</a></code><dd><p>If the given function is not a generator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2930">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The currently active control flow.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="createFlow" class="function"><div><h3>createFlow(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2945">code »</a></span></h3><p>Creates a new control flow. The provided callback will be invoked as the
+first task within the new flow, with the flow as its sole argument. Returns
+a promise that resolves to the callback result.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>): ?</code><dd><p>The entry point
+to the newly created flow.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that resolves to the callback
+result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="defer" class="function"><div><h3><code>&lt;T&gt;</code> defer()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1488">code »</a></span></h3><p>Creates a new deferred object.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a>&lt;T&gt;</code><dd><p>The new deferred object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="delayed" class="function"><div><h3>delayed(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1468">code »</a></span></h3><p>Creates a promise that will be resolved at a set time in the future.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to wait before
+resolving the promise.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The promise.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="filter" class="function"><div><h3><code>&lt;TYPE, SELF&gt;</code> filter(<wbr>arr, fn, opt_self)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1718">code »</a></span></h3><p>Calls a function for each element in an array, and if the function returns
+true adds the element to a new array.</p>
+<p>If the return value of the filter function is a promise, this function
+will wait for it to be fulfilled before determining whether to insert the
+element into the new array.</p>
+<p>If the filter function throws or returns a rejected promise, the promise
+returned by this function will be rejected with the same reason. Only the
+first failure will be reported; all subsequent errors will be silently
+ignored.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arr<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;&gt;)</code><dd><p>The
+array to iterator over, or a promise that will resolve to said array.</p>
+<dt>fn<code>function(this: SELF, TYPE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;): ?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;)</code><dd><p>The function
+to call for each element in the array.</p>
+<dt>opt_self<code>?SELF=</code><dd><p>The object to be used as the value of &#39;this&#39; within
+<code>fn</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="fulfilled" class="function"><div><h3><code>&lt;T&gt;</code> fulfilled(<wbr>opt_value)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1499">code »</a></span></h3><p>Creates a promise that has been resolved with the given value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_value<code>?T=</code><dd><p>The resolved value.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>The resolved promise.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="fullyResolved" class="function"><div><h3>fullyResolved(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1773">code »</a></span></h3><p>Returns a promise that will be resolved with the input value in a
+fully-resolved state. If the value is an array, each element will be fully
+resolved. Likewise, if the value is an object, all keys will be fully
+resolved. In both cases, all nested arrays and objects will also be
+fully resolved.  All fields are resolved in place; the returned promise will
+resolve on <code>value</code> and not a copy.</p>
+<p>Warning: This function makes no checks against objects that contain
+cyclical references:</p>
+<pre><code>var value &#61; {};
+value[&#39;self&#39;] &#61; value;
+promise.fullyResolved(value);  // Stack overflow.
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to fully resolve.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for a fully resolved version
+of the input value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isGenerator" class="function"><div><h3>isGenerator(<wbr>fn)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2958">code »</a></span></h3><p>Tests is a function is a generator.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>Function</code><dd><p>The function to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the function is a generator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isPromise" class="function"><div><h3>isPromise(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1452">code »</a></span></h3><p>Determines whether a <code>value</code> should be treated as a promise.
+Any object whose &#34;then&#34; property is a function will be considered a promise.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the value is a promise.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="map" class="function"><div><h3><code>&lt;TYPE, SELF&gt;</code> map(<wbr>arr, fn, opt_self)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1662">code »</a></span></h3><p>Calls a function for each element in an array and inserts the result into a
+new array, which is used as the fulfillment value of the promise returned
+by this function.</p>
+<p>If the return value of the mapping function is a promise, this function
+will wait for it to be fulfilled before inserting it into the new array.</p>
+<p>If the mapping function throws or returns a rejected promise, the
+promise returned by this function will be rejected with the same reason.
+Only the first failure will be reported; all subsequent errors will be
+silently ignored.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arr<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;&gt;)</code><dd><p>The
+array to iterator over, or a promise that will resolve to said array.</p>
+<dt>fn<code>function(this: SELF, TYPE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;): ?</code><dd><p>The
+function to call for each element in the array. This function should
+expect three arguments (the element, the index, and the array itself.</p>
+<dt>opt_self<code>?SELF=</code><dd><p>The object to be used as the value of &#39;this&#39; within
+<code>fn</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="rejected" class="function"><div><h3><code>&lt;T&gt;</code> rejected(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1516">code »</a></span></h3><p>Creates a promise that has been rejected with the given reason.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>*=</code><dd><p>The rejection reason; may be any value, but is
+usually an Error or a string.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>The rejected promise.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setDefaultFlow" class="function"><div><h3>setDefaultFlow(<wbr>flow)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2919">code »</a></span></h3><p>Changes the default flow to use when no others are active.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>flow<code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The new default flow.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the default flow is not currently active.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="when" class="function"><div><h3>when(<wbr>value, opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1563">code »</a></span></h3><p>Registers an observer on a promised <code>value</code>, returning a new promise
+that will be resolved when the value is. If <code>value</code> is not a promise,
+then the return promise will be immediately resolved.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to observe.</p>
+<dt>opt_callback<code>?Function=</code><dd><p>The function to call when the value is
+resolved successfully.</p>
+<dt>opt_errback<code>?Function=</code><dd><p>The function to call when the value is
+rejected.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise.</p>
+</dl></div></div></div></div><h2>Compiler Constants</h2><div id="LONG_STACK_TRACES" class="property"><dl><dt><a href="source/lib/webdriver/promise.js.src.html#l634">LONG_STACK_TRACES</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to append traces of <code>then</code> to rejection
+errors.</p>
+</dl></div><h2>Types</h2><dl><dt><a href="class_webdriver_promise_CancellationError.html">CancellationError</a><dd><p>Error used when the computation of a promise is cancelled.</p>
+<dt><a href="class_webdriver_promise_ControlFlow.html">ControlFlow</a><dd><p>Handles the execution of scheduled tasks, each of which may be an
+asynchronous operation.</p>
+<dt><a href="class_webdriver_promise_Deferred.html">Deferred</a><dd><p>Represents a value that will be resolved at some point in the future.</p>
+<dt><a href="class_webdriver_promise_MultipleUnhandledRejectionError.html">MultipleUnhandledRejectionError</a><dd><p>Error used when there are multiple unhandled promise rejections detected
+within a task or callback.</p>
+<dt><a href="class_webdriver_promise_Promise.html">Promise</a><dd><p>Represents the eventual value of a completed operation.</p>
+<dt><a href="interface_webdriver_promise_Thenable.html">Thenable</a><dd><p>No description.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_namespace_stacktrace.html b/docs/module_selenium-webdriver_namespace_stacktrace.html
new file mode 100644
index 0000000..c947732
--- /dev/null
+++ b/docs/module_selenium-webdriver_namespace_stacktrace.html
@@ -0,0 +1,17 @@
+<!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>stacktrace</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l140">View Source</a></div><h1>namespace stacktrace</h1><dl><dt>Alias for <code><a href="namespace_webdriver_stacktrace.html">webdriver.stacktrace</a></code></dl><h2>Functions</h2><div id="format" class="function"><div><h3>format(<wbr>error)<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l552">code »</a></span></h3><p>Formats an error&#39;s stack trace.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>error<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The error to format.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The formatted error.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l617">code »</a></span></h3><p>Gets the native stack trace if available otherwise follows the call chain.
+The generated trace will exclude all frames up to and including the call to
+this function.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_stacktrace_Frame.html">webdriver.stacktrace.Frame</a>&gt;</code><dd><p>The frames of the stack trace.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getStack" class="function"><div><h3>getStack(<wbr>error)<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l534">code »</a></span></h3><p>Get an error&#39;s stack trace with the error string trimmed.
+V8 prepends the string representation of an error to its stack trace.
+This function trims the string so that the stack trace can be parsed
+consistently with the other JS engines.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>error<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The error.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The stack trace string.</p>
+</dl></div></div></div></div><h2>Properties</h2><div id="BROWSER_SUPPORTED" class="property"><dl><dt><a href="source/lib/webdriver/stacktrace.js.src.html#l87">BROWSER_SUPPORTED</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current browser supports stack traces.</p>
+</dl></div><h2>Types</h2><dl><dt><a href="class_webdriver_stacktrace_Frame.html">Frame</a><dd><p>Class representing one stack frame.</p>
+<dt><a href="class_webdriver_stacktrace_Snapshot.html">Snapshot</a><dd><p>Stores a snapshot of the stack trace at the time this instance was created.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_namespace_until.html b/docs/module_selenium-webdriver_namespace_until.html
new file mode 100644
index 0000000..c42c0fb
--- /dev/null
+++ b/docs/module_selenium-webdriver_namespace_until.html
@@ -0,0 +1,82 @@
+<!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>until</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver.html">selenium-webdriver</a></div><div class="codelink"><a href="source/index.js.src.html#l146">View Source</a></div><h1>namespace until</h1><dl><dt>Alias for <code><a href="namespace_webdriver_until.html">webdriver.until</a></code></dl><h2>Functions</h2><div id="ableToSwitchToFrame" class="function"><div><h3>ableToSwitchToFrame(<wbr>frame)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l103">code »</a></span></h3><p>Creates a condition that will wait until the input driver is able to switch
+to the designated frame. The target frame may be specified as</p>
+<ol><li>a numeric index into
+<a href="https://developer.mozilla.org/en-US/docs/Web/API/Window.frames">window.frames</a>
+for the currently selected frame.</li><li>a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, which must reference a FRAME or IFRAME
+element on the current page.</li><li>a locator which may be used to first locate a FRAME or IFRAME on the
+current page before attempting to switch to it.</li></ol>
+<p>Upon successful resolution of this condition, the driver will be left
+focused on the new frame.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>frame<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The frame identifier.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="alertIsPresent" class="function"><div><h3>alertIsPresent()<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l139">code »</a></span></h3><p>Creates a condition that waits for an alert to be opened. Upon success, the
+returned promise will be fulfilled with the handle for the opened alert.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="class_webdriver_Alert.html">webdriver.Alert</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsDisabled" class="function"><div><h3>elementIsDisabled(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l319">code »</a></span></h3><p>Creates a condition that will wait for the given element to be disabled.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsEnabled" class="function"><div><h3>elementIsEnabled(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l305">code »</a></span></h3><p>Creates a condition that will wait for the given element to be enabled.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsNotSelected" class="function"><div><h3>elementIsNotSelected(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l348">code »</a></span></h3><p>Creates a condition that will wait for the given element to be deselected.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsNotVisible" class="function"><div><h3>elementIsNotVisible(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l289">code »</a></span></h3><p>Creates a condition that will wait for the given element to be in the DOM,
+yet not visible to the user.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsSelected" class="function"><div><h3>elementIsSelected(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l334">code »</a></span></h3><p>Creates a condition that will wait for the given element to be selected.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsVisible" class="function"><div><h3>elementIsVisible(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l274">code »</a></span></h3><p>Creates a condition that will wait for the given element to become visible.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementLocated" class="function"><div><h3>elementLocated(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l211">code »</a></span></h3><p>Creates a condition that will loop until an element is
+<a href="class_webdriver_WebDriver.html#findElement"><code>found</code></a> with the given locator.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementTextContains" class="function"><div><h3>elementTextContains(<wbr>element, substr)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l386">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
+<a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to contain the given
+substring.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+<dt>substr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementTextIs" class="function"><div><h3>elementTextIs(<wbr>element, text)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l367">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
+<a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to match the given
+<code>text</code> exactly.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+<dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected text.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementTextMatches" class="function"><div><h3>elementTextMatches(<wbr>element, regex)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l405">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
+<a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to match a regular
+expression.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+<dt>regex<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp">RegExp</a></code><dd><p>The regular expression to test against.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementsLocated" class="function"><div><h3>elementsLocated(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l232">code »</a></span></h3><p>Creates a condition that will loop until at least one element is
+<a href="class_webdriver_WebDriver.html#findElement"><code>found</code></a> with the given locator.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>The new
+condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="stalenessOf" class="function"><div><h3>stalenessOf(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l253">code »</a></span></h3><p>Creates a condition that will wait for the given element to become stale. An
+element is considered stale once it is removed from the DOM, or a new page
+has loaded.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element that should become stale.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="titleContains" class="function"><div><h3>titleContains(<wbr>substr)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l176">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to contain
+the given substring.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>substr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring that should be present in the page
+title.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="titleIs" class="function"><div><h3>titleIs(<wbr>title)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l157">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to match the
+given value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>title<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected page title.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="titleMatches" class="function"><div><h3>titleMatches(<wbr>regex)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l194">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to match the
+given regular expression.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>regex<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp">RegExp</a></code><dd><p>The regular expression to test against.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_until_Condition.html">Condition</a><dd><p>Defines a condition to</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_net.html b/docs/module_selenium-webdriver_net.html
index 128d586..bef67ce 100644
--- a/docs/module_selenium-webdriver_net.html
+++ b/docs/module_selenium-webdriver_net.html
@@ -1 +1,7 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/net</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/net</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/net/index.js.src.html">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/net/index.js.src.html#l67">code &raquo;</a><span class="member"><a name="getAddress">getAddress</a> <span class="args">( opt_family )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the external IP address for this host.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_family: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The IP family to retrieve. Defaults to "IPv4".</dl><tr><th>Returns<tr><td><dl>The IP address or undefined if not available.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/net/index.js.src.html#l77">code &raquo;</a><span class="member"><a name="getLoopbackAddress">getLoopbackAddress</a> <span class="args">( opt_family )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves a loopback address for this machine.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_family: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The IP family to retrieve. Defaults to "IPv4".</dl><tr><th>Returns<tr><td><dl>The IP address or undefined if not available.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/net</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><div class="codelink"><a href="source/net/index.js.src.html#l18">View Source</a></div><h1>module selenium-webdriver/net</h1><h2>Functions</h2><div id="getAddress" class="function"><div><h3>getAddress(<wbr>opt_family)<span class="codelink"><a href="source/net/index.js.src.html#l70">code »</a></span></h3><p>Retrieves the external IP address for this host.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_family<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The IP family to retrieve. Defaults to &#34;IPv4&#34;.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The IP address or undefined if not available.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLoopbackAddress" class="function"><div><h3>getLoopbackAddress(<wbr>opt_family)<span class="codelink"><a href="source/net/index.js.src.html#l80">code »</a></span></h3><p>Retrieves a loopback address for this machine.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_family<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The IP family to retrieve. Defaults to &#34;IPv4&#34;.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The IP address or undefined if not available.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_net_portprober.html b/docs/module_selenium-webdriver_net_portprober.html
index 0ae96a6..ba82679 100644
--- a/docs/module_selenium-webdriver_net_portprober.html
+++ b/docs/module_selenium-webdriver_net_portprober.html
@@ -1,6 +1,12 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/net/portprober</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/net/portprober</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/net/portprober.js.src.html">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/net/portprober.js.src.html#l212">code &raquo;</a><span class="member"><a name="findFreePort">findFreePort</a> <span class="args">( opt_host )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_host: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The bound host to test the <code >port</code> against.
-     Defaults to <code >INADDR_ANY</code>.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve
-     to a free port. If a port cannot be found, the promise will be
-     rejected.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/net/portprober.js.src.html#l213">code &raquo;</a><span class="member"><a name="isFree">isFree</a> <span class="args">( port, opt_host )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code></span></div><p>Tests if a port is free.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>port: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The port to test.<dt>opt_host: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The bound host to test the <code >port</code> against.
-     Defaults to <code >INADDR_ANY</code>.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve
-     with whether the port is free.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/net/portprober</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><div class="codelink"><a href="source/net/portprober.js.src.html#l18">View Source</a></div><h1>module selenium-webdriver/net/portprober</h1><h2>Functions</h2><div id="findFreePort" class="function"><div><h3>findFreePort(<wbr>opt_host)<span class="codelink"><a href="source/net/portprober.js.src.html#l214">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_host<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The bound host to test the <code>port</code> against.
+Defaults to <code>INADDR_ANY</code>.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code><dd><p>A promise that will resolve
+to a free port. If a port cannot be found, the promise will be
+rejected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isFree" class="function"><div><h3>isFree(<wbr>port, opt_host)<span class="codelink"><a href="source/net/portprober.js.src.html#l215">code »</a></span></h3><p>Tests if a port is free.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>port<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The port to test.</p>
+<dt>opt_host<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The bound host to test the <code>port</code> against.
+Defaults to <code>INADDR_ANY</code>.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the port is free.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_opera.html b/docs/module_selenium-webdriver_opera.html
new file mode 100644
index 0000000..0a3a33b
--- /dev/null
+++ b/docs/module_selenium-webdriver_opera.html
@@ -0,0 +1,62 @@
+<!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>selenium-webdriver/opera</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><div class="codelink"><a href="source/opera.js.src.html#l73">View Source</a></div><h1>module selenium-webdriver/opera</h1><p>Defines a <a href="module_selenium-webdriver_opera_class_Driver.html">WebDriver</a> client for the
+Opera web browser (v26&#43;). Before using this module, you must download the
+latest OperaDriver
+<a href="https://github.com/operasoftware/operachromiumdriver/releases">release</a> and
+ensure it can be found on your system
+<a href="http://en.wikipedia.org/wiki/PATH_%28variable%29">PATH</a>.</p>
+<p>There are three primary classes exported by this module:</p>
+<ol><li>
+<p><a href="module_selenium-webdriver_opera_class_ServiceBuilder.html">ServiceBuilder</a>: configures the
+<a href="module_selenium-webdriver_remote_class_DriverService.html"><code>remote.DriverService</code></a>
+that manages the
+<a href="https://github.com/operasoftware/operachromiumdriver">OperaDriver</a>
+child process.</p>
+</li><li>
+<p><a href="module_selenium-webdriver_opera_class_Options.html">Options</a>: defines configuration options for each new Opera
+session, such as which <a href="module_selenium-webdriver_opera_class_Options.html#setProxy">proxy</a> to use,
+what <a href="module_selenium-webdriver_opera_class_Options.html#addExtensions">extensions</a> to install, or
+what <a href="module_selenium-webdriver_opera_class_Options.html#addArguments">command-line switches</a> to use when
+starting the browser.</p>
+</li><li>
+<p><a href="module_selenium-webdriver_opera_class_Driver.html">Driver</a>: the WebDriver client; each new instance will control
+a unique browser session with a clean user profile (unless otherwise
+configured through the <a href="module_selenium-webdriver_opera_class_Options.html"><code>Options</code></a> class).</p>
+</li></ol>
+<p>By default, every Opera session will use a single driver service, which is
+started the first time a <a href="module_selenium-webdriver_opera_class_Driver.html"><code>Driver</code></a> instance is created and terminated
+when this process exits. The default service will inherit its environment
+from the current process and direct all output to /dev/null. You may obtain
+a handle to this default service using
+<a href="module_selenium-webdriver_opera.html#getDefaultService"><code>getDefaultService()</code></a> and change its configuration
+with <a href="module_selenium-webdriver_opera.html#setDefaultService"><code>setDefaultService()</code></a>.</p>
+<p>You may also create a <a href="module_selenium-webdriver_opera_class_Driver.html"><code>Driver</code></a> with its own driver service. This is
+useful if you need to capture the server&#39;s log output for a specific session:</p>
+<pre><code>var opera &#61; require(&#39;selenium-webdriver/opera&#39;);
+
+var service &#61; new opera.ServiceBuilder()
+    .loggingTo(&#39;/my/log/file.txt&#39;)
+    .enableVerboseLogging()
+    .build();
+
+var options &#61; new opera.Options();
+// configure browser options ...
+
+var driver &#61; new opera.Driver(options, service);
+</code></pre>
+<p>Users should only instantiate the <a href="module_selenium-webdriver_opera_class_Driver.html"><code>Driver</code></a> class directly when they
+need a custom driver service configuration (as shown above). For normal
+operation, users should start Opera using the
+<a href="module_selenium-webdriver_class_Builder.html"><code>selenium-webdriver.Builder</code></a>.</p>
+<h2>Functions</h2><div id="getDefaultService" class="function"><div><h3>getDefaultService()<span class="codelink"><a href="source/opera.js.src.html#l498">code »</a></span></h3><p>Returns the default OperaDriver service. If such a service has not been
+configured, one will be constructed using the default configuration for
+a OperaDriver executable found on the system PATH.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a></code><dd><p>The default OperaDriver service.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setDefaultService" class="function"><div><h3>setDefaultService(<wbr>service)<span class="codelink"><a href="source/opera.js.src.html#l499">code »</a></span></h3><p>Sets the default service to use for new OperaDriver instances.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>service<code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a></code><dd><p>The service to use.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the default service is currently running.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_opera_class_Driver.html">Driver</a><dd><p>Creates a new WebDriver client for Opera.</p>
+<dt><a href="module_selenium-webdriver_opera_class_Options.html">Options</a><dd><p>Class for managing <a href="module_selenium-webdriver_opera_class_Driver.html"><code>OperaDriver</code></a> specific options.</p>
+<dt><a href="module_selenium-webdriver_opera_class_ServiceBuilder.html">ServiceBuilder</a><dd><p>Creates <code>remote.DriverService</code> instances that manages an
+<a href="https://github.com/operasoftware/operachromiumdriver">OperaDriver</a>
+server in a child process.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_opera_class_Driver.html b/docs/module_selenium-webdriver_opera_class_Driver.html
new file mode 100644
index 0000000..a559e32
--- /dev/null
+++ b/docs/module_selenium-webdriver_opera_class_Driver.html
@@ -0,0 +1,276 @@
+<!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>Driver</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_opera.html">selenium-webdriver/opera</a></div><div class="codelink"><a href="source/opera.js.src.html#l495">View Source</a></div><h1>class Driver</h1><pre class="inheritance"><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>
+  &#x2514; Driver</pre><p>Creates a new WebDriver client for Opera.</p>
+<h3>new Driver(<wbr>opt_config, opt_service, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_config<code>?(<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>|<a href="module_selenium-webdriver_opera_class_Options.html">Options</a>)=</code><dd><p>The configuration
+options.</p>
+<dt>opt_service<code>?<a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a>=</code><dd><p>The session to use; will use
+the <code>default service</code> by default.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow to use, or
+<code>null</code> to use the currently active flow.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="actions" class="function"><div><h3>actions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l469">code »</a></span></h3><p>Creates a new action sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_ActionSequence.html#perform"><code>webdriver.ActionSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.actions().
+    mouseDown(element1).
+    mouseMove(element2).
+    mouseUp().
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#actions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A new action sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="call" class="function"><div><h3><code>&lt;T&gt;</code> call(<wbr>fn, opt_scope, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l639">code »</a></span></h3><p>Schedules a command to execute a custom function.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#call">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(...?): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+execute.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to execute the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved&#39;
+with the function&#39;s result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="close" class="function"><div><h3>close()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l780">code »</a></span></h3><p>Schedules a command to close the current window.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#close">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l324">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#controlFlow">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow used by this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeAsyncScript" class="function"><div><h3><code>&lt;T&gt;</code> executeAsyncScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l617">code »</a></span></h3><p>Schedules a command to execute asynchronous JavaScript in the context of the
+currently selected frame or window. The script fragment will be executed as
+the body of an anonymous function. If the script is provided as a function
+object, that function will be converted to a string for injection into the
+target window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>Unlike executing synchronous JavaScript with <a href="module_selenium-webdriver_opera_class_Driver.html#executeScript"><code>#executeScript</code></a>,
+scripts executed with this function must explicitly signal they are finished
+by invoking the provided callback. This callback will always be injected
+into the executed function as the last argument, and thus may be referenced
+with <code>arguments[arguments.length - 1]</code>. The following steps will be
+taken for resolving this functions return value against the first argument
+to the script&#39;s callback function:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><strong>Example #1:</strong> Performing a sleep that is synchronized with the currently
+selected window:</p>
+<pre><code>var start &#61; new Date().getTime();
+driver.executeAsyncScript(
+    &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).
+    then(function() {
+      console.log(
+          &#39;Elapsed time: &#39; &#43; (new Date().getTime() - start) &#43; &#39; ms&#39;);
+    });
+</code></pre>
+<p><strong>Example #2:</strong> Synchronizing a test with an AJAX application:</p>
+<pre><code>var button &#61; driver.findElement(By.id(&#39;compose-button&#39;));
+button.click();
+driver.executeAsyncScript(
+    &#39;var callback &#61; arguments[arguments.length - 1];&#39; &#43;
+    &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);
+driver.switchTo().frame(&#39;composeWidget&#39;);
+driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog&#64;example.com&#39;);
+</code></pre>
+<p><strong>Example #3:</strong> Injecting a XMLHttpRequest and waiting for the result. In
+this example, the inject script is specified with a function literal. When
+using this format, the function is converted to a string for injection, so it
+should not reference any symbols not defined in the scope of the page under
+test.</p>
+<pre><code>driver.executeAsyncScript(function() {
+  var callback &#61; arguments[arguments.length - 1];
+  var xhr &#61; new XMLHttpRequest();
+  xhr.open(&#34;GET&#34;, &#34;/resource/data.json&#34;, true);
+  xhr.onreadystatechange &#61; function() {
+    if (xhr.readyState &#61;&#61; 4) {
+      callback(xhr.responseText);
+    }
+  }
+  xhr.send(&#39;&#39;);
+}).then(function(str) {
+  console.log(JSON.parse(str)[&#39;food&#39;]);
+});
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeAsyncScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeScript" class="function"><div><h3><code>&lt;T&gt;</code> executeScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l528">code »</a></span></h3><p>Schedules a command to execute JavaScript in the context of the currently
+selected frame or window. The script fragment will be executed as the body
+of an anonymous function. If the script is provided as a function object,
+that function will be converted to a string for injection into the target
+window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>The script may refer to any variables accessible from the current window.
+Furthermore, the script will execute in the window&#39;s context, thus
+<code>document</code> may be used to refer to the current document. Any local
+variables will not be available once the script has finished executing,
+though global variables will persist.</p>
+<p>If the script has a return value (i.e. if the script contains a return
+statement), then the following steps will be taken for resolving this
+functions return value:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l867">code »</a></span></h3><p>Schedule a command to find an element on the page. If the element cannot be
+found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will be returned
+by the driver. Unlike other commands, this error cannot be suppressed. In
+other words, scheduling a command to find an element doubles as an assert
+that the element is present on the page. To test whether an element is
+present on the page, use <a href="module_selenium-webdriver_opera_class_Driver.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; driver.findElement(firstVisibleLink);
+
+function firstVisibleLink(driver) {
+  var links &#61; driver.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p>When running in the browser, a WebDriver cannot manipulate DOM elements
+directly; it may do so only through a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> reference.
+This function may be used to generate a WebElement from a DOM element. A
+reference to the DOM element will be stored in a known location and this
+driver will attempt to retrieve it through <a href="module_selenium-webdriver_opera_class_Driver.html#executeScript"><code>#executeScript</code></a>. If the
+element cannot be found (eg, it belongs to a different document than the
+one this instance is currently focused on), a
+<a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error will be returned.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElement">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l994">code »</a></span></h3><p>Schedule a command to search for multiple elements on the page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElements">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l792">code »</a></span></h3><p>Schedules a command to navigate to the given URL.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#get">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The fully qualified URL to open.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the document has finished loading.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAllWindowHandles" class="function"><div><h3>getAllWindowHandles()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l753">code »</a></span></h3><p>Schedules a command to retrieve the current list of available window handles.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getAllWindowHandles">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;&gt;</code><dd><p>A promise that will
+be resolved with an array of window handles.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l430">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCapabilities">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>&gt;</code><dd><p>A promise
+that will resolve with the this instance&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCurrentUrl" class="function"><div><h3>getCurrentUrl()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l802">code »</a></span></h3><p>Schedules a command to retrieve the URL of the current page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCurrentUrl">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current URL.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPageSource" class="function"><div><h3>getPageSource()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l768">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s source. The page source
+returned is a representation of the underlying DOM: do not expect it to be
+formatted or escaped in the same way as the response sent from the web
+server.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getPageSource">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page source.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSession" class="function"><div><h3>getSession()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l421">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getSession">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Session.html">webdriver.Session</a>&gt;</code><dd><p>A promise for this
+client&#39;s session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTitle" class="function"><div><h3>getTitle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l814">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s title.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getTitle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page&#39;s title.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWindowHandle" class="function"><div><h3>getWindowHandle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l741">code »</a></span></h3><p>Schedules a command to retrieve they current window handle.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getWindowHandle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current window handle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locatorOrElement)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l974">code »</a></span></h3><p>Schedules a command to test if an element is present on the page.</p>
+<p>If given a DOM element, this function will check if it belongs to the
+document the driver is currently focused on. Otherwise, the function will
+test if at least one element can be found with the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#isElementPresent">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locatorOrElement<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator to use, or the actual
+DOM element to be located by the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the element is present on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manage" class="function"><div><h3>manage()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1056">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#manage">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code><dd><p>The options interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="navigate" class="function"><div><h3>navigate()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1065">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#navigate">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code><dd><p>The navigation interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="quit" class="function"><div><h3>quit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l444">code »</a></span></h3><p>Schedules a command to quit the current session. After calling quit, this
+instance will be invalidated and may no longer be used to issue commands
+against the browser.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#quit">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="schedule" class="function"><div><h3><code>&lt;T&gt;</code> schedule(<wbr>command, description)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l338">code »</a></span></h3><p>Schedules a <code>webdriver.Command</code> to be executed by this driver&#39;s
+<code>webdriver.CommandExecutor</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#schedule">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to schedule.</p>
+<dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of the command for debugging.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the command result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFileDetector" class="function"><div><h3>setFileDetector(<wbr>detector)<span class="codelink"><a href="source/opera.js.src.html#l488">code »</a></span></h3><p>This function is a no-op as file detectors are not supported by this
+implementation.</p>
+<p><b>Overrides: </b><a href="class_webdriver_WebDriver.html#setFileDetector">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detector<code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code><dd><p>The detector to use or <code>null</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sleep" class="function"><div><h3>sleep(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l731">code »</a></span></h3><p>Schedules a command to make the driver sleep for the given amount of time.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#sleep">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to sleep.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the sleep has finished.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="switchTo" class="function"><div><h3>switchTo()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1074">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#switchTo">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code><dd><p>The target locator interface for
+this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="takeScreenshot" class="function"><div><h3>takeScreenshot()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1046">code »</a></span></h3><p>Schedule a command to take a screenshot. The driver makes a best effort to
+return a screenshot of the following, in order of preference:</p>
+<ol><li>Entire page
+  </li><li>Current window
+  </li><li>Visible portion of the current frame
+  </li><li>The screenshot of the entire display containing the browser
+</li></ol>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#takeScreenshot">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the screenshot as a base-64 encoded PNG.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="touchActions" class="function"><div><h3>touchActions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l486">code »</a></span></h3><p>Creates a new touch sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_TouchSequence.html#perform"><code>webdriver.TouchSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.touchActions().
+    tap(element1).
+    doubleTap(element2).
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#touchActions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A new touch sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l700">code »</a></span></h3><p>Schedules a command to wait for a condition to hold. The condition may be
+specified by a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a>, as a custom function, or
+as a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>.</p>
+<p>For a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a> or function, the wait will repeatedly
+evaluate the condition until it returns a truthy value. If any errors occur
+while evaluating the condition, they will be allowed to propagate. In the
+event a condition returns a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>, the
+polling loop will wait for it to be resolved and use the resolved value for
+whether the condition has been satisified. Note the resolution time for
+a promise is factored into whether a wait has timed out.</p>
+<p><em>Example:</em> waiting up to 10 seconds for an element to be present and visible
+on the page.</p>
+<pre><code>var button &#61; driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);
+button.click();
+</code></pre>
+<p>This function may also be used to block the command flow on the resolution
+of a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>. When given a promise, the
+command will simply wait for its resolution before completing. A timeout may
+be provided to fail the command if the promise does not resolve before the
+timeout expires.</p>
+<p><em>Example:</em> Suppose you have a function, <code>startTestServer</code>, that returns a
+promise for when a server is ready for requests. You can block a <code>WebDriver</code>
+client on this promise with:</p>
+<pre><code>var started &#61; startTestServer();
+driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);
+driver.get(getServerUrl());
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#wait">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|<a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;T&gt;|function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): T)</code><dd><p>The condition to
+wait on, defined as a promise, condition object, or  a function to
+evaluate as a condition.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait for the condition to be true.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional message to use if the wait times
+out.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+with the first truthy value returned by the condition function, or
+rejected if the condition times out.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_opera_class_Options.html b/docs/module_selenium-webdriver_opera_class_Options.html
new file mode 100644
index 0000000..c325dbd
--- /dev/null
+++ b/docs/module_selenium-webdriver_opera_class_Options.html
@@ -0,0 +1,44 @@
+<!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>Options</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_opera.html">selenium-webdriver/opera</a></div><div class="codelink"><a href="source/opera.js.src.html#l496">View Source</a></div><h1>class Options</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>
+  &#x2514; Options</pre><p>Class for managing <a href="module_selenium-webdriver_opera_class_Driver.html"><code>OperaDriver</code></a> specific options.</p>
+<h3>new Options()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="addArguments" class="function"><div><h3>addArguments(<wbr>var_args)<span class="codelink"><a href="source/opera.js.src.html#l332">code »</a></span></h3><p>Add additional command line arguments to use when launching the Opera
+browser.  Each argument may be specified with or without the &#34;--&#34; prefix
+(e.g. &#34;--foo&#34; and &#34;foo&#34;). Arguments with an associated value should be
+delimited by an &#34;&#61;&#34;: &#34;foo&#61;bar&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;)</code><dd><p>The arguments to add.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="addExtensions" class="function"><div><h3>addExtensions(<wbr>var_args)<span class="codelink"><a href="source/opera.js.src.html#l346">code »</a></span></h3><p>Add additional extensions to install when launching Opera. Each extension
+should be specified as the path to the packed CRX file, or a Buffer for an
+extension.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>var_args<code>...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Buffer|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Buffer)&gt;)</code><dd><p>The
+extensions to add.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/opera.js.src.html#l419">code »</a></span></h3><p>Converts this instance to its JSON wire protocol representation. Note this
+function is an implementation not intended for general use.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>(T|IThenable&lt;T&gt;)</code><dd><blockquote>
+<p>,
+localState: (Object|undefined),
+logPath: (string|undefined),
+prefs: (Object|undefined)}} The JSON wire protocol representation
+of this instance.</p>
+</blockquote>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPrefs" class="function"><div><h3>setLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/opera.js.src.html#l373">code »</a></span></h3><p>Sets the logging preferences for the new session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code><a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a></code><dd><p>The logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setOperaBinaryPath" class="function"><div><h3>setOperaBinaryPath(<wbr>path)<span class="codelink"><a href="source/opera.js.src.html#l362">code »</a></span></h3><p>Sets the path to the Opera binary to use. On Mac OS X, this path should
+reference the actual Opera executable, not just the application binary. The
+binary path be absolute or relative to the operadriver server executable, but
+it must exist on the machine that will launch Opera.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to the Opera binary to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setProxy" class="function"><div><h3>setProxy(<wbr>proxy)<span class="codelink"><a href="source/opera.js.src.html#l384">code »</a></span></h3><p>Sets the proxy settings for the new session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>proxy<code><a href="module_selenium-webdriver.html">selenium-webdriver.ProxyConfig</a></code><dd><p>The proxy configuration to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toCapabilities" class="function"><div><h3>toCapabilities(<wbr>opt_capabilities)<span class="codelink"><a href="source/opera.js.src.html#l396">code »</a></span></h3><p>Converts this options instance to a <a href="class_webdriver_Capabilities.html"><code>webdriver.Capabilities</code></a> object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_capabilities<code>?<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>=</code><dd><p>The capabilities to merge
+these options into, if any.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The capabilities.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="Options.fromCapabilities" class="function"><div><h3>Options.fromCapabilities(<wbr>capabilities)<span class="codelink"><a href="source/opera.js.src.html#l297">code »</a></span></h3><p>Extracts the OperaDriver specific options from the given capabilities
+object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>capabilities<code><a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a></code><dd><p>The capabilities object.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_Options.html">Options</a></code><dd><p>The OperaDriver options.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html b/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html
new file mode 100644
index 0000000..12b209b
--- /dev/null
+++ b/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html
@@ -0,0 +1,35 @@
+<!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>ServiceBuilder</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_opera.html">selenium-webdriver/opera</a></div><div class="codelink"><a href="source/opera.js.src.html#l497">View Source</a></div><h1>class ServiceBuilder</h1><p>Creates <code>remote.DriverService</code> instances that manages an
+<a href="https://github.com/operasoftware/operachromiumdriver">OperaDriver</a>
+server in a child process.</p>
+<h3>new ServiceBuilder(<wbr>opt_exe)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_exe<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>Path to the server executable to use. If omitted,
+the builder will attempt to locate the operadriver on the current
+PATH.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If provided executable does not exist, or the operadriver
+cannot be found on the PATH.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="build" class="function"><div><h3>build()<span class="codelink"><a href="source/opera.js.src.html#l218">code »</a></span></h3><p>Creates a new DriverService using this instance&#39;s current configuration.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a></code><dd><p>A new driver service using this instance&#39;s
+current configuration.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the driver exectuable was not specified and a default
+could not be found on the current PATH.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="enableVerboseLogging" class="function"><div><h3>enableVerboseLogging()<span class="codelink"><a href="source/opera.js.src.html#l170">code »</a></span></h3><p>Enables verbose logging.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="loggingTo" class="function"><div><h3>loggingTo(<wbr>path)<span class="codelink"><a href="source/opera.js.src.html#l160">code »</a></span></h3><p>Sets the path of the log file the driver should log to. If a log file is
+not specified, the driver will log to stderr.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path of the log file to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setStdio" class="function"><div><h3>setStdio(<wbr>config)<span class="codelink"><a href="source/opera.js.src.html#l193">code »</a></span></h3><p>Defines the stdio configuration for the driver service. See
+<code>child_process.spawn</code> for more information.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>config<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|Stream)&gt;)</code><dd><p>The
+configuration to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="silent" class="function"><div><h3>silent()<span class="codelink"><a href="source/opera.js.src.html#l180">code »</a></span></h3><p>Silence sthe drivers output.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="usingPort" class="function"><div><h3>usingPort(<wbr>port)<span class="codelink"><a href="source/opera.js.src.html#l145">code »</a></span></h3><p>Sets the port to start the OperaDriver on.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>port<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The port to use, or 0 for any free port.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the port is invalid.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="withEnvironment" class="function"><div><h3>withEnvironment(<wbr>env)<span class="codelink"><a href="source/opera.js.src.html#l205">code »</a></span></h3><p>Defines the environment to start the server under. This settings will be
+inherited by every browser session started by the server.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>env<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>The environment to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_opera_class_ServiceBuilder.html">ServiceBuilder</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_phantomjs.html b/docs/module_selenium-webdriver_phantomjs.html
index a4fd791..a43f7d7 100644
--- a/docs/module_selenium-webdriver_phantomjs.html
+++ b/docs/module_selenium-webdriver_phantomjs.html
@@ -1 +1,2 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/phantomjs</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/phantomjs</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/phantomjs.js.src.html">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/phantomjs.js.src.html#l164">code &raquo;</a><span class="member"><a name="createDriver">createDriver</a> <span class="args">( opt_capabilities )</span> &rArr; <code class="type">!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code></span></div><p>Creates a new PhantomJS WebDriver client.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_capabilities: <code class="type"><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>=</code><dd>The desired capabilities.</dl><tr><th>Returns<tr><td><dl>A new WebDriver instance.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/phantomjs</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><div class="codelink"><a href="source/phantomjs.js.src.html#l18">View Source</a></div><h1>module selenium-webdriver/phantomjs</h1><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_phantomjs_class_Driver.html">Driver</a><dd><p>Creates a new WebDriver client for PhantomJS.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_phantomjs_class_Driver.html b/docs/module_selenium-webdriver_phantomjs_class_Driver.html
new file mode 100644
index 0000000..69b5e42
--- /dev/null
+++ b/docs/module_selenium-webdriver_phantomjs_class_Driver.html
@@ -0,0 +1,299 @@
+<!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>Driver</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_phantomjs.html">selenium-webdriver/phantomjs</a></div><div class="codelink"><a href="source/phantomjs.js.src.html#l265">View Source</a></div><h1>class Driver</h1><pre class="inheritance"><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>
+  &#x2514; Driver</pre><p>Creates a new WebDriver client for PhantomJS.</p>
+<h3>new Driver(<wbr>opt_capabilities, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_capabilities<code>?<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>=</code><dd><p>The desired capabilities.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow to use, or
+<code>null</code> to use the currently active flow.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="actions" class="function"><div><h3>actions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l469">code »</a></span></h3><p>Creates a new action sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_ActionSequence.html#perform"><code>webdriver.ActionSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.actions().
+    mouseDown(element1).
+    mouseMove(element2).
+    mouseUp().
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#actions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A new action sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="call" class="function"><div><h3><code>&lt;T&gt;</code> call(<wbr>fn, opt_scope, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l639">code »</a></span></h3><p>Schedules a command to execute a custom function.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#call">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(...?): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+execute.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to execute the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved&#39;
+with the function&#39;s result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="close" class="function"><div><h3>close()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l780">code »</a></span></h3><p>Schedules a command to close the current window.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#close">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l324">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#controlFlow">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow used by this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeAsyncScript" class="function"><div><h3><code>&lt;T&gt;</code> executeAsyncScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l617">code »</a></span></h3><p>Schedules a command to execute asynchronous JavaScript in the context of the
+currently selected frame or window. The script fragment will be executed as
+the body of an anonymous function. If the script is provided as a function
+object, that function will be converted to a string for injection into the
+target window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>Unlike executing synchronous JavaScript with <a href="module_selenium-webdriver_phantomjs_class_Driver.html#executeScript"><code>#executeScript</code></a>,
+scripts executed with this function must explicitly signal they are finished
+by invoking the provided callback. This callback will always be injected
+into the executed function as the last argument, and thus may be referenced
+with <code>arguments[arguments.length - 1]</code>. The following steps will be
+taken for resolving this functions return value against the first argument
+to the script&#39;s callback function:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><strong>Example #1:</strong> Performing a sleep that is synchronized with the currently
+selected window:</p>
+<pre><code>var start &#61; new Date().getTime();
+driver.executeAsyncScript(
+    &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).
+    then(function() {
+      console.log(
+          &#39;Elapsed time: &#39; &#43; (new Date().getTime() - start) &#43; &#39; ms&#39;);
+    });
+</code></pre>
+<p><strong>Example #2:</strong> Synchronizing a test with an AJAX application:</p>
+<pre><code>var button &#61; driver.findElement(By.id(&#39;compose-button&#39;));
+button.click();
+driver.executeAsyncScript(
+    &#39;var callback &#61; arguments[arguments.length - 1];&#39; &#43;
+    &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);
+driver.switchTo().frame(&#39;composeWidget&#39;);
+driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog&#64;example.com&#39;);
+</code></pre>
+<p><strong>Example #3:</strong> Injecting a XMLHttpRequest and waiting for the result. In
+this example, the inject script is specified with a function literal. When
+using this format, the function is converted to a string for injection, so it
+should not reference any symbols not defined in the scope of the page under
+test.</p>
+<pre><code>driver.executeAsyncScript(function() {
+  var callback &#61; arguments[arguments.length - 1];
+  var xhr &#61; new XMLHttpRequest();
+  xhr.open(&#34;GET&#34;, &#34;/resource/data.json&#34;, true);
+  xhr.onreadystatechange &#61; function() {
+    if (xhr.readyState &#61;&#61; 4) {
+      callback(xhr.responseText);
+    }
+  }
+  xhr.send(&#39;&#39;);
+}).then(function(str) {
+  console.log(JSON.parse(str)[&#39;food&#39;]);
+});
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeAsyncScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executePhantomJS" class="function"><div><h3><code>&lt;T&gt;</code> executePhantomJS(<wbr>script, var_args)<span class="codelink"><a href="source/phantomjs.js.src.html#l249">code »</a></span></h3><p>Executes a PhantomJS fragment. This method is similar to
+<a href="module_selenium-webdriver_phantomjs_class_Driver.html#executeScript"><code>#executeScript</code></a>, except it exposes the
+<a href="http://phantomjs.org/api/">PhantomJS API</a> to the injected
+script.</p>
+<p>The injected script will execute in the context of PhantomJS&#39;s
+<code>page</code> variable. If a page has not been loaded before calling this
+method, one will be created.</p>
+<p>Be sure to wrap callback definitions in a try/catch block, as failures
+may cause future WebDriver calls to fail.</p>
+<p>Certain callbacks are used by GhostDriver (the PhantomJS WebDriver
+implementation) and overriding these may cause the script to fail. It is
+recommended that you check for existing callbacks before defining your own.
+</p>
+<p>As with <a href="module_selenium-webdriver_phantomjs_class_Driver.html#executeScript"><code>#executeScript</code></a>, the injected script may be defined as
+a string for an anonymous function body (e.g. &#34;return 123;&#34;), or as a
+function. If a function is provided, it will be decompiled to its original
+source. Note that injecting functions is provided as a convenience to
+simplify defining complex scripts. Care must be taken that the function
+only references variables that will be defined in the page&#39;s scope and
+that the function does not override <code>Function.prototype.toString</code>
+(overriding toString() will interfere with how the function is
+decompiled.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that resolve to the
+script&#39;s return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeScript" class="function"><div><h3><code>&lt;T&gt;</code> executeScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l528">code »</a></span></h3><p>Schedules a command to execute JavaScript in the context of the currently
+selected frame or window. The script fragment will be executed as the body
+of an anonymous function. If the script is provided as a function object,
+that function will be converted to a string for injection into the target
+window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>The script may refer to any variables accessible from the current window.
+Furthermore, the script will execute in the window&#39;s context, thus
+<code>document</code> may be used to refer to the current document. Any local
+variables will not be available once the script has finished executing,
+though global variables will persist.</p>
+<p>If the script has a return value (i.e. if the script contains a return
+statement), then the following steps will be taken for resolving this
+functions return value:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l867">code »</a></span></h3><p>Schedule a command to find an element on the page. If the element cannot be
+found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will be returned
+by the driver. Unlike other commands, this error cannot be suppressed. In
+other words, scheduling a command to find an element doubles as an assert
+that the element is present on the page. To test whether an element is
+present on the page, use <a href="module_selenium-webdriver_phantomjs_class_Driver.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; driver.findElement(firstVisibleLink);
+
+function firstVisibleLink(driver) {
+  var links &#61; driver.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p>When running in the browser, a WebDriver cannot manipulate DOM elements
+directly; it may do so only through a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> reference.
+This function may be used to generate a WebElement from a DOM element. A
+reference to the DOM element will be stored in a known location and this
+driver will attempt to retrieve it through <a href="module_selenium-webdriver_phantomjs_class_Driver.html#executeScript"><code>#executeScript</code></a>. If the
+element cannot be found (eg, it belongs to a different document than the
+one this instance is currently focused on), a
+<a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error will be returned.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElement">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l994">code »</a></span></h3><p>Schedule a command to search for multiple elements on the page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElements">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l792">code »</a></span></h3><p>Schedules a command to navigate to the given URL.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#get">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The fully qualified URL to open.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the document has finished loading.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAllWindowHandles" class="function"><div><h3>getAllWindowHandles()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l753">code »</a></span></h3><p>Schedules a command to retrieve the current list of available window handles.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getAllWindowHandles">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;&gt;</code><dd><p>A promise that will
+be resolved with an array of window handles.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l430">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCapabilities">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>&gt;</code><dd><p>A promise
+that will resolve with the this instance&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCurrentUrl" class="function"><div><h3>getCurrentUrl()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l802">code »</a></span></h3><p>Schedules a command to retrieve the URL of the current page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCurrentUrl">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current URL.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPageSource" class="function"><div><h3>getPageSource()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l768">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s source. The page source
+returned is a representation of the underlying DOM: do not expect it to be
+formatted or escaped in the same way as the response sent from the web
+server.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getPageSource">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page source.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSession" class="function"><div><h3>getSession()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l421">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getSession">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Session.html">webdriver.Session</a>&gt;</code><dd><p>A promise for this
+client&#39;s session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTitle" class="function"><div><h3>getTitle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l814">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s title.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getTitle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page&#39;s title.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWindowHandle" class="function"><div><h3>getWindowHandle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l741">code »</a></span></h3><p>Schedules a command to retrieve they current window handle.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getWindowHandle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current window handle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locatorOrElement)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l974">code »</a></span></h3><p>Schedules a command to test if an element is present on the page.</p>
+<p>If given a DOM element, this function will check if it belongs to the
+document the driver is currently focused on. Otherwise, the function will
+test if at least one element can be found with the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#isElementPresent">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locatorOrElement<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator to use, or the actual
+DOM element to be located by the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the element is present on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manage" class="function"><div><h3>manage()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1056">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#manage">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code><dd><p>The options interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="navigate" class="function"><div><h3>navigate()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1065">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#navigate">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code><dd><p>The navigation interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="quit" class="function"><div><h3>quit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l444">code »</a></span></h3><p>Schedules a command to quit the current session. After calling quit, this
+instance will be invalidated and may no longer be used to issue commands
+against the browser.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#quit">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="schedule" class="function"><div><h3><code>&lt;T&gt;</code> schedule(<wbr>command, description)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l338">code »</a></span></h3><p>Schedules a <code>webdriver.Command</code> to be executed by this driver&#39;s
+<code>webdriver.CommandExecutor</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#schedule">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to schedule.</p>
+<dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of the command for debugging.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the command result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFileDetector" class="function"><div><h3>setFileDetector(<wbr>detector)<span class="codelink"><a href="source/phantomjs.js.src.html#l211">code »</a></span></h3><p>This function is a no-op as file detectors are not supported by this
+implementation.</p>
+<p><b>Overrides: </b><a href="class_webdriver_WebDriver.html#setFileDetector">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detector<code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code><dd><p>The detector to use or <code>null</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sleep" class="function"><div><h3>sleep(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l731">code »</a></span></h3><p>Schedules a command to make the driver sleep for the given amount of time.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#sleep">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to sleep.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the sleep has finished.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="switchTo" class="function"><div><h3>switchTo()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1074">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#switchTo">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code><dd><p>The target locator interface for
+this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="takeScreenshot" class="function"><div><h3>takeScreenshot()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1046">code »</a></span></h3><p>Schedule a command to take a screenshot. The driver makes a best effort to
+return a screenshot of the following, in order of preference:</p>
+<ol><li>Entire page
+  </li><li>Current window
+  </li><li>Visible portion of the current frame
+  </li><li>The screenshot of the entire display containing the browser
+</li></ol>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#takeScreenshot">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the screenshot as a base-64 encoded PNG.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="touchActions" class="function"><div><h3>touchActions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l486">code »</a></span></h3><p>Creates a new touch sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_TouchSequence.html#perform"><code>webdriver.TouchSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.touchActions().
+    tap(element1).
+    doubleTap(element2).
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#touchActions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A new touch sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l700">code »</a></span></h3><p>Schedules a command to wait for a condition to hold. The condition may be
+specified by a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a>, as a custom function, or
+as a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>.</p>
+<p>For a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a> or function, the wait will repeatedly
+evaluate the condition until it returns a truthy value. If any errors occur
+while evaluating the condition, they will be allowed to propagate. In the
+event a condition returns a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>, the
+polling loop will wait for it to be resolved and use the resolved value for
+whether the condition has been satisified. Note the resolution time for
+a promise is factored into whether a wait has timed out.</p>
+<p><em>Example:</em> waiting up to 10 seconds for an element to be present and visible
+on the page.</p>
+<pre><code>var button &#61; driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);
+button.click();
+</code></pre>
+<p>This function may also be used to block the command flow on the resolution
+of a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>. When given a promise, the
+command will simply wait for its resolution before completing. A timeout may
+be provided to fail the command if the promise does not resolve before the
+timeout expires.</p>
+<p><em>Example:</em> Suppose you have a function, <code>startTestServer</code>, that returns a
+promise for when a server is ready for requests. You can block a <code>WebDriver</code>
+client on this promise with:</p>
+<pre><code>var started &#61; startTestServer();
+driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);
+driver.get(getServerUrl());
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#wait">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|<a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;T&gt;|function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): T)</code><dd><p>The condition to
+wait on, defined as a promise, condition object, or  a function to
+evaluate as a condition.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait for the condition to be true.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional message to use if the wait times
+out.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+with the first truthy value returned by the condition function, or
+rejected if the condition times out.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_proxy.html b/docs/module_selenium-webdriver_proxy.html
index 67b9e60..ab77a0f 100644
--- a/docs/module_selenium-webdriver_proxy.html
+++ b/docs/module_selenium-webdriver_proxy.html
@@ -1,24 +1,28 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/proxy</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/proxy</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/proxy.js.src.html">code &raquo;</a></header><section><p>Defines functions for configuring a webdriver proxy:
- <pre><code>
- var webdriver = require('selenium-webdriver'),
-     proxy = require('selenium-webdriver/proxy');
+<!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>selenium-webdriver/proxy</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><div class="codelink"><a href="source/proxy.js.src.html#l30">View Source</a></div><h1>module selenium-webdriver/proxy</h1><p>Defines functions for configuring a webdriver proxy:</p>
+<pre><code>var webdriver &#61; require(&#39;selenium-webdriver&#39;),
+    proxy &#61; require(&#39;selenium-webdriver/proxy&#39;);
 
- var driver = new webdriver.Builder()
-     .withCapabilities(webdriver.Capabilities.chrome())
-     .setProxy(proxy.manual({http: 'host:1234'}))
-     .build();
- </code></pre></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/proxy.js.src.html#l45">code &raquo;</a><a class="member" name="ProxyConfig">ProxyConfig</a> : <code class="type">({proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, proxyAutoconfigUrl: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, ftpProxy: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, httpProxy: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, sslProxy: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, noProxy: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code></div><div>Proxy configuration object, as defined by the WebDriver wire protocol.</div></summary></details></div></div></section><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/proxy.js.src.html#l56">code &raquo;</a><span class="member"><a name="direct">direct</a> <span class="args">( )</span> &rArr; <code class="type">!ProxyConfig</code></span></div><p>Configures WebDriver to bypass all browser proxies.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new proxy configuration object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/proxy.js.src.html#l83">code &raquo;</a><span class="member"><a name="manual">manual</a> <span class="args">( options )</span> &rArr; <code class="type">!ProxyConfig</code></span></div><p>Manually configures the browser proxy.  The following options are
- supported:
- <ul>
- <li><code >ftp</code>: Proxy host to use for FTP requests
- <li><code >http</code>: Proxy host to use for HTTP requests
- <li><code >https</code>: Proxy host to use for HTTPS requests
- <li><code >bypass</code>: A list of hosts requests should directly connect to,
-     bypassing any other proxies for that request. May be specified as a
-     comma separated string, or a list of strings.
- </ul>
-
- Behavior is undefined for FTP, HTTP, and HTTPS requests if the
- corresponding key is omitted from the configuration options.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>options: <code class="type">{ftp: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), http: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), https: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), bypass: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}</code><dd>Proxy
-     configuration options.</dl><tr><th>Returns<tr><td><dl>A new proxy configuration object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/proxy.js.src.html#l101">code &raquo;</a><span class="member"><a name="pac">pac</a> <span class="args">( url )</span> &rArr; <code class="type">!ProxyConfig</code></span></div><p>Configures WebDriver to configure the browser proxy using the PAC file at
- the given URL.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>url: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URL for the PAC proxy to use.</dl><tr><th>Returns<tr><td><dl>A new proxy configuration object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/proxy.js.src.html#l113">code &raquo;</a><span class="member"><a name="system">system</a> <span class="args">( )</span> &rArr; <code class="type">!ProxyConfig</code></span></div><p>Configures WebDriver to use the current system's proxy.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new proxy configuration object.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+var driver &#61; new webdriver.Builder()
+    .withCapabilities(webdriver.Capabilities.chrome())
+    .setProxy(proxy.manual({http: &#39;host:1234&#39;}))
+    .build();
+</code></pre>
+<h2>Functions</h2><div id="direct" class="function"><div><h3>direct()<span class="codelink"><a href="source/proxy.js.src.html#l43">code »</a></span></h3><p>Configures WebDriver to bypass all browser proxies.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>A new proxy configuration object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manual" class="function"><div><h3>manual(<wbr>options)<span class="codelink"><a href="source/proxy.js.src.html#l69">code »</a></span></h3><p>Manually configures the browser proxy.  The following options are
+supported:</p>
+<ul><li><code>ftp</code>: Proxy host to use for FTP requests</li><li><code>http</code>: Proxy host to use for HTTP requests</li><li><code>https</code>: Proxy host to use for HTTPS requests</li><li><code>bypass</code>: A list of hosts requests should directly connect to,
+bypassing any other proxies for that request. May be specified as a
+comma separated string, or a list of strings.</li></ul>
+<p>Behavior is undefined for FTP, HTTP, and HTTPS requests if the
+corresponding key is omitted from the configuration options.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>options<code>{bypass: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), ftp: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), http: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), https: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}</code><dd><p>Proxy
+configuration options.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>A new proxy configuration object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="pac" class="function"><div><h3>pac(<wbr>url)<span class="codelink"><a href="source/proxy.js.src.html#l87">code »</a></span></h3><p>Configures WebDriver to configure the browser proxy using the PAC file at
+the given URL.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>URL for the PAC proxy to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>A new proxy configuration object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="system" class="function"><div><h3>system()<span class="codelink"><a href="source/proxy.js.src.html#l99">code »</a></span></h3><p>Configures WebDriver to use the current system&#39;s proxy.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>A new proxy configuration object.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_remote.html b/docs/module_selenium-webdriver_remote.html
index 5b260c2..73a0e92 100644
--- a/docs/module_selenium-webdriver_remote.html
+++ b/docs/module_selenium-webdriver_remote.html
@@ -1,16 +1,8 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/remote</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/remote</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/remote/index.js.src.html">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a><dd>Manages the life and death of a native executable WebDriver server.<dt><a href="module_selenium-webdriver_remote_class_SeleniumServer.html">SeleniumServer</a><dd>Manages the life and death of the Selenium standalone server.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l56">code &raquo;</a><a class="member" name="ServiceOptions">ServiceOptions</a> : <code class="type">{port: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;), args: !(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>), path: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), env: (!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), stdio: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}</code></div><div>Configuration options for a DriverService instance.
- <ul>
- <li><code >port</code> - The port to start the server on (must be > 0). If the
-     port is provided as a promise, the service will wait for the promise to
-     resolve before starting.
- <li><code >args</code> - The arguments to pass to the service. If a promise is
-     provided, the service will wait for it to resolve before starting.
- <li><code >path</code> - The base path on the server for the WebDriver wire
-     protocol (e.g. '/wd/hub'). Defaults to '/'.
- <li><code >env</code> - The environment variables that should be visible to the
-     server process. Defaults to inheriting the current process's
-     environment.
- <li><code >stdio</code> - IO configuration for the spawned server process. For
-     more information, refer to the documentation of
-     <code >child_process.spawn</code>.
- </ul></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/remote</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><div class="codelink"><a href="source/remote/index.js.src.html#l18">View Source</a></div><h1>module selenium-webdriver/remote</h1><h2>Types</h2><dl><dt><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a><dd><p>Manages the life and death of a native executable WebDriver server.</p>
+<dt><a href="module_selenium-webdriver_remote_class_FileDetector.html">FileDetector</a><dd><p>A <a href="class_webdriver_FileDetector.html"><code>webdriver.FileDetector</code></a> that may be used when running
+against a remote
+<a href="http://selenium-release.storage.googleapis.com/index.html">Selenium server</a>.</p>
+<dt><a href="module_selenium-webdriver_remote_class_SeleniumServer.html">SeleniumServer</a><dd><p>Manages the life and death of the
+<a href="http://selenium-release.storage.googleapis.com/index.html">
+standalone Selenium server</a>.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_remote_class_DriverService.html b/docs/module_selenium-webdriver_remote_class_DriverService.html
index df1f193..517a143 100644
--- a/docs/module_selenium-webdriver_remote_class_DriverService.html
+++ b/docs/module_selenium-webdriver_remote_class_DriverService.html
@@ -1,19 +1,32 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>DriverService</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class DriverService</h1><a class="source" href="source/remote/index.js.src.html#l324">code &raquo;</a></header><section><p>Manages the life and death of a native executable WebDriver server.
-
- <p>It is expected that the driver server implements the
- <a href="http://code.google.com/p/selenium/wiki/JsonWireProtocol">WebDriver
- Wire Protocol</a>. Furthermore, the managed server should support multiple
- concurrent sessions, so that this class may be reused for multiple clients.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">DriverService <span class="args">( executable, options )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>executable: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Path to the executable to run.<dt>options: <code class="type">!ServiceOptions</code><dd>Configuration options for the service.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l128">code &raquo;</a><span class="member"><a name="address">address</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that resolves to
-    the server's address.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the server has not been started.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l139">code &raquo;</a><span class="member"><a name="isRunning">isRunning</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the underlying service process is running.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l221">code &raquo;</a><span class="member"><a name="kill">kill</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Stops the service if it is not currently running. This function will kill
- the server immediately. To synchronize with the active control flow, use
- <code  class="type"><a class="unresolved-link">#stop()</a></code>.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the server has been stopped.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l153">code &raquo;</a><span class="member"><a name="start">start</a> <span class="args">( opt_timeoutMs )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Starts the server if it is not already running.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_timeoutMs: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>How long to wait, in milliseconds, for the
-     server to start accepting requests. Defaults to 30 seconds.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve
-     to the server's base URL when it has started accepting requests. If the
-     timeout expires before the server has started, the promise will be
-     rejected.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l251">code &raquo;</a><span class="member"><a name="stop">stop</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a task in the current control flow to stop the server if it is
- currently running.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the server has been stopped.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l112">code &raquo;</a><span class="member"><a name="address_">address_</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Promise that resolves to the server's address or null if the server has not
- been started.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l82">code &raquo;</a><span class="member"><a name="args_">args_</a> : <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l88">code &raquo;</a><span class="member"><a name="env_">env_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l74">code &raquo;</a><span class="member"><a name="executable_">executable_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l85">code &raquo;</a><span class="member"><a name="path_">path_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l77">code &raquo;</a><span class="member"><a name="port_">port_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l104">code &raquo;</a><span class="member"><a name="process_">process_</a> : <code class="type">child_process.ChildProcess</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l120">code &raquo;</a><span class="member"><a name="shutdownHook_">shutdownHook_</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Promise that tracks the status of shutting down the server, or null if the
- server is not currently shutting down.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l91">code &raquo;</a><span class="member"><a name="stdio_">stdio_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code></span></div></summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l100">code &raquo;</a><span class="member"><a name="DriverService.DEFAULT_START_TIMEOUT_MS">DriverService.DEFAULT_START_TIMEOUT_MS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The default amount of time, in milliseconds, to wait for the server to
- start.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>DriverService</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_remote.html">selenium-webdriver/remote</a></div><div class="codelink"><a href="source/remote/index.js.src.html#l371">View Source</a></div><h1>class DriverService</h1><p>Manages the life and death of a native executable WebDriver server.</p>
+<p>It is expected that the driver server implements the
+https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol.
+Furthermore, the managed server should support multiple concurrent sessions,
+so that this class may be reused for multiple clients.</p>
+<h3>new DriverService(<wbr>executable, options)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>executable<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the executable to run.</p>
+<dt>options<code>{args: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>), env: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), loopback: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), path: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), port: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>), stdio: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|Stream)&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}</code><dd><p>Configuration options for the service.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="address" class="function"><div><h3>address()<span class="codelink"><a href="source/remote/index.js.src.html#l133">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that resolves to
+the server&#39;s address.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the server has not been started.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isRunning" class="function"><div><h3>isRunning()<span class="codelink"><a href="source/remote/index.js.src.html#l146">code »</a></span></h3><p>Returns whether the underlying process is still running. This does not take
+into account whether the process is in the process of shutting down.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the underlying service process is running.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="kill" class="function"><div><h3>kill()<span class="codelink"><a href="source/remote/index.js.src.html#l225">code »</a></span></h3><p>Stops the service if it is not currently running. This function will kill
+the server immediately. To synchronize with the active control flow, use
+<a href="module_selenium-webdriver_remote_class_DriverService.html#stop"><code>#stop()</code></a>.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved when
+the server has been stopped.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="start" class="function"><div><h3>start(<wbr>opt_timeoutMs)<span class="codelink"><a href="source/remote/index.js.src.html#l160">code »</a></span></h3><p>Starts the server if it is not already running.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_timeoutMs<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait, in milliseconds, for the
+server to start accepting requests. Defaults to 30 seconds.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will resolve
+to the server&#39;s base URL when it has started accepting requests. If the
+timeout expires before the server has started, the promise will be
+rejected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="stop" class="function"><div><h3>stop()<span class="codelink"><a href="source/remote/index.js.src.html#l241">code »</a></span></h3><p>Schedules a task in the current control flow to stop the server if it is
+currently running.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved when
+the server has been stopped.</p>
+</dl></div></div></div></div><h2>Static Properties</h2><div id="DriverService.DEFAULT_START_TIMEOUT_MS" class="property"><dl><dt><a href="source/remote/index.js.src.html#l125">DriverService.DEFAULT_START_TIMEOUT_MS</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The default amount of time, in milliseconds, to wait for the server to
+start.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_remote_class_FileDetector.html b/docs/module_selenium-webdriver_remote_class_FileDetector.html
new file mode 100644
index 0000000..032672e
--- /dev/null
+++ b/docs/module_selenium-webdriver_remote_class_FileDetector.html
@@ -0,0 +1,22 @@
+<!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>FileDetector</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_remote.html">selenium-webdriver/remote</a></div><div class="codelink"><a href="source/remote/index.js.src.html#l372">View Source</a></div><h1>class FileDetector</h1><div class="tags"><span>final</span></div><pre class="inheritance"><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a>
+  &#x2514; FileDetector</pre><p>A <a href="class_webdriver_FileDetector.html"><code>webdriver.FileDetector</code></a> that may be used when running
+against a remote
+<a href="http://selenium-release.storage.googleapis.com/index.html">Selenium server</a>.</p>
+<p>When a file path on the local machine running this script is entered with
+<a href="class_webdriver_WebElement.html#sendKeys"><code>WebElement#sendKeys</code></a>, this file detector
+will transfer the specified file to the Selenium server&#39;s host; the sendKeys
+command will be updated to use the transfered file&#39;s path.</p>
+<p><strong>Note:</strong> This class depends on a non-standard command supported on the
+Java Selenium server. The file detector will fail if used with a server that
+only supports standard WebDriver commands (such as the ChromeDriver).</p>
+<h3>new FileDetector()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="handleFile" class="function"><div><h3>handleFile(<wbr>driver, path)<span class="codelink"><a href="source/remote/index.js.src.html#l347">code »</a></span></h3><p>Handles the file specified by the given path, preparing it for use with
+the current browser. If the path does not refer to a valid file, it will
+be returned unchanged, otherwisee a path suitable for use with the current
+browser will be returned.</p>
+<p>This default implementation is a no-op. Subtypes may override this
+function for custom tailored file handling.</p>
+<p><b>Overrides: </b><a href="class_webdriver_FileDetector.html#handleFile">webdriver.FileDetector</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>driver<code><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a></code><dd><p>The driver for the current browser.</p>
+<dt>path<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The path to process.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise for the processed
+file path.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_remote_class_SeleniumServer.html b/docs/module_selenium-webdriver_remote_class_SeleniumServer.html
index 3d496b8..4b938b6 100644
--- a/docs/module_selenium-webdriver_remote_class_SeleniumServer.html
+++ b/docs/module_selenium-webdriver_remote_class_SeleniumServer.html
@@ -1,31 +1,41 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>SeleniumServer</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Class SeleniumServer</h1><a class="source" href="source/remote/index.js.src.html#l325">code &raquo;</a><pre><code><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a>
-  &#x2514; SeleniumServer</code></pre></header><section><p>Manages the life and death of the Selenium standalone server. The server
- may be obtained from http://selenium-release.storage.googleapis.com/index.html.<h2>Constructor</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">SeleniumServer <span class="args">( jar, options )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>jar: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Path to the Selenium server jar.<dt>options: <code class="type">!SeleniumServer.Options</code><dd>Configuration options for the
-     server.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If an invalid port is specified.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l319">code &raquo;</a><a class="member" name="SeleniumServer.Options">SeleniumServer.Options</a> : <code class="type">{port: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;), args: !(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>), jvmArgs: (!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), env: (!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), stdio: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}</code></div><div>Options for the Selenium server:
- <ul>
- <li><code >port</code> - The port to start the server on (must be > 0). If the
-     port is provided as a promise, the service will wait for the promise to
-     resolve before starting.
- <li><code >args</code> - The arguments to pass to the service. If a promise is
-     provided, the service will wait for it to resolve before starting.
- <li><code >jvmArgs</code> - The arguments to pass to the JVM. If a promise is
-     provided, the service will wait for it to resolve before starting.
- <li><code >env</code> - The environment variables that should be visible to the
-     server process. Defaults to inheriting the current process's
-     environment.
- <li><code >stdio</code> - IO configuration for the spawned server process. For
-     more information, refer to the documentation of
-     <code >child_process.spawn</code>.
- </ul></div></summary></details></div></div></section><section id="instance-methods"><h2>Instance Methods</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l128">code &raquo;</a><span class="member"><a name="address">address</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that resolves to
-    the server's address.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the server has not been started.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l139">code &raquo;</a><span class="member"><a name="isRunning">isRunning</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the underlying service process is running.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l221">code &raquo;</a><span class="member"><a name="kill">kill</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Stops the service if it is not currently running. This function will kill
- the server immediately. To synchronize with the active control flow, use
- <code  class="type"><a class="unresolved-link">#stop()</a></code>.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the server has been stopped.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l153">code &raquo;</a><span class="member"><a name="start">start</a> <span class="args">( opt_timeoutMs )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Starts the server if it is not already running.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_timeoutMs: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>How long to wait, in milliseconds, for the
-     server to start accepting requests. Defaults to 30 seconds.</dl><tr><th>Returns<tr><td><dl>A promise that will resolve
-     to the server's base URL when it has started accepting requests. If the
-     timeout expires before the server has started, the promise will be
-     rejected.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/remote/index.js.src.html#l251">code &raquo;</a><span class="member"><a name="stop">stop</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Schedules a task in the current control flow to stop the server if it is
- currently running.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A promise that will be resolved when
-     the server has been stopped.</dl></table></div></details></div></div></section><section id="instance-properties"><h2>Instance Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l112">code &raquo;</a><span class="member"><a name="address_">address_</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Promise that resolves to the server's address or null if the server has not
- been started.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l82">code &raquo;</a><span class="member"><a name="args_">args_</a> : <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l88">code &raquo;</a><span class="member"><a name="env_">env_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l74">code &raquo;</a><span class="member"><a name="executable_">executable_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l85">code &raquo;</a><span class="member"><a name="path_">path_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l77">code &raquo;</a><span class="member"><a name="port_">port_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l104">code &raquo;</a><span class="member"><a name="process_">process_</a> : <code class="type">child_process.ChildProcess</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l120">code &raquo;</a><span class="member"><a name="shutdownHook_">shutdownHook_</a> : <code class="type"><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Promise that tracks the status of shutting down the server, or null if the
- server is not currently shutting down.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l91">code &raquo;</a><span class="member"><a name="stdio_">stdio_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code></span></div></summary></details></div></div></section><section id="static-properties"><h2>Static Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/remote/index.js.src.html#l267">code &raquo;</a><span class="member"><a name="SeleniumServer.superClass_">SeleniumServer.superClass_</a> : <code class="type"><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService.prototype</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>SeleniumServer</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_remote.html">selenium-webdriver/remote</a></div><div class="codelink"><a href="source/remote/index.js.src.html#l373">View Source</a></div><h1>class SeleniumServer</h1><pre class="inheritance"><a href="module_selenium-webdriver_remote_class_DriverService.html">DriverService</a>
+  &#x2514; SeleniumServer</pre><p>Manages the life and death of the
+<a href="http://selenium-release.storage.googleapis.com/index.html">
+standalone Selenium server</a>.</p>
+<h3>new SeleniumServer(<wbr>jar, opt_options)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>jar<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Path to the Selenium server jar.</p>
+<dt>opt_options<code>{args: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>), env: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), jvmArgs: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), loopback: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), port: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>), stdio: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|Stream)&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}=</code><dd><p>Configuration options for the
+server.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the path to the Selenium jar is not specified or if an
+invalid port is specified.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="address" class="function"><div><h3>address()<span class="codelink"><a href="source/remote/index.js.src.html#l133">code »</a></span></h3><p><b>Defined by: </b><a href="module_selenium-webdriver_remote_class_DriverService.html#address">DriverService</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that resolves to
+the server&#39;s address.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the server has not been started.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isRunning" class="function"><div><h3>isRunning()<span class="codelink"><a href="source/remote/index.js.src.html#l146">code »</a></span></h3><p>Returns whether the underlying process is still running. This does not take
+into account whether the process is in the process of shutting down.</p>
+<p><b>Defined by: </b><a href="module_selenium-webdriver_remote_class_DriverService.html#isRunning">DriverService</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the underlying service process is running.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="kill" class="function"><div><h3>kill()<span class="codelink"><a href="source/remote/index.js.src.html#l225">code »</a></span></h3><p>Stops the service if it is not currently running. This function will kill
+the server immediately. To synchronize with the active control flow, use
+<a href="module_selenium-webdriver_remote_class_SeleniumServer.html#stop"><code>#stop()</code></a>.</p>
+<p><b>Defined by: </b><a href="module_selenium-webdriver_remote_class_DriverService.html#kill">DriverService</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved when
+the server has been stopped.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="start" class="function"><div><h3>start(<wbr>opt_timeoutMs)<span class="codelink"><a href="source/remote/index.js.src.html#l160">code »</a></span></h3><p>Starts the server if it is not already running.</p>
+<p><b>Defined by: </b><a href="module_selenium-webdriver_remote_class_DriverService.html#start">DriverService</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_timeoutMs<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait, in milliseconds, for the
+server to start accepting requests. Defaults to 30 seconds.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will resolve
+to the server&#39;s base URL when it has started accepting requests. If the
+timeout expires before the server has started, the promise will be
+rejected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="stop" class="function"><div><h3>stop()<span class="codelink"><a href="source/remote/index.js.src.html#l241">code »</a></span></h3><p>Schedules a task in the current control flow to stop the server if it is
+currently running.</p>
+<p><b>Defined by: </b><a href="module_selenium-webdriver_remote_class_DriverService.html#stop">DriverService</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved when
+the server has been stopped.</p>
+</dl></div></div></div></div><h2>Type Definitions</h2><div id="SeleniumServer.Options" class="property"><dl><dt><a href="source/remote/index.js.src.html#l320">SeleniumServer.Options</a><code>{args: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>), env: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), jvmArgs: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), loopback: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), port: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>), stdio: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|Stream)&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)}</code><dd><p>Options for the Selenium server:</p>
+<ul><li><code>loopback</code> - Whether the server should only be accessed on this host&#39;s
+loopback address.</li><li><code>port</code> - The port to start the server on (must be &gt; 0). If the port is
+provided as a promise, the service will wait for the promise to resolve
+before starting.</li><li><code>args</code> - The arguments to pass to the service. If a promise is provided,
+the service will wait for it to resolve before starting.</li><li><code>jvmArgs</code> - The arguments to pass to the JVM. If a promise is provided,
+the service will wait for it to resolve before starting.</li><li><code>env</code> - The environment variables that should be visible to the server
+process. Defaults to inheriting the current process&#39;s environment.</li><li><code>stdio</code> - IO configuration for the spawned server process. For more
+information, refer to the documentation of <code>child_process.spawn</code>.</li></ul>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_safari.html b/docs/module_selenium-webdriver_safari.html
new file mode 100644
index 0000000..a4c1235
--- /dev/null
+++ b/docs/module_selenium-webdriver_safari.html
@@ -0,0 +1,9 @@
+<!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>selenium-webdriver/safari</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><div class="codelink"><a href="source/safari.js.src.html#l27">View Source</a></div><h1>module selenium-webdriver/safari</h1><p>Defines a WebDriver client for Safari. Before using this
+module, you must install the
+<a href="http://selenium-release.storage.googleapis.com/index.html">latest version</a>
+of the SafariDriver browser extension; using Safari for normal browsing is
+not recommended once the extension has been installed. You can, and should,
+disable the extension when the browser is not being used with WebDriver.</p>
+<h2>Types</h2><dl><dt><a href="module_selenium-webdriver_safari_class_Driver.html">Driver</a><dd><p>A WebDriver client for Safari.</p>
+<dt><a href="module_selenium-webdriver_safari_class_Options.html">Options</a><dd><p>Configuration options specific to the <a href="module_selenium-webdriver_safari_class_Driver.html"><code>SafariDriver</code></a>.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_safari_class_Driver.html b/docs/module_selenium-webdriver_safari_class_Driver.html
new file mode 100644
index 0000000..4ca43e0
--- /dev/null
+++ b/docs/module_selenium-webdriver_safari_class_Driver.html
@@ -0,0 +1,279 @@
+<!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>Driver</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_safari.html">selenium-webdriver/safari</a></div><div class="codelink"><a href="source/safari.js.src.html#l537">View Source</a></div><h1>class Driver</h1><pre class="inheritance"><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>
+  &#x2514; Driver</pre><p>A WebDriver client for Safari. This class should never be instantiated
+directly; instead, use the <a href="module_selenium-webdriver_class_Builder.html"><code>selenium-webdriver.Builder</code></a>:</p>
+<pre><code>var driver &#61; new Builder()
+    .forBrowser(&#39;safari&#39;)
+    .build();
+</code></pre>
+<h3>new Driver(<wbr>opt_config, opt_flow)</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_config<code>?(<a href="module_selenium-webdriver_safari_class_Options.html">Options</a>|<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>)=</code><dd><p>The configuration
+options for the new session.</p>
+<dt>opt_flow<code>?<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>=</code><dd><p>The control flow to create
+the driver under.</p>
+</dl></div></div><h2>Instance Methods</h2><div id="actions" class="function"><div><h3>actions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l469">code »</a></span></h3><p>Creates a new action sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_ActionSequence.html#perform"><code>webdriver.ActionSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.actions().
+    mouseDown(element1).
+    mouseMove(element2).
+    mouseUp().
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#actions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a></code><dd><p>A new action sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="call" class="function"><div><h3><code>&lt;T&gt;</code> call(<wbr>fn, opt_scope, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l639">code »</a></span></h3><p>Schedules a command to execute a custom function.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#call">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(...?): (T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)</code><dd><p>The function to
+execute.</p>
+<dt>opt_scope<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object in whose scope to execute the function.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the function.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved&#39;
+with the function&#39;s result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="close" class="function"><div><h3>close()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l780">code »</a></span></h3><p>Schedules a command to close the current window.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#close">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when this command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l324">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#controlFlow">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The control flow used by this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeAsyncScript" class="function"><div><h3><code>&lt;T&gt;</code> executeAsyncScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l617">code »</a></span></h3><p>Schedules a command to execute asynchronous JavaScript in the context of the
+currently selected frame or window. The script fragment will be executed as
+the body of an anonymous function. If the script is provided as a function
+object, that function will be converted to a string for injection into the
+target window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>Unlike executing synchronous JavaScript with <a href="module_selenium-webdriver_safari_class_Driver.html#executeScript"><code>#executeScript</code></a>,
+scripts executed with this function must explicitly signal they are finished
+by invoking the provided callback. This callback will always be injected
+into the executed function as the last argument, and thus may be referenced
+with <code>arguments[arguments.length - 1]</code>. The following steps will be
+taken for resolving this functions return value against the first argument
+to the script&#39;s callback function:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><strong>Example #1:</strong> Performing a sleep that is synchronized with the currently
+selected window:</p>
+<pre><code>var start &#61; new Date().getTime();
+driver.executeAsyncScript(
+    &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).
+    then(function() {
+      console.log(
+          &#39;Elapsed time: &#39; &#43; (new Date().getTime() - start) &#43; &#39; ms&#39;);
+    });
+</code></pre>
+<p><strong>Example #2:</strong> Synchronizing a test with an AJAX application:</p>
+<pre><code>var button &#61; driver.findElement(By.id(&#39;compose-button&#39;));
+button.click();
+driver.executeAsyncScript(
+    &#39;var callback &#61; arguments[arguments.length - 1];&#39; &#43;
+    &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);
+driver.switchTo().frame(&#39;composeWidget&#39;);
+driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog&#64;example.com&#39;);
+</code></pre>
+<p><strong>Example #3:</strong> Injecting a XMLHttpRequest and waiting for the result. In
+this example, the inject script is specified with a function literal. When
+using this format, the function is converted to a string for injection, so it
+should not reference any symbols not defined in the scope of the page under
+test.</p>
+<pre><code>driver.executeAsyncScript(function() {
+  var callback &#61; arguments[arguments.length - 1];
+  var xhr &#61; new XMLHttpRequest();
+  xhr.open(&#34;GET&#34;, &#34;/resource/data.json&#34;, true);
+  xhr.onreadystatechange &#61; function() {
+    if (xhr.readyState &#61;&#61; 4) {
+      callback(xhr.responseText);
+    }
+  }
+  xhr.send(&#39;&#39;);
+}).then(function(str) {
+  console.log(JSON.parse(str)[&#39;food&#39;]);
+});
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeAsyncScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="executeScript" class="function"><div><h3><code>&lt;T&gt;</code> executeScript(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l528">code »</a></span></h3><p>Schedules a command to execute JavaScript in the context of the currently
+selected frame or window. The script fragment will be executed as the body
+of an anonymous function. If the script is provided as a function object,
+that function will be converted to a string for injection into the target
+window.</p>
+<p>Any arguments provided in addition to the script will be included as script
+arguments and may be referenced using the <code>arguments</code> object.
+Arguments may be a boolean, number, string, or <code>webdriver.WebElement</code>.
+Arrays and objects may also be used as script arguments as long as each item
+adheres to the types previously mentioned.</p>
+<p>The script may refer to any variables accessible from the current window.
+Furthermore, the script will execute in the window&#39;s context, thus
+<code>document</code> may be used to refer to the current document. Any local
+variables will not be available once the script has finished executing,
+though global variables will persist.</p>
+<p>If the script has a return value (i.e. if the script contains a return
+statement), then the following steps will be taken for resolving this
+functions return value:</p>
+<ul><li>For a HTML element, the value will resolve to a
+<a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a></li><li>Null and undefined return values will resolve to null</li><li>Booleans, numbers, and strings will resolve as is</li><li>Functions will resolve to their string representation</li><li>For arrays and objects, each member item will be converted according to
+the rules above</li></ul>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#executeScript">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will resolve to the
+scripts return value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElement" class="function"><div><h3>findElement(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l867">code »</a></span></h3><p>Schedule a command to find an element on the page. If the element cannot be
+found, a <a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> result will be returned
+by the driver. Unlike other commands, this error cannot be suppressed. In
+other words, scheduling a command to find an element doubles as an assert
+that the element is present on the page. To test whether an element is
+present on the page, use <a href="module_selenium-webdriver_safari_class_Driver.html#isElementPresent"><code>#isElementPresent</code></a> instead.</p>
+<p>The search criteria for an element may be defined using one of the
+factories in the <a href="namespace_webdriver_By.html"><code>webdriver.By</code></a> namespace, or as a short-hand
+<a href="namespace_webdriver_By.html#By.Hash"><code>webdriver.By.Hash</code></a> object. For example, the following two statements
+are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id:&#39;foo&#39;});
+</code></pre>
+<p>You may also provide a custom locator function, which takes as input
+this WebDriver instance and returns a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, or a
+promise that will resolve to a WebElement. For example, to find the first
+visible link on a page, you could write:</p>
+<pre><code>var link &#61; driver.findElement(firstVisibleLink);
+
+function firstVisibleLink(driver) {
+  var links &#61; driver.findElements(By.tagName(&#39;a&#39;));
+  return webdriver.promise.filter(links, function(link) {
+    return links.isDisplayed();
+  }).then(function(visibleLinks) {
+    return visibleLinks[0];
+  });
+}
+</code></pre>
+<p>When running in the browser, a WebDriver cannot manipulate DOM elements
+directly; it may do so only through a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> reference.
+This function may be used to generate a WebElement from a DOM element. A
+reference to the DOM element will be stored in a known location and this
+driver will attempt to retrieve it through <a href="module_selenium-webdriver_safari_class_Driver.html#executeScript"><code>#executeScript</code></a>. If the
+element cannot be found (eg, it belongs to a different document than the
+one this instance is currently focused on), a
+<a href="enum_bot_ErrorCode.html#NO_SUCH_ELEMENT"><code>bot.ErrorCode.NO_SUCH_ELEMENT</code></a> error will be returned.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElement">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The
+locator to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>A WebElement that can be used to issue
+commands against the located element. If the element is not found, the
+element will be invalidated and all scheduled commands aborted.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="findElements" class="function"><div><h3>findElements(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l994">code »</a></span></h3><p>Schedule a command to search for multiple elements on the page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#findElements">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+strategy to use when searching for the element.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>A
+promise that will resolve to an array of WebElements.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get(<wbr>url)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l792">code »</a></span></h3><p>Schedules a command to navigate to the given URL.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#get">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>url<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The fully qualified URL to open.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the document has finished loading.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getAllWindowHandles" class="function"><div><h3>getAllWindowHandles()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l753">code »</a></span></h3><p>Schedules a command to retrieve the current list of available window handles.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getAllWindowHandles">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;&gt;</code><dd><p>A promise that will
+be resolved with an array of window handles.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCapabilities" class="function"><div><h3>getCapabilities()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l430">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCapabilities">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a>&gt;</code><dd><p>A promise
+that will resolve with the this instance&#39;s capabilities.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getCurrentUrl" class="function"><div><h3>getCurrentUrl()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l802">code »</a></span></h3><p>Schedules a command to retrieve the URL of the current page.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getCurrentUrl">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current URL.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getPageSource" class="function"><div><h3>getPageSource()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l768">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s source. The page source
+returned is a representation of the underlying DOM: do not expect it to be
+formatted or escaped in the same way as the response sent from the web
+server.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getPageSource">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page source.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getSession" class="function"><div><h3>getSession()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l421">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getSession">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="class_webdriver_Session.html">webdriver.Session</a>&gt;</code><dd><p>A promise for this
+client&#39;s session.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getTitle" class="function"><div><h3>getTitle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l814">code »</a></span></h3><p>Schedules a command to retrieve the current page&#39;s title.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getTitle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current page&#39;s title.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getWindowHandle" class="function"><div><h3>getWindowHandle()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l741">code »</a></span></h3><p>Schedules a command to retrieve they current window handle.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#getWindowHandle">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved with the current window handle.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isElementPresent" class="function"><div><h3>isElementPresent(<wbr>locatorOrElement)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l974">code »</a></span></h3><p>Schedules a command to test if an element is present on the page.</p>
+<p>If given a DOM element, this function will check if it belongs to the
+document the driver is currently focused on. Otherwise, the function will
+test if at least one element can be found with the given search criteria.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#isElementPresent">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locatorOrElement<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator to use, or the actual
+DOM element to be located by the server.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A promise that will resolve
+with whether the element is present on the page.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="manage" class="function"><div><h3>manage()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1056">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#manage">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Options.html">webdriver.WebDriver.Options</a></code><dd><p>The options interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="navigate" class="function"><div><h3>navigate()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1065">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#navigate">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_Navigation.html">webdriver.WebDriver.Navigation</a></code><dd><p>The navigation interface for this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="quit" class="function"><div><h3>quit()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l444">code »</a></span></h3><p>Schedules a command to quit the current session. After calling quit, this
+instance will be invalidated and may no longer be used to issue commands
+against the browser.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#quit">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the command has completed.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="schedule" class="function"><div><h3><code>&lt;T&gt;</code> schedule(<wbr>command, description)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l338">code »</a></span></h3><p>Schedules a <code>webdriver.Command</code> to be executed by this driver&#39;s
+<code>webdriver.CommandExecutor</code>.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#schedule">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>command<code><a href="class_webdriver_Command.html">webdriver.Command</a></code><dd><p>The command to schedule.</p>
+<dt>description<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A description of the command for debugging.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be resolved
+with the command result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setFileDetector" class="function"><div><h3>setFileDetector(<wbr>detector)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l407">code »</a></span></h3><p>Sets the <a href="class_webdriver_FileDetector.html">file detector</a> that should be
+used with this instance.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#setFileDetector">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>detector<code><a href="class_webdriver_FileDetector.html">webdriver.FileDetector</a></code><dd><p>The detector to use or <code>null</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="sleep" class="function"><div><h3>sleep(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l731">code »</a></span></h3><p>Schedules a command to make the driver sleep for the given amount of time.</p>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#sleep">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to sleep.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>&gt;</code><dd><p>A promise that will be resolved
+when the sleep has finished.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="switchTo" class="function"><div><h3>switchTo()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1074">code »</a></span></h3><p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#switchTo">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_WebDriver_TargetLocator.html">webdriver.WebDriver.TargetLocator</a></code><dd><p>The target locator interface for
+this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="takeScreenshot" class="function"><div><h3>takeScreenshot()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l1046">code »</a></span></h3><p>Schedule a command to take a screenshot. The driver makes a best effort to
+return a screenshot of the following, in order of preference:</p>
+<ol><li>Entire page
+  </li><li>Current window
+  </li><li>Visible portion of the current frame
+  </li><li>The screenshot of the entire display containing the browser
+</li></ol>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#takeScreenshot">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd><p>A promise that will be
+resolved to the screenshot as a base-64 encoded PNG.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="touchActions" class="function"><div><h3>touchActions()<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l486">code »</a></span></h3><p>Creates a new touch sequence using this driver. The sequence will not be
+scheduled for execution until <a href="class_webdriver_TouchSequence.html#perform"><code>webdriver.TouchSequence#perform</code></a> is
+called. Example:</p>
+<pre><code>driver.touchActions().
+    tap(element1).
+    doubleTap(element2).
+    perform();
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#touchActions">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_TouchSequence.html">webdriver.TouchSequence</a></code><dd><p>A new touch sequence for this instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="wait" class="function"><div><h3><code>&lt;T&gt;</code> wait(<wbr>condition, opt_timeout, opt_message)<span class="codelink"><a href="source/lib/webdriver/webdriver.js.src.html#l700">code »</a></span></h3><p>Schedules a command to wait for a condition to hold. The condition may be
+specified by a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a>, as a custom function, or
+as a <a href="class_webdriver_promise_Promise.html"><code>webdriver.promise.Promise</code></a>.</p>
+<p>For a <a href="class_webdriver_until_Condition.html"><code>webdriver.until.Condition</code></a> or function, the wait will repeatedly
+evaluate the condition until it returns a truthy value. If any errors occur
+while evaluating the condition, they will be allowed to propagate. In the
+event a condition returns a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>, the
+polling loop will wait for it to be resolved and use the resolved value for
+whether the condition has been satisified. Note the resolution time for
+a promise is factored into whether a wait has timed out.</p>
+<p><em>Example:</em> waiting up to 10 seconds for an element to be present and visible
+on the page.</p>
+<pre><code>var button &#61; driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);
+button.click();
+</code></pre>
+<p>This function may also be used to block the command flow on the resolution
+of a <a href="class_webdriver_promise_Promise.html"><code>promise</code></a>. When given a promise, the
+command will simply wait for its resolution before completing. A timeout may
+be provided to fail the command if the promise does not resolve before the
+timeout expires.</p>
+<p><em>Example:</em> Suppose you have a function, <code>startTestServer</code>, that returns a
+promise for when a server is ready for requests. You can block a <code>WebDriver</code>
+client on this promise with:</p>
+<pre><code>var started &#61; startTestServer();
+driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);
+driver.get(getServerUrl());
+</code></pre>
+<p><b>Defined by: </b><a href="class_webdriver_WebDriver.html#wait">webdriver.WebDriver</a></p><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>condition<code>(<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;|<a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;T&gt;|function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): T)</code><dd><p>The condition to
+wait on, defined as a promise, condition object, or  a function to
+evaluate as a condition.</p>
+<dt>opt_timeout<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd><p>How long to wait for the condition to be true.</p>
+<dt>opt_message<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>An optional message to use if the wait times
+out.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>A promise that will be fulfilled
+with the first truthy value returned by the condition function, or
+rejected if the condition times out.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_safari_class_Options.html b/docs/module_selenium-webdriver_safari_class_Options.html
new file mode 100644
index 0000000..d725006
--- /dev/null
+++ b/docs/module_selenium-webdriver_safari_class_Options.html
@@ -0,0 +1,23 @@
+<!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>Options</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><div class="parentlink"><b>Module:</b> <a href="module_selenium-webdriver_safari.html">selenium-webdriver/safari</a></div><div class="codelink"><a href="source/safari.js.src.html#l538">View Source</a></div><h1>class Options</h1><pre class="inheritance"><a href="class_webdriver_Serializable.html">webdriver.Serializable</a>
+  &#x2514; Options</pre><p>Configuration options specific to the <a href="module_selenium-webdriver_safari_class_Driver.html"><code>SafariDriver</code></a>.</p>
+<h3>new Options()</h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dd>None.</dl></div></div><h2>Instance Methods</h2><div id="serialize" class="function"><div><h3>serialize()<span class="codelink"><a href="source/safari.js.src.html#l499">code »</a></span></h3><p>Converts this instance to its JSON wire protocol representation. Note this
+function is an implementation detail not intended for general use.</p>
+<p><b>Overrides: </b><a href="class_webdriver_Serializable.html#serialize">webdriver.Serializable</a></p><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, *&gt;</code><dd><p>The JSON wire protocol representation of this
+instance.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setCleanSession" class="function"><div><h3>setCleanSession(<wbr>clean)<span class="codelink"><a href="source/safari.js.src.html#l454">code »</a></span></h3><p>Sets whether to force Safari to start with a clean session. Enabling this
+option will cause all global browser data to be deleted.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>clean<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to make sure the session has no cookies,
+cache entries, local storage, or databases.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_safari_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setLoggingPrefs" class="function"><div><h3>setLoggingPrefs(<wbr>prefs)<span class="codelink"><a href="source/safari.js.src.html#l468">code »</a></span></h3><p>Sets the logging preferences for the new session.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>prefs<code><a href="class_webdriver_logging_Preferences.html">webdriver.logging.Preferences</a></code><dd><p>The logging preferences.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_safari_class_Options.html">Options</a></code><dd><p>A self reference.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="toCapabilities" class="function"><div><h3>toCapabilities(<wbr>opt_capabilities)<span class="codelink"><a href="source/safari.js.src.html#l480">code »</a></span></h3><p>Converts this options instance to a <a href="class_webdriver_Capabilities.html"><code>webdriver.Capabilities</code></a> object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_capabilities<code>?<a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a>=</code><dd><p>The capabilities to merge
+these options into, if any.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a></code><dd><p>The capabilities.</p>
+</dl></div></div></div></div><h2>Static Functions</h2><div id="Options.fromCapabilities" class="function"><div><h3>Options.fromCapabilities(<wbr>capabilities)<span class="codelink"><a href="source/safari.js.src.html#l428">code »</a></span></h3><p>Extracts the SafariDriver specific options from the given capabilities
+object.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>capabilities<code><a href="module_selenium-webdriver_class_Capabilities.html">Capabilities</a></code><dd><p>The capabilities object.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="module_selenium-webdriver_safari_class_Options.html">Options</a></code><dd><p>The ChromeDriver options.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_testing.html b/docs/module_selenium-webdriver_testing.html
index 336a5bb..bb12638 100644
--- a/docs/module_selenium-webdriver_testing.html
+++ b/docs/module_selenium-webdriver_testing.html
@@ -1,72 +1,74 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/testing</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/testing</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/testing/index.js.src.html">code &raquo;</a></header><section><p>Provides wrappers around the following global functions from
- <a href="http://visionmedia.github.io/mocha/">Mocha's BDD interface</a>:
- <ul>
-   <li>after
-   <li>afterEach
-   <li>before
-   <li>beforeEach
-   <li>it
-   <li>it.only
-   <li>it.skip
-   <li>xit
- </ul>
+<!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>selenium-webdriver/testing</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><div class="codelink"><a href="source/testing/index.js.src.html#l69">View Source</a></div><h1>module selenium-webdriver/testing</h1><p>Provides wrappers around the following global functions from
+<a href="https://github.com/mochajs/mocha">Mocha&#39;s BDD interface</a>:</p>
+<ul><li>after</li><li>afterEach</li><li>before</li><li>beforeEach</li><li>it</li><li>it.only</li><li>it.skip</li><li>xit</li></ul>
+<p>The provided wrappers leverage the <a href="class_webdriver_promise_ControlFlow.html"><code>webdriver.promise.ControlFlow</code></a>
+to simplify writing asynchronous tests:</p>
+<pre><code>var By &#61; require(&#39;selenium-webdriver&#39;).By,
+    until &#61; require(&#39;selenium-webdriver&#39;).until,
+    firefox &#61; require(&#39;selenium-webdriver/firefox&#39;),
+    test &#61; require(&#39;selenium-webdriver/testing&#39;);
 
- <p>The provided wrappers leverage the webdriver.promise.ControlFlow to
- simplify writing asynchronous tests:
- <pre><code>
- var webdriver = require('selenium-webdriver'),
-     remote = require('selenium-webdriver/remote'),
-     test = require('selenium-webdriver/testing');
+test.describe(&#39;Google Search&#39;, function() {
+  var driver;
 
- test.describe('Google Search', function() {
-   var driver, server;
+  test.before(function() {
+    driver &#61; new firefox.Driver();
+  });
 
-   test.before(function() {
-     server = new remote.SeleniumServer({
-       jar: 'path/to/selenium-server-standalone.jar'
-     });
-     server.start();
+  test.after(function() {
+    driver.quit();
+  });
 
-     driver = new webdriver.Builder().
-         withCapabilities({'browserName': 'firefox'}).
-         usingServer(server.address()).
-         build();
-   });
+  test.it(&#39;should append query to title&#39;, function() {
+    driver.get(&#39;http://www.google.com/ncr&#39;);
+    driver.findElement(By.name(&#39;q&#39;)).sendKeys(&#39;webdriver&#39;);
+    driver.findElement(By.name(&#39;btnG&#39;)).click();
+    driver.wait(until.titleIs(&#39;webdriver - Google Search&#39;), 1000);
+  });
+});
+</code></pre>
+<p>You may conditionally suppress a test function using the exported
+&#34;ignore&#34; function. If the provided predicate returns true, the attached
+test case will be skipped:</p>
+<pre><code>test.ignore(maybe()).it(&#39;is flaky&#39;, function() {
+  if (Math.random() &lt; 0.5) throw Error();
+});
 
-   test.after(function() {
-     driver.quit();
-     server.stop();
-   });
-
-   test.it('should append query to title', function() {
-     driver.get('http://www.google.com');
-     driver.findElement(webdriver.By.name('q')).sendKeys('webdriver');
-     driver.findElement(webdriver.By.name('btnG')).click();
-     driver.wait(function() {
-       return driver.getTitle().then(function(title) {
-         return 'webdriver - Google Search' === title;
-       });
-     }, 1000, 'Waiting for title to update');
-   });
- });
- </code></pre>
-
- <p>You may conditionally suppress a test function using the exported
- "ignore" function. If the provided predicate returns true, the attached
- test case will be skipped:
- <pre><code>
-   test.ignore(maybe()).it('is flaky', function() {
-     if (Math.random() < 0.5) throw Error();
-   });
-
-   function maybe() { return Math.random() < 0.5; }
- </code></pre></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l190">code &raquo;</a><span class="member"><a name="after">after</a> <span class="args">( fn )</span></span></div><p>Register a function to call after the current suite finishes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function()</code><dd>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l196">code &raquo;</a><span class="member"><a name="afterEach">afterEach</a> <span class="args">( fn )</span></span></div><p>Register a function to call after each test in a suite.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function()</code><dd>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l202">code &raquo;</a><span class="member"><a name="before">before</a> <span class="args">( fn )</span></span></div><p>Register a function to call before the current suite starts.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function()</code><dd>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l208">code &raquo;</a><span class="member"><a name="beforeEach">beforeEach</a> <span class="args">( fn )</span></span></div><p>Register a function to call before each test in a suite.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function()</code><dd>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l175">code &raquo;</a><span class="member"><a name="describe">describe</a> <span class="args">( name, fn )</span></span></div><p>Registers a new test suite.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The suite name.<dt>fn: <code class="type">function()=</code><dd>The suite function, or <code >undefined</code> to define
-     a pending test suite.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l235">code &raquo;</a><span class="member"><a name="ignore">ignore</a> <span class="args">( predicateFn )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Ignores the test chained to this function if the provided predicate returns
- true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>predicateFn: <code class="type">function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>A predicate to call to determine
-     if the test should be suppressed. This function MUST be synchronous.</dl><tr><th>Returns<tr><td><dl>An object with wrapped versions of <code  class="type"><a class="unresolved-link">#it()</a></code> and
-     <code  class="type"><a class="unresolved-link">#describe()</a></code> that ignore tests as indicated by the predicate.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l225">code &raquo;</a><span class="member"><a name="iit">iit</a> <span class="args">( name, fn )</span></span></div><p>An alias for <code  class="type"><a class="unresolved-link">#it()</a></code> that flags the test as the only one that should
- be run within the current suite.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The test name.<dt>fn: <code class="type">function()=</code><dd>The test function, or <code >undefined</code> to define
-     a pending test case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l216">code &raquo;</a><span class="member"><a name="it">it</a> <span class="args">( name, fn )</span></span></div><p>Add a test to the current suite.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The test name.<dt>fn: <code class="type">function()=</code><dd>The test function, or <code >undefined</code> to define
-     a pending test case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l183">code &raquo;</a><span class="member"><a name="xdescribe">xdescribe</a> <span class="args">( name, fn )</span></span></div><p>Defines a suppressed test suite.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The suite name.<dt>fn: <code class="type">function()=</code><dd>The suite function, or <code >undefined</code> to define
-     a pending test suite.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/testing/index.js.src.html#l233">code &raquo;</a><span class="member"><a name="xit">xit</a> <span class="args">( name, fn )</span></span></div><p>Adds a test to the current suite while suppressing it so it is not run.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The test name.<dt>fn: <code class="type">function()=</code><dd>The test function, or <code >undefined</code> to define
-     a pending test case.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+function maybe() { return Math.random() &lt; 0.5; }
+</code></pre>
+<h2>Functions</h2><div id="after" class="function"><div><h3>after(<wbr>fn)<span class="codelink"><a href="source/testing/index.js.src.html#l213">code »</a></span></h3><p>Register a function to call after the current suite finishes.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(): ?</code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="afterEach" class="function"><div><h3>afterEach(<wbr>fn)<span class="codelink"><a href="source/testing/index.js.src.html#l219">code »</a></span></h3><p>Register a function to call after each test in a suite.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(): ?</code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="before" class="function"><div><h3>before(<wbr>fn)<span class="codelink"><a href="source/testing/index.js.src.html#l225">code »</a></span></h3><p>Register a function to call before the current suite starts.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(): ?</code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="beforeEach" class="function"><div><h3>beforeEach(<wbr>fn)<span class="codelink"><a href="source/testing/index.js.src.html#l231">code »</a></span></h3><p>Register a function to call before each test in a suite.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>function(): ?</code><dd><p>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="describe" class="function"><div><h3>describe(<wbr>name, fn)<span class="codelink"><a href="source/testing/index.js.src.html#l198">code »</a></span></h3><p>Registers a new test suite.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The suite name.</p>
+<dt>fn<code>function(): ?=</code><dd><p>The suite function, or <code>undefined</code> to define
+a pending test suite.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="ignore" class="function"><div><h3>ignore(<wbr>predicateFn)<span class="codelink"><a href="source/testing/index.js.src.html#l258">code »</a></span></h3><p>Ignores the test chained to this function if the provided predicate returns
+true.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>predicateFn<code>function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>A predicate to call to determine
+if the test should be suppressed. This function MUST be synchronous.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd><p>An object with wrapped versions of <a href="module_selenium-webdriver_testing.html#it"><code>#it()</code></a> and
+<a href="module_selenium-webdriver_testing.html#describe"><code>#describe()</code></a> that ignore tests as indicated by the predicate.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="iit" class="function"><div><h3>iit(<wbr>name, fn)<span class="codelink"><a href="source/testing/index.js.src.html#l248">code »</a></span></h3><p>An alias for <a href="module_selenium-webdriver_testing.html#it"><code>#it()</code></a> that flags the test as the only one that should
+be run within the current suite.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The test name.</p>
+<dt>fn<code>function(): ?=</code><dd><p>The test function, or <code>undefined</code> to define
+a pending test case.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="it" class="function"><div><h3>it(<wbr>name, fn)<span class="codelink"><a href="source/testing/index.js.src.html#l239">code »</a></span></h3><p>Add a test to the current suite.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The test name.</p>
+<dt>fn<code>function(): ?=</code><dd><p>The test function, or <code>undefined</code> to define
+a pending test case.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="xdescribe" class="function"><div><h3>xdescribe(<wbr>name, fn)<span class="codelink"><a href="source/testing/index.js.src.html#l206">code »</a></span></h3><p>Defines a suppressed test suite.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The suite name.</p>
+<dt>fn<code>function(): ?=</code><dd><p>The suite function, or <code>undefined</code> to define
+a pending test suite.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="xit" class="function"><div><h3>xit(<wbr>name, fn)<span class="codelink"><a href="source/testing/index.js.src.html#l256">code »</a></span></h3><p>Adds a test to the current suite while suppressing it so it is not run.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The test name.</p>
+<dt>fn<code>function(): ?=</code><dd><p>The test function, or <code>undefined</code> to define
+a pending test case.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/module_selenium-webdriver_testing_assert.html b/docs/module_selenium-webdriver_testing_assert.html
index d214b1f..d36cbdb 100644
--- a/docs/module_selenium-webdriver_testing_assert.html
+++ b/docs/module_selenium-webdriver_testing_assert.html
@@ -1,19 +1,9 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>selenium-webdriver/testing/assert</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Module selenium-webdriver/testing/assert</h1><a class="source" href="/usr/local/google/home/jleyba/dev/selenium/build/javascript/node/selenium-webdriver/docs/source/testing/assert.js.src.html">code &raquo;</a></header><section><p>Defines a library that simplifies writing assertions against
- promised values.
-
- <blockquote>
- <hr>
- <b>NOTE:</b> This module is considered experimental and is subject to
- change, or removal, at any time!
- <hr>
- </blockquote>
-
- Sample usage:
- <pre><code>
- var driver = new webdriver.Builder().build();
- driver.get('http://www.google.com');
-
- assert(driver.getTitle()).equalTo('Google');
- </code></pre><h2>Main</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">assert <span class="args">( value )</span> &rArr; <code class="type">!<a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to perform an assertion on.</dl><tr><th>Returns<tr><td><dl>The new assertion.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l411">code &raquo;</a><span class="member"><a name="register">register</a> <span class="args">( name, matcherTemplate )</span></span></div><p>Registers a new assertion to expose from the
- <code  class="type"><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code> prototype.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The assertion name.<dt>matcherTemplate: <code class="type">(function(new: <a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a>, *)|{matches: function(*): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, describe: function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd>Either the
-     matcher constructor to use, or an object literal defining a matcher.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>selenium-webdriver/testing/assert</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><div class="codelink"><a href="source/testing/assert.js.src.html#l47">View Source</a></div><h1>module selenium-webdriver/testing/assert</h1><p>Creates a new assertion.</p>
+<h2>assert(<wbr>value)</h2><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to perform an assertion on.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code><dd><p>The new assertion.</p>
+</dl></div></div><h2>Functions</h2><div id="register" class="function"><div><h3>register(<wbr>name, matcherTemplate)<span class="codelink"><a href="source/testing/assert.js.src.html#l61">code »</a></span></h3><p>Registers a new assertion to expose from the
+<a href="class_webdriver_testing_Assertion.html"><code>webdriver.testing.Assertion</code></a> prototype.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The assertion name.</p>
+<dt>matcherTemplate<code>(function(new: goog.labs.testing.Matcher, *): ?|{describe: function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, matches: function(*): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>})</code><dd><p>Either the
+matcher constructor to use, or an object literal defining a matcher.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/namespace_PRIMITIVE_EQUALITY_PREDICATES.html b/docs/namespace_PRIMITIVE_EQUALITY_PREDICATES.html
new file mode 100644
index 0000000..55bf9cd
--- /dev/null
+++ b/docs/namespace_PRIMITIVE_EQUALITY_PREDICATES.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>PRIMITIVE_EQUALITY_PREDICATES</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace PRIMITIVE_EQUALITY_PREDICATES</h1><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l36">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l39">code &raquo;</a><span class="member"><a name="PRIMITIVE_EQUALITY_PREDICATES.Boolean">PRIMITIVE_EQUALITY_PREDICATES.Boolean</a> <span class="args">( var1, var2 )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var1<dt>var2</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l40">code &raquo;</a><span class="member"><a name="PRIMITIVE_EQUALITY_PREDICATES.Date">PRIMITIVE_EQUALITY_PREDICATES.Date</a> <span class="args">( date1, date2 )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>date1<dt>date2</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l44">code &raquo;</a><span class="member"><a name="PRIMITIVE_EQUALITY_PREDICATES.Function">PRIMITIVE_EQUALITY_PREDICATES.Function</a> <span class="args">( var1, var2 )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var1<dt>var2</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l38">code &raquo;</a><span class="member"><a name="PRIMITIVE_EQUALITY_PREDICATES.Number">PRIMITIVE_EQUALITY_PREDICATES.Number</a> <span class="args">( var1, var2 )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var1<dt>var2</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l43">code &raquo;</a><span class="member"><a name="PRIMITIVE_EQUALITY_PREDICATES.RegExp">PRIMITIVE_EQUALITY_PREDICATES.RegExp</a> <span class="args">( var1, var2 )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var1<dt>var2</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l37">code &raquo;</a><span class="member"><a name="PRIMITIVE_EQUALITY_PREDICATES.String">PRIMITIVE_EQUALITY_PREDICATES.String</a> <span class="args">( var1, var2 )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var1<dt>var2</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_bot.html b/docs/namespace_bot.html
index b3d27b1..994ded3 100644
--- a/docs/namespace_bot.html
+++ b/docs/namespace_bot.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>bot</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace bot</h1><a class="source" href="source/lib/atoms/error.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_bot_Error.html">bot.Error</a><dd>Error extension that includes error status codes from the WebDriver wire
- protocol:
- http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes</dl></table></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_bot_ErrorCode.html">bot.ErrorCode</a><dd>Error codes from the WebDriver wire protocol:
- http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>bot</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><div class="codelink"><a href="source/lib/atoms/error.js.src.html#l23">View Source</a></div><h1>namespace bot</h1><h2>Types</h2><dl><dt><a href="class_bot_Error.html">Error</a><dd><p>Represents an error returned from a WebDriver command request.</p>
+<dt><a href="enum_bot_ErrorCode.html">ErrorCode</a><dd><p>Error codes from the Selenium WebDriver protocol:
+https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#response-status-codes</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_bot_json.html b/docs/namespace_bot_json.html
index fa0a57e..54d65fa 100644
--- a/docs/namespace_bot_json.html
+++ b/docs/namespace_bot_json.html
@@ -1,4 +1,20 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>bot.json</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace bot.json</h1><a class="source" href="source/lib/atoms/json.js.src.html#l21">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/json.js.src.html#l77">code &raquo;</a><span class="member"><a name="bot.json.parse">bot.json.parse</a> <span class="args">( jsonStr )</span> &rArr; <code class="type">*</code></span></div><p>Parses a JSON string and returns the result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>jsonStr: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to parse.</dl><tr><th>Returns<tr><td><dl>The JSON object.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the input string is an invalid JSON string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/json.js.src.html#l67">code &raquo;</a><span class="member"><a name="bot.json.stringify">bot.json.stringify</a> <span class="args">( jsonObj, opt_replacer )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a JSON object to its string representation.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>jsonObj: <code class="type">*</code><dd>The input object.<dt>opt_replacer: <code class="type">?(function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, *): *)=</code><dd>A replacer function called
-     for each (key, value) pair that determines how the value should be
-     serialized. By default, this just returns the value and allows default
-     serialization to kick in.</dl><tr><th>Returns<tr><td><dl>A JSON string representation of the input object.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/atoms/json.js.src.html#l49">code &raquo;</a><span class="member"><a name="bot.json.SUPPORTS_NATIVE_JSON_">bot.json.SUPPORTS_NATIVE_JSON_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current browser supports the native JSON interface.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/json.js.src.html#l40">code &raquo;</a><span class="member"><a name="bot.json.NATIVE_JSON">bot.json.NATIVE_JSON</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>bot.json</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><div class="codelink"><a href="source/lib/atoms/json.js.src.html#l23">View Source</a></div><h1>namespace bot.json</h1><h2>Functions</h2><div id="parse" class="function"><div><h3>parse(<wbr>jsonStr)<span class="codelink"><a href="source/lib/atoms/json.js.src.html#l79">code »</a></span></h3><p>Parses a JSON string and returns the result.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>jsonStr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The string to parse.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><p>The JSON object.</p>
+</div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the input string is an invalid JSON string.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="stringify" class="function"><div><h3>stringify(<wbr>jsonObj, opt_replacer)<span class="codelink"><a href="source/lib/atoms/json.js.src.html#l69">code »</a></span></h3><p>Converts a JSON object to its string representation.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>jsonObj<code>*</code><dd><p>The input object.</p>
+<dt>opt_replacer<code>?function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, *): *=</code><dd><p>A replacer function called
+for each (key, value) pair that determines how the value should be
+serialized. By default, this just returns the value and allows default
+serialization to kick in.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>A JSON string representation of the input object.</p>
+</dl></div></div></div></div><h2>Compiler Constants</h2><div id="NATIVE_JSON" class="property"><dl><dt><a href="source/lib/atoms/json.js.src.html#l42">NATIVE_JSON</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>NATIVE_JSON indicates whether the code should rely on the
+native <code>JSON</code> functions, if available.</p>
+<p>The JSON functions can be defined by external libraries like Prototype
+and setting this flag to false forces the use of Closure&#39;s goog.json
+implementation.
+</p><p>If your JavaScript can be loaded by a third_party site and you are wary
+about relying on the native functions, specify
+&#34;--define bot.json.NATIVE_JSON&#61;false&#34; to the Closure compiler.
+</p></dl></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>
\ No newline at end of file
diff --git a/docs/namespace_bot_response.html b/docs/namespace_bot_response.html
index 3525f53..73e7453 100644
--- a/docs/namespace_bot_response.html
+++ b/docs/namespace_bot_response.html
@@ -1,5 +1,18 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>bot.response</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace bot.response</h1><a class="source" href="source/lib/atoms/response.js.src.html#l20">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/response.js.src.html#l32">code &raquo;</a><a class="member" name="bot.response.ResponseObject">bot.response.ResponseObject</a> : <code class="type">{status: <a href="enum_bot_ErrorCode.html">bot.ErrorCode</a>, value: (*|{message: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})}</code></div><div>Type definition for a response object, as defined by the JSON wire protocol.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/response.js.src.html#l92">code &raquo;</a><span class="member"><a name="bot.response.checkResponse">bot.response.checkResponse</a> <span class="args">( responseObj )</span> &rArr; <code class="type">!<a href="namespace_bot_response.html#bot.response.ResponseObject">bot.response.ResponseObject</a></code></span></div><p>Checks that a response object does not specify an error as defined by the
- WebDriver wire protocol. If the response object defines an error, it will
- be thrown. Otherwise, the response will be returned as is.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>responseObj: <code class="type">!<a href="namespace_bot_response.html#bot.response.ResponseObject">bot.response.ResponseObject</a></code><dd>The response object to
-     check.</dl><tr><th>Returns<tr><td><dl>The checked response object.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_bot_Error.html">bot.Error</a></code><dd>If the response describes an error.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/response.js.src.html#l66">code &raquo;</a><span class="member"><a name="bot.response.createErrorResponse">bot.response.createErrorResponse</a> <span class="args">( error )</span> &rArr; <code class="type">!<a href="namespace_bot_response.html#bot.response.ResponseObject">bot.response.ResponseObject</a></code></span></div><p>Converts an error value into its JSON representation as defined by the
- WebDriver wire protocol.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>error: <code class="type">(<a href="class_bot_Error.html">bot.Error</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|*)</code><dd>The error value to convert.</dl><tr><th>Returns<tr><td><dl>The new response object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/response.js.src.html#l49">code &raquo;</a><span class="member"><a name="bot.response.createResponse">bot.response.createResponse</a> <span class="args">( value )</span> &rArr; <code class="type">!<a href="namespace_bot_response.html#bot.response.ResponseObject">bot.response.ResponseObject</a></code></span></div><p>Creates a new success response object with the provided value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The response value.</dl><tr><th>Returns<tr><td><dl>The new response object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/response.js.src.html#l39">code &raquo;</a><span class="member"><a name="bot.response.isResponseObject">bot.response.isResponseObject</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to test.</dl><tr><th>Returns<tr><td><dl>Whether the given value is a response object.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>bot.response</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><div class="codelink"><a href="source/lib/atoms/response.js.src.html#l23">View Source</a></div><h1>namespace bot.response</h1><h2>Functions</h2><div id="checkResponse" class="function"><div><h3>checkResponse(<wbr>responseObj)<span class="codelink"><a href="source/lib/atoms/response.js.src.html#l95">code »</a></span></h3><p>Checks that a response object does not specify an error as defined by the
+WebDriver wire protocol. If the response object defines an error, it will
+be thrown. Otherwise, the response will be returned as is.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>responseObj<code>{status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}</code><dd><p>The response object to
+check.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}</code><dd><p>The checked response object.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="class_bot_Error.html">bot.Error</a></code><dd><p>If the response describes an error.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="createErrorResponse" class="function"><div><h3>createErrorResponse(<wbr>error)<span class="codelink"><a href="source/lib/atoms/response.js.src.html#l69">code »</a></span></h3><p>Converts an error value into its JSON representation as defined by the
+WebDriver wire protocol.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>error<code>*</code><dd><p>The error value to convert.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}</code><dd><p>The new response object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="createResponse" class="function"><div><h3>createResponse(<wbr>value)<span class="codelink"><a href="source/lib/atoms/response.js.src.html#l52">code »</a></span></h3><p>Creates a new success response object with the provided value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The response value.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>{status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}</code><dd><p>The new response object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isResponseObject" class="function"><div><h3>isResponseObject(<wbr>value)<span class="codelink"><a href="source/lib/atoms/response.js.src.html#l42">code »</a></span></h3><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the given value is a response object.</p>
+</dl></div></div></div></div><h2>Type Definitions</h2><div id="response.ResponseObject" class="property"><dl><dt><a href="source/lib/atoms/response.js.src.html#l35">response.ResponseObject</a><code>{status: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, value: *}</code><dd><p>Type definition for a response object, as defined by the JSON wire protocol.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_bot_userAgent.html b/docs/namespace_bot_userAgent.html
index cde2533..0a884fb 100644
--- a/docs/namespace_bot_userAgent.html
+++ b/docs/namespace_bot_userAgent.html
@@ -1,21 +1,33 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>bot.userAgent</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace bot.userAgent</h1><a class="source" href="source/lib/atoms/userAgent.js.src.html#l20">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l42">code &raquo;</a><span class="member"><a name="bot.userAgent.isEngineVersion">bot.userAgent.isEngineVersion</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the rendering engine version of the current browser is equal to or
- greater than the given version. This implementation differs from
- goog.userAgent.isVersion in the following ways:
- <ol>
- <li>in a Firefox extension, tests the engine version through the XUL version
-     comparator service, because no window.navigator object is available
- <li>in IE, compares the given version to the current documentMode
- </ol></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The version number to check.</dl><tr><th>Returns<tr><td><dl>Whether the browser engine version is the same or higher
-     than the given version.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l68">code &raquo;</a><span class="member"><a name="bot.userAgent.isProductVersion">bot.userAgent.isProductVersion</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the product version of the current browser is equal to or greater
- than the given version. This implementation differs from
- goog.userAgent.product.isVersion in the following ways:
- <ol>
- <li>in a Firefox extension, tests the product version through the XUL version
-     comparator service, because no window.navigator object is available
- <li>on Android, always compares to the version to the OS version
- </ol></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The version number to check.</dl><tr><th>Returns<tr><td><dl>Whether the browser product version is the same or higher
-     than the given version.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l227">code &raquo;</a><span class="member"><a name="bot.userAgent.ANDROID_PRE_GINGERBREAD">bot.userAgent.ANDROID_PRE_GINGERBREAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current browser is Android pre-gingerbread.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l236">code &raquo;</a><span class="member"><a name="bot.userAgent.ANDROID_PRE_ICECREAMSANDWICH">bot.userAgent.ANDROID_PRE_ICECREAMSANDWICH</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current browser is Android pre-icecreamsandwich</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l168">code &raquo;</a><span class="member"><a name="bot.userAgent.ANDROID_VERSION_">bot.userAgent.ANDROID_VERSION_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Android Operating System Version.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l104">code &raquo;</a><span class="member"><a name="bot.userAgent.FIREFOX_EXTENSION">bot.userAgent.FIREFOX_EXTENSION</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether we are in a Firefox extension.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l86">code &raquo;</a><span class="member"><a name="bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_">bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>|function((<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)</code></span></div><p>When we are in a Firefox extension, this is a function that accepts a version
- and returns whether the version of Gecko we are on is the same or higher
- than the given version. When we are not in a Firefox extension, this is null.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l95">code &raquo;</a><span class="member"><a name="bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_">bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>|function((<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)</code></span></div><p>When we are in a Firefox extension, this is a function that accepts a version
- and returns whether the version of Firefox we are on is the same or higher
- than the given version. When we are not in a Firefox extension, this is null.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l210">code &raquo;</a><span class="member"><a name="bot.userAgent.IE_DOC_10">bot.userAgent.IE_DOC_10</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current document is IE in IE10 (or newer) standards mode.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l193">code &raquo;</a><span class="member"><a name="bot.userAgent.IE_DOC_9">bot.userAgent.IE_DOC_9</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current document is IE in IE9 (or newer) standards mode.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l218">code &raquo;</a><span class="member"><a name="bot.userAgent.IE_DOC_PRE10">bot.userAgent.IE_DOC_PRE10</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current document is IE in a documentMode older than 10.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l184">code &raquo;</a><span class="member"><a name="bot.userAgent.IE_DOC_PRE8">bot.userAgent.IE_DOC_PRE8</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current document is IE in a documentMode older than 8.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l201">code &raquo;</a><span class="member"><a name="bot.userAgent.IE_DOC_PRE9">bot.userAgent.IE_DOC_PRE9</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current document is IE in a documentMode older than 9.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l150">code &raquo;</a><span class="member"><a name="bot.userAgent.IOS">bot.userAgent.IOS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether we are on IOS.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l160">code &raquo;</a><span class="member"><a name="bot.userAgent.MOBILE">bot.userAgent.MOBILE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether we are on a mobile browser.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l245">code &raquo;</a><span class="member"><a name="bot.userAgent.SAFARI_6">bot.userAgent.SAFARI_6</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current browser is Safari 6.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/atoms/userAgent.js.src.html#l254">code &raquo;</a><span class="member"><a name="bot.userAgent.WINDOWS_PHONE">bot.userAgent.WINDOWS_PHONE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current browser is Windows Phone.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>bot.userAgent</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><div class="codelink"><a href="source/lib/atoms/userAgent.js.src.html#l22">View Source</a></div><h1>namespace bot.userAgent</h1><h2>Functions</h2><div id="isEngineVersion" class="function"><div><h3>isEngineVersion(<wbr>version)<span class="codelink"><a href="source/lib/atoms/userAgent.js.src.html#l44">code »</a></span></h3><p>Whether the rendering engine version of the current browser is equal to or
+greater than the given version. This implementation differs from
+goog.userAgent.isVersion in the following ways:</p>
+<ol><li>in a Firefox extension, tests the engine version through the XUL version
+    comparator service, because no window.navigator object is available
+</li><li>in IE, compares the given version to the current documentMode
+</li></ol>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>version<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd><p>The version number to check.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the browser engine version is the same or higher
+than the given version.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isProductVersion" class="function"><div><h3>isProductVersion(<wbr>version)<span class="codelink"><a href="source/lib/atoms/userAgent.js.src.html#l70">code »</a></span></h3><p>Whether the product version of the current browser is equal to or greater
+than the given version. This implementation differs from
+goog.userAgent.product.isVersion in the following ways:</p>
+<ol><li>in a Firefox extension, tests the product version through the XUL version
+    comparator service, because no window.navigator object is available
+</li><li>on Android, always compares to the version to the OS version
+</li></ol>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>version<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd><p>The version number to check.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the browser product version is the same or higher
+than the given version.</p>
+</dl></div></div></div></div><h2>Properties</h2><div id="ANDROID_PRE_GINGERBREAD" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l229">ANDROID_PRE_GINGERBREAD</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current browser is Android pre-gingerbread.</p>
+</dl></div><div id="ANDROID_PRE_ICECREAMSANDWICH" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l238">ANDROID_PRE_ICECREAMSANDWICH</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current browser is Android pre-icecreamsandwich</p>
+</dl></div><div id="FIREFOX_EXTENSION" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l106">FIREFOX_EXTENSION</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether we are in a Firefox extension.</p>
+</dl></div><div id="IE_DOC_10" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l212">IE_DOC_10</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current document is IE in IE10 (or newer) standards mode.</p>
+</dl></div><div id="IE_DOC_9" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l195">IE_DOC_9</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current document is IE in IE9 (or newer) standards mode.</p>
+</dl></div><div id="IE_DOC_PRE10" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l220">IE_DOC_PRE10</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current document is IE in a documentMode older than 10.</p>
+</dl></div><div id="IE_DOC_PRE8" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l186">IE_DOC_PRE8</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current document is IE in a documentMode older than 8.</p>
+</dl></div><div id="IE_DOC_PRE9" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l203">IE_DOC_PRE9</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current document is IE in a documentMode older than 9.</p>
+</dl></div><div id="IOS" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l152">IOS</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether we are on IOS.</p>
+</dl></div><div id="MOBILE" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l162">MOBILE</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether we are on a mobile browser.</p>
+</dl></div><div id="SAFARI_6" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l247">SAFARI_6</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current browser is Safari 6.</p>
+</dl></div><div id="WINDOWS_PHONE" class="property"><dl><dt><a href="source/lib/atoms/userAgent.js.src.html#l256">WINDOWS_PHONE</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current browser is Windows Phone.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_goog.html b/docs/namespace_goog.html
index 8c7b435..4d1beec 100644
--- a/docs/namespace_goog.html
+++ b/docs/namespace_goog.html
@@ -1,57 +1,53 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog</h1><a class="source" href="source/lib/goog/base.js.src.html#l41">code &raquo;</a></header><section><p>Base namespace for the Closure library.  Checks to see goog is
- already defined in the current scope before assigning to prevent
- clobbering if base.js is loaded more than once.</section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_Uri.html">goog.Uri</a><dd>This class contains setters and getters for the parts of the URI.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l475">code &raquo;</a><span class="member"><a name="goog.abstractMethod">goog.abstractMethod</a> <span class="args">( )</span></span></div><p>When defining a class Foo with an abstract method bar(), you can do:
-
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog</h1><a class="source" href="source/lib/goog/base.js.src.html#l41">code &raquo;</a></header><section><p>Base namespace for the Closure library.  Checks to see goog is already
+ defined in the current scope before assigning to prevent clobbering if
+ base.js is loaded more than once.</section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_Disposable.html">goog.Disposable</a><dd>Class that provides the basic implementation for disposable objects.<dt><a href="class_goog_Uri.html">goog.Uri</a><dd>This class contains setters and getters for the parts of the URI.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l636">code &raquo;</a><span class="member"><a name="goog.abstractMethod">goog.abstractMethod</a> <span class="args">( )</span></span></div><p>When defining a class Foo with an abstract method bar(), you can do:
  Foo.prototype.bar = goog.abstractMethod
 
- Now if a subclass of Foo fails to override bar(), an error
- will be thrown when bar() is invoked.
+ Now if a subclass of Foo fails to override bar(), an error will be thrown
+ when bar() is invoked.
 
- Note: This does not take the name of the function to override as
- an argument because that would make it more difficult to obfuscate
- our JavaScript code.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>when invoked to indicate the method should be
-   overridden.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l306">code &raquo;</a><span class="member"><a name="goog.addDependency">goog.addDependency</a> <span class="args">( relPath, provides, requires )</span></span></div><p>Adds a dependency from a file to the files it requires.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>relPath: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The path to the js file.<dt>provides: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>An array of strings with the names of the objects
+ Note: This does not take the name of the function to override as an argument
+ because that would make it more difficult to obfuscate our JavaScript code.</summary><div class="info"><table><tbody><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>when invoked to indicate the method should be overridden.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l463">code &raquo;</a><span class="member"><a name="goog.addDependency">goog.addDependency</a> <span class="args">( relPath, provides, requires, opt_isModule )</span></span></div><p>Adds a dependency from a file to the files it requires.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>relPath: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The path to the js file.<dt>provides: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>An array of strings with the names of the objects
                          this file provides.<dt>requires: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>An array of strings with the names of the objects
-                         this file requires.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l486">code &raquo;</a><span class="member"><a name="goog.addSingletonGetter">goog.addSingletonGetter</a> <span class="args">( ctor )</span></span></div><p>Adds a <code >getInstance</code> static method that always return the same instance
- object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ctor: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The constructor for the class to add the static
-     method to.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1555">code &raquo;</a><span class="member"><a name="goog.base">goog.base</a> <span class="args">( me, opt_methodName, var_args )</span> &rArr; <code class="type">*</code></span></div><p>Call up to the superclass.
+                         this file requires.<dt>opt_isModule: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether this dependency must be loaded as
+     a module as declared by goog.module.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l647">code &raquo;</a><span class="member"><a name="goog.addSingletonGetter">goog.addSingletonGetter</a> <span class="args">( ctor )</span></span></div><p>Adds a <code >getInstance</code> static method that always returns the same
+ instance object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ctor: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The constructor for the class to add the static
+     method to.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1967">code &raquo;</a><span class="member"><a name="goog.base">goog.base</a> <span class="args">( me, opt_methodName, var_args )</span> &rArr; <code class="type">*</code></span></div><p>Call up to the superclass.
 
  If this is called from a constructor, then this calls the superclass
- contructor with arguments 1-N.
+ constructor with arguments 1-N.
 
- If this is called from a prototype method, then you must pass
- the name of the method as the second argument to this function. If
- you do not, you will get a runtime error. This calls the superclass'
- method with arguments 2-N.
+ If this is called from a prototype method, then you must pass the name of the
+ method as the second argument to this function. If you do not, you will get a
+ runtime error. This calls the superclass' method with arguments 2-N.
 
- This function only works if you use goog.inherits to express
- inheritance relationships between your classes.
+ This function only works if you use goog.inherits to express inheritance
+ relationships between your classes.
 
- This function is a compiler primitive. At compile-time, the
- compiler will do macro expansion to remove a lot of
- the extra overhead that this function introduces. The compiler
- will also enforce a lot of the assumptions that this function
- makes, and treat it as a compiler error if you break them.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>me: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Should always be "this".<dt>opt_methodName: <code class="type">*=</code><dd>The method name if calling a super method.<dt>var_args: <code class="type">...*</code><dd>The rest of the arguments.</dl><tr><th>Returns<tr><td><dl>The return value of the superclass method.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1139">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.bind">goog.bind</a> <span class="args">( fn, selfObj, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Partially applies this function to a particular 'this object' and zero or
+ This function is a compiler primitive. At compile-time, the compiler will do
+ macro expansion to remove a lot of the extra overhead that this function
+ introduces. The compiler will also enforce a lot of the assumptions that this
+ function makes, and treat it as a compiler error if you break them.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>me: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Should always be "this".<dt>opt_methodName: <code class="type">*=</code><dd>The method name if calling a super method.<dt>var_args: <code class="type">...*</code><dd>The rest of the arguments.</dl><tr><th>Returns<tr><td><dl>The return value of the superclass method.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1544">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.bind">goog.bind</a> <span class="args">( fn, selfObj, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Partially applies this function to a particular 'this object' and zero or
  more arguments. The result is a new function with some arguments of the first
- function pre-filled and the value of |this| 'pre-specified'.<br><br>
+ function pre-filled and the value of this 'pre-specified'.
 
- Remaining arguments specified at call-time are appended to the pre-
- specified ones.<br><br>
+ Remaining arguments specified at call-time are appended to the pre-specified
+ ones.
 
- Also see: <code  class="type"><a class="unresolved-link">#partial</a></code>.<br><br>
+ Also see: <code  class="type"><a class="unresolved-link">#partial</a></code>.
 
  Usage:
  <pre>var barMethBound = bind(myFunction, myObj, 'arg1', 'arg2');
- barMethBound('arg3', 'arg4');</pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">?function(this: T, ...)</code><dd>A function to partially apply.<dt>selfObj: <code class="type">T</code><dd>Specifies the object which |this| should
-     point to when the function is run.<dt>var_args: <code class="type">...*</code><dd>Additional arguments that are partially
-     applied to the function.</dl><tr><th>Returns<tr><td><dl>A partially-applied form of the function bind() was
-     invoked as a method of.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1093">code &raquo;</a><span class="member"><a name="goog.bindJs_">goog.bindJs_</a> <span class="args">( fn, selfObj, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A pure-JS implementation of goog.bind.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function to partially apply.<dt>selfObj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Specifies the object which |this| should
-     point to when the function is run.<dt>var_args: <code class="type">...*</code><dd>Additional arguments that are partially
-     applied to the function.</dl><tr><th>Returns<tr><td><dl>A partially-applied form of the function bind() was
-     invoked as a method of.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1077">code &raquo;</a><span class="member"><a name="goog.bindNative_">goog.bindNative_</a> <span class="args">( fn, selfObj, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A native implementation of goog.bind.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function to partially apply.<dt>selfObj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Specifies the object which |this| should
-     point to when the function is run.<dt>var_args: <code class="type">...*</code><dd>Additional arguments that are partially
-     applied to the function.</dl><tr><th>Returns<tr><td><dl>A partially-applied form of the function bind() was
-     invoked as a method of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1046">code &raquo;</a><span class="member deprecation-notice"><a name="goog.cloneObject">goog.cloneObject</a> <span class="args">( obj )</span> &rArr; <code class="type">*</code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">goog.cloneObject is unsafe. Prefer the goog.object methods.</span></div><p>Clones a value. The input may be an Object, Array, or basic type. Objects and
+ barMethBound('arg3', 'arg4');</pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">?function(this: T, ...)</code><dd>A function to partially apply.<dt>selfObj: <code class="type">T</code><dd>Specifies the object which this should point to when the
+     function is run.<dt>var_args: <code class="type">...*</code><dd>Additional arguments that are partially applied to the
+     function.</dl><tr><th>Returns<tr><td><dl>A partially-applied form of the function bind() was
+     invoked as a method of.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1498">code &raquo;</a><span class="member"><a name="goog.bindJs_">goog.bindJs_</a> <span class="args">( fn, selfObj, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A pure-JS implementation of goog.bind.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function to partially apply.<dt>selfObj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Specifies the object which this should
+     point to when the function is run.<dt>var_args: <code class="type">...*</code><dd>Additional arguments that are partially applied to the
+     function.</dl><tr><th>Returns<tr><td><dl>A partially-applied form of the function bind() was
+     invoked as a method of.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1482">code &raquo;</a><span class="member"><a name="goog.bindNative_">goog.bindNative_</a> <span class="args">( fn, selfObj, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>A native implementation of goog.bind.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function to partially apply.<dt>selfObj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Specifies the object which this should
+     point to when the function is run.<dt>var_args: <code class="type">...*</code><dd>Additional arguments that are partially applied to the
+     function.</dl><tr><th>Returns<tr><td><dl>A partially-applied form of the function bind() was
+     invoked as a method of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1451">code &raquo;</a><span class="member deprecation-notice"><a name="goog.cloneObject">goog.cloneObject</a> <span class="args">( obj )</span> &rArr; <code class="type">*</code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">goog.cloneObject is unsafe. Prefer the goog.object methods.</span></div><p>Clones a value. The input may be an Object, Array, or basic type. Objects and
  arrays will be cloned recursively.
 
  WARNINGS:
@@ -59,60 +55,83 @@
  refer to themselves will cause infinite recursion.
 
  <code>goog.cloneObject</code> is unaware of unique identifiers, and copies
- UIDs created by <code>getUid</code> into cloned results.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The value to clone.</dl><tr><th>Returns<tr><td><dl>A clone of the input value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l120">code &raquo;</a><span class="member"><a name="goog.define">goog.define</a> <span class="args">( name, defaultValue )</span></span></div><p>Defines a named value. In uncompiled mode, the value is retreived from
- CLOSURE_DEFINES if the object is defined and has the property specified,
- and otherwise used the defined defaultValue. When compiled, the default
- can be overridden using compiler command-line options.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The distinguished name to provide.<dt>defaultValue</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l81">code &raquo;</a><span class="member"><a name="goog.exportPath_">goog.exportPath_</a> <span class="args">( name, opt_object, opt_objectToExportTo )</span></span></div><p>Builds an object structure for the provided namespace path,
- ensuring that names that already exist are not overwritten. For
- example:
+ UIDs created by <code>getUid</code> into cloned results.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The value to clone.</dl><tr><th>Returns<tr><td><dl>A clone of the input value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l156">code &raquo;</a><span class="member"><a name="goog.define">goog.define</a> <span class="args">( name, defaultValue )</span></span></div><p>Defines a named value. In uncompiled mode, the value is retreived from
+ CLOSURE_DEFINES or CLOSURE_UNCOMPILED_DEFINES if the object is defined and
+ has the property specified, and otherwise used the defined defaultValue.
+ When compiled, the default can be overridden using compiler command-line
+ options.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The distinguished name to provide.<dt>defaultValue</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2064">code &raquo;</a><span class="member"><a name="goog.defineClass">goog.defineClass</a> <span class="args">( superClass, def )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Creates a restricted form of a Closure "class":
+   - from the compiler's perspective, the instance returned from the
+     constructor is sealed (no new properties may be added).  This enables
+     better checks.
+   - the compiler will rewrite this definition to a form that is optimal
+     for type checking and optimization (initially this will be a more
+     traditional form).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>superClass: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The superclass, Object or null.<dt>def: <code class="type"><a href="namespace_goog_defineClass.html#goog.defineClass.ClassDescriptor">goog.defineClass.ClassDescriptor</a></code><dd>An object literal describing the
+     the class.  It may have the following properties:
+     "constructor": the constructor function
+     "statics": an object literal containing methods to add to the constructor
+        as "static" methods or a function that will receive the constructor
+        function as its only parameter to which static properties can
+        be added.
+     all other properties are added to the prototype.</dl><tr><th>Returns<tr><td><dl>The class constructor.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l279">code &raquo;</a><span class="member"><a name="goog.dispose">goog.dispose</a> <span class="args">( obj )</span></span></div><p>Calls <code >dispose</code> on the argument if it supports it. If obj is not an
+     object with a dispose() method, this is a no-op.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The object to dispose of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/disposable/disposable.js.src.html#l293">code &raquo;</a><span class="member"><a name="goog.disposeAll">goog.disposeAll</a> <span class="args">( var_args )</span></span></div><p>Calls <code >dispose</code> on each member of the list that supports it. (If the
+ member is an ArrayLike, then <code >goog.disposeAll()</code> will be called
+ recursively on each of its members.) If the member is not an object with a
+ <code >dispose()</code> method, then it is ignored.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...*</code><dd>The list.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l116">code &raquo;</a><span class="member"><a name="goog.exportPath_">goog.exportPath_</a> <span class="args">( name, opt_object, opt_objectToExportTo )</span></span></div><p>Builds an object structure for the provided namespace path, ensuring that
+ names that already exist are not overwritten. For example:
  "a.b.c" -> a = {};a.b={};a.b.c={};
  Used by goog.provide and goog.exportSymbol.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>name of the object that this file defines.<dt>opt_object: <code class="type">*=</code><dd>the object to expose at the end of the path.<dt>opt_objectToExportTo: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object to add the path to; default
-     is |goog.global|.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1484">code &raquo;</a><span class="member"><a name="goog.exportProperty">goog.exportProperty</a> <span class="args">( object, publicName, symbol )</span></span></div><p>Exports a property unobfuscated into the object's namespace.
+     is |goog.global|.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1884">code &raquo;</a><span class="member"><a name="goog.exportProperty">goog.exportProperty</a> <span class="args">( object, publicName, symbol )</span></span></div><p>Exports a property unobfuscated into the object's namespace.
  ex. goog.exportProperty(Foo, 'staticFunction', Foo.staticFunction);
- ex. goog.exportProperty(Foo.prototype, 'myMethod', Foo.prototype.myMethod);</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object whose static property is being exported.<dt>publicName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Unobfuscated name to export.<dt>symbol: <code class="type">*</code><dd>Object the name should point to.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1471">code &raquo;</a><span class="member"><a name="goog.exportSymbol">goog.exportSymbol</a> <span class="args">( publicPath, object, opt_objectToExportTo )</span></span></div><p>Exposes an unobfuscated global namespace path for the given object.
- Note that fields of the exported object *will* be obfuscated,
- unless they are exported in turn via this function or
- goog.exportProperty
+ ex. goog.exportProperty(Foo.prototype, 'myMethod', Foo.prototype.myMethod);</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object whose static property is being exported.<dt>publicName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Unobfuscated name to export.<dt>symbol: <code class="type">*</code><dd>Object the name should point to.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1871">code &raquo;</a><span class="member"><a name="goog.exportSymbol">goog.exportSymbol</a> <span class="args">( publicPath, object, opt_objectToExportTo )</span></span></div><p>Exposes an unobfuscated global namespace path for the given object.
+ Note that fields of the exported object *will* be obfuscated, unless they are
+ exported in turn via this function or goog.exportProperty.
 
- <p>Also handy for making public items that are defined in anonymous
- closures.
+ Also handy for making public items that are defined in anonymous closures.
 
  ex. goog.exportSymbol('public.path.Foo', Foo);
 
- ex. goog.exportSymbol('public.path.Foo.staticFunction',
-                       Foo.staticFunction);
+ ex. goog.exportSymbol('public.path.Foo.staticFunction', Foo.staticFunction);
      public.path.Foo.staticFunction();
 
  ex. goog.exportSymbol('public.path.Foo.prototype.myMethod',
                        Foo.prototype.myMethod);
      new public.path.Foo().myMethod();</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>publicPath: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Unobfuscated name to export.<dt>object: <code class="type">*</code><dd>Object the name should point to.<dt>opt_objectToExportTo: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object to add the path to; default
-     is |goog.global|.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l560">code &raquo;</a><span class="member"><a name="goog.findBasePath_">goog.findBasePath_</a> <span class="args">( )</span></span></div><p>Tries to detect the base path of the base.js script that bootstraps Closure</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1317">code &raquo;</a><span class="member"><a name="goog.getCssName">goog.getCssName</a> <span class="args">( className, opt_modifier )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Handles strings that are intended to be used as CSS class names.
+     is goog.global.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l738">code &raquo;</a><span class="member"><a name="goog.findBasePath_">goog.findBasePath_</a> <span class="args">( )</span></span></div><p>Tries to detect the base path of base.js script that bootstraps Closure.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l377">code &raquo;</a><span class="member"><a name="goog.forwardDeclare">goog.forwardDeclare</a> <span class="args">( name )</span></span></div><p>Forward declares a symbol. This is an indication to the compiler that the
+ symbol may be used in the source yet is not required and may not be provided
+ in compilation.
+
+ The most common usage of forward declaration is code that takes a type as a
+ function parameter but does not need to require it. By forward declaring
+ instead of requiring, no hard dependency is made, and (if not required
+ elsewhere) the namespace may never be required and thus, not be pulled
+ into the JavaScript binary. If it is required elsewhere, it will be type
+ checked as normal.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The namespace to forward declare in the form of
+     "goog.package.part".</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1720">code &raquo;</a><span class="member"><a name="goog.getCssName">goog.getCssName</a> <span class="args">( className, opt_modifier )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Handles strings that are intended to be used as CSS class names.
 
  This function works in tandem with @see goog.setCssNameMapping.
 
- Without any mapping set, the arguments are simple joined with a
- hyphen and passed through unaltered.
+ Without any mapping set, the arguments are simple joined with a hyphen and
+ passed through unaltered.
 
- When there is a mapping, there are two possible styles in which
- these mappings are used. In the BY_PART style, each part (i.e. in
- between hyphens) of the passed in css name is rewritten according
- to the map. In the BY_WHOLE style, the full css name is looked up in
- the map directly. If a rewrite is not specified by the map, the
- compiler will output a warning.
+ When there is a mapping, there are two possible styles in which these
+ mappings are used. In the BY_PART style, each part (i.e. in between hyphens)
+ of the passed in css name is rewritten according to the map. In the BY_WHOLE
+ style, the full css name is looked up in the map directly. If a rewrite is
+ not specified by the map, the compiler will output a warning.
 
- When the mapping is passed to the compiler, it will replace calls
- to goog.getCssName with the strings from the mapping, e.g.
+ When the mapping is passed to the compiler, it will replace calls to
+ goog.getCssName with the strings from the mapping, e.g.
      var x = goog.getCssName('foo');
      var y = goog.getCssName(this.baseClass, 'active');
   becomes:
      var x= 'foo';
      var y = this.baseClass + '-active';
 
- If one argument is passed it will be processed, if two are passed
- only the modifier will be processed, as it is assumed the first
- argument was generated as a result of calling goog.getCssName.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The class name.<dt>opt_modifier: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A modifier to be appended to the class name.</dl><tr><th>Returns<tr><td><dl>The class name or the concatenation of the class name and
-     the modifier.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1020">code &raquo;</a><span class="member deprecation-notice"><a name="goog.getHashCode">goog.getHashCode</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.getUid instead.</span></div><p>Adds a hash code field to an object. The hash code is unique for the
- given object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to get the hash code for.</dl><tr><th>Returns<tr><td><dl>The hash code for the object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1417">code &raquo;</a><span class="member"><a name="goog.getMsg">goog.getMsg</a> <span class="args">( str, opt_values )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets a localized message.
+ If one argument is passed it will be processed, if two are passed only the
+ modifier will be processed, as it is assumed the first argument was generated
+ as a result of calling goog.getCssName.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The class name.<dt>opt_modifier: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A modifier to be appended to the class name.</dl><tr><th>Returns<tr><td><dl>The class name or the concatenation of the class name and
+     the modifier.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1425">code &raquo;</a><span class="member deprecation-notice"><a name="goog.getHashCode">goog.getHashCode</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.getUid instead.</span></div><p>Adds a hash code field to an object. The hash code is unique for the
+ given object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to get the hash code for.</dl><tr><th>Returns<tr><td><dl>The hash code for the object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1820">code &raquo;</a><span class="member"><a name="goog.getMsg">goog.getMsg</a> <span class="args">( str, opt_values )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets a localized message.
 
  This function is a compiler primitive. If you give the compiler a localized
  message bundle, it will replace the string at compile-time with a localized
@@ -121,87 +140,95 @@
  Messages must be initialized in the form:
  <code>
  var MSG_NAME = goog.getMsg('Hello {$placeholder}', {'placeholder': 'world'});
- </code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Translatable string, places holders in the form {$foo}.<dt>opt_values: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Map of place holder name to value.</dl><tr><th>Returns<tr><td><dl>message with placeholders filled.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1442">code &raquo;</a><span class="member"><a name="goog.getMsgWithFallback">goog.getMsgWithFallback</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets a localized message. If the message does not have a translation, gives a
+ </code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Translatable string, places holders in the form {$foo}.<dt>opt_values: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Map of place holder name to value.</dl><tr><th>Returns<tr><td><dl>message with placeholders filled.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1845">code &raquo;</a><span class="member"><a name="goog.getMsgWithFallback">goog.getMsgWithFallback</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets a localized message. If the message does not have a translation, gives a
  fallback message.
 
  This is useful when introducing a new message that has not yet been
  translated into all languages.
 
- This function is a compiler primtive. Must be used in the form:
+ This function is a compiler primitive. Must be used in the form:
  <code>var x = goog.getMsgWithFallback(MSG_A, MSG_B);</code>
- where MSG_A and MSG_B were initialized with goog.getMsg.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The preferred message.<dt>b: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The fallback message.</dl><tr><th>Returns<tr><td><dl>The best translated message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l268">code &raquo;</a><span class="member"><a name="goog.getObjectByName">goog.getObjectByName</a> <span class="args">( name, opt_obj )</span></span></div><p>Returns an object based on its fully qualified external name.  If you are
- using a compilation pass that renames property names beware that using this
- function will not find renamed properties.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The fully qualified name.<dt>opt_obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object within which to look; default is
-     |goog.global|.</dl><tr><th>Returns<tr><td><dl>The value (object or primitive) or, if not found, null.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l706">code &raquo;</a><span class="member"><a name="goog.getPathFromDeps_">goog.getPathFromDeps_</a> <span class="args">( rule )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Looks at the dependency rules and tries to determine the script file that
- fulfills a particular rule.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rule: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>In the form goog.namespace.Class or project.script.</dl><tr><th>Returns<tr><td><dl>Url corresponding to the rule, or null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l963">code &raquo;</a><span class="member"><a name="goog.getUid">goog.getUid</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Gets a unique ID for an object. This mutates the object so that further
- calls with the same object as a parameter returns the same value. The unique
- ID is guaranteed to be unique across the current session amongst objects that
- are passed into <code >getUid</code>. There is no guarantee that the ID is unique
- or consistent across sessions. It is unsafe to generate unique ID for
- function prototypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to get the unique ID for.</dl><tr><th>Returns<tr><td><dl>The unique ID for the object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1221">code &raquo;</a><span class="member"><a name="goog.globalEval">goog.globalEval</a> <span class="args">( script )</span></span></div><p>Evals javascript in the global scope.  In IE this uses execScript, other
+ where MSG_A and MSG_B were initialized with goog.getMsg.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The preferred message.<dt>b: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The fallback message.</dl><tr><th>Returns<tr><td><dl>The best translated message.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l423">code &raquo;</a><span class="member"><a name="goog.getObjectByName">goog.getObjectByName</a> <span class="args">( name, opt_obj )</span></span></div><p>Returns an object based on its fully qualified external name.  The object
+ is not found if null or undefined.  If you are using a compilation pass that
+ renames property names beware that using this function will not find renamed
+ properties.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The fully qualified name.<dt>opt_obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object within which to look; default is
+     |goog.global|.</dl><tr><th>Returns<tr><td><dl>The value (object or primitive) or, if not found, null.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1113">code &raquo;</a><span class="member"><a name="goog.getPathFromDeps_">goog.getPathFromDeps_</a> <span class="args">( rule )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Looks at the dependency rules and tries to determine the script file that
+ fulfills a particular rule.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rule: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>In the form goog.namespace.Class or project.script.</dl><tr><th>Returns<tr><td><dl>Url corresponding to the rule, or null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1355">code &raquo;</a><span class="member"><a name="goog.getUid">goog.getUid</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Gets a unique ID for an object. This mutates the object so that further calls
+ with the same object as a parameter returns the same value. The unique ID is
+ guaranteed to be unique across the current session amongst objects that are
+ passed into <code >getUid</code>. There is no guarantee that the ID is unique or
+ consistent across sessions. It is unsafe to generate unique ID for function
+ prototypes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to get the unique ID for.</dl><tr><th>Returns<tr><td><dl>The unique ID for the object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1625">code &raquo;</a><span class="member"><a name="goog.globalEval">goog.globalEval</a> <span class="args">( script )</span></span></div><p>Evals JavaScript in the global scope.  In IE this uses execScript, other
  browsers use goog.global.eval. If goog.global.eval does not evaluate in the
  global scope (for example, in Safari), appends a script tag instead.
- Throws an exception if neither execScript or eval is defined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>script: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>JavaScript string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l290">code &raquo;</a><span class="member deprecation-notice"><a name="goog.globalize">goog.globalize</a> <span class="args">( obj, opt_global )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Properties may be explicitly exported to the global scope, but
-     this should no longer be done in bulk.</span></div><p>Globalizes a whole namespace, such as goog or goog.lang.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The namespace to globalize.<dt>opt_global: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object to add the properties to.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l454">code &raquo;</a><span class="member deprecation-notice"><a name="goog.identityFunction">goog.identityFunction</a> <span class="args">( opt_returnValue, var_args )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.functions.identity instead.</span></div><p>The identity function. Returns its first argument.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_returnValue: <code class="type">*=</code><dd>The single value that will be returned.<dt>var_args: <code class="type">...*</code><dd>Optional trailing arguments. These are ignored.</dl><tr><th>Returns<tr><td><dl>The first argument. We can't know the type -- just pass it along
-      without type.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l589">code &raquo;</a><span class="member"><a name="goog.importScript_">goog.importScript_</a> <span class="args">( src )</span></span></div><p>Imports a script if, and only if, that script hasn't already been imported.
- (Must be called at execution time)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Script source.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l549">code &raquo;</a><span class="member"><a name="goog.inHtmlDocument_">goog.inHtmlDocument_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tries to detect whether is in the context of an HTML document.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>True if it looks like HTML document.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1519">code &raquo;</a><span class="member"><a name="goog.inherits">goog.inherits</a> <span class="args">( childCtor, parentCtor )</span></span></div><p>Inherit the prototype methods from one constructor into another.
+ Throws an exception if neither execScript or eval is defined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>script: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>JavaScript string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l445">code &raquo;</a><span class="member deprecation-notice"><a name="goog.globalize">goog.globalize</a> <span class="args">( obj, opt_global )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Properties may be explicitly exported to the global scope, but
+     this should no longer be done in bulk.</span></div><p>Globalizes a whole namespace, such as goog or goog.lang.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The namespace to globalize.<dt>opt_global: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object to add the properties to.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1374">code &raquo;</a><span class="member"><a name="goog.hasUid">goog.hasUid</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the given object is alreay assigned a unique ID.
+
+ This does not modify the object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to check.</dl><tr><th>Returns<tr><td><dl>Whether there an assigned unique id for the object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l618">code &raquo;</a><span class="member deprecation-notice"><a name="goog.identityFunction">goog.identityFunction</a> <span class="args">( opt_returnValue, var_args )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.functions.identity instead.</span></div><p>The identity function. Returns its first argument.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_returnValue: <code class="type">*=</code><dd>The single value that will be returned.<dt>var_args: <code class="type">...*</code><dd>Optional trailing arguments. These are ignored.</dl><tr><th>Returns<tr><td><dl>The first argument. We can't know the type -- just pass it along
+      without type.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l787">code &raquo;</a><span class="member"><a name="goog.importModule_">goog.importModule_</a> <span class="args">( src )</span></span></div><p>Given a URL initiate retrieval and execution of the module.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Script source URL.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l768">code &raquo;</a><span class="member"><a name="goog.importScript_">goog.importScript_</a> <span class="args">( src, opt_sourceText )</span></span></div><p>Imports a script if, and only if, that script hasn't already been imported.
+ (Must be called at execution time)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Script source.<dt>opt_sourceText: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The optionally source text to evaluate</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l727">code &raquo;</a><span class="member"><a name="goog.inHtmlDocument_">goog.inHtmlDocument_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tries to detect whether is in the context of an HTML document.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>True if it looks like HTML document.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1909">code &raquo;</a><span class="member"><a name="goog.inherits">goog.inherits</a> <span class="args">( childCtor, parentCtor )</span></span></div><p>Inherit the prototype methods from one constructor into another.
 
  Usage:
  <pre>
  function ParentClass(a, b) { }
- ParentClass.prototype.foo = function(a) { }
+ ParentClass.prototype.foo = function(a) { };
 
  function ChildClass(a, b, c) {
-   goog.base(this, a, b);
+   ChildClass.base(this, 'constructor', a, b);
  }
  goog.inherits(ChildClass, ParentClass);
 
  var child = new ChildClass('a', 'b', 'see');
- child.foo(); // works
- </pre>
-
- In addition, a superclass' implementation of a method can be invoked
- as follows:
-
- <pre>
- ChildClass.prototype.foo = function(a) {
-   ChildClass.superClass_.foo.call(this, a);
-   // other code
- };
- </pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>childCtor: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Child class.<dt>parentCtor: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Parent class.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l869">code &raquo;</a><span class="member"><a name="goog.isArray">goog.isArray</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is an array</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is an array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l881">code &raquo;</a><span class="member"><a name="goog.isArrayLike">goog.isArrayLike</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the object looks like an array. To qualify as array like
+ child.foo(); // This works.
+ </pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>childCtor: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Child class.<dt>parentCtor: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Parent class.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1261">code &raquo;</a><span class="member"><a name="goog.isArray">goog.isArray</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is an array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is an array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1273">code &raquo;</a><span class="member"><a name="goog.isArrayLike">goog.isArrayLike</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the object looks like an array. To qualify as array like
  the value needs to be either a NodeList or an object with a Number length
- property.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is an array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l913">code &raquo;</a><span class="member"><a name="goog.isBoolean">goog.isBoolean</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a boolean</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is boolean.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l893">code &raquo;</a><span class="member"><a name="goog.isDateLike">goog.isDateLike</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the object looks like a Date. To qualify as Date-like
- the value needs to be an object and have a getFullYear() function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is a like a Date.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l838">code &raquo;</a><span class="member"><a name="goog.isDef">goog.isDef</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is not |undefined|.
+ property.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is an array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1305">code &raquo;</a><span class="member"><a name="goog.isBoolean">goog.isBoolean</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a boolean.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is boolean.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1285">code &raquo;</a><span class="member"><a name="goog.isDateLike">goog.isDateLike</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the object looks like a Date. To qualify as Date-like the
+ value needs to be an object and have a getFullYear() function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is a like a Date.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l98">code &raquo;</a><span class="member"><a name="goog.isDef">goog.isDef</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is not undefined.
  WARNING: Do not use this to test if an object has a property. Use the in
- operator instead.  Additionally, this function assumes that the global
- undefined variable has not been redefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is defined.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l858">code &raquo;</a><span class="member"><a name="goog.isDefAndNotNull">goog.isDefAndNotNull</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is defined and not null</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is defined and not null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l933">code &raquo;</a><span class="member"><a name="goog.isFunction">goog.isFunction</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a function</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is a function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l848">code &raquo;</a><span class="member"><a name="goog.isNull">goog.isNull</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is |null|</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l923">code &raquo;</a><span class="member"><a name="goog.isNumber">goog.isNumber</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a number</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is a number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l944">code &raquo;</a><span class="member"><a name="goog.isObject">goog.isObject</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is an object.  This includes arrays
- and functions.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is an object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l242">code &raquo;</a><span class="member"><a name="goog.isProvided_">goog.isProvided_</a> <span class="args">( name )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Check if the given name has been goog.provided. This will return false for
- names that are available only as implicit namespaces.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>name of the object to look for.</dl><tr><th>Returns<tr><td><dl>Whether the name has been provided.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l903">code &raquo;</a><span class="member"><a name="goog.isString">goog.isString</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">*</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is a string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1190">code &raquo;</a><span class="member"><a name="goog.mixin">goog.mixin</a> <span class="args">( target, source )</span></span></div><p>Copies all the members of a source object to a target object. This method
+ operator instead.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is defined.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1250">code &raquo;</a><span class="member"><a name="goog.isDefAndNotNull">goog.isDefAndNotNull</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is defined and not null.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is defined and not null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1325">code &raquo;</a><span class="member"><a name="goog.isFunction">goog.isFunction</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is a function.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l318">code &raquo;</a><span class="member"><a name="goog.isInModuleLoader_">goog.isInModuleLoader_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether a goog.module is currently being initialized.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1240">code &raquo;</a><span class="member"><a name="goog.isNull">goog.isNull</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is null.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1315">code &raquo;</a><span class="member"><a name="goog.isNumber">goog.isNumber</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a number.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is a number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1336">code &raquo;</a><span class="member"><a name="goog.isObject">goog.isObject</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is an object.  This includes arrays and
+ functions.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is an object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l389">code &raquo;</a><span class="member"><a name="goog.isProvided_">goog.isProvided_</a> <span class="args">( name )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Check if the given name has been goog.provided. This will return false for
+ names that are available only as implicit namespaces.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>name of the object to look for.</dl><tr><th>Returns<tr><td><dl>Whether the name has been provided.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1295">code &raquo;</a><span class="member"><a name="goog.isString">goog.isString</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether variable is a string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l887">code &raquo;</a><span class="member"><a name="goog.loadModule">goog.loadModule</a> <span class="args">( moduleDef )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>moduleDef: <code class="type">(function(?): ?|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>The module definition.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l932">code &raquo;</a><span class="member"><a name="goog.loadModuleFromSource_">goog.loadModuleFromSource_</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l871">code &raquo;</a><span class="member"><a name="goog.loadQueuedModules_">goog.loadQueuedModules_</a> <span class="args">( )</span></span></div><p>Load any deferred goog.module loads.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l519">code &raquo;</a><span class="member"><a name="goog.logToConsole_">goog.logToConsole_</a> <span class="args">( msg )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>msg</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1594">code &raquo;</a><span class="member"><a name="goog.mixin">goog.mixin</a> <span class="args">( target, source )</span></span></div><p>Copies all the members of a source object to a target object. This method
  does not work on all browsers for all objects that contain keys such as
- toString or hasOwnProperty. Use goog.object.extend for this purpose.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Target.<dt>source: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Source.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1207">code &raquo;</a><span class="member"><a name="goog.now">goog.now</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>An integer value representing the number of milliseconds
-     between midnight, January 1, 1970 and the current time.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l442">code &raquo;</a><span class="member"><a name="goog.nullFunction">goog.nullFunction</a> <span class="args">( )</span> &rArr; <code class="type">void</code></span></div><p>Null function used for default values of callbacks, etc.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Nothing.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1172">code &raquo;</a><span class="member"><a name="goog.partial">goog.partial</a> <span class="args">( fn, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Like bind(), except that a 'this object' is not required. Useful when the
+ toString or hasOwnProperty. Use goog.object.extend for this purpose.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Target.<dt>source: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Source.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l283">code &raquo;</a><span class="member"><a name="goog.module">goog.module</a> <span class="args">( name )</span></span></div><p>goog.module serves two purposes:
+ - marks a file that must be loaded as a module
+ - reserves a namespace (it can not also be goog.provided)
+ and has three requirements:
+ - goog.module may not be used in the same file as goog.provide.
+ - goog.module must be the first statement in the file.
+ - only one goog.module is allowed per file.
+ When a goog.module annotated file is loaded, it is loaded enclosed in
+ a strict function closure. This means that:
+ - any variable declared in a goog.module file are private to the file,
+ not global. Although the compiler is expected to inline the module.
+ - The code must obey all the rules of "strict" JavaScript.
+ - the file will be marked as "use strict"
+
+ NOTE: unlike goog.provide, goog.module does not declare any symbols by
+ itself.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Namespace provided by this file in the form
+     "goog.package.part", is expected but not required.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1611">code &raquo;</a><span class="member"><a name="goog.now">goog.now</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>An integer value representing the number of milliseconds
+     between midnight, January 1, 1970 and the current time.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l606">code &raquo;</a><span class="member"><a name="goog.nullFunction">goog.nullFunction</a> <span class="args">( )</span> &rArr; <code class="type">void</code></span></div><p>Null function used for default values of callbacks, etc.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Nothing.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1009">code &raquo;</a><span class="member"><a name="goog.onScriptLoad_">goog.onScriptLoad_</a> <span class="args">( script, scriptIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>A readystatechange handler for legacy IE</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>script<dt>scriptIndex</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1575">code &raquo;</a><span class="member"><a name="goog.partial">goog.partial</a> <span class="args">( fn, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Like bind(), except that a 'this object' is not required. Useful when the
  target function is already bound.
 
  Usage:
  var g = partial(f, arg1, arg2);
- g(arg3, arg4);</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function to partially apply.<dt>var_args: <code class="type">...*</code><dd>Additional arguments that are partially
-     applied to fn.</dl><tr><th>Returns<tr><td><dl>A partially-applied form of the function bind() was
-     invoked as a method of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l188">code &raquo;</a><span class="member"><a name="goog.provide">goog.provide</a> <span class="args">( name )</span></span></div><p>Creates object stubs for a namespace.  The presence of one or more
+ g(arg3, arg4);</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function to partially apply.<dt>var_args: <code class="type">...*</code><dd>Additional arguments that are partially applied to fn.</dl><tr><th>Returns<tr><td><dl>A partially-applied form of the function bind() was
+     invoked as a method of.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l240">code &raquo;</a><span class="member"><a name="goog.provide">goog.provide</a> <span class="args">( name )</span></span></div><p>Creates object stubs for a namespace.  The presence of one or more
  goog.provide() calls indicate that the file defines the given
- objects/namespaces.  Build tools also scan for provide/require statements
+ objects/namespaces.  Provided objects must not be null or undefined.
+ Build tools also scan for provide/require statements
  to discern dependencies, build dependency files (see deps.js), etc.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Namespace provided by this file in the form
-     "goog.package.part".</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1028">code &raquo;</a><span class="member deprecation-notice"><a name="goog.removeHashCode">goog.removeHashCode</a> <span class="args">( obj )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.removeUid instead.</span></div><p>Removes the hash code field from an object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to remove the field from.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l980">code &raquo;</a><span class="member"><a name="goog.removeUid">goog.removeUid</a> <span class="args">( obj )</span></span></div><p>Removes the unique ID from an object. This is useful if the object was
+     "goog.package.part".</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1433">code &raquo;</a><span class="member deprecation-notice"><a name="goog.removeHashCode">goog.removeHashCode</a> <span class="args">( obj )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.removeUid instead.</span></div><p>Removes the hash code field from an object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to remove the field from.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1385">code &raquo;</a><span class="member"><a name="goog.removeUid">goog.removeUid</a> <span class="args">( obj )</span></span></div><p>Removes the unique ID from an object. This is useful if the object was
  previously mutated using <code >goog.getUid</code> in which case the mutation is
- undone.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to remove the unique ID field from.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l370">code &raquo;</a><span class="member"><a name="goog.require">goog.require</a> <span class="args">( name )</span></span></div><p>Implements a system for the dynamic resolution of dependencies
- that works in parallel with the BUILD system. Note that all calls
- to goog.require will be stripped by the JSCompiler when the
- --closure_pass option is used.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Namespace to include (as was given in goog.provide())
-     in the form "goog.package.part".</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1606">code &raquo;</a><span class="member"><a name="goog.scope">goog.scope</a> <span class="args">( fn )</span></span></div><p>Allow for aliasing within scope functions.  This function exists for
- uncompiled code - in compiled code the calls will be inlined and the
- aliases applied.  In uncompiled code the function is simply run since the
- aliases as written are valid JavaScript.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function()</code><dd>Function to call.  This function can contain aliases
+ undone.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to remove the unique ID field from.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l536">code &raquo;</a><span class="member"><a name="goog.require">goog.require</a> <span class="args">( name )</span></span></div><p>Implements a system for the dynamic resolution of dependencies that works in
+ parallel with the BUILD system. Note that all calls to goog.require will be
+ stripped by the JSCompiler when the --closure_pass option is used.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Namespace to include (as was given in goog.provide()) in
+     the form "goog.package.part".</dl><tr><th>Returns<tr><td><dl>If called within a goog.module file, the associated namespace or
+     module otherwise null.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l807">code &raquo;</a><span class="member"><a name="goog.retrieveAndExecModule_">goog.retrieveAndExecModule_</a> <span class="args">( src )</span></span></div><p>Retrieve and execute a module.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Script source URL.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2018">code &raquo;</a><span class="member"><a name="goog.scope">goog.scope</a> <span class="args">( fn )</span></span></div><p>Allow for aliasing within scope functions.  This function exists for
+ uncompiled code - in compiled code the calls will be inlined and the aliases
+ applied.  In uncompiled code the function is simply run since the aliases as
+ written are valid JavaScript.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function()</code><dd>Function to call.  This function can contain aliases
      to namespaces (e.g. "var dom = goog.dom") or classes
-    (e.g. "var Timer = goog.Timer").</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1373">code &raquo;</a><span class="member"><a name="goog.setCssNameMapping">goog.setCssNameMapping</a> <span class="args">( mapping, opt_style )</span></span></div><p>Sets the map to check when returning a value from goog.getCssName(). Example:
+     (e.g. "var Timer = goog.Timer").</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1776">code &raquo;</a><span class="member"><a name="goog.setCssNameMapping">goog.setCssNameMapping</a> <span class="args">( mapping, opt_style )</span></span></div><p>Sets the map to check when returning a value from goog.getCssName(). Example:
  <pre>
  goog.setCssNameMapping({
    "goog": "a",
@@ -217,24 +244,30 @@
  --closure_pass flag is set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>mapping: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>A map of strings to strings where keys are possible
      arguments to goog.getCssName() and values are the corresponding values
      that should be returned.<dt>opt_style: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The style of css name mapping. There are two valid
-     options: 'BY_PART', and 'BY_WHOLE'.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l224">code &raquo;</a><span class="member"><a name="goog.setTestOnly">goog.setTestOnly</a> <span class="args">( opt_message )</span></span></div><p>Marks that the current file should only be used for testing, and never for
+     options: 'BY_PART', and 'BY_WHOLE'.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l352">code &raquo;</a><span class="member"><a name="goog.setTestOnly">goog.setTestOnly</a> <span class="args">( opt_message )</span></span></div><p>Marks that the current file should only be used for testing, and never for
  live code in production.
 
- In the case of unit tests, the message may optionally be an exact
- namespace for the test (e.g. 'goog.stringTest'). The linter will then
- ignore the extra provide (if not explicitly defined in the code).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional message to add to the error that's
-     raised when used in production code.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l735">code &raquo;</a><span class="member"><a name="goog.typeOf">goog.typeOf</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>This is a "fixed" version of the typeof operator.  It differs from the typeof
- operator in such a way that null returns 'null' and arrays return 'array'.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to get the type of.</dl><tr><th>Returns<tr><td><dl>The name of the type.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l606">code &raquo;</a><span class="member"><a name="goog.writeScriptTag_">goog.writeScriptTag_</a> <span class="args">( src )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>The default implementation of the import function. Writes a script tag to
- import the script.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The script source.</dl><tr><th>Returns<tr><td><dl>True if the script was imported, false otherwise.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l640">code &raquo;</a><span class="member"><a name="goog.writeScripts_">goog.writeScripts_</a> <span class="args">( )</span></span></div><p>Resolves dependencies based on the dependencies added using addDependency
- and calls importScript_ in the correct order.</summary></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l514">code &raquo;</a><span class="member"><a name="goog.DEPENDENCIES_ENABLED">goog.DEPENDENCIES_ENABLED</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>True if goog.dependencies_ is available.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1002">code &raquo;</a><span class="member"><a name="goog.UID_PROPERTY_">goog.UID_PROPERTY_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Name for unique ID property. Initialized in a way to help avoid collisions
- with other closure javascript on the same page.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l408">code &raquo;</a><span class="member"><a name="goog.basePath">goog.basePath</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Path for included scripts</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1282">code &raquo;</a><span class="member"><a name="goog.cssNameMappingStyle_">goog.cssNameMappingStyle_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Optional obfuscation style for CSS class names. Should be set to either
- 'BY_WHOLE' or 'BY_PART' if defined.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1272">code &raquo;</a><span class="member"><a name="goog.cssNameMapping_">goog.cssNameMapping_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Optional map of CSS class names to obfuscated names used with
- goog.getCssName().</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l533">code &raquo;</a><span class="member"><a name="goog.dependencies_">goog.dependencies_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>This object is used to keep track of dependencies and other data that is
- used for loading scripts</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1262">code &raquo;</a><span class="member"><a name="goog.evalWorksForGlobals_">goog.evalWorksForGlobals_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Indicates whether or not we can call 'eval' directly to eval code in the
+ In the case of unit tests, the message may optionally be an exact namespace
+ for the test (e.g. 'goog.stringTest'). The linter will then ignore the extra
+ provide (if not explicitly defined in the code).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional message to add to the error that's
+     raised when used in production code.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2204">code &raquo;</a><span class="member"><a name="goog.tagUnsealableClass">goog.tagUnsealableClass</a> <span class="args">( ctr )</span></span></div><p>Sealing classes breaks the older idiom of assigning properties on the
+ prototype rather than in the constructor.  As such, goog.defineClass
+ must not seal subclasses of these old-style classes until they are fixed.
+ Until then, this marks a class as "broken", instructing defineClass
+ not to seal subclasses.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ctr: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The legacy constructor to tag as unsealable.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1142">code &raquo;</a><span class="member"><a name="goog.typeOf">goog.typeOf</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>This is a "fixed" version of the typeof operator.  It differs from the typeof
+ operator in such a way that null returns 'null' and arrays return 'array'.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to get the type of.</dl><tr><th>Returns<tr><td><dl>The name of the type.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l847">code &raquo;</a><span class="member"><a name="goog.wrapModule_">goog.wrapModule_</a> <span class="args">( srcUrl, scriptText )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Return an appropriate module text. Suitable to insert into
+ a script tag (that is unescaped).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>srcUrl<dt>scriptText</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l951">code &raquo;</a><span class="member"><a name="goog.writeScriptTag_">goog.writeScriptTag_</a> <span class="args">( src, opt_sourceText )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>The default implementation of the import function. Writes a script tag to
+ import the script.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The script url.<dt>opt_sourceText: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The optionally source text to evaluate</dl><tr><th>Returns<tr><td><dl>True if the script was imported, false otherwise.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1024">code &raquo;</a><span class="member"><a name="goog.writeScripts_">goog.writeScripts_</a> <span class="args">( )</span></span></div><p>Resolves dependencies based on the dependencies added using addDependency
+ and calls importScript_ in the correct order.</summary></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l693">code &raquo;</a><span class="member"><a name="goog.DEPENDENCIES_ENABLED">goog.DEPENDENCIES_ENABLED</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>True if goog.dependencies_ is available.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l778">code &raquo;</a><span class="member"><a name="goog.IS_OLD_IE_">goog.IS_OLD_IE_</a> : <code class="type">?</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1407">code &raquo;</a><span class="member"><a name="goog.UID_PROPERTY_">goog.UID_PROPERTY_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Name for unique ID property. Initialized in a way to help avoid collisions
+ with other closure JavaScript on the same page.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2215">code &raquo;</a><span class="member"><a name="goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_">goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Name for unsealable tag property.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l572">code &raquo;</a><span class="member"><a name="goog.basePath">goog.basePath</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Path for included scripts.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1686">code &raquo;</a><span class="member"><a name="goog.cssNameMappingStyle_">goog.cssNameMappingStyle_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Optional obfuscation style for CSS class names. Should be set to either
+ 'BY_WHOLE' or 'BY_PART' if defined.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1676">code &raquo;</a><span class="member"><a name="goog.cssNameMapping_">goog.cssNameMapping_</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Optional map of CSS class names to obfuscated names used with
+ goog.getCssName().</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l712">code &raquo;</a><span class="member"><a name="goog.dependencies_">goog.dependencies_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>This object is used to keep track of dependencies and other data that is
+ used for loading scripts.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1666">code &raquo;</a><span class="member"><a name="goog.evalWorksForGlobals_">goog.evalWorksForGlobals_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Indicates whether or not we can call 'eval' directly to eval code in the
  global scope. Set to a Boolean by the first call to goog.globalEval (which
- empirically tests whether eval works for globals). @see goog.globalEval</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l47">code &raquo;</a><span class="member"><a name="goog.global">goog.global</a> : <code class="type">global this</code></span></div><p>Reference to the global context.  In most cases this will be 'window'.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l254">code &raquo;</a><span class="member"><a name="goog.implicitNamespaces_">goog.implicitNamespaces_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Namespaces implicitly defined by goog.provide. For example,
- goog.provide('goog.events.Event') implicitly declares
- that 'goog' and 'goog.events' must be namespaces.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l524">code &raquo;</a><span class="member"><a name="goog.included_">goog.included_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Object used to keep track of urls that have already been added. This
- record allows the prevention of circular dependencies.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l507">code &raquo;</a><span class="member"><a name="goog.instantiatedSingletons_">goog.instantiatedSingletons_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>All singleton classes that have been instantiated, for testing. Don't read
+ empirically tests whether eval works for globals). @see goog.globalEval</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l47">code &raquo;</a><span class="member"><a name="goog.global">goog.global</a> : <code class="type">global this</code></span></div><p>Reference to the global context.  In most cases this will be 'window'.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l403">code &raquo;</a><span class="member"><a name="goog.implicitNamespaces_">goog.implicitNamespaces_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Namespaces implicitly defined by goog.provide. For example,
+ goog.provide('goog.events.Event') implicitly declares that 'goog' and
+ 'goog.events' must be namespaces.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l703">code &raquo;</a><span class="member"><a name="goog.included_">goog.included_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Object used to keep track of urls that have already been added. This record
+ allows the prevention of circular dependencies.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l668">code &raquo;</a><span class="member"><a name="goog.instantiatedSingletons_">goog.instantiatedSingletons_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>All singleton classes that have been instantiated, for testing. Don't read
  it directly, use the <code >goog.testing.singleton</code> module. The compiler
- removes this variable if unused.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1010">code &raquo;</a><span class="member"><a name="goog.uidCounter_">goog.uidCounter_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counter for UID.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l140">code &raquo;</a><span class="member"><a name="goog.DEBUG">goog.DEBUG</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l358">code &raquo;</a><span class="member"><a name="goog.ENABLE_DEBUG_LOADER">goog.ENABLE_DEBUG_LOADER</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l162">code &raquo;</a><span class="member"><a name="goog.LOCALE">goog.LOCALE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l42">code &raquo;</a><span class="member"><a name="goog.NATIVE_ARRAY_PROTOTYPES">goog.NATIVE_ARRAY_PROTOTYPES</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l176">code &raquo;</a><span class="member"><a name="goog.TRUSTED_SITE">goog.TRUSTED_SITE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ removes this variable if unused.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l999">code &raquo;</a><span class="member"><a name="goog.lastNonModuleScriptIndex_">goog.lastNonModuleScriptIndex_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l686">code &raquo;</a><span class="member"><a name="goog.loadedModules_">goog.loadedModules_</a> : <code class="type">{}</code></span></div><p>The registry of initialized modules:
+ the module identifier to module exports map.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l311">code &raquo;</a><span class="member"><a name="goog.moduleLoaderState_">goog.moduleLoaderState_</a> : <code class="type">({moduleName: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>), exportTestMethods: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l799">code &raquo;</a><span class="member"><a name="goog.queuedModules_">goog.queuedModules_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l1415">code &raquo;</a><span class="member"><a name="goog.uidCounter_">goog.uidCounter_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counter for UID.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l181">code &raquo;</a><span class="member"><a name="goog.DEBUG">goog.DEBUG</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l512">code &raquo;</a><span class="member"><a name="goog.ENABLE_DEBUG_LOADER">goog.ENABLE_DEBUG_LOADER</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l678">code &raquo;</a><span class="member"><a name="goog.LOAD_MODULE_USING_EVAL">goog.LOAD_MODULE_USING_EVAL</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l203">code &raquo;</a><span class="member"><a name="goog.LOCALE">goog.LOCALE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l42">code &raquo;</a><span class="member"><a name="goog.NATIVE_ARRAY_PROTOTYPES">goog.NATIVE_ARRAY_PROTOTYPES</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l227">code &raquo;</a><span class="member"><a name="goog.STRICT_MODE_COMPATIBLE">goog.STRICT_MODE_COMPATIBLE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l217">code &raquo;</a><span class="member"><a name="goog.TRUSTED_SITE">goog.TRUSTED_SITE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_array.html b/docs/namespace_goog_array.html
index 1c8f008..ae5a09b 100644
--- a/docs/namespace_goog_array.html
+++ b/docs/namespace_goog_array.html
@@ -1,12 +1,13 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.array</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.array</h1><a class="source" href="source/lib/goog/array/array.js.src.html#l21">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l48">code &raquo;</a><a class="member" name="goog.array.ArrayLike">goog.array.ArrayLike</a> : <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-536297177">NodeList</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments">Arguments</a>|{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code></div><div>No description.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1232">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.binaryInsert">goog.array.binaryInsert</a> <span class="args">( array, value, opt_compareFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Inserts a value into a sorted array. The array is not modified if the
- value is already present.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array to modify.<dt>value: <code class="type">T</code><dd>The object to insert.<dt>opt_compareFn: <code class="type">?function(T, T): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional comparison function by
-     which the
-     array is ordered. Should take 2 arguments to compare, and return a
-     negative number, zero, or a positive number depending on whether the
-     first argument is less than, equal to, or greater than the second.</dl><tr><th>Returns<tr><td><dl>True if an element was inserted.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1252">code &raquo;</a><span class="member"><a name="goog.array.binaryRemove">goog.array.binaryRemove</a> <span class="args">( array, value, opt_compareFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes a value from a sorted array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The array to modify.<dt>value: <code class="type">*</code><dd>The object to remove.<dt>opt_compareFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Optional comparison function by which the
-     array is ordered. Should take 2 arguments to compare, and return a
-     negative number, zero, or a positive number depending on whether the
-     first argument is less than, equal to, or greater than the second.</dl><tr><th>Returns<tr><td><dl>True if an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l933">code &raquo;</a><span class="member"><a name="goog.array.binarySearch">goog.array.binarySearch</a> <span class="args">( arr, target, opt_compareFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Searches the specified array for the specified target using the binary
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.array</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.array</h1><a class="source" href="source/lib/goog/array/array.js.src.html#l21">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l56">code &raquo;</a><a class="member" name="goog.array.ArrayLike">goog.array.ArrayLike</a> : <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-536297177">NodeList</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments">Arguments</a>|{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code></div><div>No description.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1317">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.array.binaryInsert">goog.array.binaryInsert</a> <span class="args">( array, value, opt_compareFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Inserts a value into a sorted array. The array is not modified if the
+ value is already present.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to modify.<dt>value: <code class="type">VALUE</code><dd>The object to insert.<dt>opt_compareFn: <code class="type">function(VALUE, VALUE): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional comparison
+     function by which the array is ordered. Should take 2 arguments to
+     compare, and return a negative number, zero, or a positive number
+     depending on whether the first argument is less than, equal to, or
+     greater than the second.</dl><tr><th>Returns<tr><td><dl>True if an element was inserted.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1339">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.array.binaryRemove">goog.array.binaryRemove</a> <span class="args">( array, value, opt_compareFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes a value from a sorted array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type">(!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to modify.<dt>value: <code class="type">VALUE</code><dd>The object to remove.<dt>opt_compareFn: <code class="type">function(VALUE, VALUE): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional comparison
+     function by which the array is ordered. Should take 2 arguments to
+     compare, and return a negative number, zero, or a positive number
+     depending on whether the first argument is less than, equal to, or
+     greater than the second.</dl><tr><th>Returns<tr><td><dl>True if an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1024">code &raquo;</a><code class="type">&lt;TARGET, VALUE&gt;</code> <span class="member"><a name="goog.array.binarySearch">goog.array.binarySearch</a> <span class="args">( arr, target, opt_compareFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Searches the specified array for the specified target using the binary
  search algorithm.  If no opt_compareFn is specified, elements are compared
  using <code>goog.array.defaultCompare</code>, which compares the elements
  using the built in < and > operators.  This will produce the expected
@@ -16,13 +17,14 @@
  If the array contains multiple instances of the specified target value, any
  of these instances may be found.
 
- Runtime: O(log n)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to be searched.<dt>target: <code class="type">*</code><dd>The sought value.<dt>opt_compareFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Optional comparison function by which the
-     array is ordered. Should take 2 arguments to compare, and return a
-     negative number, zero, or a positive number depending on whether the
-     first argument is less than, equal to, or greater than the second.</dl><tr><th>Returns<tr><td><dl>Lowest index of the target value if found, otherwise
+ Runtime: O(log n)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to be searched.<dt>target: <code class="type">TARGET</code><dd>The sought value.<dt>opt_compareFn: <code class="type">function(TARGET, VALUE): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional comparison
+     function by which the array is ordered. Should take 2 arguments to
+     compare, and return a negative number, zero, or a positive number
+     depending on whether the first argument is less than, equal to, or
+     greater than the second.</dl><tr><th>Returns<tr><td><dl>Lowest index of the target value if found, otherwise
      (-(insertion point) - 1). The insertion point is where the value should
      be inserted into arr to preserve the sorted property.  Return value >= 0
-     iff target is found.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l995">code &raquo;</a><span class="member"><a name="goog.array.binarySearch_">goog.array.binarySearch_</a> <span class="args">( arr, compareFn, isEvaluator, opt_target, opt_selfObj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Implementation of a binary search algorithm which knows how to use both
+     iff target is found.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1091">code &raquo;</a><code class="type">&lt;THIS, VALUE, TARGET&gt;</code> <span class="member"><a name="goog.array.binarySearch_">goog.array.binarySearch_</a> <span class="args">( arr, compareFn, isEvaluator, opt_target, opt_selfObj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Implementation of a binary search algorithm which knows how to use both
  comparison functions and evaluators. If an evaluator is provided, will call
  the evaluator with the given optional data object, conforming to the
  interface defined in binarySelect. Otherwise, if a comparison function is
@@ -31,40 +33,44 @@
  This implementation purposefully does not use goog.bind or goog.partial for
  performance reasons.
 
- Runtime: O(log n)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to be searched.<dt>compareFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Either an evaluator or a comparison function,
-     as defined by binarySearch and binarySelect above.<dt>isEvaluator: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether the function is an evaluator or a
-     comparison function.<dt>opt_target: <code class="type">*=</code><dd>If the function is a comparison function, then this is
-     the target to binary search for.<dt>opt_selfObj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>If the function is an evaluator, this is an
+ Runtime: O(log n)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to be searched.<dt>compareFn: <code class="type">(function(TARGET, VALUE): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>Either an
+     evaluator or a comparison function, as defined by binarySearch
+     and binarySelect above.<dt>isEvaluator: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether the function is an evaluator or a
+     comparison function.<dt>opt_target: <code class="type">TARGET=</code><dd>If the function is a comparison function, then
+     this is the target to binary search for.<dt>opt_selfObj: <code class="type">THIS=</code><dd>If the function is an evaluator, this is an
     optional this object for the evaluator.</dl><tr><th>Returns<tr><td><dl>Lowest index of the target value if found, otherwise
      (-(insertion point) - 1). The insertion point is where the value should
      be inserted into arr to preserve the sorted property.  Return value >= 0
-     iff target is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l962">code &raquo;</a><span class="member"><a name="goog.array.binarySelect">goog.array.binarySelect</a> <span class="args">( arr, evaluator, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Selects an index in the specified array using the binary search algorithm.
+     iff target is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1055">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.array.binarySelect">goog.array.binarySelect</a> <span class="args">( arr, evaluator, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Selects an index in the specified array using the binary search algorithm.
  The evaluator receives an element and determines whether the desired index
  is before, at, or after it.  The evaluator must be consistent (formally,
  goog.array.map(goog.array.map(arr, evaluator, opt_obj), goog.math.sign)
  must be monotonically non-increasing).
 
- Runtime: O(log n)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to be searched.<dt>evaluator: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Evaluator function that receives 3 arguments
-     (the element, the index and the array). Should return a negative number,
-     zero, or a positive number depending on whether the desired index is
-     before, at, or after the element passed to it.<dt>opt_obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>The object to be used as the value of 'this'
+ Runtime: O(log n)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to be searched.<dt>evaluator: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Evaluator function that receives 3 arguments (the element, the index and
+     the array). Should return a negative number, zero, or a positive number
+     depending on whether the desired index is before, at, or after the
+     element passed to it.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this'
      within evaluator.</dl><tr><th>Returns<tr><td><dl>Index of the leftmost element matched by the evaluator, if
      such exists; otherwise (-(insertion point) - 1). The insertion point is
      the index of the first element for which the evaluator returns negative,
      or arr.length if no such element exists. The return value is non-negative
-     iff a match is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1272">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.bucket">goog.array.bucket</a> <span class="args">( array, sorter, opt_obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Splits an array into disjoint buckets according to a splitting function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array.<dt>sorter: <code class="type">function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, <a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;): ?</code><dd>Function to call for
+     iff a match is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1359">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.bucket">goog.array.bucket</a> <span class="args">( array, sorter, opt_obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Splits an array into disjoint buckets according to a splitting function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array.<dt>sorter: <code class="type">function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, <a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;): ?</code><dd>Function to call for
      every element.  This takes 3 arguments (the element, the index and the
      array) and must return a valid object key (a string, number, etc), or
      undefined, if that object should not be placed in a bucket.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this' within
      sorter.</dl><tr><th>Returns<tr><td><dl>An object, with keys being all of the unique return values
      of sorter, and values being arrays containing the items for
-     which the splitter returned that key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l589">code &raquo;</a><span class="member"><a name="goog.array.clear">goog.array.clear</a> <span class="args">( arr )</span></span></div><p>Clears the array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Array or array like object to clear.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l774">code &raquo;</a><span class="member"><a name="goog.array.clone">goog.array.clone</a> <span class="args">( arr )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Does a shallow copy of an array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Array or array-like object to clone.</dl><tr><th>Returns<tr><td><dl>Clone of the input array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1164">code &raquo;</a><span class="member deprecation-notice"><a name="goog.array.compare">goog.array.compare</a> <span class="args">( arr1, arr2, opt_equalsFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="namespace_goog_array.html#goog.array.equals">goog.array.equals</a></code>.</span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr1: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>See <code  class="type"><a href="namespace_goog_array.html#goog.array.equals">goog.array.equals</a></code>.<dt>arr2: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>See <code  class="type"><a href="namespace_goog_array.html#goog.array.equals">goog.array.equals</a></code>.<dt>opt_equalsFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>See <code  class="type"><a href="namespace_goog_array.html#goog.array.equals">goog.array.equals</a></code>.</dl><tr><th>Returns<tr><td><dl>See <code  class="type"><a href="namespace_goog_array.html#goog.array.equals">goog.array.equals</a></code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1182">code &raquo;</a><span class="member"><a name="goog.array.compare3">goog.array.compare3</a> <span class="args">( arr1, arr2, opt_compareFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>3-way array compare function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr1: <code class="type">!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The first array to compare.<dt>arr2: <code class="type">!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The second array to compare.<dt>opt_compareFn: <code class="type">?function(?, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional comparison function
-     by which the array is to be ordered. Should take 2 arguments to compare,
-     and return a negative number, zero, or a positive number depending on
-     whether the first argument is less than, equal to, or greater than the
-     second.</dl><tr><th>Returns<tr><td><dl>Negative number, zero, or a positive number depending on
+     which the splitter returned that key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l623">code &raquo;</a><span class="member"><a name="goog.array.clear">goog.array.clear</a> <span class="args">( arr )</span></span></div><p>Clears the array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Array or array like object to clear.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l851">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.clone">goog.array.clone</a> <span class="args">( arr )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Does a shallow copy of an array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array-like object to
+     clone.</dl><tr><th>Returns<tr><td><dl>Clone of the input array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1266">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.array.compare3">goog.array.compare3</a> <span class="args">( arr1, arr2, opt_compareFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>3-way array compare function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr1: <code class="type">(!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The first array to
+     compare.<dt>arr2: <code class="type">(!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The second array to
+     compare.<dt>opt_compareFn: <code class="type">function(VALUE, VALUE): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional comparison
+     function by which the array is to be ordered. Should take 2 arguments to
+     compare, and return a negative number, zero, or a positive number
+     depending on whether the first argument is less than, equal to, or
+     greater than the second.</dl><tr><th>Returns<tr><td><dl>Negative number, zero, or a positive number depending on
      whether the first argument is less than, equal to, or greater than the
-     second.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l738">code &raquo;</a><span class="member"><a name="goog.array.concat">goog.array.concat</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns a new array that is the result of joining the arguments.  If arrays
+     second.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l799">code &raquo;</a><span class="member"><a name="goog.array.concat">goog.array.concat</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns a new array that is the result of joining the arguments.  If arrays
  are passed then their items are added, however, if non-arrays are passed they
  will be added to the return array as is.
 
@@ -85,18 +91,18 @@
 
  Internally goog.array should use this, so that all methods will continue to
  work on these broken array objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...*</code><dd>Items to concatenate.  Arrays will have each item
-     added, while primitives and objects will be added as is.</dl><tr><th>Returns<tr><td><dl>The new resultant array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l570">code &raquo;</a><span class="member"><a name="goog.array.contains">goog.array.contains</a> <span class="args">( arr, obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the array contains the given object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to test for the presence of the
-     element.<dt>obj: <code class="type">*</code><dd>The object for which to test.</dl><tr><th>Returns<tr><td><dl>true if obj is present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l461">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.count">goog.array.count</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counts the array elements that fulfill the predicate, i.e. for which the
+     added, while primitives and objects will be added as is.</dl><tr><th>Returns<tr><td><dl>The new resultant array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l604">code &raquo;</a><span class="member"><a name="goog.array.contains">goog.array.contains</a> <span class="args">( arr, obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the array contains the given object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to test for the presence of the
+     element.<dt>obj: <code class="type">*</code><dd>The object for which to test.</dl><tr><th>Returns<tr><td><dl>true if obj is present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l495">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.count">goog.array.count</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counts the array elements that fulfill the predicate, i.e. for which the
  callback function returns true. Skips holes in the array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array like object
      over which to iterate.<dt>f: <code class="type">function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
-     every element. Takes 3 arguments (the element, the index and the array).<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this' within f.</dl><tr><th>Returns<tr><td><dl>The number of the matching elements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1203">code &raquo;</a><span class="member"><a name="goog.array.defaultCompare">goog.array.defaultCompare</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Compares its two arguments for order, using the built in < and >
- operators.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">*</code><dd>The first object to be compared.<dt>b: <code class="type">*</code><dd>The second object to be compared.</dl><tr><th>Returns<tr><td><dl>A negative number, zero, or a positive number as the first
-     argument is less than, equal to, or greater than the second.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1214">code &raquo;</a><span class="member"><a name="goog.array.defaultCompareEquality">goog.array.defaultCompareEquality</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares its two arguments for equality, using the built in === operator.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">*</code><dd>The first object to compare.<dt>b: <code class="type">*</code><dd>The second object to compare.</dl><tr><th>Returns<tr><td><dl>True if the two arguments are equal, false otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1141">code &raquo;</a><span class="member"><a name="goog.array.equals">goog.array.equals</a> <span class="args">( arr1, arr2, opt_equalsFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares two arrays for equality. Two arrays are considered equal if they
+     every element. Takes 3 arguments (the element, the index and the array).<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this' within f.</dl><tr><th>Returns<tr><td><dl>The number of the matching elements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1288">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.array.defaultCompare">goog.array.defaultCompare</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Compares its two arguments for order, using the built in < and >
+ operators.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">VALUE</code><dd>The first object to be compared.<dt>b: <code class="type">VALUE</code><dd>The second object to be compared.</dl><tr><th>Returns<tr><td><dl>A negative number, zero, or a positive number as the first
+     argument is less than, equal to, or greater than the second.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1299">code &raquo;</a><span class="member"><a name="goog.array.defaultCompareEquality">goog.array.defaultCompareEquality</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares its two arguments for equality, using the built in === operator.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">*</code><dd>The first object to compare.<dt>b: <code class="type">*</code><dd>The second object to compare.</dl><tr><th>Returns<tr><td><dl>True if the two arguments are equal, false otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1234">code &raquo;</a><span class="member"><a name="goog.array.equals">goog.array.equals</a> <span class="args">( arr1, arr2, opt_equalsFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares two arrays for equality. Two arrays are considered equal if they
  have the same length and their corresponding elements are equal according to
  the comparison function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr1: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The first array to compare.<dt>arr2: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The second array to compare.<dt>opt_equalsFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Optional comparison function.
      Should take 2 arguments to compare, and return true if the arguments
      are equal. Defaults to <code  class="type"><a href="namespace_goog_array.html#goog.array.defaultCompareEquality">goog.array.defaultCompareEquality</a></code> which
-     compares the elements using the built-in '===' operator.</dl><tr><th>Returns<tr><td><dl>Whether the two arrays are equal.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l430">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.every">goog.array.every</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Call f for each element of an array. If all calls return true, every()
+     compares the elements using the built-in '===' operator.</dl><tr><th>Returns<tr><td><dl>Whether the two arrays are equal.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l463">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.every">goog.array.every</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Call f for each element of an array. If all calls return true, every()
  returns true. If any call returns false, every() returns false and
  does not continue to check the remaining elements.
 
@@ -104,7 +110,7 @@
      like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
      for every element. This function takes 3 arguments (the element, the
      index and the array) and should return a boolean.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this'
-     within f.</dl><tr><th>Returns<tr><td><dl>false if any element fails the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l791">code &raquo;</a><span class="member"><a name="goog.array.extend">goog.array.extend</a> <span class="args">( arr1, var_args )</span></span></div><p>Extends an array with another array, element, or "array like" object.
+     within f.</dl><tr><th>Returns<tr><td><dl>false if any element fails the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l870">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.array.extend">goog.array.extend</a> <span class="args">( arr1, var_args )</span></span></div><p>Extends an array with another array, element, or "array like" object.
  This function operates 'in-place', it does not create a new Array.
 
  Example:
@@ -112,7 +118,8 @@
  goog.array.extend(a, [0, 1]);
  a; // [0, 1]
  goog.array.extend(a, 2);
- a; // [0, 1, 2]</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr1: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The array to modify.<dt>var_args: <code class="type">...*</code><dd>The elements or arrays of elements to add to arr1.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l234">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.filter">goog.array.filter</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Calls a function for each element in an array, and if the function returns
+ a; // [0, 1, 2]</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr1: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;</code><dd>The array to modify.<dt>var_args: <code class="type">...(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|VALUE)</code><dd>The elements or arrays of elements
+     to add to arr1.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l259">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.filter">goog.array.filter</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Calls a function for each element in an array, and if the function returns
  true adds the element to a new array.
 
  See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-filter</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
@@ -121,65 +128,70 @@
      takes 3 arguments (the element, the index and the array) and must
      return a Boolean. If the return value is true the element is added to the
      result array. If it is false the element is not included.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this'
-     within f.</dl><tr><th>Returns<tr><td><dl>a new array in which only elements that passed the test are
-     present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l485">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.find">goog.array.find</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type">T</code></span></div><p>Search an array for the first element that satisfies a given condition and
+     within f.</dl><tr><th>Returns<tr><td><dl>a new array in which only elements that passed the test
+     are present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l519">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.find">goog.array.find</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type">?T</code></span></div><p>Search an array for the first element that satisfies a given condition and
  return that element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
      like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call
      for every element. This function takes 3 arguments (the element, the
      index and the array) and should return a boolean.<dt>opt_obj: <code class="type">S=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>The first array element that passes the test, or null if no
-     element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l505">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.findIndex">goog.array.findIndex</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Search an array for the first element that satisfies a given condition and
+     element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l539">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.findIndex">goog.array.findIndex</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Search an array for the first element that satisfies a given condition and
  return its index.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
      like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
      every element. This function
      takes 3 arguments (the element, the index and the array) and should
      return a boolean.<dt>opt_obj: <code class="type">S=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>The index of the first array element that passes the test,
-     or -1 if no element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l551">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.findIndexRight">goog.array.findIndexRight</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Search an array (in reverse order) for the last element that satisfies a
+     or -1 if no element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l585">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.findIndexRight">goog.array.findIndexRight</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Search an array (in reverse order) for the last element that satisfies a
  given condition and return its index.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
      like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call
      for every element. This function
      takes 3 arguments (the element, the index and the array) and should
      return a boolean.<dt>opt_obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>The index of the last array element that passes the test,
-     or -1 if no element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l531">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.findRight">goog.array.findRight</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type">T</code></span></div><p>Search an array (in reverse order) for the last element that satisfies a
+     or -1 if no element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l565">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.findRight">goog.array.findRight</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type">?T</code></span></div><p>Search an array (in reverse order) for the last element that satisfies a
  given condition and return that element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
      like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call
      for every element. This function
      takes 3 arguments (the element, the index and the array) and should
      return a boolean.<dt>opt_obj: <code class="type">S=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>The last array element that passes the test, or null if no
-     element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1385">code &raquo;</a><span class="member"><a name="goog.array.flatten">goog.array.flatten</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns an array consisting of every argument with all arrays
- expanded in-place recursively.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...*</code><dd>The values to flatten.</dl><tr><th>Returns<tr><td><dl>An array containing the flattened values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l172">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.forEach">goog.array.forEach</a> <span class="args">( arr, f, opt_obj )</span></span></div><p>Calls a function for each element in an array. Skips holes in the array.
+     element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1473">code &raquo;</a><span class="member"><a name="goog.array.flatten">goog.array.flatten</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns an array consisting of every argument with all arrays
+ expanded in-place recursively.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...*</code><dd>The values to flatten.</dl><tr><th>Returns<tr><td><dl>An array containing the flattened values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l196">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.forEach">goog.array.forEach</a> <span class="args">( arr, f, opt_obj )</span></span></div><p>Calls a function for each element in an array. Skips holes in the array.
  See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-foreach</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array like object over
      which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): ?</code><dd>The function to call for every
      element. This function takes 3 arguments (the element, the index and the
-     array). The return value is ignored.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this' within f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l204">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.forEachRight">goog.array.forEachRight</a> <span class="args">( arr, f, opt_obj )</span></span></div><p>Calls a function for each element in an array, starting from the last
+     array). The return value is ignored.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this' within f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l229">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.forEachRight">goog.array.forEachRight</a> <span class="args">( arr, f, opt_obj )</span></span></div><p>Calls a function for each element in an array, starting from the last
  element rather than the first.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
      like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): ?</code><dd>The function to call for every
      element. This function
      takes 3 arguments (the element, the index and the array). The return
      value is ignored.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this'
-     within f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l87">code &raquo;</a><span class="member"><a name="goog.array.indexOf">goog.array.indexOf</a> <span class="args">( arr, obj, opt_fromIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the index of the first element of an array with a specified
- value, or -1 if the element is not present in the array.
+     within f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l108">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.indexOf">goog.array.indexOf</a> <span class="args">( arr, obj, opt_fromIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the index of the first element of an array with a specified value, or
+ -1 if the element is not present in the array.
 
- See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-indexof</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to be searched.<dt>obj: <code class="type">*</code><dd>The object for which we are searching.<dt>opt_fromIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index at which to start the search. If
-     omitted the search starts at index 0.</dl><tr><th>Returns<tr><td><dl>The index of the first matching array element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l607">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.insert">goog.array.insert</a> <span class="args">( arr, obj )</span></span></div><p>Pushes an item into an array, if it's not already in the array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>Array into which to insert the item.<dt>obj: <code class="type">T</code><dd>Value to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l633">code &raquo;</a><span class="member"><a name="goog.array.insertArrayAt">goog.array.insertArrayAt</a> <span class="args">( arr, elementsToAdd, opt_i )</span></span></div><p>Inserts at the given index of the array, all elements of another array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to modify.<dt>elementsToAdd: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array of elements to add.<dt>opt_i: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index at which to insert the object. If omitted,
-      treated as 0. A negative index is counted from the end of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l621">code &raquo;</a><span class="member"><a name="goog.array.insertAt">goog.array.insertAt</a> <span class="args">( arr, obj, opt_i )</span></span></div><p>Inserts an object at the given index of the array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to modify.<dt>obj: <code class="type">*</code><dd>The object to insert.<dt>opt_i: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index at which to insert the object. If omitted,
-      treated as 0. A negative index is counted from the end of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l646">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.insertBefore">goog.array.insertBefore</a> <span class="args">( arr, obj, opt_obj2 )</span></span></div><p>Inserts an object into an array before a specified object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array to modify.<dt>obj: <code class="type">T</code><dd>The object to insert.<dt>opt_obj2: <code class="type">T=</code><dd>The object before which obj should be inserted. If obj2
-     is omitted or not found, obj is inserted at the end of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l580">code &raquo;</a><span class="member"><a name="goog.array.isEmpty">goog.array.isEmpty</a> <span class="args">( arr )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the array is empty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to test.</dl><tr><th>Returns<tr><td><dl>true if empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1116">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.isSorted">goog.array.isSorted</a> <span class="args">( arr, opt_compareFn, opt_strict )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tells if the array is sorted.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array.<dt>opt_compareFn: <code class="type">?function(T, T): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Function to compare the
+ See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-indexof</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to be searched.<dt>obj: <code class="type">T</code><dd>The object for which we are searching.<dt>opt_fromIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index at which to start the search. If
+     omitted the search starts at index 0.</dl><tr><th>Returns<tr><td><dl>The index of the first matching array element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l641">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.insert">goog.array.insert</a> <span class="args">( arr, obj )</span></span></div><p>Pushes an item into an array, if it's not already in the array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>Array into which to insert the item.<dt>obj: <code class="type">T</code><dd>Value to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l667">code &raquo;</a><span class="member"><a name="goog.array.insertArrayAt">goog.array.insertArrayAt</a> <span class="args">( arr, elementsToAdd, opt_i )</span></span></div><p>Inserts at the given index of the array, all elements of another array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to modify.<dt>elementsToAdd: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array of elements to add.<dt>opt_i: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index at which to insert the object. If omitted,
+      treated as 0. A negative index is counted from the end of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l655">code &raquo;</a><span class="member"><a name="goog.array.insertAt">goog.array.insertAt</a> <span class="args">( arr, obj, opt_i )</span></span></div><p>Inserts an object at the given index of the array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to modify.<dt>obj: <code class="type">*</code><dd>The object to insert.<dt>opt_i: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index at which to insert the object. If omitted,
+      treated as 0. A negative index is counted from the end of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l680">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.insertBefore">goog.array.insertBefore</a> <span class="args">( arr, obj, opt_obj2 )</span></span></div><p>Inserts an object into an array before a specified object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array to modify.<dt>obj: <code class="type">T</code><dd>The object to insert.<dt>opt_obj2: <code class="type">T=</code><dd>The object before which obj should be inserted. If obj2
+     is omitted or not found, obj is inserted at the end of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l614">code &raquo;</a><span class="member"><a name="goog.array.isEmpty">goog.array.isEmpty</a> <span class="args">( arr )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the array is empty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to test.</dl><tr><th>Returns<tr><td><dl>true if empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1209">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.isSorted">goog.array.isSorted</a> <span class="args">( arr, opt_compareFn, opt_strict )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tells if the array is sorted.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array.<dt>opt_compareFn: <code class="type">?function(T, T): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Function to compare the
      array elements.
      Should take 2 arguments to compare, and return a negative number, zero,
      or a positive number depending on whether the first argument is less
-     than, equal to, or greater than the second.<dt>opt_strict: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true no equal elements are allowed.</dl><tr><th>Returns<tr><td><dl>Whether the array is sorted.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l127">code &raquo;</a><span class="member"><a name="goog.array.lastIndexOf">goog.array.lastIndexOf</a> <span class="args">( arr, obj, opt_fromIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the index of the last element of an array with a specified value, or
+     than, equal to, or greater than the second.<dt>opt_strict: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true no equal elements are allowed.</dl><tr><th>Returns<tr><td><dl>Whether the array is sorted.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l811">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.join">goog.array.join</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Returns a new array that contains the contents of all the arrays passed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l78">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.last">goog.array.last</a> <span class="args">( array )</span> &rArr; <code class="type">T</code></span></div><p>Returns the last element in an array without removing it.
+ Same as goog.array.peek.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array.</dl><tr><th>Returns<tr><td><dl>Last item in array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l150">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.lastIndexOf">goog.array.lastIndexOf</a> <span class="args">( arr, obj, opt_fromIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the index of the last element of an array with a specified value, or
  -1 if the element is not present in the array.
 
- See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-lastindexof</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to be searched.<dt>obj: <code class="type">*</code><dd>The object for which we are searching.<dt>opt_fromIndex: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index at which to start the search. If
-     omitted the search starts at the end of the array.</dl><tr><th>Returns<tr><td><dl>The index of the last matching array element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l275">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.map">goog.array.map</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Calls a function for each element in an array and inserts the result into a
+ See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-lastindexof</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to be searched.<dt>obj: <code class="type">T</code><dd>The object for which we are searching.<dt>opt_fromIndex: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index at which to start the search. If
+     omitted the search starts at the end of the array.</dl><tr><th>Returns<tr><td><dl>The index of the last matching array element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l300">code &raquo;</a><code class="type">&lt;THIS, VALUE, RESULT&gt;</code> <span class="member"><a name="goog.array.map">goog.array.map</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;RESULT&gt;</code></span></div><p>Calls a function for each element in an array and inserts the result into a
  new array.
 
- See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-map</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
-     like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): ?</code><dd>The function to call for every
-     element. This function
-     takes 3 arguments (the element, the index and the array) and should
-     return something. The result will be inserted into a new array.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this'
-     within f.</dl><tr><th>Returns<tr><td><dl>a new array with the results from f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l56">code &raquo;</a><span class="member"><a name="goog.array.peek">goog.array.peek</a> <span class="args">( array )</span> &rArr; <code class="type">*</code></span></div><p>Returns the last element in an array without removing it.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array.</dl><tr><th>Returns<tr><td><dl>Last item in array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1334">code &raquo;</a><span class="member"><a name="goog.array.range">goog.array.range</a> <span class="args">( startOrEnd, opt_end, opt_step )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code></span></div><p>Creates a range of numbers in an arithmetic progression.
+ See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-map</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array like object
+     over which to iterate.<dt>f: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): RESULT</code><dd>The function to call
+     for every element. This function takes 3 arguments (the element,
+     the index and the array) and should return something. The result will be
+     inserted into a new array.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within f.</dl><tr><th>Returns<tr><td><dl>a new array with the results from f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1526">code &raquo;</a><span class="member"><a name="goog.array.moveItem">goog.array.moveItem</a> <span class="args">( arr, fromIndex, toIndex )</span></span></div><p>Moves one item of an array to a new position keeping the order of the rest
+ of the items. Example use case: keeping a list of JavaScript objects
+ synchronized with the corresponding list of DOM elements after one of the
+ elements has been dragged to a new position.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments">Arguments</a>|{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code><dd>The array to modify.<dt>fromIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Index of the item to move between 0 and
+     <code >arr.length - 1</code>.<dt>toIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Target index between 0 and <code >arr.length - 1</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l66">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.peek">goog.array.peek</a> <span class="args">( array )</span> &rArr; <code class="type">T</code></span></div><p>Returns the last element in an array without removing it.
+ Same as goog.array.last.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array.</dl><tr><th>Returns<tr><td><dl>Last item in array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1421">code &raquo;</a><span class="member"><a name="goog.array.range">goog.array.range</a> <span class="args">( startOrEnd, opt_end, opt_step )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code></span></div><p>Creates a range of numbers in an arithmetic progression.
 
  Range takes 1, 2, or 3 arguments:
  <pre>
@@ -191,7 +203,7 @@
      is provided. Otherwise, the start value is 0, and this is the end value.<dt>opt_end: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The optional end value of the range.<dt>opt_step: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The step size between range values. Defaults to 1
      if opt_step is undefined or 0.</dl><tr><th>Returns<tr><td><dl>An array of numbers for the requested range. May be
      an empty array if adding the step would not converge toward the end
-     value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l319">code &raquo;</a><code class="type">&lt;T, S, R&gt;</code> <span class="member"><a name="goog.array.reduce">goog.array.reduce</a> <span class="args">( arr, f, val, opt_obj )</span> &rArr; <code class="type">R</code></span></div><p>Passes every element of an array into a function and accumulates the result.
+     value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l345">code &raquo;</a><code class="type">&lt;T, S, R&gt;</code> <span class="member"><a name="goog.array.reduce">goog.array.reduce</a> <span class="args">( arr, f, val, opt_obj )</span> &rArr; <code class="type">R</code></span></div><p>Passes every element of an array into a function and accumulates the result.
 
  See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-reduce</a></code>
 
@@ -205,7 +217,7 @@
      the value of the current array element, the current array index, and the
      array itself)
      function(previousValue, currentValue, index, array).<dt>val: <code class="type">?</code><dd>The initial value to pass into the function on the first call.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this'
-     within f.</dl><tr><th>Returns<tr><td><dl>Result of evaluating f repeatedly across the values of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l361">code &raquo;</a><code class="type">&lt;T, S, R&gt;</code> <span class="member"><a name="goog.array.reduceRight">goog.array.reduceRight</a> <span class="args">( arr, f, val, opt_obj )</span> &rArr; <code class="type">R</code></span></div><p>Passes every element of an array into a function and accumulates the result,
+     within f.</dl><tr><th>Returns<tr><td><dl>Result of evaluating f repeatedly across the values of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l390">code &raquo;</a><code class="type">&lt;T, S, R&gt;</code> <span class="member"><a name="goog.array.reduceRight">goog.array.reduceRight</a> <span class="args">( arr, f, val, opt_obj )</span> &rArr; <code class="type">R</code></span></div><p>Passes every element of an array into a function and accumulates the result,
  starting from the last element and working towards the first.
 
  See <code  class="type"><a class="unresolved-link">http://tinyurl.com/developer-mozilla-org-array-reduceright</a></code>
@@ -221,28 +233,39 @@
      array itself)
      function(previousValue, currentValue, index, array).<dt>val: <code class="type">?</code><dd>The initial value to pass into the function on the first call.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this'
      within f.</dl><tr><th>Returns<tr><td><dl>Object returned as a result of evaluating f repeatedly across the
-     values of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l662">code &raquo;</a><span class="member"><a name="goog.array.remove">goog.array.remove</a> <span class="args">( arr, obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes the first occurrence of a particular value from an array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Array from which to remove value.<dt>obj: <code class="type">*</code><dd>Object to remove.</dl><tr><th>Returns<tr><td><dl>True if an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l679">code &raquo;</a><span class="member"><a name="goog.array.removeAt">goog.array.removeAt</a> <span class="args">( arr, i )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes from an array the element at index i</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Array or array like object from which to
-     remove value.<dt>i: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index to remove.</dl><tr><th>Returns<tr><td><dl>True if an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l887">code &raquo;</a><span class="member"><a name="goog.array.removeDuplicates">goog.array.removeDuplicates</a> <span class="args">( arr, opt_rv )</span></span></div><p>Removes all duplicates from an array (retaining only the first
+     values of the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l698">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.remove">goog.array.remove</a> <span class="args">( arr, obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes the first occurrence of a particular value from an array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array from which to remove
+     value.<dt>obj: <code class="type">T</code><dd>Object to remove.</dl><tr><th>Returns<tr><td><dl>True if an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l759">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.removeAllIf">goog.array.removeAllIf</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Removes all values that satisfy the given condition.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
+     like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call
+     for every element. This function
+     takes 3 arguments (the element, the index and the array) and should
+     return a boolean.<dt>opt_obj: <code class="type">S=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>The number of items removed</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l715">code &raquo;</a><span class="member"><a name="goog.array.removeAt">goog.array.removeAt</a> <span class="args">( arr, i )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes from an array the element at index i</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Array or array like object from which to
+     remove value.<dt>i: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index to remove.</dl><tr><th>Returns<tr><td><dl>True if an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l975">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.removeDuplicates">goog.array.removeDuplicates</a> <span class="args">( arr, opt_rv, opt_hashFn )</span></span></div><p>Removes all duplicates from an array (retaining only the first
  occurrence of each array element).  This function modifies the
  array in place and doesn't change the order of the non-duplicate items.
 
  For objects, duplicates are identified as having the same unique ID as
  defined by <code  class="type"><a href="namespace_goog.html#goog.getUid">goog.getUid</a></code>.
 
+ Alternatively you can specify a custom hash function that returns a unique
+ value for each item in the array it should consider unique.
+
  Runtime: N,
- Worstcase space: 2N (no dupes)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array from which to remove duplicates.<dt>opt_rv: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>=</code><dd>An optional array in which to return the results,
+ Worstcase space: 2N (no dupes)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array from which to remove
+     duplicates.<dt>opt_rv: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>=</code><dd>An optional array in which to return the results,
      instead of performing the removal inplace.  If specified, the original
-     array will remain unchanged.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l701">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.removeIf">goog.array.removeIf</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes the first value that satisfies the given condition.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
+     array will remain unchanged.<dt>opt_hashFn: <code class="type">function(T): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>An optional function to use to
+     apply to every item in the array. This function should return a unique
+     value for each item in the array it should consider unique.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l737">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.removeIf">goog.array.removeIf</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes the first value that satisfies the given condition.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array
      like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call
      for every element. This function
      takes 3 arguments (the element, the index and the array) and should
-     return a boolean.<dt>opt_obj: <code class="type">S=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>True if an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1369">code &raquo;</a><span class="member"><a name="goog.array.repeat">goog.array.repeat</a> <span class="args">( value, n )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns an array consisting of the given value repeated N times.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to repeat.<dt>n: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The repeat count.</dl><tr><th>Returns<tr><td><dl>An array with the repeated value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1413">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.rotate">goog.array.rotate</a> <span class="args">( array, n )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Rotates an array in-place. After calling this method, the element at
+     return a boolean.<dt>opt_obj: <code class="type">S=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>True if an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1457">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.array.repeat">goog.array.repeat</a> <span class="args">( value, n )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;</code></span></div><p>Returns an array consisting of the given value repeated N times.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">VALUE</code><dd>The value to repeat.<dt>n: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The repeat count.</dl><tr><th>Returns<tr><td><dl>An array with the repeated value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1501">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.rotate">goog.array.rotate</a> <span class="args">( array, n )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Rotates an array in-place. After calling this method, the element at
  index i will be the element previously at index (i - n) %
  array.length, for all values of i between 0 and array.length - 1,
  inclusive.
 
  For example, suppose list comprises [t, a, n, k, s]. After invoking
- rotate(array, 1) (or rotate(array, -4)), array will comprise [s, t, a, n, k].</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array to rotate.<dt>n: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The amount to rotate.</dl><tr><th>Returns<tr><td><dl>The array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1474">code &raquo;</a><span class="member"><a name="goog.array.shuffle">goog.array.shuffle</a> <span class="args">( arr, opt_randFn )</span></span></div><p>Shuffles the values in the specified array using the Fisher-Yates in-place
+ rotate(array, 1) (or rotate(array, -4)), array will comprise [s, t, a, n, k].</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code><dd>The array to rotate.<dt>n: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The amount to rotate.</dl><tr><th>Returns<tr><td><dl>The array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1584">code &raquo;</a><span class="member"><a name="goog.array.shuffle">goog.array.shuffle</a> <span class="args">( arr, opt_randFn )</span></span></div><p>Shuffles the values in the specified array using the Fisher-Yates in-place
  shuffle (also known as the Knuth Shuffle). By default, calls Math.random()
  and so resets the state of that random number generator. Similarly, may reset
  the state of the any other specified random number generator.
@@ -250,11 +273,11 @@
  Runtime: O(n)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The array to be shuffled.<dt>opt_randFn: <code class="type">function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional random function to use for
      shuffling.
      Takes no arguments, and returns a random number on the interval [0, 1).
-     Defaults to Math.random() using JavaScript's built-in Math library.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l856">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.slice">goog.array.slice</a> <span class="args">( arr, start, opt_end )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Returns a new array from a segment of an array. This is a generic version of
+     Defaults to Math.random() using JavaScript's built-in Math library.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l936">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.slice">goog.array.slice</a> <span class="args">( arr, start, opt_end )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Returns a new array from a segment of an array. This is a generic version of
  Array slice. This means that it might work on other objects similar to
  arrays, such as the arguments object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array from
  which to copy a segment.<dt>start: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index of the first element to copy.<dt>opt_end: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index after the last element to copy.</dl><tr><th>Returns<tr><td><dl>A new array containing the specified segment of the
-     original array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l394">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.some">goog.array.some</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls f for each element of an array. If any call returns true, some()
+     original array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l426">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.some">goog.array.some</a> <span class="args">( arr, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls f for each element of an array. If any call returns true, some()
  returns true (without checking the remaining elements). If all calls
  return false, some() returns false.
 
@@ -262,7 +285,7 @@
      like object over which to iterate.<dt>f: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
      for every element. This function takes 3 arguments (the element, the
      index and the array) and should return a boolean.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this'
-     within f.</dl><tr><th>Returns<tr><td><dl>true if any element passes the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1043">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.sort">goog.array.sort</a> <span class="args">( arr, opt_compareFn )</span></span></div><p>Sorts the specified array into ascending order.  If no opt_compareFn is
+     within f.</dl><tr><th>Returns<tr><td><dl>true if any element passes the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1139">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.sort">goog.array.sort</a> <span class="args">( arr, opt_compareFn )</span></span></div><p>Sorts the specified array into ascending order.  If no opt_compareFn is
  specified, elements are compared using
  <code>goog.array.defaultCompare</code>, which compares the elements using
  the built in < and > operators.  This will produce the expected behavior
@@ -276,18 +299,18 @@
      function by which the
      array is to be ordered. Should take 2 arguments to compare, and return a
      negative number, zero, or a positive number depending on whether the
-     first argument is less than, equal to, or greater than the second.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1096">code &raquo;</a><span class="member"><a name="goog.array.sortObjectsByKey">goog.array.sortObjectsByKey</a> <span class="args">( arr, key, opt_compareFn )</span></span></div><p>Sorts an array of objects by the specified object key and compare
+     first argument is less than, equal to, or greater than the second.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1189">code &raquo;</a><span class="member"><a name="goog.array.sortObjectsByKey">goog.array.sortObjectsByKey</a> <span class="args">( arr, key, opt_compareFn )</span></span></div><p>Sorts an array of objects by the specified object key and compare
  function. If no compare function is provided, the key values are
  compared in ascending order using <code>goog.array.defaultCompare</code>.
  This won't work for keys that get renamed by the compiler. So use
  {'foo': 1, 'bar': 2} rather than {foo: 1, bar: 2}.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&gt;</code><dd>An array of objects to sort.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The object key to sort by.<dt>opt_compareFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to use to compare key
-     values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l835">code &raquo;</a><span class="member"><a name="goog.array.splice">goog.array.splice</a> <span class="args">( arr, index, howMany, var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Adds or removes elements from an array. This is a generic version of Array
+     values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l915">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.splice">goog.array.splice</a> <span class="args">( arr, index, howMany, var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Adds or removes elements from an array. This is a generic version of Array
  splice. This means that it might work on other objects similar to arrays,
- such as the arguments object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The array to modify.<dt>index: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>The index at which to start changing the
+ such as the arguments object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to modify.<dt>index: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>The index at which to start changing the
      array. If not defined, treated as 0.<dt>howMany: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>How many elements to remove (0 means no removal. A
      value below 0 is treated as zero and so is any other non number. Numbers
-     are floored).<dt>var_args: <code class="type">...*</code><dd>Optional, additional elements to insert into the
-     array.</dl><tr><th>Returns<tr><td><dl>the removed elements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1070">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.stableSort">goog.array.stableSort</a> <span class="args">( arr, opt_compareFn )</span></span></div><p>Sorts the specified array into ascending order in a stable way.  If no
+     are floored).<dt>var_args: <code class="type">...T</code><dd>Optional, additional elements to insert into the
+     array.</dl><tr><th>Returns<tr><td><dl>the removed elements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1163">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.stableSort">goog.array.stableSort</a> <span class="args">( arr, opt_compareFn )</span></span></div><p>Sorts the specified array into ascending order in a stable way.  If no
  opt_compareFn is specified, elements are compared using
  <code>goog.array.defaultCompare</code>, which compares the elements using
  the built in < and > operators.  This will produce the expected behavior
@@ -298,10 +321,11 @@
      by which the array is to be ordered. Should take 2 arguments to compare,
      and return a negative number, zero, or a positive number depending on
      whether the first argument is less than, equal to, or greater than the
-     second.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l752">code &raquo;</a><span class="member"><a name="goog.array.toArray">goog.array.toArray</a> <span class="args">( object )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Converts an object to an array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type"><a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>The object to convert to an array.</dl><tr><th>Returns<tr><td><dl>The object converted into an array. If object has a
+     second.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l827">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.array.toArray">goog.array.toArray</a> <span class="args">( object )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;</code></span></div><p>Converts an object to an array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The object to convert to an
+     array.</dl><tr><th>Returns<tr><td><dl>The object converted into an array. If object has a
      length property, every property indexed with a non-negative number
      less than length will be included in the result. If object does not
-     have a length property, an empty array will be returned.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1305">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.toObject">goog.array.toObject</a> <span class="args">( arr, keyFunc, opt_obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;T&gt;</code></span></div><p>Creates a new object built from the provided array and the key-generation
+     have a length property, an empty array will be returned.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1392">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.array.toObject">goog.array.toObject</a> <span class="args">( arr, keyFunc, opt_obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;T&gt;</code></span></div><p>Creates a new object built from the provided array and the key-generation
  function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;T&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>Array or array like object over
      which to iterate whose elements will be the values in the new object.<dt>keyFunc: <code class="type">?function(this: S, T, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The function to
      call for every element. This function takes 3 arguments (the element, the
@@ -309,9 +333,9 @@
      key for the element in the new object. If the function returns the same
      key for more than one element, the value for that key is
      implementation-defined.<dt>opt_obj: <code class="type">S=</code><dd>The object to be used as the value of 'this'
-     within keyFunc.</dl><tr><th>Returns<tr><td><dl>The new object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1440">code &raquo;</a><span class="member"><a name="goog.array.zip">goog.array.zip</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Creates a new array for which the element at position i is an array of the
+     within keyFunc.</dl><tr><th>Returns<tr><td><dl>The new object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l1550">code &raquo;</a><span class="member"><a name="goog.array.zip">goog.array.zip</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Creates a new array for which the element at position i is an array of the
  ith element of the provided arrays.  The returned array will only be as long
  as the shortest array provided; additional values are ignored.  For example,
  the result of zipping [1, 2] and [3, 4, 5] is [[1,3], [2, 4]].
 
- This is similar to the zip() function in Python.  See <code  class="type"><a class="unresolved-link">http://docs.python.org/library/functions.html#zip</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Arrays to be combined.</dl><tr><th>Returns<tr><td><dl>A new array of arrays created from provided arrays.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l65">code &raquo;</a><span class="member"><a name="goog.array.ARRAY_PROTOTYPE_">goog.array.ARRAY_PROTOTYPE_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array.prototype</a></code></span></div><p>Reference to the original <code >Array.prototype</code>.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ This is similar to the zip() function in Python.  See <code  class="type"><a class="unresolved-link">http://docs.python.org/library/functions.html#zip</a></code></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Arrays to be combined.</dl><tr><th>Returns<tr><td><dl>A new array of arrays created from provided arrays.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l85">code &raquo;</a><span class="member"><a name="goog.array.ARRAY_PROTOTYPE_">goog.array.ARRAY_PROTOTYPE_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array.prototype</a></code></span></div><p>Reference to the original <code >Array.prototype</code>.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/array/array.js.src.html#l50">code &raquo;</a><span class="member"><a name="goog.array.ASSUME_NATIVE_FUNCTIONS">goog.array.ASSUME_NATIVE_FUNCTIONS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_asserts.html b/docs/namespace_goog_asserts.html
index 5841b61..2c97fd2 100644
--- a/docs/namespace_goog_asserts.html
+++ b/docs/namespace_goog_asserts.html
@@ -1,12 +1,14 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.asserts</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.asserts</h1><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l36">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a><dd>Error object for failed assertions.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l115">code &raquo;</a><span class="member"><a name="goog.asserts.assert">goog.asserts.assert</a> <span class="args">( condition, opt_message, var_args )</span> &rArr; <code class="type">*</code></span></div><p>Checks if the condition evaluates to true if goog.asserts.ENABLE_ASSERTS is
- true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>condition: <code class="type">*</code><dd>The condition to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value of the condition.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the condition evaluates to false.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l232">code &raquo;</a><span class="member"><a name="goog.asserts.assertArray">goog.asserts.assertArray</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Checks if the value is an Array if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a non-null array.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not an array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l251">code &raquo;</a><span class="member"><a name="goog.asserts.assertBoolean">goog.asserts.assertBoolean</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if the value is a boolean if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a boolean when asserts are
-     enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a boolean.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l196">code &raquo;</a><span class="member"><a name="goog.asserts.assertFunction">goog.asserts.assertFunction</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Checks if the value is a function if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a function when asserts
-     enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l276">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.asserts.assertInstanceof">goog.asserts.assertInstanceof</a> <span class="args">( value, type, opt_message, var_args )</span> &rArr; <code class="type">!T</code></span></div><p>Checks if the value is an instance of the user-defined type if
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.asserts</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.asserts</h1><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l36">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a><dd>Error object for failed assertions.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l84">code &raquo;</a><span class="member"><a name="goog.asserts.DEFAULT_ERROR_HANDLER">goog.asserts.DEFAULT_ERROR_HANDLER</a> <span class="args">( e )</span></span></div><p>The default error handler.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type">!<a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>The exception to be handled.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l146">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.asserts.assert">goog.asserts.assert</a> <span class="args">( condition, opt_message, var_args )</span> &rArr; <code class="type">T</code></span></div><p>Checks if the condition evaluates to true if goog.asserts.ENABLE_ASSERTS is
+ true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>condition: <code class="type">T</code><dd>The condition to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value of the condition.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the condition evaluates to false.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l263">code &raquo;</a><span class="member"><a name="goog.asserts.assertArray">goog.asserts.assertArray</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Checks if the value is an Array if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a non-null array.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not an array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l282">code &raquo;</a><span class="member"><a name="goog.asserts.assertBoolean">goog.asserts.assertBoolean</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if the value is a boolean if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a boolean when asserts are
+     enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a boolean.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l301">code &raquo;</a><span class="member"><a name="goog.asserts.assertElement">goog.asserts.assertElement</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Checks if the value is a DOM Element if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, likely to be a DOM Element when asserts are
+     enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a boolean.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l227">code &raquo;</a><span class="member"><a name="goog.asserts.assertFunction">goog.asserts.assertFunction</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Checks if the value is a function if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a function when asserts
+     enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l327">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.asserts.assertInstanceof">goog.asserts.assertInstanceof</a> <span class="args">( value, type, opt_message, var_args )</span> &rArr; <code class="type">!T</code></span></div><p>Checks if the value is an instance of the user-defined type if
  goog.asserts.ENABLE_ASSERTS is true.
 
  The compiler may tighten the type returned by this function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>type: <code class="type">function(new: T, ...)</code><dd>A user-defined constructor.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not an instance of
-     type.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l159">code &raquo;</a><span class="member"><a name="goog.asserts.assertNumber">goog.asserts.assertNumber</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Checks if the value is a number if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a number when asserts enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l214">code &raquo;</a><span class="member"><a name="goog.asserts.assertObject">goog.asserts.assertObject</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Checks if the value is an Object if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a non-null object.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not an object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l177">code &raquo;</a><span class="member"><a name="goog.asserts.assertString">goog.asserts.assertString</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Checks if the value is a string if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a string when asserts enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l88">code &raquo;</a><span class="member"><a name="goog.asserts.doAssertFailure_">goog.asserts.doAssertFailure_</a> <span class="args">( defaultMessage, defaultArgs, givenMessage, givenArgs )</span></span></div><p>Throws an exception with the given message and "Assertion failed" prefixed
- onto it.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>defaultMessage: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The message to use if givenMessage is empty.<dt>defaultArgs: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The substitution arguments for defaultMessage.<dt>givenMessage: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Message supplied by the caller.<dt>givenArgs: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The substitution arguments for givenMessage.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l142">code &raquo;</a><span class="member"><a name="goog.asserts.fail">goog.asserts.fail</a> <span class="args">( opt_message, var_args )</span></span></div><p>Fails if goog.asserts.ENABLE_ASSERTS is true. This function is useful in case
+     type.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l190">code &raquo;</a><span class="member"><a name="goog.asserts.assertNumber">goog.asserts.assertNumber</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Checks if the value is a number if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a number when asserts enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l245">code &raquo;</a><span class="member"><a name="goog.asserts.assertObject">goog.asserts.assertObject</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Checks if the value is an Object if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a non-null object.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not an object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l340">code &raquo;</a><span class="member"><a name="goog.asserts.assertObjectPrototypeIsIntact">goog.asserts.assertObjectPrototypeIsIntact</a> <span class="args">( )</span></span></div><p>Checks that no enumerable keys are present in Object.prototype. Such keys
+ would break most code that use <code >for (var ... in ...)</code> loops.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l208">code &raquo;</a><span class="member"><a name="goog.asserts.assertString">goog.asserts.assertString</a> <span class="args">( value, opt_message, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Checks if the value is a string if goog.asserts.ENABLE_ASSERTS is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to check.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Returns<tr><td><dl>The value, guaranteed to be a string when asserts enabled.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l104">code &raquo;</a><span class="member"><a name="goog.asserts.doAssertFailure_">goog.asserts.doAssertFailure_</a> <span class="args">( defaultMessage, defaultArgs, givenMessage, givenArgs )</span></span></div><p>Throws an exception with the given message and "Assertion failed" prefixed
+ onto it.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>defaultMessage: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The message to use if givenMessage is empty.<dt>defaultArgs: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The substitution arguments for defaultMessage.<dt>givenMessage: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Message supplied by the caller.<dt>givenArgs: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The substitution arguments for givenMessage.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>When the value is not a number.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l91">code &raquo;</a><span class="member"><a name="goog.asserts.errorHandler_">goog.asserts.errorHandler_</a> <span class="args">( )</span></span></div><p>The handler responsible for throwing or logging assertion errors.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l173">code &raquo;</a><span class="member"><a name="goog.asserts.fail">goog.asserts.fail</a> <span class="args">( opt_message, var_args )</span></span></div><p>Fails if goog.asserts.ENABLE_ASSERTS is true. This function is useful in case
  when we want to add a check in the unreachable area like switch-case
  statement:
 
@@ -17,4 +19,6 @@
     default: goog.assert.fail('Unrecognized type: ' + type);
       // We have only 2 types - "default:" section is unreachable code.
   }
- </pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>Failure.</dl></table></div></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l46">code &raquo;</a><span class="member"><a name="goog.asserts.ENABLE_ASSERTS">goog.asserts.ENABLE_ASSERTS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ </pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Error message in case of failure.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the failure message.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>Failure.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l129">code &raquo;</a><span class="member"><a name="goog.asserts.setErrorHandler">goog.asserts.setErrorHandler</a> <span class="args">( errorHandler )</span></span></div><p>Sets a custom error handler that can be used to customize the behavior of
+ assertion failures, for example by turning all assertion failures into log
+ messages.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errorHandler</dl></table></div></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/asserts/asserts.js.src.html#l47">code &raquo;</a><span class="member"><a name="goog.asserts.ENABLE_ASSERTS">goog.asserts.ENABLE_ASSERTS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_async.html b/docs/namespace_goog_async.html
new file mode 100644
index 0000000..75fad2a
--- /dev/null
+++ b/docs/namespace_goog_async.html
@@ -0,0 +1,14 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.async</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.async</h1><a class="source" href="source/lib/goog/async/nexttick.js.src.html#l22">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/nexttick.js.src.html#l58">code &raquo;</a><code class="type">&lt;SCOPE&gt;</code> <span class="member"><a name="goog.async.nextTick">goog.async.nextTick</a> <span class="args">( callback, opt_context )</span></span></div><p>Fires the provided callbacks as soon as possible after the current JS
+ execution context. setTimeout(…, 0) takes at least 4ms when called from
+ within another setTimeout(…, 0) for legacy reasons.
+
+ This will not schedule the callback as a microtask (i.e. a task that can
+ preempt user input or networking callbacks). It is meant to emulate what
+ setTimeout(_, 0) would do if it were not throttled. If you desire microtask
+ behavior, use goog.Promise instead.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type">function(this: SCOPE)</code><dd>Callback function to fire as soon as
+     possible.<dt>opt_context: <code class="type">SCOPE=</code><dd>Object in whose scope to call the listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l30">code &raquo;</a><code class="type">&lt;THIS&gt;</code> <span class="member"><a name="goog.async.run">goog.async.run</a> <span class="args">( callback, opt_context )</span></span></div><p>Fires the provided callback just before the current callstack unwinds, or as
+ soon as possible after the current JS execution context.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback<dt>opt_context: <code class="type">THIS=</code><dd>Object to use as the "this value" when calling
+     the provided function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/nexttick.js.src.html#l37">code &raquo;</a><span class="member"><a name="goog.async.throwException">goog.async.throwException</a> <span class="args">( exception )</span></span></div><p>Throw an item without interrupting the current execution context.  For
+ example, if processing a group of items in a loop, sometimes it is useful
+ to report an error while still allowing the rest of the batch to be
+ processed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>exception</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_async_nextTick.html b/docs/namespace_goog_async_nextTick.html
new file mode 100644
index 0000000..26a5026
--- /dev/null
+++ b/docs/namespace_goog_async_nextTick.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.async.nextTick</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.async.nextTick.<code class="type">&lt;SCOPE&gt;</code></h1><a class="source" href="source/lib/goog/async/nexttick.js.src.html#l58">code &raquo;</a></header><section><p>Fires the provided callbacks as soon as possible after the current JS
+ execution context. setTimeout(…, 0) takes at least 4ms when called from
+ within another setTimeout(…, 0) for legacy reasons.
+
+ This will not schedule the callback as a microtask (i.e. a task that can
+ preempt user input or networking callbacks). It is meant to emulate what
+ setTimeout(_, 0) would do if it were not throttled. If you desire microtask
+ behavior, use goog.Promise instead.<h2>Main</h2><div class="ctor wrap-details public"><div><div class="ctor"><code class="type">&lt;SCOPE&gt;</code> <span class="member">nextTick <span class="args">( callback, opt_context )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type">function(this: SCOPE)</code><dd>Callback function to fire as soon as
+     possible.<dt>opt_context: <code class="type">SCOPE=</code><dd>Object in whose scope to call the listener.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/nexttick.js.src.html#l101">code &raquo;</a><span class="member"><a name="goog.async.nextTick.getSetImmediateEmulator_">goog.async.nextTick.getSetImmediateEmulator_</a> <span class="args">( )</span> &rArr; <code class="type">function(function())</code></span></div><p>Determines the best possible implementation to run a function as soon as
+ the JS event loop is idle.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The "setImmediate" implementation.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/nexttick.js.src.html#l92">code &raquo;</a><span class="member"><a name="goog.async.nextTick.setImmediate_">goog.async.nextTick.setImmediate_</a> <span class="args">( )</span></span></div><p>Cache for the setImmediate implementation.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/nexttick.js.src.html#l206">code &raquo;</a><span class="member"><a name="goog.async.nextTick.wrapCallback_">goog.async.nextTick.wrapCallback_</a> <span class="args">( callback )</span> &rArr; <code class="type">function()</code></span></div><p>Helper function that is overrided to protect callbacks with entry point
+ monitor if the application monitors entry points.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type">function()</code><dd>Callback function to fire as soon as possible.</dl><tr><th>Returns<tr><td><dl>The wrapped callback.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_async_run.html b/docs/namespace_goog_async_run.html
new file mode 100644
index 0000000..80a1ddc
--- /dev/null
+++ b/docs/namespace_goog_async_run.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.async.run</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.async.run.<code class="type">&lt;THIS&gt;</code></h1><a class="source" href="source/lib/goog/async/run.js.src.html#l30">code &raquo;</a></header><section><p>Fires the provided callback just before the current callstack unwinds, or as
+ soon as possible after the current JS execution context.<h2>Main</h2><div class="ctor wrap-details public"><div><div class="ctor"><code class="type">&lt;THIS&gt;</code> <span class="member">run <span class="args">( callback, opt_context )</span></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback<dt>opt_context: <code class="type">THIS=</code><dd>Object to use as the "this value" when calling
+     the provided function.</dl></table></div></div></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_async_run_WorkItem_.html">goog.async.run.WorkItem_</a><dd>No Description.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l73">code &raquo;</a><span class="member"><a name="goog.async.run.forceNextTick">goog.async.run.forceNextTick</a> <span class="args">( )</span></span></div><p>Forces goog.async.run to use nextTick instead of Promise.
+
+ This should only be done in unit tests. It's useful because MockClock
+ replaces nextTick, but not the browser Promise implementation, so it allows
+ Promise-based code to be tested with MockClock.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l49">code &raquo;</a><span class="member"><a name="goog.async.run.initializeRunner_">goog.async.run.initializeRunner_</a> <span class="args">( )</span></span></div><p>Initializes the function to use to process the work queue.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l116">code &raquo;</a><span class="member"><a name="goog.async.run.processWorkQueue">goog.async.run.processWorkQueue</a> <span class="args">( )</span></span></div><p>Run any pending goog.async.run work items. This function is not intended
+ for general use, but for use by entry point handlers to run items ahead of
+ goog.async.nextTick.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l100">code &raquo;</a><span class="member"><a name="goog.async.run.resetQueue_">goog.async.run.resetQueue_</a> <span class="args">( )</span></span></div><p>Reset the event queue.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l84">code &raquo;</a><span class="member"><a name="goog.async.run.schedule_">goog.async.run.schedule_</a> <span class="args">( )</span></span></div><p>The function used to schedule work asynchronousely.</summary></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l88">code &raquo;</a><span class="member"><a name="goog.async.run.workQueueScheduled_">goog.async.run.workQueueScheduled_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/async/run.js.src.html#l92">code &raquo;</a><span class="member"><a name="goog.async.run.workQueue_">goog.async.run.workQueue_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_debug.html b/docs/namespace_goog_debug.html
index 351be28..45efc3d 100644
--- a/docs/namespace_goog_debug.html
+++ b/docs/namespace_goog_debug.html
@@ -1 +1,27 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.debug</h1><a class="source" href="source/lib/goog/debug/error.js.src.html#l24">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_debug_Error.html">goog.debug.Error</a><dd>Base class for custom error objects.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.debug</h1><a class="source" href="source/lib/goog/debug/logrecord.js.src.html#l22">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_goog_debug_EntryPointMonitor.html">goog.debug.EntryPointMonitor</a><dd>No Description.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_debug_Error.html">goog.debug.Error</a><dd>Base class for custom error objects.<dt><a href="class_goog_debug_LogBuffer.html">goog.debug.LogBuffer</a><dd>Creates the log buffer.<dt><a href="class_goog_debug_LogRecord.html">goog.debug.LogRecord</a><dd>LogRecord objects are used to pass logging requests between
+ the logging framework and individual log Handlers.<dt><a href="class_goog_debug_Logger.html">goog.debug.Logger</a><dd>The Logger is an object used for logging debug messages.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l44">code &raquo;</a><a class="member" name="goog.debug.Loggable">goog.debug.Loggable</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code></div><div>A message value that can be handled by a Logger.
+
+ Functions are treated like callbacks, but are only called when the event's
+ log level is enabled. This is useful for logging messages that are expensive
+ to construct.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l41">code &raquo;</a><span class="member"><a name="goog.debug.catchErrors">goog.debug.catchErrors</a> <span class="args">( logFunc, opt_cancel, opt_target )</span></span></div><p>Catches onerror events fired by windows and similar objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>logFunc: <code class="type">function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>The function to call with the error
+    information.<dt>opt_cancel: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to stop the error from reaching the
+    browser.<dt>opt_target: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object that fires onerror events.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l143">code &raquo;</a><span class="member"><a name="goog.debug.deepExpose">goog.debug.deepExpose</a> <span class="args">( obj, opt_showFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Creates a string representing a given primitive or object, and for an
+ object, all its properties and nested objects.  WARNING: If an object is
+ given, it and all its nested objects will be modified.  To detect reference
+ cycles, this method identifies objects using goog.getUid() which mutates the
+ object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>Object to expose.<dt>opt_showFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Also show properties that are functions (by
+     default, functions are omitted).</dl><tr><th>Returns<tr><td><dl>A string representation of <code >obj</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l307">code &raquo;</a><span class="member"><a name="goog.debug.enhanceError">goog.debug.enhanceError</a> <span class="args">( err, opt_message )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code></span></div><p>Converts an object to an Error if it's a String,
+ adds a stacktrace if there isn't one,
+ and optionally adds an extra message.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>err: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>the original thrown object or string.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>optional additional message to add to the
+     error.</dl><tr><th>Returns<tr><td><dl>If err is a string, it is used to create a new Error,
+     which is enhanced and returned.  Otherwise err itself is enhanced
+     and returned.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l106">code &raquo;</a><span class="member"><a name="goog.debug.expose">goog.debug.expose</a> <span class="args">( obj, opt_showFn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Creates a string representing an object and all its properties.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Object to expose.<dt>opt_showFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Show the functions as well as the properties,
+     default is false.</dl><tr><th>Returns<tr><td><dl>The string representation of <code >obj</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l199">code &raquo;</a><span class="member"><a name="goog.debug.exposeArray">goog.debug.exposeArray</a> <span class="args">( arr )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Recursively outputs a nested array as a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The array.</dl><tr><th>Returns<tr><td><dl>String representing nested array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l219">code &raquo;</a><span class="member"><a name="goog.debug.exposeException">goog.debug.exposeException</a> <span class="args">( err, opt_fn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Exposes an exception that has been caught by a try...catch and outputs the
+ error with a stack trace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>err: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Error object or string.<dt>opt_fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Optional function to start stack trace from.</dl><tr><th>Returns<tr><td><dl>Details of exception.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l590">code &raquo;</a><span class="member"><a name="goog.debug.fnNameResolver_">goog.debug.fnNameResolver_</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div><p>Resolves functions to their names.  Resolved function names will be cached.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l533">code &raquo;</a><span class="member"><a name="goog.debug.getFunctionName">goog.debug.getFunctionName</a> <span class="args">( fn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets a function name</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Function to get name of.</dl><tr><th>Returns<tr><td><dl>Function's name.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l394">code &raquo;</a><span class="member"><a name="goog.debug.getNativeStackTrace_">goog.debug.getNativeStackTrace_</a> <span class="args">( fn )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to start getting the trace from.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l423">code &raquo;</a><span class="member"><a name="goog.debug.getStacktrace">goog.debug.getStacktrace</a> <span class="args">( opt_fn )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the current stack trace, either starting from the caller or starting
+ from a specified function that's currently on the call stack.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Optional function to start getting the trace from.
+     If not provided, defaults to the function that called this.</dl><tr><th>Returns<tr><td><dl>Stack trace.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l448">code &raquo;</a><span class="member"><a name="goog.debug.getStacktraceHelper_">goog.debug.getStacktraceHelper_</a> <span class="args">( fn, visited )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Private helper for getStacktrace().</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Function to start getting the trace from.<dt>visited: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>List of functions visited so far.</dl><tr><th>Returns<tr><td><dl>Stack trace starting from function fn.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l342">code &raquo;</a><span class="member"><a name="goog.debug.getStacktraceSimple">goog.debug.getStacktraceSimple</a> <span class="args">( opt_depth )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the current stack trace. Simple and iterative - doesn't worry about
+ catching circular references or getting the args.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_depth: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional maximum depth to trace back to.</dl><tr><th>Returns<tr><td><dl>A string with the function names of all functions in the
+     stack, separated by \n.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l568">code &raquo;</a><span class="member"><a name="goog.debug.makeWhitespaceVisible">goog.debug.makeWhitespaceVisible</a> <span class="args">( string )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Makes whitespace visible by replacing it with printable characters.
+ This is useful in finding diffrences between the expected and the actual
+ output strings of a testcase.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>string: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>whose whitespace needs to be made visible.</dl><tr><th>Returns<tr><td><dl>string whose whitespace is made visible.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l243">code &raquo;</a><span class="member"><a name="goog.debug.normalizeErrorObject">goog.debug.normalizeErrorObject</a> <span class="args">( err )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Normalizes the error/exception object between browsers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>err: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Raw error object.</dl><tr><th>Returns<tr><td><dl>Normalized error object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l523">code &raquo;</a><span class="member"><a name="goog.debug.setFunctionResolver">goog.debug.setFunctionResolver</a> <span class="args">( resolver )</span></span></div><p>Set a custom function name resolver.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>resolver: <code class="type">function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Resolves functions to their
+     names.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l386">code &raquo;</a><span class="member"><a name="goog.debug.MAX_STACK_DEPTH">goog.debug.MAX_STACK_DEPTH</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Max length of stack to try and output</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l582">code &raquo;</a><span class="member"><a name="goog.debug.fnNameCache_">goog.debug.fnNameCache_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Hash map for storing function names that have already been looked up.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/debug/debug.js.src.html#l30">code &raquo;</a><span class="member"><a name="goog.debug.LOGGING_ENABLED">goog.debug.LOGGING_ENABLED</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_debug_LogManager.html b/docs/namespace_goog_debug_LogManager.html
new file mode 100644
index 0000000..4d2a933
--- /dev/null
+++ b/docs/namespace_goog_debug_LogManager.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug.LogManager</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.debug.LogManager</h1><a class="source" href="source/lib/goog/debug/logger.js.src.html#l775">code &raquo;</a></header><section><p>There is a single global LogManager object that is used to maintain a set of
+ shared state about Loggers and log services. This is loosely based on the
+ java class java.util.logging.LogManager.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l853">code &raquo;</a><span class="member"><a name="goog.debug.LogManager.createFunctionForCatchErrors">goog.debug.LogManager.createFunctionForCatchErrors</a> <span class="args">( opt_logger )</span> &rArr; <code class="type">function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code></span></div><p>Creates a function that can be passed to goog.debug.catchErrors. The function
+ will log all reported errors using the given logger.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_logger: <code class="type"><a href="class_goog_debug_Logger.html">goog.debug.Logger</a>=</code><dd>The logger to log the errors to.
+     Defaults to the root logger.</dl><tr><th>Returns<tr><td><dl>The created function.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l869">code &raquo;</a><span class="member"><a name="goog.debug.LogManager.createLogger_">goog.debug.LogManager.createLogger_</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code></span></div><p>Creates the named logger. Will also create the parents of the named logger
+ if they don't yet exist.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the logger.</dl><tr><th>Returns<tr><td><dl>The named logger.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l839">code &raquo;</a><span class="member"><a name="goog.debug.LogManager.getLogger">goog.debug.LogManager.getLogger</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code></span></div><p>Finds a named logger.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A name for the logger. This should be a dot-separated
+ name and should normally be based on the package name or class name of the
+ subsystem, such as goog.net.BrowserChannel.</dl><tr><th>Returns<tr><td><dl>The named logger.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l814">code &raquo;</a><span class="member"><a name="goog.debug.LogManager.getLoggers">goog.debug.LogManager.getLoggers</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns all the loggers.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Map of logger names to logger
+     objects.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l825">code &raquo;</a><span class="member"><a name="goog.debug.LogManager.getRoot">goog.debug.LogManager.getRoot</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code></span></div><p>Returns the root of the logger tree namespace, the logger with the empty
+ string as its name.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The root logger.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l798">code &raquo;</a><span class="member"><a name="goog.debug.LogManager.initialize">goog.debug.LogManager.initialize</a> <span class="args">( )</span></span></div><p>Initializes the LogManager if not already initialized.</summary></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l784">code &raquo;</a><span class="member"><a name="goog.debug.LogManager.loggers_">goog.debug.LogManager.loggers_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Map of logger names to logger objects.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/logger.js.src.html#l792">code &raquo;</a><span class="member"><a name="goog.debug.LogManager.rootLogger_">goog.debug.LogManager.rootLogger_</a> : <code class="type"><a href="class_goog_debug_Logger.html">goog.debug.Logger</a></code></span></div><p>The root logger which is the root of the logger tree.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_debug_entryPointRegistry.html b/docs/namespace_goog_debug_entryPointRegistry.html
new file mode 100644
index 0000000..c76becc
--- /dev/null
+++ b/docs/namespace_goog_debug_entryPointRegistry.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.debug.entryPointRegistry</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.debug.entryPointRegistry</h1><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l29">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l129">code &raquo;</a><span class="member"><a name="goog.debug.entryPointRegistry.monitorAll">goog.debug.entryPointRegistry.monitorAll</a> <span class="args">( monitor )</span></span></div><p>Configures a monitor to wrap all entry points.
+
+ Entry points that have already been registered are immediately wrapped by
+ the monitor. When an entry point is registered in the future, it will also
+ be wrapped by the monitor when it is registered.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>monitor: <code class="type">!<a href="interface_goog_debug_EntryPointMonitor.html">goog.debug.EntryPointMonitor</a></code><dd>An entry point monitor.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l106">code &raquo;</a><span class="member"><a name="goog.debug.entryPointRegistry.register">goog.debug.entryPointRegistry.register</a> <span class="args">( callback )</span></span></div><p>Register an entry point with this module.
+
+ The entry point will be instrumented when a monitor is passed to
+ goog.debug.entryPointRegistry.monitorAll. If this has already occurred, the
+ entry point is instrumented immediately.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type">function(!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>A callback function which is called
+     with a transforming function to instrument the entry point. The callback
+     is responsible for wrapping the relevant entry point with the
+     transforming function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l149">code &raquo;</a><span class="member"><a name="goog.debug.entryPointRegistry.unmonitorAllIfPossible">goog.debug.entryPointRegistry.unmonitorAllIfPossible</a> <span class="args">( monitor )</span></span></div><p>Try to unmonitor all the entry points that have already been registered. If
+ an entry point is registered in the future, it will not be wrapped by the
+ monitor when it is registered. Note that this may fail if the entry points
+ have additional wrapping.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>monitor: <code class="type">!<a href="interface_goog_debug_EntryPointMonitor.html">goog.debug.EntryPointMonitor</a></code><dd>The last monitor to wrap
+     the entry points.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the monitor is not the most recently configured monitor.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l91">code &raquo;</a><span class="member"><a name="goog.debug.entryPointRegistry.monitorsMayExist_">goog.debug.entryPointRegistry.monitorsMayExist_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether goog.debug.entryPointRegistry.monitorAll has ever been called.
+ Checking this allows the compiler to optimize out the registrations.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l82">code &raquo;</a><span class="member"><a name="goog.debug.entryPointRegistry.monitors_">goog.debug.entryPointRegistry.monitors_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Monitors that should wrap all the entry points.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/debug/entrypointregistry.js.src.html#l74">code &raquo;</a><span class="member"><a name="goog.debug.entryPointRegistry.refList_">goog.debug.entryPointRegistry.refList_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>An array of entry point callbacks.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_defineClass.html b/docs/namespace_goog_defineClass.html
new file mode 100644
index 0000000..e0d1d13
--- /dev/null
+++ b/docs/namespace_goog_defineClass.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.defineClass</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.defineClass</h1><a class="source" href="source/lib/goog/base.js.src.html#l2064">code &raquo;</a></header><section><p>Creates a restricted form of a Closure "class":
+   - from the compiler's perspective, the instance returned from the
+     constructor is sealed (no new properties may be added).  This enables
+     better checks.
+   - the compiler will rewrite this definition to a form that is optimal
+     for type checking and optimization (initially this will be a more
+     traditional form).<h2>Main</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">defineClass <span class="args">( superClass, def )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>superClass: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The superclass, Object or null.<dt>def: <code class="type"><a href="namespace_goog_defineClass.html#goog.defineClass.ClassDescriptor">goog.defineClass.ClassDescriptor</a></code><dd>An object literal describing the
+     the class.  It may have the following properties:
+     "constructor": the constructor function
+     "statics": an object literal containing methods to add to the constructor
+        as "static" methods or a function that will receive the constructor
+        function as its only parameter to which static properties can
+        be added.
+     all other properties are added to the prototype.</dl><tr><th>Returns<tr><td><dl>The class constructor.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2103">code &raquo;</a><a class="member" name="goog.defineClass.ClassDescriptor">goog.defineClass.ClassDescriptor</a> : <code class="type">(!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|{constructor: !<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>}|{constructor: !<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>, statics: (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>): void)})</code></div><div>No description.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2172">code &raquo;</a><span class="member"><a name="goog.defineClass.applyProperties_">goog.defineClass.applyProperties_</a> <span class="args">( target, source )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to add properties to.<dt>source: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to copy properites from.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2123">code &raquo;</a><span class="member"><a name="goog.defineClass.createSealingConstructor_">goog.defineClass.createSealingConstructor_</a> <span class="args">( ctr, superClass )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>If goog.defineClass.SEAL_CLASS_INSTANCES is enabled and Object.seal is
+ defined, this function will wrap the constructor in a function that seals the
+ results of the provided constructor function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ctr: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The constructor whose results maybe be sealed.<dt>superClass: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The superclass constructor.</dl><tr><th>Returns<tr><td><dl>The replacement constructor.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2155">code &raquo;</a><span class="member"><a name="goog.defineClass.OBJECT_PROTOTYPE_FIELDS_">goog.defineClass.OBJECT_PROTOTYPE_FIELDS_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>The names of the fields that are defined on Object.prototype.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/base.js.src.html#l2110">code &raquo;</a><span class="member"><a name="goog.defineClass.SEAL_CLASS_INSTANCES">goog.defineClass.SEAL_CLASS_INSTANCES</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_disposable.html b/docs/namespace_goog_disposable.html
new file mode 100644
index 0000000..bedb313
--- /dev/null
+++ b/docs/namespace_goog_disposable.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.disposable</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.disposable</h1><a class="source" href="source/lib/goog/disposable/idisposable.js.src.html#l22">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_goog_disposable_IDisposable.html">goog.disposable.IDisposable</a><dd>Interface for a disposable object.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_dom.html b/docs/namespace_goog_dom.html
new file mode 100644
index 0000000..8a76354
--- /dev/null
+++ b/docs/namespace_goog_dom.html
@@ -0,0 +1,232 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.dom</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.dom</h1><a class="source" href="source/lib/goog/dom/nodetype.js.src.html#l19">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_dom_DomHelper.html">goog.dom.DomHelper</a><dd>Create an instance of a DOM helper with a new document object.</dl></table></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_dom_BrowserFeature.html">goog.dom.BrowserFeature</a><dd>Enum of browser capabilities.<dt><a href="enum_goog_dom_NodeType.html">goog.dom.NodeType</a><dd>Constants for the nodeType attribute in the Node interface.<dt><a href="enum_goog_dom_TagName.html">goog.dom.TagName</a><dd>Enum of all html tag names specified by the W3C HTML4.01 and HTML5
+ specifications.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2341">code &raquo;</a><a class="member" name="goog.dom.Appendable">goog.dom.Appendable</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-536297177">NodeList</a>)</code></div><div>Typedef for use with goog.dom.createDom and goog.dom.append.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l167">code &raquo;</a><span class="member deprecation-notice"><a name="goog.dom.$">goog.dom.$</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="namespace_goog_dom.html#goog.dom.getElement">goog.dom.getElement</a></code> instead.</span></div><p>Alias for getElement.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)</code><dd>Element ID or a DOM node.</dl><tr><th>Returns<tr><td><dl>The element with the given ID, or the node passed in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l343">code &raquo;</a><span class="member deprecation-notice"><a name="goog.dom.$$">goog.dom.$$</a> <span class="args">( opt_tag, opt_class, opt_el )</span> &rArr; <code class="type">{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="namespace_goog_dom.html#goog.dom.getElementsByTagNameAndClass">goog.dom.getElementsByTagNameAndClass</a></code> instead.</span></div><p>Alias for <code >getElementsByTagNameAndClass</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_tag: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Element tag name.<dt>opt_class: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional class name.<dt>opt_el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>Array-like list of elements (only a length
+     property and numerical indices are guaranteed to exist).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l791">code &raquo;</a><span class="member deprecation-notice"><a name="goog.dom.$dom">goog.dom.$dom</a> <span class="args">( tagName, opt_attributes, var_args )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="namespace_goog_dom.html#goog.dom.createDom">goog.dom.createDom</a></code> instead.</span></div><p>Alias for <code >createDom</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tagName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Tag to create.<dt>opt_attributes: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)=</code><dd>If object, then a map of name-value
+     pairs for attributes. If a string, then this is the className of the new
+     element.<dt>var_args: <code class="type">...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-536297177">NodeList</a>)</code><dd>Further DOM nodes or
+     strings for text nodes. If one of the var_args is an array, its
+     children will be added as childNodes instead.</dl><tr><th>Returns<tr><td><dl>Reference to a DOM node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1004">code &raquo;</a><span class="member"><a name="goog.dom.append">goog.dom.append</a> <span class="args">( parent, var_args )</span></span></div><p>Appends a node with text or other nodes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to append nodes to.<dt>var_args: <code class="type">...<a href="namespace_goog_dom.html#goog.dom.Appendable">goog.dom.Appendable</a></code><dd>The things to append to the node.
+     If this is a Node it is appended as is.
+     If this is a string then a text node is appended.
+     If this is an array like object then fields 0 to length - 1 are appended.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l991">code &raquo;</a><span class="member"><a name="goog.dom.appendChild">goog.dom.appendChild</a> <span class="args">( parent, child )</span></span></div><p>Appends a child to a node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Parent.<dt>child: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Child.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l754">code &raquo;</a><span class="member"><a name="goog.dom.append_">goog.dom.append_</a> <span class="args">( doc, parent, args, startIndex )</span></span></div><p>Appends a node with text or other nodes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document to create new nodes in.<dt>parent: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to append nodes to.<dt>args: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments">Arguments</a></code><dd>The values to add. See <code >goog.dom.append</code>.<dt>startIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index of the array to start from.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l950">code &raquo;</a><span class="member"><a name="goog.dom.canHaveChildren">goog.dom.canHaveChildren</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines if the given node can contain children, intended to be used for
+ HTML generation.
+
+ IE natively supports node.canHaveChildren but has inconsistent behavior.
+ Prior to IE8 the base tag allows children and in IE9 all nodes return true
+ for canHaveChildren.
+
+ In practice all non-IE browsers allow you to add children to any node, but
+ the behavior is inconsistent:
+
+ <pre>
+   var a = document.createElement('br');
+   a.appendChild(document.createTextNode('foo'));
+   a.appendChild(document.createTextNode('bar'));
+   console.log(a.childNodes.length);  // 2
+   console.log(a.innerHTML);  // Chrome: "", IE9: "foobar", FF3.5: "foobar"
+ </pre>
+
+ For more information, see:
+ http://dev.w3.org/html5/markup/syntax.html#syntax-elements
+
+ TODO(user): Rename shouldAllowChildren() ?</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to check.</dl><tr><th>Returns<tr><td><dl>Whether the node can contain children.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l263">code &raquo;</a><span class="member"><a name="goog.dom.canUseQuerySelector_">goog.dom.canUseQuerySelector_</a> <span class="args">( parent )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Prefer the standardized (http://www.w3.org/TR/selectors-api/), native and
+ fast W3C Selectors API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type">!(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>)</code><dd>The parent document object.</dl><tr><th>Returns<tr><td><dl>whether or not we can use parent.querySelector* APIs.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1352">code &raquo;</a><span class="member"><a name="goog.dom.compareNodeOrder">goog.dom.compareNodeOrder</a> <span class="args">( node1, node2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Compares the document order of two nodes, returning 0 if they are the same
+ node, a negative number if node1 is before node2, and a positive number if
+ node2 is before node1.  Note that we compare the order the tags appear in the
+ document so in the tree <b><i>text</i></b> the B node is considered to be
+ before the I node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node1: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The first node to compare.<dt>node2: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The second node to compare.</dl><tr><th>Returns<tr><td><dl>0 if the nodes are the same node, a negative number if node1
+     is before node2, and a positive number if node2 is before node1.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1431">code &raquo;</a><span class="member"><a name="goog.dom.compareParentsDescendantNodeIe_">goog.dom.compareParentsDescendantNodeIe_</a> <span class="args">( textNode, node )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Utility function to compare the position of two nodes, when
+ <code >textNode</code>'s parent is an ancestor of <code >node</code>.  If this entry
+ condition is not met, this function will attempt to reference a null object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>textNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The textNode to compare.<dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to compare.</dl><tr><th>Returns<tr><td><dl>-1 if node is before textNode, +1 otherwise.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1453">code &raquo;</a><span class="member"><a name="goog.dom.compareSiblingOrder_">goog.dom.compareSiblingOrder_</a> <span class="args">( node1, node2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Utility function to compare the position of two nodes known to be non-equal
+ siblings.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node1: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The first node to compare.<dt>node2: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The second node to compare.</dl><tr><th>Returns<tr><td><dl>-1 if node1 is before node2, +1 otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1317">code &raquo;</a><span class="member"><a name="goog.dom.contains">goog.dom.contains</a> <span class="args">( parent, descendant )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether a node contains another node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node that should contain the other node.<dt>descendant: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to test presence of.</dl><tr><th>Returns<tr><td><dl>Whether the parent node contains the descendent node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l680">code &raquo;</a><span class="member"><a name="goog.dom.createDom">goog.dom.createDom</a> <span class="args">( tagName, opt_attributes, var_args )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns a dom node with a set of attributes.  This function accepts varargs
+ for subsequent nodes to be added.  Subsequent nodes will be added to the
+ first node as childNodes.
+
+ So:
+ <code>createDom('div', null, createDom('p'), createDom('p'));</code>
+ would return a div with two child paragraphs</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tagName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Tag to create.<dt>opt_attributes: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)=</code><dd>If object, then a map
+     of name-value pairs for attributes. If a string, then this is the
+     className of the new element. If an array, the elements will be joined
+     together as the className of the new element.<dt>var_args: <code class="type">...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-536297177">NodeList</a>)</code><dd>Further DOM nodes or
+     strings for text nodes. If one of the var_args is an array or NodeList,i
+     its elements will be added as childNodes instead.</dl><tr><th>Returns<tr><td><dl>Reference to a DOM node.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l693">code &raquo;</a><span class="member"><a name="goog.dom.createDom_">goog.dom.createDom_</a> <span class="args">( doc, args )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Helper for <code >createDom</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document to create the DOM in.<dt>args: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments">Arguments</a></code><dd>Argument object passed from the callers. See
+     <code >goog.dom.createDom</code> for details.</dl><tr><th>Returns<tr><td><dl>Reference to a DOM node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l799">code &raquo;</a><span class="member"><a name="goog.dom.createElement">goog.dom.createElement</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Creates a new element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Tag name.</dl><tr><th>Returns<tr><td><dl>The new element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l821">code &raquo;</a><span class="member"><a name="goog.dom.createTable">goog.dom.createTable</a> <span class="args">( rows, columns, opt_fillWithNbsp )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Create a table.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rows: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of rows in the table.  Must be >= 1.<dt>columns: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of columns in the table.  Must be >= 1.<dt>opt_fillWithNbsp: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, fills table entries with nsbps.</dl><tr><th>Returns<tr><td><dl>The created table.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l835">code &raquo;</a><span class="member"><a name="goog.dom.createTable_">goog.dom.createTable_</a> <span class="args">( doc, rows, columns, fillWithNbsp )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Create a table.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>Document object to use to create the table.<dt>rows: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of rows in the table.  Must be >= 1.<dt>columns: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of columns in the table.  Must be >= 1.<dt>fillWithNbsp: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>If true, fills table entries with nsbps.</dl><tr><th>Returns<tr><td><dl>The created table.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l809">code &raquo;</a><span class="member"><a name="goog.dom.createTextNode">goog.dom.createTextNode</a> <span class="args">( content )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1312295772">Text</a></code></span></div><p>Creates a new text node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>content: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>Content.</dl><tr><th>Returns<tr><td><dl>The new text node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1474">code &raquo;</a><span class="member"><a name="goog.dom.findCommonAncestor">goog.dom.findCommonAncestor</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Find the deepest common ancestor of the given nodes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The nodes to find a common ancestor of.</dl><tr><th>Returns<tr><td><dl>The common ancestor of the nodes, or null if there is none.
+     null will only be returned if two or more of the nodes are from different
+     documents.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1608">code &raquo;</a><span class="member"><a name="goog.dom.findNode">goog.dom.findNode</a> <span class="args">( root, p )</span> &rArr; <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Finds the first descendant node that matches the filter function, using
+ a depth first search. This function offers the most general purpose way
+ of finding a matching element. You may also wish to consider
+ <code >goog.dom.query</code> which can express many matching criteria using
+ CSS selector expressions. These expressions often result in a more
+ compact representation of the desired result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>root: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The root of the tree to search.<dt>p: <code class="type">function(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The filter function.</dl><tr><th>Returns<tr><td><dl>The found node or undefined if none is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1627">code &raquo;</a><span class="member"><a name="goog.dom.findNodes">goog.dom.findNodes</a> <span class="args">( root, p )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Finds all the descendant nodes that match the filter function, using a
+ a depth first search. This function offers the most general-purpose way
+ of finding a set of matching elements. You may also wish to consider
+ <code >goog.dom.query</code> which can express many matching criteria using
+ CSS selector expressions. These expressions often result in a more
+ compact representation of the desired result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>root: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The root of the tree to search.<dt>p: <code class="type">function(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The filter function.</dl><tr><th>Returns<tr><td><dl>The found nodes or an empty array if none are found.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1645">code &raquo;</a><span class="member"><a name="goog.dom.findNodes_">goog.dom.findNodes_</a> <span class="args">( root, p, rv, findOne )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Finds the first or all the descendant nodes that match the filter function,
+ using a depth first search.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>root: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The root of the tree to search.<dt>p: <code class="type">function(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The filter function.<dt>rv: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The found nodes are added to this array.<dt>findOne: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>If true we exit after the first found node.</dl><tr><th>Returns<tr><td><dl>Whether the search is complete or not. True in case findOne
+     is true and the node is found. False otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1098">code &raquo;</a><span class="member"><a name="goog.dom.flattenElement">goog.dom.flattenElement</a> <span class="args">( element )</span> &rArr; <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Flattens an element. That is, removes it and replace it with its children.
+ Does nothing if the element is not in the document.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to flatten.</dl><tr><th>Returns<tr><td><dl>The original element, detached from the document
+     tree, sans children; or undefined, if the element was not in the document
+     to begin with.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2082">code &raquo;</a><span class="member"><a name="goog.dom.getActiveElement">goog.dom.getActiveElement</a> <span class="args">( doc )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Determines the active element in the given document.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document to look in.</dl><tr><th>Returns<tr><td><dl>The active element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2058">code &raquo;</a><span class="member"><a name="goog.dom.getAncestor">goog.dom.getAncestor</a> <span class="args">( element, matcher, opt_includeNode, opt_maxSearchSteps )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Walks up the DOM hierarchy returning the first ancestor that passes the
+ matcher function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The DOM node to start with.<dt>matcher: <code class="type">function(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>A function that returns true if the
+     passed node matches the desired criteria.<dt>opt_includeNode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, the node itself is included in
+     the search (the first call to the matcher will pass startElement as
+     the node to test).<dt>opt_maxSearchSteps: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Maximum number of levels to search up the
+     dom.</dl><tr><th>Returns<tr><td><dl>DOM node that matched the matcher, or null if there was
+     no match.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2039">code &raquo;</a><span class="member"><a name="goog.dom.getAncestorByClass">goog.dom.getAncestorByClass</a> <span class="args">( element, className )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Walks up the DOM hierarchy returning the first ancestor that has the passed
+ class name. If the passed element matches the specified criteria, the
+ element itself is returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The DOM node to start with.<dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The class name to match.</dl><tr><th>Returns<tr><td><dl>The first ancestor that matches the passed criteria, or
+     null if none match.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2016">code &raquo;</a><span class="member"><a name="goog.dom.getAncestorByTagNameAndClass">goog.dom.getAncestorByTagNameAndClass</a> <span class="args">( element, opt_tag, opt_class )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Walks up the DOM hierarchy returning the first ancestor that has the passed
+ tag name and/or class name. If the passed element matches the specified
+ criteria, the element itself is returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The DOM node to start with.<dt>opt_tag: <code class="type">?(<a href="enum_goog_dom_TagName.html">goog.dom.TagName</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)=</code><dd>The tag name to match (or
+     null/undefined to match only based on class name).<dt>opt_class: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The class name to match (or null/undefined to
+     match only based on tag name).</dl><tr><th>Returns<tr><td><dl>The first ancestor that matches the passed criteria, or
+     null if no match is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1123">code &raquo;</a><span class="member"><a name="goog.dom.getChildren">goog.dom.getChildren</a> <span class="args">( element )</span> &rArr; <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-536297177">NodeList</a>)</code></span></div><p>Returns an array containing just the element children of the given element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element whose element children we want.</dl><tr><th>Returns<tr><td><dl>An array or array-like list of just the element
+     children of the given element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l96">code &raquo;</a><span class="member"><a name="goog.dom.getDocument">goog.dom.getDocument</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div><p>Gets the document object being used by the dom library.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Document object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l484">code &raquo;</a><span class="member"><a name="goog.dom.getDocumentHeight">goog.dom.getDocumentHeight</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Calculates the height of the document.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The height of the current document.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l499">code &raquo;</a><span class="member"><a name="goog.dom.getDocumentHeight_">goog.dom.getDocumentHeight_</a> <span class="args">( win )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Calculates the height of the document of the given window.
+
+ Function code copied from the opensocial gadget api:
+   gadgets.window.adjustHeight(opt_height)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>win: <code class="type">Window</code><dd>The window whose document height to retrieve.</dl><tr><th>Returns<tr><td><dl>The height of the document of the given window.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l584">code &raquo;</a><span class="member"><a name="goog.dom.getDocumentScroll">goog.dom.getDocumentScroll</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Gets the document scroll distance as a coordinate object.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Object with values 'x' and 'y'.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l615">code &raquo;</a><span class="member"><a name="goog.dom.getDocumentScrollElement">goog.dom.getDocumentScrollElement</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Gets the document scroll element.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Scrolling element.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l626">code &raquo;</a><span class="member"><a name="goog.dom.getDocumentScrollElement_">goog.dom.getDocumentScrollElement_</a> <span class="args">( doc )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Helper for <code >getDocumentScrollElement</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document to get the scroll element for.</dl><tr><th>Returns<tr><td><dl>Scrolling element.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l596">code &raquo;</a><span class="member"><a name="goog.dom.getDocumentScroll_">goog.dom.getDocumentScroll_</a> <span class="args">( doc )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Helper for <code >getDocumentScroll</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document to get the scroll for.</dl><tr><th>Returns<tr><td><dl>Object with values 'x' and 'y'.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l76">code &raquo;</a><span class="member"><a name="goog.dom.getDomHelper">goog.dom.getDomHelper</a> <span class="args">( opt_element )</span> &rArr; <code class="type">!<a href="class_goog_dom_DomHelper.html">goog.dom.DomHelper</a></code></span></div><p>Gets the DomHelper object for the document where the element resides.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_element: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>|Window)=</code><dd>If present, gets the DomHelper for this
+     element.</dl><tr><th>Returns<tr><td><dl>The DomHelper.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l109">code &raquo;</a><span class="member"><a name="goog.dom.getElement">goog.dom.getElement</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Gets an element from the current document by element id.
+
+ If an Element is passed in, it is returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)</code><dd>Element ID or a DOM node.</dl><tr><th>Returns<tr><td><dl>The element with the given ID, or the node passed in.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l226">code &raquo;</a><span class="member"><a name="goog.dom.getElementByClass">goog.dom.getElementByClass</a> <span class="args">( className, opt_el )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first element with the provided className.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>the name of the class to look for.<dt>opt_el: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>)=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>The first item with the class name provided.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l122">code &raquo;</a><span class="member"><a name="goog.dom.getElementHelper_">goog.dom.getElementHelper_</a> <span class="args">( doc, element )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Gets an element by id from the given document (if present).
+ If an element is given, it is returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc<dt>element: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)</code><dd>Element ID or a DOM node.</dl><tr><th>Returns<tr><td><dl>The resulting element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l209">code &raquo;</a><span class="member"><a name="goog.dom.getElementsByClass">goog.dom.getElementsByClass</a> <span class="args">( className, opt_el )</span> &rArr; <code class="type">{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code></span></div><p>Returns a static, array-like list of the elements with the provided
+ className.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>the name of the class to look for.<dt>opt_el: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>The items found with the class name provided.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l195">code &raquo;</a><span class="member"><a name="goog.dom.getElementsByTagNameAndClass">goog.dom.getElementsByTagNameAndClass</a> <span class="args">( opt_tag, opt_class, opt_el )</span> &rArr; <code class="type">{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code></span></div><p>Looks up elements by both tag and class name, using browser native functions
+ (<code >querySelectorAll</code>, <code >getElementsByTagName</code> or
+ <code >getElementsByClassName</code>) where possible. This function
+ is a useful, if limited, way of collecting a list of DOM elements
+ with certain characteristics.  <code >goog.dom.query</code> offers a
+ more powerful and general solution which allows matching on CSS3
+ selector expressions, but at increased cost in code size. If all you
+ need is particular tags belonging to a single class, this function
+ is fast and sleek.
+
+ Note that tag names are case sensitive in the SVG namespace, and this
+ function converts opt_tag to uppercase for comparisons. For queries in the
+ SVG namespace you should use querySelector or querySelectorAll instead.
+ https://bugzilla.mozilla.org/show_bug.cgi?id=963870
+ https://bugs.webkit.org/show_bug.cgi?id=83438</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_tag: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Element tag name.<dt>opt_class: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional class name.<dt>opt_el: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>Array-like list of elements (only a length
+     property and numerical indices are guaranteed to exist).</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l278">code &raquo;</a><span class="member"><a name="goog.dom.getElementsByTagNameAndClass_">goog.dom.getElementsByTagNameAndClass_</a> <span class="args">( doc, opt_tag, opt_class, opt_el )</span> &rArr; <code class="type">{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}</code></span></div><p>Helper for <code >getElementsByTagNameAndClass</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document to get the elements in.<dt>opt_tag: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Element tag name.<dt>opt_class: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Optional class name.<dt>opt_el: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>)=</code><dd>Optional element to look in.</dl><tr><th>Returns<tr><td><dl>Array-like list of elements (only a length
+     property and numerical indices are guaranteed to exist).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1142">code &raquo;</a><span class="member"><a name="goog.dom.getFirstElementChild">goog.dom.getFirstElementChild</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first child node that is an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the first child element of.</dl><tr><th>Returns<tr><td><dl>The first child node of <code >node</code> that is an element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1530">code &raquo;</a><span class="member"><a name="goog.dom.getFrameContentDocument">goog.dom.getFrameContentDocument</a> <span class="args">( frame )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div><p>Cross-browser function for getting the document element of a frame or iframe.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frame: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Frame element.</dl><tr><th>Returns<tr><td><dl>The frame content document.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1541">code &raquo;</a><span class="member"><a name="goog.dom.getFrameContentWindow">goog.dom.getFrameContentWindow</a> <span class="args">( frame )</span> &rArr; <code class="type">Window</code></span></div><p>Cross-browser function for getting the window of a frame or iframe.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frame: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Frame element.</dl><tr><th>Returns<tr><td><dl>The window associated with the given frame.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1155">code &raquo;</a><span class="member"><a name="goog.dom.getLastElementChild">goog.dom.getLastElementChild</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the last child node that is an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the last child element of.</dl><tr><th>Returns<tr><td><dl>The last child node of <code >node</code> that is an element.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1198">code &raquo;</a><span class="member"><a name="goog.dom.getNextElementNode_">goog.dom.getNextElementNode_</a> <span class="args">( node, forward )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first node that is an element in the specified direction,
+ starting with <code >node</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the next element from.<dt>forward: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether to look forwards or backwards.</dl><tr><th>Returns<tr><td><dl>The first element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1168">code &raquo;</a><span class="member"><a name="goog.dom.getNextElementSibling">goog.dom.getNextElementSibling</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first next sibling that is an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the next sibling element of.</dl><tr><th>Returns<tr><td><dl>The next sibling of <code >node</code> that is an element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1213">code &raquo;</a><span class="member"><a name="goog.dom.getNextNode">goog.dom.getNextNode</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Returns the next node in source order from the given node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node.</dl><tr><th>Returns<tr><td><dl>The next node in the DOM tree, or null if this was the last
+     node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1949">code &raquo;</a><span class="member"><a name="goog.dom.getNodeAtOffset">goog.dom.getNodeAtOffset</a> <span class="args">( parent, offset, opt_result )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Returns the node at a given offset in a parent node.  If an object is
+ provided for the optional third parameter, the node and the remainder of the
+ offset will stored as properties of this object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The parent node.<dt>offset: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The offset into the parent node.<dt>opt_result: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Object to be used to store the return value. The
+     return value will be stored in the form {node: Node, remainder: number}
+     if this object is provided.</dl><tr><th>Returns<tr><td><dl>The node at the given offset.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1908">code &raquo;</a><span class="member"><a name="goog.dom.getNodeTextLength">goog.dom.getNodeTextLength</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the text length of the text contained in a node, without markup. This
+ is equivalent to the selection length if the node was selected, or the number
+ of cursor movements to traverse the node. Images & BRs take one space.  New
+ lines are ignored.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node whose text content length is being calculated.</dl><tr><th>Returns<tr><td><dl>The length of <code >node</code>'s text content.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1922">code &raquo;</a><span class="member"><a name="goog.dom.getNodeTextOffset">goog.dom.getNodeTextOffset</a> <span class="args">( node, opt_offsetParent )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the text offset of a node relative to one of its ancestors. The text
+ length is the same as the length calculated by goog.dom.getNodeTextLength.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node whose offset is being calculated.<dt>opt_offsetParent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>=</code><dd>The node relative to which the offset will
+     be calculated. Defaults to the node's owner document's body.</dl><tr><th>Returns<tr><td><dl>The text offset.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1582">code &raquo;</a><span class="member"><a name="goog.dom.getOuterHtml">goog.dom.getOuterHtml</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the outerHTML of a node, which islike innerHTML, except that it
+ actually contains the HTML of the node itself.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the HTML of.</dl><tr><th>Returns<tr><td><dl>The outerHTML of the given element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1516">code &raquo;</a><span class="member"><a name="goog.dom.getOwnerDocument">goog.dom.getOwnerDocument</a> <span class="args">( node )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code></span></div><p>Returns the owner document for a node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>|Window)</code><dd>The node to get the document for.</dl><tr><th>Returns<tr><td><dl>The document owning the node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l573">code &raquo;</a><span class="member deprecation-notice"><a name="goog.dom.getPageScroll">goog.dom.getPageScroll</a> <span class="args">( opt_window )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="namespace_goog_dom.html#goog.dom.getDocumentScroll">goog.dom.getDocumentScroll</a></code> instead.</span></div><p>Gets the page scroll distance as a coordinate object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_window: <code class="type">Window=</code><dd>Optional window element to test.</dl><tr><th>Returns<tr><td><dl>Object with values 'x' and 'y'.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1290">code &raquo;</a><span class="member"><a name="goog.dom.getParentElement">goog.dom.getParentElement</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns an element's parent, if it's an Element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The DOM element.</dl><tr><th>Returns<tr><td><dl>The parent, or null if not an Element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2113">code &raquo;</a><span class="member"><a name="goog.dom.getPixelRatio">goog.dom.getPixelRatio</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Gives the current devicePixelRatio.
+
+ By default, this is the value of window.devicePixelRatio (which should be
+ preferred if present).
+
+ If window.devicePixelRatio is not present, the ratio is calculated with
+ window.matchMedia, if present. Otherwise, gives 1.0.
+
+ Some browsers (including Chrome) consider the browser zoom level in the pixel
+ ratio, so the value may change across multiple calls.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The number of actual pixels per virtual pixel.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1182">code &raquo;</a><span class="member"><a name="goog.dom.getPreviousElementSibling">goog.dom.getPreviousElementSibling</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first previous sibling that is an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to get the previous sibling element of.</dl><tr><th>Returns<tr><td><dl>The first previous sibling of <code >node</code> that is
+     an element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1236">code &raquo;</a><span class="member"><a name="goog.dom.getPreviousNode">goog.dom.getPreviousNode</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Returns the previous node in source order from the given node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node.</dl><tr><th>Returns<tr><td><dl>The previous node in the DOM tree, or null if this was the
+     first node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1862">code &raquo;</a><span class="member"><a name="goog.dom.getRawTextContent">goog.dom.getRawTextContent</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the text content of the current node, without markup.
+
+ Unlike <code >getTextContent</code> this method does not collapse whitespaces
+ or normalize lines breaks.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node from which we are getting content.</dl><tr><th>Returns<tr><td><dl>The raw text content.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l138">code &raquo;</a><span class="member"><a name="goog.dom.getRequiredElement">goog.dom.getRequiredElement</a> <span class="args">( id )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Gets an element by id, asserting that the element is found.
+
+ This is used when an element is expected to exist, and should fail with
+ an assertion error if it does not (if assertions are enabled).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>id: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Element ID.</dl><tr><th>Returns<tr><td><dl>The element with the given ID, if it exists.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l249">code &raquo;</a><span class="member"><a name="goog.dom.getRequiredElementByClass">goog.dom.getRequiredElementByClass</a> <span class="args">( className, opt_root )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Ensures an element with the given className exists, and then returns the
+ first element with the provided className.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>the name of the class to look for.<dt>opt_root: <code class="type">(!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>)=</code><dd>Optional element or document to look
+     in.</dl><tr><th>Returns<tr><td><dl>The first item with the class name provided.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="class_goog_asserts_AssertionError.html">goog.asserts.AssertionError</a></code><dd>Thrown if no element is found.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l151">code &raquo;</a><span class="member"><a name="goog.dom.getRequiredElementHelper_">goog.dom.getRequiredElementHelper_</a> <span class="args">( doc, id )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Helper function for getRequiredElementHelper functions, both static and
+ on DomHelper.  Asserts the element with the given id exists.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc<dt>id</dl><tr><th>Returns<tr><td><dl>The element with the given ID, if it exists.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1820">code &raquo;</a><span class="member"><a name="goog.dom.getTextContent">goog.dom.getTextContent</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the text content of the current node, without markup and invisible
+ symbols. New lines are stripped and whitespace is collapsed,
+ such that each character would be visible.
+
+ In browsers that support it, innerText is used.  Other browsers attempt to
+ simulate it via node traversal.  Line breaks are canonicalized in IE.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node from which we are getting content.</dl><tr><th>Returns<tr><td><dl>The text content.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1878">code &raquo;</a><span class="member"><a name="goog.dom.getTextContent_">goog.dom.getTextContent_</a> <span class="args">( node, buf, normalizeWhitespace )</span></span></div><p>Recursive support function for text content retrieval.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node from which we are getting content.<dt>buf: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>string buffer.<dt>normalizeWhitespace: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether to normalize whitespace.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l460">code &raquo;</a><span class="member"><a name="goog.dom.getViewportSize">goog.dom.getViewportSize</a> <span class="args">( opt_window )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Gets the dimensions of the viewport.
+
+ Gecko Standards mode:
+ docEl.clientWidth  Width of viewport excluding scrollbar.
+ win.innerWidth     Width of viewport including scrollbar.
+ body.clientWidth   Width of body element.
+
+ docEl.clientHeight Height of viewport excluding scrollbar.
+ win.innerHeight    Height of viewport including scrollbar.
+ body.clientHeight  Height of document.
+
+ Gecko Backwards compatible mode:
+ docEl.clientWidth  Width of viewport excluding scrollbar.
+ win.innerWidth     Width of viewport including scrollbar.
+ body.clientWidth   Width of viewport excluding scrollbar.
+
+ docEl.clientHeight Height of document.
+ win.innerHeight    Height of viewport including scrollbar.
+ body.clientHeight  Height of viewport excluding scrollbar.
+
+ IE6/7 Standards mode:
+ docEl.clientWidth  Width of viewport excluding scrollbar.
+ win.innerWidth     Undefined.
+ body.clientWidth   Width of body element.
+
+ docEl.clientHeight Height of viewport excluding scrollbar.
+ win.innerHeight    Undefined.
+ body.clientHeight  Height of document element.
+
+ IE5 + IE6/7 Backwards compatible mode:
+ docEl.clientWidth  0.
+ win.innerWidth     Undefined.
+ body.clientWidth   Width of viewport excluding scrollbar.
+
+ docEl.clientHeight 0.
+ win.innerHeight    Undefined.
+ body.clientHeight  Height of viewport excluding scrollbar.
+
+ Opera 9 Standards and backwards compatible mode:
+ docEl.clientWidth  Width of viewport excluding scrollbar.
+ win.innerWidth     Width of viewport including scrollbar.
+ body.clientWidth   Width of viewport excluding scrollbar.
+
+ docEl.clientHeight Height of document.
+ win.innerHeight    Height of viewport including scrollbar.
+ body.clientHeight  Height of viewport excluding scrollbar.
+
+ WebKit:
+ Safari 2
+ docEl.clientHeight Same as scrollHeight.
+ docEl.clientWidth  Same as innerWidth.
+ win.innerWidth     Width of viewport excluding scrollbar.
+ win.innerHeight    Height of the viewport including scrollbar.
+ frame.innerHeight  Height of the viewport exluding scrollbar.
+
+ Safari 3 (tested in 522)
+
+ docEl.clientWidth  Width of viewport excluding scrollbar.
+ docEl.clientHeight Height of viewport excluding scrollbar in strict mode.
+ body.clientHeight  Height of viewport excluding scrollbar in quirks mode.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_window: <code class="type">Window=</code><dd>Optional window element to test.</dl><tr><th>Returns<tr><td><dl>Object with values 'width' and 'height'.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l472">code &raquo;</a><span class="member"><a name="goog.dom.getViewportSize_">goog.dom.getViewportSize_</a> <span class="args">( win )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Helper for <code >getViewportSize</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>win: <code class="type">Window</code><dd>The window to get the view port size for.</dl><tr><th>Returns<tr><td><dl>Object with values 'width' and 'height'.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l643">code &raquo;</a><span class="member"><a name="goog.dom.getWindow">goog.dom.getWindow</a> <span class="args">( opt_doc )</span> &rArr; <code class="type">!Window</code></span></div><p>Gets the window object associated with the given document.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_doc: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>=</code><dd>Document object to get window for.</dl><tr><th>Returns<tr><td><dl>The window associated with the given document.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l656">code &raquo;</a><span class="member"><a name="goog.dom.getWindow_">goog.dom.getWindow_</a> <span class="args">( doc )</span> &rArr; <code class="type">!Window</code></span></div><p>Helper for <code >getWindow</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>Document object to get window for.</dl><tr><th>Returns<tr><td><dl>The window associated with the given document.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1801">code &raquo;</a><span class="member"><a name="goog.dom.hasNonZeroBoundingRect_">goog.dom.hasNonZeroBoundingRect_</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element has a bounding rectangle that would be visible
+ (i.e. its width and height are greater than zero).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element has a non-zero bounding rectangle.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1757">code &raquo;</a><span class="member"><a name="goog.dom.hasSpecifiedTabIndex_">goog.dom.hasSpecifiedTabIndex_</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element has a specified tab index.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element has a specified tab index.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l864">code &raquo;</a><span class="member"><a name="goog.dom.htmlToDocumentFragment">goog.dom.htmlToDocumentFragment</a> <span class="args">( htmlString )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Converts an HTML string into a document fragment. The string must be
+ sanitized in order to avoid cross-site scripting. For example
+ <code >goog.dom.htmlToDocumentFragment(&#39;&amp;lt;img src=x onerror=alert(0)&amp;gt;&#39;)</code>
+ triggers an alert in all browsers, even if the returned document fragment
+ is thrown away immediately.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>htmlString: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The HTML string to convert.</dl><tr><th>Returns<tr><td><dl>The resulting document fragment.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l877">code &raquo;</a><span class="member"><a name="goog.dom.htmlToDocumentFragment_">goog.dom.htmlToDocumentFragment_</a> <span class="args">( doc, htmlString )</span> &rArr; <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Helper for <code >htmlToDocumentFragment</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document.<dt>htmlString: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The HTML string to convert.</dl><tr><th>Returns<tr><td><dl>The resulting document fragment.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1059">code &raquo;</a><span class="member"><a name="goog.dom.insertChildAt">goog.dom.insertChildAt</a> <span class="args">( parent, child, index )</span></span></div><p>Insert a child at a given index. If index is larger than the number of child
+ nodes that the parent currently has, the node is inserted as the last child
+ node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>parent: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element into which to insert the child.<dt>child: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The element to insert.<dt>index: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index at which to insert the new child node. Must
+     not be negative.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1043">code &raquo;</a><span class="member"><a name="goog.dom.insertSiblingAfter">goog.dom.insertSiblingAfter</a> <span class="args">( newNode, refNode )</span></span></div><p>Inserts a new node after an existing reference node (i.e. as the next
+ sibling). If the reference node has no parent, then does nothing.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to insert.<dt>refNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Reference node to insert after.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1030">code &raquo;</a><span class="member"><a name="goog.dom.insertSiblingBefore">goog.dom.insertSiblingBefore</a> <span class="args">( newNode, refNode )</span></span></div><p>Inserts a new node before an existing reference node (i.e. as the previous
+ sibling). If the reference node has no parent, then does nothing.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to insert.<dt>refNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Reference node to insert before.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l902">code &raquo;</a><span class="member"><a name="goog.dom.isCss1CompatMode">goog.dom.isCss1CompatMode</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the browser is in "CSS1-compatible" (standards-compliant)
+ mode, false otherwise.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>True if in CSS1-compatible mode.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l914">code &raquo;</a><span class="member"><a name="goog.dom.isCss1CompatMode_">goog.dom.isCss1CompatMode_</a> <span class="args">( doc )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the browser is in "CSS1-compatible" (standards-compliant)
+ mode, false otherwise.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document to check.</dl><tr><th>Returns<tr><td><dl>True if in CSS1-compatible mode.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1269">code &raquo;</a><span class="member"><a name="goog.dom.isElement">goog.dom.isElement</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object looks like an Element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">?</code><dd>The object being tested for Element likeness.</dl><tr><th>Returns<tr><td><dl>Whether the object looks like an Element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1732">code &raquo;</a><span class="member"><a name="goog.dom.isFocusable">goog.dom.isFocusable</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element can be focused, i.e. it has a tab index that
+ allows it to receive keyboard focus (tabIndex >= 0), or it is an element
+ that natively supports keyboard focus.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element allows keyboard focus.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1696">code &raquo;</a><span class="member"><a name="goog.dom.isFocusableTabIndex">goog.dom.isFocusableTabIndex</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element has a tab index that allows it to receive
+ keyboard focus (tabIndex >= 0), false otherwise.  Note that some elements
+ natively support keyboard focus, even if they have no tab index.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element has a tab index that allows keyboard
+     focus.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1259">code &raquo;</a><span class="member"><a name="goog.dom.isNodeLike">goog.dom.isNodeLike</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object looks like a DOM node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">?</code><dd>The object being tested for node likeness.</dl><tr><th>Returns<tr><td><dl>Whether the object looks like a DOM node.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1982">code &raquo;</a><span class="member"><a name="goog.dom.isNodeList">goog.dom.isNodeList</a> <span class="args">( val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the object is a <code >NodeList</code>.  To qualify as a NodeList,
+ the object must have a numeric length property and an item function (which
+ has type 'string' on IE for some reason).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>val: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object to test.</dl><tr><th>Returns<tr><td><dl>Whether the object is a NodeList.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1772">code &raquo;</a><span class="member"><a name="goog.dom.isTabIndexFocusable_">goog.dom.isTabIndexFocusable_</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element's tab index allows the element to be focused.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element's tab index allows focus.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1280">code &raquo;</a><span class="member"><a name="goog.dom.isWindow">goog.dom.isWindow</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the specified value is a Window object. This includes the
+ global window for HTML pages, and iframe windows.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">?</code><dd>Variable to test.</dl><tr><th>Returns<tr><td><dl>Whether the variable is a window.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l2140">code &raquo;</a><span class="member"><a name="goog.dom.matchesPixelRatio_">goog.dom.matchesPixelRatio_</a> <span class="args">( pixelRatio )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Calculates a mediaQuery to check if the current device supports the
+ given actual to virtual pixel ratio.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>pixelRatio: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The ratio of actual pixels to virtual pixels.</dl><tr><th>Returns<tr><td><dl>pixelRatio if applicable, otherwise 0.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1785">code &raquo;</a><span class="member"><a name="goog.dom.nativelySupportsFocus_">goog.dom.nativelySupportsFocus_</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element is focusable even when tabIndex is not set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element natively supports focus.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1013">code &raquo;</a><span class="member"><a name="goog.dom.removeChildren">goog.dom.removeChildren</a> <span class="args">( node )</span></span></div><p>Removes all the child nodes on a DOM node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to remove children from.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1071">code &raquo;</a><span class="member"><a name="goog.dom.removeNode">goog.dom.removeNode</a> <span class="args">( node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code></span></div><p>Removes a node from its parent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to remove.</dl><tr><th>Returns<tr><td><dl>The node removed if removed; else, null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1082">code &raquo;</a><span class="member"><a name="goog.dom.replaceNode">goog.dom.replaceNode</a> <span class="args">( newNode, oldNode )</span></span></div><p>Replaces a node in the DOM tree. Will do nothing if <code >oldNode</code> has no
+ parent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>newNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to insert.<dt>oldNode: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>Node to replace.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1711">code &raquo;</a><span class="member"><a name="goog.dom.setFocusableTabIndex">goog.dom.setFocusableTabIndex</a> <span class="args">( element, enable )</span></span></div><p>Enables or disables keyboard focus support on the element via its tab index.
+ Only elements for which <code  class="type"><a href="namespace_goog_dom.html#goog.dom.isFocusableTabIndex">goog.dom.isFocusableTabIndex</a></code> returns true
+ (or elements that natively support keyboard focus, like form elements) can
+ receive keyboard focus.  See http://go/tabindex for more info.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element whose tab index is to be changed.<dt>enable: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether to set or remove a tab index on the element
+     that supports keyboard focus.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l351">code &raquo;</a><span class="member"><a name="goog.dom.setProperties">goog.dom.setProperties</a> <span class="args">( element, properties )</span></span></div><p>Sets multiple properties on a node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>DOM node to set properties on.<dt>properties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Hash of property:value pairs.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1552">code &raquo;</a><span class="member"><a name="goog.dom.setTextContent">goog.dom.setTextContent</a> <span class="args">( node, text )</span></span></div><p>Sets the text content of a node, with cross-browser support.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a></code><dd>The node to change the text content of.<dt>text: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The value that should replace the node's content.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l66">code &raquo;</a><span class="member"><a name="goog.dom.COMPAT_MODE_KNOWN_">goog.dom.COMPAT_MODE_KNOWN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether we know the compatibility mode at compile time.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l379">code &raquo;</a><span class="member"><a name="goog.dom.DIRECT_ATTRIBUTE_MAP_">goog.dom.DIRECT_ATTRIBUTE_MAP_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of attributes that should be set using
+ element.setAttribute(key, val) instead of element[key] = val.  Used
+ by goog.dom.setProperties.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1684">code &raquo;</a><span class="member"><a name="goog.dom.PREDEFINED_TAG_VALUES_">goog.dom.PREDEFINED_TAG_VALUES_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of tags which have predefined values with regard to whitespace.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l1670">code &raquo;</a><span class="member"><a name="goog.dom.TAGS_TO_IGNORE_">goog.dom.TAGS_TO_IGNORE_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of tags whose content to ignore when calculating text length.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l89">code &raquo;</a><span class="member"><a name="goog.dom.defaultDomHelper_">goog.dom.defaultDomHelper_</a> : <code class="type"><a href="class_goog_dom_DomHelper.html">goog.dom.DomHelper</a></code></span></div><p>Cached default DOM helper.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l51">code &raquo;</a><span class="member"><a name="goog.dom.ASSUME_QUIRKS_MODE">goog.dom.ASSUME_QUIRKS_MODE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/dom/dom.js.src.html#l58">code &raquo;</a><span class="member"><a name="goog.dom.ASSUME_STANDARDS_MODE">goog.dom.ASSUME_STANDARDS_MODE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_dom_vendor.html b/docs/namespace_goog_dom_vendor.html
new file mode 100644
index 0000000..b8e21e7
--- /dev/null
+++ b/docs/namespace_goog_dom_vendor.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.dom.vendor</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.dom.vendor</h1><a class="source" href="source/lib/goog/dom/vendor.js.src.html#l19">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/vendor.js.src.html#l93">code &raquo;</a><span class="member"><a name="goog.dom.vendor.getPrefixedEventType">goog.dom.vendor.getPrefixedEventType</a> <span class="args">( eventType )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>eventType: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>An event type.</dl><tr><th>Returns<tr><td><dl>A lower-cased vendor prefixed event type.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/vendor.js.src.html#l73">code &raquo;</a><span class="member"><a name="goog.dom.vendor.getPrefixedPropertyName">goog.dom.vendor.getPrefixedPropertyName</a> <span class="args">( propertyName, opt_object )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>propertyName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A property name.<dt>opt_object: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>If provided, we verify if the property exists in
+     the object.</dl><tr><th>Returns<tr><td><dl>A vendor prefixed property name, or null if it does not
+     exist.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/vendor.js.src.html#l31">code &raquo;</a><span class="member"><a name="goog.dom.vendor.getVendorJsPrefix">goog.dom.vendor.getVendorJsPrefix</a> <span class="args">( )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the JS vendor prefix used in CSS properties. Different vendors
+ use different methods of changing the case of the property names.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The JS vendor prefix or null if there is none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/dom/vendor.js.src.html#l51">code &raquo;</a><span class="member"><a name="goog.dom.vendor.getVendorPrefix">goog.dom.vendor.getVendorPrefix</a> <span class="args">( )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the vendor prefix used in CSS properties.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The vendor prefix or null if there is none.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_events.html b/docs/namespace_goog_events.html
new file mode 100644
index 0000000..a072eb5
--- /dev/null
+++ b/docs/namespace_goog_events.html
@@ -0,0 +1,97 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.events</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.events</h1><a class="source" href="source/lib/goog/events/eventid.js.src.html#l15">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_goog_events_Listenable.html">goog.events.Listenable</a><dd>A listenable interface.<dt><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a><dd>An interface that describes a single registered listener.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_events_BrowserEvent.html">goog.events.BrowserEvent</a><dd>Accepts a browser event object and creates a patched, cross browser event
+ object.<dt><a href="class_goog_events_Event.html">goog.events.Event</a><dd>A base class for event objects, so that they can support preventDefault and
+ stopPropagation.<dt><a href="class_goog_events_EventId.html">goog.events.EventId</a><dd>A templated class that is used when registering for events.<dt><a href="class_goog_events_EventTarget.html">goog.events.EventTarget</a><dd>An implementation of <code >goog.events.Listenable</code> with full W3C
+ EventTarget-like support (capture/bubble mechanism, stopping event
+ propagation, preventing default actions).<dt><a href="class_goog_events_Listener.html">goog.events.Listener</a><dd>Simple class that stores information about a listener<dt><a href="class_goog_events_ListenerMap.html">goog.events.ListenerMap</a><dd>Creates a new listener map.</dl></table></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_events_BrowserFeature.html">goog.events.BrowserFeature</a><dd>Enum of browser capabilities.<dt><a href="enum_goog_events_CaptureSimulationMode.html">goog.events.CaptureSimulationMode</a><dd>No Description.<dt><a href="enum_goog_events_EventType.html">goog.events.EventType</a><dd>Constants for event names.<dt><a href="enum_goog_events_KeyCodes.html">goog.events.KeyCodes</a><dd>Key codes for common characters.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/event.js.src.html#l41">code &raquo;</a><a class="member" name="goog.events.EventLike">goog.events.EventLike</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="class_goog_events_Event.html">goog.events.Event</a>|<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code></div><div>A typedef for event like objects that are dispatchable via the
+ goog.events.dispatchEvent function. strings are treated as the type for a
+ goog.events.Event. Objects are treated as an extension of a new
+ goog.events.Event with the type property of the object being used as the type
+ of the Event.</div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l72">code &raquo;</a><a class="member" name="goog.events.Key">goog.events.Key</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a>)</code></div><div>No description.</div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l78">code &raquo;</a><a class="member" name="goog.events.ListenableType">goog.events.ListenableType</a> : <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code></div><div>No description.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l773">code &raquo;</a><span class="member"><a name="goog.events.dispatchEvent">goog.events.dispatchEvent</a> <span class="args">( src, e )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Dispatches an event (or event like object) and calls all listeners
+ listening for events of this type. The type of the event is decided by the
+ type property on the event object.
+
+ If any of the listeners returns false OR calls preventDefault then this
+ function will return false.  If one of the capture listeners calls
+ stopPropagation, then the bubble listeners won't fire.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type"><a href="interface_goog_events_Listenable.html">goog.events.Listenable</a></code><dd>The event target.<dt>e: <code class="type"><a href="namespace_goog_events.html#goog.events.EventLike">goog.events.EventLike</a></code><dd>Event object.</dl><tr><th>Returns<tr><td><dl>If anyone called preventDefault on the event object (or
+     if any of the handlers returns false) this will also return false.
+     If there are no handlers, or if all handlers return true, this returns
+     true.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l643">code &raquo;</a><span class="member"><a name="goog.events.expose">goog.events.expose</a> <span class="args">( e )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Provides a nice string showing the normalized event objects public members</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Event Object.</dl><tr><th>Returns<tr><td><dl>String of the public members of the normalized event object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l733">code &raquo;</a><span class="member"><a name="goog.events.fireListener">goog.events.fireListener</a> <span class="args">( listener, eventObject )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Fires a listener with a set of arguments</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>listener: <code class="type"><a href="class_goog_events_Listener.html">goog.events.Listener</a></code><dd>The listener object to call.<dt>eventObject: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The event object to pass to the listener.</dl><tr><th>Returns<tr><td><dl>Result of listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l681">code &raquo;</a><span class="member"><a name="goog.events.fireListeners">goog.events.fireListeners</a> <span class="args">( obj, type, capture, eventObject )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Fires an object's listeners of a particular type and phase</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object whose listeners to call.<dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>Event type.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Which event phase.<dt>eventObject: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Event object to be passed to listener.</dl><tr><th>Returns<tr><td><dl>True if all listeners returned true else false.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l699">code &raquo;</a><span class="member"><a name="goog.events.fireListeners_">goog.events.fireListeners_</a> <span class="args">( obj, type, capture, eventObject )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Fires an object's listeners of a particular type and phase.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object whose listeners to call.<dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>Event type.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Which event phase.<dt>eventObject: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Event object to be passed to listener.</dl><tr><th>Returns<tr><td><dl>True if all listeners returned true else false.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l590">code &raquo;</a><code class="type">&lt;EVENTOBJ&gt;</code> <span class="member"><a name="goog.events.getListener">goog.events.getListener</a> <span class="args">( src, type, listener, opt_capt, opt_handler )</span> &rArr; <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code></span></div><p>Gets the goog.events.Listener for the event or null if no such listener is
+ in use.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>The target from
+     which to get listeners.<dt>type: <code class="type">(?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;)</code><dd>The type of the event.<dt>listener: <code class="type">(function(EVENTOBJ): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code><dd>The
+     listener function to get.<dt>opt_capt: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>In DOM-compliant browsers, this determines
+                            whether the listener is fired during the
+                            capture or bubble phase of the event.<dt>opt_handler: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Element in whose scope to call the listener.</dl><tr><th>Returns<tr><td><dl>the found listener or null if not found.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l941">code &raquo;</a><span class="member"><a name="goog.events.getListenerMap_">goog.events.getListenerMap_</a> <span class="args">( src )</span> &rArr; <code class="type"><a href="class_goog_events_ListenerMap.html">goog.events.ListenerMap</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">EventTarget</code><dd>The source object.</dl><tr><th>Returns<tr><td><dl>A listener map for the given
+     source object, or null if none exists.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l557">code &raquo;</a><span class="member"><a name="goog.events.getListeners">goog.events.getListeners</a> <span class="args">( obj, type, capture )</span> &rArr; <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_events_Listener.html">goog.events.Listener</a>&gt;</code></span></div><p>Gets the listeners for a given object, type and capture phase.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object to get listeners for.<dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>Event type.<dt>capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Capture phase?.</dl><tr><th>Returns<tr><td><dl>Array of listener objects.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l664">code &raquo;</a><span class="member"><a name="goog.events.getOnString_">goog.events.getOnString_</a> <span class="args">( type )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string with on prepended to the specified type. This is used for IE
+ which expects "on" to be prepended. This function caches the string in order
+ to avoid extra allocations in steady state.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Event type.</dl><tr><th>Returns<tr><td><dl>The type string with 'on' prepended.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l270">code &raquo;</a><span class="member"><a name="goog.events.getProxy">goog.events.getProxy</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Helper function for returning a proxy function.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new or reused function object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l752">code &raquo;</a><span class="member deprecation-notice"><a name="goog.events.getTotalListenerCount">goog.events.getTotalListenerCount</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">This returns estimated count, now that Closure no longer
+ stores a central listener registry. We still return an estimation
+ to keep existing listener-related tests passing. In the near future,
+ this function will be removed.</span></div><p>Gets the total number of listeners currently in the system.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Number of listeners.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l930">code &raquo;</a><span class="member"><a name="goog.events.getUniqueId">goog.events.getUniqueId</a> <span class="args">( identifier )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Creates a unique event id.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>identifier: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The identifier.</dl><tr><th>Returns<tr><td><dl>A unique identifier.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/eventtype.js.src.html#l35">code &raquo;</a><span class="member"><a name="goog.events.getVendorPrefixedName_">goog.events.getVendorPrefixedName_</a> <span class="args">( eventName )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a prefixed event name for the current browser.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>eventName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the event.</dl><tr><th>Returns<tr><td><dl>The prefixed event name.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l806">code &raquo;</a><span class="member"><a name="goog.events.handleBrowserEvent_">goog.events.handleBrowserEvent_</a> <span class="args">( listener, opt_evt )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Handles an event and dispatches it to the correct listeners. This
+ function is a proxy for the real listener the user specified.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>listener: <code class="type"><a href="class_goog_events_Listener.html">goog.events.Listener</a></code><dd>The listener object.<dt>opt_evt: <code class="type">Event=</code><dd>Optional event object that gets passed in via the
+     native event handlers.</dl><tr><th>Returns<tr><td><dl>Result of the event handler.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l627">code &raquo;</a><span class="member"><a name="goog.events.hasListener">goog.events.hasListener</a> <span class="args">( obj, opt_type, opt_capture )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether an event target has any active listeners matching the
+ specified signature. If either the type or capture parameters are
+ unspecified, the function will match on the remaining criteria.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>Target to get
+     listeners for.<dt>opt_type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)=</code><dd>Event type.<dt>opt_capture: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to check for capture or bubble-phase
+     listeners.</dl><tr><th>Returns<tr><td><dl>Whether an event target has one or more listeners matching
+     the requested type and/or capture phase.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l911">code &raquo;</a><span class="member"><a name="goog.events.isMarkedIeEvent_">goog.events.isMarkedIeEvent_</a> <span class="args">( e )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>This is used to check if an IE event has already been handled by the Closure
+ system so we do not do the Closure pass twice for a bubbling event.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type">Event</code><dd>The IE browser event.</dl><tr><th>Returns<tr><td><dl>True if the event object has been marked.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l168">code &raquo;</a><code class="type">&lt;T, EVENTOBJ&gt;</code> <span class="member"><a name="goog.events.listen">goog.events.listen</a> <span class="args">( src, type, listener, opt_capt, opt_handler )</span> &rArr; <code class="type"><a href="namespace_goog_events.html#goog.events.Key">goog.events.Key</a></code></span></div><p>Adds an event listener for a specific event on a native event
+ target (such as a DOM element) or an object that has implemented
+ <code  class="type"><a href="interface_goog_events_Listenable.html">goog.events.Listenable</a></code>. A listener can only be added once
+ to an object and if it is added again the key for the listener is
+ returned. Note that if the existing listener is a one-off listener
+ (registered via listenOnce), it will no longer be a one-off
+ listener after a call to listen().</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>The node to listen
+     to events on.<dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code><dd>Event type or array of event types.<dt>listener: <code class="type">(function(this: T, EVENTOBJ): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code><dd>Callback method, or an object with a handleEvent function.
+     WARNING: passing an Object is now softly deprecated.<dt>opt_capt: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to fire in capture phase (defaults to
+     false).<dt>opt_handler: <code class="type">T=</code><dd>Element in whose scope to call the listener.</dl><tr><th>Returns<tr><td><dl>Unique key for the listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l316">code &raquo;</a><code class="type">&lt;T, EVENTOBJ&gt;</code> <span class="member"><a name="goog.events.listenOnce">goog.events.listenOnce</a> <span class="args">( src, type, listener, opt_capt, opt_handler )</span> &rArr; <code class="type"><a href="namespace_goog_events.html#goog.events.Key">goog.events.Key</a></code></span></div><p>Adds an event listener for a specific event on a native event
+ target (such as a DOM element) or an object that has implemented
+ <code  class="type"><a href="interface_goog_events_Listenable.html">goog.events.Listenable</a></code>. After the event has fired the event
+ listener is removed from the target.
+
+ If an existing listener already exists, listenOnce will do
+ nothing. In particular, if the listener was previously registered
+ via listen(), listenOnce() will not turn the listener into a
+ one-off listener. Similarly, if there is already an existing
+ one-off listener, listenOnce does not modify the listeners (it is
+ still a once listener).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>The node to listen
+     to events on.<dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code><dd>Event type or array of event types.<dt>listener: <code class="type">(function(this: T, EVENTOBJ): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code><dd>Callback method.<dt>opt_capt: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Fire in capture phase?.<dt>opt_handler: <code class="type">T=</code><dd>Element in whose scope to call the listener.</dl><tr><th>Returns<tr><td><dl>Unique key for the listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l353">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.events.listenWithWrapper">goog.events.listenWithWrapper</a> <span class="args">( src, wrapper, listener, opt_capt, opt_handler )</span></span></div><p>Adds an event listener with a specific event wrapper on a DOM Node or an
+ object that has implemented <code  class="type"><a href="interface_goog_events_Listenable.html">goog.events.Listenable</a></code>. A listener can
+ only be added once to an object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>The target to
+     listen to events on.<dt>wrapper: <code class="type">goog.events.EventWrapper</code><dd>Event wrapper to use.<dt>listener: <code class="type">(function(this: T, ?): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code><dd>Callback method, or an object with a handleEvent function.<dt>opt_capt: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to fire in capture phase (defaults to
+     false).<dt>opt_handler: <code class="type">T=</code><dd>Element in whose scope to call the listener.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l210">code &raquo;</a><span class="member"><a name="goog.events.listen_">goog.events.listen_</a> <span class="args">( src, type, listener, callOnce, opt_capt, opt_handler )</span> &rArr; <code class="type"><a href="interface_goog_events_ListenableKey.html">goog.events.ListenableKey</a></code></span></div><p>Adds an event listener for a specific event on a native event
+ target. A listener can only be added once to an object and if it
+ is added again the key for the listener is returned.
+
+ Note that a one-off listener will not change an existing listener,
+ if any. On the other hand a normal listener will change existing
+ one-off listener to become a normal listener.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">EventTarget</code><dd>The node to listen to events on.<dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)</code><dd>Event type.<dt>listener: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Callback function.<dt>callOnce: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether the listener is a one-off
+     listener or otherwise.<dt>opt_capt: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to fire in capture phase (defaults to
+     false).<dt>opt_handler: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Element in whose scope to call the listener.</dl><tr><th>Returns<tr><td><dl>Unique key for the listener.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l872">code &raquo;</a><span class="member"><a name="goog.events.markIeEvent_">goog.events.markIeEvent_</a> <span class="args">( e )</span></span></div><p>This is used to mark the IE event object so we do not do the Closure pass
+ twice for a bubbling event.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type">Event</code><dd>The IE browser event.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l789">code &raquo;</a><span class="member"><a name="goog.events.protectBrowserEventEntryPoint">goog.events.protectBrowserEventEntryPoint</a> <span class="args">( errorHandler )</span></span></div><p>Installs exception protection for the browser event entry point using the
+ given error handler.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>errorHandler: <code class="type">goog.debug.ErrorHandler</code><dd>Error handler with which to
+     protect the entry point.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l498">code &raquo;</a><span class="member"><a name="goog.events.removeAll">goog.events.removeAll</a> <span class="args">( obj, opt_type )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Removes all listeners from an object. You can also optionally
+ remove listeners of a particular type.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Object to remove listeners from. Must be an
+     EventTarget or a goog.events.Listenable.<dt>opt_type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>)=</code><dd>Type of event to remove.
+     Default is all types.</dl><tr><th>Returns<tr><td><dl>Number of listeners removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l543">code &raquo;</a><span class="member deprecation-notice"><a name="goog.events.removeAllNativeListeners">goog.events.removeAllNativeListeners</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">This doesn't do anything, now that Closure no longer
+ stores a central listener registry.</span></div><p>Removes all native listeners registered via goog.events. Native
+ listeners are listeners on native browser objects (such as DOM
+ elements). In particular, goog.events.Listenable and
+ goog.events.EventTarget listeners will NOT be removed.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Number of listeners removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l376">code &raquo;</a><code class="type">&lt;EVENTOBJ&gt;</code> <span class="member"><a name="goog.events.unlisten">goog.events.unlisten</a> <span class="args">( src, type, listener, opt_capt, opt_handler )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes an event listener which was added with listen().</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>The target to stop
+     listening to events on.<dt>type: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;|!<a href="class_goog_events_EventId.html">goog.events.EventId</a>.&lt;EVENTOBJ&gt;|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code><dd>Event type or array of event types to unlisten to.<dt>listener: <code class="type">(function(?): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code><dd>The
+     listener function to remove.<dt>opt_capt: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>In DOM-compliant browsers, this determines
+     whether the listener is fired during the capture or bubble phase of the
+     event.<dt>opt_handler: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Element in whose scope to call the listener.</dl><tr><th>Returns<tr><td><dl>indicating whether the listener was there to remove.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l421">code &raquo;</a><span class="member"><a name="goog.events.unlistenByKey">goog.events.unlistenByKey</a> <span class="args">( key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes an event listener which was added with listen() by the key
+ returned by listen().</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="namespace_goog_events.html#goog.events.Key">goog.events.Key</a></code><dd>The key returned by listen() for this
+     event listener.</dl><tr><th>Returns<tr><td><dl>indicating whether the listener was there to remove.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l482">code &raquo;</a><span class="member"><a name="goog.events.unlistenWithWrapper">goog.events.unlistenWithWrapper</a> <span class="args">( src, wrapper, listener, opt_capt, opt_handler )</span></span></div><p>Removes an event listener which was added with listenWithWrapper().</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>src: <code class="type">(EventTarget|<a href="interface_goog_events_Listenable.html">goog.events.Listenable</a>)</code><dd>The target to stop
+     listening to events on.<dt>wrapper: <code class="type">goog.events.EventWrapper</code><dd>Event wrapper to use.<dt>listener: <code class="type">(function(?): ?|{handleEvent: function(?): ?}|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)</code><dd>The
+     listener function to remove.<dt>opt_capt: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>In DOM-compliant browsers, this determines
+     whether the listener is fired during the capture or bubble phase of the
+     event.<dt>opt_handler: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Element in whose scope to call the listener.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l966">code &raquo;</a><span class="member"><a name="goog.events.wrapListener">goog.events.wrapListener</a> <span class="args">( listener )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>listener: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The listener function or an
+     object that contains handleEvent method.</dl><tr><th>Returns<tr><td><dl>Either the original function or a function that
+     calls obj.handleEvent. If the same listener is passed to this
+     function more than once, the same function is guaranteed to be
+     returned.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l86">code &raquo;</a><span class="member"><a name="goog.events.LISTENER_MAP_PROP_">goog.events.LISTENER_MAP_PROP_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Property name on a native event target for the listener map
+ associated with the event target.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l954">code &raquo;</a><span class="member"><a name="goog.events.LISTENER_WRAPPER_PROP_">goog.events.LISTENER_WRAPPER_PROP_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Expando property for listener function wrapper for Object with
+ handleEvent.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l142">code &raquo;</a><span class="member"><a name="goog.events.listenerCountEstimate_">goog.events.listenerCountEstimate_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Estimated count of total native listeners.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l105">code &raquo;</a><span class="member"><a name="goog.events.onStringMap_">goog.events.onStringMap_</a> : <code class="type">{}</code></span></div><p>Map of computed "on<eventname>" strings for IE event types. Caching
+ this removes an extra object allocation in goog.events.listen which
+ improves IE6 performance.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l94">code &raquo;</a><span class="member"><a name="goog.events.onString_">goog.events.onString_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>String used to prepend to IE event types.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l920">code &raquo;</a><span class="member"><a name="goog.events.uniqueIdCounter_">goog.events.uniqueIdCounter_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Counter to create unique event ids.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/events/events.js.src.html#l135">code &raquo;</a><span class="member"><a name="goog.events.CAPTURE_SIMULATION_MODE">goog.events.CAPTURE_SIMULATION_MODE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_functions.html b/docs/namespace_goog_functions.html
new file mode 100644
index 0000000..a40a710
--- /dev/null
+++ b/docs/namespace_goog_functions.html
@@ -0,0 +1,30 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.functions</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.functions</h1><a class="source" href="source/lib/goog/functions/functions.js.src.html#l23">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l43">code &raquo;</a><span class="member"><a name="goog.functions.FALSE">goog.functions.FALSE</a> <span class="args">( )</span> &rArr; <code class="type">boolean</code></span></div><p>Always returns false.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l57">code &raquo;</a><span class="member"><a name="goog.functions.NULL">goog.functions.NULL</a> <span class="args">( )</span> &rArr; <code class="type">null</code></span></div><p>Always returns NULL.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l50">code &raquo;</a><span class="member"><a name="goog.functions.TRUE">goog.functions.TRUE</a> <span class="args">( )</span> &rArr; <code class="type">boolean</code></span></div><p>Always returns true.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l192">code &raquo;</a><span class="member"><a name="goog.functions.and">goog.functions.and</a> <span class="args">( var_args )</span> &rArr; <code class="type">function(?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Creates a function that returns true if each of its components evaluates
+ to true. The components are evaluated in order, and the evaluation will be
+ short-circuited as soon as a function returns false.
+ For example, (goog.functions.and(f, g))(x) is equivalent to f(x) && g(x).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A list of functions.</dl><tr><th>Returns<tr><td><dl>A function that ANDs its component
+      functions.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l295">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.functions.cacheReturnValue">goog.functions.cacheReturnValue</a> <span class="args">( fn )</span> &rArr; <code class="type">!function(): T</code></span></div><p>Gives a wrapper function that caches the return value of a parameterless
+ function when first called.
+
+ When called for the first time, the given function is called and its
+ return value is cached (thus this is only appropriate for idempotent
+ functions).  Subsequent calls will return the cached return value. This
+ allows the evaluation of expensive functions to be delayed until first used.
+
+ To cache the return values of functions with parameters, see goog.memoize.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">!function(): T</code><dd>A function to lazily evaluate.</dl><tr><th>Returns<tr><td><dl>A wrapped version the function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l146">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.functions.compose">goog.functions.compose</a> <span class="args">( fn, var_args )</span> &rArr; <code class="type">function(?): T</code></span></div><p>Creates the composition of the functions passed in.
+ For example, (goog.functions.compose(f, g))(a) is equivalent to f(g(a)).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function(?): T</code><dd>The final function.<dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A list of functions.</dl><tr><th>Returns<tr><td><dl>The composition of all inputs.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l32">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.functions.constant">goog.functions.constant</a> <span class="args">( retValue )</span> &rArr; <code class="type">function(): T</code></span></div><p>Creates a function that always returns the same value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>retValue: <code class="type">T</code><dd>The value to return.</dl><tr><th>Returns<tr><td><dl>The new function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l253">code &raquo;</a><span class="member"><a name="goog.functions.create">goog.functions.create</a> <span class="args">( constructor, var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Generic factory function to construct an object given the constructor
+ and the arguments. Intended to be bound to create object factories.
+
+ Callers should cast the result to the appropriate type for proper type
+ checking by the compiler.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>constructor: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The constructor for the Object.<dt>var_args: <code class="type">...*</code><dd>The arguments to be passed to the constructor.</dl><tr><th>Returns<tr><td><dl>A new instance of the class given in <code >constructor</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l78">code &raquo;</a><span class="member"><a name="goog.functions.error">goog.functions.error</a> <span class="args">( message )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Creates a function that always throws an error with the given message.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The error message.</dl><tr><th>Returns<tr><td><dl>The error-throwing function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l90">code &raquo;</a><span class="member"><a name="goog.functions.fail">goog.functions.fail</a> <span class="args">( err )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Creates a function that throws the given object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>err: <code class="type">*</code><dd>An object to be thrown.</dl><tr><th>Returns<tr><td><dl>The error-throwing function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l68">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.functions.identity">goog.functions.identity</a> <span class="args">( opt_returnValue, var_args )</span> &rArr; <code class="type">T</code></span></div><p>A simple function that returns the first argument of whatever is passed
+ into it.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_returnValue: <code class="type">T=</code><dd>The single value that will be returned.<dt>var_args: <code class="type">...*</code><dd>Optional trailing arguments. These are ignored.</dl><tr><th>Returns<tr><td><dl>The first argument passed in, or undefined if nothing was passed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l105">code &raquo;</a><span class="member"><a name="goog.functions.lock">goog.functions.lock</a> <span class="args">( f, opt_numArgs )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Given a function, create a function that keeps opt_numArgs arguments and
+ silently discards all additional arguments.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>f: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The original function.<dt>opt_numArgs: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The number of arguments to keep. Defaults to 0.</dl><tr><th>Returns<tr><td><dl>A version of f that only keeps the first opt_numArgs
+     arguments.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l236">code &raquo;</a><span class="member"><a name="goog.functions.not">goog.functions.not</a> <span class="args">( f )</span> &rArr; <code class="type">function(?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Creates a function that returns the Boolean opposite of a provided function.
+ For example, (goog.functions.not(f))(x) is equivalent to !f(x).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>f: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The original function.</dl><tr><th>Returns<tr><td><dl>A function that delegates to f and returns
+ opposite.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l118">code &raquo;</a><span class="member"><a name="goog.functions.nth">goog.functions.nth</a> <span class="args">( n )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Creates a function that returns its nth argument.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>n: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The position of the return argument.</dl><tr><th>Returns<tr><td><dl>A new function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l215">code &raquo;</a><span class="member"><a name="goog.functions.or">goog.functions.or</a> <span class="args">( var_args )</span> &rArr; <code class="type">function(?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Creates a function that returns true if any of its components evaluates
+ to true. The components are evaluated in order, and the evaluation will be
+ short-circuited as soon as a function returns true.
+ For example, (goog.functions.or(f, g))(x) is equivalent to f(x) || g(x).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A list of functions.</dl><tr><th>Returns<tr><td><dl>A function that ORs its component
+    functions.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l170">code &raquo;</a><span class="member"><a name="goog.functions.sequence">goog.functions.sequence</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Creates a function that calls the functions passed in in sequence, and
+ returns the value of the last function. For example,
+ (goog.functions.sequence(f, g))(x) is equivalent to f(x),g(x).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A list of functions.</dl><tr><th>Returns<tr><td><dl>A function that calls all inputs in sequence.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l133">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.functions.withReturnValue">goog.functions.withReturnValue</a> <span class="args">( f, retValue )</span> &rArr; <code class="type">function(?): T</code></span></div><p>Given a function, create a new function that swallows its return value
+ and replaces it with a new one.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>f: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>A function.<dt>retValue: <code class="type">T</code><dd>A new return value.</dl><tr><th>Returns<tr><td><dl>A new function.</dl></table></div></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/functions/functions.js.src.html#l277">code &raquo;</a><span class="member"><a name="goog.functions.CACHE_RETURN_VALUE">goog.functions.CACHE_RETURN_VALUE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_iter.html b/docs/namespace_goog_iter.html
index 22ae8f4..eacac6f 100644
--- a/docs/namespace_goog_iter.html
+++ b/docs/namespace_goog_iter.html
@@ -1,50 +1,127 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.iter</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.iter</h1><a class="source" href="source/lib/goog/iter/iter.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a><dd>Class/interface for iterators.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l36">code &raquo;</a><a class="member" name="goog.iter.Iterable">goog.iter.Iterable</a> : <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>|{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}|{__iterator__: ?})</code></div><div>No description.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l392">code &raquo;</a><span class="member"><a name="goog.iter.chain">goog.iter.chain</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Takes zero or more iterators and returns one iterator that will iterate over
- them in the order chained.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code><dd>Any number of iterator objects.</dl><tr><th>Returns<tr><td><dl>Returns a new iterator that will iterate over
-     all the given iterators' contents.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l656">code &raquo;</a><span class="member"><a name="goog.iter.cycle">goog.iter.cycle</a> <span class="args">( iterable )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Create an iterator to cycle over the iterable's elements indefinitely.
- For example, ([1, 2, 3]) would return : 1, 2, 3, 1, 2, 3, ...</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterable object.</dl><tr><th>Returns<tr><td><dl>An iterator that iterates indefinitely over
- the values in <code >iterable</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l439">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.iter.dropWhile">goog.iter.dropWhile</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Builds a new iterator that iterates over the original, but skips elements as
- long as a supplied function returns true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator object.<dt>f: <code class="type">function(this: T, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
-     every value. This function
-     takes 3 arguments (the value, undefined, and the iterator) and should
-     return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this' within
-     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator that drops elements from the
-     original iterator as long as <code >f</code> is true.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l520">code &raquo;</a><span class="member"><a name="goog.iter.equals">goog.iter.equals</a> <span class="args">( iterable1, iterable2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Iterates over 2 iterators and returns true if they contain the same sequence
- of elements and have the same length.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable1: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The first iterable object.<dt>iterable2: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The second iterable object.</dl><tr><th>Returns<tr><td><dl>true if the iterators contain the same sequence of
-     elements and have the same length.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l367">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.iter.every">goog.iter.every</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Goes through the values in the iterator. Calls f for each these and if any of
- them returns false this returns false (without checking the rest). If all
- return true this will return true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator object.<dt>f: <code class="type">function(this: T, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
-     every value. This function
-     takes 3 arguments (the value, undefined, and the iterator) and should
-     return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this' within
-     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>true if every value passes the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l197">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.iter.filter">goog.iter.filter</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Calls a function for every element in the iterator, and if the function
- returns true adds the element to a new iterator.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator to iterate over.<dt>f: <code class="type">function(this: T, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
-     every element. This function
-     takes 3 arguments (the element, undefined, and the iterator) and should
-     return a boolean.  If the return value is true the element will be
-     included  in the returned iteror.  If it is false the element is not
-     included.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this' within
-     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator in which only elements that
-     passed the test are present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l151">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.iter.forEach">goog.iter.forEach</a> <span class="args">( iterable, f, opt_obj )</span></span></div><p>Calls a function for each element in the iterator with the element of the
- iterator passed as argument.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator to iterate
-     over.  If the iterable is an object <code >toIterator</code> will be called on
-     it.<dt>f: <code class="type">function(this: T, ?, ?, ?): ?</code><dd>The function to call for every
-     element.  This function
-     takes 3 arguments (the element, undefined, and the iterator) and the
-     return value is irrelevant.  The reason for passing undefined as the
-     second argument is so that the same function can be used in
-     goog.array#forEach as well as others.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this' within
-     <code >f</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l261">code &raquo;</a><span class="member"><a name="goog.iter.join">goog.iter.join</a> <span class="args">( iterable, deliminator )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Joins the values in a iterator with a delimiter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator to get the values from.<dt>deliminator: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The text to put between the values.</dl><tr><th>Returns<tr><td><dl>The joined value string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l281">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.iter.map">goog.iter.map</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>For every element in the iterator call a function and return a new iterator
- with that value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator to iterate over.<dt>f: <code class="type">function(this: T, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, ?): ?</code><dd>The function to call for every
-     element.  This function
-     takes 3 arguments (the element, undefined, and the iterator) and should
-     return a new value.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this' within
-     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the results of
-     applying the function to each element in the original iterator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l573">code &raquo;</a><span class="member"><a name="goog.iter.nextOrValue">goog.iter.nextOrValue</a> <span class="args">( iterable, defaultValue )</span> &rArr; <code class="type">*</code></span></div><p>Advances the iterator to the next position, returning the given default value
- instead of throwing an exception if the iterator has no more entries.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterable object.<dt>defaultValue: <code class="type">*</code><dd>The value to return if the iterator is empty.</dl><tr><th>Returns<tr><td><dl>The next item in the iteration, or defaultValue if the iterator
-     was empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l594">code &raquo;</a><span class="member"><a name="goog.iter.product">goog.iter.product</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Cartesian product of zero or more sets.  Gives an iterator that gives every
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.iter</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.iter</h1><a class="source" href="source/lib/goog/iter/iter.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_iter_GroupByIterator_.html">goog.iter.GroupByIterator_</a><dd>Implements the <code >goog.iter.groupBy</code> iterator.<dt><a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a><dd>Class/interface for iterators.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l35">code &raquo;</a><a class="member" name="goog.iter.Iterable">goog.iter.Iterable</a> : <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>|{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>}|{__iterator__: ?})</code></div><div>No description.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l774">code &raquo;</a><span class="member"><a name="goog.iter.accumulate">goog.iter.accumulate</a> <span class="args">( iterable )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code></span></div><p>Creates an iterator that returns running totals from the numbers in
+ <code >iterable</code>. For example, the array <code >[1, 2, 3, 4, 5]</code> yields
+ <code >1 -&gt; 3 -&gt; 6 -&gt; 10 -&gt; 15</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code><dd>The iterable of numbers to
+     accumulate.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the
+     numbers in the series.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l427">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.chain">goog.iter.chain</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Takes zero or more iterables and returns one iterator that will iterate over
+ them in the order chained.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>Any
+     number of iterable objects.</dl><tr><th>Returns<tr><td><dl>Returns a new iterator that will
+     iterate over all the given iterables' contents.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l463">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.chainFromIterable">goog.iter.chainFromIterable</a> <span class="args">( iterable )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Takes a single iterable containing zero or more iterables and returns one
+ iterator that will iterate over each one in the order given.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterable of iterables to chain.</dl><tr><th>Returns<tr><td><dl>Returns a new iterator that will
+     iterate over all the contents of the iterables contained within
+     <code >iterable</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1247">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.combinations">goog.iter.combinations</a> <span class="args">( iterable, length )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Creates an iterator that returns combinations of elements from
+ <code >iterable</code>.
+
+ Combinations are obtained by taking the goog.iter#permutations of
+ <code >iterable</code> and filtering those whose elements appear in the order they
+ are encountered in <code >iterable</code>. For example, the 3-length combinations
+ of <code >[0,1,2,3]</code> are <code >[[0,1,2], [0,1,3], [0,2,3], [1,2,3]]</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable from which to generate combinations.<dt>length: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The length of each combination.</dl><tr><th>Returns<tr><td><dl>A new iterator containing
+     combinations from the <code >iterable</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1290">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.combinationsWithReplacement">goog.iter.combinationsWithReplacement</a> <span class="args">( iterable, length )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Creates an iterator that returns combinations of elements from
+ <code >iterable</code>, with repeated elements possible.
+
+ Combinations are obtained by taking the Cartesian product of <code >length</code>
+ iterables and filtering those whose elements appear in the order they are
+ encountered in <code >iterable</code>. For example, the 2-length combinations of
+ <code >[1,2,3]</code> are <code >[[1,1], [1,2], [1,3], [2,2], [2,3], [3,3]]</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to combine.<dt>length: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The length of each combination.</dl><tr><th>Returns<tr><td><dl>A new iterator containing
+     combinations from the <code >iterable</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l888">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.compress">goog.iter.compress</a> <span class="args">( iterable, selectors )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Creates an iterator that filters <code >iterable</code> based on a series of
+ <code >selectors</code>. On each call to <code >next()</code>, one item is taken from
+ both the <code >iterable</code> and <code >selectors</code> iterators. If the item from
+ <code >selectors</code> evaluates to true, the item from <code >iterable</code> is given.
+ Otherwise, it is skipped. Once either <code >iterable</code> or <code >selectors</code>
+ is exhausted, subsequent calls to <code >next()</code> will throw
+ <code >goog.iter.StopIteration</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to filter.<dt>selectors: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>An
+     iterable of items to be evaluated in a boolean context to determine if
+     the corresponding element in <code >iterable</code> should be included in the
+     result.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the
+     filtered values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1145">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.consume">goog.iter.consume</a> <span class="args">( iterable, count )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Creates an iterator that is advanced <code >count</code> steps ahead. Consumed
+ values are silently discarded. If <code >count</code> is greater than the number
+ of elements in <code >iterable</code>, an empty iterator is returned. Subsequent
+ calls to <code >next()</code> will throw <code >goog.iter.StopIteration</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to consume.<dt>count: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of elements to consume from the iterator.</dl><tr><th>Returns<tr><td><dl>An iterator advanced zero or more steps
+     ahead.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l733">code &raquo;</a><span class="member"><a name="goog.iter.count">goog.iter.count</a> <span class="args">( opt_start, opt_step )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code></span></div><p>Creates an iterator that counts indefinitely from a starting value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_start: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The starting value. Default is 0.<dt>opt_step: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The number to increment with between each call to
+     next. Negative and floating point numbers are allowed. Default is 1.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the values
+     in the series.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l676">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.cycle">goog.iter.cycle</a> <span class="args">( iterable )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Create an iterator to cycle over the iterable's elements indefinitely.
+ For example, ([1, 2, 3]) would return : 1, 2, 3, 1, 2, 3, ...</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable object.</dl><tr><th>Returns<tr><td><dl>An iterator that iterates indefinitely
+     over the values in <code >iterable</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l483">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.iter.dropWhile">goog.iter.dropWhile</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Builds a new iterator that iterates over the original, but skips elements as
+ long as a supplied function returns true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     object.<dt>f: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, <a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every value. This function takes 3 arguments
+     (the value, undefined, and the iterator) and should return a boolean.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator that drops elements from
+     the original iterator as long as <code >f</code> is true.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1097">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.enumerate">goog.iter.enumerate</a> <span class="args">( iterable, opt_start )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Creates an iterator that returns arrays containing a count and an element
+ obtained from the given <code >iterable</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to enumerate.<dt>opt_start: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional starting value. Default is 0.</dl><tr><th>Returns<tr><td><dl>A new iterator containing count/item
+     pairs.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l570">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.equals">goog.iter.equals</a> <span class="args">( iterable1, iterable2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Iterates over two iterables and returns true if they contain the same
+ sequence of elements and have the same length.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable1: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The first
+     iterable object.<dt>iterable2: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The second
+     iterable object.</dl><tr><th>Returns<tr><td><dl>true if the iterables contain the same sequence of elements
+     and have the same length.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l400">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.iter.every">goog.iter.every</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Goes through the values in the iterator. Calls f for each of these and if any
+ of them returns false this returns false (without checking the rest). If all
+ return true this will return true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     object.<dt>f: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, <a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every value. This function takes 3 arguments
+     (the value, undefined, and the iterator) and should return a boolean.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>true if every value passes the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l201">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.iter.filter">goog.iter.filter</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Calls a function for every element in the iterator, and if the function
+ returns true adds the element to a new iterator.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     to iterate over.<dt>f: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, <a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every element. This function takes 3 arguments
+     (the element, undefined, and the iterator) and should return a boolean.
+     If the return value is true the element will be included in the returned
+     iterator.  If it is false the element is not included.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator in which only elements
+     that passed the test are present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l234">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.iter.filterFalse">goog.iter.filterFalse</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Calls a function for every element in the iterator, and if the function
+ returns false adds the element to a new iterator.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     to iterate over.<dt>f: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, <a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every element. This function takes 3 arguments
+     (the element, undefined, and the iterator) and should return a boolean.
+     If the return value is false the element will be included in the returned
+     iterator.  If it is true the element is not included.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator in which only elements
+     that did not pass the test are present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l154">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.iter.forEach">goog.iter.forEach</a> <span class="args">( iterable, f, opt_obj )</span></span></div><p>Calls a function for each element in the iterator with the element of the
+ iterator passed as argument.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     to iterate over. If the iterable is an object <code >toIterator</code> will be
+     called on it.<dt>f: <code class="type">(function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, <a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;)|function(this: THIS, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, <a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;))</code><dd>The function to call for every element.  This function takes 3 arguments
+     (the element, undefined, and the iterator) and the return value is
+     irrelevant.  The reason for passing undefined as the second argument is
+     so that the same function can be used in goog.array#forEach as
+     well as others.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     <code >f</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l999">code &raquo;</a><code class="type">&lt;KEY, VALUE&gt;</code> <span class="member"><a name="goog.iter.groupBy">goog.iter.groupBy</a> <span class="args">( iterable, opt_keyFunc )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Creates an iterator that returns arrays containing elements from the
+ <code >iterable</code> grouped by a key value. For iterables with repeated
+ elements (i.e. sorted according to a particular key function), this function
+ has a <code >uniq</code>-like effect. For example, grouping the array:
+ <code >[A, B, B, C, C, A]</code> produces
+ <code >[A, [A]], [B, [B, B]], [C, [C, C]], [A, [A]]</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to group.<dt>opt_keyFunc: <code class="type">function(VALUE): KEY=</code><dd>Optional function for
+     determining the key value for each group in the <code >iterable</code>. Default
+     is the identity function.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns arrays of
+     consecutive key and groups.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1194">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.hasDuplicates_">goog.iter.hasDuplicates_</a> <span class="args">( arr )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks an array for duplicate elements.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;|<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>)</code><dd>The array to check for
+     duplicates.</dl><tr><th>Returns<tr><td><dl>True, if the array contains duplicates, false otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l290">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.join">goog.iter.join</a> <span class="args">( iterable, deliminator )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Joins the values in a iterator with a delimiter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     to get the values from.<dt>deliminator: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The text to put between the values.</dl><tr><th>Returns<tr><td><dl>The joined value string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1114">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.limit">goog.iter.limit</a> <span class="args">( iterable, limitSize )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Creates an iterator that returns the first <code >limitSize</code> elements from an
+ iterable. If this number is greater than the number of elements in the
+ iterable, all the elements are returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to limit.<dt>limitSize: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The maximum number of elements to return.</dl><tr><th>Returns<tr><td><dl>A new iterator containing
+     <code >limitSize</code> elements.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l312">code &raquo;</a><code class="type">&lt;THIS, VALUE, RESULT&gt;</code> <span class="member"><a name="goog.iter.map">goog.iter.map</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;RESULT&gt;</code></span></div><p>For every element in the iterator call a function and return a new iterator
+ with that value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterator to iterate over.<dt>f: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, !<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;): RESULT</code><dd>The function to call for every element.  This function takes 3 arguments
+     (the element, undefined, and the iterator) and should return a new value.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the
+     results of applying the function to each element in the original
+     iterator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l589">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.nextOrValue">goog.iter.nextOrValue</a> <span class="args">( iterable, defaultValue )</span> &rArr; <code class="type">VALUE</code></span></div><p>Advances the iterator to the next position, returning the given default value
+ instead of throwing an exception if the iterator has no more entries.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterable
+     object.<dt>defaultValue: <code class="type">VALUE</code><dd>The value to return if the iterator is empty.</dl><tr><th>Returns<tr><td><dl>The next item in the iteration, or defaultValue if the
+     iterator was empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1218">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.permutations">goog.iter.permutations</a> <span class="args">( iterable, opt_length )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Creates an iterator that returns permutations of elements in
+ <code >iterable</code>.
+
+ Permutations are obtained by taking the Cartesian product of
+ <code >opt_length</code> iterables and filtering out those with repeated
+ elements. For example, the permutations of <code >[1,2,3]</code> are
+ <code >[[1,2,3], [1,3,2], [2,1,3], [2,3,1], [3,1,2], [3,2,1]]</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable from which to generate permutations.<dt>opt_length: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Length of each permutation. If omitted, defaults
+     to the length of <code >iterable</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator containing the
+     permutations of <code >iterable</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l612">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.product">goog.iter.product</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Cartesian product of zero or more sets.  Gives an iterator that gives every
  combination of one element chosen from each set.  For example,
- ([1, 2], [3, 4]) gives ([1, 3], [1, 4], [2, 3], [2, 4]).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a></code><dd>Zero or more sets, as arrays.</dl><tr><th>Returns<tr><td><dl>An iterator that gives each n-tuple (as an
-     array).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l230">code &raquo;</a><span class="member"><a name="goog.iter.range">goog.iter.range</a> <span class="args">( startOrStop, opt_stop, opt_step )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Creates a new iterator that returns the values in a range.  This function
+ ([1, 2], [3, 4]) gives ([1, 3], [1, 4], [2, 3], [2, 4]).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...!<a href="namespace_goog_array.html#goog.array.ArrayLike">goog.array.ArrayLike</a>.&lt;VALUE&gt;</code><dd>Zero or more sets, as
+     arrays.</dl><tr><th>Returns<tr><td><dl>An iterator that gives each
+     n-tuple (as an array).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l257">code &raquo;</a><span class="member"><a name="goog.iter.range">goog.iter.range</a> <span class="args">( startOrStop, opt_stop, opt_step )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>&gt;</code></span></div><p>Creates a new iterator that returns the values in a range.  This function
  can take 1, 2 or 3 arguments:
  <pre>
  range(5) same as range(0, 5, 1)
@@ -53,26 +130,60 @@
      The start value if 2 or more arguments are provided.  If only one
      argument is used the start value is 0.<dt>opt_stop: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The stop value.  If left out then the first
      argument is used as the stop value.<dt>opt_step: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The number to increment with between each call to
-     next.  This can be negative.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the values in the
-     range.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l310">code &raquo;</a><code class="type">&lt;T, V&gt;</code> <span class="member"><a name="goog.iter.reduce">goog.iter.reduce</a> <span class="args">( iterable, f, val, opt_obj )</span> &rArr; <code class="type">V</code></span></div><p>Passes every element of an iterator into a function and accumulates the
- result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator to iterate over.<dt>f: <code class="type">function(this: T, V, ?): V</code><dd>The function to call for every
-     element. This function takes 2 arguments (the function's previous result
-     or the initial value, and the value of the current element).
-     function(previousValue, currentElement) : newValue.<dt>val: <code class="type">V</code><dd>The initial value to pass into the function on the first call.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this'
-     within f.</dl><tr><th>Returns<tr><td><dl>Result of evaluating f repeatedly across the values of
-     the iterator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l334">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.iter.some">goog.iter.some</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Goes through the values in the iterator. Calls f for each these and if any of
- them returns true, this returns true (without checking the rest). If all
- return false this will return false.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator object.<dt>f: <code class="type">function(this: T, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
-     every value. This function
-     takes 3 arguments (the value, undefined, and the iterator) and should
-     return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this' within
-     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>true if any value passes the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l471">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.iter.takeWhile">goog.iter.takeWhile</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Builds a new iterator that iterates over the original, but only as long as a
- supplied function returns true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator object.<dt>f: <code class="type">function(this: T, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, ?): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for
-     every value. This function
-     takes 3 arguments (the value, undefined, and the iterator) and should
-     return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object in f when called.</dl><tr><th>Returns<tr><td><dl>A new iterator that keeps elements in the
-     original iterator as long as the function is true.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l498">code &raquo;</a><span class="member"><a name="goog.iter.toArray">goog.iter.toArray</a> <span class="args">( iterable )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Converts the iterator to an array</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterator to convert to an array.</dl><tr><th>Returns<tr><td><dl>An array of the elements the iterator iterates over.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l102">code &raquo;</a><span class="member"><a name="goog.iter.toIterator">goog.iter.toIterator</a> <span class="args">( iterable )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Returns an iterator that knows how to iterate over the values in the object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type"><a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>If the object is an iterator it
-     will be returned as is.  If the object has a <code >__iterator__</code> method
-     that will be called to get the value iterator.  If the object is an
-     array-like object we create an iterator for that.</dl><tr><th>Returns<tr><td><dl>An iterator that knows how to iterate over the
-     values in <code >iterable</code>.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l45">code &raquo;</a><span class="member"><a name="goog.iter.StopIteration">goog.iter.StopIteration</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code></span></div><p>Singleton Error object that is used to terminate iterations.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     next.  This can be negative.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the values
+     in the range.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l341">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.iter.reduce">goog.iter.reduce</a> <span class="args">( iterable, f, val, opt_obj )</span> &rArr; <code class="type">VALUE</code></span></div><p>Passes every element of an iterator into a function and accumulates the
+ result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     to iterate over.<dt>f: <code class="type">function(this: THIS, VALUE, VALUE): VALUE</code><dd>The function to call for
+     every element. This function takes 2 arguments (the function's previous
+     result or the initial value, and the value of the current element).
+     function(previousValue, currentElement) : newValue.<dt>val: <code class="type">VALUE</code><dd>The initial value to pass into the function on the first
+     call.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     f.</dl><tr><th>Returns<tr><td><dl>Result of evaluating f repeatedly across the values of
+     the iterator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l755">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.repeat">goog.iter.repeat</a> <span class="args">( value )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Creates an iterator that returns the same object or value repeatedly.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">VALUE</code><dd>Any object or value to repeat.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the
+     repeated value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1170">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.slice">goog.iter.slice</a> <span class="args">( iterable, start, opt_end )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Creates an iterator that returns a range of elements from an iterable.
+ Similar to goog.array#slice but does not support negative indexes.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to slice.<dt>start: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index of the first element to return.<dt>opt_end: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The index after the last element to return. If
+     defined, must be greater than or equal to <code >start</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator containing a slice of
+     the original.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l366">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.iter.some">goog.iter.some</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Goes through the values in the iterator. Calls f for each of these, and if
+ any of them returns true, this returns true (without checking the rest). If
+ all return false this will return false.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     object.<dt>f: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, <a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every value. This function takes 3 arguments
+     (the value, undefined, and the iterator) and should return a boolean.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>true if any value passes the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1026">code &raquo;</a><code class="type">&lt;THIS, RESULT&gt;</code> <span class="member"><a name="goog.iter.starMap">goog.iter.starMap</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;RESULT&gt;</code></span></div><p>Gives an iterator that gives the result of calling the given function
+ <code>f</code> with the arguments taken from the next element from
+ <code>iterable</code> (the elements are expected to also be iterables).
+
+ Similar to goog.iter#map but allows the function to accept multiple
+ arguments from the iterable.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a></code><dd>The iterable of
+     iterables to iterate over.<dt>f: <code class="type">function(this: THIS, *): RESULT</code><dd>The function to call for every
+     element.  This function takes N+2 arguments, where N represents the
+     number of items from the next element of the iterable. The two
+     additional arguments passed to the function are undefined and the
+     iterator itself. The function should return a new value.<dt>opt_obj: <code class="type">THIS=</code><dd>The object to be used as the value of 'this' within
+     <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns the
+     results of applying the function to each element in the original
+     iterator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l516">code &raquo;</a><code class="type">&lt;THIS, VALUE&gt;</code> <span class="member"><a name="goog.iter.takeWhile">goog.iter.takeWhile</a> <span class="args">( iterable, f, opt_obj )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Builds a new iterator that iterates over the original, but only as long as a
+ supplied function returns true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     object.<dt>f: <code class="type">function(this: THIS, VALUE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>, <a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every value. This function takes 3 arguments
+     (the value, undefined, and the iterator) and should return a boolean.<dt>opt_obj: <code class="type">THIS=</code><dd>This is used as the 'this' object in f when called.</dl><tr><th>Returns<tr><td><dl>A new iterator that keeps elements in
+     the original iterator as long as the function is true.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l1049">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.tee">goog.iter.tee</a> <span class="args">( iterable, opt_num )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>&gt;</code></span></div><p>Returns an array of iterators each of which can iterate over the values in
+ <code >iterable</code> without advancing the others.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The
+     iterable to tee.<dt>opt_num: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The number of iterators to create. Default is 2.</dl><tr><th>Returns<tr><td><dl>An array of iterators.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l545">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.toArray">goog.iter.toArray</a> <span class="args">( iterable )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;VALUE&gt;</code></span></div><p>Converts the iterator to an array</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>The iterator
+     to convert to an array.</dl><tr><th>Returns<tr><td><dl>An array of the elements the iterator iterates over.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l104">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.toIterator">goog.iter.toIterator</a> <span class="args">( iterable )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;</code></span></div><p>Returns an iterator that knows how to iterate over the values in the object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>iterable: <code class="type">(<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>If the
+     object is an iterator it will be returned as is.  If the object has an
+     <code >__iterator__</code> method that will be called to get the value
+     iterator.  If the object is an array-like object we create an iterator
+     for that.</dl><tr><th>Returns<tr><td><dl>An iterator that knows how to iterate
+     over the values in <code >iterable</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l801">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.zip">goog.iter.zip</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Creates an iterator that returns arrays containing the ith elements from the
+ provided iterables. The returned arrays will be the same size as the number
+ of iterables given in <code >var_args</code>. Once the shortest iterable is
+ exhausted, subsequent calls to <code >next()</code> will throw
+ <code >goog.iter.StopIteration</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>Any
+     number of iterable objects.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns
+     arrays of elements from the provided iterables.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l833">code &raquo;</a><code class="type">&lt;VALUE&gt;</code> <span class="member"><a name="goog.iter.zipLongest">goog.iter.zipLongest</a> <span class="args">( fillValue, var_args )</span> &rArr; <code class="type">!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a></code></span></div><p>Creates an iterator that returns arrays containing the ith elements from the
+ provided iterables. The returned arrays will be the same size as the number
+ of iterables given in <code >var_args</code>. Shorter iterables will be extended
+ with <code >fillValue</code>. Once the longest iterable is exhausted, subsequent
+ calls to <code >next()</code> will throw <code >goog.iter.StopIteration</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fillValue: <code class="type">VALUE</code><dd>The object or value used to fill shorter iterables.<dt>var_args: <code class="type">...(!<a href="class_goog_iter_Iterator.html">goog.iter.Iterator</a>.&lt;VALUE&gt;|!<a href="namespace_goog_iter.html#goog.iter.Iterable">goog.iter.Iterable</a>)</code><dd>Any
+     number of iterable objects.</dl><tr><th>Returns<tr><td><dl>A new iterator that returns
+     arrays of elements from the provided iterables.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/iter/iter.js.src.html#l44">code &raquo;</a><span class="member"><a name="goog.iter.StopIteration">goog.iter.StopIteration</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code></span></div><p>Singleton Error object that is used to terminate iterations.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_json.html b/docs/namespace_goog_json.html
index 7ce0e5b..a8d4125 100644
--- a/docs/namespace_goog_json.html
+++ b/docs/namespace_goog_json.html
@@ -1,12 +1,10 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.json</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.json</h1><a class="source" href="source/lib/goog/json/json.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_json_Serializer.html">goog.json.Serializer</a><dd>Class that is used to serialize JSON objects to a string.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l116">code &raquo;</a><a class="member" name="goog.json.Replacer">goog.json.Replacer</a> : <code class="type">function(this: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, *): *</code></div><div>JSON replacer, as defined in Section 15.12.3 of the ES5 spec.
-
- TODO(nicksantos): Array should also be a valid replacer.</div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l124">code &raquo;</a><a class="member" name="goog.json.Reviver">goog.json.Reviver</a> : <code class="type">function(this: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, *): *</code></div><div>JSON reviver, as defined in Section 15.12.2 of the ES5 spec.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l32">code &raquo;</a><span class="member"><a name="goog.json.isValid_">goog.json.isValid_</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests if a string is an invalid JSON string. This only ensures that we are
- not using any invalid characters</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to test.</dl><tr><th>Returns<tr><td><dl>True if the input is a valid JSON string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l84">code &raquo;</a><span class="member"><a name="goog.json.parse">goog.json.parse</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Parses a JSON string and returns the result. This throws an exception if
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.json</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.json</h1><a class="source" href="source/lib/goog/json/json.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_json_Serializer.html">goog.json.Serializer</a><dd>Class that is used to serialize JSON objects to a string.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l132">code &raquo;</a><a class="member" name="goog.json.Replacer">goog.json.Replacer</a> : <code class="type">function(this: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, *): *</code></div><div>JSON replacer, as defined in Section 15.12.3 of the ES5 spec.</div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l141">code &raquo;</a><a class="member" name="goog.json.Reviver">goog.json.Reviver</a> : <code class="type">function(this: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, *): *</code></div><div>JSON reviver, as defined in Section 15.12.2 of the ES5 spec.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l42">code &raquo;</a><span class="member"><a name="goog.json.isValid">goog.json.isValid</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests if a string is an invalid JSON string. This only ensures that we are
+ not using any invalid characters</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to test.</dl><tr><th>Returns<tr><td><dl>True if the input is a valid JSON string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l95">code &raquo;</a><span class="member"><a name="goog.json.parse">goog.json.parse</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Parses a JSON string and returns the result. This throws an exception if
  the string is an invalid JSON string.
 
  Note that this is very slow on large strings. If you trust the source of
- the string then you should use unsafeParse instead.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type">*</code><dd>The JSON string to parse.</dl><tr><th>Returns<tr><td><dl>The object generated from the JSON string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l138">code &raquo;</a><span class="member"><a name="goog.json.serialize">goog.json.serialize</a> <span class="args">( object, opt_replacer )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Serializes an object or a value to a JSON string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">*</code><dd>The object to serialize.<dt>opt_replacer: <code class="type">?<a href="namespace_goog_json.html#goog.json.Replacer">goog.json.Replacer</a>=</code><dd>A replacer function
+ the string then you should use unsafeParse instead.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type">*</code><dd>The JSON string to parse.</dl><tr><th>Returns<tr><td><dl>The object generated from the JSON string, or null.</dl><tr><th>Throws<tr><td><dl><dt><dd>if s is invalid JSON.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l155">code &raquo;</a><span class="member"><a name="goog.json.serialize">goog.json.serialize</a> <span class="args">( object, opt_replacer )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Serializes an object or a value to a JSON string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>object: <code class="type">*</code><dd>The object to serialize.<dt>opt_replacer: <code class="type">?<a href="namespace_goog_json.html#goog.json.Replacer">goog.json.Replacer</a>=</code><dd>A replacer function
      called for each (key, value) pair that determines how the value
      should be serialized. By defult, this just returns the value
-     and allows default serialization to kick in.</dl><tr><th>Returns<tr><td><dl>A JSON string representation of the input.</dl><tr><th>Throws<tr><td><dl><dt><dd>if there are loops in the object graph.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l104">code &raquo;</a><span class="member"><a name="goog.json.unsafeParse">goog.json.unsafeParse</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Parses a JSON string and returns the result. This uses eval so it is open
- to security issues and it should only be used if you trust the source.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The JSON string to parse.</dl><tr><th>Returns<tr><td><dl>The object generated from the JSON string.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     and allows default serialization to kick in.</dl><tr><th>Returns<tr><td><dl>A JSON string representation of the input.</dl><tr><th>Throws<tr><td><dl><dt><dd>if there are loops in the object graph.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l117">code &raquo;</a><span class="member"><a name="goog.json.unsafeParse">goog.json.unsafeParse</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Parses a JSON string and returns the result. This uses eval so it is open
+ to security issues and it should only be used if you trust the source.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The JSON string to parse.</dl><tr><th>Returns<tr><td><dl>The object generated from the JSON string.</dl></table></div></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/json/json.js.src.html#l33">code &raquo;</a><span class="member"><a name="goog.json.USE_NATIVE_JSON">goog.json.USE_NATIVE_JSON</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_labs.html b/docs/namespace_goog_labs.html
index 873f175..ec6f76c 100644
--- a/docs/namespace_goog_labs.html
+++ b/docs/namespace_goog_labs.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.labs</h1><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l21">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.labs</h1><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l21">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_labs_testing.html b/docs/namespace_goog_labs_testing.html
index 2d4df99..e97e643 100644
--- a/docs/namespace_goog_labs_testing.html
+++ b/docs/namespace_goog_labs_testing.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.labs.testing</h1><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a><dd>A matcher object to be used in assertThat statements.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_labs_testing_AllOfMatcher.html">goog.labs.testing.AllOfMatcher</a><dd>The AllOf matcher.<dt><a href="class_goog_labs_testing_AnyOfMatcher.html">goog.labs.testing.AnyOfMatcher</a><dd>The AnyOf matcher.<dt><a href="class_goog_labs_testing_CloseToMatcher.html">goog.labs.testing.CloseToMatcher</a><dd>The CloseTo matcher.<dt><a href="class_goog_labs_testing_ContainsStringMatcher.html">goog.labs.testing.ContainsStringMatcher</a><dd>The ContainsString matcher.<dt><a href="class_goog_labs_testing_EndsWithMatcher.html">goog.labs.testing.EndsWithMatcher</a><dd>The EndsWith matcher.<dt><a href="class_goog_labs_testing_EqualToIgnoringWhitespaceMatcher.html">goog.labs.testing.EqualToIgnoringWhitespaceMatcher</a><dd>The EqualToIgnoringWhitespace matcher.<dt><a href="class_goog_labs_testing_EqualToMatcher.html">goog.labs.testing.EqualToMatcher</a><dd>The EqualTo matcher.<dt><a href="class_goog_labs_testing_EqualsMatcher.html">goog.labs.testing.EqualsMatcher</a><dd>The Equals matcher.<dt><a href="class_goog_labs_testing_GreaterThanEqualToMatcher.html">goog.labs.testing.GreaterThanEqualToMatcher</a><dd>The GreaterThanEqualTo matcher.<dt><a href="class_goog_labs_testing_GreaterThanMatcher.html">goog.labs.testing.GreaterThanMatcher</a><dd>The GreaterThan matcher.<dt><a href="class_goog_labs_testing_HasPropertyMatcher.html">goog.labs.testing.HasPropertyMatcher</a><dd>The HasProperty matcher.<dt><a href="class_goog_labs_testing_InstanceOfMatcher.html">goog.labs.testing.InstanceOfMatcher</a><dd>The InstanceOf matcher.<dt><a href="class_goog_labs_testing_IsNotMatcher.html">goog.labs.testing.IsNotMatcher</a><dd>The IsNot matcher.<dt><a href="class_goog_labs_testing_IsNullMatcher.html">goog.labs.testing.IsNullMatcher</a><dd>The IsNull matcher.<dt><a href="class_goog_labs_testing_IsNullOrUndefinedMatcher.html">goog.labs.testing.IsNullOrUndefinedMatcher</a><dd>The IsNullOrUndefined matcher.<dt><a href="class_goog_labs_testing_IsUndefinedMatcher.html">goog.labs.testing.IsUndefinedMatcher</a><dd>The IsUndefined matcher.<dt><a href="class_goog_labs_testing_LessThanEqualToMatcher.html">goog.labs.testing.LessThanEqualToMatcher</a><dd>The LessThanEqualTo matcher.<dt><a href="class_goog_labs_testing_LessThanMatcher.html">goog.labs.testing.LessThanMatcher</a><dd>The lessThan matcher.<dt><a href="class_goog_labs_testing_MatcherError.html">goog.labs.testing.MatcherError</a><dd>Error thrown when a Matcher fails to match the input value.<dt><a href="class_goog_labs_testing_ObjectEqualsMatcher.html">goog.labs.testing.ObjectEqualsMatcher</a><dd>The Equals matcher.<dt><a href="class_goog_labs_testing_RegexMatcher.html">goog.labs.testing.RegexMatcher</a><dd>The MatchesRegex matcher.<dt><a href="class_goog_labs_testing_StartsWithMatcher.html">goog.labs.testing.StartsWithMatcher</a><dd>The StartsWith matcher.<dt><a href="class_goog_labs_testing_StringContainsInOrderMatcher.html">goog.labs.testing.StringContainsInOrderMatcher</a><dd>The StringContainsInOrdermatcher.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/assertthat.js.src.html#l37">code &raquo;</a><span class="member"><a name="goog.labs.testing.assertThat">goog.labs.testing.assertThat</a> <span class="args">( actual, matcher, opt_reason )</span></span></div><p>Asserts that the actual value evaluated by the matcher is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actual: <code class="type">*</code><dd>The object to assert by the matcher.<dt>matcher: <code class="type">!<a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code><dd>A matcher to verify values.<dt>opt_reason: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Description of what is asserted.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.testing</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.labs.testing</h1><a class="source" href="source/lib/goog/labs/testing/matcher.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a><dd>A matcher object to be used in assertThat statements.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_labs_testing_AllOfMatcher.html">goog.labs.testing.AllOfMatcher</a><dd>The AllOf matcher.<dt><a href="class_goog_labs_testing_AnyOfMatcher.html">goog.labs.testing.AnyOfMatcher</a><dd>The AnyOf matcher.<dt><a href="class_goog_labs_testing_CloseToMatcher.html">goog.labs.testing.CloseToMatcher</a><dd>The CloseTo matcher.<dt><a href="class_goog_labs_testing_ContainsStringMatcher.html">goog.labs.testing.ContainsStringMatcher</a><dd>The ContainsString matcher.<dt><a href="class_goog_labs_testing_EndsWithMatcher.html">goog.labs.testing.EndsWithMatcher</a><dd>The EndsWith matcher.<dt><a href="class_goog_labs_testing_EqualToIgnoringWhitespaceMatcher.html">goog.labs.testing.EqualToIgnoringWhitespaceMatcher</a><dd>The EqualToIgnoringWhitespace matcher.<dt><a href="class_goog_labs_testing_EqualToMatcher.html">goog.labs.testing.EqualToMatcher</a><dd>The EqualTo matcher.<dt><a href="class_goog_labs_testing_EqualsMatcher.html">goog.labs.testing.EqualsMatcher</a><dd>The Equals matcher.<dt><a href="class_goog_labs_testing_GreaterThanEqualToMatcher.html">goog.labs.testing.GreaterThanEqualToMatcher</a><dd>The GreaterThanEqualTo matcher.<dt><a href="class_goog_labs_testing_GreaterThanMatcher.html">goog.labs.testing.GreaterThanMatcher</a><dd>The GreaterThan matcher.<dt><a href="class_goog_labs_testing_HasPropertyMatcher.html">goog.labs.testing.HasPropertyMatcher</a><dd>The HasProperty matcher.<dt><a href="class_goog_labs_testing_InstanceOfMatcher.html">goog.labs.testing.InstanceOfMatcher</a><dd>The InstanceOf matcher.<dt><a href="class_goog_labs_testing_IsNotMatcher.html">goog.labs.testing.IsNotMatcher</a><dd>The IsNot matcher.<dt><a href="class_goog_labs_testing_IsNullMatcher.html">goog.labs.testing.IsNullMatcher</a><dd>The IsNull matcher.<dt><a href="class_goog_labs_testing_IsNullOrUndefinedMatcher.html">goog.labs.testing.IsNullOrUndefinedMatcher</a><dd>The IsNullOrUndefined matcher.<dt><a href="class_goog_labs_testing_IsUndefinedMatcher.html">goog.labs.testing.IsUndefinedMatcher</a><dd>The IsUndefined matcher.<dt><a href="class_goog_labs_testing_LessThanEqualToMatcher.html">goog.labs.testing.LessThanEqualToMatcher</a><dd>The LessThanEqualTo matcher.<dt><a href="class_goog_labs_testing_LessThanMatcher.html">goog.labs.testing.LessThanMatcher</a><dd>The lessThan matcher.<dt><a href="class_goog_labs_testing_MatcherError.html">goog.labs.testing.MatcherError</a><dd>Error thrown when a Matcher fails to match the input value.<dt><a href="class_goog_labs_testing_ObjectEqualsMatcher.html">goog.labs.testing.ObjectEqualsMatcher</a><dd>The Equals matcher.<dt><a href="class_goog_labs_testing_RegexMatcher.html">goog.labs.testing.RegexMatcher</a><dd>The MatchesRegex matcher.<dt><a href="class_goog_labs_testing_StartsWithMatcher.html">goog.labs.testing.StartsWithMatcher</a><dd>The StartsWith matcher.<dt><a href="class_goog_labs_testing_StringContainsInOrderMatcher.html">goog.labs.testing.StringContainsInOrderMatcher</a><dd>The StringContainsInOrdermatcher.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/testing/assertthat.js.src.html#l37">code &raquo;</a><span class="member"><a name="goog.labs.testing.assertThat">goog.labs.testing.assertThat</a> <span class="args">( actual, matcher, opt_reason )</span></span></div><p>Asserts that the actual value evaluated by the matcher is true.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>actual: <code class="type">*</code><dd>The object to assert by the matcher.<dt>matcher: <code class="type">!<a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code><dd>A matcher to verify values.<dt>opt_reason: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Description of what is asserted.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_labs_userAgent.html b/docs/namespace_goog_labs_userAgent.html
new file mode 100644
index 0000000..732c4b7
--- /dev/null
+++ b/docs/namespace_goog_labs_userAgent.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.userAgent</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.labs.userAgent</h1><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l29">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_labs_userAgent_browser.html b/docs/namespace_goog_labs_userAgent_browser.html
new file mode 100644
index 0000000..acc4108
--- /dev/null
+++ b/docs/namespace_goog_labs_userAgent_browser.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.userAgent.browser</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.labs.userAgent.browser</h1><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l24">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l226">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.getIEVersion_">goog.labs.userAgent.browser.getIEVersion_</a> <span class="args">( userAgent )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Determines IE version. More information:
+ http://msdn.microsoft.com/en-us/library/ie/bg182625(v=vs.85).aspx#uaString
+ http://msdn.microsoft.com/en-us/library/hh869301(v=vs.85).aspx
+ http://blogs.msdn.com/b/ie/archive/2010/03/23/introducing-ie9-s-user-agent-string.aspx
+ http://blogs.msdn.com/b/ie/archive/2009/01/09/the-internet-explorer-8-user-agent-string-updated-edition.aspx</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>userAgent: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>the User-Agent.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l155">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.getVersion">goog.labs.userAgent.browser.getVersion</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The browser version or empty string if version cannot be
+     determined. Note that for Internet Explorer, this returns the version of
+     the browser, not the version of the rendering engine. (IE 8 in
+     compatibility mode will return 8.0 rather than 7.0. To determine the
+     rendering engine version, look at document.documentMode instead. See
+     http://msdn.microsoft.com/en-us/library/cc196988(v=vs.85).aspx for more
+     details.)</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l132">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.isAndroidBrowser">goog.labs.userAgent.browser.isAndroidBrowser</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is the Android browser.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l125">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.isChrome">goog.labs.userAgent.browser.isChrome</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Chrome.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l111">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.isFirefox">goog.labs.userAgent.browser.isFirefox</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Firefox.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l105">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.isIE">goog.labs.userAgent.browser.isIE</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is IE.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l99">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.isOpera">goog.labs.userAgent.browser.isOpera</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Opera.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l118">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.isSafari">goog.labs.userAgent.browser.isSafari</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Safari.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l141">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.isSilk">goog.labs.userAgent.browser.isSilk</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>For more information, see:
+ http://docs.aws.amazon.com/silk/latest/developerguide/user-agent.html</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Silk.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l209">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.isVersionOrHigher">goog.labs.userAgent.browser.isVersionOrHigher</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The version to check.</dl><tr><th>Returns<tr><td><dl>Whether the browser version is higher or the same as the
+     given version.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l87">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.matchAndroidBrowser_">goog.labs.userAgent.browser.matchAndroidBrowser_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is the Android browser.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l77">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.matchChrome_">goog.labs.userAgent.browser.matchChrome_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Chrome.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l56">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.matchFirefox_">goog.labs.userAgent.browser.matchFirefox_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Firefox.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l46">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.matchIE_">goog.labs.userAgent.browser.matchIE_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is IE.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l36">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.matchOpera_">goog.labs.userAgent.browser.matchOpera_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Opera.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/browser.js.src.html#l65">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.browser.matchSafari_">goog.labs.userAgent.browser.matchSafari_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user's browser is Safari.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_labs_userAgent_engine.html b/docs/namespace_goog_labs_userAgent_engine.html
new file mode 100644
index 0000000..1f9b838
--- /dev/null
+++ b/docs/namespace_goog_labs_userAgent_engine.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.userAgent.engine</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.labs.userAgent.engine</h1><a class="source" href="source/lib/goog/labs/useragent/engine.js.src.html#l23">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/engine.js.src.html#l70">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.engine.getVersion">goog.labs.userAgent.engine.getVersion</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The rendering engine's version or empty string if version
+     can't be determined.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/engine.js.src.html#l122">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.engine.getVersionForKey_">goog.labs.userAgent.engine.getVersionForKey_</a> <span class="args">( tuples, key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>tuples: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>Version tuples.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to look for.</dl><tr><th>Returns<tr><td><dl>The version string of the given key, if present.
+     Otherwise, the empty string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/engine.js.src.html#l59">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.engine.isGecko">goog.labs.userAgent.engine.isGecko</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the rendering engine is Gecko.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/engine.js.src.html#l33">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.engine.isPresto">goog.labs.userAgent.engine.isPresto</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the rendering engine is Presto.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/engine.js.src.html#l41">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.engine.isTrident">goog.labs.userAgent.engine.isTrident</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the rendering engine is Trident.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/engine.js.src.html#l109">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.engine.isVersionOrHigher">goog.labs.userAgent.engine.isVersionOrHigher</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The version to check.</dl><tr><th>Returns<tr><td><dl>Whether the rendering engine version is higher or the same
+     as the given version.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/engine.js.src.html#l51">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.engine.isWebKit">goog.labs.userAgent.engine.isWebKit</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the rendering engine is WebKit.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_labs_userAgent_util.html b/docs/namespace_goog_labs_userAgent_util.html
new file mode 100644
index 0000000..e56994c
--- /dev/null
+++ b/docs/namespace_goog_labs_userAgent_util.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.labs.userAgent.util</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.labs.userAgent.util</h1><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l29">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l120">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.util.extractVersionTuples">goog.labs.userAgent.util.extractVersionTuples</a> <span class="args">( userAgent )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Parses the user agent into tuples for each section.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>userAgent</dl><tr><th>Returns<tr><td><dl>Tuples of key, version, and the contents
+     of the parenthetical.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l41">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.util.getNativeUserAgentString_">goog.labs.userAgent.util.getNativeUserAgentString_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the native userAgent string from navigator if it exists.
+ If navigator or navigator.userAgent string is missing, returns an empty
+ string.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l59">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.util.getNavigator_">goog.labs.userAgent.util.getNavigator_</a> <span class="args">( )</span> &rArr; <code class="type">Navigator</code></span></div><p>Getter for the native navigator.
+ This is a separate function so it can be stubbed out in testing.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l88">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.util.getUserAgent">goog.labs.userAgent.util.getUserAgent</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The user agent string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l98">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.util.matchUserAgent">goog.labs.userAgent.util.matchUserAgent</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str</dl><tr><th>Returns<tr><td><dl>Whether the user agent contains the given string, ignoring
+     case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l108">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.util.matchUserAgentIgnoreCase">goog.labs.userAgent.util.matchUserAgentIgnoreCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str</dl><tr><th>Returns<tr><td><dl>Whether the user agent contains the given string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l79">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.util.setUserAgent">goog.labs.userAgent.util.setUserAgent</a> <span class="args">( opt_userAgent )</span></span></div><p>Applications may override browser detection on the built in
+ navigator.userAgent object by setting this string. Set to null to use the
+ browser object instead.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_userAgent: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The User-Agent override.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/labs/useragent/util.js.src.html#l69">code &raquo;</a><span class="member"><a name="goog.labs.userAgent.util.userAgent_">goog.labs.userAgent.util.userAgent_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>A possible override for applications which wish to not check
+ navigator.userAgent but use a specified value for detection instead.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_math.html b/docs/namespace_goog_math.html
new file mode 100644
index 0000000..224a4e6
--- /dev/null
+++ b/docs/namespace_goog_math.html
@@ -0,0 +1,61 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.math</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.math</h1><a class="source" href="source/lib/goog/math/size.js.src.html#l20">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_math_Box.html">goog.math.Box</a><dd>Class for representing a box.<dt><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a><dd>Class for representing coordinates and positions.<dt><a href="class_goog_math_Rect.html">goog.math.Rect</a><dd>Class for representing rectangular regions.<dt><a href="class_goog_math_Size.html">goog.math.Size</a><dd>Class for representing sizes consisting of a width and height.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l185">code &raquo;</a><span class="member"><a name="goog.math.angle">goog.math.angle</a> <span class="args">( x1, y1, x2, y2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Computes the angle between two points (x1,y1) and (x2,y2).
+ Angle zero points in the +X direction, 90 degrees points in the +Y
+ direction (down) and from there we grow clockwise towards 360 degrees.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>x1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>x of first point.<dt>y1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>y of first point.<dt>x2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>x of second point.<dt>y2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>y of second point.</dl><tr><th>Returns<tr><td><dl>Standardized angle in degrees of the vector from
+     x1,y1 to x2,y2.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l205">code &raquo;</a><span class="member"><a name="goog.math.angleDifference">goog.math.angleDifference</a> <span class="args">( startAngle, endAngle )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Computes the difference between startAngle and endAngle (angles in degrees).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>startAngle: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Start angle in degrees.<dt>endAngle: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>End angle in degrees.</dl><tr><th>Returns<tr><td><dl>The number of degrees that when added to
+     startAngle will result in endAngle. Positive numbers mean that the
+     direction is clockwise. Negative numbers indicate a counter-clockwise
+     direction.
+     The shortest route (clockwise vs counter-clockwise) between the angles
+     is used.
+     When the difference is 180 degrees, the function returns 180 (not -180)
+     angleDifference(30, 40) is 10, and angleDifference(40, 30) is -10.
+     angleDifference(350, 10) is 20, and angleDifference(10, 350) is -20.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l158">code &raquo;</a><span class="member"><a name="goog.math.angleDx">goog.math.angleDx</a> <span class="args">( degrees, radius )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>For a given angle and radius, finds the X portion of the offset.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>degrees: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Angle in degrees (zero points in +X direction).<dt>radius: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Radius.</dl><tr><th>Returns<tr><td><dl>The x-distance for the angle and radius.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l169">code &raquo;</a><span class="member"><a name="goog.math.angleDy">goog.math.angleDy</a> <span class="args">( degrees, radius )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>For a given angle and radius, finds the Y portion of the offset.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>degrees: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Angle in degrees (zero points in +X direction).<dt>radius: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Radius.</dl><tr><th>Returns<tr><td><dl>The y-distance for the angle and radius.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l321">code &raquo;</a><span class="member"><a name="goog.math.average">goog.math.average</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the arithmetic mean of the arguments.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Numbers to average.</dl><tr><th>Returns<tr><td><dl>The average of the arguments (<code >NaN</code> if no arguments
+     were provided or any of the arguments is not a valid number).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l55">code &raquo;</a><span class="member"><a name="goog.math.clamp">goog.math.clamp</a> <span class="args">( value, min, max )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Takes a number and clamps it to within the provided bounds.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The input number.<dt>min: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The minimum value to return.<dt>max: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The maximum value to return.</dl><tr><th>Returns<tr><td><dl>The input number if it is within bounds, or the nearest
+     number within the bounds.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l380">code &raquo;</a><span class="member"><a name="goog.math.isFiniteNumber">goog.math.isFiniteNumber</a> <span class="args">( num )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether the supplied number is finite and not NaN.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>num: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to test.</dl><tr><th>Returns<tr><td><dl>Whether <code >num</code> is a finite number.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l370">code &raquo;</a><span class="member"><a name="goog.math.isInt">goog.math.isInt</a> <span class="args">( num )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether the supplied number represents an integer, i.e. that is has
+ no fractional component.  No range-checking is performed on the number.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>num: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to test.</dl><tr><th>Returns<tr><td><dl>Whether <code >num</code> is an integer.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l89">code &raquo;</a><span class="member"><a name="goog.math.lerp">goog.math.lerp</a> <span class="args">( a, b, x )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Performs linear interpolation between values a and b. Returns the value
+ between a and b proportional to x (when x is between 0 and 1. When x is
+ outside this range, the return value is a linear extrapolation).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A number.<dt>b: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A number.<dt>x: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The proportion between a and b.</dl><tr><th>Returns<tr><td><dl>The interpolated value between a and b.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l398">code &raquo;</a><span class="member"><a name="goog.math.log10Floor">goog.math.log10Floor</a> <span class="args">( num )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the precise value of floor(log10(num)).
+ Simpler implementations didn't work because of floating point rounding
+ errors. For example
+ <ul>
+ <li>Math.floor(Math.log(num) / Math.LN10) is off by one for num == 1e+3.
+ <li>Math.floor(Math.log(num) * Math.LOG10E) is off by one for num == 1e+15.
+ <li>Math.floor(Math.log10(num)) is off by one for num == 1e+15 - 1.
+ </ul></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>num: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A floating point number.</dl><tr><th>Returns<tr><td><dl>Its logarithm to base 10 rounded down to the nearest
+     integer if num > 0. -Infinity if num == 0. NaN if num < 0.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l246">code &raquo;</a><span class="member"><a name="goog.math.longestCommonSubsequence">goog.math.longestCommonSubsequence</a> <span class="args">( array1, array2, opt_compareFn, opt_collectorFn )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&gt;</code></span></div><p>JavaScript implementation of Longest Common Subsequence problem.
+ http://en.wikipedia.org/wiki/Longest_common_subsequence
+
+ Returns the longest possible array that is subarray of both of given arrays.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>array1: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&gt;</code><dd>First array of objects.<dt>array2: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>&gt;</code><dd>Second array of objects.<dt>opt_compareFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Function that acts as a custom comparator
+     for the array ojects. Function should return true if objects are equal,
+     otherwise false.<dt>opt_collectorFn: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Function used to decide what to return
+     as a result subsequence. It accepts 2 arguments: index of common element
+     in the first array and index in the second. The default function returns
+     element from the first array.</dl><tr><th>Returns<tr><td><dl>A list of objects that are common to both arrays
+     such that there is no common subsequence with size greater than the
+     length of the list.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l73">code &raquo;</a><span class="member"><a name="goog.math.modulo">goog.math.modulo</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The % operator in JavaScript returns the remainder of a / b, but differs from
+ some other languages in that the result will have the same sign as the
+ dividend. For example, -1 % 8 == -1, whereas in some other languages
+ (such as Python) the result would be 7. This function emulates the more
+ correct modulo behavior, which is useful for certain applications such as
+ calculating an offset index in a circular list.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The dividend.<dt>b: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The divisor.</dl><tr><th>Returns<tr><td><dl>a % b where the result is between 0 and b (either 0 <= x < b
+     or b < x <= 0, depending on the sign of b).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l103">code &raquo;</a><span class="member"><a name="goog.math.nearlyEquals">goog.math.nearlyEquals</a> <span class="args">( a, b, opt_tolerance )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests whether the two values are equal to each other, within a certain
+ tolerance to adjust for floating point errors.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A number.<dt>b: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A number.<dt>opt_tolerance: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional tolerance range. Defaults
+     to 0.000001. If specified, should be greater than 0.</dl><tr><th>Returns<tr><td><dl>Whether <code >a</code> and <code >b</code> are nearly equal.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l30">code &raquo;</a><span class="member"><a name="goog.math.randomInt">goog.math.randomInt</a> <span class="args">( a )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns a random integer greater than or equal to 0 and less than <code >a</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The upper bound for the random integer (exclusive).</dl><tr><th>Returns<tr><td><dl>A random integer N such that 0 <= N < a.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l432">code &raquo;</a><span class="member"><a name="goog.math.safeCeil">goog.math.safeCeil</a> <span class="args">( num, opt_epsilon )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>A tweaked variant of <code >Math.ceil</code>. See <code >goog.math.safeFloor</code> for
+ details.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>num: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A number.<dt>opt_epsilon: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>An infinitesimally small positive number, the
+     rounding error to tolerate.</dl><tr><th>Returns<tr><td><dl>The smallest integer greater than or equal to <code >num</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l418">code &raquo;</a><span class="member"><a name="goog.math.safeFloor">goog.math.safeFloor</a> <span class="args">( num, opt_epsilon )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>A tweaked variant of <code >Math.floor</code> which tolerates if the passed number
+ is infinitesimally smaller than the closest integer. It often happens with
+ the results of floating point calculations because of the finite precision
+ of the intermediate results. For example <code >Math.floor(Math.log(1000) /
+ Math.LN10) == 2</code>, not 3 as one would expect.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>num: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A number.<dt>opt_epsilon: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>An infinitesimally small positive number, the
+     rounding error to tolerate.</dl><tr><th>Returns<tr><td><dl>The largest integer less than or equal to <code >num</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l334">code &raquo;</a><span class="member"><a name="goog.math.sampleVariance">goog.math.sampleVariance</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the unbiased sample variance of the arguments. For a definition,
+ see e.g. http://en.wikipedia.org/wiki/Variance</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Number samples to analyze.</dl><tr><th>Returns<tr><td><dl>The unbiased sample variance of the arguments (0 if fewer
+     than two samples were provided, or <code >NaN</code> if any of the samples is
+     not a valid number).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l222">code &raquo;</a><span class="member"><a name="goog.math.sign">goog.math.sign</a> <span class="args">( x )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the sign of a number as per the "sign" or "signum" function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>x: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to take the sign of.</dl><tr><th>Returns<tr><td><dl>-1 when negative, 1 when positive, 0 when 0.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l116">code &raquo;</a><span class="member"><a name="goog.math.standardAngle">goog.math.standardAngle</a> <span class="args">( angle )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Normalizes an angle to be in range [0-360). Angles outside this range will
+ be normalized to be the equivalent angle with that range.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>angle: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Angle in degrees.</dl><tr><th>Returns<tr><td><dl>Standardized angle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l127">code &raquo;</a><span class="member"><a name="goog.math.standardAngleInRadians">goog.math.standardAngleInRadians</a> <span class="args">( angle )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Normalizes an angle to be in range [0-2*PI). Angles outside this range will
+ be normalized to be the equivalent angle with that range.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>angle: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Angle in radians.</dl><tr><th>Returns<tr><td><dl>Standardized angle.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l359">code &raquo;</a><span class="member"><a name="goog.math.standardDeviation">goog.math.standardDeviation</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the sample standard deviation of the arguments.  For a definition of
+ sample standard deviation, see e.g.
+ http://en.wikipedia.org/wiki/Standard_deviation</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Number samples to analyze.</dl><tr><th>Returns<tr><td><dl>The sample standard deviation of the arguments (0 if fewer
+     than two samples were provided, or <code >NaN</code> if any of the samples is
+     not a valid number).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l307">code &raquo;</a><span class="member"><a name="goog.math.sum">goog.math.sum</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the sum of the arguments.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Numbers to add.</dl><tr><th>Returns<tr><td><dl>The sum of the arguments (0 if no arguments were provided,
+     <code >NaN</code> if any of the arguments is not a valid number).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l147">code &raquo;</a><span class="member"><a name="goog.math.toDegrees">goog.math.toDegrees</a> <span class="args">( angleRadians )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Converts radians to degrees.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>angleRadians: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Angle in radians.</dl><tr><th>Returns<tr><td><dl>Angle in degrees.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l137">code &raquo;</a><span class="member"><a name="goog.math.toRadians">goog.math.toRadians</a> <span class="args">( angleDegrees )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Converts degrees to radians.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>angleDegrees: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Angle in degrees.</dl><tr><th>Returns<tr><td><dl>Angle in radians.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/math/math.js.src.html#l42">code &raquo;</a><span class="member"><a name="goog.math.uniformRandom">goog.math.uniformRandom</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns a random number greater than or equal to <code >a</code> and less than
+ <code >b</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The lower bound for the random number (inclusive).<dt>b: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The upper bound for the random number (exclusive).</dl><tr><th>Returns<tr><td><dl>A random number N such that a <= N < b.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_net.html b/docs/namespace_goog_net.html
index 0cc40e8..8079e41 100644
--- a/docs/namespace_goog_net.html
+++ b/docs/namespace_goog_net.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.net</h1><a class="source" href="source/lib/goog/net/xmlhttpfactory.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_net_DefaultXmlHttpFactory.html">goog.net.DefaultXmlHttpFactory</a><dd>Default factory to use when creating xhr objects.<dt><a href="class_goog_net_WrapperXmlHttpFactory.html">goog.net.WrapperXmlHttpFactory</a><dd>An xhr factory subclass which can be constructed using two factory methods.<dt><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a><dd>Abstract base class for an XmlHttpRequest factory.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l34">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp">goog.net.XmlHttp</a> <span class="args">( )</span> &rArr; <code class="type">!(<a href="http://www.w3.org/TR/XMLHttpRequest/#xmlhttprequest-object">XMLHttpRequest</a>|GearsHttpRequest)</code></span></div><p>Static class for creating XMLHttpRequest objects.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new XMLHttpRequest object.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.net</h1><a class="source" href="source/lib/goog/net/xhrlike.js.src.html#l15">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_goog_net_XhrLike.html">goog.net.XhrLike</a><dd>Interface for the common parts of XMLHttpRequest.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_net_DefaultXmlHttpFactory.html">goog.net.DefaultXmlHttpFactory</a><dd>Default factory to use when creating xhr objects.<dt><a href="class_goog_net_WrapperXmlHttpFactory.html">goog.net.WrapperXmlHttpFactory</a><dd>An xhr factory subclass which can be constructed using two factory methods.<dt><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a><dd>Abstract base class for an XmlHttpRequest factory.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l36">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp">goog.net.XmlHttp</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="interface_goog_net_XhrLike.html#goog.net.XhrLike.OrNative">goog.net.XhrLike.OrNative</a></code></span></div><p>Static class for creating XMLHttpRequest objects.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new XMLHttpRequest object.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_net_XmlHttp.html b/docs/namespace_goog_net_XmlHttp.html
index d9cce79..6d28fc5 100644
--- a/docs/namespace_goog_net_XmlHttp.html
+++ b/docs/namespace_goog_net_XmlHttp.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttp</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.net.XmlHttp</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l34">code &raquo;</a></header><section><p>Static class for creating XMLHttpRequest objects.<h2>Main</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">XmlHttp <span class="args">( )</span> &rArr; <code class="type">!(<a href="http://www.w3.org/TR/XMLHttpRequest/#xmlhttprequest-object">XMLHttpRequest</a>|GearsHttpRequest)</code></span></div><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new XMLHttpRequest object.</dl></table></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_net_XmlHttp_OptionType.html">goog.net.XmlHttp.OptionType</a><dd>Type of options that an XmlHttp object can have.<dt><a href="enum_goog_net_XmlHttp_ReadyState.html">goog.net.XmlHttp.ReadyState</a><dd>Status constants for XMLHTTP, matches:
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttp</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.net.XmlHttp</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l36">code &raquo;</a></header><section><p>Static class for creating XMLHttpRequest objects.<h2>Main</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">XmlHttp <span class="args">( )</span> &rArr; <code class="type">!<a href="interface_goog_net_XhrLike.html#goog.net.XhrLike.OrNative">goog.net.XhrLike.OrNative</a></code></span></div><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A new XMLHttpRequest object.</dl></table></div></div></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_net_XmlHttp_OptionType.html">goog.net.XmlHttp.OptionType</a><dd>Type of options that an XmlHttp object can have.<dt><a href="enum_goog_net_XmlHttp_ReadyState.html">goog.net.XmlHttp.ReadyState</a><dd>Status constants for XMLHTTP, matches:
  http://msdn.microsoft.com/library/default.asp?url=/library/
-   en-us/xmlsdk/html/0e6a34e4-f90c-489d-acff-cb44242fafc6.asp</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l51">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp.getOptions">goog.net.XmlHttp.getOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Gets the options to use with the XMLHttpRequest objects obtained using
- the static methods.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The options.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l124">code &raquo;</a><span class="member deprecation-notice"><a name="goog.net.XmlHttp.setFactory">goog.net.XmlHttp.setFactory</a> <span class="args">( factory, optionsFactory )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use setGlobalFactory instead.</span></div><p>Sets the factories for creating XMLHttpRequest objects and their options.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>factory: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The factory for XMLHttpRequest objects.<dt>optionsFactory: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The factory for options.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l135">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp.setGlobalFactory">goog.net.XmlHttp.setGlobalFactory</a> <span class="args">( factory )</span></span></div><p>Sets the global factory object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>factory: <code class="type">!<a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code><dd>New global factory object.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l115">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp.factory_">goog.net.XmlHttp.factory_</a> : <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></span></div><p>The global factory instance for creating XMLHttpRequest objects.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l43">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp.ASSUME_NATIVE_XHR">goog.net.XmlHttp.ASSUME_NATIVE_XHR</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+   en-us/xmlsdk/html/0e6a34e4-f90c-489d-acff-cb44242fafc6.asp</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l68">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp.getOptions">goog.net.XmlHttp.getOptions</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Gets the options to use with the XMLHttpRequest objects obtained using
+ the static methods.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The options.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l141">code &raquo;</a><span class="member deprecation-notice"><a name="goog.net.XmlHttp.setFactory">goog.net.XmlHttp.setFactory</a> <span class="args">( factory, optionsFactory )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use setGlobalFactory instead.</span></div><p>Sets the factories for creating XMLHttpRequest objects and their options.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>factory: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The factory for XMLHttpRequest objects.<dt>optionsFactory: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The factory for options.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l152">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp.setGlobalFactory">goog.net.XmlHttp.setGlobalFactory</a> <span class="args">( factory )</span></span></div><p>Sets the global factory object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>factory: <code class="type">!<a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code><dd>New global factory object.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l132">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp.factory_">goog.net.XmlHttp.factory_</a> : <code class="type"><a href="class_goog_net_XmlHttpFactory.html">goog.net.XmlHttpFactory</a></code></span></div><p>The global factory instance for creating XMLHttpRequest objects.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l49">code &raquo;</a><span class="member"><a name="goog.net.XmlHttp.ASSUME_NATIVE_XHR">goog.net.XmlHttp.ASSUME_NATIVE_XHR</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_net_XmlHttpDefines.html b/docs/namespace_goog_net_XmlHttpDefines.html
new file mode 100644
index 0000000..18c999c
--- /dev/null
+++ b/docs/namespace_goog_net_XmlHttpDefines.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.net.XmlHttpDefines</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.net.XmlHttpDefines</h1><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l53">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/net/xmlhttp.js.src.html#l60">code &raquo;</a><span class="member"><a name="goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR">goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_object.html b/docs/namespace_goog_object.html
index 8bf0a43..c9af760 100644
--- a/docs/namespace_goog_object.html
+++ b/docs/namespace_goog_object.html
@@ -1,70 +1,72 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.object</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.object</h1><a class="source" href="source/lib/goog/object/object.js.src.html#l19">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l383">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.add">goog.object.add</a> <span class="args">( obj, key, val )</span></span></div><p>Adds a key-value pair to the object. Throws an exception if the key is
- already in use. Use set if you want to change an existing pair.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to which to add the key-value pair.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to add.<dt>val: <code class="type">V</code><dd>The value to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l351">code &raquo;</a><span class="member"><a name="goog.object.clear">goog.object.clear</a> <span class="args">( obj )</span></span></div><p>Removes all key value pairs from the object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to clear.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l443">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.clone">goog.object.clone</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code></span></div><p>Does a flat clone of the object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>Object to clone.</dl><tr><th>Returns<tr><td><dl>Clone of the input object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l196">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.contains">goog.object.contains</a> <span class="args">( obj, val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object/hash/map contains the given object as a value.
- An alias for goog.object.containsValue(obj, val).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object in which to look for val.<dt>val: <code class="type">V</code><dd>The object for which to check.</dl><tr><th>Returns<tr><td><dl>true if val is present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l269">code &raquo;</a><span class="member"><a name="goog.object.containsKey">goog.object.containsKey</a> <span class="args">( obj, key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object/map/hash contains the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object in which to look for key.<dt>key: <code class="type">*</code><dd>The key for which to check.</dl><tr><th>Returns<tr><td><dl>true If the map contains the key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l282">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.containsValue">goog.object.containsValue</a> <span class="args">( obj, val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object/map/hash contains the given value. This is O(n).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object in which to look for val.<dt>val: <code class="type">V</code><dd>The value for which to check.</dl><tr><th>Returns<tr><td><dl>true If the map contains the value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l567">code &raquo;</a><span class="member"><a name="goog.object.create">goog.object.create</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Creates a new object built from the key-value pairs provided as arguments.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...*</code><dd>If only one argument is provided and it is an array
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.object</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.object</h1><a class="source" href="source/lib/goog/object/object.js.src.html#l19">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l385">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.add">goog.object.add</a> <span class="args">( obj, key, val )</span></span></div><p>Adds a key-value pair to the object. Throws an exception if the key is
+ already in use. Use set if you want to change an existing pair.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to which to add the key-value pair.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to add.<dt>val: <code class="type">V</code><dd>The value to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l353">code &raquo;</a><span class="member"><a name="goog.object.clear">goog.object.clear</a> <span class="args">( obj )</span></span></div><p>Removes all key value pairs from the object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to clear.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l466">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.clone">goog.object.clone</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code></span></div><p>Does a flat clone of the object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>Object to clone.</dl><tr><th>Returns<tr><td><dl>Clone of the input object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l198">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.contains">goog.object.contains</a> <span class="args">( obj, val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object/hash/map contains the given object as a value.
+ An alias for goog.object.containsValue(obj, val).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object in which to look for val.<dt>val: <code class="type">V</code><dd>The object for which to check.</dl><tr><th>Returns<tr><td><dl>true if val is present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l271">code &raquo;</a><span class="member"><a name="goog.object.containsKey">goog.object.containsKey</a> <span class="args">( obj, key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object/map/hash contains the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object in which to look for key.<dt>key: <code class="type">*</code><dd>The key for which to check.</dl><tr><th>Returns<tr><td><dl>true If the map contains the key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l284">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.containsValue">goog.object.containsValue</a> <span class="args">( obj, val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object/map/hash contains the given value. This is O(n).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object in which to look for val.<dt>val: <code class="type">V</code><dd>The value for which to check.</dl><tr><th>Returns<tr><td><dl>true If the map contains the value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l592">code &raquo;</a><span class="member"><a name="goog.object.create">goog.object.create</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Creates a new object built from the key-value pairs provided as arguments.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...*</code><dd>If only one argument is provided and it is an array
      then this is used as the arguments,  otherwise even arguments are used as
      the property names and odd arguments are used as the property values.</dl><tr><th>Returns<tr><td><dl>The new object.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If there are uneven number of arguments or there is only one
-     non array argument.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l619">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.createImmutableView">goog.object.createImmutableView</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code></span></div><p>Creates an immutable view of the underlying object, if the browser
+     non array argument.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l644">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.createImmutableView">goog.object.createImmutableView</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code></span></div><p>Creates an immutable view of the underlying object, if the browser
  supports immutable objects.
 
  In default mode, writes to this view will fail silently. In strict mode,
  they will throw an error.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>An object.</dl><tr><th>Returns<tr><td><dl>An immutable view of that object, or the
-     original object if this browser does not support immutables.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l593">code &raquo;</a><span class="member"><a name="goog.object.createSet">goog.object.createSet</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Creates a new object where the property names come from the arguments but
+     original object if this browser does not support immutables.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l618">code &raquo;</a><span class="member"><a name="goog.object.createSet">goog.object.createSet</a> <span class="args">( var_args )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Creates a new object where the property names come from the arguments but
  the value is always set to true</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...*</code><dd>If only one argument is provided and it is an array
      then this is used as the arguments,  otherwise the arguments are used
-     as the property names.</dl><tr><th>Returns<tr><td><dl>The new object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l127">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.every">goog.object.every</a> <span class="args">( obj, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls a function for each element in an object/map/hash. If
+     as the property names.</dl><tr><th>Returns<tr><td><dl>The new object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l446">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.equals">goog.object.equals</a> <span class="args">( a, b )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares two objects for equality using === on the values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a<dt>b</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l129">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.every">goog.object.every</a> <span class="args">( obj, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls a function for each element in an object/map/hash. If
  all calls return true, returns true. If any call returns false, returns
  false at this point and does not continue to check the remaining elements.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to check.<dt>f: <code class="type">?function(this: T, V, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to
      call for every element. This function
      takes 3 arguments (the element, the index and the object) and should
-     return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl><tr><th>Returns<tr><td><dl>false if any element fails the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l534">code &raquo;</a><span class="member"><a name="goog.object.extend">goog.object.extend</a> <span class="args">( target, var_args )</span></span></div><p>Extends an object with another object.
+     return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl><tr><th>Returns<tr><td><dl>false if any element fails the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l559">code &raquo;</a><span class="member"><a name="goog.object.extend">goog.object.extend</a> <span class="args">( target, var_args )</span></span></div><p>Extends an object with another object.
  This operates 'in-place'; it does not create a new Object.
 
  Example:
  var o = {};
  goog.object.extend(o, {a: 0, b: 1});
  o; // {a: 0, b: 1}
- goog.object.extend(o, {c: 2});
- o; // {a: 0, b: 1, c: 2}</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to modify.<dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The objects from which values will be copied.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l55">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.filter">goog.object.filter</a> <span class="args">( obj, f, opt_obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code></span></div><p>Calls a function for each element in an object/map/hash. If that call returns
+ goog.object.extend(o, {b: 2, c: 3});
+ o; // {a: 0, b: 2, c: 3}</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to modify. Existing properties will be
+     overwritten if they are also present in one of the objects in
+     <code >var_args</code>.<dt>var_args: <code class="type">...<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The objects from which values will be copied.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l57">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.filter">goog.object.filter</a> <span class="args">( obj, f, opt_obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code></span></div><p>Calls a function for each element in an object/map/hash. If that call returns
  true, adds the element to a new object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object over which to iterate.<dt>f: <code class="type">function(this: T, V, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call
      for every element. This
      function takes 3 arguments (the element, the index and the object)
      and should return a boolean. If the return value is true the
      element is added to the result object. If it is false the
      element is not included.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl><tr><th>Returns<tr><td><dl>a new object in which only elements that passed the
-     test are present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l304">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.findKey">goog.object.findKey</a> <span class="args">( obj, f, opt_this )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Searches an object for an element that satisfies the given condition and
+     test are present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l306">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.findKey">goog.object.findKey</a> <span class="args">( obj, f, opt_this )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Searches an object for an element that satisfies the given condition and
  returns its key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to search in.<dt>f: <code class="type">function(this: T, V, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The
       function to call for every element. Takes 3 arguments (the value,
      the key and the object) and should return a boolean.<dt>opt_this: <code class="type">T=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>The key of an element for which the function
-     returns true or undefined if no such element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l326">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.findValue">goog.object.findValue</a> <span class="args">( obj, f, opt_this )</span> &rArr; <code class="type">V</code></span></div><p>Searches an object for an element that satisfies the given condition and
+     returns true or undefined if no such element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l328">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.findValue">goog.object.findValue</a> <span class="args">( obj, f, opt_this )</span> &rArr; <code class="type">V</code></span></div><p>Searches an object for an element that satisfies the given condition and
  returns its value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to search in.<dt>f: <code class="type">function(this: T, V, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function
      to call for every element. Takes 3 arguments (the value, the key
      and the object) and should return a boolean.<dt>opt_this: <code class="type">T=</code><dd>An optional "this" context for the function.</dl><tr><th>Returns<tr><td><dl>The value of an element for which the function returns true or
-     undefined if no such element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l32">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.forEach">goog.object.forEach</a> <span class="args">( obj, f, opt_obj )</span></span></div><p>Calls a function for each element in an object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object over which to iterate.<dt>f: <code class="type">function(this: T, V, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;): ?</code><dd>The function to call
+     undefined if no such element is found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l34">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.forEach">goog.object.forEach</a> <span class="args">( obj, f, opt_obj )</span></span></div><p>Calls a function for each element in an object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object over which to iterate.<dt>f: <code class="type">function(this: T, V, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;): ?</code><dd>The function to call
      for every element. This function takes 3 arguments (the element, the
-     index and the object) and the return value is ignored.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l401">code &raquo;</a><code class="type">&lt;K, V, R&gt;</code> <span class="member"><a name="goog.object.get">goog.object.get</a> <span class="args">( obj, key, opt_val )</span> &rArr; <code class="type">(V|R|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns the value for the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object from which to get the value.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key for which to get the value.<dt>opt_val: <code class="type">R=</code><dd>The value to return if no item is found for the given
-     key (default is undefined).</dl><tr><th>Returns<tr><td><dl>The value for the given key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l164">code &raquo;</a><span class="member"><a name="goog.object.getAnyKey">goog.object.getAnyKey</a> <span class="args">( obj )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns one key from the object map, if any exists.
+     index and the object) and the return value is ignored.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l403">code &raquo;</a><code class="type">&lt;K, V, R&gt;</code> <span class="member"><a name="goog.object.get">goog.object.get</a> <span class="args">( obj, key, opt_val )</span> &rArr; <code class="type">(V|R|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns the value for the given key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object from which to get the value.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key for which to get the value.<dt>opt_val: <code class="type">R=</code><dd>The value to return if no item is found for the given
+     key (default is undefined).</dl><tr><th>Returns<tr><td><dl>The value for the given key.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l166">code &raquo;</a><span class="member"><a name="goog.object.getAnyKey">goog.object.getAnyKey</a> <span class="args">( obj )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns one key from the object map, if any exists.
  For map literals the returned key will be the first one in most of the
- browsers (a know exception is Konqueror).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to pick a key from.</dl><tr><th>Returns<tr><td><dl>The key or undefined if the object is empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l180">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.getAnyValue">goog.object.getAnyValue</a> <span class="args">( obj )</span> &rArr; <code class="type">(V|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns one value from the object map, if any exists.
+ browsers (a know exception is Konqueror).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to pick a key from.</dl><tr><th>Returns<tr><td><dl>The key or undefined if the object is empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l182">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.getAnyValue">goog.object.getAnyValue</a> <span class="args">( obj )</span> &rArr; <code class="type">(V|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns one value from the object map, if any exists.
  For map literals the returned value will be the first one in most of the
- browsers (a know exception is Konqueror).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to pick a value from.</dl><tr><th>Returns<tr><td><dl>The value or undefined if the object is empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l144">code &raquo;</a><span class="member"><a name="goog.object.getCount">goog.object.getCount</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of key-value pairs in the object map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object for which to get the number of key-value
-     pairs.</dl><tr><th>Returns<tr><td><dl>The number of key-value pairs in the object map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l224">code &raquo;</a><span class="member"><a name="goog.object.getKeys">goog.object.getKeys</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns the keys of the object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object from which to get the keys.</dl><tr><th>Returns<tr><td><dl>Array of property keys.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l246">code &raquo;</a><span class="member"><a name="goog.object.getValueByKeys">goog.object.getValueByKeys</a> <span class="args">( obj, var_args )</span> &rArr; <code class="type">*</code></span></div><p>Get a value from an object multiple levels deep.  This is useful for
+ browsers (a know exception is Konqueror).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to pick a value from.</dl><tr><th>Returns<tr><td><dl>The value or undefined if the object is empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l146">code &raquo;</a><span class="member"><a name="goog.object.getCount">goog.object.getCount</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of key-value pairs in the object map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object for which to get the number of key-value
+     pairs.</dl><tr><th>Returns<tr><td><dl>The number of key-value pairs in the object map.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l226">code &raquo;</a><span class="member"><a name="goog.object.getKeys">goog.object.getKeys</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Returns the keys of the object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object from which to get the keys.</dl><tr><th>Returns<tr><td><dl>Array of property keys.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l248">code &raquo;</a><span class="member"><a name="goog.object.getValueByKeys">goog.object.getValueByKeys</a> <span class="args">( obj, var_args )</span> &rArr; <code class="type">*</code></span></div><p>Get a value from an object multiple levels deep.  This is useful for
  pulling values from deeply nested objects, such as JSON responses.
  Example usage: getValueByKeys(jsonObj, 'foo', 'entries', 3)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>An object to get the value from.  Can be array-like.<dt>var_args: <code class="type">...(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code><dd>A number of keys
      (as strings, or numbers, for array-like objects).  Can also be
      specified as a single array of keys.</dl><tr><th>Returns<tr><td><dl>The resulting value.  If, at any point, the value for a key
-     is undefined, returns undefined.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l208">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.getValues">goog.object.getValues</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;V&gt;</code></span></div><p>Returns the values of the object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object from which to get the values.</dl><tr><th>Returns<tr><td><dl>The values in the object/map/hash.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l338">code &raquo;</a><span class="member"><a name="goog.object.isEmpty">goog.object.isEmpty</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object/map/hash is empty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to test.</dl><tr><th>Returns<tr><td><dl>true if obj is empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l633">code &raquo;</a><span class="member"><a name="goog.object.isImmutableView">goog.object.isImmutableView</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>An object.</dl><tr><th>Returns<tr><td><dl>Whether this is an immutable view of the object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l80">code &raquo;</a><code class="type">&lt;T, K, V, R&gt;</code> <span class="member"><a name="goog.object.map">goog.object.map</a> <span class="args">( obj, f, opt_obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, R&gt;</code></span></div><p>For every element in an object/map/hash calls a function and inserts the
+     is undefined, returns undefined.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l210">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.getValues">goog.object.getValues</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;V&gt;</code></span></div><p>Returns the values of the object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object from which to get the values.</dl><tr><th>Returns<tr><td><dl>The values in the object/map/hash.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l340">code &raquo;</a><span class="member"><a name="goog.object.isEmpty">goog.object.isEmpty</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the object/map/hash is empty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to test.</dl><tr><th>Returns<tr><td><dl>true if obj is empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l658">code &raquo;</a><span class="member"><a name="goog.object.isImmutableView">goog.object.isImmutableView</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>An object.</dl><tr><th>Returns<tr><td><dl>Whether this is an immutable view of the object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l82">code &raquo;</a><code class="type">&lt;T, K, V, R&gt;</code> <span class="member"><a name="goog.object.map">goog.object.map</a> <span class="args">( obj, f, opt_obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, R&gt;</code></span></div><p>For every element in an object/map/hash calls a function and inserts the
  result into a new object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object over which to iterate.<dt>f: <code class="type">function(this: T, V, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;): R</code><dd>The function to call
      for every element. This function
      takes 3 arguments (the element, the index and the object)
      and should return something. The result will be inserted
-     into a new object.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl><tr><th>Returns<tr><td><dl>a new object with the results from f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l365">code &raquo;</a><span class="member"><a name="goog.object.remove">goog.object.remove</a> <span class="args">( obj, key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes a key-value pair based on the key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object from which to remove the key.<dt>key: <code class="type">*</code><dd>The key to remove.</dl><tr><th>Returns<tr><td><dl>Whether an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l417">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.set">goog.object.set</a> <span class="args">( obj, key, value )</span></span></div><p>Adds a key-value pair to the object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to which to add the key-value pair.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to add.<dt>value: <code class="type">V</code><dd>The value to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l431">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.setIfUndefined">goog.object.setIfUndefined</a> <span class="args">( obj, key, value )</span> &rArr; <code class="type">V</code></span></div><p>Adds a key-value pair to the object/map/hash if it doesn't exist yet.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to which to add the key-value pair.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to add.<dt>value: <code class="type">V</code><dd>The value to add if the key wasn't present.</dl><tr><th>Returns<tr><td><dl>The value of the entry at the end of the function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l103">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.some">goog.object.some</a> <span class="args">( obj, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls a function for each element in an object/map/hash. If any
+     into a new object.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl><tr><th>Returns<tr><td><dl>a new object with the results from f.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l367">code &raquo;</a><span class="member"><a name="goog.object.remove">goog.object.remove</a> <span class="args">( obj, key )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Removes a key-value pair based on the key.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object from which to remove the key.<dt>key: <code class="type">*</code><dd>The key to remove.</dl><tr><th>Returns<tr><td><dl>Whether an element was removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l419">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.set">goog.object.set</a> <span class="args">( obj, key, value )</span></span></div><p>Adds a key-value pair to the object/map/hash.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to which to add the key-value pair.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to add.<dt>value: <code class="type">V</code><dd>The value to add.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l433">code &raquo;</a><code class="type">&lt;K, V&gt;</code> <span class="member"><a name="goog.object.setIfUndefined">goog.object.setIfUndefined</a> <span class="args">( obj, key, value )</span> &rArr; <code class="type">V</code></span></div><p>Adds a key-value pair to the object/map/hash if it doesn't exist yet.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to which to add the key-value pair.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key to add.<dt>value: <code class="type">V</code><dd>The value to add if the key wasn't present.</dl><tr><th>Returns<tr><td><dl>The value of the entry at the end of the function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l105">code &raquo;</a><code class="type">&lt;T, K, V&gt;</code> <span class="member"><a name="goog.object.some">goog.object.some</a> <span class="args">( obj, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls a function for each element in an object/map/hash. If any
  call returns true, returns true (without checking the rest). If
  all calls return false, returns false.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;</code><dd>The object to check.<dt>f: <code class="type">function(this: T, V, ?, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;K, V&gt;): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to
      call for every element. This function
      takes 3 arguments (the element, the index and the object) and should
-     return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl><tr><th>Returns<tr><td><dl>true if any element passes the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l495">code &raquo;</a><span class="member"><a name="goog.object.transpose">goog.object.transpose</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Returns a new object in which all the keys and values are interchanged
+     return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>This is used as the 'this' object within f.</dl><tr><th>Returns<tr><td><dl>true if any element passes the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l518">code &raquo;</a><span class="member"><a name="goog.object.transpose">goog.object.transpose</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Returns a new object in which all the keys and values are interchanged
  (keys become values and values become keys). If multiple keys map to the
- same value, the chosen transposed value is implementation-dependent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to transpose.</dl><tr><th>Returns<tr><td><dl>The transposed object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l470">code &raquo;</a><span class="member"><a name="goog.object.unsafeClone">goog.object.unsafeClone</a> <span class="args">( obj )</span> &rArr; <code class="type">*</code></span></div><p>Clones a value. The input may be an Object, Array, or basic type. Objects and
+ same value, the chosen transposed value is implementation-dependent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to transpose.</dl><tr><th>Returns<tr><td><dl>The transposed object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l493">code &raquo;</a><span class="member"><a name="goog.object.unsafeClone">goog.object.unsafeClone</a> <span class="args">( obj )</span> &rArr; <code class="type">*</code></span></div><p>Clones a value. The input may be an Object, Array, or basic type. Objects and
  arrays will be cloned recursively.
 
  WARNINGS:
@@ -72,4 +74,4 @@
  that refer to themselves will cause infinite recursion.
 
  <code>goog.object.unsafeClone</code> is unaware of unique identifiers, and
- copies UIDs created by <code>getUid</code> into cloned results.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The value to clone.</dl><tr><th>Returns<tr><td><dl>A clone of the input value.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l509">code &raquo;</a><span class="member"><a name="goog.object.PROTOTYPE_FIELDS_">goog.object.PROTOTYPE_FIELDS_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>The names of the fields that are defined on Object.prototype.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ copies UIDs created by <code>getUid</code> into cloned results.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The value to clone.</dl><tr><th>Returns<tr><td><dl>A clone of the input value.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/object/object.js.src.html#l532">code &raquo;</a><span class="member"><a name="goog.object.PROTOTYPE_FIELDS_">goog.object.PROTOTYPE_FIELDS_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>The names of the fields that are defined on Object.prototype.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_reflect.html b/docs/namespace_goog_reflect.html
new file mode 100644
index 0000000..68871f5
--- /dev/null
+++ b/docs/namespace_goog_reflect.html
@@ -0,0 +1,7 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.reflect</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.reflect</h1><a class="source" href="source/lib/goog/reflect/reflect.js.src.html#l20">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/reflect/reflect.js.src.html#l70">code &raquo;</a><span class="member"><a name="goog.reflect.canAccessProperty">goog.reflect.canAccessProperty</a> <span class="args">( obj, prop )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Check if a property can be accessed without throwing an exception.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The owner of the property.<dt>prop: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The property name.</dl><tr><th>Returns<tr><td><dl>Whether the property is accessible. Will also return true
+     if obj is null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/reflect/reflect.js.src.html#l36">code &raquo;</a><span class="member"><a name="goog.reflect.object">goog.reflect.object</a> <span class="args">( type, object )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Syntax for object literal casts.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>Type to cast to.<dt>object: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Object literal to cast.</dl><tr><th>Returns<tr><td><dl>The object literal.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/reflect/reflect.js.src.html#l50">code &raquo;</a><span class="member"><a name="goog.reflect.sinkValue">goog.reflect.sinkValue</a> <span class="args">( )</span></span></div><p>To assert to the compiler that an operation is needed when it would
+ otherwise be stripped. For example:
+ <code>
+     // Force a layout
+     goog.reflect.sinkValue(dialog.offsetHeight);
+ </code></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_string.html b/docs/namespace_goog_string.html
index e4d7474..e4ace34 100644
--- a/docs/namespace_goog_string.html
+++ b/docs/namespace_goog_string.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.string</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.string</h1><a class="source" href="source/lib/goog/string/string.js.src.html#l23">code &raquo;</a></header><section></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_string_Unicode.html">goog.string.Unicode</a><dd>Common Unicode string characters.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1041">code &raquo;</a><span class="member"><a name="goog.string.buildString">goog.string.buildString</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Concatenates string expressions. This is useful
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.string</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.string</h1><a class="source" href="source/lib/goog/string/string.js.src.html#l23">code &raquo;</a></header><section></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_string_Unicode.html">goog.string.Unicode</a><dd>Common Unicode string characters.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1121">code &raquo;</a><span class="member"><a name="goog.string.buildString">goog.string.buildString</a> <span class="args">( var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Concatenates string expressions. This is useful
  since some browsers are very inefficient when it comes to using plus to
  concat strings. Be careful when using null and undefined here since
  these will not be included in the result. If you need to represent these
@@ -7,39 +7,43 @@
  <pre>buildString('a', 'b', 'c', 'd') -> 'abcd'
  buildString(null, undefined) -> ''
  </pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var_args: <code class="type">...*</code><dd>A list of strings to concatenate. If not a string,
-     it will be casted to one.</dl><tr><th>Returns<tr><td><dl>The concatenation of <code >var_args</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l239">code &raquo;</a><span class="member"><a name="goog.string.canonicalizeNewlines">goog.string.canonicalizeNewlines</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Replaces Windows and Mac new lines with unix style: \r or \r\n with \n.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to in which to canonicalize newlines.</dl><tr><th>Returns<tr><td><dl><code >str</code> A copy of {@code} with canonicalized newlines.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l329">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveCompare">goog.string.caseInsensitiveCompare</a> <span class="args">( str1, str2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>A string comparator that ignores case.
+     it will be casted to one.</dl><tr><th>Returns<tr><td><dl>The concatenation of <code >var_args</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l246">code &raquo;</a><span class="member"><a name="goog.string.canonicalizeNewlines">goog.string.canonicalizeNewlines</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Replaces Windows and Mac new lines with unix style: \r or \r\n with \n.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to in which to canonicalize newlines.</dl><tr><th>Returns<tr><td><dl><code >str</code> A copy of {@code} with canonicalized newlines.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l336">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveCompare">goog.string.caseInsensitiveCompare</a> <span class="args">( str1, str2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>A string comparator that ignores case.
  -1 = str1 less than str2
   0 = str1 equals str2
-  1 = str1 greater than str2</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to compare.<dt>str2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to compare <code >str1</code> to.</dl><tr><th>Returns<tr><td><dl>The comparator result, as described above.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l79">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveEndsWith">goog.string.caseInsensitiveEndsWith</a> <span class="args">( str, suffix )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Case-insensitive suffix-checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.<dt>suffix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string to look for at the end of <code >str</code>.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> ends with <code >suffix</code> (ignoring
-     case).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l92">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveEquals">goog.string.caseInsensitiveEquals</a> <span class="args">( str1, str2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Case-insensitive equality checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>First string to check.<dt>str2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Second string to check.</dl><tr><th>Returns<tr><td><dl>True if <code >str1</code> and <code >str2</code> are the same string,
-     ignoring case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l66">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveStartsWith">goog.string.caseInsensitiveStartsWith</a> <span class="args">( str, prefix )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Case-insensitive prefix-checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.<dt>prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string to look for at the end of <code >str</code>.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> begins with <code >prefix</code> (ignoring
-     case).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l274">code &raquo;</a><span class="member"><a name="goog.string.collapseBreakingSpaces">goog.string.collapseBreakingSpaces</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes the breaking spaces from the left and right of the string and
+  1 = str1 greater than str2</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to compare.<dt>str2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to compare <code >str1</code> to.</dl><tr><th>Returns<tr><td><dl>The comparator result, as described above.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l985">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveContains">goog.string.caseInsensitiveContains</a> <span class="args">( str, subString )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines whether a string contains a substring, ignoring case.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to search.<dt>subString: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The substring to search for.</dl><tr><th>Returns<tr><td><dl>Whether <code >str</code> contains <code >subString</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l86">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveEndsWith">goog.string.caseInsensitiveEndsWith</a> <span class="args">( str, suffix )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Case-insensitive suffix-checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.<dt>suffix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string to look for at the end of <code >str</code>.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> ends with <code >suffix</code> (ignoring
+     case).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l99">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveEquals">goog.string.caseInsensitiveEquals</a> <span class="args">( str1, str2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Case-insensitive equality checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>First string to check.<dt>str2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Second string to check.</dl><tr><th>Returns<tr><td><dl>True if <code >str1</code> and <code >str2</code> are the same string,
+     ignoring case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l73">code &raquo;</a><span class="member"><a name="goog.string.caseInsensitiveStartsWith">goog.string.caseInsensitiveStartsWith</a> <span class="args">( str, prefix )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Case-insensitive prefix-checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.<dt>prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string to look for at the end of <code >str</code>.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> begins with <code >prefix</code> (ignoring
+     case).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l281">code &raquo;</a><span class="member"><a name="goog.string.collapseBreakingSpaces">goog.string.collapseBreakingSpaces</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes the breaking spaces from the left and right of the string and
  collapses the sequences of breaking spaces in the middle into single spaces.
- The original and the result strings render the same way in HTML.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string in which to collapse spaces.</dl><tr><th>Returns<tr><td><dl>Copy of the string with normalized breaking spaces.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l127">code &raquo;</a><span class="member"><a name="goog.string.collapseWhitespace">goog.string.collapseWhitespace</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts multiple whitespace chars (spaces, non-breaking-spaces, new lines
- and tabs) to a single space, and strips leading and trailing whitespace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Input string.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> with collapsed whitespace.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1130">code &raquo;</a><span class="member"><a name="goog.string.compareElements_">goog.string.compareElements_</a> <span class="args">( left, right )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Compares elements of a version number.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>left: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)</code><dd>An element from a version number.<dt>right: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)</code><dd>An element from a version number.</dl><tr><th>Returns<tr><td><dl>1 if <code >left</code> is higher.
+ The original and the result strings render the same way in HTML.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string in which to collapse spaces.</dl><tr><th>Returns<tr><td><dl>Copy of the string with normalized breaking spaces.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l134">code &raquo;</a><span class="member"><a name="goog.string.collapseWhitespace">goog.string.collapseWhitespace</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts multiple whitespace chars (spaces, non-breaking-spaces, new lines
+ and tabs) to a single space, and strips leading and trailing whitespace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Input string.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> with collapsed whitespace.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1210">code &raquo;</a><span class="member"><a name="goog.string.compareElements_">goog.string.compareElements_</a> <span class="args">( left, right )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Compares elements of a version number.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>left: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)</code><dd>An element from a version number.<dt>right: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)</code><dd>An element from a version number.</dl><tr><th>Returns<tr><td><dl>1 if <code >left</code> is higher.
                    0 if arguments are equal.
-                  -1 if <code >right</code> is higher.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1072">code &raquo;</a><span class="member"><a name="goog.string.compareVersions">goog.string.compareVersions</a> <span class="args">( version1, version2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Compares two version numbers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version1: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>Version of first item.<dt>version2: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>Version of second item.</dl><tr><th>Returns<tr><td><dl>1 if <code >version1</code> is higher.
+                  -1 if <code >right</code> is higher.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1152">code &raquo;</a><span class="member"><a name="goog.string.compareVersions">goog.string.compareVersions</a> <span class="args">( version1, version2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Compares two version numbers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version1: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>Version of first item.<dt>version2: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>Version of second item.</dl><tr><th>Returns<tr><td><dl>1 if <code >version1</code> is higher.
                    0 if arguments are equal.
-                  -1 if <code >version2</code> is higher.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l905">code &raquo;</a><span class="member"><a name="goog.string.contains">goog.string.contains</a> <span class="args">( s, ss )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks whether a string contains a given substring.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to test.<dt>ss: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The substring to test for.</dl><tr><th>Returns<tr><td><dl>True if <code >s</code> contains <code >ss</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l917">code &raquo;</a><span class="member"><a name="goog.string.countOf">goog.string.countOf</a> <span class="args">( s, ss )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the non-overlapping occurrences of ss in s.
- If either s or ss evalutes to false, then returns zero.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to look in.<dt>ss: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to look for.</dl><tr><th>Returns<tr><td><dl>Number of occurrences of ss in s.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1183">code &raquo;</a><span class="member"><a name="goog.string.createUniqueString">goog.string.createUniqueString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Generates and returns a string which is unique in the current document.
- This is useful, for example, to create unique IDs for DOM elements.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A unique id.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l53">code &raquo;</a><span class="member"><a name="goog.string.endsWith">goog.string.endsWith</a> <span class="args">( str, suffix )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Fast suffix-checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.<dt>suffix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string to look for at the end of <code >str</code>.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> ends with <code >suffix</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l848">code &raquo;</a><span class="member"><a name="goog.string.escapeChar">goog.string.escapeChar</a> <span class="args">( c )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Takes a character and returns the escaped string for that character. For
- example escapeChar(String.fromCharCode(15)) -> "\\x0E".</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>c: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The character to escape.</dl><tr><th>Returns<tr><td><dl>An escaped string representing <code >c</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l833">code &raquo;</a><span class="member"><a name="goog.string.escapeString">goog.string.escapeString</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Takes a string and returns the escaped string for that character.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to escape.</dl><tr><th>Returns<tr><td><dl>An escaped string representing <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1055">code &raquo;</a><span class="member"><a name="goog.string.getRandomString">goog.string.getRandomString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string with at least 64-bits of randomness.
+                  -1 if <code >version2</code> is higher.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l974">code &raquo;</a><span class="member"><a name="goog.string.contains">goog.string.contains</a> <span class="args">( str, subString )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines whether a string contains a substring.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to search.<dt>subString: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The substring to search for.</dl><tr><th>Returns<tr><td><dl>Whether <code >str</code> contains <code >subString</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l997">code &raquo;</a><span class="member"><a name="goog.string.countOf">goog.string.countOf</a> <span class="args">( s, ss )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the non-overlapping occurrences of ss in s.
+ If either s or ss evalutes to false, then returns zero.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to look in.<dt>ss: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to look for.</dl><tr><th>Returns<tr><td><dl>Number of occurrences of ss in s.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1263">code &raquo;</a><span class="member"><a name="goog.string.createUniqueString">goog.string.createUniqueString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Generates and returns a string which is unique in the current document.
+ This is useful, for example, to create unique IDs for DOM elements.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A unique id.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l60">code &raquo;</a><span class="member"><a name="goog.string.endsWith">goog.string.endsWith</a> <span class="args">( str, suffix )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Fast suffix-checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.<dt>suffix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string to look for at the end of <code >str</code>.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> ends with <code >suffix</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l935">code &raquo;</a><span class="member"><a name="goog.string.escapeChar">goog.string.escapeChar</a> <span class="args">( c )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Takes a character and returns the escaped string for that character. For
+ example escapeChar(String.fromCharCode(15)) -> "\\x0E".</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>c: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The character to escape.</dl><tr><th>Returns<tr><td><dl>An escaped string representing <code >c</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l920">code &raquo;</a><span class="member"><a name="goog.string.escapeString">goog.string.escapeString</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Takes a string and returns the escaped string for that character.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to escape.</dl><tr><th>Returns<tr><td><dl>An escaped string representing <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1135">code &raquo;</a><span class="member"><a name="goog.string.getRandomString">goog.string.getRandomString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string with at least 64-bits of randomness.
 
  Doesn't trust Javascript's random function entirely. Uses a combination of
  random and current timestamp, and then encodes the string in base-36 to
- make it shorter.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A random string, e.g. sn1s7vb4gcic.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1159">code &raquo;</a><span class="member"><a name="goog.string.hashCode">goog.string.hashCode</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>String hash function similar to java.lang.String.hashCode().
+ make it shorter.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>A random string, e.g. sn1s7vb4gcic.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1239">code &raquo;</a><span class="member"><a name="goog.string.hashCode">goog.string.hashCode</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>String hash function similar to java.lang.String.hashCode().
  The hash code for a string is computed as
  s[0] * 31 ^ (n - 1) + s[1] * 31 ^ (n - 2) + ... + s[n - 1],
  where s[i] is the ith character of the string and n is the length of
  the string. We mod the result to make it between 0 (inclusive) and 2^32
  (exclusive).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string.</dl><tr><th>Returns<tr><td><dl>Hash value for <code >str</code>, between 0 (inclusive) and 2^32
-  (exclusive). The empty string returns 0.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l492">code &raquo;</a><span class="member"><a name="goog.string.htmlEscape">goog.string.htmlEscape</a> <span class="args">( str, opt_isLikelyToContainHtmlChars )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Escape double quote '"' characters in addition to '&', '<', and '>' so that a
- string can be included in an HTML tag attribute value within double quotes.
+  (exclusive). The empty string returns 0.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l503">code &raquo;</a><span class="member"><a name="goog.string.htmlEscape">goog.string.htmlEscape</a> <span class="args">( str, opt_isLikelyToContainHtmlChars )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Escapes double quote '"' and single quote '\'' characters in addition to
+ '&', '<', and '>' so that a string can be included in an HTML tag attribute
+ value within double or single quotes.
 
  It should be noted that > doesn't need to be escaped for the HTML or XML to
  be valid, but it has been decided to escape it for consistency with other
  implementations.
 
+ With goog.string.DETECT_DOUBLE_ESCAPING, this function escapes also the
+ lowercase letter "e".
+
  NOTE(user):
  HtmlEscape is often called during the generation of large blocks of HTML.
  Using statics for the regular expressions and strings is an optimization
@@ -66,17 +70,17 @@
  application grows the difference between the various methods would increase.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>string to be escaped.<dt>opt_isLikelyToContainHtmlChars: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Don't perform a check to see
      if the character needs replacing - use this option if you expect each of
      the characters to appear often. Leave false if you expect few html
-     characters to occur in your strings, such as if you are escaping HTML.</dl><tr><th>Returns<tr><td><dl>An escaped copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l176">code &raquo;</a><span class="member"><a name="goog.string.isAlpha">goog.string.isAlpha</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string contains all letters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>string to check.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> consists entirely of letters.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l197">code &raquo;</a><span class="member"><a name="goog.string.isAlphaNumeric">goog.string.isAlphaNumeric</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string contains only numbers or letters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>string to check.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> is alphanumeric.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l166">code &raquo;</a><span class="member"><a name="goog.string.isBreakingWhitespace">goog.string.isBreakingWhitespace</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string is all breaking whitespace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.</dl><tr><th>Returns<tr><td><dl>Whether the string is all breaking whitespace.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l140">code &raquo;</a><span class="member"><a name="goog.string.isEmpty">goog.string.isEmpty</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string is empty or contains only whitespaces.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> is empty or whitespace only.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l156">code &raquo;</a><span class="member"><a name="goog.string.isEmptySafe">goog.string.isEmptySafe</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string is null, undefined, empty or contains only whitespaces.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type">*</code><dd>The string to check.</dl><tr><th>Returns<tr><td><dl>True if<code >str</code> is null, undefined, empty, or
-     whitespace only.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1217">code &raquo;</a><span class="member"><a name="goog.string.isLowerCamelCase">goog.string.isLowerCamelCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether the given string is lower camel case (e.g. "isFooBar").
+     characters to occur in your strings, such as if you are escaping HTML.</dl><tr><th>Returns<tr><td><dl>An escaped copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l183">code &raquo;</a><span class="member"><a name="goog.string.isAlpha">goog.string.isAlpha</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string contains all letters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>string to check.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> consists entirely of letters.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l204">code &raquo;</a><span class="member"><a name="goog.string.isAlphaNumeric">goog.string.isAlphaNumeric</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string contains only numbers or letters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>string to check.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> is alphanumeric.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l173">code &raquo;</a><span class="member"><a name="goog.string.isBreakingWhitespace">goog.string.isBreakingWhitespace</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string is all breaking whitespace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.</dl><tr><th>Returns<tr><td><dl>Whether the string is all breaking whitespace.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l147">code &raquo;</a><span class="member"><a name="goog.string.isEmpty">goog.string.isEmpty</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string is empty or contains only whitespaces.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> is empty or whitespace only.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l163">code &raquo;</a><span class="member"><a name="goog.string.isEmptySafe">goog.string.isEmptySafe</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string is null, undefined, empty or contains only whitespaces.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type">*</code><dd>The string to check.</dl><tr><th>Returns<tr><td><dl>True if<code >str</code> is null, undefined, empty, or
+     whitespace only.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1297">code &raquo;</a><span class="member"><a name="goog.string.isLowerCamelCase">goog.string.isLowerCamelCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether the given string is lower camel case (e.g. "isFooBar").
 
- Note that this assumes the string is entirely letters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>String to test.</dl><tr><th>Returns<tr><td><dl>Whether the string is lower camel case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l187">code &raquo;</a><span class="member"><a name="goog.string.isNumeric">goog.string.isNumeric</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string contains only numbers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type">*</code><dd>string to check. If not a string, it will be
-     casted to one.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> is numeric.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l207">code &raquo;</a><span class="member"><a name="goog.string.isSpace">goog.string.isSpace</a> <span class="args">( ch )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a character is a space character.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ch: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Character to check.</dl><tr><th>Returns<tr><td><dl>True if {code ch} is a space.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l217">code &raquo;</a><span class="member"><a name="goog.string.isUnicodeChar">goog.string.isUnicodeChar</a> <span class="args">( ch )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a character is a valid unicode character.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ch: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Character to check.</dl><tr><th>Returns<tr><td><dl>True if {code ch} is a valid unicode character.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1231">code &raquo;</a><span class="member"><a name="goog.string.isUpperCamelCase">goog.string.isUpperCamelCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether the given string is upper camel case (e.g. "FooBarBaz").
+ Note that this assumes the string is entirely letters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>String to test.</dl><tr><th>Returns<tr><td><dl>Whether the string is lower camel case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l194">code &raquo;</a><span class="member"><a name="goog.string.isNumeric">goog.string.isNumeric</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a string contains only numbers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type">*</code><dd>string to check. If not a string, it will be
+     casted to one.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> is numeric.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l214">code &raquo;</a><span class="member"><a name="goog.string.isSpace">goog.string.isSpace</a> <span class="args">( ch )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a character is a space character.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ch: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Character to check.</dl><tr><th>Returns<tr><td><dl>True if {code ch} is a space.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l224">code &raquo;</a><span class="member"><a name="goog.string.isUnicodeChar">goog.string.isUnicodeChar</a> <span class="args">( ch )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Checks if a character is a valid unicode character.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ch: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Character to check.</dl><tr><th>Returns<tr><td><dl>True if {code ch} is a valid unicode character.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1311">code &raquo;</a><span class="member"><a name="goog.string.isUpperCamelCase">goog.string.isUpperCamelCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns whether the given string is upper camel case (e.g. "FooBarBaz").
 
- Note that this assumes the string is entirely letters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>String to test.</dl><tr><th>Returns<tr><td><dl>Whether the string is upper camel case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1022">code &raquo;</a><span class="member"><a name="goog.string.makeSafe">goog.string.makeSafe</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string representation of the given object, with
- null and undefined being returned as the empty string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The object to convert.</dl><tr><th>Returns<tr><td><dl>A string representation of the <code >obj</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l447">code &raquo;</a><span class="member"><a name="goog.string.newLineToBr">goog.string.newLineToBr</a> <span class="args">( str, opt_xml )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts \n to <br>s or <br />s.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in which to convert newlines.<dt>opt_xml: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to use XML compatible tags.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> with converted newlines.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l262">code &raquo;</a><span class="member"><a name="goog.string.normalizeSpaces">goog.string.normalizeSpaces</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Normalizes spaces in a string, replacing all consecutive spaces and tabs
+ Note that this assumes the string is entirely letters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>String to test.</dl><tr><th>Returns<tr><td><dl>Whether the string is upper camel case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1102">code &raquo;</a><span class="member"><a name="goog.string.makeSafe">goog.string.makeSafe</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns a string representation of the given object, with
+ null and undefined being returned as the empty string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">*</code><dd>The object to convert.</dl><tr><th>Returns<tr><td><dl>A string representation of the <code >obj</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l454">code &raquo;</a><span class="member"><a name="goog.string.newLineToBr">goog.string.newLineToBr</a> <span class="args">( str, opt_xml )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts \n to <br>s or <br />s.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in which to convert newlines.<dt>opt_xml: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to use XML compatible tags.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> with converted newlines.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l269">code &raquo;</a><span class="member"><a name="goog.string.normalizeSpaces">goog.string.normalizeSpaces</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Normalizes spaces in a string, replacing all consecutive spaces and tabs
  with a single space. Replaces non-breaking space with a space.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in which to normalize spaces.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> with all consecutive spaces and tabs
-    replaced with a single space.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l250">code &raquo;</a><span class="member"><a name="goog.string.normalizeWhitespace">goog.string.normalizeWhitespace</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Normalizes whitespace in a string, replacing all whitespace chars with
- a space.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in which to normalize whitespace.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> with all whitespace normalized.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l368">code &raquo;</a><span class="member"><a name="goog.string.numerateCompare">goog.string.numerateCompare</a> <span class="args">( str1, str2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>String comparison function that handles numbers in a way humans might expect.
+    replaced with a single space.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l257">code &raquo;</a><span class="member"><a name="goog.string.normalizeWhitespace">goog.string.normalizeWhitespace</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Normalizes whitespace in a string, replacing all whitespace chars with
+ a space.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in which to normalize whitespace.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> with all whitespace normalized.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l375">code &raquo;</a><span class="member"><a name="goog.string.numerateCompare">goog.string.numerateCompare</a> <span class="args">( str1, str2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>String comparison function that handles numbers in a way humans might expect.
  Using this function, the string "File 2.jpg" sorts before "File 10.jpg". The
  comparison is mostly case-insensitive, though strings that are identical
  except for case are sorted with the upper-case strings before lower-case.
@@ -85,12 +89,12 @@
  the default or the case-insensitive compare. It should not be used in
  time-critical code, but should be fast enough to sort several hundred short
  strings (like filenames) with a reasonable delay.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to compare in a numerically sensitive way.<dt>str2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to compare <code >str1</code> to.</dl><tr><th>Returns<tr><td><dl>less than 0 if str1 < str2, 0 if str1 == str2, greater than
-     0 if str1 > str2.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1005">code &raquo;</a><span class="member"><a name="goog.string.padNumber">goog.string.padNumber</a> <span class="args">( num, length, opt_precision )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Pads number to given length and optionally rounds it to a given precision.
+     0 if str1 > str2.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1085">code &raquo;</a><span class="member"><a name="goog.string.padNumber">goog.string.padNumber</a> <span class="args">( num, length, opt_precision )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Pads number to given length and optionally rounds it to a given precision.
  For example:
  <pre>padNumber(1.25, 2, 3) -> '01.250'
  padNumber(1.25, 2) -> '01.25'
  padNumber(1.25, 2, 1) -> '01.3'
- padNumber(1.25, 0) -> '1.25'</pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>num: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to pad.<dt>length: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The desired length.<dt>opt_precision: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The desired precision.</dl><tr><th>Returns<tr><td><dl><code >num</code> as a string with the given options.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1325">code &raquo;</a><span class="member"><a name="goog.string.parseInt">goog.string.parseInt</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Parse a string in decimal or hexidecimal ('0xFFFF') form.
+ padNumber(1.25, 0) -> '1.25'</pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>num: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number to pad.<dt>length: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The desired length.<dt>opt_precision: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>The desired precision.</dl><tr><th>Returns<tr><td><dl><code >num</code> as a string with the given options.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1405">code &raquo;</a><span class="member"><a name="goog.string.parseInt">goog.string.parseInt</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Parse a string in decimal or hexidecimal ('0xFFFF') form.
 
  To parse a particular radix, please use parseInt(string, radix) directly. See
  https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/parseInt
@@ -101,14 +105,15 @@
  this behavior. ES5 forbids it.  This function emulates the ES5 behavior.
 
  For more information, see Mozilla JS Reference: http://goo.gl/8RiFj</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>The value to be parsed.</dl><tr><th>Returns<tr><td><dl>The number, parsed. If the string failed to parse, this
-     will be NaN.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l810">code &raquo;</a><span class="member"><a name="goog.string.quote">goog.string.quote</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Encloses a string in double quotes and escapes characters so that the
- string is a valid JS string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to quote.</dl><tr><th>Returns<tr><td><dl>A copy of <code >s</code> surrounded by double quotes.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l974">code &raquo;</a><span class="member"><a name="goog.string.regExpEscape">goog.string.regExpEscape</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Escapes characters in the string that are not safe to use in a RegExp.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type">*</code><dd>The string to escape. If not a string, it will be casted
-     to one.</dl><tr><th>Returns<tr><td><dl>A RegExp safe, escaped copy of <code >s</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l949">code &raquo;</a><span class="member"><a name="goog.string.remove">goog.string.remove</a> <span class="args">( s, ss )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes the first occurrence of a substring from a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The base string from which to remove.<dt>ss: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to remove.</dl><tr><th>Returns<tr><td><dl>A copy of <code >s</code> with <code >ss</code> removed or the full
-      string if nothing is removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l962">code &raquo;</a><span class="member"><a name="goog.string.removeAll">goog.string.removeAll</a> <span class="args">( s, ss )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes all occurrences of a substring from a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The base string from which to remove.<dt>ss: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to remove.</dl><tr><th>Returns<tr><td><dl>A copy of <code >s</code> with <code >ss</code> removed or the full
-      string if nothing is removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l931">code &raquo;</a><span class="member"><a name="goog.string.removeAt">goog.string.removeAt</a> <span class="args">( s, index, stringLength )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes a substring of a specified length at a specific
+     will be NaN.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l763">code &raquo;</a><span class="member"><a name="goog.string.preserveSpaces">goog.string.preserveSpaces</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Preserve spaces that would be otherwise collapsed in HTML by replacing them
+ with non-breaking space Unicode characters.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in which to preserve whitespace.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> with preserved whitespace.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l897">code &raquo;</a><span class="member"><a name="goog.string.quote">goog.string.quote</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Encloses a string in double quotes and escapes characters so that the
+ string is a valid JS string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to quote.</dl><tr><th>Returns<tr><td><dl>A copy of <code >s</code> surrounded by double quotes.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1054">code &raquo;</a><span class="member"><a name="goog.string.regExpEscape">goog.string.regExpEscape</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Escapes characters in the string that are not safe to use in a RegExp.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type">*</code><dd>The string to escape. If not a string, it will be casted
+     to one.</dl><tr><th>Returns<tr><td><dl>A RegExp safe, escaped copy of <code >s</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1029">code &raquo;</a><span class="member"><a name="goog.string.remove">goog.string.remove</a> <span class="args">( s, ss )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes the first occurrence of a substring from a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The base string from which to remove.<dt>ss: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to remove.</dl><tr><th>Returns<tr><td><dl>A copy of <code >s</code> with <code >ss</code> removed or the full
+      string if nothing is removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1042">code &raquo;</a><span class="member"><a name="goog.string.removeAll">goog.string.removeAll</a> <span class="args">( s, ss )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes all occurrences of a substring from a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The base string from which to remove.<dt>ss: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to remove.</dl><tr><th>Returns<tr><td><dl>A copy of <code >s</code> with <code >ss</code> removed or the full
+      string if nothing is removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1011">code &raquo;</a><span class="member"><a name="goog.string.removeAt">goog.string.removeAt</a> <span class="args">( s, index, stringLength )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes a substring of a specified length at a specific
  index in a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The base string from which to remove.<dt>index: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index at which to remove the substring.<dt>stringLength: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The length of the substring to remove.</dl><tr><th>Returns<tr><td><dl>A copy of <code >s</code> with the substring removed or the full
-     string if nothing is removed or the input is invalid.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l987">code &raquo;</a><span class="member"><a name="goog.string.repeat">goog.string.repeat</a> <span class="args">( string, length )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Repeats a string n times.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>string: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to repeat.<dt>length: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of times to repeat.</dl><tr><th>Returns<tr><td><dl>A string containing <code >length</code> repetitions of
-     <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1360">code &raquo;</a><span class="member"><a name="goog.string.splitLimit">goog.string.splitLimit</a> <span class="args">( str, separator, limit )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Splits a string on a separator a limited number of times.
+     string if nothing is removed or the input is invalid.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1067">code &raquo;</a><span class="member"><a name="goog.string.repeat">goog.string.repeat</a> <span class="args">( string, length )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Repeats a string n times.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>string: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to repeat.<dt>length: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The number of times to repeat.</dl><tr><th>Returns<tr><td><dl>A string containing <code >length</code> repetitions of
+     <code >string</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1440">code &raquo;</a><span class="member"><a name="goog.string.splitLimit">goog.string.splitLimit</a> <span class="args">( str, separator, limit )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Splits a string on a separator a limited number of times.
 
  This implementation is more similar to Python or Java, where the limit
  parameter specifies the maximum number of splits rather than truncating
@@ -118,8 +123,8 @@
  See JavaDoc: http://goo.gl/F2AsY
  See Mozilla reference: http://goo.gl/dZdZs</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>String to split.<dt>separator: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The separator.<dt>limit: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The limit to the number of splits. The resulting array
      will have a maximum length of limit+1.  Negative numbers are the same
-     as zero.</dl><tr><th>Returns<tr><td><dl>The string, split.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l42">code &raquo;</a><span class="member"><a name="goog.string.startsWith">goog.string.startsWith</a> <span class="args">( str, prefix )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Fast prefix-checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.<dt>prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string to look for at the start of <code >str</code>.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> begins with <code >prefix</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l229">code &raquo;</a><span class="member"><a name="goog.string.stripNewlines">goog.string.stripNewlines</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Takes a string and replaces newlines with a space. Multiple lines are
- replaced with a single space.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string from which to strip newlines.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> stripped of newlines.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l696">code &raquo;</a><span class="member"><a name="goog.string.stripQuotes">goog.string.stripQuotes</a> <span class="args">( str, quoteChars )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Strip quote characters around a string.  The second argument is a string of
+     as zero.</dl><tr><th>Returns<tr><td><dl>The string, split.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l49">code &raquo;</a><span class="member"><a name="goog.string.startsWith">goog.string.startsWith</a> <span class="args">( str, prefix )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Fast prefix-checker.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to check.<dt>prefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A string to look for at the start of <code >str</code>.</dl><tr><th>Returns<tr><td><dl>True if <code >str</code> begins with <code >prefix</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l236">code &raquo;</a><span class="member"><a name="goog.string.stripNewlines">goog.string.stripNewlines</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Takes a string and replaces newlines with a space. Multiple lines are
+ replaced with a single space.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string from which to strip newlines.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> stripped of newlines.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l783">code &raquo;</a><span class="member"><a name="goog.string.stripQuotes">goog.string.stripQuotes</a> <span class="args">( str, quoteChars )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Strip quote characters around a string.  The second argument is a string of
  characters to treat as quotes.  This can be a single character or a string of
  multiple character and in that case each of those are treated as possible
  quote characters. For example:
@@ -127,20 +132,18 @@
  <pre>
  goog.string.stripQuotes('"abc"', '"`') --> 'abc'
  goog.string.stripQuotes('`abc`', '"`') --> 'abc'
- </pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to strip.<dt>quoteChars: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The quote characters to strip.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> without the quotes.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l105">code &raquo;</a><span class="member"><a name="goog.string.subs">goog.string.subs</a> <span class="args">( str, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Does simple python-style string substitution.
+ </pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to strip.<dt>quoteChars: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The quote characters to strip.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> without the quotes.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l112">code &raquo;</a><span class="member"><a name="goog.string.subs">goog.string.subs</a> <span class="args">( str, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Does simple python-style string substitution.
  subs("foo%s hot%s", "bar", "dog") becomes "foobar hotdog".</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string containing the pattern.<dt>var_args: <code class="type">...*</code><dd>The items to substitute into the pattern.</dl><tr><th>Returns<tr><td><dl>A copy of <code >str</code> in which each occurrence of
-     <code >%s</code> has been replaced an argument from <code >var_args</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1243">code &raquo;</a><span class="member"><a name="goog.string.toCamelCase">goog.string.toCamelCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a string from selector-case to camelCase (e.g. from
+     <code >%s</code> has been replaced an argument from <code >var_args</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1323">code &raquo;</a><span class="member"><a name="goog.string.toCamelCase">goog.string.toCamelCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a string from selector-case to camelCase (e.g. from
  "multi-part-string" to "multiPartString"), useful for converting
- CSS selectors and HTML dataset keys to their equivalent JS properties.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in selector-case form.</dl><tr><th>Returns<tr><td><dl>The string in camelCase form.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l890">code &raquo;</a><span class="member"><a name="goog.string.toMap">goog.string.toMap</a> <span class="args">( s )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Takes a string and creates a map (Object) in which the keys are the
- characters in the string. The value for the key is set to true. You can
- then use goog.object.map or goog.array.map to change the values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>s: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to build the map from.</dl><tr><th>Returns<tr><td><dl>The map of characters used.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1199">code &raquo;</a><span class="member"><a name="goog.string.toNumber">goog.string.toNumber</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Converts the supplied string to a number, which may be Ininity or NaN.
+ CSS selectors and HTML dataset keys to their equivalent JS properties.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in selector-case form.</dl><tr><th>Returns<tr><td><dl>The string in camelCase form.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1279">code &raquo;</a><span class="member"><a name="goog.string.toNumber">goog.string.toNumber</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Converts the supplied string to a number, which may be Infinity or NaN.
  This function strips whitespace: (toNumber(' 123') === 123)
  This function accepts scientific notation: (toNumber('1e1') === 10)
 
  This is better than Javascript's built-in conversions because, sadly:
-     (Number(' ') === 0) and (parseFloat('123a') === 123)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to convert.</dl><tr><th>Returns<tr><td><dl>The number the supplied string represents, or NaN.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1257">code &raquo;</a><span class="member"><a name="goog.string.toSelectorCase">goog.string.toSelectorCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a string from camelCase to selector-case (e.g. from
+     (Number(' ') === 0) and (parseFloat('123a') === 123)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to convert.</dl><tr><th>Returns<tr><td><dl>The number the supplied string represents, or NaN.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1337">code &raquo;</a><span class="member"><a name="goog.string.toSelectorCase">goog.string.toSelectorCase</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a string from camelCase to selector-case (e.g. from
  "multiPartString" to "multi-part-string"), useful for converting JS
- style and dataset properties to equivalent CSS selectors and HTML keys.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in camelCase form.</dl><tr><th>Returns<tr><td><dl>The string in selector-case form.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1293">code &raquo;</a><span class="member"><a name="goog.string.toTitleCase">goog.string.toTitleCase</a> <span class="args">( str, opt_delimiters )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a string into TitleCase. First character of the string is always
+ style and dataset properties to equivalent CSS selectors and HTML keys.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in camelCase form.</dl><tr><th>Returns<tr><td><dl>The string in selector-case form.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1373">code &raquo;</a><span class="member"><a name="goog.string.toTitleCase">goog.string.toTitleCase</a> <span class="args">( str, opt_delimiters )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a string into TitleCase. First character of the string is always
  capitalized in addition to the first letter of every subsequent word.
  Words are delimited by one or more whitespaces by default. Custom delimiters
  can optionally be specified to replace the default, which doesn't preserve
@@ -164,18 +167,20 @@
     goog.string.toTitleCase('one-two.three', '_-.')     => 'One-Two.Three'</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>String value in camelCase form.<dt>opt_delimiters: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>Custom delimiter character set used to
       distinguish words in the string value. Each character represents a
       single delimiter. When provided, default whitespace delimiter is
-      overridden and must be explicitly included if needed.</dl><tr><th>Returns<tr><td><dl>String value in TitleCase form.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l285">code &raquo;</a><span class="member"><a name="goog.string.trim">goog.string.trim</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims white spaces to the left and right of a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to trim.</dl><tr><th>Returns<tr><td><dl>A trimmed copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l298">code &raquo;</a><span class="member"><a name="goog.string.trimLeft">goog.string.trimLeft</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims whitespaces at the left end of a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to left trim.</dl><tr><th>Returns<tr><td><dl>A trimmed copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l311">code &raquo;</a><span class="member"><a name="goog.string.trimRight">goog.string.trimRight</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims whitespaces at the right end of a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to right trim.</dl><tr><th>Returns<tr><td><dl>A trimmed copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l718">code &raquo;</a><span class="member"><a name="goog.string.truncate">goog.string.truncate</a> <span class="args">( str, chars, opt_protectEscapedCharacters )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Truncates a string to a certain length and adds '...' if necessary.  The
+      overridden and must be explicitly included if needed.</dl><tr><th>Returns<tr><td><dl>String value in TitleCase form.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l292">code &raquo;</a><span class="member"><a name="goog.string.trim">goog.string.trim</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims white spaces to the left and right of a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to trim.</dl><tr><th>Returns<tr><td><dl>A trimmed copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l305">code &raquo;</a><span class="member"><a name="goog.string.trimLeft">goog.string.trimLeft</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims whitespaces at the left end of a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to left trim.</dl><tr><th>Returns<tr><td><dl>A trimmed copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l318">code &raquo;</a><span class="member"><a name="goog.string.trimRight">goog.string.trimRight</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Trims whitespaces at the right end of a string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to right trim.</dl><tr><th>Returns<tr><td><dl>A trimmed copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l805">code &raquo;</a><span class="member"><a name="goog.string.truncate">goog.string.truncate</a> <span class="args">( str, chars, opt_protectEscapedCharacters )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Truncates a string to a certain length and adds '...' if necessary.  The
  length also accounts for the ellipsis, so a maximum length of 10 and a string
  'Hello World!' produces 'Hello W...'.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to truncate.<dt>chars: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Max number of characters.<dt>opt_protectEscapedCharacters: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to protect escaped
-     characters from being cut off in the middle.</dl><tr><th>Returns<tr><td><dl>The truncated <code >str</code> string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l747">code &raquo;</a><span class="member"><a name="goog.string.truncateMiddle">goog.string.truncateMiddle</a> <span class="args">( str, chars, opt_protectEscapedCharacters, opt_trailingChars )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Truncate a string in the middle, adding "..." if necessary,
+     characters from being cut off in the middle.</dl><tr><th>Returns<tr><td><dl>The truncated <code >str</code> string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l834">code &raquo;</a><span class="member"><a name="goog.string.truncateMiddle">goog.string.truncateMiddle</a> <span class="args">( str, chars, opt_protectEscapedCharacters, opt_trailingChars )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Truncate a string in the middle, adding "..." if necessary,
  and favoring the beginning of the string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to truncate the middle of.<dt>chars: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Max number of characters.<dt>opt_protectEscapedCharacters: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to protect escaped
      characters from being cutoff in the middle.<dt>opt_trailingChars: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Optional number of trailing characters to
      leave at the end of the string, instead of truncating as close to the
-     middle as possible.</dl><tr><th>Returns<tr><td><dl>A truncated copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l569">code &raquo;</a><span class="member"><a name="goog.string.unescapeEntities">goog.string.unescapeEntities</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Unescapes an HTML string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to unescape.</dl><tr><th>Returns<tr><td><dl>An unescaped copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l592">code &raquo;</a><span class="member"><a name="goog.string.unescapeEntitiesUsingDom_">goog.string.unescapeEntitiesUsingDom_</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Unescapes an HTML string using a DOM to resolve non-XML, non-numeric
- entities. This function is XSS-safe and whitespace-preserving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to unescape.</dl><tr><th>Returns<tr><td><dl>The unescaped <code >str</code> string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l634">code &raquo;</a><span class="member"><a name="goog.string.unescapePureXmlEntities_">goog.string.unescapePureXmlEntities_</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Unescapes XML entities.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to unescape.</dl><tr><th>Returns<tr><td><dl>An unescaped copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l436">code &raquo;</a><span class="member"><a name="goog.string.urlDecode">goog.string.urlDecode</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>URL-decodes the string. We need to specially handle '+'s because
- the javascript library doesn't convert them to spaces.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to url decode.</dl><tr><th>Returns<tr><td><dl>The decoded <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l425">code &raquo;</a><span class="member"><a name="goog.string.urlEncode">goog.string.urlEncode</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>URL-encodes a string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type">*</code><dd>The string to url-encode.</dl><tr><th>Returns<tr><td><dl>An encoded copy of <code >str</code> that is safe for urls.
+     middle as possible.</dl><tr><th>Returns<tr><td><dl>A truncated copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l621">code &raquo;</a><span class="member"><a name="goog.string.unescapeEntities">goog.string.unescapeEntities</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Unescapes an HTML string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to unescape.</dl><tr><th>Returns<tr><td><dl>An unescaped copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l662">code &raquo;</a><span class="member"><a name="goog.string.unescapeEntitiesUsingDom_">goog.string.unescapeEntitiesUsingDom_</a> <span class="args">( str, opt_document )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Unescapes an HTML string using a DOM to resolve non-XML, non-numeric
+ entities. This function is XSS-safe and whitespace-preserving.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to unescape.<dt>opt_document: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a>=</code><dd>An optional document to use for creating
+     elements. If this is not specified then the default window.document
+     will be used.</dl><tr><th>Returns<tr><td><dl>The unescaped <code >str</code> string.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l644">code &raquo;</a><span class="member"><a name="goog.string.unescapeEntitiesWithDocument">goog.string.unescapeEntitiesWithDocument</a> <span class="args">( str, document )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Unescapes a HTML string using the provided document.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to unescape.<dt>document: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>A document to use in escaping the string.</dl><tr><th>Returns<tr><td><dl>An unescaped copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l709">code &raquo;</a><span class="member"><a name="goog.string.unescapePureXmlEntities_">goog.string.unescapePureXmlEntities_</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Unescapes XML entities.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to unescape.</dl><tr><th>Returns<tr><td><dl>An unescaped copy of <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l443">code &raquo;</a><span class="member"><a name="goog.string.urlDecode">goog.string.urlDecode</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>URL-decodes the string. We need to specially handle '+'s because
+ the javascript library doesn't convert them to spaces.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string to url decode.</dl><tr><th>Returns<tr><td><dl>The decoded <code >str</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l432">code &raquo;</a><span class="member"><a name="goog.string.urlEncode">goog.string.urlEncode</a> <span class="args">( str )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>URL-encodes a string</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type">*</code><dd>The string to url-encode.</dl><tr><th>Returns<tr><td><dl>An encoded copy of <code >str</code> that is safe for urls.
      Note that '#', ':', and other characters used to delimit portions
-     of URLs *will* be encoded.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l676">code &raquo;</a><span class="member"><a name="goog.string.whitespaceEscape">goog.string.whitespaceEscape</a> <span class="args">( str, opt_xml )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Do escaping of whitespace to preserve spatial formatting. We use character
- entity #160 to make it safer for xml.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in which to escape whitespace.<dt>opt_xml: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to use XML compatible tags.</dl><tr><th>Returns<tr><td><dl>An escaped copy of <code >str</code>.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1145">code &raquo;</a><span class="member"><a name="goog.string.HASHCODE_MAX_">goog.string.HASHCODE_MAX_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Maximum value of #goog.string.hashCode, exclusive. 2^32.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l666">code &raquo;</a><span class="member"><a name="goog.string.HTML_ENTITY_PATTERN_">goog.string.HTML_ENTITY_PATTERN_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches an HTML entity.
- See also HTML5: Tokenization / Tokenizing character references.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l560">code &raquo;</a><span class="member"><a name="goog.string.allRe_">goog.string.allRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches any character that needs to be escaped.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l528">code &raquo;</a><span class="member"><a name="goog.string.amperRe_">goog.string.amperRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches an ampersand, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l544">code &raquo;</a><span class="member"><a name="goog.string.gtRe_">goog.string.gtRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches a greater than sign, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l799">code &raquo;</a><span class="member"><a name="goog.string.jsEscapeCache_">goog.string.jsEscapeCache_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Character mappings used internally for goog.string.escapeChar.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l536">code &raquo;</a><span class="member"><a name="goog.string.ltRe_">goog.string.ltRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches a less than sign, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l349">code &raquo;</a><span class="member"><a name="goog.string.numerateCompareRegExp_">goog.string.numerateCompareRegExp_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression used for splitting a string into substrings of fractional
- numbers, integers, and non-numeric characters.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l552">code &raquo;</a><span class="member"><a name="goog.string.quotRe_">goog.string.quotRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches a double quote, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l781">code &raquo;</a><span class="member"><a name="goog.string.specialEscapeChars_">goog.string.specialEscapeChars_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Special chars that need to be escaped for goog.string.quote.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1175">code &raquo;</a><span class="member"><a name="goog.string.uniqueStringCounter_">goog.string.uniqueStringCounter_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The most recent unique ID. |0 is equivalent to Math.floor in this case.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     of URLs *will* be encoded.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l751">code &raquo;</a><span class="member"><a name="goog.string.whitespaceEscape">goog.string.whitespaceEscape</a> <span class="args">( str, opt_xml )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Do escaping of whitespace to preserve spatial formatting. We use character
+ entity #160 to make it safer for xml.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>str: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The string in which to escape whitespace.<dt>opt_xml: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to use XML compatible tags.</dl><tr><th>Returns<tr><td><dl>An escaped copy of <code >str</code>.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l610">code &raquo;</a><span class="member"><a name="goog.string.ALL_RE_">goog.string.ALL_RE_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches any character that needs to be escaped.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l554">code &raquo;</a><span class="member"><a name="goog.string.AMP_RE_">goog.string.AMP_RE_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches an ampersand, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l602">code &raquo;</a><span class="member"><a name="goog.string.E_RE_">goog.string.E_RE_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches a lowercase letter "e", for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l570">code &raquo;</a><span class="member"><a name="goog.string.GT_RE_">goog.string.GT_RE_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches a greater than sign, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1225">code &raquo;</a><span class="member"><a name="goog.string.HASHCODE_MAX_">goog.string.HASHCODE_MAX_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Maximum value of #goog.string.hashCode, exclusive. 2^32.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l741">code &raquo;</a><span class="member"><a name="goog.string.HTML_ENTITY_PATTERN_">goog.string.HTML_ENTITY_PATTERN_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches an HTML entity.
+ See also HTML5: Tokenization / Tokenizing character references.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l562">code &raquo;</a><span class="member"><a name="goog.string.LT_RE_">goog.string.LT_RE_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches a less than sign, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l594">code &raquo;</a><span class="member"><a name="goog.string.NULL_RE_">goog.string.NULL_RE_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches null character, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l578">code &raquo;</a><span class="member"><a name="goog.string.QUOT_RE_">goog.string.QUOT_RE_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches a double quote, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l586">code &raquo;</a><span class="member"><a name="goog.string.SINGLE_QUOTE_RE_">goog.string.SINGLE_QUOTE_RE_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression that matches a single quote, for use in escaping.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l886">code &raquo;</a><span class="member"><a name="goog.string.jsEscapeCache_">goog.string.jsEscapeCache_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Character mappings used internally for goog.string.escapeChar.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l356">code &raquo;</a><span class="member"><a name="goog.string.numerateCompareRegExp_">goog.string.numerateCompareRegExp_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression used for splitting a string into substrings of fractional
+ numbers, integers, and non-numeric characters.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l868">code &raquo;</a><span class="member"><a name="goog.string.specialEscapeChars_">goog.string.specialEscapeChars_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Special chars that need to be escaped for goog.string.quote.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l1255">code &raquo;</a><span class="member"><a name="goog.string.uniqueStringCounter_">goog.string.uniqueStringCounter_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>The most recent unique ID. |0 is equivalent to Math.floor in this case.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/string/string.js.src.html#l31">code &raquo;</a><span class="member"><a name="goog.string.DETECT_DOUBLE_ESCAPING">goog.string.DETECT_DOUBLE_ESCAPING</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_structs.html b/docs/namespace_goog_structs.html
index 95e655e..3b83e2b 100644
--- a/docs/namespace_goog_structs.html
+++ b/docs/namespace_goog_structs.html
@@ -1,11 +1,11 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.structs</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.structs</h1><a class="source" href="source/lib/goog/structs/structs.js.src.html#l26">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_structs_Map.html">goog.structs.Map</a><dd>Class for Hash Map datastructure.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l148">code &raquo;</a><span class="member"><a name="goog.structs.clear">goog.structs.clear</a> <span class="args">( col )</span></span></div><p>Removes all the elements from the collection.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l110">code &raquo;</a><span class="member"><a name="goog.structs.contains">goog.structs.contains</a> <span class="args">( col, val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the collection contains the given value. This is O(n) and uses
- equals (==) to test the existence.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.<dt>val: <code class="type">*</code><dd>The value to check for.</dl><tr><th>Returns<tr><td><dl>True if the map contains the value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l335">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.structs.every">goog.structs.every</a> <span class="args">( col, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls f for each value in a collection. If all calls return true this return
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.structs</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.structs</h1><a class="source" href="source/lib/goog/structs/collection.js.src.html#l21">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_goog_structs_Collection.html">goog.structs.Collection</a><dd>An interface for a collection of values.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_structs_Map.html">goog.structs.Map</a><dd>Class for Hash Map datastructure.<dt><a href="class_goog_structs_Set.html">goog.structs.Set</a><dd>A set that can contain both primitives and objects.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l148">code &raquo;</a><span class="member"><a name="goog.structs.clear">goog.structs.clear</a> <span class="args">( col )</span></span></div><p>Removes all the elements from the collection.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l110">code &raquo;</a><span class="member"><a name="goog.structs.contains">goog.structs.contains</a> <span class="args">( col, val )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the collection contains the given value. This is O(n) and uses
+ equals (==) to test the existence.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.<dt>val: <code class="type">*</code><dd>The value to check for.</dl><tr><th>Returns<tr><td><dl>True if the map contains the value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l338">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.structs.every">goog.structs.every</a> <span class="args">( col, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls f for each value in a collection. If all calls return true this return
  true this returns true. If any returns false this returns false at this point
   and does not continue to check the remaining values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">S</code><dd>The collection-like object.<dt>f: <code class="type">function(this: T, ?, ?, S): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every
      value. This function takes 3 arguments (the value, the key or
      undefined if the collection has no notion of keys, and the collection)
      and should return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this'
-     within <code >f</code>.</dl><tr><th>Returns<tr><td><dl>True if all key-value pairs pass the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l207">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.structs.filter">goog.structs.filter</a> <span class="args">( col, f, opt_obj )</span> &rArr; <code class="type">(!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code></span></div><p>Calls a function for every value in the collection. When a call returns true,
+     within <code >f</code>.</dl><tr><th>Returns<tr><td><dl>True if all key-value pairs pass the test.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l210">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.structs.filter">goog.structs.filter</a> <span class="args">( col, f, opt_obj )</span> &rArr; <code class="type">(!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code></span></div><p>Calls a function for every value in the collection. When a call returns true,
  adds the value to a new collection (Array is returned by default).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">S</code><dd>The collection-like object.<dt>f: <code class="type">function(this: T, ?, ?, S): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every
      value. This function takes
      3 arguments (the value, the key or undefined if the collection has no
@@ -14,22 +14,25 @@
      is false the value is not included.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this'
      within <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new collection where the passed values are
      present. If col is a key-less collection an array is returned.  If col
-     has keys and values a plain old JS object is returned.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l173">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.structs.forEach">goog.structs.forEach</a> <span class="args">( col, f, opt_obj )</span></span></div><p>Calls a function for each value in a collection. The function takes
- three arguments; the value, the key and the collection.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">S</code><dd>The collection-like object.<dt>f: <code class="type">function(this: T, ?, ?, S): ?</code><dd>The function to call for every value.
+     has keys and values a plain old JS object is returned.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l176">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.structs.forEach">goog.structs.forEach</a> <span class="args">( col, f, opt_obj )</span></span></div><p>Calls a function for each value in a collection. The function takes
+ three arguments; the value, the key and the collection.
+
+ NOTE: This will be deprecated soon! Please use a more specific method if
+ possible, e.g. goog.array.forEach, goog.object.forEach, etc.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">S</code><dd>The collection-like object.<dt>f: <code class="type">function(this: T, ?, ?, S): ?</code><dd>The function to call for every value.
      This function takes
      3 arguments (the value, the key or undefined if the collection has no
      notion of keys, and the collection) and the return value is irrelevant.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this'
      within <code >f</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l41">code &raquo;</a><span class="member"><a name="goog.structs.getCount">goog.structs.getCount</a> <span class="args">( col )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the number of values in the collection-like object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl><tr><th>Returns<tr><td><dl>The number of values in the collection-like object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l82">code &raquo;</a><span class="member"><a name="goog.structs.getKeys">goog.structs.getKeys</a> <span class="args">( col )</span> &rArr; <code class="type">(!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>Returns the keys of the collection. Some collections have no notion of
- keys/indexes and this function will return undefined in those cases.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl><tr><th>Returns<tr><td><dl>The keys in the collection.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l57">code &raquo;</a><span class="member"><a name="goog.structs.getValues">goog.structs.getValues</a> <span class="args">( col )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns the values of the collection-like object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl><tr><th>Returns<tr><td><dl>The values in the collection-like object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l129">code &raquo;</a><span class="member"><a name="goog.structs.isEmpty">goog.structs.isEmpty</a> <span class="args">( col )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the collection is empty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl><tr><th>Returns<tr><td><dl>True if empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l257">code &raquo;</a><code class="type">&lt;T, S, V&gt;</code> <span class="member"><a name="goog.structs.map">goog.structs.map</a> <span class="args">( col, f, opt_obj )</span> &rArr; <code class="type">(!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;V&gt;|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;V&gt;)</code></span></div><p>Calls a function for every value in the collection and adds the result into a
+ keys/indexes and this function will return undefined in those cases.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl><tr><th>Returns<tr><td><dl>The keys in the collection.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l57">code &raquo;</a><span class="member"><a name="goog.structs.getValues">goog.structs.getValues</a> <span class="args">( col )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Returns the values of the collection-like object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl><tr><th>Returns<tr><td><dl>The values in the collection-like object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l129">code &raquo;</a><span class="member"><a name="goog.structs.isEmpty">goog.structs.isEmpty</a> <span class="args">( col )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the collection is empty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The collection-like object.</dl><tr><th>Returns<tr><td><dl>True if empty.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l260">code &raquo;</a><code class="type">&lt;T, S, V&gt;</code> <span class="member"><a name="goog.structs.map">goog.structs.map</a> <span class="args">( col, f, opt_obj )</span> &rArr; <code class="type">(!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;V&gt;|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;V&gt;)</code></span></div><p>Calls a function for every value in the collection and adds the result into a
  new collection (defaults to creating a new Array).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">S</code><dd>The collection-like object.<dt>f: <code class="type">function(this: T, ?, ?, S): V</code><dd>The function to call for every value.
      This function takes 3 arguments (the value, the key or undefined if the
      collection has no notion of keys, and the collection) and should return
      something. The result will be used as the value in the new collection.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this'
      within <code >f</code>.</dl><tr><th>Returns<tr><td><dl>A new collection with the new values.  If
      col is a key-less collection an array is returned.  If col has keys and
-     values a plain old JS object is returned.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l301">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.structs.some">goog.structs.some</a> <span class="args">( col, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls f for each value in a collection. If any call returns true this returns
+     values a plain old JS object is returned.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/structs/structs.js.src.html#l304">code &raquo;</a><code class="type">&lt;T, S&gt;</code> <span class="member"><a name="goog.structs.some">goog.structs.some</a> <span class="args">( col, f, opt_obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Calls f for each value in a collection. If any call returns true this returns
  true (without checking the rest). If all returns false this returns false.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>col: <code class="type">S</code><dd>The collection-like object.<dt>f: <code class="type">function(this: T, ?, ?, S): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>The function to call for every
      value. This function takes 3 arguments (the value, the key or undefined
      if the collection has no notion of keys, and the collection) and should
      return a boolean.<dt>opt_obj: <code class="type">T=</code><dd>The object to be used as the value of 'this'
-     within <code >f</code>.</dl><tr><th>Returns<tr><td><dl>True if any value passes the test.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+     within <code >f</code>.</dl><tr><th>Returns<tr><td><dl>True if any value passes the test.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_style.html b/docs/namespace_goog_style.html
new file mode 100644
index 0000000..0c25e81
--- /dev/null
+++ b/docs/namespace_goog_style.html
@@ -0,0 +1,211 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.style</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.style</h1><a class="source" href="source/lib/goog/style/style.js.src.html#l23">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1258">code &raquo;</a><span class="member"><a name="goog.style.clearTransparentBackgroundImage">goog.style.clearTransparentBackgroundImage</a> <span class="args">( el )</span></span></div><p>Clears the background image of an element in a browser independent manner.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to clear background image for.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1064">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="goog.style.evaluateWithTemporaryDisplay_">goog.style.evaluateWithTemporaryDisplay_</a> <span class="args">( fn, element )</span> &rArr; <code class="type">T</code></span></div><p>Call <code >fn</code> on <code >element</code> such that <code >element</code>'s dimensions are
+ accurate when it's passed to <code >fn</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function(!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>): T</code><dd>Function to call with <code >element</code> as
+     an argument after temporarily changing <code >element</code>'s display such
+     that its dimensions are accurate.<dt>element: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element (which may have display none) to use as
+     argument to <code >fn</code>.</dl><tr><th>Returns<tr><td><dl>Value returned by calling <code >fn</code> with <code >element</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l270">code &raquo;</a><span class="member"><a name="goog.style.getBackgroundColor">goog.style.getBackgroundColor</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the computed background color string for a given element. The
+ string returned is suitable for assigning to another element's
+ background-color, but is not guaranteed to be in any particular string
+ format. Accessing the color in a numeric form may not be possible in all
+ browsers or with all input.
+
+ If the background color for the element is defined as a hexadecimal value,
+ the resulting string can be parsed by goog.color.parse in all supported
+ browsers.
+
+ Whether named colors like "red" or "lightblue" get translated into a
+ format which can be parsed is browser dependent. Calling this function on
+ transparent elements will return "transparent" in most browsers or
+ "rgba(0, 0, 0, 0)" in WebKit.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the background color of.</dl><tr><th>Returns<tr><td><dl>The computed string value of the background color.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1816">code &raquo;</a><span class="member"><a name="goog.style.getBorderBox">goog.style.getBorderBox</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Gets the computed border widths (on all sides) in pixels</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the border widths for.</dl><tr><th>Returns<tr><td><dl>The computed border widths.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1552">code &raquo;</a><span class="member"><a name="goog.style.getBorderBoxSize">goog.style.getBorderBoxSize</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Gets the border box size for an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the size for.</dl><tr><th>Returns<tr><td><dl>The border box size.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l436">code &raquo;</a><span class="member"><a name="goog.style.getBoundingClientRect_">goog.style.getBoundingClientRect_</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Gets the client rectangle of the DOM element.
+
+ getBoundingClientRect is part of a new CSS object model draft (with a
+ long-time presence in IE), replacing the error-prone parent offset
+ computation and the now-deprecated Gecko getBoxObjectFor.
+
+ This utility patches common browser bugs in getBoundingClientRect. It
+ will fail if getBoundingClientRect is unsupported.
+
+ If the element is not in the DOM, the result is undefined, and an error may
+ be thrown depending on user agent.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element whose bounding rectangle is being queried.</dl><tr><th>Returns<tr><td><dl>A native bounding rectangle with numerical left, top,
+     right, and bottom.  Reported by Firefox to be of object type ClientRect.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1146">code &raquo;</a><span class="member"><a name="goog.style.getBounds">goog.style.getBounds</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Rect.html">goog.math.Rect</a></code></span></div><p>Returns a bounding rectangle for a given element in page space.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get bounds of. Must not be display none.</dl><tr><th>Returns<tr><td><dl>Bounding rectangle for the element.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1731">code &raquo;</a><span class="member"><a name="goog.style.getBox_">goog.style.getBox_</a> <span class="args">( element, stylePrefix )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Gets the computed paddings or margins (on all sides) in pixels.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the padding for.<dt>stylePrefix: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Pass 'padding' to retrieve the padding box,
+     or 'margin' to retrieve the margin box.</dl><tr><th>Returns<tr><td><dl>The computed paddings or margins.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l203">code &raquo;</a><span class="member"><a name="goog.style.getCascadedStyle">goog.style.getCascadedStyle</a> <span class="args">( element, style )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the cascaded style value of a node, or null if the value cannot be
+ computed (only Internet Explorer can do this).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get style of.<dt>style: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Property to get (camel-case).</dl><tr><th>Returns<tr><td><dl>Style value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l637">code &raquo;</a><span class="member"><a name="goog.style.getClientLeftTop">goog.style.getClientLeftTop</a> <span class="args">( el )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns clientLeft (width of the left border and, if the directionality is
+ right to left, the vertical scrollbar) and clientTop as a coordinate object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get clientLeft for.</dl><tr><th>Returns<tr><td><dl>Client left and top.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l910">code &raquo;</a><span class="member"><a name="goog.style.getClientPosition">goog.style.getClientPosition</a> <span class="args">( el )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns the position of the event or the element's border box relative to
+ the client viewport.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|Event|<a href="class_goog_events_Event.html">goog.events.Event</a>)</code><dd>Element or a mouse / touch event.</dl><tr><th>Returns<tr><td><dl>The position.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l878">code &raquo;</a><span class="member"><a name="goog.style.getClientPositionForElement_">goog.style.getClientPositionForElement_</a> <span class="args">( el )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns the position of the event or the element's border box relative to
+ the client viewport.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element whose position to get.</dl><tr><th>Returns<tr><td><dl>The position.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l385">code &raquo;</a><span class="member"><a name="goog.style.getClientViewportElement">goog.style.getClientViewportElement</a> <span class="args">( opt_node )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the viewport element for a particular document</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>=</code><dd>DOM node (Document is OK) to get the viewport element
+     of.</dl><tr><th>Returns<tr><td><dl>document.documentElement or document.body.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l235">code &raquo;</a><span class="member"><a name="goog.style.getComputedBoxSizing">goog.style.getComputedBoxSizing</a> <span class="args">( element )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the computed value of the box-sizing CSS attribute.
+ Browser support: http://caniuse.com/css3-boxsizing.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element whose box-sizing to get.</dl><tr><th>Returns<tr><td><dl>'content-box', 'border-box' or 'padding-box'. null if
+     box-sizing is not supported (IE7 and below).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l320">code &raquo;</a><span class="member"><a name="goog.style.getComputedCursor">goog.style.getComputedCursor</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the computed value of the cursor CSS attribute.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the cursor of.</dl><tr><th>Returns<tr><td><dl>The computed string value of the cursor attribute.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l280">code &raquo;</a><span class="member"><a name="goog.style.getComputedOverflowX">goog.style.getComputedOverflowX</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the computed value of the overflow-x CSS attribute.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the overflow-x of.</dl><tr><th>Returns<tr><td><dl>The computed string value of the overflow-x attribute.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l290">code &raquo;</a><span class="member"><a name="goog.style.getComputedOverflowY">goog.style.getComputedOverflowY</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the computed value of the overflow-y CSS attribute.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the overflow-y of.</dl><tr><th>Returns<tr><td><dl>The computed string value of the overflow-y attribute.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l247">code &raquo;</a><span class="member"><a name="goog.style.getComputedPosition">goog.style.getComputedPosition</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the computed value of the position CSS attribute.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the position of.</dl><tr><th>Returns<tr><td><dl>Position value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l180">code &raquo;</a><span class="member"><a name="goog.style.getComputedStyle">goog.style.getComputedStyle</a> <span class="args">( element, property )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves a computed style value of a node. It returns empty string if the
+ value cannot be computed (which will be the case in Internet Explorer) or
+ "none" if the property requested is an SVG one and it has not been
+ explicitly set (firefox and webkit).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get style of.<dt>property: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Property to get (camel-case).</dl><tr><th>Returns<tr><td><dl>Style value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l310">code &raquo;</a><span class="member"><a name="goog.style.getComputedTextAlign">goog.style.getComputedTextAlign</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the computed value of the text-align CSS attribute.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the text-align of.</dl><tr><th>Returns<tr><td><dl>The computed string value of the text-align attribute.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l330">code &raquo;</a><span class="member"><a name="goog.style.getComputedTransform">goog.style.getComputedTransform</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves the computed value of the CSS transform attribute.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the transform of.</dl><tr><th>Returns<tr><td><dl>The computed string representation of the transform matrix.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l300">code &raquo;</a><span class="member"><a name="goog.style.getComputedZIndex">goog.style.getComputedZIndex</a> <span class="args">( element )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code></span></div><p>Retrieves the computed value of the z-index CSS attribute.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the z-index of.</dl><tr><th>Returns<tr><td><dl>The computed value of the z-index attribute.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l574">code &raquo;</a><span class="member"><a name="goog.style.getContainerOffsetToScrollInto">goog.style.getContainerOffsetToScrollInto</a> <span class="args">( element, container, opt_center )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Calculate the scroll position of <code >container</code> with the minimum amount so
+ that the content and the borders of the given <code >element</code> become visible.
+ If the element is bigger than the container, its top left corner will be
+ aligned as close to the container's top left corner as possible.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to make visible.<dt>container: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The container to scroll.<dt>opt_center: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to center the element in the container.
+     Defaults to false.</dl><tr><th>Returns<tr><td><dl>The new scroll position of the container,
+     in form of goog.math.Coordinate(scrollLeft, scrollTop).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1594">code &raquo;</a><span class="member"><a name="goog.style.getContentBoxSize">goog.style.getContentBoxSize</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Gets the content box size for an element.  This is potentially expensive in
+ all browsers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the size for.</dl><tr><th>Returns<tr><td><dl>The content box size.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l2100">code &raquo;</a><span class="member"><a name="goog.style.getCssTranslation">goog.style.getCssTranslation</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns the x,y translation component of any CSS transforms applied to the
+ element, in pixels.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the translation of.</dl><tr><th>Returns<tr><td><dl>The CSS translation of the element in px.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l2044">code &raquo;</a><span class="member"><a name="goog.style.getFloat">goog.style.getFloat</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets value of explicitly-set float CSS property on an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get float property of.</dl><tr><th>Returns<tr><td><dl>The value of explicitly-set float CSS property on this
+     element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1849">code &raquo;</a><span class="member"><a name="goog.style.getFontFamily">goog.style.getFontFamily</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the font face applied to a given node. Opera and IE should return
+ the font actually displayed. Firefox returns the author's most-preferred
+ font (whether the browser is capable of displaying it or not.)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element whose font family is returned.</dl><tr><th>Returns<tr><td><dl>The font family applied to el.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1939">code &raquo;</a><span class="member"><a name="goog.style.getFontSize">goog.style.getFontSize</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the font size, in pixels, of text in an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element whose font size is returned.</dl><tr><th>Returns<tr><td><dl>The font size (in pixels).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l798">code &raquo;</a><span class="member"><a name="goog.style.getFramedPageOffset">goog.style.getFramedPageOffset</a> <span class="args">( el, relativeWin )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns a Coordinate object relative to the top-left of an HTML document
+ in an ancestor frame of this element. Used for measuring the position of
+ an element inside a frame relative to a containing frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get the page offset for.<dt>relativeWin: <code class="type">Window</code><dd>The window to measure relative to. If relativeWin
+     is not in the ancestor frame chain of the element, we measure relative to
+     the top-most window.</dl><tr><th>Returns<tr><td><dl>The page offset.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1799">code &raquo;</a><span class="member"><a name="goog.style.getIePixelBorder_">goog.style.getIePixelBorder_</a> <span class="args">( element, prop )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Helper function for IE to get the pixel border.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the pixel border for.<dt>prop: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The part of the property name.</dl><tr><th>Returns<tr><td><dl>The value in pixels.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1716">code &raquo;</a><span class="member"><a name="goog.style.getIePixelDistance_">goog.style.getIePixelDistance_</a> <span class="args">( element, propName )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Helper function for getting the pixel padding or margin for IE.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the padding for.<dt>propName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The property name.</dl><tr><th>Returns<tr><td><dl>The pixel padding.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1689">code &raquo;</a><span class="member"><a name="goog.style.getIePixelValue_">goog.style.getIePixelValue_</a> <span class="args">( element, value, name, pixelName )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>IE specific function that converts a non pixel unit to pixels.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to convert the value for.<dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The current value as a string. The value must not be
+     ''.<dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The CSS property name to use for the converstion. This
+     should be 'left', 'top', 'width' or 'height'.<dt>pixelName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The CSS pixel property name to use to get the
+     value in pixels.</dl><tr><th>Returns<tr><td><dl>The value in pixels.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1901">code &raquo;</a><span class="member"><a name="goog.style.getLengthUnits">goog.style.getLengthUnits</a> <span class="args">( value )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the units used for a CSS length measurement.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A CSS length quantity.</dl><tr><th>Returns<tr><td><dl>The units of measurement.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1775">code &raquo;</a><span class="member"><a name="goog.style.getMarginBox">goog.style.getMarginBox</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Gets the computed margins (on all sides) in pixels.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the margins for.</dl><tr><th>Returns<tr><td><dl>The computed margins.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l476">code &raquo;</a><span class="member"><a name="goog.style.getOffsetParent">goog.style.getOffsetParent</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code></span></div><p>Returns the first parent that could affect the position of a given element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the offset parent for.</dl><tr><th>Returns<tr><td><dl>The first offset parent or null if one cannot be found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1183">code &raquo;</a><span class="member"><a name="goog.style.getOpacity">goog.style.getOpacity</a> <span class="args">( el )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code></span></div><p>Gets the opacity of a node (x-browser). This gets the inline style opacity
+ of the node, and does not take into account the cascaded or the computed
+ style for this node.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element whose opacity has to be found.</dl><tr><th>Returns<tr><td><dl>Opacity between 0 and 1 or an empty string <code >&#39;&#39;</code>
+     if the opacity is not set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1765">code &raquo;</a><span class="member"><a name="goog.style.getPaddingBox">goog.style.getPaddingBox</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Gets the computed paddings (on all sides) in pixels.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to get the padding for.</dl><tr><th>Returns<tr><td><dl>The computed paddings.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l665">code &raquo;</a><span class="member"><a name="goog.style.getPageOffset">goog.style.getPageOffset</a> <span class="args">( el )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns a Coordinate object relative to the top-left of the HTML document.
+ Implemented as a single function to save having to do two recursive loops in
+ opera and safari just to get both coordinates.  If you just want one value do
+ use goog.style.getPageOffsetLeft() and goog.style.getPageOffsetTop(), but
+ note if you call both those methods the tree will be analysed twice.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get the page offset for.</dl><tr><th>Returns<tr><td><dl>The page offset.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l772">code &raquo;</a><span class="member"><a name="goog.style.getPageOffsetLeft">goog.style.getPageOffsetLeft</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the left coordinate of an element relative to the HTML document</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Elements.</dl><tr><th>Returns<tr><td><dl>The left coordinate.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l782">code &raquo;</a><span class="member"><a name="goog.style.getPageOffsetTop">goog.style.getPageOffsetTop</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the top coordinate of an element relative to the HTML document</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Elements.</dl><tr><th>Returns<tr><td><dl>The top coordinate.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1004">code &raquo;</a><span class="member"><a name="goog.style.getPixelStyleValue_">goog.style.getPixelStyleValue_</a> <span class="args">( value, round )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Helper function to create a string to be set into a pixel-value style
+ property of an element. Can round to the nearest integer value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The style value to be used. If a number,
+     'px' will be appended, otherwise the value will be applied directly.<dt>round: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether to round the nearest integer (if property
+     is a number).</dl><tr><th>Returns<tr><td><dl>The string value for the property.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l374">code &raquo;</a><span class="member"><a name="goog.style.getPosition">goog.style.getPosition</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Gets the offsetLeft and offsetTop properties of an element and returns them
+ in a Coordinate object</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element.</dl><tr><th>Returns<tr><td><dl>The position.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l864">code &raquo;</a><span class="member"><a name="goog.style.getRelativePosition">goog.style.getRelativePosition</a> <span class="args">( a, b )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Returns the position of an element relative to another element in the
+ document.  A relative to B</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>a: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|Event|<a href="class_goog_events_Event.html">goog.events.Event</a>)</code><dd>Element or mouse event whose
+     position we're calculating.<dt>b: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|Event|<a href="class_goog_events_Event.html">goog.events.Event</a>)</code><dd>Element or mouse event position
+     is relative to.</dl><tr><th>Returns<tr><td><dl>The relative position.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l2058">code &raquo;</a><span class="member"><a name="goog.style.getScrollbarWidth">goog.style.getScrollbarWidth</a> <span class="args">( opt_className )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Returns the scroll bar width (represents the width of both horizontal
+ and vertical scroll).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>An optional class name (or names) to apply
+     to the invisible div created to measure the scrollbar. This is necessary
+     if some scrollbars are styled differently than others.</dl><tr><th>Returns<tr><td><dl>The scroll bar width in px.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1046">code &raquo;</a><span class="member"><a name="goog.style.getSize">goog.style.getSize</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Gets the height and width of an element, even if its display is none.
+
+ Specifically, this returns the height and width of the border box,
+ irrespective of the box model in effect.
+
+ Note that this function does not take CSS transforms into account. Please see
+ <code >goog.style.getTransformedSize</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get size of.</dl><tr><th>Returns<tr><td><dl>Object with width/height properties.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1094">code &raquo;</a><span class="member"><a name="goog.style.getSizeWithDisplay_">goog.style.getSizeWithDisplay_</a> <span class="args">( element )</span> &rArr; <code class="type">!<a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Gets the height and width of an element when the display is not none.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get size of.</dl><tr><th>Returns<tr><td><dl>Object with width/height properties.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l152">code &raquo;</a><span class="member"><a name="goog.style.getStyle">goog.style.getStyle</a> <span class="args">( element, property )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Retrieves an explicitly-set style value of a node. This returns '' if there
+ isn't a style attribute on the element or if this style property has not been
+ explicitly set in script.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get style of.<dt>property: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Property to get, css-style (if you have a camel-case
+ property, use element.style[style]).</dl><tr><th>Returns<tr><td><dl>Style value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l221">code &raquo;</a><span class="member"><a name="goog.style.getStyle_">goog.style.getStyle_</a> <span class="args">( element, style )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Cross-browser pseudo get computed style. It returns the computed style where
+ available. If not available it tries the cascaded style value (IE
+ currentStyle) and in worst case the inline style value.  It shouldn't be
+ called directly, see http://wiki/Main/ComputedStyleVsCascadedStyle for
+ discussion.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get style of.<dt>style: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Property to get (must be camelCase, not css-style.).</dl><tr><th>Returns<tr><td><dl>Style value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1129">code &raquo;</a><span class="member"><a name="goog.style.getTransformedSize">goog.style.getTransformedSize</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="class_goog_math_Size.html">goog.math.Size</a></code></span></div><p>Gets the height and width of an element, post transform, even if its display
+ is none.
+
+ This is like <code >goog.style.getSize</code>, except:
+ <ol>
+ <li>Takes webkitTransforms such as rotate and scale into account.
+ <li>Will return null if <code >element</code> doesn't respond to
+     <code >getBoundingClientRect</code>.
+ <li>Currently doesn't make sense on non-WebKit browsers which don't support
+    webkitTransforms.
+ </ol></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get size of.</dl><tr><th>Returns<tr><td><dl>Object with width/height properties.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l101">code &raquo;</a><span class="member"><a name="goog.style.getVendorJsStyleName_">goog.style.getVendorJsStyleName_</a> <span class="args">( element, style )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the style property name in camel-case. If it does not exist and a
+ vendor-specific version of the property does exist, then return the vendor-
+ specific property name instead.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to change.<dt>style: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Style name.</dl><tr><th>Returns<tr><td><dl>Vendor-specific style.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l126">code &raquo;</a><span class="member"><a name="goog.style.getVendorStyleName_">goog.style.getVendorStyleName_</a> <span class="args">( element, style )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the style property name in CSS notation. If it does not exist and a
+ vendor-specific version of the property does exist, then return the vendor-
+ specific property name instead.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to change.<dt>style: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Style name.</dl><tr><th>Returns<tr><td><dl>Vendor-specific style.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l409">code &raquo;</a><span class="member"><a name="goog.style.getViewportPageOffset">goog.style.getViewportPageOffset</a> <span class="args">( doc )</span> &rArr; <code class="type">!<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a></code></span></div><p>Calculates the viewport coordinates relative to the page/document
+ containing the node. The viewport may be the browser viewport for
+ non-iframe document, or the iframe container for iframe'd document.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>doc: <code class="type">!<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#i-Document">Document</a></code><dd>The document to use as the reference point.</dl><tr><th>Returns<tr><td><dl>The page offset of the viewport.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l514">code &raquo;</a><span class="member"><a name="goog.style.getVisibleRectForElement">goog.style.getVisibleRectForElement</a> <span class="args">( element )</span> &rArr; <code class="type"><a href="class_goog_math_Box.html">goog.math.Box</a></code></span></div><p>Calculates and returns the visible rectangle for a given element. Returns a
+ box describing the visible portion of the nearest scrollable offset ancestor.
+ Coordinates are given relative to the document.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to get the visible rect for.</dl><tr><th>Returns<tr><td><dl>Bounding elementBox describing the visible rect or
+     null if scrollable ancestor isn't inside the visible viewport.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1347">code &raquo;</a><span class="member"><a name="goog.style.installStyles">goog.style.installStyles</a> <span class="args">( stylesString, opt_node )</span> &rArr; <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="http://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-StyleSheet">StyleSheet</a>)</code></span></div><p>Installs the styles string into the window that contains opt_element.  If
+ opt_element is null, the main window is used.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>stylesString: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The style string to install.<dt>opt_node: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-1950641247">Node</a>=</code><dd>Node whose parent document should have the
+     styles installed.</dl><tr><th>Returns<tr><td><dl>The style element created.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1334">code &raquo;</a><span class="member"><a name="goog.style.isElementShown">goog.style.isElementShown</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Test whether the given element has been shown or hidden via a call to
+ <code  class="type"><a class="unresolved-link">#setElementShown</a></code>.
+
+ Note this is strictly a companion method for a call
+ to <code  class="type"><a class="unresolved-link">#setElementShown</a></code> and the same caveats apply; in particular, this
+ method does not guarantee that the return value will be consistent with
+ whether or not the element is actually visible.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to test.</dl><tr><th>Returns<tr><td><dl>Whether the element has been shown.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1473">code &raquo;</a><span class="member"><a name="goog.style.isRightToLeft">goog.style.isRightToLeft</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element is using right to left (rtl) direction.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to test.</dl><tr><th>Returns<tr><td><dl>True for right to left, false for left to right.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1499">code &raquo;</a><span class="member"><a name="goog.style.isUnselectable">goog.style.isUnselectable</a> <span class="args">( el )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Returns true if the element is set to be unselectable, false otherwise.
+ Note that on some platforms (e.g. Mozilla), even if an element isn't set
+ to be unselectable, it will behave as such if any of its ancestors is
+ unselectable.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to check.</dl><tr><th>Returns<tr><td><dl>Whether the element is set to be unselectable.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l2000">code &raquo;</a><span class="member"><a name="goog.style.parseStyleAttribute">goog.style.parseStyleAttribute</a> <span class="args">( value )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Parses a style attribute value.  Converts CSS property names to camel case.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The style attribute value.</dl><tr><th>Returns<tr><td><dl>Map of CSS properties to string values.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l622">code &raquo;</a><span class="member"><a name="goog.style.scrollIntoContainerView">goog.style.scrollIntoContainerView</a> <span class="args">( element, container, opt_center )</span></span></div><p>Changes the scroll position of <code >container</code> with the minimum amount so
+ that the content and the borders of the given <code >element</code> become visible.
+ If the element is bigger than the container, its top left corner will be
+ aligned as close to the container's top left corner as possible.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to make visible.<dt>container: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The container to scroll.<dt>opt_center: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to center the element in the container.
+     Defaults to false.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1563">code &raquo;</a><span class="member"><a name="goog.style.setBorderBoxSize">goog.style.setBorderBoxSize</a> <span class="args">( element, size )</span></span></div><p>Sets the border box size of an element. This is potentially expensive in IE
+ if the document is CSS1Compat mode</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to set the size on.<dt>size: <code class="type"><a href="class_goog_math_Size.html">goog.math.Size</a></code><dd>The new size.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1659">code &raquo;</a><span class="member"><a name="goog.style.setBoxSizingSize_">goog.style.setBoxSizingSize_</a> <span class="args">( element, size, boxSizing )</span></span></div><p>Helper function that sets the box sizing as well as the width and height</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to set the size on.<dt>size: <code class="type"><a href="class_goog_math_Size.html">goog.math.Size</a></code><dd>The new size to set.<dt>boxSizing: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The box-sizing value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1628">code &raquo;</a><span class="member"><a name="goog.style.setContentBoxSize">goog.style.setContentBoxSize</a> <span class="args">( element, size )</span></span></div><p>Sets the content box size of an element. This is potentially expensive in IE
+ if the document is BackCompat mode.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to set the size on.<dt>size: <code class="type"><a href="class_goog_math_Size.html">goog.math.Size</a></code><dd>The new size.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1316">code &raquo;</a><span class="member"><a name="goog.style.setElementShown">goog.style.setElementShown</a> <span class="args">( el, isShown )</span></span></div><p>Shows or hides an element from the page. Hiding the element is done by
+ setting the display property to "none", removing the element from the
+ rendering hierarchy so it takes up no space. To show the element, the default
+ inherited display property is restored (defined either in stylesheets or by
+ the browser's default style rules).
+
+ Caveat 1: if the inherited display property for the element is set to "none"
+ by the stylesheets, that is the property that will be restored by a call to
+ setElementShown(), effectively toggling the display between "none" and
+ "none".
+
+ Caveat 2: if the element display style is set inline (by setting either
+ element.style.display or a style attribute in the HTML), a call to
+ setElementShown will clear that setting and defer to the inherited style in
+ the stylesheet.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to show or hide.<dt>isShown: <code class="type">*</code><dd>True to render the element in its default style,
+     false to disable rendering the element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l2033">code &raquo;</a><span class="member"><a name="goog.style.setFloat">goog.style.setFloat</a> <span class="args">( el, value )</span></span></div><p>Sets CSS float property on an element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to set float property on.<dt>value: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The value of float CSS property to set on this element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1019">code &raquo;</a><span class="member"><a name="goog.style.setHeight">goog.style.setHeight</a> <span class="args">( element, height )</span></span></div><p>Set the height of an element.  Sets the element's style property.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to set the height of.<dt>height: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The height value to set.  If a number, 'px'
+     will be appended, otherwise the value will be applied directly.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1445">code &raquo;</a><span class="member"><a name="goog.style.setInlineBlock">goog.style.setInlineBlock</a> <span class="args">( el )</span></span></div><p>Sets 'display: inline-block' for an element (cross-browser).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to which the inline-block display style is to be
+    applied.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1206">code &raquo;</a><span class="member"><a name="goog.style.setOpacity">goog.style.setOpacity</a> <span class="args">( el, alpha )</span></span></div><p>Sets the opacity of a node (x-browser).</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Elements whose opacity has to be set.<dt>alpha: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>Opacity between 0 and 1 or an empty string
+     <code >&#39;&#39;</code> to clear the opacity.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l942">code &raquo;</a><span class="member"><a name="goog.style.setPageOffset">goog.style.setPageOffset</a> <span class="args">( el, x, opt_y )</span></span></div><p>Moves an element to the given coordinates relative to the client viewport.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Absolutely positioned element to set page offset for.
+     It must be in the document.<dt>x: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>)</code><dd>Left position of the element's margin
+     box or a coordinate object.<dt>opt_y: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Top position of the element's margin box.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l346">code &raquo;</a><span class="member"><a name="goog.style.setPosition">goog.style.setPosition</a> <span class="args">( el, arg1, opt_arg2 )</span></span></div><p>Sets the top/left values of an element.  If no unit is specified in the
+ argument then it will add px. The second argument is required if the first
+ argument is a string or number and is ignored if the first argument
+ is a coordinate.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to move.<dt>arg1: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>)</code><dd>Left position or coordinate.<dt>opt_arg2: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd>Top position.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1425">code &raquo;</a><span class="member"><a name="goog.style.setPreWrap">goog.style.setPreWrap</a> <span class="args">( el )</span></span></div><p>Sets 'white-space: pre-wrap' for a node (x-browser).
+
+ There are as many ways of specifying pre-wrap as there are browsers.
+
+ CSS3/IE8: white-space: pre-wrap;
+ Mozilla:  white-space: -moz-pre-wrap;
+ Opera:    white-space: -o-pre-wrap;
+ IE6/7:    white-space: pre; word-wrap: break-word;</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to enable pre-wrap for.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l976">code &raquo;</a><span class="member"><a name="goog.style.setSize">goog.style.setSize</a> <span class="args">( element, w, opt_h )</span></span></div><p>Sets the width/height values of an element.  If an argument is numeric,
+ or a goog.math.Size is passed, it is assumed to be pixels and will add
+ 'px' after converting it to an integer in string form. (This just sets the
+ CSS width and height properties so it might set content-box or border-box
+ size depending on the box model the browser is using.)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to set the size of.<dt>w: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_goog_math_Size.html">goog.math.Size</a>)</code><dd>Width of the element, or a
+     size object.<dt>opt_h: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)=</code><dd>Height of the element. Required if w is not a
+     size object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l63">code &raquo;</a><span class="member"><a name="goog.style.setStyle">goog.style.setStyle</a> <span class="args">( element, style, opt_value )</span></span></div><p>Sets a style value on an element.
+
+ This function is not indended to patch issues in the browser's style
+ handling, but to allow easy programmatic access to setting dash-separated
+ style properties.  An example is setting a batch of properties from a data
+ object without overwriting old styles.  When possible, use native APIs:
+ elem.style.propertyKey = 'value' or (if obliterating old styles is fine)
+ elem.style.cssText = 'property1: value1; property2: value2'.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to change.<dt>style: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>If a string, a style name. If an object, a hash
+     of style names to style values.<dt>opt_value: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>)=</code><dd>If style was a string, then this
+     should be the value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l83">code &raquo;</a><span class="member"><a name="goog.style.setStyle_">goog.style.setStyle_</a> <span class="args">( element, value, style )</span></span></div><p>Sets a style value on an element, with parameters swapped to work with
+ <code >goog.object.forEach()</code>. Prepends a vendor-specific prefix when
+ necessary.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to change.<dt>value: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code><dd>Style value.<dt>style: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Style name.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1399">code &raquo;</a><span class="member"><a name="goog.style.setStyles">goog.style.setStyles</a> <span class="args">( element, stylesString )</span></span></div><p>Sets the content of a style element.  The style element can be any valid
+ style element.  This element will have its content completely replaced by
+ the new stylesString.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="http://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-StyleSheet">StyleSheet</a>)</code><dd>A stylesheet element as returned by
+     installStyles.<dt>stylesString: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The new content of the stylesheet.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1235">code &raquo;</a><span class="member"><a name="goog.style.setTransparentBackgroundImage">goog.style.setTransparentBackgroundImage</a> <span class="args">( el, src )</span></span></div><p>Sets the background of an element to a transparent image in a browser-
+ independent manner.
+
+ This function does not support repeating backgrounds or alternate background
+ positions to match the behavior of Internet Explorer. It also does not
+ support sizingMethods other than crop since they cannot be replicated in
+ browsers other than Internet Explorer.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to set background on.<dt>src: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The image source URL.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1520">code &raquo;</a><span class="member"><a name="goog.style.setUnselectable">goog.style.setUnselectable</a> <span class="args">( el, unselectable, opt_noRecurse )</span></span></div><p>Makes the element and its descendants selectable or unselectable.  Note
+ that on some platforms (e.g. Mozilla), even if an element isn't set to
+ be unselectable, it will behave as such if any of its ancestors is
+ unselectable.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>The element to alter.<dt>unselectable: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd>Whether the element and its descendants
+     should be made unselectable.<dt>opt_noRecurse: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>Whether to only alter the element's own
+     selectable state, and leave its descendants alone; defaults to false.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1030">code &raquo;</a><span class="member"><a name="goog.style.setWidth">goog.style.setWidth</a> <span class="args">( element, width )</span></span></div><p>Set the width of an element.  Sets the element's style property.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>element: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to set the width of.<dt>width: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The width value to set.  If a number, 'px'
+     will be appended, otherwise the value will be applied directly.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1291">code &raquo;</a><span class="member deprecation-notice"><a name="goog.style.showElement">goog.style.showElement</a> <span class="args">( el, display )</span></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.style.setElementShown instead.</span></div><p>Shows or hides an element from the page. Hiding the element is done by
+ setting the display property to "none", removing the element from the
+ rendering hierarchy so it takes up no space. To show the element, the default
+ inherited display property is restored (defined either in stylesheets or by
+ the browser's default style rules.)
+
+ Caveat 1: if the inherited display property for the element is set to "none"
+ by the stylesheets, that is the property that will be restored by a call to
+ showElement(), effectively toggling the display between "none" and "none".
+
+ Caveat 2: if the element display style is set inline (by setting either
+ element.style.display or a style attribute in the HTML), a call to
+ showElement will clear that setting and defer to the inherited style in the
+ stylesheet.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>el: <code class="type"><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a></code><dd>Element to show or hide.<dt>display: <code class="type">*</code><dd>True to render the element in its default style,
+     false to disable rendering the element.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1159">code &raquo;</a><span class="member deprecation-notice"><a name="goog.style.toCamelCase">goog.style.toCamelCase</a> <span class="args">( selector )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.string.toCamelCase instead.</span></div><p>Converts a CSS selector in the form style-property to styleProperty.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>selector: <code class="type">*</code><dd>CSS Selector.</dl><tr><th>Returns<tr><td><dl>Camel case selector.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1170">code &raquo;</a><span class="member deprecation-notice"><a name="goog.style.toSelectorCase">goog.style.toSelectorCase</a> <span class="args">( selector )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.string.toSelectorCase instead.</span></div><p>Converts a CSS selector in the form styleProperty to style-property.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>selector: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Camel case selector.</dl><tr><th>Returns<tr><td><dl>Selector cased.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l2019">code &raquo;</a><span class="member"><a name="goog.style.toStyleAttribute">goog.style.toStyleAttribute</a> <span class="args">( obj )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Reverse of parseStyleAttribute; that is, takes a style object and returns the
+ corresponding attribute value.  Converts camel case property names to proper
+ CSS selector names.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>Map of CSS properties to values.</dl><tr><th>Returns<tr><td><dl>The style attribute value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l836">code &raquo;</a><span class="member"><a name="goog.style.translateRectForAnotherFrame">goog.style.translateRectForAnotherFrame</a> <span class="args">( rect, origBase, newBase )</span></span></div><p>Translates the specified rect relative to origBase page, for newBase page.
+ If origBase and newBase are the same, this function does nothing.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>rect: <code class="type"><a href="class_goog_math_Rect.html">goog.math.Rect</a></code><dd>The source rectangle relative to origBase page,
+     and it will have the translated result.<dt>origBase: <code class="type"><a href="class_goog_dom_DomHelper.html">goog.dom.DomHelper</a></code><dd>The DomHelper for the input rectangle.<dt>newBase: <code class="type"><a href="class_goog_dom_DomHelper.html">goog.dom.DomHelper</a></code><dd>The DomHelper for the resultant
+     coordinate.  This must be a DOM for an ancestor frame of origBase
+     or the same as origBase.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1384">code &raquo;</a><span class="member"><a name="goog.style.uninstallStyles">goog.style.uninstallStyles</a> <span class="args">( styleSheet )</span></span></div><p>Removes the styles added by <code  class="type"><a class="unresolved-link">#installStyles</a></code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>styleSheet: <code class="type">(<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-745549614">Element</a>|<a href="http://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-StyleSheet">StyleSheet</a>)</code><dd>The value returned by
+     <code  class="type"><a class="unresolved-link">#installStyles</a></code>.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1912">code &raquo;</a><span class="member"><a name="goog.style.ABSOLUTE_CSS_LENGTH_UNITS_">goog.style.ABSOLUTE_CSS_LENGTH_UNITS_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of absolute CSS length units</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1928">code &raquo;</a><span class="member"><a name="goog.style.CONVERTIBLE_RELATIVE_CSS_UNITS_">goog.style.CONVERTIBLE_RELATIVE_CSS_UNITS_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>Map of relative CSS length units that can be accurately converted to px
+ font-size values using getIePixelValue_. Only units that are defined in
+ relation to a font size are convertible (%, small, etc. are not).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l2087">code &raquo;</a><span class="member"><a name="goog.style.MATRIX_TRANSLATION_REGEX_">goog.style.MATRIX_TRANSLATION_REGEX_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression to extract x and y translation components from a CSS
+ transform Matrix representation.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1785">code &raquo;</a><span class="member"><a name="goog.style.ieBorderWidthKeywords_">goog.style.ieBorderWidthKeywords_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>A map used to map the border width keywords to a pixel width.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1893">code &raquo;</a><span class="member"><a name="goog.style.lengthUnitRegex_">goog.style.lengthUnitRegex_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression used for getLengthUnits.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l1485">code &raquo;</a><span class="member"><a name="goog.style.unselectableStyle_">goog.style.unselectableStyle_</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The CSS style property corresponding to an element being
+ unselectable on the current browser platform (null if none).
+ Opera and IE instead use a DOM attribute 'unselectable'.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/style/style.js.src.html#l44">code &raquo;</a><span class="member"><a name="goog.style.GET_BOUNDING_CLIENT_RECT_ALWAYS_EXISTS">goog.style.GET_BOUNDING_CLIENT_RECT_ALWAYS_EXISTS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_testing.html b/docs/namespace_goog_testing.html
new file mode 100644
index 0000000..f20920e
--- /dev/null
+++ b/docs/namespace_goog_testing.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.testing</h1><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l20">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a><dd>No Description.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_testing_AsyncTestCase.html">goog.testing.AsyncTestCase</a><dd>A test case that is capable of running tests the contain asynchronous logic.<dt><a href="class_goog_testing_FunctionCall.html">goog.testing.FunctionCall</a><dd>Struct for a single function call.<dt><a href="class_goog_testing_JsUnitException.html">goog.testing.JsUnitException</a><dd>No Description.<dt><a href="class_goog_testing_LooseExpectationCollection.html">goog.testing.LooseExpectationCollection</a><dd>This class is an ordered collection of expectations for one method.<dt><a href="class_goog_testing_LooseMock.html">goog.testing.LooseMock</a><dd>This is a mock that does not care about the order of method calls.<dt><a href="class_goog_testing_Mock.html">goog.testing.Mock</a><dd>The base class for a mock object.<dt><a href="class_goog_testing_MockClock.html">goog.testing.MockClock</a><dd>Class for unit testing code that uses setTimeout and clearTimeout.<dt><a href="class_goog_testing_MockControl.html">goog.testing.MockControl</a><dd>Controls a set of mocks.<dt><a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a><dd>This is a class that represents an expectation.<dt><a href="class_goog_testing_ObjectPropertyString.html">goog.testing.ObjectPropertyString</a><dd>Object to pass a property name as a string literal and its containing object
+ when the JSCompiler is rewriting these names.<dt><a href="class_goog_testing_PropertyReplacer.html">goog.testing.PropertyReplacer</a><dd>Helper class for stubbing out variables and object properties for unit tests.<dt><a href="class_goog_testing_StrictMock.html">goog.testing.StrictMock</a><dd>This is a mock that verifies that methods are called in the order that they
+ are specified during the recording phase.<dt><a href="class_goog_testing_TestCase.html">goog.testing.TestCase</a><dd>A class representing a JsUnit test case.<dt><a href="class_goog_testing_TestRunner.html">goog.testing.TestRunner</a><dd>Construct a test runner.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l46">code &raquo;</a><span class="member"><a name="goog.testing.FunctionMock">goog.testing.FunctionMock</a> <span class="args">( opt_functionName, opt_strictness )</span> &rArr; <code class="type"><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Class used to mock a function. Useful for mocking closures and anonymous
+ callbacks etc. Creates a function object that extends goog.testing.Mock.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The optional name of the function to mock.
+     Set to '[anonymous mocked function]' if not passed in.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l101">code &raquo;</a><span class="member"><a name="goog.testing.GlobalFunctionMock">goog.testing.GlobalFunctionMock</a> <span class="args">( functionName, opt_strictness )</span> &rArr; <code class="type">!<a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Mocks a global / top-level function. Creates a goog.testing.MethodMock
+ in the global scope with the name specified by functionName.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function we're going to mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked global function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l69">code &raquo;</a><span class="member"><a name="goog.testing.MethodMock">goog.testing.MethodMock</a> <span class="args">( scope, functionName, opt_strictness )</span> &rArr; <code class="type">!<a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Mocks an existing function. Creates a goog.testing.FunctionMock
+ and registers it in the given scope with the name specified by functionName.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The scope of the method to be mocked out.<dt>functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function we're going to mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked method.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l147">code &raquo;</a><span class="member"><a name="goog.testing.createConstructorMock">goog.testing.createConstructorMock</a> <span class="args">( scope, constructorName, opt_strictness )</span> &rArr; <code class="type">!<a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Convenience method for creating a mock for a constructor. Copies class
+ members to the mock.
+
+ <p>When mocking a constructor to return a mocked instance, remember to create
+ the instance mock before mocking the constructor. If you mock the constructor
+ first, then the mock framework will be unable to examine the prototype chain
+ when creating the mock instance.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The scope of the constructor to be mocked out.<dt>constructorName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the constructor we're going to
+     mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked constructor.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l114">code &raquo;</a><span class="member"><a name="goog.testing.createFunctionMock">goog.testing.createFunctionMock</a> <span class="args">( opt_functionName, opt_strictness )</span> &rArr; <code class="type"><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Convenience method for creating a mock for a function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The optional name of the function to mock
+     set to '[anonymous mocked function]' if not passed in.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l175">code &raquo;</a><span class="member"><a name="goog.testing.createGlobalFunctionMock">goog.testing.createGlobalFunctionMock</a> <span class="args">( functionName, opt_strictness )</span> &rArr; <code class="type"><a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Convenience method for creating a mocks for a global / top-level function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function we're going to mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked global function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l127">code &raquo;</a><span class="member"><a name="goog.testing.createMethodMock">goog.testing.createMethodMock</a> <span class="args">( scope, functionName, opt_strictness )</span> &rArr; <code class="type">!<a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><p>Convenience method for creating a mock for a method.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The scope of the method to be mocked out.<dt>functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function we're going to mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked global function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l140">code &raquo;</a><span class="member"><a name="goog.testing.recordConstructor">goog.testing.recordConstructor</a> <span class="args">( ctor )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Same as <code  class="type"><a href="namespace_goog_testing_recordFunction.html">goog.testing.recordFunction</a></code> but the recorded function will
+ have the same prototype and static fields as the original one. It can be
+ used with constructors.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ctor: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to wrap and record.</dl><tr><th>Returns<tr><td><dl>The wrapped function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/recordfunction.js.src.html#l61">code &raquo;</a><span class="member"><a name="goog.testing.recordFunction">goog.testing.recordFunction</a> <span class="args">( opt_f )</span> &rArr; <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code></span></div><p>Wraps the function into another one which calls the inner function and
+ records its calls. The recorded function will have 3 static methods:
+ <code >getCallCount</code>, <code >getCalls</code> and <code >getLastCall</code> but won't
+ inherit the original function's prototype and static fields.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_f: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to wrap and record. Defaults to
+     <code  class="type"><a href="namespace_goog.html#goog.nullFunction">goog.nullFunction</a></code>.</dl><tr><th>Returns<tr><td><dl>The wrapped function.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_testing_MethodMock.html b/docs/namespace_goog_testing_MethodMock.html
new file mode 100644
index 0000000..6cc86c6
--- /dev/null
+++ b/docs/namespace_goog_testing_MethodMock.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.MethodMock</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.testing.MethodMock</h1><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l69">code &raquo;</a></header><section><p>Mocks an existing function. Creates a goog.testing.FunctionMock
+ and registers it in the given scope with the name specified by functionName.<h2>Main</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">MethodMock <span class="args">( scope, functionName, opt_strictness )</span> &rArr; <code class="type">!<a href="interface_goog_testing_MockInterface.html">goog.testing.MockInterface</a></code></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>scope: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The scope of the method to be mocked out.<dt>functionName: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name of the function we're going to mock.<dt>opt_strictness: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>One of goog.testing.Mock.LOOSE or
+     goog.testing.Mock.STRICT. The default is STRICT.</dl><tr><th>Returns<tr><td><dl>The mocked method.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/functionmock.js.src.html#l88">code &raquo;</a><span class="member"><a name="goog.testing.MethodMock.$tearDown">goog.testing.MethodMock.$tearDown</a> <span class="args">( )</span></span></div><p>Resets the global function that we mocked back to its original state.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_testing_asserts.html b/docs/namespace_goog_testing_asserts.html
new file mode 100644
index 0000000..7eeb88e
--- /dev/null
+++ b/docs/namespace_goog_testing_asserts.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.asserts</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.testing.asserts</h1><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l15">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l26">code &raquo;</a><a class="member" name="goog.testing.asserts.ArrayLike">goog.testing.asserts.ArrayLike</a> : <code class="type">(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html#ID-536297177">NodeList</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments">Arguments</a>|{length: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>})</code></div><div>No description.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l493">code &raquo;</a><span class="member"><a name="goog.testing.asserts.callWithoutLogging">goog.testing.asserts.callWithoutLogging</a> <span class="args">( fn )</span></span></div><p>Runs a function in an environment where test failures are not logged. This is
+ useful for testing test code, where failures can be a normal part of a test.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function(): void</code><dd>Function to run without logging failures.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1145">code &raquo;</a><span class="member"><a name="goog.testing.asserts.contains_">goog.testing.asserts.contains_</a> <span class="args">( container, contained )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tells whether the array contains the given element.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>container: <code class="type"><a href="namespace_goog_testing_asserts.html#goog.testing.asserts.ArrayLike">goog.testing.asserts.ArrayLike</a></code><dd>The array to
+     find the element in.<dt>contained: <code class="type">*</code><dd>Element to find.</dl><tr><th>Returns<tr><td><dl>Whether the element is in the array.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l538">code &raquo;</a><span class="member"><a name="goog.testing.asserts.findDifferences">goog.testing.asserts.findDifferences</a> <span class="args">( expected, actual, opt_equalityPredicate )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Determines if two items of any type match, and formulates an error message
+ if not.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expected: <code class="type">*</code><dd>Expected argument to match.<dt>actual: <code class="type">*</code><dd>Argument as a result of performing the test.<dt>opt_equalityPredicate: <code class="type">(function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, *, *): ?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)=</code><dd>An optional
+     function that can be used to check equality of variables. It accepts 3
+     arguments: type-of-variables, var1, var2 (in that order) and returns an
+     error message if the variables are not equal,
+     goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL if the variables
+     are equal, or
+     goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS if the predicate
+     couldn't check the input variables. The function will be called only if
+     the types of var1 and var2 are identical.</dl><tr><th>Returns<tr><td><dl>Null on success, error message on failure.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l186">code &raquo;</a><span class="member"><a name="goog.testing.asserts.getDefaultErrorMsg_">goog.testing.asserts.getDefaultErrorMsg_</a> <span class="args">( expected, actual )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expected: <code class="type">*</code><dd>The expected value.<dt>actual: <code class="type">*</code><dd>The actual value.</dl><tr><th>Returns<tr><td><dl>A failure message of the values don't match.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1122">code &raquo;</a><span class="member"><a name="goog.testing.asserts.indexOf_">goog.testing.asserts.indexOf_</a> <span class="args">( container, contained )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Finds the position of the first occurrence of an element in a container.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>container: <code class="type"><a href="namespace_goog_testing_asserts.html#goog.testing.asserts.ArrayLike">goog.testing.asserts.ArrayLike</a></code><dd>The array to find the element in.<dt>contained: <code class="type">*</code><dd>Element to find.</dl><tr><th>Returns<tr><td><dl>Index of the first occurrence or -1 if not found.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1192">code &raquo;</a><span class="member"><a name="goog.testing.asserts.isArrayIndexProp_">goog.testing.asserts.isArrayIndexProp_</a> <span class="args">( prop )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Helper function for assertObjectEquals.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>prop: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A property name.</dl><tr><th>Returns<tr><td><dl>If the property name is an array index.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l57">code &raquo;</a><span class="member"><a name="goog.testing.asserts.numberRoughEqualityPredicate_">goog.testing.asserts.numberRoughEqualityPredicate_</a> <span class="args">( var1, var2, tolerance )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Compares equality of two numbers, allowing them to differ up to a given
+ tolerance.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>var1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A number.<dt>var2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>A number.<dt>tolerance: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>the maximum allowed difference.</dl><tr><th>Returns<tr><td><dl>Whether the two variables are sufficiently close.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1181">code &raquo;</a><span class="member"><a name="goog.testing.asserts.raiseException">goog.testing.asserts.raiseException</a> <span class="args">( comment, opt_message )</span></span></div><p>Raises a JsUnit exception with the given comment.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>comment: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A summary for the exception.<dt>opt_message: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>A description of the exception.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l1105">code &raquo;</a><span class="member"><a name="goog.testing.asserts.toArray_">goog.testing.asserts.toArray_</a> <span class="args">( arrayLike )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Converts an array like object to array or clones it if it's already array.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arrayLike: <code class="type"><a href="namespace_goog_testing_asserts.html#goog.testing.asserts.ArrayLike">goog.testing.asserts.ArrayLike</a></code><dd>The collection.</dl><tr><th>Returns<tr><td><dl>Copy of the collection as array.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l511">code &raquo;</a><span class="member"><a name="goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS">goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The return value of the equality predicate passed to findDifferences below,
+ in cases where the predicate can't test the input variables for equality.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l519">code &raquo;</a><span class="member"><a name="goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL">goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL</a> : <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The return value of the equality predicate passed to findDifferences below,
+ in cases where the input vriables are equal.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/asserts.js.src.html#l67">code &raquo;</a><span class="member"><a name="goog.testing.asserts.primitiveRoughEqualityPredicates_">goog.testing.asserts.primitiveRoughEqualityPredicates_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_testing_events.html b/docs/namespace_goog_testing_events.html
new file mode 100644
index 0000000..930c01f
--- /dev/null
+++ b/docs/namespace_goog_testing_events.html
@@ -0,0 +1,80 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.events</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.testing.events</h1><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l35">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_testing_events_Event.html">goog.testing.events.Event</a><dd>goog.events.BrowserEvent expects an Event so we provide one for JSCompiler.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l121">code &raquo;</a><span class="member"><a name="goog.testing.events.assertEventTarget_">goog.testing.events.assertEventTarget_</a> <span class="args">( target )</span> &rArr; <code class="type">!EventTarget</code></span></div><p>Asserts an event target exists.  This will fail if target is not defined.
+
+ TODO(nnaze): Gradually add this to the methods in this file, and eventually
+     update the method signatures to not take nullables.  See http://b/8961907</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>A target to assert.</dl><tr><th>Returns<tr><td><dl>The target, guaranteed to exist.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l555">code &raquo;</a><span class="member"><a name="goog.testing.events.fireBlurEvent">goog.testing.events.fireBlurEvent</a> <span class="args">( target )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulate a blur event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.</dl><tr><th>Returns<tr><td><dl>The value returned by firing the blur browser event,
+      which returns false iff 'preventDefault' was invoked.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l583">code &raquo;</a><span class="member"><a name="goog.testing.events.fireBrowserEvent">goog.testing.events.fireBrowserEvent</a> <span class="args">( event )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates an event's capturing and bubbling phases.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>event: <code class="type">Event</code><dd>A simulated native event. It will be wrapped in a
+     normalized BrowserEvent and dispatched to Closure listeners on all
+     ancestors of its target (inclusive).</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l409">code &raquo;</a><span class="member"><a name="goog.testing.events.fireClickEvent">goog.testing.events.fireClickEvent</a> <span class="args">( target, opt_button, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a click event on the given target. IE only supports click with
+ the left mouse button.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_button: <code class="type"><a href="enum_goog_events_BrowserEvent_MouseButton.html">goog.events.BrowserEvent.MouseButton</a>=</code><dd>Mouse button;
+     defaults to <code >goog.events.BrowserEvent.MouseButton.LEFT</code>.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l165">code &raquo;</a><span class="member"><a name="goog.testing.events.fireClickSequence">goog.testing.events.fireClickSequence</a> <span class="args">( target, opt_button, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a mousedown, mouseup, and then click on the given event target,
+ with the left mouse button.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_button: <code class="type"><a href="enum_goog_events_BrowserEvent_MouseButton.html">goog.events.BrowserEvent.MouseButton</a>=</code><dd>Mouse button;
+     defaults to <code >goog.events.BrowserEvent.MouseButton.LEFT</code>.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the sequence: false if preventDefault()
+     was called on any of the events, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l474">code &raquo;</a><span class="member"><a name="goog.testing.events.fireContextMenuEvent">goog.testing.events.fireContextMenuEvent</a> <span class="args">( target, opt_coords )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a contextmenu event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l497">code &raquo;</a><span class="member"><a name="goog.testing.events.fireContextMenuSequence">goog.testing.events.fireContextMenuSequence</a> <span class="args">( target, opt_coords )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a mousedown, contextmenu, and the mouseup on the given event
+ target, with the right mouse button.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).</dl><tr><th>Returns<tr><td><dl>The returnValue of the sequence: false if preventDefault()
+     was called on any of the events, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l428">code &raquo;</a><span class="member"><a name="goog.testing.events.fireDoubleClickEvent">goog.testing.events.fireDoubleClickEvent</a> <span class="args">( target, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a double-click event on the given target. Always double-clicks
+ with the left mouse button since no browser supports double-clicking with
+ any other buttons.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l188">code &raquo;</a><span class="member"><a name="goog.testing.events.fireDoubleClickSequence">goog.testing.events.fireDoubleClickSequence</a> <span class="args">( target, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates the sequence of events fired by the browser when the user double-
+ clicks the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the sequence: false if preventDefault()
+     was called on any of the events, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l568">code &raquo;</a><span class="member"><a name="goog.testing.events.fireFocusEvent">goog.testing.events.fireFocusEvent</a> <span class="args">( target )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulate a focus event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.</dl><tr><th>Returns<tr><td><dl>The value returned by firing the focus browser event,
+     which returns false iff 'preventDefault' was invoked.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l226">code &raquo;</a><span class="member"><a name="goog.testing.events.fireKeySequence">goog.testing.events.fireKeySequence</a> <span class="args">( target, keyCode, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a complete keystroke (keydown, keypress, and keyup). Note that
+ if preventDefault is called on the keydown, the keypress will not fire.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>keyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The keycode of the key pressed.<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the sequence: false if preventDefault()
+     was called on any of the events, true otherwise.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l453">code &raquo;</a><span class="member"><a name="goog.testing.events.fireMouseButtonEvent_">goog.testing.events.fireMouseButtonEvent_</a> <span class="args">( type, target, opt_button, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Helper function to fire a mouse event.
+ with the left mouse button since no browser supports double-clicking with
+ any other buttons.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>type: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The event type.<dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_button: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>Mouse button; defaults to
+     <code >goog.events.BrowserEvent.MouseButton.LEFT</code>.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l361">code &raquo;</a><span class="member"><a name="goog.testing.events.fireMouseDownEvent">goog.testing.events.fireMouseDownEvent</a> <span class="args">( target, opt_button, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a mousedown event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_button: <code class="type"><a href="enum_goog_events_BrowserEvent_MouseButton.html">goog.events.BrowserEvent.MouseButton</a>=</code><dd>Mouse button;
+     defaults to <code >goog.events.BrowserEvent.MouseButton.LEFT</code>.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l320">code &raquo;</a><span class="member"><a name="goog.testing.events.fireMouseMoveEvent">goog.testing.events.fireMouseMoveEvent</a> <span class="args">( target, opt_coords )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a mousemove event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l339">code &raquo;</a><span class="member"><a name="goog.testing.events.fireMouseOutEvent">goog.testing.events.fireMouseOutEvent</a> <span class="args">( target, relatedTarget, opt_coords )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a mouseout event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>relatedTarget: <code class="type">EventTarget</code><dd>The related target for the event (e.g.,
+     the node that the mouse is being moved into).<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l302">code &raquo;</a><span class="member"><a name="goog.testing.events.fireMouseOverEvent">goog.testing.events.fireMouseOverEvent</a> <span class="args">( target, relatedTarget, opt_coords )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a mouseover event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>relatedTarget: <code class="type">EventTarget</code><dd>The related target for the event (e.g.,
+     the node that the mouse is being moved out of).<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l385">code &raquo;</a><span class="member"><a name="goog.testing.events.fireMouseUpEvent">goog.testing.events.fireMouseUpEvent</a> <span class="args">( target, opt_button, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a mouseup event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_button: <code class="type"><a href="enum_goog_events_BrowserEvent_MouseButton.html">goog.events.BrowserEvent.MouseButton</a>=</code><dd>Mouse button;
+     defaults to <code >goog.events.BrowserEvent.MouseButton.LEFT</code>.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l246">code &raquo;</a><span class="member"><a name="goog.testing.events.fireNonAsciiKeySequence">goog.testing.events.fireNonAsciiKeySequence</a> <span class="args">( target, keyCode, keyPressKeyCode, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a complete keystroke (keydown, keypress, and keyup) when typing
+ a non-ASCII character. Same as fireKeySequence, the keypress will not fire
+ if preventDefault is called on the keydown.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>keyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The keycode of the keydown and keyup events.<dt>keyPressKeyCode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The keycode of the keypress event.<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the sequence: false if preventDefault()
+     was called on any of the events, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l542">code &raquo;</a><span class="member"><a name="goog.testing.events.firePopStateEvent">goog.testing.events.firePopStateEvent</a> <span class="args">( target, state )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a popstate event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>state: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>History state object.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l668">code &raquo;</a><span class="member"><a name="goog.testing.events.fireTouchEndEvent">goog.testing.events.fireTouchEndEvent</a> <span class="args">( target, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a touchend event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Touch position. Defaults to event's
+     target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l645">code &raquo;</a><span class="member"><a name="goog.testing.events.fireTouchMoveEvent">goog.testing.events.fireTouchMoveEvent</a> <span class="args">( target, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a touchmove event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Touch position. Defaults to event's
+     target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l691">code &raquo;</a><span class="member"><a name="goog.testing.events.fireTouchSequence">goog.testing.events.fireTouchSequence</a> <span class="args">( target, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a simple touch sequence on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Touch position. Defaults to event
+     target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the sequence: false if preventDefault()
+     was called on any of the events, true otherwise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l622">code &raquo;</a><span class="member"><a name="goog.testing.events.fireTouchStartEvent">goog.testing.events.fireTouchStartEvent</a> <span class="args">( target, opt_coords, opt_eventProperties )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Simulates a touchstart event on the given target.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>target: <code class="type">EventTarget</code><dd>The target for the event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Touch position. Defaults to event's
+     target's position (if available), otherwise (0, 0).<dt>opt_eventProperties: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd>Event properties to be mixed into the
+     BrowserEvent.</dl><tr><th>Returns<tr><td><dl>The returnValue of the event: false if preventDefault() was
+     called on it, true otherwise.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l284">code &raquo;</a><span class="member"><a name="goog.testing.events.isBrokenGeckoMacActionKey_">goog.testing.events.isBrokenGeckoMacActionKey_</a> <span class="args">( e )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>e: <code class="type"><a href="class_goog_testing_events_Event.html">goog.testing.events.Event</a></code><dd>The event.</dl><tr><th>Returns<tr><td><dl>Whether this is the Gecko/Mac's Meta-C/V/X, which
+     is broken and requires special handling.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l709">code &raquo;</a><span class="member"><a name="goog.testing.events.mixinListenable">goog.testing.events.mixinListenable</a> <span class="args">( obj )</span></span></div><p>Mixins a listenable into the given object. This turns the object
+ into a goog.events.Listenable. This is useful, for example, when
+ you need to mock a implementation of listenable and still want it
+ to work with goog.events.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>The object to mixin into.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/events/events.js.src.html#l133">code &raquo;</a><span class="member"><a name="goog.testing.events.setEventClientXY_">goog.testing.events.setEventClientXY_</a> <span class="args">( event, opt_coords )</span></span></div><p>A static helper function that sets the mouse position to the event.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>event: <code class="type">Event</code><dd>A simulated native event.<dt>opt_coords: <code class="type"><a href="class_goog_math_Coordinate.html">goog.math.Coordinate</a>=</code><dd>Mouse position. Defaults to event's
+ target's position (if available), otherwise (0, 0).</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_testing_jsunit.html b/docs/namespace_goog_testing_jsunit.html
new file mode 100644
index 0000000..df7f963
--- /dev/null
+++ b/docs/namespace_goog_testing_jsunit.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.jsunit</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.testing.jsunit</h1><a class="source" href="source/lib/goog/testing/jsunit.js.src.html#l24">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/jsunit.js.src.html#l34">code &raquo;</a><span class="member"><a name="goog.testing.jsunit.BASE_PATH">goog.testing.jsunit.BASE_PATH</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Base path for JsUnit app files, relative to Closure's base path.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/jsunit.js.src.html#l42">code &raquo;</a><span class="member"><a name="goog.testing.jsunit.CORE_SCRIPT">goog.testing.jsunit.CORE_SCRIPT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Filename for the core JS Unit script.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/jsunit.js.src.html#l58">code &raquo;</a><span class="member"><a name="goog.testing.jsunit.AUTO_RUN_DELAY_IN_MS">goog.testing.jsunit.AUTO_RUN_DELAY_IN_MS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/jsunit.js.src.html#l50">code &raquo;</a><span class="member"><a name="goog.testing.jsunit.AUTO_RUN_ONLOAD">goog.testing.jsunit.AUTO_RUN_ONLOAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_testing_mockmatchers.html b/docs/namespace_goog_testing_mockmatchers.html
new file mode 100644
index 0000000..a44ee24
--- /dev/null
+++ b/docs/namespace_goog_testing_mockmatchers.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.mockmatchers</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.testing.mockmatchers</h1><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l25">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a><dd>A simple interface for executing argument matching.<dt><a href="class_goog_testing_mockmatchers_IgnoreArgument.html">goog.testing.mockmatchers.IgnoreArgument</a><dd>A matcher that always returns true.<dt><a href="class_goog_testing_mockmatchers_InstanceOf.html">goog.testing.mockmatchers.InstanceOf</a><dd>A matcher that verifies that an argument is an instance of a given class.<dt><a href="class_goog_testing_mockmatchers_ObjectEquals.html">goog.testing.mockmatchers.ObjectEquals</a><dd>A matcher that verifies that the argument is an object that equals the given
+ expected object, using a deep comparison.<dt><a href="class_goog_testing_mockmatchers_RegexpMatch.html">goog.testing.mockmatchers.RegexpMatch</a><dd>A matcher that verifies that an argument matches a given RegExp.<dt><a href="class_goog_testing_mockmatchers_SaveArgument.html">goog.testing.mockmatchers.SaveArgument</a><dd>A matcher that saves the argument that it is verifying so that your unit test
+ can perform extra tests with this argument later.<dt><a href="class_goog_testing_mockmatchers_TypeOf.html">goog.testing.mockmatchers.TypeOf</a><dd>A matcher that verifies that an argument is of a given type (e.g.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l369">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.flexibleArrayMatcher">goog.testing.mockmatchers.flexibleArrayMatcher</a> <span class="args">( expectedArr, arr, opt_expectation )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>A function that checks to see if an array matches a given set of
+ expectations.  The expectations array can be a mix of ArgumentMatcher
+ implementations and values.  True will be returned if values are identical or
+ if a matcher returns a positive result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expectedArr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>An array of expectations which can be either
+     values to check for equality or ArgumentMatchers.<dt>arr: <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The array to match.<dt>opt_expectation: <code class="type">?<a href="class_goog_testing_MockExpectation.html">goog.testing.MockExpectation</a>=</code><dd>The expectation
+     for this match.</dl><tr><th>Returns<tr><td><dl>Whether or not the given array matches the expectations.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l271">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.ignoreArgument">goog.testing.mockmatchers.ignoreArgument</a> : <code class="type"><a href="class_goog_testing_mockmatchers_IgnoreArgument.html">goog.testing.mockmatchers.IgnoreArgument</a></code></span></div><p>An instance of the IgnoreArgument matcher. Returns true for all matches.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l279">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isArray">goog.testing.mockmatchers.isArray</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is an array.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l289">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isArrayLike">goog.testing.mockmatchers.isArrayLike</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is a array-like.  A NodeList is an
+ example of a collection that is very close to an array.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l316">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isBoolean">goog.testing.mockmatchers.isBoolean</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is a boolean.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l298">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isDateLike">goog.testing.mockmatchers.isDateLike</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is a date-like.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l334">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isFunction">goog.testing.mockmatchers.isFunction</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is a function.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l352">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isNodeLike">goog.testing.mockmatchers.isNodeLike</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is like a DOM node.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l325">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isNumber">goog.testing.mockmatchers.isNumber</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is a number.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l343">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isObject">goog.testing.mockmatchers.isObject</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is an object.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/testing/mockmatchers.js.src.html#l307">code &raquo;</a><span class="member"><a name="goog.testing.mockmatchers.isString">goog.testing.mockmatchers.isString</a> : <code class="type"><a href="class_goog_testing_mockmatchers_ArgumentMatcher.html">goog.testing.mockmatchers.ArgumentMatcher</a></code></span></div><p>A matcher that verifies that an argument is a string.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_testing_stacktrace.html b/docs/namespace_goog_testing_stacktrace.html
new file mode 100644
index 0000000..6425540
--- /dev/null
+++ b/docs/namespace_goog_testing_stacktrace.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.stacktrace</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.testing.stacktrace</h1><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l20">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_goog_testing_stacktrace_Frame.html">goog.testing.stacktrace.Frame</a><dd>Class representing one stack frame.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l578">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.callSitesToFrames_">goog.testing.stacktrace.callSitesToFrames_</a> <span class="args">( stack )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Converts an array of CallSite (elements of a stack trace in V8) to an array
+ of Frames.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>stack: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>The stack as an array of CallSites.</dl><tr><th>Returns<tr><td><dl>The stack as an array of
+     Frames.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l522">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.canonicalize">goog.testing.stacktrace.canonicalize</a> <span class="args">( stack )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Brings the stack trace into a common format across browsers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>stack: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Browser-specific stack trace.</dl><tr><th>Returns<tr><td><dl>Same stack trace in common format.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l419">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.deobfuscateFunctionName_">goog.testing.stacktrace.deobfuscateFunctionName_</a> <span class="args">( )</span> &rArr; <code class="type">string</code></span></div><p>Function to deobfuscate function names.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l292">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.followCallChain_">goog.testing.stacktrace.followCallChain_</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Creates a stack trace by following the call chain. Based on
+ <code  class="type"><a href="namespace_goog_debug.html#goog.debug.getStacktrace">goog.debug.getStacktrace</a></code>.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Stack frames.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l466">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.framesToString_">goog.testing.stacktrace.framesToString_</a> <span class="args">( frames )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts the stack frames into canonical format. Chops the beginning and the
+ end of it which come from the testing environment, not from the test itself.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frames: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_stacktrace_Frame.html">goog.testing.stacktrace.Frame</a>&gt;</code><dd>The frames.</dl><tr><th>Returns<tr><td><dl>Canonical, pretty printed stack trace.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l556">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.get">goog.testing.stacktrace.get</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the native stack trace if available otherwise follows the call chain.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The stack trace in canonical format.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l533">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.getNativeStack_">goog.testing.stacktrace.getNativeStack_</a> <span class="args">( )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>)</code></span></div><p>Returns the native stack trace.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l451">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.htmlEscape_">goog.testing.stacktrace.htmlEscape_</a> <span class="args">( text )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Escapes the special character in HTML.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>text: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Plain text.</dl><tr><th>Returns<tr><td><dl>Escaped text.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l439">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.maybeDeobfuscateFunctionName_">goog.testing.stacktrace.maybeDeobfuscateFunctionName_</a> <span class="args">( name )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Deobfuscates a compiled function name with the function passed to
+ <code  class="type"><a class="unresolved-link">#setDeobfuscateFunctionName</a></code>. Returns the original function name if
+ the deobfuscator hasn't been set.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The function name to deobfuscate.</dl><tr><th>Returns<tr><td><dl>The deobfuscated function name.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l393">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.parseLongFirefoxFrame_">goog.testing.stacktrace.parseLongFirefoxFrame_</a> <span class="args">( frameStr )</span> &rArr; <code class="type">!<a href="class_goog_testing_stacktrace_Frame.html">goog.testing.stacktrace.Frame</a></code></span></div><p>Parses a long firefox stack frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frameStr: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The stack frame as string.</dl><tr><th>Returns<tr><td><dl>Stack frame object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l351">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.parseStackFrame_">goog.testing.stacktrace.parseStackFrame_</a> <span class="args">( frameStr )</span> &rArr; <code class="type"><a href="class_goog_testing_stacktrace_Frame.html">goog.testing.stacktrace.Frame</a></code></span></div><p>Parses one stack frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frameStr: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The stack frame as string.</dl><tr><th>Returns<tr><td><dl>Stack frame object or null if the
+     parsing failed.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l507">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.parse_">goog.testing.stacktrace.parse_</a> <span class="args">( stack )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="class_goog_testing_stacktrace_Frame.html">goog.testing.stacktrace.Frame</a>&gt;</code></span></div><p>Parses the browser's native stack trace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>stack: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Stack trace.</dl><tr><th>Returns<tr><td><dl>Stack frames. The
+     unrecognized frames will be nulled out.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l426">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.setDeobfuscateFunctionName">goog.testing.stacktrace.setDeobfuscateFunctionName</a> <span class="args">( fn )</span></span></div><p>Sets function to deobfuscate function names.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">function(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>function to deobfuscate function names.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l177">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.CHROME_URL_PATTERN_">goog.testing.stacktrace.CHROME_URL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for an URL + line number + column number in V8.
+ The URL is either in submatch 1 or submatch 2.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l201">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_">goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function call in the Firefox stack trace.
+ Creates 2 submatches with function name (optional) and arguments.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l211">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_">goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing one stack frame in Firefox.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l260">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_">goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for finding the function name in its source.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l114">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.IDENTIFIER_PATTERN_">goog.testing.stacktrace.IDENTIFIER_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for JavaScript identifiers. We don't support Unicode
+ identifiers defined in ECMAScript v3.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l270">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.IE_FUNCTION_CALL_PATTERN_">goog.testing.stacktrace.IE_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function call in a IE stack trace. This expression allows
+ for identifiers like 'Anonymous function', 'eval code', and 'Global code'.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l279">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.IE_STACK_FRAME_REGEXP_">goog.testing.stacktrace.IE_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing a stack frame in IE.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l93">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.MAX_DEPTH_">goog.testing.stacktrace.MAX_DEPTH_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Maximum number of steps while the call chain is followed.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l105">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_">goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Maximum length of a string that can be matched with a RegExp on
+ Firefox 3x. Exceeding this approximate length will cause string.match
+ to exceed Firefox's stack quota. This situation can be encountered
+ when goog.globalEval is invoked with a long argument; such as
+ when loading a module.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l222">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_">goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for an anonymous function call in an Opera stack frame.
+ Creates 2 (optional) submatches: the context object and function name.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l237">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_">goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for a function call in an Opera stack frame.
+ Creates 4 (optional) submatches: the function name (if not anonymous),
+ the aliased context object and function name (if anonymous), and the
+ function call arguments.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l250">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_">goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing on stack frame in Opera 11.68 - 12.17.
+ Newer versions of Opera use V8 and stack frames should match against
+ goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l167">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.URL_PATTERN_">goog.testing.stacktrace.URL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for an URL + position inside the file.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l122">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.V8_ALIAS_PATTERN_">goog.testing.stacktrace.V8_ALIAS_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function name alias in the V8 stack trace.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l133">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.V8_CONTEXT_PATTERN_">goog.testing.stacktrace.V8_CONTEXT_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for the context of a function call in a V8 stack trace.
+ Creates an optional submatch for the namespace identifier including the
+ "new" keyword for constructor calls (e.g. "new foo.Bar").</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l156">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.V8_FUNCTION_CALL_PATTERN_">goog.testing.stacktrace.V8_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function call in the V8 stack trace. Creates 3 submatches
+ with context object (optional), function name and function alias (optional).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l145">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.V8_FUNCTION_NAME_PATTERN_">goog.testing.stacktrace.V8_FUNCTION_NAME_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function names and constructor calls in the V8 stack
+ trace.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/stacktrace.js.src.html#l190">code &raquo;</a><span class="member"><a name="goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_">goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing one stack frame in V8. For more information
+ on V8 stack frame formats, see
+ https://code.google.com/p/v8/wiki/JavaScriptStackTraceApi.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_testing_watchers.html b/docs/namespace_goog_testing_watchers.html
new file mode 100644
index 0000000..de31439
--- /dev/null
+++ b/docs/namespace_goog_testing_watchers.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.testing.watchers</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.testing.watchers</h1><a class="source" href="source/lib/goog/testing/watchers.js.src.html#l21">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/watchers.js.src.html#l31">code &raquo;</a><span class="member"><a name="goog.testing.watchers.signalClockReset">goog.testing.watchers.signalClockReset</a> <span class="args">( )</span></span></div><p>Fires clock reset watching functions.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/testing/watchers.js.src.html#l43">code &raquo;</a><span class="member"><a name="goog.testing.watchers.watchClockReset">goog.testing.watchers.watchClockReset</a> <span class="args">( fn )</span></span></div><p>Enqueues a function to be called when the clock used for setTimeout is reset.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/testing/watchers.js.src.html#l25">code &raquo;</a><span class="member"><a name="goog.testing.watchers.resetWatchers_">goog.testing.watchers.resetWatchers_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_uri.html b/docs/namespace_goog_uri.html
index 2bf8bb8..4570658 100644
--- a/docs/namespace_goog_uri.html
+++ b/docs/namespace_goog_uri.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.uri</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l48">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.uri</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l48">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_uri_utils.html b/docs/namespace_goog_uri_utils.html
index b643ff8..b41e0cb 100644
--- a/docs/namespace_goog_uri_utils.html
+++ b/docs/namespace_goog_uri_utils.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri.utils</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.uri.utils</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l48">code &raquo;</a></header><section></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_uri_utils_CharCode_.html">goog.uri.utils.CharCode_</a><dd>Character codes inlined to avoid object allocations due to charCode.<dt><a href="enum_goog_uri_utils_ComponentIndex.html">goog.uri.utils.ComponentIndex</a><dd>The index of each URI component in the return value of goog.uri.utils.split.<dt><a href="enum_goog_uri_utils_StandardQueryParam.html">goog.uri.utils.StandardQueryParam</a><dd>Standard supported query parameters.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l589">code &raquo;</a><a class="member" name="goog.uri.utils.QueryArray">goog.uri.utils.QueryArray</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></div><div>An array representing a set of query parameters with alternating keys
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.uri.utils</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.uri.utils</h1><a class="source" href="source/lib/goog/uri/utils.js.src.html#l48">code &raquo;</a></header><section></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_goog_uri_utils_CharCode_.html">goog.uri.utils.CharCode_</a><dd>Character codes inlined to avoid object allocations due to charCode.<dt><a href="enum_goog_uri_utils_ComponentIndex.html">goog.uri.utils.ComponentIndex</a><dd>The index of each URI component in the return value of goog.uri.utils.split.<dt><a href="enum_goog_uri_utils_StandardQueryParam.html">goog.uri.utils.StandardQueryParam</a><dd>Standard supported query parameters.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l597">code &raquo;</a><a class="member" name="goog.uri.utils.QueryArray">goog.uri.utils.QueryArray</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></div><div>An array representing a set of query parameters with alternating keys
  and values.
 
  Keys are assumed to be URI encoded already and live at even indices.  See
@@ -14,18 +14,18 @@
    // Multi-valued param: &house=LosAngeles&house=NewYork&house=null
    'house', ['LosAngeles', 'NewYork', null]
  ];
- </pre></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l565">code &raquo;</a><a class="member" name="goog.uri.utils.QueryValue">goog.uri.utils.QueryValue</a> : <code class="type">*</code></div><div>Supported query parameter values by the parameter serializing utilities.
+ </pre></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l573">code &raquo;</a><a class="member" name="goog.uri.utils.QueryValue">goog.uri.utils.QueryValue</a> : <code class="type">*</code></div><div>Supported query parameter values by the parameter serializing utilities.
 
  If a value is null or undefined, the key-value pair is skipped, as an easy
  way to omit parameters conditionally.  Non-array parameters are converted
  to a string and URI encoded.  Array values are expanded into multiple
- &key=value pairs, with each element stringized and URI-encoded.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l640">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendKeyValuePairs_">goog.uri.utils.appendKeyValuePairs_</a> <span class="args">( key, value, pairs )</span></span></div><p>Appends key=value pairs to an array, supporting multi-valued objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key prefix.<dt>value: <code class="type"><a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryValue">goog.uri.utils.QueryValue</a></code><dd>The value to serialize.<dt>pairs: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The array to which the 'key=value' strings
-     should be appended.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l804">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendParam">goog.uri.utils.appendParam</a> <span class="args">( uri, key, opt_value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Appends a single URI parameter.
+ &key=value pairs, with each element stringized and URI-encoded.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l648">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendKeyValuePairs_">goog.uri.utils.appendKeyValuePairs_</a> <span class="args">( key, value, pairs )</span></span></div><p>Appends key=value pairs to an array, supporting multi-valued objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key prefix.<dt>value: <code class="type"><a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryValue">goog.uri.utils.QueryValue</a></code><dd>The value to serialize.<dt>pairs: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The array to which the 'key=value' strings
+     should be appended.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l812">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendParam">goog.uri.utils.appendParam</a> <span class="args">( uri, key, opt_value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Appends a single URI parameter.
 
  Repeated calls to this can exhibit quadratic behavior in IE6 due to the
  way string append works, though it should be limited given the 2kb limit.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The original URI, which may already have query data.<dt>key: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key, which must already be URI encoded.<dt>opt_value: <code class="type">*=</code><dd>The value, which will be stringized and encoded
      (assumed not already to be encoded).  If omitted, undefined, or null, the
-     key will be added as a valueless parameter.</dl><tr><th>Returns<tr><td><dl>The URI with the query parameter added.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l768">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendParams">goog.uri.utils.appendParams</a> <span class="args">( uri, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Appends URI parameters to an existing URI.
+     key will be added as a valueless parameter.</dl><tr><th>Returns<tr><td><dl>The URI with the query parameter added.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l776">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendParams">goog.uri.utils.appendParams</a> <span class="args">( uri, var_args )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Appends URI parameters to an existing URI.
 
  The variable arguments may contain alternating keys and values.  Keys are
  assumed to be already URI encoded.  The values should not be URI-encoded,
@@ -44,69 +44,70 @@
 
  A single call to this function will not exhibit quadratic behavior in IE,
  whereas multiple repeated calls may, although the effect is limited by
- fact that URL's generally can't exceed 2kb.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The original URI, which may already have query data.<dt>var_args: <code class="type">...(<a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryArray">goog.uri.utils.QueryArray</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryValue">goog.uri.utils.QueryValue</a>)</code><dd>An array or argument list conforming to goog.uri.utils.QueryArray.</dl><tr><th>Returns<tr><td><dl>The URI with all query parameters added.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l785">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendParamsFromMap">goog.uri.utils.appendParamsFromMap</a> <span class="args">( uri, map )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Appends query parameters from a map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The original URI, which may already have query data.<dt>map: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>An object where keys are URI-encoded parameter keys,
+ fact that URL's generally can't exceed 2kb.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The original URI, which may already have query data.<dt>var_args: <code class="type">...(<a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryArray">goog.uri.utils.QueryArray</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryValue">goog.uri.utils.QueryValue</a>)</code><dd>An array or argument list conforming to goog.uri.utils.QueryArray.</dl><tr><th>Returns<tr><td><dl>The URI with all query parameters added.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l793">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendParamsFromMap">goog.uri.utils.appendParamsFromMap</a> <span class="args">( uri, map )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Appends query parameters from a map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The original URI, which may already have query data.<dt>map: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>An object where keys are URI-encoded parameter keys,
      and the values are arbitrary types or arrays.  Keys with a null value
-     are dropped.</dl><tr><th>Returns<tr><td><dl>The new parameters.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1018">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendPath">goog.uri.utils.appendPath</a> <span class="args">( baseUri, path )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Generates a URI path using a given URI and a path with checks to
+     are dropped.</dl><tr><th>Returns<tr><td><dl>The new parameters.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1026">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendPath">goog.uri.utils.appendPath</a> <span class="args">( baseUri, path )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Generates a URI path using a given URI and a path with checks to
  prevent consecutive "//". The baseUri passed in must not contain
  query or fragment identifiers. The path to append may not contain query or
- fragment identifiers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>baseUri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URI to use as the base.<dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Path to append.</dl><tr><th>Returns<tr><td><dl>Updated URI.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l605">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendQueryData_">goog.uri.utils.appendQueryData_</a> <span class="args">( buffer )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Appends a URI and query data in a string buffer with special preconditions.
+ fragment identifiers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>baseUri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URI to use as the base.<dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Path to append.</dl><tr><th>Returns<tr><td><dl>Updated URI.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l613">code &raquo;</a><span class="member"><a name="goog.uri.utils.appendQueryData_">goog.uri.utils.appendQueryData_</a> <span class="args">( buffer )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Appends a URI and query data in a string buffer with special preconditions.
 
  Internal implementation utility, performing very few object allocations.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>buffer: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>A string buffer.  The first element
      must be the base URI, and may have a fragment identifier.  If the array
      contains more than one element, the second element must be an ampersand,
      and may be overwritten, depending on the base URI.  Undefined elements
-     are treated as empty-string.</dl><tr><th>Returns<tr><td><dl>The concatenated URI and query data.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l545">code &raquo;</a><span class="member"><a name="goog.uri.utils.assertNoFragmentsOrQueries_">goog.uri.utils.assertNoFragmentsOrQueries_</a> <span class="args">( uri )</span></span></div><p>Asserts that there are no fragment or query identifiers, only in uncompiled
+     are treated as empty-string.</dl><tr><th>Returns<tr><td><dl>The concatenated URI and query data.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l553">code &raquo;</a><span class="member"><a name="goog.uri.utils.assertNoFragmentsOrQueries_">goog.uri.utils.assertNoFragmentsOrQueries_</a> <span class="args">( uri )</span></span></div><p>Asserts that there are no fragment or query identifiers, only in uncompiled
  mode.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l89">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildFromEncodedParts">goog.uri.utils.buildFromEncodedParts</a> <span class="args">( opt_scheme, opt_userInfo, opt_domain, opt_port, opt_path, opt_queryData, opt_fragment )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Builds a URI string from already-encoded parts.
 
  No encoding is performed.  Any component may be omitted as either null or
  undefined.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_scheme: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The scheme such as 'http'.<dt>opt_userInfo: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The user name before the '@'.<dt>opt_domain: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The domain such as 'www.google.com', already
      URI-encoded.<dt>opt_port: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Null">null</a>)=</code><dd>The port number.<dt>opt_path: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The path, already URI-encoded.  If it is not
-     empty, it must begin with a slash.<dt>opt_queryData: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The URI-encoded query data.<dt>opt_fragment: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The URI-encoded fragment identifier.</dl><tr><th>Returns<tr><td><dl>The fully combined URI.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l697">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildQueryData">goog.uri.utils.buildQueryData</a> <span class="args">( keysAndValues, opt_startIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Builds a query data string from a sequence of alternating keys and values.
+     empty, it must begin with a slash.<dt>opt_queryData: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The URI-encoded query data.<dt>opt_fragment: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd>The URI-encoded fragment identifier.</dl><tr><th>Returns<tr><td><dl>The fully combined URI.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l705">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildQueryData">goog.uri.utils.buildQueryData</a> <span class="args">( keysAndValues, opt_startIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Builds a query data string from a sequence of alternating keys and values.
  Currently generates "&key&" for empty args.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>keysAndValues: <code class="type"><a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryArray">goog.uri.utils.QueryArray</a></code><dd>Alternating keys and
-     values.  See the typedef.<dt>opt_startIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>A start offset into the arary, defaults to 0.</dl><tr><th>Returns<tr><td><dl>The encoded query string, in the for 'a=1&b=2'.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l716">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildQueryDataBufferFromMap_">goog.uri.utils.buildQueryDataBufferFromMap_</a> <span class="args">( buffer, map )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Builds a buffer of query data from a map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>buffer: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>A string buffer to append to.  The
+     values.  See the typedef.<dt>opt_startIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>A start offset into the arary, defaults to 0.</dl><tr><th>Returns<tr><td><dl>The encoded query string, in the form 'a=1&b=2'.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l724">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildQueryDataBufferFromMap_">goog.uri.utils.buildQueryDataBufferFromMap_</a> <span class="args">( buffer, map )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Builds a buffer of query data from a map.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>buffer: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>A string buffer to append to.  The
      first element appended will be an '&', and may be replaced by the caller.<dt>map: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryValue">goog.uri.utils.QueryValue</a>&gt;</code><dd>An object where keys are
      URI-encoded parameter keys, and the values conform to the contract
-     specified in the goog.uri.utils.QueryValue typedef.</dl><tr><th>Returns<tr><td><dl>The buffer argument.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l674">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildQueryDataBuffer_">goog.uri.utils.buildQueryDataBuffer_</a> <span class="args">( buffer, keysAndValues, opt_startIndex )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Builds a buffer of query data from a sequence of alternating keys and values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>buffer: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>A string buffer to append to.  The
+     specified in the goog.uri.utils.QueryValue typedef.</dl><tr><th>Returns<tr><td><dl>The buffer argument.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l682">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildQueryDataBuffer_">goog.uri.utils.buildQueryDataBuffer_</a> <span class="args">( buffer, keysAndValues, opt_startIndex )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Builds a buffer of query data from a sequence of alternating keys and values.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>buffer: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>A string buffer to append to.  The
      first element appended will be an '&', and may be replaced by the caller.<dt>keysAndValues: <code class="type">(<a href="namespace_goog_uri_utils.html#goog.uri.utils.QueryArray">goog.uri.utils.QueryArray</a>|<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments">Arguments</a>)</code><dd>An array with
-     alternating keys and values -- see the typedef.<dt>opt_startIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>A start offset into the arary, defaults to 0.</dl><tr><th>Returns<tr><td><dl>The buffer argument.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l734">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildQueryDataFromMap">goog.uri.utils.buildQueryDataFromMap</a> <span class="args">( map )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Builds a query data string from a map.
+     alternating keys and values -- see the typedef.<dt>opt_startIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>=</code><dd>A start offset into the arary, defaults to 0.</dl><tr><th>Returns<tr><td><dl>The buffer argument.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l742">code &raquo;</a><span class="member"><a name="goog.uri.utils.buildQueryDataFromMap">goog.uri.utils.buildQueryDataFromMap</a> <span class="args">( map )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Builds a query data string from a map.
  Currently generates "&key&" for empty args.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>map: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code><dd>An object where keys are URI-encoded parameter keys,
      and the values are arbitrary types or arrays.  Keys with a null value
-     are dropped.</dl><tr><th>Returns<tr><td><dl>The encoded query string, in the for 'a=1&b=2'.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l304">code &raquo;</a><span class="member"><a name="goog.uri.utils.decodeIfPossible_">goog.uri.utils.decodeIfPossible_</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A possibly null string.</dl><tr><th>Returns<tr><td><dl>The string URI-decoded, or null if uri is null.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l830">code &raquo;</a><span class="member"><a name="goog.uri.utils.findParam_">goog.uri.utils.findParam_</a> <span class="args">( uri, startIndex, keyEncoded, hashOrEndIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Finds the next instance of a query parameter with the specified name.
+     are dropped.</dl><tr><th>Returns<tr><td><dl>The encoded query string, in the form 'a=1&b=2'.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l306">code &raquo;</a><span class="member"><a name="goog.uri.utils.decodeIfPossible_">goog.uri.utils.decodeIfPossible_</a> <span class="args">( uri, opt_preserveReserved )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>A possibly null string.<dt>opt_preserveReserved: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>=</code><dd>If true, percent-encoding of RFC-3986
+     reserved characters will not be removed.</dl><tr><th>Returns<tr><td><dl>The string URI-decoded, or null if uri is null.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l838">code &raquo;</a><span class="member"><a name="goog.uri.utils.findParam_">goog.uri.utils.findParam_</a> <span class="args">( uri, startIndex, keyEncoded, hashOrEndIndex )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Finds the next instance of a query parameter with the specified name.
 
  Does not instantiate any objects.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to search.  May contain a fragment identifier
      if opt_hashIndex is specified.<dt>startIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The index to begin searching for the key at.  A
      match may be found even if this is one character after the ampersand.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.<dt>hashOrEndIndex: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>Index to stop looking at.  If a hash
      mark is present, it should be its index, otherwise it should be the
      length of the string.</dl><tr><th>Returns<tr><td><dl>The position of the first character in the key's name,
-     immediately after either a question mark or a dot.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l321">code &raquo;</a><span class="member"><a name="goog.uri.utils.getComponentByIndex_">goog.uri.utils.getComponentByIndex_</a> <span class="args">( componentIndex, uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets a URI component by index.
+     immediately after either a question mark or a dot.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l327">code &raquo;</a><span class="member"><a name="goog.uri.utils.getComponentByIndex_">goog.uri.utils.getComponentByIndex_</a> <span class="args">( componentIndex, uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets a URI component by index.
 
  It is preferred to use the getPathEncoded() variety of functions ahead,
  since they are more readable.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>componentIndex: <code class="type"><a href="enum_goog_uri_utils_ComponentIndex.html">goog.uri.utils.ComponentIndex</a></code><dd>The component index.<dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The still-encoded component, or null if the component
-     is not present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l390">code &raquo;</a><span class="member"><a name="goog.uri.utils.getDomain">goog.uri.utils.getDomain</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The decoded domain, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l380">code &raquo;</a><span class="member"><a name="goog.uri.utils.getDomainEncoded">goog.uri.utils.getDomainEncoded</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The domain name still encoded, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l344">code &raquo;</a><span class="member"><a name="goog.uri.utils.getEffectiveScheme">goog.uri.utils.getEffectiveScheme</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the effective scheme for the URL.  If the URL is relative then the
- scheme is derived from the page's location.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The protocol or scheme, always lower case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l469">code &raquo;</a><span class="member"><a name="goog.uri.utils.getFragment">goog.uri.utils.getFragment</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The decoded fragment identifier, or null if none.  Does
-     not include the hash mark.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l446">code &raquo;</a><span class="member"><a name="goog.uri.utils.getFragmentEncoded">goog.uri.utils.getFragmentEncoded</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The fragment identifier, or null if none.  Does not
-     include the hash mark itself.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l480">code &raquo;</a><span class="member"><a name="goog.uri.utils.getHost">goog.uri.utils.getHost</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Extracts everything up to the port of the URI.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI string.</dl><tr><th>Returns<tr><td><dl>Everything up to and including the port.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l891">code &raquo;</a><span class="member"><a name="goog.uri.utils.getParamValue">goog.uri.utils.getParamValue</a> <span class="args">( uri, keyEncoded )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the first value of a query parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to process.  May contain a fragment.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.  Case-sensitive.</dl><tr><th>Returns<tr><td><dl>The first value of the parameter (URI-decoded), or null
-     if the parameter is not found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l920">code &raquo;</a><span class="member"><a name="goog.uri.utils.getParamValues">goog.uri.utils.getParamValues</a> <span class="args">( uri, keyEncoded )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Gets all values of a query parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to process.  May contain a framgnet.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.  Case-snsitive.</dl><tr><th>Returns<tr><td><dl>All URI-decoded values with the given key.
-     If the key is not found, this will have length 0, but never be null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l425">code &raquo;</a><span class="member"><a name="goog.uri.utils.getPath">goog.uri.utils.getPath</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The decoded path, or null if none.  Includes the leading
-     slash, if any.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l496">code &raquo;</a><span class="member"><a name="goog.uri.utils.getPathAndAfter">goog.uri.utils.getPathAndAfter</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Extracts the path of the URL and everything after.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI string.</dl><tr><th>Returns<tr><td><dl>The URI, starting at the path and including the query
-     parameters and fragment identifier.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l414">code &raquo;</a><span class="member"><a name="goog.uri.utils.getPathEncoded">goog.uri.utils.getPathEncoded</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The path still encoded, or null if none. Includes the
-     leading slash, if any.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l399">code &raquo;</a><span class="member"><a name="goog.uri.utils.getPort">goog.uri.utils.getPort</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The port number, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l435">code &raquo;</a><span class="member"><a name="goog.uri.utils.getQueryData">goog.uri.utils.getQueryData</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The query data still encoded, or null if none.  Does not
-     include the question mark itself.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l332">code &raquo;</a><span class="member"><a name="goog.uri.utils.getScheme">goog.uri.utils.getScheme</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The protocol or scheme, or null if none.  Does not
-     include trailing colons or slashes.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l370">code &raquo;</a><span class="member"><a name="goog.uri.utils.getUserInfo">goog.uri.utils.getUserInfo</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The decoded user info, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l360">code &raquo;</a><span class="member"><a name="goog.uri.utils.getUserInfoEncoded">goog.uri.utils.getUserInfoEncoded</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The user name still encoded, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l878">code &raquo;</a><span class="member"><a name="goog.uri.utils.hasParam">goog.uri.utils.hasParam</a> <span class="args">( uri, keyEncoded )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines if the URI contains a specific key.
+     is not present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l396">code &raquo;</a><span class="member"><a name="goog.uri.utils.getDomain">goog.uri.utils.getDomain</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The decoded domain, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l386">code &raquo;</a><span class="member"><a name="goog.uri.utils.getDomainEncoded">goog.uri.utils.getDomainEncoded</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The domain name still encoded, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l350">code &raquo;</a><span class="member"><a name="goog.uri.utils.getEffectiveScheme">goog.uri.utils.getEffectiveScheme</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the effective scheme for the URL.  If the URL is relative then the
+ scheme is derived from the page's location.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The protocol or scheme, always lower case.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l477">code &raquo;</a><span class="member"><a name="goog.uri.utils.getFragment">goog.uri.utils.getFragment</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The decoded fragment identifier, or null if none.  Does
+     not include the hash mark.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l454">code &raquo;</a><span class="member"><a name="goog.uri.utils.getFragmentEncoded">goog.uri.utils.getFragmentEncoded</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The fragment identifier, or null if none.  Does not
+     include the hash mark itself.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l488">code &raquo;</a><span class="member"><a name="goog.uri.utils.getHost">goog.uri.utils.getHost</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Extracts everything up to the port of the URI.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI string.</dl><tr><th>Returns<tr><td><dl>Everything up to and including the port.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l899">code &raquo;</a><span class="member"><a name="goog.uri.utils.getParamValue">goog.uri.utils.getParamValue</a> <span class="args">( uri, keyEncoded )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the first value of a query parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to process.  May contain a fragment.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.  Case-sensitive.</dl><tr><th>Returns<tr><td><dl>The first value of the parameter (URI-decoded), or null
+     if the parameter is not found.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l928">code &raquo;</a><span class="member"><a name="goog.uri.utils.getParamValues">goog.uri.utils.getParamValues</a> <span class="args">( uri, keyEncoded )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code></span></div><p>Gets all values of a query parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to process.  May contain a framgnet.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.  Case-snsitive.</dl><tr><th>Returns<tr><td><dl>All URI-decoded values with the given key.
+     If the key is not found, this will have length 0, but never be null.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l432">code &raquo;</a><span class="member"><a name="goog.uri.utils.getPath">goog.uri.utils.getPath</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The decoded path, or null if none.  Includes the leading
+     slash, if any.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l504">code &raquo;</a><span class="member"><a name="goog.uri.utils.getPathAndAfter">goog.uri.utils.getPathAndAfter</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Extracts the path of the URL and everything after.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI string.</dl><tr><th>Returns<tr><td><dl>The URI, starting at the path and including the query
+     parameters and fragment identifier.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l421">code &raquo;</a><span class="member"><a name="goog.uri.utils.getPathEncoded">goog.uri.utils.getPathEncoded</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The path still encoded, or null if none. Includes the
+     leading slash, if any.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l406">code &raquo;</a><span class="member"><a name="goog.uri.utils.getPort">goog.uri.utils.getPort</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The port number, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l443">code &raquo;</a><span class="member"><a name="goog.uri.utils.getQueryData">goog.uri.utils.getQueryData</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The query data still encoded, or null if none.  Does not
+     include the question mark itself.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l338">code &raquo;</a><span class="member"><a name="goog.uri.utils.getScheme">goog.uri.utils.getScheme</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The protocol or scheme, or null if none.  Does not
+     include trailing colons or slashes.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l376">code &raquo;</a><span class="member"><a name="goog.uri.utils.getUserInfo">goog.uri.utils.getUserInfo</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The decoded user info, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l366">code &raquo;</a><span class="member"><a name="goog.uri.utils.getUserInfoEncoded">goog.uri.utils.getUserInfoEncoded</a> <span class="args">( uri )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>The user name still encoded, or null if none.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l886">code &raquo;</a><span class="member"><a name="goog.uri.utils.hasParam">goog.uri.utils.hasParam</a> <span class="args">( uri, keyEncoded )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines if the URI contains a specific key.
 
  Performs no object instantiations.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to process.  May contain a fragment
-     identifier.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.  Case-sensitive.</dl><tr><th>Returns<tr><td><dl>Whether the key is present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l527">code &raquo;</a><span class="member"><a name="goog.uri.utils.haveSameDomain">goog.uri.utils.haveSameDomain</a> <span class="args">( uri1, uri2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Ensures that two URI's have the exact same domain, scheme, and port.
+     identifier.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.  Case-sensitive.</dl><tr><th>Returns<tr><td><dl>Whether the key is present.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l535">code &raquo;</a><span class="member"><a name="goog.uri.utils.haveSameDomain">goog.uri.utils.haveSameDomain</a> <span class="args">( uri1, uri2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Ensures that two URI's have the exact same domain, scheme, and port.
 
  Unlike the version in goog.Uri, this checks protocol, and therefore is
- suitable for checking against the browser's same-origin policy.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The first URI.<dt>uri2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The second URI.</dl><tr><th>Returns<tr><td><dl>Whether they have the same domain and port.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1050">code &raquo;</a><span class="member"><a name="goog.uri.utils.makeUnique">goog.uri.utils.makeUnique</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Sets the zx parameter of a URI to a random value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Any URI.</dl><tr><th>Returns<tr><td><dl>That URI with the "zx" parameter added or replaced to
-     contain a random string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l277">code &raquo;</a><span class="member"><a name="goog.uri.utils.phishingProtection_">goog.uri.utils.phishingProtection_</a> <span class="args">( )</span></span></div><p>Check to see if the user is being phished.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l510">code &raquo;</a><span class="member"><a name="goog.uri.utils.removeFragment">goog.uri.utils.removeFragment</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the URI with the fragment identifier removed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>Everything preceding the hash mark.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l961">code &raquo;</a><span class="member"><a name="goog.uri.utils.removeParam">goog.uri.utils.removeParam</a> <span class="args">( uri, keyEncoded )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes all instances of a query parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to process.  Must not contain a fragment.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.</dl><tr><th>Returns<tr><td><dl>The URI with all instances of the parameter removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l459">code &raquo;</a><span class="member"><a name="goog.uri.utils.setFragmentEncoded">goog.uri.utils.setFragmentEncoded</a> <span class="args">( uri, fragment )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.<dt>fragment: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The encoded fragment identifier, or null if none.
-     Does not include the hash mark itself.</dl><tr><th>Returns<tr><td><dl>The URI with the fragment set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1002">code &raquo;</a><span class="member"><a name="goog.uri.utils.setParam">goog.uri.utils.setParam</a> <span class="args">( uri, keyEncoded, value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Replaces all existing definitions of a parameter with a single definition.
+ suitable for checking against the browser's same-origin policy.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The first URI.<dt>uri2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The second URI.</dl><tr><th>Returns<tr><td><dl>Whether they have the same scheme, domain and port.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1081">code &raquo;</a><span class="member"><a name="goog.uri.utils.makeUnique">goog.uri.utils.makeUnique</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Sets the zx parameter of a URI to a random value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Any URI.</dl><tr><th>Returns<tr><td><dl>That URI with the "zx" parameter added or replaced to
+     contain a random string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l277">code &raquo;</a><span class="member"><a name="goog.uri.utils.phishingProtection_">goog.uri.utils.phishingProtection_</a> <span class="args">( )</span></span></div><p>Check to see if the user is being phished.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l518">code &raquo;</a><span class="member"><a name="goog.uri.utils.removeFragment">goog.uri.utils.removeFragment</a> <span class="args">( uri )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Gets the URI with the fragment identifier removed.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.</dl><tr><th>Returns<tr><td><dl>Everything preceding the hash mark.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l969">code &raquo;</a><span class="member"><a name="goog.uri.utils.removeParam">goog.uri.utils.removeParam</a> <span class="args">( uri, keyEncoded )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Removes all instances of a query parameter.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to process.  Must not contain a fragment.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI-encoded key.</dl><tr><th>Returns<tr><td><dl>The URI with all instances of the parameter removed.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l467">code &raquo;</a><span class="member"><a name="goog.uri.utils.setFragmentEncoded">goog.uri.utils.setFragmentEncoded</a> <span class="args">( uri, fragment )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The URI to examine.<dt>fragment: <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The encoded fragment identifier, or null if none.
+     Does not include the hash mark itself.</dl><tr><th>Returns<tr><td><dl>The URI with the fragment set.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1010">code &raquo;</a><span class="member"><a name="goog.uri.utils.setParam">goog.uri.utils.setParam</a> <span class="args">( uri, keyEncoded, value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Replaces all existing definitions of a parameter with a single definition.
 
  Repeated calls to this can exhibit quadratic behavior due to the need to
  find existing instances and reconstruct the string, though it should be
  limited given the 2kb limit.  Consider using appendParams to append multiple
  parameters in bulk.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The original URI, which may already have query data.<dt>keyEncoded: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The key, which must already be URI encoded.<dt>value: <code class="type">*</code><dd>The value, which will be stringized and encoded (assumed
-     not already to be encoded).</dl><tr><th>Returns<tr><td><dl>The URI with the query parameter added.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l238">code &raquo;</a><span class="member"><a name="goog.uri.utils.split">goog.uri.utils.split</a> <span class="args">( uri )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Splits a URI into its component parts.
+     not already to be encoded).</dl><tr><th>Returns<tr><td><dl>The URI with the query parameter added.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l1047">code &raquo;</a><span class="member"><a name="goog.uri.utils.setPath">goog.uri.utils.setPath</a> <span class="args">( uri, path )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Replaces the path.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>uri: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>URI to use as the base.<dt>path: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>New path.</dl><tr><th>Returns<tr><td><dl>Updated URI.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l238">code &raquo;</a><span class="member"><a name="goog.uri.utils.split">goog.uri.utils.split</a> <span class="args">( uri )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Splits a URI into its component parts.
 
  Each component can be accessed via the component indices; for example:
  <pre>
@@ -115,7 +116,7 @@
      Each component that is present will contain the encoded value, whereas
      components that are not present will be undefined or empty, depending
      on the browser's regular expression implementation.  Never null, since
-     arbitrary strings may still look like path names.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l865">code &raquo;</a><span class="member"><a name="goog.uri.utils.hashOrEndRe_">goog.uri.utils.hashOrEndRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for finding a hash mark or end of string.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l270">code &raquo;</a><span class="member"><a name="goog.uri.utils.needsPhishingProtection_">goog.uri.utils.needsPhishingProtection_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Safari has a nasty bug where if you have an http URL with a username, e.g.,
+     arbitrary strings may still look like path names.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l873">code &raquo;</a><span class="member"><a name="goog.uri.utils.hashOrEndRe_">goog.uri.utils.hashOrEndRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for finding a hash mark or end of string.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l270">code &raquo;</a><span class="member"><a name="goog.uri.utils.needsPhishingProtection_">goog.uri.utils.needsPhishingProtection_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Safari has a nasty bug where if you have an http URL with a username, e.g.,
  http://evil.com%2F@google.com/
  Safari will report that window.location.href is
  http://evil.com/google.com/
@@ -189,4 +190,4 @@
     $5 = /pub/ietf/uri/    path
     $6 = <undefined>       query without ?
     $7 = Related           fragment without #
- </pre></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l952">code &raquo;</a><span class="member"><a name="goog.uri.utils.trailingQueryPunctuationRe_">goog.uri.utils.trailingQueryPunctuationRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regexp to find trailing question marks and ampersands.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ </pre></summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/uri/utils.js.src.html#l960">code &raquo;</a><span class="member"><a name="goog.uri.utils.trailingQueryPunctuationRe_">goog.uri.utils.trailingQueryPunctuationRe_</a> : <code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regexp to find trailing question marks and ampersands.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_userAgent.html b/docs/namespace_goog_userAgent.html
index 6630a3f..f36462f 100644
--- a/docs/namespace_goog_userAgent.html
+++ b/docs/namespace_goog_userAgent.html
@@ -1,38 +1,35 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.userAgent</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.userAgent</h1><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l23">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l509">code &raquo;</a><span class="member deprecation-notice"><a name="goog.userAgent.compare">goog.userAgent.compare</a> <span class="args">( v1, v2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.string.compareVersions.</span></div><p>Compares two version numbers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>v1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Version of first item.<dt>v2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Version of second item.</dl><tr><th>Returns<tr><td><dl>1 if first argument is higher
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>goog.userAgent</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace goog.userAgent</h1><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l23">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l466">code &raquo;</a><span class="member deprecation-notice"><a name="goog.userAgent.compare">goog.userAgent.compare</a> <span class="args">( v1, v2 )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.string.compareVersions.</span></div><p>Compares two version numbers.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>v1: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Version of first item.<dt>v2: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>Version of second item.</dl><tr><th>Returns<tr><td><dl>1 if first argument is higher
                    0 if arguments are equal
-                  -1 if second argument is higher.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l233">code &raquo;</a><span class="member"><a name="goog.userAgent.determinePlatform_">goog.userAgent.determinePlatform_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>the platform (operating system) the user agent is running
+                  -1 if second argument is higher.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l186">code &raquo;</a><span class="member"><a name="goog.userAgent.determinePlatform_">goog.userAgent.determinePlatform_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>the platform (operating system) the user agent is running
      on. Default to empty string because navigator.platform may not be defined
-     (on Rhino, for example).</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l439">code &raquo;</a><span class="member"><a name="goog.userAgent.determineVersion_">goog.userAgent.determineVersion_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The string that describes the version number of the user
-     agent.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l483">code &raquo;</a><span class="member"><a name="goog.userAgent.getDocumentMode_">goog.userAgent.getDocumentMode_</a> <span class="args">( )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Returns the document mode (for testing).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l95">code &raquo;</a><span class="member"><a name="goog.userAgent.getNavigator">goog.userAgent.getNavigator</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The native navigator object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l87">code &raquo;</a><span class="member"><a name="goog.userAgent.getUserAgentString">goog.userAgent.getUserAgentString</a> <span class="args">( )</span> &rArr; <code class="type">?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the userAgent string for the current browser.
- Some user agents (I'm thinking of you, Gears WorkerPool) do not expose a
- navigator object off the global scope.  In that case we return null.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The userAgent string or null if there is none.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l313">code &raquo;</a><span class="member"><a name="goog.userAgent.initPlatform_">goog.userAgent.initPlatform_</a> <span class="args">( )</span></span></div><p>Initialize the goog.userAgent constants that define which platform the user
- agent is running on.</summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l110">code &raquo;</a><span class="member"><a name="goog.userAgent.init_">goog.userAgent.init_</a> <span class="args">( )</span></span></div><p>Initializer for goog.userAgent.
-
- This is a named function so that it can be stripped via the jscompiler
- option for stripping types.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l576">code &raquo;</a><span class="member"><a name="goog.userAgent.isDocumentMode">goog.userAgent.isDocumentMode</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Deprecated alias to <code >goog.userAgent.isDocumentModeOrHigher</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The version to check.</dl><tr><th>Returns<tr><td><dl>Whether the IE effective document mode is higher or the
-      same as the given version.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l565">code &raquo;</a><span class="member"><a name="goog.userAgent.isDocumentModeOrHigher">goog.userAgent.isDocumentModeOrHigher</a> <span class="args">( documentMode )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the IE effective document mode is higher or the same as the given
+     (on Rhino, for example).</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l393">code &raquo;</a><span class="member"><a name="goog.userAgent.determineVersion_">goog.userAgent.determineVersion_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The string that describes the version number of the user
+     agent.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l440">code &raquo;</a><span class="member"><a name="goog.userAgent.getDocumentMode_">goog.userAgent.getDocumentMode_</a> <span class="args">( )</span> &rArr; <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Returns the document mode (for testing).</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l97">code &raquo;</a><span class="member"><a name="goog.userAgent.getNavigator">goog.userAgent.getNavigator</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>TODO(nnaze): Change type to "Navigator" and update compilation targets.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The native navigator object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l88">code &raquo;</a><span class="member"><a name="goog.userAgent.getUserAgentString">goog.userAgent.getUserAgentString</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Returns the userAgent string for the current browser.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The userAgent string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l266">code &raquo;</a><span class="member"><a name="goog.userAgent.initPlatform_">goog.userAgent.initPlatform_</a> <span class="args">( )</span></span></div><p>Initialize the goog.userAgent constants that define which platform the user
+ agent is running on.</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l534">code &raquo;</a><span class="member deprecation-notice"><a name="goog.userAgent.isDocumentMode">goog.userAgent.isDocumentMode</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.userAgent.isDocumentModeOrHigher().</span></div><p>Deprecated alias to <code >goog.userAgent.isDocumentModeOrHigher</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The version to check.</dl><tr><th>Returns<tr><td><dl>Whether the IE effective document mode is higher or the
+      same as the given version.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l522">code &raquo;</a><span class="member"><a name="goog.userAgent.isDocumentModeOrHigher">goog.userAgent.isDocumentModeOrHigher</a> <span class="args">( documentMode )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the IE effective document mode is higher or the same as the given
  document mode version.
  NOTE: Only for IE, return false for another browser.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>documentMode: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The document mode version to check.</dl><tr><th>Returns<tr><td><dl>Whether the IE effective document mode is higher or the
-     same as the given version.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l553">code &raquo;</a><span class="member deprecation-notice"><a name="goog.userAgent.isVersion">goog.userAgent.isVersion</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.userAgent.isVersionOrHigher().</span></div><p>Deprecated alias to <code >goog.userAgent.isVersionOrHigher</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The version to check.</dl><tr><th>Returns<tr><td><dl>Whether the user agent version is higher or the same as
-     the given version.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l538">code &raquo;</a><span class="member"><a name="goog.userAgent.isVersionOrHigher">goog.userAgent.isVersionOrHigher</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent version is higher or the same as the given version.
+     same as the given version.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l153">code &raquo;</a><span class="member"><a name="goog.userAgent.isMobile_">goog.userAgent.isMobile_</a> <span class="args">( )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a mobile device.
+
+ This is a separate function so that the logic can be tested.
+
+ TODO(nnaze): Investigate swapping in goog.labs.userAgent.device.isMobile().</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>Whether the user agent is running on a mobile device.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l510">code &raquo;</a><span class="member deprecation-notice"><a name="goog.userAgent.isVersion">goog.userAgent.isVersion</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use goog.userAgent.isVersionOrHigher().</span></div><p>Deprecated alias to <code >goog.userAgent.isVersionOrHigher</code>.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The version to check.</dl><tr><th>Returns<tr><td><dl>Whether the user agent version is higher or the same as
+     the given version.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l495">code &raquo;</a><span class="member"><a name="goog.userAgent.isVersionOrHigher">goog.userAgent.isVersionOrHigher</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent version is higher or the same as the given version.
  NOTE: When checking the version numbers for Firefox and Safari, be sure to
  use the engine's version, not the browser's version number.  For example,
  Firefox 3.0 corresponds to Gecko 1.9 and Safari 3.0 to Webkit 522.11.
  Opera and Internet Explorer versions match the product release number.<br></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The version to check.</dl><tr><th>Returns<tr><td><dl>Whether the user agent version is higher or the same as
-     the given version.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l414">code &raquo;</a><span class="member"><a name="goog.userAgent.ANDROID">goog.userAgent.ANDROID</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on Android.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l72">code &raquo;</a><span class="member"><a name="goog.userAgent.BROWSER_KNOWN_">goog.userAgent.BROWSER_KNOWN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether we know the browser engine at compile-time.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l587">code &raquo;</a><span class="member"><a name="goog.userAgent.DOCUMENT_MODE">goog.userAgent.DOCUMENT_MODE</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>For IE version < 7, documentMode is undefined, so attempt to use the
+     the given version.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l368">code &raquo;</a><span class="member"><a name="goog.userAgent.ANDROID">goog.userAgent.ANDROID</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on Android.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l75">code &raquo;</a><span class="member"><a name="goog.userAgent.BROWSER_KNOWN_">goog.userAgent.BROWSER_KNOWN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether we know the browser engine at compile-time.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l545">code &raquo;</a><span class="member"><a name="goog.userAgent.DOCUMENT_MODE">goog.userAgent.DOCUMENT_MODE</a> : <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Undefined">undefined</a>)</code></span></div><p>For IE version < 7, documentMode is undefined, so attempt to use the
  CSS1Compat property to see if we are in standards mode. If we are in
  standards mode, treat the browser version as the document mode. Otherwise,
- IE is emulating version 5.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l195">code &raquo;</a><span class="member"><a name="goog.userAgent.GECKO">goog.userAgent.GECKO</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is Gecko. Gecko is the rendering engine used by
- Mozilla, Mozilla Firefox, Camino and many more.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l186">code &raquo;</a><span class="member"><a name="goog.userAgent.IE">goog.userAgent.IE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is Internet Explorer. This includes other browsers
- using Trident as its rendering engine. For example AOL and Netscape 8</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l430">code &raquo;</a><span class="member"><a name="goog.userAgent.IPAD">goog.userAgent.IPAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on an iPad.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l422">code &raquo;</a><span class="member"><a name="goog.userAgent.IPHONE">goog.userAgent.IPHONE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on an iPhone.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l398">code &raquo;</a><span class="member"><a name="goog.userAgent.LINUX">goog.userAgent.LINUX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Linux operating system.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l382">code &raquo;</a><span class="member"><a name="goog.userAgent.MAC">goog.userAgent.MAC</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Macintosh operating system.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l214">code &raquo;</a><span class="member"><a name="goog.userAgent.MOBILE">goog.userAgent.MOBILE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a mobile device.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l177">code &raquo;</a><span class="member"><a name="goog.userAgent.OPERA">goog.userAgent.OPERA</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is Opera.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l245">code &raquo;</a><span class="member"><a name="goog.userAgent.PLATFORM">goog.userAgent.PLATFORM</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The platform (operating system) the user agent is running on. Default to
+ IE is emulating version 5.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l128">code &raquo;</a><span class="member"><a name="goog.userAgent.GECKO">goog.userAgent.GECKO</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is Gecko. Gecko is the rendering engine used by
+ Mozilla, Firefox, and others.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l118">code &raquo;</a><span class="member"><a name="goog.userAgent.IE">goog.userAgent.IE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is Internet Explorer.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l384">code &raquo;</a><span class="member"><a name="goog.userAgent.IPAD">goog.userAgent.IPAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on an iPad.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l376">code &raquo;</a><span class="member"><a name="goog.userAgent.IPHONE">goog.userAgent.IPHONE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on an iPhone.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l352">code &raquo;</a><span class="member"><a name="goog.userAgent.LINUX">goog.userAgent.LINUX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Linux operating system.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l336">code &raquo;</a><span class="member"><a name="goog.userAgent.MAC">goog.userAgent.MAC</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Macintosh operating system.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l167">code &raquo;</a><span class="member"><a name="goog.userAgent.MOBILE">goog.userAgent.MOBILE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a mobile device.
+
+ TODO(nnaze): Consider deprecating MOBILE when labs.userAgent
+   is promoted as the gecko/webkit logic is likely inaccurate.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l109">code &raquo;</a><span class="member"><a name="goog.userAgent.OPERA">goog.userAgent.OPERA</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is Opera.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l198">code &raquo;</a><span class="member"><a name="goog.userAgent.PLATFORM">goog.userAgent.PLATFORM</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The platform (operating system) the user agent is running on. Default to
  empty string because navigator.platform may not be defined (on Rhino, for
- example).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l298">code &raquo;</a><span class="member"><a name="goog.userAgent.PLATFORM_KNOWN_">goog.userAgent.PLATFORM_KNOWN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l224">code &raquo;</a><span class="member deprecation-notice"><a name="goog.userAgent.SAFARI">goog.userAgent.SAFARI</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="namespace_goog_userAgent_product.html#goog.userAgent.product.SAFARI">goog.userAgent.product.SAFARI</a></code> instead.
- TODO(nicksantos): Delete this from goog.userAgent.</span></div><p>Used while transitioning code to use WEBKIT instead.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l495">code &raquo;</a><span class="member"><a name="goog.userAgent.VERSION">goog.userAgent.VERSION</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The version of the user agent. This is a string because it might contain
- 'b' (as in beta) as well as multiple dots.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l205">code &raquo;</a><span class="member"><a name="goog.userAgent.WEBKIT">goog.userAgent.WEBKIT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is WebKit. WebKit is the rendering engine that
- Safari, Android and others use.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l390">code &raquo;</a><span class="member"><a name="goog.userAgent.WINDOWS">goog.userAgent.WINDOWS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Windows operating system.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l406">code &raquo;</a><span class="member"><a name="goog.userAgent.X11">goog.userAgent.X11</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a X11 windowing system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l355">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedAndroid_">goog.userAgent.detectedAndroid_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on Android.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l148">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedGecko_">goog.userAgent.detectedGecko_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent string denotes Gecko. Gecko is the rendering
- engine used by Mozilla, Mozilla Firefox, Camino and many more.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l369">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedIPad_">goog.userAgent.detectedIPad_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on an iPad.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l362">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedIPhone_">goog.userAgent.detectedIPhone_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on an iPhone.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l125">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedIe_">goog.userAgent.detectedIe_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent string denotes Internet Explorer. This includes
- other browsers using Trident as its rendering engine. For example AOL
- and Netscape 8</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l335">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedLinux_">goog.userAgent.detectedLinux_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Linux operating system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l319">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedMac_">goog.userAgent.detectedMac_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Macintosh operating system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l140">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedMobile_">goog.userAgent.detectedMobile_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent string denotes a mobile device.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l116">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedOpera_">goog.userAgent.detectedOpera_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent string denotes Opera.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l133">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedWebkit_">goog.userAgent.detectedWebkit_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent string denotes WebKit. WebKit is the rendering
- engine that Safari, Android and others use.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l327">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedWindows_">goog.userAgent.detectedWindows_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Windows operating system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l343">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedX11_">goog.userAgent.detectedX11_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a X11 windowing system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l521">code &raquo;</a><span class="member"><a name="goog.userAgent.isVersionOrHigherCache_">goog.userAgent.isVersionOrHigherCache_</a> : <code class="type">{}</code></span></div><p>Cache for <code  class="type"><a href="namespace_goog_userAgent.html#goog.userAgent.isVersionOrHigher">goog.userAgent.isVersionOrHigher</a></code>.
+ example).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l251">code &raquo;</a><span class="member"><a name="goog.userAgent.PLATFORM_KNOWN_">goog.userAgent.PLATFORM_KNOWN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l177">code &raquo;</a><span class="member deprecation-notice"><a name="goog.userAgent.SAFARI">goog.userAgent.SAFARI</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use <code  class="type"><a href="namespace_goog_userAgent_product.html#goog.userAgent.product.SAFARI">goog.userAgent.product.SAFARI</a></code> instead.
+ TODO(nicksantos): Delete this from goog.userAgent.</span></div><p>Used while transitioning code to use WEBKIT instead.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l452">code &raquo;</a><span class="member"><a name="goog.userAgent.VERSION">goog.userAgent.VERSION</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The version of the user agent. This is a string because it might contain
+ 'b' (as in beta) as well as multiple dots.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l138">code &raquo;</a><span class="member"><a name="goog.userAgent.WEBKIT">goog.userAgent.WEBKIT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is WebKit. WebKit is the rendering engine that
+ Safari, Android and others use.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l344">code &raquo;</a><span class="member"><a name="goog.userAgent.WINDOWS">goog.userAgent.WINDOWS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Windows operating system.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l360">code &raquo;</a><span class="member"><a name="goog.userAgent.X11">goog.userAgent.X11</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a X11 windowing system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l308">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedAndroid_">goog.userAgent.detectedAndroid_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on Android.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l323">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedIPad_">goog.userAgent.detectedIPad_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on an iPad.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l316">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedIPhone_">goog.userAgent.detectedIPhone_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on an iPhone.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l288">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedLinux_">goog.userAgent.detectedLinux_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Linux operating system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l272">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedMac_">goog.userAgent.detectedMac_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Macintosh operating system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l280">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedWindows_">goog.userAgent.detectedWindows_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a Windows operating system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l296">code &raquo;</a><span class="member"><a name="goog.userAgent.detectedX11_">goog.userAgent.detectedX11_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent is running on a X11 windowing system.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l478">code &raquo;</a><span class="member"><a name="goog.userAgent.isVersionOrHigherCache_">goog.userAgent.isVersionOrHigherCache_</a> : <code class="type">{}</code></span></div><p>Cache for <code  class="type"><a href="namespace_goog_userAgent.html#goog.userAgent.isVersionOrHigher">goog.userAgent.isVersionOrHigher</a></code>.
  Calls to compareVersions are surprisingly expensive and, as a browser's
- version number is unlikely to change during a session, we cache the results.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l279">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_ANDROID">goog.userAgent.ASSUME_ANDROID</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l64">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_ANY_VERSION">goog.userAgent.ASSUME_ANY_VERSION</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l37">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_GECKO">goog.userAgent.ASSUME_GECKO</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l31">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_IE">goog.userAgent.ASSUME_IE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l291">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_IPAD">goog.userAgent.ASSUME_IPAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l285">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_IPHONE">goog.userAgent.ASSUME_IPHONE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l266">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_LINUX">goog.userAgent.ASSUME_LINUX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l252">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_MAC">goog.userAgent.ASSUME_MAC</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l50">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_MOBILE_WEBKIT">goog.userAgent.ASSUME_MOBILE_WEBKIT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l56">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_OPERA">goog.userAgent.ASSUME_OPERA</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l43">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_WEBKIT">goog.userAgent.ASSUME_WEBKIT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l259">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_WINDOWS">goog.userAgent.ASSUME_WINDOWS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l273">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_X11">goog.userAgent.ASSUME_X11</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ version number is unlikely to change during a session, we cache the results.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l232">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_ANDROID">goog.userAgent.ASSUME_ANDROID</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l67">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_ANY_VERSION">goog.userAgent.ASSUME_ANY_VERSION</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l40">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_GECKO">goog.userAgent.ASSUME_GECKO</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l34">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_IE">goog.userAgent.ASSUME_IE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l244">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_IPAD">goog.userAgent.ASSUME_IPAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l238">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_IPHONE">goog.userAgent.ASSUME_IPHONE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l219">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_LINUX">goog.userAgent.ASSUME_LINUX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l205">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_MAC">goog.userAgent.ASSUME_MAC</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l53">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_MOBILE_WEBKIT">goog.userAgent.ASSUME_MOBILE_WEBKIT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l59">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_OPERA">goog.userAgent.ASSUME_OPERA</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l46">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_WEBKIT">goog.userAgent.ASSUME_WEBKIT</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l212">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_WINDOWS">goog.userAgent.ASSUME_WINDOWS</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/useragent.js.src.html#l226">code &raquo;</a><span class="member"><a name="goog.userAgent.ASSUME_X11">goog.userAgent.ASSUME_X11</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_goog_userAgent_product.html b/docs/namespace_goog_userAgent_product.html
index f06d154..4ad8688 100644
--- a/docs/namespace_goog_userAgent_product.html
+++ b/docs/namespace_goog_userAgent_product.html
@@ -6,4 +6,4 @@
  http://developer.yahoo.com/yui/articles/gbs/</summary></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/goog/useragent/product_isversion.js.src.html#l137">code &raquo;</a><span class="member"><a name="goog.userAgent.product.isVersion">goog.userAgent.product.isVersion</a> <span class="args">( version )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the user agent product version is higher or the same as the given
  version.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>version: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>)</code><dd>The version to check.</dl><tr><th>Returns<tr><td><dl>Whether the user agent product version is higher or the
      same as the given version.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l233">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ANDROID">goog.userAgent.product.ANDROID</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the default browser on an Android phone.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l206">code &raquo;</a><span class="member"><a name="goog.userAgent.product.CAMINO">goog.userAgent.product.CAMINO</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Camino web browser.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l242">code &raquo;</a><span class="member"><a name="goog.userAgent.product.CHROME">goog.userAgent.product.CHROME</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Chrome web browser.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l197">code &raquo;</a><span class="member"><a name="goog.userAgent.product.FIREFOX">goog.userAgent.product.FIREFOX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Firefox web browser.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l190">code &raquo;</a><span class="member"><a name="goog.userAgent.product.IE">goog.userAgent.product.IE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on an IE web browser.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l224">code &raquo;</a><span class="member"><a name="goog.userAgent.product.IPAD">goog.userAgent.product.IPAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on an iPad.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l215">code &raquo;</a><span class="member"><a name="goog.userAgent.product.IPHONE">goog.userAgent.product.IPHONE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on an iPhone or iPod touch.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l183">code &raquo;</a><span class="member"><a name="goog.userAgent.product.OPERA">goog.userAgent.product.OPERA</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Opera web browser.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l75">code &raquo;</a><span class="member"><a name="goog.userAgent.product.PRODUCT_KNOWN_">goog.userAgent.product.PRODUCT_KNOWN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether we know the product type at compile-time.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l251">code &raquo;</a><span class="member"><a name="goog.userAgent.product.SAFARI">goog.userAgent.product.SAFARI</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Safari web browser.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product_isversion.js.src.html#l126">code &raquo;</a><span class="member"><a name="goog.userAgent.product.VERSION">goog.userAgent.product.VERSION</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>The version of the user agent. This is a string because it might contain
- 'b' (as in beta) as well as multiple dots.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l130">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedAndroid_">goog.userAgent.product.detectedAndroid_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the default browser on an Android phone.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l109">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedCamino_">goog.userAgent.product.detectedCamino_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Camino web browser.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l137">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedChrome_">goog.userAgent.product.detectedChrome_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Chrome web browser.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l102">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedFirefox_">goog.userAgent.product.detectedFirefox_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Firefox web browser.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l123">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedIpad_">goog.userAgent.product.detectedIpad_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on an iPad</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l116">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedIphone_">goog.userAgent.product.detectedIphone_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on an iPhone or iPod touch.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l144">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedSafari_">goog.userAgent.product.detectedSafari_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Safari web browser.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l55">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_ANDROID">goog.userAgent.product.ASSUME_ANDROID</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l34">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_CAMINO">goog.userAgent.product.ASSUME_CAMINO</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l61">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_CHROME">goog.userAgent.product.ASSUME_CHROME</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l28">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_FIREFOX">goog.userAgent.product.ASSUME_FIREFOX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l48">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_IPAD">goog.userAgent.product.ASSUME_IPAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l41">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_IPHONE">goog.userAgent.product.ASSUME_IPHONE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l67">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_SAFARI">goog.userAgent.product.ASSUME_SAFARI</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ 'b' (as in beta) as well as multiple dots.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l130">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedAndroid_">goog.userAgent.product.detectedAndroid_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the default browser on an Android phone.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l109">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedCamino_">goog.userAgent.product.detectedCamino_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Camino web browser.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l137">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedChrome_">goog.userAgent.product.detectedChrome_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Chrome web browser.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l102">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedFirefox_">goog.userAgent.product.detectedFirefox_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Firefox web browser.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l123">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedIpad_">goog.userAgent.product.detectedIpad_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on an iPad</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l116">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedIphone_">goog.userAgent.product.detectedIphone_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on an iPhone or iPod touch.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l144">code &raquo;</a><span class="member"><a name="goog.userAgent.product.detectedSafari_">goog.userAgent.product.detectedSafari_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the code is running on the Safari web browser.</summary></details></div></div></section><section id="compiler-constants"><h2>Compiler Constants</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l55">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_ANDROID">goog.userAgent.product.ASSUME_ANDROID</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l34">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_CAMINO">goog.userAgent.product.ASSUME_CAMINO</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l61">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_CHROME">goog.userAgent.product.ASSUME_CHROME</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l28">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_FIREFOX">goog.userAgent.product.ASSUME_FIREFOX</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l48">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_IPAD">goog.userAgent.product.ASSUME_IPAD</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l41">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_IPHONE">goog.userAgent.product.ASSUME_IPHONE</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/goog/useragent/product.js.src.html#l67">code &raquo;</a><span class="member"><a name="goog.userAgent.product.ASSUME_SAFARI">goog.userAgent.product.ASSUME_SAFARI</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div></summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_webdriver.html b/docs/namespace_webdriver.html
index c4413ef..562a2c6 100644
--- a/docs/namespace_webdriver.html
+++ b/docs/namespace_webdriver.html
@@ -1,4 +1,30 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver</h1><a class="source" href="source/lib/webdriver/command.js.src.html#l19">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_webdriver_CommandExecutor.html">webdriver.CommandExecutor</a><dd>Handles the execution of <code >webdriver.Command</code> objects.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_AbstractBuilder.html">webdriver.AbstractBuilder</a><dd>Creates new <code >webdriver.WebDriver</code> clients.<dt><a href="class_webdriver_ActionSequence.html">webdriver.ActionSequence</a><dd>Class for defining sequences of complex user interactions.<dt><a href="class_webdriver_Alert.html">webdriver.Alert</a><dd>Represents a modal dialog such as <code >alert</code>, <code >confirm</code>, or
- <code >prompt</code>.<dt><a href="class_webdriver_Builder.html">webdriver.Builder</a><dd>No Description.<dt><a href="class_webdriver_Capabilities.html">webdriver.Capabilities</a><dd>No Description.<dt><a href="class_webdriver_Command.html">webdriver.Command</a><dd>Describes a command to be executed by the WebDriverJS framework.<dt><a href="class_webdriver_EventEmitter.html">webdriver.EventEmitter</a><dd>Object that can emit events for others to listen for.<dt><a href="class_webdriver_FirefoxDomExecutor.html">webdriver.FirefoxDomExecutor</a><dd>No Description.<dt><a href="class_webdriver_Locator.html">webdriver.Locator</a><dd>An element locator.<dt><a href="class_webdriver_Session.html">webdriver.Session</a><dd>Contains information about a WebDriver session.<dt><a href="class_webdriver_UnhandledAlertError.html">webdriver.UnhandledAlertError</a><dd>An error returned to indicate that there is an unhandled modal dialog on the
- current page.<dt><a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a><dd>Creates a new WebDriver client, which provides control over a browser.<dt><a href="class_webdriver_WebElement.html">webdriver.WebElement</a><dd>Represents a DOM element.</dl></table></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_webdriver_Browser.html">webdriver.Browser</a><dd>Recognized browser names.<dt><a href="enum_webdriver_Button.html">webdriver.Button</a><dd>Enumeration of the buttons used in the advanced interactions API.<dt><a href="enum_webdriver_Capability.html">webdriver.Capability</a><dd>Common webdriver capability keys.<dt><a href="enum_webdriver_CommandName.html">webdriver.CommandName</a><dd>Enumeration of predefined names command names that all command processors
- will support.<dt><a href="enum_webdriver_Key.html">webdriver.Key</a><dd>Representations of pressable keys that aren't text.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver</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><div class="codelink"><a href="source/lib/webdriver/serializable.js.src.html#l18">View Source</a></div><h1>namespace webdriver</h1><h2>Types</h2><dl><dt><a href="class_webdriver_ActionSequence.html">ActionSequence</a><dd><p>Class for defining sequences of complex user interactions.</p>
+<dt><a href="class_webdriver_Alert.html">Alert</a><dd><p>Represents a modal dialog such as <code>alert</code>, <code>confirm</code>, or
+<code>prompt</code>.</p>
+<dt><a href="class_webdriver_AlertPromise.html">AlertPromise</a><dd><p>AlertPromise is a promise that will be fulfilled with an Alert.</p>
+<dt><a href="enum_webdriver_Browser.html">Browser</a><dd><p>Recognized browser names.</p>
+<dt><a href="enum_webdriver_Button.html">Button</a><dd><p>Enumeration of the buttons used in the advanced interactions API.</p>
+<dt><a href="class_webdriver_Capabilities.html">Capabilities</a><dd><p>No description.</p>
+<dt><a href="enum_webdriver_Capability.html">Capability</a><dd><p>Common webdriver capability keys.</p>
+<dt><a href="class_webdriver_Command.html">Command</a><dd><p>Describes a command to be executed by the WebDriverJS framework.</p>
+<dt><a href="interface_webdriver_CommandExecutor.html">CommandExecutor</a><dd><p>Handles the execution of WebDriver <a href="class_webdriver_Command.html"><code>commands</code></a>.</p>
+<dt><a href="enum_webdriver_CommandName.html">CommandName</a><dd><p>Enumeration of predefined names command names that all command processors
+will support.</p>
+<dt><a href="class_webdriver_EventEmitter.html">EventEmitter</a><dd><p>Object that can emit events for others to listen for.</p>
+<dt><a href="class_webdriver_FileDetector.html">FileDetector</a><dd><p>Used with <a href="class_webdriver_WebElement.html#sendKeys"><code>WebElement#sendKeys</code></a> on file
+input elements (<code>&lt;input type&#61;&#34;file&#34;&gt;</code>) to detect when the entered key
+sequence defines the path to a file.</p>
+<dt><a href="enum_webdriver_Key.html">Key</a><dd><p>Representations of pressable keys that aren&#39;t text.</p>
+<dt><a href="class_webdriver_Locator.html">Locator</a><dd><p>An element locator.</p>
+<dt><a href="class_webdriver_Serializable.html">Serializable</a><dd><p>Defines an object that can be asynchronously serialized to its WebDriver
+wire representation.</p>
+<dt><a href="class_webdriver_Session.html">Session</a><dd><p>Contains information about a WebDriver session.</p>
+<dt><a href="class_webdriver_TouchSequence.html">TouchSequence</a><dd><p>Class for defining sequences of user touch interactions.</p>
+<dt><a href="class_webdriver_UnhandledAlertError.html">UnhandledAlertError</a><dd><p>An error returned to indicate that there is an unhandled modal dialog on the
+current page.</p>
+<dt><a href="class_webdriver_WebDriver.html">WebDriver</a><dd><p>Creates a new WebDriver client, which provides control over a browser.</p>
+<dt><a href="class_webdriver_WebElement.html">WebElement</a><dd><p>Represents a DOM element.</p>
+<dt><a href="class_webdriver_WebElementPromise.html">WebElementPromise</a><dd><p>WebElementPromise is a promise that will be fulfilled with a WebElement.</p>
+</dl><h2>Type Definitions</h2><div id="webdriver.ProxyConfig" class="property"><dl><dt><a href="source/lib/webdriver/capabilities.js.src.html#l65">webdriver.ProxyConfig</a><code>{proxyType: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}</code><dd><p>Describes how a proxy should be configured for a WebDriver session.
+Proxy configuration object, as defined by the WebDriver wire protocol.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_By.html b/docs/namespace_webdriver_By.html
index 342af00..dbadc13 100644
--- a/docs/namespace_webdriver_By.html
+++ b/docs/namespace_webdriver_By.html
@@ -1,26 +1,56 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.By</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver.By</h1><a class="source" href="source/lib/webdriver/locators.js.src.html#l68">code &raquo;</a></header><section><p>A collection of factory functions for creating <code  class="type"><a href="class_webdriver_Locator.html">webdriver.Locator</a></code>
- instances.</section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l96">code &raquo;</a><a class="member" name="webdriver.By.Hash">webdriver.By.Hash</a> : <code class="type">({className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code></div><div>Short-hand expressions for the primary element locator strategies.
- For example the following two statements are equivalent:
- <code><pre>
- var e1 = driver.findElement(webdriver.By.id('foo'));
- var e2 = driver.findElement({id: 'foo'});
- </pre></code>
-
- <p>Care should be taken when using JavaScript minifiers (such as the
- Closure compiler), as locator hashes will always be parsed using
- the un-obfuscated properties listed below.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l108">code &raquo;</a><span class="member"><a name="webdriver.By.className">webdriver.By.className</a> <span class="args">( className )</span> &rArr; <code class="type">!<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Locates elements that have a specific class name. The returned locator
- is equivalent to searching for elements with the CSS selector ".clazz".</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>className: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The class name to search for.</dl><tr><th>Returns<tr><td><dl>The new locator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l121">code &raquo;</a><span class="member"><a name="webdriver.By.css">webdriver.By.css</a> <span class="args">( selector )</span> &rArr; <code class="type">!<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Locates elements using a CSS selector. For browsers that do not support
- CSS selectors, WebDriver implementations may return an
- <code  class="type"><a href="enum_bot_Error_State.html#bot.Error.State.INVALID_SELECTOR">invalid selector</a></code> error. An
- implementation may, however, emulate the CSS selector API.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>selector: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The CSS selector to use.</dl><tr><th>Returns<tr><td><dl>The new locator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l130">code &raquo;</a><span class="member"><a name="webdriver.By.id">webdriver.By.id</a> <span class="args">( id )</span> &rArr; <code class="type">!<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Locates an element by its ID.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>id: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The ID to search for.</dl><tr><th>Returns<tr><td><dl>The new locator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l153">code &raquo;</a><span class="member"><a name="webdriver.By.js">webdriver.By.js</a> <span class="args">( script, var_args )</span> &rArr; <code class="type">function(!<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): !<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Locates an elements by evaluating a
- <code  class="type"><a href="class_webdriver_WebDriver.html#executeScript">JavaScript expression</a></code>.
- The result of this expression must be an element or list of elements.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>script: <code class="type">!(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>)</code><dd>The script to execute.<dt>var_args: <code class="type">...*</code><dd>The arguments to pass to the script.</dl><tr><th>Returns<tr><td><dl>A new,
-     JavaScript-based locator function.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l140">code &raquo;</a><span class="member"><a name="webdriver.By.linkText">webdriver.By.linkText</a> <span class="args">( text )</span> &rArr; <code class="type">!<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Locates link elements whose <code  class="type"><a href="class_webdriver_WebElement.html#getText">visible
- text</a></code> matches the given string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>text: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The link text to search for.</dl><tr><th>Returns<tr><td><dl>The new locator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l167">code &raquo;</a><span class="member"><a name="webdriver.By.name">webdriver.By.name</a> <span class="args">( name )</span> &rArr; <code class="type">!<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Locates elements whose <code >name</code> attribute has the given value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The name attribute to search for.</dl><tr><th>Returns<tr><td><dl>The new locator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l177">code &raquo;</a><span class="member"><a name="webdriver.By.partialLinkText">webdriver.By.partialLinkText</a> <span class="args">( text )</span> &rArr; <code class="type">!<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Locates link elements whose <code  class="type"><a href="class_webdriver_WebElement.html#getText">visible
- text</a></code> contains the given substring.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>text: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The substring to check for in a link's visible text.</dl><tr><th>Returns<tr><td><dl>The new locator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l189">code &raquo;</a><span class="member"><a name="webdriver.By.tagName">webdriver.By.tagName</a> <span class="args">( text )</span> &rArr; <code class="type">!<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Locates elements with a given tag name. The returned locator is
- equivalent to using the <code >getElementsByTagName</code> DOM function.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>text: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The substring to check for in a link's visible text.</dl><tr><th>Returns<tr><td><dl>The new locator.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/locators.js.src.html#l204">code &raquo;</a><span class="member"><a name="webdriver.By.xpath">webdriver.By.xpath</a> <span class="args">( xpath )</span> &rArr; <code class="type">!<a href="class_webdriver_Locator.html">webdriver.Locator</a></code></span></div><p>Locates elements matching a XPath selector. Care should be taken when
- using an XPath selector with a <code  class="type"><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code> as WebDriver
- will respect the context in the specified in the selector. For example,
- given the selector <code >&quot;//div&quot;</code>, WebDriver will search from the
- document root regardless of whether the locator was used with a
- WebElement.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>xpath: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The XPath selector to use.</dl><tr><th>Returns<tr><td><dl>The new locator.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.By</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><div class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l71">View Source</a></div><h1>namespace webdriver.By</h1><p>A collection of factory functions for creating <a href="class_webdriver_Locator.html"><code>webdriver.Locator</code></a>
+instances.</p>
+<h2>Functions</h2><div id="className" class="function"><div><h3>className(<wbr>className)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l110">code »</a></span></h3><p>Locates elements that have a specific class name. The returned locator
+is equivalent to searching for elements with the CSS selector &#34;.clazz&#34;.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>className<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The class name to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="css" class="function"><div><h3>css(<wbr>selector)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l123">code »</a></span></h3><p>Locates elements using a CSS selector. For browsers that do not support
+CSS selectors, WebDriver implementations may return an
+<a href="enum_bot_Error_State.html#INVALID_SELECTOR">invalid selector</a> error. An
+implementation may, however, emulate the CSS selector API.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>selector<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The CSS selector to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="id" class="function"><div><h3>id(<wbr>id)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l132">code »</a></span></h3><p>Locates an element by its ID.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>id<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The ID to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="js" class="function"><div><h3>js(<wbr>script, var_args)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l155">code »</a></span></h3><p>Locates an elements by evaluating a
+<a href="class_webdriver_WebDriver.html#executeScript">JavaScript expression</a>.
+The result of this expression must be an element or list of elements.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>script<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>|Function)</code><dd><p>The script to execute.</p>
+<dt>var_args<code>...*</code><dd><p>The arguments to pass to the script.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>function(<a href="class_webdriver_WebDriver.html">webdriver.WebDriver</a>): <a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new,
+JavaScript-based locator function.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="linkText" class="function"><div><h3>linkText(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l142">code »</a></span></h3><p>Locates link elements whose <a href="class_webdriver_WebElement.html#getText">visible
+text</a> matches the given string.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The link text to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="name" class="function"><div><h3>name(<wbr>name)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l169">code »</a></span></h3><p>Locates elements whose <code>name</code> attribute has the given value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The name attribute to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="partialLinkText" class="function"><div><h3>partialLinkText(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l179">code »</a></span></h3><p>Locates link elements whose <a href="class_webdriver_WebElement.html#getText">visible
+text</a> contains the given substring.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring to check for in a link&#39;s visible text.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="tagName" class="function"><div><h3>tagName(<wbr>text)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l193">code »</a></span></h3><p>Locates elements with a given tag name. The returned locator is
+equivalent to using the
+<a href="https://developer.mozilla.org/en-US/docs/Web/API/Element.getElementsByTagName">getElementsByTagName</a>
+DOM function.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring to check for in a link&#39;s visible text.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="xpath" class="function"><div><h3>xpath(<wbr>xpath)<span class="codelink"><a href="source/lib/webdriver/locators.js.src.html#l208">code »</a></span></h3><p>Locates elements matching a XPath selector. Care should be taken when
+using an XPath selector with a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a> as WebDriver
+will respect the context in the specified in the selector. For example,
+given the selector <code>&#34;//div&#34;</code>, WebDriver will search from the
+document root regardless of whether the locator was used with a
+WebElement.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>xpath<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The XPath selector to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_Locator.html">webdriver.Locator</a></code><dd><p>The new locator.</p>
+</dl></div></div></div></div><h2>Type Definitions</h2><div id="By.Hash" class="property"><dl><dt><a href="source/lib/webdriver/locators.js.src.html#l98">By.Hash</a><code>({className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>Short-hand expressions for the primary element locator strategies.
+For example the following two statements are equivalent:</p>
+<pre><code>var e1 &#61; driver.findElement(webdriver.By.id(&#39;foo&#39;));
+var e2 &#61; driver.findElement({id: &#39;foo&#39;});
+</code></pre>
+<p>Care should be taken when using JavaScript minifiers (such as the
+Closure compiler), as locator hashes will always be parsed using
+the un-obfuscated properties listed.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_http.html b/docs/namespace_webdriver_http.html
index 19bb8c3..7cdabfe 100644
--- a/docs/namespace_webdriver_http.html
+++ b/docs/namespace_webdriver_http.html
@@ -1,4 +1,6 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.http</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver.http</h1><a class="source" href="source/lib/webdriver/http/http.js.src.html#l20">code &raquo;</a></header><section></section><section><h2>Interfaces</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="interface_webdriver_http_Client.html">webdriver.http.Client</a><dd>Interface used for sending individual HTTP requests to the server.</dl></table></div></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_http_CorsClient.html">webdriver.http.CorsClient</a><dd>Communicates with a WebDriver server, which may be on a different domain,
- using the <a href="http://www.w3.org/TR/cors/">cross-origin resource sharing
- </a> (CORS) extension to WebDriver's JSON wire protocol.<dt><a href="class_webdriver_http_Executor.html">webdriver.http.Executor</a><dd>A command executor that communicates with a server using the WebDriver
- command protocol.<dt><a href="class_webdriver_http_Request.html">webdriver.http.Request</a><dd>Describes a partial HTTP request.<dt><a href="class_webdriver_http_Response.html">webdriver.http.Response</a><dd>Represents a HTTP response.<dt><a href="class_webdriver_http_XhrClient.html">webdriver.http.XhrClient</a><dd>A HTTP client that sends requests using XMLHttpRequests.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/http/http.js.src.html#l323">code &raquo;</a><span class="member"><a name="webdriver.http.headersToString_">webdriver.http.headersToString_</a> <span class="args">( headers )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Converts a headers object to a HTTP header block string.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>headers: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>&gt;</code><dd>The headers object to convert.</dl><tr><th>Returns<tr><td><dl>The headers as a string.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.http</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><div class="codelink"><a href="source/lib/webdriver/http/http.js.src.html#l23">View Source</a></div><h1>namespace webdriver.http</h1><h2>Types</h2><dl><dt><a href="interface_webdriver_http_Client.html">Client</a><dd><p>Interface used for sending individual HTTP requests to the server.</p>
+<dt><a href="class_webdriver_http_Executor.html">Executor</a><dd><p>A command executor that communicates with a server using the WebDriver
+command protocol.</p>
+<dt><a href="class_webdriver_http_Request.html">Request</a><dd><p>Describes a partial HTTP request.</p>
+<dt><a href="class_webdriver_http_Response.html">Response</a><dd><p>Represents a HTTP response.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_logging.html b/docs/namespace_webdriver_logging.html
index 2cd469f..34e6fce 100644
--- a/docs/namespace_webdriver_logging.html
+++ b/docs/namespace_webdriver_logging.html
@@ -1,4 +1,70 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.logging</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver.logging</h1><a class="source" href="source/lib/webdriver/logging.js.src.html#l16">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_logging_Entry.html">webdriver.logging.Entry</a><dd>A single log entry.</dl></table></div></section><section><h2>Enumerations</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="enum_webdriver_logging_Level.html">webdriver.logging.Level</a><dd>Logging levels.<dt><a href="enum_webdriver_logging_LevelName.html">webdriver.logging.LevelName</a><dd>Log level names from WebDriver's JSON wire protocol.<dt><a href="enum_webdriver_logging_Type.html">webdriver.logging.Type</a><dd>Common log types.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="typedefs"><h2>Type Definitions</h2><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/logging.js.src.html#l90">code &raquo;</a><a class="member" name="webdriver.logging.Preferences">webdriver.logging.Preferences</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>.&lt;<a href="enum_webdriver_logging_Type.html">webdriver.logging.Type</a>, <a href="enum_webdriver_logging_LevelName.html">webdriver.logging.LevelName</a>&gt;</code></div><div>A hash describing log preferences.</div></summary></details></div></div></section><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/logging.js.src.html#l58">code &raquo;</a><span class="member"><a name="webdriver.logging.getLevel">webdriver.logging.getLevel</a> <span class="args">( nameOrValue )</span> &rArr; <code class="type">!<a href="enum_webdriver_logging_Level.html">webdriver.logging.Level</a></code></span></div><p>Converts a level name or value to a <code  class="type"><a href="enum_webdriver_logging_Level.html">webdriver.logging.Level</a></code> value.
- If the name/value is not recognized, <code  class="type"><a href="enum_webdriver_logging_Level.html#webdriver.logging.Level.ALL">webdriver.logging.Level.ALL</a></code>
- will be returned.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>nameOrValue: <code class="type">(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd>The log level name, or value, to
-     convert .</dl><tr><th>Returns<tr><td><dl>The converted level.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.logging</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><div class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l67">View Source</a></div><h1>namespace webdriver.logging</h1><p>Defines WebDriver&#39;s logging system. The logging system is
+broken into major components: local and remote logging.</p>
+<p>The local logging API, which is anchored by the
+<a href="class_webdriver_logging_Logger.html"><code>Logger</code></a> class, is similar to Java&#39;s
+logging API. Loggers, retrieved by <a href="namespace_webdriver_logging.html#getLogger"><code>webdriver.logging.getLogger</code></a>, use
+hierarchical, dot-delimited namespaces
+(e.g. &#34;&#34; &gt; &#34;webdriver&#34; &gt; &#34;webdriver.logging&#34;). Recorded log messages are
+represented by the <a href="class_webdriver_logging_LogRecord.html"><code>LogRecord</code></a> class. You
+can capture log records by
+<a href="class_webdriver_logging_Logger.html#addHandler">attaching</a> a handler function
+to the desired logger. For convenience, you can quickly enable logging to
+the console by simply calling
+<a href="namespace_webdriver_logging.html#installConsoleHandler"><code>webdriver.logging.installConsoleHandler()</code></a>.</p>
+<p>The <a href="https://github.com/SeleniumHQ/selenium/wiki/Logging">remote logging API</a>
+allows you to retrieve logs from a remote WebDriver server. This API uses the
+<a href="class_webdriver_logging_Preferences.html"><code>Preferences</code></a> class to define desired log levels prior to create a
+WebDriver session:</p>
+<pre><code>var prefs &#61; new webdriver.logging.Preferences();
+prefs.setLevel(webdriver.logging.Type.BROWSER,
+               webdriver.logging.Level.DEBUG);
+
+var caps &#61; webdriver.Capabilities.chrome();
+caps.setLoggingPrefs(prefs);
+// ...
+</code></pre>
+<p>Remote log entries are represented by the <a href="class_webdriver_logging_Entry.html"><code>Entry</code></a> class and may be
+retrieved via <a href="class_webdriver_WebDriver_Logs.html"><code>webdriver.WebDriver.Logs</code></a>:</p>
+<pre><code>driver.manage().logs().get(webdriver.logging.Type.BROWSER)
+    .then(function(entries) {
+       entries.forEach(function(entry) {
+         console.log(&#39;[%s] %s&#39;, entry.level.name, entry.message);
+       });
+    });
+</code></pre>
+<p><strong>NOTE:</strong> Only a few browsers support the remote logging API (notably
+Firefox and Chrome). Firefox supports basic logging functionality, while
+Chrome exposes robust
+<a href="https://sites.google.com/a/chromium.org/chromedriver/logging">performance logging</a>
+options. Remote logging is still considered a non-standard feature, and the
+APIs exposed by this module for it are non-frozen. Once logging is officially
+defined by the <a href="http://www.w3.org/TR/webdriver/">W3C WebDriver spec</a>, this
+module will be updated to use a consistent API for local and remote logging.</p>
+<h2>Functions</h2><div id="addConsoleHandler" class="function"><div><h3>addConsoleHandler(<wbr>opt_logger)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l149">code »</a></span></h3><p>Adds the console handler to the given logger. The console handler will log
+all messages using the JavaScript Console API.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_logger<code>?<a href="class_webdriver_logging_Logger.html">webdriver.logging.Logger</a>=</code><dd><p>The logger to add the handler to; defaults
+to the root logger.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLevel" class="function"><div><h3>getLevel(<wbr>nameOrValue)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l199">code »</a></span></h3><p>Converts a level name or value to a <a href="class_webdriver_logging_Level.html"><code>webdriver.logging.Level</code></a> value.
+If the name/value is not recognized, <a href="class_webdriver_logging_Level.html#Level.ALL"><code>webdriver.logging.Level.ALL</code></a>
+will be returned.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>nameOrValue<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>)</code><dd><p>The log level name, or value, to
+convert .</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Level.html">webdriver.logging.Level</a></code><dd><p>The converted level.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getLogger" class="function"><div><h3>getLogger(<wbr>opt_name)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l107">code »</a></span></h3><p>Finds a named logger.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>=</code><dd><p>The dot-delimited logger name, such as
+&#34;webdriver.logging.Logger&#34;. Defaults to the name of the root logger.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_logging_Logger.html">webdriver.logging.Logger</a></code><dd><p>The named logger.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="installConsoleHandler" class="function"><div><h3>installConsoleHandler()<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l159">code »</a></span></h3><p>Installs the console log handler on the root logger.</p>
+</div></div><hr class="fn-sep"><div id="removeConsoleHandler" class="function"><div><h3>removeConsoleHandler(<wbr>opt_logger)<span class="codelink"><a href="source/lib/webdriver/logging.js.src.html#l171">code »</a></span></h3><p>Removes the console log handler from the given logger.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_logger<code>?<a href="class_webdriver_logging_Logger.html">webdriver.logging.Logger</a>=</code><dd><p>The logger to remove the handler from; defaults
+to the root logger.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_logging_Entry.html">Entry</a><dd><p>A single log entry recorded by a WebDriver component, such as a remote
+WebDriver server.</p>
+<dt><a href="class_webdriver_logging_Level.html">Level</a><dd><p>The Level class defines a set of standard logging levels that
+can be used to control logging output.</p>
+<dt><a href="class_webdriver_logging_LogRecord.html">LogRecord</a><dd><p>LogRecord objects are used to pass logging requests between
+the logging framework and individual log Handlers.</p>
+<dt><a href="class_webdriver_logging_Logger.html">Logger</a><dd><p>The Logger is an object used for logging debug messages.</p>
+<dt><a href="class_webdriver_logging_Preferences.html">Preferences</a><dd><p>Describes the log preferences for a WebDriver session.</p>
+<dt><a href="enum_webdriver_logging_Type.html">Type</a><dd><p>No description.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_process.html b/docs/namespace_webdriver_process.html
index eafcd04..b8d1b2e 100644
--- a/docs/namespace_webdriver_process.html
+++ b/docs/namespace_webdriver_process.html
@@ -5,4 +5,4 @@
      object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/process.js.src.html#l63">code &raquo;</a><span class="member"><a name="webdriver.process.setEnv">webdriver.process.setEnv</a> <span class="args">( name, value )</span></span></div><p>Sets an environment value. If the new value is either null or undefined, the
      environment variable will be cleared.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The value to set.<dt>value: <code class="type">*</code><dd>The new value; will be coerced to a string.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/process.js.src.html#l74">code &raquo;</a><span class="member"><a name="webdriver.process.IS_NATIVE_PROCESS_">webdriver.process.IS_NATIVE_PROCESS_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current environment is using Node's native process object.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/process.js.src.html#l119">code &raquo;</a><span class="member"><a name="webdriver.process.PROCESS_">webdriver.process.PROCESS_</a> : <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code></span></div><p>The global process object to use. Will either be Node's global
  <code >process</code> object, or an approximation of it for use in a browser
- environment.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+ environment.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_promise.html b/docs/namespace_webdriver_promise.html
index e8f69c3..8724e17 100644
--- a/docs/namespace_webdriver_promise.html
+++ b/docs/namespace_webdriver_promise.html
@@ -1,79 +1,676 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.promise</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver.promise</h1><a class="source" href="source/lib/webdriver/promise.js.src.html#l49">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_promise_CanceledTaskError_.html">webdriver.promise.CanceledTaskError_</a><dd>Special error used to signal when a task is canceled because a previous
- task in the same frame failed.<dt><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a><dd>Handles the execution of scheduled tasks, each of which may be an
- asynchronous operation.<dt><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a><dd>Represents a value that will be resolved at some point in the future.<dt><a href="class_webdriver_promise_Frame_.html">webdriver.promise.Frame_</a><dd>An execution frame within a <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>.<dt><a href="class_webdriver_promise_Node_.html">webdriver.promise.Node_</a><dd>A single node in an <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>'s task tree.<dt><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a><dd>Represents the eventual value of a completed operation.<dt><a href="class_webdriver_promise_Task_.html">webdriver.promise.Task_</a><dd>A task to be executed by a <code  class="type"><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code>.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l751">code &raquo;</a><code class="type">&lt;T&gt;</code> <span class="member"><a name="webdriver.promise.all">webdriver.promise.all</a> <span class="args">( arr )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Given an array of promises, will return a promise that will be fulfilled
- with the fulfillment values of the input array's values. If any of the
- input array's promises are rejected, the returned promise will be rejected
- with the same reason.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code><dd>An array of
-     promises to wait on.</dl><tr><th>Returns<tr><td><dl>A promise that is
-     fulfilled with an array containing the fulfilled values of the
-     input array, or rejected with the same reason as the first
-     rejected value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l721">code &raquo;</a><span class="member"><a name="webdriver.promise.asap">webdriver.promise.asap</a> <span class="args">( value, callback, opt_errback )</span></span></div><p>Invokes the appropriate callback function as soon as a promised
- <code >value</code> is resolved. This function is similar to
- <code  class="type"><a href="namespace_webdriver_promise.html#webdriver.promise.when">webdriver.promise.when</a></code>, except it does not return a new promise.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to observe.<dt>callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to call when the value is
-     resolved successfully.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call when the value is
-     rejected.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l672">code &raquo;</a><span class="member"><a name="webdriver.promise.checkedNodeCall">webdriver.promise.checkedNodeCall</a> <span class="args">( fn )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Wraps a function that is assumed to be a node-style callback as its final
- argument. This callback takes two arguments: an error value (which will be
- null if the call succeeded), and the success value as the second argument.
- If the call fails, the returned promise will be rejected, otherwise it will
- be resolved with the result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>fn: <code class="type">!<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a></code><dd>The function to wrap.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     result of the provided function's callback.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2079">code &raquo;</a><span class="member"><a name="webdriver.promise.controlFlow">webdriver.promise.controlFlow</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The currently active control flow.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2110">code &raquo;</a><span class="member"><a name="webdriver.promise.createFlow">webdriver.promise.createFlow</a> <span class="args">( callback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Creates a new control flow. The provided callback will be invoked as the
- first task within the new flow, with the flow as its sole argument. Returns
- a promise that resolves to the callback result.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>callback: <code class="type">function(!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>)</code><dd>The entry point
-     to the newly created flow.</dl><tr><th>Returns<tr><td><dl>A promise that resolves to the callback
-     result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l629">code &raquo;</a><span class="member"><a name="webdriver.promise.defer">webdriver.promise.defer</a> <span class="args">( opt_canceller )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a></code></span></div><p>Creates a new deferred object.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_canceller: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>Function to call when cancelling the
-     computation of this instance's value.</dl><tr><th>Returns<tr><td><dl>The new deferred object.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l612">code &raquo;</a><span class="member"><a name="webdriver.promise.delayed">webdriver.promise.delayed</a> <span class="args">( ms )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Creates a promise that will be resolved at a set time in the future.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>ms: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd>The amount of time, in milliseconds, to wait before
-     resolving the promise.</dl><tr><th>Returns<tr><td><dl>The promise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l830">code &raquo;</a><code class="type">&lt;TYPE, SELF&gt;</code> <span class="member"><a name="webdriver.promise.filter">webdriver.promise.filter</a> <span class="args">( arr, fn, opt_self )</span></span></div><p>Calls a function for each element in an array, and if the function returns
- true adds the element to a new array.
-
- <p>If the return value of the filter function is a promise, this function
- will wait for it to be fulfilled before determining whether to insert the
- element into the new array.
-
- <p>If the filter function throws or returns a rejected promise, the promise
- returned by this function will be rejected with the same reason. Only the
- first failure will be reported; all subsequent errors will be silently
- ignored.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;TYPE&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code><dd>The
-     array to iterator over, or a promise that will resolve to said array.<dt>fn: <code class="type">function(this: SELF, TYPE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, !<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;TYPE&gt;): (<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>.&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;)</code><dd>The function
-     to call for each element in the array.<dt>opt_self: <code class="type">SELF=</code><dd>The object to be used as the value of 'this' within
-     <code >fn</code>.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l639">code &raquo;</a><span class="member"><a name="webdriver.promise.fulfilled">webdriver.promise.fulfilled</a> <span class="args">( opt_value )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Creates a promise that has been resolved with the given value.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_value: <code class="type">*=</code><dd>The resolved value.</dl><tr><th>Returns<tr><td><dl>The resolved promise.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l916">code &raquo;</a><span class="member"><a name="webdriver.promise.fullyResolveKeys_">webdriver.promise.fullyResolveKeys_</a> <span class="args">( obj )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>obj: <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>|<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>)</code><dd>the object to resolve.</dl><tr><th>Returns<tr><td><dl>A promise that will be resolved with the
-     input object once all of its values have been fully resolved.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l877">code &raquo;</a><span class="member"><a name="webdriver.promise.fullyResolveValue_">webdriver.promise.fullyResolveValue_</a> <span class="args">( value )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to fully resolve. If a promise, assumed to
-     already be resolved.</dl><tr><th>Returns<tr><td><dl>A promise for a fully resolved version
-     of the input value.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l862">code &raquo;</a><span class="member"><a name="webdriver.promise.fullyResolved">webdriver.promise.fullyResolved</a> <span class="args">( value )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Returns a promise that will be resolved with the input value in a
- fully-resolved state. If the value is an array, each element will be fully
- resolved. Likewise, if the value is an object, all keys will be fully
- resolved. In both cases, all nested arrays and objects will also be
- fully resolved.  All fields are resolved in place; the returned promise will
- resolve on <code >value</code> and not a copy.
-
- Warning: This function makes no checks against objects that contain
- cyclical references:
- <pre><code>
-   var value = {};
-   value['self'] = value;
-   webdriver.promise.fullyResolved(value);  // Stack overflow.
- </code></pre></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to fully resolve.</dl><tr><th>Returns<tr><td><dl>A promise for a fully resolved version
-     of the input value.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l581">code &raquo;</a><span class="member"><a name="webdriver.promise.isError_">webdriver.promise.isError_</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Tests if a value is an Error-like object. This is more than an straight
- instanceof check since the value may originate from another context.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to test.</dl><tr><th>Returns<tr><td><dl>Whether the value is an error.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l598">code &raquo;</a><span class="member"><a name="webdriver.promise.isPromise">webdriver.promise.isPromise</a> <span class="args">( value )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Determines whether a <code >value</code> should be treated as a promise.
- Any object whose "then" property is a function will be considered a promise.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to test.</dl><tr><th>Returns<tr><td><dl>Whether the value is a promise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l800">code &raquo;</a><code class="type">&lt;TYPE, SELF&gt;</code> <span class="member"><a name="webdriver.promise.map">webdriver.promise.map</a> <span class="args">( arr, fn, opt_self )</span></span></div><p>Calls a function for each element in an array and inserts the result into a
- new array, which is used as the fulfillment value of the promise returned
- by this function.
-
- <p>If the return value of the mapping function is a promise, this function
- will wait for it to be fulfilled before inserting it into the new array.
-
- <p>If the mapping function throws or returns a rejected promise, the
- promise returned by this function will be rejected with the same reason.
- Only the first failure will be reported; all subsequent errors will be
- silently ignored.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>arr: <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;TYPE&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>)</code><dd>The
-     array to iterator over, or a promise that will resolve to said array.<dt>fn: <code class="type">function(this: SELF, TYPE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, !<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a>.&lt;TYPE&gt;): ?</code><dd>The
-     function to call for each element in the array. This function should
-     expect three arguments (the element, the index, and the array itself.<dt>opt_self: <code class="type">SELF=</code><dd>The object to be used as the value of 'this' within
-     <code >fn</code>.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2096">code &raquo;</a><span class="member"><a name="webdriver.promise.popFlow_">webdriver.promise.popFlow_</a> <span class="args">( )</span></span></div></summary></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2090">code &raquo;</a><span class="member"><a name="webdriver.promise.pushFlow_">webdriver.promise.pushFlow_</a> <span class="args">( flow )</span></span></div></summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>flow: <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd>The new flow.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l655">code &raquo;</a><span class="member"><a name="webdriver.promise.rejected">webdriver.promise.rejected</a> <span class="args">( opt_reason )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Creates a promise that has been rejected with the given reason.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>opt_reason: <code class="type">*=</code><dd>The rejection reason; may be any value, but is
-     usually an Error or a string.</dl><tr><th>Returns<tr><td><dl>The rejected promise.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2068">code &raquo;</a><span class="member"><a name="webdriver.promise.setDefaultFlow">webdriver.promise.setDefaultFlow</a> <span class="args">( flow )</span></span></div><p>Changes the default flow to use when no others are active.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>flow: <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd>The new default flow.</dl><tr><th>Throws<tr><td><dl><dt><code class="type"><a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a></code><dd>If the default flow is not currently active.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l698">code &raquo;</a><span class="member"><a name="webdriver.promise.when">webdriver.promise.when</a> <span class="args">( value, opt_callback, opt_errback )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><p>Registers an observer on a promised <code >value</code>, returning a new promise
- that will be resolved when the value is. If <code >value</code> is not a promise,
- then the return promise will be immediately resolved.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to observe.<dt>opt_callback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call when the value is
-     resolved successfully.<dt>opt_errback: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function">Function</a>=</code><dd>The function to call when the value is
-     rejected.</dl><tr><th>Returns<tr><td><dl>A new promise.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2060">code &raquo;</a><span class="member"><a name="webdriver.promise.activeFlows_">webdriver.promise.activeFlows_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>A stack of active control flows, with the top of the stack used to schedule
- commands. When there are multiple flows on the stack, the flow at index N
- represents a callback triggered within a task owned by the flow at index
- N-1.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/promise.js.src.html#l2050">code &raquo;</a><span class="member"><a name="webdriver.promise.defaultFlow_">webdriver.promise.defaultFlow_</a> : <code class="type">!<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code></span></div><p>The default flow to use if no others are active.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.promise</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><div class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l615">View Source</a></div><h1>namespace webdriver.promise</h1><p>The promise module is centered around the
+<a href="class_webdriver_promise_ControlFlow.html">ControlFlow</a>, a class that
+coordinates the execution of asynchronous tasks. The ControlFlow allows users
+to focus on the imperative commands for their script without worrying about
+chaining together every single asynchronous action, which can be tedious and
+verbose. APIs may be layered on top of the control flow to read as if they
+were synchronous. For instance, the core
+<a href="class_webdriver_WebDriver.html">WebDriver</a> API is built on top of the
+control flow, allowing users to write</p>
+<pre><code>driver.get(&#39;http://www.google.com/ncr&#39;);
+driver.findElement({name: &#39;q&#39;}).sendKeys(&#39;webdriver&#39;);
+driver.findElement({name: &#39;btnGn&#39;}).click();
+</code></pre>
+<p>instead of</p>
+<pre><code>driver.get(&#39;http://www.google.com/ncr&#39;)
+.then(function() {
+  return driver.findElement({name: &#39;q&#39;});
+})
+.then(function(q) {
+  return q.sendKeys(&#39;webdriver&#39;);
+})
+.then(function() {
+  return driver.findElement({name: &#39;btnG&#39;});
+})
+.then(function(btnG) {
+  return btnG.click();
+});
+</code></pre>
+<h2>Tasks and Task Queues</h2>
+<p>The control flow is based on the concept of tasks and task queues. Tasks are
+functions that define the basic unit of work for the control flow to execute.
+Each task is scheduled via
+<a href="class_webdriver_promise_ControlFlow.html#execute"><code>ControlFlow#execute()</code></a>, which
+will return a <a href="class_webdriver_promise_Promise.html"><code>Promise</code></a> that will be resolved
+with the task&#39;s result.</p>
+<p>A task queue contains all of the tasks scheduled within a single turn of the
+<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop">JavaScript event loop</a>. The control flow will create a new task queue
+the first time a task is scheduled within an event loop.</p>
+<pre><code>var flow &#61; promise.controlFlow();
+flow.execute(foo);       // Creates a new task queue and inserts foo.
+flow.execute(bar);       // Inserts bar into the same queue as foo.
+setTimeout(function() {
+  flow.execute(baz);     // Creates a new task queue and inserts baz.
+}, 0);
+</code></pre>
+<p>Whenever the control flow creates a new task queue, it will automatically
+begin executing tasks in the next available turn of the event loop. This
+execution is scheduled using a &#34;micro-task&#34; timer, such as a (native)
+<code>Promise.then()</code> callback.</p>
+<pre><code>setTimeout(() &#61;&gt; console.log(&#39;a&#39;));
+Promise.resolve().then(() &#61;&gt; console.log(&#39;b&#39;));  // A native promise.
+flow.execute(() &#61;&gt; console.log(&#39;c&#39;));
+Promise.resolve().then(() &#61;&gt; console.log(&#39;d&#39;));
+setTimeout(() &#61;&gt; console.log(&#39;fin&#39;));
+// b
+// c
+// d
+// a
+// fin
+</code></pre>
+<p>In the example above, b/c/d is logged before a/fin because native promises
+and this module use &#34;micro-task&#34; timers, which have a higher priority than
+&#34;macro-tasks&#34; like <code>setTimeout</code>.</p>
+<h2>Task Execution</h2>
+<p>Upon creating a task queue, and whenever an exisiting queue completes a task,
+the control flow will schedule a micro-task timer to process any scheduled
+tasks. This ensures no task is ever started within the same turn of the
+JavaScript event loop in which it was scheduled, nor is a task ever started
+within the same turn that another finishes.</p>
+<p>When the execution timer fires, a single task will be dequeued and executed.
+There are several important events that may occur while executing a task
+function:</p>
+<ol><li>A new task queue is created by a call to
+<a href="class_webdriver_promise_ControlFlow.html#execute"><code>ControlFlow#execute()</code></a>. Any
+tasks scheduled within this task queue are considered subtasks of the
+current task.</li><li>The task function throws an error. Any scheduled tasks are immediately
+discarded and the task&#39;s promised result (previously returned by
+<a href="class_webdriver_promise_ControlFlow.html#execute"><code>ControlFlow#execute()</code></a>) is
+immediately rejected with the thrown error.</li><li>The task function returns sucessfully.</li></ol>
+<p>If a task function created a new task queue, the control flow will wait for
+that queue to complete before processing the task result. If the queue
+completes without error, the flow will settle the task&#39;s promise with the
+value originaly returned by the task function. On the other hand, if the task
+queue termintes with an error, the task&#39;s promise will be rejected with that
+error.</p>
+<pre><code>flow.execute(function() {
+  flow.execute(() &#61;&gt; console.log(&#39;a&#39;));
+  flow.execute(() &#61;&gt; console.log(&#39;b&#39;));
+});
+flow.execute(() &#61;&gt; console.log(&#39;c&#39;));
+// a
+// b
+// c
+</code></pre>
+<h2>Promise Integration</h2>
+<p>In addition to the <a href="class_webdriver_promise_ControlFlow.html"><code>ControlFlow</code></a> class,
+the promise module also exports a <a href="https://promisesaplus.com/">Promise/A&#43;</a>
+<a href="class_webdriver_promise_Promise.html">implementation</a> that is deeply
+integrated with the ControlFlow. First and foremost, each promise
+<a href="class_webdriver_promise_Promise.html#then">callback</a> is scheduled with the
+control flow as a task. As a result, each callback is invoked in its own turn
+of the JavaScript event loop with its own task queue. If any tasks are
+scheduled within a callback, the callback&#39;s promised result will not be
+settled until the task queue has completed.</p>
+<pre><code>promise.fulfilled().then(function() {
+  flow.execute(function() {
+    console.log(&#39;b&#39;);
+  });
+}).then(() &#61;&gt; console.log(&#39;a&#39;));
+// b
+// a
+</code></pre>
+<h3>Scheduling Promise Callbacks <a id="scheduling_callbacks"></a></h3>
+<p>How callbacks are scheduled in the control flow depends on when they are
+attached to the promise. Callbacks attached to a <em>previously</em> resolved
+promise are immediately enqueued as subtasks of the currently running task.</p>
+<pre><code>var p &#61; promise.fulfilled();
+flow.execute(function() {
+  flow.execute(() &#61;&gt; console.log(&#39;A&#39;));
+  p.then(      () &#61;&gt; console.log(&#39;B&#39;));
+  flow.execute(() &#61;&gt; console.log(&#39;C&#39;));
+  p.then(      () &#61;&gt; console.log(&#39;D&#39;));
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// A
+// B
+// C
+// D
+// fin
+</code></pre>
+<p>When a promise is resolved while a task function is on the call stack, any
+callbacks also registered in that stack frame are scheduled as if the promise
+were already resolved:</p>
+<pre><code>var d &#61; promise.defer();
+flow.execute(function() {
+  flow.execute(  () &#61;&gt; console.log(&#39;A&#39;));
+  d.promise.then(() &#61;&gt; console.log(&#39;B&#39;));
+  flow.execute(  () &#61;&gt; console.log(&#39;C&#39;));
+  d.promise.then(() &#61;&gt; console.log(&#39;D&#39;));
+
+  d.fulfill();
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// A
+// B
+// C
+// D
+// fin
+</code></pre>
+<p>If a promise is resolved while a task function is on the call stack, any
+previously registered callbacks (i.e. attached while the task was <em>not</em> on
+the call stack), act as <em>interrupts</em> and are inserted at the front of the
+task queue. If multiple promises are fulfilled, their interrupts are enqueued
+in the order the promises are resolved.</p>
+<pre><code>var d1 &#61; promise.defer();
+d1.promise.then(() &#61;&gt; console.log(&#39;A&#39;));
+
+var d2 &#61; promise.defer();
+d2.promise.then(() &#61;&gt; console.log(&#39;B&#39;));
+
+flow.execute(function() {
+  flow.execute(() &#61;&gt; console.log(&#39;C&#39;));
+  flow.execute(() &#61;&gt; console.log(&#39;D&#39;));
+  d1.fulfill();
+  d2.fulfill();
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// A
+// B
+// C
+// D
+// fin
+</code></pre>
+<p>Within a task function (or callback), each step of a promise chain acts as
+an interrupt on the task queue:</p>
+<pre><code>var d &#61; promise.defer();
+flow.execute(function() {
+  d.promise.
+      then(() &#61;&gt; console.log(&#39;A&#39;)).
+      then(() &#61;&gt; console.log(&#39;B&#39;)).
+      then(() &#61;&gt; console.log(&#39;C&#39;)).
+      then(() &#61;&gt; console.log(&#39;D&#39;));
+
+  flow.execute(() &#61;&gt; console.log(&#39;E&#39;));
+  d.fulfill();
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// A
+// B
+// C
+// D
+// E
+// fin
+</code></pre>
+<p>If there are multiple promise chains derived from a single promise, they are
+processed in the order created:</p>
+<pre><code>var d &#61; promise.defer();
+flow.execute(function() {
+  var chain &#61; d.promise.then(() &#61;&gt; console.log(&#39;A&#39;));
+
+  chain.then(() &#61;&gt; console.log(&#39;B&#39;)).
+      then(() &#61;&gt; console.log(&#39;C&#39;));
+
+  chain.then(() &#61;&gt; console.log(&#39;D&#39;)).
+      then(() &#61;&gt; console.log(&#39;E&#39;));
+
+  flow.execute(() &#61;&gt; console.log(&#39;F&#39;));
+
+  d.fulfill();
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// A
+// B
+// C
+// D
+// E
+// F
+// fin
+</code></pre>
+<p>Even though a subtask&#39;s promised result will never resolve while the task
+function is on the stack, it will be treated as a promise resolved within the
+task. In all other scenarios, a task&#39;s promise behaves just like a normal
+promise. In the sample below, <code>C/D</code> is loggged before <code>B</code> because the
+resolution of <code>subtask1</code> interrupts the flow of the enclosing task. Within
+the final subtask, <code>E/F</code> is logged in order because <code>subtask1</code> is a resolved
+promise when that task runs.</p>
+<pre><code>flow.execute(function() {
+  var subtask1 &#61; flow.execute(() &#61;&gt; console.log(&#39;A&#39;));
+  var subtask2 &#61; flow.execute(() &#61;&gt; console.log(&#39;B&#39;));
+
+  subtask1.then(() &#61;&gt; console.log(&#39;C&#39;));
+  subtask1.then(() &#61;&gt; console.log(&#39;D&#39;));
+
+  flow.execute(function() {
+    flow.execute(() &#61;&gt; console.log(&#39;E&#39;));
+    subtask1.then(() &#61;&gt; console.log(&#39;F&#39;));
+  });
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// A
+// C
+// D
+// B
+// E
+// F
+// fin
+</code></pre>
+<p><strong>Note</strong>: while the ControlFlow will wait for
+<a href="class_webdriver_promise_ControlFlow.html#execute">tasks</a> and
+<a href="class_webdriver_promise_Promise.html#then">callbacks</a> to complete, it
+<em>will not</em> wait for unresolved promises created within a task:</p>
+<pre><code>flow.execute(function() {
+  var p &#61; new promise.Promise(function(fulfill) {
+    setTimeout(fulfill, 100);
+  });
+
+  p.then(() &#61;&gt; console.log(&#39;promise resolved!&#39;));
+
+}).then(function() {
+  console.log(&#39;task complete!&#39;);
+});
+// task complete!
+// promise resolved!
+</code></pre>
+<p>Finally, consider the following:</p>
+<pre><code>var d &#61; promise.defer();
+d.promise.then(() &#61;&gt; console.log(&#39;A&#39;));
+d.promise.then(() &#61;&gt; console.log(&#39;B&#39;));
+
+flow.execute(function() {
+  flow.execute(  () &#61;&gt; console.log(&#39;C&#39;));
+  d.promise.then(() &#61;&gt; console.log(&#39;D&#39;));
+
+  flow.execute(  () &#61;&gt; console.log(&#39;E&#39;));
+  d.promise.then(() &#61;&gt; console.log(&#39;F&#39;));
+
+  d.fulfill();
+
+  flow.execute(  () &#61;&gt; console.log(&#39;G&#39;));
+  d.promise.then(() &#61;&gt; console.log(&#39;H&#39;));
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// A
+// B
+// C
+// D
+// E
+// F
+// G
+// H
+// fin
+</code></pre>
+<p>In this example, callbacks are registered on <code>d.promise</code> both before and
+during the invocation of the task function. When <code>d.fulfill()</code> is called,
+the callbacks registered before the task (<code>A</code> &amp; <code>B</code>) are registered as
+interrupts. The remaining callbacks were all attached within the task and
+are scheduled in the flow as standard tasks.</p>
+<h2>Generator Support</h2>
+<p><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*">Generators</a> may be scheduled as tasks within a control flow or attached
+as callbacks to a promise. Each time the generator yields a promise, the
+control flow will wait for that promise to settle before executing the next
+iteration of the generator. The yielded promise&#39;s fulfilled value will be
+passed back into the generator:</p>
+<pre><code>flow.execute(function* () {
+  var d &#61; promise.defer();
+
+  setTimeout(() &#61;&gt; console.log(&#39;...waiting...&#39;), 25);
+  setTimeout(() &#61;&gt; d.fulfill(123), 50);
+
+  console.log(&#39;start: &#39; &#43; Date.now());
+
+  var value &#61; yield d.promise;
+  console.log(&#39;mid: %d; value &#61; %d&#39;, Date.now(), value);
+
+  yield promise.delayed(10);
+  console.log(&#39;end: &#39; &#43; Date.now());
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// start: 0
+// ...waiting...
+// mid: 50; value &#61; 123
+// end: 60
+// fin
+</code></pre>
+<p>Yielding the result of a promise chain will wait for the entire chain to
+complete:</p>
+<pre><code>promise.fulfilled().then(function* () {
+  console.log(&#39;start: &#39; &#43; Date.now());
+
+  var value &#61; yield flow.
+      execute(() &#61;&gt; console.log(&#39;A&#39;)).
+      then(   () &#61;&gt; console.log(&#39;B&#39;)).
+      then(   () &#61;&gt; 123);
+
+  console.log(&#39;mid: %s; value &#61; %d&#39;, Date.now(), value);
+
+  yield flow.execute(() &#61;&gt; console.log(&#39;C&#39;));
+}).then(function() {
+  console.log(&#39;fin&#39;);
+});
+// start: 0
+// A
+// B
+// mid: 2; value &#61; 123
+// C
+// fin
+</code></pre>
+<p>Yielding a <em>rejected</em> promise will cause the rejected value to be thrown
+within the generator function:</p>
+<pre><code>flow.execute(function* () {
+  console.log(&#39;start: &#39; &#43; Date.now());
+  try {
+    yield promise.delayed(10).then(function() {
+      throw Error(&#39;boom&#39;);
+    });
+  } catch (ex) {
+    console.log(&#39;caught time: &#39; &#43; Date.now());
+    console.log(ex.message);
+  }
+});
+// start: 0
+// caught time: 10
+// boom
+</code></pre>
+<h1>Error Handling</h1>
+<p>ES6 promises do not require users to handle a promise rejections. This can
+result in subtle bugs as the rejections are silently &#34;swallowed&#34; by the
+Promise class.</p>
+<pre><code>Promise.reject(Error(&#39;boom&#39;));
+// ... *crickets* ...
+</code></pre>
+<p>Selenium&#39;s <a href="namespace_webdriver_promise.html"><code>promise</code></a> module, on the other hand,
+requires that every rejection be explicitly handled. When a
+<a href="class_webdriver_promise_Promise.html">Promise</a> is rejected and no callbacks
+are defined on that promise, it is considered an <em>unhandled rejection</em> and
+reproted to the active task queue. If the rejection remains unhandled after
+a single turn of the <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop">event loop</a> (scheduled with a micro-task), it
+will propagate up the stack.</p>
+<h2>Error Propagation</h2>
+<p>If an unhandled rejection occurs within a task function, that task&#39;s promised
+result is rejected and all remaining subtasks are discarded:</p>
+<pre><code>flow.execute(function() {
+  // No callbacks registered on promise -&gt; unhandled rejection
+  promise.rejected(Error(&#39;boom&#39;));
+  flow.execute(function() { console.log(&#39;this will never run&#39;); });
+}).thenCatch(function(e) {
+  console.log(e.message);
+});
+// boom
+</code></pre>
+<p>The promised results for discarded tasks are silently rejected with a
+cancellation error and existing callback chains will never fire.</p>
+<pre><code>flow.execute(function() {
+  promise.rejected(Error(&#39;boom&#39;));
+  flow.execute(function() { console.log(&#39;a&#39;); }).
+      then(function() { console.log(&#39;b&#39;); });
+}).thenCatch(function(e) {
+  console.log(e.message);
+});
+// boom
+</code></pre>
+<p>An unhandled rejection takes precedence over a task function&#39;s returned
+result, even if that value is another promise:</p>
+<pre><code>flow.execute(function() {
+  promise.rejected(Error(&#39;boom&#39;));
+  return flow.execute(someOtherTask);
+}).thenCatch(function(e) {
+  console.log(e.message);
+});
+// boom
+</code></pre>
+<p>If there are multiple unhandled rejections within a task, they are packaged
+in a <a href="class_webdriver_promise_MultipleUnhandledRejectionError.html"><code>MultipleUnhandledRejectionError</code></a>, which has an <code>errors</code> property that is a
+<code>Set</code> of the recorded unhandled rejections:</p>
+<pre><code>flow.execute(function() {
+  promise.rejected(Error(&#39;boom1&#39;));
+  promise.rejected(Error(&#39;boom2&#39;));
+}).thenCatch(function(ex) {
+  console.log(ex instanceof promise.MultipleUnhandledRejectionError);
+  for (var e of ex.errors) {
+    console.log(e.message);
+  }
+});
+// boom1
+// boom2
+</code></pre>
+<p>When a subtask is discarded due to an unreported rejection in its parent
+frame, the existing callbacks on that task will never settle and the
+callbacks will not be invoked. If a new callback is attached ot the subtask
+<em>after</em> it has been discarded, it is handled the same as adding a callback
+to a cancelled promise: the error-callback path is invoked. This behavior is
+intended to handle cases where the user saves a reference to a task promise,
+as illustrated below.</p>
+<pre><code>var subTask;
+flow.execute(function() {
+  promise.rejected(Error(&#39;boom&#39;));
+  subTask &#61; flow.execute(function() {});
+}).thenCatch(function(e) {
+  console.log(e.message);
+}).then(function() {
+  return subTask.then(
+      () &#61;&gt; console.log(&#39;subtask success!&#39;),
+      (e) &#61;&gt; console.log(&#39;subtask failed:\n&#39; &#43; e));
+});
+// boom
+// subtask failed:
+// DiscardedTaskError: Task was discarded due to a previous failure: boom
+</code></pre>
+<p>When a subtask fails, its promised result is treated the same as any other
+promise: it must be handled within one turn of the rejection or the unhandled
+rejection is propagated to the parent task. This means users can catch errors
+from complex flows from the top level task:</p>
+<pre><code>flow.execute(function() {
+  flow.execute(function() {
+    flow.execute(function() {
+      throw Error(&#39;fail!&#39;);
+    });
+  });
+}).thenCatch(function(e) {
+  console.log(e.message);
+});
+// fail!
+</code></pre>
+<h2>Unhandled Rejection Events</h2>
+<p>When an unhandled rejection propagates to the root of the control flow, the
+flow will emit an <strong>uncaughtException</strong> event. If no listeners are registered
+on the flow, the error will be rethrown to the global error handler: an
+<strong>uncaughtException</strong> event from the
+<a href="https://nodejs.org/api/process.html"><code>process</code></a> object in node, or
+<code>window.onerror</code> when running in a browser.</p>
+<p>Bottom line: you <strong><em>must</em></strong> handle rejected promises.</p>
+<h1>Promise/A&#43; Compatibility</h1>
+<p>This <code>promise</code> module is compliant with the <a href="https://promisesaplus.com/">Promise/A&#43;</a> specification
+except for sections <code>2.2.6.1</code> and <code>2.2.6.2</code>:</p>
+<blockquote>
+<ul><li><code>then</code> may be called multiple times on the same promise.
+<ul><li>If/when <code>promise</code> is fulfilled, all respective <code>onFulfilled</code> callbacks
+must execute in the order of their originating calls to <code>then</code>.</li><li>If/when <code>promise</code> is rejected, all respective <code>onRejected</code> callbacks
+must execute in the order of their originating calls to <code>then</code>.</li></ul>
+</li></ul>
+</blockquote>
+<p>Specifically, the conformance tests contains the following scenario (for
+brevity, only the fulfillment version is shown):</p>
+<pre><code>var p1 &#61; Promise.resolve();
+p1.then(function() {
+  console.log(&#39;A&#39;);
+  p1.then(() &#61;&gt; console.log(&#39;B&#39;));
+});
+p1.then(() &#61;&gt; console.log(&#39;C&#39;));
+// A
+// C
+// B
+</code></pre>
+<p>Since the <a href="#scheduling_callbacks">ControlFlow</a> executes promise callbacks as
+tasks, with this module, the result would be</p>
+<pre><code>var p2 &#61; promise.fulfilled();
+p2.then(function() {
+  console.log(&#39;A&#39;);
+  p2.then(() &#61;&gt; console.log(&#39;B&#39;);
+});
+p2.then(() &#61;&gt; console.log(&#39;C&#39;));
+// A
+// B
+// C
+</code></pre>
+<h2>Functions</h2><div id="all" class="function"><div><h3><code>&lt;T&gt;</code> all(<wbr>arr)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1614">code »</a></span></h3><p>Given an array of promises, will return a promise that will be fulfilled
+with the fulfillment values of the input array&#39;s values. If any of the
+input array&#39;s promises are rejected, the returned promise will be rejected
+with the same reason.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;(T|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;)&gt;</code><dd><p>An array of
+promises to wait on.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;T&gt;&gt;</code><dd><p>A promise that is
+fulfilled with an array containing the fulfilled values of the
+input array, or rejected with the same reason as the first
+rejected value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="asap" class="function"><div><h3>asap(<wbr>value, callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1584">code »</a></span></h3><p>Invokes the appropriate callback function as soon as a promised
+<code>value</code> is resolved. This function is similar to
+<a href="namespace_webdriver_promise.html#when"><code>webdriver.promise.when</code></a>, except it does not return a new promise.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to observe.</p>
+<dt>callback<code>Function</code><dd><p>The function to call when the value is
+resolved successfully.</p>
+<dt>opt_errback<code>?Function=</code><dd><p>The function to call when the value is
+rejected.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="captureStackTrace" class="function"><div><h3>captureStackTrace(<wbr>name, msg, topFn)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l675">code »</a></span></h3><p>Generates an error to capture the current stack trace.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Error name for this stack trace.</p>
+<dt>msg<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>Message to record.</p>
+<dt>topFn<code>Function</code><dd><p>The function that should appear at the top of the
+stack; only applicable in V8.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The generated error.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="checkedNodeCall" class="function"><div><h3>checkedNodeCall(<wbr>fn, var_args)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1537">code »</a></span></h3><p>Wraps a function that expects a node-style callback as its final
+argument. This callback expects two arguments: an error value (which will be
+null if the call succeeded), and the success value as the second argument.
+The callback will the resolve or reject the returned promise, based on its arguments.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>Function</code><dd><p>The function to wrap.</p>
+<dt>var_args<code>...?</code><dd><p>The arguments to apply to the function, excluding the
+final callback.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that will be resolved with the
+result of the provided function&#39;s callback.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="consume" class="function"><div><h3>consume(<wbr>generatorFn, opt_self, var_args)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l3001">code »</a></span></h3><p>Consumes a <code>GeneratorFunction</code>. Each time the generator yields a
+promise, this function will wait for it to be fulfilled before feeding the
+fulfilled value back into <code>next</code>. Likewise, if a yielded promise is
+rejected, the rejection error will be passed to <code>throw</code>.</p>
+<p><strong>Example 1:</strong> the Fibonacci Sequence.</p>
+<pre><code>promise.consume(function* fibonacci() {
+  var n1 &#61; 1, n2 &#61; 1;
+  for (var i &#61; 0; i &lt; 4; &#43;&#43;i) {
+    var tmp &#61; yield n1 &#43; n2;
+    n1 &#61; n2;
+    n2 &#61; tmp;
+  }
+  return n1 &#43; n2;
+}).then(function(result) {
+  console.log(result);  // 13
+});
+</code></pre>
+<p><strong>Example 2:</strong> a generator that throws.</p>
+<pre><code>promise.consume(function* () {
+  yield promise.delayed(250).then(function() {
+    throw Error(&#39;boom&#39;);
+  });
+}).thenCatch(function(e) {
+  console.log(e.toString());  // Error: boom
+});
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>generatorFn<code>Function</code><dd><p>The generator function to execute.</p>
+<dt>opt_self<code>?<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a>=</code><dd><p>The object to use as &#34;this&#34; when invoking the
+initial generator.</p>
+<dt>var_args<code>...*</code><dd><p>Any arguments to pass to the initial generator.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;?&gt;</code><dd><p>A promise that will resolve to the
+generator&#39;s final result.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError">TypeError</a></code><dd><p>If the given function is not a generator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="controlFlow" class="function"><div><h3>controlFlow()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2930">code »</a></span></h3><div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The currently active control flow.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="createFlow" class="function"><div><h3>createFlow(<wbr>callback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2945">code »</a></span></h3><p>Creates a new control flow. The provided callback will be invoked as the
+first task within the new flow, with the flow as its sole argument. Returns
+a promise that resolves to the callback result.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>callback<code>function(<a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a>): ?</code><dd><p>The entry point
+to the newly created flow.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise that resolves to the callback
+result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="defer" class="function"><div><h3><code>&lt;T&gt;</code> defer()<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1488">code »</a></span></h3><p>Creates a new deferred object.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Deferred.html">webdriver.promise.Deferred</a>&lt;T&gt;</code><dd><p>The new deferred object.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="delayed" class="function"><div><h3>delayed(<wbr>ms)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1468">code »</a></span></h3><p>Creates a promise that will be resolved at a set time in the future.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>ms<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code><dd><p>The amount of time, in milliseconds, to wait before
+resolving the promise.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The promise.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="filter" class="function"><div><h3><code>&lt;TYPE, SELF&gt;</code> filter(<wbr>arr, fn, opt_self)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1718">code »</a></span></h3><p>Calls a function for each element in an array, and if the function returns
+true adds the element to a new array.</p>
+<p>If the return value of the filter function is a promise, this function
+will wait for it to be fulfilled before determining whether to insert the
+element into the new array.</p>
+<p>If the filter function throws or returns a rejected promise, the promise
+returned by this function will be rejected with the same reason. Only the
+first failure will be reported; all subsequent errors will be silently
+ignored.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arr<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;&gt;)</code><dd><p>The
+array to iterator over, or a promise that will resolve to said array.</p>
+<dt>fn<code>function(this: SELF, TYPE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;): ?(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;)</code><dd><p>The function
+to call for each element in the array.</p>
+<dt>opt_self<code>?SELF=</code><dd><p>The object to be used as the value of &#39;this&#39; within
+<code>fn</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="fulfilled" class="function"><div><h3><code>&lt;T&gt;</code> fulfilled(<wbr>opt_value)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1499">code »</a></span></h3><p>Creates a promise that has been resolved with the given value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_value<code>?T=</code><dd><p>The resolved value.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>The resolved promise.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="fullyResolved" class="function"><div><h3>fullyResolved(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1773">code »</a></span></h3><p>Returns a promise that will be resolved with the input value in a
+fully-resolved state. If the value is an array, each element will be fully
+resolved. Likewise, if the value is an object, all keys will be fully
+resolved. In both cases, all nested arrays and objects will also be
+fully resolved.  All fields are resolved in place; the returned promise will
+resolve on <code>value</code> and not a copy.</p>
+<p>Warning: This function makes no checks against objects that contain
+cyclical references:</p>
+<pre><code>var value &#61; {};
+value[&#39;self&#39;] &#61; value;
+promise.fullyResolved(value);  // Stack overflow.
+</code></pre>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to fully resolve.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A promise for a fully resolved version
+of the input value.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isGenerator" class="function"><div><h3>isGenerator(<wbr>fn)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2958">code »</a></span></h3><p>Tests is a function is a generator.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>fn<code>Function</code><dd><p>The function to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the function is a generator.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="isPromise" class="function"><div><h3>isPromise(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1452">code »</a></span></h3><p>Determines whether a <code>value</code> should be treated as a promise.
+Any object whose &#34;then&#34; property is a function will be considered a promise.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the value is a promise.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="map" class="function"><div><h3><code>&lt;TYPE, SELF&gt;</code> map(<wbr>arr, fn, opt_self)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1662">code »</a></span></h3><p>Calls a function for each element in an array and inserts the result into a
+new array, which is used as the fulfillment value of the promise returned
+by this function.</p>
+<p>If the return value of the mapping function is a promise, this function
+will wait for it to be fulfilled before inserting it into the new array.</p>
+<p>If the mapping function throws or returns a rejected promise, the
+promise returned by this function will be rejected with the same reason.
+Only the first failure will be reported; all subsequent errors will be
+silently ignored.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>arr<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;|<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;&gt;)</code><dd><p>The
+array to iterator over, or a promise that will resolve to said array.</p>
+<dt>fn<code>function(this: SELF, TYPE, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;TYPE&gt;): ?</code><dd><p>The
+function to call for each element in the array. This function should
+expect three arguments (the element, the index, and the array itself.</p>
+<dt>opt_self<code>?SELF=</code><dd><p>The object to be used as the value of &#39;this&#39; within
+<code>fn</code>.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="rejected" class="function"><div><h3><code>&lt;T&gt;</code> rejected(<wbr>opt_reason)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1516">code »</a></span></h3><p>Creates a promise that has been rejected with the given reason.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>opt_reason<code>*=</code><dd><p>The rejection reason; may be any value, but is
+usually an Error or a string.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a>&lt;T&gt;</code><dd><p>The rejected promise.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="setDefaultFlow" class="function"><div><h3>setDefaultFlow(<wbr>flow)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l2919">code »</a></span></h3><p>Changes the default flow to use when no others are active.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>flow<code><a href="class_webdriver_promise_ControlFlow.html">webdriver.promise.ControlFlow</a></code><dd><p>The new default flow.</p>
+</dl></div><div class="fn-details"><div><b>Throws</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>If the default flow is not currently active.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="when" class="function"><div><h3>when(<wbr>value, opt_callback, opt_errback)<span class="codelink"><a href="source/lib/webdriver/promise.js.src.html#l1563">code »</a></span></h3><p>Registers an observer on a promised <code>value</code>, returning a new promise
+that will be resolved when the value is. If <code>value</code> is not a promise,
+then the return promise will be immediately resolved.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to observe.</p>
+<dt>opt_callback<code>?Function=</code><dd><p>The function to call when the value is
+resolved successfully.</p>
+<dt>opt_errback<code>?Function=</code><dd><p>The function to call when the value is
+rejected.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>A new promise.</p>
+</dl></div></div></div></div><h2>Compiler Constants</h2><div id="LONG_STACK_TRACES" class="property"><dl><dt><a href="source/lib/webdriver/promise.js.src.html#l634">LONG_STACK_TRACES</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether to append traces of <code>then</code> to rejection
+errors.</p>
+</dl></div><h2>Types</h2><dl><dt><a href="class_webdriver_promise_CancellationError.html">CancellationError</a><dd><p>Error used when the computation of a promise is cancelled.</p>
+<dt><a href="class_webdriver_promise_ControlFlow.html">ControlFlow</a><dd><p>Handles the execution of scheduled tasks, each of which may be an
+asynchronous operation.</p>
+<dt><a href="class_webdriver_promise_Deferred.html">Deferred</a><dd><p>Represents a value that will be resolved at some point in the future.</p>
+<dt><a href="class_webdriver_promise_MultipleUnhandledRejectionError.html">MultipleUnhandledRejectionError</a><dd><p>Error used when there are multiple unhandled promise rejections detected
+within a task or callback.</p>
+<dt><a href="class_webdriver_promise_Promise.html">Promise</a><dd><p>Represents the eventual value of a completed operation.</p>
+<dt><a href="interface_webdriver_promise_Thenable.html">Thenable</a><dd><p>No description.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_stacktrace.html b/docs/namespace_webdriver_stacktrace.html
index 3eb1898..bd526fd 100644
--- a/docs/namespace_webdriver_stacktrace.html
+++ b/docs/namespace_webdriver_stacktrace.html
@@ -1,39 +1,17 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.stacktrace</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver.stacktrace</h1><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l22">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_stacktrace_Frame.html">webdriver.stacktrace.Frame</a><dd>Class representing one stack frame.<dt><a href="class_webdriver_stacktrace_Snapshot.html">webdriver.stacktrace.Snapshot</a><dd>Stores a snapshot of the stack trace at the time this instance was created.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l584">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.format">webdriver.stacktrace.format</a> <span class="args">( error )</span> &rArr; <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|goog.testing.JsUnitException)</code></span></div><p>Formats an error's stack trace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>error: <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|goog.testing.JsUnitException)</code><dd>The error to format.</dl><tr><th>Returns<tr><td><dl>The formatted error.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l642">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.get">webdriver.stacktrace.get</a> <span class="args">( )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Gets the native stack trace if available otherwise follows the call chain.
- The generated trace will exclude all frames up to and including the call to
- this function.</summary><div class="info"><table><tbody><tr><th>Returns<tr><td><dl>The frames of the stack trace.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l569">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.getStack_">webdriver.stacktrace.getStack_</a> <span class="args">( error )</span> &rArr; <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Get an error's stack trace with the error string trimmed.
- V8 prepends the string representation of an error to its stack trace.
- This function trims the string so that the stack trace can be parsed
- consistently with the other JS engines.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>error: <code class="type">!(<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Error">Error</a>|goog.testing.JsUnitException)</code><dd>The error.</dl><tr><th>Returns<tr><td><dl>The stack trace string.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l544">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.parseLongFirefoxFrame_">webdriver.stacktrace.parseLongFirefoxFrame_</a> <span class="args">( frameStr )</span> &rArr; <code class="type">!<a href="class_webdriver_stacktrace_Frame.html">webdriver.stacktrace.Frame</a></code></span></div><p>Parses a long firefox stack frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frameStr: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The stack frame as string.</dl><tr><th>Returns<tr><td><dl>Stack frame object.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l497">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.parseStackFrame_">webdriver.stacktrace.parseStackFrame_</a> <span class="args">( frameStr )</span> &rArr; <code class="type"><a href="class_webdriver_stacktrace_Frame.html">webdriver.stacktrace.Frame</a></code></span></div><p>Parses one stack frame.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>frameStr: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The stack frame as string.</dl><tr><th>Returns<tr><td><dl>Stack frame object or null if the
-     parsing failed.</dl></table></div></details></div></div><div class="wrap-details private"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l611">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.parse_">webdriver.stacktrace.parse_</a> <span class="args">( stack )</span> &rArr; <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array">Array</a></code></span></div><p>Parses an Error object's stack trace.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>stack: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The stack trace.</dl><tr><th>Returns<tr><td><dl>Stack frames. The
-     unrecognized frames will be nulled out.</dl></table></div></details></div></div></section><section id="static-properties"><h2>Global Properties</h2><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l463">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.ANONYMOUS_CLOSURE_FRAME_">webdriver.stacktrace.ANONYMOUS_CLOSURE_FRAME_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Representation of an anonymous frame in a stack trace generated by
- <code  class="type"><a class="unresolved-link">goog.testing.stacktrace</a></code>.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l174">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.ANONYMOUS_FRAME_">webdriver.stacktrace.ANONYMOUS_FRAME_</a> : <code class="type">!<a href="class_webdriver_stacktrace_Frame.html">webdriver.stacktrace.Frame</a></code></span></div><p>Constant for an anonymous frame.</summary></details></div></div><div class="wrap-details public"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l87">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.BROWSER_SUPPORTED">webdriver.stacktrace.BROWSER_SUPPORTED</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current browser supports stack traces.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l77">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_">webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code></span></div><p>Whether the current environment supports the Error.captureStackTrace
- function (as of 10/17/2012, only V8).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l434">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_">webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function call in a Chakra (IE) stack trace. This
- expression allows for identifiers like 'Anonymous function', 'eval code',
- and 'Global code'.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l443">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_">webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing on stack frame in Chakra (IE).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l472">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.CLOSURE_FUNCTION_CALL_PATTERN_">webdriver.stacktrace.CLOSURE_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Pattern for a function call in a Closure stack trace. Creates three optional
- submatches: the context, function name, and alias.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l484">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.CLOSURE_STACK_FRAME_REGEXP_">webdriver.stacktrace.CLOSURE_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing a stack frame generated by Closure's
- <code  class="type"><a class="unresolved-link">goog.testing.stacktrace</a></code>.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l266">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.CONTEXT_PATTERN_">webdriver.stacktrace.CONTEXT_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Pattern for a matching the type on a fully-qualified name. Forms an
- optional sub-match on the type. For example, in "foo.bar.baz", will match on
- "foo.bar".</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l378">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_">webdriver.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function call in the Firefox stack trace.
- Creates a submatch for the function name.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l368">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.FIREFOX_FUNCTION_NAME_PATTERN_">webdriver.stacktrace.FIREFOX_FUNCTION_NAME_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function names in the Firefox stack trace.
- Firefox has extended identifiers to deal with inner functions and anonymous
- functions: https://bugzilla.mozilla.org/show_bug.cgi?id=433529#c9</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l388">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_">webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing one stack frame in Firefox.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l256">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.IDENTIFIER_PATTERN_">webdriver.stacktrace.IDENTIFIER_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for JavaScript identifiers. We don't support Unicode
- identifiers defined in ECMAScript v3.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l247">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_">webdriver.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a></code></span></div><p>Maximum length of a string that can be matched with a RegExp on
- Firefox 3x. Exceeding this approximate length will cause string.match
- to exceed Firefox's stack quota. This situation can be encountered
- when goog.globalEval is invoked with a long argument; such as
- when loading a module.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l399">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_">webdriver.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for an anonymous function call in an Opera stack frame.
- Creates 2 (optional) submatches: the context object and function name.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l411">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.OPERA_FUNCTION_CALL_PATTERN_">webdriver.stacktrace.OPERA_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for a function call in an Opera stack frame.
- Creates 3 (optional) submatches: the function name (if not anonymous),
- the aliased context object and the function name (if anonymous).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l422">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.OPERA_STACK_FRAME_REGEXP_">webdriver.stacktrace.OPERA_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing on stack frame in Opera 11.68+</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l278">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.QUALIFIED_NAME_PATTERN_">webdriver.stacktrace.QUALIFIED_NAME_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Pattern for matching a fully qualified name. Will create two sub-matches:
- the type (optional), and the name. For example, in "foo.bar.baz", will
- match on ["foo.bar", "baz"].</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l454">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_">webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>Placeholder for an unparsable frame in a stack trace generated by
- <code  class="type"><a class="unresolved-link">goog.testing.stacktrace</a></code>.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l335">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.URL_PATTERN_">webdriver.stacktrace.URL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for an URL + position inside the file.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l288">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.V8_ALIAS_PATTERN_">webdriver.stacktrace.V8_ALIAS_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function name alias in the V8 stack trace.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l310">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.V8_CONTEXT_PATTERN_">webdriver.stacktrace.V8_CONTEXT_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for the context of a function call in V8. Creates two
- submatches, only one of which will ever match: either the namespace
- identifier (with optional "new" keyword in the case of a constructor call),
- or just the "new " phrase for a top level constructor call.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l324">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_">webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function call in the V8 stack trace.
- Creates 3 submatches with context object (optional), function name and
- function alias (optional).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l298">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.V8_FUNCTION_NAME_PATTERN_">webdriver.stacktrace.V8_FUNCTION_NAME_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for function names and constructor calls in the V8 stack
- trace.</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l348">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.V8_LOCATION_PATTERN_">webdriver.stacktrace.V8_LOCATION_PATTERN_</a> : <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code></span></div><p>RegExp pattern for a location string in a V8 stack frame. Creates two
- submatches for the location, one for enclosed in parentheticals and on
- where the location appears alone (which will only occur if the location is
- the only information in the frame).</summary></details></div></div><div class="wrap-details private"><div><details><summary><div><a class="source" href="source/lib/webdriver/stacktrace.js.src.html#l356">code &raquo;</a><span class="member"><a name="webdriver.stacktrace.V8_STACK_FRAME_REGEXP_">webdriver.stacktrace.V8_STACK_FRAME_REGEXP_</a> : <code class="type">!<a href="http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/RegExp">RegExp</a></code></span></div><p>Regular expression for parsing one stack frame in V8.</summary></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.stacktrace</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><div class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l23">View Source</a></div><h1>namespace webdriver.stacktrace</h1><h2>Functions</h2><div id="format" class="function"><div><h3>format(<wbr>error)<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l552">code »</a></span></h3><p>Formats an error&#39;s stack trace.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>error<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The error to format.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The formatted error.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="get" class="function"><div><h3>get()<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l617">code »</a></span></h3><p>Gets the native stack trace if available otherwise follows the call chain.
+The generated trace will exclude all frames up to and including the call to
+this function.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_stacktrace_Frame.html">webdriver.stacktrace.Frame</a>&gt;</code><dd><p>The frames of the stack trace.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="getStack" class="function"><div><h3>getStack(<wbr>error)<span class="codelink"><a href="source/lib/webdriver/stacktrace.js.src.html#l534">code »</a></span></h3><p>Get an error&#39;s stack trace with the error string trimmed.
+V8 prepends the string representation of an error to its stack trace.
+This function trims the string so that the stack trace can be parsed
+consistently with the other JS engines.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>error<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error">Error</a></code><dd><p>The error.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The stack trace string.</p>
+</dl></div></div></div></div><h2>Properties</h2><div id="BROWSER_SUPPORTED" class="property"><dl><dt><a href="source/lib/webdriver/stacktrace.js.src.html#l87">BROWSER_SUPPORTED</a><code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a></code><dd><p>Whether the current browser supports stack traces.</p>
+</dl></div><h2>Types</h2><dl><dt><a href="class_webdriver_stacktrace_Frame.html">Frame</a><dd><p>Class representing one stack frame.</p>
+<dt><a href="class_webdriver_stacktrace_Snapshot.html">Snapshot</a><dd><p>Stores a snapshot of the stack trace at the time this instance was created.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_testing.html b/docs/namespace_webdriver_testing.html
index e077f7b..07bbe37 100644
--- a/docs/namespace_webdriver_testing.html
+++ b/docs/namespace_webdriver_testing.html
@@ -1 +1,7 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.testing</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver.testing</h1><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l20">code &raquo;</a></header><section></section><section><h2>Classes</h2><div class="type-summary"><table><tbody><tr><td><dl><dt><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a><dd>Utility for performing assertions against a given <code >value</code>.<dt><a href="class_webdriver_testing_ContainsMatcher.html">webdriver.testing.ContainsMatcher</a><dd>Accepts strins or array-like structures that contain <code >value</code>.<dt><a href="class_webdriver_testing_NegatedAssertion.html">webdriver.testing.NegatedAssertion</a><dd>An assertion that negates any applied matchers.</dl></table></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l397">code &raquo;</a><span class="member"><a name="webdriver.testing.assert">webdriver.testing.assert</a> <span class="args">( value )</span> &rArr; <code class="type">!<a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code></span></div><p>Creates a new assertion.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to perform an assertion on.</dl><tr><th>Returns<tr><td><dl>The new assertion.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.testing</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><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l23">View Source</a></div><h1>namespace webdriver.testing</h1><h2>Functions</h2><div id="assert" class="function"><div><h3>assert(<wbr>value)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l399">code »</a></span></h3><p>Creates a new assertion.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to perform an assertion on.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code><dd><p>The new assertion.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_testing_Assertion.html">Assertion</a><dd><p>Utility for performing assertions against a given <code>value</code>.</p>
+<dt><a href="class_webdriver_testing_ContainsMatcher.html">ContainsMatcher</a><dd><p>Accepts strins or array-like structures that contain <code>value</code>.</p>
+<dt><a href="class_webdriver_testing_NegatedAssertion.html">NegatedAssertion</a><dd><p>An assertion that negates any applied matchers.</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_testing_assert.html b/docs/namespace_webdriver_testing_assert.html
index 91e04b6..cc00e42 100644
--- a/docs/namespace_webdriver_testing_assert.html
+++ b/docs/namespace_webdriver_testing_assert.html
@@ -1,3 +1,9 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.testing.assert</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver.testing.assert</h1><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l397">code &raquo;</a></header><section><p>Creates a new assertion.<h2>Main</h2><div class="ctor wrap-details public"><div><div class="ctor"><span class="member">assert <span class="args">( value )</span> &rArr; <code class="type">!<a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code></span></div><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>value: <code class="type">*</code><dd>The value to perform an assertion on.</dl><tr><th>Returns<tr><td><dl>The new assertion.</dl></table></div></div></div></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l411">code &raquo;</a><span class="member"><a name="webdriver.testing.assert.register">webdriver.testing.assert.register</a> <span class="args">( name, matcherTemplate )</span></span></div><p>Registers a new assertion to expose from the
- <code  class="type"><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code> prototype.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>name: <code class="type"><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd>The assertion name.<dt>matcherTemplate: <code class="type">(function(new: <a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a>, *)|{matches: function(*): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, describe: function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd>Either the
-     matcher constructor to use, or an object literal defining a matcher.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.testing.assert</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><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l399">View Source</a></div><h1>namespace webdriver.testing.assert</h1><p>Creates a new assertion.</p>
+<h2>webdriver.testing.assert(<wbr>value)</h2><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>value<code>*</code><dd><p>The value to perform an assertion on.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_testing_Assertion.html">webdriver.testing.Assertion</a></code><dd><p>The new assertion.</p>
+</dl></div></div><h2>Functions</h2><div id="register" class="function"><div><h3>register(<wbr>name, matcherTemplate)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l413">code »</a></span></h3><p>Registers a new assertion to expose from the
+<a href="class_webdriver_testing_Assertion.html"><code>webdriver.testing.Assertion</code></a> prototype.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>name<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The assertion name.</p>
+<dt>matcherTemplate<code>(function(new: goog.labs.testing.Matcher, *): ?|{describe: function(): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>, matches: function(*): <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>})</code><dd><p>Either the
+matcher constructor to use, or an object literal defining a matcher.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_testing_asserts.html b/docs/namespace_webdriver_testing_asserts.html
index 1050173..7b59d1b 100644
--- a/docs/namespace_webdriver_testing_asserts.html
+++ b/docs/namespace_webdriver_testing_asserts.html
@@ -1,10 +1,18 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.testing.asserts</title><link href="dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>Namespace webdriver.testing.asserts</h1><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l24">code &raquo;</a></header><section></section><div id="visibility-controls"><b>Show:</b><label for="show-public"><span><input type="checkbox" id="show-public" checked/></span>Public</label><label for="show-protected"><span><input type="checkbox" id="show-protected"/></span>Protected</label><label for="show-private"><span><input type="checkbox" id="show-private"/></span>Private</label></div><section id="static-functions"><h2>Global Functions</h2><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l444">code &raquo;</a><span class="member deprecation-notice"><a name="webdriver.testing.asserts.assertThat">webdriver.testing.asserts.assertThat</a> <span class="args">( failureMessageOrActualValue, actualValueOrMatcher, opt_matcher )</span> &rArr; <code class="type">!<a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code></span></div><div class="deprecation-notice">Deprecated: <span class="deprecation-reason">Use webdriver.testing.asserts.assert instead.</span></div><p>Asserts that a matcher accepts a given value.  This function has two
- signatures based on the number of arguments:
-
- Two arguments:
-   assertThat(actualValue, matcher)
- Three arguments:
-   assertThat(failureMessage, actualValue, matcher)</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>failureMessageOrActualValue: <code class="type">*</code><dd>Either a failure message or the value
-     to apply to the given matcher.<dt>actualValueOrMatcher: <code class="type">*</code><dd>Either the value to apply to the given
-     matcher, or the matcher itself.<dt>opt_matcher: <code class="type"><a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a>=</code><dd>The matcher to use;
-     ignored unless this function is invoked with three arguments.</dl><tr><th>Returns<tr><td><dl>The assertion result.</dl></table></div></details></div></div><div class="wrap-details public"><div><details class="function"><summary><div><a class="source" href="source/lib/webdriver/testing/asserts.js.src.html#l465">code &raquo;</a><span class="member"><a name="webdriver.testing.asserts.equalTo">webdriver.testing.asserts.equalTo</a> <span class="args">( expected )</span> &rArr; <code class="type">!<a href="interface_goog_labs_testing_Matcher.html">goog.labs.testing.Matcher</a></code></span></div><p>Creates an equality matcher.</summary><div class="info"><table><tbody><tr><th>Parameters<tr><td><dl><dt>expected: <code class="type">*</code><dd>The expected value.</dl><tr><th>Returns<tr><td><dl>The new matcher.</dl></table></div></details></div></div></section></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="types.js"></script><script src="dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.testing.asserts</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><div class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l27">View Source</a></div><h1>namespace webdriver.testing.asserts</h1><h2>Functions</h2><div id="assertThat" class="function"><div><h3>assertThat(<wbr>failureMessageOrActualValue, actualValueOrMatcher, opt_matcher)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l446">code »</a></span></h3><div class="tags"><span>deprecated</span></div><p>Asserts that a matcher accepts a given value.  This function has two
+signatures based on the number of arguments:</p>
+<p>Two arguments:
+assertThat(actualValue, matcher)
+Three arguments:
+assertThat(failureMessage, actualValue, matcher)</p>
+<dl><dt>Deprecated<dd><p>Use webdriver.testing.asserts.assert instead.</p>
+</dl><div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>failureMessageOrActualValue<code>*</code><dd><p>Either a failure message or the value
+to apply to the given matcher.</p>
+<dt>actualValueOrMatcher<code>*</code><dd><p>Either the value to apply to the given
+matcher, or the matcher itself.</p>
+<dt>opt_matcher<code>?goog.labs.testing.Matcher=</code><dd><p>The matcher to use;
+ignored unless this function is invoked with three arguments.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_promise_Promise.html">webdriver.promise.Promise</a></code><dd><p>The assertion result.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="equalTo" class="function"><div><h3>equalTo(<wbr>expected)<span class="codelink"><a href="source/lib/webdriver/testing/asserts.js.src.html#l467">code »</a></span></h3><p>Creates an equality matcher.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>expected<code>*</code><dd><p>The expected value.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code>goog.labs.testing.Matcher</code><dd><p>The new matcher.</p>
+</dl></div></div></div></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>
\ No newline at end of file
diff --git a/docs/namespace_webdriver_until.html b/docs/namespace_webdriver_until.html
new file mode 100644
index 0000000..fdc7557
--- /dev/null
+++ b/docs/namespace_webdriver_until.html
@@ -0,0 +1,82 @@
+<!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>webdriver.until</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><div class="codelink"><a href="source/lib/webdriver/until.js.src.html#l42">View Source</a></div><h1>namespace webdriver.until</h1><h2>Functions</h2><div id="ableToSwitchToFrame" class="function"><div><h3>ableToSwitchToFrame(<wbr>frame)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l103">code »</a></span></h3><p>Creates a condition that will wait until the input driver is able to switch
+to the designated frame. The target frame may be specified as</p>
+<ol><li>a numeric index into
+<a href="https://developer.mozilla.org/en-US/docs/Web/API/Window.frames">window.frames</a>
+for the currently selected frame.</li><li>a <a href="class_webdriver_WebElement.html"><code>webdriver.WebElement</code></a>, which must reference a FRAME or IFRAME
+element on the current page.</li><li>a locator which may be used to first locate a FRAME or IFRAME on the
+current page before attempting to switch to it.</li></ol>
+<p>Upon successful resolution of this condition, the driver will be left
+focused on the new frame.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>frame<code>(<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">number</a>|<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>|<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The frame identifier.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>A new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="alertIsPresent" class="function"><div><h3>alertIsPresent()<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l139">code »</a></span></h3><p>Creates a condition that waits for an alert to be opened. Upon success, the
+returned promise will be fulfilled with the handle for the opened alert.</p>
+<div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="class_webdriver_Alert.html">webdriver.Alert</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsDisabled" class="function"><div><h3>elementIsDisabled(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l319">code »</a></span></h3><p>Creates a condition that will wait for the given element to be disabled.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsEnabled" class="function"><div><h3>elementIsEnabled(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l305">code »</a></span></h3><p>Creates a condition that will wait for the given element to be enabled.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsNotSelected" class="function"><div><h3>elementIsNotSelected(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l348">code »</a></span></h3><p>Creates a condition that will wait for the given element to be deselected.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsNotVisible" class="function"><div><h3>elementIsNotVisible(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l289">code »</a></span></h3><p>Creates a condition that will wait for the given element to be in the DOM,
+yet not visible to the user.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsSelected" class="function"><div><h3>elementIsSelected(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l334">code »</a></span></h3><p>Creates a condition that will wait for the given element to be selected.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementIsVisible" class="function"><div><h3>elementIsVisible(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l274">code »</a></span></h3><p>Creates a condition that will wait for the given element to become visible.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementLocated" class="function"><div><h3>elementLocated(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l211">code »</a></span></h3><p>Creates a condition that will loop until an element is
+<a href="class_webdriver_WebDriver.html#findElement"><code>found</code></a> with the given locator.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementTextContains" class="function"><div><h3>elementTextContains(<wbr>element, substr)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l386">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
+<a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to contain the given
+substring.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+<dt>substr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring to search for.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementTextIs" class="function"><div><h3>elementTextIs(<wbr>element, text)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l367">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
+<a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to match the given
+<code>text</code> exactly.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+<dt>text<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected text.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementTextMatches" class="function"><div><h3>elementTextMatches(<wbr>element, regex)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l405">code »</a></span></h3><p>Creates a condition that will wait for the given element&#39;s
+<a href="class_webdriver_WebDriver.html"><code>visible text</code></a> to match a regular
+expression.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element to test.</p>
+<dt>regex<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp">RegExp</a></code><dd><p>The regular expression to test against.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="elementsLocated" class="function"><div><h3>elementsLocated(<wbr>locator)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l232">code »</a></span></h3><p>Creates a condition that will loop until at least one element is
+<a href="class_webdriver_WebDriver.html#findElement"><code>found</code></a> with the given locator.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>locator<code>(<a href="class_webdriver_Locator.html">webdriver.Locator</a>|{className: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{css: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{id: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{js: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{linkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{name: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{partialLinkText: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{tagName: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>}|{xpath: <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a>})</code><dd><p>The locator
+to use.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a>&lt;<a href="class_webdriver_WebElement.html">webdriver.WebElement</a>&gt;&gt;</code><dd><p>The new
+condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="stalenessOf" class="function"><div><h3>stalenessOf(<wbr>element)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l253">code »</a></span></h3><p>Creates a condition that will wait for the given element to become stale. An
+element is considered stale once it is removed from the DOM, or a new page
+has loaded.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>element<code><a href="class_webdriver_WebElement.html">webdriver.WebElement</a></code><dd><p>The element that should become stale.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="titleContains" class="function"><div><h3>titleContains(<wbr>substr)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l176">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to contain
+the given substring.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>substr<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The substring that should be present in the page
+title.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="titleIs" class="function"><div><h3>titleIs(<wbr>title)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l157">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to match the
+given value.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>title<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String">string</a></code><dd><p>The expected page title.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><hr class="fn-sep"><div id="titleMatches" class="function"><div><h3>titleMatches(<wbr>regex)<span class="codelink"><a href="source/lib/webdriver/until.js.src.html#l194">code »</a></span></h3><p>Creates a condition that will wait for the current page&#39;s title to match the
+given regular expression.</p>
+<div><div class="fn-details"><div><b>Parameters</b></div><dl><dt>regex<code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp">RegExp</a></code><dd><p>The regular expression to test against.</p>
+</dl></div><div class="fn-details"><div><b>Returns</b></div><dl><dt><code><a href="class_webdriver_until_Condition.html">webdriver.until.Condition</a>&lt;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean">boolean</a>&gt;</code><dd><p>The new condition.</p>
+</dl></div></div></div></div><h2>Types</h2><dl><dt><a href="class_webdriver_until_Condition.html">Condition</a><dd><p>Defines a condition to</p>
+</dl></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>
\ No newline at end of file
diff --git a/docs/source/_base.js.src.html b/docs/source/_base.js.src.html
index a8ca370..7fa1c82 100644
--- a/docs/source/_base.js.src.html
+++ b/docs/source/_base.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>_base.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>_base.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2012 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview The base module responsible for bootstrapping the Closure<tr><td><a name="l18" href="#l18">18</a><td> * library and providing a means of loading Closure-based modules.<tr><td><a name="l19" href="#l19">19</a><td> *<tr><td><a name="l20" href="#l20">20</a><td> * &lt;p&gt;Each script loaded by this module will be granted access to this module&#39;s<tr><td><a name="l21" href="#l21">21</a><td> * {@code require} function; all required non-native modules must be specified<tr><td><a name="l22" href="#l22">22</a><td> * relative to &lt;em&gt;this&lt;/em&gt; module.<tr><td><a name="l23" href="#l23">23</a><td> *<tr><td><a name="l24" href="#l24">24</a><td> * &lt;p&gt;This module will load all scripts from the &quot;lib&quot; subdirectory, unless the<tr><td><a name="l25" href="#l25">25</a><td> * SELENIUM_DEV_MODE environment variable has been set to 1, in which case all<tr><td><a name="l26" href="#l26">26</a><td> * scripts will be loaded from the Selenium client containing this script.<tr><td><a name="l27" href="#l27">27</a><td> */<tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td>&#39;use strict&#39;;<tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>var fs = require(&#39;fs&#39;),<tr><td><a name="l32" href="#l32">32</a><td>    path = require(&#39;path&#39;),<tr><td><a name="l33" href="#l33">33</a><td>    vm = require(&#39;vm&#39;);<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td>/**<tr><td><a name="l37" href="#l37">37</a><td> * If this script was loaded from the Selenium project repo, it will operate in<tr><td><a name="l38" href="#l38">38</a><td> * development mode, adjusting how it loads Closure-based dependencies.<tr><td><a name="l39" href="#l39">39</a><td> * @type {boolean}<tr><td><a name="l40" href="#l40">40</a><td> */<tr><td><a name="l41" href="#l41">41</a><td>var devMode = (function() {<tr><td><a name="l42" href="#l42">42</a><td>  var buildDescFile = path.join(__dirname, &#39;..&#39;, &#39;build.desc&#39;);<tr><td><a name="l43" href="#l43">43</a><td>  return fs.existsSync(buildDescFile);<tr><td><a name="l44" href="#l44">44</a><td>})();<tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>/** @return {boolean} Whether this script was loaded in dev mode. */<tr><td><a name="l48" href="#l48">48</a><td>function isDevMode() {<tr><td><a name="l49" href="#l49">49</a><td>  return devMode;<tr><td><a name="l50" href="#l50">50</a><td>}<tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>/**<tr><td><a name="l54" href="#l54">54</a><td> * @type {string} Path to Closure&#39;s base file, relative to this module.<tr><td><a name="l55" href="#l55">55</a><td> * @const<tr><td><a name="l56" href="#l56">56</a><td> */<tr><td><a name="l57" href="#l57">57</a><td>var CLOSURE_BASE_FILE_PATH = (function() {<tr><td><a name="l58" href="#l58">58</a><td>  var relativePath = isDevMode() ?<tr><td><a name="l59" href="#l59">59</a><td>      &#39;../../../third_party/closure/goog/base.js&#39; :<tr><td><a name="l60" href="#l60">60</a><td>      &#39;./lib/goog/base.js&#39;;<tr><td><a name="l61" href="#l61">61</a><td>  return path.join(__dirname, relativePath);<tr><td><a name="l62" href="#l62">62</a><td>})();<tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td><tr><td><a name="l65" href="#l65">65</a><td>/**<tr><td><a name="l66" href="#l66">66</a><td> * @type {string} Path to Closure&#39;s base file, relative to this module.<tr><td><a name="l67" href="#l67">67</a><td> * @const<tr><td><a name="l68" href="#l68">68</a><td> */<tr><td><a name="l69" href="#l69">69</a><td>var DEPS_FILE_PATH = (function() {<tr><td><a name="l70" href="#l70">70</a><td>  var relativePath = isDevMode() ?<tr><td><a name="l71" href="#l71">71</a><td>      &#39;../../../javascript/deps.js&#39; :<tr><td><a name="l72" href="#l72">72</a><td>      &#39;./lib/goog/deps.js&#39;;<tr><td><a name="l73" href="#l73">73</a><td>  return path.join(__dirname, relativePath);<tr><td><a name="l74" href="#l74">74</a><td>})();<tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td><tr><td><a name="l78" href="#l78">78</a><td>/**<tr><td><a name="l79" href="#l79">79</a><td> * Synchronously loads a script into the protected Closure context.<tr><td><a name="l80" href="#l80">80</a><td> * @param {string} src Path to the file to load.<tr><td><a name="l81" href="#l81">81</a><td> */<tr><td><a name="l82" href="#l82">82</a><td>function loadScript(src) {<tr><td><a name="l83" href="#l83">83</a><td>  src = path.normalize(src);<tr><td><a name="l84" href="#l84">84</a><td>  var contents = fs.readFileSync(src, &#39;utf8&#39;);<tr><td><a name="l85" href="#l85">85</a><td>  vm.runInContext(contents, closure, src);<tr><td><a name="l86" href="#l86">86</a><td>}<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>/**<tr><td><a name="l90" href="#l90">90</a><td> * The protected context to host the Closure library.<tr><td><a name="l91" href="#l91">91</a><td> * @type {!Object}<tr><td><a name="l92" href="#l92">92</a><td> * @const<tr><td><a name="l93" href="#l93">93</a><td> */<tr><td><a name="l94" href="#l94">94</a><td>var closure = vm.createContext({<tr><td><a name="l95" href="#l95">95</a><td>  console: console,<tr><td><a name="l96" href="#l96">96</a><td>  setTimeout: setTimeout,<tr><td><a name="l97" href="#l97">97</a><td>  setInterval: setInterval,<tr><td><a name="l98" href="#l98">98</a><td>  clearTimeout: clearTimeout,<tr><td><a name="l99" href="#l99">99</a><td>  clearInterval: clearInterval,<tr><td><a name="l100" href="#l100">100</a><td>  process: process,<tr><td><a name="l101" href="#l101">101</a><td>  require: require,<tr><td><a name="l102" href="#l102">102</a><td>  Buffer: Buffer,<tr><td><a name="l103" href="#l103">103</a><td>  Error: Error,<tr><td><a name="l104" href="#l104">104</a><td>  CLOSURE_BASE_PATH: path.dirname(CLOSURE_BASE_FILE_PATH) + &#39;/&#39;,<tr><td><a name="l105" href="#l105">105</a><td>  CLOSURE_IMPORT_SCRIPT: function(src) {<tr><td><a name="l106" href="#l106">106</a><td>    loadScript(src);<tr><td><a name="l107" href="#l107">107</a><td>    return true;<tr><td><a name="l108" href="#l108">108</a><td>  },<tr><td><a name="l109" href="#l109">109</a><td>  CLOSURE_NO_DEPS: !isDevMode(),<tr><td><a name="l110" href="#l110">110</a><td>  goog: {}<tr><td><a name="l111" href="#l111">111</a><td>});<tr><td><a name="l112" href="#l112">112</a><td>closure.window = closure;<tr><td><a name="l113" href="#l113">113</a><td><tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>loadScript(CLOSURE_BASE_FILE_PATH);<tr><td><a name="l116" href="#l116">116</a><td>loadScript(DEPS_FILE_PATH);<tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td><tr><td><a name="l119" href="#l119">119</a><td>/**<tr><td><a name="l120" href="#l120">120</a><td> * Loads a symbol by name from the protected Closure context.<tr><td><a name="l121" href="#l121">121</a><td> * @param {string} symbol The symbol to load.<tr><td><a name="l122" href="#l122">122</a><td> * @return {?} The loaded symbol, or {@code null} if not found.<tr><td><a name="l123" href="#l123">123</a><td> * @throws {Error} If the symbol has not been defined.<tr><td><a name="l124" href="#l124">124</a><td> */<tr><td><a name="l125" href="#l125">125</a><td>function closureRequire(symbol) {<tr><td><a name="l126" href="#l126">126</a><td>  closure.goog.require(symbol);<tr><td><a name="l127" href="#l127">127</a><td>  return closure.goog.getObjectByName(symbol);<tr><td><a name="l128" href="#l128">128</a><td>}<tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td>// PUBLIC API<tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td>/**<tr><td><a name="l135" href="#l135">135</a><td> * Loads a symbol by name from the protected Closure context and exports its<tr><td><a name="l136" href="#l136">136</a><td> * public API to the provided object. This function relies on Closure code<tr><td><a name="l137" href="#l137">137</a><td> * conventions to define the public API of an object as those properties whose<tr><td><a name="l138" href="#l138">138</a><td> * name does not end with &quot;_&quot;.<tr><td><a name="l139" href="#l139">139</a><td> * @param {string} symbol The symbol to load. This must resolve to an object.<tr><td><a name="l140" href="#l140">140</a><td> * @return {!Object} An object with the exported API.<tr><td><a name="l141" href="#l141">141</a><td> * @throws {Error} If the symbol has not been defined or does not resolve to<tr><td><a name="l142" href="#l142">142</a><td> *     an object.<tr><td><a name="l143" href="#l143">143</a><td> */<tr><td><a name="l144" href="#l144">144</a><td>exports.exportPublicApi = function(symbol) {<tr><td><a name="l145" href="#l145">145</a><td>  var src = closureRequire(symbol);<tr><td><a name="l146" href="#l146">146</a><td>  if (typeof src != &#39;object&#39; || src === null) {<tr><td><a name="l147" href="#l147">147</a><td>    throw Error(&#39;&quot;&#39; + symbol + &#39;&quot; must resolve to an object&#39;);<tr><td><a name="l148" href="#l148">148</a><td>  }<tr><td><a name="l149" href="#l149">149</a><td><tr><td><a name="l150" href="#l150">150</a><td>  var dest = {};<tr><td><a name="l151" href="#l151">151</a><td>  Object.keys(src).forEach(function(key) {<tr><td><a name="l152" href="#l152">152</a><td>    if (key[key.length - 1] != &#39;_&#39;) {<tr><td><a name="l153" href="#l153">153</a><td>      dest[key] = src[key];<tr><td><a name="l154" href="#l154">154</a><td>    }<tr><td><a name="l155" href="#l155">155</a><td>  });<tr><td><a name="l156" href="#l156">156</a><td><tr><td><a name="l157" href="#l157">157</a><td>  return dest;<tr><td><a name="l158" href="#l158">158</a><td>};<tr><td><a name="l159" href="#l159">159</a><td><tr><td><a name="l160" href="#l160">160</a><td><tr><td><a name="l161" href="#l161">161</a><td>if (isDevMode()) {<tr><td><a name="l162" href="#l162">162</a><td>  exports.closure = closure;<tr><td><a name="l163" href="#l163">163</a><td>}<tr><td><a name="l164" href="#l164">164</a><td>exports.isDevMode = isDevMode;<tr><td><a name="l165" href="#l165">165</a><td>exports.require = closureRequire;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
+<!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>_base.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>_base.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview The base module responsible for bootstrapping the Closure<tr><td><a id="l20"></a><a href="#l20">20</a><td> * library and providing a means of loading Closure-based modules.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * &lt;p&gt;Each script loaded by this module will be granted access to this module&#39;s<tr><td><a id="l23"></a><a href="#l23">23</a><td> * {@code require} function; all required non-native modules must be specified<tr><td><a id="l24"></a><a href="#l24">24</a><td> * relative to &lt;em&gt;this&lt;/em&gt; module.<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * &lt;p&gt;This module will load all scripts from the &quot;lib&quot; subdirectory, unless the<tr><td><a id="l27"></a><a href="#l27">27</a><td> * SELENIUM_DEV_MODE environment variable has been set to 1, in which case all<tr><td><a id="l28"></a><a href="#l28">28</a><td> * scripts will be loaded from the Selenium client containing this script.<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>&#39;use strict&#39;;<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l34"></a><a href="#l34">34</a><td>    path = require(&#39;path&#39;),<tr><td><a id="l35"></a><a href="#l35">35</a><td>    vm = require(&#39;vm&#39;);<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> * If this script was loaded from the Selenium project repo, it will operate in<tr><td><a id="l40"></a><a href="#l40">40</a><td> * development mode, adjusting how it loads Closure-based dependencies.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @type {boolean}<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td>var devMode = (function() {<tr><td><a id="l44"></a><a href="#l44">44</a><td>  var buildDescFile = path.join(__dirname, &#39;..&#39;, &#39;build.desc&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>  return fs.existsSync(buildDescFile);<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>/** @return {boolean} Whether this script was loaded in dev mode. */<tr><td><a id="l50"></a><a href="#l50">50</a><td>function isDevMode() {<tr><td><a id="l51"></a><a href="#l51">51</a><td>  return devMode;<tr><td><a id="l52"></a><a href="#l52">52</a><td>}<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>/**<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @type {string} Path to Closure&#39;s base file, relative to this module.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @const<tr><td><a id="l58"></a><a href="#l58">58</a><td> */<tr><td><a id="l59"></a><a href="#l59">59</a><td>var CLOSURE_BASE_FILE_PATH = (function() {<tr><td><a id="l60"></a><a href="#l60">60</a><td>  var relativePath = isDevMode() ?<tr><td><a id="l61"></a><a href="#l61">61</a><td>      &#39;../../../third_party/closure/goog/base.js&#39; :<tr><td><a id="l62"></a><a href="#l62">62</a><td>      &#39;./lib/goog/base.js&#39;;<tr><td><a id="l63"></a><a href="#l63">63</a><td>  return path.join(__dirname, relativePath);<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> * @type {string} Path to Closure&#39;s base file, relative to this module.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @const<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>var DEPS_FILE_PATH = (function() {<tr><td><a id="l72"></a><a href="#l72">72</a><td>  var relativePath = isDevMode() ?<tr><td><a id="l73"></a><a href="#l73">73</a><td>      &#39;../../../javascript/deps.js&#39; :<tr><td><a id="l74"></a><a href="#l74">74</a><td>      &#39;./lib/goog/deps.js&#39;;<tr><td><a id="l75"></a><a href="#l75">75</a><td>  return path.join(__dirname, relativePath);<tr><td><a id="l76"></a><a href="#l76">76</a><td>})();<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td>/**<tr><td><a id="l80"></a><a href="#l80">80</a><td> * Maintains a unique context for Closure library-based code.<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @param {boolean=} opt_configureForTesting Whether to configure a fake DOM<tr><td><a id="l82"></a><a href="#l82">82</a><td> *     for Closure-testing code that (incorrectly) assumes a DOM is always<tr><td><a id="l83"></a><a href="#l83">83</a><td> *     present.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @constructor<tr><td><a id="l85"></a><a href="#l85">85</a><td> */<tr><td><a id="l86"></a><a href="#l86">86</a><td>function Context(opt_configureForTesting) {<tr><td><a id="l87"></a><a href="#l87">87</a><td>  var closure = this.closure = vm.createContext({<tr><td><a id="l88"></a><a href="#l88">88</a><td>    console: console,<tr><td><a id="l89"></a><a href="#l89">89</a><td>    setTimeout: setTimeout,<tr><td><a id="l90"></a><a href="#l90">90</a><td>    setInterval: setInterval,<tr><td><a id="l91"></a><a href="#l91">91</a><td>    clearTimeout: clearTimeout,<tr><td><a id="l92"></a><a href="#l92">92</a><td>    clearInterval: clearInterval,<tr><td><a id="l93"></a><a href="#l93">93</a><td>    process: process,<tr><td><a id="l94"></a><a href="#l94">94</a><td>    require: require,<tr><td><a id="l95"></a><a href="#l95">95</a><td>    Buffer: Buffer,<tr><td><a id="l96"></a><a href="#l96">96</a><td>    Error: Error,<tr><td><a id="l97"></a><a href="#l97">97</a><td>    TypeError: TypeError,<tr><td><a id="l98"></a><a href="#l98">98</a><td>    CLOSURE_BASE_PATH: path.dirname(CLOSURE_BASE_FILE_PATH) + &#39;/&#39;,<tr><td><a id="l99"></a><a href="#l99">99</a><td>    CLOSURE_IMPORT_SCRIPT: function(src, opt_srcText) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>      if (opt_srcText !== undefined) {<tr><td><a id="l101"></a><a href="#l101">101</a><td>        // Windows paths use backslashes, which must be properly escaped before<tr><td><a id="l102"></a><a href="#l102">102</a><td>        // evaluated with vm.runInContext.<tr><td><a id="l103"></a><a href="#l103">103</a><td>        opt_srcText = opt_srcText.replace(/\\/g, &#39;/&#39;);<tr><td><a id="l104"></a><a href="#l104">104</a><td>        vm.runInContext(opt_srcText, closure, src);<tr><td><a id="l105"></a><a href="#l105">105</a><td>      } else {<tr><td><a id="l106"></a><a href="#l106">106</a><td>        loadScript(src);<tr><td><a id="l107"></a><a href="#l107">107</a><td>      }<tr><td><a id="l108"></a><a href="#l108">108</a><td>      return true;<tr><td><a id="l109"></a><a href="#l109">109</a><td>    },<tr><td><a id="l110"></a><a href="#l110">110</a><td>    CLOSURE_NO_DEPS: !isDevMode(),<tr><td><a id="l111"></a><a href="#l111">111</a><td>    CLOSURE_UNCOMPILED_DEFINES: {&#39;goog.json.USE_NATIVE_JSON&#39;: true},<tr><td><a id="l112"></a><a href="#l112">112</a><td>    goog: {}<tr><td><a id="l113"></a><a href="#l113">113</a><td>  });<tr><td><a id="l114"></a><a href="#l114">114</a><td>  closure.window = closure.top = closure;<tr><td><a id="l115"></a><a href="#l115">115</a><td><tr><td><a id="l116"></a><a href="#l116">116</a><td>  if (opt_configureForTesting) {<tr><td><a id="l117"></a><a href="#l117">117</a><td>    closure.document = {<tr><td><a id="l118"></a><a href="#l118">118</a><td>      body: {},<tr><td><a id="l119"></a><a href="#l119">119</a><td>      createElement: function() { return {}; },<tr><td><a id="l120"></a><a href="#l120">120</a><td>      getElementsByTagName: function() { return []; }<tr><td><a id="l121"></a><a href="#l121">121</a><td>    };<tr><td><a id="l122"></a><a href="#l122">122</a><td>    closure.document.body.ownerDocument = closure.document;<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>  loadScript(CLOSURE_BASE_FILE_PATH);<tr><td><a id="l126"></a><a href="#l126">126</a><td>  loadScript(DEPS_FILE_PATH);<tr><td><a id="l127"></a><a href="#l127">127</a><td><tr><td><a id="l128"></a><a href="#l128">128</a><td>  // Redefine retrieveAndExecModule_ to load modules. Closure&#39;s version<tr><td><a id="l129"></a><a href="#l129">129</a><td>  // assumes XMLHttpRequest is defined (and by extension that scripts<tr><td><a id="l130"></a><a href="#l130">130</a><td>  // are being loaded from a server).<tr><td><a id="l131"></a><a href="#l131">131</a><td>  closure.goog.retrieveAndExecModule_ = function(src) {<tr><td><a id="l132"></a><a href="#l132">132</a><td>    var normalizedSrc = path.normalize(src);<tr><td><a id="l133"></a><a href="#l133">133</a><td>    var contents = fs.readFileSync(normalizedSrc, &#39;utf8&#39;);<tr><td><a id="l134"></a><a href="#l134">134</a><td>    contents = closure.goog.wrapModule_(src, contents);<tr><td><a id="l135"></a><a href="#l135">135</a><td>    vm.runInContext(contents, closure, normalizedSrc);<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>   * Synchronously loads a script into the protected Closure context.<tr><td><a id="l140"></a><a href="#l140">140</a><td>   * @param {string} src Path to the file to load.<tr><td><a id="l141"></a><a href="#l141">141</a><td>   */<tr><td><a id="l142"></a><a href="#l142">142</a><td>  function loadScript(src) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>    src = path.normalize(src);<tr><td><a id="l144"></a><a href="#l144">144</a><td>    var contents = fs.readFileSync(src, &#39;utf8&#39;);<tr><td><a id="l145"></a><a href="#l145">145</a><td>    vm.runInContext(contents, closure, src);<tr><td><a id="l146"></a><a href="#l146">146</a><td>  }<tr><td><a id="l147"></a><a href="#l147">147</a><td>}<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>var context = new Context();<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * Loads a symbol by name from the protected Closure context.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {string} symbol The symbol to load.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @return {?} The loaded symbol, or {@code null} if not found.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @throws {Error} If the symbol has not been defined.<tr><td><a id="l158"></a><a href="#l158">158</a><td> */<tr><td><a id="l159"></a><a href="#l159">159</a><td>function closureRequire(symbol) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>  context.closure.goog.require(symbol);<tr><td><a id="l161"></a><a href="#l161">161</a><td>  return context.closure.goog.getObjectByName(symbol);<tr><td><a id="l162"></a><a href="#l162">162</a><td>}<tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td>// PUBLIC API<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>/**<tr><td><a id="l169"></a><a href="#l169">169</a><td> * Loads a symbol by name from the protected Closure context and exports its<tr><td><a id="l170"></a><a href="#l170">170</a><td> * public API to the provided object. This function relies on Closure code<tr><td><a id="l171"></a><a href="#l171">171</a><td> * conventions to define the public API of an object as those properties whose<tr><td><a id="l172"></a><a href="#l172">172</a><td> * name does not end with &quot;_&quot;.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @param {string} symbol The symbol to load. This must resolve to an object.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {!Object} An object with the exported API.<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @throws {Error} If the symbol has not been defined or does not resolve to<tr><td><a id="l176"></a><a href="#l176">176</a><td> *     an object.<tr><td><a id="l177"></a><a href="#l177">177</a><td> */<tr><td><a id="l178"></a><a href="#l178">178</a><td>exports.exportPublicApi = function(symbol) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>  var src = closureRequire(symbol);<tr><td><a id="l180"></a><a href="#l180">180</a><td>  if (typeof src != &#39;object&#39; || src === null) {<tr><td><a id="l181"></a><a href="#l181">181</a><td>    throw Error(&#39;&quot;&#39; + symbol + &#39;&quot; must resolve to an object&#39;);<tr><td><a id="l182"></a><a href="#l182">182</a><td>  }<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td>  var dest = {};<tr><td><a id="l185"></a><a href="#l185">185</a><td>  Object.keys(src).forEach(function(key) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>    if (key[key.length - 1] != &#39;_&#39;) {<tr><td><a id="l187"></a><a href="#l187">187</a><td>      dest[key] = src[key];<tr><td><a id="l188"></a><a href="#l188">188</a><td>    }<tr><td><a id="l189"></a><a href="#l189">189</a><td>  });<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td>  return dest;<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>if (isDevMode()) {<tr><td><a id="l196"></a><a href="#l196">196</a><td>  exports.closure = context.closure;<tr><td><a id="l197"></a><a href="#l197">197</a><td>}<tr><td><a id="l198"></a><a href="#l198">198</a><td>exports.Context = Context;<tr><td><a id="l199"></a><a href="#l199">199</a><td>exports.isDevMode = isDevMode;<tr><td><a id="l200"></a><a href="#l200">200</a><td>exports.require = closureRequire;</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>
\ No newline at end of file
diff --git a/docs/source/builder.js.src.html b/docs/source/builder.js.src.html
index 4ab2772..40be1bc 100644
--- a/docs/source/builder.js.src.html
+++ b/docs/source/builder.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>builder.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>builder.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>var base = require(&#39;./_base&#39;),<tr><td><a name="l16" href="#l16">16</a><td>    executors = require(&#39;./executors&#39;);<tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td>var goog = base.require(&#39;goog&#39;),<tr><td><a name="l19" href="#l19">19</a><td>    AbstractBuilder = base.require(&#39;webdriver.AbstractBuilder&#39;),<tr><td><a name="l20" href="#l20">20</a><td>    Browser = base.require(&#39;webdriver.Browser&#39;),<tr><td><a name="l21" href="#l21">21</a><td>    Capability = base.require(&#39;webdriver.Capability&#39;),<tr><td><a name="l22" href="#l22">22</a><td>    WebDriver = base.require(&#39;webdriver.WebDriver&#39;),<tr><td><a name="l23" href="#l23">23</a><td>    promise = base.require(&#39;webdriver.promise&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>/**<tr><td><a name="l27" href="#l27">27</a><td> * @param {!webdriver.Capabilities} capabilities The desired capabilities.<tr><td><a name="l28" href="#l28">28</a><td> * @return {webdriver.WebDriver} A new WebDriver instance or {@code null}<tr><td><a name="l29" href="#l29">29</a><td> *     if the requested browser is not natively supported in Node.<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>function createNativeDriver(capabilities) {<tr><td><a name="l32" href="#l32">32</a><td>  switch (capabilities.get(Capability.BROWSER_NAME)) {<tr><td><a name="l33" href="#l33">33</a><td>    case Browser.CHROME:<tr><td><a name="l34" href="#l34">34</a><td>      // Requiring &#39;chrome&#39; above would create a cycle:<tr><td><a name="l35" href="#l35">35</a><td>      // index -&gt; builder -&gt; chrome -&gt; index<tr><td><a name="l36" href="#l36">36</a><td>      var chrome = require(&#39;./chrome&#39;);<tr><td><a name="l37" href="#l37">37</a><td>      return chrome.createDriver(capabilities);<tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>    case Browser.PHANTOM_JS:<tr><td><a name="l40" href="#l40">40</a><td>      // Requiring &#39;phantomjs&#39; would create a cycle:<tr><td><a name="l41" href="#l41">41</a><td>      // index -&gt; builder -&gt; phantomjs -&gt; index<tr><td><a name="l42" href="#l42">42</a><td>      var phantomjs = require(&#39;./phantomjs&#39;);<tr><td><a name="l43" href="#l43">43</a><td>      return phantomjs.createDriver(capabilities);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>    default:<tr><td><a name="l46" href="#l46">46</a><td>      return null;<tr><td><a name="l47" href="#l47">47</a><td>  }<tr><td><a name="l48" href="#l48">48</a><td>}<tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td>/**<tr><td><a name="l53" href="#l53">53</a><td> * Creates new {@link webdriver.WebDriver WebDriver} instances.<tr><td><a name="l54" href="#l54">54</a><td> * @constructor<tr><td><a name="l55" href="#l55">55</a><td> * @extends {webdriver.AbstractBuilder}<tr><td><a name="l56" href="#l56">56</a><td> */<tr><td><a name="l57" href="#l57">57</a><td>var Builder = function() {<tr><td><a name="l58" href="#l58">58</a><td>  goog.base(this);<tr><td><a name="l59" href="#l59">59</a><td>};<tr><td><a name="l60" href="#l60">60</a><td>goog.inherits(Builder, AbstractBuilder);<tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td>/**<tr><td><a name="l64" href="#l64">64</a><td> * Sets the proxy configuration to use for WebDriver clients created by this<tr><td><a name="l65" href="#l65">65</a><td> * builder. Any calls to {@link #withCapabilities} after this function will<tr><td><a name="l66" href="#l66">66</a><td> * overwrite these settings.<tr><td><a name="l67" href="#l67">67</a><td> * @param {!proxy.ProxyConfig} config The configuration to use.<tr><td><a name="l68" href="#l68">68</a><td> * @return {!Builder} A self reference.<tr><td><a name="l69" href="#l69">69</a><td> */<tr><td><a name="l70" href="#l70">70</a><td>Builder.prototype.setProxy = function(config) {<tr><td><a name="l71" href="#l71">71</a><td>  this.getCapabilities().set(Capability.PROXY, config);<tr><td><a name="l72" href="#l72">72</a><td>  return this;<tr><td><a name="l73" href="#l73">73</a><td>};<tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td>/**<tr><td><a name="l77" href="#l77">77</a><td> * Sets Chrome-specific options for drivers created by this builder.<tr><td><a name="l78" href="#l78">78</a><td> * @param {!chrome.Options} options The ChromeDriver options to use.<tr><td><a name="l79" href="#l79">79</a><td> * @return {!Builder} A self reference.<tr><td><a name="l80" href="#l80">80</a><td> */<tr><td><a name="l81" href="#l81">81</a><td>Builder.prototype.setChromeOptions = function(options) {<tr><td><a name="l82" href="#l82">82</a><td>  var newCapabilities = options.toCapabilities(this.getCapabilities());<tr><td><a name="l83" href="#l83">83</a><td>  return /** @type {!Builder} */(this.withCapabilities(newCapabilities));<tr><td><a name="l84" href="#l84">84</a><td>};<tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td><tr><td><a name="l87" href="#l87">87</a><td>/**<tr><td><a name="l88" href="#l88">88</a><td> * @override<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>Builder.prototype.build = function() {<tr><td><a name="l91" href="#l91">91</a><td>  var url = this.getServerUrl();<tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>  // If a remote server wasn&#39;t specified, check for browsers we support<tr><td><a name="l94" href="#l94">94</a><td>  // natively in node before falling back to using the java Selenium server.<tr><td><a name="l95" href="#l95">95</a><td>  if (!url) {<tr><td><a name="l96" href="#l96">96</a><td>    var driver = createNativeDriver(this.getCapabilities());<tr><td><a name="l97" href="#l97">97</a><td>    if (driver) {<tr><td><a name="l98" href="#l98">98</a><td>      return driver;<tr><td><a name="l99" href="#l99">99</a><td>    }<tr><td><a name="l100" href="#l100">100</a><td><tr><td><a name="l101" href="#l101">101</a><td>    // Nope, fall-back to using the default java server.<tr><td><a name="l102" href="#l102">102</a><td>    url = AbstractBuilder.DEFAULT_SERVER_URL;<tr><td><a name="l103" href="#l103">103</a><td>  }<tr><td><a name="l104" href="#l104">104</a><td><tr><td><a name="l105" href="#l105">105</a><td>  var executor = executors.createExecutor(url);<tr><td><a name="l106" href="#l106">106</a><td>  return WebDriver.createSession(executor, this.getCapabilities());<tr><td><a name="l107" href="#l107">107</a><td>};<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>// PUBLIC API<tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td>exports.Builder = Builder;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
+<!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>builder.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>builder.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>var base = require(&#39;./_base&#39;),<tr><td><a id="l19"></a><a href="#l19">19</a><td>    executors = require(&#39;./executors&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>// Use base.require to avoid circular references between index and this module.<tr><td><a id="l22"></a><a href="#l22">22</a><td>var Browser = base.require(&#39;webdriver.Browser&#39;),<tr><td><a id="l23"></a><a href="#l23">23</a><td>    Capabilities = base.require(&#39;webdriver.Capabilities&#39;),<tr><td><a id="l24"></a><a href="#l24">24</a><td>    Capability = base.require(&#39;webdriver.Capability&#39;),<tr><td><a id="l25"></a><a href="#l25">25</a><td>    WebDriver = base.require(&#39;webdriver.WebDriver&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td>    promise = base.require(&#39;webdriver.promise&#39;);<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>var seleniumServer;<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> * Starts an instance of the Selenium server if not yet running.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {string} jar Path to the server jar to use.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @return {!webdriver.promise.Promise&lt;string&gt;} A promise for the server&#39;s<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     addrss once started.<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>function startSeleniumServer(jar) {<tr><td><a id="l39"></a><a href="#l39">39</a><td>  if (!seleniumServer) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>    // Requiring &#39;chrome&#39; above would create a cycle:<tr><td><a id="l41"></a><a href="#l41">41</a><td>    // index -&gt; builder -&gt; chrome -&gt; index<tr><td><a id="l42"></a><a href="#l42">42</a><td>    var remote = require(&#39;./remote&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>    seleniumServer = new remote.SeleniumServer(jar);<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 seleniumServer.start();<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>/**<tr><td><a id="l50"></a><a href="#l50">50</a><td> * Creates new {@link webdriver.WebDriver WebDriver} instances. The environment<tr><td><a id="l51"></a><a href="#l51">51</a><td> * variables listed below may be used to override a builder&#39;s configuration,<tr><td><a id="l52"></a><a href="#l52">52</a><td> * allowing quick runtime changes.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> * - {@code SELENIUM_BROWSER}: defines the target browser in the form<tr><td><a id="l55"></a><a href="#l55">55</a><td> *   {@code browser[:version][:platform]}.<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * - {@code SELENIUM_REMOTE_URL}: defines the remote URL for all builder<tr><td><a id="l58"></a><a href="#l58">58</a><td> *   instances. This environment variable should be set to a fully qualified<tr><td><a id="l59"></a><a href="#l59">59</a><td> *   URL for a WebDriver server (e.g. http://localhost:4444/wd/hub). This<tr><td><a id="l60"></a><a href="#l60">60</a><td> *   option always takes precedence over {@code SELENIUM_SERVER_JAR}.<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * - {@code SELENIUM_SERVER_JAR}: defines the path to the<tr><td><a id="l63"></a><a href="#l63">63</a><td> *   &lt;a href=&quot;http://selenium-release.storage.googleapis.com/index.html&quot;&gt;<tr><td><a id="l64"></a><a href="#l64">64</a><td> *   standalone Selenium server&lt;/a&gt; jar to use. The server will be started the<tr><td><a id="l65"></a><a href="#l65">65</a><td> *   first time a WebDriver instance and be killed when the process exits.<tr><td><a id="l66"></a><a href="#l66">66</a><td> *<tr><td><a id="l67"></a><a href="#l67">67</a><td> * Suppose you had mytest.js that created WebDriver with<tr><td><a id="l68"></a><a href="#l68">68</a><td> *<tr><td><a id="l69"></a><a href="#l69">69</a><td> *     var driver = new webdriver.Builder()<tr><td><a id="l70"></a><a href="#l70">70</a><td> *         .forBrowser(&#39;chrome&#39;)<tr><td><a id="l71"></a><a href="#l71">71</a><td> *         .build();<tr><td><a id="l72"></a><a href="#l72">72</a><td> *<tr><td><a id="l73"></a><a href="#l73">73</a><td> * This test could be made to use Firefox on the local machine by running with<tr><td><a id="l74"></a><a href="#l74">74</a><td> * `SELENIUM_BROWSER=firefox node mytest.js`. Rather than change the code to<tr><td><a id="l75"></a><a href="#l75">75</a><td> * target Google Chrome on a remote machine, you can simply set the<tr><td><a id="l76"></a><a href="#l76">76</a><td> * `SELENIUM_BROWSER` and `SELENIUM_REMOTE_URL` environment variables:<tr><td><a id="l77"></a><a href="#l77">77</a><td> *<tr><td><a id="l78"></a><a href="#l78">78</a><td> *     SELENIUM_BROWSER=chrome:36:LINUX \<tr><td><a id="l79"></a><a href="#l79">79</a><td> *     SELENIUM_REMOTE_URL=http://www.example.com:4444/wd/hub \<tr><td><a id="l80"></a><a href="#l80">80</a><td> *     node mytest.js<tr><td><a id="l81"></a><a href="#l81">81</a><td> *<tr><td><a id="l82"></a><a href="#l82">82</a><td> * You could also use a local copy of the standalone Selenium server:<tr><td><a id="l83"></a><a href="#l83">83</a><td> *<tr><td><a id="l84"></a><a href="#l84">84</a><td> *     SELENIUM_BROWSER=chrome:36:LINUX \<tr><td><a id="l85"></a><a href="#l85">85</a><td> *     SELENIUM_SERVER_JAR=/path/to/selenium-server-standalone.jar \<tr><td><a id="l86"></a><a href="#l86">86</a><td> *     node mytest.js<tr><td><a id="l87"></a><a href="#l87">87</a><td> *<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @constructor<tr><td><a id="l89"></a><a href="#l89">89</a><td> */<tr><td><a id="l90"></a><a href="#l90">90</a><td>var Builder = function() {<tr><td><a id="l91"></a><a href="#l91">91</a><td><tr><td><a id="l92"></a><a href="#l92">92</a><td>  /** @private {webdriver.promise.ControlFlow} */<tr><td><a id="l93"></a><a href="#l93">93</a><td>  this.flow_ = null;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td>  /** @private {string} */<tr><td><a id="l96"></a><a href="#l96">96</a><td>  this.url_ = &#39;&#39;;<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>  /** @private {?string} */<tr><td><a id="l99"></a><a href="#l99">99</a><td>  this.proxy_ = null;<tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td>  /** @private {!webdriver.Capabilities} */<tr><td><a id="l102"></a><a href="#l102">102</a><td>  this.capabilities_ = new Capabilities();<tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>  /** @private {chrome.Options} */<tr><td><a id="l105"></a><a href="#l105">105</a><td>  this.chromeOptions_ = null;<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td>  /** @private {firefox.Options} */<tr><td><a id="l108"></a><a href="#l108">108</a><td>  this.firefoxOptions_ = null;<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td>  /** @private {opera.Options} */<tr><td><a id="l111"></a><a href="#l111">111</a><td>  this.operaOptions_ = null;<tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td>  /** @private {ie.Options} */<tr><td><a id="l114"></a><a href="#l114">114</a><td>  this.ieOptions_ = null;<tr><td><a id="l115"></a><a href="#l115">115</a><td><tr><td><a id="l116"></a><a href="#l116">116</a><td>  /** @private {safari.Options} */<tr><td><a id="l117"></a><a href="#l117">117</a><td>  this.safariOptions_ = null;<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td>  /** @private {boolean} */<tr><td><a id="l120"></a><a href="#l120">120</a><td>  this.ignoreEnv_ = false;<tr><td><a id="l121"></a><a href="#l121">121</a><td>};<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>/**<tr><td><a id="l125"></a><a href="#l125">125</a><td> * Configures this builder to ignore any environment variable overrides and to<tr><td><a id="l126"></a><a href="#l126">126</a><td> * only use the configuration specified through this instance&#39;s API.<tr><td><a id="l127"></a><a href="#l127">127</a><td> *<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @return {!Builder} A self reference.<tr><td><a id="l129"></a><a href="#l129">129</a><td> */<tr><td><a id="l130"></a><a href="#l130">130</a><td>Builder.prototype.disableEnvironmentOverrides = function() {<tr><td><a id="l131"></a><a href="#l131">131</a><td>  this.ignoreEnv_ = true;<tr><td><a id="l132"></a><a href="#l132">132</a><td>  return this;<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>/**<tr><td><a id="l137"></a><a href="#l137">137</a><td> * Sets the URL of a remote WebDriver server to use. Once a remote URL has been<tr><td><a id="l138"></a><a href="#l138">138</a><td> * specified, the builder direct all new clients to that server. If this method<tr><td><a id="l139"></a><a href="#l139">139</a><td> * is never called, the Builder will attempt to create all clients locally.<tr><td><a id="l140"></a><a href="#l140">140</a><td> *<tr><td><a id="l141"></a><a href="#l141">141</a><td> * As an alternative to this method, you may also set the `SELENIUM_REMOTE_URL`<tr><td><a id="l142"></a><a href="#l142">142</a><td> * environment variable.<tr><td><a id="l143"></a><a href="#l143">143</a><td> *<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @param {string} url The URL of a remote server to use.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @return {!Builder} A self reference.<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>Builder.prototype.usingServer = function(url) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  this.url_ = url;<tr><td><a id="l149"></a><a href="#l149">149</a><td>  return this;<tr><td><a id="l150"></a><a href="#l150">150</a><td>};<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @return {string} The URL of the WebDriver server this instance is configured<tr><td><a id="l155"></a><a href="#l155">155</a><td> *     to use.<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>Builder.prototype.getServerUrl = function() {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  return this.url_;<tr><td><a id="l159"></a><a href="#l159">159</a><td>};<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * Sets the URL of the proxy to use for the WebDriver&#39;s HTTP connections.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * If this method is never called, the Builder will create a connection without<tr><td><a id="l165"></a><a href="#l165">165</a><td> * a proxy.<tr><td><a id="l166"></a><a href="#l166">166</a><td> *<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {string} proxy The URL of a proxy to use.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {!Builder} A self reference.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>Builder.prototype.usingWebDriverProxy = function(proxy) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>  this.proxy_ = proxy;<tr><td><a id="l172"></a><a href="#l172">172</a><td>  return this;<tr><td><a id="l173"></a><a href="#l173">173</a><td>};<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td>/**<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @return {string} The URL of the proxy server to use for the WebDriver&#39;s HTTP<tr><td><a id="l178"></a><a href="#l178">178</a><td> *    connections.<tr><td><a id="l179"></a><a href="#l179">179</a><td> */<tr><td><a id="l180"></a><a href="#l180">180</a><td>Builder.prototype.getWebDriverProxy = function() {<tr><td><a id="l181"></a><a href="#l181">181</a><td>  return this.proxy_;<tr><td><a id="l182"></a><a href="#l182">182</a><td>};<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>/**<tr><td><a id="l186"></a><a href="#l186">186</a><td> * Sets the desired capabilities when requesting a new session. This will<tr><td><a id="l187"></a><a href="#l187">187</a><td> * overwrite any previously set capabilities.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The desired<tr><td><a id="l189"></a><a href="#l189">189</a><td> *     capabilities for a new session.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @return {!Builder} A self reference.<tr><td><a id="l191"></a><a href="#l191">191</a><td> */<tr><td><a id="l192"></a><a href="#l192">192</a><td>Builder.prototype.withCapabilities = function(capabilities) {<tr><td><a id="l193"></a><a href="#l193">193</a><td>  this.capabilities_ = new Capabilities(capabilities);<tr><td><a id="l194"></a><a href="#l194">194</a><td>  return this;<tr><td><a id="l195"></a><a href="#l195">195</a><td>};<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>/**<tr><td><a id="l199"></a><a href="#l199">199</a><td> * Returns the base set of capabilities this instance is currently configured<tr><td><a id="l200"></a><a href="#l200">200</a><td> * to use.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @return {!webdriver.Capabilities} The current capabilities for this builder.<tr><td><a id="l202"></a><a href="#l202">202</a><td> */<tr><td><a id="l203"></a><a href="#l203">203</a><td>Builder.prototype.getCapabilities = function() {<tr><td><a id="l204"></a><a href="#l204">204</a><td>  return this.capabilities_;<tr><td><a id="l205"></a><a href="#l205">205</a><td>};<tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td>/**<tr><td><a id="l209"></a><a href="#l209">209</a><td> * Configures the target browser for clients created by this instance.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * Any calls to {@link #withCapabilities} after this function will<tr><td><a id="l211"></a><a href="#l211">211</a><td> * overwrite these settings.<tr><td><a id="l212"></a><a href="#l212">212</a><td> *<tr><td><a id="l213"></a><a href="#l213">213</a><td> * You may also define the target browser using the {@code SELENIUM_BROWSER}<tr><td><a id="l214"></a><a href="#l214">214</a><td> * environment variable. If set, this environment variable should be of the<tr><td><a id="l215"></a><a href="#l215">215</a><td> * form `browser[:[version][:platform]]`.<tr><td><a id="l216"></a><a href="#l216">216</a><td> *<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @param {(string|webdriver.Browser)} name The name of the target browser;<tr><td><a id="l218"></a><a href="#l218">218</a><td> *     common defaults are available on the {@link webdriver.Browser} enum.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @param {string=} opt_version A desired version; may be omitted if any<tr><td><a id="l220"></a><a href="#l220">220</a><td> *     version should be used.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {string=} opt_platform The desired platform; may be omitted if any<tr><td><a id="l222"></a><a href="#l222">222</a><td> *     version may be used.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @return {!Builder} A self reference.<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>Builder.prototype.forBrowser = function(name, opt_version, opt_platform) {<tr><td><a id="l226"></a><a href="#l226">226</a><td>  this.capabilities_.set(Capability.BROWSER_NAME, name);<tr><td><a id="l227"></a><a href="#l227">227</a><td>  this.capabilities_.set(Capability.VERSION, opt_version || null);<tr><td><a id="l228"></a><a href="#l228">228</a><td>  this.capabilities_.set(Capability.PLATFORM, opt_platform || null);<tr><td><a id="l229"></a><a href="#l229">229</a><td>  return this;<tr><td><a id="l230"></a><a href="#l230">230</a><td>};<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Sets the proxy configuration to use for WebDriver clients created by this<tr><td><a id="l235"></a><a href="#l235">235</a><td> * builder. Any calls to {@link #withCapabilities} after this function will<tr><td><a id="l236"></a><a href="#l236">236</a><td> * overwrite these settings.<tr><td><a id="l237"></a><a href="#l237">237</a><td> * @param {!webdriver.ProxyConfig} config The configuration to use.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @return {!Builder} A self reference.<tr><td><a id="l239"></a><a href="#l239">239</a><td> */<tr><td><a id="l240"></a><a href="#l240">240</a><td>Builder.prototype.setProxy = function(config) {<tr><td><a id="l241"></a><a href="#l241">241</a><td>  this.capabilities_.setProxy(config);<tr><td><a id="l242"></a><a href="#l242">242</a><td>  return this;<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><tr><td><a id="l246"></a><a href="#l246">246</a><td>/**<tr><td><a id="l247"></a><a href="#l247">247</a><td> * Sets the logging preferences for the created session. Preferences may be<tr><td><a id="l248"></a><a href="#l248">248</a><td> * changed by repeated calls, or by calling {@link #withCapabilities}.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @param {!(webdriver.logging.Preferences|Object.&lt;string, string&gt;)} prefs The<tr><td><a id="l250"></a><a href="#l250">250</a><td> *     desired logging preferences.<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @return {!Builder} A self reference.<tr><td><a id="l252"></a><a href="#l252">252</a><td> */<tr><td><a id="l253"></a><a href="#l253">253</a><td>Builder.prototype.setLoggingPrefs = function(prefs) {<tr><td><a id="l254"></a><a href="#l254">254</a><td>  this.capabilities_.setLoggingPrefs(prefs);<tr><td><a id="l255"></a><a href="#l255">255</a><td>  return this;<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>/**<tr><td><a id="l260"></a><a href="#l260">260</a><td> * Sets whether native events should be used.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @param {boolean} enabled Whether to enable native events.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @return {!Builder} A self reference.<tr><td><a id="l263"></a><a href="#l263">263</a><td> */<tr><td><a id="l264"></a><a href="#l264">264</a><td>Builder.prototype.setEnableNativeEvents = function(enabled) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>  this.capabilities_.setEnableNativeEvents(enabled);<tr><td><a id="l266"></a><a href="#l266">266</a><td>  return this;<tr><td><a id="l267"></a><a href="#l267">267</a><td>};<tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td>/**<tr><td><a id="l271"></a><a href="#l271">271</a><td> * Sets how elements should be scrolled into view for interaction.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @param {number} behavior The desired scroll behavior: either 0 to align with<tr><td><a id="l273"></a><a href="#l273">273</a><td> *     the top of the viewport or 1 to align with the bottom.<tr><td><a id="l274"></a><a href="#l274">274</a><td> * @return {!Builder} A self reference.<tr><td><a id="l275"></a><a href="#l275">275</a><td> */<tr><td><a id="l276"></a><a href="#l276">276</a><td>Builder.prototype.setScrollBehavior = function(behavior) {<tr><td><a id="l277"></a><a href="#l277">277</a><td>  this.capabilities_.setScrollBehavior(behavior);<tr><td><a id="l278"></a><a href="#l278">278</a><td>  return this;<tr><td><a id="l279"></a><a href="#l279">279</a><td>};<tr><td><a id="l280"></a><a href="#l280">280</a><td><tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td>/**<tr><td><a id="l283"></a><a href="#l283">283</a><td> * Sets the default action to take with an unexpected alert before returning<tr><td><a id="l284"></a><a href="#l284">284</a><td> * an error.<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @param {string} beahvior The desired behavior; should be &quot;accept&quot;, &quot;dismiss&quot;,<tr><td><a id="l286"></a><a href="#l286">286</a><td> *     or &quot;ignore&quot;. Defaults to &quot;dismiss&quot;.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @return {!Builder} A self reference.<tr><td><a id="l288"></a><a href="#l288">288</a><td> */<tr><td><a id="l289"></a><a href="#l289">289</a><td>Builder.prototype.setAlertBehavior = function(behavior) {<tr><td><a id="l290"></a><a href="#l290">290</a><td>  this.capabilities_.setAlertBehavior(behavior);<tr><td><a id="l291"></a><a href="#l291">291</a><td>  return this;<tr><td><a id="l292"></a><a href="#l292">292</a><td>};<tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>/**<tr><td><a id="l296"></a><a href="#l296">296</a><td> * Sets Chrome specific {@linkplain selenium-webdriver/chrome.Options options}<tr><td><a id="l297"></a><a href="#l297">297</a><td> * for drivers created by this builder. Any logging or proxy settings defined<tr><td><a id="l298"></a><a href="#l298">298</a><td> * on the given options will take precedence over those set through<tr><td><a id="l299"></a><a href="#l299">299</a><td> * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.<tr><td><a id="l300"></a><a href="#l300">300</a><td> *<tr><td><a id="l301"></a><a href="#l301">301</a><td> * @param {!chrome.Options} options The ChromeDriver options to use.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @return {!Builder} A self reference.<tr><td><a id="l303"></a><a href="#l303">303</a><td> */<tr><td><a id="l304"></a><a href="#l304">304</a><td>Builder.prototype.setChromeOptions = function(options) {<tr><td><a id="l305"></a><a href="#l305">305</a><td>  this.chromeOptions_ = options;<tr><td><a id="l306"></a><a href="#l306">306</a><td>  return this;<tr><td><a id="l307"></a><a href="#l307">307</a><td>};<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>/**<tr><td><a id="l311"></a><a href="#l311">311</a><td> * Sets Firefox specific {@linkplain selenium-webdriver/firefox.Options options}<tr><td><a id="l312"></a><a href="#l312">312</a><td> * for drivers created by this builder. Any logging or proxy settings defined<tr><td><a id="l313"></a><a href="#l313">313</a><td> * on the given options will take precedence over those set through<tr><td><a id="l314"></a><a href="#l314">314</a><td> * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.<tr><td><a id="l315"></a><a href="#l315">315</a><td> *<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @param {!firefox.Options} options The FirefoxDriver options to use.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @return {!Builder} A self reference.<tr><td><a id="l318"></a><a href="#l318">318</a><td> */<tr><td><a id="l319"></a><a href="#l319">319</a><td>Builder.prototype.setFirefoxOptions = function(options) {<tr><td><a id="l320"></a><a href="#l320">320</a><td>  this.firefoxOptions_ = options;<tr><td><a id="l321"></a><a href="#l321">321</a><td>  return this;<tr><td><a id="l322"></a><a href="#l322">322</a><td>};<tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td>/**<tr><td><a id="l326"></a><a href="#l326">326</a><td> * Sets Opera specific {@linkplain selenium-webdriver/opera.Options options} for<tr><td><a id="l327"></a><a href="#l327">327</a><td> * drivers created by this builder. Any logging or proxy settings defined on the<tr><td><a id="l328"></a><a href="#l328">328</a><td> * given options will take precedence over those set through<tr><td><a id="l329"></a><a href="#l329">329</a><td> * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.<tr><td><a id="l330"></a><a href="#l330">330</a><td> *<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @param {!opera.Options} options The OperaDriver options to use.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @return {!Builder} A self reference.<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>Builder.prototype.setOperaOptions = function(options) {<tr><td><a id="l335"></a><a href="#l335">335</a><td>  this.operaOptions_ = options;<tr><td><a id="l336"></a><a href="#l336">336</a><td>  return this;<tr><td><a id="l337"></a><a href="#l337">337</a><td>};<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Sets Internet Explorer specific<tr><td><a id="l342"></a><a href="#l342">342</a><td> * {@linkplain selenium-webdriver/ie.Options options} for drivers created by<tr><td><a id="l343"></a><a href="#l343">343</a><td> * this builder. Any proxy settings defined on the given options will take<tr><td><a id="l344"></a><a href="#l344">344</a><td> * precedence over those set through {@link #setProxy}.<tr><td><a id="l345"></a><a href="#l345">345</a><td> *<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @param {!ie.Options} options The IEDriver options to use.<tr><td><a id="l347"></a><a href="#l347">347</a><td> * @return {!Builder} A self reference.<tr><td><a id="l348"></a><a href="#l348">348</a><td> */<tr><td><a id="l349"></a><a href="#l349">349</a><td>Builder.prototype.setIeOptions = function(options) {<tr><td><a id="l350"></a><a href="#l350">350</a><td>  this.ieOptions_ = options;<tr><td><a id="l351"></a><a href="#l351">351</a><td>  return this;<tr><td><a id="l352"></a><a href="#l352">352</a><td>};<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td><tr><td><a id="l355"></a><a href="#l355">355</a><td>/**<tr><td><a id="l356"></a><a href="#l356">356</a><td> * Sets Safari specific {@linkplain selenium-webdriver/safari.Options options}<tr><td><a id="l357"></a><a href="#l357">357</a><td> * for drivers created by this builder. Any logging settings defined on the<tr><td><a id="l358"></a><a href="#l358">358</a><td> * given options will take precedence over those set through<tr><td><a id="l359"></a><a href="#l359">359</a><td> * {@link #setLoggingPrefs}.<tr><td><a id="l360"></a><a href="#l360">360</a><td> *<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @param {!safari.Options} options The Safari options to use.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @return {!Builder} A self reference.<tr><td><a id="l363"></a><a href="#l363">363</a><td> */<tr><td><a id="l364"></a><a href="#l364">364</a><td>Builder.prototype.setSafariOptions = function(options) {<tr><td><a id="l365"></a><a href="#l365">365</a><td>  this.safariOptions_ = options;<tr><td><a id="l366"></a><a href="#l366">366</a><td>  return this;<tr><td><a id="l367"></a><a href="#l367">367</a><td>};<tr><td><a id="l368"></a><a href="#l368">368</a><td><tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td>/**<tr><td><a id="l371"></a><a href="#l371">371</a><td> * Sets the control flow that created drivers should execute actions in. If<tr><td><a id="l372"></a><a href="#l372">372</a><td> * the flow is never set, or is set to {@code null}, it will use the active<tr><td><a id="l373"></a><a href="#l373">373</a><td> * flow at the time {@link #build()} is called.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {webdriver.promise.ControlFlow} flow The control flow to use, or<tr><td><a id="l375"></a><a href="#l375">375</a><td> *     {@code null} to<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @return {!Builder} A self reference.<tr><td><a id="l377"></a><a href="#l377">377</a><td> */<tr><td><a id="l378"></a><a href="#l378">378</a><td>Builder.prototype.setControlFlow = function(flow) {<tr><td><a id="l379"></a><a href="#l379">379</a><td>  this.flow_ = flow;<tr><td><a id="l380"></a><a href="#l380">380</a><td>  return this;<tr><td><a id="l381"></a><a href="#l381">381</a><td>};<tr><td><a id="l382"></a><a href="#l382">382</a><td><tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td>/**<tr><td><a id="l385"></a><a href="#l385">385</a><td> * Creates a new WebDriver client based on this builder&#39;s current<tr><td><a id="l386"></a><a href="#l386">386</a><td> * configuration.<tr><td><a id="l387"></a><a href="#l387">387</a><td> *<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @return {!webdriver.WebDriver} A new WebDriver instance.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @throws {Error} If the current configuration is invalid.<tr><td><a id="l390"></a><a href="#l390">390</a><td> */<tr><td><a id="l391"></a><a href="#l391">391</a><td>Builder.prototype.build = function() {<tr><td><a id="l392"></a><a href="#l392">392</a><td>  // Create a copy for any changes we may need to make based on the current<tr><td><a id="l393"></a><a href="#l393">393</a><td>  // environment.<tr><td><a id="l394"></a><a href="#l394">394</a><td>  var capabilities = new Capabilities(this.capabilities_);<tr><td><a id="l395"></a><a href="#l395">395</a><td><tr><td><a id="l396"></a><a href="#l396">396</a><td>  var browser;<tr><td><a id="l397"></a><a href="#l397">397</a><td>  if (!this.ignoreEnv_ &amp;&amp; process.env.SELENIUM_BROWSER) {<tr><td><a id="l398"></a><a href="#l398">398</a><td>    browser = process.env.SELENIUM_BROWSER.split(/:/, 3);<tr><td><a id="l399"></a><a href="#l399">399</a><td>    capabilities.set(Capability.BROWSER_NAME, browser[0]);<tr><td><a id="l400"></a><a href="#l400">400</a><td>    capabilities.set(Capability.VERSION, browser[1] || null);<tr><td><a id="l401"></a><a href="#l401">401</a><td>    capabilities.set(Capability.PLATFORM, browser[2] || null);<tr><td><a id="l402"></a><a href="#l402">402</a><td>  }<tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td>  browser = capabilities.get(Capability.BROWSER_NAME);<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td>  if (typeof browser !== &#39;string&#39;) {<tr><td><a id="l407"></a><a href="#l407">407</a><td>    throw TypeError(<tr><td><a id="l408"></a><a href="#l408">408</a><td>        &#39;Target browser must be a string, but is &lt;&#39; + (typeof browser) + &#39;&gt;;&#39; +<tr><td><a id="l409"></a><a href="#l409">409</a><td>        &#39; did you forget to call forBrowser()?&#39;);<tr><td><a id="l410"></a><a href="#l410">410</a><td>  }<tr><td><a id="l411"></a><a href="#l411">411</a><td><tr><td><a id="l412"></a><a href="#l412">412</a><td>  if (browser === &#39;ie&#39;) {<tr><td><a id="l413"></a><a href="#l413">413</a><td>    browser = Browser.INTERNET_EXPLORER;<tr><td><a id="l414"></a><a href="#l414">414</a><td>  }<tr><td><a id="l415"></a><a href="#l415">415</a><td><tr><td><a id="l416"></a><a href="#l416">416</a><td>  // Apply browser specific overrides.<tr><td><a id="l417"></a><a href="#l417">417</a><td>  if (browser === Browser.CHROME &amp;&amp; this.chromeOptions_) {<tr><td><a id="l418"></a><a href="#l418">418</a><td>    capabilities.merge(this.chromeOptions_.toCapabilities());<tr><td><a id="l419"></a><a href="#l419">419</a><td><tr><td><a id="l420"></a><a href="#l420">420</a><td>  } else if (browser === Browser.FIREFOX &amp;&amp; this.firefoxOptions_) {<tr><td><a id="l421"></a><a href="#l421">421</a><td>    capabilities.merge(this.firefoxOptions_.toCapabilities());<tr><td><a id="l422"></a><a href="#l422">422</a><td><tr><td><a id="l423"></a><a href="#l423">423</a><td>  } else if (browser === Browser.INTERNET_EXPLORER &amp;&amp; this.ieOptions_) {<tr><td><a id="l424"></a><a href="#l424">424</a><td>    capabilities.merge(this.ieOptions_.toCapabilities());<tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td>  } else if (browser === Browser.OPERA &amp;&amp; this.operaOptions_) {<tr><td><a id="l427"></a><a href="#l427">427</a><td>    capabilities.merge(this.operaOptions_.toCapabilities());<tr><td><a id="l428"></a><a href="#l428">428</a><td><tr><td><a id="l429"></a><a href="#l429">429</a><td>  } else if (browser === Browser.SAFARI &amp;&amp; this.safariOptions_) {<tr><td><a id="l430"></a><a href="#l430">430</a><td>    capabilities.merge(this.safariOptions_.toCapabilities());<tr><td><a id="l431"></a><a href="#l431">431</a><td>  }<tr><td><a id="l432"></a><a href="#l432">432</a><td><tr><td><a id="l433"></a><a href="#l433">433</a><td>  // Check for a remote browser.<tr><td><a id="l434"></a><a href="#l434">434</a><td>  var url = this.url_;<tr><td><a id="l435"></a><a href="#l435">435</a><td>  if (!this.ignoreEnv_) {<tr><td><a id="l436"></a><a href="#l436">436</a><td>    if (process.env.SELENIUM_REMOTE_URL) {<tr><td><a id="l437"></a><a href="#l437">437</a><td>      url = process.env.SELENIUM_REMOTE_URL;<tr><td><a id="l438"></a><a href="#l438">438</a><td>    } else if (process.env.SELENIUM_SERVER_JAR) {<tr><td><a id="l439"></a><a href="#l439">439</a><td>      url = startSeleniumServer(process.env.SELENIUM_SERVER_JAR);<tr><td><a id="l440"></a><a href="#l440">440</a><td>    }<tr><td><a id="l441"></a><a href="#l441">441</a><td>  }<tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td>  if (url) {<tr><td><a id="l444"></a><a href="#l444">444</a><td>    var executor = executors.createExecutor(url, this.proxy_);<tr><td><a id="l445"></a><a href="#l445">445</a><td>    return WebDriver.createSession(executor, capabilities, this.flow_);<tr><td><a id="l446"></a><a href="#l446">446</a><td>  }<tr><td><a id="l447"></a><a href="#l447">447</a><td><tr><td><a id="l448"></a><a href="#l448">448</a><td>  // Check for a native browser.<tr><td><a id="l449"></a><a href="#l449">449</a><td>  switch (browser) {<tr><td><a id="l450"></a><a href="#l450">450</a><td>    case Browser.CHROME:<tr><td><a id="l451"></a><a href="#l451">451</a><td>      // Requiring &#39;chrome&#39; above would create a cycle:<tr><td><a id="l452"></a><a href="#l452">452</a><td>      // index -&gt; builder -&gt; chrome -&gt; index<tr><td><a id="l453"></a><a href="#l453">453</a><td>      var chrome = require(&#39;./chrome&#39;);<tr><td><a id="l454"></a><a href="#l454">454</a><td>      return new chrome.Driver(capabilities, null, this.flow_);<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td>    case Browser.FIREFOX:<tr><td><a id="l457"></a><a href="#l457">457</a><td>      // Requiring &#39;firefox&#39; above would create a cycle:<tr><td><a id="l458"></a><a href="#l458">458</a><td>      // index -&gt; builder -&gt; firefox -&gt; index<tr><td><a id="l459"></a><a href="#l459">459</a><td>      var firefox = require(&#39;./firefox&#39;);<tr><td><a id="l460"></a><a href="#l460">460</a><td>      return new firefox.Driver(capabilities, this.flow_);<tr><td><a id="l461"></a><a href="#l461">461</a><td><tr><td><a id="l462"></a><a href="#l462">462</a><td>    case Browser.INTERNET_EXPLORER:<tr><td><a id="l463"></a><a href="#l463">463</a><td>      // Requiring &#39;ie&#39; above would create a cycle:<tr><td><a id="l464"></a><a href="#l464">464</a><td>      // index -&gt; builder -&gt; ie -&gt; index<tr><td><a id="l465"></a><a href="#l465">465</a><td>      var ie = require(&#39;./ie&#39;);<tr><td><a id="l466"></a><a href="#l466">466</a><td>      return new ie.Driver(capabilities, this.flow_);<tr><td><a id="l467"></a><a href="#l467">467</a><td><tr><td><a id="l468"></a><a href="#l468">468</a><td>    case Browser.OPERA:<tr><td><a id="l469"></a><a href="#l469">469</a><td>      // Requiring &#39;opera&#39; would create a cycle:<tr><td><a id="l470"></a><a href="#l470">470</a><td>      // index -&gt; builder -&gt; opera -&gt; index<tr><td><a id="l471"></a><a href="#l471">471</a><td>      var opera = require(&#39;./opera&#39;);<tr><td><a id="l472"></a><a href="#l472">472</a><td>      return new opera.Driver(capabilities, this.flow_);<tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td>    case Browser.PHANTOM_JS:<tr><td><a id="l475"></a><a href="#l475">475</a><td>      // Requiring &#39;phantomjs&#39; would create a cycle:<tr><td><a id="l476"></a><a href="#l476">476</a><td>      // index -&gt; builder -&gt; phantomjs -&gt; index<tr><td><a id="l477"></a><a href="#l477">477</a><td>      var phantomjs = require(&#39;./phantomjs&#39;);<tr><td><a id="l478"></a><a href="#l478">478</a><td>      return new phantomjs.Driver(capabilities, this.flow_);<tr><td><a id="l479"></a><a href="#l479">479</a><td><tr><td><a id="l480"></a><a href="#l480">480</a><td>    case Browser.SAFARI:<tr><td><a id="l481"></a><a href="#l481">481</a><td>      // Requiring &#39;safari&#39; would create a cycle:<tr><td><a id="l482"></a><a href="#l482">482</a><td>      // index -&gt; builder -&gt; safari -&gt; index<tr><td><a id="l483"></a><a href="#l483">483</a><td>      var safari = require(&#39;./safari&#39;);<tr><td><a id="l484"></a><a href="#l484">484</a><td>      return new safari.Driver(capabilities, this.flow_);<tr><td><a id="l485"></a><a href="#l485">485</a><td><tr><td><a id="l486"></a><a href="#l486">486</a><td>    default:<tr><td><a id="l487"></a><a href="#l487">487</a><td>      throw new Error(&#39;Do not know how to build driver: &#39; + browser<tr><td><a id="l488"></a><a href="#l488">488</a><td>          + &#39;; did you forget to call usingServer(url)?&#39;);<tr><td><a id="l489"></a><a href="#l489">489</a><td>  }<tr><td><a id="l490"></a><a href="#l490">490</a><td>};<tr><td><a id="l491"></a><a href="#l491">491</a><td><tr><td><a id="l492"></a><a href="#l492">492</a><td><tr><td><a id="l493"></a><a href="#l493">493</a><td>// PUBLIC API<tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td><tr><td><a id="l496"></a><a href="#l496">496</a><td>exports.Builder = Builder;</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>
\ No newline at end of file
diff --git a/docs/source/chrome.js.src.html b/docs/source/chrome.js.src.html
index 6d4103c..112dd44 100644
--- a/docs/source/chrome.js.src.html
+++ b/docs/source/chrome.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>chrome.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>chrome.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>&#39;use strict&#39;;<tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td>var fs = require(&#39;fs&#39;),<tr><td><a name="l19" href="#l19">19</a><td>    util = require(&#39;util&#39;);<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a name="l22" href="#l22">22</a><td>    executors = require(&#39;./executors&#39;),<tr><td><a name="l23" href="#l23">23</a><td>    io = require(&#39;./io&#39;),<tr><td><a name="l24" href="#l24">24</a><td>    portprober = require(&#39;./net/portprober&#39;),<tr><td><a name="l25" href="#l25">25</a><td>    remote = require(&#39;./remote&#39;);<tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>/**<tr><td><a name="l29" href="#l29">29</a><td> * Name of the ChromeDriver executable.<tr><td><a name="l30" href="#l30">30</a><td> * @type {string}<tr><td><a name="l31" href="#l31">31</a><td> * @const<tr><td><a name="l32" href="#l32">32</a><td> */<tr><td><a name="l33" href="#l33">33</a><td>var CHROMEDRIVER_EXE =<tr><td><a name="l34" href="#l34">34</a><td>    process.platform === &#39;win32&#39; ? &#39;chromedriver.exe&#39; : &#39;chromedriver&#39;;<tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td>/**<tr><td><a name="l38" href="#l38">38</a><td> * Creates {@link remote.DriverService} instances that manage a ChromeDriver<tr><td><a name="l39" href="#l39">39</a><td> * server.<tr><td><a name="l40" href="#l40">40</a><td> * @param {string=} opt_exe Path to the server executable to use. If omitted,<tr><td><a name="l41" href="#l41">41</a><td> *     the builder will attempt to locate the chromedriver on the current<tr><td><a name="l42" href="#l42">42</a><td> *     PATH.<tr><td><a name="l43" href="#l43">43</a><td> * @throws {Error} If provided executable does not exist, or the chromedriver<tr><td><a name="l44" href="#l44">44</a><td> *     cannot be found on the PATH.<tr><td><a name="l45" href="#l45">45</a><td> * @constructor<tr><td><a name="l46" href="#l46">46</a><td> */<tr><td><a name="l47" href="#l47">47</a><td>var ServiceBuilder = function(opt_exe) {<tr><td><a name="l48" href="#l48">48</a><td>  /** @private {string} */<tr><td><a name="l49" href="#l49">49</a><td>  this.exe_ = opt_exe || io.findInPath(CHROMEDRIVER_EXE, true);<tr><td><a name="l50" href="#l50">50</a><td>  if (!this.exe_) {<tr><td><a name="l51" href="#l51">51</a><td>    throw Error(<tr><td><a name="l52" href="#l52">52</a><td>        &#39;The ChromeDriver could not be found on the current PATH. Please &#39; +<tr><td><a name="l53" href="#l53">53</a><td>        &#39;download the latest version of the ChromeDriver from &#39; +<tr><td><a name="l54" href="#l54">54</a><td>        &#39;http://chromedriver.storage.googleapis.com/index.html and ensure &#39; +<tr><td><a name="l55" href="#l55">55</a><td>        &#39;it can be found on your PATH.&#39;);<tr><td><a name="l56" href="#l56">56</a><td>  }<tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td>  if (!fs.existsSync(this.exe_)) {<tr><td><a name="l59" href="#l59">59</a><td>    throw Error(&#39;File does not exist: &#39; + this.exe_);<tr><td><a name="l60" href="#l60">60</a><td>  }<tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td>  /** @private {!Array.&lt;string&gt;} */<tr><td><a name="l63" href="#l63">63</a><td>  this.args_ = [];<tr><td><a name="l64" href="#l64">64</a><td>  this.stdio_ = &#39;ignore&#39;;<tr><td><a name="l65" href="#l65">65</a><td>};<tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td>/** @private {number} */<tr><td><a name="l69" href="#l69">69</a><td>ServiceBuilder.prototype.port_ = 0;<tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td>/** @private {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} */<tr><td><a name="l73" href="#l73">73</a><td>ServiceBuilder.prototype.stdio_ = &#39;ignore&#39;;<tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td>/** @private {Object.&lt;string, string&gt;} */<tr><td><a name="l77" href="#l77">77</a><td>ServiceBuilder.prototype.env_ = null;<tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td><tr><td><a name="l80" href="#l80">80</a><td>/**<tr><td><a name="l81" href="#l81">81</a><td> * Sets the port to start the ChromeDriver on.<tr><td><a name="l82" href="#l82">82</a><td> * @param {number} port The port to use, or 0 for any free port.<tr><td><a name="l83" href="#l83">83</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a name="l84" href="#l84">84</a><td> * @throws {Error} If the port is invalid.<tr><td><a name="l85" href="#l85">85</a><td> */<tr><td><a name="l86" href="#l86">86</a><td>ServiceBuilder.prototype.usingPort = function(port) {<tr><td><a name="l87" href="#l87">87</a><td>  if (port &lt; 0) {<tr><td><a name="l88" href="#l88">88</a><td>    throw Error(&#39;port must be &gt;= 0: &#39; + port);<tr><td><a name="l89" href="#l89">89</a><td>  }<tr><td><a name="l90" href="#l90">90</a><td>  this.port_ = port;<tr><td><a name="l91" href="#l91">91</a><td>  return this;<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/**<tr><td><a name="l96" href="#l96">96</a><td> * Sets the path of the log file the driver should log to. If a log file is<tr><td><a name="l97" href="#l97">97</a><td> * not specified, the driver will log to stderr.<tr><td><a name="l98" href="#l98">98</a><td> * @param {string} path Path of the log file to use.<tr><td><a name="l99" href="#l99">99</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a name="l100" href="#l100">100</a><td> */<tr><td><a name="l101" href="#l101">101</a><td>ServiceBuilder.prototype.loggingTo = function(path) {<tr><td><a name="l102" href="#l102">102</a><td>  this.args_.push(&#39;--log-path=&#39; + path);<tr><td><a name="l103" href="#l103">103</a><td>  return this;<tr><td><a name="l104" href="#l104">104</a><td>};<tr><td><a name="l105" href="#l105">105</a><td><tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td>/**<tr><td><a name="l108" href="#l108">108</a><td> * Enables verbose logging.<tr><td><a name="l109" href="#l109">109</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a name="l110" href="#l110">110</a><td> */<tr><td><a name="l111" href="#l111">111</a><td>ServiceBuilder.prototype.enableVerboseLogging = function() {<tr><td><a name="l112" href="#l112">112</a><td>  this.args_.push(&#39;--verbose&#39;);<tr><td><a name="l113" href="#l113">113</a><td>  return this;<tr><td><a name="l114" href="#l114">114</a><td>};<tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td>/**<tr><td><a name="l118" href="#l118">118</a><td> * Sets the number of threads the driver should use to manage HTTP requests.<tr><td><a name="l119" href="#l119">119</a><td> * By default, the driver will use 4 threads.<tr><td><a name="l120" href="#l120">120</a><td> * @param {number} n The number of threads to use.<tr><td><a name="l121" href="#l121">121</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a name="l122" href="#l122">122</a><td> */<tr><td><a name="l123" href="#l123">123</a><td>ServiceBuilder.prototype.setNumHttpThreads = function(n) {<tr><td><a name="l124" href="#l124">124</a><td>  this.args_.push(&#39;--http-threads=&#39; + n);<tr><td><a name="l125" href="#l125">125</a><td>  return this;<tr><td><a name="l126" href="#l126">126</a><td>};<tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td>/**<tr><td><a name="l130" href="#l130">130</a><td> * Sets the base path for WebDriver REST commands (e.g. &quot;/wd/hub&quot;).<tr><td><a name="l131" href="#l131">131</a><td> * By default, the driver will accept commands relative to &quot;/&quot;.<tr><td><a name="l132" href="#l132">132</a><td> * @param {string} path The base path to use.<tr><td><a name="l133" href="#l133">133</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a name="l134" href="#l134">134</a><td> */<tr><td><a name="l135" href="#l135">135</a><td>ServiceBuilder.prototype.setUrlBasePath = function(path) {<tr><td><a name="l136" href="#l136">136</a><td>  this.args_.push(&#39;--url-base=&#39; + path);<tr><td><a name="l137" href="#l137">137</a><td>  return this;<tr><td><a name="l138" href="#l138">138</a><td>};<tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td><tr><td><a name="l141" href="#l141">141</a><td>/**<tr><td><a name="l142" href="#l142">142</a><td> * Defines the stdio configuration for the driver service. See<tr><td><a name="l143" href="#l143">143</a><td> * {@code child_process.spawn} for more information.<tr><td><a name="l144" href="#l144">144</a><td> * @param {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} config The<tr><td><a name="l145" href="#l145">145</a><td> *     configuration to use.<tr><td><a name="l146" href="#l146">146</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a name="l147" href="#l147">147</a><td> */<tr><td><a name="l148" href="#l148">148</a><td>ServiceBuilder.prototype.setStdio = function(config) {<tr><td><a name="l149" href="#l149">149</a><td>  this.stdio_ = config;<tr><td><a name="l150" href="#l150">150</a><td>  return this;<tr><td><a name="l151" href="#l151">151</a><td>};<tr><td><a name="l152" href="#l152">152</a><td><tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td>/**<tr><td><a name="l155" href="#l155">155</a><td> * Defines the environment to start the server under. This settings will be<tr><td><a name="l156" href="#l156">156</a><td> * inherited by every browser session started by the server.<tr><td><a name="l157" href="#l157">157</a><td> * @param {!Object.&lt;string, string&gt;} env The environment to use.<tr><td><a name="l158" href="#l158">158</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a name="l159" href="#l159">159</a><td> */<tr><td><a name="l160" href="#l160">160</a><td>ServiceBuilder.prototype.withEnvironment = function(env) {<tr><td><a name="l161" href="#l161">161</a><td>  this.env_ = env;<tr><td><a name="l162" href="#l162">162</a><td>  return this;<tr><td><a name="l163" href="#l163">163</a><td>};<tr><td><a name="l164" href="#l164">164</a><td><tr><td><a name="l165" href="#l165">165</a><td><tr><td><a name="l166" href="#l166">166</a><td>/**<tr><td><a name="l167" href="#l167">167</a><td> * Creates a new DriverService using this instance&#39;s current configuration.<tr><td><a name="l168" href="#l168">168</a><td> * @return {remote.DriverService} A new driver service using this instance&#39;s<tr><td><a name="l169" href="#l169">169</a><td> *     current configuration.<tr><td><a name="l170" href="#l170">170</a><td> * @throws {Error} If the driver exectuable was not specified and a default<tr><td><a name="l171" href="#l171">171</a><td> *     could not be found on the current PATH.<tr><td><a name="l172" href="#l172">172</a><td> */<tr><td><a name="l173" href="#l173">173</a><td>ServiceBuilder.prototype.build = function() {<tr><td><a name="l174" href="#l174">174</a><td>  var port = this.port_ || portprober.findFreePort();<tr><td><a name="l175" href="#l175">175</a><td>  var args = this.args_.concat();  // Defensive copy.<tr><td><a name="l176" href="#l176">176</a><td><tr><td><a name="l177" href="#l177">177</a><td>  return new remote.DriverService(this.exe_, {<tr><td><a name="l178" href="#l178">178</a><td>    port: port,<tr><td><a name="l179" href="#l179">179</a><td>    args: webdriver.promise.when(port, function(port) {<tr><td><a name="l180" href="#l180">180</a><td>      return args.concat(&#39;--port=&#39; + port);<tr><td><a name="l181" href="#l181">181</a><td>    }),<tr><td><a name="l182" href="#l182">182</a><td>    env: this.env_,<tr><td><a name="l183" href="#l183">183</a><td>    stdio: this.stdio_<tr><td><a name="l184" href="#l184">184</a><td>  });<tr><td><a name="l185" href="#l185">185</a><td>};<tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td><tr><td><a name="l188" href="#l188">188</a><td>/** @type {remote.DriverService} */<tr><td><a name="l189" href="#l189">189</a><td>var defaultService = null;<tr><td><a name="l190" href="#l190">190</a><td><tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td>/**<tr><td><a name="l193" href="#l193">193</a><td> * Sets the default service to use for new ChromeDriver instances.<tr><td><a name="l194" href="#l194">194</a><td> * @param {!remote.DriverService} service The service to use.<tr><td><a name="l195" href="#l195">195</a><td> * @throws {Error} If the default service is currently running.<tr><td><a name="l196" href="#l196">196</a><td> */<tr><td><a name="l197" href="#l197">197</a><td>function setDefaultService(service) {<tr><td><a name="l198" href="#l198">198</a><td>  if (defaultService &amp;&amp; defaultService.isRunning()) {<tr><td><a name="l199" href="#l199">199</a><td>    throw Error(<tr><td><a name="l200" href="#l200">200</a><td>        &#39;The previously configured ChromeDriver service is still running. &#39; +<tr><td><a name="l201" href="#l201">201</a><td>        &#39;You must shut it down before you may adjust its configuration.&#39;);<tr><td><a name="l202" href="#l202">202</a><td>  }<tr><td><a name="l203" href="#l203">203</a><td>  defaultService = service;<tr><td><a name="l204" href="#l204">204</a><td>}<tr><td><a name="l205" href="#l205">205</a><td><tr><td><a name="l206" href="#l206">206</a><td><tr><td><a name="l207" href="#l207">207</a><td>/**<tr><td><a name="l208" href="#l208">208</a><td> * Returns the default ChromeDriver service. If such a service has not been<tr><td><a name="l209" href="#l209">209</a><td> * configured, one will be constructed using the default configuration for<tr><td><a name="l210" href="#l210">210</a><td> * a ChromeDriver executable found on the system PATH.<tr><td><a name="l211" href="#l211">211</a><td> * @return {!remote.DriverService} The default ChromeDriver service.<tr><td><a name="l212" href="#l212">212</a><td> */<tr><td><a name="l213" href="#l213">213</a><td>function getDefaultService() {<tr><td><a name="l214" href="#l214">214</a><td>  if (!defaultService) {<tr><td><a name="l215" href="#l215">215</a><td>    defaultService = new ServiceBuilder().build();<tr><td><a name="l216" href="#l216">216</a><td>  }<tr><td><a name="l217" href="#l217">217</a><td>  return defaultService;<tr><td><a name="l218" href="#l218">218</a><td>}<tr><td><a name="l219" href="#l219">219</a><td><tr><td><a name="l220" href="#l220">220</a><td><tr><td><a name="l221" href="#l221">221</a><td>/**<tr><td><a name="l222" href="#l222">222</a><td> * @type {string}<tr><td><a name="l223" href="#l223">223</a><td> * @const<tr><td><a name="l224" href="#l224">224</a><td> */<tr><td><a name="l225" href="#l225">225</a><td>var OPTIONS_CAPABILITY_KEY = &#39;chromeOptions&#39;;<tr><td><a name="l226" href="#l226">226</a><td><tr><td><a name="l227" href="#l227">227</a><td><tr><td><a name="l228" href="#l228">228</a><td>/**<tr><td><a name="l229" href="#l229">229</a><td> * Class for managing ChromeDriver specific options.<tr><td><a name="l230" href="#l230">230</a><td> * @constructor<tr><td><a name="l231" href="#l231">231</a><td> */<tr><td><a name="l232" href="#l232">232</a><td>var Options = function() {<tr><td><a name="l233" href="#l233">233</a><td>  /** @private {!Array.&lt;string&gt;} */<tr><td><a name="l234" href="#l234">234</a><td>  this.args_ = [];<tr><td><a name="l235" href="#l235">235</a><td><tr><td><a name="l236" href="#l236">236</a><td>  /** @private {!Array.&lt;(string|!Buffer)&gt;} */<tr><td><a name="l237" href="#l237">237</a><td>  this.extensions_ = [];<tr><td><a name="l238" href="#l238">238</a><td>};<tr><td><a name="l239" href="#l239">239</a><td><tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td>/**<tr><td><a name="l242" href="#l242">242</a><td> * Extracts the ChromeDriver specific options from the given capabilities<tr><td><a name="l243" href="#l243">243</a><td> * object.<tr><td><a name="l244" href="#l244">244</a><td> * @param {!webdriver.Capabilities} capabilities The capabilities object.<tr><td><a name="l245" href="#l245">245</a><td> * @return {!Options} The ChromeDriver options.<tr><td><a name="l246" href="#l246">246</a><td> */<tr><td><a name="l247" href="#l247">247</a><td>Options.fromCapabilities = function(capabilities) {<tr><td><a name="l248" href="#l248">248</a><td>  var options = new Options();<tr><td><a name="l249" href="#l249">249</a><td><tr><td><a name="l250" href="#l250">250</a><td>  var o = capabilities.get(OPTIONS_CAPABILITY_KEY);<tr><td><a name="l251" href="#l251">251</a><td>  if (o instanceof Options) {<tr><td><a name="l252" href="#l252">252</a><td>    options = o;<tr><td><a name="l253" href="#l253">253</a><td>  } else if (o) {<tr><td><a name="l254" href="#l254">254</a><td>    options.<tr><td><a name="l255" href="#l255">255</a><td>        addArguments(o.args || []).<tr><td><a name="l256" href="#l256">256</a><td>        addExtensions(o.extensions || []).<tr><td><a name="l257" href="#l257">257</a><td>        detachDriver(!!o.detach).<tr><td><a name="l258" href="#l258">258</a><td>        setChromeBinaryPath(o.binary).<tr><td><a name="l259" href="#l259">259</a><td>        setChromeLogFile(o.logFile).<tr><td><a name="l260" href="#l260">260</a><td>        setLocalState(o.localState).<tr><td><a name="l261" href="#l261">261</a><td>        setUserPreferences(o.prefs);<tr><td><a name="l262" href="#l262">262</a><td>  }<tr><td><a name="l263" href="#l263">263</a><td><tr><td><a name="l264" href="#l264">264</a><td>  if (capabilities.has(webdriver.Capability.PROXY)) {<tr><td><a name="l265" href="#l265">265</a><td>    options.setProxy(capabilities.get(webdriver.Capability.PROXY));<tr><td><a name="l266" href="#l266">266</a><td>  }<tr><td><a name="l267" href="#l267">267</a><td><tr><td><a name="l268" href="#l268">268</a><td>  if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {<tr><td><a name="l269" href="#l269">269</a><td>    options.setLoggingPreferences(<tr><td><a name="l270" href="#l270">270</a><td>        capabilities.get(webdriver.Capability.LOGGING_PREFS));<tr><td><a name="l271" href="#l271">271</a><td>  }<tr><td><a name="l272" href="#l272">272</a><td><tr><td><a name="l273" href="#l273">273</a><td>  return options;<tr><td><a name="l274" href="#l274">274</a><td>};<tr><td><a name="l275" href="#l275">275</a><td><tr><td><a name="l276" href="#l276">276</a><td><tr><td><a name="l277" href="#l277">277</a><td>/**<tr><td><a name="l278" href="#l278">278</a><td> * Add additional command line arguments to use when launching the Chrome<tr><td><a name="l279" href="#l279">279</a><td> * browser.  Each argument may be specified with or without the &quot;--&quot; prefix<tr><td><a name="l280" href="#l280">280</a><td> * (e.g. &quot;--foo&quot; and &quot;foo&quot;). Arguments with an associated value should be<tr><td><a name="l281" href="#l281">281</a><td> * delimited by an &quot;=&quot;: &quot;foo=bar&quot;.<tr><td><a name="l282" href="#l282">282</a><td> * @param {...(string|!Array.&lt;string&gt;)} var_args The arguments to add.<tr><td><a name="l283" href="#l283">283</a><td> * @return {!Options} A self reference.<tr><td><a name="l284" href="#l284">284</a><td> */<tr><td><a name="l285" href="#l285">285</a><td>Options.prototype.addArguments = function(var_args) {<tr><td><a name="l286" href="#l286">286</a><td>  this.args_ = this.args_.concat.apply(this.args_, arguments);<tr><td><a name="l287" href="#l287">287</a><td>  return this;<tr><td><a name="l288" href="#l288">288</a><td>};<tr><td><a name="l289" href="#l289">289</a><td><tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td>/**<tr><td><a name="l292" href="#l292">292</a><td> * Add additional extensions to install when launching Chrome. Each extension<tr><td><a name="l293" href="#l293">293</a><td> * should be specified as the path to the packed CRX file, or a Buffer for an<tr><td><a name="l294" href="#l294">294</a><td> * extension.<tr><td><a name="l295" href="#l295">295</a><td> * @param {...(string|!Buffer|!Array.&lt;(string|!Buffer)&gt;)} var_args The<tr><td><a name="l296" href="#l296">296</a><td> *     extensions to add.<tr><td><a name="l297" href="#l297">297</a><td> * @return {!Options} A self reference.<tr><td><a name="l298" href="#l298">298</a><td> */<tr><td><a name="l299" href="#l299">299</a><td>Options.prototype.addExtensions = function(var_args) {<tr><td><a name="l300" href="#l300">300</a><td>  this.extensions_ = this.extensions_.concat.apply(<tr><td><a name="l301" href="#l301">301</a><td>      this.extensions_, arguments);<tr><td><a name="l302" href="#l302">302</a><td>  return this;<tr><td><a name="l303" href="#l303">303</a><td>};<tr><td><a name="l304" href="#l304">304</a><td><tr><td><a name="l305" href="#l305">305</a><td><tr><td><a name="l306" href="#l306">306</a><td>/**<tr><td><a name="l307" href="#l307">307</a><td> * Sets the path to the Chrome binary to use. On Mac OS X, this path should<tr><td><a name="l308" href="#l308">308</a><td> * reference the actual Chrome executable, not just the application binary<tr><td><a name="l309" href="#l309">309</a><td> * (e.g. &quot;/Applications/Google Chrome.app/Contents/MacOS/Google Chrome&quot;).<tr><td><a name="l310" href="#l310">310</a><td> *<tr><td><a name="l311" href="#l311">311</a><td> * The binary path be absolute or relative to the chromedriver server<tr><td><a name="l312" href="#l312">312</a><td> * executable, but it must exist on the machine that will launch Chrome.<tr><td><a name="l313" href="#l313">313</a><td> *<tr><td><a name="l314" href="#l314">314</a><td> * @param {string} path The path to the Chrome binary to use.<tr><td><a name="l315" href="#l315">315</a><td> * @return {!Options} A self reference.<tr><td><a name="l316" href="#l316">316</a><td> */<tr><td><a name="l317" href="#l317">317</a><td>Options.prototype.setChromeBinaryPath = function(path) {<tr><td><a name="l318" href="#l318">318</a><td>  this.binary_ = path;<tr><td><a name="l319" href="#l319">319</a><td>  return this;<tr><td><a name="l320" href="#l320">320</a><td>};<tr><td><a name="l321" href="#l321">321</a><td><tr><td><a name="l322" href="#l322">322</a><td><tr><td><a name="l323" href="#l323">323</a><td>/**<tr><td><a name="l324" href="#l324">324</a><td> * Sets whether to leave the started Chrome browser running if the controlling<tr><td><a name="l325" href="#l325">325</a><td> * ChromeDriver service is killed before {@link webdriver.WebDriver#quit()} is<tr><td><a name="l326" href="#l326">326</a><td> * called.<tr><td><a name="l327" href="#l327">327</a><td> * @param {boolean} detach Whether to leave the browser running if the<tr><td><a name="l328" href="#l328">328</a><td> *     chromedriver service is killed before the session.<tr><td><a name="l329" href="#l329">329</a><td> * @return {!Options} A self reference.<tr><td><a name="l330" href="#l330">330</a><td> */<tr><td><a name="l331" href="#l331">331</a><td>Options.prototype.detachDriver = function(detach) {<tr><td><a name="l332" href="#l332">332</a><td>  this.detach_ = detach;<tr><td><a name="l333" href="#l333">333</a><td>  return this;<tr><td><a name="l334" href="#l334">334</a><td>};<tr><td><a name="l335" href="#l335">335</a><td><tr><td><a name="l336" href="#l336">336</a><td><tr><td><a name="l337" href="#l337">337</a><td>/**<tr><td><a name="l338" href="#l338">338</a><td> * Sets the user preferences for Chrome&#39;s user profile. See the &quot;Preferences&quot;<tr><td><a name="l339" href="#l339">339</a><td> * file in Chrome&#39;s user data directory for examples.<tr><td><a name="l340" href="#l340">340</a><td> * @param {!Object} prefs Dictionary of user preferences to use.<tr><td><a name="l341" href="#l341">341</a><td> * @return {!Options} A self reference.<tr><td><a name="l342" href="#l342">342</a><td> */<tr><td><a name="l343" href="#l343">343</a><td>Options.prototype.setUserPreferences = function(prefs) {<tr><td><a name="l344" href="#l344">344</a><td>  this.prefs_ = prefs;<tr><td><a name="l345" href="#l345">345</a><td>  return this;<tr><td><a name="l346" href="#l346">346</a><td>};<tr><td><a name="l347" href="#l347">347</a><td><tr><td><a name="l348" href="#l348">348</a><td><tr><td><a name="l349" href="#l349">349</a><td>/**<tr><td><a name="l350" href="#l350">350</a><td> * Sets the logging preferences for the new session.<tr><td><a name="l351" href="#l351">351</a><td> * @param {!webdriver.logging.Preferences} prefs The logging preferences.<tr><td><a name="l352" href="#l352">352</a><td> * @return {!Options} A self reference.<tr><td><a name="l353" href="#l353">353</a><td> */<tr><td><a name="l354" href="#l354">354</a><td>Options.prototype.setLoggingPreferences = function(prefs) {<tr><td><a name="l355" href="#l355">355</a><td>  this.logPrefs_ = prefs;<tr><td><a name="l356" href="#l356">356</a><td>  return this;<tr><td><a name="l357" href="#l357">357</a><td>};<tr><td><a name="l358" href="#l358">358</a><td><tr><td><a name="l359" href="#l359">359</a><td><tr><td><a name="l360" href="#l360">360</a><td>/**<tr><td><a name="l361" href="#l361">361</a><td> * Sets preferences for the &quot;Local State&quot; file in Chrome&#39;s user data<tr><td><a name="l362" href="#l362">362</a><td> * directory.<tr><td><a name="l363" href="#l363">363</a><td> * @param {!Object} state Dictionary of local state preferences.<tr><td><a name="l364" href="#l364">364</a><td> * @return {!Options} A self reference.<tr><td><a name="l365" href="#l365">365</a><td> */<tr><td><a name="l366" href="#l366">366</a><td>Options.prototype.setLocalState = function(state) {<tr><td><a name="l367" href="#l367">367</a><td>  this.localState_ = state;<tr><td><a name="l368" href="#l368">368</a><td>  return this;<tr><td><a name="l369" href="#l369">369</a><td>};<tr><td><a name="l370" href="#l370">370</a><td><tr><td><a name="l371" href="#l371">371</a><td><tr><td><a name="l372" href="#l372">372</a><td>/**<tr><td><a name="l373" href="#l373">373</a><td> * Sets the path to Chrome&#39;s log file. This path should exist on the machine<tr><td><a name="l374" href="#l374">374</a><td> * that will launch Chrome.<tr><td><a name="l375" href="#l375">375</a><td> * @param {string} path Path to the log file to use.<tr><td><a name="l376" href="#l376">376</a><td> * @return {!Options} A self reference.<tr><td><a name="l377" href="#l377">377</a><td> */<tr><td><a name="l378" href="#l378">378</a><td>Options.prototype.setChromeLogFile = function(path) {<tr><td><a name="l379" href="#l379">379</a><td>  this.logFile_ = path;<tr><td><a name="l380" href="#l380">380</a><td>  return this;<tr><td><a name="l381" href="#l381">381</a><td>};<tr><td><a name="l382" href="#l382">382</a><td><tr><td><a name="l383" href="#l383">383</a><td><tr><td><a name="l384" href="#l384">384</a><td>/**<tr><td><a name="l385" href="#l385">385</a><td> * Sets the proxy settings for the new session.<tr><td><a name="l386" href="#l386">386</a><td> * @param {ProxyConfig} proxy The proxy configuration to use.<tr><td><a name="l387" href="#l387">387</a><td> * @return {!Options} A self reference.<tr><td><a name="l388" href="#l388">388</a><td> */<tr><td><a name="l389" href="#l389">389</a><td>Options.prototype.setProxy = function(proxy) {<tr><td><a name="l390" href="#l390">390</a><td>  this.proxy_ = proxy;<tr><td><a name="l391" href="#l391">391</a><td>  return this;<tr><td><a name="l392" href="#l392">392</a><td>};<tr><td><a name="l393" href="#l393">393</a><td><tr><td><a name="l394" href="#l394">394</a><td><tr><td><a name="l395" href="#l395">395</a><td>/**<tr><td><a name="l396" href="#l396">396</a><td> * Converts this options instance to a {@link webdriver.Capabilities} object.<tr><td><a name="l397" href="#l397">397</a><td> * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge<tr><td><a name="l398" href="#l398">398</a><td> *     these options into, if any.<tr><td><a name="l399" href="#l399">399</a><td> * @return {!webdriver.Capabilities} The capabilities.<tr><td><a name="l400" href="#l400">400</a><td> */<tr><td><a name="l401" href="#l401">401</a><td>Options.prototype.toCapabilities = function(opt_capabilities) {<tr><td><a name="l402" href="#l402">402</a><td>  var capabilities = opt_capabilities || webdriver.Capabilities.chrome();<tr><td><a name="l403" href="#l403">403</a><td>  capabilities.<tr><td><a name="l404" href="#l404">404</a><td>      set(webdriver.Capability.PROXY, this.proxy_).<tr><td><a name="l405" href="#l405">405</a><td>      set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_).<tr><td><a name="l406" href="#l406">406</a><td>      set(OPTIONS_CAPABILITY_KEY, this);<tr><td><a name="l407" href="#l407">407</a><td>  return capabilities;<tr><td><a name="l408" href="#l408">408</a><td>};<tr><td><a name="l409" href="#l409">409</a><td><tr><td><a name="l410" href="#l410">410</a><td><tr><td><a name="l411" href="#l411">411</a><td>/**<tr><td><a name="l412" href="#l412">412</a><td> * Converts this instance to its JSON wire protocol representation. Note this<tr><td><a name="l413" href="#l413">413</a><td> * function is an implementation not intended for general use.<tr><td><a name="l414" href="#l414">414</a><td> * @return {{args: !Array.&lt;string&gt;,<tr><td><a name="l415" href="#l415">415</a><td> *           binary: (string|undefined),<tr><td><a name="l416" href="#l416">416</a><td> *           detach: boolean,<tr><td><a name="l417" href="#l417">417</a><td> *           extensions: !Array.&lt;string&gt;,<tr><td><a name="l418" href="#l418">418</a><td> *           localState: (Object|undefined),<tr><td><a name="l419" href="#l419">419</a><td> *           logFile: (string|undefined),<tr><td><a name="l420" href="#l420">420</a><td> *           prefs: (Object|undefined)}} The JSON wire protocol representation<tr><td><a name="l421" href="#l421">421</a><td> *     of this instance.<tr><td><a name="l422" href="#l422">422</a><td> */<tr><td><a name="l423" href="#l423">423</a><td>Options.prototype.toJSON = function() {<tr><td><a name="l424" href="#l424">424</a><td>  return {<tr><td><a name="l425" href="#l425">425</a><td>    args: this.args_,<tr><td><a name="l426" href="#l426">426</a><td>    binary: this.binary_,<tr><td><a name="l427" href="#l427">427</a><td>    detach: !!this.detach_,<tr><td><a name="l428" href="#l428">428</a><td>    extensions: this.extensions_.map(function(extension) {<tr><td><a name="l429" href="#l429">429</a><td>      if (Buffer.isBuffer(extension)) {<tr><td><a name="l430" href="#l430">430</a><td>        return extension.toString(&#39;base64&#39;);<tr><td><a name="l431" href="#l431">431</a><td>      }<tr><td><a name="l432" href="#l432">432</a><td>      return fs.readFileSync(extension, &#39;base64&#39;);<tr><td><a name="l433" href="#l433">433</a><td>    }),<tr><td><a name="l434" href="#l434">434</a><td>    localState: this.localState_,<tr><td><a name="l435" href="#l435">435</a><td>    logFile: this.logFile_,<tr><td><a name="l436" href="#l436">436</a><td>    prefs: this.prefs_<tr><td><a name="l437" href="#l437">437</a><td>  };<tr><td><a name="l438" href="#l438">438</a><td>};<tr><td><a name="l439" href="#l439">439</a><td><tr><td><a name="l440" href="#l440">440</a><td><tr><td><a name="l441" href="#l441">441</a><td>/**<tr><td><a name="l442" href="#l442">442</a><td> * Creates a new ChromeDriver session.<tr><td><a name="l443" href="#l443">443</a><td> * @param {(webdriver.Capabilities|Options)=} opt_options The session options.<tr><td><a name="l444" href="#l444">444</a><td> * @param {remote.DriverService=} opt_service The session to use; will use<tr><td><a name="l445" href="#l445">445</a><td> *     the {@link getDefaultService default service} by default.<tr><td><a name="l446" href="#l446">446</a><td> * @return {!webdriver.WebDriver} A new WebDriver instance.<tr><td><a name="l447" href="#l447">447</a><td> */<tr><td><a name="l448" href="#l448">448</a><td>function createDriver(opt_options, opt_service) {<tr><td><a name="l449" href="#l449">449</a><td>  var service = opt_service || getDefaultService();<tr><td><a name="l450" href="#l450">450</a><td>  var executor = executors.createExecutor(service.start());<tr><td><a name="l451" href="#l451">451</a><td><tr><td><a name="l452" href="#l452">452</a><td>  var options = opt_options || new Options();<tr><td><a name="l453" href="#l453">453</a><td>  if (opt_options instanceof webdriver.Capabilities) {<tr><td><a name="l454" href="#l454">454</a><td>    // Extract the Chrome-specific options so we do not send unnecessary<tr><td><a name="l455" href="#l455">455</a><td>    // data across the wire.<tr><td><a name="l456" href="#l456">456</a><td>    options = Options.fromCapabilities(options);<tr><td><a name="l457" href="#l457">457</a><td>  }<tr><td><a name="l458" href="#l458">458</a><td><tr><td><a name="l459" href="#l459">459</a><td>  return webdriver.WebDriver.createSession(<tr><td><a name="l460" href="#l460">460</a><td>      executor, options.toCapabilities());<tr><td><a name="l461" href="#l461">461</a><td>}<tr><td><a name="l462" href="#l462">462</a><td><tr><td><a name="l463" href="#l463">463</a><td><tr><td><a name="l464" href="#l464">464</a><td><tr><td><a name="l465" href="#l465">465</a><td>// PUBLIC API<tr><td><a name="l466" href="#l466">466</a><td><tr><td><a name="l467" href="#l467">467</a><td><tr><td><a name="l468" href="#l468">468</a><td>exports.ServiceBuilder = ServiceBuilder;<tr><td><a name="l469" href="#l469">469</a><td>exports.Options = Options;<tr><td><a name="l470" href="#l470">470</a><td>exports.createDriver = createDriver;<tr><td><a name="l471" href="#l471">471</a><td>exports.getDefaultService = getDefaultService;<tr><td><a name="l472" href="#l472">472</a><td>exports.setDefaultService = setDefaultService;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
+<!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>chrome.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>chrome.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines a {@linkplain Driver WebDriver} client for the Chrome<tr><td><a id="l20"></a><a href="#l20">20</a><td> * web browser. Before using this module, you must download the latest<tr><td><a id="l21"></a><a href="#l21">21</a><td> * [ChromeDriver release] and ensure it can be found on your system [PATH].<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * There are three primary classes exported by this module:<tr><td><a id="l24"></a><a href="#l24">24</a><td> *<tr><td><a id="l25"></a><a href="#l25">25</a><td> * 1. {@linkplain ServiceBuilder}: configures the<tr><td><a id="l26"></a><a href="#l26">26</a><td> *     {@link selenium-webdriver/remote.DriverService remote.DriverService}<tr><td><a id="l27"></a><a href="#l27">27</a><td> *     that manages the [ChromeDriver] child process.<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * 2. {@linkplain Options}: defines configuration options for each new Chrome<tr><td><a id="l30"></a><a href="#l30">30</a><td> *     session, such as which {@linkplain Options#setProxy proxy} to use,<tr><td><a id="l31"></a><a href="#l31">31</a><td> *     what {@linkplain Options#addExtensions extensions} to install, or<tr><td><a id="l32"></a><a href="#l32">32</a><td> *     what {@linkplain Options#addArguments command-line switches} to use when<tr><td><a id="l33"></a><a href="#l33">33</a><td> *     starting the browser.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * 3. {@linkplain Driver}: the WebDriver client; each new instance will control<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     a unique browser session with a clean user profile (unless otherwise<tr><td><a id="l37"></a><a href="#l37">37</a><td> *     configured through the {@link Options} class).<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * __Customizing the ChromeDriver Server__ &lt;a id=&quot;custom-server&quot;&gt;&lt;/a&gt;<tr><td><a id="l40"></a><a href="#l40">40</a><td> *<tr><td><a id="l41"></a><a href="#l41">41</a><td> * By default, every Chrome session will use a single driver service, which is<tr><td><a id="l42"></a><a href="#l42">42</a><td> * started the first time a {@link Driver} instance is created and terminated<tr><td><a id="l43"></a><a href="#l43">43</a><td> * when this process exits. The default service will inherit its environment<tr><td><a id="l44"></a><a href="#l44">44</a><td> * from the current process and direct all output to /dev/null. You may obtain<tr><td><a id="l45"></a><a href="#l45">45</a><td> * a handle to this default service using<tr><td><a id="l46"></a><a href="#l46">46</a><td> * {@link #getDefaultService getDefaultService()} and change its configuration<tr><td><a id="l47"></a><a href="#l47">47</a><td> * with {@link #setDefaultService setDefaultService()}.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * You may also create a {@link Driver} with its own driver service. This is<tr><td><a id="l50"></a><a href="#l50">50</a><td> * useful if you need to capture the server&#39;s log output for a specific session:<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> *     var chrome = require(&#39;selenium-webdriver/chrome&#39;);<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> *     var service = new chrome.ServiceBuilder()<tr><td><a id="l55"></a><a href="#l55">55</a><td> *         .loggingTo(&#39;/my/log/file.txt&#39;)<tr><td><a id="l56"></a><a href="#l56">56</a><td> *         .enableVerboseLogging()<tr><td><a id="l57"></a><a href="#l57">57</a><td> *         .build();<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     var options = new chrome.Options();<tr><td><a id="l60"></a><a href="#l60">60</a><td> *     // configure browser options ...<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> *     var driver = new chrome.Driver(options, service);<tr><td><a id="l63"></a><a href="#l63">63</a><td> *<tr><td><a id="l64"></a><a href="#l64">64</a><td> * Users should only instantiate the {@link Driver} class directly when they<tr><td><a id="l65"></a><a href="#l65">65</a><td> * need a custom driver service configuration (as shown above). For normal<tr><td><a id="l66"></a><a href="#l66">66</a><td> * operation, users should start Chrome using the<tr><td><a id="l67"></a><a href="#l67">67</a><td> * {@link selenium-webdriver.Builder}.<tr><td><a id="l68"></a><a href="#l68">68</a><td> *<tr><td><a id="l69"></a><a href="#l69">69</a><td> * __Working with Android__ &lt;a id=&quot;android&quot;&gt;&lt;/a&gt;<tr><td><a id="l70"></a><a href="#l70">70</a><td> *<tr><td><a id="l71"></a><a href="#l71">71</a><td> * The [ChromeDriver][android] supports running tests on the Chrome browser as<tr><td><a id="l72"></a><a href="#l72">72</a><td> * well as [WebView apps][webview] starting in Android 4.4 (KitKat). In order to<tr><td><a id="l73"></a><a href="#l73">73</a><td> * work with Android, you must first start the adb<tr><td><a id="l74"></a><a href="#l74">74</a><td> *<tr><td><a id="l75"></a><a href="#l75">75</a><td> *     adb start-server<tr><td><a id="l76"></a><a href="#l76">76</a><td> *<tr><td><a id="l77"></a><a href="#l77">77</a><td> * By default, adb will start on port 5037. You may change this port, but this<tr><td><a id="l78"></a><a href="#l78">78</a><td> * will require configuring a [custom server](#custom-server) that will connect<tr><td><a id="l79"></a><a href="#l79">79</a><td> * to adb on the {@linkplain ServiceBuilder#setAdbPort correct port}:<tr><td><a id="l80"></a><a href="#l80">80</a><td> *<tr><td><a id="l81"></a><a href="#l81">81</a><td> *     var service = new chrome.ServiceBuilder()<tr><td><a id="l82"></a><a href="#l82">82</a><td> *         .setAdbPort(1234)<tr><td><a id="l83"></a><a href="#l83">83</a><td> *         build();<tr><td><a id="l84"></a><a href="#l84">84</a><td> *     // etc.<tr><td><a id="l85"></a><a href="#l85">85</a><td> *<tr><td><a id="l86"></a><a href="#l86">86</a><td> * The ChromeDriver may be configured to launch Chrome on Android using<tr><td><a id="l87"></a><a href="#l87">87</a><td> * {@link Options#androidChrome()}:<tr><td><a id="l88"></a><a href="#l88">88</a><td> *<tr><td><a id="l89"></a><a href="#l89">89</a><td> *     var driver = new Builder()<tr><td><a id="l90"></a><a href="#l90">90</a><td> *         .forBrowser(&#39;chrome&#39;)<tr><td><a id="l91"></a><a href="#l91">91</a><td> *         .setChromeOptions(new chrome.Options().androidChrome())<tr><td><a id="l92"></a><a href="#l92">92</a><td> *         .build();<tr><td><a id="l93"></a><a href="#l93">93</a><td> *<tr><td><a id="l94"></a><a href="#l94">94</a><td> * Alternatively, you can configure the ChromeDriver to launch an app with a<tr><td><a id="l95"></a><a href="#l95">95</a><td> * Chrome-WebView by setting the {@linkplain Options#androidActivity<tr><td><a id="l96"></a><a href="#l96">96</a><td> * androidActivity} option:<tr><td><a id="l97"></a><a href="#l97">97</a><td> *<tr><td><a id="l98"></a><a href="#l98">98</a><td> *     var driver = new Builder()<tr><td><a id="l99"></a><a href="#l99">99</a><td> *         .forBrowser(&#39;chrome&#39;)<tr><td><a id="l100"></a><a href="#l100">100</a><td> *         .setChromeOptions(new chrome.Options()<tr><td><a id="l101"></a><a href="#l101">101</a><td> *             .androidPackage(&#39;com.example&#39;)<tr><td><a id="l102"></a><a href="#l102">102</a><td> *             .androidActivity(&#39;com.example.Activity&#39;))<tr><td><a id="l103"></a><a href="#l103">103</a><td> *         .build();<tr><td><a id="l104"></a><a href="#l104">104</a><td> *<tr><td><a id="l105"></a><a href="#l105">105</a><td> * [Refer to the ChromeDriver site] for more information on using the<tr><td><a id="l106"></a><a href="#l106">106</a><td> * [ChromeDriver with Android][android].<tr><td><a id="l107"></a><a href="#l107">107</a><td> *<tr><td><a id="l108"></a><a href="#l108">108</a><td> * [ChromeDriver]: https://sites.google.com/a/chromium.org/chromedriver/<tr><td><a id="l109"></a><a href="#l109">109</a><td> * [ChromeDriver release]: http://chromedriver.storage.googleapis.com/index.html<tr><td><a id="l110"></a><a href="#l110">110</a><td> * [PATH]: http://en.wikipedia.org/wiki/PATH_%28variable%29<tr><td><a id="l111"></a><a href="#l111">111</a><td> * [android]: https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android<tr><td><a id="l112"></a><a href="#l112">112</a><td> * [webview]: https://developer.chrome.com/multidevice/webview/overview<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>&#39;use strict&#39;;<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l118"></a><a href="#l118">118</a><td>    util = require(&#39;util&#39;);<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a id="l121"></a><a href="#l121">121</a><td>    executors = require(&#39;./executors&#39;),<tr><td><a id="l122"></a><a href="#l122">122</a><td>    http = require(&#39;./http&#39;),<tr><td><a id="l123"></a><a href="#l123">123</a><td>    io = require(&#39;./io&#39;),<tr><td><a id="l124"></a><a href="#l124">124</a><td>    portprober = require(&#39;./net/portprober&#39;),<tr><td><a id="l125"></a><a href="#l125">125</a><td>    remote = require(&#39;./remote&#39;);<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>/**<tr><td><a id="l129"></a><a href="#l129">129</a><td> * Name of the ChromeDriver executable.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @type {string}<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @const<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>var CHROMEDRIVER_EXE =<tr><td><a id="l134"></a><a href="#l134">134</a><td>    process.platform === &#39;win32&#39; ? &#39;chromedriver.exe&#39; : &#39;chromedriver&#39;;<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> * Custom command names supported by ChromeDriver.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @enum {string}<tr><td><a id="l140"></a><a href="#l140">140</a><td> */<tr><td><a id="l141"></a><a href="#l141">141</a><td>var Command = {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  LAUNCH_APP: &#39;launchApp&#39;<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> * Creates a command executor with support for ChromeDriver&#39;s custom commands.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @param {!webdriver.promise.Promise&lt;string&gt;} url The server&#39;s URL.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @return {!webdriver.CommandExecutor} The new command executor.<tr><td><a id="l150"></a><a href="#l150">150</a><td> */<tr><td><a id="l151"></a><a href="#l151">151</a><td>function createExecutor(url) {<tr><td><a id="l152"></a><a href="#l152">152</a><td>  return new executors.DeferredExecutor(url.then(function(url) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>    var client = new http.HttpClient(url);<tr><td><a id="l154"></a><a href="#l154">154</a><td>    var executor = new http.Executor(client);<tr><td><a id="l155"></a><a href="#l155">155</a><td>    executor.defineCommand(<tr><td><a id="l156"></a><a href="#l156">156</a><td>        Command.LAUNCH_APP,<tr><td><a id="l157"></a><a href="#l157">157</a><td>        &#39;POST&#39;, &#39;/session/:sessionId/chromium/launch_app&#39;);<tr><td><a id="l158"></a><a href="#l158">158</a><td>    return executor;<tr><td><a id="l159"></a><a href="#l159">159</a><td>  }));<tr><td><a id="l160"></a><a href="#l160">160</a><td>}<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>/**<tr><td><a id="l164"></a><a href="#l164">164</a><td> * Creates {@link selenium-webdriver/remote.DriverService} instances that manage<tr><td><a id="l165"></a><a href="#l165">165</a><td> * a [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/)<tr><td><a id="l166"></a><a href="#l166">166</a><td> * server in a child process.<tr><td><a id="l167"></a><a href="#l167">167</a><td> *<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @param {string=} opt_exe Path to the server executable to use. If omitted,<tr><td><a id="l169"></a><a href="#l169">169</a><td> *     the builder will attempt to locate the chromedriver on the current<tr><td><a id="l170"></a><a href="#l170">170</a><td> *     PATH.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @throws {Error} If provided executable does not exist, or the chromedriver<tr><td><a id="l172"></a><a href="#l172">172</a><td> *     cannot be found on the PATH.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @constructor<tr><td><a id="l174"></a><a href="#l174">174</a><td> */<tr><td><a id="l175"></a><a href="#l175">175</a><td>var ServiceBuilder = function(opt_exe) {<tr><td><a id="l176"></a><a href="#l176">176</a><td>  /** @private {string} */<tr><td><a id="l177"></a><a href="#l177">177</a><td>  this.exe_ = opt_exe || io.findInPath(CHROMEDRIVER_EXE, true);<tr><td><a id="l178"></a><a href="#l178">178</a><td>  if (!this.exe_) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>    throw Error(<tr><td><a id="l180"></a><a href="#l180">180</a><td>        &#39;The ChromeDriver could not be found on the current PATH. Please &#39; +<tr><td><a id="l181"></a><a href="#l181">181</a><td>        &#39;download the latest version of the ChromeDriver from &#39; +<tr><td><a id="l182"></a><a href="#l182">182</a><td>        &#39;http://chromedriver.storage.googleapis.com/index.html and ensure &#39; +<tr><td><a id="l183"></a><a href="#l183">183</a><td>        &#39;it can be found on your PATH.&#39;);<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>  if (!fs.existsSync(this.exe_)) {<tr><td><a id="l187"></a><a href="#l187">187</a><td>    throw Error(&#39;File does not exist: &#39; + this.exe_);<tr><td><a id="l188"></a><a href="#l188">188</a><td>  }<tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td>  /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l191"></a><a href="#l191">191</a><td>  this.args_ = [];<tr><td><a id="l192"></a><a href="#l192">192</a><td>  this.stdio_ = &#39;ignore&#39;;<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><tr><td><a id="l196"></a><a href="#l196">196</a><td>/** @private {string} */<tr><td><a id="l197"></a><a href="#l197">197</a><td>ServiceBuilder.prototype.path_ = null;<tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>/** @private {number} */<tr><td><a id="l200"></a><a href="#l200">200</a><td>ServiceBuilder.prototype.port_ = 0;<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>/** @private {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} */<tr><td><a id="l204"></a><a href="#l204">204</a><td>ServiceBuilder.prototype.stdio_ = &#39;ignore&#39;;<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td>/** @private {Object.&lt;string, string&gt;} */<tr><td><a id="l208"></a><a href="#l208">208</a><td>ServiceBuilder.prototype.env_ = null;<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Sets the port to start the ChromeDriver on.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @param {number} port The port to use, or 0 for any free port.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @throws {Error} If the port is invalid.<tr><td><a id="l216"></a><a href="#l216">216</a><td> */<tr><td><a id="l217"></a><a href="#l217">217</a><td>ServiceBuilder.prototype.usingPort = function(port) {<tr><td><a id="l218"></a><a href="#l218">218</a><td>  if (port &lt; 0) {<tr><td><a id="l219"></a><a href="#l219">219</a><td>    throw Error(&#39;port must be &gt;= 0: &#39; + port);<tr><td><a id="l220"></a><a href="#l220">220</a><td>  }<tr><td><a id="l221"></a><a href="#l221">221</a><td>  this.port_ = port;<tr><td><a id="l222"></a><a href="#l222">222</a><td>  return this;<tr><td><a id="l223"></a><a href="#l223">223</a><td>};<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>/**<tr><td><a id="l227"></a><a href="#l227">227</a><td> * Sets which port adb is listening to. _The ChromeDriver will connect to adb<tr><td><a id="l228"></a><a href="#l228">228</a><td> * if an {@linkplain Options#androidPackage Android session} is requested, but<tr><td><a id="l229"></a><a href="#l229">229</a><td> * adb **must** be started beforehand._<tr><td><a id="l230"></a><a href="#l230">230</a><td> *<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @param {number} port Which port adb is running on.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>ServiceBuilder.prototype.setAdbPort = function(port) {<tr><td><a id="l235"></a><a href="#l235">235</a><td>  this.args_.push(&#39;--adb-port=&#39; + port);<tr><td><a id="l236"></a><a href="#l236">236</a><td>  return this;<tr><td><a id="l237"></a><a href="#l237">237</a><td>};<tr><td><a id="l238"></a><a href="#l238">238</a><td><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> * Sets the path of the log file the driver should log to. If a log file is<tr><td><a id="l242"></a><a href="#l242">242</a><td> * not specified, the driver will log to stderr.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {string} path Path of the log file to use.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>ServiceBuilder.prototype.loggingTo = function(path) {<tr><td><a id="l247"></a><a href="#l247">247</a><td>  this.args_.push(&#39;--log-path=&#39; + path);<tr><td><a id="l248"></a><a href="#l248">248</a><td>  return this;<tr><td><a id="l249"></a><a href="#l249">249</a><td>};<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td>/**<tr><td><a id="l253"></a><a href="#l253">253</a><td> * Enables verbose logging.<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l255"></a><a href="#l255">255</a><td> */<tr><td><a id="l256"></a><a href="#l256">256</a><td>ServiceBuilder.prototype.enableVerboseLogging = function() {<tr><td><a id="l257"></a><a href="#l257">257</a><td>  this.args_.push(&#39;--verbose&#39;);<tr><td><a id="l258"></a><a href="#l258">258</a><td>  return this;<tr><td><a id="l259"></a><a href="#l259">259</a><td>};<tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td>/**<tr><td><a id="l263"></a><a href="#l263">263</a><td> * Sets the number of threads the driver should use to manage HTTP requests.<tr><td><a id="l264"></a><a href="#l264">264</a><td> * By default, the driver will use 4 threads.<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @param {number} n The number of threads to use.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l267"></a><a href="#l267">267</a><td> */<tr><td><a id="l268"></a><a href="#l268">268</a><td>ServiceBuilder.prototype.setNumHttpThreads = function(n) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>  this.args_.push(&#39;--http-threads=&#39; + n);<tr><td><a id="l270"></a><a href="#l270">270</a><td>  return this;<tr><td><a id="l271"></a><a href="#l271">271</a><td>};<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> * Sets the base path for WebDriver REST commands (e.g. &quot;/wd/hub&quot;).<tr><td><a id="l276"></a><a href="#l276">276</a><td> * By default, the driver will accept commands relative to &quot;/&quot;.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {string} path The base path to use.<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l279"></a><a href="#l279">279</a><td> */<tr><td><a id="l280"></a><a href="#l280">280</a><td>ServiceBuilder.prototype.setUrlBasePath = function(path) {<tr><td><a id="l281"></a><a href="#l281">281</a><td>  this.args_.push(&#39;--url-base=&#39; + path);<tr><td><a id="l282"></a><a href="#l282">282</a><td>  this.path_ = path;<tr><td><a id="l283"></a><a href="#l283">283</a><td>  return this;<tr><td><a id="l284"></a><a href="#l284">284</a><td>};<tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td><tr><td><a id="l287"></a><a href="#l287">287</a><td>/**<tr><td><a id="l288"></a><a href="#l288">288</a><td> * Defines the stdio configuration for the driver service. See<tr><td><a id="l289"></a><a href="#l289">289</a><td> * {@code child_process.spawn} for more information.<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @param {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} config The<tr><td><a id="l291"></a><a href="#l291">291</a><td> *     configuration to use.<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l293"></a><a href="#l293">293</a><td> */<tr><td><a id="l294"></a><a href="#l294">294</a><td>ServiceBuilder.prototype.setStdio = function(config) {<tr><td><a id="l295"></a><a href="#l295">295</a><td>  this.stdio_ = config;<tr><td><a id="l296"></a><a href="#l296">296</a><td>  return this;<tr><td><a id="l297"></a><a href="#l297">297</a><td>};<tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>/**<tr><td><a id="l301"></a><a href="#l301">301</a><td> * Defines the environment to start the server under. This settings will be<tr><td><a id="l302"></a><a href="#l302">302</a><td> * inherited by every browser session started by the server.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @param {!Object.&lt;string, string&gt;} env The environment to use.<tr><td><a id="l304"></a><a href="#l304">304</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l305"></a><a href="#l305">305</a><td> */<tr><td><a id="l306"></a><a href="#l306">306</a><td>ServiceBuilder.prototype.withEnvironment = function(env) {<tr><td><a id="l307"></a><a href="#l307">307</a><td>  this.env_ = env;<tr><td><a id="l308"></a><a href="#l308">308</a><td>  return this;<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><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Creates a new DriverService using this instance&#39;s current configuration.<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @return {remote.DriverService} A new driver service using this instance&#39;s<tr><td><a id="l315"></a><a href="#l315">315</a><td> *     current configuration.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @throws {Error} If the driver exectuable was not specified and a default<tr><td><a id="l317"></a><a href="#l317">317</a><td> *     could not be found on the current PATH.<tr><td><a id="l318"></a><a href="#l318">318</a><td> */<tr><td><a id="l319"></a><a href="#l319">319</a><td>ServiceBuilder.prototype.build = function() {<tr><td><a id="l320"></a><a href="#l320">320</a><td>  var port = this.port_ || portprober.findFreePort();<tr><td><a id="l321"></a><a href="#l321">321</a><td>  var args = this.args_.concat();  // Defensive copy.<tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td>  return new remote.DriverService(this.exe_, {<tr><td><a id="l324"></a><a href="#l324">324</a><td>    loopback: true,<tr><td><a id="l325"></a><a href="#l325">325</a><td>    path: this.path_,<tr><td><a id="l326"></a><a href="#l326">326</a><td>    port: port,<tr><td><a id="l327"></a><a href="#l327">327</a><td>    args: webdriver.promise.when(port, function(port) {<tr><td><a id="l328"></a><a href="#l328">328</a><td>      return args.concat(&#39;--port=&#39; + port);<tr><td><a id="l329"></a><a href="#l329">329</a><td>    }),<tr><td><a id="l330"></a><a href="#l330">330</a><td>    env: this.env_,<tr><td><a id="l331"></a><a href="#l331">331</a><td>    stdio: this.stdio_<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><tr><td><a id="l335"></a><a href="#l335">335</a><td><tr><td><a id="l336"></a><a href="#l336">336</a><td>/** @type {remote.DriverService} */<tr><td><a id="l337"></a><a href="#l337">337</a><td>var defaultService = null;<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Sets the default service to use for new ChromeDriver instances.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {!remote.DriverService} service The service to use.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @throws {Error} If the default service is currently running.<tr><td><a id="l344"></a><a href="#l344">344</a><td> */<tr><td><a id="l345"></a><a href="#l345">345</a><td>function setDefaultService(service) {<tr><td><a id="l346"></a><a href="#l346">346</a><td>  if (defaultService &amp;&amp; defaultService.isRunning()) {<tr><td><a id="l347"></a><a href="#l347">347</a><td>    throw Error(<tr><td><a id="l348"></a><a href="#l348">348</a><td>        &#39;The previously configured ChromeDriver service is still running. &#39; +<tr><td><a id="l349"></a><a href="#l349">349</a><td>        &#39;You must shut it down before you may adjust its configuration.&#39;);<tr><td><a id="l350"></a><a href="#l350">350</a><td>  }<tr><td><a id="l351"></a><a href="#l351">351</a><td>  defaultService = service;<tr><td><a id="l352"></a><a href="#l352">352</a><td>}<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td><tr><td><a id="l355"></a><a href="#l355">355</a><td>/**<tr><td><a id="l356"></a><a href="#l356">356</a><td> * Returns the default ChromeDriver service. If such a service has not been<tr><td><a id="l357"></a><a href="#l357">357</a><td> * configured, one will be constructed using the default configuration for<tr><td><a id="l358"></a><a href="#l358">358</a><td> * a ChromeDriver executable found on the system PATH.<tr><td><a id="l359"></a><a href="#l359">359</a><td> * @return {!remote.DriverService} The default ChromeDriver service.<tr><td><a id="l360"></a><a href="#l360">360</a><td> */<tr><td><a id="l361"></a><a href="#l361">361</a><td>function getDefaultService() {<tr><td><a id="l362"></a><a href="#l362">362</a><td>  if (!defaultService) {<tr><td><a id="l363"></a><a href="#l363">363</a><td>    defaultService = new ServiceBuilder().build();<tr><td><a id="l364"></a><a href="#l364">364</a><td>  }<tr><td><a id="l365"></a><a href="#l365">365</a><td>  return defaultService;<tr><td><a id="l366"></a><a href="#l366">366</a><td>}<tr><td><a id="l367"></a><a href="#l367">367</a><td><tr><td><a id="l368"></a><a href="#l368">368</a><td><tr><td><a id="l369"></a><a href="#l369">369</a><td>/**<tr><td><a id="l370"></a><a href="#l370">370</a><td> * @type {string}<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @const<tr><td><a id="l372"></a><a href="#l372">372</a><td> */<tr><td><a id="l373"></a><a href="#l373">373</a><td>var OPTIONS_CAPABILITY_KEY = &#39;chromeOptions&#39;;<tr><td><a id="l374"></a><a href="#l374">374</a><td><tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td>/**<tr><td><a id="l377"></a><a href="#l377">377</a><td> * Class for managing ChromeDriver specific options.<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @constructor<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @extends {webdriver.Serializable}<tr><td><a id="l380"></a><a href="#l380">380</a><td> */<tr><td><a id="l381"></a><a href="#l381">381</a><td>var Options = function() {<tr><td><a id="l382"></a><a href="#l382">382</a><td>  webdriver.Serializable.call(this);<tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td>  /** @private {!Object} */<tr><td><a id="l385"></a><a href="#l385">385</a><td>  this.options_ = {};<tr><td><a id="l386"></a><a href="#l386">386</a><td><tr><td><a id="l387"></a><a href="#l387">387</a><td>  /** @private {!Array.&lt;(string|!Buffer)&gt;} */<tr><td><a id="l388"></a><a href="#l388">388</a><td>  this.extensions_ = [];<tr><td><a id="l389"></a><a href="#l389">389</a><td><tr><td><a id="l390"></a><a href="#l390">390</a><td>  /** @private {?webdriver.logging.Preferences} */<tr><td><a id="l391"></a><a href="#l391">391</a><td>  this.logPrefs_ = null;<tr><td><a id="l392"></a><a href="#l392">392</a><td><tr><td><a id="l393"></a><a href="#l393">393</a><td>  /** @private {?webdriver.ProxyConfig} */<tr><td><a id="l394"></a><a href="#l394">394</a><td>  this.proxy_ = null;<tr><td><a id="l395"></a><a href="#l395">395</a><td>};<tr><td><a id="l396"></a><a href="#l396">396</a><td>util.inherits(Options, webdriver.Serializable);<tr><td><a id="l397"></a><a href="#l397">397</a><td><tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td>/**<tr><td><a id="l400"></a><a href="#l400">400</a><td> * Extracts the ChromeDriver specific options from the given capabilities<tr><td><a id="l401"></a><a href="#l401">401</a><td> * object.<tr><td><a id="l402"></a><a href="#l402">402</a><td> * @param {!webdriver.Capabilities} capabilities The capabilities object.<tr><td><a id="l403"></a><a href="#l403">403</a><td> * @return {!Options} The ChromeDriver options.<tr><td><a id="l404"></a><a href="#l404">404</a><td> */<tr><td><a id="l405"></a><a href="#l405">405</a><td>Options.fromCapabilities = function(capabilities) {<tr><td><a id="l406"></a><a href="#l406">406</a><td>  var options = new Options();<tr><td><a id="l407"></a><a href="#l407">407</a><td><tr><td><a id="l408"></a><a href="#l408">408</a><td>  var o = capabilities.get(OPTIONS_CAPABILITY_KEY);<tr><td><a id="l409"></a><a href="#l409">409</a><td>  if (o instanceof Options) {<tr><td><a id="l410"></a><a href="#l410">410</a><td>    options = o;<tr><td><a id="l411"></a><a href="#l411">411</a><td>  } else if (o) {<tr><td><a id="l412"></a><a href="#l412">412</a><td>    options.<tr><td><a id="l413"></a><a href="#l413">413</a><td>        addArguments(o.args || []).<tr><td><a id="l414"></a><a href="#l414">414</a><td>        addExtensions(o.extensions || []).<tr><td><a id="l415"></a><a href="#l415">415</a><td>        detachDriver(o.detach).<tr><td><a id="l416"></a><a href="#l416">416</a><td>        excludeSwitches(o.excludeSwitches || []).<tr><td><a id="l417"></a><a href="#l417">417</a><td>        setChromeBinaryPath(o.binary).<tr><td><a id="l418"></a><a href="#l418">418</a><td>        setChromeLogFile(o.logPath).<tr><td><a id="l419"></a><a href="#l419">419</a><td>        setChromeMinidumpPath(o.minidumpPath).<tr><td><a id="l420"></a><a href="#l420">420</a><td>        setLocalState(o.localState).<tr><td><a id="l421"></a><a href="#l421">421</a><td>        setMobileEmulation(o.mobileEmulation).<tr><td><a id="l422"></a><a href="#l422">422</a><td>        setUserPreferences(o.prefs).<tr><td><a id="l423"></a><a href="#l423">423</a><td>        setPerfLoggingPrefs(o.perfLoggingPrefs);<tr><td><a id="l424"></a><a href="#l424">424</a><td>  }<tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td>  if (capabilities.has(webdriver.Capability.PROXY)) {<tr><td><a id="l427"></a><a href="#l427">427</a><td>    options.setProxy(capabilities.get(webdriver.Capability.PROXY));<tr><td><a id="l428"></a><a href="#l428">428</a><td>  }<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td>  if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {<tr><td><a id="l431"></a><a href="#l431">431</a><td>    options.setLoggingPrefs(<tr><td><a id="l432"></a><a href="#l432">432</a><td>        capabilities.get(webdriver.Capability.LOGGING_PREFS));<tr><td><a id="l433"></a><a href="#l433">433</a><td>  }<tr><td><a id="l434"></a><a href="#l434">434</a><td><tr><td><a id="l435"></a><a href="#l435">435</a><td>  return options;<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><tr><td><a id="l439"></a><a href="#l439">439</a><td>/**<tr><td><a id="l440"></a><a href="#l440">440</a><td> * Add additional command line arguments to use when launching the Chrome<tr><td><a id="l441"></a><a href="#l441">441</a><td> * browser.  Each argument may be specified with or without the &quot;--&quot; prefix<tr><td><a id="l442"></a><a href="#l442">442</a><td> * (e.g. &quot;--foo&quot; and &quot;foo&quot;). Arguments with an associated value should be<tr><td><a id="l443"></a><a href="#l443">443</a><td> * delimited by an &quot;=&quot;: &quot;foo=bar&quot;.<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @param {...(string|!Array.&lt;string&gt;)} var_args The arguments to add.<tr><td><a id="l445"></a><a href="#l445">445</a><td> * @return {!Options} A self reference.<tr><td><a id="l446"></a><a href="#l446">446</a><td> */<tr><td><a id="l447"></a><a href="#l447">447</a><td>Options.prototype.addArguments = function(var_args) {<tr><td><a id="l448"></a><a href="#l448">448</a><td>  var args = this.options_.args || [];<tr><td><a id="l449"></a><a href="#l449">449</a><td>  args = args.concat.apply(args, arguments);<tr><td><a id="l450"></a><a href="#l450">450</a><td>  if (args.length) {<tr><td><a id="l451"></a><a href="#l451">451</a><td>    this.options_.args = args;<tr><td><a id="l452"></a><a href="#l452">452</a><td>  }<tr><td><a id="l453"></a><a href="#l453">453</a><td>  return this;<tr><td><a id="l454"></a><a href="#l454">454</a><td>};<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td><tr><td><a id="l457"></a><a href="#l457">457</a><td>/**<tr><td><a id="l458"></a><a href="#l458">458</a><td> * List of Chrome command line switches to exclude that ChromeDriver by default<tr><td><a id="l459"></a><a href="#l459">459</a><td> * passes when starting Chrome.  Do not prefix switches with &quot;--&quot;.<tr><td><a id="l460"></a><a href="#l460">460</a><td> *<tr><td><a id="l461"></a><a href="#l461">461</a><td> * @param {...(string|!Array&lt;string&gt;)} var_args The switches to exclude.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @return {!Options} A self reference.<tr><td><a id="l463"></a><a href="#l463">463</a><td> */<tr><td><a id="l464"></a><a href="#l464">464</a><td>Options.prototype.excludeSwitches = function(var_args) {<tr><td><a id="l465"></a><a href="#l465">465</a><td>  var switches = this.options_.excludeSwitches || [];<tr><td><a id="l466"></a><a href="#l466">466</a><td>  switches = switches.concat.apply(switches, arguments);<tr><td><a id="l467"></a><a href="#l467">467</a><td>  if (switches.length) {<tr><td><a id="l468"></a><a href="#l468">468</a><td>    this.options_.excludeSwitches = switches;<tr><td><a id="l469"></a><a href="#l469">469</a><td>  }<tr><td><a id="l470"></a><a href="#l470">470</a><td>  return this;<tr><td><a id="l471"></a><a href="#l471">471</a><td>};<tr><td><a id="l472"></a><a href="#l472">472</a><td><tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td>/**<tr><td><a id="l475"></a><a href="#l475">475</a><td> * Add additional extensions to install when launching Chrome. Each extension<tr><td><a id="l476"></a><a href="#l476">476</a><td> * should be specified as the path to the packed CRX file, or a Buffer for an<tr><td><a id="l477"></a><a href="#l477">477</a><td> * extension.<tr><td><a id="l478"></a><a href="#l478">478</a><td> * @param {...(string|!Buffer|!Array.&lt;(string|!Buffer)&gt;)} var_args The<tr><td><a id="l479"></a><a href="#l479">479</a><td> *     extensions to add.<tr><td><a id="l480"></a><a href="#l480">480</a><td> * @return {!Options} A self reference.<tr><td><a id="l481"></a><a href="#l481">481</a><td> */<tr><td><a id="l482"></a><a href="#l482">482</a><td>Options.prototype.addExtensions = function(var_args) {<tr><td><a id="l483"></a><a href="#l483">483</a><td>  this.extensions_ = this.extensions_.concat.apply(this.extensions_, arguments);<tr><td><a id="l484"></a><a href="#l484">484</a><td>  return this;<tr><td><a id="l485"></a><a href="#l485">485</a><td>};<tr><td><a id="l486"></a><a href="#l486">486</a><td><tr><td><a id="l487"></a><a href="#l487">487</a><td><tr><td><a id="l488"></a><a href="#l488">488</a><td>/**<tr><td><a id="l489"></a><a href="#l489">489</a><td> * Sets the path to the Chrome binary to use. On Mac OS X, this path should<tr><td><a id="l490"></a><a href="#l490">490</a><td> * reference the actual Chrome executable, not just the application binary<tr><td><a id="l491"></a><a href="#l491">491</a><td> * (e.g. &quot;/Applications/Google Chrome.app/Contents/MacOS/Google Chrome&quot;).<tr><td><a id="l492"></a><a href="#l492">492</a><td> *<tr><td><a id="l493"></a><a href="#l493">493</a><td> * The binary path be absolute or relative to the chromedriver server<tr><td><a id="l494"></a><a href="#l494">494</a><td> * executable, but it must exist on the machine that will launch Chrome.<tr><td><a id="l495"></a><a href="#l495">495</a><td> *<tr><td><a id="l496"></a><a href="#l496">496</a><td> * @param {string} path The path to the Chrome binary to use.<tr><td><a id="l497"></a><a href="#l497">497</a><td> * @return {!Options} A self reference.<tr><td><a id="l498"></a><a href="#l498">498</a><td> */<tr><td><a id="l499"></a><a href="#l499">499</a><td>Options.prototype.setChromeBinaryPath = function(path) {<tr><td><a id="l500"></a><a href="#l500">500</a><td>  this.options_.binary = path;<tr><td><a id="l501"></a><a href="#l501">501</a><td>  return this;<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> * Sets whether to leave the started Chrome browser running if the controlling<tr><td><a id="l507"></a><a href="#l507">507</a><td> * ChromeDriver service is killed before {@link webdriver.WebDriver#quit()} is<tr><td><a id="l508"></a><a href="#l508">508</a><td> * called.<tr><td><a id="l509"></a><a href="#l509">509</a><td> * @param {boolean} detach Whether to leave the browser running if the<tr><td><a id="l510"></a><a href="#l510">510</a><td> *     chromedriver service is killed before the session.<tr><td><a id="l511"></a><a href="#l511">511</a><td> * @return {!Options} A self reference.<tr><td><a id="l512"></a><a href="#l512">512</a><td> */<tr><td><a id="l513"></a><a href="#l513">513</a><td>Options.prototype.detachDriver = function(detach) {<tr><td><a id="l514"></a><a href="#l514">514</a><td>  this.options_.detach = detach;<tr><td><a id="l515"></a><a href="#l515">515</a><td>  return this;<tr><td><a id="l516"></a><a href="#l516">516</a><td>};<tr><td><a id="l517"></a><a href="#l517">517</a><td><tr><td><a id="l518"></a><a href="#l518">518</a><td><tr><td><a id="l519"></a><a href="#l519">519</a><td>/**<tr><td><a id="l520"></a><a href="#l520">520</a><td> * Sets the user preferences for Chrome&#39;s user profile. See the &quot;Preferences&quot;<tr><td><a id="l521"></a><a href="#l521">521</a><td> * file in Chrome&#39;s user data directory for examples.<tr><td><a id="l522"></a><a href="#l522">522</a><td> * @param {!Object} prefs Dictionary of user preferences to use.<tr><td><a id="l523"></a><a href="#l523">523</a><td> * @return {!Options} A self reference.<tr><td><a id="l524"></a><a href="#l524">524</a><td> */<tr><td><a id="l525"></a><a href="#l525">525</a><td>Options.prototype.setUserPreferences = function(prefs) {<tr><td><a id="l526"></a><a href="#l526">526</a><td>  this.options_.prefs = prefs;<tr><td><a id="l527"></a><a href="#l527">527</a><td>  return this;<tr><td><a id="l528"></a><a href="#l528">528</a><td>};<tr><td><a id="l529"></a><a href="#l529">529</a><td><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> * Sets the logging preferences for the new session.<tr><td><a id="l533"></a><a href="#l533">533</a><td> * @param {!webdriver.logging.Preferences} prefs The logging preferences.<tr><td><a id="l534"></a><a href="#l534">534</a><td> * @return {!Options} A self reference.<tr><td><a id="l535"></a><a href="#l535">535</a><td> */<tr><td><a id="l536"></a><a href="#l536">536</a><td>Options.prototype.setLoggingPrefs = function(prefs) {<tr><td><a id="l537"></a><a href="#l537">537</a><td>  this.logPrefs_ = prefs;<tr><td><a id="l538"></a><a href="#l538">538</a><td>  return this;<tr><td><a id="l539"></a><a href="#l539">539</a><td>};<tr><td><a id="l540"></a><a href="#l540">540</a><td><tr><td><a id="l541"></a><a href="#l541">541</a><td><tr><td><a id="l542"></a><a href="#l542">542</a><td>/**<tr><td><a id="l543"></a><a href="#l543">543</a><td> * Sets the performance logging preferences. Options include:<tr><td><a id="l544"></a><a href="#l544">544</a><td> *<tr><td><a id="l545"></a><a href="#l545">545</a><td> * - `enableNetwork`: Whether or not to collect events from Network domain.<tr><td><a id="l546"></a><a href="#l546">546</a><td> * - `enablePage`: Whether or not to collect events from Page domain.<tr><td><a id="l547"></a><a href="#l547">547</a><td> * - `enableTimeline`: Whether or not to collect events from Timeline domain.<tr><td><a id="l548"></a><a href="#l548">548</a><td> *     Note: when tracing is enabled, Timeline domain is implicitly disabled,<tr><td><a id="l549"></a><a href="#l549">549</a><td> *     unless `enableTimeline` is explicitly set to true.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * - `tracingCategories`: A comma-separated string of Chrome tracing categories<tr><td><a id="l551"></a><a href="#l551">551</a><td> *     for which trace events should be collected. An unspecified or empty<tr><td><a id="l552"></a><a href="#l552">552</a><td> *     string disables tracing.<tr><td><a id="l553"></a><a href="#l553">553</a><td> * - `bufferUsageReportingInterval`: The requested number of milliseconds<tr><td><a id="l554"></a><a href="#l554">554</a><td> *     between DevTools trace buffer usage events. For example, if 1000, then<tr><td><a id="l555"></a><a href="#l555">555</a><td> *     once per second, DevTools will report how full the trace buffer is. If a<tr><td><a id="l556"></a><a href="#l556">556</a><td> *     report indicates the buffer usage is 100%, a warning will be issued.<tr><td><a id="l557"></a><a href="#l557">557</a><td> *<tr><td><a id="l558"></a><a href="#l558">558</a><td> * @param {{enableNetwork: boolean,<tr><td><a id="l559"></a><a href="#l559">559</a><td> *          enablePage: boolean,<tr><td><a id="l560"></a><a href="#l560">560</a><td> *          enableTimeline: boolean,<tr><td><a id="l561"></a><a href="#l561">561</a><td> *          tracingCategories: string,<tr><td><a id="l562"></a><a href="#l562">562</a><td> *          bufferUsageReportingInterval: number}} prefs The performance<tr><td><a id="l563"></a><a href="#l563">563</a><td> *     logging preferences.<tr><td><a id="l564"></a><a href="#l564">564</a><td> * @return {!Options} A self reference.<tr><td><a id="l565"></a><a href="#l565">565</a><td> */<tr><td><a id="l566"></a><a href="#l566">566</a><td>Options.prototype.setPerfLoggingPrefs = function(prefs) {<tr><td><a id="l567"></a><a href="#l567">567</a><td>  this.options_.perfLoggingPrefs = prefs;<tr><td><a id="l568"></a><a href="#l568">568</a><td>  return this;<tr><td><a id="l569"></a><a href="#l569">569</a><td>};<tr><td><a id="l570"></a><a href="#l570">570</a><td><tr><td><a id="l571"></a><a href="#l571">571</a><td><tr><td><a id="l572"></a><a href="#l572">572</a><td>/**<tr><td><a id="l573"></a><a href="#l573">573</a><td> * Sets preferences for the &quot;Local State&quot; file in Chrome&#39;s user data<tr><td><a id="l574"></a><a href="#l574">574</a><td> * directory.<tr><td><a id="l575"></a><a href="#l575">575</a><td> * @param {!Object} state Dictionary of local state preferences.<tr><td><a id="l576"></a><a href="#l576">576</a><td> * @return {!Options} A self reference.<tr><td><a id="l577"></a><a href="#l577">577</a><td> */<tr><td><a id="l578"></a><a href="#l578">578</a><td>Options.prototype.setLocalState = function(state) {<tr><td><a id="l579"></a><a href="#l579">579</a><td>  this.options_.localState = state;<tr><td><a id="l580"></a><a href="#l580">580</a><td>  return this;<tr><td><a id="l581"></a><a href="#l581">581</a><td>};<tr><td><a id="l582"></a><a href="#l582">582</a><td><tr><td><a id="l583"></a><a href="#l583">583</a><td><tr><td><a id="l584"></a><a href="#l584">584</a><td>/**<tr><td><a id="l585"></a><a href="#l585">585</a><td> * Sets the name of the activity hosting a Chrome-based Android WebView. This<tr><td><a id="l586"></a><a href="#l586">586</a><td> * option must be set to connect to an [Android WebView](<tr><td><a id="l587"></a><a href="#l587">587</a><td> * https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android)<tr><td><a id="l588"></a><a href="#l588">588</a><td> *<tr><td><a id="l589"></a><a href="#l589">589</a><td> * @param {string} name The activity name.<tr><td><a id="l590"></a><a href="#l590">590</a><td> * @return {!Options} A self reference.<tr><td><a id="l591"></a><a href="#l591">591</a><td> */<tr><td><a id="l592"></a><a href="#l592">592</a><td>Options.prototype.androidActivity = function(name) {<tr><td><a id="l593"></a><a href="#l593">593</a><td>  this.options_.androidActivity = name;<tr><td><a id="l594"></a><a href="#l594">594</a><td>  return this;<tr><td><a id="l595"></a><a href="#l595">595</a><td>};<tr><td><a id="l596"></a><a href="#l596">596</a><td><tr><td><a id="l597"></a><a href="#l597">597</a><td><tr><td><a id="l598"></a><a href="#l598">598</a><td>/**<tr><td><a id="l599"></a><a href="#l599">599</a><td> * Sets the device serial number to connect to via ADB. If not specified, the<tr><td><a id="l600"></a><a href="#l600">600</a><td> * ChromeDriver will select an unused device at random. An error will be<tr><td><a id="l601"></a><a href="#l601">601</a><td> * returned if all devices already have active sessions.<tr><td><a id="l602"></a><a href="#l602">602</a><td> *<tr><td><a id="l603"></a><a href="#l603">603</a><td> * @param {string} serial The device serial number to connect to.<tr><td><a id="l604"></a><a href="#l604">604</a><td> * @return {!Options} A self reference.<tr><td><a id="l605"></a><a href="#l605">605</a><td> */<tr><td><a id="l606"></a><a href="#l606">606</a><td>Options.prototype.androidDeviceSerial = function(serial) {<tr><td><a id="l607"></a><a href="#l607">607</a><td>  this.options_.androidDeviceSerial = serial;<tr><td><a id="l608"></a><a href="#l608">608</a><td>  return this;<tr><td><a id="l609"></a><a href="#l609">609</a><td>};<tr><td><a id="l610"></a><a href="#l610">610</a><td><tr><td><a id="l611"></a><a href="#l611">611</a><td><tr><td><a id="l612"></a><a href="#l612">612</a><td>/**<tr><td><a id="l613"></a><a href="#l613">613</a><td> * Configures the ChromeDriver to launch Chrome on Android via adb. This<tr><td><a id="l614"></a><a href="#l614">614</a><td> * function is shorthand for<tr><td><a id="l615"></a><a href="#l615">615</a><td> * {@link #androidPackage options.androidPackage(&#39;com.android.chrome&#39;)}.<tr><td><a id="l616"></a><a href="#l616">616</a><td> * @return {!Options} A self reference.<tr><td><a id="l617"></a><a href="#l617">617</a><td> */<tr><td><a id="l618"></a><a href="#l618">618</a><td>Options.prototype.androidChrome = function() {<tr><td><a id="l619"></a><a href="#l619">619</a><td>  return this.androidPackage(&#39;com.android.chrome&#39;);<tr><td><a id="l620"></a><a href="#l620">620</a><td>};<tr><td><a id="l621"></a><a href="#l621">621</a><td><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> * Sets the package name of the Chrome or WebView app.<tr><td><a id="l625"></a><a href="#l625">625</a><td> *<tr><td><a id="l626"></a><a href="#l626">626</a><td> * @param {?string} pkg The package to connect to, or `null` to disable Android<tr><td><a id="l627"></a><a href="#l627">627</a><td> *     and switch back to using desktop Chrome.<tr><td><a id="l628"></a><a href="#l628">628</a><td> * @return {!Options} A self reference.<tr><td><a id="l629"></a><a href="#l629">629</a><td> */<tr><td><a id="l630"></a><a href="#l630">630</a><td>Options.prototype.androidPackage = function(pkg) {<tr><td><a id="l631"></a><a href="#l631">631</a><td>  this.options_.androidPackage = pkg;<tr><td><a id="l632"></a><a href="#l632">632</a><td>  return this;<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> * Sets the process name of the Activity hosting the WebView (as given by `ps`).<tr><td><a id="l638"></a><a href="#l638">638</a><td> * If not specified, the process name is assumed to be the same as<tr><td><a id="l639"></a><a href="#l639">639</a><td> * {@link #androidPackage}.<tr><td><a id="l640"></a><a href="#l640">640</a><td> *<tr><td><a id="l641"></a><a href="#l641">641</a><td> * @param {string} processName The main activity name.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @return {!Options} A self reference.<tr><td><a id="l643"></a><a href="#l643">643</a><td> */<tr><td><a id="l644"></a><a href="#l644">644</a><td>Options.prototype.androidProcess = function(processName) {<tr><td><a id="l645"></a><a href="#l645">645</a><td>  this.options_.androidProcess = processName;<tr><td><a id="l646"></a><a href="#l646">646</a><td>  return this;<tr><td><a id="l647"></a><a href="#l647">647</a><td>};<tr><td><a id="l648"></a><a href="#l648">648</a><td><tr><td><a id="l649"></a><a href="#l649">649</a><td><tr><td><a id="l650"></a><a href="#l650">650</a><td>/**<tr><td><a id="l651"></a><a href="#l651">651</a><td> * Sets whether to connect to an already-running instead of the specified<tr><td><a id="l652"></a><a href="#l652">652</a><td> * {@linkplain #androidProcess app} instead of launching the app with a clean<tr><td><a id="l653"></a><a href="#l653">653</a><td> * data directory.<tr><td><a id="l654"></a><a href="#l654">654</a><td> *<tr><td><a id="l655"></a><a href="#l655">655</a><td> * @param {boolean} useRunning Whether to connect to a running instance.<tr><td><a id="l656"></a><a href="#l656">656</a><td> * @return {!Options} A self reference.<tr><td><a id="l657"></a><a href="#l657">657</a><td> */<tr><td><a id="l658"></a><a href="#l658">658</a><td>Options.prototype.androidUseRunningApp = function(useRunning) {<tr><td><a id="l659"></a><a href="#l659">659</a><td>  this.options_.androidUseRunningApp = useRunning;<tr><td><a id="l660"></a><a href="#l660">660</a><td>  return this;<tr><td><a id="l661"></a><a href="#l661">661</a><td>};<tr><td><a id="l662"></a><a href="#l662">662</a><td><tr><td><a id="l663"></a><a href="#l663">663</a><td><tr><td><a id="l664"></a><a href="#l664">664</a><td>/**<tr><td><a id="l665"></a><a href="#l665">665</a><td> * Sets the path to Chrome&#39;s log file. This path should exist on the machine<tr><td><a id="l666"></a><a href="#l666">666</a><td> * that will launch Chrome.<tr><td><a id="l667"></a><a href="#l667">667</a><td> * @param {string} path Path to the log file to use.<tr><td><a id="l668"></a><a href="#l668">668</a><td> * @return {!Options} A self reference.<tr><td><a id="l669"></a><a href="#l669">669</a><td> */<tr><td><a id="l670"></a><a href="#l670">670</a><td>Options.prototype.setChromeLogFile = function(path) {<tr><td><a id="l671"></a><a href="#l671">671</a><td>  this.options_.logPath = path;<tr><td><a id="l672"></a><a href="#l672">672</a><td>  return this;<tr><td><a id="l673"></a><a href="#l673">673</a><td>};<tr><td><a id="l674"></a><a href="#l674">674</a><td><tr><td><a id="l675"></a><a href="#l675">675</a><td><tr><td><a id="l676"></a><a href="#l676">676</a><td>/**<tr><td><a id="l677"></a><a href="#l677">677</a><td> * Sets the directory to store Chrome minidumps in. This option is only<tr><td><a id="l678"></a><a href="#l678">678</a><td> * supported when ChromeDriver is running on Linux.<tr><td><a id="l679"></a><a href="#l679">679</a><td> * @param {string} path The directory path.<tr><td><a id="l680"></a><a href="#l680">680</a><td> * @return {!Options} A self reference.<tr><td><a id="l681"></a><a href="#l681">681</a><td> */<tr><td><a id="l682"></a><a href="#l682">682</a><td>Options.prototype.setChromeMinidumpPath = function(path) {<tr><td><a id="l683"></a><a href="#l683">683</a><td>  this.options_.minidumpPath = path;<tr><td><a id="l684"></a><a href="#l684">684</a><td>  return this;<tr><td><a id="l685"></a><a href="#l685">685</a><td>};<tr><td><a id="l686"></a><a href="#l686">686</a><td><tr><td><a id="l687"></a><a href="#l687">687</a><td><tr><td><a id="l688"></a><a href="#l688">688</a><td>/**<tr><td><a id="l689"></a><a href="#l689">689</a><td> * Configures Chrome to emulate a mobile device. For more information, refer to<tr><td><a id="l690"></a><a href="#l690">690</a><td> * the ChromeDriver project page on [mobile emulation][em]. Configuration<tr><td><a id="l691"></a><a href="#l691">691</a><td> * options include:<tr><td><a id="l692"></a><a href="#l692">692</a><td> *<tr><td><a id="l693"></a><a href="#l693">693</a><td> * - `deviceName`: The name of a pre-configured [emulated device][devem]<tr><td><a id="l694"></a><a href="#l694">694</a><td> * - `width`: screen width, in pixels<tr><td><a id="l695"></a><a href="#l695">695</a><td> * - `height`: screen height, in pixels<tr><td><a id="l696"></a><a href="#l696">696</a><td> * - `pixelRatio`: screen pixel ratio<tr><td><a id="l697"></a><a href="#l697">697</a><td> *<tr><td><a id="l698"></a><a href="#l698">698</a><td> * __Example 1: Using a Pre-configured Device__<tr><td><a id="l699"></a><a href="#l699">699</a><td> *<tr><td><a id="l700"></a><a href="#l700">700</a><td> *     var options = new chrome.Options().setMobileEmulation(<tr><td><a id="l701"></a><a href="#l701">701</a><td> *         {deviceName: &#39;Google Nexus 5&#39;});<tr><td><a id="l702"></a><a href="#l702">702</a><td> *<tr><td><a id="l703"></a><a href="#l703">703</a><td> *     var driver = new chrome.Driver(options);<tr><td><a id="l704"></a><a href="#l704">704</a><td> *<tr><td><a id="l705"></a><a href="#l705">705</a><td> * __Example 2: Using Custom Screen Configuration__<tr><td><a id="l706"></a><a href="#l706">706</a><td> *<tr><td><a id="l707"></a><a href="#l707">707</a><td> *     var options = new chrome.Options().setMobileEmulation({<tr><td><a id="l708"></a><a href="#l708">708</a><td> *         width: 360,<tr><td><a id="l709"></a><a href="#l709">709</a><td> *         height: 640,<tr><td><a id="l710"></a><a href="#l710">710</a><td> *         pixelRatio: 3.0<tr><td><a id="l711"></a><a href="#l711">711</a><td> *     });<tr><td><a id="l712"></a><a href="#l712">712</a><td> *<tr><td><a id="l713"></a><a href="#l713">713</a><td> *     var driver = new chrome.Driver(options);<tr><td><a id="l714"></a><a href="#l714">714</a><td> *<tr><td><a id="l715"></a><a href="#l715">715</a><td> *<tr><td><a id="l716"></a><a href="#l716">716</a><td> * [em]: https://sites.google.com/a/chromium.org/chromedriver/mobile-emulation<tr><td><a id="l717"></a><a href="#l717">717</a><td> * [devem]: https://developer.chrome.com/devtools/docs/device-mode<tr><td><a id="l718"></a><a href="#l718">718</a><td> *<tr><td><a id="l719"></a><a href="#l719">719</a><td> * @param {?({deviceName: string}|<tr><td><a id="l720"></a><a href="#l720">720</a><td> *           {width: number, height: number, pixelRatio: number})} config The<tr><td><a id="l721"></a><a href="#l721">721</a><td> *     mobile emulation configuration, or `null` to disable emulation.<tr><td><a id="l722"></a><a href="#l722">722</a><td> * @return {!Options} A self reference.<tr><td><a id="l723"></a><a href="#l723">723</a><td> */<tr><td><a id="l724"></a><a href="#l724">724</a><td>Options.prototype.setMobileEmulation = function(config) {<tr><td><a id="l725"></a><a href="#l725">725</a><td>  this.options_.mobileEmulation = config;<tr><td><a id="l726"></a><a href="#l726">726</a><td>  return this;<tr><td><a id="l727"></a><a href="#l727">727</a><td>};<tr><td><a id="l728"></a><a href="#l728">728</a><td><tr><td><a id="l729"></a><a href="#l729">729</a><td><tr><td><a id="l730"></a><a href="#l730">730</a><td>/**<tr><td><a id="l731"></a><a href="#l731">731</a><td> * Sets the proxy settings for the new session.<tr><td><a id="l732"></a><a href="#l732">732</a><td> * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.<tr><td><a id="l733"></a><a href="#l733">733</a><td> * @return {!Options} A self reference.<tr><td><a id="l734"></a><a href="#l734">734</a><td> */<tr><td><a id="l735"></a><a href="#l735">735</a><td>Options.prototype.setProxy = function(proxy) {<tr><td><a id="l736"></a><a href="#l736">736</a><td>  this.proxy_ = proxy;<tr><td><a id="l737"></a><a href="#l737">737</a><td>  return this;<tr><td><a id="l738"></a><a href="#l738">738</a><td>};<tr><td><a id="l739"></a><a href="#l739">739</a><td><tr><td><a id="l740"></a><a href="#l740">740</a><td><tr><td><a id="l741"></a><a href="#l741">741</a><td>/**<tr><td><a id="l742"></a><a href="#l742">742</a><td> * Converts this options instance to a {@link webdriver.Capabilities} object.<tr><td><a id="l743"></a><a href="#l743">743</a><td> * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge<tr><td><a id="l744"></a><a href="#l744">744</a><td> *     these options into, if any.<tr><td><a id="l745"></a><a href="#l745">745</a><td> * @return {!webdriver.Capabilities} The capabilities.<tr><td><a id="l746"></a><a href="#l746">746</a><td> */<tr><td><a id="l747"></a><a href="#l747">747</a><td>Options.prototype.toCapabilities = function(opt_capabilities) {<tr><td><a id="l748"></a><a href="#l748">748</a><td>  var capabilities = opt_capabilities || webdriver.Capabilities.chrome();<tr><td><a id="l749"></a><a href="#l749">749</a><td>  capabilities.<tr><td><a id="l750"></a><a href="#l750">750</a><td>      set(webdriver.Capability.PROXY, this.proxy_).<tr><td><a id="l751"></a><a href="#l751">751</a><td>      set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_).<tr><td><a id="l752"></a><a href="#l752">752</a><td>      set(OPTIONS_CAPABILITY_KEY, this);<tr><td><a id="l753"></a><a href="#l753">753</a><td>  return capabilities;<tr><td><a id="l754"></a><a href="#l754">754</a><td>};<tr><td><a id="l755"></a><a href="#l755">755</a><td><tr><td><a id="l756"></a><a href="#l756">756</a><td><tr><td><a id="l757"></a><a href="#l757">757</a><td>/**<tr><td><a id="l758"></a><a href="#l758">758</a><td> * Converts this instance to its JSON wire protocol representation. Note this<tr><td><a id="l759"></a><a href="#l759">759</a><td> * function is an implementation not intended for general use.<tr><td><a id="l760"></a><a href="#l760">760</a><td> * @return {{args: !Array.&lt;string&gt;,<tr><td><a id="l761"></a><a href="#l761">761</a><td> *           binary: (string|undefined),<tr><td><a id="l762"></a><a href="#l762">762</a><td> *           detach: boolean,<tr><td><a id="l763"></a><a href="#l763">763</a><td> *           extensions: !Array.&lt;(string|!webdriver.promise.Promise.&lt;string&gt;)&gt;,<tr><td><a id="l764"></a><a href="#l764">764</a><td> *           localState: (Object|undefined),<tr><td><a id="l765"></a><a href="#l765">765</a><td> *           logPath: (string|undefined),<tr><td><a id="l766"></a><a href="#l766">766</a><td> *           prefs: (Object|undefined)}} The JSON wire protocol representation<tr><td><a id="l767"></a><a href="#l767">767</a><td> *     of this instance.<tr><td><a id="l768"></a><a href="#l768">768</a><td> * @override<tr><td><a id="l769"></a><a href="#l769">769</a><td> */<tr><td><a id="l770"></a><a href="#l770">770</a><td>Options.prototype.serialize = function() {<tr><td><a id="l771"></a><a href="#l771">771</a><td>  var json = {};<tr><td><a id="l772"></a><a href="#l772">772</a><td>  for (var key in this.options_) {<tr><td><a id="l773"></a><a href="#l773">773</a><td>    if (this.options_[key] != null) {<tr><td><a id="l774"></a><a href="#l774">774</a><td>      json[key] = this.options_[key];<tr><td><a id="l775"></a><a href="#l775">775</a><td>    }<tr><td><a id="l776"></a><a href="#l776">776</a><td>  }<tr><td><a id="l777"></a><a href="#l777">777</a><td>  if (this.extensions_.length) {<tr><td><a id="l778"></a><a href="#l778">778</a><td>    json.extensions = this.extensions_.map(function(extension) {<tr><td><a id="l779"></a><a href="#l779">779</a><td>      if (Buffer.isBuffer(extension)) {<tr><td><a id="l780"></a><a href="#l780">780</a><td>        return extension.toString(&#39;base64&#39;);<tr><td><a id="l781"></a><a href="#l781">781</a><td>      }<tr><td><a id="l782"></a><a href="#l782">782</a><td>      return webdriver.promise.checkedNodeCall(<tr><td><a id="l783"></a><a href="#l783">783</a><td>          fs.readFile, extension, &#39;base64&#39;);<tr><td><a id="l784"></a><a href="#l784">784</a><td>    });<tr><td><a id="l785"></a><a href="#l785">785</a><td>  }<tr><td><a id="l786"></a><a href="#l786">786</a><td>  return json;<tr><td><a id="l787"></a><a href="#l787">787</a><td>};<tr><td><a id="l788"></a><a href="#l788">788</a><td><tr><td><a id="l789"></a><a href="#l789">789</a><td><tr><td><a id="l790"></a><a href="#l790">790</a><td>/**<tr><td><a id="l791"></a><a href="#l791">791</a><td> * Creates a new WebDriver client for Chrome.<tr><td><a id="l792"></a><a href="#l792">792</a><td> *<tr><td><a id="l793"></a><a href="#l793">793</a><td> * @param {(webdriver.Capabilities|Options)=} opt_config The configuration<tr><td><a id="l794"></a><a href="#l794">794</a><td> *     options.<tr><td><a id="l795"></a><a href="#l795">795</a><td> * @param {remote.DriverService=} opt_service The session to use; will use<tr><td><a id="l796"></a><a href="#l796">796</a><td> *     the {@linkplain #getDefaultService default service} by default.<tr><td><a id="l797"></a><a href="#l797">797</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or<tr><td><a id="l798"></a><a href="#l798">798</a><td> *     {@code null} to use the currently active flow.<tr><td><a id="l799"></a><a href="#l799">799</a><td> * @constructor<tr><td><a id="l800"></a><a href="#l800">800</a><td> * @extends {webdriver.WebDriver}<tr><td><a id="l801"></a><a href="#l801">801</a><td> */<tr><td><a id="l802"></a><a href="#l802">802</a><td>var Driver = function(opt_config, opt_service, opt_flow) {<tr><td><a id="l803"></a><a href="#l803">803</a><td>  var service = opt_service || getDefaultService();<tr><td><a id="l804"></a><a href="#l804">804</a><td>  var executor = createExecutor(service.start());<tr><td><a id="l805"></a><a href="#l805">805</a><td><tr><td><a id="l806"></a><a href="#l806">806</a><td>  var capabilities =<tr><td><a id="l807"></a><a href="#l807">807</a><td>      opt_config instanceof Options ? opt_config.toCapabilities() :<tr><td><a id="l808"></a><a href="#l808">808</a><td>      (opt_config || webdriver.Capabilities.chrome());<tr><td><a id="l809"></a><a href="#l809">809</a><td><tr><td><a id="l810"></a><a href="#l810">810</a><td>  var driver = webdriver.WebDriver.createSession(<tr><td><a id="l811"></a><a href="#l811">811</a><td>      executor, capabilities, opt_flow);<tr><td><a id="l812"></a><a href="#l812">812</a><td><tr><td><a id="l813"></a><a href="#l813">813</a><td>  webdriver.WebDriver.call(<tr><td><a id="l814"></a><a href="#l814">814</a><td>      this, driver.getSession(), executor, driver.controlFlow());<tr><td><a id="l815"></a><a href="#l815">815</a><td>};<tr><td><a id="l816"></a><a href="#l816">816</a><td>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l817"></a><a href="#l817">817</a><td><tr><td><a id="l818"></a><a href="#l818">818</a><td><tr><td><a id="l819"></a><a href="#l819">819</a><td>/**<tr><td><a id="l820"></a><a href="#l820">820</a><td> * This function is a no-op as file detectors are not supported by this<tr><td><a id="l821"></a><a href="#l821">821</a><td> * implementation.<tr><td><a id="l822"></a><a href="#l822">822</a><td> * @override<tr><td><a id="l823"></a><a href="#l823">823</a><td> */<tr><td><a id="l824"></a><a href="#l824">824</a><td>Driver.prototype.setFileDetector = function() {<tr><td><a id="l825"></a><a href="#l825">825</a><td>};<tr><td><a id="l826"></a><a href="#l826">826</a><td><tr><td><a id="l827"></a><a href="#l827">827</a><td><tr><td><a id="l828"></a><a href="#l828">828</a><td>/**<tr><td><a id="l829"></a><a href="#l829">829</a><td> * Schedules a command to launch Chrome App with given ID.<tr><td><a id="l830"></a><a href="#l830">830</a><td> * @param {string} id ID of the App to launch.<tr><td><a id="l831"></a><a href="#l831">831</a><td> * @return {!webdriver.promise.Promise&lt;void&gt;} A promise that will be resolved<tr><td><a id="l832"></a><a href="#l832">832</a><td> *     when app is launched.<tr><td><a id="l833"></a><a href="#l833">833</a><td> */<tr><td><a id="l834"></a><a href="#l834">834</a><td>Driver.prototype.launchApp = function(id) {<tr><td><a id="l835"></a><a href="#l835">835</a><td>  return this.schedule(<tr><td><a id="l836"></a><a href="#l836">836</a><td>      new webdriver.Command(Command.LAUNCH_APP).setParameter(&#39;id&#39;, id),<tr><td><a id="l837"></a><a href="#l837">837</a><td>      &#39;Driver.launchApp()&#39;);<tr><td><a id="l838"></a><a href="#l838">838</a><td>};<tr><td><a id="l839"></a><a href="#l839">839</a><td><tr><td><a id="l840"></a><a href="#l840">840</a><td><tr><td><a id="l841"></a><a href="#l841">841</a><td>// PUBLIC API<tr><td><a id="l842"></a><a href="#l842">842</a><td><tr><td><a id="l843"></a><a href="#l843">843</a><td><tr><td><a id="l844"></a><a href="#l844">844</a><td>exports.Driver = Driver;<tr><td><a id="l845"></a><a href="#l845">845</a><td>exports.Options = Options;<tr><td><a id="l846"></a><a href="#l846">846</a><td>exports.ServiceBuilder = ServiceBuilder;<tr><td><a id="l847"></a><a href="#l847">847</a><td>exports.getDefaultService = getDefaultService;<tr><td><a id="l848"></a><a href="#l848">848</a><td>exports.setDefaultService = setDefaultService;</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>
\ No newline at end of file
diff --git a/docs/source/error.js.src.html b/docs/source/error.js.src.html
index a8aa5b0..89a1a72 100644
--- a/docs/source/error.js.src.html
+++ b/docs/source/error.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>error.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>error.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2014 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2014 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>&#39;use strict&#39;;<tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td>var base = require(&#39;./_base&#39;);<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>/** @type {function(new: bot.Error)} */<tr><td><a name="l22" href="#l22">22</a><td>exports.Error = base.require(&#39;bot.Error&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td>/** @type {bot.ErrorCode.} */<tr><td><a name="l25" href="#l25">25</a><td>exports.ErrorCode = base.require(&#39;bot.ErrorCode&#39;);</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>error.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>error.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var base = require(&#39;./_base&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/** @type {function(new: bot.Error)} */<tr><td><a id="l24"></a><a href="#l24">24</a><td>exports.Error = base.require(&#39;bot.Error&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>/** @type {bot.ErrorCode.} */<tr><td><a id="l27"></a><a href="#l27">27</a><td>exports.ErrorCode = base.require(&#39;bot.ErrorCode&#39;);</table></div></article><nav><h3><a href="../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/executors.js.src.html b/docs/source/executors.js.src.html
index b44c5ad..27312a2 100644
--- a/docs/source/executors.js.src.html
+++ b/docs/source/executors.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>executors.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>executors.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Various utilities for working with<tr><td><a name="l17" href="#l17">17</a><td> * {@link webdriver.CommandExecutor} implementations.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>var HttpClient = require(&#39;./http&#39;).HttpClient,<tr><td><a name="l21" href="#l21">21</a><td>    HttpExecutor = require(&#39;./http&#39;).Executor,<tr><td><a name="l22" href="#l22">22</a><td>    promise = require(&#39;./_base&#39;).require(&#39;webdriver.promise&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>/**<tr><td><a name="l27" href="#l27">27</a><td> * Wraps a promised {@link webdriver.CommandExecutor}, ensuring no commands<tr><td><a name="l28" href="#l28">28</a><td> * are executed until the wrapped executor has been fully built.<tr><td><a name="l29" href="#l29">29</a><td> * @param {!webdriver.promise.Promise.&lt;!webdriver.CommandExecutor&gt;} delegate The<tr><td><a name="l30" href="#l30">30</a><td> *     promised delegate.<tr><td><a name="l31" href="#l31">31</a><td> * @constructor<tr><td><a name="l32" href="#l32">32</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td>var DeferredExecutor = function(delegate) {<tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td>  /** @override */<tr><td><a name="l37" href="#l37">37</a><td>  this.execute = function(command, callback) {<tr><td><a name="l38" href="#l38">38</a><td>    delegate.then(function(executor) {<tr><td><a name="l39" href="#l39">39</a><td>      executor.execute(command, callback);<tr><td><a name="l40" href="#l40">40</a><td>    }, callback);<tr><td><a name="l41" href="#l41">41</a><td>  };<tr><td><a name="l42" href="#l42">42</a><td>};<tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>// PUBLIC API<tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td>/**<tr><td><a name="l49" href="#l49">49</a><td> * Creates a command executor that uses WebDriver&#39;s JSON wire protocol.<tr><td><a name="l50" href="#l50">50</a><td> * @param {(string|!webdriver.promise.Promise.&lt;string&gt;)} url The server&#39;s URL,<tr><td><a name="l51" href="#l51">51</a><td> *     or a promise that will resolve to that URL.<tr><td><a name="l52" href="#l52">52</a><td> * @returns {!webdriver.CommandExecutor} The new command executor.<tr><td><a name="l53" href="#l53">53</a><td> */<tr><td><a name="l54" href="#l54">54</a><td>exports.createExecutor = function(url) {<tr><td><a name="l55" href="#l55">55</a><td>  return new DeferredExecutor(promise.when(url, function(url) {<tr><td><a name="l56" href="#l56">56</a><td>    var client = new HttpClient(url);<tr><td><a name="l57" href="#l57">57</a><td>    return new HttpExecutor(client);<tr><td><a name="l58" href="#l58">58</a><td>  }));<tr><td><a name="l59" href="#l59">59</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
+<!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>executors.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>executors.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Various utilities for working with<tr><td><a id="l20"></a><a href="#l20">20</a><td> * {@link webdriver.CommandExecutor} implementations.<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>var HttpClient = require(&#39;./http&#39;).HttpClient,<tr><td><a id="l24"></a><a href="#l24">24</a><td>    HttpExecutor = require(&#39;./http&#39;).Executor,<tr><td><a id="l25"></a><a href="#l25">25</a><td>    promise = require(&#39;./_base&#39;).require(&#39;webdriver.promise&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>/**<tr><td><a id="l30"></a><a href="#l30">30</a><td> * Wraps a promised {@link webdriver.CommandExecutor}, ensuring no commands<tr><td><a id="l31"></a><a href="#l31">31</a><td> * are executed until the wrapped executor has been fully built.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {!webdriver.promise.Promise.&lt;!webdriver.CommandExecutor&gt;} delegate The<tr><td><a id="l33"></a><a href="#l33">33</a><td> *     promised delegate.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @constructor<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>var DeferredExecutor = function(delegate) {<tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td>  /** @override */<tr><td><a id="l40"></a><a href="#l40">40</a><td>  this.execute = function(command, callback) {<tr><td><a id="l41"></a><a href="#l41">41</a><td>    delegate.then(function(executor) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>      executor.execute(command, callback);<tr><td><a id="l43"></a><a href="#l43">43</a><td>    }, callback);<tr><td><a id="l44"></a><a href="#l44">44</a><td>  };<tr><td><a id="l45"></a><a href="#l45">45</a><td>};<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>// PUBLIC API<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>exports.DeferredExecutor = DeferredExecutor;<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Creates a command executor that uses WebDriver&#39;s JSON wire protocol.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {(string|!webdriver.promise.Promise.&lt;string&gt;)} url The server&#39;s URL,<tr><td><a id="l56"></a><a href="#l56">56</a><td> *     or a promise that will resolve to that URL.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @param {string=} opt_proxy (optional) The URL of the HTTP proxy for the<tr><td><a id="l58"></a><a href="#l58">58</a><td> *     client to use.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @returns {!webdriver.CommandExecutor} The new command executor.<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>exports.createExecutor = function(url, opt_proxy) {<tr><td><a id="l62"></a><a href="#l62">62</a><td>  return new DeferredExecutor(promise.when(url, function(url) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>    var client = new HttpClient(url, null, opt_proxy);<tr><td><a id="l64"></a><a href="#l64">64</a><td>    return new HttpExecutor(client);<tr><td><a id="l65"></a><a href="#l65">65</a><td>  }));<tr><td><a id="l66"></a><a href="#l66">66</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>
\ No newline at end of file
diff --git a/docs/source/firefox/binary.js.src.html b/docs/source/firefox/binary.js.src.html
new file mode 100644
index 0000000..9f5542a
--- /dev/null
+++ b/docs/source/firefox/binary.js.src.html
@@ -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>binary.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>firefox/binary.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Manages Firefox binaries. This module is considered internal;<tr><td><a id="l20"></a><a href="#l20">20</a><td> * users should use {@link selenium-webdriver/firefox}.<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>&#39;use strict&#39;;<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>var child = require(&#39;child_process&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td>    fs = require(&#39;fs&#39;),<tr><td><a id="l27"></a><a href="#l27">27</a><td>    path = require(&#39;path&#39;),<tr><td><a id="l28"></a><a href="#l28">28</a><td>    util = require(&#39;util&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td>var Serializable = require(&#39;..&#39;).Serializable,<tr><td><a id="l31"></a><a href="#l31">31</a><td>    promise = require(&#39;..&#39;).promise,<tr><td><a id="l32"></a><a href="#l32">32</a><td>    _base = require(&#39;../_base&#39;),<tr><td><a id="l33"></a><a href="#l33">33</a><td>    io = require(&#39;../io&#39;),<tr><td><a id="l34"></a><a href="#l34">34</a><td>    exec = require(&#39;../io/exec&#39;);<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>/** @const */<tr><td><a id="l39"></a><a href="#l39">39</a><td>var NO_FOCUS_LIB_X86 = _base.isDevMode() ?<tr><td><a id="l40"></a><a href="#l40">40</a><td>    path.join(__dirname, &#39;../../../../cpp/prebuilt/i386/libnoblur.so&#39;) :<tr><td><a id="l41"></a><a href="#l41">41</a><td>    path.join(__dirname, &#39;../lib/firefox/i386/libnoblur.so&#39;) ;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td>/** @const */<tr><td><a id="l44"></a><a href="#l44">44</a><td>var NO_FOCUS_LIB_AMD64 = _base.isDevMode() ?<tr><td><a id="l45"></a><a href="#l45">45</a><td>    path.join(__dirname, &#39;../../../../cpp/prebuilt/amd64/libnoblur64.so&#39;) :<tr><td><a id="l46"></a><a href="#l46">46</a><td>    path.join(__dirname, &#39;../lib/firefox/amd64/libnoblur64.so&#39;) ;<tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>var X_IGNORE_NO_FOCUS_LIB = &#39;x_ignore_nofocus.so&#39;;<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td>var foundBinary = null;<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Checks the default Windows Firefox locations in Program Files.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @return {!promise.Promise.&lt;?string&gt;} A promise for the located executable.<tr><td><a id="l56"></a><a href="#l56">56</a><td> *     The promise will resolve to {@code null} if Fireox was not found.<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>function defaultWindowsLocation() {<tr><td><a id="l59"></a><a href="#l59">59</a><td>  var files = [<tr><td><a id="l60"></a><a href="#l60">60</a><td>    process.env[&#39;PROGRAMFILES&#39;] || &#39;C:\\Program Files&#39;,<tr><td><a id="l61"></a><a href="#l61">61</a><td>    process.env[&#39;PROGRAMFILES(X86)&#39;] || &#39;C:\\Program Files (x86)&#39;<tr><td><a id="l62"></a><a href="#l62">62</a><td>  ].map(function(prefix) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>    return path.join(prefix, &#39;Mozilla Firefox\\firefox.exe&#39;);<tr><td><a id="l64"></a><a href="#l64">64</a><td>  });<tr><td><a id="l65"></a><a href="#l65">65</a><td>  return io.exists(files[0]).then(function(exists) {<tr><td><a id="l66"></a><a href="#l66">66</a><td>    return exists ? files[0] : io.exists(files[1]).then(function(exists) {<tr><td><a id="l67"></a><a href="#l67">67</a><td>      return exists ? files[1] : null;<tr><td><a id="l68"></a><a href="#l68">68</a><td>    });<tr><td><a id="l69"></a><a href="#l69">69</a><td>  });<tr><td><a id="l70"></a><a href="#l70">70</a><td>}<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> * Locates the Firefox binary for the current system.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the located binary. The<tr><td><a id="l76"></a><a href="#l76">76</a><td> *     promise will be rejected if Firefox cannot be located.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>function findFirefox() {<tr><td><a id="l79"></a><a href="#l79">79</a><td>  if (foundBinary) {<tr><td><a id="l80"></a><a href="#l80">80</a><td>    return foundBinary;<tr><td><a id="l81"></a><a href="#l81">81</a><td>  }<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>  if (process.platform === &#39;darwin&#39;) {<tr><td><a id="l84"></a><a href="#l84">84</a><td>    var osxExe =  &#39;/Applications/Firefox.app/Contents/MacOS/firefox-bin&#39;;<tr><td><a id="l85"></a><a href="#l85">85</a><td>    foundBinary = io.exists(osxExe).then(function(exists) {<tr><td><a id="l86"></a><a href="#l86">86</a><td>      return exists ? osxExe : null;<tr><td><a id="l87"></a><a href="#l87">87</a><td>    });<tr><td><a id="l88"></a><a href="#l88">88</a><td>  } else if (process.platform === &#39;win32&#39;) {<tr><td><a id="l89"></a><a href="#l89">89</a><td>    foundBinary = defaultWindowsLocation();<tr><td><a id="l90"></a><a href="#l90">90</a><td>  } else {<tr><td><a id="l91"></a><a href="#l91">91</a><td>    foundBinary = promise.fulfilled(io.findInPath(&#39;firefox&#39;));<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>  return foundBinary = foundBinary.then(function(found) {<tr><td><a id="l95"></a><a href="#l95">95</a><td>    if (found) {<tr><td><a id="l96"></a><a href="#l96">96</a><td>      return found;<tr><td><a id="l97"></a><a href="#l97">97</a><td>    }<tr><td><a id="l98"></a><a href="#l98">98</a><td>    throw Error(&#39;Could not locate Firefox on the current system&#39;);<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>/**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * Copies the no focus libs into the given profile directory.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {string} profileDir Path to the profile directory to install into.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!promise.Promise.&lt;string&gt;} The LD_LIBRARY_PATH prefix string to use<tr><td><a id="l107"></a><a href="#l107">107</a><td> *     for the installed libs.<tr><td><a id="l108"></a><a href="#l108">108</a><td> */<tr><td><a id="l109"></a><a href="#l109">109</a><td>function installNoFocusLibs(profileDir) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>  var x86 = path.join(profileDir, &#39;x86&#39;);<tr><td><a id="l111"></a><a href="#l111">111</a><td>  var amd64 = path.join(profileDir, &#39;amd64&#39;);<tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td>  return mkdir(x86)<tr><td><a id="l114"></a><a href="#l114">114</a><td>      .then(copyLib.bind(null, NO_FOCUS_LIB_X86, x86))<tr><td><a id="l115"></a><a href="#l115">115</a><td>      .then(mkdir.bind(null, amd64))<tr><td><a id="l116"></a><a href="#l116">116</a><td>      .then(copyLib.bind(null, NO_FOCUS_LIB_AMD64, amd64))<tr><td><a id="l117"></a><a href="#l117">117</a><td>      .then(function() {<tr><td><a id="l118"></a><a href="#l118">118</a><td>        return x86 + &#39;:&#39; + amd64;<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>  function mkdir(dir) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>    return io.exists(dir).then(function(exists) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>      if (!exists) {<tr><td><a id="l124"></a><a href="#l124">124</a><td>        return promise.checkedNodeCall(fs.mkdir, dir);<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><tr><td><a id="l129"></a><a href="#l129">129</a><td>  function copyLib(src, dir) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>    return io.copy(src, path.join(dir, X_IGNORE_NO_FOCUS_LIB));<tr><td><a id="l131"></a><a href="#l131">131</a><td>  }<tr><td><a id="l132"></a><a href="#l132">132</a><td>}<tr><td><a id="l133"></a><a href="#l133">133</a><td><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> * Provides a mechanism to configure and launch Firefox in a subprocess for<tr><td><a id="l137"></a><a href="#l137">137</a><td> * use with WebDriver.<tr><td><a id="l138"></a><a href="#l138">138</a><td> *<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {string=} opt_exe Path to the Firefox binary to use. If not<tr><td><a id="l140"></a><a href="#l140">140</a><td> *     specified, will attempt to locate Firefox on the current system.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @constructor<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @extends {Serializable.&lt;string&gt;}<tr><td><a id="l143"></a><a href="#l143">143</a><td> */<tr><td><a id="l144"></a><a href="#l144">144</a><td>var Binary = function(opt_exe) {<tr><td><a id="l145"></a><a href="#l145">145</a><td>  Serializable.call(this);<tr><td><a id="l146"></a><a href="#l146">146</a><td><tr><td><a id="l147"></a><a href="#l147">147</a><td>  /** @private {(string|undefined)} */<tr><td><a id="l148"></a><a href="#l148">148</a><td>  this.exe_ = opt_exe;<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>  /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l151"></a><a href="#l151">151</a><td>  this.args_ = [];<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>  /** @private {!Object.&lt;string, string&gt;} */<tr><td><a id="l154"></a><a href="#l154">154</a><td>  this.env_ = {};<tr><td><a id="l155"></a><a href="#l155">155</a><td>  Object.keys(process.env).forEach(function(key) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>    this.env_[key] = process.env[key];<tr><td><a id="l157"></a><a href="#l157">157</a><td>  }.bind(this));<tr><td><a id="l158"></a><a href="#l158">158</a><td>  this.env_[&#39;MOZ_CRASHREPORTER_DISABLE&#39;] = &#39;1&#39;;<tr><td><a id="l159"></a><a href="#l159">159</a><td>  this.env_[&#39;MOZ_NO_REMOTE&#39;] = &#39;1&#39;;<tr><td><a id="l160"></a><a href="#l160">160</a><td>  this.env_[&#39;NO_EM_RESTART&#39;] = &#39;1&#39;;<tr><td><a id="l161"></a><a href="#l161">161</a><td>};<tr><td><a id="l162"></a><a href="#l162">162</a><td>util.inherits(Binary, Serializable);<tr><td><a id="l163"></a><a href="#l163">163</a><td><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> * Add arguments to the command line used to start Firefox.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {...(string|!Array.&lt;string&gt;)} var_args Either the arguments to add as<tr><td><a id="l168"></a><a href="#l168">168</a><td> *     varargs, or the arguments as an array.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>Binary.prototype.addArguments = function(var_args) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>  for (var i = 0; i &lt; arguments.length; i++) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>    if (util.isArray(arguments[i])) {<tr><td><a id="l173"></a><a href="#l173">173</a><td>      this.args_ = this.args_.concat(arguments[i]);<tr><td><a id="l174"></a><a href="#l174">174</a><td>    } else {<tr><td><a id="l175"></a><a href="#l175">175</a><td>      this.args_.push(arguments[i]);<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><tr><td><a id="l180"></a><a href="#l180">180</a><td><tr><td><a id="l181"></a><a href="#l181">181</a><td>/**<tr><td><a id="l182"></a><a href="#l182">182</a><td> * Launches Firefox and returns a promise that will be fulfilled when the<tr><td><a id="l183"></a><a href="#l183">183</a><td> * process terminates.<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @param {string} profile Path to the profile directory to use.<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @return {!promise.Promise.&lt;!exec.Command&gt;} A promise for the handle to the<tr><td><a id="l186"></a><a href="#l186">186</a><td> *     started subprocess.<tr><td><a id="l187"></a><a href="#l187">187</a><td> */<tr><td><a id="l188"></a><a href="#l188">188</a><td>Binary.prototype.launch = function(profile) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>  var env = {};<tr><td><a id="l190"></a><a href="#l190">190</a><td>  Object.keys(this.env_).forEach(function(key) {<tr><td><a id="l191"></a><a href="#l191">191</a><td>    env[key] = this.env_[key];<tr><td><a id="l192"></a><a href="#l192">192</a><td>  }.bind(this));<tr><td><a id="l193"></a><a href="#l193">193</a><td>  env[&#39;XRE_PROFILE_PATH&#39;] = profile;<tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td>  var args = [&#39;-foreground&#39;].concat(this.args_);<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>  return promise.when(this.exe_ || findFirefox(), function(firefox) {<tr><td><a id="l198"></a><a href="#l198">198</a><td>    if (process.platform === &#39;win32&#39; || process.platform === &#39;darwin&#39;) {<tr><td><a id="l199"></a><a href="#l199">199</a><td>      return exec(firefox, {args: args, env: env});<tr><td><a id="l200"></a><a href="#l200">200</a><td>    }<tr><td><a id="l201"></a><a href="#l201">201</a><td>    return installNoFocusLibs(profile).then(function(ldLibraryPath) {<tr><td><a id="l202"></a><a href="#l202">202</a><td>      env[&#39;LD_LIBRARY_PATH&#39;] = ldLibraryPath + &#39;:&#39; + env[&#39;LD_LIBRARY_PATH&#39;];<tr><td><a id="l203"></a><a href="#l203">203</a><td>      env[&#39;LD_PRELOAD&#39;] = X_IGNORE_NO_FOCUS_LIB;<tr><td><a id="l204"></a><a href="#l204">204</a><td>      return exec(firefox, {args: args, env: env});<tr><td><a id="l205"></a><a href="#l205">205</a><td>    });<tr><td><a id="l206"></a><a href="#l206">206</a><td>  });<tr><td><a id="l207"></a><a href="#l207">207</a><td>};<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td>/**<tr><td><a id="l211"></a><a href="#l211">211</a><td> * Returns a promise for the wire representation of this binary. Note: the<tr><td><a id="l212"></a><a href="#l212">212</a><td> * FirefoxDriver only supports passing the path to the binary executable over<tr><td><a id="l213"></a><a href="#l213">213</a><td> * the wire; all command line arguments and environment variables will be<tr><td><a id="l214"></a><a href="#l214">214</a><td> * discarded.<tr><td><a id="l215"></a><a href="#l215">215</a><td> *<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for this binary&#39;s wire<tr><td><a id="l217"></a><a href="#l217">217</a><td> *     representation.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @override<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>Binary.prototype.serialize = function() {<tr><td><a id="l221"></a><a href="#l221">221</a><td>  return promise.when(this.exe_ || findFirefox());<tr><td><a id="l222"></a><a href="#l222">222</a><td>};<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td>// PUBLIC API<tr><td><a id="l226"></a><a href="#l226">226</a><td><tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td>exports.Binary = Binary;<tr><td><a id="l229"></a><a href="#l229">229</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>
\ No newline at end of file
diff --git a/docs/source/firefox/extension.js.src.html b/docs/source/firefox/extension.js.src.html
new file mode 100644
index 0000000..4e4bb30
--- /dev/null
+++ b/docs/source/firefox/extension.js.src.html
@@ -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>extension.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>firefox/extension.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>/** @fileoverview Utilities for working with Firefox extensions. */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>&#39;use strict&#39;;<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>var AdmZip = require(&#39;adm-zip&#39;),<tr><td><a id="l23"></a><a href="#l23">23</a><td>    fs = require(&#39;fs&#39;),<tr><td><a id="l24"></a><a href="#l24">24</a><td>    path = require(&#39;path&#39;),<tr><td><a id="l25"></a><a href="#l25">25</a><td>    util = require(&#39;util&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td>    xml = require(&#39;xml2js&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>var promise = require(&#39;..&#39;).promise,<tr><td><a id="l29"></a><a href="#l29">29</a><td>    checkedCall = promise.checkedNodeCall,<tr><td><a id="l30"></a><a href="#l30">30</a><td>    io = require(&#39;../io&#39;);<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>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * Thrown when there an add-on is malformed.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {string} msg The error message.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @constructor<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @extends {Error}<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>function AddonFormatError(msg) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>  Error.call(this);<tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td>  Error.captureStackTrace(this, AddonFormatError);<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>  /** @override */<tr><td><a id="l45"></a><a href="#l45">45</a><td>  this.name = AddonFormatError.name;<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td>  /** @override */<tr><td><a id="l48"></a><a href="#l48">48</a><td>  this.message = msg;<tr><td><a id="l49"></a><a href="#l49">49</a><td>}<tr><td><a id="l50"></a><a href="#l50">50</a><td>util.inherits(AddonFormatError, Error);<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>/**<tr><td><a id="l55"></a><a href="#l55">55</a><td> * Installs an extension to the given directory.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @param {string} extension Path to the extension to install, as either a xpi<tr><td><a id="l57"></a><a href="#l57">57</a><td> *     file or a directory.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {string} dir Path to the directory to install the extension in.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the add-on ID once<tr><td><a id="l60"></a><a href="#l60">60</a><td> *     installed.<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>function install(extension, dir) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  return getDetails(extension).then(function(details) {<tr><td><a id="l64"></a><a href="#l64">64</a><td>    function returnId() { return details.id; }<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td>    var dst = path.join(dir, details.id);<tr><td><a id="l67"></a><a href="#l67">67</a><td>    if (extension.slice(-4) === &#39;.xpi&#39;) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>      if (!details.unpack) {<tr><td><a id="l69"></a><a href="#l69">69</a><td>        return io.copy(extension, dst + &#39;.xpi&#39;).then(returnId);<tr><td><a id="l70"></a><a href="#l70">70</a><td>      } else {<tr><td><a id="l71"></a><a href="#l71">71</a><td>        return checkedCall(fs.readFile, extension).then(function(buff) {<tr><td><a id="l72"></a><a href="#l72">72</a><td>          // TODO: find an async library for inflating a zip archive.<tr><td><a id="l73"></a><a href="#l73">73</a><td>          new AdmZip(buff).extractAllTo(dst, true);<tr><td><a id="l74"></a><a href="#l74">74</a><td>        }).then(returnId);<tr><td><a id="l75"></a><a href="#l75">75</a><td>      }<tr><td><a id="l76"></a><a href="#l76">76</a><td>    } else {<tr><td><a id="l77"></a><a href="#l77">77</a><td>      return io.copyDir(extension, dst).then(returnId);<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>}<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>/**<tr><td><a id="l84"></a><a href="#l84">84</a><td> * Describes a Firefox add-on.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @typedef {{id: string, name: string, version: string, unpack: boolean}}<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td>var AddonDetails;<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> * Extracts the details needed to install an add-on.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @param {string} addonPath Path to the extension directory.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @return {!promise.Promise.&lt;!AddonDetails&gt;} A promise for the add-on details.<tr><td><a id="l94"></a><a href="#l94">94</a><td> */<tr><td><a id="l95"></a><a href="#l95">95</a><td>function getDetails(addonPath) {<tr><td><a id="l96"></a><a href="#l96">96</a><td>  return readManifest(addonPath).then(function(doc) {<tr><td><a id="l97"></a><a href="#l97">97</a><td>    var em = getNamespaceId(doc, &#39;http://www.mozilla.org/2004/em-rdf#&#39;);<tr><td><a id="l98"></a><a href="#l98">98</a><td>    var rdf = getNamespaceId(<tr><td><a id="l99"></a><a href="#l99">99</a><td>        doc, &#39;http://www.w3.org/1999/02/22-rdf-syntax-ns#&#39;);<tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td>    var description = doc[rdf + &#39;RDF&#39;][rdf + &#39;Description&#39;][0];<tr><td><a id="l102"></a><a href="#l102">102</a><td>    var details = {<tr><td><a id="l103"></a><a href="#l103">103</a><td>      id: getNodeText(description, em + &#39;id&#39;),<tr><td><a id="l104"></a><a href="#l104">104</a><td>      name: getNodeText(description, em + &#39;name&#39;),<tr><td><a id="l105"></a><a href="#l105">105</a><td>      version: getNodeText(description, em + &#39;version&#39;),<tr><td><a id="l106"></a><a href="#l106">106</a><td>      unpack: getNodeText(description, em + &#39;unpack&#39;) || false<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>    if (typeof details.unpack === &#39;string&#39;) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>      details.unpack = details.unpack.toLowerCase() === &#39;true&#39;;<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>    if (!details.id) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>      throw new AddonFormatError(&#39;Could not find add-on ID for &#39; + addonPath);<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>    return details;<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>  function getNodeText(node, name) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>    return node[name] &amp;&amp; node[name][0] || &#39;&#39;;<tr><td><a id="l122"></a><a href="#l122">122</a><td>  }<tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>  function getNamespaceId(doc, url) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>    var keys = Object.keys(doc);<tr><td><a id="l126"></a><a href="#l126">126</a><td>    if (keys.length !== 1) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>      throw new AddonFormatError(&#39;Malformed manifest for add-on &#39; + addonPath);<tr><td><a id="l128"></a><a href="#l128">128</a><td>    }<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>    var namespaces = doc[keys[0]].$;<tr><td><a id="l131"></a><a href="#l131">131</a><td>    var id = &#39;&#39;;<tr><td><a id="l132"></a><a href="#l132">132</a><td>    Object.keys(namespaces).some(function(ns) {<tr><td><a id="l133"></a><a href="#l133">133</a><td>      if (namespaces[ns] !== url) {<tr><td><a id="l134"></a><a href="#l134">134</a><td>        return false;<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>      if (ns.indexOf(&#39;:&#39;) != -1) {<tr><td><a id="l138"></a><a href="#l138">138</a><td>        id = ns.split(&#39;:&#39;)[1] + &#39;:&#39;;<tr><td><a id="l139"></a><a href="#l139">139</a><td>      }<tr><td><a id="l140"></a><a href="#l140">140</a><td>      return true;<tr><td><a id="l141"></a><a href="#l141">141</a><td>    });<tr><td><a id="l142"></a><a href="#l142">142</a><td>    return id;<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>/**<tr><td><a id="l148"></a><a href="#l148">148</a><td> * Reads the manifest for a Firefox add-on.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @param {string} addonPath Path to a Firefox add-on as a xpi or an extension.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @return {!promise.Promise.&lt;!Object&gt;} A promise for the parsed manifest.<tr><td><a id="l151"></a><a href="#l151">151</a><td> */<tr><td><a id="l152"></a><a href="#l152">152</a><td>function readManifest(addonPath) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>  var manifest;<tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td>  if (addonPath.slice(-4) === &#39;.xpi&#39;) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>    manifest = checkedCall(fs.readFile, addonPath).then(function(buff) {<tr><td><a id="l157"></a><a href="#l157">157</a><td>      var zip = new AdmZip(buff);<tr><td><a id="l158"></a><a href="#l158">158</a><td>      if (!zip.getEntry(&#39;install.rdf&#39;)) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>        throw new AddonFormatError(<tr><td><a id="l160"></a><a href="#l160">160</a><td>            &#39;Could not find install.rdf in &#39; + addonPath);<tr><td><a id="l161"></a><a href="#l161">161</a><td>      }<tr><td><a id="l162"></a><a href="#l162">162</a><td>      var done = promise.defer();<tr><td><a id="l163"></a><a href="#l163">163</a><td>      zip.readAsTextAsync(&#39;install.rdf&#39;, done.fulfill);<tr><td><a id="l164"></a><a href="#l164">164</a><td>      return done.promise;<tr><td><a id="l165"></a><a href="#l165">165</a><td>    });<tr><td><a id="l166"></a><a href="#l166">166</a><td>  } else {<tr><td><a id="l167"></a><a href="#l167">167</a><td>    manifest = checkedCall(fs.stat, addonPath).then(function(stats) {<tr><td><a id="l168"></a><a href="#l168">168</a><td>      if (!stats.isDirectory()) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>        throw Error(<tr><td><a id="l170"></a><a href="#l170">170</a><td>            &#39;Add-on path is niether a xpi nor a directory: &#39; + addonPath);<tr><td><a id="l171"></a><a href="#l171">171</a><td>      }<tr><td><a id="l172"></a><a href="#l172">172</a><td>      return checkedCall(fs.readFile, path.join(addonPath, &#39;install.rdf&#39;));<tr><td><a id="l173"></a><a href="#l173">173</a><td>    });<tr><td><a id="l174"></a><a href="#l174">174</a><td>  }<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td>  return manifest.then(function(content) {<tr><td><a id="l177"></a><a href="#l177">177</a><td>    return checkedCall(xml.parseString, content);<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><tr><td><a id="l182"></a><a href="#l182">182</a><td>// PUBLIC API<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>exports.install = install;</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>
\ No newline at end of file
diff --git a/docs/source/firefox/index.js.src.html b/docs/source/firefox/index.js.src.html
new file mode 100644
index 0000000..b5ea228
--- /dev/null
+++ b/docs/source/firefox/index.js.src.html
@@ -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>index.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>firefox/index.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines the {@linkplain Driver WebDriver} client for Firefox.<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Each FirefoxDriver instance will be created with an anonymous profile,<tr><td><a id="l21"></a><a href="#l21">21</a><td> * ensuring browser historys do not share session data (cookies, history, cache,<tr><td><a id="l22"></a><a href="#l22">22</a><td> * offline storage, etc.)<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * __Customizing the Firefox Profile__<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * The {@link Profile} class may be used to configure the browser profile used<tr><td><a id="l27"></a><a href="#l27">27</a><td> * with WebDriver, with functions to install additional<tr><td><a id="l28"></a><a href="#l28">28</a><td> * {@linkplain Profile#addExtension extensions}, configure browser<tr><td><a id="l29"></a><a href="#l29">29</a><td> * {@linkplain Profile#setPreference preferences}, and more. For example, you<tr><td><a id="l30"></a><a href="#l30">30</a><td> * may wish to include Firebug:<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> *     var firefox = require(&#39;selenium-webdriver/firefox&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> *     var profile = new firefox.Profile();<tr><td><a id="l35"></a><a href="#l35">35</a><td> *     profile.addExtension(&#39;/path/to/firebug.xpi&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     profile.setPreference(&#39;extensions.firebug.showChromeErrors&#39;, true);<tr><td><a id="l37"></a><a href="#l37">37</a><td> *<tr><td><a id="l38"></a><a href="#l38">38</a><td> *     var options = new firefox.Options().setProfile(profile);<tr><td><a id="l39"></a><a href="#l39">39</a><td> *     var driver = new firefox.Driver(options);<tr><td><a id="l40"></a><a href="#l40">40</a><td> *<tr><td><a id="l41"></a><a href="#l41">41</a><td> * The {@link Profile} class may also be used to configure WebDriver based on a<tr><td><a id="l42"></a><a href="#l42">42</a><td> * pre-existing browser profile:<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> *     var profile = new firefox.Profile(<tr><td><a id="l45"></a><a href="#l45">45</a><td> *         &#39;/usr/local/home/bob/.mozilla/firefox/3fgog75h.testing&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td> *     var options = new firefox.Options().setProfile(profile);<tr><td><a id="l47"></a><a href="#l47">47</a><td> *     var driver = new firefox.Driver(options);<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * The FirefoxDriver will _never_ modify a pre-existing profile; instead it will<tr><td><a id="l50"></a><a href="#l50">50</a><td> * create a copy for it to modify. By extension, there are certain browser<tr><td><a id="l51"></a><a href="#l51">51</a><td> * preferences that are required for WebDriver to function properly and they<tr><td><a id="l52"></a><a href="#l52">52</a><td> * will always be overwritten.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> * __Using a Custom Firefox Binary__<tr><td><a id="l55"></a><a href="#l55">55</a><td> *<tr><td><a id="l56"></a><a href="#l56">56</a><td> * On Windows and OSX, the FirefoxDriver will search for Firefox in its<tr><td><a id="l57"></a><a href="#l57">57</a><td> * default installation location:<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * * Windows: C:\Program Files and C:\Program Files (x86).<tr><td><a id="l60"></a><a href="#l60">60</a><td> * * Mac OS X: /Applications/Firefox.app<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * For Linux, Firefox will be located on the PATH: `$(where firefox)`.<tr><td><a id="l63"></a><a href="#l63">63</a><td> *<tr><td><a id="l64"></a><a href="#l64">64</a><td> * You can configure WebDriver to start use a custom Firefox installation with<tr><td><a id="l65"></a><a href="#l65">65</a><td> * the {@link Binary} class:<tr><td><a id="l66"></a><a href="#l66">66</a><td> *<tr><td><a id="l67"></a><a href="#l67">67</a><td> *     var firefox = require(&#39;selenium-webdriver/firefox&#39;);<tr><td><a id="l68"></a><a href="#l68">68</a><td> *     var binary = new firefox.Binary(&#39;/my/firefox/install/dir/firefox-bin&#39;);<tr><td><a id="l69"></a><a href="#l69">69</a><td> *     var options = new firefox.Options().setBinary(binary);<tr><td><a id="l70"></a><a href="#l70">70</a><td> *     var driver = new firefox.Driver(options);<tr><td><a id="l71"></a><a href="#l71">71</a><td> *<tr><td><a id="l72"></a><a href="#l72">72</a><td> * __Remote Testing__<tr><td><a id="l73"></a><a href="#l73">73</a><td> *<tr><td><a id="l74"></a><a href="#l74">74</a><td> * You may customize the Firefox binary and profile when running against a<tr><td><a id="l75"></a><a href="#l75">75</a><td> * remote Selenium server. Your custom profile will be packaged as a zip and<tr><td><a id="l76"></a><a href="#l76">76</a><td> * transfered to the remote host for use. The profile will be transferred<tr><td><a id="l77"></a><a href="#l77">77</a><td> * _once for each new session_. The performance impact should be minimal if<tr><td><a id="l78"></a><a href="#l78">78</a><td> * you&#39;ve only configured a few extra browser preferences. If you have a large<tr><td><a id="l79"></a><a href="#l79">79</a><td> * profile with several extensions, you should consider installing it on the<tr><td><a id="l80"></a><a href="#l80">80</a><td> * remote host and defining its path via the {@link Options} class. Custom<tr><td><a id="l81"></a><a href="#l81">81</a><td> * binaries are never copied to remote machines and must be referenced by<tr><td><a id="l82"></a><a href="#l82">82</a><td> * installation path.<tr><td><a id="l83"></a><a href="#l83">83</a><td> *<tr><td><a id="l84"></a><a href="#l84">84</a><td> *     var options = new firefox.Options()<tr><td><a id="l85"></a><a href="#l85">85</a><td> *         .setProfile(&#39;/profile/path/on/remote/host&#39;)<tr><td><a id="l86"></a><a href="#l86">86</a><td> *         .setBinary(&#39;/install/dir/on/remote/host/firefox-bin&#39;);<tr><td><a id="l87"></a><a href="#l87">87</a><td> *<tr><td><a id="l88"></a><a href="#l88">88</a><td> *     var driver = new (require(&#39;selenium-webdriver&#39;)).Builder()<tr><td><a id="l89"></a><a href="#l89">89</a><td> *         .forBrowser(&#39;firefox&#39;)<tr><td><a id="l90"></a><a href="#l90">90</a><td> *         .usingServer(&#39;http://127.0.0.1:4444/wd/hub&#39;)<tr><td><a id="l91"></a><a href="#l91">91</a><td> *         .setFirefoxOptions(options)<tr><td><a id="l92"></a><a href="#l92">92</a><td> *         .build();<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>&#39;use strict&#39;;<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>var url = require(&#39;url&#39;),<tr><td><a id="l98"></a><a href="#l98">98</a><td>    util = require(&#39;util&#39;);<tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>var Binary = require(&#39;./binary&#39;).Binary,<tr><td><a id="l101"></a><a href="#l101">101</a><td>    Profile = require(&#39;./profile&#39;).Profile,<tr><td><a id="l102"></a><a href="#l102">102</a><td>    decodeProfile = require(&#39;./profile&#39;).decode,<tr><td><a id="l103"></a><a href="#l103">103</a><td>    webdriver = require(&#39;..&#39;),<tr><td><a id="l104"></a><a href="#l104">104</a><td>    executors = require(&#39;../executors&#39;),<tr><td><a id="l105"></a><a href="#l105">105</a><td>    httpUtil = require(&#39;../http/util&#39;),<tr><td><a id="l106"></a><a href="#l106">106</a><td>    io = require(&#39;../io&#39;),<tr><td><a id="l107"></a><a href="#l107">107</a><td>    net = require(&#39;../net&#39;),<tr><td><a id="l108"></a><a href="#l108">108</a><td>    portprober = require(&#39;../net/portprober&#39;);<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td>/**<tr><td><a id="l112"></a><a href="#l112">112</a><td> * Configuration options for the FirefoxDriver.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @constructor<tr><td><a id="l114"></a><a href="#l114">114</a><td> */<tr><td><a id="l115"></a><a href="#l115">115</a><td>var Options = function() {<tr><td><a id="l116"></a><a href="#l116">116</a><td>  /** @private {Profile} */<tr><td><a id="l117"></a><a href="#l117">117</a><td>  this.profile_ = null;<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td>  /** @private {Binary} */<tr><td><a id="l120"></a><a href="#l120">120</a><td>  this.binary_ = null;<tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td>  /** @private {webdriver.logging.Preferences} */<tr><td><a id="l123"></a><a href="#l123">123</a><td>  this.logPrefs_ = null;<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td>  /** @private {webdriver.ProxyConfig} */<tr><td><a id="l126"></a><a href="#l126">126</a><td>  this.proxy_ = null;<tr><td><a id="l127"></a><a href="#l127">127</a><td>};<tr><td><a id="l128"></a><a href="#l128">128</a><td><tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>/**<tr><td><a id="l131"></a><a href="#l131">131</a><td> * Sets the profile to use. The profile may be specified as a<tr><td><a id="l132"></a><a href="#l132">132</a><td> * {@link Profile} object or as the path to an existing Firefox profile to use<tr><td><a id="l133"></a><a href="#l133">133</a><td> * as a template.<tr><td><a id="l134"></a><a href="#l134">134</a><td> *<tr><td><a id="l135"></a><a href="#l135">135</a><td> * @param {(string|!Profile)} profile The profile to use.<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @return {!Options} A self reference.<tr><td><a id="l137"></a><a href="#l137">137</a><td> */<tr><td><a id="l138"></a><a href="#l138">138</a><td>Options.prototype.setProfile = function(profile) {<tr><td><a id="l139"></a><a href="#l139">139</a><td>  if (typeof profile === &#39;string&#39;) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>    profile = new Profile(profile);<tr><td><a id="l141"></a><a href="#l141">141</a><td>  }<tr><td><a id="l142"></a><a href="#l142">142</a><td>  this.profile_ = profile;<tr><td><a id="l143"></a><a href="#l143">143</a><td>  return this;<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>/**<tr><td><a id="l148"></a><a href="#l148">148</a><td> * Sets the binary to use. The binary may be specified as the path to a Firefox<tr><td><a id="l149"></a><a href="#l149">149</a><td> * executable, or as a {@link Binary} object.<tr><td><a id="l150"></a><a href="#l150">150</a><td> *<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {(string|!Binary)} binary The binary to use.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @return {!Options} A self reference.<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td>Options.prototype.setBinary = function(binary) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>  if (typeof binary === &#39;string&#39;) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>    binary = new Binary(binary);<tr><td><a id="l157"></a><a href="#l157">157</a><td>  }<tr><td><a id="l158"></a><a href="#l158">158</a><td>  this.binary_ = binary;<tr><td><a id="l159"></a><a href="#l159">159</a><td>  return this;<tr><td><a id="l160"></a><a href="#l160">160</a><td>};<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>/**<tr><td><a id="l164"></a><a href="#l164">164</a><td> * Sets the logging preferences for the new session.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {webdriver.logging.Preferences} prefs The logging preferences.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @return {!Options} A self reference.<tr><td><a id="l167"></a><a href="#l167">167</a><td> */<tr><td><a id="l168"></a><a href="#l168">168</a><td>Options.prototype.setLoggingPreferences = function(prefs) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>  this.logPrefs_ = prefs;<tr><td><a id="l170"></a><a href="#l170">170</a><td>  return this;<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><tr><td><a id="l174"></a><a href="#l174">174</a><td>/**<tr><td><a id="l175"></a><a href="#l175">175</a><td> * Sets the proxy to use.<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 {webdriver.ProxyConfig} proxy The proxy configuration to use.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @return {!Options} A self reference.<tr><td><a id="l179"></a><a href="#l179">179</a><td> */<tr><td><a id="l180"></a><a href="#l180">180</a><td>Options.prototype.setProxy = function(proxy) {<tr><td><a id="l181"></a><a href="#l181">181</a><td>  this.proxy_ = proxy;<tr><td><a id="l182"></a><a href="#l182">182</a><td>  return this;<tr><td><a id="l183"></a><a href="#l183">183</a><td>};<tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td>/**<tr><td><a id="l187"></a><a href="#l187">187</a><td> * Converts these options to a {@link webdriver.Capabilities} instance.<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 {!webdriver.Capabilities} A new capabilities object.<tr><td><a id="l190"></a><a href="#l190">190</a><td> */<tr><td><a id="l191"></a><a href="#l191">191</a><td>Options.prototype.toCapabilities = function(opt_remote) {<tr><td><a id="l192"></a><a href="#l192">192</a><td>  var caps = webdriver.Capabilities.firefox();<tr><td><a id="l193"></a><a href="#l193">193</a><td>  if (this.logPrefs_) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>    caps.set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_);<tr><td><a id="l195"></a><a href="#l195">195</a><td>  }<tr><td><a id="l196"></a><a href="#l196">196</a><td>  if (this.proxy_) {<tr><td><a id="l197"></a><a href="#l197">197</a><td>    caps.set(webdriver.Capability.PROXY, this.proxy_);<tr><td><a id="l198"></a><a href="#l198">198</a><td>  }<tr><td><a id="l199"></a><a href="#l199">199</a><td>  if (this.binary_) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>    caps.set(&#39;firefox_binary&#39;, this.binary_);<tr><td><a id="l201"></a><a href="#l201">201</a><td>  }<tr><td><a id="l202"></a><a href="#l202">202</a><td>  if (this.profile_) {<tr><td><a id="l203"></a><a href="#l203">203</a><td>    caps.set(&#39;firefox_profile&#39;, this.profile_);<tr><td><a id="l204"></a><a href="#l204">204</a><td>  }<tr><td><a id="l205"></a><a href="#l205">205</a><td>  return caps;<tr><td><a id="l206"></a><a href="#l206">206</a><td>};<tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td>/**<tr><td><a id="l210"></a><a href="#l210">210</a><td> * A WebDriver client for Firefox.<tr><td><a id="l211"></a><a href="#l211">211</a><td> *<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @param {(Options|webdriver.Capabilities|Object)=} opt_config The<tr><td><a id="l213"></a><a href="#l213">213</a><td> *    configuration options for this driver, specified as either an<tr><td><a id="l214"></a><a href="#l214">214</a><td> *    {@link Options} or {@link webdriver.Capabilities}, or as a raw hash<tr><td><a id="l215"></a><a href="#l215">215</a><td> *    object.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The flow to<tr><td><a id="l217"></a><a href="#l217">217</a><td> *     schedule commands through. Defaults to the active flow object.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @constructor<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @extends {webdriver.WebDriver}<tr><td><a id="l220"></a><a href="#l220">220</a><td> */<tr><td><a id="l221"></a><a href="#l221">221</a><td>var Driver = function(opt_config, opt_flow) {<tr><td><a id="l222"></a><a href="#l222">222</a><td>  var caps;<tr><td><a id="l223"></a><a href="#l223">223</a><td>  if (opt_config instanceof Options) {<tr><td><a id="l224"></a><a href="#l224">224</a><td>    caps = opt_config.toCapabilities();<tr><td><a id="l225"></a><a href="#l225">225</a><td>  } else {<tr><td><a id="l226"></a><a href="#l226">226</a><td>    caps = new webdriver.Capabilities(opt_config);<tr><td><a id="l227"></a><a href="#l227">227</a><td>  }<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>  var binary = caps.get(&#39;firefox_binary&#39;) || new Binary();<tr><td><a id="l230"></a><a href="#l230">230</a><td>  if (typeof binary === &#39;string&#39;) {<tr><td><a id="l231"></a><a href="#l231">231</a><td>    binary = new Binary(binary);<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>  var profile = caps.get(&#39;firefox_profile&#39;) || new Profile();<tr><td><a id="l235"></a><a href="#l235">235</a><td><tr><td><a id="l236"></a><a href="#l236">236</a><td>  caps.set(&#39;firefox_binary&#39;, null);<tr><td><a id="l237"></a><a href="#l237">237</a><td>  caps.set(&#39;firefox_profile&#39;, null);<tr><td><a id="l238"></a><a href="#l238">238</a><td><tr><td><a id="l239"></a><a href="#l239">239</a><td>  /** @private {?string} */<tr><td><a id="l240"></a><a href="#l240">240</a><td>  this.profilePath_ = null;<tr><td><a id="l241"></a><a href="#l241">241</a><td><tr><td><a id="l242"></a><a href="#l242">242</a><td>  var self = this;<tr><td><a id="l243"></a><a href="#l243">243</a><td>  var freePort = portprober.findFreePort();<tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td>  /** @private */<tr><td><a id="l246"></a><a href="#l246">246</a><td>  this.command_ = freePort.then(function(port) {<tr><td><a id="l247"></a><a href="#l247">247</a><td>    if (typeof profile === &#39;string&#39;) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>      return decodeProfile(profile).then(function(dir) {<tr><td><a id="l249"></a><a href="#l249">249</a><td>        var profile = new Profile(dir);<tr><td><a id="l250"></a><a href="#l250">250</a><td>        profile.setPreference(&#39;webdriver_firefox_port&#39;, port);<tr><td><a id="l251"></a><a href="#l251">251</a><td>        return profile.writeToDisk();<tr><td><a id="l252"></a><a href="#l252">252</a><td>      });<tr><td><a id="l253"></a><a href="#l253">253</a><td>    } else {<tr><td><a id="l254"></a><a href="#l254">254</a><td>      profile.setPreference(&#39;webdriver_firefox_port&#39;, port);<tr><td><a id="l255"></a><a href="#l255">255</a><td>      return profile.writeToDisk();<tr><td><a id="l256"></a><a href="#l256">256</a><td>    }<tr><td><a id="l257"></a><a href="#l257">257</a><td>  }).then(function(profileDir) {<tr><td><a id="l258"></a><a href="#l258">258</a><td>    self.profilePath_ = profileDir;<tr><td><a id="l259"></a><a href="#l259">259</a><td>    return binary.launch(profileDir);<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>  var serverUrl = this.command_<tr><td><a id="l263"></a><a href="#l263">263</a><td>      .then(function() { return freePort; })<tr><td><a id="l264"></a><a href="#l264">264</a><td>      .then(function(port) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>        var serverUrl = url.format({<tr><td><a id="l266"></a><a href="#l266">266</a><td>          protocol: &#39;http&#39;,<tr><td><a id="l267"></a><a href="#l267">267</a><td>          hostname: net.getLoopbackAddress(),<tr><td><a id="l268"></a><a href="#l268">268</a><td>          port: port,<tr><td><a id="l269"></a><a href="#l269">269</a><td>          pathname: &#39;/hub&#39;<tr><td><a id="l270"></a><a href="#l270">270</a><td>        });<tr><td><a id="l271"></a><a href="#l271">271</a><td><tr><td><a id="l272"></a><a href="#l272">272</a><td>        return httpUtil.waitForServer(serverUrl, 45 * 1000).then(function() {<tr><td><a id="l273"></a><a href="#l273">273</a><td>          return serverUrl;<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><tr><td><a id="l277"></a><a href="#l277">277</a><td>  var executor = executors.createExecutor(serverUrl);<tr><td><a id="l278"></a><a href="#l278">278</a><td>  var driver = webdriver.WebDriver.createSession(executor, caps, opt_flow);<tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td>  webdriver.WebDriver.call(this, driver.getSession(), executor, opt_flow);<tr><td><a id="l281"></a><a href="#l281">281</a><td>};<tr><td><a id="l282"></a><a href="#l282">282</a><td>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td>/**<tr><td><a id="l286"></a><a href="#l286">286</a><td> * This function is a no-op as file detectors are not supported by this<tr><td><a id="l287"></a><a href="#l287">287</a><td> * implementation.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @override<tr><td><a id="l289"></a><a href="#l289">289</a><td> */<tr><td><a id="l290"></a><a href="#l290">290</a><td>Driver.prototype.setFileDetector = function() {<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>/** @override */<tr><td><a id="l295"></a><a href="#l295">295</a><td>Driver.prototype.quit = function() {<tr><td><a id="l296"></a><a href="#l296">296</a><td>  return this.call(function() {<tr><td><a id="l297"></a><a href="#l297">297</a><td>    var self = this;<tr><td><a id="l298"></a><a href="#l298">298</a><td>    return Driver.super_.prototype.quit.call(this)<tr><td><a id="l299"></a><a href="#l299">299</a><td>        .thenFinally(function() {<tr><td><a id="l300"></a><a href="#l300">300</a><td>          return self.command_.then(function(command) {<tr><td><a id="l301"></a><a href="#l301">301</a><td>            command.kill();<tr><td><a id="l302"></a><a href="#l302">302</a><td>            return command.result();<tr><td><a id="l303"></a><a href="#l303">303</a><td>          });<tr><td><a id="l304"></a><a href="#l304">304</a><td>        })<tr><td><a id="l305"></a><a href="#l305">305</a><td>        .thenFinally(function() {<tr><td><a id="l306"></a><a href="#l306">306</a><td>          if (self.profilePath_) {<tr><td><a id="l307"></a><a href="#l307">307</a><td>            return io.rmDir(self.profilePath_);<tr><td><a id="l308"></a><a href="#l308">308</a><td>          }<tr><td><a id="l309"></a><a href="#l309">309</a><td>        });<tr><td><a id="l310"></a><a href="#l310">310</a><td>  }, this);<tr><td><a id="l311"></a><a href="#l311">311</a><td>};<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td><tr><td><a id="l314"></a><a href="#l314">314</a><td>// PUBLIC API<tr><td><a id="l315"></a><a href="#l315">315</a><td><tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td>exports.Binary = Binary;<tr><td><a id="l318"></a><a href="#l318">318</a><td>exports.Driver = Driver;<tr><td><a id="l319"></a><a href="#l319">319</a><td>exports.Options = Options;<tr><td><a id="l320"></a><a href="#l320">320</a><td>exports.Profile = Profile;</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>
\ No newline at end of file
diff --git a/docs/source/firefox/profile.js.src.html b/docs/source/firefox/profile.js.src.html
new file mode 100644
index 0000000..79fcdf6
--- /dev/null
+++ b/docs/source/firefox/profile.js.src.html
@@ -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>profile.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>firefox/profile.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Profile management module. This module is considered internal;<tr><td><a id="l20"></a><a href="#l20">20</a><td> * users should use {@link selenium-webdriver/firefox}.<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>&#39;use strict&#39;;<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>var AdmZip = require(&#39;adm-zip&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td>    AdmConstants = require(&#39;adm-zip/util/constants&#39;),<tr><td><a id="l27"></a><a href="#l27">27</a><td>    fs = require(&#39;fs&#39;),<tr><td><a id="l28"></a><a href="#l28">28</a><td>    path = require(&#39;path&#39;),<tr><td><a id="l29"></a><a href="#l29">29</a><td>    util = require(&#39;util&#39;),<tr><td><a id="l30"></a><a href="#l30">30</a><td>    vm = require(&#39;vm&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>var Serializable = require(&#39;..&#39;).Serializable,<tr><td><a id="l33"></a><a href="#l33">33</a><td>    promise = require(&#39;..&#39;).promise,<tr><td><a id="l34"></a><a href="#l34">34</a><td>    _base = require(&#39;../_base&#39;),<tr><td><a id="l35"></a><a href="#l35">35</a><td>    io = require(&#39;../io&#39;),<tr><td><a id="l36"></a><a href="#l36">36</a><td>    extension = require(&#39;./extension&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td><tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td>/** @const */<tr><td><a id="l40"></a><a href="#l40">40</a><td>var WEBDRIVER_PREFERENCES_PATH = _base.isDevMode()<tr><td><a id="l41"></a><a href="#l41">41</a><td>    ? path.join(__dirname, &#39;../../../firefox-driver/webdriver.json&#39;)<tr><td><a id="l42"></a><a href="#l42">42</a><td>    : path.join(__dirname, &#39;../lib/firefox/webdriver.json&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>/** @const */<tr><td><a id="l45"></a><a href="#l45">45</a><td>var WEBDRIVER_EXTENSION_PATH = _base.isDevMode()<tr><td><a id="l46"></a><a href="#l46">46</a><td>    ? path.join(__dirname,<tr><td><a id="l47"></a><a href="#l47">47</a><td>        &#39;../../../../build/javascript/firefox-driver/webdriver.xpi&#39;)<tr><td><a id="l48"></a><a href="#l48">48</a><td>    : path.join(__dirname, &#39;../lib/firefox/webdriver.xpi&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td>/** @const */<tr><td><a id="l51"></a><a href="#l51">51</a><td>var WEBDRIVER_EXTENSION_NAME = &#39;fxdriver@googlecode.com&#39;;<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>/** @type {Object} */<tr><td><a id="l56"></a><a href="#l56">56</a><td>var defaultPreferences = null;<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> * Synchronously loads the default preferences used for the FirefoxDriver.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @return {!Object} The default preferences JSON object.<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>function getDefaultPreferences() {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  if (!defaultPreferences) {<tr><td><a id="l64"></a><a href="#l64">64</a><td>    var contents = fs.readFileSync(WEBDRIVER_PREFERENCES_PATH, &#39;utf8&#39;);<tr><td><a id="l65"></a><a href="#l65">65</a><td>    defaultPreferences = JSON.parse(contents);<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 defaultPreferences;<tr><td><a id="l68"></a><a href="#l68">68</a><td>}<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td>/**<tr><td><a id="l72"></a><a href="#l72">72</a><td> * Parses a user.js file in a Firefox profile directory.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @param {string} f Path to the file to parse.<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @return {!promise.Promise.&lt;!Object&gt;} A promise for the parsed preferences as<tr><td><a id="l75"></a><a href="#l75">75</a><td> *     a JSON object. If the file does not exist, an empty object will be<tr><td><a id="l76"></a><a href="#l76">76</a><td> *     returned.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>function loadUserPrefs(f) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>  var done = promise.defer();<tr><td><a id="l80"></a><a href="#l80">80</a><td>  fs.readFile(f, function(err, contents) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>    if (err &amp;&amp; err.code === &#39;ENOENT&#39;) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>      done.fulfill({});<tr><td><a id="l83"></a><a href="#l83">83</a><td>      return;<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>    if (err) {<tr><td><a id="l87"></a><a href="#l87">87</a><td>      done.reject(err);<tr><td><a id="l88"></a><a href="#l88">88</a><td>      return;<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>    var prefs = {};<tr><td><a id="l92"></a><a href="#l92">92</a><td>    var context = vm.createContext({<tr><td><a id="l93"></a><a href="#l93">93</a><td>      &#39;user_pref&#39;: function(key, value) {<tr><td><a id="l94"></a><a href="#l94">94</a><td>        prefs[key] = value;<tr><td><a id="l95"></a><a href="#l95">95</a><td>      }<tr><td><a id="l96"></a><a href="#l96">96</a><td>    });<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>    vm.runInContext(contents, context, f);<tr><td><a id="l99"></a><a href="#l99">99</a><td>    done.fulfill(prefs);<tr><td><a id="l100"></a><a href="#l100">100</a><td>  });<tr><td><a id="l101"></a><a href="#l101">101</a><td>  return done.promise;<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * Copies the properties of one object into another.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @param {!Object} a The destination object.<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @param {!Object} b The source object to apply as a mixin.<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>function mixin(a, b) {<tr><td><a id="l111"></a><a href="#l111">111</a><td>  Object.keys(b).forEach(function(key) {<tr><td><a id="l112"></a><a href="#l112">112</a><td>    a[key] = b[key];<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><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> * @param {!Object} defaults The default preferences to write. Will be<tr><td><a id="l119"></a><a href="#l119">119</a><td> *     overridden by user.js preferences in the template directory and the<tr><td><a id="l120"></a><a href="#l120">120</a><td> *     frozen preferences required by WebDriver.<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @param {string} dir Path to the directory write the file to.<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the profile directory,<tr><td><a id="l123"></a><a href="#l123">123</a><td> *     to be fulfilled when user preferences have been written.<tr><td><a id="l124"></a><a href="#l124">124</a><td> */<tr><td><a id="l125"></a><a href="#l125">125</a><td>function writeUserPrefs(prefs, dir) {<tr><td><a id="l126"></a><a href="#l126">126</a><td>  var userPrefs = path.join(dir, &#39;user.js&#39;);<tr><td><a id="l127"></a><a href="#l127">127</a><td>  return loadUserPrefs(userPrefs).then(function(overrides) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>    mixin(prefs, overrides);<tr><td><a id="l129"></a><a href="#l129">129</a><td>    mixin(prefs, getDefaultPreferences()[&#39;frozen&#39;]);<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>    var contents = Object.keys(prefs).map(function(key) {<tr><td><a id="l132"></a><a href="#l132">132</a><td>      return &#39;user_pref(&#39; + JSON.stringify(key) + &#39;, &#39; +<tr><td><a id="l133"></a><a href="#l133">133</a><td>          JSON.stringify(prefs[key]) + &#39;);&#39;;<tr><td><a id="l134"></a><a href="#l134">134</a><td>    }).join(&#39;\n&#39;);<tr><td><a id="l135"></a><a href="#l135">135</a><td><tr><td><a id="l136"></a><a href="#l136">136</a><td>    var done = promise.defer();<tr><td><a id="l137"></a><a href="#l137">137</a><td>    fs.writeFile(userPrefs, contents, function(err) {<tr><td><a id="l138"></a><a href="#l138">138</a><td>      err &amp;&amp; done.reject(err) || done.fulfill(dir);<tr><td><a id="l139"></a><a href="#l139">139</a><td>    });<tr><td><a id="l140"></a><a href="#l140">140</a><td>    return done.promise;<tr><td><a id="l141"></a><a href="#l141">141</a><td>  });<tr><td><a id="l142"></a><a href="#l142">142</a><td>};<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> * Installs a group of extensions in the given profile directory. If the<tr><td><a id="l147"></a><a href="#l147">147</a><td> * WebDriver extension is not included in this set, the default version<tr><td><a id="l148"></a><a href="#l148">148</a><td> * bundled with this package will be installed.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @param {!Array.&lt;string&gt;} extensions The extensions to install, as a<tr><td><a id="l150"></a><a href="#l150">150</a><td> *     path to an unpacked extension directory or a path to a xpi file.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {string} dir The profile directory to install to.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @param {boolean=} opt_excludeWebDriverExt Whether to skip installation of<tr><td><a id="l153"></a><a href="#l153">153</a><td> *     the default WebDriver extension.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the main profile directory<tr><td><a id="l155"></a><a href="#l155">155</a><td> *     once all extensions have been installed.<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>function installExtensions(extensions, dir, opt_excludeWebDriverExt) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  var hasWebDriver = !!opt_excludeWebDriverExt;<tr><td><a id="l159"></a><a href="#l159">159</a><td>  var next = 0;<tr><td><a id="l160"></a><a href="#l160">160</a><td>  var extensionDir = path.join(dir, &#39;extensions&#39;);<tr><td><a id="l161"></a><a href="#l161">161</a><td>  var done = promise.defer();<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>  return io.exists(extensionDir).then(function(exists) {<tr><td><a id="l164"></a><a href="#l164">164</a><td>    if (!exists) {<tr><td><a id="l165"></a><a href="#l165">165</a><td>      return promise.checkedNodeCall(fs.mkdir, extensionDir);<tr><td><a id="l166"></a><a href="#l166">166</a><td>    }<tr><td><a id="l167"></a><a href="#l167">167</a><td>  }).then(function() {<tr><td><a id="l168"></a><a href="#l168">168</a><td>    installNext();<tr><td><a id="l169"></a><a href="#l169">169</a><td>    return done.promise;<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>  function installNext() {<tr><td><a id="l173"></a><a href="#l173">173</a><td>    if (!done.isPending()) {<tr><td><a id="l174"></a><a href="#l174">174</a><td>      return;<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>    if (next &gt;= extensions.length) {<tr><td><a id="l178"></a><a href="#l178">178</a><td>      if (hasWebDriver) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>        done.fulfill(dir);<tr><td><a id="l180"></a><a href="#l180">180</a><td>      } else {<tr><td><a id="l181"></a><a href="#l181">181</a><td>        install(WEBDRIVER_EXTENSION_PATH);<tr><td><a id="l182"></a><a href="#l182">182</a><td>      }<tr><td><a id="l183"></a><a href="#l183">183</a><td>    } else {<tr><td><a id="l184"></a><a href="#l184">184</a><td>      install(extensions[next++]);<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>  function install(ext) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>    extension.install(ext, extensionDir).then(function(id) {<tr><td><a id="l190"></a><a href="#l190">190</a><td>      hasWebDriver = hasWebDriver || (id === WEBDRIVER_EXTENSION_NAME);<tr><td><a id="l191"></a><a href="#l191">191</a><td>      installNext();<tr><td><a id="l192"></a><a href="#l192">192</a><td>    }, done.reject);<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><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/**<tr><td><a id="l198"></a><a href="#l198">198</a><td> * Decodes a base64 encoded profile.<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @param {string} data The base64 encoded string.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the path to the decoded<tr><td><a id="l201"></a><a href="#l201">201</a><td> *     profile directory.<tr><td><a id="l202"></a><a href="#l202">202</a><td> */<tr><td><a id="l203"></a><a href="#l203">203</a><td>function decode(data) {<tr><td><a id="l204"></a><a href="#l204">204</a><td>  return io.tmpFile().then(function(file) {<tr><td><a id="l205"></a><a href="#l205">205</a><td>    var buf = new Buffer(data, &#39;base64&#39;);<tr><td><a id="l206"></a><a href="#l206">206</a><td>    return promise.checkedNodeCall(fs.writeFile, file, buf).then(function() {<tr><td><a id="l207"></a><a href="#l207">207</a><td>      return io.tmpDir();<tr><td><a id="l208"></a><a href="#l208">208</a><td>    }).then(function(dir) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>      var zip = new AdmZip(file);<tr><td><a id="l210"></a><a href="#l210">210</a><td>      zip.extractAllTo(dir);  // Sync only? Why?? :-(<tr><td><a id="l211"></a><a href="#l211">211</a><td>      return dir;<tr><td><a id="l212"></a><a href="#l212">212</a><td>    });<tr><td><a id="l213"></a><a href="#l213">213</a><td>  });<tr><td><a id="l214"></a><a href="#l214">214</a><td>}<tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td><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> * Models a Firefox proifle directory for use with the FirefoxDriver. The<tr><td><a id="l220"></a><a href="#l220">220</a><td> * {@code Proifle} directory uses an in-memory model until {@link #writeToDisk}<tr><td><a id="l221"></a><a href="#l221">221</a><td> * is called.<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @param {string=} opt_dir Path to an existing Firefox profile directory to<tr><td><a id="l223"></a><a href="#l223">223</a><td> *     use a template for this profile. If not specified, a blank profile will<tr><td><a id="l224"></a><a href="#l224">224</a><td> *     be used.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @constructor<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @extends {Serializable.&lt;string&gt;}<tr><td><a id="l227"></a><a href="#l227">227</a><td> */<tr><td><a id="l228"></a><a href="#l228">228</a><td>var Profile = function(opt_dir) {<tr><td><a id="l229"></a><a href="#l229">229</a><td>  Serializable.call(this);<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>  /** @private {!Object} */<tr><td><a id="l232"></a><a href="#l232">232</a><td>  this.preferences_ = {};<tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>  mixin(this.preferences_, getDefaultPreferences()[&#39;mutable&#39;]);<tr><td><a id="l235"></a><a href="#l235">235</a><td>  mixin(this.preferences_, getDefaultPreferences()[&#39;frozen&#39;]);<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td>  /** @private {boolean} */<tr><td><a id="l238"></a><a href="#l238">238</a><td>  this.nativeEventsEnabled_ = true;<tr><td><a id="l239"></a><a href="#l239">239</a><td><tr><td><a id="l240"></a><a href="#l240">240</a><td>  /** @private {(string|undefined)} */<tr><td><a id="l241"></a><a href="#l241">241</a><td>  this.template_ = opt_dir;<tr><td><a id="l242"></a><a href="#l242">242</a><td><tr><td><a id="l243"></a><a href="#l243">243</a><td>  /** @private {number} */<tr><td><a id="l244"></a><a href="#l244">244</a><td>  this.port_ = 0;<tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td>  /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l247"></a><a href="#l247">247</a><td>  this.extensions_ = [];<tr><td><a id="l248"></a><a href="#l248">248</a><td>};<tr><td><a id="l249"></a><a href="#l249">249</a><td>util.inherits(Profile, Serializable);<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td>/**<tr><td><a id="l253"></a><a href="#l253">253</a><td> * Registers an extension to be included with this profile.<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @param {string} extension Path to the extension to include, as either an<tr><td><a id="l255"></a><a href="#l255">255</a><td> *     unpacked extension directory or the path to a xpi file.<tr><td><a id="l256"></a><a href="#l256">256</a><td> */<tr><td><a id="l257"></a><a href="#l257">257</a><td>Profile.prototype.addExtension = function(extension) {<tr><td><a id="l258"></a><a href="#l258">258</a><td>  this.extensions_.push(extension);<tr><td><a id="l259"></a><a href="#l259">259</a><td>};<tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td>/**<tr><td><a id="l263"></a><a href="#l263">263</a><td> * Sets a desired preference for this profile.<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @param {string} key The preference key.<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @param {(string|number|boolean)} value The preference value.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @throws {Error} If attempting to set a frozen preference.<tr><td><a id="l267"></a><a href="#l267">267</a><td> */<tr><td><a id="l268"></a><a href="#l268">268</a><td>Profile.prototype.setPreference = function(key, value) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>  var frozen = getDefaultPreferences()[&#39;frozen&#39;];<tr><td><a id="l270"></a><a href="#l270">270</a><td>  if (frozen.hasOwnProperty(key) &amp;&amp; frozen[key] !== value) {<tr><td><a id="l271"></a><a href="#l271">271</a><td>    throw Error(&#39;You may not set &#39; + key + &#39;=&#39; + JSON.stringify(value)<tr><td><a id="l272"></a><a href="#l272">272</a><td>        + &#39;; value is frozen for proper WebDriver functionality (&#39;<tr><td><a id="l273"></a><a href="#l273">273</a><td>        + key + &#39;=&#39; + JSON.stringify(frozen[key]) + &#39;)&#39;);<tr><td><a id="l274"></a><a href="#l274">274</a><td>  }<tr><td><a id="l275"></a><a href="#l275">275</a><td>  this.preferences_[key] = value;<tr><td><a id="l276"></a><a href="#l276">276</a><td>};<tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td>/**<tr><td><a id="l280"></a><a href="#l280">280</a><td> * Returns the currently configured value of a profile preference. This does<tr><td><a id="l281"></a><a href="#l281">281</a><td> * not include any defaults defined in the profile&#39;s template directory user.js<tr><td><a id="l282"></a><a href="#l282">282</a><td> * file (if a template were specified on construction).<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @param {string} key The desired preference.<tr><td><a id="l284"></a><a href="#l284">284</a><td> * @return {(string|number|boolean|undefined)} The current value of the<tr><td><a id="l285"></a><a href="#l285">285</a><td> *     requested preference.<tr><td><a id="l286"></a><a href="#l286">286</a><td> */<tr><td><a id="l287"></a><a href="#l287">287</a><td>Profile.prototype.getPreference = function(key) {<tr><td><a id="l288"></a><a href="#l288">288</a><td>  return this.preferences_[key];<tr><td><a id="l289"></a><a href="#l289">289</a><td>};<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> * @return {number} The port this profile is currently configured to use, or<tr><td><a id="l294"></a><a href="#l294">294</a><td> *     0 if the port will be selected at random when the profile is written<tr><td><a id="l295"></a><a href="#l295">295</a><td> *     to disk.<tr><td><a id="l296"></a><a href="#l296">296</a><td> */<tr><td><a id="l297"></a><a href="#l297">297</a><td>Profile.prototype.getPort = function() {<tr><td><a id="l298"></a><a href="#l298">298</a><td>  return this.port_;<tr><td><a id="l299"></a><a href="#l299">299</a><td>};<tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td>/**<tr><td><a id="l303"></a><a href="#l303">303</a><td> * Sets the port to use for the WebDriver extension loaded by this profile.<tr><td><a id="l304"></a><a href="#l304">304</a><td> * @param {number} port The desired port, or 0 to use any free port.<tr><td><a id="l305"></a><a href="#l305">305</a><td> */<tr><td><a id="l306"></a><a href="#l306">306</a><td>Profile.prototype.setPort = function(port) {<tr><td><a id="l307"></a><a href="#l307">307</a><td>  this.port_ = port;<tr><td><a id="l308"></a><a href="#l308">308</a><td>};<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>/**<tr><td><a id="l312"></a><a href="#l312">312</a><td> * @return {boolean} Whether the FirefoxDriver is configured to automatically<tr><td><a id="l313"></a><a href="#l313">313</a><td> *     accept untrusted SSL certificates.<tr><td><a id="l314"></a><a href="#l314">314</a><td> */<tr><td><a id="l315"></a><a href="#l315">315</a><td>Profile.prototype.acceptUntrustedCerts = function() {<tr><td><a id="l316"></a><a href="#l316">316</a><td>  return !!this.preferences_[&#39;webdriver_accept_untrusted_certs&#39;];<tr><td><a id="l317"></a><a href="#l317">317</a><td>};<tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>/**<tr><td><a id="l321"></a><a href="#l321">321</a><td> * Sets whether the FirefoxDriver should automatically accept untrusted SSL<tr><td><a id="l322"></a><a href="#l322">322</a><td> * certificates.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @param {boolean} value .<tr><td><a id="l324"></a><a href="#l324">324</a><td> */<tr><td><a id="l325"></a><a href="#l325">325</a><td>Profile.prototype.setAcceptUntrustedCerts = function(value) {<tr><td><a id="l326"></a><a href="#l326">326</a><td>  this.preferences_[&#39;webdriver_accept_untrusted_certs&#39;] = !!value;<tr><td><a id="l327"></a><a href="#l327">327</a><td>};<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * Sets whether to assume untrusted certificates come from untrusted issuers.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @param {boolean} value .<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>Profile.prototype.setAssumeUntrustedCertIssuer = function(value) {<tr><td><a id="l335"></a><a href="#l335">335</a><td>  this.preferences_[&#39;webdriver_assume_untrusted_issuer&#39;] = !!value;<tr><td><a id="l336"></a><a href="#l336">336</a><td>};<tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td>/**<tr><td><a id="l340"></a><a href="#l340">340</a><td> * @return {boolean} Whether to assume untrusted certs come from untrusted<tr><td><a id="l341"></a><a href="#l341">341</a><td> *     issuers.<tr><td><a id="l342"></a><a href="#l342">342</a><td> */<tr><td><a id="l343"></a><a href="#l343">343</a><td>Profile.prototype.assumeUntrustedCertIssuer = function() {<tr><td><a id="l344"></a><a href="#l344">344</a><td>  return !!this.preferences_[&#39;webdriver_assume_untrusted_issuer&#39;];<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>/**<tr><td><a id="l349"></a><a href="#l349">349</a><td> * Sets whether to use native events with this profile.<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @param {boolean} enabled .<tr><td><a id="l351"></a><a href="#l351">351</a><td> */<tr><td><a id="l352"></a><a href="#l352">352</a><td>Profile.prototype.setNativeEventsEnabled = function(enabled) {<tr><td><a id="l353"></a><a href="#l353">353</a><td>  this.nativeEventsEnabled_ = enabled;<tr><td><a id="l354"></a><a href="#l354">354</a><td>};<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> * Returns whether native events are enabled in this profile.<tr><td><a id="l359"></a><a href="#l359">359</a><td> * @return {boolean} .<tr><td><a id="l360"></a><a href="#l360">360</a><td> */<tr><td><a id="l361"></a><a href="#l361">361</a><td>Profile.prototype.nativeEventsEnabled = function() {<tr><td><a id="l362"></a><a href="#l362">362</a><td>  return this.nativeEventsEnabled_;<tr><td><a id="l363"></a><a href="#l363">363</a><td>};<tr><td><a id="l364"></a><a href="#l364">364</a><td><tr><td><a id="l365"></a><a href="#l365">365</a><td><tr><td><a id="l366"></a><a href="#l366">366</a><td>/**<tr><td><a id="l367"></a><a href="#l367">367</a><td> * Writes this profile to disk.<tr><td><a id="l368"></a><a href="#l368">368</a><td> * @param {boolean=} opt_excludeWebDriverExt Whether to exclude the WebDriver<tr><td><a id="l369"></a><a href="#l369">369</a><td> *     extension from the generated profile. Used to reduce the size of an<tr><td><a id="l370"></a><a href="#l370">370</a><td> *     {@link #encode() encoded profile} since the server will always install<tr><td><a id="l371"></a><a href="#l371">371</a><td> *     the extension itself.<tr><td><a id="l372"></a><a href="#l372">372</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the path to the new<tr><td><a id="l373"></a><a href="#l373">373</a><td> *     profile directory.<tr><td><a id="l374"></a><a href="#l374">374</a><td> */<tr><td><a id="l375"></a><a href="#l375">375</a><td>Profile.prototype.writeToDisk = function(opt_excludeWebDriverExt) {<tr><td><a id="l376"></a><a href="#l376">376</a><td>  var profileDir = io.tmpDir();<tr><td><a id="l377"></a><a href="#l377">377</a><td>  if (this.template_) {<tr><td><a id="l378"></a><a href="#l378">378</a><td>    profileDir = profileDir.then(function(dir) {<tr><td><a id="l379"></a><a href="#l379">379</a><td>      return io.copyDir(<tr><td><a id="l380"></a><a href="#l380">380</a><td>          this.template_, dir, /(parent\.lock|lock|\.parentlock)/);<tr><td><a id="l381"></a><a href="#l381">381</a><td>    }.bind(this));<tr><td><a id="l382"></a><a href="#l382">382</a><td>  }<tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td>  // Freeze preferences for async operations.<tr><td><a id="l385"></a><a href="#l385">385</a><td>  var prefs = {};<tr><td><a id="l386"></a><a href="#l386">386</a><td>  mixin(prefs, this.preferences_);<tr><td><a id="l387"></a><a href="#l387">387</a><td><tr><td><a id="l388"></a><a href="#l388">388</a><td>  // Freeze extensions for async operations.<tr><td><a id="l389"></a><a href="#l389">389</a><td>  var extensions = this.extensions_.concat();<tr><td><a id="l390"></a><a href="#l390">390</a><td><tr><td><a id="l391"></a><a href="#l391">391</a><td>  return profileDir.then(function(dir) {<tr><td><a id="l392"></a><a href="#l392">392</a><td>    return writeUserPrefs(prefs, dir);<tr><td><a id="l393"></a><a href="#l393">393</a><td>  }).then(function(dir) {<tr><td><a id="l394"></a><a href="#l394">394</a><td>    return installExtensions(extensions, dir, !!opt_excludeWebDriverExt);<tr><td><a id="l395"></a><a href="#l395">395</a><td>  });<tr><td><a id="l396"></a><a href="#l396">396</a><td>};<tr><td><a id="l397"></a><a href="#l397">397</a><td><tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td>/**<tr><td><a id="l400"></a><a href="#l400">400</a><td> * Encodes this profile as a zipped, base64 encoded directory.<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the encoded profile.<tr><td><a id="l402"></a><a href="#l402">402</a><td> */<tr><td><a id="l403"></a><a href="#l403">403</a><td>Profile.prototype.encode = function() {<tr><td><a id="l404"></a><a href="#l404">404</a><td>  return this.writeToDisk(true).then(function(dir) {<tr><td><a id="l405"></a><a href="#l405">405</a><td>    var zip = new AdmZip();<tr><td><a id="l406"></a><a href="#l406">406</a><td>    zip.addLocalFolder(dir, &#39;&#39;);<tr><td><a id="l407"></a><a href="#l407">407</a><td>    zip.getEntries()[0].header.method = AdmConstants.STORED;<tr><td><a id="l408"></a><a href="#l408">408</a><td>    return io.tmpFile().then(function(file) {<tr><td><a id="l409"></a><a href="#l409">409</a><td>      zip.writeZip(file);  // Sync! Why oh why :-(<tr><td><a id="l410"></a><a href="#l410">410</a><td>      return promise.checkedNodeCall(fs.readFile, file);<tr><td><a id="l411"></a><a href="#l411">411</a><td>    });<tr><td><a id="l412"></a><a href="#l412">412</a><td>  }).then(function(data) {<tr><td><a id="l413"></a><a href="#l413">413</a><td>    return new Buffer(data).toString(&#39;base64&#39;);<tr><td><a id="l414"></a><a href="#l414">414</a><td>  });<tr><td><a id="l415"></a><a href="#l415">415</a><td>};<tr><td><a id="l416"></a><a href="#l416">416</a><td><tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td>/**<tr><td><a id="l419"></a><a href="#l419">419</a><td> * Encodes this profile as a zipped, base64 encoded directory.<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the encoded profile.<tr><td><a id="l421"></a><a href="#l421">421</a><td> * @override<tr><td><a id="l422"></a><a href="#l422">422</a><td> */<tr><td><a id="l423"></a><a href="#l423">423</a><td>Profile.prototype.serialize = function() {<tr><td><a id="l424"></a><a href="#l424">424</a><td>  return this.encode();<tr><td><a id="l425"></a><a href="#l425">425</a><td>};<tr><td><a id="l426"></a><a href="#l426">426</a><td><tr><td><a id="l427"></a><a href="#l427">427</a><td><tr><td><a id="l428"></a><a href="#l428">428</a><td>// PUBLIC API<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td>exports.Profile = Profile;<tr><td><a id="l432"></a><a href="#l432">432</a><td>exports.decode = decode;<tr><td><a id="l433"></a><a href="#l433">433</a><td>exports.loadUserPrefs = loadUserPrefs;</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>
\ No newline at end of file
diff --git a/docs/source/http/index.js.src.html b/docs/source/http/index.js.src.html
index 44e2cb2..f99eaa9 100644
--- a/docs/source/http/index.js.src.html
+++ b/docs/source/http/index.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>index.js</title><link href="../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>http/index.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Defines a the {@code webdriver.http.Client} for use with<tr><td><a name="l17" href="#l17">17</a><td> * NodeJS.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>var http = require(&#39;http&#39;),<tr><td><a name="l21" href="#l21">21</a><td>    url = require(&#39;url&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>var base = require(&#39;../_base&#39;),<tr><td><a name="l24" href="#l24">24</a><td>    HttpResponse = base.require(&#39;webdriver.http.Response&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td>/**<tr><td><a name="l28" href="#l28">28</a><td> * A {@link webdriver.http.Client} implementation using Node&#39;s built-in http<tr><td><a name="l29" href="#l29">29</a><td> * module.<tr><td><a name="l30" href="#l30">30</a><td> * @param {string} serverUrl URL for the WebDriver server to send commands to.<tr><td><a name="l31" href="#l31">31</a><td> * @constructor<tr><td><a name="l32" href="#l32">32</a><td> * @implements {webdriver.http.Client}<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td>var HttpClient = function(serverUrl) {<tr><td><a name="l35" href="#l35">35</a><td>  var parsedUrl = url.parse(serverUrl);<tr><td><a name="l36" href="#l36">36</a><td>  if (!parsedUrl.hostname) {<tr><td><a name="l37" href="#l37">37</a><td>    throw new Error(&#39;Invalid server URL: &#39; + serverUrl);<tr><td><a name="l38" href="#l38">38</a><td>  }<tr><td><a name="l39" href="#l39">39</a><td><tr><td><a name="l40" href="#l40">40</a><td>  /**<tr><td><a name="l41" href="#l41">41</a><td>   * Base options for each request.<tr><td><a name="l42" href="#l42">42</a><td>   * @private {!Object}<tr><td><a name="l43" href="#l43">43</a><td>   */<tr><td><a name="l44" href="#l44">44</a><td>  this.options_ = {<tr><td><a name="l45" href="#l45">45</a><td>    host: parsedUrl.hostname,<tr><td><a name="l46" href="#l46">46</a><td>    path: parsedUrl.pathname,<tr><td><a name="l47" href="#l47">47</a><td>    port: parsedUrl.port<tr><td><a name="l48" href="#l48">48</a><td>  };<tr><td><a name="l49" href="#l49">49</a><td>};<tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td>/** @override */<tr><td><a name="l53" href="#l53">53</a><td>HttpClient.prototype.send = function(httpRequest, callback) {<tr><td><a name="l54" href="#l54">54</a><td>  var data;<tr><td><a name="l55" href="#l55">55</a><td>  httpRequest.headers[&#39;Content-Length&#39;] = 0;<tr><td><a name="l56" href="#l56">56</a><td>  if (httpRequest.method == &#39;POST&#39; || httpRequest.method == &#39;PUT&#39;) {<tr><td><a name="l57" href="#l57">57</a><td>    data = JSON.stringify(httpRequest.data);<tr><td><a name="l58" href="#l58">58</a><td>    httpRequest.headers[&#39;Content-Length&#39;] = Buffer.byteLength(data, &#39;utf8&#39;);<tr><td><a name="l59" href="#l59">59</a><td>    httpRequest.headers[&#39;Content-Type&#39;] = &#39;application/json;charset=UTF-8&#39;;<tr><td><a name="l60" href="#l60">60</a><td>  }<tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td>  var path = this.options_.path;<tr><td><a name="l63" href="#l63">63</a><td>  if (path[path.length - 1] === &#39;/&#39; &amp;&amp; httpRequest.path[0] === &#39;/&#39;) {<tr><td><a name="l64" href="#l64">64</a><td>    path += httpRequest.path.substring(1);<tr><td><a name="l65" href="#l65">65</a><td>  } else {<tr><td><a name="l66" href="#l66">66</a><td>    path += httpRequest.path;<tr><td><a name="l67" href="#l67">67</a><td>  }<tr><td><a name="l68" href="#l68">68</a><td><tr><td><a name="l69" href="#l69">69</a><td>  sendRequest({<tr><td><a name="l70" href="#l70">70</a><td>    method: httpRequest.method,<tr><td><a name="l71" href="#l71">71</a><td>    host: this.options_.host,<tr><td><a name="l72" href="#l72">72</a><td>    port: this.options_.port,<tr><td><a name="l73" href="#l73">73</a><td>    path: path,<tr><td><a name="l74" href="#l74">74</a><td>    headers: httpRequest.headers<tr><td><a name="l75" href="#l75">75</a><td>  }, callback, data);<tr><td><a name="l76" href="#l76">76</a><td>};<tr><td><a name="l77" href="#l77">77</a><td><tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td>/**<tr><td><a name="l80" href="#l80">80</a><td> * Sends a single HTTP request.<tr><td><a name="l81" href="#l81">81</a><td> * @param {!Object} options The request options.<tr><td><a name="l82" href="#l82">82</a><td> * @param {function(Error, !webdriver.http.Response=)} callback The function to<tr><td><a name="l83" href="#l83">83</a><td> *     invoke with the server&#39;s response.<tr><td><a name="l84" href="#l84">84</a><td> * @param {string=} opt_data The data to send with the request.<tr><td><a name="l85" href="#l85">85</a><td> */<tr><td><a name="l86" href="#l86">86</a><td>var sendRequest = function(options, callback, opt_data) {<tr><td><a name="l87" href="#l87">87</a><td>  var request = http.request(options, function(response) {<tr><td><a name="l88" href="#l88">88</a><td>    if (response.statusCode == 302 || response.statusCode == 303) {<tr><td><a name="l89" href="#l89">89</a><td>      var location = url.parse(response.headers[&#39;location&#39;]);<tr><td><a name="l90" href="#l90">90</a><td><tr><td><a name="l91" href="#l91">91</a><td>      if (!location.hostname) {<tr><td><a name="l92" href="#l92">92</a><td>        location.hostname = options.host;<tr><td><a name="l93" href="#l93">93</a><td>        location.port = options.port;<tr><td><a name="l94" href="#l94">94</a><td>      }<tr><td><a name="l95" href="#l95">95</a><td><tr><td><a name="l96" href="#l96">96</a><td>      request.abort();<tr><td><a name="l97" href="#l97">97</a><td>      sendRequest({<tr><td><a name="l98" href="#l98">98</a><td>        method: &#39;GET&#39;,<tr><td><a name="l99" href="#l99">99</a><td>        host: location.hostname,<tr><td><a name="l100" href="#l100">100</a><td>        path: location.pathname + (location.search || &#39;&#39;),<tr><td><a name="l101" href="#l101">101</a><td>        port: location.port,<tr><td><a name="l102" href="#l102">102</a><td>        headers: {<tr><td><a name="l103" href="#l103">103</a><td>          &#39;Accept&#39;: &#39;application/json; charset=utf-8&#39;<tr><td><a name="l104" href="#l104">104</a><td>        }<tr><td><a name="l105" href="#l105">105</a><td>      }, callback);<tr><td><a name="l106" href="#l106">106</a><td>      return;<tr><td><a name="l107" href="#l107">107</a><td>    }<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td>    var body = [];<tr><td><a name="l110" href="#l110">110</a><td>    response.on(&#39;data&#39;, body.push.bind(body));<tr><td><a name="l111" href="#l111">111</a><td>    response.on(&#39;end&#39;, function() {<tr><td><a name="l112" href="#l112">112</a><td>      var resp = new HttpResponse(response.statusCode,<tr><td><a name="l113" href="#l113">113</a><td>          response.headers, body.join(&#39;&#39;).replace(/\0/g, &#39;&#39;));<tr><td><a name="l114" href="#l114">114</a><td>      callback(null, resp);<tr><td><a name="l115" href="#l115">115</a><td>    });<tr><td><a name="l116" href="#l116">116</a><td>  });<tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td>  request.on(&#39;error&#39;, function(e) {<tr><td><a name="l119" href="#l119">119</a><td>    if (e.code === &#39;ECONNRESET&#39;) {<tr><td><a name="l120" href="#l120">120</a><td>      setTimeout(function() {<tr><td><a name="l121" href="#l121">121</a><td>        sendRequest(options, callback, opt_data);<tr><td><a name="l122" href="#l122">122</a><td>      }, 15);<tr><td><a name="l123" href="#l123">123</a><td>    } else {<tr><td><a name="l124" href="#l124">124</a><td>      var message = e.message;<tr><td><a name="l125" href="#l125">125</a><td>      if (e.code) {<tr><td><a name="l126" href="#l126">126</a><td>        message = e.code + &#39; &#39; + message;<tr><td><a name="l127" href="#l127">127</a><td>      }<tr><td><a name="l128" href="#l128">128</a><td>      callback(new Error(message));<tr><td><a name="l129" href="#l129">129</a><td>    }<tr><td><a name="l130" href="#l130">130</a><td>  });<tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td>  if (opt_data) {<tr><td><a name="l133" href="#l133">133</a><td>    request.write(opt_data);<tr><td><a name="l134" href="#l134">134</a><td>  }<tr><td><a name="l135" href="#l135">135</a><td><tr><td><a name="l136" href="#l136">136</a><td>  request.end();<tr><td><a name="l137" href="#l137">137</a><td>};<tr><td><a name="l138" href="#l138">138</a><td><tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td>// PUBLIC API<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td>/** @type {webdriver.http.Executor.} */<tr><td><a name="l143" href="#l143">143</a><td>exports.Executor = base.require(&#39;webdriver.http.Executor&#39;);<tr><td><a name="l144" href="#l144">144</a><td><tr><td><a name="l145" href="#l145">145</a><td>/** @type {webdriver.http.Request.} */<tr><td><a name="l146" href="#l146">146</a><td>exports.Request = base.require(&#39;webdriver.http.Request&#39;);<tr><td><a name="l147" href="#l147">147</a><td><tr><td><a name="l148" href="#l148">148</a><td>/** @type {webdriver.http.Response.} */<tr><td><a name="l149" href="#l149">149</a><td>exports.Response = base.require(&#39;webdriver.http.Response&#39;);<tr><td><a name="l150" href="#l150">150</a><td><tr><td><a name="l151" href="#l151">151</a><td>exports.HttpClient = HttpClient;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../types.js"></script><script src="../../dossier.js"></script>
\ No newline at end of file
+<!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>index.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>http/index.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines the {@code webdriver.http.Client} for use with<tr><td><a id="l20"></a><a href="#l20">20</a><td> * NodeJS.<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>var http = require(&#39;http&#39;),<tr><td><a id="l24"></a><a href="#l24">24</a><td>    url = require(&#39;url&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>var base = require(&#39;../_base&#39;),<tr><td><a id="l27"></a><a href="#l27">27</a><td>    HttpResponse = base.require(&#39;webdriver.http.Response&#39;);<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> * A {@link webdriver.http.Client} implementation using Node&#39;s built-in http<tr><td><a id="l32"></a><a href="#l32">32</a><td> * module.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {string} serverUrl URL for the WebDriver server to send commands to.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {http.Agent=} opt_agent The agent to use for each request.<tr><td><a id="l35"></a><a href="#l35">35</a><td> *     Defaults to {@code http.globalAgent}.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @param {string=} opt_proxy The proxy to use for the connection to the server.<tr><td><a id="l37"></a><a href="#l37">37</a><td> *     Default is to use no proxy.<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> * @implements {webdriver.http.Client}<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>var HttpClient = function(serverUrl, opt_agent, opt_proxy) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  var parsedUrl = url.parse(serverUrl);<tr><td><a id="l43"></a><a href="#l43">43</a><td>  if (!parsedUrl.hostname) {<tr><td><a id="l44"></a><a href="#l44">44</a><td>    throw new Error(&#39;Invalid server URL: &#39; + serverUrl);<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>  /** @private {http.Agent} */<tr><td><a id="l48"></a><a href="#l48">48</a><td>  this.agent_ = opt_agent;<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td>  /** @private {string} */<tr><td><a id="l51"></a><a href="#l51">51</a><td>  this.proxy_ = opt_proxy;<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>  /**<tr><td><a id="l54"></a><a href="#l54">54</a><td>   * Base options for each request.<tr><td><a id="l55"></a><a href="#l55">55</a><td>   * @private {!Object}<tr><td><a id="l56"></a><a href="#l56">56</a><td>   */<tr><td><a id="l57"></a><a href="#l57">57</a><td>  this.options_ = {<tr><td><a id="l58"></a><a href="#l58">58</a><td>    auth: parsedUrl.auth,<tr><td><a id="l59"></a><a href="#l59">59</a><td>    host: parsedUrl.hostname,<tr><td><a id="l60"></a><a href="#l60">60</a><td>    path: parsedUrl.pathname,<tr><td><a id="l61"></a><a href="#l61">61</a><td>    port: parsedUrl.port<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><tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td>/** @override */<tr><td><a id="l67"></a><a href="#l67">67</a><td>HttpClient.prototype.send = function(httpRequest, callback) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  var data;<tr><td><a id="l69"></a><a href="#l69">69</a><td>  httpRequest.headers[&#39;Content-Length&#39;] = 0;<tr><td><a id="l70"></a><a href="#l70">70</a><td>  if (httpRequest.method == &#39;POST&#39; || httpRequest.method == &#39;PUT&#39;) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>    data = JSON.stringify(httpRequest.data);<tr><td><a id="l72"></a><a href="#l72">72</a><td>    httpRequest.headers[&#39;Content-Length&#39;] = Buffer.byteLength(data, &#39;utf8&#39;);<tr><td><a id="l73"></a><a href="#l73">73</a><td>    httpRequest.headers[&#39;Content-Type&#39;] = &#39;application/json;charset=UTF-8&#39;;<tr><td><a id="l74"></a><a href="#l74">74</a><td>  }<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>  var path = this.options_.path;<tr><td><a id="l77"></a><a href="#l77">77</a><td>  if (path[path.length - 1] === &#39;/&#39; &amp;&amp; httpRequest.path[0] === &#39;/&#39;) {<tr><td><a id="l78"></a><a href="#l78">78</a><td>    path += httpRequest.path.substring(1);<tr><td><a id="l79"></a><a href="#l79">79</a><td>  } else {<tr><td><a id="l80"></a><a href="#l80">80</a><td>    path += httpRequest.path;<tr><td><a id="l81"></a><a href="#l81">81</a><td>  }<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>  var options = {<tr><td><a id="l84"></a><a href="#l84">84</a><td>    method: httpRequest.method,<tr><td><a id="l85"></a><a href="#l85">85</a><td>    auth: this.options_.auth,<tr><td><a id="l86"></a><a href="#l86">86</a><td>    host: this.options_.host,<tr><td><a id="l87"></a><a href="#l87">87</a><td>    port: this.options_.port,<tr><td><a id="l88"></a><a href="#l88">88</a><td>    path: path,<tr><td><a id="l89"></a><a href="#l89">89</a><td>    headers: httpRequest.headers<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>  if (this.agent_) {<tr><td><a id="l93"></a><a href="#l93">93</a><td>    options.agent = this.agent_;<tr><td><a id="l94"></a><a href="#l94">94</a><td>  }<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>  sendRequest(options, callback, data, this.proxy_);<tr><td><a id="l97"></a><a href="#l97">97</a><td>};<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * Sends a single HTTP request.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @param {!Object} options The request options.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @param {function(Error, !webdriver.http.Response=)} callback The function to<tr><td><a id="l104"></a><a href="#l104">104</a><td> *     invoke with the server&#39;s response.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {string=} opt_data The data to send with the request.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @param {string=} opt_proxy The proxy server to use for the request.<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td>var sendRequest = function(options, callback, opt_data, opt_proxy) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>  var host = options.host;<tr><td><a id="l110"></a><a href="#l110">110</a><td>  var port = options.port;<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>  if (opt_proxy) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>    var proxy = url.parse(opt_proxy);<tr><td><a id="l114"></a><a href="#l114">114</a><td><tr><td><a id="l115"></a><a href="#l115">115</a><td>    options.headers[&#39;Host&#39;] = options.host;<tr><td><a id="l116"></a><a href="#l116">116</a><td>    options.host = proxy.hostname;<tr><td><a id="l117"></a><a href="#l117">117</a><td>    options.port = proxy.port;<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td>    if (proxy.auth) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>      options.headers[&#39;Proxy-Authorization&#39;] =<tr><td><a id="l121"></a><a href="#l121">121</a><td>          &#39;Basic &#39; + new Buffer(proxy.auth).toString(&#39;base64&#39;);<tr><td><a id="l122"></a><a href="#l122">122</a><td>    }<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>  var request = http.request(options, function(response) {<tr><td><a id="l126"></a><a href="#l126">126</a><td>    if (response.statusCode == 302 || response.statusCode == 303) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>      try {<tr><td><a id="l128"></a><a href="#l128">128</a><td>        var location = url.parse(response.headers[&#39;location&#39;]);<tr><td><a id="l129"></a><a href="#l129">129</a><td>      } catch (ex) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>        callback(Error(<tr><td><a id="l131"></a><a href="#l131">131</a><td>            &#39;Failed to parse &quot;Location&quot; header for server redirect: &#39; +<tr><td><a id="l132"></a><a href="#l132">132</a><td>            ex.message + &#39;\nResponse was: \n&#39; +<tr><td><a id="l133"></a><a href="#l133">133</a><td>            new HttpResponse(response.statusCode, response.headers, &#39;&#39;)));<tr><td><a id="l134"></a><a href="#l134">134</a><td>        return;<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>      if (!location.hostname) {<tr><td><a id="l138"></a><a href="#l138">138</a><td>        location.hostname = host;<tr><td><a id="l139"></a><a href="#l139">139</a><td>        location.port = port;<tr><td><a id="l140"></a><a href="#l140">140</a><td>      }<tr><td><a id="l141"></a><a href="#l141">141</a><td><tr><td><a id="l142"></a><a href="#l142">142</a><td>      request.abort();<tr><td><a id="l143"></a><a href="#l143">143</a><td>      sendRequest({<tr><td><a id="l144"></a><a href="#l144">144</a><td>        method: &#39;GET&#39;,<tr><td><a id="l145"></a><a href="#l145">145</a><td>        host: location.hostname,<tr><td><a id="l146"></a><a href="#l146">146</a><td>        path: location.pathname + (location.search || &#39;&#39;),<tr><td><a id="l147"></a><a href="#l147">147</a><td>        port: location.port,<tr><td><a id="l148"></a><a href="#l148">148</a><td>        headers: {<tr><td><a id="l149"></a><a href="#l149">149</a><td>          &#39;Accept&#39;: &#39;application/json; charset=utf-8&#39;<tr><td><a id="l150"></a><a href="#l150">150</a><td>        }<tr><td><a id="l151"></a><a href="#l151">151</a><td>      }, callback, undefined, opt_proxy);<tr><td><a id="l152"></a><a href="#l152">152</a><td>      return;<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>    var body = [];<tr><td><a id="l156"></a><a href="#l156">156</a><td>    response.on(&#39;data&#39;, body.push.bind(body));<tr><td><a id="l157"></a><a href="#l157">157</a><td>    response.on(&#39;end&#39;, function() {<tr><td><a id="l158"></a><a href="#l158">158</a><td>      var resp = new HttpResponse(response.statusCode,<tr><td><a id="l159"></a><a href="#l159">159</a><td>          response.headers, body.join(&#39;&#39;).replace(/\0/g, &#39;&#39;));<tr><td><a id="l160"></a><a href="#l160">160</a><td>      callback(null, resp);<tr><td><a id="l161"></a><a href="#l161">161</a><td>    });<tr><td><a id="l162"></a><a href="#l162">162</a><td>  });<tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>  request.on(&#39;error&#39;, function(e) {<tr><td><a id="l165"></a><a href="#l165">165</a><td>    if (e.code === &#39;ECONNRESET&#39;) {<tr><td><a id="l166"></a><a href="#l166">166</a><td>      setTimeout(function() {<tr><td><a id="l167"></a><a href="#l167">167</a><td>        sendRequest(options, callback, opt_data, opt_proxy);<tr><td><a id="l168"></a><a href="#l168">168</a><td>      }, 15);<tr><td><a id="l169"></a><a href="#l169">169</a><td>    } else {<tr><td><a id="l170"></a><a href="#l170">170</a><td>      var message = e.message;<tr><td><a id="l171"></a><a href="#l171">171</a><td>      if (e.code) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>        message = e.code + &#39; &#39; + message;<tr><td><a id="l173"></a><a href="#l173">173</a><td>      }<tr><td><a id="l174"></a><a href="#l174">174</a><td>      callback(new Error(message));<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>  if (opt_data) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>    request.write(opt_data);<tr><td><a id="l180"></a><a href="#l180">180</a><td>  }<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td>  request.end();<tr><td><a id="l183"></a><a href="#l183">183</a><td>};<tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td>// PUBLIC API<tr><td><a id="l187"></a><a href="#l187">187</a><td><tr><td><a id="l188"></a><a href="#l188">188</a><td>/** @type {webdriver.http.Executor.} */<tr><td><a id="l189"></a><a href="#l189">189</a><td>exports.Executor = base.require(&#39;webdriver.http.Executor&#39;);<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td>/** @type {webdriver.http.Request.} */<tr><td><a id="l192"></a><a href="#l192">192</a><td>exports.Request = base.require(&#39;webdriver.http.Request&#39;);<tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td>/** @type {webdriver.http.Response.} */<tr><td><a id="l195"></a><a href="#l195">195</a><td>exports.Response = base.require(&#39;webdriver.http.Response&#39;);<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>exports.HttpClient = HttpClient;</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>
\ No newline at end of file
diff --git a/docs/source/http/util.js.src.html b/docs/source/http/util.js.src.html
index f4b4915..e0a159c 100644
--- a/docs/source/http/util.js.src.html
+++ b/docs/source/http/util.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>util.js</title><link href="../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>http/util.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview Various HTTP utilities.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>var base = require(&#39;../_base&#39;),<tr><td><a name="l21" href="#l21">21</a><td>    HttpClient = require(&#39;./index&#39;).HttpClient,<tr><td><a name="l22" href="#l22">22</a><td>    checkResponse = base.require(&#39;bot.response&#39;).checkResponse,<tr><td><a name="l23" href="#l23">23</a><td>    Executor = base.require(&#39;webdriver.http.Executor&#39;),<tr><td><a name="l24" href="#l24">24</a><td>    HttpRequest = base.require(&#39;webdriver.http.Request&#39;),<tr><td><a name="l25" href="#l25">25</a><td>    Command = base.require(&#39;webdriver.Command&#39;),<tr><td><a name="l26" href="#l26">26</a><td>    CommandName = base.require(&#39;webdriver.CommandName&#39;),<tr><td><a name="l27" href="#l27">27</a><td>    promise = base.require(&#39;webdriver.promise&#39;);<tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>/**<tr><td><a name="l32" href="#l32">32</a><td> * Queries a WebDriver server for its current status.<tr><td><a name="l33" href="#l33">33</a><td> * @param {string} url Base URL of the server to query.<tr><td><a name="l34" href="#l34">34</a><td> * @param {function(Error, *=)} callback The function to call with the<tr><td><a name="l35" href="#l35">35</a><td> *     response.<tr><td><a name="l36" href="#l36">36</a><td> */<tr><td><a name="l37" href="#l37">37</a><td>function getStatus(url, callback) {<tr><td><a name="l38" href="#l38">38</a><td>  var client = new HttpClient(url);<tr><td><a name="l39" href="#l39">39</a><td>  var executor = new Executor(client);<tr><td><a name="l40" href="#l40">40</a><td>  var command = new Command(CommandName.GET_SERVER_STATUS);<tr><td><a name="l41" href="#l41">41</a><td>  executor.execute(command, function(err, responseObj) {<tr><td><a name="l42" href="#l42">42</a><td>    if (err) return callback(err);<tr><td><a name="l43" href="#l43">43</a><td>    try {<tr><td><a name="l44" href="#l44">44</a><td>      checkResponse(responseObj);<tr><td><a name="l45" href="#l45">45</a><td>    } catch (ex) {<tr><td><a name="l46" href="#l46">46</a><td>      return callback(ex);<tr><td><a name="l47" href="#l47">47</a><td>    }<tr><td><a name="l48" href="#l48">48</a><td>    callback(null, responseObj[&#39;value&#39;]);<tr><td><a name="l49" href="#l49">49</a><td>  });<tr><td><a name="l50" href="#l50">50</a><td>}<tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>// PUBLIC API<tr><td><a name="l54" href="#l54">54</a><td><tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td>/**<tr><td><a name="l57" href="#l57">57</a><td> * Queries a WebDriver server for its current status.<tr><td><a name="l58" href="#l58">58</a><td> * @param {string} url Base URL of the server to query.<tr><td><a name="l59" href="#l59">59</a><td> * @return {!webdriver.promise.Promise.&lt;!Object&gt;} A promise that resolves with<tr><td><a name="l60" href="#l60">60</a><td> *     a hash of the server status.<tr><td><a name="l61" href="#l61">61</a><td> */<tr><td><a name="l62" href="#l62">62</a><td>exports.getStatus = function(url) {<tr><td><a name="l63" href="#l63">63</a><td>  return promise.checkedNodeCall(getStatus.bind(null, url));<tr><td><a name="l64" href="#l64">64</a><td>};<tr><td><a name="l65" href="#l65">65</a><td><tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td>/**<tr><td><a name="l68" href="#l68">68</a><td> * Waits for a WebDriver server to be healthy and accepting requests.<tr><td><a name="l69" href="#l69">69</a><td> * @param {string} url Base URL of the server to query.<tr><td><a name="l70" href="#l70">70</a><td> * @param {number} timeout How long to wait for the server.<tr><td><a name="l71" href="#l71">71</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve when the<tr><td><a name="l72" href="#l72">72</a><td> *     server is ready.<tr><td><a name="l73" href="#l73">73</a><td> */<tr><td><a name="l74" href="#l74">74</a><td>exports.waitForServer = function(url, timeout) {<tr><td><a name="l75" href="#l75">75</a><td>  var ready = promise.defer(),<tr><td><a name="l76" href="#l76">76</a><td>      start = Date.now(),<tr><td><a name="l77" href="#l77">77</a><td>      checkServerStatus = getStatus.bind(null, url, onResponse);<tr><td><a name="l78" href="#l78">78</a><td>  checkServerStatus();<tr><td><a name="l79" href="#l79">79</a><td>  return ready.promise;<tr><td><a name="l80" href="#l80">80</a><td><tr><td><a name="l81" href="#l81">81</a><td>  function onResponse(err) {<tr><td><a name="l82" href="#l82">82</a><td>    if (!ready.isPending()) return;<tr><td><a name="l83" href="#l83">83</a><td>    if (!err) return ready.fulfill();<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td>    if (Date.now() - start &gt; timeout) {<tr><td><a name="l86" href="#l86">86</a><td>      ready.reject(<tr><td><a name="l87" href="#l87">87</a><td>          Error(&#39;Timed out waiting for the WebDriver server at &#39; + url));<tr><td><a name="l88" href="#l88">88</a><td>    } else {<tr><td><a name="l89" href="#l89">89</a><td>      setTimeout(function() {<tr><td><a name="l90" href="#l90">90</a><td>        if (ready.isPending()) {<tr><td><a name="l91" href="#l91">91</a><td>          checkServerStatus();<tr><td><a name="l92" href="#l92">92</a><td>        }<tr><td><a name="l93" href="#l93">93</a><td>      }, 50);<tr><td><a name="l94" href="#l94">94</a><td>    }<tr><td><a name="l95" href="#l95">95</a><td>  }<tr><td><a name="l96" href="#l96">96</a><td>};<tr><td><a name="l97" href="#l97">97</a><td><tr><td><a name="l98" href="#l98">98</a><td><tr><td><a name="l99" href="#l99">99</a><td>/**<tr><td><a name="l100" href="#l100">100</a><td> * Polls a URL with GET requests until it returns a 2xx response or the<tr><td><a name="l101" href="#l101">101</a><td> * timeout expires.<tr><td><a name="l102" href="#l102">102</a><td> * @param {string} url The URL to poll.<tr><td><a name="l103" href="#l103">103</a><td> * @param {number} timeout How long to wait, in milliseconds.<tr><td><a name="l104" href="#l104">104</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve when the<tr><td><a name="l105" href="#l105">105</a><td> *     URL responds with 2xx.<tr><td><a name="l106" href="#l106">106</a><td> */<tr><td><a name="l107" href="#l107">107</a><td>exports.waitForUrl = function(url, timeout) {<tr><td><a name="l108" href="#l108">108</a><td>  var client = new HttpClient(url),<tr><td><a name="l109" href="#l109">109</a><td>      request = new HttpRequest(&#39;GET&#39;, &#39;&#39;),<tr><td><a name="l110" href="#l110">110</a><td>      testUrl = client.send.bind(client, request, onResponse),<tr><td><a name="l111" href="#l111">111</a><td>      ready = promise.defer(),<tr><td><a name="l112" href="#l112">112</a><td>      start = Date.now();<tr><td><a name="l113" href="#l113">113</a><td>  testUrl();<tr><td><a name="l114" href="#l114">114</a><td>  return ready.promise;<tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td>  function onResponse(err, response) {<tr><td><a name="l117" href="#l117">117</a><td>    if (!ready.isPending()) return;<tr><td><a name="l118" href="#l118">118</a><td>    if (!err &amp;&amp; response.status &gt; 199 &amp;&amp; response.status &lt; 300) {<tr><td><a name="l119" href="#l119">119</a><td>      return ready.fulfill();<tr><td><a name="l120" href="#l120">120</a><td>    }<tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td>    if (Date.now() - start &gt; timeout) {<tr><td><a name="l123" href="#l123">123</a><td>      ready.reject(Error(<tr><td><a name="l124" href="#l124">124</a><td>          &#39;Timed out waiting for the URL to return 2xx: &#39; + url));<tr><td><a name="l125" href="#l125">125</a><td>    } else {<tr><td><a name="l126" href="#l126">126</a><td>      setTimeout(function() {<tr><td><a name="l127" href="#l127">127</a><td>        if (ready.isPending()) {<tr><td><a name="l128" href="#l128">128</a><td>          testUrl();<tr><td><a name="l129" href="#l129">129</a><td>        }<tr><td><a name="l130" href="#l130">130</a><td>      }, 50);<tr><td><a name="l131" href="#l131">131</a><td>    }<tr><td><a name="l132" href="#l132">132</a><td>  }<tr><td><a name="l133" href="#l133">133</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../types.js"></script><script src="../../dossier.js"></script>
\ No newline at end of file
+<!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>util.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>http/util.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Various HTTP utilities.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>var base = require(&#39;../_base&#39;),<tr><td><a id="l23"></a><a href="#l23">23</a><td>    HttpClient = require(&#39;./index&#39;).HttpClient,<tr><td><a id="l24"></a><a href="#l24">24</a><td>    checkResponse = base.require(&#39;bot.response&#39;).checkResponse,<tr><td><a id="l25"></a><a href="#l25">25</a><td>    Executor = base.require(&#39;webdriver.http.Executor&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td>    HttpRequest = base.require(&#39;webdriver.http.Request&#39;),<tr><td><a id="l27"></a><a href="#l27">27</a><td>    Command = base.require(&#39;webdriver.Command&#39;),<tr><td><a id="l28"></a><a href="#l28">28</a><td>    CommandName = base.require(&#39;webdriver.CommandName&#39;),<tr><td><a id="l29"></a><a href="#l29">29</a><td>    promise = base.require(&#39;webdriver.promise&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * Queries a WebDriver server for its current status.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {string} url Base URL of the server to query.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @param {function(Error, *=)} callback The function to call with the<tr><td><a id="l37"></a><a href="#l37">37</a><td> *     response.<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>function getStatus(url, callback) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>  var client = new HttpClient(url);<tr><td><a id="l41"></a><a href="#l41">41</a><td>  var executor = new Executor(client);<tr><td><a id="l42"></a><a href="#l42">42</a><td>  var command = new Command(CommandName.GET_SERVER_STATUS);<tr><td><a id="l43"></a><a href="#l43">43</a><td>  executor.execute(command, function(err, responseObj) {<tr><td><a id="l44"></a><a href="#l44">44</a><td>    if (err) return callback(err);<tr><td><a id="l45"></a><a href="#l45">45</a><td>    try {<tr><td><a id="l46"></a><a href="#l46">46</a><td>      checkResponse(responseObj);<tr><td><a id="l47"></a><a href="#l47">47</a><td>    } catch (ex) {<tr><td><a id="l48"></a><a href="#l48">48</a><td>      return callback(ex);<tr><td><a id="l49"></a><a href="#l49">49</a><td>    }<tr><td><a id="l50"></a><a href="#l50">50</a><td>    callback(null, responseObj[&#39;value&#39;]);<tr><td><a id="l51"></a><a href="#l51">51</a><td>  });<tr><td><a id="l52"></a><a href="#l52">52</a><td>}<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>// PUBLIC API<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> * Queries a WebDriver server for its current status.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {string} url Base URL of the server to query.<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @return {!webdriver.promise.Promise.&lt;!Object&gt;} A promise that resolves with<tr><td><a id="l62"></a><a href="#l62">62</a><td> *     a hash of the server status.<tr><td><a id="l63"></a><a href="#l63">63</a><td> */<tr><td><a id="l64"></a><a href="#l64">64</a><td>exports.getStatus = function(url) {<tr><td><a id="l65"></a><a href="#l65">65</a><td>  return promise.checkedNodeCall(getStatus.bind(null, url));<tr><td><a id="l66"></a><a href="#l66">66</a><td>};<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>/**<tr><td><a id="l70"></a><a href="#l70">70</a><td> * Waits for a WebDriver server to be healthy and accepting requests.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @param {string} url Base URL of the server to query.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @param {number} timeout How long to wait for the server.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve when the<tr><td><a id="l74"></a><a href="#l74">74</a><td> *     server is ready.<tr><td><a id="l75"></a><a href="#l75">75</a><td> */<tr><td><a id="l76"></a><a href="#l76">76</a><td>exports.waitForServer = function(url, timeout) {<tr><td><a id="l77"></a><a href="#l77">77</a><td>  var ready = promise.defer(),<tr><td><a id="l78"></a><a href="#l78">78</a><td>      start = Date.now(),<tr><td><a id="l79"></a><a href="#l79">79</a><td>      checkServerStatus = getStatus.bind(null, url, onResponse);<tr><td><a id="l80"></a><a href="#l80">80</a><td>  checkServerStatus();<tr><td><a id="l81"></a><a href="#l81">81</a><td>  return ready.promise;<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>  function onResponse(err) {<tr><td><a id="l84"></a><a href="#l84">84</a><td>    if (!ready.isPending()) return;<tr><td><a id="l85"></a><a href="#l85">85</a><td>    if (!err) return ready.fulfill();<tr><td><a id="l86"></a><a href="#l86">86</a><td><tr><td><a id="l87"></a><a href="#l87">87</a><td>    if (Date.now() - start &gt; timeout) {<tr><td><a id="l88"></a><a href="#l88">88</a><td>      ready.reject(<tr><td><a id="l89"></a><a href="#l89">89</a><td>          Error(&#39;Timed out waiting for the WebDriver server at &#39; + url));<tr><td><a id="l90"></a><a href="#l90">90</a><td>    } else {<tr><td><a id="l91"></a><a href="#l91">91</a><td>      setTimeout(function() {<tr><td><a id="l92"></a><a href="#l92">92</a><td>        if (ready.isPending()) {<tr><td><a id="l93"></a><a href="#l93">93</a><td>          checkServerStatus();<tr><td><a id="l94"></a><a href="#l94">94</a><td>        }<tr><td><a id="l95"></a><a href="#l95">95</a><td>      }, 50);<tr><td><a id="l96"></a><a href="#l96">96</a><td>    }<tr><td><a id="l97"></a><a href="#l97">97</a><td>  }<tr><td><a id="l98"></a><a href="#l98">98</a><td>};<tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td>/**<tr><td><a id="l102"></a><a href="#l102">102</a><td> * Polls a URL with GET requests until it returns a 2xx response or the<tr><td><a id="l103"></a><a href="#l103">103</a><td> * timeout expires.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @param {string} url The URL to poll.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {number} timeout How long to wait, in milliseconds.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve when the<tr><td><a id="l107"></a><a href="#l107">107</a><td> *     URL responds with 2xx.<tr><td><a id="l108"></a><a href="#l108">108</a><td> */<tr><td><a id="l109"></a><a href="#l109">109</a><td>exports.waitForUrl = function(url, timeout) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>  var client = new HttpClient(url),<tr><td><a id="l111"></a><a href="#l111">111</a><td>      request = new HttpRequest(&#39;GET&#39;, &#39;&#39;),<tr><td><a id="l112"></a><a href="#l112">112</a><td>      testUrl = client.send.bind(client, request, onResponse),<tr><td><a id="l113"></a><a href="#l113">113</a><td>      ready = promise.defer(),<tr><td><a id="l114"></a><a href="#l114">114</a><td>      start = Date.now();<tr><td><a id="l115"></a><a href="#l115">115</a><td>  testUrl();<tr><td><a id="l116"></a><a href="#l116">116</a><td>  return ready.promise;<tr><td><a id="l117"></a><a href="#l117">117</a><td><tr><td><a id="l118"></a><a href="#l118">118</a><td>  function onResponse(err, response) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>    if (!ready.isPending()) return;<tr><td><a id="l120"></a><a href="#l120">120</a><td>    if (!err &amp;&amp; response.status &gt; 199 &amp;&amp; response.status &lt; 300) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>      return ready.fulfill();<tr><td><a id="l122"></a><a href="#l122">122</a><td>    }<tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>    if (Date.now() - start &gt; timeout) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>      ready.reject(Error(<tr><td><a id="l126"></a><a href="#l126">126</a><td>          &#39;Timed out waiting for the URL to return 2xx: &#39; + url));<tr><td><a id="l127"></a><a href="#l127">127</a><td>    } else {<tr><td><a id="l128"></a><a href="#l128">128</a><td>      setTimeout(function() {<tr><td><a id="l129"></a><a href="#l129">129</a><td>        if (ready.isPending()) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>          testUrl();<tr><td><a id="l131"></a><a href="#l131">131</a><td>        }<tr><td><a id="l132"></a><a href="#l132">132</a><td>      }, 50);<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>};</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>
\ No newline at end of file
diff --git a/docs/source/ie.js.src.html b/docs/source/ie.js.src.html
new file mode 100644
index 0000000..9591bb8
--- /dev/null
+++ b/docs/source/ie.js.src.html
@@ -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>ie.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>ie.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines a {@linkplain Driver WebDriver} client for Microsoft&#39;s<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Internet Explorer. Before using the IEDriver, you must download the latest<tr><td><a id="l21"></a><a href="#l21">21</a><td> * [IEDriverServer](http://selenium-release.storage.googleapis.com/index.html)<tr><td><a id="l22"></a><a href="#l22">22</a><td> * and place it on your<tr><td><a id="l23"></a><a href="#l23">23</a><td> * [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29). You must also apply<tr><td><a id="l24"></a><a href="#l24">24</a><td> * the system configuration outlined on the Selenium project<tr><td><a id="l25"></a><a href="#l25">25</a><td> * [wiki](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver)<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>&#39;use strict&#39;;<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l31"></a><a href="#l31">31</a><td>    util = require(&#39;util&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a id="l34"></a><a href="#l34">34</a><td>    executors = require(&#39;./executors&#39;),<tr><td><a id="l35"></a><a href="#l35">35</a><td>    io = require(&#39;./io&#39;),<tr><td><a id="l36"></a><a href="#l36">36</a><td>    portprober = require(&#39;./net/portprober&#39;),<tr><td><a id="l37"></a><a href="#l37">37</a><td>    remote = require(&#39;./remote&#39;);<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> * @const<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @final<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>var IEDRIVER_EXE = &#39;IEDriverServer.exe&#39;;<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> * IEDriverServer logging levels.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @enum {string}<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>var Level = {<tr><td><a id="l53"></a><a href="#l53">53</a><td>  FATAL: &#39;FATAL&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td>  ERROR: &#39;ERROR&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td>  WARN: &#39;WARN&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td>  INFO: &#39;INFO&#39;,<tr><td><a id="l57"></a><a href="#l57">57</a><td>  DEBUG: &#39;DEBUG&#39;,<tr><td><a id="l58"></a><a href="#l58">58</a><td>  TRACE: &#39;TRACE&#39;<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><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> * Option keys:<tr><td><a id="l65"></a><a href="#l65">65</a><td> * https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities#ie-specific<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @enum {string}<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td>var Key = {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  IGNORE_PROTECTED_MODE_SETTINGS: &#39;ignoreProtectedModeSettings&#39;,<tr><td><a id="l70"></a><a href="#l70">70</a><td>  IGNORE_ZOOM_SETTING: &#39;ignoreZoomSetting&#39;,<tr><td><a id="l71"></a><a href="#l71">71</a><td>  INITIAL_BROWSER_URL: &#39;initialBrowserUrl&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td>  ENABLE_PERSISTENT_HOVER: &#39;enablePersistentHover&#39;,<tr><td><a id="l73"></a><a href="#l73">73</a><td>  ENABLE_ELEMENT_CACHE_CLEANUP: &#39;enableElementCacheCleanup&#39;,<tr><td><a id="l74"></a><a href="#l74">74</a><td>  REQUIRE_WINDOW_FOCUS: &#39;requireWindowFocus&#39;,<tr><td><a id="l75"></a><a href="#l75">75</a><td>  BROWSER_ATTACH_TIMEOUT: &#39;browserAttachTimeout&#39;,<tr><td><a id="l76"></a><a href="#l76">76</a><td>  FORCE_CREATE_PROCESS: &#39;ie.forceCreateProcessApi&#39;,<tr><td><a id="l77"></a><a href="#l77">77</a><td>  BROWSER_COMMAND_LINE_SWITCHES: &#39;ie.browserCommandLineSwitches&#39;,<tr><td><a id="l78"></a><a href="#l78">78</a><td>  USE_PER_PROCESS_PROXY: &#39;ie.usePerProcessProxy&#39;,<tr><td><a id="l79"></a><a href="#l79">79</a><td>  ENSURE_CLEAN_SESSION: &#39;ie.ensureCleanSession&#39;,<tr><td><a id="l80"></a><a href="#l80">80</a><td>  LOG_FILE: &#39;logFile&#39;,<tr><td><a id="l81"></a><a href="#l81">81</a><td>  LOG_LEVEL: &#39;logLevel&#39;,<tr><td><a id="l82"></a><a href="#l82">82</a><td>  HOST: &#39;host&#39;,<tr><td><a id="l83"></a><a href="#l83">83</a><td>  EXTRACT_PATH: &#39;extractPath&#39;,<tr><td><a id="l84"></a><a href="#l84">84</a><td>  SILENT: &#39;silent&#39;<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><tr><td><a id="l88"></a><a href="#l88">88</a><td>/**<tr><td><a id="l89"></a><a href="#l89">89</a><td> * Class for managing IEDriver specific options.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @constructor<tr><td><a id="l91"></a><a href="#l91">91</a><td> */<tr><td><a id="l92"></a><a href="#l92">92</a><td>var Options = function() {<tr><td><a id="l93"></a><a href="#l93">93</a><td>  /** @private {!Object&lt;(boolean|number|string)&gt;} */<tr><td><a id="l94"></a><a href="#l94">94</a><td>  this.options_ = {};<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>  /** @private {(webdriver.ProxyConfig|null)} */<tr><td><a id="l97"></a><a href="#l97">97</a><td>  this.proxy_ = null;<tr><td><a id="l98"></a><a href="#l98">98</a><td>};<tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td>/**<tr><td><a id="l103"></a><a href="#l103">103</a><td> * Extracts the IEDriver specific options from the given capabilities<tr><td><a id="l104"></a><a href="#l104">104</a><td> * object.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {!webdriver.Capabilities} capabilities The capabilities object.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!Options} The IEDriver options.<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td>Options.fromCapabilities = function(capabilities) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>  var options = new Options();<tr><td><a id="l110"></a><a href="#l110">110</a><td>  var map = options.options_;<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>  Object.keys(Key).forEach(function(key) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>    key = Key[key];<tr><td><a id="l114"></a><a href="#l114">114</a><td>    if (capabilities.has(key)) {<tr><td><a id="l115"></a><a href="#l115">115</a><td>      map[key] = capabilities.get(key);<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>  if (capabilities.has(webdriver.Capability.PROXY)) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>    options.setProxy(capabilities.get(webdriver.Capability.PROXY));<tr><td><a id="l121"></a><a href="#l121">121</a><td>  }<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>  return options;<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> * Whether to disable the protected mode settings check when the session is<tr><td><a id="l129"></a><a href="#l129">129</a><td> * created. Disbling this setting may lead to significant instability as the<tr><td><a id="l130"></a><a href="#l130">130</a><td> * browser may become unresponsive/hang. Only &quot;best effort&quot; support is provided<tr><td><a id="l131"></a><a href="#l131">131</a><td> * when using this capability.<tr><td><a id="l132"></a><a href="#l132">132</a><td> *<tr><td><a id="l133"></a><a href="#l133">133</a><td> * For more information, refer to the IEDriver&#39;s<tr><td><a id="l134"></a><a href="#l134">134</a><td> * [required system configuration](http://goo.gl/eH0Yi3).<tr><td><a id="l135"></a><a href="#l135">135</a><td> *<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @param {boolean} ignoreSettings Whether to ignore protected mode settings.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @return {!Options} A self reference.<tr><td><a id="l138"></a><a href="#l138">138</a><td> */<tr><td><a id="l139"></a><a href="#l139">139</a><td>Options.prototype.introduceFlakinessByIgnoringProtectedModeSettings =<tr><td><a id="l140"></a><a href="#l140">140</a><td>    function(ignoreSettings) {<tr><td><a id="l141"></a><a href="#l141">141</a><td>      this.options_[Key.IGNORE_PROTECTED_MODE_SETTINGS] = !!ignoreSettings;<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> * Indicates whether to skip the check that the browser&#39;s zoom level is set to<tr><td><a id="l148"></a><a href="#l148">148</a><td> * 100%.<tr><td><a id="l149"></a><a href="#l149">149</a><td> *<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @parm {boolean} ignore Whether to ignore the browser&#39;s zoom level settings.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @return {!Options} A self reference.<tr><td><a id="l152"></a><a href="#l152">152</a><td> */<tr><td><a id="l153"></a><a href="#l153">153</a><td>Options.prototype.ignoreZoomSetting = function(ignore) {<tr><td><a id="l154"></a><a href="#l154">154</a><td>  this.options_[Key.IGNORE_ZOOM_SETTING] = !!ignore;<tr><td><a id="l155"></a><a href="#l155">155</a><td>  return this;<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>/**<tr><td><a id="l160"></a><a href="#l160">160</a><td> * Sets the initial URL loaded when IE starts. This is intended to be used with<tr><td><a id="l161"></a><a href="#l161">161</a><td> * {@link #ignoreProtectedModeSettings} to allow the user to initialize IE in<tr><td><a id="l162"></a><a href="#l162">162</a><td> * the proper Protected Mode zone. Setting this option may cause browser<tr><td><a id="l163"></a><a href="#l163">163</a><td> * instability or flaky and unresponsive code. Only &quot;best effort&quot; support is<tr><td><a id="l164"></a><a href="#l164">164</a><td> * provided when using this option.<tr><td><a id="l165"></a><a href="#l165">165</a><td> *<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {string} url The initial browser URL.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @return {!Options} A self reference.<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>Options.prototype.initialBrowserUrl = function(url) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>  this.options_[Key.INITIAL_BROWSER_URL] = url;<tr><td><a id="l171"></a><a href="#l171">171</a><td>  return this;<tr><td><a id="l172"></a><a href="#l172">172</a><td>};<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * Configures whether to enable persistent mouse hovering (true by default).<tr><td><a id="l177"></a><a href="#l177">177</a><td> * Persistent hovering is achieved by continuously firing mouse over events at<tr><td><a id="l178"></a><a href="#l178">178</a><td> * the last location the mouse cursor has been moved to.<tr><td><a id="l179"></a><a href="#l179">179</a><td> *<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {boolean} enable Whether to enable persistent hovering.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @return {!Options} A self reference.<tr><td><a id="l182"></a><a href="#l182">182</a><td> */<tr><td><a id="l183"></a><a href="#l183">183</a><td>Options.prototype.enablePersistentHover = function(enable) {<tr><td><a id="l184"></a><a href="#l184">184</a><td>  this.options_[Key.ENABLE_PERSISTENT_HOVER] = !!enable;<tr><td><a id="l185"></a><a href="#l185">185</a><td>  return this;<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>/**<tr><td><a id="l190"></a><a href="#l190">190</a><td> * Configures whether the driver should attempt to remove obsolete<tr><td><a id="l191"></a><a href="#l191">191</a><td> * {@linkplain webdriver.WebElement WebElements} from its internal cache on<tr><td><a id="l192"></a><a href="#l192">192</a><td> * page navigation (true by default). Disabling this option will cause the<tr><td><a id="l193"></a><a href="#l193">193</a><td> * driver to run with a larger memory footprint.<tr><td><a id="l194"></a><a href="#l194">194</a><td> *<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @param {boolean} enable Whether to enable element reference cleanup.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @return {!Options} A self reference.<tr><td><a id="l197"></a><a href="#l197">197</a><td> */<tr><td><a id="l198"></a><a href="#l198">198</a><td>Options.prototype.enableElementCacheCleanup = function(enable) {<tr><td><a id="l199"></a><a href="#l199">199</a><td>  this.options_[Key.ENABLE_ELEMENT_CACHE_CLEANUP] = !!enable;<tr><td><a id="l200"></a><a href="#l200">200</a><td>  return this;<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><tr><td><a id="l204"></a><a href="#l204">204</a><td>/**<tr><td><a id="l205"></a><a href="#l205">205</a><td> * Configures whether to require the IE window to have input focus before<tr><td><a id="l206"></a><a href="#l206">206</a><td> * performing any user interactions (i.e. mouse or keyboard events). This<tr><td><a id="l207"></a><a href="#l207">207</a><td> * option is disabled by default, but delivers much more accurate interaction<tr><td><a id="l208"></a><a href="#l208">208</a><td> * events when enabled.<tr><td><a id="l209"></a><a href="#l209">209</a><td> *<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {boolean} require Whether to require window focus.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @return {!Options} A self reference.<tr><td><a id="l212"></a><a href="#l212">212</a><td> */<tr><td><a id="l213"></a><a href="#l213">213</a><td>Options.prototype.requireWindowFocus = function(require) {<tr><td><a id="l214"></a><a href="#l214">214</a><td>  this.options_[Key.REQUIRE_WINDOW_FOCUS] = !!require;<tr><td><a id="l215"></a><a href="#l215">215</a><td>  return this;<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> * Configures the timeout, in milliseconds, that the driver will attempt to<tr><td><a id="l221"></a><a href="#l221">221</a><td> * located and attach to a newly opened instance of Internet Explorer. The<tr><td><a id="l222"></a><a href="#l222">222</a><td> * default is zero, which indicates waiting indefinitely.<tr><td><a id="l223"></a><a href="#l223">223</a><td> *<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @param {number} timeout How long to wait for IE.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @return {!Options} A self reference.<tr><td><a id="l226"></a><a href="#l226">226</a><td> */<tr><td><a id="l227"></a><a href="#l227">227</a><td>Options.prototype.browserAttachTimeout = function(timeout) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>  this.options_[Key.BROWSER_ATTACH_TIMEOUT] = Math.max(timeout, 0);<tr><td><a id="l229"></a><a href="#l229">229</a><td>  return this;<tr><td><a id="l230"></a><a href="#l230">230</a><td>};<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Configures whether to launch Internet Explorer using the CreateProcess API.<tr><td><a id="l235"></a><a href="#l235">235</a><td> * If this option is not specified, IE is launched using IELaunchURL, if<tr><td><a id="l236"></a><a href="#l236">236</a><td> * available. For IE 8 and above, this option requires the TabProcGrowth<tr><td><a id="l237"></a><a href="#l237">237</a><td> * registry value to be set to 0.<tr><td><a id="l238"></a><a href="#l238">238</a><td> *<tr><td><a id="l239"></a><a href="#l239">239</a><td> * @param {boolean} force Whether to use the CreateProcess API.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @return {!Options} A self reference.<tr><td><a id="l241"></a><a href="#l241">241</a><td> */<tr><td><a id="l242"></a><a href="#l242">242</a><td>Options.prototype.forceCreateProcessApi = function(force) {<tr><td><a id="l243"></a><a href="#l243">243</a><td>  this.options_[Key.FORCE_CREATE_PROCESS] = !!force;<tr><td><a id="l244"></a><a href="#l244">244</a><td>  return this;<tr><td><a id="l245"></a><a href="#l245">245</a><td>};<tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td>/**<tr><td><a id="l249"></a><a href="#l249">249</a><td> * Specifies command-line switches to use when launching Internet Explorer.<tr><td><a id="l250"></a><a href="#l250">250</a><td> * This is only valid when used with {@link #forceCreateProcessApi}.<tr><td><a id="l251"></a><a href="#l251">251</a><td> *<tr><td><a id="l252"></a><a href="#l252">252</a><td> * @param {...(string|!Array.&lt;string&gt;)} var_args The arguments to add.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @return {!Options} A self reference.<tr><td><a id="l254"></a><a href="#l254">254</a><td> */<tr><td><a id="l255"></a><a href="#l255">255</a><td>Options.prototype.addArguments = function(var_args) {<tr><td><a id="l256"></a><a href="#l256">256</a><td>  var args = this.options_[Key.BROWSER_COMMAND_LINE_SWITCHES] || [];<tr><td><a id="l257"></a><a href="#l257">257</a><td>  args = args.concat.apply(args, arguments);<tr><td><a id="l258"></a><a href="#l258">258</a><td>  this.options_[Key.BROWSER_COMMAND_LINE_SWITCHES] = args;<tr><td><a id="l259"></a><a href="#l259">259</a><td>  return this;<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> * Configures whether proxies should be configured on a per-process basis. If<tr><td><a id="l265"></a><a href="#l265">265</a><td> * not set, setting a {@linkplain #setProxy proxy} will configure the system<tr><td><a id="l266"></a><a href="#l266">266</a><td> * proxy. The default behavior is to use the system proxy.<tr><td><a id="l267"></a><a href="#l267">267</a><td> *<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @param {boolean} enable Whether to enable per-process proxy settings.<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @return {!Options} A self reference.<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>Options.prototype.usePerProcessProxy = function(enable) {<tr><td><a id="l272"></a><a href="#l272">272</a><td>  this.options_[Key.USE_PER_PROCESS_PROXY] = !!enable;<tr><td><a id="l273"></a><a href="#l273">273</a><td>  return this;<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><tr><td><a id="l277"></a><a href="#l277">277</a><td>/**<tr><td><a id="l278"></a><a href="#l278">278</a><td> * Configures whether to clear the cache, cookies, history, and saved form data<tr><td><a id="l279"></a><a href="#l279">279</a><td> * before starting the browser. _Using this capability will clear session data<tr><td><a id="l280"></a><a href="#l280">280</a><td> * for all running instances of Internet Explorer, including those started<tr><td><a id="l281"></a><a href="#l281">281</a><td> * manually._<tr><td><a id="l282"></a><a href="#l282">282</a><td> *<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @param {boolean} cleanSession Whether to clear all session data on startup.<tr><td><a id="l284"></a><a href="#l284">284</a><td> * @return {!Options} A self reference.<tr><td><a id="l285"></a><a href="#l285">285</a><td> */<tr><td><a id="l286"></a><a href="#l286">286</a><td>Options.prototype.ensureCleanSession = function(cleanSession) {<tr><td><a id="l287"></a><a href="#l287">287</a><td>  this.options_[Key.ENSURE_CLEAN_SESSION] = !!cleanSession;<tr><td><a id="l288"></a><a href="#l288">288</a><td>  return this;<tr><td><a id="l289"></a><a href="#l289">289</a><td>};<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> * Sets the path to the log file the driver should log to.<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {string} path The log file path.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @return {!Options} A self reference.<tr><td><a id="l296"></a><a href="#l296">296</a><td> */<tr><td><a id="l297"></a><a href="#l297">297</a><td>Options.prototype.setLogFile = function(file) {<tr><td><a id="l298"></a><a href="#l298">298</a><td>  this.options_[Key.LOG_FILE] = file;<tr><td><a id="l299"></a><a href="#l299">299</a><td>  return this;<tr><td><a id="l300"></a><a href="#l300">300</a><td>};<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td>/**<tr><td><a id="l304"></a><a href="#l304">304</a><td> * Sets the IEDriverServer&#39;s logging {@linkplain Level level}.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @param {Level} level The logging level.<tr><td><a id="l306"></a><a href="#l306">306</a><td> * @return {!Options} A self reference.<tr><td><a id="l307"></a><a href="#l307">307</a><td> */<tr><td><a id="l308"></a><a href="#l308">308</a><td>Options.prototype.setLogLevel = function(level) {<tr><td><a id="l309"></a><a href="#l309">309</a><td>  this.options_[Key.LOG_LEVEL] = level;<tr><td><a id="l310"></a><a href="#l310">310</a><td>  return this;<tr><td><a id="l311"></a><a href="#l311">311</a><td>};<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td><tr><td><a id="l314"></a><a href="#l314">314</a><td>/**<tr><td><a id="l315"></a><a href="#l315">315</a><td> * Sets the IP address of the driver&#39;s host adapter.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @param {string} host The IP address to use.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @return {!Options} A self reference.<tr><td><a id="l318"></a><a href="#l318">318</a><td> */<tr><td><a id="l319"></a><a href="#l319">319</a><td>Options.prototype.setHost = function(host) {<tr><td><a id="l320"></a><a href="#l320">320</a><td>  this.options_[Key.HOST] = host;<tr><td><a id="l321"></a><a href="#l321">321</a><td>  return this;<tr><td><a id="l322"></a><a href="#l322">322</a><td>};<tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td>/**<tr><td><a id="l326"></a><a href="#l326">326</a><td> * Sets the path of the temporary data directory to use.<tr><td><a id="l327"></a><a href="#l327">327</a><td> * @param {string} path The log file path.<tr><td><a id="l328"></a><a href="#l328">328</a><td> * @return {!Options} A self reference.<tr><td><a id="l329"></a><a href="#l329">329</a><td> */<tr><td><a id="l330"></a><a href="#l330">330</a><td>Options.prototype.setExtractPath = function(path) {<tr><td><a id="l331"></a><a href="#l331">331</a><td>  this.options_[Key.EXTRACT_PATH] = path;<tr><td><a id="l332"></a><a href="#l332">332</a><td>  return this;<tr><td><a id="l333"></a><a href="#l333">333</a><td>};<tr><td><a id="l334"></a><a href="#l334">334</a><td><tr><td><a id="l335"></a><a href="#l335">335</a><td><tr><td><a id="l336"></a><a href="#l336">336</a><td>/**<tr><td><a id="l337"></a><a href="#l337">337</a><td> * Sets whether the driver should start in silent mode.<tr><td><a id="l338"></a><a href="#l338">338</a><td> * @param {boolean} silent Whether to run in silent mode.<tr><td><a id="l339"></a><a href="#l339">339</a><td> * @return {!Options} A self reference.<tr><td><a id="l340"></a><a href="#l340">340</a><td> */<tr><td><a id="l341"></a><a href="#l341">341</a><td>Options.prototype.silent = function(silent) {<tr><td><a id="l342"></a><a href="#l342">342</a><td>  this.options_[Key.SILENT] = silent;<tr><td><a id="l343"></a><a href="#l343">343</a><td>  return this;<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> * Sets the proxy settings for the new session.<tr><td><a id="l349"></a><a href="#l349">349</a><td> * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @return {!Options} A self reference.<tr><td><a id="l351"></a><a href="#l351">351</a><td> */<tr><td><a id="l352"></a><a href="#l352">352</a><td>Options.prototype.setProxy = function(proxy) {<tr><td><a id="l353"></a><a href="#l353">353</a><td>  this.proxy_ = proxy;<tr><td><a id="l354"></a><a href="#l354">354</a><td>  return this;<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> * Converts this options instance to a {@link webdriver.Capabilities} object.<tr><td><a id="l360"></a><a href="#l360">360</a><td> * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge<tr><td><a id="l361"></a><a href="#l361">361</a><td> *     these options into, if any.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @return {!webdriver.Capabilities} The capabilities.<tr><td><a id="l363"></a><a href="#l363">363</a><td> */<tr><td><a id="l364"></a><a href="#l364">364</a><td>Options.prototype.toCapabilities = function(opt_capabilities) {<tr><td><a id="l365"></a><a href="#l365">365</a><td>  var capabilities = opt_capabilities || webdriver.Capabilities.ie();<tr><td><a id="l366"></a><a href="#l366">366</a><td>  if (this.proxy_) {<tr><td><a id="l367"></a><a href="#l367">367</a><td>    capabilities.set(webdriver.Capability.PROXY, this.proxy_);<tr><td><a id="l368"></a><a href="#l368">368</a><td>  }<tr><td><a id="l369"></a><a href="#l369">369</a><td>  Object.keys(this.options_).forEach(function(key) {<tr><td><a id="l370"></a><a href="#l370">370</a><td>    capabilities.set(key, this.options_[key]);<tr><td><a id="l371"></a><a href="#l371">371</a><td>  }, this);<tr><td><a id="l372"></a><a href="#l372">372</a><td>  return capabilities;<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>function createServiceFromCapabilities(capabilities) {<tr><td><a id="l377"></a><a href="#l377">377</a><td>  if (process.platform !== &#39;win32&#39;) {<tr><td><a id="l378"></a><a href="#l378">378</a><td>    throw Error(<tr><td><a id="l379"></a><a href="#l379">379</a><td>        &#39;The IEDriver may only be used on Windows, but you appear to be on &#39; +<tr><td><a id="l380"></a><a href="#l380">380</a><td>        process.platform + &#39;. Did you mean to run against a remote &#39; +<tr><td><a id="l381"></a><a href="#l381">381</a><td>        &#39;WebDriver server?&#39;);<tr><td><a id="l382"></a><a href="#l382">382</a><td>  }<tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td>  var exe = io.findInPath(IEDRIVER_EXE, true);<tr><td><a id="l385"></a><a href="#l385">385</a><td>  if (!fs.existsSync(exe)) {<tr><td><a id="l386"></a><a href="#l386">386</a><td>    throw Error(&#39;File does not exist: &#39; + exe);<tr><td><a id="l387"></a><a href="#l387">387</a><td>  }<tr><td><a id="l388"></a><a href="#l388">388</a><td> <tr><td><a id="l389"></a><a href="#l389">389</a><td>  var args = [];<tr><td><a id="l390"></a><a href="#l390">390</a><td>  if (capabilities.has(Key.HOST)) {<tr><td><a id="l391"></a><a href="#l391">391</a><td>    args.push(&#39;--host=&#39; + capabilities.get(Key.HOST));<tr><td><a id="l392"></a><a href="#l392">392</a><td>  }<tr><td><a id="l393"></a><a href="#l393">393</a><td>  if (capabilities.has(Key.LOG_FILE)) {<tr><td><a id="l394"></a><a href="#l394">394</a><td>    args.push(&#39;--log-file=&#39; + capabilities.get(Key.LOG_FILE));<tr><td><a id="l395"></a><a href="#l395">395</a><td>  }<tr><td><a id="l396"></a><a href="#l396">396</a><td>  if (capabilities.has(Key.LOG_LEVEL)) {<tr><td><a id="l397"></a><a href="#l397">397</a><td>    args.push(&#39;--log-level=&#39; + capabilities.get(Key.LOG_LEVEL));<tr><td><a id="l398"></a><a href="#l398">398</a><td>  }<tr><td><a id="l399"></a><a href="#l399">399</a><td>  if (capabilities.has(Key.EXTRACT_PATH)) {<tr><td><a id="l400"></a><a href="#l400">400</a><td>    args.push(&#39;--extract-path=&#39; + capabilities.get(Key.EXTRACT_PATH));<tr><td><a id="l401"></a><a href="#l401">401</a><td>  }<tr><td><a id="l402"></a><a href="#l402">402</a><td>  if (capabilities.get(Key.SILENT)) {<tr><td><a id="l403"></a><a href="#l403">403</a><td>    args.push(&#39;--silent&#39;);<tr><td><a id="l404"></a><a href="#l404">404</a><td>  }<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td>  var port = portprober.findFreePort();<tr><td><a id="l407"></a><a href="#l407">407</a><td>  return new remote.DriverService(exe, {<tr><td><a id="l408"></a><a href="#l408">408</a><td>    loopback: true,<tr><td><a id="l409"></a><a href="#l409">409</a><td>    port: port,<tr><td><a id="l410"></a><a href="#l410">410</a><td>    args: port.then(function(port) {<tr><td><a id="l411"></a><a href="#l411">411</a><td>      return args.concat(&#39;--port=&#39; + port);<tr><td><a id="l412"></a><a href="#l412">412</a><td>    }),<tr><td><a id="l413"></a><a href="#l413">413</a><td>    stdio: &#39;ignore&#39;<tr><td><a id="l414"></a><a href="#l414">414</a><td>  });<tr><td><a id="l415"></a><a href="#l415">415</a><td>}<tr><td><a id="l416"></a><a href="#l416">416</a><td><tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td>/**<tr><td><a id="l419"></a><a href="#l419">419</a><td> * A WebDriver client for Microsoft&#39;s Internet Explorer.<tr><td><a id="l420"></a><a href="#l420">420</a><td> *<tr><td><a id="l421"></a><a href="#l421">421</a><td> * @param {(webdriver.Capabilities|Options)=} opt_config The configuration<tr><td><a id="l422"></a><a href="#l422">422</a><td> *     options.<tr><td><a id="l423"></a><a href="#l423">423</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or<tr><td><a id="l424"></a><a href="#l424">424</a><td> *     {@code null} to use the currently active flow.<tr><td><a id="l425"></a><a href="#l425">425</a><td> * @constructor<tr><td><a id="l426"></a><a href="#l426">426</a><td> * @extends {webdriver.WebDriver}<tr><td><a id="l427"></a><a href="#l427">427</a><td> */<tr><td><a id="l428"></a><a href="#l428">428</a><td>var Driver = function(opt_config, opt_flow) {<tr><td><a id="l429"></a><a href="#l429">429</a><td>  var capabilities = opt_config instanceof Options ? <tr><td><a id="l430"></a><a href="#l430">430</a><td>      opt_config.toCapabilities() :<tr><td><a id="l431"></a><a href="#l431">431</a><td>      (opt_config || webdriver.Capabilities.ie());<tr><td><a id="l432"></a><a href="#l432">432</a><td><tr><td><a id="l433"></a><a href="#l433">433</a><td>  var service = createServiceFromCapabilities(capabilities);<tr><td><a id="l434"></a><a href="#l434">434</a><td>  var executor = executors.createExecutor(service.start());<tr><td><a id="l435"></a><a href="#l435">435</a><td>  var driver = webdriver.WebDriver.createSession(<tr><td><a id="l436"></a><a href="#l436">436</a><td>      executor, capabilities, opt_flow);<tr><td><a id="l437"></a><a href="#l437">437</a><td><tr><td><a id="l438"></a><a href="#l438">438</a><td>  webdriver.WebDriver.call(<tr><td><a id="l439"></a><a href="#l439">439</a><td>      this, driver.getSession(), executor, driver.controlFlow());<tr><td><a id="l440"></a><a href="#l440">440</a><td><tr><td><a id="l441"></a><a href="#l441">441</a><td>  var boundQuit = this.quit.bind(this);<tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td>  /** @override */<tr><td><a id="l444"></a><a href="#l444">444</a><td>  this.quit = function() {<tr><td><a id="l445"></a><a href="#l445">445</a><td>    return boundQuit().thenFinally(service.kill.bind(service));<tr><td><a id="l446"></a><a href="#l446">446</a><td>  };<tr><td><a id="l447"></a><a href="#l447">447</a><td>};<tr><td><a id="l448"></a><a href="#l448">448</a><td>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l449"></a><a href="#l449">449</a><td><tr><td><a id="l450"></a><a href="#l450">450</a><td><tr><td><a id="l451"></a><a href="#l451">451</a><td>/**<tr><td><a id="l452"></a><a href="#l452">452</a><td> * This function is a no-op as file detectors are not supported by this<tr><td><a id="l453"></a><a href="#l453">453</a><td> * implementation.<tr><td><a id="l454"></a><a href="#l454">454</a><td> * @override<tr><td><a id="l455"></a><a href="#l455">455</a><td> */<tr><td><a id="l456"></a><a href="#l456">456</a><td>Driver.prototype.setFileDetector = function() {<tr><td><a id="l457"></a><a href="#l457">457</a><td>};<tr><td><a id="l458"></a><a href="#l458">458</a><td><tr><td><a id="l459"></a><a href="#l459">459</a><td><tr><td><a id="l460"></a><a href="#l460">460</a><td>// PUBLIC API<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>exports.Driver = Driver;<tr><td><a id="l464"></a><a href="#l464">464</a><td>exports.Options = Options;<tr><td><a id="l465"></a><a href="#l465">465</a><td>exports.Level = Level;</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>
\ No newline at end of file
diff --git a/docs/source/index.js.src.html b/docs/source/index.js.src.html
index b4cc5c6..9c22c9d 100644
--- a/docs/source/index.js.src.html
+++ b/docs/source/index.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>index.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>index.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2012 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview The main user facing module. Exports WebDriver&#39;s primary<tr><td><a name="l18" href="#l18">18</a><td> * public API and provides convenience assessors to certain sub-modules.<tr><td><a name="l19" href="#l19">19</a><td> */<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>var base = require(&#39;./_base&#39;);<tr><td><a name="l22" href="#l22">22</a><td>var builder = require(&#39;./builder&#39;);<tr><td><a name="l23" href="#l23">23</a><td>var error = require(&#39;./error&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>// NOTE: the remainder of this file is nasty and verbose, but the annotations<tr><td><a name="l27" href="#l27">27</a><td>// are necessary to guide the Closure Compiler&#39;s type analysis. Without them,<tr><td><a name="l28" href="#l28">28</a><td>// we would not be able to extract any meaningful API documentation.<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>/** @type {function(new: webdriver.ActionSequence)} */<tr><td><a name="l32" href="#l32">32</a><td>exports.ActionSequence = base.require(&#39;webdriver.ActionSequence&#39;);<tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>/** @type {function(new: builder.Builder)} */<tr><td><a name="l36" href="#l36">36</a><td>exports.Builder = builder.Builder;<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>/** @type {webdriver.By.} */<tr><td><a name="l40" href="#l40">40</a><td>exports.By = base.require(&#39;webdriver.By&#39;);<tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>/** @type {function(new: webdriver.Capabilities)} */<tr><td><a name="l44" href="#l44">44</a><td>exports.Capabilities = base.require(&#39;webdriver.Capabilities&#39;);<tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>/** @type {function(new: webdriver.Command)} */<tr><td><a name="l48" href="#l48">48</a><td>exports.Command = base.require(&#39;webdriver.Command&#39;);<tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td>/** @type {function(new: webdriver.EventEmitter)} */<tr><td><a name="l52" href="#l52">52</a><td>exports.EventEmitter = base.require(&#39;webdriver.EventEmitter&#39;);<tr><td><a name="l53" href="#l53">53</a><td><tr><td><a name="l54" href="#l54">54</a><td><tr><td><a name="l55" href="#l55">55</a><td>/** @type {function(new: webdriver.Session)} */<tr><td><a name="l56" href="#l56">56</a><td>exports.Session = base.require(&#39;webdriver.Session&#39;);<tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td>/** @type {function(new: webdriver.WebDriver)} */<tr><td><a name="l60" href="#l60">60</a><td>exports.WebDriver = base.require(&#39;webdriver.WebDriver&#39;);<tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td>/** @type {function(new: webdriver.WebElement)} */<tr><td><a name="l64" href="#l64">64</a><td>exports.WebElement = base.require(&#39;webdriver.WebElement&#39;);<tr><td><a name="l65" href="#l65">65</a><td><tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td>// Export the remainder of our API through getters to keep things cleaner<tr><td><a name="l68" href="#l68">68</a><td>// when this module is used in a REPL environment.<tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td>/** @type {webdriver.Browser.} */<tr><td><a name="l72" href="#l72">72</a><td>(exports.__defineGetter__(&#39;Browser&#39;, function() {<tr><td><a name="l73" href="#l73">73</a><td>  return base.require(&#39;webdriver.Browser&#39;);<tr><td><a name="l74" href="#l74">74</a><td>}));<tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td>/** @type {webdriver.Button.} */<tr><td><a name="l78" href="#l78">78</a><td>(exports.__defineGetter__(&#39;Button&#39;, function() {<tr><td><a name="l79" href="#l79">79</a><td>  return base.require(&#39;webdriver.Button&#39;);<tr><td><a name="l80" href="#l80">80</a><td>}));<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td><tr><td><a name="l83" href="#l83">83</a><td>/** @type {webdriver.Capability.} */<tr><td><a name="l84" href="#l84">84</a><td>(exports.__defineGetter__(&#39;Capability&#39;, function() {<tr><td><a name="l85" href="#l85">85</a><td>  return base.require(&#39;webdriver.Capability&#39;);<tr><td><a name="l86" href="#l86">86</a><td>}));<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>/** @type {webdriver.CommandName.} */<tr><td><a name="l90" href="#l90">90</a><td>(exports.__defineGetter__(&#39;CommandName&#39;, function() {<tr><td><a name="l91" href="#l91">91</a><td>  return base.require(&#39;webdriver.CommandName&#39;);<tr><td><a name="l92" href="#l92">92</a><td>}));<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/** @type {webdriver.Key.} */<tr><td><a name="l96" href="#l96">96</a><td>(exports.__defineGetter__(&#39;Key&#39;, function() {<tr><td><a name="l97" href="#l97">97</a><td>  return base.require(&#39;webdriver.Key&#39;);<tr><td><a name="l98" href="#l98">98</a><td>}));<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td><tr><td><a name="l101" href="#l101">101</a><td>/** @type {error.} */<tr><td><a name="l102" href="#l102">102</a><td>(exports.__defineGetter__(&#39;error&#39;, function() {<tr><td><a name="l103" href="#l103">103</a><td>  return error;<tr><td><a name="l104" href="#l104">104</a><td>}));<tr><td><a name="l105" href="#l105">105</a><td><tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td>/** @type {error.} */<tr><td><a name="l108" href="#l108">108</a><td>(exports.__defineGetter__(&#39;error&#39;, function() {<tr><td><a name="l109" href="#l109">109</a><td>  return error;<tr><td><a name="l110" href="#l110">110</a><td>}));<tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td>/** @type {webdriver.logging.} */<tr><td><a name="l114" href="#l114">114</a><td>(exports.__defineGetter__(&#39;logging&#39;, function() {<tr><td><a name="l115" href="#l115">115</a><td>  return base.exportPublicApi(&#39;webdriver.logging&#39;);<tr><td><a name="l116" href="#l116">116</a><td>}));<tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td><tr><td><a name="l119" href="#l119">119</a><td>/** @type {webdriver.promise.} */<tr><td><a name="l120" href="#l120">120</a><td>(exports.__defineGetter__(&#39;promise&#39;, function() {<tr><td><a name="l121" href="#l121">121</a><td>  return base.exportPublicApi(&#39;webdriver.promise&#39;);<tr><td><a name="l122" href="#l122">122</a><td>}));<tr><td><a name="l123" href="#l123">123</a><td><tr><td><a name="l124" href="#l124">124</a><td><tr><td><a name="l125" href="#l125">125</a><td>/** @type {webdriver.stacktrace.} */<tr><td><a name="l126" href="#l126">126</a><td>(exports.__defineGetter__(&#39;stacktrace&#39;, function() {<tr><td><a name="l127" href="#l127">127</a><td>  return base.exportPublicApi(&#39;webdriver.stacktrace&#39;);<tr><td><a name="l128" href="#l128">128</a><td>}));</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
+<!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>index.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>index.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview The main user facing module. Exports WebDriver&#39;s primary<tr><td><a id="l20"></a><a href="#l20">20</a><td> * public API and provides convenience assessors to certain sub-modules.<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>var base = require(&#39;./_base&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>var builder = require(&#39;./builder&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>var error = require(&#39;./error&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>// NOTE: the remainder of this file is nasty and verbose, but the annotations<tr><td><a id="l29"></a><a href="#l29">29</a><td>// are necessary to guide the Closure Compiler&#39;s type analysis. Without them,<tr><td><a id="l30"></a><a href="#l30">30</a><td>// we would not be able to extract any meaningful API documentation.<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>/** @type {function(new: webdriver.ActionSequence)} */<tr><td><a id="l34"></a><a href="#l34">34</a><td>exports.ActionSequence = base.require(&#39;webdriver.ActionSequence&#39;);<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>/** @type {function(new: builder.Builder)} */<tr><td><a id="l38"></a><a href="#l38">38</a><td>exports.Builder = builder.Builder;<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>/** @type {webdriver.By.} */<tr><td><a id="l42"></a><a href="#l42">42</a><td>exports.By = base.require(&#39;webdriver.By&#39;);<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 {function(new: webdriver.Capabilities)} */<tr><td><a id="l46"></a><a href="#l46">46</a><td>exports.Capabilities = base.require(&#39;webdriver.Capabilities&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td>/** @type {function(new: webdriver.Command)} */<tr><td><a id="l50"></a><a href="#l50">50</a><td>exports.Command = base.require(&#39;webdriver.Command&#39;);<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/** @type {function(new: webdriver.EventEmitter)} */<tr><td><a id="l54"></a><a href="#l54">54</a><td>exports.EventEmitter = base.require(&#39;webdriver.EventEmitter&#39;);<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>/** @type {function(new: webdriver.FileDetector)} */<tr><td><a id="l58"></a><a href="#l58">58</a><td>exports.FileDetector = base.require(&#39;webdriver.FileDetector&#39;);<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>/** @type {function(new: webdriver.Serializable)} */<tr><td><a id="l62"></a><a href="#l62">62</a><td>exports.Serializable = base.require(&#39;webdriver.Serializable&#39;);<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>/** @type {function(new: webdriver.Session)} */<tr><td><a id="l66"></a><a href="#l66">66</a><td>exports.Session = base.require(&#39;webdriver.Session&#39;);<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>/** @type {function(new: webdriver.WebDriver)} */<tr><td><a id="l70"></a><a href="#l70">70</a><td>exports.WebDriver = base.require(&#39;webdriver.WebDriver&#39;);<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 {function(new: webdriver.WebElement)} */<tr><td><a id="l74"></a><a href="#l74">74</a><td>exports.WebElement = base.require(&#39;webdriver.WebElement&#39;);<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/** @type {function(new: webdriver.WebElementPromise)} */<tr><td><a id="l78"></a><a href="#l78">78</a><td>exports.WebElementPromise = base.require(&#39;webdriver.WebElementPromise&#39;);<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td>// Export the remainder of our API through getters to keep things cleaner<tr><td><a id="l82"></a><a href="#l82">82</a><td>// when this module is used in a REPL environment.<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>/** @type {webdriver.Browser.} */<tr><td><a id="l86"></a><a href="#l86">86</a><td>(exports.__defineGetter__(&#39;Browser&#39;, function() {<tr><td><a id="l87"></a><a href="#l87">87</a><td>  return base.require(&#39;webdriver.Browser&#39;);<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>/** @type {webdriver.Button.} */<tr><td><a id="l92"></a><a href="#l92">92</a><td>(exports.__defineGetter__(&#39;Button&#39;, function() {<tr><td><a id="l93"></a><a href="#l93">93</a><td>  return base.require(&#39;webdriver.Button&#39;);<tr><td><a id="l94"></a><a href="#l94">94</a><td>}));<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/** @type {webdriver.Capability.} */<tr><td><a id="l98"></a><a href="#l98">98</a><td>(exports.__defineGetter__(&#39;Capability&#39;, function() {<tr><td><a id="l99"></a><a href="#l99">99</a><td>  return base.require(&#39;webdriver.Capability&#39;);<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>/** @type {webdriver.CommandName.} */<tr><td><a id="l104"></a><a href="#l104">104</a><td>(exports.__defineGetter__(&#39;CommandName&#39;, function() {<tr><td><a id="l105"></a><a href="#l105">105</a><td>  return base.require(&#39;webdriver.CommandName&#39;);<tr><td><a id="l106"></a><a href="#l106">106</a><td>}));<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>/** @type {webdriver.Key.} */<tr><td><a id="l110"></a><a href="#l110">110</a><td>(exports.__defineGetter__(&#39;Key&#39;, function() {<tr><td><a id="l111"></a><a href="#l111">111</a><td>  return base.require(&#39;webdriver.Key&#39;);<tr><td><a id="l112"></a><a href="#l112">112</a><td>}));<tr><td><a id="l113"></a><a href="#l113">113</a><td><tr><td><a id="l114"></a><a href="#l114">114</a><td><tr><td><a id="l115"></a><a href="#l115">115</a><td>/** @type {error.} */<tr><td><a id="l116"></a><a href="#l116">116</a><td>(exports.__defineGetter__(&#39;error&#39;, function() {<tr><td><a id="l117"></a><a href="#l117">117</a><td>  return error;<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>/** @type {error.} */<tr><td><a id="l122"></a><a href="#l122">122</a><td>(exports.__defineGetter__(&#39;error&#39;, function() {<tr><td><a id="l123"></a><a href="#l123">123</a><td>  return error;<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>/** @type {webdriver.logging.} */<tr><td><a id="l128"></a><a href="#l128">128</a><td>(exports.__defineGetter__(&#39;logging&#39;, function() {<tr><td><a id="l129"></a><a href="#l129">129</a><td>  return base.exportPublicApi(&#39;webdriver.logging&#39;);<tr><td><a id="l130"></a><a href="#l130">130</a><td>}));<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/** @type {webdriver.promise.} */<tr><td><a id="l134"></a><a href="#l134">134</a><td>(exports.__defineGetter__(&#39;promise&#39;, function() {<tr><td><a id="l135"></a><a href="#l135">135</a><td>  return base.exportPublicApi(&#39;webdriver.promise&#39;);<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>/** @type {webdriver.stacktrace.} */<tr><td><a id="l140"></a><a href="#l140">140</a><td>(exports.__defineGetter__(&#39;stacktrace&#39;, function() {<tr><td><a id="l141"></a><a href="#l141">141</a><td>  return base.exportPublicApi(&#39;webdriver.stacktrace&#39;);<tr><td><a id="l142"></a><a href="#l142">142</a><td>}));<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>/** @type {webdriver.until.} */<tr><td><a id="l146"></a><a href="#l146">146</a><td>(exports.__defineGetter__(&#39;until&#39;, function() {<tr><td><a id="l147"></a><a href="#l147">147</a><td>  return base.exportPublicApi(&#39;webdriver.until&#39;);<tr><td><a id="l148"></a><a href="#l148">148</a><td>}));</table></div></article><nav><h3><a href="../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/io/exec.js.src.html b/docs/source/io/exec.js.src.html
new file mode 100644
index 0000000..9063c7e
--- /dev/null
+++ b/docs/source/io/exec.js.src.html
@@ -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>exec.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>io/exec.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var childProcess = require(&#39;child_process&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>var promise = require(&#39;..&#39;).promise;<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> * A hash with configuration options for an executed command.<tr><td><a id="l27"></a><a href="#l27">27</a><td> *<tr><td><a id="l28"></a><a href="#l28">28</a><td> * - `args` - Command line arguments.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * - `env` - Command environment; will inherit from the current process if<tr><td><a id="l30"></a><a href="#l30">30</a><td> *     missing.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * - `stdio` - IO configuration for the spawned server process. For more<tr><td><a id="l32"></a><a href="#l32">32</a><td> *     information, refer to the documentation of `child_process.spawn`.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @typedef {{<tr><td><a id="l35"></a><a href="#l35">35</a><td> *   args: (!Array.&lt;string&gt;|undefined),<tr><td><a id="l36"></a><a href="#l36">36</a><td> *   env: (!Object.&lt;string, string&gt;|undefined),<tr><td><a id="l37"></a><a href="#l37">37</a><td> *   stdio: (string|!Array.&lt;string|number|!Stream|null|undefined&gt;|undefined)<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>var Options;<tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td>/**<tr><td><a id="l44"></a><a href="#l44">44</a><td> * Describes a command&#39;s termination conditions.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @param {?number} code The exit code, or {@code null} if the command did not<tr><td><a id="l46"></a><a href="#l46">46</a><td> *     exit normally.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @param {?string} signal The signal used to kill the command, or<tr><td><a id="l48"></a><a href="#l48">48</a><td> *     {@code null}.<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @constructor<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>var Result = function(code, signal) {<tr><td><a id="l52"></a><a href="#l52">52</a><td>  /** @type {?number} */<tr><td><a id="l53"></a><a href="#l53">53</a><td>  this.code = code;<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>  /** @type {?string} */<tr><td><a id="l56"></a><a href="#l56">56</a><td>  this.signal = signal;<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>/** @override */<tr><td><a id="l61"></a><a href="#l61">61</a><td>Result.prototype.toString = function() {<tr><td><a id="l62"></a><a href="#l62">62</a><td>  return &#39;Result(code=&#39; + this.code + &#39;, signal=&#39; + this.signal + &#39;)&#39;;<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>/**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * Represents a command running in a sub-process.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @param {!promise.Promise.&lt;!Result&gt;} result The command result.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @constructor<tr><td><a id="l71"></a><a href="#l71">71</a><td> */<tr><td><a id="l72"></a><a href="#l72">72</a><td>var Command = function(result, onKill) {<tr><td><a id="l73"></a><a href="#l73">73</a><td>  /** @return {boolean} Whether this command is still running. */<tr><td><a id="l74"></a><a href="#l74">74</a><td>  this.isRunning = function() {<tr><td><a id="l75"></a><a href="#l75">75</a><td>    return result.isPending();<tr><td><a id="l76"></a><a href="#l76">76</a><td>  };<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>  /**<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * @return {!promise.Promise.&lt;!Result&gt;} A promise for the result of this<tr><td><a id="l80"></a><a href="#l80">80</a><td>   *     command.<tr><td><a id="l81"></a><a href="#l81">81</a><td>   */<tr><td><a id="l82"></a><a href="#l82">82</a><td>  this.result = function() {<tr><td><a id="l83"></a><a href="#l83">83</a><td>    return result;<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>   * Sends a signal to the underlying process.<tr><td><a id="l88"></a><a href="#l88">88</a><td>   * @param {string=} opt_signal The signal to send; defaults to<tr><td><a id="l89"></a><a href="#l89">89</a><td>   *     {@code SIGTERM}.<tr><td><a id="l90"></a><a href="#l90">90</a><td>   */<tr><td><a id="l91"></a><a href="#l91">91</a><td>  this.kill = function(opt_signal) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>    onKill(opt_signal || &#39;SIGTERM&#39;);<tr><td><a id="l93"></a><a href="#l93">93</a><td>  };<tr><td><a id="l94"></a><a href="#l94">94</a><td>};<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>// PUBLIC API<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * Spawns a child process. The returned {@link Command} may be used to wait<tr><td><a id="l102"></a><a href="#l102">102</a><td> * for the process result or to send signals to the process.<tr><td><a id="l103"></a><a href="#l103">103</a><td> *<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @param {string} command The executable to spawn.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {Options=} opt_options The command options.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!Command} The launched command.<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td>module.exports = function(command, opt_options) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>  var options = opt_options || {};<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td>  var proc = childProcess.spawn(command, options.args || [], {<tr><td><a id="l112"></a><a href="#l112">112</a><td>    env: options.env || process.env,<tr><td><a id="l113"></a><a href="#l113">113</a><td>    stdio: options.stdio || &#39;ignore&#39;<tr><td><a id="l114"></a><a href="#l114">114</a><td>  }).once(&#39;exit&#39;, onExit);<tr><td><a id="l115"></a><a href="#l115">115</a><td><tr><td><a id="l116"></a><a href="#l116">116</a><td>  // This process should not wait on the spawned child, however, we do<tr><td><a id="l117"></a><a href="#l117">117</a><td>  // want to ensure the child is killed when this process exits.<tr><td><a id="l118"></a><a href="#l118">118</a><td>  proc.unref();<tr><td><a id="l119"></a><a href="#l119">119</a><td>  process.once(&#39;exit&#39;, killCommand);<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>  var result = promise.defer();<tr><td><a id="l122"></a><a href="#l122">122</a><td>  var cmd = new Command(result.promise, function(signal) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>    if (!result.isPending() || !proc) {<tr><td><a id="l124"></a><a href="#l124">124</a><td>      return;  // No longer running.<tr><td><a id="l125"></a><a href="#l125">125</a><td>    }<tr><td><a id="l126"></a><a href="#l126">126</a><td>    proc.kill(signal);<tr><td><a id="l127"></a><a href="#l127">127</a><td>  });<tr><td><a id="l128"></a><a href="#l128">128</a><td>  return cmd;<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>  function onExit(code, signal) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>    proc = null;<tr><td><a id="l132"></a><a href="#l132">132</a><td>    process.removeListener(&#39;exit&#39;, killCommand);<tr><td><a id="l133"></a><a href="#l133">133</a><td>    result.fulfill(new Result(code, signal));<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>  function killCommand() {<tr><td><a id="l137"></a><a href="#l137">137</a><td>    process.removeListener(&#39;exit&#39;, killCommand);<tr><td><a id="l138"></a><a href="#l138">138</a><td>    proc &amp;&amp; proc.kill(&#39;SIGTERM&#39;);<tr><td><a id="l139"></a><a href="#l139">139</a><td>  }<tr><td><a id="l140"></a><a href="#l140">140</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>
\ No newline at end of file
diff --git a/docs/source/io/index.js.src.html b/docs/source/io/index.js.src.html
index 0a18b2b..c2a0f4c 100644
--- a/docs/source/io/index.js.src.html
+++ b/docs/source/io/index.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>index.js</title><link href="../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>io/index.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>var fs = require(&#39;fs&#39;),<tr><td><a name="l17" href="#l17">17</a><td>    path = require(&#39;path&#39;);<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>var PATH_SEPARATOR = process.platform === &#39;win32&#39; ? &#39;;&#39; : &#39;:&#39;;<tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>// PUBLIC API<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>/**<tr><td><a name="l27" href="#l27">27</a><td> * Searches the {@code PATH} environment variable for the given file.<tr><td><a name="l28" href="#l28">28</a><td> * @param {string} file The file to locate on the PATH.<tr><td><a name="l29" href="#l29">29</a><td> * @param {boolean=} opt_checkCwd Whether to always start with the search with<tr><td><a name="l30" href="#l30">30</a><td> *     the current working directory, regardless of whether it is explicitly<tr><td><a name="l31" href="#l31">31</a><td> *     listed on the PATH.<tr><td><a name="l32" href="#l32">32</a><td> * @return {?string} Path to the located file, or {@code null} if it could<tr><td><a name="l33" href="#l33">33</a><td> *     not be found.<tr><td><a name="l34" href="#l34">34</a><td> */<tr><td><a name="l35" href="#l35">35</a><td>exports.findInPath = function(file, opt_checkCwd) {<tr><td><a name="l36" href="#l36">36</a><td>  if (opt_checkCwd) {<tr><td><a name="l37" href="#l37">37</a><td>    var tmp = path.join(process.cwd(), file);<tr><td><a name="l38" href="#l38">38</a><td>    if (fs.existsSync(tmp)) {<tr><td><a name="l39" href="#l39">39</a><td>      return tmp;<tr><td><a name="l40" href="#l40">40</a><td>    }<tr><td><a name="l41" href="#l41">41</a><td>  }<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>  var dirs = process.env[&#39;PATH&#39;].split(PATH_SEPARATOR);<tr><td><a name="l44" href="#l44">44</a><td>  var found = null;<tr><td><a name="l45" href="#l45">45</a><td>  dirs.forEach(function(dir) {<tr><td><a name="l46" href="#l46">46</a><td>    var tmp = path.join(dir, file);<tr><td><a name="l47" href="#l47">47</a><td>    if (!found &amp;&amp; fs.existsSync(tmp)) {<tr><td><a name="l48" href="#l48">48</a><td>      found = tmp;<tr><td><a name="l49" href="#l49">49</a><td>    }<tr><td><a name="l50" href="#l50">50</a><td>  });<tr><td><a name="l51" href="#l51">51</a><td>  return found;<tr><td><a name="l52" href="#l52">52</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../types.js"></script><script src="../../dossier.js"></script>
\ No newline at end of file
+<!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>index.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>io/index.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l19"></a><a href="#l19">19</a><td>    path = require(&#39;path&#39;),<tr><td><a id="l20"></a><a href="#l20">20</a><td>    rimraf = require(&#39;rimraf&#39;),<tr><td><a id="l21"></a><a href="#l21">21</a><td>    tmp = require(&#39;tmp&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>var promise = require(&#39;..&#39;).promise;<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><tr><td><a id="l27"></a><a href="#l27">27</a><td>// PUBLIC API<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>/**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * Recursively removes a directory and all of its contents. This is equivalent<tr><td><a id="l33"></a><a href="#l33">33</a><td> * to {@code rm -rf} on a POSIX system.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {string} path Path to the directory to remove.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @return {!promise.Promise} A promise to be resolved when the operation has<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     completed.<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>exports.rmDir = function(path) {<tr><td><a id="l39"></a><a href="#l39">39</a><td>  return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>    var numAttempts = 0;<tr><td><a id="l41"></a><a href="#l41">41</a><td>    attemptRm();<tr><td><a id="l42"></a><a href="#l42">42</a><td>    function attemptRm() {<tr><td><a id="l43"></a><a href="#l43">43</a><td>      numAttempts += 1;<tr><td><a id="l44"></a><a href="#l44">44</a><td>      rimraf(path, function(err) {<tr><td><a id="l45"></a><a href="#l45">45</a><td>        if (err) {<tr><td><a id="l46"></a><a href="#l46">46</a><td>          if (err.code === &#39;ENOTEMPTY&#39; &amp;&amp; numAttempts &lt; 2) {<tr><td><a id="l47"></a><a href="#l47">47</a><td>            attemptRm();<tr><td><a id="l48"></a><a href="#l48">48</a><td>            return;<tr><td><a id="l49"></a><a href="#l49">49</a><td>          }<tr><td><a id="l50"></a><a href="#l50">50</a><td>          reject(err);<tr><td><a id="l51"></a><a href="#l51">51</a><td>        } else {<tr><td><a id="l52"></a><a href="#l52">52</a><td>          fulfill();<tr><td><a id="l53"></a><a href="#l53">53</a><td>        }<tr><td><a id="l54"></a><a href="#l54">54</a><td>      });<tr><td><a id="l55"></a><a href="#l55">55</a><td>    }<tr><td><a id="l56"></a><a href="#l56">56</a><td>  });<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> * Copies one file to another.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {string} src The source file.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {string} dst The destination file.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the copied file&#39;s path.<tr><td><a id="l65"></a><a href="#l65">65</a><td> */<tr><td><a id="l66"></a><a href="#l66">66</a><td>exports.copy = function(src, dst) {<tr><td><a id="l67"></a><a href="#l67">67</a><td>  var copied = promise.defer();<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>  var rs = fs.createReadStream(src);<tr><td><a id="l70"></a><a href="#l70">70</a><td>  rs.on(&#39;error&#39;, copied.reject);<tr><td><a id="l71"></a><a href="#l71">71</a><td>  rs.on(&#39;end&#39;, function() {<tr><td><a id="l72"></a><a href="#l72">72</a><td>    copied.fulfill(dst);<tr><td><a id="l73"></a><a href="#l73">73</a><td>  });<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td>  var ws = fs.createWriteStream(dst);<tr><td><a id="l76"></a><a href="#l76">76</a><td>  ws.on(&#39;error&#39;, copied.reject);<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>  rs.pipe(ws);<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td>  return copied.promise;<tr><td><a id="l81"></a><a href="#l81">81</a><td>};<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td>/**<tr><td><a id="l85"></a><a href="#l85">85</a><td> * Recursively copies the contents of one directory to another.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @param {string} src The source directory to copy.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @param {string} dst The directory to copy into.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {(RegEx|function(string): boolean)=} opt_exclude An exclusion filter<tr><td><a id="l89"></a><a href="#l89">89</a><td> *     as either a regex or predicate function. All files matching this filter<tr><td><a id="l90"></a><a href="#l90">90</a><td> *     will not be copied.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the destination<tr><td><a id="l92"></a><a href="#l92">92</a><td> *     directory&#39;s path once all files have been copied.<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td>exports.copyDir = function(src, dst, opt_exclude) {<tr><td><a id="l95"></a><a href="#l95">95</a><td>  var predicate = opt_exclude;<tr><td><a id="l96"></a><a href="#l96">96</a><td>  if (opt_exclude &amp;&amp; typeof opt_exclude !== &#39;function&#39;) {<tr><td><a id="l97"></a><a href="#l97">97</a><td>    predicate = function(p) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>      return !opt_exclude.test(p);<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>  // TODO(jleyba): Make this function completely async.<tr><td><a id="l103"></a><a href="#l103">103</a><td>  if (!fs.existsSync(dst)) {<tr><td><a id="l104"></a><a href="#l104">104</a><td>    fs.mkdirSync(dst);<tr><td><a id="l105"></a><a href="#l105">105</a><td>  }<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td>  var files = fs.readdirSync(src);<tr><td><a id="l108"></a><a href="#l108">108</a><td>  files = files.map(function(file) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>    return path.join(src, file);<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>  if (predicate) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>    files = files.filter(predicate);<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>  var results = [];<tr><td><a id="l117"></a><a href="#l117">117</a><td>  files.forEach(function(file) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    var stats = fs.statSync(file);<tr><td><a id="l119"></a><a href="#l119">119</a><td>    var target = path.join(dst, path.basename(file));<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>    if (stats.isDirectory()) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>      if (!fs.existsSync(target)) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>        fs.mkdirSync(target, stats.mode);<tr><td><a id="l124"></a><a href="#l124">124</a><td>      }<tr><td><a id="l125"></a><a href="#l125">125</a><td>      results.push(exports.copyDir(file, target, predicate));<tr><td><a id="l126"></a><a href="#l126">126</a><td>    } else {<tr><td><a id="l127"></a><a href="#l127">127</a><td>      results.push(exports.copy(file, target));<tr><td><a id="l128"></a><a href="#l128">128</a><td>    }<tr><td><a id="l129"></a><a href="#l129">129</a><td>  });<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>  return promise.all(results).then(function() {<tr><td><a id="l132"></a><a href="#l132">132</a><td>    return dst;<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><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Tests if a file path exists.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {string} path The path to test.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @return {!promise.Promise.&lt;boolean&gt;} A promise for whether the file exists.<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td>exports.exists = function(path) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>  var result = promise.defer();<tr><td><a id="l144"></a><a href="#l144">144</a><td>  fs.exists(path, result.fulfill);<tr><td><a id="l145"></a><a href="#l145">145</a><td>  return result.promise;<tr><td><a id="l146"></a><a href="#l146">146</a><td>};<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>/**<tr><td><a id="l150"></a><a href="#l150">150</a><td> * Deletes a name from the filesystem and possibly the file it refers to. Has<tr><td><a id="l151"></a><a href="#l151">151</a><td> * no effect if the file does not exist.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @param {string} path The path to remove.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @return {!promise.Promise} A promise for when the file has been removed.<tr><td><a id="l154"></a><a href="#l154">154</a><td> */<tr><td><a id="l155"></a><a href="#l155">155</a><td>exports.unlink = function(path) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>  return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l157"></a><a href="#l157">157</a><td>    fs.exists(path, function(exists) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>      if (exists) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>        fs.unlink(path, function(err) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>          err &amp;&amp; reject(err) || fulfill();<tr><td><a id="l161"></a><a href="#l161">161</a><td>        });<tr><td><a id="l162"></a><a href="#l162">162</a><td>      } else {<tr><td><a id="l163"></a><a href="#l163">163</a><td>        fulfill();<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><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> * @return {!promise.Promise.&lt;string&gt;} A promise for the path to a temporary<tr><td><a id="l172"></a><a href="#l172">172</a><td> *     directory.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @see https://www.npmjs.org/package/tmp<tr><td><a id="l174"></a><a href="#l174">174</a><td> */<tr><td><a id="l175"></a><a href="#l175">175</a><td>exports.tmpDir = function() {<tr><td><a id="l176"></a><a href="#l176">176</a><td>  return promise.checkedNodeCall(tmp.dir);<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> * @param {{postfix: string}=} opt_options Temporary file options.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise for the path to a temporary<tr><td><a id="l183"></a><a href="#l183">183</a><td> *     file.<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @see https://www.npmjs.org/package/tmp<tr><td><a id="l185"></a><a href="#l185">185</a><td> */<tr><td><a id="l186"></a><a href="#l186">186</a><td>exports.tmpFile = function(opt_options) {<tr><td><a id="l187"></a><a href="#l187">187</a><td>  // |tmp.file| checks arguments length to detect options rather than doing a<tr><td><a id="l188"></a><a href="#l188">188</a><td>  // truthy check, so we must only pass options if there are some to pass.<tr><td><a id="l189"></a><a href="#l189">189</a><td>  return opt_options ?<tr><td><a id="l190"></a><a href="#l190">190</a><td>      promise.checkedNodeCall(tmp.file, opt_options) :<tr><td><a id="l191"></a><a href="#l191">191</a><td>      promise.checkedNodeCall(tmp.file);<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>/**<tr><td><a id="l196"></a><a href="#l196">196</a><td> * Searches the {@code PATH} environment variable for the given file.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @param {string} file The file to locate on the PATH.<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @param {boolean=} opt_checkCwd Whether to always start with the search with<tr><td><a id="l199"></a><a href="#l199">199</a><td> *     the current working directory, regardless of whether it is explicitly<tr><td><a id="l200"></a><a href="#l200">200</a><td> *     listed on the PATH.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @return {?string} Path to the located file, or {@code null} if it could<tr><td><a id="l202"></a><a href="#l202">202</a><td> *     not be found.<tr><td><a id="l203"></a><a href="#l203">203</a><td> */<tr><td><a id="l204"></a><a href="#l204">204</a><td>exports.findInPath = function(file, opt_checkCwd) {<tr><td><a id="l205"></a><a href="#l205">205</a><td>  if (opt_checkCwd) {<tr><td><a id="l206"></a><a href="#l206">206</a><td>    var tmp = path.join(process.cwd(), file);<tr><td><a id="l207"></a><a href="#l207">207</a><td>    if (fs.existsSync(tmp)) {<tr><td><a id="l208"></a><a href="#l208">208</a><td>      return tmp;<tr><td><a id="l209"></a><a href="#l209">209</a><td>    }<tr><td><a id="l210"></a><a href="#l210">210</a><td>  }<tr><td><a id="l211"></a><a href="#l211">211</a><td><tr><td><a id="l212"></a><a href="#l212">212</a><td>  var dirs = process.env[&#39;PATH&#39;].split(path.delimiter);<tr><td><a id="l213"></a><a href="#l213">213</a><td>  var found = null;<tr><td><a id="l214"></a><a href="#l214">214</a><td>  dirs.forEach(function(dir) {<tr><td><a id="l215"></a><a href="#l215">215</a><td>    var tmp = path.join(dir, file);<tr><td><a id="l216"></a><a href="#l216">216</a><td>    if (!found &amp;&amp; fs.existsSync(tmp)) {<tr><td><a id="l217"></a><a href="#l217">217</a><td>      found = tmp;<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>  return found;<tr><td><a id="l221"></a><a href="#l221">221</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>
\ No newline at end of file
diff --git a/docs/source/lib/atoms/error.js.src.html b/docs/source/lib/atoms/error.js.src.html
index b9696c3..201fcac 100644
--- a/docs/source/lib/atoms/error.js.src.html
+++ b/docs/source/lib/atoms/error.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>error.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/atoms/error.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2010 WebDriver committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2010 Google Inc.<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>// You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview Utilities for working with errors as defined by WebDriver&#39;s<tr><td><a name="l18" href="#l18">18</a><td> * wire protocol: http://code.google.com/p/selenium/wiki/JsonWireProtocol.<tr><td><a name="l19" href="#l19">19</a><td> */<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;bot.Error&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;bot.ErrorCode&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * Error codes from the WebDriver wire protocol:<tr><td><a name="l27" href="#l27">27</a><td> * http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes<tr><td><a name="l28" href="#l28">28</a><td> *<tr><td><a name="l29" href="#l29">29</a><td> * @enum {number}<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>bot.ErrorCode = {<tr><td><a name="l32" href="#l32">32</a><td>  SUCCESS: 0,  // Included for completeness<tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td>  NO_SUCH_ELEMENT: 7,<tr><td><a name="l35" href="#l35">35</a><td>  NO_SUCH_FRAME: 8,<tr><td><a name="l36" href="#l36">36</a><td>  UNKNOWN_COMMAND: 9,<tr><td><a name="l37" href="#l37">37</a><td>  UNSUPPORTED_OPERATION: 9,  // Alias.<tr><td><a name="l38" href="#l38">38</a><td>  STALE_ELEMENT_REFERENCE: 10,<tr><td><a name="l39" href="#l39">39</a><td>  ELEMENT_NOT_VISIBLE: 11,<tr><td><a name="l40" href="#l40">40</a><td>  INVALID_ELEMENT_STATE: 12,<tr><td><a name="l41" href="#l41">41</a><td>  UNKNOWN_ERROR: 13,<tr><td><a name="l42" href="#l42">42</a><td>  ELEMENT_NOT_SELECTABLE: 15,<tr><td><a name="l43" href="#l43">43</a><td>  JAVASCRIPT_ERROR: 17,<tr><td><a name="l44" href="#l44">44</a><td>  XPATH_LOOKUP_ERROR: 19,<tr><td><a name="l45" href="#l45">45</a><td>  TIMEOUT: 21,<tr><td><a name="l46" href="#l46">46</a><td>  NO_SUCH_WINDOW: 23,<tr><td><a name="l47" href="#l47">47</a><td>  INVALID_COOKIE_DOMAIN: 24,<tr><td><a name="l48" href="#l48">48</a><td>  UNABLE_TO_SET_COOKIE: 25,<tr><td><a name="l49" href="#l49">49</a><td>  MODAL_DIALOG_OPENED: 26,<tr><td><a name="l50" href="#l50">50</a><td>  NO_MODAL_DIALOG_OPEN: 27,<tr><td><a name="l51" href="#l51">51</a><td>  SCRIPT_TIMEOUT: 28,<tr><td><a name="l52" href="#l52">52</a><td>  INVALID_ELEMENT_COORDINATES: 29,<tr><td><a name="l53" href="#l53">53</a><td>  IME_NOT_AVAILABLE: 30,<tr><td><a name="l54" href="#l54">54</a><td>  IME_ENGINE_ACTIVATION_FAILED: 31,<tr><td><a name="l55" href="#l55">55</a><td>  INVALID_SELECTOR_ERROR: 32,<tr><td><a name="l56" href="#l56">56</a><td>  SESSION_NOT_CREATED: 33,<tr><td><a name="l57" href="#l57">57</a><td>  MOVE_TARGET_OUT_OF_BOUNDS: 34,<tr><td><a name="l58" href="#l58">58</a><td>  SQL_DATABASE_ERROR: 35,<tr><td><a name="l59" href="#l59">59</a><td>  INVALID_XPATH_SELECTOR: 51,<tr><td><a name="l60" href="#l60">60</a><td>  INVALID_XPATH_SELECTOR_RETURN_TYPE: 52,<tr><td><a name="l61" href="#l61">61</a><td>  // The following error codes are derived straight from HTTP return codes.<tr><td><a name="l62" href="#l62">62</a><td>  METHOD_NOT_ALLOWED: 405<tr><td><a name="l63" href="#l63">63</a><td>};<tr><td><a name="l64" href="#l64">64</a><td><tr><td><a name="l65" href="#l65">65</a><td><tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td>/**<tr><td><a name="l68" href="#l68">68</a><td> * Error extension that includes error status codes from the WebDriver wire<tr><td><a name="l69" href="#l69">69</a><td> * protocol:<tr><td><a name="l70" href="#l70">70</a><td> * http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes<tr><td><a name="l71" href="#l71">71</a><td> *<tr><td><a name="l72" href="#l72">72</a><td> * @param {!bot.ErrorCode} code The error&#39;s status code.<tr><td><a name="l73" href="#l73">73</a><td> * @param {string=} opt_message Optional error message.<tr><td><a name="l74" href="#l74">74</a><td> * @constructor<tr><td><a name="l75" href="#l75">75</a><td> * @extends {Error}<tr><td><a name="l76" href="#l76">76</a><td> */<tr><td><a name="l77" href="#l77">77</a><td>bot.Error = function(code, opt_message) {<tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td>  /**<tr><td><a name="l80" href="#l80">80</a><td>   * This error&#39;s status code.<tr><td><a name="l81" href="#l81">81</a><td>   * @type {!bot.ErrorCode}<tr><td><a name="l82" href="#l82">82</a><td>   */<tr><td><a name="l83" href="#l83">83</a><td>  this.code = code;<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td>  /** @type {string} */<tr><td><a name="l86" href="#l86">86</a><td>  this.state =<tr><td><a name="l87" href="#l87">87</a><td>      bot.Error.CODE_TO_STATE_[code] || bot.Error.State.UNKNOWN_ERROR;<tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>  /** @override */<tr><td><a name="l90" href="#l90">90</a><td>  this.message = opt_message || &#39;&#39;;<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td>  var name = this.state.replace(/((?:^|\s+)[a-z])/g, function(str) {<tr><td><a name="l93" href="#l93">93</a><td>    // IE&lt;9 does not support String#trim(). Also, IE does not include 0xa0<tr><td><a name="l94" href="#l94">94</a><td>    // (the non-breaking-space) in the \s character class, so we have to<tr><td><a name="l95" href="#l95">95</a><td>    // explicitly include it.<tr><td><a name="l96" href="#l96">96</a><td>    return str.toUpperCase().replace(/^[\s\xa0]+/g, &#39;&#39;);<tr><td><a name="l97" href="#l97">97</a><td>  });<tr><td><a name="l98" href="#l98">98</a><td><tr><td><a name="l99" href="#l99">99</a><td>  var l = name.length - &#39;Error&#39;.length;<tr><td><a name="l100" href="#l100">100</a><td>  if (l &lt; 0 || name.indexOf(&#39;Error&#39;, l) != l) {<tr><td><a name="l101" href="#l101">101</a><td>    name += &#39;Error&#39;;<tr><td><a name="l102" href="#l102">102</a><td>  }<tr><td><a name="l103" href="#l103">103</a><td><tr><td><a name="l104" href="#l104">104</a><td>  /** @override */<tr><td><a name="l105" href="#l105">105</a><td>  this.name = name;<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td>  // Generate a stacktrace for our custom error; ensure the error has our<tr><td><a name="l108" href="#l108">108</a><td>  // custom name and message so the stack prints correctly in all browsers.<tr><td><a name="l109" href="#l109">109</a><td>  var template = new Error(this.message);<tr><td><a name="l110" href="#l110">110</a><td>  template.name = this.name;<tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td>  /** @override */<tr><td><a name="l113" href="#l113">113</a><td>  this.stack = template.stack || &#39;&#39;;<tr><td><a name="l114" href="#l114">114</a><td>};<tr><td><a name="l115" href="#l115">115</a><td>goog.inherits(bot.Error, Error);<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td>/**<tr><td><a name="l119" href="#l119">119</a><td> * Status strings enumerated in the W3C WebDriver working draft.<tr><td><a name="l120" href="#l120">120</a><td> * @enum {string}<tr><td><a name="l121" href="#l121">121</a><td> * @see http://www.w3.org/TR/webdriver/#status-codes<tr><td><a name="l122" href="#l122">122</a><td> */<tr><td><a name="l123" href="#l123">123</a><td>bot.Error.State = {<tr><td><a name="l124" href="#l124">124</a><td>  ELEMENT_NOT_SELECTABLE: &#39;element not selectable&#39;,<tr><td><a name="l125" href="#l125">125</a><td>  ELEMENT_NOT_VISIBLE: &#39;element not visible&#39;,<tr><td><a name="l126" href="#l126">126</a><td>  IME_ENGINE_ACTIVATION_FAILED: &#39;ime engine activation failed&#39;,<tr><td><a name="l127" href="#l127">127</a><td>  IME_NOT_AVAILABLE: &#39;ime not available&#39;,<tr><td><a name="l128" href="#l128">128</a><td>  INVALID_COOKIE_DOMAIN: &#39;invalid cookie domain&#39;,<tr><td><a name="l129" href="#l129">129</a><td>  INVALID_ELEMENT_COORDINATES: &#39;invalid element coordinates&#39;,<tr><td><a name="l130" href="#l130">130</a><td>  INVALID_ELEMENT_STATE: &#39;invalid element state&#39;,<tr><td><a name="l131" href="#l131">131</a><td>  INVALID_SELECTOR: &#39;invalid selector&#39;,<tr><td><a name="l132" href="#l132">132</a><td>  JAVASCRIPT_ERROR: &#39;javascript error&#39;,<tr><td><a name="l133" href="#l133">133</a><td>  MOVE_TARGET_OUT_OF_BOUNDS: &#39;move target out of bounds&#39;,<tr><td><a name="l134" href="#l134">134</a><td>  NO_SUCH_ALERT: &#39;no such alert&#39;,<tr><td><a name="l135" href="#l135">135</a><td>  NO_SUCH_DOM: &#39;no such dom&#39;,<tr><td><a name="l136" href="#l136">136</a><td>  NO_SUCH_ELEMENT: &#39;no such element&#39;,<tr><td><a name="l137" href="#l137">137</a><td>  NO_SUCH_FRAME: &#39;no such frame&#39;,<tr><td><a name="l138" href="#l138">138</a><td>  NO_SUCH_WINDOW: &#39;no such window&#39;,<tr><td><a name="l139" href="#l139">139</a><td>  SCRIPT_TIMEOUT: &#39;script timeout&#39;,<tr><td><a name="l140" href="#l140">140</a><td>  SESSION_NOT_CREATED: &#39;session not created&#39;,<tr><td><a name="l141" href="#l141">141</a><td>  STALE_ELEMENT_REFERENCE: &#39;stale element reference&#39;,<tr><td><a name="l142" href="#l142">142</a><td>  SUCCESS: &#39;success&#39;,<tr><td><a name="l143" href="#l143">143</a><td>  TIMEOUT: &#39;timeout&#39;,<tr><td><a name="l144" href="#l144">144</a><td>  UNABLE_TO_SET_COOKIE: &#39;unable to set cookie&#39;,<tr><td><a name="l145" href="#l145">145</a><td>  UNEXPECTED_ALERT_OPEN: &#39;unexpected alert open&#39;,<tr><td><a name="l146" href="#l146">146</a><td>  UNKNOWN_COMMAND: &#39;unknown command&#39;,<tr><td><a name="l147" href="#l147">147</a><td>  UNKNOWN_ERROR: &#39;unknown error&#39;,<tr><td><a name="l148" href="#l148">148</a><td>  UNSUPPORTED_OPERATION: &#39;unsupported operation&#39;<tr><td><a name="l149" href="#l149">149</a><td>};<tr><td><a name="l150" href="#l150">150</a><td><tr><td><a name="l151" href="#l151">151</a><td><tr><td><a name="l152" href="#l152">152</a><td>/**<tr><td><a name="l153" href="#l153">153</a><td> * A map of error codes to state string.<tr><td><a name="l154" href="#l154">154</a><td> * @private {!Object.&lt;bot.ErrorCode, bot.Error.State&gt;}<tr><td><a name="l155" href="#l155">155</a><td> */<tr><td><a name="l156" href="#l156">156</a><td>bot.Error.CODE_TO_STATE_ = {};<tr><td><a name="l157" href="#l157">157</a><td>goog.scope(function() {<tr><td><a name="l158" href="#l158">158</a><td>  var map = bot.Error.CODE_TO_STATE_;<tr><td><a name="l159" href="#l159">159</a><td>  var code = bot.ErrorCode;<tr><td><a name="l160" href="#l160">160</a><td>  var state = bot.Error.State;<tr><td><a name="l161" href="#l161">161</a><td><tr><td><a name="l162" href="#l162">162</a><td>  map[code.ELEMENT_NOT_SELECTABLE] = state.ELEMENT_NOT_SELECTABLE;<tr><td><a name="l163" href="#l163">163</a><td>  map[code.ELEMENT_NOT_VISIBLE] = state.ELEMENT_NOT_VISIBLE;<tr><td><a name="l164" href="#l164">164</a><td>  map[code.IME_ENGINE_ACTIVATION_FAILED] = state.IME_ENGINE_ACTIVATION_FAILED;<tr><td><a name="l165" href="#l165">165</a><td>  map[code.IME_NOT_AVAILABLE] = state.IME_NOT_AVAILABLE;<tr><td><a name="l166" href="#l166">166</a><td>  map[code.INVALID_COOKIE_DOMAIN] = state.INVALID_COOKIE_DOMAIN;<tr><td><a name="l167" href="#l167">167</a><td>  map[code.INVALID_ELEMENT_COORDINATES] = state.INVALID_ELEMENT_COORDINATES;<tr><td><a name="l168" href="#l168">168</a><td>  map[code.INVALID_ELEMENT_STATE] = state.INVALID_ELEMENT_STATE;<tr><td><a name="l169" href="#l169">169</a><td>  map[code.INVALID_SELECTOR_ERROR] = state.INVALID_SELECTOR;<tr><td><a name="l170" href="#l170">170</a><td>  map[code.INVALID_XPATH_SELECTOR] = state.INVALID_SELECTOR;<tr><td><a name="l171" href="#l171">171</a><td>  map[code.INVALID_XPATH_SELECTOR_RETURN_TYPE] = state.INVALID_SELECTOR;<tr><td><a name="l172" href="#l172">172</a><td>  map[code.JAVASCRIPT_ERROR] = state.JAVASCRIPT_ERROR;<tr><td><a name="l173" href="#l173">173</a><td>  map[code.METHOD_NOT_ALLOWED] = state.UNSUPPORTED_OPERATION;<tr><td><a name="l174" href="#l174">174</a><td>  map[code.MOVE_TARGET_OUT_OF_BOUNDS] = state.MOVE_TARGET_OUT_OF_BOUNDS;<tr><td><a name="l175" href="#l175">175</a><td>  map[code.NO_MODAL_DIALOG_OPEN] = state.NO_SUCH_ALERT;<tr><td><a name="l176" href="#l176">176</a><td>  map[code.NO_SUCH_ELEMENT] = state.NO_SUCH_ELEMENT;<tr><td><a name="l177" href="#l177">177</a><td>  map[code.NO_SUCH_FRAME] = state.NO_SUCH_FRAME;<tr><td><a name="l178" href="#l178">178</a><td>  map[code.NO_SUCH_WINDOW] = state.NO_SUCH_WINDOW;<tr><td><a name="l179" href="#l179">179</a><td>  map[code.SCRIPT_TIMEOUT] = state.SCRIPT_TIMEOUT;<tr><td><a name="l180" href="#l180">180</a><td>  map[code.SESSION_NOT_CREATED] = state.SESSION_NOT_CREATED;<tr><td><a name="l181" href="#l181">181</a><td>  map[code.STALE_ELEMENT_REFERENCE] = state.STALE_ELEMENT_REFERENCE;<tr><td><a name="l182" href="#l182">182</a><td>  map[code.SUCCESS] = state.SUCCESS;<tr><td><a name="l183" href="#l183">183</a><td>  map[code.TIMEOUT] = state.TIMEOUT;<tr><td><a name="l184" href="#l184">184</a><td>  map[code.UNABLE_TO_SET_COOKIE] = state.UNABLE_TO_SET_COOKIE;<tr><td><a name="l185" href="#l185">185</a><td>  map[code.MODAL_DIALOG_OPENED] = state.UNEXPECTED_ALERT_OPEN;<tr><td><a name="l186" href="#l186">186</a><td>  map[code.UNKNOWN_ERROR] = state.UNKNOWN_ERROR;<tr><td><a name="l187" href="#l187">187</a><td>  map[code.UNSUPPORTED_OPERATION] = state.UNKNOWN_COMMAND;<tr><td><a name="l188" href="#l188">188</a><td>});  // goog.scope<tr><td><a name="l189" href="#l189">189</a><td><tr><td><a name="l190" href="#l190">190</a><td><tr><td><a name="l191" href="#l191">191</a><td>/**<tr><td><a name="l192" href="#l192">192</a><td> * Flag used for duck-typing when this code is embedded in a Firefox extension.<tr><td><a name="l193" href="#l193">193</a><td> * This is required since an Error thrown in one component and then reported<tr><td><a name="l194" href="#l194">194</a><td> * to another will fail instanceof checks in the second component.<tr><td><a name="l195" href="#l195">195</a><td> * @type {boolean}<tr><td><a name="l196" href="#l196">196</a><td> */<tr><td><a name="l197" href="#l197">197</a><td>bot.Error.prototype.isAutomationError = true;<tr><td><a name="l198" href="#l198">198</a><td><tr><td><a name="l199" href="#l199">199</a><td><tr><td><a name="l200" href="#l200">200</a><td>if (goog.DEBUG) {<tr><td><a name="l201" href="#l201">201</a><td>  /** @return {string} The string representation of this error. */<tr><td><a name="l202" href="#l202">202</a><td>  bot.Error.prototype.toString = function() {<tr><td><a name="l203" href="#l203">203</a><td>    return this.name + &#39;: &#39; + this.message;<tr><td><a name="l204" href="#l204">204</a><td>  };<tr><td><a name="l205" href="#l205">205</a><td>}</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>error.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/atoms/error.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Utilities for working with errors as defined by WebDriver&#39;s<tr><td><a id="l20"></a><a href="#l20">20</a><td> * wire protocol: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol<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>goog.provide(&#39;bot.Error&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;bot.ErrorCode&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * Error codes from the Selenium WebDriver protocol:<tr><td><a id="l29"></a><a href="#l29">29</a><td> * https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#response-status-codes<tr><td><a id="l30"></a><a href="#l30">30</a><td> *<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @enum {number}<tr><td><a id="l32"></a><a href="#l32">32</a><td> */<tr><td><a id="l33"></a><a href="#l33">33</a><td>bot.ErrorCode = {<tr><td><a id="l34"></a><a href="#l34">34</a><td>  SUCCESS: 0,  // Included for completeness<tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>  NO_SUCH_ELEMENT: 7,<tr><td><a id="l37"></a><a href="#l37">37</a><td>  NO_SUCH_FRAME: 8,<tr><td><a id="l38"></a><a href="#l38">38</a><td>  UNKNOWN_COMMAND: 9,<tr><td><a id="l39"></a><a href="#l39">39</a><td>  UNSUPPORTED_OPERATION: 9,  // Alias.<tr><td><a id="l40"></a><a href="#l40">40</a><td>  STALE_ELEMENT_REFERENCE: 10,<tr><td><a id="l41"></a><a href="#l41">41</a><td>  ELEMENT_NOT_VISIBLE: 11,<tr><td><a id="l42"></a><a href="#l42">42</a><td>  INVALID_ELEMENT_STATE: 12,<tr><td><a id="l43"></a><a href="#l43">43</a><td>  UNKNOWN_ERROR: 13,<tr><td><a id="l44"></a><a href="#l44">44</a><td>  ELEMENT_NOT_SELECTABLE: 15,<tr><td><a id="l45"></a><a href="#l45">45</a><td>  JAVASCRIPT_ERROR: 17,<tr><td><a id="l46"></a><a href="#l46">46</a><td>  XPATH_LOOKUP_ERROR: 19,<tr><td><a id="l47"></a><a href="#l47">47</a><td>  TIMEOUT: 21,<tr><td><a id="l48"></a><a href="#l48">48</a><td>  NO_SUCH_WINDOW: 23,<tr><td><a id="l49"></a><a href="#l49">49</a><td>  INVALID_COOKIE_DOMAIN: 24,<tr><td><a id="l50"></a><a href="#l50">50</a><td>  UNABLE_TO_SET_COOKIE: 25,<tr><td><a id="l51"></a><a href="#l51">51</a><td>  UNEXPECTED_ALERT_OPEN: 26,<tr><td><a id="l52"></a><a href="#l52">52</a><td>  NO_SUCH_ALERT: 27,<tr><td><a id="l53"></a><a href="#l53">53</a><td>  SCRIPT_TIMEOUT: 28,<tr><td><a id="l54"></a><a href="#l54">54</a><td>  INVALID_ELEMENT_COORDINATES: 29,<tr><td><a id="l55"></a><a href="#l55">55</a><td>  IME_NOT_AVAILABLE: 30,<tr><td><a id="l56"></a><a href="#l56">56</a><td>  IME_ENGINE_ACTIVATION_FAILED: 31,<tr><td><a id="l57"></a><a href="#l57">57</a><td>  INVALID_SELECTOR_ERROR: 32,<tr><td><a id="l58"></a><a href="#l58">58</a><td>  SESSION_NOT_CREATED: 33,<tr><td><a id="l59"></a><a href="#l59">59</a><td>  MOVE_TARGET_OUT_OF_BOUNDS: 34,<tr><td><a id="l60"></a><a href="#l60">60</a><td>  SQL_DATABASE_ERROR: 35,<tr><td><a id="l61"></a><a href="#l61">61</a><td>  INVALID_XPATH_SELECTOR: 51,<tr><td><a id="l62"></a><a href="#l62">62</a><td>  INVALID_XPATH_SELECTOR_RETURN_TYPE: 52,<tr><td><a id="l63"></a><a href="#l63">63</a><td>  // The following error codes are derived straight from HTTP return codes.<tr><td><a id="l64"></a><a href="#l64">64</a><td>  METHOD_NOT_ALLOWED: 405<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>/**<tr><td><a id="l69"></a><a href="#l69">69</a><td> * Represents an error returned from a WebDriver command request.<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 {!bot.ErrorCode} code The error&#39;s status code.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @param {string=} opt_message Optional error message.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @constructor<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @extends {Error}<tr><td><a id="l75"></a><a href="#l75">75</a><td> */<tr><td><a id="l76"></a><a href="#l76">76</a><td>bot.Error = function(code, opt_message) {<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>   * This error&#39;s status code.<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * @type {!bot.ErrorCode}<tr><td><a id="l81"></a><a href="#l81">81</a><td>   */<tr><td><a id="l82"></a><a href="#l82">82</a><td>  this.code = code;<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td>  /** @type {string} */<tr><td><a id="l85"></a><a href="#l85">85</a><td>  this.state =<tr><td><a id="l86"></a><a href="#l86">86</a><td>      bot.Error.CODE_TO_STATE_[code] || bot.Error.State.UNKNOWN_ERROR;<tr><td><a id="l87"></a><a href="#l87">87</a><td><tr><td><a id="l88"></a><a href="#l88">88</a><td>  /** @override */<tr><td><a id="l89"></a><a href="#l89">89</a><td>  this.message = opt_message || &#39;&#39;;<tr><td><a id="l90"></a><a href="#l90">90</a><td><tr><td><a id="l91"></a><a href="#l91">91</a><td>  var name = this.state.replace(/((?:^|\s+)[a-z])/g, function(str) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>    // IE&lt;9 does not support String#trim(). Also, IE does not include 0xa0<tr><td><a id="l93"></a><a href="#l93">93</a><td>    // (the non-breaking-space) in the \s character class, so we have to<tr><td><a id="l94"></a><a href="#l94">94</a><td>    // explicitly include it.<tr><td><a id="l95"></a><a href="#l95">95</a><td>    return str.toUpperCase().replace(/^[\s\xa0]+/g, &#39;&#39;);<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>  var l = name.length - &#39;Error&#39;.length;<tr><td><a id="l99"></a><a href="#l99">99</a><td>  if (l &lt; 0 || name.indexOf(&#39;Error&#39;, l) != l) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>    name += &#39;Error&#39;;<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>  /** @override */<tr><td><a id="l104"></a><a href="#l104">104</a><td>  this.name = name;<tr><td><a id="l105"></a><a href="#l105">105</a><td><tr><td><a id="l106"></a><a href="#l106">106</a><td>  // Generate a stacktrace for our custom error; ensure the error has our<tr><td><a id="l107"></a><a href="#l107">107</a><td>  // custom name and message so the stack prints correctly in all browsers.<tr><td><a id="l108"></a><a href="#l108">108</a><td>  var template = new Error(this.message);<tr><td><a id="l109"></a><a href="#l109">109</a><td>  template.name = this.name;<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td>  /** @override */<tr><td><a id="l112"></a><a href="#l112">112</a><td>  this.stack = template.stack || &#39;&#39;;<tr><td><a id="l113"></a><a href="#l113">113</a><td>};<tr><td><a id="l114"></a><a href="#l114">114</a><td>goog.inherits(bot.Error, Error);<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> * Status strings enumerated in the W3C WebDriver protocol.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @enum {string}<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @see https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors<tr><td><a id="l121"></a><a href="#l121">121</a><td> */<tr><td><a id="l122"></a><a href="#l122">122</a><td>bot.Error.State = {<tr><td><a id="l123"></a><a href="#l123">123</a><td>  ELEMENT_NOT_SELECTABLE: &#39;element not selectable&#39;,<tr><td><a id="l124"></a><a href="#l124">124</a><td>  ELEMENT_NOT_VISIBLE: &#39;element not visible&#39;,<tr><td><a id="l125"></a><a href="#l125">125</a><td>  INVALID_ARGUMENT: &#39;invalid argument&#39;,<tr><td><a id="l126"></a><a href="#l126">126</a><td>  INVALID_COOKIE_DOMAIN: &#39;invalid cookie domain&#39;,<tr><td><a id="l127"></a><a href="#l127">127</a><td>  INVALID_ELEMENT_COORDINATES: &#39;invalid element coordinates&#39;,<tr><td><a id="l128"></a><a href="#l128">128</a><td>  INVALID_ELEMENT_STATE: &#39;invalid element state&#39;,<tr><td><a id="l129"></a><a href="#l129">129</a><td>  INVALID_SELECTOR: &#39;invalid selector&#39;,<tr><td><a id="l130"></a><a href="#l130">130</a><td>  INVALID_SESSION_ID: &#39;invalid session id&#39;,<tr><td><a id="l131"></a><a href="#l131">131</a><td>  JAVASCRIPT_ERROR: &#39;javascript error&#39;,<tr><td><a id="l132"></a><a href="#l132">132</a><td>  MOVE_TARGET_OUT_OF_BOUNDS: &#39;move target out of bounds&#39;,<tr><td><a id="l133"></a><a href="#l133">133</a><td>  NO_SUCH_ALERT: &#39;no such alert&#39;,<tr><td><a id="l134"></a><a href="#l134">134</a><td>  NO_SUCH_ELEMENT: &#39;no such element&#39;,<tr><td><a id="l135"></a><a href="#l135">135</a><td>  NO_SUCH_FRAME: &#39;no such frame&#39;,<tr><td><a id="l136"></a><a href="#l136">136</a><td>  NO_SUCH_WINDOW: &#39;no such window&#39;,<tr><td><a id="l137"></a><a href="#l137">137</a><td>  SCRIPT_TIMEOUT: &#39;script timeout&#39;,<tr><td><a id="l138"></a><a href="#l138">138</a><td>  SESSION_NOT_CREATED: &#39;session not created&#39;,<tr><td><a id="l139"></a><a href="#l139">139</a><td>  STALE_ELEMENT_REFERENCE: &#39;stale element reference&#39;,<tr><td><a id="l140"></a><a href="#l140">140</a><td>  TIMEOUT: &#39;timeout&#39;,<tr><td><a id="l141"></a><a href="#l141">141</a><td>  UNABLE_TO_SET_COOKIE: &#39;unable to set cookie&#39;,<tr><td><a id="l142"></a><a href="#l142">142</a><td>  UNEXPECTED_ALERT_OPEN: &#39;unexpected alert open&#39;,<tr><td><a id="l143"></a><a href="#l143">143</a><td>  UNKNOWN_COMMAND: &#39;unknown command&#39;,<tr><td><a id="l144"></a><a href="#l144">144</a><td>  UNKNOWN_ERROR: &#39;unknown error&#39;,<tr><td><a id="l145"></a><a href="#l145">145</a><td>  UNKNOWN_METHOD: &#39;unknown method&#39;,<tr><td><a id="l146"></a><a href="#l146">146</a><td>  UNSUPPORTED_OPERATION: &#39;unsupported operation&#39;<tr><td><a id="l147"></a><a href="#l147">147</a><td>};<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>/**<tr><td><a id="l151"></a><a href="#l151">151</a><td> * A map of error codes to state string.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @private {!Object.&lt;bot.ErrorCode, bot.Error.State&gt;}<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td>bot.Error.CODE_TO_STATE_ = {};<tr><td><a id="l155"></a><a href="#l155">155</a><td>goog.scope(function() {<tr><td><a id="l156"></a><a href="#l156">156</a><td>  var map = bot.Error.CODE_TO_STATE_;<tr><td><a id="l157"></a><a href="#l157">157</a><td>  var code = bot.ErrorCode;<tr><td><a id="l158"></a><a href="#l158">158</a><td>  var state = bot.Error.State;<tr><td><a id="l159"></a><a href="#l159">159</a><td><tr><td><a id="l160"></a><a href="#l160">160</a><td>  map[code.ELEMENT_NOT_SELECTABLE] = state.ELEMENT_NOT_SELECTABLE;<tr><td><a id="l161"></a><a href="#l161">161</a><td>  map[code.ELEMENT_NOT_VISIBLE] = state.ELEMENT_NOT_VISIBLE;<tr><td><a id="l162"></a><a href="#l162">162</a><td>  map[code.IME_ENGINE_ACTIVATION_FAILED] = state.UNKNOWN_ERROR;<tr><td><a id="l163"></a><a href="#l163">163</a><td>  map[code.IME_NOT_AVAILABLE] = state.UNKNOWN_ERROR;<tr><td><a id="l164"></a><a href="#l164">164</a><td>  map[code.INVALID_COOKIE_DOMAIN] = state.INVALID_COOKIE_DOMAIN;<tr><td><a id="l165"></a><a href="#l165">165</a><td>  map[code.INVALID_ELEMENT_COORDINATES] = state.INVALID_ELEMENT_COORDINATES;<tr><td><a id="l166"></a><a href="#l166">166</a><td>  map[code.INVALID_ELEMENT_STATE] = state.INVALID_ELEMENT_STATE;<tr><td><a id="l167"></a><a href="#l167">167</a><td>  map[code.INVALID_SELECTOR_ERROR] = state.INVALID_SELECTOR;<tr><td><a id="l168"></a><a href="#l168">168</a><td>  map[code.INVALID_XPATH_SELECTOR] = state.INVALID_SELECTOR;<tr><td><a id="l169"></a><a href="#l169">169</a><td>  map[code.INVALID_XPATH_SELECTOR_RETURN_TYPE] = state.INVALID_SELECTOR;<tr><td><a id="l170"></a><a href="#l170">170</a><td>  map[code.JAVASCRIPT_ERROR] = state.JAVASCRIPT_ERROR;<tr><td><a id="l171"></a><a href="#l171">171</a><td>  map[code.METHOD_NOT_ALLOWED] = state.UNSUPPORTED_OPERATION;<tr><td><a id="l172"></a><a href="#l172">172</a><td>  map[code.MOVE_TARGET_OUT_OF_BOUNDS] = state.MOVE_TARGET_OUT_OF_BOUNDS;<tr><td><a id="l173"></a><a href="#l173">173</a><td>  map[code.NO_SUCH_ALERT] = state.NO_SUCH_ALERT;<tr><td><a id="l174"></a><a href="#l174">174</a><td>  map[code.NO_SUCH_ELEMENT] = state.NO_SUCH_ELEMENT;<tr><td><a id="l175"></a><a href="#l175">175</a><td>  map[code.NO_SUCH_FRAME] = state.NO_SUCH_FRAME;<tr><td><a id="l176"></a><a href="#l176">176</a><td>  map[code.NO_SUCH_WINDOW] = state.NO_SUCH_WINDOW;<tr><td><a id="l177"></a><a href="#l177">177</a><td>  map[code.SCRIPT_TIMEOUT] = state.SCRIPT_TIMEOUT;<tr><td><a id="l178"></a><a href="#l178">178</a><td>  map[code.SESSION_NOT_CREATED] = state.SESSION_NOT_CREATED;<tr><td><a id="l179"></a><a href="#l179">179</a><td>  map[code.STALE_ELEMENT_REFERENCE] = state.STALE_ELEMENT_REFERENCE;<tr><td><a id="l180"></a><a href="#l180">180</a><td>  map[code.TIMEOUT] = state.TIMEOUT;<tr><td><a id="l181"></a><a href="#l181">181</a><td>  map[code.UNABLE_TO_SET_COOKIE] = state.UNABLE_TO_SET_COOKIE;<tr><td><a id="l182"></a><a href="#l182">182</a><td>  map[code.UNEXPECTED_ALERT_OPEN] = state.UNEXPECTED_ALERT_OPEN<tr><td><a id="l183"></a><a href="#l183">183</a><td>  map[code.UNKNOWN_ERROR] = state.UNKNOWN_ERROR;<tr><td><a id="l184"></a><a href="#l184">184</a><td>  map[code.UNSUPPORTED_OPERATION] = state.UNKNOWN_COMMAND;<tr><td><a id="l185"></a><a href="#l185">185</a><td>});  // goog.scope<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> * Flag used for duck-typing when this code is embedded in a Firefox extension.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * This is required since an Error thrown in one component and then reported<tr><td><a id="l191"></a><a href="#l191">191</a><td> * to another will fail instanceof checks in the second component.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @type {boolean}<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>bot.Error.prototype.isAutomationError = true;<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>if (goog.DEBUG) {<tr><td><a id="l198"></a><a href="#l198">198</a><td>  /** @return {string} The string representation of this error. */<tr><td><a id="l199"></a><a href="#l199">199</a><td>  bot.Error.prototype.toString = function() {<tr><td><a id="l200"></a><a href="#l200">200</a><td>    return this.name + &#39;: &#39; + this.message;<tr><td><a id="l201"></a><a href="#l201">201</a><td>  };<tr><td><a id="l202"></a><a href="#l202">202</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>
\ No newline at end of file
diff --git a/docs/source/lib/atoms/json.js.src.html b/docs/source/lib/atoms/json.js.src.html
index a585c2f..7f38fbe 100644
--- a/docs/source/lib/atoms/json.js.src.html
+++ b/docs/source/lib/atoms/json.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>json.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/atoms/json.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 WebDriver committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2012 Google Inc.<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>// You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview Provides JSON utilities that uses native JSON parsing where<tr><td><a name="l18" href="#l18">18</a><td> * possible (a feature not currently offered by Closure).<tr><td><a name="l19" href="#l19">19</a><td> */<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;bot.json&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>goog.require(&#39;bot.userAgent&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>/**<tr><td><a name="l29" href="#l29">29</a><td> * @define {boolean} NATIVE_JSON indicates whether the code should rely on the<tr><td><a name="l30" href="#l30">30</a><td> * native {@code JSON} functions, if available.<tr><td><a name="l31" href="#l31">31</a><td> *<tr><td><a name="l32" href="#l32">32</a><td> * &lt;p&gt;The JSON functions can be defined by external libraries like Prototype<tr><td><a name="l33" href="#l33">33</a><td> * and setting this flag to false forces the use of Closure&#39;s goog.json<tr><td><a name="l34" href="#l34">34</a><td> * implementation.<tr><td><a name="l35" href="#l35">35</a><td> *<tr><td><a name="l36" href="#l36">36</a><td> * &lt;p&gt;If your JavaScript can be loaded by a third_party site and you are wary<tr><td><a name="l37" href="#l37">37</a><td> * about relying on the native functions, specify<tr><td><a name="l38" href="#l38">38</a><td> * &quot;--define bot.json.NATIVE_JSON=false&quot; to the Closure compiler.<tr><td><a name="l39" href="#l39">39</a><td> */<tr><td><a name="l40" href="#l40">40</a><td>bot.json.NATIVE_JSON = true;<tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>/**<tr><td><a name="l44" href="#l44">44</a><td> * Whether the current browser supports the native JSON interface.<tr><td><a name="l45" href="#l45">45</a><td> * @const<tr><td><a name="l46" href="#l46">46</a><td> * @see http://caniuse.com/#search=JSON<tr><td><a name="l47" href="#l47">47</a><td> * @private {boolean}<tr><td><a name="l48" href="#l48">48</a><td> */<tr><td><a name="l49" href="#l49">49</a><td>bot.json.SUPPORTS_NATIVE_JSON_ =<tr><td><a name="l50" href="#l50">50</a><td>    // List WebKit and Opera first since every supported version of these<tr><td><a name="l51" href="#l51">51</a><td>    // browsers supports native JSON (and we can compile away large chunks of<tr><td><a name="l52" href="#l52">52</a><td>    // code for individual fragments by setting the appropriate compiler flags).<tr><td><a name="l53" href="#l53">53</a><td>    goog.userAgent.WEBKIT || goog.userAgent.OPERA ||<tr><td><a name="l54" href="#l54">54</a><td>        (goog.userAgent.GECKO &amp;&amp; bot.userAgent.isEngineVersion(3.5)) ||<tr><td><a name="l55" href="#l55">55</a><td>        (goog.userAgent.IE &amp;&amp; bot.userAgent.isEngineVersion(8));<tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td>/**<tr><td><a name="l59" href="#l59">59</a><td> * Converts a JSON object to its string representation.<tr><td><a name="l60" href="#l60">60</a><td> * @param {*} jsonObj The input object.<tr><td><a name="l61" href="#l61">61</a><td> * @param {?(function(string, *): *)=} opt_replacer A replacer function called<tr><td><a name="l62" href="#l62">62</a><td> *     for each (key, value) pair that determines how the value should be<tr><td><a name="l63" href="#l63">63</a><td> *     serialized. By default, this just returns the value and allows default<tr><td><a name="l64" href="#l64">64</a><td> *     serialization to kick in.<tr><td><a name="l65" href="#l65">65</a><td> * @return {string} A JSON string representation of the input object.<tr><td><a name="l66" href="#l66">66</a><td> */<tr><td><a name="l67" href="#l67">67</a><td>bot.json.stringify = bot.json.NATIVE_JSON &amp;&amp; bot.json.SUPPORTS_NATIVE_JSON_ ?<tr><td><a name="l68" href="#l68">68</a><td>    JSON.stringify : goog.json.serialize;<tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td>/**<tr><td><a name="l72" href="#l72">72</a><td> * Parses a JSON string and returns the result.<tr><td><a name="l73" href="#l73">73</a><td> * @param {string} jsonStr The string to parse.<tr><td><a name="l74" href="#l74">74</a><td> * @return {*} The JSON object.<tr><td><a name="l75" href="#l75">75</a><td> * @throws {Error} If the input string is an invalid JSON string.<tr><td><a name="l76" href="#l76">76</a><td> */<tr><td><a name="l77" href="#l77">77</a><td>bot.json.parse = bot.json.NATIVE_JSON &amp;&amp; bot.json.SUPPORTS_NATIVE_JSON_ ?<tr><td><a name="l78" href="#l78">78</a><td>    JSON.parse : goog.json.parse;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>json.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/atoms/json.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Provides JSON utilities that uses native JSON parsing where<tr><td><a id="l20"></a><a href="#l20">20</a><td> * possible (a feature not currently offered by Closure).<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>goog.provide(&#39;bot.json&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;bot.userAgent&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.userAgent&#39;);<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> * @define {boolean} NATIVE_JSON indicates whether the code should rely on the<tr><td><a id="l32"></a><a href="#l32">32</a><td> * native {@code JSON} functions, if available.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * &lt;p&gt;The JSON functions can be defined by external libraries like Prototype<tr><td><a id="l35"></a><a href="#l35">35</a><td> * and setting this flag to false forces the use of Closure&#39;s goog.json<tr><td><a id="l36"></a><a href="#l36">36</a><td> * implementation.<tr><td><a id="l37"></a><a href="#l37">37</a><td> *<tr><td><a id="l38"></a><a href="#l38">38</a><td> * &lt;p&gt;If your JavaScript can be loaded by a third_party site and you are wary<tr><td><a id="l39"></a><a href="#l39">39</a><td> * about relying on the native functions, specify<tr><td><a id="l40"></a><a href="#l40">40</a><td> * &quot;--define bot.json.NATIVE_JSON=false&quot; to the Closure compiler.<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>bot.json.NATIVE_JSON = true;<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Whether the current browser supports the native JSON interface.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @const<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @see http://caniuse.com/#search=JSON<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @private {boolean}<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>bot.json.SUPPORTS_NATIVE_JSON_ =<tr><td><a id="l52"></a><a href="#l52">52</a><td>    // List WebKit first since every supported version supports<tr><td><a id="l53"></a><a href="#l53">53</a><td>    // native JSON (and we can compile away large chunks of code for<tr><td><a id="l54"></a><a href="#l54">54</a><td>    // individual fragments by setting the appropriate compiler flags).<tr><td><a id="l55"></a><a href="#l55">55</a><td>    goog.userAgent.WEBKIT ||<tr><td><a id="l56"></a><a href="#l56">56</a><td>        (goog.userAgent.GECKO &amp;&amp; bot.userAgent.isEngineVersion(3.5)) ||<tr><td><a id="l57"></a><a href="#l57">57</a><td>        (goog.userAgent.IE &amp;&amp; bot.userAgent.isEngineVersion(8));<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> * Converts a JSON object to its string representation.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {*} jsonObj The input object.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {?(function(string, *): *)=} opt_replacer A replacer function called<tr><td><a id="l64"></a><a href="#l64">64</a><td> *     for each (key, value) pair that determines how the value should be<tr><td><a id="l65"></a><a href="#l65">65</a><td> *     serialized. By default, this just returns the value and allows default<tr><td><a id="l66"></a><a href="#l66">66</a><td> *     serialization to kick in.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {string} A JSON string representation of the input object.<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>bot.json.stringify = bot.json.NATIVE_JSON &amp;&amp; bot.json.SUPPORTS_NATIVE_JSON_ ?<tr><td><a id="l70"></a><a href="#l70">70</a><td>    JSON.stringify : goog.json.serialize;<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> * Parses a JSON string and returns the result.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {string} jsonStr The string to parse.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {*} The JSON object.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @throws {Error} If the input string is an invalid JSON string.<tr><td><a id="l78"></a><a href="#l78">78</a><td> */<tr><td><a id="l79"></a><a href="#l79">79</a><td>bot.json.parse = bot.json.NATIVE_JSON &amp;&amp; bot.json.SUPPORTS_NATIVE_JSON_ ?<tr><td><a id="l80"></a><a href="#l80">80</a><td>    JSON.parse : goog.json.parse;</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>
\ No newline at end of file
diff --git a/docs/source/lib/atoms/response.js.src.html b/docs/source/lib/atoms/response.js.src.html
index 4a2bb7c..700e670 100644
--- a/docs/source/lib/atoms/response.js.src.html
+++ b/docs/source/lib/atoms/response.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>response.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/atoms/response.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Utilities for working with WebDriver response objects.<tr><td><a name="l17" href="#l17">17</a><td> * @see: http://code.google.com/p/selenium/wiki/JsonWireProtocol#Responses<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;bot.response&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;bot.response.ResponseObject&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>goog.require(&#39;bot.Error&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;bot.ErrorCode&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td>/**<tr><td><a name="l28" href="#l28">28</a><td> * Type definition for a response object, as defined by the JSON wire protocol.<tr><td><a name="l29" href="#l29">29</a><td> * @typedef {{status: bot.ErrorCode, value: (*|{message: string})}}<tr><td><a name="l30" href="#l30">30</a><td> * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Responses<tr><td><a name="l31" href="#l31">31</a><td> */<tr><td><a name="l32" href="#l32">32</a><td>bot.response.ResponseObject;<tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>/**<tr><td><a name="l36" href="#l36">36</a><td> * @param {*} value The value to test.<tr><td><a name="l37" href="#l37">37</a><td> * @return {boolean} Whether the given value is a response object.<tr><td><a name="l38" href="#l38">38</a><td> */<tr><td><a name="l39" href="#l39">39</a><td>bot.response.isResponseObject = function(value) {<tr><td><a name="l40" href="#l40">40</a><td>  return goog.isObject(value) &amp;&amp; goog.isNumber(value[&#39;status&#39;]);<tr><td><a name="l41" href="#l41">41</a><td>};<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td>/**<tr><td><a name="l45" href="#l45">45</a><td> * Creates a new success response object with the provided value.<tr><td><a name="l46" href="#l46">46</a><td> * @param {*} value The response value.<tr><td><a name="l47" href="#l47">47</a><td> * @return {!bot.response.ResponseObject} The new response object.<tr><td><a name="l48" href="#l48">48</a><td> */<tr><td><a name="l49" href="#l49">49</a><td>bot.response.createResponse = function(value) {<tr><td><a name="l50" href="#l50">50</a><td>  if (bot.response.isResponseObject(value)) {<tr><td><a name="l51" href="#l51">51</a><td>    return /** @type {!bot.response.ResponseObject} */ (value);<tr><td><a name="l52" href="#l52">52</a><td>  }<tr><td><a name="l53" href="#l53">53</a><td>  return {<tr><td><a name="l54" href="#l54">54</a><td>    &#39;status&#39;: bot.ErrorCode.SUCCESS,<tr><td><a name="l55" href="#l55">55</a><td>    &#39;value&#39;: value<tr><td><a name="l56" href="#l56">56</a><td>  };<tr><td><a name="l57" href="#l57">57</a><td>};<tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td>/**<tr><td><a name="l61" href="#l61">61</a><td> * Converts an error value into its JSON representation as defined by the<tr><td><a name="l62" href="#l62">62</a><td> * WebDriver wire protocol.<tr><td><a name="l63" href="#l63">63</a><td> * @param {(bot.Error|Error|*)} error The error value to convert.<tr><td><a name="l64" href="#l64">64</a><td> * @return {!bot.response.ResponseObject} The new response object.<tr><td><a name="l65" href="#l65">65</a><td> */<tr><td><a name="l66" href="#l66">66</a><td>bot.response.createErrorResponse = function(error) {<tr><td><a name="l67" href="#l67">67</a><td>  if (bot.response.isResponseObject(error)) {<tr><td><a name="l68" href="#l68">68</a><td>    return /** @type {!bot.response.ResponseObject} */ (error);<tr><td><a name="l69" href="#l69">69</a><td>  }<tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td>  var statusCode = error &amp;&amp; goog.isNumber(error.code) ? error.code :<tr><td><a name="l72" href="#l72">72</a><td>      bot.ErrorCode.UNKNOWN_ERROR;<tr><td><a name="l73" href="#l73">73</a><td>  return {<tr><td><a name="l74" href="#l74">74</a><td>    &#39;status&#39;: /** @type {bot.ErrorCode} */ (statusCode),<tr><td><a name="l75" href="#l75">75</a><td>    &#39;value&#39;: {<tr><td><a name="l76" href="#l76">76</a><td>      &#39;message&#39;: (error &amp;&amp; error.message || error) + &#39;&#39;<tr><td><a name="l77" href="#l77">77</a><td>    }<tr><td><a name="l78" href="#l78">78</a><td>  };<tr><td><a name="l79" href="#l79">79</a><td>};<tr><td><a name="l80" href="#l80">80</a><td><tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td>/**<tr><td><a name="l83" href="#l83">83</a><td> * Checks that a response object does not specify an error as defined by the<tr><td><a name="l84" href="#l84">84</a><td> * WebDriver wire protocol. If the response object defines an error, it will<tr><td><a name="l85" href="#l85">85</a><td> * be thrown. Otherwise, the response will be returned as is.<tr><td><a name="l86" href="#l86">86</a><td> * @param {!bot.response.ResponseObject} responseObj The response object to<tr><td><a name="l87" href="#l87">87</a><td> *     check.<tr><td><a name="l88" href="#l88">88</a><td> * @return {!bot.response.ResponseObject} The checked response object.<tr><td><a name="l89" href="#l89">89</a><td> * @throws {bot.Error} If the response describes an error.<tr><td><a name="l90" href="#l90">90</a><td> * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Failed_Commands<tr><td><a name="l91" href="#l91">91</a><td> */<tr><td><a name="l92" href="#l92">92</a><td>bot.response.checkResponse = function(responseObj) {<tr><td><a name="l93" href="#l93">93</a><td>  var status = responseObj[&#39;status&#39;];<tr><td><a name="l94" href="#l94">94</a><td>  if (status == bot.ErrorCode.SUCCESS) {<tr><td><a name="l95" href="#l95">95</a><td>    return responseObj;<tr><td><a name="l96" href="#l96">96</a><td>  }<tr><td><a name="l97" href="#l97">97</a><td><tr><td><a name="l98" href="#l98">98</a><td>  // If status is not defined, assume an unknown error.<tr><td><a name="l99" href="#l99">99</a><td>  status = status || bot.ErrorCode.UNKNOWN_ERROR;<tr><td><a name="l100" href="#l100">100</a><td><tr><td><a name="l101" href="#l101">101</a><td>  var value = responseObj[&#39;value&#39;];<tr><td><a name="l102" href="#l102">102</a><td>  if (!value || !goog.isObject(value)) {<tr><td><a name="l103" href="#l103">103</a><td>    throw new bot.Error(status, value + &#39;&#39;);<tr><td><a name="l104" href="#l104">104</a><td>  }<tr><td><a name="l105" href="#l105">105</a><td><tr><td><a name="l106" href="#l106">106</a><td>  throw new bot.Error(status, value[&#39;message&#39;] + &#39;&#39;);<tr><td><a name="l107" href="#l107">107</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>response.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/atoms/response.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Utilities for working with WebDriver response objects.<tr><td><a id="l20"></a><a href="#l20">20</a><td> * @see: hhttps://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#responses<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>goog.provide(&#39;bot.response&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;bot.response.ResponseObject&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;bot.Error&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;bot.ErrorCode&#39;);<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> * Type definition for a response object, as defined by the JSON wire protocol.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @typedef {{status: bot.ErrorCode, value: (*|{message: string})}}<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#responses<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td>bot.response.ResponseObject;<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> * @param {*} value The value to test.<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @return {boolean} Whether the given value is a response object.<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>bot.response.isResponseObject = function(value) {<tr><td><a id="l43"></a><a href="#l43">43</a><td>  return goog.isObject(value) &amp;&amp; goog.isNumber(value[&#39;status&#39;]);<tr><td><a id="l44"></a><a href="#l44">44</a><td>};<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td>/**<tr><td><a id="l48"></a><a href="#l48">48</a><td> * Creates a new success response object with the provided value.<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @param {*} value The response value.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @return {!bot.response.ResponseObject} The new response object.<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>bot.response.createResponse = function(value) {<tr><td><a id="l53"></a><a href="#l53">53</a><td>  if (bot.response.isResponseObject(value)) {<tr><td><a id="l54"></a><a href="#l54">54</a><td>    return /** @type {!bot.response.ResponseObject} */ (value);<tr><td><a id="l55"></a><a href="#l55">55</a><td>  }<tr><td><a id="l56"></a><a href="#l56">56</a><td>  return {<tr><td><a id="l57"></a><a href="#l57">57</a><td>    &#39;status&#39;: bot.ErrorCode.SUCCESS,<tr><td><a id="l58"></a><a href="#l58">58</a><td>    &#39;value&#39;: value<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><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> * Converts an error value into its JSON representation as defined by the<tr><td><a id="l65"></a><a href="#l65">65</a><td> * WebDriver wire protocol.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @param {(bot.Error|Error|*)} error The error value to convert.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {!bot.response.ResponseObject} The new response object.<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>bot.response.createErrorResponse = function(error) {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  if (bot.response.isResponseObject(error)) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>    return /** @type {!bot.response.ResponseObject} */ (error);<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>  var statusCode = error &amp;&amp; goog.isNumber(error.code) ? error.code :<tr><td><a id="l75"></a><a href="#l75">75</a><td>      bot.ErrorCode.UNKNOWN_ERROR;<tr><td><a id="l76"></a><a href="#l76">76</a><td>  return {<tr><td><a id="l77"></a><a href="#l77">77</a><td>    &#39;status&#39;: /** @type {bot.ErrorCode} */ (statusCode),<tr><td><a id="l78"></a><a href="#l78">78</a><td>    &#39;value&#39;: {<tr><td><a id="l79"></a><a href="#l79">79</a><td>      &#39;message&#39;: (error &amp;&amp; error.message || error) + &#39;&#39;<tr><td><a id="l80"></a><a href="#l80">80</a><td>    }<tr><td><a id="l81"></a><a href="#l81">81</a><td>  };<tr><td><a id="l82"></a><a href="#l82">82</a><td>};<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Checks that a response object does not specify an error as defined by the<tr><td><a id="l87"></a><a href="#l87">87</a><td> * WebDriver wire protocol. If the response object defines an error, it will<tr><td><a id="l88"></a><a href="#l88">88</a><td> * be thrown. Otherwise, the response will be returned as is.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @param {!bot.response.ResponseObject} responseObj The response object to<tr><td><a id="l90"></a><a href="#l90">90</a><td> *     check.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @return {!bot.response.ResponseObject} The checked response object.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @throws {bot.Error} If the response describes an error.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#failed-commands<tr><td><a id="l94"></a><a href="#l94">94</a><td> */<tr><td><a id="l95"></a><a href="#l95">95</a><td>bot.response.checkResponse = function(responseObj) {<tr><td><a id="l96"></a><a href="#l96">96</a><td>  var status = responseObj[&#39;status&#39;];<tr><td><a id="l97"></a><a href="#l97">97</a><td>  if (status == bot.ErrorCode.SUCCESS) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>    return responseObj;<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>  // If status is not defined, assume an unknown error.<tr><td><a id="l102"></a><a href="#l102">102</a><td>  status = status || bot.ErrorCode.UNKNOWN_ERROR;<tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>  var value = responseObj[&#39;value&#39;];<tr><td><a id="l105"></a><a href="#l105">105</a><td>  if (!value || !goog.isObject(value)) {<tr><td><a id="l106"></a><a href="#l106">106</a><td>    throw new bot.Error(status, value + &#39;&#39;);<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>  throw new bot.Error(status, value[&#39;message&#39;] + &#39;&#39;);<tr><td><a id="l110"></a><a href="#l110">110</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>
\ No newline at end of file
diff --git a/docs/source/lib/atoms/userAgent.js.src.html b/docs/source/lib/atoms/userAgent.js.src.html
index 9eed02c..ae1f199 100644
--- a/docs/source/lib/atoms/userAgent.js.src.html
+++ b/docs/source/lib/atoms/userAgent.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>userAgent.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/atoms/userAgent.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 WebDriver committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2011 Google Inc.<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>// You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview Similar to goog.userAgent.isVersion, but with support for<tr><td><a name="l18" href="#l18">18</a><td> * getting the version information when running in a firefox extension.<tr><td><a name="l19" href="#l19">19</a><td> */<tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;bot.userAgent&#39;);<tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;goog.userAgent.product&#39;);<tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.userAgent.product.isVersion&#39;);<tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>/**<tr><td><a name="l29" href="#l29">29</a><td> * Whether the rendering engine version of the current browser is equal to or<tr><td><a name="l30" href="#l30">30</a><td> * greater than the given version. This implementation differs from<tr><td><a name="l31" href="#l31">31</a><td> * goog.userAgent.isVersion in the following ways:<tr><td><a name="l32" href="#l32">32</a><td> * &lt;ol&gt;<tr><td><a name="l33" href="#l33">33</a><td> * &lt;li&gt;in a Firefox extension, tests the engine version through the XUL version<tr><td><a name="l34" href="#l34">34</a><td> *     comparator service, because no window.navigator object is available<tr><td><a name="l35" href="#l35">35</a><td> * &lt;li&gt;in IE, compares the given version to the current documentMode<tr><td><a name="l36" href="#l36">36</a><td> * &lt;/ol&gt;<tr><td><a name="l37" href="#l37">37</a><td> *<tr><td><a name="l38" href="#l38">38</a><td> * @param {string|number} version The version number to check.<tr><td><a name="l39" href="#l39">39</a><td> * @return {boolean} Whether the browser engine version is the same or higher<tr><td><a name="l40" href="#l40">40</a><td> *     than the given version.<tr><td><a name="l41" href="#l41">41</a><td> */<tr><td><a name="l42" href="#l42">42</a><td>bot.userAgent.isEngineVersion = function(version) {<tr><td><a name="l43" href="#l43">43</a><td>  if (bot.userAgent.FIREFOX_EXTENSION) {<tr><td><a name="l44" href="#l44">44</a><td>    return bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_(version);<tr><td><a name="l45" href="#l45">45</a><td>  } else if (goog.userAgent.IE) {<tr><td><a name="l46" href="#l46">46</a><td>    return goog.string.compareVersions(<tr><td><a name="l47" href="#l47">47</a><td>        /** @type {number} */ (goog.userAgent.DOCUMENT_MODE), version) &gt;= 0;<tr><td><a name="l48" href="#l48">48</a><td>  } else {<tr><td><a name="l49" href="#l49">49</a><td>    return goog.userAgent.isVersionOrHigher(version);<tr><td><a name="l50" href="#l50">50</a><td>  }<tr><td><a name="l51" href="#l51">51</a><td>};<tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td><tr><td><a name="l54" href="#l54">54</a><td>/**<tr><td><a name="l55" href="#l55">55</a><td> * Whether the product version of the current browser is equal to or greater<tr><td><a name="l56" href="#l56">56</a><td> * than the given version. This implementation differs from<tr><td><a name="l57" href="#l57">57</a><td> * goog.userAgent.product.isVersion in the following ways:<tr><td><a name="l58" href="#l58">58</a><td> * &lt;ol&gt;<tr><td><a name="l59" href="#l59">59</a><td> * &lt;li&gt;in a Firefox extension, tests the product version through the XUL version<tr><td><a name="l60" href="#l60">60</a><td> *     comparator service, because no window.navigator object is available<tr><td><a name="l61" href="#l61">61</a><td> * &lt;li&gt;on Android, always compares to the version to the OS version<tr><td><a name="l62" href="#l62">62</a><td> * &lt;/ol&gt;<tr><td><a name="l63" href="#l63">63</a><td> *<tr><td><a name="l64" href="#l64">64</a><td> * @param {string|number} version The version number to check.<tr><td><a name="l65" href="#l65">65</a><td> * @return {boolean} Whether the browser product version is the same or higher<tr><td><a name="l66" href="#l66">66</a><td> *     than the given version.<tr><td><a name="l67" href="#l67">67</a><td> */<tr><td><a name="l68" href="#l68">68</a><td>bot.userAgent.isProductVersion = function(version) {<tr><td><a name="l69" href="#l69">69</a><td>  if (bot.userAgent.FIREFOX_EXTENSION) {<tr><td><a name="l70" href="#l70">70</a><td>    return bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_(version);<tr><td><a name="l71" href="#l71">71</a><td>  } else if (goog.userAgent.product.ANDROID) {<tr><td><a name="l72" href="#l72">72</a><td>    return goog.string.compareVersions(<tr><td><a name="l73" href="#l73">73</a><td>        bot.userAgent.ANDROID_VERSION_, version) &gt;= 0;<tr><td><a name="l74" href="#l74">74</a><td>  } else {<tr><td><a name="l75" href="#l75">75</a><td>    return goog.userAgent.product.isVersion(version);<tr><td><a name="l76" href="#l76">76</a><td>  }<tr><td><a name="l77" href="#l77">77</a><td>};<tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td><tr><td><a name="l80" href="#l80">80</a><td>/**<tr><td><a name="l81" href="#l81">81</a><td> * When we are in a Firefox extension, this is a function that accepts a version<tr><td><a name="l82" href="#l82">82</a><td> * and returns whether the version of Gecko we are on is the same or higher<tr><td><a name="l83" href="#l83">83</a><td> * than the given version. When we are not in a Firefox extension, this is null.<tr><td><a name="l84" href="#l84">84</a><td> * @private {(undefined|function((string|number)): boolean)}<tr><td><a name="l85" href="#l85">85</a><td> */<tr><td><a name="l86" href="#l86">86</a><td>bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_;<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>/**<tr><td><a name="l90" href="#l90">90</a><td> * When we are in a Firefox extension, this is a function that accepts a version<tr><td><a name="l91" href="#l91">91</a><td> * and returns whether the version of Firefox we are on is the same or higher<tr><td><a name="l92" href="#l92">92</a><td> * than the given version. When we are not in a Firefox extension, this is null.<tr><td><a name="l93" href="#l93">93</a><td> * @private {(undefined|function((string|number)): boolean)}<tr><td><a name="l94" href="#l94">94</a><td> */<tr><td><a name="l95" href="#l95">95</a><td>bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_;<tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td><tr><td><a name="l98" href="#l98">98</a><td>/**<tr><td><a name="l99" href="#l99">99</a><td> * Whether we are in a Firefox extension.<tr><td><a name="l100" href="#l100">100</a><td> *<tr><td><a name="l101" href="#l101">101</a><td> * @const<tr><td><a name="l102" href="#l102">102</a><td> * @type {boolean}<tr><td><a name="l103" href="#l103">103</a><td> */<tr><td><a name="l104" href="#l104">104</a><td>bot.userAgent.FIREFOX_EXTENSION = (function() {<tr><td><a name="l105" href="#l105">105</a><td>  // False if this browser is not a Gecko browser.<tr><td><a name="l106" href="#l106">106</a><td>  if (!goog.userAgent.GECKO) {<tr><td><a name="l107" href="#l107">107</a><td>    return false;<tr><td><a name="l108" href="#l108">108</a><td>  }<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>  // False if this code isn&#39;t running in an extension.<tr><td><a name="l111" href="#l111">111</a><td>  var Components = goog.global.Components;<tr><td><a name="l112" href="#l112">112</a><td>  if (!Components) {<tr><td><a name="l113" href="#l113">113</a><td>    return false;<tr><td><a name="l114" href="#l114">114</a><td>  }<tr><td><a name="l115" href="#l115">115</a><td>  try {<tr><td><a name="l116" href="#l116">116</a><td>    if (!Components[&#39;classes&#39;]) {<tr><td><a name="l117" href="#l117">117</a><td>      return false;<tr><td><a name="l118" href="#l118">118</a><td>    }<tr><td><a name="l119" href="#l119">119</a><td>  } catch (e) {<tr><td><a name="l120" href="#l120">120</a><td>    return false;<tr><td><a name="l121" href="#l121">121</a><td>  }<tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td>  // Populate the version checker functions.<tr><td><a name="l124" href="#l124">124</a><td>  var cc = Components[&#39;classes&#39;];<tr><td><a name="l125" href="#l125">125</a><td>  var ci = Components[&#39;interfaces&#39;];<tr><td><a name="l126" href="#l126">126</a><td>  var versionComparator = cc[&#39;@mozilla.org/xpcom/version-comparator;1&#39;][<tr><td><a name="l127" href="#l127">127</a><td>      &#39;getService&#39;](ci[&#39;nsIVersionComparator&#39;]);<tr><td><a name="l128" href="#l128">128</a><td>  var appInfo = cc[&#39;@mozilla.org/xre/app-info;1&#39;][&#39;getService&#39;](<tr><td><a name="l129" href="#l129">129</a><td>      ci[&#39;nsIXULAppInfo&#39;]);<tr><td><a name="l130" href="#l130">130</a><td>  var geckoVersion = appInfo[&#39;platformVersion&#39;];<tr><td><a name="l131" href="#l131">131</a><td>  var firefoxVersion = appInfo[&#39;version&#39;];<tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td>  bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_ = function(version) {<tr><td><a name="l134" href="#l134">134</a><td>    return versionComparator.compare(geckoVersion, &#39;&#39; + version) &gt;= 0;<tr><td><a name="l135" href="#l135">135</a><td>  };<tr><td><a name="l136" href="#l136">136</a><td>  bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_ = function(version) {<tr><td><a name="l137" href="#l137">137</a><td>    return versionComparator.compare(firefoxVersion, &#39;&#39; + version) &gt;= 0;<tr><td><a name="l138" href="#l138">138</a><td>  };<tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td>  return true;<tr><td><a name="l141" href="#l141">141</a><td>})();<tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td>/**<tr><td><a name="l145" href="#l145">145</a><td> * Whether we are on IOS.<tr><td><a name="l146" href="#l146">146</a><td> *<tr><td><a name="l147" href="#l147">147</a><td> * @const<tr><td><a name="l148" href="#l148">148</a><td> * @type {boolean}<tr><td><a name="l149" href="#l149">149</a><td> */<tr><td><a name="l150" href="#l150">150</a><td>bot.userAgent.IOS = goog.userAgent.product.IPAD ||<tr><td><a name="l151" href="#l151">151</a><td>                    goog.userAgent.product.IPHONE;<tr><td><a name="l152" href="#l152">152</a><td><tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td>/**<tr><td><a name="l155" href="#l155">155</a><td> * Whether we are on a mobile browser.<tr><td><a name="l156" href="#l156">156</a><td> *<tr><td><a name="l157" href="#l157">157</a><td> * @const<tr><td><a name="l158" href="#l158">158</a><td> * @type {boolean}<tr><td><a name="l159" href="#l159">159</a><td> */<tr><td><a name="l160" href="#l160">160</a><td>bot.userAgent.MOBILE = bot.userAgent.IOS || goog.userAgent.product.ANDROID;<tr><td><a name="l161" href="#l161">161</a><td><tr><td><a name="l162" href="#l162">162</a><td><tr><td><a name="l163" href="#l163">163</a><td>/**<tr><td><a name="l164" href="#l164">164</a><td> * Android Operating System Version.<tr><td><a name="l165" href="#l165">165</a><td> * @private {string}<tr><td><a name="l166" href="#l166">166</a><td> * @const<tr><td><a name="l167" href="#l167">167</a><td> */<tr><td><a name="l168" href="#l168">168</a><td>bot.userAgent.ANDROID_VERSION_ = (function() {<tr><td><a name="l169" href="#l169">169</a><td>  if (goog.userAgent.product.ANDROID) {<tr><td><a name="l170" href="#l170">170</a><td>    var userAgentString = goog.userAgent.getUserAgentString();<tr><td><a name="l171" href="#l171">171</a><td>    var match = /Android\s+([0-9\.]+)/.exec(userAgentString);<tr><td><a name="l172" href="#l172">172</a><td>    return match ? match[1] : &#39;0&#39;;<tr><td><a name="l173" href="#l173">173</a><td>  } else {<tr><td><a name="l174" href="#l174">174</a><td>    return &#39;0&#39;;<tr><td><a name="l175" href="#l175">175</a><td>  }<tr><td><a name="l176" href="#l176">176</a><td>})();<tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>/**<tr><td><a name="l180" href="#l180">180</a><td> * Whether the current document is IE in a documentMode older than 8.<tr><td><a name="l181" href="#l181">181</a><td> * @type {boolean}<tr><td><a name="l182" href="#l182">182</a><td> * @const<tr><td><a name="l183" href="#l183">183</a><td> */<tr><td><a name="l184" href="#l184">184</a><td>bot.userAgent.IE_DOC_PRE8 = goog.userAgent.IE &amp;&amp;<tr><td><a name="l185" href="#l185">185</a><td>    !goog.userAgent.isDocumentModeOrHigher(8);<tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td><tr><td><a name="l188" href="#l188">188</a><td>/**<tr><td><a name="l189" href="#l189">189</a><td> * Whether the current document is IE in IE9 (or newer) standards mode.<tr><td><a name="l190" href="#l190">190</a><td> * @type {boolean}<tr><td><a name="l191" href="#l191">191</a><td> * @const<tr><td><a name="l192" href="#l192">192</a><td> */<tr><td><a name="l193" href="#l193">193</a><td>bot.userAgent.IE_DOC_9 = goog.userAgent.isDocumentModeOrHigher(9);<tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td><tr><td><a name="l196" href="#l196">196</a><td>/**<tr><td><a name="l197" href="#l197">197</a><td> * Whether the current document is IE in a documentMode older than 9.<tr><td><a name="l198" href="#l198">198</a><td> * @type {boolean}<tr><td><a name="l199" href="#l199">199</a><td> * @const<tr><td><a name="l200" href="#l200">200</a><td> */<tr><td><a name="l201" href="#l201">201</a><td>bot.userAgent.IE_DOC_PRE9 = goog.userAgent.IE &amp;&amp;<tr><td><a name="l202" href="#l202">202</a><td>    !goog.userAgent.isDocumentModeOrHigher(9);<tr><td><a name="l203" href="#l203">203</a><td><tr><td><a name="l204" href="#l204">204</a><td><tr><td><a name="l205" href="#l205">205</a><td>/**<tr><td><a name="l206" href="#l206">206</a><td> * Whether the current document is IE in IE10 (or newer) standards mode.<tr><td><a name="l207" href="#l207">207</a><td> * @type {boolean}<tr><td><a name="l208" href="#l208">208</a><td> * @const<tr><td><a name="l209" href="#l209">209</a><td> */<tr><td><a name="l210" href="#l210">210</a><td>bot.userAgent.IE_DOC_10 = goog.userAgent.isDocumentModeOrHigher(10);<tr><td><a name="l211" href="#l211">211</a><td><tr><td><a name="l212" href="#l212">212</a><td><tr><td><a name="l213" href="#l213">213</a><td>/**<tr><td><a name="l214" href="#l214">214</a><td> * Whether the current document is IE in a documentMode older than 10.<tr><td><a name="l215" href="#l215">215</a><td> * @type {boolean}<tr><td><a name="l216" href="#l216">216</a><td> * @const<tr><td><a name="l217" href="#l217">217</a><td> */<tr><td><a name="l218" href="#l218">218</a><td>bot.userAgent.IE_DOC_PRE10 = goog.userAgent.IE &amp;&amp;<tr><td><a name="l219" href="#l219">219</a><td>    !goog.userAgent.isDocumentModeOrHigher(10);<tr><td><a name="l220" href="#l220">220</a><td><tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td>/**<tr><td><a name="l223" href="#l223">223</a><td> * Whether the current browser is Android pre-gingerbread.<tr><td><a name="l224" href="#l224">224</a><td> * @type {boolean}<tr><td><a name="l225" href="#l225">225</a><td> * @const<tr><td><a name="l226" href="#l226">226</a><td> */<tr><td><a name="l227" href="#l227">227</a><td>bot.userAgent.ANDROID_PRE_GINGERBREAD = goog.userAgent.product.ANDROID &amp;&amp;<tr><td><a name="l228" href="#l228">228</a><td>    !bot.userAgent.isProductVersion(2.3);<tr><td><a name="l229" href="#l229">229</a><td><tr><td><a name="l230" href="#l230">230</a><td><tr><td><a name="l231" href="#l231">231</a><td>/**<tr><td><a name="l232" href="#l232">232</a><td> * Whether the current browser is Android pre-icecreamsandwich<tr><td><a name="l233" href="#l233">233</a><td> * @type {boolean}<tr><td><a name="l234" href="#l234">234</a><td> * @const<tr><td><a name="l235" href="#l235">235</a><td> */<tr><td><a name="l236" href="#l236">236</a><td>bot.userAgent.ANDROID_PRE_ICECREAMSANDWICH = goog.userAgent.product.ANDROID &amp;&amp;<tr><td><a name="l237" href="#l237">237</a><td>    !bot.userAgent.isProductVersion(4);<tr><td><a name="l238" href="#l238">238</a><td><tr><td><a name="l239" href="#l239">239</a><td><tr><td><a name="l240" href="#l240">240</a><td>/**<tr><td><a name="l241" href="#l241">241</a><td> * Whether the current browser is Safari 6.<tr><td><a name="l242" href="#l242">242</a><td> * @type {boolean}<tr><td><a name="l243" href="#l243">243</a><td> * @const<tr><td><a name="l244" href="#l244">244</a><td> */<tr><td><a name="l245" href="#l245">245</a><td>bot.userAgent.SAFARI_6 = goog.userAgent.product.SAFARI &amp;&amp;<tr><td><a name="l246" href="#l246">246</a><td>    bot.userAgent.isProductVersion(6);<tr><td><a name="l247" href="#l247">247</a><td><tr><td><a name="l248" href="#l248">248</a><td><tr><td><a name="l249" href="#l249">249</a><td>/**<tr><td><a name="l250" href="#l250">250</a><td> * Whether the current browser is Windows Phone.<tr><td><a name="l251" href="#l251">251</a><td> * @type {boolean}<tr><td><a name="l252" href="#l252">252</a><td> * @const<tr><td><a name="l253" href="#l253">253</a><td> */<tr><td><a name="l254" href="#l254">254</a><td>bot.userAgent.WINDOWS_PHONE = goog.userAgent.IE &amp;&amp;<tr><td><a name="l255" href="#l255">255</a><td>    goog.userAgent.getUserAgentString().indexOf(&#39;IEMobile&#39;) != -1;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>userAgent.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/atoms/userAgent.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Similar to goog.userAgent.isVersion, but with support for<tr><td><a id="l20"></a><a href="#l20">20</a><td> * getting the version information when running in a firefox extension.<tr><td><a id="l21"></a><a href="#l21">21</a><td> */<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;bot.userAgent&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.userAgent.product&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.userAgent.product.isVersion&#39;);<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> * Whether the rendering engine version of the current browser is equal to or<tr><td><a id="l32"></a><a href="#l32">32</a><td> * greater than the given version. This implementation differs from<tr><td><a id="l33"></a><a href="#l33">33</a><td> * goog.userAgent.isVersion in the following ways:<tr><td><a id="l34"></a><a href="#l34">34</a><td> * &lt;ol&gt;<tr><td><a id="l35"></a><a href="#l35">35</a><td> * &lt;li&gt;in a Firefox extension, tests the engine version through the XUL version<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     comparator service, because no window.navigator object is available<tr><td><a id="l37"></a><a href="#l37">37</a><td> * &lt;li&gt;in IE, compares the given version to the current documentMode<tr><td><a id="l38"></a><a href="#l38">38</a><td> * &lt;/ol&gt;<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @param {string|number} version The version number to check.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @return {boolean} Whether the browser engine version is the same or higher<tr><td><a id="l42"></a><a href="#l42">42</a><td> *     than the given version.<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>bot.userAgent.isEngineVersion = function(version) {<tr><td><a id="l45"></a><a href="#l45">45</a><td>  if (bot.userAgent.FIREFOX_EXTENSION) {<tr><td><a id="l46"></a><a href="#l46">46</a><td>    return bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_(version);<tr><td><a id="l47"></a><a href="#l47">47</a><td>  } else if (goog.userAgent.IE) {<tr><td><a id="l48"></a><a href="#l48">48</a><td>    return goog.string.compareVersions(<tr><td><a id="l49"></a><a href="#l49">49</a><td>        /** @type {number} */ (goog.userAgent.DOCUMENT_MODE), version) &gt;= 0;<tr><td><a id="l50"></a><a href="#l50">50</a><td>  } else {<tr><td><a id="l51"></a><a href="#l51">51</a><td>    return goog.userAgent.isVersionOrHigher(version);<tr><td><a id="l52"></a><a href="#l52">52</a><td>  }<tr><td><a id="l53"></a><a href="#l53">53</a><td>};<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * Whether the product version of the current browser is equal to or greater<tr><td><a id="l58"></a><a href="#l58">58</a><td> * than the given version. This implementation differs from<tr><td><a id="l59"></a><a href="#l59">59</a><td> * goog.userAgent.product.isVersion in the following ways:<tr><td><a id="l60"></a><a href="#l60">60</a><td> * &lt;ol&gt;<tr><td><a id="l61"></a><a href="#l61">61</a><td> * &lt;li&gt;in a Firefox extension, tests the product version through the XUL version<tr><td><a id="l62"></a><a href="#l62">62</a><td> *     comparator service, because no window.navigator object is available<tr><td><a id="l63"></a><a href="#l63">63</a><td> * &lt;li&gt;on Android, always compares to the version to the OS version<tr><td><a id="l64"></a><a href="#l64">64</a><td> * &lt;/ol&gt;<tr><td><a id="l65"></a><a href="#l65">65</a><td> *<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @param {string|number} version The version number to check.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {boolean} Whether the browser product version is the same or higher<tr><td><a id="l68"></a><a href="#l68">68</a><td> *     than the given version.<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>bot.userAgent.isProductVersion = function(version) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>  if (bot.userAgent.FIREFOX_EXTENSION) {<tr><td><a id="l72"></a><a href="#l72">72</a><td>    return bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_(version);<tr><td><a id="l73"></a><a href="#l73">73</a><td>  } else if (goog.userAgent.product.ANDROID) {<tr><td><a id="l74"></a><a href="#l74">74</a><td>    return goog.string.compareVersions(<tr><td><a id="l75"></a><a href="#l75">75</a><td>        bot.userAgent.ANDROID_VERSION_, version) &gt;= 0;<tr><td><a id="l76"></a><a href="#l76">76</a><td>  } else {<tr><td><a id="l77"></a><a href="#l77">77</a><td>    return goog.userAgent.product.isVersion(version);<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><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * When we are in a Firefox extension, this is a function that accepts a version<tr><td><a id="l84"></a><a href="#l84">84</a><td> * and returns whether the version of Gecko we are on is the same or higher<tr><td><a id="l85"></a><a href="#l85">85</a><td> * than the given version. When we are not in a Firefox extension, this is null.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @private {(undefined|function((string|number)): boolean)}<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_;<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> * When we are in a Firefox extension, this is a function that accepts a version<tr><td><a id="l93"></a><a href="#l93">93</a><td> * and returns whether the version of Firefox we are on is the same or higher<tr><td><a id="l94"></a><a href="#l94">94</a><td> * than the given version. When we are not in a Firefox extension, this is null.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @private {(undefined|function((string|number)): boolean)}<tr><td><a id="l96"></a><a href="#l96">96</a><td> */<tr><td><a id="l97"></a><a href="#l97">97</a><td>bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_;<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * Whether we are in a Firefox extension.<tr><td><a id="l102"></a><a href="#l102">102</a><td> *<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @const<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @type {boolean}<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>bot.userAgent.FIREFOX_EXTENSION = (function() {<tr><td><a id="l107"></a><a href="#l107">107</a><td>  // False if this browser is not a Gecko browser.<tr><td><a id="l108"></a><a href="#l108">108</a><td>  if (!goog.userAgent.GECKO) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>    return false;<tr><td><a id="l110"></a><a href="#l110">110</a><td>  }<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>  // False if this code isn&#39;t running in an extension.<tr><td><a id="l113"></a><a href="#l113">113</a><td>  var Components = goog.global.Components;<tr><td><a id="l114"></a><a href="#l114">114</a><td>  if (!Components) {<tr><td><a id="l115"></a><a href="#l115">115</a><td>    return false;<tr><td><a id="l116"></a><a href="#l116">116</a><td>  }<tr><td><a id="l117"></a><a href="#l117">117</a><td>  try {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    if (!Components[&#39;classes&#39;]) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>      return false;<tr><td><a id="l120"></a><a href="#l120">120</a><td>    }<tr><td><a id="l121"></a><a href="#l121">121</a><td>  } catch (e) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>    return false;<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>  // Populate the version checker functions.<tr><td><a id="l126"></a><a href="#l126">126</a><td>  var cc = Components[&#39;classes&#39;];<tr><td><a id="l127"></a><a href="#l127">127</a><td>  var ci = Components[&#39;interfaces&#39;];<tr><td><a id="l128"></a><a href="#l128">128</a><td>  var versionComparator = cc[&#39;@mozilla.org/xpcom/version-comparator;1&#39;][<tr><td><a id="l129"></a><a href="#l129">129</a><td>      &#39;getService&#39;](ci[&#39;nsIVersionComparator&#39;]);<tr><td><a id="l130"></a><a href="#l130">130</a><td>  var appInfo = cc[&#39;@mozilla.org/xre/app-info;1&#39;][&#39;getService&#39;](<tr><td><a id="l131"></a><a href="#l131">131</a><td>      ci[&#39;nsIXULAppInfo&#39;]);<tr><td><a id="l132"></a><a href="#l132">132</a><td>  var geckoVersion = appInfo[&#39;platformVersion&#39;];<tr><td><a id="l133"></a><a href="#l133">133</a><td>  var firefoxVersion = appInfo[&#39;version&#39;];<tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>  bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_ = function(version) {<tr><td><a id="l136"></a><a href="#l136">136</a><td>    return versionComparator.compare(geckoVersion, &#39;&#39; + version) &gt;= 0;<tr><td><a id="l137"></a><a href="#l137">137</a><td>  };<tr><td><a id="l138"></a><a href="#l138">138</a><td>  bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_ = function(version) {<tr><td><a id="l139"></a><a href="#l139">139</a><td>    return versionComparator.compare(firefoxVersion, &#39;&#39; + version) &gt;= 0;<tr><td><a id="l140"></a><a href="#l140">140</a><td>  };<tr><td><a id="l141"></a><a href="#l141">141</a><td><tr><td><a id="l142"></a><a href="#l142">142</a><td>  return true;<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> * Whether we are on IOS.<tr><td><a id="l148"></a><a href="#l148">148</a><td> *<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @const<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @type {boolean}<tr><td><a id="l151"></a><a href="#l151">151</a><td> */<tr><td><a id="l152"></a><a href="#l152">152</a><td>bot.userAgent.IOS = goog.userAgent.product.IPAD ||<tr><td><a id="l153"></a><a href="#l153">153</a><td>                    goog.userAgent.product.IPHONE;<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> * Whether we are on a mobile browser.<tr><td><a id="l158"></a><a href="#l158">158</a><td> *<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @const<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @type {boolean}<tr><td><a id="l161"></a><a href="#l161">161</a><td> */<tr><td><a id="l162"></a><a href="#l162">162</a><td>bot.userAgent.MOBILE = bot.userAgent.IOS || goog.userAgent.product.ANDROID;<tr><td><a id="l163"></a><a href="#l163">163</a><td><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> * Android Operating System Version.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @private {string}<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @const<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>bot.userAgent.ANDROID_VERSION_ = (function() {<tr><td><a id="l171"></a><a href="#l171">171</a><td>  if (goog.userAgent.product.ANDROID) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>    var userAgentString = goog.userAgent.getUserAgentString();<tr><td><a id="l173"></a><a href="#l173">173</a><td>    var match = /Android\s+([0-9\.]+)/.exec(userAgentString);<tr><td><a id="l174"></a><a href="#l174">174</a><td>    return match ? match[1] : &#39;0&#39;;<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 &#39;0&#39;;<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>/**<tr><td><a id="l182"></a><a href="#l182">182</a><td> * Whether the current document is IE in a documentMode older than 8.<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @type {boolean}<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @const<tr><td><a id="l185"></a><a href="#l185">185</a><td> */<tr><td><a id="l186"></a><a href="#l186">186</a><td>bot.userAgent.IE_DOC_PRE8 = goog.userAgent.IE &amp;&amp;<tr><td><a id="l187"></a><a href="#l187">187</a><td>    !goog.userAgent.isDocumentModeOrHigher(8);<tr><td><a id="l188"></a><a href="#l188">188</a><td><tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td>/**<tr><td><a id="l191"></a><a href="#l191">191</a><td> * Whether the current document is IE in IE9 (or newer) standards mode.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @type {boolean}<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @const<tr><td><a id="l194"></a><a href="#l194">194</a><td> */<tr><td><a id="l195"></a><a href="#l195">195</a><td>bot.userAgent.IE_DOC_9 = goog.userAgent.isDocumentModeOrHigher(9);<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>/**<tr><td><a id="l199"></a><a href="#l199">199</a><td> * Whether the current document is IE in a documentMode older than 9.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @type {boolean}<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @const<tr><td><a id="l202"></a><a href="#l202">202</a><td> */<tr><td><a id="l203"></a><a href="#l203">203</a><td>bot.userAgent.IE_DOC_PRE9 = goog.userAgent.IE &amp;&amp;<tr><td><a id="l204"></a><a href="#l204">204</a><td>    !goog.userAgent.isDocumentModeOrHigher(9);<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td>/**<tr><td><a id="l208"></a><a href="#l208">208</a><td> * Whether the current document is IE in IE10 (or newer) standards mode.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @type {boolean}<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @const<tr><td><a id="l211"></a><a href="#l211">211</a><td> */<tr><td><a id="l212"></a><a href="#l212">212</a><td>bot.userAgent.IE_DOC_10 = goog.userAgent.isDocumentModeOrHigher(10);<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * Whether the current document is IE in a documentMode older than 10.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @type {boolean}<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @const<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>bot.userAgent.IE_DOC_PRE10 = goog.userAgent.IE &amp;&amp;<tr><td><a id="l221"></a><a href="#l221">221</a><td>    !goog.userAgent.isDocumentModeOrHigher(10);<tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td>/**<tr><td><a id="l225"></a><a href="#l225">225</a><td> * Whether the current browser is Android pre-gingerbread.<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @type {boolean}<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @const<tr><td><a id="l228"></a><a href="#l228">228</a><td> */<tr><td><a id="l229"></a><a href="#l229">229</a><td>bot.userAgent.ANDROID_PRE_GINGERBREAD = goog.userAgent.product.ANDROID &amp;&amp;<tr><td><a id="l230"></a><a href="#l230">230</a><td>    !bot.userAgent.isProductVersion(2.3);<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Whether the current browser is Android pre-icecreamsandwich<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @type {boolean}<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @const<tr><td><a id="l237"></a><a href="#l237">237</a><td> */<tr><td><a id="l238"></a><a href="#l238">238</a><td>bot.userAgent.ANDROID_PRE_ICECREAMSANDWICH = goog.userAgent.product.ANDROID &amp;&amp;<tr><td><a id="l239"></a><a href="#l239">239</a><td>    !bot.userAgent.isProductVersion(4);<tr><td><a id="l240"></a><a href="#l240">240</a><td><tr><td><a id="l241"></a><a href="#l241">241</a><td><tr><td><a id="l242"></a><a href="#l242">242</a><td>/**<tr><td><a id="l243"></a><a href="#l243">243</a><td> * Whether the current browser is Safari 6.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @type {boolean}<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @const<tr><td><a id="l246"></a><a href="#l246">246</a><td> */<tr><td><a id="l247"></a><a href="#l247">247</a><td>bot.userAgent.SAFARI_6 = goog.userAgent.product.SAFARI &amp;&amp;<tr><td><a id="l248"></a><a href="#l248">248</a><td>    bot.userAgent.isProductVersion(6);<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td>/**<tr><td><a id="l252"></a><a href="#l252">252</a><td> * Whether the current browser is Windows Phone.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @type {boolean}<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @const<tr><td><a id="l255"></a><a href="#l255">255</a><td> */<tr><td><a id="l256"></a><a href="#l256">256</a><td>bot.userAgent.WINDOWS_PHONE = goog.userAgent.IE &amp;&amp;<tr><td><a id="l257"></a><a href="#l257">257</a><td>    goog.userAgent.getUserAgentString().indexOf(&#39;IEMobile&#39;) != -1;</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/array/array.js.src.html b/docs/source/lib/goog/array/array.js.src.html
index aab8e53..a03714d 100644
--- a/docs/source/lib/goog/array/array.js.src.html
+++ b/docs/source/lib/goog/array/array.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>array.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/array/array.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Utilities for manipulating arrays.<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.array&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.array.ArrayLike&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td>/**<tr><td><a name="l28" href="#l28">28</a><td> * @define {boolean} NATIVE_ARRAY_PROTOTYPES indicates whether the code should<tr><td><a name="l29" href="#l29">29</a><td> * rely on Array.prototype functions, if available.<tr><td><a name="l30" href="#l30">30</a><td> *<tr><td><a name="l31" href="#l31">31</a><td> * The Array.prototype functions can be defined by external libraries like<tr><td><a name="l32" href="#l32">32</a><td> * Prototype and setting this flag to false forces closure to use its own<tr><td><a name="l33" href="#l33">33</a><td> * goog.array implementation.<tr><td><a name="l34" href="#l34">34</a><td> *<tr><td><a name="l35" href="#l35">35</a><td> * If your javascript can be loaded by a third party site and you are wary about<tr><td><a name="l36" href="#l36">36</a><td> * relying on the prototype functions, specify<tr><td><a name="l37" href="#l37">37</a><td> * &quot;--define goog.NATIVE_ARRAY_PROTOTYPES=false&quot; to the JSCompiler.<tr><td><a name="l38" href="#l38">38</a><td> *<tr><td><a name="l39" href="#l39">39</a><td> * Setting goog.TRUSTED_SITE to false will automatically set<tr><td><a name="l40" href="#l40">40</a><td> * NATIVE_ARRAY_PROTOTYPES to false.<tr><td><a name="l41" href="#l41">41</a><td> */<tr><td><a name="l42" href="#l42">42</a><td>goog.define(&#39;goog.NATIVE_ARRAY_PROTOTYPES&#39;, goog.TRUSTED_SITE);<tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>/**<tr><td><a name="l46" href="#l46">46</a><td> * @typedef {Array|NodeList|Arguments|{length: number}}<tr><td><a name="l47" href="#l47">47</a><td> */<tr><td><a name="l48" href="#l48">48</a><td>goog.array.ArrayLike;<tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td>/**<tr><td><a name="l52" href="#l52">52</a><td> * Returns the last element in an array without removing it.<tr><td><a name="l53" href="#l53">53</a><td> * @param {goog.array.ArrayLike} array The array.<tr><td><a name="l54" href="#l54">54</a><td> * @return {*} Last item in array.<tr><td><a name="l55" href="#l55">55</a><td> */<tr><td><a name="l56" href="#l56">56</a><td>goog.array.peek = function(array) {<tr><td><a name="l57" href="#l57">57</a><td>  return array[array.length - 1];<tr><td><a name="l58" href="#l58">58</a><td>};<tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td>/**<tr><td><a name="l62" href="#l62">62</a><td> * Reference to the original {@code Array.prototype}.<tr><td><a name="l63" href="#l63">63</a><td> * @private<tr><td><a name="l64" href="#l64">64</a><td> */<tr><td><a name="l65" href="#l65">65</a><td>goog.array.ARRAY_PROTOTYPE_ = Array.prototype;<tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td>// NOTE(arv): Since most of the array functions are generic it allows you to<tr><td><a name="l69" href="#l69">69</a><td>// pass an array-like object. Strings have a length and are considered array-<tr><td><a name="l70" href="#l70">70</a><td>// like. However, the &#39;in&#39; operator does not work on strings so we cannot just<tr><td><a name="l71" href="#l71">71</a><td>// use the array path even if the browser supports indexing into strings. We<tr><td><a name="l72" href="#l72">72</a><td>// therefore end up splitting the string.<tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td>/**<tr><td><a name="l76" href="#l76">76</a><td> * Returns the index of the first element of an array with a specified<tr><td><a name="l77" href="#l77">77</a><td> * value, or -1 if the element is not present in the array.<tr><td><a name="l78" href="#l78">78</a><td> *<tr><td><a name="l79" href="#l79">79</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-indexof}<tr><td><a name="l80" href="#l80">80</a><td> *<tr><td><a name="l81" href="#l81">81</a><td> * @param {goog.array.ArrayLike} arr The array to be searched.<tr><td><a name="l82" href="#l82">82</a><td> * @param {*} obj The object for which we are searching.<tr><td><a name="l83" href="#l83">83</a><td> * @param {number=} opt_fromIndex The index at which to start the search. If<tr><td><a name="l84" href="#l84">84</a><td> *     omitted the search starts at index 0.<tr><td><a name="l85" href="#l85">85</a><td> * @return {number} The index of the first matching array element.<tr><td><a name="l86" href="#l86">86</a><td> */<tr><td><a name="l87" href="#l87">87</a><td>goog.array.indexOf = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a name="l88" href="#l88">88</a><td>                     goog.array.ARRAY_PROTOTYPE_.indexOf ?<tr><td><a name="l89" href="#l89">89</a><td>    function(arr, obj, opt_fromIndex) {<tr><td><a name="l90" href="#l90">90</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td>      return goog.array.ARRAY_PROTOTYPE_.indexOf.call(arr, obj, opt_fromIndex);<tr><td><a name="l93" href="#l93">93</a><td>    } :<tr><td><a name="l94" href="#l94">94</a><td>    function(arr, obj, opt_fromIndex) {<tr><td><a name="l95" href="#l95">95</a><td>      var fromIndex = opt_fromIndex == null ?<tr><td><a name="l96" href="#l96">96</a><td>          0 : (opt_fromIndex &lt; 0 ?<tr><td><a name="l97" href="#l97">97</a><td>               Math.max(0, arr.length + opt_fromIndex) : opt_fromIndex);<tr><td><a name="l98" href="#l98">98</a><td><tr><td><a name="l99" href="#l99">99</a><td>      if (goog.isString(arr)) {<tr><td><a name="l100" href="#l100">100</a><td>        // Array.prototype.indexOf uses === so only strings should be found.<tr><td><a name="l101" href="#l101">101</a><td>        if (!goog.isString(obj) || obj.length != 1) {<tr><td><a name="l102" href="#l102">102</a><td>          return -1;<tr><td><a name="l103" href="#l103">103</a><td>        }<tr><td><a name="l104" href="#l104">104</a><td>        return arr.indexOf(obj, fromIndex);<tr><td><a name="l105" href="#l105">105</a><td>      }<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td>      for (var i = fromIndex; i &lt; arr.length; i++) {<tr><td><a name="l108" href="#l108">108</a><td>        if (i in arr &amp;&amp; arr[i] === obj)<tr><td><a name="l109" href="#l109">109</a><td>          return i;<tr><td><a name="l110" href="#l110">110</a><td>      }<tr><td><a name="l111" href="#l111">111</a><td>      return -1;<tr><td><a name="l112" href="#l112">112</a><td>    };<tr><td><a name="l113" href="#l113">113</a><td><tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>/**<tr><td><a name="l116" href="#l116">116</a><td> * Returns the index of the last element of an array with a specified value, or<tr><td><a name="l117" href="#l117">117</a><td> * -1 if the element is not present in the array.<tr><td><a name="l118" href="#l118">118</a><td> *<tr><td><a name="l119" href="#l119">119</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-lastindexof}<tr><td><a name="l120" href="#l120">120</a><td> *<tr><td><a name="l121" href="#l121">121</a><td> * @param {goog.array.ArrayLike} arr The array to be searched.<tr><td><a name="l122" href="#l122">122</a><td> * @param {*} obj The object for which we are searching.<tr><td><a name="l123" href="#l123">123</a><td> * @param {?number=} opt_fromIndex The index at which to start the search. If<tr><td><a name="l124" href="#l124">124</a><td> *     omitted the search starts at the end of the array.<tr><td><a name="l125" href="#l125">125</a><td> * @return {number} The index of the last matching array element.<tr><td><a name="l126" href="#l126">126</a><td> */<tr><td><a name="l127" href="#l127">127</a><td>goog.array.lastIndexOf = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a name="l128" href="#l128">128</a><td>                         goog.array.ARRAY_PROTOTYPE_.lastIndexOf ?<tr><td><a name="l129" href="#l129">129</a><td>    function(arr, obj, opt_fromIndex) {<tr><td><a name="l130" href="#l130">130</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td>      // Firefox treats undefined and null as 0 in the fromIndex argument which<tr><td><a name="l133" href="#l133">133</a><td>      // leads it to always return -1<tr><td><a name="l134" href="#l134">134</a><td>      var fromIndex = opt_fromIndex == null ? arr.length - 1 : opt_fromIndex;<tr><td><a name="l135" href="#l135">135</a><td>      return goog.array.ARRAY_PROTOTYPE_.lastIndexOf.call(arr, obj, fromIndex);<tr><td><a name="l136" href="#l136">136</a><td>    } :<tr><td><a name="l137" href="#l137">137</a><td>    function(arr, obj, opt_fromIndex) {<tr><td><a name="l138" href="#l138">138</a><td>      var fromIndex = opt_fromIndex == null ? arr.length - 1 : opt_fromIndex;<tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td>      if (fromIndex &lt; 0) {<tr><td><a name="l141" href="#l141">141</a><td>        fromIndex = Math.max(0, arr.length + fromIndex);<tr><td><a name="l142" href="#l142">142</a><td>      }<tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td>      if (goog.isString(arr)) {<tr><td><a name="l145" href="#l145">145</a><td>        // Array.prototype.lastIndexOf uses === so only strings should be found.<tr><td><a name="l146" href="#l146">146</a><td>        if (!goog.isString(obj) || obj.length != 1) {<tr><td><a name="l147" href="#l147">147</a><td>          return -1;<tr><td><a name="l148" href="#l148">148</a><td>        }<tr><td><a name="l149" href="#l149">149</a><td>        return arr.lastIndexOf(obj, fromIndex);<tr><td><a name="l150" href="#l150">150</a><td>      }<tr><td><a name="l151" href="#l151">151</a><td><tr><td><a name="l152" href="#l152">152</a><td>      for (var i = fromIndex; i &gt;= 0; i--) {<tr><td><a name="l153" href="#l153">153</a><td>        if (i in arr &amp;&amp; arr[i] === obj)<tr><td><a name="l154" href="#l154">154</a><td>          return i;<tr><td><a name="l155" href="#l155">155</a><td>      }<tr><td><a name="l156" href="#l156">156</a><td>      return -1;<tr><td><a name="l157" href="#l157">157</a><td>    };<tr><td><a name="l158" href="#l158">158</a><td><tr><td><a name="l159" href="#l159">159</a><td><tr><td><a name="l160" href="#l160">160</a><td>/**<tr><td><a name="l161" href="#l161">161</a><td> * Calls a function for each element in an array. Skips holes in the array.<tr><td><a name="l162" href="#l162">162</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-foreach}<tr><td><a name="l163" href="#l163">163</a><td> *<tr><td><a name="l164" href="#l164">164</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array like object over<tr><td><a name="l165" href="#l165">165</a><td> *     which to iterate.<tr><td><a name="l166" href="#l166">166</a><td> * @param {?function(this: S, T, number, ?): ?} f The function to call for every<tr><td><a name="l167" href="#l167">167</a><td> *     element. This function takes 3 arguments (the element, the index and the<tr><td><a name="l168" href="#l168">168</a><td> *     array). The return value is ignored.<tr><td><a name="l169" href="#l169">169</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39; within f.<tr><td><a name="l170" href="#l170">170</a><td> * @template T,S<tr><td><a name="l171" href="#l171">171</a><td> */<tr><td><a name="l172" href="#l172">172</a><td>goog.array.forEach = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a name="l173" href="#l173">173</a><td>                     goog.array.ARRAY_PROTOTYPE_.forEach ?<tr><td><a name="l174" href="#l174">174</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l175" href="#l175">175</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a name="l176" href="#l176">176</a><td><tr><td><a name="l177" href="#l177">177</a><td>      goog.array.ARRAY_PROTOTYPE_.forEach.call(arr, f, opt_obj);<tr><td><a name="l178" href="#l178">178</a><td>    } :<tr><td><a name="l179" href="#l179">179</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l180" href="#l180">180</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a name="l181" href="#l181">181</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a name="l182" href="#l182">182</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a name="l183" href="#l183">183</a><td>        if (i in arr2) {<tr><td><a name="l184" href="#l184">184</a><td>          f.call(opt_obj, arr2[i], i, arr);<tr><td><a name="l185" href="#l185">185</a><td>        }<tr><td><a name="l186" href="#l186">186</a><td>      }<tr><td><a name="l187" href="#l187">187</a><td>    };<tr><td><a name="l188" href="#l188">188</a><td><tr><td><a name="l189" href="#l189">189</a><td><tr><td><a name="l190" href="#l190">190</a><td>/**<tr><td><a name="l191" href="#l191">191</a><td> * Calls a function for each element in an array, starting from the last<tr><td><a name="l192" href="#l192">192</a><td> * element rather than the first.<tr><td><a name="l193" href="#l193">193</a><td> *<tr><td><a name="l194" href="#l194">194</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l195" href="#l195">195</a><td> *     like object over which to iterate.<tr><td><a name="l196" href="#l196">196</a><td> * @param {?function(this: S, T, number, ?): ?} f The function to call for every<tr><td><a name="l197" href="#l197">197</a><td> *     element. This function<tr><td><a name="l198" href="#l198">198</a><td> *     takes 3 arguments (the element, the index and the array). The return<tr><td><a name="l199" href="#l199">199</a><td> *     value is ignored.<tr><td><a name="l200" href="#l200">200</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l201" href="#l201">201</a><td> *     within f.<tr><td><a name="l202" href="#l202">202</a><td> * @template T,S<tr><td><a name="l203" href="#l203">203</a><td> */<tr><td><a name="l204" href="#l204">204</a><td>goog.array.forEachRight = function(arr, f, opt_obj) {<tr><td><a name="l205" href="#l205">205</a><td>  var l = arr.length;  // must be fixed during loop... see docs<tr><td><a name="l206" href="#l206">206</a><td>  var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a name="l207" href="#l207">207</a><td>  for (var i = l - 1; i &gt;= 0; --i) {<tr><td><a name="l208" href="#l208">208</a><td>    if (i in arr2) {<tr><td><a name="l209" href="#l209">209</a><td>      f.call(opt_obj, arr2[i], i, arr);<tr><td><a name="l210" href="#l210">210</a><td>    }<tr><td><a name="l211" href="#l211">211</a><td>  }<tr><td><a name="l212" href="#l212">212</a><td>};<tr><td><a name="l213" href="#l213">213</a><td><tr><td><a name="l214" href="#l214">214</a><td><tr><td><a name="l215" href="#l215">215</a><td>/**<tr><td><a name="l216" href="#l216">216</a><td> * Calls a function for each element in an array, and if the function returns<tr><td><a name="l217" href="#l217">217</a><td> * true adds the element to a new array.<tr><td><a name="l218" href="#l218">218</a><td> *<tr><td><a name="l219" href="#l219">219</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-filter}<tr><td><a name="l220" href="#l220">220</a><td> *<tr><td><a name="l221" href="#l221">221</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l222" href="#l222">222</a><td> *     like object over which to iterate.<tr><td><a name="l223" href="#l223">223</a><td> * @param {?function(this:S, T, number, ?):boolean} f The function to call for<tr><td><a name="l224" href="#l224">224</a><td> *     every element. This function<tr><td><a name="l225" href="#l225">225</a><td> *     takes 3 arguments (the element, the index and the array) and must<tr><td><a name="l226" href="#l226">226</a><td> *     return a Boolean. If the return value is true the element is added to the<tr><td><a name="l227" href="#l227">227</a><td> *     result array. If it is false the element is not included.<tr><td><a name="l228" href="#l228">228</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l229" href="#l229">229</a><td> *     within f.<tr><td><a name="l230" href="#l230">230</a><td> * @return {!Array} a new array in which only elements that passed the test are<tr><td><a name="l231" href="#l231">231</a><td> *     present.<tr><td><a name="l232" href="#l232">232</a><td> * @template T,S<tr><td><a name="l233" href="#l233">233</a><td> */<tr><td><a name="l234" href="#l234">234</a><td>goog.array.filter = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a name="l235" href="#l235">235</a><td>                    goog.array.ARRAY_PROTOTYPE_.filter ?<tr><td><a name="l236" href="#l236">236</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l237" href="#l237">237</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a name="l238" href="#l238">238</a><td><tr><td><a name="l239" href="#l239">239</a><td>      return goog.array.ARRAY_PROTOTYPE_.filter.call(arr, f, opt_obj);<tr><td><a name="l240" href="#l240">240</a><td>    } :<tr><td><a name="l241" href="#l241">241</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l242" href="#l242">242</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a name="l243" href="#l243">243</a><td>      var res = [];<tr><td><a name="l244" href="#l244">244</a><td>      var resLength = 0;<tr><td><a name="l245" href="#l245">245</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a name="l246" href="#l246">246</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a name="l247" href="#l247">247</a><td>        if (i in arr2) {<tr><td><a name="l248" href="#l248">248</a><td>          var val = arr2[i];  // in case f mutates arr2<tr><td><a name="l249" href="#l249">249</a><td>          if (f.call(opt_obj, val, i, arr)) {<tr><td><a name="l250" href="#l250">250</a><td>            res[resLength++] = val;<tr><td><a name="l251" href="#l251">251</a><td>          }<tr><td><a name="l252" href="#l252">252</a><td>        }<tr><td><a name="l253" href="#l253">253</a><td>      }<tr><td><a name="l254" href="#l254">254</a><td>      return res;<tr><td><a name="l255" href="#l255">255</a><td>    };<tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td><tr><td><a name="l258" href="#l258">258</a><td>/**<tr><td><a name="l259" href="#l259">259</a><td> * Calls a function for each element in an array and inserts the result into a<tr><td><a name="l260" href="#l260">260</a><td> * new array.<tr><td><a name="l261" href="#l261">261</a><td> *<tr><td><a name="l262" href="#l262">262</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-map}<tr><td><a name="l263" href="#l263">263</a><td> *<tr><td><a name="l264" href="#l264">264</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l265" href="#l265">265</a><td> *     like object over which to iterate.<tr><td><a name="l266" href="#l266">266</a><td> * @param {?function(this:S, T, number, ?):?} f The function to call for every<tr><td><a name="l267" href="#l267">267</a><td> *     element. This function<tr><td><a name="l268" href="#l268">268</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a name="l269" href="#l269">269</a><td> *     return something. The result will be inserted into a new array.<tr><td><a name="l270" href="#l270">270</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l271" href="#l271">271</a><td> *     within f.<tr><td><a name="l272" href="#l272">272</a><td> * @return {!Array} a new array with the results from f.<tr><td><a name="l273" href="#l273">273</a><td> * @template T,S<tr><td><a name="l274" href="#l274">274</a><td> */<tr><td><a name="l275" href="#l275">275</a><td>goog.array.map = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a name="l276" href="#l276">276</a><td>                 goog.array.ARRAY_PROTOTYPE_.map ?<tr><td><a name="l277" href="#l277">277</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l278" href="#l278">278</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a name="l279" href="#l279">279</a><td><tr><td><a name="l280" href="#l280">280</a><td>      return goog.array.ARRAY_PROTOTYPE_.map.call(arr, f, opt_obj);<tr><td><a name="l281" href="#l281">281</a><td>    } :<tr><td><a name="l282" href="#l282">282</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l283" href="#l283">283</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a name="l284" href="#l284">284</a><td>      var res = new Array(l);<tr><td><a name="l285" href="#l285">285</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a name="l286" href="#l286">286</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a name="l287" href="#l287">287</a><td>        if (i in arr2) {<tr><td><a name="l288" href="#l288">288</a><td>          res[i] = f.call(opt_obj, arr2[i], i, arr);<tr><td><a name="l289" href="#l289">289</a><td>        }<tr><td><a name="l290" href="#l290">290</a><td>      }<tr><td><a name="l291" href="#l291">291</a><td>      return res;<tr><td><a name="l292" href="#l292">292</a><td>    };<tr><td><a name="l293" href="#l293">293</a><td><tr><td><a name="l294" href="#l294">294</a><td><tr><td><a name="l295" href="#l295">295</a><td>/**<tr><td><a name="l296" href="#l296">296</a><td> * Passes every element of an array into a function and accumulates the result.<tr><td><a name="l297" href="#l297">297</a><td> *<tr><td><a name="l298" href="#l298">298</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-reduce}<tr><td><a name="l299" href="#l299">299</a><td> *<tr><td><a name="l300" href="#l300">300</a><td> * For example:<tr><td><a name="l301" href="#l301">301</a><td> * var a = [1, 2, 3, 4];<tr><td><a name="l302" href="#l302">302</a><td> * goog.array.reduce(a, function(r, v, i, arr) {return r + v;}, 0);<tr><td><a name="l303" href="#l303">303</a><td> * returns 10<tr><td><a name="l304" href="#l304">304</a><td> *<tr><td><a name="l305" href="#l305">305</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l306" href="#l306">306</a><td> *     like object over which to iterate.<tr><td><a name="l307" href="#l307">307</a><td> * @param {?function(this:S, R, T, number, ?) : R} f The function to call for<tr><td><a name="l308" href="#l308">308</a><td> *     every element. This function<tr><td><a name="l309" href="#l309">309</a><td> *     takes 4 arguments (the function&#39;s previous result or the initial value,<tr><td><a name="l310" href="#l310">310</a><td> *     the value of the current array element, the current array index, and the<tr><td><a name="l311" href="#l311">311</a><td> *     array itself)<tr><td><a name="l312" href="#l312">312</a><td> *     function(previousValue, currentValue, index, array).<tr><td><a name="l313" href="#l313">313</a><td> * @param {?} val The initial value to pass into the function on the first call.<tr><td><a name="l314" href="#l314">314</a><td> * @param {S=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a name="l315" href="#l315">315</a><td> *     within f.<tr><td><a name="l316" href="#l316">316</a><td> * @return {R} Result of evaluating f repeatedly across the values of the array.<tr><td><a name="l317" href="#l317">317</a><td> * @template T,S,R<tr><td><a name="l318" href="#l318">318</a><td> */<tr><td><a name="l319" href="#l319">319</a><td>goog.array.reduce = function(arr, f, val, opt_obj) {<tr><td><a name="l320" href="#l320">320</a><td>  if (arr.reduce) {<tr><td><a name="l321" href="#l321">321</a><td>    if (opt_obj) {<tr><td><a name="l322" href="#l322">322</a><td>      return arr.reduce(goog.bind(f, opt_obj), val);<tr><td><a name="l323" href="#l323">323</a><td>    } else {<tr><td><a name="l324" href="#l324">324</a><td>      return arr.reduce(f, val);<tr><td><a name="l325" href="#l325">325</a><td>    }<tr><td><a name="l326" href="#l326">326</a><td>  }<tr><td><a name="l327" href="#l327">327</a><td>  var rval = val;<tr><td><a name="l328" href="#l328">328</a><td>  goog.array.forEach(arr, function(val, index) {<tr><td><a name="l329" href="#l329">329</a><td>    rval = f.call(opt_obj, rval, val, index, arr);<tr><td><a name="l330" href="#l330">330</a><td>  });<tr><td><a name="l331" href="#l331">331</a><td>  return rval;<tr><td><a name="l332" href="#l332">332</a><td>};<tr><td><a name="l333" href="#l333">333</a><td><tr><td><a name="l334" href="#l334">334</a><td><tr><td><a name="l335" href="#l335">335</a><td>/**<tr><td><a name="l336" href="#l336">336</a><td> * Passes every element of an array into a function and accumulates the result,<tr><td><a name="l337" href="#l337">337</a><td> * starting from the last element and working towards the first.<tr><td><a name="l338" href="#l338">338</a><td> *<tr><td><a name="l339" href="#l339">339</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-reduceright}<tr><td><a name="l340" href="#l340">340</a><td> *<tr><td><a name="l341" href="#l341">341</a><td> * For example:<tr><td><a name="l342" href="#l342">342</a><td> * var a = [&#39;a&#39;, &#39;b&#39;, &#39;c&#39;];<tr><td><a name="l343" href="#l343">343</a><td> * goog.array.reduceRight(a, function(r, v, i, arr) {return r + v;}, &#39;&#39;);<tr><td><a name="l344" href="#l344">344</a><td> * returns &#39;cba&#39;<tr><td><a name="l345" href="#l345">345</a><td> *<tr><td><a name="l346" href="#l346">346</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l347" href="#l347">347</a><td> *     like object over which to iterate.<tr><td><a name="l348" href="#l348">348</a><td> * @param {?function(this:S, R, T, number, ?) : R} f The function to call for<tr><td><a name="l349" href="#l349">349</a><td> *     every element. This function<tr><td><a name="l350" href="#l350">350</a><td> *     takes 4 arguments (the function&#39;s previous result or the initial value,<tr><td><a name="l351" href="#l351">351</a><td> *     the value of the current array element, the current array index, and the<tr><td><a name="l352" href="#l352">352</a><td> *     array itself)<tr><td><a name="l353" href="#l353">353</a><td> *     function(previousValue, currentValue, index, array).<tr><td><a name="l354" href="#l354">354</a><td> * @param {?} val The initial value to pass into the function on the first call.<tr><td><a name="l355" href="#l355">355</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l356" href="#l356">356</a><td> *     within f.<tr><td><a name="l357" href="#l357">357</a><td> * @return {R} Object returned as a result of evaluating f repeatedly across the<tr><td><a name="l358" href="#l358">358</a><td> *     values of the array.<tr><td><a name="l359" href="#l359">359</a><td> * @template T,S,R<tr><td><a name="l360" href="#l360">360</a><td> */<tr><td><a name="l361" href="#l361">361</a><td>goog.array.reduceRight = function(arr, f, val, opt_obj) {<tr><td><a name="l362" href="#l362">362</a><td>  if (arr.reduceRight) {<tr><td><a name="l363" href="#l363">363</a><td>    if (opt_obj) {<tr><td><a name="l364" href="#l364">364</a><td>      return arr.reduceRight(goog.bind(f, opt_obj), val);<tr><td><a name="l365" href="#l365">365</a><td>    } else {<tr><td><a name="l366" href="#l366">366</a><td>      return arr.reduceRight(f, val);<tr><td><a name="l367" href="#l367">367</a><td>    }<tr><td><a name="l368" href="#l368">368</a><td>  }<tr><td><a name="l369" href="#l369">369</a><td>  var rval = val;<tr><td><a name="l370" href="#l370">370</a><td>  goog.array.forEachRight(arr, function(val, index) {<tr><td><a name="l371" href="#l371">371</a><td>    rval = f.call(opt_obj, rval, val, index, arr);<tr><td><a name="l372" href="#l372">372</a><td>  });<tr><td><a name="l373" href="#l373">373</a><td>  return rval;<tr><td><a name="l374" href="#l374">374</a><td>};<tr><td><a name="l375" href="#l375">375</a><td><tr><td><a name="l376" href="#l376">376</a><td><tr><td><a name="l377" href="#l377">377</a><td>/**<tr><td><a name="l378" href="#l378">378</a><td> * Calls f for each element of an array. If any call returns true, some()<tr><td><a name="l379" href="#l379">379</a><td> * returns true (without checking the remaining elements). If all calls<tr><td><a name="l380" href="#l380">380</a><td> * return false, some() returns false.<tr><td><a name="l381" href="#l381">381</a><td> *<tr><td><a name="l382" href="#l382">382</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-some}<tr><td><a name="l383" href="#l383">383</a><td> *<tr><td><a name="l384" href="#l384">384</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l385" href="#l385">385</a><td> *     like object over which to iterate.<tr><td><a name="l386" href="#l386">386</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call for<tr><td><a name="l387" href="#l387">387</a><td> *     for every element. This function takes 3 arguments (the element, the<tr><td><a name="l388" href="#l388">388</a><td> *     index and the array) and should return a boolean.<tr><td><a name="l389" href="#l389">389</a><td> * @param {S=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a name="l390" href="#l390">390</a><td> *     within f.<tr><td><a name="l391" href="#l391">391</a><td> * @return {boolean} true if any element passes the test.<tr><td><a name="l392" href="#l392">392</a><td> * @template T,S<tr><td><a name="l393" href="#l393">393</a><td> */<tr><td><a name="l394" href="#l394">394</a><td>goog.array.some = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a name="l395" href="#l395">395</a><td>                  goog.array.ARRAY_PROTOTYPE_.some ?<tr><td><a name="l396" href="#l396">396</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l397" href="#l397">397</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a name="l398" href="#l398">398</a><td><tr><td><a name="l399" href="#l399">399</a><td>      return goog.array.ARRAY_PROTOTYPE_.some.call(arr, f, opt_obj);<tr><td><a name="l400" href="#l400">400</a><td>    } :<tr><td><a name="l401" href="#l401">401</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l402" href="#l402">402</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a name="l403" href="#l403">403</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a name="l404" href="#l404">404</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a name="l405" href="#l405">405</a><td>        if (i in arr2 &amp;&amp; f.call(opt_obj, arr2[i], i, arr)) {<tr><td><a name="l406" href="#l406">406</a><td>          return true;<tr><td><a name="l407" href="#l407">407</a><td>        }<tr><td><a name="l408" href="#l408">408</a><td>      }<tr><td><a name="l409" href="#l409">409</a><td>      return false;<tr><td><a name="l410" href="#l410">410</a><td>    };<tr><td><a name="l411" href="#l411">411</a><td><tr><td><a name="l412" href="#l412">412</a><td><tr><td><a name="l413" href="#l413">413</a><td>/**<tr><td><a name="l414" href="#l414">414</a><td> * Call f for each element of an array. If all calls return true, every()<tr><td><a name="l415" href="#l415">415</a><td> * returns true. If any call returns false, every() returns false and<tr><td><a name="l416" href="#l416">416</a><td> * does not continue to check the remaining elements.<tr><td><a name="l417" href="#l417">417</a><td> *<tr><td><a name="l418" href="#l418">418</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-every}<tr><td><a name="l419" href="#l419">419</a><td> *<tr><td><a name="l420" href="#l420">420</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l421" href="#l421">421</a><td> *     like object over which to iterate.<tr><td><a name="l422" href="#l422">422</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call for<tr><td><a name="l423" href="#l423">423</a><td> *     for every element. This function takes 3 arguments (the element, the<tr><td><a name="l424" href="#l424">424</a><td> *     index and the array) and should return a boolean.<tr><td><a name="l425" href="#l425">425</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l426" href="#l426">426</a><td> *     within f.<tr><td><a name="l427" href="#l427">427</a><td> * @return {boolean} false if any element fails the test.<tr><td><a name="l428" href="#l428">428</a><td> * @template T,S<tr><td><a name="l429" href="#l429">429</a><td> */<tr><td><a name="l430" href="#l430">430</a><td>goog.array.every = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a name="l431" href="#l431">431</a><td>                   goog.array.ARRAY_PROTOTYPE_.every ?<tr><td><a name="l432" href="#l432">432</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l433" href="#l433">433</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a name="l434" href="#l434">434</a><td><tr><td><a name="l435" href="#l435">435</a><td>      return goog.array.ARRAY_PROTOTYPE_.every.call(arr, f, opt_obj);<tr><td><a name="l436" href="#l436">436</a><td>    } :<tr><td><a name="l437" href="#l437">437</a><td>    function(arr, f, opt_obj) {<tr><td><a name="l438" href="#l438">438</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a name="l439" href="#l439">439</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a name="l440" href="#l440">440</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a name="l441" href="#l441">441</a><td>        if (i in arr2 &amp;&amp; !f.call(opt_obj, arr2[i], i, arr)) {<tr><td><a name="l442" href="#l442">442</a><td>          return false;<tr><td><a name="l443" href="#l443">443</a><td>        }<tr><td><a name="l444" href="#l444">444</a><td>      }<tr><td><a name="l445" href="#l445">445</a><td>      return true;<tr><td><a name="l446" href="#l446">446</a><td>    };<tr><td><a name="l447" href="#l447">447</a><td><tr><td><a name="l448" href="#l448">448</a><td><tr><td><a name="l449" href="#l449">449</a><td>/**<tr><td><a name="l450" href="#l450">450</a><td> * Counts the array elements that fulfill the predicate, i.e. for which the<tr><td><a name="l451" href="#l451">451</a><td> * callback function returns true. Skips holes in the array.<tr><td><a name="l452" href="#l452">452</a><td> *<tr><td><a name="l453" href="#l453">453</a><td> * @param {!(Array.&lt;T&gt;|goog.array.ArrayLike)} arr Array or array like object<tr><td><a name="l454" href="#l454">454</a><td> *     over which to iterate.<tr><td><a name="l455" href="#l455">455</a><td> * @param {function(this: S, T, number, ?): boolean} f The function to call for<tr><td><a name="l456" href="#l456">456</a><td> *     every element. Takes 3 arguments (the element, the index and the array).<tr><td><a name="l457" href="#l457">457</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39; within f.<tr><td><a name="l458" href="#l458">458</a><td> * @return {number} The number of the matching elements.<tr><td><a name="l459" href="#l459">459</a><td> * @template T,S<tr><td><a name="l460" href="#l460">460</a><td> */<tr><td><a name="l461" href="#l461">461</a><td>goog.array.count = function(arr, f, opt_obj) {<tr><td><a name="l462" href="#l462">462</a><td>  var count = 0;<tr><td><a name="l463" href="#l463">463</a><td>  goog.array.forEach(arr, function(element, index, arr) {<tr><td><a name="l464" href="#l464">464</a><td>    if (f.call(opt_obj, element, index, arr)) {<tr><td><a name="l465" href="#l465">465</a><td>      ++count;<tr><td><a name="l466" href="#l466">466</a><td>    }<tr><td><a name="l467" href="#l467">467</a><td>  }, opt_obj);<tr><td><a name="l468" href="#l468">468</a><td>  return count;<tr><td><a name="l469" href="#l469">469</a><td>};<tr><td><a name="l470" href="#l470">470</a><td><tr><td><a name="l471" href="#l471">471</a><td><tr><td><a name="l472" href="#l472">472</a><td>/**<tr><td><a name="l473" href="#l473">473</a><td> * Search an array for the first element that satisfies a given condition and<tr><td><a name="l474" href="#l474">474</a><td> * return that element.<tr><td><a name="l475" href="#l475">475</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l476" href="#l476">476</a><td> *     like object over which to iterate.<tr><td><a name="l477" href="#l477">477</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a name="l478" href="#l478">478</a><td> *     for every element. This function takes 3 arguments (the element, the<tr><td><a name="l479" href="#l479">479</a><td> *     index and the array) and should return a boolean.<tr><td><a name="l480" href="#l480">480</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a name="l481" href="#l481">481</a><td> * @return {T} The first array element that passes the test, or null if no<tr><td><a name="l482" href="#l482">482</a><td> *     element is found.<tr><td><a name="l483" href="#l483">483</a><td> * @template T,S<tr><td><a name="l484" href="#l484">484</a><td> */<tr><td><a name="l485" href="#l485">485</a><td>goog.array.find = function(arr, f, opt_obj) {<tr><td><a name="l486" href="#l486">486</a><td>  var i = goog.array.findIndex(arr, f, opt_obj);<tr><td><a name="l487" href="#l487">487</a><td>  return i &lt; 0 ? null : goog.isString(arr) ? arr.charAt(i) : arr[i];<tr><td><a name="l488" href="#l488">488</a><td>};<tr><td><a name="l489" href="#l489">489</a><td><tr><td><a name="l490" href="#l490">490</a><td><tr><td><a name="l491" href="#l491">491</a><td>/**<tr><td><a name="l492" href="#l492">492</a><td> * Search an array for the first element that satisfies a given condition and<tr><td><a name="l493" href="#l493">493</a><td> * return its index.<tr><td><a name="l494" href="#l494">494</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l495" href="#l495">495</a><td> *     like object over which to iterate.<tr><td><a name="l496" href="#l496">496</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call for<tr><td><a name="l497" href="#l497">497</a><td> *     every element. This function<tr><td><a name="l498" href="#l498">498</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a name="l499" href="#l499">499</a><td> *     return a boolean.<tr><td><a name="l500" href="#l500">500</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a name="l501" href="#l501">501</a><td> * @return {number} The index of the first array element that passes the test,<tr><td><a name="l502" href="#l502">502</a><td> *     or -1 if no element is found.<tr><td><a name="l503" href="#l503">503</a><td> * @template T,S<tr><td><a name="l504" href="#l504">504</a><td> */<tr><td><a name="l505" href="#l505">505</a><td>goog.array.findIndex = function(arr, f, opt_obj) {<tr><td><a name="l506" href="#l506">506</a><td>  var l = arr.length;  // must be fixed during loop... see docs<tr><td><a name="l507" href="#l507">507</a><td>  var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a name="l508" href="#l508">508</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a name="l509" href="#l509">509</a><td>    if (i in arr2 &amp;&amp; f.call(opt_obj, arr2[i], i, arr)) {<tr><td><a name="l510" href="#l510">510</a><td>      return i;<tr><td><a name="l511" href="#l511">511</a><td>    }<tr><td><a name="l512" href="#l512">512</a><td>  }<tr><td><a name="l513" href="#l513">513</a><td>  return -1;<tr><td><a name="l514" href="#l514">514</a><td>};<tr><td><a name="l515" href="#l515">515</a><td><tr><td><a name="l516" href="#l516">516</a><td><tr><td><a name="l517" href="#l517">517</a><td>/**<tr><td><a name="l518" href="#l518">518</a><td> * Search an array (in reverse order) for the last element that satisfies a<tr><td><a name="l519" href="#l519">519</a><td> * given condition and return that element.<tr><td><a name="l520" href="#l520">520</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l521" href="#l521">521</a><td> *     like object over which to iterate.<tr><td><a name="l522" href="#l522">522</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a name="l523" href="#l523">523</a><td> *     for every element. This function<tr><td><a name="l524" href="#l524">524</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a name="l525" href="#l525">525</a><td> *     return a boolean.<tr><td><a name="l526" href="#l526">526</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a name="l527" href="#l527">527</a><td> * @return {T} The last array element that passes the test, or null if no<tr><td><a name="l528" href="#l528">528</a><td> *     element is found.<tr><td><a name="l529" href="#l529">529</a><td> * @template T,S<tr><td><a name="l530" href="#l530">530</a><td> */<tr><td><a name="l531" href="#l531">531</a><td>goog.array.findRight = function(arr, f, opt_obj) {<tr><td><a name="l532" href="#l532">532</a><td>  var i = goog.array.findIndexRight(arr, f, opt_obj);<tr><td><a name="l533" href="#l533">533</a><td>  return i &lt; 0 ? null : goog.isString(arr) ? arr.charAt(i) : arr[i];<tr><td><a name="l534" href="#l534">534</a><td>};<tr><td><a name="l535" href="#l535">535</a><td><tr><td><a name="l536" href="#l536">536</a><td><tr><td><a name="l537" href="#l537">537</a><td>/**<tr><td><a name="l538" href="#l538">538</a><td> * Search an array (in reverse order) for the last element that satisfies a<tr><td><a name="l539" href="#l539">539</a><td> * given condition and return its index.<tr><td><a name="l540" href="#l540">540</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l541" href="#l541">541</a><td> *     like object over which to iterate.<tr><td><a name="l542" href="#l542">542</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a name="l543" href="#l543">543</a><td> *     for every element. This function<tr><td><a name="l544" href="#l544">544</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a name="l545" href="#l545">545</a><td> *     return a boolean.<tr><td><a name="l546" href="#l546">546</a><td> * @param {Object=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a name="l547" href="#l547">547</a><td> * @return {number} The index of the last array element that passes the test,<tr><td><a name="l548" href="#l548">548</a><td> *     or -1 if no element is found.<tr><td><a name="l549" href="#l549">549</a><td> * @template T,S<tr><td><a name="l550" href="#l550">550</a><td> */<tr><td><a name="l551" href="#l551">551</a><td>goog.array.findIndexRight = function(arr, f, opt_obj) {<tr><td><a name="l552" href="#l552">552</a><td>  var l = arr.length;  // must be fixed during loop... see docs<tr><td><a name="l553" href="#l553">553</a><td>  var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a name="l554" href="#l554">554</a><td>  for (var i = l - 1; i &gt;= 0; i--) {<tr><td><a name="l555" href="#l555">555</a><td>    if (i in arr2 &amp;&amp; f.call(opt_obj, arr2[i], i, arr)) {<tr><td><a name="l556" href="#l556">556</a><td>      return i;<tr><td><a name="l557" href="#l557">557</a><td>    }<tr><td><a name="l558" href="#l558">558</a><td>  }<tr><td><a name="l559" href="#l559">559</a><td>  return -1;<tr><td><a name="l560" href="#l560">560</a><td>};<tr><td><a name="l561" href="#l561">561</a><td><tr><td><a name="l562" href="#l562">562</a><td><tr><td><a name="l563" href="#l563">563</a><td>/**<tr><td><a name="l564" href="#l564">564</a><td> * Whether the array contains the given object.<tr><td><a name="l565" href="#l565">565</a><td> * @param {goog.array.ArrayLike} arr The array to test for the presence of the<tr><td><a name="l566" href="#l566">566</a><td> *     element.<tr><td><a name="l567" href="#l567">567</a><td> * @param {*} obj The object for which to test.<tr><td><a name="l568" href="#l568">568</a><td> * @return {boolean} true if obj is present.<tr><td><a name="l569" href="#l569">569</a><td> */<tr><td><a name="l570" href="#l570">570</a><td>goog.array.contains = function(arr, obj) {<tr><td><a name="l571" href="#l571">571</a><td>  return goog.array.indexOf(arr, obj) &gt;= 0;<tr><td><a name="l572" href="#l572">572</a><td>};<tr><td><a name="l573" href="#l573">573</a><td><tr><td><a name="l574" href="#l574">574</a><td><tr><td><a name="l575" href="#l575">575</a><td>/**<tr><td><a name="l576" href="#l576">576</a><td> * Whether the array is empty.<tr><td><a name="l577" href="#l577">577</a><td> * @param {goog.array.ArrayLike} arr The array to test.<tr><td><a name="l578" href="#l578">578</a><td> * @return {boolean} true if empty.<tr><td><a name="l579" href="#l579">579</a><td> */<tr><td><a name="l580" href="#l580">580</a><td>goog.array.isEmpty = function(arr) {<tr><td><a name="l581" href="#l581">581</a><td>  return arr.length == 0;<tr><td><a name="l582" href="#l582">582</a><td>};<tr><td><a name="l583" href="#l583">583</a><td><tr><td><a name="l584" href="#l584">584</a><td><tr><td><a name="l585" href="#l585">585</a><td>/**<tr><td><a name="l586" href="#l586">586</a><td> * Clears the array.<tr><td><a name="l587" href="#l587">587</a><td> * @param {goog.array.ArrayLike} arr Array or array like object to clear.<tr><td><a name="l588" href="#l588">588</a><td> */<tr><td><a name="l589" href="#l589">589</a><td>goog.array.clear = function(arr) {<tr><td><a name="l590" href="#l590">590</a><td>  // For non real arrays we don&#39;t have the magic length so we delete the<tr><td><a name="l591" href="#l591">591</a><td>  // indices.<tr><td><a name="l592" href="#l592">592</a><td>  if (!goog.isArray(arr)) {<tr><td><a name="l593" href="#l593">593</a><td>    for (var i = arr.length - 1; i &gt;= 0; i--) {<tr><td><a name="l594" href="#l594">594</a><td>      delete arr[i];<tr><td><a name="l595" href="#l595">595</a><td>    }<tr><td><a name="l596" href="#l596">596</a><td>  }<tr><td><a name="l597" href="#l597">597</a><td>  arr.length = 0;<tr><td><a name="l598" href="#l598">598</a><td>};<tr><td><a name="l599" href="#l599">599</a><td><tr><td><a name="l600" href="#l600">600</a><td><tr><td><a name="l601" href="#l601">601</a><td>/**<tr><td><a name="l602" href="#l602">602</a><td> * Pushes an item into an array, if it&#39;s not already in the array.<tr><td><a name="l603" href="#l603">603</a><td> * @param {Array.&lt;T&gt;} arr Array into which to insert the item.<tr><td><a name="l604" href="#l604">604</a><td> * @param {T} obj Value to add.<tr><td><a name="l605" href="#l605">605</a><td> * @template T<tr><td><a name="l606" href="#l606">606</a><td> */<tr><td><a name="l607" href="#l607">607</a><td>goog.array.insert = function(arr, obj) {<tr><td><a name="l608" href="#l608">608</a><td>  if (!goog.array.contains(arr, obj)) {<tr><td><a name="l609" href="#l609">609</a><td>    arr.push(obj);<tr><td><a name="l610" href="#l610">610</a><td>  }<tr><td><a name="l611" href="#l611">611</a><td>};<tr><td><a name="l612" href="#l612">612</a><td><tr><td><a name="l613" href="#l613">613</a><td><tr><td><a name="l614" href="#l614">614</a><td>/**<tr><td><a name="l615" href="#l615">615</a><td> * Inserts an object at the given index of the array.<tr><td><a name="l616" href="#l616">616</a><td> * @param {goog.array.ArrayLike} arr The array to modify.<tr><td><a name="l617" href="#l617">617</a><td> * @param {*} obj The object to insert.<tr><td><a name="l618" href="#l618">618</a><td> * @param {number=} opt_i The index at which to insert the object. If omitted,<tr><td><a name="l619" href="#l619">619</a><td> *      treated as 0. A negative index is counted from the end of the array.<tr><td><a name="l620" href="#l620">620</a><td> */<tr><td><a name="l621" href="#l621">621</a><td>goog.array.insertAt = function(arr, obj, opt_i) {<tr><td><a name="l622" href="#l622">622</a><td>  goog.array.splice(arr, opt_i, 0, obj);<tr><td><a name="l623" href="#l623">623</a><td>};<tr><td><a name="l624" href="#l624">624</a><td><tr><td><a name="l625" href="#l625">625</a><td><tr><td><a name="l626" href="#l626">626</a><td>/**<tr><td><a name="l627" href="#l627">627</a><td> * Inserts at the given index of the array, all elements of another array.<tr><td><a name="l628" href="#l628">628</a><td> * @param {goog.array.ArrayLike} arr The array to modify.<tr><td><a name="l629" href="#l629">629</a><td> * @param {goog.array.ArrayLike} elementsToAdd The array of elements to add.<tr><td><a name="l630" href="#l630">630</a><td> * @param {number=} opt_i The index at which to insert the object. If omitted,<tr><td><a name="l631" href="#l631">631</a><td> *      treated as 0. A negative index is counted from the end of the array.<tr><td><a name="l632" href="#l632">632</a><td> */<tr><td><a name="l633" href="#l633">633</a><td>goog.array.insertArrayAt = function(arr, elementsToAdd, opt_i) {<tr><td><a name="l634" href="#l634">634</a><td>  goog.partial(goog.array.splice, arr, opt_i, 0).apply(null, elementsToAdd);<tr><td><a name="l635" href="#l635">635</a><td>};<tr><td><a name="l636" href="#l636">636</a><td><tr><td><a name="l637" href="#l637">637</a><td><tr><td><a name="l638" href="#l638">638</a><td>/**<tr><td><a name="l639" href="#l639">639</a><td> * Inserts an object into an array before a specified object.<tr><td><a name="l640" href="#l640">640</a><td> * @param {Array.&lt;T&gt;} arr The array to modify.<tr><td><a name="l641" href="#l641">641</a><td> * @param {T} obj The object to insert.<tr><td><a name="l642" href="#l642">642</a><td> * @param {T=} opt_obj2 The object before which obj should be inserted. If obj2<tr><td><a name="l643" href="#l643">643</a><td> *     is omitted or not found, obj is inserted at the end of the array.<tr><td><a name="l644" href="#l644">644</a><td> * @template T<tr><td><a name="l645" href="#l645">645</a><td> */<tr><td><a name="l646" href="#l646">646</a><td>goog.array.insertBefore = function(arr, obj, opt_obj2) {<tr><td><a name="l647" href="#l647">647</a><td>  var i;<tr><td><a name="l648" href="#l648">648</a><td>  if (arguments.length == 2 || (i = goog.array.indexOf(arr, opt_obj2)) &lt; 0) {<tr><td><a name="l649" href="#l649">649</a><td>    arr.push(obj);<tr><td><a name="l650" href="#l650">650</a><td>  } else {<tr><td><a name="l651" href="#l651">651</a><td>    goog.array.insertAt(arr, obj, i);<tr><td><a name="l652" href="#l652">652</a><td>  }<tr><td><a name="l653" href="#l653">653</a><td>};<tr><td><a name="l654" href="#l654">654</a><td><tr><td><a name="l655" href="#l655">655</a><td><tr><td><a name="l656" href="#l656">656</a><td>/**<tr><td><a name="l657" href="#l657">657</a><td> * Removes the first occurrence of a particular value from an array.<tr><td><a name="l658" href="#l658">658</a><td> * @param {goog.array.ArrayLike} arr Array from which to remove value.<tr><td><a name="l659" href="#l659">659</a><td> * @param {*} obj Object to remove.<tr><td><a name="l660" href="#l660">660</a><td> * @return {boolean} True if an element was removed.<tr><td><a name="l661" href="#l661">661</a><td> */<tr><td><a name="l662" href="#l662">662</a><td>goog.array.remove = function(arr, obj) {<tr><td><a name="l663" href="#l663">663</a><td>  var i = goog.array.indexOf(arr, obj);<tr><td><a name="l664" href="#l664">664</a><td>  var rv;<tr><td><a name="l665" href="#l665">665</a><td>  if ((rv = i &gt;= 0)) {<tr><td><a name="l666" href="#l666">666</a><td>    goog.array.removeAt(arr, i);<tr><td><a name="l667" href="#l667">667</a><td>  }<tr><td><a name="l668" href="#l668">668</a><td>  return rv;<tr><td><a name="l669" href="#l669">669</a><td>};<tr><td><a name="l670" href="#l670">670</a><td><tr><td><a name="l671" href="#l671">671</a><td><tr><td><a name="l672" href="#l672">672</a><td>/**<tr><td><a name="l673" href="#l673">673</a><td> * Removes from an array the element at index i<tr><td><a name="l674" href="#l674">674</a><td> * @param {goog.array.ArrayLike} arr Array or array like object from which to<tr><td><a name="l675" href="#l675">675</a><td> *     remove value.<tr><td><a name="l676" href="#l676">676</a><td> * @param {number} i The index to remove.<tr><td><a name="l677" href="#l677">677</a><td> * @return {boolean} True if an element was removed.<tr><td><a name="l678" href="#l678">678</a><td> */<tr><td><a name="l679" href="#l679">679</a><td>goog.array.removeAt = function(arr, i) {<tr><td><a name="l680" href="#l680">680</a><td>  goog.asserts.assert(arr.length != null);<tr><td><a name="l681" href="#l681">681</a><td><tr><td><a name="l682" href="#l682">682</a><td>  // use generic form of splice<tr><td><a name="l683" href="#l683">683</a><td>  // splice returns the removed items and if successful the length of that<tr><td><a name="l684" href="#l684">684</a><td>  // will be 1<tr><td><a name="l685" href="#l685">685</a><td>  return goog.array.ARRAY_PROTOTYPE_.splice.call(arr, i, 1).length == 1;<tr><td><a name="l686" href="#l686">686</a><td>};<tr><td><a name="l687" href="#l687">687</a><td><tr><td><a name="l688" href="#l688">688</a><td><tr><td><a name="l689" href="#l689">689</a><td>/**<tr><td><a name="l690" href="#l690">690</a><td> * Removes the first value that satisfies the given condition.<tr><td><a name="l691" href="#l691">691</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a name="l692" href="#l692">692</a><td> *     like object over which to iterate.<tr><td><a name="l693" href="#l693">693</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a name="l694" href="#l694">694</a><td> *     for every element. This function<tr><td><a name="l695" href="#l695">695</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a name="l696" href="#l696">696</a><td> *     return a boolean.<tr><td><a name="l697" href="#l697">697</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a name="l698" href="#l698">698</a><td> * @return {boolean} True if an element was removed.<tr><td><a name="l699" href="#l699">699</a><td> * @template T,S<tr><td><a name="l700" href="#l700">700</a><td> */<tr><td><a name="l701" href="#l701">701</a><td>goog.array.removeIf = function(arr, f, opt_obj) {<tr><td><a name="l702" href="#l702">702</a><td>  var i = goog.array.findIndex(arr, f, opt_obj);<tr><td><a name="l703" href="#l703">703</a><td>  if (i &gt;= 0) {<tr><td><a name="l704" href="#l704">704</a><td>    goog.array.removeAt(arr, i);<tr><td><a name="l705" href="#l705">705</a><td>    return true;<tr><td><a name="l706" href="#l706">706</a><td>  }<tr><td><a name="l707" href="#l707">707</a><td>  return false;<tr><td><a name="l708" href="#l708">708</a><td>};<tr><td><a name="l709" href="#l709">709</a><td><tr><td><a name="l710" href="#l710">710</a><td><tr><td><a name="l711" href="#l711">711</a><td>/**<tr><td><a name="l712" href="#l712">712</a><td> * Returns a new array that is the result of joining the arguments.  If arrays<tr><td><a name="l713" href="#l713">713</a><td> * are passed then their items are added, however, if non-arrays are passed they<tr><td><a name="l714" href="#l714">714</a><td> * will be added to the return array as is.<tr><td><a name="l715" href="#l715">715</a><td> *<tr><td><a name="l716" href="#l716">716</a><td> * Note that ArrayLike objects will be added as is, rather than having their<tr><td><a name="l717" href="#l717">717</a><td> * items added.<tr><td><a name="l718" href="#l718">718</a><td> *<tr><td><a name="l719" href="#l719">719</a><td> * goog.array.concat([1, 2], [3, 4]) -&gt; [1, 2, 3, 4]<tr><td><a name="l720" href="#l720">720</a><td> * goog.array.concat(0, [1, 2]) -&gt; [0, 1, 2]<tr><td><a name="l721" href="#l721">721</a><td> * goog.array.concat([1, 2], null) -&gt; [1, 2, null]<tr><td><a name="l722" href="#l722">722</a><td> *<tr><td><a name="l723" href="#l723">723</a><td> * There is bug in all current versions of IE (6, 7 and 8) where arrays created<tr><td><a name="l724" href="#l724">724</a><td> * in an iframe become corrupted soon (not immediately) after the iframe is<tr><td><a name="l725" href="#l725">725</a><td> * destroyed. This is common if loading data via goog.net.IframeIo, for example.<tr><td><a name="l726" href="#l726">726</a><td> * This corruption only affects the concat method which will start throwing<tr><td><a name="l727" href="#l727">727</a><td> * Catastrophic Errors (#-2147418113).<tr><td><a name="l728" href="#l728">728</a><td> *<tr><td><a name="l729" href="#l729">729</a><td> * See http://endoflow.com/scratch/corrupted-arrays.html for a test case.<tr><td><a name="l730" href="#l730">730</a><td> *<tr><td><a name="l731" href="#l731">731</a><td> * Internally goog.array should use this, so that all methods will continue to<tr><td><a name="l732" href="#l732">732</a><td> * work on these broken array objects.<tr><td><a name="l733" href="#l733">733</a><td> *<tr><td><a name="l734" href="#l734">734</a><td> * @param {...*} var_args Items to concatenate.  Arrays will have each item<tr><td><a name="l735" href="#l735">735</a><td> *     added, while primitives and objects will be added as is.<tr><td><a name="l736" href="#l736">736</a><td> * @return {!Array} The new resultant array.<tr><td><a name="l737" href="#l737">737</a><td> */<tr><td><a name="l738" href="#l738">738</a><td>goog.array.concat = function(var_args) {<tr><td><a name="l739" href="#l739">739</a><td>  return goog.array.ARRAY_PROTOTYPE_.concat.apply(<tr><td><a name="l740" href="#l740">740</a><td>      goog.array.ARRAY_PROTOTYPE_, arguments);<tr><td><a name="l741" href="#l741">741</a><td>};<tr><td><a name="l742" href="#l742">742</a><td><tr><td><a name="l743" href="#l743">743</a><td><tr><td><a name="l744" href="#l744">744</a><td>/**<tr><td><a name="l745" href="#l745">745</a><td> * Converts an object to an array.<tr><td><a name="l746" href="#l746">746</a><td> * @param {goog.array.ArrayLike} object  The object to convert to an array.<tr><td><a name="l747" href="#l747">747</a><td> * @return {!Array} The object converted into an array. If object has a<tr><td><a name="l748" href="#l748">748</a><td> *     length property, every property indexed with a non-negative number<tr><td><a name="l749" href="#l749">749</a><td> *     less than length will be included in the result. If object does not<tr><td><a name="l750" href="#l750">750</a><td> *     have a length property, an empty array will be returned.<tr><td><a name="l751" href="#l751">751</a><td> */<tr><td><a name="l752" href="#l752">752</a><td>goog.array.toArray = function(object) {<tr><td><a name="l753" href="#l753">753</a><td>  var length = object.length;<tr><td><a name="l754" href="#l754">754</a><td><tr><td><a name="l755" href="#l755">755</a><td>  // If length is not a number the following it false. This case is kept for<tr><td><a name="l756" href="#l756">756</a><td>  // backwards compatibility since there are callers that pass objects that are<tr><td><a name="l757" href="#l757">757</a><td>  // not array like.<tr><td><a name="l758" href="#l758">758</a><td>  if (length &gt; 0) {<tr><td><a name="l759" href="#l759">759</a><td>    var rv = new Array(length);<tr><td><a name="l760" href="#l760">760</a><td>    for (var i = 0; i &lt; length; i++) {<tr><td><a name="l761" href="#l761">761</a><td>      rv[i] = object[i];<tr><td><a name="l762" href="#l762">762</a><td>    }<tr><td><a name="l763" href="#l763">763</a><td>    return rv;<tr><td><a name="l764" href="#l764">764</a><td>  }<tr><td><a name="l765" href="#l765">765</a><td>  return [];<tr><td><a name="l766" href="#l766">766</a><td>};<tr><td><a name="l767" href="#l767">767</a><td><tr><td><a name="l768" href="#l768">768</a><td><tr><td><a name="l769" href="#l769">769</a><td>/**<tr><td><a name="l770" href="#l770">770</a><td> * Does a shallow copy of an array.<tr><td><a name="l771" href="#l771">771</a><td> * @param {goog.array.ArrayLike} arr  Array or array-like object to clone.<tr><td><a name="l772" href="#l772">772</a><td> * @return {!Array} Clone of the input array.<tr><td><a name="l773" href="#l773">773</a><td> */<tr><td><a name="l774" href="#l774">774</a><td>goog.array.clone = goog.array.toArray;<tr><td><a name="l775" href="#l775">775</a><td><tr><td><a name="l776" href="#l776">776</a><td><tr><td><a name="l777" href="#l777">777</a><td>/**<tr><td><a name="l778" href="#l778">778</a><td> * Extends an array with another array, element, or &quot;array like&quot; object.<tr><td><a name="l779" href="#l779">779</a><td> * This function operates &#39;in-place&#39;, it does not create a new Array.<tr><td><a name="l780" href="#l780">780</a><td> *<tr><td><a name="l781" href="#l781">781</a><td> * Example:<tr><td><a name="l782" href="#l782">782</a><td> * var a = [];<tr><td><a name="l783" href="#l783">783</a><td> * goog.array.extend(a, [0, 1]);<tr><td><a name="l784" href="#l784">784</a><td> * a; // [0, 1]<tr><td><a name="l785" href="#l785">785</a><td> * goog.array.extend(a, 2);<tr><td><a name="l786" href="#l786">786</a><td> * a; // [0, 1, 2]<tr><td><a name="l787" href="#l787">787</a><td> *<tr><td><a name="l788" href="#l788">788</a><td> * @param {Array} arr1  The array to modify.<tr><td><a name="l789" href="#l789">789</a><td> * @param {...*} var_args The elements or arrays of elements to add to arr1.<tr><td><a name="l790" href="#l790">790</a><td> */<tr><td><a name="l791" href="#l791">791</a><td>goog.array.extend = function(arr1, var_args) {<tr><td><a name="l792" href="#l792">792</a><td>  for (var i = 1; i &lt; arguments.length; i++) {<tr><td><a name="l793" href="#l793">793</a><td>    var arr2 = arguments[i];<tr><td><a name="l794" href="#l794">794</a><td>    // If we have an Array or an Arguments object we can just call push<tr><td><a name="l795" href="#l795">795</a><td>    // directly.<tr><td><a name="l796" href="#l796">796</a><td>    var isArrayLike;<tr><td><a name="l797" href="#l797">797</a><td>    if (goog.isArray(arr2) ||<tr><td><a name="l798" href="#l798">798</a><td>        // Detect Arguments. ES5 says that the [[Class]] of an Arguments object<tr><td><a name="l799" href="#l799">799</a><td>        // is &quot;Arguments&quot; but only V8 and JSC/Safari gets this right. We instead<tr><td><a name="l800" href="#l800">800</a><td>        // detect Arguments by checking for array like and presence of &quot;callee&quot;.<tr><td><a name="l801" href="#l801">801</a><td>        (isArrayLike = goog.isArrayLike(arr2)) &amp;&amp;<tr><td><a name="l802" href="#l802">802</a><td>            // The getter for callee throws an exception in strict mode<tr><td><a name="l803" href="#l803">803</a><td>            // according to section 10.6 in ES5 so check for presence instead.<tr><td><a name="l804" href="#l804">804</a><td>            Object.prototype.hasOwnProperty.call(arr2, &#39;callee&#39;)) {<tr><td><a name="l805" href="#l805">805</a><td>      arr1.push.apply(arr1, arr2);<tr><td><a name="l806" href="#l806">806</a><td>    } else if (isArrayLike) {<tr><td><a name="l807" href="#l807">807</a><td>      // Otherwise loop over arr2 to prevent copying the object.<tr><td><a name="l808" href="#l808">808</a><td>      var len1 = arr1.length;<tr><td><a name="l809" href="#l809">809</a><td>      var len2 = arr2.length;<tr><td><a name="l810" href="#l810">810</a><td>      for (var j = 0; j &lt; len2; j++) {<tr><td><a name="l811" href="#l811">811</a><td>        arr1[len1 + j] = arr2[j];<tr><td><a name="l812" href="#l812">812</a><td>      }<tr><td><a name="l813" href="#l813">813</a><td>    } else {<tr><td><a name="l814" href="#l814">814</a><td>      arr1.push(arr2);<tr><td><a name="l815" href="#l815">815</a><td>    }<tr><td><a name="l816" href="#l816">816</a><td>  }<tr><td><a name="l817" href="#l817">817</a><td>};<tr><td><a name="l818" href="#l818">818</a><td><tr><td><a name="l819" href="#l819">819</a><td><tr><td><a name="l820" href="#l820">820</a><td>/**<tr><td><a name="l821" href="#l821">821</a><td> * Adds or removes elements from an array. This is a generic version of Array<tr><td><a name="l822" href="#l822">822</a><td> * splice. This means that it might work on other objects similar to arrays,<tr><td><a name="l823" href="#l823">823</a><td> * such as the arguments object.<tr><td><a name="l824" href="#l824">824</a><td> *<tr><td><a name="l825" href="#l825">825</a><td> * @param {goog.array.ArrayLike} arr The array to modify.<tr><td><a name="l826" href="#l826">826</a><td> * @param {number|undefined} index The index at which to start changing the<tr><td><a name="l827" href="#l827">827</a><td> *     array. If not defined, treated as 0.<tr><td><a name="l828" href="#l828">828</a><td> * @param {number} howMany How many elements to remove (0 means no removal. A<tr><td><a name="l829" href="#l829">829</a><td> *     value below 0 is treated as zero and so is any other non number. Numbers<tr><td><a name="l830" href="#l830">830</a><td> *     are floored).<tr><td><a name="l831" href="#l831">831</a><td> * @param {...*} var_args Optional, additional elements to insert into the<tr><td><a name="l832" href="#l832">832</a><td> *     array.<tr><td><a name="l833" href="#l833">833</a><td> * @return {!Array} the removed elements.<tr><td><a name="l834" href="#l834">834</a><td> */<tr><td><a name="l835" href="#l835">835</a><td>goog.array.splice = function(arr, index, howMany, var_args) {<tr><td><a name="l836" href="#l836">836</a><td>  goog.asserts.assert(arr.length != null);<tr><td><a name="l837" href="#l837">837</a><td><tr><td><a name="l838" href="#l838">838</a><td>  return goog.array.ARRAY_PROTOTYPE_.splice.apply(<tr><td><a name="l839" href="#l839">839</a><td>      arr, goog.array.slice(arguments, 1));<tr><td><a name="l840" href="#l840">840</a><td>};<tr><td><a name="l841" href="#l841">841</a><td><tr><td><a name="l842" href="#l842">842</a><td><tr><td><a name="l843" href="#l843">843</a><td>/**<tr><td><a name="l844" href="#l844">844</a><td> * Returns a new array from a segment of an array. This is a generic version of<tr><td><a name="l845" href="#l845">845</a><td> * Array slice. This means that it might work on other objects similar to<tr><td><a name="l846" href="#l846">846</a><td> * arrays, such as the arguments object.<tr><td><a name="l847" href="#l847">847</a><td> *<tr><td><a name="l848" href="#l848">848</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr The array from<tr><td><a name="l849" href="#l849">849</a><td> * which to copy a segment.<tr><td><a name="l850" href="#l850">850</a><td> * @param {number} start The index of the first element to copy.<tr><td><a name="l851" href="#l851">851</a><td> * @param {number=} opt_end The index after the last element to copy.<tr><td><a name="l852" href="#l852">852</a><td> * @return {!Array.&lt;T&gt;} A new array containing the specified segment of the<tr><td><a name="l853" href="#l853">853</a><td> *     original array.<tr><td><a name="l854" href="#l854">854</a><td> * @template T<tr><td><a name="l855" href="#l855">855</a><td> */<tr><td><a name="l856" href="#l856">856</a><td>goog.array.slice = function(arr, start, opt_end) {<tr><td><a name="l857" href="#l857">857</a><td>  goog.asserts.assert(arr.length != null);<tr><td><a name="l858" href="#l858">858</a><td><tr><td><a name="l859" href="#l859">859</a><td>  // passing 1 arg to slice is not the same as passing 2 where the second is<tr><td><a name="l860" href="#l860">860</a><td>  // null or undefined (in that case the second argument is treated as 0).<tr><td><a name="l861" href="#l861">861</a><td>  // we could use slice on the arguments object and then use apply instead of<tr><td><a name="l862" href="#l862">862</a><td>  // testing the length<tr><td><a name="l863" href="#l863">863</a><td>  if (arguments.length &lt;= 2) {<tr><td><a name="l864" href="#l864">864</a><td>    return goog.array.ARRAY_PROTOTYPE_.slice.call(arr, start);<tr><td><a name="l865" href="#l865">865</a><td>  } else {<tr><td><a name="l866" href="#l866">866</a><td>    return goog.array.ARRAY_PROTOTYPE_.slice.call(arr, start, opt_end);<tr><td><a name="l867" href="#l867">867</a><td>  }<tr><td><a name="l868" href="#l868">868</a><td>};<tr><td><a name="l869" href="#l869">869</a><td><tr><td><a name="l870" href="#l870">870</a><td><tr><td><a name="l871" href="#l871">871</a><td>/**<tr><td><a name="l872" href="#l872">872</a><td> * Removes all duplicates from an array (retaining only the first<tr><td><a name="l873" href="#l873">873</a><td> * occurrence of each array element).  This function modifies the<tr><td><a name="l874" href="#l874">874</a><td> * array in place and doesn&#39;t change the order of the non-duplicate items.<tr><td><a name="l875" href="#l875">875</a><td> *<tr><td><a name="l876" href="#l876">876</a><td> * For objects, duplicates are identified as having the same unique ID as<tr><td><a name="l877" href="#l877">877</a><td> * defined by {@link goog.getUid}.<tr><td><a name="l878" href="#l878">878</a><td> *<tr><td><a name="l879" href="#l879">879</a><td> * Runtime: N,<tr><td><a name="l880" href="#l880">880</a><td> * Worstcase space: 2N (no dupes)<tr><td><a name="l881" href="#l881">881</a><td> *<tr><td><a name="l882" href="#l882">882</a><td> * @param {goog.array.ArrayLike} arr The array from which to remove duplicates.<tr><td><a name="l883" href="#l883">883</a><td> * @param {Array=} opt_rv An optional array in which to return the results,<tr><td><a name="l884" href="#l884">884</a><td> *     instead of performing the removal inplace.  If specified, the original<tr><td><a name="l885" href="#l885">885</a><td> *     array will remain unchanged.<tr><td><a name="l886" href="#l886">886</a><td> */<tr><td><a name="l887" href="#l887">887</a><td>goog.array.removeDuplicates = function(arr, opt_rv) {<tr><td><a name="l888" href="#l888">888</a><td>  var returnArray = opt_rv || arr;<tr><td><a name="l889" href="#l889">889</a><td><tr><td><a name="l890" href="#l890">890</a><td>  var seen = {}, cursorInsert = 0, cursorRead = 0;<tr><td><a name="l891" href="#l891">891</a><td>  while (cursorRead &lt; arr.length) {<tr><td><a name="l892" href="#l892">892</a><td>    var current = arr[cursorRead++];<tr><td><a name="l893" href="#l893">893</a><td><tr><td><a name="l894" href="#l894">894</a><td>    // Prefix each type with a single character representing the type to<tr><td><a name="l895" href="#l895">895</a><td>    // prevent conflicting keys (e.g. true and &#39;true&#39;).<tr><td><a name="l896" href="#l896">896</a><td>    var key = goog.isObject(current) ?<tr><td><a name="l897" href="#l897">897</a><td>        &#39;o&#39; + goog.getUid(current) :<tr><td><a name="l898" href="#l898">898</a><td>        (typeof current).charAt(0) + current;<tr><td><a name="l899" href="#l899">899</a><td><tr><td><a name="l900" href="#l900">900</a><td>    if (!Object.prototype.hasOwnProperty.call(seen, key)) {<tr><td><a name="l901" href="#l901">901</a><td>      seen[key] = true;<tr><td><a name="l902" href="#l902">902</a><td>      returnArray[cursorInsert++] = current;<tr><td><a name="l903" href="#l903">903</a><td>    }<tr><td><a name="l904" href="#l904">904</a><td>  }<tr><td><a name="l905" href="#l905">905</a><td>  returnArray.length = cursorInsert;<tr><td><a name="l906" href="#l906">906</a><td>};<tr><td><a name="l907" href="#l907">907</a><td><tr><td><a name="l908" href="#l908">908</a><td><tr><td><a name="l909" href="#l909">909</a><td>/**<tr><td><a name="l910" href="#l910">910</a><td> * Searches the specified array for the specified target using the binary<tr><td><a name="l911" href="#l911">911</a><td> * search algorithm.  If no opt_compareFn is specified, elements are compared<tr><td><a name="l912" href="#l912">912</a><td> * using &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;, which compares the elements<tr><td><a name="l913" href="#l913">913</a><td> * using the built in &lt; and &gt; operators.  This will produce the expected<tr><td><a name="l914" href="#l914">914</a><td> * behavior for homogeneous arrays of String(s) and Number(s). The array<tr><td><a name="l915" href="#l915">915</a><td> * specified &lt;b&gt;must&lt;/b&gt; be sorted in ascending order (as defined by the<tr><td><a name="l916" href="#l916">916</a><td> * comparison function).  If the array is not sorted, results are undefined.<tr><td><a name="l917" href="#l917">917</a><td> * If the array contains multiple instances of the specified target value, any<tr><td><a name="l918" href="#l918">918</a><td> * of these instances may be found.<tr><td><a name="l919" href="#l919">919</a><td> *<tr><td><a name="l920" href="#l920">920</a><td> * Runtime: O(log n)<tr><td><a name="l921" href="#l921">921</a><td> *<tr><td><a name="l922" href="#l922">922</a><td> * @param {goog.array.ArrayLike} arr The array to be searched.<tr><td><a name="l923" href="#l923">923</a><td> * @param {*} target The sought value.<tr><td><a name="l924" href="#l924">924</a><td> * @param {Function=} opt_compareFn Optional comparison function by which the<tr><td><a name="l925" href="#l925">925</a><td> *     array is ordered. Should take 2 arguments to compare, and return a<tr><td><a name="l926" href="#l926">926</a><td> *     negative number, zero, or a positive number depending on whether the<tr><td><a name="l927" href="#l927">927</a><td> *     first argument is less than, equal to, or greater than the second.<tr><td><a name="l928" href="#l928">928</a><td> * @return {number} Lowest index of the target value if found, otherwise<tr><td><a name="l929" href="#l929">929</a><td> *     (-(insertion point) - 1). The insertion point is where the value should<tr><td><a name="l930" href="#l930">930</a><td> *     be inserted into arr to preserve the sorted property.  Return value &gt;= 0<tr><td><a name="l931" href="#l931">931</a><td> *     iff target is found.<tr><td><a name="l932" href="#l932">932</a><td> */<tr><td><a name="l933" href="#l933">933</a><td>goog.array.binarySearch = function(arr, target, opt_compareFn) {<tr><td><a name="l934" href="#l934">934</a><td>  return goog.array.binarySearch_(arr,<tr><td><a name="l935" href="#l935">935</a><td>      opt_compareFn || goog.array.defaultCompare, false /* isEvaluator */,<tr><td><a name="l936" href="#l936">936</a><td>      target);<tr><td><a name="l937" href="#l937">937</a><td>};<tr><td><a name="l938" href="#l938">938</a><td><tr><td><a name="l939" href="#l939">939</a><td><tr><td><a name="l940" href="#l940">940</a><td>/**<tr><td><a name="l941" href="#l941">941</a><td> * Selects an index in the specified array using the binary search algorithm.<tr><td><a name="l942" href="#l942">942</a><td> * The evaluator receives an element and determines whether the desired index<tr><td><a name="l943" href="#l943">943</a><td> * is before, at, or after it.  The evaluator must be consistent (formally,<tr><td><a name="l944" href="#l944">944</a><td> * goog.array.map(goog.array.map(arr, evaluator, opt_obj), goog.math.sign)<tr><td><a name="l945" href="#l945">945</a><td> * must be monotonically non-increasing).<tr><td><a name="l946" href="#l946">946</a><td> *<tr><td><a name="l947" href="#l947">947</a><td> * Runtime: O(log n)<tr><td><a name="l948" href="#l948">948</a><td> *<tr><td><a name="l949" href="#l949">949</a><td> * @param {goog.array.ArrayLike} arr The array to be searched.<tr><td><a name="l950" href="#l950">950</a><td> * @param {Function} evaluator Evaluator function that receives 3 arguments<tr><td><a name="l951" href="#l951">951</a><td> *     (the element, the index and the array). Should return a negative number,<tr><td><a name="l952" href="#l952">952</a><td> *     zero, or a positive number depending on whether the desired index is<tr><td><a name="l953" href="#l953">953</a><td> *     before, at, or after the element passed to it.<tr><td><a name="l954" href="#l954">954</a><td> * @param {Object=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l955" href="#l955">955</a><td> *     within evaluator.<tr><td><a name="l956" href="#l956">956</a><td> * @return {number} Index of the leftmost element matched by the evaluator, if<tr><td><a name="l957" href="#l957">957</a><td> *     such exists; otherwise (-(insertion point) - 1). The insertion point is<tr><td><a name="l958" href="#l958">958</a><td> *     the index of the first element for which the evaluator returns negative,<tr><td><a name="l959" href="#l959">959</a><td> *     or arr.length if no such element exists. The return value is non-negative<tr><td><a name="l960" href="#l960">960</a><td> *     iff a match is found.<tr><td><a name="l961" href="#l961">961</a><td> */<tr><td><a name="l962" href="#l962">962</a><td>goog.array.binarySelect = function(arr, evaluator, opt_obj) {<tr><td><a name="l963" href="#l963">963</a><td>  return goog.array.binarySearch_(arr, evaluator, true /* isEvaluator */,<tr><td><a name="l964" href="#l964">964</a><td>      undefined /* opt_target */, opt_obj);<tr><td><a name="l965" href="#l965">965</a><td>};<tr><td><a name="l966" href="#l966">966</a><td><tr><td><a name="l967" href="#l967">967</a><td><tr><td><a name="l968" href="#l968">968</a><td>/**<tr><td><a name="l969" href="#l969">969</a><td> * Implementation of a binary search algorithm which knows how to use both<tr><td><a name="l970" href="#l970">970</a><td> * comparison functions and evaluators. If an evaluator is provided, will call<tr><td><a name="l971" href="#l971">971</a><td> * the evaluator with the given optional data object, conforming to the<tr><td><a name="l972" href="#l972">972</a><td> * interface defined in binarySelect. Otherwise, if a comparison function is<tr><td><a name="l973" href="#l973">973</a><td> * provided, will call the comparison function against the given data object.<tr><td><a name="l974" href="#l974">974</a><td> *<tr><td><a name="l975" href="#l975">975</a><td> * This implementation purposefully does not use goog.bind or goog.partial for<tr><td><a name="l976" href="#l976">976</a><td> * performance reasons.<tr><td><a name="l977" href="#l977">977</a><td> *<tr><td><a name="l978" href="#l978">978</a><td> * Runtime: O(log n)<tr><td><a name="l979" href="#l979">979</a><td> *<tr><td><a name="l980" href="#l980">980</a><td> * @param {goog.array.ArrayLike} arr The array to be searched.<tr><td><a name="l981" href="#l981">981</a><td> * @param {Function} compareFn Either an evaluator or a comparison function,<tr><td><a name="l982" href="#l982">982</a><td> *     as defined by binarySearch and binarySelect above.<tr><td><a name="l983" href="#l983">983</a><td> * @param {boolean} isEvaluator Whether the function is an evaluator or a<tr><td><a name="l984" href="#l984">984</a><td> *     comparison function.<tr><td><a name="l985" href="#l985">985</a><td> * @param {*=} opt_target If the function is a comparison function, then this is<tr><td><a name="l986" href="#l986">986</a><td> *     the target to binary search for.<tr><td><a name="l987" href="#l987">987</a><td> * @param {Object=} opt_selfObj If the function is an evaluator, this is an<tr><td><a name="l988" href="#l988">988</a><td>  *    optional this object for the evaluator.<tr><td><a name="l989" href="#l989">989</a><td> * @return {number} Lowest index of the target value if found, otherwise<tr><td><a name="l990" href="#l990">990</a><td> *     (-(insertion point) - 1). The insertion point is where the value should<tr><td><a name="l991" href="#l991">991</a><td> *     be inserted into arr to preserve the sorted property.  Return value &gt;= 0<tr><td><a name="l992" href="#l992">992</a><td> *     iff target is found.<tr><td><a name="l993" href="#l993">993</a><td> * @private<tr><td><a name="l994" href="#l994">994</a><td> */<tr><td><a name="l995" href="#l995">995</a><td>goog.array.binarySearch_ = function(arr, compareFn, isEvaluator, opt_target,<tr><td><a name="l996" href="#l996">996</a><td>    opt_selfObj) {<tr><td><a name="l997" href="#l997">997</a><td>  var left = 0;  // inclusive<tr><td><a name="l998" href="#l998">998</a><td>  var right = arr.length;  // exclusive<tr><td><a name="l999" href="#l999">999</a><td>  var found;<tr><td><a name="l1000" href="#l1000">1000</a><td>  while (left &lt; right) {<tr><td><a name="l1001" href="#l1001">1001</a><td>    var middle = (left + right) &gt;&gt; 1;<tr><td><a name="l1002" href="#l1002">1002</a><td>    var compareResult;<tr><td><a name="l1003" href="#l1003">1003</a><td>    if (isEvaluator) {<tr><td><a name="l1004" href="#l1004">1004</a><td>      compareResult = compareFn.call(opt_selfObj, arr[middle], middle, arr);<tr><td><a name="l1005" href="#l1005">1005</a><td>    } else {<tr><td><a name="l1006" href="#l1006">1006</a><td>      compareResult = compareFn(opt_target, arr[middle]);<tr><td><a name="l1007" href="#l1007">1007</a><td>    }<tr><td><a name="l1008" href="#l1008">1008</a><td>    if (compareResult &gt; 0) {<tr><td><a name="l1009" href="#l1009">1009</a><td>      left = middle + 1;<tr><td><a name="l1010" href="#l1010">1010</a><td>    } else {<tr><td><a name="l1011" href="#l1011">1011</a><td>      right = middle;<tr><td><a name="l1012" href="#l1012">1012</a><td>      // We are looking for the lowest index so we can&#39;t return immediately.<tr><td><a name="l1013" href="#l1013">1013</a><td>      found = !compareResult;<tr><td><a name="l1014" href="#l1014">1014</a><td>    }<tr><td><a name="l1015" href="#l1015">1015</a><td>  }<tr><td><a name="l1016" href="#l1016">1016</a><td>  // left is the index if found, or the insertion point otherwise.<tr><td><a name="l1017" href="#l1017">1017</a><td>  // ~left is a shorthand for -left - 1.<tr><td><a name="l1018" href="#l1018">1018</a><td>  return found ? left : ~left;<tr><td><a name="l1019" href="#l1019">1019</a><td>};<tr><td><a name="l1020" href="#l1020">1020</a><td><tr><td><a name="l1021" href="#l1021">1021</a><td><tr><td><a name="l1022" href="#l1022">1022</a><td>/**<tr><td><a name="l1023" href="#l1023">1023</a><td> * Sorts the specified array into ascending order.  If no opt_compareFn is<tr><td><a name="l1024" href="#l1024">1024</a><td> * specified, elements are compared using<tr><td><a name="l1025" href="#l1025">1025</a><td> * &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;, which compares the elements using<tr><td><a name="l1026" href="#l1026">1026</a><td> * the built in &lt; and &gt; operators.  This will produce the expected behavior<tr><td><a name="l1027" href="#l1027">1027</a><td> * for homogeneous arrays of String(s) and Number(s), unlike the native sort,<tr><td><a name="l1028" href="#l1028">1028</a><td> * but will give unpredictable results for heterogenous lists of strings and<tr><td><a name="l1029" href="#l1029">1029</a><td> * numbers with different numbers of digits.<tr><td><a name="l1030" href="#l1030">1030</a><td> *<tr><td><a name="l1031" href="#l1031">1031</a><td> * This sort is not guaranteed to be stable.<tr><td><a name="l1032" href="#l1032">1032</a><td> *<tr><td><a name="l1033" href="#l1033">1033</a><td> * Runtime: Same as &lt;code&gt;Array.prototype.sort&lt;/code&gt;<tr><td><a name="l1034" href="#l1034">1034</a><td> *<tr><td><a name="l1035" href="#l1035">1035</a><td> * @param {Array.&lt;T&gt;} arr The array to be sorted.<tr><td><a name="l1036" href="#l1036">1036</a><td> * @param {?function(T,T):number=} opt_compareFn Optional comparison<tr><td><a name="l1037" href="#l1037">1037</a><td> *     function by which the<tr><td><a name="l1038" href="#l1038">1038</a><td> *     array is to be ordered. Should take 2 arguments to compare, and return a<tr><td><a name="l1039" href="#l1039">1039</a><td> *     negative number, zero, or a positive number depending on whether the<tr><td><a name="l1040" href="#l1040">1040</a><td> *     first argument is less than, equal to, or greater than the second.<tr><td><a name="l1041" href="#l1041">1041</a><td> * @template T<tr><td><a name="l1042" href="#l1042">1042</a><td> */<tr><td><a name="l1043" href="#l1043">1043</a><td>goog.array.sort = function(arr, opt_compareFn) {<tr><td><a name="l1044" href="#l1044">1044</a><td>  // TODO(arv): Update type annotation since null is not accepted.<tr><td><a name="l1045" href="#l1045">1045</a><td>  goog.asserts.assert(arr.length != null);<tr><td><a name="l1046" href="#l1046">1046</a><td><tr><td><a name="l1047" href="#l1047">1047</a><td>  goog.array.ARRAY_PROTOTYPE_.sort.call(<tr><td><a name="l1048" href="#l1048">1048</a><td>      arr, opt_compareFn || goog.array.defaultCompare);<tr><td><a name="l1049" href="#l1049">1049</a><td>};<tr><td><a name="l1050" href="#l1050">1050</a><td><tr><td><a name="l1051" href="#l1051">1051</a><td><tr><td><a name="l1052" href="#l1052">1052</a><td>/**<tr><td><a name="l1053" href="#l1053">1053</a><td> * Sorts the specified array into ascending order in a stable way.  If no<tr><td><a name="l1054" href="#l1054">1054</a><td> * opt_compareFn is specified, elements are compared using<tr><td><a name="l1055" href="#l1055">1055</a><td> * &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;, which compares the elements using<tr><td><a name="l1056" href="#l1056">1056</a><td> * the built in &lt; and &gt; operators.  This will produce the expected behavior<tr><td><a name="l1057" href="#l1057">1057</a><td> * for homogeneous arrays of String(s) and Number(s).<tr><td><a name="l1058" href="#l1058">1058</a><td> *<tr><td><a name="l1059" href="#l1059">1059</a><td> * Runtime: Same as &lt;code&gt;Array.prototype.sort&lt;/code&gt;, plus an additional<tr><td><a name="l1060" href="#l1060">1060</a><td> * O(n) overhead of copying the array twice.<tr><td><a name="l1061" href="#l1061">1061</a><td> *<tr><td><a name="l1062" href="#l1062">1062</a><td> * @param {Array.&lt;T&gt;} arr The array to be sorted.<tr><td><a name="l1063" href="#l1063">1063</a><td> * @param {?function(T, T): number=} opt_compareFn Optional comparison function<tr><td><a name="l1064" href="#l1064">1064</a><td> *     by which the array is to be ordered. Should take 2 arguments to compare,<tr><td><a name="l1065" href="#l1065">1065</a><td> *     and return a negative number, zero, or a positive number depending on<tr><td><a name="l1066" href="#l1066">1066</a><td> *     whether the first argument is less than, equal to, or greater than the<tr><td><a name="l1067" href="#l1067">1067</a><td> *     second.<tr><td><a name="l1068" href="#l1068">1068</a><td> * @template T<tr><td><a name="l1069" href="#l1069">1069</a><td> */<tr><td><a name="l1070" href="#l1070">1070</a><td>goog.array.stableSort = function(arr, opt_compareFn) {<tr><td><a name="l1071" href="#l1071">1071</a><td>  for (var i = 0; i &lt; arr.length; i++) {<tr><td><a name="l1072" href="#l1072">1072</a><td>    arr[i] = {index: i, value: arr[i]};<tr><td><a name="l1073" href="#l1073">1073</a><td>  }<tr><td><a name="l1074" href="#l1074">1074</a><td>  var valueCompareFn = opt_compareFn || goog.array.defaultCompare;<tr><td><a name="l1075" href="#l1075">1075</a><td>  function stableCompareFn(obj1, obj2) {<tr><td><a name="l1076" href="#l1076">1076</a><td>    return valueCompareFn(obj1.value, obj2.value) || obj1.index - obj2.index;<tr><td><a name="l1077" href="#l1077">1077</a><td>  };<tr><td><a name="l1078" href="#l1078">1078</a><td>  goog.array.sort(arr, stableCompareFn);<tr><td><a name="l1079" href="#l1079">1079</a><td>  for (var i = 0; i &lt; arr.length; i++) {<tr><td><a name="l1080" href="#l1080">1080</a><td>    arr[i] = arr[i].value;<tr><td><a name="l1081" href="#l1081">1081</a><td>  }<tr><td><a name="l1082" href="#l1082">1082</a><td>};<tr><td><a name="l1083" href="#l1083">1083</a><td><tr><td><a name="l1084" href="#l1084">1084</a><td><tr><td><a name="l1085" href="#l1085">1085</a><td>/**<tr><td><a name="l1086" href="#l1086">1086</a><td> * Sorts an array of objects by the specified object key and compare<tr><td><a name="l1087" href="#l1087">1087</a><td> * function. If no compare function is provided, the key values are<tr><td><a name="l1088" href="#l1088">1088</a><td> * compared in ascending order using &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;.<tr><td><a name="l1089" href="#l1089">1089</a><td> * This won&#39;t work for keys that get renamed by the compiler. So use<tr><td><a name="l1090" href="#l1090">1090</a><td> * {&#39;foo&#39;: 1, &#39;bar&#39;: 2} rather than {foo: 1, bar: 2}.<tr><td><a name="l1091" href="#l1091">1091</a><td> * @param {Array.&lt;Object&gt;} arr An array of objects to sort.<tr><td><a name="l1092" href="#l1092">1092</a><td> * @param {string} key The object key to sort by.<tr><td><a name="l1093" href="#l1093">1093</a><td> * @param {Function=} opt_compareFn The function to use to compare key<tr><td><a name="l1094" href="#l1094">1094</a><td> *     values.<tr><td><a name="l1095" href="#l1095">1095</a><td> */<tr><td><a name="l1096" href="#l1096">1096</a><td>goog.array.sortObjectsByKey = function(arr, key, opt_compareFn) {<tr><td><a name="l1097" href="#l1097">1097</a><td>  var compare = opt_compareFn || goog.array.defaultCompare;<tr><td><a name="l1098" href="#l1098">1098</a><td>  goog.array.sort(arr, function(a, b) {<tr><td><a name="l1099" href="#l1099">1099</a><td>    return compare(a[key], b[key]);<tr><td><a name="l1100" href="#l1100">1100</a><td>  });<tr><td><a name="l1101" href="#l1101">1101</a><td>};<tr><td><a name="l1102" href="#l1102">1102</a><td><tr><td><a name="l1103" href="#l1103">1103</a><td><tr><td><a name="l1104" href="#l1104">1104</a><td>/**<tr><td><a name="l1105" href="#l1105">1105</a><td> * Tells if the array is sorted.<tr><td><a name="l1106" href="#l1106">1106</a><td> * @param {!Array.&lt;T&gt;} arr The array.<tr><td><a name="l1107" href="#l1107">1107</a><td> * @param {?function(T,T):number=} opt_compareFn Function to compare the<tr><td><a name="l1108" href="#l1108">1108</a><td> *     array elements.<tr><td><a name="l1109" href="#l1109">1109</a><td> *     Should take 2 arguments to compare, and return a negative number, zero,<tr><td><a name="l1110" href="#l1110">1110</a><td> *     or a positive number depending on whether the first argument is less<tr><td><a name="l1111" href="#l1111">1111</a><td> *     than, equal to, or greater than the second.<tr><td><a name="l1112" href="#l1112">1112</a><td> * @param {boolean=} opt_strict If true no equal elements are allowed.<tr><td><a name="l1113" href="#l1113">1113</a><td> * @return {boolean} Whether the array is sorted.<tr><td><a name="l1114" href="#l1114">1114</a><td> * @template T<tr><td><a name="l1115" href="#l1115">1115</a><td> */<tr><td><a name="l1116" href="#l1116">1116</a><td>goog.array.isSorted = function(arr, opt_compareFn, opt_strict) {<tr><td><a name="l1117" href="#l1117">1117</a><td>  var compare = opt_compareFn || goog.array.defaultCompare;<tr><td><a name="l1118" href="#l1118">1118</a><td>  for (var i = 1; i &lt; arr.length; i++) {<tr><td><a name="l1119" href="#l1119">1119</a><td>    var compareResult = compare(arr[i - 1], arr[i]);<tr><td><a name="l1120" href="#l1120">1120</a><td>    if (compareResult &gt; 0 || compareResult == 0 &amp;&amp; opt_strict) {<tr><td><a name="l1121" href="#l1121">1121</a><td>      return false;<tr><td><a name="l1122" href="#l1122">1122</a><td>    }<tr><td><a name="l1123" href="#l1123">1123</a><td>  }<tr><td><a name="l1124" href="#l1124">1124</a><td>  return true;<tr><td><a name="l1125" href="#l1125">1125</a><td>};<tr><td><a name="l1126" href="#l1126">1126</a><td><tr><td><a name="l1127" href="#l1127">1127</a><td><tr><td><a name="l1128" href="#l1128">1128</a><td>/**<tr><td><a name="l1129" href="#l1129">1129</a><td> * Compares two arrays for equality. Two arrays are considered equal if they<tr><td><a name="l1130" href="#l1130">1130</a><td> * have the same length and their corresponding elements are equal according to<tr><td><a name="l1131" href="#l1131">1131</a><td> * the comparison function.<tr><td><a name="l1132" href="#l1132">1132</a><td> *<tr><td><a name="l1133" href="#l1133">1133</a><td> * @param {goog.array.ArrayLike} arr1 The first array to compare.<tr><td><a name="l1134" href="#l1134">1134</a><td> * @param {goog.array.ArrayLike} arr2 The second array to compare.<tr><td><a name="l1135" href="#l1135">1135</a><td> * @param {Function=} opt_equalsFn Optional comparison function.<tr><td><a name="l1136" href="#l1136">1136</a><td> *     Should take 2 arguments to compare, and return true if the arguments<tr><td><a name="l1137" href="#l1137">1137</a><td> *     are equal. Defaults to {@link goog.array.defaultCompareEquality} which<tr><td><a name="l1138" href="#l1138">1138</a><td> *     compares the elements using the built-in &#39;===&#39; operator.<tr><td><a name="l1139" href="#l1139">1139</a><td> * @return {boolean} Whether the two arrays are equal.<tr><td><a name="l1140" href="#l1140">1140</a><td> */<tr><td><a name="l1141" href="#l1141">1141</a><td>goog.array.equals = function(arr1, arr2, opt_equalsFn) {<tr><td><a name="l1142" href="#l1142">1142</a><td>  if (!goog.isArrayLike(arr1) || !goog.isArrayLike(arr2) ||<tr><td><a name="l1143" href="#l1143">1143</a><td>      arr1.length != arr2.length) {<tr><td><a name="l1144" href="#l1144">1144</a><td>    return false;<tr><td><a name="l1145" href="#l1145">1145</a><td>  }<tr><td><a name="l1146" href="#l1146">1146</a><td>  var l = arr1.length;<tr><td><a name="l1147" href="#l1147">1147</a><td>  var equalsFn = opt_equalsFn || goog.array.defaultCompareEquality;<tr><td><a name="l1148" href="#l1148">1148</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a name="l1149" href="#l1149">1149</a><td>    if (!equalsFn(arr1[i], arr2[i])) {<tr><td><a name="l1150" href="#l1150">1150</a><td>      return false;<tr><td><a name="l1151" href="#l1151">1151</a><td>    }<tr><td><a name="l1152" href="#l1152">1152</a><td>  }<tr><td><a name="l1153" href="#l1153">1153</a><td>  return true;<tr><td><a name="l1154" href="#l1154">1154</a><td>};<tr><td><a name="l1155" href="#l1155">1155</a><td><tr><td><a name="l1156" href="#l1156">1156</a><td><tr><td><a name="l1157" href="#l1157">1157</a><td>/**<tr><td><a name="l1158" href="#l1158">1158</a><td> * @deprecated Use {@link goog.array.equals}.<tr><td><a name="l1159" href="#l1159">1159</a><td> * @param {goog.array.ArrayLike} arr1 See {@link goog.array.equals}.<tr><td><a name="l1160" href="#l1160">1160</a><td> * @param {goog.array.ArrayLike} arr2 See {@link goog.array.equals}.<tr><td><a name="l1161" href="#l1161">1161</a><td> * @param {Function=} opt_equalsFn See {@link goog.array.equals}.<tr><td><a name="l1162" href="#l1162">1162</a><td> * @return {boolean} See {@link goog.array.equals}.<tr><td><a name="l1163" href="#l1163">1163</a><td> */<tr><td><a name="l1164" href="#l1164">1164</a><td>goog.array.compare = function(arr1, arr2, opt_equalsFn) {<tr><td><a name="l1165" href="#l1165">1165</a><td>  return goog.array.equals(arr1, arr2, opt_equalsFn);<tr><td><a name="l1166" href="#l1166">1166</a><td>};<tr><td><a name="l1167" href="#l1167">1167</a><td><tr><td><a name="l1168" href="#l1168">1168</a><td><tr><td><a name="l1169" href="#l1169">1169</a><td>/**<tr><td><a name="l1170" href="#l1170">1170</a><td> * 3-way array compare function.<tr><td><a name="l1171" href="#l1171">1171</a><td> * @param {!goog.array.ArrayLike} arr1 The first array to compare.<tr><td><a name="l1172" href="#l1172">1172</a><td> * @param {!goog.array.ArrayLike} arr2 The second array to compare.<tr><td><a name="l1173" href="#l1173">1173</a><td> * @param {?function(?, ?): number=} opt_compareFn Optional comparison function<tr><td><a name="l1174" href="#l1174">1174</a><td> *     by which the array is to be ordered. Should take 2 arguments to compare,<tr><td><a name="l1175" href="#l1175">1175</a><td> *     and return a negative number, zero, or a positive number depending on<tr><td><a name="l1176" href="#l1176">1176</a><td> *     whether the first argument is less than, equal to, or greater than the<tr><td><a name="l1177" href="#l1177">1177</a><td> *     second.<tr><td><a name="l1178" href="#l1178">1178</a><td> * @return {number} Negative number, zero, or a positive number depending on<tr><td><a name="l1179" href="#l1179">1179</a><td> *     whether the first argument is less than, equal to, or greater than the<tr><td><a name="l1180" href="#l1180">1180</a><td> *     second.<tr><td><a name="l1181" href="#l1181">1181</a><td> */<tr><td><a name="l1182" href="#l1182">1182</a><td>goog.array.compare3 = function(arr1, arr2, opt_compareFn) {<tr><td><a name="l1183" href="#l1183">1183</a><td>  var compare = opt_compareFn || goog.array.defaultCompare;<tr><td><a name="l1184" href="#l1184">1184</a><td>  var l = Math.min(arr1.length, arr2.length);<tr><td><a name="l1185" href="#l1185">1185</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a name="l1186" href="#l1186">1186</a><td>    var result = compare(arr1[i], arr2[i]);<tr><td><a name="l1187" href="#l1187">1187</a><td>    if (result != 0) {<tr><td><a name="l1188" href="#l1188">1188</a><td>      return result;<tr><td><a name="l1189" href="#l1189">1189</a><td>    }<tr><td><a name="l1190" href="#l1190">1190</a><td>  }<tr><td><a name="l1191" href="#l1191">1191</a><td>  return goog.array.defaultCompare(arr1.length, arr2.length);<tr><td><a name="l1192" href="#l1192">1192</a><td>};<tr><td><a name="l1193" href="#l1193">1193</a><td><tr><td><a name="l1194" href="#l1194">1194</a><td><tr><td><a name="l1195" href="#l1195">1195</a><td>/**<tr><td><a name="l1196" href="#l1196">1196</a><td> * Compares its two arguments for order, using the built in &lt; and &gt;<tr><td><a name="l1197" href="#l1197">1197</a><td> * operators.<tr><td><a name="l1198" href="#l1198">1198</a><td> * @param {*} a The first object to be compared.<tr><td><a name="l1199" href="#l1199">1199</a><td> * @param {*} b The second object to be compared.<tr><td><a name="l1200" href="#l1200">1200</a><td> * @return {number} A negative number, zero, or a positive number as the first<tr><td><a name="l1201" href="#l1201">1201</a><td> *     argument is less than, equal to, or greater than the second.<tr><td><a name="l1202" href="#l1202">1202</a><td> */<tr><td><a name="l1203" href="#l1203">1203</a><td>goog.array.defaultCompare = function(a, b) {<tr><td><a name="l1204" href="#l1204">1204</a><td>  return a &gt; b ? 1 : a &lt; b ? -1 : 0;<tr><td><a name="l1205" href="#l1205">1205</a><td>};<tr><td><a name="l1206" href="#l1206">1206</a><td><tr><td><a name="l1207" href="#l1207">1207</a><td><tr><td><a name="l1208" href="#l1208">1208</a><td>/**<tr><td><a name="l1209" href="#l1209">1209</a><td> * Compares its two arguments for equality, using the built in === operator.<tr><td><a name="l1210" href="#l1210">1210</a><td> * @param {*} a The first object to compare.<tr><td><a name="l1211" href="#l1211">1211</a><td> * @param {*} b The second object to compare.<tr><td><a name="l1212" href="#l1212">1212</a><td> * @return {boolean} True if the two arguments are equal, false otherwise.<tr><td><a name="l1213" href="#l1213">1213</a><td> */<tr><td><a name="l1214" href="#l1214">1214</a><td>goog.array.defaultCompareEquality = function(a, b) {<tr><td><a name="l1215" href="#l1215">1215</a><td>  return a === b;<tr><td><a name="l1216" href="#l1216">1216</a><td>};<tr><td><a name="l1217" href="#l1217">1217</a><td><tr><td><a name="l1218" href="#l1218">1218</a><td><tr><td><a name="l1219" href="#l1219">1219</a><td>/**<tr><td><a name="l1220" href="#l1220">1220</a><td> * Inserts a value into a sorted array. The array is not modified if the<tr><td><a name="l1221" href="#l1221">1221</a><td> * value is already present.<tr><td><a name="l1222" href="#l1222">1222</a><td> * @param {Array.&lt;T&gt;} array The array to modify.<tr><td><a name="l1223" href="#l1223">1223</a><td> * @param {T} value The object to insert.<tr><td><a name="l1224" href="#l1224">1224</a><td> * @param {?function(T,T):number=} opt_compareFn Optional comparison function by<tr><td><a name="l1225" href="#l1225">1225</a><td> *     which the<tr><td><a name="l1226" href="#l1226">1226</a><td> *     array is ordered. Should take 2 arguments to compare, and return a<tr><td><a name="l1227" href="#l1227">1227</a><td> *     negative number, zero, or a positive number depending on whether the<tr><td><a name="l1228" href="#l1228">1228</a><td> *     first argument is less than, equal to, or greater than the second.<tr><td><a name="l1229" href="#l1229">1229</a><td> * @return {boolean} True if an element was inserted.<tr><td><a name="l1230" href="#l1230">1230</a><td> * @template T<tr><td><a name="l1231" href="#l1231">1231</a><td> */<tr><td><a name="l1232" href="#l1232">1232</a><td>goog.array.binaryInsert = function(array, value, opt_compareFn) {<tr><td><a name="l1233" href="#l1233">1233</a><td>  var index = goog.array.binarySearch(array, value, opt_compareFn);<tr><td><a name="l1234" href="#l1234">1234</a><td>  if (index &lt; 0) {<tr><td><a name="l1235" href="#l1235">1235</a><td>    goog.array.insertAt(array, value, -(index + 1));<tr><td><a name="l1236" href="#l1236">1236</a><td>    return true;<tr><td><a name="l1237" href="#l1237">1237</a><td>  }<tr><td><a name="l1238" href="#l1238">1238</a><td>  return false;<tr><td><a name="l1239" href="#l1239">1239</a><td>};<tr><td><a name="l1240" href="#l1240">1240</a><td><tr><td><a name="l1241" href="#l1241">1241</a><td><tr><td><a name="l1242" href="#l1242">1242</a><td>/**<tr><td><a name="l1243" href="#l1243">1243</a><td> * Removes a value from a sorted array.<tr><td><a name="l1244" href="#l1244">1244</a><td> * @param {Array} array The array to modify.<tr><td><a name="l1245" href="#l1245">1245</a><td> * @param {*} value The object to remove.<tr><td><a name="l1246" href="#l1246">1246</a><td> * @param {Function=} opt_compareFn Optional comparison function by which the<tr><td><a name="l1247" href="#l1247">1247</a><td> *     array is ordered. Should take 2 arguments to compare, and return a<tr><td><a name="l1248" href="#l1248">1248</a><td> *     negative number, zero, or a positive number depending on whether the<tr><td><a name="l1249" href="#l1249">1249</a><td> *     first argument is less than, equal to, or greater than the second.<tr><td><a name="l1250" href="#l1250">1250</a><td> * @return {boolean} True if an element was removed.<tr><td><a name="l1251" href="#l1251">1251</a><td> */<tr><td><a name="l1252" href="#l1252">1252</a><td>goog.array.binaryRemove = function(array, value, opt_compareFn) {<tr><td><a name="l1253" href="#l1253">1253</a><td>  var index = goog.array.binarySearch(array, value, opt_compareFn);<tr><td><a name="l1254" href="#l1254">1254</a><td>  return (index &gt;= 0) ? goog.array.removeAt(array, index) : false;<tr><td><a name="l1255" href="#l1255">1255</a><td>};<tr><td><a name="l1256" href="#l1256">1256</a><td><tr><td><a name="l1257" href="#l1257">1257</a><td><tr><td><a name="l1258" href="#l1258">1258</a><td>/**<tr><td><a name="l1259" href="#l1259">1259</a><td> * Splits an array into disjoint buckets according to a splitting function.<tr><td><a name="l1260" href="#l1260">1260</a><td> * @param {Array.&lt;T&gt;} array The array.<tr><td><a name="l1261" href="#l1261">1261</a><td> * @param {function(this:S, T,number,Array.&lt;T&gt;):?} sorter Function to call for<tr><td><a name="l1262" href="#l1262">1262</a><td> *     every element.  This takes 3 arguments (the element, the index and the<tr><td><a name="l1263" href="#l1263">1263</a><td> *     array) and must return a valid object key (a string, number, etc), or<tr><td><a name="l1264" href="#l1264">1264</a><td> *     undefined, if that object should not be placed in a bucket.<tr><td><a name="l1265" href="#l1265">1265</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a name="l1266" href="#l1266">1266</a><td> *     sorter.<tr><td><a name="l1267" href="#l1267">1267</a><td> * @return {!Object} An object, with keys being all of the unique return values<tr><td><a name="l1268" href="#l1268">1268</a><td> *     of sorter, and values being arrays containing the items for<tr><td><a name="l1269" href="#l1269">1269</a><td> *     which the splitter returned that key.<tr><td><a name="l1270" href="#l1270">1270</a><td> * @template T,S<tr><td><a name="l1271" href="#l1271">1271</a><td> */<tr><td><a name="l1272" href="#l1272">1272</a><td>goog.array.bucket = function(array, sorter, opt_obj) {<tr><td><a name="l1273" href="#l1273">1273</a><td>  var buckets = {};<tr><td><a name="l1274" href="#l1274">1274</a><td><tr><td><a name="l1275" href="#l1275">1275</a><td>  for (var i = 0; i &lt; array.length; i++) {<tr><td><a name="l1276" href="#l1276">1276</a><td>    var value = array[i];<tr><td><a name="l1277" href="#l1277">1277</a><td>    var key = sorter.call(opt_obj, value, i, array);<tr><td><a name="l1278" href="#l1278">1278</a><td>    if (goog.isDef(key)) {<tr><td><a name="l1279" href="#l1279">1279</a><td>      // Push the value to the right bucket, creating it if necessary.<tr><td><a name="l1280" href="#l1280">1280</a><td>      var bucket = buckets[key] || (buckets[key] = []);<tr><td><a name="l1281" href="#l1281">1281</a><td>      bucket.push(value);<tr><td><a name="l1282" href="#l1282">1282</a><td>    }<tr><td><a name="l1283" href="#l1283">1283</a><td>  }<tr><td><a name="l1284" href="#l1284">1284</a><td><tr><td><a name="l1285" href="#l1285">1285</a><td>  return buckets;<tr><td><a name="l1286" href="#l1286">1286</a><td>};<tr><td><a name="l1287" href="#l1287">1287</a><td><tr><td><a name="l1288" href="#l1288">1288</a><td><tr><td><a name="l1289" href="#l1289">1289</a><td>/**<tr><td><a name="l1290" href="#l1290">1290</a><td> * Creates a new object built from the provided array and the key-generation<tr><td><a name="l1291" href="#l1291">1291</a><td> * function.<tr><td><a name="l1292" href="#l1292">1292</a><td> * @param {Array.&lt;T&gt;|goog.array.ArrayLike} arr Array or array like object over<tr><td><a name="l1293" href="#l1293">1293</a><td> *     which to iterate whose elements will be the values in the new object.<tr><td><a name="l1294" href="#l1294">1294</a><td> * @param {?function(this:S, T, number, ?) : string} keyFunc The function to<tr><td><a name="l1295" href="#l1295">1295</a><td> *     call for every element. This function takes 3 arguments (the element, the<tr><td><a name="l1296" href="#l1296">1296</a><td> *     index and the array) and should return a string that will be used as the<tr><td><a name="l1297" href="#l1297">1297</a><td> *     key for the element in the new object. If the function returns the same<tr><td><a name="l1298" href="#l1298">1298</a><td> *     key for more than one element, the value for that key is<tr><td><a name="l1299" href="#l1299">1299</a><td> *     implementation-defined.<tr><td><a name="l1300" href="#l1300">1300</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l1301" href="#l1301">1301</a><td> *     within keyFunc.<tr><td><a name="l1302" href="#l1302">1302</a><td> * @return {!Object.&lt;T&gt;} The new object.<tr><td><a name="l1303" href="#l1303">1303</a><td> * @template T,S<tr><td><a name="l1304" href="#l1304">1304</a><td> */<tr><td><a name="l1305" href="#l1305">1305</a><td>goog.array.toObject = function(arr, keyFunc, opt_obj) {<tr><td><a name="l1306" href="#l1306">1306</a><td>  var ret = {};<tr><td><a name="l1307" href="#l1307">1307</a><td>  goog.array.forEach(arr, function(element, index) {<tr><td><a name="l1308" href="#l1308">1308</a><td>    ret[keyFunc.call(opt_obj, element, index, arr)] = element;<tr><td><a name="l1309" href="#l1309">1309</a><td>  });<tr><td><a name="l1310" href="#l1310">1310</a><td>  return ret;<tr><td><a name="l1311" href="#l1311">1311</a><td>};<tr><td><a name="l1312" href="#l1312">1312</a><td><tr><td><a name="l1313" href="#l1313">1313</a><td><tr><td><a name="l1314" href="#l1314">1314</a><td>/**<tr><td><a name="l1315" href="#l1315">1315</a><td> * Creates a range of numbers in an arithmetic progression.<tr><td><a name="l1316" href="#l1316">1316</a><td> *<tr><td><a name="l1317" href="#l1317">1317</a><td> * Range takes 1, 2, or 3 arguments:<tr><td><a name="l1318" href="#l1318">1318</a><td> * &lt;pre&gt;<tr><td><a name="l1319" href="#l1319">1319</a><td> * range(5) is the same as range(0, 5, 1) and produces [0, 1, 2, 3, 4]<tr><td><a name="l1320" href="#l1320">1320</a><td> * range(2, 5) is the same as range(2, 5, 1) and produces [2, 3, 4]<tr><td><a name="l1321" href="#l1321">1321</a><td> * range(-2, -5, -1) produces [-2, -3, -4]<tr><td><a name="l1322" href="#l1322">1322</a><td> * range(-2, -5, 1) produces [], since stepping by 1 wouldn&#39;t ever reach -5.<tr><td><a name="l1323" href="#l1323">1323</a><td> * &lt;/pre&gt;<tr><td><a name="l1324" href="#l1324">1324</a><td> *<tr><td><a name="l1325" href="#l1325">1325</a><td> * @param {number} startOrEnd The starting value of the range if an end argument<tr><td><a name="l1326" href="#l1326">1326</a><td> *     is provided. Otherwise, the start value is 0, and this is the end value.<tr><td><a name="l1327" href="#l1327">1327</a><td> * @param {number=} opt_end The optional end value of the range.<tr><td><a name="l1328" href="#l1328">1328</a><td> * @param {number=} opt_step The step size between range values. Defaults to 1<tr><td><a name="l1329" href="#l1329">1329</a><td> *     if opt_step is undefined or 0.<tr><td><a name="l1330" href="#l1330">1330</a><td> * @return {!Array.&lt;number&gt;} An array of numbers for the requested range. May be<tr><td><a name="l1331" href="#l1331">1331</a><td> *     an empty array if adding the step would not converge toward the end<tr><td><a name="l1332" href="#l1332">1332</a><td> *     value.<tr><td><a name="l1333" href="#l1333">1333</a><td> */<tr><td><a name="l1334" href="#l1334">1334</a><td>goog.array.range = function(startOrEnd, opt_end, opt_step) {<tr><td><a name="l1335" href="#l1335">1335</a><td>  var array = [];<tr><td><a name="l1336" href="#l1336">1336</a><td>  var start = 0;<tr><td><a name="l1337" href="#l1337">1337</a><td>  var end = startOrEnd;<tr><td><a name="l1338" href="#l1338">1338</a><td>  var step = opt_step || 1;<tr><td><a name="l1339" href="#l1339">1339</a><td>  if (opt_end !== undefined) {<tr><td><a name="l1340" href="#l1340">1340</a><td>    start = startOrEnd;<tr><td><a name="l1341" href="#l1341">1341</a><td>    end = opt_end;<tr><td><a name="l1342" href="#l1342">1342</a><td>  }<tr><td><a name="l1343" href="#l1343">1343</a><td><tr><td><a name="l1344" href="#l1344">1344</a><td>  if (step * (end - start) &lt; 0) {<tr><td><a name="l1345" href="#l1345">1345</a><td>    // Sign mismatch: start + step will never reach the end value.<tr><td><a name="l1346" href="#l1346">1346</a><td>    return [];<tr><td><a name="l1347" href="#l1347">1347</a><td>  }<tr><td><a name="l1348" href="#l1348">1348</a><td><tr><td><a name="l1349" href="#l1349">1349</a><td>  if (step &gt; 0) {<tr><td><a name="l1350" href="#l1350">1350</a><td>    for (var i = start; i &lt; end; i += step) {<tr><td><a name="l1351" href="#l1351">1351</a><td>      array.push(i);<tr><td><a name="l1352" href="#l1352">1352</a><td>    }<tr><td><a name="l1353" href="#l1353">1353</a><td>  } else {<tr><td><a name="l1354" href="#l1354">1354</a><td>    for (var i = start; i &gt; end; i += step) {<tr><td><a name="l1355" href="#l1355">1355</a><td>      array.push(i);<tr><td><a name="l1356" href="#l1356">1356</a><td>    }<tr><td><a name="l1357" href="#l1357">1357</a><td>  }<tr><td><a name="l1358" href="#l1358">1358</a><td>  return array;<tr><td><a name="l1359" href="#l1359">1359</a><td>};<tr><td><a name="l1360" href="#l1360">1360</a><td><tr><td><a name="l1361" href="#l1361">1361</a><td><tr><td><a name="l1362" href="#l1362">1362</a><td>/**<tr><td><a name="l1363" href="#l1363">1363</a><td> * Returns an array consisting of the given value repeated N times.<tr><td><a name="l1364" href="#l1364">1364</a><td> *<tr><td><a name="l1365" href="#l1365">1365</a><td> * @param {*} value The value to repeat.<tr><td><a name="l1366" href="#l1366">1366</a><td> * @param {number} n The repeat count.<tr><td><a name="l1367" href="#l1367">1367</a><td> * @return {!Array} An array with the repeated value.<tr><td><a name="l1368" href="#l1368">1368</a><td> */<tr><td><a name="l1369" href="#l1369">1369</a><td>goog.array.repeat = function(value, n) {<tr><td><a name="l1370" href="#l1370">1370</a><td>  var array = [];<tr><td><a name="l1371" href="#l1371">1371</a><td>  for (var i = 0; i &lt; n; i++) {<tr><td><a name="l1372" href="#l1372">1372</a><td>    array[i] = value;<tr><td><a name="l1373" href="#l1373">1373</a><td>  }<tr><td><a name="l1374" href="#l1374">1374</a><td>  return array;<tr><td><a name="l1375" href="#l1375">1375</a><td>};<tr><td><a name="l1376" href="#l1376">1376</a><td><tr><td><a name="l1377" href="#l1377">1377</a><td><tr><td><a name="l1378" href="#l1378">1378</a><td>/**<tr><td><a name="l1379" href="#l1379">1379</a><td> * Returns an array consisting of every argument with all arrays<tr><td><a name="l1380" href="#l1380">1380</a><td> * expanded in-place recursively.<tr><td><a name="l1381" href="#l1381">1381</a><td> *<tr><td><a name="l1382" href="#l1382">1382</a><td> * @param {...*} var_args The values to flatten.<tr><td><a name="l1383" href="#l1383">1383</a><td> * @return {!Array} An array containing the flattened values.<tr><td><a name="l1384" href="#l1384">1384</a><td> */<tr><td><a name="l1385" href="#l1385">1385</a><td>goog.array.flatten = function(var_args) {<tr><td><a name="l1386" href="#l1386">1386</a><td>  var result = [];<tr><td><a name="l1387" href="#l1387">1387</a><td>  for (var i = 0; i &lt; arguments.length; i++) {<tr><td><a name="l1388" href="#l1388">1388</a><td>    var element = arguments[i];<tr><td><a name="l1389" href="#l1389">1389</a><td>    if (goog.isArray(element)) {<tr><td><a name="l1390" href="#l1390">1390</a><td>      result.push.apply(result, goog.array.flatten.apply(null, element));<tr><td><a name="l1391" href="#l1391">1391</a><td>    } else {<tr><td><a name="l1392" href="#l1392">1392</a><td>      result.push(element);<tr><td><a name="l1393" href="#l1393">1393</a><td>    }<tr><td><a name="l1394" href="#l1394">1394</a><td>  }<tr><td><a name="l1395" href="#l1395">1395</a><td>  return result;<tr><td><a name="l1396" href="#l1396">1396</a><td>};<tr><td><a name="l1397" href="#l1397">1397</a><td><tr><td><a name="l1398" href="#l1398">1398</a><td><tr><td><a name="l1399" href="#l1399">1399</a><td>/**<tr><td><a name="l1400" href="#l1400">1400</a><td> * Rotates an array in-place. After calling this method, the element at<tr><td><a name="l1401" href="#l1401">1401</a><td> * index i will be the element previously at index (i - n) %<tr><td><a name="l1402" href="#l1402">1402</a><td> * array.length, for all values of i between 0 and array.length - 1,<tr><td><a name="l1403" href="#l1403">1403</a><td> * inclusive.<tr><td><a name="l1404" href="#l1404">1404</a><td> *<tr><td><a name="l1405" href="#l1405">1405</a><td> * For example, suppose list comprises [t, a, n, k, s]. After invoking<tr><td><a name="l1406" href="#l1406">1406</a><td> * rotate(array, 1) (or rotate(array, -4)), array will comprise [s, t, a, n, k].<tr><td><a name="l1407" href="#l1407">1407</a><td> *<tr><td><a name="l1408" href="#l1408">1408</a><td> * @param {!Array.&lt;T&gt;} array The array to rotate.<tr><td><a name="l1409" href="#l1409">1409</a><td> * @param {number} n The amount to rotate.<tr><td><a name="l1410" href="#l1410">1410</a><td> * @return {!Array.&lt;T&gt;} The array.<tr><td><a name="l1411" href="#l1411">1411</a><td> * @template T<tr><td><a name="l1412" href="#l1412">1412</a><td> */<tr><td><a name="l1413" href="#l1413">1413</a><td>goog.array.rotate = function(array, n) {<tr><td><a name="l1414" href="#l1414">1414</a><td>  goog.asserts.assert(array.length != null);<tr><td><a name="l1415" href="#l1415">1415</a><td><tr><td><a name="l1416" href="#l1416">1416</a><td>  if (array.length) {<tr><td><a name="l1417" href="#l1417">1417</a><td>    n %= array.length;<tr><td><a name="l1418" href="#l1418">1418</a><td>    if (n &gt; 0) {<tr><td><a name="l1419" href="#l1419">1419</a><td>      goog.array.ARRAY_PROTOTYPE_.unshift.apply(array, array.splice(-n, n));<tr><td><a name="l1420" href="#l1420">1420</a><td>    } else if (n &lt; 0) {<tr><td><a name="l1421" href="#l1421">1421</a><td>      goog.array.ARRAY_PROTOTYPE_.push.apply(array, array.splice(0, -n));<tr><td><a name="l1422" href="#l1422">1422</a><td>    }<tr><td><a name="l1423" href="#l1423">1423</a><td>  }<tr><td><a name="l1424" href="#l1424">1424</a><td>  return array;<tr><td><a name="l1425" href="#l1425">1425</a><td>};<tr><td><a name="l1426" href="#l1426">1426</a><td><tr><td><a name="l1427" href="#l1427">1427</a><td><tr><td><a name="l1428" href="#l1428">1428</a><td>/**<tr><td><a name="l1429" href="#l1429">1429</a><td> * Creates a new array for which the element at position i is an array of the<tr><td><a name="l1430" href="#l1430">1430</a><td> * ith element of the provided arrays.  The returned array will only be as long<tr><td><a name="l1431" href="#l1431">1431</a><td> * as the shortest array provided; additional values are ignored.  For example,<tr><td><a name="l1432" href="#l1432">1432</a><td> * the result of zipping [1, 2] and [3, 4, 5] is [[1,3], [2, 4]].<tr><td><a name="l1433" href="#l1433">1433</a><td> *<tr><td><a name="l1434" href="#l1434">1434</a><td> * This is similar to the zip() function in Python.  See {@link<tr><td><a name="l1435" href="#l1435">1435</a><td> * http://docs.python.org/library/functions.html#zip}<tr><td><a name="l1436" href="#l1436">1436</a><td> *<tr><td><a name="l1437" href="#l1437">1437</a><td> * @param {...!goog.array.ArrayLike} var_args Arrays to be combined.<tr><td><a name="l1438" href="#l1438">1438</a><td> * @return {!Array.&lt;!Array&gt;} A new array of arrays created from provided arrays.<tr><td><a name="l1439" href="#l1439">1439</a><td> */<tr><td><a name="l1440" href="#l1440">1440</a><td>goog.array.zip = function(var_args) {<tr><td><a name="l1441" href="#l1441">1441</a><td>  if (!arguments.length) {<tr><td><a name="l1442" href="#l1442">1442</a><td>    return [];<tr><td><a name="l1443" href="#l1443">1443</a><td>  }<tr><td><a name="l1444" href="#l1444">1444</a><td>  var result = [];<tr><td><a name="l1445" href="#l1445">1445</a><td>  for (var i = 0; true; i++) {<tr><td><a name="l1446" href="#l1446">1446</a><td>    var value = [];<tr><td><a name="l1447" href="#l1447">1447</a><td>    for (var j = 0; j &lt; arguments.length; j++) {<tr><td><a name="l1448" href="#l1448">1448</a><td>      var arr = arguments[j];<tr><td><a name="l1449" href="#l1449">1449</a><td>      // If i is larger than the array length, this is the shortest array.<tr><td><a name="l1450" href="#l1450">1450</a><td>      if (i &gt;= arr.length) {<tr><td><a name="l1451" href="#l1451">1451</a><td>        return result;<tr><td><a name="l1452" href="#l1452">1452</a><td>      }<tr><td><a name="l1453" href="#l1453">1453</a><td>      value.push(arr[i]);<tr><td><a name="l1454" href="#l1454">1454</a><td>    }<tr><td><a name="l1455" href="#l1455">1455</a><td>    result.push(value);<tr><td><a name="l1456" href="#l1456">1456</a><td>  }<tr><td><a name="l1457" href="#l1457">1457</a><td>};<tr><td><a name="l1458" href="#l1458">1458</a><td><tr><td><a name="l1459" href="#l1459">1459</a><td><tr><td><a name="l1460" href="#l1460">1460</a><td>/**<tr><td><a name="l1461" href="#l1461">1461</a><td> * Shuffles the values in the specified array using the Fisher-Yates in-place<tr><td><a name="l1462" href="#l1462">1462</a><td> * shuffle (also known as the Knuth Shuffle). By default, calls Math.random()<tr><td><a name="l1463" href="#l1463">1463</a><td> * and so resets the state of that random number generator. Similarly, may reset<tr><td><a name="l1464" href="#l1464">1464</a><td> * the state of the any other specified random number generator.<tr><td><a name="l1465" href="#l1465">1465</a><td> *<tr><td><a name="l1466" href="#l1466">1466</a><td> * Runtime: O(n)<tr><td><a name="l1467" href="#l1467">1467</a><td> *<tr><td><a name="l1468" href="#l1468">1468</a><td> * @param {!Array} arr The array to be shuffled.<tr><td><a name="l1469" href="#l1469">1469</a><td> * @param {function():number=} opt_randFn Optional random function to use for<tr><td><a name="l1470" href="#l1470">1470</a><td> *     shuffling.<tr><td><a name="l1471" href="#l1471">1471</a><td> *     Takes no arguments, and returns a random number on the interval [0, 1).<tr><td><a name="l1472" href="#l1472">1472</a><td> *     Defaults to Math.random() using JavaScript&#39;s built-in Math library.<tr><td><a name="l1473" href="#l1473">1473</a><td> */<tr><td><a name="l1474" href="#l1474">1474</a><td>goog.array.shuffle = function(arr, opt_randFn) {<tr><td><a name="l1475" href="#l1475">1475</a><td>  var randFn = opt_randFn || Math.random;<tr><td><a name="l1476" href="#l1476">1476</a><td><tr><td><a name="l1477" href="#l1477">1477</a><td>  for (var i = arr.length - 1; i &gt; 0; i--) {<tr><td><a name="l1478" href="#l1478">1478</a><td>    // Choose a random array index in [0, i] (inclusive with i).<tr><td><a name="l1479" href="#l1479">1479</a><td>    var j = Math.floor(randFn() * (i + 1));<tr><td><a name="l1480" href="#l1480">1480</a><td><tr><td><a name="l1481" href="#l1481">1481</a><td>    var tmp = arr[i];<tr><td><a name="l1482" href="#l1482">1482</a><td>    arr[i] = arr[j];<tr><td><a name="l1483" href="#l1483">1483</a><td>    arr[j] = tmp;<tr><td><a name="l1484" href="#l1484">1484</a><td>  }<tr><td><a name="l1485" href="#l1485">1485</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>array.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/array/array.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities for manipulating arrays.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.array&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.array.ArrayLike&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @define {boolean} NATIVE_ARRAY_PROTOTYPES indicates whether the code should<tr><td><a id="l30"></a><a href="#l30">30</a><td> * rely on Array.prototype functions, if available.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * The Array.prototype functions can be defined by external libraries like<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Prototype and setting this flag to false forces closure to use its own<tr><td><a id="l34"></a><a href="#l34">34</a><td> * goog.array implementation.<tr><td><a id="l35"></a><a href="#l35">35</a><td> *<tr><td><a id="l36"></a><a href="#l36">36</a><td> * If your javascript can be loaded by a third party site and you are wary about<tr><td><a id="l37"></a><a href="#l37">37</a><td> * relying on the prototype functions, specify<tr><td><a id="l38"></a><a href="#l38">38</a><td> * &quot;--define goog.NATIVE_ARRAY_PROTOTYPES=false&quot; to the JSCompiler.<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * Setting goog.TRUSTED_SITE to false will automatically set<tr><td><a id="l41"></a><a href="#l41">41</a><td> * NATIVE_ARRAY_PROTOTYPES to false.<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.define(&#39;goog.NATIVE_ARRAY_PROTOTYPES&#39;, goog.TRUSTED_SITE);<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @define {boolean} If true, JSCompiler will use the native implementation of<tr><td><a id="l48"></a><a href="#l48">48</a><td> * array functions where appropriate (e.g., {@code Array#filter}) and remove the<tr><td><a id="l49"></a><a href="#l49">49</a><td> * unused pure JS implementation.<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.define(&#39;goog.array.ASSUME_NATIVE_FUNCTIONS&#39;, false);<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>/**<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @typedef {Array|NodeList|Arguments|{length: number}}<tr><td><a id="l56"></a><a href="#l56">56</a><td> */<tr><td><a id="l57"></a><a href="#l57">57</a><td>goog.array.ArrayLike;<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> * Returns the last element in an array without removing it.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * Same as goog.array.last.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} array The array.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @return {T} Last item in array.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @template T<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.array.peek = function(array) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  return array[array.length - 1];<tr><td><a id="l69"></a><a href="#l69">69</a><td>};<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> * Returns the last element in an array without removing it.<tr><td><a id="l74"></a><a href="#l74">74</a><td> * Same as goog.array.peek.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} array The array.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {T} Last item in array.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @template T<tr><td><a id="l78"></a><a href="#l78">78</a><td> */<tr><td><a id="l79"></a><a href="#l79">79</a><td>goog.array.last = goog.array.peek;<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Reference to the original {@code Array.prototype}.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @private {!Object}<tr><td><a id="l85"></a><a href="#l85">85</a><td> */<tr><td><a id="l86"></a><a href="#l86">86</a><td>goog.array.ARRAY_PROTOTYPE_ = Array.prototype;<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>// NOTE(arv): Since most of the array functions are generic it allows you to<tr><td><a id="l90"></a><a href="#l90">90</a><td>// pass an array-like object. Strings have a length and are considered array-<tr><td><a id="l91"></a><a href="#l91">91</a><td>// like. However, the &#39;in&#39; operator does not work on strings so we cannot just<tr><td><a id="l92"></a><a href="#l92">92</a><td>// use the array path even if the browser supports indexing into strings. We<tr><td><a id="l93"></a><a href="#l93">93</a><td>// therefore end up splitting the string.<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>/**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Returns the index of the first element of an array with a specified value, or<tr><td><a id="l98"></a><a href="#l98">98</a><td> * -1 if the element is not present in the array.<tr><td><a id="l99"></a><a href="#l99">99</a><td> *<tr><td><a id="l100"></a><a href="#l100">100</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-indexof}<tr><td><a id="l101"></a><a href="#l101">101</a><td> *<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr The array to be searched.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @param {T} obj The object for which we are searching.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @param {number=} opt_fromIndex The index at which to start the search. If<tr><td><a id="l105"></a><a href="#l105">105</a><td> *     omitted the search starts at index 0.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {number} The index of the first matching array element.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @template T<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.array.indexOf = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l110"></a><a href="#l110">110</a><td>                     (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l111"></a><a href="#l111">111</a><td>                      goog.array.ARRAY_PROTOTYPE_.indexOf) ?<tr><td><a id="l112"></a><a href="#l112">112</a><td>    function(arr, obj, opt_fromIndex) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l114"></a><a href="#l114">114</a><td><tr><td><a id="l115"></a><a href="#l115">115</a><td>      return goog.array.ARRAY_PROTOTYPE_.indexOf.call(arr, obj, opt_fromIndex);<tr><td><a id="l116"></a><a href="#l116">116</a><td>    } :<tr><td><a id="l117"></a><a href="#l117">117</a><td>    function(arr, obj, opt_fromIndex) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>      var fromIndex = opt_fromIndex == null ?<tr><td><a id="l119"></a><a href="#l119">119</a><td>          0 : (opt_fromIndex &lt; 0 ?<tr><td><a id="l120"></a><a href="#l120">120</a><td>               Math.max(0, arr.length + opt_fromIndex) : opt_fromIndex);<tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td>      if (goog.isString(arr)) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>        // Array.prototype.indexOf uses === so only strings should be found.<tr><td><a id="l124"></a><a href="#l124">124</a><td>        if (!goog.isString(obj) || obj.length != 1) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>          return -1;<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 arr.indexOf(obj, fromIndex);<tr><td><a id="l128"></a><a href="#l128">128</a><td>      }<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>      for (var i = fromIndex; i &lt; arr.length; i++) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>        if (i in arr &amp;&amp; arr[i] === obj)<tr><td><a id="l132"></a><a href="#l132">132</a><td>          return i;<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 -1;<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 index of the last element of an array with a specified value, or<tr><td><a id="l140"></a><a href="#l140">140</a><td> * -1 if the element is not present in the array.<tr><td><a id="l141"></a><a href="#l141">141</a><td> *<tr><td><a id="l142"></a><a href="#l142">142</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-lastindexof}<tr><td><a id="l143"></a><a href="#l143">143</a><td> *<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @param {!Array&lt;T&gt;|!goog.array.ArrayLike} arr The array to be searched.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {T} obj The object for which we are searching.<tr><td><a id="l146"></a><a href="#l146">146</a><td> * @param {?number=} opt_fromIndex The index at which to start the search. If<tr><td><a id="l147"></a><a href="#l147">147</a><td> *     omitted the search starts at the end of the array.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @return {number} The index of the last matching array element.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @template T<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.array.lastIndexOf = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l152"></a><a href="#l152">152</a><td>                         (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l153"></a><a href="#l153">153</a><td>                          goog.array.ARRAY_PROTOTYPE_.lastIndexOf) ?<tr><td><a id="l154"></a><a href="#l154">154</a><td>    function(arr, obj, opt_fromIndex) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td>      // Firefox treats undefined and null as 0 in the fromIndex argument which<tr><td><a id="l158"></a><a href="#l158">158</a><td>      // leads it to always return -1<tr><td><a id="l159"></a><a href="#l159">159</a><td>      var fromIndex = opt_fromIndex == null ? arr.length - 1 : opt_fromIndex;<tr><td><a id="l160"></a><a href="#l160">160</a><td>      return goog.array.ARRAY_PROTOTYPE_.lastIndexOf.call(arr, obj, fromIndex);<tr><td><a id="l161"></a><a href="#l161">161</a><td>    } :<tr><td><a id="l162"></a><a href="#l162">162</a><td>    function(arr, obj, opt_fromIndex) {<tr><td><a id="l163"></a><a href="#l163">163</a><td>      var fromIndex = opt_fromIndex == null ? arr.length - 1 : opt_fromIndex;<tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td>      if (fromIndex &lt; 0) {<tr><td><a id="l166"></a><a href="#l166">166</a><td>        fromIndex = Math.max(0, arr.length + fromIndex);<tr><td><a id="l167"></a><a href="#l167">167</a><td>      }<tr><td><a id="l168"></a><a href="#l168">168</a><td><tr><td><a id="l169"></a><a href="#l169">169</a><td>      if (goog.isString(arr)) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>        // Array.prototype.lastIndexOf uses === so only strings should be found.<tr><td><a id="l171"></a><a href="#l171">171</a><td>        if (!goog.isString(obj) || obj.length != 1) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>          return -1;<tr><td><a id="l173"></a><a href="#l173">173</a><td>        }<tr><td><a id="l174"></a><a href="#l174">174</a><td>        return arr.lastIndexOf(obj, fromIndex);<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>      for (var i = fromIndex; i &gt;= 0; i--) {<tr><td><a id="l178"></a><a href="#l178">178</a><td>        if (i in arr &amp;&amp; arr[i] === obj)<tr><td><a id="l179"></a><a href="#l179">179</a><td>          return i;<tr><td><a id="l180"></a><a href="#l180">180</a><td>      }<tr><td><a id="l181"></a><a href="#l181">181</a><td>      return -1;<tr><td><a id="l182"></a><a href="#l182">182</a><td>    };<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>/**<tr><td><a id="l186"></a><a href="#l186">186</a><td> * Calls a function for each element in an array. Skips holes in the array.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-foreach}<tr><td><a id="l188"></a><a href="#l188">188</a><td> *<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array like object over<tr><td><a id="l190"></a><a href="#l190">190</a><td> *     which to iterate.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {?function(this: S, T, number, ?): ?} f The function to call for every<tr><td><a id="l192"></a><a href="#l192">192</a><td> *     element. This function takes 3 arguments (the element, the index and the<tr><td><a id="l193"></a><a href="#l193">193</a><td> *     array). The return value is ignored.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39; within f.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @template T,S<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.array.forEach = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l198"></a><a href="#l198">198</a><td>                     (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l199"></a><a href="#l199">199</a><td>                      goog.array.ARRAY_PROTOTYPE_.forEach) ?<tr><td><a id="l200"></a><a href="#l200">200</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l201"></a><a href="#l201">201</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l202"></a><a href="#l202">202</a><td><tr><td><a id="l203"></a><a href="#l203">203</a><td>      goog.array.ARRAY_PROTOTYPE_.forEach.call(arr, f, opt_obj);<tr><td><a id="l204"></a><a href="#l204">204</a><td>    } :<tr><td><a id="l205"></a><a href="#l205">205</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l206"></a><a href="#l206">206</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a id="l207"></a><a href="#l207">207</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a id="l208"></a><a href="#l208">208</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>        if (i in arr2) {<tr><td><a id="l210"></a><a href="#l210">210</a><td>          f.call(opt_obj, arr2[i], i, arr);<tr><td><a id="l211"></a><a href="#l211">211</a><td>        }<tr><td><a id="l212"></a><a href="#l212">212</a><td>      }<tr><td><a id="l213"></a><a href="#l213">213</a><td>    };<tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td>/**<tr><td><a id="l217"></a><a href="#l217">217</a><td> * Calls a function for each element in an array, starting from the last<tr><td><a id="l218"></a><a href="#l218">218</a><td> * element rather than the first.<tr><td><a id="l219"></a><a href="#l219">219</a><td> *<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l221"></a><a href="#l221">221</a><td> *     like object over which to iterate.<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @param {?function(this: S, T, number, ?): ?} f The function to call for every<tr><td><a id="l223"></a><a href="#l223">223</a><td> *     element. This function<tr><td><a id="l224"></a><a href="#l224">224</a><td> *     takes 3 arguments (the element, the index and the array). The return<tr><td><a id="l225"></a><a href="#l225">225</a><td> *     value is ignored.<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a id="l227"></a><a href="#l227">227</a><td> *     within f.<tr><td><a id="l228"></a><a href="#l228">228</a><td> * @template T,S<tr><td><a id="l229"></a><a href="#l229">229</a><td> */<tr><td><a id="l230"></a><a href="#l230">230</a><td>goog.array.forEachRight = function(arr, f, opt_obj) {<tr><td><a id="l231"></a><a href="#l231">231</a><td>  var l = arr.length;  // must be fixed during loop... see docs<tr><td><a id="l232"></a><a href="#l232">232</a><td>  var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a id="l233"></a><a href="#l233">233</a><td>  for (var i = l - 1; i &gt;= 0; --i) {<tr><td><a id="l234"></a><a href="#l234">234</a><td>    if (i in arr2) {<tr><td><a id="l235"></a><a href="#l235">235</a><td>      f.call(opt_obj, arr2[i], i, arr);<tr><td><a id="l236"></a><a href="#l236">236</a><td>    }<tr><td><a id="l237"></a><a href="#l237">237</a><td>  }<tr><td><a id="l238"></a><a href="#l238">238</a><td>};<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>/**<tr><td><a id="l242"></a><a href="#l242">242</a><td> * Calls a function for each element in an array, and if the function returns<tr><td><a id="l243"></a><a href="#l243">243</a><td> * true adds the element to a new array.<tr><td><a id="l244"></a><a href="#l244">244</a><td> *<tr><td><a id="l245"></a><a href="#l245">245</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-filter}<tr><td><a id="l246"></a><a href="#l246">246</a><td> *<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l248"></a><a href="#l248">248</a><td> *     like object over which to iterate.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @param {?function(this:S, T, number, ?):boolean} f The function to call for<tr><td><a id="l250"></a><a href="#l250">250</a><td> *     every element. This function<tr><td><a id="l251"></a><a href="#l251">251</a><td> *     takes 3 arguments (the element, the index and the array) and must<tr><td><a id="l252"></a><a href="#l252">252</a><td> *     return a Boolean. If the return value is true the element is added to the<tr><td><a id="l253"></a><a href="#l253">253</a><td> *     result array. If it is false the element is not included.<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a id="l255"></a><a href="#l255">255</a><td> *     within f.<tr><td><a id="l256"></a><a href="#l256">256</a><td> * @return {!Array&lt;T&gt;} a new array in which only elements that passed the test<tr><td><a id="l257"></a><a href="#l257">257</a><td> *     are present.<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @template T,S<tr><td><a id="l259"></a><a href="#l259">259</a><td> */<tr><td><a id="l260"></a><a href="#l260">260</a><td>goog.array.filter = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l261"></a><a href="#l261">261</a><td>                    (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l262"></a><a href="#l262">262</a><td>                     goog.array.ARRAY_PROTOTYPE_.filter) ?<tr><td><a id="l263"></a><a href="#l263">263</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l264"></a><a href="#l264">264</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td>      return goog.array.ARRAY_PROTOTYPE_.filter.call(arr, f, opt_obj);<tr><td><a id="l267"></a><a href="#l267">267</a><td>    } :<tr><td><a id="l268"></a><a href="#l268">268</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a id="l270"></a><a href="#l270">270</a><td>      var res = [];<tr><td><a id="l271"></a><a href="#l271">271</a><td>      var resLength = 0;<tr><td><a id="l272"></a><a href="#l272">272</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a id="l273"></a><a href="#l273">273</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a id="l274"></a><a href="#l274">274</a><td>        if (i in arr2) {<tr><td><a id="l275"></a><a href="#l275">275</a><td>          var val = arr2[i];  // in case f mutates arr2<tr><td><a id="l276"></a><a href="#l276">276</a><td>          if (f.call(opt_obj, val, i, arr)) {<tr><td><a id="l277"></a><a href="#l277">277</a><td>            res[resLength++] = val;<tr><td><a id="l278"></a><a href="#l278">278</a><td>          }<tr><td><a id="l279"></a><a href="#l279">279</a><td>        }<tr><td><a id="l280"></a><a href="#l280">280</a><td>      }<tr><td><a id="l281"></a><a href="#l281">281</a><td>      return res;<tr><td><a id="l282"></a><a href="#l282">282</a><td>    };<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td>/**<tr><td><a id="l286"></a><a href="#l286">286</a><td> * Calls a function for each element in an array and inserts the result into a<tr><td><a id="l287"></a><a href="#l287">287</a><td> * new array.<tr><td><a id="l288"></a><a href="#l288">288</a><td> *<tr><td><a id="l289"></a><a href="#l289">289</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-map}<tr><td><a id="l290"></a><a href="#l290">290</a><td> *<tr><td><a id="l291"></a><a href="#l291">291</a><td> * @param {Array&lt;VALUE&gt;|goog.array.ArrayLike} arr Array or array like object<tr><td><a id="l292"></a><a href="#l292">292</a><td> *     over which to iterate.<tr><td><a id="l293"></a><a href="#l293">293</a><td> * @param {function(this:THIS, VALUE, number, ?): RESULT} f The function to call<tr><td><a id="l294"></a><a href="#l294">294</a><td> *     for every element. This function takes 3 arguments (the element,<tr><td><a id="l295"></a><a href="#l295">295</a><td> *     the index and the array) and should return something. The result will be<tr><td><a id="l296"></a><a href="#l296">296</a><td> *     inserted into a new array.<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39; within f.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @return {!Array&lt;RESULT&gt;} a new array with the results from f.<tr><td><a id="l299"></a><a href="#l299">299</a><td> * @template THIS, VALUE, RESULT<tr><td><a id="l300"></a><a href="#l300">300</a><td> */<tr><td><a id="l301"></a><a href="#l301">301</a><td>goog.array.map = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l302"></a><a href="#l302">302</a><td>                 (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l303"></a><a href="#l303">303</a><td>                  goog.array.ARRAY_PROTOTYPE_.map) ?<tr><td><a id="l304"></a><a href="#l304">304</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l305"></a><a href="#l305">305</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l306"></a><a href="#l306">306</a><td><tr><td><a id="l307"></a><a href="#l307">307</a><td>      return goog.array.ARRAY_PROTOTYPE_.map.call(arr, f, opt_obj);<tr><td><a id="l308"></a><a href="#l308">308</a><td>    } :<tr><td><a id="l309"></a><a href="#l309">309</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l310"></a><a href="#l310">310</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a id="l311"></a><a href="#l311">311</a><td>      var res = new Array(l);<tr><td><a id="l312"></a><a href="#l312">312</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a id="l313"></a><a href="#l313">313</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a id="l314"></a><a href="#l314">314</a><td>        if (i in arr2) {<tr><td><a id="l315"></a><a href="#l315">315</a><td>          res[i] = f.call(opt_obj, arr2[i], i, arr);<tr><td><a id="l316"></a><a href="#l316">316</a><td>        }<tr><td><a id="l317"></a><a href="#l317">317</a><td>      }<tr><td><a id="l318"></a><a href="#l318">318</a><td>      return res;<tr><td><a id="l319"></a><a href="#l319">319</a><td>    };<tr><td><a id="l320"></a><a href="#l320">320</a><td><tr><td><a id="l321"></a><a href="#l321">321</a><td><tr><td><a id="l322"></a><a href="#l322">322</a><td>/**<tr><td><a id="l323"></a><a href="#l323">323</a><td> * Passes every element of an array into a function and accumulates the result.<tr><td><a id="l324"></a><a href="#l324">324</a><td> *<tr><td><a id="l325"></a><a href="#l325">325</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-reduce}<tr><td><a id="l326"></a><a href="#l326">326</a><td> *<tr><td><a id="l327"></a><a href="#l327">327</a><td> * For example:<tr><td><a id="l328"></a><a href="#l328">328</a><td> * var a = [1, 2, 3, 4];<tr><td><a id="l329"></a><a href="#l329">329</a><td> * goog.array.reduce(a, function(r, v, i, arr) {return r + v;}, 0);<tr><td><a id="l330"></a><a href="#l330">330</a><td> * returns 10<tr><td><a id="l331"></a><a href="#l331">331</a><td> *<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l333"></a><a href="#l333">333</a><td> *     like object over which to iterate.<tr><td><a id="l334"></a><a href="#l334">334</a><td> * @param {function(this:S, R, T, number, ?) : R} f The function to call for<tr><td><a id="l335"></a><a href="#l335">335</a><td> *     every element. This function<tr><td><a id="l336"></a><a href="#l336">336</a><td> *     takes 4 arguments (the function&#39;s previous result or the initial value,<tr><td><a id="l337"></a><a href="#l337">337</a><td> *     the value of the current array element, the current array index, and the<tr><td><a id="l338"></a><a href="#l338">338</a><td> *     array itself)<tr><td><a id="l339"></a><a href="#l339">339</a><td> *     function(previousValue, currentValue, index, array).<tr><td><a id="l340"></a><a href="#l340">340</a><td> * @param {?} val The initial value to pass into the function on the first call.<tr><td><a id="l341"></a><a href="#l341">341</a><td> * @param {S=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a id="l342"></a><a href="#l342">342</a><td> *     within f.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @return {R} Result of evaluating f repeatedly across the values of the array.<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @template T,S,R<tr><td><a id="l345"></a><a href="#l345">345</a><td> */<tr><td><a id="l346"></a><a href="#l346">346</a><td>goog.array.reduce = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l347"></a><a href="#l347">347</a><td>                    (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l348"></a><a href="#l348">348</a><td>                     goog.array.ARRAY_PROTOTYPE_.reduce) ?<tr><td><a id="l349"></a><a href="#l349">349</a><td>    function(arr, f, val, opt_obj) {<tr><td><a id="l350"></a><a href="#l350">350</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l351"></a><a href="#l351">351</a><td>      if (opt_obj) {<tr><td><a id="l352"></a><a href="#l352">352</a><td>        f = goog.bind(f, opt_obj);<tr><td><a id="l353"></a><a href="#l353">353</a><td>      }<tr><td><a id="l354"></a><a href="#l354">354</a><td>      return goog.array.ARRAY_PROTOTYPE_.reduce.call(arr, f, val);<tr><td><a id="l355"></a><a href="#l355">355</a><td>    } :<tr><td><a id="l356"></a><a href="#l356">356</a><td>    function(arr, f, val, opt_obj) {<tr><td><a id="l357"></a><a href="#l357">357</a><td>      var rval = val;<tr><td><a id="l358"></a><a href="#l358">358</a><td>      goog.array.forEach(arr, function(val, index) {<tr><td><a id="l359"></a><a href="#l359">359</a><td>        rval = f.call(opt_obj, rval, val, index, arr);<tr><td><a id="l360"></a><a href="#l360">360</a><td>      });<tr><td><a id="l361"></a><a href="#l361">361</a><td>      return rval;<tr><td><a id="l362"></a><a href="#l362">362</a><td>    };<tr><td><a id="l363"></a><a href="#l363">363</a><td><tr><td><a id="l364"></a><a href="#l364">364</a><td><tr><td><a id="l365"></a><a href="#l365">365</a><td>/**<tr><td><a id="l366"></a><a href="#l366">366</a><td> * Passes every element of an array into a function and accumulates the result,<tr><td><a id="l367"></a><a href="#l367">367</a><td> * starting from the last element and working towards the first.<tr><td><a id="l368"></a><a href="#l368">368</a><td> *<tr><td><a id="l369"></a><a href="#l369">369</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-reduceright}<tr><td><a id="l370"></a><a href="#l370">370</a><td> *<tr><td><a id="l371"></a><a href="#l371">371</a><td> * For example:<tr><td><a id="l372"></a><a href="#l372">372</a><td> * var a = [&#39;a&#39;, &#39;b&#39;, &#39;c&#39;];<tr><td><a id="l373"></a><a href="#l373">373</a><td> * goog.array.reduceRight(a, function(r, v, i, arr) {return r + v;}, &#39;&#39;);<tr><td><a id="l374"></a><a href="#l374">374</a><td> * returns &#39;cba&#39;<tr><td><a id="l375"></a><a href="#l375">375</a><td> *<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l377"></a><a href="#l377">377</a><td> *     like object over which to iterate.<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @param {?function(this:S, R, T, number, ?) : R} f The function to call for<tr><td><a id="l379"></a><a href="#l379">379</a><td> *     every element. This function<tr><td><a id="l380"></a><a href="#l380">380</a><td> *     takes 4 arguments (the function&#39;s previous result or the initial value,<tr><td><a id="l381"></a><a href="#l381">381</a><td> *     the value of the current array element, the current array index, and the<tr><td><a id="l382"></a><a href="#l382">382</a><td> *     array itself)<tr><td><a id="l383"></a><a href="#l383">383</a><td> *     function(previousValue, currentValue, index, array).<tr><td><a id="l384"></a><a href="#l384">384</a><td> * @param {?} val The initial value to pass into the function on the first call.<tr><td><a id="l385"></a><a href="#l385">385</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a id="l386"></a><a href="#l386">386</a><td> *     within f.<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @return {R} Object returned as a result of evaluating f repeatedly across the<tr><td><a id="l388"></a><a href="#l388">388</a><td> *     values of the array.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @template T,S,R<tr><td><a id="l390"></a><a href="#l390">390</a><td> */<tr><td><a id="l391"></a><a href="#l391">391</a><td>goog.array.reduceRight = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l392"></a><a href="#l392">392</a><td>                         (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l393"></a><a href="#l393">393</a><td>                          goog.array.ARRAY_PROTOTYPE_.reduceRight) ?<tr><td><a id="l394"></a><a href="#l394">394</a><td>    function(arr, f, val, opt_obj) {<tr><td><a id="l395"></a><a href="#l395">395</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l396"></a><a href="#l396">396</a><td>      if (opt_obj) {<tr><td><a id="l397"></a><a href="#l397">397</a><td>        f = goog.bind(f, opt_obj);<tr><td><a id="l398"></a><a href="#l398">398</a><td>      }<tr><td><a id="l399"></a><a href="#l399">399</a><td>      return goog.array.ARRAY_PROTOTYPE_.reduceRight.call(arr, f, val);<tr><td><a id="l400"></a><a href="#l400">400</a><td>    } :<tr><td><a id="l401"></a><a href="#l401">401</a><td>    function(arr, f, val, opt_obj) {<tr><td><a id="l402"></a><a href="#l402">402</a><td>      var rval = val;<tr><td><a id="l403"></a><a href="#l403">403</a><td>      goog.array.forEachRight(arr, function(val, index) {<tr><td><a id="l404"></a><a href="#l404">404</a><td>        rval = f.call(opt_obj, rval, val, index, arr);<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 rval;<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> * Calls f for each element of an array. If any call returns true, some()<tr><td><a id="l412"></a><a href="#l412">412</a><td> * returns true (without checking the remaining elements). If all calls<tr><td><a id="l413"></a><a href="#l413">413</a><td> * return false, some() returns false.<tr><td><a id="l414"></a><a href="#l414">414</a><td> *<tr><td><a id="l415"></a><a href="#l415">415</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-some}<tr><td><a id="l416"></a><a href="#l416">416</a><td> *<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l418"></a><a href="#l418">418</a><td> *     like object over which to iterate.<tr><td><a id="l419"></a><a href="#l419">419</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call for<tr><td><a id="l420"></a><a href="#l420">420</a><td> *     for every element. This function takes 3 arguments (the element, the<tr><td><a id="l421"></a><a href="#l421">421</a><td> *     index and the array) and should return a boolean.<tr><td><a id="l422"></a><a href="#l422">422</a><td> * @param {S=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a id="l423"></a><a href="#l423">423</a><td> *     within f.<tr><td><a id="l424"></a><a href="#l424">424</a><td> * @return {boolean} true if any element passes the test.<tr><td><a id="l425"></a><a href="#l425">425</a><td> * @template T,S<tr><td><a id="l426"></a><a href="#l426">426</a><td> */<tr><td><a id="l427"></a><a href="#l427">427</a><td>goog.array.some = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l428"></a><a href="#l428">428</a><td>                  (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l429"></a><a href="#l429">429</a><td>                   goog.array.ARRAY_PROTOTYPE_.some) ?<tr><td><a id="l430"></a><a href="#l430">430</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l431"></a><a href="#l431">431</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l432"></a><a href="#l432">432</a><td><tr><td><a id="l433"></a><a href="#l433">433</a><td>      return goog.array.ARRAY_PROTOTYPE_.some.call(arr, f, opt_obj);<tr><td><a id="l434"></a><a href="#l434">434</a><td>    } :<tr><td><a id="l435"></a><a href="#l435">435</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l436"></a><a href="#l436">436</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a id="l437"></a><a href="#l437">437</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a id="l438"></a><a href="#l438">438</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a id="l439"></a><a href="#l439">439</a><td>        if (i in arr2 &amp;&amp; f.call(opt_obj, arr2[i], i, arr)) {<tr><td><a id="l440"></a><a href="#l440">440</a><td>          return true;<tr><td><a id="l441"></a><a href="#l441">441</a><td>        }<tr><td><a id="l442"></a><a href="#l442">442</a><td>      }<tr><td><a id="l443"></a><a href="#l443">443</a><td>      return false;<tr><td><a id="l444"></a><a href="#l444">444</a><td>    };<tr><td><a id="l445"></a><a href="#l445">445</a><td><tr><td><a id="l446"></a><a href="#l446">446</a><td><tr><td><a id="l447"></a><a href="#l447">447</a><td>/**<tr><td><a id="l448"></a><a href="#l448">448</a><td> * Call f for each element of an array. If all calls return true, every()<tr><td><a id="l449"></a><a href="#l449">449</a><td> * returns true. If any call returns false, every() returns false and<tr><td><a id="l450"></a><a href="#l450">450</a><td> * does not continue to check the remaining elements.<tr><td><a id="l451"></a><a href="#l451">451</a><td> *<tr><td><a id="l452"></a><a href="#l452">452</a><td> * See {@link http://tinyurl.com/developer-mozilla-org-array-every}<tr><td><a id="l453"></a><a href="#l453">453</a><td> *<tr><td><a id="l454"></a><a href="#l454">454</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l455"></a><a href="#l455">455</a><td> *     like object over which to iterate.<tr><td><a id="l456"></a><a href="#l456">456</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call for<tr><td><a id="l457"></a><a href="#l457">457</a><td> *     for every element. This function takes 3 arguments (the element, the<tr><td><a id="l458"></a><a href="#l458">458</a><td> *     index and the array) and should return a boolean.<tr><td><a id="l459"></a><a href="#l459">459</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a id="l460"></a><a href="#l460">460</a><td> *     within f.<tr><td><a id="l461"></a><a href="#l461">461</a><td> * @return {boolean} false if any element fails the test.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @template T,S<tr><td><a id="l463"></a><a href="#l463">463</a><td> */<tr><td><a id="l464"></a><a href="#l464">464</a><td>goog.array.every = goog.NATIVE_ARRAY_PROTOTYPES &amp;&amp;<tr><td><a id="l465"></a><a href="#l465">465</a><td>                   (goog.array.ASSUME_NATIVE_FUNCTIONS ||<tr><td><a id="l466"></a><a href="#l466">466</a><td>                    goog.array.ARRAY_PROTOTYPE_.every) ?<tr><td><a id="l467"></a><a href="#l467">467</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l468"></a><a href="#l468">468</a><td>      goog.asserts.assert(arr.length != null);<tr><td><a id="l469"></a><a href="#l469">469</a><td><tr><td><a id="l470"></a><a href="#l470">470</a><td>      return goog.array.ARRAY_PROTOTYPE_.every.call(arr, f, opt_obj);<tr><td><a id="l471"></a><a href="#l471">471</a><td>    } :<tr><td><a id="l472"></a><a href="#l472">472</a><td>    function(arr, f, opt_obj) {<tr><td><a id="l473"></a><a href="#l473">473</a><td>      var l = arr.length;  // must be fixed during loop... see docs<tr><td><a id="l474"></a><a href="#l474">474</a><td>      var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a id="l475"></a><a href="#l475">475</a><td>      for (var i = 0; i &lt; l; i++) {<tr><td><a id="l476"></a><a href="#l476">476</a><td>        if (i in arr2 &amp;&amp; !f.call(opt_obj, arr2[i], i, arr)) {<tr><td><a id="l477"></a><a href="#l477">477</a><td>          return false;<tr><td><a id="l478"></a><a href="#l478">478</a><td>        }<tr><td><a id="l479"></a><a href="#l479">479</a><td>      }<tr><td><a id="l480"></a><a href="#l480">480</a><td>      return true;<tr><td><a id="l481"></a><a href="#l481">481</a><td>    };<tr><td><a id="l482"></a><a href="#l482">482</a><td><tr><td><a id="l483"></a><a href="#l483">483</a><td><tr><td><a id="l484"></a><a href="#l484">484</a><td>/**<tr><td><a id="l485"></a><a href="#l485">485</a><td> * Counts the array elements that fulfill the predicate, i.e. for which the<tr><td><a id="l486"></a><a href="#l486">486</a><td> * callback function returns true. Skips holes in the array.<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 {!(Array&lt;T&gt;|goog.array.ArrayLike)} arr Array or array like object<tr><td><a id="l489"></a><a href="#l489">489</a><td> *     over which to iterate.<tr><td><a id="l490"></a><a href="#l490">490</a><td> * @param {function(this: S, T, number, ?): boolean} f The function to call for<tr><td><a id="l491"></a><a href="#l491">491</a><td> *     every element. Takes 3 arguments (the element, the index and the array).<tr><td><a id="l492"></a><a href="#l492">492</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39; within f.<tr><td><a id="l493"></a><a href="#l493">493</a><td> * @return {number} The number of the matching elements.<tr><td><a id="l494"></a><a href="#l494">494</a><td> * @template T,S<tr><td><a id="l495"></a><a href="#l495">495</a><td> */<tr><td><a id="l496"></a><a href="#l496">496</a><td>goog.array.count = function(arr, f, opt_obj) {<tr><td><a id="l497"></a><a href="#l497">497</a><td>  var count = 0;<tr><td><a id="l498"></a><a href="#l498">498</a><td>  goog.array.forEach(arr, function(element, index, arr) {<tr><td><a id="l499"></a><a href="#l499">499</a><td>    if (f.call(opt_obj, element, index, arr)) {<tr><td><a id="l500"></a><a href="#l500">500</a><td>      ++count;<tr><td><a id="l501"></a><a href="#l501">501</a><td>    }<tr><td><a id="l502"></a><a href="#l502">502</a><td>  }, opt_obj);<tr><td><a id="l503"></a><a href="#l503">503</a><td>  return count;<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><tr><td><a id="l507"></a><a href="#l507">507</a><td>/**<tr><td><a id="l508"></a><a href="#l508">508</a><td> * Search an array for the first element that satisfies a given condition and<tr><td><a id="l509"></a><a href="#l509">509</a><td> * return that element.<tr><td><a id="l510"></a><a href="#l510">510</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l511"></a><a href="#l511">511</a><td> *     like object over which to iterate.<tr><td><a id="l512"></a><a href="#l512">512</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a id="l513"></a><a href="#l513">513</a><td> *     for every element. This function takes 3 arguments (the element, the<tr><td><a id="l514"></a><a href="#l514">514</a><td> *     index and the array) and should return a boolean.<tr><td><a id="l515"></a><a href="#l515">515</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a id="l516"></a><a href="#l516">516</a><td> * @return {T|null} The first array element that passes the test, or null if no<tr><td><a id="l517"></a><a href="#l517">517</a><td> *     element is found.<tr><td><a id="l518"></a><a href="#l518">518</a><td> * @template T,S<tr><td><a id="l519"></a><a href="#l519">519</a><td> */<tr><td><a id="l520"></a><a href="#l520">520</a><td>goog.array.find = function(arr, f, opt_obj) {<tr><td><a id="l521"></a><a href="#l521">521</a><td>  var i = goog.array.findIndex(arr, f, opt_obj);<tr><td><a id="l522"></a><a href="#l522">522</a><td>  return i &lt; 0 ? null : goog.isString(arr) ? arr.charAt(i) : arr[i];<tr><td><a id="l523"></a><a href="#l523">523</a><td>};<tr><td><a id="l524"></a><a href="#l524">524</a><td><tr><td><a id="l525"></a><a href="#l525">525</a><td><tr><td><a id="l526"></a><a href="#l526">526</a><td>/**<tr><td><a id="l527"></a><a href="#l527">527</a><td> * Search an array for the first element that satisfies a given condition and<tr><td><a id="l528"></a><a href="#l528">528</a><td> * return its index.<tr><td><a id="l529"></a><a href="#l529">529</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l530"></a><a href="#l530">530</a><td> *     like object over which to iterate.<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call for<tr><td><a id="l532"></a><a href="#l532">532</a><td> *     every element. This function<tr><td><a id="l533"></a><a href="#l533">533</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a id="l534"></a><a href="#l534">534</a><td> *     return a boolean.<tr><td><a id="l535"></a><a href="#l535">535</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a id="l536"></a><a href="#l536">536</a><td> * @return {number} The index of the first array element that passes the test,<tr><td><a id="l537"></a><a href="#l537">537</a><td> *     or -1 if no element is found.<tr><td><a id="l538"></a><a href="#l538">538</a><td> * @template T,S<tr><td><a id="l539"></a><a href="#l539">539</a><td> */<tr><td><a id="l540"></a><a href="#l540">540</a><td>goog.array.findIndex = function(arr, f, opt_obj) {<tr><td><a id="l541"></a><a href="#l541">541</a><td>  var l = arr.length;  // must be fixed during loop... see docs<tr><td><a id="l542"></a><a href="#l542">542</a><td>  var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a id="l543"></a><a href="#l543">543</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a id="l544"></a><a href="#l544">544</a><td>    if (i in arr2 &amp;&amp; f.call(opt_obj, arr2[i], i, arr)) {<tr><td><a id="l545"></a><a href="#l545">545</a><td>      return i;<tr><td><a id="l546"></a><a href="#l546">546</a><td>    }<tr><td><a id="l547"></a><a href="#l547">547</a><td>  }<tr><td><a id="l548"></a><a href="#l548">548</a><td>  return -1;<tr><td><a id="l549"></a><a href="#l549">549</a><td>};<tr><td><a id="l550"></a><a href="#l550">550</a><td><tr><td><a id="l551"></a><a href="#l551">551</a><td><tr><td><a id="l552"></a><a href="#l552">552</a><td>/**<tr><td><a id="l553"></a><a href="#l553">553</a><td> * Search an array (in reverse order) for the last element that satisfies a<tr><td><a id="l554"></a><a href="#l554">554</a><td> * given condition and return that element.<tr><td><a id="l555"></a><a href="#l555">555</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l556"></a><a href="#l556">556</a><td> *     like object over which to iterate.<tr><td><a id="l557"></a><a href="#l557">557</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a id="l558"></a><a href="#l558">558</a><td> *     for every element. This function<tr><td><a id="l559"></a><a href="#l559">559</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a id="l560"></a><a href="#l560">560</a><td> *     return a boolean.<tr><td><a id="l561"></a><a href="#l561">561</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a id="l562"></a><a href="#l562">562</a><td> * @return {T|null} The last array element that passes the test, or null if no<tr><td><a id="l563"></a><a href="#l563">563</a><td> *     element is found.<tr><td><a id="l564"></a><a href="#l564">564</a><td> * @template T,S<tr><td><a id="l565"></a><a href="#l565">565</a><td> */<tr><td><a id="l566"></a><a href="#l566">566</a><td>goog.array.findRight = function(arr, f, opt_obj) {<tr><td><a id="l567"></a><a href="#l567">567</a><td>  var i = goog.array.findIndexRight(arr, f, opt_obj);<tr><td><a id="l568"></a><a href="#l568">568</a><td>  return i &lt; 0 ? null : goog.isString(arr) ? arr.charAt(i) : arr[i];<tr><td><a id="l569"></a><a href="#l569">569</a><td>};<tr><td><a id="l570"></a><a href="#l570">570</a><td><tr><td><a id="l571"></a><a href="#l571">571</a><td><tr><td><a id="l572"></a><a href="#l572">572</a><td>/**<tr><td><a id="l573"></a><a href="#l573">573</a><td> * Search an array (in reverse order) for the last element that satisfies a<tr><td><a id="l574"></a><a href="#l574">574</a><td> * given condition and return its index.<tr><td><a id="l575"></a><a href="#l575">575</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l576"></a><a href="#l576">576</a><td> *     like object over which to iterate.<tr><td><a id="l577"></a><a href="#l577">577</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a id="l578"></a><a href="#l578">578</a><td> *     for every element. This function<tr><td><a id="l579"></a><a href="#l579">579</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a id="l580"></a><a href="#l580">580</a><td> *     return a boolean.<tr><td><a id="l581"></a><a href="#l581">581</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a id="l582"></a><a href="#l582">582</a><td> * @return {number} The index of the last array element that passes the test,<tr><td><a id="l583"></a><a href="#l583">583</a><td> *     or -1 if no element is found.<tr><td><a id="l584"></a><a href="#l584">584</a><td> * @template T,S<tr><td><a id="l585"></a><a href="#l585">585</a><td> */<tr><td><a id="l586"></a><a href="#l586">586</a><td>goog.array.findIndexRight = function(arr, f, opt_obj) {<tr><td><a id="l587"></a><a href="#l587">587</a><td>  var l = arr.length;  // must be fixed during loop... see docs<tr><td><a id="l588"></a><a href="#l588">588</a><td>  var arr2 = goog.isString(arr) ? arr.split(&#39;&#39;) : arr;<tr><td><a id="l589"></a><a href="#l589">589</a><td>  for (var i = l - 1; i &gt;= 0; i--) {<tr><td><a id="l590"></a><a href="#l590">590</a><td>    if (i in arr2 &amp;&amp; f.call(opt_obj, arr2[i], i, arr)) {<tr><td><a id="l591"></a><a href="#l591">591</a><td>      return i;<tr><td><a id="l592"></a><a href="#l592">592</a><td>    }<tr><td><a id="l593"></a><a href="#l593">593</a><td>  }<tr><td><a id="l594"></a><a href="#l594">594</a><td>  return -1;<tr><td><a id="l595"></a><a href="#l595">595</a><td>};<tr><td><a id="l596"></a><a href="#l596">596</a><td><tr><td><a id="l597"></a><a href="#l597">597</a><td><tr><td><a id="l598"></a><a href="#l598">598</a><td>/**<tr><td><a id="l599"></a><a href="#l599">599</a><td> * Whether the array contains the given object.<tr><td><a id="l600"></a><a href="#l600">600</a><td> * @param {goog.array.ArrayLike} arr The array to test for the presence of the<tr><td><a id="l601"></a><a href="#l601">601</a><td> *     element.<tr><td><a id="l602"></a><a href="#l602">602</a><td> * @param {*} obj The object for which to test.<tr><td><a id="l603"></a><a href="#l603">603</a><td> * @return {boolean} true if obj is present.<tr><td><a id="l604"></a><a href="#l604">604</a><td> */<tr><td><a id="l605"></a><a href="#l605">605</a><td>goog.array.contains = function(arr, obj) {<tr><td><a id="l606"></a><a href="#l606">606</a><td>  return goog.array.indexOf(arr, obj) &gt;= 0;<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>/**<tr><td><a id="l611"></a><a href="#l611">611</a><td> * Whether the array is empty.<tr><td><a id="l612"></a><a href="#l612">612</a><td> * @param {goog.array.ArrayLike} arr The array to test.<tr><td><a id="l613"></a><a href="#l613">613</a><td> * @return {boolean} true if empty.<tr><td><a id="l614"></a><a href="#l614">614</a><td> */<tr><td><a id="l615"></a><a href="#l615">615</a><td>goog.array.isEmpty = function(arr) {<tr><td><a id="l616"></a><a href="#l616">616</a><td>  return arr.length == 0;<tr><td><a id="l617"></a><a href="#l617">617</a><td>};<tr><td><a id="l618"></a><a href="#l618">618</a><td><tr><td><a id="l619"></a><a href="#l619">619</a><td><tr><td><a id="l620"></a><a href="#l620">620</a><td>/**<tr><td><a id="l621"></a><a href="#l621">621</a><td> * Clears the array.<tr><td><a id="l622"></a><a href="#l622">622</a><td> * @param {goog.array.ArrayLike} arr Array or array like object to clear.<tr><td><a id="l623"></a><a href="#l623">623</a><td> */<tr><td><a id="l624"></a><a href="#l624">624</a><td>goog.array.clear = function(arr) {<tr><td><a id="l625"></a><a href="#l625">625</a><td>  // For non real arrays we don&#39;t have the magic length so we delete the<tr><td><a id="l626"></a><a href="#l626">626</a><td>  // indices.<tr><td><a id="l627"></a><a href="#l627">627</a><td>  if (!goog.isArray(arr)) {<tr><td><a id="l628"></a><a href="#l628">628</a><td>    for (var i = arr.length - 1; i &gt;= 0; i--) {<tr><td><a id="l629"></a><a href="#l629">629</a><td>      delete arr[i];<tr><td><a id="l630"></a><a href="#l630">630</a><td>    }<tr><td><a id="l631"></a><a href="#l631">631</a><td>  }<tr><td><a id="l632"></a><a href="#l632">632</a><td>  arr.length = 0;<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> * Pushes an item into an array, if it&#39;s not already in the array.<tr><td><a id="l638"></a><a href="#l638">638</a><td> * @param {Array&lt;T&gt;} arr Array into which to insert the item.<tr><td><a id="l639"></a><a href="#l639">639</a><td> * @param {T} obj Value to add.<tr><td><a id="l640"></a><a href="#l640">640</a><td> * @template T<tr><td><a id="l641"></a><a href="#l641">641</a><td> */<tr><td><a id="l642"></a><a href="#l642">642</a><td>goog.array.insert = function(arr, obj) {<tr><td><a id="l643"></a><a href="#l643">643</a><td>  if (!goog.array.contains(arr, obj)) {<tr><td><a id="l644"></a><a href="#l644">644</a><td>    arr.push(obj);<tr><td><a id="l645"></a><a href="#l645">645</a><td>  }<tr><td><a id="l646"></a><a href="#l646">646</a><td>};<tr><td><a id="l647"></a><a href="#l647">647</a><td><tr><td><a id="l648"></a><a href="#l648">648</a><td><tr><td><a id="l649"></a><a href="#l649">649</a><td>/**<tr><td><a id="l650"></a><a href="#l650">650</a><td> * Inserts an object at the given index of the array.<tr><td><a id="l651"></a><a href="#l651">651</a><td> * @param {goog.array.ArrayLike} arr The array to modify.<tr><td><a id="l652"></a><a href="#l652">652</a><td> * @param {*} obj The object to insert.<tr><td><a id="l653"></a><a href="#l653">653</a><td> * @param {number=} opt_i The index at which to insert the object. If omitted,<tr><td><a id="l654"></a><a href="#l654">654</a><td> *      treated as 0. A negative index is counted from the end of the array.<tr><td><a id="l655"></a><a href="#l655">655</a><td> */<tr><td><a id="l656"></a><a href="#l656">656</a><td>goog.array.insertAt = function(arr, obj, opt_i) {<tr><td><a id="l657"></a><a href="#l657">657</a><td>  goog.array.splice(arr, opt_i, 0, obj);<tr><td><a id="l658"></a><a href="#l658">658</a><td>};<tr><td><a id="l659"></a><a href="#l659">659</a><td><tr><td><a id="l660"></a><a href="#l660">660</a><td><tr><td><a id="l661"></a><a href="#l661">661</a><td>/**<tr><td><a id="l662"></a><a href="#l662">662</a><td> * Inserts at the given index of the array, all elements of another array.<tr><td><a id="l663"></a><a href="#l663">663</a><td> * @param {goog.array.ArrayLike} arr The array to modify.<tr><td><a id="l664"></a><a href="#l664">664</a><td> * @param {goog.array.ArrayLike} elementsToAdd The array of elements to add.<tr><td><a id="l665"></a><a href="#l665">665</a><td> * @param {number=} opt_i The index at which to insert the object. If omitted,<tr><td><a id="l666"></a><a href="#l666">666</a><td> *      treated as 0. A negative index is counted from the end of the array.<tr><td><a id="l667"></a><a href="#l667">667</a><td> */<tr><td><a id="l668"></a><a href="#l668">668</a><td>goog.array.insertArrayAt = function(arr, elementsToAdd, opt_i) {<tr><td><a id="l669"></a><a href="#l669">669</a><td>  goog.partial(goog.array.splice, arr, opt_i, 0).apply(null, elementsToAdd);<tr><td><a id="l670"></a><a href="#l670">670</a><td>};<tr><td><a id="l671"></a><a href="#l671">671</a><td><tr><td><a id="l672"></a><a href="#l672">672</a><td><tr><td><a id="l673"></a><a href="#l673">673</a><td>/**<tr><td><a id="l674"></a><a href="#l674">674</a><td> * Inserts an object into an array before a specified object.<tr><td><a id="l675"></a><a href="#l675">675</a><td> * @param {Array&lt;T&gt;} arr The array to modify.<tr><td><a id="l676"></a><a href="#l676">676</a><td> * @param {T} obj The object to insert.<tr><td><a id="l677"></a><a href="#l677">677</a><td> * @param {T=} opt_obj2 The object before which obj should be inserted. If obj2<tr><td><a id="l678"></a><a href="#l678">678</a><td> *     is omitted or not found, obj is inserted at the end of the array.<tr><td><a id="l679"></a><a href="#l679">679</a><td> * @template T<tr><td><a id="l680"></a><a href="#l680">680</a><td> */<tr><td><a id="l681"></a><a href="#l681">681</a><td>goog.array.insertBefore = function(arr, obj, opt_obj2) {<tr><td><a id="l682"></a><a href="#l682">682</a><td>  var i;<tr><td><a id="l683"></a><a href="#l683">683</a><td>  if (arguments.length == 2 || (i = goog.array.indexOf(arr, opt_obj2)) &lt; 0) {<tr><td><a id="l684"></a><a href="#l684">684</a><td>    arr.push(obj);<tr><td><a id="l685"></a><a href="#l685">685</a><td>  } else {<tr><td><a id="l686"></a><a href="#l686">686</a><td>    goog.array.insertAt(arr, obj, i);<tr><td><a id="l687"></a><a href="#l687">687</a><td>  }<tr><td><a id="l688"></a><a href="#l688">688</a><td>};<tr><td><a id="l689"></a><a href="#l689">689</a><td><tr><td><a id="l690"></a><a href="#l690">690</a><td><tr><td><a id="l691"></a><a href="#l691">691</a><td>/**<tr><td><a id="l692"></a><a href="#l692">692</a><td> * Removes the first occurrence of a particular value from an array.<tr><td><a id="l693"></a><a href="#l693">693</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array from which to remove<tr><td><a id="l694"></a><a href="#l694">694</a><td> *     value.<tr><td><a id="l695"></a><a href="#l695">695</a><td> * @param {T} obj Object to remove.<tr><td><a id="l696"></a><a href="#l696">696</a><td> * @return {boolean} True if an element was removed.<tr><td><a id="l697"></a><a href="#l697">697</a><td> * @template T<tr><td><a id="l698"></a><a href="#l698">698</a><td> */<tr><td><a id="l699"></a><a href="#l699">699</a><td>goog.array.remove = function(arr, obj) {<tr><td><a id="l700"></a><a href="#l700">700</a><td>  var i = goog.array.indexOf(arr, obj);<tr><td><a id="l701"></a><a href="#l701">701</a><td>  var rv;<tr><td><a id="l702"></a><a href="#l702">702</a><td>  if ((rv = i &gt;= 0)) {<tr><td><a id="l703"></a><a href="#l703">703</a><td>    goog.array.removeAt(arr, i);<tr><td><a id="l704"></a><a href="#l704">704</a><td>  }<tr><td><a id="l705"></a><a href="#l705">705</a><td>  return rv;<tr><td><a id="l706"></a><a href="#l706">706</a><td>};<tr><td><a id="l707"></a><a href="#l707">707</a><td><tr><td><a id="l708"></a><a href="#l708">708</a><td><tr><td><a id="l709"></a><a href="#l709">709</a><td>/**<tr><td><a id="l710"></a><a href="#l710">710</a><td> * Removes from an array the element at index i<tr><td><a id="l711"></a><a href="#l711">711</a><td> * @param {goog.array.ArrayLike} arr Array or array like object from which to<tr><td><a id="l712"></a><a href="#l712">712</a><td> *     remove value.<tr><td><a id="l713"></a><a href="#l713">713</a><td> * @param {number} i The index to remove.<tr><td><a id="l714"></a><a href="#l714">714</a><td> * @return {boolean} True if an element was removed.<tr><td><a id="l715"></a><a href="#l715">715</a><td> */<tr><td><a id="l716"></a><a href="#l716">716</a><td>goog.array.removeAt = function(arr, i) {<tr><td><a id="l717"></a><a href="#l717">717</a><td>  goog.asserts.assert(arr.length != null);<tr><td><a id="l718"></a><a href="#l718">718</a><td><tr><td><a id="l719"></a><a href="#l719">719</a><td>  // use generic form of splice<tr><td><a id="l720"></a><a href="#l720">720</a><td>  // splice returns the removed items and if successful the length of that<tr><td><a id="l721"></a><a href="#l721">721</a><td>  // will be 1<tr><td><a id="l722"></a><a href="#l722">722</a><td>  return goog.array.ARRAY_PROTOTYPE_.splice.call(arr, i, 1).length == 1;<tr><td><a id="l723"></a><a href="#l723">723</a><td>};<tr><td><a id="l724"></a><a href="#l724">724</a><td><tr><td><a id="l725"></a><a href="#l725">725</a><td><tr><td><a id="l726"></a><a href="#l726">726</a><td>/**<tr><td><a id="l727"></a><a href="#l727">727</a><td> * Removes the first value that satisfies the given condition.<tr><td><a id="l728"></a><a href="#l728">728</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l729"></a><a href="#l729">729</a><td> *     like object over which to iterate.<tr><td><a id="l730"></a><a href="#l730">730</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a id="l731"></a><a href="#l731">731</a><td> *     for every element. This function<tr><td><a id="l732"></a><a href="#l732">732</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a id="l733"></a><a href="#l733">733</a><td> *     return a boolean.<tr><td><a id="l734"></a><a href="#l734">734</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a id="l735"></a><a href="#l735">735</a><td> * @return {boolean} True if an element was removed.<tr><td><a id="l736"></a><a href="#l736">736</a><td> * @template T,S<tr><td><a id="l737"></a><a href="#l737">737</a><td> */<tr><td><a id="l738"></a><a href="#l738">738</a><td>goog.array.removeIf = function(arr, f, opt_obj) {<tr><td><a id="l739"></a><a href="#l739">739</a><td>  var i = goog.array.findIndex(arr, f, opt_obj);<tr><td><a id="l740"></a><a href="#l740">740</a><td>  if (i &gt;= 0) {<tr><td><a id="l741"></a><a href="#l741">741</a><td>    goog.array.removeAt(arr, i);<tr><td><a id="l742"></a><a href="#l742">742</a><td>    return true;<tr><td><a id="l743"></a><a href="#l743">743</a><td>  }<tr><td><a id="l744"></a><a href="#l744">744</a><td>  return false;<tr><td><a id="l745"></a><a href="#l745">745</a><td>};<tr><td><a id="l746"></a><a href="#l746">746</a><td><tr><td><a id="l747"></a><a href="#l747">747</a><td><tr><td><a id="l748"></a><a href="#l748">748</a><td>/**<tr><td><a id="l749"></a><a href="#l749">749</a><td> * Removes all values that satisfy the given condition.<tr><td><a id="l750"></a><a href="#l750">750</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array<tr><td><a id="l751"></a><a href="#l751">751</a><td> *     like object over which to iterate.<tr><td><a id="l752"></a><a href="#l752">752</a><td> * @param {?function(this:S, T, number, ?) : boolean} f The function to call<tr><td><a id="l753"></a><a href="#l753">753</a><td> *     for every element. This function<tr><td><a id="l754"></a><a href="#l754">754</a><td> *     takes 3 arguments (the element, the index and the array) and should<tr><td><a id="l755"></a><a href="#l755">755</a><td> *     return a boolean.<tr><td><a id="l756"></a><a href="#l756">756</a><td> * @param {S=} opt_obj An optional &quot;this&quot; context for the function.<tr><td><a id="l757"></a><a href="#l757">757</a><td> * @return {number} The number of items removed<tr><td><a id="l758"></a><a href="#l758">758</a><td> * @template T,S<tr><td><a id="l759"></a><a href="#l759">759</a><td> */<tr><td><a id="l760"></a><a href="#l760">760</a><td>goog.array.removeAllIf = function(arr, f, opt_obj) {<tr><td><a id="l761"></a><a href="#l761">761</a><td>  var removedCount = 0;<tr><td><a id="l762"></a><a href="#l762">762</a><td>  goog.array.forEachRight(arr, function(val, index) {<tr><td><a id="l763"></a><a href="#l763">763</a><td>    if (f.call(opt_obj, val, index, arr)) {<tr><td><a id="l764"></a><a href="#l764">764</a><td>      if (goog.array.removeAt(arr, index)) {<tr><td><a id="l765"></a><a href="#l765">765</a><td>        removedCount++;<tr><td><a id="l766"></a><a href="#l766">766</a><td>      }<tr><td><a id="l767"></a><a href="#l767">767</a><td>    }<tr><td><a id="l768"></a><a href="#l768">768</a><td>  });<tr><td><a id="l769"></a><a href="#l769">769</a><td>  return removedCount;<tr><td><a id="l770"></a><a href="#l770">770</a><td>};<tr><td><a id="l771"></a><a href="#l771">771</a><td><tr><td><a id="l772"></a><a href="#l772">772</a><td><tr><td><a id="l773"></a><a href="#l773">773</a><td>/**<tr><td><a id="l774"></a><a href="#l774">774</a><td> * Returns a new array that is the result of joining the arguments.  If arrays<tr><td><a id="l775"></a><a href="#l775">775</a><td> * are passed then their items are added, however, if non-arrays are passed they<tr><td><a id="l776"></a><a href="#l776">776</a><td> * will be added to the return array as is.<tr><td><a id="l777"></a><a href="#l777">777</a><td> *<tr><td><a id="l778"></a><a href="#l778">778</a><td> * Note that ArrayLike objects will be added as is, rather than having their<tr><td><a id="l779"></a><a href="#l779">779</a><td> * items added.<tr><td><a id="l780"></a><a href="#l780">780</a><td> *<tr><td><a id="l781"></a><a href="#l781">781</a><td> * goog.array.concat([1, 2], [3, 4]) -&gt; [1, 2, 3, 4]<tr><td><a id="l782"></a><a href="#l782">782</a><td> * goog.array.concat(0, [1, 2]) -&gt; [0, 1, 2]<tr><td><a id="l783"></a><a href="#l783">783</a><td> * goog.array.concat([1, 2], null) -&gt; [1, 2, null]<tr><td><a id="l784"></a><a href="#l784">784</a><td> *<tr><td><a id="l785"></a><a href="#l785">785</a><td> * There is bug in all current versions of IE (6, 7 and 8) where arrays created<tr><td><a id="l786"></a><a href="#l786">786</a><td> * in an iframe become corrupted soon (not immediately) after the iframe is<tr><td><a id="l787"></a><a href="#l787">787</a><td> * destroyed. This is common if loading data via goog.net.IframeIo, for example.<tr><td><a id="l788"></a><a href="#l788">788</a><td> * This corruption only affects the concat method which will start throwing<tr><td><a id="l789"></a><a href="#l789">789</a><td> * Catastrophic Errors (#-2147418113).<tr><td><a id="l790"></a><a href="#l790">790</a><td> *<tr><td><a id="l791"></a><a href="#l791">791</a><td> * See http://endoflow.com/scratch/corrupted-arrays.html for a test case.<tr><td><a id="l792"></a><a href="#l792">792</a><td> *<tr><td><a id="l793"></a><a href="#l793">793</a><td> * Internally goog.array should use this, so that all methods will continue to<tr><td><a id="l794"></a><a href="#l794">794</a><td> * work on these broken array objects.<tr><td><a id="l795"></a><a href="#l795">795</a><td> *<tr><td><a id="l796"></a><a href="#l796">796</a><td> * @param {...*} var_args Items to concatenate.  Arrays will have each item<tr><td><a id="l797"></a><a href="#l797">797</a><td> *     added, while primitives and objects will be added as is.<tr><td><a id="l798"></a><a href="#l798">798</a><td> * @return {!Array&lt;?&gt;} The new resultant array.<tr><td><a id="l799"></a><a href="#l799">799</a><td> */<tr><td><a id="l800"></a><a href="#l800">800</a><td>goog.array.concat = function(var_args) {<tr><td><a id="l801"></a><a href="#l801">801</a><td>  return goog.array.ARRAY_PROTOTYPE_.concat.apply(<tr><td><a id="l802"></a><a href="#l802">802</a><td>      goog.array.ARRAY_PROTOTYPE_, arguments);<tr><td><a id="l803"></a><a href="#l803">803</a><td>};<tr><td><a id="l804"></a><a href="#l804">804</a><td><tr><td><a id="l805"></a><a href="#l805">805</a><td><tr><td><a id="l806"></a><a href="#l806">806</a><td>/**<tr><td><a id="l807"></a><a href="#l807">807</a><td> * Returns a new array that contains the contents of all the arrays passed.<tr><td><a id="l808"></a><a href="#l808">808</a><td> * @param {...!Array&lt;T&gt;} var_args<tr><td><a id="l809"></a><a href="#l809">809</a><td> * @return {!Array&lt;T&gt;}<tr><td><a id="l810"></a><a href="#l810">810</a><td> * @template T<tr><td><a id="l811"></a><a href="#l811">811</a><td> */<tr><td><a id="l812"></a><a href="#l812">812</a><td>goog.array.join = function(var_args) {<tr><td><a id="l813"></a><a href="#l813">813</a><td>  return goog.array.ARRAY_PROTOTYPE_.concat.apply(<tr><td><a id="l814"></a><a href="#l814">814</a><td>      goog.array.ARRAY_PROTOTYPE_, arguments);<tr><td><a id="l815"></a><a href="#l815">815</a><td>};<tr><td><a id="l816"></a><a href="#l816">816</a><td><tr><td><a id="l817"></a><a href="#l817">817</a><td><tr><td><a id="l818"></a><a href="#l818">818</a><td>/**<tr><td><a id="l819"></a><a href="#l819">819</a><td> * Converts an object to an array.<tr><td><a id="l820"></a><a href="#l820">820</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} object  The object to convert to an<tr><td><a id="l821"></a><a href="#l821">821</a><td> *     array.<tr><td><a id="l822"></a><a href="#l822">822</a><td> * @return {!Array&lt;T&gt;} The object converted into an array. If object has a<tr><td><a id="l823"></a><a href="#l823">823</a><td> *     length property, every property indexed with a non-negative number<tr><td><a id="l824"></a><a href="#l824">824</a><td> *     less than length will be included in the result. If object does not<tr><td><a id="l825"></a><a href="#l825">825</a><td> *     have a length property, an empty array will be returned.<tr><td><a id="l826"></a><a href="#l826">826</a><td> * @template T<tr><td><a id="l827"></a><a href="#l827">827</a><td> */<tr><td><a id="l828"></a><a href="#l828">828</a><td>goog.array.toArray = function(object) {<tr><td><a id="l829"></a><a href="#l829">829</a><td>  var length = object.length;<tr><td><a id="l830"></a><a href="#l830">830</a><td><tr><td><a id="l831"></a><a href="#l831">831</a><td>  // If length is not a number the following it false. This case is kept for<tr><td><a id="l832"></a><a href="#l832">832</a><td>  // backwards compatibility since there are callers that pass objects that are<tr><td><a id="l833"></a><a href="#l833">833</a><td>  // not array like.<tr><td><a id="l834"></a><a href="#l834">834</a><td>  if (length &gt; 0) {<tr><td><a id="l835"></a><a href="#l835">835</a><td>    var rv = new Array(length);<tr><td><a id="l836"></a><a href="#l836">836</a><td>    for (var i = 0; i &lt; length; i++) {<tr><td><a id="l837"></a><a href="#l837">837</a><td>      rv[i] = object[i];<tr><td><a id="l838"></a><a href="#l838">838</a><td>    }<tr><td><a id="l839"></a><a href="#l839">839</a><td>    return rv;<tr><td><a id="l840"></a><a href="#l840">840</a><td>  }<tr><td><a id="l841"></a><a href="#l841">841</a><td>  return [];<tr><td><a id="l842"></a><a href="#l842">842</a><td>};<tr><td><a id="l843"></a><a href="#l843">843</a><td><tr><td><a id="l844"></a><a href="#l844">844</a><td><tr><td><a id="l845"></a><a href="#l845">845</a><td>/**<tr><td><a id="l846"></a><a href="#l846">846</a><td> * Does a shallow copy of an array.<tr><td><a id="l847"></a><a href="#l847">847</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr  Array or array-like object to<tr><td><a id="l848"></a><a href="#l848">848</a><td> *     clone.<tr><td><a id="l849"></a><a href="#l849">849</a><td> * @return {!Array&lt;T&gt;} Clone of the input array.<tr><td><a id="l850"></a><a href="#l850">850</a><td> * @template T<tr><td><a id="l851"></a><a href="#l851">851</a><td> */<tr><td><a id="l852"></a><a href="#l852">852</a><td>goog.array.clone = goog.array.toArray;<tr><td><a id="l853"></a><a href="#l853">853</a><td><tr><td><a id="l854"></a><a href="#l854">854</a><td><tr><td><a id="l855"></a><a href="#l855">855</a><td>/**<tr><td><a id="l856"></a><a href="#l856">856</a><td> * Extends an array with another array, element, or &quot;array like&quot; object.<tr><td><a id="l857"></a><a href="#l857">857</a><td> * This function operates &#39;in-place&#39;, it does not create a new Array.<tr><td><a id="l858"></a><a href="#l858">858</a><td> *<tr><td><a id="l859"></a><a href="#l859">859</a><td> * Example:<tr><td><a id="l860"></a><a href="#l860">860</a><td> * var a = [];<tr><td><a id="l861"></a><a href="#l861">861</a><td> * goog.array.extend(a, [0, 1]);<tr><td><a id="l862"></a><a href="#l862">862</a><td> * a; // [0, 1]<tr><td><a id="l863"></a><a href="#l863">863</a><td> * goog.array.extend(a, 2);<tr><td><a id="l864"></a><a href="#l864">864</a><td> * a; // [0, 1, 2]<tr><td><a id="l865"></a><a href="#l865">865</a><td> *<tr><td><a id="l866"></a><a href="#l866">866</a><td> * @param {Array&lt;VALUE&gt;} arr1  The array to modify.<tr><td><a id="l867"></a><a href="#l867">867</a><td> * @param {...(Array&lt;VALUE&gt;|VALUE)} var_args The elements or arrays of elements<tr><td><a id="l868"></a><a href="#l868">868</a><td> *     to add to arr1.<tr><td><a id="l869"></a><a href="#l869">869</a><td> * @template VALUE<tr><td><a id="l870"></a><a href="#l870">870</a><td> */<tr><td><a id="l871"></a><a href="#l871">871</a><td>goog.array.extend = function(arr1, var_args) {<tr><td><a id="l872"></a><a href="#l872">872</a><td>  for (var i = 1; i &lt; arguments.length; i++) {<tr><td><a id="l873"></a><a href="#l873">873</a><td>    var arr2 = arguments[i];<tr><td><a id="l874"></a><a href="#l874">874</a><td>    if (goog.isArrayLike(arr2)) {<tr><td><a id="l875"></a><a href="#l875">875</a><td>      var len1 = arr1.length || 0;<tr><td><a id="l876"></a><a href="#l876">876</a><td>      var len2 = arr2.length || 0;<tr><td><a id="l877"></a><a href="#l877">877</a><td>      arr1.length = len1 + len2;<tr><td><a id="l878"></a><a href="#l878">878</a><td>      for (var j = 0; j &lt; len2; j++) {<tr><td><a id="l879"></a><a href="#l879">879</a><td>        arr1[len1 + j] = arr2[j];<tr><td><a id="l880"></a><a href="#l880">880</a><td>      }<tr><td><a id="l881"></a><a href="#l881">881</a><td>    } else {<tr><td><a id="l882"></a><a href="#l882">882</a><td>      arr1.push(arr2);<tr><td><a id="l883"></a><a href="#l883">883</a><td>    }<tr><td><a id="l884"></a><a href="#l884">884</a><td>  }<tr><td><a id="l885"></a><a href="#l885">885</a><td>};<tr><td><a id="l886"></a><a href="#l886">886</a><td><tr><td><a id="l887"></a><a href="#l887">887</a><td><tr><td><a id="l888"></a><a href="#l888">888</a><td>/**<tr><td><a id="l889"></a><a href="#l889">889</a><td> * Adds or removes elements from an array. This is a generic version of Array<tr><td><a id="l890"></a><a href="#l890">890</a><td> * splice. This means that it might work on other objects similar to arrays,<tr><td><a id="l891"></a><a href="#l891">891</a><td> * such as the arguments object.<tr><td><a id="l892"></a><a href="#l892">892</a><td> *<tr><td><a id="l893"></a><a href="#l893">893</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr The array to modify.<tr><td><a id="l894"></a><a href="#l894">894</a><td> * @param {number|undefined} index The index at which to start changing the<tr><td><a id="l895"></a><a href="#l895">895</a><td> *     array. If not defined, treated as 0.<tr><td><a id="l896"></a><a href="#l896">896</a><td> * @param {number} howMany How many elements to remove (0 means no removal. A<tr><td><a id="l897"></a><a href="#l897">897</a><td> *     value below 0 is treated as zero and so is any other non number. Numbers<tr><td><a id="l898"></a><a href="#l898">898</a><td> *     are floored).<tr><td><a id="l899"></a><a href="#l899">899</a><td> * @param {...T} var_args Optional, additional elements to insert into the<tr><td><a id="l900"></a><a href="#l900">900</a><td> *     array.<tr><td><a id="l901"></a><a href="#l901">901</a><td> * @return {!Array&lt;T&gt;} the removed elements.<tr><td><a id="l902"></a><a href="#l902">902</a><td> * @template T<tr><td><a id="l903"></a><a href="#l903">903</a><td> */<tr><td><a id="l904"></a><a href="#l904">904</a><td>goog.array.splice = function(arr, index, howMany, var_args) {<tr><td><a id="l905"></a><a href="#l905">905</a><td>  goog.asserts.assert(arr.length != null);<tr><td><a id="l906"></a><a href="#l906">906</a><td><tr><td><a id="l907"></a><a href="#l907">907</a><td>  return goog.array.ARRAY_PROTOTYPE_.splice.apply(<tr><td><a id="l908"></a><a href="#l908">908</a><td>      arr, goog.array.slice(arguments, 1));<tr><td><a id="l909"></a><a href="#l909">909</a><td>};<tr><td><a id="l910"></a><a href="#l910">910</a><td><tr><td><a id="l911"></a><a href="#l911">911</a><td><tr><td><a id="l912"></a><a href="#l912">912</a><td>/**<tr><td><a id="l913"></a><a href="#l913">913</a><td> * Returns a new array from a segment of an array. This is a generic version of<tr><td><a id="l914"></a><a href="#l914">914</a><td> * Array slice. This means that it might work on other objects similar to<tr><td><a id="l915"></a><a href="#l915">915</a><td> * arrays, such as the arguments object.<tr><td><a id="l916"></a><a href="#l916">916</a><td> *<tr><td><a id="l917"></a><a href="#l917">917</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr The array from<tr><td><a id="l918"></a><a href="#l918">918</a><td> * which to copy a segment.<tr><td><a id="l919"></a><a href="#l919">919</a><td> * @param {number} start The index of the first element to copy.<tr><td><a id="l920"></a><a href="#l920">920</a><td> * @param {number=} opt_end The index after the last element to copy.<tr><td><a id="l921"></a><a href="#l921">921</a><td> * @return {!Array&lt;T&gt;} A new array containing the specified segment of the<tr><td><a id="l922"></a><a href="#l922">922</a><td> *     original array.<tr><td><a id="l923"></a><a href="#l923">923</a><td> * @template T<tr><td><a id="l924"></a><a href="#l924">924</a><td> */<tr><td><a id="l925"></a><a href="#l925">925</a><td>goog.array.slice = function(arr, start, opt_end) {<tr><td><a id="l926"></a><a href="#l926">926</a><td>  goog.asserts.assert(arr.length != null);<tr><td><a id="l927"></a><a href="#l927">927</a><td><tr><td><a id="l928"></a><a href="#l928">928</a><td>  // passing 1 arg to slice is not the same as passing 2 where the second is<tr><td><a id="l929"></a><a href="#l929">929</a><td>  // null or undefined (in that case the second argument is treated as 0).<tr><td><a id="l930"></a><a href="#l930">930</a><td>  // we could use slice on the arguments object and then use apply instead of<tr><td><a id="l931"></a><a href="#l931">931</a><td>  // testing the length<tr><td><a id="l932"></a><a href="#l932">932</a><td>  if (arguments.length &lt;= 2) {<tr><td><a id="l933"></a><a href="#l933">933</a><td>    return goog.array.ARRAY_PROTOTYPE_.slice.call(arr, start);<tr><td><a id="l934"></a><a href="#l934">934</a><td>  } else {<tr><td><a id="l935"></a><a href="#l935">935</a><td>    return goog.array.ARRAY_PROTOTYPE_.slice.call(arr, start, opt_end);<tr><td><a id="l936"></a><a href="#l936">936</a><td>  }<tr><td><a id="l937"></a><a href="#l937">937</a><td>};<tr><td><a id="l938"></a><a href="#l938">938</a><td><tr><td><a id="l939"></a><a href="#l939">939</a><td><tr><td><a id="l940"></a><a href="#l940">940</a><td>/**<tr><td><a id="l941"></a><a href="#l941">941</a><td> * Removes all duplicates from an array (retaining only the first<tr><td><a id="l942"></a><a href="#l942">942</a><td> * occurrence of each array element).  This function modifies the<tr><td><a id="l943"></a><a href="#l943">943</a><td> * array in place and doesn&#39;t change the order of the non-duplicate items.<tr><td><a id="l944"></a><a href="#l944">944</a><td> *<tr><td><a id="l945"></a><a href="#l945">945</a><td> * For objects, duplicates are identified as having the same unique ID as<tr><td><a id="l946"></a><a href="#l946">946</a><td> * defined by {@link goog.getUid}.<tr><td><a id="l947"></a><a href="#l947">947</a><td> *<tr><td><a id="l948"></a><a href="#l948">948</a><td> * Alternatively you can specify a custom hash function that returns a unique<tr><td><a id="l949"></a><a href="#l949">949</a><td> * value for each item in the array it should consider unique.<tr><td><a id="l950"></a><a href="#l950">950</a><td> *<tr><td><a id="l951"></a><a href="#l951">951</a><td> * Runtime: N,<tr><td><a id="l952"></a><a href="#l952">952</a><td> * Worstcase space: 2N (no dupes)<tr><td><a id="l953"></a><a href="#l953">953</a><td> *<tr><td><a id="l954"></a><a href="#l954">954</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr The array from which to remove<tr><td><a id="l955"></a><a href="#l955">955</a><td> *     duplicates.<tr><td><a id="l956"></a><a href="#l956">956</a><td> * @param {Array=} opt_rv An optional array in which to return the results,<tr><td><a id="l957"></a><a href="#l957">957</a><td> *     instead of performing the removal inplace.  If specified, the original<tr><td><a id="l958"></a><a href="#l958">958</a><td> *     array will remain unchanged.<tr><td><a id="l959"></a><a href="#l959">959</a><td> * @param {function(T):string=} opt_hashFn An optional function to use to<tr><td><a id="l960"></a><a href="#l960">960</a><td> *     apply to every item in the array. This function should return a unique<tr><td><a id="l961"></a><a href="#l961">961</a><td> *     value for each item in the array it should consider unique.<tr><td><a id="l962"></a><a href="#l962">962</a><td> * @template T<tr><td><a id="l963"></a><a href="#l963">963</a><td> */<tr><td><a id="l964"></a><a href="#l964">964</a><td>goog.array.removeDuplicates = function(arr, opt_rv, opt_hashFn) {<tr><td><a id="l965"></a><a href="#l965">965</a><td>  var returnArray = opt_rv || arr;<tr><td><a id="l966"></a><a href="#l966">966</a><td>  var defaultHashFn = function(item) {<tr><td><a id="l967"></a><a href="#l967">967</a><td>    // Prefix each type with a single character representing the type to<tr><td><a id="l968"></a><a href="#l968">968</a><td>    // prevent conflicting keys (e.g. true and &#39;true&#39;).<tr><td><a id="l969"></a><a href="#l969">969</a><td>    return goog.isObject(item) ? &#39;o&#39; + goog.getUid(item) :<tr><td><a id="l970"></a><a href="#l970">970</a><td>        (typeof item).charAt(0) + item;<tr><td><a id="l971"></a><a href="#l971">971</a><td>  };<tr><td><a id="l972"></a><a href="#l972">972</a><td>  var hashFn = opt_hashFn || defaultHashFn;<tr><td><a id="l973"></a><a href="#l973">973</a><td><tr><td><a id="l974"></a><a href="#l974">974</a><td>  var seen = {}, cursorInsert = 0, cursorRead = 0;<tr><td><a id="l975"></a><a href="#l975">975</a><td>  while (cursorRead &lt; arr.length) {<tr><td><a id="l976"></a><a href="#l976">976</a><td>    var current = arr[cursorRead++];<tr><td><a id="l977"></a><a href="#l977">977</a><td>    var key = hashFn(current);<tr><td><a id="l978"></a><a href="#l978">978</a><td>    if (!Object.prototype.hasOwnProperty.call(seen, key)) {<tr><td><a id="l979"></a><a href="#l979">979</a><td>      seen[key] = true;<tr><td><a id="l980"></a><a href="#l980">980</a><td>      returnArray[cursorInsert++] = current;<tr><td><a id="l981"></a><a href="#l981">981</a><td>    }<tr><td><a id="l982"></a><a href="#l982">982</a><td>  }<tr><td><a id="l983"></a><a href="#l983">983</a><td>  returnArray.length = cursorInsert;<tr><td><a id="l984"></a><a href="#l984">984</a><td>};<tr><td><a id="l985"></a><a href="#l985">985</a><td><tr><td><a id="l986"></a><a href="#l986">986</a><td><tr><td><a id="l987"></a><a href="#l987">987</a><td>/**<tr><td><a id="l988"></a><a href="#l988">988</a><td> * Searches the specified array for the specified target using the binary<tr><td><a id="l989"></a><a href="#l989">989</a><td> * search algorithm.  If no opt_compareFn is specified, elements are compared<tr><td><a id="l990"></a><a href="#l990">990</a><td> * using &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;, which compares the elements<tr><td><a id="l991"></a><a href="#l991">991</a><td> * using the built in &lt; and &gt; operators.  This will produce the expected<tr><td><a id="l992"></a><a href="#l992">992</a><td> * behavior for homogeneous arrays of String(s) and Number(s). The array<tr><td><a id="l993"></a><a href="#l993">993</a><td> * specified &lt;b&gt;must&lt;/b&gt; be sorted in ascending order (as defined by the<tr><td><a id="l994"></a><a href="#l994">994</a><td> * comparison function).  If the array is not sorted, results are undefined.<tr><td><a id="l995"></a><a href="#l995">995</a><td> * If the array contains multiple instances of the specified target value, any<tr><td><a id="l996"></a><a href="#l996">996</a><td> * of these instances may be found.<tr><td><a id="l997"></a><a href="#l997">997</a><td> *<tr><td><a id="l998"></a><a href="#l998">998</a><td> * Runtime: O(log n)<tr><td><a id="l999"></a><a href="#l999">999</a><td> *<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td> * @param {Array&lt;VALUE&gt;|goog.array.ArrayLike} arr The array to be searched.<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td> * @param {TARGET} target The sought value.<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td> * @param {function(TARGET, VALUE): number=} opt_compareFn Optional comparison<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td> *     function by which the array is ordered. Should take 2 arguments to<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td> *     compare, and return a negative number, zero, or a positive number<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td> *     depending on whether the first argument is less than, equal to, or<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td> *     greater than the second.<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td> * @return {number} Lowest index of the target value if found, otherwise<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td> *     (-(insertion point) - 1). The insertion point is where the value should<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td> *     be inserted into arr to preserve the sorted property.  Return value &gt;= 0<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td> *     iff target is found.<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td> * @template TARGET, VALUE<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td> */<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td>goog.array.binarySearch = function(arr, target, opt_compareFn) {<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td>  return goog.array.binarySearch_(arr,<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>      opt_compareFn || goog.array.defaultCompare, false /* isEvaluator */,<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td>      target);<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td>};<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td><tr><td><a id="l1019"></a><a href="#l1019">1019</a><td><tr><td><a id="l1020"></a><a href="#l1020">1020</a><td>/**<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td> * Selects an index in the specified array using the binary search algorithm.<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td> * The evaluator receives an element and determines whether the desired index<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td> * is before, at, or after it.  The evaluator must be consistent (formally,<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td> * goog.array.map(goog.array.map(arr, evaluator, opt_obj), goog.math.sign)<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td> * must be monotonically non-increasing).<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td> *<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td> * Runtime: O(log n)<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td> *<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td> * @param {Array&lt;VALUE&gt;|goog.array.ArrayLike} arr The array to be searched.<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td> * @param {function(this:THIS, VALUE, number, ?): number} evaluator<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td> *     Evaluator function that receives 3 arguments (the element, the index and<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td> *     the array). Should return a negative number, zero, or a positive number<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td> *     depending on whether the desired index is before, at, or after the<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td> *     element passed to it.<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td> *     within evaluator.<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td> * @return {number} Index of the leftmost element matched by the evaluator, if<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td> *     such exists; otherwise (-(insertion point) - 1). The insertion point is<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td> *     the index of the first element for which the evaluator returns negative,<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td> *     or arr.length if no such element exists. The return value is non-negative<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td> *     iff a match is found.<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td> * @template THIS, VALUE<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td> */<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>goog.array.binarySelect = function(arr, evaluator, opt_obj) {<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td>  return goog.array.binarySearch_(arr, evaluator, true /* isEvaluator */,<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td>      undefined /* opt_target */, opt_obj);<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td>};<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td><tr><td><a id="l1049"></a><a href="#l1049">1049</a><td><tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>/**<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td> * Implementation of a binary search algorithm which knows how to use both<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td> * comparison functions and evaluators. If an evaluator is provided, will call<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td> * the evaluator with the given optional data object, conforming to the<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td> * interface defined in binarySelect. Otherwise, if a comparison function is<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td> * provided, will call the comparison function against the given data object.<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td> *<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td> * This implementation purposefully does not use goog.bind or goog.partial for<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td> * performance reasons.<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td> *<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td> * Runtime: O(log n)<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td> *<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td> * @param {Array&lt;?&gt;|goog.array.ArrayLike} arr The array to be searched.<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td> * @param {function(?, ?, ?): number | function(?, ?): number} compareFn<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td> *     Either an evaluator or a comparison function, as defined by binarySearch<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td> *     and binarySelect above.<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td> * @param {boolean} isEvaluator Whether the function is an evaluator or a<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td> *     comparison function.<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td> * @param {?=} opt_target If the function is a comparison function, then<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td> *     this is the target to binary search for.<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td> * @param {Object=} opt_selfObj If the function is an evaluator, this is an<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td> *     optional this object for the evaluator.<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td> * @return {number} Lowest index of the target value if found, otherwise<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td> *     (-(insertion point) - 1). The insertion point is where the value should<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td> *     be inserted into arr to preserve the sorted property.  Return value &gt;= 0<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td> *     iff target is found.<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td> * @private<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td> */<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td>goog.array.binarySearch_ = function(arr, compareFn, isEvaluator, opt_target,<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td>    opt_selfObj) {<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>  var left = 0;  // inclusive<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td>  var right = arr.length;  // exclusive<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td>  var found;<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>  while (left &lt; right) {<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td>    var middle = (left + right) &gt;&gt; 1;<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td>    var compareResult;<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td>    if (isEvaluator) {<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>      compareResult = compareFn.call(opt_selfObj, arr[middle], middle, arr);<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>    } else {<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>      compareResult = compareFn(opt_target, arr[middle]);<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>    }<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td>    if (compareResult &gt; 0) {<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td>      left = middle + 1;<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td>    } else {<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td>      right = middle;<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td>      // We are looking for the lowest index so we can&#39;t return immediately.<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td>      found = !compareResult;<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>    }<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td>  }<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td>  // left is the index if found, or the insertion point otherwise.<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>  // ~left is a shorthand for -left - 1.<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td>  return found ? left : ~left;<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td>};<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td><tr><td><a id="l1104"></a><a href="#l1104">1104</a><td><tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>/**<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td> * Sorts the specified array into ascending order.  If no opt_compareFn is<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td> * specified, elements are compared using<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td> * &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;, which compares the elements using<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td> * the built in &lt; and &gt; operators.  This will produce the expected behavior<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td> * for homogeneous arrays of String(s) and Number(s), unlike the native sort,<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td> * but will give unpredictable results for heterogenous lists of strings and<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td> * numbers with different numbers of digits.<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td> *<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td> * This sort is not guaranteed to be stable.<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td> *<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td> * Runtime: Same as &lt;code&gt;Array.prototype.sort&lt;/code&gt;<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td> *<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td> * @param {Array&lt;T&gt;} arr The array to be sorted.<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td> * @param {?function(T,T):number=} opt_compareFn Optional comparison<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td> *     function by which the<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td> *     array is to be ordered. Should take 2 arguments to compare, and return a<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td> *     negative number, zero, or a positive number depending on whether the<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td> *     first argument is less than, equal to, or greater than the second.<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td> * @template T<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td> */<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td>goog.array.sort = function(arr, opt_compareFn) {<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td>  // TODO(arv): Update type annotation since null is not accepted.<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td>  arr.sort(opt_compareFn || goog.array.defaultCompare);<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td>};<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td><tr><td><a id="l1131"></a><a href="#l1131">1131</a><td><tr><td><a id="l1132"></a><a href="#l1132">1132</a><td>/**<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td> * Sorts the specified array into ascending order in a stable way.  If no<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td> * opt_compareFn is specified, elements are compared using<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td> * &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;, which compares the elements using<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td> * the built in &lt; and &gt; operators.  This will produce the expected behavior<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td> * for homogeneous arrays of String(s) and Number(s).<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td> *<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td> * Runtime: Same as &lt;code&gt;Array.prototype.sort&lt;/code&gt;, plus an additional<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td> * O(n) overhead of copying the array twice.<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td> *<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td> * @param {Array&lt;T&gt;} arr The array to be sorted.<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td> * @param {?function(T, T): number=} opt_compareFn Optional comparison function<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td> *     by which the array is to be ordered. Should take 2 arguments to compare,<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td> *     and return a negative number, zero, or a positive number depending on<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td> *     whether the first argument is less than, equal to, or greater than the<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td> *     second.<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td> * @template T<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td> */<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>goog.array.stableSort = function(arr, opt_compareFn) {<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td>  for (var i = 0; i &lt; arr.length; i++) {<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td>    arr[i] = {index: i, value: arr[i]};<tr><td><a id="l1153"></a><a href="#l1153">1153</a><td>  }<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td>  var valueCompareFn = opt_compareFn || goog.array.defaultCompare;<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td>  function stableCompareFn(obj1, obj2) {<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td>    return valueCompareFn(obj1.value, obj2.value) || obj1.index - obj2.index;<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td>  };<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td>  goog.array.sort(arr, stableCompareFn);<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td>  for (var i = 0; i &lt; arr.length; i++) {<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td>    arr[i] = arr[i].value;<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td>  }<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td>};<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td><tr><td><a id="l1164"></a><a href="#l1164">1164</a><td><tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>/**<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td> * Sort the specified array into ascending order based on item keys<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td> * returned by the specified key function.<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td> * If no opt_compareFn is specified, the keys are compared in ascending order<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td> * using &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;.<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td> *<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td> * Runtime: O(S(f(n)), where S is runtime of &lt;code&gt;goog.array.sort&lt;/code&gt;<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td> * and f(n) is runtime of the key function.<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td> *<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td> * @param {Array&lt;T&gt;} arr The array to be sorted.<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td> * @param {function(T): K} keyFn Function taking array element and returning<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td> *     a key used for sorting this element.<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td> * @param {?function(K, K): number=} opt_compareFn Optional comparison function<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td> *     by which the keys are to be ordered. Should take 2 arguments to compare,<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td> *     and return a negative number, zero, or a positive number depending on<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td> *     whether the first argument is less than, equal to, or greater than the<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td> *     second.<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td> * @template T,K<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td> */<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td>goog.array.sortByKey = function(arr, keyFn, opt_compareFn) {<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td>  var keyCompareFn = opt_compareFn || goog.array.defaultCompare;<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td>  goog.array.sort(arr, function(a, b) {<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td>    return keyCompareFn(keyFn(a), keyFn(b));<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td>  });<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td>};<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td><tr><td><a id="l1191"></a><a href="#l1191">1191</a><td><tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>/**<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td> * Sorts an array of objects by the specified object key and compare<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td> * function. If no compare function is provided, the key values are<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td> * compared in ascending order using &lt;code&gt;goog.array.defaultCompare&lt;/code&gt;.<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td> * This won&#39;t work for keys that get renamed by the compiler. So use<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td> * {&#39;foo&#39;: 1, &#39;bar&#39;: 2} rather than {foo: 1, bar: 2}.<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td> * @param {Array&lt;Object&gt;} arr An array of objects to sort.<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td> * @param {string} key The object key to sort by.<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td> * @param {Function=} opt_compareFn The function to use to compare key<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td> *     values.<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td> */<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td>goog.array.sortObjectsByKey = function(arr, key, opt_compareFn) {<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td>  goog.array.sortByKey(arr,<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td>      function(obj) { return obj[key]; },<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td>      opt_compareFn);<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td>};<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td><tr><td><a id="l1209"></a><a href="#l1209">1209</a><td><tr><td><a id="l1210"></a><a href="#l1210">1210</a><td>/**<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td> * Tells if the array is sorted.<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td> * @param {!Array&lt;T&gt;} arr The array.<tr><td><a id="l1213"></a><a href="#l1213">1213</a><td> * @param {?function(T,T):number=} opt_compareFn Function to compare the<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td> *     array elements.<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td> *     Should take 2 arguments to compare, and return a negative number, zero,<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td> *     or a positive number depending on whether the first argument is less<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td> *     than, equal to, or greater than the second.<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td> * @param {boolean=} opt_strict If true no equal elements are allowed.<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td> * @return {boolean} Whether the array is sorted.<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td> * @template T<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td> */<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>goog.array.isSorted = function(arr, opt_compareFn, opt_strict) {<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>  var compare = opt_compareFn || goog.array.defaultCompare;<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td>  for (var i = 1; i &lt; arr.length; i++) {<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td>    var compareResult = compare(arr[i - 1], arr[i]);<tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>    if (compareResult &gt; 0 || compareResult == 0 &amp;&amp; opt_strict) {<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td>      return false;<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td>    }<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td>  }<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td>  return true;<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td>};<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td><tr><td><a id="l1233"></a><a href="#l1233">1233</a><td><tr><td><a id="l1234"></a><a href="#l1234">1234</a><td>/**<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td> * Compares two arrays for equality. Two arrays are considered equal if they<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td> * have the same length and their corresponding elements are equal according to<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td> * the comparison function.<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td> *<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td> * @param {goog.array.ArrayLike} arr1 The first array to compare.<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td> * @param {goog.array.ArrayLike} arr2 The second array to compare.<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td> * @param {Function=} opt_equalsFn Optional comparison function.<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td> *     Should take 2 arguments to compare, and return true if the arguments<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td> *     are equal. Defaults to {@link goog.array.defaultCompareEquality} which<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td> *     compares the elements using the built-in &#39;===&#39; operator.<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td> * @return {boolean} Whether the two arrays are equal.<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td> */<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>goog.array.equals = function(arr1, arr2, opt_equalsFn) {<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>  if (!goog.isArrayLike(arr1) || !goog.isArrayLike(arr2) ||<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>      arr1.length != arr2.length) {<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>    return false;<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>  }<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td>  var l = arr1.length;<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>  var equalsFn = opt_equalsFn || goog.array.defaultCompareEquality;<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td>    if (!equalsFn(arr1[i], arr2[i])) {<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td>      return false;<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td>    }<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td>  }<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td>  return true;<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td>};<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td><tr><td><a id="l1262"></a><a href="#l1262">1262</a><td><tr><td><a id="l1263"></a><a href="#l1263">1263</a><td>/**<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td> * 3-way array compare function.<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td> * @param {!Array&lt;VALUE&gt;|!goog.array.ArrayLike} arr1 The first array to<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td> *     compare.<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td> * @param {!Array&lt;VALUE&gt;|!goog.array.ArrayLike} arr2 The second array to<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td> *     compare.<tr><td><a id="l1269"></a><a href="#l1269">1269</a><td> * @param {function(VALUE, VALUE): number=} opt_compareFn Optional comparison<tr><td><a id="l1270"></a><a href="#l1270">1270</a><td> *     function by which the array is to be ordered. Should take 2 arguments to<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td> *     compare, and return a negative number, zero, or a positive number<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td> *     depending on whether the first argument is less than, equal to, or<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td> *     greater than the second.<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td> * @return {number} Negative number, zero, or a positive number depending on<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td> *     whether the first argument is less than, equal to, or greater than the<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td> *     second.<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td> * @template VALUE<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td> */<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>goog.array.compare3 = function(arr1, arr2, opt_compareFn) {<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td>  var compare = opt_compareFn || goog.array.defaultCompare;<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>  var l = Math.min(arr1.length, arr2.length);<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>    var result = compare(arr1[i], arr2[i]);<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>    if (result != 0) {<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>      return result;<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>    }<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>  }<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td>  return goog.array.defaultCompare(arr1.length, arr2.length);<tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>};<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td><tr><td><a id="l1291"></a><a href="#l1291">1291</a><td><tr><td><a id="l1292"></a><a href="#l1292">1292</a><td>/**<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td> * Compares its two arguments for order, using the built in &lt; and &gt;<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td> * operators.<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td> * @param {VALUE} a The first object to be compared.<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td> * @param {VALUE} b The second object to be compared.<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td> * @return {number} A negative number, zero, or a positive number as the first<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td> *     argument is less than, equal to, or greater than the second,<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td> *     respectively.<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td> * @template VALUE<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td> */<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td>goog.array.defaultCompare = function(a, b) {<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td>  return a &gt; b ? 1 : a &lt; b ? -1 : 0;<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>};<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td><tr><td><a id="l1306"></a><a href="#l1306">1306</a><td><tr><td><a id="l1307"></a><a href="#l1307">1307</a><td>/**<tr><td><a id="l1308"></a><a href="#l1308">1308</a><td> * Compares its two arguments for inverse order, using the built in &lt; and &gt;<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td> * operators.<tr><td><a id="l1310"></a><a href="#l1310">1310</a><td> * @param {VALUE} a The first object to be compared.<tr><td><a id="l1311"></a><a href="#l1311">1311</a><td> * @param {VALUE} b The second object to be compared.<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td> * @return {number} A negative number, zero, or a positive number as the first<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td> *     argument is greater than, equal to, or less than the second,<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td> *     respectively.<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td> * @template VALUE<tr><td><a id="l1316"></a><a href="#l1316">1316</a><td> */<tr><td><a id="l1317"></a><a href="#l1317">1317</a><td>goog.array.inverseDefaultCompare = function(a, b) {<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td>  return -goog.array.defaultCompare(a, b);<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td>};<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td><tr><td><a id="l1321"></a><a href="#l1321">1321</a><td><tr><td><a id="l1322"></a><a href="#l1322">1322</a><td>/**<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td> * Compares its two arguments for equality, using the built in === operator.<tr><td><a id="l1324"></a><a href="#l1324">1324</a><td> * @param {*} a The first object to compare.<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td> * @param {*} b The second object to compare.<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td> * @return {boolean} True if the two arguments are equal, false otherwise.<tr><td><a id="l1327"></a><a href="#l1327">1327</a><td> */<tr><td><a id="l1328"></a><a href="#l1328">1328</a><td>goog.array.defaultCompareEquality = function(a, b) {<tr><td><a id="l1329"></a><a href="#l1329">1329</a><td>  return a === b;<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td>};<tr><td><a id="l1331"></a><a href="#l1331">1331</a><td><tr><td><a id="l1332"></a><a href="#l1332">1332</a><td><tr><td><a id="l1333"></a><a href="#l1333">1333</a><td>/**<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td> * Inserts a value into a sorted array. The array is not modified if the<tr><td><a id="l1335"></a><a href="#l1335">1335</a><td> * value is already present.<tr><td><a id="l1336"></a><a href="#l1336">1336</a><td> * @param {Array&lt;VALUE&gt;|goog.array.ArrayLike} array The array to modify.<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td> * @param {VALUE} value The object to insert.<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td> * @param {function(VALUE, VALUE): number=} opt_compareFn Optional comparison<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td> *     function by which the array is ordered. Should take 2 arguments to<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td> *     compare, and return a negative number, zero, or a positive number<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td> *     depending on whether the first argument is less than, equal to, or<tr><td><a id="l1342"></a><a href="#l1342">1342</a><td> *     greater than the second.<tr><td><a id="l1343"></a><a href="#l1343">1343</a><td> * @return {boolean} True if an element was inserted.<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td> * @template VALUE<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td> */<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td>goog.array.binaryInsert = function(array, value, opt_compareFn) {<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td>  var index = goog.array.binarySearch(array, value, opt_compareFn);<tr><td><a id="l1348"></a><a href="#l1348">1348</a><td>  if (index &lt; 0) {<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td>    goog.array.insertAt(array, value, -(index + 1));<tr><td><a id="l1350"></a><a href="#l1350">1350</a><td>    return true;<tr><td><a id="l1351"></a><a href="#l1351">1351</a><td>  }<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td>  return false;<tr><td><a id="l1353"></a><a href="#l1353">1353</a><td>};<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td><tr><td><a id="l1355"></a><a href="#l1355">1355</a><td><tr><td><a id="l1356"></a><a href="#l1356">1356</a><td>/**<tr><td><a id="l1357"></a><a href="#l1357">1357</a><td> * Removes a value from a sorted array.<tr><td><a id="l1358"></a><a href="#l1358">1358</a><td> * @param {!Array&lt;VALUE&gt;|!goog.array.ArrayLike} array The array to modify.<tr><td><a id="l1359"></a><a href="#l1359">1359</a><td> * @param {VALUE} value The object to remove.<tr><td><a id="l1360"></a><a href="#l1360">1360</a><td> * @param {function(VALUE, VALUE): number=} opt_compareFn Optional comparison<tr><td><a id="l1361"></a><a href="#l1361">1361</a><td> *     function by which the array is ordered. Should take 2 arguments to<tr><td><a id="l1362"></a><a href="#l1362">1362</a><td> *     compare, and return a negative number, zero, or a positive number<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td> *     depending on whether the first argument is less than, equal to, or<tr><td><a id="l1364"></a><a href="#l1364">1364</a><td> *     greater than the second.<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td> * @return {boolean} True if an element was removed.<tr><td><a id="l1366"></a><a href="#l1366">1366</a><td> * @template VALUE<tr><td><a id="l1367"></a><a href="#l1367">1367</a><td> */<tr><td><a id="l1368"></a><a href="#l1368">1368</a><td>goog.array.binaryRemove = function(array, value, opt_compareFn) {<tr><td><a id="l1369"></a><a href="#l1369">1369</a><td>  var index = goog.array.binarySearch(array, value, opt_compareFn);<tr><td><a id="l1370"></a><a href="#l1370">1370</a><td>  return (index &gt;= 0) ? goog.array.removeAt(array, index) : false;<tr><td><a id="l1371"></a><a href="#l1371">1371</a><td>};<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td><tr><td><a id="l1373"></a><a href="#l1373">1373</a><td><tr><td><a id="l1374"></a><a href="#l1374">1374</a><td>/**<tr><td><a id="l1375"></a><a href="#l1375">1375</a><td> * Splits an array into disjoint buckets according to a splitting function.<tr><td><a id="l1376"></a><a href="#l1376">1376</a><td> * @param {Array&lt;T&gt;} array The array.<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td> * @param {function(this:S, T,number,Array&lt;T&gt;):?} sorter Function to call for<tr><td><a id="l1378"></a><a href="#l1378">1378</a><td> *     every element.  This takes 3 arguments (the element, the index and the<tr><td><a id="l1379"></a><a href="#l1379">1379</a><td> *     array) and must return a valid object key (a string, number, etc), or<tr><td><a id="l1380"></a><a href="#l1380">1380</a><td> *     undefined, if that object should not be placed in a bucket.<tr><td><a id="l1381"></a><a href="#l1381">1381</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a id="l1382"></a><a href="#l1382">1382</a><td> *     sorter.<tr><td><a id="l1383"></a><a href="#l1383">1383</a><td> * @return {!Object} An object, with keys being all of the unique return values<tr><td><a id="l1384"></a><a href="#l1384">1384</a><td> *     of sorter, and values being arrays containing the items for<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td> *     which the splitter returned that key.<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td> * @template T,S<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td> */<tr><td><a id="l1388"></a><a href="#l1388">1388</a><td>goog.array.bucket = function(array, sorter, opt_obj) {<tr><td><a id="l1389"></a><a href="#l1389">1389</a><td>  var buckets = {};<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td><tr><td><a id="l1391"></a><a href="#l1391">1391</a><td>  for (var i = 0; i &lt; array.length; i++) {<tr><td><a id="l1392"></a><a href="#l1392">1392</a><td>    var value = array[i];<tr><td><a id="l1393"></a><a href="#l1393">1393</a><td>    var key = sorter.call(opt_obj, value, i, array);<tr><td><a id="l1394"></a><a href="#l1394">1394</a><td>    if (goog.isDef(key)) {<tr><td><a id="l1395"></a><a href="#l1395">1395</a><td>      // Push the value to the right bucket, creating it if necessary.<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td>      var bucket = buckets[key] || (buckets[key] = []);<tr><td><a id="l1397"></a><a href="#l1397">1397</a><td>      bucket.push(value);<tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>    }<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td>  }<tr><td><a id="l1400"></a><a href="#l1400">1400</a><td><tr><td><a id="l1401"></a><a href="#l1401">1401</a><td>  return buckets;<tr><td><a id="l1402"></a><a href="#l1402">1402</a><td>};<tr><td><a id="l1403"></a><a href="#l1403">1403</a><td><tr><td><a id="l1404"></a><a href="#l1404">1404</a><td><tr><td><a id="l1405"></a><a href="#l1405">1405</a><td>/**<tr><td><a id="l1406"></a><a href="#l1406">1406</a><td> * Creates a new object built from the provided array and the key-generation<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td> * function.<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td> * @param {Array&lt;T&gt;|goog.array.ArrayLike} arr Array or array like object over<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td> *     which to iterate whose elements will be the values in the new object.<tr><td><a id="l1410"></a><a href="#l1410">1410</a><td> * @param {?function(this:S, T, number, ?) : string} keyFunc The function to<tr><td><a id="l1411"></a><a href="#l1411">1411</a><td> *     call for every element. This function takes 3 arguments (the element, the<tr><td><a id="l1412"></a><a href="#l1412">1412</a><td> *     index and the array) and should return a string that will be used as the<tr><td><a id="l1413"></a><a href="#l1413">1413</a><td> *     key for the element in the new object. If the function returns the same<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td> *     key for more than one element, the value for that key is<tr><td><a id="l1415"></a><a href="#l1415">1415</a><td> *     implementation-defined.<tr><td><a id="l1416"></a><a href="#l1416">1416</a><td> * @param {S=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a id="l1417"></a><a href="#l1417">1417</a><td> *     within keyFunc.<tr><td><a id="l1418"></a><a href="#l1418">1418</a><td> * @return {!Object&lt;T&gt;} The new object.<tr><td><a id="l1419"></a><a href="#l1419">1419</a><td> * @template T,S<tr><td><a id="l1420"></a><a href="#l1420">1420</a><td> */<tr><td><a id="l1421"></a><a href="#l1421">1421</a><td>goog.array.toObject = function(arr, keyFunc, opt_obj) {<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td>  var ret = {};<tr><td><a id="l1423"></a><a href="#l1423">1423</a><td>  goog.array.forEach(arr, function(element, index) {<tr><td><a id="l1424"></a><a href="#l1424">1424</a><td>    ret[keyFunc.call(opt_obj, element, index, arr)] = element;<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td>  });<tr><td><a id="l1426"></a><a href="#l1426">1426</a><td>  return ret;<tr><td><a id="l1427"></a><a href="#l1427">1427</a><td>};<tr><td><a id="l1428"></a><a href="#l1428">1428</a><td><tr><td><a id="l1429"></a><a href="#l1429">1429</a><td><tr><td><a id="l1430"></a><a href="#l1430">1430</a><td>/**<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td> * Creates a range of numbers in an arithmetic progression.<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td> *<tr><td><a id="l1433"></a><a href="#l1433">1433</a><td> * Range takes 1, 2, or 3 arguments:<tr><td><a id="l1434"></a><a href="#l1434">1434</a><td> * &lt;pre&gt;<tr><td><a id="l1435"></a><a href="#l1435">1435</a><td> * range(5) is the same as range(0, 5, 1) and produces [0, 1, 2, 3, 4]<tr><td><a id="l1436"></a><a href="#l1436">1436</a><td> * range(2, 5) is the same as range(2, 5, 1) and produces [2, 3, 4]<tr><td><a id="l1437"></a><a href="#l1437">1437</a><td> * range(-2, -5, -1) produces [-2, -3, -4]<tr><td><a id="l1438"></a><a href="#l1438">1438</a><td> * range(-2, -5, 1) produces [], since stepping by 1 wouldn&#39;t ever reach -5.<tr><td><a id="l1439"></a><a href="#l1439">1439</a><td> * &lt;/pre&gt;<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td> *<tr><td><a id="l1441"></a><a href="#l1441">1441</a><td> * @param {number} startOrEnd The starting value of the range if an end argument<tr><td><a id="l1442"></a><a href="#l1442">1442</a><td> *     is provided. Otherwise, the start value is 0, and this is the end value.<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td> * @param {number=} opt_end The optional end value of the range.<tr><td><a id="l1444"></a><a href="#l1444">1444</a><td> * @param {number=} opt_step The step size between range values. Defaults to 1<tr><td><a id="l1445"></a><a href="#l1445">1445</a><td> *     if opt_step is undefined or 0.<tr><td><a id="l1446"></a><a href="#l1446">1446</a><td> * @return {!Array&lt;number&gt;} An array of numbers for the requested range. May be<tr><td><a id="l1447"></a><a href="#l1447">1447</a><td> *     an empty array if adding the step would not converge toward the end<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td> *     value.<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td> */<tr><td><a id="l1450"></a><a href="#l1450">1450</a><td>goog.array.range = function(startOrEnd, opt_end, opt_step) {<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td>  var array = [];<tr><td><a id="l1452"></a><a href="#l1452">1452</a><td>  var start = 0;<tr><td><a id="l1453"></a><a href="#l1453">1453</a><td>  var end = startOrEnd;<tr><td><a id="l1454"></a><a href="#l1454">1454</a><td>  var step = opt_step || 1;<tr><td><a id="l1455"></a><a href="#l1455">1455</a><td>  if (opt_end !== undefined) {<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td>    start = startOrEnd;<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td>    end = opt_end;<tr><td><a id="l1458"></a><a href="#l1458">1458</a><td>  }<tr><td><a id="l1459"></a><a href="#l1459">1459</a><td><tr><td><a id="l1460"></a><a href="#l1460">1460</a><td>  if (step * (end - start) &lt; 0) {<tr><td><a id="l1461"></a><a href="#l1461">1461</a><td>    // Sign mismatch: start + step will never reach the end value.<tr><td><a id="l1462"></a><a href="#l1462">1462</a><td>    return [];<tr><td><a id="l1463"></a><a href="#l1463">1463</a><td>  }<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td><tr><td><a id="l1465"></a><a href="#l1465">1465</a><td>  if (step &gt; 0) {<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td>    for (var i = start; i &lt; end; i += step) {<tr><td><a id="l1467"></a><a href="#l1467">1467</a><td>      array.push(i);<tr><td><a id="l1468"></a><a href="#l1468">1468</a><td>    }<tr><td><a id="l1469"></a><a href="#l1469">1469</a><td>  } else {<tr><td><a id="l1470"></a><a href="#l1470">1470</a><td>    for (var i = start; i &gt; end; i += step) {<tr><td><a id="l1471"></a><a href="#l1471">1471</a><td>      array.push(i);<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td>    }<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td>  }<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td>  return array;<tr><td><a id="l1475"></a><a href="#l1475">1475</a><td>};<tr><td><a id="l1476"></a><a href="#l1476">1476</a><td><tr><td><a id="l1477"></a><a href="#l1477">1477</a><td><tr><td><a id="l1478"></a><a href="#l1478">1478</a><td>/**<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td> * Returns an array consisting of the given value repeated N times.<tr><td><a id="l1480"></a><a href="#l1480">1480</a><td> *<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td> * @param {VALUE} value The value to repeat.<tr><td><a id="l1482"></a><a href="#l1482">1482</a><td> * @param {number} n The repeat count.<tr><td><a id="l1483"></a><a href="#l1483">1483</a><td> * @return {!Array&lt;VALUE&gt;} An array with the repeated value.<tr><td><a id="l1484"></a><a href="#l1484">1484</a><td> * @template VALUE<tr><td><a id="l1485"></a><a href="#l1485">1485</a><td> */<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td>goog.array.repeat = function(value, n) {<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td>  var array = [];<tr><td><a id="l1488"></a><a href="#l1488">1488</a><td>  for (var i = 0; i &lt; n; i++) {<tr><td><a id="l1489"></a><a href="#l1489">1489</a><td>    array[i] = value;<tr><td><a id="l1490"></a><a href="#l1490">1490</a><td>  }<tr><td><a id="l1491"></a><a href="#l1491">1491</a><td>  return array;<tr><td><a id="l1492"></a><a href="#l1492">1492</a><td>};<tr><td><a id="l1493"></a><a href="#l1493">1493</a><td><tr><td><a id="l1494"></a><a href="#l1494">1494</a><td><tr><td><a id="l1495"></a><a href="#l1495">1495</a><td>/**<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td> * Returns an array consisting of every argument with all arrays<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td> * expanded in-place recursively.<tr><td><a id="l1498"></a><a href="#l1498">1498</a><td> *<tr><td><a id="l1499"></a><a href="#l1499">1499</a><td> * @param {...*} var_args The values to flatten.<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td> * @return {!Array&lt;?&gt;} An array containing the flattened values.<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td> */<tr><td><a id="l1502"></a><a href="#l1502">1502</a><td>goog.array.flatten = function(var_args) {<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td>  var CHUNK_SIZE = 8192;<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td><tr><td><a id="l1505"></a><a href="#l1505">1505</a><td>  var result = [];<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td>  for (var i = 0; i &lt; arguments.length; i++) {<tr><td><a id="l1507"></a><a href="#l1507">1507</a><td>    var element = arguments[i];<tr><td><a id="l1508"></a><a href="#l1508">1508</a><td>    if (goog.isArray(element)) {<tr><td><a id="l1509"></a><a href="#l1509">1509</a><td>      for (var c = 0; c &lt; element.length; c += CHUNK_SIZE) {<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td>        var chunk = goog.array.slice(element, c, c + CHUNK_SIZE);<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td>        var recurseResult = goog.array.flatten.apply(null, chunk);<tr><td><a id="l1512"></a><a href="#l1512">1512</a><td>        for (var r = 0; r &lt; recurseResult.length; r++) {<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td>          result.push(recurseResult[r]);<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td>        }<tr><td><a id="l1515"></a><a href="#l1515">1515</a><td>      }<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>    } else {<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td>      result.push(element);<tr><td><a id="l1518"></a><a href="#l1518">1518</a><td>    }<tr><td><a id="l1519"></a><a href="#l1519">1519</a><td>  }<tr><td><a id="l1520"></a><a href="#l1520">1520</a><td>  return result;<tr><td><a id="l1521"></a><a href="#l1521">1521</a><td>};<tr><td><a id="l1522"></a><a href="#l1522">1522</a><td><tr><td><a id="l1523"></a><a href="#l1523">1523</a><td><tr><td><a id="l1524"></a><a href="#l1524">1524</a><td>/**<tr><td><a id="l1525"></a><a href="#l1525">1525</a><td> * Rotates an array in-place. After calling this method, the element at<tr><td><a id="l1526"></a><a href="#l1526">1526</a><td> * index i will be the element previously at index (i - n) %<tr><td><a id="l1527"></a><a href="#l1527">1527</a><td> * array.length, for all values of i between 0 and array.length - 1,<tr><td><a id="l1528"></a><a href="#l1528">1528</a><td> * inclusive.<tr><td><a id="l1529"></a><a href="#l1529">1529</a><td> *<tr><td><a id="l1530"></a><a href="#l1530">1530</a><td> * For example, suppose list comprises [t, a, n, k, s]. After invoking<tr><td><a id="l1531"></a><a href="#l1531">1531</a><td> * rotate(array, 1) (or rotate(array, -4)), array will comprise [s, t, a, n, k].<tr><td><a id="l1532"></a><a href="#l1532">1532</a><td> *<tr><td><a id="l1533"></a><a href="#l1533">1533</a><td> * @param {!Array&lt;T&gt;} array The array to rotate.<tr><td><a id="l1534"></a><a href="#l1534">1534</a><td> * @param {number} n The amount to rotate.<tr><td><a id="l1535"></a><a href="#l1535">1535</a><td> * @return {!Array&lt;T&gt;} The array.<tr><td><a id="l1536"></a><a href="#l1536">1536</a><td> * @template T<tr><td><a id="l1537"></a><a href="#l1537">1537</a><td> */<tr><td><a id="l1538"></a><a href="#l1538">1538</a><td>goog.array.rotate = function(array, n) {<tr><td><a id="l1539"></a><a href="#l1539">1539</a><td>  goog.asserts.assert(array.length != null);<tr><td><a id="l1540"></a><a href="#l1540">1540</a><td><tr><td><a id="l1541"></a><a href="#l1541">1541</a><td>  if (array.length) {<tr><td><a id="l1542"></a><a href="#l1542">1542</a><td>    n %= array.length;<tr><td><a id="l1543"></a><a href="#l1543">1543</a><td>    if (n &gt; 0) {<tr><td><a id="l1544"></a><a href="#l1544">1544</a><td>      goog.array.ARRAY_PROTOTYPE_.unshift.apply(array, array.splice(-n, n));<tr><td><a id="l1545"></a><a href="#l1545">1545</a><td>    } else if (n &lt; 0) {<tr><td><a id="l1546"></a><a href="#l1546">1546</a><td>      goog.array.ARRAY_PROTOTYPE_.push.apply(array, array.splice(0, -n));<tr><td><a id="l1547"></a><a href="#l1547">1547</a><td>    }<tr><td><a id="l1548"></a><a href="#l1548">1548</a><td>  }<tr><td><a id="l1549"></a><a href="#l1549">1549</a><td>  return array;<tr><td><a id="l1550"></a><a href="#l1550">1550</a><td>};<tr><td><a id="l1551"></a><a href="#l1551">1551</a><td><tr><td><a id="l1552"></a><a href="#l1552">1552</a><td><tr><td><a id="l1553"></a><a href="#l1553">1553</a><td>/**<tr><td><a id="l1554"></a><a href="#l1554">1554</a><td> * Moves one item of an array to a new position keeping the order of the rest<tr><td><a id="l1555"></a><a href="#l1555">1555</a><td> * of the items. Example use case: keeping a list of JavaScript objects<tr><td><a id="l1556"></a><a href="#l1556">1556</a><td> * synchronized with the corresponding list of DOM elements after one of the<tr><td><a id="l1557"></a><a href="#l1557">1557</a><td> * elements has been dragged to a new position.<tr><td><a id="l1558"></a><a href="#l1558">1558</a><td> * @param {!(Array|Arguments|{length:number})} arr The array to modify.<tr><td><a id="l1559"></a><a href="#l1559">1559</a><td> * @param {number} fromIndex Index of the item to move between 0 and<tr><td><a id="l1560"></a><a href="#l1560">1560</a><td> *     {@code arr.length - 1}.<tr><td><a id="l1561"></a><a href="#l1561">1561</a><td> * @param {number} toIndex Target index between 0 and {@code arr.length - 1}.<tr><td><a id="l1562"></a><a href="#l1562">1562</a><td> */<tr><td><a id="l1563"></a><a href="#l1563">1563</a><td>goog.array.moveItem = function(arr, fromIndex, toIndex) {<tr><td><a id="l1564"></a><a href="#l1564">1564</a><td>  goog.asserts.assert(fromIndex &gt;= 0 &amp;&amp; fromIndex &lt; arr.length);<tr><td><a id="l1565"></a><a href="#l1565">1565</a><td>  goog.asserts.assert(toIndex &gt;= 0 &amp;&amp; toIndex &lt; arr.length);<tr><td><a id="l1566"></a><a href="#l1566">1566</a><td>  // Remove 1 item at fromIndex.<tr><td><a id="l1567"></a><a href="#l1567">1567</a><td>  var removedItems = goog.array.ARRAY_PROTOTYPE_.splice.call(arr, fromIndex, 1);<tr><td><a id="l1568"></a><a href="#l1568">1568</a><td>  // Insert the removed item at toIndex.<tr><td><a id="l1569"></a><a href="#l1569">1569</a><td>  goog.array.ARRAY_PROTOTYPE_.splice.call(arr, toIndex, 0, removedItems[0]);<tr><td><a id="l1570"></a><a href="#l1570">1570</a><td>  // We don&#39;t use goog.array.insertAt and goog.array.removeAt, because they&#39;re<tr><td><a id="l1571"></a><a href="#l1571">1571</a><td>  // significantly slower than splice.<tr><td><a id="l1572"></a><a href="#l1572">1572</a><td>};<tr><td><a id="l1573"></a><a href="#l1573">1573</a><td><tr><td><a id="l1574"></a><a href="#l1574">1574</a><td><tr><td><a id="l1575"></a><a href="#l1575">1575</a><td>/**<tr><td><a id="l1576"></a><a href="#l1576">1576</a><td> * Creates a new array for which the element at position i is an array of the<tr><td><a id="l1577"></a><a href="#l1577">1577</a><td> * ith element of the provided arrays.  The returned array will only be as long<tr><td><a id="l1578"></a><a href="#l1578">1578</a><td> * as the shortest array provided; additional values are ignored.  For example,<tr><td><a id="l1579"></a><a href="#l1579">1579</a><td> * the result of zipping [1, 2] and [3, 4, 5] is [[1,3], [2, 4]].<tr><td><a id="l1580"></a><a href="#l1580">1580</a><td> *<tr><td><a id="l1581"></a><a href="#l1581">1581</a><td> * This is similar to the zip() function in Python.  See {@link<tr><td><a id="l1582"></a><a href="#l1582">1582</a><td> * http://docs.python.org/library/functions.html#zip}<tr><td><a id="l1583"></a><a href="#l1583">1583</a><td> *<tr><td><a id="l1584"></a><a href="#l1584">1584</a><td> * @param {...!goog.array.ArrayLike} var_args Arrays to be combined.<tr><td><a id="l1585"></a><a href="#l1585">1585</a><td> * @return {!Array&lt;!Array&lt;?&gt;&gt;} A new array of arrays created from<tr><td><a id="l1586"></a><a href="#l1586">1586</a><td> *     provided arrays.<tr><td><a id="l1587"></a><a href="#l1587">1587</a><td> */<tr><td><a id="l1588"></a><a href="#l1588">1588</a><td>goog.array.zip = function(var_args) {<tr><td><a id="l1589"></a><a href="#l1589">1589</a><td>  if (!arguments.length) {<tr><td><a id="l1590"></a><a href="#l1590">1590</a><td>    return [];<tr><td><a id="l1591"></a><a href="#l1591">1591</a><td>  }<tr><td><a id="l1592"></a><a href="#l1592">1592</a><td>  var result = [];<tr><td><a id="l1593"></a><a href="#l1593">1593</a><td>  var minLen = arguments[0].length;<tr><td><a id="l1594"></a><a href="#l1594">1594</a><td>  for (var i = 1; i &lt; arguments.length; i++) {<tr><td><a id="l1595"></a><a href="#l1595">1595</a><td>    if (arguments[i].length &lt; minLen) {<tr><td><a id="l1596"></a><a href="#l1596">1596</a><td>      minLen = arguments[i].length;<tr><td><a id="l1597"></a><a href="#l1597">1597</a><td>    }<tr><td><a id="l1598"></a><a href="#l1598">1598</a><td>  }<tr><td><a id="l1599"></a><a href="#l1599">1599</a><td>  for (var i = 0; i &lt; minLen; i++) {<tr><td><a id="l1600"></a><a href="#l1600">1600</a><td>    var value = [];<tr><td><a id="l1601"></a><a href="#l1601">1601</a><td>    for (var j = 0; j &lt; arguments.length; j++) {<tr><td><a id="l1602"></a><a href="#l1602">1602</a><td>      value.push(arguments[j][i]);<tr><td><a id="l1603"></a><a href="#l1603">1603</a><td>    }<tr><td><a id="l1604"></a><a href="#l1604">1604</a><td>    result.push(value);<tr><td><a id="l1605"></a><a href="#l1605">1605</a><td>  }<tr><td><a id="l1606"></a><a href="#l1606">1606</a><td>  return result;<tr><td><a id="l1607"></a><a href="#l1607">1607</a><td>};<tr><td><a id="l1608"></a><a href="#l1608">1608</a><td><tr><td><a id="l1609"></a><a href="#l1609">1609</a><td><tr><td><a id="l1610"></a><a href="#l1610">1610</a><td>/**<tr><td><a id="l1611"></a><a href="#l1611">1611</a><td> * Shuffles the values in the specified array using the Fisher-Yates in-place<tr><td><a id="l1612"></a><a href="#l1612">1612</a><td> * shuffle (also known as the Knuth Shuffle). By default, calls Math.random()<tr><td><a id="l1613"></a><a href="#l1613">1613</a><td> * and so resets the state of that random number generator. Similarly, may reset<tr><td><a id="l1614"></a><a href="#l1614">1614</a><td> * the state of the any other specified random number generator.<tr><td><a id="l1615"></a><a href="#l1615">1615</a><td> *<tr><td><a id="l1616"></a><a href="#l1616">1616</a><td> * Runtime: O(n)<tr><td><a id="l1617"></a><a href="#l1617">1617</a><td> *<tr><td><a id="l1618"></a><a href="#l1618">1618</a><td> * @param {!Array&lt;?&gt;} arr The array to be shuffled.<tr><td><a id="l1619"></a><a href="#l1619">1619</a><td> * @param {function():number=} opt_randFn Optional random function to use for<tr><td><a id="l1620"></a><a href="#l1620">1620</a><td> *     shuffling.<tr><td><a id="l1621"></a><a href="#l1621">1621</a><td> *     Takes no arguments, and returns a random number on the interval [0, 1).<tr><td><a id="l1622"></a><a href="#l1622">1622</a><td> *     Defaults to Math.random() using JavaScript&#39;s built-in Math library.<tr><td><a id="l1623"></a><a href="#l1623">1623</a><td> */<tr><td><a id="l1624"></a><a href="#l1624">1624</a><td>goog.array.shuffle = function(arr, opt_randFn) {<tr><td><a id="l1625"></a><a href="#l1625">1625</a><td>  var randFn = opt_randFn || Math.random;<tr><td><a id="l1626"></a><a href="#l1626">1626</a><td><tr><td><a id="l1627"></a><a href="#l1627">1627</a><td>  for (var i = arr.length - 1; i &gt; 0; i--) {<tr><td><a id="l1628"></a><a href="#l1628">1628</a><td>    // Choose a random array index in [0, i] (inclusive with i).<tr><td><a id="l1629"></a><a href="#l1629">1629</a><td>    var j = Math.floor(randFn() * (i + 1));<tr><td><a id="l1630"></a><a href="#l1630">1630</a><td><tr><td><a id="l1631"></a><a href="#l1631">1631</a><td>    var tmp = arr[i];<tr><td><a id="l1632"></a><a href="#l1632">1632</a><td>    arr[i] = arr[j];<tr><td><a id="l1633"></a><a href="#l1633">1633</a><td>    arr[j] = tmp;<tr><td><a id="l1634"></a><a href="#l1634">1634</a><td>  }<tr><td><a id="l1635"></a><a href="#l1635">1635</a><td>};<tr><td><a id="l1636"></a><a href="#l1636">1636</a><td><tr><td><a id="l1637"></a><a href="#l1637">1637</a><td><tr><td><a id="l1638"></a><a href="#l1638">1638</a><td>/**<tr><td><a id="l1639"></a><a href="#l1639">1639</a><td> * Returns a new array of elements from arr, based on the indexes of elements<tr><td><a id="l1640"></a><a href="#l1640">1640</a><td> * provided by index_arr. For example, the result of index copying<tr><td><a id="l1641"></a><a href="#l1641">1641</a><td> * [&#39;a&#39;, &#39;b&#39;, &#39;c&#39;] with index_arr [1,0,0,2] is [&#39;b&#39;, &#39;a&#39;, &#39;a&#39;, &#39;c&#39;].<tr><td><a id="l1642"></a><a href="#l1642">1642</a><td> *<tr><td><a id="l1643"></a><a href="#l1643">1643</a><td> * @param {!Array&lt;T&gt;} arr The array to get a indexed copy from.<tr><td><a id="l1644"></a><a href="#l1644">1644</a><td> * @param {!Array&lt;number&gt;} index_arr An array of indexes to get from arr.<tr><td><a id="l1645"></a><a href="#l1645">1645</a><td> * @return {!Array&lt;T&gt;} A new array of elements from arr in index_arr order.<tr><td><a id="l1646"></a><a href="#l1646">1646</a><td> * @template T<tr><td><a id="l1647"></a><a href="#l1647">1647</a><td> */<tr><td><a id="l1648"></a><a href="#l1648">1648</a><td>goog.array.copyByIndex = function(arr, index_arr) {<tr><td><a id="l1649"></a><a href="#l1649">1649</a><td>  var result = [];<tr><td><a id="l1650"></a><a href="#l1650">1650</a><td>  goog.array.forEach(index_arr, function(index) {<tr><td><a id="l1651"></a><a href="#l1651">1651</a><td>    result.push(arr[index]);<tr><td><a id="l1652"></a><a href="#l1652">1652</a><td>  });<tr><td><a id="l1653"></a><a href="#l1653">1653</a><td>  return result;<tr><td><a id="l1654"></a><a href="#l1654">1654</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/asserts/asserts.js.src.html b/docs/source/lib/goog/asserts/asserts.js.src.html
index a4d719f..afed314 100644
--- a/docs/source/lib/goog/asserts/asserts.js.src.html
+++ b/docs/source/lib/goog/asserts/asserts.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>asserts.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/asserts/asserts.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Utilities to check the preconditions, postconditions and<tr><td><a name="l17" href="#l17">17</a><td> * invariants runtime.<tr><td><a name="l18" href="#l18">18</a><td> *<tr><td><a name="l19" href="#l19">19</a><td> * Methods in this package should be given special treatment by the compiler<tr><td><a name="l20" href="#l20">20</a><td> * for type-inference. For example, &lt;code&gt;goog.asserts.assert(foo)&lt;/code&gt;<tr><td><a name="l21" href="#l21">21</a><td> * will restrict &lt;code&gt;foo&lt;/code&gt; to a truthy value.<tr><td><a name="l22" href="#l22">22</a><td> *<tr><td><a name="l23" href="#l23">23</a><td> * The compiler has an option to disable asserts. So code like:<tr><td><a name="l24" href="#l24">24</a><td> * &lt;code&gt;<tr><td><a name="l25" href="#l25">25</a><td> * var x = goog.asserts.assert(foo()); goog.asserts.assert(bar());<tr><td><a name="l26" href="#l26">26</a><td> * &lt;/code&gt;<tr><td><a name="l27" href="#l27">27</a><td> * will be transformed into:<tr><td><a name="l28" href="#l28">28</a><td> * &lt;code&gt;<tr><td><a name="l29" href="#l29">29</a><td> * var x = foo();<tr><td><a name="l30" href="#l30">30</a><td> * &lt;/code&gt;<tr><td><a name="l31" href="#l31">31</a><td> * The compiler will leave in foo() (because its return value is used),<tr><td><a name="l32" href="#l32">32</a><td> * but it will remove bar() because it assumes it does not have side-effects.<tr><td><a name="l33" href="#l33">33</a><td> *<tr><td><a name="l34" href="#l34">34</a><td> */<tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td>goog.provide(&#39;goog.asserts&#39;);<tr><td><a name="l37" href="#l37">37</a><td>goog.provide(&#39;goog.asserts.AssertionError&#39;);<tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>goog.require(&#39;goog.debug.Error&#39;);<tr><td><a name="l40" href="#l40">40</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>/**<tr><td><a name="l44" href="#l44">44</a><td> * @define {boolean} Whether to strip out asserts or to leave them in.<tr><td><a name="l45" href="#l45">45</a><td> */<tr><td><a name="l46" href="#l46">46</a><td>goog.define(&#39;goog.asserts.ENABLE_ASSERTS&#39;, goog.DEBUG);<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td>/**<tr><td><a name="l51" href="#l51">51</a><td> * Error object for failed assertions.<tr><td><a name="l52" href="#l52">52</a><td> * @param {string} messagePattern The pattern that was used to form message.<tr><td><a name="l53" href="#l53">53</a><td> * @param {!Array.&lt;*&gt;} messageArgs The items to substitute into the pattern.<tr><td><a name="l54" href="#l54">54</a><td> * @constructor<tr><td><a name="l55" href="#l55">55</a><td> * @extends {goog.debug.Error}<tr><td><a name="l56" href="#l56">56</a><td> */<tr><td><a name="l57" href="#l57">57</a><td>goog.asserts.AssertionError = function(messagePattern, messageArgs) {<tr><td><a name="l58" href="#l58">58</a><td>  messageArgs.unshift(messagePattern);<tr><td><a name="l59" href="#l59">59</a><td>  goog.debug.Error.call(this, goog.string.subs.apply(null, messageArgs));<tr><td><a name="l60" href="#l60">60</a><td>  // Remove the messagePattern afterwards to avoid permenantly modifying the<tr><td><a name="l61" href="#l61">61</a><td>  // passed in array.<tr><td><a name="l62" href="#l62">62</a><td>  messageArgs.shift();<tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>  /**<tr><td><a name="l65" href="#l65">65</a><td>   * The message pattern used to format the error message. Error handlers can<tr><td><a name="l66" href="#l66">66</a><td>   * use this to uniquely identify the assertion.<tr><td><a name="l67" href="#l67">67</a><td>   * @type {string}<tr><td><a name="l68" href="#l68">68</a><td>   */<tr><td><a name="l69" href="#l69">69</a><td>  this.messagePattern = messagePattern;<tr><td><a name="l70" href="#l70">70</a><td>};<tr><td><a name="l71" href="#l71">71</a><td>goog.inherits(goog.asserts.AssertionError, goog.debug.Error);<tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td>/** @override */<tr><td><a name="l75" href="#l75">75</a><td>goog.asserts.AssertionError.prototype.name = &#39;AssertionError&#39;;<tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td><tr><td><a name="l78" href="#l78">78</a><td>/**<tr><td><a name="l79" href="#l79">79</a><td> * Throws an exception with the given message and &quot;Assertion failed&quot; prefixed<tr><td><a name="l80" href="#l80">80</a><td> * onto it.<tr><td><a name="l81" href="#l81">81</a><td> * @param {string} defaultMessage The message to use if givenMessage is empty.<tr><td><a name="l82" href="#l82">82</a><td> * @param {Array.&lt;*&gt;} defaultArgs The substitution arguments for defaultMessage.<tr><td><a name="l83" href="#l83">83</a><td> * @param {string|undefined} givenMessage Message supplied by the caller.<tr><td><a name="l84" href="#l84">84</a><td> * @param {Array.&lt;*&gt;} givenArgs The substitution arguments for givenMessage.<tr><td><a name="l85" href="#l85">85</a><td> * @throws {goog.asserts.AssertionError} When the value is not a number.<tr><td><a name="l86" href="#l86">86</a><td> * @private<tr><td><a name="l87" href="#l87">87</a><td> */<tr><td><a name="l88" href="#l88">88</a><td>goog.asserts.doAssertFailure_ =<tr><td><a name="l89" href="#l89">89</a><td>    function(defaultMessage, defaultArgs, givenMessage, givenArgs) {<tr><td><a name="l90" href="#l90">90</a><td>  var message = &#39;Assertion failed&#39;;<tr><td><a name="l91" href="#l91">91</a><td>  if (givenMessage) {<tr><td><a name="l92" href="#l92">92</a><td>    message += &#39;: &#39; + givenMessage;<tr><td><a name="l93" href="#l93">93</a><td>    var args = givenArgs;<tr><td><a name="l94" href="#l94">94</a><td>  } else if (defaultMessage) {<tr><td><a name="l95" href="#l95">95</a><td>    message += &#39;: &#39; + defaultMessage;<tr><td><a name="l96" href="#l96">96</a><td>    args = defaultArgs;<tr><td><a name="l97" href="#l97">97</a><td>  }<tr><td><a name="l98" href="#l98">98</a><td>  // The &#39;&#39; + works around an Opera 10 bug in the unit tests. Without it,<tr><td><a name="l99" href="#l99">99</a><td>  // a stack trace is added to var message above. With this, a stack trace is<tr><td><a name="l100" href="#l100">100</a><td>  // not added until this line (it causes the extra garbage to be added after<tr><td><a name="l101" href="#l101">101</a><td>  // the assertion message instead of in the middle of it).<tr><td><a name="l102" href="#l102">102</a><td>  throw new goog.asserts.AssertionError(&#39;&#39; + message, args || []);<tr><td><a name="l103" href="#l103">103</a><td>};<tr><td><a name="l104" href="#l104">104</a><td><tr><td><a name="l105" href="#l105">105</a><td><tr><td><a name="l106" href="#l106">106</a><td>/**<tr><td><a name="l107" href="#l107">107</a><td> * Checks if the condition evaluates to true if goog.asserts.ENABLE_ASSERTS is<tr><td><a name="l108" href="#l108">108</a><td> * true.<tr><td><a name="l109" href="#l109">109</a><td> * @param {*} condition The condition to check.<tr><td><a name="l110" href="#l110">110</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l111" href="#l111">111</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l112" href="#l112">112</a><td> * @return {*} The value of the condition.<tr><td><a name="l113" href="#l113">113</a><td> * @throws {goog.asserts.AssertionError} When the condition evaluates to false.<tr><td><a name="l114" href="#l114">114</a><td> */<tr><td><a name="l115" href="#l115">115</a><td>goog.asserts.assert = function(condition, opt_message, var_args) {<tr><td><a name="l116" href="#l116">116</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !condition) {<tr><td><a name="l117" href="#l117">117</a><td>    goog.asserts.doAssertFailure_(&#39;&#39;, null, opt_message,<tr><td><a name="l118" href="#l118">118</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a name="l119" href="#l119">119</a><td>  }<tr><td><a name="l120" href="#l120">120</a><td>  return condition;<tr><td><a name="l121" href="#l121">121</a><td>};<tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td><tr><td><a name="l124" href="#l124">124</a><td>/**<tr><td><a name="l125" href="#l125">125</a><td> * Fails if goog.asserts.ENABLE_ASSERTS is true. This function is useful in case<tr><td><a name="l126" href="#l126">126</a><td> * when we want to add a check in the unreachable area like switch-case<tr><td><a name="l127" href="#l127">127</a><td> * statement:<tr><td><a name="l128" href="#l128">128</a><td> *<tr><td><a name="l129" href="#l129">129</a><td> * &lt;pre&gt;<tr><td><a name="l130" href="#l130">130</a><td> *  switch(type) {<tr><td><a name="l131" href="#l131">131</a><td> *    case FOO: doSomething(); break;<tr><td><a name="l132" href="#l132">132</a><td> *    case BAR: doSomethingElse(); break;<tr><td><a name="l133" href="#l133">133</a><td> *    default: goog.assert.fail(&#39;Unrecognized type: &#39; + type);<tr><td><a name="l134" href="#l134">134</a><td> *      // We have only 2 types - &quot;default:&quot; section is unreachable code.<tr><td><a name="l135" href="#l135">135</a><td> *  }<tr><td><a name="l136" href="#l136">136</a><td> * &lt;/pre&gt;<tr><td><a name="l137" href="#l137">137</a><td> *<tr><td><a name="l138" href="#l138">138</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l139" href="#l139">139</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l140" href="#l140">140</a><td> * @throws {goog.asserts.AssertionError} Failure.<tr><td><a name="l141" href="#l141">141</a><td> */<tr><td><a name="l142" href="#l142">142</a><td>goog.asserts.fail = function(opt_message, var_args) {<tr><td><a name="l143" href="#l143">143</a><td>  if (goog.asserts.ENABLE_ASSERTS) {<tr><td><a name="l144" href="#l144">144</a><td>    throw new goog.asserts.AssertionError(<tr><td><a name="l145" href="#l145">145</a><td>        &#39;Failure&#39; + (opt_message ? &#39;: &#39; + opt_message : &#39;&#39;),<tr><td><a name="l146" href="#l146">146</a><td>        Array.prototype.slice.call(arguments, 1));<tr><td><a name="l147" href="#l147">147</a><td>  }<tr><td><a name="l148" href="#l148">148</a><td>};<tr><td><a name="l149" href="#l149">149</a><td><tr><td><a name="l150" href="#l150">150</a><td><tr><td><a name="l151" href="#l151">151</a><td>/**<tr><td><a name="l152" href="#l152">152</a><td> * Checks if the value is a number if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a name="l153" href="#l153">153</a><td> * @param {*} value The value to check.<tr><td><a name="l154" href="#l154">154</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l155" href="#l155">155</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l156" href="#l156">156</a><td> * @return {number} The value, guaranteed to be a number when asserts enabled.<tr><td><a name="l157" href="#l157">157</a><td> * @throws {goog.asserts.AssertionError} When the value is not a number.<tr><td><a name="l158" href="#l158">158</a><td> */<tr><td><a name="l159" href="#l159">159</a><td>goog.asserts.assertNumber = function(value, opt_message, var_args) {<tr><td><a name="l160" href="#l160">160</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isNumber(value)) {<tr><td><a name="l161" href="#l161">161</a><td>    goog.asserts.doAssertFailure_(&#39;Expected number but got %s: %s.&#39;,<tr><td><a name="l162" href="#l162">162</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a name="l163" href="#l163">163</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a name="l164" href="#l164">164</a><td>  }<tr><td><a name="l165" href="#l165">165</a><td>  return /** @type {number} */ (value);<tr><td><a name="l166" href="#l166">166</a><td>};<tr><td><a name="l167" href="#l167">167</a><td><tr><td><a name="l168" href="#l168">168</a><td><tr><td><a name="l169" href="#l169">169</a><td>/**<tr><td><a name="l170" href="#l170">170</a><td> * Checks if the value is a string if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a name="l171" href="#l171">171</a><td> * @param {*} value The value to check.<tr><td><a name="l172" href="#l172">172</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l173" href="#l173">173</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l174" href="#l174">174</a><td> * @return {string} The value, guaranteed to be a string when asserts enabled.<tr><td><a name="l175" href="#l175">175</a><td> * @throws {goog.asserts.AssertionError} When the value is not a string.<tr><td><a name="l176" href="#l176">176</a><td> */<tr><td><a name="l177" href="#l177">177</a><td>goog.asserts.assertString = function(value, opt_message, var_args) {<tr><td><a name="l178" href="#l178">178</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isString(value)) {<tr><td><a name="l179" href="#l179">179</a><td>    goog.asserts.doAssertFailure_(&#39;Expected string but got %s: %s.&#39;,<tr><td><a name="l180" href="#l180">180</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a name="l181" href="#l181">181</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a name="l182" href="#l182">182</a><td>  }<tr><td><a name="l183" href="#l183">183</a><td>  return /** @type {string} */ (value);<tr><td><a name="l184" href="#l184">184</a><td>};<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td>/**<tr><td><a name="l188" href="#l188">188</a><td> * Checks if the value is a function if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a name="l189" href="#l189">189</a><td> * @param {*} value The value to check.<tr><td><a name="l190" href="#l190">190</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l191" href="#l191">191</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l192" href="#l192">192</a><td> * @return {!Function} The value, guaranteed to be a function when asserts<tr><td><a name="l193" href="#l193">193</a><td> *     enabled.<tr><td><a name="l194" href="#l194">194</a><td> * @throws {goog.asserts.AssertionError} When the value is not a function.<tr><td><a name="l195" href="#l195">195</a><td> */<tr><td><a name="l196" href="#l196">196</a><td>goog.asserts.assertFunction = function(value, opt_message, var_args) {<tr><td><a name="l197" href="#l197">197</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isFunction(value)) {<tr><td><a name="l198" href="#l198">198</a><td>    goog.asserts.doAssertFailure_(&#39;Expected function but got %s: %s.&#39;,<tr><td><a name="l199" href="#l199">199</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a name="l200" href="#l200">200</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a name="l201" href="#l201">201</a><td>  }<tr><td><a name="l202" href="#l202">202</a><td>  return /** @type {!Function} */ (value);<tr><td><a name="l203" href="#l203">203</a><td>};<tr><td><a name="l204" href="#l204">204</a><td><tr><td><a name="l205" href="#l205">205</a><td><tr><td><a name="l206" href="#l206">206</a><td>/**<tr><td><a name="l207" href="#l207">207</a><td> * Checks if the value is an Object if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a name="l208" href="#l208">208</a><td> * @param {*} value The value to check.<tr><td><a name="l209" href="#l209">209</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l210" href="#l210">210</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l211" href="#l211">211</a><td> * @return {!Object} The value, guaranteed to be a non-null object.<tr><td><a name="l212" href="#l212">212</a><td> * @throws {goog.asserts.AssertionError} When the value is not an object.<tr><td><a name="l213" href="#l213">213</a><td> */<tr><td><a name="l214" href="#l214">214</a><td>goog.asserts.assertObject = function(value, opt_message, var_args) {<tr><td><a name="l215" href="#l215">215</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isObject(value)) {<tr><td><a name="l216" href="#l216">216</a><td>    goog.asserts.doAssertFailure_(&#39;Expected object but got %s: %s.&#39;,<tr><td><a name="l217" href="#l217">217</a><td>        [goog.typeOf(value), value],<tr><td><a name="l218" href="#l218">218</a><td>        opt_message, Array.prototype.slice.call(arguments, 2));<tr><td><a name="l219" href="#l219">219</a><td>  }<tr><td><a name="l220" href="#l220">220</a><td>  return /** @type {!Object} */ (value);<tr><td><a name="l221" href="#l221">221</a><td>};<tr><td><a name="l222" href="#l222">222</a><td><tr><td><a name="l223" href="#l223">223</a><td><tr><td><a name="l224" href="#l224">224</a><td>/**<tr><td><a name="l225" href="#l225">225</a><td> * Checks if the value is an Array if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a name="l226" href="#l226">226</a><td> * @param {*} value The value to check.<tr><td><a name="l227" href="#l227">227</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l228" href="#l228">228</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l229" href="#l229">229</a><td> * @return {!Array} The value, guaranteed to be a non-null array.<tr><td><a name="l230" href="#l230">230</a><td> * @throws {goog.asserts.AssertionError} When the value is not an array.<tr><td><a name="l231" href="#l231">231</a><td> */<tr><td><a name="l232" href="#l232">232</a><td>goog.asserts.assertArray = function(value, opt_message, var_args) {<tr><td><a name="l233" href="#l233">233</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isArray(value)) {<tr><td><a name="l234" href="#l234">234</a><td>    goog.asserts.doAssertFailure_(&#39;Expected array but got %s: %s.&#39;,<tr><td><a name="l235" href="#l235">235</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a name="l236" href="#l236">236</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a name="l237" href="#l237">237</a><td>  }<tr><td><a name="l238" href="#l238">238</a><td>  return /** @type {!Array} */ (value);<tr><td><a name="l239" href="#l239">239</a><td>};<tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td><tr><td><a name="l242" href="#l242">242</a><td>/**<tr><td><a name="l243" href="#l243">243</a><td> * Checks if the value is a boolean if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a name="l244" href="#l244">244</a><td> * @param {*} value The value to check.<tr><td><a name="l245" href="#l245">245</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l246" href="#l246">246</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l247" href="#l247">247</a><td> * @return {boolean} The value, guaranteed to be a boolean when asserts are<tr><td><a name="l248" href="#l248">248</a><td> *     enabled.<tr><td><a name="l249" href="#l249">249</a><td> * @throws {goog.asserts.AssertionError} When the value is not a boolean.<tr><td><a name="l250" href="#l250">250</a><td> */<tr><td><a name="l251" href="#l251">251</a><td>goog.asserts.assertBoolean = function(value, opt_message, var_args) {<tr><td><a name="l252" href="#l252">252</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isBoolean(value)) {<tr><td><a name="l253" href="#l253">253</a><td>    goog.asserts.doAssertFailure_(&#39;Expected boolean but got %s: %s.&#39;,<tr><td><a name="l254" href="#l254">254</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a name="l255" href="#l255">255</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a name="l256" href="#l256">256</a><td>  }<tr><td><a name="l257" href="#l257">257</a><td>  return /** @type {boolean} */ (value);<tr><td><a name="l258" href="#l258">258</a><td>};<tr><td><a name="l259" href="#l259">259</a><td><tr><td><a name="l260" href="#l260">260</a><td><tr><td><a name="l261" href="#l261">261</a><td>/**<tr><td><a name="l262" href="#l262">262</a><td> * Checks if the value is an instance of the user-defined type if<tr><td><a name="l263" href="#l263">263</a><td> * goog.asserts.ENABLE_ASSERTS is true.<tr><td><a name="l264" href="#l264">264</a><td> *<tr><td><a name="l265" href="#l265">265</a><td> * The compiler may tighten the type returned by this function.<tr><td><a name="l266" href="#l266">266</a><td> *<tr><td><a name="l267" href="#l267">267</a><td> * @param {*} value The value to check.<tr><td><a name="l268" href="#l268">268</a><td> * @param {function(new: T, ...)} type A user-defined constructor.<tr><td><a name="l269" href="#l269">269</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a name="l270" href="#l270">270</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a name="l271" href="#l271">271</a><td> * @throws {goog.asserts.AssertionError} When the value is not an instance of<tr><td><a name="l272" href="#l272">272</a><td> *     type.<tr><td><a name="l273" href="#l273">273</a><td> * @return {!T}<tr><td><a name="l274" href="#l274">274</a><td> * @template T<tr><td><a name="l275" href="#l275">275</a><td> */<tr><td><a name="l276" href="#l276">276</a><td>goog.asserts.assertInstanceof = function(value, type, opt_message, var_args) {<tr><td><a name="l277" href="#l277">277</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !(value instanceof type)) {<tr><td><a name="l278" href="#l278">278</a><td>    goog.asserts.doAssertFailure_(&#39;instanceof check failed.&#39;, null,<tr><td><a name="l279" href="#l279">279</a><td>        opt_message, Array.prototype.slice.call(arguments, 3));<tr><td><a name="l280" href="#l280">280</a><td>  }<tr><td><a name="l281" href="#l281">281</a><td>  return value;<tr><td><a name="l282" href="#l282">282</a><td>};<tr><td><a name="l283" href="#l283">283</a><td></table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>asserts.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/asserts/asserts.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities to check the preconditions, postconditions and<tr><td><a id="l17"></a><a href="#l17">17</a><td> * invariants runtime.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * Methods in this package should be given special treatment by the compiler<tr><td><a id="l20"></a><a href="#l20">20</a><td> * for type-inference. For example, &lt;code&gt;goog.asserts.assert(foo)&lt;/code&gt;<tr><td><a id="l21"></a><a href="#l21">21</a><td> * will restrict &lt;code&gt;foo&lt;/code&gt; to a truthy value.<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * The compiler has an option to disable asserts. So code like:<tr><td><a id="l24"></a><a href="#l24">24</a><td> * &lt;code&gt;<tr><td><a id="l25"></a><a href="#l25">25</a><td> * var x = goog.asserts.assert(foo()); goog.asserts.assert(bar());<tr><td><a id="l26"></a><a href="#l26">26</a><td> * &lt;/code&gt;<tr><td><a id="l27"></a><a href="#l27">27</a><td> * will be transformed into:<tr><td><a id="l28"></a><a href="#l28">28</a><td> * &lt;code&gt;<tr><td><a id="l29"></a><a href="#l29">29</a><td> * var x = foo();<tr><td><a id="l30"></a><a href="#l30">30</a><td> * &lt;/code&gt;<tr><td><a id="l31"></a><a href="#l31">31</a><td> * The compiler will leave in foo() (because its return value is used),<tr><td><a id="l32"></a><a href="#l32">32</a><td> * but it will remove bar() because it assumes it does not have side-effects.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @author agrieve@google.com (Andrew Grieve)<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>goog.provide(&#39;goog.asserts&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.provide(&#39;goog.asserts.AssertionError&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.debug.Error&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.dom.NodeType&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @define {boolean} Whether to strip out asserts or to leave them in.<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.define(&#39;goog.asserts.ENABLE_ASSERTS&#39;, goog.DEBUG);<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>/**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * Error object for failed assertions.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {string} messagePattern The pattern that was used to form message.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {!Array&lt;*&gt;} messageArgs The items to substitute into the pattern.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @constructor<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @extends {goog.debug.Error}<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @final<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.asserts.AssertionError = function(messagePattern, messageArgs) {<tr><td><a id="l61"></a><a href="#l61">61</a><td>  messageArgs.unshift(messagePattern);<tr><td><a id="l62"></a><a href="#l62">62</a><td>  goog.debug.Error.call(this, goog.string.subs.apply(null, messageArgs));<tr><td><a id="l63"></a><a href="#l63">63</a><td>  // Remove the messagePattern afterwards to avoid permanently modifying the<tr><td><a id="l64"></a><a href="#l64">64</a><td>  // passed in array.<tr><td><a id="l65"></a><a href="#l65">65</a><td>  messageArgs.shift();<tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>  /**<tr><td><a id="l68"></a><a href="#l68">68</a><td>   * The message pattern used to format the error message. Error handlers can<tr><td><a id="l69"></a><a href="#l69">69</a><td>   * use this to uniquely identify the assertion.<tr><td><a id="l70"></a><a href="#l70">70</a><td>   * @type {string}<tr><td><a id="l71"></a><a href="#l71">71</a><td>   */<tr><td><a id="l72"></a><a href="#l72">72</a><td>  this.messagePattern = messagePattern;<tr><td><a id="l73"></a><a href="#l73">73</a><td>};<tr><td><a id="l74"></a><a href="#l74">74</a><td>goog.inherits(goog.asserts.AssertionError, goog.debug.Error);<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/** @override */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.asserts.AssertionError.prototype.name = &#39;AssertionError&#39;;<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td>/**<tr><td><a id="l82"></a><a href="#l82">82</a><td> * The default error handler.<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @param {!goog.asserts.AssertionError} e The exception to be handled.<tr><td><a id="l84"></a><a href="#l84">84</a><td> */<tr><td><a id="l85"></a><a href="#l85">85</a><td>goog.asserts.DEFAULT_ERROR_HANDLER = function(e) { throw e; };<tr><td><a id="l86"></a><a href="#l86">86</a><td><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> * The handler responsible for throwing or logging assertion errors.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @private {function(!goog.asserts.AssertionError)}<tr><td><a id="l91"></a><a href="#l91">91</a><td> */<tr><td><a id="l92"></a><a href="#l92">92</a><td>goog.asserts.errorHandler_ = goog.asserts.DEFAULT_ERROR_HANDLER;<tr><td><a id="l93"></a><a href="#l93">93</a><td><tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td>/**<tr><td><a id="l96"></a><a href="#l96">96</a><td> * Throws an exception with the given message and &quot;Assertion failed&quot; prefixed<tr><td><a id="l97"></a><a href="#l97">97</a><td> * onto it.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @param {string} defaultMessage The message to use if givenMessage is empty.<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @param {Array&lt;*&gt;} defaultArgs The substitution arguments for defaultMessage.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {string|undefined} givenMessage Message supplied by the caller.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {Array&lt;*&gt;} givenArgs The substitution arguments for givenMessage.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @throws {goog.asserts.AssertionError} When the value is not a number.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @private<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.asserts.doAssertFailure_ =<tr><td><a id="l106"></a><a href="#l106">106</a><td>    function(defaultMessage, defaultArgs, givenMessage, givenArgs) {<tr><td><a id="l107"></a><a href="#l107">107</a><td>  var message = &#39;Assertion failed&#39;;<tr><td><a id="l108"></a><a href="#l108">108</a><td>  if (givenMessage) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>    message += &#39;: &#39; + givenMessage;<tr><td><a id="l110"></a><a href="#l110">110</a><td>    var args = givenArgs;<tr><td><a id="l111"></a><a href="#l111">111</a><td>  } else if (defaultMessage) {<tr><td><a id="l112"></a><a href="#l112">112</a><td>    message += &#39;: &#39; + defaultMessage;<tr><td><a id="l113"></a><a href="#l113">113</a><td>    args = defaultArgs;<tr><td><a id="l114"></a><a href="#l114">114</a><td>  }<tr><td><a id="l115"></a><a href="#l115">115</a><td>  // The &#39;&#39; + works around an Opera 10 bug in the unit tests. Without it,<tr><td><a id="l116"></a><a href="#l116">116</a><td>  // a stack trace is added to var message above. With this, a stack trace is<tr><td><a id="l117"></a><a href="#l117">117</a><td>  // not added until this line (it causes the extra garbage to be added after<tr><td><a id="l118"></a><a href="#l118">118</a><td>  // the assertion message instead of in the middle of it).<tr><td><a id="l119"></a><a href="#l119">119</a><td>  var e = new goog.asserts.AssertionError(&#39;&#39; + message, args || []);<tr><td><a id="l120"></a><a href="#l120">120</a><td>  goog.asserts.errorHandler_(e);<tr><td><a id="l121"></a><a href="#l121">121</a><td>};<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>/**<tr><td><a id="l125"></a><a href="#l125">125</a><td> * Sets a custom error handler that can be used to customize the behavior of<tr><td><a id="l126"></a><a href="#l126">126</a><td> * assertion failures, for example by turning all assertion failures into log<tr><td><a id="l127"></a><a href="#l127">127</a><td> * messages.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {function(!goog.asserts.AssertionError)} errorHandler<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.asserts.setErrorHandler = function(errorHandler) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>  if (goog.asserts.ENABLE_ASSERTS) {<tr><td><a id="l132"></a><a href="#l132">132</a><td>    goog.asserts.errorHandler_ = errorHandler;<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><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Checks if the condition evaluates to true if goog.asserts.ENABLE_ASSERTS is<tr><td><a id="l139"></a><a href="#l139">139</a><td> * true.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @template T<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {T} condition The condition to check.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @return {T} The value of the condition.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @throws {goog.asserts.AssertionError} When the condition evaluates to false.<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.asserts.assert = function(condition, opt_message, var_args) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !condition) {<tr><td><a id="l149"></a><a href="#l149">149</a><td>    goog.asserts.doAssertFailure_(&#39;&#39;, null, opt_message,<tr><td><a id="l150"></a><a href="#l150">150</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a id="l151"></a><a href="#l151">151</a><td>  }<tr><td><a id="l152"></a><a href="#l152">152</a><td>  return condition;<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> * Fails if goog.asserts.ENABLE_ASSERTS is true. This function is useful in case<tr><td><a id="l158"></a><a href="#l158">158</a><td> * when we want to add a check in the unreachable area like switch-case<tr><td><a id="l159"></a><a href="#l159">159</a><td> * statement:<tr><td><a id="l160"></a><a href="#l160">160</a><td> *<tr><td><a id="l161"></a><a href="#l161">161</a><td> * &lt;pre&gt;<tr><td><a id="l162"></a><a href="#l162">162</a><td> *  switch(type) {<tr><td><a id="l163"></a><a href="#l163">163</a><td> *    case FOO: doSomething(); break;<tr><td><a id="l164"></a><a href="#l164">164</a><td> *    case BAR: doSomethingElse(); break;<tr><td><a id="l165"></a><a href="#l165">165</a><td> *    default: goog.assert.fail(&#39;Unrecognized type: &#39; + type);<tr><td><a id="l166"></a><a href="#l166">166</a><td> *      // We have only 2 types - &quot;default:&quot; section is unreachable code.<tr><td><a id="l167"></a><a href="#l167">167</a><td> *  }<tr><td><a id="l168"></a><a href="#l168">168</a><td> * &lt;/pre&gt;<tr><td><a id="l169"></a><a href="#l169">169</a><td> *<tr><td><a id="l170"></a><a href="#l170">170</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l172"></a><a href="#l172">172</a><td> * @throws {goog.asserts.AssertionError} Failure.<tr><td><a id="l173"></a><a href="#l173">173</a><td> */<tr><td><a id="l174"></a><a href="#l174">174</a><td>goog.asserts.fail = function(opt_message, var_args) {<tr><td><a id="l175"></a><a href="#l175">175</a><td>  if (goog.asserts.ENABLE_ASSERTS) {<tr><td><a id="l176"></a><a href="#l176">176</a><td>    goog.asserts.errorHandler_(new goog.asserts.AssertionError(<tr><td><a id="l177"></a><a href="#l177">177</a><td>        &#39;Failure&#39; + (opt_message ? &#39;: &#39; + opt_message : &#39;&#39;),<tr><td><a id="l178"></a><a href="#l178">178</a><td>        Array.prototype.slice.call(arguments, 1)));<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><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Checks if the value is a number if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @param {*} value The value to check.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @return {number} The value, guaranteed to be a number when asserts enabled.<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @throws {goog.asserts.AssertionError} When the value is not a number.<tr><td><a id="l190"></a><a href="#l190">190</a><td> */<tr><td><a id="l191"></a><a href="#l191">191</a><td>goog.asserts.assertNumber = function(value, opt_message, var_args) {<tr><td><a id="l192"></a><a href="#l192">192</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isNumber(value)) {<tr><td><a id="l193"></a><a href="#l193">193</a><td>    goog.asserts.doAssertFailure_(&#39;Expected number but got %s: %s.&#39;,<tr><td><a id="l194"></a><a href="#l194">194</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a id="l195"></a><a href="#l195">195</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a id="l196"></a><a href="#l196">196</a><td>  }<tr><td><a id="l197"></a><a href="#l197">197</a><td>  return /** @type {number} */ (value);<tr><td><a id="l198"></a><a href="#l198">198</a><td>};<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> * Checks if the value is a string if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {*} value The value to check.<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {string} The value, guaranteed to be a string when asserts enabled.<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @throws {goog.asserts.AssertionError} When the value is not a string.<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.asserts.assertString = function(value, opt_message, var_args) {<tr><td><a id="l210"></a><a href="#l210">210</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isString(value)) {<tr><td><a id="l211"></a><a href="#l211">211</a><td>    goog.asserts.doAssertFailure_(&#39;Expected string but got %s: %s.&#39;,<tr><td><a id="l212"></a><a href="#l212">212</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a id="l213"></a><a href="#l213">213</a><td>        Array.prototype.slice.call(arguments, 2));<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 /** @type {string} */ (value);<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> * Checks if the value is a function if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {*} value The value to check.<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @return {!Function} The value, guaranteed to be a function when asserts<tr><td><a id="l225"></a><a href="#l225">225</a><td> *     enabled.<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @throws {goog.asserts.AssertionError} When the value is not a function.<tr><td><a id="l227"></a><a href="#l227">227</a><td> */<tr><td><a id="l228"></a><a href="#l228">228</a><td>goog.asserts.assertFunction = function(value, opt_message, var_args) {<tr><td><a id="l229"></a><a href="#l229">229</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isFunction(value)) {<tr><td><a id="l230"></a><a href="#l230">230</a><td>    goog.asserts.doAssertFailure_(&#39;Expected function but got %s: %s.&#39;,<tr><td><a id="l231"></a><a href="#l231">231</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a id="l232"></a><a href="#l232">232</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a id="l233"></a><a href="#l233">233</a><td>  }<tr><td><a id="l234"></a><a href="#l234">234</a><td>  return /** @type {!Function} */ (value);<tr><td><a id="l235"></a><a href="#l235">235</a><td>};<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Checks if the value is an Object if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {*} value The value to check.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @return {!Object} The value, guaranteed to be a non-null object.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @throws {goog.asserts.AssertionError} When the value is not an object.<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>goog.asserts.assertObject = function(value, opt_message, var_args) {<tr><td><a id="l247"></a><a href="#l247">247</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isObject(value)) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>    goog.asserts.doAssertFailure_(&#39;Expected object but got %s: %s.&#39;,<tr><td><a id="l249"></a><a href="#l249">249</a><td>        [goog.typeOf(value), value],<tr><td><a id="l250"></a><a href="#l250">250</a><td>        opt_message, Array.prototype.slice.call(arguments, 2));<tr><td><a id="l251"></a><a href="#l251">251</a><td>  }<tr><td><a id="l252"></a><a href="#l252">252</a><td>  return /** @type {!Object} */ (value);<tr><td><a id="l253"></a><a href="#l253">253</a><td>};<tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td><tr><td><a id="l256"></a><a href="#l256">256</a><td>/**<tr><td><a id="l257"></a><a href="#l257">257</a><td> * Checks if the value is an Array if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @param {*} value The value to check.<tr><td><a id="l259"></a><a href="#l259">259</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @return {!Array&lt;?&gt;} The value, guaranteed to be a non-null array.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @throws {goog.asserts.AssertionError} When the value is not an array.<tr><td><a id="l263"></a><a href="#l263">263</a><td> */<tr><td><a id="l264"></a><a href="#l264">264</a><td>goog.asserts.assertArray = function(value, opt_message, var_args) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isArray(value)) {<tr><td><a id="l266"></a><a href="#l266">266</a><td>    goog.asserts.doAssertFailure_(&#39;Expected array but got %s: %s.&#39;,<tr><td><a id="l267"></a><a href="#l267">267</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a id="l268"></a><a href="#l268">268</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a id="l269"></a><a href="#l269">269</a><td>  }<tr><td><a id="l270"></a><a href="#l270">270</a><td>  return /** @type {!Array&lt;?&gt;} */ (value);<tr><td><a id="l271"></a><a href="#l271">271</a><td>};<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> * Checks if the value is a boolean if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @param {*} value The value to check.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @return {boolean} The value, guaranteed to be a boolean when asserts are<tr><td><a id="l280"></a><a href="#l280">280</a><td> *     enabled.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @throws {goog.asserts.AssertionError} When the value is not a boolean.<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.asserts.assertBoolean = function(value, opt_message, var_args) {<tr><td><a id="l284"></a><a href="#l284">284</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !goog.isBoolean(value)) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>    goog.asserts.doAssertFailure_(&#39;Expected boolean but got %s: %s.&#39;,<tr><td><a id="l286"></a><a href="#l286">286</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a id="l287"></a><a href="#l287">287</a><td>        Array.prototype.slice.call(arguments, 2));<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 /** @type {boolean} */ (value);<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> * Checks if the value is a DOM Element if goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @param {*} value The value to check.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @return {!Element} The value, likely to be a DOM Element when asserts are<tr><td><a id="l299"></a><a href="#l299">299</a><td> *     enabled.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @throws {goog.asserts.AssertionError} When the value is not an Element.<tr><td><a id="l301"></a><a href="#l301">301</a><td> */<tr><td><a id="l302"></a><a href="#l302">302</a><td>goog.asserts.assertElement = function(value, opt_message, var_args) {<tr><td><a id="l303"></a><a href="#l303">303</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; (!goog.isObject(value) ||<tr><td><a id="l304"></a><a href="#l304">304</a><td>      value.nodeType != goog.dom.NodeType.ELEMENT)) {<tr><td><a id="l305"></a><a href="#l305">305</a><td>    goog.asserts.doAssertFailure_(&#39;Expected Element but got %s: %s.&#39;,<tr><td><a id="l306"></a><a href="#l306">306</a><td>        [goog.typeOf(value), value], opt_message,<tr><td><a id="l307"></a><a href="#l307">307</a><td>        Array.prototype.slice.call(arguments, 2));<tr><td><a id="l308"></a><a href="#l308">308</a><td>  }<tr><td><a id="l309"></a><a href="#l309">309</a><td>  return /** @type {!Element} */ (value);<tr><td><a id="l310"></a><a href="#l310">310</a><td>};<tr><td><a id="l311"></a><a href="#l311">311</a><td><tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td>/**<tr><td><a id="l314"></a><a href="#l314">314</a><td> * Checks if the value is an instance of the user-defined type if<tr><td><a id="l315"></a><a href="#l315">315</a><td> * goog.asserts.ENABLE_ASSERTS is true.<tr><td><a id="l316"></a><a href="#l316">316</a><td> *<tr><td><a id="l317"></a><a href="#l317">317</a><td> * The compiler may tighten the type returned by this function.<tr><td><a id="l318"></a><a href="#l318">318</a><td> *<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @param {?} value The value to check.<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {function(new: T, ...)} type A user-defined constructor.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @param {string=} opt_message Error message in case of failure.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {...*} var_args The items to substitute into the failure message.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @throws {goog.asserts.AssertionError} When the value is not an instance of<tr><td><a id="l324"></a><a href="#l324">324</a><td> *     type.<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @return {T}<tr><td><a id="l326"></a><a href="#l326">326</a><td> * @template T<tr><td><a id="l327"></a><a href="#l327">327</a><td> */<tr><td><a id="l328"></a><a href="#l328">328</a><td>goog.asserts.assertInstanceof = function(value, type, opt_message, var_args) {<tr><td><a id="l329"></a><a href="#l329">329</a><td>  if (goog.asserts.ENABLE_ASSERTS &amp;&amp; !(value instanceof type)) {<tr><td><a id="l330"></a><a href="#l330">330</a><td>    goog.asserts.doAssertFailure_(&#39;Expected instanceof %s but got %s.&#39;,<tr><td><a id="l331"></a><a href="#l331">331</a><td>        [goog.asserts.getType_(type), goog.asserts.getType_(value)],<tr><td><a id="l332"></a><a href="#l332">332</a><td>        opt_message, Array.prototype.slice.call(arguments, 3));<tr><td><a id="l333"></a><a href="#l333">333</a><td>  }<tr><td><a id="l334"></a><a href="#l334">334</a><td>  return value;<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td>/**<tr><td><a id="l339"></a><a href="#l339">339</a><td> * Checks that no enumerable keys are present in Object.prototype. Such keys<tr><td><a id="l340"></a><a href="#l340">340</a><td> * would break most code that use {@code for (var ... in ...)} loops.<tr><td><a id="l341"></a><a href="#l341">341</a><td> */<tr><td><a id="l342"></a><a href="#l342">342</a><td>goog.asserts.assertObjectPrototypeIsIntact = function() {<tr><td><a id="l343"></a><a href="#l343">343</a><td>  for (var key in Object.prototype) {<tr><td><a id="l344"></a><a href="#l344">344</a><td>    goog.asserts.fail(key + &#39; should not be enumerable in Object.prototype.&#39;);<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><tr><td><a id="l349"></a><a href="#l349">349</a><td>/**<tr><td><a id="l350"></a><a href="#l350">350</a><td> * Returns the type of a value. If a constructor is passed, and a suitable<tr><td><a id="l351"></a><a href="#l351">351</a><td> * string cannot be found, &#39;unknown type name&#39; will be returned.<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @param {*} value A constructor, object, or primitive.<tr><td><a id="l353"></a><a href="#l353">353</a><td> * @return {string} The best display name for the value, or &#39;unknown type name&#39;.<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @private<tr><td><a id="l355"></a><a href="#l355">355</a><td> */<tr><td><a id="l356"></a><a href="#l356">356</a><td>goog.asserts.getType_ = function(value) {<tr><td><a id="l357"></a><a href="#l357">357</a><td>  if (value instanceof Function) {<tr><td><a id="l358"></a><a href="#l358">358</a><td>    return value.displayName || value.name || &#39;unknown type name&#39;;<tr><td><a id="l359"></a><a href="#l359">359</a><td>  } else if (value instanceof Object) {<tr><td><a id="l360"></a><a href="#l360">360</a><td>    return value.constructor.displayName || value.constructor.name ||<tr><td><a id="l361"></a><a href="#l361">361</a><td>        Object.prototype.toString.call(value);<tr><td><a id="l362"></a><a href="#l362">362</a><td>  } else {<tr><td><a id="l363"></a><a href="#l363">363</a><td>    return value === null ? &#39;null&#39; : typeof value;<tr><td><a id="l364"></a><a href="#l364">364</a><td>  }<tr><td><a id="l365"></a><a href="#l365">365</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/async/freelist.js.src.html b/docs/source/lib/goog/async/freelist.js.src.html
new file mode 100644
index 0000000..6c76c1c
--- /dev/null
+++ b/docs/source/lib/goog/async/freelist.js.src.html
@@ -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>freelist.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/async/freelist.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2015 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Simple freelist.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * An anterative to goog.structs.SimplePool, it imposes the requirement that the<tr><td><a id="l19"></a><a href="#l19">19</a><td> * objects in the list contain a &quot;next&quot; property that can be used to maintain<tr><td><a id="l20"></a><a href="#l20">20</a><td> * the pool.<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>goog.provide(&#39;goog.async.FreeList&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @template ITEM<tr><td><a id="l28"></a><a href="#l28">28</a><td> */<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.async.FreeList = goog.defineClass(null, {<tr><td><a id="l30"></a><a href="#l30">30</a><td>  /**<tr><td><a id="l31"></a><a href="#l31">31</a><td>   * @param {function():ITEM} create<tr><td><a id="l32"></a><a href="#l32">32</a><td>   * @param {function(ITEM):void} reset<tr><td><a id="l33"></a><a href="#l33">33</a><td>   * @param {number} limit<tr><td><a id="l34"></a><a href="#l34">34</a><td>   */<tr><td><a id="l35"></a><a href="#l35">35</a><td>  constructor: function(create, reset, limit) {<tr><td><a id="l36"></a><a href="#l36">36</a><td>    /** @const {number} */<tr><td><a id="l37"></a><a href="#l37">37</a><td>    this.limit_ = limit;<tr><td><a id="l38"></a><a href="#l38">38</a><td>    /** @const {function()} */<tr><td><a id="l39"></a><a href="#l39">39</a><td>    this.create_ = create;<tr><td><a id="l40"></a><a href="#l40">40</a><td>    /** @const {function(ITEM):void} */<tr><td><a id="l41"></a><a href="#l41">41</a><td>    this.reset_ = reset;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td>    /** @type {number} */<tr><td><a id="l44"></a><a href="#l44">44</a><td>    this.occupants_ = 0;<tr><td><a id="l45"></a><a href="#l45">45</a><td>    /** @type {ITEM} */<tr><td><a id="l46"></a><a href="#l46">46</a><td>    this.head_ = null;<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>  /**<tr><td><a id="l50"></a><a href="#l50">50</a><td>   * @return {ITEM}<tr><td><a id="l51"></a><a href="#l51">51</a><td>   */<tr><td><a id="l52"></a><a href="#l52">52</a><td>  get: function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td>    var item;<tr><td><a id="l54"></a><a href="#l54">54</a><td>    if (this.occupants_ &gt; 0) {<tr><td><a id="l55"></a><a href="#l55">55</a><td>      this.occupants_--;<tr><td><a id="l56"></a><a href="#l56">56</a><td>      item = this.head_;<tr><td><a id="l57"></a><a href="#l57">57</a><td>      this.head_ = item.next;<tr><td><a id="l58"></a><a href="#l58">58</a><td>      item.next = null;<tr><td><a id="l59"></a><a href="#l59">59</a><td>    } else {<tr><td><a id="l60"></a><a href="#l60">60</a><td>      item = this.create_();<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 item;<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>   * @param {ITEM} item An item available for possible future reuse.<tr><td><a id="l67"></a><a href="#l67">67</a><td>   */<tr><td><a id="l68"></a><a href="#l68">68</a><td>  put: function(item) {<tr><td><a id="l69"></a><a href="#l69">69</a><td>    this.reset_(item);<tr><td><a id="l70"></a><a href="#l70">70</a><td>    if (this.occupants_ &lt; this.limit_) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>      this.occupants_++;<tr><td><a id="l72"></a><a href="#l72">72</a><td>      item.next = this.head_;<tr><td><a id="l73"></a><a href="#l73">73</a><td>      this.head_ = item;<tr><td><a id="l74"></a><a href="#l74">74</a><td>    }<tr><td><a id="l75"></a><a href="#l75">75</a><td>  },<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>  /**<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * Visible for testing.<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * @package<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * @return {number}<tr><td><a id="l81"></a><a href="#l81">81</a><td>   */<tr><td><a id="l82"></a><a href="#l82">82</a><td>  occupants: function() {<tr><td><a id="l83"></a><a href="#l83">83</a><td>    return this.occupants_;<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><tr><td><a id="l88"></a><a href="#l88">88</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/async/nexttick.js.src.html b/docs/source/lib/goog/async/nexttick.js.src.html
new file mode 100644
index 0000000..c1b8f1d
--- /dev/null
+++ b/docs/source/lib/goog/async/nexttick.js.src.html
@@ -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>nexttick.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/async/nexttick.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Provides a function to schedule running a function as soon<tr><td><a id="l17"></a><a href="#l17">17</a><td> * as possible after the current JS execution stops and yields to the event<tr><td><a id="l18"></a><a href="#l18">18</a><td> * loop.<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.async.nextTick&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.async.throwException&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.debug.entryPointRegistry&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.dom.TagName&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.functions&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.labs.userAgent.browser&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.labs.userAgent.engine&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Throw an item without interrupting the current execution context.  For<tr><td><a id="l34"></a><a href="#l34">34</a><td> * example, if processing a group of items in a loop, sometimes it is useful<tr><td><a id="l35"></a><a href="#l35">35</a><td> * to report an error while still allowing the rest of the batch to be<tr><td><a id="l36"></a><a href="#l36">36</a><td> * processed.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {*} exception<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.async.throwException = function(exception) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>  // Each throw needs to be in its own context.<tr><td><a id="l41"></a><a href="#l41">41</a><td>  goog.global.setTimeout(function() { throw exception; }, 0);<tr><td><a id="l42"></a><a href="#l42">42</a><td>};<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Fires the provided callbacks as soon as possible after the current JS<tr><td><a id="l47"></a><a href="#l47">47</a><td> * execution context. setTimeout(…, 0) takes at least 4ms when called from<tr><td><a id="l48"></a><a href="#l48">48</a><td> * within another setTimeout(…, 0) for legacy reasons.<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> * This will not schedule the callback as a microtask (i.e. a task that can<tr><td><a id="l51"></a><a href="#l51">51</a><td> * preempt user input or networking callbacks). It is meant to emulate what<tr><td><a id="l52"></a><a href="#l52">52</a><td> * setTimeout(_, 0) would do if it were not throttled. If you desire microtask<tr><td><a id="l53"></a><a href="#l53">53</a><td> * behavior, use {@see goog.Promise} instead.<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {function(this:SCOPE)} callback Callback function to fire as soon as<tr><td><a id="l56"></a><a href="#l56">56</a><td> *     possible.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @param {SCOPE=} opt_context Object in whose scope to call the listener.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {boolean=} opt_useSetImmediate Avoid the IE workaround that<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     ensures correctness at the cost of speed. See comments for details.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @template SCOPE<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.async.nextTick = function(callback, opt_context, opt_useSetImmediate) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  var cb = callback;<tr><td><a id="l64"></a><a href="#l64">64</a><td>  if (opt_context) {<tr><td><a id="l65"></a><a href="#l65">65</a><td>    cb = goog.bind(callback, opt_context);<tr><td><a id="l66"></a><a href="#l66">66</a><td>  }<tr><td><a id="l67"></a><a href="#l67">67</a><td>  cb = goog.async.nextTick.wrapCallback_(cb);<tr><td><a id="l68"></a><a href="#l68">68</a><td>  // window.setImmediate was introduced and currently only supported by IE10+,<tr><td><a id="l69"></a><a href="#l69">69</a><td>  // but due to a bug in the implementation it is not guaranteed that<tr><td><a id="l70"></a><a href="#l70">70</a><td>  // setImmediate is faster than setTimeout nor that setImmediate N is before<tr><td><a id="l71"></a><a href="#l71">71</a><td>  // setImmediate N+1. That is why we do not use the native version if<tr><td><a id="l72"></a><a href="#l72">72</a><td>  // available. We do, however, call setImmediate if it is a normal function<tr><td><a id="l73"></a><a href="#l73">73</a><td>  // because that indicates that it has been replaced by goog.testing.MockClock<tr><td><a id="l74"></a><a href="#l74">74</a><td>  // which we do want to support.<tr><td><a id="l75"></a><a href="#l75">75</a><td>  // See<tr><td><a id="l76"></a><a href="#l76">76</a><td>  // http://connect.microsoft.com/IE/feedback/details/801823/setimmediate-and-messagechannel-are-broken-in-ie10<tr><td><a id="l77"></a><a href="#l77">77</a><td>  //<tr><td><a id="l78"></a><a href="#l78">78</a><td>  // Note we do allow callers to also request setImmediate if they are willing<tr><td><a id="l79"></a><a href="#l79">79</a><td>  // to accept the possible tradeoffs of incorrectness in exchange for speed.<tr><td><a id="l80"></a><a href="#l80">80</a><td>  // The IE fallback of readystate change is much slower.<tr><td><a id="l81"></a><a href="#l81">81</a><td>  if (goog.isFunction(goog.global.setImmediate) &amp;&amp;<tr><td><a id="l82"></a><a href="#l82">82</a><td>      // Opt in.<tr><td><a id="l83"></a><a href="#l83">83</a><td>      (opt_useSetImmediate ||<tr><td><a id="l84"></a><a href="#l84">84</a><td>      // or it isn&#39;t a browser or the environment is weird<tr><td><a id="l85"></a><a href="#l85">85</a><td>      !goog.global.Window || !goog.global.Window.prototype ||<tr><td><a id="l86"></a><a href="#l86">86</a><td>      // or something redefined setImmediate in which case we (YOLO) decide<tr><td><a id="l87"></a><a href="#l87">87</a><td>      // to use it (This is so that we use the mockClock setImmediate. sigh).<tr><td><a id="l88"></a><a href="#l88">88</a><td>      goog.global.Window.prototype.setImmediate != goog.global.setImmediate)) {<tr><td><a id="l89"></a><a href="#l89">89</a><td>    goog.global.setImmediate(cb);<tr><td><a id="l90"></a><a href="#l90">90</a><td>    return;<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>  // Look for and cache the custom fallback version of setImmediate.<tr><td><a id="l94"></a><a href="#l94">94</a><td>  if (!goog.async.nextTick.setImmediate_) {<tr><td><a id="l95"></a><a href="#l95">95</a><td>    goog.async.nextTick.setImmediate_ =<tr><td><a id="l96"></a><a href="#l96">96</a><td>        goog.async.nextTick.getSetImmediateEmulator_();<tr><td><a id="l97"></a><a href="#l97">97</a><td>  }<tr><td><a id="l98"></a><a href="#l98">98</a><td>  goog.async.nextTick.setImmediate_(cb);<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> * Cache for the setImmediate implementation.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @type {function(function())}<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @private<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.async.nextTick.setImmediate_;<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> * Determines the best possible implementation to run a function as soon as<tr><td><a id="l112"></a><a href="#l112">112</a><td> * the JS event loop is idle.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @return {function(function())} The &quot;setImmediate&quot; implementation.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @private<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.async.nextTick.getSetImmediateEmulator_ = function() {<tr><td><a id="l117"></a><a href="#l117">117</a><td>  // Create a private message channel and use it to postMessage empty messages<tr><td><a id="l118"></a><a href="#l118">118</a><td>  // to ourselves.<tr><td><a id="l119"></a><a href="#l119">119</a><td>  var Channel = goog.global[&#39;MessageChannel&#39;];<tr><td><a id="l120"></a><a href="#l120">120</a><td>  // If MessageChannel is not available and we are in a browser, implement<tr><td><a id="l121"></a><a href="#l121">121</a><td>  // an iframe based polyfill in browsers that have postMessage and<tr><td><a id="l122"></a><a href="#l122">122</a><td>  // document.addEventListener. The latter excludes IE8 because it has a<tr><td><a id="l123"></a><a href="#l123">123</a><td>  // synchronous postMessage implementation.<tr><td><a id="l124"></a><a href="#l124">124</a><td>  if (typeof Channel === &#39;undefined&#39; &amp;&amp; typeof window !== &#39;undefined&#39; &amp;&amp;<tr><td><a id="l125"></a><a href="#l125">125</a><td>      window.postMessage &amp;&amp; window.addEventListener &amp;&amp;<tr><td><a id="l126"></a><a href="#l126">126</a><td>      // Presto (The old pre-blink Opera engine) has problems with iframes<tr><td><a id="l127"></a><a href="#l127">127</a><td>      // and contentWindow.<tr><td><a id="l128"></a><a href="#l128">128</a><td>      !goog.labs.userAgent.engine.isPresto()) {<tr><td><a id="l129"></a><a href="#l129">129</a><td>    /** @constructor */<tr><td><a id="l130"></a><a href="#l130">130</a><td>    Channel = function() {<tr><td><a id="l131"></a><a href="#l131">131</a><td>      // Make an empty, invisible iframe.<tr><td><a id="l132"></a><a href="#l132">132</a><td>      var iframe = document.createElement(goog.dom.TagName.IFRAME);<tr><td><a id="l133"></a><a href="#l133">133</a><td>      iframe.style.display = &#39;none&#39;;<tr><td><a id="l134"></a><a href="#l134">134</a><td>      iframe.src = &#39;&#39;;<tr><td><a id="l135"></a><a href="#l135">135</a><td>      document.documentElement.appendChild(iframe);<tr><td><a id="l136"></a><a href="#l136">136</a><td>      var win = iframe.contentWindow;<tr><td><a id="l137"></a><a href="#l137">137</a><td>      var doc = win.document;<tr><td><a id="l138"></a><a href="#l138">138</a><td>      doc.open();<tr><td><a id="l139"></a><a href="#l139">139</a><td>      doc.write(&#39;&#39;);<tr><td><a id="l140"></a><a href="#l140">140</a><td>      doc.close();<tr><td><a id="l141"></a><a href="#l141">141</a><td>      // Do not post anything sensitive over this channel, as the workaround for<tr><td><a id="l142"></a><a href="#l142">142</a><td>      // pages with file: origin could allow that information to be modified or<tr><td><a id="l143"></a><a href="#l143">143</a><td>      // intercepted.<tr><td><a id="l144"></a><a href="#l144">144</a><td>      var message = &#39;callImmediate&#39; + Math.random();<tr><td><a id="l145"></a><a href="#l145">145</a><td>      // The same origin policy rejects attempts to postMessage from file: urls<tr><td><a id="l146"></a><a href="#l146">146</a><td>      // unless the origin is &#39;*&#39;.<tr><td><a id="l147"></a><a href="#l147">147</a><td>      // TODO(b/16335441): Use &#39;*&#39; origin for data: and other similar protocols.<tr><td><a id="l148"></a><a href="#l148">148</a><td>      var origin = win.location.protocol == &#39;file:&#39; ?<tr><td><a id="l149"></a><a href="#l149">149</a><td>          &#39;*&#39; : win.location.protocol + &#39;//&#39; + win.location.host;<tr><td><a id="l150"></a><a href="#l150">150</a><td>      var onmessage = goog.bind(function(e) {<tr><td><a id="l151"></a><a href="#l151">151</a><td>        // Validate origin and message to make sure that this message was<tr><td><a id="l152"></a><a href="#l152">152</a><td>        // intended for us. If the origin is set to &#39;*&#39; (see above) only the<tr><td><a id="l153"></a><a href="#l153">153</a><td>        // message needs to match since, for example, &#39;*&#39; != &#39;file://&#39;. Allowing<tr><td><a id="l154"></a><a href="#l154">154</a><td>        // the wildcard is ok, as we are not concerned with security here.<tr><td><a id="l155"></a><a href="#l155">155</a><td>        if ((origin != &#39;*&#39; &amp;&amp; e.origin != origin) || e.data != message) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>          return;<tr><td><a id="l157"></a><a href="#l157">157</a><td>        }<tr><td><a id="l158"></a><a href="#l158">158</a><td>        this[&#39;port1&#39;].onmessage();<tr><td><a id="l159"></a><a href="#l159">159</a><td>      }, this);<tr><td><a id="l160"></a><a href="#l160">160</a><td>      win.addEventListener(&#39;message&#39;, onmessage, false);<tr><td><a id="l161"></a><a href="#l161">161</a><td>      this[&#39;port1&#39;] = {};<tr><td><a id="l162"></a><a href="#l162">162</a><td>      this[&#39;port2&#39;] = {<tr><td><a id="l163"></a><a href="#l163">163</a><td>        postMessage: function() {<tr><td><a id="l164"></a><a href="#l164">164</a><td>          win.postMessage(message, origin);<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>  }<tr><td><a id="l169"></a><a href="#l169">169</a><td>  if (typeof Channel !== &#39;undefined&#39; &amp;&amp;<tr><td><a id="l170"></a><a href="#l170">170</a><td>      (!goog.labs.userAgent.browser.isIE())) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>    // Exclude all of IE due to<tr><td><a id="l172"></a><a href="#l172">172</a><td>    // http://codeforhire.com/2013/09/21/setimmediate-and-messagechannel-broken-on-internet-explorer-10/<tr><td><a id="l173"></a><a href="#l173">173</a><td>    // which allows starving postMessage with a busy setTimeout loop.<tr><td><a id="l174"></a><a href="#l174">174</a><td>    // This currently affects IE10 and IE11 which would otherwise be able<tr><td><a id="l175"></a><a href="#l175">175</a><td>    // to use the postMessage based fallbacks.<tr><td><a id="l176"></a><a href="#l176">176</a><td>    var channel = new Channel();<tr><td><a id="l177"></a><a href="#l177">177</a><td>    // Use a fifo linked list to call callbacks in the right order.<tr><td><a id="l178"></a><a href="#l178">178</a><td>    var head = {};<tr><td><a id="l179"></a><a href="#l179">179</a><td>    var tail = head;<tr><td><a id="l180"></a><a href="#l180">180</a><td>    channel[&#39;port1&#39;].onmessage = function() {<tr><td><a id="l181"></a><a href="#l181">181</a><td>      if (goog.isDef(head.next)) {<tr><td><a id="l182"></a><a href="#l182">182</a><td>        head = head.next;<tr><td><a id="l183"></a><a href="#l183">183</a><td>        var cb = head.cb;<tr><td><a id="l184"></a><a href="#l184">184</a><td>        head.cb = null;<tr><td><a id="l185"></a><a href="#l185">185</a><td>        cb();<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>    return function(cb) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>      tail.next = {<tr><td><a id="l190"></a><a href="#l190">190</a><td>        cb: cb<tr><td><a id="l191"></a><a href="#l191">191</a><td>      };<tr><td><a id="l192"></a><a href="#l192">192</a><td>      tail = tail.next;<tr><td><a id="l193"></a><a href="#l193">193</a><td>      channel[&#39;port2&#39;].postMessage(0);<tr><td><a id="l194"></a><a href="#l194">194</a><td>    };<tr><td><a id="l195"></a><a href="#l195">195</a><td>  }<tr><td><a id="l196"></a><a href="#l196">196</a><td>  // Implementation for IE6+: Script elements fire an asynchronous<tr><td><a id="l197"></a><a href="#l197">197</a><td>  // onreadystatechange event when inserted into the DOM.<tr><td><a id="l198"></a><a href="#l198">198</a><td>  if (typeof document !== &#39;undefined&#39; &amp;&amp; &#39;onreadystatechange&#39; in<tr><td><a id="l199"></a><a href="#l199">199</a><td>      document.createElement(goog.dom.TagName.SCRIPT)) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>    return function(cb) {<tr><td><a id="l201"></a><a href="#l201">201</a><td>      var script = document.createElement(goog.dom.TagName.SCRIPT);<tr><td><a id="l202"></a><a href="#l202">202</a><td>      script.onreadystatechange = function() {<tr><td><a id="l203"></a><a href="#l203">203</a><td>        // Clean up and call the callback.<tr><td><a id="l204"></a><a href="#l204">204</a><td>        script.onreadystatechange = null;<tr><td><a id="l205"></a><a href="#l205">205</a><td>        script.parentNode.removeChild(script);<tr><td><a id="l206"></a><a href="#l206">206</a><td>        script = null;<tr><td><a id="l207"></a><a href="#l207">207</a><td>        cb();<tr><td><a id="l208"></a><a href="#l208">208</a><td>        cb = null;<tr><td><a id="l209"></a><a href="#l209">209</a><td>      };<tr><td><a id="l210"></a><a href="#l210">210</a><td>      document.documentElement.appendChild(script);<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>  // Fall back to setTimeout with 0. In browsers this creates a delay of 5ms<tr><td><a id="l214"></a><a href="#l214">214</a><td>  // or more.<tr><td><a id="l215"></a><a href="#l215">215</a><td>  return function(cb) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>    goog.global.setTimeout(cb, 0);<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><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Helper function that is overrided to protect callbacks with entry point<tr><td><a id="l223"></a><a href="#l223">223</a><td> * monitor if the application monitors entry points.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @param {function()} callback Callback function to fire as soon as possible.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @return {function()} The wrapped callback.<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @private<tr><td><a id="l227"></a><a href="#l227">227</a><td> */<tr><td><a id="l228"></a><a href="#l228">228</a><td>goog.async.nextTick.wrapCallback_ = goog.functions.identity;<tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>// Register the callback function as an entry point, so that it can be<tr><td><a id="l232"></a><a href="#l232">232</a><td>// monitored for exception handling, etc. This has to be done in this file<tr><td><a id="l233"></a><a href="#l233">233</a><td>// since it requires special code to handle all browsers.<tr><td><a id="l234"></a><a href="#l234">234</a><td>goog.debug.entryPointRegistry.register(<tr><td><a id="l235"></a><a href="#l235">235</a><td>    /**<tr><td><a id="l236"></a><a href="#l236">236</a><td>     * @param {function(!Function): !Function} transformer The transforming<tr><td><a id="l237"></a><a href="#l237">237</a><td>     *     function.<tr><td><a id="l238"></a><a href="#l238">238</a><td>     */<tr><td><a id="l239"></a><a href="#l239">239</a><td>    function(transformer) {<tr><td><a id="l240"></a><a href="#l240">240</a><td>      goog.async.nextTick.wrapCallback_ = transformer;<tr><td><a id="l241"></a><a href="#l241">241</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/async/run.js.src.html b/docs/source/lib/goog/async/run.js.src.html
new file mode 100644
index 0000000..ce3194f
--- /dev/null
+++ b/docs/source/lib/goog/async/run.js.src.html
@@ -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>run.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/async/run.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.async.run&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td>goog.require(&#39;goog.async.WorkQueue&#39;);<tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.require(&#39;goog.async.nextTick&#39;);<tr><td><a id="l19"></a><a href="#l19">19</a><td>goog.require(&#39;goog.async.throwException&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td><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> * Fires the provided callback just before the current callstack unwinds, or as<tr><td><a id="l24"></a><a href="#l24">24</a><td> * soon as possible after the current JS execution context.<tr><td><a id="l25"></a><a href="#l25">25</a><td> * @param {function(this:THIS)} callback<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @param {THIS=} opt_context Object to use as the &quot;this value&quot; when calling<tr><td><a id="l27"></a><a href="#l27">27</a><td> *     the provided function.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @template THIS<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.async.run = function(callback, opt_context) {<tr><td><a id="l31"></a><a href="#l31">31</a><td>  if (!goog.async.run.schedule_) {<tr><td><a id="l32"></a><a href="#l32">32</a><td>    goog.async.run.initializeRunner_();<tr><td><a id="l33"></a><a href="#l33">33</a><td>  }<tr><td><a id="l34"></a><a href="#l34">34</a><td>  if (!goog.async.run.workQueueScheduled_) {<tr><td><a id="l35"></a><a href="#l35">35</a><td>    // Nothing is currently scheduled, schedule it now.<tr><td><a id="l36"></a><a href="#l36">36</a><td>    goog.async.run.schedule_();<tr><td><a id="l37"></a><a href="#l37">37</a><td>    goog.async.run.workQueueScheduled_ = true;<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>  goog.async.run.workQueue_.add(callback, opt_context);<tr><td><a id="l41"></a><a href="#l41">41</a><td>};<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>/**<tr><td><a id="l45"></a><a href="#l45">45</a><td> * Initializes the function to use to process the work queue.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @private<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.async.run.initializeRunner_ = function() {<tr><td><a id="l49"></a><a href="#l49">49</a><td>  // If native Promises are available in the browser, just schedule the callback<tr><td><a id="l50"></a><a href="#l50">50</a><td>  // on a fulfilled promise, which is specified to be async, but as fast as<tr><td><a id="l51"></a><a href="#l51">51</a><td>  // possible.<tr><td><a id="l52"></a><a href="#l52">52</a><td>  if (goog.global.Promise &amp;&amp; goog.global.Promise.resolve) {<tr><td><a id="l53"></a><a href="#l53">53</a><td>    var promise = goog.global.Promise.resolve(undefined);<tr><td><a id="l54"></a><a href="#l54">54</a><td>    goog.async.run.schedule_ = function() {<tr><td><a id="l55"></a><a href="#l55">55</a><td>      promise.then(goog.async.run.processWorkQueue);<tr><td><a id="l56"></a><a href="#l56">56</a><td>    };<tr><td><a id="l57"></a><a href="#l57">57</a><td>  } else {<tr><td><a id="l58"></a><a href="#l58">58</a><td>    goog.async.run.schedule_ = function() {<tr><td><a id="l59"></a><a href="#l59">59</a><td>      goog.async.nextTick(goog.async.run.processWorkQueue);<tr><td><a id="l60"></a><a href="#l60">60</a><td>    };<tr><td><a id="l61"></a><a href="#l61">61</a><td>  }<tr><td><a id="l62"></a><a href="#l62">62</a><td>};<tr><td><a id="l63"></a><a href="#l63">63</a><td><tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td>/**<tr><td><a id="l66"></a><a href="#l66">66</a><td> * Forces goog.async.run to use nextTick instead of Promise.<tr><td><a id="l67"></a><a href="#l67">67</a><td> *<tr><td><a id="l68"></a><a href="#l68">68</a><td> * This should only be done in unit tests. It&#39;s useful because MockClock<tr><td><a id="l69"></a><a href="#l69">69</a><td> * replaces nextTick, but not the browser Promise implementation, so it allows<tr><td><a id="l70"></a><a href="#l70">70</a><td> * Promise-based code to be tested with MockClock.<tr><td><a id="l71"></a><a href="#l71">71</a><td> *<tr><td><a id="l72"></a><a href="#l72">72</a><td> * However, we also want to run promises if the MockClock is no longer in<tr><td><a id="l73"></a><a href="#l73">73</a><td> * control so we schedule a backup &quot;setTimeout&quot; to the unmocked timeout if<tr><td><a id="l74"></a><a href="#l74">74</a><td> * provided.<tr><td><a id="l75"></a><a href="#l75">75</a><td> *<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @param {function(function())=} opt_realSetTimeout<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.async.run.forceNextTick = function(opt_realSetTimeout) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>  goog.async.run.schedule_ = function() {<tr><td><a id="l80"></a><a href="#l80">80</a><td>    goog.async.nextTick(goog.async.run.processWorkQueue);<tr><td><a id="l81"></a><a href="#l81">81</a><td>    if (opt_realSetTimeout) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>      opt_realSetTimeout(goog.async.run.processWorkQueue);<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><tr><td><a id="l88"></a><a href="#l88">88</a><td>/**<tr><td><a id="l89"></a><a href="#l89">89</a><td> * The function used to schedule work asynchronousely.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @private {function()}<tr><td><a id="l91"></a><a href="#l91">91</a><td> */<tr><td><a id="l92"></a><a href="#l92">92</a><td>goog.async.run.schedule_;<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>/** @private {boolean} */<tr><td><a id="l96"></a><a href="#l96">96</a><td>goog.async.run.workQueueScheduled_ = false;<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td>/** @private {!goog.async.WorkQueue} */<tr><td><a id="l100"></a><a href="#l100">100</a><td>goog.async.run.workQueue_ = new goog.async.WorkQueue();<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>if (goog.DEBUG) {<tr><td><a id="l104"></a><a href="#l104">104</a><td>  /**<tr><td><a id="l105"></a><a href="#l105">105</a><td>   * Reset the work queue. Only available for tests in debug mode.<tr><td><a id="l106"></a><a href="#l106">106</a><td>   */<tr><td><a id="l107"></a><a href="#l107">107</a><td>  goog.async.run.resetQueue = function() {<tr><td><a id="l108"></a><a href="#l108">108</a><td>    goog.async.run.workQueueScheduled_ = false;<tr><td><a id="l109"></a><a href="#l109">109</a><td>    goog.async.run.workQueue_ = new goog.async.WorkQueue();<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><tr><td><a id="l114"></a><a href="#l114">114</a><td>/**<tr><td><a id="l115"></a><a href="#l115">115</a><td> * Run any pending goog.async.run work items. This function is not intended<tr><td><a id="l116"></a><a href="#l116">116</a><td> * for general use, but for use by entry point handlers to run items ahead of<tr><td><a id="l117"></a><a href="#l117">117</a><td> * goog.async.nextTick.<tr><td><a id="l118"></a><a href="#l118">118</a><td> */<tr><td><a id="l119"></a><a href="#l119">119</a><td>goog.async.run.processWorkQueue = function() {<tr><td><a id="l120"></a><a href="#l120">120</a><td>  // NOTE: additional work queue items may be added while processing.<tr><td><a id="l121"></a><a href="#l121">121</a><td>  var item = null;<tr><td><a id="l122"></a><a href="#l122">122</a><td>  while (item = goog.async.run.workQueue_.remove()) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>    try {<tr><td><a id="l124"></a><a href="#l124">124</a><td>      item.fn.call(item.scope);<tr><td><a id="l125"></a><a href="#l125">125</a><td>    } catch (e) {<tr><td><a id="l126"></a><a href="#l126">126</a><td>      goog.async.throwException(e);<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.async.run.workQueue_.returnUnused(item);<tr><td><a id="l129"></a><a href="#l129">129</a><td>  }<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>  // There are no more work items, allow processing to be scheduled again.<tr><td><a id="l132"></a><a href="#l132">132</a><td>  goog.async.run.workQueueScheduled_ = false;<tr><td><a id="l133"></a><a href="#l133">133</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/async/workqueue.js.src.html b/docs/source/lib/goog/async/workqueue.js.src.html
new file mode 100644
index 0000000..bc75c92
--- /dev/null
+++ b/docs/source/lib/goog/async/workqueue.js.src.html
@@ -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>workqueue.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/async/workqueue.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2015 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.async.WorkItem&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td>goog.provide(&#39;goog.async.WorkQueue&#39;);<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l19"></a><a href="#l19">19</a><td>goog.require(&#39;goog.async.FreeList&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>// TODO(johnlenz): generalize the WorkQueue if this is used by more<tr><td><a id="l23"></a><a href="#l23">23</a><td>// than goog.async.run.<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><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * A low GC workqueue. The key elements of this design:<tr><td><a id="l29"></a><a href="#l29">29</a><td> *   - avoids the need for goog.bind or equivalent by carrying scope<tr><td><a id="l30"></a><a href="#l30">30</a><td> *   - avoids the need for array reallocation by using a linked list<tr><td><a id="l31"></a><a href="#l31">31</a><td> *   - minimizes work entry objects allocation by recycling objects<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @constructor<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @final<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @struct<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.async.WorkQueue = function() {<tr><td><a id="l37"></a><a href="#l37">37</a><td>  this.workHead_ = null;<tr><td><a id="l38"></a><a href="#l38">38</a><td>  this.workTail_ = null;<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 {number} The maximum number of entries to keep for recycling. */<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.define(&#39;goog.async.WorkQueue.DEFAULT_MAX_UNUSED&#39;, 100);<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/** @const @private {goog.async.FreeList&lt;goog.async.WorkItem&gt;} */<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.async.WorkQueue.freelist_ = new goog.async.FreeList(<tr><td><a id="l48"></a><a href="#l48">48</a><td>    function() {return new goog.async.WorkItem(); },<tr><td><a id="l49"></a><a href="#l49">49</a><td>    function(item) {item.reset()},<tr><td><a id="l50"></a><a href="#l50">50</a><td>    goog.async.WorkQueue.DEFAULT_MAX_UNUSED);<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {function()} fn<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {Object|null|undefined} scope<tr><td><a id="l56"></a><a href="#l56">56</a><td> */<tr><td><a id="l57"></a><a href="#l57">57</a><td>goog.async.WorkQueue.prototype.add = function(fn, scope) {<tr><td><a id="l58"></a><a href="#l58">58</a><td>  var item = this.getUnusedItem_();<tr><td><a id="l59"></a><a href="#l59">59</a><td>  item.set(fn, scope);<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td>  if (this.workTail_) {<tr><td><a id="l62"></a><a href="#l62">62</a><td>    this.workTail_.next = item;<tr><td><a id="l63"></a><a href="#l63">63</a><td>    this.workTail_ = item;<tr><td><a id="l64"></a><a href="#l64">64</a><td>  } else {<tr><td><a id="l65"></a><a href="#l65">65</a><td>    goog.asserts.assert(!this.workHead_);<tr><td><a id="l66"></a><a href="#l66">66</a><td>    this.workHead_ = item;<tr><td><a id="l67"></a><a href="#l67">67</a><td>    this.workTail_ = item;<tr><td><a id="l68"></a><a href="#l68">68</a><td>  }<tr><td><a id="l69"></a><a href="#l69">69</a><td>};<tr><td><a id="l70"></a><a href="#l70">70</a><td><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> * @return {goog.async.WorkItem}<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td>goog.async.WorkQueue.prototype.remove = function() {<tr><td><a id="l76"></a><a href="#l76">76</a><td>  var item = null;<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>  if (this.workHead_) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>    item = this.workHead_;<tr><td><a id="l80"></a><a href="#l80">80</a><td>    this.workHead_ = this.workHead_.next;<tr><td><a id="l81"></a><a href="#l81">81</a><td>    if (!this.workHead_) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>      this.workTail_ = null;<tr><td><a id="l83"></a><a href="#l83">83</a><td>    }<tr><td><a id="l84"></a><a href="#l84">84</a><td>    item.next = null;<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 item;<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> * @param {goog.async.WorkItem} item<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.async.WorkQueue.prototype.returnUnused = function(item) {<tr><td><a id="l94"></a><a href="#l94">94</a><td>  goog.async.WorkQueue.freelist_.put(item);<tr><td><a id="l95"></a><a href="#l95">95</a><td>};<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>/**<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @return {goog.async.WorkItem}<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @private<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>goog.async.WorkQueue.prototype.getUnusedItem_ = function() {<tr><td><a id="l103"></a><a href="#l103">103</a><td>  return goog.async.WorkQueue.freelist_.get();<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><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> * @constructor<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @final<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @struct<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.async.WorkItem = function() {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  /** @type {?function()} */<tr><td><a id="l115"></a><a href="#l115">115</a><td>  this.fn = null;<tr><td><a id="l116"></a><a href="#l116">116</a><td>  /** @type {Object|null|undefined} */<tr><td><a id="l117"></a><a href="#l117">117</a><td>  this.scope = null;<tr><td><a id="l118"></a><a href="#l118">118</a><td>  /** @type {?goog.async.WorkItem} */<tr><td><a id="l119"></a><a href="#l119">119</a><td>  this.next = null;<tr><td><a id="l120"></a><a href="#l120">120</a><td>};<tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>/**<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {function()} fn<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @param {Object|null|undefined} scope<tr><td><a id="l126"></a><a href="#l126">126</a><td> */<tr><td><a id="l127"></a><a href="#l127">127</a><td>goog.async.WorkItem.prototype.set = function(fn, scope) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>  this.fn = fn;<tr><td><a id="l129"></a><a href="#l129">129</a><td>  this.scope = scope;<tr><td><a id="l130"></a><a href="#l130">130</a><td>  this.next = null;<tr><td><a id="l131"></a><a href="#l131">131</a><td>};<tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td>/** Reset the work item so they don&#39;t prevent GC before reuse */<tr><td><a id="l135"></a><a href="#l135">135</a><td>goog.async.WorkItem.prototype.reset = function() {<tr><td><a id="l136"></a><a href="#l136">136</a><td>  this.fn = null;<tr><td><a id="l137"></a><a href="#l137">137</a><td>  this.scope = null;<tr><td><a id="l138"></a><a href="#l138">138</a><td>  this.next = null;<tr><td><a id="l139"></a><a href="#l139">139</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/base.js.src.html b/docs/source/lib/goog/base.js.src.html
index dd4e1b2..98c0c08 100644
--- a/docs/source/lib/goog/base.js.src.html
+++ b/docs/source/lib/goog/base.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>base.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/base.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Bootstrap for the Google JS Library (Closure).<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> * In uncompiled mode base.js will write out Closure&#39;s deps file, unless the<tr><td><a name="l19" href="#l19">19</a><td> * global &lt;code&gt;CLOSURE_NO_DEPS&lt;/code&gt; is set to true.  This allows projects to<tr><td><a name="l20" href="#l20">20</a><td> * include their own deps file(s) from different locations.<tr><td><a name="l21" href="#l21">21</a><td> *<tr><td><a name="l22" href="#l22">22</a><td> *<tr><td><a name="l23" href="#l23">23</a><td> * @provideGoog<tr><td><a name="l24" href="#l24">24</a><td> */<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td>/**<tr><td><a name="l28" href="#l28">28</a><td> * @define {boolean} Overridden to true by the compiler when --closure_pass<tr><td><a name="l29" href="#l29">29</a><td> *     or --mark_as_compiled is specified.<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>var COMPILED = false;<tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td>/**<tr><td><a name="l35" href="#l35">35</a><td> * Base namespace for the Closure library.  Checks to see goog is<tr><td><a name="l36" href="#l36">36</a><td> * already defined in the current scope before assigning to prevent<tr><td><a name="l37" href="#l37">37</a><td> * clobbering if base.js is loaded more than once.<tr><td><a name="l38" href="#l38">38</a><td> *<tr><td><a name="l39" href="#l39">39</a><td> * @const<tr><td><a name="l40" href="#l40">40</a><td> */<tr><td><a name="l41" href="#l41">41</a><td>var goog = goog || {};<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td>/**<tr><td><a name="l45" href="#l45">45</a><td> * Reference to the global context.  In most cases this will be &#39;window&#39;.<tr><td><a name="l46" href="#l46">46</a><td> */<tr><td><a name="l47" href="#l47">47</a><td>goog.global = this;<tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td>/**<tr><td><a name="l51" href="#l51">51</a><td> * A hook for overriding the define values in uncompiled mode.<tr><td><a name="l52" href="#l52">52</a><td> *<tr><td><a name="l53" href="#l53">53</a><td> * In uncompiled mode, {@code CLOSURE_DEFINES} may be defined before loading<tr><td><a name="l54" href="#l54">54</a><td> * base.js.  If a key is defined in {@code CLOSURE_DEFINES}, {@code goog.define}<tr><td><a name="l55" href="#l55">55</a><td> * will use the value instead of the default value.  This allows flags to be<tr><td><a name="l56" href="#l56">56</a><td> * overwritten without compilation (this is normally accomplished with the<tr><td><a name="l57" href="#l57">57</a><td> * compiler&#39;s &quot;define&quot; flag).<tr><td><a name="l58" href="#l58">58</a><td> *<tr><td><a name="l59" href="#l59">59</a><td> * Example:<tr><td><a name="l60" href="#l60">60</a><td> * &lt;pre&gt;<tr><td><a name="l61" href="#l61">61</a><td> *   var CLOSURE_DEFINES = {&#39;goog.DEBUG&#39;, false};<tr><td><a name="l62" href="#l62">62</a><td> * &lt;/pre&gt;<tr><td><a name="l63" href="#l63">63</a><td> *<tr><td><a name="l64" href="#l64">64</a><td> * @type {Object.&lt;string, (string|number|boolean)&gt;|undefined}<tr><td><a name="l65" href="#l65">65</a><td> */<tr><td><a name="l66" href="#l66">66</a><td>goog.global.CLOSURE_DEFINES;<tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td><tr><td><a name="l69" href="#l69">69</a><td>/**<tr><td><a name="l70" href="#l70">70</a><td> * Builds an object structure for the provided namespace path,<tr><td><a name="l71" href="#l71">71</a><td> * ensuring that names that already exist are not overwritten. For<tr><td><a name="l72" href="#l72">72</a><td> * example:<tr><td><a name="l73" href="#l73">73</a><td> * &quot;a.b.c&quot; -&gt; a = {};a.b={};a.b.c={};<tr><td><a name="l74" href="#l74">74</a><td> * Used by goog.provide and goog.exportSymbol.<tr><td><a name="l75" href="#l75">75</a><td> * @param {string} name name of the object that this file defines.<tr><td><a name="l76" href="#l76">76</a><td> * @param {*=} opt_object the object to expose at the end of the path.<tr><td><a name="l77" href="#l77">77</a><td> * @param {Object=} opt_objectToExportTo The object to add the path to; default<tr><td><a name="l78" href="#l78">78</a><td> *     is |goog.global|.<tr><td><a name="l79" href="#l79">79</a><td> * @private<tr><td><a name="l80" href="#l80">80</a><td> */<tr><td><a name="l81" href="#l81">81</a><td>goog.exportPath_ = function(name, opt_object, opt_objectToExportTo) {<tr><td><a name="l82" href="#l82">82</a><td>  var parts = name.split(&#39;.&#39;);<tr><td><a name="l83" href="#l83">83</a><td>  var cur = opt_objectToExportTo || goog.global;<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td>  // Internet Explorer exhibits strange behavior when throwing errors from<tr><td><a name="l86" href="#l86">86</a><td>  // methods externed in this manner.  See the testExportSymbolExceptions in<tr><td><a name="l87" href="#l87">87</a><td>  // base_test.html for an example.<tr><td><a name="l88" href="#l88">88</a><td>  if (!(parts[0] in cur) &amp;&amp; cur.execScript) {<tr><td><a name="l89" href="#l89">89</a><td>    cur.execScript(&#39;var &#39; + parts[0]);<tr><td><a name="l90" href="#l90">90</a><td>  }<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td>  // Certain browsers cannot parse code in the form for((a in b); c;);<tr><td><a name="l93" href="#l93">93</a><td>  // This pattern is produced by the JSCompiler when it collapses the<tr><td><a name="l94" href="#l94">94</a><td>  // statement above into the conditional loop below. To prevent this from<tr><td><a name="l95" href="#l95">95</a><td>  // happening, use a for-loop and reserve the init logic as below.<tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>  // Parentheses added to eliminate strict JS warning in Firefox.<tr><td><a name="l98" href="#l98">98</a><td>  for (var part; parts.length &amp;&amp; (part = parts.shift());) {<tr><td><a name="l99" href="#l99">99</a><td>    if (!parts.length &amp;&amp; opt_object !== undefined) {<tr><td><a name="l100" href="#l100">100</a><td>      // last part and we have an object; use it<tr><td><a name="l101" href="#l101">101</a><td>      cur[part] = opt_object;<tr><td><a name="l102" href="#l102">102</a><td>    } else if (cur[part]) {<tr><td><a name="l103" href="#l103">103</a><td>      cur = cur[part];<tr><td><a name="l104" href="#l104">104</a><td>    } else {<tr><td><a name="l105" href="#l105">105</a><td>      cur = cur[part] = {};<tr><td><a name="l106" href="#l106">106</a><td>    }<tr><td><a name="l107" href="#l107">107</a><td>  }<tr><td><a name="l108" href="#l108">108</a><td>};<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td>/**<tr><td><a name="l112" href="#l112">112</a><td> * Defines a named value. In uncompiled mode, the value is retreived from<tr><td><a name="l113" href="#l113">113</a><td> * CLOSURE_DEFINES if the object is defined and has the property specified,<tr><td><a name="l114" href="#l114">114</a><td> * and otherwise used the defined defaultValue. When compiled, the default<tr><td><a name="l115" href="#l115">115</a><td> * can be overridden using compiler command-line options.<tr><td><a name="l116" href="#l116">116</a><td> *<tr><td><a name="l117" href="#l117">117</a><td> * @param {string} name The distinguished name to provide.<tr><td><a name="l118" href="#l118">118</a><td> * @param {string|number|boolean} defaultValue<tr><td><a name="l119" href="#l119">119</a><td> */<tr><td><a name="l120" href="#l120">120</a><td>goog.define = function(name, defaultValue) {<tr><td><a name="l121" href="#l121">121</a><td>  var value = defaultValue;<tr><td><a name="l122" href="#l122">122</a><td>  if (!COMPILED) {<tr><td><a name="l123" href="#l123">123</a><td>    if (goog.global.CLOSURE_DEFINES &amp;&amp; Object.prototype.hasOwnProperty.call(<tr><td><a name="l124" href="#l124">124</a><td>        goog.global.CLOSURE_DEFINES, name)) {<tr><td><a name="l125" href="#l125">125</a><td>      value = goog.global.CLOSURE_DEFINES[name];<tr><td><a name="l126" href="#l126">126</a><td>    }<tr><td><a name="l127" href="#l127">127</a><td>  }<tr><td><a name="l128" href="#l128">128</a><td>  goog.exportPath_(name, value);<tr><td><a name="l129" href="#l129">129</a><td>};<tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td>/**<tr><td><a name="l133" href="#l133">133</a><td> * @define {boolean} DEBUG is provided as a convenience so that debugging code<tr><td><a name="l134" href="#l134">134</a><td> * that should not be included in a production js_binary can be easily stripped<tr><td><a name="l135" href="#l135">135</a><td> * by specifying --define goog.DEBUG=false to the JSCompiler. For example, most<tr><td><a name="l136" href="#l136">136</a><td> * toString() methods should be declared inside an &quot;if (goog.DEBUG)&quot; conditional<tr><td><a name="l137" href="#l137">137</a><td> * because they are generally used for debugging purposes and it is difficult<tr><td><a name="l138" href="#l138">138</a><td> * for the JSCompiler to statically determine whether they are used.<tr><td><a name="l139" href="#l139">139</a><td> */<tr><td><a name="l140" href="#l140">140</a><td>goog.DEBUG = true;<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td>/**<tr><td><a name="l144" href="#l144">144</a><td> * @define {string} LOCALE defines the locale being used for compilation. It is<tr><td><a name="l145" href="#l145">145</a><td> * used to select locale specific data to be compiled in js binary. BUILD rule<tr><td><a name="l146" href="#l146">146</a><td> * can specify this value by &quot;--define goog.LOCALE=&lt;locale_name&gt;&quot; as JSCompiler<tr><td><a name="l147" href="#l147">147</a><td> * option.<tr><td><a name="l148" href="#l148">148</a><td> *<tr><td><a name="l149" href="#l149">149</a><td> * Take into account that the locale code format is important. You should use<tr><td><a name="l150" href="#l150">150</a><td> * the canonical Unicode format with hyphen as a delimiter. Language must be<tr><td><a name="l151" href="#l151">151</a><td> * lowercase, Language Script - Capitalized, Region - UPPERCASE.<tr><td><a name="l152" href="#l152">152</a><td> * There are few examples: pt-BR, en, en-US, sr-Latin-BO, zh-Hans-CN.<tr><td><a name="l153" href="#l153">153</a><td> *<tr><td><a name="l154" href="#l154">154</a><td> * See more info about locale codes here:<tr><td><a name="l155" href="#l155">155</a><td> * http://www.unicode.org/reports/tr35/#Unicode_Language_and_Locale_Identifiers<tr><td><a name="l156" href="#l156">156</a><td> *<tr><td><a name="l157" href="#l157">157</a><td> * For language codes you should use values defined by ISO 693-1. See it here<tr><td><a name="l158" href="#l158">158</a><td> * http://www.w3.org/WAI/ER/IG/ert/iso639.htm. There is only one exception from<tr><td><a name="l159" href="#l159">159</a><td> * this rule: the Hebrew language. For legacy reasons the old code (iw) should<tr><td><a name="l160" href="#l160">160</a><td> * be used instead of the new code (he), see http://wiki/Main/IIISynonyms.<tr><td><a name="l161" href="#l161">161</a><td> */<tr><td><a name="l162" href="#l162">162</a><td>goog.define(&#39;goog.LOCALE&#39;, &#39;en&#39;);  // default to en<tr><td><a name="l163" href="#l163">163</a><td><tr><td><a name="l164" href="#l164">164</a><td><tr><td><a name="l165" href="#l165">165</a><td>/**<tr><td><a name="l166" href="#l166">166</a><td> * @define {boolean} Whether this code is running on trusted sites.<tr><td><a name="l167" href="#l167">167</a><td> *<tr><td><a name="l168" href="#l168">168</a><td> * On untrusted sites, several native functions can be defined or overridden by<tr><td><a name="l169" href="#l169">169</a><td> * external libraries like Prototype, Datejs, and JQuery and setting this flag<tr><td><a name="l170" href="#l170">170</a><td> * to false forces closure to use its own implementations when possible.<tr><td><a name="l171" href="#l171">171</a><td> *<tr><td><a name="l172" href="#l172">172</a><td> * If your javascript can be loaded by a third party site and you are wary about<tr><td><a name="l173" href="#l173">173</a><td> * relying on non-standard implementations, specify<tr><td><a name="l174" href="#l174">174</a><td> * &quot;--define goog.TRUSTED_SITE=false&quot; to the JSCompiler.<tr><td><a name="l175" href="#l175">175</a><td> */<tr><td><a name="l176" href="#l176">176</a><td>goog.define(&#39;goog.TRUSTED_SITE&#39;, true);<tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>/**<tr><td><a name="l180" href="#l180">180</a><td> * Creates object stubs for a namespace.  The presence of one or more<tr><td><a name="l181" href="#l181">181</a><td> * goog.provide() calls indicate that the file defines the given<tr><td><a name="l182" href="#l182">182</a><td> * objects/namespaces.  Build tools also scan for provide/require statements<tr><td><a name="l183" href="#l183">183</a><td> * to discern dependencies, build dependency files (see deps.js), etc.<tr><td><a name="l184" href="#l184">184</a><td> * @see goog.require<tr><td><a name="l185" href="#l185">185</a><td> * @param {string} name Namespace provided by this file in the form<tr><td><a name="l186" href="#l186">186</a><td> *     &quot;goog.package.part&quot;.<tr><td><a name="l187" href="#l187">187</a><td> */<tr><td><a name="l188" href="#l188">188</a><td>goog.provide = function(name) {<tr><td><a name="l189" href="#l189">189</a><td>  if (!COMPILED) {<tr><td><a name="l190" href="#l190">190</a><td>    // Ensure that the same namespace isn&#39;t provided twice. This is intended<tr><td><a name="l191" href="#l191">191</a><td>    // to teach new developers that &#39;goog.provide&#39; is effectively a variable<tr><td><a name="l192" href="#l192">192</a><td>    // declaration. And when JSCompiler transforms goog.provide into a real<tr><td><a name="l193" href="#l193">193</a><td>    // variable declaration, the compiled JS should work the same as the raw<tr><td><a name="l194" href="#l194">194</a><td>    // JS--even when the raw JS uses goog.provide incorrectly.<tr><td><a name="l195" href="#l195">195</a><td>    if (goog.isProvided_(name)) {<tr><td><a name="l196" href="#l196">196</a><td>      throw Error(&#39;Namespace &quot;&#39; + name + &#39;&quot; already declared.&#39;);<tr><td><a name="l197" href="#l197">197</a><td>    }<tr><td><a name="l198" href="#l198">198</a><td>    delete goog.implicitNamespaces_[name];<tr><td><a name="l199" href="#l199">199</a><td><tr><td><a name="l200" href="#l200">200</a><td>    var namespace = name;<tr><td><a name="l201" href="#l201">201</a><td>    while ((namespace = namespace.substring(0, namespace.lastIndexOf(&#39;.&#39;)))) {<tr><td><a name="l202" href="#l202">202</a><td>      if (goog.getObjectByName(namespace)) {<tr><td><a name="l203" href="#l203">203</a><td>        break;<tr><td><a name="l204" href="#l204">204</a><td>      }<tr><td><a name="l205" href="#l205">205</a><td>      goog.implicitNamespaces_[namespace] = true;<tr><td><a name="l206" href="#l206">206</a><td>    }<tr><td><a name="l207" href="#l207">207</a><td>  }<tr><td><a name="l208" href="#l208">208</a><td><tr><td><a name="l209" href="#l209">209</a><td>  goog.exportPath_(name);<tr><td><a name="l210" href="#l210">210</a><td>};<tr><td><a name="l211" href="#l211">211</a><td><tr><td><a name="l212" href="#l212">212</a><td><tr><td><a name="l213" href="#l213">213</a><td>/**<tr><td><a name="l214" href="#l214">214</a><td> * Marks that the current file should only be used for testing, and never for<tr><td><a name="l215" href="#l215">215</a><td> * live code in production.<tr><td><a name="l216" href="#l216">216</a><td> *<tr><td><a name="l217" href="#l217">217</a><td> * In the case of unit tests, the message may optionally be an exact<tr><td><a name="l218" href="#l218">218</a><td> * namespace for the test (e.g. &#39;goog.stringTest&#39;). The linter will then<tr><td><a name="l219" href="#l219">219</a><td> * ignore the extra provide (if not explicitly defined in the code).<tr><td><a name="l220" href="#l220">220</a><td> *<tr><td><a name="l221" href="#l221">221</a><td> * @param {string=} opt_message Optional message to add to the error that&#39;s<tr><td><a name="l222" href="#l222">222</a><td> *     raised when used in production code.<tr><td><a name="l223" href="#l223">223</a><td> */<tr><td><a name="l224" href="#l224">224</a><td>goog.setTestOnly = function(opt_message) {<tr><td><a name="l225" href="#l225">225</a><td>  if (COMPILED &amp;&amp; !goog.DEBUG) {<tr><td><a name="l226" href="#l226">226</a><td>    opt_message = opt_message || &#39;&#39;;<tr><td><a name="l227" href="#l227">227</a><td>    throw Error(&#39;Importing test-only code into non-debug environment&#39; +<tr><td><a name="l228" href="#l228">228</a><td>                opt_message ? &#39;: &#39; + opt_message : &#39;.&#39;);<tr><td><a name="l229" href="#l229">229</a><td>  }<tr><td><a name="l230" href="#l230">230</a><td>};<tr><td><a name="l231" href="#l231">231</a><td><tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td>if (!COMPILED) {<tr><td><a name="l234" href="#l234">234</a><td><tr><td><a name="l235" href="#l235">235</a><td>  /**<tr><td><a name="l236" href="#l236">236</a><td>   * Check if the given name has been goog.provided. This will return false for<tr><td><a name="l237" href="#l237">237</a><td>   * names that are available only as implicit namespaces.<tr><td><a name="l238" href="#l238">238</a><td>   * @param {string} name name of the object to look for.<tr><td><a name="l239" href="#l239">239</a><td>   * @return {boolean} Whether the name has been provided.<tr><td><a name="l240" href="#l240">240</a><td>   * @private<tr><td><a name="l241" href="#l241">241</a><td>   */<tr><td><a name="l242" href="#l242">242</a><td>  goog.isProvided_ = function(name) {<tr><td><a name="l243" href="#l243">243</a><td>    return !goog.implicitNamespaces_[name] &amp;&amp; !!goog.getObjectByName(name);<tr><td><a name="l244" href="#l244">244</a><td>  };<tr><td><a name="l245" href="#l245">245</a><td><tr><td><a name="l246" href="#l246">246</a><td>  /**<tr><td><a name="l247" href="#l247">247</a><td>   * Namespaces implicitly defined by goog.provide. For example,<tr><td><a name="l248" href="#l248">248</a><td>   * goog.provide(&#39;goog.events.Event&#39;) implicitly declares<tr><td><a name="l249" href="#l249">249</a><td>   * that &#39;goog&#39; and &#39;goog.events&#39; must be namespaces.<tr><td><a name="l250" href="#l250">250</a><td>   *<tr><td><a name="l251" href="#l251">251</a><td>   * @type {Object}<tr><td><a name="l252" href="#l252">252</a><td>   * @private<tr><td><a name="l253" href="#l253">253</a><td>   */<tr><td><a name="l254" href="#l254">254</a><td>  goog.implicitNamespaces_ = {};<tr><td><a name="l255" href="#l255">255</a><td>}<tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td><tr><td><a name="l258" href="#l258">258</a><td>/**<tr><td><a name="l259" href="#l259">259</a><td> * Returns an object based on its fully qualified external name.  If you are<tr><td><a name="l260" href="#l260">260</a><td> * using a compilation pass that renames property names beware that using this<tr><td><a name="l261" href="#l261">261</a><td> * function will not find renamed properties.<tr><td><a name="l262" href="#l262">262</a><td> *<tr><td><a name="l263" href="#l263">263</a><td> * @param {string} name The fully qualified name.<tr><td><a name="l264" href="#l264">264</a><td> * @param {Object=} opt_obj The object within which to look; default is<tr><td><a name="l265" href="#l265">265</a><td> *     |goog.global|.<tr><td><a name="l266" href="#l266">266</a><td> * @return {?} The value (object or primitive) or, if not found, null.<tr><td><a name="l267" href="#l267">267</a><td> */<tr><td><a name="l268" href="#l268">268</a><td>goog.getObjectByName = function(name, opt_obj) {<tr><td><a name="l269" href="#l269">269</a><td>  var parts = name.split(&#39;.&#39;);<tr><td><a name="l270" href="#l270">270</a><td>  var cur = opt_obj || goog.global;<tr><td><a name="l271" href="#l271">271</a><td>  for (var part; part = parts.shift(); ) {<tr><td><a name="l272" href="#l272">272</a><td>    if (goog.isDefAndNotNull(cur[part])) {<tr><td><a name="l273" href="#l273">273</a><td>      cur = cur[part];<tr><td><a name="l274" href="#l274">274</a><td>    } else {<tr><td><a name="l275" href="#l275">275</a><td>      return null;<tr><td><a name="l276" href="#l276">276</a><td>    }<tr><td><a name="l277" href="#l277">277</a><td>  }<tr><td><a name="l278" href="#l278">278</a><td>  return cur;<tr><td><a name="l279" href="#l279">279</a><td>};<tr><td><a name="l280" href="#l280">280</a><td><tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td>/**<tr><td><a name="l283" href="#l283">283</a><td> * Globalizes a whole namespace, such as goog or goog.lang.<tr><td><a name="l284" href="#l284">284</a><td> *<tr><td><a name="l285" href="#l285">285</a><td> * @param {Object} obj The namespace to globalize.<tr><td><a name="l286" href="#l286">286</a><td> * @param {Object=} opt_global The object to add the properties to.<tr><td><a name="l287" href="#l287">287</a><td> * @deprecated Properties may be explicitly exported to the global scope, but<tr><td><a name="l288" href="#l288">288</a><td> *     this should no longer be done in bulk.<tr><td><a name="l289" href="#l289">289</a><td> */<tr><td><a name="l290" href="#l290">290</a><td>goog.globalize = function(obj, opt_global) {<tr><td><a name="l291" href="#l291">291</a><td>  var global = opt_global || goog.global;<tr><td><a name="l292" href="#l292">292</a><td>  for (var x in obj) {<tr><td><a name="l293" href="#l293">293</a><td>    global[x] = obj[x];<tr><td><a name="l294" href="#l294">294</a><td>  }<tr><td><a name="l295" href="#l295">295</a><td>};<tr><td><a name="l296" href="#l296">296</a><td><tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td>/**<tr><td><a name="l299" href="#l299">299</a><td> * Adds a dependency from a file to the files it requires.<tr><td><a name="l300" href="#l300">300</a><td> * @param {string} relPath The path to the js file.<tr><td><a name="l301" href="#l301">301</a><td> * @param {Array} provides An array of strings with the names of the objects<tr><td><a name="l302" href="#l302">302</a><td> *                         this file provides.<tr><td><a name="l303" href="#l303">303</a><td> * @param {Array} requires An array of strings with the names of the objects<tr><td><a name="l304" href="#l304">304</a><td> *                         this file requires.<tr><td><a name="l305" href="#l305">305</a><td> */<tr><td><a name="l306" href="#l306">306</a><td>goog.addDependency = function(relPath, provides, requires) {<tr><td><a name="l307" href="#l307">307</a><td>  if (goog.DEPENDENCIES_ENABLED) {<tr><td><a name="l308" href="#l308">308</a><td>    var provide, require;<tr><td><a name="l309" href="#l309">309</a><td>    var path = relPath.replace(/\\/g, &#39;/&#39;);<tr><td><a name="l310" href="#l310">310</a><td>    var deps = goog.dependencies_;<tr><td><a name="l311" href="#l311">311</a><td>    for (var i = 0; provide = provides[i]; i++) {<tr><td><a name="l312" href="#l312">312</a><td>      deps.nameToPath[provide] = path;<tr><td><a name="l313" href="#l313">313</a><td>      if (!(path in deps.pathToNames)) {<tr><td><a name="l314" href="#l314">314</a><td>        deps.pathToNames[path] = {};<tr><td><a name="l315" href="#l315">315</a><td>      }<tr><td><a name="l316" href="#l316">316</a><td>      deps.pathToNames[path][provide] = true;<tr><td><a name="l317" href="#l317">317</a><td>    }<tr><td><a name="l318" href="#l318">318</a><td>    for (var j = 0; require = requires[j]; j++) {<tr><td><a name="l319" href="#l319">319</a><td>      if (!(path in deps.requires)) {<tr><td><a name="l320" href="#l320">320</a><td>        deps.requires[path] = {};<tr><td><a name="l321" href="#l321">321</a><td>      }<tr><td><a name="l322" href="#l322">322</a><td>      deps.requires[path][require] = true;<tr><td><a name="l323" href="#l323">323</a><td>    }<tr><td><a name="l324" href="#l324">324</a><td>  }<tr><td><a name="l325" href="#l325">325</a><td>};<tr><td><a name="l326" href="#l326">326</a><td><tr><td><a name="l327" href="#l327">327</a><td><tr><td><a name="l328" href="#l328">328</a><td><tr><td><a name="l329" href="#l329">329</a><td><tr><td><a name="l330" href="#l330">330</a><td>// NOTE(nnaze): The debug DOM loader was included in base.js as an orignal<tr><td><a name="l331" href="#l331">331</a><td>// way to do &quot;debug-mode&quot; development.  The dependency system can sometimes<tr><td><a name="l332" href="#l332">332</a><td>// be confusing, as can the debug DOM loader&#39;s asyncronous nature.<tr><td><a name="l333" href="#l333">333</a><td>//<tr><td><a name="l334" href="#l334">334</a><td>// With the DOM loader, a call to goog.require() is not blocking -- the<tr><td><a name="l335" href="#l335">335</a><td>// script will not load until some point after the current script.  If a<tr><td><a name="l336" href="#l336">336</a><td>// namespace is needed at runtime, it needs to be defined in a previous<tr><td><a name="l337" href="#l337">337</a><td>// script, or loaded via require() with its registered dependencies.<tr><td><a name="l338" href="#l338">338</a><td>// User-defined namespaces may need their own deps file.  See http://go/js_deps,<tr><td><a name="l339" href="#l339">339</a><td>// http://go/genjsdeps, or, externally, DepsWriter.<tr><td><a name="l340" href="#l340">340</a><td>// http://code.google.com/closure/library/docs/depswriter.html<tr><td><a name="l341" href="#l341">341</a><td>//<tr><td><a name="l342" href="#l342">342</a><td>// Because of legacy clients, the DOM loader can&#39;t be easily removed from<tr><td><a name="l343" href="#l343">343</a><td>// base.js.  Work is being done to make it disableable or replaceable for<tr><td><a name="l344" href="#l344">344</a><td>// different environments (DOM-less JavaScript interpreters like Rhino or V8,<tr><td><a name="l345" href="#l345">345</a><td>// for example). See bootstrap/ for more information.<tr><td><a name="l346" href="#l346">346</a><td><tr><td><a name="l347" href="#l347">347</a><td><tr><td><a name="l348" href="#l348">348</a><td>/**<tr><td><a name="l349" href="#l349">349</a><td> * @define {boolean} Whether to enable the debug loader.<tr><td><a name="l350" href="#l350">350</a><td> *<tr><td><a name="l351" href="#l351">351</a><td> * If enabled, a call to goog.require() will attempt to load the namespace by<tr><td><a name="l352" href="#l352">352</a><td> * appending a script tag to the DOM (if the namespace has been registered).<tr><td><a name="l353" href="#l353">353</a><td> *<tr><td><a name="l354" href="#l354">354</a><td> * If disabled, goog.require() will simply assert that the namespace has been<tr><td><a name="l355" href="#l355">355</a><td> * provided (and depend on the fact that some outside tool correctly ordered<tr><td><a name="l356" href="#l356">356</a><td> * the script).<tr><td><a name="l357" href="#l357">357</a><td> */<tr><td><a name="l358" href="#l358">358</a><td>goog.define(&#39;goog.ENABLE_DEBUG_LOADER&#39;, true);<tr><td><a name="l359" href="#l359">359</a><td><tr><td><a name="l360" href="#l360">360</a><td><tr><td><a name="l361" href="#l361">361</a><td>/**<tr><td><a name="l362" href="#l362">362</a><td> * Implements a system for the dynamic resolution of dependencies<tr><td><a name="l363" href="#l363">363</a><td> * that works in parallel with the BUILD system. Note that all calls<tr><td><a name="l364" href="#l364">364</a><td> * to goog.require will be stripped by the JSCompiler when the<tr><td><a name="l365" href="#l365">365</a><td> * --closure_pass option is used.<tr><td><a name="l366" href="#l366">366</a><td> * @see goog.provide<tr><td><a name="l367" href="#l367">367</a><td> * @param {string} name Namespace to include (as was given in goog.provide())<tr><td><a name="l368" href="#l368">368</a><td> *     in the form &quot;goog.package.part&quot;.<tr><td><a name="l369" href="#l369">369</a><td> */<tr><td><a name="l370" href="#l370">370</a><td>goog.require = function(name) {<tr><td><a name="l371" href="#l371">371</a><td><tr><td><a name="l372" href="#l372">372</a><td>  // if the object already exists we do not need do do anything<tr><td><a name="l373" href="#l373">373</a><td>  // TODO(arv): If we start to support require based on file name this has<tr><td><a name="l374" href="#l374">374</a><td>  //            to change<tr><td><a name="l375" href="#l375">375</a><td>  // TODO(arv): If we allow goog.foo.* this has to change<tr><td><a name="l376" href="#l376">376</a><td>  // TODO(arv): If we implement dynamic load after page load we should probably<tr><td><a name="l377" href="#l377">377</a><td>  //            not remove this code for the compiled output<tr><td><a name="l378" href="#l378">378</a><td>  if (!COMPILED) {<tr><td><a name="l379" href="#l379">379</a><td>    if (goog.isProvided_(name)) {<tr><td><a name="l380" href="#l380">380</a><td>      return;<tr><td><a name="l381" href="#l381">381</a><td>    }<tr><td><a name="l382" href="#l382">382</a><td><tr><td><a name="l383" href="#l383">383</a><td>    if (goog.ENABLE_DEBUG_LOADER) {<tr><td><a name="l384" href="#l384">384</a><td>      var path = goog.getPathFromDeps_(name);<tr><td><a name="l385" href="#l385">385</a><td>      if (path) {<tr><td><a name="l386" href="#l386">386</a><td>        goog.included_[path] = true;<tr><td><a name="l387" href="#l387">387</a><td>        goog.writeScripts_();<tr><td><a name="l388" href="#l388">388</a><td>        return;<tr><td><a name="l389" href="#l389">389</a><td>      }<tr><td><a name="l390" href="#l390">390</a><td>    }<tr><td><a name="l391" href="#l391">391</a><td><tr><td><a name="l392" href="#l392">392</a><td>    var errorMessage = &#39;goog.require could not find: &#39; + name;<tr><td><a name="l393" href="#l393">393</a><td>    if (goog.global.console) {<tr><td><a name="l394" href="#l394">394</a><td>      goog.global.console[&#39;error&#39;](errorMessage);<tr><td><a name="l395" href="#l395">395</a><td>    }<tr><td><a name="l396" href="#l396">396</a><td><tr><td><a name="l397" href="#l397">397</a><td><tr><td><a name="l398" href="#l398">398</a><td>      throw Error(errorMessage);<tr><td><a name="l399" href="#l399">399</a><td><tr><td><a name="l400" href="#l400">400</a><td>  }<tr><td><a name="l401" href="#l401">401</a><td>};<tr><td><a name="l402" href="#l402">402</a><td><tr><td><a name="l403" href="#l403">403</a><td><tr><td><a name="l404" href="#l404">404</a><td>/**<tr><td><a name="l405" href="#l405">405</a><td> * Path for included scripts<tr><td><a name="l406" href="#l406">406</a><td> * @type {string}<tr><td><a name="l407" href="#l407">407</a><td> */<tr><td><a name="l408" href="#l408">408</a><td>goog.basePath = &#39;&#39;;<tr><td><a name="l409" href="#l409">409</a><td><tr><td><a name="l410" href="#l410">410</a><td><tr><td><a name="l411" href="#l411">411</a><td>/**<tr><td><a name="l412" href="#l412">412</a><td> * A hook for overriding the base path.<tr><td><a name="l413" href="#l413">413</a><td> * @type {string|undefined}<tr><td><a name="l414" href="#l414">414</a><td> */<tr><td><a name="l415" href="#l415">415</a><td>goog.global.CLOSURE_BASE_PATH;<tr><td><a name="l416" href="#l416">416</a><td><tr><td><a name="l417" href="#l417">417</a><td><tr><td><a name="l418" href="#l418">418</a><td>/**<tr><td><a name="l419" href="#l419">419</a><td> * Whether to write out Closure&#39;s deps file. By default,<tr><td><a name="l420" href="#l420">420</a><td> * the deps are written.<tr><td><a name="l421" href="#l421">421</a><td> * @type {boolean|undefined}<tr><td><a name="l422" href="#l422">422</a><td> */<tr><td><a name="l423" href="#l423">423</a><td>goog.global.CLOSURE_NO_DEPS;<tr><td><a name="l424" href="#l424">424</a><td><tr><td><a name="l425" href="#l425">425</a><td><tr><td><a name="l426" href="#l426">426</a><td>/**<tr><td><a name="l427" href="#l427">427</a><td> * A function to import a single script. This is meant to be overridden when<tr><td><a name="l428" href="#l428">428</a><td> * Closure is being run in non-HTML contexts, such as web workers. It&#39;s defined<tr><td><a name="l429" href="#l429">429</a><td> * in the global scope so that it can be set before base.js is loaded, which<tr><td><a name="l430" href="#l430">430</a><td> * allows deps.js to be imported properly.<tr><td><a name="l431" href="#l431">431</a><td> *<tr><td><a name="l432" href="#l432">432</a><td> * The function is passed the script source, which is a relative URI. It should<tr><td><a name="l433" href="#l433">433</a><td> * return true if the script was imported, false otherwise.<tr><td><a name="l434" href="#l434">434</a><td> */<tr><td><a name="l435" href="#l435">435</a><td>goog.global.CLOSURE_IMPORT_SCRIPT;<tr><td><a name="l436" href="#l436">436</a><td><tr><td><a name="l437" href="#l437">437</a><td><tr><td><a name="l438" href="#l438">438</a><td>/**<tr><td><a name="l439" href="#l439">439</a><td> * Null function used for default values of callbacks, etc.<tr><td><a name="l440" href="#l440">440</a><td> * @return {void} Nothing.<tr><td><a name="l441" href="#l441">441</a><td> */<tr><td><a name="l442" href="#l442">442</a><td>goog.nullFunction = function() {};<tr><td><a name="l443" href="#l443">443</a><td><tr><td><a name="l444" href="#l444">444</a><td><tr><td><a name="l445" href="#l445">445</a><td>/**<tr><td><a name="l446" href="#l446">446</a><td> * The identity function. Returns its first argument.<tr><td><a name="l447" href="#l447">447</a><td> *<tr><td><a name="l448" href="#l448">448</a><td> * @param {*=} opt_returnValue The single value that will be returned.<tr><td><a name="l449" href="#l449">449</a><td> * @param {...*} var_args Optional trailing arguments. These are ignored.<tr><td><a name="l450" href="#l450">450</a><td> * @return {?} The first argument. We can&#39;t know the type -- just pass it along<tr><td><a name="l451" href="#l451">451</a><td> *      without type.<tr><td><a name="l452" href="#l452">452</a><td> * @deprecated Use goog.functions.identity instead.<tr><td><a name="l453" href="#l453">453</a><td> */<tr><td><a name="l454" href="#l454">454</a><td>goog.identityFunction = function(opt_returnValue, var_args) {<tr><td><a name="l455" href="#l455">455</a><td>  return opt_returnValue;<tr><td><a name="l456" href="#l456">456</a><td>};<tr><td><a name="l457" href="#l457">457</a><td><tr><td><a name="l458" href="#l458">458</a><td><tr><td><a name="l459" href="#l459">459</a><td>/**<tr><td><a name="l460" href="#l460">460</a><td> * When defining a class Foo with an abstract method bar(), you can do:<tr><td><a name="l461" href="#l461">461</a><td> *<tr><td><a name="l462" href="#l462">462</a><td> * Foo.prototype.bar = goog.abstractMethod<tr><td><a name="l463" href="#l463">463</a><td> *<tr><td><a name="l464" href="#l464">464</a><td> * Now if a subclass of Foo fails to override bar(), an error<tr><td><a name="l465" href="#l465">465</a><td> * will be thrown when bar() is invoked.<tr><td><a name="l466" href="#l466">466</a><td> *<tr><td><a name="l467" href="#l467">467</a><td> * Note: This does not take the name of the function to override as<tr><td><a name="l468" href="#l468">468</a><td> * an argument because that would make it more difficult to obfuscate<tr><td><a name="l469" href="#l469">469</a><td> * our JavaScript code.<tr><td><a name="l470" href="#l470">470</a><td> *<tr><td><a name="l471" href="#l471">471</a><td> * @type {!Function}<tr><td><a name="l472" href="#l472">472</a><td> * @throws {Error} when invoked to indicate the method should be<tr><td><a name="l473" href="#l473">473</a><td> *   overridden.<tr><td><a name="l474" href="#l474">474</a><td> */<tr><td><a name="l475" href="#l475">475</a><td>goog.abstractMethod = function() {<tr><td><a name="l476" href="#l476">476</a><td>  throw Error(&#39;unimplemented abstract method&#39;);<tr><td><a name="l477" href="#l477">477</a><td>};<tr><td><a name="l478" href="#l478">478</a><td><tr><td><a name="l479" href="#l479">479</a><td><tr><td><a name="l480" href="#l480">480</a><td>/**<tr><td><a name="l481" href="#l481">481</a><td> * Adds a {@code getInstance} static method that always return the same instance<tr><td><a name="l482" href="#l482">482</a><td> * object.<tr><td><a name="l483" href="#l483">483</a><td> * @param {!Function} ctor The constructor for the class to add the static<tr><td><a name="l484" href="#l484">484</a><td> *     method to.<tr><td><a name="l485" href="#l485">485</a><td> */<tr><td><a name="l486" href="#l486">486</a><td>goog.addSingletonGetter = function(ctor) {<tr><td><a name="l487" href="#l487">487</a><td>  ctor.getInstance = function() {<tr><td><a name="l488" href="#l488">488</a><td>    if (ctor.instance_) {<tr><td><a name="l489" href="#l489">489</a><td>      return ctor.instance_;<tr><td><a name="l490" href="#l490">490</a><td>    }<tr><td><a name="l491" href="#l491">491</a><td>    if (goog.DEBUG) {<tr><td><a name="l492" href="#l492">492</a><td>      // NOTE: JSCompiler can&#39;t optimize away Array#push.<tr><td><a name="l493" href="#l493">493</a><td>      goog.instantiatedSingletons_[goog.instantiatedSingletons_.length] = ctor;<tr><td><a name="l494" href="#l494">494</a><td>    }<tr><td><a name="l495" href="#l495">495</a><td>    return ctor.instance_ = new ctor;<tr><td><a name="l496" href="#l496">496</a><td>  };<tr><td><a name="l497" href="#l497">497</a><td>};<tr><td><a name="l498" href="#l498">498</a><td><tr><td><a name="l499" href="#l499">499</a><td><tr><td><a name="l500" href="#l500">500</a><td>/**<tr><td><a name="l501" href="#l501">501</a><td> * All singleton classes that have been instantiated, for testing. Don&#39;t read<tr><td><a name="l502" href="#l502">502</a><td> * it directly, use the {@code goog.testing.singleton} module. The compiler<tr><td><a name="l503" href="#l503">503</a><td> * removes this variable if unused.<tr><td><a name="l504" href="#l504">504</a><td> * @type {!Array.&lt;!Function&gt;}<tr><td><a name="l505" href="#l505">505</a><td> * @private<tr><td><a name="l506" href="#l506">506</a><td> */<tr><td><a name="l507" href="#l507">507</a><td>goog.instantiatedSingletons_ = [];<tr><td><a name="l508" href="#l508">508</a><td><tr><td><a name="l509" href="#l509">509</a><td><tr><td><a name="l510" href="#l510">510</a><td>/**<tr><td><a name="l511" href="#l511">511</a><td> * True if goog.dependencies_ is available.<tr><td><a name="l512" href="#l512">512</a><td> * @const {boolean}<tr><td><a name="l513" href="#l513">513</a><td> */<tr><td><a name="l514" href="#l514">514</a><td>goog.DEPENDENCIES_ENABLED = !COMPILED &amp;&amp; goog.ENABLE_DEBUG_LOADER;<tr><td><a name="l515" href="#l515">515</a><td><tr><td><a name="l516" href="#l516">516</a><td><tr><td><a name="l517" href="#l517">517</a><td>if (goog.DEPENDENCIES_ENABLED) {<tr><td><a name="l518" href="#l518">518</a><td>  /**<tr><td><a name="l519" href="#l519">519</a><td>   * Object used to keep track of urls that have already been added. This<tr><td><a name="l520" href="#l520">520</a><td>   * record allows the prevention of circular dependencies.<tr><td><a name="l521" href="#l521">521</a><td>   * @type {Object}<tr><td><a name="l522" href="#l522">522</a><td>   * @private<tr><td><a name="l523" href="#l523">523</a><td>   */<tr><td><a name="l524" href="#l524">524</a><td>  goog.included_ = {};<tr><td><a name="l525" href="#l525">525</a><td><tr><td><a name="l526" href="#l526">526</a><td><tr><td><a name="l527" href="#l527">527</a><td>  /**<tr><td><a name="l528" href="#l528">528</a><td>   * This object is used to keep track of dependencies and other data that is<tr><td><a name="l529" href="#l529">529</a><td>   * used for loading scripts<tr><td><a name="l530" href="#l530">530</a><td>   * @private<tr><td><a name="l531" href="#l531">531</a><td>   * @type {Object}<tr><td><a name="l532" href="#l532">532</a><td>   */<tr><td><a name="l533" href="#l533">533</a><td>  goog.dependencies_ = {<tr><td><a name="l534" href="#l534">534</a><td>    pathToNames: {}, // 1 to many<tr><td><a name="l535" href="#l535">535</a><td>    nameToPath: {}, // 1 to 1<tr><td><a name="l536" href="#l536">536</a><td>    requires: {}, // 1 to many<tr><td><a name="l537" href="#l537">537</a><td>    // used when resolving dependencies to prevent us from<tr><td><a name="l538" href="#l538">538</a><td>    // visiting the file twice<tr><td><a name="l539" href="#l539">539</a><td>    visited: {},<tr><td><a name="l540" href="#l540">540</a><td>    written: {} // used to keep track of script files we have written<tr><td><a name="l541" href="#l541">541</a><td>  };<tr><td><a name="l542" href="#l542">542</a><td><tr><td><a name="l543" href="#l543">543</a><td><tr><td><a name="l544" href="#l544">544</a><td>  /**<tr><td><a name="l545" href="#l545">545</a><td>   * Tries to detect whether is in the context of an HTML document.<tr><td><a name="l546" href="#l546">546</a><td>   * @return {boolean} True if it looks like HTML document.<tr><td><a name="l547" href="#l547">547</a><td>   * @private<tr><td><a name="l548" href="#l548">548</a><td>   */<tr><td><a name="l549" href="#l549">549</a><td>  goog.inHtmlDocument_ = function() {<tr><td><a name="l550" href="#l550">550</a><td>    var doc = goog.global.document;<tr><td><a name="l551" href="#l551">551</a><td>    return typeof doc != &#39;undefined&#39; &amp;&amp;<tr><td><a name="l552" href="#l552">552</a><td>           &#39;write&#39; in doc;  // XULDocument misses write.<tr><td><a name="l553" href="#l553">553</a><td>  };<tr><td><a name="l554" href="#l554">554</a><td><tr><td><a name="l555" href="#l555">555</a><td><tr><td><a name="l556" href="#l556">556</a><td>  /**<tr><td><a name="l557" href="#l557">557</a><td>   * Tries to detect the base path of the base.js script that bootstraps Closure<tr><td><a name="l558" href="#l558">558</a><td>   * @private<tr><td><a name="l559" href="#l559">559</a><td>   */<tr><td><a name="l560" href="#l560">560</a><td>  goog.findBasePath_ = function() {<tr><td><a name="l561" href="#l561">561</a><td>    if (goog.global.CLOSURE_BASE_PATH) {<tr><td><a name="l562" href="#l562">562</a><td>      goog.basePath = goog.global.CLOSURE_BASE_PATH;<tr><td><a name="l563" href="#l563">563</a><td>      return;<tr><td><a name="l564" href="#l564">564</a><td>    } else if (!goog.inHtmlDocument_()) {<tr><td><a name="l565" href="#l565">565</a><td>      return;<tr><td><a name="l566" href="#l566">566</a><td>    }<tr><td><a name="l567" href="#l567">567</a><td>    var doc = goog.global.document;<tr><td><a name="l568" href="#l568">568</a><td>    var scripts = doc.getElementsByTagName(&#39;script&#39;);<tr><td><a name="l569" href="#l569">569</a><td>    // Search backwards since the current script is in almost all cases the one<tr><td><a name="l570" href="#l570">570</a><td>    // that has base.js.<tr><td><a name="l571" href="#l571">571</a><td>    for (var i = scripts.length - 1; i &gt;= 0; --i) {<tr><td><a name="l572" href="#l572">572</a><td>      var src = scripts[i].src;<tr><td><a name="l573" href="#l573">573</a><td>      var qmark = src.lastIndexOf(&#39;?&#39;);<tr><td><a name="l574" href="#l574">574</a><td>      var l = qmark == -1 ? src.length : qmark;<tr><td><a name="l575" href="#l575">575</a><td>      if (src.substr(l - 7, 7) == &#39;base.js&#39;) {<tr><td><a name="l576" href="#l576">576</a><td>        goog.basePath = src.substr(0, l - 7);<tr><td><a name="l577" href="#l577">577</a><td>        return;<tr><td><a name="l578" href="#l578">578</a><td>      }<tr><td><a name="l579" href="#l579">579</a><td>    }<tr><td><a name="l580" href="#l580">580</a><td>  };<tr><td><a name="l581" href="#l581">581</a><td><tr><td><a name="l582" href="#l582">582</a><td><tr><td><a name="l583" href="#l583">583</a><td>  /**<tr><td><a name="l584" href="#l584">584</a><td>   * Imports a script if, and only if, that script hasn&#39;t already been imported.<tr><td><a name="l585" href="#l585">585</a><td>   * (Must be called at execution time)<tr><td><a name="l586" href="#l586">586</a><td>   * @param {string} src Script source.<tr><td><a name="l587" href="#l587">587</a><td>   * @private<tr><td><a name="l588" href="#l588">588</a><td>   */<tr><td><a name="l589" href="#l589">589</a><td>  goog.importScript_ = function(src) {<tr><td><a name="l590" href="#l590">590</a><td>    var importScript = goog.global.CLOSURE_IMPORT_SCRIPT ||<tr><td><a name="l591" href="#l591">591</a><td>        goog.writeScriptTag_;<tr><td><a name="l592" href="#l592">592</a><td>    if (!goog.dependencies_.written[src] &amp;&amp; importScript(src)) {<tr><td><a name="l593" href="#l593">593</a><td>      goog.dependencies_.written[src] = true;<tr><td><a name="l594" href="#l594">594</a><td>    }<tr><td><a name="l595" href="#l595">595</a><td>  };<tr><td><a name="l596" href="#l596">596</a><td><tr><td><a name="l597" href="#l597">597</a><td><tr><td><a name="l598" href="#l598">598</a><td>  /**<tr><td><a name="l599" href="#l599">599</a><td>   * The default implementation of the import function. Writes a script tag to<tr><td><a name="l600" href="#l600">600</a><td>   * import the script.<tr><td><a name="l601" href="#l601">601</a><td>   *<tr><td><a name="l602" href="#l602">602</a><td>   * @param {string} src The script source.<tr><td><a name="l603" href="#l603">603</a><td>   * @return {boolean} True if the script was imported, false otherwise.<tr><td><a name="l604" href="#l604">604</a><td>   * @private<tr><td><a name="l605" href="#l605">605</a><td>   */<tr><td><a name="l606" href="#l606">606</a><td>  goog.writeScriptTag_ = function(src) {<tr><td><a name="l607" href="#l607">607</a><td>    if (goog.inHtmlDocument_()) {<tr><td><a name="l608" href="#l608">608</a><td>      var doc = goog.global.document;<tr><td><a name="l609" href="#l609">609</a><td><tr><td><a name="l610" href="#l610">610</a><td>      // If the user tries to require a new symbol after document load,<tr><td><a name="l611" href="#l611">611</a><td>      // something has gone terribly wrong. Doing a document.write would<tr><td><a name="l612" href="#l612">612</a><td>      // wipe out the page.<tr><td><a name="l613" href="#l613">613</a><td>      if (doc.readyState == &#39;complete&#39;) {<tr><td><a name="l614" href="#l614">614</a><td>        // Certain test frameworks load base.js multiple times, which tries<tr><td><a name="l615" href="#l615">615</a><td>        // to write deps.js each time. If that happens, just fail silently.<tr><td><a name="l616" href="#l616">616</a><td>        // These frameworks wipe the page between each load of base.js, so this<tr><td><a name="l617" href="#l617">617</a><td>        // is OK.<tr><td><a name="l618" href="#l618">618</a><td>        var isDeps = /\bdeps.js$/.test(src);<tr><td><a name="l619" href="#l619">619</a><td>        if (isDeps) {<tr><td><a name="l620" href="#l620">620</a><td>          return false;<tr><td><a name="l621" href="#l621">621</a><td>        } else {<tr><td><a name="l622" href="#l622">622</a><td>          throw Error(&#39;Cannot write &quot;&#39; + src + &#39;&quot; after document load&#39;);<tr><td><a name="l623" href="#l623">623</a><td>        }<tr><td><a name="l624" href="#l624">624</a><td>      }<tr><td><a name="l625" href="#l625">625</a><td><tr><td><a name="l626" href="#l626">626</a><td>      doc.write(<tr><td><a name="l627" href="#l627">627</a><td>          &#39;&lt;script type=&quot;text/javascript&quot; src=&quot;&#39; + src + &#39;&quot;&gt;&lt;/&#39; + &#39;script&gt;&#39;);<tr><td><a name="l628" href="#l628">628</a><td>      return true;<tr><td><a name="l629" href="#l629">629</a><td>    } else {<tr><td><a name="l630" href="#l630">630</a><td>      return false;<tr><td><a name="l631" href="#l631">631</a><td>    }<tr><td><a name="l632" href="#l632">632</a><td>  };<tr><td><a name="l633" href="#l633">633</a><td><tr><td><a name="l634" href="#l634">634</a><td><tr><td><a name="l635" href="#l635">635</a><td>  /**<tr><td><a name="l636" href="#l636">636</a><td>   * Resolves dependencies based on the dependencies added using addDependency<tr><td><a name="l637" href="#l637">637</a><td>   * and calls importScript_ in the correct order.<tr><td><a name="l638" href="#l638">638</a><td>   * @private<tr><td><a name="l639" href="#l639">639</a><td>   */<tr><td><a name="l640" href="#l640">640</a><td>  goog.writeScripts_ = function() {<tr><td><a name="l641" href="#l641">641</a><td>    // the scripts we need to write this time<tr><td><a name="l642" href="#l642">642</a><td>    var scripts = [];<tr><td><a name="l643" href="#l643">643</a><td>    var seenScript = {};<tr><td><a name="l644" href="#l644">644</a><td>    var deps = goog.dependencies_;<tr><td><a name="l645" href="#l645">645</a><td><tr><td><a name="l646" href="#l646">646</a><td>    function visitNode(path) {<tr><td><a name="l647" href="#l647">647</a><td>      if (path in deps.written) {<tr><td><a name="l648" href="#l648">648</a><td>        return;<tr><td><a name="l649" href="#l649">649</a><td>      }<tr><td><a name="l650" href="#l650">650</a><td><tr><td><a name="l651" href="#l651">651</a><td>      // we have already visited this one. We can get here if we have cyclic<tr><td><a name="l652" href="#l652">652</a><td>      // dependencies<tr><td><a name="l653" href="#l653">653</a><td>      if (path in deps.visited) {<tr><td><a name="l654" href="#l654">654</a><td>        if (!(path in seenScript)) {<tr><td><a name="l655" href="#l655">655</a><td>          seenScript[path] = true;<tr><td><a name="l656" href="#l656">656</a><td>          scripts.push(path);<tr><td><a name="l657" href="#l657">657</a><td>        }<tr><td><a name="l658" href="#l658">658</a><td>        return;<tr><td><a name="l659" href="#l659">659</a><td>      }<tr><td><a name="l660" href="#l660">660</a><td><tr><td><a name="l661" href="#l661">661</a><td>      deps.visited[path] = true;<tr><td><a name="l662" href="#l662">662</a><td><tr><td><a name="l663" href="#l663">663</a><td>      if (path in deps.requires) {<tr><td><a name="l664" href="#l664">664</a><td>        for (var requireName in deps.requires[path]) {<tr><td><a name="l665" href="#l665">665</a><td>          // If the required name is defined, we assume that it was already<tr><td><a name="l666" href="#l666">666</a><td>          // bootstrapped by other means.<tr><td><a name="l667" href="#l667">667</a><td>          if (!goog.isProvided_(requireName)) {<tr><td><a name="l668" href="#l668">668</a><td>            if (requireName in deps.nameToPath) {<tr><td><a name="l669" href="#l669">669</a><td>              visitNode(deps.nameToPath[requireName]);<tr><td><a name="l670" href="#l670">670</a><td>            } else {<tr><td><a name="l671" href="#l671">671</a><td>              throw Error(&#39;Undefined nameToPath for &#39; + requireName);<tr><td><a name="l672" href="#l672">672</a><td>            }<tr><td><a name="l673" href="#l673">673</a><td>          }<tr><td><a name="l674" href="#l674">674</a><td>        }<tr><td><a name="l675" href="#l675">675</a><td>      }<tr><td><a name="l676" href="#l676">676</a><td><tr><td><a name="l677" href="#l677">677</a><td>      if (!(path in seenScript)) {<tr><td><a name="l678" href="#l678">678</a><td>        seenScript[path] = true;<tr><td><a name="l679" href="#l679">679</a><td>        scripts.push(path);<tr><td><a name="l680" href="#l680">680</a><td>      }<tr><td><a name="l681" href="#l681">681</a><td>    }<tr><td><a name="l682" href="#l682">682</a><td><tr><td><a name="l683" href="#l683">683</a><td>    for (var path in goog.included_) {<tr><td><a name="l684" href="#l684">684</a><td>      if (!deps.written[path]) {<tr><td><a name="l685" href="#l685">685</a><td>        visitNode(path);<tr><td><a name="l686" href="#l686">686</a><td>      }<tr><td><a name="l687" href="#l687">687</a><td>    }<tr><td><a name="l688" href="#l688">688</a><td><tr><td><a name="l689" href="#l689">689</a><td>    for (var i = 0; i &lt; scripts.length; i++) {<tr><td><a name="l690" href="#l690">690</a><td>      if (scripts[i]) {<tr><td><a name="l691" href="#l691">691</a><td>        goog.importScript_(goog.basePath + scripts[i]);<tr><td><a name="l692" href="#l692">692</a><td>      } else {<tr><td><a name="l693" href="#l693">693</a><td>        throw Error(&#39;Undefined script input&#39;);<tr><td><a name="l694" href="#l694">694</a><td>      }<tr><td><a name="l695" href="#l695">695</a><td>    }<tr><td><a name="l696" href="#l696">696</a><td>  };<tr><td><a name="l697" href="#l697">697</a><td><tr><td><a name="l698" href="#l698">698</a><td><tr><td><a name="l699" href="#l699">699</a><td>  /**<tr><td><a name="l700" href="#l700">700</a><td>   * Looks at the dependency rules and tries to determine the script file that<tr><td><a name="l701" href="#l701">701</a><td>   * fulfills a particular rule.<tr><td><a name="l702" href="#l702">702</a><td>   * @param {string} rule In the form goog.namespace.Class or project.script.<tr><td><a name="l703" href="#l703">703</a><td>   * @return {?string} Url corresponding to the rule, or null.<tr><td><a name="l704" href="#l704">704</a><td>   * @private<tr><td><a name="l705" href="#l705">705</a><td>   */<tr><td><a name="l706" href="#l706">706</a><td>  goog.getPathFromDeps_ = function(rule) {<tr><td><a name="l707" href="#l707">707</a><td>    if (rule in goog.dependencies_.nameToPath) {<tr><td><a name="l708" href="#l708">708</a><td>      return goog.dependencies_.nameToPath[rule];<tr><td><a name="l709" href="#l709">709</a><td>    } else {<tr><td><a name="l710" href="#l710">710</a><td>      return null;<tr><td><a name="l711" href="#l711">711</a><td>    }<tr><td><a name="l712" href="#l712">712</a><td>  };<tr><td><a name="l713" href="#l713">713</a><td><tr><td><a name="l714" href="#l714">714</a><td>  goog.findBasePath_();<tr><td><a name="l715" href="#l715">715</a><td><tr><td><a name="l716" href="#l716">716</a><td>  // Allow projects to manage the deps files themselves.<tr><td><a name="l717" href="#l717">717</a><td>  if (!goog.global.CLOSURE_NO_DEPS) {<tr><td><a name="l718" href="#l718">718</a><td>    goog.importScript_(goog.basePath + &#39;deps.js&#39;);<tr><td><a name="l719" href="#l719">719</a><td>  }<tr><td><a name="l720" href="#l720">720</a><td>}<tr><td><a name="l721" href="#l721">721</a><td><tr><td><a name="l722" href="#l722">722</a><td><tr><td><a name="l723" href="#l723">723</a><td><tr><td><a name="l724" href="#l724">724</a><td>//==============================================================================<tr><td><a name="l725" href="#l725">725</a><td>// Language Enhancements<tr><td><a name="l726" href="#l726">726</a><td>//==============================================================================<tr><td><a name="l727" href="#l727">727</a><td><tr><td><a name="l728" href="#l728">728</a><td><tr><td><a name="l729" href="#l729">729</a><td>/**<tr><td><a name="l730" href="#l730">730</a><td> * This is a &quot;fixed&quot; version of the typeof operator.  It differs from the typeof<tr><td><a name="l731" href="#l731">731</a><td> * operator in such a way that null returns &#39;null&#39; and arrays return &#39;array&#39;.<tr><td><a name="l732" href="#l732">732</a><td> * @param {*} value The value to get the type of.<tr><td><a name="l733" href="#l733">733</a><td> * @return {string} The name of the type.<tr><td><a name="l734" href="#l734">734</a><td> */<tr><td><a name="l735" href="#l735">735</a><td>goog.typeOf = function(value) {<tr><td><a name="l736" href="#l736">736</a><td>  var s = typeof value;<tr><td><a name="l737" href="#l737">737</a><td>  if (s == &#39;object&#39;) {<tr><td><a name="l738" href="#l738">738</a><td>    if (value) {<tr><td><a name="l739" href="#l739">739</a><td>      // Check these first, so we can avoid calling Object.prototype.toString if<tr><td><a name="l740" href="#l740">740</a><td>      // possible.<tr><td><a name="l741" href="#l741">741</a><td>      //<tr><td><a name="l742" href="#l742">742</a><td>      // IE improperly marshals tyepof across execution contexts, but a<tr><td><a name="l743" href="#l743">743</a><td>      // cross-context object will still return false for &quot;instanceof Object&quot;.<tr><td><a name="l744" href="#l744">744</a><td>      if (value instanceof Array) {<tr><td><a name="l745" href="#l745">745</a><td>        return &#39;array&#39;;<tr><td><a name="l746" href="#l746">746</a><td>      } else if (value instanceof Object) {<tr><td><a name="l747" href="#l747">747</a><td>        return s;<tr><td><a name="l748" href="#l748">748</a><td>      }<tr><td><a name="l749" href="#l749">749</a><td><tr><td><a name="l750" href="#l750">750</a><td>      // HACK: In order to use an Object prototype method on the arbitrary<tr><td><a name="l751" href="#l751">751</a><td>      //   value, the compiler requires the value be cast to type Object,<tr><td><a name="l752" href="#l752">752</a><td>      //   even though the ECMA spec explicitly allows it.<tr><td><a name="l753" href="#l753">753</a><td>      var className = Object.prototype.toString.call(<tr><td><a name="l754" href="#l754">754</a><td>          /** @type {Object} */ (value));<tr><td><a name="l755" href="#l755">755</a><td>      // In Firefox 3.6, attempting to access iframe window objects&#39; length<tr><td><a name="l756" href="#l756">756</a><td>      // property throws an NS_ERROR_FAILURE, so we need to special-case it<tr><td><a name="l757" href="#l757">757</a><td>      // here.<tr><td><a name="l758" href="#l758">758</a><td>      if (className == &#39;[object Window]&#39;) {<tr><td><a name="l759" href="#l759">759</a><td>        return &#39;object&#39;;<tr><td><a name="l760" href="#l760">760</a><td>      }<tr><td><a name="l761" href="#l761">761</a><td><tr><td><a name="l762" href="#l762">762</a><td>      // We cannot always use constructor == Array or instanceof Array because<tr><td><a name="l763" href="#l763">763</a><td>      // different frames have different Array objects. In IE6, if the iframe<tr><td><a name="l764" href="#l764">764</a><td>      // where the array was created is destroyed, the array loses its<tr><td><a name="l765" href="#l765">765</a><td>      // prototype. Then dereferencing val.splice here throws an exception, so<tr><td><a name="l766" href="#l766">766</a><td>      // we can&#39;t use goog.isFunction. Calling typeof directly returns &#39;unknown&#39;<tr><td><a name="l767" href="#l767">767</a><td>      // so that will work. In this case, this function will return false and<tr><td><a name="l768" href="#l768">768</a><td>      // most array functions will still work because the array is still<tr><td><a name="l769" href="#l769">769</a><td>      // array-like (supports length and []) even though it has lost its<tr><td><a name="l770" href="#l770">770</a><td>      // prototype.<tr><td><a name="l771" href="#l771">771</a><td>      // Mark Miller noticed that Object.prototype.toString<tr><td><a name="l772" href="#l772">772</a><td>      // allows access to the unforgeable [[Class]] property.<tr><td><a name="l773" href="#l773">773</a><td>      //  15.2.4.2 Object.prototype.toString ( )<tr><td><a name="l774" href="#l774">774</a><td>      //  When the toString method is called, the following steps are taken:<tr><td><a name="l775" href="#l775">775</a><td>      //      1. Get the [[Class]] property of this object.<tr><td><a name="l776" href="#l776">776</a><td>      //      2. Compute a string value by concatenating the three strings<tr><td><a name="l777" href="#l777">777</a><td>      //         &quot;[object &quot;, Result(1), and &quot;]&quot;.<tr><td><a name="l778" href="#l778">778</a><td>      //      3. Return Result(2).<tr><td><a name="l779" href="#l779">779</a><td>      // and this behavior survives the destruction of the execution context.<tr><td><a name="l780" href="#l780">780</a><td>      if ((className == &#39;[object Array]&#39; ||<tr><td><a name="l781" href="#l781">781</a><td>           // In IE all non value types are wrapped as objects across window<tr><td><a name="l782" href="#l782">782</a><td>           // boundaries (not iframe though) so we have to do object detection<tr><td><a name="l783" href="#l783">783</a><td>           // for this edge case<tr><td><a name="l784" href="#l784">784</a><td>           typeof value.length == &#39;number&#39; &amp;&amp;<tr><td><a name="l785" href="#l785">785</a><td>           typeof value.splice != &#39;undefined&#39; &amp;&amp;<tr><td><a name="l786" href="#l786">786</a><td>           typeof value.propertyIsEnumerable != &#39;undefined&#39; &amp;&amp;<tr><td><a name="l787" href="#l787">787</a><td>           !value.propertyIsEnumerable(&#39;splice&#39;)<tr><td><a name="l788" href="#l788">788</a><td><tr><td><a name="l789" href="#l789">789</a><td>          )) {<tr><td><a name="l790" href="#l790">790</a><td>        return &#39;array&#39;;<tr><td><a name="l791" href="#l791">791</a><td>      }<tr><td><a name="l792" href="#l792">792</a><td>      // HACK: There is still an array case that fails.<tr><td><a name="l793" href="#l793">793</a><td>      //     function ArrayImpostor() {}<tr><td><a name="l794" href="#l794">794</a><td>      //     ArrayImpostor.prototype = [];<tr><td><a name="l795" href="#l795">795</a><td>      //     var impostor = new ArrayImpostor;<tr><td><a name="l796" href="#l796">796</a><td>      // this can be fixed by getting rid of the fast path<tr><td><a name="l797" href="#l797">797</a><td>      // (value instanceof Array) and solely relying on<tr><td><a name="l798" href="#l798">798</a><td>      // (value &amp;&amp; Object.prototype.toString.vall(value) === &#39;[object Array]&#39;)<tr><td><a name="l799" href="#l799">799</a><td>      // but that would require many more function calls and is not warranted<tr><td><a name="l800" href="#l800">800</a><td>      // unless closure code is receiving objects from untrusted sources.<tr><td><a name="l801" href="#l801">801</a><td><tr><td><a name="l802" href="#l802">802</a><td>      // IE in cross-window calls does not correctly marshal the function type<tr><td><a name="l803" href="#l803">803</a><td>      // (it appears just as an object) so we cannot use just typeof val ==<tr><td><a name="l804" href="#l804">804</a><td>      // &#39;function&#39;. However, if the object has a call property, it is a<tr><td><a name="l805" href="#l805">805</a><td>      // function.<tr><td><a name="l806" href="#l806">806</a><td>      if ((className == &#39;[object Function]&#39; ||<tr><td><a name="l807" href="#l807">807</a><td>          typeof value.call != &#39;undefined&#39; &amp;&amp;<tr><td><a name="l808" href="#l808">808</a><td>          typeof value.propertyIsEnumerable != &#39;undefined&#39; &amp;&amp;<tr><td><a name="l809" href="#l809">809</a><td>          !value.propertyIsEnumerable(&#39;call&#39;))) {<tr><td><a name="l810" href="#l810">810</a><td>        return &#39;function&#39;;<tr><td><a name="l811" href="#l811">811</a><td>      }<tr><td><a name="l812" href="#l812">812</a><td><tr><td><a name="l813" href="#l813">813</a><td><tr><td><a name="l814" href="#l814">814</a><td>    } else {<tr><td><a name="l815" href="#l815">815</a><td>      return &#39;null&#39;;<tr><td><a name="l816" href="#l816">816</a><td>    }<tr><td><a name="l817" href="#l817">817</a><td><tr><td><a name="l818" href="#l818">818</a><td>  } else if (s == &#39;function&#39; &amp;&amp; typeof value.call == &#39;undefined&#39;) {<tr><td><a name="l819" href="#l819">819</a><td>    // In Safari typeof nodeList returns &#39;function&#39;, and on Firefox<tr><td><a name="l820" href="#l820">820</a><td>    // typeof behaves similarly for HTML{Applet,Embed,Object}Elements<tr><td><a name="l821" href="#l821">821</a><td>    // and RegExps.  We would like to return object for those and we can<tr><td><a name="l822" href="#l822">822</a><td>    // detect an invalid function by making sure that the function<tr><td><a name="l823" href="#l823">823</a><td>    // object has a call method.<tr><td><a name="l824" href="#l824">824</a><td>    return &#39;object&#39;;<tr><td><a name="l825" href="#l825">825</a><td>  }<tr><td><a name="l826" href="#l826">826</a><td>  return s;<tr><td><a name="l827" href="#l827">827</a><td>};<tr><td><a name="l828" href="#l828">828</a><td><tr><td><a name="l829" href="#l829">829</a><td><tr><td><a name="l830" href="#l830">830</a><td>/**<tr><td><a name="l831" href="#l831">831</a><td> * Returns true if the specified value is not |undefined|.<tr><td><a name="l832" href="#l832">832</a><td> * WARNING: Do not use this to test if an object has a property. Use the in<tr><td><a name="l833" href="#l833">833</a><td> * operator instead.  Additionally, this function assumes that the global<tr><td><a name="l834" href="#l834">834</a><td> * undefined variable has not been redefined.<tr><td><a name="l835" href="#l835">835</a><td> * @param {*} val Variable to test.<tr><td><a name="l836" href="#l836">836</a><td> * @return {boolean} Whether variable is defined.<tr><td><a name="l837" href="#l837">837</a><td> */<tr><td><a name="l838" href="#l838">838</a><td>goog.isDef = function(val) {<tr><td><a name="l839" href="#l839">839</a><td>  return val !== undefined;<tr><td><a name="l840" href="#l840">840</a><td>};<tr><td><a name="l841" href="#l841">841</a><td><tr><td><a name="l842" href="#l842">842</a><td><tr><td><a name="l843" href="#l843">843</a><td>/**<tr><td><a name="l844" href="#l844">844</a><td> * Returns true if the specified value is |null|<tr><td><a name="l845" href="#l845">845</a><td> * @param {*} val Variable to test.<tr><td><a name="l846" href="#l846">846</a><td> * @return {boolean} Whether variable is null.<tr><td><a name="l847" href="#l847">847</a><td> */<tr><td><a name="l848" href="#l848">848</a><td>goog.isNull = function(val) {<tr><td><a name="l849" href="#l849">849</a><td>  return val === null;<tr><td><a name="l850" href="#l850">850</a><td>};<tr><td><a name="l851" href="#l851">851</a><td><tr><td><a name="l852" href="#l852">852</a><td><tr><td><a name="l853" href="#l853">853</a><td>/**<tr><td><a name="l854" href="#l854">854</a><td> * Returns true if the specified value is defined and not null<tr><td><a name="l855" href="#l855">855</a><td> * @param {*} val Variable to test.<tr><td><a name="l856" href="#l856">856</a><td> * @return {boolean} Whether variable is defined and not null.<tr><td><a name="l857" href="#l857">857</a><td> */<tr><td><a name="l858" href="#l858">858</a><td>goog.isDefAndNotNull = function(val) {<tr><td><a name="l859" href="#l859">859</a><td>  // Note that undefined == null.<tr><td><a name="l860" href="#l860">860</a><td>  return val != null;<tr><td><a name="l861" href="#l861">861</a><td>};<tr><td><a name="l862" href="#l862">862</a><td><tr><td><a name="l863" href="#l863">863</a><td><tr><td><a name="l864" href="#l864">864</a><td>/**<tr><td><a name="l865" href="#l865">865</a><td> * Returns true if the specified value is an array<tr><td><a name="l866" href="#l866">866</a><td> * @param {*} val Variable to test.<tr><td><a name="l867" href="#l867">867</a><td> * @return {boolean} Whether variable is an array.<tr><td><a name="l868" href="#l868">868</a><td> */<tr><td><a name="l869" href="#l869">869</a><td>goog.isArray = function(val) {<tr><td><a name="l870" href="#l870">870</a><td>  return goog.typeOf(val) == &#39;array&#39;;<tr><td><a name="l871" href="#l871">871</a><td>};<tr><td><a name="l872" href="#l872">872</a><td><tr><td><a name="l873" href="#l873">873</a><td><tr><td><a name="l874" href="#l874">874</a><td>/**<tr><td><a name="l875" href="#l875">875</a><td> * Returns true if the object looks like an array. To qualify as array like<tr><td><a name="l876" href="#l876">876</a><td> * the value needs to be either a NodeList or an object with a Number length<tr><td><a name="l877" href="#l877">877</a><td> * property.<tr><td><a name="l878" href="#l878">878</a><td> * @param {*} val Variable to test.<tr><td><a name="l879" href="#l879">879</a><td> * @return {boolean} Whether variable is an array.<tr><td><a name="l880" href="#l880">880</a><td> */<tr><td><a name="l881" href="#l881">881</a><td>goog.isArrayLike = function(val) {<tr><td><a name="l882" href="#l882">882</a><td>  var type = goog.typeOf(val);<tr><td><a name="l883" href="#l883">883</a><td>  return type == &#39;array&#39; || type == &#39;object&#39; &amp;&amp; typeof val.length == &#39;number&#39;;<tr><td><a name="l884" href="#l884">884</a><td>};<tr><td><a name="l885" href="#l885">885</a><td><tr><td><a name="l886" href="#l886">886</a><td><tr><td><a name="l887" href="#l887">887</a><td>/**<tr><td><a name="l888" href="#l888">888</a><td> * Returns true if the object looks like a Date. To qualify as Date-like<tr><td><a name="l889" href="#l889">889</a><td> * the value needs to be an object and have a getFullYear() function.<tr><td><a name="l890" href="#l890">890</a><td> * @param {*} val Variable to test.<tr><td><a name="l891" href="#l891">891</a><td> * @return {boolean} Whether variable is a like a Date.<tr><td><a name="l892" href="#l892">892</a><td> */<tr><td><a name="l893" href="#l893">893</a><td>goog.isDateLike = function(val) {<tr><td><a name="l894" href="#l894">894</a><td>  return goog.isObject(val) &amp;&amp; typeof val.getFullYear == &#39;function&#39;;<tr><td><a name="l895" href="#l895">895</a><td>};<tr><td><a name="l896" href="#l896">896</a><td><tr><td><a name="l897" href="#l897">897</a><td><tr><td><a name="l898" href="#l898">898</a><td>/**<tr><td><a name="l899" href="#l899">899</a><td> * Returns true if the specified value is a string<tr><td><a name="l900" href="#l900">900</a><td> * @param {*} val Variable to test.<tr><td><a name="l901" href="#l901">901</a><td> * @return {boolean} Whether variable is a string.<tr><td><a name="l902" href="#l902">902</a><td> */<tr><td><a name="l903" href="#l903">903</a><td>goog.isString = function(val) {<tr><td><a name="l904" href="#l904">904</a><td>  return typeof val == &#39;string&#39;;<tr><td><a name="l905" href="#l905">905</a><td>};<tr><td><a name="l906" href="#l906">906</a><td><tr><td><a name="l907" href="#l907">907</a><td><tr><td><a name="l908" href="#l908">908</a><td>/**<tr><td><a name="l909" href="#l909">909</a><td> * Returns true if the specified value is a boolean<tr><td><a name="l910" href="#l910">910</a><td> * @param {*} val Variable to test.<tr><td><a name="l911" href="#l911">911</a><td> * @return {boolean} Whether variable is boolean.<tr><td><a name="l912" href="#l912">912</a><td> */<tr><td><a name="l913" href="#l913">913</a><td>goog.isBoolean = function(val) {<tr><td><a name="l914" href="#l914">914</a><td>  return typeof val == &#39;boolean&#39;;<tr><td><a name="l915" href="#l915">915</a><td>};<tr><td><a name="l916" href="#l916">916</a><td><tr><td><a name="l917" href="#l917">917</a><td><tr><td><a name="l918" href="#l918">918</a><td>/**<tr><td><a name="l919" href="#l919">919</a><td> * Returns true if the specified value is a number<tr><td><a name="l920" href="#l920">920</a><td> * @param {*} val Variable to test.<tr><td><a name="l921" href="#l921">921</a><td> * @return {boolean} Whether variable is a number.<tr><td><a name="l922" href="#l922">922</a><td> */<tr><td><a name="l923" href="#l923">923</a><td>goog.isNumber = function(val) {<tr><td><a name="l924" href="#l924">924</a><td>  return typeof val == &#39;number&#39;;<tr><td><a name="l925" href="#l925">925</a><td>};<tr><td><a name="l926" href="#l926">926</a><td><tr><td><a name="l927" href="#l927">927</a><td><tr><td><a name="l928" href="#l928">928</a><td>/**<tr><td><a name="l929" href="#l929">929</a><td> * Returns true if the specified value is a function<tr><td><a name="l930" href="#l930">930</a><td> * @param {*} val Variable to test.<tr><td><a name="l931" href="#l931">931</a><td> * @return {boolean} Whether variable is a function.<tr><td><a name="l932" href="#l932">932</a><td> */<tr><td><a name="l933" href="#l933">933</a><td>goog.isFunction = function(val) {<tr><td><a name="l934" href="#l934">934</a><td>  return goog.typeOf(val) == &#39;function&#39;;<tr><td><a name="l935" href="#l935">935</a><td>};<tr><td><a name="l936" href="#l936">936</a><td><tr><td><a name="l937" href="#l937">937</a><td><tr><td><a name="l938" href="#l938">938</a><td>/**<tr><td><a name="l939" href="#l939">939</a><td> * Returns true if the specified value is an object.  This includes arrays<tr><td><a name="l940" href="#l940">940</a><td> * and functions.<tr><td><a name="l941" href="#l941">941</a><td> * @param {*} val Variable to test.<tr><td><a name="l942" href="#l942">942</a><td> * @return {boolean} Whether variable is an object.<tr><td><a name="l943" href="#l943">943</a><td> */<tr><td><a name="l944" href="#l944">944</a><td>goog.isObject = function(val) {<tr><td><a name="l945" href="#l945">945</a><td>  var type = typeof val;<tr><td><a name="l946" href="#l946">946</a><td>  return type == &#39;object&#39; &amp;&amp; val != null || type == &#39;function&#39;;<tr><td><a name="l947" href="#l947">947</a><td>  // return Object(val) === val also works, but is slower, especially if val is<tr><td><a name="l948" href="#l948">948</a><td>  // not an object.<tr><td><a name="l949" href="#l949">949</a><td>};<tr><td><a name="l950" href="#l950">950</a><td><tr><td><a name="l951" href="#l951">951</a><td><tr><td><a name="l952" href="#l952">952</a><td>/**<tr><td><a name="l953" href="#l953">953</a><td> * Gets a unique ID for an object. This mutates the object so that further<tr><td><a name="l954" href="#l954">954</a><td> * calls with the same object as a parameter returns the same value. The unique<tr><td><a name="l955" href="#l955">955</a><td> * ID is guaranteed to be unique across the current session amongst objects that<tr><td><a name="l956" href="#l956">956</a><td> * are passed into {@code getUid}. There is no guarantee that the ID is unique<tr><td><a name="l957" href="#l957">957</a><td> * or consistent across sessions. It is unsafe to generate unique ID for<tr><td><a name="l958" href="#l958">958</a><td> * function prototypes.<tr><td><a name="l959" href="#l959">959</a><td> *<tr><td><a name="l960" href="#l960">960</a><td> * @param {Object} obj The object to get the unique ID for.<tr><td><a name="l961" href="#l961">961</a><td> * @return {number} The unique ID for the object.<tr><td><a name="l962" href="#l962">962</a><td> */<tr><td><a name="l963" href="#l963">963</a><td>goog.getUid = function(obj) {<tr><td><a name="l964" href="#l964">964</a><td>  // TODO(arv): Make the type stricter, do not accept null.<tr><td><a name="l965" href="#l965">965</a><td><tr><td><a name="l966" href="#l966">966</a><td>  // In Opera window.hasOwnProperty exists but always returns false so we avoid<tr><td><a name="l967" href="#l967">967</a><td>  // using it. As a consequence the unique ID generated for BaseClass.prototype<tr><td><a name="l968" href="#l968">968</a><td>  // and SubClass.prototype will be the same.<tr><td><a name="l969" href="#l969">969</a><td>  return obj[goog.UID_PROPERTY_] ||<tr><td><a name="l970" href="#l970">970</a><td>      (obj[goog.UID_PROPERTY_] = ++goog.uidCounter_);<tr><td><a name="l971" href="#l971">971</a><td>};<tr><td><a name="l972" href="#l972">972</a><td><tr><td><a name="l973" href="#l973">973</a><td><tr><td><a name="l974" href="#l974">974</a><td>/**<tr><td><a name="l975" href="#l975">975</a><td> * Removes the unique ID from an object. This is useful if the object was<tr><td><a name="l976" href="#l976">976</a><td> * previously mutated using {@code goog.getUid} in which case the mutation is<tr><td><a name="l977" href="#l977">977</a><td> * undone.<tr><td><a name="l978" href="#l978">978</a><td> * @param {Object} obj The object to remove the unique ID field from.<tr><td><a name="l979" href="#l979">979</a><td> */<tr><td><a name="l980" href="#l980">980</a><td>goog.removeUid = function(obj) {<tr><td><a name="l981" href="#l981">981</a><td>  // TODO(arv): Make the type stricter, do not accept null.<tr><td><a name="l982" href="#l982">982</a><td><tr><td><a name="l983" href="#l983">983</a><td>  // DOM nodes in IE are not instance of Object and throws exception<tr><td><a name="l984" href="#l984">984</a><td>  // for delete. Instead we try to use removeAttribute<tr><td><a name="l985" href="#l985">985</a><td>  if (&#39;removeAttribute&#39; in obj) {<tr><td><a name="l986" href="#l986">986</a><td>    obj.removeAttribute(goog.UID_PROPERTY_);<tr><td><a name="l987" href="#l987">987</a><td>  }<tr><td><a name="l988" href="#l988">988</a><td>  /** @preserveTry */<tr><td><a name="l989" href="#l989">989</a><td>  try {<tr><td><a name="l990" href="#l990">990</a><td>    delete obj[goog.UID_PROPERTY_];<tr><td><a name="l991" href="#l991">991</a><td>  } catch (ex) {<tr><td><a name="l992" href="#l992">992</a><td>  }<tr><td><a name="l993" href="#l993">993</a><td>};<tr><td><a name="l994" href="#l994">994</a><td><tr><td><a name="l995" href="#l995">995</a><td><tr><td><a name="l996" href="#l996">996</a><td>/**<tr><td><a name="l997" href="#l997">997</a><td> * Name for unique ID property. Initialized in a way to help avoid collisions<tr><td><a name="l998" href="#l998">998</a><td> * with other closure javascript on the same page.<tr><td><a name="l999" href="#l999">999</a><td> * @type {string}<tr><td><a name="l1000" href="#l1000">1000</a><td> * @private<tr><td><a name="l1001" href="#l1001">1001</a><td> */<tr><td><a name="l1002" href="#l1002">1002</a><td>goog.UID_PROPERTY_ = &#39;closure_uid_&#39; + ((Math.random() * 1e9) &gt;&gt;&gt; 0);<tr><td><a name="l1003" href="#l1003">1003</a><td><tr><td><a name="l1004" href="#l1004">1004</a><td><tr><td><a name="l1005" href="#l1005">1005</a><td>/**<tr><td><a name="l1006" href="#l1006">1006</a><td> * Counter for UID.<tr><td><a name="l1007" href="#l1007">1007</a><td> * @type {number}<tr><td><a name="l1008" href="#l1008">1008</a><td> * @private<tr><td><a name="l1009" href="#l1009">1009</a><td> */<tr><td><a name="l1010" href="#l1010">1010</a><td>goog.uidCounter_ = 0;<tr><td><a name="l1011" href="#l1011">1011</a><td><tr><td><a name="l1012" href="#l1012">1012</a><td><tr><td><a name="l1013" href="#l1013">1013</a><td>/**<tr><td><a name="l1014" href="#l1014">1014</a><td> * Adds a hash code field to an object. The hash code is unique for the<tr><td><a name="l1015" href="#l1015">1015</a><td> * given object.<tr><td><a name="l1016" href="#l1016">1016</a><td> * @param {Object} obj The object to get the hash code for.<tr><td><a name="l1017" href="#l1017">1017</a><td> * @return {number} The hash code for the object.<tr><td><a name="l1018" href="#l1018">1018</a><td> * @deprecated Use goog.getUid instead.<tr><td><a name="l1019" href="#l1019">1019</a><td> */<tr><td><a name="l1020" href="#l1020">1020</a><td>goog.getHashCode = goog.getUid;<tr><td><a name="l1021" href="#l1021">1021</a><td><tr><td><a name="l1022" href="#l1022">1022</a><td><tr><td><a name="l1023" href="#l1023">1023</a><td>/**<tr><td><a name="l1024" href="#l1024">1024</a><td> * Removes the hash code field from an object.<tr><td><a name="l1025" href="#l1025">1025</a><td> * @param {Object} obj The object to remove the field from.<tr><td><a name="l1026" href="#l1026">1026</a><td> * @deprecated Use goog.removeUid instead.<tr><td><a name="l1027" href="#l1027">1027</a><td> */<tr><td><a name="l1028" href="#l1028">1028</a><td>goog.removeHashCode = goog.removeUid;<tr><td><a name="l1029" href="#l1029">1029</a><td><tr><td><a name="l1030" href="#l1030">1030</a><td><tr><td><a name="l1031" href="#l1031">1031</a><td>/**<tr><td><a name="l1032" href="#l1032">1032</a><td> * Clones a value. The input may be an Object, Array, or basic type. Objects and<tr><td><a name="l1033" href="#l1033">1033</a><td> * arrays will be cloned recursively.<tr><td><a name="l1034" href="#l1034">1034</a><td> *<tr><td><a name="l1035" href="#l1035">1035</a><td> * WARNINGS:<tr><td><a name="l1036" href="#l1036">1036</a><td> * &lt;code&gt;goog.cloneObject&lt;/code&gt; does not detect reference loops. Objects that<tr><td><a name="l1037" href="#l1037">1037</a><td> * refer to themselves will cause infinite recursion.<tr><td><a name="l1038" href="#l1038">1038</a><td> *<tr><td><a name="l1039" href="#l1039">1039</a><td> * &lt;code&gt;goog.cloneObject&lt;/code&gt; is unaware of unique identifiers, and copies<tr><td><a name="l1040" href="#l1040">1040</a><td> * UIDs created by &lt;code&gt;getUid&lt;/code&gt; into cloned results.<tr><td><a name="l1041" href="#l1041">1041</a><td> *<tr><td><a name="l1042" href="#l1042">1042</a><td> * @param {*} obj The value to clone.<tr><td><a name="l1043" href="#l1043">1043</a><td> * @return {*} A clone of the input value.<tr><td><a name="l1044" href="#l1044">1044</a><td> * @deprecated goog.cloneObject is unsafe. Prefer the goog.object methods.<tr><td><a name="l1045" href="#l1045">1045</a><td> */<tr><td><a name="l1046" href="#l1046">1046</a><td>goog.cloneObject = function(obj) {<tr><td><a name="l1047" href="#l1047">1047</a><td>  var type = goog.typeOf(obj);<tr><td><a name="l1048" href="#l1048">1048</a><td>  if (type == &#39;object&#39; || type == &#39;array&#39;) {<tr><td><a name="l1049" href="#l1049">1049</a><td>    if (obj.clone) {<tr><td><a name="l1050" href="#l1050">1050</a><td>      return obj.clone();<tr><td><a name="l1051" href="#l1051">1051</a><td>    }<tr><td><a name="l1052" href="#l1052">1052</a><td>    var clone = type == &#39;array&#39; ? [] : {};<tr><td><a name="l1053" href="#l1053">1053</a><td>    for (var key in obj) {<tr><td><a name="l1054" href="#l1054">1054</a><td>      clone[key] = goog.cloneObject(obj[key]);<tr><td><a name="l1055" href="#l1055">1055</a><td>    }<tr><td><a name="l1056" href="#l1056">1056</a><td>    return clone;<tr><td><a name="l1057" href="#l1057">1057</a><td>  }<tr><td><a name="l1058" href="#l1058">1058</a><td><tr><td><a name="l1059" href="#l1059">1059</a><td>  return obj;<tr><td><a name="l1060" href="#l1060">1060</a><td>};<tr><td><a name="l1061" href="#l1061">1061</a><td><tr><td><a name="l1062" href="#l1062">1062</a><td><tr><td><a name="l1063" href="#l1063">1063</a><td>/**<tr><td><a name="l1064" href="#l1064">1064</a><td> * A native implementation of goog.bind.<tr><td><a name="l1065" href="#l1065">1065</a><td> * @param {Function} fn A function to partially apply.<tr><td><a name="l1066" href="#l1066">1066</a><td> * @param {Object|undefined} selfObj Specifies the object which |this| should<tr><td><a name="l1067" href="#l1067">1067</a><td> *     point to when the function is run.<tr><td><a name="l1068" href="#l1068">1068</a><td> * @param {...*} var_args Additional arguments that are partially<tr><td><a name="l1069" href="#l1069">1069</a><td> *     applied to the function.<tr><td><a name="l1070" href="#l1070">1070</a><td> * @return {!Function} A partially-applied form of the function bind() was<tr><td><a name="l1071" href="#l1071">1071</a><td> *     invoked as a method of.<tr><td><a name="l1072" href="#l1072">1072</a><td> * @private<tr><td><a name="l1073" href="#l1073">1073</a><td> * @suppress {deprecated} The compiler thinks that Function.prototype.bind<tr><td><a name="l1074" href="#l1074">1074</a><td> *     is deprecated because some people have declared a pure-JS version.<tr><td><a name="l1075" href="#l1075">1075</a><td> *     Only the pure-JS version is truly deprecated.<tr><td><a name="l1076" href="#l1076">1076</a><td> */<tr><td><a name="l1077" href="#l1077">1077</a><td>goog.bindNative_ = function(fn, selfObj, var_args) {<tr><td><a name="l1078" href="#l1078">1078</a><td>  return /** @type {!Function} */ (fn.call.apply(fn.bind, arguments));<tr><td><a name="l1079" href="#l1079">1079</a><td>};<tr><td><a name="l1080" href="#l1080">1080</a><td><tr><td><a name="l1081" href="#l1081">1081</a><td><tr><td><a name="l1082" href="#l1082">1082</a><td>/**<tr><td><a name="l1083" href="#l1083">1083</a><td> * A pure-JS implementation of goog.bind.<tr><td><a name="l1084" href="#l1084">1084</a><td> * @param {Function} fn A function to partially apply.<tr><td><a name="l1085" href="#l1085">1085</a><td> * @param {Object|undefined} selfObj Specifies the object which |this| should<tr><td><a name="l1086" href="#l1086">1086</a><td> *     point to when the function is run.<tr><td><a name="l1087" href="#l1087">1087</a><td> * @param {...*} var_args Additional arguments that are partially<tr><td><a name="l1088" href="#l1088">1088</a><td> *     applied to the function.<tr><td><a name="l1089" href="#l1089">1089</a><td> * @return {!Function} A partially-applied form of the function bind() was<tr><td><a name="l1090" href="#l1090">1090</a><td> *     invoked as a method of.<tr><td><a name="l1091" href="#l1091">1091</a><td> * @private<tr><td><a name="l1092" href="#l1092">1092</a><td> */<tr><td><a name="l1093" href="#l1093">1093</a><td>goog.bindJs_ = function(fn, selfObj, var_args) {<tr><td><a name="l1094" href="#l1094">1094</a><td>  if (!fn) {<tr><td><a name="l1095" href="#l1095">1095</a><td>    throw new Error();<tr><td><a name="l1096" href="#l1096">1096</a><td>  }<tr><td><a name="l1097" href="#l1097">1097</a><td><tr><td><a name="l1098" href="#l1098">1098</a><td>  if (arguments.length &gt; 2) {<tr><td><a name="l1099" href="#l1099">1099</a><td>    var boundArgs = Array.prototype.slice.call(arguments, 2);<tr><td><a name="l1100" href="#l1100">1100</a><td>    return function() {<tr><td><a name="l1101" href="#l1101">1101</a><td>      // Prepend the bound arguments to the current arguments.<tr><td><a name="l1102" href="#l1102">1102</a><td>      var newArgs = Array.prototype.slice.call(arguments);<tr><td><a name="l1103" href="#l1103">1103</a><td>      Array.prototype.unshift.apply(newArgs, boundArgs);<tr><td><a name="l1104" href="#l1104">1104</a><td>      return fn.apply(selfObj, newArgs);<tr><td><a name="l1105" href="#l1105">1105</a><td>    };<tr><td><a name="l1106" href="#l1106">1106</a><td><tr><td><a name="l1107" href="#l1107">1107</a><td>  } else {<tr><td><a name="l1108" href="#l1108">1108</a><td>    return function() {<tr><td><a name="l1109" href="#l1109">1109</a><td>      return fn.apply(selfObj, arguments);<tr><td><a name="l1110" href="#l1110">1110</a><td>    };<tr><td><a name="l1111" href="#l1111">1111</a><td>  }<tr><td><a name="l1112" href="#l1112">1112</a><td>};<tr><td><a name="l1113" href="#l1113">1113</a><td><tr><td><a name="l1114" href="#l1114">1114</a><td><tr><td><a name="l1115" href="#l1115">1115</a><td>/**<tr><td><a name="l1116" href="#l1116">1116</a><td> * Partially applies this function to a particular &#39;this object&#39; and zero or<tr><td><a name="l1117" href="#l1117">1117</a><td> * more arguments. The result is a new function with some arguments of the first<tr><td><a name="l1118" href="#l1118">1118</a><td> * function pre-filled and the value of |this| &#39;pre-specified&#39;.&lt;br&gt;&lt;br&gt;<tr><td><a name="l1119" href="#l1119">1119</a><td> *<tr><td><a name="l1120" href="#l1120">1120</a><td> * Remaining arguments specified at call-time are appended to the pre-<tr><td><a name="l1121" href="#l1121">1121</a><td> * specified ones.&lt;br&gt;&lt;br&gt;<tr><td><a name="l1122" href="#l1122">1122</a><td> *<tr><td><a name="l1123" href="#l1123">1123</a><td> * Also see: {@link #partial}.&lt;br&gt;&lt;br&gt;<tr><td><a name="l1124" href="#l1124">1124</a><td> *<tr><td><a name="l1125" href="#l1125">1125</a><td> * Usage:<tr><td><a name="l1126" href="#l1126">1126</a><td> * &lt;pre&gt;var barMethBound = bind(myFunction, myObj, &#39;arg1&#39;, &#39;arg2&#39;);<tr><td><a name="l1127" href="#l1127">1127</a><td> * barMethBound(&#39;arg3&#39;, &#39;arg4&#39;);&lt;/pre&gt;<tr><td><a name="l1128" href="#l1128">1128</a><td> *<tr><td><a name="l1129" href="#l1129">1129</a><td> * @param {?function(this:T, ...)} fn A function to partially apply.<tr><td><a name="l1130" href="#l1130">1130</a><td> * @param {T} selfObj Specifies the object which |this| should<tr><td><a name="l1131" href="#l1131">1131</a><td> *     point to when the function is run.<tr><td><a name="l1132" href="#l1132">1132</a><td> * @param {...*} var_args Additional arguments that are partially<tr><td><a name="l1133" href="#l1133">1133</a><td> *     applied to the function.<tr><td><a name="l1134" href="#l1134">1134</a><td> * @return {!Function} A partially-applied form of the function bind() was<tr><td><a name="l1135" href="#l1135">1135</a><td> *     invoked as a method of.<tr><td><a name="l1136" href="#l1136">1136</a><td> * @template T<tr><td><a name="l1137" href="#l1137">1137</a><td> * @suppress {deprecated} See above.<tr><td><a name="l1138" href="#l1138">1138</a><td> */<tr><td><a name="l1139" href="#l1139">1139</a><td>goog.bind = function(fn, selfObj, var_args) {<tr><td><a name="l1140" href="#l1140">1140</a><td>  // TODO(nicksantos): narrow the type signature.<tr><td><a name="l1141" href="#l1141">1141</a><td>  if (Function.prototype.bind &amp;&amp;<tr><td><a name="l1142" href="#l1142">1142</a><td>      // NOTE(nicksantos): Somebody pulled base.js into the default<tr><td><a name="l1143" href="#l1143">1143</a><td>      // Chrome extension environment. This means that for Chrome extensions,<tr><td><a name="l1144" href="#l1144">1144</a><td>      // they get the implementation of Function.prototype.bind that<tr><td><a name="l1145" href="#l1145">1145</a><td>      // calls goog.bind instead of the native one. Even worse, we don&#39;t want<tr><td><a name="l1146" href="#l1146">1146</a><td>      // to introduce a circular dependency between goog.bind and<tr><td><a name="l1147" href="#l1147">1147</a><td>      // Function.prototype.bind, so we have to hack this to make sure it<tr><td><a name="l1148" href="#l1148">1148</a><td>      // works correctly.<tr><td><a name="l1149" href="#l1149">1149</a><td>      Function.prototype.bind.toString().indexOf(&#39;native code&#39;) != -1) {<tr><td><a name="l1150" href="#l1150">1150</a><td>    goog.bind = goog.bindNative_;<tr><td><a name="l1151" href="#l1151">1151</a><td>  } else {<tr><td><a name="l1152" href="#l1152">1152</a><td>    goog.bind = goog.bindJs_;<tr><td><a name="l1153" href="#l1153">1153</a><td>  }<tr><td><a name="l1154" href="#l1154">1154</a><td>  return goog.bind.apply(null, arguments);<tr><td><a name="l1155" href="#l1155">1155</a><td>};<tr><td><a name="l1156" href="#l1156">1156</a><td><tr><td><a name="l1157" href="#l1157">1157</a><td><tr><td><a name="l1158" href="#l1158">1158</a><td>/**<tr><td><a name="l1159" href="#l1159">1159</a><td> * Like bind(), except that a &#39;this object&#39; is not required. Useful when the<tr><td><a name="l1160" href="#l1160">1160</a><td> * target function is already bound.<tr><td><a name="l1161" href="#l1161">1161</a><td> *<tr><td><a name="l1162" href="#l1162">1162</a><td> * Usage:<tr><td><a name="l1163" href="#l1163">1163</a><td> * var g = partial(f, arg1, arg2);<tr><td><a name="l1164" href="#l1164">1164</a><td> * g(arg3, arg4);<tr><td><a name="l1165" href="#l1165">1165</a><td> *<tr><td><a name="l1166" href="#l1166">1166</a><td> * @param {Function} fn A function to partially apply.<tr><td><a name="l1167" href="#l1167">1167</a><td> * @param {...*} var_args Additional arguments that are partially<tr><td><a name="l1168" href="#l1168">1168</a><td> *     applied to fn.<tr><td><a name="l1169" href="#l1169">1169</a><td> * @return {!Function} A partially-applied form of the function bind() was<tr><td><a name="l1170" href="#l1170">1170</a><td> *     invoked as a method of.<tr><td><a name="l1171" href="#l1171">1171</a><td> */<tr><td><a name="l1172" href="#l1172">1172</a><td>goog.partial = function(fn, var_args) {<tr><td><a name="l1173" href="#l1173">1173</a><td>  var args = Array.prototype.slice.call(arguments, 1);<tr><td><a name="l1174" href="#l1174">1174</a><td>  return function() {<tr><td><a name="l1175" href="#l1175">1175</a><td>    // Prepend the bound arguments to the current arguments.<tr><td><a name="l1176" href="#l1176">1176</a><td>    var newArgs = Array.prototype.slice.call(arguments);<tr><td><a name="l1177" href="#l1177">1177</a><td>    newArgs.unshift.apply(newArgs, args);<tr><td><a name="l1178" href="#l1178">1178</a><td>    return fn.apply(this, newArgs);<tr><td><a name="l1179" href="#l1179">1179</a><td>  };<tr><td><a name="l1180" href="#l1180">1180</a><td>};<tr><td><a name="l1181" href="#l1181">1181</a><td><tr><td><a name="l1182" href="#l1182">1182</a><td><tr><td><a name="l1183" href="#l1183">1183</a><td>/**<tr><td><a name="l1184" href="#l1184">1184</a><td> * Copies all the members of a source object to a target object. This method<tr><td><a name="l1185" href="#l1185">1185</a><td> * does not work on all browsers for all objects that contain keys such as<tr><td><a name="l1186" href="#l1186">1186</a><td> * toString or hasOwnProperty. Use goog.object.extend for this purpose.<tr><td><a name="l1187" href="#l1187">1187</a><td> * @param {Object} target Target.<tr><td><a name="l1188" href="#l1188">1188</a><td> * @param {Object} source Source.<tr><td><a name="l1189" href="#l1189">1189</a><td> */<tr><td><a name="l1190" href="#l1190">1190</a><td>goog.mixin = function(target, source) {<tr><td><a name="l1191" href="#l1191">1191</a><td>  for (var x in source) {<tr><td><a name="l1192" href="#l1192">1192</a><td>    target[x] = source[x];<tr><td><a name="l1193" href="#l1193">1193</a><td>  }<tr><td><a name="l1194" href="#l1194">1194</a><td><tr><td><a name="l1195" href="#l1195">1195</a><td>  // For IE7 or lower, the for-in-loop does not contain any properties that are<tr><td><a name="l1196" href="#l1196">1196</a><td>  // not enumerable on the prototype object (for example, isPrototypeOf from<tr><td><a name="l1197" href="#l1197">1197</a><td>  // Object.prototype) but also it will not include &#39;replace&#39; on objects that<tr><td><a name="l1198" href="#l1198">1198</a><td>  // extend String and change &#39;replace&#39; (not that it is common for anyone to<tr><td><a name="l1199" href="#l1199">1199</a><td>  // extend anything except Object).<tr><td><a name="l1200" href="#l1200">1200</a><td>};<tr><td><a name="l1201" href="#l1201">1201</a><td><tr><td><a name="l1202" href="#l1202">1202</a><td><tr><td><a name="l1203" href="#l1203">1203</a><td>/**<tr><td><a name="l1204" href="#l1204">1204</a><td> * @return {number} An integer value representing the number of milliseconds<tr><td><a name="l1205" href="#l1205">1205</a><td> *     between midnight, January 1, 1970 and the current time.<tr><td><a name="l1206" href="#l1206">1206</a><td> */<tr><td><a name="l1207" href="#l1207">1207</a><td>goog.now = (goog.TRUSTED_SITE &amp;&amp; Date.now) || (function() {<tr><td><a name="l1208" href="#l1208">1208</a><td>  // Unary plus operator converts its operand to a number which in the case of<tr><td><a name="l1209" href="#l1209">1209</a><td>  // a date is done by calling getTime().<tr><td><a name="l1210" href="#l1210">1210</a><td>  return +new Date();<tr><td><a name="l1211" href="#l1211">1211</a><td>});<tr><td><a name="l1212" href="#l1212">1212</a><td><tr><td><a name="l1213" href="#l1213">1213</a><td><tr><td><a name="l1214" href="#l1214">1214</a><td>/**<tr><td><a name="l1215" href="#l1215">1215</a><td> * Evals javascript in the global scope.  In IE this uses execScript, other<tr><td><a name="l1216" href="#l1216">1216</a><td> * browsers use goog.global.eval. If goog.global.eval does not evaluate in the<tr><td><a name="l1217" href="#l1217">1217</a><td> * global scope (for example, in Safari), appends a script tag instead.<tr><td><a name="l1218" href="#l1218">1218</a><td> * Throws an exception if neither execScript or eval is defined.<tr><td><a name="l1219" href="#l1219">1219</a><td> * @param {string} script JavaScript string.<tr><td><a name="l1220" href="#l1220">1220</a><td> */<tr><td><a name="l1221" href="#l1221">1221</a><td>goog.globalEval = function(script) {<tr><td><a name="l1222" href="#l1222">1222</a><td>  if (goog.global.execScript) {<tr><td><a name="l1223" href="#l1223">1223</a><td>    goog.global.execScript(script, &#39;JavaScript&#39;);<tr><td><a name="l1224" href="#l1224">1224</a><td>  } else if (goog.global.eval) {<tr><td><a name="l1225" href="#l1225">1225</a><td>    // Test to see if eval works<tr><td><a name="l1226" href="#l1226">1226</a><td>    if (goog.evalWorksForGlobals_ == null) {<tr><td><a name="l1227" href="#l1227">1227</a><td>      goog.global.eval(&#39;var _et_ = 1;&#39;);<tr><td><a name="l1228" href="#l1228">1228</a><td>      if (typeof goog.global[&#39;_et_&#39;] != &#39;undefined&#39;) {<tr><td><a name="l1229" href="#l1229">1229</a><td>        delete goog.global[&#39;_et_&#39;];<tr><td><a name="l1230" href="#l1230">1230</a><td>        goog.evalWorksForGlobals_ = true;<tr><td><a name="l1231" href="#l1231">1231</a><td>      } else {<tr><td><a name="l1232" href="#l1232">1232</a><td>        goog.evalWorksForGlobals_ = false;<tr><td><a name="l1233" href="#l1233">1233</a><td>      }<tr><td><a name="l1234" href="#l1234">1234</a><td>    }<tr><td><a name="l1235" href="#l1235">1235</a><td><tr><td><a name="l1236" href="#l1236">1236</a><td>    if (goog.evalWorksForGlobals_) {<tr><td><a name="l1237" href="#l1237">1237</a><td>      goog.global.eval(script);<tr><td><a name="l1238" href="#l1238">1238</a><td>    } else {<tr><td><a name="l1239" href="#l1239">1239</a><td>      var doc = goog.global.document;<tr><td><a name="l1240" href="#l1240">1240</a><td>      var scriptElt = doc.createElement(&#39;script&#39;);<tr><td><a name="l1241" href="#l1241">1241</a><td>      scriptElt.type = &#39;text/javascript&#39;;<tr><td><a name="l1242" href="#l1242">1242</a><td>      scriptElt.defer = false;<tr><td><a name="l1243" href="#l1243">1243</a><td>      // Note(user): can&#39;t use .innerHTML since &quot;t(&#39;&lt;test&gt;&#39;)&quot; will fail and<tr><td><a name="l1244" href="#l1244">1244</a><td>      // .text doesn&#39;t work in Safari 2.  Therefore we append a text node.<tr><td><a name="l1245" href="#l1245">1245</a><td>      scriptElt.appendChild(doc.createTextNode(script));<tr><td><a name="l1246" href="#l1246">1246</a><td>      doc.body.appendChild(scriptElt);<tr><td><a name="l1247" href="#l1247">1247</a><td>      doc.body.removeChild(scriptElt);<tr><td><a name="l1248" href="#l1248">1248</a><td>    }<tr><td><a name="l1249" href="#l1249">1249</a><td>  } else {<tr><td><a name="l1250" href="#l1250">1250</a><td>    throw Error(&#39;goog.globalEval not available&#39;);<tr><td><a name="l1251" href="#l1251">1251</a><td>  }<tr><td><a name="l1252" href="#l1252">1252</a><td>};<tr><td><a name="l1253" href="#l1253">1253</a><td><tr><td><a name="l1254" href="#l1254">1254</a><td><tr><td><a name="l1255" href="#l1255">1255</a><td>/**<tr><td><a name="l1256" href="#l1256">1256</a><td> * Indicates whether or not we can call &#39;eval&#39; directly to eval code in the<tr><td><a name="l1257" href="#l1257">1257</a><td> * global scope. Set to a Boolean by the first call to goog.globalEval (which<tr><td><a name="l1258" href="#l1258">1258</a><td> * empirically tests whether eval works for globals). @see goog.globalEval<tr><td><a name="l1259" href="#l1259">1259</a><td> * @type {?boolean}<tr><td><a name="l1260" href="#l1260">1260</a><td> * @private<tr><td><a name="l1261" href="#l1261">1261</a><td> */<tr><td><a name="l1262" href="#l1262">1262</a><td>goog.evalWorksForGlobals_ = null;<tr><td><a name="l1263" href="#l1263">1263</a><td><tr><td><a name="l1264" href="#l1264">1264</a><td><tr><td><a name="l1265" href="#l1265">1265</a><td>/**<tr><td><a name="l1266" href="#l1266">1266</a><td> * Optional map of CSS class names to obfuscated names used with<tr><td><a name="l1267" href="#l1267">1267</a><td> * goog.getCssName().<tr><td><a name="l1268" href="#l1268">1268</a><td> * @type {Object|undefined}<tr><td><a name="l1269" href="#l1269">1269</a><td> * @private<tr><td><a name="l1270" href="#l1270">1270</a><td> * @see goog.setCssNameMapping<tr><td><a name="l1271" href="#l1271">1271</a><td> */<tr><td><a name="l1272" href="#l1272">1272</a><td>goog.cssNameMapping_;<tr><td><a name="l1273" href="#l1273">1273</a><td><tr><td><a name="l1274" href="#l1274">1274</a><td><tr><td><a name="l1275" href="#l1275">1275</a><td>/**<tr><td><a name="l1276" href="#l1276">1276</a><td> * Optional obfuscation style for CSS class names. Should be set to either<tr><td><a name="l1277" href="#l1277">1277</a><td> * &#39;BY_WHOLE&#39; or &#39;BY_PART&#39; if defined.<tr><td><a name="l1278" href="#l1278">1278</a><td> * @type {string|undefined}<tr><td><a name="l1279" href="#l1279">1279</a><td> * @private<tr><td><a name="l1280" href="#l1280">1280</a><td> * @see goog.setCssNameMapping<tr><td><a name="l1281" href="#l1281">1281</a><td> */<tr><td><a name="l1282" href="#l1282">1282</a><td>goog.cssNameMappingStyle_;<tr><td><a name="l1283" href="#l1283">1283</a><td><tr><td><a name="l1284" href="#l1284">1284</a><td><tr><td><a name="l1285" href="#l1285">1285</a><td>/**<tr><td><a name="l1286" href="#l1286">1286</a><td> * Handles strings that are intended to be used as CSS class names.<tr><td><a name="l1287" href="#l1287">1287</a><td> *<tr><td><a name="l1288" href="#l1288">1288</a><td> * This function works in tandem with @see goog.setCssNameMapping.<tr><td><a name="l1289" href="#l1289">1289</a><td> *<tr><td><a name="l1290" href="#l1290">1290</a><td> * Without any mapping set, the arguments are simple joined with a<tr><td><a name="l1291" href="#l1291">1291</a><td> * hyphen and passed through unaltered.<tr><td><a name="l1292" href="#l1292">1292</a><td> *<tr><td><a name="l1293" href="#l1293">1293</a><td> * When there is a mapping, there are two possible styles in which<tr><td><a name="l1294" href="#l1294">1294</a><td> * these mappings are used. In the BY_PART style, each part (i.e. in<tr><td><a name="l1295" href="#l1295">1295</a><td> * between hyphens) of the passed in css name is rewritten according<tr><td><a name="l1296" href="#l1296">1296</a><td> * to the map. In the BY_WHOLE style, the full css name is looked up in<tr><td><a name="l1297" href="#l1297">1297</a><td> * the map directly. If a rewrite is not specified by the map, the<tr><td><a name="l1298" href="#l1298">1298</a><td> * compiler will output a warning.<tr><td><a name="l1299" href="#l1299">1299</a><td> *<tr><td><a name="l1300" href="#l1300">1300</a><td> * When the mapping is passed to the compiler, it will replace calls<tr><td><a name="l1301" href="#l1301">1301</a><td> * to goog.getCssName with the strings from the mapping, e.g.<tr><td><a name="l1302" href="#l1302">1302</a><td> *     var x = goog.getCssName(&#39;foo&#39;);<tr><td><a name="l1303" href="#l1303">1303</a><td> *     var y = goog.getCssName(this.baseClass, &#39;active&#39;);<tr><td><a name="l1304" href="#l1304">1304</a><td> *  becomes:<tr><td><a name="l1305" href="#l1305">1305</a><td> *     var x= &#39;foo&#39;;<tr><td><a name="l1306" href="#l1306">1306</a><td> *     var y = this.baseClass + &#39;-active&#39;;<tr><td><a name="l1307" href="#l1307">1307</a><td> *<tr><td><a name="l1308" href="#l1308">1308</a><td> * If one argument is passed it will be processed, if two are passed<tr><td><a name="l1309" href="#l1309">1309</a><td> * only the modifier will be processed, as it is assumed the first<tr><td><a name="l1310" href="#l1310">1310</a><td> * argument was generated as a result of calling goog.getCssName.<tr><td><a name="l1311" href="#l1311">1311</a><td> *<tr><td><a name="l1312" href="#l1312">1312</a><td> * @param {string} className The class name.<tr><td><a name="l1313" href="#l1313">1313</a><td> * @param {string=} opt_modifier A modifier to be appended to the class name.<tr><td><a name="l1314" href="#l1314">1314</a><td> * @return {string} The class name or the concatenation of the class name and<tr><td><a name="l1315" href="#l1315">1315</a><td> *     the modifier.<tr><td><a name="l1316" href="#l1316">1316</a><td> */<tr><td><a name="l1317" href="#l1317">1317</a><td>goog.getCssName = function(className, opt_modifier) {<tr><td><a name="l1318" href="#l1318">1318</a><td>  var getMapping = function(cssName) {<tr><td><a name="l1319" href="#l1319">1319</a><td>    return goog.cssNameMapping_[cssName] || cssName;<tr><td><a name="l1320" href="#l1320">1320</a><td>  };<tr><td><a name="l1321" href="#l1321">1321</a><td><tr><td><a name="l1322" href="#l1322">1322</a><td>  var renameByParts = function(cssName) {<tr><td><a name="l1323" href="#l1323">1323</a><td>    // Remap all the parts individually.<tr><td><a name="l1324" href="#l1324">1324</a><td>    var parts = cssName.split(&#39;-&#39;);<tr><td><a name="l1325" href="#l1325">1325</a><td>    var mapped = [];<tr><td><a name="l1326" href="#l1326">1326</a><td>    for (var i = 0; i &lt; parts.length; i++) {<tr><td><a name="l1327" href="#l1327">1327</a><td>      mapped.push(getMapping(parts[i]));<tr><td><a name="l1328" href="#l1328">1328</a><td>    }<tr><td><a name="l1329" href="#l1329">1329</a><td>    return mapped.join(&#39;-&#39;);<tr><td><a name="l1330" href="#l1330">1330</a><td>  };<tr><td><a name="l1331" href="#l1331">1331</a><td><tr><td><a name="l1332" href="#l1332">1332</a><td>  var rename;<tr><td><a name="l1333" href="#l1333">1333</a><td>  if (goog.cssNameMapping_) {<tr><td><a name="l1334" href="#l1334">1334</a><td>    rename = goog.cssNameMappingStyle_ == &#39;BY_WHOLE&#39; ?<tr><td><a name="l1335" href="#l1335">1335</a><td>        getMapping : renameByParts;<tr><td><a name="l1336" href="#l1336">1336</a><td>  } else {<tr><td><a name="l1337" href="#l1337">1337</a><td>    rename = function(a) {<tr><td><a name="l1338" href="#l1338">1338</a><td>      return a;<tr><td><a name="l1339" href="#l1339">1339</a><td>    };<tr><td><a name="l1340" href="#l1340">1340</a><td>  }<tr><td><a name="l1341" href="#l1341">1341</a><td><tr><td><a name="l1342" href="#l1342">1342</a><td>  if (opt_modifier) {<tr><td><a name="l1343" href="#l1343">1343</a><td>    return className + &#39;-&#39; + rename(opt_modifier);<tr><td><a name="l1344" href="#l1344">1344</a><td>  } else {<tr><td><a name="l1345" href="#l1345">1345</a><td>    return rename(className);<tr><td><a name="l1346" href="#l1346">1346</a><td>  }<tr><td><a name="l1347" href="#l1347">1347</a><td>};<tr><td><a name="l1348" href="#l1348">1348</a><td><tr><td><a name="l1349" href="#l1349">1349</a><td><tr><td><a name="l1350" href="#l1350">1350</a><td>/**<tr><td><a name="l1351" href="#l1351">1351</a><td> * Sets the map to check when returning a value from goog.getCssName(). Example:<tr><td><a name="l1352" href="#l1352">1352</a><td> * &lt;pre&gt;<tr><td><a name="l1353" href="#l1353">1353</a><td> * goog.setCssNameMapping({<tr><td><a name="l1354" href="#l1354">1354</a><td> *   &quot;goog&quot;: &quot;a&quot;,<tr><td><a name="l1355" href="#l1355">1355</a><td> *   &quot;disabled&quot;: &quot;b&quot;,<tr><td><a name="l1356" href="#l1356">1356</a><td> * });<tr><td><a name="l1357" href="#l1357">1357</a><td> *<tr><td><a name="l1358" href="#l1358">1358</a><td> * var x = goog.getCssName(&#39;goog&#39;);<tr><td><a name="l1359" href="#l1359">1359</a><td> * // The following evaluates to: &quot;a a-b&quot;.<tr><td><a name="l1360" href="#l1360">1360</a><td> * goog.getCssName(&#39;goog&#39;) + &#39; &#39; + goog.getCssName(x, &#39;disabled&#39;)<tr><td><a name="l1361" href="#l1361">1361</a><td> * &lt;/pre&gt;<tr><td><a name="l1362" href="#l1362">1362</a><td> * When declared as a map of string literals to string literals, the JSCompiler<tr><td><a name="l1363" href="#l1363">1363</a><td> * will replace all calls to goog.getCssName() using the supplied map if the<tr><td><a name="l1364" href="#l1364">1364</a><td> * --closure_pass flag is set.<tr><td><a name="l1365" href="#l1365">1365</a><td> *<tr><td><a name="l1366" href="#l1366">1366</a><td> * @param {!Object} mapping A map of strings to strings where keys are possible<tr><td><a name="l1367" href="#l1367">1367</a><td> *     arguments to goog.getCssName() and values are the corresponding values<tr><td><a name="l1368" href="#l1368">1368</a><td> *     that should be returned.<tr><td><a name="l1369" href="#l1369">1369</a><td> * @param {string=} opt_style The style of css name mapping. There are two valid<tr><td><a name="l1370" href="#l1370">1370</a><td> *     options: &#39;BY_PART&#39;, and &#39;BY_WHOLE&#39;.<tr><td><a name="l1371" href="#l1371">1371</a><td> * @see goog.getCssName for a description.<tr><td><a name="l1372" href="#l1372">1372</a><td> */<tr><td><a name="l1373" href="#l1373">1373</a><td>goog.setCssNameMapping = function(mapping, opt_style) {<tr><td><a name="l1374" href="#l1374">1374</a><td>  goog.cssNameMapping_ = mapping;<tr><td><a name="l1375" href="#l1375">1375</a><td>  goog.cssNameMappingStyle_ = opt_style;<tr><td><a name="l1376" href="#l1376">1376</a><td>};<tr><td><a name="l1377" href="#l1377">1377</a><td><tr><td><a name="l1378" href="#l1378">1378</a><td><tr><td><a name="l1379" href="#l1379">1379</a><td>/**<tr><td><a name="l1380" href="#l1380">1380</a><td> * To use CSS renaming in compiled mode, one of the input files should have a<tr><td><a name="l1381" href="#l1381">1381</a><td> * call to goog.setCssNameMapping() with an object literal that the JSCompiler<tr><td><a name="l1382" href="#l1382">1382</a><td> * can extract and use to replace all calls to goog.getCssName(). In uncompiled<tr><td><a name="l1383" href="#l1383">1383</a><td> * mode, JavaScript code should be loaded before this base.js file that declares<tr><td><a name="l1384" href="#l1384">1384</a><td> * a global variable, CLOSURE_CSS_NAME_MAPPING, which is used below. This is<tr><td><a name="l1385" href="#l1385">1385</a><td> * to ensure that the mapping is loaded before any calls to goog.getCssName()<tr><td><a name="l1386" href="#l1386">1386</a><td> * are made in uncompiled mode.<tr><td><a name="l1387" href="#l1387">1387</a><td> *<tr><td><a name="l1388" href="#l1388">1388</a><td> * A hook for overriding the CSS name mapping.<tr><td><a name="l1389" href="#l1389">1389</a><td> * @type {Object|undefined}<tr><td><a name="l1390" href="#l1390">1390</a><td> */<tr><td><a name="l1391" href="#l1391">1391</a><td>goog.global.CLOSURE_CSS_NAME_MAPPING;<tr><td><a name="l1392" href="#l1392">1392</a><td><tr><td><a name="l1393" href="#l1393">1393</a><td><tr><td><a name="l1394" href="#l1394">1394</a><td>if (!COMPILED &amp;&amp; goog.global.CLOSURE_CSS_NAME_MAPPING) {<tr><td><a name="l1395" href="#l1395">1395</a><td>  // This does not call goog.setCssNameMapping() because the JSCompiler<tr><td><a name="l1396" href="#l1396">1396</a><td>  // requires that goog.setCssNameMapping() be called with an object literal.<tr><td><a name="l1397" href="#l1397">1397</a><td>  goog.cssNameMapping_ = goog.global.CLOSURE_CSS_NAME_MAPPING;<tr><td><a name="l1398" href="#l1398">1398</a><td>}<tr><td><a name="l1399" href="#l1399">1399</a><td><tr><td><a name="l1400" href="#l1400">1400</a><td><tr><td><a name="l1401" href="#l1401">1401</a><td>/**<tr><td><a name="l1402" href="#l1402">1402</a><td> * Gets a localized message.<tr><td><a name="l1403" href="#l1403">1403</a><td> *<tr><td><a name="l1404" href="#l1404">1404</a><td> * This function is a compiler primitive. If you give the compiler a localized<tr><td><a name="l1405" href="#l1405">1405</a><td> * message bundle, it will replace the string at compile-time with a localized<tr><td><a name="l1406" href="#l1406">1406</a><td> * version, and expand goog.getMsg call to a concatenated string.<tr><td><a name="l1407" href="#l1407">1407</a><td> *<tr><td><a name="l1408" href="#l1408">1408</a><td> * Messages must be initialized in the form:<tr><td><a name="l1409" href="#l1409">1409</a><td> * &lt;code&gt;<tr><td><a name="l1410" href="#l1410">1410</a><td> * var MSG_NAME = goog.getMsg(&#39;Hello {$placeholder}&#39;, {&#39;placeholder&#39;: &#39;world&#39;});<tr><td><a name="l1411" href="#l1411">1411</a><td> * &lt;/code&gt;<tr><td><a name="l1412" href="#l1412">1412</a><td> *<tr><td><a name="l1413" href="#l1413">1413</a><td> * @param {string} str Translatable string, places holders in the form {$foo}.<tr><td><a name="l1414" href="#l1414">1414</a><td> * @param {Object=} opt_values Map of place holder name to value.<tr><td><a name="l1415" href="#l1415">1415</a><td> * @return {string} message with placeholders filled.<tr><td><a name="l1416" href="#l1416">1416</a><td> */<tr><td><a name="l1417" href="#l1417">1417</a><td>goog.getMsg = function(str, opt_values) {<tr><td><a name="l1418" href="#l1418">1418</a><td>  var values = opt_values || {};<tr><td><a name="l1419" href="#l1419">1419</a><td>  for (var key in values) {<tr><td><a name="l1420" href="#l1420">1420</a><td>    var value = (&#39;&#39; + values[key]).replace(/\$/g, &#39;$$$$&#39;);<tr><td><a name="l1421" href="#l1421">1421</a><td>    str = str.replace(new RegExp(&#39;\\{\\$&#39; + key + &#39;\\}&#39;, &#39;gi&#39;), value);<tr><td><a name="l1422" href="#l1422">1422</a><td>  }<tr><td><a name="l1423" href="#l1423">1423</a><td>  return str;<tr><td><a name="l1424" href="#l1424">1424</a><td>};<tr><td><a name="l1425" href="#l1425">1425</a><td><tr><td><a name="l1426" href="#l1426">1426</a><td><tr><td><a name="l1427" href="#l1427">1427</a><td>/**<tr><td><a name="l1428" href="#l1428">1428</a><td> * Gets a localized message. If the message does not have a translation, gives a<tr><td><a name="l1429" href="#l1429">1429</a><td> * fallback message.<tr><td><a name="l1430" href="#l1430">1430</a><td> *<tr><td><a name="l1431" href="#l1431">1431</a><td> * This is useful when introducing a new message that has not yet been<tr><td><a name="l1432" href="#l1432">1432</a><td> * translated into all languages.<tr><td><a name="l1433" href="#l1433">1433</a><td> *<tr><td><a name="l1434" href="#l1434">1434</a><td> * This function is a compiler primtive. Must be used in the form:<tr><td><a name="l1435" href="#l1435">1435</a><td> * &lt;code&gt;var x = goog.getMsgWithFallback(MSG_A, MSG_B);&lt;/code&gt;<tr><td><a name="l1436" href="#l1436">1436</a><td> * where MSG_A and MSG_B were initialized with goog.getMsg.<tr><td><a name="l1437" href="#l1437">1437</a><td> *<tr><td><a name="l1438" href="#l1438">1438</a><td> * @param {string} a The preferred message.<tr><td><a name="l1439" href="#l1439">1439</a><td> * @param {string} b The fallback message.<tr><td><a name="l1440" href="#l1440">1440</a><td> * @return {string} The best translated message.<tr><td><a name="l1441" href="#l1441">1441</a><td> */<tr><td><a name="l1442" href="#l1442">1442</a><td>goog.getMsgWithFallback = function(a, b) {<tr><td><a name="l1443" href="#l1443">1443</a><td>  return a;<tr><td><a name="l1444" href="#l1444">1444</a><td>};<tr><td><a name="l1445" href="#l1445">1445</a><td><tr><td><a name="l1446" href="#l1446">1446</a><td><tr><td><a name="l1447" href="#l1447">1447</a><td>/**<tr><td><a name="l1448" href="#l1448">1448</a><td> * Exposes an unobfuscated global namespace path for the given object.<tr><td><a name="l1449" href="#l1449">1449</a><td> * Note that fields of the exported object *will* be obfuscated,<tr><td><a name="l1450" href="#l1450">1450</a><td> * unless they are exported in turn via this function or<tr><td><a name="l1451" href="#l1451">1451</a><td> * goog.exportProperty<tr><td><a name="l1452" href="#l1452">1452</a><td> *<tr><td><a name="l1453" href="#l1453">1453</a><td> * &lt;p&gt;Also handy for making public items that are defined in anonymous<tr><td><a name="l1454" href="#l1454">1454</a><td> * closures.<tr><td><a name="l1455" href="#l1455">1455</a><td> *<tr><td><a name="l1456" href="#l1456">1456</a><td> * ex. goog.exportSymbol(&#39;public.path.Foo&#39;, Foo);<tr><td><a name="l1457" href="#l1457">1457</a><td> *<tr><td><a name="l1458" href="#l1458">1458</a><td> * ex. goog.exportSymbol(&#39;public.path.Foo.staticFunction&#39;,<tr><td><a name="l1459" href="#l1459">1459</a><td> *                       Foo.staticFunction);<tr><td><a name="l1460" href="#l1460">1460</a><td> *     public.path.Foo.staticFunction();<tr><td><a name="l1461" href="#l1461">1461</a><td> *<tr><td><a name="l1462" href="#l1462">1462</a><td> * ex. goog.exportSymbol(&#39;public.path.Foo.prototype.myMethod&#39;,<tr><td><a name="l1463" href="#l1463">1463</a><td> *                       Foo.prototype.myMethod);<tr><td><a name="l1464" href="#l1464">1464</a><td> *     new public.path.Foo().myMethod();<tr><td><a name="l1465" href="#l1465">1465</a><td> *<tr><td><a name="l1466" href="#l1466">1466</a><td> * @param {string} publicPath Unobfuscated name to export.<tr><td><a name="l1467" href="#l1467">1467</a><td> * @param {*} object Object the name should point to.<tr><td><a name="l1468" href="#l1468">1468</a><td> * @param {Object=} opt_objectToExportTo The object to add the path to; default<tr><td><a name="l1469" href="#l1469">1469</a><td> *     is |goog.global|.<tr><td><a name="l1470" href="#l1470">1470</a><td> */<tr><td><a name="l1471" href="#l1471">1471</a><td>goog.exportSymbol = function(publicPath, object, opt_objectToExportTo) {<tr><td><a name="l1472" href="#l1472">1472</a><td>  goog.exportPath_(publicPath, object, opt_objectToExportTo);<tr><td><a name="l1473" href="#l1473">1473</a><td>};<tr><td><a name="l1474" href="#l1474">1474</a><td><tr><td><a name="l1475" href="#l1475">1475</a><td><tr><td><a name="l1476" href="#l1476">1476</a><td>/**<tr><td><a name="l1477" href="#l1477">1477</a><td> * Exports a property unobfuscated into the object&#39;s namespace.<tr><td><a name="l1478" href="#l1478">1478</a><td> * ex. goog.exportProperty(Foo, &#39;staticFunction&#39;, Foo.staticFunction);<tr><td><a name="l1479" href="#l1479">1479</a><td> * ex. goog.exportProperty(Foo.prototype, &#39;myMethod&#39;, Foo.prototype.myMethod);<tr><td><a name="l1480" href="#l1480">1480</a><td> * @param {Object} object Object whose static property is being exported.<tr><td><a name="l1481" href="#l1481">1481</a><td> * @param {string} publicName Unobfuscated name to export.<tr><td><a name="l1482" href="#l1482">1482</a><td> * @param {*} symbol Object the name should point to.<tr><td><a name="l1483" href="#l1483">1483</a><td> */<tr><td><a name="l1484" href="#l1484">1484</a><td>goog.exportProperty = function(object, publicName, symbol) {<tr><td><a name="l1485" href="#l1485">1485</a><td>  object[publicName] = symbol;<tr><td><a name="l1486" href="#l1486">1486</a><td>};<tr><td><a name="l1487" href="#l1487">1487</a><td><tr><td><a name="l1488" href="#l1488">1488</a><td><tr><td><a name="l1489" href="#l1489">1489</a><td>/**<tr><td><a name="l1490" href="#l1490">1490</a><td> * Inherit the prototype methods from one constructor into another.<tr><td><a name="l1491" href="#l1491">1491</a><td> *<tr><td><a name="l1492" href="#l1492">1492</a><td> * Usage:<tr><td><a name="l1493" href="#l1493">1493</a><td> * &lt;pre&gt;<tr><td><a name="l1494" href="#l1494">1494</a><td> * function ParentClass(a, b) { }<tr><td><a name="l1495" href="#l1495">1495</a><td> * ParentClass.prototype.foo = function(a) { }<tr><td><a name="l1496" href="#l1496">1496</a><td> *<tr><td><a name="l1497" href="#l1497">1497</a><td> * function ChildClass(a, b, c) {<tr><td><a name="l1498" href="#l1498">1498</a><td> *   goog.base(this, a, b);<tr><td><a name="l1499" href="#l1499">1499</a><td> * }<tr><td><a name="l1500" href="#l1500">1500</a><td> * goog.inherits(ChildClass, ParentClass);<tr><td><a name="l1501" href="#l1501">1501</a><td> *<tr><td><a name="l1502" href="#l1502">1502</a><td> * var child = new ChildClass(&#39;a&#39;, &#39;b&#39;, &#39;see&#39;);<tr><td><a name="l1503" href="#l1503">1503</a><td> * child.foo(); // works<tr><td><a name="l1504" href="#l1504">1504</a><td> * &lt;/pre&gt;<tr><td><a name="l1505" href="#l1505">1505</a><td> *<tr><td><a name="l1506" href="#l1506">1506</a><td> * In addition, a superclass&#39; implementation of a method can be invoked<tr><td><a name="l1507" href="#l1507">1507</a><td> * as follows:<tr><td><a name="l1508" href="#l1508">1508</a><td> *<tr><td><a name="l1509" href="#l1509">1509</a><td> * &lt;pre&gt;<tr><td><a name="l1510" href="#l1510">1510</a><td> * ChildClass.prototype.foo = function(a) {<tr><td><a name="l1511" href="#l1511">1511</a><td> *   ChildClass.superClass_.foo.call(this, a);<tr><td><a name="l1512" href="#l1512">1512</a><td> *   // other code<tr><td><a name="l1513" href="#l1513">1513</a><td> * };<tr><td><a name="l1514" href="#l1514">1514</a><td> * &lt;/pre&gt;<tr><td><a name="l1515" href="#l1515">1515</a><td> *<tr><td><a name="l1516" href="#l1516">1516</a><td> * @param {Function} childCtor Child class.<tr><td><a name="l1517" href="#l1517">1517</a><td> * @param {Function} parentCtor Parent class.<tr><td><a name="l1518" href="#l1518">1518</a><td> */<tr><td><a name="l1519" href="#l1519">1519</a><td>goog.inherits = function(childCtor, parentCtor) {<tr><td><a name="l1520" href="#l1520">1520</a><td>  /** @constructor */<tr><td><a name="l1521" href="#l1521">1521</a><td>  function tempCtor() {};<tr><td><a name="l1522" href="#l1522">1522</a><td>  tempCtor.prototype = parentCtor.prototype;<tr><td><a name="l1523" href="#l1523">1523</a><td>  childCtor.superClass_ = parentCtor.prototype;<tr><td><a name="l1524" href="#l1524">1524</a><td>  childCtor.prototype = new tempCtor();<tr><td><a name="l1525" href="#l1525">1525</a><td>  /** @override */<tr><td><a name="l1526" href="#l1526">1526</a><td>  childCtor.prototype.constructor = childCtor;<tr><td><a name="l1527" href="#l1527">1527</a><td>};<tr><td><a name="l1528" href="#l1528">1528</a><td><tr><td><a name="l1529" href="#l1529">1529</a><td><tr><td><a name="l1530" href="#l1530">1530</a><td>/**<tr><td><a name="l1531" href="#l1531">1531</a><td> * Call up to the superclass.<tr><td><a name="l1532" href="#l1532">1532</a><td> *<tr><td><a name="l1533" href="#l1533">1533</a><td> * If this is called from a constructor, then this calls the superclass<tr><td><a name="l1534" href="#l1534">1534</a><td> * contructor with arguments 1-N.<tr><td><a name="l1535" href="#l1535">1535</a><td> *<tr><td><a name="l1536" href="#l1536">1536</a><td> * If this is called from a prototype method, then you must pass<tr><td><a name="l1537" href="#l1537">1537</a><td> * the name of the method as the second argument to this function. If<tr><td><a name="l1538" href="#l1538">1538</a><td> * you do not, you will get a runtime error. This calls the superclass&#39;<tr><td><a name="l1539" href="#l1539">1539</a><td> * method with arguments 2-N.<tr><td><a name="l1540" href="#l1540">1540</a><td> *<tr><td><a name="l1541" href="#l1541">1541</a><td> * This function only works if you use goog.inherits to express<tr><td><a name="l1542" href="#l1542">1542</a><td> * inheritance relationships between your classes.<tr><td><a name="l1543" href="#l1543">1543</a><td> *<tr><td><a name="l1544" href="#l1544">1544</a><td> * This function is a compiler primitive. At compile-time, the<tr><td><a name="l1545" href="#l1545">1545</a><td> * compiler will do macro expansion to remove a lot of<tr><td><a name="l1546" href="#l1546">1546</a><td> * the extra overhead that this function introduces. The compiler<tr><td><a name="l1547" href="#l1547">1547</a><td> * will also enforce a lot of the assumptions that this function<tr><td><a name="l1548" href="#l1548">1548</a><td> * makes, and treat it as a compiler error if you break them.<tr><td><a name="l1549" href="#l1549">1549</a><td> *<tr><td><a name="l1550" href="#l1550">1550</a><td> * @param {!Object} me Should always be &quot;this&quot;.<tr><td><a name="l1551" href="#l1551">1551</a><td> * @param {*=} opt_methodName The method name if calling a super method.<tr><td><a name="l1552" href="#l1552">1552</a><td> * @param {...*} var_args The rest of the arguments.<tr><td><a name="l1553" href="#l1553">1553</a><td> * @return {*} The return value of the superclass method.<tr><td><a name="l1554" href="#l1554">1554</a><td> */<tr><td><a name="l1555" href="#l1555">1555</a><td>goog.base = function(me, opt_methodName, var_args) {<tr><td><a name="l1556" href="#l1556">1556</a><td>  var caller = arguments.callee.caller;<tr><td><a name="l1557" href="#l1557">1557</a><td><tr><td><a name="l1558" href="#l1558">1558</a><td>  if (goog.DEBUG) {<tr><td><a name="l1559" href="#l1559">1559</a><td>    if (!caller) {<tr><td><a name="l1560" href="#l1560">1560</a><td>      throw Error(&#39;arguments.caller not defined.  goog.base() expects not &#39; +<tr><td><a name="l1561" href="#l1561">1561</a><td>                  &#39;to be running in strict mode. See &#39; +<tr><td><a name="l1562" href="#l1562">1562</a><td>                  &#39;http://www.ecma-international.org/ecma-262/5.1/#sec-C&#39;);<tr><td><a name="l1563" href="#l1563">1563</a><td>    }<tr><td><a name="l1564" href="#l1564">1564</a><td>  }<tr><td><a name="l1565" href="#l1565">1565</a><td><tr><td><a name="l1566" href="#l1566">1566</a><td>  if (caller.superClass_) {<tr><td><a name="l1567" href="#l1567">1567</a><td>    // This is a constructor. Call the superclass constructor.<tr><td><a name="l1568" href="#l1568">1568</a><td>    return caller.superClass_.constructor.apply(<tr><td><a name="l1569" href="#l1569">1569</a><td>        me, Array.prototype.slice.call(arguments, 1));<tr><td><a name="l1570" href="#l1570">1570</a><td>  }<tr><td><a name="l1571" href="#l1571">1571</a><td><tr><td><a name="l1572" href="#l1572">1572</a><td>  var args = Array.prototype.slice.call(arguments, 2);<tr><td><a name="l1573" href="#l1573">1573</a><td>  var foundCaller = false;<tr><td><a name="l1574" href="#l1574">1574</a><td>  for (var ctor = me.constructor;<tr><td><a name="l1575" href="#l1575">1575</a><td>       ctor; ctor = ctor.superClass_ &amp;&amp; ctor.superClass_.constructor) {<tr><td><a name="l1576" href="#l1576">1576</a><td>    if (ctor.prototype[opt_methodName] === caller) {<tr><td><a name="l1577" href="#l1577">1577</a><td>      foundCaller = true;<tr><td><a name="l1578" href="#l1578">1578</a><td>    } else if (foundCaller) {<tr><td><a name="l1579" href="#l1579">1579</a><td>      return ctor.prototype[opt_methodName].apply(me, args);<tr><td><a name="l1580" href="#l1580">1580</a><td>    }<tr><td><a name="l1581" href="#l1581">1581</a><td>  }<tr><td><a name="l1582" href="#l1582">1582</a><td><tr><td><a name="l1583" href="#l1583">1583</a><td>  // If we did not find the caller in the prototype chain,<tr><td><a name="l1584" href="#l1584">1584</a><td>  // then one of two things happened:<tr><td><a name="l1585" href="#l1585">1585</a><td>  // 1) The caller is an instance method.<tr><td><a name="l1586" href="#l1586">1586</a><td>  // 2) This method was not called by the right caller.<tr><td><a name="l1587" href="#l1587">1587</a><td>  if (me[opt_methodName] === caller) {<tr><td><a name="l1588" href="#l1588">1588</a><td>    return me.constructor.prototype[opt_methodName].apply(me, args);<tr><td><a name="l1589" href="#l1589">1589</a><td>  } else {<tr><td><a name="l1590" href="#l1590">1590</a><td>    throw Error(<tr><td><a name="l1591" href="#l1591">1591</a><td>        &#39;goog.base called from a method of one name &#39; +<tr><td><a name="l1592" href="#l1592">1592</a><td>        &#39;to a method of a different name&#39;);<tr><td><a name="l1593" href="#l1593">1593</a><td>  }<tr><td><a name="l1594" href="#l1594">1594</a><td>};<tr><td><a name="l1595" href="#l1595">1595</a><td><tr><td><a name="l1596" href="#l1596">1596</a><td><tr><td><a name="l1597" href="#l1597">1597</a><td>/**<tr><td><a name="l1598" href="#l1598">1598</a><td> * Allow for aliasing within scope functions.  This function exists for<tr><td><a name="l1599" href="#l1599">1599</a><td> * uncompiled code - in compiled code the calls will be inlined and the<tr><td><a name="l1600" href="#l1600">1600</a><td> * aliases applied.  In uncompiled code the function is simply run since the<tr><td><a name="l1601" href="#l1601">1601</a><td> * aliases as written are valid JavaScript.<tr><td><a name="l1602" href="#l1602">1602</a><td> * @param {function()} fn Function to call.  This function can contain aliases<tr><td><a name="l1603" href="#l1603">1603</a><td> *     to namespaces (e.g. &quot;var dom = goog.dom&quot;) or classes<tr><td><a name="l1604" href="#l1604">1604</a><td> *    (e.g. &quot;var Timer = goog.Timer&quot;).<tr><td><a name="l1605" href="#l1605">1605</a><td> */<tr><td><a name="l1606" href="#l1606">1606</a><td>goog.scope = function(fn) {<tr><td><a name="l1607" href="#l1607">1607</a><td>  fn.call(goog.global);<tr><td><a name="l1608" href="#l1608">1608</a><td>};<tr><td><a name="l1609" href="#l1609">1609</a><td><tr><td><a name="l1610" href="#l1610">1610</a><td></table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>base.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/base.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Bootstrap for the Google JS Library (Closure).<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * In uncompiled mode base.js will write out Closure&#39;s deps file, unless the<tr><td><a id="l19"></a><a href="#l19">19</a><td> * global &lt;code&gt;CLOSURE_NO_DEPS&lt;/code&gt; is set to true.  This allows projects to<tr><td><a id="l20"></a><a href="#l20">20</a><td> * include their own deps file(s) from different locations.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * @provideGoog<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> * @define {boolean} Overridden to true by the compiler when<tr><td><a id="l30"></a><a href="#l30">30</a><td> *     --process_closure_primitives is specified.<tr><td><a id="l31"></a><a href="#l31">31</a><td> */<tr><td><a id="l32"></a><a href="#l32">32</a><td>var COMPILED = false;<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> * Base namespace for the Closure library.  Checks to see goog is already<tr><td><a id="l37"></a><a href="#l37">37</a><td> * defined in the current scope before assigning to prevent clobbering if<tr><td><a id="l38"></a><a href="#l38">38</a><td> * base.js is loaded more than once.<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @const<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>var goog = goog || {};<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Reference to the global context.  In most cases this will be &#39;window&#39;.<tr><td><a id="l47"></a><a href="#l47">47</a><td> */<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.global = this;<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> * A hook for overriding the define values in uncompiled mode.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> * In uncompiled mode, {@code CLOSURE_UNCOMPILED_DEFINES} may be defined before<tr><td><a id="l55"></a><a href="#l55">55</a><td> * loading base.js.  If a key is defined in {@code CLOSURE_UNCOMPILED_DEFINES},<tr><td><a id="l56"></a><a href="#l56">56</a><td> * {@code goog.define} will use the value instead of the default value.  This<tr><td><a id="l57"></a><a href="#l57">57</a><td> * allows flags to be overwritten without compilation (this is normally<tr><td><a id="l58"></a><a href="#l58">58</a><td> * accomplished with the compiler&#39;s &quot;define&quot; flag).<tr><td><a id="l59"></a><a href="#l59">59</a><td> *<tr><td><a id="l60"></a><a href="#l60">60</a><td> * Example:<tr><td><a id="l61"></a><a href="#l61">61</a><td> * &lt;pre&gt;<tr><td><a id="l62"></a><a href="#l62">62</a><td> *   var CLOSURE_UNCOMPILED_DEFINES = {&#39;goog.DEBUG&#39;: false};<tr><td><a id="l63"></a><a href="#l63">63</a><td> * &lt;/pre&gt;<tr><td><a id="l64"></a><a href="#l64">64</a><td> *<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @type {Object&lt;string, (string|number|boolean)&gt;|undefined}<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.global.CLOSURE_UNCOMPILED_DEFINES;<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>/**<tr><td><a id="l71"></a><a href="#l71">71</a><td> * A hook for overriding the define values in uncompiled or compiled mode,<tr><td><a id="l72"></a><a href="#l72">72</a><td> * like CLOSURE_UNCOMPILED_DEFINES but effective in compiled code.  In<tr><td><a id="l73"></a><a href="#l73">73</a><td> * uncompiled code CLOSURE_UNCOMPILED_DEFINES takes precedence.<tr><td><a id="l74"></a><a href="#l74">74</a><td> *<tr><td><a id="l75"></a><a href="#l75">75</a><td> * Also unlike CLOSURE_UNCOMPILED_DEFINES the values must be number, boolean or<tr><td><a id="l76"></a><a href="#l76">76</a><td> * string literals or the compiler will emit an error.<tr><td><a id="l77"></a><a href="#l77">77</a><td> *<tr><td><a id="l78"></a><a href="#l78">78</a><td> * While any @define value may be set, only those set with goog.define will be<tr><td><a id="l79"></a><a href="#l79">79</a><td> * effective for uncompiled code.<tr><td><a id="l80"></a><a href="#l80">80</a><td> *<tr><td><a id="l81"></a><a href="#l81">81</a><td> * Example:<tr><td><a id="l82"></a><a href="#l82">82</a><td> * &lt;pre&gt;<tr><td><a id="l83"></a><a href="#l83">83</a><td> *   var CLOSURE_DEFINES = {&#39;goog.DEBUG&#39;: false} ;<tr><td><a id="l84"></a><a href="#l84">84</a><td> * &lt;/pre&gt;<tr><td><a id="l85"></a><a href="#l85">85</a><td> *<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @type {Object&lt;string, (string|number|boolean)&gt;|undefined}<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>goog.global.CLOSURE_DEFINES;<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> * Returns true if the specified value is not undefined.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * WARNING: Do not use this to test if an object has a property. Use the in<tr><td><a id="l94"></a><a href="#l94">94</a><td> * operator instead.<tr><td><a id="l95"></a><a href="#l95">95</a><td> *<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {?} val Variable to test.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @return {boolean} Whether variable is defined.<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.isDef = function(val) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  // void 0 always evaluates to undefined and hence we do not need to depend on<tr><td><a id="l101"></a><a href="#l101">101</a><td>  // the definition of the global variable named &#39;undefined&#39;.<tr><td><a id="l102"></a><a href="#l102">102</a><td>  return val !== void 0;<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><tr><td><a id="l106"></a><a href="#l106">106</a><td>/**<tr><td><a id="l107"></a><a href="#l107">107</a><td> * Builds an object structure for the provided namespace path, ensuring that<tr><td><a id="l108"></a><a href="#l108">108</a><td> * names that already exist are not overwritten. For example:<tr><td><a id="l109"></a><a href="#l109">109</a><td> * &quot;a.b.c&quot; -&gt; a = {};a.b={};a.b.c={};<tr><td><a id="l110"></a><a href="#l110">110</a><td> * Used by goog.provide and goog.exportSymbol.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @param {string} name name of the object that this file defines.<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @param {*=} opt_object the object to expose at the end of the path.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @param {Object=} opt_objectToExportTo The object to add the path to; default<tr><td><a id="l114"></a><a href="#l114">114</a><td> *     is |goog.global|.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @private<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.exportPath_ = function(name, opt_object, opt_objectToExportTo) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>  var parts = name.split(&#39;.&#39;);<tr><td><a id="l119"></a><a href="#l119">119</a><td>  var cur = opt_objectToExportTo || goog.global;<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>  // Internet Explorer exhibits strange behavior when throwing errors from<tr><td><a id="l122"></a><a href="#l122">122</a><td>  // methods externed in this manner.  See the testExportSymbolExceptions in<tr><td><a id="l123"></a><a href="#l123">123</a><td>  // base_test.html for an example.<tr><td><a id="l124"></a><a href="#l124">124</a><td>  if (!(parts[0] in cur) &amp;&amp; cur.execScript) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>    cur.execScript(&#39;var &#39; + parts[0]);<tr><td><a id="l126"></a><a href="#l126">126</a><td>  }<tr><td><a id="l127"></a><a href="#l127">127</a><td><tr><td><a id="l128"></a><a href="#l128">128</a><td>  // Certain browsers cannot parse code in the form for((a in b); c;);<tr><td><a id="l129"></a><a href="#l129">129</a><td>  // This pattern is produced by the JSCompiler when it collapses the<tr><td><a id="l130"></a><a href="#l130">130</a><td>  // statement above into the conditional loop below. To prevent this from<tr><td><a id="l131"></a><a href="#l131">131</a><td>  // happening, use a for-loop and reserve the init logic as below.<tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>  // Parentheses added to eliminate strict JS warning in Firefox.<tr><td><a id="l134"></a><a href="#l134">134</a><td>  for (var part; parts.length &amp;&amp; (part = parts.shift());) {<tr><td><a id="l135"></a><a href="#l135">135</a><td>    if (!parts.length &amp;&amp; goog.isDef(opt_object)) {<tr><td><a id="l136"></a><a href="#l136">136</a><td>      // last part and we have an object; use it<tr><td><a id="l137"></a><a href="#l137">137</a><td>      cur[part] = opt_object;<tr><td><a id="l138"></a><a href="#l138">138</a><td>    } else if (cur[part]) {<tr><td><a id="l139"></a><a href="#l139">139</a><td>      cur = cur[part];<tr><td><a id="l140"></a><a href="#l140">140</a><td>    } else {<tr><td><a id="l141"></a><a href="#l141">141</a><td>      cur = cur[part] = {};<tr><td><a id="l142"></a><a href="#l142">142</a><td>    }<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>/**<tr><td><a id="l148"></a><a href="#l148">148</a><td> * Defines a named value. In uncompiled mode, the value is retrieved from<tr><td><a id="l149"></a><a href="#l149">149</a><td> * CLOSURE_DEFINES or CLOSURE_UNCOMPILED_DEFINES if the object is defined and<tr><td><a id="l150"></a><a href="#l150">150</a><td> * has the property specified, and otherwise used the defined defaultValue.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * When compiled the default can be overridden using the compiler<tr><td><a id="l152"></a><a href="#l152">152</a><td> * options or the value set in the CLOSURE_DEFINES object.<tr><td><a id="l153"></a><a href="#l153">153</a><td> *<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {string} name The distinguished name to provide.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {string|number|boolean} defaultValue<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>goog.define = function(name, defaultValue) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  var value = defaultValue;<tr><td><a id="l159"></a><a href="#l159">159</a><td>  if (!COMPILED) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>    if (goog.global.CLOSURE_UNCOMPILED_DEFINES &amp;&amp;<tr><td><a id="l161"></a><a href="#l161">161</a><td>        Object.prototype.hasOwnProperty.call(<tr><td><a id="l162"></a><a href="#l162">162</a><td>            goog.global.CLOSURE_UNCOMPILED_DEFINES, name)) {<tr><td><a id="l163"></a><a href="#l163">163</a><td>      value = goog.global.CLOSURE_UNCOMPILED_DEFINES[name];<tr><td><a id="l164"></a><a href="#l164">164</a><td>    } else if (goog.global.CLOSURE_DEFINES &amp;&amp;<tr><td><a id="l165"></a><a href="#l165">165</a><td>        Object.prototype.hasOwnProperty.call(<tr><td><a id="l166"></a><a href="#l166">166</a><td>            goog.global.CLOSURE_DEFINES, name)) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>      value = goog.global.CLOSURE_DEFINES[name];<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>  goog.exportPath_(name, value);<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><tr><td><a id="l174"></a><a href="#l174">174</a><td>/**<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @define {boolean} DEBUG is provided as a convenience so that debugging code<tr><td><a id="l176"></a><a href="#l176">176</a><td> * that should not be included in a production js_binary can be easily stripped<tr><td><a id="l177"></a><a href="#l177">177</a><td> * by specifying --define goog.DEBUG=false to the JSCompiler. For example, most<tr><td><a id="l178"></a><a href="#l178">178</a><td> * toString() methods should be declared inside an &quot;if (goog.DEBUG)&quot; conditional<tr><td><a id="l179"></a><a href="#l179">179</a><td> * because they are generally used for debugging purposes and it is difficult<tr><td><a id="l180"></a><a href="#l180">180</a><td> * for the JSCompiler to statically determine whether they are used.<tr><td><a id="l181"></a><a href="#l181">181</a><td> */<tr><td><a id="l182"></a><a href="#l182">182</a><td>goog.define(&#39;goog.DEBUG&#39;, true);<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>/**<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @define {string} LOCALE defines the locale being used for compilation. It is<tr><td><a id="l187"></a><a href="#l187">187</a><td> * used to select locale specific data to be compiled in js binary. BUILD rule<tr><td><a id="l188"></a><a href="#l188">188</a><td> * can specify this value by &quot;--define goog.LOCALE=&lt;locale_name&gt;&quot; as JSCompiler<tr><td><a id="l189"></a><a href="#l189">189</a><td> * option.<tr><td><a id="l190"></a><a href="#l190">190</a><td> *<tr><td><a id="l191"></a><a href="#l191">191</a><td> * Take into account that the locale code format is important. You should use<tr><td><a id="l192"></a><a href="#l192">192</a><td> * the canonical Unicode format with hyphen as a delimiter. Language must be<tr><td><a id="l193"></a><a href="#l193">193</a><td> * lowercase, Language Script - Capitalized, Region - UPPERCASE.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * There are few examples: pt-BR, en, en-US, sr-Latin-BO, zh-Hans-CN.<tr><td><a id="l195"></a><a href="#l195">195</a><td> *<tr><td><a id="l196"></a><a href="#l196">196</a><td> * See more info about locale codes here:<tr><td><a id="l197"></a><a href="#l197">197</a><td> * http://www.unicode.org/reports/tr35/#Unicode_Language_and_Locale_Identifiers<tr><td><a id="l198"></a><a href="#l198">198</a><td> *<tr><td><a id="l199"></a><a href="#l199">199</a><td> * For language codes you should use values defined by ISO 693-1. See it here<tr><td><a id="l200"></a><a href="#l200">200</a><td> * http://www.w3.org/WAI/ER/IG/ert/iso639.htm. There is only one exception from<tr><td><a id="l201"></a><a href="#l201">201</a><td> * this rule: the Hebrew language. For legacy reasons the old code (iw) should<tr><td><a id="l202"></a><a href="#l202">202</a><td> * be used instead of the new code (he), see http://wiki/Main/IIISynonyms.<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.define(&#39;goog.LOCALE&#39;, &#39;en&#39;);  // default to en<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td>/**<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @define {boolean} Whether this code is running on trusted sites.<tr><td><a id="l209"></a><a href="#l209">209</a><td> *<tr><td><a id="l210"></a><a href="#l210">210</a><td> * On untrusted sites, several native functions can be defined or overridden by<tr><td><a id="l211"></a><a href="#l211">211</a><td> * external libraries like Prototype, Datejs, and JQuery and setting this flag<tr><td><a id="l212"></a><a href="#l212">212</a><td> * to false forces closure to use its own implementations when possible.<tr><td><a id="l213"></a><a href="#l213">213</a><td> *<tr><td><a id="l214"></a><a href="#l214">214</a><td> * If your JavaScript can be loaded by a third party site and you are wary about<tr><td><a id="l215"></a><a href="#l215">215</a><td> * relying on non-standard implementations, specify<tr><td><a id="l216"></a><a href="#l216">216</a><td> * &quot;--define goog.TRUSTED_SITE=false&quot; to the JSCompiler.<tr><td><a id="l217"></a><a href="#l217">217</a><td> */<tr><td><a id="l218"></a><a href="#l218">218</a><td>goog.define(&#39;goog.TRUSTED_SITE&#39;, true);<tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @define {boolean} Whether a project is expected to be running in strict mode.<tr><td><a id="l223"></a><a href="#l223">223</a><td> *<tr><td><a id="l224"></a><a href="#l224">224</a><td> * This define can be used to trigger alternate implementations compatible with<tr><td><a id="l225"></a><a href="#l225">225</a><td> * running in EcmaScript Strict mode or warn about unavailable functionality.<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions_and_function_scope/Strict_mode<tr><td><a id="l227"></a><a href="#l227">227</a><td> *<tr><td><a id="l228"></a><a href="#l228">228</a><td> */<tr><td><a id="l229"></a><a href="#l229">229</a><td>goog.define(&#39;goog.STRICT_MODE_COMPATIBLE&#39;, false);<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td>/**<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @define {boolean} Whether code that calls {@link goog.setTestOnly} should<tr><td><a id="l234"></a><a href="#l234">234</a><td> *     be disallowed in the compilation unit.<tr><td><a id="l235"></a><a href="#l235">235</a><td> */<tr><td><a id="l236"></a><a href="#l236">236</a><td>goog.define(&#39;goog.DISALLOW_TEST_ONLY_CODE&#39;, COMPILED &amp;&amp; !goog.DEBUG);<tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td><tr><td><a id="l239"></a><a href="#l239">239</a><td>/**<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @define {boolean} Whether to use a Chrome app CSP-compliant method for<tr><td><a id="l241"></a><a href="#l241">241</a><td> *     loading scripts via goog.require. @see appendScriptSrcNode_.<tr><td><a id="l242"></a><a href="#l242">242</a><td> */<tr><td><a id="l243"></a><a href="#l243">243</a><td>goog.define(&#39;goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING&#39;, false);<tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td>/**<tr><td><a id="l247"></a><a href="#l247">247</a><td> * Defines a namespace in Closure.<tr><td><a id="l248"></a><a href="#l248">248</a><td> *<tr><td><a id="l249"></a><a href="#l249">249</a><td> * A namespace may only be defined once in a codebase. It may be defined using<tr><td><a id="l250"></a><a href="#l250">250</a><td> * goog.provide() or goog.module().<tr><td><a id="l251"></a><a href="#l251">251</a><td> *<tr><td><a id="l252"></a><a href="#l252">252</a><td> * The presence of one or more goog.provide() calls in a file indicates<tr><td><a id="l253"></a><a href="#l253">253</a><td> * that the file defines the given objects/namespaces.<tr><td><a id="l254"></a><a href="#l254">254</a><td> * Provided symbols must not be null or undefined.<tr><td><a id="l255"></a><a href="#l255">255</a><td> *<tr><td><a id="l256"></a><a href="#l256">256</a><td> * In addition, goog.provide() creates the object stubs for a namespace<tr><td><a id="l257"></a><a href="#l257">257</a><td> * (for example, goog.provide(&quot;goog.foo.bar&quot;) will create the object<tr><td><a id="l258"></a><a href="#l258">258</a><td> * goog.foo.bar if it does not already exist).<tr><td><a id="l259"></a><a href="#l259">259</a><td> *<tr><td><a id="l260"></a><a href="#l260">260</a><td> * Build tools also scan for provide/require/module statements<tr><td><a id="l261"></a><a href="#l261">261</a><td> * to discern dependencies, build dependency files (see deps.js), etc.<tr><td><a id="l262"></a><a href="#l262">262</a><td> *<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @see goog.require<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @see goog.module<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @param {string} name Namespace provided by this file in the form<tr><td><a id="l266"></a><a href="#l266">266</a><td> *     &quot;goog.package.part&quot;.<tr><td><a id="l267"></a><a href="#l267">267</a><td> */<tr><td><a id="l268"></a><a href="#l268">268</a><td>goog.provide = function(name) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>  if (!COMPILED) {<tr><td><a id="l270"></a><a href="#l270">270</a><td>    // Ensure that the same namespace isn&#39;t provided twice.<tr><td><a id="l271"></a><a href="#l271">271</a><td>    // A goog.module/goog.provide maps a goog.require to a specific file<tr><td><a id="l272"></a><a href="#l272">272</a><td>    if (goog.isProvided_(name)) {<tr><td><a id="l273"></a><a href="#l273">273</a><td>      throw Error(&#39;Namespace &quot;&#39; + name + &#39;&quot; already declared.&#39;);<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><tr><td><a id="l277"></a><a href="#l277">277</a><td>  goog.constructNamespace_(name);<tr><td><a id="l278"></a><a href="#l278">278</a><td>};<tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td><tr><td><a id="l281"></a><a href="#l281">281</a><td>/**<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @param {string} name Namespace provided by this file in the form<tr><td><a id="l283"></a><a href="#l283">283</a><td> *     &quot;goog.package.part&quot;.<tr><td><a id="l284"></a><a href="#l284">284</a><td> * @param {Object=} opt_obj The object to embed in the namespace.<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @private<tr><td><a id="l286"></a><a href="#l286">286</a><td> */<tr><td><a id="l287"></a><a href="#l287">287</a><td>goog.constructNamespace_ = function(name, opt_obj) {<tr><td><a id="l288"></a><a href="#l288">288</a><td>  if (!COMPILED) {<tr><td><a id="l289"></a><a href="#l289">289</a><td>    delete goog.implicitNamespaces_[name];<tr><td><a id="l290"></a><a href="#l290">290</a><td><tr><td><a id="l291"></a><a href="#l291">291</a><td>    var namespace = name;<tr><td><a id="l292"></a><a href="#l292">292</a><td>    while ((namespace = namespace.substring(0, namespace.lastIndexOf(&#39;.&#39;)))) {<tr><td><a id="l293"></a><a href="#l293">293</a><td>      if (goog.getObjectByName(namespace)) {<tr><td><a id="l294"></a><a href="#l294">294</a><td>        break;<tr><td><a id="l295"></a><a href="#l295">295</a><td>      }<tr><td><a id="l296"></a><a href="#l296">296</a><td>      goog.implicitNamespaces_[namespace] = true;<tr><td><a id="l297"></a><a href="#l297">297</a><td>    }<tr><td><a id="l298"></a><a href="#l298">298</a><td>  }<tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>  goog.exportPath_(name, opt_obj);<tr><td><a id="l301"></a><a href="#l301">301</a><td>};<tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td><tr><td><a id="l304"></a><a href="#l304">304</a><td>/**<tr><td><a id="l305"></a><a href="#l305">305</a><td> * Module identifier validation regexp.<tr><td><a id="l306"></a><a href="#l306">306</a><td> * Note: This is a conservative check, it is very possible to be more lenient,<tr><td><a id="l307"></a><a href="#l307">307</a><td> *   the primary exclusion here is &quot;/&quot; and &quot;\&quot; and a leading &quot;.&quot;, these<tr><td><a id="l308"></a><a href="#l308">308</a><td> *   restrictions are intended to leave the door open for using goog.require<tr><td><a id="l309"></a><a href="#l309">309</a><td> *   with relative file paths rather than module identifiers.<tr><td><a id="l310"></a><a href="#l310">310</a><td> * @private<tr><td><a id="l311"></a><a href="#l311">311</a><td> */<tr><td><a id="l312"></a><a href="#l312">312</a><td>goog.VALID_MODULE_RE_ = /^[a-zA-Z_$][a-zA-Z0-9._$]*$/;<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> * Defines a module in Closure.<tr><td><a id="l317"></a><a href="#l317">317</a><td> *<tr><td><a id="l318"></a><a href="#l318">318</a><td> * Marks that this file must be loaded as a module and claims the namespace.<tr><td><a id="l319"></a><a href="#l319">319</a><td> *<tr><td><a id="l320"></a><a href="#l320">320</a><td> * A namespace may only be defined once in a codebase. It may be defined using<tr><td><a id="l321"></a><a href="#l321">321</a><td> * goog.provide() or goog.module().<tr><td><a id="l322"></a><a href="#l322">322</a><td> *<tr><td><a id="l323"></a><a href="#l323">323</a><td> * goog.module() has three requirements:<tr><td><a id="l324"></a><a href="#l324">324</a><td> * - goog.module may not be used in the same file as goog.provide.<tr><td><a id="l325"></a><a href="#l325">325</a><td> * - goog.module must be the first statement in the file.<tr><td><a id="l326"></a><a href="#l326">326</a><td> * - only one goog.module is allowed per file.<tr><td><a id="l327"></a><a href="#l327">327</a><td> *<tr><td><a id="l328"></a><a href="#l328">328</a><td> * When a goog.module annotated file is loaded, it is enclosed in<tr><td><a id="l329"></a><a href="#l329">329</a><td> * a strict function closure. This means that:<tr><td><a id="l330"></a><a href="#l330">330</a><td> * - any variables declared in a goog.module file are private to the file<tr><td><a id="l331"></a><a href="#l331">331</a><td> * (not global), though the compiler is expected to inline the module.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * - The code must obey all the rules of &quot;strict&quot; JavaScript.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * - the file will be marked as &quot;use strict&quot;<tr><td><a id="l334"></a><a href="#l334">334</a><td> *<tr><td><a id="l335"></a><a href="#l335">335</a><td> * NOTE: unlike goog.provide, goog.module does not declare any symbols by<tr><td><a id="l336"></a><a href="#l336">336</a><td> * itself. If declared symbols are desired, use<tr><td><a id="l337"></a><a href="#l337">337</a><td> * goog.module.declareLegacyNamespace().<tr><td><a id="l338"></a><a href="#l338">338</a><td> *<tr><td><a id="l339"></a><a href="#l339">339</a><td> *<tr><td><a id="l340"></a><a href="#l340">340</a><td> * See the public goog.module proposal: http://goo.gl/Va1hin<tr><td><a id="l341"></a><a href="#l341">341</a><td> *<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {string} name Namespace provided by this file in the form<tr><td><a id="l343"></a><a href="#l343">343</a><td> *     &quot;goog.package.part&quot;, is expected but not required.<tr><td><a id="l344"></a><a href="#l344">344</a><td> */<tr><td><a id="l345"></a><a href="#l345">345</a><td>goog.module = function(name) {<tr><td><a id="l346"></a><a href="#l346">346</a><td>  if (!goog.isString(name) ||<tr><td><a id="l347"></a><a href="#l347">347</a><td>      !name ||<tr><td><a id="l348"></a><a href="#l348">348</a><td>      name.search(goog.VALID_MODULE_RE_) == -1) {<tr><td><a id="l349"></a><a href="#l349">349</a><td>    throw Error(&#39;Invalid module identifier&#39;);<tr><td><a id="l350"></a><a href="#l350">350</a><td>  }<tr><td><a id="l351"></a><a href="#l351">351</a><td>  if (!goog.isInModuleLoader_()) {<tr><td><a id="l352"></a><a href="#l352">352</a><td>    throw Error(&#39;Module &#39; + name + &#39; has been loaded incorrectly.&#39;);<tr><td><a id="l353"></a><a href="#l353">353</a><td>  }<tr><td><a id="l354"></a><a href="#l354">354</a><td>  if (goog.moduleLoaderState_.moduleName) {<tr><td><a id="l355"></a><a href="#l355">355</a><td>    throw Error(&#39;goog.module may only be called once per module.&#39;);<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>  // Store the module name for the loader.<tr><td><a id="l359"></a><a href="#l359">359</a><td>  goog.moduleLoaderState_.moduleName = name;<tr><td><a id="l360"></a><a href="#l360">360</a><td>  if (!COMPILED) {<tr><td><a id="l361"></a><a href="#l361">361</a><td>    // Ensure that the same namespace isn&#39;t provided twice.<tr><td><a id="l362"></a><a href="#l362">362</a><td>    // A goog.module/goog.provide maps a goog.require to a specific file<tr><td><a id="l363"></a><a href="#l363">363</a><td>    if (goog.isProvided_(name)) {<tr><td><a id="l364"></a><a href="#l364">364</a><td>      throw Error(&#39;Namespace &quot;&#39; + name + &#39;&quot; already declared.&#39;);<tr><td><a id="l365"></a><a href="#l365">365</a><td>    }<tr><td><a id="l366"></a><a href="#l366">366</a><td>    delete goog.implicitNamespaces_[name];<tr><td><a id="l367"></a><a href="#l367">367</a><td>  }<tr><td><a id="l368"></a><a href="#l368">368</a><td>};<tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td>/**<tr><td><a id="l372"></a><a href="#l372">372</a><td> * @param {string} name The module identifier.<tr><td><a id="l373"></a><a href="#l373">373</a><td> * @return {?} The module exports for an already loaded module or null.<tr><td><a id="l374"></a><a href="#l374">374</a><td> *<tr><td><a id="l375"></a><a href="#l375">375</a><td> * Note: This is not an alternative to goog.require, it does not<tr><td><a id="l376"></a><a href="#l376">376</a><td> * indicate a hard dependency, instead it is used to indicate<tr><td><a id="l377"></a><a href="#l377">377</a><td> * an optional dependency or to access the exports of a module<tr><td><a id="l378"></a><a href="#l378">378</a><td> * that has already been loaded.<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @suppress {missingProvide}<tr><td><a id="l380"></a><a href="#l380">380</a><td> */<tr><td><a id="l381"></a><a href="#l381">381</a><td>goog.module.get = function(name) {<tr><td><a id="l382"></a><a href="#l382">382</a><td>  return goog.module.getInternal_(name);<tr><td><a id="l383"></a><a href="#l383">383</a><td>};<tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td>/**<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @param {string} name The module identifier.<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @return {?} The module exports for an already loaded module or null.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @private<tr><td><a id="l390"></a><a href="#l390">390</a><td> */<tr><td><a id="l391"></a><a href="#l391">391</a><td>goog.module.getInternal_ = function(name) {<tr><td><a id="l392"></a><a href="#l392">392</a><td>  if (!COMPILED) {<tr><td><a id="l393"></a><a href="#l393">393</a><td>    if (goog.isProvided_(name)) {<tr><td><a id="l394"></a><a href="#l394">394</a><td>      // goog.require only return a value with-in goog.module files.<tr><td><a id="l395"></a><a href="#l395">395</a><td>      return name in goog.loadedModules_ ?<tr><td><a id="l396"></a><a href="#l396">396</a><td>          goog.loadedModules_[name] :<tr><td><a id="l397"></a><a href="#l397">397</a><td>          goog.getObjectByName(name);<tr><td><a id="l398"></a><a href="#l398">398</a><td>    } else {<tr><td><a id="l399"></a><a href="#l399">399</a><td>      return null;<tr><td><a id="l400"></a><a href="#l400">400</a><td>    }<tr><td><a id="l401"></a><a href="#l401">401</a><td>  }<tr><td><a id="l402"></a><a href="#l402">402</a><td>};<tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td><tr><td><a id="l405"></a><a href="#l405">405</a><td>/**<tr><td><a id="l406"></a><a href="#l406">406</a><td> * @private {?{moduleName: (string|undefined), declareLegacyNamespace:boolean}}<tr><td><a id="l407"></a><a href="#l407">407</a><td> */<tr><td><a id="l408"></a><a href="#l408">408</a><td>goog.moduleLoaderState_ = null;<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>/**<tr><td><a id="l412"></a><a href="#l412">412</a><td> * @private<tr><td><a id="l413"></a><a href="#l413">413</a><td> * @return {boolean} Whether a goog.module is currently being initialized.<tr><td><a id="l414"></a><a href="#l414">414</a><td> */<tr><td><a id="l415"></a><a href="#l415">415</a><td>goog.isInModuleLoader_ = function() {<tr><td><a id="l416"></a><a href="#l416">416</a><td>  return goog.moduleLoaderState_ != null;<tr><td><a id="l417"></a><a href="#l417">417</a><td>};<tr><td><a id="l418"></a><a href="#l418">418</a><td><tr><td><a id="l419"></a><a href="#l419">419</a><td><tr><td><a id="l420"></a><a href="#l420">420</a><td>/**<tr><td><a id="l421"></a><a href="#l421">421</a><td> * Provide the module&#39;s exports as a globally accessible object under the<tr><td><a id="l422"></a><a href="#l422">422</a><td> * module&#39;s declared name.  This is intended to ease migration to goog.module<tr><td><a id="l423"></a><a href="#l423">423</a><td> * for files that have existing usages.<tr><td><a id="l424"></a><a href="#l424">424</a><td> * @suppress {missingProvide}<tr><td><a id="l425"></a><a href="#l425">425</a><td> */<tr><td><a id="l426"></a><a href="#l426">426</a><td>goog.module.declareLegacyNamespace = function() {<tr><td><a id="l427"></a><a href="#l427">427</a><td>  if (!COMPILED &amp;&amp; !goog.isInModuleLoader_()) {<tr><td><a id="l428"></a><a href="#l428">428</a><td>    throw new Error(&#39;goog.module.declareLegacyNamespace must be called from &#39; +<tr><td><a id="l429"></a><a href="#l429">429</a><td>        &#39;within a goog.module&#39;);<tr><td><a id="l430"></a><a href="#l430">430</a><td>  }<tr><td><a id="l431"></a><a href="#l431">431</a><td>  if (!COMPILED &amp;&amp; !goog.moduleLoaderState_.moduleName) {<tr><td><a id="l432"></a><a href="#l432">432</a><td>    throw Error(&#39;goog.module must be called prior to &#39; +<tr><td><a id="l433"></a><a href="#l433">433</a><td>        &#39;goog.module.declareLegacyNamespace.&#39;);<tr><td><a id="l434"></a><a href="#l434">434</a><td>  }<tr><td><a id="l435"></a><a href="#l435">435</a><td>  goog.moduleLoaderState_.declareLegacyNamespace = true;<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><tr><td><a id="l439"></a><a href="#l439">439</a><td>/**<tr><td><a id="l440"></a><a href="#l440">440</a><td> * Marks that the current file should only be used for testing, and never for<tr><td><a id="l441"></a><a href="#l441">441</a><td> * live code in production.<tr><td><a id="l442"></a><a href="#l442">442</a><td> *<tr><td><a id="l443"></a><a href="#l443">443</a><td> * In the case of unit tests, the message may optionally be an exact namespace<tr><td><a id="l444"></a><a href="#l444">444</a><td> * for the test (e.g. &#39;goog.stringTest&#39;). The linter will then ignore the extra<tr><td><a id="l445"></a><a href="#l445">445</a><td> * provide (if not explicitly defined in the code).<tr><td><a id="l446"></a><a href="#l446">446</a><td> *<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {string=} opt_message Optional message to add to the error that&#39;s<tr><td><a id="l448"></a><a href="#l448">448</a><td> *     raised when used in production code.<tr><td><a id="l449"></a><a href="#l449">449</a><td> */<tr><td><a id="l450"></a><a href="#l450">450</a><td>goog.setTestOnly = function(opt_message) {<tr><td><a id="l451"></a><a href="#l451">451</a><td>  if (goog.DISALLOW_TEST_ONLY_CODE) {<tr><td><a id="l452"></a><a href="#l452">452</a><td>    opt_message = opt_message || &#39;&#39;;<tr><td><a id="l453"></a><a href="#l453">453</a><td>    throw Error(&#39;Importing test-only code into non-debug environment&#39; +<tr><td><a id="l454"></a><a href="#l454">454</a><td>                (opt_message ? &#39;: &#39; + opt_message : &#39;.&#39;));<tr><td><a id="l455"></a><a href="#l455">455</a><td>  }<tr><td><a id="l456"></a><a href="#l456">456</a><td>};<tr><td><a id="l457"></a><a href="#l457">457</a><td><tr><td><a id="l458"></a><a href="#l458">458</a><td><tr><td><a id="l459"></a><a href="#l459">459</a><td>/**<tr><td><a id="l460"></a><a href="#l460">460</a><td> * Forward declares a symbol. This is an indication to the compiler that the<tr><td><a id="l461"></a><a href="#l461">461</a><td> * symbol may be used in the source yet is not required and may not be provided<tr><td><a id="l462"></a><a href="#l462">462</a><td> * in compilation.<tr><td><a id="l463"></a><a href="#l463">463</a><td> *<tr><td><a id="l464"></a><a href="#l464">464</a><td> * The most common usage of forward declaration is code that takes a type as a<tr><td><a id="l465"></a><a href="#l465">465</a><td> * function parameter but does not need to require it. By forward declaring<tr><td><a id="l466"></a><a href="#l466">466</a><td> * instead of requiring, no hard dependency is made, and (if not required<tr><td><a id="l467"></a><a href="#l467">467</a><td> * elsewhere) the namespace may never be required and thus, not be pulled<tr><td><a id="l468"></a><a href="#l468">468</a><td> * into the JavaScript binary. If it is required elsewhere, it will be type<tr><td><a id="l469"></a><a href="#l469">469</a><td> * checked as normal.<tr><td><a id="l470"></a><a href="#l470">470</a><td> *<tr><td><a id="l471"></a><a href="#l471">471</a><td> *<tr><td><a id="l472"></a><a href="#l472">472</a><td> * @param {string} name The namespace to forward declare in the form of<tr><td><a id="l473"></a><a href="#l473">473</a><td> *     &quot;goog.package.part&quot;.<tr><td><a id="l474"></a><a href="#l474">474</a><td> */<tr><td><a id="l475"></a><a href="#l475">475</a><td>goog.forwardDeclare = function(name) {};<tr><td><a id="l476"></a><a href="#l476">476</a><td><tr><td><a id="l477"></a><a href="#l477">477</a><td><tr><td><a id="l478"></a><a href="#l478">478</a><td>/**<tr><td><a id="l479"></a><a href="#l479">479</a><td> * Forward declare type information. Used to assign types to goog.global<tr><td><a id="l480"></a><a href="#l480">480</a><td> * referenced object that would otherwise result in unknown type references<tr><td><a id="l481"></a><a href="#l481">481</a><td> * and thus block property disambiguation.<tr><td><a id="l482"></a><a href="#l482">482</a><td> */<tr><td><a id="l483"></a><a href="#l483">483</a><td>goog.forwardDeclare(&#39;Document&#39;);<tr><td><a id="l484"></a><a href="#l484">484</a><td>goog.forwardDeclare(&#39;HTMLScriptElement&#39;);<tr><td><a id="l485"></a><a href="#l485">485</a><td>goog.forwardDeclare(&#39;XMLHttpRequest&#39;);<tr><td><a id="l486"></a><a href="#l486">486</a><td><tr><td><a id="l487"></a><a href="#l487">487</a><td><tr><td><a id="l488"></a><a href="#l488">488</a><td>if (!COMPILED) {<tr><td><a id="l489"></a><a href="#l489">489</a><td><tr><td><a id="l490"></a><a href="#l490">490</a><td>  /**<tr><td><a id="l491"></a><a href="#l491">491</a><td>   * Check if the given name has been goog.provided. This will return false for<tr><td><a id="l492"></a><a href="#l492">492</a><td>   * names that are available only as implicit namespaces.<tr><td><a id="l493"></a><a href="#l493">493</a><td>   * @param {string} name name of the object to look for.<tr><td><a id="l494"></a><a href="#l494">494</a><td>   * @return {boolean} Whether the name has been provided.<tr><td><a id="l495"></a><a href="#l495">495</a><td>   * @private<tr><td><a id="l496"></a><a href="#l496">496</a><td>   */<tr><td><a id="l497"></a><a href="#l497">497</a><td>  goog.isProvided_ = function(name) {<tr><td><a id="l498"></a><a href="#l498">498</a><td>    return (name in goog.loadedModules_) ||<tr><td><a id="l499"></a><a href="#l499">499</a><td>        (!goog.implicitNamespaces_[name] &amp;&amp;<tr><td><a id="l500"></a><a href="#l500">500</a><td>            goog.isDefAndNotNull(goog.getObjectByName(name)));<tr><td><a id="l501"></a><a href="#l501">501</a><td>  };<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>   * Namespaces implicitly defined by goog.provide. For example,<tr><td><a id="l505"></a><a href="#l505">505</a><td>   * goog.provide(&#39;goog.events.Event&#39;) implicitly declares that &#39;goog&#39; and<tr><td><a id="l506"></a><a href="#l506">506</a><td>   * &#39;goog.events&#39; must be namespaces.<tr><td><a id="l507"></a><a href="#l507">507</a><td>   *<tr><td><a id="l508"></a><a href="#l508">508</a><td>   * @type {!Object&lt;string, (boolean|undefined)&gt;}<tr><td><a id="l509"></a><a href="#l509">509</a><td>   * @private<tr><td><a id="l510"></a><a href="#l510">510</a><td>   */<tr><td><a id="l511"></a><a href="#l511">511</a><td>  goog.implicitNamespaces_ = {&#39;goog.module&#39;: true};<tr><td><a id="l512"></a><a href="#l512">512</a><td><tr><td><a id="l513"></a><a href="#l513">513</a><td>  // NOTE: We add goog.module as an implicit namespace as goog.module is defined<tr><td><a id="l514"></a><a href="#l514">514</a><td>  // here and because the existing module package has not been moved yet out of<tr><td><a id="l515"></a><a href="#l515">515</a><td>  // the goog.module namespace. This satisifies both the debug loader and<tr><td><a id="l516"></a><a href="#l516">516</a><td>  // ahead-of-time dependency management.<tr><td><a id="l517"></a><a href="#l517">517</a><td>}<tr><td><a id="l518"></a><a href="#l518">518</a><td><tr><td><a id="l519"></a><a href="#l519">519</a><td><tr><td><a id="l520"></a><a href="#l520">520</a><td>/**<tr><td><a id="l521"></a><a href="#l521">521</a><td> * Returns an object based on its fully qualified external name.  The object<tr><td><a id="l522"></a><a href="#l522">522</a><td> * is not found if null or undefined.  If you are using a compilation pass that<tr><td><a id="l523"></a><a href="#l523">523</a><td> * renames property names beware that using this function will not find renamed<tr><td><a id="l524"></a><a href="#l524">524</a><td> * properties.<tr><td><a id="l525"></a><a href="#l525">525</a><td> *<tr><td><a id="l526"></a><a href="#l526">526</a><td> * @param {string} name The fully qualified name.<tr><td><a id="l527"></a><a href="#l527">527</a><td> * @param {Object=} opt_obj The object within which to look; default is<tr><td><a id="l528"></a><a href="#l528">528</a><td> *     |goog.global|.<tr><td><a id="l529"></a><a href="#l529">529</a><td> * @return {?} The value (object or primitive) or, if not found, null.<tr><td><a id="l530"></a><a href="#l530">530</a><td> */<tr><td><a id="l531"></a><a href="#l531">531</a><td>goog.getObjectByName = function(name, opt_obj) {<tr><td><a id="l532"></a><a href="#l532">532</a><td>  var parts = name.split(&#39;.&#39;);<tr><td><a id="l533"></a><a href="#l533">533</a><td>  var cur = opt_obj || goog.global;<tr><td><a id="l534"></a><a href="#l534">534</a><td>  for (var part; part = parts.shift(); ) {<tr><td><a id="l535"></a><a href="#l535">535</a><td>    if (goog.isDefAndNotNull(cur[part])) {<tr><td><a id="l536"></a><a href="#l536">536</a><td>      cur = cur[part];<tr><td><a id="l537"></a><a href="#l537">537</a><td>    } else {<tr><td><a id="l538"></a><a href="#l538">538</a><td>      return null;<tr><td><a id="l539"></a><a href="#l539">539</a><td>    }<tr><td><a id="l540"></a><a href="#l540">540</a><td>  }<tr><td><a id="l541"></a><a href="#l541">541</a><td>  return cur;<tr><td><a id="l542"></a><a href="#l542">542</a><td>};<tr><td><a id="l543"></a><a href="#l543">543</a><td><tr><td><a id="l544"></a><a href="#l544">544</a><td><tr><td><a id="l545"></a><a href="#l545">545</a><td>/**<tr><td><a id="l546"></a><a href="#l546">546</a><td> * Globalizes a whole namespace, such as goog or goog.lang.<tr><td><a id="l547"></a><a href="#l547">547</a><td> *<tr><td><a id="l548"></a><a href="#l548">548</a><td> * @param {!Object} obj The namespace to globalize.<tr><td><a id="l549"></a><a href="#l549">549</a><td> * @param {Object=} opt_global The object to add the properties to.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * @deprecated Properties may be explicitly exported to the global scope, but<tr><td><a id="l551"></a><a href="#l551">551</a><td> *     this should no longer be done in bulk.<tr><td><a id="l552"></a><a href="#l552">552</a><td> */<tr><td><a id="l553"></a><a href="#l553">553</a><td>goog.globalize = function(obj, opt_global) {<tr><td><a id="l554"></a><a href="#l554">554</a><td>  var global = opt_global || goog.global;<tr><td><a id="l555"></a><a href="#l555">555</a><td>  for (var x in obj) {<tr><td><a id="l556"></a><a href="#l556">556</a><td>    global[x] = obj[x];<tr><td><a id="l557"></a><a href="#l557">557</a><td>  }<tr><td><a id="l558"></a><a href="#l558">558</a><td>};<tr><td><a id="l559"></a><a href="#l559">559</a><td><tr><td><a id="l560"></a><a href="#l560">560</a><td><tr><td><a id="l561"></a><a href="#l561">561</a><td>/**<tr><td><a id="l562"></a><a href="#l562">562</a><td> * Adds a dependency from a file to the files it requires.<tr><td><a id="l563"></a><a href="#l563">563</a><td> * @param {string} relPath The path to the js file.<tr><td><a id="l564"></a><a href="#l564">564</a><td> * @param {!Array&lt;string&gt;} provides An array of strings with<tr><td><a id="l565"></a><a href="#l565">565</a><td> *     the names of the objects this file provides.<tr><td><a id="l566"></a><a href="#l566">566</a><td> * @param {!Array&lt;string&gt;} requires An array of strings with<tr><td><a id="l567"></a><a href="#l567">567</a><td> *     the names of the objects this file requires.<tr><td><a id="l568"></a><a href="#l568">568</a><td> * @param {boolean=} opt_isModule Whether this dependency must be loaded as<tr><td><a id="l569"></a><a href="#l569">569</a><td> *     a module as declared by goog.module.<tr><td><a id="l570"></a><a href="#l570">570</a><td> */<tr><td><a id="l571"></a><a href="#l571">571</a><td>goog.addDependency = function(relPath, provides, requires, opt_isModule) {<tr><td><a id="l572"></a><a href="#l572">572</a><td>  if (goog.DEPENDENCIES_ENABLED) {<tr><td><a id="l573"></a><a href="#l573">573</a><td>    var provide, require;<tr><td><a id="l574"></a><a href="#l574">574</a><td>    var path = relPath.replace(/\\/g, &#39;/&#39;);<tr><td><a id="l575"></a><a href="#l575">575</a><td>    var deps = goog.dependencies_;<tr><td><a id="l576"></a><a href="#l576">576</a><td>    for (var i = 0; provide = provides[i]; i++) {<tr><td><a id="l577"></a><a href="#l577">577</a><td>      deps.nameToPath[provide] = path;<tr><td><a id="l578"></a><a href="#l578">578</a><td>      deps.pathIsModule[path] = !!opt_isModule;<tr><td><a id="l579"></a><a href="#l579">579</a><td>    }<tr><td><a id="l580"></a><a href="#l580">580</a><td>    for (var j = 0; require = requires[j]; j++) {<tr><td><a id="l581"></a><a href="#l581">581</a><td>      if (!(path in deps.requires)) {<tr><td><a id="l582"></a><a href="#l582">582</a><td>        deps.requires[path] = {};<tr><td><a id="l583"></a><a href="#l583">583</a><td>      }<tr><td><a id="l584"></a><a href="#l584">584</a><td>      deps.requires[path][require] = true;<tr><td><a id="l585"></a><a href="#l585">585</a><td>    }<tr><td><a id="l586"></a><a href="#l586">586</a><td>  }<tr><td><a id="l587"></a><a href="#l587">587</a><td>};<tr><td><a id="l588"></a><a href="#l588">588</a><td><tr><td><a id="l589"></a><a href="#l589">589</a><td><tr><td><a id="l590"></a><a href="#l590">590</a><td><tr><td><a id="l591"></a><a href="#l591">591</a><td><tr><td><a id="l592"></a><a href="#l592">592</a><td>// NOTE(nnaze): The debug DOM loader was included in base.js as an original way<tr><td><a id="l593"></a><a href="#l593">593</a><td>// to do &quot;debug-mode&quot; development.  The dependency system can sometimes be<tr><td><a id="l594"></a><a href="#l594">594</a><td>// confusing, as can the debug DOM loader&#39;s asynchronous nature.<tr><td><a id="l595"></a><a href="#l595">595</a><td>//<tr><td><a id="l596"></a><a href="#l596">596</a><td>// With the DOM loader, a call to goog.require() is not blocking -- the script<tr><td><a id="l597"></a><a href="#l597">597</a><td>// will not load until some point after the current script.  If a namespace is<tr><td><a id="l598"></a><a href="#l598">598</a><td>// needed at runtime, it needs to be defined in a previous script, or loaded via<tr><td><a id="l599"></a><a href="#l599">599</a><td>// require() with its registered dependencies.<tr><td><a id="l600"></a><a href="#l600">600</a><td>// User-defined namespaces may need their own deps file.  See http://go/js_deps,<tr><td><a id="l601"></a><a href="#l601">601</a><td>// http://go/genjsdeps, or, externally, DepsWriter.<tr><td><a id="l602"></a><a href="#l602">602</a><td>// https://developers.google.com/closure/library/docs/depswriter<tr><td><a id="l603"></a><a href="#l603">603</a><td>//<tr><td><a id="l604"></a><a href="#l604">604</a><td>// Because of legacy clients, the DOM loader can&#39;t be easily removed from<tr><td><a id="l605"></a><a href="#l605">605</a><td>// base.js.  Work is being done to make it disableable or replaceable for<tr><td><a id="l606"></a><a href="#l606">606</a><td>// different environments (DOM-less JavaScript interpreters like Rhino or V8,<tr><td><a id="l607"></a><a href="#l607">607</a><td>// for example). See bootstrap/ for more information.<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>/**<tr><td><a id="l611"></a><a href="#l611">611</a><td> * @define {boolean} Whether to enable the debug loader.<tr><td><a id="l612"></a><a href="#l612">612</a><td> *<tr><td><a id="l613"></a><a href="#l613">613</a><td> * If enabled, a call to goog.require() will attempt to load the namespace by<tr><td><a id="l614"></a><a href="#l614">614</a><td> * appending a script tag to the DOM (if the namespace has been registered).<tr><td><a id="l615"></a><a href="#l615">615</a><td> *<tr><td><a id="l616"></a><a href="#l616">616</a><td> * If disabled, goog.require() will simply assert that the namespace has been<tr><td><a id="l617"></a><a href="#l617">617</a><td> * provided (and depend on the fact that some outside tool correctly ordered<tr><td><a id="l618"></a><a href="#l618">618</a><td> * the script).<tr><td><a id="l619"></a><a href="#l619">619</a><td> */<tr><td><a id="l620"></a><a href="#l620">620</a><td>goog.define(&#39;goog.ENABLE_DEBUG_LOADER&#39;, true);<tr><td><a id="l621"></a><a href="#l621">621</a><td><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> * @param {string} msg<tr><td><a id="l625"></a><a href="#l625">625</a><td> * @private<tr><td><a id="l626"></a><a href="#l626">626</a><td> */<tr><td><a id="l627"></a><a href="#l627">627</a><td>goog.logToConsole_ = function(msg) {<tr><td><a id="l628"></a><a href="#l628">628</a><td>  if (goog.global.console) {<tr><td><a id="l629"></a><a href="#l629">629</a><td>    goog.global.console[&#39;error&#39;](msg);<tr><td><a id="l630"></a><a href="#l630">630</a><td>  }<tr><td><a id="l631"></a><a href="#l631">631</a><td>};<tr><td><a id="l632"></a><a href="#l632">632</a><td><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> * Implements a system for the dynamic resolution of dependencies that works in<tr><td><a id="l636"></a><a href="#l636">636</a><td> * parallel with the BUILD system. Note that all calls to goog.require will be<tr><td><a id="l637"></a><a href="#l637">637</a><td> * stripped by the JSCompiler when the --process_closure_primitives option is<tr><td><a id="l638"></a><a href="#l638">638</a><td> * used.<tr><td><a id="l639"></a><a href="#l639">639</a><td> * @see goog.provide<tr><td><a id="l640"></a><a href="#l640">640</a><td> * @param {string} name Namespace to include (as was given in goog.provide()) in<tr><td><a id="l641"></a><a href="#l641">641</a><td> *     the form &quot;goog.package.part&quot;.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @return {?} If called within a goog.module file, the associated namespace or<tr><td><a id="l643"></a><a href="#l643">643</a><td> *     module otherwise null.<tr><td><a id="l644"></a><a href="#l644">644</a><td> */<tr><td><a id="l645"></a><a href="#l645">645</a><td>goog.require = function(name) {<tr><td><a id="l646"></a><a href="#l646">646</a><td>  // If the object already exists we do not need do do anything.<tr><td><a id="l647"></a><a href="#l647">647</a><td>  if (!COMPILED) {<tr><td><a id="l648"></a><a href="#l648">648</a><td>    if (goog.ENABLE_DEBUG_LOADER &amp;&amp; goog.IS_OLD_IE_) {<tr><td><a id="l649"></a><a href="#l649">649</a><td>      goog.maybeProcessDeferredDep_(name);<tr><td><a id="l650"></a><a href="#l650">650</a><td>    }<tr><td><a id="l651"></a><a href="#l651">651</a><td><tr><td><a id="l652"></a><a href="#l652">652</a><td>    if (goog.isProvided_(name)) {<tr><td><a id="l653"></a><a href="#l653">653</a><td>      if (goog.isInModuleLoader_()) {<tr><td><a id="l654"></a><a href="#l654">654</a><td>        return goog.module.getInternal_(name);<tr><td><a id="l655"></a><a href="#l655">655</a><td>      } else {<tr><td><a id="l656"></a><a href="#l656">656</a><td>        return null;<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><tr><td><a id="l660"></a><a href="#l660">660</a><td>    if (goog.ENABLE_DEBUG_LOADER) {<tr><td><a id="l661"></a><a href="#l661">661</a><td>      var path = goog.getPathFromDeps_(name);<tr><td><a id="l662"></a><a href="#l662">662</a><td>      if (path) {<tr><td><a id="l663"></a><a href="#l663">663</a><td>        goog.writeScripts_(path);<tr><td><a id="l664"></a><a href="#l664">664</a><td>        return null;<tr><td><a id="l665"></a><a href="#l665">665</a><td>      }<tr><td><a id="l666"></a><a href="#l666">666</a><td>    }<tr><td><a id="l667"></a><a href="#l667">667</a><td><tr><td><a id="l668"></a><a href="#l668">668</a><td>    var errorMessage = &#39;goog.require could not find: &#39; + name;<tr><td><a id="l669"></a><a href="#l669">669</a><td>    goog.logToConsole_(errorMessage);<tr><td><a id="l670"></a><a href="#l670">670</a><td><tr><td><a id="l671"></a><a href="#l671">671</a><td>    throw Error(errorMessage);<tr><td><a id="l672"></a><a href="#l672">672</a><td>  }<tr><td><a id="l673"></a><a href="#l673">673</a><td>};<tr><td><a id="l674"></a><a href="#l674">674</a><td><tr><td><a id="l675"></a><a href="#l675">675</a><td><tr><td><a id="l676"></a><a href="#l676">676</a><td>/**<tr><td><a id="l677"></a><a href="#l677">677</a><td> * Path for included scripts.<tr><td><a id="l678"></a><a href="#l678">678</a><td> * @type {string}<tr><td><a id="l679"></a><a href="#l679">679</a><td> */<tr><td><a id="l680"></a><a href="#l680">680</a><td>goog.basePath = &#39;&#39;;<tr><td><a id="l681"></a><a href="#l681">681</a><td><tr><td><a id="l682"></a><a href="#l682">682</a><td><tr><td><a id="l683"></a><a href="#l683">683</a><td>/**<tr><td><a id="l684"></a><a href="#l684">684</a><td> * A hook for overriding the base path.<tr><td><a id="l685"></a><a href="#l685">685</a><td> * @type {string|undefined}<tr><td><a id="l686"></a><a href="#l686">686</a><td> */<tr><td><a id="l687"></a><a href="#l687">687</a><td>goog.global.CLOSURE_BASE_PATH;<tr><td><a id="l688"></a><a href="#l688">688</a><td><tr><td><a id="l689"></a><a href="#l689">689</a><td><tr><td><a id="l690"></a><a href="#l690">690</a><td>/**<tr><td><a id="l691"></a><a href="#l691">691</a><td> * Whether to write out Closure&#39;s deps file. By default, the deps are written.<tr><td><a id="l692"></a><a href="#l692">692</a><td> * @type {boolean|undefined}<tr><td><a id="l693"></a><a href="#l693">693</a><td> */<tr><td><a id="l694"></a><a href="#l694">694</a><td>goog.global.CLOSURE_NO_DEPS;<tr><td><a id="l695"></a><a href="#l695">695</a><td><tr><td><a id="l696"></a><a href="#l696">696</a><td><tr><td><a id="l697"></a><a href="#l697">697</a><td>/**<tr><td><a id="l698"></a><a href="#l698">698</a><td> * A function to import a single script. This is meant to be overridden when<tr><td><a id="l699"></a><a href="#l699">699</a><td> * Closure is being run in non-HTML contexts, such as web workers. It&#39;s defined<tr><td><a id="l700"></a><a href="#l700">700</a><td> * in the global scope so that it can be set before base.js is loaded, which<tr><td><a id="l701"></a><a href="#l701">701</a><td> * allows deps.js to be imported properly.<tr><td><a id="l702"></a><a href="#l702">702</a><td> *<tr><td><a id="l703"></a><a href="#l703">703</a><td> * The function is passed the script source, which is a relative URI. It should<tr><td><a id="l704"></a><a href="#l704">704</a><td> * return true if the script was imported, false otherwise.<tr><td><a id="l705"></a><a href="#l705">705</a><td> * @type {(function(string): boolean)|undefined}<tr><td><a id="l706"></a><a href="#l706">706</a><td> */<tr><td><a id="l707"></a><a href="#l707">707</a><td>goog.global.CLOSURE_IMPORT_SCRIPT;<tr><td><a id="l708"></a><a href="#l708">708</a><td><tr><td><a id="l709"></a><a href="#l709">709</a><td><tr><td><a id="l710"></a><a href="#l710">710</a><td>/**<tr><td><a id="l711"></a><a href="#l711">711</a><td> * Null function used for default values of callbacks, etc.<tr><td><a id="l712"></a><a href="#l712">712</a><td> * @return {void} Nothing.<tr><td><a id="l713"></a><a href="#l713">713</a><td> */<tr><td><a id="l714"></a><a href="#l714">714</a><td>goog.nullFunction = function() {};<tr><td><a id="l715"></a><a href="#l715">715</a><td><tr><td><a id="l716"></a><a href="#l716">716</a><td><tr><td><a id="l717"></a><a href="#l717">717</a><td>/**<tr><td><a id="l718"></a><a href="#l718">718</a><td> * When defining a class Foo with an abstract method bar(), you can do:<tr><td><a id="l719"></a><a href="#l719">719</a><td> * Foo.prototype.bar = goog.abstractMethod<tr><td><a id="l720"></a><a href="#l720">720</a><td> *<tr><td><a id="l721"></a><a href="#l721">721</a><td> * Now if a subclass of Foo fails to override bar(), an error will be thrown<tr><td><a id="l722"></a><a href="#l722">722</a><td> * when bar() is invoked.<tr><td><a id="l723"></a><a href="#l723">723</a><td> *<tr><td><a id="l724"></a><a href="#l724">724</a><td> * Note: This does not take the name of the function to override as an argument<tr><td><a id="l725"></a><a href="#l725">725</a><td> * because that would make it more difficult to obfuscate our JavaScript code.<tr><td><a id="l726"></a><a href="#l726">726</a><td> *<tr><td><a id="l727"></a><a href="#l727">727</a><td> * @type {!Function}<tr><td><a id="l728"></a><a href="#l728">728</a><td> * @throws {Error} when invoked to indicate the method should be overridden.<tr><td><a id="l729"></a><a href="#l729">729</a><td> */<tr><td><a id="l730"></a><a href="#l730">730</a><td>goog.abstractMethod = function() {<tr><td><a id="l731"></a><a href="#l731">731</a><td>  throw Error(&#39;unimplemented abstract method&#39;);<tr><td><a id="l732"></a><a href="#l732">732</a><td>};<tr><td><a id="l733"></a><a href="#l733">733</a><td><tr><td><a id="l734"></a><a href="#l734">734</a><td><tr><td><a id="l735"></a><a href="#l735">735</a><td>/**<tr><td><a id="l736"></a><a href="#l736">736</a><td> * Adds a {@code getInstance} static method that always returns the same<tr><td><a id="l737"></a><a href="#l737">737</a><td> * instance object.<tr><td><a id="l738"></a><a href="#l738">738</a><td> * @param {!Function} ctor The constructor for the class to add the static<tr><td><a id="l739"></a><a href="#l739">739</a><td> *     method to.<tr><td><a id="l740"></a><a href="#l740">740</a><td> */<tr><td><a id="l741"></a><a href="#l741">741</a><td>goog.addSingletonGetter = function(ctor) {<tr><td><a id="l742"></a><a href="#l742">742</a><td>  ctor.getInstance = function() {<tr><td><a id="l743"></a><a href="#l743">743</a><td>    if (ctor.instance_) {<tr><td><a id="l744"></a><a href="#l744">744</a><td>      return ctor.instance_;<tr><td><a id="l745"></a><a href="#l745">745</a><td>    }<tr><td><a id="l746"></a><a href="#l746">746</a><td>    if (goog.DEBUG) {<tr><td><a id="l747"></a><a href="#l747">747</a><td>      // NOTE: JSCompiler can&#39;t optimize away Array#push.<tr><td><a id="l748"></a><a href="#l748">748</a><td>      goog.instantiatedSingletons_[goog.instantiatedSingletons_.length] = ctor;<tr><td><a id="l749"></a><a href="#l749">749</a><td>    }<tr><td><a id="l750"></a><a href="#l750">750</a><td>    return ctor.instance_ = new ctor;<tr><td><a id="l751"></a><a href="#l751">751</a><td>  };<tr><td><a id="l752"></a><a href="#l752">752</a><td>};<tr><td><a id="l753"></a><a href="#l753">753</a><td><tr><td><a id="l754"></a><a href="#l754">754</a><td><tr><td><a id="l755"></a><a href="#l755">755</a><td>/**<tr><td><a id="l756"></a><a href="#l756">756</a><td> * All singleton classes that have been instantiated, for testing. Don&#39;t read<tr><td><a id="l757"></a><a href="#l757">757</a><td> * it directly, use the {@code goog.testing.singleton} module. The compiler<tr><td><a id="l758"></a><a href="#l758">758</a><td> * removes this variable if unused.<tr><td><a id="l759"></a><a href="#l759">759</a><td> * @type {!Array&lt;!Function&gt;}<tr><td><a id="l760"></a><a href="#l760">760</a><td> * @private<tr><td><a id="l761"></a><a href="#l761">761</a><td> */<tr><td><a id="l762"></a><a href="#l762">762</a><td>goog.instantiatedSingletons_ = [];<tr><td><a id="l763"></a><a href="#l763">763</a><td><tr><td><a id="l764"></a><a href="#l764">764</a><td><tr><td><a id="l765"></a><a href="#l765">765</a><td>/**<tr><td><a id="l766"></a><a href="#l766">766</a><td> * @define {boolean} Whether to load goog.modules using {@code eval} when using<tr><td><a id="l767"></a><a href="#l767">767</a><td> * the debug loader.  This provides a better debugging experience as the<tr><td><a id="l768"></a><a href="#l768">768</a><td> * source is unmodified and can be edited using Chrome Workspaces or similar.<tr><td><a id="l769"></a><a href="#l769">769</a><td> * However in some environments the use of {@code eval} is banned<tr><td><a id="l770"></a><a href="#l770">770</a><td> * so we provide an alternative.<tr><td><a id="l771"></a><a href="#l771">771</a><td> */<tr><td><a id="l772"></a><a href="#l772">772</a><td>goog.define(&#39;goog.LOAD_MODULE_USING_EVAL&#39;, true);<tr><td><a id="l773"></a><a href="#l773">773</a><td><tr><td><a id="l774"></a><a href="#l774">774</a><td><tr><td><a id="l775"></a><a href="#l775">775</a><td>/**<tr><td><a id="l776"></a><a href="#l776">776</a><td> * @define {boolean} Whether the exports of goog.modules should be sealed when<tr><td><a id="l777"></a><a href="#l777">777</a><td> * possible.<tr><td><a id="l778"></a><a href="#l778">778</a><td> */<tr><td><a id="l779"></a><a href="#l779">779</a><td>goog.define(&#39;goog.SEAL_MODULE_EXPORTS&#39;, goog.DEBUG);<tr><td><a id="l780"></a><a href="#l780">780</a><td><tr><td><a id="l781"></a><a href="#l781">781</a><td><tr><td><a id="l782"></a><a href="#l782">782</a><td>/**<tr><td><a id="l783"></a><a href="#l783">783</a><td> * The registry of initialized modules:<tr><td><a id="l784"></a><a href="#l784">784</a><td> * the module identifier to module exports map.<tr><td><a id="l785"></a><a href="#l785">785</a><td> * @private @const {!Object&lt;string, ?&gt;}<tr><td><a id="l786"></a><a href="#l786">786</a><td> */<tr><td><a id="l787"></a><a href="#l787">787</a><td>goog.loadedModules_ = {};<tr><td><a id="l788"></a><a href="#l788">788</a><td><tr><td><a id="l789"></a><a href="#l789">789</a><td><tr><td><a id="l790"></a><a href="#l790">790</a><td>/**<tr><td><a id="l791"></a><a href="#l791">791</a><td> * True if goog.dependencies_ is available.<tr><td><a id="l792"></a><a href="#l792">792</a><td> * @const {boolean}<tr><td><a id="l793"></a><a href="#l793">793</a><td> */<tr><td><a id="l794"></a><a href="#l794">794</a><td>goog.DEPENDENCIES_ENABLED = !COMPILED &amp;&amp; goog.ENABLE_DEBUG_LOADER;<tr><td><a id="l795"></a><a href="#l795">795</a><td><tr><td><a id="l796"></a><a href="#l796">796</a><td><tr><td><a id="l797"></a><a href="#l797">797</a><td>if (goog.DEPENDENCIES_ENABLED) {<tr><td><a id="l798"></a><a href="#l798">798</a><td><tr><td><a id="l799"></a><a href="#l799">799</a><td>  /**<tr><td><a id="l800"></a><a href="#l800">800</a><td>   * This object is used to keep track of dependencies and other data that is<tr><td><a id="l801"></a><a href="#l801">801</a><td>   * used for loading scripts.<tr><td><a id="l802"></a><a href="#l802">802</a><td>   * @private<tr><td><a id="l803"></a><a href="#l803">803</a><td>   * @type {{<tr><td><a id="l804"></a><a href="#l804">804</a><td>   *   pathIsModule: !Object&lt;string, boolean&gt;,<tr><td><a id="l805"></a><a href="#l805">805</a><td>   *   nameToPath: !Object&lt;string, string&gt;,<tr><td><a id="l806"></a><a href="#l806">806</a><td>   *   requires: !Object&lt;string, !Object&lt;string, boolean&gt;&gt;,<tr><td><a id="l807"></a><a href="#l807">807</a><td>   *   visited: !Object&lt;string, boolean&gt;,<tr><td><a id="l808"></a><a href="#l808">808</a><td>   *   written: !Object&lt;string, boolean&gt;,<tr><td><a id="l809"></a><a href="#l809">809</a><td>   *   deferred: !Object&lt;string, string&gt;<tr><td><a id="l810"></a><a href="#l810">810</a><td>   * }}<tr><td><a id="l811"></a><a href="#l811">811</a><td>   */<tr><td><a id="l812"></a><a href="#l812">812</a><td>  goog.dependencies_ = {<tr><td><a id="l813"></a><a href="#l813">813</a><td>    pathIsModule: {}, // 1 to 1<tr><td><a id="l814"></a><a href="#l814">814</a><td><tr><td><a id="l815"></a><a href="#l815">815</a><td>    nameToPath: {}, // 1 to 1<tr><td><a id="l816"></a><a href="#l816">816</a><td><tr><td><a id="l817"></a><a href="#l817">817</a><td>    requires: {}, // 1 to many<tr><td><a id="l818"></a><a href="#l818">818</a><td><tr><td><a id="l819"></a><a href="#l819">819</a><td>    // Used when resolving dependencies to prevent us from visiting file twice.<tr><td><a id="l820"></a><a href="#l820">820</a><td>    visited: {},<tr><td><a id="l821"></a><a href="#l821">821</a><td><tr><td><a id="l822"></a><a href="#l822">822</a><td>    written: {}, // Used to keep track of script files we have written.<tr><td><a id="l823"></a><a href="#l823">823</a><td><tr><td><a id="l824"></a><a href="#l824">824</a><td>    deferred: {} // Used to track deferred module evaluations in old IEs<tr><td><a id="l825"></a><a href="#l825">825</a><td>  };<tr><td><a id="l826"></a><a href="#l826">826</a><td><tr><td><a id="l827"></a><a href="#l827">827</a><td><tr><td><a id="l828"></a><a href="#l828">828</a><td>  /**<tr><td><a id="l829"></a><a href="#l829">829</a><td>   * Tries to detect whether is in the context of an HTML document.<tr><td><a id="l830"></a><a href="#l830">830</a><td>   * @return {boolean} True if it looks like HTML document.<tr><td><a id="l831"></a><a href="#l831">831</a><td>   * @private<tr><td><a id="l832"></a><a href="#l832">832</a><td>   */<tr><td><a id="l833"></a><a href="#l833">833</a><td>  goog.inHtmlDocument_ = function() {<tr><td><a id="l834"></a><a href="#l834">834</a><td>    /** @type {Document} */<tr><td><a id="l835"></a><a href="#l835">835</a><td>    var doc = goog.global.document;<tr><td><a id="l836"></a><a href="#l836">836</a><td>    return doc != null &amp;&amp; &#39;write&#39; in doc;  // XULDocument misses write.<tr><td><a id="l837"></a><a href="#l837">837</a><td>  };<tr><td><a id="l838"></a><a href="#l838">838</a><td><tr><td><a id="l839"></a><a href="#l839">839</a><td><tr><td><a id="l840"></a><a href="#l840">840</a><td>  /**<tr><td><a id="l841"></a><a href="#l841">841</a><td>   * Tries to detect the base path of base.js script that bootstraps Closure.<tr><td><a id="l842"></a><a href="#l842">842</a><td>   * @private<tr><td><a id="l843"></a><a href="#l843">843</a><td>   */<tr><td><a id="l844"></a><a href="#l844">844</a><td>  goog.findBasePath_ = function() {<tr><td><a id="l845"></a><a href="#l845">845</a><td>    if (goog.isDef(goog.global.CLOSURE_BASE_PATH)) {<tr><td><a id="l846"></a><a href="#l846">846</a><td>      goog.basePath = goog.global.CLOSURE_BASE_PATH;<tr><td><a id="l847"></a><a href="#l847">847</a><td>      return;<tr><td><a id="l848"></a><a href="#l848">848</a><td>    } else if (!goog.inHtmlDocument_()) {<tr><td><a id="l849"></a><a href="#l849">849</a><td>      return;<tr><td><a id="l850"></a><a href="#l850">850</a><td>    }<tr><td><a id="l851"></a><a href="#l851">851</a><td>    /** @type {Document} */<tr><td><a id="l852"></a><a href="#l852">852</a><td>    var doc = goog.global.document;<tr><td><a id="l853"></a><a href="#l853">853</a><td>    var scripts = doc.getElementsByTagName(&#39;SCRIPT&#39;);<tr><td><a id="l854"></a><a href="#l854">854</a><td>    // Search backwards since the current script is in almost all cases the one<tr><td><a id="l855"></a><a href="#l855">855</a><td>    // that has base.js.<tr><td><a id="l856"></a><a href="#l856">856</a><td>    for (var i = scripts.length - 1; i &gt;= 0; --i) {<tr><td><a id="l857"></a><a href="#l857">857</a><td>      var script = /** @type {!HTMLScriptElement} */ (scripts[i]);<tr><td><a id="l858"></a><a href="#l858">858</a><td>      var src = script.src;<tr><td><a id="l859"></a><a href="#l859">859</a><td>      var qmark = src.lastIndexOf(&#39;?&#39;);<tr><td><a id="l860"></a><a href="#l860">860</a><td>      var l = qmark == -1 ? src.length : qmark;<tr><td><a id="l861"></a><a href="#l861">861</a><td>      if (src.substr(l - 7, 7) == &#39;base.js&#39;) {<tr><td><a id="l862"></a><a href="#l862">862</a><td>        goog.basePath = src.substr(0, l - 7);<tr><td><a id="l863"></a><a href="#l863">863</a><td>        return;<tr><td><a id="l864"></a><a href="#l864">864</a><td>      }<tr><td><a id="l865"></a><a href="#l865">865</a><td>    }<tr><td><a id="l866"></a><a href="#l866">866</a><td>  };<tr><td><a id="l867"></a><a href="#l867">867</a><td><tr><td><a id="l868"></a><a href="#l868">868</a><td><tr><td><a id="l869"></a><a href="#l869">869</a><td>  /**<tr><td><a id="l870"></a><a href="#l870">870</a><td>   * Imports a script if, and only if, that script hasn&#39;t already been imported.<tr><td><a id="l871"></a><a href="#l871">871</a><td>   * (Must be called at execution time)<tr><td><a id="l872"></a><a href="#l872">872</a><td>   * @param {string} src Script source.<tr><td><a id="l873"></a><a href="#l873">873</a><td>   * @param {string=} opt_sourceText The optionally source text to evaluate<tr><td><a id="l874"></a><a href="#l874">874</a><td>   * @private<tr><td><a id="l875"></a><a href="#l875">875</a><td>   */<tr><td><a id="l876"></a><a href="#l876">876</a><td>  goog.importScript_ = function(src, opt_sourceText) {<tr><td><a id="l877"></a><a href="#l877">877</a><td>    var importScript = goog.global.CLOSURE_IMPORT_SCRIPT ||<tr><td><a id="l878"></a><a href="#l878">878</a><td>        goog.writeScriptTag_;<tr><td><a id="l879"></a><a href="#l879">879</a><td>    if (importScript(src, opt_sourceText)) {<tr><td><a id="l880"></a><a href="#l880">880</a><td>      goog.dependencies_.written[src] = true;<tr><td><a id="l881"></a><a href="#l881">881</a><td>    }<tr><td><a id="l882"></a><a href="#l882">882</a><td>  };<tr><td><a id="l883"></a><a href="#l883">883</a><td><tr><td><a id="l884"></a><a href="#l884">884</a><td><tr><td><a id="l885"></a><a href="#l885">885</a><td>  /** @const @private {boolean} */<tr><td><a id="l886"></a><a href="#l886">886</a><td>  goog.IS_OLD_IE_ = !!(!goog.global.atob &amp;&amp; goog.global.document &amp;&amp;<tr><td><a id="l887"></a><a href="#l887">887</a><td>      goog.global.document.all);<tr><td><a id="l888"></a><a href="#l888">888</a><td><tr><td><a id="l889"></a><a href="#l889">889</a><td><tr><td><a id="l890"></a><a href="#l890">890</a><td>  /**<tr><td><a id="l891"></a><a href="#l891">891</a><td>   * Given a URL initiate retrieval and execution of the module.<tr><td><a id="l892"></a><a href="#l892">892</a><td>   * @param {string} src Script source URL.<tr><td><a id="l893"></a><a href="#l893">893</a><td>   * @private<tr><td><a id="l894"></a><a href="#l894">894</a><td>   */<tr><td><a id="l895"></a><a href="#l895">895</a><td>  goog.importModule_ = function(src) {<tr><td><a id="l896"></a><a href="#l896">896</a><td>    // In an attempt to keep browsers from timing out loading scripts using<tr><td><a id="l897"></a><a href="#l897">897</a><td>    // synchronous XHRs, put each load in its own script block.<tr><td><a id="l898"></a><a href="#l898">898</a><td>    var bootstrap = &#39;goog.retrieveAndExecModule_(&quot;&#39; + src + &#39;&quot;);&#39;;<tr><td><a id="l899"></a><a href="#l899">899</a><td><tr><td><a id="l900"></a><a href="#l900">900</a><td>    if (goog.importScript_(&#39;&#39;, bootstrap)) {<tr><td><a id="l901"></a><a href="#l901">901</a><td>      goog.dependencies_.written[src] = true;<tr><td><a id="l902"></a><a href="#l902">902</a><td>    }<tr><td><a id="l903"></a><a href="#l903">903</a><td>  };<tr><td><a id="l904"></a><a href="#l904">904</a><td><tr><td><a id="l905"></a><a href="#l905">905</a><td><tr><td><a id="l906"></a><a href="#l906">906</a><td>  /** @private {!Array&lt;string&gt;} */<tr><td><a id="l907"></a><a href="#l907">907</a><td>  goog.queuedModules_ = [];<tr><td><a id="l908"></a><a href="#l908">908</a><td><tr><td><a id="l909"></a><a href="#l909">909</a><td><tr><td><a id="l910"></a><a href="#l910">910</a><td>  /**<tr><td><a id="l911"></a><a href="#l911">911</a><td>   * Return an appropriate module text. Suitable to insert into<tr><td><a id="l912"></a><a href="#l912">912</a><td>   * a script tag (that is unescaped).<tr><td><a id="l913"></a><a href="#l913">913</a><td>   * @param {string} srcUrl<tr><td><a id="l914"></a><a href="#l914">914</a><td>   * @param {string} scriptText<tr><td><a id="l915"></a><a href="#l915">915</a><td>   * @return {string}<tr><td><a id="l916"></a><a href="#l916">916</a><td>   * @private<tr><td><a id="l917"></a><a href="#l917">917</a><td>   */<tr><td><a id="l918"></a><a href="#l918">918</a><td>  goog.wrapModule_ = function(srcUrl, scriptText) {<tr><td><a id="l919"></a><a href="#l919">919</a><td>    if (!goog.LOAD_MODULE_USING_EVAL || !goog.isDef(goog.global.JSON)) {<tr><td><a id="l920"></a><a href="#l920">920</a><td>      return &#39;&#39; +<tr><td><a id="l921"></a><a href="#l921">921</a><td>          &#39;goog.loadModule(function(exports) {&#39; +<tr><td><a id="l922"></a><a href="#l922">922</a><td>          &#39;&quot;use strict&quot;;&#39; +<tr><td><a id="l923"></a><a href="#l923">923</a><td>          scriptText +<tr><td><a id="l924"></a><a href="#l924">924</a><td>          &#39;\n&#39; + // terminate any trailing single line comment.<tr><td><a id="l925"></a><a href="#l925">925</a><td>          &#39;;return exports&#39; +<tr><td><a id="l926"></a><a href="#l926">926</a><td>          &#39;});&#39; +<tr><td><a id="l927"></a><a href="#l927">927</a><td>          &#39;\n//# sourceURL=&#39; + srcUrl + &#39;\n&#39;;<tr><td><a id="l928"></a><a href="#l928">928</a><td>    } else {<tr><td><a id="l929"></a><a href="#l929">929</a><td>      return &#39;&#39; +<tr><td><a id="l930"></a><a href="#l930">930</a><td>          &#39;goog.loadModule(&#39; +<tr><td><a id="l931"></a><a href="#l931">931</a><td>          goog.global.JSON.stringify(<tr><td><a id="l932"></a><a href="#l932">932</a><td>              scriptText + &#39;\n//# sourceURL=&#39; + srcUrl + &#39;\n&#39;) +<tr><td><a id="l933"></a><a href="#l933">933</a><td>          &#39;);&#39;;<tr><td><a id="l934"></a><a href="#l934">934</a><td>    }<tr><td><a id="l935"></a><a href="#l935">935</a><td>  };<tr><td><a id="l936"></a><a href="#l936">936</a><td><tr><td><a id="l937"></a><a href="#l937">937</a><td>  // On IE9 and earlier, it is necessary to handle<tr><td><a id="l938"></a><a href="#l938">938</a><td>  // deferred module loads. In later browsers, the<tr><td><a id="l939"></a><a href="#l939">939</a><td>  // code to be evaluated is simply inserted as a script<tr><td><a id="l940"></a><a href="#l940">940</a><td>  // block in the correct order. To eval deferred<tr><td><a id="l941"></a><a href="#l941">941</a><td>  // code at the right time, we piggy back on goog.require to call<tr><td><a id="l942"></a><a href="#l942">942</a><td>  // goog.maybeProcessDeferredDep_.<tr><td><a id="l943"></a><a href="#l943">943</a><td>  //<tr><td><a id="l944"></a><a href="#l944">944</a><td>  // The goog.requires are used both to bootstrap<tr><td><a id="l945"></a><a href="#l945">945</a><td>  // the loading process (when no deps are available) and<tr><td><a id="l946"></a><a href="#l946">946</a><td>  // declare that they should be available.<tr><td><a id="l947"></a><a href="#l947">947</a><td>  //<tr><td><a id="l948"></a><a href="#l948">948</a><td>  // Here we eval the sources, if all the deps are available<tr><td><a id="l949"></a><a href="#l949">949</a><td>  // either already eval&#39;d or goog.require&#39;d.  This will<tr><td><a id="l950"></a><a href="#l950">950</a><td>  // be the case when all the dependencies have already<tr><td><a id="l951"></a><a href="#l951">951</a><td>  // been loaded, and the dependent module is loaded.<tr><td><a id="l952"></a><a href="#l952">952</a><td>  //<tr><td><a id="l953"></a><a href="#l953">953</a><td>  // But this alone isn&#39;t sufficient because it is also<tr><td><a id="l954"></a><a href="#l954">954</a><td>  // necessary to handle the case where there is no root<tr><td><a id="l955"></a><a href="#l955">955</a><td>  // that is not deferred.  For that there we register for an event<tr><td><a id="l956"></a><a href="#l956">956</a><td>  // and trigger goog.loadQueuedModules_ handle any remaining deferred<tr><td><a id="l957"></a><a href="#l957">957</a><td>  // evaluations.<tr><td><a id="l958"></a><a href="#l958">958</a><td><tr><td><a id="l959"></a><a href="#l959">959</a><td>  /**<tr><td><a id="l960"></a><a href="#l960">960</a><td>   * Handle any remaining deferred goog.module evals.<tr><td><a id="l961"></a><a href="#l961">961</a><td>   * @private<tr><td><a id="l962"></a><a href="#l962">962</a><td>   */<tr><td><a id="l963"></a><a href="#l963">963</a><td>  goog.loadQueuedModules_ = function() {<tr><td><a id="l964"></a><a href="#l964">964</a><td>    var count = goog.queuedModules_.length;<tr><td><a id="l965"></a><a href="#l965">965</a><td>    if (count &gt; 0) {<tr><td><a id="l966"></a><a href="#l966">966</a><td>      var queue = goog.queuedModules_;<tr><td><a id="l967"></a><a href="#l967">967</a><td>      goog.queuedModules_ = [];<tr><td><a id="l968"></a><a href="#l968">968</a><td>      for (var i = 0; i &lt; count; i++) {<tr><td><a id="l969"></a><a href="#l969">969</a><td>        var path = queue[i];<tr><td><a id="l970"></a><a href="#l970">970</a><td>        goog.maybeProcessDeferredPath_(path);<tr><td><a id="l971"></a><a href="#l971">971</a><td>      }<tr><td><a id="l972"></a><a href="#l972">972</a><td>    }<tr><td><a id="l973"></a><a href="#l973">973</a><td>  };<tr><td><a id="l974"></a><a href="#l974">974</a><td><tr><td><a id="l975"></a><a href="#l975">975</a><td><tr><td><a id="l976"></a><a href="#l976">976</a><td>  /**<tr><td><a id="l977"></a><a href="#l977">977</a><td>   * Eval the named module if its dependencies are<tr><td><a id="l978"></a><a href="#l978">978</a><td>   * available.<tr><td><a id="l979"></a><a href="#l979">979</a><td>   * @param {string} name The module to load.<tr><td><a id="l980"></a><a href="#l980">980</a><td>   * @private<tr><td><a id="l981"></a><a href="#l981">981</a><td>   */<tr><td><a id="l982"></a><a href="#l982">982</a><td>  goog.maybeProcessDeferredDep_ = function(name) {<tr><td><a id="l983"></a><a href="#l983">983</a><td>    if (goog.isDeferredModule_(name) &amp;&amp;<tr><td><a id="l984"></a><a href="#l984">984</a><td>        goog.allDepsAreAvailable_(name)) {<tr><td><a id="l985"></a><a href="#l985">985</a><td>      var path = goog.getPathFromDeps_(name);<tr><td><a id="l986"></a><a href="#l986">986</a><td>      goog.maybeProcessDeferredPath_(goog.basePath + path);<tr><td><a id="l987"></a><a href="#l987">987</a><td>    }<tr><td><a id="l988"></a><a href="#l988">988</a><td>  };<tr><td><a id="l989"></a><a href="#l989">989</a><td><tr><td><a id="l990"></a><a href="#l990">990</a><td>  /**<tr><td><a id="l991"></a><a href="#l991">991</a><td>   * @param {string} name The module to check.<tr><td><a id="l992"></a><a href="#l992">992</a><td>   * @return {boolean} Whether the name represents a<tr><td><a id="l993"></a><a href="#l993">993</a><td>   *     module whose evaluation has been deferred.<tr><td><a id="l994"></a><a href="#l994">994</a><td>   * @private<tr><td><a id="l995"></a><a href="#l995">995</a><td>   */<tr><td><a id="l996"></a><a href="#l996">996</a><td>  goog.isDeferredModule_ = function(name) {<tr><td><a id="l997"></a><a href="#l997">997</a><td>    var path = goog.getPathFromDeps_(name);<tr><td><a id="l998"></a><a href="#l998">998</a><td>    if (path &amp;&amp; goog.dependencies_.pathIsModule[path]) {<tr><td><a id="l999"></a><a href="#l999">999</a><td>      var abspath = goog.basePath + path;<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td>      return (abspath) in goog.dependencies_.deferred;<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td>    }<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td>    return false;<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td>  };<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td><tr><td><a id="l1005"></a><a href="#l1005">1005</a><td>  /**<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td>   * @param {string} name The module to check.<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>   * @return {boolean} Whether the name represents a<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td>   *     module whose declared dependencies have all been loaded<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td>   *     (eval&#39;d or a deferred module load)<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td>   * @private<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td>   */<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td>  goog.allDepsAreAvailable_ = function(name) {<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td>    var path = goog.getPathFromDeps_(name);<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td>    if (path &amp;&amp; (path in goog.dependencies_.requires)) {<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>      for (var requireName in goog.dependencies_.requires[path]) {<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td>        if (!goog.isProvided_(requireName) &amp;&amp;<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td>            !goog.isDeferredModule_(requireName)) {<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td>          return false;<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td>        }<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td>      }<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>    }<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td>    return true;<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td>  };<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td><tr><td><a id="l1025"></a><a href="#l1025">1025</a><td><tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>  /**<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>   * @param {string} abspath<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>   * @private<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td>   */<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>  goog.maybeProcessDeferredPath_ = function(abspath) {<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td>    if (abspath in goog.dependencies_.deferred) {<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td>      var src = goog.dependencies_.deferred[abspath];<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>      delete goog.dependencies_.deferred[abspath];<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>      goog.globalEval(src);<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>    }<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>  };<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td><tr><td><a id="l1038"></a><a href="#l1038">1038</a><td><tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>  /**<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>   * Load a goog.module from the provided URL.  This is not a general purpose<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td>   * code loader and does not support late loading code, that is it should only<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td>   * be used during page load. This method exists to support unit tests and<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td>   * &quot;debug&quot; loaders that would otherwise have inserted script tags. Under the<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>   * hood this needs to use a synchronous XHR and is not recommeneded for<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td>   * production code.<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td>   *<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td>   * The module&#39;s goog.requires must have already been satisified; an exception<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>   * will be thrown if this is not the case. This assumption is that no<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td>   * &quot;deps.js&quot; file exists, so there is no way to discover and locate the<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>   * module-to-be-loaded&#39;s dependencies and no attempt is made to do so.<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td>   *<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td>   * There should only be one attempt to load a module.  If<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td>   * &quot;goog.loadModuleFromUrl&quot; is called for an already loaded module, an<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td>   * exception will be throw.<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td>   *<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td>   * @param {string} url The URL from which to attempt to load the goog.module.<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td>   */<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td>  goog.loadModuleFromUrl = function(url) {<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td>    // Because this executes synchronously, we don&#39;t need to do any additional<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td>    // bookkeeping. When &quot;goog.loadModule&quot; the namespace will be marked as<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td>    // having been provided which is sufficient.<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td>    goog.retrieveAndExecModule_(url);<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td>  };<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td><tr><td><a id="l1065"></a><a href="#l1065">1065</a><td><tr><td><a id="l1066"></a><a href="#l1066">1066</a><td>  /**<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>   * @param {function(?):?|string} moduleDef The module definition.<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td>   */<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td>  goog.loadModule = function(moduleDef) {<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td>    // NOTE: we allow function definitions to be either in the from<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td>    // of a string to eval (which keeps the original source intact) or<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td>    // in a eval forbidden environment (CSP) we allow a function definition<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td>    // which in its body must call {@code goog.module}, and return the exports<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>    // of the module.<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td>    var previousState = goog.moduleLoaderState_;<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td>    try {<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td>      goog.moduleLoaderState_ = {<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td>        moduleName: undefined,<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td>        declareLegacyNamespace: false<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>      };<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td>      var exports;<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td>      if (goog.isFunction(moduleDef)) {<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>        exports = moduleDef.call(goog.global, {});<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td>      } else if (goog.isString(moduleDef)) {<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td>        exports = goog.loadModuleFromSource_.call(goog.global, moduleDef);<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td>      } else {<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>        throw Error(&#39;Invalid module definition&#39;);<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>      }<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td><tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>      var moduleName = goog.moduleLoaderState_.moduleName;<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td>      if (!goog.isString(moduleName) || !moduleName) {<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td>        throw Error(&#39;Invalid module name \&quot;&#39; + moduleName + &#39;\&quot;&#39;);<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td>      }<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td><tr><td><a id="l1095"></a><a href="#l1095">1095</a><td>      // Don&#39;t seal legacy namespaces as they may be uses as a parent of<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td>      // another namespace<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>      if (goog.moduleLoaderState_.declareLegacyNamespace) {<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td>        goog.constructNamespace_(moduleName, exports);<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td>      } else if (goog.SEAL_MODULE_EXPORTS &amp;&amp; Object.seal) {<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>        Object.seal(exports);<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td>      }<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td><tr><td><a id="l1103"></a><a href="#l1103">1103</a><td>      goog.loadedModules_[moduleName] = exports;<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td>    } finally {<tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>      goog.moduleLoaderState_ = previousState;<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td>    }<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td>  };<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td><tr><td><a id="l1109"></a><a href="#l1109">1109</a><td><tr><td><a id="l1110"></a><a href="#l1110">1110</a><td>  /**<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td>   * @private @const {function(string):?}<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td>   *<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td>   * The new type inference warns because this function has no formal<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td>   * parameters, but its jsdoc says that it takes one argument.<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td>   * (The argument is used via arguments[0], but NTI does not detect this.)<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td>   * @suppress {newCheckTypes}<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td>   */<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td>  goog.loadModuleFromSource_ = function() {<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td>    // NOTE: we avoid declaring parameters or local variables here to avoid<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td>    // masking globals or leaking values into the module definition.<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td>    &#39;use strict&#39;;<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td>    var exports = {};<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td>    eval(arguments[0]);<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td>    return exports;<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td>  };<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td><tr><td><a id="l1127"></a><a href="#l1127">1127</a><td><tr><td><a id="l1128"></a><a href="#l1128">1128</a><td>  /**<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td>   * Writes a new script pointing to {@code src} directly into the DOM.<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td>   *<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td>   * NOTE: This method is not CSP-compliant. @see goog.appendScriptSrcNode_ for<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td>   * the fallback mechanism.<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td>   *<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td>   * @param {string} src The script URL.<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td>   * @private<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td>   */<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td>  goog.writeScriptSrcNode_ = function(src) {<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td>    goog.global.document.write(<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>        &#39;&lt;script type=&quot;text/javascript&quot; src=&quot;&#39; + src + &#39;&quot;&gt;&lt;/&#39; + &#39;script&gt;&#39;);<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td>  };<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td><tr><td><a id="l1142"></a><a href="#l1142">1142</a><td><tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>  /**<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td>   * Appends a new script node to the DOM using a CSP-compliant mechanism. This<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>   * method exists as a fallback for document.write (which is not allowed in a<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>   * strict CSP context, e.g., Chrome apps).<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td>   *<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td>   * NOTE: This method is not analogous to using document.write to insert a<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td>   * &lt;script&gt; tag; specifically, the user agent will execute a script added by<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>   * document.write immediately after the current script block finishes<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td>   * executing, whereas the DOM-appended script node will not be executed until<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td>   * the entire document is parsed and executed. That is to say, this script is<tr><td><a id="l1153"></a><a href="#l1153">1153</a><td>   * added to the end of the script execution queue.<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td>   *<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td>   * The page must not attempt to call goog.required entities until after the<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td>   * document has loaded, e.g., in or after the window.onload callback.<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td>   *<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td>   * @param {string} src The script URL.<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td>   * @private<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td>   */<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td>  goog.appendScriptSrcNode_ = function(src) {<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td>    /** @type {Document} */<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td>    var doc = goog.global.document;<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td>    var scriptEl = /** @type {HTMLScriptElement} */ (<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>        doc.createElement(&#39;script&#39;));<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td>    scriptEl.type = &#39;text/javascript&#39;;<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>    scriptEl.src = src;<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td>    scriptEl.defer = false;<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td>    scriptEl.async = false;<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td>    doc.head.appendChild(scriptEl);<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td>  };<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td><tr><td><a id="l1173"></a><a href="#l1173">1173</a><td><tr><td><a id="l1174"></a><a href="#l1174">1174</a><td>  /**<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td>   * The default implementation of the import function. Writes a script tag to<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td>   * import the script.<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td>   *<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td>   * @param {string} src The script url.<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td>   * @param {string=} opt_sourceText The optionally source text to evaluate<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td>   * @return {boolean} True if the script was imported, false otherwise.<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td>   * @private<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td>   */<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td>  goog.writeScriptTag_ = function(src, opt_sourceText) {<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td>    if (goog.inHtmlDocument_()) {<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td>      /** @type {Document} */<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td>      var doc = goog.global.document;<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td><tr><td><a id="l1188"></a><a href="#l1188">1188</a><td>      // If the user tries to require a new symbol after document load,<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td>      // something has gone terribly wrong. Doing a document.write would<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td>      // wipe out the page. This does not apply to the CSP-compliant method<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td>      // of writing script tags.<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>      if (!goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING &amp;&amp;<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>          doc.readyState == &#39;complete&#39;) {<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td>        // Certain test frameworks load base.js multiple times, which tries<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>        // to write deps.js each time. If that happens, just fail silently.<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td>        // These frameworks wipe the page between each load of base.js, so this<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td>        // is OK.<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td>        var isDeps = /\bdeps.js$/.test(src);<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td>        if (isDeps) {<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td>          return false;<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td>        } else {<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td>          throw Error(&#39;Cannot write &quot;&#39; + src + &#39;&quot; after document load&#39;);<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td>        }<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td>      }<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td><tr><td><a id="l1206"></a><a href="#l1206">1206</a><td>      var isOldIE = goog.IS_OLD_IE_;<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td><tr><td><a id="l1208"></a><a href="#l1208">1208</a><td>      if (opt_sourceText === undefined) {<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td>        if (!isOldIE) {<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td>          if (goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING) {<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td>            goog.appendScriptSrcNode_(src);<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td>          } else {<tr><td><a id="l1213"></a><a href="#l1213">1213</a><td>            goog.writeScriptSrcNode_(src);<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td>          }<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td>        } else {<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td>          var state = &quot; onreadystatechange=&#39;goog.onScriptLoad_(this, &quot; +<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td>              ++goog.lastNonModuleScriptIndex_ + &quot;)&#39; &quot;;<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td>          doc.write(<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td>              &#39;&lt;script type=&quot;text/javascript&quot; src=&quot;&#39; +<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td>                  src + &#39;&quot;&#39; + state + &#39;&gt;&lt;/&#39; + &#39;script&gt;&#39;);<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td>        }<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>      } else {<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>        doc.write(<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td>            &#39;&lt;script type=&quot;text/javascript&quot;&gt;&#39; +<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td>            opt_sourceText +<tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>            &#39;&lt;/&#39; + &#39;script&gt;&#39;);<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td>      }<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td>      return true;<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td>    } else {<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td>      return false;<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td>    }<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td>  };<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td><tr><td><a id="l1234"></a><a href="#l1234">1234</a><td><tr><td><a id="l1235"></a><a href="#l1235">1235</a><td>  /** @private {number} */<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td>  goog.lastNonModuleScriptIndex_ = 0;<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td><tr><td><a id="l1238"></a><a href="#l1238">1238</a><td><tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>  /**<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td>   * A readystatechange handler for legacy IE<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td>   * @param {!HTMLScriptElement} script<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td>   * @param {number} scriptIndex<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td>   * @return {boolean}<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td>   * @private<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td>   */<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td>  goog.onScriptLoad_ = function(script, scriptIndex) {<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>    // for now load the modules when we reach the last script,<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>    // later allow more inter-mingling.<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>    if (script.readyState == &#39;complete&#39; &amp;&amp;<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>        goog.lastNonModuleScriptIndex_ == scriptIndex) {<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>      goog.loadQueuedModules_();<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td>    }<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>    return true;<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td>  };<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td><tr><td><a id="l1256"></a><a href="#l1256">1256</a><td>  /**<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td>   * Resolves dependencies based on the dependencies added using addDependency<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td>   * and calls importScript_ in the correct order.<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td>   * @param {string} pathToLoad The path from which to start discovering<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td>   *     dependencies.<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td>   * @private<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td>   */<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td>  goog.writeScripts_ = function(pathToLoad) {<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>    /** @type {!Array&lt;string&gt;} The scripts we need to write this time. */<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>    var scripts = [];<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>    var seenScript = {};<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>    var deps = goog.dependencies_;<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td><tr><td><a id="l1269"></a><a href="#l1269">1269</a><td>    /** @param {string} path */<tr><td><a id="l1270"></a><a href="#l1270">1270</a><td>    function visitNode(path) {<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td>      if (path in deps.written) {<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td>        return;<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td>      }<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td><tr><td><a id="l1275"></a><a href="#l1275">1275</a><td>      // We have already visited this one. We can get here if we have cyclic<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td>      // dependencies.<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td>      if (path in deps.visited) {<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>        return;<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>      }<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td><tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>      deps.visited[path] = true;<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td><tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>      if (path in deps.requires) {<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>        for (var requireName in deps.requires[path]) {<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>          // If the required name is defined, we assume that it was already<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>          // bootstrapped by other means.<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>          if (!goog.isProvided_(requireName)) {<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td>            if (requireName in deps.nameToPath) {<tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>              visitNode(deps.nameToPath[requireName]);<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td>            } else {<tr><td><a id="l1291"></a><a href="#l1291">1291</a><td>              throw Error(&#39;Undefined nameToPath for &#39; + requireName);<tr><td><a id="l1292"></a><a href="#l1292">1292</a><td>            }<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td>          }<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td>        }<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td>      }<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td><tr><td><a id="l1297"></a><a href="#l1297">1297</a><td>      if (!(path in seenScript)) {<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td>        seenScript[path] = true;<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td>        scripts.push(path);<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td>      }<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>    }<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td><tr><td><a id="l1303"></a><a href="#l1303">1303</a><td>    visitNode(pathToLoad);<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td><tr><td><a id="l1305"></a><a href="#l1305">1305</a><td>    // record that we are going to load all these scripts.<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td>    for (var i = 0; i &lt; scripts.length; i++) {<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td>      var path = scripts[i];<tr><td><a id="l1308"></a><a href="#l1308">1308</a><td>      goog.dependencies_.written[path] = true;<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td>    }<tr><td><a id="l1310"></a><a href="#l1310">1310</a><td><tr><td><a id="l1311"></a><a href="#l1311">1311</a><td>    // If a module is loaded synchronously then we need to<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td>    // clear the current inModuleLoader value, and restore it when we are<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td>    // done loading the current &quot;requires&quot;.<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td>    var moduleState = goog.moduleLoaderState_;<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td>    goog.moduleLoaderState_ = null;<tr><td><a id="l1316"></a><a href="#l1316">1316</a><td><tr><td><a id="l1317"></a><a href="#l1317">1317</a><td>    for (var i = 0; i &lt; scripts.length; i++) {<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td>      var path = scripts[i];<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td>      if (path) {<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td>        if (!deps.pathIsModule[path]) {<tr><td><a id="l1321"></a><a href="#l1321">1321</a><td>          goog.importScript_(goog.basePath + path);<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td>        } else {<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td>          goog.importModule_(goog.basePath + path);<tr><td><a id="l1324"></a><a href="#l1324">1324</a><td>        }<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td>      } else {<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td>        goog.moduleLoaderState_ = moduleState;<tr><td><a id="l1327"></a><a href="#l1327">1327</a><td>        throw Error(&#39;Undefined script input&#39;);<tr><td><a id="l1328"></a><a href="#l1328">1328</a><td>      }<tr><td><a id="l1329"></a><a href="#l1329">1329</a><td>    }<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td><tr><td><a id="l1331"></a><a href="#l1331">1331</a><td>    // restore the current &quot;module loading state&quot;<tr><td><a id="l1332"></a><a href="#l1332">1332</a><td>    goog.moduleLoaderState_ = moduleState;<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td>  };<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td><tr><td><a id="l1335"></a><a href="#l1335">1335</a><td><tr><td><a id="l1336"></a><a href="#l1336">1336</a><td>  /**<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td>   * Looks at the dependency rules and tries to determine the script file that<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td>   * fulfills a particular rule.<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td>   * @param {string} rule In the form goog.namespace.Class or project.script.<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td>   * @return {?string} Url corresponding to the rule, or null.<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td>   * @private<tr><td><a id="l1342"></a><a href="#l1342">1342</a><td>   */<tr><td><a id="l1343"></a><a href="#l1343">1343</a><td>  goog.getPathFromDeps_ = function(rule) {<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td>    if (rule in goog.dependencies_.nameToPath) {<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td>      return goog.dependencies_.nameToPath[rule];<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td>    } else {<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td>      return null;<tr><td><a id="l1348"></a><a href="#l1348">1348</a><td>    }<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td>  };<tr><td><a id="l1350"></a><a href="#l1350">1350</a><td><tr><td><a id="l1351"></a><a href="#l1351">1351</a><td>  goog.findBasePath_();<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td><tr><td><a id="l1353"></a><a href="#l1353">1353</a><td>  // Allow projects to manage the deps files themselves.<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td>  if (!goog.global.CLOSURE_NO_DEPS) {<tr><td><a id="l1355"></a><a href="#l1355">1355</a><td>    goog.importScript_(goog.basePath + &#39;deps.js&#39;);<tr><td><a id="l1356"></a><a href="#l1356">1356</a><td>  }<tr><td><a id="l1357"></a><a href="#l1357">1357</a><td>}<tr><td><a id="l1358"></a><a href="#l1358">1358</a><td><tr><td><a id="l1359"></a><a href="#l1359">1359</a><td><tr><td><a id="l1360"></a><a href="#l1360">1360</a><td>/**<tr><td><a id="l1361"></a><a href="#l1361">1361</a><td> * Normalize a file path by removing redundant &quot;..&quot; and extraneous &quot;.&quot; file<tr><td><a id="l1362"></a><a href="#l1362">1362</a><td> * path components.<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td> * @param {string} path<tr><td><a id="l1364"></a><a href="#l1364">1364</a><td> * @return {string}<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td> * @private<tr><td><a id="l1366"></a><a href="#l1366">1366</a><td> */<tr><td><a id="l1367"></a><a href="#l1367">1367</a><td>goog.normalizePath_ = function(path) {<tr><td><a id="l1368"></a><a href="#l1368">1368</a><td>  var components = path.split(&#39;/&#39;);<tr><td><a id="l1369"></a><a href="#l1369">1369</a><td>  var i = 0;<tr><td><a id="l1370"></a><a href="#l1370">1370</a><td>  while (i &lt; components.length) {<tr><td><a id="l1371"></a><a href="#l1371">1371</a><td>    if (components[i] == &#39;.&#39;) {<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td>      components.splice(i, 1);<tr><td><a id="l1373"></a><a href="#l1373">1373</a><td>    } else if (i &amp;&amp; components[i] == &#39;..&#39; &amp;&amp;<tr><td><a id="l1374"></a><a href="#l1374">1374</a><td>        components[i - 1] &amp;&amp; components[i - 1] != &#39;..&#39;) {<tr><td><a id="l1375"></a><a href="#l1375">1375</a><td>      components.splice(--i, 2);<tr><td><a id="l1376"></a><a href="#l1376">1376</a><td>    } else {<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td>      i++;<tr><td><a id="l1378"></a><a href="#l1378">1378</a><td>    }<tr><td><a id="l1379"></a><a href="#l1379">1379</a><td>  }<tr><td><a id="l1380"></a><a href="#l1380">1380</a><td>  return components.join(&#39;/&#39;);<tr><td><a id="l1381"></a><a href="#l1381">1381</a><td>};<tr><td><a id="l1382"></a><a href="#l1382">1382</a><td><tr><td><a id="l1383"></a><a href="#l1383">1383</a><td><tr><td><a id="l1384"></a><a href="#l1384">1384</a><td>/**<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td> * Loads file by synchronous XHR. Should not be used in production environments.<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td> * @param {string} src Source URL.<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td> * @return {string} File contents.<tr><td><a id="l1388"></a><a href="#l1388">1388</a><td> * @private<tr><td><a id="l1389"></a><a href="#l1389">1389</a><td> */<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td>goog.loadFileSync_ = function(src) {<tr><td><a id="l1391"></a><a href="#l1391">1391</a><td>  if (goog.global.CLOSURE_LOAD_FILE_SYNC) {<tr><td><a id="l1392"></a><a href="#l1392">1392</a><td>    return goog.global.CLOSURE_LOAD_FILE_SYNC(src);<tr><td><a id="l1393"></a><a href="#l1393">1393</a><td>  } else {<tr><td><a id="l1394"></a><a href="#l1394">1394</a><td>    /** @type {XMLHttpRequest} */<tr><td><a id="l1395"></a><a href="#l1395">1395</a><td>    var xhr = new goog.global[&#39;XMLHttpRequest&#39;]();<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td>    xhr.open(&#39;get&#39;, src, false);<tr><td><a id="l1397"></a><a href="#l1397">1397</a><td>    xhr.send();<tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>    return xhr.responseText;<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td>  }<tr><td><a id="l1400"></a><a href="#l1400">1400</a><td>};<tr><td><a id="l1401"></a><a href="#l1401">1401</a><td><tr><td><a id="l1402"></a><a href="#l1402">1402</a><td><tr><td><a id="l1403"></a><a href="#l1403">1403</a><td>/**<tr><td><a id="l1404"></a><a href="#l1404">1404</a><td> * Retrieve and execute a module.<tr><td><a id="l1405"></a><a href="#l1405">1405</a><td> * @param {string} src Script source URL.<tr><td><a id="l1406"></a><a href="#l1406">1406</a><td> * @private<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td> */<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td>goog.retrieveAndExecModule_ = function(src) {<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td>  if (!COMPILED) {<tr><td><a id="l1410"></a><a href="#l1410">1410</a><td>    // The full but non-canonicalized URL for later use.<tr><td><a id="l1411"></a><a href="#l1411">1411</a><td>    var originalPath = src;<tr><td><a id="l1412"></a><a href="#l1412">1412</a><td>    // Canonicalize the path, removing any /./ or /../ since Chrome&#39;s debugging<tr><td><a id="l1413"></a><a href="#l1413">1413</a><td>    // console doesn&#39;t auto-canonicalize XHR loads as it does &lt;script&gt; srcs.<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td>    src = goog.normalizePath_(src);<tr><td><a id="l1415"></a><a href="#l1415">1415</a><td><tr><td><a id="l1416"></a><a href="#l1416">1416</a><td>    var importScript = goog.global.CLOSURE_IMPORT_SCRIPT ||<tr><td><a id="l1417"></a><a href="#l1417">1417</a><td>        goog.writeScriptTag_;<tr><td><a id="l1418"></a><a href="#l1418">1418</a><td><tr><td><a id="l1419"></a><a href="#l1419">1419</a><td>    var scriptText = goog.loadFileSync_(src);<tr><td><a id="l1420"></a><a href="#l1420">1420</a><td><tr><td><a id="l1421"></a><a href="#l1421">1421</a><td>    if (scriptText != null) {<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td>      var execModuleScript = goog.wrapModule_(src, scriptText);<tr><td><a id="l1423"></a><a href="#l1423">1423</a><td>      var isOldIE = goog.IS_OLD_IE_;<tr><td><a id="l1424"></a><a href="#l1424">1424</a><td>      if (isOldIE) {<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td>        goog.dependencies_.deferred[originalPath] = execModuleScript;<tr><td><a id="l1426"></a><a href="#l1426">1426</a><td>        goog.queuedModules_.push(originalPath);<tr><td><a id="l1427"></a><a href="#l1427">1427</a><td>      } else {<tr><td><a id="l1428"></a><a href="#l1428">1428</a><td>        importScript(src, execModuleScript);<tr><td><a id="l1429"></a><a href="#l1429">1429</a><td>      }<tr><td><a id="l1430"></a><a href="#l1430">1430</a><td>    } else {<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td>      throw new Error(&#39;load of &#39; + src + &#39;failed&#39;);<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td>    }<tr><td><a id="l1433"></a><a href="#l1433">1433</a><td>  }<tr><td><a id="l1434"></a><a href="#l1434">1434</a><td>};<tr><td><a id="l1435"></a><a href="#l1435">1435</a><td><tr><td><a id="l1436"></a><a href="#l1436">1436</a><td><tr><td><a id="l1437"></a><a href="#l1437">1437</a><td>//==============================================================================<tr><td><a id="l1438"></a><a href="#l1438">1438</a><td>// Language Enhancements<tr><td><a id="l1439"></a><a href="#l1439">1439</a><td>//==============================================================================<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td><tr><td><a id="l1441"></a><a href="#l1441">1441</a><td><tr><td><a id="l1442"></a><a href="#l1442">1442</a><td>/**<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td> * This is a &quot;fixed&quot; version of the typeof operator.  It differs from the typeof<tr><td><a id="l1444"></a><a href="#l1444">1444</a><td> * operator in such a way that null returns &#39;null&#39; and arrays return &#39;array&#39;.<tr><td><a id="l1445"></a><a href="#l1445">1445</a><td> * @param {?} value The value to get the type of.<tr><td><a id="l1446"></a><a href="#l1446">1446</a><td> * @return {string} The name of the type.<tr><td><a id="l1447"></a><a href="#l1447">1447</a><td> */<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td>goog.typeOf = function(value) {<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td>  var s = typeof value;<tr><td><a id="l1450"></a><a href="#l1450">1450</a><td>  if (s == &#39;object&#39;) {<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td>    if (value) {<tr><td><a id="l1452"></a><a href="#l1452">1452</a><td>      // Check these first, so we can avoid calling Object.prototype.toString if<tr><td><a id="l1453"></a><a href="#l1453">1453</a><td>      // possible.<tr><td><a id="l1454"></a><a href="#l1454">1454</a><td>      //<tr><td><a id="l1455"></a><a href="#l1455">1455</a><td>      // IE improperly marshals tyepof across execution contexts, but a<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td>      // cross-context object will still return false for &quot;instanceof Object&quot;.<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td>      if (value instanceof Array) {<tr><td><a id="l1458"></a><a href="#l1458">1458</a><td>        return &#39;array&#39;;<tr><td><a id="l1459"></a><a href="#l1459">1459</a><td>      } else if (value instanceof Object) {<tr><td><a id="l1460"></a><a href="#l1460">1460</a><td>        return s;<tr><td><a id="l1461"></a><a href="#l1461">1461</a><td>      }<tr><td><a id="l1462"></a><a href="#l1462">1462</a><td><tr><td><a id="l1463"></a><a href="#l1463">1463</a><td>      // HACK: In order to use an Object prototype method on the arbitrary<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td>      //   value, the compiler requires the value be cast to type Object,<tr><td><a id="l1465"></a><a href="#l1465">1465</a><td>      //   even though the ECMA spec explicitly allows it.<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td>      var className = Object.prototype.toString.call(<tr><td><a id="l1467"></a><a href="#l1467">1467</a><td>          /** @type {!Object} */ (value));<tr><td><a id="l1468"></a><a href="#l1468">1468</a><td>      // In Firefox 3.6, attempting to access iframe window objects&#39; length<tr><td><a id="l1469"></a><a href="#l1469">1469</a><td>      // property throws an NS_ERROR_FAILURE, so we need to special-case it<tr><td><a id="l1470"></a><a href="#l1470">1470</a><td>      // here.<tr><td><a id="l1471"></a><a href="#l1471">1471</a><td>      if (className == &#39;[object Window]&#39;) {<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td>        return &#39;object&#39;;<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td>      }<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td><tr><td><a id="l1475"></a><a href="#l1475">1475</a><td>      // We cannot always use constructor == Array or instanceof Array because<tr><td><a id="l1476"></a><a href="#l1476">1476</a><td>      // different frames have different Array objects. In IE6, if the iframe<tr><td><a id="l1477"></a><a href="#l1477">1477</a><td>      // where the array was created is destroyed, the array loses its<tr><td><a id="l1478"></a><a href="#l1478">1478</a><td>      // prototype. Then dereferencing val.splice here throws an exception, so<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td>      // we can&#39;t use goog.isFunction. Calling typeof directly returns &#39;unknown&#39;<tr><td><a id="l1480"></a><a href="#l1480">1480</a><td>      // so that will work. In this case, this function will return false and<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td>      // most array functions will still work because the array is still<tr><td><a id="l1482"></a><a href="#l1482">1482</a><td>      // array-like (supports length and []) even though it has lost its<tr><td><a id="l1483"></a><a href="#l1483">1483</a><td>      // prototype.<tr><td><a id="l1484"></a><a href="#l1484">1484</a><td>      // Mark Miller noticed that Object.prototype.toString<tr><td><a id="l1485"></a><a href="#l1485">1485</a><td>      // allows access to the unforgeable [[Class]] property.<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td>      //  15.2.4.2 Object.prototype.toString ( )<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td>      //  When the toString method is called, the following steps are taken:<tr><td><a id="l1488"></a><a href="#l1488">1488</a><td>      //      1. Get the [[Class]] property of this object.<tr><td><a id="l1489"></a><a href="#l1489">1489</a><td>      //      2. Compute a string value by concatenating the three strings<tr><td><a id="l1490"></a><a href="#l1490">1490</a><td>      //         &quot;[object &quot;, Result(1), and &quot;]&quot;.<tr><td><a id="l1491"></a><a href="#l1491">1491</a><td>      //      3. Return Result(2).<tr><td><a id="l1492"></a><a href="#l1492">1492</a><td>      // and this behavior survives the destruction of the execution context.<tr><td><a id="l1493"></a><a href="#l1493">1493</a><td>      if ((className == &#39;[object Array]&#39; ||<tr><td><a id="l1494"></a><a href="#l1494">1494</a><td>           // In IE all non value types are wrapped as objects across window<tr><td><a id="l1495"></a><a href="#l1495">1495</a><td>           // boundaries (not iframe though) so we have to do object detection<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td>           // for this edge case.<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td>           typeof value.length == &#39;number&#39; &amp;&amp;<tr><td><a id="l1498"></a><a href="#l1498">1498</a><td>           typeof value.splice != &#39;undefined&#39; &amp;&amp;<tr><td><a id="l1499"></a><a href="#l1499">1499</a><td>           typeof value.propertyIsEnumerable != &#39;undefined&#39; &amp;&amp;<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td>           !value.propertyIsEnumerable(&#39;splice&#39;)<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td><tr><td><a id="l1502"></a><a href="#l1502">1502</a><td>          )) {<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td>        return &#39;array&#39;;<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td>      }<tr><td><a id="l1505"></a><a href="#l1505">1505</a><td>      // HACK: There is still an array case that fails.<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td>      //     function ArrayImpostor() {}<tr><td><a id="l1507"></a><a href="#l1507">1507</a><td>      //     ArrayImpostor.prototype = [];<tr><td><a id="l1508"></a><a href="#l1508">1508</a><td>      //     var impostor = new ArrayImpostor;<tr><td><a id="l1509"></a><a href="#l1509">1509</a><td>      // this can be fixed by getting rid of the fast path<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td>      // (value instanceof Array) and solely relying on<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td>      // (value &amp;&amp; Object.prototype.toString.vall(value) === &#39;[object Array]&#39;)<tr><td><a id="l1512"></a><a href="#l1512">1512</a><td>      // but that would require many more function calls and is not warranted<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td>      // unless closure code is receiving objects from untrusted sources.<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td><tr><td><a id="l1515"></a><a href="#l1515">1515</a><td>      // IE in cross-window calls does not correctly marshal the function type<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>      // (it appears just as an object) so we cannot use just typeof val ==<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td>      // &#39;function&#39;. However, if the object has a call property, it is a<tr><td><a id="l1518"></a><a href="#l1518">1518</a><td>      // function.<tr><td><a id="l1519"></a><a href="#l1519">1519</a><td>      if ((className == &#39;[object Function]&#39; ||<tr><td><a id="l1520"></a><a href="#l1520">1520</a><td>          typeof value.call != &#39;undefined&#39; &amp;&amp;<tr><td><a id="l1521"></a><a href="#l1521">1521</a><td>          typeof value.propertyIsEnumerable != &#39;undefined&#39; &amp;&amp;<tr><td><a id="l1522"></a><a href="#l1522">1522</a><td>          !value.propertyIsEnumerable(&#39;call&#39;))) {<tr><td><a id="l1523"></a><a href="#l1523">1523</a><td>        return &#39;function&#39;;<tr><td><a id="l1524"></a><a href="#l1524">1524</a><td>      }<tr><td><a id="l1525"></a><a href="#l1525">1525</a><td><tr><td><a id="l1526"></a><a href="#l1526">1526</a><td>    } else {<tr><td><a id="l1527"></a><a href="#l1527">1527</a><td>      return &#39;null&#39;;<tr><td><a id="l1528"></a><a href="#l1528">1528</a><td>    }<tr><td><a id="l1529"></a><a href="#l1529">1529</a><td><tr><td><a id="l1530"></a><a href="#l1530">1530</a><td>  } else if (s == &#39;function&#39; &amp;&amp; typeof value.call == &#39;undefined&#39;) {<tr><td><a id="l1531"></a><a href="#l1531">1531</a><td>    // In Safari typeof nodeList returns &#39;function&#39;, and on Firefox typeof<tr><td><a id="l1532"></a><a href="#l1532">1532</a><td>    // behaves similarly for HTML{Applet,Embed,Object}, Elements and RegExps. We<tr><td><a id="l1533"></a><a href="#l1533">1533</a><td>    // would like to return object for those and we can detect an invalid<tr><td><a id="l1534"></a><a href="#l1534">1534</a><td>    // function by making sure that the function object has a call method.<tr><td><a id="l1535"></a><a href="#l1535">1535</a><td>    return &#39;object&#39;;<tr><td><a id="l1536"></a><a href="#l1536">1536</a><td>  }<tr><td><a id="l1537"></a><a href="#l1537">1537</a><td>  return s;<tr><td><a id="l1538"></a><a href="#l1538">1538</a><td>};<tr><td><a id="l1539"></a><a href="#l1539">1539</a><td><tr><td><a id="l1540"></a><a href="#l1540">1540</a><td><tr><td><a id="l1541"></a><a href="#l1541">1541</a><td>/**<tr><td><a id="l1542"></a><a href="#l1542">1542</a><td> * Returns true if the specified value is null.<tr><td><a id="l1543"></a><a href="#l1543">1543</a><td> * @param {?} val Variable to test.<tr><td><a id="l1544"></a><a href="#l1544">1544</a><td> * @return {boolean} Whether variable is null.<tr><td><a id="l1545"></a><a href="#l1545">1545</a><td> */<tr><td><a id="l1546"></a><a href="#l1546">1546</a><td>goog.isNull = function(val) {<tr><td><a id="l1547"></a><a href="#l1547">1547</a><td>  return val === null;<tr><td><a id="l1548"></a><a href="#l1548">1548</a><td>};<tr><td><a id="l1549"></a><a href="#l1549">1549</a><td><tr><td><a id="l1550"></a><a href="#l1550">1550</a><td><tr><td><a id="l1551"></a><a href="#l1551">1551</a><td>/**<tr><td><a id="l1552"></a><a href="#l1552">1552</a><td> * Returns true if the specified value is defined and not null.<tr><td><a id="l1553"></a><a href="#l1553">1553</a><td> * @param {?} val Variable to test.<tr><td><a id="l1554"></a><a href="#l1554">1554</a><td> * @return {boolean} Whether variable is defined and not null.<tr><td><a id="l1555"></a><a href="#l1555">1555</a><td> */<tr><td><a id="l1556"></a><a href="#l1556">1556</a><td>goog.isDefAndNotNull = function(val) {<tr><td><a id="l1557"></a><a href="#l1557">1557</a><td>  // Note that undefined == null.<tr><td><a id="l1558"></a><a href="#l1558">1558</a><td>  return val != null;<tr><td><a id="l1559"></a><a href="#l1559">1559</a><td>};<tr><td><a id="l1560"></a><a href="#l1560">1560</a><td><tr><td><a id="l1561"></a><a href="#l1561">1561</a><td><tr><td><a id="l1562"></a><a href="#l1562">1562</a><td>/**<tr><td><a id="l1563"></a><a href="#l1563">1563</a><td> * Returns true if the specified value is an array.<tr><td><a id="l1564"></a><a href="#l1564">1564</a><td> * @param {?} val Variable to test.<tr><td><a id="l1565"></a><a href="#l1565">1565</a><td> * @return {boolean} Whether variable is an array.<tr><td><a id="l1566"></a><a href="#l1566">1566</a><td> */<tr><td><a id="l1567"></a><a href="#l1567">1567</a><td>goog.isArray = function(val) {<tr><td><a id="l1568"></a><a href="#l1568">1568</a><td>  return goog.typeOf(val) == &#39;array&#39;;<tr><td><a id="l1569"></a><a href="#l1569">1569</a><td>};<tr><td><a id="l1570"></a><a href="#l1570">1570</a><td><tr><td><a id="l1571"></a><a href="#l1571">1571</a><td><tr><td><a id="l1572"></a><a href="#l1572">1572</a><td>/**<tr><td><a id="l1573"></a><a href="#l1573">1573</a><td> * Returns true if the object looks like an array. To qualify as array like<tr><td><a id="l1574"></a><a href="#l1574">1574</a><td> * the value needs to be either a NodeList or an object with a Number length<tr><td><a id="l1575"></a><a href="#l1575">1575</a><td> * property. As a special case, a function value is not array like, because its<tr><td><a id="l1576"></a><a href="#l1576">1576</a><td> * length property is fixed to correspond to the number of expected arguments.<tr><td><a id="l1577"></a><a href="#l1577">1577</a><td> * @param {?} val Variable to test.<tr><td><a id="l1578"></a><a href="#l1578">1578</a><td> * @return {boolean} Whether variable is an array.<tr><td><a id="l1579"></a><a href="#l1579">1579</a><td> */<tr><td><a id="l1580"></a><a href="#l1580">1580</a><td>goog.isArrayLike = function(val) {<tr><td><a id="l1581"></a><a href="#l1581">1581</a><td>  var type = goog.typeOf(val);<tr><td><a id="l1582"></a><a href="#l1582">1582</a><td>  // We do not use goog.isObject here in order to exclude function values.<tr><td><a id="l1583"></a><a href="#l1583">1583</a><td>  return type == &#39;array&#39; || type == &#39;object&#39; &amp;&amp; typeof val.length == &#39;number&#39;;<tr><td><a id="l1584"></a><a href="#l1584">1584</a><td>};<tr><td><a id="l1585"></a><a href="#l1585">1585</a><td><tr><td><a id="l1586"></a><a href="#l1586">1586</a><td><tr><td><a id="l1587"></a><a href="#l1587">1587</a><td>/**<tr><td><a id="l1588"></a><a href="#l1588">1588</a><td> * Returns true if the object looks like a Date. To qualify as Date-like the<tr><td><a id="l1589"></a><a href="#l1589">1589</a><td> * value needs to be an object and have a getFullYear() function.<tr><td><a id="l1590"></a><a href="#l1590">1590</a><td> * @param {?} val Variable to test.<tr><td><a id="l1591"></a><a href="#l1591">1591</a><td> * @return {boolean} Whether variable is a like a Date.<tr><td><a id="l1592"></a><a href="#l1592">1592</a><td> */<tr><td><a id="l1593"></a><a href="#l1593">1593</a><td>goog.isDateLike = function(val) {<tr><td><a id="l1594"></a><a href="#l1594">1594</a><td>  return goog.isObject(val) &amp;&amp; typeof val.getFullYear == &#39;function&#39;;<tr><td><a id="l1595"></a><a href="#l1595">1595</a><td>};<tr><td><a id="l1596"></a><a href="#l1596">1596</a><td><tr><td><a id="l1597"></a><a href="#l1597">1597</a><td><tr><td><a id="l1598"></a><a href="#l1598">1598</a><td>/**<tr><td><a id="l1599"></a><a href="#l1599">1599</a><td> * Returns true if the specified value is a string.<tr><td><a id="l1600"></a><a href="#l1600">1600</a><td> * @param {?} val Variable to test.<tr><td><a id="l1601"></a><a href="#l1601">1601</a><td> * @return {boolean} Whether variable is a string.<tr><td><a id="l1602"></a><a href="#l1602">1602</a><td> */<tr><td><a id="l1603"></a><a href="#l1603">1603</a><td>goog.isString = function(val) {<tr><td><a id="l1604"></a><a href="#l1604">1604</a><td>  return typeof val == &#39;string&#39;;<tr><td><a id="l1605"></a><a href="#l1605">1605</a><td>};<tr><td><a id="l1606"></a><a href="#l1606">1606</a><td><tr><td><a id="l1607"></a><a href="#l1607">1607</a><td><tr><td><a id="l1608"></a><a href="#l1608">1608</a><td>/**<tr><td><a id="l1609"></a><a href="#l1609">1609</a><td> * Returns true if the specified value is a boolean.<tr><td><a id="l1610"></a><a href="#l1610">1610</a><td> * @param {?} val Variable to test.<tr><td><a id="l1611"></a><a href="#l1611">1611</a><td> * @return {boolean} Whether variable is boolean.<tr><td><a id="l1612"></a><a href="#l1612">1612</a><td> */<tr><td><a id="l1613"></a><a href="#l1613">1613</a><td>goog.isBoolean = function(val) {<tr><td><a id="l1614"></a><a href="#l1614">1614</a><td>  return typeof val == &#39;boolean&#39;;<tr><td><a id="l1615"></a><a href="#l1615">1615</a><td>};<tr><td><a id="l1616"></a><a href="#l1616">1616</a><td><tr><td><a id="l1617"></a><a href="#l1617">1617</a><td><tr><td><a id="l1618"></a><a href="#l1618">1618</a><td>/**<tr><td><a id="l1619"></a><a href="#l1619">1619</a><td> * Returns true if the specified value is a number.<tr><td><a id="l1620"></a><a href="#l1620">1620</a><td> * @param {?} val Variable to test.<tr><td><a id="l1621"></a><a href="#l1621">1621</a><td> * @return {boolean} Whether variable is a number.<tr><td><a id="l1622"></a><a href="#l1622">1622</a><td> */<tr><td><a id="l1623"></a><a href="#l1623">1623</a><td>goog.isNumber = function(val) {<tr><td><a id="l1624"></a><a href="#l1624">1624</a><td>  return typeof val == &#39;number&#39;;<tr><td><a id="l1625"></a><a href="#l1625">1625</a><td>};<tr><td><a id="l1626"></a><a href="#l1626">1626</a><td><tr><td><a id="l1627"></a><a href="#l1627">1627</a><td><tr><td><a id="l1628"></a><a href="#l1628">1628</a><td>/**<tr><td><a id="l1629"></a><a href="#l1629">1629</a><td> * Returns true if the specified value is a function.<tr><td><a id="l1630"></a><a href="#l1630">1630</a><td> * @param {?} val Variable to test.<tr><td><a id="l1631"></a><a href="#l1631">1631</a><td> * @return {boolean} Whether variable is a function.<tr><td><a id="l1632"></a><a href="#l1632">1632</a><td> */<tr><td><a id="l1633"></a><a href="#l1633">1633</a><td>goog.isFunction = function(val) {<tr><td><a id="l1634"></a><a href="#l1634">1634</a><td>  return goog.typeOf(val) == &#39;function&#39;;<tr><td><a id="l1635"></a><a href="#l1635">1635</a><td>};<tr><td><a id="l1636"></a><a href="#l1636">1636</a><td><tr><td><a id="l1637"></a><a href="#l1637">1637</a><td><tr><td><a id="l1638"></a><a href="#l1638">1638</a><td>/**<tr><td><a id="l1639"></a><a href="#l1639">1639</a><td> * Returns true if the specified value is an object.  This includes arrays and<tr><td><a id="l1640"></a><a href="#l1640">1640</a><td> * functions.<tr><td><a id="l1641"></a><a href="#l1641">1641</a><td> * @param {?} val Variable to test.<tr><td><a id="l1642"></a><a href="#l1642">1642</a><td> * @return {boolean} Whether variable is an object.<tr><td><a id="l1643"></a><a href="#l1643">1643</a><td> */<tr><td><a id="l1644"></a><a href="#l1644">1644</a><td>goog.isObject = function(val) {<tr><td><a id="l1645"></a><a href="#l1645">1645</a><td>  var type = typeof val;<tr><td><a id="l1646"></a><a href="#l1646">1646</a><td>  return type == &#39;object&#39; &amp;&amp; val != null || type == &#39;function&#39;;<tr><td><a id="l1647"></a><a href="#l1647">1647</a><td>  // return Object(val) === val also works, but is slower, especially if val is<tr><td><a id="l1648"></a><a href="#l1648">1648</a><td>  // not an object.<tr><td><a id="l1649"></a><a href="#l1649">1649</a><td>};<tr><td><a id="l1650"></a><a href="#l1650">1650</a><td><tr><td><a id="l1651"></a><a href="#l1651">1651</a><td><tr><td><a id="l1652"></a><a href="#l1652">1652</a><td>/**<tr><td><a id="l1653"></a><a href="#l1653">1653</a><td> * Gets a unique ID for an object. This mutates the object so that further calls<tr><td><a id="l1654"></a><a href="#l1654">1654</a><td> * with the same object as a parameter returns the same value. The unique ID is<tr><td><a id="l1655"></a><a href="#l1655">1655</a><td> * guaranteed to be unique across the current session amongst objects that are<tr><td><a id="l1656"></a><a href="#l1656">1656</a><td> * passed into {@code getUid}. There is no guarantee that the ID is unique or<tr><td><a id="l1657"></a><a href="#l1657">1657</a><td> * consistent across sessions. It is unsafe to generate unique ID for function<tr><td><a id="l1658"></a><a href="#l1658">1658</a><td> * prototypes.<tr><td><a id="l1659"></a><a href="#l1659">1659</a><td> *<tr><td><a id="l1660"></a><a href="#l1660">1660</a><td> * @param {Object} obj The object to get the unique ID for.<tr><td><a id="l1661"></a><a href="#l1661">1661</a><td> * @return {number} The unique ID for the object.<tr><td><a id="l1662"></a><a href="#l1662">1662</a><td> */<tr><td><a id="l1663"></a><a href="#l1663">1663</a><td>goog.getUid = function(obj) {<tr><td><a id="l1664"></a><a href="#l1664">1664</a><td>  // TODO(arv): Make the type stricter, do not accept null.<tr><td><a id="l1665"></a><a href="#l1665">1665</a><td><tr><td><a id="l1666"></a><a href="#l1666">1666</a><td>  // In Opera window.hasOwnProperty exists but always returns false so we avoid<tr><td><a id="l1667"></a><a href="#l1667">1667</a><td>  // using it. As a consequence the unique ID generated for BaseClass.prototype<tr><td><a id="l1668"></a><a href="#l1668">1668</a><td>  // and SubClass.prototype will be the same.<tr><td><a id="l1669"></a><a href="#l1669">1669</a><td>  return obj[goog.UID_PROPERTY_] ||<tr><td><a id="l1670"></a><a href="#l1670">1670</a><td>      (obj[goog.UID_PROPERTY_] = ++goog.uidCounter_);<tr><td><a id="l1671"></a><a href="#l1671">1671</a><td>};<tr><td><a id="l1672"></a><a href="#l1672">1672</a><td><tr><td><a id="l1673"></a><a href="#l1673">1673</a><td><tr><td><a id="l1674"></a><a href="#l1674">1674</a><td>/**<tr><td><a id="l1675"></a><a href="#l1675">1675</a><td> * Whether the given object is already assigned a unique ID.<tr><td><a id="l1676"></a><a href="#l1676">1676</a><td> *<tr><td><a id="l1677"></a><a href="#l1677">1677</a><td> * This does not modify the object.<tr><td><a id="l1678"></a><a href="#l1678">1678</a><td> *<tr><td><a id="l1679"></a><a href="#l1679">1679</a><td> * @param {!Object} obj The object to check.<tr><td><a id="l1680"></a><a href="#l1680">1680</a><td> * @return {boolean} Whether there is an assigned unique id for the object.<tr><td><a id="l1681"></a><a href="#l1681">1681</a><td> */<tr><td><a id="l1682"></a><a href="#l1682">1682</a><td>goog.hasUid = function(obj) {<tr><td><a id="l1683"></a><a href="#l1683">1683</a><td>  return !!obj[goog.UID_PROPERTY_];<tr><td><a id="l1684"></a><a href="#l1684">1684</a><td>};<tr><td><a id="l1685"></a><a href="#l1685">1685</a><td><tr><td><a id="l1686"></a><a href="#l1686">1686</a><td><tr><td><a id="l1687"></a><a href="#l1687">1687</a><td>/**<tr><td><a id="l1688"></a><a href="#l1688">1688</a><td> * Removes the unique ID from an object. This is useful if the object was<tr><td><a id="l1689"></a><a href="#l1689">1689</a><td> * previously mutated using {@code goog.getUid} in which case the mutation is<tr><td><a id="l1690"></a><a href="#l1690">1690</a><td> * undone.<tr><td><a id="l1691"></a><a href="#l1691">1691</a><td> * @param {Object} obj The object to remove the unique ID field from.<tr><td><a id="l1692"></a><a href="#l1692">1692</a><td> */<tr><td><a id="l1693"></a><a href="#l1693">1693</a><td>goog.removeUid = function(obj) {<tr><td><a id="l1694"></a><a href="#l1694">1694</a><td>  // TODO(arv): Make the type stricter, do not accept null.<tr><td><a id="l1695"></a><a href="#l1695">1695</a><td><tr><td><a id="l1696"></a><a href="#l1696">1696</a><td>  // In IE, DOM nodes are not instances of Object and throw an exception if we<tr><td><a id="l1697"></a><a href="#l1697">1697</a><td>  // try to delete.  Instead we try to use removeAttribute.<tr><td><a id="l1698"></a><a href="#l1698">1698</a><td>  if (&#39;removeAttribute&#39; in /** @type {!Object} */ (obj)) {<tr><td><a id="l1699"></a><a href="#l1699">1699</a><td>    obj.removeAttribute(goog.UID_PROPERTY_);<tr><td><a id="l1700"></a><a href="#l1700">1700</a><td>  }<tr><td><a id="l1701"></a><a href="#l1701">1701</a><td>  /** @preserveTry */<tr><td><a id="l1702"></a><a href="#l1702">1702</a><td>  try {<tr><td><a id="l1703"></a><a href="#l1703">1703</a><td>    delete obj[goog.UID_PROPERTY_];<tr><td><a id="l1704"></a><a href="#l1704">1704</a><td>  } catch (ex) {<tr><td><a id="l1705"></a><a href="#l1705">1705</a><td>  }<tr><td><a id="l1706"></a><a href="#l1706">1706</a><td>};<tr><td><a id="l1707"></a><a href="#l1707">1707</a><td><tr><td><a id="l1708"></a><a href="#l1708">1708</a><td><tr><td><a id="l1709"></a><a href="#l1709">1709</a><td>/**<tr><td><a id="l1710"></a><a href="#l1710">1710</a><td> * Name for unique ID property. Initialized in a way to help avoid collisions<tr><td><a id="l1711"></a><a href="#l1711">1711</a><td> * with other closure JavaScript on the same page.<tr><td><a id="l1712"></a><a href="#l1712">1712</a><td> * @type {string}<tr><td><a id="l1713"></a><a href="#l1713">1713</a><td> * @private<tr><td><a id="l1714"></a><a href="#l1714">1714</a><td> */<tr><td><a id="l1715"></a><a href="#l1715">1715</a><td>goog.UID_PROPERTY_ = &#39;closure_uid_&#39; + ((Math.random() * 1e9) &gt;&gt;&gt; 0);<tr><td><a id="l1716"></a><a href="#l1716">1716</a><td><tr><td><a id="l1717"></a><a href="#l1717">1717</a><td><tr><td><a id="l1718"></a><a href="#l1718">1718</a><td>/**<tr><td><a id="l1719"></a><a href="#l1719">1719</a><td> * Counter for UID.<tr><td><a id="l1720"></a><a href="#l1720">1720</a><td> * @type {number}<tr><td><a id="l1721"></a><a href="#l1721">1721</a><td> * @private<tr><td><a id="l1722"></a><a href="#l1722">1722</a><td> */<tr><td><a id="l1723"></a><a href="#l1723">1723</a><td>goog.uidCounter_ = 0;<tr><td><a id="l1724"></a><a href="#l1724">1724</a><td><tr><td><a id="l1725"></a><a href="#l1725">1725</a><td><tr><td><a id="l1726"></a><a href="#l1726">1726</a><td>/**<tr><td><a id="l1727"></a><a href="#l1727">1727</a><td> * Adds a hash code field to an object. The hash code is unique for the<tr><td><a id="l1728"></a><a href="#l1728">1728</a><td> * given object.<tr><td><a id="l1729"></a><a href="#l1729">1729</a><td> * @param {Object} obj The object to get the hash code for.<tr><td><a id="l1730"></a><a href="#l1730">1730</a><td> * @return {number} The hash code for the object.<tr><td><a id="l1731"></a><a href="#l1731">1731</a><td> * @deprecated Use goog.getUid instead.<tr><td><a id="l1732"></a><a href="#l1732">1732</a><td> */<tr><td><a id="l1733"></a><a href="#l1733">1733</a><td>goog.getHashCode = goog.getUid;<tr><td><a id="l1734"></a><a href="#l1734">1734</a><td><tr><td><a id="l1735"></a><a href="#l1735">1735</a><td><tr><td><a id="l1736"></a><a href="#l1736">1736</a><td>/**<tr><td><a id="l1737"></a><a href="#l1737">1737</a><td> * Removes the hash code field from an object.<tr><td><a id="l1738"></a><a href="#l1738">1738</a><td> * @param {Object} obj The object to remove the field from.<tr><td><a id="l1739"></a><a href="#l1739">1739</a><td> * @deprecated Use goog.removeUid instead.<tr><td><a id="l1740"></a><a href="#l1740">1740</a><td> */<tr><td><a id="l1741"></a><a href="#l1741">1741</a><td>goog.removeHashCode = goog.removeUid;<tr><td><a id="l1742"></a><a href="#l1742">1742</a><td><tr><td><a id="l1743"></a><a href="#l1743">1743</a><td><tr><td><a id="l1744"></a><a href="#l1744">1744</a><td>/**<tr><td><a id="l1745"></a><a href="#l1745">1745</a><td> * Clones a value. The input may be an Object, Array, or basic type. Objects and<tr><td><a id="l1746"></a><a href="#l1746">1746</a><td> * arrays will be cloned recursively.<tr><td><a id="l1747"></a><a href="#l1747">1747</a><td> *<tr><td><a id="l1748"></a><a href="#l1748">1748</a><td> * WARNINGS:<tr><td><a id="l1749"></a><a href="#l1749">1749</a><td> * &lt;code&gt;goog.cloneObject&lt;/code&gt; does not detect reference loops. Objects that<tr><td><a id="l1750"></a><a href="#l1750">1750</a><td> * refer to themselves will cause infinite recursion.<tr><td><a id="l1751"></a><a href="#l1751">1751</a><td> *<tr><td><a id="l1752"></a><a href="#l1752">1752</a><td> * &lt;code&gt;goog.cloneObject&lt;/code&gt; is unaware of unique identifiers, and copies<tr><td><a id="l1753"></a><a href="#l1753">1753</a><td> * UIDs created by &lt;code&gt;getUid&lt;/code&gt; into cloned results.<tr><td><a id="l1754"></a><a href="#l1754">1754</a><td> *<tr><td><a id="l1755"></a><a href="#l1755">1755</a><td> * @param {*} obj The value to clone.<tr><td><a id="l1756"></a><a href="#l1756">1756</a><td> * @return {*} A clone of the input value.<tr><td><a id="l1757"></a><a href="#l1757">1757</a><td> * @deprecated goog.cloneObject is unsafe. Prefer the goog.object methods.<tr><td><a id="l1758"></a><a href="#l1758">1758</a><td> */<tr><td><a id="l1759"></a><a href="#l1759">1759</a><td>goog.cloneObject = function(obj) {<tr><td><a id="l1760"></a><a href="#l1760">1760</a><td>  var type = goog.typeOf(obj);<tr><td><a id="l1761"></a><a href="#l1761">1761</a><td>  if (type == &#39;object&#39; || type == &#39;array&#39;) {<tr><td><a id="l1762"></a><a href="#l1762">1762</a><td>    if (obj.clone) {<tr><td><a id="l1763"></a><a href="#l1763">1763</a><td>      return obj.clone();<tr><td><a id="l1764"></a><a href="#l1764">1764</a><td>    }<tr><td><a id="l1765"></a><a href="#l1765">1765</a><td>    var clone = type == &#39;array&#39; ? [] : {};<tr><td><a id="l1766"></a><a href="#l1766">1766</a><td>    for (var key in obj) {<tr><td><a id="l1767"></a><a href="#l1767">1767</a><td>      clone[key] = goog.cloneObject(obj[key]);<tr><td><a id="l1768"></a><a href="#l1768">1768</a><td>    }<tr><td><a id="l1769"></a><a href="#l1769">1769</a><td>    return clone;<tr><td><a id="l1770"></a><a href="#l1770">1770</a><td>  }<tr><td><a id="l1771"></a><a href="#l1771">1771</a><td><tr><td><a id="l1772"></a><a href="#l1772">1772</a><td>  return obj;<tr><td><a id="l1773"></a><a href="#l1773">1773</a><td>};<tr><td><a id="l1774"></a><a href="#l1774">1774</a><td><tr><td><a id="l1775"></a><a href="#l1775">1775</a><td><tr><td><a id="l1776"></a><a href="#l1776">1776</a><td>/**<tr><td><a id="l1777"></a><a href="#l1777">1777</a><td> * A native implementation of goog.bind.<tr><td><a id="l1778"></a><a href="#l1778">1778</a><td> * @param {Function} fn A function to partially apply.<tr><td><a id="l1779"></a><a href="#l1779">1779</a><td> * @param {Object|undefined} selfObj Specifies the object which this should<tr><td><a id="l1780"></a><a href="#l1780">1780</a><td> *     point to when the function is run.<tr><td><a id="l1781"></a><a href="#l1781">1781</a><td> * @param {...*} var_args Additional arguments that are partially applied to the<tr><td><a id="l1782"></a><a href="#l1782">1782</a><td> *     function.<tr><td><a id="l1783"></a><a href="#l1783">1783</a><td> * @return {!Function} A partially-applied form of the function bind() was<tr><td><a id="l1784"></a><a href="#l1784">1784</a><td> *     invoked as a method of.<tr><td><a id="l1785"></a><a href="#l1785">1785</a><td> * @private<tr><td><a id="l1786"></a><a href="#l1786">1786</a><td> * @suppress {deprecated} The compiler thinks that Function.prototype.bind is<tr><td><a id="l1787"></a><a href="#l1787">1787</a><td> *     deprecated because some people have declared a pure-JS version.<tr><td><a id="l1788"></a><a href="#l1788">1788</a><td> *     Only the pure-JS version is truly deprecated.<tr><td><a id="l1789"></a><a href="#l1789">1789</a><td> */<tr><td><a id="l1790"></a><a href="#l1790">1790</a><td>goog.bindNative_ = function(fn, selfObj, var_args) {<tr><td><a id="l1791"></a><a href="#l1791">1791</a><td>  return /** @type {!Function} */ (fn.call.apply(fn.bind, arguments));<tr><td><a id="l1792"></a><a href="#l1792">1792</a><td>};<tr><td><a id="l1793"></a><a href="#l1793">1793</a><td><tr><td><a id="l1794"></a><a href="#l1794">1794</a><td><tr><td><a id="l1795"></a><a href="#l1795">1795</a><td>/**<tr><td><a id="l1796"></a><a href="#l1796">1796</a><td> * A pure-JS implementation of goog.bind.<tr><td><a id="l1797"></a><a href="#l1797">1797</a><td> * @param {Function} fn A function to partially apply.<tr><td><a id="l1798"></a><a href="#l1798">1798</a><td> * @param {Object|undefined} selfObj Specifies the object which this should<tr><td><a id="l1799"></a><a href="#l1799">1799</a><td> *     point to when the function is run.<tr><td><a id="l1800"></a><a href="#l1800">1800</a><td> * @param {...*} var_args Additional arguments that are partially applied to the<tr><td><a id="l1801"></a><a href="#l1801">1801</a><td> *     function.<tr><td><a id="l1802"></a><a href="#l1802">1802</a><td> * @return {!Function} A partially-applied form of the function bind() was<tr><td><a id="l1803"></a><a href="#l1803">1803</a><td> *     invoked as a method of.<tr><td><a id="l1804"></a><a href="#l1804">1804</a><td> * @private<tr><td><a id="l1805"></a><a href="#l1805">1805</a><td> */<tr><td><a id="l1806"></a><a href="#l1806">1806</a><td>goog.bindJs_ = function(fn, selfObj, var_args) {<tr><td><a id="l1807"></a><a href="#l1807">1807</a><td>  if (!fn) {<tr><td><a id="l1808"></a><a href="#l1808">1808</a><td>    throw new Error();<tr><td><a id="l1809"></a><a href="#l1809">1809</a><td>  }<tr><td><a id="l1810"></a><a href="#l1810">1810</a><td><tr><td><a id="l1811"></a><a href="#l1811">1811</a><td>  if (arguments.length &gt; 2) {<tr><td><a id="l1812"></a><a href="#l1812">1812</a><td>    var boundArgs = Array.prototype.slice.call(arguments, 2);<tr><td><a id="l1813"></a><a href="#l1813">1813</a><td>    return function() {<tr><td><a id="l1814"></a><a href="#l1814">1814</a><td>      // Prepend the bound arguments to the current arguments.<tr><td><a id="l1815"></a><a href="#l1815">1815</a><td>      var newArgs = Array.prototype.slice.call(arguments);<tr><td><a id="l1816"></a><a href="#l1816">1816</a><td>      Array.prototype.unshift.apply(newArgs, boundArgs);<tr><td><a id="l1817"></a><a href="#l1817">1817</a><td>      return fn.apply(selfObj, newArgs);<tr><td><a id="l1818"></a><a href="#l1818">1818</a><td>    };<tr><td><a id="l1819"></a><a href="#l1819">1819</a><td><tr><td><a id="l1820"></a><a href="#l1820">1820</a><td>  } else {<tr><td><a id="l1821"></a><a href="#l1821">1821</a><td>    return function() {<tr><td><a id="l1822"></a><a href="#l1822">1822</a><td>      return fn.apply(selfObj, arguments);<tr><td><a id="l1823"></a><a href="#l1823">1823</a><td>    };<tr><td><a id="l1824"></a><a href="#l1824">1824</a><td>  }<tr><td><a id="l1825"></a><a href="#l1825">1825</a><td>};<tr><td><a id="l1826"></a><a href="#l1826">1826</a><td><tr><td><a id="l1827"></a><a href="#l1827">1827</a><td><tr><td><a id="l1828"></a><a href="#l1828">1828</a><td>/**<tr><td><a id="l1829"></a><a href="#l1829">1829</a><td> * Partially applies this function to a particular &#39;this object&#39; and zero or<tr><td><a id="l1830"></a><a href="#l1830">1830</a><td> * more arguments. The result is a new function with some arguments of the first<tr><td><a id="l1831"></a><a href="#l1831">1831</a><td> * function pre-filled and the value of this &#39;pre-specified&#39;.<tr><td><a id="l1832"></a><a href="#l1832">1832</a><td> *<tr><td><a id="l1833"></a><a href="#l1833">1833</a><td> * Remaining arguments specified at call-time are appended to the pre-specified<tr><td><a id="l1834"></a><a href="#l1834">1834</a><td> * ones.<tr><td><a id="l1835"></a><a href="#l1835">1835</a><td> *<tr><td><a id="l1836"></a><a href="#l1836">1836</a><td> * Also see: {@link #partial}.<tr><td><a id="l1837"></a><a href="#l1837">1837</a><td> *<tr><td><a id="l1838"></a><a href="#l1838">1838</a><td> * Usage:<tr><td><a id="l1839"></a><a href="#l1839">1839</a><td> * &lt;pre&gt;var barMethBound = goog.bind(myFunction, myObj, &#39;arg1&#39;, &#39;arg2&#39;);<tr><td><a id="l1840"></a><a href="#l1840">1840</a><td> * barMethBound(&#39;arg3&#39;, &#39;arg4&#39;);&lt;/pre&gt;<tr><td><a id="l1841"></a><a href="#l1841">1841</a><td> *<tr><td><a id="l1842"></a><a href="#l1842">1842</a><td> * @param {?function(this:T, ...)} fn A function to partially apply.<tr><td><a id="l1843"></a><a href="#l1843">1843</a><td> * @param {T} selfObj Specifies the object which this should point to when the<tr><td><a id="l1844"></a><a href="#l1844">1844</a><td> *     function is run.<tr><td><a id="l1845"></a><a href="#l1845">1845</a><td> * @param {...*} var_args Additional arguments that are partially applied to the<tr><td><a id="l1846"></a><a href="#l1846">1846</a><td> *     function.<tr><td><a id="l1847"></a><a href="#l1847">1847</a><td> * @return {!Function} A partially-applied form of the function goog.bind() was<tr><td><a id="l1848"></a><a href="#l1848">1848</a><td> *     invoked as a method of.<tr><td><a id="l1849"></a><a href="#l1849">1849</a><td> * @template T<tr><td><a id="l1850"></a><a href="#l1850">1850</a><td> * @suppress {deprecated} See above.<tr><td><a id="l1851"></a><a href="#l1851">1851</a><td> */<tr><td><a id="l1852"></a><a href="#l1852">1852</a><td>goog.bind = function(fn, selfObj, var_args) {<tr><td><a id="l1853"></a><a href="#l1853">1853</a><td>  // TODO(nicksantos): narrow the type signature.<tr><td><a id="l1854"></a><a href="#l1854">1854</a><td>  if (Function.prototype.bind &amp;&amp;<tr><td><a id="l1855"></a><a href="#l1855">1855</a><td>      // NOTE(nicksantos): Somebody pulled base.js into the default Chrome<tr><td><a id="l1856"></a><a href="#l1856">1856</a><td>      // extension environment. This means that for Chrome extensions, they get<tr><td><a id="l1857"></a><a href="#l1857">1857</a><td>      // the implementation of Function.prototype.bind that calls goog.bind<tr><td><a id="l1858"></a><a href="#l1858">1858</a><td>      // instead of the native one. Even worse, we don&#39;t want to introduce a<tr><td><a id="l1859"></a><a href="#l1859">1859</a><td>      // circular dependency between goog.bind and Function.prototype.bind, so<tr><td><a id="l1860"></a><a href="#l1860">1860</a><td>      // we have to hack this to make sure it works correctly.<tr><td><a id="l1861"></a><a href="#l1861">1861</a><td>      Function.prototype.bind.toString().indexOf(&#39;native code&#39;) != -1) {<tr><td><a id="l1862"></a><a href="#l1862">1862</a><td>    goog.bind = goog.bindNative_;<tr><td><a id="l1863"></a><a href="#l1863">1863</a><td>  } else {<tr><td><a id="l1864"></a><a href="#l1864">1864</a><td>    goog.bind = goog.bindJs_;<tr><td><a id="l1865"></a><a href="#l1865">1865</a><td>  }<tr><td><a id="l1866"></a><a href="#l1866">1866</a><td>  return goog.bind.apply(null, arguments);<tr><td><a id="l1867"></a><a href="#l1867">1867</a><td>};<tr><td><a id="l1868"></a><a href="#l1868">1868</a><td><tr><td><a id="l1869"></a><a href="#l1869">1869</a><td><tr><td><a id="l1870"></a><a href="#l1870">1870</a><td>/**<tr><td><a id="l1871"></a><a href="#l1871">1871</a><td> * Like goog.bind(), except that a &#39;this object&#39; is not required. Useful when<tr><td><a id="l1872"></a><a href="#l1872">1872</a><td> * the target function is already bound.<tr><td><a id="l1873"></a><a href="#l1873">1873</a><td> *<tr><td><a id="l1874"></a><a href="#l1874">1874</a><td> * Usage:<tr><td><a id="l1875"></a><a href="#l1875">1875</a><td> * var g = goog.partial(f, arg1, arg2);<tr><td><a id="l1876"></a><a href="#l1876">1876</a><td> * g(arg3, arg4);<tr><td><a id="l1877"></a><a href="#l1877">1877</a><td> *<tr><td><a id="l1878"></a><a href="#l1878">1878</a><td> * @param {Function} fn A function to partially apply.<tr><td><a id="l1879"></a><a href="#l1879">1879</a><td> * @param {...*} var_args Additional arguments that are partially applied to fn.<tr><td><a id="l1880"></a><a href="#l1880">1880</a><td> * @return {!Function} A partially-applied form of the function goog.partial()<tr><td><a id="l1881"></a><a href="#l1881">1881</a><td> *     was invoked as a method of.<tr><td><a id="l1882"></a><a href="#l1882">1882</a><td> */<tr><td><a id="l1883"></a><a href="#l1883">1883</a><td>goog.partial = function(fn, var_args) {<tr><td><a id="l1884"></a><a href="#l1884">1884</a><td>  var args = Array.prototype.slice.call(arguments, 1);<tr><td><a id="l1885"></a><a href="#l1885">1885</a><td>  return function() {<tr><td><a id="l1886"></a><a href="#l1886">1886</a><td>    // Clone the array (with slice()) and append additional arguments<tr><td><a id="l1887"></a><a href="#l1887">1887</a><td>    // to the existing arguments.<tr><td><a id="l1888"></a><a href="#l1888">1888</a><td>    var newArgs = args.slice();<tr><td><a id="l1889"></a><a href="#l1889">1889</a><td>    newArgs.push.apply(newArgs, arguments);<tr><td><a id="l1890"></a><a href="#l1890">1890</a><td>    return fn.apply(this, newArgs);<tr><td><a id="l1891"></a><a href="#l1891">1891</a><td>  };<tr><td><a id="l1892"></a><a href="#l1892">1892</a><td>};<tr><td><a id="l1893"></a><a href="#l1893">1893</a><td><tr><td><a id="l1894"></a><a href="#l1894">1894</a><td><tr><td><a id="l1895"></a><a href="#l1895">1895</a><td>/**<tr><td><a id="l1896"></a><a href="#l1896">1896</a><td> * Copies all the members of a source object to a target object. This method<tr><td><a id="l1897"></a><a href="#l1897">1897</a><td> * does not work on all browsers for all objects that contain keys such as<tr><td><a id="l1898"></a><a href="#l1898">1898</a><td> * toString or hasOwnProperty. Use goog.object.extend for this purpose.<tr><td><a id="l1899"></a><a href="#l1899">1899</a><td> * @param {Object} target Target.<tr><td><a id="l1900"></a><a href="#l1900">1900</a><td> * @param {Object} source Source.<tr><td><a id="l1901"></a><a href="#l1901">1901</a><td> */<tr><td><a id="l1902"></a><a href="#l1902">1902</a><td>goog.mixin = function(target, source) {<tr><td><a id="l1903"></a><a href="#l1903">1903</a><td>  for (var x in source) {<tr><td><a id="l1904"></a><a href="#l1904">1904</a><td>    target[x] = source[x];<tr><td><a id="l1905"></a><a href="#l1905">1905</a><td>  }<tr><td><a id="l1906"></a><a href="#l1906">1906</a><td><tr><td><a id="l1907"></a><a href="#l1907">1907</a><td>  // For IE7 or lower, the for-in-loop does not contain any properties that are<tr><td><a id="l1908"></a><a href="#l1908">1908</a><td>  // not enumerable on the prototype object (for example, isPrototypeOf from<tr><td><a id="l1909"></a><a href="#l1909">1909</a><td>  // Object.prototype) but also it will not include &#39;replace&#39; on objects that<tr><td><a id="l1910"></a><a href="#l1910">1910</a><td>  // extend String and change &#39;replace&#39; (not that it is common for anyone to<tr><td><a id="l1911"></a><a href="#l1911">1911</a><td>  // extend anything except Object).<tr><td><a id="l1912"></a><a href="#l1912">1912</a><td>};<tr><td><a id="l1913"></a><a href="#l1913">1913</a><td><tr><td><a id="l1914"></a><a href="#l1914">1914</a><td><tr><td><a id="l1915"></a><a href="#l1915">1915</a><td>/**<tr><td><a id="l1916"></a><a href="#l1916">1916</a><td> * @return {number} An integer value representing the number of milliseconds<tr><td><a id="l1917"></a><a href="#l1917">1917</a><td> *     between midnight, January 1, 1970 and the current time.<tr><td><a id="l1918"></a><a href="#l1918">1918</a><td> */<tr><td><a id="l1919"></a><a href="#l1919">1919</a><td>goog.now = (goog.TRUSTED_SITE &amp;&amp; Date.now) || (function() {<tr><td><a id="l1920"></a><a href="#l1920">1920</a><td>  // Unary plus operator converts its operand to a number which in the case of<tr><td><a id="l1921"></a><a href="#l1921">1921</a><td>  // a date is done by calling getTime().<tr><td><a id="l1922"></a><a href="#l1922">1922</a><td>  return +new Date();<tr><td><a id="l1923"></a><a href="#l1923">1923</a><td>});<tr><td><a id="l1924"></a><a href="#l1924">1924</a><td><tr><td><a id="l1925"></a><a href="#l1925">1925</a><td><tr><td><a id="l1926"></a><a href="#l1926">1926</a><td>/**<tr><td><a id="l1927"></a><a href="#l1927">1927</a><td> * Evals JavaScript in the global scope.  In IE this uses execScript, other<tr><td><a id="l1928"></a><a href="#l1928">1928</a><td> * browsers use goog.global.eval. If goog.global.eval does not evaluate in the<tr><td><a id="l1929"></a><a href="#l1929">1929</a><td> * global scope (for example, in Safari), appends a script tag instead.<tr><td><a id="l1930"></a><a href="#l1930">1930</a><td> * Throws an exception if neither execScript or eval is defined.<tr><td><a id="l1931"></a><a href="#l1931">1931</a><td> * @param {string} script JavaScript string.<tr><td><a id="l1932"></a><a href="#l1932">1932</a><td> */<tr><td><a id="l1933"></a><a href="#l1933">1933</a><td>goog.globalEval = function(script) {<tr><td><a id="l1934"></a><a href="#l1934">1934</a><td>  if (goog.global.execScript) {<tr><td><a id="l1935"></a><a href="#l1935">1935</a><td>    goog.global.execScript(script, &#39;JavaScript&#39;);<tr><td><a id="l1936"></a><a href="#l1936">1936</a><td>  } else if (goog.global.eval) {<tr><td><a id="l1937"></a><a href="#l1937">1937</a><td>    // Test to see if eval works<tr><td><a id="l1938"></a><a href="#l1938">1938</a><td>    if (goog.evalWorksForGlobals_ == null) {<tr><td><a id="l1939"></a><a href="#l1939">1939</a><td>      goog.global.eval(&#39;var _evalTest_ = 1;&#39;);<tr><td><a id="l1940"></a><a href="#l1940">1940</a><td>      if (typeof goog.global[&#39;_evalTest_&#39;] != &#39;undefined&#39;) {<tr><td><a id="l1941"></a><a href="#l1941">1941</a><td>        try {<tr><td><a id="l1942"></a><a href="#l1942">1942</a><td>          delete goog.global[&#39;_evalTest_&#39;];<tr><td><a id="l1943"></a><a href="#l1943">1943</a><td>        } catch (ignore) {<tr><td><a id="l1944"></a><a href="#l1944">1944</a><td>          // Microsoft edge fails the deletion above in strict mode.<tr><td><a id="l1945"></a><a href="#l1945">1945</a><td>        }<tr><td><a id="l1946"></a><a href="#l1946">1946</a><td>        goog.evalWorksForGlobals_ = true;<tr><td><a id="l1947"></a><a href="#l1947">1947</a><td>      } else {<tr><td><a id="l1948"></a><a href="#l1948">1948</a><td>        goog.evalWorksForGlobals_ = false;<tr><td><a id="l1949"></a><a href="#l1949">1949</a><td>      }<tr><td><a id="l1950"></a><a href="#l1950">1950</a><td>    }<tr><td><a id="l1951"></a><a href="#l1951">1951</a><td><tr><td><a id="l1952"></a><a href="#l1952">1952</a><td>    if (goog.evalWorksForGlobals_) {<tr><td><a id="l1953"></a><a href="#l1953">1953</a><td>      goog.global.eval(script);<tr><td><a id="l1954"></a><a href="#l1954">1954</a><td>    } else {<tr><td><a id="l1955"></a><a href="#l1955">1955</a><td>      /** @type {Document} */<tr><td><a id="l1956"></a><a href="#l1956">1956</a><td>      var doc = goog.global.document;<tr><td><a id="l1957"></a><a href="#l1957">1957</a><td>      var scriptElt = /** @type {!HTMLScriptElement} */ (<tr><td><a id="l1958"></a><a href="#l1958">1958</a><td>          doc.createElement(&#39;SCRIPT&#39;));<tr><td><a id="l1959"></a><a href="#l1959">1959</a><td>      scriptElt.type = &#39;text/javascript&#39;;<tr><td><a id="l1960"></a><a href="#l1960">1960</a><td>      scriptElt.defer = false;<tr><td><a id="l1961"></a><a href="#l1961">1961</a><td>      // Note(user): can&#39;t use .innerHTML since &quot;t(&#39;&lt;test&gt;&#39;)&quot; will fail and<tr><td><a id="l1962"></a><a href="#l1962">1962</a><td>      // .text doesn&#39;t work in Safari 2.  Therefore we append a text node.<tr><td><a id="l1963"></a><a href="#l1963">1963</a><td>      scriptElt.appendChild(doc.createTextNode(script));<tr><td><a id="l1964"></a><a href="#l1964">1964</a><td>      doc.body.appendChild(scriptElt);<tr><td><a id="l1965"></a><a href="#l1965">1965</a><td>      doc.body.removeChild(scriptElt);<tr><td><a id="l1966"></a><a href="#l1966">1966</a><td>    }<tr><td><a id="l1967"></a><a href="#l1967">1967</a><td>  } else {<tr><td><a id="l1968"></a><a href="#l1968">1968</a><td>    throw Error(&#39;goog.globalEval not available&#39;);<tr><td><a id="l1969"></a><a href="#l1969">1969</a><td>  }<tr><td><a id="l1970"></a><a href="#l1970">1970</a><td>};<tr><td><a id="l1971"></a><a href="#l1971">1971</a><td><tr><td><a id="l1972"></a><a href="#l1972">1972</a><td><tr><td><a id="l1973"></a><a href="#l1973">1973</a><td>/**<tr><td><a id="l1974"></a><a href="#l1974">1974</a><td> * Indicates whether or not we can call &#39;eval&#39; directly to eval code in the<tr><td><a id="l1975"></a><a href="#l1975">1975</a><td> * global scope. Set to a Boolean by the first call to goog.globalEval (which<tr><td><a id="l1976"></a><a href="#l1976">1976</a><td> * empirically tests whether eval works for globals). @see goog.globalEval<tr><td><a id="l1977"></a><a href="#l1977">1977</a><td> * @type {?boolean}<tr><td><a id="l1978"></a><a href="#l1978">1978</a><td> * @private<tr><td><a id="l1979"></a><a href="#l1979">1979</a><td> */<tr><td><a id="l1980"></a><a href="#l1980">1980</a><td>goog.evalWorksForGlobals_ = null;<tr><td><a id="l1981"></a><a href="#l1981">1981</a><td><tr><td><a id="l1982"></a><a href="#l1982">1982</a><td><tr><td><a id="l1983"></a><a href="#l1983">1983</a><td>/**<tr><td><a id="l1984"></a><a href="#l1984">1984</a><td> * Optional map of CSS class names to obfuscated names used with<tr><td><a id="l1985"></a><a href="#l1985">1985</a><td> * goog.getCssName().<tr><td><a id="l1986"></a><a href="#l1986">1986</a><td> * @private {!Object&lt;string, string&gt;|undefined}<tr><td><a id="l1987"></a><a href="#l1987">1987</a><td> * @see goog.setCssNameMapping<tr><td><a id="l1988"></a><a href="#l1988">1988</a><td> */<tr><td><a id="l1989"></a><a href="#l1989">1989</a><td>goog.cssNameMapping_;<tr><td><a id="l1990"></a><a href="#l1990">1990</a><td><tr><td><a id="l1991"></a><a href="#l1991">1991</a><td><tr><td><a id="l1992"></a><a href="#l1992">1992</a><td>/**<tr><td><a id="l1993"></a><a href="#l1993">1993</a><td> * Optional obfuscation style for CSS class names. Should be set to either<tr><td><a id="l1994"></a><a href="#l1994">1994</a><td> * &#39;BY_WHOLE&#39; or &#39;BY_PART&#39; if defined.<tr><td><a id="l1995"></a><a href="#l1995">1995</a><td> * @type {string|undefined}<tr><td><a id="l1996"></a><a href="#l1996">1996</a><td> * @private<tr><td><a id="l1997"></a><a href="#l1997">1997</a><td> * @see goog.setCssNameMapping<tr><td><a id="l1998"></a><a href="#l1998">1998</a><td> */<tr><td><a id="l1999"></a><a href="#l1999">1999</a><td>goog.cssNameMappingStyle_;<tr><td><a id="l2000"></a><a href="#l2000">2000</a><td><tr><td><a id="l2001"></a><a href="#l2001">2001</a><td><tr><td><a id="l2002"></a><a href="#l2002">2002</a><td>/**<tr><td><a id="l2003"></a><a href="#l2003">2003</a><td> * Handles strings that are intended to be used as CSS class names.<tr><td><a id="l2004"></a><a href="#l2004">2004</a><td> *<tr><td><a id="l2005"></a><a href="#l2005">2005</a><td> * This function works in tandem with @see goog.setCssNameMapping.<tr><td><a id="l2006"></a><a href="#l2006">2006</a><td> *<tr><td><a id="l2007"></a><a href="#l2007">2007</a><td> * Without any mapping set, the arguments are simple joined with a hyphen and<tr><td><a id="l2008"></a><a href="#l2008">2008</a><td> * passed through unaltered.<tr><td><a id="l2009"></a><a href="#l2009">2009</a><td> *<tr><td><a id="l2010"></a><a href="#l2010">2010</a><td> * When there is a mapping, there are two possible styles in which these<tr><td><a id="l2011"></a><a href="#l2011">2011</a><td> * mappings are used. In the BY_PART style, each part (i.e. in between hyphens)<tr><td><a id="l2012"></a><a href="#l2012">2012</a><td> * of the passed in css name is rewritten according to the map. In the BY_WHOLE<tr><td><a id="l2013"></a><a href="#l2013">2013</a><td> * style, the full css name is looked up in the map directly. If a rewrite is<tr><td><a id="l2014"></a><a href="#l2014">2014</a><td> * not specified by the map, the compiler will output a warning.<tr><td><a id="l2015"></a><a href="#l2015">2015</a><td> *<tr><td><a id="l2016"></a><a href="#l2016">2016</a><td> * When the mapping is passed to the compiler, it will replace calls to<tr><td><a id="l2017"></a><a href="#l2017">2017</a><td> * goog.getCssName with the strings from the mapping, e.g.<tr><td><a id="l2018"></a><a href="#l2018">2018</a><td> *     var x = goog.getCssName(&#39;foo&#39;);<tr><td><a id="l2019"></a><a href="#l2019">2019</a><td> *     var y = goog.getCssName(this.baseClass, &#39;active&#39;);<tr><td><a id="l2020"></a><a href="#l2020">2020</a><td> *  becomes:<tr><td><a id="l2021"></a><a href="#l2021">2021</a><td> *     var x = &#39;foo&#39;;<tr><td><a id="l2022"></a><a href="#l2022">2022</a><td> *     var y = this.baseClass + &#39;-active&#39;;<tr><td><a id="l2023"></a><a href="#l2023">2023</a><td> *<tr><td><a id="l2024"></a><a href="#l2024">2024</a><td> * If one argument is passed it will be processed, if two are passed only the<tr><td><a id="l2025"></a><a href="#l2025">2025</a><td> * modifier will be processed, as it is assumed the first argument was generated<tr><td><a id="l2026"></a><a href="#l2026">2026</a><td> * as a result of calling goog.getCssName.<tr><td><a id="l2027"></a><a href="#l2027">2027</a><td> *<tr><td><a id="l2028"></a><a href="#l2028">2028</a><td> * @param {string} className The class name.<tr><td><a id="l2029"></a><a href="#l2029">2029</a><td> * @param {string=} opt_modifier A modifier to be appended to the class name.<tr><td><a id="l2030"></a><a href="#l2030">2030</a><td> * @return {string} The class name or the concatenation of the class name and<tr><td><a id="l2031"></a><a href="#l2031">2031</a><td> *     the modifier.<tr><td><a id="l2032"></a><a href="#l2032">2032</a><td> */<tr><td><a id="l2033"></a><a href="#l2033">2033</a><td>goog.getCssName = function(className, opt_modifier) {<tr><td><a id="l2034"></a><a href="#l2034">2034</a><td>  var getMapping = function(cssName) {<tr><td><a id="l2035"></a><a href="#l2035">2035</a><td>    return goog.cssNameMapping_[cssName] || cssName;<tr><td><a id="l2036"></a><a href="#l2036">2036</a><td>  };<tr><td><a id="l2037"></a><a href="#l2037">2037</a><td><tr><td><a id="l2038"></a><a href="#l2038">2038</a><td>  var renameByParts = function(cssName) {<tr><td><a id="l2039"></a><a href="#l2039">2039</a><td>    // Remap all the parts individually.<tr><td><a id="l2040"></a><a href="#l2040">2040</a><td>    var parts = cssName.split(&#39;-&#39;);<tr><td><a id="l2041"></a><a href="#l2041">2041</a><td>    var mapped = [];<tr><td><a id="l2042"></a><a href="#l2042">2042</a><td>    for (var i = 0; i &lt; parts.length; i++) {<tr><td><a id="l2043"></a><a href="#l2043">2043</a><td>      mapped.push(getMapping(parts[i]));<tr><td><a id="l2044"></a><a href="#l2044">2044</a><td>    }<tr><td><a id="l2045"></a><a href="#l2045">2045</a><td>    return mapped.join(&#39;-&#39;);<tr><td><a id="l2046"></a><a href="#l2046">2046</a><td>  };<tr><td><a id="l2047"></a><a href="#l2047">2047</a><td><tr><td><a id="l2048"></a><a href="#l2048">2048</a><td>  var rename;<tr><td><a id="l2049"></a><a href="#l2049">2049</a><td>  if (goog.cssNameMapping_) {<tr><td><a id="l2050"></a><a href="#l2050">2050</a><td>    rename = goog.cssNameMappingStyle_ == &#39;BY_WHOLE&#39; ?<tr><td><a id="l2051"></a><a href="#l2051">2051</a><td>        getMapping : renameByParts;<tr><td><a id="l2052"></a><a href="#l2052">2052</a><td>  } else {<tr><td><a id="l2053"></a><a href="#l2053">2053</a><td>    rename = function(a) {<tr><td><a id="l2054"></a><a href="#l2054">2054</a><td>      return a;<tr><td><a id="l2055"></a><a href="#l2055">2055</a><td>    };<tr><td><a id="l2056"></a><a href="#l2056">2056</a><td>  }<tr><td><a id="l2057"></a><a href="#l2057">2057</a><td><tr><td><a id="l2058"></a><a href="#l2058">2058</a><td>  if (opt_modifier) {<tr><td><a id="l2059"></a><a href="#l2059">2059</a><td>    return className + &#39;-&#39; + rename(opt_modifier);<tr><td><a id="l2060"></a><a href="#l2060">2060</a><td>  } else {<tr><td><a id="l2061"></a><a href="#l2061">2061</a><td>    return rename(className);<tr><td><a id="l2062"></a><a href="#l2062">2062</a><td>  }<tr><td><a id="l2063"></a><a href="#l2063">2063</a><td>};<tr><td><a id="l2064"></a><a href="#l2064">2064</a><td><tr><td><a id="l2065"></a><a href="#l2065">2065</a><td><tr><td><a id="l2066"></a><a href="#l2066">2066</a><td>/**<tr><td><a id="l2067"></a><a href="#l2067">2067</a><td> * Sets the map to check when returning a value from goog.getCssName(). Example:<tr><td><a id="l2068"></a><a href="#l2068">2068</a><td> * &lt;pre&gt;<tr><td><a id="l2069"></a><a href="#l2069">2069</a><td> * goog.setCssNameMapping({<tr><td><a id="l2070"></a><a href="#l2070">2070</a><td> *   &quot;goog&quot;: &quot;a&quot;,<tr><td><a id="l2071"></a><a href="#l2071">2071</a><td> *   &quot;disabled&quot;: &quot;b&quot;,<tr><td><a id="l2072"></a><a href="#l2072">2072</a><td> * });<tr><td><a id="l2073"></a><a href="#l2073">2073</a><td> *<tr><td><a id="l2074"></a><a href="#l2074">2074</a><td> * var x = goog.getCssName(&#39;goog&#39;);<tr><td><a id="l2075"></a><a href="#l2075">2075</a><td> * // The following evaluates to: &quot;a a-b&quot;.<tr><td><a id="l2076"></a><a href="#l2076">2076</a><td> * goog.getCssName(&#39;goog&#39;) + &#39; &#39; + goog.getCssName(x, &#39;disabled&#39;)<tr><td><a id="l2077"></a><a href="#l2077">2077</a><td> * &lt;/pre&gt;<tr><td><a id="l2078"></a><a href="#l2078">2078</a><td> * When declared as a map of string literals to string literals, the JSCompiler<tr><td><a id="l2079"></a><a href="#l2079">2079</a><td> * will replace all calls to goog.getCssName() using the supplied map if the<tr><td><a id="l2080"></a><a href="#l2080">2080</a><td> * --process_closure_primitives flag is set.<tr><td><a id="l2081"></a><a href="#l2081">2081</a><td> *<tr><td><a id="l2082"></a><a href="#l2082">2082</a><td> * @param {!Object} mapping A map of strings to strings where keys are possible<tr><td><a id="l2083"></a><a href="#l2083">2083</a><td> *     arguments to goog.getCssName() and values are the corresponding values<tr><td><a id="l2084"></a><a href="#l2084">2084</a><td> *     that should be returned.<tr><td><a id="l2085"></a><a href="#l2085">2085</a><td> * @param {string=} opt_style The style of css name mapping. There are two valid<tr><td><a id="l2086"></a><a href="#l2086">2086</a><td> *     options: &#39;BY_PART&#39;, and &#39;BY_WHOLE&#39;.<tr><td><a id="l2087"></a><a href="#l2087">2087</a><td> * @see goog.getCssName for a description.<tr><td><a id="l2088"></a><a href="#l2088">2088</a><td> */<tr><td><a id="l2089"></a><a href="#l2089">2089</a><td>goog.setCssNameMapping = function(mapping, opt_style) {<tr><td><a id="l2090"></a><a href="#l2090">2090</a><td>  goog.cssNameMapping_ = mapping;<tr><td><a id="l2091"></a><a href="#l2091">2091</a><td>  goog.cssNameMappingStyle_ = opt_style;<tr><td><a id="l2092"></a><a href="#l2092">2092</a><td>};<tr><td><a id="l2093"></a><a href="#l2093">2093</a><td><tr><td><a id="l2094"></a><a href="#l2094">2094</a><td><tr><td><a id="l2095"></a><a href="#l2095">2095</a><td>/**<tr><td><a id="l2096"></a><a href="#l2096">2096</a><td> * To use CSS renaming in compiled mode, one of the input files should have a<tr><td><a id="l2097"></a><a href="#l2097">2097</a><td> * call to goog.setCssNameMapping() with an object literal that the JSCompiler<tr><td><a id="l2098"></a><a href="#l2098">2098</a><td> * can extract and use to replace all calls to goog.getCssName(). In uncompiled<tr><td><a id="l2099"></a><a href="#l2099">2099</a><td> * mode, JavaScript code should be loaded before this base.js file that declares<tr><td><a id="l2100"></a><a href="#l2100">2100</a><td> * a global variable, CLOSURE_CSS_NAME_MAPPING, which is used below. This is<tr><td><a id="l2101"></a><a href="#l2101">2101</a><td> * to ensure that the mapping is loaded before any calls to goog.getCssName()<tr><td><a id="l2102"></a><a href="#l2102">2102</a><td> * are made in uncompiled mode.<tr><td><a id="l2103"></a><a href="#l2103">2103</a><td> *<tr><td><a id="l2104"></a><a href="#l2104">2104</a><td> * A hook for overriding the CSS name mapping.<tr><td><a id="l2105"></a><a href="#l2105">2105</a><td> * @type {!Object&lt;string, string&gt;|undefined}<tr><td><a id="l2106"></a><a href="#l2106">2106</a><td> */<tr><td><a id="l2107"></a><a href="#l2107">2107</a><td>goog.global.CLOSURE_CSS_NAME_MAPPING;<tr><td><a id="l2108"></a><a href="#l2108">2108</a><td><tr><td><a id="l2109"></a><a href="#l2109">2109</a><td><tr><td><a id="l2110"></a><a href="#l2110">2110</a><td>if (!COMPILED &amp;&amp; goog.global.CLOSURE_CSS_NAME_MAPPING) {<tr><td><a id="l2111"></a><a href="#l2111">2111</a><td>  // This does not call goog.setCssNameMapping() because the JSCompiler<tr><td><a id="l2112"></a><a href="#l2112">2112</a><td>  // requires that goog.setCssNameMapping() be called with an object literal.<tr><td><a id="l2113"></a><a href="#l2113">2113</a><td>  goog.cssNameMapping_ = goog.global.CLOSURE_CSS_NAME_MAPPING;<tr><td><a id="l2114"></a><a href="#l2114">2114</a><td>}<tr><td><a id="l2115"></a><a href="#l2115">2115</a><td><tr><td><a id="l2116"></a><a href="#l2116">2116</a><td><tr><td><a id="l2117"></a><a href="#l2117">2117</a><td>/**<tr><td><a id="l2118"></a><a href="#l2118">2118</a><td> * Gets a localized message.<tr><td><a id="l2119"></a><a href="#l2119">2119</a><td> *<tr><td><a id="l2120"></a><a href="#l2120">2120</a><td> * This function is a compiler primitive. If you give the compiler a localized<tr><td><a id="l2121"></a><a href="#l2121">2121</a><td> * message bundle, it will replace the string at compile-time with a localized<tr><td><a id="l2122"></a><a href="#l2122">2122</a><td> * version, and expand goog.getMsg call to a concatenated string.<tr><td><a id="l2123"></a><a href="#l2123">2123</a><td> *<tr><td><a id="l2124"></a><a href="#l2124">2124</a><td> * Messages must be initialized in the form:<tr><td><a id="l2125"></a><a href="#l2125">2125</a><td> * &lt;code&gt;<tr><td><a id="l2126"></a><a href="#l2126">2126</a><td> * var MSG_NAME = goog.getMsg(&#39;Hello {$placeholder}&#39;, {&#39;placeholder&#39;: &#39;world&#39;});<tr><td><a id="l2127"></a><a href="#l2127">2127</a><td> * &lt;/code&gt;<tr><td><a id="l2128"></a><a href="#l2128">2128</a><td> *<tr><td><a id="l2129"></a><a href="#l2129">2129</a><td> * @param {string} str Translatable string, places holders in the form {$foo}.<tr><td><a id="l2130"></a><a href="#l2130">2130</a><td> * @param {Object&lt;string, string&gt;=} opt_values Maps place holder name to value.<tr><td><a id="l2131"></a><a href="#l2131">2131</a><td> * @return {string} message with placeholders filled.<tr><td><a id="l2132"></a><a href="#l2132">2132</a><td> */<tr><td><a id="l2133"></a><a href="#l2133">2133</a><td>goog.getMsg = function(str, opt_values) {<tr><td><a id="l2134"></a><a href="#l2134">2134</a><td>  if (opt_values) {<tr><td><a id="l2135"></a><a href="#l2135">2135</a><td>    str = str.replace(/\{\$([^}]+)}/g, function(match, key) {<tr><td><a id="l2136"></a><a href="#l2136">2136</a><td>      return (opt_values != null &amp;&amp; key in opt_values) ?<tr><td><a id="l2137"></a><a href="#l2137">2137</a><td>          opt_values[key] : match;<tr><td><a id="l2138"></a><a href="#l2138">2138</a><td>    });<tr><td><a id="l2139"></a><a href="#l2139">2139</a><td>  }<tr><td><a id="l2140"></a><a href="#l2140">2140</a><td>  return str;<tr><td><a id="l2141"></a><a href="#l2141">2141</a><td>};<tr><td><a id="l2142"></a><a href="#l2142">2142</a><td><tr><td><a id="l2143"></a><a href="#l2143">2143</a><td><tr><td><a id="l2144"></a><a href="#l2144">2144</a><td>/**<tr><td><a id="l2145"></a><a href="#l2145">2145</a><td> * Gets a localized message. If the message does not have a translation, gives a<tr><td><a id="l2146"></a><a href="#l2146">2146</a><td> * fallback message.<tr><td><a id="l2147"></a><a href="#l2147">2147</a><td> *<tr><td><a id="l2148"></a><a href="#l2148">2148</a><td> * This is useful when introducing a new message that has not yet been<tr><td><a id="l2149"></a><a href="#l2149">2149</a><td> * translated into all languages.<tr><td><a id="l2150"></a><a href="#l2150">2150</a><td> *<tr><td><a id="l2151"></a><a href="#l2151">2151</a><td> * This function is a compiler primitive. Must be used in the form:<tr><td><a id="l2152"></a><a href="#l2152">2152</a><td> * &lt;code&gt;var x = goog.getMsgWithFallback(MSG_A, MSG_B);&lt;/code&gt;<tr><td><a id="l2153"></a><a href="#l2153">2153</a><td> * where MSG_A and MSG_B were initialized with goog.getMsg.<tr><td><a id="l2154"></a><a href="#l2154">2154</a><td> *<tr><td><a id="l2155"></a><a href="#l2155">2155</a><td> * @param {string} a The preferred message.<tr><td><a id="l2156"></a><a href="#l2156">2156</a><td> * @param {string} b The fallback message.<tr><td><a id="l2157"></a><a href="#l2157">2157</a><td> * @return {string} The best translated message.<tr><td><a id="l2158"></a><a href="#l2158">2158</a><td> */<tr><td><a id="l2159"></a><a href="#l2159">2159</a><td>goog.getMsgWithFallback = function(a, b) {<tr><td><a id="l2160"></a><a href="#l2160">2160</a><td>  return a;<tr><td><a id="l2161"></a><a href="#l2161">2161</a><td>};<tr><td><a id="l2162"></a><a href="#l2162">2162</a><td><tr><td><a id="l2163"></a><a href="#l2163">2163</a><td><tr><td><a id="l2164"></a><a href="#l2164">2164</a><td>/**<tr><td><a id="l2165"></a><a href="#l2165">2165</a><td> * Exposes an unobfuscated global namespace path for the given object.<tr><td><a id="l2166"></a><a href="#l2166">2166</a><td> * Note that fields of the exported object *will* be obfuscated, unless they are<tr><td><a id="l2167"></a><a href="#l2167">2167</a><td> * exported in turn via this function or goog.exportProperty.<tr><td><a id="l2168"></a><a href="#l2168">2168</a><td> *<tr><td><a id="l2169"></a><a href="#l2169">2169</a><td> * Also handy for making public items that are defined in anonymous closures.<tr><td><a id="l2170"></a><a href="#l2170">2170</a><td> *<tr><td><a id="l2171"></a><a href="#l2171">2171</a><td> * ex. goog.exportSymbol(&#39;public.path.Foo&#39;, Foo);<tr><td><a id="l2172"></a><a href="#l2172">2172</a><td> *<tr><td><a id="l2173"></a><a href="#l2173">2173</a><td> * ex. goog.exportSymbol(&#39;public.path.Foo.staticFunction&#39;, Foo.staticFunction);<tr><td><a id="l2174"></a><a href="#l2174">2174</a><td> *     public.path.Foo.staticFunction();<tr><td><a id="l2175"></a><a href="#l2175">2175</a><td> *<tr><td><a id="l2176"></a><a href="#l2176">2176</a><td> * ex. goog.exportSymbol(&#39;public.path.Foo.prototype.myMethod&#39;,<tr><td><a id="l2177"></a><a href="#l2177">2177</a><td> *                       Foo.prototype.myMethod);<tr><td><a id="l2178"></a><a href="#l2178">2178</a><td> *     new public.path.Foo().myMethod();<tr><td><a id="l2179"></a><a href="#l2179">2179</a><td> *<tr><td><a id="l2180"></a><a href="#l2180">2180</a><td> * @param {string} publicPath Unobfuscated name to export.<tr><td><a id="l2181"></a><a href="#l2181">2181</a><td> * @param {*} object Object the name should point to.<tr><td><a id="l2182"></a><a href="#l2182">2182</a><td> * @param {Object=} opt_objectToExportTo The object to add the path to; default<tr><td><a id="l2183"></a><a href="#l2183">2183</a><td> *     is goog.global.<tr><td><a id="l2184"></a><a href="#l2184">2184</a><td> */<tr><td><a id="l2185"></a><a href="#l2185">2185</a><td>goog.exportSymbol = function(publicPath, object, opt_objectToExportTo) {<tr><td><a id="l2186"></a><a href="#l2186">2186</a><td>  goog.exportPath_(publicPath, object, opt_objectToExportTo);<tr><td><a id="l2187"></a><a href="#l2187">2187</a><td>};<tr><td><a id="l2188"></a><a href="#l2188">2188</a><td><tr><td><a id="l2189"></a><a href="#l2189">2189</a><td><tr><td><a id="l2190"></a><a href="#l2190">2190</a><td>/**<tr><td><a id="l2191"></a><a href="#l2191">2191</a><td> * Exports a property unobfuscated into the object&#39;s namespace.<tr><td><a id="l2192"></a><a href="#l2192">2192</a><td> * ex. goog.exportProperty(Foo, &#39;staticFunction&#39;, Foo.staticFunction);<tr><td><a id="l2193"></a><a href="#l2193">2193</a><td> * ex. goog.exportProperty(Foo.prototype, &#39;myMethod&#39;, Foo.prototype.myMethod);<tr><td><a id="l2194"></a><a href="#l2194">2194</a><td> * @param {Object} object Object whose static property is being exported.<tr><td><a id="l2195"></a><a href="#l2195">2195</a><td> * @param {string} publicName Unobfuscated name to export.<tr><td><a id="l2196"></a><a href="#l2196">2196</a><td> * @param {*} symbol Object the name should point to.<tr><td><a id="l2197"></a><a href="#l2197">2197</a><td> */<tr><td><a id="l2198"></a><a href="#l2198">2198</a><td>goog.exportProperty = function(object, publicName, symbol) {<tr><td><a id="l2199"></a><a href="#l2199">2199</a><td>  object[publicName] = symbol;<tr><td><a id="l2200"></a><a href="#l2200">2200</a><td>};<tr><td><a id="l2201"></a><a href="#l2201">2201</a><td><tr><td><a id="l2202"></a><a href="#l2202">2202</a><td><tr><td><a id="l2203"></a><a href="#l2203">2203</a><td>/**<tr><td><a id="l2204"></a><a href="#l2204">2204</a><td> * Inherit the prototype methods from one constructor into another.<tr><td><a id="l2205"></a><a href="#l2205">2205</a><td> *<tr><td><a id="l2206"></a><a href="#l2206">2206</a><td> * Usage:<tr><td><a id="l2207"></a><a href="#l2207">2207</a><td> * &lt;pre&gt;<tr><td><a id="l2208"></a><a href="#l2208">2208</a><td> * function ParentClass(a, b) { }<tr><td><a id="l2209"></a><a href="#l2209">2209</a><td> * ParentClass.prototype.foo = function(a) { };<tr><td><a id="l2210"></a><a href="#l2210">2210</a><td> *<tr><td><a id="l2211"></a><a href="#l2211">2211</a><td> * function ChildClass(a, b, c) {<tr><td><a id="l2212"></a><a href="#l2212">2212</a><td> *   ChildClass.base(this, &#39;constructor&#39;, a, b);<tr><td><a id="l2213"></a><a href="#l2213">2213</a><td> * }<tr><td><a id="l2214"></a><a href="#l2214">2214</a><td> * goog.inherits(ChildClass, ParentClass);<tr><td><a id="l2215"></a><a href="#l2215">2215</a><td> *<tr><td><a id="l2216"></a><a href="#l2216">2216</a><td> * var child = new ChildClass(&#39;a&#39;, &#39;b&#39;, &#39;see&#39;);<tr><td><a id="l2217"></a><a href="#l2217">2217</a><td> * child.foo(); // This works.<tr><td><a id="l2218"></a><a href="#l2218">2218</a><td> * &lt;/pre&gt;<tr><td><a id="l2219"></a><a href="#l2219">2219</a><td> *<tr><td><a id="l2220"></a><a href="#l2220">2220</a><td> * @param {!Function} childCtor Child class.<tr><td><a id="l2221"></a><a href="#l2221">2221</a><td> * @param {!Function} parentCtor Parent class.<tr><td><a id="l2222"></a><a href="#l2222">2222</a><td> */<tr><td><a id="l2223"></a><a href="#l2223">2223</a><td>goog.inherits = function(childCtor, parentCtor) {<tr><td><a id="l2224"></a><a href="#l2224">2224</a><td>  /** @constructor */<tr><td><a id="l2225"></a><a href="#l2225">2225</a><td>  function tempCtor() {};<tr><td><a id="l2226"></a><a href="#l2226">2226</a><td>  tempCtor.prototype = parentCtor.prototype;<tr><td><a id="l2227"></a><a href="#l2227">2227</a><td>  childCtor.superClass_ = parentCtor.prototype;<tr><td><a id="l2228"></a><a href="#l2228">2228</a><td>  childCtor.prototype = new tempCtor();<tr><td><a id="l2229"></a><a href="#l2229">2229</a><td>  /** @override */<tr><td><a id="l2230"></a><a href="#l2230">2230</a><td>  childCtor.prototype.constructor = childCtor;<tr><td><a id="l2231"></a><a href="#l2231">2231</a><td><tr><td><a id="l2232"></a><a href="#l2232">2232</a><td>  /**<tr><td><a id="l2233"></a><a href="#l2233">2233</a><td>   * Calls superclass constructor/method.<tr><td><a id="l2234"></a><a href="#l2234">2234</a><td>   *<tr><td><a id="l2235"></a><a href="#l2235">2235</a><td>   * This function is only available if you use goog.inherits to<tr><td><a id="l2236"></a><a href="#l2236">2236</a><td>   * express inheritance relationships between classes.<tr><td><a id="l2237"></a><a href="#l2237">2237</a><td>   *<tr><td><a id="l2238"></a><a href="#l2238">2238</a><td>   * NOTE: This is a replacement for goog.base and for superClass_<tr><td><a id="l2239"></a><a href="#l2239">2239</a><td>   * property defined in childCtor.<tr><td><a id="l2240"></a><a href="#l2240">2240</a><td>   *<tr><td><a id="l2241"></a><a href="#l2241">2241</a><td>   * @param {!Object} me Should always be &quot;this&quot;.<tr><td><a id="l2242"></a><a href="#l2242">2242</a><td>   * @param {string} methodName The method name to call. Calling<tr><td><a id="l2243"></a><a href="#l2243">2243</a><td>   *     superclass constructor can be done with the special string<tr><td><a id="l2244"></a><a href="#l2244">2244</a><td>   *     &#39;constructor&#39;.<tr><td><a id="l2245"></a><a href="#l2245">2245</a><td>   * @param {...*} var_args The arguments to pass to superclass<tr><td><a id="l2246"></a><a href="#l2246">2246</a><td>   *     method/constructor.<tr><td><a id="l2247"></a><a href="#l2247">2247</a><td>   * @return {*} The return value of the superclass method/constructor.<tr><td><a id="l2248"></a><a href="#l2248">2248</a><td>   */<tr><td><a id="l2249"></a><a href="#l2249">2249</a><td>  childCtor.base = function(me, methodName, var_args) {<tr><td><a id="l2250"></a><a href="#l2250">2250</a><td>    // Copying using loop to avoid deop due to passing arguments object to<tr><td><a id="l2251"></a><a href="#l2251">2251</a><td>    // function. This is faster in many JS engines as of late 2014.<tr><td><a id="l2252"></a><a href="#l2252">2252</a><td>    var args = new Array(arguments.length - 2);<tr><td><a id="l2253"></a><a href="#l2253">2253</a><td>    for (var i = 2; i &lt; arguments.length; i++) {<tr><td><a id="l2254"></a><a href="#l2254">2254</a><td>      args[i - 2] = arguments[i];<tr><td><a id="l2255"></a><a href="#l2255">2255</a><td>    }<tr><td><a id="l2256"></a><a href="#l2256">2256</a><td>    return parentCtor.prototype[methodName].apply(me, args);<tr><td><a id="l2257"></a><a href="#l2257">2257</a><td>  };<tr><td><a id="l2258"></a><a href="#l2258">2258</a><td>};<tr><td><a id="l2259"></a><a href="#l2259">2259</a><td><tr><td><a id="l2260"></a><a href="#l2260">2260</a><td><tr><td><a id="l2261"></a><a href="#l2261">2261</a><td>/**<tr><td><a id="l2262"></a><a href="#l2262">2262</a><td> * Call up to the superclass.<tr><td><a id="l2263"></a><a href="#l2263">2263</a><td> *<tr><td><a id="l2264"></a><a href="#l2264">2264</a><td> * If this is called from a constructor, then this calls the superclass<tr><td><a id="l2265"></a><a href="#l2265">2265</a><td> * constructor with arguments 1-N.<tr><td><a id="l2266"></a><a href="#l2266">2266</a><td> *<tr><td><a id="l2267"></a><a href="#l2267">2267</a><td> * If this is called from a prototype method, then you must pass the name of the<tr><td><a id="l2268"></a><a href="#l2268">2268</a><td> * method as the second argument to this function. If you do not, you will get a<tr><td><a id="l2269"></a><a href="#l2269">2269</a><td> * runtime error. This calls the superclass&#39; method with arguments 2-N.<tr><td><a id="l2270"></a><a href="#l2270">2270</a><td> *<tr><td><a id="l2271"></a><a href="#l2271">2271</a><td> * This function only works if you use goog.inherits to express inheritance<tr><td><a id="l2272"></a><a href="#l2272">2272</a><td> * relationships between your classes.<tr><td><a id="l2273"></a><a href="#l2273">2273</a><td> *<tr><td><a id="l2274"></a><a href="#l2274">2274</a><td> * This function is a compiler primitive. At compile-time, the compiler will do<tr><td><a id="l2275"></a><a href="#l2275">2275</a><td> * macro expansion to remove a lot of the extra overhead that this function<tr><td><a id="l2276"></a><a href="#l2276">2276</a><td> * introduces. The compiler will also enforce a lot of the assumptions that this<tr><td><a id="l2277"></a><a href="#l2277">2277</a><td> * function makes, and treat it as a compiler error if you break them.<tr><td><a id="l2278"></a><a href="#l2278">2278</a><td> *<tr><td><a id="l2279"></a><a href="#l2279">2279</a><td> * @param {!Object} me Should always be &quot;this&quot;.<tr><td><a id="l2280"></a><a href="#l2280">2280</a><td> * @param {*=} opt_methodName The method name if calling a super method.<tr><td><a id="l2281"></a><a href="#l2281">2281</a><td> * @param {...*} var_args The rest of the arguments.<tr><td><a id="l2282"></a><a href="#l2282">2282</a><td> * @return {*} The return value of the superclass method.<tr><td><a id="l2283"></a><a href="#l2283">2283</a><td> * @suppress {es5Strict} This method can not be used in strict mode, but<tr><td><a id="l2284"></a><a href="#l2284">2284</a><td> *     all Closure Library consumers must depend on this file.<tr><td><a id="l2285"></a><a href="#l2285">2285</a><td> */<tr><td><a id="l2286"></a><a href="#l2286">2286</a><td>goog.base = function(me, opt_methodName, var_args) {<tr><td><a id="l2287"></a><a href="#l2287">2287</a><td>  var caller = arguments.callee.caller;<tr><td><a id="l2288"></a><a href="#l2288">2288</a><td><tr><td><a id="l2289"></a><a href="#l2289">2289</a><td>  if (goog.STRICT_MODE_COMPATIBLE || (goog.DEBUG &amp;&amp; !caller)) {<tr><td><a id="l2290"></a><a href="#l2290">2290</a><td>    throw Error(&#39;arguments.caller not defined.  goog.base() cannot be used &#39; +<tr><td><a id="l2291"></a><a href="#l2291">2291</a><td>                &#39;with strict mode code. See &#39; +<tr><td><a id="l2292"></a><a href="#l2292">2292</a><td>                &#39;http://www.ecma-international.org/ecma-262/5.1/#sec-C&#39;);<tr><td><a id="l2293"></a><a href="#l2293">2293</a><td>  }<tr><td><a id="l2294"></a><a href="#l2294">2294</a><td><tr><td><a id="l2295"></a><a href="#l2295">2295</a><td>  if (caller.superClass_) {<tr><td><a id="l2296"></a><a href="#l2296">2296</a><td>    // Copying using loop to avoid deop due to passing arguments object to<tr><td><a id="l2297"></a><a href="#l2297">2297</a><td>    // function. This is faster in many JS engines as of late 2014.<tr><td><a id="l2298"></a><a href="#l2298">2298</a><td>    var ctorArgs = new Array(arguments.length - 1);<tr><td><a id="l2299"></a><a href="#l2299">2299</a><td>    for (var i = 1; i &lt; arguments.length; i++) {<tr><td><a id="l2300"></a><a href="#l2300">2300</a><td>      ctorArgs[i - 1] = arguments[i];<tr><td><a id="l2301"></a><a href="#l2301">2301</a><td>    }<tr><td><a id="l2302"></a><a href="#l2302">2302</a><td>    // This is a constructor. Call the superclass constructor.<tr><td><a id="l2303"></a><a href="#l2303">2303</a><td>    return caller.superClass_.constructor.apply(me, ctorArgs);<tr><td><a id="l2304"></a><a href="#l2304">2304</a><td>  }<tr><td><a id="l2305"></a><a href="#l2305">2305</a><td><tr><td><a id="l2306"></a><a href="#l2306">2306</a><td>  // Copying using loop to avoid deop due to passing arguments object to<tr><td><a id="l2307"></a><a href="#l2307">2307</a><td>  // function. This is faster in many JS engines as of late 2014.<tr><td><a id="l2308"></a><a href="#l2308">2308</a><td>  var args = new Array(arguments.length - 2);<tr><td><a id="l2309"></a><a href="#l2309">2309</a><td>  for (var i = 2; i &lt; arguments.length; i++) {<tr><td><a id="l2310"></a><a href="#l2310">2310</a><td>    args[i - 2] = arguments[i];<tr><td><a id="l2311"></a><a href="#l2311">2311</a><td>  }<tr><td><a id="l2312"></a><a href="#l2312">2312</a><td>  var foundCaller = false;<tr><td><a id="l2313"></a><a href="#l2313">2313</a><td>  for (var ctor = me.constructor;<tr><td><a id="l2314"></a><a href="#l2314">2314</a><td>       ctor; ctor = ctor.superClass_ &amp;&amp; ctor.superClass_.constructor) {<tr><td><a id="l2315"></a><a href="#l2315">2315</a><td>    if (ctor.prototype[opt_methodName] === caller) {<tr><td><a id="l2316"></a><a href="#l2316">2316</a><td>      foundCaller = true;<tr><td><a id="l2317"></a><a href="#l2317">2317</a><td>    } else if (foundCaller) {<tr><td><a id="l2318"></a><a href="#l2318">2318</a><td>      return ctor.prototype[opt_methodName].apply(me, args);<tr><td><a id="l2319"></a><a href="#l2319">2319</a><td>    }<tr><td><a id="l2320"></a><a href="#l2320">2320</a><td>  }<tr><td><a id="l2321"></a><a href="#l2321">2321</a><td><tr><td><a id="l2322"></a><a href="#l2322">2322</a><td>  // If we did not find the caller in the prototype chain, then one of two<tr><td><a id="l2323"></a><a href="#l2323">2323</a><td>  // things happened:<tr><td><a id="l2324"></a><a href="#l2324">2324</a><td>  // 1) The caller is an instance method.<tr><td><a id="l2325"></a><a href="#l2325">2325</a><td>  // 2) This method was not called by the right caller.<tr><td><a id="l2326"></a><a href="#l2326">2326</a><td>  if (me[opt_methodName] === caller) {<tr><td><a id="l2327"></a><a href="#l2327">2327</a><td>    return me.constructor.prototype[opt_methodName].apply(me, args);<tr><td><a id="l2328"></a><a href="#l2328">2328</a><td>  } else {<tr><td><a id="l2329"></a><a href="#l2329">2329</a><td>    throw Error(<tr><td><a id="l2330"></a><a href="#l2330">2330</a><td>        &#39;goog.base called from a method of one name &#39; +<tr><td><a id="l2331"></a><a href="#l2331">2331</a><td>        &#39;to a method of a different name&#39;);<tr><td><a id="l2332"></a><a href="#l2332">2332</a><td>  }<tr><td><a id="l2333"></a><a href="#l2333">2333</a><td>};<tr><td><a id="l2334"></a><a href="#l2334">2334</a><td><tr><td><a id="l2335"></a><a href="#l2335">2335</a><td><tr><td><a id="l2336"></a><a href="#l2336">2336</a><td>/**<tr><td><a id="l2337"></a><a href="#l2337">2337</a><td> * Allow for aliasing within scope functions.  This function exists for<tr><td><a id="l2338"></a><a href="#l2338">2338</a><td> * uncompiled code - in compiled code the calls will be inlined and the aliases<tr><td><a id="l2339"></a><a href="#l2339">2339</a><td> * applied.  In uncompiled code the function is simply run since the aliases as<tr><td><a id="l2340"></a><a href="#l2340">2340</a><td> * written are valid JavaScript.<tr><td><a id="l2341"></a><a href="#l2341">2341</a><td> *<tr><td><a id="l2342"></a><a href="#l2342">2342</a><td> *<tr><td><a id="l2343"></a><a href="#l2343">2343</a><td> * @param {function()} fn Function to call.  This function can contain aliases<tr><td><a id="l2344"></a><a href="#l2344">2344</a><td> *     to namespaces (e.g. &quot;var dom = goog.dom&quot;) or classes<tr><td><a id="l2345"></a><a href="#l2345">2345</a><td> *     (e.g. &quot;var Timer = goog.Timer&quot;).<tr><td><a id="l2346"></a><a href="#l2346">2346</a><td> */<tr><td><a id="l2347"></a><a href="#l2347">2347</a><td>goog.scope = function(fn) {<tr><td><a id="l2348"></a><a href="#l2348">2348</a><td>  fn.call(goog.global);<tr><td><a id="l2349"></a><a href="#l2349">2349</a><td>};<tr><td><a id="l2350"></a><a href="#l2350">2350</a><td><tr><td><a id="l2351"></a><a href="#l2351">2351</a><td><tr><td><a id="l2352"></a><a href="#l2352">2352</a><td>/*<tr><td><a id="l2353"></a><a href="#l2353">2353</a><td> * To support uncompiled, strict mode bundles that use eval to divide source<tr><td><a id="l2354"></a><a href="#l2354">2354</a><td> * like so:<tr><td><a id="l2355"></a><a href="#l2355">2355</a><td> *    eval(&#39;someSource;//# sourceUrl sourcefile.js&#39;);<tr><td><a id="l2356"></a><a href="#l2356">2356</a><td> * We need to export the globally defined symbols &quot;goog&quot; and &quot;COMPILED&quot;.<tr><td><a id="l2357"></a><a href="#l2357">2357</a><td> * Exporting &quot;goog&quot; breaks the compiler optimizations, so we required that<tr><td><a id="l2358"></a><a href="#l2358">2358</a><td> * be defined externally.<tr><td><a id="l2359"></a><a href="#l2359">2359</a><td> * NOTE: We don&#39;t use goog.exportSymbol here because we don&#39;t want to trigger<tr><td><a id="l2360"></a><a href="#l2360">2360</a><td> * extern generation when that compiler option is enabled.<tr><td><a id="l2361"></a><a href="#l2361">2361</a><td> */<tr><td><a id="l2362"></a><a href="#l2362">2362</a><td>if (!COMPILED) {<tr><td><a id="l2363"></a><a href="#l2363">2363</a><td>  goog.global[&#39;COMPILED&#39;] = COMPILED;<tr><td><a id="l2364"></a><a href="#l2364">2364</a><td>}<tr><td><a id="l2365"></a><a href="#l2365">2365</a><td><tr><td><a id="l2366"></a><a href="#l2366">2366</a><td><tr><td><a id="l2367"></a><a href="#l2367">2367</a><td>//==============================================================================<tr><td><a id="l2368"></a><a href="#l2368">2368</a><td>// goog.defineClass implementation<tr><td><a id="l2369"></a><a href="#l2369">2369</a><td>//==============================================================================<tr><td><a id="l2370"></a><a href="#l2370">2370</a><td><tr><td><a id="l2371"></a><a href="#l2371">2371</a><td><tr><td><a id="l2372"></a><a href="#l2372">2372</a><td>/**<tr><td><a id="l2373"></a><a href="#l2373">2373</a><td> * Creates a restricted form of a Closure &quot;class&quot;:<tr><td><a id="l2374"></a><a href="#l2374">2374</a><td> *   - from the compiler&#39;s perspective, the instance returned from the<tr><td><a id="l2375"></a><a href="#l2375">2375</a><td> *     constructor is sealed (no new properties may be added).  This enables<tr><td><a id="l2376"></a><a href="#l2376">2376</a><td> *     better checks.<tr><td><a id="l2377"></a><a href="#l2377">2377</a><td> *   - the compiler will rewrite this definition to a form that is optimal<tr><td><a id="l2378"></a><a href="#l2378">2378</a><td> *     for type checking and optimization (initially this will be a more<tr><td><a id="l2379"></a><a href="#l2379">2379</a><td> *     traditional form).<tr><td><a id="l2380"></a><a href="#l2380">2380</a><td> *<tr><td><a id="l2381"></a><a href="#l2381">2381</a><td> * @param {Function} superClass The superclass, Object or null.<tr><td><a id="l2382"></a><a href="#l2382">2382</a><td> * @param {goog.defineClass.ClassDescriptor} def<tr><td><a id="l2383"></a><a href="#l2383">2383</a><td> *     An object literal describing<tr><td><a id="l2384"></a><a href="#l2384">2384</a><td> *     the class.  It may have the following properties:<tr><td><a id="l2385"></a><a href="#l2385">2385</a><td> *     &quot;constructor&quot;: the constructor function<tr><td><a id="l2386"></a><a href="#l2386">2386</a><td> *     &quot;statics&quot;: an object literal containing methods to add to the constructor<tr><td><a id="l2387"></a><a href="#l2387">2387</a><td> *        as &quot;static&quot; methods or a function that will receive the constructor<tr><td><a id="l2388"></a><a href="#l2388">2388</a><td> *        function as its only parameter to which static properties can<tr><td><a id="l2389"></a><a href="#l2389">2389</a><td> *        be added.<tr><td><a id="l2390"></a><a href="#l2390">2390</a><td> *     all other properties are added to the prototype.<tr><td><a id="l2391"></a><a href="#l2391">2391</a><td> * @return {!Function} The class constructor.<tr><td><a id="l2392"></a><a href="#l2392">2392</a><td> */<tr><td><a id="l2393"></a><a href="#l2393">2393</a><td>goog.defineClass = function(superClass, def) {<tr><td><a id="l2394"></a><a href="#l2394">2394</a><td>  // TODO(johnlenz): consider making the superClass an optional parameter.<tr><td><a id="l2395"></a><a href="#l2395">2395</a><td>  var constructor = def.constructor;<tr><td><a id="l2396"></a><a href="#l2396">2396</a><td>  var statics = def.statics;<tr><td><a id="l2397"></a><a href="#l2397">2397</a><td>  // Wrap the constructor prior to setting up the prototype and static methods.<tr><td><a id="l2398"></a><a href="#l2398">2398</a><td>  if (!constructor || constructor == Object.prototype.constructor) {<tr><td><a id="l2399"></a><a href="#l2399">2399</a><td>    constructor = function() {<tr><td><a id="l2400"></a><a href="#l2400">2400</a><td>      throw Error(&#39;cannot instantiate an interface (no constructor defined).&#39;);<tr><td><a id="l2401"></a><a href="#l2401">2401</a><td>    };<tr><td><a id="l2402"></a><a href="#l2402">2402</a><td>  }<tr><td><a id="l2403"></a><a href="#l2403">2403</a><td><tr><td><a id="l2404"></a><a href="#l2404">2404</a><td>  var cls = goog.defineClass.createSealingConstructor_(constructor, superClass);<tr><td><a id="l2405"></a><a href="#l2405">2405</a><td>  if (superClass) {<tr><td><a id="l2406"></a><a href="#l2406">2406</a><td>    goog.inherits(cls, superClass);<tr><td><a id="l2407"></a><a href="#l2407">2407</a><td>  }<tr><td><a id="l2408"></a><a href="#l2408">2408</a><td><tr><td><a id="l2409"></a><a href="#l2409">2409</a><td>  // Remove all the properties that should not be copied to the prototype.<tr><td><a id="l2410"></a><a href="#l2410">2410</a><td>  delete def.constructor;<tr><td><a id="l2411"></a><a href="#l2411">2411</a><td>  delete def.statics;<tr><td><a id="l2412"></a><a href="#l2412">2412</a><td><tr><td><a id="l2413"></a><a href="#l2413">2413</a><td>  goog.defineClass.applyProperties_(cls.prototype, def);<tr><td><a id="l2414"></a><a href="#l2414">2414</a><td>  if (statics != null) {<tr><td><a id="l2415"></a><a href="#l2415">2415</a><td>    if (statics instanceof Function) {<tr><td><a id="l2416"></a><a href="#l2416">2416</a><td>      statics(cls);<tr><td><a id="l2417"></a><a href="#l2417">2417</a><td>    } else {<tr><td><a id="l2418"></a><a href="#l2418">2418</a><td>      goog.defineClass.applyProperties_(cls, statics);<tr><td><a id="l2419"></a><a href="#l2419">2419</a><td>    }<tr><td><a id="l2420"></a><a href="#l2420">2420</a><td>  }<tr><td><a id="l2421"></a><a href="#l2421">2421</a><td><tr><td><a id="l2422"></a><a href="#l2422">2422</a><td>  return cls;<tr><td><a id="l2423"></a><a href="#l2423">2423</a><td>};<tr><td><a id="l2424"></a><a href="#l2424">2424</a><td><tr><td><a id="l2425"></a><a href="#l2425">2425</a><td><tr><td><a id="l2426"></a><a href="#l2426">2426</a><td>/**<tr><td><a id="l2427"></a><a href="#l2427">2427</a><td> * @typedef {<tr><td><a id="l2428"></a><a href="#l2428">2428</a><td> *     !Object|<tr><td><a id="l2429"></a><a href="#l2429">2429</a><td> *     {constructor:!Function}|<tr><td><a id="l2430"></a><a href="#l2430">2430</a><td> *     {constructor:!Function, statics:(Object|function(Function):void)}}<tr><td><a id="l2431"></a><a href="#l2431">2431</a><td> * @suppress {missingProvide}<tr><td><a id="l2432"></a><a href="#l2432">2432</a><td> */<tr><td><a id="l2433"></a><a href="#l2433">2433</a><td>goog.defineClass.ClassDescriptor;<tr><td><a id="l2434"></a><a href="#l2434">2434</a><td><tr><td><a id="l2435"></a><a href="#l2435">2435</a><td><tr><td><a id="l2436"></a><a href="#l2436">2436</a><td>/**<tr><td><a id="l2437"></a><a href="#l2437">2437</a><td> * @define {boolean} Whether the instances returned by<tr><td><a id="l2438"></a><a href="#l2438">2438</a><td> * goog.defineClass should be sealed when possible.<tr><td><a id="l2439"></a><a href="#l2439">2439</a><td> */<tr><td><a id="l2440"></a><a href="#l2440">2440</a><td>goog.define(&#39;goog.defineClass.SEAL_CLASS_INSTANCES&#39;, goog.DEBUG);<tr><td><a id="l2441"></a><a href="#l2441">2441</a><td><tr><td><a id="l2442"></a><a href="#l2442">2442</a><td><tr><td><a id="l2443"></a><a href="#l2443">2443</a><td>/**<tr><td><a id="l2444"></a><a href="#l2444">2444</a><td> * If goog.defineClass.SEAL_CLASS_INSTANCES is enabled and Object.seal is<tr><td><a id="l2445"></a><a href="#l2445">2445</a><td> * defined, this function will wrap the constructor in a function that seals the<tr><td><a id="l2446"></a><a href="#l2446">2446</a><td> * results of the provided constructor function.<tr><td><a id="l2447"></a><a href="#l2447">2447</a><td> *<tr><td><a id="l2448"></a><a href="#l2448">2448</a><td> * @param {!Function} ctr The constructor whose results maybe be sealed.<tr><td><a id="l2449"></a><a href="#l2449">2449</a><td> * @param {Function} superClass The superclass constructor.<tr><td><a id="l2450"></a><a href="#l2450">2450</a><td> * @return {!Function} The replacement constructor.<tr><td><a id="l2451"></a><a href="#l2451">2451</a><td> * @private<tr><td><a id="l2452"></a><a href="#l2452">2452</a><td> */<tr><td><a id="l2453"></a><a href="#l2453">2453</a><td>goog.defineClass.createSealingConstructor_ = function(ctr, superClass) {<tr><td><a id="l2454"></a><a href="#l2454">2454</a><td>  if (goog.defineClass.SEAL_CLASS_INSTANCES &amp;&amp;<tr><td><a id="l2455"></a><a href="#l2455">2455</a><td>      Object.seal instanceof Function) {<tr><td><a id="l2456"></a><a href="#l2456">2456</a><td>    // Don&#39;t seal subclasses of unsealable-tagged legacy classes.<tr><td><a id="l2457"></a><a href="#l2457">2457</a><td>    if (superClass &amp;&amp; superClass.prototype &amp;&amp;<tr><td><a id="l2458"></a><a href="#l2458">2458</a><td>        superClass.prototype[goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_]) {<tr><td><a id="l2459"></a><a href="#l2459">2459</a><td>      return ctr;<tr><td><a id="l2460"></a><a href="#l2460">2460</a><td>    }<tr><td><a id="l2461"></a><a href="#l2461">2461</a><td>    /**<tr><td><a id="l2462"></a><a href="#l2462">2462</a><td>     * @this {Object}<tr><td><a id="l2463"></a><a href="#l2463">2463</a><td>     * @return {?}<tr><td><a id="l2464"></a><a href="#l2464">2464</a><td>     */<tr><td><a id="l2465"></a><a href="#l2465">2465</a><td>    var wrappedCtr = function() {<tr><td><a id="l2466"></a><a href="#l2466">2466</a><td>      // Don&#39;t seal an instance of a subclass when it calls the constructor of<tr><td><a id="l2467"></a><a href="#l2467">2467</a><td>      // its super class as there is most likely still setup to do.<tr><td><a id="l2468"></a><a href="#l2468">2468</a><td>      var instance = ctr.apply(this, arguments) || this;<tr><td><a id="l2469"></a><a href="#l2469">2469</a><td>      instance[goog.UID_PROPERTY_] = instance[goog.UID_PROPERTY_];<tr><td><a id="l2470"></a><a href="#l2470">2470</a><td>      if (this.constructor === wrappedCtr) {<tr><td><a id="l2471"></a><a href="#l2471">2471</a><td>        Object.seal(instance);<tr><td><a id="l2472"></a><a href="#l2472">2472</a><td>      }<tr><td><a id="l2473"></a><a href="#l2473">2473</a><td>      return instance;<tr><td><a id="l2474"></a><a href="#l2474">2474</a><td>    };<tr><td><a id="l2475"></a><a href="#l2475">2475</a><td>    return wrappedCtr;<tr><td><a id="l2476"></a><a href="#l2476">2476</a><td>  }<tr><td><a id="l2477"></a><a href="#l2477">2477</a><td>  return ctr;<tr><td><a id="l2478"></a><a href="#l2478">2478</a><td>};<tr><td><a id="l2479"></a><a href="#l2479">2479</a><td><tr><td><a id="l2480"></a><a href="#l2480">2480</a><td><tr><td><a id="l2481"></a><a href="#l2481">2481</a><td>// TODO(johnlenz): share these values with the goog.object<tr><td><a id="l2482"></a><a href="#l2482">2482</a><td>/**<tr><td><a id="l2483"></a><a href="#l2483">2483</a><td> * The names of the fields that are defined on Object.prototype.<tr><td><a id="l2484"></a><a href="#l2484">2484</a><td> * @type {!Array&lt;string&gt;}<tr><td><a id="l2485"></a><a href="#l2485">2485</a><td> * @private<tr><td><a id="l2486"></a><a href="#l2486">2486</a><td> * @const<tr><td><a id="l2487"></a><a href="#l2487">2487</a><td> */<tr><td><a id="l2488"></a><a href="#l2488">2488</a><td>goog.defineClass.OBJECT_PROTOTYPE_FIELDS_ = [<tr><td><a id="l2489"></a><a href="#l2489">2489</a><td>  &#39;constructor&#39;,<tr><td><a id="l2490"></a><a href="#l2490">2490</a><td>  &#39;hasOwnProperty&#39;,<tr><td><a id="l2491"></a><a href="#l2491">2491</a><td>  &#39;isPrototypeOf&#39;,<tr><td><a id="l2492"></a><a href="#l2492">2492</a><td>  &#39;propertyIsEnumerable&#39;,<tr><td><a id="l2493"></a><a href="#l2493">2493</a><td>  &#39;toLocaleString&#39;,<tr><td><a id="l2494"></a><a href="#l2494">2494</a><td>  &#39;toString&#39;,<tr><td><a id="l2495"></a><a href="#l2495">2495</a><td>  &#39;valueOf&#39;<tr><td><a id="l2496"></a><a href="#l2496">2496</a><td>];<tr><td><a id="l2497"></a><a href="#l2497">2497</a><td><tr><td><a id="l2498"></a><a href="#l2498">2498</a><td><tr><td><a id="l2499"></a><a href="#l2499">2499</a><td>// TODO(johnlenz): share this function with the goog.object<tr><td><a id="l2500"></a><a href="#l2500">2500</a><td>/**<tr><td><a id="l2501"></a><a href="#l2501">2501</a><td> * @param {!Object} target The object to add properties to.<tr><td><a id="l2502"></a><a href="#l2502">2502</a><td> * @param {!Object} source The object to copy properties from.<tr><td><a id="l2503"></a><a href="#l2503">2503</a><td> * @private<tr><td><a id="l2504"></a><a href="#l2504">2504</a><td> */<tr><td><a id="l2505"></a><a href="#l2505">2505</a><td>goog.defineClass.applyProperties_ = function(target, source) {<tr><td><a id="l2506"></a><a href="#l2506">2506</a><td>  // TODO(johnlenz): update this to support ES5 getters/setters<tr><td><a id="l2507"></a><a href="#l2507">2507</a><td><tr><td><a id="l2508"></a><a href="#l2508">2508</a><td>  var key;<tr><td><a id="l2509"></a><a href="#l2509">2509</a><td>  for (key in source) {<tr><td><a id="l2510"></a><a href="#l2510">2510</a><td>    if (Object.prototype.hasOwnProperty.call(source, key)) {<tr><td><a id="l2511"></a><a href="#l2511">2511</a><td>      target[key] = source[key];<tr><td><a id="l2512"></a><a href="#l2512">2512</a><td>    }<tr><td><a id="l2513"></a><a href="#l2513">2513</a><td>  }<tr><td><a id="l2514"></a><a href="#l2514">2514</a><td><tr><td><a id="l2515"></a><a href="#l2515">2515</a><td>  // For IE the for-in-loop does not contain any properties that are not<tr><td><a id="l2516"></a><a href="#l2516">2516</a><td>  // enumerable on the prototype object (for example isPrototypeOf from<tr><td><a id="l2517"></a><a href="#l2517">2517</a><td>  // Object.prototype) and it will also not include &#39;replace&#39; on objects that<tr><td><a id="l2518"></a><a href="#l2518">2518</a><td>  // extend String and change &#39;replace&#39; (not that it is common for anyone to<tr><td><a id="l2519"></a><a href="#l2519">2519</a><td>  // extend anything except Object).<tr><td><a id="l2520"></a><a href="#l2520">2520</a><td>  for (var i = 0; i &lt; goog.defineClass.OBJECT_PROTOTYPE_FIELDS_.length; i++) {<tr><td><a id="l2521"></a><a href="#l2521">2521</a><td>    key = goog.defineClass.OBJECT_PROTOTYPE_FIELDS_[i];<tr><td><a id="l2522"></a><a href="#l2522">2522</a><td>    if (Object.prototype.hasOwnProperty.call(source, key)) {<tr><td><a id="l2523"></a><a href="#l2523">2523</a><td>      target[key] = source[key];<tr><td><a id="l2524"></a><a href="#l2524">2524</a><td>    }<tr><td><a id="l2525"></a><a href="#l2525">2525</a><td>  }<tr><td><a id="l2526"></a><a href="#l2526">2526</a><td>};<tr><td><a id="l2527"></a><a href="#l2527">2527</a><td><tr><td><a id="l2528"></a><a href="#l2528">2528</a><td><tr><td><a id="l2529"></a><a href="#l2529">2529</a><td>/**<tr><td><a id="l2530"></a><a href="#l2530">2530</a><td> * Sealing classes breaks the older idiom of assigning properties on the<tr><td><a id="l2531"></a><a href="#l2531">2531</a><td> * prototype rather than in the constructor.  As such, goog.defineClass<tr><td><a id="l2532"></a><a href="#l2532">2532</a><td> * must not seal subclasses of these old-style classes until they are fixed.<tr><td><a id="l2533"></a><a href="#l2533">2533</a><td> * Until then, this marks a class as &quot;broken&quot;, instructing defineClass<tr><td><a id="l2534"></a><a href="#l2534">2534</a><td> * not to seal subclasses.<tr><td><a id="l2535"></a><a href="#l2535">2535</a><td> * @param {!Function} ctr The legacy constructor to tag as unsealable.<tr><td><a id="l2536"></a><a href="#l2536">2536</a><td> */<tr><td><a id="l2537"></a><a href="#l2537">2537</a><td>goog.tagUnsealableClass = function(ctr) {<tr><td><a id="l2538"></a><a href="#l2538">2538</a><td>  if (!COMPILED &amp;&amp; goog.defineClass.SEAL_CLASS_INSTANCES) {<tr><td><a id="l2539"></a><a href="#l2539">2539</a><td>    ctr.prototype[goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_] = true;<tr><td><a id="l2540"></a><a href="#l2540">2540</a><td>  }<tr><td><a id="l2541"></a><a href="#l2541">2541</a><td>};<tr><td><a id="l2542"></a><a href="#l2542">2542</a><td><tr><td><a id="l2543"></a><a href="#l2543">2543</a><td><tr><td><a id="l2544"></a><a href="#l2544">2544</a><td>/**<tr><td><a id="l2545"></a><a href="#l2545">2545</a><td> * Name for unsealable tag property.<tr><td><a id="l2546"></a><a href="#l2546">2546</a><td> * @const @private {string}<tr><td><a id="l2547"></a><a href="#l2547">2547</a><td> */<tr><td><a id="l2548"></a><a href="#l2548">2548</a><td>goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_ = &#39;goog_defineClass_legacy_unsealable&#39;;</table></div></article><nav><h3><a href="../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/debug/debug.js.src.html b/docs/source/lib/goog/debug/debug.js.src.html
new file mode 100644
index 0000000..11ee87e
--- /dev/null
+++ b/docs/source/lib/goog/debug/debug.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>debug.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/debug/debug.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Logging and debugging utilities.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @see ../demos/debug.html<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.debug&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.html.SafeHtml&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.html.SafeUrl&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.html.uncheckedconversions&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.structs.Set&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/** @define {boolean} Whether logging should be enabled. */<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.define(&#39;goog.debug.LOGGING_ENABLED&#39;, goog.DEBUG);<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>/**<tr><td><a id="l37"></a><a href="#l37">37</a><td> * Catches onerror events fired by windows and similar objects.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @param {function(Object)} logFunc The function to call with the error<tr><td><a id="l39"></a><a href="#l39">39</a><td> *    information.<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @param {boolean=} opt_cancel Whether to stop the error from reaching the<tr><td><a id="l41"></a><a href="#l41">41</a><td> *    browser.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @param {Object=} opt_target Object that fires onerror events.<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.debug.catchErrors = function(logFunc, opt_cancel, opt_target) {<tr><td><a id="l45"></a><a href="#l45">45</a><td>  var target = opt_target || goog.global;<tr><td><a id="l46"></a><a href="#l46">46</a><td>  var oldErrorHandler = target.onerror;<tr><td><a id="l47"></a><a href="#l47">47</a><td>  var retVal = !!opt_cancel;<tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td>  // Chrome interprets onerror return value backwards (http://crbug.com/92062)<tr><td><a id="l50"></a><a href="#l50">50</a><td>  // until it was fixed in webkit revision r94061 (Webkit 535.3). This<tr><td><a id="l51"></a><a href="#l51">51</a><td>  // workaround still needs to be skipped in Safari after the webkit change<tr><td><a id="l52"></a><a href="#l52">52</a><td>  // gets pushed out in Safari.<tr><td><a id="l53"></a><a href="#l53">53</a><td>  // See https://bugs.webkit.org/show_bug.cgi?id=67119<tr><td><a id="l54"></a><a href="#l54">54</a><td>  if (goog.userAgent.WEBKIT &amp;&amp;<tr><td><a id="l55"></a><a href="#l55">55</a><td>      !goog.userAgent.isVersionOrHigher(&#39;535.3&#39;)) {<tr><td><a id="l56"></a><a href="#l56">56</a><td>    retVal = !retVal;<tr><td><a id="l57"></a><a href="#l57">57</a><td>  }<tr><td><a id="l58"></a><a href="#l58">58</a><td><tr><td><a id="l59"></a><a href="#l59">59</a><td>  /**<tr><td><a id="l60"></a><a href="#l60">60</a><td>   * New onerror handler for this target. This onerror handler follows the spec<tr><td><a id="l61"></a><a href="#l61">61</a><td>   * according to<tr><td><a id="l62"></a><a href="#l62">62</a><td>   * http://www.whatwg.org/specs/web-apps/current-work/#runtime-script-errors<tr><td><a id="l63"></a><a href="#l63">63</a><td>   * The spec was changed in August 2013 to support receiving column information<tr><td><a id="l64"></a><a href="#l64">64</a><td>   * and an error object for all scripts on the same origin or cross origin<tr><td><a id="l65"></a><a href="#l65">65</a><td>   * scripts with the proper headers. See<tr><td><a id="l66"></a><a href="#l66">66</a><td>   * https://mikewest.org/2013/08/debugging-runtime-errors-with-window-onerror<tr><td><a id="l67"></a><a href="#l67">67</a><td>   *<tr><td><a id="l68"></a><a href="#l68">68</a><td>   * @param {string} message The error message. For cross-origin errors, this<tr><td><a id="l69"></a><a href="#l69">69</a><td>   *     will be scrubbed to just &quot;Script error.&quot;. For new browsers that have<tr><td><a id="l70"></a><a href="#l70">70</a><td>   *     updated to follow the latest spec, errors that come from origins that<tr><td><a id="l71"></a><a href="#l71">71</a><td>   *     have proper cross origin headers will not be scrubbed.<tr><td><a id="l72"></a><a href="#l72">72</a><td>   * @param {string} url The URL of the script that caused the error. The URL<tr><td><a id="l73"></a><a href="#l73">73</a><td>   *     will be scrubbed to &quot;&quot; for cross origin scripts unless the script has<tr><td><a id="l74"></a><a href="#l74">74</a><td>   *     proper cross origin headers and the browser has updated to the latest<tr><td><a id="l75"></a><a href="#l75">75</a><td>   *     spec.<tr><td><a id="l76"></a><a href="#l76">76</a><td>   * @param {number} line The line number in the script that the error<tr><td><a id="l77"></a><a href="#l77">77</a><td>   *     occurred on.<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * @param {number=} opt_col The optional column number that the error<tr><td><a id="l79"></a><a href="#l79">79</a><td>   *     occurred on. Only browsers that have updated to the latest spec will<tr><td><a id="l80"></a><a href="#l80">80</a><td>   *     include this.<tr><td><a id="l81"></a><a href="#l81">81</a><td>   * @param {Error=} opt_error The optional actual error object for this<tr><td><a id="l82"></a><a href="#l82">82</a><td>   *     error that should include the stack. Only browsers that have updated<tr><td><a id="l83"></a><a href="#l83">83</a><td>   *     to the latest spec will inlude this parameter.<tr><td><a id="l84"></a><a href="#l84">84</a><td>   * @return {boolean} Whether to prevent the error from reaching the browser.<tr><td><a id="l85"></a><a href="#l85">85</a><td>   */<tr><td><a id="l86"></a><a href="#l86">86</a><td>  target.onerror = function(message, url, line, opt_col, opt_error) {<tr><td><a id="l87"></a><a href="#l87">87</a><td>    if (oldErrorHandler) {<tr><td><a id="l88"></a><a href="#l88">88</a><td>      oldErrorHandler(message, url, line, opt_col, opt_error);<tr><td><a id="l89"></a><a href="#l89">89</a><td>    }<tr><td><a id="l90"></a><a href="#l90">90</a><td>    logFunc({<tr><td><a id="l91"></a><a href="#l91">91</a><td>      message: message,<tr><td><a id="l92"></a><a href="#l92">92</a><td>      fileName: url,<tr><td><a id="l93"></a><a href="#l93">93</a><td>      line: line,<tr><td><a id="l94"></a><a href="#l94">94</a><td>      col: opt_col,<tr><td><a id="l95"></a><a href="#l95">95</a><td>      error: opt_error<tr><td><a id="l96"></a><a href="#l96">96</a><td>    });<tr><td><a id="l97"></a><a href="#l97">97</a><td>    return retVal;<tr><td><a id="l98"></a><a href="#l98">98</a><td>  };<tr><td><a id="l99"></a><a href="#l99">99</a><td>};<tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td>/**<tr><td><a id="l103"></a><a href="#l103">103</a><td> * Creates a string representing an object and all its properties.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @param {Object|null|undefined} obj Object to expose.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {boolean=} opt_showFn Show the functions as well as the properties,<tr><td><a id="l106"></a><a href="#l106">106</a><td> *     default is false.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @return {string} The string representation of {@code obj}.<tr><td><a id="l108"></a><a href="#l108">108</a><td> */<tr><td><a id="l109"></a><a href="#l109">109</a><td>goog.debug.expose = function(obj, opt_showFn) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>  if (typeof obj == &#39;undefined&#39;) {<tr><td><a id="l111"></a><a href="#l111">111</a><td>    return &#39;undefined&#39;;<tr><td><a id="l112"></a><a href="#l112">112</a><td>  }<tr><td><a id="l113"></a><a href="#l113">113</a><td>  if (obj == null) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>    return &#39;NULL&#39;;<tr><td><a id="l115"></a><a href="#l115">115</a><td>  }<tr><td><a id="l116"></a><a href="#l116">116</a><td>  var str = [];<tr><td><a id="l117"></a><a href="#l117">117</a><td><tr><td><a id="l118"></a><a href="#l118">118</a><td>  for (var x in obj) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>    if (!opt_showFn &amp;&amp; goog.isFunction(obj[x])) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>      continue;<tr><td><a id="l121"></a><a href="#l121">121</a><td>    }<tr><td><a id="l122"></a><a href="#l122">122</a><td>    var s = x + &#39; = &#39;;<tr><td><a id="l123"></a><a href="#l123">123</a><td>    /** @preserveTry */<tr><td><a id="l124"></a><a href="#l124">124</a><td>    try {<tr><td><a id="l125"></a><a href="#l125">125</a><td>      s += obj[x];<tr><td><a id="l126"></a><a href="#l126">126</a><td>    } catch (e) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>      s += &#39;*** &#39; + e + &#39; ***&#39;;<tr><td><a id="l128"></a><a href="#l128">128</a><td>    }<tr><td><a id="l129"></a><a href="#l129">129</a><td>    str.push(s);<tr><td><a id="l130"></a><a href="#l130">130</a><td>  }<tr><td><a id="l131"></a><a href="#l131">131</a><td>  return str.join(&#39;\n&#39;);<tr><td><a id="l132"></a><a href="#l132">132</a><td>};<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>/**<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Creates a string representing a given primitive or object, and for an<tr><td><a id="l137"></a><a href="#l137">137</a><td> * object, all its properties and nested objects.  WARNING: If an object is<tr><td><a id="l138"></a><a href="#l138">138</a><td> * given, it and all its nested objects will be modified.  To detect reference<tr><td><a id="l139"></a><a href="#l139">139</a><td> * cycles, this method identifies objects using goog.getUid() which mutates the<tr><td><a id="l140"></a><a href="#l140">140</a><td> * object.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {*} obj Object to expose.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {boolean=} opt_showFn Also show properties that are functions (by<tr><td><a id="l143"></a><a href="#l143">143</a><td> *     default, functions are omitted).<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @return {string} A string representation of {@code obj}.<tr><td><a id="l145"></a><a href="#l145">145</a><td> */<tr><td><a id="l146"></a><a href="#l146">146</a><td>goog.debug.deepExpose = function(obj, opt_showFn) {<tr><td><a id="l147"></a><a href="#l147">147</a><td>  var str = [];<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>  var helper = function(obj, space, parentSeen) {<tr><td><a id="l150"></a><a href="#l150">150</a><td>    var nestspace = space + &#39;  &#39;;<tr><td><a id="l151"></a><a href="#l151">151</a><td>    var seen = new goog.structs.Set(parentSeen);<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>    var indentMultiline = function(str) {<tr><td><a id="l154"></a><a href="#l154">154</a><td>      return str.replace(/\n/g, &#39;\n&#39; + space);<tr><td><a id="l155"></a><a href="#l155">155</a><td>    };<tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td>    /** @preserveTry */<tr><td><a id="l158"></a><a href="#l158">158</a><td>    try {<tr><td><a id="l159"></a><a href="#l159">159</a><td>      if (!goog.isDef(obj)) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>        str.push(&#39;undefined&#39;);<tr><td><a id="l161"></a><a href="#l161">161</a><td>      } else if (goog.isNull(obj)) {<tr><td><a id="l162"></a><a href="#l162">162</a><td>        str.push(&#39;NULL&#39;);<tr><td><a id="l163"></a><a href="#l163">163</a><td>      } else if (goog.isString(obj)) {<tr><td><a id="l164"></a><a href="#l164">164</a><td>        str.push(&#39;&quot;&#39; + indentMultiline(obj) + &#39;&quot;&#39;);<tr><td><a id="l165"></a><a href="#l165">165</a><td>      } else if (goog.isFunction(obj)) {<tr><td><a id="l166"></a><a href="#l166">166</a><td>        str.push(indentMultiline(String(obj)));<tr><td><a id="l167"></a><a href="#l167">167</a><td>      } else if (goog.isObject(obj)) {<tr><td><a id="l168"></a><a href="#l168">168</a><td>        if (seen.contains(obj)) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>          str.push(&#39;*** reference loop detected ***&#39;);<tr><td><a id="l170"></a><a href="#l170">170</a><td>        } else {<tr><td><a id="l171"></a><a href="#l171">171</a><td>          seen.add(obj);<tr><td><a id="l172"></a><a href="#l172">172</a><td>          str.push(&#39;{&#39;);<tr><td><a id="l173"></a><a href="#l173">173</a><td>          for (var x in obj) {<tr><td><a id="l174"></a><a href="#l174">174</a><td>            if (!opt_showFn &amp;&amp; goog.isFunction(obj[x])) {<tr><td><a id="l175"></a><a href="#l175">175</a><td>              continue;<tr><td><a id="l176"></a><a href="#l176">176</a><td>            }<tr><td><a id="l177"></a><a href="#l177">177</a><td>            str.push(&#39;\n&#39;);<tr><td><a id="l178"></a><a href="#l178">178</a><td>            str.push(nestspace);<tr><td><a id="l179"></a><a href="#l179">179</a><td>            str.push(x + &#39; = &#39;);<tr><td><a id="l180"></a><a href="#l180">180</a><td>            helper(obj[x], nestspace, seen);<tr><td><a id="l181"></a><a href="#l181">181</a><td>          }<tr><td><a id="l182"></a><a href="#l182">182</a><td>          str.push(&#39;\n&#39; + space + &#39;}&#39;);<tr><td><a id="l183"></a><a href="#l183">183</a><td>        }<tr><td><a id="l184"></a><a href="#l184">184</a><td>      } else {<tr><td><a id="l185"></a><a href="#l185">185</a><td>        str.push(obj);<tr><td><a id="l186"></a><a href="#l186">186</a><td>      }<tr><td><a id="l187"></a><a href="#l187">187</a><td>    } catch (e) {<tr><td><a id="l188"></a><a href="#l188">188</a><td>      str.push(&#39;*** &#39; + e + &#39; ***&#39;);<tr><td><a id="l189"></a><a href="#l189">189</a><td>    }<tr><td><a id="l190"></a><a href="#l190">190</a><td>  };<tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td>  helper(obj, &#39;&#39;, new goog.structs.Set());<tr><td><a id="l193"></a><a href="#l193">193</a><td>  return str.join(&#39;&#39;);<tr><td><a id="l194"></a><a href="#l194">194</a><td>};<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/**<tr><td><a id="l198"></a><a href="#l198">198</a><td> * Recursively outputs a nested array as a string.<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @param {Array&lt;?&gt;} arr The array.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @return {string} String representing nested array.<tr><td><a id="l201"></a><a href="#l201">201</a><td> */<tr><td><a id="l202"></a><a href="#l202">202</a><td>goog.debug.exposeArray = function(arr) {<tr><td><a id="l203"></a><a href="#l203">203</a><td>  var str = [];<tr><td><a id="l204"></a><a href="#l204">204</a><td>  for (var i = 0; i &lt; arr.length; i++) {<tr><td><a id="l205"></a><a href="#l205">205</a><td>    if (goog.isArray(arr[i])) {<tr><td><a id="l206"></a><a href="#l206">206</a><td>      str.push(goog.debug.exposeArray(arr[i]));<tr><td><a id="l207"></a><a href="#l207">207</a><td>    } else {<tr><td><a id="l208"></a><a href="#l208">208</a><td>      str.push(arr[i]);<tr><td><a id="l209"></a><a href="#l209">209</a><td>    }<tr><td><a id="l210"></a><a href="#l210">210</a><td>  }<tr><td><a id="l211"></a><a href="#l211">211</a><td>  return &#39;[ &#39; + str.join(&#39;, &#39;) + &#39; ]&#39;;<tr><td><a id="l212"></a><a href="#l212">212</a><td>};<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * Exposes an exception that has been caught by a try...catch and outputs the<tr><td><a id="l217"></a><a href="#l217">217</a><td> * error as HTML with a stack trace.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @param {Object} err Error object or string.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @param {Function=} opt_fn Optional function to start stack trace from.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @return {string} Details of exception, as HTML.<tr><td><a id="l221"></a><a href="#l221">221</a><td> */<tr><td><a id="l222"></a><a href="#l222">222</a><td>goog.debug.exposeException = function(err, opt_fn) {<tr><td><a id="l223"></a><a href="#l223">223</a><td>  var html = goog.debug.exposeExceptionAsHtml(err, opt_fn);<tr><td><a id="l224"></a><a href="#l224">224</a><td>  return goog.html.SafeHtml.unwrap(html);<tr><td><a id="l225"></a><a href="#l225">225</a><td>};<tr><td><a id="l226"></a><a href="#l226">226</a><td><tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td>/**<tr><td><a id="l229"></a><a href="#l229">229</a><td> * Exposes an exception that has been caught by a try...catch and outputs the<tr><td><a id="l230"></a><a href="#l230">230</a><td> * error with a stack trace.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @param {Object} err Error object or string.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @param {Function=} opt_fn Optional function to start stack trace from.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @return {!goog.html.SafeHtml} Details of exception.<tr><td><a id="l234"></a><a href="#l234">234</a><td> */<tr><td><a id="l235"></a><a href="#l235">235</a><td>goog.debug.exposeExceptionAsHtml = function(err, opt_fn) {<tr><td><a id="l236"></a><a href="#l236">236</a><td>  /** @preserveTry */<tr><td><a id="l237"></a><a href="#l237">237</a><td>  try {<tr><td><a id="l238"></a><a href="#l238">238</a><td>    var e = goog.debug.normalizeErrorObject(err);<tr><td><a id="l239"></a><a href="#l239">239</a><td>    // Create the error message<tr><td><a id="l240"></a><a href="#l240">240</a><td>    var viewSourceUrl = goog.debug.createViewSourceUrl_(e.fileName);<tr><td><a id="l241"></a><a href="#l241">241</a><td>    var error = goog.html.SafeHtml.concat(<tr><td><a id="l242"></a><a href="#l242">242</a><td>        goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(<tr><td><a id="l243"></a><a href="#l243">243</a><td>            &#39;Message: &#39; + e.message + &#39;\nUrl: &#39;),<tr><td><a id="l244"></a><a href="#l244">244</a><td>        goog.html.SafeHtml.create(&#39;a&#39;,<tr><td><a id="l245"></a><a href="#l245">245</a><td>            {href: viewSourceUrl, target: &#39;_new&#39;}, e.fileName),<tr><td><a id="l246"></a><a href="#l246">246</a><td>        goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(<tr><td><a id="l247"></a><a href="#l247">247</a><td>            &#39;\nLine: &#39; + e.lineNumber + &#39;\n\nBrowser stack:\n&#39; +<tr><td><a id="l248"></a><a href="#l248">248</a><td>            e.stack + &#39;-&gt; &#39; + &#39;[end]\n\nJS stack traversal:\n&#39; +<tr><td><a id="l249"></a><a href="#l249">249</a><td>            goog.debug.getStacktrace(opt_fn) + &#39;-&gt; &#39;));<tr><td><a id="l250"></a><a href="#l250">250</a><td>    return error;<tr><td><a id="l251"></a><a href="#l251">251</a><td>  } catch (e2) {<tr><td><a id="l252"></a><a href="#l252">252</a><td>    return goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(<tr><td><a id="l253"></a><a href="#l253">253</a><td>        &#39;Exception trying to expose exception! You win, we lose. &#39; + e2);<tr><td><a id="l254"></a><a href="#l254">254</a><td>  }<tr><td><a id="l255"></a><a href="#l255">255</a><td>};<tr><td><a id="l256"></a><a href="#l256">256</a><td><tr><td><a id="l257"></a><a href="#l257">257</a><td><tr><td><a id="l258"></a><a href="#l258">258</a><td>/**<tr><td><a id="l259"></a><a href="#l259">259</a><td> * @param {?string=} opt_fileName<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @return {!goog.html.SafeUrl} SafeUrl with view-source scheme, pointing at<tr><td><a id="l261"></a><a href="#l261">261</a><td> *     fileName.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @private<tr><td><a id="l263"></a><a href="#l263">263</a><td> */<tr><td><a id="l264"></a><a href="#l264">264</a><td>goog.debug.createViewSourceUrl_ = function(opt_fileName) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>  if (!goog.isDefAndNotNull(opt_fileName)) {<tr><td><a id="l266"></a><a href="#l266">266</a><td>    opt_fileName = &#39;&#39;;<tr><td><a id="l267"></a><a href="#l267">267</a><td>  }<tr><td><a id="l268"></a><a href="#l268">268</a><td>  if (!/^https?:\/\//i.test(opt_fileName)) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>    return goog.html.SafeUrl.fromConstant(<tr><td><a id="l270"></a><a href="#l270">270</a><td>        goog.string.Const.from(&#39;sanitizedviewsrc&#39;));<tr><td><a id="l271"></a><a href="#l271">271</a><td>  }<tr><td><a id="l272"></a><a href="#l272">272</a><td>  var sanitizedFileName = goog.html.SafeUrl.sanitize(opt_fileName);<tr><td><a id="l273"></a><a href="#l273">273</a><td>  return goog.html.uncheckedconversions.<tr><td><a id="l274"></a><a href="#l274">274</a><td>      safeUrlFromStringKnownToSatisfyTypeContract(<tr><td><a id="l275"></a><a href="#l275">275</a><td>          goog.string.Const.from(&#39;view-source scheme plus HTTP/HTTPS URL&#39;),<tr><td><a id="l276"></a><a href="#l276">276</a><td>          &#39;view-source:&#39; + goog.html.SafeUrl.unwrap(sanitizedFileName));<tr><td><a id="l277"></a><a href="#l277">277</a><td>};<tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td>/**<tr><td><a id="l281"></a><a href="#l281">281</a><td> * Normalizes the error/exception object between browsers.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @param {Object} err Raw error object.<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @return {!Object} Normalized error object.<tr><td><a id="l284"></a><a href="#l284">284</a><td> */<tr><td><a id="l285"></a><a href="#l285">285</a><td>goog.debug.normalizeErrorObject = function(err) {<tr><td><a id="l286"></a><a href="#l286">286</a><td>  var href = goog.getObjectByName(&#39;window.location.href&#39;);<tr><td><a id="l287"></a><a href="#l287">287</a><td>  if (goog.isString(err)) {<tr><td><a id="l288"></a><a href="#l288">288</a><td>    return {<tr><td><a id="l289"></a><a href="#l289">289</a><td>      &#39;message&#39;: err,<tr><td><a id="l290"></a><a href="#l290">290</a><td>      &#39;name&#39;: &#39;Unknown error&#39;,<tr><td><a id="l291"></a><a href="#l291">291</a><td>      &#39;lineNumber&#39;: &#39;Not available&#39;,<tr><td><a id="l292"></a><a href="#l292">292</a><td>      &#39;fileName&#39;: href,<tr><td><a id="l293"></a><a href="#l293">293</a><td>      &#39;stack&#39;: &#39;Not available&#39;<tr><td><a id="l294"></a><a href="#l294">294</a><td>    };<tr><td><a id="l295"></a><a href="#l295">295</a><td>  }<tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td>  var lineNumber, fileName;<tr><td><a id="l298"></a><a href="#l298">298</a><td>  var threwError = false;<tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>  try {<tr><td><a id="l301"></a><a href="#l301">301</a><td>    lineNumber = err.lineNumber || err.line || &#39;Not available&#39;;<tr><td><a id="l302"></a><a href="#l302">302</a><td>  } catch (e) {<tr><td><a id="l303"></a><a href="#l303">303</a><td>    // Firefox 2 sometimes throws an error when accessing &#39;lineNumber&#39;:<tr><td><a id="l304"></a><a href="#l304">304</a><td>    // Message: Permission denied to get property UnnamedClass.lineNumber<tr><td><a id="l305"></a><a href="#l305">305</a><td>    lineNumber = &#39;Not available&#39;;<tr><td><a id="l306"></a><a href="#l306">306</a><td>    threwError = true;<tr><td><a id="l307"></a><a href="#l307">307</a><td>  }<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td>  try {<tr><td><a id="l310"></a><a href="#l310">310</a><td>    fileName = err.fileName || err.filename || err.sourceURL ||<tr><td><a id="l311"></a><a href="#l311">311</a><td>        // $googDebugFname may be set before a call to eval to set the filename<tr><td><a id="l312"></a><a href="#l312">312</a><td>        // that the eval is supposed to present.<tr><td><a id="l313"></a><a href="#l313">313</a><td>        goog.global[&#39;$googDebugFname&#39;] || href;<tr><td><a id="l314"></a><a href="#l314">314</a><td>  } catch (e) {<tr><td><a id="l315"></a><a href="#l315">315</a><td>    // Firefox 2 may also throw an error when accessing &#39;filename&#39;.<tr><td><a id="l316"></a><a href="#l316">316</a><td>    fileName = &#39;Not available&#39;;<tr><td><a id="l317"></a><a href="#l317">317</a><td>    threwError = true;<tr><td><a id="l318"></a><a href="#l318">318</a><td>  }<tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>  // The IE Error object contains only the name and the message.<tr><td><a id="l321"></a><a href="#l321">321</a><td>  // The Safari Error object uses the line and sourceURL fields.<tr><td><a id="l322"></a><a href="#l322">322</a><td>  if (threwError || !err.lineNumber || !err.fileName || !err.stack ||<tr><td><a id="l323"></a><a href="#l323">323</a><td>      !err.message || !err.name) {<tr><td><a id="l324"></a><a href="#l324">324</a><td>    return {<tr><td><a id="l325"></a><a href="#l325">325</a><td>      &#39;message&#39;: err.message || &#39;Not available&#39;,<tr><td><a id="l326"></a><a href="#l326">326</a><td>      &#39;name&#39;: err.name || &#39;UnknownError&#39;,<tr><td><a id="l327"></a><a href="#l327">327</a><td>      &#39;lineNumber&#39;: lineNumber,<tr><td><a id="l328"></a><a href="#l328">328</a><td>      &#39;fileName&#39;: fileName,<tr><td><a id="l329"></a><a href="#l329">329</a><td>      &#39;stack&#39;: err.stack || &#39;Not available&#39;<tr><td><a id="l330"></a><a href="#l330">330</a><td>    };<tr><td><a id="l331"></a><a href="#l331">331</a><td>  }<tr><td><a id="l332"></a><a href="#l332">332</a><td><tr><td><a id="l333"></a><a href="#l333">333</a><td>  // Standards error object<tr><td><a id="l334"></a><a href="#l334">334</a><td>  return err;<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td>/**<tr><td><a id="l339"></a><a href="#l339">339</a><td> * Converts an object to an Error if it&#39;s a String,<tr><td><a id="l340"></a><a href="#l340">340</a><td> * adds a stacktrace if there isn&#39;t one,<tr><td><a id="l341"></a><a href="#l341">341</a><td> * and optionally adds an extra message.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {Error|string} err  the original thrown object or string.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @param {string=} opt_message  optional additional message to add to the<tr><td><a id="l344"></a><a href="#l344">344</a><td> *     error.<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @return {!Error} If err is a string, it is used to create a new Error,<tr><td><a id="l346"></a><a href="#l346">346</a><td> *     which is enhanced and returned.  Otherwise err itself is enhanced<tr><td><a id="l347"></a><a href="#l347">347</a><td> *     and returned.<tr><td><a id="l348"></a><a href="#l348">348</a><td> */<tr><td><a id="l349"></a><a href="#l349">349</a><td>goog.debug.enhanceError = function(err, opt_message) {<tr><td><a id="l350"></a><a href="#l350">350</a><td>  var error;<tr><td><a id="l351"></a><a href="#l351">351</a><td>  if (typeof err == &#39;string&#39;) {<tr><td><a id="l352"></a><a href="#l352">352</a><td>    error = Error(err);<tr><td><a id="l353"></a><a href="#l353">353</a><td>    if (Error.captureStackTrace) {<tr><td><a id="l354"></a><a href="#l354">354</a><td>      // Trim this function off the call stack, if we can.<tr><td><a id="l355"></a><a href="#l355">355</a><td>      Error.captureStackTrace(error, goog.debug.enhanceError);<tr><td><a id="l356"></a><a href="#l356">356</a><td>    }<tr><td><a id="l357"></a><a href="#l357">357</a><td>  } else {<tr><td><a id="l358"></a><a href="#l358">358</a><td>    error = err;<tr><td><a id="l359"></a><a href="#l359">359</a><td>  }<tr><td><a id="l360"></a><a href="#l360">360</a><td><tr><td><a id="l361"></a><a href="#l361">361</a><td>  if (!error.stack) {<tr><td><a id="l362"></a><a href="#l362">362</a><td>    error.stack = goog.debug.getStacktrace(goog.debug.enhanceError);<tr><td><a id="l363"></a><a href="#l363">363</a><td>  }<tr><td><a id="l364"></a><a href="#l364">364</a><td>  if (opt_message) {<tr><td><a id="l365"></a><a href="#l365">365</a><td>    // find the first unoccupied &#39;messageX&#39; property<tr><td><a id="l366"></a><a href="#l366">366</a><td>    var x = 0;<tr><td><a id="l367"></a><a href="#l367">367</a><td>    while (error[&#39;message&#39; + x]) {<tr><td><a id="l368"></a><a href="#l368">368</a><td>      ++x;<tr><td><a id="l369"></a><a href="#l369">369</a><td>    }<tr><td><a id="l370"></a><a href="#l370">370</a><td>    error[&#39;message&#39; + x] = String(opt_message);<tr><td><a id="l371"></a><a href="#l371">371</a><td>  }<tr><td><a id="l372"></a><a href="#l372">372</a><td>  return error;<tr><td><a id="l373"></a><a href="#l373">373</a><td>};<tr><td><a id="l374"></a><a href="#l374">374</a><td><tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td>/**<tr><td><a id="l377"></a><a href="#l377">377</a><td> * Gets the current stack trace. Simple and iterative - doesn&#39;t worry about<tr><td><a id="l378"></a><a href="#l378">378</a><td> * catching circular references or getting the args.<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @param {number=} opt_depth Optional maximum depth to trace back to.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @return {string} A string with the function names of all functions in the<tr><td><a id="l381"></a><a href="#l381">381</a><td> *     stack, separated by \n.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @suppress {es5Strict}<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>goog.debug.getStacktraceSimple = function(opt_depth) {<tr><td><a id="l385"></a><a href="#l385">385</a><td>  if (goog.STRICT_MODE_COMPATIBLE) {<tr><td><a id="l386"></a><a href="#l386">386</a><td>    var stack = goog.debug.getNativeStackTrace_(goog.debug.getStacktraceSimple);<tr><td><a id="l387"></a><a href="#l387">387</a><td>    if (stack) {<tr><td><a id="l388"></a><a href="#l388">388</a><td>      return stack;<tr><td><a id="l389"></a><a href="#l389">389</a><td>    }<tr><td><a id="l390"></a><a href="#l390">390</a><td>    // NOTE: browsers that have strict mode support also have native &quot;stack&quot;<tr><td><a id="l391"></a><a href="#l391">391</a><td>    // properties.  Fall-through for legacy browser support.<tr><td><a id="l392"></a><a href="#l392">392</a><td>  }<tr><td><a id="l393"></a><a href="#l393">393</a><td><tr><td><a id="l394"></a><a href="#l394">394</a><td>  var sb = [];<tr><td><a id="l395"></a><a href="#l395">395</a><td>  var fn = arguments.callee.caller;<tr><td><a id="l396"></a><a href="#l396">396</a><td>  var depth = 0;<tr><td><a id="l397"></a><a href="#l397">397</a><td><tr><td><a id="l398"></a><a href="#l398">398</a><td>  while (fn &amp;&amp; (!opt_depth || depth &lt; opt_depth)) {<tr><td><a id="l399"></a><a href="#l399">399</a><td>    sb.push(goog.debug.getFunctionName(fn));<tr><td><a id="l400"></a><a href="#l400">400</a><td>    sb.push(&#39;()\n&#39;);<tr><td><a id="l401"></a><a href="#l401">401</a><td>    /** @preserveTry */<tr><td><a id="l402"></a><a href="#l402">402</a><td>    try {<tr><td><a id="l403"></a><a href="#l403">403</a><td>      fn = fn.caller;<tr><td><a id="l404"></a><a href="#l404">404</a><td>    } catch (e) {<tr><td><a id="l405"></a><a href="#l405">405</a><td>      sb.push(&#39;[exception trying to get caller]\n&#39;);<tr><td><a id="l406"></a><a href="#l406">406</a><td>      break;<tr><td><a id="l407"></a><a href="#l407">407</a><td>    }<tr><td><a id="l408"></a><a href="#l408">408</a><td>    depth++;<tr><td><a id="l409"></a><a href="#l409">409</a><td>    if (depth &gt;= goog.debug.MAX_STACK_DEPTH) {<tr><td><a id="l410"></a><a href="#l410">410</a><td>      sb.push(&#39;[...long stack...]&#39;);<tr><td><a id="l411"></a><a href="#l411">411</a><td>      break;<tr><td><a id="l412"></a><a href="#l412">412</a><td>    }<tr><td><a id="l413"></a><a href="#l413">413</a><td>  }<tr><td><a id="l414"></a><a href="#l414">414</a><td>  if (opt_depth &amp;&amp; depth &gt;= opt_depth) {<tr><td><a id="l415"></a><a href="#l415">415</a><td>    sb.push(&#39;[...reached max depth limit...]&#39;);<tr><td><a id="l416"></a><a href="#l416">416</a><td>  } else {<tr><td><a id="l417"></a><a href="#l417">417</a><td>    sb.push(&#39;[end]&#39;);<tr><td><a id="l418"></a><a href="#l418">418</a><td>  }<tr><td><a id="l419"></a><a href="#l419">419</a><td><tr><td><a id="l420"></a><a href="#l420">420</a><td>  return sb.join(&#39;&#39;);<tr><td><a id="l421"></a><a href="#l421">421</a><td>};<tr><td><a id="l422"></a><a href="#l422">422</a><td><tr><td><a id="l423"></a><a href="#l423">423</a><td><tr><td><a id="l424"></a><a href="#l424">424</a><td>/**<tr><td><a id="l425"></a><a href="#l425">425</a><td> * Max length of stack to try and output<tr><td><a id="l426"></a><a href="#l426">426</a><td> * @type {number}<tr><td><a id="l427"></a><a href="#l427">427</a><td> */<tr><td><a id="l428"></a><a href="#l428">428</a><td>goog.debug.MAX_STACK_DEPTH = 50;<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td>/**<tr><td><a id="l432"></a><a href="#l432">432</a><td> * @param {Function} fn The function to start getting the trace from.<tr><td><a id="l433"></a><a href="#l433">433</a><td> * @return {?string}<tr><td><a id="l434"></a><a href="#l434">434</a><td> * @private<tr><td><a id="l435"></a><a href="#l435">435</a><td> */<tr><td><a id="l436"></a><a href="#l436">436</a><td>goog.debug.getNativeStackTrace_ = function(fn) {<tr><td><a id="l437"></a><a href="#l437">437</a><td>  var tempErr = new Error();<tr><td><a id="l438"></a><a href="#l438">438</a><td>  if (Error.captureStackTrace) {<tr><td><a id="l439"></a><a href="#l439">439</a><td>    Error.captureStackTrace(tempErr, fn);<tr><td><a id="l440"></a><a href="#l440">440</a><td>    return String(tempErr.stack);<tr><td><a id="l441"></a><a href="#l441">441</a><td>  } else {<tr><td><a id="l442"></a><a href="#l442">442</a><td>    // IE10, only adds stack traces when an exception is thrown.<tr><td><a id="l443"></a><a href="#l443">443</a><td>    try {<tr><td><a id="l444"></a><a href="#l444">444</a><td>      throw tempErr;<tr><td><a id="l445"></a><a href="#l445">445</a><td>    } catch (e) {<tr><td><a id="l446"></a><a href="#l446">446</a><td>      tempErr = e;<tr><td><a id="l447"></a><a href="#l447">447</a><td>    }<tr><td><a id="l448"></a><a href="#l448">448</a><td>    var stack = tempErr.stack;<tr><td><a id="l449"></a><a href="#l449">449</a><td>    if (stack) {<tr><td><a id="l450"></a><a href="#l450">450</a><td>      return String(stack);<tr><td><a id="l451"></a><a href="#l451">451</a><td>    }<tr><td><a id="l452"></a><a href="#l452">452</a><td>  }<tr><td><a id="l453"></a><a href="#l453">453</a><td>  return null;<tr><td><a id="l454"></a><a href="#l454">454</a><td>};<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td><tr><td><a id="l457"></a><a href="#l457">457</a><td>/**<tr><td><a id="l458"></a><a href="#l458">458</a><td> * Gets the current stack trace, either starting from the caller or starting<tr><td><a id="l459"></a><a href="#l459">459</a><td> * from a specified function that&#39;s currently on the call stack.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * @param {Function=} opt_fn Optional function to start getting the trace from.<tr><td><a id="l461"></a><a href="#l461">461</a><td> *     If not provided, defaults to the function that called this.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @return {string} Stack trace.<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @suppress {es5Strict}<tr><td><a id="l464"></a><a href="#l464">464</a><td> */<tr><td><a id="l465"></a><a href="#l465">465</a><td>goog.debug.getStacktrace = function(opt_fn) {<tr><td><a id="l466"></a><a href="#l466">466</a><td>  var stack;<tr><td><a id="l467"></a><a href="#l467">467</a><td>  if (goog.STRICT_MODE_COMPATIBLE) {<tr><td><a id="l468"></a><a href="#l468">468</a><td>    // Try to get the stack trace from the environment if it is available.<tr><td><a id="l469"></a><a href="#l469">469</a><td>    var contextFn = opt_fn || goog.debug.getStacktrace;<tr><td><a id="l470"></a><a href="#l470">470</a><td>    stack = goog.debug.getNativeStackTrace_(contextFn);<tr><td><a id="l471"></a><a href="#l471">471</a><td>  }<tr><td><a id="l472"></a><a href="#l472">472</a><td>  if (!stack) {<tr><td><a id="l473"></a><a href="#l473">473</a><td>    // NOTE: browsers that have strict mode support also have native &quot;stack&quot;<tr><td><a id="l474"></a><a href="#l474">474</a><td>    // properties. This function will throw in strict mode.<tr><td><a id="l475"></a><a href="#l475">475</a><td>    stack = goog.debug.getStacktraceHelper_(<tr><td><a id="l476"></a><a href="#l476">476</a><td>        opt_fn || arguments.callee.caller, []);<tr><td><a id="l477"></a><a href="#l477">477</a><td>  }<tr><td><a id="l478"></a><a href="#l478">478</a><td>  return stack;<tr><td><a id="l479"></a><a href="#l479">479</a><td>};<tr><td><a id="l480"></a><a href="#l480">480</a><td><tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td>/**<tr><td><a id="l483"></a><a href="#l483">483</a><td> * Private helper for getStacktrace().<tr><td><a id="l484"></a><a href="#l484">484</a><td> * @param {Function} fn Function to start getting the trace from.<tr><td><a id="l485"></a><a href="#l485">485</a><td> * @param {Array&lt;!Function&gt;} visited List of functions visited so far.<tr><td><a id="l486"></a><a href="#l486">486</a><td> * @return {string} Stack trace starting from function fn.<tr><td><a id="l487"></a><a href="#l487">487</a><td> * @suppress {es5Strict}<tr><td><a id="l488"></a><a href="#l488">488</a><td> * @private<tr><td><a id="l489"></a><a href="#l489">489</a><td> */<tr><td><a id="l490"></a><a href="#l490">490</a><td>goog.debug.getStacktraceHelper_ = function(fn, visited) {<tr><td><a id="l491"></a><a href="#l491">491</a><td>  var sb = [];<tr><td><a id="l492"></a><a href="#l492">492</a><td><tr><td><a id="l493"></a><a href="#l493">493</a><td>  // Circular reference, certain functions like bind seem to cause a recursive<tr><td><a id="l494"></a><a href="#l494">494</a><td>  // loop so we need to catch circular references<tr><td><a id="l495"></a><a href="#l495">495</a><td>  if (goog.array.contains(visited, fn)) {<tr><td><a id="l496"></a><a href="#l496">496</a><td>    sb.push(&#39;[...circular reference...]&#39;);<tr><td><a id="l497"></a><a href="#l497">497</a><td><tr><td><a id="l498"></a><a href="#l498">498</a><td>  // Traverse the call stack until function not found or max depth is reached<tr><td><a id="l499"></a><a href="#l499">499</a><td>  } else if (fn &amp;&amp; visited.length &lt; goog.debug.MAX_STACK_DEPTH) {<tr><td><a id="l500"></a><a href="#l500">500</a><td>    sb.push(goog.debug.getFunctionName(fn) + &#39;(&#39;);<tr><td><a id="l501"></a><a href="#l501">501</a><td>    var args = fn.arguments;<tr><td><a id="l502"></a><a href="#l502">502</a><td>    // Args may be null for some special functions such as host objects or eval.<tr><td><a id="l503"></a><a href="#l503">503</a><td>    for (var i = 0; args &amp;&amp; i &lt; args.length; i++) {<tr><td><a id="l504"></a><a href="#l504">504</a><td>      if (i &gt; 0) {<tr><td><a id="l505"></a><a href="#l505">505</a><td>        sb.push(&#39;, &#39;);<tr><td><a id="l506"></a><a href="#l506">506</a><td>      }<tr><td><a id="l507"></a><a href="#l507">507</a><td>      var argDesc;<tr><td><a id="l508"></a><a href="#l508">508</a><td>      var arg = args[i];<tr><td><a id="l509"></a><a href="#l509">509</a><td>      switch (typeof arg) {<tr><td><a id="l510"></a><a href="#l510">510</a><td>        case &#39;object&#39;:<tr><td><a id="l511"></a><a href="#l511">511</a><td>          argDesc = arg ? &#39;object&#39; : &#39;null&#39;;<tr><td><a id="l512"></a><a href="#l512">512</a><td>          break;<tr><td><a id="l513"></a><a href="#l513">513</a><td><tr><td><a id="l514"></a><a href="#l514">514</a><td>        case &#39;string&#39;:<tr><td><a id="l515"></a><a href="#l515">515</a><td>          argDesc = arg;<tr><td><a id="l516"></a><a href="#l516">516</a><td>          break;<tr><td><a id="l517"></a><a href="#l517">517</a><td><tr><td><a id="l518"></a><a href="#l518">518</a><td>        case &#39;number&#39;:<tr><td><a id="l519"></a><a href="#l519">519</a><td>          argDesc = String(arg);<tr><td><a id="l520"></a><a href="#l520">520</a><td>          break;<tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td>        case &#39;boolean&#39;:<tr><td><a id="l523"></a><a href="#l523">523</a><td>          argDesc = arg ? &#39;true&#39; : &#39;false&#39;;<tr><td><a id="l524"></a><a href="#l524">524</a><td>          break;<tr><td><a id="l525"></a><a href="#l525">525</a><td><tr><td><a id="l526"></a><a href="#l526">526</a><td>        case &#39;function&#39;:<tr><td><a id="l527"></a><a href="#l527">527</a><td>          argDesc = goog.debug.getFunctionName(arg);<tr><td><a id="l528"></a><a href="#l528">528</a><td>          argDesc = argDesc ? argDesc : &#39;[fn]&#39;;<tr><td><a id="l529"></a><a href="#l529">529</a><td>          break;<tr><td><a id="l530"></a><a href="#l530">530</a><td><tr><td><a id="l531"></a><a href="#l531">531</a><td>        case &#39;undefined&#39;:<tr><td><a id="l532"></a><a href="#l532">532</a><td>        default:<tr><td><a id="l533"></a><a href="#l533">533</a><td>          argDesc = typeof arg;<tr><td><a id="l534"></a><a href="#l534">534</a><td>          break;<tr><td><a id="l535"></a><a href="#l535">535</a><td>      }<tr><td><a id="l536"></a><a href="#l536">536</a><td><tr><td><a id="l537"></a><a href="#l537">537</a><td>      if (argDesc.length &gt; 40) {<tr><td><a id="l538"></a><a href="#l538">538</a><td>        argDesc = argDesc.substr(0, 40) + &#39;...&#39;;<tr><td><a id="l539"></a><a href="#l539">539</a><td>      }<tr><td><a id="l540"></a><a href="#l540">540</a><td>      sb.push(argDesc);<tr><td><a id="l541"></a><a href="#l541">541</a><td>    }<tr><td><a id="l542"></a><a href="#l542">542</a><td>    visited.push(fn);<tr><td><a id="l543"></a><a href="#l543">543</a><td>    sb.push(&#39;)\n&#39;);<tr><td><a id="l544"></a><a href="#l544">544</a><td>    /** @preserveTry */<tr><td><a id="l545"></a><a href="#l545">545</a><td>    try {<tr><td><a id="l546"></a><a href="#l546">546</a><td>      sb.push(goog.debug.getStacktraceHelper_(fn.caller, visited));<tr><td><a id="l547"></a><a href="#l547">547</a><td>    } catch (e) {<tr><td><a id="l548"></a><a href="#l548">548</a><td>      sb.push(&#39;[exception trying to get caller]\n&#39;);<tr><td><a id="l549"></a><a href="#l549">549</a><td>    }<tr><td><a id="l550"></a><a href="#l550">550</a><td><tr><td><a id="l551"></a><a href="#l551">551</a><td>  } else if (fn) {<tr><td><a id="l552"></a><a href="#l552">552</a><td>    sb.push(&#39;[...long stack...]&#39;);<tr><td><a id="l553"></a><a href="#l553">553</a><td>  } else {<tr><td><a id="l554"></a><a href="#l554">554</a><td>    sb.push(&#39;[end]&#39;);<tr><td><a id="l555"></a><a href="#l555">555</a><td>  }<tr><td><a id="l556"></a><a href="#l556">556</a><td>  return sb.join(&#39;&#39;);<tr><td><a id="l557"></a><a href="#l557">557</a><td>};<tr><td><a id="l558"></a><a href="#l558">558</a><td><tr><td><a id="l559"></a><a href="#l559">559</a><td><tr><td><a id="l560"></a><a href="#l560">560</a><td>/**<tr><td><a id="l561"></a><a href="#l561">561</a><td> * Set a custom function name resolver.<tr><td><a id="l562"></a><a href="#l562">562</a><td> * @param {function(Function): string} resolver Resolves functions to their<tr><td><a id="l563"></a><a href="#l563">563</a><td> *     names.<tr><td><a id="l564"></a><a href="#l564">564</a><td> */<tr><td><a id="l565"></a><a href="#l565">565</a><td>goog.debug.setFunctionResolver = function(resolver) {<tr><td><a id="l566"></a><a href="#l566">566</a><td>  goog.debug.fnNameResolver_ = resolver;<tr><td><a id="l567"></a><a href="#l567">567</a><td>};<tr><td><a id="l568"></a><a href="#l568">568</a><td><tr><td><a id="l569"></a><a href="#l569">569</a><td><tr><td><a id="l570"></a><a href="#l570">570</a><td>/**<tr><td><a id="l571"></a><a href="#l571">571</a><td> * Gets a function name<tr><td><a id="l572"></a><a href="#l572">572</a><td> * @param {Function} fn Function to get name of.<tr><td><a id="l573"></a><a href="#l573">573</a><td> * @return {string} Function&#39;s name.<tr><td><a id="l574"></a><a href="#l574">574</a><td> */<tr><td><a id="l575"></a><a href="#l575">575</a><td>goog.debug.getFunctionName = function(fn) {<tr><td><a id="l576"></a><a href="#l576">576</a><td>  if (goog.debug.fnNameCache_[fn]) {<tr><td><a id="l577"></a><a href="#l577">577</a><td>    return goog.debug.fnNameCache_[fn];<tr><td><a id="l578"></a><a href="#l578">578</a><td>  }<tr><td><a id="l579"></a><a href="#l579">579</a><td>  if (goog.debug.fnNameResolver_) {<tr><td><a id="l580"></a><a href="#l580">580</a><td>    var name = goog.debug.fnNameResolver_(fn);<tr><td><a id="l581"></a><a href="#l581">581</a><td>    if (name) {<tr><td><a id="l582"></a><a href="#l582">582</a><td>      goog.debug.fnNameCache_[fn] = name;<tr><td><a id="l583"></a><a href="#l583">583</a><td>      return name;<tr><td><a id="l584"></a><a href="#l584">584</a><td>    }<tr><td><a id="l585"></a><a href="#l585">585</a><td>  }<tr><td><a id="l586"></a><a href="#l586">586</a><td><tr><td><a id="l587"></a><a href="#l587">587</a><td>  // Heuristically determine function name based on code.<tr><td><a id="l588"></a><a href="#l588">588</a><td>  var functionSource = String(fn);<tr><td><a id="l589"></a><a href="#l589">589</a><td>  if (!goog.debug.fnNameCache_[functionSource]) {<tr><td><a id="l590"></a><a href="#l590">590</a><td>    var matches = /function ([^\(]+)/.exec(functionSource);<tr><td><a id="l591"></a><a href="#l591">591</a><td>    if (matches) {<tr><td><a id="l592"></a><a href="#l592">592</a><td>      var method = matches[1];<tr><td><a id="l593"></a><a href="#l593">593</a><td>      goog.debug.fnNameCache_[functionSource] = method;<tr><td><a id="l594"></a><a href="#l594">594</a><td>    } else {<tr><td><a id="l595"></a><a href="#l595">595</a><td>      goog.debug.fnNameCache_[functionSource] = &#39;[Anonymous]&#39;;<tr><td><a id="l596"></a><a href="#l596">596</a><td>    }<tr><td><a id="l597"></a><a href="#l597">597</a><td>  }<tr><td><a id="l598"></a><a href="#l598">598</a><td><tr><td><a id="l599"></a><a href="#l599">599</a><td>  return goog.debug.fnNameCache_[functionSource];<tr><td><a id="l600"></a><a href="#l600">600</a><td>};<tr><td><a id="l601"></a><a href="#l601">601</a><td><tr><td><a id="l602"></a><a href="#l602">602</a><td><tr><td><a id="l603"></a><a href="#l603">603</a><td>/**<tr><td><a id="l604"></a><a href="#l604">604</a><td> * Makes whitespace visible by replacing it with printable characters.<tr><td><a id="l605"></a><a href="#l605">605</a><td> * This is useful in finding diffrences between the expected and the actual<tr><td><a id="l606"></a><a href="#l606">606</a><td> * output strings of a testcase.<tr><td><a id="l607"></a><a href="#l607">607</a><td> * @param {string} string whose whitespace needs to be made visible.<tr><td><a id="l608"></a><a href="#l608">608</a><td> * @return {string} string whose whitespace is made visible.<tr><td><a id="l609"></a><a href="#l609">609</a><td> */<tr><td><a id="l610"></a><a href="#l610">610</a><td>goog.debug.makeWhitespaceVisible = function(string) {<tr><td><a id="l611"></a><a href="#l611">611</a><td>  return string.replace(/ /g, &#39;[_]&#39;)<tr><td><a id="l612"></a><a href="#l612">612</a><td>      .replace(/\f/g, &#39;[f]&#39;)<tr><td><a id="l613"></a><a href="#l613">613</a><td>      .replace(/\n/g, &#39;[n]\n&#39;)<tr><td><a id="l614"></a><a href="#l614">614</a><td>      .replace(/\r/g, &#39;[r]&#39;)<tr><td><a id="l615"></a><a href="#l615">615</a><td>      .replace(/\t/g, &#39;[t]&#39;);<tr><td><a id="l616"></a><a href="#l616">616</a><td>};<tr><td><a id="l617"></a><a href="#l617">617</a><td><tr><td><a id="l618"></a><a href="#l618">618</a><td><tr><td><a id="l619"></a><a href="#l619">619</a><td>/**<tr><td><a id="l620"></a><a href="#l620">620</a><td> * Returns the type of a value. If a constructor is passed, and a suitable<tr><td><a id="l621"></a><a href="#l621">621</a><td> * string cannot be found, &#39;unknown type name&#39; will be returned.<tr><td><a id="l622"></a><a href="#l622">622</a><td> *<tr><td><a id="l623"></a><a href="#l623">623</a><td> * &lt;p&gt;Forked rather than moved from {@link goog.asserts.getType_}<tr><td><a id="l624"></a><a href="#l624">624</a><td> * to avoid adding a dependency to goog.asserts.<tr><td><a id="l625"></a><a href="#l625">625</a><td> * @param {*} value A constructor, object, or primitive.<tr><td><a id="l626"></a><a href="#l626">626</a><td> * @return {string} The best display name for the value, or &#39;unknown type name&#39;.<tr><td><a id="l627"></a><a href="#l627">627</a><td> */<tr><td><a id="l628"></a><a href="#l628">628</a><td>goog.debug.runtimeType = function(value) {<tr><td><a id="l629"></a><a href="#l629">629</a><td>  if (value instanceof Function) {<tr><td><a id="l630"></a><a href="#l630">630</a><td>    return value.displayName || value.name || &#39;unknown type name&#39;;<tr><td><a id="l631"></a><a href="#l631">631</a><td>  } else if (value instanceof Object) {<tr><td><a id="l632"></a><a href="#l632">632</a><td>    return value.constructor.displayName || value.constructor.name ||<tr><td><a id="l633"></a><a href="#l633">633</a><td>        Object.prototype.toString.call(value);<tr><td><a id="l634"></a><a href="#l634">634</a><td>  } else {<tr><td><a id="l635"></a><a href="#l635">635</a><td>    return value === null ? &#39;null&#39; : typeof value;<tr><td><a id="l636"></a><a href="#l636">636</a><td>  }<tr><td><a id="l637"></a><a href="#l637">637</a><td>};<tr><td><a id="l638"></a><a href="#l638">638</a><td><tr><td><a id="l639"></a><a href="#l639">639</a><td><tr><td><a id="l640"></a><a href="#l640">640</a><td>/**<tr><td><a id="l641"></a><a href="#l641">641</a><td> * Hash map for storing function names that have already been looked up.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @type {Object}<tr><td><a id="l643"></a><a href="#l643">643</a><td> * @private<tr><td><a id="l644"></a><a href="#l644">644</a><td> */<tr><td><a id="l645"></a><a href="#l645">645</a><td>goog.debug.fnNameCache_ = {};<tr><td><a id="l646"></a><a href="#l646">646</a><td><tr><td><a id="l647"></a><a href="#l647">647</a><td><tr><td><a id="l648"></a><a href="#l648">648</a><td>/**<tr><td><a id="l649"></a><a href="#l649">649</a><td> * Resolves functions to their names.  Resolved function names will be cached.<tr><td><a id="l650"></a><a href="#l650">650</a><td> * @type {function(Function):string}<tr><td><a id="l651"></a><a href="#l651">651</a><td> * @private<tr><td><a id="l652"></a><a href="#l652">652</a><td> */<tr><td><a id="l653"></a><a href="#l653">653</a><td>goog.debug.fnNameResolver_;</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/debug/entrypointregistry.js.src.html b/docs/source/lib/goog/debug/entrypointregistry.js.src.html
new file mode 100644
index 0000000..9bbf8bb
--- /dev/null
+++ b/docs/source/lib/goog/debug/entrypointregistry.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>entrypointregistry.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/debug/entrypointregistry.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A global registry for entry points into a program,<tr><td><a id="l17"></a><a href="#l17">17</a><td> * so that they can be instrumented. Each module should register their<tr><td><a id="l18"></a><a href="#l18">18</a><td> * entry points with this registry. Designed to be compiled out<tr><td><a id="l19"></a><a href="#l19">19</a><td> * if no instrumentation is requested.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * Entry points may be registered before or after a call to<tr><td><a id="l22"></a><a href="#l22">22</a><td> * goog.debug.entryPointRegistry.monitorAll. If an entry point is registered<tr><td><a id="l23"></a><a href="#l23">23</a><td> * later, the existing monitor will instrument the new entry point.<tr><td><a id="l24"></a><a href="#l24">24</a><td> *<tr><td><a id="l25"></a><a href="#l25">25</a><td> * @author nicksantos@google.com (Nick Santos)<tr><td><a id="l26"></a><a href="#l26">26</a><td> */<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.provide(&#39;goog.debug.EntryPointMonitor&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.provide(&#39;goog.debug.entryPointRegistry&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @interface<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.debug.EntryPointMonitor = function() {};<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td>/**<tr><td><a id="l42"></a><a href="#l42">42</a><td> * Instruments a function.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {!Function} fn A function to instrument.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @return {!Function} The instrumented function.<tr><td><a id="l46"></a><a href="#l46">46</a><td> */<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.debug.EntryPointMonitor.prototype.wrap;<tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td>/**<tr><td><a id="l51"></a><a href="#l51">51</a><td> * Try to remove an instrumentation wrapper created by this monitor.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * If the function passed to unwrap is not a wrapper created by this<tr><td><a id="l53"></a><a href="#l53">53</a><td> * monitor, then we will do nothing.<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> * Notice that some wrappers may not be unwrappable. For example, if other<tr><td><a id="l56"></a><a href="#l56">56</a><td> * monitors have applied their own wrappers, then it will be impossible to<tr><td><a id="l57"></a><a href="#l57">57</a><td> * unwrap them because their wrappers will have captured our wrapper.<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * So it is important that entry points are unwrapped in the reverse<tr><td><a id="l60"></a><a href="#l60">60</a><td> * order that they were wrapped.<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {!Function} fn A function to unwrap.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @return {!Function} The unwrapped function, or {@code fn} if it was not<tr><td><a id="l64"></a><a href="#l64">64</a><td> *     a wrapped function created by this monitor.<tr><td><a id="l65"></a><a href="#l65">65</a><td> */<tr><td><a id="l66"></a><a href="#l66">66</a><td>goog.debug.EntryPointMonitor.prototype.unwrap;<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>/**<tr><td><a id="l70"></a><a href="#l70">70</a><td> * An array of entry point callbacks.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @type {!Array&lt;function(!Function)&gt;}<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @private<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td>goog.debug.entryPointRegistry.refList_ = [];<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * Monitors that should wrap all the entry points.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @type {!Array&lt;!goog.debug.EntryPointMonitor&gt;}<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @private<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.debug.entryPointRegistry.monitors_ = [];<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Whether goog.debug.entryPointRegistry.monitorAll has ever been called.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * Checking this allows the compiler to optimize out the registrations.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @type {boolean}<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @private<tr><td><a id="l90"></a><a href="#l90">90</a><td> */<tr><td><a id="l91"></a><a href="#l91">91</a><td>goog.debug.entryPointRegistry.monitorsMayExist_ = false;<tr><td><a id="l92"></a><a href="#l92">92</a><td><tr><td><a id="l93"></a><a href="#l93">93</a><td><tr><td><a id="l94"></a><a href="#l94">94</a><td>/**<tr><td><a id="l95"></a><a href="#l95">95</a><td> * Register an entry point with this module.<tr><td><a id="l96"></a><a href="#l96">96</a><td> *<tr><td><a id="l97"></a><a href="#l97">97</a><td> * The entry point will be instrumented when a monitor is passed to<tr><td><a id="l98"></a><a href="#l98">98</a><td> * goog.debug.entryPointRegistry.monitorAll. If this has already occurred, the<tr><td><a id="l99"></a><a href="#l99">99</a><td> * entry point is instrumented immediately.<tr><td><a id="l100"></a><a href="#l100">100</a><td> *<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {function(!Function)} callback A callback function which is called<tr><td><a id="l102"></a><a href="#l102">102</a><td> *     with a transforming function to instrument the entry point. The callback<tr><td><a id="l103"></a><a href="#l103">103</a><td> *     is responsible for wrapping the relevant entry point with the<tr><td><a id="l104"></a><a href="#l104">104</a><td> *     transforming function.<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.debug.entryPointRegistry.register = function(callback) {<tr><td><a id="l107"></a><a href="#l107">107</a><td>  // Don&#39;t use push(), so that this can be compiled out.<tr><td><a id="l108"></a><a href="#l108">108</a><td>  goog.debug.entryPointRegistry.refList_[<tr><td><a id="l109"></a><a href="#l109">109</a><td>      goog.debug.entryPointRegistry.refList_.length] = callback;<tr><td><a id="l110"></a><a href="#l110">110</a><td>  // If no one calls monitorAll, this can be compiled out.<tr><td><a id="l111"></a><a href="#l111">111</a><td>  if (goog.debug.entryPointRegistry.monitorsMayExist_) {<tr><td><a id="l112"></a><a href="#l112">112</a><td>    var monitors = goog.debug.entryPointRegistry.monitors_;<tr><td><a id="l113"></a><a href="#l113">113</a><td>    for (var i = 0; i &lt; monitors.length; i++) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>      callback(goog.bind(monitors[i].wrap, monitors[i]));<tr><td><a id="l115"></a><a href="#l115">115</a><td>    }<tr><td><a id="l116"></a><a href="#l116">116</a><td>  }<tr><td><a id="l117"></a><a href="#l117">117</a><td>};<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>/**<tr><td><a id="l121"></a><a href="#l121">121</a><td> * Configures a monitor to wrap all entry points.<tr><td><a id="l122"></a><a href="#l122">122</a><td> *<tr><td><a id="l123"></a><a href="#l123">123</a><td> * Entry points that have already been registered are immediately wrapped by<tr><td><a id="l124"></a><a href="#l124">124</a><td> * the monitor. When an entry point is registered in the future, it will also<tr><td><a id="l125"></a><a href="#l125">125</a><td> * be wrapped by the monitor when it is registered.<tr><td><a id="l126"></a><a href="#l126">126</a><td> *<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @param {!goog.debug.EntryPointMonitor} monitor An entry point monitor.<tr><td><a id="l128"></a><a href="#l128">128</a><td> */<tr><td><a id="l129"></a><a href="#l129">129</a><td>goog.debug.entryPointRegistry.monitorAll = function(monitor) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>  goog.debug.entryPointRegistry.monitorsMayExist_ = true;<tr><td><a id="l131"></a><a href="#l131">131</a><td>  var transformer = goog.bind(monitor.wrap, monitor);<tr><td><a id="l132"></a><a href="#l132">132</a><td>  for (var i = 0; i &lt; goog.debug.entryPointRegistry.refList_.length; i++) {<tr><td><a id="l133"></a><a href="#l133">133</a><td>    goog.debug.entryPointRegistry.refList_[i](transformer);<tr><td><a id="l134"></a><a href="#l134">134</a><td>  }<tr><td><a id="l135"></a><a href="#l135">135</a><td>  goog.debug.entryPointRegistry.monitors_.push(monitor);<tr><td><a id="l136"></a><a href="#l136">136</a><td>};<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * Try to unmonitor all the entry points that have already been registered. If<tr><td><a id="l141"></a><a href="#l141">141</a><td> * an entry point is registered in the future, it will not be wrapped by the<tr><td><a id="l142"></a><a href="#l142">142</a><td> * monitor when it is registered. Note that this may fail if the entry points<tr><td><a id="l143"></a><a href="#l143">143</a><td> * have additional wrapping.<tr><td><a id="l144"></a><a href="#l144">144</a><td> *<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {!goog.debug.EntryPointMonitor} monitor The last monitor to wrap<tr><td><a id="l146"></a><a href="#l146">146</a><td> *     the entry points.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @throws {Error} If the monitor is not the most recently configured monitor.<tr><td><a id="l148"></a><a href="#l148">148</a><td> */<tr><td><a id="l149"></a><a href="#l149">149</a><td>goog.debug.entryPointRegistry.unmonitorAllIfPossible = function(monitor) {<tr><td><a id="l150"></a><a href="#l150">150</a><td>  var monitors = goog.debug.entryPointRegistry.monitors_;<tr><td><a id="l151"></a><a href="#l151">151</a><td>  goog.asserts.assert(monitor == monitors[monitors.length - 1],<tr><td><a id="l152"></a><a href="#l152">152</a><td>      &#39;Only the most recent monitor can be unwrapped.&#39;);<tr><td><a id="l153"></a><a href="#l153">153</a><td>  var transformer = goog.bind(monitor.unwrap, monitor);<tr><td><a id="l154"></a><a href="#l154">154</a><td>  for (var i = 0; i &lt; goog.debug.entryPointRegistry.refList_.length; i++) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>    goog.debug.entryPointRegistry.refList_[i](transformer);<tr><td><a id="l156"></a><a href="#l156">156</a><td>  }<tr><td><a id="l157"></a><a href="#l157">157</a><td>  monitors.length--;<tr><td><a id="l158"></a><a href="#l158">158</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/debug/error.js.src.html b/docs/source/lib/goog/debug/error.js.src.html
index 7dec952..0b4c27b 100644
--- a/docs/source/lib/goog/debug/error.js.src.html
+++ b/docs/source/lib/goog/debug/error.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>error.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/debug/error.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides a base class for custom Error objects such that the<tr><td><a name="l17" href="#l17">17</a><td> * stack is correctly maintained.<tr><td><a name="l18" href="#l18">18</a><td> *<tr><td><a name="l19" href="#l19">19</a><td> * You should never need to throw goog.debug.Error(msg) directly, Error(msg) is<tr><td><a name="l20" href="#l20">20</a><td> * sufficient.<tr><td><a name="l21" href="#l21">21</a><td> *<tr><td><a name="l22" href="#l22">22</a><td> */<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td>goog.provide(&#39;goog.debug.Error&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>/**<tr><td><a name="l29" href="#l29">29</a><td> * Base class for custom error objects.<tr><td><a name="l30" href="#l30">30</a><td> * @param {*=} opt_msg The message associated with the error.<tr><td><a name="l31" href="#l31">31</a><td> * @constructor<tr><td><a name="l32" href="#l32">32</a><td> * @extends {Error}<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td>goog.debug.Error = function(opt_msg) {<tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td>  // Ensure there is a stack trace.<tr><td><a name="l37" href="#l37">37</a><td>  if (Error.captureStackTrace) {<tr><td><a name="l38" href="#l38">38</a><td>    Error.captureStackTrace(this, goog.debug.Error);<tr><td><a name="l39" href="#l39">39</a><td>  } else {<tr><td><a name="l40" href="#l40">40</a><td>    this.stack = new Error().stack || &#39;&#39;;<tr><td><a name="l41" href="#l41">41</a><td>  }<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>  if (opt_msg) {<tr><td><a name="l44" href="#l44">44</a><td>    this.message = String(opt_msg);<tr><td><a name="l45" href="#l45">45</a><td>  }<tr><td><a name="l46" href="#l46">46</a><td>};<tr><td><a name="l47" href="#l47">47</a><td>goog.inherits(goog.debug.Error, Error);<tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td>/** @override */<tr><td><a name="l51" href="#l51">51</a><td>goog.debug.Error.prototype.name = &#39;CustomError&#39;;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>error.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/debug/error.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Provides a base class for custom Error objects such that the<tr><td><a id="l17"></a><a href="#l17">17</a><td> * stack is correctly maintained.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * You should never need to throw goog.debug.Error(msg) directly, Error(msg) is<tr><td><a id="l20"></a><a href="#l20">20</a><td> * sufficient.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.debug.Error&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Base class for custom error objects.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {*=} opt_msg The message associated with the error.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @constructor<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @extends {Error}<tr><td><a id="l33"></a><a href="#l33">33</a><td> */<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.debug.Error = function(opt_msg) {<tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>  // Attempt to ensure there is a stack trace.<tr><td><a id="l37"></a><a href="#l37">37</a><td>  if (Error.captureStackTrace) {<tr><td><a id="l38"></a><a href="#l38">38</a><td>    Error.captureStackTrace(this, goog.debug.Error);<tr><td><a id="l39"></a><a href="#l39">39</a><td>  } else {<tr><td><a id="l40"></a><a href="#l40">40</a><td>    var stack = new Error().stack;<tr><td><a id="l41"></a><a href="#l41">41</a><td>    if (stack) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>      this.stack = stack;<tr><td><a id="l43"></a><a href="#l43">43</a><td>    }<tr><td><a id="l44"></a><a href="#l44">44</a><td>  }<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>  if (opt_msg) {<tr><td><a id="l47"></a><a href="#l47">47</a><td>    this.message = String(opt_msg);<tr><td><a id="l48"></a><a href="#l48">48</a><td>  }<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td>  /**<tr><td><a id="l51"></a><a href="#l51">51</a><td>   * Whether to report this error to the server. Setting this to false will<tr><td><a id="l52"></a><a href="#l52">52</a><td>   * cause the error reporter to not report the error back to the server,<tr><td><a id="l53"></a><a href="#l53">53</a><td>   * which can be useful if the client knows that the error has already been<tr><td><a id="l54"></a><a href="#l54">54</a><td>   * logged on the server.<tr><td><a id="l55"></a><a href="#l55">55</a><td>   * @type {boolean}<tr><td><a id="l56"></a><a href="#l56">56</a><td>   */<tr><td><a id="l57"></a><a href="#l57">57</a><td>  this.reportErrorToServer = true;<tr><td><a id="l58"></a><a href="#l58">58</a><td>};<tr><td><a id="l59"></a><a href="#l59">59</a><td>goog.inherits(goog.debug.Error, Error);<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td>/** @override */<tr><td><a id="l63"></a><a href="#l63">63</a><td>goog.debug.Error.prototype.name = &#39;CustomError&#39;;</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/debug/logbuffer.js.src.html b/docs/source/lib/goog/debug/logbuffer.js.src.html
new file mode 100644
index 0000000..0508996
--- /dev/null
+++ b/docs/source/lib/goog/debug/logbuffer.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>logbuffer.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/debug/logbuffer.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A buffer for log records. The purpose of this is to improve<tr><td><a id="l17"></a><a href="#l17">17</a><td> * logging performance by re-using old objects when the buffer becomes full and<tr><td><a id="l18"></a><a href="#l18">18</a><td> * to eliminate the need for each app to implement their own log buffer. The<tr><td><a id="l19"></a><a href="#l19">19</a><td> * disadvantage to doing this is that log handlers cannot maintain references to<tr><td><a id="l20"></a><a href="#l20">20</a><td> * log records and expect that they are not overwriten at a later point.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * @author agrieve@google.com (Andrew Grieve)<tr><td><a id="l23"></a><a href="#l23">23</a><td> */<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.debug.LogBuffer&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.debug.LogRecord&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Creates the log buffer.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @constructor<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @final<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.debug.LogBuffer = function() {<tr><td><a id="l38"></a><a href="#l38">38</a><td>  goog.asserts.assert(goog.debug.LogBuffer.isBufferingEnabled(),<tr><td><a id="l39"></a><a href="#l39">39</a><td>      &#39;Cannot use goog.debug.LogBuffer without defining &#39; +<tr><td><a id="l40"></a><a href="#l40">40</a><td>      &#39;goog.debug.LogBuffer.CAPACITY.&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>  this.clear();<tr><td><a id="l42"></a><a href="#l42">42</a><td>};<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * A static method that always returns the same instance of LogBuffer.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @return {!goog.debug.LogBuffer} The LogBuffer singleton instance.<tr><td><a id="l48"></a><a href="#l48">48</a><td> */<tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.debug.LogBuffer.getInstance = function() {<tr><td><a id="l50"></a><a href="#l50">50</a><td>  if (!goog.debug.LogBuffer.instance_) {<tr><td><a id="l51"></a><a href="#l51">51</a><td>    // This function is written with the return statement after the assignment<tr><td><a id="l52"></a><a href="#l52">52</a><td>    // to avoid the jscompiler StripCode bug described in http://b/2608064.<tr><td><a id="l53"></a><a href="#l53">53</a><td>    // After that bug is fixed this can be refactored.<tr><td><a id="l54"></a><a href="#l54">54</a><td>    goog.debug.LogBuffer.instance_ = new goog.debug.LogBuffer();<tr><td><a id="l55"></a><a href="#l55">55</a><td>  }<tr><td><a id="l56"></a><a href="#l56">56</a><td>  return goog.debug.LogBuffer.instance_;<tr><td><a id="l57"></a><a href="#l57">57</a><td>};<tr><td><a id="l58"></a><a href="#l58">58</a><td><tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td>/**<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @define {number} The number of log records to buffer. 0 means disable<tr><td><a id="l62"></a><a href="#l62">62</a><td> * buffering.<tr><td><a id="l63"></a><a href="#l63">63</a><td> */<tr><td><a id="l64"></a><a href="#l64">64</a><td>goog.define(&#39;goog.debug.LogBuffer.CAPACITY&#39;, 0);<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>/**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * The array to store the records.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @type {!Array&lt;!goog.debug.LogRecord|undefined&gt;}<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @private<tr><td><a id="l71"></a><a href="#l71">71</a><td> */<tr><td><a id="l72"></a><a href="#l72">72</a><td>goog.debug.LogBuffer.prototype.buffer_;<tr><td><a id="l73"></a><a href="#l73">73</a><td><tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td>/**<tr><td><a id="l76"></a><a href="#l76">76</a><td> * The index of the most recently added record or -1 if there are no records.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @type {number}<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @private<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td>goog.debug.LogBuffer.prototype.curIndex_;<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>/**<tr><td><a id="l84"></a><a href="#l84">84</a><td> * Whether the buffer is at capacity.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @type {boolean}<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @private<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>goog.debug.LogBuffer.prototype.isFull_;<tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td><tr><td><a id="l91"></a><a href="#l91">91</a><td>/**<tr><td><a id="l92"></a><a href="#l92">92</a><td> * Adds a log record to the buffer, possibly overwriting the oldest record.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @param {goog.debug.Logger.Level} level One of the level identifiers.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @param {string} msg The string message.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @param {string} loggerName The name of the source logger.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @return {!goog.debug.LogRecord} The log record.<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.debug.LogBuffer.prototype.addRecord = function(level, msg, loggerName) {<tr><td><a id="l99"></a><a href="#l99">99</a><td>  var curIndex = (this.curIndex_ + 1) % goog.debug.LogBuffer.CAPACITY;<tr><td><a id="l100"></a><a href="#l100">100</a><td>  this.curIndex_ = curIndex;<tr><td><a id="l101"></a><a href="#l101">101</a><td>  if (this.isFull_) {<tr><td><a id="l102"></a><a href="#l102">102</a><td>    var ret = this.buffer_[curIndex];<tr><td><a id="l103"></a><a href="#l103">103</a><td>    ret.reset(level, msg, loggerName);<tr><td><a id="l104"></a><a href="#l104">104</a><td>    return ret;<tr><td><a id="l105"></a><a href="#l105">105</a><td>  }<tr><td><a id="l106"></a><a href="#l106">106</a><td>  this.isFull_ = curIndex == goog.debug.LogBuffer.CAPACITY - 1;<tr><td><a id="l107"></a><a href="#l107">107</a><td>  return this.buffer_[curIndex] =<tr><td><a id="l108"></a><a href="#l108">108</a><td>      new goog.debug.LogRecord(level, msg, loggerName);<tr><td><a id="l109"></a><a href="#l109">109</a><td>};<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>/**<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @return {boolean} Whether the log buffer is enabled.<tr><td><a id="l114"></a><a href="#l114">114</a><td> */<tr><td><a id="l115"></a><a href="#l115">115</a><td>goog.debug.LogBuffer.isBufferingEnabled = function() {<tr><td><a id="l116"></a><a href="#l116">116</a><td>  return goog.debug.LogBuffer.CAPACITY &gt; 0;<tr><td><a id="l117"></a><a href="#l117">117</a><td>};<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>/**<tr><td><a id="l121"></a><a href="#l121">121</a><td> * Removes all buffered log records.<tr><td><a id="l122"></a><a href="#l122">122</a><td> */<tr><td><a id="l123"></a><a href="#l123">123</a><td>goog.debug.LogBuffer.prototype.clear = function() {<tr><td><a id="l124"></a><a href="#l124">124</a><td>  this.buffer_ = new Array(goog.debug.LogBuffer.CAPACITY);<tr><td><a id="l125"></a><a href="#l125">125</a><td>  this.curIndex_ = -1;<tr><td><a id="l126"></a><a href="#l126">126</a><td>  this.isFull_ = false;<tr><td><a id="l127"></a><a href="#l127">127</a><td>};<tr><td><a id="l128"></a><a href="#l128">128</a><td><tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>/**<tr><td><a id="l131"></a><a href="#l131">131</a><td> * Calls the given function for each buffered log record, starting with the<tr><td><a id="l132"></a><a href="#l132">132</a><td> * oldest one.<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @param {function(!goog.debug.LogRecord)} func The function to call.<tr><td><a id="l134"></a><a href="#l134">134</a><td> */<tr><td><a id="l135"></a><a href="#l135">135</a><td>goog.debug.LogBuffer.prototype.forEachRecord = function(func) {<tr><td><a id="l136"></a><a href="#l136">136</a><td>  var buffer = this.buffer_;<tr><td><a id="l137"></a><a href="#l137">137</a><td>  // Corner case: no records.<tr><td><a id="l138"></a><a href="#l138">138</a><td>  if (!buffer[0]) {<tr><td><a id="l139"></a><a href="#l139">139</a><td>    return;<tr><td><a id="l140"></a><a href="#l140">140</a><td>  }<tr><td><a id="l141"></a><a href="#l141">141</a><td>  var curIndex = this.curIndex_;<tr><td><a id="l142"></a><a href="#l142">142</a><td>  var i = this.isFull_ ? curIndex : -1;<tr><td><a id="l143"></a><a href="#l143">143</a><td>  do {<tr><td><a id="l144"></a><a href="#l144">144</a><td>    i = (i + 1) % goog.debug.LogBuffer.CAPACITY;<tr><td><a id="l145"></a><a href="#l145">145</a><td>    func(/** @type {!goog.debug.LogRecord} */ (buffer[i]));<tr><td><a id="l146"></a><a href="#l146">146</a><td>  } while (i != curIndex);<tr><td><a id="l147"></a><a href="#l147">147</a><td>};<tr><td><a id="l148"></a><a href="#l148">148</a><td></table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/debug/logger.js.src.html b/docs/source/lib/goog/debug/logger.js.src.html
new file mode 100644
index 0000000..031db67
--- /dev/null
+++ b/docs/source/lib/goog/debug/logger.js.src.html
@@ -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>logger.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/debug/logger.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Definition of the Logger class. Please minimize dependencies<tr><td><a id="l17"></a><a href="#l17">17</a><td> * this file has on other closure classes as any dependency it takes won&#39;t be<tr><td><a id="l18"></a><a href="#l18">18</a><td> * able to use the logging infrastructure.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * @see ../demos/debug.html<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>goog.provide(&#39;goog.debug.LogManager&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.debug.Loggable&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.debug.Logger&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.debug.Logger.Level&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.debug&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.debug.LogBuffer&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.debug.LogRecord&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * A message value that can be handled by a Logger.<tr><td><a id="l37"></a><a href="#l37">37</a><td> *<tr><td><a id="l38"></a><a href="#l38">38</a><td> * Functions are treated like callbacks, but are only called when the event&#39;s<tr><td><a id="l39"></a><a href="#l39">39</a><td> * log level is enabled. This is useful for logging messages that are expensive<tr><td><a id="l40"></a><a href="#l40">40</a><td> * to construct.<tr><td><a id="l41"></a><a href="#l41">41</a><td> *<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @typedef {string|function(): string}<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.debug.Loggable;<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> * The Logger is an object used for logging debug messages. Loggers are<tr><td><a id="l50"></a><a href="#l50">50</a><td> * normally named, using a hierarchical dot-separated namespace. Logger names<tr><td><a id="l51"></a><a href="#l51">51</a><td> * can be arbitrary strings, but they should normally be based on the package<tr><td><a id="l52"></a><a href="#l52">52</a><td> * name or class name of the logged component, such as goog.net.BrowserChannel.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> * The Logger object is loosely based on the java class<tr><td><a id="l55"></a><a href="#l55">55</a><td> * java.util.logging.Logger. It supports different levels of filtering for<tr><td><a id="l56"></a><a href="#l56">56</a><td> * different loggers.<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * The logger object should never be instantiated by application code. It<tr><td><a id="l59"></a><a href="#l59">59</a><td> * should always use the goog.debug.Logger.getLogger function.<tr><td><a id="l60"></a><a href="#l60">60</a><td> *<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @constructor<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {string} name The name of the Logger.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @final<tr><td><a id="l64"></a><a href="#l64">64</a><td> */<tr><td><a id="l65"></a><a href="#l65">65</a><td>goog.debug.Logger = function(name) {<tr><td><a id="l66"></a><a href="#l66">66</a><td>  /**<tr><td><a id="l67"></a><a href="#l67">67</a><td>   * Name of the Logger. Generally a dot-separated namespace<tr><td><a id="l68"></a><a href="#l68">68</a><td>   * @private {string}<tr><td><a id="l69"></a><a href="#l69">69</a><td>   */<tr><td><a id="l70"></a><a href="#l70">70</a><td>  this.name_ = name;<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>   * Parent Logger.<tr><td><a id="l74"></a><a href="#l74">74</a><td>   * @private {goog.debug.Logger}<tr><td><a id="l75"></a><a href="#l75">75</a><td>   */<tr><td><a id="l76"></a><a href="#l76">76</a><td>  this.parent_ = null;<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>   * Level that this logger only filters above. Null indicates it should<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * inherit from the parent.<tr><td><a id="l81"></a><a href="#l81">81</a><td>   * @private {goog.debug.Logger.Level}<tr><td><a id="l82"></a><a href="#l82">82</a><td>   */<tr><td><a id="l83"></a><a href="#l83">83</a><td>  this.level_ = null;<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>   * Map of children loggers. The keys are the leaf names of the children and<tr><td><a id="l87"></a><a href="#l87">87</a><td>   * the values are the child loggers.<tr><td><a id="l88"></a><a href="#l88">88</a><td>   * @private {Object}<tr><td><a id="l89"></a><a href="#l89">89</a><td>   */<tr><td><a id="l90"></a><a href="#l90">90</a><td>  this.children_ = null;<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>   * Handlers that are listening to this logger.<tr><td><a id="l94"></a><a href="#l94">94</a><td>   * @private {Array&lt;Function&gt;}<tr><td><a id="l95"></a><a href="#l95">95</a><td>   */<tr><td><a id="l96"></a><a href="#l96">96</a><td>  this.handlers_ = null;<tr><td><a id="l97"></a><a href="#l97">97</a><td>};<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/** @const */<tr><td><a id="l101"></a><a href="#l101">101</a><td>goog.debug.Logger.ROOT_LOGGER_NAME = &#39;&#39;;<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> * @define {boolean} Toggles whether loggers other than the root logger can have<tr><td><a id="l106"></a><a href="#l106">106</a><td> *     log handlers attached to them and whether they can have their log level<tr><td><a id="l107"></a><a href="#l107">107</a><td> *     set. Logging is a bit faster when this is set to false.<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.define(&#39;goog.debug.Logger.ENABLE_HIERARCHY&#39;, true);<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>if (!goog.debug.Logger.ENABLE_HIERARCHY) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>  /**<tr><td><a id="l114"></a><a href="#l114">114</a><td>   * @type {!Array&lt;Function&gt;}<tr><td><a id="l115"></a><a href="#l115">115</a><td>   * @private<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.debug.Logger.rootHandlers_ = [];<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>   * @type {goog.debug.Logger.Level}<tr><td><a id="l122"></a><a href="#l122">122</a><td>   * @private<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.debug.Logger.rootLevel_;<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><tr><td><a id="l129"></a><a href="#l129">129</a><td>/**<tr><td><a id="l130"></a><a href="#l130">130</a><td> * The Level class defines a set of standard logging levels that<tr><td><a id="l131"></a><a href="#l131">131</a><td> * can be used to control logging output.  The logging Level objects<tr><td><a id="l132"></a><a href="#l132">132</a><td> * are ordered and are specified by ordered integers.  Enabling logging<tr><td><a id="l133"></a><a href="#l133">133</a><td> * at a given level also enables logging at all higher levels.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * &lt;p&gt;<tr><td><a id="l135"></a><a href="#l135">135</a><td> * Clients should normally use the predefined Level constants such<tr><td><a id="l136"></a><a href="#l136">136</a><td> * as Level.SEVERE.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * &lt;p&gt;<tr><td><a id="l138"></a><a href="#l138">138</a><td> * The levels in descending order are:<tr><td><a id="l139"></a><a href="#l139">139</a><td> * &lt;ul&gt;<tr><td><a id="l140"></a><a href="#l140">140</a><td> * &lt;li&gt;SEVERE (highest value)<tr><td><a id="l141"></a><a href="#l141">141</a><td> * &lt;li&gt;WARNING<tr><td><a id="l142"></a><a href="#l142">142</a><td> * &lt;li&gt;INFO<tr><td><a id="l143"></a><a href="#l143">143</a><td> * &lt;li&gt;CONFIG<tr><td><a id="l144"></a><a href="#l144">144</a><td> * &lt;li&gt;FINE<tr><td><a id="l145"></a><a href="#l145">145</a><td> * &lt;li&gt;FINER<tr><td><a id="l146"></a><a href="#l146">146</a><td> * &lt;li&gt;FINEST  (lowest value)<tr><td><a id="l147"></a><a href="#l147">147</a><td> * &lt;/ul&gt;<tr><td><a id="l148"></a><a href="#l148">148</a><td> * In addition there is a level OFF that can be used to turn<tr><td><a id="l149"></a><a href="#l149">149</a><td> * off logging, and a level ALL that can be used to enable<tr><td><a id="l150"></a><a href="#l150">150</a><td> * logging of all messages.<tr><td><a id="l151"></a><a href="#l151">151</a><td> *<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @param {string} name The name of the level.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @param {number} value The numeric value of the level.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @constructor<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @final<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>goog.debug.Logger.Level = function(name, value) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  /**<tr><td><a id="l159"></a><a href="#l159">159</a><td>   * The name of the level<tr><td><a id="l160"></a><a href="#l160">160</a><td>   * @type {string}<tr><td><a id="l161"></a><a href="#l161">161</a><td>   */<tr><td><a id="l162"></a><a href="#l162">162</a><td>  this.name = name;<tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>  /**<tr><td><a id="l165"></a><a href="#l165">165</a><td>   * The numeric value of the level<tr><td><a id="l166"></a><a href="#l166">166</a><td>   * @type {number}<tr><td><a id="l167"></a><a href="#l167">167</a><td>   */<tr><td><a id="l168"></a><a href="#l168">168</a><td>  this.value = value;<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> * @return {string} String representation of the logger level.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @override<tr><td><a id="l175"></a><a href="#l175">175</a><td> */<tr><td><a id="l176"></a><a href="#l176">176</a><td>goog.debug.Logger.Level.prototype.toString = function() {<tr><td><a id="l177"></a><a href="#l177">177</a><td>  return this.name;<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>/**<tr><td><a id="l182"></a><a href="#l182">182</a><td> * OFF is a special level that can be used to turn off logging.<tr><td><a id="l183"></a><a href="#l183">183</a><td> * This level is initialized to &lt;CODE&gt;Infinity&lt;/CODE&gt;.<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @type {!goog.debug.Logger.Level}<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.debug.Logger.Level.OFF =<tr><td><a id="l187"></a><a href="#l187">187</a><td>    new goog.debug.Logger.Level(&#39;OFF&#39;, Infinity);<tr><td><a id="l188"></a><a href="#l188">188</a><td><tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td>/**<tr><td><a id="l191"></a><a href="#l191">191</a><td> * SHOUT is a message level for extra debugging loudness.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * This level is initialized to &lt;CODE&gt;1200&lt;/CODE&gt;.<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l194"></a><a href="#l194">194</a><td> */<tr><td><a id="l195"></a><a href="#l195">195</a><td>goog.debug.Logger.Level.SHOUT = new goog.debug.Logger.Level(&#39;SHOUT&#39;, 1200);<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>/**<tr><td><a id="l199"></a><a href="#l199">199</a><td> * SEVERE is a message level indicating a serious failure.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * This level is initialized to &lt;CODE&gt;1000&lt;/CODE&gt;.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l202"></a><a href="#l202">202</a><td> */<tr><td><a id="l203"></a><a href="#l203">203</a><td>goog.debug.Logger.Level.SEVERE = new goog.debug.Logger.Level(&#39;SEVERE&#39;, 1000);<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * WARNING is a message level indicating a potential problem.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * This level is initialized to &lt;CODE&gt;900&lt;/CODE&gt;.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>goog.debug.Logger.Level.WARNING = new goog.debug.Logger.Level(&#39;WARNING&#39;, 900);<tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td>/**<tr><td><a id="l215"></a><a href="#l215">215</a><td> * INFO is a message level for informational messages.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * This level is initialized to &lt;CODE&gt;800&lt;/CODE&gt;.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l218"></a><a href="#l218">218</a><td> */<tr><td><a id="l219"></a><a href="#l219">219</a><td>goog.debug.Logger.Level.INFO = new goog.debug.Logger.Level(&#39;INFO&#39;, 800);<tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td>/**<tr><td><a id="l223"></a><a href="#l223">223</a><td> * CONFIG is a message level for static configuration messages.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * This level is initialized to &lt;CODE&gt;700&lt;/CODE&gt;.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l226"></a><a href="#l226">226</a><td> */<tr><td><a id="l227"></a><a href="#l227">227</a><td>goog.debug.Logger.Level.CONFIG = new goog.debug.Logger.Level(&#39;CONFIG&#39;, 700);<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>/**<tr><td><a id="l231"></a><a href="#l231">231</a><td> * FINE is a message level providing tracing information.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * This level is initialized to &lt;CODE&gt;500&lt;/CODE&gt;.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l234"></a><a href="#l234">234</a><td> */<tr><td><a id="l235"></a><a href="#l235">235</a><td>goog.debug.Logger.Level.FINE = new goog.debug.Logger.Level(&#39;FINE&#39;, 500);<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * FINER indicates a fairly detailed tracing message.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * This level is initialized to &lt;CODE&gt;400&lt;/CODE&gt;.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l242"></a><a href="#l242">242</a><td> */<tr><td><a id="l243"></a><a href="#l243">243</a><td>goog.debug.Logger.Level.FINER = new goog.debug.Logger.Level(&#39;FINER&#39;, 400);<tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td>/**<tr><td><a id="l246"></a><a href="#l246">246</a><td> * FINEST indicates a highly detailed tracing message.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * This level is initialized to &lt;CODE&gt;300&lt;/CODE&gt;.<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l249"></a><a href="#l249">249</a><td> */<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td>goog.debug.Logger.Level.FINEST = new goog.debug.Logger.Level(&#39;FINEST&#39;, 300);<tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td>/**<tr><td><a id="l255"></a><a href="#l255">255</a><td> * ALL indicates that all messages should be logged.<tr><td><a id="l256"></a><a href="#l256">256</a><td> * This level is initialized to &lt;CODE&gt;0&lt;/CODE&gt;.<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @type {!goog.debug.Logger.Level}<tr><td><a id="l258"></a><a href="#l258">258</a><td> */<tr><td><a id="l259"></a><a href="#l259">259</a><td>goog.debug.Logger.Level.ALL = new goog.debug.Logger.Level(&#39;ALL&#39;, 0);<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> * The predefined levels.<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @type {!Array&lt;!goog.debug.Logger.Level&gt;}<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @final<tr><td><a id="l266"></a><a href="#l266">266</a><td> */<tr><td><a id="l267"></a><a href="#l267">267</a><td>goog.debug.Logger.Level.PREDEFINED_LEVELS = [<tr><td><a id="l268"></a><a href="#l268">268</a><td>  goog.debug.Logger.Level.OFF,<tr><td><a id="l269"></a><a href="#l269">269</a><td>  goog.debug.Logger.Level.SHOUT,<tr><td><a id="l270"></a><a href="#l270">270</a><td>  goog.debug.Logger.Level.SEVERE,<tr><td><a id="l271"></a><a href="#l271">271</a><td>  goog.debug.Logger.Level.WARNING,<tr><td><a id="l272"></a><a href="#l272">272</a><td>  goog.debug.Logger.Level.INFO,<tr><td><a id="l273"></a><a href="#l273">273</a><td>  goog.debug.Logger.Level.CONFIG,<tr><td><a id="l274"></a><a href="#l274">274</a><td>  goog.debug.Logger.Level.FINE,<tr><td><a id="l275"></a><a href="#l275">275</a><td>  goog.debug.Logger.Level.FINER,<tr><td><a id="l276"></a><a href="#l276">276</a><td>  goog.debug.Logger.Level.FINEST,<tr><td><a id="l277"></a><a href="#l277">277</a><td>  goog.debug.Logger.Level.ALL];<tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td>/**<tr><td><a id="l281"></a><a href="#l281">281</a><td> * A lookup map used to find the level object based on the name or value of<tr><td><a id="l282"></a><a href="#l282">282</a><td> * the level object.<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @type {Object}<tr><td><a id="l284"></a><a href="#l284">284</a><td> * @private<tr><td><a id="l285"></a><a href="#l285">285</a><td> */<tr><td><a id="l286"></a><a href="#l286">286</a><td>goog.debug.Logger.Level.predefinedLevelsCache_ = null;<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>/**<tr><td><a id="l290"></a><a href="#l290">290</a><td> * Creates the predefined levels cache and populates it.<tr><td><a id="l291"></a><a href="#l291">291</a><td> * @private<tr><td><a id="l292"></a><a href="#l292">292</a><td> */<tr><td><a id="l293"></a><a href="#l293">293</a><td>goog.debug.Logger.Level.createPredefinedLevelsCache_ = function() {<tr><td><a id="l294"></a><a href="#l294">294</a><td>  goog.debug.Logger.Level.predefinedLevelsCache_ = {};<tr><td><a id="l295"></a><a href="#l295">295</a><td>  for (var i = 0, level; level = goog.debug.Logger.Level.PREDEFINED_LEVELS[i];<tr><td><a id="l296"></a><a href="#l296">296</a><td>       i++) {<tr><td><a id="l297"></a><a href="#l297">297</a><td>    goog.debug.Logger.Level.predefinedLevelsCache_[level.value] = level;<tr><td><a id="l298"></a><a href="#l298">298</a><td>    goog.debug.Logger.Level.predefinedLevelsCache_[level.name] = level;<tr><td><a id="l299"></a><a href="#l299">299</a><td>  }<tr><td><a id="l300"></a><a href="#l300">300</a><td>};<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td>/**<tr><td><a id="l304"></a><a href="#l304">304</a><td> * Gets the predefined level with the given name.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @param {string} name The name of the level.<tr><td><a id="l306"></a><a href="#l306">306</a><td> * @return {goog.debug.Logger.Level} The level, or null if none found.<tr><td><a id="l307"></a><a href="#l307">307</a><td> */<tr><td><a id="l308"></a><a href="#l308">308</a><td>goog.debug.Logger.Level.getPredefinedLevel = function(name) {<tr><td><a id="l309"></a><a href="#l309">309</a><td>  if (!goog.debug.Logger.Level.predefinedLevelsCache_) {<tr><td><a id="l310"></a><a href="#l310">310</a><td>    goog.debug.Logger.Level.createPredefinedLevelsCache_();<tr><td><a id="l311"></a><a href="#l311">311</a><td>  }<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td>  return goog.debug.Logger.Level.predefinedLevelsCache_[name] || null;<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><tr><td><a id="l317"></a><a href="#l317">317</a><td>/**<tr><td><a id="l318"></a><a href="#l318">318</a><td> * Gets the highest predefined level &lt;= #value.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @param {number} value Level value.<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @return {goog.debug.Logger.Level} The level, or null if none found.<tr><td><a id="l321"></a><a href="#l321">321</a><td> */<tr><td><a id="l322"></a><a href="#l322">322</a><td>goog.debug.Logger.Level.getPredefinedLevelByValue = function(value) {<tr><td><a id="l323"></a><a href="#l323">323</a><td>  if (!goog.debug.Logger.Level.predefinedLevelsCache_) {<tr><td><a id="l324"></a><a href="#l324">324</a><td>    goog.debug.Logger.Level.createPredefinedLevelsCache_();<tr><td><a id="l325"></a><a href="#l325">325</a><td>  }<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td>  if (value in goog.debug.Logger.Level.predefinedLevelsCache_) {<tr><td><a id="l328"></a><a href="#l328">328</a><td>    return goog.debug.Logger.Level.predefinedLevelsCache_[value];<tr><td><a id="l329"></a><a href="#l329">329</a><td>  }<tr><td><a id="l330"></a><a href="#l330">330</a><td><tr><td><a id="l331"></a><a href="#l331">331</a><td>  for (var i = 0; i &lt; goog.debug.Logger.Level.PREDEFINED_LEVELS.length; ++i) {<tr><td><a id="l332"></a><a href="#l332">332</a><td>    var level = goog.debug.Logger.Level.PREDEFINED_LEVELS[i];<tr><td><a id="l333"></a><a href="#l333">333</a><td>    if (level.value &lt;= value) {<tr><td><a id="l334"></a><a href="#l334">334</a><td>      return level;<tr><td><a id="l335"></a><a href="#l335">335</a><td>    }<tr><td><a id="l336"></a><a href="#l336">336</a><td>  }<tr><td><a id="l337"></a><a href="#l337">337</a><td>  return null;<tr><td><a id="l338"></a><a href="#l338">338</a><td>};<tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td>/**<tr><td><a id="l342"></a><a href="#l342">342</a><td> * Finds or creates a logger for a named subsystem. If a logger has already been<tr><td><a id="l343"></a><a href="#l343">343</a><td> * created with the given name it is returned. Otherwise a new logger is<tr><td><a id="l344"></a><a href="#l344">344</a><td> * created. If a new logger is created its log level will be configured based<tr><td><a id="l345"></a><a href="#l345">345</a><td> * on the LogManager configuration and it will configured to also send logging<tr><td><a id="l346"></a><a href="#l346">346</a><td> * output to its parent&#39;s handlers. It will be registered in the LogManager<tr><td><a id="l347"></a><a href="#l347">347</a><td> * global namespace.<tr><td><a id="l348"></a><a href="#l348">348</a><td> *<tr><td><a id="l349"></a><a href="#l349">349</a><td> * @param {string} name A name for the logger. This should be a dot-separated<tr><td><a id="l350"></a><a href="#l350">350</a><td> * name and should normally be based on the package name or class name of the<tr><td><a id="l351"></a><a href="#l351">351</a><td> * subsystem, such as goog.net.BrowserChannel.<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @return {!goog.debug.Logger} The named logger.<tr><td><a id="l353"></a><a href="#l353">353</a><td> * @deprecated use goog.log instead. http://go/goog-debug-logger-deprecated<tr><td><a id="l354"></a><a href="#l354">354</a><td> */<tr><td><a id="l355"></a><a href="#l355">355</a><td>goog.debug.Logger.getLogger = function(name) {<tr><td><a id="l356"></a><a href="#l356">356</a><td>  return goog.debug.LogManager.getLogger(name);<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>/**<tr><td><a id="l361"></a><a href="#l361">361</a><td> * Logs a message to profiling tools, if available.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * {@see https://developers.google.com/web-toolkit/speedtracer/logging-api}<tr><td><a id="l363"></a><a href="#l363">363</a><td> * {@see http://msdn.microsoft.com/en-us/library/dd433074(VS.85).aspx}<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @param {string} msg The message to log.<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.debug.Logger.logToProfilers = function(msg) {<tr><td><a id="l367"></a><a href="#l367">367</a><td>  // Using goog.global, as loggers might be used in window-less contexts.<tr><td><a id="l368"></a><a href="#l368">368</a><td>  if (goog.global[&#39;console&#39;]) {<tr><td><a id="l369"></a><a href="#l369">369</a><td>    if (goog.global[&#39;console&#39;][&#39;timeStamp&#39;]) {<tr><td><a id="l370"></a><a href="#l370">370</a><td>      // Logs a message to Firebug, Web Inspector, SpeedTracer, etc.<tr><td><a id="l371"></a><a href="#l371">371</a><td>      goog.global[&#39;console&#39;][&#39;timeStamp&#39;](msg);<tr><td><a id="l372"></a><a href="#l372">372</a><td>    } else if (goog.global[&#39;console&#39;][&#39;markTimeline&#39;]) {<tr><td><a id="l373"></a><a href="#l373">373</a><td>      // TODO(user): markTimeline is deprecated. Drop this else clause entirely<tr><td><a id="l374"></a><a href="#l374">374</a><td>      // after Chrome M14 hits stable.<tr><td><a id="l375"></a><a href="#l375">375</a><td>      goog.global[&#39;console&#39;][&#39;markTimeline&#39;](msg);<tr><td><a id="l376"></a><a href="#l376">376</a><td>    }<tr><td><a id="l377"></a><a href="#l377">377</a><td>  }<tr><td><a id="l378"></a><a href="#l378">378</a><td><tr><td><a id="l379"></a><a href="#l379">379</a><td>  if (goog.global[&#39;msWriteProfilerMark&#39;]) {<tr><td><a id="l380"></a><a href="#l380">380</a><td>    // Logs a message to the Microsoft profiler<tr><td><a id="l381"></a><a href="#l381">381</a><td>    goog.global[&#39;msWriteProfilerMark&#39;](msg);<tr><td><a id="l382"></a><a href="#l382">382</a><td>  }<tr><td><a id="l383"></a><a href="#l383">383</a><td>};<tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td>/**<tr><td><a id="l387"></a><a href="#l387">387</a><td> * Gets the name of this logger.<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @return {string} The name of this logger.<tr><td><a id="l389"></a><a href="#l389">389</a><td> */<tr><td><a id="l390"></a><a href="#l390">390</a><td>goog.debug.Logger.prototype.getName = function() {<tr><td><a id="l391"></a><a href="#l391">391</a><td>  return this.name_;<tr><td><a id="l392"></a><a href="#l392">392</a><td>};<tr><td><a id="l393"></a><a href="#l393">393</a><td><tr><td><a id="l394"></a><a href="#l394">394</a><td><tr><td><a id="l395"></a><a href="#l395">395</a><td>/**<tr><td><a id="l396"></a><a href="#l396">396</a><td> * Adds a handler to the logger. This doesn&#39;t use the event system because<tr><td><a id="l397"></a><a href="#l397">397</a><td> * we want to be able to add logging to the event system.<tr><td><a id="l398"></a><a href="#l398">398</a><td> * @param {Function} handler Handler function to add.<tr><td><a id="l399"></a><a href="#l399">399</a><td> */<tr><td><a id="l400"></a><a href="#l400">400</a><td>goog.debug.Logger.prototype.addHandler = function(handler) {<tr><td><a id="l401"></a><a href="#l401">401</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l402"></a><a href="#l402">402</a><td>    if (goog.debug.Logger.ENABLE_HIERARCHY) {<tr><td><a id="l403"></a><a href="#l403">403</a><td>      if (!this.handlers_) {<tr><td><a id="l404"></a><a href="#l404">404</a><td>        this.handlers_ = [];<tr><td><a id="l405"></a><a href="#l405">405</a><td>      }<tr><td><a id="l406"></a><a href="#l406">406</a><td>      this.handlers_.push(handler);<tr><td><a id="l407"></a><a href="#l407">407</a><td>    } else {<tr><td><a id="l408"></a><a href="#l408">408</a><td>      goog.asserts.assert(!this.name_,<tr><td><a id="l409"></a><a href="#l409">409</a><td>          &#39;Cannot call addHandler on a non-root logger when &#39; +<tr><td><a id="l410"></a><a href="#l410">410</a><td>          &#39;goog.debug.Logger.ENABLE_HIERARCHY is false.&#39;);<tr><td><a id="l411"></a><a href="#l411">411</a><td>      goog.debug.Logger.rootHandlers_.push(handler);<tr><td><a id="l412"></a><a href="#l412">412</a><td>    }<tr><td><a id="l413"></a><a href="#l413">413</a><td>  }<tr><td><a id="l414"></a><a href="#l414">414</a><td>};<tr><td><a id="l415"></a><a href="#l415">415</a><td><tr><td><a id="l416"></a><a href="#l416">416</a><td><tr><td><a id="l417"></a><a href="#l417">417</a><td>/**<tr><td><a id="l418"></a><a href="#l418">418</a><td> * Removes a handler from the logger. This doesn&#39;t use the event system because<tr><td><a id="l419"></a><a href="#l419">419</a><td> * we want to be able to add logging to the event system.<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @param {Function} handler Handler function to remove.<tr><td><a id="l421"></a><a href="#l421">421</a><td> * @return {boolean} Whether the handler was removed.<tr><td><a id="l422"></a><a href="#l422">422</a><td> */<tr><td><a id="l423"></a><a href="#l423">423</a><td>goog.debug.Logger.prototype.removeHandler = function(handler) {<tr><td><a id="l424"></a><a href="#l424">424</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l425"></a><a href="#l425">425</a><td>    var handlers = goog.debug.Logger.ENABLE_HIERARCHY ? this.handlers_ :<tr><td><a id="l426"></a><a href="#l426">426</a><td>        goog.debug.Logger.rootHandlers_;<tr><td><a id="l427"></a><a href="#l427">427</a><td>    return !!handlers &amp;&amp; goog.array.remove(handlers, handler);<tr><td><a id="l428"></a><a href="#l428">428</a><td>  } else {<tr><td><a id="l429"></a><a href="#l429">429</a><td>    return false;<tr><td><a id="l430"></a><a href="#l430">430</a><td>  }<tr><td><a id="l431"></a><a href="#l431">431</a><td>};<tr><td><a id="l432"></a><a href="#l432">432</a><td><tr><td><a id="l433"></a><a href="#l433">433</a><td><tr><td><a id="l434"></a><a href="#l434">434</a><td>/**<tr><td><a id="l435"></a><a href="#l435">435</a><td> * Returns the parent of this logger.<tr><td><a id="l436"></a><a href="#l436">436</a><td> * @return {goog.debug.Logger} The parent logger or null if this is the root.<tr><td><a id="l437"></a><a href="#l437">437</a><td> */<tr><td><a id="l438"></a><a href="#l438">438</a><td>goog.debug.Logger.prototype.getParent = function() {<tr><td><a id="l439"></a><a href="#l439">439</a><td>  return this.parent_;<tr><td><a id="l440"></a><a href="#l440">440</a><td>};<tr><td><a id="l441"></a><a href="#l441">441</a><td><tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td>/**<tr><td><a id="l444"></a><a href="#l444">444</a><td> * Returns the children of this logger as a map of the child name to the logger.<tr><td><a id="l445"></a><a href="#l445">445</a><td> * @return {!Object} The map where the keys are the child leaf names and the<tr><td><a id="l446"></a><a href="#l446">446</a><td> *     values are the Logger objects.<tr><td><a id="l447"></a><a href="#l447">447</a><td> */<tr><td><a id="l448"></a><a href="#l448">448</a><td>goog.debug.Logger.prototype.getChildren = function() {<tr><td><a id="l449"></a><a href="#l449">449</a><td>  if (!this.children_) {<tr><td><a id="l450"></a><a href="#l450">450</a><td>    this.children_ = {};<tr><td><a id="l451"></a><a href="#l451">451</a><td>  }<tr><td><a id="l452"></a><a href="#l452">452</a><td>  return this.children_;<tr><td><a id="l453"></a><a href="#l453">453</a><td>};<tr><td><a id="l454"></a><a href="#l454">454</a><td><tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td>/**<tr><td><a id="l457"></a><a href="#l457">457</a><td> * Set the log level specifying which message levels will be logged by this<tr><td><a id="l458"></a><a href="#l458">458</a><td> * logger. Message levels lower than this value will be discarded.<tr><td><a id="l459"></a><a href="#l459">459</a><td> * The level value Level.OFF can be used to turn off logging. If the new level<tr><td><a id="l460"></a><a href="#l460">460</a><td> * is null, it means that this node should inherit its level from its nearest<tr><td><a id="l461"></a><a href="#l461">461</a><td> * ancestor with a specific (non-null) level value.<tr><td><a id="l462"></a><a href="#l462">462</a><td> *<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @param {goog.debug.Logger.Level} level The new level.<tr><td><a id="l464"></a><a href="#l464">464</a><td> */<tr><td><a id="l465"></a><a href="#l465">465</a><td>goog.debug.Logger.prototype.setLevel = function(level) {<tr><td><a id="l466"></a><a href="#l466">466</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l467"></a><a href="#l467">467</a><td>    if (goog.debug.Logger.ENABLE_HIERARCHY) {<tr><td><a id="l468"></a><a href="#l468">468</a><td>      this.level_ = level;<tr><td><a id="l469"></a><a href="#l469">469</a><td>    } else {<tr><td><a id="l470"></a><a href="#l470">470</a><td>      goog.asserts.assert(!this.name_,<tr><td><a id="l471"></a><a href="#l471">471</a><td>          &#39;Cannot call setLevel() on a non-root logger when &#39; +<tr><td><a id="l472"></a><a href="#l472">472</a><td>          &#39;goog.debug.Logger.ENABLE_HIERARCHY is false.&#39;);<tr><td><a id="l473"></a><a href="#l473">473</a><td>      goog.debug.Logger.rootLevel_ = level;<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>};<tr><td><a id="l477"></a><a href="#l477">477</a><td><tr><td><a id="l478"></a><a href="#l478">478</a><td><tr><td><a id="l479"></a><a href="#l479">479</a><td>/**<tr><td><a id="l480"></a><a href="#l480">480</a><td> * Gets the log level specifying which message levels will be logged by this<tr><td><a id="l481"></a><a href="#l481">481</a><td> * logger. Message levels lower than this value will be discarded.<tr><td><a id="l482"></a><a href="#l482">482</a><td> * The level value Level.OFF can be used to turn off logging. If the level<tr><td><a id="l483"></a><a href="#l483">483</a><td> * is null, it means that this node should inherit its level from its nearest<tr><td><a id="l484"></a><a href="#l484">484</a><td> * ancestor with a specific (non-null) level value.<tr><td><a id="l485"></a><a href="#l485">485</a><td> *<tr><td><a id="l486"></a><a href="#l486">486</a><td> * @return {goog.debug.Logger.Level} The level.<tr><td><a id="l487"></a><a href="#l487">487</a><td> */<tr><td><a id="l488"></a><a href="#l488">488</a><td>goog.debug.Logger.prototype.getLevel = function() {<tr><td><a id="l489"></a><a href="#l489">489</a><td>  return goog.debug.LOGGING_ENABLED ?<tr><td><a id="l490"></a><a href="#l490">490</a><td>      this.level_ : goog.debug.Logger.Level.OFF;<tr><td><a id="l491"></a><a href="#l491">491</a><td>};<tr><td><a id="l492"></a><a href="#l492">492</a><td><tr><td><a id="l493"></a><a href="#l493">493</a><td><tr><td><a id="l494"></a><a href="#l494">494</a><td>/**<tr><td><a id="l495"></a><a href="#l495">495</a><td> * Returns the effective level of the logger based on its ancestors&#39; levels.<tr><td><a id="l496"></a><a href="#l496">496</a><td> * @return {goog.debug.Logger.Level} The level.<tr><td><a id="l497"></a><a href="#l497">497</a><td> */<tr><td><a id="l498"></a><a href="#l498">498</a><td>goog.debug.Logger.prototype.getEffectiveLevel = function() {<tr><td><a id="l499"></a><a href="#l499">499</a><td>  if (!goog.debug.LOGGING_ENABLED) {<tr><td><a id="l500"></a><a href="#l500">500</a><td>    return goog.debug.Logger.Level.OFF;<tr><td><a id="l501"></a><a href="#l501">501</a><td>  }<tr><td><a id="l502"></a><a href="#l502">502</a><td><tr><td><a id="l503"></a><a href="#l503">503</a><td>  if (!goog.debug.Logger.ENABLE_HIERARCHY) {<tr><td><a id="l504"></a><a href="#l504">504</a><td>    return goog.debug.Logger.rootLevel_;<tr><td><a id="l505"></a><a href="#l505">505</a><td>  }<tr><td><a id="l506"></a><a href="#l506">506</a><td>  if (this.level_) {<tr><td><a id="l507"></a><a href="#l507">507</a><td>    return this.level_;<tr><td><a id="l508"></a><a href="#l508">508</a><td>  }<tr><td><a id="l509"></a><a href="#l509">509</a><td>  if (this.parent_) {<tr><td><a id="l510"></a><a href="#l510">510</a><td>    return this.parent_.getEffectiveLevel();<tr><td><a id="l511"></a><a href="#l511">511</a><td>  }<tr><td><a id="l512"></a><a href="#l512">512</a><td>  goog.asserts.fail(&#39;Root logger has no level set.&#39;);<tr><td><a id="l513"></a><a href="#l513">513</a><td>  return null;<tr><td><a id="l514"></a><a href="#l514">514</a><td>};<tr><td><a id="l515"></a><a href="#l515">515</a><td><tr><td><a id="l516"></a><a href="#l516">516</a><td><tr><td><a id="l517"></a><a href="#l517">517</a><td>/**<tr><td><a id="l518"></a><a href="#l518">518</a><td> * Checks if a message of the given level would actually be logged by this<tr><td><a id="l519"></a><a href="#l519">519</a><td> * logger. This check is based on the Loggers effective level, which may be<tr><td><a id="l520"></a><a href="#l520">520</a><td> * inherited from its parent.<tr><td><a id="l521"></a><a href="#l521">521</a><td> * @param {goog.debug.Logger.Level} level The level to check.<tr><td><a id="l522"></a><a href="#l522">522</a><td> * @return {boolean} Whether the message would be logged.<tr><td><a id="l523"></a><a href="#l523">523</a><td> */<tr><td><a id="l524"></a><a href="#l524">524</a><td>goog.debug.Logger.prototype.isLoggable = function(level) {<tr><td><a id="l525"></a><a href="#l525">525</a><td>  return goog.debug.LOGGING_ENABLED &amp;&amp;<tr><td><a id="l526"></a><a href="#l526">526</a><td>      level.value &gt;= this.getEffectiveLevel().value;<tr><td><a id="l527"></a><a href="#l527">527</a><td>};<tr><td><a id="l528"></a><a href="#l528">528</a><td><tr><td><a id="l529"></a><a href="#l529">529</a><td><tr><td><a id="l530"></a><a href="#l530">530</a><td>/**<tr><td><a id="l531"></a><a href="#l531">531</a><td> * Logs a message. If the logger is currently enabled for the<tr><td><a id="l532"></a><a href="#l532">532</a><td> * given message level then the given message is forwarded to all the<tr><td><a id="l533"></a><a href="#l533">533</a><td> * registered output Handler objects.<tr><td><a id="l534"></a><a href="#l534">534</a><td> * @param {goog.debug.Logger.Level} level One of the level identifiers.<tr><td><a id="l535"></a><a href="#l535">535</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l536"></a><a href="#l536">536</a><td> * @param {Error|Object=} opt_exception An exception associated with the<tr><td><a id="l537"></a><a href="#l537">537</a><td> *     message.<tr><td><a id="l538"></a><a href="#l538">538</a><td> */<tr><td><a id="l539"></a><a href="#l539">539</a><td>goog.debug.Logger.prototype.log = function(level, msg, opt_exception) {<tr><td><a id="l540"></a><a href="#l540">540</a><td>  // java caches the effective level, not sure it&#39;s necessary here<tr><td><a id="l541"></a><a href="#l541">541</a><td>  if (goog.debug.LOGGING_ENABLED &amp;&amp; this.isLoggable(level)) {<tr><td><a id="l542"></a><a href="#l542">542</a><td>    // Message callbacks can be useful when a log message is expensive to build.<tr><td><a id="l543"></a><a href="#l543">543</a><td>    if (goog.isFunction(msg)) {<tr><td><a id="l544"></a><a href="#l544">544</a><td>      msg = msg();<tr><td><a id="l545"></a><a href="#l545">545</a><td>    }<tr><td><a id="l546"></a><a href="#l546">546</a><td><tr><td><a id="l547"></a><a href="#l547">547</a><td>    this.doLogRecord_(this.getLogRecord(level, msg, opt_exception));<tr><td><a id="l548"></a><a href="#l548">548</a><td>  }<tr><td><a id="l549"></a><a href="#l549">549</a><td>};<tr><td><a id="l550"></a><a href="#l550">550</a><td><tr><td><a id="l551"></a><a href="#l551">551</a><td><tr><td><a id="l552"></a><a href="#l552">552</a><td>/**<tr><td><a id="l553"></a><a href="#l553">553</a><td> * Creates a new log record and adds the exception (if present) to it.<tr><td><a id="l554"></a><a href="#l554">554</a><td> * @param {goog.debug.Logger.Level} level One of the level identifiers.<tr><td><a id="l555"></a><a href="#l555">555</a><td> * @param {string} msg The string message.<tr><td><a id="l556"></a><a href="#l556">556</a><td> * @param {Error|Object=} opt_exception An exception associated with the<tr><td><a id="l557"></a><a href="#l557">557</a><td> *     message.<tr><td><a id="l558"></a><a href="#l558">558</a><td> * @return {!goog.debug.LogRecord} A log record.<tr><td><a id="l559"></a><a href="#l559">559</a><td> * @suppress {es5Strict}<tr><td><a id="l560"></a><a href="#l560">560</a><td> */<tr><td><a id="l561"></a><a href="#l561">561</a><td>goog.debug.Logger.prototype.getLogRecord = function(<tr><td><a id="l562"></a><a href="#l562">562</a><td>    level, msg, opt_exception) {<tr><td><a id="l563"></a><a href="#l563">563</a><td>  if (goog.debug.LogBuffer.isBufferingEnabled()) {<tr><td><a id="l564"></a><a href="#l564">564</a><td>    var logRecord =<tr><td><a id="l565"></a><a href="#l565">565</a><td>        goog.debug.LogBuffer.getInstance().addRecord(level, msg, this.name_);<tr><td><a id="l566"></a><a href="#l566">566</a><td>  } else {<tr><td><a id="l567"></a><a href="#l567">567</a><td>    logRecord = new goog.debug.LogRecord(level, String(msg), this.name_);<tr><td><a id="l568"></a><a href="#l568">568</a><td>  }<tr><td><a id="l569"></a><a href="#l569">569</a><td>  if (opt_exception) {<tr><td><a id="l570"></a><a href="#l570">570</a><td>    logRecord.setException(opt_exception);<tr><td><a id="l571"></a><a href="#l571">571</a><td>  }<tr><td><a id="l572"></a><a href="#l572">572</a><td>  return logRecord;<tr><td><a id="l573"></a><a href="#l573">573</a><td>};<tr><td><a id="l574"></a><a href="#l574">574</a><td><tr><td><a id="l575"></a><a href="#l575">575</a><td><tr><td><a id="l576"></a><a href="#l576">576</a><td>/**<tr><td><a id="l577"></a><a href="#l577">577</a><td> * Logs a message at the Logger.Level.SHOUT level.<tr><td><a id="l578"></a><a href="#l578">578</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l579"></a><a href="#l579">579</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l580"></a><a href="#l580">580</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l581"></a><a href="#l581">581</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l582"></a><a href="#l582">582</a><td> */<tr><td><a id="l583"></a><a href="#l583">583</a><td>goog.debug.Logger.prototype.shout = function(msg, opt_exception) {<tr><td><a id="l584"></a><a href="#l584">584</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l585"></a><a href="#l585">585</a><td>    this.log(goog.debug.Logger.Level.SHOUT, msg, opt_exception);<tr><td><a id="l586"></a><a href="#l586">586</a><td>  }<tr><td><a id="l587"></a><a href="#l587">587</a><td>};<tr><td><a id="l588"></a><a href="#l588">588</a><td><tr><td><a id="l589"></a><a href="#l589">589</a><td><tr><td><a id="l590"></a><a href="#l590">590</a><td>/**<tr><td><a id="l591"></a><a href="#l591">591</a><td> * Logs a message at the Logger.Level.SEVERE level.<tr><td><a id="l592"></a><a href="#l592">592</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l593"></a><a href="#l593">593</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l594"></a><a href="#l594">594</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l595"></a><a href="#l595">595</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l596"></a><a href="#l596">596</a><td> */<tr><td><a id="l597"></a><a href="#l597">597</a><td>goog.debug.Logger.prototype.severe = function(msg, opt_exception) {<tr><td><a id="l598"></a><a href="#l598">598</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l599"></a><a href="#l599">599</a><td>    this.log(goog.debug.Logger.Level.SEVERE, msg, opt_exception);<tr><td><a id="l600"></a><a href="#l600">600</a><td>  }<tr><td><a id="l601"></a><a href="#l601">601</a><td>};<tr><td><a id="l602"></a><a href="#l602">602</a><td><tr><td><a id="l603"></a><a href="#l603">603</a><td><tr><td><a id="l604"></a><a href="#l604">604</a><td>/**<tr><td><a id="l605"></a><a href="#l605">605</a><td> * Logs a message at the Logger.Level.WARNING level.<tr><td><a id="l606"></a><a href="#l606">606</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l607"></a><a href="#l607">607</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l608"></a><a href="#l608">608</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l609"></a><a href="#l609">609</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l610"></a><a href="#l610">610</a><td> */<tr><td><a id="l611"></a><a href="#l611">611</a><td>goog.debug.Logger.prototype.warning = function(msg, opt_exception) {<tr><td><a id="l612"></a><a href="#l612">612</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l613"></a><a href="#l613">613</a><td>    this.log(goog.debug.Logger.Level.WARNING, msg, opt_exception);<tr><td><a id="l614"></a><a href="#l614">614</a><td>  }<tr><td><a id="l615"></a><a href="#l615">615</a><td>};<tr><td><a id="l616"></a><a href="#l616">616</a><td><tr><td><a id="l617"></a><a href="#l617">617</a><td><tr><td><a id="l618"></a><a href="#l618">618</a><td>/**<tr><td><a id="l619"></a><a href="#l619">619</a><td> * Logs a message at the Logger.Level.INFO level.<tr><td><a id="l620"></a><a href="#l620">620</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l621"></a><a href="#l621">621</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l622"></a><a href="#l622">622</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l623"></a><a href="#l623">623</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l624"></a><a href="#l624">624</a><td> */<tr><td><a id="l625"></a><a href="#l625">625</a><td>goog.debug.Logger.prototype.info = function(msg, opt_exception) {<tr><td><a id="l626"></a><a href="#l626">626</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l627"></a><a href="#l627">627</a><td>    this.log(goog.debug.Logger.Level.INFO, msg, opt_exception);<tr><td><a id="l628"></a><a href="#l628">628</a><td>  }<tr><td><a id="l629"></a><a href="#l629">629</a><td>};<tr><td><a id="l630"></a><a href="#l630">630</a><td><tr><td><a id="l631"></a><a href="#l631">631</a><td><tr><td><a id="l632"></a><a href="#l632">632</a><td>/**<tr><td><a id="l633"></a><a href="#l633">633</a><td> * Logs a message at the Logger.Level.CONFIG level.<tr><td><a id="l634"></a><a href="#l634">634</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l635"></a><a href="#l635">635</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l636"></a><a href="#l636">636</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l637"></a><a href="#l637">637</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l638"></a><a href="#l638">638</a><td> */<tr><td><a id="l639"></a><a href="#l639">639</a><td>goog.debug.Logger.prototype.config = function(msg, opt_exception) {<tr><td><a id="l640"></a><a href="#l640">640</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l641"></a><a href="#l641">641</a><td>    this.log(goog.debug.Logger.Level.CONFIG, msg, opt_exception);<tr><td><a id="l642"></a><a href="#l642">642</a><td>  }<tr><td><a id="l643"></a><a href="#l643">643</a><td>};<tr><td><a id="l644"></a><a href="#l644">644</a><td><tr><td><a id="l645"></a><a href="#l645">645</a><td><tr><td><a id="l646"></a><a href="#l646">646</a><td>/**<tr><td><a id="l647"></a><a href="#l647">647</a><td> * Logs a message at the Logger.Level.FINE level.<tr><td><a id="l648"></a><a href="#l648">648</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l649"></a><a href="#l649">649</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l650"></a><a href="#l650">650</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l651"></a><a href="#l651">651</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l652"></a><a href="#l652">652</a><td> */<tr><td><a id="l653"></a><a href="#l653">653</a><td>goog.debug.Logger.prototype.fine = function(msg, opt_exception) {<tr><td><a id="l654"></a><a href="#l654">654</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l655"></a><a href="#l655">655</a><td>    this.log(goog.debug.Logger.Level.FINE, msg, opt_exception);<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><tr><td><a id="l660"></a><a href="#l660">660</a><td>/**<tr><td><a id="l661"></a><a href="#l661">661</a><td> * Logs a message at the Logger.Level.FINER level.<tr><td><a id="l662"></a><a href="#l662">662</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l663"></a><a href="#l663">663</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l664"></a><a href="#l664">664</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l665"></a><a href="#l665">665</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l666"></a><a href="#l666">666</a><td> */<tr><td><a id="l667"></a><a href="#l667">667</a><td>goog.debug.Logger.prototype.finer = function(msg, opt_exception) {<tr><td><a id="l668"></a><a href="#l668">668</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l669"></a><a href="#l669">669</a><td>    this.log(goog.debug.Logger.Level.FINER, msg, opt_exception);<tr><td><a id="l670"></a><a href="#l670">670</a><td>  }<tr><td><a id="l671"></a><a href="#l671">671</a><td>};<tr><td><a id="l672"></a><a href="#l672">672</a><td><tr><td><a id="l673"></a><a href="#l673">673</a><td><tr><td><a id="l674"></a><a href="#l674">674</a><td>/**<tr><td><a id="l675"></a><a href="#l675">675</a><td> * Logs a message at the Logger.Level.FINEST level.<tr><td><a id="l676"></a><a href="#l676">676</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l677"></a><a href="#l677">677</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l678"></a><a href="#l678">678</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l679"></a><a href="#l679">679</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l680"></a><a href="#l680">680</a><td> */<tr><td><a id="l681"></a><a href="#l681">681</a><td>goog.debug.Logger.prototype.finest = function(msg, opt_exception) {<tr><td><a id="l682"></a><a href="#l682">682</a><td>  if (goog.debug.LOGGING_ENABLED) {<tr><td><a id="l683"></a><a href="#l683">683</a><td>    this.log(goog.debug.Logger.Level.FINEST, msg, opt_exception);<tr><td><a id="l684"></a><a href="#l684">684</a><td>  }<tr><td><a id="l685"></a><a href="#l685">685</a><td>};<tr><td><a id="l686"></a><a href="#l686">686</a><td><tr><td><a id="l687"></a><a href="#l687">687</a><td><tr><td><a id="l688"></a><a href="#l688">688</a><td>/**<tr><td><a id="l689"></a><a href="#l689">689</a><td> * Logs a LogRecord. If the logger is currently enabled for the<tr><td><a id="l690"></a><a href="#l690">690</a><td> * given message level then the given message is forwarded to all the<tr><td><a id="l691"></a><a href="#l691">691</a><td> * registered output Handler objects.<tr><td><a id="l692"></a><a href="#l692">692</a><td> * @param {goog.debug.LogRecord} logRecord A log record to log.<tr><td><a id="l693"></a><a href="#l693">693</a><td> */<tr><td><a id="l694"></a><a href="#l694">694</a><td>goog.debug.Logger.prototype.logRecord = function(logRecord) {<tr><td><a id="l695"></a><a href="#l695">695</a><td>  if (goog.debug.LOGGING_ENABLED &amp;&amp; this.isLoggable(logRecord.getLevel())) {<tr><td><a id="l696"></a><a href="#l696">696</a><td>    this.doLogRecord_(logRecord);<tr><td><a id="l697"></a><a href="#l697">697</a><td>  }<tr><td><a id="l698"></a><a href="#l698">698</a><td>};<tr><td><a id="l699"></a><a href="#l699">699</a><td><tr><td><a id="l700"></a><a href="#l700">700</a><td><tr><td><a id="l701"></a><a href="#l701">701</a><td>/**<tr><td><a id="l702"></a><a href="#l702">702</a><td> * Logs a LogRecord.<tr><td><a id="l703"></a><a href="#l703">703</a><td> * @param {goog.debug.LogRecord} logRecord A log record to log.<tr><td><a id="l704"></a><a href="#l704">704</a><td> * @private<tr><td><a id="l705"></a><a href="#l705">705</a><td> */<tr><td><a id="l706"></a><a href="#l706">706</a><td>goog.debug.Logger.prototype.doLogRecord_ = function(logRecord) {<tr><td><a id="l707"></a><a href="#l707">707</a><td>  goog.debug.Logger.logToProfilers(&#39;log:&#39; + logRecord.getMessage());<tr><td><a id="l708"></a><a href="#l708">708</a><td>  if (goog.debug.Logger.ENABLE_HIERARCHY) {<tr><td><a id="l709"></a><a href="#l709">709</a><td>    var target = this;<tr><td><a id="l710"></a><a href="#l710">710</a><td>    while (target) {<tr><td><a id="l711"></a><a href="#l711">711</a><td>      target.callPublish_(logRecord);<tr><td><a id="l712"></a><a href="#l712">712</a><td>      target = target.getParent();<tr><td><a id="l713"></a><a href="#l713">713</a><td>    }<tr><td><a id="l714"></a><a href="#l714">714</a><td>  } else {<tr><td><a id="l715"></a><a href="#l715">715</a><td>    for (var i = 0, handler; handler = goog.debug.Logger.rootHandlers_[i++]; ) {<tr><td><a id="l716"></a><a href="#l716">716</a><td>      handler(logRecord);<tr><td><a id="l717"></a><a href="#l717">717</a><td>    }<tr><td><a id="l718"></a><a href="#l718">718</a><td>  }<tr><td><a id="l719"></a><a href="#l719">719</a><td>};<tr><td><a id="l720"></a><a href="#l720">720</a><td><tr><td><a id="l721"></a><a href="#l721">721</a><td><tr><td><a id="l722"></a><a href="#l722">722</a><td>/**<tr><td><a id="l723"></a><a href="#l723">723</a><td> * Calls the handlers for publish.<tr><td><a id="l724"></a><a href="#l724">724</a><td> * @param {goog.debug.LogRecord} logRecord The log record to publish.<tr><td><a id="l725"></a><a href="#l725">725</a><td> * @private<tr><td><a id="l726"></a><a href="#l726">726</a><td> */<tr><td><a id="l727"></a><a href="#l727">727</a><td>goog.debug.Logger.prototype.callPublish_ = function(logRecord) {<tr><td><a id="l728"></a><a href="#l728">728</a><td>  if (this.handlers_) {<tr><td><a id="l729"></a><a href="#l729">729</a><td>    for (var i = 0, handler; handler = this.handlers_[i]; i++) {<tr><td><a id="l730"></a><a href="#l730">730</a><td>      handler(logRecord);<tr><td><a id="l731"></a><a href="#l731">731</a><td>    }<tr><td><a id="l732"></a><a href="#l732">732</a><td>  }<tr><td><a id="l733"></a><a href="#l733">733</a><td>};<tr><td><a id="l734"></a><a href="#l734">734</a><td><tr><td><a id="l735"></a><a href="#l735">735</a><td><tr><td><a id="l736"></a><a href="#l736">736</a><td>/**<tr><td><a id="l737"></a><a href="#l737">737</a><td> * Sets the parent of this logger. This is used for setting up the logger tree.<tr><td><a id="l738"></a><a href="#l738">738</a><td> * @param {goog.debug.Logger} parent The parent logger.<tr><td><a id="l739"></a><a href="#l739">739</a><td> * @private<tr><td><a id="l740"></a><a href="#l740">740</a><td> */<tr><td><a id="l741"></a><a href="#l741">741</a><td>goog.debug.Logger.prototype.setParent_ = function(parent) {<tr><td><a id="l742"></a><a href="#l742">742</a><td>  this.parent_ = parent;<tr><td><a id="l743"></a><a href="#l743">743</a><td>};<tr><td><a id="l744"></a><a href="#l744">744</a><td><tr><td><a id="l745"></a><a href="#l745">745</a><td><tr><td><a id="l746"></a><a href="#l746">746</a><td>/**<tr><td><a id="l747"></a><a href="#l747">747</a><td> * Adds a child to this logger. This is used for setting up the logger tree.<tr><td><a id="l748"></a><a href="#l748">748</a><td> * @param {string} name The leaf name of the child.<tr><td><a id="l749"></a><a href="#l749">749</a><td> * @param {goog.debug.Logger} logger The child logger.<tr><td><a id="l750"></a><a href="#l750">750</a><td> * @private<tr><td><a id="l751"></a><a href="#l751">751</a><td> */<tr><td><a id="l752"></a><a href="#l752">752</a><td>goog.debug.Logger.prototype.addChild_ = function(name, logger) {<tr><td><a id="l753"></a><a href="#l753">753</a><td>  this.getChildren()[name] = logger;<tr><td><a id="l754"></a><a href="#l754">754</a><td>};<tr><td><a id="l755"></a><a href="#l755">755</a><td><tr><td><a id="l756"></a><a href="#l756">756</a><td><tr><td><a id="l757"></a><a href="#l757">757</a><td>/**<tr><td><a id="l758"></a><a href="#l758">758</a><td> * There is a single global LogManager object that is used to maintain a set of<tr><td><a id="l759"></a><a href="#l759">759</a><td> * shared state about Loggers and log services. This is loosely based on the<tr><td><a id="l760"></a><a href="#l760">760</a><td> * java class java.util.logging.LogManager.<tr><td><a id="l761"></a><a href="#l761">761</a><td> * @const<tr><td><a id="l762"></a><a href="#l762">762</a><td> */<tr><td><a id="l763"></a><a href="#l763">763</a><td>goog.debug.LogManager = {};<tr><td><a id="l764"></a><a href="#l764">764</a><td><tr><td><a id="l765"></a><a href="#l765">765</a><td><tr><td><a id="l766"></a><a href="#l766">766</a><td>/**<tr><td><a id="l767"></a><a href="#l767">767</a><td> * Map of logger names to logger objects.<tr><td><a id="l768"></a><a href="#l768">768</a><td> *<tr><td><a id="l769"></a><a href="#l769">769</a><td> * @type {!Object&lt;string, !goog.debug.Logger&gt;}<tr><td><a id="l770"></a><a href="#l770">770</a><td> * @private<tr><td><a id="l771"></a><a href="#l771">771</a><td> */<tr><td><a id="l772"></a><a href="#l772">772</a><td>goog.debug.LogManager.loggers_ = {};<tr><td><a id="l773"></a><a href="#l773">773</a><td><tr><td><a id="l774"></a><a href="#l774">774</a><td><tr><td><a id="l775"></a><a href="#l775">775</a><td>/**<tr><td><a id="l776"></a><a href="#l776">776</a><td> * The root logger which is the root of the logger tree.<tr><td><a id="l777"></a><a href="#l777">777</a><td> * @type {goog.debug.Logger}<tr><td><a id="l778"></a><a href="#l778">778</a><td> * @private<tr><td><a id="l779"></a><a href="#l779">779</a><td> */<tr><td><a id="l780"></a><a href="#l780">780</a><td>goog.debug.LogManager.rootLogger_ = null;<tr><td><a id="l781"></a><a href="#l781">781</a><td><tr><td><a id="l782"></a><a href="#l782">782</a><td><tr><td><a id="l783"></a><a href="#l783">783</a><td>/**<tr><td><a id="l784"></a><a href="#l784">784</a><td> * Initializes the LogManager if not already initialized.<tr><td><a id="l785"></a><a href="#l785">785</a><td> */<tr><td><a id="l786"></a><a href="#l786">786</a><td>goog.debug.LogManager.initialize = function() {<tr><td><a id="l787"></a><a href="#l787">787</a><td>  if (!goog.debug.LogManager.rootLogger_) {<tr><td><a id="l788"></a><a href="#l788">788</a><td>    goog.debug.LogManager.rootLogger_ = new goog.debug.Logger(<tr><td><a id="l789"></a><a href="#l789">789</a><td>        goog.debug.Logger.ROOT_LOGGER_NAME);<tr><td><a id="l790"></a><a href="#l790">790</a><td>    goog.debug.LogManager.loggers_[goog.debug.Logger.ROOT_LOGGER_NAME] =<tr><td><a id="l791"></a><a href="#l791">791</a><td>        goog.debug.LogManager.rootLogger_;<tr><td><a id="l792"></a><a href="#l792">792</a><td>    goog.debug.LogManager.rootLogger_.setLevel(goog.debug.Logger.Level.CONFIG);<tr><td><a id="l793"></a><a href="#l793">793</a><td>  }<tr><td><a id="l794"></a><a href="#l794">794</a><td>};<tr><td><a id="l795"></a><a href="#l795">795</a><td><tr><td><a id="l796"></a><a href="#l796">796</a><td><tr><td><a id="l797"></a><a href="#l797">797</a><td>/**<tr><td><a id="l798"></a><a href="#l798">798</a><td> * Returns all the loggers.<tr><td><a id="l799"></a><a href="#l799">799</a><td> * @return {!Object&lt;string, !goog.debug.Logger&gt;} Map of logger names to logger<tr><td><a id="l800"></a><a href="#l800">800</a><td> *     objects.<tr><td><a id="l801"></a><a href="#l801">801</a><td> */<tr><td><a id="l802"></a><a href="#l802">802</a><td>goog.debug.LogManager.getLoggers = function() {<tr><td><a id="l803"></a><a href="#l803">803</a><td>  return goog.debug.LogManager.loggers_;<tr><td><a id="l804"></a><a href="#l804">804</a><td>};<tr><td><a id="l805"></a><a href="#l805">805</a><td><tr><td><a id="l806"></a><a href="#l806">806</a><td><tr><td><a id="l807"></a><a href="#l807">807</a><td>/**<tr><td><a id="l808"></a><a href="#l808">808</a><td> * Returns the root of the logger tree namespace, the logger with the empty<tr><td><a id="l809"></a><a href="#l809">809</a><td> * string as its name.<tr><td><a id="l810"></a><a href="#l810">810</a><td> *<tr><td><a id="l811"></a><a href="#l811">811</a><td> * @return {!goog.debug.Logger} The root logger.<tr><td><a id="l812"></a><a href="#l812">812</a><td> */<tr><td><a id="l813"></a><a href="#l813">813</a><td>goog.debug.LogManager.getRoot = function() {<tr><td><a id="l814"></a><a href="#l814">814</a><td>  goog.debug.LogManager.initialize();<tr><td><a id="l815"></a><a href="#l815">815</a><td>  return /** @type {!goog.debug.Logger} */ (goog.debug.LogManager.rootLogger_);<tr><td><a id="l816"></a><a href="#l816">816</a><td>};<tr><td><a id="l817"></a><a href="#l817">817</a><td><tr><td><a id="l818"></a><a href="#l818">818</a><td><tr><td><a id="l819"></a><a href="#l819">819</a><td>/**<tr><td><a id="l820"></a><a href="#l820">820</a><td> * Finds a named logger.<tr><td><a id="l821"></a><a href="#l821">821</a><td> *<tr><td><a id="l822"></a><a href="#l822">822</a><td> * @param {string} name A name for the logger. This should be a dot-separated<tr><td><a id="l823"></a><a href="#l823">823</a><td> * name and should normally be based on the package name or class name of the<tr><td><a id="l824"></a><a href="#l824">824</a><td> * subsystem, such as goog.net.BrowserChannel.<tr><td><a id="l825"></a><a href="#l825">825</a><td> * @return {!goog.debug.Logger} The named logger.<tr><td><a id="l826"></a><a href="#l826">826</a><td> */<tr><td><a id="l827"></a><a href="#l827">827</a><td>goog.debug.LogManager.getLogger = function(name) {<tr><td><a id="l828"></a><a href="#l828">828</a><td>  goog.debug.LogManager.initialize();<tr><td><a id="l829"></a><a href="#l829">829</a><td>  var ret = goog.debug.LogManager.loggers_[name];<tr><td><a id="l830"></a><a href="#l830">830</a><td>  return ret || goog.debug.LogManager.createLogger_(name);<tr><td><a id="l831"></a><a href="#l831">831</a><td>};<tr><td><a id="l832"></a><a href="#l832">832</a><td><tr><td><a id="l833"></a><a href="#l833">833</a><td><tr><td><a id="l834"></a><a href="#l834">834</a><td>/**<tr><td><a id="l835"></a><a href="#l835">835</a><td> * Creates a function that can be passed to goog.debug.catchErrors. The function<tr><td><a id="l836"></a><a href="#l836">836</a><td> * will log all reported errors using the given logger.<tr><td><a id="l837"></a><a href="#l837">837</a><td> * @param {goog.debug.Logger=} opt_logger The logger to log the errors to.<tr><td><a id="l838"></a><a href="#l838">838</a><td> *     Defaults to the root logger.<tr><td><a id="l839"></a><a href="#l839">839</a><td> * @return {function(Object)} The created function.<tr><td><a id="l840"></a><a href="#l840">840</a><td> */<tr><td><a id="l841"></a><a href="#l841">841</a><td>goog.debug.LogManager.createFunctionForCatchErrors = function(opt_logger) {<tr><td><a id="l842"></a><a href="#l842">842</a><td>  return function(info) {<tr><td><a id="l843"></a><a href="#l843">843</a><td>    var logger = opt_logger || goog.debug.LogManager.getRoot();<tr><td><a id="l844"></a><a href="#l844">844</a><td>    logger.severe(&#39;Error: &#39; + info.message + &#39; (&#39; + info.fileName +<tr><td><a id="l845"></a><a href="#l845">845</a><td>                  &#39; @ Line: &#39; + info.line + &#39;)&#39;);<tr><td><a id="l846"></a><a href="#l846">846</a><td>  };<tr><td><a id="l847"></a><a href="#l847">847</a><td>};<tr><td><a id="l848"></a><a href="#l848">848</a><td><tr><td><a id="l849"></a><a href="#l849">849</a><td><tr><td><a id="l850"></a><a href="#l850">850</a><td>/**<tr><td><a id="l851"></a><a href="#l851">851</a><td> * Creates the named logger. Will also create the parents of the named logger<tr><td><a id="l852"></a><a href="#l852">852</a><td> * if they don&#39;t yet exist.<tr><td><a id="l853"></a><a href="#l853">853</a><td> * @param {string} name The name of the logger.<tr><td><a id="l854"></a><a href="#l854">854</a><td> * @return {!goog.debug.Logger} The named logger.<tr><td><a id="l855"></a><a href="#l855">855</a><td> * @private<tr><td><a id="l856"></a><a href="#l856">856</a><td> */<tr><td><a id="l857"></a><a href="#l857">857</a><td>goog.debug.LogManager.createLogger_ = function(name) {<tr><td><a id="l858"></a><a href="#l858">858</a><td>  // find parent logger<tr><td><a id="l859"></a><a href="#l859">859</a><td>  var logger = new goog.debug.Logger(name);<tr><td><a id="l860"></a><a href="#l860">860</a><td>  if (goog.debug.Logger.ENABLE_HIERARCHY) {<tr><td><a id="l861"></a><a href="#l861">861</a><td>    var lastDotIndex = name.lastIndexOf(&#39;.&#39;);<tr><td><a id="l862"></a><a href="#l862">862</a><td>    var parentName = name.substr(0, lastDotIndex);<tr><td><a id="l863"></a><a href="#l863">863</a><td>    var leafName = name.substr(lastDotIndex + 1);<tr><td><a id="l864"></a><a href="#l864">864</a><td>    var parentLogger = goog.debug.LogManager.getLogger(parentName);<tr><td><a id="l865"></a><a href="#l865">865</a><td><tr><td><a id="l866"></a><a href="#l866">866</a><td>    // tell the parent about the child and the child about the parent<tr><td><a id="l867"></a><a href="#l867">867</a><td>    parentLogger.addChild_(leafName, logger);<tr><td><a id="l868"></a><a href="#l868">868</a><td>    logger.setParent_(parentLogger);<tr><td><a id="l869"></a><a href="#l869">869</a><td>  }<tr><td><a id="l870"></a><a href="#l870">870</a><td><tr><td><a id="l871"></a><a href="#l871">871</a><td>  goog.debug.LogManager.loggers_[name] = logger;<tr><td><a id="l872"></a><a href="#l872">872</a><td>  return logger;<tr><td><a id="l873"></a><a href="#l873">873</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/debug/logrecord.js.src.html b/docs/source/lib/goog/debug/logrecord.js.src.html
new file mode 100644
index 0000000..fc8deb0
--- /dev/null
+++ b/docs/source/lib/goog/debug/logrecord.js.src.html
@@ -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>logrecord.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/debug/logrecord.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Definition of the LogRecord class. Please minimize<tr><td><a id="l17"></a><a href="#l17">17</a><td> * dependencies this file has on other closure classes as any dependency it<tr><td><a id="l18"></a><a href="#l18">18</a><td> * takes won&#39;t be able to use the logging infrastructure.<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.debug.LogRecord&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * LogRecord objects are used to pass logging requests between<tr><td><a id="l28"></a><a href="#l28">28</a><td> * the logging framework and individual log Handlers.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @constructor<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {goog.debug.Logger.Level} level One of the level identifiers.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @param {string} msg The string message.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {string} loggerName The name of the source logger.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {number=} opt_time Time this log record was created if other than now.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *     If 0, we use #goog.now.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {number=} opt_sequenceNumber Sequence number of this log record. This<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     should only be passed in when restoring a log record from persistence.<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.debug.LogRecord = function(level, msg, loggerName,<tr><td><a id="l39"></a><a href="#l39">39</a><td>    opt_time, opt_sequenceNumber) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>  this.reset(level, msg, loggerName, opt_time, opt_sequenceNumber);<tr><td><a id="l41"></a><a href="#l41">41</a><td>};<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>/**<tr><td><a id="l45"></a><a href="#l45">45</a><td> * Time the LogRecord was created.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @type {number}<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>goog.debug.LogRecord.prototype.time_;<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>/**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * Level of the LogRecord<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @type {goog.debug.Logger.Level}<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @private<tr><td><a id="l56"></a><a href="#l56">56</a><td> */<tr><td><a id="l57"></a><a href="#l57">57</a><td>goog.debug.LogRecord.prototype.level_;<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> * Message associated with the record<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @type {string}<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @private<tr><td><a id="l64"></a><a href="#l64">64</a><td> */<tr><td><a id="l65"></a><a href="#l65">65</a><td>goog.debug.LogRecord.prototype.msg_;<tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td>/**<tr><td><a id="l69"></a><a href="#l69">69</a><td> * Name of the logger that created the record.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @type {string}<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @private<tr><td><a id="l72"></a><a href="#l72">72</a><td> */<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.debug.LogRecord.prototype.loggerName_;<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * Sequence number for the LogRecord. Each record has a unique sequence number<tr><td><a id="l78"></a><a href="#l78">78</a><td> * that is greater than all log records created before it.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @type {number}<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @private<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.debug.LogRecord.prototype.sequenceNumber_ = 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>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Exception associated with the record<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @type {Object}<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @private<tr><td><a id="l89"></a><a href="#l89">89</a><td> */<tr><td><a id="l90"></a><a href="#l90">90</a><td>goog.debug.LogRecord.prototype.exception_ = null;<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> * @define {boolean} Whether to enable log sequence numbers.<tr><td><a id="l95"></a><a href="#l95">95</a><td> */<tr><td><a id="l96"></a><a href="#l96">96</a><td>goog.define(&#39;goog.debug.LogRecord.ENABLE_SEQUENCE_NUMBERS&#39;, true);<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td>/**<tr><td><a id="l100"></a><a href="#l100">100</a><td> * A sequence counter for assigning increasing sequence numbers to LogRecord<tr><td><a id="l101"></a><a href="#l101">101</a><td> * objects.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @type {number}<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @private<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.debug.LogRecord.nextSequenceNumber_ = 0;<tr><td><a id="l106"></a><a href="#l106">106</a><td><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> * Sets all fields of the log record.<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @param {goog.debug.Logger.Level} level One of the level identifiers.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @param {string} msg The string message.<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @param {string} loggerName The name of the source logger.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @param {number=} opt_time Time this log record was created if other than now.<tr><td><a id="l114"></a><a href="#l114">114</a><td> *     If 0, we use #goog.now.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {number=} opt_sequenceNumber Sequence number of this log record. This<tr><td><a id="l116"></a><a href="#l116">116</a><td> *     should only be passed in when restoring a log record from persistence.<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.debug.LogRecord.prototype.reset = function(level, msg, loggerName,<tr><td><a id="l119"></a><a href="#l119">119</a><td>    opt_time, opt_sequenceNumber) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>  if (goog.debug.LogRecord.ENABLE_SEQUENCE_NUMBERS) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>    this.sequenceNumber_ = typeof opt_sequenceNumber == &#39;number&#39; ?<tr><td><a id="l122"></a><a href="#l122">122</a><td>        opt_sequenceNumber : goog.debug.LogRecord.nextSequenceNumber_++;<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>  this.time_ = opt_time || goog.now();<tr><td><a id="l126"></a><a href="#l126">126</a><td>  this.level_ = level;<tr><td><a id="l127"></a><a href="#l127">127</a><td>  this.msg_ = msg;<tr><td><a id="l128"></a><a href="#l128">128</a><td>  this.loggerName_ = loggerName;<tr><td><a id="l129"></a><a href="#l129">129</a><td>  delete this.exception_;<tr><td><a id="l130"></a><a href="#l130">130</a><td>};<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/**<tr><td><a id="l134"></a><a href="#l134">134</a><td> * Get the source Logger&#39;s name.<tr><td><a id="l135"></a><a href="#l135">135</a><td> *<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @return {string} source logger name (may be null).<tr><td><a id="l137"></a><a href="#l137">137</a><td> */<tr><td><a id="l138"></a><a href="#l138">138</a><td>goog.debug.LogRecord.prototype.getLoggerName = function() {<tr><td><a id="l139"></a><a href="#l139">139</a><td>  return this.loggerName_;<tr><td><a id="l140"></a><a href="#l140">140</a><td>};<tr><td><a id="l141"></a><a href="#l141">141</a><td><tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>/**<tr><td><a id="l144"></a><a href="#l144">144</a><td> * Get the exception that is part of the log record.<tr><td><a id="l145"></a><a href="#l145">145</a><td> *<tr><td><a id="l146"></a><a href="#l146">146</a><td> * @return {Object} the exception.<tr><td><a id="l147"></a><a href="#l147">147</a><td> */<tr><td><a id="l148"></a><a href="#l148">148</a><td>goog.debug.LogRecord.prototype.getException = function() {<tr><td><a id="l149"></a><a href="#l149">149</a><td>  return this.exception_;<tr><td><a id="l150"></a><a href="#l150">150</a><td>};<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * Set the exception that is part of the log record.<tr><td><a id="l155"></a><a href="#l155">155</a><td> *<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @param {Object} exception the exception.<tr><td><a id="l157"></a><a href="#l157">157</a><td> */<tr><td><a id="l158"></a><a href="#l158">158</a><td>goog.debug.LogRecord.prototype.setException = function(exception) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>  this.exception_ = exception;<tr><td><a id="l160"></a><a href="#l160">160</a><td>};<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>/**<tr><td><a id="l164"></a><a href="#l164">164</a><td> * Get the source Logger&#39;s name.<tr><td><a id="l165"></a><a href="#l165">165</a><td> *<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {string} loggerName source logger name (may be null).<tr><td><a id="l167"></a><a href="#l167">167</a><td> */<tr><td><a id="l168"></a><a href="#l168">168</a><td>goog.debug.LogRecord.prototype.setLoggerName = function(loggerName) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>  this.loggerName_ = loggerName;<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>/**<tr><td><a id="l174"></a><a href="#l174">174</a><td> * Get the logging message level, for example Level.SEVERE.<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @return {goog.debug.Logger.Level} the logging message level.<tr><td><a id="l176"></a><a href="#l176">176</a><td> */<tr><td><a id="l177"></a><a href="#l177">177</a><td>goog.debug.LogRecord.prototype.getLevel = function() {<tr><td><a id="l178"></a><a href="#l178">178</a><td>  return this.level_;<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><tr><td><a id="l182"></a><a href="#l182">182</a><td>/**<tr><td><a id="l183"></a><a href="#l183">183</a><td> * Set the logging message level, for example Level.SEVERE.<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @param {goog.debug.Logger.Level} level the logging message level.<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.debug.LogRecord.prototype.setLevel = function(level) {<tr><td><a id="l187"></a><a href="#l187">187</a><td>  this.level_ = level;<tr><td><a id="l188"></a><a href="#l188">188</a><td>};<tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td>/**<tr><td><a id="l192"></a><a href="#l192">192</a><td> * Get the &quot;raw&quot; log message, before localization or formatting.<tr><td><a id="l193"></a><a href="#l193">193</a><td> *<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @return {string} the raw message string.<tr><td><a id="l195"></a><a href="#l195">195</a><td> */<tr><td><a id="l196"></a><a href="#l196">196</a><td>goog.debug.LogRecord.prototype.getMessage = function() {<tr><td><a id="l197"></a><a href="#l197">197</a><td>  return this.msg_;<tr><td><a id="l198"></a><a href="#l198">198</a><td>};<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> * Set the &quot;raw&quot; log message, before localization or formatting.<tr><td><a id="l203"></a><a href="#l203">203</a><td> *<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {string} msg the raw message string.<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.debug.LogRecord.prototype.setMessage = function(msg) {<tr><td><a id="l207"></a><a href="#l207">207</a><td>  this.msg_ = msg;<tr><td><a id="l208"></a><a href="#l208">208</a><td>};<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Get event time in milliseconds since 1970.<tr><td><a id="l213"></a><a href="#l213">213</a><td> *<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @return {number} event time in millis since 1970.<tr><td><a id="l215"></a><a href="#l215">215</a><td> */<tr><td><a id="l216"></a><a href="#l216">216</a><td>goog.debug.LogRecord.prototype.getMillis = function() {<tr><td><a id="l217"></a><a href="#l217">217</a><td>  return this.time_;<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><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Set event time in milliseconds since 1970.<tr><td><a id="l223"></a><a href="#l223">223</a><td> *<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @param {number} time event time in millis since 1970.<tr><td><a id="l225"></a><a href="#l225">225</a><td> */<tr><td><a id="l226"></a><a href="#l226">226</a><td>goog.debug.LogRecord.prototype.setMillis = function(time) {<tr><td><a id="l227"></a><a href="#l227">227</a><td>  this.time_ = time;<tr><td><a id="l228"></a><a href="#l228">228</a><td>};<tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>/**<tr><td><a id="l232"></a><a href="#l232">232</a><td> * Get the sequence number.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * &lt;p&gt;<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Sequence numbers are normally assigned in the LogRecord<tr><td><a id="l235"></a><a href="#l235">235</a><td> * constructor, which assigns unique sequence numbers to<tr><td><a id="l236"></a><a href="#l236">236</a><td> * each new LogRecord in increasing order.<tr><td><a id="l237"></a><a href="#l237">237</a><td> * @return {number} the sequence number.<tr><td><a id="l238"></a><a href="#l238">238</a><td> */<tr><td><a id="l239"></a><a href="#l239">239</a><td>goog.debug.LogRecord.prototype.getSequenceNumber = function() {<tr><td><a id="l240"></a><a href="#l240">240</a><td>  return this.sequenceNumber_;<tr><td><a id="l241"></a><a href="#l241">241</a><td>};<tr><td><a id="l242"></a><a href="#l242">242</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/deps.js.src.html b/docs/source/lib/goog/deps.js.src.html
index c3c1eac..9a40185 100644
--- a/docs/source/lib/goog/deps.js.src.html
+++ b/docs/source/lib/goog/deps.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>deps.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/deps.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// This file has been auto-generated; do not edit by hand<tr><td><a name="l2" href="#l2">2</a><td>goog.addDependency(&quot;../atoms/error.js&quot;, [&quot;bot.Error&quot;,&quot;bot.ErrorCode&quot;], []);<tr><td><a name="l3" href="#l3">3</a><td>goog.addDependency(&quot;../atoms/response.js&quot;, [&quot;bot.response&quot;,&quot;bot.response.ResponseObject&quot;], [&quot;bot.Error&quot;,&quot;bot.ErrorCode&quot;]);<tr><td><a name="l4" href="#l4">4</a><td>goog.addDependency(&quot;../atoms/json.js&quot;, [&quot;bot.json&quot;], [&quot;bot.userAgent&quot;,&quot;goog.json&quot;,&quot;goog.userAgent&quot;]);<tr><td><a name="l5" href="#l5">5</a><td>goog.addDependency(&quot;../atoms/userAgent.js&quot;, [&quot;bot.userAgent&quot;], [&quot;goog.string&quot;,&quot;goog.userAgent&quot;,&quot;goog.userAgent.product&quot;,&quot;goog.userAgent.product.isVersion&quot;]);<tr><td><a name="l6" href="#l6">6</a><td>goog.addDependency(&quot;string/string.js&quot;, [&quot;goog.string&quot;,&quot;goog.string.Unicode&quot;], []);<tr><td><a name="l7" href="#l7">7</a><td>goog.addDependency(&quot;useragent/useragent.js&quot;, [&quot;goog.userAgent&quot;], [&quot;goog.string&quot;]);<tr><td><a name="l8" href="#l8">8</a><td>goog.addDependency(&quot;useragent/product.js&quot;, [&quot;goog.userAgent.product&quot;], [&quot;goog.userAgent&quot;]);<tr><td><a name="l9" href="#l9">9</a><td>goog.addDependency(&quot;useragent/product_isversion.js&quot;, [&quot;goog.userAgent.product.isVersion&quot;], [&quot;goog.userAgent.product&quot;]);<tr><td><a name="l10" href="#l10">10</a><td>goog.addDependency(&quot;json/json.js&quot;, [&quot;goog.json&quot;,&quot;goog.json.Serializer&quot;], []);<tr><td><a name="l11" href="#l11">11</a><td>goog.addDependency(&quot;../webdriver/capabilities.js&quot;, [&quot;webdriver.Browser&quot;,&quot;webdriver.Capabilities&quot;,&quot;webdriver.Capability&quot;], []);<tr><td><a name="l12" href="#l12">12</a><td>goog.addDependency(&quot;../webdriver/logging.js&quot;, [&quot;webdriver.logging&quot;,&quot;webdriver.logging.Preferences&quot;], [&quot;goog.object&quot;]);<tr><td><a name="l13" href="#l13">13</a><td>goog.addDependency(&quot;object/object.js&quot;, [&quot;goog.object&quot;], []);<tr><td><a name="l14" href="#l14">14</a><td>goog.addDependency(&quot;../webdriver/actionsequence.js&quot;, [&quot;webdriver.ActionSequence&quot;], [&quot;goog.array&quot;,&quot;webdriver.Button&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.CommandName&quot;,&quot;webdriver.Key&quot;]);<tr><td><a name="l15" href="#l15">15</a><td>goog.addDependency(&quot;array/array.js&quot;, [&quot;goog.array&quot;,&quot;goog.array.ArrayLike&quot;], [&quot;goog.asserts&quot;]);<tr><td><a name="l16" href="#l16">16</a><td>goog.addDependency(&quot;asserts/asserts.js&quot;, [&quot;goog.asserts&quot;,&quot;goog.asserts.AssertionError&quot;], [&quot;goog.debug.Error&quot;,&quot;goog.string&quot;]);<tr><td><a name="l17" href="#l17">17</a><td>goog.addDependency(&quot;debug/error.js&quot;, [&quot;goog.debug.Error&quot;], []);<tr><td><a name="l18" href="#l18">18</a><td>goog.addDependency(&quot;../webdriver/button.js&quot;, [&quot;webdriver.Button&quot;], []);<tr><td><a name="l19" href="#l19">19</a><td>goog.addDependency(&quot;../webdriver/command.js&quot;, [&quot;webdriver.Command&quot;,&quot;webdriver.CommandExecutor&quot;,&quot;webdriver.CommandName&quot;], []);<tr><td><a name="l20" href="#l20">20</a><td>goog.addDependency(&quot;../webdriver/key.js&quot;, [&quot;webdriver.Key&quot;], []);<tr><td><a name="l21" href="#l21">21</a><td>goog.addDependency(&quot;../webdriver/stacktrace.js&quot;, [&quot;webdriver.stacktrace&quot;,&quot;webdriver.stacktrace.Snapshot&quot;], [&quot;goog.array&quot;,&quot;goog.string&quot;,&quot;goog.userAgent&quot;]);<tr><td><a name="l22" href="#l22">22</a><td>goog.addDependency(&quot;../webdriver/locators.js&quot;, [&quot;webdriver.By&quot;,&quot;webdriver.Locator&quot;,&quot;webdriver.Locator.Strategy&quot;], [&quot;goog.array&quot;,&quot;goog.object&quot;,&quot;goog.string&quot;]);<tr><td><a name="l23" href="#l23">23</a><td>goog.addDependency(&quot;../webdriver/promise.js&quot;, [&quot;webdriver.promise&quot;,&quot;webdriver.promise.ControlFlow&quot;,&quot;webdriver.promise.ControlFlow.Timer&quot;,&quot;webdriver.promise.Deferred&quot;,&quot;webdriver.promise.Promise&quot;], [&quot;goog.array&quot;,&quot;goog.debug.Error&quot;,&quot;goog.object&quot;,&quot;webdriver.EventEmitter&quot;,&quot;webdriver.stacktrace.Snapshot&quot;]);<tr><td><a name="l24" href="#l24">24</a><td>goog.addDependency(&quot;../webdriver/events.js&quot;, [&quot;webdriver.EventEmitter&quot;], []);<tr><td><a name="l25" href="#l25">25</a><td>goog.addDependency(&quot;../webdriver/process.js&quot;, [&quot;webdriver.process&quot;], [&quot;goog.Uri&quot;,&quot;goog.array&quot;,&quot;goog.json&quot;]);<tr><td><a name="l26" href="#l26">26</a><td>goog.addDependency(&quot;uri/uri.js&quot;, [&quot;goog.Uri&quot;,&quot;goog.Uri.QueryData&quot;], [&quot;goog.array&quot;,&quot;goog.string&quot;,&quot;goog.structs&quot;,&quot;goog.structs.Map&quot;,&quot;goog.uri.utils&quot;,&quot;goog.uri.utils.ComponentIndex&quot;,&quot;goog.uri.utils.StandardQueryParam&quot;]);<tr><td><a name="l27" href="#l27">27</a><td>goog.addDependency(&quot;structs/structs.js&quot;, [&quot;goog.structs&quot;], [&quot;goog.array&quot;,&quot;goog.object&quot;]);<tr><td><a name="l28" href="#l28">28</a><td>goog.addDependency(&quot;structs/map.js&quot;, [&quot;goog.structs.Map&quot;], [&quot;goog.iter.Iterator&quot;,&quot;goog.iter.StopIteration&quot;,&quot;goog.object&quot;]);<tr><td><a name="l29" href="#l29">29</a><td>goog.addDependency(&quot;iter/iter.js&quot;, [&quot;goog.iter&quot;,&quot;goog.iter.Iterator&quot;,&quot;goog.iter.StopIteration&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;]);<tr><td><a name="l30" href="#l30">30</a><td>goog.addDependency(&quot;uri/utils.js&quot;, [&quot;goog.uri.utils&quot;,&quot;goog.uri.utils.ComponentIndex&quot;,&quot;goog.uri.utils.QueryArray&quot;,&quot;goog.uri.utils.QueryValue&quot;,&quot;goog.uri.utils.StandardQueryParam&quot;], [&quot;goog.asserts&quot;,&quot;goog.string&quot;,&quot;goog.userAgent&quot;]);<tr><td><a name="l31" href="#l31">31</a><td>goog.addDependency(&quot;../webdriver/webdriver.js&quot;, [&quot;webdriver.Alert&quot;,&quot;webdriver.UnhandledAlertError&quot;,&quot;webdriver.WebDriver&quot;,&quot;webdriver.WebElement&quot;], [&quot;bot.Error&quot;,&quot;bot.ErrorCode&quot;,&quot;bot.response&quot;,&quot;goog.array&quot;,&quot;goog.object&quot;,&quot;webdriver.ActionSequence&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.CommandName&quot;,&quot;webdriver.Key&quot;,&quot;webdriver.Locator&quot;,&quot;webdriver.Session&quot;,&quot;webdriver.logging&quot;,&quot;webdriver.promise&quot;]);<tr><td><a name="l32" href="#l32">32</a><td>goog.addDependency(&quot;../webdriver/session.js&quot;, [&quot;webdriver.Session&quot;], [&quot;webdriver.Capabilities&quot;]);<tr><td><a name="l33" href="#l33">33</a><td>goog.addDependency(&quot;../webdriver/builder.js&quot;, [&quot;webdriver.Builder&quot;], [&quot;goog.userAgent&quot;,&quot;webdriver.AbstractBuilder&quot;,&quot;webdriver.FirefoxDomExecutor&quot;,&quot;webdriver.WebDriver&quot;,&quot;webdriver.http.CorsClient&quot;,&quot;webdriver.http.Executor&quot;,&quot;webdriver.http.XhrClient&quot;,&quot;webdriver.process&quot;]);<tr><td><a name="l34" href="#l34">34</a><td>goog.addDependency(&quot;../webdriver/abstractbuilder.js&quot;, [&quot;webdriver.AbstractBuilder&quot;], [&quot;webdriver.Capabilities&quot;,&quot;webdriver.process&quot;]);<tr><td><a name="l35" href="#l35">35</a><td>goog.addDependency(&quot;../webdriver/firefoxdomexecutor.js&quot;, [&quot;webdriver.FirefoxDomExecutor&quot;], [&quot;bot.response&quot;,&quot;goog.json&quot;,&quot;goog.userAgent.product&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.CommandName&quot;]);<tr><td><a name="l36" href="#l36">36</a><td>goog.addDependency(&quot;../webdriver/http/corsclient.js&quot;, [&quot;webdriver.http.CorsClient&quot;], [&quot;goog.json&quot;,&quot;webdriver.http.Response&quot;]);<tr><td><a name="l37" href="#l37">37</a><td>goog.addDependency(&quot;../webdriver/http/http.js&quot;, [&quot;webdriver.http.Client&quot;,&quot;webdriver.http.Executor&quot;,&quot;webdriver.http.Request&quot;,&quot;webdriver.http.Response&quot;], [&quot;bot.ErrorCode&quot;,&quot;goog.array&quot;,&quot;goog.json&quot;,&quot;webdriver.CommandName&quot;,&quot;webdriver.promise.Deferred&quot;]);<tr><td><a name="l38" href="#l38">38</a><td>goog.addDependency(&quot;../webdriver/http/xhrclient.js&quot;, [&quot;webdriver.http.XhrClient&quot;], [&quot;goog.json&quot;,&quot;goog.net.XmlHttp&quot;,&quot;webdriver.http.Response&quot;]);<tr><td><a name="l39" href="#l39">39</a><td>goog.addDependency(&quot;net/xmlhttp.js&quot;, [&quot;goog.net.DefaultXmlHttpFactory&quot;,&quot;goog.net.XmlHttp&quot;,&quot;goog.net.XmlHttp.OptionType&quot;,&quot;goog.net.XmlHttp.ReadyState&quot;], [&quot;goog.net.WrapperXmlHttpFactory&quot;,&quot;goog.net.XmlHttpFactory&quot;]);<tr><td><a name="l40" href="#l40">40</a><td>goog.addDependency(&quot;net/wrapperxmlhttpfactory.js&quot;, [&quot;goog.net.WrapperXmlHttpFactory&quot;], [&quot;goog.net.XmlHttpFactory&quot;]);<tr><td><a name="l41" href="#l41">41</a><td>goog.addDependency(&quot;net/xmlhttpfactory.js&quot;, [&quot;goog.net.XmlHttpFactory&quot;], []);<tr><td><a name="l42" href="#l42">42</a><td>goog.addDependency(&quot;../webdriver/testing/asserts.js&quot;, [&quot;webdriver.testing.Assertion&quot;,&quot;webdriver.testing.ContainsMatcher&quot;,&quot;webdriver.testing.NegatedAssertion&quot;,&quot;webdriver.testing.assert&quot;,&quot;webdriver.testing.asserts&quot;], [&quot;goog.array&quot;,&quot;goog.labs.testing.CloseToMatcher&quot;,&quot;goog.labs.testing.EndsWithMatcher&quot;,&quot;goog.labs.testing.EqualToMatcher&quot;,&quot;goog.labs.testing.EqualsMatcher&quot;,&quot;goog.labs.testing.GreaterThanEqualToMatcher&quot;,&quot;goog.labs.testing.GreaterThanMatcher&quot;,&quot;goog.labs.testing.LessThanEqualToMatcher&quot;,&quot;goog.labs.testing.LessThanMatcher&quot;,&quot;goog.labs.testing.InstanceOfMatcher&quot;,&quot;goog.labs.testing.IsNotMatcher&quot;,&quot;goog.labs.testing.IsNullMatcher&quot;,&quot;goog.labs.testing.IsNullOrUndefinedMatcher&quot;,&quot;goog.labs.testing.IsUndefinedMatcher&quot;,&quot;goog.labs.testing.Matcher&quot;,&quot;goog.labs.testing.ObjectEqualsMatcher&quot;,&quot;goog.labs.testing.RegexMatcher&quot;,&quot;goog.labs.testing.StartsWithMatcher&quot;,&quot;goog.labs.testing.assertThat&quot;,&quot;goog.string&quot;,&quot;webdriver.promise&quot;]);<tr><td><a name="l43" href="#l43">43</a><td>goog.addDependency(&quot;labs/testing/numbermatcher.js&quot;, [&quot;goog.labs.testing.CloseToMatcher&quot;,&quot;goog.labs.testing.EqualToMatcher&quot;,&quot;goog.labs.testing.GreaterThanEqualToMatcher&quot;,&quot;goog.labs.testing.GreaterThanMatcher&quot;,&quot;goog.labs.testing.LessThanEqualToMatcher&quot;,&quot;goog.labs.testing.LessThanMatcher&quot;], [&quot;goog.asserts&quot;,&quot;goog.labs.testing.Matcher&quot;]);<tr><td><a name="l44" href="#l44">44</a><td>goog.addDependency(&quot;labs/testing/matcher.js&quot;, [&quot;goog.labs.testing.Matcher&quot;], []);<tr><td><a name="l45" href="#l45">45</a><td>goog.addDependency(&quot;labs/testing/stringmatcher.js&quot;, [&quot;goog.labs.testing.ContainsStringMatcher&quot;,&quot;goog.labs.testing.EndsWithMatcher&quot;,&quot;goog.labs.testing.EqualToIgnoringCaseMatcher&quot;,&quot;goog.labs.testing.EqualToIgnoringWhitespaceMatcher&quot;,&quot;goog.labs.testing.EqualsMatcher&quot;,&quot;goog.labs.testing.RegexMatcher&quot;,&quot;goog.labs.testing.StartsWithMatcher&quot;,&quot;goog.labs.testing.StringContainsInOrderMatcher&quot;], [&quot;goog.asserts&quot;,&quot;goog.labs.testing.Matcher&quot;,&quot;goog.string&quot;]);<tr><td><a name="l46" href="#l46">46</a><td>goog.addDependency(&quot;labs/testing/objectmatcher.js&quot;, [&quot;goog.labs.testing.HasPropertyMatcher&quot;,&quot;goog.labs.testing.InstanceOfMatcher&quot;,&quot;goog.labs.testing.IsNullMatcher&quot;,&quot;goog.labs.testing.IsNullOrUndefinedMatcher&quot;,&quot;goog.labs.testing.IsUndefinedMatcher&quot;,&quot;goog.labs.testing.ObjectEqualsMatcher&quot;], [&quot;goog.labs.testing.Matcher&quot;,&quot;goog.string&quot;]);<tr><td><a name="l47" href="#l47">47</a><td>goog.addDependency(&quot;labs/testing/logicmatcher.js&quot;, [&quot;goog.labs.testing.AllOfMatcher&quot;,&quot;goog.labs.testing.AnyOfMatcher&quot;,&quot;goog.labs.testing.IsNotMatcher&quot;], [&quot;goog.array&quot;,&quot;goog.labs.testing.Matcher&quot;]);<tr><td><a name="l48" href="#l48">48</a><td>goog.addDependency(&quot;labs/testing/assertthat.js&quot;, [&quot;goog.labs.testing.MatcherError&quot;,&quot;goog.labs.testing.assertThat&quot;], [&quot;goog.asserts&quot;,&quot;goog.debug.Error&quot;,&quot;goog.labs.testing.Matcher&quot;]);</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>deps.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/deps.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// This file has been auto-generated; do not edit by hand<tr><td><a id="l2"></a><a href="#l2">2</a><td>goog.addDependency(&quot;../webdriver/test/builder_test.js&quot;, [], [&quot;goog.testing.jsunit&quot;,&quot;webdriver.Builder&quot;], false);<tr><td><a id="l3"></a><a href="#l3">3</a><td>goog.addDependency(&quot;testing/jsunit.js&quot;, [&quot;goog.testing.jsunit&quot;], [&quot;goog.dom.TagName&quot;,&quot;goog.testing.TestCase&quot;,&quot;goog.testing.TestRunner&quot;], false);<tr><td><a id="l4"></a><a href="#l4">4</a><td>goog.addDependency(&quot;dom/tagname.js&quot;, [&quot;goog.dom.TagName&quot;], [], false);<tr><td><a id="l5"></a><a href="#l5">5</a><td>goog.addDependency(&quot;testing/testcase.js&quot;, [&quot;goog.testing.TestCase&quot;,&quot;goog.testing.TestCase.Error&quot;,&quot;goog.testing.TestCase.Order&quot;,&quot;goog.testing.TestCase.Result&quot;,&quot;goog.testing.TestCase.Test&quot;], [&quot;goog.Promise&quot;,&quot;goog.Thenable&quot;,&quot;goog.asserts&quot;,&quot;goog.dom.TagName&quot;,&quot;goog.object&quot;,&quot;goog.testing.asserts&quot;,&quot;goog.testing.stacktrace&quot;], false);<tr><td><a id="l6"></a><a href="#l6">6</a><td>goog.addDependency(&quot;promise/promise.js&quot;, [&quot;goog.Promise&quot;], [&quot;goog.Thenable&quot;,&quot;goog.asserts&quot;,&quot;goog.async.FreeList&quot;,&quot;goog.async.run&quot;,&quot;goog.async.throwException&quot;,&quot;goog.debug.Error&quot;,&quot;goog.promise.Resolver&quot;], false);<tr><td><a id="l7"></a><a href="#l7">7</a><td>goog.addDependency(&quot;promise/thenable.js&quot;, [&quot;goog.Thenable&quot;], [], false);<tr><td><a id="l8"></a><a href="#l8">8</a><td>goog.addDependency(&quot;asserts/asserts.js&quot;, [&quot;goog.asserts&quot;,&quot;goog.asserts.AssertionError&quot;], [&quot;goog.debug.Error&quot;,&quot;goog.dom.NodeType&quot;,&quot;goog.string&quot;], false);<tr><td><a id="l9"></a><a href="#l9">9</a><td>goog.addDependency(&quot;debug/error.js&quot;, [&quot;goog.debug.Error&quot;], [], false);<tr><td><a id="l10"></a><a href="#l10">10</a><td>goog.addDependency(&quot;dom/nodetype.js&quot;, [&quot;goog.dom.NodeType&quot;], [], false);<tr><td><a id="l11"></a><a href="#l11">11</a><td>goog.addDependency(&quot;string/string.js&quot;, [&quot;goog.string&quot;,&quot;goog.string.Unicode&quot;], [], false);<tr><td><a id="l12"></a><a href="#l12">12</a><td>goog.addDependency(&quot;async/freelist.js&quot;, [&quot;goog.async.FreeList&quot;], [], false);<tr><td><a id="l13"></a><a href="#l13">13</a><td>goog.addDependency(&quot;async/run.js&quot;, [&quot;goog.async.run&quot;], [&quot;goog.async.WorkQueue&quot;,&quot;goog.async.nextTick&quot;,&quot;goog.async.throwException&quot;], false);<tr><td><a id="l14"></a><a href="#l14">14</a><td>goog.addDependency(&quot;async/workqueue.js&quot;, [&quot;goog.async.WorkItem&quot;,&quot;goog.async.WorkQueue&quot;], [&quot;goog.asserts&quot;,&quot;goog.async.FreeList&quot;], false);<tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.addDependency(&quot;async/nexttick.js&quot;, [&quot;goog.async.nextTick&quot;,&quot;goog.async.throwException&quot;], [&quot;goog.debug.entryPointRegistry&quot;,&quot;goog.dom.TagName&quot;,&quot;goog.functions&quot;,&quot;goog.labs.userAgent.browser&quot;,&quot;goog.labs.userAgent.engine&quot;], false);<tr><td><a id="l16"></a><a href="#l16">16</a><td>goog.addDependency(&quot;debug/entrypointregistry.js&quot;, [&quot;goog.debug.EntryPointMonitor&quot;,&quot;goog.debug.entryPointRegistry&quot;], [&quot;goog.asserts&quot;], false);<tr><td><a id="l17"></a><a href="#l17">17</a><td>goog.addDependency(&quot;functions/functions.js&quot;, [&quot;goog.functions&quot;], [], false);<tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.addDependency(&quot;labs/useragent/browser.js&quot;, [&quot;goog.labs.userAgent.browser&quot;], [&quot;goog.array&quot;,&quot;goog.labs.userAgent.util&quot;,&quot;goog.object&quot;,&quot;goog.string&quot;], false);<tr><td><a id="l19"></a><a href="#l19">19</a><td>goog.addDependency(&quot;array/array.js&quot;, [&quot;goog.array&quot;,&quot;goog.array.ArrayLike&quot;], [&quot;goog.asserts&quot;], false);<tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.addDependency(&quot;labs/useragent/util.js&quot;, [&quot;goog.labs.userAgent.util&quot;], [&quot;goog.string&quot;], false);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.addDependency(&quot;object/object.js&quot;, [&quot;goog.object&quot;], [], false);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.addDependency(&quot;labs/useragent/engine.js&quot;, [&quot;goog.labs.userAgent.engine&quot;], [&quot;goog.array&quot;,&quot;goog.labs.userAgent.util&quot;,&quot;goog.string&quot;], false);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.addDependency(&quot;promise/resolver.js&quot;, [&quot;goog.promise.Resolver&quot;], [], false);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.addDependency(&quot;testing/asserts.js&quot;, [&quot;goog.testing.JsUnitException&quot;,&quot;goog.testing.asserts&quot;,&quot;goog.testing.asserts.ArrayLike&quot;], [&quot;goog.testing.stacktrace&quot;], false);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.addDependency(&quot;testing/stacktrace.js&quot;, [&quot;goog.testing.stacktrace&quot;,&quot;goog.testing.stacktrace.Frame&quot;], [], false);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.addDependency(&quot;testing/testrunner.js&quot;, [&quot;goog.testing.TestRunner&quot;], [&quot;goog.dom.TagName&quot;,&quot;goog.testing.TestCase&quot;], false);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.addDependency(&quot;../webdriver/builder.js&quot;, [&quot;webdriver.Builder&quot;], [&quot;goog.Uri&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.Capabilities&quot;,&quot;webdriver.FirefoxDomExecutor&quot;,&quot;webdriver.WebDriver&quot;,&quot;webdriver.http.CorsClient&quot;,&quot;webdriver.http.Executor&quot;,&quot;webdriver.http.XhrClient&quot;], false);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.addDependency(&quot;uri/uri.js&quot;, [&quot;goog.Uri&quot;,&quot;goog.Uri.QueryData&quot;], [&quot;goog.array&quot;,&quot;goog.string&quot;,&quot;goog.structs&quot;,&quot;goog.structs.Map&quot;,&quot;goog.uri.utils&quot;,&quot;goog.uri.utils.ComponentIndex&quot;,&quot;goog.uri.utils.StandardQueryParam&quot;], false);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.addDependency(&quot;structs/structs.js&quot;, [&quot;goog.structs&quot;], [&quot;goog.array&quot;,&quot;goog.object&quot;], false);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.addDependency(&quot;structs/map.js&quot;, [&quot;goog.structs.Map&quot;], [&quot;goog.iter.Iterator&quot;,&quot;goog.iter.StopIteration&quot;,&quot;goog.object&quot;], false);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.addDependency(&quot;iter/iter.js&quot;, [&quot;goog.iter&quot;,&quot;goog.iter.Iterable&quot;,&quot;goog.iter.Iterator&quot;,&quot;goog.iter.StopIteration&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;,&quot;goog.functions&quot;,&quot;goog.math&quot;], false);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.addDependency(&quot;math/math.js&quot;, [&quot;goog.math&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;], false);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.addDependency(&quot;uri/utils.js&quot;, [&quot;goog.uri.utils&quot;,&quot;goog.uri.utils.ComponentIndex&quot;,&quot;goog.uri.utils.QueryArray&quot;,&quot;goog.uri.utils.QueryValue&quot;,&quot;goog.uri.utils.StandardQueryParam&quot;], [&quot;goog.asserts&quot;,&quot;goog.string&quot;], false);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.addDependency(&quot;useragent/useragent.js&quot;, [&quot;goog.userAgent&quot;], [&quot;goog.labs.userAgent.browser&quot;,&quot;goog.labs.userAgent.engine&quot;,&quot;goog.labs.userAgent.platform&quot;,&quot;goog.labs.userAgent.util&quot;,&quot;goog.string&quot;], false);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.addDependency(&quot;labs/useragent/platform.js&quot;, [&quot;goog.labs.userAgent.platform&quot;], [&quot;goog.labs.userAgent.util&quot;,&quot;goog.string&quot;], false);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.addDependency(&quot;../webdriver/capabilities.js&quot;, [&quot;webdriver.Browser&quot;,&quot;webdriver.Capabilities&quot;,&quot;webdriver.Capability&quot;,&quot;webdriver.ProxyConfig&quot;], [&quot;webdriver.Serializable&quot;,&quot;webdriver.logging&quot;], false);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.addDependency(&quot;../webdriver/serializable.js&quot;, [&quot;webdriver.Serializable&quot;], [], false);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.addDependency(&quot;../webdriver/logging.js&quot;, [&quot;webdriver.logging&quot;], [&quot;goog.debug.LogManager&quot;,&quot;goog.debug.LogRecord&quot;,&quot;goog.debug.Logger&quot;,&quot;goog.object&quot;], true);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.addDependency(&quot;debug/logger.js&quot;, [&quot;goog.debug.LogManager&quot;,&quot;goog.debug.Loggable&quot;,&quot;goog.debug.Logger&quot;,&quot;goog.debug.Logger.Level&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;,&quot;goog.debug&quot;,&quot;goog.debug.LogBuffer&quot;,&quot;goog.debug.LogRecord&quot;], false);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.addDependency(&quot;debug/debug.js&quot;, [&quot;goog.debug&quot;], [&quot;goog.array&quot;,&quot;goog.html.SafeHtml&quot;,&quot;goog.html.SafeUrl&quot;,&quot;goog.html.uncheckedconversions&quot;,&quot;goog.string.Const&quot;,&quot;goog.structs.Set&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.addDependency(&quot;html/safehtml.js&quot;, [&quot;goog.html.SafeHtml&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;,&quot;goog.dom.TagName&quot;,&quot;goog.dom.tags&quot;,&quot;goog.html.SafeStyle&quot;,&quot;goog.html.SafeStyleSheet&quot;,&quot;goog.html.SafeUrl&quot;,&quot;goog.html.TrustedResourceUrl&quot;,&quot;goog.i18n.bidi.Dir&quot;,&quot;goog.i18n.bidi.DirectionalString&quot;,&quot;goog.object&quot;,&quot;goog.string&quot;,&quot;goog.string.Const&quot;,&quot;goog.string.TypedString&quot;], false);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.addDependency(&quot;dom/tags.js&quot;, [&quot;goog.dom.tags&quot;], [&quot;goog.object&quot;], false);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.addDependency(&quot;html/safestyle.js&quot;, [&quot;goog.html.SafeStyle&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;,&quot;goog.string&quot;,&quot;goog.string.Const&quot;,&quot;goog.string.TypedString&quot;], false);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.addDependency(&quot;string/const.js&quot;, [&quot;goog.string.Const&quot;], [&quot;goog.asserts&quot;,&quot;goog.string.TypedString&quot;], false);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.addDependency(&quot;string/typedstring.js&quot;, [&quot;goog.string.TypedString&quot;], [], false);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.addDependency(&quot;html/safestylesheet.js&quot;, [&quot;goog.html.SafeStyleSheet&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;,&quot;goog.string&quot;,&quot;goog.string.Const&quot;,&quot;goog.string.TypedString&quot;], false);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.addDependency(&quot;html/safeurl.js&quot;, [&quot;goog.html.SafeUrl&quot;], [&quot;goog.asserts&quot;,&quot;goog.fs.url&quot;,&quot;goog.i18n.bidi.Dir&quot;,&quot;goog.i18n.bidi.DirectionalString&quot;,&quot;goog.string.Const&quot;,&quot;goog.string.TypedString&quot;], false);<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.addDependency(&quot;fs/url.js&quot;, [&quot;goog.fs.url&quot;], [], false);<tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.addDependency(&quot;i18n/bidi.js&quot;, [&quot;goog.i18n.bidi&quot;,&quot;goog.i18n.bidi.Dir&quot;,&quot;goog.i18n.bidi.DirectionalString&quot;,&quot;goog.i18n.bidi.Format&quot;], [], false);<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.addDependency(&quot;html/trustedresourceurl.js&quot;, [&quot;goog.html.TrustedResourceUrl&quot;], [&quot;goog.asserts&quot;,&quot;goog.i18n.bidi.Dir&quot;,&quot;goog.i18n.bidi.DirectionalString&quot;,&quot;goog.string.Const&quot;,&quot;goog.string.TypedString&quot;], false);<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.addDependency(&quot;html/uncheckedconversions.js&quot;, [&quot;goog.html.uncheckedconversions&quot;], [&quot;goog.asserts&quot;,&quot;goog.html.SafeHtml&quot;,&quot;goog.html.SafeScript&quot;,&quot;goog.html.SafeStyle&quot;,&quot;goog.html.SafeStyleSheet&quot;,&quot;goog.html.SafeUrl&quot;,&quot;goog.html.TrustedResourceUrl&quot;,&quot;goog.string&quot;,&quot;goog.string.Const&quot;], false);<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.addDependency(&quot;html/safescript.js&quot;, [&quot;goog.html.SafeScript&quot;], [&quot;goog.asserts&quot;,&quot;goog.string.Const&quot;,&quot;goog.string.TypedString&quot;], false);<tr><td><a id="l53"></a><a href="#l53">53</a><td>goog.addDependency(&quot;structs/set.js&quot;, [&quot;goog.structs.Set&quot;], [&quot;goog.structs&quot;,&quot;goog.structs.Collection&quot;,&quot;goog.structs.Map&quot;], false);<tr><td><a id="l54"></a><a href="#l54">54</a><td>goog.addDependency(&quot;structs/collection.js&quot;, [&quot;goog.structs.Collection&quot;], [], false);<tr><td><a id="l55"></a><a href="#l55">55</a><td>goog.addDependency(&quot;debug/logbuffer.js&quot;, [&quot;goog.debug.LogBuffer&quot;], [&quot;goog.asserts&quot;,&quot;goog.debug.LogRecord&quot;], false);<tr><td><a id="l56"></a><a href="#l56">56</a><td>goog.addDependency(&quot;debug/logrecord.js&quot;, [&quot;goog.debug.LogRecord&quot;], [], false);<tr><td><a id="l57"></a><a href="#l57">57</a><td>goog.addDependency(&quot;../webdriver/firefoxdomexecutor.js&quot;, [&quot;webdriver.FirefoxDomExecutor&quot;], [&quot;bot.response&quot;,&quot;goog.userAgent.product&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.CommandExecutor&quot;,&quot;webdriver.CommandName&quot;], false);<tr><td><a id="l58"></a><a href="#l58">58</a><td>goog.addDependency(&quot;../atoms/response.js&quot;, [&quot;bot.response&quot;,&quot;bot.response.ResponseObject&quot;], [&quot;bot.Error&quot;,&quot;bot.ErrorCode&quot;], false);<tr><td><a id="l59"></a><a href="#l59">59</a><td>goog.addDependency(&quot;../atoms/error.js&quot;, [&quot;bot.Error&quot;,&quot;bot.ErrorCode&quot;], [], false);<tr><td><a id="l60"></a><a href="#l60">60</a><td>goog.addDependency(&quot;useragent/product.js&quot;, [&quot;goog.userAgent.product&quot;], [&quot;goog.labs.userAgent.browser&quot;,&quot;goog.labs.userAgent.platform&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l61"></a><a href="#l61">61</a><td>goog.addDependency(&quot;../webdriver/command.js&quot;, [&quot;webdriver.Command&quot;,&quot;webdriver.CommandExecutor&quot;,&quot;webdriver.CommandName&quot;], [], false);<tr><td><a id="l62"></a><a href="#l62">62</a><td>goog.addDependency(&quot;../webdriver/webdriver.js&quot;, [&quot;webdriver.Alert&quot;,&quot;webdriver.AlertPromise&quot;,&quot;webdriver.FileDetector&quot;,&quot;webdriver.UnhandledAlertError&quot;,&quot;webdriver.WebDriver&quot;,&quot;webdriver.WebElement&quot;,&quot;webdriver.WebElementPromise&quot;], [&quot;bot.Error&quot;,&quot;bot.ErrorCode&quot;,&quot;bot.response&quot;,&quot;goog.array&quot;,&quot;goog.object&quot;,&quot;webdriver.ActionSequence&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.CommandName&quot;,&quot;webdriver.Key&quot;,&quot;webdriver.Locator&quot;,&quot;webdriver.Serializable&quot;,&quot;webdriver.Session&quot;,&quot;webdriver.TouchSequence&quot;,&quot;webdriver.logging&quot;,&quot;webdriver.promise&quot;,&quot;webdriver.until&quot;], false);<tr><td><a id="l63"></a><a href="#l63">63</a><td>goog.addDependency(&quot;../webdriver/actionsequence.js&quot;, [&quot;webdriver.ActionSequence&quot;], [&quot;goog.array&quot;,&quot;webdriver.Button&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.CommandName&quot;,&quot;webdriver.Key&quot;], false);<tr><td><a id="l64"></a><a href="#l64">64</a><td>goog.addDependency(&quot;../webdriver/button.js&quot;, [&quot;webdriver.Button&quot;], [], false);<tr><td><a id="l65"></a><a href="#l65">65</a><td>goog.addDependency(&quot;../webdriver/key.js&quot;, [&quot;webdriver.Key&quot;], [], false);<tr><td><a id="l66"></a><a href="#l66">66</a><td>goog.addDependency(&quot;../webdriver/locators.js&quot;, [&quot;webdriver.By&quot;,&quot;webdriver.Locator&quot;,&quot;webdriver.Locator.Strategy&quot;], [&quot;goog.array&quot;,&quot;goog.object&quot;,&quot;goog.string&quot;], false);<tr><td><a id="l67"></a><a href="#l67">67</a><td>goog.addDependency(&quot;../webdriver/session.js&quot;, [&quot;webdriver.Session&quot;], [&quot;webdriver.Capabilities&quot;], false);<tr><td><a id="l68"></a><a href="#l68">68</a><td>goog.addDependency(&quot;../webdriver/touchsequence.js&quot;, [&quot;webdriver.TouchSequence&quot;], [&quot;goog.array&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.CommandName&quot;], false);<tr><td><a id="l69"></a><a href="#l69">69</a><td>goog.addDependency(&quot;../webdriver/promise.js&quot;, [&quot;webdriver.promise&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;,&quot;goog.async.run&quot;,&quot;goog.async.throwException&quot;,&quot;goog.debug.Error&quot;,&quot;goog.log&quot;,&quot;goog.object&quot;,&quot;webdriver.EventEmitter&quot;,&quot;webdriver.stacktrace&quot;], true);<tr><td><a id="l70"></a><a href="#l70">70</a><td>goog.addDependency(&quot;log/log.js&quot;, [&quot;goog.log&quot;,&quot;goog.log.Level&quot;,&quot;goog.log.LogRecord&quot;,&quot;goog.log.Logger&quot;], [&quot;goog.debug&quot;,&quot;goog.debug.LogManager&quot;,&quot;goog.debug.LogRecord&quot;,&quot;goog.debug.Logger&quot;], false);<tr><td><a id="l71"></a><a href="#l71">71</a><td>goog.addDependency(&quot;../webdriver/events.js&quot;, [&quot;webdriver.EventEmitter&quot;], [], false);<tr><td><a id="l72"></a><a href="#l72">72</a><td>goog.addDependency(&quot;../webdriver/stacktrace.js&quot;, [&quot;webdriver.stacktrace&quot;,&quot;webdriver.stacktrace.Snapshot&quot;], [&quot;goog.array&quot;,&quot;goog.string&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.addDependency(&quot;../webdriver/until.js&quot;, [&quot;webdriver.until&quot;], [&quot;bot.ErrorCode&quot;,&quot;goog.array&quot;,&quot;goog.string&quot;,&quot;webdriver.Locator&quot;], false);<tr><td><a id="l74"></a><a href="#l74">74</a><td>goog.addDependency(&quot;../webdriver/http/corsclient.js&quot;, [&quot;webdriver.http.CorsClient&quot;], [&quot;webdriver.http.Client&quot;,&quot;webdriver.http.Response&quot;], false);<tr><td><a id="l75"></a><a href="#l75">75</a><td>goog.addDependency(&quot;../webdriver/http/http.js&quot;, [&quot;webdriver.http.Client&quot;,&quot;webdriver.http.Executor&quot;,&quot;webdriver.http.Request&quot;,&quot;webdriver.http.Response&quot;], [&quot;bot.ErrorCode&quot;,&quot;goog.array&quot;,&quot;webdriver.CommandExecutor&quot;,&quot;webdriver.CommandName&quot;,&quot;webdriver.logging&quot;,&quot;webdriver.promise&quot;], false);<tr><td><a id="l76"></a><a href="#l76">76</a><td>goog.addDependency(&quot;../webdriver/http/xhrclient.js&quot;, [&quot;webdriver.http.XhrClient&quot;], [&quot;goog.net.XmlHttp&quot;,&quot;webdriver.http.Client&quot;,&quot;webdriver.http.Response&quot;], false);<tr><td><a id="l77"></a><a href="#l77">77</a><td>goog.addDependency(&quot;net/xmlhttp.js&quot;, [&quot;goog.net.DefaultXmlHttpFactory&quot;,&quot;goog.net.XmlHttp&quot;,&quot;goog.net.XmlHttp.OptionType&quot;,&quot;goog.net.XmlHttp.ReadyState&quot;,&quot;goog.net.XmlHttpDefines&quot;], [&quot;goog.asserts&quot;,&quot;goog.net.WrapperXmlHttpFactory&quot;,&quot;goog.net.XmlHttpFactory&quot;], false);<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.addDependency(&quot;net/wrapperxmlhttpfactory.js&quot;, [&quot;goog.net.WrapperXmlHttpFactory&quot;], [&quot;goog.net.XhrLike&quot;,&quot;goog.net.XmlHttpFactory&quot;], false);<tr><td><a id="l79"></a><a href="#l79">79</a><td>goog.addDependency(&quot;net/xhrlike.js&quot;, [&quot;goog.net.XhrLike&quot;], [], false);<tr><td><a id="l80"></a><a href="#l80">80</a><td>goog.addDependency(&quot;net/xmlhttpfactory.js&quot;, [&quot;goog.net.XmlHttpFactory&quot;], [&quot;goog.net.XhrLike&quot;], false);<tr><td><a id="l81"></a><a href="#l81">81</a><td>goog.addDependency(&quot;../webdriver/test/capabilities_test.js&quot;, [], [&quot;goog.testing.jsunit&quot;,&quot;webdriver.Capabilities&quot;], false);<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.addDependency(&quot;../webdriver/test/events_test.js&quot;, [], [&quot;goog.testing.jsunit&quot;,&quot;webdriver.EventEmitter&quot;], false);<tr><td><a id="l83"></a><a href="#l83">83</a><td>goog.addDependency(&quot;../webdriver/test/locators_test.js&quot;, [], [&quot;goog.testing.jsunit&quot;,&quot;webdriver.By&quot;,&quot;webdriver.Locator&quot;,&quot;webdriver.Locator.Strategy&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l84"></a><a href="#l84">84</a><td>goog.addDependency(&quot;../webdriver/test/testutil.js&quot;, [&quot;webdriver.test.testutil&quot;,&quot;webdriver.test.testutil.StubError&quot;], [&quot;goog.array&quot;,&quot;goog.debug.Error&quot;,&quot;goog.string&quot;,&quot;goog.testing.recordFunction&quot;,&quot;webdriver.stacktrace&quot;], false);<tr><td><a id="l85"></a><a href="#l85">85</a><td>goog.addDependency(&quot;testing/recordfunction.js&quot;, [&quot;goog.testing.FunctionCall&quot;,&quot;goog.testing.recordConstructor&quot;,&quot;goog.testing.recordFunction&quot;], [&quot;goog.testing.asserts&quot;], false);<tr><td><a id="l86"></a><a href="#l86">86</a><td>goog.addDependency(&quot;../webdriver/test/logging_test.js&quot;, [], [&quot;goog.debug.LogRecord&quot;,&quot;goog.debug.Logger&quot;,&quot;goog.testing.jsunit&quot;,&quot;webdriver.logging&quot;], false);<tr><td><a id="l87"></a><a href="#l87">87</a><td>goog.addDependency(&quot;../webdriver/test/promise_error_test.js&quot;, [], [&quot;goog.Promise&quot;,&quot;goog.async.run&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;goog.userAgent.product&quot;,&quot;webdriver.promise&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l88"></a><a href="#l88">88</a><td>goog.addDependency(&quot;../webdriver/test/promise_flow_test.js&quot;, [], [&quot;goog.array&quot;,&quot;goog.string&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.promise&quot;,&quot;webdriver.stacktrace.Snapshot&quot;,&quot;webdriver.stacktrace&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l89"></a><a href="#l89">89</a><td>goog.addDependency(&quot;../webdriver/test/promise_test.js&quot;, [], [&quot;goog.testing.MockClock&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.promise&quot;,&quot;webdriver.stacktrace&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l90"></a><a href="#l90">90</a><td>goog.addDependency(&quot;testing/mockclock.js&quot;, [&quot;goog.testing.MockClock&quot;], [&quot;goog.Disposable&quot;,&quot;goog.async.run&quot;,&quot;goog.testing.PropertyReplacer&quot;,&quot;goog.testing.events&quot;,&quot;goog.testing.events.Event&quot;], false);<tr><td><a id="l91"></a><a href="#l91">91</a><td>goog.addDependency(&quot;disposable/disposable.js&quot;, [&quot;goog.Disposable&quot;,&quot;goog.dispose&quot;,&quot;goog.disposeAll&quot;], [&quot;goog.disposable.IDisposable&quot;], false);<tr><td><a id="l92"></a><a href="#l92">92</a><td>goog.addDependency(&quot;disposable/idisposable.js&quot;, [&quot;goog.disposable.IDisposable&quot;], [], false);<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.addDependency(&quot;testing/propertyreplacer.js&quot;, [&quot;goog.testing.PropertyReplacer&quot;], [&quot;goog.testing.ObjectPropertyString&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l94"></a><a href="#l94">94</a><td>goog.addDependency(&quot;testing/objectpropertystring.js&quot;, [&quot;goog.testing.ObjectPropertyString&quot;], [], false);<tr><td><a id="l95"></a><a href="#l95">95</a><td>goog.addDependency(&quot;testing/events/events.js&quot;, [&quot;goog.testing.events&quot;,&quot;goog.testing.events.Event&quot;], [&quot;goog.Disposable&quot;,&quot;goog.asserts&quot;,&quot;goog.dom.NodeType&quot;,&quot;goog.events&quot;,&quot;goog.events.BrowserEvent&quot;,&quot;goog.events.BrowserFeature&quot;,&quot;goog.events.EventTarget&quot;,&quot;goog.events.EventType&quot;,&quot;goog.events.KeyCodes&quot;,&quot;goog.object&quot;,&quot;goog.style&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l96"></a><a href="#l96">96</a><td>goog.addDependency(&quot;events/events.js&quot;, [&quot;goog.events&quot;,&quot;goog.events.CaptureSimulationMode&quot;,&quot;goog.events.Key&quot;,&quot;goog.events.ListenableType&quot;], [&quot;goog.asserts&quot;,&quot;goog.debug.entryPointRegistry&quot;,&quot;goog.events.BrowserEvent&quot;,&quot;goog.events.BrowserFeature&quot;,&quot;goog.events.Listenable&quot;,&quot;goog.events.ListenerMap&quot;], false);<tr><td><a id="l97"></a><a href="#l97">97</a><td>goog.addDependency(&quot;events/browserevent.js&quot;, [&quot;goog.events.BrowserEvent&quot;,&quot;goog.events.BrowserEvent.MouseButton&quot;], [&quot;goog.events.BrowserFeature&quot;,&quot;goog.events.Event&quot;,&quot;goog.events.EventType&quot;,&quot;goog.reflect&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.addDependency(&quot;events/browserfeature.js&quot;, [&quot;goog.events.BrowserFeature&quot;], [&quot;goog.userAgent&quot;], false);<tr><td><a id="l99"></a><a href="#l99">99</a><td>goog.addDependency(&quot;events/event.js&quot;, [&quot;goog.events.Event&quot;,&quot;goog.events.EventLike&quot;], [&quot;goog.Disposable&quot;,&quot;goog.events.EventId&quot;], false);<tr><td><a id="l100"></a><a href="#l100">100</a><td>goog.addDependency(&quot;events/eventid.js&quot;, [&quot;goog.events.EventId&quot;], [], false);<tr><td><a id="l101"></a><a href="#l101">101</a><td>goog.addDependency(&quot;events/eventtype.js&quot;, [&quot;goog.events.EventType&quot;], [&quot;goog.userAgent&quot;], false);<tr><td><a id="l102"></a><a href="#l102">102</a><td>goog.addDependency(&quot;reflect/reflect.js&quot;, [&quot;goog.reflect&quot;], [], false);<tr><td><a id="l103"></a><a href="#l103">103</a><td>goog.addDependency(&quot;events/listenable.js&quot;, [&quot;goog.events.Listenable&quot;,&quot;goog.events.ListenableKey&quot;], [&quot;goog.events.EventId&quot;], false);<tr><td><a id="l104"></a><a href="#l104">104</a><td>goog.addDependency(&quot;events/listenermap.js&quot;, [&quot;goog.events.ListenerMap&quot;], [&quot;goog.array&quot;,&quot;goog.events.Listener&quot;,&quot;goog.object&quot;], false);<tr><td><a id="l105"></a><a href="#l105">105</a><td>goog.addDependency(&quot;events/listener.js&quot;, [&quot;goog.events.Listener&quot;], [&quot;goog.events.ListenableKey&quot;], false);<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.addDependency(&quot;events/eventtarget.js&quot;, [&quot;goog.events.EventTarget&quot;], [&quot;goog.Disposable&quot;,&quot;goog.asserts&quot;,&quot;goog.events&quot;,&quot;goog.events.Event&quot;,&quot;goog.events.Listenable&quot;,&quot;goog.events.ListenerMap&quot;,&quot;goog.object&quot;], false);<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.addDependency(&quot;events/keycodes.js&quot;, [&quot;goog.events.KeyCodes&quot;], [&quot;goog.userAgent&quot;], false);<tr><td><a id="l108"></a><a href="#l108">108</a><td>goog.addDependency(&quot;style/style.js&quot;, [&quot;goog.style&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;,&quot;goog.dom&quot;,&quot;goog.dom.NodeType&quot;,&quot;goog.dom.TagName&quot;,&quot;goog.dom.vendor&quot;,&quot;goog.math.Box&quot;,&quot;goog.math.Coordinate&quot;,&quot;goog.math.Rect&quot;,&quot;goog.math.Size&quot;,&quot;goog.object&quot;,&quot;goog.string&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l109"></a><a href="#l109">109</a><td>goog.addDependency(&quot;dom/dom.js&quot;, [&quot;goog.dom&quot;,&quot;goog.dom.Appendable&quot;,&quot;goog.dom.DomHelper&quot;], [&quot;goog.array&quot;,&quot;goog.asserts&quot;,&quot;goog.dom.BrowserFeature&quot;,&quot;goog.dom.NodeType&quot;,&quot;goog.dom.TagName&quot;,&quot;goog.dom.safe&quot;,&quot;goog.html.SafeHtml&quot;,&quot;goog.math.Coordinate&quot;,&quot;goog.math.Size&quot;,&quot;goog.object&quot;,&quot;goog.string&quot;,&quot;goog.string.Unicode&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.addDependency(&quot;dom/browserfeature.js&quot;, [&quot;goog.dom.BrowserFeature&quot;], [&quot;goog.userAgent&quot;], false);<tr><td><a id="l111"></a><a href="#l111">111</a><td>goog.addDependency(&quot;dom/safe.js&quot;, [&quot;goog.dom.safe&quot;,&quot;goog.dom.safe.InsertAdjacentHtmlPosition&quot;], [&quot;goog.asserts&quot;,&quot;goog.html.SafeHtml&quot;,&quot;goog.html.SafeUrl&quot;,&quot;goog.html.TrustedResourceUrl&quot;,&quot;goog.string&quot;,&quot;goog.string.Const&quot;], false);<tr><td><a id="l112"></a><a href="#l112">112</a><td>goog.addDependency(&quot;math/coordinate.js&quot;, [&quot;goog.math.Coordinate&quot;], [&quot;goog.math&quot;], false);<tr><td><a id="l113"></a><a href="#l113">113</a><td>goog.addDependency(&quot;math/size.js&quot;, [&quot;goog.math.Size&quot;], [], false);<tr><td><a id="l114"></a><a href="#l114">114</a><td>goog.addDependency(&quot;dom/vendor.js&quot;, [&quot;goog.dom.vendor&quot;], [&quot;goog.string&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l115"></a><a href="#l115">115</a><td>goog.addDependency(&quot;math/box.js&quot;, [&quot;goog.math.Box&quot;], [&quot;goog.math.Coordinate&quot;], false);<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.addDependency(&quot;math/rect.js&quot;, [&quot;goog.math.Rect&quot;], [&quot;goog.math.Box&quot;,&quot;goog.math.Coordinate&quot;,&quot;goog.math.Size&quot;], false);<tr><td><a id="l117"></a><a href="#l117">117</a><td>goog.addDependency(&quot;../webdriver/test/stacktrace_test.js&quot;, [], [&quot;bot.Error&quot;,&quot;bot.ErrorCode&quot;,&quot;goog.string&quot;,&quot;goog.testing.JsUnitException&quot;,&quot;goog.testing.PropertyReplacer&quot;,&quot;goog.testing.StrictMock&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.testing.stacktrace&quot;,&quot;webdriver.stacktrace&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.addDependency(&quot;testing/strictmock.js&quot;, [&quot;goog.testing.StrictMock&quot;], [&quot;goog.array&quot;,&quot;goog.testing.Mock&quot;], false);<tr><td><a id="l119"></a><a href="#l119">119</a><td>goog.addDependency(&quot;testing/mock.js&quot;, [&quot;goog.testing.Mock&quot;,&quot;goog.testing.MockExpectation&quot;], [&quot;goog.array&quot;,&quot;goog.object&quot;,&quot;goog.testing.JsUnitException&quot;,&quot;goog.testing.MockInterface&quot;,&quot;goog.testing.mockmatchers&quot;], false);<tr><td><a id="l120"></a><a href="#l120">120</a><td>goog.addDependency(&quot;testing/mockinterface.js&quot;, [&quot;goog.testing.MockInterface&quot;], [], false);<tr><td><a id="l121"></a><a href="#l121">121</a><td>goog.addDependency(&quot;testing/mockmatchers.js&quot;, [&quot;goog.testing.mockmatchers&quot;,&quot;goog.testing.mockmatchers.ArgumentMatcher&quot;,&quot;goog.testing.mockmatchers.IgnoreArgument&quot;,&quot;goog.testing.mockmatchers.InstanceOf&quot;,&quot;goog.testing.mockmatchers.ObjectEquals&quot;,&quot;goog.testing.mockmatchers.RegexpMatch&quot;,&quot;goog.testing.mockmatchers.SaveArgument&quot;,&quot;goog.testing.mockmatchers.TypeOf&quot;], [&quot;goog.array&quot;,&quot;goog.dom&quot;,&quot;goog.testing.asserts&quot;], false);<tr><td><a id="l122"></a><a href="#l122">122</a><td>goog.addDependency(&quot;../webdriver/test/test_bootstrap.js&quot;, [], [], false);<tr><td><a id="l123"></a><a href="#l123">123</a><td>goog.addDependency(&quot;../webdriver/test/testutil_test.js&quot;, [], [&quot;goog.testing.jsunit&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l124"></a><a href="#l124">124</a><td>goog.addDependency(&quot;../webdriver/test/webdriver_test.js&quot;, [], [&quot;bot.ErrorCode&quot;,&quot;goog.Promise&quot;,&quot;goog.functions&quot;,&quot;goog.testing.PropertyReplacer&quot;,&quot;goog.testing.MockControl&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.Capabilities&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.CommandExecutor&quot;,&quot;webdriver.CommandName&quot;,&quot;webdriver.FileDetector&quot;,&quot;webdriver.WebDriver&quot;,&quot;webdriver.Serializable&quot;,&quot;webdriver.Session&quot;,&quot;webdriver.logging&quot;,&quot;webdriver.promise&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l125"></a><a href="#l125">125</a><td>goog.addDependency(&quot;testing/mockcontrol.js&quot;, [&quot;goog.testing.MockControl&quot;], [&quot;goog.array&quot;,&quot;goog.testing&quot;,&quot;goog.testing.LooseMock&quot;,&quot;goog.testing.StrictMock&quot;], false);<tr><td><a id="l126"></a><a href="#l126">126</a><td>goog.addDependency(&quot;testing/functionmock.js&quot;, [&quot;goog.testing&quot;,&quot;goog.testing.FunctionMock&quot;,&quot;goog.testing.GlobalFunctionMock&quot;,&quot;goog.testing.MethodMock&quot;], [&quot;goog.object&quot;,&quot;goog.testing.LooseMock&quot;,&quot;goog.testing.Mock&quot;,&quot;goog.testing.PropertyReplacer&quot;,&quot;goog.testing.StrictMock&quot;], false);<tr><td><a id="l127"></a><a href="#l127">127</a><td>goog.addDependency(&quot;testing/loosemock.js&quot;, [&quot;goog.testing.LooseExpectationCollection&quot;,&quot;goog.testing.LooseMock&quot;], [&quot;goog.array&quot;,&quot;goog.structs.Map&quot;,&quot;goog.testing.Mock&quot;], false);<tr><td><a id="l128"></a><a href="#l128">128</a><td>goog.addDependency(&quot;../webdriver/test/http/corsclient_test.js&quot;, [], [&quot;goog.testing.MockControl&quot;,&quot;goog.testing.PropertyReplacer&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.http.CorsClient&quot;,&quot;webdriver.http.Request&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l129"></a><a href="#l129">129</a><td>goog.addDependency(&quot;../webdriver/test/http/http_test.js&quot;, [], [&quot;bot.ErrorCode&quot;,&quot;goog.Uri&quot;,&quot;goog.testing.MockControl&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.Command&quot;,&quot;webdriver.http.Client&quot;,&quot;webdriver.http.Executor&quot;,&quot;webdriver.promise&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l130"></a><a href="#l130">130</a><td>goog.addDependency(&quot;../webdriver/test/http/xhrclient_test.js&quot;, [], [&quot;goog.testing.MockControl&quot;,&quot;goog.testing.PropertyReplacer&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.http.Request&quot;,&quot;webdriver.http.XhrClient&quot;,&quot;webdriver.promise&quot;,&quot;webdriver.test.testutil&quot;], false);<tr><td><a id="l131"></a><a href="#l131">131</a><td>goog.addDependency(&quot;../webdriver/test/testing/asserts_test.js&quot;, [], [&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.test.testutil&quot;,&quot;webdriver.testing.assert&quot;,&quot;webdriver.testing.asserts&quot;], false);<tr><td><a id="l132"></a><a href="#l132">132</a><td>goog.addDependency(&quot;../webdriver/testing/asserts.js&quot;, [&quot;webdriver.testing.Assertion&quot;,&quot;webdriver.testing.ContainsMatcher&quot;,&quot;webdriver.testing.NegatedAssertion&quot;,&quot;webdriver.testing.assert&quot;,&quot;webdriver.testing.asserts&quot;], [&quot;goog.array&quot;,&quot;goog.labs.testing.CloseToMatcher&quot;,&quot;goog.labs.testing.EndsWithMatcher&quot;,&quot;goog.labs.testing.EqualToMatcher&quot;,&quot;goog.labs.testing.EqualsMatcher&quot;,&quot;goog.labs.testing.GreaterThanEqualToMatcher&quot;,&quot;goog.labs.testing.GreaterThanMatcher&quot;,&quot;goog.labs.testing.LessThanEqualToMatcher&quot;,&quot;goog.labs.testing.LessThanMatcher&quot;,&quot;goog.labs.testing.InstanceOfMatcher&quot;,&quot;goog.labs.testing.IsNotMatcher&quot;,&quot;goog.labs.testing.IsNullMatcher&quot;,&quot;goog.labs.testing.IsNullOrUndefinedMatcher&quot;,&quot;goog.labs.testing.IsUndefinedMatcher&quot;,&quot;goog.labs.testing.Matcher&quot;,&quot;goog.labs.testing.ObjectEqualsMatcher&quot;,&quot;goog.labs.testing.RegexMatcher&quot;,&quot;goog.labs.testing.StartsWithMatcher&quot;,&quot;goog.labs.testing.assertThat&quot;,&quot;goog.string&quot;,&quot;webdriver.promise&quot;], false);<tr><td><a id="l133"></a><a href="#l133">133</a><td>goog.addDependency(&quot;labs/testing/numbermatcher.js&quot;, [&quot;goog.labs.testing.CloseToMatcher&quot;,&quot;goog.labs.testing.EqualToMatcher&quot;,&quot;goog.labs.testing.GreaterThanEqualToMatcher&quot;,&quot;goog.labs.testing.GreaterThanMatcher&quot;,&quot;goog.labs.testing.LessThanEqualToMatcher&quot;,&quot;goog.labs.testing.LessThanMatcher&quot;], [&quot;goog.asserts&quot;,&quot;goog.labs.testing.Matcher&quot;], false);<tr><td><a id="l134"></a><a href="#l134">134</a><td>goog.addDependency(&quot;labs/testing/matcher.js&quot;, [&quot;goog.labs.testing.Matcher&quot;], [], false);<tr><td><a id="l135"></a><a href="#l135">135</a><td>goog.addDependency(&quot;labs/testing/stringmatcher.js&quot;, [&quot;goog.labs.testing.ContainsStringMatcher&quot;,&quot;goog.labs.testing.EndsWithMatcher&quot;,&quot;goog.labs.testing.EqualToIgnoringWhitespaceMatcher&quot;,&quot;goog.labs.testing.EqualsMatcher&quot;,&quot;goog.labs.testing.RegexMatcher&quot;,&quot;goog.labs.testing.StartsWithMatcher&quot;,&quot;goog.labs.testing.StringContainsInOrderMatcher&quot;], [&quot;goog.asserts&quot;,&quot;goog.labs.testing.Matcher&quot;,&quot;goog.string&quot;], false);<tr><td><a id="l136"></a><a href="#l136">136</a><td>goog.addDependency(&quot;labs/testing/objectmatcher.js&quot;, [&quot;goog.labs.testing.HasPropertyMatcher&quot;,&quot;goog.labs.testing.InstanceOfMatcher&quot;,&quot;goog.labs.testing.IsNullMatcher&quot;,&quot;goog.labs.testing.IsNullOrUndefinedMatcher&quot;,&quot;goog.labs.testing.IsUndefinedMatcher&quot;,&quot;goog.labs.testing.ObjectEqualsMatcher&quot;], [&quot;goog.labs.testing.Matcher&quot;], false);<tr><td><a id="l137"></a><a href="#l137">137</a><td>goog.addDependency(&quot;labs/testing/logicmatcher.js&quot;, [&quot;goog.labs.testing.AllOfMatcher&quot;,&quot;goog.labs.testing.AnyOfMatcher&quot;,&quot;goog.labs.testing.IsNotMatcher&quot;], [&quot;goog.array&quot;,&quot;goog.labs.testing.Matcher&quot;], false);<tr><td><a id="l138"></a><a href="#l138">138</a><td>goog.addDependency(&quot;labs/testing/assertthat.js&quot;, [&quot;goog.labs.testing.MatcherError&quot;,&quot;goog.labs.testing.assertThat&quot;], [&quot;goog.debug.Error&quot;], false);<tr><td><a id="l139"></a><a href="#l139">139</a><td>goog.addDependency(&quot;../webdriver/test/testing/client_test.js&quot;, [], [&quot;goog.testing.MockControl&quot;,&quot;goog.testing.PropertyReplacer&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.testing.Client&quot;], false);<tr><td><a id="l140"></a><a href="#l140">140</a><td>goog.addDependency(&quot;../webdriver/testing/client.js&quot;, [&quot;webdriver.testing.Client&quot;], [&quot;goog.json&quot;,&quot;goog.net.XmlHttp&quot;], false);<tr><td><a id="l141"></a><a href="#l141">141</a><td>goog.addDependency(&quot;json/json.js&quot;, [&quot;goog.json&quot;,&quot;goog.json.Replacer&quot;,&quot;goog.json.Reviver&quot;,&quot;goog.json.Serializer&quot;], [], false);<tr><td><a id="l142"></a><a href="#l142">142</a><td>goog.addDependency(&quot;../webdriver/test/testing/testcase_test.js&quot;, [], [&quot;goog.Promise&quot;,&quot;goog.testing.MockControl&quot;,&quot;goog.testing.PropertyReplacer&quot;,&quot;goog.testing.mockmatchers&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.testing.recordFunction&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.test.testutil&quot;,&quot;webdriver.testing.TestCase&quot;], false);<tr><td><a id="l143"></a><a href="#l143">143</a><td>goog.addDependency(&quot;../webdriver/testing/testcase.js&quot;, [&quot;webdriver.testing.TestCase&quot;], [&quot;goog.testing.TestCase&quot;,&quot;webdriver.promise&quot;,&quot;webdriver.testing.asserts&quot;], false);<tr><td><a id="l144"></a><a href="#l144">144</a><td>goog.addDependency(&quot;../atoms/json.js&quot;, [&quot;bot.json&quot;], [&quot;bot.userAgent&quot;,&quot;goog.json&quot;,&quot;goog.userAgent&quot;], false);<tr><td><a id="l145"></a><a href="#l145">145</a><td>goog.addDependency(&quot;../atoms/userAgent.js&quot;, [&quot;bot.userAgent&quot;], [&quot;goog.string&quot;,&quot;goog.userAgent&quot;,&quot;goog.userAgent.product&quot;,&quot;goog.userAgent.product.isVersion&quot;], false);<tr><td><a id="l146"></a><a href="#l146">146</a><td>goog.addDependency(&quot;useragent/product_isversion.js&quot;, [&quot;goog.userAgent.product.isVersion&quot;], [&quot;goog.labs.userAgent.platform&quot;,&quot;goog.string&quot;,&quot;goog.userAgent&quot;,&quot;goog.userAgent.product&quot;], false);<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.addDependency(&quot;../webdriver/testing/jsunit.js&quot;, [&quot;webdriver.testing.jsunit&quot;,&quot;webdriver.testing.jsunit.TestRunner&quot;], [&quot;goog.testing.TestRunner&quot;,&quot;webdriver.testing.Client&quot;,&quot;webdriver.testing.TestCase&quot;], false);<tr><td><a id="l148"></a><a href="#l148">148</a><td>goog.addDependency(&quot;../webdriver/testing/window.js&quot;, [&quot;webdriver.testing.Window&quot;], [&quot;goog.string&quot;,&quot;webdriver.promise&quot;], false);<tr><td><a id="l149"></a><a href="#l149">149</a><td>goog.addDependency(&quot;../webdriver/test/promise_generator_test.js&quot;, [&quot;webdriver.test.promise.generator.test&quot;], [&quot;goog.testing.jsunit&quot;,&quot;webdriver.promise&quot;], false);<tr><td><a id="l150"></a><a href="#l150">150</a><td>goog.addDependency(&quot;../webdriver/test/until_test.js&quot;, [&quot;webdriver.test.until_test&quot;], [&quot;bot.Error&quot;,&quot;bot.ErrorCode&quot;,&quot;bot.response&quot;,&quot;goog.array&quot;,&quot;goog.string&quot;,&quot;goog.testing.jsunit&quot;,&quot;goog.userAgent&quot;,&quot;webdriver.By&quot;,&quot;webdriver.CommandName&quot;,&quot;webdriver.WebDriver&quot;,&quot;webdriver.WebElement&quot;,&quot;webdriver.WebElementPromise&quot;,&quot;webdriver.until&quot;], false);<tr><td><a id="l151"></a><a href="#l151">151</a><td>goog.addDependency(&quot;../webdriver/test/webdriver_generator_test.js&quot;, [&quot;webdriver.test.WebDriver.generator.test&quot;], [&quot;goog.testing.jsunit&quot;,&quot;webdriver.Session&quot;,&quot;webdriver.WebDriver&quot;], false);</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/disposable/disposable.js.src.html b/docs/source/lib/goog/disposable/disposable.js.src.html
new file mode 100644
index 0000000..60129c2
--- /dev/null
+++ b/docs/source/lib/goog/disposable/disposable.js.src.html
@@ -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>disposable.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/disposable/disposable.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2005 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Implements the disposable interface. The dispose method is used<tr><td><a id="l17"></a><a href="#l17">17</a><td> * to clean up references and resources.<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.Disposable&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>/** @suppress {extraProvide} */<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.dispose&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>/** @suppress {extraProvide} */<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.disposeAll&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.disposable.IDisposable&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Class that provides the basic implementation for disposable objects. If your<tr><td><a id="l34"></a><a href="#l34">34</a><td> * class holds one or more references to COM objects, DOM nodes, or other<tr><td><a id="l35"></a><a href="#l35">35</a><td> * disposable objects, it should extend this class or implement the disposable<tr><td><a id="l36"></a><a href="#l36">36</a><td> * interface (defined in goog.disposable.IDisposable).<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @constructor<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @implements {goog.disposable.IDisposable}<tr><td><a id="l39"></a><a href="#l39">39</a><td> */<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.Disposable = function() {<tr><td><a id="l41"></a><a href="#l41">41</a><td>  if (goog.Disposable.MONITORING_MODE != goog.Disposable.MonitoringMode.OFF) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>    if (goog.Disposable.INCLUDE_STACK_ON_CREATION) {<tr><td><a id="l43"></a><a href="#l43">43</a><td>      this.creationStack = new Error().stack;<tr><td><a id="l44"></a><a href="#l44">44</a><td>    }<tr><td><a id="l45"></a><a href="#l45">45</a><td>    goog.Disposable.instances_[goog.getUid(this)] = this;<tr><td><a id="l46"></a><a href="#l46">46</a><td>  }<tr><td><a id="l47"></a><a href="#l47">47</a><td>  // Support sealing<tr><td><a id="l48"></a><a href="#l48">48</a><td>  this.disposed_ = this.disposed_;<tr><td><a id="l49"></a><a href="#l49">49</a><td>  this.onDisposeCallbacks_ = this.onDisposeCallbacks_;<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><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @enum {number} Different monitoring modes for Disposable.<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.Disposable.MonitoringMode = {<tr><td><a id="l57"></a><a href="#l57">57</a><td>  /**<tr><td><a id="l58"></a><a href="#l58">58</a><td>   * No monitoring.<tr><td><a id="l59"></a><a href="#l59">59</a><td>   */<tr><td><a id="l60"></a><a href="#l60">60</a><td>  OFF: 0,<tr><td><a id="l61"></a><a href="#l61">61</a><td>  /**<tr><td><a id="l62"></a><a href="#l62">62</a><td>   * Creating and disposing the goog.Disposable instances is monitored. All<tr><td><a id="l63"></a><a href="#l63">63</a><td>   * disposable objects need to call the {@code goog.Disposable} base<tr><td><a id="l64"></a><a href="#l64">64</a><td>   * constructor. The PERMANENT mode must be switched on before creating any<tr><td><a id="l65"></a><a href="#l65">65</a><td>   * goog.Disposable instances.<tr><td><a id="l66"></a><a href="#l66">66</a><td>   */<tr><td><a id="l67"></a><a href="#l67">67</a><td>  PERMANENT: 1,<tr><td><a id="l68"></a><a href="#l68">68</a><td>  /**<tr><td><a id="l69"></a><a href="#l69">69</a><td>   * INTERACTIVE mode can be switched on and off on the fly without producing<tr><td><a id="l70"></a><a href="#l70">70</a><td>   * errors. It also doesn&#39;t warn if the disposable objects don&#39;t call the<tr><td><a id="l71"></a><a href="#l71">71</a><td>   * {@code goog.Disposable} base constructor.<tr><td><a id="l72"></a><a href="#l72">72</a><td>   */<tr><td><a id="l73"></a><a href="#l73">73</a><td>  INTERACTIVE: 2<tr><td><a id="l74"></a><a href="#l74">74</a><td>};<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @define {number} The monitoring mode of the goog.Disposable<tr><td><a id="l79"></a><a href="#l79">79</a><td> *     instances. Default is OFF. Switching on the monitoring is only<tr><td><a id="l80"></a><a href="#l80">80</a><td> *     recommended for debugging because it has a significant impact on<tr><td><a id="l81"></a><a href="#l81">81</a><td> *     performance and memory usage. If switched off, the monitoring code<tr><td><a id="l82"></a><a href="#l82">82</a><td> *     compiles down to 0 bytes.<tr><td><a id="l83"></a><a href="#l83">83</a><td> */<tr><td><a id="l84"></a><a href="#l84">84</a><td>goog.define(&#39;goog.Disposable.MONITORING_MODE&#39;, 0);<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>/**<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @define {boolean} Whether to attach creation stack to each created disposable<tr><td><a id="l89"></a><a href="#l89">89</a><td> *     instance; This is only relevant for when MonitoringMode != OFF.<tr><td><a id="l90"></a><a href="#l90">90</a><td> */<tr><td><a id="l91"></a><a href="#l91">91</a><td>goog.define(&#39;goog.Disposable.INCLUDE_STACK_ON_CREATION&#39;, true);<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> * Maps the unique ID of every undisposed {@code goog.Disposable} object to<tr><td><a id="l96"></a><a href="#l96">96</a><td> * the object itself.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @type {!Object&lt;number, !goog.Disposable&gt;}<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @private<tr><td><a id="l99"></a><a href="#l99">99</a><td> */<tr><td><a id="l100"></a><a href="#l100">100</a><td>goog.Disposable.instances_ = {};<tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td>/**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @return {!Array&lt;!goog.Disposable&gt;} All {@code goog.Disposable} objects that<tr><td><a id="l105"></a><a href="#l105">105</a><td> *     haven&#39;t been disposed of.<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.Disposable.getUndisposedObjects = function() {<tr><td><a id="l108"></a><a href="#l108">108</a><td>  var ret = [];<tr><td><a id="l109"></a><a href="#l109">109</a><td>  for (var id in goog.Disposable.instances_) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>    if (goog.Disposable.instances_.hasOwnProperty(id)) {<tr><td><a id="l111"></a><a href="#l111">111</a><td>      ret.push(goog.Disposable.instances_[Number(id)]);<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>  return ret;<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> * Clears the registry of undisposed objects but doesn&#39;t dispose of them.<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.Disposable.clearUndisposedObjects = function() {<tr><td><a id="l122"></a><a href="#l122">122</a><td>  goog.Disposable.instances_ = {};<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> * Whether the object has been disposed of.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @type {boolean}<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @private<tr><td><a id="l130"></a><a href="#l130">130</a><td> */<tr><td><a id="l131"></a><a href="#l131">131</a><td>goog.Disposable.prototype.disposed_ = 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>/**<tr><td><a id="l135"></a><a href="#l135">135</a><td> * Callbacks to invoke when this object is disposed.<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @type {Array&lt;!Function&gt;}<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @private<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.Disposable.prototype.onDisposeCallbacks_;<tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td><tr><td><a id="l142"></a><a href="#l142">142</a><td>/**<tr><td><a id="l143"></a><a href="#l143">143</a><td> * If monitoring the goog.Disposable instances is enabled, stores the creation<tr><td><a id="l144"></a><a href="#l144">144</a><td> * stack trace of the Disposable instance.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @const {string}<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.Disposable.prototype.creationStack;<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>/**<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @return {boolean} Whether the object has been disposed of.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @override<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td>goog.Disposable.prototype.isDisposed = function() {<tr><td><a id="l155"></a><a href="#l155">155</a><td>  return this.disposed_;<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>/**<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @return {boolean} Whether the object has been disposed of.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @deprecated Use {@link #isDisposed} instead.<tr><td><a id="l162"></a><a href="#l162">162</a><td> */<tr><td><a id="l163"></a><a href="#l163">163</a><td>goog.Disposable.prototype.getDisposed = goog.Disposable.prototype.isDisposed;<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> * Disposes of the object. If the object hasn&#39;t already been disposed of, calls<tr><td><a id="l168"></a><a href="#l168">168</a><td> * {@link #disposeInternal}. Classes that extend {@code goog.Disposable} should<tr><td><a id="l169"></a><a href="#l169">169</a><td> * override {@link #disposeInternal} in order to delete references to COM<tr><td><a id="l170"></a><a href="#l170">170</a><td> * objects, DOM nodes, and other disposable objects. Reentrant.<tr><td><a id="l171"></a><a href="#l171">171</a><td> *<tr><td><a id="l172"></a><a href="#l172">172</a><td> * @return {void} Nothing.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @override<tr><td><a id="l174"></a><a href="#l174">174</a><td> */<tr><td><a id="l175"></a><a href="#l175">175</a><td>goog.Disposable.prototype.dispose = function() {<tr><td><a id="l176"></a><a href="#l176">176</a><td>  if (!this.disposed_) {<tr><td><a id="l177"></a><a href="#l177">177</a><td>    // Set disposed_ to true first, in case during the chain of disposal this<tr><td><a id="l178"></a><a href="#l178">178</a><td>    // gets disposed recursively.<tr><td><a id="l179"></a><a href="#l179">179</a><td>    this.disposed_ = true;<tr><td><a id="l180"></a><a href="#l180">180</a><td>    this.disposeInternal();<tr><td><a id="l181"></a><a href="#l181">181</a><td>    if (goog.Disposable.MONITORING_MODE != goog.Disposable.MonitoringMode.OFF) {<tr><td><a id="l182"></a><a href="#l182">182</a><td>      var uid = goog.getUid(this);<tr><td><a id="l183"></a><a href="#l183">183</a><td>      if (goog.Disposable.MONITORING_MODE ==<tr><td><a id="l184"></a><a href="#l184">184</a><td>          goog.Disposable.MonitoringMode.PERMANENT &amp;&amp;<tr><td><a id="l185"></a><a href="#l185">185</a><td>          !goog.Disposable.instances_.hasOwnProperty(uid)) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>        throw Error(this + &#39; did not call the goog.Disposable base &#39; +<tr><td><a id="l187"></a><a href="#l187">187</a><td>            &#39;constructor or was disposed of after a clearUndisposedObjects &#39; +<tr><td><a id="l188"></a><a href="#l188">188</a><td>            &#39;call&#39;);<tr><td><a id="l189"></a><a href="#l189">189</a><td>      }<tr><td><a id="l190"></a><a href="#l190">190</a><td>      delete goog.Disposable.instances_[uid];<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><tr><td><a id="l196"></a><a href="#l196">196</a><td>/**<tr><td><a id="l197"></a><a href="#l197">197</a><td> * Associates a disposable object with this object so that they will be disposed<tr><td><a id="l198"></a><a href="#l198">198</a><td> * together.<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @param {goog.disposable.IDisposable} disposable that will be disposed when<tr><td><a id="l200"></a><a href="#l200">200</a><td> *     this object is disposed.<tr><td><a id="l201"></a><a href="#l201">201</a><td> */<tr><td><a id="l202"></a><a href="#l202">202</a><td>goog.Disposable.prototype.registerDisposable = function(disposable) {<tr><td><a id="l203"></a><a href="#l203">203</a><td>  this.addOnDisposeCallback(goog.partial(goog.dispose, disposable));<tr><td><a id="l204"></a><a href="#l204">204</a><td>};<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td>/**<tr><td><a id="l208"></a><a href="#l208">208</a><td> * Invokes a callback function when this object is disposed. Callbacks are<tr><td><a id="l209"></a><a href="#l209">209</a><td> * invoked in the order in which they were added. If a callback is added to<tr><td><a id="l210"></a><a href="#l210">210</a><td> * an already disposed Disposable, it will be called immediately.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @param {function(this:T):?} callback The callback function.<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @param {T=} opt_scope An optional scope to call the callback in.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @template T<tr><td><a id="l214"></a><a href="#l214">214</a><td> */<tr><td><a id="l215"></a><a href="#l215">215</a><td>goog.Disposable.prototype.addOnDisposeCallback = function(callback, opt_scope) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>  if (this.disposed_) {<tr><td><a id="l217"></a><a href="#l217">217</a><td>    callback.call(opt_scope);<tr><td><a id="l218"></a><a href="#l218">218</a><td>    return;<tr><td><a id="l219"></a><a href="#l219">219</a><td>  }<tr><td><a id="l220"></a><a href="#l220">220</a><td>  if (!this.onDisposeCallbacks_) {<tr><td><a id="l221"></a><a href="#l221">221</a><td>    this.onDisposeCallbacks_ = [];<tr><td><a id="l222"></a><a href="#l222">222</a><td>  }<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td>  this.onDisposeCallbacks_.push(<tr><td><a id="l225"></a><a href="#l225">225</a><td>      goog.isDef(opt_scope) ? goog.bind(callback, opt_scope) : callback);<tr><td><a id="l226"></a><a href="#l226">226</a><td>};<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>/**<tr><td><a id="l230"></a><a href="#l230">230</a><td> * Deletes or nulls out any references to COM objects, DOM nodes, or other<tr><td><a id="l231"></a><a href="#l231">231</a><td> * disposable objects. Classes that extend {@code goog.Disposable} should<tr><td><a id="l232"></a><a href="#l232">232</a><td> * override this method.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * Not reentrant. To avoid calling it twice, it must only be called from the<tr><td><a id="l234"></a><a href="#l234">234</a><td> * subclass&#39; {@code disposeInternal} method. Everywhere else the public<tr><td><a id="l235"></a><a href="#l235">235</a><td> * {@code dispose} method must be used.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * For example:<tr><td><a id="l237"></a><a href="#l237">237</a><td> * &lt;pre&gt;<tr><td><a id="l238"></a><a href="#l238">238</a><td> *   mypackage.MyClass = function() {<tr><td><a id="l239"></a><a href="#l239">239</a><td> *     mypackage.MyClass.base(this, &#39;constructor&#39;);<tr><td><a id="l240"></a><a href="#l240">240</a><td> *     // Constructor logic specific to MyClass.<tr><td><a id="l241"></a><a href="#l241">241</a><td> *     ...<tr><td><a id="l242"></a><a href="#l242">242</a><td> *   };<tr><td><a id="l243"></a><a href="#l243">243</a><td> *   goog.inherits(mypackage.MyClass, goog.Disposable);<tr><td><a id="l244"></a><a href="#l244">244</a><td> *<tr><td><a id="l245"></a><a href="#l245">245</a><td> *   mypackage.MyClass.prototype.disposeInternal = function() {<tr><td><a id="l246"></a><a href="#l246">246</a><td> *     // Dispose logic specific to MyClass.<tr><td><a id="l247"></a><a href="#l247">247</a><td> *     ...<tr><td><a id="l248"></a><a href="#l248">248</a><td> *     // Call superclass&#39;s disposeInternal at the end of the subclass&#39;s, like<tr><td><a id="l249"></a><a href="#l249">249</a><td> *     // in C++, to avoid hard-to-catch issues.<tr><td><a id="l250"></a><a href="#l250">250</a><td> *     mypackage.MyClass.base(this, &#39;disposeInternal&#39;);<tr><td><a id="l251"></a><a href="#l251">251</a><td> *   };<tr><td><a id="l252"></a><a href="#l252">252</a><td> * &lt;/pre&gt;<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @protected<tr><td><a id="l254"></a><a href="#l254">254</a><td> */<tr><td><a id="l255"></a><a href="#l255">255</a><td>goog.Disposable.prototype.disposeInternal = function() {<tr><td><a id="l256"></a><a href="#l256">256</a><td>  if (this.onDisposeCallbacks_) {<tr><td><a id="l257"></a><a href="#l257">257</a><td>    while (this.onDisposeCallbacks_.length) {<tr><td><a id="l258"></a><a href="#l258">258</a><td>      this.onDisposeCallbacks_.shift()();<tr><td><a id="l259"></a><a href="#l259">259</a><td>    }<tr><td><a id="l260"></a><a href="#l260">260</a><td>  }<tr><td><a id="l261"></a><a href="#l261">261</a><td>};<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>/**<tr><td><a id="l265"></a><a href="#l265">265</a><td> * Returns True if we can verify the object is disposed.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * Calls {@code isDisposed} on the argument if it supports it.  If obj<tr><td><a id="l267"></a><a href="#l267">267</a><td> * is not an object with an isDisposed() method, return false.<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @param {*} obj The object to investigate.<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @return {boolean} True if we can verify the object is disposed.<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>goog.Disposable.isDisposed = function(obj) {<tr><td><a id="l272"></a><a href="#l272">272</a><td>  if (obj &amp;&amp; typeof obj.isDisposed == &#39;function&#39;) {<tr><td><a id="l273"></a><a href="#l273">273</a><td>    return obj.isDisposed();<tr><td><a id="l274"></a><a href="#l274">274</a><td>  }<tr><td><a id="l275"></a><a href="#l275">275</a><td>  return false;<tr><td><a id="l276"></a><a href="#l276">276</a><td>};<tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td>/**<tr><td><a id="l280"></a><a href="#l280">280</a><td> * Calls {@code dispose} on the argument if it supports it. If obj is not an<tr><td><a id="l281"></a><a href="#l281">281</a><td> *     object with a dispose() method, this is a no-op.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @param {*} obj The object to dispose of.<tr><td><a id="l283"></a><a href="#l283">283</a><td> */<tr><td><a id="l284"></a><a href="#l284">284</a><td>goog.dispose = function(obj) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>  if (obj &amp;&amp; typeof obj.dispose == &#39;function&#39;) {<tr><td><a id="l286"></a><a href="#l286">286</a><td>    obj.dispose();<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><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> * Calls {@code dispose} on each member of the list that supports it. (If the<tr><td><a id="l293"></a><a href="#l293">293</a><td> * member is an ArrayLike, then {@code goog.disposeAll()} will be called<tr><td><a id="l294"></a><a href="#l294">294</a><td> * recursively on each of its members.) If the member is not an object with a<tr><td><a id="l295"></a><a href="#l295">295</a><td> * {@code dispose()} method, then it is ignored.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @param {...*} var_args The list.<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>goog.disposeAll = function(var_args) {<tr><td><a id="l299"></a><a href="#l299">299</a><td>  for (var i = 0, len = arguments.length; i &lt; len; ++i) {<tr><td><a id="l300"></a><a href="#l300">300</a><td>    var disposable = arguments[i];<tr><td><a id="l301"></a><a href="#l301">301</a><td>    if (goog.isArrayLike(disposable)) {<tr><td><a id="l302"></a><a href="#l302">302</a><td>      goog.disposeAll.apply(null, disposable);<tr><td><a id="l303"></a><a href="#l303">303</a><td>    } else {<tr><td><a id="l304"></a><a href="#l304">304</a><td>      goog.dispose(disposable);<tr><td><a id="l305"></a><a href="#l305">305</a><td>    }<tr><td><a id="l306"></a><a href="#l306">306</a><td>  }<tr><td><a id="l307"></a><a href="#l307">307</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/disposable/idisposable.js.src.html b/docs/source/lib/goog/disposable/idisposable.js.src.html
new file mode 100644
index 0000000..a3d4819
--- /dev/null
+++ b/docs/source/lib/goog/disposable/idisposable.js.src.html
@@ -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>idisposable.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/disposable/idisposable.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2011 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Definition of the disposable interface.  A disposable object<tr><td><a id="l17"></a><a href="#l17">17</a><td> * has a dispose method to to clean up references and resources.<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author nnaze@google.com (Nathan Naze)<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.disposable.IDisposable&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Interface for a disposable object.  If a instance requires cleanup<tr><td><a id="l28"></a><a href="#l28">28</a><td> * (references COM objects, DOM notes, or other disposable objects), it should<tr><td><a id="l29"></a><a href="#l29">29</a><td> * implement this interface (it may subclass goog.Disposable).<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @interface<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.disposable.IDisposable = 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> * Disposes of the object and its resources.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @return {void} Nothing.<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.disposable.IDisposable.prototype.dispose = goog.abstractMethod;<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>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @return {boolean} Whether the object has been disposed of.<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.disposable.IDisposable.prototype.isDisposed = 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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/dom/browserfeature.js.src.html b/docs/source/lib/goog/dom/browserfeature.js.src.html
new file mode 100644
index 0000000..0c53d6b
--- /dev/null
+++ b/docs/source/lib/goog/dom/browserfeature.js.src.html
@@ -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>browserfeature.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/dom/browserfeature.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Browser capability checks for the dom package.<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><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.dom.BrowserFeature&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.userAgent&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Enum of browser capabilities.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @enum {boolean}<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.dom.BrowserFeature = {<tr><td><a id="l31"></a><a href="#l31">31</a><td>  /**<tr><td><a id="l32"></a><a href="#l32">32</a><td>   * Whether attributes &#39;name&#39; and &#39;type&#39; can be added to an element after it&#39;s<tr><td><a id="l33"></a><a href="#l33">33</a><td>   * created. False in Internet Explorer prior to version 9.<tr><td><a id="l34"></a><a href="#l34">34</a><td>   */<tr><td><a id="l35"></a><a href="#l35">35</a><td>  CAN_ADD_NAME_OR_TYPE_ATTRIBUTES: !goog.userAgent.IE ||<tr><td><a id="l36"></a><a href="#l36">36</a><td>      goog.userAgent.isDocumentModeOrHigher(9),<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>   * Whether we can use element.children to access an element&#39;s Element<tr><td><a id="l40"></a><a href="#l40">40</a><td>   * children. Available since Gecko 1.9.1, IE 9. (IE&lt;9 also includes comment<tr><td><a id="l41"></a><a href="#l41">41</a><td>   * nodes in the collection.)<tr><td><a id="l42"></a><a href="#l42">42</a><td>   */<tr><td><a id="l43"></a><a href="#l43">43</a><td>  CAN_USE_CHILDREN_ATTRIBUTE: !goog.userAgent.GECKO &amp;&amp; !goog.userAgent.IE ||<tr><td><a id="l44"></a><a href="#l44">44</a><td>      goog.userAgent.IE &amp;&amp; goog.userAgent.isDocumentModeOrHigher(9) ||<tr><td><a id="l45"></a><a href="#l45">45</a><td>      goog.userAgent.GECKO &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;1.9.1&#39;),<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>   * Opera, Safari 3, and Internet Explorer 9 all support innerText but they<tr><td><a id="l49"></a><a href="#l49">49</a><td>   * include text nodes in script and style tags. Not document-mode-dependent.<tr><td><a id="l50"></a><a href="#l50">50</a><td>   */<tr><td><a id="l51"></a><a href="#l51">51</a><td>  CAN_USE_INNER_TEXT: (<tr><td><a id="l52"></a><a href="#l52">52</a><td>      goog.userAgent.IE &amp;&amp; !goog.userAgent.isVersionOrHigher(&#39;9&#39;)),<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>  /**<tr><td><a id="l55"></a><a href="#l55">55</a><td>   * MSIE, Opera, and Safari&gt;=4 support element.parentElement to access an<tr><td><a id="l56"></a><a href="#l56">56</a><td>   * element&#39;s parent if it is an Element.<tr><td><a id="l57"></a><a href="#l57">57</a><td>   */<tr><td><a id="l58"></a><a href="#l58">58</a><td>  CAN_USE_PARENT_ELEMENT_PROPERTY: goog.userAgent.IE || goog.userAgent.OPERA ||<tr><td><a id="l59"></a><a href="#l59">59</a><td>      goog.userAgent.WEBKIT,<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td>  /**<tr><td><a id="l62"></a><a href="#l62">62</a><td>   * Whether NoScope elements need a scoped element written before them in<tr><td><a id="l63"></a><a href="#l63">63</a><td>   * innerHTML.<tr><td><a id="l64"></a><a href="#l64">64</a><td>   * MSDN: http://msdn.microsoft.com/en-us/library/ms533897(VS.85).aspx#1<tr><td><a id="l65"></a><a href="#l65">65</a><td>   */<tr><td><a id="l66"></a><a href="#l66">66</a><td>  INNER_HTML_NEEDS_SCOPED_ELEMENT: goog.userAgent.IE,<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td>  /**<tr><td><a id="l69"></a><a href="#l69">69</a><td>   * Whether we use legacy IE range API.<tr><td><a id="l70"></a><a href="#l70">70</a><td>   */<tr><td><a id="l71"></a><a href="#l71">71</a><td>  LEGACY_IE_RANGES: goog.userAgent.IE &amp;&amp; !goog.userAgent.isDocumentModeOrHigher(9)<tr><td><a id="l72"></a><a href="#l72">72</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/dom/dom.js.src.html b/docs/source/lib/goog/dom/dom.js.src.html
new file mode 100644
index 0000000..626f007
--- /dev/null
+++ b/docs/source/lib/goog/dom/dom.js.src.html
@@ -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>dom.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/dom/dom.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities for manipulating the browser&#39;s Document Object Model<tr><td><a id="l17"></a><a href="#l17">17</a><td> * Inspiration taken *heavily* from mochikit (http://mochikit.com/).<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * You can use {@link goog.dom.DomHelper} to create new dom helpers that refer<tr><td><a id="l20"></a><a href="#l20">20</a><td> * to a different document object.  This is useful if you are working with<tr><td><a id="l21"></a><a href="#l21">21</a><td> * frames or multiple windows.<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * @author arv@google.com (Erik Arvidsson)<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><tr><td><a id="l27"></a><a href="#l27">27</a><td>// TODO(arv): Rename/refactor getTextContent and getRawTextContent. The problem<tr><td><a id="l28"></a><a href="#l28">28</a><td>// is that getTextContent should mimic the DOM3 textContent. We should add a<tr><td><a id="l29"></a><a href="#l29">29</a><td>// getInnerText (or getText) which tries to return the visible text, innerText.<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>goog.provide(&#39;goog.dom&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.provide(&#39;goog.dom.Appendable&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.provide(&#39;goog.dom.DomHelper&#39;);<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.require(&#39;goog.array&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.dom.BrowserFeature&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.dom.NodeType&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.dom.TagName&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.dom.safe&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.html.SafeHtml&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.math.Coordinate&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;goog.math.Size&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.require(&#39;goog.string.Unicode&#39;);<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>/**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @define {boolean} Whether we know at compile time that the browser is in<tr><td><a id="l53"></a><a href="#l53">53</a><td> * quirks mode.<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.define(&#39;goog.dom.ASSUME_QUIRKS_MODE&#39;, false);<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> * @define {boolean} Whether we know at compile time that the browser is in<tr><td><a id="l60"></a><a href="#l60">60</a><td> * standards compliance mode.<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.define(&#39;goog.dom.ASSUME_STANDARDS_MODE&#39;, false);<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> * Whether we know the compatibility mode at compile time.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @type {boolean}<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @private<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>goog.dom.COMPAT_MODE_KNOWN_ =<tr><td><a id="l71"></a><a href="#l71">71</a><td>    goog.dom.ASSUME_QUIRKS_MODE || goog.dom.ASSUME_STANDARDS_MODE;<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>/**<tr><td><a id="l75"></a><a href="#l75">75</a><td> * Gets the DomHelper object for the document where the element resides.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @param {(Node|Window)=} opt_element If present, gets the DomHelper for this<tr><td><a id="l77"></a><a href="#l77">77</a><td> *     element.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {!goog.dom.DomHelper} The DomHelper.<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.dom.getDomHelper = function(opt_element) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>  return opt_element ?<tr><td><a id="l82"></a><a href="#l82">82</a><td>      new goog.dom.DomHelper(goog.dom.getOwnerDocument(opt_element)) :<tr><td><a id="l83"></a><a href="#l83">83</a><td>      (goog.dom.defaultDomHelper_ ||<tr><td><a id="l84"></a><a href="#l84">84</a><td>          (goog.dom.defaultDomHelper_ = new goog.dom.DomHelper()));<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><tr><td><a id="l88"></a><a href="#l88">88</a><td>/**<tr><td><a id="l89"></a><a href="#l89">89</a><td> * Cached default DOM helper.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @type {goog.dom.DomHelper}<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @private<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.dom.defaultDomHelper_;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>/**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Gets the document object being used by the dom library.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @return {!Document} Document object.<tr><td><a id="l99"></a><a href="#l99">99</a><td> */<tr><td><a id="l100"></a><a href="#l100">100</a><td>goog.dom.getDocument = function() {<tr><td><a id="l101"></a><a href="#l101">101</a><td>  return document;<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * Gets an element from the current document by element id.<tr><td><a id="l107"></a><a href="#l107">107</a><td> *<tr><td><a id="l108"></a><a href="#l108">108</a><td> * If an Element is passed in, it is returned.<tr><td><a id="l109"></a><a href="#l109">109</a><td> *<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @param {string|Element} element Element ID or a DOM node.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @return {Element} The element with the given ID, or the node passed in.<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.dom.getElement = function(element) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  return goog.dom.getElementHelper_(document, element);<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> * Gets an element by id from the given document (if present).<tr><td><a id="l120"></a><a href="#l120">120</a><td> * If an element is given, it is returned.<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @param {!Document} doc<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @param {string|Element} element Element ID or a DOM node.<tr><td><a id="l123"></a><a href="#l123">123</a><td> * @return {Element} The resulting element.<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @private<tr><td><a id="l125"></a><a href="#l125">125</a><td> */<tr><td><a id="l126"></a><a href="#l126">126</a><td>goog.dom.getElementHelper_ = function(doc, element) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>  return goog.isString(element) ?<tr><td><a id="l128"></a><a href="#l128">128</a><td>      doc.getElementById(element) :<tr><td><a id="l129"></a><a href="#l129">129</a><td>      element;<tr><td><a id="l130"></a><a href="#l130">130</a><td>};<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/**<tr><td><a id="l134"></a><a href="#l134">134</a><td> * Gets an element by id, asserting that the element is found.<tr><td><a id="l135"></a><a href="#l135">135</a><td> *<tr><td><a id="l136"></a><a href="#l136">136</a><td> * This is used when an element is expected to exist, and should fail with<tr><td><a id="l137"></a><a href="#l137">137</a><td> * an assertion error if it does not (if assertions are enabled).<tr><td><a id="l138"></a><a href="#l138">138</a><td> *<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {string} id Element ID.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @return {!Element} The element with the given ID, if it exists.<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td>goog.dom.getRequiredElement = function(id) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>  return goog.dom.getRequiredElementHelper_(document, id);<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>/**<tr><td><a id="l148"></a><a href="#l148">148</a><td> * Helper function for getRequiredElementHelper functions, both static and<tr><td><a id="l149"></a><a href="#l149">149</a><td> * on DomHelper.  Asserts the element with the given id exists.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @param {!Document} doc<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {string} id<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @return {!Element} The element with the given ID, if it exists.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @private<tr><td><a id="l154"></a><a href="#l154">154</a><td> */<tr><td><a id="l155"></a><a href="#l155">155</a><td>goog.dom.getRequiredElementHelper_ = function(doc, id) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>  // To prevent users passing in Elements as is permitted in getElement().<tr><td><a id="l157"></a><a href="#l157">157</a><td>  goog.asserts.assertString(id);<tr><td><a id="l158"></a><a href="#l158">158</a><td>  var element = goog.dom.getElementHelper_(doc, id);<tr><td><a id="l159"></a><a href="#l159">159</a><td>  element = goog.asserts.assertElement(element,<tr><td><a id="l160"></a><a href="#l160">160</a><td>      &#39;No element found with id: &#39; + id);<tr><td><a id="l161"></a><a href="#l161">161</a><td>  return element;<tr><td><a id="l162"></a><a href="#l162">162</a><td>};<tr><td><a id="l163"></a><a href="#l163">163</a><td><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> * Alias for getElement.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {string|Element} element Element ID or a DOM node.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {Element} The element with the given ID, or the node passed in.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @deprecated Use {@link goog.dom.getElement} instead.<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.dom.$ = goog.dom.getElement;<tr><td><a id="l172"></a><a href="#l172">172</a><td><tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td>/**<tr><td><a id="l175"></a><a href="#l175">175</a><td> * Looks up elements by both tag and class name, using browser native functions<tr><td><a id="l176"></a><a href="#l176">176</a><td> * ({@code querySelectorAll}, {@code getElementsByTagName} or<tr><td><a id="l177"></a><a href="#l177">177</a><td> * {@code getElementsByClassName}) where possible. This function<tr><td><a id="l178"></a><a href="#l178">178</a><td> * is a useful, if limited, way of collecting a list of DOM elements<tr><td><a id="l179"></a><a href="#l179">179</a><td> * with certain characteristics.  {@code goog.dom.query} offers a<tr><td><a id="l180"></a><a href="#l180">180</a><td> * more powerful and general solution which allows matching on CSS3<tr><td><a id="l181"></a><a href="#l181">181</a><td> * selector expressions, but at increased cost in code size. If all you<tr><td><a id="l182"></a><a href="#l182">182</a><td> * need is particular tags belonging to a single class, this function<tr><td><a id="l183"></a><a href="#l183">183</a><td> * is fast and sleek.<tr><td><a id="l184"></a><a href="#l184">184</a><td> *<tr><td><a id="l185"></a><a href="#l185">185</a><td> * Note that tag names are case sensitive in the SVG namespace, and this<tr><td><a id="l186"></a><a href="#l186">186</a><td> * function converts opt_tag to uppercase for comparisons. For queries in the<tr><td><a id="l187"></a><a href="#l187">187</a><td> * SVG namespace you should use querySelector or querySelectorAll instead.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * https://bugzilla.mozilla.org/show_bug.cgi?id=963870<tr><td><a id="l189"></a><a href="#l189">189</a><td> * https://bugs.webkit.org/show_bug.cgi?id=83438<tr><td><a id="l190"></a><a href="#l190">190</a><td> *<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @see {goog.dom.query}<tr><td><a id="l192"></a><a href="#l192">192</a><td> *<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @param {?string=} opt_tag Element tag name.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @param {?string=} opt_class Optional class name.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @param {(Document|Element)=} opt_el Optional element to look in.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @return { {length: number} } Array-like list of elements (only a length<tr><td><a id="l197"></a><a href="#l197">197</a><td> *     property and numerical indices are guaranteed to exist).<tr><td><a id="l198"></a><a href="#l198">198</a><td> */<tr><td><a id="l199"></a><a href="#l199">199</a><td>goog.dom.getElementsByTagNameAndClass = function(opt_tag, opt_class, opt_el) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>  return goog.dom.getElementsByTagNameAndClass_(document, opt_tag, opt_class,<tr><td><a id="l201"></a><a href="#l201">201</a><td>                                                opt_el);<tr><td><a id="l202"></a><a href="#l202">202</a><td>};<tr><td><a id="l203"></a><a href="#l203">203</a><td><tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td>/**<tr><td><a id="l206"></a><a href="#l206">206</a><td> * Returns a static, array-like list of the elements with the provided<tr><td><a id="l207"></a><a href="#l207">207</a><td> * className.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @see {goog.dom.query}<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @param {string} className the name of the class to look for.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {(Document|Element)=} opt_el Optional element to look in.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @return { {length: number} } The items found with the class name provided.<tr><td><a id="l212"></a><a href="#l212">212</a><td> */<tr><td><a id="l213"></a><a href="#l213">213</a><td>goog.dom.getElementsByClass = function(className, opt_el) {<tr><td><a id="l214"></a><a href="#l214">214</a><td>  var parent = opt_el || document;<tr><td><a id="l215"></a><a href="#l215">215</a><td>  if (goog.dom.canUseQuerySelector_(parent)) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>    return parent.querySelectorAll(&#39;.&#39; + className);<tr><td><a id="l217"></a><a href="#l217">217</a><td>  }<tr><td><a id="l218"></a><a href="#l218">218</a><td>  return goog.dom.getElementsByTagNameAndClass_(<tr><td><a id="l219"></a><a href="#l219">219</a><td>      document, &#39;*&#39;, className, opt_el);<tr><td><a id="l220"></a><a href="#l220">220</a><td>};<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td>/**<tr><td><a id="l224"></a><a href="#l224">224</a><td> * Returns the first element with the provided className.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @see {goog.dom.query}<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @param {string} className the name of the class to look for.<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @param {Element|Document=} opt_el Optional element to look in.<tr><td><a id="l228"></a><a href="#l228">228</a><td> * @return {Element} The first item with the class name provided.<tr><td><a id="l229"></a><a href="#l229">229</a><td> */<tr><td><a id="l230"></a><a href="#l230">230</a><td>goog.dom.getElementByClass = function(className, opt_el) {<tr><td><a id="l231"></a><a href="#l231">231</a><td>  var parent = opt_el || document;<tr><td><a id="l232"></a><a href="#l232">232</a><td>  var retVal = null;<tr><td><a id="l233"></a><a href="#l233">233</a><td>  if (parent.getElementsByClassName) {<tr><td><a id="l234"></a><a href="#l234">234</a><td>    retVal = parent.getElementsByClassName(className)[0];<tr><td><a id="l235"></a><a href="#l235">235</a><td>  } else if (goog.dom.canUseQuerySelector_(parent)) {<tr><td><a id="l236"></a><a href="#l236">236</a><td>    retVal = parent.querySelector(&#39;.&#39; + className);<tr><td><a id="l237"></a><a href="#l237">237</a><td>  } else {<tr><td><a id="l238"></a><a href="#l238">238</a><td>    retVal = goog.dom.getElementsByTagNameAndClass_(<tr><td><a id="l239"></a><a href="#l239">239</a><td>        document, &#39;*&#39;, className, opt_el)[0];<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 retVal || null;<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>/**<tr><td><a id="l246"></a><a href="#l246">246</a><td> * Ensures an element with the given className exists, and then returns the<tr><td><a id="l247"></a><a href="#l247">247</a><td> * first element with the provided className.<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @see {goog.dom.query}<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @param {string} className the name of the class to look for.<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @param {!Element|!Document=} opt_root Optional element or document to look<tr><td><a id="l251"></a><a href="#l251">251</a><td> *     in.<tr><td><a id="l252"></a><a href="#l252">252</a><td> * @return {!Element} The first item with the class name provided.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @throws {goog.asserts.AssertionError} Thrown if no element is found.<tr><td><a id="l254"></a><a href="#l254">254</a><td> */<tr><td><a id="l255"></a><a href="#l255">255</a><td>goog.dom.getRequiredElementByClass = function(className, opt_root) {<tr><td><a id="l256"></a><a href="#l256">256</a><td>  var retValue = goog.dom.getElementByClass(className, opt_root);<tr><td><a id="l257"></a><a href="#l257">257</a><td>  return goog.asserts.assert(retValue,<tr><td><a id="l258"></a><a href="#l258">258</a><td>      &#39;No element found with className: &#39; + className);<tr><td><a id="l259"></a><a href="#l259">259</a><td>};<tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td>/**<tr><td><a id="l263"></a><a href="#l263">263</a><td> * Prefer the standardized (http://www.w3.org/TR/selectors-api/), native and<tr><td><a id="l264"></a><a href="#l264">264</a><td> * fast W3C Selectors API.<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @param {!(Element|Document)} parent The parent document object.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @return {boolean} whether or not we can use parent.querySelector* APIs.<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @private<tr><td><a id="l268"></a><a href="#l268">268</a><td> */<tr><td><a id="l269"></a><a href="#l269">269</a><td>goog.dom.canUseQuerySelector_ = function(parent) {<tr><td><a id="l270"></a><a href="#l270">270</a><td>  return !!(parent.querySelectorAll &amp;&amp; parent.querySelector);<tr><td><a id="l271"></a><a href="#l271">271</a><td>};<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> * Helper for {@code getElementsByTagNameAndClass}.<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @param {!Document} doc The document to get the elements in.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {?string=} opt_tag Element tag name.<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @param {?string=} opt_class Optional class name.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {(Document|Element)=} opt_el Optional element to look in.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @return { {length: number} } Array-like list of elements (only a length<tr><td><a id="l281"></a><a href="#l281">281</a><td> *     property and numerical indices are guaranteed to exist).<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @private<tr><td><a id="l283"></a><a href="#l283">283</a><td> */<tr><td><a id="l284"></a><a href="#l284">284</a><td>goog.dom.getElementsByTagNameAndClass_ = function(doc, opt_tag, opt_class,<tr><td><a id="l285"></a><a href="#l285">285</a><td>                                                  opt_el) {<tr><td><a id="l286"></a><a href="#l286">286</a><td>  var parent = opt_el || doc;<tr><td><a id="l287"></a><a href="#l287">287</a><td>  var tagName = (opt_tag &amp;&amp; opt_tag != &#39;*&#39;) ? opt_tag.toUpperCase() : &#39;&#39;;<tr><td><a id="l288"></a><a href="#l288">288</a><td><tr><td><a id="l289"></a><a href="#l289">289</a><td>  if (goog.dom.canUseQuerySelector_(parent) &amp;&amp;<tr><td><a id="l290"></a><a href="#l290">290</a><td>      (tagName || opt_class)) {<tr><td><a id="l291"></a><a href="#l291">291</a><td>    var query = tagName + (opt_class ? &#39;.&#39; + opt_class : &#39;&#39;);<tr><td><a id="l292"></a><a href="#l292">292</a><td>    return parent.querySelectorAll(query);<tr><td><a id="l293"></a><a href="#l293">293</a><td>  }<tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>  // Use the native getElementsByClassName if available, under the assumption<tr><td><a id="l296"></a><a href="#l296">296</a><td>  // that even when the tag name is specified, there will be fewer elements to<tr><td><a id="l297"></a><a href="#l297">297</a><td>  // filter through when going by class than by tag name<tr><td><a id="l298"></a><a href="#l298">298</a><td>  if (opt_class &amp;&amp; parent.getElementsByClassName) {<tr><td><a id="l299"></a><a href="#l299">299</a><td>    var els = parent.getElementsByClassName(opt_class);<tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td>    if (tagName) {<tr><td><a id="l302"></a><a href="#l302">302</a><td>      var arrayLike = {};<tr><td><a id="l303"></a><a href="#l303">303</a><td>      var len = 0;<tr><td><a id="l304"></a><a href="#l304">304</a><td><tr><td><a id="l305"></a><a href="#l305">305</a><td>      // Filter for specific tags if requested.<tr><td><a id="l306"></a><a href="#l306">306</a><td>      for (var i = 0, el; el = els[i]; i++) {<tr><td><a id="l307"></a><a href="#l307">307</a><td>        if (tagName == el.nodeName) {<tr><td><a id="l308"></a><a href="#l308">308</a><td>          arrayLike[len++] = el;<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>      arrayLike.length = len;<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td>      return arrayLike;<tr><td><a id="l314"></a><a href="#l314">314</a><td>    } else {<tr><td><a id="l315"></a><a href="#l315">315</a><td>      return els;<tr><td><a id="l316"></a><a href="#l316">316</a><td>    }<tr><td><a id="l317"></a><a href="#l317">317</a><td>  }<tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td>  var els = parent.getElementsByTagName(tagName || &#39;*&#39;);<tr><td><a id="l320"></a><a href="#l320">320</a><td><tr><td><a id="l321"></a><a href="#l321">321</a><td>  if (opt_class) {<tr><td><a id="l322"></a><a href="#l322">322</a><td>    var arrayLike = {};<tr><td><a id="l323"></a><a href="#l323">323</a><td>    var len = 0;<tr><td><a id="l324"></a><a href="#l324">324</a><td>    for (var i = 0, el; el = els[i]; i++) {<tr><td><a id="l325"></a><a href="#l325">325</a><td>      var className = el.className;<tr><td><a id="l326"></a><a href="#l326">326</a><td>      // Check if className has a split function since SVG className does not.<tr><td><a id="l327"></a><a href="#l327">327</a><td>      if (typeof className.split == &#39;function&#39; &amp;&amp;<tr><td><a id="l328"></a><a href="#l328">328</a><td>          goog.array.contains(className.split(/\s+/), opt_class)) {<tr><td><a id="l329"></a><a href="#l329">329</a><td>        arrayLike[len++] = el;<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>    arrayLike.length = len;<tr><td><a id="l333"></a><a href="#l333">333</a><td>    return arrayLike;<tr><td><a id="l334"></a><a href="#l334">334</a><td>  } else {<tr><td><a id="l335"></a><a href="#l335">335</a><td>    return els;<tr><td><a id="l336"></a><a href="#l336">336</a><td>  }<tr><td><a id="l337"></a><a href="#l337">337</a><td>};<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Alias for {@code getElementsByTagNameAndClass}.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {?string=} opt_tag Element tag name.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @param {?string=} opt_class Optional class name.<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @param {Element=} opt_el Optional element to look in.<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @return { {length: number} } Array-like list of elements (only a length<tr><td><a id="l346"></a><a href="#l346">346</a><td> *     property and numerical indices are guaranteed to exist).<tr><td><a id="l347"></a><a href="#l347">347</a><td> * @deprecated Use {@link goog.dom.getElementsByTagNameAndClass} instead.<tr><td><a id="l348"></a><a href="#l348">348</a><td> */<tr><td><a id="l349"></a><a href="#l349">349</a><td>goog.dom.$$ = goog.dom.getElementsByTagNameAndClass;<tr><td><a id="l350"></a><a href="#l350">350</a><td><tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td>/**<tr><td><a id="l353"></a><a href="#l353">353</a><td> * Sets multiple properties on a node.<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @param {Element} element DOM node to set properties on.<tr><td><a id="l355"></a><a href="#l355">355</a><td> * @param {Object} properties Hash of property:value pairs.<tr><td><a id="l356"></a><a href="#l356">356</a><td> */<tr><td><a id="l357"></a><a href="#l357">357</a><td>goog.dom.setProperties = function(element, properties) {<tr><td><a id="l358"></a><a href="#l358">358</a><td>  goog.object.forEach(properties, function(val, key) {<tr><td><a id="l359"></a><a href="#l359">359</a><td>    if (key == &#39;style&#39;) {<tr><td><a id="l360"></a><a href="#l360">360</a><td>      element.style.cssText = val;<tr><td><a id="l361"></a><a href="#l361">361</a><td>    } else if (key == &#39;class&#39;) {<tr><td><a id="l362"></a><a href="#l362">362</a><td>      element.className = val;<tr><td><a id="l363"></a><a href="#l363">363</a><td>    } else if (key == &#39;for&#39;) {<tr><td><a id="l364"></a><a href="#l364">364</a><td>      element.htmlFor = val;<tr><td><a id="l365"></a><a href="#l365">365</a><td>    } else if (goog.dom.DIRECT_ATTRIBUTE_MAP_.hasOwnProperty(key)) {<tr><td><a id="l366"></a><a href="#l366">366</a><td>      element.setAttribute(goog.dom.DIRECT_ATTRIBUTE_MAP_[key], val);<tr><td><a id="l367"></a><a href="#l367">367</a><td>    } else if (goog.string.startsWith(key, &#39;aria-&#39;) ||<tr><td><a id="l368"></a><a href="#l368">368</a><td>        goog.string.startsWith(key, &#39;data-&#39;)) {<tr><td><a id="l369"></a><a href="#l369">369</a><td>      element.setAttribute(key, val);<tr><td><a id="l370"></a><a href="#l370">370</a><td>    } else {<tr><td><a id="l371"></a><a href="#l371">371</a><td>      element[key] = val;<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><tr><td><a id="l377"></a><a href="#l377">377</a><td>/**<tr><td><a id="l378"></a><a href="#l378">378</a><td> * Map of attributes that should be set using<tr><td><a id="l379"></a><a href="#l379">379</a><td> * element.setAttribute(key, val) instead of element[key] = val.  Used<tr><td><a id="l380"></a><a href="#l380">380</a><td> * by goog.dom.setProperties.<tr><td><a id="l381"></a><a href="#l381">381</a><td> *<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @private {!Object&lt;string, string&gt;}<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @const<tr><td><a id="l384"></a><a href="#l384">384</a><td> */<tr><td><a id="l385"></a><a href="#l385">385</a><td>goog.dom.DIRECT_ATTRIBUTE_MAP_ = {<tr><td><a id="l386"></a><a href="#l386">386</a><td>  &#39;cellpadding&#39;: &#39;cellPadding&#39;,<tr><td><a id="l387"></a><a href="#l387">387</a><td>  &#39;cellspacing&#39;: &#39;cellSpacing&#39;,<tr><td><a id="l388"></a><a href="#l388">388</a><td>  &#39;colspan&#39;: &#39;colSpan&#39;,<tr><td><a id="l389"></a><a href="#l389">389</a><td>  &#39;frameborder&#39;: &#39;frameBorder&#39;,<tr><td><a id="l390"></a><a href="#l390">390</a><td>  &#39;height&#39;: &#39;height&#39;,<tr><td><a id="l391"></a><a href="#l391">391</a><td>  &#39;maxlength&#39;: &#39;maxLength&#39;,<tr><td><a id="l392"></a><a href="#l392">392</a><td>  &#39;role&#39;: &#39;role&#39;,<tr><td><a id="l393"></a><a href="#l393">393</a><td>  &#39;rowspan&#39;: &#39;rowSpan&#39;,<tr><td><a id="l394"></a><a href="#l394">394</a><td>  &#39;type&#39;: &#39;type&#39;,<tr><td><a id="l395"></a><a href="#l395">395</a><td>  &#39;usemap&#39;: &#39;useMap&#39;,<tr><td><a id="l396"></a><a href="#l396">396</a><td>  &#39;valign&#39;: &#39;vAlign&#39;,<tr><td><a id="l397"></a><a href="#l397">397</a><td>  &#39;width&#39;: &#39;width&#39;<tr><td><a id="l398"></a><a href="#l398">398</a><td>};<tr><td><a id="l399"></a><a href="#l399">399</a><td><tr><td><a id="l400"></a><a href="#l400">400</a><td><tr><td><a id="l401"></a><a href="#l401">401</a><td>/**<tr><td><a id="l402"></a><a href="#l402">402</a><td> * Gets the dimensions of the viewport.<tr><td><a id="l403"></a><a href="#l403">403</a><td> *<tr><td><a id="l404"></a><a href="#l404">404</a><td> * Gecko Standards mode:<tr><td><a id="l405"></a><a href="#l405">405</a><td> * docEl.clientWidth  Width of viewport excluding scrollbar.<tr><td><a id="l406"></a><a href="#l406">406</a><td> * win.innerWidth     Width of viewport including scrollbar.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * body.clientWidth   Width of body element.<tr><td><a id="l408"></a><a href="#l408">408</a><td> *<tr><td><a id="l409"></a><a href="#l409">409</a><td> * docEl.clientHeight Height of viewport excluding scrollbar.<tr><td><a id="l410"></a><a href="#l410">410</a><td> * win.innerHeight    Height of viewport including scrollbar.<tr><td><a id="l411"></a><a href="#l411">411</a><td> * body.clientHeight  Height of document.<tr><td><a id="l412"></a><a href="#l412">412</a><td> *<tr><td><a id="l413"></a><a href="#l413">413</a><td> * Gecko Backwards compatible mode:<tr><td><a id="l414"></a><a href="#l414">414</a><td> * docEl.clientWidth  Width of viewport excluding scrollbar.<tr><td><a id="l415"></a><a href="#l415">415</a><td> * win.innerWidth     Width of viewport including scrollbar.<tr><td><a id="l416"></a><a href="#l416">416</a><td> * body.clientWidth   Width of viewport excluding scrollbar.<tr><td><a id="l417"></a><a href="#l417">417</a><td> *<tr><td><a id="l418"></a><a href="#l418">418</a><td> * docEl.clientHeight Height of document.<tr><td><a id="l419"></a><a href="#l419">419</a><td> * win.innerHeight    Height of viewport including scrollbar.<tr><td><a id="l420"></a><a href="#l420">420</a><td> * body.clientHeight  Height of viewport excluding scrollbar.<tr><td><a id="l421"></a><a href="#l421">421</a><td> *<tr><td><a id="l422"></a><a href="#l422">422</a><td> * IE6/7 Standards mode:<tr><td><a id="l423"></a><a href="#l423">423</a><td> * docEl.clientWidth  Width of viewport excluding scrollbar.<tr><td><a id="l424"></a><a href="#l424">424</a><td> * win.innerWidth     Undefined.<tr><td><a id="l425"></a><a href="#l425">425</a><td> * body.clientWidth   Width of body element.<tr><td><a id="l426"></a><a href="#l426">426</a><td> *<tr><td><a id="l427"></a><a href="#l427">427</a><td> * docEl.clientHeight Height of viewport excluding scrollbar.<tr><td><a id="l428"></a><a href="#l428">428</a><td> * win.innerHeight    Undefined.<tr><td><a id="l429"></a><a href="#l429">429</a><td> * body.clientHeight  Height of document element.<tr><td><a id="l430"></a><a href="#l430">430</a><td> *<tr><td><a id="l431"></a><a href="#l431">431</a><td> * IE5 + IE6/7 Backwards compatible mode:<tr><td><a id="l432"></a><a href="#l432">432</a><td> * docEl.clientWidth  0.<tr><td><a id="l433"></a><a href="#l433">433</a><td> * win.innerWidth     Undefined.<tr><td><a id="l434"></a><a href="#l434">434</a><td> * body.clientWidth   Width of viewport excluding scrollbar.<tr><td><a id="l435"></a><a href="#l435">435</a><td> *<tr><td><a id="l436"></a><a href="#l436">436</a><td> * docEl.clientHeight 0.<tr><td><a id="l437"></a><a href="#l437">437</a><td> * win.innerHeight    Undefined.<tr><td><a id="l438"></a><a href="#l438">438</a><td> * body.clientHeight  Height of viewport excluding scrollbar.<tr><td><a id="l439"></a><a href="#l439">439</a><td> *<tr><td><a id="l440"></a><a href="#l440">440</a><td> * Opera 9 Standards and backwards compatible mode:<tr><td><a id="l441"></a><a href="#l441">441</a><td> * docEl.clientWidth  Width of viewport excluding scrollbar.<tr><td><a id="l442"></a><a href="#l442">442</a><td> * win.innerWidth     Width of viewport including scrollbar.<tr><td><a id="l443"></a><a href="#l443">443</a><td> * body.clientWidth   Width of viewport excluding scrollbar.<tr><td><a id="l444"></a><a href="#l444">444</a><td> *<tr><td><a id="l445"></a><a href="#l445">445</a><td> * docEl.clientHeight Height of document.<tr><td><a id="l446"></a><a href="#l446">446</a><td> * win.innerHeight    Height of viewport including scrollbar.<tr><td><a id="l447"></a><a href="#l447">447</a><td> * body.clientHeight  Height of viewport excluding scrollbar.<tr><td><a id="l448"></a><a href="#l448">448</a><td> *<tr><td><a id="l449"></a><a href="#l449">449</a><td> * WebKit:<tr><td><a id="l450"></a><a href="#l450">450</a><td> * Safari 2<tr><td><a id="l451"></a><a href="#l451">451</a><td> * docEl.clientHeight Same as scrollHeight.<tr><td><a id="l452"></a><a href="#l452">452</a><td> * docEl.clientWidth  Same as innerWidth.<tr><td><a id="l453"></a><a href="#l453">453</a><td> * win.innerWidth     Width of viewport excluding scrollbar.<tr><td><a id="l454"></a><a href="#l454">454</a><td> * win.innerHeight    Height of the viewport including scrollbar.<tr><td><a id="l455"></a><a href="#l455">455</a><td> * frame.innerHeight  Height of the viewport exluding scrollbar.<tr><td><a id="l456"></a><a href="#l456">456</a><td> *<tr><td><a id="l457"></a><a href="#l457">457</a><td> * Safari 3 (tested in 522)<tr><td><a id="l458"></a><a href="#l458">458</a><td> *<tr><td><a id="l459"></a><a href="#l459">459</a><td> * docEl.clientWidth  Width of viewport excluding scrollbar.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * docEl.clientHeight Height of viewport excluding scrollbar in strict mode.<tr><td><a id="l461"></a><a href="#l461">461</a><td> * body.clientHeight  Height of viewport excluding scrollbar in quirks mode.<tr><td><a id="l462"></a><a href="#l462">462</a><td> *<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @param {Window=} opt_window Optional window element to test.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @return {!goog.math.Size} Object with values &#39;width&#39; and &#39;height&#39;.<tr><td><a id="l465"></a><a href="#l465">465</a><td> */<tr><td><a id="l466"></a><a href="#l466">466</a><td>goog.dom.getViewportSize = function(opt_window) {<tr><td><a id="l467"></a><a href="#l467">467</a><td>  // TODO(arv): This should not take an argument<tr><td><a id="l468"></a><a href="#l468">468</a><td>  return goog.dom.getViewportSize_(opt_window || window);<tr><td><a id="l469"></a><a href="#l469">469</a><td>};<tr><td><a id="l470"></a><a href="#l470">470</a><td><tr><td><a id="l471"></a><a href="#l471">471</a><td><tr><td><a id="l472"></a><a href="#l472">472</a><td>/**<tr><td><a id="l473"></a><a href="#l473">473</a><td> * Helper for {@code getViewportSize}.<tr><td><a id="l474"></a><a href="#l474">474</a><td> * @param {Window} win The window to get the view port size for.<tr><td><a id="l475"></a><a href="#l475">475</a><td> * @return {!goog.math.Size} Object with values &#39;width&#39; and &#39;height&#39;.<tr><td><a id="l476"></a><a href="#l476">476</a><td> * @private<tr><td><a id="l477"></a><a href="#l477">477</a><td> */<tr><td><a id="l478"></a><a href="#l478">478</a><td>goog.dom.getViewportSize_ = function(win) {<tr><td><a id="l479"></a><a href="#l479">479</a><td>  var doc = win.document;<tr><td><a id="l480"></a><a href="#l480">480</a><td>  var el = goog.dom.isCss1CompatMode_(doc) ? doc.documentElement : doc.body;<tr><td><a id="l481"></a><a href="#l481">481</a><td>  return new goog.math.Size(el.clientWidth, el.clientHeight);<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> * Calculates the height of the document.<tr><td><a id="l487"></a><a href="#l487">487</a><td> *<tr><td><a id="l488"></a><a href="#l488">488</a><td> * @return {number} The height of the current document.<tr><td><a id="l489"></a><a href="#l489">489</a><td> */<tr><td><a id="l490"></a><a href="#l490">490</a><td>goog.dom.getDocumentHeight = function() {<tr><td><a id="l491"></a><a href="#l491">491</a><td>  return goog.dom.getDocumentHeight_(window);<tr><td><a id="l492"></a><a href="#l492">492</a><td>};<tr><td><a id="l493"></a><a href="#l493">493</a><td><tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td>/**<tr><td><a id="l496"></a><a href="#l496">496</a><td> * Calculates the height of the document of the given window.<tr><td><a id="l497"></a><a href="#l497">497</a><td> *<tr><td><a id="l498"></a><a href="#l498">498</a><td> * Function code copied from the opensocial gadget api:<tr><td><a id="l499"></a><a href="#l499">499</a><td> *   gadgets.window.adjustHeight(opt_height)<tr><td><a id="l500"></a><a href="#l500">500</a><td> *<tr><td><a id="l501"></a><a href="#l501">501</a><td> * @private<tr><td><a id="l502"></a><a href="#l502">502</a><td> * @param {!Window} win The window whose document height to retrieve.<tr><td><a id="l503"></a><a href="#l503">503</a><td> * @return {number} The height of the document of the given window.<tr><td><a id="l504"></a><a href="#l504">504</a><td> */<tr><td><a id="l505"></a><a href="#l505">505</a><td>goog.dom.getDocumentHeight_ = function(win) {<tr><td><a id="l506"></a><a href="#l506">506</a><td>  // NOTE(eae): This method will return the window size rather than the document<tr><td><a id="l507"></a><a href="#l507">507</a><td>  // size in webkit quirks mode.<tr><td><a id="l508"></a><a href="#l508">508</a><td>  var doc = win.document;<tr><td><a id="l509"></a><a href="#l509">509</a><td>  var height = 0;<tr><td><a id="l510"></a><a href="#l510">510</a><td><tr><td><a id="l511"></a><a href="#l511">511</a><td>  if (doc) {<tr><td><a id="l512"></a><a href="#l512">512</a><td>    // Calculating inner content height is hard and different between<tr><td><a id="l513"></a><a href="#l513">513</a><td>    // browsers rendering in Strict vs. Quirks mode.  We use a combination of<tr><td><a id="l514"></a><a href="#l514">514</a><td>    // three properties within document.body and document.documentElement:<tr><td><a id="l515"></a><a href="#l515">515</a><td>    // - scrollHeight<tr><td><a id="l516"></a><a href="#l516">516</a><td>    // - offsetHeight<tr><td><a id="l517"></a><a href="#l517">517</a><td>    // - clientHeight<tr><td><a id="l518"></a><a href="#l518">518</a><td>    // These values differ significantly between browsers and rendering modes.<tr><td><a id="l519"></a><a href="#l519">519</a><td>    // But there are patterns.  It just takes a lot of time and persistence<tr><td><a id="l520"></a><a href="#l520">520</a><td>    // to figure out.<tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td>    var body = doc.body;<tr><td><a id="l523"></a><a href="#l523">523</a><td>    var docEl = /** @type {!HTMLElement} */ (doc.documentElement);<tr><td><a id="l524"></a><a href="#l524">524</a><td>    if (!(docEl &amp;&amp; body)) {<tr><td><a id="l525"></a><a href="#l525">525</a><td>      return 0;<tr><td><a id="l526"></a><a href="#l526">526</a><td>    }<tr><td><a id="l527"></a><a href="#l527">527</a><td><tr><td><a id="l528"></a><a href="#l528">528</a><td>    // Get the height of the viewport<tr><td><a id="l529"></a><a href="#l529">529</a><td>    var vh = goog.dom.getViewportSize_(win).height;<tr><td><a id="l530"></a><a href="#l530">530</a><td>    if (goog.dom.isCss1CompatMode_(doc) &amp;&amp; docEl.scrollHeight) {<tr><td><a id="l531"></a><a href="#l531">531</a><td>      // In Strict mode:<tr><td><a id="l532"></a><a href="#l532">532</a><td>      // The inner content height is contained in either:<tr><td><a id="l533"></a><a href="#l533">533</a><td>      //    document.documentElement.scrollHeight<tr><td><a id="l534"></a><a href="#l534">534</a><td>      //    document.documentElement.offsetHeight<tr><td><a id="l535"></a><a href="#l535">535</a><td>      // Based on studying the values output by different browsers,<tr><td><a id="l536"></a><a href="#l536">536</a><td>      // use the value that&#39;s NOT equal to the viewport height found above.<tr><td><a id="l537"></a><a href="#l537">537</a><td>      height = docEl.scrollHeight != vh ?<tr><td><a id="l538"></a><a href="#l538">538</a><td>          docEl.scrollHeight : docEl.offsetHeight;<tr><td><a id="l539"></a><a href="#l539">539</a><td>    } else {<tr><td><a id="l540"></a><a href="#l540">540</a><td>      // In Quirks mode:<tr><td><a id="l541"></a><a href="#l541">541</a><td>      // documentElement.clientHeight is equal to documentElement.offsetHeight<tr><td><a id="l542"></a><a href="#l542">542</a><td>      // except in IE.  In most browsers, document.documentElement can be used<tr><td><a id="l543"></a><a href="#l543">543</a><td>      // to calculate the inner content height.<tr><td><a id="l544"></a><a href="#l544">544</a><td>      // However, in other browsers (e.g. IE), document.body must be used<tr><td><a id="l545"></a><a href="#l545">545</a><td>      // instead.  How do we know which one to use?<tr><td><a id="l546"></a><a href="#l546">546</a><td>      // If document.documentElement.clientHeight does NOT equal<tr><td><a id="l547"></a><a href="#l547">547</a><td>      // document.documentElement.offsetHeight, then use document.body.<tr><td><a id="l548"></a><a href="#l548">548</a><td>      var sh = docEl.scrollHeight;<tr><td><a id="l549"></a><a href="#l549">549</a><td>      var oh = docEl.offsetHeight;<tr><td><a id="l550"></a><a href="#l550">550</a><td>      if (docEl.clientHeight != oh) {<tr><td><a id="l551"></a><a href="#l551">551</a><td>        sh = body.scrollHeight;<tr><td><a id="l552"></a><a href="#l552">552</a><td>        oh = body.offsetHeight;<tr><td><a id="l553"></a><a href="#l553">553</a><td>      }<tr><td><a id="l554"></a><a href="#l554">554</a><td><tr><td><a id="l555"></a><a href="#l555">555</a><td>      // Detect whether the inner content height is bigger or smaller<tr><td><a id="l556"></a><a href="#l556">556</a><td>      // than the bounding box (viewport).  If bigger, take the larger<tr><td><a id="l557"></a><a href="#l557">557</a><td>      // value.  If smaller, take the smaller value.<tr><td><a id="l558"></a><a href="#l558">558</a><td>      if (sh &gt; vh) {<tr><td><a id="l559"></a><a href="#l559">559</a><td>        // Content is larger<tr><td><a id="l560"></a><a href="#l560">560</a><td>        height = sh &gt; oh ? sh : oh;<tr><td><a id="l561"></a><a href="#l561">561</a><td>      } else {<tr><td><a id="l562"></a><a href="#l562">562</a><td>        // Content is smaller<tr><td><a id="l563"></a><a href="#l563">563</a><td>        height = sh &lt; oh ? sh : oh;<tr><td><a id="l564"></a><a href="#l564">564</a><td>      }<tr><td><a id="l565"></a><a href="#l565">565</a><td>    }<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>  return height;<tr><td><a id="l569"></a><a href="#l569">569</a><td>};<tr><td><a id="l570"></a><a href="#l570">570</a><td><tr><td><a id="l571"></a><a href="#l571">571</a><td><tr><td><a id="l572"></a><a href="#l572">572</a><td>/**<tr><td><a id="l573"></a><a href="#l573">573</a><td> * Gets the page scroll distance as a coordinate object.<tr><td><a id="l574"></a><a href="#l574">574</a><td> *<tr><td><a id="l575"></a><a href="#l575">575</a><td> * @param {Window=} opt_window Optional window element to test.<tr><td><a id="l576"></a><a href="#l576">576</a><td> * @return {!goog.math.Coordinate} Object with values &#39;x&#39; and &#39;y&#39;.<tr><td><a id="l577"></a><a href="#l577">577</a><td> * @deprecated Use {@link goog.dom.getDocumentScroll} instead.<tr><td><a id="l578"></a><a href="#l578">578</a><td> */<tr><td><a id="l579"></a><a href="#l579">579</a><td>goog.dom.getPageScroll = function(opt_window) {<tr><td><a id="l580"></a><a href="#l580">580</a><td>  var win = opt_window || goog.global || window;<tr><td><a id="l581"></a><a href="#l581">581</a><td>  return goog.dom.getDomHelper(win.document).getDocumentScroll();<tr><td><a id="l582"></a><a href="#l582">582</a><td>};<tr><td><a id="l583"></a><a href="#l583">583</a><td><tr><td><a id="l584"></a><a href="#l584">584</a><td><tr><td><a id="l585"></a><a href="#l585">585</a><td>/**<tr><td><a id="l586"></a><a href="#l586">586</a><td> * Gets the document scroll distance as a coordinate object.<tr><td><a id="l587"></a><a href="#l587">587</a><td> *<tr><td><a id="l588"></a><a href="#l588">588</a><td> * @return {!goog.math.Coordinate} Object with values &#39;x&#39; and &#39;y&#39;.<tr><td><a id="l589"></a><a href="#l589">589</a><td> */<tr><td><a id="l590"></a><a href="#l590">590</a><td>goog.dom.getDocumentScroll = function() {<tr><td><a id="l591"></a><a href="#l591">591</a><td>  return goog.dom.getDocumentScroll_(document);<tr><td><a id="l592"></a><a href="#l592">592</a><td>};<tr><td><a id="l593"></a><a href="#l593">593</a><td><tr><td><a id="l594"></a><a href="#l594">594</a><td><tr><td><a id="l595"></a><a href="#l595">595</a><td>/**<tr><td><a id="l596"></a><a href="#l596">596</a><td> * Helper for {@code getDocumentScroll}.<tr><td><a id="l597"></a><a href="#l597">597</a><td> *<tr><td><a id="l598"></a><a href="#l598">598</a><td> * @param {!Document} doc The document to get the scroll for.<tr><td><a id="l599"></a><a href="#l599">599</a><td> * @return {!goog.math.Coordinate} Object with values &#39;x&#39; and &#39;y&#39;.<tr><td><a id="l600"></a><a href="#l600">600</a><td> * @private<tr><td><a id="l601"></a><a href="#l601">601</a><td> */<tr><td><a id="l602"></a><a href="#l602">602</a><td>goog.dom.getDocumentScroll_ = function(doc) {<tr><td><a id="l603"></a><a href="#l603">603</a><td>  var el = goog.dom.getDocumentScrollElement_(doc);<tr><td><a id="l604"></a><a href="#l604">604</a><td>  var win = goog.dom.getWindow_(doc);<tr><td><a id="l605"></a><a href="#l605">605</a><td>  if (goog.userAgent.IE &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;10&#39;) &amp;&amp;<tr><td><a id="l606"></a><a href="#l606">606</a><td>      win.pageYOffset != el.scrollTop) {<tr><td><a id="l607"></a><a href="#l607">607</a><td>    // The keyboard on IE10 touch devices shifts the page using the pageYOffset<tr><td><a id="l608"></a><a href="#l608">608</a><td>    // without modifying scrollTop. For this case, we want the body scroll<tr><td><a id="l609"></a><a href="#l609">609</a><td>    // offsets.<tr><td><a id="l610"></a><a href="#l610">610</a><td>    return new goog.math.Coordinate(el.scrollLeft, el.scrollTop);<tr><td><a id="l611"></a><a href="#l611">611</a><td>  }<tr><td><a id="l612"></a><a href="#l612">612</a><td>  return new goog.math.Coordinate(win.pageXOffset || el.scrollLeft,<tr><td><a id="l613"></a><a href="#l613">613</a><td>      win.pageYOffset || el.scrollTop);<tr><td><a id="l614"></a><a href="#l614">614</a><td>};<tr><td><a id="l615"></a><a href="#l615">615</a><td><tr><td><a id="l616"></a><a href="#l616">616</a><td><tr><td><a id="l617"></a><a href="#l617">617</a><td>/**<tr><td><a id="l618"></a><a href="#l618">618</a><td> * Gets the document scroll element.<tr><td><a id="l619"></a><a href="#l619">619</a><td> * @return {!Element} Scrolling element.<tr><td><a id="l620"></a><a href="#l620">620</a><td> */<tr><td><a id="l621"></a><a href="#l621">621</a><td>goog.dom.getDocumentScrollElement = function() {<tr><td><a id="l622"></a><a href="#l622">622</a><td>  return goog.dom.getDocumentScrollElement_(document);<tr><td><a id="l623"></a><a href="#l623">623</a><td>};<tr><td><a id="l624"></a><a href="#l624">624</a><td><tr><td><a id="l625"></a><a href="#l625">625</a><td><tr><td><a id="l626"></a><a href="#l626">626</a><td>/**<tr><td><a id="l627"></a><a href="#l627">627</a><td> * Helper for {@code getDocumentScrollElement}.<tr><td><a id="l628"></a><a href="#l628">628</a><td> * @param {!Document} doc The document to get the scroll element for.<tr><td><a id="l629"></a><a href="#l629">629</a><td> * @return {!Element} Scrolling element.<tr><td><a id="l630"></a><a href="#l630">630</a><td> * @private<tr><td><a id="l631"></a><a href="#l631">631</a><td> */<tr><td><a id="l632"></a><a href="#l632">632</a><td>goog.dom.getDocumentScrollElement_ = function(doc) {<tr><td><a id="l633"></a><a href="#l633">633</a><td>  // Old WebKit needs body.scrollLeft in both quirks mode and strict mode. We<tr><td><a id="l634"></a><a href="#l634">634</a><td>  // also default to the documentElement if the document does not have a body<tr><td><a id="l635"></a><a href="#l635">635</a><td>  // (e.g. a SVG document).<tr><td><a id="l636"></a><a href="#l636">636</a><td>  // Uses http://dev.w3.org/csswg/cssom-view/#dom-document-scrollingelement to<tr><td><a id="l637"></a><a href="#l637">637</a><td>  // avoid trying to guess about browser behavior from the UA string.<tr><td><a id="l638"></a><a href="#l638">638</a><td>  if (doc.scrollingElement) {<tr><td><a id="l639"></a><a href="#l639">639</a><td>    return doc.scrollingElement;<tr><td><a id="l640"></a><a href="#l640">640</a><td>  }<tr><td><a id="l641"></a><a href="#l641">641</a><td>  if (!goog.userAgent.WEBKIT &amp;&amp; goog.dom.isCss1CompatMode_(doc)) {<tr><td><a id="l642"></a><a href="#l642">642</a><td>    return doc.documentElement;<tr><td><a id="l643"></a><a href="#l643">643</a><td>  }<tr><td><a id="l644"></a><a href="#l644">644</a><td>  return doc.body || doc.documentElement;<tr><td><a id="l645"></a><a href="#l645">645</a><td>};<tr><td><a id="l646"></a><a href="#l646">646</a><td><tr><td><a id="l647"></a><a href="#l647">647</a><td><tr><td><a id="l648"></a><a href="#l648">648</a><td>/**<tr><td><a id="l649"></a><a href="#l649">649</a><td> * Gets the window object associated with the given document.<tr><td><a id="l650"></a><a href="#l650">650</a><td> *<tr><td><a id="l651"></a><a href="#l651">651</a><td> * @param {Document=} opt_doc  Document object to get window for.<tr><td><a id="l652"></a><a href="#l652">652</a><td> * @return {!Window} The window associated with the given document.<tr><td><a id="l653"></a><a href="#l653">653</a><td> */<tr><td><a id="l654"></a><a href="#l654">654</a><td>goog.dom.getWindow = function(opt_doc) {<tr><td><a id="l655"></a><a href="#l655">655</a><td>  // TODO(arv): This should not take an argument.<tr><td><a id="l656"></a><a href="#l656">656</a><td>  return opt_doc ? goog.dom.getWindow_(opt_doc) : window;<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><tr><td><a id="l660"></a><a href="#l660">660</a><td>/**<tr><td><a id="l661"></a><a href="#l661">661</a><td> * Helper for {@code getWindow}.<tr><td><a id="l662"></a><a href="#l662">662</a><td> *<tr><td><a id="l663"></a><a href="#l663">663</a><td> * @param {!Document} doc  Document object to get window for.<tr><td><a id="l664"></a><a href="#l664">664</a><td> * @return {!Window} The window associated with the given document.<tr><td><a id="l665"></a><a href="#l665">665</a><td> * @private<tr><td><a id="l666"></a><a href="#l666">666</a><td> */<tr><td><a id="l667"></a><a href="#l667">667</a><td>goog.dom.getWindow_ = function(doc) {<tr><td><a id="l668"></a><a href="#l668">668</a><td>  return doc.parentWindow || doc.defaultView;<tr><td><a id="l669"></a><a href="#l669">669</a><td>};<tr><td><a id="l670"></a><a href="#l670">670</a><td><tr><td><a id="l671"></a><a href="#l671">671</a><td><tr><td><a id="l672"></a><a href="#l672">672</a><td>/**<tr><td><a id="l673"></a><a href="#l673">673</a><td> * Returns a dom node with a set of attributes.  This function accepts varargs<tr><td><a id="l674"></a><a href="#l674">674</a><td> * for subsequent nodes to be added.  Subsequent nodes will be added to the<tr><td><a id="l675"></a><a href="#l675">675</a><td> * first node as childNodes.<tr><td><a id="l676"></a><a href="#l676">676</a><td> *<tr><td><a id="l677"></a><a href="#l677">677</a><td> * So:<tr><td><a id="l678"></a><a href="#l678">678</a><td> * &lt;code&gt;createDom(&#39;div&#39;, null, createDom(&#39;p&#39;), createDom(&#39;p&#39;));&lt;/code&gt;<tr><td><a id="l679"></a><a href="#l679">679</a><td> * would return a div with two child paragraphs<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 {string} tagName Tag to create.<tr><td><a id="l682"></a><a href="#l682">682</a><td> * @param {(Object|Array&lt;string&gt;|string)=} opt_attributes If object, then a map<tr><td><a id="l683"></a><a href="#l683">683</a><td> *     of name-value pairs for attributes. If a string, then this is the<tr><td><a id="l684"></a><a href="#l684">684</a><td> *     className of the new element. If an array, the elements will be joined<tr><td><a id="l685"></a><a href="#l685">685</a><td> *     together as the className of the new element.<tr><td><a id="l686"></a><a href="#l686">686</a><td> * @param {...(Object|string|Array|NodeList)} var_args Further DOM nodes or<tr><td><a id="l687"></a><a href="#l687">687</a><td> *     strings for text nodes. If one of the var_args is an array or NodeList,<tr><td><a id="l688"></a><a href="#l688">688</a><td> *     its elements will be added as childNodes instead.<tr><td><a id="l689"></a><a href="#l689">689</a><td> * @return {!Element} Reference to a DOM node.<tr><td><a id="l690"></a><a href="#l690">690</a><td> */<tr><td><a id="l691"></a><a href="#l691">691</a><td>goog.dom.createDom = function(tagName, opt_attributes, var_args) {<tr><td><a id="l692"></a><a href="#l692">692</a><td>  return goog.dom.createDom_(document, arguments);<tr><td><a id="l693"></a><a href="#l693">693</a><td>};<tr><td><a id="l694"></a><a href="#l694">694</a><td><tr><td><a id="l695"></a><a href="#l695">695</a><td><tr><td><a id="l696"></a><a href="#l696">696</a><td>/**<tr><td><a id="l697"></a><a href="#l697">697</a><td> * Helper for {@code createDom}.<tr><td><a id="l698"></a><a href="#l698">698</a><td> * @param {!Document} doc The document to create the DOM in.<tr><td><a id="l699"></a><a href="#l699">699</a><td> * @param {!Arguments} args Argument object passed from the callers. See<tr><td><a id="l700"></a><a href="#l700">700</a><td> *     {@code goog.dom.createDom} for details.<tr><td><a id="l701"></a><a href="#l701">701</a><td> * @return {!Element} Reference to a DOM node.<tr><td><a id="l702"></a><a href="#l702">702</a><td> * @private<tr><td><a id="l703"></a><a href="#l703">703</a><td> */<tr><td><a id="l704"></a><a href="#l704">704</a><td>goog.dom.createDom_ = function(doc, args) {<tr><td><a id="l705"></a><a href="#l705">705</a><td>  var tagName = args[0];<tr><td><a id="l706"></a><a href="#l706">706</a><td>  var attributes = args[1];<tr><td><a id="l707"></a><a href="#l707">707</a><td><tr><td><a id="l708"></a><a href="#l708">708</a><td>  // Internet Explorer is dumb:<tr><td><a id="l709"></a><a href="#l709">709</a><td>  // name: https://msdn.microsoft.com/en-us/library/ms534184(v=vs.85).aspx<tr><td><a id="l710"></a><a href="#l710">710</a><td>  // type: https://msdn.microsoft.com/en-us/library/ms534700(v=vs.85).aspx<tr><td><a id="l711"></a><a href="#l711">711</a><td>  // Also does not allow setting of &#39;type&#39; attribute on &#39;input&#39; or &#39;button&#39;.<tr><td><a id="l712"></a><a href="#l712">712</a><td>  if (!goog.dom.BrowserFeature.CAN_ADD_NAME_OR_TYPE_ATTRIBUTES &amp;&amp; attributes &amp;&amp;<tr><td><a id="l713"></a><a href="#l713">713</a><td>      (attributes.name || attributes.type)) {<tr><td><a id="l714"></a><a href="#l714">714</a><td>    var tagNameArr = [&#39;&lt;&#39;, tagName];<tr><td><a id="l715"></a><a href="#l715">715</a><td>    if (attributes.name) {<tr><td><a id="l716"></a><a href="#l716">716</a><td>      tagNameArr.push(&#39; name=&quot;&#39;, goog.string.htmlEscape(attributes.name), &#39;&quot;&#39;);<tr><td><a id="l717"></a><a href="#l717">717</a><td>    }<tr><td><a id="l718"></a><a href="#l718">718</a><td>    if (attributes.type) {<tr><td><a id="l719"></a><a href="#l719">719</a><td>      tagNameArr.push(&#39; type=&quot;&#39;, goog.string.htmlEscape(attributes.type), &#39;&quot;&#39;);<tr><td><a id="l720"></a><a href="#l720">720</a><td><tr><td><a id="l721"></a><a href="#l721">721</a><td>      // Clone attributes map to remove &#39;type&#39; without mutating the input.<tr><td><a id="l722"></a><a href="#l722">722</a><td>      var clone = {};<tr><td><a id="l723"></a><a href="#l723">723</a><td>      goog.object.extend(clone, attributes);<tr><td><a id="l724"></a><a href="#l724">724</a><td><tr><td><a id="l725"></a><a href="#l725">725</a><td>      // JSCompiler can&#39;t see how goog.object.extend added this property,<tr><td><a id="l726"></a><a href="#l726">726</a><td>      // because it was essentially added by reflection.<tr><td><a id="l727"></a><a href="#l727">727</a><td>      // So it needs to be quoted.<tr><td><a id="l728"></a><a href="#l728">728</a><td>      delete clone[&#39;type&#39;];<tr><td><a id="l729"></a><a href="#l729">729</a><td><tr><td><a id="l730"></a><a href="#l730">730</a><td>      attributes = clone;<tr><td><a id="l731"></a><a href="#l731">731</a><td>    }<tr><td><a id="l732"></a><a href="#l732">732</a><td>    tagNameArr.push(&#39;&gt;&#39;);<tr><td><a id="l733"></a><a href="#l733">733</a><td>    tagName = tagNameArr.join(&#39;&#39;);<tr><td><a id="l734"></a><a href="#l734">734</a><td>  }<tr><td><a id="l735"></a><a href="#l735">735</a><td><tr><td><a id="l736"></a><a href="#l736">736</a><td>  var element = doc.createElement(tagName);<tr><td><a id="l737"></a><a href="#l737">737</a><td><tr><td><a id="l738"></a><a href="#l738">738</a><td>  if (attributes) {<tr><td><a id="l739"></a><a href="#l739">739</a><td>    if (goog.isString(attributes)) {<tr><td><a id="l740"></a><a href="#l740">740</a><td>      element.className = attributes;<tr><td><a id="l741"></a><a href="#l741">741</a><td>    } else if (goog.isArray(attributes)) {<tr><td><a id="l742"></a><a href="#l742">742</a><td>      element.className = attributes.join(&#39; &#39;);<tr><td><a id="l743"></a><a href="#l743">743</a><td>    } else {<tr><td><a id="l744"></a><a href="#l744">744</a><td>      goog.dom.setProperties(element, attributes);<tr><td><a id="l745"></a><a href="#l745">745</a><td>    }<tr><td><a id="l746"></a><a href="#l746">746</a><td>  }<tr><td><a id="l747"></a><a href="#l747">747</a><td><tr><td><a id="l748"></a><a href="#l748">748</a><td>  if (args.length &gt; 2) {<tr><td><a id="l749"></a><a href="#l749">749</a><td>    goog.dom.append_(doc, element, args, 2);<tr><td><a id="l750"></a><a href="#l750">750</a><td>  }<tr><td><a id="l751"></a><a href="#l751">751</a><td><tr><td><a id="l752"></a><a href="#l752">752</a><td>  return element;<tr><td><a id="l753"></a><a href="#l753">753</a><td>};<tr><td><a id="l754"></a><a href="#l754">754</a><td><tr><td><a id="l755"></a><a href="#l755">755</a><td><tr><td><a id="l756"></a><a href="#l756">756</a><td>/**<tr><td><a id="l757"></a><a href="#l757">757</a><td> * Appends a node with text or other nodes.<tr><td><a id="l758"></a><a href="#l758">758</a><td> * @param {!Document} doc The document to create new nodes in.<tr><td><a id="l759"></a><a href="#l759">759</a><td> * @param {!Node} parent The node to append nodes to.<tr><td><a id="l760"></a><a href="#l760">760</a><td> * @param {!Arguments} args The values to add. See {@code goog.dom.append}.<tr><td><a id="l761"></a><a href="#l761">761</a><td> * @param {number} startIndex The index of the array to start from.<tr><td><a id="l762"></a><a href="#l762">762</a><td> * @private<tr><td><a id="l763"></a><a href="#l763">763</a><td> */<tr><td><a id="l764"></a><a href="#l764">764</a><td>goog.dom.append_ = function(doc, parent, args, startIndex) {<tr><td><a id="l765"></a><a href="#l765">765</a><td>  function childHandler(child) {<tr><td><a id="l766"></a><a href="#l766">766</a><td>    // TODO(user): More coercion, ala MochiKit?<tr><td><a id="l767"></a><a href="#l767">767</a><td>    if (child) {<tr><td><a id="l768"></a><a href="#l768">768</a><td>      parent.appendChild(goog.isString(child) ?<tr><td><a id="l769"></a><a href="#l769">769</a><td>          doc.createTextNode(child) : child);<tr><td><a id="l770"></a><a href="#l770">770</a><td>    }<tr><td><a id="l771"></a><a href="#l771">771</a><td>  }<tr><td><a id="l772"></a><a href="#l772">772</a><td><tr><td><a id="l773"></a><a href="#l773">773</a><td>  for (var i = startIndex; i &lt; args.length; i++) {<tr><td><a id="l774"></a><a href="#l774">774</a><td>    var arg = args[i];<tr><td><a id="l775"></a><a href="#l775">775</a><td>    // TODO(attila): Fix isArrayLike to return false for a text node.<tr><td><a id="l776"></a><a href="#l776">776</a><td>    if (goog.isArrayLike(arg) &amp;&amp; !goog.dom.isNodeLike(arg)) {<tr><td><a id="l777"></a><a href="#l777">777</a><td>      // If the argument is a node list, not a real array, use a clone,<tr><td><a id="l778"></a><a href="#l778">778</a><td>      // because forEach can&#39;t be used to mutate a NodeList.<tr><td><a id="l779"></a><a href="#l779">779</a><td>      goog.array.forEach(goog.dom.isNodeList(arg) ?<tr><td><a id="l780"></a><a href="#l780">780</a><td>          goog.array.toArray(arg) : arg,<tr><td><a id="l781"></a><a href="#l781">781</a><td>          childHandler);<tr><td><a id="l782"></a><a href="#l782">782</a><td>    } else {<tr><td><a id="l783"></a><a href="#l783">783</a><td>      childHandler(arg);<tr><td><a id="l784"></a><a href="#l784">784</a><td>    }<tr><td><a id="l785"></a><a href="#l785">785</a><td>  }<tr><td><a id="l786"></a><a href="#l786">786</a><td>};<tr><td><a id="l787"></a><a href="#l787">787</a><td><tr><td><a id="l788"></a><a href="#l788">788</a><td><tr><td><a id="l789"></a><a href="#l789">789</a><td>/**<tr><td><a id="l790"></a><a href="#l790">790</a><td> * Alias for {@code createDom}.<tr><td><a id="l791"></a><a href="#l791">791</a><td> * @param {string} tagName Tag to create.<tr><td><a id="l792"></a><a href="#l792">792</a><td> * @param {(string|Object)=} opt_attributes If object, then a map of name-value<tr><td><a id="l793"></a><a href="#l793">793</a><td> *     pairs for attributes. If a string, then this is the className of the new<tr><td><a id="l794"></a><a href="#l794">794</a><td> *     element.<tr><td><a id="l795"></a><a href="#l795">795</a><td> * @param {...(Object|string|Array|NodeList)} var_args Further DOM nodes or<tr><td><a id="l796"></a><a href="#l796">796</a><td> *     strings for text nodes. If one of the var_args is an array, its<tr><td><a id="l797"></a><a href="#l797">797</a><td> *     children will be added as childNodes instead.<tr><td><a id="l798"></a><a href="#l798">798</a><td> * @return {!Element} Reference to a DOM node.<tr><td><a id="l799"></a><a href="#l799">799</a><td> * @deprecated Use {@link goog.dom.createDom} instead.<tr><td><a id="l800"></a><a href="#l800">800</a><td> */<tr><td><a id="l801"></a><a href="#l801">801</a><td>goog.dom.$dom = goog.dom.createDom;<tr><td><a id="l802"></a><a href="#l802">802</a><td><tr><td><a id="l803"></a><a href="#l803">803</a><td><tr><td><a id="l804"></a><a href="#l804">804</a><td>/**<tr><td><a id="l805"></a><a href="#l805">805</a><td> * Creates a new element.<tr><td><a id="l806"></a><a href="#l806">806</a><td> * @param {string} name Tag name.<tr><td><a id="l807"></a><a href="#l807">807</a><td> * @return {!Element} The new element.<tr><td><a id="l808"></a><a href="#l808">808</a><td> */<tr><td><a id="l809"></a><a href="#l809">809</a><td>goog.dom.createElement = function(name) {<tr><td><a id="l810"></a><a href="#l810">810</a><td>  return document.createElement(name);<tr><td><a id="l811"></a><a href="#l811">811</a><td>};<tr><td><a id="l812"></a><a href="#l812">812</a><td><tr><td><a id="l813"></a><a href="#l813">813</a><td><tr><td><a id="l814"></a><a href="#l814">814</a><td>/**<tr><td><a id="l815"></a><a href="#l815">815</a><td> * Creates a new text node.<tr><td><a id="l816"></a><a href="#l816">816</a><td> * @param {number|string} content Content.<tr><td><a id="l817"></a><a href="#l817">817</a><td> * @return {!Text} The new text node.<tr><td><a id="l818"></a><a href="#l818">818</a><td> */<tr><td><a id="l819"></a><a href="#l819">819</a><td>goog.dom.createTextNode = function(content) {<tr><td><a id="l820"></a><a href="#l820">820</a><td>  return document.createTextNode(String(content));<tr><td><a id="l821"></a><a href="#l821">821</a><td>};<tr><td><a id="l822"></a><a href="#l822">822</a><td><tr><td><a id="l823"></a><a href="#l823">823</a><td><tr><td><a id="l824"></a><a href="#l824">824</a><td>/**<tr><td><a id="l825"></a><a href="#l825">825</a><td> * Create a table.<tr><td><a id="l826"></a><a href="#l826">826</a><td> * @param {number} rows The number of rows in the table.  Must be &gt;= 1.<tr><td><a id="l827"></a><a href="#l827">827</a><td> * @param {number} columns The number of columns in the table.  Must be &gt;= 1.<tr><td><a id="l828"></a><a href="#l828">828</a><td> * @param {boolean=} opt_fillWithNbsp If true, fills table entries with<tr><td><a id="l829"></a><a href="#l829">829</a><td> *     {@code goog.string.Unicode.NBSP} characters.<tr><td><a id="l830"></a><a href="#l830">830</a><td> * @return {!Element} The created table.<tr><td><a id="l831"></a><a href="#l831">831</a><td> */<tr><td><a id="l832"></a><a href="#l832">832</a><td>goog.dom.createTable = function(rows, columns, opt_fillWithNbsp) {<tr><td><a id="l833"></a><a href="#l833">833</a><td>  // TODO(user): Return HTMLTableElement, also in prototype function.<tr><td><a id="l834"></a><a href="#l834">834</a><td>  // Callers need to be updated to e.g. not assign numbers to table.cellSpacing.<tr><td><a id="l835"></a><a href="#l835">835</a><td>  return goog.dom.createTable_(document, rows, columns, !!opt_fillWithNbsp);<tr><td><a id="l836"></a><a href="#l836">836</a><td>};<tr><td><a id="l837"></a><a href="#l837">837</a><td><tr><td><a id="l838"></a><a href="#l838">838</a><td><tr><td><a id="l839"></a><a href="#l839">839</a><td>/**<tr><td><a id="l840"></a><a href="#l840">840</a><td> * Create a table.<tr><td><a id="l841"></a><a href="#l841">841</a><td> * @param {!Document} doc Document object to use to create the table.<tr><td><a id="l842"></a><a href="#l842">842</a><td> * @param {number} rows The number of rows in the table.  Must be &gt;= 1.<tr><td><a id="l843"></a><a href="#l843">843</a><td> * @param {number} columns The number of columns in the table.  Must be &gt;= 1.<tr><td><a id="l844"></a><a href="#l844">844</a><td> * @param {boolean} fillWithNbsp If true, fills table entries with<tr><td><a id="l845"></a><a href="#l845">845</a><td> *     {@code goog.string.Unicode.NBSP} characters.<tr><td><a id="l846"></a><a href="#l846">846</a><td> * @return {!HTMLTableElement} The created table.<tr><td><a id="l847"></a><a href="#l847">847</a><td> * @private<tr><td><a id="l848"></a><a href="#l848">848</a><td> */<tr><td><a id="l849"></a><a href="#l849">849</a><td>goog.dom.createTable_ = function(doc, rows, columns, fillWithNbsp) {<tr><td><a id="l850"></a><a href="#l850">850</a><td>  var table = /** @type {!HTMLTableElement} */<tr><td><a id="l851"></a><a href="#l851">851</a><td>      (doc.createElement(goog.dom.TagName.TABLE));<tr><td><a id="l852"></a><a href="#l852">852</a><td>  var tbody = table.appendChild(doc.createElement(goog.dom.TagName.TBODY));<tr><td><a id="l853"></a><a href="#l853">853</a><td>  for (var i = 0; i &lt; rows; i++) {<tr><td><a id="l854"></a><a href="#l854">854</a><td>    var tr = doc.createElement(goog.dom.TagName.TR);<tr><td><a id="l855"></a><a href="#l855">855</a><td>    for (var j = 0; j &lt; columns; j++) {<tr><td><a id="l856"></a><a href="#l856">856</a><td>      var td = doc.createElement(goog.dom.TagName.TD);<tr><td><a id="l857"></a><a href="#l857">857</a><td>      // IE &lt;= 9 will create a text node if we set text content to the empty<tr><td><a id="l858"></a><a href="#l858">858</a><td>      // string, so we avoid doing it unless necessary. This ensures that the<tr><td><a id="l859"></a><a href="#l859">859</a><td>      // same DOM tree is returned on all browsers.<tr><td><a id="l860"></a><a href="#l860">860</a><td>      if (fillWithNbsp) {<tr><td><a id="l861"></a><a href="#l861">861</a><td>        goog.dom.setTextContent(td, goog.string.Unicode.NBSP);<tr><td><a id="l862"></a><a href="#l862">862</a><td>      }<tr><td><a id="l863"></a><a href="#l863">863</a><td>      tr.appendChild(td);<tr><td><a id="l864"></a><a href="#l864">864</a><td>    }<tr><td><a id="l865"></a><a href="#l865">865</a><td>    tbody.appendChild(tr);<tr><td><a id="l866"></a><a href="#l866">866</a><td>  }<tr><td><a id="l867"></a><a href="#l867">867</a><td>  return table;<tr><td><a id="l868"></a><a href="#l868">868</a><td>};<tr><td><a id="l869"></a><a href="#l869">869</a><td><tr><td><a id="l870"></a><a href="#l870">870</a><td><tr><td><a id="l871"></a><a href="#l871">871</a><td>/**<tr><td><a id="l872"></a><a href="#l872">872</a><td> * Converts HTML markup into a node.<tr><td><a id="l873"></a><a href="#l873">873</a><td> * @param {!goog.html.SafeHtml} html The HTML markup to convert.<tr><td><a id="l874"></a><a href="#l874">874</a><td> * @return {!Node} The resulting node.<tr><td><a id="l875"></a><a href="#l875">875</a><td> */<tr><td><a id="l876"></a><a href="#l876">876</a><td>goog.dom.safeHtmlToNode = function(html) {<tr><td><a id="l877"></a><a href="#l877">877</a><td>  return goog.dom.safeHtmlToNode_(document, html);<tr><td><a id="l878"></a><a href="#l878">878</a><td>};<tr><td><a id="l879"></a><a href="#l879">879</a><td><tr><td><a id="l880"></a><a href="#l880">880</a><td><tr><td><a id="l881"></a><a href="#l881">881</a><td>/**<tr><td><a id="l882"></a><a href="#l882">882</a><td> * Helper for {@code safeHtmlToNode}.<tr><td><a id="l883"></a><a href="#l883">883</a><td> * @param {!Document} doc The document.<tr><td><a id="l884"></a><a href="#l884">884</a><td> * @param {!goog.html.SafeHtml} html The HTML markup to convert.<tr><td><a id="l885"></a><a href="#l885">885</a><td> * @return {!Node} The resulting node.<tr><td><a id="l886"></a><a href="#l886">886</a><td> * @private<tr><td><a id="l887"></a><a href="#l887">887</a><td> */<tr><td><a id="l888"></a><a href="#l888">888</a><td>goog.dom.safeHtmlToNode_ = function(doc, html) {<tr><td><a id="l889"></a><a href="#l889">889</a><td>  var tempDiv = doc.createElement(goog.dom.TagName.DIV);<tr><td><a id="l890"></a><a href="#l890">890</a><td>  if (goog.dom.BrowserFeature.INNER_HTML_NEEDS_SCOPED_ELEMENT) {<tr><td><a id="l891"></a><a href="#l891">891</a><td>    goog.dom.safe.setInnerHtml(tempDiv,<tr><td><a id="l892"></a><a href="#l892">892</a><td>        goog.html.SafeHtml.concat(goog.html.SafeHtml.create(&#39;br&#39;), html));<tr><td><a id="l893"></a><a href="#l893">893</a><td>    tempDiv.removeChild(tempDiv.firstChild);<tr><td><a id="l894"></a><a href="#l894">894</a><td>  } else {<tr><td><a id="l895"></a><a href="#l895">895</a><td>    goog.dom.safe.setInnerHtml(tempDiv, html);<tr><td><a id="l896"></a><a href="#l896">896</a><td>  }<tr><td><a id="l897"></a><a href="#l897">897</a><td>  return goog.dom.childrenToNode_(doc, tempDiv);<tr><td><a id="l898"></a><a href="#l898">898</a><td>};<tr><td><a id="l899"></a><a href="#l899">899</a><td><tr><td><a id="l900"></a><a href="#l900">900</a><td><tr><td><a id="l901"></a><a href="#l901">901</a><td>/**<tr><td><a id="l902"></a><a href="#l902">902</a><td> * Converts an HTML string into a document fragment. The string must be<tr><td><a id="l903"></a><a href="#l903">903</a><td> * sanitized in order to avoid cross-site scripting. For example<tr><td><a id="l904"></a><a href="#l904">904</a><td> * {@code goog.dom.htmlToDocumentFragment(&#39;&amp;lt;img src=x onerror=alert(0)&amp;gt;&#39;)}<tr><td><a id="l905"></a><a href="#l905">905</a><td> * triggers an alert in all browsers, even if the returned document fragment<tr><td><a id="l906"></a><a href="#l906">906</a><td> * is thrown away immediately.<tr><td><a id="l907"></a><a href="#l907">907</a><td> *<tr><td><a id="l908"></a><a href="#l908">908</a><td> * NOTE: This method doesn&#39;t work if your htmlString contains elements that<tr><td><a id="l909"></a><a href="#l909">909</a><td> * can&#39;t be contained in a &lt;div&gt;. For example, &lt;tr&gt;.<tr><td><a id="l910"></a><a href="#l910">910</a><td> *<tr><td><a id="l911"></a><a href="#l911">911</a><td> * @param {string} htmlString The HTML string to convert.<tr><td><a id="l912"></a><a href="#l912">912</a><td> * @return {!Node} The resulting document fragment.<tr><td><a id="l913"></a><a href="#l913">913</a><td> */<tr><td><a id="l914"></a><a href="#l914">914</a><td>goog.dom.htmlToDocumentFragment = function(htmlString) {<tr><td><a id="l915"></a><a href="#l915">915</a><td>  return goog.dom.htmlToDocumentFragment_(document, htmlString);<tr><td><a id="l916"></a><a href="#l916">916</a><td>};<tr><td><a id="l917"></a><a href="#l917">917</a><td><tr><td><a id="l918"></a><a href="#l918">918</a><td><tr><td><a id="l919"></a><a href="#l919">919</a><td>// TODO(jakubvrana): Merge with {@code safeHtmlToNode_}.<tr><td><a id="l920"></a><a href="#l920">920</a><td>/**<tr><td><a id="l921"></a><a href="#l921">921</a><td> * Helper for {@code htmlToDocumentFragment}.<tr><td><a id="l922"></a><a href="#l922">922</a><td> *<tr><td><a id="l923"></a><a href="#l923">923</a><td> * @param {!Document} doc The document.<tr><td><a id="l924"></a><a href="#l924">924</a><td> * @param {string} htmlString The HTML string to convert.<tr><td><a id="l925"></a><a href="#l925">925</a><td> * @return {!Node} The resulting document fragment.<tr><td><a id="l926"></a><a href="#l926">926</a><td> * @private<tr><td><a id="l927"></a><a href="#l927">927</a><td> */<tr><td><a id="l928"></a><a href="#l928">928</a><td>goog.dom.htmlToDocumentFragment_ = function(doc, htmlString) {<tr><td><a id="l929"></a><a href="#l929">929</a><td>  var tempDiv = doc.createElement(goog.dom.TagName.DIV);<tr><td><a id="l930"></a><a href="#l930">930</a><td>  if (goog.dom.BrowserFeature.INNER_HTML_NEEDS_SCOPED_ELEMENT) {<tr><td><a id="l931"></a><a href="#l931">931</a><td>    tempDiv.innerHTML = &#39;&lt;br&gt;&#39; + htmlString;<tr><td><a id="l932"></a><a href="#l932">932</a><td>    tempDiv.removeChild(tempDiv.firstChild);<tr><td><a id="l933"></a><a href="#l933">933</a><td>  } else {<tr><td><a id="l934"></a><a href="#l934">934</a><td>    tempDiv.innerHTML = htmlString;<tr><td><a id="l935"></a><a href="#l935">935</a><td>  }<tr><td><a id="l936"></a><a href="#l936">936</a><td>  return goog.dom.childrenToNode_(doc, tempDiv);<tr><td><a id="l937"></a><a href="#l937">937</a><td>};<tr><td><a id="l938"></a><a href="#l938">938</a><td><tr><td><a id="l939"></a><a href="#l939">939</a><td><tr><td><a id="l940"></a><a href="#l940">940</a><td>/**<tr><td><a id="l941"></a><a href="#l941">941</a><td> * Helper for {@code htmlToDocumentFragment_}.<tr><td><a id="l942"></a><a href="#l942">942</a><td> * @param {!Document} doc The document.<tr><td><a id="l943"></a><a href="#l943">943</a><td> * @param {!Node} tempDiv The input node.<tr><td><a id="l944"></a><a href="#l944">944</a><td> * @return {!Node} The resulting node.<tr><td><a id="l945"></a><a href="#l945">945</a><td> * @private<tr><td><a id="l946"></a><a href="#l946">946</a><td> */<tr><td><a id="l947"></a><a href="#l947">947</a><td>goog.dom.childrenToNode_ = function(doc, tempDiv) {<tr><td><a id="l948"></a><a href="#l948">948</a><td>  if (tempDiv.childNodes.length == 1) {<tr><td><a id="l949"></a><a href="#l949">949</a><td>    return tempDiv.removeChild(tempDiv.firstChild);<tr><td><a id="l950"></a><a href="#l950">950</a><td>  } else {<tr><td><a id="l951"></a><a href="#l951">951</a><td>    var fragment = doc.createDocumentFragment();<tr><td><a id="l952"></a><a href="#l952">952</a><td>    while (tempDiv.firstChild) {<tr><td><a id="l953"></a><a href="#l953">953</a><td>      fragment.appendChild(tempDiv.firstChild);<tr><td><a id="l954"></a><a href="#l954">954</a><td>    }<tr><td><a id="l955"></a><a href="#l955">955</a><td>    return fragment;<tr><td><a id="l956"></a><a href="#l956">956</a><td>  }<tr><td><a id="l957"></a><a href="#l957">957</a><td>};<tr><td><a id="l958"></a><a href="#l958">958</a><td><tr><td><a id="l959"></a><a href="#l959">959</a><td><tr><td><a id="l960"></a><a href="#l960">960</a><td>/**<tr><td><a id="l961"></a><a href="#l961">961</a><td> * Returns true if the browser is in &quot;CSS1-compatible&quot; (standards-compliant)<tr><td><a id="l962"></a><a href="#l962">962</a><td> * mode, false otherwise.<tr><td><a id="l963"></a><a href="#l963">963</a><td> * @return {boolean} True if in CSS1-compatible mode.<tr><td><a id="l964"></a><a href="#l964">964</a><td> */<tr><td><a id="l965"></a><a href="#l965">965</a><td>goog.dom.isCss1CompatMode = function() {<tr><td><a id="l966"></a><a href="#l966">966</a><td>  return goog.dom.isCss1CompatMode_(document);<tr><td><a id="l967"></a><a href="#l967">967</a><td>};<tr><td><a id="l968"></a><a href="#l968">968</a><td><tr><td><a id="l969"></a><a href="#l969">969</a><td><tr><td><a id="l970"></a><a href="#l970">970</a><td>/**<tr><td><a id="l971"></a><a href="#l971">971</a><td> * Returns true if the browser is in &quot;CSS1-compatible&quot; (standards-compliant)<tr><td><a id="l972"></a><a href="#l972">972</a><td> * mode, false otherwise.<tr><td><a id="l973"></a><a href="#l973">973</a><td> * @param {!Document} doc The document to check.<tr><td><a id="l974"></a><a href="#l974">974</a><td> * @return {boolean} True if in CSS1-compatible mode.<tr><td><a id="l975"></a><a href="#l975">975</a><td> * @private<tr><td><a id="l976"></a><a href="#l976">976</a><td> */<tr><td><a id="l977"></a><a href="#l977">977</a><td>goog.dom.isCss1CompatMode_ = function(doc) {<tr><td><a id="l978"></a><a href="#l978">978</a><td>  if (goog.dom.COMPAT_MODE_KNOWN_) {<tr><td><a id="l979"></a><a href="#l979">979</a><td>    return goog.dom.ASSUME_STANDARDS_MODE;<tr><td><a id="l980"></a><a href="#l980">980</a><td>  }<tr><td><a id="l981"></a><a href="#l981">981</a><td><tr><td><a id="l982"></a><a href="#l982">982</a><td>  return doc.compatMode == &#39;CSS1Compat&#39;;<tr><td><a id="l983"></a><a href="#l983">983</a><td>};<tr><td><a id="l984"></a><a href="#l984">984</a><td><tr><td><a id="l985"></a><a href="#l985">985</a><td><tr><td><a id="l986"></a><a href="#l986">986</a><td>/**<tr><td><a id="l987"></a><a href="#l987">987</a><td> * Determines if the given node can contain children, intended to be used for<tr><td><a id="l988"></a><a href="#l988">988</a><td> * HTML generation.<tr><td><a id="l989"></a><a href="#l989">989</a><td> *<tr><td><a id="l990"></a><a href="#l990">990</a><td> * IE natively supports node.canHaveChildren but has inconsistent behavior.<tr><td><a id="l991"></a><a href="#l991">991</a><td> * Prior to IE8 the base tag allows children and in IE9 all nodes return true<tr><td><a id="l992"></a><a href="#l992">992</a><td> * for canHaveChildren.<tr><td><a id="l993"></a><a href="#l993">993</a><td> *<tr><td><a id="l994"></a><a href="#l994">994</a><td> * In practice all non-IE browsers allow you to add children to any node, but<tr><td><a id="l995"></a><a href="#l995">995</a><td> * the behavior is inconsistent:<tr><td><a id="l996"></a><a href="#l996">996</a><td> *<tr><td><a id="l997"></a><a href="#l997">997</a><td> * &lt;pre&gt;<tr><td><a id="l998"></a><a href="#l998">998</a><td> *   var a = document.createElement(goog.dom.TagName.BR);<tr><td><a id="l999"></a><a href="#l999">999</a><td> *   a.appendChild(document.createTextNode(&#39;foo&#39;));<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td> *   a.appendChild(document.createTextNode(&#39;bar&#39;));<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td> *   console.log(a.childNodes.length);  // 2<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td> *   console.log(a.innerHTML);  // Chrome: &quot;&quot;, IE9: &quot;foobar&quot;, FF3.5: &quot;foobar&quot;<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td> * &lt;/pre&gt;<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td> *<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td> * For more information, see:<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td> * http://dev.w3.org/html5/markup/syntax.html#syntax-elements<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td> *<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td> * TODO(user): Rename shouldAllowChildren() ?<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td> *<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td> * @param {Node} node The node to check.<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td> * @return {boolean} Whether the node can contain children.<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td> */<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td>goog.dom.canHaveChildren = function(node) {<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td>  if (node.nodeType != goog.dom.NodeType.ELEMENT) {<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>    return false;<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td>  }<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td>  switch (/** @type {!Element} */ (node).tagName) {<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td>    case goog.dom.TagName.APPLET:<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td>    case goog.dom.TagName.AREA:<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td>    case goog.dom.TagName.BASE:<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>    case goog.dom.TagName.BR:<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td>    case goog.dom.TagName.COL:<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td>    case goog.dom.TagName.COMMAND:<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td>    case goog.dom.TagName.EMBED:<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td>    case goog.dom.TagName.FRAME:<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>    case goog.dom.TagName.HR:<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>    case goog.dom.TagName.IMG:<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>    case goog.dom.TagName.INPUT:<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td>    case goog.dom.TagName.IFRAME:<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>    case goog.dom.TagName.ISINDEX:<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td>    case goog.dom.TagName.KEYGEN:<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td>    case goog.dom.TagName.LINK:<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>    case goog.dom.TagName.NOFRAMES:<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>    case goog.dom.TagName.NOSCRIPT:<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>    case goog.dom.TagName.META:<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>    case goog.dom.TagName.OBJECT:<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td>    case goog.dom.TagName.PARAM:<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td>    case goog.dom.TagName.SCRIPT:<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>    case goog.dom.TagName.SOURCE:<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>    case goog.dom.TagName.STYLE:<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td>    case goog.dom.TagName.TRACK:<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td>    case goog.dom.TagName.WBR:<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td>      return false;<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>  }<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td>  return true;<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td>};<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td><tr><td><a id="l1048"></a><a href="#l1048">1048</a><td><tr><td><a id="l1049"></a><a href="#l1049">1049</a><td>/**<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td> * Appends a child to a node.<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td> * @param {Node} parent Parent.<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td> * @param {Node} child Child.<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td> */<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td>goog.dom.appendChild = function(parent, child) {<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td>  parent.appendChild(child);<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td>};<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td><tr><td><a id="l1058"></a><a href="#l1058">1058</a><td><tr><td><a id="l1059"></a><a href="#l1059">1059</a><td>/**<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td> * Appends a node with text or other nodes.<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td> * @param {!Node} parent The node to append nodes to.<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td> * @param {...goog.dom.Appendable} var_args The things to append to the node.<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td> *     If this is a Node it is appended as is.<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td> *     If this is a string then a text node is appended.<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td> *     If this is an array like object then fields 0 to length - 1 are appended.<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td> */<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>goog.dom.append = function(parent, var_args) {<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td>  goog.dom.append_(goog.dom.getOwnerDocument(parent), parent, arguments, 1);<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td>};<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td><tr><td><a id="l1071"></a><a href="#l1071">1071</a><td><tr><td><a id="l1072"></a><a href="#l1072">1072</a><td>/**<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td> * Removes all the child nodes on a DOM node.<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td> * @param {Node} node Node to remove children from.<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td> */<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td>goog.dom.removeChildren = function(node) {<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td>  // Note: Iterations over live collections can be slow, this is the fastest<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td>  // we could find. The double parenthesis are used to prevent JsCompiler and<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td>  // strict warnings.<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>  var child;<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td>  while ((child = node.firstChild)) {<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td>    node.removeChild(child);<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>  }<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td>};<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td><tr><td><a id="l1086"></a><a href="#l1086">1086</a><td><tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>/**<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td> * Inserts a new node before an existing reference node (i.e. as the previous<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td> * sibling). If the reference node has no parent, then does nothing.<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td> * @param {Node} newNode Node to insert.<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td> * @param {Node} refNode Reference node to insert before.<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td> */<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td>goog.dom.insertSiblingBefore = function(newNode, refNode) {<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td>  if (refNode.parentNode) {<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td>    refNode.parentNode.insertBefore(newNode, refNode);<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td>  }<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>};<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td><tr><td><a id="l1099"></a><a href="#l1099">1099</a><td><tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>/**<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td> * Inserts a new node after an existing reference node (i.e. as the next<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td> * sibling). If the reference node has no parent, then does nothing.<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td> * @param {Node} newNode Node to insert.<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td> * @param {Node} refNode Reference node to insert after.<tr><td><a id="l1105"></a><a href="#l1105">1105</a><td> */<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td>goog.dom.insertSiblingAfter = function(newNode, refNode) {<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td>  if (refNode.parentNode) {<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td>    refNode.parentNode.insertBefore(newNode, refNode.nextSibling);<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td>  }<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td>};<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td><tr><td><a id="l1112"></a><a href="#l1112">1112</a><td><tr><td><a id="l1113"></a><a href="#l1113">1113</a><td>/**<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td> * Insert a child at a given index. If index is larger than the number of child<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td> * nodes that the parent currently has, the node is inserted as the last child<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td> * node.<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td> * @param {Element} parent The element into which to insert the child.<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td> * @param {Node} child The element to insert.<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td> * @param {number} index The index at which to insert the new child node. Must<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td> *     not be negative.<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td> */<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td>goog.dom.insertChildAt = function(parent, child, index) {<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td>  // Note that if the second argument is null, insertBefore<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td>  // will append the child at the end of the list of children.<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td>  parent.insertBefore(child, parent.childNodes[index] || null);<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td>};<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td><tr><td><a id="l1128"></a><a href="#l1128">1128</a><td><tr><td><a id="l1129"></a><a href="#l1129">1129</a><td>/**<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td> * Removes a node from its parent.<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td> * @param {Node} node The node to remove.<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td> * @return {Node} The node removed if removed; else, null.<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td> */<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td>goog.dom.removeNode = function(node) {<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td>  return node &amp;&amp; node.parentNode ? node.parentNode.removeChild(node) : null;<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td>};<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td><tr><td><a id="l1138"></a><a href="#l1138">1138</a><td><tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>/**<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td> * Replaces a node in the DOM tree. Will do nothing if {@code oldNode} has no<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td> * parent.<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td> * @param {Node} newNode Node to insert.<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td> * @param {Node} oldNode Node to replace.<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td> */<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>goog.dom.replaceNode = function(newNode, oldNode) {<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>  var parent = oldNode.parentNode;<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td>  if (parent) {<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td>    parent.replaceChild(newNode, oldNode);<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td>  }<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>};<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td><tr><td><a id="l1152"></a><a href="#l1152">1152</a><td><tr><td><a id="l1153"></a><a href="#l1153">1153</a><td>/**<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td> * Flattens an element. That is, removes it and replace it with its children.<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td> * Does nothing if the element is not in the document.<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td> * @param {Element} element The element to flatten.<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td> * @return {Element|undefined} The original element, detached from the document<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td> *     tree, sans children; or undefined, if the element was not in the document<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td> *     to begin with.<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td> */<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td>goog.dom.flattenElement = function(element) {<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td>  var child, parent = element.parentNode;<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td>  if (parent &amp;&amp; parent.nodeType != goog.dom.NodeType.DOCUMENT_FRAGMENT) {<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td>    // Use IE DOM method (supported by Opera too) if available<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>    if (element.removeNode) {<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td>      return /** @type {Element} */ (element.removeNode(false));<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>    } else {<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td>      // Move all children of the original node up one level.<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td>      while ((child = element.firstChild)) {<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td>        parent.insertBefore(child, element);<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td>      }<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td><tr><td><a id="l1173"></a><a href="#l1173">1173</a><td>      // Detach the original element.<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td>      return /** @type {Element} */ (goog.dom.removeNode(element));<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td>    }<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td>  }<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td>};<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td><tr><td><a id="l1179"></a><a href="#l1179">1179</a><td><tr><td><a id="l1180"></a><a href="#l1180">1180</a><td>/**<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td> * Returns an array containing just the element children of the given element.<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td> * @param {Element} element The element whose element children we want.<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td> * @return {!(Array|NodeList)} An array or array-like list of just the element<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td> *     children of the given element.<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td> */<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td>goog.dom.getChildren = function(element) {<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td>  // We check if the children attribute is supported for child elements<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td>  // since IE8 misuses the attribute by also including comments.<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td>  if (goog.dom.BrowserFeature.CAN_USE_CHILDREN_ATTRIBUTE &amp;&amp;<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td>      element.children != undefined) {<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td>    return element.children;<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>  }<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>  // Fall back to manually filtering the element&#39;s child nodes.<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td>  return goog.array.filter(element.childNodes, function(node) {<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>    return node.nodeType == goog.dom.NodeType.ELEMENT;<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td>  });<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td>};<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td><tr><td><a id="l1199"></a><a href="#l1199">1199</a><td><tr><td><a id="l1200"></a><a href="#l1200">1200</a><td>/**<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td> * Returns the first child node that is an element.<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td> * @param {Node} node The node to get the first child element of.<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td> * @return {Element} The first child node of {@code node} that is an element.<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td> */<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td>goog.dom.getFirstElementChild = function(node) {<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td>  if (goog.isDef(node.firstElementChild)) {<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td>    return /** @type {!Element} */(node).firstElementChild;<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td>  }<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td>  return goog.dom.getNextElementNode_(node.firstChild, true);<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td>};<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td><tr><td><a id="l1212"></a><a href="#l1212">1212</a><td><tr><td><a id="l1213"></a><a href="#l1213">1213</a><td>/**<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td> * Returns the last child node that is an element.<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td> * @param {Node} node The node to get the last child element of.<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td> * @return {Element} The last child node of {@code node} that is an element.<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td> */<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td>goog.dom.getLastElementChild = function(node) {<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td>  if (goog.isDef(node.lastElementChild)) {<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td>    return /** @type {!Element} */(node).lastElementChild;<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td>  }<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>  return goog.dom.getNextElementNode_(node.lastChild, false);<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>};<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td><tr><td><a id="l1225"></a><a href="#l1225">1225</a><td><tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>/**<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td> * Returns the first next sibling that is an element.<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td> * @param {Node} node The node to get the next sibling element of.<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td> * @return {Element} The next sibling of {@code node} that is an element.<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td> */<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td>goog.dom.getNextElementSibling = function(node) {<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td>  if (goog.isDef(node.nextElementSibling)) {<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td>    return /** @type {!Element} */(node).nextElementSibling;<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td>  }<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td>  return goog.dom.getNextElementNode_(node.nextSibling, true);<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td>};<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td><tr><td><a id="l1238"></a><a href="#l1238">1238</a><td><tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>/**<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td> * Returns the first previous sibling that is an element.<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td> * @param {Node} node The node to get the previous sibling element of.<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td> * @return {Element} The first previous sibling of {@code node} that is<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td> *     an element.<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td> */<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td>goog.dom.getPreviousElementSibling = function(node) {<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td>  if (goog.isDef(node.previousElementSibling)) {<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>    return /** @type {!Element} */(node).previousElementSibling;<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>  }<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>  return goog.dom.getNextElementNode_(node.previousSibling, false);<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>};<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td><tr><td><a id="l1252"></a><a href="#l1252">1252</a><td><tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>/**<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td> * Returns the first node that is an element in the specified direction,<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td> * starting with {@code node}.<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td> * @param {Node} node The node to get the next element from.<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td> * @param {boolean} forward Whether to look forwards or backwards.<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td> * @return {Element} The first element.<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td> * @private<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td> */<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td>goog.dom.getNextElementNode_ = function(node, forward) {<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td>  while (node &amp;&amp; node.nodeType != goog.dom.NodeType.ELEMENT) {<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td>    node = forward ? node.nextSibling : node.previousSibling;<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>  }<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td><tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>  return /** @type {Element} */ (node);<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>};<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td><tr><td><a id="l1269"></a><a href="#l1269">1269</a><td><tr><td><a id="l1270"></a><a href="#l1270">1270</a><td>/**<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td> * Returns the next node in source order from the given node.<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td> * @param {Node} node The node.<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td> * @return {Node} The next node in the DOM tree, or null if this was the last<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td> *     node.<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td> */<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td>goog.dom.getNextNode = function(node) {<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td>  if (!node) {<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>    return null;<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>  }<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td><tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>  if (node.firstChild) {<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>    return node.firstChild;<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>  }<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td><tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>  while (node &amp;&amp; !node.nextSibling) {<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>    node = node.parentNode;<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>  }<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td><tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>  return node ? node.nextSibling : null;<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td>};<tr><td><a id="l1291"></a><a href="#l1291">1291</a><td><tr><td><a id="l1292"></a><a href="#l1292">1292</a><td><tr><td><a id="l1293"></a><a href="#l1293">1293</a><td>/**<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td> * Returns the previous node in source order from the given node.<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td> * @param {Node} node The node.<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td> * @return {Node} The previous node in the DOM tree, or null if this was the<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td> *     first node.<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td> */<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td>goog.dom.getPreviousNode = function(node) {<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td>  if (!node) {<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>    return null;<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td>  }<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td><tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>  if (!node.previousSibling) {<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td>    return node.parentNode;<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td>  }<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td><tr><td><a id="l1308"></a><a href="#l1308">1308</a><td>  node = node.previousSibling;<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td>  while (node &amp;&amp; node.lastChild) {<tr><td><a id="l1310"></a><a href="#l1310">1310</a><td>    node = node.lastChild;<tr><td><a id="l1311"></a><a href="#l1311">1311</a><td>  }<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td><tr><td><a id="l1313"></a><a href="#l1313">1313</a><td>  return node;<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td>};<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td><tr><td><a id="l1316"></a><a href="#l1316">1316</a><td><tr><td><a id="l1317"></a><a href="#l1317">1317</a><td>/**<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td> * Whether the object looks like a DOM node.<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td> * @param {?} obj The object being tested for node likeness.<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td> * @return {boolean} Whether the object looks like a DOM node.<tr><td><a id="l1321"></a><a href="#l1321">1321</a><td> */<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td>goog.dom.isNodeLike = function(obj) {<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td>  return goog.isObject(obj) &amp;&amp; obj.nodeType &gt; 0;<tr><td><a id="l1324"></a><a href="#l1324">1324</a><td>};<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td><tr><td><a id="l1326"></a><a href="#l1326">1326</a><td><tr><td><a id="l1327"></a><a href="#l1327">1327</a><td>/**<tr><td><a id="l1328"></a><a href="#l1328">1328</a><td> * Whether the object looks like an Element.<tr><td><a id="l1329"></a><a href="#l1329">1329</a><td> * @param {?} obj The object being tested for Element likeness.<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td> * @return {boolean} Whether the object looks like an Element.<tr><td><a id="l1331"></a><a href="#l1331">1331</a><td> */<tr><td><a id="l1332"></a><a href="#l1332">1332</a><td>goog.dom.isElement = function(obj) {<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td>  return goog.isObject(obj) &amp;&amp; obj.nodeType == goog.dom.NodeType.ELEMENT;<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td>};<tr><td><a id="l1335"></a><a href="#l1335">1335</a><td><tr><td><a id="l1336"></a><a href="#l1336">1336</a><td><tr><td><a id="l1337"></a><a href="#l1337">1337</a><td>/**<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td> * Returns true if the specified value is a Window object. This includes the<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td> * global window for HTML pages, and iframe windows.<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td> * @param {?} obj Variable to test.<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td> * @return {boolean} Whether the variable is a window.<tr><td><a id="l1342"></a><a href="#l1342">1342</a><td> */<tr><td><a id="l1343"></a><a href="#l1343">1343</a><td>goog.dom.isWindow = function(obj) {<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td>  return goog.isObject(obj) &amp;&amp; obj[&#39;window&#39;] == obj;<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td>};<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td><tr><td><a id="l1347"></a><a href="#l1347">1347</a><td><tr><td><a id="l1348"></a><a href="#l1348">1348</a><td>/**<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td> * Returns an element&#39;s parent, if it&#39;s an Element.<tr><td><a id="l1350"></a><a href="#l1350">1350</a><td> * @param {Element} element The DOM element.<tr><td><a id="l1351"></a><a href="#l1351">1351</a><td> * @return {Element} The parent, or null if not an Element.<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td> */<tr><td><a id="l1353"></a><a href="#l1353">1353</a><td>goog.dom.getParentElement = function(element) {<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td>  var parent;<tr><td><a id="l1355"></a><a href="#l1355">1355</a><td>  if (goog.dom.BrowserFeature.CAN_USE_PARENT_ELEMENT_PROPERTY) {<tr><td><a id="l1356"></a><a href="#l1356">1356</a><td>    var isIe9 = goog.userAgent.IE &amp;&amp;<tr><td><a id="l1357"></a><a href="#l1357">1357</a><td>        goog.userAgent.isVersionOrHigher(&#39;9&#39;) &amp;&amp;<tr><td><a id="l1358"></a><a href="#l1358">1358</a><td>        !goog.userAgent.isVersionOrHigher(&#39;10&#39;);<tr><td><a id="l1359"></a><a href="#l1359">1359</a><td>    // SVG elements in IE9 can&#39;t use the parentElement property.<tr><td><a id="l1360"></a><a href="#l1360">1360</a><td>    // goog.global[&#39;SVGElement&#39;] is not defined in IE9 quirks mode.<tr><td><a id="l1361"></a><a href="#l1361">1361</a><td>    if (!(isIe9 &amp;&amp; goog.global[&#39;SVGElement&#39;] &amp;&amp;<tr><td><a id="l1362"></a><a href="#l1362">1362</a><td>        element instanceof goog.global[&#39;SVGElement&#39;])) {<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td>      parent = element.parentElement;<tr><td><a id="l1364"></a><a href="#l1364">1364</a><td>      if (parent) {<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td>        return parent;<tr><td><a id="l1366"></a><a href="#l1366">1366</a><td>      }<tr><td><a id="l1367"></a><a href="#l1367">1367</a><td>    }<tr><td><a id="l1368"></a><a href="#l1368">1368</a><td>  }<tr><td><a id="l1369"></a><a href="#l1369">1369</a><td>  parent = element.parentNode;<tr><td><a id="l1370"></a><a href="#l1370">1370</a><td>  return goog.dom.isElement(parent) ? /** @type {!Element} */ (parent) : null;<tr><td><a id="l1371"></a><a href="#l1371">1371</a><td>};<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td><tr><td><a id="l1373"></a><a href="#l1373">1373</a><td><tr><td><a id="l1374"></a><a href="#l1374">1374</a><td>/**<tr><td><a id="l1375"></a><a href="#l1375">1375</a><td> * Whether a node contains another node.<tr><td><a id="l1376"></a><a href="#l1376">1376</a><td> * @param {Node} parent The node that should contain the other node.<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td> * @param {Node} descendant The node to test presence of.<tr><td><a id="l1378"></a><a href="#l1378">1378</a><td> * @return {boolean} Whether the parent node contains the descendent node.<tr><td><a id="l1379"></a><a href="#l1379">1379</a><td> */<tr><td><a id="l1380"></a><a href="#l1380">1380</a><td>goog.dom.contains = function(parent, descendant) {<tr><td><a id="l1381"></a><a href="#l1381">1381</a><td>  // We use browser specific methods for this if available since it is faster<tr><td><a id="l1382"></a><a href="#l1382">1382</a><td>  // that way.<tr><td><a id="l1383"></a><a href="#l1383">1383</a><td><tr><td><a id="l1384"></a><a href="#l1384">1384</a><td>  // IE DOM<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td>  if (parent.contains &amp;&amp; descendant.nodeType == goog.dom.NodeType.ELEMENT) {<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td>    return parent == descendant || parent.contains(descendant);<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td>  }<tr><td><a id="l1388"></a><a href="#l1388">1388</a><td><tr><td><a id="l1389"></a><a href="#l1389">1389</a><td>  // W3C DOM Level 3<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td>  if (typeof parent.compareDocumentPosition != &#39;undefined&#39;) {<tr><td><a id="l1391"></a><a href="#l1391">1391</a><td>    return parent == descendant ||<tr><td><a id="l1392"></a><a href="#l1392">1392</a><td>        Boolean(parent.compareDocumentPosition(descendant) &amp; 16);<tr><td><a id="l1393"></a><a href="#l1393">1393</a><td>  }<tr><td><a id="l1394"></a><a href="#l1394">1394</a><td><tr><td><a id="l1395"></a><a href="#l1395">1395</a><td>  // W3C DOM Level 1<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td>  while (descendant &amp;&amp; parent != descendant) {<tr><td><a id="l1397"></a><a href="#l1397">1397</a><td>    descendant = descendant.parentNode;<tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>  }<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td>  return descendant == parent;<tr><td><a id="l1400"></a><a href="#l1400">1400</a><td>};<tr><td><a id="l1401"></a><a href="#l1401">1401</a><td><tr><td><a id="l1402"></a><a href="#l1402">1402</a><td><tr><td><a id="l1403"></a><a href="#l1403">1403</a><td>/**<tr><td><a id="l1404"></a><a href="#l1404">1404</a><td> * Compares the document order of two nodes, returning 0 if they are the same<tr><td><a id="l1405"></a><a href="#l1405">1405</a><td> * node, a negative number if node1 is before node2, and a positive number if<tr><td><a id="l1406"></a><a href="#l1406">1406</a><td> * node2 is before node1.  Note that we compare the order the tags appear in the<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td> * document so in the tree &lt;b&gt;&lt;i&gt;text&lt;/i&gt;&lt;/b&gt; the B node is considered to be<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td> * before the I node.<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td> *<tr><td><a id="l1410"></a><a href="#l1410">1410</a><td> * @param {Node} node1 The first node to compare.<tr><td><a id="l1411"></a><a href="#l1411">1411</a><td> * @param {Node} node2 The second node to compare.<tr><td><a id="l1412"></a><a href="#l1412">1412</a><td> * @return {number} 0 if the nodes are the same node, a negative number if node1<tr><td><a id="l1413"></a><a href="#l1413">1413</a><td> *     is before node2, and a positive number if node2 is before node1.<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td> */<tr><td><a id="l1415"></a><a href="#l1415">1415</a><td>goog.dom.compareNodeOrder = function(node1, node2) {<tr><td><a id="l1416"></a><a href="#l1416">1416</a><td>  // Fall out quickly for equality.<tr><td><a id="l1417"></a><a href="#l1417">1417</a><td>  if (node1 == node2) {<tr><td><a id="l1418"></a><a href="#l1418">1418</a><td>    return 0;<tr><td><a id="l1419"></a><a href="#l1419">1419</a><td>  }<tr><td><a id="l1420"></a><a href="#l1420">1420</a><td><tr><td><a id="l1421"></a><a href="#l1421">1421</a><td>  // Use compareDocumentPosition where available<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td>  if (node1.compareDocumentPosition) {<tr><td><a id="l1423"></a><a href="#l1423">1423</a><td>    // 4 is the bitmask for FOLLOWS.<tr><td><a id="l1424"></a><a href="#l1424">1424</a><td>    return node1.compareDocumentPosition(node2) &amp; 2 ? 1 : -1;<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td>  }<tr><td><a id="l1426"></a><a href="#l1426">1426</a><td><tr><td><a id="l1427"></a><a href="#l1427">1427</a><td>  // Special case for document nodes on IE 7 and 8.<tr><td><a id="l1428"></a><a href="#l1428">1428</a><td>  if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isDocumentModeOrHigher(9)) {<tr><td><a id="l1429"></a><a href="#l1429">1429</a><td>    if (node1.nodeType == goog.dom.NodeType.DOCUMENT) {<tr><td><a id="l1430"></a><a href="#l1430">1430</a><td>      return -1;<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td>    }<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td>    if (node2.nodeType == goog.dom.NodeType.DOCUMENT) {<tr><td><a id="l1433"></a><a href="#l1433">1433</a><td>      return 1;<tr><td><a id="l1434"></a><a href="#l1434">1434</a><td>    }<tr><td><a id="l1435"></a><a href="#l1435">1435</a><td>  }<tr><td><a id="l1436"></a><a href="#l1436">1436</a><td><tr><td><a id="l1437"></a><a href="#l1437">1437</a><td>  // Process in IE using sourceIndex - we check to see if the first node has<tr><td><a id="l1438"></a><a href="#l1438">1438</a><td>  // a source index or if its parent has one.<tr><td><a id="l1439"></a><a href="#l1439">1439</a><td>  if (&#39;sourceIndex&#39; in node1 ||<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td>      (node1.parentNode &amp;&amp; &#39;sourceIndex&#39; in node1.parentNode)) {<tr><td><a id="l1441"></a><a href="#l1441">1441</a><td>    var isElement1 = node1.nodeType == goog.dom.NodeType.ELEMENT;<tr><td><a id="l1442"></a><a href="#l1442">1442</a><td>    var isElement2 = node2.nodeType == goog.dom.NodeType.ELEMENT;<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td><tr><td><a id="l1444"></a><a href="#l1444">1444</a><td>    if (isElement1 &amp;&amp; isElement2) {<tr><td><a id="l1445"></a><a href="#l1445">1445</a><td>      return node1.sourceIndex - node2.sourceIndex;<tr><td><a id="l1446"></a><a href="#l1446">1446</a><td>    } else {<tr><td><a id="l1447"></a><a href="#l1447">1447</a><td>      var parent1 = node1.parentNode;<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td>      var parent2 = node2.parentNode;<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td><tr><td><a id="l1450"></a><a href="#l1450">1450</a><td>      if (parent1 == parent2) {<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td>        return goog.dom.compareSiblingOrder_(node1, node2);<tr><td><a id="l1452"></a><a href="#l1452">1452</a><td>      }<tr><td><a id="l1453"></a><a href="#l1453">1453</a><td><tr><td><a id="l1454"></a><a href="#l1454">1454</a><td>      if (!isElement1 &amp;&amp; goog.dom.contains(parent1, node2)) {<tr><td><a id="l1455"></a><a href="#l1455">1455</a><td>        return -1 * goog.dom.compareParentsDescendantNodeIe_(node1, node2);<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td>      }<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td><tr><td><a id="l1458"></a><a href="#l1458">1458</a><td><tr><td><a id="l1459"></a><a href="#l1459">1459</a><td>      if (!isElement2 &amp;&amp; goog.dom.contains(parent2, node1)) {<tr><td><a id="l1460"></a><a href="#l1460">1460</a><td>        return goog.dom.compareParentsDescendantNodeIe_(node2, node1);<tr><td><a id="l1461"></a><a href="#l1461">1461</a><td>      }<tr><td><a id="l1462"></a><a href="#l1462">1462</a><td><tr><td><a id="l1463"></a><a href="#l1463">1463</a><td>      return (isElement1 ? node1.sourceIndex : parent1.sourceIndex) -<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td>             (isElement2 ? node2.sourceIndex : parent2.sourceIndex);<tr><td><a id="l1465"></a><a href="#l1465">1465</a><td>    }<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td>  }<tr><td><a id="l1467"></a><a href="#l1467">1467</a><td><tr><td><a id="l1468"></a><a href="#l1468">1468</a><td>  // For Safari, we compare ranges.<tr><td><a id="l1469"></a><a href="#l1469">1469</a><td>  var doc = goog.dom.getOwnerDocument(node1);<tr><td><a id="l1470"></a><a href="#l1470">1470</a><td><tr><td><a id="l1471"></a><a href="#l1471">1471</a><td>  var range1, range2;<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td>  range1 = doc.createRange();<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td>  range1.selectNode(node1);<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td>  range1.collapse(true);<tr><td><a id="l1475"></a><a href="#l1475">1475</a><td><tr><td><a id="l1476"></a><a href="#l1476">1476</a><td>  range2 = doc.createRange();<tr><td><a id="l1477"></a><a href="#l1477">1477</a><td>  range2.selectNode(node2);<tr><td><a id="l1478"></a><a href="#l1478">1478</a><td>  range2.collapse(true);<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td><tr><td><a id="l1480"></a><a href="#l1480">1480</a><td>  return range1.compareBoundaryPoints(goog.global[&#39;Range&#39;].START_TO_END,<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td>      range2);<tr><td><a id="l1482"></a><a href="#l1482">1482</a><td>};<tr><td><a id="l1483"></a><a href="#l1483">1483</a><td><tr><td><a id="l1484"></a><a href="#l1484">1484</a><td><tr><td><a id="l1485"></a><a href="#l1485">1485</a><td>/**<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td> * Utility function to compare the position of two nodes, when<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td> * {@code textNode}&#39;s parent is an ancestor of {@code node}.  If this entry<tr><td><a id="l1488"></a><a href="#l1488">1488</a><td> * condition is not met, this function will attempt to reference a null object.<tr><td><a id="l1489"></a><a href="#l1489">1489</a><td> * @param {!Node} textNode The textNode to compare.<tr><td><a id="l1490"></a><a href="#l1490">1490</a><td> * @param {Node} node The node to compare.<tr><td><a id="l1491"></a><a href="#l1491">1491</a><td> * @return {number} -1 if node is before textNode, +1 otherwise.<tr><td><a id="l1492"></a><a href="#l1492">1492</a><td> * @private<tr><td><a id="l1493"></a><a href="#l1493">1493</a><td> */<tr><td><a id="l1494"></a><a href="#l1494">1494</a><td>goog.dom.compareParentsDescendantNodeIe_ = function(textNode, node) {<tr><td><a id="l1495"></a><a href="#l1495">1495</a><td>  var parent = textNode.parentNode;<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td>  if (parent == node) {<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td>    // If textNode is a child of node, then node comes first.<tr><td><a id="l1498"></a><a href="#l1498">1498</a><td>    return -1;<tr><td><a id="l1499"></a><a href="#l1499">1499</a><td>  }<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td>  var sibling = node;<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td>  while (sibling.parentNode != parent) {<tr><td><a id="l1502"></a><a href="#l1502">1502</a><td>    sibling = sibling.parentNode;<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td>  }<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td>  return goog.dom.compareSiblingOrder_(sibling, textNode);<tr><td><a id="l1505"></a><a href="#l1505">1505</a><td>};<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td><tr><td><a id="l1507"></a><a href="#l1507">1507</a><td><tr><td><a id="l1508"></a><a href="#l1508">1508</a><td>/**<tr><td><a id="l1509"></a><a href="#l1509">1509</a><td> * Utility function to compare the position of two nodes known to be non-equal<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td> * siblings.<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td> * @param {Node} node1 The first node to compare.<tr><td><a id="l1512"></a><a href="#l1512">1512</a><td> * @param {!Node} node2 The second node to compare.<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td> * @return {number} -1 if node1 is before node2, +1 otherwise.<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td> * @private<tr><td><a id="l1515"></a><a href="#l1515">1515</a><td> */<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>goog.dom.compareSiblingOrder_ = function(node1, node2) {<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td>  var s = node2;<tr><td><a id="l1518"></a><a href="#l1518">1518</a><td>  while ((s = s.previousSibling)) {<tr><td><a id="l1519"></a><a href="#l1519">1519</a><td>    if (s == node1) {<tr><td><a id="l1520"></a><a href="#l1520">1520</a><td>      // We just found node1 before node2.<tr><td><a id="l1521"></a><a href="#l1521">1521</a><td>      return -1;<tr><td><a id="l1522"></a><a href="#l1522">1522</a><td>    }<tr><td><a id="l1523"></a><a href="#l1523">1523</a><td>  }<tr><td><a id="l1524"></a><a href="#l1524">1524</a><td><tr><td><a id="l1525"></a><a href="#l1525">1525</a><td>  // Since we didn&#39;t find it, node1 must be after node2.<tr><td><a id="l1526"></a><a href="#l1526">1526</a><td>  return 1;<tr><td><a id="l1527"></a><a href="#l1527">1527</a><td>};<tr><td><a id="l1528"></a><a href="#l1528">1528</a><td><tr><td><a id="l1529"></a><a href="#l1529">1529</a><td><tr><td><a id="l1530"></a><a href="#l1530">1530</a><td>/**<tr><td><a id="l1531"></a><a href="#l1531">1531</a><td> * Find the deepest common ancestor of the given nodes.<tr><td><a id="l1532"></a><a href="#l1532">1532</a><td> * @param {...Node} var_args The nodes to find a common ancestor of.<tr><td><a id="l1533"></a><a href="#l1533">1533</a><td> * @return {Node} The common ancestor of the nodes, or null if there is none.<tr><td><a id="l1534"></a><a href="#l1534">1534</a><td> *     null will only be returned if two or more of the nodes are from different<tr><td><a id="l1535"></a><a href="#l1535">1535</a><td> *     documents.<tr><td><a id="l1536"></a><a href="#l1536">1536</a><td> */<tr><td><a id="l1537"></a><a href="#l1537">1537</a><td>goog.dom.findCommonAncestor = function(var_args) {<tr><td><a id="l1538"></a><a href="#l1538">1538</a><td>  var i, count = arguments.length;<tr><td><a id="l1539"></a><a href="#l1539">1539</a><td>  if (!count) {<tr><td><a id="l1540"></a><a href="#l1540">1540</a><td>    return null;<tr><td><a id="l1541"></a><a href="#l1541">1541</a><td>  } else if (count == 1) {<tr><td><a id="l1542"></a><a href="#l1542">1542</a><td>    return arguments[0];<tr><td><a id="l1543"></a><a href="#l1543">1543</a><td>  }<tr><td><a id="l1544"></a><a href="#l1544">1544</a><td><tr><td><a id="l1545"></a><a href="#l1545">1545</a><td>  var paths = [];<tr><td><a id="l1546"></a><a href="#l1546">1546</a><td>  var minLength = Infinity;<tr><td><a id="l1547"></a><a href="#l1547">1547</a><td>  for (i = 0; i &lt; count; i++) {<tr><td><a id="l1548"></a><a href="#l1548">1548</a><td>    // Compute the list of ancestors.<tr><td><a id="l1549"></a><a href="#l1549">1549</a><td>    var ancestors = [];<tr><td><a id="l1550"></a><a href="#l1550">1550</a><td>    var node = arguments[i];<tr><td><a id="l1551"></a><a href="#l1551">1551</a><td>    while (node) {<tr><td><a id="l1552"></a><a href="#l1552">1552</a><td>      ancestors.unshift(node);<tr><td><a id="l1553"></a><a href="#l1553">1553</a><td>      node = node.parentNode;<tr><td><a id="l1554"></a><a href="#l1554">1554</a><td>    }<tr><td><a id="l1555"></a><a href="#l1555">1555</a><td><tr><td><a id="l1556"></a><a href="#l1556">1556</a><td>    // Save the list for comparison.<tr><td><a id="l1557"></a><a href="#l1557">1557</a><td>    paths.push(ancestors);<tr><td><a id="l1558"></a><a href="#l1558">1558</a><td>    minLength = Math.min(minLength, ancestors.length);<tr><td><a id="l1559"></a><a href="#l1559">1559</a><td>  }<tr><td><a id="l1560"></a><a href="#l1560">1560</a><td>  var output = null;<tr><td><a id="l1561"></a><a href="#l1561">1561</a><td>  for (i = 0; i &lt; minLength; i++) {<tr><td><a id="l1562"></a><a href="#l1562">1562</a><td>    var first = paths[0][i];<tr><td><a id="l1563"></a><a href="#l1563">1563</a><td>    for (var j = 1; j &lt; count; j++) {<tr><td><a id="l1564"></a><a href="#l1564">1564</a><td>      if (first != paths[j][i]) {<tr><td><a id="l1565"></a><a href="#l1565">1565</a><td>        return output;<tr><td><a id="l1566"></a><a href="#l1566">1566</a><td>      }<tr><td><a id="l1567"></a><a href="#l1567">1567</a><td>    }<tr><td><a id="l1568"></a><a href="#l1568">1568</a><td>    output = first;<tr><td><a id="l1569"></a><a href="#l1569">1569</a><td>  }<tr><td><a id="l1570"></a><a href="#l1570">1570</a><td>  return output;<tr><td><a id="l1571"></a><a href="#l1571">1571</a><td>};<tr><td><a id="l1572"></a><a href="#l1572">1572</a><td><tr><td><a id="l1573"></a><a href="#l1573">1573</a><td><tr><td><a id="l1574"></a><a href="#l1574">1574</a><td>/**<tr><td><a id="l1575"></a><a href="#l1575">1575</a><td> * Returns the owner document for a node.<tr><td><a id="l1576"></a><a href="#l1576">1576</a><td> * @param {Node|Window} node The node to get the document for.<tr><td><a id="l1577"></a><a href="#l1577">1577</a><td> * @return {!Document} The document owning the node.<tr><td><a id="l1578"></a><a href="#l1578">1578</a><td> */<tr><td><a id="l1579"></a><a href="#l1579">1579</a><td>goog.dom.getOwnerDocument = function(node) {<tr><td><a id="l1580"></a><a href="#l1580">1580</a><td>  // TODO(nnaze): Update param signature to be non-nullable.<tr><td><a id="l1581"></a><a href="#l1581">1581</a><td>  goog.asserts.assert(node, &#39;Node cannot be null or undefined.&#39;);<tr><td><a id="l1582"></a><a href="#l1582">1582</a><td>  return /** @type {!Document} */ (<tr><td><a id="l1583"></a><a href="#l1583">1583</a><td>      node.nodeType == goog.dom.NodeType.DOCUMENT ? node :<tr><td><a id="l1584"></a><a href="#l1584">1584</a><td>      node.ownerDocument || node.document);<tr><td><a id="l1585"></a><a href="#l1585">1585</a><td>};<tr><td><a id="l1586"></a><a href="#l1586">1586</a><td><tr><td><a id="l1587"></a><a href="#l1587">1587</a><td><tr><td><a id="l1588"></a><a href="#l1588">1588</a><td>/**<tr><td><a id="l1589"></a><a href="#l1589">1589</a><td> * Cross-browser function for getting the document element of a frame or iframe.<tr><td><a id="l1590"></a><a href="#l1590">1590</a><td> * @param {Element} frame Frame element.<tr><td><a id="l1591"></a><a href="#l1591">1591</a><td> * @return {!Document} The frame content document.<tr><td><a id="l1592"></a><a href="#l1592">1592</a><td> */<tr><td><a id="l1593"></a><a href="#l1593">1593</a><td>goog.dom.getFrameContentDocument = function(frame) {<tr><td><a id="l1594"></a><a href="#l1594">1594</a><td>  var doc = frame.contentDocument || frame.contentWindow.document;<tr><td><a id="l1595"></a><a href="#l1595">1595</a><td>  return doc;<tr><td><a id="l1596"></a><a href="#l1596">1596</a><td>};<tr><td><a id="l1597"></a><a href="#l1597">1597</a><td><tr><td><a id="l1598"></a><a href="#l1598">1598</a><td><tr><td><a id="l1599"></a><a href="#l1599">1599</a><td>/**<tr><td><a id="l1600"></a><a href="#l1600">1600</a><td> * Cross-browser function for getting the window of a frame or iframe.<tr><td><a id="l1601"></a><a href="#l1601">1601</a><td> * @param {Element} frame Frame element.<tr><td><a id="l1602"></a><a href="#l1602">1602</a><td> * @return {Window} The window associated with the given frame.<tr><td><a id="l1603"></a><a href="#l1603">1603</a><td> */<tr><td><a id="l1604"></a><a href="#l1604">1604</a><td>goog.dom.getFrameContentWindow = function(frame) {<tr><td><a id="l1605"></a><a href="#l1605">1605</a><td>  return frame.contentWindow ||<tr><td><a id="l1606"></a><a href="#l1606">1606</a><td>      goog.dom.getWindow(goog.dom.getFrameContentDocument(frame));<tr><td><a id="l1607"></a><a href="#l1607">1607</a><td>};<tr><td><a id="l1608"></a><a href="#l1608">1608</a><td><tr><td><a id="l1609"></a><a href="#l1609">1609</a><td><tr><td><a id="l1610"></a><a href="#l1610">1610</a><td>/**<tr><td><a id="l1611"></a><a href="#l1611">1611</a><td> * Sets the text content of a node, with cross-browser support.<tr><td><a id="l1612"></a><a href="#l1612">1612</a><td> * @param {Node} node The node to change the text content of.<tr><td><a id="l1613"></a><a href="#l1613">1613</a><td> * @param {string|number} text The value that should replace the node&#39;s content.<tr><td><a id="l1614"></a><a href="#l1614">1614</a><td> */<tr><td><a id="l1615"></a><a href="#l1615">1615</a><td>goog.dom.setTextContent = function(node, text) {<tr><td><a id="l1616"></a><a href="#l1616">1616</a><td>  goog.asserts.assert(node != null,<tr><td><a id="l1617"></a><a href="#l1617">1617</a><td>      &#39;goog.dom.setTextContent expects a non-null value for node&#39;);<tr><td><a id="l1618"></a><a href="#l1618">1618</a><td><tr><td><a id="l1619"></a><a href="#l1619">1619</a><td>  if (&#39;textContent&#39; in node) {<tr><td><a id="l1620"></a><a href="#l1620">1620</a><td>    node.textContent = text;<tr><td><a id="l1621"></a><a href="#l1621">1621</a><td>  } else if (node.nodeType == goog.dom.NodeType.TEXT) {<tr><td><a id="l1622"></a><a href="#l1622">1622</a><td>    node.data = text;<tr><td><a id="l1623"></a><a href="#l1623">1623</a><td>  } else if (node.firstChild &amp;&amp;<tr><td><a id="l1624"></a><a href="#l1624">1624</a><td>             node.firstChild.nodeType == goog.dom.NodeType.TEXT) {<tr><td><a id="l1625"></a><a href="#l1625">1625</a><td>    // If the first child is a text node we just change its data and remove the<tr><td><a id="l1626"></a><a href="#l1626">1626</a><td>    // rest of the children.<tr><td><a id="l1627"></a><a href="#l1627">1627</a><td>    while (node.lastChild != node.firstChild) {<tr><td><a id="l1628"></a><a href="#l1628">1628</a><td>      node.removeChild(node.lastChild);<tr><td><a id="l1629"></a><a href="#l1629">1629</a><td>    }<tr><td><a id="l1630"></a><a href="#l1630">1630</a><td>    node.firstChild.data = text;<tr><td><a id="l1631"></a><a href="#l1631">1631</a><td>  } else {<tr><td><a id="l1632"></a><a href="#l1632">1632</a><td>    goog.dom.removeChildren(node);<tr><td><a id="l1633"></a><a href="#l1633">1633</a><td>    var doc = goog.dom.getOwnerDocument(node);<tr><td><a id="l1634"></a><a href="#l1634">1634</a><td>    node.appendChild(doc.createTextNode(String(text)));<tr><td><a id="l1635"></a><a href="#l1635">1635</a><td>  }<tr><td><a id="l1636"></a><a href="#l1636">1636</a><td>};<tr><td><a id="l1637"></a><a href="#l1637">1637</a><td><tr><td><a id="l1638"></a><a href="#l1638">1638</a><td><tr><td><a id="l1639"></a><a href="#l1639">1639</a><td>/**<tr><td><a id="l1640"></a><a href="#l1640">1640</a><td> * Gets the outerHTML of a node, which islike innerHTML, except that it<tr><td><a id="l1641"></a><a href="#l1641">1641</a><td> * actually contains the HTML of the node itself.<tr><td><a id="l1642"></a><a href="#l1642">1642</a><td> * @param {Element} element The element to get the HTML of.<tr><td><a id="l1643"></a><a href="#l1643">1643</a><td> * @return {string} The outerHTML of the given element.<tr><td><a id="l1644"></a><a href="#l1644">1644</a><td> */<tr><td><a id="l1645"></a><a href="#l1645">1645</a><td>goog.dom.getOuterHtml = function(element) {<tr><td><a id="l1646"></a><a href="#l1646">1646</a><td>  // IE, Opera and WebKit all have outerHTML.<tr><td><a id="l1647"></a><a href="#l1647">1647</a><td>  if (&#39;outerHTML&#39; in element) {<tr><td><a id="l1648"></a><a href="#l1648">1648</a><td>    return element.outerHTML;<tr><td><a id="l1649"></a><a href="#l1649">1649</a><td>  } else {<tr><td><a id="l1650"></a><a href="#l1650">1650</a><td>    var doc = goog.dom.getOwnerDocument(element);<tr><td><a id="l1651"></a><a href="#l1651">1651</a><td>    var div = doc.createElement(goog.dom.TagName.DIV);<tr><td><a id="l1652"></a><a href="#l1652">1652</a><td>    div.appendChild(element.cloneNode(true));<tr><td><a id="l1653"></a><a href="#l1653">1653</a><td>    return div.innerHTML;<tr><td><a id="l1654"></a><a href="#l1654">1654</a><td>  }<tr><td><a id="l1655"></a><a href="#l1655">1655</a><td>};<tr><td><a id="l1656"></a><a href="#l1656">1656</a><td><tr><td><a id="l1657"></a><a href="#l1657">1657</a><td><tr><td><a id="l1658"></a><a href="#l1658">1658</a><td>/**<tr><td><a id="l1659"></a><a href="#l1659">1659</a><td> * Finds the first descendant node that matches the filter function, using<tr><td><a id="l1660"></a><a href="#l1660">1660</a><td> * a depth first search. This function offers the most general purpose way<tr><td><a id="l1661"></a><a href="#l1661">1661</a><td> * of finding a matching element. You may also wish to consider<tr><td><a id="l1662"></a><a href="#l1662">1662</a><td> * {@code goog.dom.query} which can express many matching criteria using<tr><td><a id="l1663"></a><a href="#l1663">1663</a><td> * CSS selector expressions. These expressions often result in a more<tr><td><a id="l1664"></a><a href="#l1664">1664</a><td> * compact representation of the desired result.<tr><td><a id="l1665"></a><a href="#l1665">1665</a><td> * @see goog.dom.query<tr><td><a id="l1666"></a><a href="#l1666">1666</a><td> *<tr><td><a id="l1667"></a><a href="#l1667">1667</a><td> * @param {Node} root The root of the tree to search.<tr><td><a id="l1668"></a><a href="#l1668">1668</a><td> * @param {function(Node) : boolean} p The filter function.<tr><td><a id="l1669"></a><a href="#l1669">1669</a><td> * @return {Node|undefined} The found node or undefined if none is found.<tr><td><a id="l1670"></a><a href="#l1670">1670</a><td> */<tr><td><a id="l1671"></a><a href="#l1671">1671</a><td>goog.dom.findNode = function(root, p) {<tr><td><a id="l1672"></a><a href="#l1672">1672</a><td>  var rv = [];<tr><td><a id="l1673"></a><a href="#l1673">1673</a><td>  var found = goog.dom.findNodes_(root, p, rv, true);<tr><td><a id="l1674"></a><a href="#l1674">1674</a><td>  return found ? rv[0] : undefined;<tr><td><a id="l1675"></a><a href="#l1675">1675</a><td>};<tr><td><a id="l1676"></a><a href="#l1676">1676</a><td><tr><td><a id="l1677"></a><a href="#l1677">1677</a><td><tr><td><a id="l1678"></a><a href="#l1678">1678</a><td>/**<tr><td><a id="l1679"></a><a href="#l1679">1679</a><td> * Finds all the descendant nodes that match the filter function, using a<tr><td><a id="l1680"></a><a href="#l1680">1680</a><td> * a depth first search. This function offers the most general-purpose way<tr><td><a id="l1681"></a><a href="#l1681">1681</a><td> * of finding a set of matching elements. You may also wish to consider<tr><td><a id="l1682"></a><a href="#l1682">1682</a><td> * {@code goog.dom.query} which can express many matching criteria using<tr><td><a id="l1683"></a><a href="#l1683">1683</a><td> * CSS selector expressions. These expressions often result in a more<tr><td><a id="l1684"></a><a href="#l1684">1684</a><td> * compact representation of the desired result.<tr><td><a id="l1685"></a><a href="#l1685">1685</a><td><tr><td><a id="l1686"></a><a href="#l1686">1686</a><td> * @param {Node} root The root of the tree to search.<tr><td><a id="l1687"></a><a href="#l1687">1687</a><td> * @param {function(Node) : boolean} p The filter function.<tr><td><a id="l1688"></a><a href="#l1688">1688</a><td> * @return {!Array&lt;!Node&gt;} The found nodes or an empty array if none are found.<tr><td><a id="l1689"></a><a href="#l1689">1689</a><td> */<tr><td><a id="l1690"></a><a href="#l1690">1690</a><td>goog.dom.findNodes = function(root, p) {<tr><td><a id="l1691"></a><a href="#l1691">1691</a><td>  var rv = [];<tr><td><a id="l1692"></a><a href="#l1692">1692</a><td>  goog.dom.findNodes_(root, p, rv, false);<tr><td><a id="l1693"></a><a href="#l1693">1693</a><td>  return rv;<tr><td><a id="l1694"></a><a href="#l1694">1694</a><td>};<tr><td><a id="l1695"></a><a href="#l1695">1695</a><td><tr><td><a id="l1696"></a><a href="#l1696">1696</a><td><tr><td><a id="l1697"></a><a href="#l1697">1697</a><td>/**<tr><td><a id="l1698"></a><a href="#l1698">1698</a><td> * Finds the first or all the descendant nodes that match the filter function,<tr><td><a id="l1699"></a><a href="#l1699">1699</a><td> * using a depth first search.<tr><td><a id="l1700"></a><a href="#l1700">1700</a><td> * @param {Node} root The root of the tree to search.<tr><td><a id="l1701"></a><a href="#l1701">1701</a><td> * @param {function(Node) : boolean} p The filter function.<tr><td><a id="l1702"></a><a href="#l1702">1702</a><td> * @param {!Array&lt;!Node&gt;} rv The found nodes are added to this array.<tr><td><a id="l1703"></a><a href="#l1703">1703</a><td> * @param {boolean} findOne If true we exit after the first found node.<tr><td><a id="l1704"></a><a href="#l1704">1704</a><td> * @return {boolean} Whether the search is complete or not. True in case findOne<tr><td><a id="l1705"></a><a href="#l1705">1705</a><td> *     is true and the node is found. False otherwise.<tr><td><a id="l1706"></a><a href="#l1706">1706</a><td> * @private<tr><td><a id="l1707"></a><a href="#l1707">1707</a><td> */<tr><td><a id="l1708"></a><a href="#l1708">1708</a><td>goog.dom.findNodes_ = function(root, p, rv, findOne) {<tr><td><a id="l1709"></a><a href="#l1709">1709</a><td>  if (root != null) {<tr><td><a id="l1710"></a><a href="#l1710">1710</a><td>    var child = root.firstChild;<tr><td><a id="l1711"></a><a href="#l1711">1711</a><td>    while (child) {<tr><td><a id="l1712"></a><a href="#l1712">1712</a><td>      if (p(child)) {<tr><td><a id="l1713"></a><a href="#l1713">1713</a><td>        rv.push(child);<tr><td><a id="l1714"></a><a href="#l1714">1714</a><td>        if (findOne) {<tr><td><a id="l1715"></a><a href="#l1715">1715</a><td>          return true;<tr><td><a id="l1716"></a><a href="#l1716">1716</a><td>        }<tr><td><a id="l1717"></a><a href="#l1717">1717</a><td>      }<tr><td><a id="l1718"></a><a href="#l1718">1718</a><td>      if (goog.dom.findNodes_(child, p, rv, findOne)) {<tr><td><a id="l1719"></a><a href="#l1719">1719</a><td>        return true;<tr><td><a id="l1720"></a><a href="#l1720">1720</a><td>      }<tr><td><a id="l1721"></a><a href="#l1721">1721</a><td>      child = child.nextSibling;<tr><td><a id="l1722"></a><a href="#l1722">1722</a><td>    }<tr><td><a id="l1723"></a><a href="#l1723">1723</a><td>  }<tr><td><a id="l1724"></a><a href="#l1724">1724</a><td>  return false;<tr><td><a id="l1725"></a><a href="#l1725">1725</a><td>};<tr><td><a id="l1726"></a><a href="#l1726">1726</a><td><tr><td><a id="l1727"></a><a href="#l1727">1727</a><td><tr><td><a id="l1728"></a><a href="#l1728">1728</a><td>/**<tr><td><a id="l1729"></a><a href="#l1729">1729</a><td> * Map of tags whose content to ignore when calculating text length.<tr><td><a id="l1730"></a><a href="#l1730">1730</a><td> * @private {!Object&lt;string, number&gt;}<tr><td><a id="l1731"></a><a href="#l1731">1731</a><td> * @const<tr><td><a id="l1732"></a><a href="#l1732">1732</a><td> */<tr><td><a id="l1733"></a><a href="#l1733">1733</a><td>goog.dom.TAGS_TO_IGNORE_ = {<tr><td><a id="l1734"></a><a href="#l1734">1734</a><td>  &#39;SCRIPT&#39;: 1,<tr><td><a id="l1735"></a><a href="#l1735">1735</a><td>  &#39;STYLE&#39;: 1,<tr><td><a id="l1736"></a><a href="#l1736">1736</a><td>  &#39;HEAD&#39;: 1,<tr><td><a id="l1737"></a><a href="#l1737">1737</a><td>  &#39;IFRAME&#39;: 1,<tr><td><a id="l1738"></a><a href="#l1738">1738</a><td>  &#39;OBJECT&#39;: 1<tr><td><a id="l1739"></a><a href="#l1739">1739</a><td>};<tr><td><a id="l1740"></a><a href="#l1740">1740</a><td><tr><td><a id="l1741"></a><a href="#l1741">1741</a><td><tr><td><a id="l1742"></a><a href="#l1742">1742</a><td>/**<tr><td><a id="l1743"></a><a href="#l1743">1743</a><td> * Map of tags which have predefined values with regard to whitespace.<tr><td><a id="l1744"></a><a href="#l1744">1744</a><td> * @private {!Object&lt;string, string&gt;}<tr><td><a id="l1745"></a><a href="#l1745">1745</a><td> * @const<tr><td><a id="l1746"></a><a href="#l1746">1746</a><td> */<tr><td><a id="l1747"></a><a href="#l1747">1747</a><td>goog.dom.PREDEFINED_TAG_VALUES_ = {&#39;IMG&#39;: &#39; &#39;, &#39;BR&#39;: &#39;\n&#39;};<tr><td><a id="l1748"></a><a href="#l1748">1748</a><td><tr><td><a id="l1749"></a><a href="#l1749">1749</a><td><tr><td><a id="l1750"></a><a href="#l1750">1750</a><td>/**<tr><td><a id="l1751"></a><a href="#l1751">1751</a><td> * Returns true if the element has a tab index that allows it to receive<tr><td><a id="l1752"></a><a href="#l1752">1752</a><td> * keyboard focus (tabIndex &gt;= 0), false otherwise.  Note that some elements<tr><td><a id="l1753"></a><a href="#l1753">1753</a><td> * natively support keyboard focus, even if they have no tab index.<tr><td><a id="l1754"></a><a href="#l1754">1754</a><td> * @param {!Element} element Element to check.<tr><td><a id="l1755"></a><a href="#l1755">1755</a><td> * @return {boolean} Whether the element has a tab index that allows keyboard<tr><td><a id="l1756"></a><a href="#l1756">1756</a><td> *     focus.<tr><td><a id="l1757"></a><a href="#l1757">1757</a><td> * @see http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/<tr><td><a id="l1758"></a><a href="#l1758">1758</a><td> */<tr><td><a id="l1759"></a><a href="#l1759">1759</a><td>goog.dom.isFocusableTabIndex = function(element) {<tr><td><a id="l1760"></a><a href="#l1760">1760</a><td>  return goog.dom.hasSpecifiedTabIndex_(element) &amp;&amp;<tr><td><a id="l1761"></a><a href="#l1761">1761</a><td>         goog.dom.isTabIndexFocusable_(element);<tr><td><a id="l1762"></a><a href="#l1762">1762</a><td>};<tr><td><a id="l1763"></a><a href="#l1763">1763</a><td><tr><td><a id="l1764"></a><a href="#l1764">1764</a><td><tr><td><a id="l1765"></a><a href="#l1765">1765</a><td>/**<tr><td><a id="l1766"></a><a href="#l1766">1766</a><td> * Enables or disables keyboard focus support on the element via its tab index.<tr><td><a id="l1767"></a><a href="#l1767">1767</a><td> * Only elements for which {@link goog.dom.isFocusableTabIndex} returns true<tr><td><a id="l1768"></a><a href="#l1768">1768</a><td> * (or elements that natively support keyboard focus, like form elements) can<tr><td><a id="l1769"></a><a href="#l1769">1769</a><td> * receive keyboard focus.  See http://go/tabindex for more info.<tr><td><a id="l1770"></a><a href="#l1770">1770</a><td> * @param {Element} element Element whose tab index is to be changed.<tr><td><a id="l1771"></a><a href="#l1771">1771</a><td> * @param {boolean} enable Whether to set or remove a tab index on the element<tr><td><a id="l1772"></a><a href="#l1772">1772</a><td> *     that supports keyboard focus.<tr><td><a id="l1773"></a><a href="#l1773">1773</a><td> */<tr><td><a id="l1774"></a><a href="#l1774">1774</a><td>goog.dom.setFocusableTabIndex = function(element, enable) {<tr><td><a id="l1775"></a><a href="#l1775">1775</a><td>  if (enable) {<tr><td><a id="l1776"></a><a href="#l1776">1776</a><td>    element.tabIndex = 0;<tr><td><a id="l1777"></a><a href="#l1777">1777</a><td>  } else {<tr><td><a id="l1778"></a><a href="#l1778">1778</a><td>    // Set tabIndex to -1 first, then remove it. This is a workaround for<tr><td><a id="l1779"></a><a href="#l1779">1779</a><td>    // Safari (confirmed in version 4 on Windows). When removing the attribute<tr><td><a id="l1780"></a><a href="#l1780">1780</a><td>    // without setting it to -1 first, the element remains keyboard focusable<tr><td><a id="l1781"></a><a href="#l1781">1781</a><td>    // despite not having a tabIndex attribute anymore.<tr><td><a id="l1782"></a><a href="#l1782">1782</a><td>    element.tabIndex = -1;<tr><td><a id="l1783"></a><a href="#l1783">1783</a><td>    element.removeAttribute(&#39;tabIndex&#39;); // Must be camelCase!<tr><td><a id="l1784"></a><a href="#l1784">1784</a><td>  }<tr><td><a id="l1785"></a><a href="#l1785">1785</a><td>};<tr><td><a id="l1786"></a><a href="#l1786">1786</a><td><tr><td><a id="l1787"></a><a href="#l1787">1787</a><td><tr><td><a id="l1788"></a><a href="#l1788">1788</a><td>/**<tr><td><a id="l1789"></a><a href="#l1789">1789</a><td> * Returns true if the element can be focused, i.e. it has a tab index that<tr><td><a id="l1790"></a><a href="#l1790">1790</a><td> * allows it to receive keyboard focus (tabIndex &gt;= 0), or it is an element<tr><td><a id="l1791"></a><a href="#l1791">1791</a><td> * that natively supports keyboard focus.<tr><td><a id="l1792"></a><a href="#l1792">1792</a><td> * @param {!Element} element Element to check.<tr><td><a id="l1793"></a><a href="#l1793">1793</a><td> * @return {boolean} Whether the element allows keyboard focus.<tr><td><a id="l1794"></a><a href="#l1794">1794</a><td> */<tr><td><a id="l1795"></a><a href="#l1795">1795</a><td>goog.dom.isFocusable = function(element) {<tr><td><a id="l1796"></a><a href="#l1796">1796</a><td>  var focusable;<tr><td><a id="l1797"></a><a href="#l1797">1797</a><td>  // Some elements can have unspecified tab index and still receive focus.<tr><td><a id="l1798"></a><a href="#l1798">1798</a><td>  if (goog.dom.nativelySupportsFocus_(element)) {<tr><td><a id="l1799"></a><a href="#l1799">1799</a><td>    // Make sure the element is not disabled ...<tr><td><a id="l1800"></a><a href="#l1800">1800</a><td>    focusable = !element.disabled &amp;&amp;<tr><td><a id="l1801"></a><a href="#l1801">1801</a><td>        // ... and if a tab index is specified, it allows focus.<tr><td><a id="l1802"></a><a href="#l1802">1802</a><td>        (!goog.dom.hasSpecifiedTabIndex_(element) ||<tr><td><a id="l1803"></a><a href="#l1803">1803</a><td>         goog.dom.isTabIndexFocusable_(element));<tr><td><a id="l1804"></a><a href="#l1804">1804</a><td>  } else {<tr><td><a id="l1805"></a><a href="#l1805">1805</a><td>    focusable = goog.dom.isFocusableTabIndex(element);<tr><td><a id="l1806"></a><a href="#l1806">1806</a><td>  }<tr><td><a id="l1807"></a><a href="#l1807">1807</a><td><tr><td><a id="l1808"></a><a href="#l1808">1808</a><td>  // IE requires elements to be visible in order to focus them.<tr><td><a id="l1809"></a><a href="#l1809">1809</a><td>  return focusable &amp;&amp; goog.userAgent.IE ?<tr><td><a id="l1810"></a><a href="#l1810">1810</a><td>             goog.dom.hasNonZeroBoundingRect_(element) : focusable;<tr><td><a id="l1811"></a><a href="#l1811">1811</a><td>};<tr><td><a id="l1812"></a><a href="#l1812">1812</a><td><tr><td><a id="l1813"></a><a href="#l1813">1813</a><td><tr><td><a id="l1814"></a><a href="#l1814">1814</a><td>/**<tr><td><a id="l1815"></a><a href="#l1815">1815</a><td> * Returns true if the element has a specified tab index.<tr><td><a id="l1816"></a><a href="#l1816">1816</a><td> * @param {!Element} element Element to check.<tr><td><a id="l1817"></a><a href="#l1817">1817</a><td> * @return {boolean} Whether the element has a specified tab index.<tr><td><a id="l1818"></a><a href="#l1818">1818</a><td> * @private<tr><td><a id="l1819"></a><a href="#l1819">1819</a><td> */<tr><td><a id="l1820"></a><a href="#l1820">1820</a><td>goog.dom.hasSpecifiedTabIndex_ = function(element) {<tr><td><a id="l1821"></a><a href="#l1821">1821</a><td>  // IE returns 0 for an unset tabIndex, so we must use getAttributeNode(),<tr><td><a id="l1822"></a><a href="#l1822">1822</a><td>  // which returns an object with a &#39;specified&#39; property if tabIndex is<tr><td><a id="l1823"></a><a href="#l1823">1823</a><td>  // specified.  This works on other browsers, too.<tr><td><a id="l1824"></a><a href="#l1824">1824</a><td>  var attrNode = element.getAttributeNode(&#39;tabindex&#39;); // Must be lowercase!<tr><td><a id="l1825"></a><a href="#l1825">1825</a><td>  return goog.isDefAndNotNull(attrNode) &amp;&amp; attrNode.specified;<tr><td><a id="l1826"></a><a href="#l1826">1826</a><td>};<tr><td><a id="l1827"></a><a href="#l1827">1827</a><td><tr><td><a id="l1828"></a><a href="#l1828">1828</a><td><tr><td><a id="l1829"></a><a href="#l1829">1829</a><td>/**<tr><td><a id="l1830"></a><a href="#l1830">1830</a><td> * Returns true if the element&#39;s tab index allows the element to be focused.<tr><td><a id="l1831"></a><a href="#l1831">1831</a><td> * @param {!Element} element Element to check.<tr><td><a id="l1832"></a><a href="#l1832">1832</a><td> * @return {boolean} Whether the element&#39;s tab index allows focus.<tr><td><a id="l1833"></a><a href="#l1833">1833</a><td> * @private<tr><td><a id="l1834"></a><a href="#l1834">1834</a><td> */<tr><td><a id="l1835"></a><a href="#l1835">1835</a><td>goog.dom.isTabIndexFocusable_ = function(element) {<tr><td><a id="l1836"></a><a href="#l1836">1836</a><td>  var index = element.tabIndex;<tr><td><a id="l1837"></a><a href="#l1837">1837</a><td>  // NOTE: IE9 puts tabIndex in 16-bit int, e.g. -2 is 65534.<tr><td><a id="l1838"></a><a href="#l1838">1838</a><td>  return goog.isNumber(index) &amp;&amp; index &gt;= 0 &amp;&amp; index &lt; 32768;<tr><td><a id="l1839"></a><a href="#l1839">1839</a><td>};<tr><td><a id="l1840"></a><a href="#l1840">1840</a><td><tr><td><a id="l1841"></a><a href="#l1841">1841</a><td><tr><td><a id="l1842"></a><a href="#l1842">1842</a><td>/**<tr><td><a id="l1843"></a><a href="#l1843">1843</a><td> * Returns true if the element is focusable even when tabIndex is not set.<tr><td><a id="l1844"></a><a href="#l1844">1844</a><td> * @param {!Element} element Element to check.<tr><td><a id="l1845"></a><a href="#l1845">1845</a><td> * @return {boolean} Whether the element natively supports focus.<tr><td><a id="l1846"></a><a href="#l1846">1846</a><td> * @private<tr><td><a id="l1847"></a><a href="#l1847">1847</a><td> */<tr><td><a id="l1848"></a><a href="#l1848">1848</a><td>goog.dom.nativelySupportsFocus_ = function(element) {<tr><td><a id="l1849"></a><a href="#l1849">1849</a><td>  return element.tagName == goog.dom.TagName.A ||<tr><td><a id="l1850"></a><a href="#l1850">1850</a><td>         element.tagName == goog.dom.TagName.INPUT ||<tr><td><a id="l1851"></a><a href="#l1851">1851</a><td>         element.tagName == goog.dom.TagName.TEXTAREA ||<tr><td><a id="l1852"></a><a href="#l1852">1852</a><td>         element.tagName == goog.dom.TagName.SELECT ||<tr><td><a id="l1853"></a><a href="#l1853">1853</a><td>         element.tagName == goog.dom.TagName.BUTTON;<tr><td><a id="l1854"></a><a href="#l1854">1854</a><td>};<tr><td><a id="l1855"></a><a href="#l1855">1855</a><td><tr><td><a id="l1856"></a><a href="#l1856">1856</a><td><tr><td><a id="l1857"></a><a href="#l1857">1857</a><td>/**<tr><td><a id="l1858"></a><a href="#l1858">1858</a><td> * Returns true if the element has a bounding rectangle that would be visible<tr><td><a id="l1859"></a><a href="#l1859">1859</a><td> * (i.e. its width and height are greater than zero).<tr><td><a id="l1860"></a><a href="#l1860">1860</a><td> * @param {!Element} element Element to check.<tr><td><a id="l1861"></a><a href="#l1861">1861</a><td> * @return {boolean} Whether the element has a non-zero bounding rectangle.<tr><td><a id="l1862"></a><a href="#l1862">1862</a><td> * @private<tr><td><a id="l1863"></a><a href="#l1863">1863</a><td> */<tr><td><a id="l1864"></a><a href="#l1864">1864</a><td>goog.dom.hasNonZeroBoundingRect_ = function(element) {<tr><td><a id="l1865"></a><a href="#l1865">1865</a><td>  var rect = goog.isFunction(element[&#39;getBoundingClientRect&#39;]) ?<tr><td><a id="l1866"></a><a href="#l1866">1866</a><td>      element.getBoundingClientRect() :<tr><td><a id="l1867"></a><a href="#l1867">1867</a><td>      {&#39;height&#39;: element.offsetHeight, &#39;width&#39;: element.offsetWidth};<tr><td><a id="l1868"></a><a href="#l1868">1868</a><td>  return goog.isDefAndNotNull(rect) &amp;&amp; rect.height &gt; 0 &amp;&amp; rect.width &gt; 0;<tr><td><a id="l1869"></a><a href="#l1869">1869</a><td>};<tr><td><a id="l1870"></a><a href="#l1870">1870</a><td><tr><td><a id="l1871"></a><a href="#l1871">1871</a><td><tr><td><a id="l1872"></a><a href="#l1872">1872</a><td>/**<tr><td><a id="l1873"></a><a href="#l1873">1873</a><td> * Returns the text content of the current node, without markup and invisible<tr><td><a id="l1874"></a><a href="#l1874">1874</a><td> * symbols. New lines are stripped and whitespace is collapsed,<tr><td><a id="l1875"></a><a href="#l1875">1875</a><td> * such that each character would be visible.<tr><td><a id="l1876"></a><a href="#l1876">1876</a><td> *<tr><td><a id="l1877"></a><a href="#l1877">1877</a><td> * In browsers that support it, innerText is used.  Other browsers attempt to<tr><td><a id="l1878"></a><a href="#l1878">1878</a><td> * simulate it via node traversal.  Line breaks are canonicalized in IE.<tr><td><a id="l1879"></a><a href="#l1879">1879</a><td> *<tr><td><a id="l1880"></a><a href="#l1880">1880</a><td> * @param {Node} node The node from which we are getting content.<tr><td><a id="l1881"></a><a href="#l1881">1881</a><td> * @return {string} The text content.<tr><td><a id="l1882"></a><a href="#l1882">1882</a><td> */<tr><td><a id="l1883"></a><a href="#l1883">1883</a><td>goog.dom.getTextContent = function(node) {<tr><td><a id="l1884"></a><a href="#l1884">1884</a><td>  var textContent;<tr><td><a id="l1885"></a><a href="#l1885">1885</a><td>  // Note(arv): IE9, Opera, and Safari 3 support innerText but they include<tr><td><a id="l1886"></a><a href="#l1886">1886</a><td>  // text nodes in script tags. So we revert to use a user agent test here.<tr><td><a id="l1887"></a><a href="#l1887">1887</a><td>  if (goog.dom.BrowserFeature.CAN_USE_INNER_TEXT &amp;&amp; (&#39;innerText&#39; in node)) {<tr><td><a id="l1888"></a><a href="#l1888">1888</a><td>    textContent = goog.string.canonicalizeNewlines(node.innerText);<tr><td><a id="l1889"></a><a href="#l1889">1889</a><td>    // Unfortunately .innerText() returns text with &amp;shy; symbols<tr><td><a id="l1890"></a><a href="#l1890">1890</a><td>    // We need to filter it out and then remove duplicate whitespaces<tr><td><a id="l1891"></a><a href="#l1891">1891</a><td>  } else {<tr><td><a id="l1892"></a><a href="#l1892">1892</a><td>    var buf = [];<tr><td><a id="l1893"></a><a href="#l1893">1893</a><td>    goog.dom.getTextContent_(node, buf, true);<tr><td><a id="l1894"></a><a href="#l1894">1894</a><td>    textContent = buf.join(&#39;&#39;);<tr><td><a id="l1895"></a><a href="#l1895">1895</a><td>  }<tr><td><a id="l1896"></a><a href="#l1896">1896</a><td><tr><td><a id="l1897"></a><a href="#l1897">1897</a><td>  // Strip &amp;shy; entities. goog.format.insertWordBreaks inserts them in Opera.<tr><td><a id="l1898"></a><a href="#l1898">1898</a><td>  textContent = textContent.replace(/ \xAD /g, &#39; &#39;).replace(/\xAD/g, &#39;&#39;);<tr><td><a id="l1899"></a><a href="#l1899">1899</a><td>  // Strip &amp;#8203; entities. goog.format.insertWordBreaks inserts them in IE8.<tr><td><a id="l1900"></a><a href="#l1900">1900</a><td>  textContent = textContent.replace(/\u200B/g, &#39;&#39;);<tr><td><a id="l1901"></a><a href="#l1901">1901</a><td><tr><td><a id="l1902"></a><a href="#l1902">1902</a><td>  // Skip this replacement on old browsers with working innerText, which<tr><td><a id="l1903"></a><a href="#l1903">1903</a><td>  // automatically turns &amp;nbsp; into &#39; &#39; and / +/ into &#39; &#39; when reading<tr><td><a id="l1904"></a><a href="#l1904">1904</a><td>  // innerText.<tr><td><a id="l1905"></a><a href="#l1905">1905</a><td>  if (!goog.dom.BrowserFeature.CAN_USE_INNER_TEXT) {<tr><td><a id="l1906"></a><a href="#l1906">1906</a><td>    textContent = textContent.replace(/ +/g, &#39; &#39;);<tr><td><a id="l1907"></a><a href="#l1907">1907</a><td>  }<tr><td><a id="l1908"></a><a href="#l1908">1908</a><td>  if (textContent != &#39; &#39;) {<tr><td><a id="l1909"></a><a href="#l1909">1909</a><td>    textContent = textContent.replace(/^\s*/, &#39;&#39;);<tr><td><a id="l1910"></a><a href="#l1910">1910</a><td>  }<tr><td><a id="l1911"></a><a href="#l1911">1911</a><td><tr><td><a id="l1912"></a><a href="#l1912">1912</a><td>  return textContent;<tr><td><a id="l1913"></a><a href="#l1913">1913</a><td>};<tr><td><a id="l1914"></a><a href="#l1914">1914</a><td><tr><td><a id="l1915"></a><a href="#l1915">1915</a><td><tr><td><a id="l1916"></a><a href="#l1916">1916</a><td>/**<tr><td><a id="l1917"></a><a href="#l1917">1917</a><td> * Returns the text content of the current node, without markup.<tr><td><a id="l1918"></a><a href="#l1918">1918</a><td> *<tr><td><a id="l1919"></a><a href="#l1919">1919</a><td> * Unlike {@code getTextContent} this method does not collapse whitespaces<tr><td><a id="l1920"></a><a href="#l1920">1920</a><td> * or normalize lines breaks.<tr><td><a id="l1921"></a><a href="#l1921">1921</a><td> *<tr><td><a id="l1922"></a><a href="#l1922">1922</a><td> * @param {Node} node The node from which we are getting content.<tr><td><a id="l1923"></a><a href="#l1923">1923</a><td> * @return {string} The raw text content.<tr><td><a id="l1924"></a><a href="#l1924">1924</a><td> */<tr><td><a id="l1925"></a><a href="#l1925">1925</a><td>goog.dom.getRawTextContent = function(node) {<tr><td><a id="l1926"></a><a href="#l1926">1926</a><td>  var buf = [];<tr><td><a id="l1927"></a><a href="#l1927">1927</a><td>  goog.dom.getTextContent_(node, buf, false);<tr><td><a id="l1928"></a><a href="#l1928">1928</a><td><tr><td><a id="l1929"></a><a href="#l1929">1929</a><td>  return buf.join(&#39;&#39;);<tr><td><a id="l1930"></a><a href="#l1930">1930</a><td>};<tr><td><a id="l1931"></a><a href="#l1931">1931</a><td><tr><td><a id="l1932"></a><a href="#l1932">1932</a><td><tr><td><a id="l1933"></a><a href="#l1933">1933</a><td>/**<tr><td><a id="l1934"></a><a href="#l1934">1934</a><td> * Recursive support function for text content retrieval.<tr><td><a id="l1935"></a><a href="#l1935">1935</a><td> *<tr><td><a id="l1936"></a><a href="#l1936">1936</a><td> * @param {Node} node The node from which we are getting content.<tr><td><a id="l1937"></a><a href="#l1937">1937</a><td> * @param {Array&lt;string&gt;} buf string buffer.<tr><td><a id="l1938"></a><a href="#l1938">1938</a><td> * @param {boolean} normalizeWhitespace Whether to normalize whitespace.<tr><td><a id="l1939"></a><a href="#l1939">1939</a><td> * @private<tr><td><a id="l1940"></a><a href="#l1940">1940</a><td> */<tr><td><a id="l1941"></a><a href="#l1941">1941</a><td>goog.dom.getTextContent_ = function(node, buf, normalizeWhitespace) {<tr><td><a id="l1942"></a><a href="#l1942">1942</a><td>  if (node.nodeName in goog.dom.TAGS_TO_IGNORE_) {<tr><td><a id="l1943"></a><a href="#l1943">1943</a><td>    // ignore certain tags<tr><td><a id="l1944"></a><a href="#l1944">1944</a><td>  } else if (node.nodeType == goog.dom.NodeType.TEXT) {<tr><td><a id="l1945"></a><a href="#l1945">1945</a><td>    if (normalizeWhitespace) {<tr><td><a id="l1946"></a><a href="#l1946">1946</a><td>      buf.push(String(node.nodeValue).replace(/(\r\n|\r|\n)/g, &#39;&#39;));<tr><td><a id="l1947"></a><a href="#l1947">1947</a><td>    } else {<tr><td><a id="l1948"></a><a href="#l1948">1948</a><td>      buf.push(node.nodeValue);<tr><td><a id="l1949"></a><a href="#l1949">1949</a><td>    }<tr><td><a id="l1950"></a><a href="#l1950">1950</a><td>  } else if (node.nodeName in goog.dom.PREDEFINED_TAG_VALUES_) {<tr><td><a id="l1951"></a><a href="#l1951">1951</a><td>    buf.push(goog.dom.PREDEFINED_TAG_VALUES_[node.nodeName]);<tr><td><a id="l1952"></a><a href="#l1952">1952</a><td>  } else {<tr><td><a id="l1953"></a><a href="#l1953">1953</a><td>    var child = node.firstChild;<tr><td><a id="l1954"></a><a href="#l1954">1954</a><td>    while (child) {<tr><td><a id="l1955"></a><a href="#l1955">1955</a><td>      goog.dom.getTextContent_(child, buf, normalizeWhitespace);<tr><td><a id="l1956"></a><a href="#l1956">1956</a><td>      child = child.nextSibling;<tr><td><a id="l1957"></a><a href="#l1957">1957</a><td>    }<tr><td><a id="l1958"></a><a href="#l1958">1958</a><td>  }<tr><td><a id="l1959"></a><a href="#l1959">1959</a><td>};<tr><td><a id="l1960"></a><a href="#l1960">1960</a><td><tr><td><a id="l1961"></a><a href="#l1961">1961</a><td><tr><td><a id="l1962"></a><a href="#l1962">1962</a><td>/**<tr><td><a id="l1963"></a><a href="#l1963">1963</a><td> * Returns the text length of the text contained in a node, without markup. This<tr><td><a id="l1964"></a><a href="#l1964">1964</a><td> * is equivalent to the selection length if the node was selected, or the number<tr><td><a id="l1965"></a><a href="#l1965">1965</a><td> * of cursor movements to traverse the node. Images &amp; BRs take one space.  New<tr><td><a id="l1966"></a><a href="#l1966">1966</a><td> * lines are ignored.<tr><td><a id="l1967"></a><a href="#l1967">1967</a><td> *<tr><td><a id="l1968"></a><a href="#l1968">1968</a><td> * @param {Node} node The node whose text content length is being calculated.<tr><td><a id="l1969"></a><a href="#l1969">1969</a><td> * @return {number} The length of {@code node}&#39;s text content.<tr><td><a id="l1970"></a><a href="#l1970">1970</a><td> */<tr><td><a id="l1971"></a><a href="#l1971">1971</a><td>goog.dom.getNodeTextLength = function(node) {<tr><td><a id="l1972"></a><a href="#l1972">1972</a><td>  return goog.dom.getTextContent(node).length;<tr><td><a id="l1973"></a><a href="#l1973">1973</a><td>};<tr><td><a id="l1974"></a><a href="#l1974">1974</a><td><tr><td><a id="l1975"></a><a href="#l1975">1975</a><td><tr><td><a id="l1976"></a><a href="#l1976">1976</a><td>/**<tr><td><a id="l1977"></a><a href="#l1977">1977</a><td> * Returns the text offset of a node relative to one of its ancestors. The text<tr><td><a id="l1978"></a><a href="#l1978">1978</a><td> * length is the same as the length calculated by goog.dom.getNodeTextLength.<tr><td><a id="l1979"></a><a href="#l1979">1979</a><td> *<tr><td><a id="l1980"></a><a href="#l1980">1980</a><td> * @param {Node} node The node whose offset is being calculated.<tr><td><a id="l1981"></a><a href="#l1981">1981</a><td> * @param {Node=} opt_offsetParent The node relative to which the offset will<tr><td><a id="l1982"></a><a href="#l1982">1982</a><td> *     be calculated. Defaults to the node&#39;s owner document&#39;s body.<tr><td><a id="l1983"></a><a href="#l1983">1983</a><td> * @return {number} The text offset.<tr><td><a id="l1984"></a><a href="#l1984">1984</a><td> */<tr><td><a id="l1985"></a><a href="#l1985">1985</a><td>goog.dom.getNodeTextOffset = function(node, opt_offsetParent) {<tr><td><a id="l1986"></a><a href="#l1986">1986</a><td>  var root = opt_offsetParent || goog.dom.getOwnerDocument(node).body;<tr><td><a id="l1987"></a><a href="#l1987">1987</a><td>  var buf = [];<tr><td><a id="l1988"></a><a href="#l1988">1988</a><td>  while (node &amp;&amp; node != root) {<tr><td><a id="l1989"></a><a href="#l1989">1989</a><td>    var cur = node;<tr><td><a id="l1990"></a><a href="#l1990">1990</a><td>    while ((cur = cur.previousSibling)) {<tr><td><a id="l1991"></a><a href="#l1991">1991</a><td>      buf.unshift(goog.dom.getTextContent(cur));<tr><td><a id="l1992"></a><a href="#l1992">1992</a><td>    }<tr><td><a id="l1993"></a><a href="#l1993">1993</a><td>    node = node.parentNode;<tr><td><a id="l1994"></a><a href="#l1994">1994</a><td>  }<tr><td><a id="l1995"></a><a href="#l1995">1995</a><td>  // Trim left to deal with FF cases when there might be line breaks and empty<tr><td><a id="l1996"></a><a href="#l1996">1996</a><td>  // nodes at the front of the text<tr><td><a id="l1997"></a><a href="#l1997">1997</a><td>  return goog.string.trimLeft(buf.join(&#39;&#39;)).replace(/ +/g, &#39; &#39;).length;<tr><td><a id="l1998"></a><a href="#l1998">1998</a><td>};<tr><td><a id="l1999"></a><a href="#l1999">1999</a><td><tr><td><a id="l2000"></a><a href="#l2000">2000</a><td><tr><td><a id="l2001"></a><a href="#l2001">2001</a><td>/**<tr><td><a id="l2002"></a><a href="#l2002">2002</a><td> * Returns the node at a given offset in a parent node.  If an object is<tr><td><a id="l2003"></a><a href="#l2003">2003</a><td> * provided for the optional third parameter, the node and the remainder of the<tr><td><a id="l2004"></a><a href="#l2004">2004</a><td> * offset will stored as properties of this object.<tr><td><a id="l2005"></a><a href="#l2005">2005</a><td> * @param {Node} parent The parent node.<tr><td><a id="l2006"></a><a href="#l2006">2006</a><td> * @param {number} offset The offset into the parent node.<tr><td><a id="l2007"></a><a href="#l2007">2007</a><td> * @param {Object=} opt_result Object to be used to store the return value. The<tr><td><a id="l2008"></a><a href="#l2008">2008</a><td> *     return value will be stored in the form {node: Node, remainder: number}<tr><td><a id="l2009"></a><a href="#l2009">2009</a><td> *     if this object is provided.<tr><td><a id="l2010"></a><a href="#l2010">2010</a><td> * @return {Node} The node at the given offset.<tr><td><a id="l2011"></a><a href="#l2011">2011</a><td> */<tr><td><a id="l2012"></a><a href="#l2012">2012</a><td>goog.dom.getNodeAtOffset = function(parent, offset, opt_result) {<tr><td><a id="l2013"></a><a href="#l2013">2013</a><td>  var stack = [parent], pos = 0, cur = null;<tr><td><a id="l2014"></a><a href="#l2014">2014</a><td>  while (stack.length &gt; 0 &amp;&amp; pos &lt; offset) {<tr><td><a id="l2015"></a><a href="#l2015">2015</a><td>    cur = stack.pop();<tr><td><a id="l2016"></a><a href="#l2016">2016</a><td>    if (cur.nodeName in goog.dom.TAGS_TO_IGNORE_) {<tr><td><a id="l2017"></a><a href="#l2017">2017</a><td>      // ignore certain tags<tr><td><a id="l2018"></a><a href="#l2018">2018</a><td>    } else if (cur.nodeType == goog.dom.NodeType.TEXT) {<tr><td><a id="l2019"></a><a href="#l2019">2019</a><td>      var text = cur.nodeValue.replace(/(\r\n|\r|\n)/g, &#39;&#39;).replace(/ +/g, &#39; &#39;);<tr><td><a id="l2020"></a><a href="#l2020">2020</a><td>      pos += text.length;<tr><td><a id="l2021"></a><a href="#l2021">2021</a><td>    } else if (cur.nodeName in goog.dom.PREDEFINED_TAG_VALUES_) {<tr><td><a id="l2022"></a><a href="#l2022">2022</a><td>      pos += goog.dom.PREDEFINED_TAG_VALUES_[cur.nodeName].length;<tr><td><a id="l2023"></a><a href="#l2023">2023</a><td>    } else {<tr><td><a id="l2024"></a><a href="#l2024">2024</a><td>      for (var i = cur.childNodes.length - 1; i &gt;= 0; i--) {<tr><td><a id="l2025"></a><a href="#l2025">2025</a><td>        stack.push(cur.childNodes[i]);<tr><td><a id="l2026"></a><a href="#l2026">2026</a><td>      }<tr><td><a id="l2027"></a><a href="#l2027">2027</a><td>    }<tr><td><a id="l2028"></a><a href="#l2028">2028</a><td>  }<tr><td><a id="l2029"></a><a href="#l2029">2029</a><td>  if (goog.isObject(opt_result)) {<tr><td><a id="l2030"></a><a href="#l2030">2030</a><td>    opt_result.remainder = cur ? cur.nodeValue.length + offset - pos - 1 : 0;<tr><td><a id="l2031"></a><a href="#l2031">2031</a><td>    opt_result.node = cur;<tr><td><a id="l2032"></a><a href="#l2032">2032</a><td>  }<tr><td><a id="l2033"></a><a href="#l2033">2033</a><td><tr><td><a id="l2034"></a><a href="#l2034">2034</a><td>  return cur;<tr><td><a id="l2035"></a><a href="#l2035">2035</a><td>};<tr><td><a id="l2036"></a><a href="#l2036">2036</a><td><tr><td><a id="l2037"></a><a href="#l2037">2037</a><td><tr><td><a id="l2038"></a><a href="#l2038">2038</a><td>/**<tr><td><a id="l2039"></a><a href="#l2039">2039</a><td> * Returns true if the object is a {@code NodeList}.  To qualify as a NodeList,<tr><td><a id="l2040"></a><a href="#l2040">2040</a><td> * the object must have a numeric length property and an item function (which<tr><td><a id="l2041"></a><a href="#l2041">2041</a><td> * has type &#39;string&#39; on IE for some reason).<tr><td><a id="l2042"></a><a href="#l2042">2042</a><td> * @param {Object} val Object to test.<tr><td><a id="l2043"></a><a href="#l2043">2043</a><td> * @return {boolean} Whether the object is a NodeList.<tr><td><a id="l2044"></a><a href="#l2044">2044</a><td> */<tr><td><a id="l2045"></a><a href="#l2045">2045</a><td>goog.dom.isNodeList = function(val) {<tr><td><a id="l2046"></a><a href="#l2046">2046</a><td>  // TODO(attila): Now the isNodeList is part of goog.dom we can use<tr><td><a id="l2047"></a><a href="#l2047">2047</a><td>  // goog.userAgent to make this simpler.<tr><td><a id="l2048"></a><a href="#l2048">2048</a><td>  // A NodeList must have a length property of type &#39;number&#39; on all platforms.<tr><td><a id="l2049"></a><a href="#l2049">2049</a><td>  if (val &amp;&amp; typeof val.length == &#39;number&#39;) {<tr><td><a id="l2050"></a><a href="#l2050">2050</a><td>    // A NodeList is an object everywhere except Safari, where it&#39;s a function.<tr><td><a id="l2051"></a><a href="#l2051">2051</a><td>    if (goog.isObject(val)) {<tr><td><a id="l2052"></a><a href="#l2052">2052</a><td>      // A NodeList must have an item function (on non-IE platforms) or an item<tr><td><a id="l2053"></a><a href="#l2053">2053</a><td>      // property of type &#39;string&#39; (on IE).<tr><td><a id="l2054"></a><a href="#l2054">2054</a><td>      return typeof val.item == &#39;function&#39; || typeof val.item == &#39;string&#39;;<tr><td><a id="l2055"></a><a href="#l2055">2055</a><td>    } else if (goog.isFunction(val)) {<tr><td><a id="l2056"></a><a href="#l2056">2056</a><td>      // On Safari, a NodeList is a function with an item property that is also<tr><td><a id="l2057"></a><a href="#l2057">2057</a><td>      // a function.<tr><td><a id="l2058"></a><a href="#l2058">2058</a><td>      return typeof val.item == &#39;function&#39;;<tr><td><a id="l2059"></a><a href="#l2059">2059</a><td>    }<tr><td><a id="l2060"></a><a href="#l2060">2060</a><td>  }<tr><td><a id="l2061"></a><a href="#l2061">2061</a><td><tr><td><a id="l2062"></a><a href="#l2062">2062</a><td>  // Not a NodeList.<tr><td><a id="l2063"></a><a href="#l2063">2063</a><td>  return false;<tr><td><a id="l2064"></a><a href="#l2064">2064</a><td>};<tr><td><a id="l2065"></a><a href="#l2065">2065</a><td><tr><td><a id="l2066"></a><a href="#l2066">2066</a><td><tr><td><a id="l2067"></a><a href="#l2067">2067</a><td>/**<tr><td><a id="l2068"></a><a href="#l2068">2068</a><td> * Walks up the DOM hierarchy returning the first ancestor that has the passed<tr><td><a id="l2069"></a><a href="#l2069">2069</a><td> * tag name and/or class name. If the passed element matches the specified<tr><td><a id="l2070"></a><a href="#l2070">2070</a><td> * criteria, the element itself is returned.<tr><td><a id="l2071"></a><a href="#l2071">2071</a><td> * @param {Node} element The DOM node to start with.<tr><td><a id="l2072"></a><a href="#l2072">2072</a><td> * @param {?(goog.dom.TagName|string)=} opt_tag The tag name to match (or<tr><td><a id="l2073"></a><a href="#l2073">2073</a><td> *     null/undefined to match only based on class name).<tr><td><a id="l2074"></a><a href="#l2074">2074</a><td> * @param {?string=} opt_class The class name to match (or null/undefined to<tr><td><a id="l2075"></a><a href="#l2075">2075</a><td> *     match only based on tag name).<tr><td><a id="l2076"></a><a href="#l2076">2076</a><td> * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the<tr><td><a id="l2077"></a><a href="#l2077">2077</a><td> *     dom.<tr><td><a id="l2078"></a><a href="#l2078">2078</a><td> * @return {Element} The first ancestor that matches the passed criteria, or<tr><td><a id="l2079"></a><a href="#l2079">2079</a><td> *     null if no match is found.<tr><td><a id="l2080"></a><a href="#l2080">2080</a><td> */<tr><td><a id="l2081"></a><a href="#l2081">2081</a><td>goog.dom.getAncestorByTagNameAndClass = function(element, opt_tag, opt_class,<tr><td><a id="l2082"></a><a href="#l2082">2082</a><td>    opt_maxSearchSteps) {<tr><td><a id="l2083"></a><a href="#l2083">2083</a><td>  if (!opt_tag &amp;&amp; !opt_class) {<tr><td><a id="l2084"></a><a href="#l2084">2084</a><td>    return null;<tr><td><a id="l2085"></a><a href="#l2085">2085</a><td>  }<tr><td><a id="l2086"></a><a href="#l2086">2086</a><td>  var tagName = opt_tag ? opt_tag.toUpperCase() : null;<tr><td><a id="l2087"></a><a href="#l2087">2087</a><td>  return /** @type {Element} */ (goog.dom.getAncestor(element,<tr><td><a id="l2088"></a><a href="#l2088">2088</a><td>      function(node) {<tr><td><a id="l2089"></a><a href="#l2089">2089</a><td>        return (!tagName || node.nodeName == tagName) &amp;&amp;<tr><td><a id="l2090"></a><a href="#l2090">2090</a><td>               (!opt_class || goog.isString(node.className) &amp;&amp;<tr><td><a id="l2091"></a><a href="#l2091">2091</a><td>                   goog.array.contains(node.className.split(/\s+/), opt_class));<tr><td><a id="l2092"></a><a href="#l2092">2092</a><td>      }, true, opt_maxSearchSteps));<tr><td><a id="l2093"></a><a href="#l2093">2093</a><td>};<tr><td><a id="l2094"></a><a href="#l2094">2094</a><td><tr><td><a id="l2095"></a><a href="#l2095">2095</a><td><tr><td><a id="l2096"></a><a href="#l2096">2096</a><td>/**<tr><td><a id="l2097"></a><a href="#l2097">2097</a><td> * Walks up the DOM hierarchy returning the first ancestor that has the passed<tr><td><a id="l2098"></a><a href="#l2098">2098</a><td> * class name. If the passed element matches the specified criteria, the<tr><td><a id="l2099"></a><a href="#l2099">2099</a><td> * element itself is returned.<tr><td><a id="l2100"></a><a href="#l2100">2100</a><td> * @param {Node} element The DOM node to start with.<tr><td><a id="l2101"></a><a href="#l2101">2101</a><td> * @param {string} className The class name to match.<tr><td><a id="l2102"></a><a href="#l2102">2102</a><td> * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the<tr><td><a id="l2103"></a><a href="#l2103">2103</a><td> *     dom.<tr><td><a id="l2104"></a><a href="#l2104">2104</a><td> * @return {Element} The first ancestor that matches the passed criteria, or<tr><td><a id="l2105"></a><a href="#l2105">2105</a><td> *     null if none match.<tr><td><a id="l2106"></a><a href="#l2106">2106</a><td> */<tr><td><a id="l2107"></a><a href="#l2107">2107</a><td>goog.dom.getAncestorByClass = function(element, className, opt_maxSearchSteps) {<tr><td><a id="l2108"></a><a href="#l2108">2108</a><td>  return goog.dom.getAncestorByTagNameAndClass(element, null, className,<tr><td><a id="l2109"></a><a href="#l2109">2109</a><td>      opt_maxSearchSteps);<tr><td><a id="l2110"></a><a href="#l2110">2110</a><td>};<tr><td><a id="l2111"></a><a href="#l2111">2111</a><td><tr><td><a id="l2112"></a><a href="#l2112">2112</a><td><tr><td><a id="l2113"></a><a href="#l2113">2113</a><td>/**<tr><td><a id="l2114"></a><a href="#l2114">2114</a><td> * Walks up the DOM hierarchy returning the first ancestor that passes the<tr><td><a id="l2115"></a><a href="#l2115">2115</a><td> * matcher function.<tr><td><a id="l2116"></a><a href="#l2116">2116</a><td> * @param {Node} element The DOM node to start with.<tr><td><a id="l2117"></a><a href="#l2117">2117</a><td> * @param {function(Node) : boolean} matcher A function that returns true if the<tr><td><a id="l2118"></a><a href="#l2118">2118</a><td> *     passed node matches the desired criteria.<tr><td><a id="l2119"></a><a href="#l2119">2119</a><td> * @param {boolean=} opt_includeNode If true, the node itself is included in<tr><td><a id="l2120"></a><a href="#l2120">2120</a><td> *     the search (the first call to the matcher will pass startElement as<tr><td><a id="l2121"></a><a href="#l2121">2121</a><td> *     the node to test).<tr><td><a id="l2122"></a><a href="#l2122">2122</a><td> * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the<tr><td><a id="l2123"></a><a href="#l2123">2123</a><td> *     dom.<tr><td><a id="l2124"></a><a href="#l2124">2124</a><td> * @return {Node} DOM node that matched the matcher, or null if there was<tr><td><a id="l2125"></a><a href="#l2125">2125</a><td> *     no match.<tr><td><a id="l2126"></a><a href="#l2126">2126</a><td> */<tr><td><a id="l2127"></a><a href="#l2127">2127</a><td>goog.dom.getAncestor = function(<tr><td><a id="l2128"></a><a href="#l2128">2128</a><td>    element, matcher, opt_includeNode, opt_maxSearchSteps) {<tr><td><a id="l2129"></a><a href="#l2129">2129</a><td>  if (!opt_includeNode) {<tr><td><a id="l2130"></a><a href="#l2130">2130</a><td>    element = element.parentNode;<tr><td><a id="l2131"></a><a href="#l2131">2131</a><td>  }<tr><td><a id="l2132"></a><a href="#l2132">2132</a><td>  var ignoreSearchSteps = opt_maxSearchSteps == null;<tr><td><a id="l2133"></a><a href="#l2133">2133</a><td>  var steps = 0;<tr><td><a id="l2134"></a><a href="#l2134">2134</a><td>  while (element &amp;&amp; (ignoreSearchSteps || steps &lt;= opt_maxSearchSteps)) {<tr><td><a id="l2135"></a><a href="#l2135">2135</a><td>    goog.asserts.assert(element.name != &#39;parentNode&#39;);<tr><td><a id="l2136"></a><a href="#l2136">2136</a><td>    if (matcher(element)) {<tr><td><a id="l2137"></a><a href="#l2137">2137</a><td>      return element;<tr><td><a id="l2138"></a><a href="#l2138">2138</a><td>    }<tr><td><a id="l2139"></a><a href="#l2139">2139</a><td>    element = element.parentNode;<tr><td><a id="l2140"></a><a href="#l2140">2140</a><td>    steps++;<tr><td><a id="l2141"></a><a href="#l2141">2141</a><td>  }<tr><td><a id="l2142"></a><a href="#l2142">2142</a><td>  // Reached the root of the DOM without a match<tr><td><a id="l2143"></a><a href="#l2143">2143</a><td>  return null;<tr><td><a id="l2144"></a><a href="#l2144">2144</a><td>};<tr><td><a id="l2145"></a><a href="#l2145">2145</a><td><tr><td><a id="l2146"></a><a href="#l2146">2146</a><td><tr><td><a id="l2147"></a><a href="#l2147">2147</a><td>/**<tr><td><a id="l2148"></a><a href="#l2148">2148</a><td> * Determines the active element in the given document.<tr><td><a id="l2149"></a><a href="#l2149">2149</a><td> * @param {Document} doc The document to look in.<tr><td><a id="l2150"></a><a href="#l2150">2150</a><td> * @return {Element} The active element.<tr><td><a id="l2151"></a><a href="#l2151">2151</a><td> */<tr><td><a id="l2152"></a><a href="#l2152">2152</a><td>goog.dom.getActiveElement = function(doc) {<tr><td><a id="l2153"></a><a href="#l2153">2153</a><td>  try {<tr><td><a id="l2154"></a><a href="#l2154">2154</a><td>    return doc &amp;&amp; doc.activeElement;<tr><td><a id="l2155"></a><a href="#l2155">2155</a><td>  } catch (e) {<tr><td><a id="l2156"></a><a href="#l2156">2156</a><td>    // NOTE(nicksantos): Sometimes, evaluating document.activeElement in IE<tr><td><a id="l2157"></a><a href="#l2157">2157</a><td>    // throws an exception. I&#39;m not 100% sure why, but I suspect it chokes<tr><td><a id="l2158"></a><a href="#l2158">2158</a><td>    // on document.activeElement if the activeElement has been recently<tr><td><a id="l2159"></a><a href="#l2159">2159</a><td>    // removed from the DOM by a JS operation.<tr><td><a id="l2160"></a><a href="#l2160">2160</a><td>    //<tr><td><a id="l2161"></a><a href="#l2161">2161</a><td>    // We assume that an exception here simply means<tr><td><a id="l2162"></a><a href="#l2162">2162</a><td>    // &quot;there is no active element.&quot;<tr><td><a id="l2163"></a><a href="#l2163">2163</a><td>  }<tr><td><a id="l2164"></a><a href="#l2164">2164</a><td><tr><td><a id="l2165"></a><a href="#l2165">2165</a><td>  return null;<tr><td><a id="l2166"></a><a href="#l2166">2166</a><td>};<tr><td><a id="l2167"></a><a href="#l2167">2167</a><td><tr><td><a id="l2168"></a><a href="#l2168">2168</a><td><tr><td><a id="l2169"></a><a href="#l2169">2169</a><td>/**<tr><td><a id="l2170"></a><a href="#l2170">2170</a><td> * Gives the current devicePixelRatio.<tr><td><a id="l2171"></a><a href="#l2171">2171</a><td> *<tr><td><a id="l2172"></a><a href="#l2172">2172</a><td> * By default, this is the value of window.devicePixelRatio (which should be<tr><td><a id="l2173"></a><a href="#l2173">2173</a><td> * preferred if present).<tr><td><a id="l2174"></a><a href="#l2174">2174</a><td> *<tr><td><a id="l2175"></a><a href="#l2175">2175</a><td> * If window.devicePixelRatio is not present, the ratio is calculated with<tr><td><a id="l2176"></a><a href="#l2176">2176</a><td> * window.matchMedia, if present. Otherwise, gives 1.0.<tr><td><a id="l2177"></a><a href="#l2177">2177</a><td> *<tr><td><a id="l2178"></a><a href="#l2178">2178</a><td> * Some browsers (including Chrome) consider the browser zoom level in the pixel<tr><td><a id="l2179"></a><a href="#l2179">2179</a><td> * ratio, so the value may change across multiple calls.<tr><td><a id="l2180"></a><a href="#l2180">2180</a><td> *<tr><td><a id="l2181"></a><a href="#l2181">2181</a><td> * @return {number} The number of actual pixels per virtual pixel.<tr><td><a id="l2182"></a><a href="#l2182">2182</a><td> */<tr><td><a id="l2183"></a><a href="#l2183">2183</a><td>goog.dom.getPixelRatio = function() {<tr><td><a id="l2184"></a><a href="#l2184">2184</a><td>  var win = goog.dom.getWindow();<tr><td><a id="l2185"></a><a href="#l2185">2185</a><td>  if (goog.isDef(win.devicePixelRatio)) {<tr><td><a id="l2186"></a><a href="#l2186">2186</a><td>    return win.devicePixelRatio;<tr><td><a id="l2187"></a><a href="#l2187">2187</a><td>  } else if (win.matchMedia) {<tr><td><a id="l2188"></a><a href="#l2188">2188</a><td>    return goog.dom.matchesPixelRatio_(.75) ||<tr><td><a id="l2189"></a><a href="#l2189">2189</a><td>           goog.dom.matchesPixelRatio_(1.5) ||<tr><td><a id="l2190"></a><a href="#l2190">2190</a><td>           goog.dom.matchesPixelRatio_(2) ||<tr><td><a id="l2191"></a><a href="#l2191">2191</a><td>           goog.dom.matchesPixelRatio_(3) || 1;<tr><td><a id="l2192"></a><a href="#l2192">2192</a><td>  }<tr><td><a id="l2193"></a><a href="#l2193">2193</a><td>  return 1;<tr><td><a id="l2194"></a><a href="#l2194">2194</a><td>};<tr><td><a id="l2195"></a><a href="#l2195">2195</a><td><tr><td><a id="l2196"></a><a href="#l2196">2196</a><td><tr><td><a id="l2197"></a><a href="#l2197">2197</a><td>/**<tr><td><a id="l2198"></a><a href="#l2198">2198</a><td> * Calculates a mediaQuery to check if the current device supports the<tr><td><a id="l2199"></a><a href="#l2199">2199</a><td> * given actual to virtual pixel ratio.<tr><td><a id="l2200"></a><a href="#l2200">2200</a><td> * @param {number} pixelRatio The ratio of actual pixels to virtual pixels.<tr><td><a id="l2201"></a><a href="#l2201">2201</a><td> * @return {number} pixelRatio if applicable, otherwise 0.<tr><td><a id="l2202"></a><a href="#l2202">2202</a><td> * @private<tr><td><a id="l2203"></a><a href="#l2203">2203</a><td> */<tr><td><a id="l2204"></a><a href="#l2204">2204</a><td>goog.dom.matchesPixelRatio_ = function(pixelRatio) {<tr><td><a id="l2205"></a><a href="#l2205">2205</a><td>  var win = goog.dom.getWindow();<tr><td><a id="l2206"></a><a href="#l2206">2206</a><td>  var query = (&#39;(-webkit-min-device-pixel-ratio: &#39; + pixelRatio + &#39;),&#39; +<tr><td><a id="l2207"></a><a href="#l2207">2207</a><td>               &#39;(min--moz-device-pixel-ratio: &#39; + pixelRatio + &#39;),&#39; +<tr><td><a id="l2208"></a><a href="#l2208">2208</a><td>               &#39;(min-resolution: &#39; + pixelRatio + &#39;dppx)&#39;);<tr><td><a id="l2209"></a><a href="#l2209">2209</a><td>  return win.matchMedia(query).matches ? pixelRatio : 0;<tr><td><a id="l2210"></a><a href="#l2210">2210</a><td>};<tr><td><a id="l2211"></a><a href="#l2211">2211</a><td><tr><td><a id="l2212"></a><a href="#l2212">2212</a><td><tr><td><a id="l2213"></a><a href="#l2213">2213</a><td><tr><td><a id="l2214"></a><a href="#l2214">2214</a><td>/**<tr><td><a id="l2215"></a><a href="#l2215">2215</a><td> * Create an instance of a DOM helper with a new document object.<tr><td><a id="l2216"></a><a href="#l2216">2216</a><td> * @param {Document=} opt_document Document object to associate with this<tr><td><a id="l2217"></a><a href="#l2217">2217</a><td> *     DOM helper.<tr><td><a id="l2218"></a><a href="#l2218">2218</a><td> * @constructor<tr><td><a id="l2219"></a><a href="#l2219">2219</a><td> */<tr><td><a id="l2220"></a><a href="#l2220">2220</a><td>goog.dom.DomHelper = function(opt_document) {<tr><td><a id="l2221"></a><a href="#l2221">2221</a><td>  /**<tr><td><a id="l2222"></a><a href="#l2222">2222</a><td>   * Reference to the document object to use<tr><td><a id="l2223"></a><a href="#l2223">2223</a><td>   * @type {!Document}<tr><td><a id="l2224"></a><a href="#l2224">2224</a><td>   * @private<tr><td><a id="l2225"></a><a href="#l2225">2225</a><td>   */<tr><td><a id="l2226"></a><a href="#l2226">2226</a><td>  this.document_ = opt_document || goog.global.document || document;<tr><td><a id="l2227"></a><a href="#l2227">2227</a><td>};<tr><td><a id="l2228"></a><a href="#l2228">2228</a><td><tr><td><a id="l2229"></a><a href="#l2229">2229</a><td><tr><td><a id="l2230"></a><a href="#l2230">2230</a><td>/**<tr><td><a id="l2231"></a><a href="#l2231">2231</a><td> * Gets the dom helper object for the document where the element resides.<tr><td><a id="l2232"></a><a href="#l2232">2232</a><td> * @param {Node=} opt_node If present, gets the DomHelper for this node.<tr><td><a id="l2233"></a><a href="#l2233">2233</a><td> * @return {!goog.dom.DomHelper} The DomHelper.<tr><td><a id="l2234"></a><a href="#l2234">2234</a><td> */<tr><td><a id="l2235"></a><a href="#l2235">2235</a><td>goog.dom.DomHelper.prototype.getDomHelper = goog.dom.getDomHelper;<tr><td><a id="l2236"></a><a href="#l2236">2236</a><td><tr><td><a id="l2237"></a><a href="#l2237">2237</a><td><tr><td><a id="l2238"></a><a href="#l2238">2238</a><td>/**<tr><td><a id="l2239"></a><a href="#l2239">2239</a><td> * Sets the document object.<tr><td><a id="l2240"></a><a href="#l2240">2240</a><td> * @param {!Document} document Document object.<tr><td><a id="l2241"></a><a href="#l2241">2241</a><td> */<tr><td><a id="l2242"></a><a href="#l2242">2242</a><td>goog.dom.DomHelper.prototype.setDocument = function(document) {<tr><td><a id="l2243"></a><a href="#l2243">2243</a><td>  this.document_ = document;<tr><td><a id="l2244"></a><a href="#l2244">2244</a><td>};<tr><td><a id="l2245"></a><a href="#l2245">2245</a><td><tr><td><a id="l2246"></a><a href="#l2246">2246</a><td><tr><td><a id="l2247"></a><a href="#l2247">2247</a><td>/**<tr><td><a id="l2248"></a><a href="#l2248">2248</a><td> * Gets the document object being used by the dom library.<tr><td><a id="l2249"></a><a href="#l2249">2249</a><td> * @return {!Document} Document object.<tr><td><a id="l2250"></a><a href="#l2250">2250</a><td> */<tr><td><a id="l2251"></a><a href="#l2251">2251</a><td>goog.dom.DomHelper.prototype.getDocument = function() {<tr><td><a id="l2252"></a><a href="#l2252">2252</a><td>  return this.document_;<tr><td><a id="l2253"></a><a href="#l2253">2253</a><td>};<tr><td><a id="l2254"></a><a href="#l2254">2254</a><td><tr><td><a id="l2255"></a><a href="#l2255">2255</a><td><tr><td><a id="l2256"></a><a href="#l2256">2256</a><td>/**<tr><td><a id="l2257"></a><a href="#l2257">2257</a><td> * Alias for {@code getElementById}. If a DOM node is passed in then we just<tr><td><a id="l2258"></a><a href="#l2258">2258</a><td> * return that.<tr><td><a id="l2259"></a><a href="#l2259">2259</a><td> * @param {string|Element} element Element ID or a DOM node.<tr><td><a id="l2260"></a><a href="#l2260">2260</a><td> * @return {Element} The element with the given ID, or the node passed in.<tr><td><a id="l2261"></a><a href="#l2261">2261</a><td> */<tr><td><a id="l2262"></a><a href="#l2262">2262</a><td>goog.dom.DomHelper.prototype.getElement = function(element) {<tr><td><a id="l2263"></a><a href="#l2263">2263</a><td>  return goog.dom.getElementHelper_(this.document_, element);<tr><td><a id="l2264"></a><a href="#l2264">2264</a><td>};<tr><td><a id="l2265"></a><a href="#l2265">2265</a><td><tr><td><a id="l2266"></a><a href="#l2266">2266</a><td><tr><td><a id="l2267"></a><a href="#l2267">2267</a><td>/**<tr><td><a id="l2268"></a><a href="#l2268">2268</a><td> * Gets an element by id, asserting that the element is found.<tr><td><a id="l2269"></a><a href="#l2269">2269</a><td> *<tr><td><a id="l2270"></a><a href="#l2270">2270</a><td> * This is used when an element is expected to exist, and should fail with<tr><td><a id="l2271"></a><a href="#l2271">2271</a><td> * an assertion error if it does not (if assertions are enabled).<tr><td><a id="l2272"></a><a href="#l2272">2272</a><td> *<tr><td><a id="l2273"></a><a href="#l2273">2273</a><td> * @param {string} id Element ID.<tr><td><a id="l2274"></a><a href="#l2274">2274</a><td> * @return {!Element} The element with the given ID, if it exists.<tr><td><a id="l2275"></a><a href="#l2275">2275</a><td> */<tr><td><a id="l2276"></a><a href="#l2276">2276</a><td>goog.dom.DomHelper.prototype.getRequiredElement = function(id) {<tr><td><a id="l2277"></a><a href="#l2277">2277</a><td>  return goog.dom.getRequiredElementHelper_(this.document_, id);<tr><td><a id="l2278"></a><a href="#l2278">2278</a><td>};<tr><td><a id="l2279"></a><a href="#l2279">2279</a><td><tr><td><a id="l2280"></a><a href="#l2280">2280</a><td><tr><td><a id="l2281"></a><a href="#l2281">2281</a><td>/**<tr><td><a id="l2282"></a><a href="#l2282">2282</a><td> * Alias for {@code getElement}.<tr><td><a id="l2283"></a><a href="#l2283">2283</a><td> * @param {string|Element} element Element ID or a DOM node.<tr><td><a id="l2284"></a><a href="#l2284">2284</a><td> * @return {Element} The element with the given ID, or the node passed in.<tr><td><a id="l2285"></a><a href="#l2285">2285</a><td> * @deprecated Use {@link goog.dom.DomHelper.prototype.getElement} instead.<tr><td><a id="l2286"></a><a href="#l2286">2286</a><td> */<tr><td><a id="l2287"></a><a href="#l2287">2287</a><td>goog.dom.DomHelper.prototype.$ = goog.dom.DomHelper.prototype.getElement;<tr><td><a id="l2288"></a><a href="#l2288">2288</a><td><tr><td><a id="l2289"></a><a href="#l2289">2289</a><td><tr><td><a id="l2290"></a><a href="#l2290">2290</a><td>/**<tr><td><a id="l2291"></a><a href="#l2291">2291</a><td> * Looks up elements by both tag and class name, using browser native functions<tr><td><a id="l2292"></a><a href="#l2292">2292</a><td> * ({@code querySelectorAll}, {@code getElementsByTagName} or<tr><td><a id="l2293"></a><a href="#l2293">2293</a><td> * {@code getElementsByClassName}) where possible. The returned array is a live<tr><td><a id="l2294"></a><a href="#l2294">2294</a><td> * NodeList or a static list depending on the code path taken.<tr><td><a id="l2295"></a><a href="#l2295">2295</a><td> *<tr><td><a id="l2296"></a><a href="#l2296">2296</a><td> * @see goog.dom.query<tr><td><a id="l2297"></a><a href="#l2297">2297</a><td> *<tr><td><a id="l2298"></a><a href="#l2298">2298</a><td> * @param {?string=} opt_tag Element tag name or * for all tags.<tr><td><a id="l2299"></a><a href="#l2299">2299</a><td> * @param {?string=} opt_class Optional class name.<tr><td><a id="l2300"></a><a href="#l2300">2300</a><td> * @param {(Document|Element)=} opt_el Optional element to look in.<tr><td><a id="l2301"></a><a href="#l2301">2301</a><td> * @return { {length: number} } Array-like list of elements (only a length<tr><td><a id="l2302"></a><a href="#l2302">2302</a><td> *     property and numerical indices are guaranteed to exist).<tr><td><a id="l2303"></a><a href="#l2303">2303</a><td> */<tr><td><a id="l2304"></a><a href="#l2304">2304</a><td>goog.dom.DomHelper.prototype.getElementsByTagNameAndClass = function(opt_tag,<tr><td><a id="l2305"></a><a href="#l2305">2305</a><td>                                                                     opt_class,<tr><td><a id="l2306"></a><a href="#l2306">2306</a><td>                                                                     opt_el) {<tr><td><a id="l2307"></a><a href="#l2307">2307</a><td>  return goog.dom.getElementsByTagNameAndClass_(this.document_, opt_tag,<tr><td><a id="l2308"></a><a href="#l2308">2308</a><td>                                                opt_class, opt_el);<tr><td><a id="l2309"></a><a href="#l2309">2309</a><td>};<tr><td><a id="l2310"></a><a href="#l2310">2310</a><td><tr><td><a id="l2311"></a><a href="#l2311">2311</a><td><tr><td><a id="l2312"></a><a href="#l2312">2312</a><td>/**<tr><td><a id="l2313"></a><a href="#l2313">2313</a><td> * Returns an array of all the elements with the provided className.<tr><td><a id="l2314"></a><a href="#l2314">2314</a><td> * @see {goog.dom.query}<tr><td><a id="l2315"></a><a href="#l2315">2315</a><td> * @param {string} className the name of the class to look for.<tr><td><a id="l2316"></a><a href="#l2316">2316</a><td> * @param {Element|Document=} opt_el Optional element to look in.<tr><td><a id="l2317"></a><a href="#l2317">2317</a><td> * @return { {length: number} } The items found with the class name provided.<tr><td><a id="l2318"></a><a href="#l2318">2318</a><td> */<tr><td><a id="l2319"></a><a href="#l2319">2319</a><td>goog.dom.DomHelper.prototype.getElementsByClass = function(className, opt_el) {<tr><td><a id="l2320"></a><a href="#l2320">2320</a><td>  var doc = opt_el || this.document_;<tr><td><a id="l2321"></a><a href="#l2321">2321</a><td>  return goog.dom.getElementsByClass(className, doc);<tr><td><a id="l2322"></a><a href="#l2322">2322</a><td>};<tr><td><a id="l2323"></a><a href="#l2323">2323</a><td><tr><td><a id="l2324"></a><a href="#l2324">2324</a><td><tr><td><a id="l2325"></a><a href="#l2325">2325</a><td>/**<tr><td><a id="l2326"></a><a href="#l2326">2326</a><td> * Returns the first element we find matching the provided class name.<tr><td><a id="l2327"></a><a href="#l2327">2327</a><td> * @see {goog.dom.query}<tr><td><a id="l2328"></a><a href="#l2328">2328</a><td> * @param {string} className the name of the class to look for.<tr><td><a id="l2329"></a><a href="#l2329">2329</a><td> * @param {(Element|Document)=} opt_el Optional element to look in.<tr><td><a id="l2330"></a><a href="#l2330">2330</a><td> * @return {Element} The first item found with the class name provided.<tr><td><a id="l2331"></a><a href="#l2331">2331</a><td> */<tr><td><a id="l2332"></a><a href="#l2332">2332</a><td>goog.dom.DomHelper.prototype.getElementByClass = function(className, opt_el) {<tr><td><a id="l2333"></a><a href="#l2333">2333</a><td>  var doc = opt_el || this.document_;<tr><td><a id="l2334"></a><a href="#l2334">2334</a><td>  return goog.dom.getElementByClass(className, doc);<tr><td><a id="l2335"></a><a href="#l2335">2335</a><td>};<tr><td><a id="l2336"></a><a href="#l2336">2336</a><td><tr><td><a id="l2337"></a><a href="#l2337">2337</a><td><tr><td><a id="l2338"></a><a href="#l2338">2338</a><td>/**<tr><td><a id="l2339"></a><a href="#l2339">2339</a><td> * Ensures an element with the given className exists, and then returns the<tr><td><a id="l2340"></a><a href="#l2340">2340</a><td> * first element with the provided className.<tr><td><a id="l2341"></a><a href="#l2341">2341</a><td> * @see {goog.dom.query}<tr><td><a id="l2342"></a><a href="#l2342">2342</a><td> * @param {string} className the name of the class to look for.<tr><td><a id="l2343"></a><a href="#l2343">2343</a><td> * @param {(!Element|!Document)=} opt_root Optional element or document to look<tr><td><a id="l2344"></a><a href="#l2344">2344</a><td> *     in.<tr><td><a id="l2345"></a><a href="#l2345">2345</a><td> * @return {!Element} The first item found with the class name provided.<tr><td><a id="l2346"></a><a href="#l2346">2346</a><td> * @throws {goog.asserts.AssertionError} Thrown if no element is found.<tr><td><a id="l2347"></a><a href="#l2347">2347</a><td> */<tr><td><a id="l2348"></a><a href="#l2348">2348</a><td>goog.dom.DomHelper.prototype.getRequiredElementByClass = function(className,<tr><td><a id="l2349"></a><a href="#l2349">2349</a><td>                                                                  opt_root) {<tr><td><a id="l2350"></a><a href="#l2350">2350</a><td>  var root = opt_root || this.document_;<tr><td><a id="l2351"></a><a href="#l2351">2351</a><td>  return goog.dom.getRequiredElementByClass(className, root);<tr><td><a id="l2352"></a><a href="#l2352">2352</a><td>};<tr><td><a id="l2353"></a><a href="#l2353">2353</a><td><tr><td><a id="l2354"></a><a href="#l2354">2354</a><td><tr><td><a id="l2355"></a><a href="#l2355">2355</a><td>/**<tr><td><a id="l2356"></a><a href="#l2356">2356</a><td> * Alias for {@code getElementsByTagNameAndClass}.<tr><td><a id="l2357"></a><a href="#l2357">2357</a><td> * @deprecated Use DomHelper getElementsByTagNameAndClass.<tr><td><a id="l2358"></a><a href="#l2358">2358</a><td> * @see goog.dom.query<tr><td><a id="l2359"></a><a href="#l2359">2359</a><td> *<tr><td><a id="l2360"></a><a href="#l2360">2360</a><td> * @param {?string=} opt_tag Element tag name.<tr><td><a id="l2361"></a><a href="#l2361">2361</a><td> * @param {?string=} opt_class Optional class name.<tr><td><a id="l2362"></a><a href="#l2362">2362</a><td> * @param {Element=} opt_el Optional element to look in.<tr><td><a id="l2363"></a><a href="#l2363">2363</a><td> * @return { {length: number} } Array-like list of elements (only a length<tr><td><a id="l2364"></a><a href="#l2364">2364</a><td> *     property and numerical indices are guaranteed to exist).<tr><td><a id="l2365"></a><a href="#l2365">2365</a><td> */<tr><td><a id="l2366"></a><a href="#l2366">2366</a><td>goog.dom.DomHelper.prototype.$$ =<tr><td><a id="l2367"></a><a href="#l2367">2367</a><td>    goog.dom.DomHelper.prototype.getElementsByTagNameAndClass;<tr><td><a id="l2368"></a><a href="#l2368">2368</a><td><tr><td><a id="l2369"></a><a href="#l2369">2369</a><td><tr><td><a id="l2370"></a><a href="#l2370">2370</a><td>/**<tr><td><a id="l2371"></a><a href="#l2371">2371</a><td> * Sets a number of properties on a node.<tr><td><a id="l2372"></a><a href="#l2372">2372</a><td> * @param {Element} element DOM node to set properties on.<tr><td><a id="l2373"></a><a href="#l2373">2373</a><td> * @param {Object} properties Hash of property:value pairs.<tr><td><a id="l2374"></a><a href="#l2374">2374</a><td> */<tr><td><a id="l2375"></a><a href="#l2375">2375</a><td>goog.dom.DomHelper.prototype.setProperties = goog.dom.setProperties;<tr><td><a id="l2376"></a><a href="#l2376">2376</a><td><tr><td><a id="l2377"></a><a href="#l2377">2377</a><td><tr><td><a id="l2378"></a><a href="#l2378">2378</a><td>/**<tr><td><a id="l2379"></a><a href="#l2379">2379</a><td> * Gets the dimensions of the viewport.<tr><td><a id="l2380"></a><a href="#l2380">2380</a><td> * @param {Window=} opt_window Optional window element to test. Defaults to<tr><td><a id="l2381"></a><a href="#l2381">2381</a><td> *     the window of the Dom Helper.<tr><td><a id="l2382"></a><a href="#l2382">2382</a><td> * @return {!goog.math.Size} Object with values &#39;width&#39; and &#39;height&#39;.<tr><td><a id="l2383"></a><a href="#l2383">2383</a><td> */<tr><td><a id="l2384"></a><a href="#l2384">2384</a><td>goog.dom.DomHelper.prototype.getViewportSize = function(opt_window) {<tr><td><a id="l2385"></a><a href="#l2385">2385</a><td>  // TODO(arv): This should not take an argument. That breaks the rule of a<tr><td><a id="l2386"></a><a href="#l2386">2386</a><td>  // a DomHelper representing a single frame/window/document.<tr><td><a id="l2387"></a><a href="#l2387">2387</a><td>  return goog.dom.getViewportSize(opt_window || this.getWindow());<tr><td><a id="l2388"></a><a href="#l2388">2388</a><td>};<tr><td><a id="l2389"></a><a href="#l2389">2389</a><td><tr><td><a id="l2390"></a><a href="#l2390">2390</a><td><tr><td><a id="l2391"></a><a href="#l2391">2391</a><td>/**<tr><td><a id="l2392"></a><a href="#l2392">2392</a><td> * Calculates the height of the document.<tr><td><a id="l2393"></a><a href="#l2393">2393</a><td> *<tr><td><a id="l2394"></a><a href="#l2394">2394</a><td> * @return {number} The height of the document.<tr><td><a id="l2395"></a><a href="#l2395">2395</a><td> */<tr><td><a id="l2396"></a><a href="#l2396">2396</a><td>goog.dom.DomHelper.prototype.getDocumentHeight = function() {<tr><td><a id="l2397"></a><a href="#l2397">2397</a><td>  return goog.dom.getDocumentHeight_(this.getWindow());<tr><td><a id="l2398"></a><a href="#l2398">2398</a><td>};<tr><td><a id="l2399"></a><a href="#l2399">2399</a><td><tr><td><a id="l2400"></a><a href="#l2400">2400</a><td><tr><td><a id="l2401"></a><a href="#l2401">2401</a><td>/**<tr><td><a id="l2402"></a><a href="#l2402">2402</a><td> * Typedef for use with goog.dom.createDom and goog.dom.append.<tr><td><a id="l2403"></a><a href="#l2403">2403</a><td> * @typedef {Object|string|Array|NodeList}<tr><td><a id="l2404"></a><a href="#l2404">2404</a><td> */<tr><td><a id="l2405"></a><a href="#l2405">2405</a><td>goog.dom.Appendable;<tr><td><a id="l2406"></a><a href="#l2406">2406</a><td><tr><td><a id="l2407"></a><a href="#l2407">2407</a><td><tr><td><a id="l2408"></a><a href="#l2408">2408</a><td>/**<tr><td><a id="l2409"></a><a href="#l2409">2409</a><td> * Returns a dom node with a set of attributes.  This function accepts varargs<tr><td><a id="l2410"></a><a href="#l2410">2410</a><td> * for subsequent nodes to be added.  Subsequent nodes will be added to the<tr><td><a id="l2411"></a><a href="#l2411">2411</a><td> * first node as childNodes.<tr><td><a id="l2412"></a><a href="#l2412">2412</a><td> *<tr><td><a id="l2413"></a><a href="#l2413">2413</a><td> * So:<tr><td><a id="l2414"></a><a href="#l2414">2414</a><td> * &lt;code&gt;createDom(&#39;div&#39;, null, createDom(&#39;p&#39;), createDom(&#39;p&#39;));&lt;/code&gt;<tr><td><a id="l2415"></a><a href="#l2415">2415</a><td> * would return a div with two child paragraphs<tr><td><a id="l2416"></a><a href="#l2416">2416</a><td> *<tr><td><a id="l2417"></a><a href="#l2417">2417</a><td> * An easy way to move all child nodes of an existing element to a new parent<tr><td><a id="l2418"></a><a href="#l2418">2418</a><td> * element is:<tr><td><a id="l2419"></a><a href="#l2419">2419</a><td> * &lt;code&gt;createDom(&#39;div&#39;, null, oldElement.childNodes);&lt;/code&gt;<tr><td><a id="l2420"></a><a href="#l2420">2420</a><td> * which will remove all child nodes from the old element and add them as<tr><td><a id="l2421"></a><a href="#l2421">2421</a><td> * child nodes of the new DIV.<tr><td><a id="l2422"></a><a href="#l2422">2422</a><td> *<tr><td><a id="l2423"></a><a href="#l2423">2423</a><td> * @param {string} tagName Tag to create.<tr><td><a id="l2424"></a><a href="#l2424">2424</a><td> * @param {Object|string=} opt_attributes If object, then a map of name-value<tr><td><a id="l2425"></a><a href="#l2425">2425</a><td> *     pairs for attributes. If a string, then this is the className of the new<tr><td><a id="l2426"></a><a href="#l2426">2426</a><td> *     element.<tr><td><a id="l2427"></a><a href="#l2427">2427</a><td> * @param {...goog.dom.Appendable} var_args Further DOM nodes or<tr><td><a id="l2428"></a><a href="#l2428">2428</a><td> *     strings for text nodes. If one of the var_args is an array or<tr><td><a id="l2429"></a><a href="#l2429">2429</a><td> *     NodeList, its elements will be added as childNodes instead.<tr><td><a id="l2430"></a><a href="#l2430">2430</a><td> * @return {!Element} Reference to a DOM node.<tr><td><a id="l2431"></a><a href="#l2431">2431</a><td> */<tr><td><a id="l2432"></a><a href="#l2432">2432</a><td>goog.dom.DomHelper.prototype.createDom = function(tagName,<tr><td><a id="l2433"></a><a href="#l2433">2433</a><td>                                                  opt_attributes,<tr><td><a id="l2434"></a><a href="#l2434">2434</a><td>                                                  var_args) {<tr><td><a id="l2435"></a><a href="#l2435">2435</a><td>  return goog.dom.createDom_(this.document_, arguments);<tr><td><a id="l2436"></a><a href="#l2436">2436</a><td>};<tr><td><a id="l2437"></a><a href="#l2437">2437</a><td><tr><td><a id="l2438"></a><a href="#l2438">2438</a><td><tr><td><a id="l2439"></a><a href="#l2439">2439</a><td>/**<tr><td><a id="l2440"></a><a href="#l2440">2440</a><td> * Alias for {@code createDom}.<tr><td><a id="l2441"></a><a href="#l2441">2441</a><td> * @param {string} tagName Tag to create.<tr><td><a id="l2442"></a><a href="#l2442">2442</a><td> * @param {(Object|string)=} opt_attributes If object, then a map of name-value<tr><td><a id="l2443"></a><a href="#l2443">2443</a><td> *     pairs for attributes. If a string, then this is the className of the new<tr><td><a id="l2444"></a><a href="#l2444">2444</a><td> *     element.<tr><td><a id="l2445"></a><a href="#l2445">2445</a><td> * @param {...goog.dom.Appendable} var_args Further DOM nodes or strings for<tr><td><a id="l2446"></a><a href="#l2446">2446</a><td> *     text nodes.  If one of the var_args is an array, its children will be<tr><td><a id="l2447"></a><a href="#l2447">2447</a><td> *     added as childNodes instead.<tr><td><a id="l2448"></a><a href="#l2448">2448</a><td> * @return {!Element} Reference to a DOM node.<tr><td><a id="l2449"></a><a href="#l2449">2449</a><td> * @deprecated Use {@link goog.dom.DomHelper.prototype.createDom} instead.<tr><td><a id="l2450"></a><a href="#l2450">2450</a><td> */<tr><td><a id="l2451"></a><a href="#l2451">2451</a><td>goog.dom.DomHelper.prototype.$dom = goog.dom.DomHelper.prototype.createDom;<tr><td><a id="l2452"></a><a href="#l2452">2452</a><td><tr><td><a id="l2453"></a><a href="#l2453">2453</a><td><tr><td><a id="l2454"></a><a href="#l2454">2454</a><td>/**<tr><td><a id="l2455"></a><a href="#l2455">2455</a><td> * Creates a new element.<tr><td><a id="l2456"></a><a href="#l2456">2456</a><td> * @param {string} name Tag name.<tr><td><a id="l2457"></a><a href="#l2457">2457</a><td> * @return {!Element} The new element.<tr><td><a id="l2458"></a><a href="#l2458">2458</a><td> */<tr><td><a id="l2459"></a><a href="#l2459">2459</a><td>goog.dom.DomHelper.prototype.createElement = function(name) {<tr><td><a id="l2460"></a><a href="#l2460">2460</a><td>  return this.document_.createElement(name);<tr><td><a id="l2461"></a><a href="#l2461">2461</a><td>};<tr><td><a id="l2462"></a><a href="#l2462">2462</a><td><tr><td><a id="l2463"></a><a href="#l2463">2463</a><td><tr><td><a id="l2464"></a><a href="#l2464">2464</a><td>/**<tr><td><a id="l2465"></a><a href="#l2465">2465</a><td> * Creates a new text node.<tr><td><a id="l2466"></a><a href="#l2466">2466</a><td> * @param {number|string} content Content.<tr><td><a id="l2467"></a><a href="#l2467">2467</a><td> * @return {!Text} The new text node.<tr><td><a id="l2468"></a><a href="#l2468">2468</a><td> */<tr><td><a id="l2469"></a><a href="#l2469">2469</a><td>goog.dom.DomHelper.prototype.createTextNode = function(content) {<tr><td><a id="l2470"></a><a href="#l2470">2470</a><td>  return this.document_.createTextNode(String(content));<tr><td><a id="l2471"></a><a href="#l2471">2471</a><td>};<tr><td><a id="l2472"></a><a href="#l2472">2472</a><td><tr><td><a id="l2473"></a><a href="#l2473">2473</a><td><tr><td><a id="l2474"></a><a href="#l2474">2474</a><td>/**<tr><td><a id="l2475"></a><a href="#l2475">2475</a><td> * Create a table.<tr><td><a id="l2476"></a><a href="#l2476">2476</a><td> * @param {number} rows The number of rows in the table.  Must be &gt;= 1.<tr><td><a id="l2477"></a><a href="#l2477">2477</a><td> * @param {number} columns The number of columns in the table.  Must be &gt;= 1.<tr><td><a id="l2478"></a><a href="#l2478">2478</a><td> * @param {boolean=} opt_fillWithNbsp If true, fills table entries with<tr><td><a id="l2479"></a><a href="#l2479">2479</a><td> *     {@code goog.string.Unicode.NBSP} characters.<tr><td><a id="l2480"></a><a href="#l2480">2480</a><td> * @return {!HTMLElement} The created table.<tr><td><a id="l2481"></a><a href="#l2481">2481</a><td> */<tr><td><a id="l2482"></a><a href="#l2482">2482</a><td>goog.dom.DomHelper.prototype.createTable = function(rows, columns,<tr><td><a id="l2483"></a><a href="#l2483">2483</a><td>    opt_fillWithNbsp) {<tr><td><a id="l2484"></a><a href="#l2484">2484</a><td>  return goog.dom.createTable_(this.document_, rows, columns,<tr><td><a id="l2485"></a><a href="#l2485">2485</a><td>      !!opt_fillWithNbsp);<tr><td><a id="l2486"></a><a href="#l2486">2486</a><td>};<tr><td><a id="l2487"></a><a href="#l2487">2487</a><td><tr><td><a id="l2488"></a><a href="#l2488">2488</a><td><tr><td><a id="l2489"></a><a href="#l2489">2489</a><td>/**<tr><td><a id="l2490"></a><a href="#l2490">2490</a><td> * Converts an HTML into a node or a document fragment. A single Node is used if<tr><td><a id="l2491"></a><a href="#l2491">2491</a><td> * {@code html} only generates a single node. If {@code html} generates multiple<tr><td><a id="l2492"></a><a href="#l2492">2492</a><td> * nodes then these are put inside a {@code DocumentFragment}.<tr><td><a id="l2493"></a><a href="#l2493">2493</a><td> * @param {!goog.html.SafeHtml} html The HTML markup to convert.<tr><td><a id="l2494"></a><a href="#l2494">2494</a><td> * @return {!Node} The resulting node.<tr><td><a id="l2495"></a><a href="#l2495">2495</a><td> */<tr><td><a id="l2496"></a><a href="#l2496">2496</a><td>goog.dom.DomHelper.prototype.safeHtmlToNode = function(html) {<tr><td><a id="l2497"></a><a href="#l2497">2497</a><td>  return goog.dom.safeHtmlToNode_(this.document_, html);<tr><td><a id="l2498"></a><a href="#l2498">2498</a><td>};<tr><td><a id="l2499"></a><a href="#l2499">2499</a><td><tr><td><a id="l2500"></a><a href="#l2500">2500</a><td><tr><td><a id="l2501"></a><a href="#l2501">2501</a><td>/**<tr><td><a id="l2502"></a><a href="#l2502">2502</a><td> * Converts an HTML string into a node or a document fragment.  A single Node<tr><td><a id="l2503"></a><a href="#l2503">2503</a><td> * is used if the {@code htmlString} only generates a single node.  If the<tr><td><a id="l2504"></a><a href="#l2504">2504</a><td> * {@code htmlString} generates multiple nodes then these are put inside a<tr><td><a id="l2505"></a><a href="#l2505">2505</a><td> * {@code DocumentFragment}.<tr><td><a id="l2506"></a><a href="#l2506">2506</a><td> *<tr><td><a id="l2507"></a><a href="#l2507">2507</a><td> * @param {string} htmlString The HTML string to convert.<tr><td><a id="l2508"></a><a href="#l2508">2508</a><td> * @return {!Node} The resulting node.<tr><td><a id="l2509"></a><a href="#l2509">2509</a><td> */<tr><td><a id="l2510"></a><a href="#l2510">2510</a><td>goog.dom.DomHelper.prototype.htmlToDocumentFragment = function(htmlString) {<tr><td><a id="l2511"></a><a href="#l2511">2511</a><td>  return goog.dom.htmlToDocumentFragment_(this.document_, htmlString);<tr><td><a id="l2512"></a><a href="#l2512">2512</a><td>};<tr><td><a id="l2513"></a><a href="#l2513">2513</a><td><tr><td><a id="l2514"></a><a href="#l2514">2514</a><td><tr><td><a id="l2515"></a><a href="#l2515">2515</a><td>/**<tr><td><a id="l2516"></a><a href="#l2516">2516</a><td> * Returns true if the browser is in &quot;CSS1-compatible&quot; (standards-compliant)<tr><td><a id="l2517"></a><a href="#l2517">2517</a><td> * mode, false otherwise.<tr><td><a id="l2518"></a><a href="#l2518">2518</a><td> * @return {boolean} True if in CSS1-compatible mode.<tr><td><a id="l2519"></a><a href="#l2519">2519</a><td> */<tr><td><a id="l2520"></a><a href="#l2520">2520</a><td>goog.dom.DomHelper.prototype.isCss1CompatMode = function() {<tr><td><a id="l2521"></a><a href="#l2521">2521</a><td>  return goog.dom.isCss1CompatMode_(this.document_);<tr><td><a id="l2522"></a><a href="#l2522">2522</a><td>};<tr><td><a id="l2523"></a><a href="#l2523">2523</a><td><tr><td><a id="l2524"></a><a href="#l2524">2524</a><td><tr><td><a id="l2525"></a><a href="#l2525">2525</a><td>/**<tr><td><a id="l2526"></a><a href="#l2526">2526</a><td> * Gets the window object associated with the document.<tr><td><a id="l2527"></a><a href="#l2527">2527</a><td> * @return {!Window} The window associated with the given document.<tr><td><a id="l2528"></a><a href="#l2528">2528</a><td> */<tr><td><a id="l2529"></a><a href="#l2529">2529</a><td>goog.dom.DomHelper.prototype.getWindow = function() {<tr><td><a id="l2530"></a><a href="#l2530">2530</a><td>  return goog.dom.getWindow_(this.document_);<tr><td><a id="l2531"></a><a href="#l2531">2531</a><td>};<tr><td><a id="l2532"></a><a href="#l2532">2532</a><td><tr><td><a id="l2533"></a><a href="#l2533">2533</a><td><tr><td><a id="l2534"></a><a href="#l2534">2534</a><td>/**<tr><td><a id="l2535"></a><a href="#l2535">2535</a><td> * Gets the document scroll element.<tr><td><a id="l2536"></a><a href="#l2536">2536</a><td> * @return {!Element} Scrolling element.<tr><td><a id="l2537"></a><a href="#l2537">2537</a><td> */<tr><td><a id="l2538"></a><a href="#l2538">2538</a><td>goog.dom.DomHelper.prototype.getDocumentScrollElement = function() {<tr><td><a id="l2539"></a><a href="#l2539">2539</a><td>  return goog.dom.getDocumentScrollElement_(this.document_);<tr><td><a id="l2540"></a><a href="#l2540">2540</a><td>};<tr><td><a id="l2541"></a><a href="#l2541">2541</a><td><tr><td><a id="l2542"></a><a href="#l2542">2542</a><td><tr><td><a id="l2543"></a><a href="#l2543">2543</a><td>/**<tr><td><a id="l2544"></a><a href="#l2544">2544</a><td> * Gets the document scroll distance as a coordinate object.<tr><td><a id="l2545"></a><a href="#l2545">2545</a><td> * @return {!goog.math.Coordinate} Object with properties &#39;x&#39; and &#39;y&#39;.<tr><td><a id="l2546"></a><a href="#l2546">2546</a><td> */<tr><td><a id="l2547"></a><a href="#l2547">2547</a><td>goog.dom.DomHelper.prototype.getDocumentScroll = function() {<tr><td><a id="l2548"></a><a href="#l2548">2548</a><td>  return goog.dom.getDocumentScroll_(this.document_);<tr><td><a id="l2549"></a><a href="#l2549">2549</a><td>};<tr><td><a id="l2550"></a><a href="#l2550">2550</a><td><tr><td><a id="l2551"></a><a href="#l2551">2551</a><td><tr><td><a id="l2552"></a><a href="#l2552">2552</a><td>/**<tr><td><a id="l2553"></a><a href="#l2553">2553</a><td> * Determines the active element in the given document.<tr><td><a id="l2554"></a><a href="#l2554">2554</a><td> * @param {Document=} opt_doc The document to look in.<tr><td><a id="l2555"></a><a href="#l2555">2555</a><td> * @return {Element} The active element.<tr><td><a id="l2556"></a><a href="#l2556">2556</a><td> */<tr><td><a id="l2557"></a><a href="#l2557">2557</a><td>goog.dom.DomHelper.prototype.getActiveElement = function(opt_doc) {<tr><td><a id="l2558"></a><a href="#l2558">2558</a><td>  return goog.dom.getActiveElement(opt_doc || this.document_);<tr><td><a id="l2559"></a><a href="#l2559">2559</a><td>};<tr><td><a id="l2560"></a><a href="#l2560">2560</a><td><tr><td><a id="l2561"></a><a href="#l2561">2561</a><td><tr><td><a id="l2562"></a><a href="#l2562">2562</a><td>/**<tr><td><a id="l2563"></a><a href="#l2563">2563</a><td> * Appends a child to a node.<tr><td><a id="l2564"></a><a href="#l2564">2564</a><td> * @param {Node} parent Parent.<tr><td><a id="l2565"></a><a href="#l2565">2565</a><td> * @param {Node} child Child.<tr><td><a id="l2566"></a><a href="#l2566">2566</a><td> */<tr><td><a id="l2567"></a><a href="#l2567">2567</a><td>goog.dom.DomHelper.prototype.appendChild = goog.dom.appendChild;<tr><td><a id="l2568"></a><a href="#l2568">2568</a><td><tr><td><a id="l2569"></a><a href="#l2569">2569</a><td><tr><td><a id="l2570"></a><a href="#l2570">2570</a><td>/**<tr><td><a id="l2571"></a><a href="#l2571">2571</a><td> * Appends a node with text or other nodes.<tr><td><a id="l2572"></a><a href="#l2572">2572</a><td> * @param {!Node} parent The node to append nodes to.<tr><td><a id="l2573"></a><a href="#l2573">2573</a><td> * @param {...goog.dom.Appendable} var_args The things to append to the node.<tr><td><a id="l2574"></a><a href="#l2574">2574</a><td> *     If this is a Node it is appended as is.<tr><td><a id="l2575"></a><a href="#l2575">2575</a><td> *     If this is a string then a text node is appended.<tr><td><a id="l2576"></a><a href="#l2576">2576</a><td> *     If this is an array like object then fields 0 to length - 1 are appended.<tr><td><a id="l2577"></a><a href="#l2577">2577</a><td> */<tr><td><a id="l2578"></a><a href="#l2578">2578</a><td>goog.dom.DomHelper.prototype.append = goog.dom.append;<tr><td><a id="l2579"></a><a href="#l2579">2579</a><td><tr><td><a id="l2580"></a><a href="#l2580">2580</a><td><tr><td><a id="l2581"></a><a href="#l2581">2581</a><td>/**<tr><td><a id="l2582"></a><a href="#l2582">2582</a><td> * Determines if the given node can contain children, intended to be used for<tr><td><a id="l2583"></a><a href="#l2583">2583</a><td> * HTML generation.<tr><td><a id="l2584"></a><a href="#l2584">2584</a><td> *<tr><td><a id="l2585"></a><a href="#l2585">2585</a><td> * @param {Node} node The node to check.<tr><td><a id="l2586"></a><a href="#l2586">2586</a><td> * @return {boolean} Whether the node can contain children.<tr><td><a id="l2587"></a><a href="#l2587">2587</a><td> */<tr><td><a id="l2588"></a><a href="#l2588">2588</a><td>goog.dom.DomHelper.prototype.canHaveChildren = goog.dom.canHaveChildren;<tr><td><a id="l2589"></a><a href="#l2589">2589</a><td><tr><td><a id="l2590"></a><a href="#l2590">2590</a><td><tr><td><a id="l2591"></a><a href="#l2591">2591</a><td>/**<tr><td><a id="l2592"></a><a href="#l2592">2592</a><td> * Removes all the child nodes on a DOM node.<tr><td><a id="l2593"></a><a href="#l2593">2593</a><td> * @param {Node} node Node to remove children from.<tr><td><a id="l2594"></a><a href="#l2594">2594</a><td> */<tr><td><a id="l2595"></a><a href="#l2595">2595</a><td>goog.dom.DomHelper.prototype.removeChildren = goog.dom.removeChildren;<tr><td><a id="l2596"></a><a href="#l2596">2596</a><td><tr><td><a id="l2597"></a><a href="#l2597">2597</a><td><tr><td><a id="l2598"></a><a href="#l2598">2598</a><td>/**<tr><td><a id="l2599"></a><a href="#l2599">2599</a><td> * Inserts a new node before an existing reference node (i.e., as the previous<tr><td><a id="l2600"></a><a href="#l2600">2600</a><td> * sibling). If the reference node has no parent, then does nothing.<tr><td><a id="l2601"></a><a href="#l2601">2601</a><td> * @param {Node} newNode Node to insert.<tr><td><a id="l2602"></a><a href="#l2602">2602</a><td> * @param {Node} refNode Reference node to insert before.<tr><td><a id="l2603"></a><a href="#l2603">2603</a><td> */<tr><td><a id="l2604"></a><a href="#l2604">2604</a><td>goog.dom.DomHelper.prototype.insertSiblingBefore = goog.dom.insertSiblingBefore;<tr><td><a id="l2605"></a><a href="#l2605">2605</a><td><tr><td><a id="l2606"></a><a href="#l2606">2606</a><td><tr><td><a id="l2607"></a><a href="#l2607">2607</a><td>/**<tr><td><a id="l2608"></a><a href="#l2608">2608</a><td> * Inserts a new node after an existing reference node (i.e., as the next<tr><td><a id="l2609"></a><a href="#l2609">2609</a><td> * sibling). If the reference node has no parent, then does nothing.<tr><td><a id="l2610"></a><a href="#l2610">2610</a><td> * @param {Node} newNode Node to insert.<tr><td><a id="l2611"></a><a href="#l2611">2611</a><td> * @param {Node} refNode Reference node to insert after.<tr><td><a id="l2612"></a><a href="#l2612">2612</a><td> */<tr><td><a id="l2613"></a><a href="#l2613">2613</a><td>goog.dom.DomHelper.prototype.insertSiblingAfter = goog.dom.insertSiblingAfter;<tr><td><a id="l2614"></a><a href="#l2614">2614</a><td><tr><td><a id="l2615"></a><a href="#l2615">2615</a><td><tr><td><a id="l2616"></a><a href="#l2616">2616</a><td>/**<tr><td><a id="l2617"></a><a href="#l2617">2617</a><td> * Insert a child at a given index. If index is larger than the number of child<tr><td><a id="l2618"></a><a href="#l2618">2618</a><td> * nodes that the parent currently has, the node is inserted as the last child<tr><td><a id="l2619"></a><a href="#l2619">2619</a><td> * node.<tr><td><a id="l2620"></a><a href="#l2620">2620</a><td> * @param {Element} parent The element into which to insert the child.<tr><td><a id="l2621"></a><a href="#l2621">2621</a><td> * @param {Node} child The element to insert.<tr><td><a id="l2622"></a><a href="#l2622">2622</a><td> * @param {number} index The index at which to insert the new child node. Must<tr><td><a id="l2623"></a><a href="#l2623">2623</a><td> *     not be negative.<tr><td><a id="l2624"></a><a href="#l2624">2624</a><td> */<tr><td><a id="l2625"></a><a href="#l2625">2625</a><td>goog.dom.DomHelper.prototype.insertChildAt = goog.dom.insertChildAt;<tr><td><a id="l2626"></a><a href="#l2626">2626</a><td><tr><td><a id="l2627"></a><a href="#l2627">2627</a><td><tr><td><a id="l2628"></a><a href="#l2628">2628</a><td>/**<tr><td><a id="l2629"></a><a href="#l2629">2629</a><td> * Removes a node from its parent.<tr><td><a id="l2630"></a><a href="#l2630">2630</a><td> * @param {Node} node The node to remove.<tr><td><a id="l2631"></a><a href="#l2631">2631</a><td> * @return {Node} The node removed if removed; else, null.<tr><td><a id="l2632"></a><a href="#l2632">2632</a><td> */<tr><td><a id="l2633"></a><a href="#l2633">2633</a><td>goog.dom.DomHelper.prototype.removeNode = goog.dom.removeNode;<tr><td><a id="l2634"></a><a href="#l2634">2634</a><td><tr><td><a id="l2635"></a><a href="#l2635">2635</a><td><tr><td><a id="l2636"></a><a href="#l2636">2636</a><td>/**<tr><td><a id="l2637"></a><a href="#l2637">2637</a><td> * Replaces a node in the DOM tree. Will do nothing if {@code oldNode} has no<tr><td><a id="l2638"></a><a href="#l2638">2638</a><td> * parent.<tr><td><a id="l2639"></a><a href="#l2639">2639</a><td> * @param {Node} newNode Node to insert.<tr><td><a id="l2640"></a><a href="#l2640">2640</a><td> * @param {Node} oldNode Node to replace.<tr><td><a id="l2641"></a><a href="#l2641">2641</a><td> */<tr><td><a id="l2642"></a><a href="#l2642">2642</a><td>goog.dom.DomHelper.prototype.replaceNode = goog.dom.replaceNode;<tr><td><a id="l2643"></a><a href="#l2643">2643</a><td><tr><td><a id="l2644"></a><a href="#l2644">2644</a><td><tr><td><a id="l2645"></a><a href="#l2645">2645</a><td>/**<tr><td><a id="l2646"></a><a href="#l2646">2646</a><td> * Flattens an element. That is, removes it and replace it with its children.<tr><td><a id="l2647"></a><a href="#l2647">2647</a><td> * @param {Element} element The element to flatten.<tr><td><a id="l2648"></a><a href="#l2648">2648</a><td> * @return {Element|undefined} The original element, detached from the document<tr><td><a id="l2649"></a><a href="#l2649">2649</a><td> *     tree, sans children, or undefined if the element was already not in the<tr><td><a id="l2650"></a><a href="#l2650">2650</a><td> *     document.<tr><td><a id="l2651"></a><a href="#l2651">2651</a><td> */<tr><td><a id="l2652"></a><a href="#l2652">2652</a><td>goog.dom.DomHelper.prototype.flattenElement = goog.dom.flattenElement;<tr><td><a id="l2653"></a><a href="#l2653">2653</a><td><tr><td><a id="l2654"></a><a href="#l2654">2654</a><td><tr><td><a id="l2655"></a><a href="#l2655">2655</a><td>/**<tr><td><a id="l2656"></a><a href="#l2656">2656</a><td> * Returns an array containing just the element children of the given element.<tr><td><a id="l2657"></a><a href="#l2657">2657</a><td> * @param {Element} element The element whose element children we want.<tr><td><a id="l2658"></a><a href="#l2658">2658</a><td> * @return {!(Array|NodeList)} An array or array-like list of just the element<tr><td><a id="l2659"></a><a href="#l2659">2659</a><td> *     children of the given element.<tr><td><a id="l2660"></a><a href="#l2660">2660</a><td> */<tr><td><a id="l2661"></a><a href="#l2661">2661</a><td>goog.dom.DomHelper.prototype.getChildren = goog.dom.getChildren;<tr><td><a id="l2662"></a><a href="#l2662">2662</a><td><tr><td><a id="l2663"></a><a href="#l2663">2663</a><td><tr><td><a id="l2664"></a><a href="#l2664">2664</a><td>/**<tr><td><a id="l2665"></a><a href="#l2665">2665</a><td> * Returns the first child node that is an element.<tr><td><a id="l2666"></a><a href="#l2666">2666</a><td> * @param {Node} node The node to get the first child element of.<tr><td><a id="l2667"></a><a href="#l2667">2667</a><td> * @return {Element} The first child node of {@code node} that is an element.<tr><td><a id="l2668"></a><a href="#l2668">2668</a><td> */<tr><td><a id="l2669"></a><a href="#l2669">2669</a><td>goog.dom.DomHelper.prototype.getFirstElementChild =<tr><td><a id="l2670"></a><a href="#l2670">2670</a><td>    goog.dom.getFirstElementChild;<tr><td><a id="l2671"></a><a href="#l2671">2671</a><td><tr><td><a id="l2672"></a><a href="#l2672">2672</a><td><tr><td><a id="l2673"></a><a href="#l2673">2673</a><td>/**<tr><td><a id="l2674"></a><a href="#l2674">2674</a><td> * Returns the last child node that is an element.<tr><td><a id="l2675"></a><a href="#l2675">2675</a><td> * @param {Node} node The node to get the last child element of.<tr><td><a id="l2676"></a><a href="#l2676">2676</a><td> * @return {Element} The last child node of {@code node} that is an element.<tr><td><a id="l2677"></a><a href="#l2677">2677</a><td> */<tr><td><a id="l2678"></a><a href="#l2678">2678</a><td>goog.dom.DomHelper.prototype.getLastElementChild = goog.dom.getLastElementChild;<tr><td><a id="l2679"></a><a href="#l2679">2679</a><td><tr><td><a id="l2680"></a><a href="#l2680">2680</a><td><tr><td><a id="l2681"></a><a href="#l2681">2681</a><td>/**<tr><td><a id="l2682"></a><a href="#l2682">2682</a><td> * Returns the first next sibling that is an element.<tr><td><a id="l2683"></a><a href="#l2683">2683</a><td> * @param {Node} node The node to get the next sibling element of.<tr><td><a id="l2684"></a><a href="#l2684">2684</a><td> * @return {Element} The next sibling of {@code node} that is an element.<tr><td><a id="l2685"></a><a href="#l2685">2685</a><td> */<tr><td><a id="l2686"></a><a href="#l2686">2686</a><td>goog.dom.DomHelper.prototype.getNextElementSibling =<tr><td><a id="l2687"></a><a href="#l2687">2687</a><td>    goog.dom.getNextElementSibling;<tr><td><a id="l2688"></a><a href="#l2688">2688</a><td><tr><td><a id="l2689"></a><a href="#l2689">2689</a><td><tr><td><a id="l2690"></a><a href="#l2690">2690</a><td>/**<tr><td><a id="l2691"></a><a href="#l2691">2691</a><td> * Returns the first previous sibling that is an element.<tr><td><a id="l2692"></a><a href="#l2692">2692</a><td> * @param {Node} node The node to get the previous sibling element of.<tr><td><a id="l2693"></a><a href="#l2693">2693</a><td> * @return {Element} The first previous sibling of {@code node} that is<tr><td><a id="l2694"></a><a href="#l2694">2694</a><td> *     an element.<tr><td><a id="l2695"></a><a href="#l2695">2695</a><td> */<tr><td><a id="l2696"></a><a href="#l2696">2696</a><td>goog.dom.DomHelper.prototype.getPreviousElementSibling =<tr><td><a id="l2697"></a><a href="#l2697">2697</a><td>    goog.dom.getPreviousElementSibling;<tr><td><a id="l2698"></a><a href="#l2698">2698</a><td><tr><td><a id="l2699"></a><a href="#l2699">2699</a><td><tr><td><a id="l2700"></a><a href="#l2700">2700</a><td>/**<tr><td><a id="l2701"></a><a href="#l2701">2701</a><td> * Returns the next node in source order from the given node.<tr><td><a id="l2702"></a><a href="#l2702">2702</a><td> * @param {Node} node The node.<tr><td><a id="l2703"></a><a href="#l2703">2703</a><td> * @return {Node} The next node in the DOM tree, or null if this was the last<tr><td><a id="l2704"></a><a href="#l2704">2704</a><td> *     node.<tr><td><a id="l2705"></a><a href="#l2705">2705</a><td> */<tr><td><a id="l2706"></a><a href="#l2706">2706</a><td>goog.dom.DomHelper.prototype.getNextNode = goog.dom.getNextNode;<tr><td><a id="l2707"></a><a href="#l2707">2707</a><td><tr><td><a id="l2708"></a><a href="#l2708">2708</a><td><tr><td><a id="l2709"></a><a href="#l2709">2709</a><td>/**<tr><td><a id="l2710"></a><a href="#l2710">2710</a><td> * Returns the previous node in source order from the given node.<tr><td><a id="l2711"></a><a href="#l2711">2711</a><td> * @param {Node} node The node.<tr><td><a id="l2712"></a><a href="#l2712">2712</a><td> * @return {Node} The previous node in the DOM tree, or null if this was the<tr><td><a id="l2713"></a><a href="#l2713">2713</a><td> *     first node.<tr><td><a id="l2714"></a><a href="#l2714">2714</a><td> */<tr><td><a id="l2715"></a><a href="#l2715">2715</a><td>goog.dom.DomHelper.prototype.getPreviousNode = goog.dom.getPreviousNode;<tr><td><a id="l2716"></a><a href="#l2716">2716</a><td><tr><td><a id="l2717"></a><a href="#l2717">2717</a><td><tr><td><a id="l2718"></a><a href="#l2718">2718</a><td>/**<tr><td><a id="l2719"></a><a href="#l2719">2719</a><td> * Whether the object looks like a DOM node.<tr><td><a id="l2720"></a><a href="#l2720">2720</a><td> * @param {?} obj The object being tested for node likeness.<tr><td><a id="l2721"></a><a href="#l2721">2721</a><td> * @return {boolean} Whether the object looks like a DOM node.<tr><td><a id="l2722"></a><a href="#l2722">2722</a><td> */<tr><td><a id="l2723"></a><a href="#l2723">2723</a><td>goog.dom.DomHelper.prototype.isNodeLike = goog.dom.isNodeLike;<tr><td><a id="l2724"></a><a href="#l2724">2724</a><td><tr><td><a id="l2725"></a><a href="#l2725">2725</a><td><tr><td><a id="l2726"></a><a href="#l2726">2726</a><td>/**<tr><td><a id="l2727"></a><a href="#l2727">2727</a><td> * Whether the object looks like an Element.<tr><td><a id="l2728"></a><a href="#l2728">2728</a><td> * @param {?} obj The object being tested for Element likeness.<tr><td><a id="l2729"></a><a href="#l2729">2729</a><td> * @return {boolean} Whether the object looks like an Element.<tr><td><a id="l2730"></a><a href="#l2730">2730</a><td> */<tr><td><a id="l2731"></a><a href="#l2731">2731</a><td>goog.dom.DomHelper.prototype.isElement = goog.dom.isElement;<tr><td><a id="l2732"></a><a href="#l2732">2732</a><td><tr><td><a id="l2733"></a><a href="#l2733">2733</a><td><tr><td><a id="l2734"></a><a href="#l2734">2734</a><td>/**<tr><td><a id="l2735"></a><a href="#l2735">2735</a><td> * Returns true if the specified value is a Window object. This includes the<tr><td><a id="l2736"></a><a href="#l2736">2736</a><td> * global window for HTML pages, and iframe windows.<tr><td><a id="l2737"></a><a href="#l2737">2737</a><td> * @param {?} obj Variable to test.<tr><td><a id="l2738"></a><a href="#l2738">2738</a><td> * @return {boolean} Whether the variable is a window.<tr><td><a id="l2739"></a><a href="#l2739">2739</a><td> */<tr><td><a id="l2740"></a><a href="#l2740">2740</a><td>goog.dom.DomHelper.prototype.isWindow = goog.dom.isWindow;<tr><td><a id="l2741"></a><a href="#l2741">2741</a><td><tr><td><a id="l2742"></a><a href="#l2742">2742</a><td><tr><td><a id="l2743"></a><a href="#l2743">2743</a><td>/**<tr><td><a id="l2744"></a><a href="#l2744">2744</a><td> * Returns an element&#39;s parent, if it&#39;s an Element.<tr><td><a id="l2745"></a><a href="#l2745">2745</a><td> * @param {Element} element The DOM element.<tr><td><a id="l2746"></a><a href="#l2746">2746</a><td> * @return {Element} The parent, or null if not an Element.<tr><td><a id="l2747"></a><a href="#l2747">2747</a><td> */<tr><td><a id="l2748"></a><a href="#l2748">2748</a><td>goog.dom.DomHelper.prototype.getParentElement = goog.dom.getParentElement;<tr><td><a id="l2749"></a><a href="#l2749">2749</a><td><tr><td><a id="l2750"></a><a href="#l2750">2750</a><td><tr><td><a id="l2751"></a><a href="#l2751">2751</a><td>/**<tr><td><a id="l2752"></a><a href="#l2752">2752</a><td> * Whether a node contains another node.<tr><td><a id="l2753"></a><a href="#l2753">2753</a><td> * @param {Node} parent The node that should contain the other node.<tr><td><a id="l2754"></a><a href="#l2754">2754</a><td> * @param {Node} descendant The node to test presence of.<tr><td><a id="l2755"></a><a href="#l2755">2755</a><td> * @return {boolean} Whether the parent node contains the descendent node.<tr><td><a id="l2756"></a><a href="#l2756">2756</a><td> */<tr><td><a id="l2757"></a><a href="#l2757">2757</a><td>goog.dom.DomHelper.prototype.contains = goog.dom.contains;<tr><td><a id="l2758"></a><a href="#l2758">2758</a><td><tr><td><a id="l2759"></a><a href="#l2759">2759</a><td><tr><td><a id="l2760"></a><a href="#l2760">2760</a><td>/**<tr><td><a id="l2761"></a><a href="#l2761">2761</a><td> * Compares the document order of two nodes, returning 0 if they are the same<tr><td><a id="l2762"></a><a href="#l2762">2762</a><td> * node, a negative number if node1 is before node2, and a positive number if<tr><td><a id="l2763"></a><a href="#l2763">2763</a><td> * node2 is before node1.  Note that we compare the order the tags appear in the<tr><td><a id="l2764"></a><a href="#l2764">2764</a><td> * document so in the tree &lt;b&gt;&lt;i&gt;text&lt;/i&gt;&lt;/b&gt; the B node is considered to be<tr><td><a id="l2765"></a><a href="#l2765">2765</a><td> * before the I node.<tr><td><a id="l2766"></a><a href="#l2766">2766</a><td> *<tr><td><a id="l2767"></a><a href="#l2767">2767</a><td> * @param {Node} node1 The first node to compare.<tr><td><a id="l2768"></a><a href="#l2768">2768</a><td> * @param {Node} node2 The second node to compare.<tr><td><a id="l2769"></a><a href="#l2769">2769</a><td> * @return {number} 0 if the nodes are the same node, a negative number if node1<tr><td><a id="l2770"></a><a href="#l2770">2770</a><td> *     is before node2, and a positive number if node2 is before node1.<tr><td><a id="l2771"></a><a href="#l2771">2771</a><td> */<tr><td><a id="l2772"></a><a href="#l2772">2772</a><td>goog.dom.DomHelper.prototype.compareNodeOrder = goog.dom.compareNodeOrder;<tr><td><a id="l2773"></a><a href="#l2773">2773</a><td><tr><td><a id="l2774"></a><a href="#l2774">2774</a><td><tr><td><a id="l2775"></a><a href="#l2775">2775</a><td>/**<tr><td><a id="l2776"></a><a href="#l2776">2776</a><td> * Find the deepest common ancestor of the given nodes.<tr><td><a id="l2777"></a><a href="#l2777">2777</a><td> * @param {...Node} var_args The nodes to find a common ancestor of.<tr><td><a id="l2778"></a><a href="#l2778">2778</a><td> * @return {Node} The common ancestor of the nodes, or null if there is none.<tr><td><a id="l2779"></a><a href="#l2779">2779</a><td> *     null will only be returned if two or more of the nodes are from different<tr><td><a id="l2780"></a><a href="#l2780">2780</a><td> *     documents.<tr><td><a id="l2781"></a><a href="#l2781">2781</a><td> */<tr><td><a id="l2782"></a><a href="#l2782">2782</a><td>goog.dom.DomHelper.prototype.findCommonAncestor = goog.dom.findCommonAncestor;<tr><td><a id="l2783"></a><a href="#l2783">2783</a><td><tr><td><a id="l2784"></a><a href="#l2784">2784</a><td><tr><td><a id="l2785"></a><a href="#l2785">2785</a><td>/**<tr><td><a id="l2786"></a><a href="#l2786">2786</a><td> * Returns the owner document for a node.<tr><td><a id="l2787"></a><a href="#l2787">2787</a><td> * @param {Node} node The node to get the document for.<tr><td><a id="l2788"></a><a href="#l2788">2788</a><td> * @return {!Document} The document owning the node.<tr><td><a id="l2789"></a><a href="#l2789">2789</a><td> */<tr><td><a id="l2790"></a><a href="#l2790">2790</a><td>goog.dom.DomHelper.prototype.getOwnerDocument = goog.dom.getOwnerDocument;<tr><td><a id="l2791"></a><a href="#l2791">2791</a><td><tr><td><a id="l2792"></a><a href="#l2792">2792</a><td><tr><td><a id="l2793"></a><a href="#l2793">2793</a><td>/**<tr><td><a id="l2794"></a><a href="#l2794">2794</a><td> * Cross browser function for getting the document element of an iframe.<tr><td><a id="l2795"></a><a href="#l2795">2795</a><td> * @param {Element} iframe Iframe element.<tr><td><a id="l2796"></a><a href="#l2796">2796</a><td> * @return {!Document} The frame content document.<tr><td><a id="l2797"></a><a href="#l2797">2797</a><td> */<tr><td><a id="l2798"></a><a href="#l2798">2798</a><td>goog.dom.DomHelper.prototype.getFrameContentDocument =<tr><td><a id="l2799"></a><a href="#l2799">2799</a><td>    goog.dom.getFrameContentDocument;<tr><td><a id="l2800"></a><a href="#l2800">2800</a><td><tr><td><a id="l2801"></a><a href="#l2801">2801</a><td><tr><td><a id="l2802"></a><a href="#l2802">2802</a><td>/**<tr><td><a id="l2803"></a><a href="#l2803">2803</a><td> * Cross browser function for getting the window of a frame or iframe.<tr><td><a id="l2804"></a><a href="#l2804">2804</a><td> * @param {Element} frame Frame element.<tr><td><a id="l2805"></a><a href="#l2805">2805</a><td> * @return {Window} The window associated with the given frame.<tr><td><a id="l2806"></a><a href="#l2806">2806</a><td> */<tr><td><a id="l2807"></a><a href="#l2807">2807</a><td>goog.dom.DomHelper.prototype.getFrameContentWindow =<tr><td><a id="l2808"></a><a href="#l2808">2808</a><td>    goog.dom.getFrameContentWindow;<tr><td><a id="l2809"></a><a href="#l2809">2809</a><td><tr><td><a id="l2810"></a><a href="#l2810">2810</a><td><tr><td><a id="l2811"></a><a href="#l2811">2811</a><td>/**<tr><td><a id="l2812"></a><a href="#l2812">2812</a><td> * Sets the text content of a node, with cross-browser support.<tr><td><a id="l2813"></a><a href="#l2813">2813</a><td> * @param {Node} node The node to change the text content of.<tr><td><a id="l2814"></a><a href="#l2814">2814</a><td> * @param {string|number} text The value that should replace the node&#39;s content.<tr><td><a id="l2815"></a><a href="#l2815">2815</a><td> */<tr><td><a id="l2816"></a><a href="#l2816">2816</a><td>goog.dom.DomHelper.prototype.setTextContent = goog.dom.setTextContent;<tr><td><a id="l2817"></a><a href="#l2817">2817</a><td><tr><td><a id="l2818"></a><a href="#l2818">2818</a><td><tr><td><a id="l2819"></a><a href="#l2819">2819</a><td>/**<tr><td><a id="l2820"></a><a href="#l2820">2820</a><td> * Gets the outerHTML of a node, which islike innerHTML, except that it<tr><td><a id="l2821"></a><a href="#l2821">2821</a><td> * actually contains the HTML of the node itself.<tr><td><a id="l2822"></a><a href="#l2822">2822</a><td> * @param {Element} element The element to get the HTML of.<tr><td><a id="l2823"></a><a href="#l2823">2823</a><td> * @return {string} The outerHTML of the given element.<tr><td><a id="l2824"></a><a href="#l2824">2824</a><td> */<tr><td><a id="l2825"></a><a href="#l2825">2825</a><td>goog.dom.DomHelper.prototype.getOuterHtml = goog.dom.getOuterHtml;<tr><td><a id="l2826"></a><a href="#l2826">2826</a><td><tr><td><a id="l2827"></a><a href="#l2827">2827</a><td><tr><td><a id="l2828"></a><a href="#l2828">2828</a><td>/**<tr><td><a id="l2829"></a><a href="#l2829">2829</a><td> * Finds the first descendant node that matches the filter function. This does<tr><td><a id="l2830"></a><a href="#l2830">2830</a><td> * a depth first search.<tr><td><a id="l2831"></a><a href="#l2831">2831</a><td> * @param {Node} root The root of the tree to search.<tr><td><a id="l2832"></a><a href="#l2832">2832</a><td> * @param {function(Node) : boolean} p The filter function.<tr><td><a id="l2833"></a><a href="#l2833">2833</a><td> * @return {Node|undefined} The found node or undefined if none is found.<tr><td><a id="l2834"></a><a href="#l2834">2834</a><td> */<tr><td><a id="l2835"></a><a href="#l2835">2835</a><td>goog.dom.DomHelper.prototype.findNode = goog.dom.findNode;<tr><td><a id="l2836"></a><a href="#l2836">2836</a><td><tr><td><a id="l2837"></a><a href="#l2837">2837</a><td><tr><td><a id="l2838"></a><a href="#l2838">2838</a><td>/**<tr><td><a id="l2839"></a><a href="#l2839">2839</a><td> * Finds all the descendant nodes that matches the filter function. This does a<tr><td><a id="l2840"></a><a href="#l2840">2840</a><td> * depth first search.<tr><td><a id="l2841"></a><a href="#l2841">2841</a><td> * @param {Node} root The root of the tree to search.<tr><td><a id="l2842"></a><a href="#l2842">2842</a><td> * @param {function(Node) : boolean} p The filter function.<tr><td><a id="l2843"></a><a href="#l2843">2843</a><td> * @return {Array&lt;Node&gt;} The found nodes or an empty array if none are found.<tr><td><a id="l2844"></a><a href="#l2844">2844</a><td> */<tr><td><a id="l2845"></a><a href="#l2845">2845</a><td>goog.dom.DomHelper.prototype.findNodes = goog.dom.findNodes;<tr><td><a id="l2846"></a><a href="#l2846">2846</a><td><tr><td><a id="l2847"></a><a href="#l2847">2847</a><td><tr><td><a id="l2848"></a><a href="#l2848">2848</a><td>/**<tr><td><a id="l2849"></a><a href="#l2849">2849</a><td> * Returns true if the element has a tab index that allows it to receive<tr><td><a id="l2850"></a><a href="#l2850">2850</a><td> * keyboard focus (tabIndex &gt;= 0), false otherwise.  Note that some elements<tr><td><a id="l2851"></a><a href="#l2851">2851</a><td> * natively support keyboard focus, even if they have no tab index.<tr><td><a id="l2852"></a><a href="#l2852">2852</a><td> * @param {!Element} element Element to check.<tr><td><a id="l2853"></a><a href="#l2853">2853</a><td> * @return {boolean} Whether the element has a tab index that allows keyboard<tr><td><a id="l2854"></a><a href="#l2854">2854</a><td> *     focus.<tr><td><a id="l2855"></a><a href="#l2855">2855</a><td> */<tr><td><a id="l2856"></a><a href="#l2856">2856</a><td>goog.dom.DomHelper.prototype.isFocusableTabIndex = goog.dom.isFocusableTabIndex;<tr><td><a id="l2857"></a><a href="#l2857">2857</a><td><tr><td><a id="l2858"></a><a href="#l2858">2858</a><td><tr><td><a id="l2859"></a><a href="#l2859">2859</a><td>/**<tr><td><a id="l2860"></a><a href="#l2860">2860</a><td> * Enables or disables keyboard focus support on the element via its tab index.<tr><td><a id="l2861"></a><a href="#l2861">2861</a><td> * Only elements for which {@link goog.dom.isFocusableTabIndex} returns true<tr><td><a id="l2862"></a><a href="#l2862">2862</a><td> * (or elements that natively support keyboard focus, like form elements) can<tr><td><a id="l2863"></a><a href="#l2863">2863</a><td> * receive keyboard focus.  See http://go/tabindex for more info.<tr><td><a id="l2864"></a><a href="#l2864">2864</a><td> * @param {Element} element Element whose tab index is to be changed.<tr><td><a id="l2865"></a><a href="#l2865">2865</a><td> * @param {boolean} enable Whether to set or remove a tab index on the element<tr><td><a id="l2866"></a><a href="#l2866">2866</a><td> *     that supports keyboard focus.<tr><td><a id="l2867"></a><a href="#l2867">2867</a><td> */<tr><td><a id="l2868"></a><a href="#l2868">2868</a><td>goog.dom.DomHelper.prototype.setFocusableTabIndex =<tr><td><a id="l2869"></a><a href="#l2869">2869</a><td>    goog.dom.setFocusableTabIndex;<tr><td><a id="l2870"></a><a href="#l2870">2870</a><td><tr><td><a id="l2871"></a><a href="#l2871">2871</a><td><tr><td><a id="l2872"></a><a href="#l2872">2872</a><td>/**<tr><td><a id="l2873"></a><a href="#l2873">2873</a><td> * Returns true if the element can be focused, i.e. it has a tab index that<tr><td><a id="l2874"></a><a href="#l2874">2874</a><td> * allows it to receive keyboard focus (tabIndex &gt;= 0), or it is an element<tr><td><a id="l2875"></a><a href="#l2875">2875</a><td> * that natively supports keyboard focus.<tr><td><a id="l2876"></a><a href="#l2876">2876</a><td> * @param {!Element} element Element to check.<tr><td><a id="l2877"></a><a href="#l2877">2877</a><td> * @return {boolean} Whether the element allows keyboard focus.<tr><td><a id="l2878"></a><a href="#l2878">2878</a><td> */<tr><td><a id="l2879"></a><a href="#l2879">2879</a><td>goog.dom.DomHelper.prototype.isFocusable = goog.dom.isFocusable;<tr><td><a id="l2880"></a><a href="#l2880">2880</a><td><tr><td><a id="l2881"></a><a href="#l2881">2881</a><td><tr><td><a id="l2882"></a><a href="#l2882">2882</a><td>/**<tr><td><a id="l2883"></a><a href="#l2883">2883</a><td> * Returns the text contents of the current node, without markup. New lines are<tr><td><a id="l2884"></a><a href="#l2884">2884</a><td> * stripped and whitespace is collapsed, such that each character would be<tr><td><a id="l2885"></a><a href="#l2885">2885</a><td> * visible.<tr><td><a id="l2886"></a><a href="#l2886">2886</a><td> *<tr><td><a id="l2887"></a><a href="#l2887">2887</a><td> * In browsers that support it, innerText is used.  Other browsers attempt to<tr><td><a id="l2888"></a><a href="#l2888">2888</a><td> * simulate it via node traversal.  Line breaks are canonicalized in IE.<tr><td><a id="l2889"></a><a href="#l2889">2889</a><td> *<tr><td><a id="l2890"></a><a href="#l2890">2890</a><td> * @param {Node} node The node from which we are getting content.<tr><td><a id="l2891"></a><a href="#l2891">2891</a><td> * @return {string} The text content.<tr><td><a id="l2892"></a><a href="#l2892">2892</a><td> */<tr><td><a id="l2893"></a><a href="#l2893">2893</a><td>goog.dom.DomHelper.prototype.getTextContent = goog.dom.getTextContent;<tr><td><a id="l2894"></a><a href="#l2894">2894</a><td><tr><td><a id="l2895"></a><a href="#l2895">2895</a><td><tr><td><a id="l2896"></a><a href="#l2896">2896</a><td>/**<tr><td><a id="l2897"></a><a href="#l2897">2897</a><td> * Returns the text length of the text contained in a node, without markup. This<tr><td><a id="l2898"></a><a href="#l2898">2898</a><td> * is equivalent to the selection length if the node was selected, or the number<tr><td><a id="l2899"></a><a href="#l2899">2899</a><td> * of cursor movements to traverse the node. Images &amp; BRs take one space.  New<tr><td><a id="l2900"></a><a href="#l2900">2900</a><td> * lines are ignored.<tr><td><a id="l2901"></a><a href="#l2901">2901</a><td> *<tr><td><a id="l2902"></a><a href="#l2902">2902</a><td> * @param {Node} node The node whose text content length is being calculated.<tr><td><a id="l2903"></a><a href="#l2903">2903</a><td> * @return {number} The length of {@code node}&#39;s text content.<tr><td><a id="l2904"></a><a href="#l2904">2904</a><td> */<tr><td><a id="l2905"></a><a href="#l2905">2905</a><td>goog.dom.DomHelper.prototype.getNodeTextLength = goog.dom.getNodeTextLength;<tr><td><a id="l2906"></a><a href="#l2906">2906</a><td><tr><td><a id="l2907"></a><a href="#l2907">2907</a><td><tr><td><a id="l2908"></a><a href="#l2908">2908</a><td>/**<tr><td><a id="l2909"></a><a href="#l2909">2909</a><td> * Returns the text offset of a node relative to one of its ancestors. The text<tr><td><a id="l2910"></a><a href="#l2910">2910</a><td> * length is the same as the length calculated by<tr><td><a id="l2911"></a><a href="#l2911">2911</a><td> * {@code goog.dom.getNodeTextLength}.<tr><td><a id="l2912"></a><a href="#l2912">2912</a><td> *<tr><td><a id="l2913"></a><a href="#l2913">2913</a><td> * @param {Node} node The node whose offset is being calculated.<tr><td><a id="l2914"></a><a href="#l2914">2914</a><td> * @param {Node=} opt_offsetParent Defaults to the node&#39;s owner document&#39;s body.<tr><td><a id="l2915"></a><a href="#l2915">2915</a><td> * @return {number} The text offset.<tr><td><a id="l2916"></a><a href="#l2916">2916</a><td> */<tr><td><a id="l2917"></a><a href="#l2917">2917</a><td>goog.dom.DomHelper.prototype.getNodeTextOffset = goog.dom.getNodeTextOffset;<tr><td><a id="l2918"></a><a href="#l2918">2918</a><td><tr><td><a id="l2919"></a><a href="#l2919">2919</a><td><tr><td><a id="l2920"></a><a href="#l2920">2920</a><td>/**<tr><td><a id="l2921"></a><a href="#l2921">2921</a><td> * Returns the node at a given offset in a parent node.  If an object is<tr><td><a id="l2922"></a><a href="#l2922">2922</a><td> * provided for the optional third parameter, the node and the remainder of the<tr><td><a id="l2923"></a><a href="#l2923">2923</a><td> * offset will stored as properties of this object.<tr><td><a id="l2924"></a><a href="#l2924">2924</a><td> * @param {Node} parent The parent node.<tr><td><a id="l2925"></a><a href="#l2925">2925</a><td> * @param {number} offset The offset into the parent node.<tr><td><a id="l2926"></a><a href="#l2926">2926</a><td> * @param {Object=} opt_result Object to be used to store the return value. The<tr><td><a id="l2927"></a><a href="#l2927">2927</a><td> *     return value will be stored in the form {node: Node, remainder: number}<tr><td><a id="l2928"></a><a href="#l2928">2928</a><td> *     if this object is provided.<tr><td><a id="l2929"></a><a href="#l2929">2929</a><td> * @return {Node} The node at the given offset.<tr><td><a id="l2930"></a><a href="#l2930">2930</a><td> */<tr><td><a id="l2931"></a><a href="#l2931">2931</a><td>goog.dom.DomHelper.prototype.getNodeAtOffset = goog.dom.getNodeAtOffset;<tr><td><a id="l2932"></a><a href="#l2932">2932</a><td><tr><td><a id="l2933"></a><a href="#l2933">2933</a><td><tr><td><a id="l2934"></a><a href="#l2934">2934</a><td>/**<tr><td><a id="l2935"></a><a href="#l2935">2935</a><td> * Returns true if the object is a {@code NodeList}.  To qualify as a NodeList,<tr><td><a id="l2936"></a><a href="#l2936">2936</a><td> * the object must have a numeric length property and an item function (which<tr><td><a id="l2937"></a><a href="#l2937">2937</a><td> * has type &#39;string&#39; on IE for some reason).<tr><td><a id="l2938"></a><a href="#l2938">2938</a><td> * @param {Object} val Object to test.<tr><td><a id="l2939"></a><a href="#l2939">2939</a><td> * @return {boolean} Whether the object is a NodeList.<tr><td><a id="l2940"></a><a href="#l2940">2940</a><td> */<tr><td><a id="l2941"></a><a href="#l2941">2941</a><td>goog.dom.DomHelper.prototype.isNodeList = goog.dom.isNodeList;<tr><td><a id="l2942"></a><a href="#l2942">2942</a><td><tr><td><a id="l2943"></a><a href="#l2943">2943</a><td><tr><td><a id="l2944"></a><a href="#l2944">2944</a><td>/**<tr><td><a id="l2945"></a><a href="#l2945">2945</a><td> * Walks up the DOM hierarchy returning the first ancestor that has the passed<tr><td><a id="l2946"></a><a href="#l2946">2946</a><td> * tag name and/or class name. If the passed element matches the specified<tr><td><a id="l2947"></a><a href="#l2947">2947</a><td> * criteria, the element itself is returned.<tr><td><a id="l2948"></a><a href="#l2948">2948</a><td> * @param {Node} element The DOM node to start with.<tr><td><a id="l2949"></a><a href="#l2949">2949</a><td> * @param {?(goog.dom.TagName|string)=} opt_tag The tag name to match (or<tr><td><a id="l2950"></a><a href="#l2950">2950</a><td> *     null/undefined to match only based on class name).<tr><td><a id="l2951"></a><a href="#l2951">2951</a><td> * @param {?string=} opt_class The class name to match (or null/undefined to<tr><td><a id="l2952"></a><a href="#l2952">2952</a><td> *     match only based on tag name).<tr><td><a id="l2953"></a><a href="#l2953">2953</a><td> * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the<tr><td><a id="l2954"></a><a href="#l2954">2954</a><td> *     dom.<tr><td><a id="l2955"></a><a href="#l2955">2955</a><td> * @return {Element} The first ancestor that matches the passed criteria, or<tr><td><a id="l2956"></a><a href="#l2956">2956</a><td> *     null if no match is found.<tr><td><a id="l2957"></a><a href="#l2957">2957</a><td> */<tr><td><a id="l2958"></a><a href="#l2958">2958</a><td>goog.dom.DomHelper.prototype.getAncestorByTagNameAndClass =<tr><td><a id="l2959"></a><a href="#l2959">2959</a><td>    goog.dom.getAncestorByTagNameAndClass;<tr><td><a id="l2960"></a><a href="#l2960">2960</a><td><tr><td><a id="l2961"></a><a href="#l2961">2961</a><td><tr><td><a id="l2962"></a><a href="#l2962">2962</a><td>/**<tr><td><a id="l2963"></a><a href="#l2963">2963</a><td> * Walks up the DOM hierarchy returning the first ancestor that has the passed<tr><td><a id="l2964"></a><a href="#l2964">2964</a><td> * class name. If the passed element matches the specified criteria, the<tr><td><a id="l2965"></a><a href="#l2965">2965</a><td> * element itself is returned.<tr><td><a id="l2966"></a><a href="#l2966">2966</a><td> * @param {Node} element The DOM node to start with.<tr><td><a id="l2967"></a><a href="#l2967">2967</a><td> * @param {string} class The class name to match.<tr><td><a id="l2968"></a><a href="#l2968">2968</a><td> * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the<tr><td><a id="l2969"></a><a href="#l2969">2969</a><td> *     dom.<tr><td><a id="l2970"></a><a href="#l2970">2970</a><td> * @return {Element} The first ancestor that matches the passed criteria, or<tr><td><a id="l2971"></a><a href="#l2971">2971</a><td> *     null if none match.<tr><td><a id="l2972"></a><a href="#l2972">2972</a><td> */<tr><td><a id="l2973"></a><a href="#l2973">2973</a><td>goog.dom.DomHelper.prototype.getAncestorByClass =<tr><td><a id="l2974"></a><a href="#l2974">2974</a><td>    goog.dom.getAncestorByClass;<tr><td><a id="l2975"></a><a href="#l2975">2975</a><td><tr><td><a id="l2976"></a><a href="#l2976">2976</a><td><tr><td><a id="l2977"></a><a href="#l2977">2977</a><td>/**<tr><td><a id="l2978"></a><a href="#l2978">2978</a><td> * Walks up the DOM hierarchy returning the first ancestor that passes the<tr><td><a id="l2979"></a><a href="#l2979">2979</a><td> * matcher function.<tr><td><a id="l2980"></a><a href="#l2980">2980</a><td> * @param {Node} element The DOM node to start with.<tr><td><a id="l2981"></a><a href="#l2981">2981</a><td> * @param {function(Node) : boolean} matcher A function that returns true if the<tr><td><a id="l2982"></a><a href="#l2982">2982</a><td> *     passed node matches the desired criteria.<tr><td><a id="l2983"></a><a href="#l2983">2983</a><td> * @param {boolean=} opt_includeNode If true, the node itself is included in<tr><td><a id="l2984"></a><a href="#l2984">2984</a><td> *     the search (the first call to the matcher will pass startElement as<tr><td><a id="l2985"></a><a href="#l2985">2985</a><td> *     the node to test).<tr><td><a id="l2986"></a><a href="#l2986">2986</a><td> * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the<tr><td><a id="l2987"></a><a href="#l2987">2987</a><td> *     dom.<tr><td><a id="l2988"></a><a href="#l2988">2988</a><td> * @return {Node} DOM node that matched the matcher, or null if there was<tr><td><a id="l2989"></a><a href="#l2989">2989</a><td> *     no match.<tr><td><a id="l2990"></a><a href="#l2990">2990</a><td> */<tr><td><a id="l2991"></a><a href="#l2991">2991</a><td>goog.dom.DomHelper.prototype.getAncestor = goog.dom.getAncestor;</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/dom/nodetype.js.src.html b/docs/source/lib/goog/dom/nodetype.js.src.html
new file mode 100644
index 0000000..587e392
--- /dev/null
+++ b/docs/source/lib/goog/dom/nodetype.js.src.html
@@ -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>nodetype.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/dom/nodetype.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Definition of goog.dom.NodeType.<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>goog.provide(&#39;goog.dom.NodeType&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td><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> * Constants for the nodeType attribute in the Node interface.<tr><td><a id="l24"></a><a href="#l24">24</a><td> *<tr><td><a id="l25"></a><a href="#l25">25</a><td> * These constants match those specified in the Node interface. These are<tr><td><a id="l26"></a><a href="#l26">26</a><td> * usually present on the Node object in recent browsers, but not in older<tr><td><a id="l27"></a><a href="#l27">27</a><td> * browsers (specifically, early IEs) and thus are given here.<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * In some browsers (early IEs), these are not defined on the Node object,<tr><td><a id="l30"></a><a href="#l30">30</a><td> * so they are provided here.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * See http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1950641247<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @enum {number}<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.dom.NodeType = {<tr><td><a id="l36"></a><a href="#l36">36</a><td>  ELEMENT: 1,<tr><td><a id="l37"></a><a href="#l37">37</a><td>  ATTRIBUTE: 2,<tr><td><a id="l38"></a><a href="#l38">38</a><td>  TEXT: 3,<tr><td><a id="l39"></a><a href="#l39">39</a><td>  CDATA_SECTION: 4,<tr><td><a id="l40"></a><a href="#l40">40</a><td>  ENTITY_REFERENCE: 5,<tr><td><a id="l41"></a><a href="#l41">41</a><td>  ENTITY: 6,<tr><td><a id="l42"></a><a href="#l42">42</a><td>  PROCESSING_INSTRUCTION: 7,<tr><td><a id="l43"></a><a href="#l43">43</a><td>  COMMENT: 8,<tr><td><a id="l44"></a><a href="#l44">44</a><td>  DOCUMENT: 9,<tr><td><a id="l45"></a><a href="#l45">45</a><td>  DOCUMENT_TYPE: 10,<tr><td><a id="l46"></a><a href="#l46">46</a><td>  DOCUMENT_FRAGMENT: 11,<tr><td><a id="l47"></a><a href="#l47">47</a><td>  NOTATION: 12<tr><td><a id="l48"></a><a href="#l48">48</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/dom/safe.js.src.html b/docs/source/lib/goog/dom/safe.js.src.html
new file mode 100644
index 0000000..e37c7c3
--- /dev/null
+++ b/docs/source/lib/goog/dom/safe.js.src.html
@@ -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>safe.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/dom/safe.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Type-safe wrappers for unsafe DOM APIs.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * This file provides type-safe wrappers for DOM APIs that can result in<tr><td><a id="l19"></a><a href="#l19">19</a><td> * cross-site scripting (XSS) vulnerabilities, if the API is supplied with<tr><td><a id="l20"></a><a href="#l20">20</a><td> * untrusted (attacker-controlled) input.  Instead of plain strings, the type<tr><td><a id="l21"></a><a href="#l21">21</a><td> * safe wrappers consume values of types from the goog.html package whose<tr><td><a id="l22"></a><a href="#l22">22</a><td> * contract promises that values are safe to use in the corresponding context.<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * Hence, a program that exclusively uses the wrappers in this file (i.e., whose<tr><td><a id="l25"></a><a href="#l25">25</a><td> * only reference to security-sensitive raw DOM APIs are in this file) is<tr><td><a id="l26"></a><a href="#l26">26</a><td> * guaranteed to be free of XSS due to incorrect use of such DOM APIs (modulo<tr><td><a id="l27"></a><a href="#l27">27</a><td> * correctness of code that produces values of the respective goog.html types,<tr><td><a id="l28"></a><a href="#l28">28</a><td> * and absent code that violates type safety).<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * For example, assigning to an element&#39;s .innerHTML property a string that is<tr><td><a id="l31"></a><a href="#l31">31</a><td> * derived (even partially) from untrusted input typically results in an XSS<tr><td><a id="l32"></a><a href="#l32">32</a><td> * vulnerability. The type-safe wrapper goog.html.setInnerHtml consumes a value<tr><td><a id="l33"></a><a href="#l33">33</a><td> * of type goog.html.SafeHtml, whose contract states that using its values in a<tr><td><a id="l34"></a><a href="#l34">34</a><td> * HTML context will not result in XSS. Hence a program that is free of direct<tr><td><a id="l35"></a><a href="#l35">35</a><td> * assignments to any element&#39;s innerHTML property (with the exception of the<tr><td><a id="l36"></a><a href="#l36">36</a><td> * assignment to .innerHTML in this file) is guaranteed to be free of XSS due to<tr><td><a id="l37"></a><a href="#l37">37</a><td> * assignment of untrusted strings to the innerHTML property.<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>goog.provide(&#39;goog.dom.safe&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.provide(&#39;goog.dom.safe.InsertAdjacentHtmlPosition&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;goog.html.SafeHtml&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;goog.html.SafeUrl&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.require(&#39;goog.html.TrustedResourceUrl&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>/** @enum {string} */<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.dom.safe.InsertAdjacentHtmlPosition = {<tr><td><a id="l53"></a><a href="#l53">53</a><td>  AFTERBEGIN: &#39;afterbegin&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td>  AFTEREND: &#39;afterend&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td>  BEFOREBEGIN: &#39;beforebegin&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td>  BEFOREEND: &#39;beforeend&#39;<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> * Inserts known-safe HTML into a Node, at the specified position.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {!Node} node The node on which to call insertAdjacentHTML.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {!goog.dom.safe.InsertAdjacentHtmlPosition} position Position where<tr><td><a id="l64"></a><a href="#l64">64</a><td> *     to insert the HTML.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @param {!goog.html.SafeHtml} html The known-safe HTML to insert.<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.dom.safe.insertAdjacentHtml = function(node, position, html) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  node.insertAdjacentHTML(position, goog.html.SafeHtml.unwrap(html));<tr><td><a id="l69"></a><a href="#l69">69</a><td>};<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> * Assigns known-safe HTML to an element&#39;s innerHTML property.<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @param {!Element} elem The element whose innerHTML is to be assigned to.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.<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.dom.safe.setInnerHtml = function(elem, html) {<tr><td><a id="l78"></a><a href="#l78">78</a><td>  elem.innerHTML = goog.html.SafeHtml.unwrap(html);<tr><td><a id="l79"></a><a href="#l79">79</a><td>};<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Assigns known-safe HTML to an element&#39;s outerHTML property.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {!Element} elem The element whose outerHTML is to be assigned to.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.<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.dom.safe.setOuterHtml = function(elem, html) {<tr><td><a id="l88"></a><a href="#l88">88</a><td>  elem.outerHTML = goog.html.SafeHtml.unwrap(html);<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>/**<tr><td><a id="l93"></a><a href="#l93">93</a><td> * Writes known-safe HTML to a document.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @param {!Document} doc The document to be written to.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.<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.dom.safe.documentWrite = function(doc, html) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>  doc.write(goog.html.SafeHtml.unwrap(html));<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> * Safely assigns a URL to an anchor element&#39;s href property.<tr><td><a id="l104"></a><a href="#l104">104</a><td> *<tr><td><a id="l105"></a><a href="#l105">105</a><td> * If url is of type goog.html.SafeUrl, its value is unwrapped and assigned to<tr><td><a id="l106"></a><a href="#l106">106</a><td> * anchor&#39;s href property.  If url is of type string however, it is first<tr><td><a id="l107"></a><a href="#l107">107</a><td> * sanitized using goog.html.SafeUrl.sanitize.<tr><td><a id="l108"></a><a href="#l108">108</a><td> *<tr><td><a id="l109"></a><a href="#l109">109</a><td> * Example usage:<tr><td><a id="l110"></a><a href="#l110">110</a><td> *   goog.dom.safe.setAnchorHref(anchorEl, url);<tr><td><a id="l111"></a><a href="#l111">111</a><td> * which is a safe alternative to<tr><td><a id="l112"></a><a href="#l112">112</a><td> *   anchorEl.href = url;<tr><td><a id="l113"></a><a href="#l113">113</a><td> * The latter can result in XSS vulnerabilities if url is a<tr><td><a id="l114"></a><a href="#l114">114</a><td> * user-/attacker-controlled value.<tr><td><a id="l115"></a><a href="#l115">115</a><td> *<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @param {!HTMLAnchorElement} anchor The anchor element whose href property<tr><td><a id="l117"></a><a href="#l117">117</a><td> *     is to be assigned to.<tr><td><a id="l118"></a><a href="#l118">118</a><td> * @param {string|!goog.html.SafeUrl} url The URL to assign.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @see goog.html.SafeUrl#sanitize<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.dom.safe.setAnchorHref = function(anchor, url) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>  /** @type {!goog.html.SafeUrl} */<tr><td><a id="l123"></a><a href="#l123">123</a><td>  var safeUrl;<tr><td><a id="l124"></a><a href="#l124">124</a><td>  if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>    safeUrl = url;<tr><td><a id="l126"></a><a href="#l126">126</a><td>  } else {<tr><td><a id="l127"></a><a href="#l127">127</a><td>    safeUrl = goog.html.SafeUrl.sanitize(url);<tr><td><a id="l128"></a><a href="#l128">128</a><td>  }<tr><td><a id="l129"></a><a href="#l129">129</a><td>  anchor.href = goog.html.SafeUrl.unwrap(safeUrl);<tr><td><a id="l130"></a><a href="#l130">130</a><td>};<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/**<tr><td><a id="l134"></a><a href="#l134">134</a><td> * Safely assigns a URL to an embed element&#39;s src property.<tr><td><a id="l135"></a><a href="#l135">135</a><td> *<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Example usage:<tr><td><a id="l137"></a><a href="#l137">137</a><td> *   goog.dom.safe.setEmbedSrc(embedEl, url);<tr><td><a id="l138"></a><a href="#l138">138</a><td> * which is a safe alternative to<tr><td><a id="l139"></a><a href="#l139">139</a><td> *   embedEl.src = url;<tr><td><a id="l140"></a><a href="#l140">140</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l141"></a><a href="#l141">141</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l142"></a><a href="#l142">142</a><td> *<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {!HTMLEmbedElement} embed The embed element whose src property<tr><td><a id="l144"></a><a href="#l144">144</a><td> *     is to be assigned to.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.dom.safe.setEmbedSrc = function(embed, url) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  embed.src = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * Safely assigns a URL to a frame element&#39;s src property.<tr><td><a id="l154"></a><a href="#l154">154</a><td> *<tr><td><a id="l155"></a><a href="#l155">155</a><td> * Example usage:<tr><td><a id="l156"></a><a href="#l156">156</a><td> *   goog.dom.safe.setFrameSrc(frameEl, url);<tr><td><a id="l157"></a><a href="#l157">157</a><td> * which is a safe alternative to<tr><td><a id="l158"></a><a href="#l158">158</a><td> *   frameEl.src = url;<tr><td><a id="l159"></a><a href="#l159">159</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l160"></a><a href="#l160">160</a><td> * the URL refers to a trustworthy resource.<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 {!HTMLFrameElement} frame The frame element whose src property<tr><td><a id="l163"></a><a href="#l163">163</a><td> *     is to be assigned to.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l165"></a><a href="#l165">165</a><td> */<tr><td><a id="l166"></a><a href="#l166">166</a><td>goog.dom.safe.setFrameSrc = function(frame, url) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>  frame.src = goog.html.TrustedResourceUrl.unwrap(url);<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> * Safely assigns a URL to an iframe element&#39;s src property.<tr><td><a id="l173"></a><a href="#l173">173</a><td> *<tr><td><a id="l174"></a><a href="#l174">174</a><td> * Example usage:<tr><td><a id="l175"></a><a href="#l175">175</a><td> *   goog.dom.safe.setIframeSrc(iframeEl, url);<tr><td><a id="l176"></a><a href="#l176">176</a><td> * which is a safe alternative to<tr><td><a id="l177"></a><a href="#l177">177</a><td> *   iframeEl.src = url;<tr><td><a id="l178"></a><a href="#l178">178</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l179"></a><a href="#l179">179</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l180"></a><a href="#l180">180</a><td> *<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {!HTMLIFrameElement} iframe The iframe element whose src property<tr><td><a id="l182"></a><a href="#l182">182</a><td> *     is to be assigned to.<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>goog.dom.safe.setIframeSrc = function(iframe, url) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>  iframe.src = goog.html.TrustedResourceUrl.unwrap(url);<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><tr><td><a id="l190"></a><a href="#l190">190</a><td>/**<tr><td><a id="l191"></a><a href="#l191">191</a><td> * Safely sets a link element&#39;s href and rel properties. Whether or not<tr><td><a id="l192"></a><a href="#l192">192</a><td> * the URL assigned to href has to be a goog.html.TrustedResourceUrl<tr><td><a id="l193"></a><a href="#l193">193</a><td> * depends on the value of the rel property. If rel contains &quot;stylesheet&quot;<tr><td><a id="l194"></a><a href="#l194">194</a><td> * then a TrustedResourceUrl is required.<tr><td><a id="l195"></a><a href="#l195">195</a><td> *<tr><td><a id="l196"></a><a href="#l196">196</a><td> * Example usage:<tr><td><a id="l197"></a><a href="#l197">197</a><td> *   goog.dom.safe.setLinkHrefAndRel(linkEl, url, &#39;stylesheet&#39;);<tr><td><a id="l198"></a><a href="#l198">198</a><td> * which is a safe alternative to<tr><td><a id="l199"></a><a href="#l199">199</a><td> *   linkEl.rel = &#39;stylesheet&#39;;<tr><td><a id="l200"></a><a href="#l200">200</a><td> *   linkEl.href = url;<tr><td><a id="l201"></a><a href="#l201">201</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l202"></a><a href="#l202">202</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l203"></a><a href="#l203">203</a><td> *<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {!HTMLLinkElement} link The link element whose href property<tr><td><a id="l205"></a><a href="#l205">205</a><td> *     is to be assigned to.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @param {string|!goog.html.SafeUrl|!goog.html.TrustedResourceUrl} url The URL<tr><td><a id="l207"></a><a href="#l207">207</a><td> *     to assign to the href property. Must be a TrustedResourceUrl if the<tr><td><a id="l208"></a><a href="#l208">208</a><td> *     value assigned to rel contains &quot;stylesheet&quot;. A string value is<tr><td><a id="l209"></a><a href="#l209">209</a><td> *     sanitized with goog.html.SafeUrl.sanitize.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {string} rel The value to assign to the rel property.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @throws {Error} if rel contains &quot;stylesheet&quot; and url is not a<tr><td><a id="l212"></a><a href="#l212">212</a><td> *     TrustedResourceUrl<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @see goog.html.SafeUrl#sanitize<tr><td><a id="l214"></a><a href="#l214">214</a><td> */<tr><td><a id="l215"></a><a href="#l215">215</a><td>goog.dom.safe.setLinkHrefAndRel = function(link, url, rel) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>  link.rel = rel;<tr><td><a id="l217"></a><a href="#l217">217</a><td>  if (goog.string.caseInsensitiveContains(rel, &#39;stylesheet&#39;)) {<tr><td><a id="l218"></a><a href="#l218">218</a><td>    goog.asserts.assert(<tr><td><a id="l219"></a><a href="#l219">219</a><td>        url instanceof goog.html.TrustedResourceUrl,<tr><td><a id="l220"></a><a href="#l220">220</a><td>        &#39;URL must be TrustedResourceUrl because &quot;rel&quot; contains &quot;stylesheet&quot;&#39;);<tr><td><a id="l221"></a><a href="#l221">221</a><td>    link.href = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l222"></a><a href="#l222">222</a><td>  } else if (url instanceof goog.html.TrustedResourceUrl) {<tr><td><a id="l223"></a><a href="#l223">223</a><td>    link.href = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l224"></a><a href="#l224">224</a><td>  } else if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l225"></a><a href="#l225">225</a><td>    link.href = goog.html.SafeUrl.unwrap(url);<tr><td><a id="l226"></a><a href="#l226">226</a><td>  } else {  // string<tr><td><a id="l227"></a><a href="#l227">227</a><td>    // SafeUrl.sanitize must return legitimate SafeUrl when passed a string.<tr><td><a id="l228"></a><a href="#l228">228</a><td>    link.href = goog.html.SafeUrl.sanitize(url).getTypedStringValue();<tr><td><a id="l229"></a><a href="#l229">229</a><td>  }<tr><td><a id="l230"></a><a href="#l230">230</a><td>};<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Safely assigns a URL to an object element&#39;s data property.<tr><td><a id="l235"></a><a href="#l235">235</a><td> *<tr><td><a id="l236"></a><a href="#l236">236</a><td> * Example usage:<tr><td><a id="l237"></a><a href="#l237">237</a><td> *   goog.dom.safe.setObjectData(objectEl, url);<tr><td><a id="l238"></a><a href="#l238">238</a><td> * which is a safe alternative to<tr><td><a id="l239"></a><a href="#l239">239</a><td> *   objectEl.data = url;<tr><td><a id="l240"></a><a href="#l240">240</a><td> * The latter can result in loading untrusted code unless setit is ensured that<tr><td><a id="l241"></a><a href="#l241">241</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l242"></a><a href="#l242">242</a><td> *<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {!HTMLObjectElement} object The object element whose data property<tr><td><a id="l244"></a><a href="#l244">244</a><td> *     is to be assigned to.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<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.dom.safe.setObjectData = function(object, url) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>  object.data = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l249"></a><a href="#l249">249</a><td>};<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td>/**<tr><td><a id="l253"></a><a href="#l253">253</a><td> * Safely assigns a URL to an iframe element&#39;s src property.<tr><td><a id="l254"></a><a href="#l254">254</a><td> *<tr><td><a id="l255"></a><a href="#l255">255</a><td> * Example usage:<tr><td><a id="l256"></a><a href="#l256">256</a><td> *   goog.dom.safe.setScriptSrc(scriptEl, url);<tr><td><a id="l257"></a><a href="#l257">257</a><td> * which is a safe alternative to<tr><td><a id="l258"></a><a href="#l258">258</a><td> *   scriptEl.src = url;<tr><td><a id="l259"></a><a href="#l259">259</a><td> * The latter can result in loading untrusted code unless it is ensured that<tr><td><a id="l260"></a><a href="#l260">260</a><td> * the URL refers to a trustworthy resource.<tr><td><a id="l261"></a><a href="#l261">261</a><td> *<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @param {!HTMLScriptElement} script The script element whose src property<tr><td><a id="l263"></a><a href="#l263">263</a><td> *     is to be assigned to.<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @param {!goog.html.TrustedResourceUrl} url The URL to assign.<tr><td><a id="l265"></a><a href="#l265">265</a><td> */<tr><td><a id="l266"></a><a href="#l266">266</a><td>goog.dom.safe.setScriptSrc = function(script, url) {<tr><td><a id="l267"></a><a href="#l267">267</a><td>  script.src = goog.html.TrustedResourceUrl.unwrap(url);<tr><td><a id="l268"></a><a href="#l268">268</a><td>};<tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>/**<tr><td><a id="l272"></a><a href="#l272">272</a><td> * Safely assigns a URL to a Location object&#39;s href property.<tr><td><a id="l273"></a><a href="#l273">273</a><td> *<tr><td><a id="l274"></a><a href="#l274">274</a><td> * If url is of type goog.html.SafeUrl, its value is unwrapped and assigned to<tr><td><a id="l275"></a><a href="#l275">275</a><td> * loc&#39;s href property.  If url is of type string however, it is first sanitized<tr><td><a id="l276"></a><a href="#l276">276</a><td> * using goog.html.SafeUrl.sanitize.<tr><td><a id="l277"></a><a href="#l277">277</a><td> *<tr><td><a id="l278"></a><a href="#l278">278</a><td> * Example usage:<tr><td><a id="l279"></a><a href="#l279">279</a><td> *   goog.dom.safe.setLocationHref(document.location, redirectUrl);<tr><td><a id="l280"></a><a href="#l280">280</a><td> * which is a safe alternative to<tr><td><a id="l281"></a><a href="#l281">281</a><td> *   document.location.href = redirectUrl;<tr><td><a id="l282"></a><a href="#l282">282</a><td> * The latter can result in XSS vulnerabilities if redirectUrl is a<tr><td><a id="l283"></a><a href="#l283">283</a><td> * user-/attacker-controlled value.<tr><td><a id="l284"></a><a href="#l284">284</a><td> *<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @param {!Location} loc The Location object whose href property is to be<tr><td><a id="l286"></a><a href="#l286">286</a><td> *     assigned to.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @param {string|!goog.html.SafeUrl} url The URL to assign.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @see goog.html.SafeUrl#sanitize<tr><td><a id="l289"></a><a href="#l289">289</a><td> */<tr><td><a id="l290"></a><a href="#l290">290</a><td>goog.dom.safe.setLocationHref = function(loc, url) {<tr><td><a id="l291"></a><a href="#l291">291</a><td>  /** @type {!goog.html.SafeUrl} */<tr><td><a id="l292"></a><a href="#l292">292</a><td>  var safeUrl;<tr><td><a id="l293"></a><a href="#l293">293</a><td>  if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l294"></a><a href="#l294">294</a><td>    safeUrl = url;<tr><td><a id="l295"></a><a href="#l295">295</a><td>  } else {<tr><td><a id="l296"></a><a href="#l296">296</a><td>    safeUrl = goog.html.SafeUrl.sanitize(url);<tr><td><a id="l297"></a><a href="#l297">297</a><td>  }<tr><td><a id="l298"></a><a href="#l298">298</a><td>  loc.href = goog.html.SafeUrl.unwrap(safeUrl);<tr><td><a id="l299"></a><a href="#l299">299</a><td>};<tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td>/**<tr><td><a id="l303"></a><a href="#l303">303</a><td> * Safely opens a URL in a new window (via window.open).<tr><td><a id="l304"></a><a href="#l304">304</a><td> *<tr><td><a id="l305"></a><a href="#l305">305</a><td> * If url is of type goog.html.SafeUrl, its value is unwrapped and passed in to<tr><td><a id="l306"></a><a href="#l306">306</a><td> * window.open.  If url is of type string however, it is first sanitized<tr><td><a id="l307"></a><a href="#l307">307</a><td> * using goog.html.SafeUrl.sanitize.<tr><td><a id="l308"></a><a href="#l308">308</a><td> *<tr><td><a id="l309"></a><a href="#l309">309</a><td> * Note that this function does not prevent leakages via the referer that is<tr><td><a id="l310"></a><a href="#l310">310</a><td> * sent by window.open. It is advised to only use this to open 1st party URLs.<tr><td><a id="l311"></a><a href="#l311">311</a><td> *<tr><td><a id="l312"></a><a href="#l312">312</a><td> * Example usage:<tr><td><a id="l313"></a><a href="#l313">313</a><td> *   goog.dom.safe.openInWindow(url);<tr><td><a id="l314"></a><a href="#l314">314</a><td> * which is a safe alternative to<tr><td><a id="l315"></a><a href="#l315">315</a><td> *   window.open(url);<tr><td><a id="l316"></a><a href="#l316">316</a><td> * The latter can result in XSS vulnerabilities if redirectUrl is a<tr><td><a id="l317"></a><a href="#l317">317</a><td> * user-/attacker-controlled value.<tr><td><a id="l318"></a><a href="#l318">318</a><td> *<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @param {string|!goog.html.SafeUrl} url The URL to open.<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {Window=} opt_openerWin Window of which to call the .open() method.<tr><td><a id="l321"></a><a href="#l321">321</a><td> *     Defaults to the global window.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {!goog.string.Const=} opt_name Name of the window to open in. Can be<tr><td><a id="l323"></a><a href="#l323">323</a><td> *     _top, etc as allowed by window.open().<tr><td><a id="l324"></a><a href="#l324">324</a><td> * @param {string=} opt_specs Comma-separated list of specifications, same as<tr><td><a id="l325"></a><a href="#l325">325</a><td> *     in window.open().<tr><td><a id="l326"></a><a href="#l326">326</a><td> * @param {boolean=} opt_replace Whether to replace the current entry in browser<tr><td><a id="l327"></a><a href="#l327">327</a><td> *     history, same as in window.open().<tr><td><a id="l328"></a><a href="#l328">328</a><td> * @return {Window} Window the url was opened in.<tr><td><a id="l329"></a><a href="#l329">329</a><td> */<tr><td><a id="l330"></a><a href="#l330">330</a><td>goog.dom.safe.openInWindow = function(<tr><td><a id="l331"></a><a href="#l331">331</a><td>    url, opt_openerWin, opt_name, opt_specs, opt_replace) {<tr><td><a id="l332"></a><a href="#l332">332</a><td>  /** @type {!goog.html.SafeUrl} */<tr><td><a id="l333"></a><a href="#l333">333</a><td>  var safeUrl;<tr><td><a id="l334"></a><a href="#l334">334</a><td>  if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l335"></a><a href="#l335">335</a><td>    safeUrl = url;<tr><td><a id="l336"></a><a href="#l336">336</a><td>  } else {<tr><td><a id="l337"></a><a href="#l337">337</a><td>    safeUrl = goog.html.SafeUrl.sanitize(url);<tr><td><a id="l338"></a><a href="#l338">338</a><td>  }<tr><td><a id="l339"></a><a href="#l339">339</a><td>  var win = opt_openerWin || window;<tr><td><a id="l340"></a><a href="#l340">340</a><td>  return win.open(goog.html.SafeUrl.unwrap(safeUrl),<tr><td><a id="l341"></a><a href="#l341">341</a><td>      // If opt_name is undefined, simply passing that in to open() causes IE to<tr><td><a id="l342"></a><a href="#l342">342</a><td>      // reuse the current window instead of opening a new one. Thus we pass &#39;&#39;<tr><td><a id="l343"></a><a href="#l343">343</a><td>      // in instead, which according to spec opens a new window. See<tr><td><a id="l344"></a><a href="#l344">344</a><td>      // https://html.spec.whatwg.org/multipage/browsers.html#dom-open .<tr><td><a id="l345"></a><a href="#l345">345</a><td>      opt_name ? goog.string.Const.unwrap(opt_name) : &#39;&#39;,<tr><td><a id="l346"></a><a href="#l346">346</a><td>      opt_specs, opt_replace);<tr><td><a id="l347"></a><a href="#l347">347</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/dom/tagname.js.src.html b/docs/source/lib/goog/dom/tagname.js.src.html
new file mode 100644
index 0000000..871a3c4
--- /dev/null
+++ b/docs/source/lib/goog/dom/tagname.js.src.html
@@ -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>tagname.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/dom/tagname.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Defines the goog.dom.TagName enum.  This enumerates<tr><td><a id="l17"></a><a href="#l17">17</a><td> * all HTML tag names specified in either the the W3C HTML 4.01 index of<tr><td><a id="l18"></a><a href="#l18">18</a><td> * elements or the HTML5 draft specification.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * References:<tr><td><a id="l21"></a><a href="#l21">21</a><td> * http://www.w3.org/TR/html401/index/elements.html<tr><td><a id="l22"></a><a href="#l22">22</a><td> * http://dev.w3.org/html5/spec/section-index.html<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> */<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.dom.TagName&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Enum of all html tag names specified by the W3C HTML4.01 and HTML5<tr><td><a id="l30"></a><a href="#l30">30</a><td> * specifications.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @enum {string}<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.dom.TagName = {<tr><td><a id="l34"></a><a href="#l34">34</a><td>  A: &#39;A&#39;,<tr><td><a id="l35"></a><a href="#l35">35</a><td>  ABBR: &#39;ABBR&#39;,<tr><td><a id="l36"></a><a href="#l36">36</a><td>  ACRONYM: &#39;ACRONYM&#39;,<tr><td><a id="l37"></a><a href="#l37">37</a><td>  ADDRESS: &#39;ADDRESS&#39;,<tr><td><a id="l38"></a><a href="#l38">38</a><td>  APPLET: &#39;APPLET&#39;,<tr><td><a id="l39"></a><a href="#l39">39</a><td>  AREA: &#39;AREA&#39;,<tr><td><a id="l40"></a><a href="#l40">40</a><td>  ARTICLE: &#39;ARTICLE&#39;,<tr><td><a id="l41"></a><a href="#l41">41</a><td>  ASIDE: &#39;ASIDE&#39;,<tr><td><a id="l42"></a><a href="#l42">42</a><td>  AUDIO: &#39;AUDIO&#39;,<tr><td><a id="l43"></a><a href="#l43">43</a><td>  B: &#39;B&#39;,<tr><td><a id="l44"></a><a href="#l44">44</a><td>  BASE: &#39;BASE&#39;,<tr><td><a id="l45"></a><a href="#l45">45</a><td>  BASEFONT: &#39;BASEFONT&#39;,<tr><td><a id="l46"></a><a href="#l46">46</a><td>  BDI: &#39;BDI&#39;,<tr><td><a id="l47"></a><a href="#l47">47</a><td>  BDO: &#39;BDO&#39;,<tr><td><a id="l48"></a><a href="#l48">48</a><td>  BIG: &#39;BIG&#39;,<tr><td><a id="l49"></a><a href="#l49">49</a><td>  BLOCKQUOTE: &#39;BLOCKQUOTE&#39;,<tr><td><a id="l50"></a><a href="#l50">50</a><td>  BODY: &#39;BODY&#39;,<tr><td><a id="l51"></a><a href="#l51">51</a><td>  BR: &#39;BR&#39;,<tr><td><a id="l52"></a><a href="#l52">52</a><td>  BUTTON: &#39;BUTTON&#39;,<tr><td><a id="l53"></a><a href="#l53">53</a><td>  CANVAS: &#39;CANVAS&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td>  CAPTION: &#39;CAPTION&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td>  CENTER: &#39;CENTER&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td>  CITE: &#39;CITE&#39;,<tr><td><a id="l57"></a><a href="#l57">57</a><td>  CODE: &#39;CODE&#39;,<tr><td><a id="l58"></a><a href="#l58">58</a><td>  COL: &#39;COL&#39;,<tr><td><a id="l59"></a><a href="#l59">59</a><td>  COLGROUP: &#39;COLGROUP&#39;,<tr><td><a id="l60"></a><a href="#l60">60</a><td>  COMMAND: &#39;COMMAND&#39;,<tr><td><a id="l61"></a><a href="#l61">61</a><td>  DATA: &#39;DATA&#39;,<tr><td><a id="l62"></a><a href="#l62">62</a><td>  DATALIST: &#39;DATALIST&#39;,<tr><td><a id="l63"></a><a href="#l63">63</a><td>  DD: &#39;DD&#39;,<tr><td><a id="l64"></a><a href="#l64">64</a><td>  DEL: &#39;DEL&#39;,<tr><td><a id="l65"></a><a href="#l65">65</a><td>  DETAILS: &#39;DETAILS&#39;,<tr><td><a id="l66"></a><a href="#l66">66</a><td>  DFN: &#39;DFN&#39;,<tr><td><a id="l67"></a><a href="#l67">67</a><td>  DIALOG: &#39;DIALOG&#39;,<tr><td><a id="l68"></a><a href="#l68">68</a><td>  DIR: &#39;DIR&#39;,<tr><td><a id="l69"></a><a href="#l69">69</a><td>  DIV: &#39;DIV&#39;,<tr><td><a id="l70"></a><a href="#l70">70</a><td>  DL: &#39;DL&#39;,<tr><td><a id="l71"></a><a href="#l71">71</a><td>  DT: &#39;DT&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td>  EM: &#39;EM&#39;,<tr><td><a id="l73"></a><a href="#l73">73</a><td>  EMBED: &#39;EMBED&#39;,<tr><td><a id="l74"></a><a href="#l74">74</a><td>  FIELDSET: &#39;FIELDSET&#39;,<tr><td><a id="l75"></a><a href="#l75">75</a><td>  FIGCAPTION: &#39;FIGCAPTION&#39;,<tr><td><a id="l76"></a><a href="#l76">76</a><td>  FIGURE: &#39;FIGURE&#39;,<tr><td><a id="l77"></a><a href="#l77">77</a><td>  FONT: &#39;FONT&#39;,<tr><td><a id="l78"></a><a href="#l78">78</a><td>  FOOTER: &#39;FOOTER&#39;,<tr><td><a id="l79"></a><a href="#l79">79</a><td>  FORM: &#39;FORM&#39;,<tr><td><a id="l80"></a><a href="#l80">80</a><td>  FRAME: &#39;FRAME&#39;,<tr><td><a id="l81"></a><a href="#l81">81</a><td>  FRAMESET: &#39;FRAMESET&#39;,<tr><td><a id="l82"></a><a href="#l82">82</a><td>  H1: &#39;H1&#39;,<tr><td><a id="l83"></a><a href="#l83">83</a><td>  H2: &#39;H2&#39;,<tr><td><a id="l84"></a><a href="#l84">84</a><td>  H3: &#39;H3&#39;,<tr><td><a id="l85"></a><a href="#l85">85</a><td>  H4: &#39;H4&#39;,<tr><td><a id="l86"></a><a href="#l86">86</a><td>  H5: &#39;H5&#39;,<tr><td><a id="l87"></a><a href="#l87">87</a><td>  H6: &#39;H6&#39;,<tr><td><a id="l88"></a><a href="#l88">88</a><td>  HEAD: &#39;HEAD&#39;,<tr><td><a id="l89"></a><a href="#l89">89</a><td>  HEADER: &#39;HEADER&#39;,<tr><td><a id="l90"></a><a href="#l90">90</a><td>  HGROUP: &#39;HGROUP&#39;,<tr><td><a id="l91"></a><a href="#l91">91</a><td>  HR: &#39;HR&#39;,<tr><td><a id="l92"></a><a href="#l92">92</a><td>  HTML: &#39;HTML&#39;,<tr><td><a id="l93"></a><a href="#l93">93</a><td>  I: &#39;I&#39;,<tr><td><a id="l94"></a><a href="#l94">94</a><td>  IFRAME: &#39;IFRAME&#39;,<tr><td><a id="l95"></a><a href="#l95">95</a><td>  IMG: &#39;IMG&#39;,<tr><td><a id="l96"></a><a href="#l96">96</a><td>  INPUT: &#39;INPUT&#39;,<tr><td><a id="l97"></a><a href="#l97">97</a><td>  INS: &#39;INS&#39;,<tr><td><a id="l98"></a><a href="#l98">98</a><td>  ISINDEX: &#39;ISINDEX&#39;,<tr><td><a id="l99"></a><a href="#l99">99</a><td>  KBD: &#39;KBD&#39;,<tr><td><a id="l100"></a><a href="#l100">100</a><td>  KEYGEN: &#39;KEYGEN&#39;,<tr><td><a id="l101"></a><a href="#l101">101</a><td>  LABEL: &#39;LABEL&#39;,<tr><td><a id="l102"></a><a href="#l102">102</a><td>  LEGEND: &#39;LEGEND&#39;,<tr><td><a id="l103"></a><a href="#l103">103</a><td>  LI: &#39;LI&#39;,<tr><td><a id="l104"></a><a href="#l104">104</a><td>  LINK: &#39;LINK&#39;,<tr><td><a id="l105"></a><a href="#l105">105</a><td>  MAP: &#39;MAP&#39;,<tr><td><a id="l106"></a><a href="#l106">106</a><td>  MARK: &#39;MARK&#39;,<tr><td><a id="l107"></a><a href="#l107">107</a><td>  MATH: &#39;MATH&#39;,<tr><td><a id="l108"></a><a href="#l108">108</a><td>  MENU: &#39;MENU&#39;,<tr><td><a id="l109"></a><a href="#l109">109</a><td>  META: &#39;META&#39;,<tr><td><a id="l110"></a><a href="#l110">110</a><td>  METER: &#39;METER&#39;,<tr><td><a id="l111"></a><a href="#l111">111</a><td>  NAV: &#39;NAV&#39;,<tr><td><a id="l112"></a><a href="#l112">112</a><td>  NOFRAMES: &#39;NOFRAMES&#39;,<tr><td><a id="l113"></a><a href="#l113">113</a><td>  NOSCRIPT: &#39;NOSCRIPT&#39;,<tr><td><a id="l114"></a><a href="#l114">114</a><td>  OBJECT: &#39;OBJECT&#39;,<tr><td><a id="l115"></a><a href="#l115">115</a><td>  OL: &#39;OL&#39;,<tr><td><a id="l116"></a><a href="#l116">116</a><td>  OPTGROUP: &#39;OPTGROUP&#39;,<tr><td><a id="l117"></a><a href="#l117">117</a><td>  OPTION: &#39;OPTION&#39;,<tr><td><a id="l118"></a><a href="#l118">118</a><td>  OUTPUT: &#39;OUTPUT&#39;,<tr><td><a id="l119"></a><a href="#l119">119</a><td>  P: &#39;P&#39;,<tr><td><a id="l120"></a><a href="#l120">120</a><td>  PARAM: &#39;PARAM&#39;,<tr><td><a id="l121"></a><a href="#l121">121</a><td>  PRE: &#39;PRE&#39;,<tr><td><a id="l122"></a><a href="#l122">122</a><td>  PROGRESS: &#39;PROGRESS&#39;,<tr><td><a id="l123"></a><a href="#l123">123</a><td>  Q: &#39;Q&#39;,<tr><td><a id="l124"></a><a href="#l124">124</a><td>  RP: &#39;RP&#39;,<tr><td><a id="l125"></a><a href="#l125">125</a><td>  RT: &#39;RT&#39;,<tr><td><a id="l126"></a><a href="#l126">126</a><td>  RUBY: &#39;RUBY&#39;,<tr><td><a id="l127"></a><a href="#l127">127</a><td>  S: &#39;S&#39;,<tr><td><a id="l128"></a><a href="#l128">128</a><td>  SAMP: &#39;SAMP&#39;,<tr><td><a id="l129"></a><a href="#l129">129</a><td>  SCRIPT: &#39;SCRIPT&#39;,<tr><td><a id="l130"></a><a href="#l130">130</a><td>  SECTION: &#39;SECTION&#39;,<tr><td><a id="l131"></a><a href="#l131">131</a><td>  SELECT: &#39;SELECT&#39;,<tr><td><a id="l132"></a><a href="#l132">132</a><td>  SMALL: &#39;SMALL&#39;,<tr><td><a id="l133"></a><a href="#l133">133</a><td>  SOURCE: &#39;SOURCE&#39;,<tr><td><a id="l134"></a><a href="#l134">134</a><td>  SPAN: &#39;SPAN&#39;,<tr><td><a id="l135"></a><a href="#l135">135</a><td>  STRIKE: &#39;STRIKE&#39;,<tr><td><a id="l136"></a><a href="#l136">136</a><td>  STRONG: &#39;STRONG&#39;,<tr><td><a id="l137"></a><a href="#l137">137</a><td>  STYLE: &#39;STYLE&#39;,<tr><td><a id="l138"></a><a href="#l138">138</a><td>  SUB: &#39;SUB&#39;,<tr><td><a id="l139"></a><a href="#l139">139</a><td>  SUMMARY: &#39;SUMMARY&#39;,<tr><td><a id="l140"></a><a href="#l140">140</a><td>  SUP: &#39;SUP&#39;,<tr><td><a id="l141"></a><a href="#l141">141</a><td>  SVG: &#39;SVG&#39;,<tr><td><a id="l142"></a><a href="#l142">142</a><td>  TABLE: &#39;TABLE&#39;,<tr><td><a id="l143"></a><a href="#l143">143</a><td>  TBODY: &#39;TBODY&#39;,<tr><td><a id="l144"></a><a href="#l144">144</a><td>  TD: &#39;TD&#39;,<tr><td><a id="l145"></a><a href="#l145">145</a><td>  TEMPLATE: &#39;TEMPLATE&#39;,<tr><td><a id="l146"></a><a href="#l146">146</a><td>  TEXTAREA: &#39;TEXTAREA&#39;,<tr><td><a id="l147"></a><a href="#l147">147</a><td>  TFOOT: &#39;TFOOT&#39;,<tr><td><a id="l148"></a><a href="#l148">148</a><td>  TH: &#39;TH&#39;,<tr><td><a id="l149"></a><a href="#l149">149</a><td>  THEAD: &#39;THEAD&#39;,<tr><td><a id="l150"></a><a href="#l150">150</a><td>  TIME: &#39;TIME&#39;,<tr><td><a id="l151"></a><a href="#l151">151</a><td>  TITLE: &#39;TITLE&#39;,<tr><td><a id="l152"></a><a href="#l152">152</a><td>  TR: &#39;TR&#39;,<tr><td><a id="l153"></a><a href="#l153">153</a><td>  TRACK: &#39;TRACK&#39;,<tr><td><a id="l154"></a><a href="#l154">154</a><td>  TT: &#39;TT&#39;,<tr><td><a id="l155"></a><a href="#l155">155</a><td>  U: &#39;U&#39;,<tr><td><a id="l156"></a><a href="#l156">156</a><td>  UL: &#39;UL&#39;,<tr><td><a id="l157"></a><a href="#l157">157</a><td>  VAR: &#39;VAR&#39;,<tr><td><a id="l158"></a><a href="#l158">158</a><td>  VIDEO: &#39;VIDEO&#39;,<tr><td><a id="l159"></a><a href="#l159">159</a><td>  WBR: &#39;WBR&#39;<tr><td><a id="l160"></a><a href="#l160">160</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/dom/tags.js.src.html b/docs/source/lib/goog/dom/tags.js.src.html
new file mode 100644
index 0000000..09b1a51
--- /dev/null
+++ b/docs/source/lib/goog/dom/tags.js.src.html
@@ -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>tags.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/dom/tags.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2014 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities for HTML element tag names.<tr><td><a id="l17"></a><a href="#l17">17</a><td> */<tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.provide(&#39;goog.dom.tags&#39;);<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.require(&#39;goog.object&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/**<tr><td><a id="l24"></a><a href="#l24">24</a><td> * The void elements specified by<tr><td><a id="l25"></a><a href="#l25">25</a><td> * http://www.w3.org/TR/html-markup/syntax.html#void-elements.<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @const @private {!Object&lt;string, boolean&gt;}<tr><td><a id="l27"></a><a href="#l27">27</a><td> */<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.dom.tags.VOID_TAGS_ = goog.object.createSet(<tr><td><a id="l29"></a><a href="#l29">29</a><td>    &#39;area&#39;, &#39;base&#39;, &#39;br&#39;, &#39;col&#39;, &#39;command&#39;, &#39;embed&#39;, &#39;hr&#39;, &#39;img&#39;, &#39;input&#39;,<tr><td><a id="l30"></a><a href="#l30">30</a><td>    &#39;keygen&#39;, &#39;link&#39;, &#39;meta&#39;, &#39;param&#39;, &#39;source&#39;, &#39;track&#39;, &#39;wbr&#39;);<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>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * Checks whether the tag is void (with no contents allowed and no legal end<tr><td><a id="l35"></a><a href="#l35">35</a><td> * tag), for example &#39;br&#39;.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @param {string} tagName The tag name in lower case.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @return {boolean}<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.dom.tags.isVoidTag = function(tagName) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>  return goog.dom.tags.VOID_TAGS_[tagName] === true;<tr><td><a id="l41"></a><a href="#l41">41</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/dom/vendor.js.src.html b/docs/source/lib/goog/dom/vendor.js.src.html
new file mode 100644
index 0000000..d97e89d
--- /dev/null
+++ b/docs/source/lib/goog/dom/vendor.js.src.html
@@ -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>vendor.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/dom/vendor.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Vendor prefix getters.<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>goog.provide(&#39;goog.dom.vendor&#39;);<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.require(&#39;goog.string&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.userAgent&#39;);<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> * Returns the JS vendor prefix used in CSS properties. Different vendors<tr><td><a id="l27"></a><a href="#l27">27</a><td> * use different methods of changing the case of the property names.<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @return {?string} The JS vendor prefix or null if there is none.<tr><td><a id="l30"></a><a href="#l30">30</a><td> */<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.dom.vendor.getVendorJsPrefix = function() {<tr><td><a id="l32"></a><a href="#l32">32</a><td>  if (goog.userAgent.WEBKIT) {<tr><td><a id="l33"></a><a href="#l33">33</a><td>    return &#39;Webkit&#39;;<tr><td><a id="l34"></a><a href="#l34">34</a><td>  } else if (goog.userAgent.GECKO) {<tr><td><a id="l35"></a><a href="#l35">35</a><td>    return &#39;Moz&#39;;<tr><td><a id="l36"></a><a href="#l36">36</a><td>  } else if (goog.userAgent.IE) {<tr><td><a id="l37"></a><a href="#l37">37</a><td>    return &#39;ms&#39;;<tr><td><a id="l38"></a><a href="#l38">38</a><td>  } else if (goog.userAgent.OPERA) {<tr><td><a id="l39"></a><a href="#l39">39</a><td>    return &#39;O&#39;;<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>  return null;<tr><td><a id="l43"></a><a href="#l43">43</a><td>};<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * Returns the vendor prefix used in CSS properties.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @return {?string} The vendor prefix or null if there is none.<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.dom.vendor.getVendorPrefix = function() {<tr><td><a id="l52"></a><a href="#l52">52</a><td>  if (goog.userAgent.WEBKIT) {<tr><td><a id="l53"></a><a href="#l53">53</a><td>    return &#39;-webkit&#39;;<tr><td><a id="l54"></a><a href="#l54">54</a><td>  } else if (goog.userAgent.GECKO) {<tr><td><a id="l55"></a><a href="#l55">55</a><td>    return &#39;-moz&#39;;<tr><td><a id="l56"></a><a href="#l56">56</a><td>  } else if (goog.userAgent.IE) {<tr><td><a id="l57"></a><a href="#l57">57</a><td>    return &#39;-ms&#39;;<tr><td><a id="l58"></a><a href="#l58">58</a><td>  } else if (goog.userAgent.OPERA) {<tr><td><a id="l59"></a><a href="#l59">59</a><td>    return &#39;-o&#39;;<tr><td><a id="l60"></a><a href="#l60">60</a><td>  }<tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td>  return null;<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> * @param {string} propertyName A property name.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @param {!Object=} opt_object If provided, we verify if the property exists in<tr><td><a id="l69"></a><a href="#l69">69</a><td> *     the object.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @return {?string} A vendor prefixed property name, or null if it does not<tr><td><a id="l71"></a><a href="#l71">71</a><td> *     exist.<tr><td><a id="l72"></a><a href="#l72">72</a><td> */<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.dom.vendor.getPrefixedPropertyName = function(propertyName, opt_object) {<tr><td><a id="l74"></a><a href="#l74">74</a><td>  // We first check for a non-prefixed property, if available.<tr><td><a id="l75"></a><a href="#l75">75</a><td>  if (opt_object &amp;&amp; propertyName in opt_object) {<tr><td><a id="l76"></a><a href="#l76">76</a><td>    return propertyName;<tr><td><a id="l77"></a><a href="#l77">77</a><td>  }<tr><td><a id="l78"></a><a href="#l78">78</a><td>  var prefix = goog.dom.vendor.getVendorJsPrefix();<tr><td><a id="l79"></a><a href="#l79">79</a><td>  if (prefix) {<tr><td><a id="l80"></a><a href="#l80">80</a><td>    prefix = prefix.toLowerCase();<tr><td><a id="l81"></a><a href="#l81">81</a><td>    var prefixedPropertyName = prefix + goog.string.toTitleCase(propertyName);<tr><td><a id="l82"></a><a href="#l82">82</a><td>    return (!goog.isDef(opt_object) || prefixedPropertyName in opt_object) ?<tr><td><a id="l83"></a><a href="#l83">83</a><td>        prefixedPropertyName : null;<tr><td><a id="l84"></a><a href="#l84">84</a><td>  }<tr><td><a id="l85"></a><a href="#l85">85</a><td>  return null;<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<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> * @param {string} eventType An event type.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @return {string} A lower-cased vendor prefixed event type.<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.dom.vendor.getPrefixedEventType = function(eventType) {<tr><td><a id="l94"></a><a href="#l94">94</a><td>  var prefix = goog.dom.vendor.getVendorJsPrefix() || &#39;&#39;;<tr><td><a id="l95"></a><a href="#l95">95</a><td>  return (prefix + eventType).toLowerCase();<tr><td><a id="l96"></a><a href="#l96">96</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/browserevent.js.src.html b/docs/source/lib/goog/events/browserevent.js.src.html
new file mode 100644
index 0000000..31bc078
--- /dev/null
+++ b/docs/source/lib/goog/events/browserevent.js.src.html
@@ -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>browserevent.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/events/browserevent.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2005 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A patched, standardized event object for browser events.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * &lt;pre&gt;<tr><td><a id="l19"></a><a href="#l19">19</a><td> * The patched event object contains the following members:<tr><td><a id="l20"></a><a href="#l20">20</a><td> * - type           {string}    Event type, e.g. &#39;click&#39;<tr><td><a id="l21"></a><a href="#l21">21</a><td> * - target         {Object}    The element that actually triggered the event<tr><td><a id="l22"></a><a href="#l22">22</a><td> * - currentTarget  {Object}    The element the listener is attached to<tr><td><a id="l23"></a><a href="#l23">23</a><td> * - relatedTarget  {Object}    For mouseover and mouseout, the previous object<tr><td><a id="l24"></a><a href="#l24">24</a><td> * - offsetX        {number}    X-coordinate relative to target<tr><td><a id="l25"></a><a href="#l25">25</a><td> * - offsetY        {number}    Y-coordinate relative to target<tr><td><a id="l26"></a><a href="#l26">26</a><td> * - clientX        {number}    X-coordinate relative to viewport<tr><td><a id="l27"></a><a href="#l27">27</a><td> * - clientY        {number}    Y-coordinate relative to viewport<tr><td><a id="l28"></a><a href="#l28">28</a><td> * - screenX        {number}    X-coordinate relative to the edge of the screen<tr><td><a id="l29"></a><a href="#l29">29</a><td> * - screenY        {number}    Y-coordinate relative to the edge of the screen<tr><td><a id="l30"></a><a href="#l30">30</a><td> * - button         {number}    Mouse button. Use isButton() to test.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * - keyCode        {number}    Key-code<tr><td><a id="l32"></a><a href="#l32">32</a><td> * - ctrlKey        {boolean}   Was ctrl key depressed<tr><td><a id="l33"></a><a href="#l33">33</a><td> * - altKey         {boolean}   Was alt key depressed<tr><td><a id="l34"></a><a href="#l34">34</a><td> * - shiftKey       {boolean}   Was shift key depressed<tr><td><a id="l35"></a><a href="#l35">35</a><td> * - metaKey        {boolean}   Was meta key depressed<tr><td><a id="l36"></a><a href="#l36">36</a><td> * - defaultPrevented {boolean} Whether the default action has been prevented<tr><td><a id="l37"></a><a href="#l37">37</a><td> * - state          {Object}    History state object<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * NOTE: The keyCode member contains the raw browser keyCode. For normalized<tr><td><a id="l40"></a><a href="#l40">40</a><td> * key and character code use {@link goog.events.KeyHandler}.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * &lt;/pre&gt;<tr><td><a id="l42"></a><a href="#l42">42</a><td> *<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.provide(&#39;goog.events.BrowserEvent&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.provide(&#39;goog.events.BrowserEvent.MouseButton&#39;);<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.require(&#39;goog.events.BrowserFeature&#39;);<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.require(&#39;goog.events.Event&#39;);<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.require(&#39;goog.events.EventType&#39;);<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.require(&#39;goog.reflect&#39;);<tr><td><a id="l53"></a><a href="#l53">53</a><td>goog.require(&#39;goog.userAgent&#39;);<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>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * Accepts a browser event object and creates a patched, cross browser event<tr><td><a id="l59"></a><a href="#l59">59</a><td> * object.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * The content of this object will not be initialized if no event object is<tr><td><a id="l61"></a><a href="#l61">61</a><td> * provided. If this is the case, init() needs to be invoked separately.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {Event=} opt_e Browser event object.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {EventTarget=} opt_currentTarget Current target for event.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @constructor<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @extends {goog.events.Event}<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.events.BrowserEvent = function(opt_e, opt_currentTarget) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  goog.events.BrowserEvent.base(this, &#39;constructor&#39;, opt_e ? opt_e.type : &#39;&#39;);<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>  /**<tr><td><a id="l71"></a><a href="#l71">71</a><td>   * Target that fired the event.<tr><td><a id="l72"></a><a href="#l72">72</a><td>   * @override<tr><td><a id="l73"></a><a href="#l73">73</a><td>   * @type {Node}<tr><td><a id="l74"></a><a href="#l74">74</a><td>   */<tr><td><a id="l75"></a><a href="#l75">75</a><td>  this.target = null;<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>  /**<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * Node that had the listener attached.<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * @override<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * @type {Node|undefined}<tr><td><a id="l81"></a><a href="#l81">81</a><td>   */<tr><td><a id="l82"></a><a href="#l82">82</a><td>  this.currentTarget = null;<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>   * For mouseover and mouseout events, the related object for the event.<tr><td><a id="l86"></a><a href="#l86">86</a><td>   * @type {Node}<tr><td><a id="l87"></a><a href="#l87">87</a><td>   */<tr><td><a id="l88"></a><a href="#l88">88</a><td>  this.relatedTarget = null;<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>   * X-coordinate relative to target.<tr><td><a id="l92"></a><a href="#l92">92</a><td>   * @type {number}<tr><td><a id="l93"></a><a href="#l93">93</a><td>   */<tr><td><a id="l94"></a><a href="#l94">94</a><td>  this.offsetX = 0;<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>  /**<tr><td><a id="l97"></a><a href="#l97">97</a><td>   * Y-coordinate relative to target.<tr><td><a id="l98"></a><a href="#l98">98</a><td>   * @type {number}<tr><td><a id="l99"></a><a href="#l99">99</a><td>   */<tr><td><a id="l100"></a><a href="#l100">100</a><td>  this.offsetY = 0;<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>   * X-coordinate relative to the window.<tr><td><a id="l104"></a><a href="#l104">104</a><td>   * @type {number}<tr><td><a id="l105"></a><a href="#l105">105</a><td>   */<tr><td><a id="l106"></a><a href="#l106">106</a><td>  this.clientX = 0;<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>   * Y-coordinate relative to the window.<tr><td><a id="l110"></a><a href="#l110">110</a><td>   * @type {number}<tr><td><a id="l111"></a><a href="#l111">111</a><td>   */<tr><td><a id="l112"></a><a href="#l112">112</a><td>  this.clientY = 0;<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>   * X-coordinate relative to the monitor.<tr><td><a id="l116"></a><a href="#l116">116</a><td>   * @type {number}<tr><td><a id="l117"></a><a href="#l117">117</a><td>   */<tr><td><a id="l118"></a><a href="#l118">118</a><td>  this.screenX = 0;<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>   * Y-coordinate relative to the monitor.<tr><td><a id="l122"></a><a href="#l122">122</a><td>   * @type {number}<tr><td><a id="l123"></a><a href="#l123">123</a><td>   */<tr><td><a id="l124"></a><a href="#l124">124</a><td>  this.screenY = 0;<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>   * Which mouse button was pressed.<tr><td><a id="l128"></a><a href="#l128">128</a><td>   * @type {number}<tr><td><a id="l129"></a><a href="#l129">129</a><td>   */<tr><td><a id="l130"></a><a href="#l130">130</a><td>  this.button = 0;<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>  /**<tr><td><a id="l133"></a><a href="#l133">133</a><td>   * Keycode of key press.<tr><td><a id="l134"></a><a href="#l134">134</a><td>   * @type {number}<tr><td><a id="l135"></a><a href="#l135">135</a><td>   */<tr><td><a id="l136"></a><a href="#l136">136</a><td>  this.keyCode = 0;<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>   * Keycode of key press.<tr><td><a id="l140"></a><a href="#l140">140</a><td>   * @type {number}<tr><td><a id="l141"></a><a href="#l141">141</a><td>   */<tr><td><a id="l142"></a><a href="#l142">142</a><td>  this.charCode = 0;<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>   * Whether control was pressed at time of event.<tr><td><a id="l146"></a><a href="#l146">146</a><td>   * @type {boolean}<tr><td><a id="l147"></a><a href="#l147">147</a><td>   */<tr><td><a id="l148"></a><a href="#l148">148</a><td>  this.ctrlKey = false;<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>  /**<tr><td><a id="l151"></a><a href="#l151">151</a><td>   * Whether alt was pressed at time of event.<tr><td><a id="l152"></a><a href="#l152">152</a><td>   * @type {boolean}<tr><td><a id="l153"></a><a href="#l153">153</a><td>   */<tr><td><a id="l154"></a><a href="#l154">154</a><td>  this.altKey = false;<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>   * Whether shift was pressed at time of event.<tr><td><a id="l158"></a><a href="#l158">158</a><td>   * @type {boolean}<tr><td><a id="l159"></a><a href="#l159">159</a><td>   */<tr><td><a id="l160"></a><a href="#l160">160</a><td>  this.shiftKey = false;<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>  /**<tr><td><a id="l163"></a><a href="#l163">163</a><td>   * Whether the meta key was pressed at time of event.<tr><td><a id="l164"></a><a href="#l164">164</a><td>   * @type {boolean}<tr><td><a id="l165"></a><a href="#l165">165</a><td>   */<tr><td><a id="l166"></a><a href="#l166">166</a><td>  this.metaKey = false;<tr><td><a id="l167"></a><a href="#l167">167</a><td><tr><td><a id="l168"></a><a href="#l168">168</a><td>  /**<tr><td><a id="l169"></a><a href="#l169">169</a><td>   * History state object, only set for PopState events where it&#39;s a copy of the<tr><td><a id="l170"></a><a href="#l170">170</a><td>   * state object provided to pushState or replaceState.<tr><td><a id="l171"></a><a href="#l171">171</a><td>   * @type {Object}<tr><td><a id="l172"></a><a href="#l172">172</a><td>   */<tr><td><a id="l173"></a><a href="#l173">173</a><td>  this.state = null;<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>  /**<tr><td><a id="l176"></a><a href="#l176">176</a><td>   * Whether the default platform modifier key was pressed at time of event.<tr><td><a id="l177"></a><a href="#l177">177</a><td>   * (This is control for all platforms except Mac, where it&#39;s Meta.)<tr><td><a id="l178"></a><a href="#l178">178</a><td>   * @type {boolean}<tr><td><a id="l179"></a><a href="#l179">179</a><td>   */<tr><td><a id="l180"></a><a href="#l180">180</a><td>  this.platformModifierKey = false;<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td>  /**<tr><td><a id="l183"></a><a href="#l183">183</a><td>   * The browser event object.<tr><td><a id="l184"></a><a href="#l184">184</a><td>   * @private {Event}<tr><td><a id="l185"></a><a href="#l185">185</a><td>   */<tr><td><a id="l186"></a><a href="#l186">186</a><td>  this.event_ = null;<tr><td><a id="l187"></a><a href="#l187">187</a><td><tr><td><a id="l188"></a><a href="#l188">188</a><td>  if (opt_e) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>    this.init(opt_e, opt_currentTarget);<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>goog.inherits(goog.events.BrowserEvent, goog.events.Event);<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>/**<tr><td><a id="l196"></a><a href="#l196">196</a><td> * Normalized button constants for the mouse.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @enum {number}<tr><td><a id="l198"></a><a href="#l198">198</a><td> */<tr><td><a id="l199"></a><a href="#l199">199</a><td>goog.events.BrowserEvent.MouseButton = {<tr><td><a id="l200"></a><a href="#l200">200</a><td>  LEFT: 0,<tr><td><a id="l201"></a><a href="#l201">201</a><td>  MIDDLE: 1,<tr><td><a id="l202"></a><a href="#l202">202</a><td>  RIGHT: 2<tr><td><a id="l203"></a><a href="#l203">203</a><td>};<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * Static data for mapping mouse buttons.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @type {!Array&lt;number&gt;}<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>goog.events.BrowserEvent.IEButtonMap = [<tr><td><a id="l211"></a><a href="#l211">211</a><td>  1, // LEFT<tr><td><a id="l212"></a><a href="#l212">212</a><td>  4, // MIDDLE<tr><td><a id="l213"></a><a href="#l213">213</a><td>  2  // RIGHT<tr><td><a id="l214"></a><a href="#l214">214</a><td>];<tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td><tr><td><a id="l217"></a><a href="#l217">217</a><td>/**<tr><td><a id="l218"></a><a href="#l218">218</a><td> * Accepts a browser event object and creates a patched, cross browser event<tr><td><a id="l219"></a><a href="#l219">219</a><td> * object.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @param {Event} e Browser event object.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {EventTarget=} opt_currentTarget Current target for event.<tr><td><a id="l222"></a><a href="#l222">222</a><td> */<tr><td><a id="l223"></a><a href="#l223">223</a><td>goog.events.BrowserEvent.prototype.init = function(e, opt_currentTarget) {<tr><td><a id="l224"></a><a href="#l224">224</a><td>  var type = this.type = e.type;<tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>  /**<tr><td><a id="l227"></a><a href="#l227">227</a><td>   * On touch devices use the first &quot;changed touch&quot; as the relevant touch.<tr><td><a id="l228"></a><a href="#l228">228</a><td>   * @type {Touch}<tr><td><a id="l229"></a><a href="#l229">229</a><td>   */<tr><td><a id="l230"></a><a href="#l230">230</a><td>  var relevantTouch = e.changedTouches ? e.changedTouches[0] : null;<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td>  // TODO(nicksantos): Change this.target to type EventTarget.<tr><td><a id="l233"></a><a href="#l233">233</a><td>  this.target = /** @type {Node} */ (e.target) || e.srcElement;<tr><td><a id="l234"></a><a href="#l234">234</a><td><tr><td><a id="l235"></a><a href="#l235">235</a><td>  // TODO(nicksantos): Change this.currentTarget to type EventTarget.<tr><td><a id="l236"></a><a href="#l236">236</a><td>  this.currentTarget = /** @type {Node} */ (opt_currentTarget);<tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>  var relatedTarget = /** @type {Node} */ (e.relatedTarget);<tr><td><a id="l239"></a><a href="#l239">239</a><td>  if (relatedTarget) {<tr><td><a id="l240"></a><a href="#l240">240</a><td>    // There&#39;s a bug in FireFox where sometimes, relatedTarget will be a<tr><td><a id="l241"></a><a href="#l241">241</a><td>    // chrome element, and accessing any property of it will get a permission<tr><td><a id="l242"></a><a href="#l242">242</a><td>    // denied exception. See:<tr><td><a id="l243"></a><a href="#l243">243</a><td>    // https://bugzilla.mozilla.org/show_bug.cgi?id=497780<tr><td><a id="l244"></a><a href="#l244">244</a><td>    if (goog.userAgent.GECKO) {<tr><td><a id="l245"></a><a href="#l245">245</a><td>      if (!goog.reflect.canAccessProperty(relatedTarget, &#39;nodeName&#39;)) {<tr><td><a id="l246"></a><a href="#l246">246</a><td>        relatedTarget = null;<tr><td><a id="l247"></a><a href="#l247">247</a><td>      }<tr><td><a id="l248"></a><a href="#l248">248</a><td>    }<tr><td><a id="l249"></a><a href="#l249">249</a><td>    // TODO(arv): Use goog.events.EventType when it has been refactored into its<tr><td><a id="l250"></a><a href="#l250">250</a><td>    // own file.<tr><td><a id="l251"></a><a href="#l251">251</a><td>  } else if (type == goog.events.EventType.MOUSEOVER) {<tr><td><a id="l252"></a><a href="#l252">252</a><td>    relatedTarget = e.fromElement;<tr><td><a id="l253"></a><a href="#l253">253</a><td>  } else if (type == goog.events.EventType.MOUSEOUT) {<tr><td><a id="l254"></a><a href="#l254">254</a><td>    relatedTarget = e.toElement;<tr><td><a id="l255"></a><a href="#l255">255</a><td>  }<tr><td><a id="l256"></a><a href="#l256">256</a><td><tr><td><a id="l257"></a><a href="#l257">257</a><td>  this.relatedTarget = relatedTarget;<tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td>  if (!goog.isNull(relevantTouch)) {<tr><td><a id="l260"></a><a href="#l260">260</a><td>    this.clientX = relevantTouch.clientX !== undefined ?<tr><td><a id="l261"></a><a href="#l261">261</a><td>        relevantTouch.clientX : relevantTouch.pageX;<tr><td><a id="l262"></a><a href="#l262">262</a><td>    this.clientY = relevantTouch.clientY !== undefined ?<tr><td><a id="l263"></a><a href="#l263">263</a><td>        relevantTouch.clientY : relevantTouch.pageY;<tr><td><a id="l264"></a><a href="#l264">264</a><td>    this.screenX = relevantTouch.screenX || 0;<tr><td><a id="l265"></a><a href="#l265">265</a><td>    this.screenY = relevantTouch.screenY || 0;<tr><td><a id="l266"></a><a href="#l266">266</a><td>  } else {<tr><td><a id="l267"></a><a href="#l267">267</a><td>    // Webkit emits a lame warning whenever layerX/layerY is accessed.<tr><td><a id="l268"></a><a href="#l268">268</a><td>    // http://code.google.com/p/chromium/issues/detail?id=101733<tr><td><a id="l269"></a><a href="#l269">269</a><td>    this.offsetX = (goog.userAgent.WEBKIT || e.offsetX !== undefined) ?<tr><td><a id="l270"></a><a href="#l270">270</a><td>        e.offsetX : e.layerX;<tr><td><a id="l271"></a><a href="#l271">271</a><td>    this.offsetY = (goog.userAgent.WEBKIT || e.offsetY !== undefined) ?<tr><td><a id="l272"></a><a href="#l272">272</a><td>        e.offsetY : e.layerY;<tr><td><a id="l273"></a><a href="#l273">273</a><td>    this.clientX = e.clientX !== undefined ? e.clientX : e.pageX;<tr><td><a id="l274"></a><a href="#l274">274</a><td>    this.clientY = e.clientY !== undefined ? e.clientY : e.pageY;<tr><td><a id="l275"></a><a href="#l275">275</a><td>    this.screenX = e.screenX || 0;<tr><td><a id="l276"></a><a href="#l276">276</a><td>    this.screenY = e.screenY || 0;<tr><td><a id="l277"></a><a href="#l277">277</a><td>  }<tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td>  this.button = e.button;<tr><td><a id="l280"></a><a href="#l280">280</a><td><tr><td><a id="l281"></a><a href="#l281">281</a><td>  this.keyCode = e.keyCode || 0;<tr><td><a id="l282"></a><a href="#l282">282</a><td>  this.charCode = e.charCode || (type == &#39;keypress&#39; ? e.keyCode : 0);<tr><td><a id="l283"></a><a href="#l283">283</a><td>  this.ctrlKey = e.ctrlKey;<tr><td><a id="l284"></a><a href="#l284">284</a><td>  this.altKey = e.altKey;<tr><td><a id="l285"></a><a href="#l285">285</a><td>  this.shiftKey = e.shiftKey;<tr><td><a id="l286"></a><a href="#l286">286</a><td>  this.metaKey = e.metaKey;<tr><td><a id="l287"></a><a href="#l287">287</a><td>  this.platformModifierKey = goog.userAgent.MAC ? e.metaKey : e.ctrlKey;<tr><td><a id="l288"></a><a href="#l288">288</a><td>  this.state = e.state;<tr><td><a id="l289"></a><a href="#l289">289</a><td>  this.event_ = e;<tr><td><a id="l290"></a><a href="#l290">290</a><td>  if (e.defaultPrevented) {<tr><td><a id="l291"></a><a href="#l291">291</a><td>    this.preventDefault();<tr><td><a id="l292"></a><a href="#l292">292</a><td>  }<tr><td><a id="l293"></a><a href="#l293">293</a><td>};<tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td><tr><td><a id="l296"></a><a href="#l296">296</a><td>/**<tr><td><a id="l297"></a><a href="#l297">297</a><td> * Tests to see which button was pressed during the event. This is really only<tr><td><a id="l298"></a><a href="#l298">298</a><td> * useful in IE and Gecko browsers. And in IE, it&#39;s only useful for<tr><td><a id="l299"></a><a href="#l299">299</a><td> * mousedown/mouseup events, because click only fires for the left mouse button.<tr><td><a id="l300"></a><a href="#l300">300</a><td> *<tr><td><a id="l301"></a><a href="#l301">301</a><td> * Safari 2 only reports the left button being clicked, and uses the value &#39;1&#39;<tr><td><a id="l302"></a><a href="#l302">302</a><td> * instead of 0. Opera only reports a mousedown event for the middle button, and<tr><td><a id="l303"></a><a href="#l303">303</a><td> * no mouse events for the right button. Opera has default behavior for left and<tr><td><a id="l304"></a><a href="#l304">304</a><td> * middle click that can only be overridden via a configuration setting.<tr><td><a id="l305"></a><a href="#l305">305</a><td> *<tr><td><a id="l306"></a><a href="#l306">306</a><td> * There&#39;s a nice table of this mess at http://www.unixpapa.com/js/mouse.html.<tr><td><a id="l307"></a><a href="#l307">307</a><td> *<tr><td><a id="l308"></a><a href="#l308">308</a><td> * @param {goog.events.BrowserEvent.MouseButton} button The button<tr><td><a id="l309"></a><a href="#l309">309</a><td> *     to test for.<tr><td><a id="l310"></a><a href="#l310">310</a><td> * @return {boolean} True if button was pressed.<tr><td><a id="l311"></a><a href="#l311">311</a><td> */<tr><td><a id="l312"></a><a href="#l312">312</a><td>goog.events.BrowserEvent.prototype.isButton = function(button) {<tr><td><a id="l313"></a><a href="#l313">313</a><td>  if (!goog.events.BrowserFeature.HAS_W3C_BUTTON) {<tr><td><a id="l314"></a><a href="#l314">314</a><td>    if (this.type == &#39;click&#39;) {<tr><td><a id="l315"></a><a href="#l315">315</a><td>      return button == goog.events.BrowserEvent.MouseButton.LEFT;<tr><td><a id="l316"></a><a href="#l316">316</a><td>    } else {<tr><td><a id="l317"></a><a href="#l317">317</a><td>      return !!(this.event_.button &amp;<tr><td><a id="l318"></a><a href="#l318">318</a><td>          goog.events.BrowserEvent.IEButtonMap[button]);<tr><td><a id="l319"></a><a href="#l319">319</a><td>    }<tr><td><a id="l320"></a><a href="#l320">320</a><td>  } else {<tr><td><a id="l321"></a><a href="#l321">321</a><td>    return this.event_.button == button;<tr><td><a id="l322"></a><a href="#l322">322</a><td>  }<tr><td><a id="l323"></a><a href="#l323">323</a><td>};<tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td><tr><td><a id="l326"></a><a href="#l326">326</a><td>/**<tr><td><a id="l327"></a><a href="#l327">327</a><td> * Whether this has an &quot;action&quot;-producing mouse button.<tr><td><a id="l328"></a><a href="#l328">328</a><td> *<tr><td><a id="l329"></a><a href="#l329">329</a><td> * By definition, this includes left-click on windows/linux, and left-click<tr><td><a id="l330"></a><a href="#l330">330</a><td> * without the ctrl key on Macs.<tr><td><a id="l331"></a><a href="#l331">331</a><td> *<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @return {boolean} The result.<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>goog.events.BrowserEvent.prototype.isMouseActionButton = function() {<tr><td><a id="l335"></a><a href="#l335">335</a><td>  // Webkit does not ctrl+click to be a right-click, so we<tr><td><a id="l336"></a><a href="#l336">336</a><td>  // normalize it to behave like Gecko and Opera.<tr><td><a id="l337"></a><a href="#l337">337</a><td>  return this.isButton(goog.events.BrowserEvent.MouseButton.LEFT) &amp;&amp;<tr><td><a id="l338"></a><a href="#l338">338</a><td>      !(goog.userAgent.WEBKIT &amp;&amp; goog.userAgent.MAC &amp;&amp; this.ctrlKey);<tr><td><a id="l339"></a><a href="#l339">339</a><td>};<tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td><tr><td><a id="l342"></a><a href="#l342">342</a><td>/**<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @override<tr><td><a id="l344"></a><a href="#l344">344</a><td> */<tr><td><a id="l345"></a><a href="#l345">345</a><td>goog.events.BrowserEvent.prototype.stopPropagation = function() {<tr><td><a id="l346"></a><a href="#l346">346</a><td>  goog.events.BrowserEvent.superClass_.stopPropagation.call(this);<tr><td><a id="l347"></a><a href="#l347">347</a><td>  if (this.event_.stopPropagation) {<tr><td><a id="l348"></a><a href="#l348">348</a><td>    this.event_.stopPropagation();<tr><td><a id="l349"></a><a href="#l349">349</a><td>  } else {<tr><td><a id="l350"></a><a href="#l350">350</a><td>    this.event_.cancelBubble = true;<tr><td><a id="l351"></a><a href="#l351">351</a><td>  }<tr><td><a id="l352"></a><a href="#l352">352</a><td>};<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td><tr><td><a id="l355"></a><a href="#l355">355</a><td>/**<tr><td><a id="l356"></a><a href="#l356">356</a><td> * @override<tr><td><a id="l357"></a><a href="#l357">357</a><td> */<tr><td><a id="l358"></a><a href="#l358">358</a><td>goog.events.BrowserEvent.prototype.preventDefault = function() {<tr><td><a id="l359"></a><a href="#l359">359</a><td>  goog.events.BrowserEvent.superClass_.preventDefault.call(this);<tr><td><a id="l360"></a><a href="#l360">360</a><td>  var be = this.event_;<tr><td><a id="l361"></a><a href="#l361">361</a><td>  if (!be.preventDefault) {<tr><td><a id="l362"></a><a href="#l362">362</a><td>    be.returnValue = false;<tr><td><a id="l363"></a><a href="#l363">363</a><td>    if (goog.events.BrowserFeature.SET_KEY_CODE_TO_PREVENT_DEFAULT) {<tr><td><a id="l364"></a><a href="#l364">364</a><td>      /** @preserveTry */<tr><td><a id="l365"></a><a href="#l365">365</a><td>      try {<tr><td><a id="l366"></a><a href="#l366">366</a><td>        // Most keys can be prevented using returnValue. Some special keys<tr><td><a id="l367"></a><a href="#l367">367</a><td>        // require setting the keyCode to -1 as well:<tr><td><a id="l368"></a><a href="#l368">368</a><td>        //<tr><td><a id="l369"></a><a href="#l369">369</a><td>        // In IE7:<tr><td><a id="l370"></a><a href="#l370">370</a><td>        // F3, F5, F10, F11, Ctrl+P, Crtl+O, Ctrl+F (these are taken from IE6)<tr><td><a id="l371"></a><a href="#l371">371</a><td>        //<tr><td><a id="l372"></a><a href="#l372">372</a><td>        // In IE8:<tr><td><a id="l373"></a><a href="#l373">373</a><td>        // Ctrl+P, Crtl+O, Ctrl+F (F1-F12 cannot be stopped through the event)<tr><td><a id="l374"></a><a href="#l374">374</a><td>        //<tr><td><a id="l375"></a><a href="#l375">375</a><td>        // We therefore do this for all function keys as well as when Ctrl key<tr><td><a id="l376"></a><a href="#l376">376</a><td>        // is pressed.<tr><td><a id="l377"></a><a href="#l377">377</a><td>        var VK_F1 = 112;<tr><td><a id="l378"></a><a href="#l378">378</a><td>        var VK_F12 = 123;<tr><td><a id="l379"></a><a href="#l379">379</a><td>        if (be.ctrlKey || be.keyCode &gt;= VK_F1 &amp;&amp; be.keyCode &lt;= VK_F12) {<tr><td><a id="l380"></a><a href="#l380">380</a><td>          be.keyCode = -1;<tr><td><a id="l381"></a><a href="#l381">381</a><td>        }<tr><td><a id="l382"></a><a href="#l382">382</a><td>      } catch (ex) {<tr><td><a id="l383"></a><a href="#l383">383</a><td>        // IE throws an &#39;access denied&#39; exception when trying to change<tr><td><a id="l384"></a><a href="#l384">384</a><td>        // keyCode in some situations (e.g. srcElement is input[type=file],<tr><td><a id="l385"></a><a href="#l385">385</a><td>        // or srcElement is an anchor tag rewritten by parent&#39;s innerHTML).<tr><td><a id="l386"></a><a href="#l386">386</a><td>        // Do nothing in this case.<tr><td><a id="l387"></a><a href="#l387">387</a><td>      }<tr><td><a id="l388"></a><a href="#l388">388</a><td>    }<tr><td><a id="l389"></a><a href="#l389">389</a><td>  } else {<tr><td><a id="l390"></a><a href="#l390">390</a><td>    be.preventDefault();<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><tr><td><a id="l394"></a><a href="#l394">394</a><td><tr><td><a id="l395"></a><a href="#l395">395</a><td>/**<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @return {Event} The underlying browser event object.<tr><td><a id="l397"></a><a href="#l397">397</a><td> */<tr><td><a id="l398"></a><a href="#l398">398</a><td>goog.events.BrowserEvent.prototype.getBrowserEvent = function() {<tr><td><a id="l399"></a><a href="#l399">399</a><td>  return this.event_;<tr><td><a id="l400"></a><a href="#l400">400</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/browserfeature.js.src.html b/docs/source/lib/goog/events/browserfeature.js.src.html
new file mode 100644
index 0000000..e7faa18
--- /dev/null
+++ b/docs/source/lib/goog/events/browserfeature.js.src.html
@@ -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>browserfeature.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/events/browserfeature.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Browser capability checks for the events package.<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><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.events.BrowserFeature&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.userAgent&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Enum of browser capabilities.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @enum {boolean}<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.events.BrowserFeature = {<tr><td><a id="l31"></a><a href="#l31">31</a><td>  /**<tr><td><a id="l32"></a><a href="#l32">32</a><td>   * Whether the button attribute of the event is W3C compliant.  False in<tr><td><a id="l33"></a><a href="#l33">33</a><td>   * Internet Explorer prior to version 9; document-version dependent.<tr><td><a id="l34"></a><a href="#l34">34</a><td>   */<tr><td><a id="l35"></a><a href="#l35">35</a><td>  HAS_W3C_BUTTON: !goog.userAgent.IE ||<tr><td><a id="l36"></a><a href="#l36">36</a><td>      goog.userAgent.isDocumentModeOrHigher(9),<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>   * Whether the browser supports full W3C event model.<tr><td><a id="l40"></a><a href="#l40">40</a><td>   */<tr><td><a id="l41"></a><a href="#l41">41</a><td>  HAS_W3C_EVENT_SUPPORT: !goog.userAgent.IE ||<tr><td><a id="l42"></a><a href="#l42">42</a><td>      goog.userAgent.isDocumentModeOrHigher(9),<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>   * To prevent default in IE7-8 for certain keydown events we need set the<tr><td><a id="l46"></a><a href="#l46">46</a><td>   * keyCode to -1.<tr><td><a id="l47"></a><a href="#l47">47</a><td>   */<tr><td><a id="l48"></a><a href="#l48">48</a><td>  SET_KEY_CODE_TO_PREVENT_DEFAULT: goog.userAgent.IE &amp;&amp;<tr><td><a id="l49"></a><a href="#l49">49</a><td>      !goog.userAgent.isVersionOrHigher(&#39;9&#39;),<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>   * Whether the {@code navigator.onLine} property is supported.<tr><td><a id="l53"></a><a href="#l53">53</a><td>   */<tr><td><a id="l54"></a><a href="#l54">54</a><td>  HAS_NAVIGATOR_ONLINE_PROPERTY: !goog.userAgent.WEBKIT ||<tr><td><a id="l55"></a><a href="#l55">55</a><td>      goog.userAgent.isVersionOrHigher(&#39;528&#39;),<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>   * Whether HTML5 network online/offline events are supported.<tr><td><a id="l59"></a><a href="#l59">59</a><td>   */<tr><td><a id="l60"></a><a href="#l60">60</a><td>  HAS_HTML5_NETWORK_EVENT_SUPPORT:<tr><td><a id="l61"></a><a href="#l61">61</a><td>      goog.userAgent.GECKO &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;1.9b&#39;) ||<tr><td><a id="l62"></a><a href="#l62">62</a><td>      goog.userAgent.IE &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;8&#39;) ||<tr><td><a id="l63"></a><a href="#l63">63</a><td>      goog.userAgent.OPERA &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;9.5&#39;) ||<tr><td><a id="l64"></a><a href="#l64">64</a><td>      goog.userAgent.WEBKIT &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;528&#39;),<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>   * Whether HTML5 network events fire on document.body, or otherwise the<tr><td><a id="l68"></a><a href="#l68">68</a><td>   * window.<tr><td><a id="l69"></a><a href="#l69">69</a><td>   */<tr><td><a id="l70"></a><a href="#l70">70</a><td>  HTML5_NETWORK_EVENTS_FIRE_ON_BODY:<tr><td><a id="l71"></a><a href="#l71">71</a><td>      goog.userAgent.GECKO &amp;&amp; !goog.userAgent.isVersionOrHigher(&#39;8&#39;) ||<tr><td><a id="l72"></a><a href="#l72">72</a><td>      goog.userAgent.IE &amp;&amp; !goog.userAgent.isVersionOrHigher(&#39;9&#39;),<tr><td><a id="l73"></a><a href="#l73">73</a><td><tr><td><a id="l74"></a><a href="#l74">74</a><td>  /**<tr><td><a id="l75"></a><a href="#l75">75</a><td>   * Whether touch is enabled in the browser.<tr><td><a id="l76"></a><a href="#l76">76</a><td>   */<tr><td><a id="l77"></a><a href="#l77">77</a><td>  TOUCH_ENABLED:<tr><td><a id="l78"></a><a href="#l78">78</a><td>      (&#39;ontouchstart&#39; in goog.global ||<tr><td><a id="l79"></a><a href="#l79">79</a><td>          !!(goog.global[&#39;document&#39;] &amp;&amp;<tr><td><a id="l80"></a><a href="#l80">80</a><td>             document.documentElement &amp;&amp;<tr><td><a id="l81"></a><a href="#l81">81</a><td>             &#39;ontouchstart&#39; in document.documentElement) ||<tr><td><a id="l82"></a><a href="#l82">82</a><td>          // IE10 uses non-standard touch events, so it has a different check.<tr><td><a id="l83"></a><a href="#l83">83</a><td>          !!(goog.global[&#39;navigator&#39;] &amp;&amp;<tr><td><a id="l84"></a><a href="#l84">84</a><td>              goog.global[&#39;navigator&#39;][&#39;msMaxTouchPoints&#39;]))<tr><td><a id="l85"></a><a href="#l85">85</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/event.js.src.html b/docs/source/lib/goog/events/event.js.src.html
new file mode 100644
index 0000000..23bb1d5
--- /dev/null
+++ b/docs/source/lib/goog/events/event.js.src.html
@@ -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>event.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/events/event.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2005 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A base class for event objects.<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><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.events.Event&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.events.EventLike&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>/**<tr><td><a id="l25"></a><a href="#l25">25</a><td> * goog.events.Event no longer depends on goog.Disposable. Keep requiring<tr><td><a id="l26"></a><a href="#l26">26</a><td> * goog.Disposable here to not break projects which assume this dependency.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @suppress {extraRequire}<tr><td><a id="l28"></a><a href="#l28">28</a><td> */<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.Disposable&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.events.EventId&#39;);<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>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * A typedef for event like objects that are dispatchable via the<tr><td><a id="l35"></a><a href="#l35">35</a><td> * goog.events.dispatchEvent function. strings are treated as the type for a<tr><td><a id="l36"></a><a href="#l36">36</a><td> * goog.events.Event. Objects are treated as an extension of a new<tr><td><a id="l37"></a><a href="#l37">37</a><td> * goog.events.Event with the type property of the object being used as the type<tr><td><a id="l38"></a><a href="#l38">38</a><td> * of the Event.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @typedef {string|Object|goog.events.Event|goog.events.EventId}<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.events.EventLike;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * A base class for event objects, so that they can support preventDefault and<tr><td><a id="l47"></a><a href="#l47">47</a><td> * stopPropagation.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @param {string|!goog.events.EventId} type Event Type.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @param {Object=} opt_target Reference to the object that is the target of<tr><td><a id="l51"></a><a href="#l51">51</a><td> *     this event. It has to implement the {@code EventTarget} interface<tr><td><a id="l52"></a><a href="#l52">52</a><td> *     declared at {@link http://developer.mozilla.org/en/DOM/EventTarget}.<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @constructor<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.events.Event = function(type, opt_target) {<tr><td><a id="l56"></a><a href="#l56">56</a><td>  /**<tr><td><a id="l57"></a><a href="#l57">57</a><td>   * Event type.<tr><td><a id="l58"></a><a href="#l58">58</a><td>   * @type {string}<tr><td><a id="l59"></a><a href="#l59">59</a><td>   */<tr><td><a id="l60"></a><a href="#l60">60</a><td>  this.type = type instanceof goog.events.EventId ? String(type) : type;<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>   * TODO(tbreisacher): The type should probably be<tr><td><a id="l64"></a><a href="#l64">64</a><td>   * EventTarget|goog.events.EventTarget.<tr><td><a id="l65"></a><a href="#l65">65</a><td>   *<tr><td><a id="l66"></a><a href="#l66">66</a><td>   * Target of the event.<tr><td><a id="l67"></a><a href="#l67">67</a><td>   * @type {Object|undefined}<tr><td><a id="l68"></a><a href="#l68">68</a><td>   */<tr><td><a id="l69"></a><a href="#l69">69</a><td>  this.target = opt_target;<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>   * Object that had the listener attached.<tr><td><a id="l73"></a><a href="#l73">73</a><td>   * @type {Object|undefined}<tr><td><a id="l74"></a><a href="#l74">74</a><td>   */<tr><td><a id="l75"></a><a href="#l75">75</a><td>  this.currentTarget = this.target;<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>  /**<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * Whether to cancel the event in internal capture/bubble processing for IE.<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * @type {boolean}<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * @public<tr><td><a id="l81"></a><a href="#l81">81</a><td>   * @suppress {underscore|visibility} Technically public, but referencing this<tr><td><a id="l82"></a><a href="#l82">82</a><td>   *     outside this package is strongly discouraged.<tr><td><a id="l83"></a><a href="#l83">83</a><td>   */<tr><td><a id="l84"></a><a href="#l84">84</a><td>  this.propagationStopped_ = false;<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>   * Whether the default action has been prevented.<tr><td><a id="l88"></a><a href="#l88">88</a><td>   * This is a property to match the W3C specification at<tr><td><a id="l89"></a><a href="#l89">89</a><td>   * {@link http://www.w3.org/TR/DOM-Level-3-Events/<tr><td><a id="l90"></a><a href="#l90">90</a><td>   * #events-event-type-defaultPrevented}.<tr><td><a id="l91"></a><a href="#l91">91</a><td>   * Must be treated as read-only outside the class.<tr><td><a id="l92"></a><a href="#l92">92</a><td>   * @type {boolean}<tr><td><a id="l93"></a><a href="#l93">93</a><td>   */<tr><td><a id="l94"></a><a href="#l94">94</a><td>  this.defaultPrevented = false;<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>  /**<tr><td><a id="l97"></a><a href="#l97">97</a><td>   * Return value for in internal capture/bubble processing for IE.<tr><td><a id="l98"></a><a href="#l98">98</a><td>   * @type {boolean}<tr><td><a id="l99"></a><a href="#l99">99</a><td>   * @public<tr><td><a id="l100"></a><a href="#l100">100</a><td>   * @suppress {underscore|visibility} Technically public, but referencing this<tr><td><a id="l101"></a><a href="#l101">101</a><td>   *     outside this package is strongly discouraged.<tr><td><a id="l102"></a><a href="#l102">102</a><td>   */<tr><td><a id="l103"></a><a href="#l103">103</a><td>  this.returnValue_ = true;<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><tr><td><a id="l107"></a><a href="#l107">107</a><td>/**<tr><td><a id="l108"></a><a href="#l108">108</a><td> * Stops event propagation.<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.events.Event.prototype.stopPropagation = function() {<tr><td><a id="l111"></a><a href="#l111">111</a><td>  this.propagationStopped_ = true;<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>/**<tr><td><a id="l116"></a><a href="#l116">116</a><td> * Prevents the default action, for example a link redirecting to a url.<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.events.Event.prototype.preventDefault = function() {<tr><td><a id="l119"></a><a href="#l119">119</a><td>  this.defaultPrevented = true;<tr><td><a id="l120"></a><a href="#l120">120</a><td>  this.returnValue_ = false;<tr><td><a id="l121"></a><a href="#l121">121</a><td>};<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>/**<tr><td><a id="l125"></a><a href="#l125">125</a><td> * Stops the propagation of the event. It is equivalent to<tr><td><a id="l126"></a><a href="#l126">126</a><td> * {@code e.stopPropagation()}, but can be used as the callback argument of<tr><td><a id="l127"></a><a href="#l127">127</a><td> * {@link goog.events.listen} without declaring another function.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {!goog.events.Event} e An event.<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.events.Event.stopPropagation = function(e) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>  e.stopPropagation();<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> * Prevents the default action. It is equivalent to<tr><td><a id="l137"></a><a href="#l137">137</a><td> * {@code e.preventDefault()}, but can be used as the callback argument of<tr><td><a id="l138"></a><a href="#l138">138</a><td> * {@link goog.events.listen} without declaring another function.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {!goog.events.Event} e An event.<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.events.Event.preventDefault = function(e) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  e.preventDefault();<tr><td><a id="l143"></a><a href="#l143">143</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/eventid.js.src.html b/docs/source/lib/goog/events/eventid.js.src.html
new file mode 100644
index 0000000..b6ed918
--- /dev/null
+++ b/docs/source/lib/goog/events/eventid.js.src.html
@@ -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>eventid.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/events/eventid.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.events.EventId&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * A templated class that is used when registering for events. Typical usage:<tr><td><a id="l21"></a><a href="#l21">21</a><td> * &lt;code&gt;<tr><td><a id="l22"></a><a href="#l22">22</a><td> *   /** @type {goog.events.EventId&lt;MyEventObj&gt;}<tr><td><a id="l23"></a><a href="#l23">23</a><td> *   var myEventId = new goog.events.EventId(<tr><td><a id="l24"></a><a href="#l24">24</a><td> *       goog.events.getUniqueId((&#39;someEvent&#39;));<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> *   // No need to cast or declare here since the compiler knows the correct<tr><td><a id="l27"></a><a href="#l27">27</a><td> *   // type of &#39;evt&#39; (MyEventObj).<tr><td><a id="l28"></a><a href="#l28">28</a><td> *   something.listen(myEventId, function(evt) {});<tr><td><a id="l29"></a><a href="#l29">29</a><td> * &lt;/code&gt;<tr><td><a id="l30"></a><a href="#l30">30</a><td> *<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @param {string} eventId<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @template T<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @constructor<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @struct<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @final<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.events.EventId = function(eventId) {<tr><td><a id="l38"></a><a href="#l38">38</a><td>  /** @const */ this.id = eventId;<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>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @override<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.events.EventId.prototype.toString = function() {<tr><td><a id="l46"></a><a href="#l46">46</a><td>  return this.id;<tr><td><a id="l47"></a><a href="#l47">47</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/events.js.src.html b/docs/source/lib/goog/events/events.js.src.html
new file mode 100644
index 0000000..37c66b6
--- /dev/null
+++ b/docs/source/lib/goog/events/events.js.src.html
@@ -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>events.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/events/events.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2005 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview An event manager for both native browser event<tr><td><a id="l17"></a><a href="#l17">17</a><td> * targets and custom JavaScript event targets<tr><td><a id="l18"></a><a href="#l18">18</a><td> * ({@code goog.events.Listenable}). This provides an abstraction<tr><td><a id="l19"></a><a href="#l19">19</a><td> * over browsers&#39; event systems.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * It also provides a simulation of W3C event model&#39;s capture phase in<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Internet Explorer (IE 8 and below). Caveat: the simulation does not<tr><td><a id="l23"></a><a href="#l23">23</a><td> * interact well with listeners registered directly on the elements<tr><td><a id="l24"></a><a href="#l24">24</a><td> * (bypassing goog.events) or even with listeners registered via<tr><td><a id="l25"></a><a href="#l25">25</a><td> * goog.events in a separate JS binary. In these cases, we provide<tr><td><a id="l26"></a><a href="#l26">26</a><td> * no ordering guarantees.<tr><td><a id="l27"></a><a href="#l27">27</a><td> *<tr><td><a id="l28"></a><a href="#l28">28</a><td> * The listeners will receive a &quot;patched&quot; event object. Such event object<tr><td><a id="l29"></a><a href="#l29">29</a><td> * contains normalized values for certain event properties that differs in<tr><td><a id="l30"></a><a href="#l30">30</a><td> * different browsers.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * Example usage:<tr><td><a id="l33"></a><a href="#l33">33</a><td> * &lt;pre&gt;<tr><td><a id="l34"></a><a href="#l34">34</a><td> * goog.events.listen(myNode, &#39;click&#39;, function(e) { alert(&#39;woo&#39;) });<tr><td><a id="l35"></a><a href="#l35">35</a><td> * goog.events.listen(myNode, &#39;mouseover&#39;, mouseHandler, true);<tr><td><a id="l36"></a><a href="#l36">36</a><td> * goog.events.unlisten(myNode, &#39;mouseover&#39;, mouseHandler, true);<tr><td><a id="l37"></a><a href="#l37">37</a><td> * goog.events.removeAll(myNode);<tr><td><a id="l38"></a><a href="#l38">38</a><td> * &lt;/pre&gt;<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> *                                            in IE and event object patching]<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l42"></a><a href="#l42">42</a><td> *<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @see ../demos/events.html<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @see ../demos/event-propagation.html<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @see ../demos/stopevent.html<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>// IMPLEMENTATION NOTES:<tr><td><a id="l49"></a><a href="#l49">49</a><td>// goog.events stores an auxiliary data structure on each EventTarget<tr><td><a id="l50"></a><a href="#l50">50</a><td>// source being listened on. This allows us to take advantage of GC,<tr><td><a id="l51"></a><a href="#l51">51</a><td>// having the data structure GC&#39;d when the EventTarget is GC&#39;d. This<tr><td><a id="l52"></a><a href="#l52">52</a><td>// GC behavior is equivalent to using W3C DOM Events directly.<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.provide(&#39;goog.events&#39;);<tr><td><a id="l55"></a><a href="#l55">55</a><td>goog.provide(&#39;goog.events.CaptureSimulationMode&#39;);<tr><td><a id="l56"></a><a href="#l56">56</a><td>goog.provide(&#39;goog.events.Key&#39;);<tr><td><a id="l57"></a><a href="#l57">57</a><td>goog.provide(&#39;goog.events.ListenableType&#39;);<tr><td><a id="l58"></a><a href="#l58">58</a><td><tr><td><a id="l59"></a><a href="#l59">59</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l60"></a><a href="#l60">60</a><td>goog.require(&#39;goog.debug.entryPointRegistry&#39;);<tr><td><a id="l61"></a><a href="#l61">61</a><td>goog.require(&#39;goog.events.BrowserEvent&#39;);<tr><td><a id="l62"></a><a href="#l62">62</a><td>goog.require(&#39;goog.events.BrowserFeature&#39;);<tr><td><a id="l63"></a><a href="#l63">63</a><td>goog.require(&#39;goog.events.Listenable&#39;);<tr><td><a id="l64"></a><a href="#l64">64</a><td>goog.require(&#39;goog.events.ListenerMap&#39;);<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td>goog.forwardDeclare(&#39;goog.debug.ErrorHandler&#39;);<tr><td><a id="l67"></a><a href="#l67">67</a><td>goog.forwardDeclare(&#39;goog.events.EventWrapper&#39;);<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>/**<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @typedef {number|goog.events.ListenableKey}<tr><td><a id="l72"></a><a href="#l72">72</a><td> */<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.events.Key;<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @typedef {EventTarget|goog.events.Listenable}<tr><td><a id="l78"></a><a href="#l78">78</a><td> */<tr><td><a id="l79"></a><a href="#l79">79</a><td>goog.events.ListenableType;<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Property name on a native event target for the listener map<tr><td><a id="l84"></a><a href="#l84">84</a><td> * associated with the event target.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @private @const {string}<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.events.LISTENER_MAP_PROP_ = &#39;closure_lm_&#39; + ((Math.random() * 1e6) | 0);<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> * String used to prepend to IE event types.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @const<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @private<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.events.onString_ = &#39;on&#39;;<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> * Map of computed &quot;on&lt;eventname&gt;&quot; strings for IE event types. Caching<tr><td><a id="l100"></a><a href="#l100">100</a><td> * this removes an extra object allocation in goog.events.listen which<tr><td><a id="l101"></a><a href="#l101">101</a><td> * improves IE6 performance.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @const<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @dict<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @private<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.events.onStringMap_ = {};<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> * @enum {number} Different capture simulation mode for IE8-.<tr><td><a id="l111"></a><a href="#l111">111</a><td> */<tr><td><a id="l112"></a><a href="#l112">112</a><td>goog.events.CaptureSimulationMode = {<tr><td><a id="l113"></a><a href="#l113">113</a><td>  /**<tr><td><a id="l114"></a><a href="#l114">114</a><td>   * Does not perform capture simulation. Will asserts in IE8- when you<tr><td><a id="l115"></a><a href="#l115">115</a><td>   * add capture listeners.<tr><td><a id="l116"></a><a href="#l116">116</a><td>   */<tr><td><a id="l117"></a><a href="#l117">117</a><td>  OFF_AND_FAIL: 0,<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>   * Does not perform capture simulation, silently ignore capture<tr><td><a id="l121"></a><a href="#l121">121</a><td>   * listeners.<tr><td><a id="l122"></a><a href="#l122">122</a><td>   */<tr><td><a id="l123"></a><a href="#l123">123</a><td>  OFF_AND_SILENT: 1,<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>   * Performs capture simulation.<tr><td><a id="l127"></a><a href="#l127">127</a><td>   */<tr><td><a id="l128"></a><a href="#l128">128</a><td>  ON: 2<tr><td><a id="l129"></a><a href="#l129">129</a><td>};<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @define {number} The capture simulation mode for IE8-. By default,<tr><td><a id="l134"></a><a href="#l134">134</a><td> *     this is ON.<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td>goog.define(&#39;goog.events.CAPTURE_SIMULATION_MODE&#39;, 2);<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * Estimated count of total native listeners.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @private {number}<tr><td><a id="l142"></a><a href="#l142">142</a><td> */<tr><td><a id="l143"></a><a href="#l143">143</a><td>goog.events.listenerCountEstimate_ = 0;<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> * Adds an event listener for a specific event on a native event<tr><td><a id="l148"></a><a href="#l148">148</a><td> * target (such as a DOM element) or an object that has implemented<tr><td><a id="l149"></a><a href="#l149">149</a><td> * {@link goog.events.Listenable}. A listener can only be added once<tr><td><a id="l150"></a><a href="#l150">150</a><td> * to an object and if it is added again the key for the listener is<tr><td><a id="l151"></a><a href="#l151">151</a><td> * returned. Note that if the existing listener is a one-off listener<tr><td><a id="l152"></a><a href="#l152">152</a><td> * (registered via listenOnce), it will no longer be a one-off<tr><td><a id="l153"></a><a href="#l153">153</a><td> * listener after a call to listen().<tr><td><a id="l154"></a><a href="#l154">154</a><td> *<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {EventTarget|goog.events.Listenable} src The node to listen<tr><td><a id="l156"></a><a href="#l156">156</a><td> *     to events on.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @param {string|Array&lt;string&gt;|<tr><td><a id="l158"></a><a href="#l158">158</a><td> *     !goog.events.EventId&lt;EVENTOBJ&gt;|!Array&lt;!goog.events.EventId&lt;EVENTOBJ&gt;&gt;}<tr><td><a id="l159"></a><a href="#l159">159</a><td> *     type Event type or array of event types.<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @param {function(this:T, EVENTOBJ):?|{handleEvent:function(?):?}|null}<tr><td><a id="l161"></a><a href="#l161">161</a><td> *     listener Callback method, or an object with a handleEvent function.<tr><td><a id="l162"></a><a href="#l162">162</a><td> *     WARNING: passing an Object is now softly deprecated.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @param {boolean=} opt_capt Whether to fire in capture phase (defaults to<tr><td><a id="l164"></a><a href="#l164">164</a><td> *     false).<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {T=} opt_handler Element in whose scope to call the listener.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @return {goog.events.Key} Unique key for the listener.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @template T,EVENTOBJ<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>goog.events.listen = function(src, type, listener, opt_capt, opt_handler) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>  if (goog.isArray(type)) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>    for (var i = 0; i &lt; type.length; i++) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>      goog.events.listen(src, type[i], listener, opt_capt, opt_handler);<tr><td><a id="l173"></a><a href="#l173">173</a><td>    }<tr><td><a id="l174"></a><a href="#l174">174</a><td>    return null;<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>  listener = goog.events.wrapListener(listener);<tr><td><a id="l178"></a><a href="#l178">178</a><td>  if (goog.events.Listenable.isImplementedBy(src)) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>    return src.listen(<tr><td><a id="l180"></a><a href="#l180">180</a><td>        /** @type {string|!goog.events.EventId} */ (type),<tr><td><a id="l181"></a><a href="#l181">181</a><td>        listener, opt_capt, opt_handler);<tr><td><a id="l182"></a><a href="#l182">182</a><td>  } else {<tr><td><a id="l183"></a><a href="#l183">183</a><td>    return goog.events.listen_(<tr><td><a id="l184"></a><a href="#l184">184</a><td>        /** @type {!EventTarget} */ (src),<tr><td><a id="l185"></a><a href="#l185">185</a><td>        /** @type {string|!goog.events.EventId} */ (type),<tr><td><a id="l186"></a><a href="#l186">186</a><td>        listener, /* callOnce */ false, opt_capt, opt_handler);<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><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> * Adds an event listener for a specific event on a native event<tr><td><a id="l193"></a><a href="#l193">193</a><td> * target. A listener can only be added once to an object and if it<tr><td><a id="l194"></a><a href="#l194">194</a><td> * is added again the key for the listener is returned.<tr><td><a id="l195"></a><a href="#l195">195</a><td> *<tr><td><a id="l196"></a><a href="#l196">196</a><td> * Note that a one-off listener will not change an existing listener,<tr><td><a id="l197"></a><a href="#l197">197</a><td> * if any. On the other hand a normal listener will change existing<tr><td><a id="l198"></a><a href="#l198">198</a><td> * one-off listener to become a normal listener.<tr><td><a id="l199"></a><a href="#l199">199</a><td> *<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @param {EventTarget} src The node to listen to events on.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @param {string|!goog.events.EventId} type Event type.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @param {!Function} listener Callback function.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {boolean} callOnce Whether the listener is a one-off<tr><td><a id="l204"></a><a href="#l204">204</a><td> *     listener or otherwise.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @param {boolean=} opt_capt Whether to fire in capture phase (defaults to<tr><td><a id="l206"></a><a href="#l206">206</a><td> *     false).<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @param {Object=} opt_handler Element in whose scope to call the listener.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @return {goog.events.ListenableKey} Unique key for the listener.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @private<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>goog.events.listen_ = function(<tr><td><a id="l212"></a><a href="#l212">212</a><td>    src, type, listener, callOnce, opt_capt, opt_handler) {<tr><td><a id="l213"></a><a href="#l213">213</a><td>  if (!type) {<tr><td><a id="l214"></a><a href="#l214">214</a><td>    throw Error(&#39;Invalid event type&#39;);<tr><td><a id="l215"></a><a href="#l215">215</a><td>  }<tr><td><a id="l216"></a><a href="#l216">216</a><td><tr><td><a id="l217"></a><a href="#l217">217</a><td>  var capture = !!opt_capt;<tr><td><a id="l218"></a><a href="#l218">218</a><td>  if (capture &amp;&amp; !goog.events.BrowserFeature.HAS_W3C_EVENT_SUPPORT) {<tr><td><a id="l219"></a><a href="#l219">219</a><td>    if (goog.events.CAPTURE_SIMULATION_MODE ==<tr><td><a id="l220"></a><a href="#l220">220</a><td>        goog.events.CaptureSimulationMode.OFF_AND_FAIL) {<tr><td><a id="l221"></a><a href="#l221">221</a><td>      goog.asserts.fail(&#39;Can not register capture listener in IE8-.&#39;);<tr><td><a id="l222"></a><a href="#l222">222</a><td>      return null;<tr><td><a id="l223"></a><a href="#l223">223</a><td>    } else if (goog.events.CAPTURE_SIMULATION_MODE ==<tr><td><a id="l224"></a><a href="#l224">224</a><td>        goog.events.CaptureSimulationMode.OFF_AND_SILENT) {<tr><td><a id="l225"></a><a href="#l225">225</a><td>      return null;<tr><td><a id="l226"></a><a href="#l226">226</a><td>    }<tr><td><a id="l227"></a><a href="#l227">227</a><td>  }<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>  var listenerMap = goog.events.getListenerMap_(src);<tr><td><a id="l230"></a><a href="#l230">230</a><td>  if (!listenerMap) {<tr><td><a id="l231"></a><a href="#l231">231</a><td>    src[goog.events.LISTENER_MAP_PROP_] = listenerMap =<tr><td><a id="l232"></a><a href="#l232">232</a><td>        new goog.events.ListenerMap(src);<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>  var listenerObj = listenerMap.add(<tr><td><a id="l236"></a><a href="#l236">236</a><td>      type, listener, callOnce, opt_capt, opt_handler);<tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>  // If the listenerObj already has a proxy, it has been set up<tr><td><a id="l239"></a><a href="#l239">239</a><td>  // previously. We simply return.<tr><td><a id="l240"></a><a href="#l240">240</a><td>  if (listenerObj.proxy) {<tr><td><a id="l241"></a><a href="#l241">241</a><td>    return listenerObj;<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>  var proxy = goog.events.getProxy();<tr><td><a id="l245"></a><a href="#l245">245</a><td>  listenerObj.proxy = proxy;<tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>  proxy.src = src;<tr><td><a id="l248"></a><a href="#l248">248</a><td>  proxy.listener = listenerObj;<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td>  // Attach the proxy through the browser&#39;s API<tr><td><a id="l251"></a><a href="#l251">251</a><td>  if (src.addEventListener) {<tr><td><a id="l252"></a><a href="#l252">252</a><td>    src.addEventListener(type.toString(), proxy, capture);<tr><td><a id="l253"></a><a href="#l253">253</a><td>  } else if (src.attachEvent) {<tr><td><a id="l254"></a><a href="#l254">254</a><td>    // The else if above used to be an unconditional else. It would call<tr><td><a id="l255"></a><a href="#l255">255</a><td>    // exception on IE11, spoiling the day of some callers. The previous<tr><td><a id="l256"></a><a href="#l256">256</a><td>    // incarnation of this code, from 2007, indicates that it replaced an<tr><td><a id="l257"></a><a href="#l257">257</a><td>    // earlier still version that caused excess allocations on IE6.<tr><td><a id="l258"></a><a href="#l258">258</a><td>    src.attachEvent(goog.events.getOnString_(type.toString()), proxy);<tr><td><a id="l259"></a><a href="#l259">259</a><td>  } else {<tr><td><a id="l260"></a><a href="#l260">260</a><td>    throw Error(&#39;addEventListener and attachEvent are unavailable.&#39;);<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>  goog.events.listenerCountEstimate_++;<tr><td><a id="l264"></a><a href="#l264">264</a><td>  return listenerObj;<tr><td><a id="l265"></a><a href="#l265">265</a><td>};<tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td>/**<tr><td><a id="l269"></a><a href="#l269">269</a><td> * Helper function for returning a proxy function.<tr><td><a id="l270"></a><a href="#l270">270</a><td> * @return {!Function} A new or reused function object.<tr><td><a id="l271"></a><a href="#l271">271</a><td> */<tr><td><a id="l272"></a><a href="#l272">272</a><td>goog.events.getProxy = function() {<tr><td><a id="l273"></a><a href="#l273">273</a><td>  var proxyCallbackFunction = goog.events.handleBrowserEvent_;<tr><td><a id="l274"></a><a href="#l274">274</a><td>  // Use a local var f to prevent one allocation.<tr><td><a id="l275"></a><a href="#l275">275</a><td>  var f = goog.events.BrowserFeature.HAS_W3C_EVENT_SUPPORT ?<tr><td><a id="l276"></a><a href="#l276">276</a><td>      function(eventObject) {<tr><td><a id="l277"></a><a href="#l277">277</a><td>        return proxyCallbackFunction.call(f.src, f.listener, eventObject);<tr><td><a id="l278"></a><a href="#l278">278</a><td>      } :<tr><td><a id="l279"></a><a href="#l279">279</a><td>      function(eventObject) {<tr><td><a id="l280"></a><a href="#l280">280</a><td>        var v = proxyCallbackFunction.call(f.src, f.listener, eventObject);<tr><td><a id="l281"></a><a href="#l281">281</a><td>        // NOTE(chrishenry): In IE, we hack in a capture phase. However, if<tr><td><a id="l282"></a><a href="#l282">282</a><td>        // there is inline event handler which tries to prevent default (for<tr><td><a id="l283"></a><a href="#l283">283</a><td>        // example &lt;a href=&quot;...&quot; onclick=&quot;return false&quot;&gt;...&lt;/a&gt;) in a<tr><td><a id="l284"></a><a href="#l284">284</a><td>        // descendant element, the prevent default will be overridden<tr><td><a id="l285"></a><a href="#l285">285</a><td>        // by this listener if this listener were to return true. Hence, we<tr><td><a id="l286"></a><a href="#l286">286</a><td>        // return undefined.<tr><td><a id="l287"></a><a href="#l287">287</a><td>        if (!v) return v;<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 f;<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> * Adds an event listener for a specific event on a native event<tr><td><a id="l295"></a><a href="#l295">295</a><td> * target (such as a DOM element) or an object that has implemented<tr><td><a id="l296"></a><a href="#l296">296</a><td> * {@link goog.events.Listenable}. After the event has fired the event<tr><td><a id="l297"></a><a href="#l297">297</a><td> * listener is removed from the target.<tr><td><a id="l298"></a><a href="#l298">298</a><td> *<tr><td><a id="l299"></a><a href="#l299">299</a><td> * If an existing listener already exists, listenOnce will do<tr><td><a id="l300"></a><a href="#l300">300</a><td> * nothing. In particular, if the listener was previously registered<tr><td><a id="l301"></a><a href="#l301">301</a><td> * via listen(), listenOnce() will not turn the listener into a<tr><td><a id="l302"></a><a href="#l302">302</a><td> * one-off listener. Similarly, if there is already an existing<tr><td><a id="l303"></a><a href="#l303">303</a><td> * one-off listener, listenOnce does not modify the listeners (it is<tr><td><a id="l304"></a><a href="#l304">304</a><td> * still a once listener).<tr><td><a id="l305"></a><a href="#l305">305</a><td> *<tr><td><a id="l306"></a><a href="#l306">306</a><td> * @param {EventTarget|goog.events.Listenable} src The node to listen<tr><td><a id="l307"></a><a href="#l307">307</a><td> *     to events on.<tr><td><a id="l308"></a><a href="#l308">308</a><td> * @param {string|Array&lt;string&gt;|<tr><td><a id="l309"></a><a href="#l309">309</a><td> *     !goog.events.EventId&lt;EVENTOBJ&gt;|!Array&lt;!goog.events.EventId&lt;EVENTOBJ&gt;&gt;}<tr><td><a id="l310"></a><a href="#l310">310</a><td> *     type Event type or array of event types.<tr><td><a id="l311"></a><a href="#l311">311</a><td> * @param {function(this:T, EVENTOBJ):?|{handleEvent:function(?):?}|null}<tr><td><a id="l312"></a><a href="#l312">312</a><td> *     listener Callback method.<tr><td><a id="l313"></a><a href="#l313">313</a><td> * @param {boolean=} opt_capt Fire in capture phase?.<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @param {T=} opt_handler Element in whose scope to call the listener.<tr><td><a id="l315"></a><a href="#l315">315</a><td> * @return {goog.events.Key} Unique key for the listener.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @template T,EVENTOBJ<tr><td><a id="l317"></a><a href="#l317">317</a><td> */<tr><td><a id="l318"></a><a href="#l318">318</a><td>goog.events.listenOnce = function(src, type, listener, opt_capt, opt_handler) {<tr><td><a id="l319"></a><a href="#l319">319</a><td>  if (goog.isArray(type)) {<tr><td><a id="l320"></a><a href="#l320">320</a><td>    for (var i = 0; i &lt; type.length; i++) {<tr><td><a id="l321"></a><a href="#l321">321</a><td>      goog.events.listenOnce(src, type[i], listener, opt_capt, opt_handler);<tr><td><a id="l322"></a><a href="#l322">322</a><td>    }<tr><td><a id="l323"></a><a href="#l323">323</a><td>    return null;<tr><td><a id="l324"></a><a href="#l324">324</a><td>  }<tr><td><a id="l325"></a><a href="#l325">325</a><td><tr><td><a id="l326"></a><a href="#l326">326</a><td>  listener = goog.events.wrapListener(listener);<tr><td><a id="l327"></a><a href="#l327">327</a><td>  if (goog.events.Listenable.isImplementedBy(src)) {<tr><td><a id="l328"></a><a href="#l328">328</a><td>    return src.listenOnce(<tr><td><a id="l329"></a><a href="#l329">329</a><td>        /** @type {string|!goog.events.EventId} */ (type),<tr><td><a id="l330"></a><a href="#l330">330</a><td>        listener, opt_capt, opt_handler);<tr><td><a id="l331"></a><a href="#l331">331</a><td>  } else {<tr><td><a id="l332"></a><a href="#l332">332</a><td>    return goog.events.listen_(<tr><td><a id="l333"></a><a href="#l333">333</a><td>        /** @type {!EventTarget} */ (src),<tr><td><a id="l334"></a><a href="#l334">334</a><td>        /** @type {string|!goog.events.EventId} */ (type),<tr><td><a id="l335"></a><a href="#l335">335</a><td>        listener, /* callOnce */ true, opt_capt, opt_handler);<tr><td><a id="l336"></a><a href="#l336">336</a><td>  }<tr><td><a id="l337"></a><a href="#l337">337</a><td>};<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Adds an event listener with a specific event wrapper on a DOM Node or an<tr><td><a id="l342"></a><a href="#l342">342</a><td> * object that has implemented {@link goog.events.Listenable}. A listener can<tr><td><a id="l343"></a><a href="#l343">343</a><td> * only be added once to an object.<tr><td><a id="l344"></a><a href="#l344">344</a><td> *<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @param {EventTarget|goog.events.Listenable} src The target to<tr><td><a id="l346"></a><a href="#l346">346</a><td> *     listen to events on.<tr><td><a id="l347"></a><a href="#l347">347</a><td> * @param {goog.events.EventWrapper} wrapper Event wrapper to use.<tr><td><a id="l348"></a><a href="#l348">348</a><td> * @param {function(this:T, ?):?|{handleEvent:function(?):?}|null} listener<tr><td><a id="l349"></a><a href="#l349">349</a><td> *     Callback method, or an object with a handleEvent function.<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @param {boolean=} opt_capt Whether to fire in capture phase (defaults to<tr><td><a id="l351"></a><a href="#l351">351</a><td> *     false).<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @param {T=} opt_handler Element in whose scope to call the listener.<tr><td><a id="l353"></a><a href="#l353">353</a><td> * @template T<tr><td><a id="l354"></a><a href="#l354">354</a><td> */<tr><td><a id="l355"></a><a href="#l355">355</a><td>goog.events.listenWithWrapper = function(src, wrapper, listener, opt_capt,<tr><td><a id="l356"></a><a href="#l356">356</a><td>    opt_handler) {<tr><td><a id="l357"></a><a href="#l357">357</a><td>  wrapper.listen(src, listener, opt_capt, opt_handler);<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><tr><td><a id="l361"></a><a href="#l361">361</a><td>/**<tr><td><a id="l362"></a><a href="#l362">362</a><td> * Removes an event listener which was added with listen().<tr><td><a id="l363"></a><a href="#l363">363</a><td> *<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @param {EventTarget|goog.events.Listenable} src The target to stop<tr><td><a id="l365"></a><a href="#l365">365</a><td> *     listening to events on.<tr><td><a id="l366"></a><a href="#l366">366</a><td> * @param {string|Array&lt;string&gt;|<tr><td><a id="l367"></a><a href="#l367">367</a><td> *     !goog.events.EventId&lt;EVENTOBJ&gt;|!Array&lt;!goog.events.EventId&lt;EVENTOBJ&gt;&gt;}<tr><td><a id="l368"></a><a href="#l368">368</a><td> *     type Event type or array of event types to unlisten to.<tr><td><a id="l369"></a><a href="#l369">369</a><td> * @param {function(?):?|{handleEvent:function(?):?}|null} listener The<tr><td><a id="l370"></a><a href="#l370">370</a><td> *     listener function to remove.<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @param {boolean=} opt_capt In DOM-compliant browsers, this determines<tr><td><a id="l372"></a><a href="#l372">372</a><td> *     whether the listener is fired during the capture or bubble phase of the<tr><td><a id="l373"></a><a href="#l373">373</a><td> *     event.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {Object=} opt_handler Element in whose scope to call the listener.<tr><td><a id="l375"></a><a href="#l375">375</a><td> * @return {?boolean} indicating whether the listener was there to remove.<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @template EVENTOBJ<tr><td><a id="l377"></a><a href="#l377">377</a><td> */<tr><td><a id="l378"></a><a href="#l378">378</a><td>goog.events.unlisten = function(src, type, listener, opt_capt, opt_handler) {<tr><td><a id="l379"></a><a href="#l379">379</a><td>  if (goog.isArray(type)) {<tr><td><a id="l380"></a><a href="#l380">380</a><td>    for (var i = 0; i &lt; type.length; i++) {<tr><td><a id="l381"></a><a href="#l381">381</a><td>      goog.events.unlisten(src, type[i], listener, opt_capt, opt_handler);<tr><td><a id="l382"></a><a href="#l382">382</a><td>    }<tr><td><a id="l383"></a><a href="#l383">383</a><td>    return null;<tr><td><a id="l384"></a><a href="#l384">384</a><td>  }<tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td>  listener = goog.events.wrapListener(listener);<tr><td><a id="l387"></a><a href="#l387">387</a><td>  if (goog.events.Listenable.isImplementedBy(src)) {<tr><td><a id="l388"></a><a href="#l388">388</a><td>    return src.unlisten(<tr><td><a id="l389"></a><a href="#l389">389</a><td>        /** @type {string|!goog.events.EventId} */ (type),<tr><td><a id="l390"></a><a href="#l390">390</a><td>        listener, opt_capt, opt_handler);<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>  if (!src) {<tr><td><a id="l394"></a><a href="#l394">394</a><td>    // TODO(chrishenry): We should tighten the API to only accept<tr><td><a id="l395"></a><a href="#l395">395</a><td>    // non-null objects, or add an assertion here.<tr><td><a id="l396"></a><a href="#l396">396</a><td>    return false;<tr><td><a id="l397"></a><a href="#l397">397</a><td>  }<tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td>  var capture = !!opt_capt;<tr><td><a id="l400"></a><a href="#l400">400</a><td>  var listenerMap = goog.events.getListenerMap_(<tr><td><a id="l401"></a><a href="#l401">401</a><td>      /** @type {!EventTarget} */ (src));<tr><td><a id="l402"></a><a href="#l402">402</a><td>  if (listenerMap) {<tr><td><a id="l403"></a><a href="#l403">403</a><td>    var listenerObj = listenerMap.getListener(<tr><td><a id="l404"></a><a href="#l404">404</a><td>        /** @type {string|!goog.events.EventId} */ (type),<tr><td><a id="l405"></a><a href="#l405">405</a><td>        listener, capture, opt_handler);<tr><td><a id="l406"></a><a href="#l406">406</a><td>    if (listenerObj) {<tr><td><a id="l407"></a><a href="#l407">407</a><td>      return goog.events.unlistenByKey(listenerObj);<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>  return false;<tr><td><a id="l412"></a><a href="#l412">412</a><td>};<tr><td><a id="l413"></a><a href="#l413">413</a><td><tr><td><a id="l414"></a><a href="#l414">414</a><td><tr><td><a id="l415"></a><a href="#l415">415</a><td>/**<tr><td><a id="l416"></a><a href="#l416">416</a><td> * Removes an event listener which was added with listen() by the key<tr><td><a id="l417"></a><a href="#l417">417</a><td> * returned by listen().<tr><td><a id="l418"></a><a href="#l418">418</a><td> *<tr><td><a id="l419"></a><a href="#l419">419</a><td> * @param {goog.events.Key} key The key returned by listen() for this<tr><td><a id="l420"></a><a href="#l420">420</a><td> *     event listener.<tr><td><a id="l421"></a><a href="#l421">421</a><td> * @return {boolean} indicating whether the listener was there to remove.<tr><td><a id="l422"></a><a href="#l422">422</a><td> */<tr><td><a id="l423"></a><a href="#l423">423</a><td>goog.events.unlistenByKey = function(key) {<tr><td><a id="l424"></a><a href="#l424">424</a><td>  // TODO(chrishenry): Remove this check when tests that rely on this<tr><td><a id="l425"></a><a href="#l425">425</a><td>  // are fixed.<tr><td><a id="l426"></a><a href="#l426">426</a><td>  if (goog.isNumber(key)) {<tr><td><a id="l427"></a><a href="#l427">427</a><td>    return false;<tr><td><a id="l428"></a><a href="#l428">428</a><td>  }<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td>  var listener = key;<tr><td><a id="l431"></a><a href="#l431">431</a><td>  if (!listener || listener.removed) {<tr><td><a id="l432"></a><a href="#l432">432</a><td>    return false;<tr><td><a id="l433"></a><a href="#l433">433</a><td>  }<tr><td><a id="l434"></a><a href="#l434">434</a><td><tr><td><a id="l435"></a><a href="#l435">435</a><td>  var src = listener.src;<tr><td><a id="l436"></a><a href="#l436">436</a><td>  if (goog.events.Listenable.isImplementedBy(src)) {<tr><td><a id="l437"></a><a href="#l437">437</a><td>    return src.unlistenByKey(listener);<tr><td><a id="l438"></a><a href="#l438">438</a><td>  }<tr><td><a id="l439"></a><a href="#l439">439</a><td><tr><td><a id="l440"></a><a href="#l440">440</a><td>  var type = listener.type;<tr><td><a id="l441"></a><a href="#l441">441</a><td>  var proxy = listener.proxy;<tr><td><a id="l442"></a><a href="#l442">442</a><td>  if (src.removeEventListener) {<tr><td><a id="l443"></a><a href="#l443">443</a><td>    src.removeEventListener(type, proxy, listener.capture);<tr><td><a id="l444"></a><a href="#l444">444</a><td>  } else if (src.detachEvent) {<tr><td><a id="l445"></a><a href="#l445">445</a><td>    src.detachEvent(goog.events.getOnString_(type), proxy);<tr><td><a id="l446"></a><a href="#l446">446</a><td>  }<tr><td><a id="l447"></a><a href="#l447">447</a><td>  goog.events.listenerCountEstimate_--;<tr><td><a id="l448"></a><a href="#l448">448</a><td><tr><td><a id="l449"></a><a href="#l449">449</a><td>  var listenerMap = goog.events.getListenerMap_(<tr><td><a id="l450"></a><a href="#l450">450</a><td>      /** @type {!EventTarget} */ (src));<tr><td><a id="l451"></a><a href="#l451">451</a><td>  // TODO(chrishenry): Try to remove this conditional and execute the<tr><td><a id="l452"></a><a href="#l452">452</a><td>  // first branch always. This should be safe.<tr><td><a id="l453"></a><a href="#l453">453</a><td>  if (listenerMap) {<tr><td><a id="l454"></a><a href="#l454">454</a><td>    listenerMap.removeByKey(listener);<tr><td><a id="l455"></a><a href="#l455">455</a><td>    if (listenerMap.getTypeCount() == 0) {<tr><td><a id="l456"></a><a href="#l456">456</a><td>      // Null the src, just because this is simple to do (and useful<tr><td><a id="l457"></a><a href="#l457">457</a><td>      // for IE &lt;= 7).<tr><td><a id="l458"></a><a href="#l458">458</a><td>      listenerMap.src = null;<tr><td><a id="l459"></a><a href="#l459">459</a><td>      // We don&#39;t use delete here because IE does not allow delete<tr><td><a id="l460"></a><a href="#l460">460</a><td>      // on a window object.<tr><td><a id="l461"></a><a href="#l461">461</a><td>      src[goog.events.LISTENER_MAP_PROP_] = null;<tr><td><a id="l462"></a><a href="#l462">462</a><td>    }<tr><td><a id="l463"></a><a href="#l463">463</a><td>  } else {<tr><td><a id="l464"></a><a href="#l464">464</a><td>    listener.markAsRemoved();<tr><td><a id="l465"></a><a href="#l465">465</a><td>  }<tr><td><a id="l466"></a><a href="#l466">466</a><td><tr><td><a id="l467"></a><a href="#l467">467</a><td>  return true;<tr><td><a id="l468"></a><a href="#l468">468</a><td>};<tr><td><a id="l469"></a><a href="#l469">469</a><td><tr><td><a id="l470"></a><a href="#l470">470</a><td><tr><td><a id="l471"></a><a href="#l471">471</a><td>/**<tr><td><a id="l472"></a><a href="#l472">472</a><td> * Removes an event listener which was added with listenWithWrapper().<tr><td><a id="l473"></a><a href="#l473">473</a><td> *<tr><td><a id="l474"></a><a href="#l474">474</a><td> * @param {EventTarget|goog.events.Listenable} src The target to stop<tr><td><a id="l475"></a><a href="#l475">475</a><td> *     listening to events on.<tr><td><a id="l476"></a><a href="#l476">476</a><td> * @param {goog.events.EventWrapper} wrapper Event wrapper to use.<tr><td><a id="l477"></a><a href="#l477">477</a><td> * @param {function(?):?|{handleEvent:function(?):?}|null} listener The<tr><td><a id="l478"></a><a href="#l478">478</a><td> *     listener function to remove.<tr><td><a id="l479"></a><a href="#l479">479</a><td> * @param {boolean=} opt_capt In DOM-compliant browsers, this determines<tr><td><a id="l480"></a><a href="#l480">480</a><td> *     whether the listener is fired during the capture or bubble phase of the<tr><td><a id="l481"></a><a href="#l481">481</a><td> *     event.<tr><td><a id="l482"></a><a href="#l482">482</a><td> * @param {Object=} opt_handler Element in whose scope to call the listener.<tr><td><a id="l483"></a><a href="#l483">483</a><td> */<tr><td><a id="l484"></a><a href="#l484">484</a><td>goog.events.unlistenWithWrapper = function(src, wrapper, listener, opt_capt,<tr><td><a id="l485"></a><a href="#l485">485</a><td>    opt_handler) {<tr><td><a id="l486"></a><a href="#l486">486</a><td>  wrapper.unlisten(src, listener, opt_capt, opt_handler);<tr><td><a id="l487"></a><a href="#l487">487</a><td>};<tr><td><a id="l488"></a><a href="#l488">488</a><td><tr><td><a id="l489"></a><a href="#l489">489</a><td><tr><td><a id="l490"></a><a href="#l490">490</a><td>/**<tr><td><a id="l491"></a><a href="#l491">491</a><td> * Removes all listeners from an object. You can also optionally<tr><td><a id="l492"></a><a href="#l492">492</a><td> * remove listeners of a particular type.<tr><td><a id="l493"></a><a href="#l493">493</a><td> *<tr><td><a id="l494"></a><a href="#l494">494</a><td> * @param {Object|undefined} obj Object to remove listeners from. Must be an<tr><td><a id="l495"></a><a href="#l495">495</a><td> *     EventTarget or a goog.events.Listenable.<tr><td><a id="l496"></a><a href="#l496">496</a><td> * @param {string|!goog.events.EventId=} opt_type Type of event to remove.<tr><td><a id="l497"></a><a href="#l497">497</a><td> *     Default is all types.<tr><td><a id="l498"></a><a href="#l498">498</a><td> * @return {number} Number of listeners removed.<tr><td><a id="l499"></a><a href="#l499">499</a><td> */<tr><td><a id="l500"></a><a href="#l500">500</a><td>goog.events.removeAll = function(obj, opt_type) {<tr><td><a id="l501"></a><a href="#l501">501</a><td>  // TODO(chrishenry): Change the type of obj to<tr><td><a id="l502"></a><a href="#l502">502</a><td>  // (!EventTarget|!goog.events.Listenable).<tr><td><a id="l503"></a><a href="#l503">503</a><td><tr><td><a id="l504"></a><a href="#l504">504</a><td>  if (!obj) {<tr><td><a id="l505"></a><a href="#l505">505</a><td>    return 0;<tr><td><a id="l506"></a><a href="#l506">506</a><td>  }<tr><td><a id="l507"></a><a href="#l507">507</a><td><tr><td><a id="l508"></a><a href="#l508">508</a><td>  if (goog.events.Listenable.isImplementedBy(obj)) {<tr><td><a id="l509"></a><a href="#l509">509</a><td>    return obj.removeAllListeners(opt_type);<tr><td><a id="l510"></a><a href="#l510">510</a><td>  }<tr><td><a id="l511"></a><a href="#l511">511</a><td><tr><td><a id="l512"></a><a href="#l512">512</a><td>  var listenerMap = goog.events.getListenerMap_(<tr><td><a id="l513"></a><a href="#l513">513</a><td>      /** @type {!EventTarget} */ (obj));<tr><td><a id="l514"></a><a href="#l514">514</a><td>  if (!listenerMap) {<tr><td><a id="l515"></a><a href="#l515">515</a><td>    return 0;<tr><td><a id="l516"></a><a href="#l516">516</a><td>  }<tr><td><a id="l517"></a><a href="#l517">517</a><td><tr><td><a id="l518"></a><a href="#l518">518</a><td>  var count = 0;<tr><td><a id="l519"></a><a href="#l519">519</a><td>  var typeStr = opt_type &amp;&amp; opt_type.toString();<tr><td><a id="l520"></a><a href="#l520">520</a><td>  for (var type in listenerMap.listeners) {<tr><td><a id="l521"></a><a href="#l521">521</a><td>    if (!typeStr || type == typeStr) {<tr><td><a id="l522"></a><a href="#l522">522</a><td>      // Clone so that we don&#39;t need to worry about unlistenByKey<tr><td><a id="l523"></a><a href="#l523">523</a><td>      // changing the content of the ListenerMap.<tr><td><a id="l524"></a><a href="#l524">524</a><td>      var listeners = listenerMap.listeners[type].concat();<tr><td><a id="l525"></a><a href="#l525">525</a><td>      for (var i = 0; i &lt; listeners.length; ++i) {<tr><td><a id="l526"></a><a href="#l526">526</a><td>        if (goog.events.unlistenByKey(listeners[i])) {<tr><td><a id="l527"></a><a href="#l527">527</a><td>          ++count;<tr><td><a id="l528"></a><a href="#l528">528</a><td>        }<tr><td><a id="l529"></a><a href="#l529">529</a><td>      }<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 count;<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> * Gets the listeners for a given object, type and capture phase.<tr><td><a id="l538"></a><a href="#l538">538</a><td> *<tr><td><a id="l539"></a><a href="#l539">539</a><td> * @param {Object} obj Object to get listeners for.<tr><td><a id="l540"></a><a href="#l540">540</a><td> * @param {string|!goog.events.EventId} type Event type.<tr><td><a id="l541"></a><a href="#l541">541</a><td> * @param {boolean} capture Capture phase?.<tr><td><a id="l542"></a><a href="#l542">542</a><td> * @return {Array&lt;goog.events.Listener&gt;} Array of listener objects.<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.events.getListeners = function(obj, type, capture) {<tr><td><a id="l545"></a><a href="#l545">545</a><td>  if (goog.events.Listenable.isImplementedBy(obj)) {<tr><td><a id="l546"></a><a href="#l546">546</a><td>    return obj.getListeners(type, capture);<tr><td><a id="l547"></a><a href="#l547">547</a><td>  } else {<tr><td><a id="l548"></a><a href="#l548">548</a><td>    if (!obj) {<tr><td><a id="l549"></a><a href="#l549">549</a><td>      // TODO(chrishenry): We should tighten the API to accept<tr><td><a id="l550"></a><a href="#l550">550</a><td>      // !EventTarget|goog.events.Listenable, and add an assertion here.<tr><td><a id="l551"></a><a href="#l551">551</a><td>      return [];<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>    var listenerMap = goog.events.getListenerMap_(<tr><td><a id="l555"></a><a href="#l555">555</a><td>        /** @type {!EventTarget} */ (obj));<tr><td><a id="l556"></a><a href="#l556">556</a><td>    return listenerMap ? listenerMap.getListeners(type, capture) : [];<tr><td><a id="l557"></a><a href="#l557">557</a><td>  }<tr><td><a id="l558"></a><a href="#l558">558</a><td>};<tr><td><a id="l559"></a><a href="#l559">559</a><td><tr><td><a id="l560"></a><a href="#l560">560</a><td><tr><td><a id="l561"></a><a href="#l561">561</a><td>/**<tr><td><a id="l562"></a><a href="#l562">562</a><td> * Gets the goog.events.Listener for the event or null if no such listener is<tr><td><a id="l563"></a><a href="#l563">563</a><td> * in use.<tr><td><a id="l564"></a><a href="#l564">564</a><td> *<tr><td><a id="l565"></a><a href="#l565">565</a><td> * @param {EventTarget|goog.events.Listenable} src The target from<tr><td><a id="l566"></a><a href="#l566">566</a><td> *     which to get listeners.<tr><td><a id="l567"></a><a href="#l567">567</a><td> * @param {?string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The type of the event.<tr><td><a id="l568"></a><a href="#l568">568</a><td> * @param {function(EVENTOBJ):?|{handleEvent:function(?):?}|null} listener The<tr><td><a id="l569"></a><a href="#l569">569</a><td> *     listener function to get.<tr><td><a id="l570"></a><a href="#l570">570</a><td> * @param {boolean=} opt_capt In DOM-compliant browsers, this determines<tr><td><a id="l571"></a><a href="#l571">571</a><td> *                            whether the listener is fired during the<tr><td><a id="l572"></a><a href="#l572">572</a><td> *                            capture or bubble phase of the event.<tr><td><a id="l573"></a><a href="#l573">573</a><td> * @param {Object=} opt_handler Element in whose scope to call the listener.<tr><td><a id="l574"></a><a href="#l574">574</a><td> * @return {goog.events.ListenableKey} the found listener or null if not found.<tr><td><a id="l575"></a><a href="#l575">575</a><td> * @template EVENTOBJ<tr><td><a id="l576"></a><a href="#l576">576</a><td> */<tr><td><a id="l577"></a><a href="#l577">577</a><td>goog.events.getListener = function(src, type, listener, opt_capt, opt_handler) {<tr><td><a id="l578"></a><a href="#l578">578</a><td>  // TODO(chrishenry): Change type from ?string to string, or add assertion.<tr><td><a id="l579"></a><a href="#l579">579</a><td>  type = /** @type {string} */ (type);<tr><td><a id="l580"></a><a href="#l580">580</a><td>  listener = goog.events.wrapListener(listener);<tr><td><a id="l581"></a><a href="#l581">581</a><td>  var capture = !!opt_capt;<tr><td><a id="l582"></a><a href="#l582">582</a><td>  if (goog.events.Listenable.isImplementedBy(src)) {<tr><td><a id="l583"></a><a href="#l583">583</a><td>    return src.getListener(type, listener, capture, opt_handler);<tr><td><a id="l584"></a><a href="#l584">584</a><td>  }<tr><td><a id="l585"></a><a href="#l585">585</a><td><tr><td><a id="l586"></a><a href="#l586">586</a><td>  if (!src) {<tr><td><a id="l587"></a><a href="#l587">587</a><td>    // TODO(chrishenry): We should tighten the API to only accept<tr><td><a id="l588"></a><a href="#l588">588</a><td>    // non-null objects, or add an assertion here.<tr><td><a id="l589"></a><a href="#l589">589</a><td>    return null;<tr><td><a id="l590"></a><a href="#l590">590</a><td>  }<tr><td><a id="l591"></a><a href="#l591">591</a><td><tr><td><a id="l592"></a><a href="#l592">592</a><td>  var listenerMap = goog.events.getListenerMap_(<tr><td><a id="l593"></a><a href="#l593">593</a><td>      /** @type {!EventTarget} */ (src));<tr><td><a id="l594"></a><a href="#l594">594</a><td>  if (listenerMap) {<tr><td><a id="l595"></a><a href="#l595">595</a><td>    return listenerMap.getListener(type, listener, capture, opt_handler);<tr><td><a id="l596"></a><a href="#l596">596</a><td>  }<tr><td><a id="l597"></a><a href="#l597">597</a><td>  return null;<tr><td><a id="l598"></a><a href="#l598">598</a><td>};<tr><td><a id="l599"></a><a href="#l599">599</a><td><tr><td><a id="l600"></a><a href="#l600">600</a><td><tr><td><a id="l601"></a><a href="#l601">601</a><td>/**<tr><td><a id="l602"></a><a href="#l602">602</a><td> * Returns whether an event target has any active listeners matching the<tr><td><a id="l603"></a><a href="#l603">603</a><td> * specified signature. If either the type or capture parameters are<tr><td><a id="l604"></a><a href="#l604">604</a><td> * unspecified, the function will match on the remaining criteria.<tr><td><a id="l605"></a><a href="#l605">605</a><td> *<tr><td><a id="l606"></a><a href="#l606">606</a><td> * @param {EventTarget|goog.events.Listenable} obj Target to get<tr><td><a id="l607"></a><a href="#l607">607</a><td> *     listeners for.<tr><td><a id="l608"></a><a href="#l608">608</a><td> * @param {string|!goog.events.EventId=} opt_type Event type.<tr><td><a id="l609"></a><a href="#l609">609</a><td> * @param {boolean=} opt_capture Whether to check for capture or bubble-phase<tr><td><a id="l610"></a><a href="#l610">610</a><td> *     listeners.<tr><td><a id="l611"></a><a href="#l611">611</a><td> * @return {boolean} Whether an event target has one or more listeners matching<tr><td><a id="l612"></a><a href="#l612">612</a><td> *     the requested type and/or capture phase.<tr><td><a id="l613"></a><a href="#l613">613</a><td> */<tr><td><a id="l614"></a><a href="#l614">614</a><td>goog.events.hasListener = function(obj, opt_type, opt_capture) {<tr><td><a id="l615"></a><a href="#l615">615</a><td>  if (goog.events.Listenable.isImplementedBy(obj)) {<tr><td><a id="l616"></a><a href="#l616">616</a><td>    return obj.hasListener(opt_type, opt_capture);<tr><td><a id="l617"></a><a href="#l617">617</a><td>  }<tr><td><a id="l618"></a><a href="#l618">618</a><td><tr><td><a id="l619"></a><a href="#l619">619</a><td>  var listenerMap = goog.events.getListenerMap_(<tr><td><a id="l620"></a><a href="#l620">620</a><td>      /** @type {!EventTarget} */ (obj));<tr><td><a id="l621"></a><a href="#l621">621</a><td>  return !!listenerMap &amp;&amp; listenerMap.hasListener(opt_type, opt_capture);<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><tr><td><a id="l625"></a><a href="#l625">625</a><td>/**<tr><td><a id="l626"></a><a href="#l626">626</a><td> * Provides a nice string showing the normalized event objects public members<tr><td><a id="l627"></a><a href="#l627">627</a><td> * @param {Object} e Event Object.<tr><td><a id="l628"></a><a href="#l628">628</a><td> * @return {string} String of the public members of the normalized event object.<tr><td><a id="l629"></a><a href="#l629">629</a><td> */<tr><td><a id="l630"></a><a href="#l630">630</a><td>goog.events.expose = function(e) {<tr><td><a id="l631"></a><a href="#l631">631</a><td>  var str = [];<tr><td><a id="l632"></a><a href="#l632">632</a><td>  for (var key in e) {<tr><td><a id="l633"></a><a href="#l633">633</a><td>    if (e[key] &amp;&amp; e[key].id) {<tr><td><a id="l634"></a><a href="#l634">634</a><td>      str.push(key + &#39; = &#39; + e[key] + &#39; (&#39; + e[key].id + &#39;)&#39;);<tr><td><a id="l635"></a><a href="#l635">635</a><td>    } else {<tr><td><a id="l636"></a><a href="#l636">636</a><td>      str.push(key + &#39; = &#39; + e[key]);<tr><td><a id="l637"></a><a href="#l637">637</a><td>    }<tr><td><a id="l638"></a><a href="#l638">638</a><td>  }<tr><td><a id="l639"></a><a href="#l639">639</a><td>  return str.join(&#39;\n&#39;);<tr><td><a id="l640"></a><a href="#l640">640</a><td>};<tr><td><a id="l641"></a><a href="#l641">641</a><td><tr><td><a id="l642"></a><a href="#l642">642</a><td><tr><td><a id="l643"></a><a href="#l643">643</a><td>/**<tr><td><a id="l644"></a><a href="#l644">644</a><td> * Returns a string with on prepended to the specified type. This is used for IE<tr><td><a id="l645"></a><a href="#l645">645</a><td> * which expects &quot;on&quot; to be prepended. This function caches the string in order<tr><td><a id="l646"></a><a href="#l646">646</a><td> * to avoid extra allocations in steady state.<tr><td><a id="l647"></a><a href="#l647">647</a><td> * @param {string} type Event type.<tr><td><a id="l648"></a><a href="#l648">648</a><td> * @return {string} The type string with &#39;on&#39; prepended.<tr><td><a id="l649"></a><a href="#l649">649</a><td> * @private<tr><td><a id="l650"></a><a href="#l650">650</a><td> */<tr><td><a id="l651"></a><a href="#l651">651</a><td>goog.events.getOnString_ = function(type) {<tr><td><a id="l652"></a><a href="#l652">652</a><td>  if (type in goog.events.onStringMap_) {<tr><td><a id="l653"></a><a href="#l653">653</a><td>    return goog.events.onStringMap_[type];<tr><td><a id="l654"></a><a href="#l654">654</a><td>  }<tr><td><a id="l655"></a><a href="#l655">655</a><td>  return goog.events.onStringMap_[type] = goog.events.onString_ + type;<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>/**<tr><td><a id="l660"></a><a href="#l660">660</a><td> * Fires an object&#39;s listeners of a particular type and phase<tr><td><a id="l661"></a><a href="#l661">661</a><td> *<tr><td><a id="l662"></a><a href="#l662">662</a><td> * @param {Object} obj Object whose listeners to call.<tr><td><a id="l663"></a><a href="#l663">663</a><td> * @param {string|!goog.events.EventId} type Event type.<tr><td><a id="l664"></a><a href="#l664">664</a><td> * @param {boolean} capture Which event phase.<tr><td><a id="l665"></a><a href="#l665">665</a><td> * @param {Object} eventObject Event object to be passed to listener.<tr><td><a id="l666"></a><a href="#l666">666</a><td> * @return {boolean} True if all listeners returned true else false.<tr><td><a id="l667"></a><a href="#l667">667</a><td> */<tr><td><a id="l668"></a><a href="#l668">668</a><td>goog.events.fireListeners = function(obj, type, capture, eventObject) {<tr><td><a id="l669"></a><a href="#l669">669</a><td>  if (goog.events.Listenable.isImplementedBy(obj)) {<tr><td><a id="l670"></a><a href="#l670">670</a><td>    return obj.fireListeners(type, capture, eventObject);<tr><td><a id="l671"></a><a href="#l671">671</a><td>  }<tr><td><a id="l672"></a><a href="#l672">672</a><td><tr><td><a id="l673"></a><a href="#l673">673</a><td>  return goog.events.fireListeners_(obj, type, capture, eventObject);<tr><td><a id="l674"></a><a href="#l674">674</a><td>};<tr><td><a id="l675"></a><a href="#l675">675</a><td><tr><td><a id="l676"></a><a href="#l676">676</a><td><tr><td><a id="l677"></a><a href="#l677">677</a><td>/**<tr><td><a id="l678"></a><a href="#l678">678</a><td> * Fires an object&#39;s listeners of a particular type and phase.<tr><td><a id="l679"></a><a href="#l679">679</a><td> * @param {Object} obj Object whose listeners to call.<tr><td><a id="l680"></a><a href="#l680">680</a><td> * @param {string|!goog.events.EventId} type Event type.<tr><td><a id="l681"></a><a href="#l681">681</a><td> * @param {boolean} capture Which event phase.<tr><td><a id="l682"></a><a href="#l682">682</a><td> * @param {Object} eventObject Event object to be passed to listener.<tr><td><a id="l683"></a><a href="#l683">683</a><td> * @return {boolean} True if all listeners returned true else false.<tr><td><a id="l684"></a><a href="#l684">684</a><td> * @private<tr><td><a id="l685"></a><a href="#l685">685</a><td> */<tr><td><a id="l686"></a><a href="#l686">686</a><td>goog.events.fireListeners_ = function(obj, type, capture, eventObject) {<tr><td><a id="l687"></a><a href="#l687">687</a><td>  /** @type {boolean} */<tr><td><a id="l688"></a><a href="#l688">688</a><td>  var retval = true;<tr><td><a id="l689"></a><a href="#l689">689</a><td><tr><td><a id="l690"></a><a href="#l690">690</a><td>  var listenerMap = goog.events.getListenerMap_(<tr><td><a id="l691"></a><a href="#l691">691</a><td>      /** @type {EventTarget} */ (obj));<tr><td><a id="l692"></a><a href="#l692">692</a><td>  if (listenerMap) {<tr><td><a id="l693"></a><a href="#l693">693</a><td>    // TODO(chrishenry): Original code avoids array creation when there<tr><td><a id="l694"></a><a href="#l694">694</a><td>    // is no listener, so we do the same. If this optimization turns<tr><td><a id="l695"></a><a href="#l695">695</a><td>    // out to be not required, we can replace this with<tr><td><a id="l696"></a><a href="#l696">696</a><td>    // listenerMap.getListeners(type, capture) instead, which is simpler.<tr><td><a id="l697"></a><a href="#l697">697</a><td>    var listenerArray = listenerMap.listeners[type.toString()];<tr><td><a id="l698"></a><a href="#l698">698</a><td>    if (listenerArray) {<tr><td><a id="l699"></a><a href="#l699">699</a><td>      listenerArray = listenerArray.concat();<tr><td><a id="l700"></a><a href="#l700">700</a><td>      for (var i = 0; i &lt; listenerArray.length; i++) {<tr><td><a id="l701"></a><a href="#l701">701</a><td>        var listener = listenerArray[i];<tr><td><a id="l702"></a><a href="#l702">702</a><td>        // We might not have a listener if the listener was removed.<tr><td><a id="l703"></a><a href="#l703">703</a><td>        if (listener &amp;&amp; listener.capture == capture &amp;&amp; !listener.removed) {<tr><td><a id="l704"></a><a href="#l704">704</a><td>          var result = goog.events.fireListener(listener, eventObject);<tr><td><a id="l705"></a><a href="#l705">705</a><td>          retval = retval &amp;&amp; (result !== false);<tr><td><a id="l706"></a><a href="#l706">706</a><td>        }<tr><td><a id="l707"></a><a href="#l707">707</a><td>      }<tr><td><a id="l708"></a><a href="#l708">708</a><td>    }<tr><td><a id="l709"></a><a href="#l709">709</a><td>  }<tr><td><a id="l710"></a><a href="#l710">710</a><td>  return retval;<tr><td><a id="l711"></a><a href="#l711">711</a><td>};<tr><td><a id="l712"></a><a href="#l712">712</a><td><tr><td><a id="l713"></a><a href="#l713">713</a><td><tr><td><a id="l714"></a><a href="#l714">714</a><td>/**<tr><td><a id="l715"></a><a href="#l715">715</a><td> * Fires a listener with a set of arguments<tr><td><a id="l716"></a><a href="#l716">716</a><td> *<tr><td><a id="l717"></a><a href="#l717">717</a><td> * @param {goog.events.Listener} listener The listener object to call.<tr><td><a id="l718"></a><a href="#l718">718</a><td> * @param {Object} eventObject The event object to pass to the listener.<tr><td><a id="l719"></a><a href="#l719">719</a><td> * @return {boolean} Result of listener.<tr><td><a id="l720"></a><a href="#l720">720</a><td> */<tr><td><a id="l721"></a><a href="#l721">721</a><td>goog.events.fireListener = function(listener, eventObject) {<tr><td><a id="l722"></a><a href="#l722">722</a><td>  var listenerFn = listener.listener;<tr><td><a id="l723"></a><a href="#l723">723</a><td>  var listenerHandler = listener.handler || listener.src;<tr><td><a id="l724"></a><a href="#l724">724</a><td><tr><td><a id="l725"></a><a href="#l725">725</a><td>  if (listener.callOnce) {<tr><td><a id="l726"></a><a href="#l726">726</a><td>    goog.events.unlistenByKey(listener);<tr><td><a id="l727"></a><a href="#l727">727</a><td>  }<tr><td><a id="l728"></a><a href="#l728">728</a><td>  return listenerFn.call(listenerHandler, eventObject);<tr><td><a id="l729"></a><a href="#l729">729</a><td>};<tr><td><a id="l730"></a><a href="#l730">730</a><td><tr><td><a id="l731"></a><a href="#l731">731</a><td><tr><td><a id="l732"></a><a href="#l732">732</a><td>/**<tr><td><a id="l733"></a><a href="#l733">733</a><td> * Gets the total number of listeners currently in the system.<tr><td><a id="l734"></a><a href="#l734">734</a><td> * @return {number} Number of listeners.<tr><td><a id="l735"></a><a href="#l735">735</a><td> * @deprecated This returns estimated count, now that Closure no longer<tr><td><a id="l736"></a><a href="#l736">736</a><td> * stores a central listener registry. We still return an estimation<tr><td><a id="l737"></a><a href="#l737">737</a><td> * to keep existing listener-related tests passing. In the near future,<tr><td><a id="l738"></a><a href="#l738">738</a><td> * this function will be removed.<tr><td><a id="l739"></a><a href="#l739">739</a><td> */<tr><td><a id="l740"></a><a href="#l740">740</a><td>goog.events.getTotalListenerCount = function() {<tr><td><a id="l741"></a><a href="#l741">741</a><td>  return goog.events.listenerCountEstimate_;<tr><td><a id="l742"></a><a href="#l742">742</a><td>};<tr><td><a id="l743"></a><a href="#l743">743</a><td><tr><td><a id="l744"></a><a href="#l744">744</a><td><tr><td><a id="l745"></a><a href="#l745">745</a><td>/**<tr><td><a id="l746"></a><a href="#l746">746</a><td> * Dispatches an event (or event like object) and calls all listeners<tr><td><a id="l747"></a><a href="#l747">747</a><td> * listening for events of this type. The type of the event is decided by the<tr><td><a id="l748"></a><a href="#l748">748</a><td> * type property on the event object.<tr><td><a id="l749"></a><a href="#l749">749</a><td> *<tr><td><a id="l750"></a><a href="#l750">750</a><td> * If any of the listeners returns false OR calls preventDefault then this<tr><td><a id="l751"></a><a href="#l751">751</a><td> * function will return false.  If one of the capture listeners calls<tr><td><a id="l752"></a><a href="#l752">752</a><td> * stopPropagation, then the bubble listeners won&#39;t fire.<tr><td><a id="l753"></a><a href="#l753">753</a><td> *<tr><td><a id="l754"></a><a href="#l754">754</a><td> * @param {goog.events.Listenable} src The event target.<tr><td><a id="l755"></a><a href="#l755">755</a><td> * @param {goog.events.EventLike} e Event object.<tr><td><a id="l756"></a><a href="#l756">756</a><td> * @return {boolean} If anyone called preventDefault on the event object (or<tr><td><a id="l757"></a><a href="#l757">757</a><td> *     if any of the handlers returns false) this will also return false.<tr><td><a id="l758"></a><a href="#l758">758</a><td> *     If there are no handlers, or if all handlers return true, this returns<tr><td><a id="l759"></a><a href="#l759">759</a><td> *     true.<tr><td><a id="l760"></a><a href="#l760">760</a><td> */<tr><td><a id="l761"></a><a href="#l761">761</a><td>goog.events.dispatchEvent = function(src, e) {<tr><td><a id="l762"></a><a href="#l762">762</a><td>  goog.asserts.assert(<tr><td><a id="l763"></a><a href="#l763">763</a><td>      goog.events.Listenable.isImplementedBy(src),<tr><td><a id="l764"></a><a href="#l764">764</a><td>      &#39;Can not use goog.events.dispatchEvent with &#39; +<tr><td><a id="l765"></a><a href="#l765">765</a><td>      &#39;non-goog.events.Listenable instance.&#39;);<tr><td><a id="l766"></a><a href="#l766">766</a><td>  return src.dispatchEvent(e);<tr><td><a id="l767"></a><a href="#l767">767</a><td>};<tr><td><a id="l768"></a><a href="#l768">768</a><td><tr><td><a id="l769"></a><a href="#l769">769</a><td><tr><td><a id="l770"></a><a href="#l770">770</a><td>/**<tr><td><a id="l771"></a><a href="#l771">771</a><td> * Installs exception protection for the browser event entry point using the<tr><td><a id="l772"></a><a href="#l772">772</a><td> * given error handler.<tr><td><a id="l773"></a><a href="#l773">773</a><td> *<tr><td><a id="l774"></a><a href="#l774">774</a><td> * @param {goog.debug.ErrorHandler} errorHandler Error handler with which to<tr><td><a id="l775"></a><a href="#l775">775</a><td> *     protect the entry point.<tr><td><a id="l776"></a><a href="#l776">776</a><td> */<tr><td><a id="l777"></a><a href="#l777">777</a><td>goog.events.protectBrowserEventEntryPoint = function(errorHandler) {<tr><td><a id="l778"></a><a href="#l778">778</a><td>  goog.events.handleBrowserEvent_ = errorHandler.protectEntryPoint(<tr><td><a id="l779"></a><a href="#l779">779</a><td>      goog.events.handleBrowserEvent_);<tr><td><a id="l780"></a><a href="#l780">780</a><td>};<tr><td><a id="l781"></a><a href="#l781">781</a><td><tr><td><a id="l782"></a><a href="#l782">782</a><td><tr><td><a id="l783"></a><a href="#l783">783</a><td>/**<tr><td><a id="l784"></a><a href="#l784">784</a><td> * Handles an event and dispatches it to the correct listeners. This<tr><td><a id="l785"></a><a href="#l785">785</a><td> * function is a proxy for the real listener the user specified.<tr><td><a id="l786"></a><a href="#l786">786</a><td> *<tr><td><a id="l787"></a><a href="#l787">787</a><td> * @param {goog.events.Listener} listener The listener object.<tr><td><a id="l788"></a><a href="#l788">788</a><td> * @param {Event=} opt_evt Optional event object that gets passed in via the<tr><td><a id="l789"></a><a href="#l789">789</a><td> *     native event handlers.<tr><td><a id="l790"></a><a href="#l790">790</a><td> * @return {boolean} Result of the event handler.<tr><td><a id="l791"></a><a href="#l791">791</a><td> * @this {EventTarget} The object or Element that fired the event.<tr><td><a id="l792"></a><a href="#l792">792</a><td> * @private<tr><td><a id="l793"></a><a href="#l793">793</a><td> */<tr><td><a id="l794"></a><a href="#l794">794</a><td>goog.events.handleBrowserEvent_ = function(listener, opt_evt) {<tr><td><a id="l795"></a><a href="#l795">795</a><td>  if (listener.removed) {<tr><td><a id="l796"></a><a href="#l796">796</a><td>    return true;<tr><td><a id="l797"></a><a href="#l797">797</a><td>  }<tr><td><a id="l798"></a><a href="#l798">798</a><td><tr><td><a id="l799"></a><a href="#l799">799</a><td>  // Synthesize event propagation if the browser does not support W3C<tr><td><a id="l800"></a><a href="#l800">800</a><td>  // event model.<tr><td><a id="l801"></a><a href="#l801">801</a><td>  if (!goog.events.BrowserFeature.HAS_W3C_EVENT_SUPPORT) {<tr><td><a id="l802"></a><a href="#l802">802</a><td>    var ieEvent = opt_evt ||<tr><td><a id="l803"></a><a href="#l803">803</a><td>        /** @type {Event} */ (goog.getObjectByName(&#39;window.event&#39;));<tr><td><a id="l804"></a><a href="#l804">804</a><td>    var evt = new goog.events.BrowserEvent(ieEvent, this);<tr><td><a id="l805"></a><a href="#l805">805</a><td>    /** @type {boolean} */<tr><td><a id="l806"></a><a href="#l806">806</a><td>    var retval = true;<tr><td><a id="l807"></a><a href="#l807">807</a><td><tr><td><a id="l808"></a><a href="#l808">808</a><td>    if (goog.events.CAPTURE_SIMULATION_MODE ==<tr><td><a id="l809"></a><a href="#l809">809</a><td>            goog.events.CaptureSimulationMode.ON) {<tr><td><a id="l810"></a><a href="#l810">810</a><td>      // If we have not marked this event yet, we should perform capture<tr><td><a id="l811"></a><a href="#l811">811</a><td>      // simulation.<tr><td><a id="l812"></a><a href="#l812">812</a><td>      if (!goog.events.isMarkedIeEvent_(ieEvent)) {<tr><td><a id="l813"></a><a href="#l813">813</a><td>        goog.events.markIeEvent_(ieEvent);<tr><td><a id="l814"></a><a href="#l814">814</a><td><tr><td><a id="l815"></a><a href="#l815">815</a><td>        var ancestors = [];<tr><td><a id="l816"></a><a href="#l816">816</a><td>        for (var parent = evt.currentTarget; parent;<tr><td><a id="l817"></a><a href="#l817">817</a><td>             parent = parent.parentNode) {<tr><td><a id="l818"></a><a href="#l818">818</a><td>          ancestors.push(parent);<tr><td><a id="l819"></a><a href="#l819">819</a><td>        }<tr><td><a id="l820"></a><a href="#l820">820</a><td><tr><td><a id="l821"></a><a href="#l821">821</a><td>        // Fire capture listeners.<tr><td><a id="l822"></a><a href="#l822">822</a><td>        var type = listener.type;<tr><td><a id="l823"></a><a href="#l823">823</a><td>        for (var i = ancestors.length - 1; !evt.propagationStopped_ &amp;&amp; i &gt;= 0;<tr><td><a id="l824"></a><a href="#l824">824</a><td>             i--) {<tr><td><a id="l825"></a><a href="#l825">825</a><td>          evt.currentTarget = ancestors[i];<tr><td><a id="l826"></a><a href="#l826">826</a><td>          var result = goog.events.fireListeners_(ancestors[i], type, true, evt);<tr><td><a id="l827"></a><a href="#l827">827</a><td>          retval = retval &amp;&amp; result;<tr><td><a id="l828"></a><a href="#l828">828</a><td>        }<tr><td><a id="l829"></a><a href="#l829">829</a><td><tr><td><a id="l830"></a><a href="#l830">830</a><td>        // Fire bubble listeners.<tr><td><a id="l831"></a><a href="#l831">831</a><td>        //<tr><td><a id="l832"></a><a href="#l832">832</a><td>        // We can technically rely on IE to perform bubble event<tr><td><a id="l833"></a><a href="#l833">833</a><td>        // propagation. However, it turns out that IE fires events in<tr><td><a id="l834"></a><a href="#l834">834</a><td>        // opposite order of attachEvent registration, which broke<tr><td><a id="l835"></a><a href="#l835">835</a><td>        // some code and tests that rely on the order. (While W3C DOM<tr><td><a id="l836"></a><a href="#l836">836</a><td>        // Level 2 Events TR leaves the event ordering unspecified,<tr><td><a id="l837"></a><a href="#l837">837</a><td>        // modern browsers and W3C DOM Level 3 Events Working Draft<tr><td><a id="l838"></a><a href="#l838">838</a><td>        // actually specify the order as the registration order.)<tr><td><a id="l839"></a><a href="#l839">839</a><td>        for (var i = 0; !evt.propagationStopped_ &amp;&amp; i &lt; ancestors.length; i++) {<tr><td><a id="l840"></a><a href="#l840">840</a><td>          evt.currentTarget = ancestors[i];<tr><td><a id="l841"></a><a href="#l841">841</a><td>          var result = goog.events.fireListeners_(ancestors[i], type, false, evt);<tr><td><a id="l842"></a><a href="#l842">842</a><td>          retval = retval &amp;&amp; result;<tr><td><a id="l843"></a><a href="#l843">843</a><td>        }<tr><td><a id="l844"></a><a href="#l844">844</a><td>      }<tr><td><a id="l845"></a><a href="#l845">845</a><td>    } else {<tr><td><a id="l846"></a><a href="#l846">846</a><td>      retval = goog.events.fireListener(listener, evt);<tr><td><a id="l847"></a><a href="#l847">847</a><td>    }<tr><td><a id="l848"></a><a href="#l848">848</a><td>    return retval;<tr><td><a id="l849"></a><a href="#l849">849</a><td>  }<tr><td><a id="l850"></a><a href="#l850">850</a><td><tr><td><a id="l851"></a><a href="#l851">851</a><td>  // Otherwise, simply fire the listener.<tr><td><a id="l852"></a><a href="#l852">852</a><td>  return goog.events.fireListener(<tr><td><a id="l853"></a><a href="#l853">853</a><td>      listener, new goog.events.BrowserEvent(opt_evt, this));<tr><td><a id="l854"></a><a href="#l854">854</a><td>};<tr><td><a id="l855"></a><a href="#l855">855</a><td><tr><td><a id="l856"></a><a href="#l856">856</a><td><tr><td><a id="l857"></a><a href="#l857">857</a><td>/**<tr><td><a id="l858"></a><a href="#l858">858</a><td> * This is used to mark the IE event object so we do not do the Closure pass<tr><td><a id="l859"></a><a href="#l859">859</a><td> * twice for a bubbling event.<tr><td><a id="l860"></a><a href="#l860">860</a><td> * @param {Event} e The IE browser event.<tr><td><a id="l861"></a><a href="#l861">861</a><td> * @private<tr><td><a id="l862"></a><a href="#l862">862</a><td> */<tr><td><a id="l863"></a><a href="#l863">863</a><td>goog.events.markIeEvent_ = function(e) {<tr><td><a id="l864"></a><a href="#l864">864</a><td>  // Only the keyCode and the returnValue can be changed. We use keyCode for<tr><td><a id="l865"></a><a href="#l865">865</a><td>  // non keyboard events.<tr><td><a id="l866"></a><a href="#l866">866</a><td>  // event.returnValue is a bit more tricky. It is undefined by default. A<tr><td><a id="l867"></a><a href="#l867">867</a><td>  // boolean false prevents the default action. In a window.onbeforeunload and<tr><td><a id="l868"></a><a href="#l868">868</a><td>  // the returnValue is non undefined it will be alerted. However, we will only<tr><td><a id="l869"></a><a href="#l869">869</a><td>  // modify the returnValue for keyboard events. We can get a problem if non<tr><td><a id="l870"></a><a href="#l870">870</a><td>  // closure events sets the keyCode or the returnValue<tr><td><a id="l871"></a><a href="#l871">871</a><td><tr><td><a id="l872"></a><a href="#l872">872</a><td>  var useReturnValue = false;<tr><td><a id="l873"></a><a href="#l873">873</a><td><tr><td><a id="l874"></a><a href="#l874">874</a><td>  if (e.keyCode == 0) {<tr><td><a id="l875"></a><a href="#l875">875</a><td>    // We cannot change the keyCode in case that srcElement is input[type=file].<tr><td><a id="l876"></a><a href="#l876">876</a><td>    // We could test that that is the case but that would allocate 3 objects.<tr><td><a id="l877"></a><a href="#l877">877</a><td>    // If we use try/catch we will only allocate extra objects in the case of a<tr><td><a id="l878"></a><a href="#l878">878</a><td>    // failure.<tr><td><a id="l879"></a><a href="#l879">879</a><td>    /** @preserveTry */<tr><td><a id="l880"></a><a href="#l880">880</a><td>    try {<tr><td><a id="l881"></a><a href="#l881">881</a><td>      e.keyCode = -1;<tr><td><a id="l882"></a><a href="#l882">882</a><td>      return;<tr><td><a id="l883"></a><a href="#l883">883</a><td>    } catch (ex) {<tr><td><a id="l884"></a><a href="#l884">884</a><td>      useReturnValue = true;<tr><td><a id="l885"></a><a href="#l885">885</a><td>    }<tr><td><a id="l886"></a><a href="#l886">886</a><td>  }<tr><td><a id="l887"></a><a href="#l887">887</a><td><tr><td><a id="l888"></a><a href="#l888">888</a><td>  if (useReturnValue ||<tr><td><a id="l889"></a><a href="#l889">889</a><td>      /** @type {boolean|undefined} */ (e.returnValue) == undefined) {<tr><td><a id="l890"></a><a href="#l890">890</a><td>    e.returnValue = true;<tr><td><a id="l891"></a><a href="#l891">891</a><td>  }<tr><td><a id="l892"></a><a href="#l892">892</a><td>};<tr><td><a id="l893"></a><a href="#l893">893</a><td><tr><td><a id="l894"></a><a href="#l894">894</a><td><tr><td><a id="l895"></a><a href="#l895">895</a><td>/**<tr><td><a id="l896"></a><a href="#l896">896</a><td> * This is used to check if an IE event has already been handled by the Closure<tr><td><a id="l897"></a><a href="#l897">897</a><td> * system so we do not do the Closure pass twice for a bubbling event.<tr><td><a id="l898"></a><a href="#l898">898</a><td> * @param {Event} e  The IE browser event.<tr><td><a id="l899"></a><a href="#l899">899</a><td> * @return {boolean} True if the event object has been marked.<tr><td><a id="l900"></a><a href="#l900">900</a><td> * @private<tr><td><a id="l901"></a><a href="#l901">901</a><td> */<tr><td><a id="l902"></a><a href="#l902">902</a><td>goog.events.isMarkedIeEvent_ = function(e) {<tr><td><a id="l903"></a><a href="#l903">903</a><td>  return e.keyCode &lt; 0 || e.returnValue != undefined;<tr><td><a id="l904"></a><a href="#l904">904</a><td>};<tr><td><a id="l905"></a><a href="#l905">905</a><td><tr><td><a id="l906"></a><a href="#l906">906</a><td><tr><td><a id="l907"></a><a href="#l907">907</a><td>/**<tr><td><a id="l908"></a><a href="#l908">908</a><td> * Counter to create unique event ids.<tr><td><a id="l909"></a><a href="#l909">909</a><td> * @private {number}<tr><td><a id="l910"></a><a href="#l910">910</a><td> */<tr><td><a id="l911"></a><a href="#l911">911</a><td>goog.events.uniqueIdCounter_ = 0;<tr><td><a id="l912"></a><a href="#l912">912</a><td><tr><td><a id="l913"></a><a href="#l913">913</a><td><tr><td><a id="l914"></a><a href="#l914">914</a><td>/**<tr><td><a id="l915"></a><a href="#l915">915</a><td> * Creates a unique event id.<tr><td><a id="l916"></a><a href="#l916">916</a><td> *<tr><td><a id="l917"></a><a href="#l917">917</a><td> * @param {string} identifier The identifier.<tr><td><a id="l918"></a><a href="#l918">918</a><td> * @return {string} A unique identifier.<tr><td><a id="l919"></a><a href="#l919">919</a><td> * @idGenerator<tr><td><a id="l920"></a><a href="#l920">920</a><td> */<tr><td><a id="l921"></a><a href="#l921">921</a><td>goog.events.getUniqueId = function(identifier) {<tr><td><a id="l922"></a><a href="#l922">922</a><td>  return identifier + &#39;_&#39; + goog.events.uniqueIdCounter_++;<tr><td><a id="l923"></a><a href="#l923">923</a><td>};<tr><td><a id="l924"></a><a href="#l924">924</a><td><tr><td><a id="l925"></a><a href="#l925">925</a><td><tr><td><a id="l926"></a><a href="#l926">926</a><td>/**<tr><td><a id="l927"></a><a href="#l927">927</a><td> * @param {EventTarget} src The source object.<tr><td><a id="l928"></a><a href="#l928">928</a><td> * @return {goog.events.ListenerMap} A listener map for the given<tr><td><a id="l929"></a><a href="#l929">929</a><td> *     source object, or null if none exists.<tr><td><a id="l930"></a><a href="#l930">930</a><td> * @private<tr><td><a id="l931"></a><a href="#l931">931</a><td> */<tr><td><a id="l932"></a><a href="#l932">932</a><td>goog.events.getListenerMap_ = function(src) {<tr><td><a id="l933"></a><a href="#l933">933</a><td>  var listenerMap = src[goog.events.LISTENER_MAP_PROP_];<tr><td><a id="l934"></a><a href="#l934">934</a><td>  // IE serializes the property as well (e.g. when serializing outer<tr><td><a id="l935"></a><a href="#l935">935</a><td>  // HTML). So we must check that the value is of the correct type.<tr><td><a id="l936"></a><a href="#l936">936</a><td>  return listenerMap instanceof goog.events.ListenerMap ? listenerMap : null;<tr><td><a id="l937"></a><a href="#l937">937</a><td>};<tr><td><a id="l938"></a><a href="#l938">938</a><td><tr><td><a id="l939"></a><a href="#l939">939</a><td><tr><td><a id="l940"></a><a href="#l940">940</a><td>/**<tr><td><a id="l941"></a><a href="#l941">941</a><td> * Expando property for listener function wrapper for Object with<tr><td><a id="l942"></a><a href="#l942">942</a><td> * handleEvent.<tr><td><a id="l943"></a><a href="#l943">943</a><td> * @private @const {string}<tr><td><a id="l944"></a><a href="#l944">944</a><td> */<tr><td><a id="l945"></a><a href="#l945">945</a><td>goog.events.LISTENER_WRAPPER_PROP_ = &#39;__closure_events_fn_&#39; +<tr><td><a id="l946"></a><a href="#l946">946</a><td>    ((Math.random() * 1e9) &gt;&gt;&gt; 0);<tr><td><a id="l947"></a><a href="#l947">947</a><td><tr><td><a id="l948"></a><a href="#l948">948</a><td><tr><td><a id="l949"></a><a href="#l949">949</a><td>/**<tr><td><a id="l950"></a><a href="#l950">950</a><td> * @param {Object|Function} listener The listener function or an<tr><td><a id="l951"></a><a href="#l951">951</a><td> *     object that contains handleEvent method.<tr><td><a id="l952"></a><a href="#l952">952</a><td> * @return {!Function} Either the original function or a function that<tr><td><a id="l953"></a><a href="#l953">953</a><td> *     calls obj.handleEvent. If the same listener is passed to this<tr><td><a id="l954"></a><a href="#l954">954</a><td> *     function more than once, the same function is guaranteed to be<tr><td><a id="l955"></a><a href="#l955">955</a><td> *     returned.<tr><td><a id="l956"></a><a href="#l956">956</a><td> */<tr><td><a id="l957"></a><a href="#l957">957</a><td>goog.events.wrapListener = function(listener) {<tr><td><a id="l958"></a><a href="#l958">958</a><td>  goog.asserts.assert(listener, &#39;Listener can not be null.&#39;);<tr><td><a id="l959"></a><a href="#l959">959</a><td><tr><td><a id="l960"></a><a href="#l960">960</a><td>  if (goog.isFunction(listener)) {<tr><td><a id="l961"></a><a href="#l961">961</a><td>    return listener;<tr><td><a id="l962"></a><a href="#l962">962</a><td>  }<tr><td><a id="l963"></a><a href="#l963">963</a><td><tr><td><a id="l964"></a><a href="#l964">964</a><td>  goog.asserts.assert(<tr><td><a id="l965"></a><a href="#l965">965</a><td>      listener.handleEvent, &#39;An object listener must have handleEvent method.&#39;);<tr><td><a id="l966"></a><a href="#l966">966</a><td>  if (!listener[goog.events.LISTENER_WRAPPER_PROP_]) {<tr><td><a id="l967"></a><a href="#l967">967</a><td>    listener[goog.events.LISTENER_WRAPPER_PROP_] =<tr><td><a id="l968"></a><a href="#l968">968</a><td>        function(e) { return listener.handleEvent(e); };<tr><td><a id="l969"></a><a href="#l969">969</a><td>  }<tr><td><a id="l970"></a><a href="#l970">970</a><td>  return listener[goog.events.LISTENER_WRAPPER_PROP_];<tr><td><a id="l971"></a><a href="#l971">971</a><td>};<tr><td><a id="l972"></a><a href="#l972">972</a><td><tr><td><a id="l973"></a><a href="#l973">973</a><td><tr><td><a id="l974"></a><a href="#l974">974</a><td>// Register the browser event handler as an entry point, so that<tr><td><a id="l975"></a><a href="#l975">975</a><td>// it can be monitored for exception handling, etc.<tr><td><a id="l976"></a><a href="#l976">976</a><td>goog.debug.entryPointRegistry.register(<tr><td><a id="l977"></a><a href="#l977">977</a><td>    /**<tr><td><a id="l978"></a><a href="#l978">978</a><td>     * @param {function(!Function): !Function} transformer The transforming<tr><td><a id="l979"></a><a href="#l979">979</a><td>     *     function.<tr><td><a id="l980"></a><a href="#l980">980</a><td>     */<tr><td><a id="l981"></a><a href="#l981">981</a><td>    function(transformer) {<tr><td><a id="l982"></a><a href="#l982">982</a><td>      goog.events.handleBrowserEvent_ = transformer(<tr><td><a id="l983"></a><a href="#l983">983</a><td>          goog.events.handleBrowserEvent_);<tr><td><a id="l984"></a><a href="#l984">984</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/eventtarget.js.src.html b/docs/source/lib/goog/events/eventtarget.js.src.html
new file mode 100644
index 0000000..ea50cac
--- /dev/null
+++ b/docs/source/lib/goog/events/eventtarget.js.src.html
@@ -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>eventtarget.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/events/eventtarget.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2005 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A disposable implementation of a custom<tr><td><a id="l17"></a><a href="#l17">17</a><td> * listenable/event target. See also: documentation for<tr><td><a id="l18"></a><a href="#l18">18</a><td> * {@code goog.events.Listenable}.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * @author arv@google.com (Erik Arvidsson) [Original implementation]<tr><td><a id="l21"></a><a href="#l21">21</a><td> * @see ../demos/eventtarget.html<tr><td><a id="l22"></a><a href="#l22">22</a><td> * @see goog.events.Listenable<tr><td><a id="l23"></a><a href="#l23">23</a><td> */<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.events.EventTarget&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.Disposable&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.events&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.events.Event&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.events.Listenable&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.events.ListenerMap&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;goog.object&#39;);<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>/**<tr><td><a id="l38"></a><a href="#l38">38</a><td> * An implementation of {@code goog.events.Listenable} with full W3C<tr><td><a id="l39"></a><a href="#l39">39</a><td> * EventTarget-like support (capture/bubble mechanism, stopping event<tr><td><a id="l40"></a><a href="#l40">40</a><td> * propagation, preventing default actions).<tr><td><a id="l41"></a><a href="#l41">41</a><td> *<tr><td><a id="l42"></a><a href="#l42">42</a><td> * You may subclass this class to turn your class into a Listenable.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * Unless propagation is stopped, an event dispatched by an<tr><td><a id="l45"></a><a href="#l45">45</a><td> * EventTarget will bubble to the parent returned by<tr><td><a id="l46"></a><a href="#l46">46</a><td> * {@code getParentEventTarget}. To set the parent, call<tr><td><a id="l47"></a><a href="#l47">47</a><td> * {@code setParentEventTarget}. Subclasses that don&#39;t support<tr><td><a id="l48"></a><a href="#l48">48</a><td> * changing the parent can override the setter to throw an error.<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> * Example usage:<tr><td><a id="l51"></a><a href="#l51">51</a><td> * &lt;pre&gt;<tr><td><a id="l52"></a><a href="#l52">52</a><td> *   var source = new goog.events.EventTarget();<tr><td><a id="l53"></a><a href="#l53">53</a><td> *   function handleEvent(e) {<tr><td><a id="l54"></a><a href="#l54">54</a><td> *     alert(&#39;Type: &#39; + e.type + &#39;; Target: &#39; + e.target);<tr><td><a id="l55"></a><a href="#l55">55</a><td> *   }<tr><td><a id="l56"></a><a href="#l56">56</a><td> *   source.listen(&#39;foo&#39;, handleEvent);<tr><td><a id="l57"></a><a href="#l57">57</a><td> *   // Or: goog.events.listen(source, &#39;foo&#39;, handleEvent);<tr><td><a id="l58"></a><a href="#l58">58</a><td> *   ...<tr><td><a id="l59"></a><a href="#l59">59</a><td> *   source.dispatchEvent(&#39;foo&#39;);  // will call handleEvent<tr><td><a id="l60"></a><a href="#l60">60</a><td> *   ...<tr><td><a id="l61"></a><a href="#l61">61</a><td> *   source.unlisten(&#39;foo&#39;, handleEvent);<tr><td><a id="l62"></a><a href="#l62">62</a><td> *   // Or: goog.events.unlisten(source, &#39;foo&#39;, handleEvent);<tr><td><a id="l63"></a><a href="#l63">63</a><td> * &lt;/pre&gt;<tr><td><a id="l64"></a><a href="#l64">64</a><td> *<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @constructor<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @extends {goog.Disposable}<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @implements {goog.events.Listenable}<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.events.EventTarget = function() {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  goog.Disposable.call(this);<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>   * Maps of event type to an array of listeners.<tr><td><a id="l74"></a><a href="#l74">74</a><td>   * @private {!goog.events.ListenerMap}<tr><td><a id="l75"></a><a href="#l75">75</a><td>   */<tr><td><a id="l76"></a><a href="#l76">76</a><td>  this.eventTargetListeners_ = new goog.events.ListenerMap(this);<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>   * The object to use for event.target. Useful when mixing in an<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * EventTarget to another object.<tr><td><a id="l81"></a><a href="#l81">81</a><td>   * @private {!Object}<tr><td><a id="l82"></a><a href="#l82">82</a><td>   */<tr><td><a id="l83"></a><a href="#l83">83</a><td>  this.actualEventTarget_ = this;<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>   * Parent event target, used during event bubbling.<tr><td><a id="l87"></a><a href="#l87">87</a><td>   *<tr><td><a id="l88"></a><a href="#l88">88</a><td>   * TODO(chrishenry): Change this to goog.events.Listenable. This<tr><td><a id="l89"></a><a href="#l89">89</a><td>   * currently breaks people who expect getParentEventTarget to return<tr><td><a id="l90"></a><a href="#l90">90</a><td>   * goog.events.EventTarget.<tr><td><a id="l91"></a><a href="#l91">91</a><td>   *<tr><td><a id="l92"></a><a href="#l92">92</a><td>   * @private {goog.events.EventTarget}<tr><td><a id="l93"></a><a href="#l93">93</a><td>   */<tr><td><a id="l94"></a><a href="#l94">94</a><td>  this.parentEventTarget_ = null;<tr><td><a id="l95"></a><a href="#l95">95</a><td>};<tr><td><a id="l96"></a><a href="#l96">96</a><td>goog.inherits(goog.events.EventTarget, goog.Disposable);<tr><td><a id="l97"></a><a href="#l97">97</a><td>goog.events.Listenable.addImplementation(goog.events.EventTarget);<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * An artificial cap on the number of ancestors you can have. This is mainly<tr><td><a id="l102"></a><a href="#l102">102</a><td> * for loop detection.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @const {number}<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @private<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.events.EventTarget.MAX_ANCESTORS_ = 1000;<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> * Returns the parent of this event target to use for bubbling.<tr><td><a id="l111"></a><a href="#l111">111</a><td> *<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @return {goog.events.EventTarget} The parent EventTarget or null if<tr><td><a id="l113"></a><a href="#l113">113</a><td> *     there is no parent.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @override<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.events.EventTarget.prototype.getParentEventTarget = function() {<tr><td><a id="l117"></a><a href="#l117">117</a><td>  return this.parentEventTarget_;<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>/**<tr><td><a id="l122"></a><a href="#l122">122</a><td> * Sets the parent of this event target to use for capture/bubble<tr><td><a id="l123"></a><a href="#l123">123</a><td> * mechanism.<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {goog.events.EventTarget} parent Parent listenable (null if none).<tr><td><a id="l125"></a><a href="#l125">125</a><td> */<tr><td><a id="l126"></a><a href="#l126">126</a><td>goog.events.EventTarget.prototype.setParentEventTarget = function(parent) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>  this.parentEventTarget_ = parent;<tr><td><a id="l128"></a><a href="#l128">128</a><td>};<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>/**<tr><td><a id="l132"></a><a href="#l132">132</a><td> * Adds an event listener to the event target. The same handler can only be<tr><td><a id="l133"></a><a href="#l133">133</a><td> * added once per the type. Even if you add the same handler multiple times<tr><td><a id="l134"></a><a href="#l134">134</a><td> * using the same type then it will only be called once when the event is<tr><td><a id="l135"></a><a href="#l135">135</a><td> * dispatched.<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @param {string} type The type of the event to listen for.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @param {function(?):?|{handleEvent:function(?):?}|null} handler The function<tr><td><a id="l139"></a><a href="#l139">139</a><td> *     to handle the event. The handler can also be an object that implements<tr><td><a id="l140"></a><a href="#l140">140</a><td> *     the handleEvent method which takes the event object as argument.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {boolean=} opt_capture In DOM-compliant browsers, this determines<tr><td><a id="l142"></a><a href="#l142">142</a><td> *     whether the listener is fired during the capture or bubble phase<tr><td><a id="l143"></a><a href="#l143">143</a><td> *     of the event.<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @param {Object=} opt_handlerScope Object in whose scope to call<tr><td><a id="l145"></a><a href="#l145">145</a><td> *     the listener.<tr><td><a id="l146"></a><a href="#l146">146</a><td> * @deprecated Use {@code #listen} instead, when possible. Otherwise, use<tr><td><a id="l147"></a><a href="#l147">147</a><td> *     {@code goog.events.listen} if you are passing Object<tr><td><a id="l148"></a><a href="#l148">148</a><td> *     (instead of Function) as handler.<tr><td><a id="l149"></a><a href="#l149">149</a><td> */<tr><td><a id="l150"></a><a href="#l150">150</a><td>goog.events.EventTarget.prototype.addEventListener = function(<tr><td><a id="l151"></a><a href="#l151">151</a><td>    type, handler, opt_capture, opt_handlerScope) {<tr><td><a id="l152"></a><a href="#l152">152</a><td>  goog.events.listen(this, type, handler, opt_capture, opt_handlerScope);<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> * Removes an event listener from the event target. The handler must be the<tr><td><a id="l158"></a><a href="#l158">158</a><td> * same object as the one added. If the handler has not been added then<tr><td><a id="l159"></a><a href="#l159">159</a><td> * nothing is done.<tr><td><a id="l160"></a><a href="#l160">160</a><td> *<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @param {string} type The type of the event to listen for.<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @param {function(?):?|{handleEvent:function(?):?}|null} handler The function<tr><td><a id="l163"></a><a href="#l163">163</a><td> *     to handle the event. The handler can also be an object that implements<tr><td><a id="l164"></a><a href="#l164">164</a><td> *     the handleEvent method which takes the event object as argument.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {boolean=} opt_capture In DOM-compliant browsers, this determines<tr><td><a id="l166"></a><a href="#l166">166</a><td> *     whether the listener is fired during the capture or bubble phase<tr><td><a id="l167"></a><a href="#l167">167</a><td> *     of the event.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @param {Object=} opt_handlerScope Object in whose scope to call<tr><td><a id="l169"></a><a href="#l169">169</a><td> *     the listener.<tr><td><a id="l170"></a><a href="#l170">170</a><td> * @deprecated Use {@code #unlisten} instead, when possible. Otherwise, use<tr><td><a id="l171"></a><a href="#l171">171</a><td> *     {@code goog.events.unlisten} if you are passing Object<tr><td><a id="l172"></a><a href="#l172">172</a><td> *     (instead of Function) as handler.<tr><td><a id="l173"></a><a href="#l173">173</a><td> */<tr><td><a id="l174"></a><a href="#l174">174</a><td>goog.events.EventTarget.prototype.removeEventListener = function(<tr><td><a id="l175"></a><a href="#l175">175</a><td>    type, handler, opt_capture, opt_handlerScope) {<tr><td><a id="l176"></a><a href="#l176">176</a><td>  goog.events.unlisten(this, type, handler, opt_capture, opt_handlerScope);<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>/** @override */<tr><td><a id="l181"></a><a href="#l181">181</a><td>goog.events.EventTarget.prototype.dispatchEvent = function(e) {<tr><td><a id="l182"></a><a href="#l182">182</a><td>  this.assertInitialized_();<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td>  var ancestorsTree, ancestor = this.getParentEventTarget();<tr><td><a id="l185"></a><a href="#l185">185</a><td>  if (ancestor) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>    ancestorsTree = [];<tr><td><a id="l187"></a><a href="#l187">187</a><td>    var ancestorCount = 1;<tr><td><a id="l188"></a><a href="#l188">188</a><td>    for (; ancestor; ancestor = ancestor.getParentEventTarget()) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>      ancestorsTree.push(ancestor);<tr><td><a id="l190"></a><a href="#l190">190</a><td>      goog.asserts.assert(<tr><td><a id="l191"></a><a href="#l191">191</a><td>          (++ancestorCount &lt; goog.events.EventTarget.MAX_ANCESTORS_),<tr><td><a id="l192"></a><a href="#l192">192</a><td>          &#39;infinite loop&#39;);<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><tr><td><a id="l196"></a><a href="#l196">196</a><td>  return goog.events.EventTarget.dispatchEventInternal_(<tr><td><a id="l197"></a><a href="#l197">197</a><td>      this.actualEventTarget_, e, ancestorsTree);<tr><td><a id="l198"></a><a href="#l198">198</a><td>};<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> * Removes listeners from this object.  Classes that extend EventTarget may<tr><td><a id="l203"></a><a href="#l203">203</a><td> * need to override this method in order to remove references to DOM Elements<tr><td><a id="l204"></a><a href="#l204">204</a><td> * and additional listeners.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @override<tr><td><a id="l206"></a><a href="#l206">206</a><td> */<tr><td><a id="l207"></a><a href="#l207">207</a><td>goog.events.EventTarget.prototype.disposeInternal = function() {<tr><td><a id="l208"></a><a href="#l208">208</a><td>  goog.events.EventTarget.superClass_.disposeInternal.call(this);<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td>  this.removeAllListeners();<tr><td><a id="l211"></a><a href="#l211">211</a><td>  this.parentEventTarget_ = null;<tr><td><a id="l212"></a><a href="#l212">212</a><td>};<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/** @override */<tr><td><a id="l216"></a><a href="#l216">216</a><td>goog.events.EventTarget.prototype.listen = function(<tr><td><a id="l217"></a><a href="#l217">217</a><td>    type, listener, opt_useCapture, opt_listenerScope) {<tr><td><a id="l218"></a><a href="#l218">218</a><td>  this.assertInitialized_();<tr><td><a id="l219"></a><a href="#l219">219</a><td>  return this.eventTargetListeners_.add(<tr><td><a id="l220"></a><a href="#l220">220</a><td>      String(type), listener, false /* callOnce */, opt_useCapture,<tr><td><a id="l221"></a><a href="#l221">221</a><td>      opt_listenerScope);<tr><td><a id="l222"></a><a href="#l222">222</a><td>};<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td>/** @override */<tr><td><a id="l226"></a><a href="#l226">226</a><td>goog.events.EventTarget.prototype.listenOnce = function(<tr><td><a id="l227"></a><a href="#l227">227</a><td>    type, listener, opt_useCapture, opt_listenerScope) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>  return this.eventTargetListeners_.add(<tr><td><a id="l229"></a><a href="#l229">229</a><td>      String(type), listener, true /* callOnce */, opt_useCapture,<tr><td><a id="l230"></a><a href="#l230">230</a><td>      opt_listenerScope);<tr><td><a id="l231"></a><a href="#l231">231</a><td>};<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>/** @override */<tr><td><a id="l235"></a><a href="#l235">235</a><td>goog.events.EventTarget.prototype.unlisten = function(<tr><td><a id="l236"></a><a href="#l236">236</a><td>    type, listener, opt_useCapture, opt_listenerScope) {<tr><td><a id="l237"></a><a href="#l237">237</a><td>  return this.eventTargetListeners_.remove(<tr><td><a id="l238"></a><a href="#l238">238</a><td>      String(type), listener, opt_useCapture, opt_listenerScope);<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><tr><td><a id="l242"></a><a href="#l242">242</a><td>/** @override */<tr><td><a id="l243"></a><a href="#l243">243</a><td>goog.events.EventTarget.prototype.unlistenByKey = function(key) {<tr><td><a id="l244"></a><a href="#l244">244</a><td>  return this.eventTargetListeners_.removeByKey(key);<tr><td><a id="l245"></a><a href="#l245">245</a><td>};<tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td>/** @override */<tr><td><a id="l249"></a><a href="#l249">249</a><td>goog.events.EventTarget.prototype.removeAllListeners = function(opt_type) {<tr><td><a id="l250"></a><a href="#l250">250</a><td>  // TODO(chrishenry): Previously, removeAllListeners can be called on<tr><td><a id="l251"></a><a href="#l251">251</a><td>  // uninitialized EventTarget, so we preserve that behavior. We<tr><td><a id="l252"></a><a href="#l252">252</a><td>  // should remove this when usages that rely on that fact are purged.<tr><td><a id="l253"></a><a href="#l253">253</a><td>  if (!this.eventTargetListeners_) {<tr><td><a id="l254"></a><a href="#l254">254</a><td>    return 0;<tr><td><a id="l255"></a><a href="#l255">255</a><td>  }<tr><td><a id="l256"></a><a href="#l256">256</a><td>  return this.eventTargetListeners_.removeAll(opt_type);<tr><td><a id="l257"></a><a href="#l257">257</a><td>};<tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td>/** @override */<tr><td><a id="l261"></a><a href="#l261">261</a><td>goog.events.EventTarget.prototype.fireListeners = function(<tr><td><a id="l262"></a><a href="#l262">262</a><td>    type, capture, eventObject) {<tr><td><a id="l263"></a><a href="#l263">263</a><td>  // TODO(chrishenry): Original code avoids array creation when there<tr><td><a id="l264"></a><a href="#l264">264</a><td>  // is no listener, so we do the same. If this optimization turns<tr><td><a id="l265"></a><a href="#l265">265</a><td>  // out to be not required, we can replace this with<tr><td><a id="l266"></a><a href="#l266">266</a><td>  // getListeners(type, capture) instead, which is simpler.<tr><td><a id="l267"></a><a href="#l267">267</a><td>  var listenerArray = this.eventTargetListeners_.listeners[String(type)];<tr><td><a id="l268"></a><a href="#l268">268</a><td>  if (!listenerArray) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>    return true;<tr><td><a id="l270"></a><a href="#l270">270</a><td>  }<tr><td><a id="l271"></a><a href="#l271">271</a><td>  listenerArray = listenerArray.concat();<tr><td><a id="l272"></a><a href="#l272">272</a><td><tr><td><a id="l273"></a><a href="#l273">273</a><td>  var rv = true;<tr><td><a id="l274"></a><a href="#l274">274</a><td>  for (var i = 0; i &lt; listenerArray.length; ++i) {<tr><td><a id="l275"></a><a href="#l275">275</a><td>    var listener = listenerArray[i];<tr><td><a id="l276"></a><a href="#l276">276</a><td>    // We might not have a listener if the listener was removed.<tr><td><a id="l277"></a><a href="#l277">277</a><td>    if (listener &amp;&amp; !listener.removed &amp;&amp; listener.capture == capture) {<tr><td><a id="l278"></a><a href="#l278">278</a><td>      var listenerFn = listener.listener;<tr><td><a id="l279"></a><a href="#l279">279</a><td>      var listenerHandler = listener.handler || listener.src;<tr><td><a id="l280"></a><a href="#l280">280</a><td><tr><td><a id="l281"></a><a href="#l281">281</a><td>      if (listener.callOnce) {<tr><td><a id="l282"></a><a href="#l282">282</a><td>        this.unlistenByKey(listener);<tr><td><a id="l283"></a><a href="#l283">283</a><td>      }<tr><td><a id="l284"></a><a href="#l284">284</a><td>      rv = listenerFn.call(listenerHandler, eventObject) !== false &amp;&amp; rv;<tr><td><a id="l285"></a><a href="#l285">285</a><td>    }<tr><td><a id="l286"></a><a href="#l286">286</a><td>  }<tr><td><a id="l287"></a><a href="#l287">287</a><td><tr><td><a id="l288"></a><a href="#l288">288</a><td>  return rv &amp;&amp; eventObject.returnValue_ != false;<tr><td><a id="l289"></a><a href="#l289">289</a><td>};<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>/** @override */<tr><td><a id="l293"></a><a href="#l293">293</a><td>goog.events.EventTarget.prototype.getListeners = function(type, capture) {<tr><td><a id="l294"></a><a href="#l294">294</a><td>  return this.eventTargetListeners_.getListeners(String(type), capture);<tr><td><a id="l295"></a><a href="#l295">295</a><td>};<tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td><tr><td><a id="l298"></a><a href="#l298">298</a><td>/** @override */<tr><td><a id="l299"></a><a href="#l299">299</a><td>goog.events.EventTarget.prototype.getListener = function(<tr><td><a id="l300"></a><a href="#l300">300</a><td>    type, listener, capture, opt_listenerScope) {<tr><td><a id="l301"></a><a href="#l301">301</a><td>  return this.eventTargetListeners_.getListener(<tr><td><a id="l302"></a><a href="#l302">302</a><td>      String(type), listener, capture, opt_listenerScope);<tr><td><a id="l303"></a><a href="#l303">303</a><td>};<tr><td><a id="l304"></a><a href="#l304">304</a><td><tr><td><a id="l305"></a><a href="#l305">305</a><td><tr><td><a id="l306"></a><a href="#l306">306</a><td>/** @override */<tr><td><a id="l307"></a><a href="#l307">307</a><td>goog.events.EventTarget.prototype.hasListener = function(<tr><td><a id="l308"></a><a href="#l308">308</a><td>    opt_type, opt_capture) {<tr><td><a id="l309"></a><a href="#l309">309</a><td>  var id = goog.isDef(opt_type) ? String(opt_type) : undefined;<tr><td><a id="l310"></a><a href="#l310">310</a><td>  return this.eventTargetListeners_.hasListener(id, opt_capture);<tr><td><a id="l311"></a><a href="#l311">311</a><td>};<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td><tr><td><a id="l314"></a><a href="#l314">314</a><td>/**<tr><td><a id="l315"></a><a href="#l315">315</a><td> * Sets the target to be used for {@code event.target} when firing<tr><td><a id="l316"></a><a href="#l316">316</a><td> * event. Mainly used for testing. For example, see<tr><td><a id="l317"></a><a href="#l317">317</a><td> * {@code goog.testing.events.mixinListenable}.<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @param {!Object} target The target.<tr><td><a id="l319"></a><a href="#l319">319</a><td> */<tr><td><a id="l320"></a><a href="#l320">320</a><td>goog.events.EventTarget.prototype.setTargetForTesting = function(target) {<tr><td><a id="l321"></a><a href="#l321">321</a><td>  this.actualEventTarget_ = target;<tr><td><a id="l322"></a><a href="#l322">322</a><td>};<tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td>/**<tr><td><a id="l326"></a><a href="#l326">326</a><td> * Asserts that the event target instance is initialized properly.<tr><td><a id="l327"></a><a href="#l327">327</a><td> * @private<tr><td><a id="l328"></a><a href="#l328">328</a><td> */<tr><td><a id="l329"></a><a href="#l329">329</a><td>goog.events.EventTarget.prototype.assertInitialized_ = function() {<tr><td><a id="l330"></a><a href="#l330">330</a><td>  goog.asserts.assert(<tr><td><a id="l331"></a><a href="#l331">331</a><td>      this.eventTargetListeners_,<tr><td><a id="l332"></a><a href="#l332">332</a><td>      &#39;Event target is not initialized. Did you call the superclass &#39; +<tr><td><a id="l333"></a><a href="#l333">333</a><td>      &#39;(goog.events.EventTarget) constructor?&#39;);<tr><td><a id="l334"></a><a href="#l334">334</a><td>};<tr><td><a id="l335"></a><a href="#l335">335</a><td><tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td>/**<tr><td><a id="l338"></a><a href="#l338">338</a><td> * Dispatches the given event on the ancestorsTree.<tr><td><a id="l339"></a><a href="#l339">339</a><td> *<tr><td><a id="l340"></a><a href="#l340">340</a><td> * @param {!Object} target The target to dispatch on.<tr><td><a id="l341"></a><a href="#l341">341</a><td> * @param {goog.events.Event|Object|string} e The event object.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {Array&lt;goog.events.Listenable&gt;=} opt_ancestorsTree The ancestors<tr><td><a id="l343"></a><a href="#l343">343</a><td> *     tree of the target, in reverse order from the closest ancestor<tr><td><a id="l344"></a><a href="#l344">344</a><td> *     to the root event target. May be null if the target has no ancestor.<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @return {boolean} If anyone called preventDefault on the event object (or<tr><td><a id="l346"></a><a href="#l346">346</a><td> *     if any of the listeners returns false) this will also return false.<tr><td><a id="l347"></a><a href="#l347">347</a><td> * @private<tr><td><a id="l348"></a><a href="#l348">348</a><td> */<tr><td><a id="l349"></a><a href="#l349">349</a><td>goog.events.EventTarget.dispatchEventInternal_ = function(<tr><td><a id="l350"></a><a href="#l350">350</a><td>    target, e, opt_ancestorsTree) {<tr><td><a id="l351"></a><a href="#l351">351</a><td>  var type = e.type || /** @type {string} */ (e);<tr><td><a id="l352"></a><a href="#l352">352</a><td><tr><td><a id="l353"></a><a href="#l353">353</a><td>  // If accepting a string or object, create a custom event object so that<tr><td><a id="l354"></a><a href="#l354">354</a><td>  // preventDefault and stopPropagation work with the event.<tr><td><a id="l355"></a><a href="#l355">355</a><td>  if (goog.isString(e)) {<tr><td><a id="l356"></a><a href="#l356">356</a><td>    e = new goog.events.Event(e, target);<tr><td><a id="l357"></a><a href="#l357">357</a><td>  } else if (!(e instanceof goog.events.Event)) {<tr><td><a id="l358"></a><a href="#l358">358</a><td>    var oldEvent = e;<tr><td><a id="l359"></a><a href="#l359">359</a><td>    e = new goog.events.Event(type, target);<tr><td><a id="l360"></a><a href="#l360">360</a><td>    goog.object.extend(e, oldEvent);<tr><td><a id="l361"></a><a href="#l361">361</a><td>  } else {<tr><td><a id="l362"></a><a href="#l362">362</a><td>    e.target = e.target || target;<tr><td><a id="l363"></a><a href="#l363">363</a><td>  }<tr><td><a id="l364"></a><a href="#l364">364</a><td><tr><td><a id="l365"></a><a href="#l365">365</a><td>  var rv = true, currentTarget;<tr><td><a id="l366"></a><a href="#l366">366</a><td><tr><td><a id="l367"></a><a href="#l367">367</a><td>  // Executes all capture listeners on the ancestors, if any.<tr><td><a id="l368"></a><a href="#l368">368</a><td>  if (opt_ancestorsTree) {<tr><td><a id="l369"></a><a href="#l369">369</a><td>    for (var i = opt_ancestorsTree.length - 1; !e.propagationStopped_ &amp;&amp; i &gt;= 0;<tr><td><a id="l370"></a><a href="#l370">370</a><td>         i--) {<tr><td><a id="l371"></a><a href="#l371">371</a><td>      currentTarget = e.currentTarget = opt_ancestorsTree[i];<tr><td><a id="l372"></a><a href="#l372">372</a><td>      rv = currentTarget.fireListeners(type, true, e) &amp;&amp; rv;<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>  // Executes capture and bubble listeners on the target.<tr><td><a id="l377"></a><a href="#l377">377</a><td>  if (!e.propagationStopped_) {<tr><td><a id="l378"></a><a href="#l378">378</a><td>    currentTarget = e.currentTarget = target;<tr><td><a id="l379"></a><a href="#l379">379</a><td>    rv = currentTarget.fireListeners(type, true, e) &amp;&amp; rv;<tr><td><a id="l380"></a><a href="#l380">380</a><td>    if (!e.propagationStopped_) {<tr><td><a id="l381"></a><a href="#l381">381</a><td>      rv = currentTarget.fireListeners(type, false, e) &amp;&amp; rv;<tr><td><a id="l382"></a><a href="#l382">382</a><td>    }<tr><td><a id="l383"></a><a href="#l383">383</a><td>  }<tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td>  // Executes all bubble listeners on the ancestors, if any.<tr><td><a id="l386"></a><a href="#l386">386</a><td>  if (opt_ancestorsTree) {<tr><td><a id="l387"></a><a href="#l387">387</a><td>    for (i = 0; !e.propagationStopped_ &amp;&amp; i &lt; opt_ancestorsTree.length; i++) {<tr><td><a id="l388"></a><a href="#l388">388</a><td>      currentTarget = e.currentTarget = opt_ancestorsTree[i];<tr><td><a id="l389"></a><a href="#l389">389</a><td>      rv = currentTarget.fireListeners(type, false, e) &amp;&amp; rv;<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>  return rv;<tr><td><a id="l394"></a><a href="#l394">394</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/eventtype.js.src.html b/docs/source/lib/goog/events/eventtype.js.src.html
new file mode 100644
index 0000000..52ab644
--- /dev/null
+++ b/docs/source/lib/goog/events/eventtype.js.src.html
@@ -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>eventtype.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/events/eventtype.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Event Types.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.events.EventType&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * Returns a prefixed event name for the current browser.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {string} eventName The name of the event.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @return {string} The prefixed event name.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @suppress {missingRequire|missingProvide}<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @private<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.events.getVendorPrefixedName_ = function(eventName) {<tr><td><a id="l35"></a><a href="#l35">35</a><td>  return goog.userAgent.WEBKIT ? &#39;webkit&#39; + eventName :<tr><td><a id="l36"></a><a href="#l36">36</a><td>      (goog.userAgent.OPERA ? &#39;o&#39; + eventName.toLowerCase() :<tr><td><a id="l37"></a><a href="#l37">37</a><td>          eventName.toLowerCase());<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> * Constants for event names.<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @enum {string}<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.events.EventType = {<tr><td><a id="l46"></a><a href="#l46">46</a><td>  // Mouse events<tr><td><a id="l47"></a><a href="#l47">47</a><td>  CLICK: &#39;click&#39;,<tr><td><a id="l48"></a><a href="#l48">48</a><td>  RIGHTCLICK: &#39;rightclick&#39;,<tr><td><a id="l49"></a><a href="#l49">49</a><td>  DBLCLICK: &#39;dblclick&#39;,<tr><td><a id="l50"></a><a href="#l50">50</a><td>  MOUSEDOWN: &#39;mousedown&#39;,<tr><td><a id="l51"></a><a href="#l51">51</a><td>  MOUSEUP: &#39;mouseup&#39;,<tr><td><a id="l52"></a><a href="#l52">52</a><td>  MOUSEOVER: &#39;mouseover&#39;,<tr><td><a id="l53"></a><a href="#l53">53</a><td>  MOUSEOUT: &#39;mouseout&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td>  MOUSEMOVE: &#39;mousemove&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td>  MOUSEENTER: &#39;mouseenter&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td>  MOUSELEAVE: &#39;mouseleave&#39;,<tr><td><a id="l57"></a><a href="#l57">57</a><td>  // Select start is non-standard.<tr><td><a id="l58"></a><a href="#l58">58</a><td>  // See http://msdn.microsoft.com/en-us/library/ie/ms536969(v=vs.85).aspx.<tr><td><a id="l59"></a><a href="#l59">59</a><td>  SELECTSTART: &#39;selectstart&#39;, // IE, Safari, Chrome<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td>  // Wheel events<tr><td><a id="l62"></a><a href="#l62">62</a><td>  // http://www.w3.org/TR/DOM-Level-3-Events/#events-wheelevents<tr><td><a id="l63"></a><a href="#l63">63</a><td>  WHEEL: &#39;wheel&#39;,<tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td>  // Key events<tr><td><a id="l66"></a><a href="#l66">66</a><td>  KEYPRESS: &#39;keypress&#39;,<tr><td><a id="l67"></a><a href="#l67">67</a><td>  KEYDOWN: &#39;keydown&#39;,<tr><td><a id="l68"></a><a href="#l68">68</a><td>  KEYUP: &#39;keyup&#39;,<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>  // Focus<tr><td><a id="l71"></a><a href="#l71">71</a><td>  BLUR: &#39;blur&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td>  FOCUS: &#39;focus&#39;,<tr><td><a id="l73"></a><a href="#l73">73</a><td>  DEACTIVATE: &#39;deactivate&#39;, // IE only<tr><td><a id="l74"></a><a href="#l74">74</a><td>  // NOTE: The following two events are not stable in cross-browser usage.<tr><td><a id="l75"></a><a href="#l75">75</a><td>  //     WebKit and Opera implement DOMFocusIn/Out.<tr><td><a id="l76"></a><a href="#l76">76</a><td>  //     IE implements focusin/out.<tr><td><a id="l77"></a><a href="#l77">77</a><td>  //     Gecko implements neither see bug at<tr><td><a id="l78"></a><a href="#l78">78</a><td>  //     https://bugzilla.mozilla.org/show_bug.cgi?id=396927.<tr><td><a id="l79"></a><a href="#l79">79</a><td>  // The DOM Events Level 3 Draft deprecates DOMFocusIn in favor of focusin:<tr><td><a id="l80"></a><a href="#l80">80</a><td>  //     http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html<tr><td><a id="l81"></a><a href="#l81">81</a><td>  // You can use FOCUS in Capture phase until implementations converge.<tr><td><a id="l82"></a><a href="#l82">82</a><td>  FOCUSIN: goog.userAgent.IE ? &#39;focusin&#39; : &#39;DOMFocusIn&#39;,<tr><td><a id="l83"></a><a href="#l83">83</a><td>  FOCUSOUT: goog.userAgent.IE ? &#39;focusout&#39; : &#39;DOMFocusOut&#39;,<tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>  // Forms<tr><td><a id="l86"></a><a href="#l86">86</a><td>  CHANGE: &#39;change&#39;,<tr><td><a id="l87"></a><a href="#l87">87</a><td>  RESET: &#39;reset&#39;,<tr><td><a id="l88"></a><a href="#l88">88</a><td>  SELECT: &#39;select&#39;,<tr><td><a id="l89"></a><a href="#l89">89</a><td>  SUBMIT: &#39;submit&#39;,<tr><td><a id="l90"></a><a href="#l90">90</a><td>  INPUT: &#39;input&#39;,<tr><td><a id="l91"></a><a href="#l91">91</a><td>  PROPERTYCHANGE: &#39;propertychange&#39;, // IE only<tr><td><a id="l92"></a><a href="#l92">92</a><td><tr><td><a id="l93"></a><a href="#l93">93</a><td>  // Drag and drop<tr><td><a id="l94"></a><a href="#l94">94</a><td>  DRAGSTART: &#39;dragstart&#39;,<tr><td><a id="l95"></a><a href="#l95">95</a><td>  DRAG: &#39;drag&#39;,<tr><td><a id="l96"></a><a href="#l96">96</a><td>  DRAGENTER: &#39;dragenter&#39;,<tr><td><a id="l97"></a><a href="#l97">97</a><td>  DRAGOVER: &#39;dragover&#39;,<tr><td><a id="l98"></a><a href="#l98">98</a><td>  DRAGLEAVE: &#39;dragleave&#39;,<tr><td><a id="l99"></a><a href="#l99">99</a><td>  DROP: &#39;drop&#39;,<tr><td><a id="l100"></a><a href="#l100">100</a><td>  DRAGEND: &#39;dragend&#39;,<tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td>  // Touch events<tr><td><a id="l103"></a><a href="#l103">103</a><td>  // Note that other touch events exist, but we should follow the W3C list here.<tr><td><a id="l104"></a><a href="#l104">104</a><td>  // http://www.w3.org/TR/touch-events/#list-of-touchevent-types<tr><td><a id="l105"></a><a href="#l105">105</a><td>  TOUCHSTART: &#39;touchstart&#39;,<tr><td><a id="l106"></a><a href="#l106">106</a><td>  TOUCHMOVE: &#39;touchmove&#39;,<tr><td><a id="l107"></a><a href="#l107">107</a><td>  TOUCHEND: &#39;touchend&#39;,<tr><td><a id="l108"></a><a href="#l108">108</a><td>  TOUCHCANCEL: &#39;touchcancel&#39;,<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td>  // Misc<tr><td><a id="l111"></a><a href="#l111">111</a><td>  BEFOREUNLOAD: &#39;beforeunload&#39;,<tr><td><a id="l112"></a><a href="#l112">112</a><td>  CONSOLEMESSAGE: &#39;consolemessage&#39;,<tr><td><a id="l113"></a><a href="#l113">113</a><td>  CONTEXTMENU: &#39;contextmenu&#39;,<tr><td><a id="l114"></a><a href="#l114">114</a><td>  DOMCONTENTLOADED: &#39;DOMContentLoaded&#39;,<tr><td><a id="l115"></a><a href="#l115">115</a><td>  ERROR: &#39;error&#39;,<tr><td><a id="l116"></a><a href="#l116">116</a><td>  HELP: &#39;help&#39;,<tr><td><a id="l117"></a><a href="#l117">117</a><td>  LOAD: &#39;load&#39;,<tr><td><a id="l118"></a><a href="#l118">118</a><td>  LOSECAPTURE: &#39;losecapture&#39;,<tr><td><a id="l119"></a><a href="#l119">119</a><td>  ORIENTATIONCHANGE: &#39;orientationchange&#39;,<tr><td><a id="l120"></a><a href="#l120">120</a><td>  READYSTATECHANGE: &#39;readystatechange&#39;,<tr><td><a id="l121"></a><a href="#l121">121</a><td>  RESIZE: &#39;resize&#39;,<tr><td><a id="l122"></a><a href="#l122">122</a><td>  SCROLL: &#39;scroll&#39;,<tr><td><a id="l123"></a><a href="#l123">123</a><td>  UNLOAD: &#39;unload&#39;,<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td>  // HTML 5 History events<tr><td><a id="l126"></a><a href="#l126">126</a><td>  // See http://www.w3.org/TR/html5/browsers.html#event-definitions-0<tr><td><a id="l127"></a><a href="#l127">127</a><td>  HASHCHANGE: &#39;hashchange&#39;,<tr><td><a id="l128"></a><a href="#l128">128</a><td>  PAGEHIDE: &#39;pagehide&#39;,<tr><td><a id="l129"></a><a href="#l129">129</a><td>  PAGESHOW: &#39;pageshow&#39;,<tr><td><a id="l130"></a><a href="#l130">130</a><td>  POPSTATE: &#39;popstate&#39;,<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>  // Copy and Paste<tr><td><a id="l133"></a><a href="#l133">133</a><td>  // Support is limited. Make sure it works on your favorite browser<tr><td><a id="l134"></a><a href="#l134">134</a><td>  // before using.<tr><td><a id="l135"></a><a href="#l135">135</a><td>  // http://www.quirksmode.org/dom/events/cutcopypaste.html<tr><td><a id="l136"></a><a href="#l136">136</a><td>  COPY: &#39;copy&#39;,<tr><td><a id="l137"></a><a href="#l137">137</a><td>  PASTE: &#39;paste&#39;,<tr><td><a id="l138"></a><a href="#l138">138</a><td>  CUT: &#39;cut&#39;,<tr><td><a id="l139"></a><a href="#l139">139</a><td>  BEFORECOPY: &#39;beforecopy&#39;,<tr><td><a id="l140"></a><a href="#l140">140</a><td>  BEFORECUT: &#39;beforecut&#39;,<tr><td><a id="l141"></a><a href="#l141">141</a><td>  BEFOREPASTE: &#39;beforepaste&#39;,<tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>  // HTML5 online/offline events.<tr><td><a id="l144"></a><a href="#l144">144</a><td>  // http://www.w3.org/TR/offline-webapps/#related<tr><td><a id="l145"></a><a href="#l145">145</a><td>  ONLINE: &#39;online&#39;,<tr><td><a id="l146"></a><a href="#l146">146</a><td>  OFFLINE: &#39;offline&#39;,<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td>  // HTML 5 worker events<tr><td><a id="l149"></a><a href="#l149">149</a><td>  MESSAGE: &#39;message&#39;,<tr><td><a id="l150"></a><a href="#l150">150</a><td>  CONNECT: &#39;connect&#39;,<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>  // CSS animation events.<tr><td><a id="l153"></a><a href="#l153">153</a><td>  /** @suppress {missingRequire} */<tr><td><a id="l154"></a><a href="#l154">154</a><td>  ANIMATIONSTART: goog.events.getVendorPrefixedName_(&#39;AnimationStart&#39;),<tr><td><a id="l155"></a><a href="#l155">155</a><td>  /** @suppress {missingRequire} */<tr><td><a id="l156"></a><a href="#l156">156</a><td>  ANIMATIONEND: goog.events.getVendorPrefixedName_(&#39;AnimationEnd&#39;),<tr><td><a id="l157"></a><a href="#l157">157</a><td>  /** @suppress {missingRequire} */<tr><td><a id="l158"></a><a href="#l158">158</a><td>  ANIMATIONITERATION: goog.events.getVendorPrefixedName_(&#39;AnimationIteration&#39;),<tr><td><a id="l159"></a><a href="#l159">159</a><td><tr><td><a id="l160"></a><a href="#l160">160</a><td>  // CSS transition events. Based on the browser support described at:<tr><td><a id="l161"></a><a href="#l161">161</a><td>  // https://developer.mozilla.org/en/css/css_transitions#Browser_compatibility<tr><td><a id="l162"></a><a href="#l162">162</a><td>  /** @suppress {missingRequire} */<tr><td><a id="l163"></a><a href="#l163">163</a><td>  TRANSITIONEND: goog.events.getVendorPrefixedName_(&#39;TransitionEnd&#39;),<tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td>  // W3C Pointer Events<tr><td><a id="l166"></a><a href="#l166">166</a><td>  // http://www.w3.org/TR/pointerevents/<tr><td><a id="l167"></a><a href="#l167">167</a><td>  POINTERDOWN: &#39;pointerdown&#39;,<tr><td><a id="l168"></a><a href="#l168">168</a><td>  POINTERUP: &#39;pointerup&#39;,<tr><td><a id="l169"></a><a href="#l169">169</a><td>  POINTERCANCEL: &#39;pointercancel&#39;,<tr><td><a id="l170"></a><a href="#l170">170</a><td>  POINTERMOVE: &#39;pointermove&#39;,<tr><td><a id="l171"></a><a href="#l171">171</a><td>  POINTEROVER: &#39;pointerover&#39;,<tr><td><a id="l172"></a><a href="#l172">172</a><td>  POINTEROUT: &#39;pointerout&#39;,<tr><td><a id="l173"></a><a href="#l173">173</a><td>  POINTERENTER: &#39;pointerenter&#39;,<tr><td><a id="l174"></a><a href="#l174">174</a><td>  POINTERLEAVE: &#39;pointerleave&#39;,<tr><td><a id="l175"></a><a href="#l175">175</a><td>  GOTPOINTERCAPTURE: &#39;gotpointercapture&#39;,<tr><td><a id="l176"></a><a href="#l176">176</a><td>  LOSTPOINTERCAPTURE: &#39;lostpointercapture&#39;,<tr><td><a id="l177"></a><a href="#l177">177</a><td><tr><td><a id="l178"></a><a href="#l178">178</a><td>  // IE specific events.<tr><td><a id="l179"></a><a href="#l179">179</a><td>  // See http://msdn.microsoft.com/en-us/library/ie/hh772103(v=vs.85).aspx<tr><td><a id="l180"></a><a href="#l180">180</a><td>  // Note: these events will be supplanted in IE11.<tr><td><a id="l181"></a><a href="#l181">181</a><td>  MSGESTURECHANGE: &#39;MSGestureChange&#39;,<tr><td><a id="l182"></a><a href="#l182">182</a><td>  MSGESTUREEND: &#39;MSGestureEnd&#39;,<tr><td><a id="l183"></a><a href="#l183">183</a><td>  MSGESTUREHOLD: &#39;MSGestureHold&#39;,<tr><td><a id="l184"></a><a href="#l184">184</a><td>  MSGESTURESTART: &#39;MSGestureStart&#39;,<tr><td><a id="l185"></a><a href="#l185">185</a><td>  MSGESTURETAP: &#39;MSGestureTap&#39;,<tr><td><a id="l186"></a><a href="#l186">186</a><td>  MSGOTPOINTERCAPTURE: &#39;MSGotPointerCapture&#39;,<tr><td><a id="l187"></a><a href="#l187">187</a><td>  MSINERTIASTART: &#39;MSInertiaStart&#39;,<tr><td><a id="l188"></a><a href="#l188">188</a><td>  MSLOSTPOINTERCAPTURE: &#39;MSLostPointerCapture&#39;,<tr><td><a id="l189"></a><a href="#l189">189</a><td>  MSPOINTERCANCEL: &#39;MSPointerCancel&#39;,<tr><td><a id="l190"></a><a href="#l190">190</a><td>  MSPOINTERDOWN: &#39;MSPointerDown&#39;,<tr><td><a id="l191"></a><a href="#l191">191</a><td>  MSPOINTERENTER: &#39;MSPointerEnter&#39;,<tr><td><a id="l192"></a><a href="#l192">192</a><td>  MSPOINTERHOVER: &#39;MSPointerHover&#39;,<tr><td><a id="l193"></a><a href="#l193">193</a><td>  MSPOINTERLEAVE: &#39;MSPointerLeave&#39;,<tr><td><a id="l194"></a><a href="#l194">194</a><td>  MSPOINTERMOVE: &#39;MSPointerMove&#39;,<tr><td><a id="l195"></a><a href="#l195">195</a><td>  MSPOINTEROUT: &#39;MSPointerOut&#39;,<tr><td><a id="l196"></a><a href="#l196">196</a><td>  MSPOINTEROVER: &#39;MSPointerOver&#39;,<tr><td><a id="l197"></a><a href="#l197">197</a><td>  MSPOINTERUP: &#39;MSPointerUp&#39;,<tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>  // Native IMEs/input tools events.<tr><td><a id="l200"></a><a href="#l200">200</a><td>  TEXT: &#39;text&#39;,<tr><td><a id="l201"></a><a href="#l201">201</a><td>  TEXTINPUT: &#39;textInput&#39;,<tr><td><a id="l202"></a><a href="#l202">202</a><td>  COMPOSITIONSTART: &#39;compositionstart&#39;,<tr><td><a id="l203"></a><a href="#l203">203</a><td>  COMPOSITIONUPDATE: &#39;compositionupdate&#39;,<tr><td><a id="l204"></a><a href="#l204">204</a><td>  COMPOSITIONEND: &#39;compositionend&#39;,<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>  // Webview tag events<tr><td><a id="l207"></a><a href="#l207">207</a><td>  // See http://developer.chrome.com/dev/apps/webview_tag.html<tr><td><a id="l208"></a><a href="#l208">208</a><td>  EXIT: &#39;exit&#39;,<tr><td><a id="l209"></a><a href="#l209">209</a><td>  LOADABORT: &#39;loadabort&#39;,<tr><td><a id="l210"></a><a href="#l210">210</a><td>  LOADCOMMIT: &#39;loadcommit&#39;,<tr><td><a id="l211"></a><a href="#l211">211</a><td>  LOADREDIRECT: &#39;loadredirect&#39;,<tr><td><a id="l212"></a><a href="#l212">212</a><td>  LOADSTART: &#39;loadstart&#39;,<tr><td><a id="l213"></a><a href="#l213">213</a><td>  LOADSTOP: &#39;loadstop&#39;,<tr><td><a id="l214"></a><a href="#l214">214</a><td>  RESPONSIVE: &#39;responsive&#39;,<tr><td><a id="l215"></a><a href="#l215">215</a><td>  SIZECHANGED: &#39;sizechanged&#39;,<tr><td><a id="l216"></a><a href="#l216">216</a><td>  UNRESPONSIVE: &#39;unresponsive&#39;,<tr><td><a id="l217"></a><a href="#l217">217</a><td><tr><td><a id="l218"></a><a href="#l218">218</a><td>  // HTML5 Page Visibility API.  See details at<tr><td><a id="l219"></a><a href="#l219">219</a><td>  // {@code goog.labs.dom.PageVisibilityMonitor}.<tr><td><a id="l220"></a><a href="#l220">220</a><td>  VISIBILITYCHANGE: &#39;visibilitychange&#39;,<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td>  // LocalStorage event.<tr><td><a id="l223"></a><a href="#l223">223</a><td>  STORAGE: &#39;storage&#39;,<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td>  // DOM Level 2 mutation events (deprecated).<tr><td><a id="l226"></a><a href="#l226">226</a><td>  DOMSUBTREEMODIFIED: &#39;DOMSubtreeModified&#39;,<tr><td><a id="l227"></a><a href="#l227">227</a><td>  DOMNODEINSERTED: &#39;DOMNodeInserted&#39;,<tr><td><a id="l228"></a><a href="#l228">228</a><td>  DOMNODEREMOVED: &#39;DOMNodeRemoved&#39;,<tr><td><a id="l229"></a><a href="#l229">229</a><td>  DOMNODEREMOVEDFROMDOCUMENT: &#39;DOMNodeRemovedFromDocument&#39;,<tr><td><a id="l230"></a><a href="#l230">230</a><td>  DOMNODEINSERTEDINTODOCUMENT: &#39;DOMNodeInsertedIntoDocument&#39;,<tr><td><a id="l231"></a><a href="#l231">231</a><td>  DOMATTRMODIFIED: &#39;DOMAttrModified&#39;,<tr><td><a id="l232"></a><a href="#l232">232</a><td>  DOMCHARACTERDATAMODIFIED: &#39;DOMCharacterDataModified&#39;,<tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>  // Print events.<tr><td><a id="l235"></a><a href="#l235">235</a><td>  BEFOREPRINT: &#39;beforeprint&#39;,<tr><td><a id="l236"></a><a href="#l236">236</a><td>  AFTERPRINT: &#39;afterprint&#39;<tr><td><a id="l237"></a><a href="#l237">237</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/keycodes.js.src.html b/docs/source/lib/goog/events/keycodes.js.src.html
new file mode 100644
index 0000000..f6d6ff6
--- /dev/null
+++ b/docs/source/lib/goog/events/keycodes.js.src.html
@@ -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>keycodes.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/events/keycodes.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Constant declarations for common key codes.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author eae@google.com (Emil A Eklund)<tr><td><a id="l19"></a><a href="#l19">19</a><td> * @see ../demos/keyhandler.html<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.events.KeyCodes&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.forwardDeclare(&#39;goog.events.BrowserEvent&#39;);<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> * Key codes for common characters.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * This list is not localized and therefore some of the key codes are not<tr><td><a id="l33"></a><a href="#l33">33</a><td> * correct for non US keyboard layouts. See comments below.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @enum {number}<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.events.KeyCodes = {<tr><td><a id="l38"></a><a href="#l38">38</a><td>  WIN_KEY_FF_LINUX: 0,<tr><td><a id="l39"></a><a href="#l39">39</a><td>  MAC_ENTER: 3,<tr><td><a id="l40"></a><a href="#l40">40</a><td>  BACKSPACE: 8,<tr><td><a id="l41"></a><a href="#l41">41</a><td>  TAB: 9,<tr><td><a id="l42"></a><a href="#l42">42</a><td>  NUM_CENTER: 12,  // NUMLOCK on FF/Safari Mac<tr><td><a id="l43"></a><a href="#l43">43</a><td>  ENTER: 13,<tr><td><a id="l44"></a><a href="#l44">44</a><td>  SHIFT: 16,<tr><td><a id="l45"></a><a href="#l45">45</a><td>  CTRL: 17,<tr><td><a id="l46"></a><a href="#l46">46</a><td>  ALT: 18,<tr><td><a id="l47"></a><a href="#l47">47</a><td>  PAUSE: 19,<tr><td><a id="l48"></a><a href="#l48">48</a><td>  CAPS_LOCK: 20,<tr><td><a id="l49"></a><a href="#l49">49</a><td>  ESC: 27,<tr><td><a id="l50"></a><a href="#l50">50</a><td>  SPACE: 32,<tr><td><a id="l51"></a><a href="#l51">51</a><td>  PAGE_UP: 33,     // also NUM_NORTH_EAST<tr><td><a id="l52"></a><a href="#l52">52</a><td>  PAGE_DOWN: 34,   // also NUM_SOUTH_EAST<tr><td><a id="l53"></a><a href="#l53">53</a><td>  END: 35,         // also NUM_SOUTH_WEST<tr><td><a id="l54"></a><a href="#l54">54</a><td>  HOME: 36,        // also NUM_NORTH_WEST<tr><td><a id="l55"></a><a href="#l55">55</a><td>  LEFT: 37,        // also NUM_WEST<tr><td><a id="l56"></a><a href="#l56">56</a><td>  UP: 38,          // also NUM_NORTH<tr><td><a id="l57"></a><a href="#l57">57</a><td>  RIGHT: 39,       // also NUM_EAST<tr><td><a id="l58"></a><a href="#l58">58</a><td>  DOWN: 40,        // also NUM_SOUTH<tr><td><a id="l59"></a><a href="#l59">59</a><td>  PLUS_SIGN: 43,   // NOT numpad plus<tr><td><a id="l60"></a><a href="#l60">60</a><td>  PRINT_SCREEN: 44,<tr><td><a id="l61"></a><a href="#l61">61</a><td>  INSERT: 45,      // also NUM_INSERT<tr><td><a id="l62"></a><a href="#l62">62</a><td>  DELETE: 46,      // also NUM_DELETE<tr><td><a id="l63"></a><a href="#l63">63</a><td>  ZERO: 48,<tr><td><a id="l64"></a><a href="#l64">64</a><td>  ONE: 49,<tr><td><a id="l65"></a><a href="#l65">65</a><td>  TWO: 50,<tr><td><a id="l66"></a><a href="#l66">66</a><td>  THREE: 51,<tr><td><a id="l67"></a><a href="#l67">67</a><td>  FOUR: 52,<tr><td><a id="l68"></a><a href="#l68">68</a><td>  FIVE: 53,<tr><td><a id="l69"></a><a href="#l69">69</a><td>  SIX: 54,<tr><td><a id="l70"></a><a href="#l70">70</a><td>  SEVEN: 55,<tr><td><a id="l71"></a><a href="#l71">71</a><td>  EIGHT: 56,<tr><td><a id="l72"></a><a href="#l72">72</a><td>  NINE: 57,<tr><td><a id="l73"></a><a href="#l73">73</a><td>  FF_SEMICOLON: 59, // Firefox (Gecko) fires this for semicolon instead of 186<tr><td><a id="l74"></a><a href="#l74">74</a><td>  FF_EQUALS: 61, // Firefox (Gecko) fires this for equals instead of 187<tr><td><a id="l75"></a><a href="#l75">75</a><td>  FF_DASH: 173, // Firefox (Gecko) fires this for dash instead of 189<tr><td><a id="l76"></a><a href="#l76">76</a><td>  QUESTION_MARK: 63, // needs localization<tr><td><a id="l77"></a><a href="#l77">77</a><td>  AT_SIGN: 64,<tr><td><a id="l78"></a><a href="#l78">78</a><td>  A: 65,<tr><td><a id="l79"></a><a href="#l79">79</a><td>  B: 66,<tr><td><a id="l80"></a><a href="#l80">80</a><td>  C: 67,<tr><td><a id="l81"></a><a href="#l81">81</a><td>  D: 68,<tr><td><a id="l82"></a><a href="#l82">82</a><td>  E: 69,<tr><td><a id="l83"></a><a href="#l83">83</a><td>  F: 70,<tr><td><a id="l84"></a><a href="#l84">84</a><td>  G: 71,<tr><td><a id="l85"></a><a href="#l85">85</a><td>  H: 72,<tr><td><a id="l86"></a><a href="#l86">86</a><td>  I: 73,<tr><td><a id="l87"></a><a href="#l87">87</a><td>  J: 74,<tr><td><a id="l88"></a><a href="#l88">88</a><td>  K: 75,<tr><td><a id="l89"></a><a href="#l89">89</a><td>  L: 76,<tr><td><a id="l90"></a><a href="#l90">90</a><td>  M: 77,<tr><td><a id="l91"></a><a href="#l91">91</a><td>  N: 78,<tr><td><a id="l92"></a><a href="#l92">92</a><td>  O: 79,<tr><td><a id="l93"></a><a href="#l93">93</a><td>  P: 80,<tr><td><a id="l94"></a><a href="#l94">94</a><td>  Q: 81,<tr><td><a id="l95"></a><a href="#l95">95</a><td>  R: 82,<tr><td><a id="l96"></a><a href="#l96">96</a><td>  S: 83,<tr><td><a id="l97"></a><a href="#l97">97</a><td>  T: 84,<tr><td><a id="l98"></a><a href="#l98">98</a><td>  U: 85,<tr><td><a id="l99"></a><a href="#l99">99</a><td>  V: 86,<tr><td><a id="l100"></a><a href="#l100">100</a><td>  W: 87,<tr><td><a id="l101"></a><a href="#l101">101</a><td>  X: 88,<tr><td><a id="l102"></a><a href="#l102">102</a><td>  Y: 89,<tr><td><a id="l103"></a><a href="#l103">103</a><td>  Z: 90,<tr><td><a id="l104"></a><a href="#l104">104</a><td>  META: 91, // WIN_KEY_LEFT<tr><td><a id="l105"></a><a href="#l105">105</a><td>  WIN_KEY_RIGHT: 92,<tr><td><a id="l106"></a><a href="#l106">106</a><td>  CONTEXT_MENU: 93,<tr><td><a id="l107"></a><a href="#l107">107</a><td>  NUM_ZERO: 96,<tr><td><a id="l108"></a><a href="#l108">108</a><td>  NUM_ONE: 97,<tr><td><a id="l109"></a><a href="#l109">109</a><td>  NUM_TWO: 98,<tr><td><a id="l110"></a><a href="#l110">110</a><td>  NUM_THREE: 99,<tr><td><a id="l111"></a><a href="#l111">111</a><td>  NUM_FOUR: 100,<tr><td><a id="l112"></a><a href="#l112">112</a><td>  NUM_FIVE: 101,<tr><td><a id="l113"></a><a href="#l113">113</a><td>  NUM_SIX: 102,<tr><td><a id="l114"></a><a href="#l114">114</a><td>  NUM_SEVEN: 103,<tr><td><a id="l115"></a><a href="#l115">115</a><td>  NUM_EIGHT: 104,<tr><td><a id="l116"></a><a href="#l116">116</a><td>  NUM_NINE: 105,<tr><td><a id="l117"></a><a href="#l117">117</a><td>  NUM_MULTIPLY: 106,<tr><td><a id="l118"></a><a href="#l118">118</a><td>  NUM_PLUS: 107,<tr><td><a id="l119"></a><a href="#l119">119</a><td>  NUM_MINUS: 109,<tr><td><a id="l120"></a><a href="#l120">120</a><td>  NUM_PERIOD: 110,<tr><td><a id="l121"></a><a href="#l121">121</a><td>  NUM_DIVISION: 111,<tr><td><a id="l122"></a><a href="#l122">122</a><td>  F1: 112,<tr><td><a id="l123"></a><a href="#l123">123</a><td>  F2: 113,<tr><td><a id="l124"></a><a href="#l124">124</a><td>  F3: 114,<tr><td><a id="l125"></a><a href="#l125">125</a><td>  F4: 115,<tr><td><a id="l126"></a><a href="#l126">126</a><td>  F5: 116,<tr><td><a id="l127"></a><a href="#l127">127</a><td>  F6: 117,<tr><td><a id="l128"></a><a href="#l128">128</a><td>  F7: 118,<tr><td><a id="l129"></a><a href="#l129">129</a><td>  F8: 119,<tr><td><a id="l130"></a><a href="#l130">130</a><td>  F9: 120,<tr><td><a id="l131"></a><a href="#l131">131</a><td>  F10: 121,<tr><td><a id="l132"></a><a href="#l132">132</a><td>  F11: 122,<tr><td><a id="l133"></a><a href="#l133">133</a><td>  F12: 123,<tr><td><a id="l134"></a><a href="#l134">134</a><td>  NUMLOCK: 144,<tr><td><a id="l135"></a><a href="#l135">135</a><td>  SCROLL_LOCK: 145,<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>  // OS-specific media keys like volume controls and browser controls.<tr><td><a id="l138"></a><a href="#l138">138</a><td>  FIRST_MEDIA_KEY: 166,<tr><td><a id="l139"></a><a href="#l139">139</a><td>  LAST_MEDIA_KEY: 183,<tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td>  SEMICOLON: 186,            // needs localization<tr><td><a id="l142"></a><a href="#l142">142</a><td>  DASH: 189,                 // needs localization<tr><td><a id="l143"></a><a href="#l143">143</a><td>  EQUALS: 187,               // needs localization<tr><td><a id="l144"></a><a href="#l144">144</a><td>  COMMA: 188,                // needs localization<tr><td><a id="l145"></a><a href="#l145">145</a><td>  PERIOD: 190,               // needs localization<tr><td><a id="l146"></a><a href="#l146">146</a><td>  SLASH: 191,                // needs localization<tr><td><a id="l147"></a><a href="#l147">147</a><td>  APOSTROPHE: 192,           // needs localization<tr><td><a id="l148"></a><a href="#l148">148</a><td>  TILDE: 192,                // needs localization<tr><td><a id="l149"></a><a href="#l149">149</a><td>  SINGLE_QUOTE: 222,         // needs localization<tr><td><a id="l150"></a><a href="#l150">150</a><td>  OPEN_SQUARE_BRACKET: 219,  // needs localization<tr><td><a id="l151"></a><a href="#l151">151</a><td>  BACKSLASH: 220,            // needs localization<tr><td><a id="l152"></a><a href="#l152">152</a><td>  CLOSE_SQUARE_BRACKET: 221, // needs localization<tr><td><a id="l153"></a><a href="#l153">153</a><td>  WIN_KEY: 224,<tr><td><a id="l154"></a><a href="#l154">154</a><td>  MAC_FF_META: 224, // Firefox (Gecko) fires this for the meta key instead of 91<tr><td><a id="l155"></a><a href="#l155">155</a><td>  MAC_WK_CMD_LEFT: 91,  // WebKit Left Command key fired, same as META<tr><td><a id="l156"></a><a href="#l156">156</a><td>  MAC_WK_CMD_RIGHT: 93, // WebKit Right Command key fired, different from META<tr><td><a id="l157"></a><a href="#l157">157</a><td>  WIN_IME: 229,<tr><td><a id="l158"></a><a href="#l158">158</a><td><tr><td><a id="l159"></a><a href="#l159">159</a><td>  // &quot;Reserved for future use&quot;. Some programs (e.g. the SlingPlayer 2.4 ActiveX<tr><td><a id="l160"></a><a href="#l160">160</a><td>  // control) fire this as a hacky way to disable screensavers.<tr><td><a id="l161"></a><a href="#l161">161</a><td>  VK_NONAME: 252,<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>  // We&#39;ve seen users whose machines fire this keycode at regular one<tr><td><a id="l164"></a><a href="#l164">164</a><td>  // second intervals. The common thread among these users is that<tr><td><a id="l165"></a><a href="#l165">165</a><td>  // they&#39;re all using Dell Inspiron laptops, so we suspect that this<tr><td><a id="l166"></a><a href="#l166">166</a><td>  // indicates a hardware/bios problem.<tr><td><a id="l167"></a><a href="#l167">167</a><td>  // http://en.community.dell.com/support-forums/laptop/f/3518/p/19285957/19523128.aspx<tr><td><a id="l168"></a><a href="#l168">168</a><td>  PHANTOM: 255<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 true if the event contains a text modifying key.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @param {goog.events.BrowserEvent} e A key event.<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @return {boolean} Whether it&#39;s a text modifying key.<tr><td><a id="l176"></a><a href="#l176">176</a><td> */<tr><td><a id="l177"></a><a href="#l177">177</a><td>goog.events.KeyCodes.isTextModifyingKeyEvent = function(e) {<tr><td><a id="l178"></a><a href="#l178">178</a><td>  if (e.altKey &amp;&amp; !e.ctrlKey ||<tr><td><a id="l179"></a><a href="#l179">179</a><td>      e.metaKey ||<tr><td><a id="l180"></a><a href="#l180">180</a><td>      // Function keys don&#39;t generate text<tr><td><a id="l181"></a><a href="#l181">181</a><td>      e.keyCode &gt;= goog.events.KeyCodes.F1 &amp;&amp;<tr><td><a id="l182"></a><a href="#l182">182</a><td>      e.keyCode &lt;= goog.events.KeyCodes.F12) {<tr><td><a id="l183"></a><a href="#l183">183</a><td>    return false;<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>  // The following keys are quite harmless, even in combination with<tr><td><a id="l187"></a><a href="#l187">187</a><td>  // CTRL, ALT or SHIFT.<tr><td><a id="l188"></a><a href="#l188">188</a><td>  switch (e.keyCode) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>    case goog.events.KeyCodes.ALT:<tr><td><a id="l190"></a><a href="#l190">190</a><td>    case goog.events.KeyCodes.CAPS_LOCK:<tr><td><a id="l191"></a><a href="#l191">191</a><td>    case goog.events.KeyCodes.CONTEXT_MENU:<tr><td><a id="l192"></a><a href="#l192">192</a><td>    case goog.events.KeyCodes.CTRL:<tr><td><a id="l193"></a><a href="#l193">193</a><td>    case goog.events.KeyCodes.DOWN:<tr><td><a id="l194"></a><a href="#l194">194</a><td>    case goog.events.KeyCodes.END:<tr><td><a id="l195"></a><a href="#l195">195</a><td>    case goog.events.KeyCodes.ESC:<tr><td><a id="l196"></a><a href="#l196">196</a><td>    case goog.events.KeyCodes.HOME:<tr><td><a id="l197"></a><a href="#l197">197</a><td>    case goog.events.KeyCodes.INSERT:<tr><td><a id="l198"></a><a href="#l198">198</a><td>    case goog.events.KeyCodes.LEFT:<tr><td><a id="l199"></a><a href="#l199">199</a><td>    case goog.events.KeyCodes.MAC_FF_META:<tr><td><a id="l200"></a><a href="#l200">200</a><td>    case goog.events.KeyCodes.META:<tr><td><a id="l201"></a><a href="#l201">201</a><td>    case goog.events.KeyCodes.NUMLOCK:<tr><td><a id="l202"></a><a href="#l202">202</a><td>    case goog.events.KeyCodes.NUM_CENTER:<tr><td><a id="l203"></a><a href="#l203">203</a><td>    case goog.events.KeyCodes.PAGE_DOWN:<tr><td><a id="l204"></a><a href="#l204">204</a><td>    case goog.events.KeyCodes.PAGE_UP:<tr><td><a id="l205"></a><a href="#l205">205</a><td>    case goog.events.KeyCodes.PAUSE:<tr><td><a id="l206"></a><a href="#l206">206</a><td>    case goog.events.KeyCodes.PHANTOM:<tr><td><a id="l207"></a><a href="#l207">207</a><td>    case goog.events.KeyCodes.PRINT_SCREEN:<tr><td><a id="l208"></a><a href="#l208">208</a><td>    case goog.events.KeyCodes.RIGHT:<tr><td><a id="l209"></a><a href="#l209">209</a><td>    case goog.events.KeyCodes.SCROLL_LOCK:<tr><td><a id="l210"></a><a href="#l210">210</a><td>    case goog.events.KeyCodes.SHIFT:<tr><td><a id="l211"></a><a href="#l211">211</a><td>    case goog.events.KeyCodes.UP:<tr><td><a id="l212"></a><a href="#l212">212</a><td>    case goog.events.KeyCodes.VK_NONAME:<tr><td><a id="l213"></a><a href="#l213">213</a><td>    case goog.events.KeyCodes.WIN_KEY:<tr><td><a id="l214"></a><a href="#l214">214</a><td>    case goog.events.KeyCodes.WIN_KEY_RIGHT:<tr><td><a id="l215"></a><a href="#l215">215</a><td>      return false;<tr><td><a id="l216"></a><a href="#l216">216</a><td>    case goog.events.KeyCodes.WIN_KEY_FF_LINUX:<tr><td><a id="l217"></a><a href="#l217">217</a><td>      return !goog.userAgent.GECKO;<tr><td><a id="l218"></a><a href="#l218">218</a><td>    default:<tr><td><a id="l219"></a><a href="#l219">219</a><td>      return e.keyCode &lt; goog.events.KeyCodes.FIRST_MEDIA_KEY ||<tr><td><a id="l220"></a><a href="#l220">220</a><td>          e.keyCode &gt; goog.events.KeyCodes.LAST_MEDIA_KEY;<tr><td><a id="l221"></a><a href="#l221">221</a><td>  }<tr><td><a id="l222"></a><a href="#l222">222</a><td>};<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td>/**<tr><td><a id="l226"></a><a href="#l226">226</a><td> * Returns true if the key fires a keypress event in the current browser.<tr><td><a id="l227"></a><a href="#l227">227</a><td> *<tr><td><a id="l228"></a><a href="#l228">228</a><td> * Accoridng to MSDN [1] IE only fires keypress events for the following keys:<tr><td><a id="l229"></a><a href="#l229">229</a><td> * - Letters: A - Z (uppercase and lowercase)<tr><td><a id="l230"></a><a href="#l230">230</a><td> * - Numerals: 0 - 9<tr><td><a id="l231"></a><a href="#l231">231</a><td> * - Symbols: ! @ # $ % ^ &amp; * ( ) _ - + = &lt; [ ] { } , . / ? \ | &#39; ` &quot; ~<tr><td><a id="l232"></a><a href="#l232">232</a><td> * - System: ESC, SPACEBAR, ENTER<tr><td><a id="l233"></a><a href="#l233">233</a><td> *<tr><td><a id="l234"></a><a href="#l234">234</a><td> * That&#39;s not entirely correct though, for instance there&#39;s no distinction<tr><td><a id="l235"></a><a href="#l235">235</a><td> * between upper and lower case letters.<tr><td><a id="l236"></a><a href="#l236">236</a><td> *<tr><td><a id="l237"></a><a href="#l237">237</a><td> * [1] http://msdn2.microsoft.com/en-us/library/ms536939(VS.85).aspx)<tr><td><a id="l238"></a><a href="#l238">238</a><td> *<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Safari is similar to IE, but does not fire keypress for ESC.<tr><td><a id="l240"></a><a href="#l240">240</a><td> *<tr><td><a id="l241"></a><a href="#l241">241</a><td> * Additionally, IE6 does not fire keydown or keypress events for letters when<tr><td><a id="l242"></a><a href="#l242">242</a><td> * the control or alt keys are held down and the shift key is not. IE7 does<tr><td><a id="l243"></a><a href="#l243">243</a><td> * fire keydown in these cases, though, but not keypress.<tr><td><a id="l244"></a><a href="#l244">244</a><td> *<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {number} keyCode A key code.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @param {number=} opt_heldKeyCode Key code of a currently-held key.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @param {boolean=} opt_shiftKey Whether the shift key is held down.<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @param {boolean=} opt_ctrlKey Whether the control key is held down.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @param {boolean=} opt_altKey Whether the alt key is held down.<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @return {boolean} Whether it&#39;s a key that fires a keypress event.<tr><td><a id="l251"></a><a href="#l251">251</a><td> */<tr><td><a id="l252"></a><a href="#l252">252</a><td>goog.events.KeyCodes.firesKeyPressEvent = function(keyCode, opt_heldKeyCode,<tr><td><a id="l253"></a><a href="#l253">253</a><td>    opt_shiftKey, opt_ctrlKey, opt_altKey) {<tr><td><a id="l254"></a><a href="#l254">254</a><td>  if (!goog.userAgent.IE &amp;&amp; !goog.userAgent.EDGE &amp;&amp;<tr><td><a id="l255"></a><a href="#l255">255</a><td>      !(goog.userAgent.WEBKIT &amp;&amp; goog.userAgent.isVersionOrHigher(&#39;525&#39;))) {<tr><td><a id="l256"></a><a href="#l256">256</a><td>    return true;<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>  if (goog.userAgent.MAC &amp;&amp; opt_altKey) {<tr><td><a id="l260"></a><a href="#l260">260</a><td>    return goog.events.KeyCodes.isCharacterKey(keyCode);<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>  // Alt but not AltGr which is represented as Alt+Ctrl.<tr><td><a id="l264"></a><a href="#l264">264</a><td>  if (opt_altKey &amp;&amp; !opt_ctrlKey) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>    return false;<tr><td><a id="l266"></a><a href="#l266">266</a><td>  }<tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td>  // Saves Ctrl or Alt + key for IE and WebKit 525+, which won&#39;t fire keypress.<tr><td><a id="l269"></a><a href="#l269">269</a><td>  // Non-IE browsers and WebKit prior to 525 won&#39;t get this far so no need to<tr><td><a id="l270"></a><a href="#l270">270</a><td>  // check the user agent.<tr><td><a id="l271"></a><a href="#l271">271</a><td>  if (goog.isNumber(opt_heldKeyCode)) {<tr><td><a id="l272"></a><a href="#l272">272</a><td>    opt_heldKeyCode = goog.events.KeyCodes.normalizeKeyCode(opt_heldKeyCode);<tr><td><a id="l273"></a><a href="#l273">273</a><td>  }<tr><td><a id="l274"></a><a href="#l274">274</a><td>  if (!opt_shiftKey &amp;&amp;<tr><td><a id="l275"></a><a href="#l275">275</a><td>      (opt_heldKeyCode == goog.events.KeyCodes.CTRL ||<tr><td><a id="l276"></a><a href="#l276">276</a><td>       opt_heldKeyCode == goog.events.KeyCodes.ALT ||<tr><td><a id="l277"></a><a href="#l277">277</a><td>       goog.userAgent.MAC &amp;&amp;<tr><td><a id="l278"></a><a href="#l278">278</a><td>       opt_heldKeyCode == goog.events.KeyCodes.META)) {<tr><td><a id="l279"></a><a href="#l279">279</a><td>    return false;<tr><td><a id="l280"></a><a href="#l280">280</a><td>  }<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td>  // Some keys with Ctrl/Shift do not issue keypress in WEBKIT.<tr><td><a id="l283"></a><a href="#l283">283</a><td>  if ((goog.userAgent.WEBKIT || goog.userAgent.EDGE) &amp;&amp;<tr><td><a id="l284"></a><a href="#l284">284</a><td>      opt_ctrlKey &amp;&amp; opt_shiftKey) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>    switch (keyCode) {<tr><td><a id="l286"></a><a href="#l286">286</a><td>      case goog.events.KeyCodes.BACKSLASH:<tr><td><a id="l287"></a><a href="#l287">287</a><td>      case goog.events.KeyCodes.OPEN_SQUARE_BRACKET:<tr><td><a id="l288"></a><a href="#l288">288</a><td>      case goog.events.KeyCodes.CLOSE_SQUARE_BRACKET:<tr><td><a id="l289"></a><a href="#l289">289</a><td>      case goog.events.KeyCodes.TILDE:<tr><td><a id="l290"></a><a href="#l290">290</a><td>      case goog.events.KeyCodes.SEMICOLON:<tr><td><a id="l291"></a><a href="#l291">291</a><td>      case goog.events.KeyCodes.DASH:<tr><td><a id="l292"></a><a href="#l292">292</a><td>      case goog.events.KeyCodes.EQUALS:<tr><td><a id="l293"></a><a href="#l293">293</a><td>      case goog.events.KeyCodes.COMMA:<tr><td><a id="l294"></a><a href="#l294">294</a><td>      case goog.events.KeyCodes.PERIOD:<tr><td><a id="l295"></a><a href="#l295">295</a><td>      case goog.events.KeyCodes.SLASH:<tr><td><a id="l296"></a><a href="#l296">296</a><td>      case goog.events.KeyCodes.APOSTROPHE:<tr><td><a id="l297"></a><a href="#l297">297</a><td>      case goog.events.KeyCodes.SINGLE_QUOTE:<tr><td><a id="l298"></a><a href="#l298">298</a><td>        return false;<tr><td><a id="l299"></a><a href="#l299">299</a><td>    }<tr><td><a id="l300"></a><a href="#l300">300</a><td>  }<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td>  // When Ctrl+&lt;somekey&gt; is held in IE, it only fires a keypress once, but it<tr><td><a id="l303"></a><a href="#l303">303</a><td>  // continues to fire keydown events as the event repeats.<tr><td><a id="l304"></a><a href="#l304">304</a><td>  if (goog.userAgent.IE &amp;&amp; opt_ctrlKey &amp;&amp; opt_heldKeyCode == keyCode) {<tr><td><a id="l305"></a><a href="#l305">305</a><td>    return false;<tr><td><a id="l306"></a><a href="#l306">306</a><td>  }<tr><td><a id="l307"></a><a href="#l307">307</a><td><tr><td><a id="l308"></a><a href="#l308">308</a><td>  switch (keyCode) {<tr><td><a id="l309"></a><a href="#l309">309</a><td>    case goog.events.KeyCodes.ENTER:<tr><td><a id="l310"></a><a href="#l310">310</a><td>      return true;<tr><td><a id="l311"></a><a href="#l311">311</a><td>    case goog.events.KeyCodes.ESC:<tr><td><a id="l312"></a><a href="#l312">312</a><td>      return !(goog.userAgent.WEBKIT || goog.userAgent.EDGE);<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>  return goog.events.KeyCodes.isCharacterKey(keyCode);<tr><td><a id="l316"></a><a href="#l316">316</a><td>};<tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td>/**<tr><td><a id="l320"></a><a href="#l320">320</a><td> * Returns true if the key produces a character.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * This does not cover characters on non-US keyboards (Russian, Hebrew, etc.).<tr><td><a id="l322"></a><a href="#l322">322</a><td> *<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @param {number} keyCode A key code.<tr><td><a id="l324"></a><a href="#l324">324</a><td> * @return {boolean} Whether it&#39;s a character key.<tr><td><a id="l325"></a><a href="#l325">325</a><td> */<tr><td><a id="l326"></a><a href="#l326">326</a><td>goog.events.KeyCodes.isCharacterKey = function(keyCode) {<tr><td><a id="l327"></a><a href="#l327">327</a><td>  if (keyCode &gt;= goog.events.KeyCodes.ZERO &amp;&amp;<tr><td><a id="l328"></a><a href="#l328">328</a><td>      keyCode &lt;= goog.events.KeyCodes.NINE) {<tr><td><a id="l329"></a><a href="#l329">329</a><td>    return true;<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>  if (keyCode &gt;= goog.events.KeyCodes.NUM_ZERO &amp;&amp;<tr><td><a id="l333"></a><a href="#l333">333</a><td>      keyCode &lt;= goog.events.KeyCodes.NUM_MULTIPLY) {<tr><td><a id="l334"></a><a href="#l334">334</a><td>    return true;<tr><td><a id="l335"></a><a href="#l335">335</a><td>  }<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td>  if (keyCode &gt;= goog.events.KeyCodes.A &amp;&amp;<tr><td><a id="l338"></a><a href="#l338">338</a><td>      keyCode &lt;= goog.events.KeyCodes.Z) {<tr><td><a id="l339"></a><a href="#l339">339</a><td>    return true;<tr><td><a id="l340"></a><a href="#l340">340</a><td>  }<tr><td><a id="l341"></a><a href="#l341">341</a><td><tr><td><a id="l342"></a><a href="#l342">342</a><td>  // Safari sends zero key code for non-latin characters.<tr><td><a id="l343"></a><a href="#l343">343</a><td>  if ((goog.userAgent.WEBKIT || goog.userAgent.EDGE) &amp;&amp; keyCode == 0) {<tr><td><a id="l344"></a><a href="#l344">344</a><td>    return true;<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>  switch (keyCode) {<tr><td><a id="l348"></a><a href="#l348">348</a><td>    case goog.events.KeyCodes.SPACE:<tr><td><a id="l349"></a><a href="#l349">349</a><td>    case goog.events.KeyCodes.PLUS_SIGN:<tr><td><a id="l350"></a><a href="#l350">350</a><td>    case goog.events.KeyCodes.QUESTION_MARK:<tr><td><a id="l351"></a><a href="#l351">351</a><td>    case goog.events.KeyCodes.AT_SIGN:<tr><td><a id="l352"></a><a href="#l352">352</a><td>    case goog.events.KeyCodes.NUM_PLUS:<tr><td><a id="l353"></a><a href="#l353">353</a><td>    case goog.events.KeyCodes.NUM_MINUS:<tr><td><a id="l354"></a><a href="#l354">354</a><td>    case goog.events.KeyCodes.NUM_PERIOD:<tr><td><a id="l355"></a><a href="#l355">355</a><td>    case goog.events.KeyCodes.NUM_DIVISION:<tr><td><a id="l356"></a><a href="#l356">356</a><td>    case goog.events.KeyCodes.SEMICOLON:<tr><td><a id="l357"></a><a href="#l357">357</a><td>    case goog.events.KeyCodes.FF_SEMICOLON:<tr><td><a id="l358"></a><a href="#l358">358</a><td>    case goog.events.KeyCodes.DASH:<tr><td><a id="l359"></a><a href="#l359">359</a><td>    case goog.events.KeyCodes.EQUALS:<tr><td><a id="l360"></a><a href="#l360">360</a><td>    case goog.events.KeyCodes.FF_EQUALS:<tr><td><a id="l361"></a><a href="#l361">361</a><td>    case goog.events.KeyCodes.COMMA:<tr><td><a id="l362"></a><a href="#l362">362</a><td>    case goog.events.KeyCodes.PERIOD:<tr><td><a id="l363"></a><a href="#l363">363</a><td>    case goog.events.KeyCodes.SLASH:<tr><td><a id="l364"></a><a href="#l364">364</a><td>    case goog.events.KeyCodes.APOSTROPHE:<tr><td><a id="l365"></a><a href="#l365">365</a><td>    case goog.events.KeyCodes.SINGLE_QUOTE:<tr><td><a id="l366"></a><a href="#l366">366</a><td>    case goog.events.KeyCodes.OPEN_SQUARE_BRACKET:<tr><td><a id="l367"></a><a href="#l367">367</a><td>    case goog.events.KeyCodes.BACKSLASH:<tr><td><a id="l368"></a><a href="#l368">368</a><td>    case goog.events.KeyCodes.CLOSE_SQUARE_BRACKET:<tr><td><a id="l369"></a><a href="#l369">369</a><td>      return true;<tr><td><a id="l370"></a><a href="#l370">370</a><td>    default:<tr><td><a id="l371"></a><a href="#l371">371</a><td>      return false;<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>/**<tr><td><a id="l377"></a><a href="#l377">377</a><td> * Normalizes key codes from OS/Browser-specific value to the general one.<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @param {number} keyCode The native key code.<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @return {number} The normalized key code.<tr><td><a id="l380"></a><a href="#l380">380</a><td> */<tr><td><a id="l381"></a><a href="#l381">381</a><td>goog.events.KeyCodes.normalizeKeyCode = function(keyCode) {<tr><td><a id="l382"></a><a href="#l382">382</a><td>  if (goog.userAgent.GECKO) {<tr><td><a id="l383"></a><a href="#l383">383</a><td>    return goog.events.KeyCodes.normalizeGeckoKeyCode(keyCode);<tr><td><a id="l384"></a><a href="#l384">384</a><td>  } else if (goog.userAgent.MAC &amp;&amp; goog.userAgent.WEBKIT) {<tr><td><a id="l385"></a><a href="#l385">385</a><td>    return goog.events.KeyCodes.normalizeMacWebKitKeyCode(keyCode);<tr><td><a id="l386"></a><a href="#l386">386</a><td>  } else {<tr><td><a id="l387"></a><a href="#l387">387</a><td>    return keyCode;<tr><td><a id="l388"></a><a href="#l388">388</a><td>  }<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> * Normalizes key codes from their Gecko-specific value to the general one.<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @param {number} keyCode The native key code.<tr><td><a id="l395"></a><a href="#l395">395</a><td> * @return {number} The normalized key code.<tr><td><a id="l396"></a><a href="#l396">396</a><td> */<tr><td><a id="l397"></a><a href="#l397">397</a><td>goog.events.KeyCodes.normalizeGeckoKeyCode = function(keyCode) {<tr><td><a id="l398"></a><a href="#l398">398</a><td>  switch (keyCode) {<tr><td><a id="l399"></a><a href="#l399">399</a><td>    case goog.events.KeyCodes.FF_EQUALS:<tr><td><a id="l400"></a><a href="#l400">400</a><td>      return goog.events.KeyCodes.EQUALS;<tr><td><a id="l401"></a><a href="#l401">401</a><td>    case goog.events.KeyCodes.FF_SEMICOLON:<tr><td><a id="l402"></a><a href="#l402">402</a><td>      return goog.events.KeyCodes.SEMICOLON;<tr><td><a id="l403"></a><a href="#l403">403</a><td>    case goog.events.KeyCodes.FF_DASH:<tr><td><a id="l404"></a><a href="#l404">404</a><td>      return goog.events.KeyCodes.DASH;<tr><td><a id="l405"></a><a href="#l405">405</a><td>    case goog.events.KeyCodes.MAC_FF_META:<tr><td><a id="l406"></a><a href="#l406">406</a><td>      return goog.events.KeyCodes.META;<tr><td><a id="l407"></a><a href="#l407">407</a><td>    case goog.events.KeyCodes.WIN_KEY_FF_LINUX:<tr><td><a id="l408"></a><a href="#l408">408</a><td>      return goog.events.KeyCodes.WIN_KEY;<tr><td><a id="l409"></a><a href="#l409">409</a><td>    default:<tr><td><a id="l410"></a><a href="#l410">410</a><td>      return keyCode;<tr><td><a id="l411"></a><a href="#l411">411</a><td>  }<tr><td><a id="l412"></a><a href="#l412">412</a><td>};<tr><td><a id="l413"></a><a href="#l413">413</a><td><tr><td><a id="l414"></a><a href="#l414">414</a><td><tr><td><a id="l415"></a><a href="#l415">415</a><td>/**<tr><td><a id="l416"></a><a href="#l416">416</a><td> * Normalizes key codes from their Mac WebKit-specific value to the general one.<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @param {number} keyCode The native key code.<tr><td><a id="l418"></a><a href="#l418">418</a><td> * @return {number} The normalized key code.<tr><td><a id="l419"></a><a href="#l419">419</a><td> */<tr><td><a id="l420"></a><a href="#l420">420</a><td>goog.events.KeyCodes.normalizeMacWebKitKeyCode = function(keyCode) {<tr><td><a id="l421"></a><a href="#l421">421</a><td>  switch (keyCode) {<tr><td><a id="l422"></a><a href="#l422">422</a><td>    case goog.events.KeyCodes.MAC_WK_CMD_RIGHT:  // 93<tr><td><a id="l423"></a><a href="#l423">423</a><td>      return goog.events.KeyCodes.META;          // 91<tr><td><a id="l424"></a><a href="#l424">424</a><td>    default:<tr><td><a id="l425"></a><a href="#l425">425</a><td>      return keyCode;<tr><td><a id="l426"></a><a href="#l426">426</a><td>  }<tr><td><a id="l427"></a><a href="#l427">427</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/listenable.js.src.html b/docs/source/lib/goog/events/listenable.js.src.html
new file mode 100644
index 0000000..61e8c3b
--- /dev/null
+++ b/docs/source/lib/goog/events/listenable.js.src.html
@@ -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>listenable.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/events/listenable.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview An interface for a listenable JavaScript object.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author chrishenry@google.com (Chris Henry)<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.events.Listenable&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.events.ListenableKey&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/** @suppress {extraRequire} */<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.events.EventId&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * A listenable interface. A listenable is an object with the ability<tr><td><a id="l30"></a><a href="#l30">30</a><td> * to dispatch/broadcast events to &quot;event listeners&quot; registered via<tr><td><a id="l31"></a><a href="#l31">31</a><td> * listen/listenOnce.<tr><td><a id="l32"></a><a href="#l32">32</a><td> *<tr><td><a id="l33"></a><a href="#l33">33</a><td> * The interface allows for an event propagation mechanism similar<tr><td><a id="l34"></a><a href="#l34">34</a><td> * to one offered by native browser event targets, such as<tr><td><a id="l35"></a><a href="#l35">35</a><td> * capture/bubble mechanism, stopping propagation, and preventing<tr><td><a id="l36"></a><a href="#l36">36</a><td> * default actions. Capture/bubble mechanism depends on the ancestor<tr><td><a id="l37"></a><a href="#l37">37</a><td> * tree constructed via {@code #getParentEventTarget}; this tree<tr><td><a id="l38"></a><a href="#l38">38</a><td> * must be directed acyclic graph. The meaning of default action(s)<tr><td><a id="l39"></a><a href="#l39">39</a><td> * in preventDefault is specific to a particular use case.<tr><td><a id="l40"></a><a href="#l40">40</a><td> *<tr><td><a id="l41"></a><a href="#l41">41</a><td> * Implementations that do not support capture/bubble or can not have<tr><td><a id="l42"></a><a href="#l42">42</a><td> * a parent listenable can simply not implement any ability to set the<tr><td><a id="l43"></a><a href="#l43">43</a><td> * parent listenable (and have {@code #getParentEventTarget} return<tr><td><a id="l44"></a><a href="#l44">44</a><td> * null).<tr><td><a id="l45"></a><a href="#l45">45</a><td> *<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Implementation of this class can be used with or independently from<tr><td><a id="l47"></a><a href="#l47">47</a><td> * goog.events.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * Implementation must call {@code #addImplementation(implClass)}.<tr><td><a id="l50"></a><a href="#l50">50</a><td> *<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @interface<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @see goog.events<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @see http://www.w3.org/TR/DOM-Level-2-Events/events.html<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.events.Listenable = function() {};<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> * An expando property to indicate that an object implements<tr><td><a id="l60"></a><a href="#l60">60</a><td> * goog.events.Listenable.<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * See addImplementation/isImplementedBy.<tr><td><a id="l63"></a><a href="#l63">63</a><td> *<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @type {string}<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @const<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.events.Listenable.IMPLEMENTED_BY_PROP =<tr><td><a id="l68"></a><a href="#l68">68</a><td>    &#39;closure_listenable_&#39; + ((Math.random() * 1e6) | 0);<tr><td><a id="l69"></a><a href="#l69">69</a><td><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> * Marks a given class (constructor) as an implementation of<tr><td><a id="l73"></a><a href="#l73">73</a><td> * Listenable, do that we can query that fact at runtime. The class<tr><td><a id="l74"></a><a href="#l74">74</a><td> * must have already implemented the interface.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {!Function} cls The class constructor. The corresponding<tr><td><a id="l76"></a><a href="#l76">76</a><td> *     class must have already implemented the interface.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.events.Listenable.addImplementation = function(cls) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>  cls.prototype[goog.events.Listenable.IMPLEMENTED_BY_PROP] = true;<tr><td><a id="l80"></a><a href="#l80">80</a><td>};<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>/**<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {Object} obj The object to check.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @return {boolean} Whether a given instance implements Listenable. The<tr><td><a id="l86"></a><a href="#l86">86</a><td> *     class/superclass of the instance must call addImplementation.<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>goog.events.Listenable.isImplementedBy = function(obj) {<tr><td><a id="l89"></a><a href="#l89">89</a><td>  return !!(obj &amp;&amp; obj[goog.events.Listenable.IMPLEMENTED_BY_PROP]);<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> * Adds an event listener. A listener can only be added once to an<tr><td><a id="l95"></a><a href="#l95">95</a><td> * object and if it is added again the key for the listener is<tr><td><a id="l96"></a><a href="#l96">96</a><td> * returned. Note that if the existing listener is a one-off listener<tr><td><a id="l97"></a><a href="#l97">97</a><td> * (registered via listenOnce), it will no longer be a one-off<tr><td><a id="l98"></a><a href="#l98">98</a><td> * listener after a call to listen().<tr><td><a id="l99"></a><a href="#l99">99</a><td> *<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The event type id.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback<tr><td><a id="l102"></a><a href="#l102">102</a><td> *     method.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @param {boolean=} opt_useCapture Whether to fire in capture phase<tr><td><a id="l104"></a><a href="#l104">104</a><td> *     (defaults to false).<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {SCOPE=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l106"></a><a href="#l106">106</a><td> *     listener.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @return {goog.events.ListenableKey} Unique key for the listener.<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @template SCOPE,EVENTOBJ<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.events.Listenable.prototype.listen;<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> * Adds an event listener that is removed automatically after the<tr><td><a id="l115"></a><a href="#l115">115</a><td> * listener fired once.<tr><td><a id="l116"></a><a href="#l116">116</a><td> *<tr><td><a id="l117"></a><a href="#l117">117</a><td> * If an existing listener already exists, listenOnce will do<tr><td><a id="l118"></a><a href="#l118">118</a><td> * nothing. In particular, if the listener was previously registered<tr><td><a id="l119"></a><a href="#l119">119</a><td> * via listen(), listenOnce() will not turn the listener into a<tr><td><a id="l120"></a><a href="#l120">120</a><td> * one-off listener. Similarly, if there is already an existing<tr><td><a id="l121"></a><a href="#l121">121</a><td> * one-off listener, listenOnce does not modify the listeners (it is<tr><td><a id="l122"></a><a href="#l122">122</a><td> * still a once listener).<tr><td><a id="l123"></a><a href="#l123">123</a><td> *<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The event type id.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback<tr><td><a id="l126"></a><a href="#l126">126</a><td> *     method.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @param {boolean=} opt_useCapture Whether to fire in capture phase<tr><td><a id="l128"></a><a href="#l128">128</a><td> *     (defaults to false).<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {SCOPE=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l130"></a><a href="#l130">130</a><td> *     listener.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @return {goog.events.ListenableKey} Unique key for the listener.<tr><td><a id="l132"></a><a href="#l132">132</a><td> * @template SCOPE,EVENTOBJ<tr><td><a id="l133"></a><a href="#l133">133</a><td> */<tr><td><a id="l134"></a><a href="#l134">134</a><td>goog.events.Listenable.prototype.listenOnce;<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> * Removes an event listener which was added with listen() or listenOnce().<tr><td><a id="l139"></a><a href="#l139">139</a><td> *<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The event type id.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback<tr><td><a id="l142"></a><a href="#l142">142</a><td> *     method.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {boolean=} opt_useCapture Whether to fire in capture phase<tr><td><a id="l144"></a><a href="#l144">144</a><td> *     (defaults to false).<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {SCOPE=} opt_listenerScope Object in whose scope to call<tr><td><a id="l146"></a><a href="#l146">146</a><td> *     the listener.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @return {boolean} Whether any listener was removed.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @template SCOPE,EVENTOBJ<tr><td><a id="l149"></a><a href="#l149">149</a><td> */<tr><td><a id="l150"></a><a href="#l150">150</a><td>goog.events.Listenable.prototype.unlisten;<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * Removes an event listener which was added with listen() by the key<tr><td><a id="l155"></a><a href="#l155">155</a><td> * returned by listen().<tr><td><a id="l156"></a><a href="#l156">156</a><td> *<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @param {goog.events.ListenableKey} key The key returned by<tr><td><a id="l158"></a><a href="#l158">158</a><td> *     listen() or listenOnce().<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @return {boolean} Whether any listener was removed.<tr><td><a id="l160"></a><a href="#l160">160</a><td> */<tr><td><a id="l161"></a><a href="#l161">161</a><td>goog.events.Listenable.prototype.unlistenByKey;<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>/**<tr><td><a id="l165"></a><a href="#l165">165</a><td> * Dispatches an event (or event like object) and calls all listeners<tr><td><a id="l166"></a><a href="#l166">166</a><td> * listening for events of this type. The type of the event is decided by the<tr><td><a id="l167"></a><a href="#l167">167</a><td> * type property on the event object.<tr><td><a id="l168"></a><a href="#l168">168</a><td> *<tr><td><a id="l169"></a><a href="#l169">169</a><td> * If any of the listeners returns false OR calls preventDefault then this<tr><td><a id="l170"></a><a href="#l170">170</a><td> * function will return false.  If one of the capture listeners calls<tr><td><a id="l171"></a><a href="#l171">171</a><td> * stopPropagation, then the bubble listeners won&#39;t fire.<tr><td><a id="l172"></a><a href="#l172">172</a><td> *<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @param {goog.events.EventLike} e Event object.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {boolean} If anyone called preventDefault on the event object (or<tr><td><a id="l175"></a><a href="#l175">175</a><td> *     if any of the listeners returns false) this will also return false.<tr><td><a id="l176"></a><a href="#l176">176</a><td> */<tr><td><a id="l177"></a><a href="#l177">177</a><td>goog.events.Listenable.prototype.dispatchEvent;<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> * Removes all listeners from this listenable. If type is specified,<tr><td><a id="l182"></a><a href="#l182">182</a><td> * it will only remove listeners of the particular type. otherwise all<tr><td><a id="l183"></a><a href="#l183">183</a><td> * registered listeners will be removed.<tr><td><a id="l184"></a><a href="#l184">184</a><td> *<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @param {string=} opt_type Type of event to remove, default is to<tr><td><a id="l186"></a><a href="#l186">186</a><td> *     remove all types.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @return {number} Number of listeners removed.<tr><td><a id="l188"></a><a href="#l188">188</a><td> */<tr><td><a id="l189"></a><a href="#l189">189</a><td>goog.events.Listenable.prototype.removeAllListeners;<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td>/**<tr><td><a id="l193"></a><a href="#l193">193</a><td> * Returns the parent of this event target to use for capture/bubble<tr><td><a id="l194"></a><a href="#l194">194</a><td> * mechanism.<tr><td><a id="l195"></a><a href="#l195">195</a><td> *<tr><td><a id="l196"></a><a href="#l196">196</a><td> * NOTE(chrishenry): The name reflects the original implementation of<tr><td><a id="l197"></a><a href="#l197">197</a><td> * custom event target ({@code goog.events.EventTarget}). We decided<tr><td><a id="l198"></a><a href="#l198">198</a><td> * that changing the name is not worth it.<tr><td><a id="l199"></a><a href="#l199">199</a><td> *<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @return {goog.events.Listenable} The parent EventTarget or null if<tr><td><a id="l201"></a><a href="#l201">201</a><td> *     there is no parent.<tr><td><a id="l202"></a><a href="#l202">202</a><td> */<tr><td><a id="l203"></a><a href="#l203">203</a><td>goog.events.Listenable.prototype.getParentEventTarget;<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * Fires all registered listeners in this listenable for the given<tr><td><a id="l208"></a><a href="#l208">208</a><td> * type and capture mode, passing them the given eventObject. This<tr><td><a id="l209"></a><a href="#l209">209</a><td> * does not perform actual capture/bubble. Only implementors of the<tr><td><a id="l210"></a><a href="#l210">210</a><td> * interface should be using this.<tr><td><a id="l211"></a><a href="#l211">211</a><td> *<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The type of the<tr><td><a id="l213"></a><a href="#l213">213</a><td> *     listeners to fire.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @param {boolean} capture The capture mode of the listeners to fire.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @param {EVENTOBJ} eventObject The event object to fire.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @return {boolean} Whether all listeners succeeded without<tr><td><a id="l217"></a><a href="#l217">217</a><td> *     attempting to prevent default behavior. If any listener returns<tr><td><a id="l218"></a><a href="#l218">218</a><td> *     false or called goog.events.Event#preventDefault, this returns<tr><td><a id="l219"></a><a href="#l219">219</a><td> *     false.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @template EVENTOBJ<tr><td><a id="l221"></a><a href="#l221">221</a><td> */<tr><td><a id="l222"></a><a href="#l222">222</a><td>goog.events.Listenable.prototype.fireListeners;<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td>/**<tr><td><a id="l226"></a><a href="#l226">226</a><td> * Gets all listeners in this listenable for the given type and<tr><td><a id="l227"></a><a href="#l227">227</a><td> * capture mode.<tr><td><a id="l228"></a><a href="#l228">228</a><td> *<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @param {string|!goog.events.EventId} type The type of the listeners to fire.<tr><td><a id="l230"></a><a href="#l230">230</a><td> * @param {boolean} capture The capture mode of the listeners to fire.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @return {!Array&lt;goog.events.ListenableKey&gt;} An array of registered<tr><td><a id="l232"></a><a href="#l232">232</a><td> *     listeners.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @template EVENTOBJ<tr><td><a id="l234"></a><a href="#l234">234</a><td> */<tr><td><a id="l235"></a><a href="#l235">235</a><td>goog.events.Listenable.prototype.getListeners;<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Gets the goog.events.ListenableKey for the event or null if no such<tr><td><a id="l240"></a><a href="#l240">240</a><td> * listener is in use.<tr><td><a id="l241"></a><a href="#l241">241</a><td> *<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;} type The name of the event<tr><td><a id="l243"></a><a href="#l243">243</a><td> *     without the &#39;on&#39; prefix.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener The<tr><td><a id="l245"></a><a href="#l245">245</a><td> *     listener function to get.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @param {boolean} capture Whether the listener is a capturing listener.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @param {SCOPE=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l248"></a><a href="#l248">248</a><td> *     listener.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @return {goog.events.ListenableKey} the found listener or null if not found.<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @template SCOPE,EVENTOBJ<tr><td><a id="l251"></a><a href="#l251">251</a><td> */<tr><td><a id="l252"></a><a href="#l252">252</a><td>goog.events.Listenable.prototype.getListener;<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Whether there is any active listeners matching the specified<tr><td><a id="l257"></a><a href="#l257">257</a><td> * signature. If either the type or capture parameters are<tr><td><a id="l258"></a><a href="#l258">258</a><td> * unspecified, the function will match on the remaining criteria.<tr><td><a id="l259"></a><a href="#l259">259</a><td> *<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @param {string|!goog.events.EventId&lt;EVENTOBJ&gt;=} opt_type Event type.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @param {boolean=} opt_capture Whether to check for capture or bubble<tr><td><a id="l262"></a><a href="#l262">262</a><td> *     listeners.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @return {boolean} Whether there is any active listeners matching<tr><td><a id="l264"></a><a href="#l264">264</a><td> *     the requested type and/or capture phase.<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @template EVENTOBJ<tr><td><a id="l266"></a><a href="#l266">266</a><td> */<tr><td><a id="l267"></a><a href="#l267">267</a><td>goog.events.Listenable.prototype.hasListener;<tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>/**<tr><td><a id="l272"></a><a href="#l272">272</a><td> * An interface that describes a single registered listener.<tr><td><a id="l273"></a><a href="#l273">273</a><td> * @interface<tr><td><a id="l274"></a><a href="#l274">274</a><td> */<tr><td><a id="l275"></a><a href="#l275">275</a><td>goog.events.ListenableKey = function() {};<tr><td><a id="l276"></a><a href="#l276">276</a><td><tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td>/**<tr><td><a id="l279"></a><a href="#l279">279</a><td> * Counter used to create a unique key<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @type {number}<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @private<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.events.ListenableKey.counter_ = 0;<tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td>/**<tr><td><a id="l287"></a><a href="#l287">287</a><td> * Reserves a key to be used for ListenableKey#key field.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @return {number} A number to be used to fill ListenableKey#key<tr><td><a id="l289"></a><a href="#l289">289</a><td> *     field.<tr><td><a id="l290"></a><a href="#l290">290</a><td> */<tr><td><a id="l291"></a><a href="#l291">291</a><td>goog.events.ListenableKey.reserveKey = function() {<tr><td><a id="l292"></a><a href="#l292">292</a><td>  return ++goog.events.ListenableKey.counter_;<tr><td><a id="l293"></a><a href="#l293">293</a><td>};<tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td><tr><td><a id="l296"></a><a href="#l296">296</a><td>/**<tr><td><a id="l297"></a><a href="#l297">297</a><td> * The source event target.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @type {Object|goog.events.Listenable|goog.events.EventTarget}<tr><td><a id="l299"></a><a href="#l299">299</a><td> */<tr><td><a id="l300"></a><a href="#l300">300</a><td>goog.events.ListenableKey.prototype.src;<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td>/**<tr><td><a id="l304"></a><a href="#l304">304</a><td> * The event type the listener is listening to.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @type {string}<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>goog.events.ListenableKey.prototype.type;<tr><td><a id="l308"></a><a href="#l308">308</a><td><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> * The listener function.<tr><td><a id="l312"></a><a href="#l312">312</a><td> * @type {function(?):?|{handleEvent:function(?):?}|null}<tr><td><a id="l313"></a><a href="#l313">313</a><td> */<tr><td><a id="l314"></a><a href="#l314">314</a><td>goog.events.ListenableKey.prototype.listener;<tr><td><a id="l315"></a><a href="#l315">315</a><td><tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td>/**<tr><td><a id="l318"></a><a href="#l318">318</a><td> * Whether the listener works on capture phase.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @type {boolean}<tr><td><a id="l320"></a><a href="#l320">320</a><td> */<tr><td><a id="l321"></a><a href="#l321">321</a><td>goog.events.ListenableKey.prototype.capture;<tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td>/**<tr><td><a id="l325"></a><a href="#l325">325</a><td> * The &#39;this&#39; object for the listener function&#39;s scope.<tr><td><a id="l326"></a><a href="#l326">326</a><td> * @type {Object|undefined}<tr><td><a id="l327"></a><a href="#l327">327</a><td> */<tr><td><a id="l328"></a><a href="#l328">328</a><td>goog.events.ListenableKey.prototype.handler;<tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td><tr><td><a id="l331"></a><a href="#l331">331</a><td>/**<tr><td><a id="l332"></a><a href="#l332">332</a><td> * A globally unique number to identify the key.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @type {number}<tr><td><a id="l334"></a><a href="#l334">334</a><td> */<tr><td><a id="l335"></a><a href="#l335">335</a><td>goog.events.ListenableKey.prototype.key;</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/listener.js.src.html b/docs/source/lib/goog/events/listener.js.src.html
new file mode 100644
index 0000000..22d0c1e
--- /dev/null
+++ b/docs/source/lib/goog/events/listener.js.src.html
@@ -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>listener.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/events/listener.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2005 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Listener object.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @see ../demos/events.html<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.events.Listener&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.events.ListenableKey&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Simple class that stores information about a listener<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @param {!Function} listener Callback function.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {Function} proxy Wrapper for the listener that patches the event.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {EventTarget|goog.events.Listenable} src Source object for<tr><td><a id="l31"></a><a href="#l31">31</a><td> *     the event.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {string} type Event type.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {boolean} capture Whether in capture or bubble phase.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {Object=} opt_handler Object in whose context to execute the callback.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @implements {goog.events.ListenableKey}<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @constructor<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.events.Listener = function(<tr><td><a id="l39"></a><a href="#l39">39</a><td>    listener, proxy, src, type, capture, opt_handler) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>  if (goog.events.Listener.ENABLE_MONITORING) {<tr><td><a id="l41"></a><a href="#l41">41</a><td>    this.creationStack = new Error().stack;<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>   * Callback function.<tr><td><a id="l46"></a><a href="#l46">46</a><td>   * @type {Function}<tr><td><a id="l47"></a><a href="#l47">47</a><td>   */<tr><td><a id="l48"></a><a href="#l48">48</a><td>  this.listener = listener;<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>   * A wrapper over the original listener. This is used solely to<tr><td><a id="l52"></a><a href="#l52">52</a><td>   * handle native browser events (it is used to simulate the capture<tr><td><a id="l53"></a><a href="#l53">53</a><td>   * phase and to patch the event object).<tr><td><a id="l54"></a><a href="#l54">54</a><td>   * @type {Function}<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.proxy = proxy;<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>   * Object or node that callback is listening to<tr><td><a id="l60"></a><a href="#l60">60</a><td>   * @type {EventTarget|goog.events.Listenable}<tr><td><a id="l61"></a><a href="#l61">61</a><td>   */<tr><td><a id="l62"></a><a href="#l62">62</a><td>  this.src = src;<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>   * The event type.<tr><td><a id="l66"></a><a href="#l66">66</a><td>   * @const {string}<tr><td><a id="l67"></a><a href="#l67">67</a><td>   */<tr><td><a id="l68"></a><a href="#l68">68</a><td>  this.type = type;<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>  /**<tr><td><a id="l71"></a><a href="#l71">71</a><td>   * Whether the listener is being called in the capture or bubble phase<tr><td><a id="l72"></a><a href="#l72">72</a><td>   * @const {boolean}<tr><td><a id="l73"></a><a href="#l73">73</a><td>   */<tr><td><a id="l74"></a><a href="#l74">74</a><td>  this.capture = !!capture;<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>  /**<tr><td><a id="l77"></a><a href="#l77">77</a><td>   * Optional object whose context to execute the listener in<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * @type {Object|undefined}<tr><td><a id="l79"></a><a href="#l79">79</a><td>   */<tr><td><a id="l80"></a><a href="#l80">80</a><td>  this.handler = opt_handler;<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>  /**<tr><td><a id="l83"></a><a href="#l83">83</a><td>   * The key of the listener.<tr><td><a id="l84"></a><a href="#l84">84</a><td>   * @const {number}<tr><td><a id="l85"></a><a href="#l85">85</a><td>   * @override<tr><td><a id="l86"></a><a href="#l86">86</a><td>   */<tr><td><a id="l87"></a><a href="#l87">87</a><td>  this.key = goog.events.ListenableKey.reserveKey();<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>   * Whether to remove the listener after it has been called.<tr><td><a id="l91"></a><a href="#l91">91</a><td>   * @type {boolean}<tr><td><a id="l92"></a><a href="#l92">92</a><td>   */<tr><td><a id="l93"></a><a href="#l93">93</a><td>  this.callOnce = 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>  /**<tr><td><a id="l96"></a><a href="#l96">96</a><td>   * Whether the listener has been removed.<tr><td><a id="l97"></a><a href="#l97">97</a><td>   * @type {boolean}<tr><td><a id="l98"></a><a href="#l98">98</a><td>   */<tr><td><a id="l99"></a><a href="#l99">99</a><td>  this.removed = false;<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>/**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @define {boolean} Whether to enable the monitoring of the<tr><td><a id="l105"></a><a href="#l105">105</a><td> *     goog.events.Listener instances. Switching on the monitoring is only<tr><td><a id="l106"></a><a href="#l106">106</a><td> *     recommended for debugging because it has a significant impact on<tr><td><a id="l107"></a><a href="#l107">107</a><td> *     performance and memory usage. If switched off, the monitoring code<tr><td><a id="l108"></a><a href="#l108">108</a><td> *     compiles down to 0 bytes.<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.define(&#39;goog.events.Listener.ENABLE_MONITORING&#39;, 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> * If monitoring the goog.events.Listener instances is enabled, stores the<tr><td><a id="l115"></a><a href="#l115">115</a><td> * creation stack trace of the Disposable instance.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @type {string}<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.events.Listener.prototype.creationStack;<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>/**<tr><td><a id="l122"></a><a href="#l122">122</a><td> * Marks this listener as removed. This also remove references held by<tr><td><a id="l123"></a><a href="#l123">123</a><td> * this listener object (such as listener and event source).<tr><td><a id="l124"></a><a href="#l124">124</a><td> */<tr><td><a id="l125"></a><a href="#l125">125</a><td>goog.events.Listener.prototype.markAsRemoved = function() {<tr><td><a id="l126"></a><a href="#l126">126</a><td>  this.removed = true;<tr><td><a id="l127"></a><a href="#l127">127</a><td>  this.listener = null;<tr><td><a id="l128"></a><a href="#l128">128</a><td>  this.proxy = null;<tr><td><a id="l129"></a><a href="#l129">129</a><td>  this.src = null;<tr><td><a id="l130"></a><a href="#l130">130</a><td>  this.handler = null;<tr><td><a id="l131"></a><a href="#l131">131</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/events/listenermap.js.src.html b/docs/source/lib/goog/events/listenermap.js.src.html
new file mode 100644
index 0000000..67b711e
--- /dev/null
+++ b/docs/source/lib/goog/events/listenermap.js.src.html
@@ -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>listenermap.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/events/listenermap.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A map of listeners that provides utility functions to<tr><td><a id="l17"></a><a href="#l17">17</a><td> * deal with listeners on an event target. Used by<tr><td><a id="l18"></a><a href="#l18">18</a><td> * {@code goog.events.EventTarget}.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * WARNING: Do not use this class from outside goog.events package.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * @visibility {//closure/goog/bin/sizetests:__pkg__}<tr><td><a id="l23"></a><a href="#l23">23</a><td> * @visibility {//closure/goog/events:__pkg__}<tr><td><a id="l24"></a><a href="#l24">24</a><td> * @visibility {//closure/goog/labs/events:__pkg__}<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>goog.provide(&#39;goog.events.ListenerMap&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.events.Listener&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * Creates a new listener map.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {EventTarget|goog.events.Listenable} src The src object.<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.events.ListenerMap = function(src) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  /** @type {EventTarget|goog.events.Listenable} */<tr><td><a id="l43"></a><a href="#l43">43</a><td>  this.src = src;<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>  /**<tr><td><a id="l46"></a><a href="#l46">46</a><td>   * Maps of event type to an array of listeners.<tr><td><a id="l47"></a><a href="#l47">47</a><td>   * @type {Object&lt;string, !Array&lt;!goog.events.Listener&gt;&gt;}<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.listeners = {};<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>   * The count of types in this map that have registered listeners.<tr><td><a id="l53"></a><a href="#l53">53</a><td>   * @private {number}<tr><td><a id="l54"></a><a href="#l54">54</a><td>   */<tr><td><a id="l55"></a><a href="#l55">55</a><td>  this.typeCount_ = 0;<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>/**<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @return {number} The count of event types in this map that actually<tr><td><a id="l61"></a><a href="#l61">61</a><td> *     have registered listeners.<tr><td><a id="l62"></a><a href="#l62">62</a><td> */<tr><td><a id="l63"></a><a href="#l63">63</a><td>goog.events.ListenerMap.prototype.getTypeCount = function() {<tr><td><a id="l64"></a><a href="#l64">64</a><td>  return this.typeCount_;<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>/**<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @return {number} Total number of registered listeners.<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>goog.events.ListenerMap.prototype.getListenerCount = function() {<tr><td><a id="l72"></a><a href="#l72">72</a><td>  var count = 0;<tr><td><a id="l73"></a><a href="#l73">73</a><td>  for (var type in this.listeners) {<tr><td><a id="l74"></a><a href="#l74">74</a><td>    count += this.listeners[type].length;<tr><td><a id="l75"></a><a href="#l75">75</a><td>  }<tr><td><a id="l76"></a><a href="#l76">76</a><td>  return count;<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>/**<tr><td><a id="l81"></a><a href="#l81">81</a><td> * Adds an event listener. A listener can only be added once to an<tr><td><a id="l82"></a><a href="#l82">82</a><td> * object and if it is added again the key for the listener is<tr><td><a id="l83"></a><a href="#l83">83</a><td> * returned.<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 that a one-off listener will not change an existing listener,<tr><td><a id="l86"></a><a href="#l86">86</a><td> * if any. On the other hand a normal listener will change existing<tr><td><a id="l87"></a><a href="#l87">87</a><td> * one-off listener to become a normal listener.<tr><td><a id="l88"></a><a href="#l88">88</a><td> *<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @param {string|!goog.events.EventId} type The listener event type.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @param {!Function} listener This listener callback method.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @param {boolean} callOnce Whether the listener is a one-off<tr><td><a id="l92"></a><a href="#l92">92</a><td> *     listener.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @param {boolean=} opt_useCapture The capture mode of the listener.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @param {Object=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l95"></a><a href="#l95">95</a><td> *     listener.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @return {goog.events.ListenableKey} Unique key for the listener.<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.events.ListenerMap.prototype.add = function(<tr><td><a id="l99"></a><a href="#l99">99</a><td>    type, listener, callOnce, opt_useCapture, opt_listenerScope) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  var typeStr = type.toString();<tr><td><a id="l101"></a><a href="#l101">101</a><td>  var listenerArray = this.listeners[typeStr];<tr><td><a id="l102"></a><a href="#l102">102</a><td>  if (!listenerArray) {<tr><td><a id="l103"></a><a href="#l103">103</a><td>    listenerArray = this.listeners[typeStr] = [];<tr><td><a id="l104"></a><a href="#l104">104</a><td>    this.typeCount_++;<tr><td><a id="l105"></a><a href="#l105">105</a><td>  }<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td>  var listenerObj;<tr><td><a id="l108"></a><a href="#l108">108</a><td>  var index = goog.events.ListenerMap.findListenerIndex_(<tr><td><a id="l109"></a><a href="#l109">109</a><td>      listenerArray, listener, opt_useCapture, opt_listenerScope);<tr><td><a id="l110"></a><a href="#l110">110</a><td>  if (index &gt; -1) {<tr><td><a id="l111"></a><a href="#l111">111</a><td>    listenerObj = listenerArray[index];<tr><td><a id="l112"></a><a href="#l112">112</a><td>    if (!callOnce) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>      // Ensure that, if there is an existing callOnce listener, it is no<tr><td><a id="l114"></a><a href="#l114">114</a><td>      // longer a callOnce listener.<tr><td><a id="l115"></a><a href="#l115">115</a><td>      listenerObj.callOnce = false;<tr><td><a id="l116"></a><a href="#l116">116</a><td>    }<tr><td><a id="l117"></a><a href="#l117">117</a><td>  } else {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    listenerObj = new goog.events.Listener(<tr><td><a id="l119"></a><a href="#l119">119</a><td>        listener, null, this.src, typeStr, !!opt_useCapture, opt_listenerScope);<tr><td><a id="l120"></a><a href="#l120">120</a><td>    listenerObj.callOnce = callOnce;<tr><td><a id="l121"></a><a href="#l121">121</a><td>    listenerArray.push(listenerObj);<tr><td><a id="l122"></a><a href="#l122">122</a><td>  }<tr><td><a id="l123"></a><a href="#l123">123</a><td>  return listenerObj;<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> * Removes a matching listener.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {string|!goog.events.EventId} type The listener event type.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {!Function} listener This listener callback method.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @param {boolean=} opt_useCapture The capture mode of the listener.<tr><td><a id="l132"></a><a href="#l132">132</a><td> * @param {Object=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l133"></a><a href="#l133">133</a><td> *     listener.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @return {boolean} Whether any listener was removed.<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td>goog.events.ListenerMap.prototype.remove = function(<tr><td><a id="l137"></a><a href="#l137">137</a><td>    type, listener, opt_useCapture, opt_listenerScope) {<tr><td><a id="l138"></a><a href="#l138">138</a><td>  var typeStr = type.toString();<tr><td><a id="l139"></a><a href="#l139">139</a><td>  if (!(typeStr in this.listeners)) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>    return false;<tr><td><a id="l141"></a><a href="#l141">141</a><td>  }<tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>  var listenerArray = this.listeners[typeStr];<tr><td><a id="l144"></a><a href="#l144">144</a><td>  var index = goog.events.ListenerMap.findListenerIndex_(<tr><td><a id="l145"></a><a href="#l145">145</a><td>      listenerArray, listener, opt_useCapture, opt_listenerScope);<tr><td><a id="l146"></a><a href="#l146">146</a><td>  if (index &gt; -1) {<tr><td><a id="l147"></a><a href="#l147">147</a><td>    var listenerObj = listenerArray[index];<tr><td><a id="l148"></a><a href="#l148">148</a><td>    listenerObj.markAsRemoved();<tr><td><a id="l149"></a><a href="#l149">149</a><td>    goog.array.removeAt(listenerArray, index);<tr><td><a id="l150"></a><a href="#l150">150</a><td>    if (listenerArray.length == 0) {<tr><td><a id="l151"></a><a href="#l151">151</a><td>      delete this.listeners[typeStr];<tr><td><a id="l152"></a><a href="#l152">152</a><td>      this.typeCount_--;<tr><td><a id="l153"></a><a href="#l153">153</a><td>    }<tr><td><a id="l154"></a><a href="#l154">154</a><td>    return true;<tr><td><a id="l155"></a><a href="#l155">155</a><td>  }<tr><td><a id="l156"></a><a href="#l156">156</a><td>  return false;<tr><td><a id="l157"></a><a href="#l157">157</a><td>};<tr><td><a id="l158"></a><a href="#l158">158</a><td><tr><td><a id="l159"></a><a href="#l159">159</a><td><tr><td><a id="l160"></a><a href="#l160">160</a><td>/**<tr><td><a id="l161"></a><a href="#l161">161</a><td> * Removes the given listener object.<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @param {goog.events.ListenableKey} listener The listener to remove.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @return {boolean} Whether the listener is removed.<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.events.ListenerMap.prototype.removeByKey = function(listener) {<tr><td><a id="l166"></a><a href="#l166">166</a><td>  var type = listener.type;<tr><td><a id="l167"></a><a href="#l167">167</a><td>  if (!(type in this.listeners)) {<tr><td><a id="l168"></a><a href="#l168">168</a><td>    return false;<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>  var removed = goog.array.remove(this.listeners[type], listener);<tr><td><a id="l172"></a><a href="#l172">172</a><td>  if (removed) {<tr><td><a id="l173"></a><a href="#l173">173</a><td>    listener.markAsRemoved();<tr><td><a id="l174"></a><a href="#l174">174</a><td>    if (this.listeners[type].length == 0) {<tr><td><a id="l175"></a><a href="#l175">175</a><td>      delete this.listeners[type];<tr><td><a id="l176"></a><a href="#l176">176</a><td>      this.typeCount_--;<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>  return removed;<tr><td><a id="l180"></a><a href="#l180">180</a><td>};<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Removes all listeners from this map. If opt_type is provided, only<tr><td><a id="l185"></a><a href="#l185">185</a><td> * listeners that match the given type are removed.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @param {string|!goog.events.EventId=} opt_type Type of event to remove.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @return {number} Number of listeners removed.<tr><td><a id="l188"></a><a href="#l188">188</a><td> */<tr><td><a id="l189"></a><a href="#l189">189</a><td>goog.events.ListenerMap.prototype.removeAll = function(opt_type) {<tr><td><a id="l190"></a><a href="#l190">190</a><td>  var typeStr = opt_type &amp;&amp; opt_type.toString();<tr><td><a id="l191"></a><a href="#l191">191</a><td>  var count = 0;<tr><td><a id="l192"></a><a href="#l192">192</a><td>  for (var type in this.listeners) {<tr><td><a id="l193"></a><a href="#l193">193</a><td>    if (!typeStr || type == typeStr) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>      var listenerArray = this.listeners[type];<tr><td><a id="l195"></a><a href="#l195">195</a><td>      for (var i = 0; i &lt; listenerArray.length; i++) {<tr><td><a id="l196"></a><a href="#l196">196</a><td>        ++count;<tr><td><a id="l197"></a><a href="#l197">197</a><td>        listenerArray[i].markAsRemoved();<tr><td><a id="l198"></a><a href="#l198">198</a><td>      }<tr><td><a id="l199"></a><a href="#l199">199</a><td>      delete this.listeners[type];<tr><td><a id="l200"></a><a href="#l200">200</a><td>      this.typeCount_--;<tr><td><a id="l201"></a><a href="#l201">201</a><td>    }<tr><td><a id="l202"></a><a href="#l202">202</a><td>  }<tr><td><a id="l203"></a><a href="#l203">203</a><td>  return count;<tr><td><a id="l204"></a><a href="#l204">204</a><td>};<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td>/**<tr><td><a id="l208"></a><a href="#l208">208</a><td> * Gets all listeners that match the given type and capture mode. The<tr><td><a id="l209"></a><a href="#l209">209</a><td> * returned array is a copy (but the listener objects are not).<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {string|!goog.events.EventId} type The type of the listeners<tr><td><a id="l211"></a><a href="#l211">211</a><td> *     to retrieve.<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @param {boolean} capture The capture mode of the listeners to retrieve.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @return {!Array&lt;goog.events.ListenableKey&gt;} An array of matching<tr><td><a id="l214"></a><a href="#l214">214</a><td> *     listeners.<tr><td><a id="l215"></a><a href="#l215">215</a><td> */<tr><td><a id="l216"></a><a href="#l216">216</a><td>goog.events.ListenerMap.prototype.getListeners = function(type, capture) {<tr><td><a id="l217"></a><a href="#l217">217</a><td>  var listenerArray = this.listeners[type.toString()];<tr><td><a id="l218"></a><a href="#l218">218</a><td>  var rv = [];<tr><td><a id="l219"></a><a href="#l219">219</a><td>  if (listenerArray) {<tr><td><a id="l220"></a><a href="#l220">220</a><td>    for (var i = 0; i &lt; listenerArray.length; ++i) {<tr><td><a id="l221"></a><a href="#l221">221</a><td>      var listenerObj = listenerArray[i];<tr><td><a id="l222"></a><a href="#l222">222</a><td>      if (listenerObj.capture == capture) {<tr><td><a id="l223"></a><a href="#l223">223</a><td>        rv.push(listenerObj);<tr><td><a id="l224"></a><a href="#l224">224</a><td>      }<tr><td><a id="l225"></a><a href="#l225">225</a><td>    }<tr><td><a id="l226"></a><a href="#l226">226</a><td>  }<tr><td><a id="l227"></a><a href="#l227">227</a><td>  return rv;<tr><td><a id="l228"></a><a href="#l228">228</a><td>};<tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>/**<tr><td><a id="l232"></a><a href="#l232">232</a><td> * Gets the goog.events.ListenableKey for the event or null if no such<tr><td><a id="l233"></a><a href="#l233">233</a><td> * listener is in use.<tr><td><a id="l234"></a><a href="#l234">234</a><td> *<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @param {string|!goog.events.EventId} type The type of the listener<tr><td><a id="l236"></a><a href="#l236">236</a><td> *     to retrieve.<tr><td><a id="l237"></a><a href="#l237">237</a><td> * @param {!Function} listener The listener function to get.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @param {boolean} capture Whether the listener is a capturing listener.<tr><td><a id="l239"></a><a href="#l239">239</a><td> * @param {Object=} opt_listenerScope Object in whose scope to call the<tr><td><a id="l240"></a><a href="#l240">240</a><td> *     listener.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @return {goog.events.ListenableKey} the found listener or null if not found.<tr><td><a id="l242"></a><a href="#l242">242</a><td> */<tr><td><a id="l243"></a><a href="#l243">243</a><td>goog.events.ListenerMap.prototype.getListener = function(<tr><td><a id="l244"></a><a href="#l244">244</a><td>    type, listener, capture, opt_listenerScope) {<tr><td><a id="l245"></a><a href="#l245">245</a><td>  var listenerArray = this.listeners[type.toString()];<tr><td><a id="l246"></a><a href="#l246">246</a><td>  var i = -1;<tr><td><a id="l247"></a><a href="#l247">247</a><td>  if (listenerArray) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>    i = goog.events.ListenerMap.findListenerIndex_(<tr><td><a id="l249"></a><a href="#l249">249</a><td>        listenerArray, listener, capture, opt_listenerScope);<tr><td><a id="l250"></a><a href="#l250">250</a><td>  }<tr><td><a id="l251"></a><a href="#l251">251</a><td>  return i &gt; -1 ? listenerArray[i] : null;<tr><td><a id="l252"></a><a href="#l252">252</a><td>};<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Whether there is a matching listener. If either the type or capture<tr><td><a id="l257"></a><a href="#l257">257</a><td> * parameters are unspecified, the function will match on the<tr><td><a id="l258"></a><a href="#l258">258</a><td> * remaining criteria.<tr><td><a id="l259"></a><a href="#l259">259</a><td> *<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @param {string|!goog.events.EventId=} opt_type The type of the listener.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @param {boolean=} opt_capture The capture mode of the listener.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @return {boolean} Whether there is an active listener matching<tr><td><a id="l263"></a><a href="#l263">263</a><td> *     the requested type and/or capture phase.<tr><td><a id="l264"></a><a href="#l264">264</a><td> */<tr><td><a id="l265"></a><a href="#l265">265</a><td>goog.events.ListenerMap.prototype.hasListener = function(<tr><td><a id="l266"></a><a href="#l266">266</a><td>    opt_type, opt_capture) {<tr><td><a id="l267"></a><a href="#l267">267</a><td>  var hasType = goog.isDef(opt_type);<tr><td><a id="l268"></a><a href="#l268">268</a><td>  var typeStr = hasType ? opt_type.toString() : &#39;&#39;;<tr><td><a id="l269"></a><a href="#l269">269</a><td>  var hasCapture = goog.isDef(opt_capture);<tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>  return goog.object.some(<tr><td><a id="l272"></a><a href="#l272">272</a><td>      this.listeners, function(listenerArray, type) {<tr><td><a id="l273"></a><a href="#l273">273</a><td>        for (var i = 0; i &lt; listenerArray.length; ++i) {<tr><td><a id="l274"></a><a href="#l274">274</a><td>          if ((!hasType || listenerArray[i].type == typeStr) &amp;&amp;<tr><td><a id="l275"></a><a href="#l275">275</a><td>              (!hasCapture || listenerArray[i].capture == opt_capture)) {<tr><td><a id="l276"></a><a href="#l276">276</a><td>            return true;<tr><td><a id="l277"></a><a href="#l277">277</a><td>          }<tr><td><a id="l278"></a><a href="#l278">278</a><td>        }<tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td>        return false;<tr><td><a id="l281"></a><a href="#l281">281</a><td>      });<tr><td><a id="l282"></a><a href="#l282">282</a><td>};<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td>/**<tr><td><a id="l286"></a><a href="#l286">286</a><td> * Finds the index of a matching goog.events.Listener in the given<tr><td><a id="l287"></a><a href="#l287">287</a><td> * listenerArray.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @param {!Array&lt;!goog.events.Listener&gt;} listenerArray Array of listener.<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @param {!Function} listener The listener function.<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @param {boolean=} opt_useCapture The capture flag for the listener.<tr><td><a id="l291"></a><a href="#l291">291</a><td> * @param {Object=} opt_listenerScope The listener scope.<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @return {number} The index of the matching listener within the<tr><td><a id="l293"></a><a href="#l293">293</a><td> *     listenerArray.<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @private<tr><td><a id="l295"></a><a href="#l295">295</a><td> */<tr><td><a id="l296"></a><a href="#l296">296</a><td>goog.events.ListenerMap.findListenerIndex_ = function(<tr><td><a id="l297"></a><a href="#l297">297</a><td>    listenerArray, listener, opt_useCapture, opt_listenerScope) {<tr><td><a id="l298"></a><a href="#l298">298</a><td>  for (var i = 0; i &lt; listenerArray.length; ++i) {<tr><td><a id="l299"></a><a href="#l299">299</a><td>    var listenerObj = listenerArray[i];<tr><td><a id="l300"></a><a href="#l300">300</a><td>    if (!listenerObj.removed &amp;&amp;<tr><td><a id="l301"></a><a href="#l301">301</a><td>        listenerObj.listener == listener &amp;&amp;<tr><td><a id="l302"></a><a href="#l302">302</a><td>        listenerObj.capture == !!opt_useCapture &amp;&amp;<tr><td><a id="l303"></a><a href="#l303">303</a><td>        listenerObj.handler == opt_listenerScope) {<tr><td><a id="l304"></a><a href="#l304">304</a><td>      return i;<tr><td><a id="l305"></a><a href="#l305">305</a><td>    }<tr><td><a id="l306"></a><a href="#l306">306</a><td>  }<tr><td><a id="l307"></a><a href="#l307">307</a><td>  return -1;<tr><td><a id="l308"></a><a href="#l308">308</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/fs/url.js.src.html b/docs/source/lib/goog/fs/url.js.src.html
new file mode 100644
index 0000000..7d7bb87
--- /dev/null
+++ b/docs/source/lib/goog/fs/url.js.src.html
@@ -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>url.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/fs/url.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2015 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Wrapper for URL and its createObjectUrl and revokeObjectUrl<tr><td><a id="l17"></a><a href="#l17">17</a><td> * methods that are part of the HTML5 File API.<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.fs.url&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/**<tr><td><a id="l24"></a><a href="#l24">24</a><td> * Creates a blob URL for a blob object.<tr><td><a id="l25"></a><a href="#l25">25</a><td> * Throws an error if the browser does not support Object Urls.<tr><td><a id="l26"></a><a href="#l26">26</a><td> *<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {!Blob} blob The object for which to create the URL.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @return {string} The URL for the object.<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.fs.url.createObjectUrl = function(blob) {<tr><td><a id="l31"></a><a href="#l31">31</a><td>  return goog.fs.url.getUrlObject_().createObjectURL(blob);<tr><td><a id="l32"></a><a href="#l32">32</a><td>};<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * Revokes a URL created by {@link goog.fs.url.createObjectUrl}.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * Throws an error if the browser does not support Object Urls.<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @param {string} url The URL to revoke.<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.fs.url.revokeObjectUrl = function(url) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  goog.fs.url.getUrlObject_().revokeObjectURL(url);<tr><td><a id="l43"></a><a href="#l43">43</a><td>};<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @typedef {{createObjectURL: (function(!Blob): string),<tr><td><a id="l48"></a><a href="#l48">48</a><td> *            revokeObjectURL: function(string): void}}<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.fs.url.UrlObject_;<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Get the object that has the createObjectURL and revokeObjectURL functions for<tr><td><a id="l55"></a><a href="#l55">55</a><td> * this browser.<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @return {goog.fs.url.UrlObject_} The object for this browser.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @private<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.fs.url.getUrlObject_ = function() {<tr><td><a id="l61"></a><a href="#l61">61</a><td>  var urlObject = goog.fs.url.findUrlObject_();<tr><td><a id="l62"></a><a href="#l62">62</a><td>  if (urlObject != null) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>    return urlObject;<tr><td><a id="l64"></a><a href="#l64">64</a><td>  } else {<tr><td><a id="l65"></a><a href="#l65">65</a><td>    throw Error(&#39;This browser doesn\&#39;t seem to support blob URLs&#39;);<tr><td><a id="l66"></a><a href="#l66">66</a><td>  }<tr><td><a id="l67"></a><a href="#l67">67</a><td>};<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>/**<tr><td><a id="l71"></a><a href="#l71">71</a><td> * Finds the object that has the createObjectURL and revokeObjectURL functions<tr><td><a id="l72"></a><a href="#l72">72</a><td> * for this browser.<tr><td><a id="l73"></a><a href="#l73">73</a><td> *<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @return {?goog.fs.url.UrlObject_} The object for this browser or null if the<tr><td><a id="l75"></a><a href="#l75">75</a><td> *     browser does not support Object Urls.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @suppress {unnecessaryCasts} Depending on how the code is compiled, casting<tr><td><a id="l77"></a><a href="#l77">77</a><td> *     goog.global to UrlObject_ may result in unnecessary cast warning.<tr><td><a id="l78"></a><a href="#l78">78</a><td> *     However, the cast cannot be removed because with different set of<tr><td><a id="l79"></a><a href="#l79">79</a><td> *     compiler flags, the cast is indeed necessary.  As such, silencing it.<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @private<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.fs.url.findUrlObject_ = function() {<tr><td><a id="l83"></a><a href="#l83">83</a><td>  // This is what the spec says to do<tr><td><a id="l84"></a><a href="#l84">84</a><td>  // http://dev.w3.org/2006/webapi/FileAPI/#dfn-createObjectURL<tr><td><a id="l85"></a><a href="#l85">85</a><td>  if (goog.isDef(goog.global.URL) &amp;&amp;<tr><td><a id="l86"></a><a href="#l86">86</a><td>      goog.isDef(goog.global.URL.createObjectURL)) {<tr><td><a id="l87"></a><a href="#l87">87</a><td>    return /** @type {goog.fs.url.UrlObject_} */ (goog.global.URL);<tr><td><a id="l88"></a><a href="#l88">88</a><td>  // This is what Chrome does (as of 10.0.648.6 dev)<tr><td><a id="l89"></a><a href="#l89">89</a><td>  } else if (goog.isDef(goog.global.webkitURL) &amp;&amp;<tr><td><a id="l90"></a><a href="#l90">90</a><td>             goog.isDef(goog.global.webkitURL.createObjectURL)) {<tr><td><a id="l91"></a><a href="#l91">91</a><td>    return /** @type {goog.fs.url.UrlObject_} */ (goog.global.webkitURL);<tr><td><a id="l92"></a><a href="#l92">92</a><td>  // This is what the spec used to say to do<tr><td><a id="l93"></a><a href="#l93">93</a><td>  } else if (goog.isDef(goog.global.createObjectURL)) {<tr><td><a id="l94"></a><a href="#l94">94</a><td>    return /** @type {goog.fs.url.UrlObject_} */ (goog.global);<tr><td><a id="l95"></a><a href="#l95">95</a><td>  } else {<tr><td><a id="l96"></a><a href="#l96">96</a><td>    return null;<tr><td><a id="l97"></a><a href="#l97">97</a><td>  }<tr><td><a id="l98"></a><a href="#l98">98</a><td>};<tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td>/**<tr><td><a id="l102"></a><a href="#l102">102</a><td> * Checks whether this browser supports Object Urls. If not, calls to<tr><td><a id="l103"></a><a href="#l103">103</a><td> * createObjectUrl and revokeObjectUrl will result in an error.<tr><td><a id="l104"></a><a href="#l104">104</a><td> *<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @return {boolean} True if this browser supports Object Urls.<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.fs.url.browserSupportsObjectUrls = function() {<tr><td><a id="l108"></a><a href="#l108">108</a><td>  return goog.fs.url.findUrlObject_() != null;<tr><td><a id="l109"></a><a href="#l109">109</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/functions/functions.js.src.html b/docs/source/lib/goog/functions/functions.js.src.html
new file mode 100644
index 0000000..b64eaf8
--- /dev/null
+++ b/docs/source/lib/goog/functions/functions.js.src.html
@@ -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>functions.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/functions/functions.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities for creating functions. Loosely inspired by the<tr><td><a id="l17"></a><a href="#l17">17</a><td> * java classes: http://goo.gl/GM0Hmu and http://goo.gl/6k7nI8.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * @author nicksantos@google.com (Nick Santos)<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<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>goog.provide(&#39;goog.functions&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Creates a function that always returns the same value.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @param {T} retValue The value to return.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @return {function():T} The new function.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @template T<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.functions.constant = function(retValue) {<tr><td><a id="l33"></a><a href="#l33">33</a><td>  return function() {<tr><td><a id="l34"></a><a href="#l34">34</a><td>    return retValue;<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><tr><td><a id="l39"></a><a href="#l39">39</a><td>/**<tr><td><a id="l40"></a><a href="#l40">40</a><td> * Always returns false.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @type {function(...): boolean}<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.functions.FALSE = goog.functions.constant(false);<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * Always returns true.<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @type {function(...): boolean}<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.functions.TRUE = goog.functions.constant(true);<tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Always returns NULL.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @type {function(...): null}<tr><td><a id="l56"></a><a href="#l56">56</a><td> */<tr><td><a id="l57"></a><a href="#l57">57</a><td>goog.functions.NULL = goog.functions.constant(null);<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> * A simple function that returns the first argument of whatever is passed<tr><td><a id="l62"></a><a href="#l62">62</a><td> * into it.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {T=} opt_returnValue The single value that will be returned.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @param {...*} var_args Optional trailing arguments. These are ignored.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @return {T} The first argument passed in, or undefined if nothing was passed.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @template T<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.functions.identity = function(opt_returnValue, var_args) {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  return opt_returnValue;<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> * Creates a function that always throws an error with the given message.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {string} message The error message.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {!Function} The error-throwing function.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.functions.error = function(message) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>  return function() {<tr><td><a id="l80"></a><a href="#l80">80</a><td>    throw Error(message);<tr><td><a id="l81"></a><a href="#l81">81</a><td>  };<tr><td><a id="l82"></a><a href="#l82">82</a><td>};<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Creates a function that throws the given object.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @param {*} err An object to be thrown.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @return {!Function} The error-throwing function.<tr><td><a id="l89"></a><a href="#l89">89</a><td> */<tr><td><a id="l90"></a><a href="#l90">90</a><td>goog.functions.fail = function(err) {<tr><td><a id="l91"></a><a href="#l91">91</a><td>  return function() {<tr><td><a id="l92"></a><a href="#l92">92</a><td>    throw err;<tr><td><a id="l93"></a><a href="#l93">93</a><td>  }<tr><td><a id="l94"></a><a href="#l94">94</a><td>};<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Given a function, create a function that keeps opt_numArgs arguments and<tr><td><a id="l99"></a><a href="#l99">99</a><td> * silently discards all additional arguments.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {Function} f The original function.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {number=} opt_numArgs The number of arguments to keep. Defaults to 0.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @return {!Function} A version of f that only keeps the first opt_numArgs<tr><td><a id="l103"></a><a href="#l103">103</a><td> *     arguments.<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.functions.lock = function(f, opt_numArgs) {<tr><td><a id="l106"></a><a href="#l106">106</a><td>  opt_numArgs = opt_numArgs || 0;<tr><td><a id="l107"></a><a href="#l107">107</a><td>  return function() {<tr><td><a id="l108"></a><a href="#l108">108</a><td>    return f.apply(this, Array.prototype.slice.call(arguments, 0, opt_numArgs));<tr><td><a id="l109"></a><a href="#l109">109</a><td>  };<tr><td><a id="l110"></a><a href="#l110">110</a><td>};<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td>/**<tr><td><a id="l114"></a><a href="#l114">114</a><td> * Creates a function that returns its nth argument.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {number} n The position of the return argument.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @return {!Function} A new function.<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.functions.nth = function(n) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>  return function() {<tr><td><a id="l120"></a><a href="#l120">120</a><td>    return arguments[n];<tr><td><a id="l121"></a><a href="#l121">121</a><td>  };<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<tr><td><a id="l123"></a><a href="#l123">123</a><td><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> * Given a function, create a new function that swallows its return value<tr><td><a id="l127"></a><a href="#l127">127</a><td> * and replaces it with a new one.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {Function} f A function.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {T} retValue A new return value.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @return {function(...?):T} A new function.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @template T<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>goog.functions.withReturnValue = function(f, retValue) {<tr><td><a id="l134"></a><a href="#l134">134</a><td>  return goog.functions.sequence(f, goog.functions.constant(retValue));<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> * Creates a function that returns whether its arguement equals the given value.<tr><td><a id="l140"></a><a href="#l140">140</a><td> *<tr><td><a id="l141"></a><a href="#l141">141</a><td> * Example:<tr><td><a id="l142"></a><a href="#l142">142</a><td> * var key = goog.object.findKey(obj, goog.functions.equalTo(&#39;needle&#39;));<tr><td><a id="l143"></a><a href="#l143">143</a><td> *<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @param {*} value The value to compare to.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {boolean=} opt_useLooseComparison Whether to use a loose (==)<tr><td><a id="l146"></a><a href="#l146">146</a><td> *     comparison rather than a strict (===) one. Defaults to false.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @return {function(*):boolean} The new function.<tr><td><a id="l148"></a><a href="#l148">148</a><td> */<tr><td><a id="l149"></a><a href="#l149">149</a><td>goog.functions.equalTo = function(value, opt_useLooseComparison) {<tr><td><a id="l150"></a><a href="#l150">150</a><td>  return function(other) {<tr><td><a id="l151"></a><a href="#l151">151</a><td>    return opt_useLooseComparison ? (value == other) : (value === other);<tr><td><a id="l152"></a><a href="#l152">152</a><td>  };<tr><td><a id="l153"></a><a href="#l153">153</a><td>};<tr><td><a id="l154"></a><a href="#l154">154</a><td><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> * Creates the composition of the functions passed in.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * For example, (goog.functions.compose(f, g))(a) is equivalent to f(g(a)).<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @param {function(...?):T} fn The final function.<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @param {...Function} var_args A list of functions.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @return {function(...?):T} The composition of all inputs.<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @template T<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.functions.compose = function(fn, var_args) {<tr><td><a id="l165"></a><a href="#l165">165</a><td>  var functions = arguments;<tr><td><a id="l166"></a><a href="#l166">166</a><td>  var length = functions.length;<tr><td><a id="l167"></a><a href="#l167">167</a><td>  return function() {<tr><td><a id="l168"></a><a href="#l168">168</a><td>    var result;<tr><td><a id="l169"></a><a href="#l169">169</a><td>    if (length) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>      result = functions[length - 1].apply(this, arguments);<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>    for (var i = length - 2; i &gt;= 0; i--) {<tr><td><a id="l174"></a><a href="#l174">174</a><td>      result = functions[i].call(this, result);<tr><td><a id="l175"></a><a href="#l175">175</a><td>    }<tr><td><a id="l176"></a><a href="#l176">176</a><td>    return result;<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>/**<tr><td><a id="l182"></a><a href="#l182">182</a><td> * Creates a function that calls the functions passed in in sequence, and<tr><td><a id="l183"></a><a href="#l183">183</a><td> * returns the value of the last function. For example,<tr><td><a id="l184"></a><a href="#l184">184</a><td> * (goog.functions.sequence(f, g))(x) is equivalent to f(x),g(x).<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @param {...Function} var_args A list of functions.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @return {!Function} A function that calls all inputs in sequence.<tr><td><a id="l187"></a><a href="#l187">187</a><td> */<tr><td><a id="l188"></a><a href="#l188">188</a><td>goog.functions.sequence = function(var_args) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>  var functions = arguments;<tr><td><a id="l190"></a><a href="#l190">190</a><td>  var length = functions.length;<tr><td><a id="l191"></a><a href="#l191">191</a><td>  return function() {<tr><td><a id="l192"></a><a href="#l192">192</a><td>    var result;<tr><td><a id="l193"></a><a href="#l193">193</a><td>    for (var i = 0; i &lt; length; i++) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>      result = functions[i].apply(this, arguments);<tr><td><a id="l195"></a><a href="#l195">195</a><td>    }<tr><td><a id="l196"></a><a href="#l196">196</a><td>    return result;<tr><td><a id="l197"></a><a href="#l197">197</a><td>  };<tr><td><a id="l198"></a><a href="#l198">198</a><td>};<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> * Creates a function that returns true if each of its components evaluates<tr><td><a id="l203"></a><a href="#l203">203</a><td> * to true. The components are evaluated in order, and the evaluation will be<tr><td><a id="l204"></a><a href="#l204">204</a><td> * short-circuited as soon as a function returns false.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * For example, (goog.functions.and(f, g))(x) is equivalent to f(x) &amp;&amp; g(x).<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @param {...Function} var_args A list of functions.<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @return {function(...?):boolean} A function that ANDs its component<tr><td><a id="l208"></a><a href="#l208">208</a><td> *      functions.<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>goog.functions.and = function(var_args) {<tr><td><a id="l211"></a><a href="#l211">211</a><td>  var functions = arguments;<tr><td><a id="l212"></a><a href="#l212">212</a><td>  var length = functions.length;<tr><td><a id="l213"></a><a href="#l213">213</a><td>  return function() {<tr><td><a id="l214"></a><a href="#l214">214</a><td>    for (var i = 0; i &lt; length; i++) {<tr><td><a id="l215"></a><a href="#l215">215</a><td>      if (!functions[i].apply(this, arguments)) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>        return false;<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>    return true;<tr><td><a id="l220"></a><a href="#l220">220</a><td>  };<tr><td><a id="l221"></a><a href="#l221">221</a><td>};<tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td>/**<tr><td><a id="l225"></a><a href="#l225">225</a><td> * Creates a function that returns true if any of its components evaluates<tr><td><a id="l226"></a><a href="#l226">226</a><td> * to true. The components are evaluated in order, and the evaluation will be<tr><td><a id="l227"></a><a href="#l227">227</a><td> * short-circuited as soon as a function returns true.<tr><td><a id="l228"></a><a href="#l228">228</a><td> * For example, (goog.functions.or(f, g))(x) is equivalent to f(x) || g(x).<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @param {...Function} var_args A list of functions.<tr><td><a id="l230"></a><a href="#l230">230</a><td> * @return {function(...?):boolean} A function that ORs its component<tr><td><a id="l231"></a><a href="#l231">231</a><td> *    functions.<tr><td><a id="l232"></a><a href="#l232">232</a><td> */<tr><td><a id="l233"></a><a href="#l233">233</a><td>goog.functions.or = function(var_args) {<tr><td><a id="l234"></a><a href="#l234">234</a><td>  var functions = arguments;<tr><td><a id="l235"></a><a href="#l235">235</a><td>  var length = functions.length;<tr><td><a id="l236"></a><a href="#l236">236</a><td>  return function() {<tr><td><a id="l237"></a><a href="#l237">237</a><td>    for (var i = 0; i &lt; length; i++) {<tr><td><a id="l238"></a><a href="#l238">238</a><td>      if (functions[i].apply(this, arguments)) {<tr><td><a id="l239"></a><a href="#l239">239</a><td>        return true;<tr><td><a id="l240"></a><a href="#l240">240</a><td>      }<tr><td><a id="l241"></a><a href="#l241">241</a><td>    }<tr><td><a id="l242"></a><a href="#l242">242</a><td>    return false;<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><tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>/**<tr><td><a id="l248"></a><a href="#l248">248</a><td> * Creates a function that returns the Boolean opposite of a provided function.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * For example, (goog.functions.not(f))(x) is equivalent to !f(x).<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @param {!Function} f The original function.<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @return {function(...?):boolean} A function that delegates to f and returns<tr><td><a id="l252"></a><a href="#l252">252</a><td> * opposite.<tr><td><a id="l253"></a><a href="#l253">253</a><td> */<tr><td><a id="l254"></a><a href="#l254">254</a><td>goog.functions.not = function(f) {<tr><td><a id="l255"></a><a href="#l255">255</a><td>  return function() {<tr><td><a id="l256"></a><a href="#l256">256</a><td>    return !f.apply(this, arguments);<tr><td><a id="l257"></a><a href="#l257">257</a><td>  };<tr><td><a id="l258"></a><a href="#l258">258</a><td>};<tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td>/**<tr><td><a id="l262"></a><a href="#l262">262</a><td> * Generic factory function to construct an object given the constructor<tr><td><a id="l263"></a><a href="#l263">263</a><td> * and the arguments. Intended to be bound to create object factories.<tr><td><a id="l264"></a><a href="#l264">264</a><td> *<tr><td><a id="l265"></a><a href="#l265">265</a><td> * Example:<tr><td><a id="l266"></a><a href="#l266">266</a><td> *<tr><td><a id="l267"></a><a href="#l267">267</a><td> * var factory = goog.partial(goog.functions.create, Class);<tr><td><a id="l268"></a><a href="#l268">268</a><td> *<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @param {function(new:T, ...)} constructor The constructor for the Object.<tr><td><a id="l270"></a><a href="#l270">270</a><td> * @param {...*} var_args The arguments to be passed to the constructor.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @return {T} A new instance of the class given in {@code constructor}.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @template T<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td>goog.functions.create = function(constructor, var_args) {<tr><td><a id="l275"></a><a href="#l275">275</a><td>  /**<tr><td><a id="l276"></a><a href="#l276">276</a><td>   * @constructor<tr><td><a id="l277"></a><a href="#l277">277</a><td>   * @final<tr><td><a id="l278"></a><a href="#l278">278</a><td>   */<tr><td><a id="l279"></a><a href="#l279">279</a><td>  var temp = function() {};<tr><td><a id="l280"></a><a href="#l280">280</a><td>  temp.prototype = constructor.prototype;<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td>  // obj will have constructor&#39;s prototype in its chain and<tr><td><a id="l283"></a><a href="#l283">283</a><td>  // &#39;obj instanceof constructor&#39; will be true.<tr><td><a id="l284"></a><a href="#l284">284</a><td>  var obj = new temp();<tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td>  // obj is initialized by constructor.<tr><td><a id="l287"></a><a href="#l287">287</a><td>  // arguments is only array-like so lacks shift(), but can be used with<tr><td><a id="l288"></a><a href="#l288">288</a><td>  // the Array prototype function.<tr><td><a id="l289"></a><a href="#l289">289</a><td>  constructor.apply(obj, Array.prototype.slice.call(arguments, 1));<tr><td><a id="l290"></a><a href="#l290">290</a><td>  return obj;<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>/**<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @define {boolean} Whether the return value cache should be used.<tr><td><a id="l296"></a><a href="#l296">296</a><td> *    This should only be used to disable caches when testing.<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>goog.define(&#39;goog.functions.CACHE_RETURN_VALUE&#39;, true);<tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td>/**<tr><td><a id="l302"></a><a href="#l302">302</a><td> * Gives a wrapper function that caches the return value of a parameterless<tr><td><a id="l303"></a><a href="#l303">303</a><td> * function when first called.<tr><td><a id="l304"></a><a href="#l304">304</a><td> *<tr><td><a id="l305"></a><a href="#l305">305</a><td> * When called for the first time, the given function is called and its<tr><td><a id="l306"></a><a href="#l306">306</a><td> * return value is cached (thus this is only appropriate for idempotent<tr><td><a id="l307"></a><a href="#l307">307</a><td> * functions).  Subsequent calls will return the cached return value. This<tr><td><a id="l308"></a><a href="#l308">308</a><td> * allows the evaluation of expensive functions to be delayed until first used.<tr><td><a id="l309"></a><a href="#l309">309</a><td> *<tr><td><a id="l310"></a><a href="#l310">310</a><td> * To cache the return values of functions with parameters, see goog.memoize.<tr><td><a id="l311"></a><a href="#l311">311</a><td> *<tr><td><a id="l312"></a><a href="#l312">312</a><td> * @param {!function():T} fn A function to lazily evaluate.<tr><td><a id="l313"></a><a href="#l313">313</a><td> * @return {!function():T} A wrapped version the function.<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @template T<tr><td><a id="l315"></a><a href="#l315">315</a><td> */<tr><td><a id="l316"></a><a href="#l316">316</a><td>goog.functions.cacheReturnValue = function(fn) {<tr><td><a id="l317"></a><a href="#l317">317</a><td>  var called = false;<tr><td><a id="l318"></a><a href="#l318">318</a><td>  var value;<tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>  return function() {<tr><td><a id="l321"></a><a href="#l321">321</a><td>    if (!goog.functions.CACHE_RETURN_VALUE) {<tr><td><a id="l322"></a><a href="#l322">322</a><td>      return fn();<tr><td><a id="l323"></a><a href="#l323">323</a><td>    }<tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td>    if (!called) {<tr><td><a id="l326"></a><a href="#l326">326</a><td>      value = fn();<tr><td><a id="l327"></a><a href="#l327">327</a><td>      called = true;<tr><td><a id="l328"></a><a href="#l328">328</a><td>    }<tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>    return value;<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><tr><td><a id="l335"></a><a href="#l335">335</a><td>/**<tr><td><a id="l336"></a><a href="#l336">336</a><td> * Wraps a function to allow it to be called, at most, once. All<tr><td><a id="l337"></a><a href="#l337">337</a><td> * additional calls are no-ops.<tr><td><a id="l338"></a><a href="#l338">338</a><td> *<tr><td><a id="l339"></a><a href="#l339">339</a><td> * This is particularly useful for initialization functions<tr><td><a id="l340"></a><a href="#l340">340</a><td> * that should be called, at most, once.<tr><td><a id="l341"></a><a href="#l341">341</a><td> *<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {function():*} f Function to call.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @return {function():undefined} Wrapped function.<tr><td><a id="l344"></a><a href="#l344">344</a><td> */<tr><td><a id="l345"></a><a href="#l345">345</a><td>goog.functions.once = function(f) {<tr><td><a id="l346"></a><a href="#l346">346</a><td>  // Keep a reference to the function that we null out when we&#39;re done with<tr><td><a id="l347"></a><a href="#l347">347</a><td>  // it -- that way, the function can be GC&#39;d when we&#39;re done with it.<tr><td><a id="l348"></a><a href="#l348">348</a><td>  var inner = f;<tr><td><a id="l349"></a><a href="#l349">349</a><td>  return function() {<tr><td><a id="l350"></a><a href="#l350">350</a><td>    if (inner) {<tr><td><a id="l351"></a><a href="#l351">351</a><td>      var tmp = inner;<tr><td><a id="l352"></a><a href="#l352">352</a><td>      inner = null;<tr><td><a id="l353"></a><a href="#l353">353</a><td>      tmp();<tr><td><a id="l354"></a><a href="#l354">354</a><td>    }<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> * Wraps a function to allow it to be called, at most, once for each sequence of<tr><td><a id="l361"></a><a href="#l361">361</a><td> * calls fired repeatedly so long as they are fired less than a specified<tr><td><a id="l362"></a><a href="#l362">362</a><td> * interval apart (in milliseconds). Whether it receives one signal or multiple,<tr><td><a id="l363"></a><a href="#l363">363</a><td> * it will always wait until a full interval has elapsed since the last signal<tr><td><a id="l364"></a><a href="#l364">364</a><td> * before performing the action, passing the arguments from the last call of the<tr><td><a id="l365"></a><a href="#l365">365</a><td> * debouncing decorator into the decorated function.<tr><td><a id="l366"></a><a href="#l366">366</a><td> *<tr><td><a id="l367"></a><a href="#l367">367</a><td> * This is particularly useful for bulking up repeated user actions (e.g. only<tr><td><a id="l368"></a><a href="#l368">368</a><td> * refreshing a view once a user finishes typing rather than updating with every<tr><td><a id="l369"></a><a href="#l369">369</a><td> * keystroke). For more stateful debouncing with support for pausing, resuming,<tr><td><a id="l370"></a><a href="#l370">370</a><td> * and canceling debounced actions, use {@code goog.async.Debouncer}.<tr><td><a id="l371"></a><a href="#l371">371</a><td> *<tr><td><a id="l372"></a><a href="#l372">372</a><td> * @param {function(this:SCOPE, ...?)} f Function to call.<tr><td><a id="l373"></a><a href="#l373">373</a><td> * @param {number} interval Interval over which to debounce. The function will<tr><td><a id="l374"></a><a href="#l374">374</a><td> *     only be called after the full interval has elapsed since the last call.<tr><td><a id="l375"></a><a href="#l375">375</a><td> * @param {SCOPE=} opt_scope Object in whose scope to call the function.<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @return {function(...?): undefined} Wrapped function.<tr><td><a id="l377"></a><a href="#l377">377</a><td> * @template SCOPE<tr><td><a id="l378"></a><a href="#l378">378</a><td> */<tr><td><a id="l379"></a><a href="#l379">379</a><td>goog.functions.debounce = function(f, interval, opt_scope) {<tr><td><a id="l380"></a><a href="#l380">380</a><td>  if (opt_scope) {<tr><td><a id="l381"></a><a href="#l381">381</a><td>    f = goog.bind(f, opt_scope);<tr><td><a id="l382"></a><a href="#l382">382</a><td>  }<tr><td><a id="l383"></a><a href="#l383">383</a><td>  var timeout = null;<tr><td><a id="l384"></a><a href="#l384">384</a><td>  return /** @type {function(...?)} */ (function(var_args) {<tr><td><a id="l385"></a><a href="#l385">385</a><td>    goog.global.clearTimeout(timeout);<tr><td><a id="l386"></a><a href="#l386">386</a><td>    var args = arguments;<tr><td><a id="l387"></a><a href="#l387">387</a><td>    timeout = goog.global.setTimeout(function() {<tr><td><a id="l388"></a><a href="#l388">388</a><td>      f.apply(null, args);<tr><td><a id="l389"></a><a href="#l389">389</a><td>    }, interval);<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><tr><td><a id="l394"></a><a href="#l394">394</a><td>/**<tr><td><a id="l395"></a><a href="#l395">395</a><td> * Wraps a function to allow it to be called, at most, once per interval<tr><td><a id="l396"></a><a href="#l396">396</a><td> * (specified in milliseconds). If it is called multiple times while it is<tr><td><a id="l397"></a><a href="#l397">397</a><td> * waiting, it will only perform the action once at the end of the interval,<tr><td><a id="l398"></a><a href="#l398">398</a><td> * passing the arguments from the last call of the throttling decorator into the<tr><td><a id="l399"></a><a href="#l399">399</a><td> * decorated function.<tr><td><a id="l400"></a><a href="#l400">400</a><td> *<tr><td><a id="l401"></a><a href="#l401">401</a><td> * This is particularly useful for limiting repeated user requests (e.g.<tr><td><a id="l402"></a><a href="#l402">402</a><td> * preventing a user from spamming a server with frequent view refreshes). For<tr><td><a id="l403"></a><a href="#l403">403</a><td> * more stateful throttling with support for pausing, resuming, and canceling<tr><td><a id="l404"></a><a href="#l404">404</a><td> * throttled actions, use {@code goog.async.Throttle}.<tr><td><a id="l405"></a><a href="#l405">405</a><td> *<tr><td><a id="l406"></a><a href="#l406">406</a><td> * @param {function(this:SCOPE, ...?)} f Function to call.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @param {number} interval Interval over which to throttle. The function can<tr><td><a id="l408"></a><a href="#l408">408</a><td> *     only be called once per interval.<tr><td><a id="l409"></a><a href="#l409">409</a><td> * @param {SCOPE=} opt_scope Object in whose scope to call the function.<tr><td><a id="l410"></a><a href="#l410">410</a><td> * @return {function(...?): undefined} Wrapped function.<tr><td><a id="l411"></a><a href="#l411">411</a><td> * @template SCOPE<tr><td><a id="l412"></a><a href="#l412">412</a><td> */<tr><td><a id="l413"></a><a href="#l413">413</a><td>goog.functions.throttle = function(f, interval, opt_scope) {<tr><td><a id="l414"></a><a href="#l414">414</a><td>  if (opt_scope) {<tr><td><a id="l415"></a><a href="#l415">415</a><td>    f = goog.bind(f, opt_scope);<tr><td><a id="l416"></a><a href="#l416">416</a><td>  }<tr><td><a id="l417"></a><a href="#l417">417</a><td>  var timeout = null;<tr><td><a id="l418"></a><a href="#l418">418</a><td>  var shouldFire = false;<tr><td><a id="l419"></a><a href="#l419">419</a><td>  var args = [];<tr><td><a id="l420"></a><a href="#l420">420</a><td><tr><td><a id="l421"></a><a href="#l421">421</a><td>  var handleTimeout = function() {<tr><td><a id="l422"></a><a href="#l422">422</a><td>    timeout = null;<tr><td><a id="l423"></a><a href="#l423">423</a><td>    if (shouldFire) {<tr><td><a id="l424"></a><a href="#l424">424</a><td>      shouldFire = false;<tr><td><a id="l425"></a><a href="#l425">425</a><td>      fire();<tr><td><a id="l426"></a><a href="#l426">426</a><td>    }<tr><td><a id="l427"></a><a href="#l427">427</a><td>  };<tr><td><a id="l428"></a><a href="#l428">428</a><td><tr><td><a id="l429"></a><a href="#l429">429</a><td>  var fire = function() {<tr><td><a id="l430"></a><a href="#l430">430</a><td>    timeout = goog.global.setTimeout(handleTimeout, interval);<tr><td><a id="l431"></a><a href="#l431">431</a><td>    f.apply(null, args);<tr><td><a id="l432"></a><a href="#l432">432</a><td>  };<tr><td><a id="l433"></a><a href="#l433">433</a><td><tr><td><a id="l434"></a><a href="#l434">434</a><td>  return /** @type {function(...?)} */ (function(var_args) {<tr><td><a id="l435"></a><a href="#l435">435</a><td>    args = arguments;<tr><td><a id="l436"></a><a href="#l436">436</a><td>    if (!timeout) {<tr><td><a id="l437"></a><a href="#l437">437</a><td>      fire();<tr><td><a id="l438"></a><a href="#l438">438</a><td>    } else {<tr><td><a id="l439"></a><a href="#l439">439</a><td>      shouldFire = true;<tr><td><a id="l440"></a><a href="#l440">440</a><td>    }<tr><td><a id="l441"></a><a href="#l441">441</a><td>  });<tr><td><a id="l442"></a><a href="#l442">442</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/html/safehtml.js.src.html b/docs/source/lib/goog/html/safehtml.js.src.html
new file mode 100644
index 0000000..a7da629
--- /dev/null
+++ b/docs/source/lib/goog/html/safehtml.js.src.html
@@ -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>safehtml.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/html/safehtml.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td><tr><td><a id="l16"></a><a href="#l16">16</a><td>/**<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @fileoverview The SafeHtml type and its builders.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * TODO(xtof): Link to document stating type contract.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.html.SafeHtml&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.dom.TagName&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.dom.tags&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.html.SafeStyle&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.html.SafeStyleSheet&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.html.SafeUrl&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.html.TrustedResourceUrl&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.i18n.bidi.Dir&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;goog.i18n.bidi.DirectionalString&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.string.TypedString&#39;);<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> * A string that is safe to use in HTML context in DOM APIs and HTML documents.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * A SafeHtml is a string-like object that carries the security type contract<tr><td><a id="l45"></a><a href="#l45">45</a><td> * that its value as a string will not cause untrusted script execution when<tr><td><a id="l46"></a><a href="#l46">46</a><td> * evaluated as HTML in a browser.<tr><td><a id="l47"></a><a href="#l47">47</a><td> *<tr><td><a id="l48"></a><a href="#l48">48</a><td> * Values of this type are guaranteed to be safe to use in HTML contexts,<tr><td><a id="l49"></a><a href="#l49">49</a><td> * such as, assignment to the innerHTML DOM property, or interpolation into<tr><td><a id="l50"></a><a href="#l50">50</a><td> * a HTML template in HTML PC_DATA context, in the sense that the use will not<tr><td><a id="l51"></a><a href="#l51">51</a><td> * result in a Cross-Site-Scripting vulnerability.<tr><td><a id="l52"></a><a href="#l52">52</a><td> *<tr><td><a id="l53"></a><a href="#l53">53</a><td> * Instances of this type must be created via the factory methods<tr><td><a id="l54"></a><a href="#l54">54</a><td> * ({@code goog.html.SafeHtml.create}, {@code goog.html.SafeHtml.htmlEscape}),<tr><td><a id="l55"></a><a href="#l55">55</a><td> * etc and not by invoking its constructor.  The constructor intentionally<tr><td><a id="l56"></a><a href="#l56">56</a><td> * takes no parameters and the type is immutable; hence only a default instance<tr><td><a id="l57"></a><a href="#l57">57</a><td> * corresponding to the empty string can be obtained via constructor invocation.<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @see goog.html.SafeHtml#create<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @see goog.html.SafeHtml#htmlEscape<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @constructor<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @final<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @struct<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @implements {goog.i18n.bidi.DirectionalString}<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @implements {goog.string.TypedString}<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.html.SafeHtml = function() {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  /**<tr><td><a id="l69"></a><a href="#l69">69</a><td>   * The contained value of this SafeHtml.  The field has a purposely ugly<tr><td><a id="l70"></a><a href="#l70">70</a><td>   * name to make (non-compiled) code that attempts to directly access this<tr><td><a id="l71"></a><a href="#l71">71</a><td>   * field stand out.<tr><td><a id="l72"></a><a href="#l72">72</a><td>   * @private {string}<tr><td><a id="l73"></a><a href="#l73">73</a><td>   */<tr><td><a id="l74"></a><a href="#l74">74</a><td>  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = &#39;&#39;;<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>  /**<tr><td><a id="l77"></a><a href="#l77">77</a><td>   * A type marker used to implement additional run-time type checking.<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * @see goog.html.SafeHtml#unwrap<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * @const<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * @private<tr><td><a id="l81"></a><a href="#l81">81</a><td>   */<tr><td><a id="l82"></a><a href="#l82">82</a><td>  this.SAFE_HTML_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =<tr><td><a id="l83"></a><a href="#l83">83</a><td>      goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;<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>   * This SafeHtml&#39;s directionality, or null if unknown.<tr><td><a id="l87"></a><a href="#l87">87</a><td>   * @private {?goog.i18n.bidi.Dir}<tr><td><a id="l88"></a><a href="#l88">88</a><td>   */<tr><td><a id="l89"></a><a href="#l89">89</a><td>  this.dir_ = null;<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> * @override<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @const<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.html.SafeHtml.prototype.implementsGoogI18nBidiDirectionalString = true;<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/** @override */<tr><td><a id="l101"></a><a href="#l101">101</a><td>goog.html.SafeHtml.prototype.getDirection = function() {<tr><td><a id="l102"></a><a href="#l102">102</a><td>  return this.dir_;<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><tr><td><a id="l106"></a><a href="#l106">106</a><td>/**<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @override<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @const<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.html.SafeHtml.prototype.implementsGoogStringTypedString = true;<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> * Returns this SafeHtml&#39;s value a string.<tr><td><a id="l115"></a><a href="#l115">115</a><td> *<tr><td><a id="l116"></a><a href="#l116">116</a><td> * IMPORTANT: In code where it is security relevant that an object&#39;s type is<tr><td><a id="l117"></a><a href="#l117">117</a><td> * indeed {@code SafeHtml}, use {@code goog.html.SafeHtml.unwrap} instead of<tr><td><a id="l118"></a><a href="#l118">118</a><td> * this method. If in doubt, assume that it&#39;s security relevant. In particular,<tr><td><a id="l119"></a><a href="#l119">119</a><td> * note that goog.html functions which return a goog.html type do not guarantee<tr><td><a id="l120"></a><a href="#l120">120</a><td> * that the returned instance is of the right type. For example:<tr><td><a id="l121"></a><a href="#l121">121</a><td> *<tr><td><a id="l122"></a><a href="#l122">122</a><td> * &lt;pre&gt;<tr><td><a id="l123"></a><a href="#l123">123</a><td> * var fakeSafeHtml = new String(&#39;fake&#39;);<tr><td><a id="l124"></a><a href="#l124">124</a><td> * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;<tr><td><a id="l125"></a><a href="#l125">125</a><td> * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);<tr><td><a id="l126"></a><a href="#l126">126</a><td> * // newSafeHtml is just an alias for fakeSafeHtml, it&#39;s passed through by<tr><td><a id="l127"></a><a href="#l127">127</a><td> * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml<tr><td><a id="l128"></a><a href="#l128">128</a><td> * // instanceof goog.html.SafeHtml.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * &lt;/pre&gt;<tr><td><a id="l130"></a><a href="#l130">130</a><td> *<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @see goog.html.SafeHtml#unwrap<tr><td><a id="l132"></a><a href="#l132">132</a><td> * @override<tr><td><a id="l133"></a><a href="#l133">133</a><td> */<tr><td><a id="l134"></a><a href="#l134">134</a><td>goog.html.SafeHtml.prototype.getTypedStringValue = function() {<tr><td><a id="l135"></a><a href="#l135">135</a><td>  return this.privateDoNotAccessOrElseSafeHtmlWrappedValue_;<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>if (goog.DEBUG) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>  /**<tr><td><a id="l141"></a><a href="#l141">141</a><td>   * Returns a debug string-representation of this value.<tr><td><a id="l142"></a><a href="#l142">142</a><td>   *<tr><td><a id="l143"></a><a href="#l143">143</a><td>   * To obtain the actual string value wrapped in a SafeHtml, use<tr><td><a id="l144"></a><a href="#l144">144</a><td>   * {@code goog.html.SafeHtml.unwrap}.<tr><td><a id="l145"></a><a href="#l145">145</a><td>   *<tr><td><a id="l146"></a><a href="#l146">146</a><td>   * @see goog.html.SafeHtml#unwrap<tr><td><a id="l147"></a><a href="#l147">147</a><td>   * @override<tr><td><a id="l148"></a><a href="#l148">148</a><td>   */<tr><td><a id="l149"></a><a href="#l149">149</a><td>  goog.html.SafeHtml.prototype.toString = function() {<tr><td><a id="l150"></a><a href="#l150">150</a><td>    return &#39;SafeHtml{&#39; + this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ +<tr><td><a id="l151"></a><a href="#l151">151</a><td>        &#39;}&#39;;<tr><td><a id="l152"></a><a href="#l152">152</a><td>  };<tr><td><a id="l153"></a><a href="#l153">153</a><td>}<tr><td><a id="l154"></a><a href="#l154">154</a><td><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> * Performs a runtime check that the provided object is indeed a SafeHtml<tr><td><a id="l158"></a><a href="#l158">158</a><td> * object, and returns its value.<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @param {!goog.html.SafeHtml} safeHtml The object to extract from.<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @return {string} The SafeHtml object&#39;s contained string, unless the run-time<tr><td><a id="l161"></a><a href="#l161">161</a><td> *     type check fails. In that case, {@code unwrap} returns an innocuous<tr><td><a id="l162"></a><a href="#l162">162</a><td> *     string, or, if assertions are enabled, throws<tr><td><a id="l163"></a><a href="#l163">163</a><td> *     {@code goog.asserts.AssertionError}.<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.html.SafeHtml.unwrap = function(safeHtml) {<tr><td><a id="l166"></a><a href="#l166">166</a><td>  // Perform additional run-time type-checking to ensure that safeHtml is indeed<tr><td><a id="l167"></a><a href="#l167">167</a><td>  // an instance of the expected type.  This provides some additional protection<tr><td><a id="l168"></a><a href="#l168">168</a><td>  // against security bugs due to application code that disables type checks.<tr><td><a id="l169"></a><a href="#l169">169</a><td>  // Specifically, the following checks are performed:<tr><td><a id="l170"></a><a href="#l170">170</a><td>  // 1. The object is an instance of the expected type.<tr><td><a id="l171"></a><a href="#l171">171</a><td>  // 2. The object is not an instance of a subclass.<tr><td><a id="l172"></a><a href="#l172">172</a><td>  // 3. The object carries a type marker for the expected type. &quot;Faking&quot; an<tr><td><a id="l173"></a><a href="#l173">173</a><td>  // object requires a reference to the type marker, which has names intended<tr><td><a id="l174"></a><a href="#l174">174</a><td>  // to stand out in code reviews.<tr><td><a id="l175"></a><a href="#l175">175</a><td>  if (safeHtml instanceof goog.html.SafeHtml &amp;&amp;<tr><td><a id="l176"></a><a href="#l176">176</a><td>      safeHtml.constructor === goog.html.SafeHtml &amp;&amp;<tr><td><a id="l177"></a><a href="#l177">177</a><td>      safeHtml.SAFE_HTML_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===<tr><td><a id="l178"></a><a href="#l178">178</a><td>          goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>    return safeHtml.privateDoNotAccessOrElseSafeHtmlWrappedValue_;<tr><td><a id="l180"></a><a href="#l180">180</a><td>  } else {<tr><td><a id="l181"></a><a href="#l181">181</a><td>    goog.asserts.fail(&#39;expected object of type SafeHtml, got \&#39;&#39; +<tr><td><a id="l182"></a><a href="#l182">182</a><td>                      safeHtml + &#39;\&#39;&#39;);<tr><td><a id="l183"></a><a href="#l183">183</a><td>    return &#39;type_error:SafeHtml&#39;;<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> * Shorthand for union of types that can sensibly be converted to strings<tr><td><a id="l190"></a><a href="#l190">190</a><td> * or might already be SafeHtml (as SafeHtml is a goog.string.TypedString).<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @private<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @typedef {string|number|boolean|!goog.string.TypedString|<tr><td><a id="l193"></a><a href="#l193">193</a><td> *           !goog.i18n.bidi.DirectionalString}<tr><td><a id="l194"></a><a href="#l194">194</a><td> */<tr><td><a id="l195"></a><a href="#l195">195</a><td>goog.html.SafeHtml.TextOrHtml_;<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>/**<tr><td><a id="l199"></a><a href="#l199">199</a><td> * Returns HTML-escaped text as a SafeHtml object.<tr><td><a id="l200"></a><a href="#l200">200</a><td> *<tr><td><a id="l201"></a><a href="#l201">201</a><td> * If text is of a type that implements<tr><td><a id="l202"></a><a href="#l202">202</a><td> * {@code goog.i18n.bidi.DirectionalString}, the directionality of the new<tr><td><a id="l203"></a><a href="#l203">203</a><td> * {@code SafeHtml} object is set to {@code text}&#39;s directionality, if known.<tr><td><a id="l204"></a><a href="#l204">204</a><td> * Otherwise, the directionality of the resulting SafeHtml is unknown (i.e.,<tr><td><a id="l205"></a><a href="#l205">205</a><td> * {@code null}).<tr><td><a id="l206"></a><a href="#l206">206</a><td> *<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @param {!goog.html.SafeHtml.TextOrHtml_} textOrHtml The text to escape. If<tr><td><a id="l208"></a><a href="#l208">208</a><td> *     the parameter is of type SafeHtml it is returned directly (no escaping<tr><td><a id="l209"></a><a href="#l209">209</a><td> *     is done).<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @return {!goog.html.SafeHtml} The escaped text, wrapped as a SafeHtml.<tr><td><a id="l211"></a><a href="#l211">211</a><td> */<tr><td><a id="l212"></a><a href="#l212">212</a><td>goog.html.SafeHtml.htmlEscape = function(textOrHtml) {<tr><td><a id="l213"></a><a href="#l213">213</a><td>  if (textOrHtml instanceof goog.html.SafeHtml) {<tr><td><a id="l214"></a><a href="#l214">214</a><td>    return textOrHtml;<tr><td><a id="l215"></a><a href="#l215">215</a><td>  }<tr><td><a id="l216"></a><a href="#l216">216</a><td>  var dir = null;<tr><td><a id="l217"></a><a href="#l217">217</a><td>  if (textOrHtml.implementsGoogI18nBidiDirectionalString) {<tr><td><a id="l218"></a><a href="#l218">218</a><td>    dir = textOrHtml.getDirection();<tr><td><a id="l219"></a><a href="#l219">219</a><td>  }<tr><td><a id="l220"></a><a href="#l220">220</a><td>  var textAsString;<tr><td><a id="l221"></a><a href="#l221">221</a><td>  if (textOrHtml.implementsGoogStringTypedString) {<tr><td><a id="l222"></a><a href="#l222">222</a><td>    textAsString = textOrHtml.getTypedStringValue();<tr><td><a id="l223"></a><a href="#l223">223</a><td>  } else {<tr><td><a id="l224"></a><a href="#l224">224</a><td>    textAsString = String(textOrHtml);<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 goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l227"></a><a href="#l227">227</a><td>      goog.string.htmlEscape(textAsString), dir);<tr><td><a id="l228"></a><a href="#l228">228</a><td>};<tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>/**<tr><td><a id="l232"></a><a href="#l232">232</a><td> * Returns HTML-escaped text as a SafeHtml object, with newlines changed to<tr><td><a id="l233"></a><a href="#l233">233</a><td> * &amp;lt;br&amp;gt;.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @param {!goog.html.SafeHtml.TextOrHtml_} textOrHtml The text to escape. If<tr><td><a id="l235"></a><a href="#l235">235</a><td> *     the parameter is of type SafeHtml it is returned directly (no escaping<tr><td><a id="l236"></a><a href="#l236">236</a><td> *     is done).<tr><td><a id="l237"></a><a href="#l237">237</a><td> * @return {!goog.html.SafeHtml} The escaped text, wrapped as a SafeHtml.<tr><td><a id="l238"></a><a href="#l238">238</a><td> */<tr><td><a id="l239"></a><a href="#l239">239</a><td>goog.html.SafeHtml.htmlEscapePreservingNewlines = function(textOrHtml) {<tr><td><a id="l240"></a><a href="#l240">240</a><td>  if (textOrHtml instanceof goog.html.SafeHtml) {<tr><td><a id="l241"></a><a href="#l241">241</a><td>    return textOrHtml;<tr><td><a id="l242"></a><a href="#l242">242</a><td>  }<tr><td><a id="l243"></a><a href="#l243">243</a><td>  var html = goog.html.SafeHtml.htmlEscape(textOrHtml);<tr><td><a id="l244"></a><a href="#l244">244</a><td>  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l245"></a><a href="#l245">245</a><td>      goog.string.newLineToBr(goog.html.SafeHtml.unwrap(html)),<tr><td><a id="l246"></a><a href="#l246">246</a><td>      html.getDirection());<tr><td><a id="l247"></a><a href="#l247">247</a><td>};<tr><td><a id="l248"></a><a href="#l248">248</a><td><tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td>/**<tr><td><a id="l251"></a><a href="#l251">251</a><td> * Returns HTML-escaped text as a SafeHtml object, with newlines changed to<tr><td><a id="l252"></a><a href="#l252">252</a><td> * &amp;lt;br&amp;gt; and escaping whitespace to preserve spatial formatting. Character<tr><td><a id="l253"></a><a href="#l253">253</a><td> * entity #160 is used to make it safer for XML.<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @param {!goog.html.SafeHtml.TextOrHtml_} textOrHtml The text to escape. If<tr><td><a id="l255"></a><a href="#l255">255</a><td> *     the parameter is of type SafeHtml it is returned directly (no escaping<tr><td><a id="l256"></a><a href="#l256">256</a><td> *     is done).<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @return {!goog.html.SafeHtml} The escaped text, wrapped as a SafeHtml.<tr><td><a id="l258"></a><a href="#l258">258</a><td> */<tr><td><a id="l259"></a><a href="#l259">259</a><td>goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces = function(<tr><td><a id="l260"></a><a href="#l260">260</a><td>    textOrHtml) {<tr><td><a id="l261"></a><a href="#l261">261</a><td>  if (textOrHtml instanceof goog.html.SafeHtml) {<tr><td><a id="l262"></a><a href="#l262">262</a><td>    return textOrHtml;<tr><td><a id="l263"></a><a href="#l263">263</a><td>  }<tr><td><a id="l264"></a><a href="#l264">264</a><td>  var html = goog.html.SafeHtml.htmlEscape(textOrHtml);<tr><td><a id="l265"></a><a href="#l265">265</a><td>  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l266"></a><a href="#l266">266</a><td>      goog.string.whitespaceEscape(goog.html.SafeHtml.unwrap(html)),<tr><td><a id="l267"></a><a href="#l267">267</a><td>      html.getDirection());<tr><td><a id="l268"></a><a href="#l268">268</a><td>};<tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>/**<tr><td><a id="l272"></a><a href="#l272">272</a><td> * Coerces an arbitrary object into a SafeHtml object.<tr><td><a id="l273"></a><a href="#l273">273</a><td> *<tr><td><a id="l274"></a><a href="#l274">274</a><td> * If {@code textOrHtml} is already of type {@code goog.html.SafeHtml}, the same<tr><td><a id="l275"></a><a href="#l275">275</a><td> * object is returned. Otherwise, {@code textOrHtml} is coerced to string, and<tr><td><a id="l276"></a><a href="#l276">276</a><td> * HTML-escaped. If {@code textOrHtml} is of a type that implements<tr><td><a id="l277"></a><a href="#l277">277</a><td> * {@code goog.i18n.bidi.DirectionalString}, its directionality, if known, is<tr><td><a id="l278"></a><a href="#l278">278</a><td> * preserved.<tr><td><a id="l279"></a><a href="#l279">279</a><td> *<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @param {!goog.html.SafeHtml.TextOrHtml_} textOrHtml The text or SafeHtml to<tr><td><a id="l281"></a><a href="#l281">281</a><td> *     coerce.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @return {!goog.html.SafeHtml} The resulting SafeHtml object.<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @deprecated Use goog.html.SafeHtml.htmlEscape.<tr><td><a id="l284"></a><a href="#l284">284</a><td> */<tr><td><a id="l285"></a><a href="#l285">285</a><td>goog.html.SafeHtml.from = goog.html.SafeHtml.htmlEscape;<tr><td><a id="l286"></a><a href="#l286">286</a><td><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> * @const<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @private<tr><td><a id="l291"></a><a href="#l291">291</a><td> */<tr><td><a id="l292"></a><a href="#l292">292</a><td>goog.html.SafeHtml.VALID_NAMES_IN_TAG_ = /^[a-zA-Z0-9-]+$/;<tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>/**<tr><td><a id="l296"></a><a href="#l296">296</a><td> * Set of attributes containing URL as defined at<tr><td><a id="l297"></a><a href="#l297">297</a><td> * http://www.w3.org/TR/html5/index.html#attributes-1.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @private @const {!Object&lt;string,boolean&gt;}<tr><td><a id="l299"></a><a href="#l299">299</a><td> */<tr><td><a id="l300"></a><a href="#l300">300</a><td>goog.html.SafeHtml.URL_ATTRIBUTES_ = goog.object.createSet(&#39;action&#39;, &#39;cite&#39;,<tr><td><a id="l301"></a><a href="#l301">301</a><td>    &#39;data&#39;, &#39;formaction&#39;, &#39;href&#39;, &#39;manifest&#39;, &#39;poster&#39;, &#39;src&#39;);<tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td><tr><td><a id="l304"></a><a href="#l304">304</a><td>/**<tr><td><a id="l305"></a><a href="#l305">305</a><td> * Tags which are unsupported via create(). They might be supported via a<tr><td><a id="l306"></a><a href="#l306">306</a><td> * tag-specific create method. These are tags which might require a<tr><td><a id="l307"></a><a href="#l307">307</a><td> * TrustedResourceUrl in one of their attributes or a restricted type for<tr><td><a id="l308"></a><a href="#l308">308</a><td> * their content.<tr><td><a id="l309"></a><a href="#l309">309</a><td> * @private @const {!Object&lt;string,boolean&gt;}<tr><td><a id="l310"></a><a href="#l310">310</a><td> */<tr><td><a id="l311"></a><a href="#l311">311</a><td>goog.html.SafeHtml.NOT_ALLOWED_TAG_NAMES_ = goog.object.createSet(<tr><td><a id="l312"></a><a href="#l312">312</a><td>    goog.dom.TagName.EMBED, goog.dom.TagName.IFRAME, goog.dom.TagName.LINK,<tr><td><a id="l313"></a><a href="#l313">313</a><td>    goog.dom.TagName.OBJECT, goog.dom.TagName.SCRIPT, goog.dom.TagName.STYLE,<tr><td><a id="l314"></a><a href="#l314">314</a><td>    goog.dom.TagName.TEMPLATE);<tr><td><a id="l315"></a><a href="#l315">315</a><td><tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td>/**<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @typedef {string|number|goog.string.TypedString|<tr><td><a id="l319"></a><a href="#l319">319</a><td> *     goog.html.SafeStyle.PropertyMap}<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @private<tr><td><a id="l321"></a><a href="#l321">321</a><td> */<tr><td><a id="l322"></a><a href="#l322">322</a><td>goog.html.SafeHtml.AttributeValue_;<tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td>/**<tr><td><a id="l326"></a><a href="#l326">326</a><td> * Creates a SafeHtml content consisting of a tag with optional attributes and<tr><td><a id="l327"></a><a href="#l327">327</a><td> * optional content.<tr><td><a id="l328"></a><a href="#l328">328</a><td> *<tr><td><a id="l329"></a><a href="#l329">329</a><td> * For convenience tag names and attribute names are accepted as regular<tr><td><a id="l330"></a><a href="#l330">330</a><td> * strings, instead of goog.string.Const. Nevertheless, you should not pass<tr><td><a id="l331"></a><a href="#l331">331</a><td> * user-controlled values to these parameters. Note that these parameters are<tr><td><a id="l332"></a><a href="#l332">332</a><td> * syntactically validated at runtime, and invalid values will result in<tr><td><a id="l333"></a><a href="#l333">333</a><td> * an exception.<tr><td><a id="l334"></a><a href="#l334">334</a><td> *<tr><td><a id="l335"></a><a href="#l335">335</a><td> * Example usage:<tr><td><a id="l336"></a><a href="#l336">336</a><td> *<tr><td><a id="l337"></a><a href="#l337">337</a><td> * goog.html.SafeHtml.create(&#39;br&#39;);<tr><td><a id="l338"></a><a href="#l338">338</a><td> * goog.html.SafeHtml.create(&#39;div&#39;, {&#39;class&#39;: &#39;a&#39;});<tr><td><a id="l339"></a><a href="#l339">339</a><td> * goog.html.SafeHtml.create(&#39;p&#39;, {}, &#39;a&#39;);<tr><td><a id="l340"></a><a href="#l340">340</a><td> * goog.html.SafeHtml.create(&#39;p&#39;, {}, goog.html.SafeHtml.create(&#39;br&#39;));<tr><td><a id="l341"></a><a href="#l341">341</a><td> *<tr><td><a id="l342"></a><a href="#l342">342</a><td> * goog.html.SafeHtml.create(&#39;span&#39;, {<tr><td><a id="l343"></a><a href="#l343">343</a><td> *   &#39;style&#39;: {&#39;margin&#39;: &#39;0&#39;}<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> * To guarantee SafeHtml&#39;s type contract is upheld there are restrictions on<tr><td><a id="l347"></a><a href="#l347">347</a><td> * attribute values and tag names.<tr><td><a id="l348"></a><a href="#l348">348</a><td> *<tr><td><a id="l349"></a><a href="#l349">349</a><td> * - For attributes which contain script code (on*), a goog.string.Const is<tr><td><a id="l350"></a><a href="#l350">350</a><td> *   required.<tr><td><a id="l351"></a><a href="#l351">351</a><td> * - For attributes which contain style (style), a goog.html.SafeStyle or a<tr><td><a id="l352"></a><a href="#l352">352</a><td> *   goog.html.SafeStyle.PropertyMap is required.<tr><td><a id="l353"></a><a href="#l353">353</a><td> * - For attributes which are interpreted as URLs (e.g. src, href) a<tr><td><a id="l354"></a><a href="#l354">354</a><td> *   goog.html.SafeUrl, goog.string.Const or string is required. If a string<tr><td><a id="l355"></a><a href="#l355">355</a><td> *   is passed, it will be sanitized with SafeUrl.sanitize().<tr><td><a id="l356"></a><a href="#l356">356</a><td> * - For tags which can load code, more specific goog.html.SafeHtml.create*()<tr><td><a id="l357"></a><a href="#l357">357</a><td> *   functions must be used. Tags which can load code and are not supported by<tr><td><a id="l358"></a><a href="#l358">358</a><td> *   this function are embed, iframe, link, object, script, style, and template.<tr><td><a id="l359"></a><a href="#l359">359</a><td> *<tr><td><a id="l360"></a><a href="#l360">360</a><td> * @param {string} tagName The name of the tag. Only tag names consisting of<tr><td><a id="l361"></a><a href="#l361">361</a><td> *     [a-zA-Z0-9-] are allowed. Tag names documented above are disallowed.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @param {!Object&lt;string, goog.html.SafeHtml.AttributeValue_&gt;=}<tr><td><a id="l363"></a><a href="#l363">363</a><td> *     opt_attributes Mapping from attribute names to their values. Only<tr><td><a id="l364"></a><a href="#l364">364</a><td> *     attribute names consisting of [a-zA-Z0-9-] are allowed. Value of null or<tr><td><a id="l365"></a><a href="#l365">365</a><td> *     undefined causes the attribute to be omitted.<tr><td><a id="l366"></a><a href="#l366">366</a><td> * @param {!goog.html.SafeHtml.TextOrHtml_|<tr><td><a id="l367"></a><a href="#l367">367</a><td> *     !Array&lt;!goog.html.SafeHtml.TextOrHtml_&gt;=} opt_content Content to<tr><td><a id="l368"></a><a href="#l368">368</a><td> *     HTML-escape and put inside the tag. This must be empty for void tags<tr><td><a id="l369"></a><a href="#l369">369</a><td> *     like &lt;br&gt;. Array elements are concatenated.<tr><td><a id="l370"></a><a href="#l370">370</a><td> * @return {!goog.html.SafeHtml} The SafeHtml content with the tag.<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @throws {Error} If invalid tag name, attribute name, or attribute value is<tr><td><a id="l372"></a><a href="#l372">372</a><td> *     provided.<tr><td><a id="l373"></a><a href="#l373">373</a><td> * @throws {goog.asserts.AssertionError} If content for void tag is provided.<tr><td><a id="l374"></a><a href="#l374">374</a><td> */<tr><td><a id="l375"></a><a href="#l375">375</a><td>goog.html.SafeHtml.create = function(tagName, opt_attributes, opt_content) {<tr><td><a id="l376"></a><a href="#l376">376</a><td>  if (!goog.html.SafeHtml.VALID_NAMES_IN_TAG_.test(tagName)) {<tr><td><a id="l377"></a><a href="#l377">377</a><td>    throw Error(&#39;Invalid tag name &lt;&#39; + tagName + &#39;&gt;.&#39;);<tr><td><a id="l378"></a><a href="#l378">378</a><td>  }<tr><td><a id="l379"></a><a href="#l379">379</a><td>  if (tagName.toUpperCase() in goog.html.SafeHtml.NOT_ALLOWED_TAG_NAMES_) {<tr><td><a id="l380"></a><a href="#l380">380</a><td>    throw Error(&#39;Tag name &lt;&#39; + tagName + &#39;&gt; is not allowed for SafeHtml.&#39;);<tr><td><a id="l381"></a><a href="#l381">381</a><td>  }<tr><td><a id="l382"></a><a href="#l382">382</a><td>  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l383"></a><a href="#l383">383</a><td>      tagName, opt_attributes, opt_content);<tr><td><a id="l384"></a><a href="#l384">384</a><td>};<tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td><tr><td><a id="l387"></a><a href="#l387">387</a><td>/**<tr><td><a id="l388"></a><a href="#l388">388</a><td> * Creates a SafeHtml representing an iframe tag.<tr><td><a id="l389"></a><a href="#l389">389</a><td> *<tr><td><a id="l390"></a><a href="#l390">390</a><td> * By default the sandbox attribute is set to an empty value, which is the most<tr><td><a id="l391"></a><a href="#l391">391</a><td> * secure option, as it confers the iframe the least privileges. If this<tr><td><a id="l392"></a><a href="#l392">392</a><td> * is too restrictive then granting individual privileges is the preferable<tr><td><a id="l393"></a><a href="#l393">393</a><td> * option. Unsetting the attribute entirely is the least secure option and<tr><td><a id="l394"></a><a href="#l394">394</a><td> * should never be done unless it&#39;s stricly necessary.<tr><td><a id="l395"></a><a href="#l395">395</a><td> *<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @param {goog.html.TrustedResourceUrl=} opt_src The value of the src<tr><td><a id="l397"></a><a href="#l397">397</a><td> *     attribute. If null or undefined src will not be set.<tr><td><a id="l398"></a><a href="#l398">398</a><td> * @param {goog.html.SafeHtml=} opt_srcdoc The value of the srcdoc attribute.<tr><td><a id="l399"></a><a href="#l399">399</a><td> *     If null or undefined srcdoc will not be set.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @param {!Object&lt;string, goog.html.SafeHtml.AttributeValue_&gt;=}<tr><td><a id="l401"></a><a href="#l401">401</a><td> *     opt_attributes Mapping from attribute names to their values. Only<tr><td><a id="l402"></a><a href="#l402">402</a><td> *     attribute names consisting of [a-zA-Z0-9-] are allowed. Value of null or<tr><td><a id="l403"></a><a href="#l403">403</a><td> *     undefined causes the attribute to be omitted.<tr><td><a id="l404"></a><a href="#l404">404</a><td> * @param {!goog.html.SafeHtml.TextOrHtml_|<tr><td><a id="l405"></a><a href="#l405">405</a><td> *     !Array&lt;!goog.html.SafeHtml.TextOrHtml_&gt;=} opt_content Content to<tr><td><a id="l406"></a><a href="#l406">406</a><td> *     HTML-escape and put inside the tag. Array elements are concatenated.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @return {!goog.html.SafeHtml} The SafeHtml content with the tag.<tr><td><a id="l408"></a><a href="#l408">408</a><td> * @throws {Error} If invalid tag name, attribute name, or attribute value is<tr><td><a id="l409"></a><a href="#l409">409</a><td> *     provided. If opt_attributes contains the src or srcdoc attributes.<tr><td><a id="l410"></a><a href="#l410">410</a><td> */<tr><td><a id="l411"></a><a href="#l411">411</a><td>goog.html.SafeHtml.createIframe = function(<tr><td><a id="l412"></a><a href="#l412">412</a><td>    opt_src, opt_srcdoc, opt_attributes, opt_content) {<tr><td><a id="l413"></a><a href="#l413">413</a><td>  var fixedAttributes = {};<tr><td><a id="l414"></a><a href="#l414">414</a><td>  fixedAttributes[&#39;src&#39;] = opt_src || null;<tr><td><a id="l415"></a><a href="#l415">415</a><td>  fixedAttributes[&#39;srcdoc&#39;] = opt_srcdoc || null;<tr><td><a id="l416"></a><a href="#l416">416</a><td>  var defaultAttributes = {&#39;sandbox&#39;: &#39;&#39;};<tr><td><a id="l417"></a><a href="#l417">417</a><td>  var attributes = goog.html.SafeHtml.combineAttributes(<tr><td><a id="l418"></a><a href="#l418">418</a><td>      fixedAttributes, defaultAttributes, opt_attributes);<tr><td><a id="l419"></a><a href="#l419">419</a><td>  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l420"></a><a href="#l420">420</a><td>      &#39;iframe&#39;, attributes, opt_content);<tr><td><a id="l421"></a><a href="#l421">421</a><td>};<tr><td><a id="l422"></a><a href="#l422">422</a><td><tr><td><a id="l423"></a><a href="#l423">423</a><td><tr><td><a id="l424"></a><a href="#l424">424</a><td>/**<tr><td><a id="l425"></a><a href="#l425">425</a><td> * Creates a SafeHtml representing a style tag. The type attribute is set<tr><td><a id="l426"></a><a href="#l426">426</a><td> * to &quot;text/css&quot;.<tr><td><a id="l427"></a><a href="#l427">427</a><td> * @param {!goog.html.SafeStyleSheet|!Array&lt;!goog.html.SafeStyleSheet&gt;}<tr><td><a id="l428"></a><a href="#l428">428</a><td> *     styleSheet Content to put inside the tag. Array elements are<tr><td><a id="l429"></a><a href="#l429">429</a><td> *     concatenated.<tr><td><a id="l430"></a><a href="#l430">430</a><td> * @param {!Object&lt;string, goog.html.SafeHtml.AttributeValue_&gt;=}<tr><td><a id="l431"></a><a href="#l431">431</a><td> *     opt_attributes Mapping from attribute names to their values. Only<tr><td><a id="l432"></a><a href="#l432">432</a><td> *     attribute names consisting of [a-zA-Z0-9-] are allowed. Value of null or<tr><td><a id="l433"></a><a href="#l433">433</a><td> *     undefined causes the attribute to be omitted.<tr><td><a id="l434"></a><a href="#l434">434</a><td> * @return {!goog.html.SafeHtml} The SafeHtml content with the tag.<tr><td><a id="l435"></a><a href="#l435">435</a><td> * @throws {Error} If invalid attribute name or attribute value is provided. If<tr><td><a id="l436"></a><a href="#l436">436</a><td> *     opt_attributes contains the type attribute.<tr><td><a id="l437"></a><a href="#l437">437</a><td> */<tr><td><a id="l438"></a><a href="#l438">438</a><td>goog.html.SafeHtml.createStyle = function(styleSheet, opt_attributes) {<tr><td><a id="l439"></a><a href="#l439">439</a><td>  var fixedAttributes = {&#39;type&#39;: &#39;text/css&#39;};<tr><td><a id="l440"></a><a href="#l440">440</a><td>  var defaultAttributes = {};<tr><td><a id="l441"></a><a href="#l441">441</a><td>  var attributes = goog.html.SafeHtml.combineAttributes(<tr><td><a id="l442"></a><a href="#l442">442</a><td>      fixedAttributes, defaultAttributes, opt_attributes);<tr><td><a id="l443"></a><a href="#l443">443</a><td><tr><td><a id="l444"></a><a href="#l444">444</a><td>  var content = &#39;&#39;;<tr><td><a id="l445"></a><a href="#l445">445</a><td>  styleSheet = goog.array.concat(styleSheet);<tr><td><a id="l446"></a><a href="#l446">446</a><td>  for (var i = 0; i &lt; styleSheet.length; i++) {<tr><td><a id="l447"></a><a href="#l447">447</a><td>    content += goog.html.SafeStyleSheet.unwrap(styleSheet[i]);<tr><td><a id="l448"></a><a href="#l448">448</a><td>  }<tr><td><a id="l449"></a><a href="#l449">449</a><td>  // Convert to SafeHtml so that it&#39;s not HTML-escaped.<tr><td><a id="l450"></a><a href="#l450">450</a><td>  var htmlContent = goog.html.SafeHtml<tr><td><a id="l451"></a><a href="#l451">451</a><td>      .createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l452"></a><a href="#l452">452</a><td>          content, goog.i18n.bidi.Dir.NEUTRAL);<tr><td><a id="l453"></a><a href="#l453">453</a><td>  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l454"></a><a href="#l454">454</a><td>      &#39;style&#39;, attributes, htmlContent);<tr><td><a id="l455"></a><a href="#l455">455</a><td>};<tr><td><a id="l456"></a><a href="#l456">456</a><td><tr><td><a id="l457"></a><a href="#l457">457</a><td><tr><td><a id="l458"></a><a href="#l458">458</a><td>/**<tr><td><a id="l459"></a><a href="#l459">459</a><td> * @param {string} tagName The tag name.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * @param {string} name The attribute name.<tr><td><a id="l461"></a><a href="#l461">461</a><td> * @param {!goog.html.SafeHtml.AttributeValue_} value The attribute value.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @return {string} A &quot;name=value&quot; string.<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @throws {Error} If attribute value is unsafe for the given tag and attribute.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @private<tr><td><a id="l465"></a><a href="#l465">465</a><td> */<tr><td><a id="l466"></a><a href="#l466">466</a><td>goog.html.SafeHtml.getAttrNameAndValue_ = function(tagName, name, value) {<tr><td><a id="l467"></a><a href="#l467">467</a><td>  // If it&#39;s goog.string.Const, allow any valid attribute name.<tr><td><a id="l468"></a><a href="#l468">468</a><td>  if (value instanceof goog.string.Const) {<tr><td><a id="l469"></a><a href="#l469">469</a><td>    value = goog.string.Const.unwrap(value);<tr><td><a id="l470"></a><a href="#l470">470</a><td>  } else if (name.toLowerCase() == &#39;style&#39;) {<tr><td><a id="l471"></a><a href="#l471">471</a><td>    value = goog.html.SafeHtml.getStyleValue_(value);<tr><td><a id="l472"></a><a href="#l472">472</a><td>  } else if (/^on/i.test(name)) {<tr><td><a id="l473"></a><a href="#l473">473</a><td>    // TODO(jakubvrana): Disallow more attributes with a special meaning.<tr><td><a id="l474"></a><a href="#l474">474</a><td>    throw Error(&#39;Attribute &quot;&#39; + name +<tr><td><a id="l475"></a><a href="#l475">475</a><td>        &#39;&quot; requires goog.string.Const value, &quot;&#39; + value + &#39;&quot; given.&#39;);<tr><td><a id="l476"></a><a href="#l476">476</a><td>  // URL attributes handled differently accroding to tag.<tr><td><a id="l477"></a><a href="#l477">477</a><td>  } else if (name.toLowerCase() in goog.html.SafeHtml.URL_ATTRIBUTES_) {<tr><td><a id="l478"></a><a href="#l478">478</a><td>    if (value instanceof goog.html.TrustedResourceUrl) {<tr><td><a id="l479"></a><a href="#l479">479</a><td>      value = goog.html.TrustedResourceUrl.unwrap(value);<tr><td><a id="l480"></a><a href="#l480">480</a><td>    } else if (value instanceof goog.html.SafeUrl) {<tr><td><a id="l481"></a><a href="#l481">481</a><td>      value = goog.html.SafeUrl.unwrap(value);<tr><td><a id="l482"></a><a href="#l482">482</a><td>    } else if (goog.isString(value)) {<tr><td><a id="l483"></a><a href="#l483">483</a><td>      value = goog.html.SafeUrl.sanitize(value).getTypedStringValue();<tr><td><a id="l484"></a><a href="#l484">484</a><td>    } else {<tr><td><a id="l485"></a><a href="#l485">485</a><td>      throw Error(&#39;Attribute &quot;&#39; + name + &#39;&quot; on tag &quot;&#39; + tagName +<tr><td><a id="l486"></a><a href="#l486">486</a><td>          &#39;&quot; requires goog.html.SafeUrl, goog.string.Const, or string,&#39; +<tr><td><a id="l487"></a><a href="#l487">487</a><td>          &#39; value &quot;&#39; + value + &#39;&quot; given.&#39;);<tr><td><a id="l488"></a><a href="#l488">488</a><td>    }<tr><td><a id="l489"></a><a href="#l489">489</a><td>  }<tr><td><a id="l490"></a><a href="#l490">490</a><td><tr><td><a id="l491"></a><a href="#l491">491</a><td>  // Accept SafeUrl, TrustedResourceUrl, etc. for attributes which only require<tr><td><a id="l492"></a><a href="#l492">492</a><td>  // HTML-escaping.<tr><td><a id="l493"></a><a href="#l493">493</a><td>  if (value.implementsGoogStringTypedString) {<tr><td><a id="l494"></a><a href="#l494">494</a><td>    // Ok to call getTypedStringValue() since there&#39;s no reliance on the type<tr><td><a id="l495"></a><a href="#l495">495</a><td>    // contract for security here.<tr><td><a id="l496"></a><a href="#l496">496</a><td>    value = value.getTypedStringValue();<tr><td><a id="l497"></a><a href="#l497">497</a><td>  }<tr><td><a id="l498"></a><a href="#l498">498</a><td><tr><td><a id="l499"></a><a href="#l499">499</a><td>  goog.asserts.assert(goog.isString(value) || goog.isNumber(value),<tr><td><a id="l500"></a><a href="#l500">500</a><td>      &#39;String or number value expected, got &#39; +<tr><td><a id="l501"></a><a href="#l501">501</a><td>      (typeof value) + &#39; with value: &#39; + value);<tr><td><a id="l502"></a><a href="#l502">502</a><td>  return name + &#39;=&quot;&#39; + goog.string.htmlEscape(String(value)) + &#39;&quot;&#39;;<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>/**<tr><td><a id="l507"></a><a href="#l507">507</a><td> * Gets value allowed in &quot;style&quot; attribute.<tr><td><a id="l508"></a><a href="#l508">508</a><td> * @param {goog.html.SafeHtml.AttributeValue_} value It could be SafeStyle or a<tr><td><a id="l509"></a><a href="#l509">509</a><td> *     map which will be passed to goog.html.SafeStyle.create.<tr><td><a id="l510"></a><a href="#l510">510</a><td> * @return {string} Unwrapped value.<tr><td><a id="l511"></a><a href="#l511">511</a><td> * @throws {Error} If string value is given.<tr><td><a id="l512"></a><a href="#l512">512</a><td> * @private<tr><td><a id="l513"></a><a href="#l513">513</a><td> */<tr><td><a id="l514"></a><a href="#l514">514</a><td>goog.html.SafeHtml.getStyleValue_ = function(value) {<tr><td><a id="l515"></a><a href="#l515">515</a><td>  if (!goog.isObject(value)) {<tr><td><a id="l516"></a><a href="#l516">516</a><td>    throw Error(&#39;The &quot;style&quot; attribute requires goog.html.SafeStyle or map &#39; +<tr><td><a id="l517"></a><a href="#l517">517</a><td>        &#39;of style properties, &#39; + (typeof value) + &#39; given: &#39; + 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>  if (!(value instanceof goog.html.SafeStyle)) {<tr><td><a id="l520"></a><a href="#l520">520</a><td>    // Process the property bag into a style object.<tr><td><a id="l521"></a><a href="#l521">521</a><td>    value = goog.html.SafeStyle.create(value);<tr><td><a id="l522"></a><a href="#l522">522</a><td>  }<tr><td><a id="l523"></a><a href="#l523">523</a><td>  return goog.html.SafeStyle.unwrap(value);<tr><td><a id="l524"></a><a href="#l524">524</a><td>};<tr><td><a id="l525"></a><a href="#l525">525</a><td><tr><td><a id="l526"></a><a href="#l526">526</a><td><tr><td><a id="l527"></a><a href="#l527">527</a><td>/**<tr><td><a id="l528"></a><a href="#l528">528</a><td> * Creates a SafeHtml content with known directionality consisting of a tag with<tr><td><a id="l529"></a><a href="#l529">529</a><td> * optional attributes and optional content.<tr><td><a id="l530"></a><a href="#l530">530</a><td> * @param {!goog.i18n.bidi.Dir} dir Directionality.<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @param {string} tagName<tr><td><a id="l532"></a><a href="#l532">532</a><td> * @param {!Object&lt;string, goog.html.SafeHtml.AttributeValue_&gt;=} opt_attributes<tr><td><a id="l533"></a><a href="#l533">533</a><td> * @param {!goog.html.SafeHtml.TextOrHtml_|<tr><td><a id="l534"></a><a href="#l534">534</a><td> *     !Array&lt;!goog.html.SafeHtml.TextOrHtml_&gt;=} opt_content<tr><td><a id="l535"></a><a href="#l535">535</a><td> * @return {!goog.html.SafeHtml} The SafeHtml content with the tag.<tr><td><a id="l536"></a><a href="#l536">536</a><td> */<tr><td><a id="l537"></a><a href="#l537">537</a><td>goog.html.SafeHtml.createWithDir = function(dir, tagName, opt_attributes,<tr><td><a id="l538"></a><a href="#l538">538</a><td>    opt_content) {<tr><td><a id="l539"></a><a href="#l539">539</a><td>  var html = goog.html.SafeHtml.create(tagName, opt_attributes, opt_content);<tr><td><a id="l540"></a><a href="#l540">540</a><td>  html.dir_ = dir;<tr><td><a id="l541"></a><a href="#l541">541</a><td>  return html;<tr><td><a id="l542"></a><a href="#l542">542</a><td>};<tr><td><a id="l543"></a><a href="#l543">543</a><td><tr><td><a id="l544"></a><a href="#l544">544</a><td><tr><td><a id="l545"></a><a href="#l545">545</a><td>/**<tr><td><a id="l546"></a><a href="#l546">546</a><td> * Creates a new SafeHtml object by concatenating values.<tr><td><a id="l547"></a><a href="#l547">547</a><td> * @param {...(!goog.html.SafeHtml.TextOrHtml_|<tr><td><a id="l548"></a><a href="#l548">548</a><td> *     !Array&lt;!goog.html.SafeHtml.TextOrHtml_&gt;)} var_args Values to concatenate.<tr><td><a id="l549"></a><a href="#l549">549</a><td> * @return {!goog.html.SafeHtml}<tr><td><a id="l550"></a><a href="#l550">550</a><td> */<tr><td><a id="l551"></a><a href="#l551">551</a><td>goog.html.SafeHtml.concat = function(var_args) {<tr><td><a id="l552"></a><a href="#l552">552</a><td>  var dir = goog.i18n.bidi.Dir.NEUTRAL;<tr><td><a id="l553"></a><a href="#l553">553</a><td>  var content = &#39;&#39;;<tr><td><a id="l554"></a><a href="#l554">554</a><td><tr><td><a id="l555"></a><a href="#l555">555</a><td>  /**<tr><td><a id="l556"></a><a href="#l556">556</a><td>   * @param {!goog.html.SafeHtml.TextOrHtml_|<tr><td><a id="l557"></a><a href="#l557">557</a><td>   *     !Array&lt;!goog.html.SafeHtml.TextOrHtml_&gt;} argument<tr><td><a id="l558"></a><a href="#l558">558</a><td>   */<tr><td><a id="l559"></a><a href="#l559">559</a><td>  var addArgument = function(argument) {<tr><td><a id="l560"></a><a href="#l560">560</a><td>    if (goog.isArray(argument)) {<tr><td><a id="l561"></a><a href="#l561">561</a><td>      goog.array.forEach(argument, addArgument);<tr><td><a id="l562"></a><a href="#l562">562</a><td>    } else {<tr><td><a id="l563"></a><a href="#l563">563</a><td>      var html = goog.html.SafeHtml.htmlEscape(argument);<tr><td><a id="l564"></a><a href="#l564">564</a><td>      content += goog.html.SafeHtml.unwrap(html);<tr><td><a id="l565"></a><a href="#l565">565</a><td>      var htmlDir = html.getDirection();<tr><td><a id="l566"></a><a href="#l566">566</a><td>      if (dir == goog.i18n.bidi.Dir.NEUTRAL) {<tr><td><a id="l567"></a><a href="#l567">567</a><td>        dir = htmlDir;<tr><td><a id="l568"></a><a href="#l568">568</a><td>      } else if (htmlDir != goog.i18n.bidi.Dir.NEUTRAL &amp;&amp; dir != htmlDir) {<tr><td><a id="l569"></a><a href="#l569">569</a><td>        dir = null;<tr><td><a id="l570"></a><a href="#l570">570</a><td>      }<tr><td><a id="l571"></a><a href="#l571">571</a><td>    }<tr><td><a id="l572"></a><a href="#l572">572</a><td>  };<tr><td><a id="l573"></a><a href="#l573">573</a><td><tr><td><a id="l574"></a><a href="#l574">574</a><td>  goog.array.forEach(arguments, addArgument);<tr><td><a id="l575"></a><a href="#l575">575</a><td>  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l576"></a><a href="#l576">576</a><td>      content, dir);<tr><td><a id="l577"></a><a href="#l577">577</a><td>};<tr><td><a id="l578"></a><a href="#l578">578</a><td><tr><td><a id="l579"></a><a href="#l579">579</a><td><tr><td><a id="l580"></a><a href="#l580">580</a><td>/**<tr><td><a id="l581"></a><a href="#l581">581</a><td> * Creates a new SafeHtml object with known directionality by concatenating the<tr><td><a id="l582"></a><a href="#l582">582</a><td> * values.<tr><td><a id="l583"></a><a href="#l583">583</a><td> * @param {!goog.i18n.bidi.Dir} dir Directionality.<tr><td><a id="l584"></a><a href="#l584">584</a><td> * @param {...(!goog.html.SafeHtml.TextOrHtml_|<tr><td><a id="l585"></a><a href="#l585">585</a><td> *     !Array&lt;!goog.html.SafeHtml.TextOrHtml_&gt;)} var_args Elements of array<tr><td><a id="l586"></a><a href="#l586">586</a><td> *     arguments would be processed recursively.<tr><td><a id="l587"></a><a href="#l587">587</a><td> * @return {!goog.html.SafeHtml}<tr><td><a id="l588"></a><a href="#l588">588</a><td> */<tr><td><a id="l589"></a><a href="#l589">589</a><td>goog.html.SafeHtml.concatWithDir = function(dir, var_args) {<tr><td><a id="l590"></a><a href="#l590">590</a><td>  var html = goog.html.SafeHtml.concat(goog.array.slice(arguments, 1));<tr><td><a id="l591"></a><a href="#l591">591</a><td>  html.dir_ = dir;<tr><td><a id="l592"></a><a href="#l592">592</a><td>  return html;<tr><td><a id="l593"></a><a href="#l593">593</a><td>};<tr><td><a id="l594"></a><a href="#l594">594</a><td><tr><td><a id="l595"></a><a href="#l595">595</a><td><tr><td><a id="l596"></a><a href="#l596">596</a><td>/**<tr><td><a id="l597"></a><a href="#l597">597</a><td> * Type marker for the SafeHtml type, used to implement additional run-time<tr><td><a id="l598"></a><a href="#l598">598</a><td> * type checking.<tr><td><a id="l599"></a><a href="#l599">599</a><td> * @const {!Object}<tr><td><a id="l600"></a><a href="#l600">600</a><td> * @private<tr><td><a id="l601"></a><a href="#l601">601</a><td> */<tr><td><a id="l602"></a><a href="#l602">602</a><td>goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};<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> * Package-internal utility method to create SafeHtml instances.<tr><td><a id="l607"></a><a href="#l607">607</a><td> *<tr><td><a id="l608"></a><a href="#l608">608</a><td> * @param {string} html The string to initialize the SafeHtml object with.<tr><td><a id="l609"></a><a href="#l609">609</a><td> * @param {?goog.i18n.bidi.Dir} dir The directionality of the SafeHtml to be<tr><td><a id="l610"></a><a href="#l610">610</a><td> *     constructed, or null if unknown.<tr><td><a id="l611"></a><a href="#l611">611</a><td> * @return {!goog.html.SafeHtml} The initialized SafeHtml object.<tr><td><a id="l612"></a><a href="#l612">612</a><td> * @package<tr><td><a id="l613"></a><a href="#l613">613</a><td> */<tr><td><a id="l614"></a><a href="#l614">614</a><td>goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse = function(<tr><td><a id="l615"></a><a href="#l615">615</a><td>    html, dir) {<tr><td><a id="l616"></a><a href="#l616">616</a><td>  return new goog.html.SafeHtml().initSecurityPrivateDoNotAccessOrElse_(<tr><td><a id="l617"></a><a href="#l617">617</a><td>      html, dir);<tr><td><a id="l618"></a><a href="#l618">618</a><td>};<tr><td><a id="l619"></a><a href="#l619">619</a><td><tr><td><a id="l620"></a><a href="#l620">620</a><td><tr><td><a id="l621"></a><a href="#l621">621</a><td>/**<tr><td><a id="l622"></a><a href="#l622">622</a><td> * Called from createSafeHtmlSecurityPrivateDoNotAccessOrElse(). This<tr><td><a id="l623"></a><a href="#l623">623</a><td> * method exists only so that the compiler can dead code eliminate static<tr><td><a id="l624"></a><a href="#l624">624</a><td> * fields (like EMPTY) when they&#39;re not accessed.<tr><td><a id="l625"></a><a href="#l625">625</a><td> * @param {string} html<tr><td><a id="l626"></a><a href="#l626">626</a><td> * @param {?goog.i18n.bidi.Dir} dir<tr><td><a id="l627"></a><a href="#l627">627</a><td> * @return {!goog.html.SafeHtml}<tr><td><a id="l628"></a><a href="#l628">628</a><td> * @private<tr><td><a id="l629"></a><a href="#l629">629</a><td> */<tr><td><a id="l630"></a><a href="#l630">630</a><td>goog.html.SafeHtml.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(<tr><td><a id="l631"></a><a href="#l631">631</a><td>    html, dir) {<tr><td><a id="l632"></a><a href="#l632">632</a><td>  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = html;<tr><td><a id="l633"></a><a href="#l633">633</a><td>  this.dir_ = dir;<tr><td><a id="l634"></a><a href="#l634">634</a><td>  return this;<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><tr><td><a id="l638"></a><a href="#l638">638</a><td>/**<tr><td><a id="l639"></a><a href="#l639">639</a><td> * Like create() but does not restrict which tags can be constructed.<tr><td><a id="l640"></a><a href="#l640">640</a><td> *<tr><td><a id="l641"></a><a href="#l641">641</a><td> * @param {string} tagName Tag name. Set or validated by caller.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @param {!Object&lt;string, goog.html.SafeHtml.AttributeValue_&gt;=} opt_attributes<tr><td><a id="l643"></a><a href="#l643">643</a><td> * @param {(!goog.html.SafeHtml.TextOrHtml_|<tr><td><a id="l644"></a><a href="#l644">644</a><td> *     !Array&lt;!goog.html.SafeHtml.TextOrHtml_&gt;)=} opt_content<tr><td><a id="l645"></a><a href="#l645">645</a><td> * @return {!goog.html.SafeHtml}<tr><td><a id="l646"></a><a href="#l646">646</a><td> * @throws {Error} If invalid or unsafe attribute name or value is provided.<tr><td><a id="l647"></a><a href="#l647">647</a><td> * @throws {goog.asserts.AssertionError} If content for void tag is provided.<tr><td><a id="l648"></a><a href="#l648">648</a><td> * @package<tr><td><a id="l649"></a><a href="#l649">649</a><td> */<tr><td><a id="l650"></a><a href="#l650">650</a><td>goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse =<tr><td><a id="l651"></a><a href="#l651">651</a><td>    function(tagName, opt_attributes, opt_content) {<tr><td><a id="l652"></a><a href="#l652">652</a><td>  var dir = null;<tr><td><a id="l653"></a><a href="#l653">653</a><td>  var result = &#39;&lt;&#39; + tagName;<tr><td><a id="l654"></a><a href="#l654">654</a><td><tr><td><a id="l655"></a><a href="#l655">655</a><td>  if (opt_attributes) {<tr><td><a id="l656"></a><a href="#l656">656</a><td>    for (var name in opt_attributes) {<tr><td><a id="l657"></a><a href="#l657">657</a><td>      if (!goog.html.SafeHtml.VALID_NAMES_IN_TAG_.test(name)) {<tr><td><a id="l658"></a><a href="#l658">658</a><td>        throw Error(&#39;Invalid attribute name &quot;&#39; + name + &#39;&quot;.&#39;);<tr><td><a id="l659"></a><a href="#l659">659</a><td>      }<tr><td><a id="l660"></a><a href="#l660">660</a><td>      var value = opt_attributes[name];<tr><td><a id="l661"></a><a href="#l661">661</a><td>      if (!goog.isDefAndNotNull(value)) {<tr><td><a id="l662"></a><a href="#l662">662</a><td>        continue;<tr><td><a id="l663"></a><a href="#l663">663</a><td>      }<tr><td><a id="l664"></a><a href="#l664">664</a><td>      result += &#39; &#39; +<tr><td><a id="l665"></a><a href="#l665">665</a><td>          goog.html.SafeHtml.getAttrNameAndValue_(tagName, name, value);<tr><td><a id="l666"></a><a href="#l666">666</a><td>    }<tr><td><a id="l667"></a><a href="#l667">667</a><td>  }<tr><td><a id="l668"></a><a href="#l668">668</a><td><tr><td><a id="l669"></a><a href="#l669">669</a><td>  var content = opt_content;<tr><td><a id="l670"></a><a href="#l670">670</a><td>  if (!goog.isDefAndNotNull(content)) {<tr><td><a id="l671"></a><a href="#l671">671</a><td>    content = [];<tr><td><a id="l672"></a><a href="#l672">672</a><td>  } else if (!goog.isArray(content)) {<tr><td><a id="l673"></a><a href="#l673">673</a><td>    content = [content];<tr><td><a id="l674"></a><a href="#l674">674</a><td>  }<tr><td><a id="l675"></a><a href="#l675">675</a><td><tr><td><a id="l676"></a><a href="#l676">676</a><td>  if (goog.dom.tags.isVoidTag(tagName.toLowerCase())) {<tr><td><a id="l677"></a><a href="#l677">677</a><td>    goog.asserts.assert(!content.length,<tr><td><a id="l678"></a><a href="#l678">678</a><td>        &#39;Void tag &lt;&#39; + tagName + &#39;&gt; does not allow content.&#39;);<tr><td><a id="l679"></a><a href="#l679">679</a><td>    result += &#39;&gt;&#39;;<tr><td><a id="l680"></a><a href="#l680">680</a><td>  } else {<tr><td><a id="l681"></a><a href="#l681">681</a><td>    var html = goog.html.SafeHtml.concat(content);<tr><td><a id="l682"></a><a href="#l682">682</a><td>    result += &#39;&gt;&#39; + goog.html.SafeHtml.unwrap(html) + &#39;&lt;/&#39; + tagName + &#39;&gt;&#39;;<tr><td><a id="l683"></a><a href="#l683">683</a><td>    dir = html.getDirection();<tr><td><a id="l684"></a><a href="#l684">684</a><td>  }<tr><td><a id="l685"></a><a href="#l685">685</a><td><tr><td><a id="l686"></a><a href="#l686">686</a><td>  var dirAttribute = opt_attributes &amp;&amp; opt_attributes[&#39;dir&#39;];<tr><td><a id="l687"></a><a href="#l687">687</a><td>  if (dirAttribute) {<tr><td><a id="l688"></a><a href="#l688">688</a><td>    if (/^(ltr|rtl|auto)$/i.test(dirAttribute)) {<tr><td><a id="l689"></a><a href="#l689">689</a><td>      // If the tag has the &quot;dir&quot; attribute specified then its direction is<tr><td><a id="l690"></a><a href="#l690">690</a><td>      // neutral because it can be safely used in any context.<tr><td><a id="l691"></a><a href="#l691">691</a><td>      dir = goog.i18n.bidi.Dir.NEUTRAL;<tr><td><a id="l692"></a><a href="#l692">692</a><td>    } else {<tr><td><a id="l693"></a><a href="#l693">693</a><td>      dir = null;<tr><td><a id="l694"></a><a href="#l694">694</a><td>    }<tr><td><a id="l695"></a><a href="#l695">695</a><td>  }<tr><td><a id="l696"></a><a href="#l696">696</a><td><tr><td><a id="l697"></a><a href="#l697">697</a><td>  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l698"></a><a href="#l698">698</a><td>      result, dir);<tr><td><a id="l699"></a><a href="#l699">699</a><td>};<tr><td><a id="l700"></a><a href="#l700">700</a><td><tr><td><a id="l701"></a><a href="#l701">701</a><td><tr><td><a id="l702"></a><a href="#l702">702</a><td>/**<tr><td><a id="l703"></a><a href="#l703">703</a><td> * @param {!Object&lt;string, string&gt;} fixedAttributes<tr><td><a id="l704"></a><a href="#l704">704</a><td> * @param {!Object&lt;string, string&gt;} defaultAttributes<tr><td><a id="l705"></a><a href="#l705">705</a><td> * @param {!Object&lt;string, goog.html.SafeHtml.AttributeValue_&gt;=}<tr><td><a id="l706"></a><a href="#l706">706</a><td> *     opt_attributes Optional attributes passed to create*().<tr><td><a id="l707"></a><a href="#l707">707</a><td> * @return {!Object&lt;string, goog.html.SafeHtml.AttributeValue_&gt;}<tr><td><a id="l708"></a><a href="#l708">708</a><td> * @throws {Error} If opt_attributes contains an attribute with the same name<tr><td><a id="l709"></a><a href="#l709">709</a><td> *     as an attribute in fixedAttributes.<tr><td><a id="l710"></a><a href="#l710">710</a><td> * @package<tr><td><a id="l711"></a><a href="#l711">711</a><td> */<tr><td><a id="l712"></a><a href="#l712">712</a><td>goog.html.SafeHtml.combineAttributes = function(<tr><td><a id="l713"></a><a href="#l713">713</a><td>    fixedAttributes, defaultAttributes, opt_attributes) {<tr><td><a id="l714"></a><a href="#l714">714</a><td>  var combinedAttributes = {};<tr><td><a id="l715"></a><a href="#l715">715</a><td>  var name;<tr><td><a id="l716"></a><a href="#l716">716</a><td><tr><td><a id="l717"></a><a href="#l717">717</a><td>  for (name in fixedAttributes) {<tr><td><a id="l718"></a><a href="#l718">718</a><td>    goog.asserts.assert(name.toLowerCase() == name, &#39;Must be lower case&#39;);<tr><td><a id="l719"></a><a href="#l719">719</a><td>    combinedAttributes[name] = fixedAttributes[name];<tr><td><a id="l720"></a><a href="#l720">720</a><td>  }<tr><td><a id="l721"></a><a href="#l721">721</a><td>  for (name in defaultAttributes) {<tr><td><a id="l722"></a><a href="#l722">722</a><td>    goog.asserts.assert(name.toLowerCase() == name, &#39;Must be lower case&#39;);<tr><td><a id="l723"></a><a href="#l723">723</a><td>    combinedAttributes[name] = defaultAttributes[name];<tr><td><a id="l724"></a><a href="#l724">724</a><td>  }<tr><td><a id="l725"></a><a href="#l725">725</a><td><tr><td><a id="l726"></a><a href="#l726">726</a><td>  for (name in opt_attributes) {<tr><td><a id="l727"></a><a href="#l727">727</a><td>    var nameLower = name.toLowerCase();<tr><td><a id="l728"></a><a href="#l728">728</a><td>    if (nameLower in fixedAttributes) {<tr><td><a id="l729"></a><a href="#l729">729</a><td>      throw Error(&#39;Cannot override &quot;&#39; + nameLower + &#39;&quot; attribute, got &quot;&#39; +<tr><td><a id="l730"></a><a href="#l730">730</a><td>          name + &#39;&quot; with value &quot;&#39; + opt_attributes[name] + &#39;&quot;&#39;);<tr><td><a id="l731"></a><a href="#l731">731</a><td>    }<tr><td><a id="l732"></a><a href="#l732">732</a><td>    if (nameLower in defaultAttributes) {<tr><td><a id="l733"></a><a href="#l733">733</a><td>      delete combinedAttributes[nameLower];<tr><td><a id="l734"></a><a href="#l734">734</a><td>    }<tr><td><a id="l735"></a><a href="#l735">735</a><td>    combinedAttributes[name] = opt_attributes[name];<tr><td><a id="l736"></a><a href="#l736">736</a><td>  }<tr><td><a id="l737"></a><a href="#l737">737</a><td><tr><td><a id="l738"></a><a href="#l738">738</a><td>  return combinedAttributes;<tr><td><a id="l739"></a><a href="#l739">739</a><td>};<tr><td><a id="l740"></a><a href="#l740">740</a><td><tr><td><a id="l741"></a><a href="#l741">741</a><td><tr><td><a id="l742"></a><a href="#l742">742</a><td>/**<tr><td><a id="l743"></a><a href="#l743">743</a><td> * A SafeHtml instance corresponding to the HTML doctype: &quot;&lt;!DOCTYPE html&gt;&quot;.<tr><td><a id="l744"></a><a href="#l744">744</a><td> * @const {!goog.html.SafeHtml}<tr><td><a id="l745"></a><a href="#l745">745</a><td> */<tr><td><a id="l746"></a><a href="#l746">746</a><td>goog.html.SafeHtml.DOCTYPE_HTML =<tr><td><a id="l747"></a><a href="#l747">747</a><td>    goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l748"></a><a href="#l748">748</a><td>        &#39;&lt;!DOCTYPE html&gt;&#39;, goog.i18n.bidi.Dir.NEUTRAL);<tr><td><a id="l749"></a><a href="#l749">749</a><td><tr><td><a id="l750"></a><a href="#l750">750</a><td><tr><td><a id="l751"></a><a href="#l751">751</a><td>/**<tr><td><a id="l752"></a><a href="#l752">752</a><td> * A SafeHtml instance corresponding to the empty string.<tr><td><a id="l753"></a><a href="#l753">753</a><td> * @const {!goog.html.SafeHtml}<tr><td><a id="l754"></a><a href="#l754">754</a><td> */<tr><td><a id="l755"></a><a href="#l755">755</a><td>goog.html.SafeHtml.EMPTY =<tr><td><a id="l756"></a><a href="#l756">756</a><td>    goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l757"></a><a href="#l757">757</a><td>        &#39;&#39;, goog.i18n.bidi.Dir.NEUTRAL);</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/html/safescript.js.src.html b/docs/source/lib/goog/html/safescript.js.src.html
new file mode 100644
index 0000000..bf38421
--- /dev/null
+++ b/docs/source/lib/goog/html/safescript.js.src.html
@@ -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>safescript.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/html/safescript.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2014 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview The SafeScript type and its builders.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * TODO(xtof): Link to document stating type contract.<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.html.SafeScript&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.string.TypedString&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>/**<tr><td><a id="l30"></a><a href="#l30">30</a><td> * A string-like object which represents JavaScript code and that carries the<tr><td><a id="l31"></a><a href="#l31">31</a><td> * security type contract that its value, as a string, will not cause execution<tr><td><a id="l32"></a><a href="#l32">32</a><td> * of unconstrained attacker controlled code (XSS) when evaluated as JavaScript<tr><td><a id="l33"></a><a href="#l33">33</a><td> * in a browser.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Instances of this type must be created via the factory method<tr><td><a id="l36"></a><a href="#l36">36</a><td> * {@code goog.html.SafeScript.fromConstant} and not by invoking its<tr><td><a id="l37"></a><a href="#l37">37</a><td> * constructor. The constructor intentionally takes no parameters and the type<tr><td><a id="l38"></a><a href="#l38">38</a><td> * is immutable; hence only a default instance corresponding to the empty string<tr><td><a id="l39"></a><a href="#l39">39</a><td> * can be obtained via constructor invocation.<tr><td><a id="l40"></a><a href="#l40">40</a><td> *<tr><td><a id="l41"></a><a href="#l41">41</a><td> * A SafeScript&#39;s string representation can safely be interpolated as the<tr><td><a id="l42"></a><a href="#l42">42</a><td> * content of a script element within HTML. The SafeScript string should not be<tr><td><a id="l43"></a><a href="#l43">43</a><td> * escaped before interpolation.<tr><td><a id="l44"></a><a href="#l44">44</a><td> *<tr><td><a id="l45"></a><a href="#l45">45</a><td> * Note that the SafeScript might contain text that is attacker-controlled but<tr><td><a id="l46"></a><a href="#l46">46</a><td> * that text should have been interpolated with appropriate escaping,<tr><td><a id="l47"></a><a href="#l47">47</a><td> * sanitization and/or validation into the right location in the script, such<tr><td><a id="l48"></a><a href="#l48">48</a><td> * that it is highly constrained in its effect (for example, it had to match a<tr><td><a id="l49"></a><a href="#l49">49</a><td> * set of whitelisted words).<tr><td><a id="l50"></a><a href="#l50">50</a><td> *<tr><td><a id="l51"></a><a href="#l51">51</a><td> * A SafeScript can be constructed via security-reviewed unchecked<tr><td><a id="l52"></a><a href="#l52">52</a><td> * conversions. In this case producers of SafeScript must ensure themselves that<tr><td><a id="l53"></a><a href="#l53">53</a><td> * the SafeScript does not contain unsafe script. Note in particular that<tr><td><a id="l54"></a><a href="#l54">54</a><td> * {@code &amp;lt;} is dangerous, even when inside JavaScript strings, and so should<tr><td><a id="l55"></a><a href="#l55">55</a><td> * always be forbidden or JavaScript escaped in user controlled input. For<tr><td><a id="l56"></a><a href="#l56">56</a><td> * example, if {@code &amp;lt;/script&amp;gt;&amp;lt;script&amp;gt;evil&amp;lt;/script&amp;gt;&quot;} were<tr><td><a id="l57"></a><a href="#l57">57</a><td> * interpolated inside a JavaScript string, it would break out of the context<tr><td><a id="l58"></a><a href="#l58">58</a><td> * of the original script element and {@code evil} would execute. Also note<tr><td><a id="l59"></a><a href="#l59">59</a><td> * that within an HTML script (raw text) element, HTML character references,<tr><td><a id="l60"></a><a href="#l60">60</a><td> * such as &quot;&amp;lt;&quot; are not allowed. See<tr><td><a id="l61"></a><a href="#l61">61</a><td> * http://www.w3.org/TR/html5/scripting-1.html#restrictions-for-contents-of-script-elements.<tr><td><a id="l62"></a><a href="#l62">62</a><td> *<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @see goog.html.SafeScript#fromConstant<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @constructor<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @final<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @struct<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @implements {goog.string.TypedString}<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.html.SafeScript = function() {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  /**<tr><td><a id="l71"></a><a href="#l71">71</a><td>   * The contained value of this SafeScript.  The field has a purposely<tr><td><a id="l72"></a><a href="#l72">72</a><td>   * ugly name to make (non-compiled) code that attempts to directly access this<tr><td><a id="l73"></a><a href="#l73">73</a><td>   * field stand out.<tr><td><a id="l74"></a><a href="#l74">74</a><td>   * @private {string}<tr><td><a id="l75"></a><a href="#l75">75</a><td>   */<tr><td><a id="l76"></a><a href="#l76">76</a><td>  this.privateDoNotAccessOrElseSafeScriptWrappedValue_ = &#39;&#39;;<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>   * A type marker used to implement additional run-time type checking.<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * @see goog.html.SafeScript#unwrap<tr><td><a id="l81"></a><a href="#l81">81</a><td>   * @const<tr><td><a id="l82"></a><a href="#l82">82</a><td>   * @private<tr><td><a id="l83"></a><a href="#l83">83</a><td>   */<tr><td><a id="l84"></a><a href="#l84">84</a><td>  this.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =<tr><td><a id="l85"></a><a href="#l85">85</a><td>      goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<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> * @override<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @const<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.html.SafeScript.prototype.implementsGoogStringTypedString = true;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>/**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Type marker for the SafeScript type, used to implement additional<tr><td><a id="l98"></a><a href="#l98">98</a><td> * run-time type checking.<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @const {!Object}<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @private<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * Creates a SafeScript object from a compile-time constant string.<tr><td><a id="l107"></a><a href="#l107">107</a><td> *<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @param {!goog.string.Const} script A compile-time-constant string from which<tr><td><a id="l109"></a><a href="#l109">109</a><td> *     to create a SafeScript.<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @return {!goog.html.SafeScript} A SafeScript object initialized to<tr><td><a id="l111"></a><a href="#l111">111</a><td> *     {@code script}.<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.html.SafeScript.fromConstant = function(script) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  var scriptString = goog.string.Const.unwrap(script);<tr><td><a id="l115"></a><a href="#l115">115</a><td>  if (scriptString.length === 0) {<tr><td><a id="l116"></a><a href="#l116">116</a><td>    return goog.html.SafeScript.EMPTY;<tr><td><a id="l117"></a><a href="#l117">117</a><td>  }<tr><td><a id="l118"></a><a href="#l118">118</a><td>  return goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l119"></a><a href="#l119">119</a><td>      scriptString);<tr><td><a id="l120"></a><a href="#l120">120</a><td>};<tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>/**<tr><td><a id="l124"></a><a href="#l124">124</a><td> * Returns this SafeScript&#39;s value as a string.<tr><td><a id="l125"></a><a href="#l125">125</a><td> *<tr><td><a id="l126"></a><a href="#l126">126</a><td> * IMPORTANT: In code where it is security relevant that an object&#39;s type is<tr><td><a id="l127"></a><a href="#l127">127</a><td> * indeed {@code SafeScript}, use {@code goog.html.SafeScript.unwrap} instead of<tr><td><a id="l128"></a><a href="#l128">128</a><td> * this method. If in doubt, assume that it&#39;s security relevant. In particular,<tr><td><a id="l129"></a><a href="#l129">129</a><td> * note that goog.html functions which return a goog.html type do not guarantee<tr><td><a id="l130"></a><a href="#l130">130</a><td> * the returned instance is of the right type. For example:<tr><td><a id="l131"></a><a href="#l131">131</a><td> *<tr><td><a id="l132"></a><a href="#l132">132</a><td> * &lt;pre&gt;<tr><td><a id="l133"></a><a href="#l133">133</a><td> * var fakeSafeHtml = new String(&#39;fake&#39;);<tr><td><a id="l134"></a><a href="#l134">134</a><td> * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;<tr><td><a id="l135"></a><a href="#l135">135</a><td> * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);<tr><td><a id="l136"></a><a href="#l136">136</a><td> * // newSafeHtml is just an alias for fakeSafeHtml, it&#39;s passed through by<tr><td><a id="l137"></a><a href="#l137">137</a><td> * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml<tr><td><a id="l138"></a><a href="#l138">138</a><td> * // instanceof goog.html.SafeHtml.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * &lt;/pre&gt;<tr><td><a id="l140"></a><a href="#l140">140</a><td> *<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @see goog.html.SafeScript#unwrap<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @override<tr><td><a id="l143"></a><a href="#l143">143</a><td> */<tr><td><a id="l144"></a><a href="#l144">144</a><td>goog.html.SafeScript.prototype.getTypedStringValue = function() {<tr><td><a id="l145"></a><a href="#l145">145</a><td>  return this.privateDoNotAccessOrElseSafeScriptWrappedValue_;<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>if (goog.DEBUG) {<tr><td><a id="l150"></a><a href="#l150">150</a><td>  /**<tr><td><a id="l151"></a><a href="#l151">151</a><td>   * Returns a debug string-representation of this value.<tr><td><a id="l152"></a><a href="#l152">152</a><td>   *<tr><td><a id="l153"></a><a href="#l153">153</a><td>   * To obtain the actual string value wrapped in a SafeScript, use<tr><td><a id="l154"></a><a href="#l154">154</a><td>   * {@code goog.html.SafeScript.unwrap}.<tr><td><a id="l155"></a><a href="#l155">155</a><td>   *<tr><td><a id="l156"></a><a href="#l156">156</a><td>   * @see goog.html.SafeScript#unwrap<tr><td><a id="l157"></a><a href="#l157">157</a><td>   * @override<tr><td><a id="l158"></a><a href="#l158">158</a><td>   */<tr><td><a id="l159"></a><a href="#l159">159</a><td>  goog.html.SafeScript.prototype.toString = function() {<tr><td><a id="l160"></a><a href="#l160">160</a><td>    return &#39;SafeScript{&#39; +<tr><td><a id="l161"></a><a href="#l161">161</a><td>        this.privateDoNotAccessOrElseSafeScriptWrappedValue_ + &#39;}&#39;;<tr><td><a id="l162"></a><a href="#l162">162</a><td>  };<tr><td><a id="l163"></a><a href="#l163">163</a><td>}<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> * Performs a runtime check that the provided object is indeed a<tr><td><a id="l168"></a><a href="#l168">168</a><td> * SafeScript object, and returns its value.<tr><td><a id="l169"></a><a href="#l169">169</a><td> *<tr><td><a id="l170"></a><a href="#l170">170</a><td> * @param {!goog.html.SafeScript} safeScript The object to extract from.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @return {string} The safeScript object&#39;s contained string, unless<tr><td><a id="l172"></a><a href="#l172">172</a><td> *     the run-time type check fails. In that case, {@code unwrap} returns an<tr><td><a id="l173"></a><a href="#l173">173</a><td> *     innocuous string, or, if assertions are enabled, throws<tr><td><a id="l174"></a><a href="#l174">174</a><td> *     {@code goog.asserts.AssertionError}.<tr><td><a id="l175"></a><a href="#l175">175</a><td> */<tr><td><a id="l176"></a><a href="#l176">176</a><td>goog.html.SafeScript.unwrap = function(safeScript) {<tr><td><a id="l177"></a><a href="#l177">177</a><td>  // Perform additional Run-time type-checking to ensure that<tr><td><a id="l178"></a><a href="#l178">178</a><td>  // safeScript is indeed an instance of the expected type.  This<tr><td><a id="l179"></a><a href="#l179">179</a><td>  // provides some additional protection against security bugs due to<tr><td><a id="l180"></a><a href="#l180">180</a><td>  // application code that disables type checks.<tr><td><a id="l181"></a><a href="#l181">181</a><td>  // Specifically, the following checks are performed:<tr><td><a id="l182"></a><a href="#l182">182</a><td>  // 1. The object is an instance of the expected type.<tr><td><a id="l183"></a><a href="#l183">183</a><td>  // 2. The object is not an instance of a subclass.<tr><td><a id="l184"></a><a href="#l184">184</a><td>  // 3. The object carries a type marker for the expected type. &quot;Faking&quot; an<tr><td><a id="l185"></a><a href="#l185">185</a><td>  // object requires a reference to the type marker, which has names intended<tr><td><a id="l186"></a><a href="#l186">186</a><td>  // to stand out in code reviews.<tr><td><a id="l187"></a><a href="#l187">187</a><td>  if (safeScript instanceof goog.html.SafeScript &amp;&amp;<tr><td><a id="l188"></a><a href="#l188">188</a><td>      safeScript.constructor === goog.html.SafeScript &amp;&amp;<tr><td><a id="l189"></a><a href="#l189">189</a><td>      safeScript.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===<tr><td><a id="l190"></a><a href="#l190">190</a><td>          goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {<tr><td><a id="l191"></a><a href="#l191">191</a><td>    return safeScript.privateDoNotAccessOrElseSafeScriptWrappedValue_;<tr><td><a id="l192"></a><a href="#l192">192</a><td>  } else {<tr><td><a id="l193"></a><a href="#l193">193</a><td>    goog.asserts.fail(<tr><td><a id="l194"></a><a href="#l194">194</a><td>        &#39;expected object of type SafeScript, got \&#39;&#39; + safeScript + &#39;\&#39;&#39;);<tr><td><a id="l195"></a><a href="#l195">195</a><td>    return &#39;type_error:SafeScript&#39;;<tr><td><a id="l196"></a><a href="#l196">196</a><td>  }<tr><td><a id="l197"></a><a href="#l197">197</a><td>};<tr><td><a id="l198"></a><a href="#l198">198</a><td><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> * Package-internal utility method to create SafeScript instances.<tr><td><a id="l202"></a><a href="#l202">202</a><td> *<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {string} script The string to initialize the SafeScript object with.<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @return {!goog.html.SafeScript} The initialized SafeScript object.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @package<tr><td><a id="l206"></a><a href="#l206">206</a><td> */<tr><td><a id="l207"></a><a href="#l207">207</a><td>goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse =<tr><td><a id="l208"></a><a href="#l208">208</a><td>    function(script) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>  return new goog.html.SafeScript().initSecurityPrivateDoNotAccessOrElse_(<tr><td><a id="l210"></a><a href="#l210">210</a><td>      script);<tr><td><a id="l211"></a><a href="#l211">211</a><td>};<tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td>/**<tr><td><a id="l215"></a><a href="#l215">215</a><td> * Called from createSafeScriptSecurityPrivateDoNotAccessOrElse(). This<tr><td><a id="l216"></a><a href="#l216">216</a><td> * method exists only so that the compiler can dead code eliminate static<tr><td><a id="l217"></a><a href="#l217">217</a><td> * fields (like EMPTY) when they&#39;re not accessed.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @param {string} script<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @return {!goog.html.SafeScript}<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @private<tr><td><a id="l221"></a><a href="#l221">221</a><td> */<tr><td><a id="l222"></a><a href="#l222">222</a><td>goog.html.SafeScript.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(<tr><td><a id="l223"></a><a href="#l223">223</a><td>    script) {<tr><td><a id="l224"></a><a href="#l224">224</a><td>  this.privateDoNotAccessOrElseSafeScriptWrappedValue_ = script;<tr><td><a id="l225"></a><a href="#l225">225</a><td>  return this;<tr><td><a id="l226"></a><a href="#l226">226</a><td>};<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>/**<tr><td><a id="l230"></a><a href="#l230">230</a><td> * A SafeScript instance corresponding to the empty string.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @const {!goog.html.SafeScript}<tr><td><a id="l232"></a><a href="#l232">232</a><td> */<tr><td><a id="l233"></a><a href="#l233">233</a><td>goog.html.SafeScript.EMPTY =<tr><td><a id="l234"></a><a href="#l234">234</a><td>    goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(&#39;&#39;);</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/html/safestyle.js.src.html b/docs/source/lib/goog/html/safestyle.js.src.html
new file mode 100644
index 0000000..8fcf043
--- /dev/null
+++ b/docs/source/lib/goog/html/safestyle.js.src.html
@@ -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>safestyle.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/html/safestyle.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2014 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview The SafeStyle type and its builders.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * TODO(xtof): Link to document stating type contract.<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.html.SafeStyle&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string.TypedString&#39;);<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>/**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * A string-like object which represents a sequence of CSS declarations<tr><td><a id="l33"></a><a href="#l33">33</a><td> * ({@code propertyName1: propertyvalue1; propertyName2: propertyValue2; ...})<tr><td><a id="l34"></a><a href="#l34">34</a><td> * and that carries the security type contract that its value, as a string,<tr><td><a id="l35"></a><a href="#l35">35</a><td> * will not cause untrusted script execution (XSS) when evaluated as CSS in a<tr><td><a id="l36"></a><a href="#l36">36</a><td> * browser.<tr><td><a id="l37"></a><a href="#l37">37</a><td> *<tr><td><a id="l38"></a><a href="#l38">38</a><td> * Instances of this type must be created via the factory methods<tr><td><a id="l39"></a><a href="#l39">39</a><td> * ({@code goog.html.SafeStyle.create} or<tr><td><a id="l40"></a><a href="#l40">40</a><td> * {@code goog.html.SafeStyle.fromConstant}) and not by invoking its<tr><td><a id="l41"></a><a href="#l41">41</a><td> * constructor. The constructor intentionally takes no parameters and the type<tr><td><a id="l42"></a><a href="#l42">42</a><td> * is immutable; hence only a default instance corresponding to the empty string<tr><td><a id="l43"></a><a href="#l43">43</a><td> * can be obtained via constructor invocation.<tr><td><a id="l44"></a><a href="#l44">44</a><td> *<tr><td><a id="l45"></a><a href="#l45">45</a><td> * A SafeStyle&#39;s string representation ({@link #getTypedStringValue()}) can<tr><td><a id="l46"></a><a href="#l46">46</a><td> * safely:<tr><td><a id="l47"></a><a href="#l47">47</a><td> * &lt;ul&gt;<tr><td><a id="l48"></a><a href="#l48">48</a><td> *   &lt;li&gt;Be interpolated as the entire content of a *quoted* HTML style<tr><td><a id="l49"></a><a href="#l49">49</a><td> *       attribute, or before already existing properties. The SafeStyle string<tr><td><a id="l50"></a><a href="#l50">50</a><td> *       *must be HTML-attribute-escaped* (where &quot; and &#39; are escaped) before<tr><td><a id="l51"></a><a href="#l51">51</a><td> *       interpolation.<tr><td><a id="l52"></a><a href="#l52">52</a><td> *   &lt;li&gt;Be interpolated as the entire content of a {}-wrapped block within a<tr><td><a id="l53"></a><a href="#l53">53</a><td> *       stylesheet, or before already existing properties. The SafeStyle string<tr><td><a id="l54"></a><a href="#l54">54</a><td> *       should not be escaped before interpolation. SafeStyle&#39;s contract also<tr><td><a id="l55"></a><a href="#l55">55</a><td> *       guarantees that the string will not be able to introduce new properties<tr><td><a id="l56"></a><a href="#l56">56</a><td> *       or elide existing ones.<tr><td><a id="l57"></a><a href="#l57">57</a><td> *   &lt;li&gt;Be assigned to the style property of a DOM node. The SafeStyle string<tr><td><a id="l58"></a><a href="#l58">58</a><td> *       should not be escaped before being assigned to the property.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * &lt;/ul&gt;<tr><td><a id="l60"></a><a href="#l60">60</a><td> *<tr><td><a id="l61"></a><a href="#l61">61</a><td> * A SafeStyle may never contain literal angle brackets. Otherwise, it could<tr><td><a id="l62"></a><a href="#l62">62</a><td> * be unsafe to place a SafeStyle into a &amp;lt;style&amp;gt; tag (where it can&#39;t<tr><td><a id="l63"></a><a href="#l63">63</a><td> * be HTML escaped). For example, if the SafeStyle containing<tr><td><a id="l64"></a><a href="#l64">64</a><td> * &quot;{@code font: &#39;foo &amp;lt;style/&amp;gt;&amp;lt;script&amp;gt;evil&amp;lt;/script&amp;gt;&#39;}&quot; were<tr><td><a id="l65"></a><a href="#l65">65</a><td> * interpolated within a &amp;lt;style&amp;gt; tag, this would then break out of the<tr><td><a id="l66"></a><a href="#l66">66</a><td> * style context into HTML.<tr><td><a id="l67"></a><a href="#l67">67</a><td> *<tr><td><a id="l68"></a><a href="#l68">68</a><td> * A SafeStyle may contain literal single or double quotes, and as such the<tr><td><a id="l69"></a><a href="#l69">69</a><td> * entire style string must be escaped when used in a style attribute (if<tr><td><a id="l70"></a><a href="#l70">70</a><td> * this were not the case, the string could contain a matching quote that<tr><td><a id="l71"></a><a href="#l71">71</a><td> * would escape from the style attribute).<tr><td><a id="l72"></a><a href="#l72">72</a><td> *<tr><td><a id="l73"></a><a href="#l73">73</a><td> * Values of this type must be composable, i.e. for any two values<tr><td><a id="l74"></a><a href="#l74">74</a><td> * {@code style1} and {@code style2} of this type,<tr><td><a id="l75"></a><a href="#l75">75</a><td> * {@code goog.html.SafeStyle.unwrap(style1) +<tr><td><a id="l76"></a><a href="#l76">76</a><td> * goog.html.SafeStyle.unwrap(style2)} must itself be a value that satisfies<tr><td><a id="l77"></a><a href="#l77">77</a><td> * the SafeStyle type constraint. This requirement implies that for any value<tr><td><a id="l78"></a><a href="#l78">78</a><td> * {@code style} of this type, {@code goog.html.SafeStyle.unwrap(style)} must<tr><td><a id="l79"></a><a href="#l79">79</a><td> * not end in a &quot;property value&quot; or &quot;property name&quot; context. For example,<tr><td><a id="l80"></a><a href="#l80">80</a><td> * a value of {@code background:url(&quot;} or {@code font-} would not satisfy the<tr><td><a id="l81"></a><a href="#l81">81</a><td> * SafeStyle contract. This is because concatenating such strings with a<tr><td><a id="l82"></a><a href="#l82">82</a><td> * second value that itself does not contain unsafe CSS can result in an<tr><td><a id="l83"></a><a href="#l83">83</a><td> * overall string that does. For example, if {@code javascript:evil())&quot;} is<tr><td><a id="l84"></a><a href="#l84">84</a><td> * appended to {@code background:url(&quot;}, the resulting string may result in<tr><td><a id="l85"></a><a href="#l85">85</a><td> * the execution of a malicious script.<tr><td><a id="l86"></a><a href="#l86">86</a><td> *<tr><td><a id="l87"></a><a href="#l87">87</a><td> * TODO(user): Consider whether we should implement UTF-8 interchange<tr><td><a id="l88"></a><a href="#l88">88</a><td> * validity checks and blacklisting of newlines (including Unicode ones) and<tr><td><a id="l89"></a><a href="#l89">89</a><td> * other whitespace characters (\t, \f). Document here if so and also update<tr><td><a id="l90"></a><a href="#l90">90</a><td> * SafeStyle.fromConstant().<tr><td><a id="l91"></a><a href="#l91">91</a><td> *<tr><td><a id="l92"></a><a href="#l92">92</a><td> * The following example values comply with this type&#39;s contract:<tr><td><a id="l93"></a><a href="#l93">93</a><td> * &lt;ul&gt;<tr><td><a id="l94"></a><a href="#l94">94</a><td> *   &lt;li&gt;&lt;pre&gt;width: 1em;&lt;/pre&gt;<tr><td><a id="l95"></a><a href="#l95">95</a><td> *   &lt;li&gt;&lt;pre&gt;height:1em;&lt;/pre&gt;<tr><td><a id="l96"></a><a href="#l96">96</a><td> *   &lt;li&gt;&lt;pre&gt;width: 1em;height: 1em;&lt;/pre&gt;<tr><td><a id="l97"></a><a href="#l97">97</a><td> *   &lt;li&gt;&lt;pre&gt;background:url(&#39;http://url&#39;);&lt;/pre&gt;<tr><td><a id="l98"></a><a href="#l98">98</a><td> * &lt;/ul&gt;<tr><td><a id="l99"></a><a href="#l99">99</a><td> * In addition, the empty string is safe for use in a CSS attribute.<tr><td><a id="l100"></a><a href="#l100">100</a><td> *<tr><td><a id="l101"></a><a href="#l101">101</a><td> * The following example values do NOT comply with this type&#39;s contract:<tr><td><a id="l102"></a><a href="#l102">102</a><td> * &lt;ul&gt;<tr><td><a id="l103"></a><a href="#l103">103</a><td> *   &lt;li&gt;&lt;pre&gt;background: red&lt;/pre&gt; (missing a trailing semi-colon)<tr><td><a id="l104"></a><a href="#l104">104</a><td> *   &lt;li&gt;&lt;pre&gt;background:&lt;/pre&gt; (missing a value and a trailing semi-colon)<tr><td><a id="l105"></a><a href="#l105">105</a><td> *   &lt;li&gt;&lt;pre&gt;1em&lt;/pre&gt; (missing an attribute name, which provides context for<tr><td><a id="l106"></a><a href="#l106">106</a><td> *       the value)<tr><td><a id="l107"></a><a href="#l107">107</a><td> * &lt;/ul&gt;<tr><td><a id="l108"></a><a href="#l108">108</a><td> *<tr><td><a id="l109"></a><a href="#l109">109</a><td> * @see goog.html.SafeStyle#create<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @see goog.html.SafeStyle#fromConstant<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @see http://www.w3.org/TR/css3-syntax/<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @constructor<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @final<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @struct<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @implements {goog.string.TypedString}<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.html.SafeStyle = function() {<tr><td><a id="l118"></a><a href="#l118">118</a><td>  /**<tr><td><a id="l119"></a><a href="#l119">119</a><td>   * The contained value of this SafeStyle.  The field has a purposely<tr><td><a id="l120"></a><a href="#l120">120</a><td>   * ugly name to make (non-compiled) code that attempts to directly access this<tr><td><a id="l121"></a><a href="#l121">121</a><td>   * field stand out.<tr><td><a id="l122"></a><a href="#l122">122</a><td>   * @private {string}<tr><td><a id="l123"></a><a href="#l123">123</a><td>   */<tr><td><a id="l124"></a><a href="#l124">124</a><td>  this.privateDoNotAccessOrElseSafeStyleWrappedValue_ = &#39;&#39;;<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>   * A type marker used to implement additional run-time type checking.<tr><td><a id="l128"></a><a href="#l128">128</a><td>   * @see goog.html.SafeStyle#unwrap<tr><td><a id="l129"></a><a href="#l129">129</a><td>   * @const<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>  this.SAFE_STYLE_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =<tr><td><a id="l133"></a><a href="#l133">133</a><td>      goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;<tr><td><a id="l134"></a><a href="#l134">134</a><td>};<tr><td><a id="l135"></a><a href="#l135">135</a><td><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> * @override<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @const<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.html.SafeStyle.prototype.implementsGoogStringTypedString = true;<tr><td><a id="l142"></a><a href="#l142">142</a><td><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> * Type marker for the SafeStyle type, used to implement additional<tr><td><a id="l146"></a><a href="#l146">146</a><td> * run-time type checking.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @const {!Object}<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @private<tr><td><a id="l149"></a><a href="#l149">149</a><td> */<tr><td><a id="l150"></a><a href="#l150">150</a><td>goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * Creates a SafeStyle object from a compile-time constant string.<tr><td><a id="l155"></a><a href="#l155">155</a><td> *<tr><td><a id="l156"></a><a href="#l156">156</a><td> * {@code style} should be in the format<tr><td><a id="l157"></a><a href="#l157">157</a><td> * {@code name: value; [name: value; ...]} and must not have any &lt; or &gt;<tr><td><a id="l158"></a><a href="#l158">158</a><td> * characters in it. This is so that SafeStyle&#39;s contract is preserved,<tr><td><a id="l159"></a><a href="#l159">159</a><td> * allowing the SafeStyle to correctly be interpreted as a sequence of CSS<tr><td><a id="l160"></a><a href="#l160">160</a><td> * declarations and without affecting the syntactic structure of any<tr><td><a id="l161"></a><a href="#l161">161</a><td> * surrounding CSS and HTML.<tr><td><a id="l162"></a><a href="#l162">162</a><td> *<tr><td><a id="l163"></a><a href="#l163">163</a><td> * This method performs basic sanity checks on the format of {@code style}<tr><td><a id="l164"></a><a href="#l164">164</a><td> * but does not constrain the format of {@code name} and {@code value}, except<tr><td><a id="l165"></a><a href="#l165">165</a><td> * for disallowing tag characters.<tr><td><a id="l166"></a><a href="#l166">166</a><td> *<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {!goog.string.Const} style A compile-time-constant string from which<tr><td><a id="l168"></a><a href="#l168">168</a><td> *     to create a SafeStyle.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @return {!goog.html.SafeStyle} A SafeStyle object initialized to<tr><td><a id="l170"></a><a href="#l170">170</a><td> *     {@code style}.<tr><td><a id="l171"></a><a href="#l171">171</a><td> */<tr><td><a id="l172"></a><a href="#l172">172</a><td>goog.html.SafeStyle.fromConstant = function(style) {<tr><td><a id="l173"></a><a href="#l173">173</a><td>  var styleString = goog.string.Const.unwrap(style);<tr><td><a id="l174"></a><a href="#l174">174</a><td>  if (styleString.length === 0) {<tr><td><a id="l175"></a><a href="#l175">175</a><td>    return goog.html.SafeStyle.EMPTY;<tr><td><a id="l176"></a><a href="#l176">176</a><td>  }<tr><td><a id="l177"></a><a href="#l177">177</a><td>  goog.html.SafeStyle.checkStyle_(styleString);<tr><td><a id="l178"></a><a href="#l178">178</a><td>  goog.asserts.assert(goog.string.endsWith(styleString, &#39;;&#39;),<tr><td><a id="l179"></a><a href="#l179">179</a><td>      &#39;Last character of style string is not \&#39;;\&#39;: &#39; + styleString);<tr><td><a id="l180"></a><a href="#l180">180</a><td>  goog.asserts.assert(goog.string.contains(styleString, &#39;:&#39;),<tr><td><a id="l181"></a><a href="#l181">181</a><td>      &#39;Style string must contain at least one \&#39;:\&#39;, to &#39; +<tr><td><a id="l182"></a><a href="#l182">182</a><td>      &#39;specify a &quot;name: value&quot; pair: &#39; + styleString);<tr><td><a id="l183"></a><a href="#l183">183</a><td>  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l184"></a><a href="#l184">184</a><td>      styleString);<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> * Checks if the style definition is valid.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @param {string} style<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @private<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>goog.html.SafeStyle.checkStyle_ = function(style) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>  goog.asserts.assert(!/[&lt;&gt;]/.test(style),<tr><td><a id="l195"></a><a href="#l195">195</a><td>      &#39;Forbidden characters in style string: &#39; + style);<tr><td><a id="l196"></a><a href="#l196">196</a><td>};<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>/**<tr><td><a id="l200"></a><a href="#l200">200</a><td> * Returns this SafeStyle&#39;s value as a string.<tr><td><a id="l201"></a><a href="#l201">201</a><td> *<tr><td><a id="l202"></a><a href="#l202">202</a><td> * IMPORTANT: In code where it is security relevant that an object&#39;s type is<tr><td><a id="l203"></a><a href="#l203">203</a><td> * indeed {@code SafeStyle}, use {@code goog.html.SafeStyle.unwrap} instead of<tr><td><a id="l204"></a><a href="#l204">204</a><td> * this method. If in doubt, assume that it&#39;s security relevant. In particular,<tr><td><a id="l205"></a><a href="#l205">205</a><td> * note that goog.html functions which return a goog.html type do not guarantee<tr><td><a id="l206"></a><a href="#l206">206</a><td> * the returned instance is of the right type. For example:<tr><td><a id="l207"></a><a href="#l207">207</a><td> *<tr><td><a id="l208"></a><a href="#l208">208</a><td> * &lt;pre&gt;<tr><td><a id="l209"></a><a href="#l209">209</a><td> * var fakeSafeHtml = new String(&#39;fake&#39;);<tr><td><a id="l210"></a><a href="#l210">210</a><td> * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;<tr><td><a id="l211"></a><a href="#l211">211</a><td> * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);<tr><td><a id="l212"></a><a href="#l212">212</a><td> * // newSafeHtml is just an alias for fakeSafeHtml, it&#39;s passed through by<tr><td><a id="l213"></a><a href="#l213">213</a><td> * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml<tr><td><a id="l214"></a><a href="#l214">214</a><td> * // instanceof goog.html.SafeHtml.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * &lt;/pre&gt;<tr><td><a id="l216"></a><a href="#l216">216</a><td> *<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @see goog.html.SafeStyle#unwrap<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @override<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>goog.html.SafeStyle.prototype.getTypedStringValue = function() {<tr><td><a id="l221"></a><a href="#l221">221</a><td>  return this.privateDoNotAccessOrElseSafeStyleWrappedValue_;<tr><td><a id="l222"></a><a href="#l222">222</a><td>};<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td>if (goog.DEBUG) {<tr><td><a id="l226"></a><a href="#l226">226</a><td>  /**<tr><td><a id="l227"></a><a href="#l227">227</a><td>   * Returns a debug string-representation of this value.<tr><td><a id="l228"></a><a href="#l228">228</a><td>   *<tr><td><a id="l229"></a><a href="#l229">229</a><td>   * To obtain the actual string value wrapped in a SafeStyle, use<tr><td><a id="l230"></a><a href="#l230">230</a><td>   * {@code goog.html.SafeStyle.unwrap}.<tr><td><a id="l231"></a><a href="#l231">231</a><td>   *<tr><td><a id="l232"></a><a href="#l232">232</a><td>   * @see goog.html.SafeStyle#unwrap<tr><td><a id="l233"></a><a href="#l233">233</a><td>   * @override<tr><td><a id="l234"></a><a href="#l234">234</a><td>   */<tr><td><a id="l235"></a><a href="#l235">235</a><td>  goog.html.SafeStyle.prototype.toString = function() {<tr><td><a id="l236"></a><a href="#l236">236</a><td>    return &#39;SafeStyle{&#39; +<tr><td><a id="l237"></a><a href="#l237">237</a><td>        this.privateDoNotAccessOrElseSafeStyleWrappedValue_ + &#39;}&#39;;<tr><td><a id="l238"></a><a href="#l238">238</a><td>  };<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><tr><td><a id="l242"></a><a href="#l242">242</a><td>/**<tr><td><a id="l243"></a><a href="#l243">243</a><td> * Performs a runtime check that the provided object is indeed a<tr><td><a id="l244"></a><a href="#l244">244</a><td> * SafeStyle object, and returns its value.<tr><td><a id="l245"></a><a href="#l245">245</a><td> *<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @param {!goog.html.SafeStyle} safeStyle The object to extract from.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @return {string} The safeStyle object&#39;s contained string, unless<tr><td><a id="l248"></a><a href="#l248">248</a><td> *     the run-time type check fails. In that case, {@code unwrap} returns an<tr><td><a id="l249"></a><a href="#l249">249</a><td> *     innocuous string, or, if assertions are enabled, throws<tr><td><a id="l250"></a><a href="#l250">250</a><td> *     {@code goog.asserts.AssertionError}.<tr><td><a id="l251"></a><a href="#l251">251</a><td> */<tr><td><a id="l252"></a><a href="#l252">252</a><td>goog.html.SafeStyle.unwrap = function(safeStyle) {<tr><td><a id="l253"></a><a href="#l253">253</a><td>  // Perform additional Run-time type-checking to ensure that<tr><td><a id="l254"></a><a href="#l254">254</a><td>  // safeStyle is indeed an instance of the expected type.  This<tr><td><a id="l255"></a><a href="#l255">255</a><td>  // provides some additional protection against security bugs due to<tr><td><a id="l256"></a><a href="#l256">256</a><td>  // application code that disables type checks.<tr><td><a id="l257"></a><a href="#l257">257</a><td>  // Specifically, the following checks are performed:<tr><td><a id="l258"></a><a href="#l258">258</a><td>  // 1. The object is an instance of the expected type.<tr><td><a id="l259"></a><a href="#l259">259</a><td>  // 2. The object is not an instance of a subclass.<tr><td><a id="l260"></a><a href="#l260">260</a><td>  // 3. The object carries a type marker for the expected type. &quot;Faking&quot; an<tr><td><a id="l261"></a><a href="#l261">261</a><td>  // object requires a reference to the type marker, which has names intended<tr><td><a id="l262"></a><a href="#l262">262</a><td>  // to stand out in code reviews.<tr><td><a id="l263"></a><a href="#l263">263</a><td>  if (safeStyle instanceof goog.html.SafeStyle &amp;&amp;<tr><td><a id="l264"></a><a href="#l264">264</a><td>      safeStyle.constructor === goog.html.SafeStyle &amp;&amp;<tr><td><a id="l265"></a><a href="#l265">265</a><td>      safeStyle.SAFE_STYLE_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===<tr><td><a id="l266"></a><a href="#l266">266</a><td>          goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {<tr><td><a id="l267"></a><a href="#l267">267</a><td>    return safeStyle.privateDoNotAccessOrElseSafeStyleWrappedValue_;<tr><td><a id="l268"></a><a href="#l268">268</a><td>  } else {<tr><td><a id="l269"></a><a href="#l269">269</a><td>    goog.asserts.fail(<tr><td><a id="l270"></a><a href="#l270">270</a><td>        &#39;expected object of type SafeStyle, got \&#39;&#39; + safeStyle + &#39;\&#39;&#39;);<tr><td><a id="l271"></a><a href="#l271">271</a><td>    return &#39;type_error:SafeStyle&#39;;<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>/**<tr><td><a id="l277"></a><a href="#l277">277</a><td> * Package-internal utility method to create SafeStyle instances.<tr><td><a id="l278"></a><a href="#l278">278</a><td> *<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {string} style The string to initialize the SafeStyle object with.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @return {!goog.html.SafeStyle} The initialized SafeStyle object.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @package<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.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse =<tr><td><a id="l284"></a><a href="#l284">284</a><td>    function(style) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>  return new goog.html.SafeStyle().initSecurityPrivateDoNotAccessOrElse_(style);<tr><td><a id="l286"></a><a href="#l286">286</a><td>};<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>/**<tr><td><a id="l290"></a><a href="#l290">290</a><td> * Called from createSafeStyleSecurityPrivateDoNotAccessOrElse(). This<tr><td><a id="l291"></a><a href="#l291">291</a><td> * method exists only so that the compiler can dead code eliminate static<tr><td><a id="l292"></a><a href="#l292">292</a><td> * fields (like EMPTY) when they&#39;re not accessed.<tr><td><a id="l293"></a><a href="#l293">293</a><td> * @param {string} style<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @return {!goog.html.SafeStyle}<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @private<tr><td><a id="l296"></a><a href="#l296">296</a><td> */<tr><td><a id="l297"></a><a href="#l297">297</a><td>goog.html.SafeStyle.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(<tr><td><a id="l298"></a><a href="#l298">298</a><td>    style) {<tr><td><a id="l299"></a><a href="#l299">299</a><td>  this.privateDoNotAccessOrElseSafeStyleWrappedValue_ = style;<tr><td><a id="l300"></a><a href="#l300">300</a><td>  return this;<tr><td><a id="l301"></a><a href="#l301">301</a><td>};<tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td><tr><td><a id="l304"></a><a href="#l304">304</a><td>/**<tr><td><a id="l305"></a><a href="#l305">305</a><td> * A SafeStyle instance corresponding to the empty string.<tr><td><a id="l306"></a><a href="#l306">306</a><td> * @const {!goog.html.SafeStyle}<tr><td><a id="l307"></a><a href="#l307">307</a><td> */<tr><td><a id="l308"></a><a href="#l308">308</a><td>goog.html.SafeStyle.EMPTY =<tr><td><a id="l309"></a><a href="#l309">309</a><td>    goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(&#39;&#39;);<tr><td><a id="l310"></a><a href="#l310">310</a><td><tr><td><a id="l311"></a><a href="#l311">311</a><td><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * The innocuous string generated by goog.html.SafeUrl.create when passed<tr><td><a id="l314"></a><a href="#l314">314</a><td> * an unsafe value.<tr><td><a id="l315"></a><a href="#l315">315</a><td> * @const {string}<tr><td><a id="l316"></a><a href="#l316">316</a><td> */<tr><td><a id="l317"></a><a href="#l317">317</a><td>goog.html.SafeStyle.INNOCUOUS_STRING = &#39;zClosurez&#39;;<tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>/**<tr><td><a id="l321"></a><a href="#l321">321</a><td> * Mapping of property names to their values.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @typedef {!Object&lt;string, goog.string.Const|string&gt;}<tr><td><a id="l323"></a><a href="#l323">323</a><td> */<tr><td><a id="l324"></a><a href="#l324">324</a><td>goog.html.SafeStyle.PropertyMap;<tr><td><a id="l325"></a><a href="#l325">325</a><td><tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td>/**<tr><td><a id="l328"></a><a href="#l328">328</a><td> * Creates a new SafeStyle object from the properties specified in the map.<tr><td><a id="l329"></a><a href="#l329">329</a><td> * @param {goog.html.SafeStyle.PropertyMap} map Mapping of property names to<tr><td><a id="l330"></a><a href="#l330">330</a><td> *     their values, for example {&#39;margin&#39;: &#39;1px&#39;}. Names must consist of<tr><td><a id="l331"></a><a href="#l331">331</a><td> *     [-_a-zA-Z0-9]. Values might be strings consisting of<tr><td><a id="l332"></a><a href="#l332">332</a><td> *     [-,.&#39;&quot;%_!# a-zA-Z0-9], where &quot; and &#39; must be properly balanced.<tr><td><a id="l333"></a><a href="#l333">333</a><td> *     Other values must be wrapped in goog.string.Const. Null value causes<tr><td><a id="l334"></a><a href="#l334">334</a><td> *     skipping the property.<tr><td><a id="l335"></a><a href="#l335">335</a><td> * @return {!goog.html.SafeStyle}<tr><td><a id="l336"></a><a href="#l336">336</a><td> * @throws {Error} If invalid name is provided.<tr><td><a id="l337"></a><a href="#l337">337</a><td> * @throws {goog.asserts.AssertionError} If invalid value is provided. With<tr><td><a id="l338"></a><a href="#l338">338</a><td> *     disabled assertions, invalid value is replaced by<tr><td><a id="l339"></a><a href="#l339">339</a><td> *     goog.html.SafeStyle.INNOCUOUS_STRING.<tr><td><a id="l340"></a><a href="#l340">340</a><td> */<tr><td><a id="l341"></a><a href="#l341">341</a><td>goog.html.SafeStyle.create = function(map) {<tr><td><a id="l342"></a><a href="#l342">342</a><td>  var style = &#39;&#39;;<tr><td><a id="l343"></a><a href="#l343">343</a><td>  for (var name in map) {<tr><td><a id="l344"></a><a href="#l344">344</a><td>    if (!/^[-_a-zA-Z0-9]+$/.test(name)) {<tr><td><a id="l345"></a><a href="#l345">345</a><td>      throw Error(&#39;Name allows only [-_a-zA-Z0-9], got: &#39; + name);<tr><td><a id="l346"></a><a href="#l346">346</a><td>    }<tr><td><a id="l347"></a><a href="#l347">347</a><td>    var value = map[name];<tr><td><a id="l348"></a><a href="#l348">348</a><td>    if (value == null) {<tr><td><a id="l349"></a><a href="#l349">349</a><td>      continue;<tr><td><a id="l350"></a><a href="#l350">350</a><td>    }<tr><td><a id="l351"></a><a href="#l351">351</a><td>    if (value instanceof goog.string.Const) {<tr><td><a id="l352"></a><a href="#l352">352</a><td>      value = goog.string.Const.unwrap(value);<tr><td><a id="l353"></a><a href="#l353">353</a><td>      // These characters can be used to change context and we don&#39;t want that<tr><td><a id="l354"></a><a href="#l354">354</a><td>      // even with const values.<tr><td><a id="l355"></a><a href="#l355">355</a><td>      goog.asserts.assert(!/[{;}]/.test(value), &#39;Value does not allow [{;}].&#39;);<tr><td><a id="l356"></a><a href="#l356">356</a><td>    } else if (!goog.html.SafeStyle.VALUE_RE_.test(value)) {<tr><td><a id="l357"></a><a href="#l357">357</a><td>      goog.asserts.fail(<tr><td><a id="l358"></a><a href="#l358">358</a><td>          &#39;String value allows only [-,.&quot;\&#39;%_!# a-zA-Z0-9], got: &#39; + value);<tr><td><a id="l359"></a><a href="#l359">359</a><td>      value = goog.html.SafeStyle.INNOCUOUS_STRING;<tr><td><a id="l360"></a><a href="#l360">360</a><td>    } else if (!goog.html.SafeStyle.hasBalancedQuotes_(value)) {<tr><td><a id="l361"></a><a href="#l361">361</a><td>      goog.asserts.fail(&#39;String value requires balanced quotes, got: &#39; + value);<tr><td><a id="l362"></a><a href="#l362">362</a><td>      value = goog.html.SafeStyle.INNOCUOUS_STRING;<tr><td><a id="l363"></a><a href="#l363">363</a><td>    }<tr><td><a id="l364"></a><a href="#l364">364</a><td>    style += name + &#39;:&#39; + value + &#39;;&#39;;<tr><td><a id="l365"></a><a href="#l365">365</a><td>  }<tr><td><a id="l366"></a><a href="#l366">366</a><td>  if (!style) {<tr><td><a id="l367"></a><a href="#l367">367</a><td>    return goog.html.SafeStyle.EMPTY;<tr><td><a id="l368"></a><a href="#l368">368</a><td>  }<tr><td><a id="l369"></a><a href="#l369">369</a><td>  goog.html.SafeStyle.checkStyle_(style);<tr><td><a id="l370"></a><a href="#l370">370</a><td>  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l371"></a><a href="#l371">371</a><td>      style);<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> * Checks that quotes (&quot; and &#39;) are properly balanced inside a string. Assumes<tr><td><a id="l377"></a><a href="#l377">377</a><td> * that neither escape (\) nor any other character that could result in<tr><td><a id="l378"></a><a href="#l378">378</a><td> * breaking out of a string parsing context are allowed;<tr><td><a id="l379"></a><a href="#l379">379</a><td> * see http://www.w3.org/TR/css3-syntax/#string-token-diagram.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @param {string} value Untrusted CSS property value.<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @return {boolean} True if property value is safe with respect to quote<tr><td><a id="l382"></a><a href="#l382">382</a><td> *     balancedness.<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @private<tr><td><a id="l384"></a><a href="#l384">384</a><td> */<tr><td><a id="l385"></a><a href="#l385">385</a><td>goog.html.SafeStyle.hasBalancedQuotes_ = function(value) {<tr><td><a id="l386"></a><a href="#l386">386</a><td>  var outsideSingle = true;<tr><td><a id="l387"></a><a href="#l387">387</a><td>  var outsideDouble = true;<tr><td><a id="l388"></a><a href="#l388">388</a><td>  for (var i = 0; i &lt; value.length; i++) {<tr><td><a id="l389"></a><a href="#l389">389</a><td>    var c = value.charAt(i);<tr><td><a id="l390"></a><a href="#l390">390</a><td>    if (c == &quot;&#39;&quot; &amp;&amp; outsideDouble) {<tr><td><a id="l391"></a><a href="#l391">391</a><td>      outsideSingle = !outsideSingle;<tr><td><a id="l392"></a><a href="#l392">392</a><td>    } else if (c == &#39;&quot;&#39; &amp;&amp; outsideSingle) {<tr><td><a id="l393"></a><a href="#l393">393</a><td>      outsideDouble = !outsideDouble;<tr><td><a id="l394"></a><a href="#l394">394</a><td>    }<tr><td><a id="l395"></a><a href="#l395">395</a><td>  }<tr><td><a id="l396"></a><a href="#l396">396</a><td>  return outsideSingle &amp;&amp; outsideDouble;<tr><td><a id="l397"></a><a href="#l397">397</a><td>};<tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td><tr><td><a id="l400"></a><a href="#l400">400</a><td>// Keep in sync with the error string in create().<tr><td><a id="l401"></a><a href="#l401">401</a><td>/**<tr><td><a id="l402"></a><a href="#l402">402</a><td> * Regular expression for safe values.<tr><td><a id="l403"></a><a href="#l403">403</a><td> *<tr><td><a id="l404"></a><a href="#l404">404</a><td> * Quotes (&quot; and &#39;) are allowed, but a check must be done elsewhere to ensure<tr><td><a id="l405"></a><a href="#l405">405</a><td> * they&#39;re balanced.<tr><td><a id="l406"></a><a href="#l406">406</a><td> *<tr><td><a id="l407"></a><a href="#l407">407</a><td> * &#39;,&#39; allows multiple values to be assigned to the same property<tr><td><a id="l408"></a><a href="#l408">408</a><td> * (e.g. background-attachment or font-family) and hence could allow<tr><td><a id="l409"></a><a href="#l409">409</a><td> * multiple values to get injected, but that should pose no risk of XSS.<tr><td><a id="l410"></a><a href="#l410">410</a><td> * @const {!RegExp}<tr><td><a id="l411"></a><a href="#l411">411</a><td> * @private<tr><td><a id="l412"></a><a href="#l412">412</a><td> */<tr><td><a id="l413"></a><a href="#l413">413</a><td>goog.html.SafeStyle.VALUE_RE_ = /^[-,.&quot;&#39;%_!# a-zA-Z0-9]+$/;<tr><td><a id="l414"></a><a href="#l414">414</a><td><tr><td><a id="l415"></a><a href="#l415">415</a><td><tr><td><a id="l416"></a><a href="#l416">416</a><td>/**<tr><td><a id="l417"></a><a href="#l417">417</a><td> * Creates a new SafeStyle object by concatenating the values.<tr><td><a id="l418"></a><a href="#l418">418</a><td> * @param {...(!goog.html.SafeStyle|!Array&lt;!goog.html.SafeStyle&gt;)} var_args<tr><td><a id="l419"></a><a href="#l419">419</a><td> *     SafeStyles to concatenate.<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @return {!goog.html.SafeStyle}<tr><td><a id="l421"></a><a href="#l421">421</a><td> */<tr><td><a id="l422"></a><a href="#l422">422</a><td>goog.html.SafeStyle.concat = function(var_args) {<tr><td><a id="l423"></a><a href="#l423">423</a><td>  var style = &#39;&#39;;<tr><td><a id="l424"></a><a href="#l424">424</a><td><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 {!goog.html.SafeStyle|!Array&lt;!goog.html.SafeStyle&gt;} argument<tr><td><a id="l427"></a><a href="#l427">427</a><td>   */<tr><td><a id="l428"></a><a href="#l428">428</a><td>  var addArgument = function(argument) {<tr><td><a id="l429"></a><a href="#l429">429</a><td>    if (goog.isArray(argument)) {<tr><td><a id="l430"></a><a href="#l430">430</a><td>      goog.array.forEach(argument, addArgument);<tr><td><a id="l431"></a><a href="#l431">431</a><td>    } else {<tr><td><a id="l432"></a><a href="#l432">432</a><td>      style += goog.html.SafeStyle.unwrap(argument);<tr><td><a id="l433"></a><a href="#l433">433</a><td>    }<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>  goog.array.forEach(arguments, addArgument);<tr><td><a id="l437"></a><a href="#l437">437</a><td>  if (!style) {<tr><td><a id="l438"></a><a href="#l438">438</a><td>    return goog.html.SafeStyle.EMPTY;<tr><td><a id="l439"></a><a href="#l439">439</a><td>  }<tr><td><a id="l440"></a><a href="#l440">440</a><td>  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l441"></a><a href="#l441">441</a><td>      style);<tr><td><a id="l442"></a><a href="#l442">442</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/html/safestylesheet.js.src.html b/docs/source/lib/goog/html/safestylesheet.js.src.html
new file mode 100644
index 0000000..ebf132e
--- /dev/null
+++ b/docs/source/lib/goog/html/safestylesheet.js.src.html
@@ -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>safestylesheet.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/html/safestylesheet.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2014 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview The SafeStyleSheet type and its builders.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * TODO(xtof): Link to document stating type contract.<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.html.SafeStyleSheet&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string.TypedString&#39;);<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>/**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * A string-like object which represents a CSS style sheet and that carries the<tr><td><a id="l33"></a><a href="#l33">33</a><td> * security type contract that its value, as a string, will not cause untrusted<tr><td><a id="l34"></a><a href="#l34">34</a><td> * script execution (XSS) when evaluated as CSS in a browser.<tr><td><a id="l35"></a><a href="#l35">35</a><td> *<tr><td><a id="l36"></a><a href="#l36">36</a><td> * Instances of this type must be created via the factory method<tr><td><a id="l37"></a><a href="#l37">37</a><td> * {@code goog.html.SafeStyleSheet.fromConstant} and not by invoking its<tr><td><a id="l38"></a><a href="#l38">38</a><td> * constructor. The constructor intentionally takes no parameters and the type<tr><td><a id="l39"></a><a href="#l39">39</a><td> * is immutable; hence only a default instance corresponding to the empty string<tr><td><a id="l40"></a><a href="#l40">40</a><td> * can be obtained via constructor invocation.<tr><td><a id="l41"></a><a href="#l41">41</a><td> *<tr><td><a id="l42"></a><a href="#l42">42</a><td> * A SafeStyleSheet&#39;s string representation can safely be interpolated as the<tr><td><a id="l43"></a><a href="#l43">43</a><td> * content of a style element within HTML. The SafeStyleSheet string should<tr><td><a id="l44"></a><a href="#l44">44</a><td> * not be escaped before interpolation.<tr><td><a id="l45"></a><a href="#l45">45</a><td> *<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Values of this type must be composable, i.e. for any two values<tr><td><a id="l47"></a><a href="#l47">47</a><td> * {@code styleSheet1} and {@code styleSheet2} of this type,<tr><td><a id="l48"></a><a href="#l48">48</a><td> * {@code goog.html.SafeStyleSheet.unwrap(styleSheet1) +<tr><td><a id="l49"></a><a href="#l49">49</a><td> * goog.html.SafeStyleSheet.unwrap(styleSheet2)} must itself be a value that<tr><td><a id="l50"></a><a href="#l50">50</a><td> * satisfies the SafeStyleSheet type constraint. This requirement implies that<tr><td><a id="l51"></a><a href="#l51">51</a><td> * for any value {@code styleSheet} of this type,<tr><td><a id="l52"></a><a href="#l52">52</a><td> * {@code goog.html.SafeStyleSheet.unwrap(styleSheet1)} must end in<tr><td><a id="l53"></a><a href="#l53">53</a><td> * &quot;beginning of rule&quot; context.<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td> * A SafeStyleSheet can be constructed via security-reviewed unchecked<tr><td><a id="l56"></a><a href="#l56">56</a><td> * conversions. In this case producers of SafeStyleSheet must ensure themselves<tr><td><a id="l57"></a><a href="#l57">57</a><td> * that the SafeStyleSheet does not contain unsafe script. Note in particular<tr><td><a id="l58"></a><a href="#l58">58</a><td> * that {@code &amp;lt;} is dangerous, even when inside CSS strings, and so should<tr><td><a id="l59"></a><a href="#l59">59</a><td> * always be forbidden or CSS-escaped in user controlled input. For example, if<tr><td><a id="l60"></a><a href="#l60">60</a><td> * {@code &amp;lt;/style&amp;gt;&amp;lt;script&amp;gt;evil&amp;lt;/script&amp;gt;&quot;} were interpolated<tr><td><a id="l61"></a><a href="#l61">61</a><td> * inside a CSS string, it would break out of the context of the original<tr><td><a id="l62"></a><a href="#l62">62</a><td> * style element and {@code evil} would execute. Also note that within an HTML<tr><td><a id="l63"></a><a href="#l63">63</a><td> * style (raw text) element, HTML character references, such as<tr><td><a id="l64"></a><a href="#l64">64</a><td> * {@code &amp;amp;lt;}, are not allowed. See<tr><td><a id="l65"></a><a href="#l65">65</a><td> * http://www.w3.org/TR/html5/scripting-1.html#restrictions-for-contents-of-script-elements<tr><td><a id="l66"></a><a href="#l66">66</a><td> * (similar considerations apply to the style element).<tr><td><a id="l67"></a><a href="#l67">67</a><td> *<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @see goog.html.SafeStyleSheet#fromConstant<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @constructor<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @final<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @struct<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @implements {goog.string.TypedString}<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td>goog.html.SafeStyleSheet = function() {<tr><td><a id="l75"></a><a href="#l75">75</a><td>  /**<tr><td><a id="l76"></a><a href="#l76">76</a><td>   * The contained value of this SafeStyleSheet.  The field has a purposely<tr><td><a id="l77"></a><a href="#l77">77</a><td>   * ugly name to make (non-compiled) code that attempts to directly access this<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * field stand out.<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * @private {string}<tr><td><a id="l80"></a><a href="#l80">80</a><td>   */<tr><td><a id="l81"></a><a href="#l81">81</a><td>  this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ = &#39;&#39;;<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>  /**<tr><td><a id="l84"></a><a href="#l84">84</a><td>   * A type marker used to implement additional run-time type checking.<tr><td><a id="l85"></a><a href="#l85">85</a><td>   * @see goog.html.SafeStyleSheet#unwrap<tr><td><a id="l86"></a><a href="#l86">86</a><td>   * @const<tr><td><a id="l87"></a><a href="#l87">87</a><td>   * @private<tr><td><a id="l88"></a><a href="#l88">88</a><td>   */<tr><td><a id="l89"></a><a href="#l89">89</a><td>  this.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =<tr><td><a id="l90"></a><a href="#l90">90</a><td>      goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;<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> * @override<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @const<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.html.SafeStyleSheet.prototype.implementsGoogStringTypedString = true;<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> * Type marker for the SafeStyleSheet type, used to implement additional<tr><td><a id="l103"></a><a href="#l103">103</a><td> * run-time type checking.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @const {!Object}<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @private<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};<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> * Creates a new SafeStyleSheet object by concatenating values.<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @param {...(!goog.html.SafeStyleSheet|!Array&lt;!goog.html.SafeStyleSheet&gt;)}<tr><td><a id="l113"></a><a href="#l113">113</a><td> *     var_args Values to concatenate.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @return {!goog.html.SafeStyleSheet}<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.html.SafeStyleSheet.concat = function(var_args) {<tr><td><a id="l117"></a><a href="#l117">117</a><td>  var result = &#39;&#39;;<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>   * @param {!goog.html.SafeStyleSheet|!Array&lt;!goog.html.SafeStyleSheet&gt;}<tr><td><a id="l121"></a><a href="#l121">121</a><td>   *     argument<tr><td><a id="l122"></a><a href="#l122">122</a><td>   */<tr><td><a id="l123"></a><a href="#l123">123</a><td>  var addArgument = function(argument) {<tr><td><a id="l124"></a><a href="#l124">124</a><td>    if (goog.isArray(argument)) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>      goog.array.forEach(argument, addArgument);<tr><td><a id="l126"></a><a href="#l126">126</a><td>    } else {<tr><td><a id="l127"></a><a href="#l127">127</a><td>      result += goog.html.SafeStyleSheet.unwrap(argument);<tr><td><a id="l128"></a><a href="#l128">128</a><td>    }<tr><td><a id="l129"></a><a href="#l129">129</a><td>  };<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>  goog.array.forEach(arguments, addArgument);<tr><td><a id="l132"></a><a href="#l132">132</a><td>  return goog.html.SafeStyleSheet<tr><td><a id="l133"></a><a href="#l133">133</a><td>      .createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(result);<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><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Creates a SafeStyleSheet object from a compile-time constant string.<tr><td><a id="l139"></a><a href="#l139">139</a><td> *<tr><td><a id="l140"></a><a href="#l140">140</a><td> * {@code styleSheet} must not have any &amp;lt; characters in it, so that<tr><td><a id="l141"></a><a href="#l141">141</a><td> * the syntactic structure of the surrounding HTML is not affected.<tr><td><a id="l142"></a><a href="#l142">142</a><td> *<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {!goog.string.Const} styleSheet A compile-time-constant string from<tr><td><a id="l144"></a><a href="#l144">144</a><td> *     which to create a SafeStyleSheet.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @return {!goog.html.SafeStyleSheet} A SafeStyleSheet object initialized to<tr><td><a id="l146"></a><a href="#l146">146</a><td> *     {@code styleSheet}.<tr><td><a id="l147"></a><a href="#l147">147</a><td> */<tr><td><a id="l148"></a><a href="#l148">148</a><td>goog.html.SafeStyleSheet.fromConstant = function(styleSheet) {<tr><td><a id="l149"></a><a href="#l149">149</a><td>  var styleSheetString = goog.string.Const.unwrap(styleSheet);<tr><td><a id="l150"></a><a href="#l150">150</a><td>  if (styleSheetString.length === 0) {<tr><td><a id="l151"></a><a href="#l151">151</a><td>    return goog.html.SafeStyleSheet.EMPTY;<tr><td><a id="l152"></a><a href="#l152">152</a><td>  }<tr><td><a id="l153"></a><a href="#l153">153</a><td>  // &gt; is a valid character in CSS selectors and there&#39;s no strict need to<tr><td><a id="l154"></a><a href="#l154">154</a><td>  // block it if we already block &lt;.<tr><td><a id="l155"></a><a href="#l155">155</a><td>  goog.asserts.assert(!goog.string.contains(styleSheetString, &#39;&lt;&#39;),<tr><td><a id="l156"></a><a href="#l156">156</a><td>      &quot;Forbidden &#39;&lt;&#39; character in style sheet string: &quot; + styleSheetString);<tr><td><a id="l157"></a><a href="#l157">157</a><td>  return goog.html.SafeStyleSheet.<tr><td><a id="l158"></a><a href="#l158">158</a><td>      createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(styleSheetString);<tr><td><a id="l159"></a><a href="#l159">159</a><td>};<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * Returns this SafeStyleSheet&#39;s value as a string.<tr><td><a id="l164"></a><a href="#l164">164</a><td> *<tr><td><a id="l165"></a><a href="#l165">165</a><td> * IMPORTANT: In code where it is security relevant that an object&#39;s type is<tr><td><a id="l166"></a><a href="#l166">166</a><td> * indeed {@code SafeStyleSheet}, use {@code goog.html.SafeStyleSheet.unwrap}<tr><td><a id="l167"></a><a href="#l167">167</a><td> * instead of this method. If in doubt, assume that it&#39;s security relevant. In<tr><td><a id="l168"></a><a href="#l168">168</a><td> * particular, note that goog.html functions which return a goog.html type do<tr><td><a id="l169"></a><a href="#l169">169</a><td> * not guarantee the returned instance is of the right type. For example:<tr><td><a id="l170"></a><a href="#l170">170</a><td> *<tr><td><a id="l171"></a><a href="#l171">171</a><td> * &lt;pre&gt;<tr><td><a id="l172"></a><a href="#l172">172</a><td> * var fakeSafeHtml = new String(&#39;fake&#39;);<tr><td><a id="l173"></a><a href="#l173">173</a><td> * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;<tr><td><a id="l174"></a><a href="#l174">174</a><td> * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);<tr><td><a id="l175"></a><a href="#l175">175</a><td> * // newSafeHtml is just an alias for fakeSafeHtml, it&#39;s passed through by<tr><td><a id="l176"></a><a href="#l176">176</a><td> * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml<tr><td><a id="l177"></a><a href="#l177">177</a><td> * // instanceof goog.html.SafeHtml.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * &lt;/pre&gt;<tr><td><a id="l179"></a><a href="#l179">179</a><td> *<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @see goog.html.SafeStyleSheet#unwrap<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> */<tr><td><a id="l183"></a><a href="#l183">183</a><td>goog.html.SafeStyleSheet.prototype.getTypedStringValue = function() {<tr><td><a id="l184"></a><a href="#l184">184</a><td>  return this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_;<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>if (goog.DEBUG) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>  /**<tr><td><a id="l190"></a><a href="#l190">190</a><td>   * Returns a debug string-representation of this value.<tr><td><a id="l191"></a><a href="#l191">191</a><td>   *<tr><td><a id="l192"></a><a href="#l192">192</a><td>   * To obtain the actual string value wrapped in a SafeStyleSheet, use<tr><td><a id="l193"></a><a href="#l193">193</a><td>   * {@code goog.html.SafeStyleSheet.unwrap}.<tr><td><a id="l194"></a><a href="#l194">194</a><td>   *<tr><td><a id="l195"></a><a href="#l195">195</a><td>   * @see goog.html.SafeStyleSheet#unwrap<tr><td><a id="l196"></a><a href="#l196">196</a><td>   * @override<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.html.SafeStyleSheet.prototype.toString = function() {<tr><td><a id="l199"></a><a href="#l199">199</a><td>    return &#39;SafeStyleSheet{&#39; +<tr><td><a id="l200"></a><a href="#l200">200</a><td>        this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ + &#39;}&#39;;<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><tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td>/**<tr><td><a id="l206"></a><a href="#l206">206</a><td> * Performs a runtime check that the provided object is indeed a<tr><td><a id="l207"></a><a href="#l207">207</a><td> * SafeStyleSheet object, and returns its value.<tr><td><a id="l208"></a><a href="#l208">208</a><td> *<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @param {!goog.html.SafeStyleSheet} safeStyleSheet The object to extract from.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @return {string} The safeStyleSheet object&#39;s contained string, unless<tr><td><a id="l211"></a><a href="#l211">211</a><td> *     the run-time type check fails. In that case, {@code unwrap} returns an<tr><td><a id="l212"></a><a href="#l212">212</a><td> *     innocuous string, or, if assertions are enabled, throws<tr><td><a id="l213"></a><a href="#l213">213</a><td> *     {@code goog.asserts.AssertionError}.<tr><td><a id="l214"></a><a href="#l214">214</a><td> */<tr><td><a id="l215"></a><a href="#l215">215</a><td>goog.html.SafeStyleSheet.unwrap = function(safeStyleSheet) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>  // Perform additional Run-time type-checking to ensure that<tr><td><a id="l217"></a><a href="#l217">217</a><td>  // safeStyleSheet is indeed an instance of the expected type.  This<tr><td><a id="l218"></a><a href="#l218">218</a><td>  // provides some additional protection against security bugs due to<tr><td><a id="l219"></a><a href="#l219">219</a><td>  // application code that disables type checks.<tr><td><a id="l220"></a><a href="#l220">220</a><td>  // Specifically, the following checks are performed:<tr><td><a id="l221"></a><a href="#l221">221</a><td>  // 1. The object is an instance of the expected type.<tr><td><a id="l222"></a><a href="#l222">222</a><td>  // 2. The object is not an instance of a subclass.<tr><td><a id="l223"></a><a href="#l223">223</a><td>  // 3. The object carries a type marker for the expected type. &quot;Faking&quot; an<tr><td><a id="l224"></a><a href="#l224">224</a><td>  // object requires a reference to the type marker, which has names intended<tr><td><a id="l225"></a><a href="#l225">225</a><td>  // to stand out in code reviews.<tr><td><a id="l226"></a><a href="#l226">226</a><td>  if (safeStyleSheet instanceof goog.html.SafeStyleSheet &amp;&amp;<tr><td><a id="l227"></a><a href="#l227">227</a><td>      safeStyleSheet.constructor === goog.html.SafeStyleSheet &amp;&amp;<tr><td><a id="l228"></a><a href="#l228">228</a><td>      safeStyleSheet.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===<tr><td><a id="l229"></a><a href="#l229">229</a><td>          goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {<tr><td><a id="l230"></a><a href="#l230">230</a><td>    return safeStyleSheet.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_;<tr><td><a id="l231"></a><a href="#l231">231</a><td>  } else {<tr><td><a id="l232"></a><a href="#l232">232</a><td>    goog.asserts.fail(<tr><td><a id="l233"></a><a href="#l233">233</a><td>        &quot;expected object of type SafeStyleSheet, got &#39;&quot; + safeStyleSheet +<tr><td><a id="l234"></a><a href="#l234">234</a><td>        &quot;&#39;&quot;);<tr><td><a id="l235"></a><a href="#l235">235</a><td>    return &#39;type_error:SafeStyleSheet&#39;;<tr><td><a id="l236"></a><a href="#l236">236</a><td>  }<tr><td><a id="l237"></a><a href="#l237">237</a><td>};<tr><td><a id="l238"></a><a href="#l238">238</a><td><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> * Package-internal utility method to create SafeStyleSheet instances.<tr><td><a id="l242"></a><a href="#l242">242</a><td> *<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {string} styleSheet The string to initialize the SafeStyleSheet<tr><td><a id="l244"></a><a href="#l244">244</a><td> *     object with.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @return {!goog.html.SafeStyleSheet} The initialized SafeStyleSheet object.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @package<tr><td><a id="l247"></a><a href="#l247">247</a><td> */<tr><td><a id="l248"></a><a href="#l248">248</a><td>goog.html.SafeStyleSheet.createSafeStyleSheetSecurityPrivateDoNotAccessOrElse =<tr><td><a id="l249"></a><a href="#l249">249</a><td>    function(styleSheet) {<tr><td><a id="l250"></a><a href="#l250">250</a><td>  return new goog.html.SafeStyleSheet().initSecurityPrivateDoNotAccessOrElse_(<tr><td><a id="l251"></a><a href="#l251">251</a><td>      styleSheet);<tr><td><a id="l252"></a><a href="#l252">252</a><td>};<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Called from createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(). This<tr><td><a id="l257"></a><a href="#l257">257</a><td> * method exists only so that the compiler can dead code eliminate static<tr><td><a id="l258"></a><a href="#l258">258</a><td> * fields (like EMPTY) when they&#39;re not accessed.<tr><td><a id="l259"></a><a href="#l259">259</a><td> * @param {string} styleSheet<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @return {!goog.html.SafeStyleSheet}<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @private<tr><td><a id="l262"></a><a href="#l262">262</a><td> */<tr><td><a id="l263"></a><a href="#l263">263</a><td>goog.html.SafeStyleSheet.prototype.initSecurityPrivateDoNotAccessOrElse_ =<tr><td><a id="l264"></a><a href="#l264">264</a><td>    function(styleSheet) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>  this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ = styleSheet;<tr><td><a id="l266"></a><a href="#l266">266</a><td>  return this;<tr><td><a id="l267"></a><a href="#l267">267</a><td>};<tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td>/**<tr><td><a id="l271"></a><a href="#l271">271</a><td> * A SafeStyleSheet instance corresponding to the empty string.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @const {!goog.html.SafeStyleSheet}<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td>goog.html.SafeStyleSheet.EMPTY =<tr><td><a id="l275"></a><a href="#l275">275</a><td>    goog.html.SafeStyleSheet.<tr><td><a id="l276"></a><a href="#l276">276</a><td>        createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(&#39;&#39;);</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/html/safeurl.js.src.html b/docs/source/lib/goog/html/safeurl.js.src.html
new file mode 100644
index 0000000..35997f0
--- /dev/null
+++ b/docs/source/lib/goog/html/safeurl.js.src.html
@@ -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>safeurl.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/html/safeurl.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview The SafeUrl type and its builders.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * TODO(xtof): Link to document stating type contract.<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.html.SafeUrl&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.fs.url&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.i18n.bidi.Dir&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.i18n.bidi.DirectionalString&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.string.TypedString&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * A string that is safe to use in URL context in DOM APIs and HTML documents.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * A SafeUrl is a string-like object that carries the security type contract<tr><td><a id="l36"></a><a href="#l36">36</a><td> * that its value as a string will not cause untrusted script execution<tr><td><a id="l37"></a><a href="#l37">37</a><td> * when evaluated as a hyperlink URL in a browser.<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * Values of this type are guaranteed to be safe to use in URL/hyperlink<tr><td><a id="l40"></a><a href="#l40">40</a><td> * contexts, such as, assignment to URL-valued DOM properties, or<tr><td><a id="l41"></a><a href="#l41">41</a><td> * interpolation into a HTML template in URL context (e.g., inside a href<tr><td><a id="l42"></a><a href="#l42">42</a><td> * attribute), in the sense that the use will not result in a<tr><td><a id="l43"></a><a href="#l43">43</a><td> * Cross-Site-Scripting vulnerability.<tr><td><a id="l44"></a><a href="#l44">44</a><td> *<tr><td><a id="l45"></a><a href="#l45">45</a><td> * Note that, as documented in {@code goog.html.SafeUrl.unwrap}, this type&#39;s<tr><td><a id="l46"></a><a href="#l46">46</a><td> * contract does not guarantee that instances are safe to interpolate into HTML<tr><td><a id="l47"></a><a href="#l47">47</a><td> * without appropriate escaping.<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * Note also that this type&#39;s contract does not imply any guarantees regarding<tr><td><a id="l50"></a><a href="#l50">50</a><td> * the resource the URL refers to.  In particular, SafeUrls are &lt;b&gt;not&lt;/b&gt;<tr><td><a id="l51"></a><a href="#l51">51</a><td> * safe to use in a context where the referred-to resource is interpreted as<tr><td><a id="l52"></a><a href="#l52">52</a><td> * trusted code, e.g., as the src of a script tag.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Instances of this type must be created via the factory methods<tr><td><a id="l55"></a><a href="#l55">55</a><td> * ({@code goog.html.SafeUrl.fromConstant}, {@code goog.html.SafeUrl.sanitize}),<tr><td><a id="l56"></a><a href="#l56">56</a><td> * etc and not by invoking its constructor.  The constructor intentionally<tr><td><a id="l57"></a><a href="#l57">57</a><td> * takes no parameters and the type is immutable; hence only a default instance<tr><td><a id="l58"></a><a href="#l58">58</a><td> * corresponding to the empty string can be obtained via constructor invocation.<tr><td><a id="l59"></a><a href="#l59">59</a><td> *<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @see goog.html.SafeUrl#fromConstant<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @see goog.html.SafeUrl#from<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @see goog.html.SafeUrl#sanitize<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @constructor<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @final<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @struct<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @implements {goog.i18n.bidi.DirectionalString}<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @implements {goog.string.TypedString}<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.html.SafeUrl = function() {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  /**<tr><td><a id="l71"></a><a href="#l71">71</a><td>   * The contained value of this SafeUrl.  The field has a purposely ugly<tr><td><a id="l72"></a><a href="#l72">72</a><td>   * name to make (non-compiled) code that attempts to directly access this<tr><td><a id="l73"></a><a href="#l73">73</a><td>   * field stand out.<tr><td><a id="l74"></a><a href="#l74">74</a><td>   * @private {string}<tr><td><a id="l75"></a><a href="#l75">75</a><td>   */<tr><td><a id="l76"></a><a href="#l76">76</a><td>  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = &#39;&#39;;<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>   * A type marker used to implement additional run-time type checking.<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * @see goog.html.SafeUrl#unwrap<tr><td><a id="l81"></a><a href="#l81">81</a><td>   * @const<tr><td><a id="l82"></a><a href="#l82">82</a><td>   * @private<tr><td><a id="l83"></a><a href="#l83">83</a><td>   */<tr><td><a id="l84"></a><a href="#l84">84</a><td>  this.SAFE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =<tr><td><a id="l85"></a><a href="#l85">85</a><td>      goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<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> * The innocuous string generated by goog.html.SafeUrl.sanitize when passed<tr><td><a id="l91"></a><a href="#l91">91</a><td> * an unsafe URL.<tr><td><a id="l92"></a><a href="#l92">92</a><td> *<tr><td><a id="l93"></a><a href="#l93">93</a><td> * about:invalid is registered in<tr><td><a id="l94"></a><a href="#l94">94</a><td> * http://www.w3.org/TR/css3-values/#about-invalid.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * http://tools.ietf.org/html/rfc6694#section-2.2.1 permits about URLs to<tr><td><a id="l96"></a><a href="#l96">96</a><td> * contain a fragment, which is not to be considered when determining if an<tr><td><a id="l97"></a><a href="#l97">97</a><td> * about URL is well-known.<tr><td><a id="l98"></a><a href="#l98">98</a><td> *<tr><td><a id="l99"></a><a href="#l99">99</a><td> * Using about:invalid seems preferable to using a fixed data URL, since<tr><td><a id="l100"></a><a href="#l100">100</a><td> * browsers might choose to not report CSP violations on it, as legitimate<tr><td><a id="l101"></a><a href="#l101">101</a><td> * CSS function calls to attr() can result in this URL being produced. It is<tr><td><a id="l102"></a><a href="#l102">102</a><td> * also a standard URL which matches exactly the semantics we need:<tr><td><a id="l103"></a><a href="#l103">103</a><td> * &quot;The about:invalid URI references a non-existent document with a generic<tr><td><a id="l104"></a><a href="#l104">104</a><td> * error condition. It can be used when a URI is necessary, but the default<tr><td><a id="l105"></a><a href="#l105">105</a><td> * value shouldn&#39;t be resolveable as any type of document&quot;.<tr><td><a id="l106"></a><a href="#l106">106</a><td> *<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @const {string}<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.html.SafeUrl.INNOCUOUS_STRING = &#39;about:invalid#zClosurez&#39;;<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> * @override<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @const<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.html.SafeUrl.prototype.implementsGoogStringTypedString = true;<tr><td><a id="l117"></a><a href="#l117">117</a><td><tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td>/**<tr><td><a id="l120"></a><a href="#l120">120</a><td> * Returns this SafeUrl&#39;s value a string.<tr><td><a id="l121"></a><a href="#l121">121</a><td> *<tr><td><a id="l122"></a><a href="#l122">122</a><td> * IMPORTANT: In code where it is security relevant that an object&#39;s type is<tr><td><a id="l123"></a><a href="#l123">123</a><td> * indeed {@code SafeUrl}, use {@code goog.html.SafeUrl.unwrap} instead of this<tr><td><a id="l124"></a><a href="#l124">124</a><td> * method. If in doubt, assume that it&#39;s security relevant. In particular, note<tr><td><a id="l125"></a><a href="#l125">125</a><td> * that goog.html functions which return a goog.html type do not guarantee that<tr><td><a id="l126"></a><a href="#l126">126</a><td> * the returned instance is of the right type. For example:<tr><td><a id="l127"></a><a href="#l127">127</a><td> *<tr><td><a id="l128"></a><a href="#l128">128</a><td> * &lt;pre&gt;<tr><td><a id="l129"></a><a href="#l129">129</a><td> * var fakeSafeHtml = new String(&#39;fake&#39;);<tr><td><a id="l130"></a><a href="#l130">130</a><td> * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;<tr><td><a id="l131"></a><a href="#l131">131</a><td> * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);<tr><td><a id="l132"></a><a href="#l132">132</a><td> * // newSafeHtml is just an alias for fakeSafeHtml, it&#39;s passed through by<tr><td><a id="l133"></a><a href="#l133">133</a><td> * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml instanceof<tr><td><a id="l134"></a><a href="#l134">134</a><td> * // goog.html.SafeHtml.<tr><td><a id="l135"></a><a href="#l135">135</a><td> * &lt;/pre&gt;<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * IMPORTANT: The guarantees of the SafeUrl type contract only extend to the<tr><td><a id="l138"></a><a href="#l138">138</a><td> * behavior of browsers when interpreting URLs. Values of SafeUrl objects MUST<tr><td><a id="l139"></a><a href="#l139">139</a><td> * be appropriately escaped before embedding in a HTML document. Note that the<tr><td><a id="l140"></a><a href="#l140">140</a><td> * required escaping is context-sensitive (e.g. a different escaping is<tr><td><a id="l141"></a><a href="#l141">141</a><td> * required for embedding a URL in a style property within a style<tr><td><a id="l142"></a><a href="#l142">142</a><td> * attribute, as opposed to embedding in a href attribute).<tr><td><a id="l143"></a><a href="#l143">143</a><td> *<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @see goog.html.SafeUrl#unwrap<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @override<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.html.SafeUrl.prototype.getTypedStringValue = function() {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  return this.privateDoNotAccessOrElseSafeHtmlWrappedValue_;<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @override<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @const<tr><td><a id="l155"></a><a href="#l155">155</a><td> */<tr><td><a id="l156"></a><a href="#l156">156</a><td>goog.html.SafeUrl.prototype.implementsGoogI18nBidiDirectionalString = true;<tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td><tr><td><a id="l159"></a><a href="#l159">159</a><td>/**<tr><td><a id="l160"></a><a href="#l160">160</a><td> * Returns this URLs directionality, which is always {@code LTR}.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @override<tr><td><a id="l162"></a><a href="#l162">162</a><td> */<tr><td><a id="l163"></a><a href="#l163">163</a><td>goog.html.SafeUrl.prototype.getDirection = function() {<tr><td><a id="l164"></a><a href="#l164">164</a><td>  return goog.i18n.bidi.Dir.LTR;<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>if (goog.DEBUG) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>  /**<tr><td><a id="l170"></a><a href="#l170">170</a><td>   * Returns a debug string-representation of this value.<tr><td><a id="l171"></a><a href="#l171">171</a><td>   *<tr><td><a id="l172"></a><a href="#l172">172</a><td>   * To obtain the actual string value wrapped in a SafeUrl, use<tr><td><a id="l173"></a><a href="#l173">173</a><td>   * {@code goog.html.SafeUrl.unwrap}.<tr><td><a id="l174"></a><a href="#l174">174</a><td>   *<tr><td><a id="l175"></a><a href="#l175">175</a><td>   * @see goog.html.SafeUrl#unwrap<tr><td><a id="l176"></a><a href="#l176">176</a><td>   * @override<tr><td><a id="l177"></a><a href="#l177">177</a><td>   */<tr><td><a id="l178"></a><a href="#l178">178</a><td>  goog.html.SafeUrl.prototype.toString = function() {<tr><td><a id="l179"></a><a href="#l179">179</a><td>    return &#39;SafeUrl{&#39; + this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ +<tr><td><a id="l180"></a><a href="#l180">180</a><td>        &#39;}&#39;;<tr><td><a id="l181"></a><a href="#l181">181</a><td>  };<tr><td><a id="l182"></a><a href="#l182">182</a><td>}<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>/**<tr><td><a id="l186"></a><a href="#l186">186</a><td> * Performs a runtime check that the provided object is indeed a SafeUrl<tr><td><a id="l187"></a><a href="#l187">187</a><td> * object, and returns its value.<tr><td><a id="l188"></a><a href="#l188">188</a><td> *<tr><td><a id="l189"></a><a href="#l189">189</a><td> * IMPORTANT: The guarantees of the SafeUrl type contract only extend to the<tr><td><a id="l190"></a><a href="#l190">190</a><td> * behavior of  browsers when interpreting URLs. Values of SafeUrl objects MUST<tr><td><a id="l191"></a><a href="#l191">191</a><td> * be appropriately escaped before embedding in a HTML document. Note that the<tr><td><a id="l192"></a><a href="#l192">192</a><td> * required escaping is context-sensitive (e.g. a different escaping is<tr><td><a id="l193"></a><a href="#l193">193</a><td> * required for embedding a URL in a style property within a style<tr><td><a id="l194"></a><a href="#l194">194</a><td> * attribute, as opposed to embedding in a href attribute).<tr><td><a id="l195"></a><a href="#l195">195</a><td> *<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @param {!goog.html.SafeUrl} safeUrl The object to extract from.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @return {string} The SafeUrl object&#39;s contained string, unless the run-time<tr><td><a id="l198"></a><a href="#l198">198</a><td> *     type check fails. In that case, {@code unwrap} returns an innocuous<tr><td><a id="l199"></a><a href="#l199">199</a><td> *     string, or, if assertions are enabled, throws<tr><td><a id="l200"></a><a href="#l200">200</a><td> *     {@code goog.asserts.AssertionError}.<tr><td><a id="l201"></a><a href="#l201">201</a><td> */<tr><td><a id="l202"></a><a href="#l202">202</a><td>goog.html.SafeUrl.unwrap = function(safeUrl) {<tr><td><a id="l203"></a><a href="#l203">203</a><td>  // Perform additional Run-time type-checking to ensure that safeUrl is indeed<tr><td><a id="l204"></a><a href="#l204">204</a><td>  // an instance of the expected type.  This provides some additional protection<tr><td><a id="l205"></a><a href="#l205">205</a><td>  // against security bugs due to application code that disables type checks.<tr><td><a id="l206"></a><a href="#l206">206</a><td>  // Specifically, the following checks are performed:<tr><td><a id="l207"></a><a href="#l207">207</a><td>  // 1. The object is an instance of the expected type.<tr><td><a id="l208"></a><a href="#l208">208</a><td>  // 2. The object is not an instance of a subclass.<tr><td><a id="l209"></a><a href="#l209">209</a><td>  // 3. The object carries a type marker for the expected type. &quot;Faking&quot; an<tr><td><a id="l210"></a><a href="#l210">210</a><td>  // object requires a reference to the type marker, which has names intended<tr><td><a id="l211"></a><a href="#l211">211</a><td>  // to stand out in code reviews.<tr><td><a id="l212"></a><a href="#l212">212</a><td>  if (safeUrl instanceof goog.html.SafeUrl &amp;&amp;<tr><td><a id="l213"></a><a href="#l213">213</a><td>      safeUrl.constructor === goog.html.SafeUrl &amp;&amp;<tr><td><a id="l214"></a><a href="#l214">214</a><td>      safeUrl.SAFE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===<tr><td><a id="l215"></a><a href="#l215">215</a><td>          goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>    return safeUrl.privateDoNotAccessOrElseSafeHtmlWrappedValue_;<tr><td><a id="l217"></a><a href="#l217">217</a><td>  } else {<tr><td><a id="l218"></a><a href="#l218">218</a><td>    goog.asserts.fail(&#39;expected object of type SafeUrl, got \&#39;&#39; +<tr><td><a id="l219"></a><a href="#l219">219</a><td>                      safeUrl + &#39;\&#39;&#39;);<tr><td><a id="l220"></a><a href="#l220">220</a><td>    return &#39;type_error:SafeUrl&#39;;<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td>  }<tr><td><a id="l223"></a><a href="#l223">223</a><td>};<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>/**<tr><td><a id="l227"></a><a href="#l227">227</a><td> * Creates a SafeUrl object from a compile-time constant string.<tr><td><a id="l228"></a><a href="#l228">228</a><td> *<tr><td><a id="l229"></a><a href="#l229">229</a><td> * Compile-time constant strings are inherently program-controlled and hence<tr><td><a id="l230"></a><a href="#l230">230</a><td> * trusted.<tr><td><a id="l231"></a><a href="#l231">231</a><td> *<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @param {!goog.string.Const} url A compile-time-constant string from which to<tr><td><a id="l233"></a><a href="#l233">233</a><td> *         create a SafeUrl.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @return {!goog.html.SafeUrl} A SafeUrl object initialized to {@code url}.<tr><td><a id="l235"></a><a href="#l235">235</a><td> */<tr><td><a id="l236"></a><a href="#l236">236</a><td>goog.html.SafeUrl.fromConstant = function(url) {<tr><td><a id="l237"></a><a href="#l237">237</a><td>  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l238"></a><a href="#l238">238</a><td>      goog.string.Const.unwrap(url));<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><tr><td><a id="l242"></a><a href="#l242">242</a><td>/**<tr><td><a id="l243"></a><a href="#l243">243</a><td> * A pattern that matches Blob or data types that can have SafeUrls created<tr><td><a id="l244"></a><a href="#l244">244</a><td> * from URL.createObjectURL(blob) or via a data: URI.  Only matches image and<tr><td><a id="l245"></a><a href="#l245">245</a><td> * video types, currently.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @const<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @private<tr><td><a id="l248"></a><a href="#l248">248</a><td> */<tr><td><a id="l249"></a><a href="#l249">249</a><td>goog.html.SAFE_MIME_TYPE_PATTERN_ =<tr><td><a id="l250"></a><a href="#l250">250</a><td>    /^(?:image\/(?:bmp|gif|jpeg|jpg|png|tiff|webp)|video\/(?:mpeg|mp4|ogg|webm))$/i;<tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td>/**<tr><td><a id="l254"></a><a href="#l254">254</a><td> * Creates a SafeUrl wrapping a blob URL for the given {@code blob}.<tr><td><a id="l255"></a><a href="#l255">255</a><td> *<tr><td><a id="l256"></a><a href="#l256">256</a><td> * The blob URL is created with {@code URL.createObjectURL}. If the MIME type<tr><td><a id="l257"></a><a href="#l257">257</a><td> * for {@code blob} is not of a known safe image or video MIME type, then the<tr><td><a id="l258"></a><a href="#l258">258</a><td> * SafeUrl will wrap {@link #INNOCUOUS_STRING}.<tr><td><a id="l259"></a><a href="#l259">259</a><td> *<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @see http://www.w3.org/TR/FileAPI/#url<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @param {!Blob} blob<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @return {!goog.html.SafeUrl} The blob URL, or an innocuous string wrapped<tr><td><a id="l263"></a><a href="#l263">263</a><td> *   as a SafeUrl.<tr><td><a id="l264"></a><a href="#l264">264</a><td> */<tr><td><a id="l265"></a><a href="#l265">265</a><td>goog.html.SafeUrl.fromBlob = function(blob) {<tr><td><a id="l266"></a><a href="#l266">266</a><td>  var url = goog.html.SAFE_MIME_TYPE_PATTERN_.test(blob.type) ?<tr><td><a id="l267"></a><a href="#l267">267</a><td>      goog.fs.url.createObjectUrl(blob) : goog.html.SafeUrl.INNOCUOUS_STRING;<tr><td><a id="l268"></a><a href="#l268">268</a><td>  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(url);<tr><td><a id="l269"></a><a href="#l269">269</a><td>};<tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td><tr><td><a id="l272"></a><a href="#l272">272</a><td>/**<tr><td><a id="l273"></a><a href="#l273">273</a><td> * Matches a base-64 data URL, with the first match group being the MIME type.<tr><td><a id="l274"></a><a href="#l274">274</a><td> * @const<tr><td><a id="l275"></a><a href="#l275">275</a><td> * @private<tr><td><a id="l276"></a><a href="#l276">276</a><td> */<tr><td><a id="l277"></a><a href="#l277">277</a><td>goog.html.DATA_URL_PATTERN_ = /^data:([^;,]*);base64,[a-z0-9+\/]+=*$/i;<tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td>/**<tr><td><a id="l281"></a><a href="#l281">281</a><td> * Creates a SafeUrl wrapping a data: URL, after validating it matches a<tr><td><a id="l282"></a><a href="#l282">282</a><td> * known-safe image or video MIME type.<tr><td><a id="l283"></a><a href="#l283">283</a><td> *<tr><td><a id="l284"></a><a href="#l284">284</a><td> * @param {string} dataUrl A valid base64 data URL with one of the whitelisted<tr><td><a id="l285"></a><a href="#l285">285</a><td> *     image or video MIME types.<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @return {!goog.html.SafeUrl} A matching safe URL, or {@link INNOCUOUS_STRING}<tr><td><a id="l287"></a><a href="#l287">287</a><td> *     wrapped as a SafeUrl if it does not pass.<tr><td><a id="l288"></a><a href="#l288">288</a><td> */<tr><td><a id="l289"></a><a href="#l289">289</a><td>goog.html.SafeUrl.fromDataUrl = function(dataUrl) {<tr><td><a id="l290"></a><a href="#l290">290</a><td>  // There&#39;s a slight risk here that a browser sniffs the content type if it<tr><td><a id="l291"></a><a href="#l291">291</a><td>  // doesn&#39;t know the MIME type and executes HTML within the data: URL. For this<tr><td><a id="l292"></a><a href="#l292">292</a><td>  // to cause XSS it would also have to execute the HTML in the same origin<tr><td><a id="l293"></a><a href="#l293">293</a><td>  // of the page with the link. It seems unlikely that both of these will<tr><td><a id="l294"></a><a href="#l294">294</a><td>  // happen, particularly in not really old IEs.<tr><td><a id="l295"></a><a href="#l295">295</a><td>  var match = dataUrl.match(goog.html.DATA_URL_PATTERN_);<tr><td><a id="l296"></a><a href="#l296">296</a><td>  var valid = match &amp;&amp; goog.html.SAFE_MIME_TYPE_PATTERN_.test(match[1]);<tr><td><a id="l297"></a><a href="#l297">297</a><td>  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l298"></a><a href="#l298">298</a><td>      valid ? dataUrl : goog.html.SafeUrl.INNOCUOUS_STRING);<tr><td><a id="l299"></a><a href="#l299">299</a><td>};<tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td>/**<tr><td><a id="l303"></a><a href="#l303">303</a><td> * A pattern that recognizes a commonly useful subset of URLs that satisfy<tr><td><a id="l304"></a><a href="#l304">304</a><td> * the SafeUrl contract.<tr><td><a id="l305"></a><a href="#l305">305</a><td> *<tr><td><a id="l306"></a><a href="#l306">306</a><td> * This regular expression matches a subset of URLs that will not cause script<tr><td><a id="l307"></a><a href="#l307">307</a><td> * execution if used in URL context within a HTML document. Specifically, this<tr><td><a id="l308"></a><a href="#l308">308</a><td> * regular expression matches if (comment from here on and regex copied from<tr><td><a id="l309"></a><a href="#l309">309</a><td> * Soy&#39;s EscapingConventions):<tr><td><a id="l310"></a><a href="#l310">310</a><td> * (1) Either a protocol in a whitelist (http, https, mailto or ftp).<tr><td><a id="l311"></a><a href="#l311">311</a><td> * (2) or no protocol.  A protocol must be followed by a colon. The below<tr><td><a id="l312"></a><a href="#l312">312</a><td> *     allows that by allowing colons only after one of the characters [/?#].<tr><td><a id="l313"></a><a href="#l313">313</a><td> *     A colon after a hash (#) must be in the fragment.<tr><td><a id="l314"></a><a href="#l314">314</a><td> *     Otherwise, a colon after a (?) must be in a query.<tr><td><a id="l315"></a><a href="#l315">315</a><td> *     Otherwise, a colon after a single solidus (/) must be in a path.<tr><td><a id="l316"></a><a href="#l316">316</a><td> *     Otherwise, a colon after a double solidus (//) must be in the authority<tr><td><a id="l317"></a><a href="#l317">317</a><td> *     (before port).<tr><td><a id="l318"></a><a href="#l318">318</a><td> *<tr><td><a id="l319"></a><a href="#l319">319</a><td> * The pattern disallows &amp;, used in HTML entity declarations before<tr><td><a id="l320"></a><a href="#l320">320</a><td> * one of the characters in [/?#]. This disallows HTML entities used in the<tr><td><a id="l321"></a><a href="#l321">321</a><td> * protocol name, which should never happen, e.g. &quot;h&amp;#116;tp&quot; for &quot;http&quot;.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * It also disallows HTML entities in the first path part of a relative path,<tr><td><a id="l323"></a><a href="#l323">323</a><td> * e.g. &quot;foo&amp;lt;bar/baz&quot;.  Our existing escaping functions should not produce<tr><td><a id="l324"></a><a href="#l324">324</a><td> * that. More importantly, it disallows masking of a colon,<tr><td><a id="l325"></a><a href="#l325">325</a><td> * e.g. &quot;javascript&amp;#58;...&quot;.<tr><td><a id="l326"></a><a href="#l326">326</a><td> *<tr><td><a id="l327"></a><a href="#l327">327</a><td> * @private<tr><td><a id="l328"></a><a href="#l328">328</a><td> * @const {!RegExp}<tr><td><a id="l329"></a><a href="#l329">329</a><td> */<tr><td><a id="l330"></a><a href="#l330">330</a><td>goog.html.SAFE_URL_PATTERN_ =<tr><td><a id="l331"></a><a href="#l331">331</a><td>    /^(?:(?:https?|mailto|ftp):|[^&amp;:/?#]*(?:[/?#]|$))/i;<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>/**<tr><td><a id="l335"></a><a href="#l335">335</a><td> * Creates a SafeUrl object from {@code url}. If {@code url} is a<tr><td><a id="l336"></a><a href="#l336">336</a><td> * goog.html.SafeUrl then it is simply returned. Otherwise the input string is<tr><td><a id="l337"></a><a href="#l337">337</a><td> * validated to match a pattern of commonly used safe URLs. The string is<tr><td><a id="l338"></a><a href="#l338">338</a><td> * converted to UTF-8 and non-whitelisted characters are percent-encoded. The<tr><td><a id="l339"></a><a href="#l339">339</a><td> * string wrapped by the created SafeUrl will thus contain only ASCII printable<tr><td><a id="l340"></a><a href="#l340">340</a><td> * characters.<tr><td><a id="l341"></a><a href="#l341">341</a><td> *<tr><td><a id="l342"></a><a href="#l342">342</a><td> * {@code url} may be a URL with the http, https, mailto or ftp scheme,<tr><td><a id="l343"></a><a href="#l343">343</a><td> * or a relative URL (i.e., a URL without a scheme; specifically, a<tr><td><a id="l344"></a><a href="#l344">344</a><td> * scheme-relative, absolute-path-relative, or path-relative URL).<tr><td><a id="l345"></a><a href="#l345">345</a><td> *<tr><td><a id="l346"></a><a href="#l346">346</a><td> * {@code url} is converted to UTF-8 and non-whitelisted characters are<tr><td><a id="l347"></a><a href="#l347">347</a><td> * percent-encoded. Whitelisted characters are &#39;%&#39; and, from RFC 3986,<tr><td><a id="l348"></a><a href="#l348">348</a><td> * unreserved characters and reserved characters, with the exception of &#39;\&#39;&#39;,<tr><td><a id="l349"></a><a href="#l349">349</a><td> * &#39;(&#39; and &#39;)&#39;. This ensures the the SafeUrl contains only ASCII-printable<tr><td><a id="l350"></a><a href="#l350">350</a><td> * characters and reduces the chance of security bugs were it to be<tr><td><a id="l351"></a><a href="#l351">351</a><td> * interpolated into a specific context without the necessary escaping.<tr><td><a id="l352"></a><a href="#l352">352</a><td> *<tr><td><a id="l353"></a><a href="#l353">353</a><td> * If {@code url} fails validation or does not UTF-16 decode correctly<tr><td><a id="l354"></a><a href="#l354">354</a><td> * (JavaScript strings are UTF-16 encoded), this function returns a SafeUrl<tr><td><a id="l355"></a><a href="#l355">355</a><td> * object containing an innocuous string, goog.html.SafeUrl.INNOCUOUS_STRING.<tr><td><a id="l356"></a><a href="#l356">356</a><td> *<tr><td><a id="l357"></a><a href="#l357">357</a><td> * @see http://url.spec.whatwg.org/#concept-relative-url<tr><td><a id="l358"></a><a href="#l358">358</a><td> * @param {string|!goog.string.TypedString} url The URL to validate.<tr><td><a id="l359"></a><a href="#l359">359</a><td> * @return {!goog.html.SafeUrl} The validated URL, wrapped as a SafeUrl.<tr><td><a id="l360"></a><a href="#l360">360</a><td> */<tr><td><a id="l361"></a><a href="#l361">361</a><td>goog.html.SafeUrl.sanitize = function(url) {<tr><td><a id="l362"></a><a href="#l362">362</a><td>  if (url instanceof goog.html.SafeUrl) {<tr><td><a id="l363"></a><a href="#l363">363</a><td>    return url;<tr><td><a id="l364"></a><a href="#l364">364</a><td>  }<tr><td><a id="l365"></a><a href="#l365">365</a><td>  else if (url.implementsGoogStringTypedString) {<tr><td><a id="l366"></a><a href="#l366">366</a><td>    url = url.getTypedStringValue();<tr><td><a id="l367"></a><a href="#l367">367</a><td>  } else {<tr><td><a id="l368"></a><a href="#l368">368</a><td>    url = String(url);<tr><td><a id="l369"></a><a href="#l369">369</a><td>  }<tr><td><a id="l370"></a><a href="#l370">370</a><td>  if (!goog.html.SAFE_URL_PATTERN_.test(url)) {<tr><td><a id="l371"></a><a href="#l371">371</a><td>    url = goog.html.SafeUrl.INNOCUOUS_STRING;<tr><td><a id="l372"></a><a href="#l372">372</a><td>  }<tr><td><a id="l373"></a><a href="#l373">373</a><td>  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(url);<tr><td><a id="l374"></a><a href="#l374">374</a><td>};<tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td><tr><td><a id="l377"></a><a href="#l377">377</a><td>/**<tr><td><a id="l378"></a><a href="#l378">378</a><td> * Type marker for the SafeUrl type, used to implement additional run-time<tr><td><a id="l379"></a><a href="#l379">379</a><td> * type checking.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @const {!Object}<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @private<tr><td><a id="l382"></a><a href="#l382">382</a><td> */<tr><td><a id="l383"></a><a href="#l383">383</a><td>goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};<tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td>/**<tr><td><a id="l387"></a><a href="#l387">387</a><td> * Package-internal utility method to create SafeUrl instances.<tr><td><a id="l388"></a><a href="#l388">388</a><td> *<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @param {string} url The string to initialize the SafeUrl object with.<tr><td><a id="l390"></a><a href="#l390">390</a><td> * @return {!goog.html.SafeUrl} The initialized SafeUrl object.<tr><td><a id="l391"></a><a href="#l391">391</a><td> * @package<tr><td><a id="l392"></a><a href="#l392">392</a><td> */<tr><td><a id="l393"></a><a href="#l393">393</a><td>goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse = function(<tr><td><a id="l394"></a><a href="#l394">394</a><td>    url) {<tr><td><a id="l395"></a><a href="#l395">395</a><td>  var safeUrl = new goog.html.SafeUrl();<tr><td><a id="l396"></a><a href="#l396">396</a><td>  safeUrl.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = url;<tr><td><a id="l397"></a><a href="#l397">397</a><td>  return safeUrl;<tr><td><a id="l398"></a><a href="#l398">398</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/html/trustedresourceurl.js.src.html b/docs/source/lib/goog/html/trustedresourceurl.js.src.html
new file mode 100644
index 0000000..1146db6
--- /dev/null
+++ b/docs/source/lib/goog/html/trustedresourceurl.js.src.html
@@ -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>trustedresourceurl.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/html/trustedresourceurl.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview The TrustedResourceUrl type and its builders.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * TODO(xtof): Link to document stating type contract.<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.html.TrustedResourceUrl&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.i18n.bidi.Dir&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.i18n.bidi.DirectionalString&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string.TypedString&#39;);<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>/**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * A URL which is under application control and from which script, CSS, and<tr><td><a id="l33"></a><a href="#l33">33</a><td> * other resources that represent executable code, can be fetched.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Given that the URL can only be constructed from strings under application<tr><td><a id="l36"></a><a href="#l36">36</a><td> * control and is used to load resources, bugs resulting in a malformed URL<tr><td><a id="l37"></a><a href="#l37">37</a><td> * should not have a security impact and are likely to be easily detectable<tr><td><a id="l38"></a><a href="#l38">38</a><td> * during testing. Given the wide number of non-RFC compliant URLs in use,<tr><td><a id="l39"></a><a href="#l39">39</a><td> * stricter validation could prevent some applications from being able to use<tr><td><a id="l40"></a><a href="#l40">40</a><td> * this type.<tr><td><a id="l41"></a><a href="#l41">41</a><td> *<tr><td><a id="l42"></a><a href="#l42">42</a><td> * Instances of this type must be created via the factory method,<tr><td><a id="l43"></a><a href="#l43">43</a><td> * ({@code goog.html.TrustedResourceUrl.fromConstant}), and not by invoking its<tr><td><a id="l44"></a><a href="#l44">44</a><td> * constructor. The constructor intentionally takes no parameters and the type<tr><td><a id="l45"></a><a href="#l45">45</a><td> * is immutable; hence only a default instance corresponding to the empty<tr><td><a id="l46"></a><a href="#l46">46</a><td> * string can be obtained via constructor invocation.<tr><td><a id="l47"></a><a href="#l47">47</a><td> *<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @see goog.html.TrustedResourceUrl#fromConstant<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @constructor<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @final<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @struct<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @implements {goog.i18n.bidi.DirectionalString}<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @implements {goog.string.TypedString}<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.html.TrustedResourceUrl = function() {<tr><td><a id="l56"></a><a href="#l56">56</a><td>  /**<tr><td><a id="l57"></a><a href="#l57">57</a><td>   * The contained value of this TrustedResourceUrl.  The field has a purposely<tr><td><a id="l58"></a><a href="#l58">58</a><td>   * ugly name to make (non-compiled) code that attempts to directly access this<tr><td><a id="l59"></a><a href="#l59">59</a><td>   * field stand out.<tr><td><a id="l60"></a><a href="#l60">60</a><td>   * @private {string}<tr><td><a id="l61"></a><a href="#l61">61</a><td>   */<tr><td><a id="l62"></a><a href="#l62">62</a><td>  this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ = &#39;&#39;;<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>   * A type marker used to implement additional run-time type checking.<tr><td><a id="l66"></a><a href="#l66">66</a><td>   * @see goog.html.TrustedResourceUrl#unwrap<tr><td><a id="l67"></a><a href="#l67">67</a><td>   * @const<tr><td><a id="l68"></a><a href="#l68">68</a><td>   * @private<tr><td><a id="l69"></a><a href="#l69">69</a><td>   */<tr><td><a id="l70"></a><a href="#l70">70</a><td>  this.TRUSTED_RESOURCE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =<tr><td><a id="l71"></a><a href="#l71">71</a><td>      goog.html.TrustedResourceUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;<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><tr><td><a id="l75"></a><a href="#l75">75</a><td>/**<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @override<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @const<tr><td><a id="l78"></a><a href="#l78">78</a><td> */<tr><td><a id="l79"></a><a href="#l79">79</a><td>goog.html.TrustedResourceUrl.prototype.implementsGoogStringTypedString = true;<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Returns this TrustedResourceUrl&#39;s value as a string.<tr><td><a id="l84"></a><a href="#l84">84</a><td> *<tr><td><a id="l85"></a><a href="#l85">85</a><td> * IMPORTANT: In code where it is security relevant that an object&#39;s type is<tr><td><a id="l86"></a><a href="#l86">86</a><td> * indeed {@code TrustedResourceUrl}, use<tr><td><a id="l87"></a><a href="#l87">87</a><td> * {@code goog.html.TrustedResourceUrl.unwrap} instead of this method. If in<tr><td><a id="l88"></a><a href="#l88">88</a><td> * doubt, assume that it&#39;s security relevant. In particular, note that<tr><td><a id="l89"></a><a href="#l89">89</a><td> * goog.html functions which return a goog.html type do not guarantee that<tr><td><a id="l90"></a><a href="#l90">90</a><td> * the returned instance is of the right type. For example:<tr><td><a id="l91"></a><a href="#l91">91</a><td> *<tr><td><a id="l92"></a><a href="#l92">92</a><td> * &lt;pre&gt;<tr><td><a id="l93"></a><a href="#l93">93</a><td> * var fakeSafeHtml = new String(&#39;fake&#39;);<tr><td><a id="l94"></a><a href="#l94">94</a><td> * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;<tr><td><a id="l95"></a><a href="#l95">95</a><td> * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);<tr><td><a id="l96"></a><a href="#l96">96</a><td> * // newSafeHtml is just an alias for fakeSafeHtml, it&#39;s passed through by<tr><td><a id="l97"></a><a href="#l97">97</a><td> * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml instanceof<tr><td><a id="l98"></a><a href="#l98">98</a><td> * // goog.html.SafeHtml.<tr><td><a id="l99"></a><a href="#l99">99</a><td> * &lt;/pre&gt;<tr><td><a id="l100"></a><a href="#l100">100</a><td> *<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @see goog.html.TrustedResourceUrl#unwrap<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @override<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.html.TrustedResourceUrl.prototype.getTypedStringValue = function() {<tr><td><a id="l105"></a><a href="#l105">105</a><td>  return this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_;<tr><td><a id="l106"></a><a href="#l106">106</a><td>};<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> * @override<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @const<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.html.TrustedResourceUrl.prototype.implementsGoogI18nBidiDirectionalString =<tr><td><a id="l114"></a><a href="#l114">114</a><td>    true;<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> * Returns this URLs directionality, which is always {@code LTR}.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @override<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.html.TrustedResourceUrl.prototype.getDirection = function() {<tr><td><a id="l122"></a><a href="#l122">122</a><td>  return goog.i18n.bidi.Dir.LTR;<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>if (goog.DEBUG) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>  /**<tr><td><a id="l128"></a><a href="#l128">128</a><td>   * Returns a debug string-representation of this value.<tr><td><a id="l129"></a><a href="#l129">129</a><td>   *<tr><td><a id="l130"></a><a href="#l130">130</a><td>   * To obtain the actual string value wrapped in a TrustedResourceUrl, use<tr><td><a id="l131"></a><a href="#l131">131</a><td>   * {@code goog.html.TrustedResourceUrl.unwrap}.<tr><td><a id="l132"></a><a href="#l132">132</a><td>   *<tr><td><a id="l133"></a><a href="#l133">133</a><td>   * @see goog.html.TrustedResourceUrl#unwrap<tr><td><a id="l134"></a><a href="#l134">134</a><td>   * @override<tr><td><a id="l135"></a><a href="#l135">135</a><td>   */<tr><td><a id="l136"></a><a href="#l136">136</a><td>  goog.html.TrustedResourceUrl.prototype.toString = function() {<tr><td><a id="l137"></a><a href="#l137">137</a><td>    return &#39;TrustedResourceUrl{&#39; +<tr><td><a id="l138"></a><a href="#l138">138</a><td>        this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ + &#39;}&#39;;<tr><td><a id="l139"></a><a href="#l139">139</a><td>  };<tr><td><a id="l140"></a><a href="#l140">140</a><td>}<tr><td><a id="l141"></a><a href="#l141">141</a><td><tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>/**<tr><td><a id="l144"></a><a href="#l144">144</a><td> * Performs a runtime check that the provided object is indeed a<tr><td><a id="l145"></a><a href="#l145">145</a><td> * TrustedResourceUrl object, and returns its value.<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.html.TrustedResourceUrl} trustedResourceUrl The object to<tr><td><a id="l148"></a><a href="#l148">148</a><td> *     extract from.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @return {string} The trustedResourceUrl object&#39;s contained string, unless<tr><td><a id="l150"></a><a href="#l150">150</a><td> *     the run-time type check fails. In that case, {@code unwrap} returns an<tr><td><a id="l151"></a><a href="#l151">151</a><td> *     innocuous string, or, if assertions are enabled, throws<tr><td><a id="l152"></a><a href="#l152">152</a><td> *     {@code goog.asserts.AssertionError}.<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td>goog.html.TrustedResourceUrl.unwrap = function(trustedResourceUrl) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>  // Perform additional Run-time type-checking to ensure that<tr><td><a id="l156"></a><a href="#l156">156</a><td>  // trustedResourceUrl is indeed an instance of the expected type.  This<tr><td><a id="l157"></a><a href="#l157">157</a><td>  // provides some additional protection against security bugs due to<tr><td><a id="l158"></a><a href="#l158">158</a><td>  // application code that disables type checks.<tr><td><a id="l159"></a><a href="#l159">159</a><td>  // Specifically, the following checks are performed:<tr><td><a id="l160"></a><a href="#l160">160</a><td>  // 1. The object is an instance of the expected type.<tr><td><a id="l161"></a><a href="#l161">161</a><td>  // 2. The object is not an instance of a subclass.<tr><td><a id="l162"></a><a href="#l162">162</a><td>  // 3. The object carries a type marker for the expected type. &quot;Faking&quot; an<tr><td><a id="l163"></a><a href="#l163">163</a><td>  // object requires a reference to the type marker, which has names intended<tr><td><a id="l164"></a><a href="#l164">164</a><td>  // to stand out in code reviews.<tr><td><a id="l165"></a><a href="#l165">165</a><td>  if (trustedResourceUrl instanceof goog.html.TrustedResourceUrl &amp;&amp;<tr><td><a id="l166"></a><a href="#l166">166</a><td>      trustedResourceUrl.constructor === goog.html.TrustedResourceUrl &amp;&amp;<tr><td><a id="l167"></a><a href="#l167">167</a><td>      trustedResourceUrl<tr><td><a id="l168"></a><a href="#l168">168</a><td>          .TRUSTED_RESOURCE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===<tr><td><a id="l169"></a><a href="#l169">169</a><td>              goog.html.TrustedResourceUrl<tr><td><a id="l170"></a><a href="#l170">170</a><td>                  .TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>    return trustedResourceUrl<tr><td><a id="l172"></a><a href="#l172">172</a><td>        .privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_;<tr><td><a id="l173"></a><a href="#l173">173</a><td>  } else {<tr><td><a id="l174"></a><a href="#l174">174</a><td>    goog.asserts.fail(&#39;expected object of type TrustedResourceUrl, got \&#39;&#39; +<tr><td><a id="l175"></a><a href="#l175">175</a><td>                      trustedResourceUrl + &#39;\&#39;&#39;);<tr><td><a id="l176"></a><a href="#l176">176</a><td>    return &#39;type_error:TrustedResourceUrl&#39;;<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><tr><td><a id="l182"></a><a href="#l182">182</a><td>/**<tr><td><a id="l183"></a><a href="#l183">183</a><td> * Creates a TrustedResourceUrl object from a compile-time constant string.<tr><td><a id="l184"></a><a href="#l184">184</a><td> *<tr><td><a id="l185"></a><a href="#l185">185</a><td> * Compile-time constant strings are inherently program-controlled and hence<tr><td><a id="l186"></a><a href="#l186">186</a><td> * trusted.<tr><td><a id="l187"></a><a href="#l187">187</a><td> *<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @param {!goog.string.Const} url A compile-time-constant string from which to<tr><td><a id="l189"></a><a href="#l189">189</a><td> *     create a TrustedResourceUrl.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @return {!goog.html.TrustedResourceUrl} A TrustedResourceUrl object<tr><td><a id="l191"></a><a href="#l191">191</a><td> *     initialized to {@code url}.<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>goog.html.TrustedResourceUrl.fromConstant = function(url) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>  return goog.html.TrustedResourceUrl<tr><td><a id="l195"></a><a href="#l195">195</a><td>      .createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l196"></a><a href="#l196">196</a><td>          goog.string.Const.unwrap(url));<tr><td><a id="l197"></a><a href="#l197">197</a><td>};<tr><td><a id="l198"></a><a href="#l198">198</a><td><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> * Type marker for the TrustedResourceUrl type, used to implement additional<tr><td><a id="l202"></a><a href="#l202">202</a><td> * run-time type checking.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @const {!Object}<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.html.TrustedResourceUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};<tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td>/**<tr><td><a id="l210"></a><a href="#l210">210</a><td> * Package-internal utility method to create TrustedResourceUrl instances.<tr><td><a id="l211"></a><a href="#l211">211</a><td> *<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @param {string} url The string to initialize the TrustedResourceUrl object<tr><td><a id="l213"></a><a href="#l213">213</a><td> *     with.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @return {!goog.html.TrustedResourceUrl} The initialized TrustedResourceUrl<tr><td><a id="l215"></a><a href="#l215">215</a><td> *     object.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @package<tr><td><a id="l217"></a><a href="#l217">217</a><td> */<tr><td><a id="l218"></a><a href="#l218">218</a><td>goog.html.TrustedResourceUrl.<tr><td><a id="l219"></a><a href="#l219">219</a><td>    createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse = function(url) {<tr><td><a id="l220"></a><a href="#l220">220</a><td>  var trustedResourceUrl = new goog.html.TrustedResourceUrl();<tr><td><a id="l221"></a><a href="#l221">221</a><td>  trustedResourceUrl.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ =<tr><td><a id="l222"></a><a href="#l222">222</a><td>      url;<tr><td><a id="l223"></a><a href="#l223">223</a><td>  return trustedResourceUrl;<tr><td><a id="l224"></a><a href="#l224">224</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/html/uncheckedconversions.js.src.html b/docs/source/lib/goog/html/uncheckedconversions.js.src.html
new file mode 100644
index 0000000..e12549e
--- /dev/null
+++ b/docs/source/lib/goog/html/uncheckedconversions.js.src.html
@@ -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>uncheckedconversions.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/html/uncheckedconversions.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Unchecked conversions to create values of goog.html types from<tr><td><a id="l17"></a><a href="#l17">17</a><td> * plain strings.  Use of these functions could potentially result in instances<tr><td><a id="l18"></a><a href="#l18">18</a><td> * of goog.html types that violate their type contracts, and hence result in<tr><td><a id="l19"></a><a href="#l19">19</a><td> * security vulnerabilties.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * Therefore, all uses of the methods herein must be carefully security<tr><td><a id="l22"></a><a href="#l22">22</a><td> * reviewed.  Avoid use of the methods in this file whenever possible; instead<tr><td><a id="l23"></a><a href="#l23">23</a><td> * prefer to create instances of goog.html types using inherently safe builders<tr><td><a id="l24"></a><a href="#l24">24</a><td> * or template systems.<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> * @visibility {//closure/goog/html:approved_for_unchecked_conversion}<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @visibility {//closure/goog/bin/sizetests:__pkg__}<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>goog.provide(&#39;goog.html.uncheckedconversions&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.html.SafeHtml&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.html.SafeScript&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.html.SafeStyle&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.html.SafeStyleSheet&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.html.SafeUrl&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.html.TrustedResourceUrl&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.string.Const&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * Performs an &quot;unchecked conversion&quot; to SafeHtml from a plain string that is<tr><td><a id="l48"></a><a href="#l48">48</a><td> * known to satisfy the SafeHtml type contract.<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l51"></a><a href="#l51">51</a><td> * that the value of {@code html} satisfies the SafeHtml type contract in all<tr><td><a id="l52"></a><a href="#l52">52</a><td> * possible program states.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l56"></a><a href="#l56">56</a><td> *     this use of this method is safe. May include a security review ticket<tr><td><a id="l57"></a><a href="#l57">57</a><td> *     number.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {string} html A string that is claimed to adhere to the SafeHtml<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     contract.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {?goog.i18n.bidi.Dir=} opt_dir The optional directionality of the<tr><td><a id="l61"></a><a href="#l61">61</a><td> *     SafeHtml to be constructed. A null or undefined value signifies an<tr><td><a id="l62"></a><a href="#l62">62</a><td> *     unknown directionality.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @return {!goog.html.SafeHtml} The value of html, wrapped in a SafeHtml<tr><td><a id="l64"></a><a href="#l64">64</a><td> *     object.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @suppress {visibility} For access to SafeHtml.create...  Note that this<tr><td><a id="l66"></a><a href="#l66">66</a><td> *     use is appropriate since this method is intended to be &quot;package private&quot;<tr><td><a id="l67"></a><a href="#l67">67</a><td> *     withing goog.html.  DO NOT call SafeHtml.create... from outside this<tr><td><a id="l68"></a><a href="#l68">68</a><td> *     package; use appropriate wrappers instead.<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>goog.html.uncheckedconversions.safeHtmlFromStringKnownToSatisfyTypeContract =<tr><td><a id="l71"></a><a href="#l71">71</a><td>    function(justification, html, opt_dir) {<tr><td><a id="l72"></a><a href="#l72">72</a><td>  // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l73"></a><a href="#l73">73</a><td>  // away in production code.<tr><td><a id="l74"></a><a href="#l74">74</a><td>  goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l75"></a><a href="#l75">75</a><td>                            &#39;must provide justification&#39;);<tr><td><a id="l76"></a><a href="#l76">76</a><td>  goog.asserts.assert(<tr><td><a id="l77"></a><a href="#l77">77</a><td>      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l78"></a><a href="#l78">78</a><td>      &#39;must provide non-empty justification&#39;);<tr><td><a id="l79"></a><a href="#l79">79</a><td>  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l80"></a><a href="#l80">80</a><td>      html, opt_dir || 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><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> * Performs an &quot;unchecked conversion&quot; to SafeScript from a plain string that is<tr><td><a id="l86"></a><a href="#l86">86</a><td> * known to satisfy the SafeScript type contract.<tr><td><a id="l87"></a><a href="#l87">87</a><td> *<tr><td><a id="l88"></a><a href="#l88">88</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l89"></a><a href="#l89">89</a><td> * that the value of {@code script} satisfies the SafeScript type contract in<tr><td><a id="l90"></a><a href="#l90">90</a><td> * all possible program states.<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> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l94"></a><a href="#l94">94</a><td> *     this use of this method is safe. May include a security review ticket<tr><td><a id="l95"></a><a href="#l95">95</a><td> *     number.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {string} script The string to wrap as a SafeScript.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @return {!goog.html.SafeScript} The value of {@code script}, wrapped in a<tr><td><a id="l98"></a><a href="#l98">98</a><td> *     SafeScript object.<tr><td><a id="l99"></a><a href="#l99">99</a><td> */<tr><td><a id="l100"></a><a href="#l100">100</a><td>goog.html.uncheckedconversions.safeScriptFromStringKnownToSatisfyTypeContract =<tr><td><a id="l101"></a><a href="#l101">101</a><td>    function(justification, script) {<tr><td><a id="l102"></a><a href="#l102">102</a><td>  // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l103"></a><a href="#l103">103</a><td>  // away in production code.<tr><td><a id="l104"></a><a href="#l104">104</a><td>  goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l105"></a><a href="#l105">105</a><td>                            &#39;must provide justification&#39;);<tr><td><a id="l106"></a><a href="#l106">106</a><td>  goog.asserts.assert(<tr><td><a id="l107"></a><a href="#l107">107</a><td>      !goog.string.isEmpty(goog.string.Const.unwrap(justification)),<tr><td><a id="l108"></a><a href="#l108">108</a><td>      &#39;must provide non-empty justification&#39;);<tr><td><a id="l109"></a><a href="#l109">109</a><td>  return goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l110"></a><a href="#l110">110</a><td>      script);<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> * Performs an &quot;unchecked conversion&quot; to SafeStyle from a plain string that is<tr><td><a id="l116"></a><a href="#l116">116</a><td> * known to satisfy the SafeStyle type contract.<tr><td><a id="l117"></a><a href="#l117">117</a><td> *<tr><td><a id="l118"></a><a href="#l118">118</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l119"></a><a href="#l119">119</a><td> * that the value of {@code style} satisfies the SafeUrl type contract in all<tr><td><a id="l120"></a><a href="#l120">120</a><td> * possible program states.<tr><td><a id="l121"></a><a href="#l121">121</a><td> *<tr><td><a id="l122"></a><a href="#l122">122</a><td> *<tr><td><a id="l123"></a><a href="#l123">123</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l124"></a><a href="#l124">124</a><td> *     this use of this method is safe. May include a security review ticket<tr><td><a id="l125"></a><a href="#l125">125</a><td> *     number.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @param {string} style The string to wrap as a SafeStyle.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @return {!goog.html.SafeStyle} The value of {@code style}, wrapped in a<tr><td><a id="l128"></a><a href="#l128">128</a><td> *     SafeStyle object.<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.html.uncheckedconversions.safeStyleFromStringKnownToSatisfyTypeContract =<tr><td><a id="l131"></a><a href="#l131">131</a><td>    function(justification, style) {<tr><td><a id="l132"></a><a href="#l132">132</a><td>  // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l133"></a><a href="#l133">133</a><td>  // away in production code.<tr><td><a id="l134"></a><a href="#l134">134</a><td>  goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l135"></a><a href="#l135">135</a><td>                            &#39;must provide justification&#39;);<tr><td><a id="l136"></a><a href="#l136">136</a><td>  goog.asserts.assert(<tr><td><a id="l137"></a><a href="#l137">137</a><td>      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l138"></a><a href="#l138">138</a><td>      &#39;must provide non-empty justification&#39;);<tr><td><a id="l139"></a><a href="#l139">139</a><td>  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(<tr><td><a id="l140"></a><a href="#l140">140</a><td>      style);<tr><td><a id="l141"></a><a href="#l141">141</a><td>};<tr><td><a id="l142"></a><a href="#l142">142</a><td><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> * Performs an &quot;unchecked conversion&quot; to SafeStyleSheet from a plain string<tr><td><a id="l146"></a><a href="#l146">146</a><td> * that is known to satisfy the SafeStyleSheet type contract.<tr><td><a id="l147"></a><a href="#l147">147</a><td> *<tr><td><a id="l148"></a><a href="#l148">148</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l149"></a><a href="#l149">149</a><td> * that the value of {@code styleSheet} satisfies the SafeUrl type contract in<tr><td><a id="l150"></a><a href="#l150">150</a><td> * all possible program states.<tr><td><a id="l151"></a><a href="#l151">151</a><td> *<tr><td><a id="l152"></a><a href="#l152">152</a><td> *<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l154"></a><a href="#l154">154</a><td> *     this use of this method is safe. May include a security review ticket<tr><td><a id="l155"></a><a href="#l155">155</a><td> *     number.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @param {string} styleSheet The string to wrap as a SafeStyleSheet.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @return {!goog.html.SafeStyleSheet} The value of {@code styleSheet}, wrapped<tr><td><a id="l158"></a><a href="#l158">158</a><td> *     in a SafeStyleSheet object.<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.html.uncheckedconversions.<tr><td><a id="l161"></a><a href="#l161">161</a><td>    safeStyleSheetFromStringKnownToSatisfyTypeContract =<tr><td><a id="l162"></a><a href="#l162">162</a><td>    function(justification, styleSheet) {<tr><td><a id="l163"></a><a href="#l163">163</a><td>  // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l164"></a><a href="#l164">164</a><td>  // away in production code.<tr><td><a id="l165"></a><a href="#l165">165</a><td>  goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l166"></a><a href="#l166">166</a><td>                            &#39;must provide justification&#39;);<tr><td><a id="l167"></a><a href="#l167">167</a><td>  goog.asserts.assert(<tr><td><a id="l168"></a><a href="#l168">168</a><td>      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l169"></a><a href="#l169">169</a><td>      &#39;must provide non-empty justification&#39;);<tr><td><a id="l170"></a><a href="#l170">170</a><td>  return goog.html.SafeStyleSheet.<tr><td><a id="l171"></a><a href="#l171">171</a><td>      createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(styleSheet);<tr><td><a id="l172"></a><a href="#l172">172</a><td>};<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * Performs an &quot;unchecked conversion&quot; to SafeUrl from a plain string that is<tr><td><a id="l177"></a><a href="#l177">177</a><td> * known to satisfy the SafeUrl type contract.<tr><td><a id="l178"></a><a href="#l178">178</a><td> *<tr><td><a id="l179"></a><a href="#l179">179</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l180"></a><a href="#l180">180</a><td> * that the value of {@code url} satisfies the SafeUrl type contract in all<tr><td><a id="l181"></a><a href="#l181">181</a><td> * possible program states.<tr><td><a id="l182"></a><a href="#l182">182</a><td> *<tr><td><a id="l183"></a><a href="#l183">183</a><td> *<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l185"></a><a href="#l185">185</a><td> *     this use of this method is safe. May include a security review ticket<tr><td><a id="l186"></a><a href="#l186">186</a><td> *     number.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @param {string} url The string to wrap as a SafeUrl.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @return {!goog.html.SafeUrl} The value of {@code url}, wrapped in a SafeUrl<tr><td><a id="l189"></a><a href="#l189">189</a><td> *     object.<tr><td><a id="l190"></a><a href="#l190">190</a><td> */<tr><td><a id="l191"></a><a href="#l191">191</a><td>goog.html.uncheckedconversions.safeUrlFromStringKnownToSatisfyTypeContract =<tr><td><a id="l192"></a><a href="#l192">192</a><td>    function(justification, url) {<tr><td><a id="l193"></a><a href="#l193">193</a><td>  // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l194"></a><a href="#l194">194</a><td>  // away in production code.<tr><td><a id="l195"></a><a href="#l195">195</a><td>  goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l196"></a><a href="#l196">196</a><td>                            &#39;must provide justification&#39;);<tr><td><a id="l197"></a><a href="#l197">197</a><td>  goog.asserts.assert(<tr><td><a id="l198"></a><a href="#l198">198</a><td>      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l199"></a><a href="#l199">199</a><td>      &#39;must provide non-empty justification&#39;);<tr><td><a id="l200"></a><a href="#l200">200</a><td>  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(url);<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><tr><td><a id="l204"></a><a href="#l204">204</a><td>/**<tr><td><a id="l205"></a><a href="#l205">205</a><td> * Performs an &quot;unchecked conversion&quot; to TrustedResourceUrl from a plain string<tr><td><a id="l206"></a><a href="#l206">206</a><td> * that is known to satisfy the TrustedResourceUrl type contract.<tr><td><a id="l207"></a><a href="#l207">207</a><td> *<tr><td><a id="l208"></a><a href="#l208">208</a><td> * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure<tr><td><a id="l209"></a><a href="#l209">209</a><td> * that the value of {@code url} satisfies the TrustedResourceUrl type contract<tr><td><a id="l210"></a><a href="#l210">210</a><td> * in all possible program states.<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> * @param {!goog.string.Const} justification A constant string explaining why<tr><td><a id="l214"></a><a href="#l214">214</a><td> *     this use of this method is safe. May include a security review ticket<tr><td><a id="l215"></a><a href="#l215">215</a><td> *     number.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @param {string} url The string to wrap as a TrustedResourceUrl.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @return {!goog.html.TrustedResourceUrl} The value of {@code url}, wrapped in<tr><td><a id="l218"></a><a href="#l218">218</a><td> *     a TrustedResourceUrl object.<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>goog.html.uncheckedconversions.<tr><td><a id="l221"></a><a href="#l221">221</a><td>    trustedResourceUrlFromStringKnownToSatisfyTypeContract =<tr><td><a id="l222"></a><a href="#l222">222</a><td>    function(justification, url) {<tr><td><a id="l223"></a><a href="#l223">223</a><td>  // unwrap() called inside an assert so that justification can be optimized<tr><td><a id="l224"></a><a href="#l224">224</a><td>  // away in production code.<tr><td><a id="l225"></a><a href="#l225">225</a><td>  goog.asserts.assertString(goog.string.Const.unwrap(justification),<tr><td><a id="l226"></a><a href="#l226">226</a><td>                            &#39;must provide justification&#39;);<tr><td><a id="l227"></a><a href="#l227">227</a><td>  goog.asserts.assert(<tr><td><a id="l228"></a><a href="#l228">228</a><td>      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),<tr><td><a id="l229"></a><a href="#l229">229</a><td>      &#39;must provide non-empty justification&#39;);<tr><td><a id="l230"></a><a href="#l230">230</a><td>  return goog.html.TrustedResourceUrl.<tr><td><a id="l231"></a><a href="#l231">231</a><td>      createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse(url);<tr><td><a id="l232"></a><a href="#l232">232</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/i18n/bidi.js.src.html b/docs/source/lib/goog/i18n/bidi.js.src.html
new file mode 100644
index 0000000..34b4bf6
--- /dev/null
+++ b/docs/source/lib/goog/i18n/bidi.js.src.html
@@ -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>bidi.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/i18n/bidi.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utility functions for supporting Bidi issues.<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>/**<tr><td><a id="l21"></a><a href="#l21">21</a><td> * Namespace for bidi supporting functions.<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.i18n.bidi&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.i18n.bidi.Dir&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.i18n.bidi.DirectionalString&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.i18n.bidi.Format&#39;);<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> * @define {boolean} FORCE_RTL forces the {@link goog.i18n.bidi.IS_RTL} constant<tr><td><a id="l31"></a><a href="#l31">31</a><td> * to say that the current locale is a RTL locale.  This should only be used<tr><td><a id="l32"></a><a href="#l32">32</a><td> * if you want to override the default behavior for deciding whether the<tr><td><a id="l33"></a><a href="#l33">33</a><td> * current locale is RTL or not.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * {@see goog.i18n.bidi.IS_RTL}<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.define(&#39;goog.i18n.bidi.FORCE_RTL&#39;, false);<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> * Constant that defines whether or not the current locale is a RTL locale.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * If {@link goog.i18n.bidi.FORCE_RTL} is not true, this constant will default<tr><td><a id="l43"></a><a href="#l43">43</a><td> * to check that {@link goog.LOCALE} is one of a few major RTL locales.<tr><td><a id="l44"></a><a href="#l44">44</a><td> *<tr><td><a id="l45"></a><a href="#l45">45</a><td> * &lt;p&gt;This is designed to be a maximally efficient compile-time constant. For<tr><td><a id="l46"></a><a href="#l46">46</a><td> * example, for the default goog.LOCALE, compiling<tr><td><a id="l47"></a><a href="#l47">47</a><td> * &quot;if (goog.i18n.bidi.IS_RTL) alert(&#39;rtl&#39;) else {}&quot; should produce no code. It<tr><td><a id="l48"></a><a href="#l48">48</a><td> * is this design consideration that limits the implementation to only<tr><td><a id="l49"></a><a href="#l49">49</a><td> * supporting a few major RTL locales, as opposed to the broader repertoire of<tr><td><a id="l50"></a><a href="#l50">50</a><td> * something like goog.i18n.bidi.isRtlLanguage.<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * &lt;p&gt;Since this constant refers to the directionality of the locale, it is up<tr><td><a id="l53"></a><a href="#l53">53</a><td> * to the caller to determine if this constant should also be used for the<tr><td><a id="l54"></a><a href="#l54">54</a><td> * direction of the UI.<tr><td><a id="l55"></a><a href="#l55">55</a><td> *<tr><td><a id="l56"></a><a href="#l56">56</a><td> * {@see goog.LOCALE}<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @type {boolean}<tr><td><a id="l59"></a><a href="#l59">59</a><td> *<tr><td><a id="l60"></a><a href="#l60">60</a><td> * TODO(user): write a test that checks that this is a compile-time constant.<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.i18n.bidi.IS_RTL = goog.i18n.bidi.FORCE_RTL ||<tr><td><a id="l63"></a><a href="#l63">63</a><td>    (<tr><td><a id="l64"></a><a href="#l64">64</a><td>        (goog.LOCALE.substring(0, 2).toLowerCase() == &#39;ar&#39; ||<tr><td><a id="l65"></a><a href="#l65">65</a><td>         goog.LOCALE.substring(0, 2).toLowerCase() == &#39;fa&#39; ||<tr><td><a id="l66"></a><a href="#l66">66</a><td>         goog.LOCALE.substring(0, 2).toLowerCase() == &#39;he&#39; ||<tr><td><a id="l67"></a><a href="#l67">67</a><td>         goog.LOCALE.substring(0, 2).toLowerCase() == &#39;iw&#39; ||<tr><td><a id="l68"></a><a href="#l68">68</a><td>         goog.LOCALE.substring(0, 2).toLowerCase() == &#39;ps&#39; ||<tr><td><a id="l69"></a><a href="#l69">69</a><td>         goog.LOCALE.substring(0, 2).toLowerCase() == &#39;sd&#39; ||<tr><td><a id="l70"></a><a href="#l70">70</a><td>         goog.LOCALE.substring(0, 2).toLowerCase() == &#39;ug&#39; ||<tr><td><a id="l71"></a><a href="#l71">71</a><td>         goog.LOCALE.substring(0, 2).toLowerCase() == &#39;ur&#39; ||<tr><td><a id="l72"></a><a href="#l72">72</a><td>         goog.LOCALE.substring(0, 2).toLowerCase() == &#39;yi&#39;) &amp;&amp;<tr><td><a id="l73"></a><a href="#l73">73</a><td>        (goog.LOCALE.length == 2 ||<tr><td><a id="l74"></a><a href="#l74">74</a><td>         goog.LOCALE.substring(2, 3) == &#39;-&#39; ||<tr><td><a id="l75"></a><a href="#l75">75</a><td>         goog.LOCALE.substring(2, 3) == &#39;_&#39;)<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.LOCALE.length &gt;= 3 &amp;&amp;<tr><td><a id="l78"></a><a href="#l78">78</a><td>        goog.LOCALE.substring(0, 3).toLowerCase() == &#39;ckb&#39; &amp;&amp;<tr><td><a id="l79"></a><a href="#l79">79</a><td>        (goog.LOCALE.length == 3 ||<tr><td><a id="l80"></a><a href="#l80">80</a><td>         goog.LOCALE.substring(3, 4) == &#39;-&#39; ||<tr><td><a id="l81"></a><a href="#l81">81</a><td>         goog.LOCALE.substring(3, 4) == &#39;_&#39;)<tr><td><a id="l82"></a><a href="#l82">82</a><td>    );<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Unicode formatting characters and directionality string constants.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @enum {string}<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.i18n.bidi.Format = {<tr><td><a id="l90"></a><a href="#l90">90</a><td>  /** Unicode &quot;Left-To-Right Embedding&quot; (LRE) character. */<tr><td><a id="l91"></a><a href="#l91">91</a><td>  LRE: &#39;\u202A&#39;,<tr><td><a id="l92"></a><a href="#l92">92</a><td>  /** Unicode &quot;Right-To-Left Embedding&quot; (RLE) character. */<tr><td><a id="l93"></a><a href="#l93">93</a><td>  RLE: &#39;\u202B&#39;,<tr><td><a id="l94"></a><a href="#l94">94</a><td>  /** Unicode &quot;Pop Directional Formatting&quot; (PDF) character. */<tr><td><a id="l95"></a><a href="#l95">95</a><td>  PDF: &#39;\u202C&#39;,<tr><td><a id="l96"></a><a href="#l96">96</a><td>  /** Unicode &quot;Left-To-Right Mark&quot; (LRM) character. */<tr><td><a id="l97"></a><a href="#l97">97</a><td>  LRM: &#39;\u200E&#39;,<tr><td><a id="l98"></a><a href="#l98">98</a><td>  /** Unicode &quot;Right-To-Left Mark&quot; (RLM) character. */<tr><td><a id="l99"></a><a href="#l99">99</a><td>  RLM: &#39;\u200F&#39;<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>/**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * Directionality enum.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @enum {number}<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.i18n.bidi.Dir = {<tr><td><a id="l108"></a><a href="#l108">108</a><td>  /**<tr><td><a id="l109"></a><a href="#l109">109</a><td>   * Left-to-right.<tr><td><a id="l110"></a><a href="#l110">110</a><td>   */<tr><td><a id="l111"></a><a href="#l111">111</a><td>  LTR: 1,<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>   * Right-to-left.<tr><td><a id="l115"></a><a href="#l115">115</a><td>   */<tr><td><a id="l116"></a><a href="#l116">116</a><td>  RTL: -1,<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>   * Neither left-to-right nor right-to-left.<tr><td><a id="l120"></a><a href="#l120">120</a><td>   */<tr><td><a id="l121"></a><a href="#l121">121</a><td>  NEUTRAL: 0<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<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> * &#39;right&#39; string constant.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @type {string}<tr><td><a id="l128"></a><a href="#l128">128</a><td> */<tr><td><a id="l129"></a><a href="#l129">129</a><td>goog.i18n.bidi.RIGHT = &#39;right&#39;;<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * &#39;left&#39; string constant.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @type {string}<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td>goog.i18n.bidi.LEFT = &#39;left&#39;;<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * &#39;left&#39; if locale is RTL, &#39;right&#39; if not.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @type {string}<tr><td><a id="l142"></a><a href="#l142">142</a><td> */<tr><td><a id="l143"></a><a href="#l143">143</a><td>goog.i18n.bidi.I18N_RIGHT = goog.i18n.bidi.IS_RTL ? goog.i18n.bidi.LEFT :<tr><td><a id="l144"></a><a href="#l144">144</a><td>    goog.i18n.bidi.RIGHT;<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> * &#39;right&#39; if locale is RTL, &#39;left&#39; if not.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @type {string}<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.i18n.bidi.I18N_LEFT = goog.i18n.bidi.IS_RTL ? goog.i18n.bidi.RIGHT :<tr><td><a id="l152"></a><a href="#l152">152</a><td>    goog.i18n.bidi.LEFT;<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> * Convert a directionality given in various formats to a goog.i18n.bidi.Dir<tr><td><a id="l157"></a><a href="#l157">157</a><td> * constant. Useful for interaction with different standards of directionality<tr><td><a id="l158"></a><a href="#l158">158</a><td> * representation.<tr><td><a id="l159"></a><a href="#l159">159</a><td> *<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @param {goog.i18n.bidi.Dir|number|boolean|null} givenDir Directionality given<tr><td><a id="l161"></a><a href="#l161">161</a><td> *     in one of the following formats:<tr><td><a id="l162"></a><a href="#l162">162</a><td> *     1. A goog.i18n.bidi.Dir constant.<tr><td><a id="l163"></a><a href="#l163">163</a><td> *     2. A number (positive = LTR, negative = RTL, 0 = neutral).<tr><td><a id="l164"></a><a href="#l164">164</a><td> *     3. A boolean (true = RTL, false = LTR).<tr><td><a id="l165"></a><a href="#l165">165</a><td> *     4. A null for unknown directionality.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {boolean=} opt_noNeutral Whether a givenDir of zero or<tr><td><a id="l167"></a><a href="#l167">167</a><td> *     goog.i18n.bidi.Dir.NEUTRAL should be treated as null, i.e. unknown, in<tr><td><a id="l168"></a><a href="#l168">168</a><td> *     order to preserve legacy behavior.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @return {?goog.i18n.bidi.Dir} A goog.i18n.bidi.Dir constant matching the<tr><td><a id="l170"></a><a href="#l170">170</a><td> *     given directionality. If given null, returns null (i.e. unknown).<tr><td><a id="l171"></a><a href="#l171">171</a><td> */<tr><td><a id="l172"></a><a href="#l172">172</a><td>goog.i18n.bidi.toDir = function(givenDir, opt_noNeutral) {<tr><td><a id="l173"></a><a href="#l173">173</a><td>  if (typeof givenDir == &#39;number&#39;) {<tr><td><a id="l174"></a><a href="#l174">174</a><td>    // This includes the non-null goog.i18n.bidi.Dir case.<tr><td><a id="l175"></a><a href="#l175">175</a><td>    return givenDir &gt; 0 ? goog.i18n.bidi.Dir.LTR :<tr><td><a id="l176"></a><a href="#l176">176</a><td>        givenDir &lt; 0 ? goog.i18n.bidi.Dir.RTL :<tr><td><a id="l177"></a><a href="#l177">177</a><td>        opt_noNeutral ? null : goog.i18n.bidi.Dir.NEUTRAL;<tr><td><a id="l178"></a><a href="#l178">178</a><td>  } else if (givenDir == null) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>    return null;<tr><td><a id="l180"></a><a href="#l180">180</a><td>  } else {<tr><td><a id="l181"></a><a href="#l181">181</a><td>    // Must be typeof givenDir == &#39;boolean&#39;.<tr><td><a id="l182"></a><a href="#l182">182</a><td>    return givenDir ? goog.i18n.bidi.Dir.RTL : goog.i18n.bidi.Dir.LTR;<tr><td><a id="l183"></a><a href="#l183">183</a><td>  }<tr><td><a id="l184"></a><a href="#l184">184</a><td>};<tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td><tr><td><a id="l187"></a><a href="#l187">187</a><td>/**<tr><td><a id="l188"></a><a href="#l188">188</a><td> * A practical pattern to identify strong LTR characters. This pattern is not<tr><td><a id="l189"></a><a href="#l189">189</a><td> * theoretically correct according to the Unicode standard. It is simplified for<tr><td><a id="l190"></a><a href="#l190">190</a><td> * performance and small code size.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @type {string}<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @private<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>goog.i18n.bidi.ltrChars_ =<tr><td><a id="l195"></a><a href="#l195">195</a><td>    &#39;A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02B8\u0300-\u0590\u0800-\u1FFF&#39; +<tr><td><a id="l196"></a><a href="#l196">196</a><td>    &#39;\u200E\u2C00-\uFB1C\uFE00-\uFE6F\uFEFD-\uFFFF&#39;;<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>/**<tr><td><a id="l200"></a><a href="#l200">200</a><td> * A practical pattern to identify strong RTL character. This pattern is not<tr><td><a id="l201"></a><a href="#l201">201</a><td> * theoretically correct according to the Unicode standard. It is simplified<tr><td><a id="l202"></a><a href="#l202">202</a><td> * for performance and small code size.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @type {string}<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.i18n.bidi.rtlChars_ =<tr><td><a id="l207"></a><a href="#l207">207</a><td>    &#39;\u0591-\u06EF\u06FA-\u07FF\u200F\uFB1D-\uFDFF\uFE70-\uFEFC&#39;;<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td>/**<tr><td><a id="l211"></a><a href="#l211">211</a><td> * Simplified regular expression for an HTML tag (opening or closing) or an HTML<tr><td><a id="l212"></a><a href="#l212">212</a><td> * escape. We might want to skip over such expressions when estimating the text<tr><td><a id="l213"></a><a href="#l213">213</a><td> * directionality.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @type {RegExp}<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @private<tr><td><a id="l216"></a><a href="#l216">216</a><td> */<tr><td><a id="l217"></a><a href="#l217">217</a><td>goog.i18n.bidi.htmlSkipReg_ = /&lt;[^&gt;]*&gt;|&amp;[^;]+;/g;<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>/**<tr><td><a id="l221"></a><a href="#l221">221</a><td> * Returns the input text with spaces instead of HTML tags or HTML escapes, if<tr><td><a id="l222"></a><a href="#l222">222</a><td> * opt_isStripNeeded is true. Else returns the input as is.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * Useful for text directionality estimation.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * Note: the function should not be used in other contexts; it is not 100%<tr><td><a id="l225"></a><a href="#l225">225</a><td> * correct, but rather a good-enough implementation for directionality<tr><td><a id="l226"></a><a href="#l226">226</a><td> * estimation purposes.<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @param {string} str The given string.<tr><td><a id="l228"></a><a href="#l228">228</a><td> * @param {boolean=} opt_isStripNeeded Whether to perform the stripping.<tr><td><a id="l229"></a><a href="#l229">229</a><td> *     Default: false (to retain consistency with calling functions).<tr><td><a id="l230"></a><a href="#l230">230</a><td> * @return {string} The given string cleaned of HTML tags / escapes.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @private<tr><td><a id="l232"></a><a href="#l232">232</a><td> */<tr><td><a id="l233"></a><a href="#l233">233</a><td>goog.i18n.bidi.stripHtmlIfNeeded_ = function(str, opt_isStripNeeded) {<tr><td><a id="l234"></a><a href="#l234">234</a><td>  return opt_isStripNeeded ? str.replace(goog.i18n.bidi.htmlSkipReg_, &#39;&#39;) :<tr><td><a id="l235"></a><a href="#l235">235</a><td>      str;<tr><td><a id="l236"></a><a href="#l236">236</a><td>};<tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td><tr><td><a id="l239"></a><a href="#l239">239</a><td>/**<tr><td><a id="l240"></a><a href="#l240">240</a><td> * Regular expression to check for RTL characters.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @type {RegExp}<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @private<tr><td><a id="l243"></a><a href="#l243">243</a><td> */<tr><td><a id="l244"></a><a href="#l244">244</a><td>goog.i18n.bidi.rtlCharReg_ = new RegExp(&#39;[&#39; + goog.i18n.bidi.rtlChars_ + &#39;]&#39;);<tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>/**<tr><td><a id="l248"></a><a href="#l248">248</a><td> * Regular expression to check for LTR characters.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @type {RegExp}<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @private<tr><td><a id="l251"></a><a href="#l251">251</a><td> */<tr><td><a id="l252"></a><a href="#l252">252</a><td>goog.i18n.bidi.ltrCharReg_ = new RegExp(&#39;[&#39; + goog.i18n.bidi.ltrChars_ + &#39;]&#39;);<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Test whether the given string has any RTL characters in it.<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l259"></a><a href="#l259">259</a><td> *     Default: false.<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @return {boolean} Whether the string contains RTL characters.<tr><td><a id="l261"></a><a href="#l261">261</a><td> */<tr><td><a id="l262"></a><a href="#l262">262</a><td>goog.i18n.bidi.hasAnyRtl = function(str, opt_isHtml) {<tr><td><a id="l263"></a><a href="#l263">263</a><td>  return goog.i18n.bidi.rtlCharReg_.test(goog.i18n.bidi.stripHtmlIfNeeded_(<tr><td><a id="l264"></a><a href="#l264">264</a><td>      str, opt_isHtml));<tr><td><a id="l265"></a><a href="#l265">265</a><td>};<tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td>/**<tr><td><a id="l269"></a><a href="#l269">269</a><td> * Test whether the given string has any RTL characters in it.<tr><td><a id="l270"></a><a href="#l270">270</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @return {boolean} Whether the string contains RTL characters.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @deprecated Use hasAnyRtl.<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td>goog.i18n.bidi.hasRtlChar = goog.i18n.bidi.hasAnyRtl;<tr><td><a id="l275"></a><a href="#l275">275</a><td><tr><td><a id="l276"></a><a href="#l276">276</a><td><tr><td><a id="l277"></a><a href="#l277">277</a><td>/**<tr><td><a id="l278"></a><a href="#l278">278</a><td> * Test whether the given string has any LTR characters in it.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l281"></a><a href="#l281">281</a><td> *     Default: false.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @return {boolean} Whether the string contains LTR characters.<tr><td><a id="l283"></a><a href="#l283">283</a><td> */<tr><td><a id="l284"></a><a href="#l284">284</a><td>goog.i18n.bidi.hasAnyLtr = function(str, opt_isHtml) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>  return goog.i18n.bidi.ltrCharReg_.test(goog.i18n.bidi.stripHtmlIfNeeded_(<tr><td><a id="l286"></a><a href="#l286">286</a><td>      str, opt_isHtml));<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><tr><td><a id="l290"></a><a href="#l290">290</a><td>/**<tr><td><a id="l291"></a><a href="#l291">291</a><td> * Regular expression pattern to check if the first character in the string<tr><td><a id="l292"></a><a href="#l292">292</a><td> * is LTR.<tr><td><a id="l293"></a><a href="#l293">293</a><td> * @type {RegExp}<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @private<tr><td><a id="l295"></a><a href="#l295">295</a><td> */<tr><td><a id="l296"></a><a href="#l296">296</a><td>goog.i18n.bidi.ltrRe_ = new RegExp(&#39;^[&#39; + goog.i18n.bidi.ltrChars_ + &#39;]&#39;);<tr><td><a id="l297"></a><a href="#l297">297</a><td><tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td>/**<tr><td><a id="l300"></a><a href="#l300">300</a><td> * Regular expression pattern to check if the first character in the string<tr><td><a id="l301"></a><a href="#l301">301</a><td> * is RTL.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @type {RegExp}<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @private<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.i18n.bidi.rtlRe_ = new RegExp(&#39;^[&#39; + goog.i18n.bidi.rtlChars_ + &#39;]&#39;);<tr><td><a id="l306"></a><a href="#l306">306</a><td><tr><td><a id="l307"></a><a href="#l307">307</a><td><tr><td><a id="l308"></a><a href="#l308">308</a><td>/**<tr><td><a id="l309"></a><a href="#l309">309</a><td> * Check if the first character in the string is RTL or not.<tr><td><a id="l310"></a><a href="#l310">310</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l311"></a><a href="#l311">311</a><td> * @return {boolean} Whether the first character in str is an RTL char.<tr><td><a id="l312"></a><a href="#l312">312</a><td> */<tr><td><a id="l313"></a><a href="#l313">313</a><td>goog.i18n.bidi.isRtlChar = function(str) {<tr><td><a id="l314"></a><a href="#l314">314</a><td>  return goog.i18n.bidi.rtlRe_.test(str);<tr><td><a id="l315"></a><a href="#l315">315</a><td>};<tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td>/**<tr><td><a id="l319"></a><a href="#l319">319</a><td> * Check if the first character in the string is LTR or not.<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @return {boolean} Whether the first character in str is an LTR char.<tr><td><a id="l322"></a><a href="#l322">322</a><td> */<tr><td><a id="l323"></a><a href="#l323">323</a><td>goog.i18n.bidi.isLtrChar = function(str) {<tr><td><a id="l324"></a><a href="#l324">324</a><td>  return goog.i18n.bidi.ltrRe_.test(str);<tr><td><a id="l325"></a><a href="#l325">325</a><td>};<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>/**<tr><td><a id="l329"></a><a href="#l329">329</a><td> * Check if the first character in the string is neutral or not.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @param {string} str The given string that need to be tested.<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @return {boolean} Whether the first character in str is a neutral char.<tr><td><a id="l332"></a><a href="#l332">332</a><td> */<tr><td><a id="l333"></a><a href="#l333">333</a><td>goog.i18n.bidi.isNeutralChar = function(str) {<tr><td><a id="l334"></a><a href="#l334">334</a><td>  return !goog.i18n.bidi.isLtrChar(str) &amp;&amp; !goog.i18n.bidi.isRtlChar(str);<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td>/**<tr><td><a id="l339"></a><a href="#l339">339</a><td> * Regular expressions to check if a piece of text is of LTR directionality<tr><td><a id="l340"></a><a href="#l340">340</a><td> * on first character with strong directionality.<tr><td><a id="l341"></a><a href="#l341">341</a><td> * @type {RegExp}<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @private<tr><td><a id="l343"></a><a href="#l343">343</a><td> */<tr><td><a id="l344"></a><a href="#l344">344</a><td>goog.i18n.bidi.ltrDirCheckRe_ = new RegExp(<tr><td><a id="l345"></a><a href="#l345">345</a><td>    &#39;^[^&#39; + goog.i18n.bidi.rtlChars_ + &#39;]*[&#39; + goog.i18n.bidi.ltrChars_ + &#39;]&#39;);<tr><td><a id="l346"></a><a href="#l346">346</a><td><tr><td><a id="l347"></a><a href="#l347">347</a><td><tr><td><a id="l348"></a><a href="#l348">348</a><td>/**<tr><td><a id="l349"></a><a href="#l349">349</a><td> * Regular expressions to check if a piece of text is of RTL directionality<tr><td><a id="l350"></a><a href="#l350">350</a><td> * on first character with strong directionality.<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @type {RegExp}<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @private<tr><td><a id="l353"></a><a href="#l353">353</a><td> */<tr><td><a id="l354"></a><a href="#l354">354</a><td>goog.i18n.bidi.rtlDirCheckRe_ = new RegExp(<tr><td><a id="l355"></a><a href="#l355">355</a><td>    &#39;^[^&#39; + goog.i18n.bidi.ltrChars_ + &#39;]*[&#39; + goog.i18n.bidi.rtlChars_ + &#39;]&#39;);<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> * Check whether the first strongly directional character (if any) is RTL.<tr><td><a id="l360"></a><a href="#l360">360</a><td> * @param {string} str String being checked.<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l362"></a><a href="#l362">362</a><td> *     Default: false.<tr><td><a id="l363"></a><a href="#l363">363</a><td> * @return {boolean} Whether RTL directionality is detected using the first<tr><td><a id="l364"></a><a href="#l364">364</a><td> *     strongly-directional character method.<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.i18n.bidi.startsWithRtl = function(str, opt_isHtml) {<tr><td><a id="l367"></a><a href="#l367">367</a><td>  return goog.i18n.bidi.rtlDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(<tr><td><a id="l368"></a><a href="#l368">368</a><td>      str, opt_isHtml));<tr><td><a id="l369"></a><a href="#l369">369</a><td>};<tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td><tr><td><a id="l372"></a><a href="#l372">372</a><td>/**<tr><td><a id="l373"></a><a href="#l373">373</a><td> * Check whether the first strongly directional character (if any) is RTL.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {string} str String being checked.<tr><td><a id="l375"></a><a href="#l375">375</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l376"></a><a href="#l376">376</a><td> *     Default: false.<tr><td><a id="l377"></a><a href="#l377">377</a><td> * @return {boolean} Whether RTL directionality is detected using the first<tr><td><a id="l378"></a><a href="#l378">378</a><td> *     strongly-directional character method.<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @deprecated Use startsWithRtl.<tr><td><a id="l380"></a><a href="#l380">380</a><td> */<tr><td><a id="l381"></a><a href="#l381">381</a><td>goog.i18n.bidi.isRtlText = goog.i18n.bidi.startsWithRtl;<tr><td><a id="l382"></a><a href="#l382">382</a><td><tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td>/**<tr><td><a id="l385"></a><a href="#l385">385</a><td> * Check whether the first strongly directional character (if any) is LTR.<tr><td><a id="l386"></a><a href="#l386">386</a><td> * @param {string} str String being checked.<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l388"></a><a href="#l388">388</a><td> *     Default: false.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @return {boolean} Whether LTR directionality is detected using the first<tr><td><a id="l390"></a><a href="#l390">390</a><td> *     strongly-directional character method.<tr><td><a id="l391"></a><a href="#l391">391</a><td> */<tr><td><a id="l392"></a><a href="#l392">392</a><td>goog.i18n.bidi.startsWithLtr = function(str, opt_isHtml) {<tr><td><a id="l393"></a><a href="#l393">393</a><td>  return goog.i18n.bidi.ltrDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(<tr><td><a id="l394"></a><a href="#l394">394</a><td>      str, opt_isHtml));<tr><td><a id="l395"></a><a href="#l395">395</a><td>};<tr><td><a id="l396"></a><a href="#l396">396</a><td><tr><td><a id="l397"></a><a href="#l397">397</a><td><tr><td><a id="l398"></a><a href="#l398">398</a><td>/**<tr><td><a id="l399"></a><a href="#l399">399</a><td> * Check whether the first strongly directional character (if any) is LTR.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @param {string} str String being checked.<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l402"></a><a href="#l402">402</a><td> *     Default: false.<tr><td><a id="l403"></a><a href="#l403">403</a><td> * @return {boolean} Whether LTR directionality is detected using the first<tr><td><a id="l404"></a><a href="#l404">404</a><td> *     strongly-directional character method.<tr><td><a id="l405"></a><a href="#l405">405</a><td> * @deprecated Use startsWithLtr.<tr><td><a id="l406"></a><a href="#l406">406</a><td> */<tr><td><a id="l407"></a><a href="#l407">407</a><td>goog.i18n.bidi.isLtrText = goog.i18n.bidi.startsWithLtr;<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> * Regular expression to check if a string looks like something that must<tr><td><a id="l412"></a><a href="#l412">412</a><td> * always be LTR even in RTL text, e.g. a URL. When estimating the<tr><td><a id="l413"></a><a href="#l413">413</a><td> * directionality of text containing these, we treat these as weakly LTR,<tr><td><a id="l414"></a><a href="#l414">414</a><td> * like numbers.<tr><td><a id="l415"></a><a href="#l415">415</a><td> * @type {RegExp}<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @private<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.i18n.bidi.isRequiredLtrRe_ = /^http:\/\/.*/;<tr><td><a id="l419"></a><a href="#l419">419</a><td><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> * Check whether the input string either contains no strongly directional<tr><td><a id="l423"></a><a href="#l423">423</a><td> * characters or looks like a url.<tr><td><a id="l424"></a><a href="#l424">424</a><td> * @param {string} str String being checked.<tr><td><a id="l425"></a><a href="#l425">425</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l426"></a><a href="#l426">426</a><td> *     Default: false.<tr><td><a id="l427"></a><a href="#l427">427</a><td> * @return {boolean} Whether neutral directionality is detected.<tr><td><a id="l428"></a><a href="#l428">428</a><td> */<tr><td><a id="l429"></a><a href="#l429">429</a><td>goog.i18n.bidi.isNeutralText = function(str, opt_isHtml) {<tr><td><a id="l430"></a><a href="#l430">430</a><td>  str = goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml);<tr><td><a id="l431"></a><a href="#l431">431</a><td>  return goog.i18n.bidi.isRequiredLtrRe_.test(str) ||<tr><td><a id="l432"></a><a href="#l432">432</a><td>      !goog.i18n.bidi.hasAnyLtr(str) &amp;&amp; !goog.i18n.bidi.hasAnyRtl(str);<tr><td><a id="l433"></a><a href="#l433">433</a><td>};<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> * Regular expressions to check if the last strongly-directional character in a<tr><td><a id="l438"></a><a href="#l438">438</a><td> * piece of text is LTR.<tr><td><a id="l439"></a><a href="#l439">439</a><td> * @type {RegExp}<tr><td><a id="l440"></a><a href="#l440">440</a><td> * @private<tr><td><a id="l441"></a><a href="#l441">441</a><td> */<tr><td><a id="l442"></a><a href="#l442">442</a><td>goog.i18n.bidi.ltrExitDirCheckRe_ = new RegExp(<tr><td><a id="l443"></a><a href="#l443">443</a><td>    &#39;[&#39; + goog.i18n.bidi.ltrChars_ + &#39;][^&#39; + goog.i18n.bidi.rtlChars_ + &#39;]*$&#39;);<tr><td><a id="l444"></a><a href="#l444">444</a><td><tr><td><a id="l445"></a><a href="#l445">445</a><td><tr><td><a id="l446"></a><a href="#l446">446</a><td>/**<tr><td><a id="l447"></a><a href="#l447">447</a><td> * Regular expressions to check if the last strongly-directional character in a<tr><td><a id="l448"></a><a href="#l448">448</a><td> * piece of text is RTL.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @type {RegExp}<tr><td><a id="l450"></a><a href="#l450">450</a><td> * @private<tr><td><a id="l451"></a><a href="#l451">451</a><td> */<tr><td><a id="l452"></a><a href="#l452">452</a><td>goog.i18n.bidi.rtlExitDirCheckRe_ = new RegExp(<tr><td><a id="l453"></a><a href="#l453">453</a><td>    &#39;[&#39; + goog.i18n.bidi.rtlChars_ + &#39;][^&#39; + goog.i18n.bidi.ltrChars_ + &#39;]*$&#39;);<tr><td><a id="l454"></a><a href="#l454">454</a><td><tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td>/**<tr><td><a id="l457"></a><a href="#l457">457</a><td> * Check if the exit directionality a piece of text is LTR, i.e. if the last<tr><td><a id="l458"></a><a href="#l458">458</a><td> * strongly-directional character in the string is LTR.<tr><td><a id="l459"></a><a href="#l459">459</a><td> * @param {string} str String being checked.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l461"></a><a href="#l461">461</a><td> *     Default: false.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @return {boolean} Whether LTR exit directionality was detected.<tr><td><a id="l463"></a><a href="#l463">463</a><td> */<tr><td><a id="l464"></a><a href="#l464">464</a><td>goog.i18n.bidi.endsWithLtr = function(str, opt_isHtml) {<tr><td><a id="l465"></a><a href="#l465">465</a><td>  return goog.i18n.bidi.ltrExitDirCheckRe_.test(<tr><td><a id="l466"></a><a href="#l466">466</a><td>      goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml));<tr><td><a id="l467"></a><a href="#l467">467</a><td>};<tr><td><a id="l468"></a><a href="#l468">468</a><td><tr><td><a id="l469"></a><a href="#l469">469</a><td><tr><td><a id="l470"></a><a href="#l470">470</a><td>/**<tr><td><a id="l471"></a><a href="#l471">471</a><td> * Check if the exit directionality a piece of text is LTR, i.e. if the last<tr><td><a id="l472"></a><a href="#l472">472</a><td> * strongly-directional character in the string is LTR.<tr><td><a id="l473"></a><a href="#l473">473</a><td> * @param {string} str String being checked.<tr><td><a id="l474"></a><a href="#l474">474</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l475"></a><a href="#l475">475</a><td> *     Default: false.<tr><td><a id="l476"></a><a href="#l476">476</a><td> * @return {boolean} Whether LTR exit directionality was detected.<tr><td><a id="l477"></a><a href="#l477">477</a><td> * @deprecated Use endsWithLtr.<tr><td><a id="l478"></a><a href="#l478">478</a><td> */<tr><td><a id="l479"></a><a href="#l479">479</a><td>goog.i18n.bidi.isLtrExitText = goog.i18n.bidi.endsWithLtr;<tr><td><a id="l480"></a><a href="#l480">480</a><td><tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td>/**<tr><td><a id="l483"></a><a href="#l483">483</a><td> * Check if the exit directionality a piece of text is RTL, i.e. if the last<tr><td><a id="l484"></a><a href="#l484">484</a><td> * strongly-directional character in the string is RTL.<tr><td><a id="l485"></a><a href="#l485">485</a><td> * @param {string} str String being checked.<tr><td><a id="l486"></a><a href="#l486">486</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l487"></a><a href="#l487">487</a><td> *     Default: false.<tr><td><a id="l488"></a><a href="#l488">488</a><td> * @return {boolean} Whether RTL exit directionality was detected.<tr><td><a id="l489"></a><a href="#l489">489</a><td> */<tr><td><a id="l490"></a><a href="#l490">490</a><td>goog.i18n.bidi.endsWithRtl = function(str, opt_isHtml) {<tr><td><a id="l491"></a><a href="#l491">491</a><td>  return goog.i18n.bidi.rtlExitDirCheckRe_.test(<tr><td><a id="l492"></a><a href="#l492">492</a><td>      goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml));<tr><td><a id="l493"></a><a href="#l493">493</a><td>};<tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td><tr><td><a id="l496"></a><a href="#l496">496</a><td>/**<tr><td><a id="l497"></a><a href="#l497">497</a><td> * Check if the exit directionality a piece of text is RTL, i.e. if the last<tr><td><a id="l498"></a><a href="#l498">498</a><td> * strongly-directional character in the string is RTL.<tr><td><a id="l499"></a><a href="#l499">499</a><td> * @param {string} str String being checked.<tr><td><a id="l500"></a><a href="#l500">500</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l501"></a><a href="#l501">501</a><td> *     Default: false.<tr><td><a id="l502"></a><a href="#l502">502</a><td> * @return {boolean} Whether RTL exit directionality was detected.<tr><td><a id="l503"></a><a href="#l503">503</a><td> * @deprecated Use endsWithRtl.<tr><td><a id="l504"></a><a href="#l504">504</a><td> */<tr><td><a id="l505"></a><a href="#l505">505</a><td>goog.i18n.bidi.isRtlExitText = goog.i18n.bidi.endsWithRtl;<tr><td><a id="l506"></a><a href="#l506">506</a><td><tr><td><a id="l507"></a><a href="#l507">507</a><td><tr><td><a id="l508"></a><a href="#l508">508</a><td>/**<tr><td><a id="l509"></a><a href="#l509">509</a><td> * A regular expression for matching right-to-left language codes.<tr><td><a id="l510"></a><a href="#l510">510</a><td> * See {@link #isRtlLanguage} for the design.<tr><td><a id="l511"></a><a href="#l511">511</a><td> * @type {RegExp}<tr><td><a id="l512"></a><a href="#l512">512</a><td> * @private<tr><td><a id="l513"></a><a href="#l513">513</a><td> */<tr><td><a id="l514"></a><a href="#l514">514</a><td>goog.i18n.bidi.rtlLocalesRe_ = new RegExp(<tr><td><a id="l515"></a><a href="#l515">515</a><td>    &#39;^(ar|ckb|dv|he|iw|fa|nqo|ps|sd|ug|ur|yi|&#39; +<tr><td><a id="l516"></a><a href="#l516">516</a><td>    &#39;.*[-_](Arab|Hebr|Thaa|Nkoo|Tfng))&#39; +<tr><td><a id="l517"></a><a href="#l517">517</a><td>    &#39;(?!.*[-_](Latn|Cyrl)($|-|_))($|-|_)&#39;,<tr><td><a id="l518"></a><a href="#l518">518</a><td>    &#39;i&#39;);<tr><td><a id="l519"></a><a href="#l519">519</a><td><tr><td><a id="l520"></a><a href="#l520">520</a><td><tr><td><a id="l521"></a><a href="#l521">521</a><td>/**<tr><td><a id="l522"></a><a href="#l522">522</a><td> * Check if a BCP 47 / III language code indicates an RTL language, i.e. either:<tr><td><a id="l523"></a><a href="#l523">523</a><td> * - a language code explicitly specifying one of the right-to-left scripts,<tr><td><a id="l524"></a><a href="#l524">524</a><td> *   e.g. &quot;az-Arab&quot;, or&lt;p&gt;<tr><td><a id="l525"></a><a href="#l525">525</a><td> * - a language code specifying one of the languages normally written in a<tr><td><a id="l526"></a><a href="#l526">526</a><td> *   right-to-left script, e.g. &quot;fa&quot; (Farsi), except ones explicitly specifying<tr><td><a id="l527"></a><a href="#l527">527</a><td> *   Latin or Cyrillic script (which are the usual LTR alternatives).&lt;p&gt;<tr><td><a id="l528"></a><a href="#l528">528</a><td> * The list of right-to-left scripts appears in the 100-199 range in<tr><td><a id="l529"></a><a href="#l529">529</a><td> * http://www.unicode.org/iso15924/iso15924-num.html, of which Arabic and<tr><td><a id="l530"></a><a href="#l530">530</a><td> * Hebrew are by far the most widely used. We also recognize Thaana, N&#39;Ko, and<tr><td><a id="l531"></a><a href="#l531">531</a><td> * Tifinagh, which also have significant modern usage. The rest (Syriac,<tr><td><a id="l532"></a><a href="#l532">532</a><td> * Samaritan, Mandaic, etc.) seem to have extremely limited or no modern usage<tr><td><a id="l533"></a><a href="#l533">533</a><td> * and are not recognized to save on code size.<tr><td><a id="l534"></a><a href="#l534">534</a><td> * The languages usually written in a right-to-left script are taken as those<tr><td><a id="l535"></a><a href="#l535">535</a><td> * with Suppress-Script: Hebr|Arab|Thaa|Nkoo|Tfng  in<tr><td><a id="l536"></a><a href="#l536">536</a><td> * http://www.iana.org/assignments/language-subtag-registry,<tr><td><a id="l537"></a><a href="#l537">537</a><td> * as well as Central (or Sorani) Kurdish (ckb), Sindhi (sd) and Uyghur (ug).<tr><td><a id="l538"></a><a href="#l538">538</a><td> * Other subtags of the language code, e.g. regions like EG (Egypt), are<tr><td><a id="l539"></a><a href="#l539">539</a><td> * ignored.<tr><td><a id="l540"></a><a href="#l540">540</a><td> * @param {string} lang BCP 47 (a.k.a III) language code.<tr><td><a id="l541"></a><a href="#l541">541</a><td> * @return {boolean} Whether the language code is an RTL language.<tr><td><a id="l542"></a><a href="#l542">542</a><td> */<tr><td><a id="l543"></a><a href="#l543">543</a><td>goog.i18n.bidi.isRtlLanguage = function(lang) {<tr><td><a id="l544"></a><a href="#l544">544</a><td>  return goog.i18n.bidi.rtlLocalesRe_.test(lang);<tr><td><a id="l545"></a><a href="#l545">545</a><td>};<tr><td><a id="l546"></a><a href="#l546">546</a><td><tr><td><a id="l547"></a><a href="#l547">547</a><td><tr><td><a id="l548"></a><a href="#l548">548</a><td>/**<tr><td><a id="l549"></a><a href="#l549">549</a><td> * Regular expression for bracket guard replacement in html.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * @type {RegExp}<tr><td><a id="l551"></a><a href="#l551">551</a><td> * @private<tr><td><a id="l552"></a><a href="#l552">552</a><td> */<tr><td><a id="l553"></a><a href="#l553">553</a><td>goog.i18n.bidi.bracketGuardHtmlRe_ =<tr><td><a id="l554"></a><a href="#l554">554</a><td>    /(\(.*?\)+)|(\[.*?\]+)|(\{.*?\}+)|(&amp;lt;.*?(&amp;gt;)+)/g;<tr><td><a id="l555"></a><a href="#l555">555</a><td><tr><td><a id="l556"></a><a href="#l556">556</a><td><tr><td><a id="l557"></a><a href="#l557">557</a><td>/**<tr><td><a id="l558"></a><a href="#l558">558</a><td> * Regular expression for bracket guard replacement in text.<tr><td><a id="l559"></a><a href="#l559">559</a><td> * @type {RegExp}<tr><td><a id="l560"></a><a href="#l560">560</a><td> * @private<tr><td><a id="l561"></a><a href="#l561">561</a><td> */<tr><td><a id="l562"></a><a href="#l562">562</a><td>goog.i18n.bidi.bracketGuardTextRe_ =<tr><td><a id="l563"></a><a href="#l563">563</a><td>    /(\(.*?\)+)|(\[.*?\]+)|(\{.*?\}+)|(&lt;.*?&gt;+)/g;<tr><td><a id="l564"></a><a href="#l564">564</a><td><tr><td><a id="l565"></a><a href="#l565">565</a><td><tr><td><a id="l566"></a><a href="#l566">566</a><td>/**<tr><td><a id="l567"></a><a href="#l567">567</a><td> * Apply bracket guard using html span tag. This is to address the problem of<tr><td><a id="l568"></a><a href="#l568">568</a><td> * messy bracket display frequently happens in RTL layout.<tr><td><a id="l569"></a><a href="#l569">569</a><td> * @param {string} s The string that need to be processed.<tr><td><a id="l570"></a><a href="#l570">570</a><td> * @param {boolean=} opt_isRtlContext specifies default direction (usually<tr><td><a id="l571"></a><a href="#l571">571</a><td> *     direction of the UI).<tr><td><a id="l572"></a><a href="#l572">572</a><td> * @return {string} The processed string, with all bracket guarded.<tr><td><a id="l573"></a><a href="#l573">573</a><td> */<tr><td><a id="l574"></a><a href="#l574">574</a><td>goog.i18n.bidi.guardBracketInHtml = function(s, opt_isRtlContext) {<tr><td><a id="l575"></a><a href="#l575">575</a><td>  var useRtl = opt_isRtlContext === undefined ?<tr><td><a id="l576"></a><a href="#l576">576</a><td>      goog.i18n.bidi.hasAnyRtl(s) : opt_isRtlContext;<tr><td><a id="l577"></a><a href="#l577">577</a><td>  if (useRtl) {<tr><td><a id="l578"></a><a href="#l578">578</a><td>    return s.replace(goog.i18n.bidi.bracketGuardHtmlRe_,<tr><td><a id="l579"></a><a href="#l579">579</a><td>        &#39;&lt;span dir=rtl&gt;$&amp;&lt;/span&gt;&#39;);<tr><td><a id="l580"></a><a href="#l580">580</a><td>  }<tr><td><a id="l581"></a><a href="#l581">581</a><td>  return s.replace(goog.i18n.bidi.bracketGuardHtmlRe_,<tr><td><a id="l582"></a><a href="#l582">582</a><td>      &#39;&lt;span dir=ltr&gt;$&amp;&lt;/span&gt;&#39;);<tr><td><a id="l583"></a><a href="#l583">583</a><td>};<tr><td><a id="l584"></a><a href="#l584">584</a><td><tr><td><a id="l585"></a><a href="#l585">585</a><td><tr><td><a id="l586"></a><a href="#l586">586</a><td>/**<tr><td><a id="l587"></a><a href="#l587">587</a><td> * Apply bracket guard using LRM and RLM. This is to address the problem of<tr><td><a id="l588"></a><a href="#l588">588</a><td> * messy bracket display frequently happens in RTL layout.<tr><td><a id="l589"></a><a href="#l589">589</a><td> * This version works for both plain text and html. But it does not work as<tr><td><a id="l590"></a><a href="#l590">590</a><td> * good as guardBracketInHtml in some cases.<tr><td><a id="l591"></a><a href="#l591">591</a><td> * @param {string} s The string that need to be processed.<tr><td><a id="l592"></a><a href="#l592">592</a><td> * @param {boolean=} opt_isRtlContext specifies default direction (usually<tr><td><a id="l593"></a><a href="#l593">593</a><td> *     direction of the UI).<tr><td><a id="l594"></a><a href="#l594">594</a><td> * @return {string} The processed string, with all bracket guarded.<tr><td><a id="l595"></a><a href="#l595">595</a><td> */<tr><td><a id="l596"></a><a href="#l596">596</a><td>goog.i18n.bidi.guardBracketInText = function(s, opt_isRtlContext) {<tr><td><a id="l597"></a><a href="#l597">597</a><td>  var useRtl = opt_isRtlContext === undefined ?<tr><td><a id="l598"></a><a href="#l598">598</a><td>      goog.i18n.bidi.hasAnyRtl(s) : opt_isRtlContext;<tr><td><a id="l599"></a><a href="#l599">599</a><td>  var mark = useRtl ? goog.i18n.bidi.Format.RLM : goog.i18n.bidi.Format.LRM;<tr><td><a id="l600"></a><a href="#l600">600</a><td>  return s.replace(goog.i18n.bidi.bracketGuardTextRe_, mark + &#39;$&amp;&#39; + mark);<tr><td><a id="l601"></a><a href="#l601">601</a><td>};<tr><td><a id="l602"></a><a href="#l602">602</a><td><tr><td><a id="l603"></a><a href="#l603">603</a><td><tr><td><a id="l604"></a><a href="#l604">604</a><td>/**<tr><td><a id="l605"></a><a href="#l605">605</a><td> * Enforce the html snippet in RTL directionality regardless overall context.<tr><td><a id="l606"></a><a href="#l606">606</a><td> * If the html piece was enclosed by tag, dir will be applied to existing<tr><td><a id="l607"></a><a href="#l607">607</a><td> * tag, otherwise a span tag will be added as wrapper. For this reason, if<tr><td><a id="l608"></a><a href="#l608">608</a><td> * html snippet start with with tag, this tag must enclose the whole piece. If<tr><td><a id="l609"></a><a href="#l609">609</a><td> * the tag already has a dir specified, this new one will override existing<tr><td><a id="l610"></a><a href="#l610">610</a><td> * one in behavior (tested on FF and IE).<tr><td><a id="l611"></a><a href="#l611">611</a><td> * @param {string} html The string that need to be processed.<tr><td><a id="l612"></a><a href="#l612">612</a><td> * @return {string} The processed string, with directionality enforced to RTL.<tr><td><a id="l613"></a><a href="#l613">613</a><td> */<tr><td><a id="l614"></a><a href="#l614">614</a><td>goog.i18n.bidi.enforceRtlInHtml = function(html) {<tr><td><a id="l615"></a><a href="#l615">615</a><td>  if (html.charAt(0) == &#39;&lt;&#39;) {<tr><td><a id="l616"></a><a href="#l616">616</a><td>    return html.replace(/&lt;\w+/, &#39;$&amp; dir=rtl&#39;);<tr><td><a id="l617"></a><a href="#l617">617</a><td>  }<tr><td><a id="l618"></a><a href="#l618">618</a><td>  // &#39;\n&#39; is important for FF so that it won&#39;t incorrectly merge span groups<tr><td><a id="l619"></a><a href="#l619">619</a><td>  return &#39;\n&lt;span dir=rtl&gt;&#39; + html + &#39;&lt;/span&gt;&#39;;<tr><td><a id="l620"></a><a href="#l620">620</a><td>};<tr><td><a id="l621"></a><a href="#l621">621</a><td><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> * Enforce RTL on both end of the given text piece using unicode BiDi formatting<tr><td><a id="l625"></a><a href="#l625">625</a><td> * characters RLE and PDF.<tr><td><a id="l626"></a><a href="#l626">626</a><td> * @param {string} text The piece of text that need to be wrapped.<tr><td><a id="l627"></a><a href="#l627">627</a><td> * @return {string} The wrapped string after process.<tr><td><a id="l628"></a><a href="#l628">628</a><td> */<tr><td><a id="l629"></a><a href="#l629">629</a><td>goog.i18n.bidi.enforceRtlInText = function(text) {<tr><td><a id="l630"></a><a href="#l630">630</a><td>  return goog.i18n.bidi.Format.RLE + text + goog.i18n.bidi.Format.PDF;<tr><td><a id="l631"></a><a href="#l631">631</a><td>};<tr><td><a id="l632"></a><a href="#l632">632</a><td><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> * Enforce the html snippet in RTL directionality regardless overall context.<tr><td><a id="l636"></a><a href="#l636">636</a><td> * If the html piece was enclosed by tag, dir will be applied to existing<tr><td><a id="l637"></a><a href="#l637">637</a><td> * tag, otherwise a span tag will be added as wrapper. For this reason, if<tr><td><a id="l638"></a><a href="#l638">638</a><td> * html snippet start with with tag, this tag must enclose the whole piece. If<tr><td><a id="l639"></a><a href="#l639">639</a><td> * the tag already has a dir specified, this new one will override existing<tr><td><a id="l640"></a><a href="#l640">640</a><td> * one in behavior (tested on FF and IE).<tr><td><a id="l641"></a><a href="#l641">641</a><td> * @param {string} html The string that need to be processed.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @return {string} The processed string, with directionality enforced to RTL.<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.i18n.bidi.enforceLtrInHtml = function(html) {<tr><td><a id="l645"></a><a href="#l645">645</a><td>  if (html.charAt(0) == &#39;&lt;&#39;) {<tr><td><a id="l646"></a><a href="#l646">646</a><td>    return html.replace(/&lt;\w+/, &#39;$&amp; dir=ltr&#39;);<tr><td><a id="l647"></a><a href="#l647">647</a><td>  }<tr><td><a id="l648"></a><a href="#l648">648</a><td>  // &#39;\n&#39; is important for FF so that it won&#39;t incorrectly merge span groups<tr><td><a id="l649"></a><a href="#l649">649</a><td>  return &#39;\n&lt;span dir=ltr&gt;&#39; + html + &#39;&lt;/span&gt;&#39;;<tr><td><a id="l650"></a><a href="#l650">650</a><td>};<tr><td><a id="l651"></a><a href="#l651">651</a><td><tr><td><a id="l652"></a><a href="#l652">652</a><td><tr><td><a id="l653"></a><a href="#l653">653</a><td>/**<tr><td><a id="l654"></a><a href="#l654">654</a><td> * Enforce LTR on both end of the given text piece using unicode BiDi formatting<tr><td><a id="l655"></a><a href="#l655">655</a><td> * characters LRE and PDF.<tr><td><a id="l656"></a><a href="#l656">656</a><td> * @param {string} text The piece of text that need to be wrapped.<tr><td><a id="l657"></a><a href="#l657">657</a><td> * @return {string} The wrapped string after process.<tr><td><a id="l658"></a><a href="#l658">658</a><td> */<tr><td><a id="l659"></a><a href="#l659">659</a><td>goog.i18n.bidi.enforceLtrInText = function(text) {<tr><td><a id="l660"></a><a href="#l660">660</a><td>  return goog.i18n.bidi.Format.LRE + text + goog.i18n.bidi.Format.PDF;<tr><td><a id="l661"></a><a href="#l661">661</a><td>};<tr><td><a id="l662"></a><a href="#l662">662</a><td><tr><td><a id="l663"></a><a href="#l663">663</a><td><tr><td><a id="l664"></a><a href="#l664">664</a><td>/**<tr><td><a id="l665"></a><a href="#l665">665</a><td> * Regular expression to find dimensions such as &quot;padding: .3 0.4ex 5px 6;&quot;<tr><td><a id="l666"></a><a href="#l666">666</a><td> * @type {RegExp}<tr><td><a id="l667"></a><a href="#l667">667</a><td> * @private<tr><td><a id="l668"></a><a href="#l668">668</a><td> */<tr><td><a id="l669"></a><a href="#l669">669</a><td>goog.i18n.bidi.dimensionsRe_ =<tr><td><a id="l670"></a><a href="#l670">670</a><td>    /:\s*([.\d][.\w]*)\s+([.\d][.\w]*)\s+([.\d][.\w]*)\s+([.\d][.\w]*)/g;<tr><td><a id="l671"></a><a href="#l671">671</a><td><tr><td><a id="l672"></a><a href="#l672">672</a><td><tr><td><a id="l673"></a><a href="#l673">673</a><td>/**<tr><td><a id="l674"></a><a href="#l674">674</a><td> * Regular expression for left.<tr><td><a id="l675"></a><a href="#l675">675</a><td> * @type {RegExp}<tr><td><a id="l676"></a><a href="#l676">676</a><td> * @private<tr><td><a id="l677"></a><a href="#l677">677</a><td> */<tr><td><a id="l678"></a><a href="#l678">678</a><td>goog.i18n.bidi.leftRe_ = /left/gi;<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>/**<tr><td><a id="l682"></a><a href="#l682">682</a><td> * Regular expression for right.<tr><td><a id="l683"></a><a href="#l683">683</a><td> * @type {RegExp}<tr><td><a id="l684"></a><a href="#l684">684</a><td> * @private<tr><td><a id="l685"></a><a href="#l685">685</a><td> */<tr><td><a id="l686"></a><a href="#l686">686</a><td>goog.i18n.bidi.rightRe_ = /right/gi;<tr><td><a id="l687"></a><a href="#l687">687</a><td><tr><td><a id="l688"></a><a href="#l688">688</a><td><tr><td><a id="l689"></a><a href="#l689">689</a><td>/**<tr><td><a id="l690"></a><a href="#l690">690</a><td> * Placeholder regular expression for swapping.<tr><td><a id="l691"></a><a href="#l691">691</a><td> * @type {RegExp}<tr><td><a id="l692"></a><a href="#l692">692</a><td> * @private<tr><td><a id="l693"></a><a href="#l693">693</a><td> */<tr><td><a id="l694"></a><a href="#l694">694</a><td>goog.i18n.bidi.tempRe_ = /%%%%/g;<tr><td><a id="l695"></a><a href="#l695">695</a><td><tr><td><a id="l696"></a><a href="#l696">696</a><td><tr><td><a id="l697"></a><a href="#l697">697</a><td>/**<tr><td><a id="l698"></a><a href="#l698">698</a><td> * Swap location parameters and &#39;left&#39;/&#39;right&#39; in CSS specification. The<tr><td><a id="l699"></a><a href="#l699">699</a><td> * processed string will be suited for RTL layout. Though this function can<tr><td><a id="l700"></a><a href="#l700">700</a><td> * cover most cases, there are always exceptions. It is suggested to put<tr><td><a id="l701"></a><a href="#l701">701</a><td> * those exceptions in separate group of CSS string.<tr><td><a id="l702"></a><a href="#l702">702</a><td> * @param {string} cssStr CSS spefication string.<tr><td><a id="l703"></a><a href="#l703">703</a><td> * @return {string} Processed CSS specification string.<tr><td><a id="l704"></a><a href="#l704">704</a><td> */<tr><td><a id="l705"></a><a href="#l705">705</a><td>goog.i18n.bidi.mirrorCSS = function(cssStr) {<tr><td><a id="l706"></a><a href="#l706">706</a><td>  return cssStr.<tr><td><a id="l707"></a><a href="#l707">707</a><td>      // reverse dimensions<tr><td><a id="l708"></a><a href="#l708">708</a><td>      replace(goog.i18n.bidi.dimensionsRe_, &#39;:$1 $4 $3 $2&#39;).<tr><td><a id="l709"></a><a href="#l709">709</a><td>      replace(goog.i18n.bidi.leftRe_, &#39;%%%%&#39;).          // swap left and right<tr><td><a id="l710"></a><a href="#l710">710</a><td>      replace(goog.i18n.bidi.rightRe_, goog.i18n.bidi.LEFT).<tr><td><a id="l711"></a><a href="#l711">711</a><td>      replace(goog.i18n.bidi.tempRe_, goog.i18n.bidi.RIGHT);<tr><td><a id="l712"></a><a href="#l712">712</a><td>};<tr><td><a id="l713"></a><a href="#l713">713</a><td><tr><td><a id="l714"></a><a href="#l714">714</a><td><tr><td><a id="l715"></a><a href="#l715">715</a><td>/**<tr><td><a id="l716"></a><a href="#l716">716</a><td> * Regular expression for hebrew double quote substitution, finding quote<tr><td><a id="l717"></a><a href="#l717">717</a><td> * directly after hebrew characters.<tr><td><a id="l718"></a><a href="#l718">718</a><td> * @type {RegExp}<tr><td><a id="l719"></a><a href="#l719">719</a><td> * @private<tr><td><a id="l720"></a><a href="#l720">720</a><td> */<tr><td><a id="l721"></a><a href="#l721">721</a><td>goog.i18n.bidi.doubleQuoteSubstituteRe_ = /([\u0591-\u05f2])&quot;/g;<tr><td><a id="l722"></a><a href="#l722">722</a><td><tr><td><a id="l723"></a><a href="#l723">723</a><td><tr><td><a id="l724"></a><a href="#l724">724</a><td>/**<tr><td><a id="l725"></a><a href="#l725">725</a><td> * Regular expression for hebrew single quote substitution, finding quote<tr><td><a id="l726"></a><a href="#l726">726</a><td> * directly after hebrew characters.<tr><td><a id="l727"></a><a href="#l727">727</a><td> * @type {RegExp}<tr><td><a id="l728"></a><a href="#l728">728</a><td> * @private<tr><td><a id="l729"></a><a href="#l729">729</a><td> */<tr><td><a id="l730"></a><a href="#l730">730</a><td>goog.i18n.bidi.singleQuoteSubstituteRe_ = /([\u0591-\u05f2])&#39;/g;<tr><td><a id="l731"></a><a href="#l731">731</a><td><tr><td><a id="l732"></a><a href="#l732">732</a><td><tr><td><a id="l733"></a><a href="#l733">733</a><td>/**<tr><td><a id="l734"></a><a href="#l734">734</a><td> * Replace the double and single quote directly after a Hebrew character with<tr><td><a id="l735"></a><a href="#l735">735</a><td> * GERESH and GERSHAYIM. In such case, most likely that&#39;s user intention.<tr><td><a id="l736"></a><a href="#l736">736</a><td> * @param {string} str String that need to be processed.<tr><td><a id="l737"></a><a href="#l737">737</a><td> * @return {string} Processed string with double/single quote replaced.<tr><td><a id="l738"></a><a href="#l738">738</a><td> */<tr><td><a id="l739"></a><a href="#l739">739</a><td>goog.i18n.bidi.normalizeHebrewQuote = function(str) {<tr><td><a id="l740"></a><a href="#l740">740</a><td>  return str.<tr><td><a id="l741"></a><a href="#l741">741</a><td>      replace(goog.i18n.bidi.doubleQuoteSubstituteRe_, &#39;$1\u05f4&#39;).<tr><td><a id="l742"></a><a href="#l742">742</a><td>      replace(goog.i18n.bidi.singleQuoteSubstituteRe_, &#39;$1\u05f3&#39;);<tr><td><a id="l743"></a><a href="#l743">743</a><td>};<tr><td><a id="l744"></a><a href="#l744">744</a><td><tr><td><a id="l745"></a><a href="#l745">745</a><td><tr><td><a id="l746"></a><a href="#l746">746</a><td>/**<tr><td><a id="l747"></a><a href="#l747">747</a><td> * Regular expression to split a string into &quot;words&quot; for directionality<tr><td><a id="l748"></a><a href="#l748">748</a><td> * estimation based on relative word counts.<tr><td><a id="l749"></a><a href="#l749">749</a><td> * @type {RegExp}<tr><td><a id="l750"></a><a href="#l750">750</a><td> * @private<tr><td><a id="l751"></a><a href="#l751">751</a><td> */<tr><td><a id="l752"></a><a href="#l752">752</a><td>goog.i18n.bidi.wordSeparatorRe_ = /\s+/;<tr><td><a id="l753"></a><a href="#l753">753</a><td><tr><td><a id="l754"></a><a href="#l754">754</a><td><tr><td><a id="l755"></a><a href="#l755">755</a><td>/**<tr><td><a id="l756"></a><a href="#l756">756</a><td> * Regular expression to check if a string contains any numerals. Used to<tr><td><a id="l757"></a><a href="#l757">757</a><td> * differentiate between completely neutral strings and those containing<tr><td><a id="l758"></a><a href="#l758">758</a><td> * numbers, which are weakly LTR.<tr><td><a id="l759"></a><a href="#l759">759</a><td> *<tr><td><a id="l760"></a><a href="#l760">760</a><td> * Native Arabic digits (\u0660 - \u0669) are not included because although they<tr><td><a id="l761"></a><a href="#l761">761</a><td> * do flow left-to-right inside a number, this is the case even if the  overall<tr><td><a id="l762"></a><a href="#l762">762</a><td> * directionality is RTL, and a mathematical expression using these digits is<tr><td><a id="l763"></a><a href="#l763">763</a><td> * supposed to flow right-to-left overall, including unary plus and minus<tr><td><a id="l764"></a><a href="#l764">764</a><td> * appearing to the right of a number, and this does depend on the overall<tr><td><a id="l765"></a><a href="#l765">765</a><td> * directionality being RTL. The digits used in Farsi (\u06F0 - \u06F9), on the<tr><td><a id="l766"></a><a href="#l766">766</a><td> * other hand, are included, since Farsi math (including unary plus and minus)<tr><td><a id="l767"></a><a href="#l767">767</a><td> * does flow left-to-right.<tr><td><a id="l768"></a><a href="#l768">768</a><td> *<tr><td><a id="l769"></a><a href="#l769">769</a><td> * @type {RegExp}<tr><td><a id="l770"></a><a href="#l770">770</a><td> * @private<tr><td><a id="l771"></a><a href="#l771">771</a><td> */<tr><td><a id="l772"></a><a href="#l772">772</a><td>goog.i18n.bidi.hasNumeralsRe_ = /[\d\u06f0-\u06f9]/;<tr><td><a id="l773"></a><a href="#l773">773</a><td><tr><td><a id="l774"></a><a href="#l774">774</a><td><tr><td><a id="l775"></a><a href="#l775">775</a><td>/**<tr><td><a id="l776"></a><a href="#l776">776</a><td> * This constant controls threshold of RTL directionality.<tr><td><a id="l777"></a><a href="#l777">777</a><td> * @type {number}<tr><td><a id="l778"></a><a href="#l778">778</a><td> * @private<tr><td><a id="l779"></a><a href="#l779">779</a><td> */<tr><td><a id="l780"></a><a href="#l780">780</a><td>goog.i18n.bidi.rtlDetectionThreshold_ = 0.40;<tr><td><a id="l781"></a><a href="#l781">781</a><td><tr><td><a id="l782"></a><a href="#l782">782</a><td><tr><td><a id="l783"></a><a href="#l783">783</a><td>/**<tr><td><a id="l784"></a><a href="#l784">784</a><td> * Estimates the directionality of a string based on relative word counts.<tr><td><a id="l785"></a><a href="#l785">785</a><td> * If the number of RTL words is above a certain percentage of the total number<tr><td><a id="l786"></a><a href="#l786">786</a><td> * of strongly directional words, returns RTL.<tr><td><a id="l787"></a><a href="#l787">787</a><td> * Otherwise, if any words are strongly or weakly LTR, returns LTR.<tr><td><a id="l788"></a><a href="#l788">788</a><td> * Otherwise, returns UNKNOWN, which is used to mean &quot;neutral&quot;.<tr><td><a id="l789"></a><a href="#l789">789</a><td> * Numbers are counted as weakly LTR.<tr><td><a id="l790"></a><a href="#l790">790</a><td> * @param {string} str The string to be checked.<tr><td><a id="l791"></a><a href="#l791">791</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l792"></a><a href="#l792">792</a><td> *     Default: false.<tr><td><a id="l793"></a><a href="#l793">793</a><td> * @return {goog.i18n.bidi.Dir} Estimated overall directionality of {@code str}.<tr><td><a id="l794"></a><a href="#l794">794</a><td> */<tr><td><a id="l795"></a><a href="#l795">795</a><td>goog.i18n.bidi.estimateDirection = function(str, opt_isHtml) {<tr><td><a id="l796"></a><a href="#l796">796</a><td>  var rtlCount = 0;<tr><td><a id="l797"></a><a href="#l797">797</a><td>  var totalCount = 0;<tr><td><a id="l798"></a><a href="#l798">798</a><td>  var hasWeaklyLtr = false;<tr><td><a id="l799"></a><a href="#l799">799</a><td>  var tokens = goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml).<tr><td><a id="l800"></a><a href="#l800">800</a><td>      split(goog.i18n.bidi.wordSeparatorRe_);<tr><td><a id="l801"></a><a href="#l801">801</a><td>  for (var i = 0; i &lt; tokens.length; i++) {<tr><td><a id="l802"></a><a href="#l802">802</a><td>    var token = tokens[i];<tr><td><a id="l803"></a><a href="#l803">803</a><td>    if (goog.i18n.bidi.startsWithRtl(token)) {<tr><td><a id="l804"></a><a href="#l804">804</a><td>      rtlCount++;<tr><td><a id="l805"></a><a href="#l805">805</a><td>      totalCount++;<tr><td><a id="l806"></a><a href="#l806">806</a><td>    } else if (goog.i18n.bidi.isRequiredLtrRe_.test(token)) {<tr><td><a id="l807"></a><a href="#l807">807</a><td>      hasWeaklyLtr = true;<tr><td><a id="l808"></a><a href="#l808">808</a><td>    } else if (goog.i18n.bidi.hasAnyLtr(token)) {<tr><td><a id="l809"></a><a href="#l809">809</a><td>      totalCount++;<tr><td><a id="l810"></a><a href="#l810">810</a><td>    } else if (goog.i18n.bidi.hasNumeralsRe_.test(token)) {<tr><td><a id="l811"></a><a href="#l811">811</a><td>      hasWeaklyLtr = true;<tr><td><a id="l812"></a><a href="#l812">812</a><td>    }<tr><td><a id="l813"></a><a href="#l813">813</a><td>  }<tr><td><a id="l814"></a><a href="#l814">814</a><td><tr><td><a id="l815"></a><a href="#l815">815</a><td>  return totalCount == 0 ?<tr><td><a id="l816"></a><a href="#l816">816</a><td>      (hasWeaklyLtr ? goog.i18n.bidi.Dir.LTR : goog.i18n.bidi.Dir.NEUTRAL) :<tr><td><a id="l817"></a><a href="#l817">817</a><td>      (rtlCount / totalCount &gt; goog.i18n.bidi.rtlDetectionThreshold_ ?<tr><td><a id="l818"></a><a href="#l818">818</a><td>          goog.i18n.bidi.Dir.RTL : goog.i18n.bidi.Dir.LTR);<tr><td><a id="l819"></a><a href="#l819">819</a><td>};<tr><td><a id="l820"></a><a href="#l820">820</a><td><tr><td><a id="l821"></a><a href="#l821">821</a><td><tr><td><a id="l822"></a><a href="#l822">822</a><td>/**<tr><td><a id="l823"></a><a href="#l823">823</a><td> * Check the directionality of a piece of text, return true if the piece of<tr><td><a id="l824"></a><a href="#l824">824</a><td> * text should be laid out in RTL direction.<tr><td><a id="l825"></a><a href="#l825">825</a><td> * @param {string} str The piece of text that need to be detected.<tr><td><a id="l826"></a><a href="#l826">826</a><td> * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.<tr><td><a id="l827"></a><a href="#l827">827</a><td> *     Default: false.<tr><td><a id="l828"></a><a href="#l828">828</a><td> * @return {boolean} Whether this piece of text should be laid out in RTL.<tr><td><a id="l829"></a><a href="#l829">829</a><td> */<tr><td><a id="l830"></a><a href="#l830">830</a><td>goog.i18n.bidi.detectRtlDirectionality = function(str, opt_isHtml) {<tr><td><a id="l831"></a><a href="#l831">831</a><td>  return goog.i18n.bidi.estimateDirection(str, opt_isHtml) ==<tr><td><a id="l832"></a><a href="#l832">832</a><td>      goog.i18n.bidi.Dir.RTL;<tr><td><a id="l833"></a><a href="#l833">833</a><td>};<tr><td><a id="l834"></a><a href="#l834">834</a><td><tr><td><a id="l835"></a><a href="#l835">835</a><td><tr><td><a id="l836"></a><a href="#l836">836</a><td>/**<tr><td><a id="l837"></a><a href="#l837">837</a><td> * Sets text input element&#39;s directionality and text alignment based on a<tr><td><a id="l838"></a><a href="#l838">838</a><td> * given directionality. Does nothing if the given directionality is unknown or<tr><td><a id="l839"></a><a href="#l839">839</a><td> * neutral.<tr><td><a id="l840"></a><a href="#l840">840</a><td> * @param {Element} element Input field element to set directionality to.<tr><td><a id="l841"></a><a href="#l841">841</a><td> * @param {goog.i18n.bidi.Dir|number|boolean|null} dir Desired directionality,<tr><td><a id="l842"></a><a href="#l842">842</a><td> *     given in one of the following formats:<tr><td><a id="l843"></a><a href="#l843">843</a><td> *     1. A goog.i18n.bidi.Dir constant.<tr><td><a id="l844"></a><a href="#l844">844</a><td> *     2. A number (positive = LRT, negative = RTL, 0 = neutral).<tr><td><a id="l845"></a><a href="#l845">845</a><td> *     3. A boolean (true = RTL, false = LTR).<tr><td><a id="l846"></a><a href="#l846">846</a><td> *     4. A null for unknown directionality.<tr><td><a id="l847"></a><a href="#l847">847</a><td> */<tr><td><a id="l848"></a><a href="#l848">848</a><td>goog.i18n.bidi.setElementDirAndAlign = function(element, dir) {<tr><td><a id="l849"></a><a href="#l849">849</a><td>  if (element) {<tr><td><a id="l850"></a><a href="#l850">850</a><td>    dir = goog.i18n.bidi.toDir(dir);<tr><td><a id="l851"></a><a href="#l851">851</a><td>    if (dir) {<tr><td><a id="l852"></a><a href="#l852">852</a><td>      element.style.textAlign =<tr><td><a id="l853"></a><a href="#l853">853</a><td>          dir == goog.i18n.bidi.Dir.RTL ?<tr><td><a id="l854"></a><a href="#l854">854</a><td>          goog.i18n.bidi.RIGHT : goog.i18n.bidi.LEFT;<tr><td><a id="l855"></a><a href="#l855">855</a><td>      element.dir = dir == goog.i18n.bidi.Dir.RTL ? &#39;rtl&#39; : &#39;ltr&#39;;<tr><td><a id="l856"></a><a href="#l856">856</a><td>    }<tr><td><a id="l857"></a><a href="#l857">857</a><td>  }<tr><td><a id="l858"></a><a href="#l858">858</a><td>};<tr><td><a id="l859"></a><a href="#l859">859</a><td><tr><td><a id="l860"></a><a href="#l860">860</a><td><tr><td><a id="l861"></a><a href="#l861">861</a><td>/**<tr><td><a id="l862"></a><a href="#l862">862</a><td> * Sets element dir based on estimated directionality of the given text.<tr><td><a id="l863"></a><a href="#l863">863</a><td> * @param {!Element} element<tr><td><a id="l864"></a><a href="#l864">864</a><td> * @param {string} text<tr><td><a id="l865"></a><a href="#l865">865</a><td> */<tr><td><a id="l866"></a><a href="#l866">866</a><td>goog.i18n.bidi.setElementDirByTextDirectionality = function(element, text) {<tr><td><a id="l867"></a><a href="#l867">867</a><td>  switch (goog.i18n.bidi.estimateDirection(text)) {<tr><td><a id="l868"></a><a href="#l868">868</a><td>    case (goog.i18n.bidi.Dir.LTR):<tr><td><a id="l869"></a><a href="#l869">869</a><td>      element.dir = &#39;ltr&#39;;<tr><td><a id="l870"></a><a href="#l870">870</a><td>      break;<tr><td><a id="l871"></a><a href="#l871">871</a><td>    case (goog.i18n.bidi.Dir.RTL):<tr><td><a id="l872"></a><a href="#l872">872</a><td>      element.dir = &#39;rtl&#39;;<tr><td><a id="l873"></a><a href="#l873">873</a><td>      break;<tr><td><a id="l874"></a><a href="#l874">874</a><td>    default:<tr><td><a id="l875"></a><a href="#l875">875</a><td>      // Default for no direction, inherit from document.<tr><td><a id="l876"></a><a href="#l876">876</a><td>      element.removeAttribute(&#39;dir&#39;);<tr><td><a id="l877"></a><a href="#l877">877</a><td>  }<tr><td><a id="l878"></a><a href="#l878">878</a><td>};<tr><td><a id="l879"></a><a href="#l879">879</a><td><tr><td><a id="l880"></a><a href="#l880">880</a><td><tr><td><a id="l881"></a><a href="#l881">881</a><td><tr><td><a id="l882"></a><a href="#l882">882</a><td>/**<tr><td><a id="l883"></a><a href="#l883">883</a><td> * Strings that have an (optional) known direction.<tr><td><a id="l884"></a><a href="#l884">884</a><td> *<tr><td><a id="l885"></a><a href="#l885">885</a><td> * Implementations of this interface are string-like objects that carry an<tr><td><a id="l886"></a><a href="#l886">886</a><td> * attached direction, if known.<tr><td><a id="l887"></a><a href="#l887">887</a><td> * @interface<tr><td><a id="l888"></a><a href="#l888">888</a><td> */<tr><td><a id="l889"></a><a href="#l889">889</a><td>goog.i18n.bidi.DirectionalString = function() {};<tr><td><a id="l890"></a><a href="#l890">890</a><td><tr><td><a id="l891"></a><a href="#l891">891</a><td><tr><td><a id="l892"></a><a href="#l892">892</a><td>/**<tr><td><a id="l893"></a><a href="#l893">893</a><td> * Interface marker of the DirectionalString interface.<tr><td><a id="l894"></a><a href="#l894">894</a><td> *<tr><td><a id="l895"></a><a href="#l895">895</a><td> * This property can be used to determine at runtime whether or not an object<tr><td><a id="l896"></a><a href="#l896">896</a><td> * implements this interface.  All implementations of this interface set this<tr><td><a id="l897"></a><a href="#l897">897</a><td> * property to {@code true}.<tr><td><a id="l898"></a><a href="#l898">898</a><td> * @type {boolean}<tr><td><a id="l899"></a><a href="#l899">899</a><td> */<tr><td><a id="l900"></a><a href="#l900">900</a><td>goog.i18n.bidi.DirectionalString.prototype.<tr><td><a id="l901"></a><a href="#l901">901</a><td>    implementsGoogI18nBidiDirectionalString;<tr><td><a id="l902"></a><a href="#l902">902</a><td><tr><td><a id="l903"></a><a href="#l903">903</a><td><tr><td><a id="l904"></a><a href="#l904">904</a><td>/**<tr><td><a id="l905"></a><a href="#l905">905</a><td> * Retrieves this object&#39;s known direction (if any).<tr><td><a id="l906"></a><a href="#l906">906</a><td> * @return {?goog.i18n.bidi.Dir} The known direction. Null if unknown.<tr><td><a id="l907"></a><a href="#l907">907</a><td> */<tr><td><a id="l908"></a><a href="#l908">908</a><td>goog.i18n.bidi.DirectionalString.prototype.getDirection;</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/iter/iter.js.src.html b/docs/source/lib/goog/iter/iter.js.src.html
index d75b9d2..88959c2 100644
--- a/docs/source/lib/goog/iter/iter.js.src.html
+++ b/docs/source/lib/goog/iter/iter.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>iter.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/iter/iter.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Python style iteration utilities.<tr><td><a name="l17" href="#l17">17</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.iter&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.iter.Iterator&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.iter.StopIteration&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td>// TODO(nnaze): Add more functions from Python&#39;s itertools.<tr><td><a name="l30" href="#l30">30</a><td>// http://docs.python.org/library/itertools.html<tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td>/**<tr><td><a name="l34" href="#l34">34</a><td> * @typedef {goog.iter.Iterator|{length:number}|{__iterator__}}<tr><td><a name="l35" href="#l35">35</a><td> */<tr><td><a name="l36" href="#l36">36</a><td>goog.iter.Iterable;<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>// For script engines that already support iterators.<tr><td><a name="l40" href="#l40">40</a><td>if (&#39;StopIteration&#39; in goog.global) {<tr><td><a name="l41" href="#l41">41</a><td>  /**<tr><td><a name="l42" href="#l42">42</a><td>   * Singleton Error object that is used to terminate iterations.<tr><td><a name="l43" href="#l43">43</a><td>   * @type {Error}<tr><td><a name="l44" href="#l44">44</a><td>   */<tr><td><a name="l45" href="#l45">45</a><td>  goog.iter.StopIteration = goog.global[&#39;StopIteration&#39;];<tr><td><a name="l46" href="#l46">46</a><td>} else {<tr><td><a name="l47" href="#l47">47</a><td>  /**<tr><td><a name="l48" href="#l48">48</a><td>   * Singleton Error object that is used to terminate iterations.<tr><td><a name="l49" href="#l49">49</a><td>   * @type {Error}<tr><td><a name="l50" href="#l50">50</a><td>   * @suppress {duplicate}<tr><td><a name="l51" href="#l51">51</a><td>   */<tr><td><a name="l52" href="#l52">52</a><td>  goog.iter.StopIteration = Error(&#39;StopIteration&#39;);<tr><td><a name="l53" href="#l53">53</a><td>}<tr><td><a name="l54" href="#l54">54</a><td><tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td>/**<tr><td><a name="l58" href="#l58">58</a><td> * Class/interface for iterators.  An iterator needs to implement a {@code next}<tr><td><a name="l59" href="#l59">59</a><td> * method and it needs to throw a {@code goog.iter.StopIteration} when the<tr><td><a name="l60" href="#l60">60</a><td> * iteration passes beyond the end.  Iterators have no {@code hasNext} method.<tr><td><a name="l61" href="#l61">61</a><td> * It is recommended to always use the helper functions to iterate over the<tr><td><a name="l62" href="#l62">62</a><td> * iterator or in case you are only targeting JavaScript 1.7 for in loops.<tr><td><a name="l63" href="#l63">63</a><td> * @constructor<tr><td><a name="l64" href="#l64">64</a><td> */<tr><td><a name="l65" href="#l65">65</a><td>goog.iter.Iterator = function() {};<tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td>/**<tr><td><a name="l69" href="#l69">69</a><td> * Returns the next value of the iteration.  This will throw the object<tr><td><a name="l70" href="#l70">70</a><td> * {@see goog.iter#StopIteration} when the iteration passes the end.<tr><td><a name="l71" href="#l71">71</a><td> * @return {*} Any object or value.<tr><td><a name="l72" href="#l72">72</a><td> */<tr><td><a name="l73" href="#l73">73</a><td>goog.iter.Iterator.prototype.next = function() {<tr><td><a name="l74" href="#l74">74</a><td>  throw goog.iter.StopIteration;<tr><td><a name="l75" href="#l75">75</a><td>};<tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td><tr><td><a name="l78" href="#l78">78</a><td>/**<tr><td><a name="l79" href="#l79">79</a><td> * Returns the {@code Iterator} object itself.  This is used to implement<tr><td><a name="l80" href="#l80">80</a><td> * the iterator protocol in JavaScript 1.7<tr><td><a name="l81" href="#l81">81</a><td> * @param {boolean=} opt_keys  Whether to return the keys or values. Default is<tr><td><a name="l82" href="#l82">82</a><td> *     to only return the values.  This is being used by the for-in loop (true)<tr><td><a name="l83" href="#l83">83</a><td> *     and the for-each-in loop (false).  Even though the param gives a hint<tr><td><a name="l84" href="#l84">84</a><td> *     about what the iterator will return there is no guarantee that it will<tr><td><a name="l85" href="#l85">85</a><td> *     return the keys when true is passed.<tr><td><a name="l86" href="#l86">86</a><td> * @return {!goog.iter.Iterator} The object itself.<tr><td><a name="l87" href="#l87">87</a><td> */<tr><td><a name="l88" href="#l88">88</a><td>goog.iter.Iterator.prototype.__iterator__ = function(opt_keys) {<tr><td><a name="l89" href="#l89">89</a><td>  return this;<tr><td><a name="l90" href="#l90">90</a><td>};<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>/**<tr><td><a name="l94" href="#l94">94</a><td> * Returns an iterator that knows how to iterate over the values in the object.<tr><td><a name="l95" href="#l95">95</a><td> * @param {goog.iter.Iterable} iterable  If the object is an iterator it<tr><td><a name="l96" href="#l96">96</a><td> *     will be returned as is.  If the object has a {@code __iterator__} method<tr><td><a name="l97" href="#l97">97</a><td> *     that will be called to get the value iterator.  If the object is an<tr><td><a name="l98" href="#l98">98</a><td> *     array-like object we create an iterator for that.<tr><td><a name="l99" href="#l99">99</a><td> * @return {!goog.iter.Iterator} An iterator that knows how to iterate over the<tr><td><a name="l100" href="#l100">100</a><td> *     values in {@code iterable}.<tr><td><a name="l101" href="#l101">101</a><td> */<tr><td><a name="l102" href="#l102">102</a><td>goog.iter.toIterator = function(iterable) {<tr><td><a name="l103" href="#l103">103</a><td>  if (iterable instanceof goog.iter.Iterator) {<tr><td><a name="l104" href="#l104">104</a><td>    return iterable;<tr><td><a name="l105" href="#l105">105</a><td>  }<tr><td><a name="l106" href="#l106">106</a><td>  if (typeof iterable.__iterator__ == &#39;function&#39;) {<tr><td><a name="l107" href="#l107">107</a><td>    return iterable.__iterator__(false);<tr><td><a name="l108" href="#l108">108</a><td>  }<tr><td><a name="l109" href="#l109">109</a><td>  if (goog.isArrayLike(iterable)) {<tr><td><a name="l110" href="#l110">110</a><td>    var i = 0;<tr><td><a name="l111" href="#l111">111</a><td>    var newIter = new goog.iter.Iterator;<tr><td><a name="l112" href="#l112">112</a><td>    newIter.next = function() {<tr><td><a name="l113" href="#l113">113</a><td>      while (true) {<tr><td><a name="l114" href="#l114">114</a><td>        if (i &gt;= iterable.length) {<tr><td><a name="l115" href="#l115">115</a><td>          throw goog.iter.StopIteration;<tr><td><a name="l116" href="#l116">116</a><td>        }<tr><td><a name="l117" href="#l117">117</a><td>        // Don&#39;t include deleted elements.<tr><td><a name="l118" href="#l118">118</a><td>        if (!(i in iterable)) {<tr><td><a name="l119" href="#l119">119</a><td>          i++;<tr><td><a name="l120" href="#l120">120</a><td>          continue;<tr><td><a name="l121" href="#l121">121</a><td>        }<tr><td><a name="l122" href="#l122">122</a><td>        return iterable[i++];<tr><td><a name="l123" href="#l123">123</a><td>      }<tr><td><a name="l124" href="#l124">124</a><td>    };<tr><td><a name="l125" href="#l125">125</a><td>    return newIter;<tr><td><a name="l126" href="#l126">126</a><td>  }<tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td>  // TODO(arv): Should we fall back on goog.structs.getValues()?<tr><td><a name="l130" href="#l130">130</a><td>  throw Error(&#39;Not implemented&#39;);<tr><td><a name="l131" href="#l131">131</a><td>};<tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td>/**<tr><td><a name="l135" href="#l135">135</a><td> * Calls a function for each element in the iterator with the element of the<tr><td><a name="l136" href="#l136">136</a><td> * iterator passed as argument.<tr><td><a name="l137" href="#l137">137</a><td> *<tr><td><a name="l138" href="#l138">138</a><td> * @param {goog.iter.Iterable} iterable  The iterator to iterate<tr><td><a name="l139" href="#l139">139</a><td> *     over.  If the iterable is an object {@code toIterator} will be called on<tr><td><a name="l140" href="#l140">140</a><td> *     it.<tr><td><a name="l141" href="#l141">141</a><td>* @param {function(this:T,?,?,?):?} f  The function to call for every<tr><td><a name="l142" href="#l142">142</a><td> *     element.  This function<tr><td><a name="l143" href="#l143">143</a><td> *     takes 3 arguments (the element, undefined, and the iterator) and the<tr><td><a name="l144" href="#l144">144</a><td> *     return value is irrelevant.  The reason for passing undefined as the<tr><td><a name="l145" href="#l145">145</a><td> *     second argument is so that the same function can be used in<tr><td><a name="l146" href="#l146">146</a><td> *     {@see goog.array#forEach} as well as others.<tr><td><a name="l147" href="#l147">147</a><td> * @param {T=} opt_obj  The object to be used as the value of &#39;this&#39; within<tr><td><a name="l148" href="#l148">148</a><td> *     {@code f}.<tr><td><a name="l149" href="#l149">149</a><td> * @template T<tr><td><a name="l150" href="#l150">150</a><td> */<tr><td><a name="l151" href="#l151">151</a><td>goog.iter.forEach = function(iterable, f, opt_obj) {<tr><td><a name="l152" href="#l152">152</a><td>  if (goog.isArrayLike(iterable)) {<tr><td><a name="l153" href="#l153">153</a><td>    /** @preserveTry */<tr><td><a name="l154" href="#l154">154</a><td>    try {<tr><td><a name="l155" href="#l155">155</a><td>      // NOTES: this passes the index number to the second parameter<tr><td><a name="l156" href="#l156">156</a><td>      // of the callback contrary to the documentation above.<tr><td><a name="l157" href="#l157">157</a><td>      goog.array.forEach(/** @type {goog.array.ArrayLike} */(iterable), f,<tr><td><a name="l158" href="#l158">158</a><td>                         opt_obj);<tr><td><a name="l159" href="#l159">159</a><td>    } catch (ex) {<tr><td><a name="l160" href="#l160">160</a><td>      if (ex !== goog.iter.StopIteration) {<tr><td><a name="l161" href="#l161">161</a><td>        throw ex;<tr><td><a name="l162" href="#l162">162</a><td>      }<tr><td><a name="l163" href="#l163">163</a><td>    }<tr><td><a name="l164" href="#l164">164</a><td>  } else {<tr><td><a name="l165" href="#l165">165</a><td>    iterable = goog.iter.toIterator(iterable);<tr><td><a name="l166" href="#l166">166</a><td>    /** @preserveTry */<tr><td><a name="l167" href="#l167">167</a><td>    try {<tr><td><a name="l168" href="#l168">168</a><td>      while (true) {<tr><td><a name="l169" href="#l169">169</a><td>        f.call(opt_obj, iterable.next(), undefined, iterable);<tr><td><a name="l170" href="#l170">170</a><td>      }<tr><td><a name="l171" href="#l171">171</a><td>    } catch (ex) {<tr><td><a name="l172" href="#l172">172</a><td>      if (ex !== goog.iter.StopIteration) {<tr><td><a name="l173" href="#l173">173</a><td>        throw ex;<tr><td><a name="l174" href="#l174">174</a><td>      }<tr><td><a name="l175" href="#l175">175</a><td>    }<tr><td><a name="l176" href="#l176">176</a><td>  }<tr><td><a name="l177" href="#l177">177</a><td>};<tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td>/**<tr><td><a name="l181" href="#l181">181</a><td> * Calls a function for every element in the iterator, and if the function<tr><td><a name="l182" href="#l182">182</a><td> * returns true adds the element to a new iterator.<tr><td><a name="l183" href="#l183">183</a><td> *<tr><td><a name="l184" href="#l184">184</a><td> * @param {goog.iter.Iterable} iterable The iterator to iterate over.<tr><td><a name="l185" href="#l185">185</a><td> * @param {function(this:T,?,undefined,?):boolean} f The function to call for<tr><td><a name="l186" href="#l186">186</a><td> *     every element. This function<tr><td><a name="l187" href="#l187">187</a><td> *     takes 3 arguments (the element, undefined, and the iterator) and should<tr><td><a name="l188" href="#l188">188</a><td> *     return a boolean.  If the return value is true the element will be<tr><td><a name="l189" href="#l189">189</a><td> *     included  in the returned iteror.  If it is false the element is not<tr><td><a name="l190" href="#l190">190</a><td> *     included.<tr><td><a name="l191" href="#l191">191</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a name="l192" href="#l192">192</a><td> *     {@code f}.<tr><td><a name="l193" href="#l193">193</a><td> * @return {!goog.iter.Iterator} A new iterator in which only elements that<tr><td><a name="l194" href="#l194">194</a><td> *     passed the test are present.<tr><td><a name="l195" href="#l195">195</a><td> * @template T<tr><td><a name="l196" href="#l196">196</a><td> */<tr><td><a name="l197" href="#l197">197</a><td>goog.iter.filter = function(iterable, f, opt_obj) {<tr><td><a name="l198" href="#l198">198</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a name="l199" href="#l199">199</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a name="l200" href="#l200">200</a><td>  newIter.next = function() {<tr><td><a name="l201" href="#l201">201</a><td>    while (true) {<tr><td><a name="l202" href="#l202">202</a><td>      var val = iterator.next();<tr><td><a name="l203" href="#l203">203</a><td>      if (f.call(opt_obj, val, undefined, iterator)) {<tr><td><a name="l204" href="#l204">204</a><td>        return val;<tr><td><a name="l205" href="#l205">205</a><td>      }<tr><td><a name="l206" href="#l206">206</a><td>    }<tr><td><a name="l207" href="#l207">207</a><td>  };<tr><td><a name="l208" href="#l208">208</a><td>  return newIter;<tr><td><a name="l209" href="#l209">209</a><td>};<tr><td><a name="l210" href="#l210">210</a><td><tr><td><a name="l211" href="#l211">211</a><td><tr><td><a name="l212" href="#l212">212</a><td>/**<tr><td><a name="l213" href="#l213">213</a><td> * Creates a new iterator that returns the values in a range.  This function<tr><td><a name="l214" href="#l214">214</a><td> * can take 1, 2 or 3 arguments:<tr><td><a name="l215" href="#l215">215</a><td> * &lt;pre&gt;<tr><td><a name="l216" href="#l216">216</a><td> * range(5) same as range(0, 5, 1)<tr><td><a name="l217" href="#l217">217</a><td> * range(2, 5) same as range(2, 5, 1)<tr><td><a name="l218" href="#l218">218</a><td> * &lt;/pre&gt;<tr><td><a name="l219" href="#l219">219</a><td> *<tr><td><a name="l220" href="#l220">220</a><td> * @param {number} startOrStop  The stop value if only one argument is provided.<tr><td><a name="l221" href="#l221">221</a><td> *     The start value if 2 or more arguments are provided.  If only one<tr><td><a name="l222" href="#l222">222</a><td> *     argument is used the start value is 0.<tr><td><a name="l223" href="#l223">223</a><td> * @param {number=} opt_stop  The stop value.  If left out then the first<tr><td><a name="l224" href="#l224">224</a><td> *     argument is used as the stop value.<tr><td><a name="l225" href="#l225">225</a><td> * @param {number=} opt_step  The number to increment with between each call to<tr><td><a name="l226" href="#l226">226</a><td> *     next.  This can be negative.<tr><td><a name="l227" href="#l227">227</a><td> * @return {!goog.iter.Iterator} A new iterator that returns the values in the<tr><td><a name="l228" href="#l228">228</a><td> *     range.<tr><td><a name="l229" href="#l229">229</a><td> */<tr><td><a name="l230" href="#l230">230</a><td>goog.iter.range = function(startOrStop, opt_stop, opt_step) {<tr><td><a name="l231" href="#l231">231</a><td>  var start = 0;<tr><td><a name="l232" href="#l232">232</a><td>  var stop = startOrStop;<tr><td><a name="l233" href="#l233">233</a><td>  var step = opt_step || 1;<tr><td><a name="l234" href="#l234">234</a><td>  if (arguments.length &gt; 1) {<tr><td><a name="l235" href="#l235">235</a><td>    start = startOrStop;<tr><td><a name="l236" href="#l236">236</a><td>    stop = opt_stop;<tr><td><a name="l237" href="#l237">237</a><td>  }<tr><td><a name="l238" href="#l238">238</a><td>  if (step == 0) {<tr><td><a name="l239" href="#l239">239</a><td>    throw Error(&#39;Range step argument must not be zero&#39;);<tr><td><a name="l240" href="#l240">240</a><td>  }<tr><td><a name="l241" href="#l241">241</a><td><tr><td><a name="l242" href="#l242">242</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a name="l243" href="#l243">243</a><td>  newIter.next = function() {<tr><td><a name="l244" href="#l244">244</a><td>    if (step &gt; 0 &amp;&amp; start &gt;= stop || step &lt; 0 &amp;&amp; start &lt;= stop) {<tr><td><a name="l245" href="#l245">245</a><td>      throw goog.iter.StopIteration;<tr><td><a name="l246" href="#l246">246</a><td>    }<tr><td><a name="l247" href="#l247">247</a><td>    var rv = start;<tr><td><a name="l248" href="#l248">248</a><td>    start += step;<tr><td><a name="l249" href="#l249">249</a><td>    return rv;<tr><td><a name="l250" href="#l250">250</a><td>  };<tr><td><a name="l251" href="#l251">251</a><td>  return newIter;<tr><td><a name="l252" href="#l252">252</a><td>};<tr><td><a name="l253" href="#l253">253</a><td><tr><td><a name="l254" href="#l254">254</a><td><tr><td><a name="l255" href="#l255">255</a><td>/**<tr><td><a name="l256" href="#l256">256</a><td> * Joins the values in a iterator with a delimiter.<tr><td><a name="l257" href="#l257">257</a><td> * @param {goog.iter.Iterable} iterable  The iterator to get the values from.<tr><td><a name="l258" href="#l258">258</a><td> * @param {string} deliminator  The text to put between the values.<tr><td><a name="l259" href="#l259">259</a><td> * @return {string} The joined value string.<tr><td><a name="l260" href="#l260">260</a><td> */<tr><td><a name="l261" href="#l261">261</a><td>goog.iter.join = function(iterable, deliminator) {<tr><td><a name="l262" href="#l262">262</a><td>  return goog.iter.toArray(iterable).join(deliminator);<tr><td><a name="l263" href="#l263">263</a><td>};<tr><td><a name="l264" href="#l264">264</a><td><tr><td><a name="l265" href="#l265">265</a><td><tr><td><a name="l266" href="#l266">266</a><td>/**<tr><td><a name="l267" href="#l267">267</a><td> * For every element in the iterator call a function and return a new iterator<tr><td><a name="l268" href="#l268">268</a><td> * with that value.<tr><td><a name="l269" href="#l269">269</a><td> *<tr><td><a name="l270" href="#l270">270</a><td> * @param {goog.iter.Iterable} iterable The iterator to iterate over.<tr><td><a name="l271" href="#l271">271</a><td> * @param {function(this:T,?,undefined,?):?} f The function to call for every<tr><td><a name="l272" href="#l272">272</a><td> *     element.  This function<tr><td><a name="l273" href="#l273">273</a><td> *     takes 3 arguments (the element, undefined, and the iterator) and should<tr><td><a name="l274" href="#l274">274</a><td> *     return a new value.<tr><td><a name="l275" href="#l275">275</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a name="l276" href="#l276">276</a><td> *     {@code f}.<tr><td><a name="l277" href="#l277">277</a><td> * @return {!goog.iter.Iterator} A new iterator that returns the results of<tr><td><a name="l278" href="#l278">278</a><td> *     applying the function to each element in the original iterator.<tr><td><a name="l279" href="#l279">279</a><td> * @template T<tr><td><a name="l280" href="#l280">280</a><td> */<tr><td><a name="l281" href="#l281">281</a><td>goog.iter.map = function(iterable, f, opt_obj) {<tr><td><a name="l282" href="#l282">282</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a name="l283" href="#l283">283</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a name="l284" href="#l284">284</a><td>  newIter.next = function() {<tr><td><a name="l285" href="#l285">285</a><td>    while (true) {<tr><td><a name="l286" href="#l286">286</a><td>      var val = iterator.next();<tr><td><a name="l287" href="#l287">287</a><td>      return f.call(opt_obj, val, undefined, iterator);<tr><td><a name="l288" href="#l288">288</a><td>    }<tr><td><a name="l289" href="#l289">289</a><td>  };<tr><td><a name="l290" href="#l290">290</a><td>  return newIter;<tr><td><a name="l291" href="#l291">291</a><td>};<tr><td><a name="l292" href="#l292">292</a><td><tr><td><a name="l293" href="#l293">293</a><td><tr><td><a name="l294" href="#l294">294</a><td>/**<tr><td><a name="l295" href="#l295">295</a><td> * Passes every element of an iterator into a function and accumulates the<tr><td><a name="l296" href="#l296">296</a><td> * result.<tr><td><a name="l297" href="#l297">297</a><td> *<tr><td><a name="l298" href="#l298">298</a><td> * @param {goog.iter.Iterable} iterable The iterator to iterate over.<tr><td><a name="l299" href="#l299">299</a><td> * @param {function(this:T,V,?):V} f The function to call for every<tr><td><a name="l300" href="#l300">300</a><td> *     element. This function takes 2 arguments (the function&#39;s previous result<tr><td><a name="l301" href="#l301">301</a><td> *     or the initial value, and the value of the current element).<tr><td><a name="l302" href="#l302">302</a><td> *     function(previousValue, currentElement) : newValue.<tr><td><a name="l303" href="#l303">303</a><td> * @param {V} val The initial value to pass into the function on the first call.<tr><td><a name="l304" href="#l304">304</a><td> * @param {T=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a name="l305" href="#l305">305</a><td> *     within f.<tr><td><a name="l306" href="#l306">306</a><td> * @return {V} Result of evaluating f repeatedly across the values of<tr><td><a name="l307" href="#l307">307</a><td> *     the iterator.<tr><td><a name="l308" href="#l308">308</a><td> * @template T,V<tr><td><a name="l309" href="#l309">309</a><td> */<tr><td><a name="l310" href="#l310">310</a><td>goog.iter.reduce = function(iterable, f, val, opt_obj) {<tr><td><a name="l311" href="#l311">311</a><td>  var rval = val;<tr><td><a name="l312" href="#l312">312</a><td>  goog.iter.forEach(iterable, function(val) {<tr><td><a name="l313" href="#l313">313</a><td>    rval = f.call(opt_obj, rval, val);<tr><td><a name="l314" href="#l314">314</a><td>  });<tr><td><a name="l315" href="#l315">315</a><td>  return rval;<tr><td><a name="l316" href="#l316">316</a><td>};<tr><td><a name="l317" href="#l317">317</a><td><tr><td><a name="l318" href="#l318">318</a><td><tr><td><a name="l319" href="#l319">319</a><td>/**<tr><td><a name="l320" href="#l320">320</a><td> * Goes through the values in the iterator. Calls f for each these and if any of<tr><td><a name="l321" href="#l321">321</a><td> * them returns true, this returns true (without checking the rest). If all<tr><td><a name="l322" href="#l322">322</a><td> * return false this will return false.<tr><td><a name="l323" href="#l323">323</a><td> *<tr><td><a name="l324" href="#l324">324</a><td> * @param {goog.iter.Iterable} iterable  The iterator object.<tr><td><a name="l325" href="#l325">325</a><td> * @param {function(this:T,?,undefined,?):boolean} f  The function to call for<tr><td><a name="l326" href="#l326">326</a><td> *     every value. This function<tr><td><a name="l327" href="#l327">327</a><td> *     takes 3 arguments (the value, undefined, and the iterator) and should<tr><td><a name="l328" href="#l328">328</a><td> *     return a boolean.<tr><td><a name="l329" href="#l329">329</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a name="l330" href="#l330">330</a><td> *     {@code f}.<tr><td><a name="l331" href="#l331">331</a><td> * @return {boolean} true if any value passes the test.<tr><td><a name="l332" href="#l332">332</a><td> * @template T<tr><td><a name="l333" href="#l333">333</a><td> */<tr><td><a name="l334" href="#l334">334</a><td>goog.iter.some = function(iterable, f, opt_obj) {<tr><td><a name="l335" href="#l335">335</a><td>  iterable = goog.iter.toIterator(iterable);<tr><td><a name="l336" href="#l336">336</a><td>  /** @preserveTry */<tr><td><a name="l337" href="#l337">337</a><td>  try {<tr><td><a name="l338" href="#l338">338</a><td>    while (true) {<tr><td><a name="l339" href="#l339">339</a><td>      if (f.call(opt_obj, iterable.next(), undefined, iterable)) {<tr><td><a name="l340" href="#l340">340</a><td>        return true;<tr><td><a name="l341" href="#l341">341</a><td>      }<tr><td><a name="l342" href="#l342">342</a><td>    }<tr><td><a name="l343" href="#l343">343</a><td>  } catch (ex) {<tr><td><a name="l344" href="#l344">344</a><td>    if (ex !== goog.iter.StopIteration) {<tr><td><a name="l345" href="#l345">345</a><td>      throw ex;<tr><td><a name="l346" href="#l346">346</a><td>    }<tr><td><a name="l347" href="#l347">347</a><td>  }<tr><td><a name="l348" href="#l348">348</a><td>  return false;<tr><td><a name="l349" href="#l349">349</a><td>};<tr><td><a name="l350" href="#l350">350</a><td><tr><td><a name="l351" href="#l351">351</a><td><tr><td><a name="l352" href="#l352">352</a><td>/**<tr><td><a name="l353" href="#l353">353</a><td> * Goes through the values in the iterator. Calls f for each these and if any of<tr><td><a name="l354" href="#l354">354</a><td> * them returns false this returns false (without checking the rest). If all<tr><td><a name="l355" href="#l355">355</a><td> * return true this will return true.<tr><td><a name="l356" href="#l356">356</a><td> *<tr><td><a name="l357" href="#l357">357</a><td> * @param {goog.iter.Iterable} iterable  The iterator object.<tr><td><a name="l358" href="#l358">358</a><td> * @param {function(this:T,?,undefined,?):boolean} f  The function to call for<tr><td><a name="l359" href="#l359">359</a><td> *     every value. This function<tr><td><a name="l360" href="#l360">360</a><td> *     takes 3 arguments (the value, undefined, and the iterator) and should<tr><td><a name="l361" href="#l361">361</a><td> *     return a boolean.<tr><td><a name="l362" href="#l362">362</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a name="l363" href="#l363">363</a><td> *     {@code f}.<tr><td><a name="l364" href="#l364">364</a><td> * @return {boolean} true if every value passes the test.<tr><td><a name="l365" href="#l365">365</a><td> * @template T<tr><td><a name="l366" href="#l366">366</a><td> */<tr><td><a name="l367" href="#l367">367</a><td>goog.iter.every = function(iterable, f, opt_obj) {<tr><td><a name="l368" href="#l368">368</a><td>  iterable = goog.iter.toIterator(iterable);<tr><td><a name="l369" href="#l369">369</a><td>  /** @preserveTry */<tr><td><a name="l370" href="#l370">370</a><td>  try {<tr><td><a name="l371" href="#l371">371</a><td>    while (true) {<tr><td><a name="l372" href="#l372">372</a><td>      if (!f.call(opt_obj, iterable.next(), undefined, iterable)) {<tr><td><a name="l373" href="#l373">373</a><td>        return false;<tr><td><a name="l374" href="#l374">374</a><td>      }<tr><td><a name="l375" href="#l375">375</a><td>    }<tr><td><a name="l376" href="#l376">376</a><td>  } catch (ex) {<tr><td><a name="l377" href="#l377">377</a><td>    if (ex !== goog.iter.StopIteration) {<tr><td><a name="l378" href="#l378">378</a><td>      throw ex;<tr><td><a name="l379" href="#l379">379</a><td>    }<tr><td><a name="l380" href="#l380">380</a><td>  }<tr><td><a name="l381" href="#l381">381</a><td>  return true;<tr><td><a name="l382" href="#l382">382</a><td>};<tr><td><a name="l383" href="#l383">383</a><td><tr><td><a name="l384" href="#l384">384</a><td><tr><td><a name="l385" href="#l385">385</a><td>/**<tr><td><a name="l386" href="#l386">386</a><td> * Takes zero or more iterators and returns one iterator that will iterate over<tr><td><a name="l387" href="#l387">387</a><td> * them in the order chained.<tr><td><a name="l388" href="#l388">388</a><td> * @param {...goog.iter.Iterator} var_args  Any number of iterator objects.<tr><td><a name="l389" href="#l389">389</a><td> * @return {!goog.iter.Iterator} Returns a new iterator that will iterate over<tr><td><a name="l390" href="#l390">390</a><td> *     all the given iterators&#39; contents.<tr><td><a name="l391" href="#l391">391</a><td> */<tr><td><a name="l392" href="#l392">392</a><td>goog.iter.chain = function(var_args) {<tr><td><a name="l393" href="#l393">393</a><td>  var args = arguments;<tr><td><a name="l394" href="#l394">394</a><td>  var length = args.length;<tr><td><a name="l395" href="#l395">395</a><td>  var i = 0;<tr><td><a name="l396" href="#l396">396</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a name="l397" href="#l397">397</a><td><tr><td><a name="l398" href="#l398">398</a><td>  /**<tr><td><a name="l399" href="#l399">399</a><td>   * @return {*} The next item in the iteration.<tr><td><a name="l400" href="#l400">400</a><td>   * @this {goog.iter.Iterator}<tr><td><a name="l401" href="#l401">401</a><td>   */<tr><td><a name="l402" href="#l402">402</a><td>  newIter.next = function() {<tr><td><a name="l403" href="#l403">403</a><td>    /** @preserveTry */<tr><td><a name="l404" href="#l404">404</a><td>    try {<tr><td><a name="l405" href="#l405">405</a><td>      if (i &gt;= length) {<tr><td><a name="l406" href="#l406">406</a><td>        throw goog.iter.StopIteration;<tr><td><a name="l407" href="#l407">407</a><td>      }<tr><td><a name="l408" href="#l408">408</a><td>      var current = goog.iter.toIterator(args[i]);<tr><td><a name="l409" href="#l409">409</a><td>      return current.next();<tr><td><a name="l410" href="#l410">410</a><td>    } catch (ex) {<tr><td><a name="l411" href="#l411">411</a><td>      if (ex !== goog.iter.StopIteration || i &gt;= length) {<tr><td><a name="l412" href="#l412">412</a><td>        throw ex;<tr><td><a name="l413" href="#l413">413</a><td>      } else {<tr><td><a name="l414" href="#l414">414</a><td>        // In case we got a StopIteration increment counter and try again.<tr><td><a name="l415" href="#l415">415</a><td>        i++;<tr><td><a name="l416" href="#l416">416</a><td>        return this.next();<tr><td><a name="l417" href="#l417">417</a><td>      }<tr><td><a name="l418" href="#l418">418</a><td>    }<tr><td><a name="l419" href="#l419">419</a><td>  };<tr><td><a name="l420" href="#l420">420</a><td><tr><td><a name="l421" href="#l421">421</a><td>  return newIter;<tr><td><a name="l422" href="#l422">422</a><td>};<tr><td><a name="l423" href="#l423">423</a><td><tr><td><a name="l424" href="#l424">424</a><td><tr><td><a name="l425" href="#l425">425</a><td>/**<tr><td><a name="l426" href="#l426">426</a><td> * Builds a new iterator that iterates over the original, but skips elements as<tr><td><a name="l427" href="#l427">427</a><td> * long as a supplied function returns true.<tr><td><a name="l428" href="#l428">428</a><td> * @param {goog.iter.Iterable} iterable  The iterator object.<tr><td><a name="l429" href="#l429">429</a><td> * @param {function(this:T,?,undefined,?):boolean} f  The function to call for<tr><td><a name="l430" href="#l430">430</a><td> *     every value. This function<tr><td><a name="l431" href="#l431">431</a><td> *     takes 3 arguments (the value, undefined, and the iterator) and should<tr><td><a name="l432" href="#l432">432</a><td> *     return a boolean.<tr><td><a name="l433" href="#l433">433</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a name="l434" href="#l434">434</a><td> *     {@code f}.<tr><td><a name="l435" href="#l435">435</a><td> * @return {!goog.iter.Iterator} A new iterator that drops elements from the<tr><td><a name="l436" href="#l436">436</a><td> *     original iterator as long as {@code f} is true.<tr><td><a name="l437" href="#l437">437</a><td> * @template T<tr><td><a name="l438" href="#l438">438</a><td> */<tr><td><a name="l439" href="#l439">439</a><td>goog.iter.dropWhile = function(iterable, f, opt_obj) {<tr><td><a name="l440" href="#l440">440</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a name="l441" href="#l441">441</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a name="l442" href="#l442">442</a><td>  var dropping = true;<tr><td><a name="l443" href="#l443">443</a><td>  newIter.next = function() {<tr><td><a name="l444" href="#l444">444</a><td>    while (true) {<tr><td><a name="l445" href="#l445">445</a><td>      var val = iterator.next();<tr><td><a name="l446" href="#l446">446</a><td>      if (dropping &amp;&amp; f.call(opt_obj, val, undefined, iterator)) {<tr><td><a name="l447" href="#l447">447</a><td>        continue;<tr><td><a name="l448" href="#l448">448</a><td>      } else {<tr><td><a name="l449" href="#l449">449</a><td>        dropping = false;<tr><td><a name="l450" href="#l450">450</a><td>      }<tr><td><a name="l451" href="#l451">451</a><td>      return val;<tr><td><a name="l452" href="#l452">452</a><td>    }<tr><td><a name="l453" href="#l453">453</a><td>  };<tr><td><a name="l454" href="#l454">454</a><td>  return newIter;<tr><td><a name="l455" href="#l455">455</a><td>};<tr><td><a name="l456" href="#l456">456</a><td><tr><td><a name="l457" href="#l457">457</a><td><tr><td><a name="l458" href="#l458">458</a><td>/**<tr><td><a name="l459" href="#l459">459</a><td> * Builds a new iterator that iterates over the original, but only as long as a<tr><td><a name="l460" href="#l460">460</a><td> * supplied function returns true.<tr><td><a name="l461" href="#l461">461</a><td> * @param {goog.iter.Iterable} iterable  The iterator object.<tr><td><a name="l462" href="#l462">462</a><td> * @param {function(this:T,?,undefined,?):boolean} f  The function to call for<tr><td><a name="l463" href="#l463">463</a><td> *     every value. This function<tr><td><a name="l464" href="#l464">464</a><td> *     takes 3 arguments (the value, undefined, and the iterator) and should<tr><td><a name="l465" href="#l465">465</a><td> *     return a boolean.<tr><td><a name="l466" href="#l466">466</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object in f when called.<tr><td><a name="l467" href="#l467">467</a><td> * @return {!goog.iter.Iterator} A new iterator that keeps elements in the<tr><td><a name="l468" href="#l468">468</a><td> *     original iterator as long as the function is true.<tr><td><a name="l469" href="#l469">469</a><td> * @template T<tr><td><a name="l470" href="#l470">470</a><td> */<tr><td><a name="l471" href="#l471">471</a><td>goog.iter.takeWhile = function(iterable, f, opt_obj) {<tr><td><a name="l472" href="#l472">472</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a name="l473" href="#l473">473</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a name="l474" href="#l474">474</a><td>  var taking = true;<tr><td><a name="l475" href="#l475">475</a><td>  newIter.next = function() {<tr><td><a name="l476" href="#l476">476</a><td>    while (true) {<tr><td><a name="l477" href="#l477">477</a><td>      if (taking) {<tr><td><a name="l478" href="#l478">478</a><td>        var val = iterator.next();<tr><td><a name="l479" href="#l479">479</a><td>        if (f.call(opt_obj, val, undefined, iterator)) {<tr><td><a name="l480" href="#l480">480</a><td>          return val;<tr><td><a name="l481" href="#l481">481</a><td>        } else {<tr><td><a name="l482" href="#l482">482</a><td>          taking = false;<tr><td><a name="l483" href="#l483">483</a><td>        }<tr><td><a name="l484" href="#l484">484</a><td>      } else {<tr><td><a name="l485" href="#l485">485</a><td>        throw goog.iter.StopIteration;<tr><td><a name="l486" href="#l486">486</a><td>      }<tr><td><a name="l487" href="#l487">487</a><td>    }<tr><td><a name="l488" href="#l488">488</a><td>  };<tr><td><a name="l489" href="#l489">489</a><td>  return newIter;<tr><td><a name="l490" href="#l490">490</a><td>};<tr><td><a name="l491" href="#l491">491</a><td><tr><td><a name="l492" href="#l492">492</a><td><tr><td><a name="l493" href="#l493">493</a><td>/**<tr><td><a name="l494" href="#l494">494</a><td> * Converts the iterator to an array<tr><td><a name="l495" href="#l495">495</a><td> * @param {goog.iter.Iterable} iterable  The iterator to convert to an array.<tr><td><a name="l496" href="#l496">496</a><td> * @return {!Array} An array of the elements the iterator iterates over.<tr><td><a name="l497" href="#l497">497</a><td> */<tr><td><a name="l498" href="#l498">498</a><td>goog.iter.toArray = function(iterable) {<tr><td><a name="l499" href="#l499">499</a><td>  // Fast path for array-like.<tr><td><a name="l500" href="#l500">500</a><td>  if (goog.isArrayLike(iterable)) {<tr><td><a name="l501" href="#l501">501</a><td>    return goog.array.toArray(/** @type {!goog.array.ArrayLike} */(iterable));<tr><td><a name="l502" href="#l502">502</a><td>  }<tr><td><a name="l503" href="#l503">503</a><td>  iterable = goog.iter.toIterator(iterable);<tr><td><a name="l504" href="#l504">504</a><td>  var array = [];<tr><td><a name="l505" href="#l505">505</a><td>  goog.iter.forEach(iterable, function(val) {<tr><td><a name="l506" href="#l506">506</a><td>    array.push(val);<tr><td><a name="l507" href="#l507">507</a><td>  });<tr><td><a name="l508" href="#l508">508</a><td>  return array;<tr><td><a name="l509" href="#l509">509</a><td>};<tr><td><a name="l510" href="#l510">510</a><td><tr><td><a name="l511" href="#l511">511</a><td><tr><td><a name="l512" href="#l512">512</a><td>/**<tr><td><a name="l513" href="#l513">513</a><td> * Iterates over 2 iterators and returns true if they contain the same sequence<tr><td><a name="l514" href="#l514">514</a><td> * of elements and have the same length.<tr><td><a name="l515" href="#l515">515</a><td> * @param {goog.iter.Iterable} iterable1  The first iterable object.<tr><td><a name="l516" href="#l516">516</a><td> * @param {goog.iter.Iterable} iterable2  The second iterable object.<tr><td><a name="l517" href="#l517">517</a><td> * @return {boolean} true if the iterators contain the same sequence of<tr><td><a name="l518" href="#l518">518</a><td> *     elements and have the same length.<tr><td><a name="l519" href="#l519">519</a><td> */<tr><td><a name="l520" href="#l520">520</a><td>goog.iter.equals = function(iterable1, iterable2) {<tr><td><a name="l521" href="#l521">521</a><td>  iterable1 = goog.iter.toIterator(iterable1);<tr><td><a name="l522" href="#l522">522</a><td>  iterable2 = goog.iter.toIterator(iterable2);<tr><td><a name="l523" href="#l523">523</a><td>  var b1, b2;<tr><td><a name="l524" href="#l524">524</a><td>  /** @preserveTry */<tr><td><a name="l525" href="#l525">525</a><td>  try {<tr><td><a name="l526" href="#l526">526</a><td>    while (true) {<tr><td><a name="l527" href="#l527">527</a><td>      b1 = b2 = false;<tr><td><a name="l528" href="#l528">528</a><td>      var val1 = iterable1.next();<tr><td><a name="l529" href="#l529">529</a><td>      b1 = true;<tr><td><a name="l530" href="#l530">530</a><td>      var val2 = iterable2.next();<tr><td><a name="l531" href="#l531">531</a><td>      b2 = true;<tr><td><a name="l532" href="#l532">532</a><td>      if (val1 != val2) {<tr><td><a name="l533" href="#l533">533</a><td>        return false;<tr><td><a name="l534" href="#l534">534</a><td>      }<tr><td><a name="l535" href="#l535">535</a><td>    }<tr><td><a name="l536" href="#l536">536</a><td>  } catch (ex) {<tr><td><a name="l537" href="#l537">537</a><td>    if (ex !== goog.iter.StopIteration) {<tr><td><a name="l538" href="#l538">538</a><td>      throw ex;<tr><td><a name="l539" href="#l539">539</a><td>    } else {<tr><td><a name="l540" href="#l540">540</a><td>      if (b1 &amp;&amp; !b2) {<tr><td><a name="l541" href="#l541">541</a><td>        // iterable1 done but iterable2 is not done.<tr><td><a name="l542" href="#l542">542</a><td>        return false;<tr><td><a name="l543" href="#l543">543</a><td>      }<tr><td><a name="l544" href="#l544">544</a><td>      if (!b2) {<tr><td><a name="l545" href="#l545">545</a><td>        /** @preserveTry */<tr><td><a name="l546" href="#l546">546</a><td>        try {<tr><td><a name="l547" href="#l547">547</a><td>          // iterable2 not done?<tr><td><a name="l548" href="#l548">548</a><td>          val2 = iterable2.next();<tr><td><a name="l549" href="#l549">549</a><td>          // iterable2 not done but iterable1 is done<tr><td><a name="l550" href="#l550">550</a><td>          return false;<tr><td><a name="l551" href="#l551">551</a><td>        } catch (ex1) {<tr><td><a name="l552" href="#l552">552</a><td>          if (ex1 !== goog.iter.StopIteration) {<tr><td><a name="l553" href="#l553">553</a><td>            throw ex1;<tr><td><a name="l554" href="#l554">554</a><td>          }<tr><td><a name="l555" href="#l555">555</a><td>          // iterable2 done as well... They are equal<tr><td><a name="l556" href="#l556">556</a><td>          return true;<tr><td><a name="l557" href="#l557">557</a><td>        }<tr><td><a name="l558" href="#l558">558</a><td>      }<tr><td><a name="l559" href="#l559">559</a><td>    }<tr><td><a name="l560" href="#l560">560</a><td>  }<tr><td><a name="l561" href="#l561">561</a><td>  return false;<tr><td><a name="l562" href="#l562">562</a><td>};<tr><td><a name="l563" href="#l563">563</a><td><tr><td><a name="l564" href="#l564">564</a><td><tr><td><a name="l565" href="#l565">565</a><td>/**<tr><td><a name="l566" href="#l566">566</a><td> * Advances the iterator to the next position, returning the given default value<tr><td><a name="l567" href="#l567">567</a><td> * instead of throwing an exception if the iterator has no more entries.<tr><td><a name="l568" href="#l568">568</a><td> * @param {goog.iter.Iterable} iterable The iterable object.<tr><td><a name="l569" href="#l569">569</a><td> * @param {*} defaultValue The value to return if the iterator is empty.<tr><td><a name="l570" href="#l570">570</a><td> * @return {*} The next item in the iteration, or defaultValue if the iterator<tr><td><a name="l571" href="#l571">571</a><td> *     was empty.<tr><td><a name="l572" href="#l572">572</a><td> */<tr><td><a name="l573" href="#l573">573</a><td>goog.iter.nextOrValue = function(iterable, defaultValue) {<tr><td><a name="l574" href="#l574">574</a><td>  try {<tr><td><a name="l575" href="#l575">575</a><td>    return goog.iter.toIterator(iterable).next();<tr><td><a name="l576" href="#l576">576</a><td>  } catch (e) {<tr><td><a name="l577" href="#l577">577</a><td>    if (e != goog.iter.StopIteration) {<tr><td><a name="l578" href="#l578">578</a><td>      throw e;<tr><td><a name="l579" href="#l579">579</a><td>    }<tr><td><a name="l580" href="#l580">580</a><td>    return defaultValue;<tr><td><a name="l581" href="#l581">581</a><td>  }<tr><td><a name="l582" href="#l582">582</a><td>};<tr><td><a name="l583" href="#l583">583</a><td><tr><td><a name="l584" href="#l584">584</a><td><tr><td><a name="l585" href="#l585">585</a><td>/**<tr><td><a name="l586" href="#l586">586</a><td> * Cartesian product of zero or more sets.  Gives an iterator that gives every<tr><td><a name="l587" href="#l587">587</a><td> * combination of one element chosen from each set.  For example,<tr><td><a name="l588" href="#l588">588</a><td> * ([1, 2], [3, 4]) gives ([1, 3], [1, 4], [2, 3], [2, 4]).<tr><td><a name="l589" href="#l589">589</a><td> * @see http://docs.python.org/library/itertools.html#itertools.product<tr><td><a name="l590" href="#l590">590</a><td> * @param {...!goog.array.ArrayLike.&lt;*&gt;} var_args Zero or more sets, as arrays.<tr><td><a name="l591" href="#l591">591</a><td> * @return {!goog.iter.Iterator} An iterator that gives each n-tuple (as an<tr><td><a name="l592" href="#l592">592</a><td> *     array).<tr><td><a name="l593" href="#l593">593</a><td> */<tr><td><a name="l594" href="#l594">594</a><td>goog.iter.product = function(var_args) {<tr><td><a name="l595" href="#l595">595</a><td>  var someArrayEmpty = goog.array.some(arguments, function(arr) {<tr><td><a name="l596" href="#l596">596</a><td>    return !arr.length;<tr><td><a name="l597" href="#l597">597</a><td>  });<tr><td><a name="l598" href="#l598">598</a><td><tr><td><a name="l599" href="#l599">599</a><td>  // An empty set in a cartesian product gives an empty set.<tr><td><a name="l600" href="#l600">600</a><td>  if (someArrayEmpty || !arguments.length) {<tr><td><a name="l601" href="#l601">601</a><td>    return new goog.iter.Iterator();<tr><td><a name="l602" href="#l602">602</a><td>  }<tr><td><a name="l603" href="#l603">603</a><td><tr><td><a name="l604" href="#l604">604</a><td>  var iter = new goog.iter.Iterator();<tr><td><a name="l605" href="#l605">605</a><td>  var arrays = arguments;<tr><td><a name="l606" href="#l606">606</a><td><tr><td><a name="l607" href="#l607">607</a><td>  // The first indicies are [0, 0, ...]<tr><td><a name="l608" href="#l608">608</a><td>  var indicies = goog.array.repeat(0, arrays.length);<tr><td><a name="l609" href="#l609">609</a><td><tr><td><a name="l610" href="#l610">610</a><td>  iter.next = function() {<tr><td><a name="l611" href="#l611">611</a><td><tr><td><a name="l612" href="#l612">612</a><td>    if (indicies) {<tr><td><a name="l613" href="#l613">613</a><td>      var retVal = goog.array.map(indicies, function(valueIndex, arrayIndex) {<tr><td><a name="l614" href="#l614">614</a><td>        return arrays[arrayIndex][valueIndex];<tr><td><a name="l615" href="#l615">615</a><td>      });<tr><td><a name="l616" href="#l616">616</a><td><tr><td><a name="l617" href="#l617">617</a><td>      // Generate the next-largest indicies for the next call.<tr><td><a name="l618" href="#l618">618</a><td>      // Increase the rightmost index. If it goes over, increase the next<tr><td><a name="l619" href="#l619">619</a><td>      // rightmost (like carry-over addition).<tr><td><a name="l620" href="#l620">620</a><td>      for (var i = indicies.length - 1; i &gt;= 0; i--) {<tr><td><a name="l621" href="#l621">621</a><td>        // Assertion prevents compiler warning below.<tr><td><a name="l622" href="#l622">622</a><td>        goog.asserts.assert(indicies);<tr><td><a name="l623" href="#l623">623</a><td>        if (indicies[i] &lt; arrays[i].length - 1) {<tr><td><a name="l624" href="#l624">624</a><td>          indicies[i]++;<tr><td><a name="l625" href="#l625">625</a><td>          break;<tr><td><a name="l626" href="#l626">626</a><td>        }<tr><td><a name="l627" href="#l627">627</a><td><tr><td><a name="l628" href="#l628">628</a><td>        // We&#39;re at the last indicies (the last element of every array), so<tr><td><a name="l629" href="#l629">629</a><td>        // the iteration is over on the next call.<tr><td><a name="l630" href="#l630">630</a><td>        if (i == 0) {<tr><td><a name="l631" href="#l631">631</a><td>          indicies = null;<tr><td><a name="l632" href="#l632">632</a><td>          break;<tr><td><a name="l633" href="#l633">633</a><td>        }<tr><td><a name="l634" href="#l634">634</a><td>        // Reset the index in this column and loop back to increment the<tr><td><a name="l635" href="#l635">635</a><td>        // next one.<tr><td><a name="l636" href="#l636">636</a><td>        indicies[i] = 0;<tr><td><a name="l637" href="#l637">637</a><td>      }<tr><td><a name="l638" href="#l638">638</a><td>      return retVal;<tr><td><a name="l639" href="#l639">639</a><td>    }<tr><td><a name="l640" href="#l640">640</a><td><tr><td><a name="l641" href="#l641">641</a><td>    throw goog.iter.StopIteration;<tr><td><a name="l642" href="#l642">642</a><td>  };<tr><td><a name="l643" href="#l643">643</a><td><tr><td><a name="l644" href="#l644">644</a><td>  return iter;<tr><td><a name="l645" href="#l645">645</a><td>};<tr><td><a name="l646" href="#l646">646</a><td><tr><td><a name="l647" href="#l647">647</a><td><tr><td><a name="l648" href="#l648">648</a><td>/**<tr><td><a name="l649" href="#l649">649</a><td> * Create an iterator to cycle over the iterable&#39;s elements indefinitely.<tr><td><a name="l650" href="#l650">650</a><td> * For example, ([1, 2, 3]) would return : 1, 2, 3, 1, 2, 3, ...<tr><td><a name="l651" href="#l651">651</a><td> * @see: http://docs.python.org/library/itertools.html#itertools.cycle.<tr><td><a name="l652" href="#l652">652</a><td> * @param {!goog.iter.Iterable} iterable The iterable object.<tr><td><a name="l653" href="#l653">653</a><td> * @return {!goog.iter.Iterator} An iterator that iterates indefinitely over<tr><td><a name="l654" href="#l654">654</a><td> * the values in {@code iterable}.<tr><td><a name="l655" href="#l655">655</a><td> */<tr><td><a name="l656" href="#l656">656</a><td>goog.iter.cycle = function(iterable) {<tr><td><a name="l657" href="#l657">657</a><td><tr><td><a name="l658" href="#l658">658</a><td>  var baseIterator = goog.iter.toIterator(iterable);<tr><td><a name="l659" href="#l659">659</a><td><tr><td><a name="l660" href="#l660">660</a><td>  // We maintain a cache to store the iterable elements as we iterate<tr><td><a name="l661" href="#l661">661</a><td>  // over them. The cache is used to return elements once we have<tr><td><a name="l662" href="#l662">662</a><td>  // iterated over the iterable once.<tr><td><a name="l663" href="#l663">663</a><td>  var cache = [];<tr><td><a name="l664" href="#l664">664</a><td>  var cacheIndex = 0;<tr><td><a name="l665" href="#l665">665</a><td><tr><td><a name="l666" href="#l666">666</a><td>  var iter = new goog.iter.Iterator();<tr><td><a name="l667" href="#l667">667</a><td><tr><td><a name="l668" href="#l668">668</a><td>  // This flag is set after the iterable is iterated over once<tr><td><a name="l669" href="#l669">669</a><td>  var useCache = false;<tr><td><a name="l670" href="#l670">670</a><td><tr><td><a name="l671" href="#l671">671</a><td>  iter.next = function() {<tr><td><a name="l672" href="#l672">672</a><td>    var returnElement = null;<tr><td><a name="l673" href="#l673">673</a><td><tr><td><a name="l674" href="#l674">674</a><td>    // Pull elements off the original iterator if not using cache<tr><td><a name="l675" href="#l675">675</a><td>    if (!useCache) {<tr><td><a name="l676" href="#l676">676</a><td>      try {<tr><td><a name="l677" href="#l677">677</a><td>        // Return the element from the iterable<tr><td><a name="l678" href="#l678">678</a><td>        returnElement = baseIterator.next();<tr><td><a name="l679" href="#l679">679</a><td>        cache.push(returnElement);<tr><td><a name="l680" href="#l680">680</a><td>        return returnElement;<tr><td><a name="l681" href="#l681">681</a><td>      } catch (e) {<tr><td><a name="l682" href="#l682">682</a><td>        // If an exception other than StopIteration is thrown<tr><td><a name="l683" href="#l683">683</a><td>        // or if there are no elements to iterate over (the iterable was empty)<tr><td><a name="l684" href="#l684">684</a><td>        // throw an exception<tr><td><a name="l685" href="#l685">685</a><td>        if (e != goog.iter.StopIteration || goog.array.isEmpty(cache)) {<tr><td><a name="l686" href="#l686">686</a><td>          throw e;<tr><td><a name="l687" href="#l687">687</a><td>        }<tr><td><a name="l688" href="#l688">688</a><td>        // set useCache to true after we know that a &#39;StopIteration&#39; exception<tr><td><a name="l689" href="#l689">689</a><td>        // was thrown and the cache is not empty (to handle the &#39;empty iterable&#39;<tr><td><a name="l690" href="#l690">690</a><td>        // use case)<tr><td><a name="l691" href="#l691">691</a><td>        useCache = true;<tr><td><a name="l692" href="#l692">692</a><td>      }<tr><td><a name="l693" href="#l693">693</a><td>    }<tr><td><a name="l694" href="#l694">694</a><td><tr><td><a name="l695" href="#l695">695</a><td>    returnElement = cache[cacheIndex];<tr><td><a name="l696" href="#l696">696</a><td>    cacheIndex = (cacheIndex + 1) % cache.length;<tr><td><a name="l697" href="#l697">697</a><td><tr><td><a name="l698" href="#l698">698</a><td>    return returnElement;<tr><td><a name="l699" href="#l699">699</a><td>  };<tr><td><a name="l700" href="#l700">700</a><td><tr><td><a name="l701" href="#l701">701</a><td>  return iter;<tr><td><a name="l702" href="#l702">702</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>iter.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/iter/iter.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Python style iteration utilities.<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><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.iter&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.iter.Iterable&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.iter.Iterator&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.iter.StopIteration&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.functions&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.math&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @typedef {goog.iter.Iterator|{length:number}|{__iterator__}}<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.iter.Iterable;<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> * Singleton Error object that is used to terminate iterations.<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @const {!Error}<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.iter.StopIteration = (&#39;StopIteration&#39; in goog.global) ?<tr><td><a id="l43"></a><a href="#l43">43</a><td>    // For script engines that support legacy iterators.<tr><td><a id="l44"></a><a href="#l44">44</a><td>    goog.global[&#39;StopIteration&#39;] :<tr><td><a id="l45"></a><a href="#l45">45</a><td>    { message: &#39;StopIteration&#39;, stack: &#39;&#39;};<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>/**<tr><td><a id="l50"></a><a href="#l50">50</a><td> * Class/interface for iterators.  An iterator needs to implement a {@code next}<tr><td><a id="l51"></a><a href="#l51">51</a><td> * method and it needs to throw a {@code goog.iter.StopIteration} when the<tr><td><a id="l52"></a><a href="#l52">52</a><td> * iteration passes beyond the end.  Iterators have no {@code hasNext} method.<tr><td><a id="l53"></a><a href="#l53">53</a><td> * It is recommended to always use the helper functions to iterate over the<tr><td><a id="l54"></a><a href="#l54">54</a><td> * iterator or in case you are only targeting JavaScript 1.7 for in loops.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @constructor<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @template VALUE<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.iter.Iterator = function() {};<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>/**<tr><td><a id="l62"></a><a href="#l62">62</a><td> * Returns the next value of the iteration.  This will throw the object<tr><td><a id="l63"></a><a href="#l63">63</a><td> * {@see goog.iter#StopIteration} when the iteration passes the end.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @return {VALUE} Any object or value.<tr><td><a id="l65"></a><a href="#l65">65</a><td> */<tr><td><a id="l66"></a><a href="#l66">66</a><td>goog.iter.Iterator.prototype.next = function() {<tr><td><a id="l67"></a><a href="#l67">67</a><td>  throw goog.iter.StopIteration;<tr><td><a id="l68"></a><a href="#l68">68</a><td>};<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td>/**<tr><td><a id="l72"></a><a href="#l72">72</a><td> * Returns the {@code Iterator} object itself.  This is used to implement<tr><td><a id="l73"></a><a href="#l73">73</a><td> * the iterator protocol in JavaScript 1.7<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @param {boolean=} opt_keys  Whether to return the keys or values. Default is<tr><td><a id="l75"></a><a href="#l75">75</a><td> *     to only return the values.  This is being used by the for-in loop (true)<tr><td><a id="l76"></a><a href="#l76">76</a><td> *     and the for-each-in loop (false).  Even though the param gives a hint<tr><td><a id="l77"></a><a href="#l77">77</a><td> *     about what the iterator will return there is no guarantee that it will<tr><td><a id="l78"></a><a href="#l78">78</a><td> *     return the keys when true is passed.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} The object itself.<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.iter.Iterator.prototype.__iterator__ = function(opt_keys) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>  return this;<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> * Returns an iterator that knows how to iterate over the values in the object.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable  If the<tr><td><a id="l89"></a><a href="#l89">89</a><td> *     object is an iterator it will be returned as is.  If the object has an<tr><td><a id="l90"></a><a href="#l90">90</a><td> *     {@code __iterator__} method that will be called to get the value<tr><td><a id="l91"></a><a href="#l91">91</a><td> *     iterator.  If the object is an array-like object we create an iterator<tr><td><a id="l92"></a><a href="#l92">92</a><td> *     for that.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} An iterator that knows how to iterate<tr><td><a id="l94"></a><a href="#l94">94</a><td> *     over the values in {@code iterable}.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @template VALUE<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.iter.toIterator = function(iterable) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>  if (iterable instanceof goog.iter.Iterator) {<tr><td><a id="l99"></a><a href="#l99">99</a><td>    return iterable;<tr><td><a id="l100"></a><a href="#l100">100</a><td>  }<tr><td><a id="l101"></a><a href="#l101">101</a><td>  if (typeof iterable.__iterator__ == &#39;function&#39;) {<tr><td><a id="l102"></a><a href="#l102">102</a><td>    return iterable.__iterator__(false);<tr><td><a id="l103"></a><a href="#l103">103</a><td>  }<tr><td><a id="l104"></a><a href="#l104">104</a><td>  if (goog.isArrayLike(iterable)) {<tr><td><a id="l105"></a><a href="#l105">105</a><td>    var i = 0;<tr><td><a id="l106"></a><a href="#l106">106</a><td>    var newIter = new goog.iter.Iterator;<tr><td><a id="l107"></a><a href="#l107">107</a><td>    newIter.next = function() {<tr><td><a id="l108"></a><a href="#l108">108</a><td>      while (true) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>        if (i &gt;= iterable.length) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>          throw goog.iter.StopIteration;<tr><td><a id="l111"></a><a href="#l111">111</a><td>        }<tr><td><a id="l112"></a><a href="#l112">112</a><td>        // Don&#39;t include deleted elements.<tr><td><a id="l113"></a><a href="#l113">113</a><td>        if (!(i in iterable)) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>          i++;<tr><td><a id="l115"></a><a href="#l115">115</a><td>          continue;<tr><td><a id="l116"></a><a href="#l116">116</a><td>        }<tr><td><a id="l117"></a><a href="#l117">117</a><td>        return iterable[i++];<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>    return newIter;<tr><td><a id="l121"></a><a href="#l121">121</a><td>  }<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>  // TODO(arv): Should we fall back on goog.structs.getValues()?<tr><td><a id="l125"></a><a href="#l125">125</a><td>  throw Error(&#39;Not implemented&#39;);<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><tr><td><a id="l129"></a><a href="#l129">129</a><td>/**<tr><td><a id="l130"></a><a href="#l130">130</a><td> * Calls a function for each element in the iterator with the element of the<tr><td><a id="l131"></a><a href="#l131">131</a><td> * iterator passed as argument.<tr><td><a id="l132"></a><a href="#l132">132</a><td> *<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable  The iterator<tr><td><a id="l134"></a><a href="#l134">134</a><td> *     to iterate over. If the iterable is an object {@code toIterator} will be<tr><td><a id="l135"></a><a href="#l135">135</a><td> *     called on it.<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @param {function(this:THIS,VALUE,?,!goog.iter.Iterator&lt;VALUE&gt;)} f<tr><td><a id="l137"></a><a href="#l137">137</a><td> *     The function to call for every element.  This function takes 3 arguments<tr><td><a id="l138"></a><a href="#l138">138</a><td> *     (the element, undefined, and the iterator) and the return value is<tr><td><a id="l139"></a><a href="#l139">139</a><td> *     irrelevant.  The reason for passing undefined as the second argument is<tr><td><a id="l140"></a><a href="#l140">140</a><td> *     so that the same function can be used in {@see goog.array#forEach} as<tr><td><a id="l141"></a><a href="#l141">141</a><td> *     well as others.  The third parameter is of type &quot;number&quot; for<tr><td><a id="l142"></a><a href="#l142">142</a><td> *     arraylike objects, undefined, otherwise.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {THIS=} opt_obj  The object to be used as the value of &#39;this&#39; within<tr><td><a id="l144"></a><a href="#l144">144</a><td> *     {@code f}.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @template THIS, VALUE<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.iter.forEach = function(iterable, f, opt_obj) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  if (goog.isArrayLike(iterable)) {<tr><td><a id="l149"></a><a href="#l149">149</a><td>    /** @preserveTry */<tr><td><a id="l150"></a><a href="#l150">150</a><td>    try {<tr><td><a id="l151"></a><a href="#l151">151</a><td>      // NOTES: this passes the index number to the second parameter<tr><td><a id="l152"></a><a href="#l152">152</a><td>      // of the callback contrary to the documentation above.<tr><td><a id="l153"></a><a href="#l153">153</a><td>      goog.array.forEach(/** @type {goog.array.ArrayLike} */(iterable), f,<tr><td><a id="l154"></a><a href="#l154">154</a><td>                         opt_obj);<tr><td><a id="l155"></a><a href="#l155">155</a><td>    } catch (ex) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>      if (ex !== goog.iter.StopIteration) {<tr><td><a id="l157"></a><a href="#l157">157</a><td>        throw ex;<tr><td><a id="l158"></a><a href="#l158">158</a><td>      }<tr><td><a id="l159"></a><a href="#l159">159</a><td>    }<tr><td><a id="l160"></a><a href="#l160">160</a><td>  } else {<tr><td><a id="l161"></a><a href="#l161">161</a><td>    iterable = goog.iter.toIterator(iterable);<tr><td><a id="l162"></a><a href="#l162">162</a><td>    /** @preserveTry */<tr><td><a id="l163"></a><a href="#l163">163</a><td>    try {<tr><td><a id="l164"></a><a href="#l164">164</a><td>      while (true) {<tr><td><a id="l165"></a><a href="#l165">165</a><td>        f.call(opt_obj, iterable.next(), undefined, iterable);<tr><td><a id="l166"></a><a href="#l166">166</a><td>      }<tr><td><a id="l167"></a><a href="#l167">167</a><td>    } catch (ex) {<tr><td><a id="l168"></a><a href="#l168">168</a><td>      if (ex !== goog.iter.StopIteration) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>        throw ex;<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>};<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td>/**<tr><td><a id="l177"></a><a href="#l177">177</a><td> * Calls a function for every element in the iterator, and if the function<tr><td><a id="l178"></a><a href="#l178">178</a><td> * returns true adds the element to a new iterator.<tr><td><a id="l179"></a><a href="#l179">179</a><td> *<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l181"></a><a href="#l181">181</a><td> *     to iterate over.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @param {<tr><td><a id="l183"></a><a href="#l183">183</a><td> *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator&lt;VALUE&gt;):boolean} f<tr><td><a id="l184"></a><a href="#l184">184</a><td> *     The function to call for every element. This function takes 3 arguments<tr><td><a id="l185"></a><a href="#l185">185</a><td> *     (the element, undefined, and the iterator) and should return a boolean.<tr><td><a id="l186"></a><a href="#l186">186</a><td> *     If the return value is true the element will be included in the returned<tr><td><a id="l187"></a><a href="#l187">187</a><td> *     iterator.  If it is false the element is not included.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a id="l189"></a><a href="#l189">189</a><td> *     {@code f}.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} A new iterator in which only elements<tr><td><a id="l191"></a><a href="#l191">191</a><td> *     that passed the test are present.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @template THIS, VALUE<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>goog.iter.filter = function(iterable, f, opt_obj) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l196"></a><a href="#l196">196</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a id="l197"></a><a href="#l197">197</a><td>  newIter.next = function() {<tr><td><a id="l198"></a><a href="#l198">198</a><td>    while (true) {<tr><td><a id="l199"></a><a href="#l199">199</a><td>      var val = iterator.next();<tr><td><a id="l200"></a><a href="#l200">200</a><td>      if (f.call(opt_obj, val, undefined, iterator)) {<tr><td><a id="l201"></a><a href="#l201">201</a><td>        return val;<tr><td><a id="l202"></a><a href="#l202">202</a><td>      }<tr><td><a id="l203"></a><a href="#l203">203</a><td>    }<tr><td><a id="l204"></a><a href="#l204">204</a><td>  };<tr><td><a id="l205"></a><a href="#l205">205</a><td>  return newIter;<tr><td><a id="l206"></a><a href="#l206">206</a><td>};<tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td>/**<tr><td><a id="l210"></a><a href="#l210">210</a><td> * Calls a function for every element in the iterator, and if the function<tr><td><a id="l211"></a><a href="#l211">211</a><td> * returns false adds the element to a new iterator.<tr><td><a id="l212"></a><a href="#l212">212</a><td> *<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l214"></a><a href="#l214">214</a><td> *     to iterate over.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @param {<tr><td><a id="l216"></a><a href="#l216">216</a><td> *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator&lt;VALUE&gt;):boolean} f<tr><td><a id="l217"></a><a href="#l217">217</a><td> *     The function to call for every element. This function takes 3 arguments<tr><td><a id="l218"></a><a href="#l218">218</a><td> *     (the element, undefined, and the iterator) and should return a boolean.<tr><td><a id="l219"></a><a href="#l219">219</a><td> *     If the return value is false the element will be included in the returned<tr><td><a id="l220"></a><a href="#l220">220</a><td> *     iterator.  If it is true the element is not included.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a id="l222"></a><a href="#l222">222</a><td> *     {@code f}.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} A new iterator in which only elements<tr><td><a id="l224"></a><a href="#l224">224</a><td> *     that did not pass the test are present.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @template THIS, VALUE<tr><td><a id="l226"></a><a href="#l226">226</a><td> */<tr><td><a id="l227"></a><a href="#l227">227</a><td>goog.iter.filterFalse = function(iterable, f, opt_obj) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>  return goog.iter.filter(iterable, goog.functions.not(f), opt_obj);<tr><td><a id="l229"></a><a href="#l229">229</a><td>};<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td>/**<tr><td><a id="l233"></a><a href="#l233">233</a><td> * Creates a new iterator that returns the values in a range.  This function<tr><td><a id="l234"></a><a href="#l234">234</a><td> * can take 1, 2 or 3 arguments:<tr><td><a id="l235"></a><a href="#l235">235</a><td> * &lt;pre&gt;<tr><td><a id="l236"></a><a href="#l236">236</a><td> * range(5) same as range(0, 5, 1)<tr><td><a id="l237"></a><a href="#l237">237</a><td> * range(2, 5) same as range(2, 5, 1)<tr><td><a id="l238"></a><a href="#l238">238</a><td> * &lt;/pre&gt;<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 {number} startOrStop  The stop value if only one argument is provided.<tr><td><a id="l241"></a><a href="#l241">241</a><td> *     The start value if 2 or more arguments are provided.  If only one<tr><td><a id="l242"></a><a href="#l242">242</a><td> *     argument is used the start value is 0.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {number=} opt_stop  The stop value.  If left out then the first<tr><td><a id="l244"></a><a href="#l244">244</a><td> *     argument is used as the stop value.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {number=} opt_step  The number to increment with between each call to<tr><td><a id="l246"></a><a href="#l246">246</a><td> *     next.  This can be negative.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @return {!goog.iter.Iterator&lt;number&gt;} A new iterator that returns the values<tr><td><a id="l248"></a><a href="#l248">248</a><td> *     in the range.<tr><td><a id="l249"></a><a href="#l249">249</a><td> */<tr><td><a id="l250"></a><a href="#l250">250</a><td>goog.iter.range = function(startOrStop, opt_stop, opt_step) {<tr><td><a id="l251"></a><a href="#l251">251</a><td>  var start = 0;<tr><td><a id="l252"></a><a href="#l252">252</a><td>  var stop = startOrStop;<tr><td><a id="l253"></a><a href="#l253">253</a><td>  var step = opt_step || 1;<tr><td><a id="l254"></a><a href="#l254">254</a><td>  if (arguments.length &gt; 1) {<tr><td><a id="l255"></a><a href="#l255">255</a><td>    start = startOrStop;<tr><td><a id="l256"></a><a href="#l256">256</a><td>    stop = opt_stop;<tr><td><a id="l257"></a><a href="#l257">257</a><td>  }<tr><td><a id="l258"></a><a href="#l258">258</a><td>  if (step == 0) {<tr><td><a id="l259"></a><a href="#l259">259</a><td>    throw Error(&#39;Range step argument must not be zero&#39;);<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>  var newIter = new goog.iter.Iterator;<tr><td><a id="l263"></a><a href="#l263">263</a><td>  newIter.next = function() {<tr><td><a id="l264"></a><a href="#l264">264</a><td>    if (step &gt; 0 &amp;&amp; start &gt;= stop || step &lt; 0 &amp;&amp; start &lt;= stop) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>      throw goog.iter.StopIteration;<tr><td><a id="l266"></a><a href="#l266">266</a><td>    }<tr><td><a id="l267"></a><a href="#l267">267</a><td>    var rv = start;<tr><td><a id="l268"></a><a href="#l268">268</a><td>    start += step;<tr><td><a id="l269"></a><a href="#l269">269</a><td>    return rv;<tr><td><a id="l270"></a><a href="#l270">270</a><td>  };<tr><td><a id="l271"></a><a href="#l271">271</a><td>  return newIter;<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> * Joins the values in a iterator with a delimiter.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l278"></a><a href="#l278">278</a><td> *     to get the values from.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {string} deliminator  The text to put between the values.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @return {string} The joined value string.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @template VALUE<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.iter.join = function(iterable, deliminator) {<tr><td><a id="l284"></a><a href="#l284">284</a><td>  return goog.iter.toArray(iterable).join(deliminator);<tr><td><a id="l285"></a><a href="#l285">285</a><td>};<tr><td><a id="l286"></a><a href="#l286">286</a><td><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> * For every element in the iterator call a function and return a new iterator<tr><td><a id="l290"></a><a href="#l290">290</a><td> * with that value.<tr><td><a id="l291"></a><a href="#l291">291</a><td> *<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l293"></a><a href="#l293">293</a><td> *     iterator to iterate over.<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {<tr><td><a id="l295"></a><a href="#l295">295</a><td> *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator&lt;VALUE&gt;):RESULT} f<tr><td><a id="l296"></a><a href="#l296">296</a><td> *     The function to call for every element.  This function takes 3 arguments<tr><td><a id="l297"></a><a href="#l297">297</a><td> *     (the element, undefined, and the iterator) and should return a new value.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a id="l299"></a><a href="#l299">299</a><td> *     {@code f}.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @return {!goog.iter.Iterator&lt;RESULT&gt;} A new iterator that returns the<tr><td><a id="l301"></a><a href="#l301">301</a><td> *     results of applying the function to each element in the original<tr><td><a id="l302"></a><a href="#l302">302</a><td> *     iterator.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @template THIS, VALUE, RESULT<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.iter.map = function(iterable, f, opt_obj) {<tr><td><a id="l306"></a><a href="#l306">306</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l307"></a><a href="#l307">307</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a id="l308"></a><a href="#l308">308</a><td>  newIter.next = function() {<tr><td><a id="l309"></a><a href="#l309">309</a><td>    var val = iterator.next();<tr><td><a id="l310"></a><a href="#l310">310</a><td>    return f.call(opt_obj, val, undefined, iterator);<tr><td><a id="l311"></a><a href="#l311">311</a><td>  };<tr><td><a id="l312"></a><a href="#l312">312</a><td>  return newIter;<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>/**<tr><td><a id="l317"></a><a href="#l317">317</a><td> * Passes every element of an iterator into a function and accumulates the<tr><td><a id="l318"></a><a href="#l318">318</a><td> * result.<tr><td><a id="l319"></a><a href="#l319">319</a><td> *<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l321"></a><a href="#l321">321</a><td> *     to iterate over.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {function(this:THIS,VALUE,VALUE):VALUE} f The function to call for<tr><td><a id="l323"></a><a href="#l323">323</a><td> *     every element. This function takes 2 arguments (the function&#39;s previous<tr><td><a id="l324"></a><a href="#l324">324</a><td> *     result or the initial value, and the value of the current element).<tr><td><a id="l325"></a><a href="#l325">325</a><td> *     function(previousValue, currentElement) : newValue.<tr><td><a id="l326"></a><a href="#l326">326</a><td> * @param {VALUE} val The initial value to pass into the function on the first<tr><td><a id="l327"></a><a href="#l327">327</a><td> *     call.<tr><td><a id="l328"></a><a href="#l328">328</a><td> * @param {THIS=} opt_obj  The object to be used as the value of &#39;this&#39; within<tr><td><a id="l329"></a><a href="#l329">329</a><td> *     f.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @return {VALUE} Result of evaluating f repeatedly across the values of<tr><td><a id="l331"></a><a href="#l331">331</a><td> *     the iterator.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @template THIS, VALUE<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>goog.iter.reduce = function(iterable, f, val, opt_obj) {<tr><td><a id="l335"></a><a href="#l335">335</a><td>  var rval = val;<tr><td><a id="l336"></a><a href="#l336">336</a><td>  goog.iter.forEach(iterable, function(val) {<tr><td><a id="l337"></a><a href="#l337">337</a><td>    rval = f.call(opt_obj, rval, val);<tr><td><a id="l338"></a><a href="#l338">338</a><td>  });<tr><td><a id="l339"></a><a href="#l339">339</a><td>  return rval;<tr><td><a id="l340"></a><a href="#l340">340</a><td>};<tr><td><a id="l341"></a><a href="#l341">341</a><td><tr><td><a id="l342"></a><a href="#l342">342</a><td><tr><td><a id="l343"></a><a href="#l343">343</a><td>/**<tr><td><a id="l344"></a><a href="#l344">344</a><td> * Goes through the values in the iterator. Calls f for each of these, and if<tr><td><a id="l345"></a><a href="#l345">345</a><td> * any of them returns true, this returns true (without checking the rest). If<tr><td><a id="l346"></a><a href="#l346">346</a><td> * all return false this will return false.<tr><td><a id="l347"></a><a href="#l347">347</a><td> *<tr><td><a id="l348"></a><a href="#l348">348</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l349"></a><a href="#l349">349</a><td> *     object.<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @param {<tr><td><a id="l351"></a><a href="#l351">351</a><td> *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator&lt;VALUE&gt;):boolean} f<tr><td><a id="l352"></a><a href="#l352">352</a><td> *     The function to call for every value. This function takes 3 arguments<tr><td><a id="l353"></a><a href="#l353">353</a><td> *     (the value, undefined, and the iterator) and should return a boolean.<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a id="l355"></a><a href="#l355">355</a><td> *     {@code f}.<tr><td><a id="l356"></a><a href="#l356">356</a><td> * @return {boolean} true if any value passes the test.<tr><td><a id="l357"></a><a href="#l357">357</a><td> * @template THIS, VALUE<tr><td><a id="l358"></a><a href="#l358">358</a><td> */<tr><td><a id="l359"></a><a href="#l359">359</a><td>goog.iter.some = function(iterable, f, opt_obj) {<tr><td><a id="l360"></a><a href="#l360">360</a><td>  iterable = goog.iter.toIterator(iterable);<tr><td><a id="l361"></a><a href="#l361">361</a><td>  /** @preserveTry */<tr><td><a id="l362"></a><a href="#l362">362</a><td>  try {<tr><td><a id="l363"></a><a href="#l363">363</a><td>    while (true) {<tr><td><a id="l364"></a><a href="#l364">364</a><td>      if (f.call(opt_obj, iterable.next(), undefined, iterable)) {<tr><td><a id="l365"></a><a href="#l365">365</a><td>        return true;<tr><td><a id="l366"></a><a href="#l366">366</a><td>      }<tr><td><a id="l367"></a><a href="#l367">367</a><td>    }<tr><td><a id="l368"></a><a href="#l368">368</a><td>  } catch (ex) {<tr><td><a id="l369"></a><a href="#l369">369</a><td>    if (ex !== goog.iter.StopIteration) {<tr><td><a id="l370"></a><a href="#l370">370</a><td>      throw ex;<tr><td><a id="l371"></a><a href="#l371">371</a><td>    }<tr><td><a id="l372"></a><a href="#l372">372</a><td>  }<tr><td><a id="l373"></a><a href="#l373">373</a><td>  return false;<tr><td><a id="l374"></a><a href="#l374">374</a><td>};<tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td><tr><td><a id="l377"></a><a href="#l377">377</a><td>/**<tr><td><a id="l378"></a><a href="#l378">378</a><td> * Goes through the values in the iterator. Calls f for each of these and if any<tr><td><a id="l379"></a><a href="#l379">379</a><td> * of them returns false this returns false (without checking the rest). If all<tr><td><a id="l380"></a><a href="#l380">380</a><td> * return true this will return true.<tr><td><a id="l381"></a><a href="#l381">381</a><td> *<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l383"></a><a href="#l383">383</a><td> *     object.<tr><td><a id="l384"></a><a href="#l384">384</a><td> * @param {<tr><td><a id="l385"></a><a href="#l385">385</a><td> *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator&lt;VALUE&gt;):boolean} f<tr><td><a id="l386"></a><a href="#l386">386</a><td> *     The function to call for every value. This function takes 3 arguments<tr><td><a id="l387"></a><a href="#l387">387</a><td> *     (the value, undefined, and the iterator) and should return a boolean.<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a id="l389"></a><a href="#l389">389</a><td> *     {@code f}.<tr><td><a id="l390"></a><a href="#l390">390</a><td> * @return {boolean} true if every value passes the test.<tr><td><a id="l391"></a><a href="#l391">391</a><td> * @template THIS, VALUE<tr><td><a id="l392"></a><a href="#l392">392</a><td> */<tr><td><a id="l393"></a><a href="#l393">393</a><td>goog.iter.every = function(iterable, f, opt_obj) {<tr><td><a id="l394"></a><a href="#l394">394</a><td>  iterable = goog.iter.toIterator(iterable);<tr><td><a id="l395"></a><a href="#l395">395</a><td>  /** @preserveTry */<tr><td><a id="l396"></a><a href="#l396">396</a><td>  try {<tr><td><a id="l397"></a><a href="#l397">397</a><td>    while (true) {<tr><td><a id="l398"></a><a href="#l398">398</a><td>      if (!f.call(opt_obj, iterable.next(), undefined, iterable)) {<tr><td><a id="l399"></a><a href="#l399">399</a><td>        return false;<tr><td><a id="l400"></a><a href="#l400">400</a><td>      }<tr><td><a id="l401"></a><a href="#l401">401</a><td>    }<tr><td><a id="l402"></a><a href="#l402">402</a><td>  } catch (ex) {<tr><td><a id="l403"></a><a href="#l403">403</a><td>    if (ex !== goog.iter.StopIteration) {<tr><td><a id="l404"></a><a href="#l404">404</a><td>      throw ex;<tr><td><a id="l405"></a><a href="#l405">405</a><td>    }<tr><td><a id="l406"></a><a href="#l406">406</a><td>  }<tr><td><a id="l407"></a><a href="#l407">407</a><td>  return true;<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>/**<tr><td><a id="l412"></a><a href="#l412">412</a><td> * Takes zero or more iterables and returns one iterator that will iterate over<tr><td><a id="l413"></a><a href="#l413">413</a><td> * them in the order chained.<tr><td><a id="l414"></a><a href="#l414">414</a><td> * @param {...!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} var_args Any<tr><td><a id="l415"></a><a href="#l415">415</a><td> *     number of iterable objects.<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} Returns a new iterator that will<tr><td><a id="l417"></a><a href="#l417">417</a><td> *     iterate over all the given iterables&#39; contents.<tr><td><a id="l418"></a><a href="#l418">418</a><td> * @template VALUE<tr><td><a id="l419"></a><a href="#l419">419</a><td> */<tr><td><a id="l420"></a><a href="#l420">420</a><td>goog.iter.chain = function(var_args) {<tr><td><a id="l421"></a><a href="#l421">421</a><td>  return goog.iter.chainFromIterable(arguments);<tr><td><a id="l422"></a><a href="#l422">422</a><td>};<tr><td><a id="l423"></a><a href="#l423">423</a><td><tr><td><a id="l424"></a><a href="#l424">424</a><td><tr><td><a id="l425"></a><a href="#l425">425</a><td>/**<tr><td><a id="l426"></a><a href="#l426">426</a><td> * Takes a single iterable containing zero or more iterables and returns one<tr><td><a id="l427"></a><a href="#l427">427</a><td> * iterator that will iterate over each one in the order given.<tr><td><a id="l428"></a><a href="#l428">428</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.chain.from_iterable<tr><td><a id="l429"></a><a href="#l429">429</a><td> * @param {goog.iter.Iterable} iterable The iterable of iterables to chain.<tr><td><a id="l430"></a><a href="#l430">430</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} Returns a new iterator that will<tr><td><a id="l431"></a><a href="#l431">431</a><td> *     iterate over all the contents of the iterables contained within<tr><td><a id="l432"></a><a href="#l432">432</a><td> *     {@code iterable}.<tr><td><a id="l433"></a><a href="#l433">433</a><td> * @template 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>goog.iter.chainFromIterable = function(iterable) {<tr><td><a id="l436"></a><a href="#l436">436</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l437"></a><a href="#l437">437</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l438"></a><a href="#l438">438</a><td>  var current = null;<tr><td><a id="l439"></a><a href="#l439">439</a><td><tr><td><a id="l440"></a><a href="#l440">440</a><td>  iter.next = function() {<tr><td><a id="l441"></a><a href="#l441">441</a><td>    while (true) {<tr><td><a id="l442"></a><a href="#l442">442</a><td>      if (current == null) {<tr><td><a id="l443"></a><a href="#l443">443</a><td>        var it = iterator.next();<tr><td><a id="l444"></a><a href="#l444">444</a><td>        current = goog.iter.toIterator(it);<tr><td><a id="l445"></a><a href="#l445">445</a><td>      }<tr><td><a id="l446"></a><a href="#l446">446</a><td>      try {<tr><td><a id="l447"></a><a href="#l447">447</a><td>        return current.next();<tr><td><a id="l448"></a><a href="#l448">448</a><td>      } catch (ex) {<tr><td><a id="l449"></a><a href="#l449">449</a><td>        if (ex !== goog.iter.StopIteration) {<tr><td><a id="l450"></a><a href="#l450">450</a><td>          throw ex;<tr><td><a id="l451"></a><a href="#l451">451</a><td>        }<tr><td><a id="l452"></a><a href="#l452">452</a><td>        current = null;<tr><td><a id="l453"></a><a href="#l453">453</a><td>      }<tr><td><a id="l454"></a><a href="#l454">454</a><td>    }<tr><td><a id="l455"></a><a href="#l455">455</a><td>  };<tr><td><a id="l456"></a><a href="#l456">456</a><td><tr><td><a id="l457"></a><a href="#l457">457</a><td>  return iter;<tr><td><a id="l458"></a><a href="#l458">458</a><td>};<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> * Builds a new iterator that iterates over the original, but skips elements as<tr><td><a id="l463"></a><a href="#l463">463</a><td> * long as a supplied function returns true.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l465"></a><a href="#l465">465</a><td> *     object.<tr><td><a id="l466"></a><a href="#l466">466</a><td> * @param {<tr><td><a id="l467"></a><a href="#l467">467</a><td> *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator&lt;VALUE&gt;):boolean} f<tr><td><a id="l468"></a><a href="#l468">468</a><td> *     The function to call for every value. This function takes 3 arguments<tr><td><a id="l469"></a><a href="#l469">469</a><td> *     (the value, undefined, and the iterator) and should return a boolean.<tr><td><a id="l470"></a><a href="#l470">470</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a id="l471"></a><a href="#l471">471</a><td> *     {@code f}.<tr><td><a id="l472"></a><a href="#l472">472</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} A new iterator that drops elements from<tr><td><a id="l473"></a><a href="#l473">473</a><td> *     the original iterator as long as {@code f} is true.<tr><td><a id="l474"></a><a href="#l474">474</a><td> * @template THIS, VALUE<tr><td><a id="l475"></a><a href="#l475">475</a><td> */<tr><td><a id="l476"></a><a href="#l476">476</a><td>goog.iter.dropWhile = function(iterable, f, opt_obj) {<tr><td><a id="l477"></a><a href="#l477">477</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l478"></a><a href="#l478">478</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a id="l479"></a><a href="#l479">479</a><td>  var dropping = true;<tr><td><a id="l480"></a><a href="#l480">480</a><td>  newIter.next = function() {<tr><td><a id="l481"></a><a href="#l481">481</a><td>    while (true) {<tr><td><a id="l482"></a><a href="#l482">482</a><td>      var val = iterator.next();<tr><td><a id="l483"></a><a href="#l483">483</a><td>      if (dropping &amp;&amp; f.call(opt_obj, val, undefined, iterator)) {<tr><td><a id="l484"></a><a href="#l484">484</a><td>        continue;<tr><td><a id="l485"></a><a href="#l485">485</a><td>      } else {<tr><td><a id="l486"></a><a href="#l486">486</a><td>        dropping = false;<tr><td><a id="l487"></a><a href="#l487">487</a><td>      }<tr><td><a id="l488"></a><a href="#l488">488</a><td>      return val;<tr><td><a id="l489"></a><a href="#l489">489</a><td>    }<tr><td><a id="l490"></a><a href="#l490">490</a><td>  };<tr><td><a id="l491"></a><a href="#l491">491</a><td>  return newIter;<tr><td><a id="l492"></a><a href="#l492">492</a><td>};<tr><td><a id="l493"></a><a href="#l493">493</a><td><tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td>/**<tr><td><a id="l496"></a><a href="#l496">496</a><td> * Builds a new iterator that iterates over the original, but only as long as a<tr><td><a id="l497"></a><a href="#l497">497</a><td> * supplied function returns true.<tr><td><a id="l498"></a><a href="#l498">498</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l499"></a><a href="#l499">499</a><td> *     object.<tr><td><a id="l500"></a><a href="#l500">500</a><td> * @param {<tr><td><a id="l501"></a><a href="#l501">501</a><td> *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator&lt;VALUE&gt;):boolean} f<tr><td><a id="l502"></a><a href="#l502">502</a><td> *     The function to call for every value. This function takes 3 arguments<tr><td><a id="l503"></a><a href="#l503">503</a><td> *     (the value, undefined, and the iterator) and should return a boolean.<tr><td><a id="l504"></a><a href="#l504">504</a><td> * @param {THIS=} opt_obj This is used as the &#39;this&#39; object in f when called.<tr><td><a id="l505"></a><a href="#l505">505</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} A new iterator that keeps elements in<tr><td><a id="l506"></a><a href="#l506">506</a><td> *     the original iterator as long as the function is true.<tr><td><a id="l507"></a><a href="#l507">507</a><td> * @template THIS, VALUE<tr><td><a id="l508"></a><a href="#l508">508</a><td> */<tr><td><a id="l509"></a><a href="#l509">509</a><td>goog.iter.takeWhile = function(iterable, f, opt_obj) {<tr><td><a id="l510"></a><a href="#l510">510</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l511"></a><a href="#l511">511</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l512"></a><a href="#l512">512</a><td>  iter.next = function() {<tr><td><a id="l513"></a><a href="#l513">513</a><td>    var val = iterator.next();<tr><td><a id="l514"></a><a href="#l514">514</a><td>    if (f.call(opt_obj, val, undefined, iterator)) {<tr><td><a id="l515"></a><a href="#l515">515</a><td>      return val;<tr><td><a id="l516"></a><a href="#l516">516</a><td>    }<tr><td><a id="l517"></a><a href="#l517">517</a><td>    throw goog.iter.StopIteration;<tr><td><a id="l518"></a><a href="#l518">518</a><td>  };<tr><td><a id="l519"></a><a href="#l519">519</a><td>  return iter;<tr><td><a id="l520"></a><a href="#l520">520</a><td>};<tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td><tr><td><a id="l523"></a><a href="#l523">523</a><td>/**<tr><td><a id="l524"></a><a href="#l524">524</a><td> * Converts the iterator to an array<tr><td><a id="l525"></a><a href="#l525">525</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterator<tr><td><a id="l526"></a><a href="#l526">526</a><td> *     to convert to an array.<tr><td><a id="l527"></a><a href="#l527">527</a><td> * @return {!Array&lt;VALUE&gt;} An array of the elements the iterator iterates over.<tr><td><a id="l528"></a><a href="#l528">528</a><td> * @template VALUE<tr><td><a id="l529"></a><a href="#l529">529</a><td> */<tr><td><a id="l530"></a><a href="#l530">530</a><td>goog.iter.toArray = function(iterable) {<tr><td><a id="l531"></a><a href="#l531">531</a><td>  // Fast path for array-like.<tr><td><a id="l532"></a><a href="#l532">532</a><td>  if (goog.isArrayLike(iterable)) {<tr><td><a id="l533"></a><a href="#l533">533</a><td>    return goog.array.toArray(/** @type {!goog.array.ArrayLike} */(iterable));<tr><td><a id="l534"></a><a href="#l534">534</a><td>  }<tr><td><a id="l535"></a><a href="#l535">535</a><td>  iterable = goog.iter.toIterator(iterable);<tr><td><a id="l536"></a><a href="#l536">536</a><td>  var array = [];<tr><td><a id="l537"></a><a href="#l537">537</a><td>  goog.iter.forEach(iterable, function(val) {<tr><td><a id="l538"></a><a href="#l538">538</a><td>    array.push(val);<tr><td><a id="l539"></a><a href="#l539">539</a><td>  });<tr><td><a id="l540"></a><a href="#l540">540</a><td>  return array;<tr><td><a id="l541"></a><a href="#l541">541</a><td>};<tr><td><a id="l542"></a><a href="#l542">542</a><td><tr><td><a id="l543"></a><a href="#l543">543</a><td><tr><td><a id="l544"></a><a href="#l544">544</a><td>/**<tr><td><a id="l545"></a><a href="#l545">545</a><td> * Iterates over two iterables and returns true if they contain the same<tr><td><a id="l546"></a><a href="#l546">546</a><td> * sequence of elements and have the same length.<tr><td><a id="l547"></a><a href="#l547">547</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable1 The first<tr><td><a id="l548"></a><a href="#l548">548</a><td> *     iterable object.<tr><td><a id="l549"></a><a href="#l549">549</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable2 The second<tr><td><a id="l550"></a><a href="#l550">550</a><td> *     iterable object.<tr><td><a id="l551"></a><a href="#l551">551</a><td> * @param {function(VALUE,VALUE):boolean=} opt_equalsFn Optional comparison<tr><td><a id="l552"></a><a href="#l552">552</a><td> *     function.<tr><td><a id="l553"></a><a href="#l553">553</a><td> *     Should take two arguments to compare, and return true if the arguments<tr><td><a id="l554"></a><a href="#l554">554</a><td> *     are equal. Defaults to {@link goog.array.defaultCompareEquality} which<tr><td><a id="l555"></a><a href="#l555">555</a><td> *     compares the elements using the built-in &#39;===&#39; operator.<tr><td><a id="l556"></a><a href="#l556">556</a><td> * @return {boolean} true if the iterables contain the same sequence of elements<tr><td><a id="l557"></a><a href="#l557">557</a><td> *     and have the same length.<tr><td><a id="l558"></a><a href="#l558">558</a><td> * @template VALUE<tr><td><a id="l559"></a><a href="#l559">559</a><td> */<tr><td><a id="l560"></a><a href="#l560">560</a><td>goog.iter.equals = function(iterable1, iterable2, opt_equalsFn) {<tr><td><a id="l561"></a><a href="#l561">561</a><td>  var fillValue = {};<tr><td><a id="l562"></a><a href="#l562">562</a><td>  var pairs = goog.iter.zipLongest(fillValue, iterable1, iterable2);<tr><td><a id="l563"></a><a href="#l563">563</a><td>  var equalsFn = opt_equalsFn || goog.array.defaultCompareEquality;<tr><td><a id="l564"></a><a href="#l564">564</a><td>  return goog.iter.every(pairs, function(pair) {<tr><td><a id="l565"></a><a href="#l565">565</a><td>    return equalsFn(pair[0], pair[1]);<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>/**<tr><td><a id="l571"></a><a href="#l571">571</a><td> * Advances the iterator to the next position, returning the given default value<tr><td><a id="l572"></a><a href="#l572">572</a><td> * instead of throwing an exception if the iterator has no more entries.<tr><td><a id="l573"></a><a href="#l573">573</a><td> * @param {goog.iter.Iterator&lt;VALUE&gt;|goog.iter.Iterable} iterable The iterable<tr><td><a id="l574"></a><a href="#l574">574</a><td> *     object.<tr><td><a id="l575"></a><a href="#l575">575</a><td> * @param {VALUE} defaultValue The value to return if the iterator is empty.<tr><td><a id="l576"></a><a href="#l576">576</a><td> * @return {VALUE} The next item in the iteration, or defaultValue if the<tr><td><a id="l577"></a><a href="#l577">577</a><td> *     iterator was empty.<tr><td><a id="l578"></a><a href="#l578">578</a><td> * @template VALUE<tr><td><a id="l579"></a><a href="#l579">579</a><td> */<tr><td><a id="l580"></a><a href="#l580">580</a><td>goog.iter.nextOrValue = function(iterable, defaultValue) {<tr><td><a id="l581"></a><a href="#l581">581</a><td>  try {<tr><td><a id="l582"></a><a href="#l582">582</a><td>    return goog.iter.toIterator(iterable).next();<tr><td><a id="l583"></a><a href="#l583">583</a><td>  } catch (e) {<tr><td><a id="l584"></a><a href="#l584">584</a><td>    if (e != goog.iter.StopIteration) {<tr><td><a id="l585"></a><a href="#l585">585</a><td>      throw e;<tr><td><a id="l586"></a><a href="#l586">586</a><td>    }<tr><td><a id="l587"></a><a href="#l587">587</a><td>    return defaultValue;<tr><td><a id="l588"></a><a href="#l588">588</a><td>  }<tr><td><a id="l589"></a><a href="#l589">589</a><td>};<tr><td><a id="l590"></a><a href="#l590">590</a><td><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> * Cartesian product of zero or more sets.  Gives an iterator that gives every<tr><td><a id="l594"></a><a href="#l594">594</a><td> * combination of one element chosen from each set.  For example,<tr><td><a id="l595"></a><a href="#l595">595</a><td> * ([1, 2], [3, 4]) gives ([1, 3], [1, 4], [2, 3], [2, 4]).<tr><td><a id="l596"></a><a href="#l596">596</a><td> * @see http://docs.python.org/library/itertools.html#itertools.product<tr><td><a id="l597"></a><a href="#l597">597</a><td> * @param {...!goog.array.ArrayLike&lt;VALUE&gt;} var_args Zero or more sets, as<tr><td><a id="l598"></a><a href="#l598">598</a><td> *     arrays.<tr><td><a id="l599"></a><a href="#l599">599</a><td> * @return {!goog.iter.Iterator&lt;!Array&lt;VALUE&gt;&gt;} An iterator that gives each<tr><td><a id="l600"></a><a href="#l600">600</a><td> *     n-tuple (as an array).<tr><td><a id="l601"></a><a href="#l601">601</a><td> * @template VALUE<tr><td><a id="l602"></a><a href="#l602">602</a><td> */<tr><td><a id="l603"></a><a href="#l603">603</a><td>goog.iter.product = function(var_args) {<tr><td><a id="l604"></a><a href="#l604">604</a><td>  var someArrayEmpty = goog.array.some(arguments, function(arr) {<tr><td><a id="l605"></a><a href="#l605">605</a><td>    return !arr.length;<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>  // An empty set in a cartesian product gives an empty set.<tr><td><a id="l609"></a><a href="#l609">609</a><td>  if (someArrayEmpty || !arguments.length) {<tr><td><a id="l610"></a><a href="#l610">610</a><td>    return new goog.iter.Iterator();<tr><td><a id="l611"></a><a href="#l611">611</a><td>  }<tr><td><a id="l612"></a><a href="#l612">612</a><td><tr><td><a id="l613"></a><a href="#l613">613</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l614"></a><a href="#l614">614</a><td>  var arrays = arguments;<tr><td><a id="l615"></a><a href="#l615">615</a><td><tr><td><a id="l616"></a><a href="#l616">616</a><td>  // The first indices are [0, 0, ...]<tr><td><a id="l617"></a><a href="#l617">617</a><td>  var indicies = goog.array.repeat(0, arrays.length);<tr><td><a id="l618"></a><a href="#l618">618</a><td><tr><td><a id="l619"></a><a href="#l619">619</a><td>  iter.next = function() {<tr><td><a id="l620"></a><a href="#l620">620</a><td><tr><td><a id="l621"></a><a href="#l621">621</a><td>    if (indicies) {<tr><td><a id="l622"></a><a href="#l622">622</a><td>      var retVal = goog.array.map(indicies, function(valueIndex, arrayIndex) {<tr><td><a id="l623"></a><a href="#l623">623</a><td>        return arrays[arrayIndex][valueIndex];<tr><td><a id="l624"></a><a href="#l624">624</a><td>      });<tr><td><a id="l625"></a><a href="#l625">625</a><td><tr><td><a id="l626"></a><a href="#l626">626</a><td>      // Generate the next-largest indices for the next call.<tr><td><a id="l627"></a><a href="#l627">627</a><td>      // Increase the rightmost index. If it goes over, increase the next<tr><td><a id="l628"></a><a href="#l628">628</a><td>      // rightmost (like carry-over addition).<tr><td><a id="l629"></a><a href="#l629">629</a><td>      for (var i = indicies.length - 1; i &gt;= 0; i--) {<tr><td><a id="l630"></a><a href="#l630">630</a><td>        // Assertion prevents compiler warning below.<tr><td><a id="l631"></a><a href="#l631">631</a><td>        goog.asserts.assert(indicies);<tr><td><a id="l632"></a><a href="#l632">632</a><td>        if (indicies[i] &lt; arrays[i].length - 1) {<tr><td><a id="l633"></a><a href="#l633">633</a><td>          indicies[i]++;<tr><td><a id="l634"></a><a href="#l634">634</a><td>          break;<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>        // We&#39;re at the last indices (the last element of every array), so<tr><td><a id="l638"></a><a href="#l638">638</a><td>        // the iteration is over on the next call.<tr><td><a id="l639"></a><a href="#l639">639</a><td>        if (i == 0) {<tr><td><a id="l640"></a><a href="#l640">640</a><td>          indicies = null;<tr><td><a id="l641"></a><a href="#l641">641</a><td>          break;<tr><td><a id="l642"></a><a href="#l642">642</a><td>        }<tr><td><a id="l643"></a><a href="#l643">643</a><td>        // Reset the index in this column and loop back to increment the<tr><td><a id="l644"></a><a href="#l644">644</a><td>        // next one.<tr><td><a id="l645"></a><a href="#l645">645</a><td>        indicies[i] = 0;<tr><td><a id="l646"></a><a href="#l646">646</a><td>      }<tr><td><a id="l647"></a><a href="#l647">647</a><td>      return retVal;<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>    throw goog.iter.StopIteration;<tr><td><a id="l651"></a><a href="#l651">651</a><td>  };<tr><td><a id="l652"></a><a href="#l652">652</a><td><tr><td><a id="l653"></a><a href="#l653">653</a><td>  return iter;<tr><td><a id="l654"></a><a href="#l654">654</a><td>};<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> * Create an iterator to cycle over the iterable&#39;s elements indefinitely.<tr><td><a id="l659"></a><a href="#l659">659</a><td> * For example, ([1, 2, 3]) would return : 1, 2, 3, 1, 2, 3, ...<tr><td><a id="l660"></a><a href="#l660">660</a><td> * @see: http://docs.python.org/library/itertools.html#itertools.cycle.<tr><td><a id="l661"></a><a href="#l661">661</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l662"></a><a href="#l662">662</a><td> *     iterable object.<tr><td><a id="l663"></a><a href="#l663">663</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} An iterator that iterates indefinitely<tr><td><a id="l664"></a><a href="#l664">664</a><td> *     over the values in {@code iterable}.<tr><td><a id="l665"></a><a href="#l665">665</a><td> * @template VALUE<tr><td><a id="l666"></a><a href="#l666">666</a><td> */<tr><td><a id="l667"></a><a href="#l667">667</a><td>goog.iter.cycle = function(iterable) {<tr><td><a id="l668"></a><a href="#l668">668</a><td>  var baseIterator = goog.iter.toIterator(iterable);<tr><td><a id="l669"></a><a href="#l669">669</a><td><tr><td><a id="l670"></a><a href="#l670">670</a><td>  // We maintain a cache to store the iterable elements as we iterate<tr><td><a id="l671"></a><a href="#l671">671</a><td>  // over them. The cache is used to return elements once we have<tr><td><a id="l672"></a><a href="#l672">672</a><td>  // iterated over the iterable once.<tr><td><a id="l673"></a><a href="#l673">673</a><td>  var cache = [];<tr><td><a id="l674"></a><a href="#l674">674</a><td>  var cacheIndex = 0;<tr><td><a id="l675"></a><a href="#l675">675</a><td><tr><td><a id="l676"></a><a href="#l676">676</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l677"></a><a href="#l677">677</a><td><tr><td><a id="l678"></a><a href="#l678">678</a><td>  // This flag is set after the iterable is iterated over once<tr><td><a id="l679"></a><a href="#l679">679</a><td>  var useCache = false;<tr><td><a id="l680"></a><a href="#l680">680</a><td><tr><td><a id="l681"></a><a href="#l681">681</a><td>  iter.next = function() {<tr><td><a id="l682"></a><a href="#l682">682</a><td>    var returnElement = null;<tr><td><a id="l683"></a><a href="#l683">683</a><td><tr><td><a id="l684"></a><a href="#l684">684</a><td>    // Pull elements off the original iterator if not using cache<tr><td><a id="l685"></a><a href="#l685">685</a><td>    if (!useCache) {<tr><td><a id="l686"></a><a href="#l686">686</a><td>      try {<tr><td><a id="l687"></a><a href="#l687">687</a><td>        // Return the element from the iterable<tr><td><a id="l688"></a><a href="#l688">688</a><td>        returnElement = baseIterator.next();<tr><td><a id="l689"></a><a href="#l689">689</a><td>        cache.push(returnElement);<tr><td><a id="l690"></a><a href="#l690">690</a><td>        return returnElement;<tr><td><a id="l691"></a><a href="#l691">691</a><td>      } catch (e) {<tr><td><a id="l692"></a><a href="#l692">692</a><td>        // If an exception other than StopIteration is thrown<tr><td><a id="l693"></a><a href="#l693">693</a><td>        // or if there are no elements to iterate over (the iterable was empty)<tr><td><a id="l694"></a><a href="#l694">694</a><td>        // throw an exception<tr><td><a id="l695"></a><a href="#l695">695</a><td>        if (e != goog.iter.StopIteration || goog.array.isEmpty(cache)) {<tr><td><a id="l696"></a><a href="#l696">696</a><td>          throw e;<tr><td><a id="l697"></a><a href="#l697">697</a><td>        }<tr><td><a id="l698"></a><a href="#l698">698</a><td>        // set useCache to true after we know that a &#39;StopIteration&#39; exception<tr><td><a id="l699"></a><a href="#l699">699</a><td>        // was thrown and the cache is not empty (to handle the &#39;empty iterable&#39;<tr><td><a id="l700"></a><a href="#l700">700</a><td>        // use case)<tr><td><a id="l701"></a><a href="#l701">701</a><td>        useCache = true;<tr><td><a id="l702"></a><a href="#l702">702</a><td>      }<tr><td><a id="l703"></a><a href="#l703">703</a><td>    }<tr><td><a id="l704"></a><a href="#l704">704</a><td><tr><td><a id="l705"></a><a href="#l705">705</a><td>    returnElement = cache[cacheIndex];<tr><td><a id="l706"></a><a href="#l706">706</a><td>    cacheIndex = (cacheIndex + 1) % cache.length;<tr><td><a id="l707"></a><a href="#l707">707</a><td><tr><td><a id="l708"></a><a href="#l708">708</a><td>    return returnElement;<tr><td><a id="l709"></a><a href="#l709">709</a><td>  };<tr><td><a id="l710"></a><a href="#l710">710</a><td><tr><td><a id="l711"></a><a href="#l711">711</a><td>  return iter;<tr><td><a id="l712"></a><a href="#l712">712</a><td>};<tr><td><a id="l713"></a><a href="#l713">713</a><td><tr><td><a id="l714"></a><a href="#l714">714</a><td><tr><td><a id="l715"></a><a href="#l715">715</a><td>/**<tr><td><a id="l716"></a><a href="#l716">716</a><td> * Creates an iterator that counts indefinitely from a starting value.<tr><td><a id="l717"></a><a href="#l717">717</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.count<tr><td><a id="l718"></a><a href="#l718">718</a><td> * @param {number=} opt_start The starting value. Default is 0.<tr><td><a id="l719"></a><a href="#l719">719</a><td> * @param {number=} opt_step The number to increment with between each call to<tr><td><a id="l720"></a><a href="#l720">720</a><td> *     next. Negative and floating point numbers are allowed. Default is 1.<tr><td><a id="l721"></a><a href="#l721">721</a><td> * @return {!goog.iter.Iterator&lt;number&gt;} A new iterator that returns the values<tr><td><a id="l722"></a><a href="#l722">722</a><td> *     in the series.<tr><td><a id="l723"></a><a href="#l723">723</a><td> */<tr><td><a id="l724"></a><a href="#l724">724</a><td>goog.iter.count = function(opt_start, opt_step) {<tr><td><a id="l725"></a><a href="#l725">725</a><td>  var counter = opt_start || 0;<tr><td><a id="l726"></a><a href="#l726">726</a><td>  var step = goog.isDef(opt_step) ? opt_step : 1;<tr><td><a id="l727"></a><a href="#l727">727</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l728"></a><a href="#l728">728</a><td><tr><td><a id="l729"></a><a href="#l729">729</a><td>  iter.next = function() {<tr><td><a id="l730"></a><a href="#l730">730</a><td>    var returnValue = counter;<tr><td><a id="l731"></a><a href="#l731">731</a><td>    counter += step;<tr><td><a id="l732"></a><a href="#l732">732</a><td>    return returnValue;<tr><td><a id="l733"></a><a href="#l733">733</a><td>  };<tr><td><a id="l734"></a><a href="#l734">734</a><td><tr><td><a id="l735"></a><a href="#l735">735</a><td>  return iter;<tr><td><a id="l736"></a><a href="#l736">736</a><td>};<tr><td><a id="l737"></a><a href="#l737">737</a><td><tr><td><a id="l738"></a><a href="#l738">738</a><td><tr><td><a id="l739"></a><a href="#l739">739</a><td>/**<tr><td><a id="l740"></a><a href="#l740">740</a><td> * Creates an iterator that returns the same object or value repeatedly.<tr><td><a id="l741"></a><a href="#l741">741</a><td> * @param {VALUE} value Any object or value to repeat.<tr><td><a id="l742"></a><a href="#l742">742</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} A new iterator that returns the<tr><td><a id="l743"></a><a href="#l743">743</a><td> *     repeated value.<tr><td><a id="l744"></a><a href="#l744">744</a><td> * @template VALUE<tr><td><a id="l745"></a><a href="#l745">745</a><td> */<tr><td><a id="l746"></a><a href="#l746">746</a><td>goog.iter.repeat = function(value) {<tr><td><a id="l747"></a><a href="#l747">747</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l748"></a><a href="#l748">748</a><td><tr><td><a id="l749"></a><a href="#l749">749</a><td>  iter.next = goog.functions.constant(value);<tr><td><a id="l750"></a><a href="#l750">750</a><td><tr><td><a id="l751"></a><a href="#l751">751</a><td>  return iter;<tr><td><a id="l752"></a><a href="#l752">752</a><td>};<tr><td><a id="l753"></a><a href="#l753">753</a><td><tr><td><a id="l754"></a><a href="#l754">754</a><td><tr><td><a id="l755"></a><a href="#l755">755</a><td>/**<tr><td><a id="l756"></a><a href="#l756">756</a><td> * Creates an iterator that returns running totals from the numbers in<tr><td><a id="l757"></a><a href="#l757">757</a><td> * {@code iterable}. For example, the array {@code [1, 2, 3, 4, 5]} yields<tr><td><a id="l758"></a><a href="#l758">758</a><td> * {@code 1 -&gt; 3 -&gt; 6 -&gt; 10 -&gt; 15}.<tr><td><a id="l759"></a><a href="#l759">759</a><td> * @see http://docs.python.org/3.2/library/itertools.html#itertools.accumulate<tr><td><a id="l760"></a><a href="#l760">760</a><td> * @param {!goog.iter.Iterable&lt;number&gt;} iterable The iterable of numbers to<tr><td><a id="l761"></a><a href="#l761">761</a><td> *     accumulate.<tr><td><a id="l762"></a><a href="#l762">762</a><td> * @return {!goog.iter.Iterator&lt;number&gt;} A new iterator that returns the<tr><td><a id="l763"></a><a href="#l763">763</a><td> *     numbers in the series.<tr><td><a id="l764"></a><a href="#l764">764</a><td> */<tr><td><a id="l765"></a><a href="#l765">765</a><td>goog.iter.accumulate = function(iterable) {<tr><td><a id="l766"></a><a href="#l766">766</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l767"></a><a href="#l767">767</a><td>  var total = 0;<tr><td><a id="l768"></a><a href="#l768">768</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l769"></a><a href="#l769">769</a><td><tr><td><a id="l770"></a><a href="#l770">770</a><td>  iter.next = function() {<tr><td><a id="l771"></a><a href="#l771">771</a><td>    total += iterator.next();<tr><td><a id="l772"></a><a href="#l772">772</a><td>    return total;<tr><td><a id="l773"></a><a href="#l773">773</a><td>  };<tr><td><a id="l774"></a><a href="#l774">774</a><td><tr><td><a id="l775"></a><a href="#l775">775</a><td>  return iter;<tr><td><a id="l776"></a><a href="#l776">776</a><td>};<tr><td><a id="l777"></a><a href="#l777">777</a><td><tr><td><a id="l778"></a><a href="#l778">778</a><td><tr><td><a id="l779"></a><a href="#l779">779</a><td>/**<tr><td><a id="l780"></a><a href="#l780">780</a><td> * Creates an iterator that returns arrays containing the ith elements from the<tr><td><a id="l781"></a><a href="#l781">781</a><td> * provided iterables. The returned arrays will be the same size as the number<tr><td><a id="l782"></a><a href="#l782">782</a><td> * of iterables given in {@code var_args}. Once the shortest iterable is<tr><td><a id="l783"></a><a href="#l783">783</a><td> * exhausted, subsequent calls to {@code next()} will throw<tr><td><a id="l784"></a><a href="#l784">784</a><td> * {@code goog.iter.StopIteration}.<tr><td><a id="l785"></a><a href="#l785">785</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.izip<tr><td><a id="l786"></a><a href="#l786">786</a><td> * @param {...!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} var_args Any<tr><td><a id="l787"></a><a href="#l787">787</a><td> *     number of iterable objects.<tr><td><a id="l788"></a><a href="#l788">788</a><td> * @return {!goog.iter.Iterator&lt;!Array&lt;VALUE&gt;&gt;} A new iterator that returns<tr><td><a id="l789"></a><a href="#l789">789</a><td> *     arrays of elements from the provided iterables.<tr><td><a id="l790"></a><a href="#l790">790</a><td> * @template VALUE<tr><td><a id="l791"></a><a href="#l791">791</a><td> */<tr><td><a id="l792"></a><a href="#l792">792</a><td>goog.iter.zip = function(var_args) {<tr><td><a id="l793"></a><a href="#l793">793</a><td>  var args = arguments;<tr><td><a id="l794"></a><a href="#l794">794</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l795"></a><a href="#l795">795</a><td><tr><td><a id="l796"></a><a href="#l796">796</a><td>  if (args.length &gt; 0) {<tr><td><a id="l797"></a><a href="#l797">797</a><td>    var iterators = goog.array.map(args, goog.iter.toIterator);<tr><td><a id="l798"></a><a href="#l798">798</a><td>    iter.next = function() {<tr><td><a id="l799"></a><a href="#l799">799</a><td>      var arr = goog.array.map(iterators, function(it) {<tr><td><a id="l800"></a><a href="#l800">800</a><td>        return it.next();<tr><td><a id="l801"></a><a href="#l801">801</a><td>      });<tr><td><a id="l802"></a><a href="#l802">802</a><td>      return arr;<tr><td><a id="l803"></a><a href="#l803">803</a><td>    };<tr><td><a id="l804"></a><a href="#l804">804</a><td>  }<tr><td><a id="l805"></a><a href="#l805">805</a><td><tr><td><a id="l806"></a><a href="#l806">806</a><td>  return iter;<tr><td><a id="l807"></a><a href="#l807">807</a><td>};<tr><td><a id="l808"></a><a href="#l808">808</a><td><tr><td><a id="l809"></a><a href="#l809">809</a><td><tr><td><a id="l810"></a><a href="#l810">810</a><td>/**<tr><td><a id="l811"></a><a href="#l811">811</a><td> * Creates an iterator that returns arrays containing the ith elements from the<tr><td><a id="l812"></a><a href="#l812">812</a><td> * provided iterables. The returned arrays will be the same size as the number<tr><td><a id="l813"></a><a href="#l813">813</a><td> * of iterables given in {@code var_args}. Shorter iterables will be extended<tr><td><a id="l814"></a><a href="#l814">814</a><td> * with {@code fillValue}. Once the longest iterable is exhausted, subsequent<tr><td><a id="l815"></a><a href="#l815">815</a><td> * calls to {@code next()} will throw {@code goog.iter.StopIteration}.<tr><td><a id="l816"></a><a href="#l816">816</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.izip_longest<tr><td><a id="l817"></a><a href="#l817">817</a><td> * @param {VALUE} fillValue The object or value used to fill shorter iterables.<tr><td><a id="l818"></a><a href="#l818">818</a><td> * @param {...!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} var_args Any<tr><td><a id="l819"></a><a href="#l819">819</a><td> *     number of iterable objects.<tr><td><a id="l820"></a><a href="#l820">820</a><td> * @return {!goog.iter.Iterator&lt;!Array&lt;VALUE&gt;&gt;} A new iterator that returns<tr><td><a id="l821"></a><a href="#l821">821</a><td> *     arrays of elements from the provided iterables.<tr><td><a id="l822"></a><a href="#l822">822</a><td> * @template VALUE<tr><td><a id="l823"></a><a href="#l823">823</a><td> */<tr><td><a id="l824"></a><a href="#l824">824</a><td>goog.iter.zipLongest = function(fillValue, var_args) {<tr><td><a id="l825"></a><a href="#l825">825</a><td>  var args = goog.array.slice(arguments, 1);<tr><td><a id="l826"></a><a href="#l826">826</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l827"></a><a href="#l827">827</a><td><tr><td><a id="l828"></a><a href="#l828">828</a><td>  if (args.length &gt; 0) {<tr><td><a id="l829"></a><a href="#l829">829</a><td>    var iterators = goog.array.map(args, goog.iter.toIterator);<tr><td><a id="l830"></a><a href="#l830">830</a><td><tr><td><a id="l831"></a><a href="#l831">831</a><td>    iter.next = function() {<tr><td><a id="l832"></a><a href="#l832">832</a><td>      var iteratorsHaveValues = false;  // false when all iterators are empty.<tr><td><a id="l833"></a><a href="#l833">833</a><td>      var arr = goog.array.map(iterators, function(it) {<tr><td><a id="l834"></a><a href="#l834">834</a><td>        var returnValue;<tr><td><a id="l835"></a><a href="#l835">835</a><td>        try {<tr><td><a id="l836"></a><a href="#l836">836</a><td>          returnValue = it.next();<tr><td><a id="l837"></a><a href="#l837">837</a><td>          // Iterator had a value, so we&#39;ve not exhausted the iterators.<tr><td><a id="l838"></a><a href="#l838">838</a><td>          // Set flag accordingly.<tr><td><a id="l839"></a><a href="#l839">839</a><td>          iteratorsHaveValues = true;<tr><td><a id="l840"></a><a href="#l840">840</a><td>        } catch (ex) {<tr><td><a id="l841"></a><a href="#l841">841</a><td>          if (ex !== goog.iter.StopIteration) {<tr><td><a id="l842"></a><a href="#l842">842</a><td>            throw ex;<tr><td><a id="l843"></a><a href="#l843">843</a><td>          }<tr><td><a id="l844"></a><a href="#l844">844</a><td>          returnValue = fillValue;<tr><td><a id="l845"></a><a href="#l845">845</a><td>        }<tr><td><a id="l846"></a><a href="#l846">846</a><td>        return returnValue;<tr><td><a id="l847"></a><a href="#l847">847</a><td>      });<tr><td><a id="l848"></a><a href="#l848">848</a><td><tr><td><a id="l849"></a><a href="#l849">849</a><td>      if (!iteratorsHaveValues) {<tr><td><a id="l850"></a><a href="#l850">850</a><td>        throw goog.iter.StopIteration;<tr><td><a id="l851"></a><a href="#l851">851</a><td>      }<tr><td><a id="l852"></a><a href="#l852">852</a><td>      return arr;<tr><td><a id="l853"></a><a href="#l853">853</a><td>    };<tr><td><a id="l854"></a><a href="#l854">854</a><td>  }<tr><td><a id="l855"></a><a href="#l855">855</a><td><tr><td><a id="l856"></a><a href="#l856">856</a><td>  return iter;<tr><td><a id="l857"></a><a href="#l857">857</a><td>};<tr><td><a id="l858"></a><a href="#l858">858</a><td><tr><td><a id="l859"></a><a href="#l859">859</a><td><tr><td><a id="l860"></a><a href="#l860">860</a><td>/**<tr><td><a id="l861"></a><a href="#l861">861</a><td> * Creates an iterator that filters {@code iterable} based on a series of<tr><td><a id="l862"></a><a href="#l862">862</a><td> * {@code selectors}. On each call to {@code next()}, one item is taken from<tr><td><a id="l863"></a><a href="#l863">863</a><td> * both the {@code iterable} and {@code selectors} iterators. If the item from<tr><td><a id="l864"></a><a href="#l864">864</a><td> * {@code selectors} evaluates to true, the item from {@code iterable} is given.<tr><td><a id="l865"></a><a href="#l865">865</a><td> * Otherwise, it is skipped. Once either {@code iterable} or {@code selectors}<tr><td><a id="l866"></a><a href="#l866">866</a><td> * is exhausted, subsequent calls to {@code next()} will throw<tr><td><a id="l867"></a><a href="#l867">867</a><td> * {@code goog.iter.StopIteration}.<tr><td><a id="l868"></a><a href="#l868">868</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.compress<tr><td><a id="l869"></a><a href="#l869">869</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l870"></a><a href="#l870">870</a><td> *     iterable to filter.<tr><td><a id="l871"></a><a href="#l871">871</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} selectors An<tr><td><a id="l872"></a><a href="#l872">872</a><td> *     iterable of items to be evaluated in a boolean context to determine if<tr><td><a id="l873"></a><a href="#l873">873</a><td> *     the corresponding element in {@code iterable} should be included in the<tr><td><a id="l874"></a><a href="#l874">874</a><td> *     result.<tr><td><a id="l875"></a><a href="#l875">875</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} A new iterator that returns the<tr><td><a id="l876"></a><a href="#l876">876</a><td> *     filtered values.<tr><td><a id="l877"></a><a href="#l877">877</a><td> * @template VALUE<tr><td><a id="l878"></a><a href="#l878">878</a><td> */<tr><td><a id="l879"></a><a href="#l879">879</a><td>goog.iter.compress = function(iterable, selectors) {<tr><td><a id="l880"></a><a href="#l880">880</a><td>  var selectorIterator = goog.iter.toIterator(selectors);<tr><td><a id="l881"></a><a href="#l881">881</a><td><tr><td><a id="l882"></a><a href="#l882">882</a><td>  return goog.iter.filter(iterable, function() {<tr><td><a id="l883"></a><a href="#l883">883</a><td>    return !!selectorIterator.next();<tr><td><a id="l884"></a><a href="#l884">884</a><td>  });<tr><td><a id="l885"></a><a href="#l885">885</a><td>};<tr><td><a id="l886"></a><a href="#l886">886</a><td><tr><td><a id="l887"></a><a href="#l887">887</a><td><tr><td><a id="l888"></a><a href="#l888">888</a><td><tr><td><a id="l889"></a><a href="#l889">889</a><td>/**<tr><td><a id="l890"></a><a href="#l890">890</a><td> * Implements the {@code goog.iter.groupBy} iterator.<tr><td><a id="l891"></a><a href="#l891">891</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l892"></a><a href="#l892">892</a><td> *     iterable to group.<tr><td><a id="l893"></a><a href="#l893">893</a><td> * @param {function(...VALUE): KEY=} opt_keyFunc  Optional function for<tr><td><a id="l894"></a><a href="#l894">894</a><td> *     determining the key value for each group in the {@code iterable}. Default<tr><td><a id="l895"></a><a href="#l895">895</a><td> *     is the identity function.<tr><td><a id="l896"></a><a href="#l896">896</a><td> * @constructor<tr><td><a id="l897"></a><a href="#l897">897</a><td> * @extends {goog.iter.Iterator&lt;!Array&lt;?&gt;&gt;}<tr><td><a id="l898"></a><a href="#l898">898</a><td> * @template KEY, VALUE<tr><td><a id="l899"></a><a href="#l899">899</a><td> * @private<tr><td><a id="l900"></a><a href="#l900">900</a><td> */<tr><td><a id="l901"></a><a href="#l901">901</a><td>goog.iter.GroupByIterator_ = function(iterable, opt_keyFunc) {<tr><td><a id="l902"></a><a href="#l902">902</a><td><tr><td><a id="l903"></a><a href="#l903">903</a><td>  /**<tr><td><a id="l904"></a><a href="#l904">904</a><td>   * The iterable to group, coerced to an iterator.<tr><td><a id="l905"></a><a href="#l905">905</a><td>   * @type {!goog.iter.Iterator}<tr><td><a id="l906"></a><a href="#l906">906</a><td>   */<tr><td><a id="l907"></a><a href="#l907">907</a><td>  this.iterator = goog.iter.toIterator(iterable);<tr><td><a id="l908"></a><a href="#l908">908</a><td><tr><td><a id="l909"></a><a href="#l909">909</a><td>  /**<tr><td><a id="l910"></a><a href="#l910">910</a><td>   * A function for determining the key value for each element in the iterable.<tr><td><a id="l911"></a><a href="#l911">911</a><td>   * If no function is provided, the identity function is used and returns the<tr><td><a id="l912"></a><a href="#l912">912</a><td>   * element unchanged.<tr><td><a id="l913"></a><a href="#l913">913</a><td>   * @type {function(...VALUE): KEY}<tr><td><a id="l914"></a><a href="#l914">914</a><td>   */<tr><td><a id="l915"></a><a href="#l915">915</a><td>  this.keyFunc = opt_keyFunc || goog.functions.identity;<tr><td><a id="l916"></a><a href="#l916">916</a><td><tr><td><a id="l917"></a><a href="#l917">917</a><td>  /**<tr><td><a id="l918"></a><a href="#l918">918</a><td>   * The target key for determining the start of a group.<tr><td><a id="l919"></a><a href="#l919">919</a><td>   * @type {KEY}<tr><td><a id="l920"></a><a href="#l920">920</a><td>   */<tr><td><a id="l921"></a><a href="#l921">921</a><td>  this.targetKey;<tr><td><a id="l922"></a><a href="#l922">922</a><td><tr><td><a id="l923"></a><a href="#l923">923</a><td>  /**<tr><td><a id="l924"></a><a href="#l924">924</a><td>   * The current key visited during iteration.<tr><td><a id="l925"></a><a href="#l925">925</a><td>   * @type {KEY}<tr><td><a id="l926"></a><a href="#l926">926</a><td>   */<tr><td><a id="l927"></a><a href="#l927">927</a><td>  this.currentKey;<tr><td><a id="l928"></a><a href="#l928">928</a><td><tr><td><a id="l929"></a><a href="#l929">929</a><td>  /**<tr><td><a id="l930"></a><a href="#l930">930</a><td>   * The current value being added to the group.<tr><td><a id="l931"></a><a href="#l931">931</a><td>   * @type {VALUE}<tr><td><a id="l932"></a><a href="#l932">932</a><td>   */<tr><td><a id="l933"></a><a href="#l933">933</a><td>  this.currentValue;<tr><td><a id="l934"></a><a href="#l934">934</a><td>};<tr><td><a id="l935"></a><a href="#l935">935</a><td>goog.inherits(goog.iter.GroupByIterator_, goog.iter.Iterator);<tr><td><a id="l936"></a><a href="#l936">936</a><td><tr><td><a id="l937"></a><a href="#l937">937</a><td><tr><td><a id="l938"></a><a href="#l938">938</a><td>/** @override */<tr><td><a id="l939"></a><a href="#l939">939</a><td>goog.iter.GroupByIterator_.prototype.next = function() {<tr><td><a id="l940"></a><a href="#l940">940</a><td>  while (this.currentKey == this.targetKey) {<tr><td><a id="l941"></a><a href="#l941">941</a><td>    this.currentValue = this.iterator.next();  // Exits on StopIteration<tr><td><a id="l942"></a><a href="#l942">942</a><td>    this.currentKey = this.keyFunc(this.currentValue);<tr><td><a id="l943"></a><a href="#l943">943</a><td>  }<tr><td><a id="l944"></a><a href="#l944">944</a><td>  this.targetKey = this.currentKey;<tr><td><a id="l945"></a><a href="#l945">945</a><td>  return [this.currentKey, this.groupItems_(this.targetKey)];<tr><td><a id="l946"></a><a href="#l946">946</a><td>};<tr><td><a id="l947"></a><a href="#l947">947</a><td><tr><td><a id="l948"></a><a href="#l948">948</a><td><tr><td><a id="l949"></a><a href="#l949">949</a><td>/**<tr><td><a id="l950"></a><a href="#l950">950</a><td> * Performs the grouping of objects using the given key.<tr><td><a id="l951"></a><a href="#l951">951</a><td> * @param {KEY} targetKey  The target key object for the group.<tr><td><a id="l952"></a><a href="#l952">952</a><td> * @return {!Array&lt;VALUE&gt;} An array of grouped objects.<tr><td><a id="l953"></a><a href="#l953">953</a><td> * @private<tr><td><a id="l954"></a><a href="#l954">954</a><td> */<tr><td><a id="l955"></a><a href="#l955">955</a><td>goog.iter.GroupByIterator_.prototype.groupItems_ = function(targetKey) {<tr><td><a id="l956"></a><a href="#l956">956</a><td>  var arr = [];<tr><td><a id="l957"></a><a href="#l957">957</a><td>  while (this.currentKey == targetKey) {<tr><td><a id="l958"></a><a href="#l958">958</a><td>    arr.push(this.currentValue);<tr><td><a id="l959"></a><a href="#l959">959</a><td>    try {<tr><td><a id="l960"></a><a href="#l960">960</a><td>      this.currentValue = this.iterator.next();<tr><td><a id="l961"></a><a href="#l961">961</a><td>    } catch (ex) {<tr><td><a id="l962"></a><a href="#l962">962</a><td>      if (ex !== goog.iter.StopIteration) {<tr><td><a id="l963"></a><a href="#l963">963</a><td>        throw ex;<tr><td><a id="l964"></a><a href="#l964">964</a><td>      }<tr><td><a id="l965"></a><a href="#l965">965</a><td>      break;<tr><td><a id="l966"></a><a href="#l966">966</a><td>    }<tr><td><a id="l967"></a><a href="#l967">967</a><td>    this.currentKey = this.keyFunc(this.currentValue);<tr><td><a id="l968"></a><a href="#l968">968</a><td>  }<tr><td><a id="l969"></a><a href="#l969">969</a><td>  return arr;<tr><td><a id="l970"></a><a href="#l970">970</a><td>};<tr><td><a id="l971"></a><a href="#l971">971</a><td><tr><td><a id="l972"></a><a href="#l972">972</a><td><tr><td><a id="l973"></a><a href="#l973">973</a><td>/**<tr><td><a id="l974"></a><a href="#l974">974</a><td> * Creates an iterator that returns arrays containing elements from the<tr><td><a id="l975"></a><a href="#l975">975</a><td> * {@code iterable} grouped by a key value. For iterables with repeated<tr><td><a id="l976"></a><a href="#l976">976</a><td> * elements (i.e. sorted according to a particular key function), this function<tr><td><a id="l977"></a><a href="#l977">977</a><td> * has a {@code uniq}-like effect. For example, grouping the array:<tr><td><a id="l978"></a><a href="#l978">978</a><td> * {@code [A, B, B, C, C, A]} produces<tr><td><a id="l979"></a><a href="#l979">979</a><td> * {@code [A, [A]], [B, [B, B]], [C, [C, C]], [A, [A]]}.<tr><td><a id="l980"></a><a href="#l980">980</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.groupby<tr><td><a id="l981"></a><a href="#l981">981</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l982"></a><a href="#l982">982</a><td> *     iterable to group.<tr><td><a id="l983"></a><a href="#l983">983</a><td> * @param {function(...VALUE): KEY=} opt_keyFunc  Optional function for<tr><td><a id="l984"></a><a href="#l984">984</a><td> *     determining the key value for each group in the {@code iterable}. Default<tr><td><a id="l985"></a><a href="#l985">985</a><td> *     is the identity function.<tr><td><a id="l986"></a><a href="#l986">986</a><td> * @return {!goog.iter.Iterator&lt;!Array&lt;?&gt;&gt;} A new iterator that returns<tr><td><a id="l987"></a><a href="#l987">987</a><td> *     arrays of consecutive key and groups.<tr><td><a id="l988"></a><a href="#l988">988</a><td> * @template KEY, VALUE<tr><td><a id="l989"></a><a href="#l989">989</a><td> */<tr><td><a id="l990"></a><a href="#l990">990</a><td>goog.iter.groupBy = function(iterable, opt_keyFunc) {<tr><td><a id="l991"></a><a href="#l991">991</a><td>  return new goog.iter.GroupByIterator_(iterable, opt_keyFunc);<tr><td><a id="l992"></a><a href="#l992">992</a><td>};<tr><td><a id="l993"></a><a href="#l993">993</a><td><tr><td><a id="l994"></a><a href="#l994">994</a><td><tr><td><a id="l995"></a><a href="#l995">995</a><td>/**<tr><td><a id="l996"></a><a href="#l996">996</a><td> * Gives an iterator that gives the result of calling the given function<tr><td><a id="l997"></a><a href="#l997">997</a><td> * &lt;code&gt;f&lt;/code&gt; with the arguments taken from the next element from<tr><td><a id="l998"></a><a href="#l998">998</a><td> * &lt;code&gt;iterable&lt;/code&gt; (the elements are expected to also be iterables).<tr><td><a id="l999"></a><a href="#l999">999</a><td> *<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td> * Similar to {@see goog.iter#map} but allows the function to accept multiple<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td> * arguments from the iterable.<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td> *<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td> * @param {!goog.iter.Iterable&lt;!goog.iter.Iterable&gt;} iterable The iterable of<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td> *     iterables to iterate over.<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td> * @param {function(this:THIS,...*):RESULT} f The function to call for every<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td> *     element.  This function takes N+2 arguments, where N represents the<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td> *     number of items from the next element of the iterable. The two<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td> *     additional arguments passed to the function are undefined and the<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td> *     iterator itself. The function should return a new value.<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td> * @param {THIS=} opt_obj The object to be used as the value of &#39;this&#39; within<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td> *     {@code f}.<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td> * @return {!goog.iter.Iterator&lt;RESULT&gt;} A new iterator that returns the<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td> *     results of applying the function to each element in the original<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td> *     iterator.<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td> * @template THIS, RESULT<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td> */<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td>goog.iter.starMap = function(iterable, f, opt_obj) {<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td><tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>  iter.next = function() {<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td>    var args = goog.iter.toArray(iterator.next());<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td>    return f.apply(opt_obj, goog.array.concat(args, undefined, iterator));<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td>  };<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td><tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>  return iter;<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>};<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td><tr><td><a id="l1029"></a><a href="#l1029">1029</a><td><tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>/**<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td> * Returns an array of iterators each of which can iterate over the values in<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td> * {@code iterable} without advancing the others.<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.tee<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td> *     iterable to tee.<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td> * @param {number=} opt_num  The number of iterators to create. Default is 2.<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td> * @return {!Array&lt;goog.iter.Iterator&lt;VALUE&gt;&gt;} An array of iterators.<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td> * @template VALUE<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td> */<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>goog.iter.tee = function(iterable, opt_num) {<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td>  var num = goog.isNumber(opt_num) ? opt_num : 2;<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td>  var buffers = goog.array.map(goog.array.range(num), function() {<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>    return [];<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td>  });<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td><tr><td><a id="l1047"></a><a href="#l1047">1047</a><td>  var addNextIteratorValueToBuffers = function() {<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>    var val = iterator.next();<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td>    goog.array.forEach(buffers, function(buffer) {<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>      buffer.push(val);<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td>    });<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td>  };<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td><tr><td><a id="l1054"></a><a href="#l1054">1054</a><td>  var createIterator = function(buffer) {<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td>    // Each tee&#39;d iterator has an associated buffer (initially empty). When a<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td>    // tee&#39;d iterator&#39;s buffer is empty, it calls<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td>    // addNextIteratorValueToBuffers(), adding the next value to all tee&#39;d<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td>    // iterators&#39; buffers, and then returns that value. This allows each<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td>    // iterator to be advanced independently.<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td>    var iter = new goog.iter.Iterator();<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td><tr><td><a id="l1062"></a><a href="#l1062">1062</a><td>    iter.next = function() {<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td>      if (goog.array.isEmpty(buffer)) {<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td>        addNextIteratorValueToBuffers();<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td>      }<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td>      goog.asserts.assert(!goog.array.isEmpty(buffer));<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>      return buffer.shift();<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td>    };<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td><tr><td><a id="l1070"></a><a href="#l1070">1070</a><td>    return iter;<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td>  };<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td><tr><td><a id="l1073"></a><a href="#l1073">1073</a><td>  return goog.array.map(buffers, createIterator);<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>};<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td><tr><td><a id="l1076"></a><a href="#l1076">1076</a><td><tr><td><a id="l1077"></a><a href="#l1077">1077</a><td>/**<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td> * Creates an iterator that returns arrays containing a count and an element<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td> * obtained from the given {@code iterable}.<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td> * @see http://docs.python.org/2/library/functions.html#enumerate<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td> *     iterable to enumerate.<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td> * @param {number=} opt_start  Optional starting value. Default is 0.<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td> * @return {!goog.iter.Iterator&lt;!Array&lt;?&gt;&gt;} A new iterator containing<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td> *     count/item pairs.<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td> * @template VALUE<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td> */<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>goog.iter.enumerate = function(iterable, opt_start) {<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>  return goog.iter.zip(goog.iter.count(opt_start), iterable);<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>};<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td><tr><td><a id="l1092"></a><a href="#l1092">1092</a><td><tr><td><a id="l1093"></a><a href="#l1093">1093</a><td>/**<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td> * Creates an iterator that returns the first {@code limitSize} elements from an<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td> * iterable. If this number is greater than the number of elements in the<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td> * iterable, all the elements are returned.<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td> * @see http://goo.gl/V0sihp Inspired by the limit iterator in Guava.<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td> *     iterable to limit.<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td> * @param {number} limitSize  The maximum number of elements to return.<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} A new iterator containing<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td> *     {@code limitSize} elements.<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td> * @template VALUE<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td> */<tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>goog.iter.limit = function(iterable, limitSize) {<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td>  goog.asserts.assert(goog.math.isInt(limitSize) &amp;&amp; limitSize &gt;= 0);<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td><tr><td><a id="l1108"></a><a href="#l1108">1108</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td><tr><td><a id="l1110"></a><a href="#l1110">1110</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td>  var remaining = limitSize;<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td><tr><td><a id="l1113"></a><a href="#l1113">1113</a><td>  iter.next = function() {<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td>    if (remaining-- &gt; 0) {<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td>      return iterator.next();<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td>    }<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td>    throw goog.iter.StopIteration;<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td>  };<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td><tr><td><a id="l1120"></a><a href="#l1120">1120</a><td>  return iter;<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td>};<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td><tr><td><a id="l1123"></a><a href="#l1123">1123</a><td><tr><td><a id="l1124"></a><a href="#l1124">1124</a><td>/**<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td> * Creates an iterator that is advanced {@code count} steps ahead. Consumed<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td> * values are silently discarded. If {@code count} is greater than the number<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td> * of elements in {@code iterable}, an empty iterator is returned. Subsequent<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td> * calls to {@code next()} will throw {@code goog.iter.StopIteration}.<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td> *     iterable to consume.<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td> * @param {number} count  The number of elements to consume from the iterator.<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} An iterator advanced zero or more steps<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td> *     ahead.<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td> * @template VALUE<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td> */<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td>goog.iter.consume = function(iterable, count) {<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td>  goog.asserts.assert(goog.math.isInt(count) &amp;&amp; count &gt;= 0);<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td><tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>  var iterator = goog.iter.toIterator(iterable);<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td><tr><td><a id="l1141"></a><a href="#l1141">1141</a><td>  while (count-- &gt; 0) {<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>    goog.iter.nextOrValue(iterator, null);<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>  }<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td><tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>  return iterator;<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>};<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td><tr><td><a id="l1148"></a><a href="#l1148">1148</a><td><tr><td><a id="l1149"></a><a href="#l1149">1149</a><td>/**<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td> * Creates an iterator that returns a range of elements from an iterable.<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td> * Similar to {@see goog.array#slice} but does not support negative indexes.<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l1153"></a><a href="#l1153">1153</a><td> *     iterable to slice.<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td> * @param {number} start  The index of the first element to return.<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td> * @param {number=} opt_end  The index after the last element to return. If<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td> *     defined, must be greater than or equal to {@code start}.<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td> * @return {!goog.iter.Iterator&lt;VALUE&gt;} A new iterator containing a slice of<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td> *     the original.<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td> * @template VALUE<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td> */<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td>goog.iter.slice = function(iterable, start, opt_end) {<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td>  goog.asserts.assert(goog.math.isInt(start) &amp;&amp; start &gt;= 0);<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td><tr><td><a id="l1164"></a><a href="#l1164">1164</a><td>  var iterator = goog.iter.consume(iterable, start);<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td><tr><td><a id="l1166"></a><a href="#l1166">1166</a><td>  if (goog.isNumber(opt_end)) {<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>    goog.asserts.assert(goog.math.isInt(opt_end) &amp;&amp; opt_end &gt;= start);<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td>    iterator = goog.iter.limit(iterator, opt_end - start /* limitSize */);<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td>  }<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td><tr><td><a id="l1171"></a><a href="#l1171">1171</a><td>  return iterator;<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td>};<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td><tr><td><a id="l1174"></a><a href="#l1174">1174</a><td><tr><td><a id="l1175"></a><a href="#l1175">1175</a><td>/**<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td> * Checks an array for duplicate elements.<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td> * @param {Array&lt;VALUE&gt;|goog.array.ArrayLike} arr The array to check for<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td> *     duplicates.<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td> * @return {boolean} True, if the array contains duplicates, false otherwise.<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td> * @private<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td> * @template VALUE<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td> */<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td>// TODO(user): Consider moving this into goog.array as a public function.<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td>goog.iter.hasDuplicates_ = function(arr) {<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td>  var deduped = [];<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td>  goog.array.removeDuplicates(arr, deduped);<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td>  return arr.length != deduped.length;<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td>};<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td><tr><td><a id="l1190"></a><a href="#l1190">1190</a><td><tr><td><a id="l1191"></a><a href="#l1191">1191</a><td>/**<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td> * Creates an iterator that returns permutations of elements in<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td> * {@code iterable}.<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td> *<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td> * Permutations are obtained by taking the Cartesian product of<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td> * {@code opt_length} iterables and filtering out those with repeated<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td> * elements. For example, the permutations of {@code [1,2,3]} are<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td> * {@code [[1,2,3], [1,3,2], [2,1,3], [2,3,1], [3,1,2], [3,2,1]]}.<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.permutations<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td> *     iterable from which to generate permutations.<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td> * @param {number=} opt_length Length of each permutation. If omitted, defaults<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td> *     to the length of {@code iterable}.<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td> * @return {!goog.iter.Iterator&lt;!Array&lt;VALUE&gt;&gt;} A new iterator containing the<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td> *     permutations of {@code iterable}.<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td> * @template VALUE<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td> */<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td>goog.iter.permutations = function(iterable, opt_length) {<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td>  var elements = goog.iter.toArray(iterable);<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td>  var length = goog.isNumber(opt_length) ? opt_length : elements.length;<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td><tr><td><a id="l1212"></a><a href="#l1212">1212</a><td>  var sets = goog.array.repeat(elements, length);<tr><td><a id="l1213"></a><a href="#l1213">1213</a><td>  var product = goog.iter.product.apply(undefined, sets);<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td><tr><td><a id="l1215"></a><a href="#l1215">1215</a><td>  return goog.iter.filter(product, function(arr) {<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td>    return !goog.iter.hasDuplicates_(arr);<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td>  });<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td>};<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td><tr><td><a id="l1220"></a><a href="#l1220">1220</a><td><tr><td><a id="l1221"></a><a href="#l1221">1221</a><td>/**<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td> * Creates an iterator that returns combinations of elements from<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td> * {@code iterable}.<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td> *<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td> * Combinations are obtained by taking the {@see goog.iter#permutations} of<tr><td><a id="l1226"></a><a href="#l1226">1226</a><td> * {@code iterable} and filtering those whose elements appear in the order they<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td> * are encountered in {@code iterable}. For example, the 3-length combinations<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td> * of {@code [0,1,2,3]} are {@code [[0,1,2], [0,1,3], [0,2,3], [1,2,3]]}.<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.combinations<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td> *     iterable from which to generate combinations.<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td> * @param {number} length The length of each combination.<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td> * @return {!goog.iter.Iterator&lt;!Array&lt;VALUE&gt;&gt;} A new iterator containing<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td> *     combinations from the {@code iterable}.<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td> * @template VALUE<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td> */<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td>goog.iter.combinations = function(iterable, length) {<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td>  var elements = goog.iter.toArray(iterable);<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>  var indexes = goog.iter.range(elements.length);<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td>  var indexIterator = goog.iter.permutations(indexes, length);<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td>  // sortedIndexIterator will now give arrays of with the given length that<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td>  // indicate what indexes into &quot;elements&quot; should be returned on each iteration.<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td>  var sortedIndexIterator = goog.iter.filter(indexIterator, function(arr) {<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td>    return goog.array.isSorted(arr);<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td>  });<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td><tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td><tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>  function getIndexFromElements(index) {<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>    return elements[index];<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>  }<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td><tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>  iter.next = function() {<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td>    return goog.array.map(sortedIndexIterator.next(), getIndexFromElements);<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td>  };<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td><tr><td><a id="l1257"></a><a href="#l1257">1257</a><td>  return iter;<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td>};<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td><tr><td><a id="l1260"></a><a href="#l1260">1260</a><td><tr><td><a id="l1261"></a><a href="#l1261">1261</a><td>/**<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td> * Creates an iterator that returns combinations of elements from<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td> * {@code iterable}, with repeated elements possible.<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td> *<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td> * Combinations are obtained by taking the Cartesian product of {@code length}<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td> * iterables and filtering those whose elements appear in the order they are<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td> * encountered in {@code iterable}. For example, the 2-length combinations of<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td> * {@code [1,2,3]} are {@code [[1,1], [1,2], [1,3], [2,2], [2,3], [3,3]]}.<tr><td><a id="l1269"></a><a href="#l1269">1269</a><td> * @see http://docs.python.org/2/library/itertools.html#itertools.combinations_with_replacement<tr><td><a id="l1270"></a><a href="#l1270">1270</a><td> * @see http://en.wikipedia.org/wiki/Combination#Number_of_combinations_with_repetition<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td> * @param {!goog.iter.Iterator&lt;VALUE&gt;|!goog.iter.Iterable} iterable The<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td> *     iterable to combine.<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td> * @param {number} length The length of each combination.<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td> * @return {!goog.iter.Iterator&lt;!Array&lt;VALUE&gt;&gt;} A new iterator containing<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td> *     combinations from the {@code iterable}.<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td> * @template VALUE<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td> */<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>goog.iter.combinationsWithReplacement = function(iterable, length) {<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>  var elements = goog.iter.toArray(iterable);<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td>  var indexes = goog.array.range(elements.length);<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>  var sets = goog.array.repeat(indexes, length);<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>  var indexIterator = goog.iter.product.apply(undefined, sets);<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>  // sortedIndexIterator will now give arrays of with the given length that<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>  // indicate what indexes into &quot;elements&quot; should be returned on each iteration.<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>  var sortedIndexIterator = goog.iter.filter(indexIterator, function(arr) {<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>    return goog.array.isSorted(arr);<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>  });<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td><tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>  var iter = new goog.iter.Iterator();<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td><tr><td><a id="l1291"></a><a href="#l1291">1291</a><td>  function getIndexFromElements(index) {<tr><td><a id="l1292"></a><a href="#l1292">1292</a><td>    return elements[index];<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td>  }<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td><tr><td><a id="l1295"></a><a href="#l1295">1295</a><td>  iter.next = function() {<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td>    return goog.array.map(<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td>        /** @type {!Array&lt;number&gt;} */<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td>        (sortedIndexIterator.next()), getIndexFromElements);<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td>  };<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td><tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>  return iter;<tr><td><a id="l1302"></a><a href="#l1302">1302</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/json/json.js.src.html b/docs/source/lib/goog/json/json.js.src.html
index 3b84a07..8a8ecd9 100644
--- a/docs/source/lib/goog/json/json.js.src.html
+++ b/docs/source/lib/goog/json/json.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>json.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/json/json.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview JSON utility functions.<tr><td><a name="l17" href="#l17">17</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.json&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.json.Serializer&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * Tests if a string is an invalid JSON string. This only ensures that we are<tr><td><a name="l27" href="#l27">27</a><td> * not using any invalid characters<tr><td><a name="l28" href="#l28">28</a><td> * @param {string} s The string to test.<tr><td><a name="l29" href="#l29">29</a><td> * @return {boolean} True if the input is a valid JSON string.<tr><td><a name="l30" href="#l30">30</a><td> * @private<tr><td><a name="l31" href="#l31">31</a><td> */<tr><td><a name="l32" href="#l32">32</a><td>goog.json.isValid_ = function(s) {<tr><td><a name="l33" href="#l33">33</a><td>  // All empty whitespace is not valid.<tr><td><a name="l34" href="#l34">34</a><td>  if (/^\s*$/.test(s)) {<tr><td><a name="l35" href="#l35">35</a><td>    return false;<tr><td><a name="l36" href="#l36">36</a><td>  }<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td>  // This is taken from http://www.json.org/json2.js which is released to the<tr><td><a name="l39" href="#l39">39</a><td>  // public domain.<tr><td><a name="l40" href="#l40">40</a><td>  // Changes: We dissallow \u2028 Line separator and \u2029 Paragraph separator<tr><td><a name="l41" href="#l41">41</a><td>  // inside strings.  We also treat \u2028 and \u2029 as whitespace which they<tr><td><a name="l42" href="#l42">42</a><td>  // are in the RFC but IE and Safari does not match \s to these so we need to<tr><td><a name="l43" href="#l43">43</a><td>  // include them in the reg exps in all places where whitespace is allowed.<tr><td><a name="l44" href="#l44">44</a><td>  // We allowed \x7f inside strings because some tools don&#39;t escape it,<tr><td><a name="l45" href="#l45">45</a><td>  // e.g. http://www.json.org/java/org/json/JSONObject.java<tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>  // Parsing happens in three stages. In the first stage, we run the text<tr><td><a name="l48" href="#l48">48</a><td>  // against regular expressions that look for non-JSON patterns. We are<tr><td><a name="l49" href="#l49">49</a><td>  // especially concerned with &#39;()&#39; and &#39;new&#39; because they can cause invocation,<tr><td><a name="l50" href="#l50">50</a><td>  // and &#39;=&#39; because it can cause mutation. But just to be safe, we want to<tr><td><a name="l51" href="#l51">51</a><td>  // reject all unexpected forms.<tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>  // We split the first stage into 4 regexp operations in order to work around<tr><td><a name="l54" href="#l54">54</a><td>  // crippling inefficiencies in IE&#39;s and Safari&#39;s regexp engines. First we<tr><td><a name="l55" href="#l55">55</a><td>  // replace all backslash pairs with &#39;@&#39; (a non-JSON character). Second, we<tr><td><a name="l56" href="#l56">56</a><td>  // replace all simple value tokens with &#39;]&#39; characters. Third, we delete all<tr><td><a name="l57" href="#l57">57</a><td>  // open brackets that follow a colon or comma or that begin the text. Finally,<tr><td><a name="l58" href="#l58">58</a><td>  // we look to see that the remaining characters are only whitespace or &#39;]&#39; or<tr><td><a name="l59" href="#l59">59</a><td>  // &#39;,&#39; or &#39;:&#39; or &#39;{&#39; or &#39;}&#39;. If that is so, then the text is safe for eval.<tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td>  // Don&#39;t make these static since they have the global flag.<tr><td><a name="l62" href="#l62">62</a><td>  var backslashesRe = /\\[&quot;\\\/bfnrtu]/g;<tr><td><a name="l63" href="#l63">63</a><td>  var simpleValuesRe =<tr><td><a name="l64" href="#l64">64</a><td>      /&quot;[^&quot;\\\n\r\u2028\u2029\x00-\x08\x0a-\x1f]*&quot;|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g;<tr><td><a name="l65" href="#l65">65</a><td>  var openBracketsRe = /(?:^|:|,)(?:[\s\u2028\u2029]*\[)+/g;<tr><td><a name="l66" href="#l66">66</a><td>  var remainderRe = /^[\],:{}\s\u2028\u2029]*$/;<tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td>  return remainderRe.test(s.replace(backslashesRe, &#39;@&#39;).<tr><td><a name="l69" href="#l69">69</a><td>      replace(simpleValuesRe, &#39;]&#39;).<tr><td><a name="l70" href="#l70">70</a><td>      replace(openBracketsRe, &#39;&#39;));<tr><td><a name="l71" href="#l71">71</a><td>};<tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td>/**<tr><td><a name="l75" href="#l75">75</a><td> * Parses a JSON string and returns the result. This throws an exception if<tr><td><a name="l76" href="#l76">76</a><td> * the string is an invalid JSON string.<tr><td><a name="l77" href="#l77">77</a><td> *<tr><td><a name="l78" href="#l78">78</a><td> * Note that this is very slow on large strings. If you trust the source of<tr><td><a name="l79" href="#l79">79</a><td> * the string then you should use unsafeParse instead.<tr><td><a name="l80" href="#l80">80</a><td> *<tr><td><a name="l81" href="#l81">81</a><td> * @param {*} s The JSON string to parse.<tr><td><a name="l82" href="#l82">82</a><td> * @return {Object} The object generated from the JSON string.<tr><td><a name="l83" href="#l83">83</a><td> */<tr><td><a name="l84" href="#l84">84</a><td>goog.json.parse = function(s) {<tr><td><a name="l85" href="#l85">85</a><td>  var o = String(s);<tr><td><a name="l86" href="#l86">86</a><td>  if (goog.json.isValid_(o)) {<tr><td><a name="l87" href="#l87">87</a><td>    /** @preserveTry */<tr><td><a name="l88" href="#l88">88</a><td>    try {<tr><td><a name="l89" href="#l89">89</a><td>      return /** @type {Object} */ (eval(&#39;(&#39; + o + &#39;)&#39;));<tr><td><a name="l90" href="#l90">90</a><td>    } catch (ex) {<tr><td><a name="l91" href="#l91">91</a><td>    }<tr><td><a name="l92" href="#l92">92</a><td>  }<tr><td><a name="l93" href="#l93">93</a><td>  throw Error(&#39;Invalid JSON string: &#39; + o);<tr><td><a name="l94" href="#l94">94</a><td>};<tr><td><a name="l95" href="#l95">95</a><td><tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>/**<tr><td><a name="l98" href="#l98">98</a><td> * Parses a JSON string and returns the result. This uses eval so it is open<tr><td><a name="l99" href="#l99">99</a><td> * to security issues and it should only be used if you trust the source.<tr><td><a name="l100" href="#l100">100</a><td> *<tr><td><a name="l101" href="#l101">101</a><td> * @param {string} s The JSON string to parse.<tr><td><a name="l102" href="#l102">102</a><td> * @return {Object} The object generated from the JSON string.<tr><td><a name="l103" href="#l103">103</a><td> */<tr><td><a name="l104" href="#l104">104</a><td>goog.json.unsafeParse = function(s) {<tr><td><a name="l105" href="#l105">105</a><td>  return /** @type {Object} */ (eval(&#39;(&#39; + s + &#39;)&#39;));<tr><td><a name="l106" href="#l106">106</a><td>};<tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td>/**<tr><td><a name="l110" href="#l110">110</a><td> * JSON replacer, as defined in Section 15.12.3 of the ES5 spec.<tr><td><a name="l111" href="#l111">111</a><td> *<tr><td><a name="l112" href="#l112">112</a><td> * TODO(nicksantos): Array should also be a valid replacer.<tr><td><a name="l113" href="#l113">113</a><td> *<tr><td><a name="l114" href="#l114">114</a><td> * @typedef {function(this:Object, string, *): *}<tr><td><a name="l115" href="#l115">115</a><td> */<tr><td><a name="l116" href="#l116">116</a><td>goog.json.Replacer;<tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td><tr><td><a name="l119" href="#l119">119</a><td>/**<tr><td><a name="l120" href="#l120">120</a><td> * JSON reviver, as defined in Section 15.12.2 of the ES5 spec.<tr><td><a name="l121" href="#l121">121</a><td> *<tr><td><a name="l122" href="#l122">122</a><td> * @typedef {function(this:Object, string, *): *}<tr><td><a name="l123" href="#l123">123</a><td> */<tr><td><a name="l124" href="#l124">124</a><td>goog.json.Reviver;<tr><td><a name="l125" href="#l125">125</a><td><tr><td><a name="l126" href="#l126">126</a><td><tr><td><a name="l127" href="#l127">127</a><td>/**<tr><td><a name="l128" href="#l128">128</a><td> * Serializes an object or a value to a JSON string.<tr><td><a name="l129" href="#l129">129</a><td> *<tr><td><a name="l130" href="#l130">130</a><td> * @param {*} object The object to serialize.<tr><td><a name="l131" href="#l131">131</a><td> * @param {?goog.json.Replacer=} opt_replacer A replacer function<tr><td><a name="l132" href="#l132">132</a><td> *     called for each (key, value) pair that determines how the value<tr><td><a name="l133" href="#l133">133</a><td> *     should be serialized. By defult, this just returns the value<tr><td><a name="l134" href="#l134">134</a><td> *     and allows default serialization to kick in.<tr><td><a name="l135" href="#l135">135</a><td> * @throws Error if there are loops in the object graph.<tr><td><a name="l136" href="#l136">136</a><td> * @return {string} A JSON string representation of the input.<tr><td><a name="l137" href="#l137">137</a><td> */<tr><td><a name="l138" href="#l138">138</a><td>goog.json.serialize = function(object, opt_replacer) {<tr><td><a name="l139" href="#l139">139</a><td>  // NOTE(nicksantos): Currently, we never use JSON.stringify.<tr><td><a name="l140" href="#l140">140</a><td>  //<tr><td><a name="l141" href="#l141">141</a><td>  // The last time I evaluated this, JSON.stringify had subtle bugs and behavior<tr><td><a name="l142" href="#l142">142</a><td>  // differences on all browsers, and the performance win was not large enough<tr><td><a name="l143" href="#l143">143</a><td>  // to justify all the issues. This may change in the future as browser<tr><td><a name="l144" href="#l144">144</a><td>  // implementations get better.<tr><td><a name="l145" href="#l145">145</a><td>  //<tr><td><a name="l146" href="#l146">146</a><td>  // assertSerialize in json_test contains if branches for the cases<tr><td><a name="l147" href="#l147">147</a><td>  // that fail.<tr><td><a name="l148" href="#l148">148</a><td>  return new goog.json.Serializer(opt_replacer).serialize(object);<tr><td><a name="l149" href="#l149">149</a><td>};<tr><td><a name="l150" href="#l150">150</a><td><tr><td><a name="l151" href="#l151">151</a><td><tr><td><a name="l152" href="#l152">152</a><td><tr><td><a name="l153" href="#l153">153</a><td>/**<tr><td><a name="l154" href="#l154">154</a><td> * Class that is used to serialize JSON objects to a string.<tr><td><a name="l155" href="#l155">155</a><td> * @param {?goog.json.Replacer=} opt_replacer Replacer.<tr><td><a name="l156" href="#l156">156</a><td> * @constructor<tr><td><a name="l157" href="#l157">157</a><td> */<tr><td><a name="l158" href="#l158">158</a><td>goog.json.Serializer = function(opt_replacer) {<tr><td><a name="l159" href="#l159">159</a><td>  /**<tr><td><a name="l160" href="#l160">160</a><td>   * @type {goog.json.Replacer|null|undefined}<tr><td><a name="l161" href="#l161">161</a><td>   * @private<tr><td><a name="l162" href="#l162">162</a><td>   */<tr><td><a name="l163" href="#l163">163</a><td>  this.replacer_ = opt_replacer;<tr><td><a name="l164" href="#l164">164</a><td>};<tr><td><a name="l165" href="#l165">165</a><td><tr><td><a name="l166" href="#l166">166</a><td><tr><td><a name="l167" href="#l167">167</a><td>/**<tr><td><a name="l168" href="#l168">168</a><td> * Serializes an object or a value to a JSON string.<tr><td><a name="l169" href="#l169">169</a><td> *<tr><td><a name="l170" href="#l170">170</a><td> * @param {*} object The object to serialize.<tr><td><a name="l171" href="#l171">171</a><td> * @throws Error if there are loops in the object graph.<tr><td><a name="l172" href="#l172">172</a><td> * @return {string} A JSON string representation of the input.<tr><td><a name="l173" href="#l173">173</a><td> */<tr><td><a name="l174" href="#l174">174</a><td>goog.json.Serializer.prototype.serialize = function(object) {<tr><td><a name="l175" href="#l175">175</a><td>  var sb = [];<tr><td><a name="l176" href="#l176">176</a><td>  this.serialize_(object, sb);<tr><td><a name="l177" href="#l177">177</a><td>  return sb.join(&#39;&#39;);<tr><td><a name="l178" href="#l178">178</a><td>};<tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td><tr><td><a name="l181" href="#l181">181</a><td>/**<tr><td><a name="l182" href="#l182">182</a><td> * Serializes a generic value to a JSON string<tr><td><a name="l183" href="#l183">183</a><td> * @private<tr><td><a name="l184" href="#l184">184</a><td> * @param {*} object The object to serialize.<tr><td><a name="l185" href="#l185">185</a><td> * @param {Array} sb Array used as a string builder.<tr><td><a name="l186" href="#l186">186</a><td> * @throws Error if there are loops in the object graph.<tr><td><a name="l187" href="#l187">187</a><td> */<tr><td><a name="l188" href="#l188">188</a><td>goog.json.Serializer.prototype.serialize_ = function(object, sb) {<tr><td><a name="l189" href="#l189">189</a><td>  switch (typeof object) {<tr><td><a name="l190" href="#l190">190</a><td>    case &#39;string&#39;:<tr><td><a name="l191" href="#l191">191</a><td>      this.serializeString_(/** @type {string} */ (object), sb);<tr><td><a name="l192" href="#l192">192</a><td>      break;<tr><td><a name="l193" href="#l193">193</a><td>    case &#39;number&#39;:<tr><td><a name="l194" href="#l194">194</a><td>      this.serializeNumber_(/** @type {number} */ (object), sb);<tr><td><a name="l195" href="#l195">195</a><td>      break;<tr><td><a name="l196" href="#l196">196</a><td>    case &#39;boolean&#39;:<tr><td><a name="l197" href="#l197">197</a><td>      sb.push(object);<tr><td><a name="l198" href="#l198">198</a><td>      break;<tr><td><a name="l199" href="#l199">199</a><td>    case &#39;undefined&#39;:<tr><td><a name="l200" href="#l200">200</a><td>      sb.push(&#39;null&#39;);<tr><td><a name="l201" href="#l201">201</a><td>      break;<tr><td><a name="l202" href="#l202">202</a><td>    case &#39;object&#39;:<tr><td><a name="l203" href="#l203">203</a><td>      if (object == null) {<tr><td><a name="l204" href="#l204">204</a><td>        sb.push(&#39;null&#39;);<tr><td><a name="l205" href="#l205">205</a><td>        break;<tr><td><a name="l206" href="#l206">206</a><td>      }<tr><td><a name="l207" href="#l207">207</a><td>      if (goog.isArray(object)) {<tr><td><a name="l208" href="#l208">208</a><td>        this.serializeArray(/** @type {!Array} */ (object), sb);<tr><td><a name="l209" href="#l209">209</a><td>        break;<tr><td><a name="l210" href="#l210">210</a><td>      }<tr><td><a name="l211" href="#l211">211</a><td>      // should we allow new String, new Number and new Boolean to be treated<tr><td><a name="l212" href="#l212">212</a><td>      // as string, number and boolean? Most implementations do not and the<tr><td><a name="l213" href="#l213">213</a><td>      // need is not very big<tr><td><a name="l214" href="#l214">214</a><td>      this.serializeObject_(/** @type {Object} */ (object), sb);<tr><td><a name="l215" href="#l215">215</a><td>      break;<tr><td><a name="l216" href="#l216">216</a><td>    case &#39;function&#39;:<tr><td><a name="l217" href="#l217">217</a><td>      // Skip functions.<tr><td><a name="l218" href="#l218">218</a><td>      // TODO(user) Should we return something here?<tr><td><a name="l219" href="#l219">219</a><td>      break;<tr><td><a name="l220" href="#l220">220</a><td>    default:<tr><td><a name="l221" href="#l221">221</a><td>      throw Error(&#39;Unknown type: &#39; + typeof object);<tr><td><a name="l222" href="#l222">222</a><td>  }<tr><td><a name="l223" href="#l223">223</a><td>};<tr><td><a name="l224" href="#l224">224</a><td><tr><td><a name="l225" href="#l225">225</a><td><tr><td><a name="l226" href="#l226">226</a><td>/**<tr><td><a name="l227" href="#l227">227</a><td> * Character mappings used internally for goog.string.quote<tr><td><a name="l228" href="#l228">228</a><td> * @private<tr><td><a name="l229" href="#l229">229</a><td> * @type {Object}<tr><td><a name="l230" href="#l230">230</a><td> */<tr><td><a name="l231" href="#l231">231</a><td>goog.json.Serializer.charToJsonCharCache_ = {<tr><td><a name="l232" href="#l232">232</a><td>  &#39;\&quot;&#39;: &#39;\\&quot;&#39;,<tr><td><a name="l233" href="#l233">233</a><td>  &#39;\\&#39;: &#39;\\\\&#39;,<tr><td><a name="l234" href="#l234">234</a><td>  &#39;/&#39;: &#39;\\/&#39;,<tr><td><a name="l235" href="#l235">235</a><td>  &#39;\b&#39;: &#39;\\b&#39;,<tr><td><a name="l236" href="#l236">236</a><td>  &#39;\f&#39;: &#39;\\f&#39;,<tr><td><a name="l237" href="#l237">237</a><td>  &#39;\n&#39;: &#39;\\n&#39;,<tr><td><a name="l238" href="#l238">238</a><td>  &#39;\r&#39;: &#39;\\r&#39;,<tr><td><a name="l239" href="#l239">239</a><td>  &#39;\t&#39;: &#39;\\t&#39;,<tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td>  &#39;\x0B&#39;: &#39;\\u000b&#39; // &#39;\v&#39; is not supported in JScript<tr><td><a name="l242" href="#l242">242</a><td>};<tr><td><a name="l243" href="#l243">243</a><td><tr><td><a name="l244" href="#l244">244</a><td><tr><td><a name="l245" href="#l245">245</a><td>/**<tr><td><a name="l246" href="#l246">246</a><td> * Regular expression used to match characters that need to be replaced.<tr><td><a name="l247" href="#l247">247</a><td> * The S60 browser has a bug where unicode characters are not matched by<tr><td><a name="l248" href="#l248">248</a><td> * regular expressions. The condition below detects such behaviour and<tr><td><a name="l249" href="#l249">249</a><td> * adjusts the regular expression accordingly.<tr><td><a name="l250" href="#l250">250</a><td> * @private<tr><td><a name="l251" href="#l251">251</a><td> * @type {RegExp}<tr><td><a name="l252" href="#l252">252</a><td> */<tr><td><a name="l253" href="#l253">253</a><td>goog.json.Serializer.charsToReplace_ = /\uffff/.test(&#39;\uffff&#39;) ?<tr><td><a name="l254" href="#l254">254</a><td>    /[\\\&quot;\x00-\x1f\x7f-\uffff]/g : /[\\\&quot;\x00-\x1f\x7f-\xff]/g;<tr><td><a name="l255" href="#l255">255</a><td><tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td>/**<tr><td><a name="l258" href="#l258">258</a><td> * Serializes a string to a JSON string<tr><td><a name="l259" href="#l259">259</a><td> * @private<tr><td><a name="l260" href="#l260">260</a><td> * @param {string} s The string to serialize.<tr><td><a name="l261" href="#l261">261</a><td> * @param {Array} sb Array used as a string builder.<tr><td><a name="l262" href="#l262">262</a><td> */<tr><td><a name="l263" href="#l263">263</a><td>goog.json.Serializer.prototype.serializeString_ = function(s, sb) {<tr><td><a name="l264" href="#l264">264</a><td>  // The official JSON implementation does not work with international<tr><td><a name="l265" href="#l265">265</a><td>  // characters.<tr><td><a name="l266" href="#l266">266</a><td>  sb.push(&#39;&quot;&#39;, s.replace(goog.json.Serializer.charsToReplace_, function(c) {<tr><td><a name="l267" href="#l267">267</a><td>    // caching the result improves performance by a factor 2-3<tr><td><a name="l268" href="#l268">268</a><td>    if (c in goog.json.Serializer.charToJsonCharCache_) {<tr><td><a name="l269" href="#l269">269</a><td>      return goog.json.Serializer.charToJsonCharCache_[c];<tr><td><a name="l270" href="#l270">270</a><td>    }<tr><td><a name="l271" href="#l271">271</a><td><tr><td><a name="l272" href="#l272">272</a><td>    var cc = c.charCodeAt(0);<tr><td><a name="l273" href="#l273">273</a><td>    var rv = &#39;\\u&#39;;<tr><td><a name="l274" href="#l274">274</a><td>    if (cc &lt; 16) {<tr><td><a name="l275" href="#l275">275</a><td>      rv += &#39;000&#39;;<tr><td><a name="l276" href="#l276">276</a><td>    } else if (cc &lt; 256) {<tr><td><a name="l277" href="#l277">277</a><td>      rv += &#39;00&#39;;<tr><td><a name="l278" href="#l278">278</a><td>    } else if (cc &lt; 4096) { // \u1000<tr><td><a name="l279" href="#l279">279</a><td>      rv += &#39;0&#39;;<tr><td><a name="l280" href="#l280">280</a><td>    }<tr><td><a name="l281" href="#l281">281</a><td>    return goog.json.Serializer.charToJsonCharCache_[c] = rv + cc.toString(16);<tr><td><a name="l282" href="#l282">282</a><td>  }), &#39;&quot;&#39;);<tr><td><a name="l283" href="#l283">283</a><td>};<tr><td><a name="l284" href="#l284">284</a><td><tr><td><a name="l285" href="#l285">285</a><td><tr><td><a name="l286" href="#l286">286</a><td>/**<tr><td><a name="l287" href="#l287">287</a><td> * Serializes a number to a JSON string<tr><td><a name="l288" href="#l288">288</a><td> * @private<tr><td><a name="l289" href="#l289">289</a><td> * @param {number} n The number to serialize.<tr><td><a name="l290" href="#l290">290</a><td> * @param {Array} sb Array used as a string builder.<tr><td><a name="l291" href="#l291">291</a><td> */<tr><td><a name="l292" href="#l292">292</a><td>goog.json.Serializer.prototype.serializeNumber_ = function(n, sb) {<tr><td><a name="l293" href="#l293">293</a><td>  sb.push(isFinite(n) &amp;&amp; !isNaN(n) ? n : &#39;null&#39;);<tr><td><a name="l294" href="#l294">294</a><td>};<tr><td><a name="l295" href="#l295">295</a><td><tr><td><a name="l296" href="#l296">296</a><td><tr><td><a name="l297" href="#l297">297</a><td>/**<tr><td><a name="l298" href="#l298">298</a><td> * Serializes an array to a JSON string<tr><td><a name="l299" href="#l299">299</a><td> * @param {Array} arr The array to serialize.<tr><td><a name="l300" href="#l300">300</a><td> * @param {Array} sb Array used as a string builder.<tr><td><a name="l301" href="#l301">301</a><td> * @protected<tr><td><a name="l302" href="#l302">302</a><td> */<tr><td><a name="l303" href="#l303">303</a><td>goog.json.Serializer.prototype.serializeArray = function(arr, sb) {<tr><td><a name="l304" href="#l304">304</a><td>  var l = arr.length;<tr><td><a name="l305" href="#l305">305</a><td>  sb.push(&#39;[&#39;);<tr><td><a name="l306" href="#l306">306</a><td>  var sep = &#39;&#39;;<tr><td><a name="l307" href="#l307">307</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a name="l308" href="#l308">308</a><td>    sb.push(sep);<tr><td><a name="l309" href="#l309">309</a><td><tr><td><a name="l310" href="#l310">310</a><td>    var value = arr[i];<tr><td><a name="l311" href="#l311">311</a><td>    this.serialize_(<tr><td><a name="l312" href="#l312">312</a><td>        this.replacer_ ? this.replacer_.call(arr, String(i), value) : value,<tr><td><a name="l313" href="#l313">313</a><td>        sb);<tr><td><a name="l314" href="#l314">314</a><td><tr><td><a name="l315" href="#l315">315</a><td>    sep = &#39;,&#39;;<tr><td><a name="l316" href="#l316">316</a><td>  }<tr><td><a name="l317" href="#l317">317</a><td>  sb.push(&#39;]&#39;);<tr><td><a name="l318" href="#l318">318</a><td>};<tr><td><a name="l319" href="#l319">319</a><td><tr><td><a name="l320" href="#l320">320</a><td><tr><td><a name="l321" href="#l321">321</a><td>/**<tr><td><a name="l322" href="#l322">322</a><td> * Serializes an object to a JSON string<tr><td><a name="l323" href="#l323">323</a><td> * @private<tr><td><a name="l324" href="#l324">324</a><td> * @param {Object} obj The object to serialize.<tr><td><a name="l325" href="#l325">325</a><td> * @param {Array} sb Array used as a string builder.<tr><td><a name="l326" href="#l326">326</a><td> */<tr><td><a name="l327" href="#l327">327</a><td>goog.json.Serializer.prototype.serializeObject_ = function(obj, sb) {<tr><td><a name="l328" href="#l328">328</a><td>  sb.push(&#39;{&#39;);<tr><td><a name="l329" href="#l329">329</a><td>  var sep = &#39;&#39;;<tr><td><a name="l330" href="#l330">330</a><td>  for (var key in obj) {<tr><td><a name="l331" href="#l331">331</a><td>    if (Object.prototype.hasOwnProperty.call(obj, key)) {<tr><td><a name="l332" href="#l332">332</a><td>      var value = obj[key];<tr><td><a name="l333" href="#l333">333</a><td>      // Skip functions.<tr><td><a name="l334" href="#l334">334</a><td>      // TODO(ptucker) Should we return something for function properties?<tr><td><a name="l335" href="#l335">335</a><td>      if (typeof value != &#39;function&#39;) {<tr><td><a name="l336" href="#l336">336</a><td>        sb.push(sep);<tr><td><a name="l337" href="#l337">337</a><td>        this.serializeString_(key, sb);<tr><td><a name="l338" href="#l338">338</a><td>        sb.push(&#39;:&#39;);<tr><td><a name="l339" href="#l339">339</a><td><tr><td><a name="l340" href="#l340">340</a><td>        this.serialize_(<tr><td><a name="l341" href="#l341">341</a><td>            this.replacer_ ? this.replacer_.call(obj, key, value) : value,<tr><td><a name="l342" href="#l342">342</a><td>            sb);<tr><td><a name="l343" href="#l343">343</a><td><tr><td><a name="l344" href="#l344">344</a><td>        sep = &#39;,&#39;;<tr><td><a name="l345" href="#l345">345</a><td>      }<tr><td><a name="l346" href="#l346">346</a><td>    }<tr><td><a name="l347" href="#l347">347</a><td>  }<tr><td><a name="l348" href="#l348">348</a><td>  sb.push(&#39;}&#39;);<tr><td><a name="l349" href="#l349">349</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>json.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/json/json.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview JSON utility functions.<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><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.json&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.json.Replacer&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.json.Reviver&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.json.Serializer&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @define {boolean} If true, use the native JSON parsing API.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * NOTE(ruilopes): EXPERIMENTAL, handle with care.  Setting this to true might<tr><td><a id="l30"></a><a href="#l30">30</a><td> * break your code.  The default {@code goog.json.parse} implementation is able<tr><td><a id="l31"></a><a href="#l31">31</a><td> * to handle invalid JSON, such as JSPB.<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.define(&#39;goog.json.USE_NATIVE_JSON&#39;, false);<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> * Tests if a string is an invalid JSON string. This only ensures that we are<tr><td><a id="l38"></a><a href="#l38">38</a><td> * not using any invalid characters<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @param {string} s The string to test.<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @return {boolean} True if the input is a valid JSON string.<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.json.isValid = function(s) {<tr><td><a id="l43"></a><a href="#l43">43</a><td>  // All empty whitespace is not valid.<tr><td><a id="l44"></a><a href="#l44">44</a><td>  if (/^\s*$/.test(s)) {<tr><td><a id="l45"></a><a href="#l45">45</a><td>    return false;<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>  // This is taken from http://www.json.org/json2.js which is released to the<tr><td><a id="l49"></a><a href="#l49">49</a><td>  // public domain.<tr><td><a id="l50"></a><a href="#l50">50</a><td>  // Changes: We dissallow \u2028 Line separator and \u2029 Paragraph separator<tr><td><a id="l51"></a><a href="#l51">51</a><td>  // inside strings.  We also treat \u2028 and \u2029 as whitespace which they<tr><td><a id="l52"></a><a href="#l52">52</a><td>  // are in the RFC but IE and Safari does not match \s to these so we need to<tr><td><a id="l53"></a><a href="#l53">53</a><td>  // include them in the reg exps in all places where whitespace is allowed.<tr><td><a id="l54"></a><a href="#l54">54</a><td>  // We allowed \x7f inside strings because some tools don&#39;t escape it,<tr><td><a id="l55"></a><a href="#l55">55</a><td>  // e.g. http://www.json.org/java/org/json/JSONObject.java<tr><td><a id="l56"></a><a href="#l56">56</a><td><tr><td><a id="l57"></a><a href="#l57">57</a><td>  // Parsing happens in three stages. In the first stage, we run the text<tr><td><a id="l58"></a><a href="#l58">58</a><td>  // against regular expressions that look for non-JSON patterns. We are<tr><td><a id="l59"></a><a href="#l59">59</a><td>  // especially concerned with &#39;()&#39; and &#39;new&#39; because they can cause invocation,<tr><td><a id="l60"></a><a href="#l60">60</a><td>  // and &#39;=&#39; because it can cause mutation. But just to be safe, we want to<tr><td><a id="l61"></a><a href="#l61">61</a><td>  // reject all unexpected forms.<tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td>  // We split the first stage into 4 regexp operations in order to work around<tr><td><a id="l64"></a><a href="#l64">64</a><td>  // crippling inefficiencies in IE&#39;s and Safari&#39;s regexp engines. First we<tr><td><a id="l65"></a><a href="#l65">65</a><td>  // replace all backslash pairs with &#39;@&#39; (a non-JSON character). Second, we<tr><td><a id="l66"></a><a href="#l66">66</a><td>  // replace all simple value tokens with &#39;]&#39; characters. Third, we delete all<tr><td><a id="l67"></a><a href="#l67">67</a><td>  // open brackets that follow a colon or comma or that begin the text. Finally,<tr><td><a id="l68"></a><a href="#l68">68</a><td>  // we look to see that the remaining characters are only whitespace or &#39;]&#39; or<tr><td><a id="l69"></a><a href="#l69">69</a><td>  // &#39;,&#39; or &#39;:&#39; or &#39;{&#39; or &#39;}&#39;. If that is so, then the text is safe for eval.<tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td>  // Don&#39;t make these static since they have the global flag.<tr><td><a id="l72"></a><a href="#l72">72</a><td>  var backslashesRe = /\\[&quot;\\\/bfnrtu]/g;<tr><td><a id="l73"></a><a href="#l73">73</a><td>  var simpleValuesRe =<tr><td><a id="l74"></a><a href="#l74">74</a><td>      /&quot;[^&quot;\\\n\r\u2028\u2029\x00-\x08\x0a-\x1f]*&quot;|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g;<tr><td><a id="l75"></a><a href="#l75">75</a><td>  var openBracketsRe = /(?:^|:|,)(?:[\s\u2028\u2029]*\[)+/g;<tr><td><a id="l76"></a><a href="#l76">76</a><td>  var remainderRe = /^[\],:{}\s\u2028\u2029]*$/;<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>  return remainderRe.test(s.replace(backslashesRe, &#39;@&#39;).<tr><td><a id="l79"></a><a href="#l79">79</a><td>      replace(simpleValuesRe, &#39;]&#39;).<tr><td><a id="l80"></a><a href="#l80">80</a><td>      replace(openBracketsRe, &#39;&#39;));<tr><td><a id="l81"></a><a href="#l81">81</a><td>};<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td>/**<tr><td><a id="l85"></a><a href="#l85">85</a><td> * Parses a JSON string and returns the result. This throws an exception if<tr><td><a id="l86"></a><a href="#l86">86</a><td> * the string is an invalid JSON string.<tr><td><a id="l87"></a><a href="#l87">87</a><td> *<tr><td><a id="l88"></a><a href="#l88">88</a><td> * Note that this is very slow on large strings. If you trust the source of<tr><td><a id="l89"></a><a href="#l89">89</a><td> * the string then you should use unsafeParse instead.<tr><td><a id="l90"></a><a href="#l90">90</a><td> *<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @param {*} s The JSON string to parse.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @throws Error if s is invalid JSON.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @return {Object} The object generated from the JSON string, or null.<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.json.parse = goog.json.USE_NATIVE_JSON ?<tr><td><a id="l96"></a><a href="#l96">96</a><td>    /** @type {function(*):Object} */ (goog.global[&#39;JSON&#39;][&#39;parse&#39;]) :<tr><td><a id="l97"></a><a href="#l97">97</a><td>    function(s) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>      var o = String(s);<tr><td><a id="l99"></a><a href="#l99">99</a><td>      if (goog.json.isValid(o)) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>        /** @preserveTry */<tr><td><a id="l101"></a><a href="#l101">101</a><td>        try {<tr><td><a id="l102"></a><a href="#l102">102</a><td>          return /** @type {Object} */ (eval(&#39;(&#39; + o + &#39;)&#39;));<tr><td><a id="l103"></a><a href="#l103">103</a><td>        } catch (ex) {<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>      throw Error(&#39;Invalid JSON string: &#39; + o);<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> * Parses a JSON string and returns the result. This uses eval so it is open<tr><td><a id="l112"></a><a href="#l112">112</a><td> * to security issues and it should only be used if you trust the source.<tr><td><a id="l113"></a><a href="#l113">113</a><td> *<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @param {string} s The JSON string to parse.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @return {Object} The object generated from the JSON string.<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.json.unsafeParse = goog.json.USE_NATIVE_JSON ?<tr><td><a id="l118"></a><a href="#l118">118</a><td>    /** @type {function(string):Object} */ (goog.global[&#39;JSON&#39;][&#39;parse&#39;]) :<tr><td><a id="l119"></a><a href="#l119">119</a><td>    function(s) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>      return /** @type {Object} */ (eval(&#39;(&#39; + s + &#39;)&#39;));<tr><td><a id="l121"></a><a href="#l121">121</a><td>    };<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>/**<tr><td><a id="l125"></a><a href="#l125">125</a><td> * JSON replacer, as defined in Section 15.12.3 of the ES5 spec.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @see http://ecma-international.org/ecma-262/5.1/#sec-15.12.3<tr><td><a id="l127"></a><a href="#l127">127</a><td> *<tr><td><a id="l128"></a><a href="#l128">128</a><td> * TODO(nicksantos): Array should also be a valid replacer.<tr><td><a id="l129"></a><a href="#l129">129</a><td> *<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @typedef {function(this:Object, string, *): *}<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.json.Replacer;<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> * JSON reviver, as defined in Section 15.12.2 of the ES5 spec.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @see http://ecma-international.org/ecma-262/5.1/#sec-15.12.3<tr><td><a id="l138"></a><a href="#l138">138</a><td> *<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @typedef {function(this:Object, string, *): *}<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.json.Reviver;<tr><td><a id="l142"></a><a href="#l142">142</a><td><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> * Serializes an object or a value to a JSON string.<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 {*} object The object to serialize.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @param {?goog.json.Replacer=} opt_replacer A replacer function<tr><td><a id="l149"></a><a href="#l149">149</a><td> *     called for each (key, value) pair that determines how the value<tr><td><a id="l150"></a><a href="#l150">150</a><td> *     should be serialized. By defult, this just returns the value<tr><td><a id="l151"></a><a href="#l151">151</a><td> *     and allows default serialization to kick in.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @throws Error if there are loops in the object graph.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @return {string} A JSON string representation of the input.<tr><td><a id="l154"></a><a href="#l154">154</a><td> */<tr><td><a id="l155"></a><a href="#l155">155</a><td>goog.json.serialize = goog.json.USE_NATIVE_JSON ?<tr><td><a id="l156"></a><a href="#l156">156</a><td>    /** @type {function(*, ?goog.json.Replacer=):string} */<tr><td><a id="l157"></a><a href="#l157">157</a><td>    (goog.global[&#39;JSON&#39;][&#39;stringify&#39;]) :<tr><td><a id="l158"></a><a href="#l158">158</a><td>    function(object, opt_replacer) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>      // NOTE(nicksantos): Currently, we never use JSON.stringify.<tr><td><a id="l160"></a><a href="#l160">160</a><td>      //<tr><td><a id="l161"></a><a href="#l161">161</a><td>      // The last time I evaluated this, JSON.stringify had subtle bugs and<tr><td><a id="l162"></a><a href="#l162">162</a><td>      // behavior differences on all browsers, and the performance win was not<tr><td><a id="l163"></a><a href="#l163">163</a><td>      // large enough to justify all the issues. This may change in the future<tr><td><a id="l164"></a><a href="#l164">164</a><td>      // as browser implementations get better.<tr><td><a id="l165"></a><a href="#l165">165</a><td>      //<tr><td><a id="l166"></a><a href="#l166">166</a><td>      // assertSerialize in json_test contains if branches for the cases<tr><td><a id="l167"></a><a href="#l167">167</a><td>      // that fail.<tr><td><a id="l168"></a><a href="#l168">168</a><td>      return new goog.json.Serializer(opt_replacer).serialize(object);<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>/**<tr><td><a id="l174"></a><a href="#l174">174</a><td> * Class that is used to serialize JSON objects to a string.<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @param {?goog.json.Replacer=} opt_replacer Replacer.<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @constructor<tr><td><a id="l177"></a><a href="#l177">177</a><td> */<tr><td><a id="l178"></a><a href="#l178">178</a><td>goog.json.Serializer = function(opt_replacer) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>  /**<tr><td><a id="l180"></a><a href="#l180">180</a><td>   * @type {goog.json.Replacer|null|undefined}<tr><td><a id="l181"></a><a href="#l181">181</a><td>   * @private<tr><td><a id="l182"></a><a href="#l182">182</a><td>   */<tr><td><a id="l183"></a><a href="#l183">183</a><td>  this.replacer_ = opt_replacer;<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> * Serializes an object or a value to a JSON string.<tr><td><a id="l189"></a><a href="#l189">189</a><td> *<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @param {*} object The object to serialize.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @throws Error if there are loops in the object graph.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @return {string} A JSON string representation of the input.<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>goog.json.Serializer.prototype.serialize = function(object) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>  var sb = [];<tr><td><a id="l196"></a><a href="#l196">196</a><td>  this.serializeInternal(object, sb);<tr><td><a id="l197"></a><a href="#l197">197</a><td>  return sb.join(&#39;&#39;);<tr><td><a id="l198"></a><a href="#l198">198</a><td>};<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> * Serializes a generic value to a JSON string<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @protected<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {*} object The object to serialize.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @param {Array&lt;string&gt;} sb Array used as a string builder.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @throws Error if there are loops in the object graph.<tr><td><a id="l207"></a><a href="#l207">207</a><td> */<tr><td><a id="l208"></a><a href="#l208">208</a><td>goog.json.Serializer.prototype.serializeInternal = function(object, sb) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>  if (object == null) {<tr><td><a id="l210"></a><a href="#l210">210</a><td>    // undefined == null so this branch covers undefined as well as null<tr><td><a id="l211"></a><a href="#l211">211</a><td>    sb.push(&#39;null&#39;);<tr><td><a id="l212"></a><a href="#l212">212</a><td>    return;<tr><td><a id="l213"></a><a href="#l213">213</a><td>  }<tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>  if (typeof object == &#39;object&#39;) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>    if (goog.isArray(object)) {<tr><td><a id="l217"></a><a href="#l217">217</a><td>      this.serializeArray(object, sb);<tr><td><a id="l218"></a><a href="#l218">218</a><td>      return;<tr><td><a id="l219"></a><a href="#l219">219</a><td>    } else if (object instanceof String ||<tr><td><a id="l220"></a><a href="#l220">220</a><td>               object instanceof Number ||<tr><td><a id="l221"></a><a href="#l221">221</a><td>               object instanceof Boolean) {<tr><td><a id="l222"></a><a href="#l222">222</a><td>      object = object.valueOf();<tr><td><a id="l223"></a><a href="#l223">223</a><td>      // Fall through to switch below.<tr><td><a id="l224"></a><a href="#l224">224</a><td>    } else {<tr><td><a id="l225"></a><a href="#l225">225</a><td>      this.serializeObject_(/** @type {Object} */ (object), sb);<tr><td><a id="l226"></a><a href="#l226">226</a><td>      return;<tr><td><a id="l227"></a><a href="#l227">227</a><td>    }<tr><td><a id="l228"></a><a href="#l228">228</a><td>  }<tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>  switch (typeof object) {<tr><td><a id="l231"></a><a href="#l231">231</a><td>    case &#39;string&#39;:<tr><td><a id="l232"></a><a href="#l232">232</a><td>      this.serializeString_(object, sb);<tr><td><a id="l233"></a><a href="#l233">233</a><td>      break;<tr><td><a id="l234"></a><a href="#l234">234</a><td>    case &#39;number&#39;:<tr><td><a id="l235"></a><a href="#l235">235</a><td>      this.serializeNumber_(object, sb);<tr><td><a id="l236"></a><a href="#l236">236</a><td>      break;<tr><td><a id="l237"></a><a href="#l237">237</a><td>    case &#39;boolean&#39;:<tr><td><a id="l238"></a><a href="#l238">238</a><td>      sb.push(String(object));<tr><td><a id="l239"></a><a href="#l239">239</a><td>      break;<tr><td><a id="l240"></a><a href="#l240">240</a><td>    case &#39;function&#39;:<tr><td><a id="l241"></a><a href="#l241">241</a><td>      sb.push(&#39;null&#39;);<tr><td><a id="l242"></a><a href="#l242">242</a><td>      break;<tr><td><a id="l243"></a><a href="#l243">243</a><td>    default:<tr><td><a id="l244"></a><a href="#l244">244</a><td>      throw Error(&#39;Unknown type: &#39; + typeof object);<tr><td><a id="l245"></a><a href="#l245">245</a><td>  }<tr><td><a id="l246"></a><a href="#l246">246</a><td>};<tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td><tr><td><a id="l249"></a><a href="#l249">249</a><td>/**<tr><td><a id="l250"></a><a href="#l250">250</a><td> * Character mappings used internally for goog.string.quote<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @private<tr><td><a id="l252"></a><a href="#l252">252</a><td> * @type {!Object}<tr><td><a id="l253"></a><a href="#l253">253</a><td> */<tr><td><a id="l254"></a><a href="#l254">254</a><td>goog.json.Serializer.charToJsonCharCache_ = {<tr><td><a id="l255"></a><a href="#l255">255</a><td>  &#39;\&quot;&#39;: &#39;\\&quot;&#39;,<tr><td><a id="l256"></a><a href="#l256">256</a><td>  &#39;\\&#39;: &#39;\\\\&#39;,<tr><td><a id="l257"></a><a href="#l257">257</a><td>  &#39;/&#39;: &#39;\\/&#39;,<tr><td><a id="l258"></a><a href="#l258">258</a><td>  &#39;\b&#39;: &#39;\\b&#39;,<tr><td><a id="l259"></a><a href="#l259">259</a><td>  &#39;\f&#39;: &#39;\\f&#39;,<tr><td><a id="l260"></a><a href="#l260">260</a><td>  &#39;\n&#39;: &#39;\\n&#39;,<tr><td><a id="l261"></a><a href="#l261">261</a><td>  &#39;\r&#39;: &#39;\\r&#39;,<tr><td><a id="l262"></a><a href="#l262">262</a><td>  &#39;\t&#39;: &#39;\\t&#39;,<tr><td><a id="l263"></a><a href="#l263">263</a><td><tr><td><a id="l264"></a><a href="#l264">264</a><td>  &#39;\x0B&#39;: &#39;\\u000b&#39; // &#39;\v&#39; is not supported in JScript<tr><td><a id="l265"></a><a href="#l265">265</a><td>};<tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td>/**<tr><td><a id="l269"></a><a href="#l269">269</a><td> * Regular expression used to match characters that need to be replaced.<tr><td><a id="l270"></a><a href="#l270">270</a><td> * The S60 browser has a bug where unicode characters are not matched by<tr><td><a id="l271"></a><a href="#l271">271</a><td> * regular expressions. The condition below detects such behaviour and<tr><td><a id="l272"></a><a href="#l272">272</a><td> * adjusts the regular expression accordingly.<tr><td><a id="l273"></a><a href="#l273">273</a><td> * @private<tr><td><a id="l274"></a><a href="#l274">274</a><td> * @type {!RegExp}<tr><td><a id="l275"></a><a href="#l275">275</a><td> */<tr><td><a id="l276"></a><a href="#l276">276</a><td>goog.json.Serializer.charsToReplace_ = /\uffff/.test(&#39;\uffff&#39;) ?<tr><td><a id="l277"></a><a href="#l277">277</a><td>    /[\\\&quot;\x00-\x1f\x7f-\uffff]/g : /[\\\&quot;\x00-\x1f\x7f-\xff]/g;<tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td>/**<tr><td><a id="l281"></a><a href="#l281">281</a><td> * Serializes a string to a JSON string<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @private<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @param {string} s The string to serialize.<tr><td><a id="l284"></a><a href="#l284">284</a><td> * @param {Array&lt;string&gt;} sb Array used as a string builder.<tr><td><a id="l285"></a><a href="#l285">285</a><td> */<tr><td><a id="l286"></a><a href="#l286">286</a><td>goog.json.Serializer.prototype.serializeString_ = function(s, sb) {<tr><td><a id="l287"></a><a href="#l287">287</a><td>  // The official JSON implementation does not work with international<tr><td><a id="l288"></a><a href="#l288">288</a><td>  // characters.<tr><td><a id="l289"></a><a href="#l289">289</a><td>  sb.push(&#39;&quot;&#39;, s.replace(goog.json.Serializer.charsToReplace_, function(c) {<tr><td><a id="l290"></a><a href="#l290">290</a><td>    // caching the result improves performance by a factor 2-3<tr><td><a id="l291"></a><a href="#l291">291</a><td>    var rv = goog.json.Serializer.charToJsonCharCache_[c];<tr><td><a id="l292"></a><a href="#l292">292</a><td>    if (!rv) {<tr><td><a id="l293"></a><a href="#l293">293</a><td>      rv = &#39;\\u&#39; + (c.charCodeAt(0) | 0x10000).toString(16).substr(1);<tr><td><a id="l294"></a><a href="#l294">294</a><td>      goog.json.Serializer.charToJsonCharCache_[c] = rv;<tr><td><a id="l295"></a><a href="#l295">295</a><td>    }<tr><td><a id="l296"></a><a href="#l296">296</a><td>    return rv;<tr><td><a id="l297"></a><a href="#l297">297</a><td>  }), &#39;&quot;&#39;);<tr><td><a id="l298"></a><a href="#l298">298</a><td>};<tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td>/**<tr><td><a id="l302"></a><a href="#l302">302</a><td> * Serializes a number to a JSON string<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @private<tr><td><a id="l304"></a><a href="#l304">304</a><td> * @param {number} n The number to serialize.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @param {Array&lt;string&gt;} sb Array used as a string builder.<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>goog.json.Serializer.prototype.serializeNumber_ = function(n, sb) {<tr><td><a id="l308"></a><a href="#l308">308</a><td>  sb.push(isFinite(n) &amp;&amp; !isNaN(n) ? String(n) : &#39;null&#39;);<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><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Serializes an array to a JSON string<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @param {Array&lt;string&gt;} arr The array to serialize.<tr><td><a id="l315"></a><a href="#l315">315</a><td> * @param {Array&lt;string&gt;} sb Array used as a string builder.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @protected<tr><td><a id="l317"></a><a href="#l317">317</a><td> */<tr><td><a id="l318"></a><a href="#l318">318</a><td>goog.json.Serializer.prototype.serializeArray = function(arr, sb) {<tr><td><a id="l319"></a><a href="#l319">319</a><td>  var l = arr.length;<tr><td><a id="l320"></a><a href="#l320">320</a><td>  sb.push(&#39;[&#39;);<tr><td><a id="l321"></a><a href="#l321">321</a><td>  var sep = &#39;&#39;;<tr><td><a id="l322"></a><a href="#l322">322</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a id="l323"></a><a href="#l323">323</a><td>    sb.push(sep);<tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td>    var value = arr[i];<tr><td><a id="l326"></a><a href="#l326">326</a><td>    this.serializeInternal(<tr><td><a id="l327"></a><a href="#l327">327</a><td>        this.replacer_ ? this.replacer_.call(arr, String(i), value) : value,<tr><td><a id="l328"></a><a href="#l328">328</a><td>        sb);<tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>    sep = &#39;,&#39;;<tr><td><a id="l331"></a><a href="#l331">331</a><td>  }<tr><td><a id="l332"></a><a href="#l332">332</a><td>  sb.push(&#39;]&#39;);<tr><td><a id="l333"></a><a href="#l333">333</a><td>};<tr><td><a id="l334"></a><a href="#l334">334</a><td><tr><td><a id="l335"></a><a href="#l335">335</a><td><tr><td><a id="l336"></a><a href="#l336">336</a><td>/**<tr><td><a id="l337"></a><a href="#l337">337</a><td> * Serializes an object to a JSON string<tr><td><a id="l338"></a><a href="#l338">338</a><td> * @private<tr><td><a id="l339"></a><a href="#l339">339</a><td> * @param {Object} obj The object to serialize.<tr><td><a id="l340"></a><a href="#l340">340</a><td> * @param {Array&lt;string&gt;} sb Array used as a string builder.<tr><td><a id="l341"></a><a href="#l341">341</a><td> */<tr><td><a id="l342"></a><a href="#l342">342</a><td>goog.json.Serializer.prototype.serializeObject_ = function(obj, sb) {<tr><td><a id="l343"></a><a href="#l343">343</a><td>  sb.push(&#39;{&#39;);<tr><td><a id="l344"></a><a href="#l344">344</a><td>  var sep = &#39;&#39;;<tr><td><a id="l345"></a><a href="#l345">345</a><td>  for (var key in obj) {<tr><td><a id="l346"></a><a href="#l346">346</a><td>    if (Object.prototype.hasOwnProperty.call(obj, key)) {<tr><td><a id="l347"></a><a href="#l347">347</a><td>      var value = obj[key];<tr><td><a id="l348"></a><a href="#l348">348</a><td>      // Skip functions.<tr><td><a id="l349"></a><a href="#l349">349</a><td>      if (typeof value != &#39;function&#39;) {<tr><td><a id="l350"></a><a href="#l350">350</a><td>        sb.push(sep);<tr><td><a id="l351"></a><a href="#l351">351</a><td>        this.serializeString_(key, sb);<tr><td><a id="l352"></a><a href="#l352">352</a><td>        sb.push(&#39;:&#39;);<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td>        this.serializeInternal(<tr><td><a id="l355"></a><a href="#l355">355</a><td>            this.replacer_ ? this.replacer_.call(obj, key, value) : value,<tr><td><a id="l356"></a><a href="#l356">356</a><td>            sb);<tr><td><a id="l357"></a><a href="#l357">357</a><td><tr><td><a id="l358"></a><a href="#l358">358</a><td>        sep = &#39;,&#39;;<tr><td><a id="l359"></a><a href="#l359">359</a><td>      }<tr><td><a id="l360"></a><a href="#l360">360</a><td>    }<tr><td><a id="l361"></a><a href="#l361">361</a><td>  }<tr><td><a id="l362"></a><a href="#l362">362</a><td>  sb.push(&#39;}&#39;);<tr><td><a id="l363"></a><a href="#l363">363</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/testing/assertthat.js.src.html b/docs/source/lib/goog/labs/testing/assertthat.js.src.html
index cb81061..775f035 100644
--- a/docs/source/lib/goog/labs/testing/assertthat.js.src.html
+++ b/docs/source/lib/goog/labs/testing/assertthat.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>assertthat.js</title><link href="../../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/labs/testing/assertthat.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides main functionality of assertThat. assertThat calls the<tr><td><a name="l17" href="#l17">17</a><td> * matcher&#39;s matches method to test if a matcher matches assertThat&#39;s arguments.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.MatcherError&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.assertThat&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.debug.Error&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td>/**<tr><td><a name="l30" href="#l30">30</a><td> * Asserts that the actual value evaluated by the matcher is true.<tr><td><a name="l31" href="#l31">31</a><td> *<tr><td><a name="l32" href="#l32">32</a><td> * @param {*} actual The object to assert by the matcher.<tr><td><a name="l33" href="#l33">33</a><td> * @param {!goog.labs.testing.Matcher} matcher A matcher to verify values.<tr><td><a name="l34" href="#l34">34</a><td> * @param {string=} opt_reason Description of what is asserted.<tr><td><a name="l35" href="#l35">35</a><td> *<tr><td><a name="l36" href="#l36">36</a><td> */<tr><td><a name="l37" href="#l37">37</a><td>goog.labs.testing.assertThat = function(actual, matcher, opt_reason) {<tr><td><a name="l38" href="#l38">38</a><td>  if (!matcher.matches(actual)) {<tr><td><a name="l39" href="#l39">39</a><td>    // Prefix the error description with a reason from the assert ?<tr><td><a name="l40" href="#l40">40</a><td>    var prefix = opt_reason ? opt_reason + &#39;: &#39; : &#39;&#39;;<tr><td><a name="l41" href="#l41">41</a><td>    var desc = prefix + matcher.describe(actual);<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>    // some sort of failure here<tr><td><a name="l44" href="#l44">44</a><td>    throw new goog.labs.testing.MatcherError(desc);<tr><td><a name="l45" href="#l45">45</a><td>  }<tr><td><a name="l46" href="#l46">46</a><td>};<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td>/**<tr><td><a name="l51" href="#l51">51</a><td> * Error thrown when a Matcher fails to match the input value.<tr><td><a name="l52" href="#l52">52</a><td> * @param {string=} opt_message The error message.<tr><td><a name="l53" href="#l53">53</a><td> * @constructor<tr><td><a name="l54" href="#l54">54</a><td> * @extends {goog.debug.Error}<tr><td><a name="l55" href="#l55">55</a><td> */<tr><td><a name="l56" href="#l56">56</a><td>goog.labs.testing.MatcherError = function(opt_message) {<tr><td><a name="l57" href="#l57">57</a><td>  goog.base(this, opt_message);<tr><td><a name="l58" href="#l58">58</a><td>};<tr><td><a name="l59" href="#l59">59</a><td>goog.inherits(goog.labs.testing.MatcherError, goog.debug.Error);</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../../types.js"></script><script src="../../../../../dossier.js"></script>
\ No newline at end of file
+<!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>assertthat.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/labs/testing/assertthat.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Provides main functionality of assertThat. assertThat calls the<tr><td><a id="l17"></a><a href="#l17">17</a><td> * matcher&#39;s matches method to test if a matcher matches assertThat&#39;s arguments.<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.MatcherError&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.assertThat&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.debug.Error&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * Asserts that the actual value evaluated by the matcher is true.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {*} actual The object to assert by the matcher.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @param {!goog.labs.testing.Matcher} matcher A matcher to verify values.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {string=} opt_reason Description of what is asserted.<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>goog.labs.testing.assertThat = function(actual, matcher, opt_reason) {<tr><td><a id="l36"></a><a href="#l36">36</a><td>  if (!matcher.matches(actual)) {<tr><td><a id="l37"></a><a href="#l37">37</a><td>    // Prefix the error description with a reason from the assert ?<tr><td><a id="l38"></a><a href="#l38">38</a><td>    var prefix = opt_reason ? opt_reason + &#39;: &#39; : &#39;&#39;;<tr><td><a id="l39"></a><a href="#l39">39</a><td>    var desc = prefix + matcher.describe(actual);<tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td>    // some sort of failure here<tr><td><a id="l42"></a><a href="#l42">42</a><td>    throw new goog.labs.testing.MatcherError(desc);<tr><td><a id="l43"></a><a href="#l43">43</a><td>  }<tr><td><a id="l44"></a><a href="#l44">44</a><td>};<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td><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> * Error thrown when a Matcher fails to match the input value.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @param {string=} opt_message The error message.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @constructor<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @extends {goog.debug.Error}<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @final<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.labs.testing.MatcherError = function(opt_message) {<tr><td><a id="l56"></a><a href="#l56">56</a><td>  goog.labs.testing.MatcherError.base(this, &#39;constructor&#39;, opt_message);<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.labs.testing.MatcherError, goog.debug.Error);</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html b/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html
index 9aa4930..7ecfefb 100644
--- a/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html
+++ b/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>logicmatcher.js</title><link href="../../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/labs/testing/logicmatcher.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides the built-in logic matchers: anyOf, allOf, and isNot.<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.AllOfMatcher&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.AnyOfMatcher&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.labs.testing.IsNotMatcher&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>/**<tr><td><a name="l32" href="#l32">32</a><td> * The AllOf matcher.<tr><td><a name="l33" href="#l33">33</a><td> *<tr><td><a name="l34" href="#l34">34</a><td> * @param {!Array.&lt;!goog.labs.testing.Matcher&gt;} matchers Input matchers.<tr><td><a name="l35" href="#l35">35</a><td> *<tr><td><a name="l36" href="#l36">36</a><td> * @constructor<tr><td><a name="l37" href="#l37">37</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l38" href="#l38">38</a><td> */<tr><td><a name="l39" href="#l39">39</a><td>goog.labs.testing.AllOfMatcher = function(matchers) {<tr><td><a name="l40" href="#l40">40</a><td>  /**<tr><td><a name="l41" href="#l41">41</a><td>   * @type {!Array.&lt;!goog.labs.testing.Matcher&gt;}<tr><td><a name="l42" href="#l42">42</a><td>   * @private<tr><td><a name="l43" href="#l43">43</a><td>   */<tr><td><a name="l44" href="#l44">44</a><td>  this.matchers_ = matchers;<tr><td><a name="l45" href="#l45">45</a><td>};<tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td>/**<tr><td><a name="l49" href="#l49">49</a><td> * Determines if all of the matchers match the input value.<tr><td><a name="l50" href="#l50">50</a><td> *<tr><td><a name="l51" href="#l51">51</a><td> * @override<tr><td><a name="l52" href="#l52">52</a><td> */<tr><td><a name="l53" href="#l53">53</a><td>goog.labs.testing.AllOfMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l54" href="#l54">54</a><td>  return goog.array.every(this.matchers_, function(matcher) {<tr><td><a name="l55" href="#l55">55</a><td>    return matcher.matches(actualValue);<tr><td><a name="l56" href="#l56">56</a><td>  });<tr><td><a name="l57" href="#l57">57</a><td>};<tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td>/**<tr><td><a name="l61" href="#l61">61</a><td> * Describes why the matcher failed. The returned string is a concatenation of<tr><td><a name="l62" href="#l62">62</a><td> * all the failed matchers&#39; error strings.<tr><td><a name="l63" href="#l63">63</a><td> *<tr><td><a name="l64" href="#l64">64</a><td> * @override<tr><td><a name="l65" href="#l65">65</a><td> */<tr><td><a name="l66" href="#l66">66</a><td>goog.labs.testing.AllOfMatcher.prototype.describe =<tr><td><a name="l67" href="#l67">67</a><td>    function(actualValue) {<tr><td><a name="l68" href="#l68">68</a><td>  // TODO(user) : Optimize this to remove duplication with matches ?<tr><td><a name="l69" href="#l69">69</a><td>  var errorString = &#39;&#39;;<tr><td><a name="l70" href="#l70">70</a><td>  goog.array.forEach(this.matchers_, function(matcher) {<tr><td><a name="l71" href="#l71">71</a><td>    if (!matcher.matches(actualValue)) {<tr><td><a name="l72" href="#l72">72</a><td>      errorString += matcher.describe(actualValue) + &#39;\n&#39;;<tr><td><a name="l73" href="#l73">73</a><td>    }<tr><td><a name="l74" href="#l74">74</a><td>  });<tr><td><a name="l75" href="#l75">75</a><td>  return errorString;<tr><td><a name="l76" href="#l76">76</a><td>};<tr><td><a name="l77" href="#l77">77</a><td><tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td><tr><td><a name="l80" href="#l80">80</a><td>/**<tr><td><a name="l81" href="#l81">81</a><td> * The AnyOf matcher.<tr><td><a name="l82" href="#l82">82</a><td> *<tr><td><a name="l83" href="#l83">83</a><td> * @param {!Array.&lt;!goog.labs.testing.Matcher&gt;} matchers Input matchers.<tr><td><a name="l84" href="#l84">84</a><td> *<tr><td><a name="l85" href="#l85">85</a><td> * @constructor<tr><td><a name="l86" href="#l86">86</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l87" href="#l87">87</a><td> */<tr><td><a name="l88" href="#l88">88</a><td>goog.labs.testing.AnyOfMatcher = function(matchers) {<tr><td><a name="l89" href="#l89">89</a><td>  /**<tr><td><a name="l90" href="#l90">90</a><td>   * @type {!Array.&lt;!goog.labs.testing.Matcher&gt;}<tr><td><a name="l91" href="#l91">91</a><td>   * @private<tr><td><a name="l92" href="#l92">92</a><td>   */<tr><td><a name="l93" href="#l93">93</a><td>  this.matchers_ = matchers;<tr><td><a name="l94" href="#l94">94</a><td>};<tr><td><a name="l95" href="#l95">95</a><td><tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>/**<tr><td><a name="l98" href="#l98">98</a><td> * Determines if any of the matchers matches the input value.<tr><td><a name="l99" href="#l99">99</a><td> *<tr><td><a name="l100" href="#l100">100</a><td> * @override<tr><td><a name="l101" href="#l101">101</a><td> */<tr><td><a name="l102" href="#l102">102</a><td>goog.labs.testing.AnyOfMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l103" href="#l103">103</a><td>  return goog.array.some(this.matchers_, function(matcher) {<tr><td><a name="l104" href="#l104">104</a><td>    return matcher.matches(actualValue);<tr><td><a name="l105" href="#l105">105</a><td>  });<tr><td><a name="l106" href="#l106">106</a><td>};<tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td>/**<tr><td><a name="l110" href="#l110">110</a><td> * Describes why the matcher failed.<tr><td><a name="l111" href="#l111">111</a><td> *<tr><td><a name="l112" href="#l112">112</a><td> * @override<tr><td><a name="l113" href="#l113">113</a><td> */<tr><td><a name="l114" href="#l114">114</a><td>goog.labs.testing.AnyOfMatcher.prototype.describe =<tr><td><a name="l115" href="#l115">115</a><td>    function(actualValue) {<tr><td><a name="l116" href="#l116">116</a><td>  // TODO(user) : Optimize this to remove duplication with matches ?<tr><td><a name="l117" href="#l117">117</a><td>  var errorString = &#39;&#39;;<tr><td><a name="l118" href="#l118">118</a><td>  goog.array.forEach(this.matchers_, function(matcher) {<tr><td><a name="l119" href="#l119">119</a><td>    if (!matcher.matches(actualValue)) {<tr><td><a name="l120" href="#l120">120</a><td>      errorString += matcher.describe(actualValue) + &#39;\n&#39;;<tr><td><a name="l121" href="#l121">121</a><td>    }<tr><td><a name="l122" href="#l122">122</a><td>  });<tr><td><a name="l123" href="#l123">123</a><td>  return errorString;<tr><td><a name="l124" href="#l124">124</a><td>};<tr><td><a name="l125" href="#l125">125</a><td><tr><td><a name="l126" href="#l126">126</a><td><tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td>/**<tr><td><a name="l129" href="#l129">129</a><td> * The IsNot matcher.<tr><td><a name="l130" href="#l130">130</a><td> *<tr><td><a name="l131" href="#l131">131</a><td> * @param {!goog.labs.testing.Matcher} matcher The matcher to negate.<tr><td><a name="l132" href="#l132">132</a><td> *<tr><td><a name="l133" href="#l133">133</a><td> * @constructor<tr><td><a name="l134" href="#l134">134</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l135" href="#l135">135</a><td> */<tr><td><a name="l136" href="#l136">136</a><td>goog.labs.testing.IsNotMatcher = function(matcher) {<tr><td><a name="l137" href="#l137">137</a><td>  /**<tr><td><a name="l138" href="#l138">138</a><td>   * @type {!goog.labs.testing.Matcher}<tr><td><a name="l139" href="#l139">139</a><td>   * @private<tr><td><a name="l140" href="#l140">140</a><td>   */<tr><td><a name="l141" href="#l141">141</a><td>  this.matcher_ = matcher;<tr><td><a name="l142" href="#l142">142</a><td>};<tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td><tr><td><a name="l145" href="#l145">145</a><td>/**<tr><td><a name="l146" href="#l146">146</a><td> * Determines if the input value doesn&#39;t satisfy a matcher.<tr><td><a name="l147" href="#l147">147</a><td> *<tr><td><a name="l148" href="#l148">148</a><td> * @override<tr><td><a name="l149" href="#l149">149</a><td> */<tr><td><a name="l150" href="#l150">150</a><td>goog.labs.testing.IsNotMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l151" href="#l151">151</a><td>  return !this.matcher_.matches(actualValue);<tr><td><a name="l152" href="#l152">152</a><td>};<tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td>/**<tr><td><a name="l156" href="#l156">156</a><td> * Describes why the matcher failed.<tr><td><a name="l157" href="#l157">157</a><td> *<tr><td><a name="l158" href="#l158">158</a><td> * @override<tr><td><a name="l159" href="#l159">159</a><td> */<tr><td><a name="l160" href="#l160">160</a><td>goog.labs.testing.IsNotMatcher.prototype.describe =<tr><td><a name="l161" href="#l161">161</a><td>    function(actualValue) {<tr><td><a name="l162" href="#l162">162</a><td>  return &#39;The following is false: &#39; + this.matcher_.describe(actualValue);<tr><td><a name="l163" href="#l163">163</a><td>};<tr><td><a name="l164" href="#l164">164</a><td><tr><td><a name="l165" href="#l165">165</a><td><tr><td><a name="l166" href="#l166">166</a><td>/**<tr><td><a name="l167" href="#l167">167</a><td> * Creates a matcher that will succeed only if all of the given matchers<tr><td><a name="l168" href="#l168">168</a><td> * succeed.<tr><td><a name="l169" href="#l169">169</a><td> *<tr><td><a name="l170" href="#l170">170</a><td> * @param {...goog.labs.testing.Matcher} var_args The matchers to test<tr><td><a name="l171" href="#l171">171</a><td> *     against.<tr><td><a name="l172" href="#l172">172</a><td> *<tr><td><a name="l173" href="#l173">173</a><td> * @return {!goog.labs.testing.AllOfMatcher} The AllOf matcher.<tr><td><a name="l174" href="#l174">174</a><td> */<tr><td><a name="l175" href="#l175">175</a><td>function allOf(var_args) {<tr><td><a name="l176" href="#l176">176</a><td>  var matchers = goog.array.toArray(arguments);<tr><td><a name="l177" href="#l177">177</a><td>  return new goog.labs.testing.AllOfMatcher(matchers);<tr><td><a name="l178" href="#l178">178</a><td>}<tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td><tr><td><a name="l181" href="#l181">181</a><td>/**<tr><td><a name="l182" href="#l182">182</a><td> * Accepts a set of matchers and returns a matcher which matches<tr><td><a name="l183" href="#l183">183</a><td> * values which satisfy the constraints of any of the given matchers.<tr><td><a name="l184" href="#l184">184</a><td> *<tr><td><a name="l185" href="#l185">185</a><td> * @param {...goog.labs.testing.Matcher} var_args The matchers to test<tr><td><a name="l186" href="#l186">186</a><td> *     against.<tr><td><a name="l187" href="#l187">187</a><td> *<tr><td><a name="l188" href="#l188">188</a><td> * @return {!goog.labs.testing.AnyOfMatcher} The AnyOf matcher.<tr><td><a name="l189" href="#l189">189</a><td> */<tr><td><a name="l190" href="#l190">190</a><td>function anyOf(var_args) {<tr><td><a name="l191" href="#l191">191</a><td>  var matchers = goog.array.toArray(arguments);<tr><td><a name="l192" href="#l192">192</a><td>  return new goog.labs.testing.AnyOfMatcher(matchers);<tr><td><a name="l193" href="#l193">193</a><td>}<tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td><tr><td><a name="l196" href="#l196">196</a><td>/**<tr><td><a name="l197" href="#l197">197</a><td> * Returns a matcher that negates the input matcher. The returned<tr><td><a name="l198" href="#l198">198</a><td> * matcher matches the values not matched by the input matcher and vice-versa.<tr><td><a name="l199" href="#l199">199</a><td> *<tr><td><a name="l200" href="#l200">200</a><td> * @param {!goog.labs.testing.Matcher} matcher The matcher to test against.<tr><td><a name="l201" href="#l201">201</a><td> *<tr><td><a name="l202" href="#l202">202</a><td> * @return {!goog.labs.testing.IsNotMatcher} The IsNot matcher.<tr><td><a name="l203" href="#l203">203</a><td> */<tr><td><a name="l204" href="#l204">204</a><td>function isNot(matcher) {<tr><td><a name="l205" href="#l205">205</a><td>  return new goog.labs.testing.IsNotMatcher(matcher);<tr><td><a name="l206" href="#l206">206</a><td>}</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../../types.js"></script><script src="../../../../../dossier.js"></script>
\ No newline at end of file
+<!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>logicmatcher.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/labs/testing/logicmatcher.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Provides the built-in logic matchers: anyOf, allOf, and isNot.<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><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.AllOfMatcher&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.AnyOfMatcher&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.labs.testing.IsNotMatcher&#39;);<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>goog.require(&#39;goog.array&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<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>/**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * The AllOf matcher.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {!Array&lt;!goog.labs.testing.Matcher&gt;} matchers Input matchers.<tr><td><a id="l35"></a><a href="#l35">35</a><td> *<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @constructor<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @struct<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @implements {goog.labs.testing.Matcher}<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.labs.testing.AllOfMatcher = function(matchers) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  /**<tr><td><a id="l43"></a><a href="#l43">43</a><td>   * @type {!Array&lt;!goog.labs.testing.Matcher&gt;}<tr><td><a id="l44"></a><a href="#l44">44</a><td>   * @private<tr><td><a id="l45"></a><a href="#l45">45</a><td>   */<tr><td><a id="l46"></a><a href="#l46">46</a><td>  this.matchers_ = matchers;<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><tr><td><a id="l50"></a><a href="#l50">50</a><td>/**<tr><td><a id="l51"></a><a href="#l51">51</a><td> * Determines if all of the matchers match the input value.<tr><td><a id="l52"></a><a href="#l52">52</a><td> *<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @override<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.labs.testing.AllOfMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l56"></a><a href="#l56">56</a><td>  return goog.array.every(this.matchers_, function(matcher) {<tr><td><a id="l57"></a><a href="#l57">57</a><td>    return matcher.matches(actualValue);<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><tr><td><a id="l62"></a><a href="#l62">62</a><td>/**<tr><td><a id="l63"></a><a href="#l63">63</a><td> * Describes why the matcher failed. The returned string is a concatenation of<tr><td><a id="l64"></a><a href="#l64">64</a><td> * all the failed matchers&#39; error strings.<tr><td><a id="l65"></a><a href="#l65">65</a><td> *<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @override<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.labs.testing.AllOfMatcher.prototype.describe =<tr><td><a id="l69"></a><a href="#l69">69</a><td>    function(actualValue) {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  // TODO(user) : Optimize this to remove duplication with matches ?<tr><td><a id="l71"></a><a href="#l71">71</a><td>  var errorString = &#39;&#39;;<tr><td><a id="l72"></a><a href="#l72">72</a><td>  goog.array.forEach(this.matchers_, function(matcher) {<tr><td><a id="l73"></a><a href="#l73">73</a><td>    if (!matcher.matches(actualValue)) {<tr><td><a id="l74"></a><a href="#l74">74</a><td>      errorString += matcher.describe(actualValue) + &#39;\n&#39;;<tr><td><a id="l75"></a><a href="#l75">75</a><td>    }<tr><td><a id="l76"></a><a href="#l76">76</a><td>  });<tr><td><a id="l77"></a><a href="#l77">77</a><td>  return errorString;<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><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * The AnyOf matcher.<tr><td><a id="l84"></a><a href="#l84">84</a><td> *<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @param {!Array&lt;!goog.labs.testing.Matcher&gt;} matchers Input matchers.<tr><td><a id="l86"></a><a href="#l86">86</a><td> *<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @constructor<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @struct<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @final<tr><td><a id="l91"></a><a href="#l91">91</a><td> */<tr><td><a id="l92"></a><a href="#l92">92</a><td>goog.labs.testing.AnyOfMatcher = function(matchers) {<tr><td><a id="l93"></a><a href="#l93">93</a><td>  /**<tr><td><a id="l94"></a><a href="#l94">94</a><td>   * @type {!Array&lt;!goog.labs.testing.Matcher&gt;}<tr><td><a id="l95"></a><a href="#l95">95</a><td>   * @private<tr><td><a id="l96"></a><a href="#l96">96</a><td>   */<tr><td><a id="l97"></a><a href="#l97">97</a><td>  this.matchers_ = matchers;<tr><td><a id="l98"></a><a href="#l98">98</a><td>};<tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td>/**<tr><td><a id="l102"></a><a href="#l102">102</a><td> * Determines if any of the matchers matches the input value.<tr><td><a id="l103"></a><a href="#l103">103</a><td> *<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @override<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.labs.testing.AnyOfMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l107"></a><a href="#l107">107</a><td>  return goog.array.some(this.matchers_, function(matcher) {<tr><td><a id="l108"></a><a href="#l108">108</a><td>    return matcher.matches(actualValue);<tr><td><a id="l109"></a><a href="#l109">109</a><td>  });<tr><td><a id="l110"></a><a href="#l110">110</a><td>};<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td>/**<tr><td><a id="l114"></a><a href="#l114">114</a><td> * Describes why the matcher failed.<tr><td><a id="l115"></a><a href="#l115">115</a><td> *<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @override<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.labs.testing.AnyOfMatcher.prototype.describe =<tr><td><a id="l119"></a><a href="#l119">119</a><td>    function(actualValue) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>  // TODO(user) : Optimize this to remove duplication with matches ?<tr><td><a id="l121"></a><a href="#l121">121</a><td>  var errorString = &#39;&#39;;<tr><td><a id="l122"></a><a href="#l122">122</a><td>  goog.array.forEach(this.matchers_, function(matcher) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>    if (!matcher.matches(actualValue)) {<tr><td><a id="l124"></a><a href="#l124">124</a><td>      errorString += matcher.describe(actualValue) + &#39;\n&#39;;<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 errorString;<tr><td><a id="l128"></a><a href="#l128">128</a><td>};<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * The IsNot matcher.<tr><td><a id="l134"></a><a href="#l134">134</a><td> *<tr><td><a id="l135"></a><a href="#l135">135</a><td> * @param {!goog.labs.testing.Matcher} matcher The matcher to negate.<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @constructor<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @struct<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @final<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td>goog.labs.testing.IsNotMatcher = function(matcher) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>  /**<tr><td><a id="l144"></a><a href="#l144">144</a><td>   * @type {!goog.labs.testing.Matcher}<tr><td><a id="l145"></a><a href="#l145">145</a><td>   * @private<tr><td><a id="l146"></a><a href="#l146">146</a><td>   */<tr><td><a id="l147"></a><a href="#l147">147</a><td>  this.matcher_ = matcher;<tr><td><a id="l148"></a><a href="#l148">148</a><td>};<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td>/**<tr><td><a id="l152"></a><a href="#l152">152</a><td> * Determines if the input value doesn&#39;t satisfy a matcher.<tr><td><a id="l153"></a><a href="#l153">153</a><td> *<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @override<tr><td><a id="l155"></a><a href="#l155">155</a><td> */<tr><td><a id="l156"></a><a href="#l156">156</a><td>goog.labs.testing.IsNotMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l157"></a><a href="#l157">157</a><td>  return !this.matcher_.matches(actualValue);<tr><td><a id="l158"></a><a href="#l158">158</a><td>};<tr><td><a id="l159"></a><a href="#l159">159</a><td><tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td>/**<tr><td><a id="l162"></a><a href="#l162">162</a><td> * Describes why the matcher failed.<tr><td><a id="l163"></a><a href="#l163">163</a><td> *<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @override<tr><td><a id="l165"></a><a href="#l165">165</a><td> */<tr><td><a id="l166"></a><a href="#l166">166</a><td>goog.labs.testing.IsNotMatcher.prototype.describe =<tr><td><a id="l167"></a><a href="#l167">167</a><td>    function(actualValue) {<tr><td><a id="l168"></a><a href="#l168">168</a><td>  return &#39;The following is false: &#39; + this.matcher_.describe(actualValue);<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> * Creates a matcher that will succeed only if all of the given matchers<tr><td><a id="l174"></a><a href="#l174">174</a><td> * succeed.<tr><td><a id="l175"></a><a href="#l175">175</a><td> *<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @param {...goog.labs.testing.Matcher} var_args The matchers to test<tr><td><a id="l177"></a><a href="#l177">177</a><td> *     against.<tr><td><a id="l178"></a><a href="#l178">178</a><td> *<tr><td><a id="l179"></a><a href="#l179">179</a><td> * @return {!goog.labs.testing.AllOfMatcher} The AllOf matcher.<tr><td><a id="l180"></a><a href="#l180">180</a><td> */<tr><td><a id="l181"></a><a href="#l181">181</a><td>function allOf(var_args) {<tr><td><a id="l182"></a><a href="#l182">182</a><td>  var matchers = goog.array.toArray(arguments);<tr><td><a id="l183"></a><a href="#l183">183</a><td>  return new goog.labs.testing.AllOfMatcher(matchers);<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> * Accepts a set of matchers and returns a matcher which matches<tr><td><a id="l189"></a><a href="#l189">189</a><td> * values which satisfy the constraints of any of the given matchers.<tr><td><a id="l190"></a><a href="#l190">190</a><td> *<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {...goog.labs.testing.Matcher} var_args The matchers to test<tr><td><a id="l192"></a><a href="#l192">192</a><td> *     against.<tr><td><a id="l193"></a><a href="#l193">193</a><td> *<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @return {!goog.labs.testing.AnyOfMatcher} The AnyOf matcher.<tr><td><a id="l195"></a><a href="#l195">195</a><td> */<tr><td><a id="l196"></a><a href="#l196">196</a><td>function anyOf(var_args) {<tr><td><a id="l197"></a><a href="#l197">197</a><td>  var matchers = goog.array.toArray(arguments);<tr><td><a id="l198"></a><a href="#l198">198</a><td>  return new goog.labs.testing.AnyOfMatcher(matchers);<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 a matcher that negates the input matcher. The returned<tr><td><a id="l204"></a><a href="#l204">204</a><td> * matcher matches the values not matched by the input matcher and vice-versa.<tr><td><a id="l205"></a><a href="#l205">205</a><td> *<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @param {!goog.labs.testing.Matcher} matcher The matcher to test against.<tr><td><a id="l207"></a><a href="#l207">207</a><td> *<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @return {!goog.labs.testing.IsNotMatcher} The IsNot matcher.<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>function isNot(matcher) {<tr><td><a id="l211"></a><a href="#l211">211</a><td>  return new goog.labs.testing.IsNotMatcher(matcher);<tr><td><a id="l212"></a><a href="#l212">212</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/testing/matcher.js.src.html b/docs/source/lib/goog/labs/testing/matcher.js.src.html
index 2c148eb..0fa61c4 100644
--- a/docs/source/lib/goog/labs/testing/matcher.js.src.html
+++ b/docs/source/lib/goog/labs/testing/matcher.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>matcher.js</title><link href="../../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/labs/testing/matcher.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides the base Matcher interface. User code should use the<tr><td><a name="l17" href="#l17">17</a><td> * matchers through assertThat statements and not directly.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * A matcher object to be used in assertThat statements.<tr><td><a name="l27" href="#l27">27</a><td> * @interface<tr><td><a name="l28" href="#l28">28</a><td> */<tr><td><a name="l29" href="#l29">29</a><td>goog.labs.testing.Matcher = function() {};<tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td>/**<tr><td><a name="l33" href="#l33">33</a><td> * Determines whether a value matches the constraints of the match.<tr><td><a name="l34" href="#l34">34</a><td> *<tr><td><a name="l35" href="#l35">35</a><td> * @param {*} value The object to match.<tr><td><a name="l36" href="#l36">36</a><td> * @return {boolean} Whether the input value matches this matcher.<tr><td><a name="l37" href="#l37">37</a><td> */<tr><td><a name="l38" href="#l38">38</a><td>goog.labs.testing.Matcher.prototype.matches = function(value) {};<tr><td><a name="l39" href="#l39">39</a><td><tr><td><a name="l40" href="#l40">40</a><td><tr><td><a name="l41" href="#l41">41</a><td>/**<tr><td><a name="l42" href="#l42">42</a><td> * Describes why the matcher failed.<tr><td><a name="l43" href="#l43">43</a><td> *<tr><td><a name="l44" href="#l44">44</a><td> * @param {*} value The value that didn&#39;t match.<tr><td><a name="l45" href="#l45">45</a><td> * @param {string=} opt_description A partial description to which the reason<tr><td><a name="l46" href="#l46">46</a><td> *     will be appended.<tr><td><a name="l47" href="#l47">47</a><td> *<tr><td><a name="l48" href="#l48">48</a><td> * @return {string} Description of why the matcher failed.<tr><td><a name="l49" href="#l49">49</a><td> */<tr><td><a name="l50" href="#l50">50</a><td>goog.labs.testing.Matcher.prototype.describe =<tr><td><a name="l51" href="#l51">51</a><td>    function(value, opt_description) {};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../../types.js"></script><script src="../../../../../dossier.js"></script>
\ No newline at end of file
+<!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>matcher.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/labs/testing/matcher.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Provides the base Matcher interface. User code should use the<tr><td><a id="l17"></a><a href="#l17">17</a><td> * matchers through assertThat statements and not directly.<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>/**<tr><td><a id="l26"></a><a href="#l26">26</a><td> * A matcher object to be used in assertThat statements.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @interface<tr><td><a id="l28"></a><a href="#l28">28</a><td> */<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.labs.testing.Matcher = function() {};<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> * Determines whether a value matches the constraints of the match.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {*} value The object to match.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @return {boolean} Whether the input value matches this matcher.<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.labs.testing.Matcher.prototype.matches = function(value) {};<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> * Describes why the matcher failed.<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 {*} value The value that didn&#39;t match.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @param {string=} opt_description A partial description to which the reason<tr><td><a id="l46"></a><a href="#l46">46</a><td> *     will be appended.<tr><td><a id="l47"></a><a href="#l47">47</a><td> *<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @return {string} Description of why the matcher failed.<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.labs.testing.Matcher.prototype.describe =<tr><td><a id="l51"></a><a href="#l51">51</a><td>    function(value, opt_description) {};<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>/**<tr><td><a id="l55"></a><a href="#l55">55</a><td> * Generates a Matcher from the ‘matches’ and ‘describe’ functions passed in.<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @param {!Function} matchesFunction The ‘matches’ function.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {Function=} opt_describeFunction The ‘describe’ function.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @return {!Function} The custom matcher.<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>goog.labs.testing.Matcher.makeMatcher =<tr><td><a id="l62"></a><a href="#l62">62</a><td>    function(matchesFunction, opt_describeFunction) {<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>   * @constructor<tr><td><a id="l66"></a><a href="#l66">66</a><td>   * @implements {goog.labs.testing.Matcher}<tr><td><a id="l67"></a><a href="#l67">67</a><td>   * @final<tr><td><a id="l68"></a><a href="#l68">68</a><td>   */<tr><td><a id="l69"></a><a href="#l69">69</a><td>  var matcherConstructor = function() {};<tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td>  /** @override */<tr><td><a id="l72"></a><a href="#l72">72</a><td>  matcherConstructor.prototype.matches = matchesFunction;<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 (opt_describeFunction) {<tr><td><a id="l75"></a><a href="#l75">75</a><td>    /** @override */<tr><td><a id="l76"></a><a href="#l76">76</a><td>    matcherConstructor.prototype.describe = opt_describeFunction;<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>  return matcherConstructor;<tr><td><a id="l80"></a><a href="#l80">80</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html b/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html
index d6a9293..c73dfcf 100644
--- a/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html
+++ b/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>numbermatcher.js</title><link href="../../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/labs/testing/numbermatcher.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides the built-in number matchers like lessThan,<tr><td><a name="l17" href="#l17">17</a><td> * greaterThan, etc.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.CloseToMatcher&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.EqualToMatcher&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.labs.testing.GreaterThanEqualToMatcher&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.provide(&#39;goog.labs.testing.GreaterThanMatcher&#39;);<tr><td><a name="l25" href="#l25">25</a><td>goog.provide(&#39;goog.labs.testing.LessThanEqualToMatcher&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.provide(&#39;goog.labs.testing.LessThanMatcher&#39;);<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a name="l30" href="#l30">30</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td>/**<tr><td><a name="l35" href="#l35">35</a><td> * The GreaterThan matcher.<tr><td><a name="l36" href="#l36">36</a><td> *<tr><td><a name="l37" href="#l37">37</a><td> * @param {number} value The value to compare.<tr><td><a name="l38" href="#l38">38</a><td> *<tr><td><a name="l39" href="#l39">39</a><td> * @constructor<tr><td><a name="l40" href="#l40">40</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l41" href="#l41">41</a><td> */<tr><td><a name="l42" href="#l42">42</a><td>goog.labs.testing.GreaterThanMatcher = function(value) {<tr><td><a name="l43" href="#l43">43</a><td>  /**<tr><td><a name="l44" href="#l44">44</a><td>   * @type {number}<tr><td><a name="l45" href="#l45">45</a><td>   * @private<tr><td><a name="l46" href="#l46">46</a><td>   */<tr><td><a name="l47" href="#l47">47</a><td>  this.value_ = value;<tr><td><a name="l48" href="#l48">48</a><td>};<tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td>/**<tr><td><a name="l52" href="#l52">52</a><td> * Determines if input value is greater than the expected value.<tr><td><a name="l53" href="#l53">53</a><td> *<tr><td><a name="l54" href="#l54">54</a><td> * @override<tr><td><a name="l55" href="#l55">55</a><td> */<tr><td><a name="l56" href="#l56">56</a><td>goog.labs.testing.GreaterThanMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l57" href="#l57">57</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l58" href="#l58">58</a><td>  return actualValue &gt; this.value_;<tr><td><a name="l59" href="#l59">59</a><td>};<tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td>/**<tr><td><a name="l63" href="#l63">63</a><td> * @override<tr><td><a name="l64" href="#l64">64</a><td> */<tr><td><a name="l65" href="#l65">65</a><td>goog.labs.testing.GreaterThanMatcher.prototype.describe =<tr><td><a name="l66" href="#l66">66</a><td>    function(actualValue) {<tr><td><a name="l67" href="#l67">67</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l68" href="#l68">68</a><td>  return actualValue + &#39; is not greater than &#39; + this.value_;<tr><td><a name="l69" href="#l69">69</a><td>};<tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>/**<tr><td><a name="l74" href="#l74">74</a><td> * The lessThan matcher.<tr><td><a name="l75" href="#l75">75</a><td> *<tr><td><a name="l76" href="#l76">76</a><td> * @param {number} value The value to compare.<tr><td><a name="l77" href="#l77">77</a><td> *<tr><td><a name="l78" href="#l78">78</a><td> * @constructor<tr><td><a name="l79" href="#l79">79</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l80" href="#l80">80</a><td> */<tr><td><a name="l81" href="#l81">81</a><td>goog.labs.testing.LessThanMatcher = function(value) {<tr><td><a name="l82" href="#l82">82</a><td>  /**<tr><td><a name="l83" href="#l83">83</a><td>   * @type {number}<tr><td><a name="l84" href="#l84">84</a><td>   * @private<tr><td><a name="l85" href="#l85">85</a><td>   */<tr><td><a name="l86" href="#l86">86</a><td>  this.value_ = value;<tr><td><a name="l87" href="#l87">87</a><td>};<tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td><tr><td><a name="l90" href="#l90">90</a><td>/**<tr><td><a name="l91" href="#l91">91</a><td> * Determines if the input value is less than the expected value.<tr><td><a name="l92" href="#l92">92</a><td> *<tr><td><a name="l93" href="#l93">93</a><td> * @override<tr><td><a name="l94" href="#l94">94</a><td> */<tr><td><a name="l95" href="#l95">95</a><td>goog.labs.testing.LessThanMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l96" href="#l96">96</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l97" href="#l97">97</a><td>  return actualValue &lt; this.value_;<tr><td><a name="l98" href="#l98">98</a><td>};<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td><tr><td><a name="l101" href="#l101">101</a><td>/**<tr><td><a name="l102" href="#l102">102</a><td> * @override<tr><td><a name="l103" href="#l103">103</a><td> */<tr><td><a name="l104" href="#l104">104</a><td>goog.labs.testing.LessThanMatcher.prototype.describe =<tr><td><a name="l105" href="#l105">105</a><td>    function(actualValue) {<tr><td><a name="l106" href="#l106">106</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l107" href="#l107">107</a><td>  return actualValue + &#39; is not less than &#39; + this.value_;<tr><td><a name="l108" href="#l108">108</a><td>};<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td>/**<tr><td><a name="l113" href="#l113">113</a><td> * The GreaterThanEqualTo matcher.<tr><td><a name="l114" href="#l114">114</a><td> *<tr><td><a name="l115" href="#l115">115</a><td> * @param {number} value The value to compare.<tr><td><a name="l116" href="#l116">116</a><td> *<tr><td><a name="l117" href="#l117">117</a><td> * @constructor<tr><td><a name="l118" href="#l118">118</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l119" href="#l119">119</a><td> */<tr><td><a name="l120" href="#l120">120</a><td>goog.labs.testing.GreaterThanEqualToMatcher = function(value) {<tr><td><a name="l121" href="#l121">121</a><td>  /**<tr><td><a name="l122" href="#l122">122</a><td>   * @type {number}<tr><td><a name="l123" href="#l123">123</a><td>   * @private<tr><td><a name="l124" href="#l124">124</a><td>   */<tr><td><a name="l125" href="#l125">125</a><td>  this.value_ = value;<tr><td><a name="l126" href="#l126">126</a><td>};<tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td>/**<tr><td><a name="l130" href="#l130">130</a><td> * Determines if the input value is greater than equal to the expected value.<tr><td><a name="l131" href="#l131">131</a><td> *<tr><td><a name="l132" href="#l132">132</a><td> * @override<tr><td><a name="l133" href="#l133">133</a><td> */<tr><td><a name="l134" href="#l134">134</a><td>goog.labs.testing.GreaterThanEqualToMatcher.prototype.matches =<tr><td><a name="l135" href="#l135">135</a><td>    function(actualValue) {<tr><td><a name="l136" href="#l136">136</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l137" href="#l137">137</a><td>  return actualValue &gt;= this.value_;<tr><td><a name="l138" href="#l138">138</a><td>};<tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td><tr><td><a name="l141" href="#l141">141</a><td>/**<tr><td><a name="l142" href="#l142">142</a><td> * @override<tr><td><a name="l143" href="#l143">143</a><td> */<tr><td><a name="l144" href="#l144">144</a><td>goog.labs.testing.GreaterThanEqualToMatcher.prototype.describe =<tr><td><a name="l145" href="#l145">145</a><td>    function(actualValue) {<tr><td><a name="l146" href="#l146">146</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l147" href="#l147">147</a><td>  return actualValue + &#39; is not greater than equal to &#39; + this.value_;<tr><td><a name="l148" href="#l148">148</a><td>};<tr><td><a name="l149" href="#l149">149</a><td><tr><td><a name="l150" href="#l150">150</a><td><tr><td><a name="l151" href="#l151">151</a><td><tr><td><a name="l152" href="#l152">152</a><td>/**<tr><td><a name="l153" href="#l153">153</a><td> * The LessThanEqualTo matcher.<tr><td><a name="l154" href="#l154">154</a><td> *<tr><td><a name="l155" href="#l155">155</a><td> * @param {number} value The value to compare.<tr><td><a name="l156" href="#l156">156</a><td> *<tr><td><a name="l157" href="#l157">157</a><td> * @constructor<tr><td><a name="l158" href="#l158">158</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l159" href="#l159">159</a><td> */<tr><td><a name="l160" href="#l160">160</a><td>goog.labs.testing.LessThanEqualToMatcher = function(value) {<tr><td><a name="l161" href="#l161">161</a><td>  /**<tr><td><a name="l162" href="#l162">162</a><td>   * @type {number}<tr><td><a name="l163" href="#l163">163</a><td>   * @private<tr><td><a name="l164" href="#l164">164</a><td>   */<tr><td><a name="l165" href="#l165">165</a><td>  this.value_ = value;<tr><td><a name="l166" href="#l166">166</a><td>};<tr><td><a name="l167" href="#l167">167</a><td><tr><td><a name="l168" href="#l168">168</a><td><tr><td><a name="l169" href="#l169">169</a><td>/**<tr><td><a name="l170" href="#l170">170</a><td> * Determines if the input value is less than or equal to the expected value.<tr><td><a name="l171" href="#l171">171</a><td> *<tr><td><a name="l172" href="#l172">172</a><td> * @override<tr><td><a name="l173" href="#l173">173</a><td> */<tr><td><a name="l174" href="#l174">174</a><td>goog.labs.testing.LessThanEqualToMatcher.prototype.matches =<tr><td><a name="l175" href="#l175">175</a><td>    function(actualValue) {<tr><td><a name="l176" href="#l176">176</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l177" href="#l177">177</a><td>  return actualValue &lt;= this.value_;<tr><td><a name="l178" href="#l178">178</a><td>};<tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td><tr><td><a name="l181" href="#l181">181</a><td>/**<tr><td><a name="l182" href="#l182">182</a><td> * @override<tr><td><a name="l183" href="#l183">183</a><td> */<tr><td><a name="l184" href="#l184">184</a><td>goog.labs.testing.LessThanEqualToMatcher.prototype.describe =<tr><td><a name="l185" href="#l185">185</a><td>    function(actualValue) {<tr><td><a name="l186" href="#l186">186</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l187" href="#l187">187</a><td>  return actualValue + &#39; is not less than equal to &#39; + this.value_;<tr><td><a name="l188" href="#l188">188</a><td>};<tr><td><a name="l189" href="#l189">189</a><td><tr><td><a name="l190" href="#l190">190</a><td><tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td>/**<tr><td><a name="l193" href="#l193">193</a><td> * The EqualTo matcher.<tr><td><a name="l194" href="#l194">194</a><td> *<tr><td><a name="l195" href="#l195">195</a><td> * @param {number} value The value to compare.<tr><td><a name="l196" href="#l196">196</a><td> *<tr><td><a name="l197" href="#l197">197</a><td> * @constructor<tr><td><a name="l198" href="#l198">198</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l199" href="#l199">199</a><td> */<tr><td><a name="l200" href="#l200">200</a><td>goog.labs.testing.EqualToMatcher = function(value) {<tr><td><a name="l201" href="#l201">201</a><td>  /**<tr><td><a name="l202" href="#l202">202</a><td>   * @type {number}<tr><td><a name="l203" href="#l203">203</a><td>   * @private<tr><td><a name="l204" href="#l204">204</a><td>   */<tr><td><a name="l205" href="#l205">205</a><td>  this.value_ = value;<tr><td><a name="l206" href="#l206">206</a><td>};<tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td><tr><td><a name="l209" href="#l209">209</a><td>/**<tr><td><a name="l210" href="#l210">210</a><td> * Determines if the input value is equal to the expected value.<tr><td><a name="l211" href="#l211">211</a><td> *<tr><td><a name="l212" href="#l212">212</a><td> * @override<tr><td><a name="l213" href="#l213">213</a><td> */<tr><td><a name="l214" href="#l214">214</a><td>goog.labs.testing.EqualToMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l215" href="#l215">215</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l216" href="#l216">216</a><td>  return actualValue === this.value_;<tr><td><a name="l217" href="#l217">217</a><td>};<tr><td><a name="l218" href="#l218">218</a><td><tr><td><a name="l219" href="#l219">219</a><td><tr><td><a name="l220" href="#l220">220</a><td>/**<tr><td><a name="l221" href="#l221">221</a><td> * @override<tr><td><a name="l222" href="#l222">222</a><td> */<tr><td><a name="l223" href="#l223">223</a><td>goog.labs.testing.EqualToMatcher.prototype.describe =<tr><td><a name="l224" href="#l224">224</a><td>    function(actualValue) {<tr><td><a name="l225" href="#l225">225</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l226" href="#l226">226</a><td>  return actualValue + &#39; is not equal to &#39; + this.value_;<tr><td><a name="l227" href="#l227">227</a><td>};<tr><td><a name="l228" href="#l228">228</a><td><tr><td><a name="l229" href="#l229">229</a><td><tr><td><a name="l230" href="#l230">230</a><td><tr><td><a name="l231" href="#l231">231</a><td>/**<tr><td><a name="l232" href="#l232">232</a><td> * The CloseTo matcher.<tr><td><a name="l233" href="#l233">233</a><td> *<tr><td><a name="l234" href="#l234">234</a><td> * @param {number} value The value to compare.<tr><td><a name="l235" href="#l235">235</a><td> * @param {number} range The range to check within.<tr><td><a name="l236" href="#l236">236</a><td> *<tr><td><a name="l237" href="#l237">237</a><td> * @constructor<tr><td><a name="l238" href="#l238">238</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l239" href="#l239">239</a><td> */<tr><td><a name="l240" href="#l240">240</a><td>goog.labs.testing.CloseToMatcher = function(value, range) {<tr><td><a name="l241" href="#l241">241</a><td>  /**<tr><td><a name="l242" href="#l242">242</a><td>   * @type {number}<tr><td><a name="l243" href="#l243">243</a><td>   * @private<tr><td><a name="l244" href="#l244">244</a><td>   */<tr><td><a name="l245" href="#l245">245</a><td>  this.value_ = value;<tr><td><a name="l246" href="#l246">246</a><td>  /**<tr><td><a name="l247" href="#l247">247</a><td>   * @type {number}<tr><td><a name="l248" href="#l248">248</a><td>   * @private<tr><td><a name="l249" href="#l249">249</a><td>   */<tr><td><a name="l250" href="#l250">250</a><td>  this.range_ = range;<tr><td><a name="l251" href="#l251">251</a><td>};<tr><td><a name="l252" href="#l252">252</a><td><tr><td><a name="l253" href="#l253">253</a><td><tr><td><a name="l254" href="#l254">254</a><td>/**<tr><td><a name="l255" href="#l255">255</a><td> * Determines if input value is within a certain range of the expected value.<tr><td><a name="l256" href="#l256">256</a><td> *<tr><td><a name="l257" href="#l257">257</a><td> * @override<tr><td><a name="l258" href="#l258">258</a><td> */<tr><td><a name="l259" href="#l259">259</a><td>goog.labs.testing.CloseToMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l260" href="#l260">260</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l261" href="#l261">261</a><td>  return Math.abs(this.value_ - actualValue) &lt; this.range_;<tr><td><a name="l262" href="#l262">262</a><td>};<tr><td><a name="l263" href="#l263">263</a><td><tr><td><a name="l264" href="#l264">264</a><td><tr><td><a name="l265" href="#l265">265</a><td>/**<tr><td><a name="l266" href="#l266">266</a><td> * @override<tr><td><a name="l267" href="#l267">267</a><td> */<tr><td><a name="l268" href="#l268">268</a><td>goog.labs.testing.CloseToMatcher.prototype.describe =<tr><td><a name="l269" href="#l269">269</a><td>    function(actualValue) {<tr><td><a name="l270" href="#l270">270</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a name="l271" href="#l271">271</a><td>  return actualValue + &#39; is not close to(&#39; + this.range_ + &#39;) &#39; + this.value_;<tr><td><a name="l272" href="#l272">272</a><td>};<tr><td><a name="l273" href="#l273">273</a><td><tr><td><a name="l274" href="#l274">274</a><td><tr><td><a name="l275" href="#l275">275</a><td>/**<tr><td><a name="l276" href="#l276">276</a><td> * @param {number} value The expected value.<tr><td><a name="l277" href="#l277">277</a><td> *<tr><td><a name="l278" href="#l278">278</a><td> * @return {!goog.labs.testing.GreaterThanMatcher} A GreaterThanMatcher.<tr><td><a name="l279" href="#l279">279</a><td> */<tr><td><a name="l280" href="#l280">280</a><td>function greaterThan(value) {<tr><td><a name="l281" href="#l281">281</a><td>  return new goog.labs.testing.GreaterThanMatcher(value);<tr><td><a name="l282" href="#l282">282</a><td>}<tr><td><a name="l283" href="#l283">283</a><td><tr><td><a name="l284" href="#l284">284</a><td><tr><td><a name="l285" href="#l285">285</a><td>/**<tr><td><a name="l286" href="#l286">286</a><td> * @param {number} value The expected value.<tr><td><a name="l287" href="#l287">287</a><td> *<tr><td><a name="l288" href="#l288">288</a><td> * @return {!goog.labs.testing.GreaterThanEqualToMatcher} A<tr><td><a name="l289" href="#l289">289</a><td> *     GreaterThanEqualToMatcher.<tr><td><a name="l290" href="#l290">290</a><td> */<tr><td><a name="l291" href="#l291">291</a><td>function greaterThanEqualTo(value) {<tr><td><a name="l292" href="#l292">292</a><td>  return new goog.labs.testing.GreaterThanEqualToMatcher(value);<tr><td><a name="l293" href="#l293">293</a><td>}<tr><td><a name="l294" href="#l294">294</a><td><tr><td><a name="l295" href="#l295">295</a><td><tr><td><a name="l296" href="#l296">296</a><td>/**<tr><td><a name="l297" href="#l297">297</a><td> * @param {number} value The expected value.<tr><td><a name="l298" href="#l298">298</a><td> *<tr><td><a name="l299" href="#l299">299</a><td> * @return {!goog.labs.testing.LessThanMatcher} A LessThanMatcher.<tr><td><a name="l300" href="#l300">300</a><td> */<tr><td><a name="l301" href="#l301">301</a><td>function lessThan(value) {<tr><td><a name="l302" href="#l302">302</a><td>  return new goog.labs.testing.LessThanMatcher(value);<tr><td><a name="l303" href="#l303">303</a><td>}<tr><td><a name="l304" href="#l304">304</a><td><tr><td><a name="l305" href="#l305">305</a><td><tr><td><a name="l306" href="#l306">306</a><td>/**<tr><td><a name="l307" href="#l307">307</a><td> * @param {number} value The expected value.<tr><td><a name="l308" href="#l308">308</a><td> *<tr><td><a name="l309" href="#l309">309</a><td> * @return {!goog.labs.testing.LessThanEqualToMatcher} A LessThanEqualToMatcher.<tr><td><a name="l310" href="#l310">310</a><td> */<tr><td><a name="l311" href="#l311">311</a><td>function lessThanEqualTo(value) {<tr><td><a name="l312" href="#l312">312</a><td>  return new goog.labs.testing.LessThanEqualToMatcher(value);<tr><td><a name="l313" href="#l313">313</a><td>}<tr><td><a name="l314" href="#l314">314</a><td><tr><td><a name="l315" href="#l315">315</a><td><tr><td><a name="l316" href="#l316">316</a><td>/**<tr><td><a name="l317" href="#l317">317</a><td> * @param {number} value The expected value.<tr><td><a name="l318" href="#l318">318</a><td> *<tr><td><a name="l319" href="#l319">319</a><td> * @return {!goog.labs.testing.EqualToMatcher} An EqualToMatcher.<tr><td><a name="l320" href="#l320">320</a><td> */<tr><td><a name="l321" href="#l321">321</a><td>function equalTo(value) {<tr><td><a name="l322" href="#l322">322</a><td>  return new goog.labs.testing.EqualToMatcher(value);<tr><td><a name="l323" href="#l323">323</a><td>}<tr><td><a name="l324" href="#l324">324</a><td><tr><td><a name="l325" href="#l325">325</a><td><tr><td><a name="l326" href="#l326">326</a><td>/**<tr><td><a name="l327" href="#l327">327</a><td> * @param {number} value The expected value.<tr><td><a name="l328" href="#l328">328</a><td> * @param {number} range The maximum allowed difference from the expected value.<tr><td><a name="l329" href="#l329">329</a><td> *<tr><td><a name="l330" href="#l330">330</a><td> * @return {!goog.labs.testing.CloseToMatcher} A CloseToMatcher.<tr><td><a name="l331" href="#l331">331</a><td> */<tr><td><a name="l332" href="#l332">332</a><td>function closeTo(value, range) {<tr><td><a name="l333" href="#l333">333</a><td>  return new goog.labs.testing.CloseToMatcher(value, range);<tr><td><a name="l334" href="#l334">334</a><td>}</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../../types.js"></script><script src="../../../../../dossier.js"></script>
\ No newline at end of file
+<!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>numbermatcher.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/labs/testing/numbermatcher.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Provides the built-in number matchers like lessThan,<tr><td><a id="l17"></a><a href="#l17">17</a><td> * greaterThan, etc.<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.CloseToMatcher&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.EqualToMatcher&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.labs.testing.GreaterThanEqualToMatcher&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.labs.testing.GreaterThanMatcher&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.labs.testing.LessThanEqualToMatcher&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.labs.testing.LessThanMatcher&#39;);<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>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<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><tr><td><a id="l34"></a><a href="#l34">34</a><td>/**<tr><td><a id="l35"></a><a href="#l35">35</a><td> * The GreaterThan matcher.<tr><td><a id="l36"></a><a href="#l36">36</a><td> *<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {number} value The value to compare.<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @constructor<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @struct<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @final<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.labs.testing.GreaterThanMatcher = function(value) {<tr><td><a id="l45"></a><a href="#l45">45</a><td>  /**<tr><td><a id="l46"></a><a href="#l46">46</a><td>   * @type {number}<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.value_ = value;<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><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Determines if input value is greater than the expected value.<tr><td><a id="l55"></a><a href="#l55">55</a><td> *<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @override<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.labs.testing.GreaterThanMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l59"></a><a href="#l59">59</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l60"></a><a href="#l60">60</a><td>  return actualValue &gt; this.value_;<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>/**<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @override<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.labs.testing.GreaterThanMatcher.prototype.describe =<tr><td><a id="l68"></a><a href="#l68">68</a><td>    function(actualValue) {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l70"></a><a href="#l70">70</a><td>  return actualValue + &#39; is not greater than &#39; + this.value_;<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><tr><td><a id="l75"></a><a href="#l75">75</a><td>/**<tr><td><a id="l76"></a><a href="#l76">76</a><td> * The lessThan matcher.<tr><td><a id="l77"></a><a href="#l77">77</a><td> *<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @param {number} value The value to compare.<tr><td><a id="l79"></a><a href="#l79">79</a><td> *<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @constructor<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @struct<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @final<tr><td><a id="l84"></a><a href="#l84">84</a><td> */<tr><td><a id="l85"></a><a href="#l85">85</a><td>goog.labs.testing.LessThanMatcher = function(value) {<tr><td><a id="l86"></a><a href="#l86">86</a><td>  /**<tr><td><a id="l87"></a><a href="#l87">87</a><td>   * @type {number}<tr><td><a id="l88"></a><a href="#l88">88</a><td>   * @private<tr><td><a id="l89"></a><a href="#l89">89</a><td>   */<tr><td><a id="l90"></a><a href="#l90">90</a><td>  this.value_ = value;<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> * Determines if the input value is less than the expected value.<tr><td><a id="l96"></a><a href="#l96">96</a><td> *<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @override<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.labs.testing.LessThanMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l101"></a><a href="#l101">101</a><td>  return actualValue &lt; this.value_;<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @override<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td>goog.labs.testing.LessThanMatcher.prototype.describe =<tr><td><a id="l109"></a><a href="#l109">109</a><td>    function(actualValue) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l111"></a><a href="#l111">111</a><td>  return actualValue + &#39; is not less than &#39; + this.value_;<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><tr><td><a id="l116"></a><a href="#l116">116</a><td>/**<tr><td><a id="l117"></a><a href="#l117">117</a><td> * The GreaterThanEqualTo matcher.<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 {number} value The value to compare.<tr><td><a id="l120"></a><a href="#l120">120</a><td> *<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @constructor<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @struct<tr><td><a id="l123"></a><a href="#l123">123</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @final<tr><td><a id="l125"></a><a href="#l125">125</a><td> */<tr><td><a id="l126"></a><a href="#l126">126</a><td>goog.labs.testing.GreaterThanEqualToMatcher = function(value) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>  /**<tr><td><a id="l128"></a><a href="#l128">128</a><td>   * @type {number}<tr><td><a id="l129"></a><a href="#l129">129</a><td>   * @private<tr><td><a id="l130"></a><a href="#l130">130</a><td>   */<tr><td><a id="l131"></a><a href="#l131">131</a><td>  this.value_ = value;<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> * Determines if the input value is greater than equal to the expected value.<tr><td><a id="l137"></a><a href="#l137">137</a><td> *<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @override<tr><td><a id="l139"></a><a href="#l139">139</a><td> */<tr><td><a id="l140"></a><a href="#l140">140</a><td>goog.labs.testing.GreaterThanEqualToMatcher.prototype.matches =<tr><td><a id="l141"></a><a href="#l141">141</a><td>    function(actualValue) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l143"></a><a href="#l143">143</a><td>  return actualValue &gt;= this.value_;<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>/**<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @override<tr><td><a id="l149"></a><a href="#l149">149</a><td> */<tr><td><a id="l150"></a><a href="#l150">150</a><td>goog.labs.testing.GreaterThanEqualToMatcher.prototype.describe =<tr><td><a id="l151"></a><a href="#l151">151</a><td>    function(actualValue) {<tr><td><a id="l152"></a><a href="#l152">152</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l153"></a><a href="#l153">153</a><td>  return actualValue + &#39; is not greater than equal to &#39; + this.value_;<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> * The LessThanEqualTo matcher.<tr><td><a id="l160"></a><a href="#l160">160</a><td> *<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @param {number} value The value to compare.<tr><td><a id="l162"></a><a href="#l162">162</a><td> *<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @constructor<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @struct<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @final<tr><td><a id="l167"></a><a href="#l167">167</a><td> */<tr><td><a id="l168"></a><a href="#l168">168</a><td>goog.labs.testing.LessThanEqualToMatcher = function(value) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>  /**<tr><td><a id="l170"></a><a href="#l170">170</a><td>   * @type {number}<tr><td><a id="l171"></a><a href="#l171">171</a><td>   * @private<tr><td><a id="l172"></a><a href="#l172">172</a><td>   */<tr><td><a id="l173"></a><a href="#l173">173</a><td>  this.value_ = value;<tr><td><a id="l174"></a><a href="#l174">174</a><td>};<tr><td><a id="l175"></a><a href="#l175">175</a><td><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> * Determines if the input value is less than or equal to the expected value.<tr><td><a id="l179"></a><a href="#l179">179</a><td> *<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @override<tr><td><a id="l181"></a><a href="#l181">181</a><td> */<tr><td><a id="l182"></a><a href="#l182">182</a><td>goog.labs.testing.LessThanEqualToMatcher.prototype.matches =<tr><td><a id="l183"></a><a href="#l183">183</a><td>    function(actualValue) {<tr><td><a id="l184"></a><a href="#l184">184</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l185"></a><a href="#l185">185</a><td>  return actualValue &lt;= this.value_;<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>/**<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @override<tr><td><a id="l191"></a><a href="#l191">191</a><td> */<tr><td><a id="l192"></a><a href="#l192">192</a><td>goog.labs.testing.LessThanEqualToMatcher.prototype.describe =<tr><td><a id="l193"></a><a href="#l193">193</a><td>    function(actualValue) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l195"></a><a href="#l195">195</a><td>  return actualValue + &#39; is not less than equal to &#39; + this.value_;<tr><td><a id="l196"></a><a href="#l196">196</a><td>};<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td><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> * The EqualTo matcher.<tr><td><a id="l202"></a><a href="#l202">202</a><td> *<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {number} value The value to compare.<tr><td><a id="l204"></a><a href="#l204">204</a><td> *<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @constructor<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @struct<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @final<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>goog.labs.testing.EqualToMatcher = function(value) {<tr><td><a id="l211"></a><a href="#l211">211</a><td>  /**<tr><td><a id="l212"></a><a href="#l212">212</a><td>   * @type {number}<tr><td><a id="l213"></a><a href="#l213">213</a><td>   * @private<tr><td><a id="l214"></a><a href="#l214">214</a><td>   */<tr><td><a id="l215"></a><a href="#l215">215</a><td>  this.value_ = value;<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> * Determines if the input value is equal to the expected value.<tr><td><a id="l221"></a><a href="#l221">221</a><td> *<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @override<tr><td><a id="l223"></a><a href="#l223">223</a><td> */<tr><td><a id="l224"></a><a href="#l224">224</a><td>goog.labs.testing.EqualToMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l225"></a><a href="#l225">225</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l226"></a><a href="#l226">226</a><td>  return actualValue === this.value_;<tr><td><a id="l227"></a><a href="#l227">227</a><td>};<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>/**<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @override<tr><td><a id="l232"></a><a href="#l232">232</a><td> */<tr><td><a id="l233"></a><a href="#l233">233</a><td>goog.labs.testing.EqualToMatcher.prototype.describe =<tr><td><a id="l234"></a><a href="#l234">234</a><td>    function(actualValue) {<tr><td><a id="l235"></a><a href="#l235">235</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l236"></a><a href="#l236">236</a><td>  return actualValue + &#39; is not equal to &#39; + this.value_;<tr><td><a id="l237"></a><a href="#l237">237</a><td>};<tr><td><a id="l238"></a><a href="#l238">238</a><td><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>/**<tr><td><a id="l242"></a><a href="#l242">242</a><td> * The CloseTo matcher.<tr><td><a id="l243"></a><a href="#l243">243</a><td> *<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {number} value The value to compare.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {number} range The range to check within.<tr><td><a id="l246"></a><a href="#l246">246</a><td> *<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @constructor<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @struct<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @final<tr><td><a id="l251"></a><a href="#l251">251</a><td> */<tr><td><a id="l252"></a><a href="#l252">252</a><td>goog.labs.testing.CloseToMatcher = function(value, range) {<tr><td><a id="l253"></a><a href="#l253">253</a><td>  /**<tr><td><a id="l254"></a><a href="#l254">254</a><td>   * @type {number}<tr><td><a id="l255"></a><a href="#l255">255</a><td>   * @private<tr><td><a id="l256"></a><a href="#l256">256</a><td>   */<tr><td><a id="l257"></a><a href="#l257">257</a><td>  this.value_ = value;<tr><td><a id="l258"></a><a href="#l258">258</a><td>  /**<tr><td><a id="l259"></a><a href="#l259">259</a><td>   * @type {number}<tr><td><a id="l260"></a><a href="#l260">260</a><td>   * @private<tr><td><a id="l261"></a><a href="#l261">261</a><td>   */<tr><td><a id="l262"></a><a href="#l262">262</a><td>  this.range_ = range;<tr><td><a id="l263"></a><a href="#l263">263</a><td>};<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td>/**<tr><td><a id="l267"></a><a href="#l267">267</a><td> * Determines if input value is within a certain range of the expected value.<tr><td><a id="l268"></a><a href="#l268">268</a><td> *<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @override<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>goog.labs.testing.CloseToMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l272"></a><a href="#l272">272</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l273"></a><a href="#l273">273</a><td>  return Math.abs(this.value_ - actualValue) &lt; this.range_;<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><tr><td><a id="l277"></a><a href="#l277">277</a><td>/**<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @override<tr><td><a id="l279"></a><a href="#l279">279</a><td> */<tr><td><a id="l280"></a><a href="#l280">280</a><td>goog.labs.testing.CloseToMatcher.prototype.describe =<tr><td><a id="l281"></a><a href="#l281">281</a><td>    function(actualValue) {<tr><td><a id="l282"></a><a href="#l282">282</a><td>  goog.asserts.assertNumber(actualValue);<tr><td><a id="l283"></a><a href="#l283">283</a><td>  return actualValue + &#39; is not close to(&#39; + this.range_ + &#39;) &#39; + this.value_;<tr><td><a id="l284"></a><a href="#l284">284</a><td>};<tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td><tr><td><a id="l287"></a><a href="#l287">287</a><td>/**<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @param {number} value The expected value.<tr><td><a id="l289"></a><a href="#l289">289</a><td> *<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @return {!goog.labs.testing.GreaterThanMatcher} A GreaterThanMatcher.<tr><td><a id="l291"></a><a href="#l291">291</a><td> */<tr><td><a id="l292"></a><a href="#l292">292</a><td>function greaterThan(value) {<tr><td><a id="l293"></a><a href="#l293">293</a><td>  return new goog.labs.testing.GreaterThanMatcher(value);<tr><td><a id="l294"></a><a href="#l294">294</a><td>}<tr><td><a id="l295"></a><a href="#l295">295</a><td><tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td>/**<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @param {number} value The expected value.<tr><td><a id="l299"></a><a href="#l299">299</a><td> *<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @return {!goog.labs.testing.GreaterThanEqualToMatcher} A<tr><td><a id="l301"></a><a href="#l301">301</a><td> *     GreaterThanEqualToMatcher.<tr><td><a id="l302"></a><a href="#l302">302</a><td> */<tr><td><a id="l303"></a><a href="#l303">303</a><td>function greaterThanEqualTo(value) {<tr><td><a id="l304"></a><a href="#l304">304</a><td>  return new goog.labs.testing.GreaterThanEqualToMatcher(value);<tr><td><a id="l305"></a><a href="#l305">305</a><td>}<tr><td><a id="l306"></a><a href="#l306">306</a><td><tr><td><a id="l307"></a><a href="#l307">307</a><td><tr><td><a id="l308"></a><a href="#l308">308</a><td>/**<tr><td><a id="l309"></a><a href="#l309">309</a><td> * @param {number} value The expected value.<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 {!goog.labs.testing.LessThanMatcher} A LessThanMatcher.<tr><td><a id="l312"></a><a href="#l312">312</a><td> */<tr><td><a id="l313"></a><a href="#l313">313</a><td>function lessThan(value) {<tr><td><a id="l314"></a><a href="#l314">314</a><td>  return new goog.labs.testing.LessThanMatcher(value);<tr><td><a id="l315"></a><a href="#l315">315</a><td>}<tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td>/**<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @param {number} value The expected value.<tr><td><a id="l320"></a><a href="#l320">320</a><td> *<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @return {!goog.labs.testing.LessThanEqualToMatcher} A LessThanEqualToMatcher.<tr><td><a id="l322"></a><a href="#l322">322</a><td> */<tr><td><a id="l323"></a><a href="#l323">323</a><td>function lessThanEqualTo(value) {<tr><td><a id="l324"></a><a href="#l324">324</a><td>  return new goog.labs.testing.LessThanEqualToMatcher(value);<tr><td><a id="l325"></a><a href="#l325">325</a><td>}<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>/**<tr><td><a id="l329"></a><a href="#l329">329</a><td> * @param {number} value The expected value.<tr><td><a id="l330"></a><a href="#l330">330</a><td> *<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @return {!goog.labs.testing.EqualToMatcher} An EqualToMatcher.<tr><td><a id="l332"></a><a href="#l332">332</a><td> */<tr><td><a id="l333"></a><a href="#l333">333</a><td>function equalTo(value) {<tr><td><a id="l334"></a><a href="#l334">334</a><td>  return new goog.labs.testing.EqualToMatcher(value);<tr><td><a id="l335"></a><a href="#l335">335</a><td>}<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td>/**<tr><td><a id="l339"></a><a href="#l339">339</a><td> * @param {number} value The expected value.<tr><td><a id="l340"></a><a href="#l340">340</a><td> * @param {number} range The maximum allowed difference from the expected value.<tr><td><a id="l341"></a><a href="#l341">341</a><td> *<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @return {!goog.labs.testing.CloseToMatcher} A CloseToMatcher.<tr><td><a id="l343"></a><a href="#l343">343</a><td> */<tr><td><a id="l344"></a><a href="#l344">344</a><td>function closeTo(value, range) {<tr><td><a id="l345"></a><a href="#l345">345</a><td>  return new goog.labs.testing.CloseToMatcher(value, range);<tr><td><a id="l346"></a><a href="#l346">346</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html b/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html
index 69a7f81..f74e010 100644
--- a/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html
+++ b/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>objectmatcher.js</title><link href="../../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/labs/testing/objectmatcher.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides the built-in object matchers like equalsObject,<tr><td><a name="l17" href="#l17">17</a><td> *     hasProperty, instanceOf, etc.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.HasPropertyMatcher&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.labs.testing.InstanceOfMatcher&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.provide(&#39;goog.labs.testing.IsNullMatcher&#39;);<tr><td><a name="l25" href="#l25">25</a><td>goog.provide(&#39;goog.labs.testing.IsNullOrUndefinedMatcher&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.provide(&#39;goog.labs.testing.IsUndefinedMatcher&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.provide(&#39;goog.labs.testing.ObjectEqualsMatcher&#39;);<tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a name="l31" href="#l31">31</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>/**<tr><td><a name="l36" href="#l36">36</a><td> * The Equals matcher.<tr><td><a name="l37" href="#l37">37</a><td> *<tr><td><a name="l38" href="#l38">38</a><td> * @param {!Object} expectedObject The expected object.<tr><td><a name="l39" href="#l39">39</a><td> *<tr><td><a name="l40" href="#l40">40</a><td> * @constructor<tr><td><a name="l41" href="#l41">41</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l42" href="#l42">42</a><td> */<tr><td><a name="l43" href="#l43">43</a><td>goog.labs.testing.ObjectEqualsMatcher = function(expectedObject) {<tr><td><a name="l44" href="#l44">44</a><td>  /**<tr><td><a name="l45" href="#l45">45</a><td>   * @type {!Object}<tr><td><a name="l46" href="#l46">46</a><td>   * @private<tr><td><a name="l47" href="#l47">47</a><td>   */<tr><td><a name="l48" href="#l48">48</a><td>  this.object_ = expectedObject;<tr><td><a name="l49" href="#l49">49</a><td>};<tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td>/**<tr><td><a name="l53" href="#l53">53</a><td> * Determines if two objects are the same.<tr><td><a name="l54" href="#l54">54</a><td> *<tr><td><a name="l55" href="#l55">55</a><td> * @override<tr><td><a name="l56" href="#l56">56</a><td> */<tr><td><a name="l57" href="#l57">57</a><td>goog.labs.testing.ObjectEqualsMatcher.prototype.matches =<tr><td><a name="l58" href="#l58">58</a><td>    function(actualObject) {<tr><td><a name="l59" href="#l59">59</a><td>  return actualObject === this.object_;<tr><td><a name="l60" href="#l60">60</a><td>};<tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td>/**<tr><td><a name="l64" href="#l64">64</a><td> * @override<tr><td><a name="l65" href="#l65">65</a><td> */<tr><td><a name="l66" href="#l66">66</a><td>goog.labs.testing.ObjectEqualsMatcher.prototype.describe =<tr><td><a name="l67" href="#l67">67</a><td>    function(actualObject) {<tr><td><a name="l68" href="#l68">68</a><td>  return &#39;Input object is not the same as the expected object.&#39;;<tr><td><a name="l69" href="#l69">69</a><td>};<tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>/**<tr><td><a name="l74" href="#l74">74</a><td> * The HasProperty matcher.<tr><td><a name="l75" href="#l75">75</a><td> *<tr><td><a name="l76" href="#l76">76</a><td> * @param {string} property Name of the property to test.<tr><td><a name="l77" href="#l77">77</a><td> *<tr><td><a name="l78" href="#l78">78</a><td> * @constructor<tr><td><a name="l79" href="#l79">79</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l80" href="#l80">80</a><td> */<tr><td><a name="l81" href="#l81">81</a><td>goog.labs.testing.HasPropertyMatcher = function(property) {<tr><td><a name="l82" href="#l82">82</a><td>  /**<tr><td><a name="l83" href="#l83">83</a><td>   * @type {string}<tr><td><a name="l84" href="#l84">84</a><td>   * @private<tr><td><a name="l85" href="#l85">85</a><td>   */<tr><td><a name="l86" href="#l86">86</a><td>  this.property_ = property;<tr><td><a name="l87" href="#l87">87</a><td>};<tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td><tr><td><a name="l90" href="#l90">90</a><td>/**<tr><td><a name="l91" href="#l91">91</a><td> * Determines if an object has a property.<tr><td><a name="l92" href="#l92">92</a><td> *<tr><td><a name="l93" href="#l93">93</a><td> * @override<tr><td><a name="l94" href="#l94">94</a><td> */<tr><td><a name="l95" href="#l95">95</a><td>goog.labs.testing.HasPropertyMatcher.prototype.matches =<tr><td><a name="l96" href="#l96">96</a><td>    function(actualObject) {<tr><td><a name="l97" href="#l97">97</a><td>  return this.property_ in actualObject;<tr><td><a name="l98" href="#l98">98</a><td>};<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td><tr><td><a name="l101" href="#l101">101</a><td>/**<tr><td><a name="l102" href="#l102">102</a><td> * @override<tr><td><a name="l103" href="#l103">103</a><td> */<tr><td><a name="l104" href="#l104">104</a><td>goog.labs.testing.HasPropertyMatcher.prototype.describe =<tr><td><a name="l105" href="#l105">105</a><td>    function(actualObject) {<tr><td><a name="l106" href="#l106">106</a><td>  return &#39;Object does not have property: &#39; + this.property_;<tr><td><a name="l107" href="#l107">107</a><td>};<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td>/**<tr><td><a name="l112" href="#l112">112</a><td> * The InstanceOf matcher.<tr><td><a name="l113" href="#l113">113</a><td> *<tr><td><a name="l114" href="#l114">114</a><td> * @param {!Object} object The expected class object.<tr><td><a name="l115" href="#l115">115</a><td> *<tr><td><a name="l116" href="#l116">116</a><td> * @constructor<tr><td><a name="l117" href="#l117">117</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l118" href="#l118">118</a><td> */<tr><td><a name="l119" href="#l119">119</a><td>goog.labs.testing.InstanceOfMatcher = function(object) {<tr><td><a name="l120" href="#l120">120</a><td>  /**<tr><td><a name="l121" href="#l121">121</a><td>   * @type {!Object}<tr><td><a name="l122" href="#l122">122</a><td>   * @private<tr><td><a name="l123" href="#l123">123</a><td>   */<tr><td><a name="l124" href="#l124">124</a><td>  this.object_ = object;<tr><td><a name="l125" href="#l125">125</a><td>};<tr><td><a name="l126" href="#l126">126</a><td><tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td>/**<tr><td><a name="l129" href="#l129">129</a><td> * Determines if an object is an instance of another object.<tr><td><a name="l130" href="#l130">130</a><td> *<tr><td><a name="l131" href="#l131">131</a><td> * @override<tr><td><a name="l132" href="#l132">132</a><td> */<tr><td><a name="l133" href="#l133">133</a><td>goog.labs.testing.InstanceOfMatcher.prototype.matches =<tr><td><a name="l134" href="#l134">134</a><td>    function(actualObject) {<tr><td><a name="l135" href="#l135">135</a><td>  return actualObject instanceof this.object_;<tr><td><a name="l136" href="#l136">136</a><td>};<tr><td><a name="l137" href="#l137">137</a><td><tr><td><a name="l138" href="#l138">138</a><td><tr><td><a name="l139" href="#l139">139</a><td>/**<tr><td><a name="l140" href="#l140">140</a><td> * @override<tr><td><a name="l141" href="#l141">141</a><td> */<tr><td><a name="l142" href="#l142">142</a><td>goog.labs.testing.InstanceOfMatcher.prototype.describe =<tr><td><a name="l143" href="#l143">143</a><td>    function(actualObject) {<tr><td><a name="l144" href="#l144">144</a><td>  return &#39;Input object is not an instance of the expected object&#39;;<tr><td><a name="l145" href="#l145">145</a><td>};<tr><td><a name="l146" href="#l146">146</a><td><tr><td><a name="l147" href="#l147">147</a><td><tr><td><a name="l148" href="#l148">148</a><td><tr><td><a name="l149" href="#l149">149</a><td>/**<tr><td><a name="l150" href="#l150">150</a><td> * The IsNullOrUndefined matcher.<tr><td><a name="l151" href="#l151">151</a><td> *<tr><td><a name="l152" href="#l152">152</a><td> * @constructor<tr><td><a name="l153" href="#l153">153</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l154" href="#l154">154</a><td> */<tr><td><a name="l155" href="#l155">155</a><td>goog.labs.testing.IsNullOrUndefinedMatcher = function() {};<tr><td><a name="l156" href="#l156">156</a><td><tr><td><a name="l157" href="#l157">157</a><td><tr><td><a name="l158" href="#l158">158</a><td>/**<tr><td><a name="l159" href="#l159">159</a><td> * Determines if input value is null or undefined.<tr><td><a name="l160" href="#l160">160</a><td> *<tr><td><a name="l161" href="#l161">161</a><td> * @override<tr><td><a name="l162" href="#l162">162</a><td> */<tr><td><a name="l163" href="#l163">163</a><td>goog.labs.testing.IsNullOrUndefinedMatcher.prototype.matches =<tr><td><a name="l164" href="#l164">164</a><td>    function(actualValue) {<tr><td><a name="l165" href="#l165">165</a><td>  return !goog.isDefAndNotNull(actualValue);<tr><td><a name="l166" href="#l166">166</a><td>};<tr><td><a name="l167" href="#l167">167</a><td><tr><td><a name="l168" href="#l168">168</a><td><tr><td><a name="l169" href="#l169">169</a><td>/**<tr><td><a name="l170" href="#l170">170</a><td> * @override<tr><td><a name="l171" href="#l171">171</a><td> */<tr><td><a name="l172" href="#l172">172</a><td>goog.labs.testing.IsNullOrUndefinedMatcher.prototype.describe =<tr><td><a name="l173" href="#l173">173</a><td>    function(actualValue) {<tr><td><a name="l174" href="#l174">174</a><td>  return actualValue + &#39; is not null or undefined.&#39;;<tr><td><a name="l175" href="#l175">175</a><td>};<tr><td><a name="l176" href="#l176">176</a><td><tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>/**<tr><td><a name="l180" href="#l180">180</a><td> * The IsNull matcher.<tr><td><a name="l181" href="#l181">181</a><td> *<tr><td><a name="l182" href="#l182">182</a><td> * @constructor<tr><td><a name="l183" href="#l183">183</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l184" href="#l184">184</a><td> */<tr><td><a name="l185" href="#l185">185</a><td>goog.labs.testing.IsNullMatcher = function() {};<tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td><tr><td><a name="l188" href="#l188">188</a><td>/**<tr><td><a name="l189" href="#l189">189</a><td> * Determines if input value is null.<tr><td><a name="l190" href="#l190">190</a><td> *<tr><td><a name="l191" href="#l191">191</a><td> * @override<tr><td><a name="l192" href="#l192">192</a><td> */<tr><td><a name="l193" href="#l193">193</a><td>goog.labs.testing.IsNullMatcher.prototype.matches =<tr><td><a name="l194" href="#l194">194</a><td>    function(actualValue) {<tr><td><a name="l195" href="#l195">195</a><td>  return goog.isNull(actualValue);<tr><td><a name="l196" href="#l196">196</a><td>};<tr><td><a name="l197" href="#l197">197</a><td><tr><td><a name="l198" href="#l198">198</a><td><tr><td><a name="l199" href="#l199">199</a><td>/**<tr><td><a name="l200" href="#l200">200</a><td> * @override<tr><td><a name="l201" href="#l201">201</a><td> */<tr><td><a name="l202" href="#l202">202</a><td>goog.labs.testing.IsNullMatcher.prototype.describe =<tr><td><a name="l203" href="#l203">203</a><td>    function(actualValue) {<tr><td><a name="l204" href="#l204">204</a><td>  return actualValue + &#39; is not null.&#39;;<tr><td><a name="l205" href="#l205">205</a><td>};<tr><td><a name="l206" href="#l206">206</a><td><tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td><tr><td><a name="l209" href="#l209">209</a><td>/**<tr><td><a name="l210" href="#l210">210</a><td> * The IsUndefined matcher.<tr><td><a name="l211" href="#l211">211</a><td> *<tr><td><a name="l212" href="#l212">212</a><td> * @constructor<tr><td><a name="l213" href="#l213">213</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l214" href="#l214">214</a><td> */<tr><td><a name="l215" href="#l215">215</a><td>goog.labs.testing.IsUndefinedMatcher = function() {};<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * Determines if input value is undefined.<tr><td><a name="l220" href="#l220">220</a><td> *<tr><td><a name="l221" href="#l221">221</a><td> * @override<tr><td><a name="l222" href="#l222">222</a><td> */<tr><td><a name="l223" href="#l223">223</a><td>goog.labs.testing.IsUndefinedMatcher.prototype.matches =<tr><td><a name="l224" href="#l224">224</a><td>    function(actualValue) {<tr><td><a name="l225" href="#l225">225</a><td>  return !goog.isDef(actualValue);<tr><td><a name="l226" href="#l226">226</a><td>};<tr><td><a name="l227" href="#l227">227</a><td><tr><td><a name="l228" href="#l228">228</a><td><tr><td><a name="l229" href="#l229">229</a><td>/**<tr><td><a name="l230" href="#l230">230</a><td> * @override<tr><td><a name="l231" href="#l231">231</a><td> */<tr><td><a name="l232" href="#l232">232</a><td>goog.labs.testing.IsUndefinedMatcher.prototype.describe =<tr><td><a name="l233" href="#l233">233</a><td>    function(actualValue) {<tr><td><a name="l234" href="#l234">234</a><td>  return actualValue + &#39; is not undefined.&#39;;<tr><td><a name="l235" href="#l235">235</a><td>};<tr><td><a name="l236" href="#l236">236</a><td><tr><td><a name="l237" href="#l237">237</a><td><tr><td><a name="l238" href="#l238">238</a><td>/**<tr><td><a name="l239" href="#l239">239</a><td> * Returns a matcher that matches objects that are equal to the input object.<tr><td><a name="l240" href="#l240">240</a><td> * Equality in this case means the two objects are references to the same<tr><td><a name="l241" href="#l241">241</a><td> * object.<tr><td><a name="l242" href="#l242">242</a><td> *<tr><td><a name="l243" href="#l243">243</a><td> * @param {!Object} object The expected object.<tr><td><a name="l244" href="#l244">244</a><td> *<tr><td><a name="l245" href="#l245">245</a><td> * @return {!goog.labs.testing.ObjectEqualsMatcher} A<tr><td><a name="l246" href="#l246">246</a><td> *     ObjectEqualsMatcher.<tr><td><a name="l247" href="#l247">247</a><td> */<tr><td><a name="l248" href="#l248">248</a><td>function equalsObject(object) {<tr><td><a name="l249" href="#l249">249</a><td>  return new goog.labs.testing.ObjectEqualsMatcher(object);<tr><td><a name="l250" href="#l250">250</a><td>}<tr><td><a name="l251" href="#l251">251</a><td><tr><td><a name="l252" href="#l252">252</a><td><tr><td><a name="l253" href="#l253">253</a><td>/**<tr><td><a name="l254" href="#l254">254</a><td> * Returns a matcher that matches objects that contain the input property.<tr><td><a name="l255" href="#l255">255</a><td> *<tr><td><a name="l256" href="#l256">256</a><td> * @param {string} property The property name to check.<tr><td><a name="l257" href="#l257">257</a><td> *<tr><td><a name="l258" href="#l258">258</a><td> * @return {!goog.labs.testing.HasPropertyMatcher} A HasPropertyMatcher.<tr><td><a name="l259" href="#l259">259</a><td> */<tr><td><a name="l260" href="#l260">260</a><td>function hasProperty(property) {<tr><td><a name="l261" href="#l261">261</a><td>  return new goog.labs.testing.HasPropertyMatcher(property);<tr><td><a name="l262" href="#l262">262</a><td>}<tr><td><a name="l263" href="#l263">263</a><td><tr><td><a name="l264" href="#l264">264</a><td><tr><td><a name="l265" href="#l265">265</a><td>/**<tr><td><a name="l266" href="#l266">266</a><td> * Returns a matcher that matches instances of the input class.<tr><td><a name="l267" href="#l267">267</a><td> *<tr><td><a name="l268" href="#l268">268</a><td> * @param {!Object} object The class object.<tr><td><a name="l269" href="#l269">269</a><td> *<tr><td><a name="l270" href="#l270">270</a><td> * @return {!goog.labs.testing.InstanceOfMatcher} A<tr><td><a name="l271" href="#l271">271</a><td> *     InstanceOfMatcher.<tr><td><a name="l272" href="#l272">272</a><td> */<tr><td><a name="l273" href="#l273">273</a><td>function instanceOfClass(object) {<tr><td><a name="l274" href="#l274">274</a><td>  return new goog.labs.testing.InstanceOfMatcher(object);<tr><td><a name="l275" href="#l275">275</a><td>}<tr><td><a name="l276" href="#l276">276</a><td><tr><td><a name="l277" href="#l277">277</a><td><tr><td><a name="l278" href="#l278">278</a><td>/**<tr><td><a name="l279" href="#l279">279</a><td> * Returns a matcher that matches all null values.<tr><td><a name="l280" href="#l280">280</a><td> *<tr><td><a name="l281" href="#l281">281</a><td> * @return {!goog.labs.testing.IsNullMatcher} A IsNullMatcher.<tr><td><a name="l282" href="#l282">282</a><td> */<tr><td><a name="l283" href="#l283">283</a><td>function isNull() {<tr><td><a name="l284" href="#l284">284</a><td>  return new goog.labs.testing.IsNullMatcher();<tr><td><a name="l285" href="#l285">285</a><td>}<tr><td><a name="l286" href="#l286">286</a><td><tr><td><a name="l287" href="#l287">287</a><td><tr><td><a name="l288" href="#l288">288</a><td>/**<tr><td><a name="l289" href="#l289">289</a><td> * Returns a matcher that matches all null and undefined values.<tr><td><a name="l290" href="#l290">290</a><td> *<tr><td><a name="l291" href="#l291">291</a><td> * @return {!goog.labs.testing.IsNullOrUndefinedMatcher} A<tr><td><a name="l292" href="#l292">292</a><td> *     IsNullOrUndefinedMatcher.<tr><td><a name="l293" href="#l293">293</a><td> */<tr><td><a name="l294" href="#l294">294</a><td>function isNullOrUndefined() {<tr><td><a name="l295" href="#l295">295</a><td>  return new goog.labs.testing.IsNullOrUndefinedMatcher();<tr><td><a name="l296" href="#l296">296</a><td>}<tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td><tr><td><a name="l299" href="#l299">299</a><td>/**<tr><td><a name="l300" href="#l300">300</a><td> * Returns a matcher that matches undefined values.<tr><td><a name="l301" href="#l301">301</a><td> *<tr><td><a name="l302" href="#l302">302</a><td> * @return {!goog.labs.testing.IsUndefinedMatcher} A IsUndefinedMatcher.<tr><td><a name="l303" href="#l303">303</a><td> */<tr><td><a name="l304" href="#l304">304</a><td>function isUndefined() {<tr><td><a name="l305" href="#l305">305</a><td>  return new goog.labs.testing.IsUndefinedMatcher();<tr><td><a name="l306" href="#l306">306</a><td>}</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../../types.js"></script><script src="../../../../../dossier.js"></script>
\ No newline at end of file
+<!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>objectmatcher.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/labs/testing/objectmatcher.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Provides the built-in object matchers like equalsObject,<tr><td><a id="l17"></a><a href="#l17">17</a><td> *     hasProperty, instanceOf, etc.<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.HasPropertyMatcher&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.labs.testing.InstanceOfMatcher&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.labs.testing.IsNullMatcher&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.labs.testing.IsNullOrUndefinedMatcher&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.labs.testing.IsUndefinedMatcher&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;goog.labs.testing.ObjectEqualsMatcher&#39;);<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>goog.require(&#39;goog.labs.testing.Matcher&#39;);<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><tr><td><a id="l34"></a><a href="#l34">34</a><td>/**<tr><td><a id="l35"></a><a href="#l35">35</a><td> * The Equals matcher.<tr><td><a id="l36"></a><a href="#l36">36</a><td> *<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {!Object} expectedObject The expected object.<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @constructor<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @struct<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @final<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.labs.testing.ObjectEqualsMatcher = function(expectedObject) {<tr><td><a id="l45"></a><a href="#l45">45</a><td>  /**<tr><td><a id="l46"></a><a href="#l46">46</a><td>   * @type {!Object}<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.object_ = expectedObject;<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><tr><td><a id="l53"></a><a href="#l53">53</a><td>/**<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Determines if two objects are the same.<tr><td><a id="l55"></a><a href="#l55">55</a><td> *<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @override<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.labs.testing.ObjectEqualsMatcher.prototype.matches =<tr><td><a id="l59"></a><a href="#l59">59</a><td>    function(actualObject) {<tr><td><a id="l60"></a><a href="#l60">60</a><td>  return actualObject === this.object_;<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>/**<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @override<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.labs.testing.ObjectEqualsMatcher.prototype.describe =<tr><td><a id="l68"></a><a href="#l68">68</a><td>    function(actualObject) {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  return &#39;Input object is not the same as the expected object.&#39;;<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>/**<tr><td><a id="l75"></a><a href="#l75">75</a><td> * The HasProperty matcher.<tr><td><a id="l76"></a><a href="#l76">76</a><td> *<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {string} property Name of the property to test.<tr><td><a id="l78"></a><a href="#l78">78</a><td> *<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @constructor<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @struct<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @final<tr><td><a id="l83"></a><a href="#l83">83</a><td> */<tr><td><a id="l84"></a><a href="#l84">84</a><td>goog.labs.testing.HasPropertyMatcher = function(property) {<tr><td><a id="l85"></a><a href="#l85">85</a><td>  /**<tr><td><a id="l86"></a><a href="#l86">86</a><td>   * @type {string}<tr><td><a id="l87"></a><a href="#l87">87</a><td>   * @private<tr><td><a id="l88"></a><a href="#l88">88</a><td>   */<tr><td><a id="l89"></a><a href="#l89">89</a><td>  this.property_ = property;<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> * Determines if an object has a property.<tr><td><a id="l95"></a><a href="#l95">95</a><td> *<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @override<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.labs.testing.HasPropertyMatcher.prototype.matches =<tr><td><a id="l99"></a><a href="#l99">99</a><td>    function(actualObject) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  return this.property_ in actualObject;<tr><td><a id="l101"></a><a href="#l101">101</a><td>};<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>/**<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @override<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.labs.testing.HasPropertyMatcher.prototype.describe =<tr><td><a id="l108"></a><a href="#l108">108</a><td>    function(actualObject) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>  return &#39;Object does not have property: &#39; + this.property_;<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><tr><td><a id="l114"></a><a href="#l114">114</a><td>/**<tr><td><a id="l115"></a><a href="#l115">115</a><td> * The InstanceOf matcher.<tr><td><a id="l116"></a><a href="#l116">116</a><td> *<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @param {!Object} object The expected class object.<tr><td><a id="l118"></a><a href="#l118">118</a><td> *<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @constructor<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @struct<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @final<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.labs.testing.InstanceOfMatcher = function(object) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>  /**<tr><td><a id="l126"></a><a href="#l126">126</a><td>   * @type {!Object}<tr><td><a id="l127"></a><a href="#l127">127</a><td>   * @private<tr><td><a id="l128"></a><a href="#l128">128</a><td>   */<tr><td><a id="l129"></a><a href="#l129">129</a><td>  this.object_ = object;<tr><td><a id="l130"></a><a href="#l130">130</a><td>};<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/**<tr><td><a id="l134"></a><a href="#l134">134</a><td> * Determines if an object is an instance of another object.<tr><td><a id="l135"></a><a href="#l135">135</a><td> *<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @override<tr><td><a id="l137"></a><a href="#l137">137</a><td> */<tr><td><a id="l138"></a><a href="#l138">138</a><td>goog.labs.testing.InstanceOfMatcher.prototype.matches =<tr><td><a id="l139"></a><a href="#l139">139</a><td>    function(actualObject) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>  return actualObject instanceof this.object_;<tr><td><a id="l141"></a><a href="#l141">141</a><td>};<tr><td><a id="l142"></a><a href="#l142">142</a><td><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> * @override<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.labs.testing.InstanceOfMatcher.prototype.describe =<tr><td><a id="l148"></a><a href="#l148">148</a><td>    function(actualObject) {<tr><td><a id="l149"></a><a href="#l149">149</a><td>  return &#39;Input object is not an instance of the expected object&#39;;<tr><td><a id="l150"></a><a href="#l150">150</a><td>};<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td>/**<tr><td><a id="l155"></a><a href="#l155">155</a><td> * The IsNullOrUndefined matcher.<tr><td><a id="l156"></a><a href="#l156">156</a><td> *<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @constructor<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @struct<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @final<tr><td><a id="l161"></a><a href="#l161">161</a><td> */<tr><td><a id="l162"></a><a href="#l162">162</a><td>goog.labs.testing.IsNullOrUndefinedMatcher = function() {};<tr><td><a id="l163"></a><a href="#l163">163</a><td><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> * Determines if input value is null or undefined.<tr><td><a id="l167"></a><a href="#l167">167</a><td> *<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @override<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>goog.labs.testing.IsNullOrUndefinedMatcher.prototype.matches =<tr><td><a id="l171"></a><a href="#l171">171</a><td>    function(actualValue) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>  return !goog.isDefAndNotNull(actualValue);<tr><td><a id="l173"></a><a href="#l173">173</a><td>};<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td>/**<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @override<tr><td><a id="l178"></a><a href="#l178">178</a><td> */<tr><td><a id="l179"></a><a href="#l179">179</a><td>goog.labs.testing.IsNullOrUndefinedMatcher.prototype.describe =<tr><td><a id="l180"></a><a href="#l180">180</a><td>    function(actualValue) {<tr><td><a id="l181"></a><a href="#l181">181</a><td>  return actualValue + &#39; is not null or undefined.&#39;;<tr><td><a id="l182"></a><a href="#l182">182</a><td>};<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td>/**<tr><td><a id="l187"></a><a href="#l187">187</a><td> * The IsNull matcher.<tr><td><a id="l188"></a><a href="#l188">188</a><td> *<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @constructor<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @struct<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @final<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>goog.labs.testing.IsNullMatcher = function() {};<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/**<tr><td><a id="l198"></a><a href="#l198">198</a><td> * Determines if input value is null.<tr><td><a id="l199"></a><a href="#l199">199</a><td> *<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @override<tr><td><a id="l201"></a><a href="#l201">201</a><td> */<tr><td><a id="l202"></a><a href="#l202">202</a><td>goog.labs.testing.IsNullMatcher.prototype.matches =<tr><td><a id="l203"></a><a href="#l203">203</a><td>    function(actualValue) {<tr><td><a id="l204"></a><a href="#l204">204</a><td>  return goog.isNull(actualValue);<tr><td><a id="l205"></a><a href="#l205">205</a><td>};<tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td>/**<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @override<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>goog.labs.testing.IsNullMatcher.prototype.describe =<tr><td><a id="l212"></a><a href="#l212">212</a><td>    function(actualValue) {<tr><td><a id="l213"></a><a href="#l213">213</a><td>  return actualValue + &#39; is not null.&#39;;<tr><td><a id="l214"></a><a href="#l214">214</a><td>};<tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td><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> * The IsUndefined matcher.<tr><td><a id="l220"></a><a href="#l220">220</a><td> *<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @constructor<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @struct<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @final<tr><td><a id="l225"></a><a href="#l225">225</a><td> */<tr><td><a id="l226"></a><a href="#l226">226</a><td>goog.labs.testing.IsUndefinedMatcher = function() {};<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>/**<tr><td><a id="l230"></a><a href="#l230">230</a><td> * Determines if input value is undefined.<tr><td><a id="l231"></a><a href="#l231">231</a><td> *<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @override<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>goog.labs.testing.IsUndefinedMatcher.prototype.matches =<tr><td><a id="l235"></a><a href="#l235">235</a><td>    function(actualValue) {<tr><td><a id="l236"></a><a href="#l236">236</a><td>  return !goog.isDef(actualValue);<tr><td><a id="l237"></a><a href="#l237">237</a><td>};<tr><td><a id="l238"></a><a href="#l238">238</a><td><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> * @override<tr><td><a id="l242"></a><a href="#l242">242</a><td> */<tr><td><a id="l243"></a><a href="#l243">243</a><td>goog.labs.testing.IsUndefinedMatcher.prototype.describe =<tr><td><a id="l244"></a><a href="#l244">244</a><td>    function(actualValue) {<tr><td><a id="l245"></a><a href="#l245">245</a><td>  return actualValue + &#39; is not undefined.&#39;;<tr><td><a id="l246"></a><a href="#l246">246</a><td>};<tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td><tr><td><a id="l249"></a><a href="#l249">249</a><td>/**<tr><td><a id="l250"></a><a href="#l250">250</a><td> * Returns a matcher that matches objects that are equal to the input object.<tr><td><a id="l251"></a><a href="#l251">251</a><td> * Equality in this case means the two objects are references to the same<tr><td><a id="l252"></a><a href="#l252">252</a><td> * object.<tr><td><a id="l253"></a><a href="#l253">253</a><td> *<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @param {!Object} object The expected object.<tr><td><a id="l255"></a><a href="#l255">255</a><td> *<tr><td><a id="l256"></a><a href="#l256">256</a><td> * @return {!goog.labs.testing.ObjectEqualsMatcher} A<tr><td><a id="l257"></a><a href="#l257">257</a><td> *     ObjectEqualsMatcher.<tr><td><a id="l258"></a><a href="#l258">258</a><td> */<tr><td><a id="l259"></a><a href="#l259">259</a><td>function equalsObject(object) {<tr><td><a id="l260"></a><a href="#l260">260</a><td>  return new goog.labs.testing.ObjectEqualsMatcher(object);<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>/**<tr><td><a id="l265"></a><a href="#l265">265</a><td> * Returns a matcher that matches objects that contain the input property.<tr><td><a id="l266"></a><a href="#l266">266</a><td> *<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @param {string} property The property name to check.<tr><td><a id="l268"></a><a href="#l268">268</a><td> *<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @return {!goog.labs.testing.HasPropertyMatcher} A HasPropertyMatcher.<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>function hasProperty(property) {<tr><td><a id="l272"></a><a href="#l272">272</a><td>  return new goog.labs.testing.HasPropertyMatcher(property);<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>/**<tr><td><a id="l277"></a><a href="#l277">277</a><td> * Returns a matcher that matches instances of the input class.<tr><td><a id="l278"></a><a href="#l278">278</a><td> *<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {!Object} object The class object.<tr><td><a id="l280"></a><a href="#l280">280</a><td> *<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @return {!goog.labs.testing.InstanceOfMatcher} A<tr><td><a id="l282"></a><a href="#l282">282</a><td> *     InstanceOfMatcher.<tr><td><a id="l283"></a><a href="#l283">283</a><td> */<tr><td><a id="l284"></a><a href="#l284">284</a><td>function instanceOfClass(object) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>  return new goog.labs.testing.InstanceOfMatcher(object);<tr><td><a id="l286"></a><a href="#l286">286</a><td>}<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>/**<tr><td><a id="l290"></a><a href="#l290">290</a><td> * Returns a matcher that matches all null values.<tr><td><a id="l291"></a><a href="#l291">291</a><td> *<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @return {!goog.labs.testing.IsNullMatcher} A IsNullMatcher.<tr><td><a id="l293"></a><a href="#l293">293</a><td> */<tr><td><a id="l294"></a><a href="#l294">294</a><td>function isNull() {<tr><td><a id="l295"></a><a href="#l295">295</a><td>  return new goog.labs.testing.IsNullMatcher();<tr><td><a id="l296"></a><a href="#l296">296</a><td>}<tr><td><a id="l297"></a><a href="#l297">297</a><td><tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td>/**<tr><td><a id="l300"></a><a href="#l300">300</a><td> * Returns a matcher that matches all null and undefined values.<tr><td><a id="l301"></a><a href="#l301">301</a><td> *<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @return {!goog.labs.testing.IsNullOrUndefinedMatcher} A<tr><td><a id="l303"></a><a href="#l303">303</a><td> *     IsNullOrUndefinedMatcher.<tr><td><a id="l304"></a><a href="#l304">304</a><td> */<tr><td><a id="l305"></a><a href="#l305">305</a><td>function isNullOrUndefined() {<tr><td><a id="l306"></a><a href="#l306">306</a><td>  return new goog.labs.testing.IsNullOrUndefinedMatcher();<tr><td><a id="l307"></a><a href="#l307">307</a><td>}<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>/**<tr><td><a id="l311"></a><a href="#l311">311</a><td> * Returns a matcher that matches undefined values.<tr><td><a id="l312"></a><a href="#l312">312</a><td> *<tr><td><a id="l313"></a><a href="#l313">313</a><td> * @return {!goog.labs.testing.IsUndefinedMatcher} A IsUndefinedMatcher.<tr><td><a id="l314"></a><a href="#l314">314</a><td> */<tr><td><a id="l315"></a><a href="#l315">315</a><td>function isUndefined() {<tr><td><a id="l316"></a><a href="#l316">316</a><td>  return new goog.labs.testing.IsUndefinedMatcher();<tr><td><a id="l317"></a><a href="#l317">317</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html b/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html
index 7f7b789..ec37ca4 100644
--- a/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html
+++ b/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>stringmatcher.js</title><link href="../../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/labs/testing/stringmatcher.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides the built-in string matchers like containsString,<tr><td><a name="l17" href="#l17">17</a><td> *     startsWith, endsWith, etc.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.ContainsStringMatcher&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.EndsWithMatcher&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.labs.testing.EqualToIgnoringCaseMatcher&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.provide(&#39;goog.labs.testing.EqualToIgnoringWhitespaceMatcher&#39;);<tr><td><a name="l25" href="#l25">25</a><td>goog.provide(&#39;goog.labs.testing.EqualsMatcher&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.provide(&#39;goog.labs.testing.RegexMatcher&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.provide(&#39;goog.labs.testing.StartsWithMatcher&#39;);<tr><td><a name="l28" href="#l28">28</a><td>goog.provide(&#39;goog.labs.testing.StringContainsInOrderMatcher&#39;);<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a name="l32" href="#l32">32</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a name="l33" href="#l33">33</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td>/**<tr><td><a name="l38" href="#l38">38</a><td> * The ContainsString matcher.<tr><td><a name="l39" href="#l39">39</a><td> *<tr><td><a name="l40" href="#l40">40</a><td> * @param {string} value The expected string.<tr><td><a name="l41" href="#l41">41</a><td> *<tr><td><a name="l42" href="#l42">42</a><td> * @constructor<tr><td><a name="l43" href="#l43">43</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l44" href="#l44">44</a><td> */<tr><td><a name="l45" href="#l45">45</a><td>goog.labs.testing.ContainsStringMatcher = function(value) {<tr><td><a name="l46" href="#l46">46</a><td>  /**<tr><td><a name="l47" href="#l47">47</a><td>   * @type {string}<tr><td><a name="l48" href="#l48">48</a><td>   * @private<tr><td><a name="l49" href="#l49">49</a><td>   */<tr><td><a name="l50" href="#l50">50</a><td>  this.value_ = value;<tr><td><a name="l51" href="#l51">51</a><td>};<tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td><tr><td><a name="l54" href="#l54">54</a><td>/**<tr><td><a name="l55" href="#l55">55</a><td> * Determines if input string contains the expected string.<tr><td><a name="l56" href="#l56">56</a><td> *<tr><td><a name="l57" href="#l57">57</a><td> * @override<tr><td><a name="l58" href="#l58">58</a><td> */<tr><td><a name="l59" href="#l59">59</a><td>goog.labs.testing.ContainsStringMatcher.prototype.matches =<tr><td><a name="l60" href="#l60">60</a><td>    function(actualValue) {<tr><td><a name="l61" href="#l61">61</a><td>  goog.asserts.assertString(actualValue);<tr><td><a name="l62" href="#l62">62</a><td>  return goog.string.contains(actualValue, this.value_);<tr><td><a name="l63" href="#l63">63</a><td>};<tr><td><a name="l64" href="#l64">64</a><td><tr><td><a name="l65" href="#l65">65</a><td><tr><td><a name="l66" href="#l66">66</a><td>/**<tr><td><a name="l67" href="#l67">67</a><td> * @override<tr><td><a name="l68" href="#l68">68</a><td> */<tr><td><a name="l69" href="#l69">69</a><td>goog.labs.testing.ContainsStringMatcher.prototype.describe =<tr><td><a name="l70" href="#l70">70</a><td>    function(actualValue) {<tr><td><a name="l71" href="#l71">71</a><td>  return actualValue + &#39; does not contain &#39; + this.value_;<tr><td><a name="l72" href="#l72">72</a><td>};<tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td>/**<tr><td><a name="l77" href="#l77">77</a><td> * The EndsWith matcher.<tr><td><a name="l78" href="#l78">78</a><td> *<tr><td><a name="l79" href="#l79">79</a><td> * @param {string} value The expected string.<tr><td><a name="l80" href="#l80">80</a><td> *<tr><td><a name="l81" href="#l81">81</a><td> * @constructor<tr><td><a name="l82" href="#l82">82</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l83" href="#l83">83</a><td> */<tr><td><a name="l84" href="#l84">84</a><td>goog.labs.testing.EndsWithMatcher = function(value) {<tr><td><a name="l85" href="#l85">85</a><td>  /**<tr><td><a name="l86" href="#l86">86</a><td>   * @type {string}<tr><td><a name="l87" href="#l87">87</a><td>   * @private<tr><td><a name="l88" href="#l88">88</a><td>   */<tr><td><a name="l89" href="#l89">89</a><td>  this.value_ = value;<tr><td><a name="l90" href="#l90">90</a><td>};<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>/**<tr><td><a name="l94" href="#l94">94</a><td> * Determines if input string ends with the expected string.<tr><td><a name="l95" href="#l95">95</a><td> *<tr><td><a name="l96" href="#l96">96</a><td> * @override<tr><td><a name="l97" href="#l97">97</a><td> */<tr><td><a name="l98" href="#l98">98</a><td>goog.labs.testing.EndsWithMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l99" href="#l99">99</a><td>  goog.asserts.assertString(actualValue);<tr><td><a name="l100" href="#l100">100</a><td>  return goog.string.endsWith(actualValue, this.value_);<tr><td><a name="l101" href="#l101">101</a><td>};<tr><td><a name="l102" href="#l102">102</a><td><tr><td><a name="l103" href="#l103">103</a><td><tr><td><a name="l104" href="#l104">104</a><td>/**<tr><td><a name="l105" href="#l105">105</a><td> * @override<tr><td><a name="l106" href="#l106">106</a><td> */<tr><td><a name="l107" href="#l107">107</a><td>goog.labs.testing.EndsWithMatcher.prototype.describe =<tr><td><a name="l108" href="#l108">108</a><td>    function(actualValue) {<tr><td><a name="l109" href="#l109">109</a><td>  return actualValue + &#39; does not end with &#39; + this.value_;<tr><td><a name="l110" href="#l110">110</a><td>};<tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td><tr><td><a name="l114" href="#l114">114</a><td>/**<tr><td><a name="l115" href="#l115">115</a><td> * The EqualToIgnoringWhitespace matcher.<tr><td><a name="l116" href="#l116">116</a><td> *<tr><td><a name="l117" href="#l117">117</a><td> * @param {string} value The expected string.<tr><td><a name="l118" href="#l118">118</a><td> *<tr><td><a name="l119" href="#l119">119</a><td> * @constructor<tr><td><a name="l120" href="#l120">120</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l121" href="#l121">121</a><td> */<tr><td><a name="l122" href="#l122">122</a><td>goog.labs.testing.EqualToIgnoringWhitespaceMatcher = function(value) {<tr><td><a name="l123" href="#l123">123</a><td>  /**<tr><td><a name="l124" href="#l124">124</a><td>   * @type {string}<tr><td><a name="l125" href="#l125">125</a><td>   * @private<tr><td><a name="l126" href="#l126">126</a><td>   */<tr><td><a name="l127" href="#l127">127</a><td>  this.value_ = value;<tr><td><a name="l128" href="#l128">128</a><td>};<tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td>/**<tr><td><a name="l132" href="#l132">132</a><td> * Determines if input string contains the expected string.<tr><td><a name="l133" href="#l133">133</a><td> *<tr><td><a name="l134" href="#l134">134</a><td> * @override<tr><td><a name="l135" href="#l135">135</a><td> */<tr><td><a name="l136" href="#l136">136</a><td>goog.labs.testing.EqualToIgnoringWhitespaceMatcher.prototype.matches =<tr><td><a name="l137" href="#l137">137</a><td>    function(actualValue) {<tr><td><a name="l138" href="#l138">138</a><td>  goog.asserts.assertString(actualValue);<tr><td><a name="l139" href="#l139">139</a><td>  var string1 = goog.string.collapseWhitespace(actualValue);<tr><td><a name="l140" href="#l140">140</a><td><tr><td><a name="l141" href="#l141">141</a><td>  return goog.string.caseInsensitiveCompare(this.value_, string1) === 0;<tr><td><a name="l142" href="#l142">142</a><td>};<tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td><tr><td><a name="l145" href="#l145">145</a><td>/**<tr><td><a name="l146" href="#l146">146</a><td> * @override<tr><td><a name="l147" href="#l147">147</a><td> */<tr><td><a name="l148" href="#l148">148</a><td>goog.labs.testing.EqualToIgnoringWhitespaceMatcher.prototype.describe =<tr><td><a name="l149" href="#l149">149</a><td>    function(actualValue) {<tr><td><a name="l150" href="#l150">150</a><td>  return actualValue + &#39; is not equal(ignoring whitespace) to &#39; + this.value_;<tr><td><a name="l151" href="#l151">151</a><td>};<tr><td><a name="l152" href="#l152">152</a><td><tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td>/**<tr><td><a name="l156" href="#l156">156</a><td> * The Equals matcher.<tr><td><a name="l157" href="#l157">157</a><td> *<tr><td><a name="l158" href="#l158">158</a><td> * @param {string} value The expected string.<tr><td><a name="l159" href="#l159">159</a><td> *<tr><td><a name="l160" href="#l160">160</a><td> * @constructor<tr><td><a name="l161" href="#l161">161</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l162" href="#l162">162</a><td> */<tr><td><a name="l163" href="#l163">163</a><td>goog.labs.testing.EqualsMatcher = function(value) {<tr><td><a name="l164" href="#l164">164</a><td>  /**<tr><td><a name="l165" href="#l165">165</a><td>   * @type {string}<tr><td><a name="l166" href="#l166">166</a><td>   * @private<tr><td><a name="l167" href="#l167">167</a><td>   */<tr><td><a name="l168" href="#l168">168</a><td>  this.value_ = value;<tr><td><a name="l169" href="#l169">169</a><td>};<tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td><tr><td><a name="l172" href="#l172">172</a><td>/**<tr><td><a name="l173" href="#l173">173</a><td> * Determines if input string is equal to the expected string.<tr><td><a name="l174" href="#l174">174</a><td> *<tr><td><a name="l175" href="#l175">175</a><td> * @override<tr><td><a name="l176" href="#l176">176</a><td> */<tr><td><a name="l177" href="#l177">177</a><td>goog.labs.testing.EqualsMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l178" href="#l178">178</a><td>  goog.asserts.assertString(actualValue);<tr><td><a name="l179" href="#l179">179</a><td>  return this.value_ === actualValue;<tr><td><a name="l180" href="#l180">180</a><td>};<tr><td><a name="l181" href="#l181">181</a><td><tr><td><a name="l182" href="#l182">182</a><td><tr><td><a name="l183" href="#l183">183</a><td>/**<tr><td><a name="l184" href="#l184">184</a><td> * @override<tr><td><a name="l185" href="#l185">185</a><td> */<tr><td><a name="l186" href="#l186">186</a><td>goog.labs.testing.EqualsMatcher.prototype.describe =<tr><td><a name="l187" href="#l187">187</a><td>    function(actualValue) {<tr><td><a name="l188" href="#l188">188</a><td>  return actualValue + &#39; is not equal to &#39; + this.value_;<tr><td><a name="l189" href="#l189">189</a><td>};<tr><td><a name="l190" href="#l190">190</a><td><tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td><tr><td><a name="l193" href="#l193">193</a><td>/**<tr><td><a name="l194" href="#l194">194</a><td> * The MatchesRegex matcher.<tr><td><a name="l195" href="#l195">195</a><td> *<tr><td><a name="l196" href="#l196">196</a><td> * @param {!RegExp} regex The expected regex.<tr><td><a name="l197" href="#l197">197</a><td> *<tr><td><a name="l198" href="#l198">198</a><td> * @constructor<tr><td><a name="l199" href="#l199">199</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l200" href="#l200">200</a><td> */<tr><td><a name="l201" href="#l201">201</a><td>goog.labs.testing.RegexMatcher = function(regex) {<tr><td><a name="l202" href="#l202">202</a><td>  /**<tr><td><a name="l203" href="#l203">203</a><td>   * @type {!RegExp}<tr><td><a name="l204" href="#l204">204</a><td>   * @private<tr><td><a name="l205" href="#l205">205</a><td>   */<tr><td><a name="l206" href="#l206">206</a><td>  this.regex_ = regex;<tr><td><a name="l207" href="#l207">207</a><td>};<tr><td><a name="l208" href="#l208">208</a><td><tr><td><a name="l209" href="#l209">209</a><td><tr><td><a name="l210" href="#l210">210</a><td>/**<tr><td><a name="l211" href="#l211">211</a><td> * Determines if input string is equal to the expected string.<tr><td><a name="l212" href="#l212">212</a><td> *<tr><td><a name="l213" href="#l213">213</a><td> * @override<tr><td><a name="l214" href="#l214">214</a><td> */<tr><td><a name="l215" href="#l215">215</a><td>goog.labs.testing.RegexMatcher.prototype.matches = function(<tr><td><a name="l216" href="#l216">216</a><td>    actualValue) {<tr><td><a name="l217" href="#l217">217</a><td>  goog.asserts.assertString(actualValue);<tr><td><a name="l218" href="#l218">218</a><td>  return this.regex_.test(actualValue);<tr><td><a name="l219" href="#l219">219</a><td>};<tr><td><a name="l220" href="#l220">220</a><td><tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td>/**<tr><td><a name="l223" href="#l223">223</a><td> * @override<tr><td><a name="l224" href="#l224">224</a><td> */<tr><td><a name="l225" href="#l225">225</a><td>goog.labs.testing.RegexMatcher.prototype.describe =<tr><td><a name="l226" href="#l226">226</a><td>    function(actualValue) {<tr><td><a name="l227" href="#l227">227</a><td>  return actualValue + &#39; does not match &#39; + this.regex_;<tr><td><a name="l228" href="#l228">228</a><td>};<tr><td><a name="l229" href="#l229">229</a><td><tr><td><a name="l230" href="#l230">230</a><td><tr><td><a name="l231" href="#l231">231</a><td><tr><td><a name="l232" href="#l232">232</a><td>/**<tr><td><a name="l233" href="#l233">233</a><td> * The StartsWith matcher.<tr><td><a name="l234" href="#l234">234</a><td> *<tr><td><a name="l235" href="#l235">235</a><td> * @param {string} value The expected string.<tr><td><a name="l236" href="#l236">236</a><td> *<tr><td><a name="l237" href="#l237">237</a><td> * @constructor<tr><td><a name="l238" href="#l238">238</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l239" href="#l239">239</a><td> */<tr><td><a name="l240" href="#l240">240</a><td>goog.labs.testing.StartsWithMatcher = function(value) {<tr><td><a name="l241" href="#l241">241</a><td>  /**<tr><td><a name="l242" href="#l242">242</a><td>   * @type {string}<tr><td><a name="l243" href="#l243">243</a><td>   * @private<tr><td><a name="l244" href="#l244">244</a><td>   */<tr><td><a name="l245" href="#l245">245</a><td>  this.value_ = value;<tr><td><a name="l246" href="#l246">246</a><td>};<tr><td><a name="l247" href="#l247">247</a><td><tr><td><a name="l248" href="#l248">248</a><td><tr><td><a name="l249" href="#l249">249</a><td>/**<tr><td><a name="l250" href="#l250">250</a><td> * Determines if input string starts with the expected string.<tr><td><a name="l251" href="#l251">251</a><td> *<tr><td><a name="l252" href="#l252">252</a><td> * @override<tr><td><a name="l253" href="#l253">253</a><td> */<tr><td><a name="l254" href="#l254">254</a><td>goog.labs.testing.StartsWithMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l255" href="#l255">255</a><td>  goog.asserts.assertString(actualValue);<tr><td><a name="l256" href="#l256">256</a><td>  return goog.string.startsWith(actualValue, this.value_);<tr><td><a name="l257" href="#l257">257</a><td>};<tr><td><a name="l258" href="#l258">258</a><td><tr><td><a name="l259" href="#l259">259</a><td><tr><td><a name="l260" href="#l260">260</a><td>/**<tr><td><a name="l261" href="#l261">261</a><td> * @override<tr><td><a name="l262" href="#l262">262</a><td> */<tr><td><a name="l263" href="#l263">263</a><td>goog.labs.testing.StartsWithMatcher.prototype.describe =<tr><td><a name="l264" href="#l264">264</a><td>    function(actualValue) {<tr><td><a name="l265" href="#l265">265</a><td>  return actualValue + &#39; does not start with &#39; + this.value_;<tr><td><a name="l266" href="#l266">266</a><td>};<tr><td><a name="l267" href="#l267">267</a><td><tr><td><a name="l268" href="#l268">268</a><td><tr><td><a name="l269" href="#l269">269</a><td><tr><td><a name="l270" href="#l270">270</a><td>/**<tr><td><a name="l271" href="#l271">271</a><td> * The StringContainsInOrdermatcher.<tr><td><a name="l272" href="#l272">272</a><td> *<tr><td><a name="l273" href="#l273">273</a><td> * @param {Array.&lt;string&gt;} values The expected string values.<tr><td><a name="l274" href="#l274">274</a><td> *<tr><td><a name="l275" href="#l275">275</a><td> * @constructor<tr><td><a name="l276" href="#l276">276</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l277" href="#l277">277</a><td> */<tr><td><a name="l278" href="#l278">278</a><td>goog.labs.testing.StringContainsInOrderMatcher = function(values) {<tr><td><a name="l279" href="#l279">279</a><td>  /**<tr><td><a name="l280" href="#l280">280</a><td>   * @type {Array.&lt;string&gt;}<tr><td><a name="l281" href="#l281">281</a><td>   * @private<tr><td><a name="l282" href="#l282">282</a><td>   */<tr><td><a name="l283" href="#l283">283</a><td>  this.values_ = values;<tr><td><a name="l284" href="#l284">284</a><td>};<tr><td><a name="l285" href="#l285">285</a><td><tr><td><a name="l286" href="#l286">286</a><td><tr><td><a name="l287" href="#l287">287</a><td>/**<tr><td><a name="l288" href="#l288">288</a><td> * Determines if input string contains, in order, the expected array of strings.<tr><td><a name="l289" href="#l289">289</a><td> *<tr><td><a name="l290" href="#l290">290</a><td> * @override<tr><td><a name="l291" href="#l291">291</a><td> */<tr><td><a name="l292" href="#l292">292</a><td>goog.labs.testing.StringContainsInOrderMatcher.prototype.matches =<tr><td><a name="l293" href="#l293">293</a><td>    function(actualValue) {<tr><td><a name="l294" href="#l294">294</a><td>  goog.asserts.assertString(actualValue);<tr><td><a name="l295" href="#l295">295</a><td>  var currentIndex, previousIndex = 0;<tr><td><a name="l296" href="#l296">296</a><td>  for (var i = 0; i &lt; this.values_.length; i++) {<tr><td><a name="l297" href="#l297">297</a><td>    currentIndex = goog.string.contains(actualValue, this.values_[i]);<tr><td><a name="l298" href="#l298">298</a><td>    if (currentIndex &lt; 0 || currentIndex &lt; previousIndex) {<tr><td><a name="l299" href="#l299">299</a><td>      return false;<tr><td><a name="l300" href="#l300">300</a><td>    }<tr><td><a name="l301" href="#l301">301</a><td>    previousIndex = currentIndex;<tr><td><a name="l302" href="#l302">302</a><td>  }<tr><td><a name="l303" href="#l303">303</a><td>  return true;<tr><td><a name="l304" href="#l304">304</a><td>};<tr><td><a name="l305" href="#l305">305</a><td><tr><td><a name="l306" href="#l306">306</a><td><tr><td><a name="l307" href="#l307">307</a><td>/**<tr><td><a name="l308" href="#l308">308</a><td> * @override<tr><td><a name="l309" href="#l309">309</a><td> */<tr><td><a name="l310" href="#l310">310</a><td>goog.labs.testing.StringContainsInOrderMatcher.prototype.describe =<tr><td><a name="l311" href="#l311">311</a><td>    function(actualValue) {<tr><td><a name="l312" href="#l312">312</a><td>  return actualValue + &#39; does not contain the expected values in order.&#39;;<tr><td><a name="l313" href="#l313">313</a><td>};<tr><td><a name="l314" href="#l314">314</a><td><tr><td><a name="l315" href="#l315">315</a><td><tr><td><a name="l316" href="#l316">316</a><td>/**<tr><td><a name="l317" href="#l317">317</a><td> * Matches a string containing the given string.<tr><td><a name="l318" href="#l318">318</a><td> *<tr><td><a name="l319" href="#l319">319</a><td> * @param {string} value The expected value.<tr><td><a name="l320" href="#l320">320</a><td> *<tr><td><a name="l321" href="#l321">321</a><td> * @return {!goog.labs.testing.ContainsStringMatcher} A<tr><td><a name="l322" href="#l322">322</a><td> *     ContainsStringMatcher.<tr><td><a name="l323" href="#l323">323</a><td> */<tr><td><a name="l324" href="#l324">324</a><td>function containsString(value) {<tr><td><a name="l325" href="#l325">325</a><td>  return new goog.labs.testing.ContainsStringMatcher(value);<tr><td><a name="l326" href="#l326">326</a><td>}<tr><td><a name="l327" href="#l327">327</a><td><tr><td><a name="l328" href="#l328">328</a><td><tr><td><a name="l329" href="#l329">329</a><td>/**<tr><td><a name="l330" href="#l330">330</a><td> * Matches a string that ends with the given string.<tr><td><a name="l331" href="#l331">331</a><td> *<tr><td><a name="l332" href="#l332">332</a><td> * @param {string} value The expected value.<tr><td><a name="l333" href="#l333">333</a><td> *<tr><td><a name="l334" href="#l334">334</a><td> * @return {!goog.labs.testing.EndsWithMatcher} A<tr><td><a name="l335" href="#l335">335</a><td> *     EndsWithMatcher.<tr><td><a name="l336" href="#l336">336</a><td> */<tr><td><a name="l337" href="#l337">337</a><td>function endsWith(value) {<tr><td><a name="l338" href="#l338">338</a><td>  return new goog.labs.testing.EndsWithMatcher(value);<tr><td><a name="l339" href="#l339">339</a><td>}<tr><td><a name="l340" href="#l340">340</a><td><tr><td><a name="l341" href="#l341">341</a><td><tr><td><a name="l342" href="#l342">342</a><td>/**<tr><td><a name="l343" href="#l343">343</a><td> * Matches a string that equals (ignoring whitespace) the given string.<tr><td><a name="l344" href="#l344">344</a><td> *<tr><td><a name="l345" href="#l345">345</a><td> * @param {string} value The expected value.<tr><td><a name="l346" href="#l346">346</a><td> *<tr><td><a name="l347" href="#l347">347</a><td> * @return {!goog.labs.testing.EqualToIgnoringWhitespaceMatcher} A<tr><td><a name="l348" href="#l348">348</a><td> *     EqualToIgnoringWhitespaceMatcher.<tr><td><a name="l349" href="#l349">349</a><td> */<tr><td><a name="l350" href="#l350">350</a><td>function equalToIgnoringWhitespace(value) {<tr><td><a name="l351" href="#l351">351</a><td>  return new goog.labs.testing.EqualToIgnoringWhitespaceMatcher(value);<tr><td><a name="l352" href="#l352">352</a><td>}<tr><td><a name="l353" href="#l353">353</a><td><tr><td><a name="l354" href="#l354">354</a><td><tr><td><a name="l355" href="#l355">355</a><td>/**<tr><td><a name="l356" href="#l356">356</a><td> * Matches a string that equals the given string.<tr><td><a name="l357" href="#l357">357</a><td> *<tr><td><a name="l358" href="#l358">358</a><td> * @param {string} value The expected value.<tr><td><a name="l359" href="#l359">359</a><td> *<tr><td><a name="l360" href="#l360">360</a><td> * @return {!goog.labs.testing.EqualsMatcher} A EqualsMatcher.<tr><td><a name="l361" href="#l361">361</a><td> */<tr><td><a name="l362" href="#l362">362</a><td>function equals(value) {<tr><td><a name="l363" href="#l363">363</a><td>  return new goog.labs.testing.EqualsMatcher(value);<tr><td><a name="l364" href="#l364">364</a><td>}<tr><td><a name="l365" href="#l365">365</a><td><tr><td><a name="l366" href="#l366">366</a><td><tr><td><a name="l367" href="#l367">367</a><td>/**<tr><td><a name="l368" href="#l368">368</a><td> * Matches a string against a regular expression.<tr><td><a name="l369" href="#l369">369</a><td> *<tr><td><a name="l370" href="#l370">370</a><td> * @param {!RegExp} regex The expected regex.<tr><td><a name="l371" href="#l371">371</a><td> *<tr><td><a name="l372" href="#l372">372</a><td> * @return {!goog.labs.testing.RegexMatcher} A RegexMatcher.<tr><td><a name="l373" href="#l373">373</a><td> */<tr><td><a name="l374" href="#l374">374</a><td>function matchesRegex(regex) {<tr><td><a name="l375" href="#l375">375</a><td>  return new goog.labs.testing.RegexMatcher(regex);<tr><td><a name="l376" href="#l376">376</a><td>}<tr><td><a name="l377" href="#l377">377</a><td><tr><td><a name="l378" href="#l378">378</a><td><tr><td><a name="l379" href="#l379">379</a><td>/**<tr><td><a name="l380" href="#l380">380</a><td> * Matches a string that starts with the given string.<tr><td><a name="l381" href="#l381">381</a><td> *<tr><td><a name="l382" href="#l382">382</a><td> * @param {string} value The expected value.<tr><td><a name="l383" href="#l383">383</a><td> *<tr><td><a name="l384" href="#l384">384</a><td> * @return {!goog.labs.testing.StartsWithMatcher} A<tr><td><a name="l385" href="#l385">385</a><td> *     StartsWithMatcher.<tr><td><a name="l386" href="#l386">386</a><td> */<tr><td><a name="l387" href="#l387">387</a><td>function startsWith(value) {<tr><td><a name="l388" href="#l388">388</a><td>  return new goog.labs.testing.StartsWithMatcher(value);<tr><td><a name="l389" href="#l389">389</a><td>}<tr><td><a name="l390" href="#l390">390</a><td><tr><td><a name="l391" href="#l391">391</a><td><tr><td><a name="l392" href="#l392">392</a><td>/**<tr><td><a name="l393" href="#l393">393</a><td> * Matches a string that contains the given strings in order.<tr><td><a name="l394" href="#l394">394</a><td> *<tr><td><a name="l395" href="#l395">395</a><td> * @param {Array.&lt;string&gt;} values The expected value.<tr><td><a name="l396" href="#l396">396</a><td> *<tr><td><a name="l397" href="#l397">397</a><td> * @return {!goog.labs.testing.StringContainsInOrderMatcher} A<tr><td><a name="l398" href="#l398">398</a><td> *     StringContainsInOrderMatcher.<tr><td><a name="l399" href="#l399">399</a><td> */<tr><td><a name="l400" href="#l400">400</a><td>function stringContainsInOrder(values) {<tr><td><a name="l401" href="#l401">401</a><td>  return new goog.labs.testing.StringContainsInOrderMatcher(values);<tr><td><a name="l402" href="#l402">402</a><td>}</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../../types.js"></script><script src="../../../../../dossier.js"></script>
\ No newline at end of file
+<!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>stringmatcher.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/labs/testing/stringmatcher.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2012 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Provides the built-in string matchers like containsString,<tr><td><a id="l17"></a><a href="#l17">17</a><td> *     startsWith, endsWith, etc.<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.labs.testing.ContainsStringMatcher&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.labs.testing.EndsWithMatcher&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.labs.testing.EqualToIgnoringWhitespaceMatcher&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.labs.testing.EqualsMatcher&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.labs.testing.RegexMatcher&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.labs.testing.StartsWithMatcher&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;goog.labs.testing.StringContainsInOrderMatcher&#39;);<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>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><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> * The ContainsString matcher.<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @param {string} value The expected string.<tr><td><a id="l40"></a><a href="#l40">40</a><td> *<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @constructor<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @struct<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @final<tr><td><a id="l45"></a><a href="#l45">45</a><td> */<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.labs.testing.ContainsStringMatcher = function(value) {<tr><td><a id="l47"></a><a href="#l47">47</a><td>  /**<tr><td><a id="l48"></a><a href="#l48">48</a><td>   * @type {string}<tr><td><a id="l49"></a><a href="#l49">49</a><td>   * @private<tr><td><a id="l50"></a><a href="#l50">50</a><td>   */<tr><td><a id="l51"></a><a href="#l51">51</a><td>  this.value_ = value;<tr><td><a id="l52"></a><a href="#l52">52</a><td>};<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>/**<tr><td><a id="l56"></a><a href="#l56">56</a><td> * Determines if input string contains the expected string.<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @override<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.labs.testing.ContainsStringMatcher.prototype.matches =<tr><td><a id="l61"></a><a href="#l61">61</a><td>    function(actualValue) {<tr><td><a id="l62"></a><a href="#l62">62</a><td>  goog.asserts.assertString(actualValue);<tr><td><a id="l63"></a><a href="#l63">63</a><td>  return goog.string.contains(actualValue, this.value_);<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> * @override<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>goog.labs.testing.ContainsStringMatcher.prototype.describe =<tr><td><a id="l71"></a><a href="#l71">71</a><td>    function(actualValue) {<tr><td><a id="l72"></a><a href="#l72">72</a><td>  return actualValue + &#39; does not contain &#39; + this.value_;<tr><td><a id="l73"></a><a href="#l73">73</a><td>};<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * The EndsWith matcher.<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} value The expected string.<tr><td><a id="l81"></a><a href="#l81">81</a><td> *<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @constructor<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @struct<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @final<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.labs.testing.EndsWithMatcher = function(value) {<tr><td><a id="l88"></a><a href="#l88">88</a><td>  /**<tr><td><a id="l89"></a><a href="#l89">89</a><td>   * @type {string}<tr><td><a id="l90"></a><a href="#l90">90</a><td>   * @private<tr><td><a id="l91"></a><a href="#l91">91</a><td>   */<tr><td><a id="l92"></a><a href="#l92">92</a><td>  this.value_ = value;<tr><td><a id="l93"></a><a href="#l93">93</a><td>};<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>/**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Determines if input string ends with the expected string.<tr><td><a id="l98"></a><a href="#l98">98</a><td> *<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @override<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.labs.testing.EndsWithMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l102"></a><a href="#l102">102</a><td>  goog.asserts.assertString(actualValue);<tr><td><a id="l103"></a><a href="#l103">103</a><td>  return goog.string.endsWith(actualValue, this.value_);<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><tr><td><a id="l107"></a><a href="#l107">107</a><td>/**<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @override<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.labs.testing.EndsWithMatcher.prototype.describe =<tr><td><a id="l111"></a><a href="#l111">111</a><td>    function(actualValue) {<tr><td><a id="l112"></a><a href="#l112">112</a><td>  return actualValue + &#39; does not end with &#39; + this.value_;<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><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> * The EqualToIgnoringWhitespace matcher.<tr><td><a id="l119"></a><a href="#l119">119</a><td> *<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @param {string} value The expected string.<tr><td><a id="l121"></a><a href="#l121">121</a><td> *<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @constructor<tr><td><a id="l123"></a><a href="#l123">123</a><td> * @struct<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @final<tr><td><a id="l126"></a><a href="#l126">126</a><td> */<tr><td><a id="l127"></a><a href="#l127">127</a><td>goog.labs.testing.EqualToIgnoringWhitespaceMatcher = function(value) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>  /**<tr><td><a id="l129"></a><a href="#l129">129</a><td>   * @type {string}<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>  this.value_ = value;<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>/**<tr><td><a id="l137"></a><a href="#l137">137</a><td> * Determines if input string contains the expected string.<tr><td><a id="l138"></a><a href="#l138">138</a><td> *<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @override<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.labs.testing.EqualToIgnoringWhitespaceMatcher.prototype.matches =<tr><td><a id="l142"></a><a href="#l142">142</a><td>    function(actualValue) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>  goog.asserts.assertString(actualValue);<tr><td><a id="l144"></a><a href="#l144">144</a><td>  var string1 = goog.string.collapseWhitespace(actualValue);<tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td>  return goog.string.caseInsensitiveCompare(this.value_, string1) === 0;<tr><td><a id="l147"></a><a href="#l147">147</a><td>};<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>/**<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @override<tr><td><a id="l152"></a><a href="#l152">152</a><td> */<tr><td><a id="l153"></a><a href="#l153">153</a><td>goog.labs.testing.EqualToIgnoringWhitespaceMatcher.prototype.describe =<tr><td><a id="l154"></a><a href="#l154">154</a><td>    function(actualValue) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>  return actualValue + &#39; is not equal(ignoring whitespace) to &#39; + this.value_;<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><tr><td><a id="l160"></a><a href="#l160">160</a><td>/**<tr><td><a id="l161"></a><a href="#l161">161</a><td> * The Equals matcher.<tr><td><a id="l162"></a><a href="#l162">162</a><td> *<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @param {string} value The expected string.<tr><td><a id="l164"></a><a href="#l164">164</a><td> *<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @constructor<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @struct<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @final<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>goog.labs.testing.EqualsMatcher = function(value) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>  /**<tr><td><a id="l172"></a><a href="#l172">172</a><td>   * @type {string}<tr><td><a id="l173"></a><a href="#l173">173</a><td>   * @private<tr><td><a id="l174"></a><a href="#l174">174</a><td>   */<tr><td><a id="l175"></a><a href="#l175">175</a><td>  this.value_ = value;<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>/**<tr><td><a id="l180"></a><a href="#l180">180</a><td> * Determines if input string is equal to the expected string.<tr><td><a id="l181"></a><a href="#l181">181</a><td> *<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @override<tr><td><a id="l183"></a><a href="#l183">183</a><td> */<tr><td><a id="l184"></a><a href="#l184">184</a><td>goog.labs.testing.EqualsMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l185"></a><a href="#l185">185</a><td>  goog.asserts.assertString(actualValue);<tr><td><a id="l186"></a><a href="#l186">186</a><td>  return this.value_ === actualValue;<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><tr><td><a id="l190"></a><a href="#l190">190</a><td>/**<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @override<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>goog.labs.testing.EqualsMatcher.prototype.describe =<tr><td><a id="l194"></a><a href="#l194">194</a><td>    function(actualValue) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>  return actualValue + &#39; is not equal to &#39; + this.value_;<tr><td><a id="l196"></a><a href="#l196">196</a><td>};<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td><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> * The MatchesRegex matcher.<tr><td><a id="l202"></a><a href="#l202">202</a><td> *<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {!RegExp} regex The expected regex.<tr><td><a id="l204"></a><a href="#l204">204</a><td> *<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @constructor<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @struct<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @final<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>goog.labs.testing.RegexMatcher = function(regex) {<tr><td><a id="l211"></a><a href="#l211">211</a><td>  /**<tr><td><a id="l212"></a><a href="#l212">212</a><td>   * @type {!RegExp}<tr><td><a id="l213"></a><a href="#l213">213</a><td>   * @private<tr><td><a id="l214"></a><a href="#l214">214</a><td>   */<tr><td><a id="l215"></a><a href="#l215">215</a><td>  this.regex_ = regex;<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> * Determines if input string is equal to the expected string.<tr><td><a id="l221"></a><a href="#l221">221</a><td> *<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @override<tr><td><a id="l223"></a><a href="#l223">223</a><td> */<tr><td><a id="l224"></a><a href="#l224">224</a><td>goog.labs.testing.RegexMatcher.prototype.matches = function(<tr><td><a id="l225"></a><a href="#l225">225</a><td>    actualValue) {<tr><td><a id="l226"></a><a href="#l226">226</a><td>  goog.asserts.assertString(actualValue);<tr><td><a id="l227"></a><a href="#l227">227</a><td>  return this.regex_.test(actualValue);<tr><td><a id="l228"></a><a href="#l228">228</a><td>};<tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>/**<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @override<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>goog.labs.testing.RegexMatcher.prototype.describe =<tr><td><a id="l235"></a><a href="#l235">235</a><td>    function(actualValue) {<tr><td><a id="l236"></a><a href="#l236">236</a><td>  return actualValue + &#39; does not match &#39; + this.regex_;<tr><td><a id="l237"></a><a href="#l237">237</a><td>};<tr><td><a id="l238"></a><a href="#l238">238</a><td><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>/**<tr><td><a id="l242"></a><a href="#l242">242</a><td> * The StartsWith matcher.<tr><td><a id="l243"></a><a href="#l243">243</a><td> *<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {string} value The expected string.<tr><td><a id="l245"></a><a href="#l245">245</a><td> *<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @constructor<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @struct<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @final<tr><td><a id="l250"></a><a href="#l250">250</a><td> */<tr><td><a id="l251"></a><a href="#l251">251</a><td>goog.labs.testing.StartsWithMatcher = function(value) {<tr><td><a id="l252"></a><a href="#l252">252</a><td>  /**<tr><td><a id="l253"></a><a href="#l253">253</a><td>   * @type {string}<tr><td><a id="l254"></a><a href="#l254">254</a><td>   * @private<tr><td><a id="l255"></a><a href="#l255">255</a><td>   */<tr><td><a id="l256"></a><a href="#l256">256</a><td>  this.value_ = value;<tr><td><a id="l257"></a><a href="#l257">257</a><td>};<tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td>/**<tr><td><a id="l261"></a><a href="#l261">261</a><td> * Determines if input string starts with the expected string.<tr><td><a id="l262"></a><a href="#l262">262</a><td> *<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @override<tr><td><a id="l264"></a><a href="#l264">264</a><td> */<tr><td><a id="l265"></a><a href="#l265">265</a><td>goog.labs.testing.StartsWithMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l266"></a><a href="#l266">266</a><td>  goog.asserts.assertString(actualValue);<tr><td><a id="l267"></a><a href="#l267">267</a><td>  return goog.string.startsWith(actualValue, this.value_);<tr><td><a id="l268"></a><a href="#l268">268</a><td>};<tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>/**<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @override<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td>goog.labs.testing.StartsWithMatcher.prototype.describe =<tr><td><a id="l275"></a><a href="#l275">275</a><td>    function(actualValue) {<tr><td><a id="l276"></a><a href="#l276">276</a><td>  return actualValue + &#39; does not start with &#39; + this.value_;<tr><td><a id="l277"></a><a href="#l277">277</a><td>};<tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td><tr><td><a id="l281"></a><a href="#l281">281</a><td>/**<tr><td><a id="l282"></a><a href="#l282">282</a><td> * The StringContainsInOrdermatcher.<tr><td><a id="l283"></a><a href="#l283">283</a><td> *<tr><td><a id="l284"></a><a href="#l284">284</a><td> * @param {Array&lt;string&gt;} values The expected string values.<tr><td><a id="l285"></a><a href="#l285">285</a><td> *<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @constructor<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @struct<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @final<tr><td><a id="l290"></a><a href="#l290">290</a><td> */<tr><td><a id="l291"></a><a href="#l291">291</a><td>goog.labs.testing.StringContainsInOrderMatcher = function(values) {<tr><td><a id="l292"></a><a href="#l292">292</a><td>  /**<tr><td><a id="l293"></a><a href="#l293">293</a><td>   * @type {Array&lt;string&gt;}<tr><td><a id="l294"></a><a href="#l294">294</a><td>   * @private<tr><td><a id="l295"></a><a href="#l295">295</a><td>   */<tr><td><a id="l296"></a><a href="#l296">296</a><td>  this.values_ = values;<tr><td><a id="l297"></a><a href="#l297">297</a><td>};<tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>/**<tr><td><a id="l301"></a><a href="#l301">301</a><td> * Determines if input string contains, in order, the expected array of strings.<tr><td><a id="l302"></a><a href="#l302">302</a><td> *<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @override<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.labs.testing.StringContainsInOrderMatcher.prototype.matches =<tr><td><a id="l306"></a><a href="#l306">306</a><td>    function(actualValue) {<tr><td><a id="l307"></a><a href="#l307">307</a><td>  goog.asserts.assertString(actualValue);<tr><td><a id="l308"></a><a href="#l308">308</a><td>  var currentIndex, previousIndex = 0;<tr><td><a id="l309"></a><a href="#l309">309</a><td>  for (var i = 0; i &lt; this.values_.length; i++) {<tr><td><a id="l310"></a><a href="#l310">310</a><td>    currentIndex = goog.string.contains(actualValue, this.values_[i]);<tr><td><a id="l311"></a><a href="#l311">311</a><td>    if (currentIndex &lt; 0 || currentIndex &lt; previousIndex) {<tr><td><a id="l312"></a><a href="#l312">312</a><td>      return false;<tr><td><a id="l313"></a><a href="#l313">313</a><td>    }<tr><td><a id="l314"></a><a href="#l314">314</a><td>    previousIndex = currentIndex;<tr><td><a id="l315"></a><a href="#l315">315</a><td>  }<tr><td><a id="l316"></a><a href="#l316">316</a><td>  return true;<tr><td><a id="l317"></a><a href="#l317">317</a><td>};<tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>/**<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @override<tr><td><a id="l322"></a><a href="#l322">322</a><td> */<tr><td><a id="l323"></a><a href="#l323">323</a><td>goog.labs.testing.StringContainsInOrderMatcher.prototype.describe =<tr><td><a id="l324"></a><a href="#l324">324</a><td>    function(actualValue) {<tr><td><a id="l325"></a><a href="#l325">325</a><td>  return actualValue + &#39; does not contain the expected values in order.&#39;;<tr><td><a id="l326"></a><a href="#l326">326</a><td>};<tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td>/**<tr><td><a id="l330"></a><a href="#l330">330</a><td> * Matches a string containing the given string.<tr><td><a id="l331"></a><a href="#l331">331</a><td> *<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @param {string} value The expected value.<tr><td><a id="l333"></a><a href="#l333">333</a><td> *<tr><td><a id="l334"></a><a href="#l334">334</a><td> * @return {!goog.labs.testing.ContainsStringMatcher} A<tr><td><a id="l335"></a><a href="#l335">335</a><td> *     ContainsStringMatcher.<tr><td><a id="l336"></a><a href="#l336">336</a><td> */<tr><td><a id="l337"></a><a href="#l337">337</a><td>function containsString(value) {<tr><td><a id="l338"></a><a href="#l338">338</a><td>  return new goog.labs.testing.ContainsStringMatcher(value);<tr><td><a id="l339"></a><a href="#l339">339</a><td>}<tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td><tr><td><a id="l342"></a><a href="#l342">342</a><td>/**<tr><td><a id="l343"></a><a href="#l343">343</a><td> * Matches a string that ends with the given string.<tr><td><a id="l344"></a><a href="#l344">344</a><td> *<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @param {string} value The expected value.<tr><td><a id="l346"></a><a href="#l346">346</a><td> *<tr><td><a id="l347"></a><a href="#l347">347</a><td> * @return {!goog.labs.testing.EndsWithMatcher} A<tr><td><a id="l348"></a><a href="#l348">348</a><td> *     EndsWithMatcher.<tr><td><a id="l349"></a><a href="#l349">349</a><td> */<tr><td><a id="l350"></a><a href="#l350">350</a><td>function endsWith(value) {<tr><td><a id="l351"></a><a href="#l351">351</a><td>  return new goog.labs.testing.EndsWithMatcher(value);<tr><td><a id="l352"></a><a href="#l352">352</a><td>}<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td><tr><td><a id="l355"></a><a href="#l355">355</a><td>/**<tr><td><a id="l356"></a><a href="#l356">356</a><td> * Matches a string that equals (ignoring whitespace) the given string.<tr><td><a id="l357"></a><a href="#l357">357</a><td> *<tr><td><a id="l358"></a><a href="#l358">358</a><td> * @param {string} value The expected value.<tr><td><a id="l359"></a><a href="#l359">359</a><td> *<tr><td><a id="l360"></a><a href="#l360">360</a><td> * @return {!goog.labs.testing.EqualToIgnoringWhitespaceMatcher} A<tr><td><a id="l361"></a><a href="#l361">361</a><td> *     EqualToIgnoringWhitespaceMatcher.<tr><td><a id="l362"></a><a href="#l362">362</a><td> */<tr><td><a id="l363"></a><a href="#l363">363</a><td>function equalToIgnoringWhitespace(value) {<tr><td><a id="l364"></a><a href="#l364">364</a><td>  return new goog.labs.testing.EqualToIgnoringWhitespaceMatcher(value);<tr><td><a id="l365"></a><a href="#l365">365</a><td>}<tr><td><a id="l366"></a><a href="#l366">366</a><td><tr><td><a id="l367"></a><a href="#l367">367</a><td><tr><td><a id="l368"></a><a href="#l368">368</a><td>/**<tr><td><a id="l369"></a><a href="#l369">369</a><td> * Matches a string that equals the given string.<tr><td><a id="l370"></a><a href="#l370">370</a><td> *<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @param {string} value The expected value.<tr><td><a id="l372"></a><a href="#l372">372</a><td> *<tr><td><a id="l373"></a><a href="#l373">373</a><td> * @return {!goog.labs.testing.EqualsMatcher} A EqualsMatcher.<tr><td><a id="l374"></a><a href="#l374">374</a><td> */<tr><td><a id="l375"></a><a href="#l375">375</a><td>function equals(value) {<tr><td><a id="l376"></a><a href="#l376">376</a><td>  return new goog.labs.testing.EqualsMatcher(value);<tr><td><a id="l377"></a><a href="#l377">377</a><td>}<tr><td><a id="l378"></a><a href="#l378">378</a><td><tr><td><a id="l379"></a><a href="#l379">379</a><td><tr><td><a id="l380"></a><a href="#l380">380</a><td>/**<tr><td><a id="l381"></a><a href="#l381">381</a><td> * Matches a string against a regular expression.<tr><td><a id="l382"></a><a href="#l382">382</a><td> *<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @param {!RegExp} regex The expected regex.<tr><td><a id="l384"></a><a href="#l384">384</a><td> *<tr><td><a id="l385"></a><a href="#l385">385</a><td> * @return {!goog.labs.testing.RegexMatcher} A RegexMatcher.<tr><td><a id="l386"></a><a href="#l386">386</a><td> */<tr><td><a id="l387"></a><a href="#l387">387</a><td>function matchesRegex(regex) {<tr><td><a id="l388"></a><a href="#l388">388</a><td>  return new goog.labs.testing.RegexMatcher(regex);<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> * Matches a string that starts with the given string.<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 {string} value The expected value.<tr><td><a id="l396"></a><a href="#l396">396</a><td> *<tr><td><a id="l397"></a><a href="#l397">397</a><td> * @return {!goog.labs.testing.StartsWithMatcher} A<tr><td><a id="l398"></a><a href="#l398">398</a><td> *     StartsWithMatcher.<tr><td><a id="l399"></a><a href="#l399">399</a><td> */<tr><td><a id="l400"></a><a href="#l400">400</a><td>function startsWith(value) {<tr><td><a id="l401"></a><a href="#l401">401</a><td>  return new goog.labs.testing.StartsWithMatcher(value);<tr><td><a id="l402"></a><a href="#l402">402</a><td>}<tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td><tr><td><a id="l405"></a><a href="#l405">405</a><td>/**<tr><td><a id="l406"></a><a href="#l406">406</a><td> * Matches a string that contains the given strings in order.<tr><td><a id="l407"></a><a href="#l407">407</a><td> *<tr><td><a id="l408"></a><a href="#l408">408</a><td> * @param {Array&lt;string&gt;} values The expected value.<tr><td><a id="l409"></a><a href="#l409">409</a><td> *<tr><td><a id="l410"></a><a href="#l410">410</a><td> * @return {!goog.labs.testing.StringContainsInOrderMatcher} A<tr><td><a id="l411"></a><a href="#l411">411</a><td> *     StringContainsInOrderMatcher.<tr><td><a id="l412"></a><a href="#l412">412</a><td> */<tr><td><a id="l413"></a><a href="#l413">413</a><td>function stringContainsInOrder(values) {<tr><td><a id="l414"></a><a href="#l414">414</a><td>  return new goog.labs.testing.StringContainsInOrderMatcher(values);<tr><td><a id="l415"></a><a href="#l415">415</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/useragent/browser.js.src.html b/docs/source/lib/goog/labs/useragent/browser.js.src.html
new file mode 100644
index 0000000..0766138
--- /dev/null
+++ b/docs/source/lib/goog/labs/useragent/browser.js.src.html
@@ -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>browser.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/labs/useragent/browser.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Closure user agent detection (Browser).<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @see &lt;a href=&quot;http://www.useragentstring.com/&quot;&gt;User agent strings&lt;/a&gt;<tr><td><a id="l18"></a><a href="#l18">18</a><td> * For more information on rendering engine, platform, or device see the other<tr><td><a id="l19"></a><a href="#l19">19</a><td> * sub-namespaces in goog.labs.userAgent, goog.labs.userAgent.platform,<tr><td><a id="l20"></a><a href="#l20">20</a><td> * goog.labs.userAgent.device respectively.)<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * @author martone@google.com (Andy Martone)<tr><td><a id="l23"></a><a href="#l23">23</a><td> */<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.labs.userAgent.browser&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.labs.userAgent.util&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.string&#39;);<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>// TODO(nnaze): Refactor to remove excessive exclusion logic in matching<tr><td><a id="l34"></a><a href="#l34">34</a><td>// functions.<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> * @return {boolean} Whether the user&#39;s browser is Opera.<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.labs.userAgent.browser.matchOpera_ = function() {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Opera&#39;) ||<tr><td><a id="l43"></a><a href="#l43">43</a><td>      goog.labs.userAgent.util.matchUserAgent(&#39;OPR&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>};<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td>/**<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @return {boolean} Whether the user&#39;s browser is IE.<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @private<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.labs.userAgent.browser.matchIE_ = function() {<tr><td><a id="l52"></a><a href="#l52">52</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Trident&#39;) ||<tr><td><a id="l53"></a><a href="#l53">53</a><td>      goog.labs.userAgent.util.matchUserAgent(&#39;MSIE&#39;);<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>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @return {boolean} Whether the user&#39;s browser is Edge.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @private<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>goog.labs.userAgent.browser.matchEdge_ = function() {<tr><td><a id="l62"></a><a href="#l62">62</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Edge&#39;);<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 {boolean} Whether the user&#39;s browser is Firefox.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @private<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>goog.labs.userAgent.browser.matchFirefox_ = function() {<tr><td><a id="l71"></a><a href="#l71">71</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Firefox&#39;);<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><tr><td><a id="l75"></a><a href="#l75">75</a><td>/**<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {boolean} Whether the user&#39;s browser is Safari.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @private<tr><td><a id="l78"></a><a href="#l78">78</a><td> */<tr><td><a id="l79"></a><a href="#l79">79</a><td>goog.labs.userAgent.browser.matchSafari_ = function() {<tr><td><a id="l80"></a><a href="#l80">80</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Safari&#39;) &amp;&amp;<tr><td><a id="l81"></a><a href="#l81">81</a><td>      !(goog.labs.userAgent.browser.matchChrome_() ||<tr><td><a id="l82"></a><a href="#l82">82</a><td>        goog.labs.userAgent.browser.matchCoast_() ||<tr><td><a id="l83"></a><a href="#l83">83</a><td>        goog.labs.userAgent.browser.matchOpera_() ||<tr><td><a id="l84"></a><a href="#l84">84</a><td>        goog.labs.userAgent.browser.matchEdge_() ||<tr><td><a id="l85"></a><a href="#l85">85</a><td>        goog.labs.userAgent.browser.isSilk() ||<tr><td><a id="l86"></a><a href="#l86">86</a><td>        goog.labs.userAgent.util.matchUserAgent(&#39;Android&#39;));<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> * @return {boolean} Whether the user&#39;s browser is Coast (Opera&#39;s Webkit-based<tr><td><a id="l92"></a><a href="#l92">92</a><td> *     iOS browser).<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @private<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.labs.userAgent.browser.matchCoast_ = function() {<tr><td><a id="l96"></a><a href="#l96">96</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Coast&#39;);<tr><td><a id="l97"></a><a href="#l97">97</a><td>};<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @return {boolean} Whether the user&#39;s browser is iOS Webview.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @private<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.labs.userAgent.browser.matchIosWebview_ = function() {<tr><td><a id="l105"></a><a href="#l105">105</a><td>  // iOS Webview does not show up as Chrome or Safari. Also check for Opera&#39;s<tr><td><a id="l106"></a><a href="#l106">106</a><td>  // WebKit-based iOS browser, Coast.<tr><td><a id="l107"></a><a href="#l107">107</a><td>  return (goog.labs.userAgent.util.matchUserAgent(&#39;iPad&#39;) ||<tr><td><a id="l108"></a><a href="#l108">108</a><td>          goog.labs.userAgent.util.matchUserAgent(&#39;iPhone&#39;)) &amp;&amp;<tr><td><a id="l109"></a><a href="#l109">109</a><td>      !goog.labs.userAgent.browser.matchSafari_() &amp;&amp;<tr><td><a id="l110"></a><a href="#l110">110</a><td>      !goog.labs.userAgent.browser.matchChrome_() &amp;&amp;<tr><td><a id="l111"></a><a href="#l111">111</a><td>      !goog.labs.userAgent.browser.matchCoast_() &amp;&amp;<tr><td><a id="l112"></a><a href="#l112">112</a><td>      goog.labs.userAgent.util.matchUserAgent(&#39;AppleWebKit&#39;);<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><tr><td><a id="l116"></a><a href="#l116">116</a><td>/**<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @return {boolean} Whether the user&#39;s browser is Chrome.<tr><td><a id="l118"></a><a href="#l118">118</a><td> * @private<tr><td><a id="l119"></a><a href="#l119">119</a><td> */<tr><td><a id="l120"></a><a href="#l120">120</a><td>goog.labs.userAgent.browser.matchChrome_ = function() {<tr><td><a id="l121"></a><a href="#l121">121</a><td>  return (goog.labs.userAgent.util.matchUserAgent(&#39;Chrome&#39;) ||<tr><td><a id="l122"></a><a href="#l122">122</a><td>      goog.labs.userAgent.util.matchUserAgent(&#39;CriOS&#39;)) &amp;&amp;<tr><td><a id="l123"></a><a href="#l123">123</a><td>      !goog.labs.userAgent.browser.matchOpera_() &amp;&amp;<tr><td><a id="l124"></a><a href="#l124">124</a><td>      !goog.labs.userAgent.browser.matchEdge_();<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>/**<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @return {boolean} Whether the user&#39;s browser is the Android browser.<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.labs.userAgent.browser.matchAndroidBrowser_ = function() {<tr><td><a id="l133"></a><a href="#l133">133</a><td>  // Android can appear in the user agent string for Chrome on Android.<tr><td><a id="l134"></a><a href="#l134">134</a><td>  // This is not the Android standalone browser if it does.<tr><td><a id="l135"></a><a href="#l135">135</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Android&#39;) &amp;&amp;<tr><td><a id="l136"></a><a href="#l136">136</a><td>      !(goog.labs.userAgent.browser.isChrome() ||<tr><td><a id="l137"></a><a href="#l137">137</a><td>        goog.labs.userAgent.browser.isFirefox() ||<tr><td><a id="l138"></a><a href="#l138">138</a><td>        goog.labs.userAgent.browser.isOpera() ||<tr><td><a id="l139"></a><a href="#l139">139</a><td>        goog.labs.userAgent.browser.isSilk());<tr><td><a id="l140"></a><a href="#l140">140</a><td>};<tr><td><a id="l141"></a><a href="#l141">141</a><td><tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>/**<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @return {boolean} Whether the user&#39;s browser is Opera.<tr><td><a id="l145"></a><a href="#l145">145</a><td> */<tr><td><a id="l146"></a><a href="#l146">146</a><td>goog.labs.userAgent.browser.isOpera = goog.labs.userAgent.browser.matchOpera_;<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>/**<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @return {boolean} Whether the user&#39;s browser is IE.<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.labs.userAgent.browser.isIE = goog.labs.userAgent.browser.matchIE_;<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> * @return {boolean} Whether the user&#39;s browser is Edge.<tr><td><a id="l157"></a><a href="#l157">157</a><td> */<tr><td><a id="l158"></a><a href="#l158">158</a><td>goog.labs.userAgent.browser.isEdge = goog.labs.userAgent.browser.matchEdge_;<tr><td><a id="l159"></a><a href="#l159">159</a><td><tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td>/**<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @return {boolean} Whether the user&#39;s browser is Firefox.<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.labs.userAgent.browser.isFirefox =<tr><td><a id="l165"></a><a href="#l165">165</a><td>    goog.labs.userAgent.browser.matchFirefox_;<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>/**<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @return {boolean} Whether the user&#39;s browser is Safari.<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.labs.userAgent.browser.isSafari =<tr><td><a id="l172"></a><a href="#l172">172</a><td>    goog.labs.userAgent.browser.matchSafari_;<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @return {boolean} Whether the user&#39;s browser is Coast (Opera&#39;s Webkit-based<tr><td><a id="l177"></a><a href="#l177">177</a><td> *     iOS browser).<tr><td><a id="l178"></a><a href="#l178">178</a><td> */<tr><td><a id="l179"></a><a href="#l179">179</a><td>goog.labs.userAgent.browser.isCoast =<tr><td><a id="l180"></a><a href="#l180">180</a><td>    goog.labs.userAgent.browser.matchCoast_;<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @return {boolean} Whether the user&#39;s browser is iOS Webview.<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.labs.userAgent.browser.isIosWebview =<tr><td><a id="l187"></a><a href="#l187">187</a><td>    goog.labs.userAgent.browser.matchIosWebview_;<tr><td><a id="l188"></a><a href="#l188">188</a><td><tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td>/**<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @return {boolean} Whether the user&#39;s browser is Chrome.<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>goog.labs.userAgent.browser.isChrome =<tr><td><a id="l194"></a><a href="#l194">194</a><td>    goog.labs.userAgent.browser.matchChrome_;<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/**<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @return {boolean} Whether the user&#39;s browser is the Android browser.<tr><td><a id="l199"></a><a href="#l199">199</a><td> */<tr><td><a id="l200"></a><a href="#l200">200</a><td>goog.labs.userAgent.browser.isAndroidBrowser =<tr><td><a id="l201"></a><a href="#l201">201</a><td>    goog.labs.userAgent.browser.matchAndroidBrowser_;<tr><td><a id="l202"></a><a href="#l202">202</a><td><tr><td><a id="l203"></a><a href="#l203">203</a><td><tr><td><a id="l204"></a><a href="#l204">204</a><td>/**<tr><td><a id="l205"></a><a href="#l205">205</a><td> * For more information, see:<tr><td><a id="l206"></a><a href="#l206">206</a><td> * http://docs.aws.amazon.com/silk/latest/developerguide/user-agent.html<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @return {boolean} Whether the user&#39;s browser is Silk.<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.labs.userAgent.browser.isSilk = function() {<tr><td><a id="l210"></a><a href="#l210">210</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Silk&#39;);<tr><td><a id="l211"></a><a href="#l211">211</a><td>};<tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td>/**<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @return {string} The browser version or empty string if version cannot be<tr><td><a id="l216"></a><a href="#l216">216</a><td> *     determined. Note that for Internet Explorer, this returns the version of<tr><td><a id="l217"></a><a href="#l217">217</a><td> *     the browser, not the version of the rendering engine. (IE 8 in<tr><td><a id="l218"></a><a href="#l218">218</a><td> *     compatibility mode will return 8.0 rather than 7.0. To determine the<tr><td><a id="l219"></a><a href="#l219">219</a><td> *     rendering engine version, look at document.documentMode instead. See<tr><td><a id="l220"></a><a href="#l220">220</a><td> *     http://msdn.microsoft.com/en-us/library/cc196988(v=vs.85).aspx for more<tr><td><a id="l221"></a><a href="#l221">221</a><td> *     details.)<tr><td><a id="l222"></a><a href="#l222">222</a><td> */<tr><td><a id="l223"></a><a href="#l223">223</a><td>goog.labs.userAgent.browser.getVersion = function() {<tr><td><a id="l224"></a><a href="#l224">224</a><td>  var userAgentString = goog.labs.userAgent.util.getUserAgent();<tr><td><a id="l225"></a><a href="#l225">225</a><td>  // Special case IE since IE&#39;s version is inside the parenthesis and<tr><td><a id="l226"></a><a href="#l226">226</a><td>  // without the &#39;/&#39;.<tr><td><a id="l227"></a><a href="#l227">227</a><td>  if (goog.labs.userAgent.browser.isIE()) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>    return goog.labs.userAgent.browser.getIEVersion_(userAgentString);<tr><td><a id="l229"></a><a href="#l229">229</a><td>  }<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>  var versionTuples = goog.labs.userAgent.util.extractVersionTuples(<tr><td><a id="l232"></a><a href="#l232">232</a><td>      userAgentString);<tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>  // Construct a map for easy lookup.<tr><td><a id="l235"></a><a href="#l235">235</a><td>  var versionMap = {};<tr><td><a id="l236"></a><a href="#l236">236</a><td>  goog.array.forEach(versionTuples, function(tuple) {<tr><td><a id="l237"></a><a href="#l237">237</a><td>    // Note that the tuple is of length three, but we only care about the<tr><td><a id="l238"></a><a href="#l238">238</a><td>    // first two.<tr><td><a id="l239"></a><a href="#l239">239</a><td>    var key = tuple[0];<tr><td><a id="l240"></a><a href="#l240">240</a><td>    var value = tuple[1];<tr><td><a id="l241"></a><a href="#l241">241</a><td>    versionMap[key] = value;<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>  var versionMapHasKey = goog.partial(goog.object.containsKey, versionMap);<tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td>  // Gives the value with the first key it finds, otherwise empty string.<tr><td><a id="l247"></a><a href="#l247">247</a><td>  function lookUpValueWithKeys(keys) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>    var key = goog.array.find(keys, versionMapHasKey);<tr><td><a id="l249"></a><a href="#l249">249</a><td>    return versionMap[key] || &#39;&#39;;<tr><td><a id="l250"></a><a href="#l250">250</a><td>  }<tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td>  // Check Opera before Chrome since Opera 15+ has &quot;Chrome&quot; in the string.<tr><td><a id="l253"></a><a href="#l253">253</a><td>  // See<tr><td><a id="l254"></a><a href="#l254">254</a><td>  // http://my.opera.com/ODIN/blog/2013/07/15/opera-user-agent-strings-opera-15-and-beyond<tr><td><a id="l255"></a><a href="#l255">255</a><td>  if (goog.labs.userAgent.browser.isOpera()) {<tr><td><a id="l256"></a><a href="#l256">256</a><td>    // Opera 10 has Version/10.0 but Opera/9.8, so look for &quot;Version&quot; first.<tr><td><a id="l257"></a><a href="#l257">257</a><td>    // Opera uses &#39;OPR&#39; for more recent UAs.<tr><td><a id="l258"></a><a href="#l258">258</a><td>    return lookUpValueWithKeys([&#39;Version&#39;, &#39;Opera&#39;, &#39;OPR&#39;]);<tr><td><a id="l259"></a><a href="#l259">259</a><td>  }<tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td>  // Check Edge before Chrome since it has Chrome in the string.<tr><td><a id="l262"></a><a href="#l262">262</a><td>  if (goog.labs.userAgent.browser.isEdge()) {<tr><td><a id="l263"></a><a href="#l263">263</a><td>    return lookUpValueWithKeys([&#39;Edge&#39;]);<tr><td><a id="l264"></a><a href="#l264">264</a><td>  }<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td>  if (goog.labs.userAgent.browser.isChrome()) {<tr><td><a id="l267"></a><a href="#l267">267</a><td>    return lookUpValueWithKeys([&#39;Chrome&#39;, &#39;CriOS&#39;]);<tr><td><a id="l268"></a><a href="#l268">268</a><td>  }<tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td>  // Usually products browser versions are in the third tuple after &quot;Mozilla&quot;<tr><td><a id="l271"></a><a href="#l271">271</a><td>  // and the engine.<tr><td><a id="l272"></a><a href="#l272">272</a><td>  var tuple = versionTuples[2];<tr><td><a id="l273"></a><a href="#l273">273</a><td>  return tuple &amp;&amp; tuple[1] || &#39;&#39;;<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><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 {string|number} version The version to check.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @return {boolean} Whether the browser version is higher or the same as the<tr><td><a id="l280"></a><a href="#l280">280</a><td> *     given version.<tr><td><a id="l281"></a><a href="#l281">281</a><td> */<tr><td><a id="l282"></a><a href="#l282">282</a><td>goog.labs.userAgent.browser.isVersionOrHigher = function(version) {<tr><td><a id="l283"></a><a href="#l283">283</a><td>  return goog.string.compareVersions(goog.labs.userAgent.browser.getVersion(),<tr><td><a id="l284"></a><a href="#l284">284</a><td>                                     version) &gt;= 0;<tr><td><a id="l285"></a><a href="#l285">285</a><td>};<tr><td><a id="l286"></a><a href="#l286">286</a><td><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> * Determines IE version. More information:<tr><td><a id="l290"></a><a href="#l290">290</a><td> * http://msdn.microsoft.com/en-us/library/ie/bg182625(v=vs.85).aspx#uaString<tr><td><a id="l291"></a><a href="#l291">291</a><td> * http://msdn.microsoft.com/en-us/library/hh869301(v=vs.85).aspx<tr><td><a id="l292"></a><a href="#l292">292</a><td> * http://blogs.msdn.com/b/ie/archive/2010/03/23/introducing-ie9-s-user-agent-string.aspx<tr><td><a id="l293"></a><a href="#l293">293</a><td> * http://blogs.msdn.com/b/ie/archive/2009/01/09/the-internet-explorer-8-user-agent-string-updated-edition.aspx<tr><td><a id="l294"></a><a href="#l294">294</a><td> *<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @param {string} userAgent the User-Agent.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @return {string}<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @private<tr><td><a id="l298"></a><a href="#l298">298</a><td> */<tr><td><a id="l299"></a><a href="#l299">299</a><td>goog.labs.userAgent.browser.getIEVersion_ = function(userAgent) {<tr><td><a id="l300"></a><a href="#l300">300</a><td>  // IE11 may identify itself as MSIE 9.0 or MSIE 10.0 due to an IE 11 upgrade<tr><td><a id="l301"></a><a href="#l301">301</a><td>  // bug. Example UA:<tr><td><a id="l302"></a><a href="#l302">302</a><td>  // Mozilla/5.0 (MSIE 9.0; Windows NT 6.1; WOW64; Trident/7.0; rv:11.0)<tr><td><a id="l303"></a><a href="#l303">303</a><td>  // like Gecko.<tr><td><a id="l304"></a><a href="#l304">304</a><td>  // See http://www.whatismybrowser.com/developers/unknown-user-agent-fragments.<tr><td><a id="l305"></a><a href="#l305">305</a><td>  var rv = /rv: *([\d\.]*)/.exec(userAgent);<tr><td><a id="l306"></a><a href="#l306">306</a><td>  if (rv &amp;&amp; rv[1]) {<tr><td><a id="l307"></a><a href="#l307">307</a><td>    return rv[1];<tr><td><a id="l308"></a><a href="#l308">308</a><td>  }<tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>  var version = &#39;&#39;;<tr><td><a id="l311"></a><a href="#l311">311</a><td>  var msie = /MSIE +([\d\.]+)/.exec(userAgent);<tr><td><a id="l312"></a><a href="#l312">312</a><td>  if (msie &amp;&amp; msie[1]) {<tr><td><a id="l313"></a><a href="#l313">313</a><td>    // IE in compatibility mode usually identifies itself as MSIE 7.0; in this<tr><td><a id="l314"></a><a href="#l314">314</a><td>    // case, use the Trident version to determine the version of IE. For more<tr><td><a id="l315"></a><a href="#l315">315</a><td>    // details, see the links above.<tr><td><a id="l316"></a><a href="#l316">316</a><td>    var tridentVersion = /Trident\/(\d.\d)/.exec(userAgent);<tr><td><a id="l317"></a><a href="#l317">317</a><td>    if (msie[1] == &#39;7.0&#39;) {<tr><td><a id="l318"></a><a href="#l318">318</a><td>      if (tridentVersion &amp;&amp; tridentVersion[1]) {<tr><td><a id="l319"></a><a href="#l319">319</a><td>        switch (tridentVersion[1]) {<tr><td><a id="l320"></a><a href="#l320">320</a><td>          case &#39;4.0&#39;:<tr><td><a id="l321"></a><a href="#l321">321</a><td>            version = &#39;8.0&#39;;<tr><td><a id="l322"></a><a href="#l322">322</a><td>            break;<tr><td><a id="l323"></a><a href="#l323">323</a><td>          case &#39;5.0&#39;:<tr><td><a id="l324"></a><a href="#l324">324</a><td>            version = &#39;9.0&#39;;<tr><td><a id="l325"></a><a href="#l325">325</a><td>            break;<tr><td><a id="l326"></a><a href="#l326">326</a><td>          case &#39;6.0&#39;:<tr><td><a id="l327"></a><a href="#l327">327</a><td>            version = &#39;10.0&#39;;<tr><td><a id="l328"></a><a href="#l328">328</a><td>            break;<tr><td><a id="l329"></a><a href="#l329">329</a><td>          case &#39;7.0&#39;:<tr><td><a id="l330"></a><a href="#l330">330</a><td>            version = &#39;11.0&#39;;<tr><td><a id="l331"></a><a href="#l331">331</a><td>            break;<tr><td><a id="l332"></a><a href="#l332">332</a><td>        }<tr><td><a id="l333"></a><a href="#l333">333</a><td>      } else {<tr><td><a id="l334"></a><a href="#l334">334</a><td>        version = &#39;7.0&#39;;<tr><td><a id="l335"></a><a href="#l335">335</a><td>      }<tr><td><a id="l336"></a><a href="#l336">336</a><td>    } else {<tr><td><a id="l337"></a><a href="#l337">337</a><td>      version = msie[1];<tr><td><a id="l338"></a><a href="#l338">338</a><td>    }<tr><td><a id="l339"></a><a href="#l339">339</a><td>  }<tr><td><a id="l340"></a><a href="#l340">340</a><td>  return version;<tr><td><a id="l341"></a><a href="#l341">341</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/useragent/engine.js.src.html b/docs/source/lib/goog/labs/useragent/engine.js.src.html
new file mode 100644
index 0000000..8b32be2
--- /dev/null
+++ b/docs/source/lib/goog/labs/useragent/engine.js.src.html
@@ -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>engine.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/labs/useragent/engine.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Closure user agent detection.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @see http://en.wikipedia.org/wiki/User_agent<tr><td><a id="l18"></a><a href="#l18">18</a><td> * For more information on browser brand, platform, or device see the other<tr><td><a id="l19"></a><a href="#l19">19</a><td> * sub-namespaces in goog.labs.userAgent (browser, platform, and device).<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<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>goog.provide(&#39;goog.labs.userAgent.engine&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.labs.userAgent.util&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string&#39;);<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> * @return {boolean} Whether the rendering engine is Presto.<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.labs.userAgent.engine.isPresto = function() {<tr><td><a id="l34"></a><a href="#l34">34</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Presto&#39;);<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>/**<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @return {boolean} Whether the rendering engine is Trident.<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.labs.userAgent.engine.isTrident = function() {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  // IE only started including the Trident token in IE8.<tr><td><a id="l43"></a><a href="#l43">43</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Trident&#39;) ||<tr><td><a id="l44"></a><a href="#l44">44</a><td>      goog.labs.userAgent.util.matchUserAgent(&#39;MSIE&#39;);<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> * @return {boolean} Whether the rendering engine is Edge.<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.labs.userAgent.engine.isEdge = function() {<tr><td><a id="l52"></a><a href="#l52">52</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Edge&#39;);<tr><td><a id="l53"></a><a href="#l53">53</a><td>};<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @return {boolean} Whether the rendering engine is WebKit.<tr><td><a id="l58"></a><a href="#l58">58</a><td> */<tr><td><a id="l59"></a><a href="#l59">59</a><td>goog.labs.userAgent.engine.isWebKit = function() {<tr><td><a id="l60"></a><a href="#l60">60</a><td>  return goog.labs.userAgent.util.matchUserAgentIgnoreCase(&#39;WebKit&#39;) &amp;&amp;<tr><td><a id="l61"></a><a href="#l61">61</a><td>      !goog.labs.userAgent.engine.isEdge();<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><tr><td><a id="l65"></a><a href="#l65">65</a><td>/**<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @return {boolean} Whether the rendering engine is Gecko.<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.labs.userAgent.engine.isGecko = function() {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Gecko&#39;) &amp;&amp;<tr><td><a id="l70"></a><a href="#l70">70</a><td>      !goog.labs.userAgent.engine.isWebKit() &amp;&amp;<tr><td><a id="l71"></a><a href="#l71">71</a><td>      !goog.labs.userAgent.engine.isTrident() &amp;&amp;<tr><td><a id="l72"></a><a href="#l72">72</a><td>      !goog.labs.userAgent.engine.isEdge();<tr><td><a id="l73"></a><a href="#l73">73</a><td>};<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @return {string} The rendering engine&#39;s version or empty string if version<tr><td><a id="l78"></a><a href="#l78">78</a><td> *     can&#39;t be determined.<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.labs.userAgent.engine.getVersion = function() {<tr><td><a id="l81"></a><a href="#l81">81</a><td>  var userAgentString = goog.labs.userAgent.util.getUserAgent();<tr><td><a id="l82"></a><a href="#l82">82</a><td>  if (userAgentString) {<tr><td><a id="l83"></a><a href="#l83">83</a><td>    var tuples = goog.labs.userAgent.util.extractVersionTuples(<tr><td><a id="l84"></a><a href="#l84">84</a><td>        userAgentString);<tr><td><a id="l85"></a><a href="#l85">85</a><td><tr><td><a id="l86"></a><a href="#l86">86</a><td>    var engineTuple = goog.labs.userAgent.engine.getEngineTuple_(tuples);<tr><td><a id="l87"></a><a href="#l87">87</a><td>    if (engineTuple) {<tr><td><a id="l88"></a><a href="#l88">88</a><td>      // In Gecko, the version string is either in the browser info or the<tr><td><a id="l89"></a><a href="#l89">89</a><td>      // Firefox version.  See Gecko user agent string reference:<tr><td><a id="l90"></a><a href="#l90">90</a><td>      // http://goo.gl/mULqa<tr><td><a id="l91"></a><a href="#l91">91</a><td>      if (engineTuple[0] == &#39;Gecko&#39;) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>        return goog.labs.userAgent.engine.getVersionForKey_(<tr><td><a id="l93"></a><a href="#l93">93</a><td>            tuples, &#39;Firefox&#39;);<tr><td><a id="l94"></a><a href="#l94">94</a><td>      }<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>      return engineTuple[1];<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>    // MSIE has only one version identifier, and the Trident version is<tr><td><a id="l100"></a><a href="#l100">100</a><td>    // specified in the parenthetical. IE Edge is covered in the engine tuple<tr><td><a id="l101"></a><a href="#l101">101</a><td>    // detection.<tr><td><a id="l102"></a><a href="#l102">102</a><td>    var browserTuple = tuples[0];<tr><td><a id="l103"></a><a href="#l103">103</a><td>    var info;<tr><td><a id="l104"></a><a href="#l104">104</a><td>    if (browserTuple &amp;&amp; (info = browserTuple[2])) {<tr><td><a id="l105"></a><a href="#l105">105</a><td>      var match = /Trident\/([^\s;]+)/.exec(info);<tr><td><a id="l106"></a><a href="#l106">106</a><td>      if (match) {<tr><td><a id="l107"></a><a href="#l107">107</a><td>        return match[1];<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 &#39;&#39;;<tr><td><a id="l112"></a><a href="#l112">112</a><td>};<tr><td><a id="l113"></a><a href="#l113">113</a><td><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> * @param {!Array&lt;!Array&lt;string&gt;&gt;} tuples Extracted version tuples.<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @return {!Array&lt;string&gt;|undefined} The engine tuple or undefined if not<tr><td><a id="l118"></a><a href="#l118">118</a><td> *     found.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @private<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.labs.userAgent.engine.getEngineTuple_ = function(tuples) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>  if (!goog.labs.userAgent.engine.isEdge()) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>    return tuples[1];<tr><td><a id="l124"></a><a href="#l124">124</a><td>  }<tr><td><a id="l125"></a><a href="#l125">125</a><td>  for (var i = 0; i &lt; tuples.length; i++) {<tr><td><a id="l126"></a><a href="#l126">126</a><td>    var tuple = tuples[i];<tr><td><a id="l127"></a><a href="#l127">127</a><td>    if (tuple[0] == &#39;Edge&#39;) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>      return tuple;<tr><td><a id="l129"></a><a href="#l129">129</a><td>    }<tr><td><a id="l130"></a><a href="#l130">130</a><td>  }<tr><td><a id="l131"></a><a href="#l131">131</a><td>};<tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td>/**<tr><td><a id="l135"></a><a href="#l135">135</a><td> * @param {string|number} version The version to check.<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @return {boolean} Whether the rendering engine version is higher or the same<tr><td><a id="l137"></a><a href="#l137">137</a><td> *     as the given version.<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.labs.userAgent.engine.isVersionOrHigher = function(version) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>  return goog.string.compareVersions(goog.labs.userAgent.engine.getVersion(),<tr><td><a id="l141"></a><a href="#l141">141</a><td>                                     version) &gt;= 0;<tr><td><a id="l142"></a><a href="#l142">142</a><td>};<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> * @param {!Array&lt;!Array&lt;string&gt;&gt;} tuples Version tuples.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @param {string} key The key to look for.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @return {string} The version string of the given key, if present.<tr><td><a id="l149"></a><a href="#l149">149</a><td> *     Otherwise, the empty string.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @private<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.labs.userAgent.engine.getVersionForKey_ = function(tuples, key) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>  // TODO(nnaze): Move to util if useful elsewhere.<tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td>  var pair = goog.array.find(tuples, function(pair) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>    return key == pair[0];<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>  return pair &amp;&amp; pair[1] || &#39;&#39;;<tr><td><a id="l160"></a><a href="#l160">160</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/useragent/platform.js.src.html b/docs/source/lib/goog/labs/useragent/platform.js.src.html
new file mode 100644
index 0000000..f141003
--- /dev/null
+++ b/docs/source/lib/goog/labs/useragent/platform.js.src.html
@@ -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>platform.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/labs/useragent/platform.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Closure user agent platform detection.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @see &lt;a href=&quot;http://www.useragentstring.com/&quot;&gt;User agent strings&lt;/a&gt;<tr><td><a id="l18"></a><a href="#l18">18</a><td> * For more information on browser brand, rendering engine, or device see the<tr><td><a id="l19"></a><a href="#l19">19</a><td> * other sub-namespaces in goog.labs.userAgent (browser, engine, and device<tr><td><a id="l20"></a><a href="#l20">20</a><td> * respectively).<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.labs.userAgent.platform&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.labs.userAgent.util&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string&#39;);<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> * @return {boolean} Whether the platform is Android.<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.labs.userAgent.platform.isAndroid = function() {<tr><td><a id="l34"></a><a href="#l34">34</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Android&#39;);<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>/**<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @return {boolean} Whether the platform is iPod.<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.labs.userAgent.platform.isIpod = function() {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;iPod&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>};<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @return {boolean} Whether the platform is iPhone.<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.labs.userAgent.platform.isIphone = function() {<tr><td><a id="l50"></a><a href="#l50">50</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;iPhone&#39;) &amp;&amp;<tr><td><a id="l51"></a><a href="#l51">51</a><td>      !goog.labs.userAgent.util.matchUserAgent(&#39;iPod&#39;) &amp;&amp;<tr><td><a id="l52"></a><a href="#l52">52</a><td>      !goog.labs.userAgent.util.matchUserAgent(&#39;iPad&#39;);<tr><td><a id="l53"></a><a href="#l53">53</a><td>};<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @return {boolean} Whether the platform is iPad.<tr><td><a id="l58"></a><a href="#l58">58</a><td> */<tr><td><a id="l59"></a><a href="#l59">59</a><td>goog.labs.userAgent.platform.isIpad = function() {<tr><td><a id="l60"></a><a href="#l60">60</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;iPad&#39;);<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>/**<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @return {boolean} Whether the platform is iOS.<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.labs.userAgent.platform.isIos = function() {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  return goog.labs.userAgent.platform.isIphone() ||<tr><td><a id="l69"></a><a href="#l69">69</a><td>      goog.labs.userAgent.platform.isIpad() ||<tr><td><a id="l70"></a><a href="#l70">70</a><td>      goog.labs.userAgent.platform.isIpod();<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>/**<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @return {boolean} Whether the platform is Mac.<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.labs.userAgent.platform.isMacintosh = function() {<tr><td><a id="l78"></a><a href="#l78">78</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Macintosh&#39;);<tr><td><a id="l79"></a><a href="#l79">79</a><td>};<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Note: ChromeOS is not considered to be Linux as it does not report itself<tr><td><a id="l84"></a><a href="#l84">84</a><td> * as Linux in the user agent string.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @return {boolean} Whether the platform is Linux.<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.labs.userAgent.platform.isLinux = function() {<tr><td><a id="l88"></a><a href="#l88">88</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Linux&#39;);<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>/**<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @return {boolean} Whether the platform is Windows.<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.labs.userAgent.platform.isWindows = function() {<tr><td><a id="l96"></a><a href="#l96">96</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;Windows&#39;);<tr><td><a id="l97"></a><a href="#l97">97</a><td>};<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @return {boolean} Whether the platform is ChromeOS.<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td>goog.labs.userAgent.platform.isChromeOS = function() {<tr><td><a id="l104"></a><a href="#l104">104</a><td>  return goog.labs.userAgent.util.matchUserAgent(&#39;CrOS&#39;);<tr><td><a id="l105"></a><a href="#l105">105</a><td>};<tr><td><a id="l106"></a><a href="#l106">106</a><td><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> * The version of the platform. We only determine the version for Windows,<tr><td><a id="l110"></a><a href="#l110">110</a><td> * Mac, and Chrome OS. It doesn&#39;t make much sense on Linux. For Windows, we only<tr><td><a id="l111"></a><a href="#l111">111</a><td> * look at the NT version. Non-NT-based versions (e.g. 95, 98, etc.) are given<tr><td><a id="l112"></a><a href="#l112">112</a><td> * version 0.0.<tr><td><a id="l113"></a><a href="#l113">113</a><td> *<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @return {string} The platform version or empty string if version cannot be<tr><td><a id="l115"></a><a href="#l115">115</a><td> *     determined.<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.labs.userAgent.platform.getVersion = function() {<tr><td><a id="l118"></a><a href="#l118">118</a><td>  var userAgentString = goog.labs.userAgent.util.getUserAgent();<tr><td><a id="l119"></a><a href="#l119">119</a><td>  var version = &#39;&#39;, re;<tr><td><a id="l120"></a><a href="#l120">120</a><td>  if (goog.labs.userAgent.platform.isWindows()) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>    re = /Windows (?:NT|Phone) ([0-9.]+)/;<tr><td><a id="l122"></a><a href="#l122">122</a><td>    var match = re.exec(userAgentString);<tr><td><a id="l123"></a><a href="#l123">123</a><td>    if (match) {<tr><td><a id="l124"></a><a href="#l124">124</a><td>      version = match[1];<tr><td><a id="l125"></a><a href="#l125">125</a><td>    } else {<tr><td><a id="l126"></a><a href="#l126">126</a><td>      version = &#39;0.0&#39;;<tr><td><a id="l127"></a><a href="#l127">127</a><td>    }<tr><td><a id="l128"></a><a href="#l128">128</a><td>  } else if (goog.labs.userAgent.platform.isIos()) {<tr><td><a id="l129"></a><a href="#l129">129</a><td>    re = /(?:iPhone|iPod|iPad|CPU)\s+OS\s+(\S+)/;<tr><td><a id="l130"></a><a href="#l130">130</a><td>    var match = re.exec(userAgentString);<tr><td><a id="l131"></a><a href="#l131">131</a><td>    // Report the version as x.y.z and not x_y_z<tr><td><a id="l132"></a><a href="#l132">132</a><td>    version = match &amp;&amp; match[1].replace(/_/g, &#39;.&#39;);<tr><td><a id="l133"></a><a href="#l133">133</a><td>  } else if (goog.labs.userAgent.platform.isMacintosh()) {<tr><td><a id="l134"></a><a href="#l134">134</a><td>    re = /Mac OS X ([0-9_.]+)/;<tr><td><a id="l135"></a><a href="#l135">135</a><td>    var match = re.exec(userAgentString);<tr><td><a id="l136"></a><a href="#l136">136</a><td>    // Note: some old versions of Camino do not report an OSX version.<tr><td><a id="l137"></a><a href="#l137">137</a><td>    // Default to 10.<tr><td><a id="l138"></a><a href="#l138">138</a><td>    version = match ? match[1].replace(/_/g, &#39;.&#39;) : &#39;10&#39;;<tr><td><a id="l139"></a><a href="#l139">139</a><td>  } else if (goog.labs.userAgent.platform.isAndroid()) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>    re = /Android\s+([^\);]+)(\)|;)/;<tr><td><a id="l141"></a><a href="#l141">141</a><td>    var match = re.exec(userAgentString);<tr><td><a id="l142"></a><a href="#l142">142</a><td>    version = match &amp;&amp; match[1];<tr><td><a id="l143"></a><a href="#l143">143</a><td>  } else if (goog.labs.userAgent.platform.isChromeOS()) {<tr><td><a id="l144"></a><a href="#l144">144</a><td>    re = /(?:CrOS\s+(?:i686|x86_64)\s+([0-9.]+))/;<tr><td><a id="l145"></a><a href="#l145">145</a><td>    var match = re.exec(userAgentString);<tr><td><a id="l146"></a><a href="#l146">146</a><td>    version = match &amp;&amp; match[1];<tr><td><a id="l147"></a><a href="#l147">147</a><td>  }<tr><td><a id="l148"></a><a href="#l148">148</a><td>  return version || &#39;&#39;;<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @param {string|number} version The version to check.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @return {boolean} Whether the browser version is higher or the same as the<tr><td><a id="l155"></a><a href="#l155">155</a><td> *     given version.<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>goog.labs.userAgent.platform.isVersionOrHigher = function(version) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  return goog.string.compareVersions(goog.labs.userAgent.platform.getVersion(),<tr><td><a id="l159"></a><a href="#l159">159</a><td>                                     version) &gt;= 0;<tr><td><a id="l160"></a><a href="#l160">160</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/labs/useragent/util.js.src.html b/docs/source/lib/goog/labs/useragent/util.js.src.html
new file mode 100644
index 0000000..6f4e40e
--- /dev/null
+++ b/docs/source/lib/goog/labs/useragent/util.js.src.html
@@ -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>util.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/labs/useragent/util.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities used by goog.labs.userAgent tools. These functions<tr><td><a id="l17"></a><a href="#l17">17</a><td> * should not be used outside of goog.labs.userAgent.*.<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> * @author nnaze@google.com (Nathan Naze)<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>goog.provide(&#39;goog.labs.userAgent.util&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Gets the native userAgent string from navigator if it exists.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * If navigator or navigator.userAgent string is missing, returns an empty<tr><td><a id="l31"></a><a href="#l31">31</a><td> * string.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @return {string}<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @private<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.labs.userAgent.util.getNativeUserAgentString_ = function() {<tr><td><a id="l36"></a><a href="#l36">36</a><td>  var navigator = goog.labs.userAgent.util.getNavigator_();<tr><td><a id="l37"></a><a href="#l37">37</a><td>  if (navigator) {<tr><td><a id="l38"></a><a href="#l38">38</a><td>    var userAgent = navigator.userAgent;<tr><td><a id="l39"></a><a href="#l39">39</a><td>    if (userAgent) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>      return userAgent;<tr><td><a id="l41"></a><a href="#l41">41</a><td>    }<tr><td><a id="l42"></a><a href="#l42">42</a><td>  }<tr><td><a id="l43"></a><a href="#l43">43</a><td>  return &#39;&#39;;<tr><td><a id="l44"></a><a href="#l44">44</a><td>};<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td>/**<tr><td><a id="l48"></a><a href="#l48">48</a><td> * Getter for the native navigator.<tr><td><a id="l49"></a><a href="#l49">49</a><td> * This is a separate function so it can be stubbed out in testing.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @return {Navigator}<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @private<tr><td><a id="l52"></a><a href="#l52">52</a><td> */<tr><td><a id="l53"></a><a href="#l53">53</a><td>goog.labs.userAgent.util.getNavigator_ = function() {<tr><td><a id="l54"></a><a href="#l54">54</a><td>  return goog.global.navigator;<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><tr><td><a id="l58"></a><a href="#l58">58</a><td>/**<tr><td><a id="l59"></a><a href="#l59">59</a><td> * A possible override for applications which wish to not check<tr><td><a id="l60"></a><a href="#l60">60</a><td> * navigator.userAgent but use a specified value for detection instead.<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @private {string}<tr><td><a id="l62"></a><a href="#l62">62</a><td> */<tr><td><a id="l63"></a><a href="#l63">63</a><td>goog.labs.userAgent.util.userAgent_ =<tr><td><a id="l64"></a><a href="#l64">64</a><td>    goog.labs.userAgent.util.getNativeUserAgentString_();<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> * Applications may override browser detection on the built in<tr><td><a id="l69"></a><a href="#l69">69</a><td> * navigator.userAgent object by setting this string. Set to null to use the<tr><td><a id="l70"></a><a href="#l70">70</a><td> * browser object instead.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @param {?string=} opt_userAgent The User-Agent override.<tr><td><a id="l72"></a><a href="#l72">72</a><td> */<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.labs.userAgent.util.setUserAgent = function(opt_userAgent) {<tr><td><a id="l74"></a><a href="#l74">74</a><td>  goog.labs.userAgent.util.userAgent_ = opt_userAgent ||<tr><td><a id="l75"></a><a href="#l75">75</a><td>      goog.labs.userAgent.util.getNativeUserAgentString_();<tr><td><a id="l76"></a><a href="#l76">76</a><td>};<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td>/**<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @return {string} The user agent string.<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.labs.userAgent.util.getUserAgent = function() {<tr><td><a id="l83"></a><a href="#l83">83</a><td>  return goog.labs.userAgent.util.userAgent_;<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>/**<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {string} str<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @return {boolean} Whether the user agent contains the given string, ignoring<tr><td><a id="l90"></a><a href="#l90">90</a><td> *     case.<tr><td><a id="l91"></a><a href="#l91">91</a><td> */<tr><td><a id="l92"></a><a href="#l92">92</a><td>goog.labs.userAgent.util.matchUserAgent = function(str) {<tr><td><a id="l93"></a><a href="#l93">93</a><td>  var userAgent = goog.labs.userAgent.util.getUserAgent();<tr><td><a id="l94"></a><a href="#l94">94</a><td>  return goog.string.contains(userAgent, str);<tr><td><a id="l95"></a><a href="#l95">95</a><td>};<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>/**<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @param {string} str<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @return {boolean} Whether the user agent contains the given string.<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>goog.labs.userAgent.util.matchUserAgentIgnoreCase = function(str) {<tr><td><a id="l103"></a><a href="#l103">103</a><td>  var userAgent = goog.labs.userAgent.util.getUserAgent();<tr><td><a id="l104"></a><a href="#l104">104</a><td>  return goog.string.caseInsensitiveContains(userAgent, str);<tr><td><a id="l105"></a><a href="#l105">105</a><td>};<tr><td><a id="l106"></a><a href="#l106">106</a><td><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> * Parses the user agent into tuples for each section.<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @param {string} userAgent<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @return {!Array&lt;!Array&lt;string&gt;&gt;} Tuples of key, version, and the contents<tr><td><a id="l112"></a><a href="#l112">112</a><td> *     of the parenthetical.<tr><td><a id="l113"></a><a href="#l113">113</a><td> */<tr><td><a id="l114"></a><a href="#l114">114</a><td>goog.labs.userAgent.util.extractVersionTuples = function(userAgent) {<tr><td><a id="l115"></a><a href="#l115">115</a><td>  // Matches each section of a user agent string.<tr><td><a id="l116"></a><a href="#l116">116</a><td>  // Example UA:<tr><td><a id="l117"></a><a href="#l117">117</a><td>  // Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us)<tr><td><a id="l118"></a><a href="#l118">118</a><td>  // AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405<tr><td><a id="l119"></a><a href="#l119">119</a><td>  // This has three version tuples: Mozilla, AppleWebKit, and Mobile.<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>  var versionRegExp = new RegExp(<tr><td><a id="l122"></a><a href="#l122">122</a><td>      // Key. Note that a key may have a space.<tr><td><a id="l123"></a><a href="#l123">123</a><td>      // (i.e. &#39;Mobile Safari&#39; in &#39;Mobile Safari/5.0&#39;)<tr><td><a id="l124"></a><a href="#l124">124</a><td>      &#39;(\\w[\\w ]+)&#39; +<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td>      &#39;/&#39; +                // slash<tr><td><a id="l127"></a><a href="#l127">127</a><td>      &#39;([^\\s]+)&#39; +        // version (i.e. &#39;5.0b&#39;)<tr><td><a id="l128"></a><a href="#l128">128</a><td>      &#39;\\s*&#39; +             // whitespace<tr><td><a id="l129"></a><a href="#l129">129</a><td>      &#39;(?:\\((.*?)\\))?&#39;,  // parenthetical info. parentheses not matched.<tr><td><a id="l130"></a><a href="#l130">130</a><td>      &#39;g&#39;);<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>  var data = [];<tr><td><a id="l133"></a><a href="#l133">133</a><td>  var match;<tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>  // Iterate and collect the version tuples.  Each iteration will be the<tr><td><a id="l136"></a><a href="#l136">136</a><td>  // next regex match.<tr><td><a id="l137"></a><a href="#l137">137</a><td>  while (match = versionRegExp.exec(userAgent)) {<tr><td><a id="l138"></a><a href="#l138">138</a><td>    data.push([<tr><td><a id="l139"></a><a href="#l139">139</a><td>      match[1],  // key<tr><td><a id="l140"></a><a href="#l140">140</a><td>      match[2],  // value<tr><td><a id="l141"></a><a href="#l141">141</a><td>      // || undefined as this is not undefined in IE7 and IE8<tr><td><a id="l142"></a><a href="#l142">142</a><td>      match[3] || undefined  // info<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>  return data;<tr><td><a id="l147"></a><a href="#l147">147</a><td>};<tr><td><a id="l148"></a><a href="#l148">148</a><td></table></div></article><nav><h3><a href="../../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../../types.js"></script><script src="../../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/log/log.js.src.html b/docs/source/lib/goog/log/log.js.src.html
new file mode 100644
index 0000000..a0bae37
--- /dev/null
+++ b/docs/source/lib/goog/log/log.js.src.html
@@ -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>log.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/log/log.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Basic strippable logging definitions.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @see http://go/closurelogging<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * @author johnlenz@google.com (John Lenz)<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.log&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.log.Level&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.log.LogRecord&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.log.Logger&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.debug&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.debug.LogManager&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.debug.LogRecord&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.debug.Logger&#39;);<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>/** @define {boolean} Whether logging is enabled. */<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.define(&#39;goog.log.ENABLED&#39;, goog.debug.LOGGING_ENABLED);<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>/** @const */<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.log.ROOT_LOGGER_NAME = goog.debug.Logger.ROOT_LOGGER_NAME;<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>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @constructor<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @final<tr><td><a id="l45"></a><a href="#l45">45</a><td> */<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.log.Logger = goog.debug.Logger;<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><tr><td><a id="l50"></a><a href="#l50">50</a><td>/**<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @constructor<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @final<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.log.Level = goog.debug.Logger.Level;<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><tr><td><a id="l58"></a><a href="#l58">58</a><td>/**<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @constructor<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @final<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.log.LogRecord = goog.debug.LogRecord;<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> * Finds or creates a logger for a named subsystem. If a logger has already been<tr><td><a id="l67"></a><a href="#l67">67</a><td> * created with the given name it is returned. Otherwise a new logger is<tr><td><a id="l68"></a><a href="#l68">68</a><td> * created. If a new logger is created its log level will be configured based<tr><td><a id="l69"></a><a href="#l69">69</a><td> * on the goog.debug.LogManager configuration and it will configured to also<tr><td><a id="l70"></a><a href="#l70">70</a><td> * send logging output to its parent&#39;s handlers.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @see goog.debug.LogManager<tr><td><a id="l72"></a><a href="#l72">72</a><td> *<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @param {string} name A name for the logger. This should be a dot-separated<tr><td><a id="l74"></a><a href="#l74">74</a><td> *     name and should normally be based on the package name or class name of<tr><td><a id="l75"></a><a href="#l75">75</a><td> *     the subsystem, such as goog.net.BrowserChannel.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @param {goog.log.Level=} opt_level If provided, override the<tr><td><a id="l77"></a><a href="#l77">77</a><td> *     default logging level with the provided level.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {goog.log.Logger} The named logger or null if logging is disabled.<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.log.getLogger = function(name, opt_level) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>  if (goog.log.ENABLED) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>    var logger = goog.debug.LogManager.getLogger(name);<tr><td><a id="l83"></a><a href="#l83">83</a><td>    if (opt_level &amp;&amp; logger) {<tr><td><a id="l84"></a><a href="#l84">84</a><td>      logger.setLevel(opt_level);<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 logger;<tr><td><a id="l87"></a><a href="#l87">87</a><td>  } else {<tr><td><a id="l88"></a><a href="#l88">88</a><td>    return null;<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><tr><td><a id="l93"></a><a href="#l93">93</a><td>// TODO(johnlenz): try to tighten the types to these functions.<tr><td><a id="l94"></a><a href="#l94">94</a><td>/**<tr><td><a id="l95"></a><a href="#l95">95</a><td> * Adds a handler to the logger. This doesn&#39;t use the event system because<tr><td><a id="l96"></a><a href="#l96">96</a><td> * we want to be able to add logging to the event system.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @param {goog.log.Logger} logger<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @param {Function} handler Handler function to add.<tr><td><a id="l99"></a><a href="#l99">99</a><td> */<tr><td><a id="l100"></a><a href="#l100">100</a><td>goog.log.addHandler = function(logger, handler) {<tr><td><a id="l101"></a><a href="#l101">101</a><td>  if (goog.log.ENABLED &amp;&amp; logger) {<tr><td><a id="l102"></a><a href="#l102">102</a><td>    logger.addHandler(handler);<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><tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td>/**<tr><td><a id="l108"></a><a href="#l108">108</a><td> * Removes a handler from the logger. This doesn&#39;t use the event system because<tr><td><a id="l109"></a><a href="#l109">109</a><td> * we want to be able to add logging to the event system.<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @param {goog.log.Logger} logger<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @param {Function} handler Handler function to remove.<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @return {boolean} Whether the handler was removed.<tr><td><a id="l113"></a><a href="#l113">113</a><td> */<tr><td><a id="l114"></a><a href="#l114">114</a><td>goog.log.removeHandler = function(logger, handler) {<tr><td><a id="l115"></a><a href="#l115">115</a><td>  if (goog.log.ENABLED &amp;&amp; logger) {<tr><td><a id="l116"></a><a href="#l116">116</a><td>    return logger.removeHandler(handler);<tr><td><a id="l117"></a><a href="#l117">117</a><td>  } else {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    return false;<tr><td><a id="l119"></a><a href="#l119">119</a><td>  }<tr><td><a id="l120"></a><a href="#l120">120</a><td>};<tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>/**<tr><td><a id="l124"></a><a href="#l124">124</a><td> * Logs a message. If the logger is currently enabled for the<tr><td><a id="l125"></a><a href="#l125">125</a><td> * given message level then the given message is forwarded to all the<tr><td><a id="l126"></a><a href="#l126">126</a><td> * registered output Handler objects.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @param {goog.log.Logger} logger<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {goog.log.Level} level One of the level identifiers.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {Error|Object=} opt_exception An exception associated with the<tr><td><a id="l131"></a><a href="#l131">131</a><td> *     message.<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>goog.log.log = function(logger, level, msg, opt_exception) {<tr><td><a id="l134"></a><a href="#l134">134</a><td>  if (goog.log.ENABLED &amp;&amp; logger) {<tr><td><a id="l135"></a><a href="#l135">135</a><td>    logger.log(level, msg, opt_exception);<tr><td><a id="l136"></a><a href="#l136">136</a><td>  }<tr><td><a id="l137"></a><a href="#l137">137</a><td>};<tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td>/**<tr><td><a id="l141"></a><a href="#l141">141</a><td> * Logs a message at the Level.SEVERE level.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l143"></a><a href="#l143">143</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @param {goog.log.Logger} logger<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l146"></a><a href="#l146">146</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l147"></a><a href="#l147">147</a><td> */<tr><td><a id="l148"></a><a href="#l148">148</a><td>goog.log.error = function(logger, msg, opt_exception) {<tr><td><a id="l149"></a><a href="#l149">149</a><td>  if (goog.log.ENABLED &amp;&amp; logger) {<tr><td><a id="l150"></a><a href="#l150">150</a><td>    logger.severe(msg, opt_exception);<tr><td><a id="l151"></a><a href="#l151">151</a><td>  }<tr><td><a id="l152"></a><a href="#l152">152</a><td>};<tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td>/**<tr><td><a id="l156"></a><a href="#l156">156</a><td> * Logs a message at the Level.WARNING level.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l158"></a><a href="#l158">158</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @param {goog.log.Logger} logger<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l162"></a><a href="#l162">162</a><td> */<tr><td><a id="l163"></a><a href="#l163">163</a><td>goog.log.warning = function(logger, msg, opt_exception) {<tr><td><a id="l164"></a><a href="#l164">164</a><td>  if (goog.log.ENABLED &amp;&amp; logger) {<tr><td><a id="l165"></a><a href="#l165">165</a><td>    logger.warning(msg, opt_exception);<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><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> * Logs a message at the Level.INFO level.<tr><td><a id="l172"></a><a href="#l172">172</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l173"></a><a href="#l173">173</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @param {goog.log.Logger} logger<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l177"></a><a href="#l177">177</a><td> */<tr><td><a id="l178"></a><a href="#l178">178</a><td>goog.log.info = function(logger, msg, opt_exception) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>  if (goog.log.ENABLED &amp;&amp; logger) {<tr><td><a id="l180"></a><a href="#l180">180</a><td>    logger.info(msg, opt_exception);<tr><td><a id="l181"></a><a href="#l181">181</a><td>  }<tr><td><a id="l182"></a><a href="#l182">182</a><td>};<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>/**<tr><td><a id="l186"></a><a href="#l186">186</a><td> * Logs a message at the Level.Fine level.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * If the logger is currently enabled for the given message level then the<tr><td><a id="l188"></a><a href="#l188">188</a><td> * given message is forwarded to all the registered output Handler objects.<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @param {goog.log.Logger} logger<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @param {goog.debug.Loggable} msg The message to log.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {Error=} opt_exception An exception associated with the message.<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>goog.log.fine = function(logger, msg, opt_exception) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>  if (goog.log.ENABLED &amp;&amp; logger) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>    logger.fine(msg, opt_exception);<tr><td><a id="l196"></a><a href="#l196">196</a><td>  }<tr><td><a id="l197"></a><a href="#l197">197</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/math/box.js.src.html b/docs/source/lib/goog/math/box.js.src.html
new file mode 100644
index 0000000..7d2bd93
--- /dev/null
+++ b/docs/source/lib/goog/math/box.js.src.html
@@ -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>box.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/box.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A utility class for representing a numeric box.<tr><td><a id="l17"></a><a href="#l17">17</a><td> */<tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.math.Box&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.math.Coordinate&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Class for representing a box. A box is specified as a top, right, bottom,<tr><td><a id="l28"></a><a href="#l28">28</a><td> * and left. A box is useful for representing margins and padding.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * This class assumes &#39;screen coordinates&#39;: larger Y coordinates are further<tr><td><a id="l31"></a><a href="#l31">31</a><td> * from the top of the screen.<tr><td><a id="l32"></a><a href="#l32">32</a><td> *<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {number} top Top.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {number} right Right.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {number} bottom Bottom.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @param {number} left Left.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @struct<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> */<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.math.Box = function(top, right, bottom, left) {<tr><td><a id="l41"></a><a href="#l41">41</a><td>  /**<tr><td><a id="l42"></a><a href="#l42">42</a><td>   * Top<tr><td><a id="l43"></a><a href="#l43">43</a><td>   * @type {number}<tr><td><a id="l44"></a><a href="#l44">44</a><td>   */<tr><td><a id="l45"></a><a href="#l45">45</a><td>  this.top = top;<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>   * Right<tr><td><a id="l49"></a><a href="#l49">49</a><td>   * @type {number}<tr><td><a id="l50"></a><a href="#l50">50</a><td>   */<tr><td><a id="l51"></a><a href="#l51">51</a><td>  this.right = right;<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>  /**<tr><td><a id="l54"></a><a href="#l54">54</a><td>   * Bottom<tr><td><a id="l55"></a><a href="#l55">55</a><td>   * @type {number}<tr><td><a id="l56"></a><a href="#l56">56</a><td>   */<tr><td><a id="l57"></a><a href="#l57">57</a><td>  this.bottom = bottom;<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>   * Left<tr><td><a id="l61"></a><a href="#l61">61</a><td>   * @type {number}<tr><td><a id="l62"></a><a href="#l62">62</a><td>   */<tr><td><a id="l63"></a><a href="#l63">63</a><td>  this.left = left;<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> * Creates a Box by bounding a collection of goog.math.Coordinate objects<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @param {...goog.math.Coordinate} var_args Coordinates to be included inside<tr><td><a id="l70"></a><a href="#l70">70</a><td> *     the box.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @return {!goog.math.Box} A Box containing all the specified Coordinates.<tr><td><a id="l72"></a><a href="#l72">72</a><td> */<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.math.Box.boundingBox = function(var_args) {<tr><td><a id="l74"></a><a href="#l74">74</a><td>  var box = new goog.math.Box(arguments[0].y, arguments[0].x,<tr><td><a id="l75"></a><a href="#l75">75</a><td>                              arguments[0].y, arguments[0].x);<tr><td><a id="l76"></a><a href="#l76">76</a><td>  for (var i = 1; i &lt; arguments.length; i++) {<tr><td><a id="l77"></a><a href="#l77">77</a><td>    box.expandToIncludeCoordinate(arguments[i]);<tr><td><a id="l78"></a><a href="#l78">78</a><td>  }<tr><td><a id="l79"></a><a href="#l79">79</a><td>  return box;<tr><td><a id="l80"></a><a href="#l80">80</a><td>};<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>/**<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @return {number} width The width of this Box.<tr><td><a id="l85"></a><a href="#l85">85</a><td> */<tr><td><a id="l86"></a><a href="#l86">86</a><td>goog.math.Box.prototype.getWidth = function() {<tr><td><a id="l87"></a><a href="#l87">87</a><td>  return this.right - this.left;<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>/**<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @return {number} height The height of this Box.<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td>goog.math.Box.prototype.getHeight = function() {<tr><td><a id="l95"></a><a href="#l95">95</a><td>  return this.bottom - this.top;<tr><td><a id="l96"></a><a href="#l96">96</a><td>};<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td>/**<tr><td><a id="l100"></a><a href="#l100">100</a><td> * Creates a copy of the box with the same dimensions.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @return {!goog.math.Box} A clone of this Box.<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td>goog.math.Box.prototype.clone = function() {<tr><td><a id="l104"></a><a href="#l104">104</a><td>  return new goog.math.Box(this.top, this.right, this.bottom, this.left);<tr><td><a id="l105"></a><a href="#l105">105</a><td>};<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>if (goog.DEBUG) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>  /**<tr><td><a id="l110"></a><a href="#l110">110</a><td>   * Returns a nice string representing the box.<tr><td><a id="l111"></a><a href="#l111">111</a><td>   * @return {string} In the form (50t, 73r, 24b, 13l).<tr><td><a id="l112"></a><a href="#l112">112</a><td>   * @override<tr><td><a id="l113"></a><a href="#l113">113</a><td>   */<tr><td><a id="l114"></a><a href="#l114">114</a><td>  goog.math.Box.prototype.toString = function() {<tr><td><a id="l115"></a><a href="#l115">115</a><td>    return &#39;(&#39; + this.top + &#39;t, &#39; + this.right + &#39;r, &#39; + this.bottom + &#39;b, &#39; +<tr><td><a id="l116"></a><a href="#l116">116</a><td>           this.left + &#39;l)&#39;;<tr><td><a id="l117"></a><a href="#l117">117</a><td>  };<tr><td><a id="l118"></a><a href="#l118">118</a><td>}<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>/**<tr><td><a id="l122"></a><a href="#l122">122</a><td> * Returns whether the box contains a coordinate or another box.<tr><td><a id="l123"></a><a href="#l123">123</a><td> *<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {goog.math.Coordinate|goog.math.Box} other A Coordinate or a Box.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @return {boolean} Whether the box contains the coordinate or other box.<tr><td><a id="l126"></a><a href="#l126">126</a><td> */<tr><td><a id="l127"></a><a href="#l127">127</a><td>goog.math.Box.prototype.contains = function(other) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>  return goog.math.Box.contains(this, other);<tr><td><a id="l129"></a><a href="#l129">129</a><td>};<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * Expands box with the given margins.<tr><td><a id="l134"></a><a href="#l134">134</a><td> *<tr><td><a id="l135"></a><a href="#l135">135</a><td> * @param {number|goog.math.Box} top Top margin or box with all margins.<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @param {number=} opt_right Right margin.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @param {number=} opt_bottom Bottom margin.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @param {number=} opt_left Left margin.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @return {!goog.math.Box} A reference to this Box.<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.math.Box.prototype.expand = function(top, opt_right, opt_bottom,<tr><td><a id="l142"></a><a href="#l142">142</a><td>    opt_left) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>  if (goog.isObject(top)) {<tr><td><a id="l144"></a><a href="#l144">144</a><td>    this.top -= top.top;<tr><td><a id="l145"></a><a href="#l145">145</a><td>    this.right += top.right;<tr><td><a id="l146"></a><a href="#l146">146</a><td>    this.bottom += top.bottom;<tr><td><a id="l147"></a><a href="#l147">147</a><td>    this.left -= top.left;<tr><td><a id="l148"></a><a href="#l148">148</a><td>  } else {<tr><td><a id="l149"></a><a href="#l149">149</a><td>    this.top -= top;<tr><td><a id="l150"></a><a href="#l150">150</a><td>    this.right += opt_right;<tr><td><a id="l151"></a><a href="#l151">151</a><td>    this.bottom += opt_bottom;<tr><td><a id="l152"></a><a href="#l152">152</a><td>    this.left -= opt_left;<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>  return this;<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>/**<tr><td><a id="l160"></a><a href="#l160">160</a><td> * Expand this box to include another box.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * NOTE(user): This is used in code that needs to be very fast, please don&#39;t<tr><td><a id="l162"></a><a href="#l162">162</a><td> * add functionality to this function at the expense of speed (variable<tr><td><a id="l163"></a><a href="#l163">163</a><td> * arguments, accepting multiple argument types, etc).<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @param {goog.math.Box} box The box to include in this one.<tr><td><a id="l165"></a><a href="#l165">165</a><td> */<tr><td><a id="l166"></a><a href="#l166">166</a><td>goog.math.Box.prototype.expandToInclude = function(box) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>  this.left = Math.min(this.left, box.left);<tr><td><a id="l168"></a><a href="#l168">168</a><td>  this.top = Math.min(this.top, box.top);<tr><td><a id="l169"></a><a href="#l169">169</a><td>  this.right = Math.max(this.right, box.right);<tr><td><a id="l170"></a><a href="#l170">170</a><td>  this.bottom = Math.max(this.bottom, box.bottom);<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><tr><td><a id="l174"></a><a href="#l174">174</a><td>/**<tr><td><a id="l175"></a><a href="#l175">175</a><td> * Expand this box to include the coordinate.<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @param {!goog.math.Coordinate} coord The coordinate to be included<tr><td><a id="l177"></a><a href="#l177">177</a><td> *     inside the box.<tr><td><a id="l178"></a><a href="#l178">178</a><td> */<tr><td><a id="l179"></a><a href="#l179">179</a><td>goog.math.Box.prototype.expandToIncludeCoordinate = function(coord) {<tr><td><a id="l180"></a><a href="#l180">180</a><td>  this.top = Math.min(this.top, coord.y);<tr><td><a id="l181"></a><a href="#l181">181</a><td>  this.right = Math.max(this.right, coord.x);<tr><td><a id="l182"></a><a href="#l182">182</a><td>  this.bottom = Math.max(this.bottom, coord.y);<tr><td><a id="l183"></a><a href="#l183">183</a><td>  this.left = Math.min(this.left, coord.x);<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> * Compares boxes for equality.<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @param {goog.math.Box} a A Box.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @param {goog.math.Box} b A Box.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @return {boolean} True iff the boxes are equal, or if both are null.<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>goog.math.Box.equals = function(a, b) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>  if (a == b) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>    return true;<tr><td><a id="l196"></a><a href="#l196">196</a><td>  }<tr><td><a id="l197"></a><a href="#l197">197</a><td>  if (!a || !b) {<tr><td><a id="l198"></a><a href="#l198">198</a><td>    return false;<tr><td><a id="l199"></a><a href="#l199">199</a><td>  }<tr><td><a id="l200"></a><a href="#l200">200</a><td>  return a.top == b.top &amp;&amp; a.right == b.right &amp;&amp;<tr><td><a id="l201"></a><a href="#l201">201</a><td>         a.bottom == b.bottom &amp;&amp; a.left == b.left;<tr><td><a id="l202"></a><a href="#l202">202</a><td>};<tr><td><a id="l203"></a><a href="#l203">203</a><td><tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td>/**<tr><td><a id="l206"></a><a href="#l206">206</a><td> * Returns whether a box contains a coordinate or another box.<tr><td><a id="l207"></a><a href="#l207">207</a><td> *<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @param {goog.math.Box} box A Box.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @param {goog.math.Coordinate|goog.math.Box} other A Coordinate or a Box.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @return {boolean} Whether the box contains the coordinate or other box.<tr><td><a id="l211"></a><a href="#l211">211</a><td> */<tr><td><a id="l212"></a><a href="#l212">212</a><td>goog.math.Box.contains = function(box, other) {<tr><td><a id="l213"></a><a href="#l213">213</a><td>  if (!box || !other) {<tr><td><a id="l214"></a><a href="#l214">214</a><td>    return false;<tr><td><a id="l215"></a><a href="#l215">215</a><td>  }<tr><td><a id="l216"></a><a href="#l216">216</a><td><tr><td><a id="l217"></a><a href="#l217">217</a><td>  if (other instanceof goog.math.Box) {<tr><td><a id="l218"></a><a href="#l218">218</a><td>    return other.left &gt;= box.left &amp;&amp; other.right &lt;= box.right &amp;&amp;<tr><td><a id="l219"></a><a href="#l219">219</a><td>        other.top &gt;= box.top &amp;&amp; other.bottom &lt;= box.bottom;<tr><td><a id="l220"></a><a href="#l220">220</a><td>  }<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td>  // other is a Coordinate.<tr><td><a id="l223"></a><a href="#l223">223</a><td>  return other.x &gt;= box.left &amp;&amp; other.x &lt;= box.right &amp;&amp;<tr><td><a id="l224"></a><a href="#l224">224</a><td>         other.y &gt;= box.top &amp;&amp; other.y &lt;= box.bottom;<tr><td><a id="l225"></a><a href="#l225">225</a><td>};<tr><td><a id="l226"></a><a href="#l226">226</a><td><tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td>/**<tr><td><a id="l229"></a><a href="#l229">229</a><td> * Returns the relative x position of a coordinate compared to a box.  Returns<tr><td><a id="l230"></a><a href="#l230">230</a><td> * zero if the coordinate is inside the box.<tr><td><a id="l231"></a><a href="#l231">231</a><td> *<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @param {goog.math.Box} box A Box.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @param {goog.math.Coordinate} coord A Coordinate.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @return {number} The x position of {@code coord} relative to the nearest<tr><td><a id="l235"></a><a href="#l235">235</a><td> *     side of {@code box}, or zero if {@code coord} is inside {@code box}.<tr><td><a id="l236"></a><a href="#l236">236</a><td> */<tr><td><a id="l237"></a><a href="#l237">237</a><td>goog.math.Box.relativePositionX = function(box, coord) {<tr><td><a id="l238"></a><a href="#l238">238</a><td>  if (coord.x &lt; box.left) {<tr><td><a id="l239"></a><a href="#l239">239</a><td>    return coord.x - box.left;<tr><td><a id="l240"></a><a href="#l240">240</a><td>  } else if (coord.x &gt; box.right) {<tr><td><a id="l241"></a><a href="#l241">241</a><td>    return coord.x - box.right;<tr><td><a id="l242"></a><a href="#l242">242</a><td>  }<tr><td><a id="l243"></a><a href="#l243">243</a><td>  return 0;<tr><td><a id="l244"></a><a href="#l244">244</a><td>};<tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>/**<tr><td><a id="l248"></a><a href="#l248">248</a><td> * Returns the relative y position of a coordinate compared to a box.  Returns<tr><td><a id="l249"></a><a href="#l249">249</a><td> * zero if the coordinate is inside the box.<tr><td><a id="l250"></a><a href="#l250">250</a><td> *<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @param {goog.math.Box} box A Box.<tr><td><a id="l252"></a><a href="#l252">252</a><td> * @param {goog.math.Coordinate} coord A Coordinate.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @return {number} The y position of {@code coord} relative to the nearest<tr><td><a id="l254"></a><a href="#l254">254</a><td> *     side of {@code box}, or zero if {@code coord} is inside {@code box}.<tr><td><a id="l255"></a><a href="#l255">255</a><td> */<tr><td><a id="l256"></a><a href="#l256">256</a><td>goog.math.Box.relativePositionY = function(box, coord) {<tr><td><a id="l257"></a><a href="#l257">257</a><td>  if (coord.y &lt; box.top) {<tr><td><a id="l258"></a><a href="#l258">258</a><td>    return coord.y - box.top;<tr><td><a id="l259"></a><a href="#l259">259</a><td>  } else if (coord.y &gt; box.bottom) {<tr><td><a id="l260"></a><a href="#l260">260</a><td>    return coord.y - box.bottom;<tr><td><a id="l261"></a><a href="#l261">261</a><td>  }<tr><td><a id="l262"></a><a href="#l262">262</a><td>  return 0;<tr><td><a id="l263"></a><a href="#l263">263</a><td>};<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td>/**<tr><td><a id="l267"></a><a href="#l267">267</a><td> * Returns the distance between a coordinate and the nearest corner/side of a<tr><td><a id="l268"></a><a href="#l268">268</a><td> * box. Returns zero if the coordinate is inside the box.<tr><td><a id="l269"></a><a href="#l269">269</a><td> *<tr><td><a id="l270"></a><a href="#l270">270</a><td> * @param {goog.math.Box} box A Box.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @param {goog.math.Coordinate} coord A Coordinate.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @return {number} The distance between {@code coord} and the nearest<tr><td><a id="l273"></a><a href="#l273">273</a><td> *     corner/side of {@code box}, or zero if {@code coord} is inside<tr><td><a id="l274"></a><a href="#l274">274</a><td> *     {@code box}.<tr><td><a id="l275"></a><a href="#l275">275</a><td> */<tr><td><a id="l276"></a><a href="#l276">276</a><td>goog.math.Box.distance = function(box, coord) {<tr><td><a id="l277"></a><a href="#l277">277</a><td>  var x = goog.math.Box.relativePositionX(box, coord);<tr><td><a id="l278"></a><a href="#l278">278</a><td>  var y = goog.math.Box.relativePositionY(box, coord);<tr><td><a id="l279"></a><a href="#l279">279</a><td>  return Math.sqrt(x * x + y * y);<tr><td><a id="l280"></a><a href="#l280">280</a><td>};<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td><tr><td><a id="l283"></a><a href="#l283">283</a><td>/**<tr><td><a id="l284"></a><a href="#l284">284</a><td> * Returns whether two boxes intersect.<tr><td><a id="l285"></a><a href="#l285">285</a><td> *<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @param {goog.math.Box} a A Box.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @param {goog.math.Box} b A second Box.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @return {boolean} Whether the boxes intersect.<tr><td><a id="l289"></a><a href="#l289">289</a><td> */<tr><td><a id="l290"></a><a href="#l290">290</a><td>goog.math.Box.intersects = function(a, b) {<tr><td><a id="l291"></a><a href="#l291">291</a><td>  return (a.left &lt;= b.right &amp;&amp; b.left &lt;= a.right &amp;&amp;<tr><td><a id="l292"></a><a href="#l292">292</a><td>          a.top &lt;= b.bottom &amp;&amp; b.top &lt;= a.bottom);<tr><td><a id="l293"></a><a href="#l293">293</a><td>};<tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td><tr><td><a id="l296"></a><a href="#l296">296</a><td>/**<tr><td><a id="l297"></a><a href="#l297">297</a><td> * Returns whether two boxes would intersect with additional padding.<tr><td><a id="l298"></a><a href="#l298">298</a><td> *<tr><td><a id="l299"></a><a href="#l299">299</a><td> * @param {goog.math.Box} a A Box.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @param {goog.math.Box} b A second Box.<tr><td><a id="l301"></a><a href="#l301">301</a><td> * @param {number} padding The additional padding.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @return {boolean} Whether the boxes intersect.<tr><td><a id="l303"></a><a href="#l303">303</a><td> */<tr><td><a id="l304"></a><a href="#l304">304</a><td>goog.math.Box.intersectsWithPadding = function(a, b, padding) {<tr><td><a id="l305"></a><a href="#l305">305</a><td>  return (a.left &lt;= b.right + padding &amp;&amp; b.left &lt;= a.right + padding &amp;&amp;<tr><td><a id="l306"></a><a href="#l306">306</a><td>          a.top &lt;= b.bottom + padding &amp;&amp; b.top &lt;= a.bottom + padding);<tr><td><a id="l307"></a><a href="#l307">307</a><td>};<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>/**<tr><td><a id="l311"></a><a href="#l311">311</a><td> * Rounds the fields to the next larger integer values.<tr><td><a id="l312"></a><a href="#l312">312</a><td> *<tr><td><a id="l313"></a><a href="#l313">313</a><td> * @return {!goog.math.Box} This box with ceil&#39;d fields.<tr><td><a id="l314"></a><a href="#l314">314</a><td> */<tr><td><a id="l315"></a><a href="#l315">315</a><td>goog.math.Box.prototype.ceil = function() {<tr><td><a id="l316"></a><a href="#l316">316</a><td>  this.top = Math.ceil(this.top);<tr><td><a id="l317"></a><a href="#l317">317</a><td>  this.right = Math.ceil(this.right);<tr><td><a id="l318"></a><a href="#l318">318</a><td>  this.bottom = Math.ceil(this.bottom);<tr><td><a id="l319"></a><a href="#l319">319</a><td>  this.left = Math.ceil(this.left);<tr><td><a id="l320"></a><a href="#l320">320</a><td>  return this;<tr><td><a id="l321"></a><a href="#l321">321</a><td>};<tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td>/**<tr><td><a id="l325"></a><a href="#l325">325</a><td> * Rounds the fields to the next smaller integer values.<tr><td><a id="l326"></a><a href="#l326">326</a><td> *<tr><td><a id="l327"></a><a href="#l327">327</a><td> * @return {!goog.math.Box} This box with floored fields.<tr><td><a id="l328"></a><a href="#l328">328</a><td> */<tr><td><a id="l329"></a><a href="#l329">329</a><td>goog.math.Box.prototype.floor = function() {<tr><td><a id="l330"></a><a href="#l330">330</a><td>  this.top = Math.floor(this.top);<tr><td><a id="l331"></a><a href="#l331">331</a><td>  this.right = Math.floor(this.right);<tr><td><a id="l332"></a><a href="#l332">332</a><td>  this.bottom = Math.floor(this.bottom);<tr><td><a id="l333"></a><a href="#l333">333</a><td>  this.left = Math.floor(this.left);<tr><td><a id="l334"></a><a href="#l334">334</a><td>  return this;<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td>/**<tr><td><a id="l339"></a><a href="#l339">339</a><td> * Rounds the fields to nearest integer values.<tr><td><a id="l340"></a><a href="#l340">340</a><td> *<tr><td><a id="l341"></a><a href="#l341">341</a><td> * @return {!goog.math.Box} This box with rounded fields.<tr><td><a id="l342"></a><a href="#l342">342</a><td> */<tr><td><a id="l343"></a><a href="#l343">343</a><td>goog.math.Box.prototype.round = function() {<tr><td><a id="l344"></a><a href="#l344">344</a><td>  this.top = Math.round(this.top);<tr><td><a id="l345"></a><a href="#l345">345</a><td>  this.right = Math.round(this.right);<tr><td><a id="l346"></a><a href="#l346">346</a><td>  this.bottom = Math.round(this.bottom);<tr><td><a id="l347"></a><a href="#l347">347</a><td>  this.left = Math.round(this.left);<tr><td><a id="l348"></a><a href="#l348">348</a><td>  return this;<tr><td><a id="l349"></a><a href="#l349">349</a><td>};<tr><td><a id="l350"></a><a href="#l350">350</a><td><tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td>/**<tr><td><a id="l353"></a><a href="#l353">353</a><td> * Translates this box by the given offsets. If a {@code goog.math.Coordinate}<tr><td><a id="l354"></a><a href="#l354">354</a><td> * is given, then the left and right values are translated by the coordinate&#39;s<tr><td><a id="l355"></a><a href="#l355">355</a><td> * x value and the top and bottom values are translated by the coordinate&#39;s y<tr><td><a id="l356"></a><a href="#l356">356</a><td> * value.  Otherwise, {@code tx} and {@code opt_ty} are used to translate the x<tr><td><a id="l357"></a><a href="#l357">357</a><td> * and y dimension values.<tr><td><a id="l358"></a><a href="#l358">358</a><td> *<tr><td><a id="l359"></a><a href="#l359">359</a><td> * @param {number|goog.math.Coordinate} tx The value to translate the x<tr><td><a id="l360"></a><a href="#l360">360</a><td> *     dimension values by or the the coordinate to translate this box by.<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @param {number=} opt_ty The value to translate y dimension values by.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @return {!goog.math.Box} This box after translating.<tr><td><a id="l363"></a><a href="#l363">363</a><td> */<tr><td><a id="l364"></a><a href="#l364">364</a><td>goog.math.Box.prototype.translate = function(tx, opt_ty) {<tr><td><a id="l365"></a><a href="#l365">365</a><td>  if (tx instanceof goog.math.Coordinate) {<tr><td><a id="l366"></a><a href="#l366">366</a><td>    this.left += tx.x;<tr><td><a id="l367"></a><a href="#l367">367</a><td>    this.right += tx.x;<tr><td><a id="l368"></a><a href="#l368">368</a><td>    this.top += tx.y;<tr><td><a id="l369"></a><a href="#l369">369</a><td>    this.bottom += tx.y;<tr><td><a id="l370"></a><a href="#l370">370</a><td>  } else {<tr><td><a id="l371"></a><a href="#l371">371</a><td>    this.left += tx;<tr><td><a id="l372"></a><a href="#l372">372</a><td>    this.right += tx;<tr><td><a id="l373"></a><a href="#l373">373</a><td>    if (goog.isNumber(opt_ty)) {<tr><td><a id="l374"></a><a href="#l374">374</a><td>      this.top += opt_ty;<tr><td><a id="l375"></a><a href="#l375">375</a><td>      this.bottom += opt_ty;<tr><td><a id="l376"></a><a href="#l376">376</a><td>    }<tr><td><a id="l377"></a><a href="#l377">377</a><td>  }<tr><td><a id="l378"></a><a href="#l378">378</a><td>  return this;<tr><td><a id="l379"></a><a href="#l379">379</a><td>};<tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td><tr><td><a id="l382"></a><a href="#l382">382</a><td>/**<tr><td><a id="l383"></a><a href="#l383">383</a><td> * Scales this coordinate by the given scale factors. The x and y dimension<tr><td><a id="l384"></a><a href="#l384">384</a><td> * values are scaled by {@code sx} and {@code opt_sy} respectively.<tr><td><a id="l385"></a><a href="#l385">385</a><td> * If {@code opt_sy} is not given, then {@code sx} is used for both x and y.<tr><td><a id="l386"></a><a href="#l386">386</a><td> *<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @param {number} sx The scale factor to use for the x dimension.<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @param {number=} opt_sy The scale factor to use for the y dimension.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @return {!goog.math.Box} This box after scaling.<tr><td><a id="l390"></a><a href="#l390">390</a><td> */<tr><td><a id="l391"></a><a href="#l391">391</a><td>goog.math.Box.prototype.scale = function(sx, opt_sy) {<tr><td><a id="l392"></a><a href="#l392">392</a><td>  var sy = goog.isNumber(opt_sy) ? opt_sy : sx;<tr><td><a id="l393"></a><a href="#l393">393</a><td>  this.left *= sx;<tr><td><a id="l394"></a><a href="#l394">394</a><td>  this.right *= sx;<tr><td><a id="l395"></a><a href="#l395">395</a><td>  this.top *= sy;<tr><td><a id="l396"></a><a href="#l396">396</a><td>  this.bottom *= sy;<tr><td><a id="l397"></a><a href="#l397">397</a><td>  return this;<tr><td><a id="l398"></a><a href="#l398">398</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/math/coordinate.js.src.html b/docs/source/lib/goog/math/coordinate.js.src.html
new file mode 100644
index 0000000..3fcf521
--- /dev/null
+++ b/docs/source/lib/goog/math/coordinate.js.src.html
@@ -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>coordinate.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/coordinate.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A utility class for representing two-dimensional positions.<tr><td><a id="l17"></a><a href="#l17">17</a><td> */<tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.math.Coordinate&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.math&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Class for representing coordinates and positions.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @param {number=} opt_x Left, defaults to 0.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {number=} opt_y Top, defaults to 0.<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.Coordinate = function(opt_x, opt_y) {<tr><td><a id="l34"></a><a href="#l34">34</a><td>  /**<tr><td><a id="l35"></a><a href="#l35">35</a><td>   * X-value<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.x = goog.isDef(opt_x) ? opt_x : 0;<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>   * Y-value<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.y = goog.isDef(opt_y) ? opt_y : 0;<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> * Returns a new copy of the coordinate.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @return {!goog.math.Coordinate} A clone of this coordinate.<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.math.Coordinate.prototype.clone = function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td>  return new goog.math.Coordinate(this.x, this.y);<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>if (goog.DEBUG) {<tr><td><a id="l58"></a><a href="#l58">58</a><td>  /**<tr><td><a id="l59"></a><a href="#l59">59</a><td>   * Returns a nice string representing the coordinate.<tr><td><a id="l60"></a><a href="#l60">60</a><td>   * @return {string} In the form (50, 73).<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>   */<tr><td><a id="l63"></a><a href="#l63">63</a><td>  goog.math.Coordinate.prototype.toString = function() {<tr><td><a id="l64"></a><a href="#l64">64</a><td>    return &#39;(&#39; + this.x + &#39;, &#39; + this.y + &#39;)&#39;;<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><tr><td><a id="l69"></a><a href="#l69">69</a><td>/**<tr><td><a id="l70"></a><a href="#l70">70</a><td> * Compares coordinates for equality.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @param {goog.math.Coordinate} a A Coordinate.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @param {goog.math.Coordinate} b A Coordinate.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @return {boolean} True iff the coordinates are equal, or if both are null.<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td>goog.math.Coordinate.equals = function(a, b) {<tr><td><a id="l76"></a><a href="#l76">76</a><td>  if (a == b) {<tr><td><a id="l77"></a><a href="#l77">77</a><td>    return true;<tr><td><a id="l78"></a><a href="#l78">78</a><td>  }<tr><td><a id="l79"></a><a href="#l79">79</a><td>  if (!a || !b) {<tr><td><a id="l80"></a><a href="#l80">80</a><td>    return false;<tr><td><a id="l81"></a><a href="#l81">81</a><td>  }<tr><td><a id="l82"></a><a href="#l82">82</a><td>  return a.x == b.x &amp;&amp; a.y == b.y;<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> * Returns the distance between two coordinates.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {!goog.math.Coordinate} a A Coordinate.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @param {!goog.math.Coordinate} b A Coordinate.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @return {number} The distance between {@code a} and {@code b}.<tr><td><a id="l91"></a><a href="#l91">91</a><td> */<tr><td><a id="l92"></a><a href="#l92">92</a><td>goog.math.Coordinate.distance = function(a, b) {<tr><td><a id="l93"></a><a href="#l93">93</a><td>  var dx = a.x - b.x;<tr><td><a id="l94"></a><a href="#l94">94</a><td>  var dy = a.y - b.y;<tr><td><a id="l95"></a><a href="#l95">95</a><td>  return Math.sqrt(dx * dx + dy * dy);<tr><td><a id="l96"></a><a href="#l96">96</a><td>};<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td>/**<tr><td><a id="l100"></a><a href="#l100">100</a><td> * Returns the magnitude of a coordinate.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {!goog.math.Coordinate} a A Coordinate.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @return {number} The distance between the origin and {@code a}.<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.math.Coordinate.magnitude = function(a) {<tr><td><a id="l105"></a><a href="#l105">105</a><td>  return Math.sqrt(a.x * a.x + a.y * a.y);<tr><td><a id="l106"></a><a href="#l106">106</a><td>};<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> * Returns the angle from the origin to a coordinate.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @param {!goog.math.Coordinate} a A Coordinate.<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @return {number} The angle, in degrees, clockwise from the positive X<tr><td><a id="l113"></a><a href="#l113">113</a><td> *     axis to {@code a}.<tr><td><a id="l114"></a><a href="#l114">114</a><td> */<tr><td><a id="l115"></a><a href="#l115">115</a><td>goog.math.Coordinate.azimuth = function(a) {<tr><td><a id="l116"></a><a href="#l116">116</a><td>  return goog.math.angle(0, 0, a.x, a.y);<tr><td><a id="l117"></a><a href="#l117">117</a><td>};<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>/**<tr><td><a id="l121"></a><a href="#l121">121</a><td> * Returns the squared distance between two coordinates. Squared distances can<tr><td><a id="l122"></a><a href="#l122">122</a><td> * be used for comparisons when the actual value is not required.<tr><td><a id="l123"></a><a href="#l123">123</a><td> *<tr><td><a id="l124"></a><a href="#l124">124</a><td> * Performance note: eliminating the square root is an optimization often used<tr><td><a id="l125"></a><a href="#l125">125</a><td> * in lower-level languages, but the speed difference is not nearly as<tr><td><a id="l126"></a><a href="#l126">126</a><td> * pronounced in JavaScript (only a few percent.)<tr><td><a id="l127"></a><a href="#l127">127</a><td> *<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {!goog.math.Coordinate} a A Coordinate.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {!goog.math.Coordinate} b A Coordinate.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @return {number} The squared distance between {@code a} and {@code b}.<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.math.Coordinate.squaredDistance = function(a, b) {<tr><td><a id="l133"></a><a href="#l133">133</a><td>  var dx = a.x - b.x;<tr><td><a id="l134"></a><a href="#l134">134</a><td>  var dy = a.y - b.y;<tr><td><a id="l135"></a><a href="#l135">135</a><td>  return dx * dx + dy * dy;<tr><td><a id="l136"></a><a href="#l136">136</a><td>};<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * Returns the difference between two coordinates as a new<tr><td><a id="l141"></a><a href="#l141">141</a><td> * goog.math.Coordinate.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {!goog.math.Coordinate} a A Coordinate.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {!goog.math.Coordinate} b A Coordinate.<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @return {!goog.math.Coordinate} A Coordinate representing the difference<tr><td><a id="l145"></a><a href="#l145">145</a><td> *     between {@code a} and {@code b}.<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.math.Coordinate.difference = function(a, b) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  return new goog.math.Coordinate(a.x - b.x, a.y - b.y);<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * Returns the sum of two coordinates as a new goog.math.Coordinate.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {!goog.math.Coordinate} a A Coordinate.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {!goog.math.Coordinate} b A Coordinate.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @return {!goog.math.Coordinate} A Coordinate representing the sum of the two<tr><td><a id="l157"></a><a href="#l157">157</a><td> *     coordinates.<tr><td><a id="l158"></a><a href="#l158">158</a><td> */<tr><td><a id="l159"></a><a href="#l159">159</a><td>goog.math.Coordinate.sum = function(a, b) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>  return new goog.math.Coordinate(a.x + b.x, a.y + b.y);<tr><td><a id="l161"></a><a href="#l161">161</a><td>};<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>/**<tr><td><a id="l165"></a><a href="#l165">165</a><td> * Rounds the x and y fields to the next larger integer values.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @return {!goog.math.Coordinate} This coordinate with ceil&#39;d fields.<tr><td><a id="l167"></a><a href="#l167">167</a><td> */<tr><td><a id="l168"></a><a href="#l168">168</a><td>goog.math.Coordinate.prototype.ceil = function() {<tr><td><a id="l169"></a><a href="#l169">169</a><td>  this.x = Math.ceil(this.x);<tr><td><a id="l170"></a><a href="#l170">170</a><td>  this.y = Math.ceil(this.y);<tr><td><a id="l171"></a><a href="#l171">171</a><td>  return this;<tr><td><a id="l172"></a><a href="#l172">172</a><td>};<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * Rounds the x and y fields to the next smaller integer values.<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @return {!goog.math.Coordinate} This coordinate with floored fields.<tr><td><a id="l178"></a><a href="#l178">178</a><td> */<tr><td><a id="l179"></a><a href="#l179">179</a><td>goog.math.Coordinate.prototype.floor = function() {<tr><td><a id="l180"></a><a href="#l180">180</a><td>  this.x = Math.floor(this.x);<tr><td><a id="l181"></a><a href="#l181">181</a><td>  this.y = Math.floor(this.y);<tr><td><a id="l182"></a><a href="#l182">182</a><td>  return this;<tr><td><a id="l183"></a><a href="#l183">183</a><td>};<tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td>/**<tr><td><a id="l187"></a><a href="#l187">187</a><td> * Rounds the x and y fields to the nearest integer values.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @return {!goog.math.Coordinate} This coordinate with rounded fields.<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>goog.math.Coordinate.prototype.round = function() {<tr><td><a id="l191"></a><a href="#l191">191</a><td>  this.x = Math.round(this.x);<tr><td><a id="l192"></a><a href="#l192">192</a><td>  this.y = Math.round(this.y);<tr><td><a id="l193"></a><a href="#l193">193</a><td>  return this;<tr><td><a id="l194"></a><a href="#l194">194</a><td>};<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/**<tr><td><a id="l198"></a><a href="#l198">198</a><td> * Translates this box by the given offsets. If a {@code goog.math.Coordinate}<tr><td><a id="l199"></a><a href="#l199">199</a><td> * is given, then the x and y values are translated by the coordinate&#39;s x and y.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * Otherwise, x and y are translated by {@code tx} and {@code opt_ty}<tr><td><a id="l201"></a><a href="#l201">201</a><td> * respectively.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @param {number|goog.math.Coordinate} tx The value to translate x by or the<tr><td><a id="l203"></a><a href="#l203">203</a><td> *     the coordinate to translate this coordinate by.<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {number=} opt_ty The value to translate y by.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @return {!goog.math.Coordinate} This coordinate after translating.<tr><td><a id="l206"></a><a href="#l206">206</a><td> */<tr><td><a id="l207"></a><a href="#l207">207</a><td>goog.math.Coordinate.prototype.translate = function(tx, opt_ty) {<tr><td><a id="l208"></a><a href="#l208">208</a><td>  if (tx instanceof goog.math.Coordinate) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>    this.x += tx.x;<tr><td><a id="l210"></a><a href="#l210">210</a><td>    this.y += tx.y;<tr><td><a id="l211"></a><a href="#l211">211</a><td>  } else {<tr><td><a id="l212"></a><a href="#l212">212</a><td>    this.x += tx;<tr><td><a id="l213"></a><a href="#l213">213</a><td>    if (goog.isNumber(opt_ty)) {<tr><td><a id="l214"></a><a href="#l214">214</a><td>      this.y += opt_ty;<tr><td><a id="l215"></a><a href="#l215">215</a><td>    }<tr><td><a id="l216"></a><a href="#l216">216</a><td>  }<tr><td><a id="l217"></a><a href="#l217">217</a><td>  return this;<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><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Scales this coordinate by the given scale factors. The x and y values are<tr><td><a id="l223"></a><a href="#l223">223</a><td> * scaled by {@code sx} and {@code opt_sy} respectively.  If {@code opt_sy}<tr><td><a id="l224"></a><a href="#l224">224</a><td> * is not given, then {@code sx} is used for both x and y.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @param {number} sx The scale factor to use for the x dimension.<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @param {number=} opt_sy The scale factor to use for the y dimension.<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @return {!goog.math.Coordinate} This coordinate after scaling.<tr><td><a id="l228"></a><a href="#l228">228</a><td> */<tr><td><a id="l229"></a><a href="#l229">229</a><td>goog.math.Coordinate.prototype.scale = function(sx, opt_sy) {<tr><td><a id="l230"></a><a href="#l230">230</a><td>  var sy = goog.isNumber(opt_sy) ? opt_sy : sx;<tr><td><a id="l231"></a><a href="#l231">231</a><td>  this.x *= sx;<tr><td><a id="l232"></a><a href="#l232">232</a><td>  this.y *= sy;<tr><td><a id="l233"></a><a href="#l233">233</a><td>  return this;<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><tr><td><a id="l237"></a><a href="#l237">237</a><td>/**<tr><td><a id="l238"></a><a href="#l238">238</a><td> * Rotates this coordinate clockwise about the origin (or, optionally, the given<tr><td><a id="l239"></a><a href="#l239">239</a><td> * center) by the given angle, in radians.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {number} radians The angle by which to rotate this coordinate<tr><td><a id="l241"></a><a href="#l241">241</a><td> *     clockwise about the given center, in radians.<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {!goog.math.Coordinate=} opt_center The center of rotation. Defaults<tr><td><a id="l243"></a><a href="#l243">243</a><td> *     to (0, 0) if not given.<tr><td><a id="l244"></a><a href="#l244">244</a><td> */<tr><td><a id="l245"></a><a href="#l245">245</a><td>goog.math.Coordinate.prototype.rotateRadians = function(radians, opt_center) {<tr><td><a id="l246"></a><a href="#l246">246</a><td>  var center = opt_center || new goog.math.Coordinate(0, 0);<tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td>  var x = this.x;<tr><td><a id="l249"></a><a href="#l249">249</a><td>  var y = this.y;<tr><td><a id="l250"></a><a href="#l250">250</a><td>  var cos = Math.cos(radians);<tr><td><a id="l251"></a><a href="#l251">251</a><td>  var sin = Math.sin(radians);<tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td>  this.x = (x - center.x) * cos - (y - center.y) * sin + center.x;<tr><td><a id="l254"></a><a href="#l254">254</a><td>  this.y = (x - center.x) * sin + (y - center.y) * cos + center.y;<tr><td><a id="l255"></a><a href="#l255">255</a><td>};<tr><td><a id="l256"></a><a href="#l256">256</a><td><tr><td><a id="l257"></a><a href="#l257">257</a><td><tr><td><a id="l258"></a><a href="#l258">258</a><td>/**<tr><td><a id="l259"></a><a href="#l259">259</a><td> * Rotates this coordinate clockwise about the origin (or, optionally, the given<tr><td><a id="l260"></a><a href="#l260">260</a><td> * center) by the given angle, in degrees.<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @param {number} degrees The angle by which to rotate this coordinate<tr><td><a id="l262"></a><a href="#l262">262</a><td> *     clockwise about the given center, in degrees.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @param {!goog.math.Coordinate=} opt_center The center of rotation. Defaults<tr><td><a id="l264"></a><a href="#l264">264</a><td> *     to (0, 0) if not given.<tr><td><a id="l265"></a><a href="#l265">265</a><td> */<tr><td><a id="l266"></a><a href="#l266">266</a><td>goog.math.Coordinate.prototype.rotateDegrees = function(degrees, opt_center) {<tr><td><a id="l267"></a><a href="#l267">267</a><td>  this.rotateRadians(goog.math.toRadians(degrees), opt_center);<tr><td><a id="l268"></a><a href="#l268">268</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/math/math.js.src.html b/docs/source/lib/goog/math/math.js.src.html
new file mode 100644
index 0000000..fa0d7c3
--- /dev/null
+++ b/docs/source/lib/goog/math/math.js.src.html
@@ -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>math.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/math.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Additional mathematical functions.<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>goog.provide(&#39;goog.math&#39;);<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.require(&#39;goog.array&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.asserts&#39;);<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> * Returns a random integer greater than or equal to 0 and less than {@code a}.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {number} a  The upper bound for the random integer (exclusive).<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @return {number} A random integer N such that 0 &lt;= N &lt; a.<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.math.randomInt = function(a) {<tr><td><a id="l31"></a><a href="#l31">31</a><td>  return Math.floor(Math.random() * a);<tr><td><a id="l32"></a><a href="#l32">32</a><td>};<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * Returns a random number greater than or equal to {@code a} and less than<tr><td><a id="l37"></a><a href="#l37">37</a><td> * {@code b}.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @param {number} a  The lower bound for the random number (inclusive).<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @param {number} b  The upper bound for the random number (exclusive).<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @return {number} A random number N such that a &lt;= N &lt; b.<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.math.uniformRandom = function(a, b) {<tr><td><a id="l43"></a><a href="#l43">43</a><td>  return a + Math.random() * (b - a);<tr><td><a id="l44"></a><a href="#l44">44</a><td>};<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td>/**<tr><td><a id="l48"></a><a href="#l48">48</a><td> * Takes a number and clamps it to within the provided bounds.<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @param {number} value The input number.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @param {number} min The minimum value to return.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @param {number} max The maximum value to return.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @return {number} The input number if it is within bounds, or the nearest<tr><td><a id="l53"></a><a href="#l53">53</a><td> *     number within the bounds.<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.clamp = function(value, min, max) {<tr><td><a id="l56"></a><a href="#l56">56</a><td>  return Math.min(Math.max(value, min), max);<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> * The % operator in JavaScript returns the remainder of a / b, but differs from<tr><td><a id="l62"></a><a href="#l62">62</a><td> * some other languages in that the result will have the same sign as the<tr><td><a id="l63"></a><a href="#l63">63</a><td> * dividend. For example, -1 % 8 == -1, whereas in some other languages<tr><td><a id="l64"></a><a href="#l64">64</a><td> * (such as Python) the result would be 7. This function emulates the more<tr><td><a id="l65"></a><a href="#l65">65</a><td> * correct modulo behavior, which is useful for certain applications such as<tr><td><a id="l66"></a><a href="#l66">66</a><td> * calculating an offset index in a circular list.<tr><td><a id="l67"></a><a href="#l67">67</a><td> *<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @param {number} a The dividend.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @param {number} b The divisor.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @return {number} a % b where the result is between 0 and b (either 0 &lt;= x &lt; b<tr><td><a id="l71"></a><a href="#l71">71</a><td> *     or b &lt; x &lt;= 0, depending on the sign of b).<tr><td><a id="l72"></a><a href="#l72">72</a><td> */<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.math.modulo = function(a, b) {<tr><td><a id="l74"></a><a href="#l74">74</a><td>  var r = a % b;<tr><td><a id="l75"></a><a href="#l75">75</a><td>  // If r and b differ in sign, add b to wrap the result to the correct sign.<tr><td><a id="l76"></a><a href="#l76">76</a><td>  return (r * b &lt; 0) ? r + b : r;<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>/**<tr><td><a id="l81"></a><a href="#l81">81</a><td> * Performs linear interpolation between values a and b. Returns the value<tr><td><a id="l82"></a><a href="#l82">82</a><td> * between a and b proportional to x (when x is between 0 and 1. When x is<tr><td><a id="l83"></a><a href="#l83">83</a><td> * outside this range, the return value is a linear extrapolation).<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {number} a A number.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @param {number} b A number.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @param {number} x The proportion between a and b.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @return {number} The interpolated value between a and b.<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.lerp = function(a, b, x) {<tr><td><a id="l90"></a><a href="#l90">90</a><td>  return a + x * (b - a);<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> * Tests whether the two values are equal to each other, within a certain<tr><td><a id="l96"></a><a href="#l96">96</a><td> * tolerance to adjust for floating point errors.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @param {number} a A number.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @param {number} b A number.<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @param {number=} opt_tolerance Optional tolerance range. Defaults<tr><td><a id="l100"></a><a href="#l100">100</a><td> *     to 0.000001. If specified, should be greater than 0.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @return {boolean} Whether {@code a} and {@code b} are nearly equal.<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td>goog.math.nearlyEquals = function(a, b, opt_tolerance) {<tr><td><a id="l104"></a><a href="#l104">104</a><td>  return Math.abs(a - b) &lt;= (opt_tolerance || 0.000001);<tr><td><a id="l105"></a><a href="#l105">105</a><td>};<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>// TODO(user): Rename to normalizeAngle, retaining old name as deprecated<tr><td><a id="l109"></a><a href="#l109">109</a><td>// alias.<tr><td><a id="l110"></a><a href="#l110">110</a><td>/**<tr><td><a id="l111"></a><a href="#l111">111</a><td> * Normalizes an angle to be in range [0-360). Angles outside this range will<tr><td><a id="l112"></a><a href="#l112">112</a><td> * be normalized to be the equivalent angle with that range.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @param {number} angle Angle in degrees.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @return {number} Standardized angle.<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.math.standardAngle = function(angle) {<tr><td><a id="l117"></a><a href="#l117">117</a><td>  return goog.math.modulo(angle, 360);<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>/**<tr><td><a id="l122"></a><a href="#l122">122</a><td> * Normalizes an angle to be in range [0-2*PI). Angles outside this range will<tr><td><a id="l123"></a><a href="#l123">123</a><td> * be normalized to be the equivalent angle with that range.<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {number} angle Angle in radians.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @return {number} Standardized angle.<tr><td><a id="l126"></a><a href="#l126">126</a><td> */<tr><td><a id="l127"></a><a href="#l127">127</a><td>goog.math.standardAngleInRadians = function(angle) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>  return goog.math.modulo(angle, 2 * Math.PI);<tr><td><a id="l129"></a><a href="#l129">129</a><td>};<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * Converts degrees to radians.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @param {number} angleDegrees Angle in degrees.<tr><td><a id="l135"></a><a href="#l135">135</a><td> * @return {number} Angle in radians.<tr><td><a id="l136"></a><a href="#l136">136</a><td> */<tr><td><a id="l137"></a><a href="#l137">137</a><td>goog.math.toRadians = function(angleDegrees) {<tr><td><a id="l138"></a><a href="#l138">138</a><td>  return angleDegrees * Math.PI / 180;<tr><td><a id="l139"></a><a href="#l139">139</a><td>};<tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td><tr><td><a id="l142"></a><a href="#l142">142</a><td>/**<tr><td><a id="l143"></a><a href="#l143">143</a><td> * Converts radians to degrees.<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @param {number} angleRadians Angle in radians.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @return {number} Angle in degrees.<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.math.toDegrees = function(angleRadians) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  return angleRadians * 180 / Math.PI;<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * For a given angle and radius, finds the X portion of the offset.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {number} degrees Angle in degrees (zero points in +X direction).<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {number} radius Radius.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @return {number} The x-distance for the angle and radius.<tr><td><a id="l157"></a><a href="#l157">157</a><td> */<tr><td><a id="l158"></a><a href="#l158">158</a><td>goog.math.angleDx = function(degrees, radius) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>  return radius * Math.cos(goog.math.toRadians(degrees));<tr><td><a id="l160"></a><a href="#l160">160</a><td>};<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>/**<tr><td><a id="l164"></a><a href="#l164">164</a><td> * For a given angle and radius, finds the Y portion of the offset.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {number} degrees Angle in degrees (zero points in +X direction).<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {number} radius Radius.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @return {number} The y-distance for the angle and radius.<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>goog.math.angleDy = function(degrees, radius) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>  return radius * Math.sin(goog.math.toRadians(degrees));<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><tr><td><a id="l174"></a><a href="#l174">174</a><td>/**<tr><td><a id="l175"></a><a href="#l175">175</a><td> * Computes the angle between two points (x1,y1) and (x2,y2).<tr><td><a id="l176"></a><a href="#l176">176</a><td> * Angle zero points in the +X direction, 90 degrees points in the +Y<tr><td><a id="l177"></a><a href="#l177">177</a><td> * direction (down) and from there we grow clockwise towards 360 degrees.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @param {number} x1 x of first point.<tr><td><a id="l179"></a><a href="#l179">179</a><td> * @param {number} y1 y of first point.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {number} x2 x of second point.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {number} y2 y of second point.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @return {number} Standardized angle in degrees of the vector from<tr><td><a id="l183"></a><a href="#l183">183</a><td> *     x1,y1 to x2,y2.<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>goog.math.angle = function(x1, y1, x2, y2) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>  return goog.math.standardAngle(goog.math.toDegrees(Math.atan2(y2 - y1,<tr><td><a id="l187"></a><a href="#l187">187</a><td>                                                                x2 - x1)));<tr><td><a id="l188"></a><a href="#l188">188</a><td>};<tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td>/**<tr><td><a id="l192"></a><a href="#l192">192</a><td> * Computes the difference between startAngle and endAngle (angles in degrees).<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @param {number} startAngle  Start angle in degrees.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @param {number} endAngle  End angle in degrees.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @return {number} The number of degrees that when added to<tr><td><a id="l196"></a><a href="#l196">196</a><td> *     startAngle will result in endAngle. Positive numbers mean that the<tr><td><a id="l197"></a><a href="#l197">197</a><td> *     direction is clockwise. Negative numbers indicate a counter-clockwise<tr><td><a id="l198"></a><a href="#l198">198</a><td> *     direction.<tr><td><a id="l199"></a><a href="#l199">199</a><td> *     The shortest route (clockwise vs counter-clockwise) between the angles<tr><td><a id="l200"></a><a href="#l200">200</a><td> *     is used.<tr><td><a id="l201"></a><a href="#l201">201</a><td> *     When the difference is 180 degrees, the function returns 180 (not -180)<tr><td><a id="l202"></a><a href="#l202">202</a><td> *     angleDifference(30, 40) is 10, and angleDifference(40, 30) is -10.<tr><td><a id="l203"></a><a href="#l203">203</a><td> *     angleDifference(350, 10) is 20, and angleDifference(10, 350) is -20.<tr><td><a id="l204"></a><a href="#l204">204</a><td> */<tr><td><a id="l205"></a><a href="#l205">205</a><td>goog.math.angleDifference = function(startAngle, endAngle) {<tr><td><a id="l206"></a><a href="#l206">206</a><td>  var d = goog.math.standardAngle(endAngle) -<tr><td><a id="l207"></a><a href="#l207">207</a><td>          goog.math.standardAngle(startAngle);<tr><td><a id="l208"></a><a href="#l208">208</a><td>  if (d &gt; 180) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>    d = d - 360;<tr><td><a id="l210"></a><a href="#l210">210</a><td>  } else if (d &lt;= -180) {<tr><td><a id="l211"></a><a href="#l211">211</a><td>    d = 360 + d;<tr><td><a id="l212"></a><a href="#l212">212</a><td>  }<tr><td><a id="l213"></a><a href="#l213">213</a><td>  return d;<tr><td><a id="l214"></a><a href="#l214">214</a><td>};<tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td><tr><td><a id="l217"></a><a href="#l217">217</a><td>/**<tr><td><a id="l218"></a><a href="#l218">218</a><td> * Returns the sign of a number as per the &quot;sign&quot; or &quot;signum&quot; function.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @param {number} x The number to take the sign of.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @return {number} -1 when negative, 1 when positive, 0 when 0. Preserves<tr><td><a id="l221"></a><a href="#l221">221</a><td> *     signed zeros and NaN.<tr><td><a id="l222"></a><a href="#l222">222</a><td> */<tr><td><a id="l223"></a><a href="#l223">223</a><td>goog.math.sign = Math.sign || function(x) {<tr><td><a id="l224"></a><a href="#l224">224</a><td>  if (x &gt; 0) {<tr><td><a id="l225"></a><a href="#l225">225</a><td>    return 1;<tr><td><a id="l226"></a><a href="#l226">226</a><td>  }<tr><td><a id="l227"></a><a href="#l227">227</a><td>  if (x &lt; 0) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>    return -1;<tr><td><a id="l229"></a><a href="#l229">229</a><td>  }<tr><td><a id="l230"></a><a href="#l230">230</a><td>  return x;  // Preserves signed zeros and NaN.<tr><td><a id="l231"></a><a href="#l231">231</a><td>};<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>/**<tr><td><a id="l235"></a><a href="#l235">235</a><td> * JavaScript implementation of Longest Common Subsequence problem.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * http://en.wikipedia.org/wiki/Longest_common_subsequence<tr><td><a id="l237"></a><a href="#l237">237</a><td> *<tr><td><a id="l238"></a><a href="#l238">238</a><td> * Returns the longest possible array that is subarray of both of given arrays.<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 {Array&lt;Object&gt;} array1 First array of objects.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {Array&lt;Object&gt;} array2 Second array of objects.<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {Function=} opt_compareFn Function that acts as a custom comparator<tr><td><a id="l243"></a><a href="#l243">243</a><td> *     for the array ojects. Function should return true if objects are equal,<tr><td><a id="l244"></a><a href="#l244">244</a><td> *     otherwise false.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {Function=} opt_collectorFn Function used to decide what to return<tr><td><a id="l246"></a><a href="#l246">246</a><td> *     as a result subsequence. It accepts 2 arguments: index of common element<tr><td><a id="l247"></a><a href="#l247">247</a><td> *     in the first array and index in the second. The default function returns<tr><td><a id="l248"></a><a href="#l248">248</a><td> *     element from the first array.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @return {!Array&lt;Object&gt;} A list of objects that are common to both arrays<tr><td><a id="l250"></a><a href="#l250">250</a><td> *     such that there is no common subsequence with size greater than the<tr><td><a id="l251"></a><a href="#l251">251</a><td> *     length of the list.<tr><td><a id="l252"></a><a href="#l252">252</a><td> */<tr><td><a id="l253"></a><a href="#l253">253</a><td>goog.math.longestCommonSubsequence = function(<tr><td><a id="l254"></a><a href="#l254">254</a><td>    array1, array2, opt_compareFn, opt_collectorFn) {<tr><td><a id="l255"></a><a href="#l255">255</a><td><tr><td><a id="l256"></a><a href="#l256">256</a><td>  var compare = opt_compareFn || function(a, b) {<tr><td><a id="l257"></a><a href="#l257">257</a><td>    return a == b;<tr><td><a id="l258"></a><a href="#l258">258</a><td>  };<tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td>  var collect = opt_collectorFn || function(i1, i2) {<tr><td><a id="l261"></a><a href="#l261">261</a><td>    return array1[i1];<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>  var length1 = array1.length;<tr><td><a id="l265"></a><a href="#l265">265</a><td>  var length2 = array2.length;<tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>  var arr = [];<tr><td><a id="l268"></a><a href="#l268">268</a><td>  for (var i = 0; i &lt; length1 + 1; i++) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>    arr[i] = [];<tr><td><a id="l270"></a><a href="#l270">270</a><td>    arr[i][0] = 0;<tr><td><a id="l271"></a><a href="#l271">271</a><td>  }<tr><td><a id="l272"></a><a href="#l272">272</a><td><tr><td><a id="l273"></a><a href="#l273">273</a><td>  for (var j = 0; j &lt; length2 + 1; j++) {<tr><td><a id="l274"></a><a href="#l274">274</a><td>    arr[0][j] = 0;<tr><td><a id="l275"></a><a href="#l275">275</a><td>  }<tr><td><a id="l276"></a><a href="#l276">276</a><td><tr><td><a id="l277"></a><a href="#l277">277</a><td>  for (i = 1; i &lt;= length1; i++) {<tr><td><a id="l278"></a><a href="#l278">278</a><td>    for (j = 1; j &lt;= length2; j++) {<tr><td><a id="l279"></a><a href="#l279">279</a><td>      if (compare(array1[i - 1], array2[j - 1])) {<tr><td><a id="l280"></a><a href="#l280">280</a><td>        arr[i][j] = arr[i - 1][j - 1] + 1;<tr><td><a id="l281"></a><a href="#l281">281</a><td>      } else {<tr><td><a id="l282"></a><a href="#l282">282</a><td>        arr[i][j] = Math.max(arr[i - 1][j], arr[i][j - 1]);<tr><td><a id="l283"></a><a href="#l283">283</a><td>      }<tr><td><a id="l284"></a><a href="#l284">284</a><td>    }<tr><td><a id="l285"></a><a href="#l285">285</a><td>  }<tr><td><a id="l286"></a><a href="#l286">286</a><td><tr><td><a id="l287"></a><a href="#l287">287</a><td>  // Backtracking<tr><td><a id="l288"></a><a href="#l288">288</a><td>  var result = [];<tr><td><a id="l289"></a><a href="#l289">289</a><td>  var i = length1, j = length2;<tr><td><a id="l290"></a><a href="#l290">290</a><td>  while (i &gt; 0 &amp;&amp; j &gt; 0) {<tr><td><a id="l291"></a><a href="#l291">291</a><td>    if (compare(array1[i - 1], array2[j - 1])) {<tr><td><a id="l292"></a><a href="#l292">292</a><td>      result.unshift(collect(i - 1, j - 1));<tr><td><a id="l293"></a><a href="#l293">293</a><td>      i--;<tr><td><a id="l294"></a><a href="#l294">294</a><td>      j--;<tr><td><a id="l295"></a><a href="#l295">295</a><td>    } else {<tr><td><a id="l296"></a><a href="#l296">296</a><td>      if (arr[i - 1][j] &gt; arr[i][j - 1]) {<tr><td><a id="l297"></a><a href="#l297">297</a><td>        i--;<tr><td><a id="l298"></a><a href="#l298">298</a><td>      } else {<tr><td><a id="l299"></a><a href="#l299">299</a><td>        j--;<tr><td><a id="l300"></a><a href="#l300">300</a><td>      }<tr><td><a id="l301"></a><a href="#l301">301</a><td>    }<tr><td><a id="l302"></a><a href="#l302">302</a><td>  }<tr><td><a id="l303"></a><a href="#l303">303</a><td><tr><td><a id="l304"></a><a href="#l304">304</a><td>  return result;<tr><td><a id="l305"></a><a href="#l305">305</a><td>};<tr><td><a id="l306"></a><a href="#l306">306</a><td><tr><td><a id="l307"></a><a href="#l307">307</a><td><tr><td><a id="l308"></a><a href="#l308">308</a><td>/**<tr><td><a id="l309"></a><a href="#l309">309</a><td> * Returns the sum of the arguments.<tr><td><a id="l310"></a><a href="#l310">310</a><td> * @param {...number} var_args Numbers to add.<tr><td><a id="l311"></a><a href="#l311">311</a><td> * @return {number} The sum of the arguments (0 if no arguments were provided,<tr><td><a id="l312"></a><a href="#l312">312</a><td> *     {@code NaN} if any of the arguments is not a valid number).<tr><td><a id="l313"></a><a href="#l313">313</a><td> */<tr><td><a id="l314"></a><a href="#l314">314</a><td>goog.math.sum = function(var_args) {<tr><td><a id="l315"></a><a href="#l315">315</a><td>  return /** @type {number} */ (goog.array.reduce(arguments,<tr><td><a id="l316"></a><a href="#l316">316</a><td>      function(sum, value) {<tr><td><a id="l317"></a><a href="#l317">317</a><td>        return sum + value;<tr><td><a id="l318"></a><a href="#l318">318</a><td>      }, 0));<tr><td><a id="l319"></a><a href="#l319">319</a><td>};<tr><td><a id="l320"></a><a href="#l320">320</a><td><tr><td><a id="l321"></a><a href="#l321">321</a><td><tr><td><a id="l322"></a><a href="#l322">322</a><td>/**<tr><td><a id="l323"></a><a href="#l323">323</a><td> * Returns the arithmetic mean of the arguments.<tr><td><a id="l324"></a><a href="#l324">324</a><td> * @param {...number} var_args Numbers to average.<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @return {number} The average of the arguments ({@code NaN} if no arguments<tr><td><a id="l326"></a><a href="#l326">326</a><td> *     were provided or any of the arguments is not a valid number).<tr><td><a id="l327"></a><a href="#l327">327</a><td> */<tr><td><a id="l328"></a><a href="#l328">328</a><td>goog.math.average = function(var_args) {<tr><td><a id="l329"></a><a href="#l329">329</a><td>  return goog.math.sum.apply(null, arguments) / arguments.length;<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> * Returns the unbiased sample variance of the arguments. For a definition,<tr><td><a id="l335"></a><a href="#l335">335</a><td> * see e.g. http://en.wikipedia.org/wiki/Variance<tr><td><a id="l336"></a><a href="#l336">336</a><td> * @param {...number} var_args Number samples to analyze.<tr><td><a id="l337"></a><a href="#l337">337</a><td> * @return {number} The unbiased sample variance of the arguments (0 if fewer<tr><td><a id="l338"></a><a href="#l338">338</a><td> *     than two samples were provided, or {@code NaN} if any of the samples is<tr><td><a id="l339"></a><a href="#l339">339</a><td> *     not a valid number).<tr><td><a id="l340"></a><a href="#l340">340</a><td> */<tr><td><a id="l341"></a><a href="#l341">341</a><td>goog.math.sampleVariance = function(var_args) {<tr><td><a id="l342"></a><a href="#l342">342</a><td>  var sampleSize = arguments.length;<tr><td><a id="l343"></a><a href="#l343">343</a><td>  if (sampleSize &lt; 2) {<tr><td><a id="l344"></a><a href="#l344">344</a><td>    return 0;<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>  var mean = goog.math.average.apply(null, arguments);<tr><td><a id="l348"></a><a href="#l348">348</a><td>  var variance = goog.math.sum.apply(null, goog.array.map(arguments,<tr><td><a id="l349"></a><a href="#l349">349</a><td>      function(val) {<tr><td><a id="l350"></a><a href="#l350">350</a><td>        return Math.pow(val - mean, 2);<tr><td><a id="l351"></a><a href="#l351">351</a><td>      })) / (sampleSize - 1);<tr><td><a id="l352"></a><a href="#l352">352</a><td><tr><td><a id="l353"></a><a href="#l353">353</a><td>  return variance;<tr><td><a id="l354"></a><a href="#l354">354</a><td>};<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> * Returns the sample standard deviation of the arguments.  For a definition of<tr><td><a id="l359"></a><a href="#l359">359</a><td> * sample standard deviation, see e.g.<tr><td><a id="l360"></a><a href="#l360">360</a><td> * http://en.wikipedia.org/wiki/Standard_deviation<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @param {...number} var_args Number samples to analyze.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @return {number} The sample standard deviation of the arguments (0 if fewer<tr><td><a id="l363"></a><a href="#l363">363</a><td> *     than two samples were provided, or {@code NaN} if any of the samples is<tr><td><a id="l364"></a><a href="#l364">364</a><td> *     not a valid number).<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.math.standardDeviation = function(var_args) {<tr><td><a id="l367"></a><a href="#l367">367</a><td>  return Math.sqrt(goog.math.sampleVariance.apply(null, arguments));<tr><td><a id="l368"></a><a href="#l368">368</a><td>};<tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td>/**<tr><td><a id="l372"></a><a href="#l372">372</a><td> * Returns whether the supplied number represents an integer, i.e. that is has<tr><td><a id="l373"></a><a href="#l373">373</a><td> * no fractional component.  No range-checking is performed on the number.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {number} num The number to test.<tr><td><a id="l375"></a><a href="#l375">375</a><td> * @return {boolean} Whether {@code num} is an integer.<tr><td><a id="l376"></a><a href="#l376">376</a><td> */<tr><td><a id="l377"></a><a href="#l377">377</a><td>goog.math.isInt = function(num) {<tr><td><a id="l378"></a><a href="#l378">378</a><td>  return isFinite(num) &amp;&amp; num % 1 == 0;<tr><td><a id="l379"></a><a href="#l379">379</a><td>};<tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td><tr><td><a id="l382"></a><a href="#l382">382</a><td>/**<tr><td><a id="l383"></a><a href="#l383">383</a><td> * Returns whether the supplied number is finite and not NaN.<tr><td><a id="l384"></a><a href="#l384">384</a><td> * @param {number} num The number to test.<tr><td><a id="l385"></a><a href="#l385">385</a><td> * @return {boolean} Whether {@code num} is a finite number.<tr><td><a id="l386"></a><a href="#l386">386</a><td> */<tr><td><a id="l387"></a><a href="#l387">387</a><td>goog.math.isFiniteNumber = function(num) {<tr><td><a id="l388"></a><a href="#l388">388</a><td>  return isFinite(num) &amp;&amp; !isNaN(num);<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> * @param {number} num The number to test.<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @return {boolean} Whether it is negative zero.<tr><td><a id="l395"></a><a href="#l395">395</a><td> */<tr><td><a id="l396"></a><a href="#l396">396</a><td>goog.math.isNegativeZero = function(num) {<tr><td><a id="l397"></a><a href="#l397">397</a><td>  return num == 0 &amp;&amp; 1 / num &lt; 0;<tr><td><a id="l398"></a><a href="#l398">398</a><td>};<tr><td><a id="l399"></a><a href="#l399">399</a><td><tr><td><a id="l400"></a><a href="#l400">400</a><td><tr><td><a id="l401"></a><a href="#l401">401</a><td>/**<tr><td><a id="l402"></a><a href="#l402">402</a><td> * Returns the precise value of floor(log10(num)).<tr><td><a id="l403"></a><a href="#l403">403</a><td> * Simpler implementations didn&#39;t work because of floating point rounding<tr><td><a id="l404"></a><a href="#l404">404</a><td> * errors. For example<tr><td><a id="l405"></a><a href="#l405">405</a><td> * &lt;ul&gt;<tr><td><a id="l406"></a><a href="#l406">406</a><td> * &lt;li&gt;Math.floor(Math.log(num) / Math.LN10) is off by one for num == 1e+3.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * &lt;li&gt;Math.floor(Math.log(num) * Math.LOG10E) is off by one for num == 1e+15.<tr><td><a id="l408"></a><a href="#l408">408</a><td> * &lt;li&gt;Math.floor(Math.log10(num)) is off by one for num == 1e+15 - 1.<tr><td><a id="l409"></a><a href="#l409">409</a><td> * &lt;/ul&gt;<tr><td><a id="l410"></a><a href="#l410">410</a><td> * @param {number} num A floating point number.<tr><td><a id="l411"></a><a href="#l411">411</a><td> * @return {number} Its logarithm to base 10 rounded down to the nearest<tr><td><a id="l412"></a><a href="#l412">412</a><td> *     integer if num &gt; 0. -Infinity if num == 0. NaN if num &lt; 0.<tr><td><a id="l413"></a><a href="#l413">413</a><td> */<tr><td><a id="l414"></a><a href="#l414">414</a><td>goog.math.log10Floor = function(num) {<tr><td><a id="l415"></a><a href="#l415">415</a><td>  if (num &gt; 0) {<tr><td><a id="l416"></a><a href="#l416">416</a><td>    var x = Math.round(Math.log(num) * Math.LOG10E);<tr><td><a id="l417"></a><a href="#l417">417</a><td>    return x - (parseFloat(&#39;1e&#39; + x) &gt; num ? 1 : 0);<tr><td><a id="l418"></a><a href="#l418">418</a><td>  }<tr><td><a id="l419"></a><a href="#l419">419</a><td>  return num == 0 ? -Infinity : NaN;<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> * A tweaked variant of {@code Math.floor} which tolerates if the passed number<tr><td><a id="l425"></a><a href="#l425">425</a><td> * is infinitesimally smaller than the closest integer. It often happens with<tr><td><a id="l426"></a><a href="#l426">426</a><td> * the results of floating point calculations because of the finite precision<tr><td><a id="l427"></a><a href="#l427">427</a><td> * of the intermediate results. For example {@code Math.floor(Math.log(1000) /<tr><td><a id="l428"></a><a href="#l428">428</a><td> * Math.LN10) == 2}, not 3 as one would expect.<tr><td><a id="l429"></a><a href="#l429">429</a><td> * @param {number} num A number.<tr><td><a id="l430"></a><a href="#l430">430</a><td> * @param {number=} opt_epsilon An infinitesimally small positive number, the<tr><td><a id="l431"></a><a href="#l431">431</a><td> *     rounding error to tolerate.<tr><td><a id="l432"></a><a href="#l432">432</a><td> * @return {number} The largest integer less than or equal to {@code num}.<tr><td><a id="l433"></a><a href="#l433">433</a><td> */<tr><td><a id="l434"></a><a href="#l434">434</a><td>goog.math.safeFloor = function(num, opt_epsilon) {<tr><td><a id="l435"></a><a href="#l435">435</a><td>  goog.asserts.assert(!goog.isDef(opt_epsilon) || opt_epsilon &gt; 0);<tr><td><a id="l436"></a><a href="#l436">436</a><td>  return Math.floor(num + (opt_epsilon || 2e-15));<tr><td><a id="l437"></a><a href="#l437">437</a><td>};<tr><td><a id="l438"></a><a href="#l438">438</a><td><tr><td><a id="l439"></a><a href="#l439">439</a><td><tr><td><a id="l440"></a><a href="#l440">440</a><td>/**<tr><td><a id="l441"></a><a href="#l441">441</a><td> * A tweaked variant of {@code Math.ceil}. See {@code goog.math.safeFloor} for<tr><td><a id="l442"></a><a href="#l442">442</a><td> * details.<tr><td><a id="l443"></a><a href="#l443">443</a><td> * @param {number} num A number.<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @param {number=} opt_epsilon An infinitesimally small positive number, the<tr><td><a id="l445"></a><a href="#l445">445</a><td> *     rounding error to tolerate.<tr><td><a id="l446"></a><a href="#l446">446</a><td> * @return {number} The smallest integer greater than or equal to {@code num}.<tr><td><a id="l447"></a><a href="#l447">447</a><td> */<tr><td><a id="l448"></a><a href="#l448">448</a><td>goog.math.safeCeil = function(num, opt_epsilon) {<tr><td><a id="l449"></a><a href="#l449">449</a><td>  goog.asserts.assert(!goog.isDef(opt_epsilon) || opt_epsilon &gt; 0);<tr><td><a id="l450"></a><a href="#l450">450</a><td>  return Math.ceil(num - (opt_epsilon || 2e-15));<tr><td><a id="l451"></a><a href="#l451">451</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/math/rect.js.src.html b/docs/source/lib/goog/math/rect.js.src.html
new file mode 100644
index 0000000..0ee35fb
--- /dev/null
+++ b/docs/source/lib/goog/math/rect.js.src.html
@@ -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>rect.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/rect.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A utility class for representing rectangles.<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>goog.provide(&#39;goog.math.Rect&#39;);<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.require(&#39;goog.math.Box&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.math.Coordinate&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.math.Size&#39;);<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><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * Class for representing rectangular regions.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {number} x Left.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {number} y Top.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @param {number} w Width.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {number} h Height.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @struct<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @constructor<tr><td><a id="l35"></a><a href="#l35">35</a><td> */<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.math.Rect = function(x, y, w, h) {<tr><td><a id="l37"></a><a href="#l37">37</a><td>  /** @type {number} */<tr><td><a id="l38"></a><a href="#l38">38</a><td>  this.left = x;<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>  /** @type {number} */<tr><td><a id="l41"></a><a href="#l41">41</a><td>  this.top = y;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td>  /** @type {number} */<tr><td><a id="l44"></a><a href="#l44">44</a><td>  this.width = w;<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>  /** @type {number} */<tr><td><a id="l47"></a><a href="#l47">47</a><td>  this.height = h;<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>/**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @return {!goog.math.Rect} A new copy of this Rectangle.<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.math.Rect.prototype.clone = function() {<tr><td><a id="l55"></a><a href="#l55">55</a><td>  return new goog.math.Rect(this.left, this.top, this.width, this.height);<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>/**<tr><td><a id="l60"></a><a href="#l60">60</a><td> * Returns a new Box object with the same position and dimensions as this<tr><td><a id="l61"></a><a href="#l61">61</a><td> * rectangle.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @return {!goog.math.Box} A new Box representation of this Rectangle.<tr><td><a id="l63"></a><a href="#l63">63</a><td> */<tr><td><a id="l64"></a><a href="#l64">64</a><td>goog.math.Rect.prototype.toBox = function() {<tr><td><a id="l65"></a><a href="#l65">65</a><td>  var right = this.left + this.width;<tr><td><a id="l66"></a><a href="#l66">66</a><td>  var bottom = this.top + this.height;<tr><td><a id="l67"></a><a href="#l67">67</a><td>  return new goog.math.Box(this.top,<tr><td><a id="l68"></a><a href="#l68">68</a><td>                           right,<tr><td><a id="l69"></a><a href="#l69">69</a><td>                           bottom,<tr><td><a id="l70"></a><a href="#l70">70</a><td>                           this.left);<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>/**<tr><td><a id="l75"></a><a href="#l75">75</a><td> * Creates a new Rect object with the position and size given.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @param {!goog.math.Coordinate} position The top-left coordinate of the Rect<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {!goog.math.Size} size The size of the Rect<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {!goog.math.Rect} A new Rect initialized with the given position and<tr><td><a id="l79"></a><a href="#l79">79</a><td> *     size.<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.math.Rect.createFromPositionAndSize = function(position, size) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>  return new goog.math.Rect(position.x, position.y, size.width, size.height);<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> * Creates a new Rect object with the same position and dimensions as a given<tr><td><a id="l88"></a><a href="#l88">88</a><td> * Box.  Note that this is only the inverse of toBox if left/top are defined.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @param {goog.math.Box} box A box.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @return {!goog.math.Rect} A new Rect initialized with the box&#39;s position<tr><td><a id="l91"></a><a href="#l91">91</a><td> *     and size.<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.math.Rect.createFromBox = function(box) {<tr><td><a id="l94"></a><a href="#l94">94</a><td>  return new goog.math.Rect(box.left, box.top,<tr><td><a id="l95"></a><a href="#l95">95</a><td>      box.right - box.left, box.bottom - box.top);<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>if (goog.DEBUG) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  /**<tr><td><a id="l101"></a><a href="#l101">101</a><td>   * Returns a nice string representing size and dimensions of rectangle.<tr><td><a id="l102"></a><a href="#l102">102</a><td>   * @return {string} In the form (50, 73 - 75w x 25h).<tr><td><a id="l103"></a><a href="#l103">103</a><td>   * @override<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.Rect.prototype.toString = function() {<tr><td><a id="l106"></a><a href="#l106">106</a><td>    return &#39;(&#39; + this.left + &#39;, &#39; + this.top + &#39; - &#39; + this.width + &#39;w x &#39; +<tr><td><a id="l107"></a><a href="#l107">107</a><td>           this.height + &#39;h)&#39;;<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><tr><td><a id="l112"></a><a href="#l112">112</a><td>/**<tr><td><a id="l113"></a><a href="#l113">113</a><td> * Compares rectangles for equality.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @param {goog.math.Rect} a A Rectangle.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {goog.math.Rect} b A Rectangle.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @return {boolean} True iff the rectangles have the same left, top, width,<tr><td><a id="l117"></a><a href="#l117">117</a><td> *     and height, or if both are null.<tr><td><a id="l118"></a><a href="#l118">118</a><td> */<tr><td><a id="l119"></a><a href="#l119">119</a><td>goog.math.Rect.equals = function(a, b) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>  if (a == b) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>    return true;<tr><td><a id="l122"></a><a href="#l122">122</a><td>  }<tr><td><a id="l123"></a><a href="#l123">123</a><td>  if (!a || !b) {<tr><td><a id="l124"></a><a href="#l124">124</a><td>    return false;<tr><td><a id="l125"></a><a href="#l125">125</a><td>  }<tr><td><a id="l126"></a><a href="#l126">126</a><td>  return a.left == b.left &amp;&amp; a.width == b.width &amp;&amp;<tr><td><a id="l127"></a><a href="#l127">127</a><td>         a.top == b.top &amp;&amp; a.height == b.height;<tr><td><a id="l128"></a><a href="#l128">128</a><td>};<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>/**<tr><td><a id="l132"></a><a href="#l132">132</a><td> * Computes the intersection of this rectangle and the rectangle parameter.  If<tr><td><a id="l133"></a><a href="#l133">133</a><td> * there is no intersection, returns false and leaves this rectangle as is.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @param {goog.math.Rect} rect A Rectangle.<tr><td><a id="l135"></a><a href="#l135">135</a><td> * @return {boolean} True iff this rectangle intersects with the parameter.<tr><td><a id="l136"></a><a href="#l136">136</a><td> */<tr><td><a id="l137"></a><a href="#l137">137</a><td>goog.math.Rect.prototype.intersection = function(rect) {<tr><td><a id="l138"></a><a href="#l138">138</a><td>  var x0 = Math.max(this.left, rect.left);<tr><td><a id="l139"></a><a href="#l139">139</a><td>  var x1 = Math.min(this.left + this.width, rect.left + rect.width);<tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td>  if (x0 &lt;= x1) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>    var y0 = Math.max(this.top, rect.top);<tr><td><a id="l143"></a><a href="#l143">143</a><td>    var y1 = Math.min(this.top + this.height, rect.top + rect.height);<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td>    if (y0 &lt;= y1) {<tr><td><a id="l146"></a><a href="#l146">146</a><td>      this.left = x0;<tr><td><a id="l147"></a><a href="#l147">147</a><td>      this.top = y0;<tr><td><a id="l148"></a><a href="#l148">148</a><td>      this.width = x1 - x0;<tr><td><a id="l149"></a><a href="#l149">149</a><td>      this.height = y1 - y0;<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td>      return true;<tr><td><a id="l152"></a><a href="#l152">152</a><td>    }<tr><td><a id="l153"></a><a href="#l153">153</a><td>  }<tr><td><a id="l154"></a><a href="#l154">154</a><td>  return false;<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> * Returns the intersection of two rectangles. Two rectangles intersect if they<tr><td><a id="l160"></a><a href="#l160">160</a><td> * touch at all, for example, two zero width and height rectangles would<tr><td><a id="l161"></a><a href="#l161">161</a><td> * intersect if they had the same top and left.<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @param {goog.math.Rect} a A Rectangle.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @param {goog.math.Rect} b A Rectangle.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @return {goog.math.Rect} A new intersection rect (even if width and height<tr><td><a id="l165"></a><a href="#l165">165</a><td> *     are 0), or null if there is no intersection.<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.math.Rect.intersection = function(a, b) {<tr><td><a id="l168"></a><a href="#l168">168</a><td>  // There is no nice way to do intersection via a clone, because any such<tr><td><a id="l169"></a><a href="#l169">169</a><td>  // clone might be unnecessary if this function returns null.  So, we duplicate<tr><td><a id="l170"></a><a href="#l170">170</a><td>  // code from above.<tr><td><a id="l171"></a><a href="#l171">171</a><td><tr><td><a id="l172"></a><a href="#l172">172</a><td>  var x0 = Math.max(a.left, b.left);<tr><td><a id="l173"></a><a href="#l173">173</a><td>  var x1 = Math.min(a.left + a.width, b.left + b.width);<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>  if (x0 &lt;= x1) {<tr><td><a id="l176"></a><a href="#l176">176</a><td>    var y0 = Math.max(a.top, b.top);<tr><td><a id="l177"></a><a href="#l177">177</a><td>    var y1 = Math.min(a.top + a.height, b.top + b.height);<tr><td><a id="l178"></a><a href="#l178">178</a><td><tr><td><a id="l179"></a><a href="#l179">179</a><td>    if (y0 &lt;= y1) {<tr><td><a id="l180"></a><a href="#l180">180</a><td>      return new goog.math.Rect(x0, y0, x1 - x0, y1 - y0);<tr><td><a id="l181"></a><a href="#l181">181</a><td>    }<tr><td><a id="l182"></a><a href="#l182">182</a><td>  }<tr><td><a id="l183"></a><a href="#l183">183</a><td>  return null;<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> * Returns whether two rectangles intersect. Two rectangles intersect if they<tr><td><a id="l189"></a><a href="#l189">189</a><td> * touch at all, for example, two zero width and height rectangles would<tr><td><a id="l190"></a><a href="#l190">190</a><td> * intersect if they had the same top and left.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {goog.math.Rect} a A Rectangle.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @param {goog.math.Rect} b A Rectangle.<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @return {boolean} Whether a and b intersect.<tr><td><a id="l194"></a><a href="#l194">194</a><td> */<tr><td><a id="l195"></a><a href="#l195">195</a><td>goog.math.Rect.intersects = function(a, b) {<tr><td><a id="l196"></a><a href="#l196">196</a><td>  return (a.left &lt;= b.left + b.width &amp;&amp; b.left &lt;= a.left + a.width &amp;&amp;<tr><td><a id="l197"></a><a href="#l197">197</a><td>      a.top &lt;= b.top + b.height &amp;&amp; b.top &lt;= a.top + a.height);<tr><td><a id="l198"></a><a href="#l198">198</a><td>};<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> * Returns whether a rectangle intersects this rectangle.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {goog.math.Rect} rect A rectangle.<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @return {boolean} Whether rect intersects this rectangle.<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.math.Rect.prototype.intersects = function(rect) {<tr><td><a id="l207"></a><a href="#l207">207</a><td>  return goog.math.Rect.intersects(this, rect);<tr><td><a id="l208"></a><a href="#l208">208</a><td>};<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Computes the difference regions between two rectangles. The return value is<tr><td><a id="l213"></a><a href="#l213">213</a><td> * an array of 0 to 4 rectangles defining the remaining regions of the first<tr><td><a id="l214"></a><a href="#l214">214</a><td> * rectangle after the second has been subtracted.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @param {goog.math.Rect} a A Rectangle.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @param {goog.math.Rect} b A Rectangle.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @return {!Array&lt;!goog.math.Rect&gt;} An array with 0 to 4 rectangles which<tr><td><a id="l218"></a><a href="#l218">218</a><td> *     together define the difference area of rectangle a minus rectangle b.<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>goog.math.Rect.difference = function(a, b) {<tr><td><a id="l221"></a><a href="#l221">221</a><td>  var intersection = goog.math.Rect.intersection(a, b);<tr><td><a id="l222"></a><a href="#l222">222</a><td>  if (!intersection || !intersection.height || !intersection.width) {<tr><td><a id="l223"></a><a href="#l223">223</a><td>    return [a.clone()];<tr><td><a id="l224"></a><a href="#l224">224</a><td>  }<tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>  var result = [];<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td>  var top = a.top;<tr><td><a id="l229"></a><a href="#l229">229</a><td>  var height = a.height;<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td>  var ar = a.left + a.width;<tr><td><a id="l232"></a><a href="#l232">232</a><td>  var ab = a.top + a.height;<tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>  var br = b.left + b.width;<tr><td><a id="l235"></a><a href="#l235">235</a><td>  var bb = b.top + b.height;<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td>  // Subtract off any area on top where A extends past B<tr><td><a id="l238"></a><a href="#l238">238</a><td>  if (b.top &gt; a.top) {<tr><td><a id="l239"></a><a href="#l239">239</a><td>    result.push(new goog.math.Rect(a.left, a.top, a.width, b.top - a.top));<tr><td><a id="l240"></a><a href="#l240">240</a><td>    top = b.top;<tr><td><a id="l241"></a><a href="#l241">241</a><td>    // If we&#39;re moving the top down, we also need to subtract the height diff.<tr><td><a id="l242"></a><a href="#l242">242</a><td>    height -= b.top - a.top;<tr><td><a id="l243"></a><a href="#l243">243</a><td>  }<tr><td><a id="l244"></a><a href="#l244">244</a><td>  // Subtract off any area on bottom where A extends past B<tr><td><a id="l245"></a><a href="#l245">245</a><td>  if (bb &lt; ab) {<tr><td><a id="l246"></a><a href="#l246">246</a><td>    result.push(new goog.math.Rect(a.left, bb, a.width, ab - bb));<tr><td><a id="l247"></a><a href="#l247">247</a><td>    height = bb - top;<tr><td><a id="l248"></a><a href="#l248">248</a><td>  }<tr><td><a id="l249"></a><a href="#l249">249</a><td>  // Subtract any area on left where A extends past B<tr><td><a id="l250"></a><a href="#l250">250</a><td>  if (b.left &gt; a.left) {<tr><td><a id="l251"></a><a href="#l251">251</a><td>    result.push(new goog.math.Rect(a.left, top, b.left - a.left, height));<tr><td><a id="l252"></a><a href="#l252">252</a><td>  }<tr><td><a id="l253"></a><a href="#l253">253</a><td>  // Subtract any area on right where A extends past B<tr><td><a id="l254"></a><a href="#l254">254</a><td>  if (br &lt; ar) {<tr><td><a id="l255"></a><a href="#l255">255</a><td>    result.push(new goog.math.Rect(br, top, ar - br, height));<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>  return result;<tr><td><a id="l259"></a><a href="#l259">259</a><td>};<tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td>/**<tr><td><a id="l263"></a><a href="#l263">263</a><td> * Computes the difference regions between this rectangle and {@code rect}. The<tr><td><a id="l264"></a><a href="#l264">264</a><td> * return value is an array of 0 to 4 rectangles defining the remaining regions<tr><td><a id="l265"></a><a href="#l265">265</a><td> * of this rectangle after the other has been subtracted.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @param {goog.math.Rect} rect A Rectangle.<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @return {!Array&lt;!goog.math.Rect&gt;} An array with 0 to 4 rectangles which<tr><td><a id="l268"></a><a href="#l268">268</a><td> *     together define the difference area of rectangle a minus rectangle b.<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.math.Rect.prototype.difference = function(rect) {<tr><td><a id="l271"></a><a href="#l271">271</a><td>  return goog.math.Rect.difference(this, rect);<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> * Expand this rectangle to also include the area of the given rectangle.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {goog.math.Rect} rect The other rectangle.<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>goog.math.Rect.prototype.boundingRect = function(rect) {<tr><td><a id="l280"></a><a href="#l280">280</a><td>  // We compute right and bottom before we change left and top below.<tr><td><a id="l281"></a><a href="#l281">281</a><td>  var right = Math.max(this.left + this.width, rect.left + rect.width);<tr><td><a id="l282"></a><a href="#l282">282</a><td>  var bottom = Math.max(this.top + this.height, rect.top + rect.height);<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td>  this.left = Math.min(this.left, rect.left);<tr><td><a id="l285"></a><a href="#l285">285</a><td>  this.top = Math.min(this.top, rect.top);<tr><td><a id="l286"></a><a href="#l286">286</a><td><tr><td><a id="l287"></a><a href="#l287">287</a><td>  this.width = right - this.left;<tr><td><a id="l288"></a><a href="#l288">288</a><td>  this.height = bottom - this.top;<tr><td><a id="l289"></a><a href="#l289">289</a><td>};<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> * Returns a new rectangle which completely contains both input rectangles.<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {goog.math.Rect} a A rectangle.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @param {goog.math.Rect} b A rectangle.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @return {goog.math.Rect} A new bounding rect, or null if either rect is<tr><td><a id="l297"></a><a href="#l297">297</a><td> *     null.<tr><td><a id="l298"></a><a href="#l298">298</a><td> */<tr><td><a id="l299"></a><a href="#l299">299</a><td>goog.math.Rect.boundingRect = function(a, b) {<tr><td><a id="l300"></a><a href="#l300">300</a><td>  if (!a || !b) {<tr><td><a id="l301"></a><a href="#l301">301</a><td>    return null;<tr><td><a id="l302"></a><a href="#l302">302</a><td>  }<tr><td><a id="l303"></a><a href="#l303">303</a><td><tr><td><a id="l304"></a><a href="#l304">304</a><td>  var clone = a.clone();<tr><td><a id="l305"></a><a href="#l305">305</a><td>  clone.boundingRect(b);<tr><td><a id="l306"></a><a href="#l306">306</a><td><tr><td><a id="l307"></a><a href="#l307">307</a><td>  return clone;<tr><td><a id="l308"></a><a href="#l308">308</a><td>};<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>/**<tr><td><a id="l312"></a><a href="#l312">312</a><td> * Tests whether this rectangle entirely contains another rectangle or<tr><td><a id="l313"></a><a href="#l313">313</a><td> * coordinate.<tr><td><a id="l314"></a><a href="#l314">314</a><td> *<tr><td><a id="l315"></a><a href="#l315">315</a><td> * @param {goog.math.Rect|goog.math.Coordinate} another The rectangle or<tr><td><a id="l316"></a><a href="#l316">316</a><td> *     coordinate to test for containment.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @return {boolean} Whether this rectangle contains given rectangle or<tr><td><a id="l318"></a><a href="#l318">318</a><td> *     coordinate.<tr><td><a id="l319"></a><a href="#l319">319</a><td> */<tr><td><a id="l320"></a><a href="#l320">320</a><td>goog.math.Rect.prototype.contains = function(another) {<tr><td><a id="l321"></a><a href="#l321">321</a><td>  if (another instanceof goog.math.Rect) {<tr><td><a id="l322"></a><a href="#l322">322</a><td>    return this.left &lt;= another.left &amp;&amp;<tr><td><a id="l323"></a><a href="#l323">323</a><td>           this.left + this.width &gt;= another.left + another.width &amp;&amp;<tr><td><a id="l324"></a><a href="#l324">324</a><td>           this.top &lt;= another.top &amp;&amp;<tr><td><a id="l325"></a><a href="#l325">325</a><td>           this.top + this.height &gt;= another.top + another.height;<tr><td><a id="l326"></a><a href="#l326">326</a><td>  } else { // (another instanceof goog.math.Coordinate)<tr><td><a id="l327"></a><a href="#l327">327</a><td>    return another.x &gt;= this.left &amp;&amp;<tr><td><a id="l328"></a><a href="#l328">328</a><td>           another.x &lt;= this.left + this.width &amp;&amp;<tr><td><a id="l329"></a><a href="#l329">329</a><td>           another.y &gt;= this.top &amp;&amp;<tr><td><a id="l330"></a><a href="#l330">330</a><td>           another.y &lt;= this.top + this.height;<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><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 {!goog.math.Coordinate} point A coordinate.<tr><td><a id="l337"></a><a href="#l337">337</a><td> * @return {number} The squared distance between the point and the closest<tr><td><a id="l338"></a><a href="#l338">338</a><td> *     point inside the rectangle. Returns 0 if the point is inside the<tr><td><a id="l339"></a><a href="#l339">339</a><td> *     rectangle.<tr><td><a id="l340"></a><a href="#l340">340</a><td> */<tr><td><a id="l341"></a><a href="#l341">341</a><td>goog.math.Rect.prototype.squaredDistance = function(point) {<tr><td><a id="l342"></a><a href="#l342">342</a><td>  var dx = point.x &lt; this.left ?<tr><td><a id="l343"></a><a href="#l343">343</a><td>      this.left - point.x : Math.max(point.x - (this.left + this.width), 0);<tr><td><a id="l344"></a><a href="#l344">344</a><td>  var dy = point.y &lt; this.top ?<tr><td><a id="l345"></a><a href="#l345">345</a><td>      this.top - point.y : Math.max(point.y - (this.top + this.height), 0);<tr><td><a id="l346"></a><a href="#l346">346</a><td>  return dx * dx + dy * dy;<tr><td><a id="l347"></a><a href="#l347">347</a><td>};<tr><td><a id="l348"></a><a href="#l348">348</a><td><tr><td><a id="l349"></a><a href="#l349">349</a><td><tr><td><a id="l350"></a><a href="#l350">350</a><td>/**<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @param {!goog.math.Coordinate} point A coordinate.<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @return {number} The distance between the point and the closest point<tr><td><a id="l353"></a><a href="#l353">353</a><td> *     inside the rectangle. Returns 0 if the point is inside the rectangle.<tr><td><a id="l354"></a><a href="#l354">354</a><td> */<tr><td><a id="l355"></a><a href="#l355">355</a><td>goog.math.Rect.prototype.distance = function(point) {<tr><td><a id="l356"></a><a href="#l356">356</a><td>  return Math.sqrt(this.squaredDistance(point));<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>/**<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @return {!goog.math.Size} The size of this rectangle.<tr><td><a id="l362"></a><a href="#l362">362</a><td> */<tr><td><a id="l363"></a><a href="#l363">363</a><td>goog.math.Rect.prototype.getSize = function() {<tr><td><a id="l364"></a><a href="#l364">364</a><td>  return new goog.math.Size(this.width, this.height);<tr><td><a id="l365"></a><a href="#l365">365</a><td>};<tr><td><a id="l366"></a><a href="#l366">366</a><td><tr><td><a id="l367"></a><a href="#l367">367</a><td><tr><td><a id="l368"></a><a href="#l368">368</a><td>/**<tr><td><a id="l369"></a><a href="#l369">369</a><td> * @return {!goog.math.Coordinate} A new coordinate for the top-left corner of<tr><td><a id="l370"></a><a href="#l370">370</a><td> *     the rectangle.<tr><td><a id="l371"></a><a href="#l371">371</a><td> */<tr><td><a id="l372"></a><a href="#l372">372</a><td>goog.math.Rect.prototype.getTopLeft = function() {<tr><td><a id="l373"></a><a href="#l373">373</a><td>  return new goog.math.Coordinate(this.left, this.top);<tr><td><a id="l374"></a><a href="#l374">374</a><td>};<tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td><tr><td><a id="l377"></a><a href="#l377">377</a><td>/**<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @return {!goog.math.Coordinate} A new coordinate for the center of the<tr><td><a id="l379"></a><a href="#l379">379</a><td> *     rectangle.<tr><td><a id="l380"></a><a href="#l380">380</a><td> */<tr><td><a id="l381"></a><a href="#l381">381</a><td>goog.math.Rect.prototype.getCenter = function() {<tr><td><a id="l382"></a><a href="#l382">382</a><td>  return new goog.math.Coordinate(<tr><td><a id="l383"></a><a href="#l383">383</a><td>      this.left + this.width / 2, this.top + this.height / 2);<tr><td><a id="l384"></a><a href="#l384">384</a><td>};<tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td><tr><td><a id="l387"></a><a href="#l387">387</a><td>/**<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @return {!goog.math.Coordinate} A new coordinate for the bottom-right corner<tr><td><a id="l389"></a><a href="#l389">389</a><td> *     of the rectangle.<tr><td><a id="l390"></a><a href="#l390">390</a><td> */<tr><td><a id="l391"></a><a href="#l391">391</a><td>goog.math.Rect.prototype.getBottomRight = function() {<tr><td><a id="l392"></a><a href="#l392">392</a><td>  return new goog.math.Coordinate(<tr><td><a id="l393"></a><a href="#l393">393</a><td>      this.left + this.width, this.top + this.height);<tr><td><a id="l394"></a><a href="#l394">394</a><td>};<tr><td><a id="l395"></a><a href="#l395">395</a><td><tr><td><a id="l396"></a><a href="#l396">396</a><td><tr><td><a id="l397"></a><a href="#l397">397</a><td>/**<tr><td><a id="l398"></a><a href="#l398">398</a><td> * Rounds the fields to the next larger integer values.<tr><td><a id="l399"></a><a href="#l399">399</a><td> * @return {!goog.math.Rect} This rectangle with ceil&#39;d fields.<tr><td><a id="l400"></a><a href="#l400">400</a><td> */<tr><td><a id="l401"></a><a href="#l401">401</a><td>goog.math.Rect.prototype.ceil = function() {<tr><td><a id="l402"></a><a href="#l402">402</a><td>  this.left = Math.ceil(this.left);<tr><td><a id="l403"></a><a href="#l403">403</a><td>  this.top = Math.ceil(this.top);<tr><td><a id="l404"></a><a href="#l404">404</a><td>  this.width = Math.ceil(this.width);<tr><td><a id="l405"></a><a href="#l405">405</a><td>  this.height = Math.ceil(this.height);<tr><td><a id="l406"></a><a href="#l406">406</a><td>  return this;<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> * Rounds the fields to the next smaller integer values.<tr><td><a id="l412"></a><a href="#l412">412</a><td> * @return {!goog.math.Rect} This rectangle with floored fields.<tr><td><a id="l413"></a><a href="#l413">413</a><td> */<tr><td><a id="l414"></a><a href="#l414">414</a><td>goog.math.Rect.prototype.floor = function() {<tr><td><a id="l415"></a><a href="#l415">415</a><td>  this.left = Math.floor(this.left);<tr><td><a id="l416"></a><a href="#l416">416</a><td>  this.top = Math.floor(this.top);<tr><td><a id="l417"></a><a href="#l417">417</a><td>  this.width = Math.floor(this.width);<tr><td><a id="l418"></a><a href="#l418">418</a><td>  this.height = Math.floor(this.height);<tr><td><a id="l419"></a><a href="#l419">419</a><td>  return this;<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> * Rounds the fields to nearest integer values.<tr><td><a id="l425"></a><a href="#l425">425</a><td> * @return {!goog.math.Rect} This rectangle with rounded fields.<tr><td><a id="l426"></a><a href="#l426">426</a><td> */<tr><td><a id="l427"></a><a href="#l427">427</a><td>goog.math.Rect.prototype.round = function() {<tr><td><a id="l428"></a><a href="#l428">428</a><td>  this.left = Math.round(this.left);<tr><td><a id="l429"></a><a href="#l429">429</a><td>  this.top = Math.round(this.top);<tr><td><a id="l430"></a><a href="#l430">430</a><td>  this.width = Math.round(this.width);<tr><td><a id="l431"></a><a href="#l431">431</a><td>  this.height = Math.round(this.height);<tr><td><a id="l432"></a><a href="#l432">432</a><td>  return this;<tr><td><a id="l433"></a><a href="#l433">433</a><td>};<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> * Translates this rectangle by the given offsets. If a<tr><td><a id="l438"></a><a href="#l438">438</a><td> * {@code goog.math.Coordinate} is given, then the left and top values are<tr><td><a id="l439"></a><a href="#l439">439</a><td> * translated by the coordinate&#39;s x and y values. Otherwise, top and left are<tr><td><a id="l440"></a><a href="#l440">440</a><td> * translated by {@code tx} and {@code opt_ty} respectively.<tr><td><a id="l441"></a><a href="#l441">441</a><td> * @param {number|goog.math.Coordinate} tx The value to translate left by or the<tr><td><a id="l442"></a><a href="#l442">442</a><td> *     the coordinate to translate this rect by.<tr><td><a id="l443"></a><a href="#l443">443</a><td> * @param {number=} opt_ty The value to translate top by.<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @return {!goog.math.Rect} This rectangle after translating.<tr><td><a id="l445"></a><a href="#l445">445</a><td> */<tr><td><a id="l446"></a><a href="#l446">446</a><td>goog.math.Rect.prototype.translate = function(tx, opt_ty) {<tr><td><a id="l447"></a><a href="#l447">447</a><td>  if (tx instanceof goog.math.Coordinate) {<tr><td><a id="l448"></a><a href="#l448">448</a><td>    this.left += tx.x;<tr><td><a id="l449"></a><a href="#l449">449</a><td>    this.top += tx.y;<tr><td><a id="l450"></a><a href="#l450">450</a><td>  } else {<tr><td><a id="l451"></a><a href="#l451">451</a><td>    this.left += tx;<tr><td><a id="l452"></a><a href="#l452">452</a><td>    if (goog.isNumber(opt_ty)) {<tr><td><a id="l453"></a><a href="#l453">453</a><td>      this.top += opt_ty;<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>  return this;<tr><td><a id="l457"></a><a href="#l457">457</a><td>};<tr><td><a id="l458"></a><a href="#l458">458</a><td><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> * Scales this rectangle by the given scale factors. The left and width values<tr><td><a id="l462"></a><a href="#l462">462</a><td> * are scaled by {@code sx} and the top and height values are scaled by<tr><td><a id="l463"></a><a href="#l463">463</a><td> * {@code opt_sy}.  If {@code opt_sy} is not given, then all fields are scaled<tr><td><a id="l464"></a><a href="#l464">464</a><td> * by {@code sx}.<tr><td><a id="l465"></a><a href="#l465">465</a><td> * @param {number} sx The scale factor to use for the x dimension.<tr><td><a id="l466"></a><a href="#l466">466</a><td> * @param {number=} opt_sy The scale factor to use for the y dimension.<tr><td><a id="l467"></a><a href="#l467">467</a><td> * @return {!goog.math.Rect} This rectangle after scaling.<tr><td><a id="l468"></a><a href="#l468">468</a><td> */<tr><td><a id="l469"></a><a href="#l469">469</a><td>goog.math.Rect.prototype.scale = function(sx, opt_sy) {<tr><td><a id="l470"></a><a href="#l470">470</a><td>  var sy = goog.isNumber(opt_sy) ? opt_sy : sx;<tr><td><a id="l471"></a><a href="#l471">471</a><td>  this.left *= sx;<tr><td><a id="l472"></a><a href="#l472">472</a><td>  this.width *= sx;<tr><td><a id="l473"></a><a href="#l473">473</a><td>  this.top *= sy;<tr><td><a id="l474"></a><a href="#l474">474</a><td>  this.height *= sy;<tr><td><a id="l475"></a><a href="#l475">475</a><td>  return this;<tr><td><a id="l476"></a><a href="#l476">476</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/math/size.js.src.html b/docs/source/lib/goog/math/size.js.src.html
new file mode 100644
index 0000000..d35a7f5
--- /dev/null
+++ b/docs/source/lib/goog/math/size.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>size.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/math/size.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A utility class for representing two-dimensional sizes.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author brenneman@google.com (Shawn Brenneman)<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.math.Size&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>/**<tr><td><a id="l26"></a><a href="#l26">26</a><td> * Class for representing sizes consisting of a width and height. Undefined<tr><td><a id="l27"></a><a href="#l27">27</a><td> * width and height support is deprecated and results in compiler warning.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @param {number} width Width.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {number} height Height.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @struct<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @constructor<tr><td><a id="l32"></a><a href="#l32">32</a><td> */<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.math.Size = function(width, height) {<tr><td><a id="l34"></a><a href="#l34">34</a><td>  /**<tr><td><a id="l35"></a><a href="#l35">35</a><td>   * Width<tr><td><a id="l36"></a><a href="#l36">36</a><td>   * @type {number}<tr><td><a id="l37"></a><a href="#l37">37</a><td>   */<tr><td><a id="l38"></a><a href="#l38">38</a><td>  this.width = width;<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>  /**<tr><td><a id="l41"></a><a href="#l41">41</a><td>   * Height<tr><td><a id="l42"></a><a href="#l42">42</a><td>   * @type {number}<tr><td><a id="l43"></a><a href="#l43">43</a><td>   */<tr><td><a id="l44"></a><a href="#l44">44</a><td>  this.height = height;<tr><td><a id="l45"></a><a href="#l45">45</a><td>};<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>/**<tr><td><a id="l49"></a><a href="#l49">49</a><td> * Compares sizes for equality.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @param {goog.math.Size} a A Size.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @param {goog.math.Size} b A Size.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @return {boolean} True iff the sizes have equal widths and equal<tr><td><a id="l53"></a><a href="#l53">53</a><td> *     heights, or if both are null.<tr><td><a id="l54"></a><a href="#l54">54</a><td> */<tr><td><a id="l55"></a><a href="#l55">55</a><td>goog.math.Size.equals = function(a, b) {<tr><td><a id="l56"></a><a href="#l56">56</a><td>  if (a == b) {<tr><td><a id="l57"></a><a href="#l57">57</a><td>    return true;<tr><td><a id="l58"></a><a href="#l58">58</a><td>  }<tr><td><a id="l59"></a><a href="#l59">59</a><td>  if (!a || !b) {<tr><td><a id="l60"></a><a href="#l60">60</a><td>    return false;<tr><td><a id="l61"></a><a href="#l61">61</a><td>  }<tr><td><a id="l62"></a><a href="#l62">62</a><td>  return a.width == b.width &amp;&amp; a.height == b.height;<tr><td><a id="l63"></a><a href="#l63">63</a><td>};<tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td>/**<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {!goog.math.Size} A new copy of the Size.<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>goog.math.Size.prototype.clone = function() {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  return new goog.math.Size(this.width, this.height);<tr><td><a id="l71"></a><a href="#l71">71</a><td>};<tr><td><a id="l72"></a><a href="#l72">72</a><td><tr><td><a id="l73"></a><a href="#l73">73</a><td><tr><td><a id="l74"></a><a href="#l74">74</a><td>if (goog.DEBUG) {<tr><td><a id="l75"></a><a href="#l75">75</a><td>  /**<tr><td><a id="l76"></a><a href="#l76">76</a><td>   * Returns a nice string representing size.<tr><td><a id="l77"></a><a href="#l77">77</a><td>   * @return {string} In the form (50 x 73).<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * @override<tr><td><a id="l79"></a><a href="#l79">79</a><td>   */<tr><td><a id="l80"></a><a href="#l80">80</a><td>  goog.math.Size.prototype.toString = function() {<tr><td><a id="l81"></a><a href="#l81">81</a><td>    return &#39;(&#39; + this.width + &#39; x &#39; + this.height + &#39;)&#39;;<tr><td><a id="l82"></a><a href="#l82">82</a><td>  };<tr><td><a id="l83"></a><a href="#l83">83</a><td>}<tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td><tr><td><a id="l86"></a><a href="#l86">86</a><td>/**<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @return {number} The longer of the two dimensions in the size.<tr><td><a id="l88"></a><a href="#l88">88</a><td> */<tr><td><a id="l89"></a><a href="#l89">89</a><td>goog.math.Size.prototype.getLongest = function() {<tr><td><a id="l90"></a><a href="#l90">90</a><td>  return Math.max(this.width, this.height);<tr><td><a id="l91"></a><a href="#l91">91</a><td>};<tr><td><a id="l92"></a><a href="#l92">92</a><td><tr><td><a id="l93"></a><a href="#l93">93</a><td><tr><td><a id="l94"></a><a href="#l94">94</a><td>/**<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @return {number} The shorter of the two dimensions in the size.<tr><td><a id="l96"></a><a href="#l96">96</a><td> */<tr><td><a id="l97"></a><a href="#l97">97</a><td>goog.math.Size.prototype.getShortest = function() {<tr><td><a id="l98"></a><a href="#l98">98</a><td>  return Math.min(this.width, this.height);<tr><td><a id="l99"></a><a href="#l99">99</a><td>};<tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td><tr><td><a id="l102"></a><a href="#l102">102</a><td>/**<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @return {number} The area of the size (width * height).<tr><td><a id="l104"></a><a href="#l104">104</a><td> */<tr><td><a id="l105"></a><a href="#l105">105</a><td>goog.math.Size.prototype.area = function() {<tr><td><a id="l106"></a><a href="#l106">106</a><td>  return this.width * this.height;<tr><td><a id="l107"></a><a href="#l107">107</a><td>};<tr><td><a id="l108"></a><a href="#l108">108</a><td><tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td>/**<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @return {number} The perimeter of the size (width + height) * 2.<tr><td><a id="l112"></a><a href="#l112">112</a><td> */<tr><td><a id="l113"></a><a href="#l113">113</a><td>goog.math.Size.prototype.perimeter = function() {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  return (this.width + this.height) * 2;<tr><td><a id="l115"></a><a href="#l115">115</a><td>};<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td><tr><td><a id="l118"></a><a href="#l118">118</a><td>/**<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @return {number} The ratio of the size&#39;s width to its height.<tr><td><a id="l120"></a><a href="#l120">120</a><td> */<tr><td><a id="l121"></a><a href="#l121">121</a><td>goog.math.Size.prototype.aspectRatio = function() {<tr><td><a id="l122"></a><a href="#l122">122</a><td>  return this.width / this.height;<tr><td><a id="l123"></a><a href="#l123">123</a><td>};<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td>/**<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @return {boolean} True if the size has zero area, false if both dimensions<tr><td><a id="l128"></a><a href="#l128">128</a><td> *     are non-zero numbers.<tr><td><a id="l129"></a><a href="#l129">129</a><td> */<tr><td><a id="l130"></a><a href="#l130">130</a><td>goog.math.Size.prototype.isEmpty = function() {<tr><td><a id="l131"></a><a href="#l131">131</a><td>  return !this.area();<tr><td><a id="l132"></a><a href="#l132">132</a><td>};<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>/**<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Clamps the width and height parameters upward to integer values.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @return {!goog.math.Size} This size with ceil&#39;d components.<tr><td><a id="l138"></a><a href="#l138">138</a><td> */<tr><td><a id="l139"></a><a href="#l139">139</a><td>goog.math.Size.prototype.ceil = function() {<tr><td><a id="l140"></a><a href="#l140">140</a><td>  this.width = Math.ceil(this.width);<tr><td><a id="l141"></a><a href="#l141">141</a><td>  this.height = Math.ceil(this.height);<tr><td><a id="l142"></a><a href="#l142">142</a><td>  return this;<tr><td><a id="l143"></a><a href="#l143">143</a><td>};<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td>/**<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @param {!goog.math.Size} target The target size.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @return {boolean} True if this Size is the same size or smaller than the<tr><td><a id="l149"></a><a href="#l149">149</a><td> *     target size in both dimensions.<tr><td><a id="l150"></a><a href="#l150">150</a><td> */<tr><td><a id="l151"></a><a href="#l151">151</a><td>goog.math.Size.prototype.fitsInside = function(target) {<tr><td><a id="l152"></a><a href="#l152">152</a><td>  return this.width &lt;= target.width &amp;&amp; this.height &lt;= target.height;<tr><td><a id="l153"></a><a href="#l153">153</a><td>};<tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td>/**<tr><td><a id="l157"></a><a href="#l157">157</a><td> * Clamps the width and height parameters downward to integer values.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @return {!goog.math.Size} This size with floored components.<tr><td><a id="l159"></a><a href="#l159">159</a><td> */<tr><td><a id="l160"></a><a href="#l160">160</a><td>goog.math.Size.prototype.floor = function() {<tr><td><a id="l161"></a><a href="#l161">161</a><td>  this.width = Math.floor(this.width);<tr><td><a id="l162"></a><a href="#l162">162</a><td>  this.height = Math.floor(this.height);<tr><td><a id="l163"></a><a href="#l163">163</a><td>  return this;<tr><td><a id="l164"></a><a href="#l164">164</a><td>};<tr><td><a id="l165"></a><a href="#l165">165</a><td><tr><td><a id="l166"></a><a href="#l166">166</a><td><tr><td><a id="l167"></a><a href="#l167">167</a><td>/**<tr><td><a id="l168"></a><a href="#l168">168</a><td> * Rounds the width and height parameters to integer values.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @return {!goog.math.Size} This size with rounded components.<tr><td><a id="l170"></a><a href="#l170">170</a><td> */<tr><td><a id="l171"></a><a href="#l171">171</a><td>goog.math.Size.prototype.round = function() {<tr><td><a id="l172"></a><a href="#l172">172</a><td>  this.width = Math.round(this.width);<tr><td><a id="l173"></a><a href="#l173">173</a><td>  this.height = Math.round(this.height);<tr><td><a id="l174"></a><a href="#l174">174</a><td>  return this;<tr><td><a id="l175"></a><a href="#l175">175</a><td>};<tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td><tr><td><a id="l178"></a><a href="#l178">178</a><td>/**<tr><td><a id="l179"></a><a href="#l179">179</a><td> * Scales this size by the given scale factors. The width and height are scaled<tr><td><a id="l180"></a><a href="#l180">180</a><td> * by {@code sx} and {@code opt_sy} respectively.  If {@code opt_sy} is not<tr><td><a id="l181"></a><a href="#l181">181</a><td> * given, then {@code sx} is used for both the width and height.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @param {number} sx The scale factor to use for the width.<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @param {number=} opt_sy The scale factor to use for the height.<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @return {!goog.math.Size} This Size object after scaling.<tr><td><a id="l185"></a><a href="#l185">185</a><td> */<tr><td><a id="l186"></a><a href="#l186">186</a><td>goog.math.Size.prototype.scale = function(sx, opt_sy) {<tr><td><a id="l187"></a><a href="#l187">187</a><td>  var sy = goog.isNumber(opt_sy) ? opt_sy : sx;<tr><td><a id="l188"></a><a href="#l188">188</a><td>  this.width *= sx;<tr><td><a id="l189"></a><a href="#l189">189</a><td>  this.height *= sy;<tr><td><a id="l190"></a><a href="#l190">190</a><td>  return this;<tr><td><a id="l191"></a><a href="#l191">191</a><td>};<tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td>/**<tr><td><a id="l195"></a><a href="#l195">195</a><td> * Uniformly scales the size to perfectly cover the dimensions of a given size.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * If the size is already larger than the target, it will be scaled down to the<tr><td><a id="l197"></a><a href="#l197">197</a><td> * minimum size at which it still covers the entire target. The original aspect<tr><td><a id="l198"></a><a href="#l198">198</a><td> * ratio will be preserved.<tr><td><a id="l199"></a><a href="#l199">199</a><td> *<tr><td><a id="l200"></a><a href="#l200">200</a><td> * This function assumes that both Sizes contain strictly positive dimensions.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @param {!goog.math.Size} target The target size.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @return {!goog.math.Size} This Size object, after optional scaling.<tr><td><a id="l203"></a><a href="#l203">203</a><td> */<tr><td><a id="l204"></a><a href="#l204">204</a><td>goog.math.Size.prototype.scaleToCover = function(target) {<tr><td><a id="l205"></a><a href="#l205">205</a><td>  var s = this.aspectRatio() &lt;= target.aspectRatio() ?<tr><td><a id="l206"></a><a href="#l206">206</a><td>      target.width / this.width :<tr><td><a id="l207"></a><a href="#l207">207</a><td>      target.height / this.height;<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td>  return this.scale(s);<tr><td><a id="l210"></a><a href="#l210">210</a><td>};<tr><td><a id="l211"></a><a href="#l211">211</a><td><tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td>/**<tr><td><a id="l214"></a><a href="#l214">214</a><td> * Uniformly scales the size to fit inside the dimensions of a given size. The<tr><td><a id="l215"></a><a href="#l215">215</a><td> * original aspect ratio will be preserved.<tr><td><a id="l216"></a><a href="#l216">216</a><td> *<tr><td><a id="l217"></a><a href="#l217">217</a><td> * This function assumes that both Sizes contain strictly positive dimensions.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @param {!goog.math.Size} target The target size.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @return {!goog.math.Size} This Size object, after optional scaling.<tr><td><a id="l220"></a><a href="#l220">220</a><td> */<tr><td><a id="l221"></a><a href="#l221">221</a><td>goog.math.Size.prototype.scaleToFit = function(target) {<tr><td><a id="l222"></a><a href="#l222">222</a><td>  var s = this.aspectRatio() &gt; target.aspectRatio() ?<tr><td><a id="l223"></a><a href="#l223">223</a><td>      target.width / this.width :<tr><td><a id="l224"></a><a href="#l224">224</a><td>      target.height / this.height;<tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>  return this.scale(s);<tr><td><a id="l227"></a><a href="#l227">227</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html b/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html
index 000b805..ce7f2a4 100644
--- a/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html
+++ b/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>wrapperxmlhttpfactory.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/net/wrapperxmlhttpfactory.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Implementation of XmlHttpFactory which allows construction from<tr><td><a name="l17" href="#l17">17</a><td> * simple factory methods.<tr><td><a name="l18" href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<tr><td><a name="l19" href="#l19">19</a><td> */<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.net.WrapperXmlHttpFactory&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>goog.require(&#39;goog.net.XmlHttpFactory&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td>/**<tr><td><a name="l28" href="#l28">28</a><td> * An xhr factory subclass which can be constructed using two factory methods.<tr><td><a name="l29" href="#l29">29</a><td> * This exists partly to allow the preservation of goog.net.XmlHttp.setFactory()<tr><td><a name="l30" href="#l30">30</a><td> * with an unchanged signature.<tr><td><a name="l31" href="#l31">31</a><td> * @param {function() : !(XMLHttpRequest|GearsHttpRequest)} xhrFactory A<tr><td><a name="l32" href="#l32">32</a><td> *     function which returns a new XHR object.<tr><td><a name="l33" href="#l33">33</a><td> * @param {function() : !Object} optionsFactory A function which returns the<tr><td><a name="l34" href="#l34">34</a><td> *     options associated with xhr objects from this factory.<tr><td><a name="l35" href="#l35">35</a><td> * @extends {goog.net.XmlHttpFactory}<tr><td><a name="l36" href="#l36">36</a><td> * @constructor<tr><td><a name="l37" href="#l37">37</a><td> */<tr><td><a name="l38" href="#l38">38</a><td>goog.net.WrapperXmlHttpFactory = function(xhrFactory, optionsFactory) {<tr><td><a name="l39" href="#l39">39</a><td>  goog.net.XmlHttpFactory.call(this);<tr><td><a name="l40" href="#l40">40</a><td><tr><td><a name="l41" href="#l41">41</a><td>  /**<tr><td><a name="l42" href="#l42">42</a><td>   * XHR factory method.<tr><td><a name="l43" href="#l43">43</a><td>   * @type {function() : !(XMLHttpRequest|GearsHttpRequest)}<tr><td><a name="l44" href="#l44">44</a><td>   * @private<tr><td><a name="l45" href="#l45">45</a><td>   */<tr><td><a name="l46" href="#l46">46</a><td>  this.xhrFactory_ = xhrFactory;<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td>  /**<tr><td><a name="l49" href="#l49">49</a><td>   * Options factory method.<tr><td><a name="l50" href="#l50">50</a><td>   * @type {function() : !Object}<tr><td><a name="l51" href="#l51">51</a><td>   * @private<tr><td><a name="l52" href="#l52">52</a><td>   */<tr><td><a name="l53" href="#l53">53</a><td>  this.optionsFactory_ = optionsFactory;<tr><td><a name="l54" href="#l54">54</a><td>};<tr><td><a name="l55" href="#l55">55</a><td>goog.inherits(goog.net.WrapperXmlHttpFactory, goog.net.XmlHttpFactory);<tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td>/** @override */<tr><td><a name="l59" href="#l59">59</a><td>goog.net.WrapperXmlHttpFactory.prototype.createInstance = function() {<tr><td><a name="l60" href="#l60">60</a><td>  return this.xhrFactory_();<tr><td><a name="l61" href="#l61">61</a><td>};<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/** @override */<tr><td><a name="l65" href="#l65">65</a><td>goog.net.WrapperXmlHttpFactory.prototype.getOptions = function() {<tr><td><a name="l66" href="#l66">66</a><td>  return this.optionsFactory_();<tr><td><a name="l67" href="#l67">67</a><td>};<tr><td><a name="l68" href="#l68">68</a><td></table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>wrapperxmlhttpfactory.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/net/wrapperxmlhttpfactory.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Implementation of XmlHttpFactory which allows construction from<tr><td><a id="l17"></a><a href="#l17">17</a><td> * simple factory methods.<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.net.WrapperXmlHttpFactory&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/** @suppress {extraRequire} Typedef. */<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.net.XhrLike&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.require(&#39;goog.net.XmlHttpFactory&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>/**<tr><td><a id="l30"></a><a href="#l30">30</a><td> * An xhr factory subclass which can be constructed using two factory methods.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * This exists partly to allow the preservation of goog.net.XmlHttp.setFactory()<tr><td><a id="l32"></a><a href="#l32">32</a><td> * with an unchanged signature.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {function():!goog.net.XhrLike.OrNative} xhrFactory<tr><td><a id="l34"></a><a href="#l34">34</a><td> *     A function which returns a new XHR object.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {function():!Object} optionsFactory A function which returns the<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     options associated with xhr objects from this factory.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @extends {goog.net.XmlHttpFactory}<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @constructor<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @final<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.net.WrapperXmlHttpFactory = function(xhrFactory, optionsFactory) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  goog.net.XmlHttpFactory.call(this);<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>  /**<tr><td><a id="l45"></a><a href="#l45">45</a><td>   * XHR factory method.<tr><td><a id="l46"></a><a href="#l46">46</a><td>   * @type {function() : !goog.net.XhrLike.OrNative}<tr><td><a id="l47"></a><a href="#l47">47</a><td>   * @private<tr><td><a id="l48"></a><a href="#l48">48</a><td>   */<tr><td><a id="l49"></a><a href="#l49">49</a><td>  this.xhrFactory_ = xhrFactory;<tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>  /**<tr><td><a id="l52"></a><a href="#l52">52</a><td>   * Options factory method.<tr><td><a id="l53"></a><a href="#l53">53</a><td>   * @type {function() : !Object}<tr><td><a id="l54"></a><a href="#l54">54</a><td>   * @private<tr><td><a id="l55"></a><a href="#l55">55</a><td>   */<tr><td><a id="l56"></a><a href="#l56">56</a><td>  this.optionsFactory_ = optionsFactory;<tr><td><a id="l57"></a><a href="#l57">57</a><td>};<tr><td><a id="l58"></a><a href="#l58">58</a><td>goog.inherits(goog.net.WrapperXmlHttpFactory, goog.net.XmlHttpFactory);<tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td>/** @override */<tr><td><a id="l62"></a><a href="#l62">62</a><td>goog.net.WrapperXmlHttpFactory.prototype.createInstance = function() {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  return this.xhrFactory_();<tr><td><a id="l64"></a><a href="#l64">64</a><td>};<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>/** @override */<tr><td><a id="l68"></a><a href="#l68">68</a><td>goog.net.WrapperXmlHttpFactory.prototype.getOptions = function() {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  return this.optionsFactory_();<tr><td><a id="l70"></a><a href="#l70">70</a><td>};<tr><td><a id="l71"></a><a href="#l71">71</a><td></table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/net/xhrlike.js.src.html b/docs/source/lib/goog/net/xhrlike.js.src.html
new file mode 100644
index 0000000..39baf98
--- /dev/null
+++ b/docs/source/lib/goog/net/xhrlike.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>xhrlike.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/net/xhrlike.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.net.XhrLike&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Interface for the common parts of XMLHttpRequest.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Mostly copied from externs/w3c_xml.js.<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * @interface<tr><td><a id="l25"></a><a href="#l25">25</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/<tr><td><a id="l26"></a><a href="#l26">26</a><td> */<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.net.XhrLike = function() {};<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td>/**<tr><td><a id="l31"></a><a href="#l31">31</a><td> * Typedef that refers to either native or custom-implemented XHR objects.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @typedef {!goog.net.XhrLike|!XMLHttpRequest}<tr><td><a id="l33"></a><a href="#l33">33</a><td> */<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.net.XhrLike.OrNative;<tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td><tr><td><a id="l37"></a><a href="#l37">37</a><td>/**<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @type {function()|null|undefined}<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#handler-xhr-onreadystatechange<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.net.XhrLike.prototype.onreadystatechange;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>/**<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @type {string}<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-responsetext-attribute<tr><td><a id="l47"></a><a href="#l47">47</a><td> */<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.net.XhrLike.prototype.responseText;<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>/**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @type {Document}<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-responsexml-attribute<tr><td><a id="l54"></a><a href="#l54">54</a><td> */<tr><td><a id="l55"></a><a href="#l55">55</a><td>goog.net.XhrLike.prototype.responseXML;<tr><td><a id="l56"></a><a href="#l56">56</a><td><tr><td><a id="l57"></a><a href="#l57">57</a><td><tr><td><a id="l58"></a><a href="#l58">58</a><td>/**<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @type {number}<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#readystate<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>goog.net.XhrLike.prototype.readyState;<tr><td><a id="l63"></a><a href="#l63">63</a><td><tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td>/**<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @type {number}<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#status<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>goog.net.XhrLike.prototype.status;<tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td><tr><td><a id="l72"></a><a href="#l72">72</a><td>/**<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @type {string}<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#statustext<tr><td><a id="l75"></a><a href="#l75">75</a><td> */<tr><td><a id="l76"></a><a href="#l76">76</a><td>goog.net.XhrLike.prototype.statusText;<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td>/**<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @param {string} method<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @param {string} url<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @param {?boolean=} opt_async<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @param {?string=} opt_user<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {?string=} opt_password<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-open()-method<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td>goog.net.XhrLike.prototype.open = function(method, url, opt_async, opt_user,<tr><td><a id="l88"></a><a href="#l88">88</a><td>    opt_password) {};<tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td><tr><td><a id="l91"></a><a href="#l91">91</a><td>/**<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @param {ArrayBuffer|ArrayBufferView|Blob|Document|FormData|string=} opt_data<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-send()-method<tr><td><a id="l94"></a><a href="#l94">94</a><td> */<tr><td><a id="l95"></a><a href="#l95">95</a><td>goog.net.XhrLike.prototype.send = function(opt_data) {};<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>/**<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-abort()-method<tr><td><a id="l100"></a><a href="#l100">100</a><td> */<tr><td><a id="l101"></a><a href="#l101">101</a><td>goog.net.XhrLike.prototype.abort = function() {};<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>/**<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @param {string} header<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @param {string} value<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-setrequestheader()-method<tr><td><a id="l108"></a><a href="#l108">108</a><td> */<tr><td><a id="l109"></a><a href="#l109">109</a><td>goog.net.XhrLike.prototype.setRequestHeader = function(header, value) {};<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>/**<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @param {string} header<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @return {string}<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-getresponseheader()-method<tr><td><a id="l116"></a><a href="#l116">116</a><td> */<tr><td><a id="l117"></a><a href="#l117">117</a><td>goog.net.XhrLike.prototype.getResponseHeader = function(header) {};<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>/**<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @return {string}<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @see http://www.w3.org/TR/XMLHttpRequest/#the-getallresponseheaders()-method<tr><td><a id="l123"></a><a href="#l123">123</a><td> */<tr><td><a id="l124"></a><a href="#l124">124</a><td>goog.net.XhrLike.prototype.getAllResponseHeaders = function() {};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/net/xmlhttp.js.src.html b/docs/source/lib/goog/net/xmlhttp.js.src.html
index 9292738..52d0ce2 100644
--- a/docs/source/lib/goog/net/xmlhttp.js.src.html
+++ b/docs/source/lib/goog/net/xmlhttp.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>xmlhttp.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/net/xmlhttp.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Low level handling of XMLHttpRequest.<tr><td><a name="l17" href="#l17">17</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a name="l18" href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<tr><td><a name="l19" href="#l19">19</a><td> */<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.net.DefaultXmlHttpFactory&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;goog.net.XmlHttp&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.net.XmlHttp.OptionType&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.provide(&#39;goog.net.XmlHttp.ReadyState&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.net.WrapperXmlHttpFactory&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.require(&#39;goog.net.XmlHttpFactory&#39;);<tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td>/**<tr><td><a name="l31" href="#l31">31</a><td> * Static class for creating XMLHttpRequest objects.<tr><td><a name="l32" href="#l32">32</a><td> * @return {!(XMLHttpRequest|GearsHttpRequest)} A new XMLHttpRequest object.<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td>goog.net.XmlHttp = function() {<tr><td><a name="l35" href="#l35">35</a><td>  return goog.net.XmlHttp.factory_.createInstance();<tr><td><a name="l36" href="#l36">36</a><td>};<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>/**<tr><td><a name="l40" href="#l40">40</a><td> * @define {boolean} Whether to assume XMLHttpRequest exists. Setting this to<tr><td><a name="l41" href="#l41">41</a><td> *     true strips the ActiveX probing code.<tr><td><a name="l42" href="#l42">42</a><td> */<tr><td><a name="l43" href="#l43">43</a><td>goog.define(&#39;goog.net.XmlHttp.ASSUME_NATIVE_XHR&#39;, false);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td>/**<tr><td><a name="l47" href="#l47">47</a><td> * Gets the options to use with the XMLHttpRequest objects obtained using<tr><td><a name="l48" href="#l48">48</a><td> * the static methods.<tr><td><a name="l49" href="#l49">49</a><td> * @return {Object} The options.<tr><td><a name="l50" href="#l50">50</a><td> */<tr><td><a name="l51" href="#l51">51</a><td>goog.net.XmlHttp.getOptions = function() {<tr><td><a name="l52" href="#l52">52</a><td>  return goog.net.XmlHttp.factory_.getOptions();<tr><td><a name="l53" href="#l53">53</a><td>};<tr><td><a name="l54" href="#l54">54</a><td><tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td>/**<tr><td><a name="l57" href="#l57">57</a><td> * Type of options that an XmlHttp object can have.<tr><td><a name="l58" href="#l58">58</a><td> * @enum {number}<tr><td><a name="l59" href="#l59">59</a><td> */<tr><td><a name="l60" href="#l60">60</a><td>goog.net.XmlHttp.OptionType = {<tr><td><a name="l61" href="#l61">61</a><td>  /**<tr><td><a name="l62" href="#l62">62</a><td>   * Whether a goog.nullFunction should be used to clear the onreadystatechange<tr><td><a name="l63" href="#l63">63</a><td>   * handler instead of null.<tr><td><a name="l64" href="#l64">64</a><td>   */<tr><td><a name="l65" href="#l65">65</a><td>  USE_NULL_FUNCTION: 0,<tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td>  /**<tr><td><a name="l68" href="#l68">68</a><td>   * NOTE(user): In IE if send() errors on a *local* request the readystate<tr><td><a name="l69" href="#l69">69</a><td>   * is still changed to COMPLETE.  We need to ignore it and allow the<tr><td><a name="l70" href="#l70">70</a><td>   * try/catch around send() to pick up the error.<tr><td><a name="l71" href="#l71">71</a><td>   */<tr><td><a name="l72" href="#l72">72</a><td>  LOCAL_REQUEST_ERROR: 1<tr><td><a name="l73" href="#l73">73</a><td>};<tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td>/**<tr><td><a name="l77" href="#l77">77</a><td> * Status constants for XMLHTTP, matches:<tr><td><a name="l78" href="#l78">78</a><td> * http://msdn.microsoft.com/library/default.asp?url=/library/<tr><td><a name="l79" href="#l79">79</a><td> *   en-us/xmlsdk/html/0e6a34e4-f90c-489d-acff-cb44242fafc6.asp<tr><td><a name="l80" href="#l80">80</a><td> * @enum {number}<tr><td><a name="l81" href="#l81">81</a><td> */<tr><td><a name="l82" href="#l82">82</a><td>goog.net.XmlHttp.ReadyState = {<tr><td><a name="l83" href="#l83">83</a><td>  /**<tr><td><a name="l84" href="#l84">84</a><td>   * Constant for when xmlhttprequest.readyState is uninitialized<tr><td><a name="l85" href="#l85">85</a><td>   */<tr><td><a name="l86" href="#l86">86</a><td>  UNINITIALIZED: 0,<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td>  /**<tr><td><a name="l89" href="#l89">89</a><td>   * Constant for when xmlhttprequest.readyState is loading.<tr><td><a name="l90" href="#l90">90</a><td>   */<tr><td><a name="l91" href="#l91">91</a><td>  LOADING: 1,<tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>  /**<tr><td><a name="l94" href="#l94">94</a><td>   * Constant for when xmlhttprequest.readyState is loaded.<tr><td><a name="l95" href="#l95">95</a><td>   */<tr><td><a name="l96" href="#l96">96</a><td>  LOADED: 2,<tr><td><a name="l97" href="#l97">97</a><td><tr><td><a name="l98" href="#l98">98</a><td>  /**<tr><td><a name="l99" href="#l99">99</a><td>   * Constant for when xmlhttprequest.readyState is in an interactive state.<tr><td><a name="l100" href="#l100">100</a><td>   */<tr><td><a name="l101" href="#l101">101</a><td>  INTERACTIVE: 3,<tr><td><a name="l102" href="#l102">102</a><td><tr><td><a name="l103" href="#l103">103</a><td>  /**<tr><td><a name="l104" href="#l104">104</a><td>   * Constant for when xmlhttprequest.readyState is completed<tr><td><a name="l105" href="#l105">105</a><td>   */<tr><td><a name="l106" href="#l106">106</a><td>  COMPLETE: 4<tr><td><a name="l107" href="#l107">107</a><td>};<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>/**<tr><td><a name="l111" href="#l111">111</a><td> * The global factory instance for creating XMLHttpRequest objects.<tr><td><a name="l112" href="#l112">112</a><td> * @type {goog.net.XmlHttpFactory}<tr><td><a name="l113" href="#l113">113</a><td> * @private<tr><td><a name="l114" href="#l114">114</a><td> */<tr><td><a name="l115" href="#l115">115</a><td>goog.net.XmlHttp.factory_;<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td>/**<tr><td><a name="l119" href="#l119">119</a><td> * Sets the factories for creating XMLHttpRequest objects and their options.<tr><td><a name="l120" href="#l120">120</a><td> * @param {Function} factory The factory for XMLHttpRequest objects.<tr><td><a name="l121" href="#l121">121</a><td> * @param {Function} optionsFactory The factory for options.<tr><td><a name="l122" href="#l122">122</a><td> * @deprecated Use setGlobalFactory instead.<tr><td><a name="l123" href="#l123">123</a><td> */<tr><td><a name="l124" href="#l124">124</a><td>goog.net.XmlHttp.setFactory = function(factory, optionsFactory) {<tr><td><a name="l125" href="#l125">125</a><td>  goog.net.XmlHttp.setGlobalFactory(new goog.net.WrapperXmlHttpFactory(<tr><td><a name="l126" href="#l126">126</a><td>      /** @type {function() : !(XMLHttpRequest|GearsHttpRequest)} */ (factory),<tr><td><a name="l127" href="#l127">127</a><td>      /** @type {function() : !Object}*/ (optionsFactory)));<tr><td><a name="l128" href="#l128">128</a><td>};<tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td>/**<tr><td><a name="l132" href="#l132">132</a><td> * Sets the global factory object.<tr><td><a name="l133" href="#l133">133</a><td> * @param {!goog.net.XmlHttpFactory} factory New global factory object.<tr><td><a name="l134" href="#l134">134</a><td> */<tr><td><a name="l135" href="#l135">135</a><td>goog.net.XmlHttp.setGlobalFactory = function(factory) {<tr><td><a name="l136" href="#l136">136</a><td>  goog.net.XmlHttp.factory_ = factory;<tr><td><a name="l137" href="#l137">137</a><td>};<tr><td><a name="l138" href="#l138">138</a><td><tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td><tr><td><a name="l141" href="#l141">141</a><td>/**<tr><td><a name="l142" href="#l142">142</a><td> * Default factory to use when creating xhr objects.  You probably shouldn&#39;t be<tr><td><a name="l143" href="#l143">143</a><td> * instantiating this directly, but rather using it via goog.net.XmlHttp.<tr><td><a name="l144" href="#l144">144</a><td> * @extends {goog.net.XmlHttpFactory}<tr><td><a name="l145" href="#l145">145</a><td> * @constructor<tr><td><a name="l146" href="#l146">146</a><td> */<tr><td><a name="l147" href="#l147">147</a><td>goog.net.DefaultXmlHttpFactory = function() {<tr><td><a name="l148" href="#l148">148</a><td>  goog.net.XmlHttpFactory.call(this);<tr><td><a name="l149" href="#l149">149</a><td>};<tr><td><a name="l150" href="#l150">150</a><td>goog.inherits(goog.net.DefaultXmlHttpFactory, goog.net.XmlHttpFactory);<tr><td><a name="l151" href="#l151">151</a><td><tr><td><a name="l152" href="#l152">152</a><td><tr><td><a name="l153" href="#l153">153</a><td>/** @override */<tr><td><a name="l154" href="#l154">154</a><td>goog.net.DefaultXmlHttpFactory.prototype.createInstance = function() {<tr><td><a name="l155" href="#l155">155</a><td>  var progId = this.getProgId_();<tr><td><a name="l156" href="#l156">156</a><td>  if (progId) {<tr><td><a name="l157" href="#l157">157</a><td>    return new ActiveXObject(progId);<tr><td><a name="l158" href="#l158">158</a><td>  } else {<tr><td><a name="l159" href="#l159">159</a><td>    return new XMLHttpRequest();<tr><td><a name="l160" href="#l160">160</a><td>  }<tr><td><a name="l161" href="#l161">161</a><td>};<tr><td><a name="l162" href="#l162">162</a><td><tr><td><a name="l163" href="#l163">163</a><td><tr><td><a name="l164" href="#l164">164</a><td>/** @override */<tr><td><a name="l165" href="#l165">165</a><td>goog.net.DefaultXmlHttpFactory.prototype.internalGetOptions = function() {<tr><td><a name="l166" href="#l166">166</a><td>  var progId = this.getProgId_();<tr><td><a name="l167" href="#l167">167</a><td>  var options = {};<tr><td><a name="l168" href="#l168">168</a><td>  if (progId) {<tr><td><a name="l169" href="#l169">169</a><td>    options[goog.net.XmlHttp.OptionType.USE_NULL_FUNCTION] = true;<tr><td><a name="l170" href="#l170">170</a><td>    options[goog.net.XmlHttp.OptionType.LOCAL_REQUEST_ERROR] = true;<tr><td><a name="l171" href="#l171">171</a><td>  }<tr><td><a name="l172" href="#l172">172</a><td>  return options;<tr><td><a name="l173" href="#l173">173</a><td>};<tr><td><a name="l174" href="#l174">174</a><td><tr><td><a name="l175" href="#l175">175</a><td><tr><td><a name="l176" href="#l176">176</a><td>/**<tr><td><a name="l177" href="#l177">177</a><td> * The ActiveX PROG ID string to use to create xhr&#39;s in IE. Lazily initialized.<tr><td><a name="l178" href="#l178">178</a><td> * @type {string|undefined}<tr><td><a name="l179" href="#l179">179</a><td> * @private<tr><td><a name="l180" href="#l180">180</a><td> */<tr><td><a name="l181" href="#l181">181</a><td>goog.net.DefaultXmlHttpFactory.prototype.ieProgId_;<tr><td><a name="l182" href="#l182">182</a><td><tr><td><a name="l183" href="#l183">183</a><td><tr><td><a name="l184" href="#l184">184</a><td>/**<tr><td><a name="l185" href="#l185">185</a><td> * Initialize the private state used by other functions.<tr><td><a name="l186" href="#l186">186</a><td> * @return {string} The ActiveX PROG ID string to use to create xhr&#39;s in IE.<tr><td><a name="l187" href="#l187">187</a><td> * @private<tr><td><a name="l188" href="#l188">188</a><td> */<tr><td><a name="l189" href="#l189">189</a><td>goog.net.DefaultXmlHttpFactory.prototype.getProgId_ = function() {<tr><td><a name="l190" href="#l190">190</a><td>  if (goog.net.XmlHttp.ASSUME_NATIVE_XHR) {<tr><td><a name="l191" href="#l191">191</a><td>    return &#39;&#39;;<tr><td><a name="l192" href="#l192">192</a><td>  }<tr><td><a name="l193" href="#l193">193</a><td><tr><td><a name="l194" href="#l194">194</a><td>  // The following blog post describes what PROG IDs to use to create the<tr><td><a name="l195" href="#l195">195</a><td>  // XMLHTTP object in Internet Explorer:<tr><td><a name="l196" href="#l196">196</a><td>  // http://blogs.msdn.com/xmlteam/archive/2006/10/23/using-the-right-version-of-msxml-in-internet-explorer.aspx<tr><td><a name="l197" href="#l197">197</a><td>  // However we do not (yet) fully trust that this will be OK for old versions<tr><td><a name="l198" href="#l198">198</a><td>  // of IE on Win9x so we therefore keep the last 2.<tr><td><a name="l199" href="#l199">199</a><td>  if (!this.ieProgId_ &amp;&amp; typeof XMLHttpRequest == &#39;undefined&#39; &amp;&amp;<tr><td><a name="l200" href="#l200">200</a><td>      typeof ActiveXObject != &#39;undefined&#39;) {<tr><td><a name="l201" href="#l201">201</a><td>    // Candidate Active X types.<tr><td><a name="l202" href="#l202">202</a><td>    var ACTIVE_X_IDENTS = [&#39;MSXML2.XMLHTTP.6.0&#39;, &#39;MSXML2.XMLHTTP.3.0&#39;,<tr><td><a name="l203" href="#l203">203</a><td>                           &#39;MSXML2.XMLHTTP&#39;, &#39;Microsoft.XMLHTTP&#39;];<tr><td><a name="l204" href="#l204">204</a><td>    for (var i = 0; i &lt; ACTIVE_X_IDENTS.length; i++) {<tr><td><a name="l205" href="#l205">205</a><td>      var candidate = ACTIVE_X_IDENTS[i];<tr><td><a name="l206" href="#l206">206</a><td>      /** @preserveTry */<tr><td><a name="l207" href="#l207">207</a><td>      try {<tr><td><a name="l208" href="#l208">208</a><td>        new ActiveXObject(candidate);<tr><td><a name="l209" href="#l209">209</a><td>        // NOTE(user): cannot assign progid and return candidate in one line<tr><td><a name="l210" href="#l210">210</a><td>        // because JSCompiler complaings: BUG 658126<tr><td><a name="l211" href="#l211">211</a><td>        this.ieProgId_ = candidate;<tr><td><a name="l212" href="#l212">212</a><td>        return candidate;<tr><td><a name="l213" href="#l213">213</a><td>      } catch (e) {<tr><td><a name="l214" href="#l214">214</a><td>        // do nothing; try next choice<tr><td><a name="l215" href="#l215">215</a><td>      }<tr><td><a name="l216" href="#l216">216</a><td>    }<tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>    // couldn&#39;t find any matches<tr><td><a name="l219" href="#l219">219</a><td>    throw Error(&#39;Could not create ActiveXObject. ActiveX might be disabled,&#39; +<tr><td><a name="l220" href="#l220">220</a><td>                &#39; or MSXML might not be installed&#39;);<tr><td><a name="l221" href="#l221">221</a><td>  }<tr><td><a name="l222" href="#l222">222</a><td><tr><td><a name="l223" href="#l223">223</a><td>  return /** @type {string} */ (this.ieProgId_);<tr><td><a name="l224" href="#l224">224</a><td>};<tr><td><a name="l225" href="#l225">225</a><td><tr><td><a name="l226" href="#l226">226</a><td><tr><td><a name="l227" href="#l227">227</a><td>//Set the global factory to an instance of the default factory.<tr><td><a name="l228" href="#l228">228</a><td>goog.net.XmlHttp.setGlobalFactory(new goog.net.DefaultXmlHttpFactory());</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>xmlhttp.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/net/xmlhttp.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Low level handling of XMLHttpRequest.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.net.DefaultXmlHttpFactory&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;goog.net.XmlHttp&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;goog.net.XmlHttp.OptionType&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.net.XmlHttp.ReadyState&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.net.XmlHttpDefines&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.net.WrapperXmlHttpFactory&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.net.XmlHttpFactory&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Static class for creating XMLHttpRequest objects.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @return {!goog.net.XhrLike.OrNative} A new XMLHttpRequest object.<tr><td><a id="l35"></a><a href="#l35">35</a><td> */<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.net.XmlHttp = function() {<tr><td><a id="l37"></a><a href="#l37">37</a><td>  return goog.net.XmlHttp.factory_.createInstance();<tr><td><a id="l38"></a><a href="#l38">38</a><td>};<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td>/**<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @define {boolean} Whether to assume XMLHttpRequest exists. Setting this to<tr><td><a id="l43"></a><a href="#l43">43</a><td> *     true bypasses the ActiveX probing code.<tr><td><a id="l44"></a><a href="#l44">44</a><td> * NOTE(ruilopes): Due to the way JSCompiler works, this define *will not* strip<tr><td><a id="l45"></a><a href="#l45">45</a><td> * out the ActiveX probing code from binaries.  To achieve this, use<tr><td><a id="l46"></a><a href="#l46">46</a><td> * {@code goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR} instead.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * TODO(ruilopes): Collapse both defines.<tr><td><a id="l48"></a><a href="#l48">48</a><td> */<tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.define(&#39;goog.net.XmlHttp.ASSUME_NATIVE_XHR&#39;, false);<tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td><tr><td><a id="l52"></a><a href="#l52">52</a><td>/** @const */<tr><td><a id="l53"></a><a href="#l53">53</a><td>goog.net.XmlHttpDefines = {};<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @define {boolean} Whether to assume XMLHttpRequest exists. Setting this to<tr><td><a id="l58"></a><a href="#l58">58</a><td> *     true eliminates the ActiveX probing code.<tr><td><a id="l59"></a><a href="#l59">59</a><td> */<tr><td><a id="l60"></a><a href="#l60">60</a><td>goog.define(&#39;goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR&#39;, false);<tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td>/**<tr><td><a id="l64"></a><a href="#l64">64</a><td> * Gets the options to use with the XMLHttpRequest objects obtained using<tr><td><a id="l65"></a><a href="#l65">65</a><td> * the static methods.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @return {Object} The options.<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td>goog.net.XmlHttp.getOptions = function() {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  return goog.net.XmlHttp.factory_.getOptions();<tr><td><a id="l70"></a><a href="#l70">70</a><td>};<tr><td><a id="l71"></a><a href="#l71">71</a><td><tr><td><a id="l72"></a><a href="#l72">72</a><td><tr><td><a id="l73"></a><a href="#l73">73</a><td>/**<tr><td><a id="l74"></a><a href="#l74">74</a><td> * Type of options that an XmlHttp object can have.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @enum {number}<tr><td><a id="l76"></a><a href="#l76">76</a><td> */<tr><td><a id="l77"></a><a href="#l77">77</a><td>goog.net.XmlHttp.OptionType = {<tr><td><a id="l78"></a><a href="#l78">78</a><td>  /**<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * Whether a goog.nullFunction should be used to clear the onreadystatechange<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * handler instead of null.<tr><td><a id="l81"></a><a href="#l81">81</a><td>   */<tr><td><a id="l82"></a><a href="#l82">82</a><td>  USE_NULL_FUNCTION: 0,<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td>  /**<tr><td><a id="l85"></a><a href="#l85">85</a><td>   * NOTE(user): In IE if send() errors on a *local* request the readystate<tr><td><a id="l86"></a><a href="#l86">86</a><td>   * is still changed to COMPLETE.  We need to ignore it and allow the<tr><td><a id="l87"></a><a href="#l87">87</a><td>   * try/catch around send() to pick up the error.<tr><td><a id="l88"></a><a href="#l88">88</a><td>   */<tr><td><a id="l89"></a><a href="#l89">89</a><td>  LOCAL_REQUEST_ERROR: 1<tr><td><a id="l90"></a><a href="#l90">90</a><td>};<tr><td><a id="l91"></a><a href="#l91">91</a><td><tr><td><a id="l92"></a><a href="#l92">92</a><td><tr><td><a id="l93"></a><a href="#l93">93</a><td>/**<tr><td><a id="l94"></a><a href="#l94">94</a><td> * Status constants for XMLHTTP, matches:<tr><td><a id="l95"></a><a href="#l95">95</a><td> * http://msdn.microsoft.com/library/default.asp?url=/library/<tr><td><a id="l96"></a><a href="#l96">96</a><td> *   en-us/xmlsdk/html/0e6a34e4-f90c-489d-acff-cb44242fafc6.asp<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @enum {number}<tr><td><a id="l98"></a><a href="#l98">98</a><td> */<tr><td><a id="l99"></a><a href="#l99">99</a><td>goog.net.XmlHttp.ReadyState = {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  /**<tr><td><a id="l101"></a><a href="#l101">101</a><td>   * Constant for when xmlhttprequest.readyState is uninitialized<tr><td><a id="l102"></a><a href="#l102">102</a><td>   */<tr><td><a id="l103"></a><a href="#l103">103</a><td>  UNINITIALIZED: 0,<tr><td><a id="l104"></a><a href="#l104">104</a><td><tr><td><a id="l105"></a><a href="#l105">105</a><td>  /**<tr><td><a id="l106"></a><a href="#l106">106</a><td>   * Constant for when xmlhttprequest.readyState is loading.<tr><td><a id="l107"></a><a href="#l107">107</a><td>   */<tr><td><a id="l108"></a><a href="#l108">108</a><td>  LOADING: 1,<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td>  /**<tr><td><a id="l111"></a><a href="#l111">111</a><td>   * Constant for when xmlhttprequest.readyState is loaded.<tr><td><a id="l112"></a><a href="#l112">112</a><td>   */<tr><td><a id="l113"></a><a href="#l113">113</a><td>  LOADED: 2,<tr><td><a id="l114"></a><a href="#l114">114</a><td><tr><td><a id="l115"></a><a href="#l115">115</a><td>  /**<tr><td><a id="l116"></a><a href="#l116">116</a><td>   * Constant for when xmlhttprequest.readyState is in an interactive state.<tr><td><a id="l117"></a><a href="#l117">117</a><td>   */<tr><td><a id="l118"></a><a href="#l118">118</a><td>  INTERACTIVE: 3,<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>  /**<tr><td><a id="l121"></a><a href="#l121">121</a><td>   * Constant for when xmlhttprequest.readyState is completed<tr><td><a id="l122"></a><a href="#l122">122</a><td>   */<tr><td><a id="l123"></a><a href="#l123">123</a><td>  COMPLETE: 4<tr><td><a id="l124"></a><a href="#l124">124</a><td>};<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td><tr><td><a id="l127"></a><a href="#l127">127</a><td>/**<tr><td><a id="l128"></a><a href="#l128">128</a><td> * The global factory instance for creating XMLHttpRequest objects.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @type {goog.net.XmlHttpFactory}<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @private<tr><td><a id="l131"></a><a href="#l131">131</a><td> */<tr><td><a id="l132"></a><a href="#l132">132</a><td>goog.net.XmlHttp.factory_;<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>/**<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Sets the factories for creating XMLHttpRequest objects and their options.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @param {Function} factory The factory for XMLHttpRequest objects.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @param {Function} optionsFactory The factory for options.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @deprecated Use setGlobalFactory instead.<tr><td><a id="l140"></a><a href="#l140">140</a><td> */<tr><td><a id="l141"></a><a href="#l141">141</a><td>goog.net.XmlHttp.setFactory = function(factory, optionsFactory) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  goog.net.XmlHttp.setGlobalFactory(new goog.net.WrapperXmlHttpFactory(<tr><td><a id="l143"></a><a href="#l143">143</a><td>      goog.asserts.assert(factory),<tr><td><a id="l144"></a><a href="#l144">144</a><td>      goog.asserts.assert(optionsFactory)));<tr><td><a id="l145"></a><a href="#l145">145</a><td>};<tr><td><a id="l146"></a><a href="#l146">146</a><td><tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td>/**<tr><td><a id="l149"></a><a href="#l149">149</a><td> * Sets the global factory object.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @param {!goog.net.XmlHttpFactory} factory New global factory object.<tr><td><a id="l151"></a><a href="#l151">151</a><td> */<tr><td><a id="l152"></a><a href="#l152">152</a><td>goog.net.XmlHttp.setGlobalFactory = function(factory) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>  goog.net.XmlHttp.factory_ = factory;<tr><td><a id="l154"></a><a href="#l154">154</a><td>};<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td>/**<tr><td><a id="l159"></a><a href="#l159">159</a><td> * Default factory to use when creating xhr objects.  You probably shouldn&#39;t be<tr><td><a id="l160"></a><a href="#l160">160</a><td> * instantiating this directly, but rather using it via goog.net.XmlHttp.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @extends {goog.net.XmlHttpFactory}<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @constructor<tr><td><a id="l163"></a><a href="#l163">163</a><td> */<tr><td><a id="l164"></a><a href="#l164">164</a><td>goog.net.DefaultXmlHttpFactory = function() {<tr><td><a id="l165"></a><a href="#l165">165</a><td>  goog.net.XmlHttpFactory.call(this);<tr><td><a id="l166"></a><a href="#l166">166</a><td>};<tr><td><a id="l167"></a><a href="#l167">167</a><td>goog.inherits(goog.net.DefaultXmlHttpFactory, goog.net.XmlHttpFactory);<tr><td><a id="l168"></a><a href="#l168">168</a><td><tr><td><a id="l169"></a><a href="#l169">169</a><td><tr><td><a id="l170"></a><a href="#l170">170</a><td>/** @override */<tr><td><a id="l171"></a><a href="#l171">171</a><td>goog.net.DefaultXmlHttpFactory.prototype.createInstance = function() {<tr><td><a id="l172"></a><a href="#l172">172</a><td>  var progId = this.getProgId_();<tr><td><a id="l173"></a><a href="#l173">173</a><td>  if (progId) {<tr><td><a id="l174"></a><a href="#l174">174</a><td>    return new ActiveXObject(progId);<tr><td><a id="l175"></a><a href="#l175">175</a><td>  } else {<tr><td><a id="l176"></a><a href="#l176">176</a><td>    return new XMLHttpRequest();<tr><td><a id="l177"></a><a href="#l177">177</a><td>  }<tr><td><a id="l178"></a><a href="#l178">178</a><td>};<tr><td><a id="l179"></a><a href="#l179">179</a><td><tr><td><a id="l180"></a><a href="#l180">180</a><td><tr><td><a id="l181"></a><a href="#l181">181</a><td>/** @override */<tr><td><a id="l182"></a><a href="#l182">182</a><td>goog.net.DefaultXmlHttpFactory.prototype.internalGetOptions = function() {<tr><td><a id="l183"></a><a href="#l183">183</a><td>  var progId = this.getProgId_();<tr><td><a id="l184"></a><a href="#l184">184</a><td>  var options = {};<tr><td><a id="l185"></a><a href="#l185">185</a><td>  if (progId) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>    options[goog.net.XmlHttp.OptionType.USE_NULL_FUNCTION] = true;<tr><td><a id="l187"></a><a href="#l187">187</a><td>    options[goog.net.XmlHttp.OptionType.LOCAL_REQUEST_ERROR] = true;<tr><td><a id="l188"></a><a href="#l188">188</a><td>  }<tr><td><a id="l189"></a><a href="#l189">189</a><td>  return options;<tr><td><a id="l190"></a><a href="#l190">190</a><td>};<tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td>/**<tr><td><a id="l194"></a><a href="#l194">194</a><td> * The ActiveX PROG ID string to use to create xhr&#39;s in IE. Lazily initialized.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @type {string|undefined}<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @private<tr><td><a id="l197"></a><a href="#l197">197</a><td> */<tr><td><a id="l198"></a><a href="#l198">198</a><td>goog.net.DefaultXmlHttpFactory.prototype.ieProgId_;<tr><td><a id="l199"></a><a href="#l199">199</a><td><tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td>/**<tr><td><a id="l202"></a><a href="#l202">202</a><td> * Initialize the private state used by other functions.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @return {string} The ActiveX PROG ID string to use to create xhr&#39;s in IE.<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @private<tr><td><a id="l205"></a><a href="#l205">205</a><td> */<tr><td><a id="l206"></a><a href="#l206">206</a><td>goog.net.DefaultXmlHttpFactory.prototype.getProgId_ = function() {<tr><td><a id="l207"></a><a href="#l207">207</a><td>  if (goog.net.XmlHttp.ASSUME_NATIVE_XHR ||<tr><td><a id="l208"></a><a href="#l208">208</a><td>      goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>    return &#39;&#39;;<tr><td><a id="l210"></a><a href="#l210">210</a><td>  }<tr><td><a id="l211"></a><a href="#l211">211</a><td><tr><td><a id="l212"></a><a href="#l212">212</a><td>  // The following blog post describes what PROG IDs to use to create the<tr><td><a id="l213"></a><a href="#l213">213</a><td>  // XMLHTTP object in Internet Explorer:<tr><td><a id="l214"></a><a href="#l214">214</a><td>  // http://blogs.msdn.com/xmlteam/archive/2006/10/23/using-the-right-version-of-msxml-in-internet-explorer.aspx<tr><td><a id="l215"></a><a href="#l215">215</a><td>  // However we do not (yet) fully trust that this will be OK for old versions<tr><td><a id="l216"></a><a href="#l216">216</a><td>  // of IE on Win9x so we therefore keep the last 2.<tr><td><a id="l217"></a><a href="#l217">217</a><td>  if (!this.ieProgId_ &amp;&amp; typeof XMLHttpRequest == &#39;undefined&#39; &amp;&amp;<tr><td><a id="l218"></a><a href="#l218">218</a><td>      typeof ActiveXObject != &#39;undefined&#39;) {<tr><td><a id="l219"></a><a href="#l219">219</a><td>    // Candidate Active X types.<tr><td><a id="l220"></a><a href="#l220">220</a><td>    var ACTIVE_X_IDENTS = [&#39;MSXML2.XMLHTTP.6.0&#39;, &#39;MSXML2.XMLHTTP.3.0&#39;,<tr><td><a id="l221"></a><a href="#l221">221</a><td>                           &#39;MSXML2.XMLHTTP&#39;, &#39;Microsoft.XMLHTTP&#39;];<tr><td><a id="l222"></a><a href="#l222">222</a><td>    for (var i = 0; i &lt; ACTIVE_X_IDENTS.length; i++) {<tr><td><a id="l223"></a><a href="#l223">223</a><td>      var candidate = ACTIVE_X_IDENTS[i];<tr><td><a id="l224"></a><a href="#l224">224</a><td>      /** @preserveTry */<tr><td><a id="l225"></a><a href="#l225">225</a><td>      try {<tr><td><a id="l226"></a><a href="#l226">226</a><td>        new ActiveXObject(candidate);<tr><td><a id="l227"></a><a href="#l227">227</a><td>        // NOTE(user): cannot assign progid and return candidate in one line<tr><td><a id="l228"></a><a href="#l228">228</a><td>        // because JSCompiler complaings: BUG 658126<tr><td><a id="l229"></a><a href="#l229">229</a><td>        this.ieProgId_ = candidate;<tr><td><a id="l230"></a><a href="#l230">230</a><td>        return candidate;<tr><td><a id="l231"></a><a href="#l231">231</a><td>      } catch (e) {<tr><td><a id="l232"></a><a href="#l232">232</a><td>        // do nothing; try next choice<tr><td><a id="l233"></a><a href="#l233">233</a><td>      }<tr><td><a id="l234"></a><a href="#l234">234</a><td>    }<tr><td><a id="l235"></a><a href="#l235">235</a><td><tr><td><a id="l236"></a><a href="#l236">236</a><td>    // couldn&#39;t find any matches<tr><td><a id="l237"></a><a href="#l237">237</a><td>    throw Error(&#39;Could not create ActiveXObject. ActiveX might be disabled,&#39; +<tr><td><a id="l238"></a><a href="#l238">238</a><td>                &#39; or MSXML might not be installed&#39;);<tr><td><a id="l239"></a><a href="#l239">239</a><td>  }<tr><td><a id="l240"></a><a href="#l240">240</a><td><tr><td><a id="l241"></a><a href="#l241">241</a><td>  return /** @type {string} */ (this.ieProgId_);<tr><td><a id="l242"></a><a href="#l242">242</a><td>};<tr><td><a id="l243"></a><a href="#l243">243</a><td><tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td>//Set the global factory to an instance of the default factory.<tr><td><a id="l246"></a><a href="#l246">246</a><td>goog.net.XmlHttp.setGlobalFactory(new goog.net.DefaultXmlHttpFactory());</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/net/xmlhttpfactory.js.src.html b/docs/source/lib/goog/net/xmlhttpfactory.js.src.html
index 09406c3..6dde268 100644
--- a/docs/source/lib/goog/net/xmlhttpfactory.js.src.html
+++ b/docs/source/lib/goog/net/xmlhttpfactory.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>xmlhttpfactory.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/net/xmlhttpfactory.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Interface for a factory for creating XMLHttpRequest objects<tr><td><a name="l17" href="#l17">17</a><td> * and metadata about them.<tr><td><a name="l18" href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<tr><td><a name="l19" href="#l19">19</a><td> */<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.net.XmlHttpFactory&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * Abstract base class for an XmlHttpRequest factory.<tr><td><a name="l27" href="#l27">27</a><td> * @constructor<tr><td><a name="l28" href="#l28">28</a><td> */<tr><td><a name="l29" href="#l29">29</a><td>goog.net.XmlHttpFactory = function() {<tr><td><a name="l30" href="#l30">30</a><td>};<tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td>/**<tr><td><a name="l34" href="#l34">34</a><td> * Cache of options - we only actually call internalGetOptions once.<tr><td><a name="l35" href="#l35">35</a><td> * @type {Object}<tr><td><a name="l36" href="#l36">36</a><td> * @private<tr><td><a name="l37" href="#l37">37</a><td> */<tr><td><a name="l38" href="#l38">38</a><td>goog.net.XmlHttpFactory.prototype.cachedOptions_ = null;<tr><td><a name="l39" href="#l39">39</a><td><tr><td><a name="l40" href="#l40">40</a><td><tr><td><a name="l41" href="#l41">41</a><td>/**<tr><td><a name="l42" href="#l42">42</a><td> * @return {!(XMLHttpRequest|GearsHttpRequest)} A new XMLHttpRequest instance.<tr><td><a name="l43" href="#l43">43</a><td> */<tr><td><a name="l44" href="#l44">44</a><td>goog.net.XmlHttpFactory.prototype.createInstance = goog.abstractMethod;<tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>/**<tr><td><a name="l48" href="#l48">48</a><td> * @return {Object} Options describing how xhr objects obtained from this<tr><td><a name="l49" href="#l49">49</a><td> *     factory should be used.<tr><td><a name="l50" href="#l50">50</a><td> */<tr><td><a name="l51" href="#l51">51</a><td>goog.net.XmlHttpFactory.prototype.getOptions = function() {<tr><td><a name="l52" href="#l52">52</a><td>  return this.cachedOptions_ ||<tr><td><a name="l53" href="#l53">53</a><td>      (this.cachedOptions_ = this.internalGetOptions());<tr><td><a name="l54" href="#l54">54</a><td>};<tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td>/**<tr><td><a name="l58" href="#l58">58</a><td> * Override this method in subclasses to preserve the caching offered by<tr><td><a name="l59" href="#l59">59</a><td> * getOptions().<tr><td><a name="l60" href="#l60">60</a><td> * @return {Object} Options describing how xhr objects obtained from this<tr><td><a name="l61" href="#l61">61</a><td> *     factory should be used.<tr><td><a name="l62" href="#l62">62</a><td> * @protected<tr><td><a name="l63" href="#l63">63</a><td> */<tr><td><a name="l64" href="#l64">64</a><td>goog.net.XmlHttpFactory.prototype.internalGetOptions = goog.abstractMethod;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>xmlhttpfactory.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/net/xmlhttpfactory.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Interface for a factory for creating XMLHttpRequest objects<tr><td><a id="l17"></a><a href="#l17">17</a><td> * and metadata about them.<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author dbk@google.com (David Barrett-Kahn)<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.net.XmlHttpFactory&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/** @suppress {extraRequire} Typedef. */<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.net.XhrLike&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Abstract base class for an XmlHttpRequest factory.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @constructor<tr><td><a id="l31"></a><a href="#l31">31</a><td> */<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.net.XmlHttpFactory = function() {<tr><td><a id="l33"></a><a href="#l33">33</a><td>};<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>/**<tr><td><a id="l37"></a><a href="#l37">37</a><td> * Cache of options - we only actually call internalGetOptions once.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @type {Object}<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @private<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.net.XmlHttpFactory.prototype.cachedOptions_ = null;<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>/**<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @return {!goog.net.XhrLike.OrNative} A new XhrLike instance.<tr><td><a id="l46"></a><a href="#l46">46</a><td> */<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.net.XmlHttpFactory.prototype.createInstance = goog.abstractMethod;<tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td>/**<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @return {Object} Options describing how xhr objects obtained from this<tr><td><a id="l52"></a><a href="#l52">52</a><td> *     factory should be used.<tr><td><a id="l53"></a><a href="#l53">53</a><td> */<tr><td><a id="l54"></a><a href="#l54">54</a><td>goog.net.XmlHttpFactory.prototype.getOptions = function() {<tr><td><a id="l55"></a><a href="#l55">55</a><td>  return this.cachedOptions_ ||<tr><td><a id="l56"></a><a href="#l56">56</a><td>      (this.cachedOptions_ = this.internalGetOptions());<tr><td><a id="l57"></a><a href="#l57">57</a><td>};<tr><td><a id="l58"></a><a href="#l58">58</a><td><tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td>/**<tr><td><a id="l61"></a><a href="#l61">61</a><td> * Override this method in subclasses to preserve the caching offered by<tr><td><a id="l62"></a><a href="#l62">62</a><td> * getOptions().<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @return {Object} Options describing how xhr objects obtained from this<tr><td><a id="l64"></a><a href="#l64">64</a><td> *     factory should be used.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @protected<tr><td><a id="l66"></a><a href="#l66">66</a><td> */<tr><td><a id="l67"></a><a href="#l67">67</a><td>goog.net.XmlHttpFactory.prototype.internalGetOptions = goog.abstractMethod;</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/object/object.js.src.html b/docs/source/lib/goog/object/object.js.src.html
index a9b8f59..57141fb 100644
--- a/docs/source/lib/goog/object/object.js.src.html
+++ b/docs/source/lib/goog/object/object.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>object.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/object/object.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Utilities for manipulating objects/maps/hashes.<tr><td><a name="l17" href="#l17">17</a><td> */<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.provide(&#39;goog.object&#39;);<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>/**<tr><td><a name="l23" href="#l23">23</a><td> * Calls a function for each element in an object/map/hash.<tr><td><a name="l24" href="#l24">24</a><td> *<tr><td><a name="l25" href="#l25">25</a><td> * @param {Object.&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a name="l26" href="#l26">26</a><td> * @param {function(this:T,V,?,Object.&lt;K,V&gt;):?} f The function to call<tr><td><a name="l27" href="#l27">27</a><td> *     for every element. This function takes 3 arguments (the element, the<tr><td><a name="l28" href="#l28">28</a><td> *     index and the object) and the return value is ignored.<tr><td><a name="l29" href="#l29">29</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a name="l30" href="#l30">30</a><td> * @template T,K,V<tr><td><a name="l31" href="#l31">31</a><td> */<tr><td><a name="l32" href="#l32">32</a><td>goog.object.forEach = function(obj, f, opt_obj) {<tr><td><a name="l33" href="#l33">33</a><td>  for (var key in obj) {<tr><td><a name="l34" href="#l34">34</a><td>    f.call(opt_obj, obj[key], key, obj);<tr><td><a name="l35" href="#l35">35</a><td>  }<tr><td><a name="l36" href="#l36">36</a><td>};<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>/**<tr><td><a name="l40" href="#l40">40</a><td> * Calls a function for each element in an object/map/hash. If that call returns<tr><td><a name="l41" href="#l41">41</a><td> * true, adds the element to a new object.<tr><td><a name="l42" href="#l42">42</a><td> *<tr><td><a name="l43" href="#l43">43</a><td> * @param {Object.&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a name="l44" href="#l44">44</a><td> * @param {function(this:T,V,?,Object.&lt;K,V&gt;):boolean} f The function to call<tr><td><a name="l45" href="#l45">45</a><td> *     for every element. This<tr><td><a name="l46" href="#l46">46</a><td> *     function takes 3 arguments (the element, the index and the object)<tr><td><a name="l47" href="#l47">47</a><td> *     and should return a boolean. If the return value is true the<tr><td><a name="l48" href="#l48">48</a><td> *     element is added to the result object. If it is false the<tr><td><a name="l49" href="#l49">49</a><td> *     element is not included.<tr><td><a name="l50" href="#l50">50</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a name="l51" href="#l51">51</a><td> * @return {!Object.&lt;K,V&gt;} a new object in which only elements that passed the<tr><td><a name="l52" href="#l52">52</a><td> *     test are present.<tr><td><a name="l53" href="#l53">53</a><td> * @template T,K,V<tr><td><a name="l54" href="#l54">54</a><td> */<tr><td><a name="l55" href="#l55">55</a><td>goog.object.filter = function(obj, f, opt_obj) {<tr><td><a name="l56" href="#l56">56</a><td>  var res = {};<tr><td><a name="l57" href="#l57">57</a><td>  for (var key in obj) {<tr><td><a name="l58" href="#l58">58</a><td>    if (f.call(opt_obj, obj[key], key, obj)) {<tr><td><a name="l59" href="#l59">59</a><td>      res[key] = obj[key];<tr><td><a name="l60" href="#l60">60</a><td>    }<tr><td><a name="l61" href="#l61">61</a><td>  }<tr><td><a name="l62" href="#l62">62</a><td>  return res;<tr><td><a name="l63" href="#l63">63</a><td>};<tr><td><a name="l64" href="#l64">64</a><td><tr><td><a name="l65" href="#l65">65</a><td><tr><td><a name="l66" href="#l66">66</a><td>/**<tr><td><a name="l67" href="#l67">67</a><td> * For every element in an object/map/hash calls a function and inserts the<tr><td><a name="l68" href="#l68">68</a><td> * result into a new object.<tr><td><a name="l69" href="#l69">69</a><td> *<tr><td><a name="l70" href="#l70">70</a><td> * @param {Object.&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a name="l71" href="#l71">71</a><td> * @param {function(this:T,V,?,Object.&lt;K,V&gt;):R} f The function to call<tr><td><a name="l72" href="#l72">72</a><td> *     for every element. This function<tr><td><a name="l73" href="#l73">73</a><td> *     takes 3 arguments (the element, the index and the object)<tr><td><a name="l74" href="#l74">74</a><td> *     and should return something. The result will be inserted<tr><td><a name="l75" href="#l75">75</a><td> *     into a new object.<tr><td><a name="l76" href="#l76">76</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a name="l77" href="#l77">77</a><td> * @return {!Object.&lt;K,R&gt;} a new object with the results from f.<tr><td><a name="l78" href="#l78">78</a><td> * @template T,K,V,R<tr><td><a name="l79" href="#l79">79</a><td> */<tr><td><a name="l80" href="#l80">80</a><td>goog.object.map = function(obj, f, opt_obj) {<tr><td><a name="l81" href="#l81">81</a><td>  var res = {};<tr><td><a name="l82" href="#l82">82</a><td>  for (var key in obj) {<tr><td><a name="l83" href="#l83">83</a><td>    res[key] = f.call(opt_obj, obj[key], key, obj);<tr><td><a name="l84" href="#l84">84</a><td>  }<tr><td><a name="l85" href="#l85">85</a><td>  return res;<tr><td><a name="l86" href="#l86">86</a><td>};<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>/**<tr><td><a name="l90" href="#l90">90</a><td> * Calls a function for each element in an object/map/hash. If any<tr><td><a name="l91" href="#l91">91</a><td> * call returns true, returns true (without checking the rest). If<tr><td><a name="l92" href="#l92">92</a><td> * all calls return false, returns false.<tr><td><a name="l93" href="#l93">93</a><td> *<tr><td><a name="l94" href="#l94">94</a><td> * @param {Object.&lt;K,V&gt;} obj The object to check.<tr><td><a name="l95" href="#l95">95</a><td> * @param {function(this:T,V,?,Object.&lt;K,V&gt;):boolean} f The function to<tr><td><a name="l96" href="#l96">96</a><td> *     call for every element. This function<tr><td><a name="l97" href="#l97">97</a><td> *     takes 3 arguments (the element, the index and the object) and should<tr><td><a name="l98" href="#l98">98</a><td> *     return a boolean.<tr><td><a name="l99" href="#l99">99</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a name="l100" href="#l100">100</a><td> * @return {boolean} true if any element passes the test.<tr><td><a name="l101" href="#l101">101</a><td> * @template T,K,V<tr><td><a name="l102" href="#l102">102</a><td> */<tr><td><a name="l103" href="#l103">103</a><td>goog.object.some = function(obj, f, opt_obj) {<tr><td><a name="l104" href="#l104">104</a><td>  for (var key in obj) {<tr><td><a name="l105" href="#l105">105</a><td>    if (f.call(opt_obj, obj[key], key, obj)) {<tr><td><a name="l106" href="#l106">106</a><td>      return true;<tr><td><a name="l107" href="#l107">107</a><td>    }<tr><td><a name="l108" href="#l108">108</a><td>  }<tr><td><a name="l109" href="#l109">109</a><td>  return false;<tr><td><a name="l110" href="#l110">110</a><td>};<tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td>/**<tr><td><a name="l114" href="#l114">114</a><td> * Calls a function for each element in an object/map/hash. If<tr><td><a name="l115" href="#l115">115</a><td> * all calls return true, returns true. If any call returns false, returns<tr><td><a name="l116" href="#l116">116</a><td> * false at this point and does not continue to check the remaining elements.<tr><td><a name="l117" href="#l117">117</a><td> *<tr><td><a name="l118" href="#l118">118</a><td> * @param {Object.&lt;K,V&gt;} obj The object to check.<tr><td><a name="l119" href="#l119">119</a><td> * @param {?function(this:T,V,?,Object.&lt;K,V&gt;):boolean} f The function to<tr><td><a name="l120" href="#l120">120</a><td> *     call for every element. This function<tr><td><a name="l121" href="#l121">121</a><td> *     takes 3 arguments (the element, the index and the object) and should<tr><td><a name="l122" href="#l122">122</a><td> *     return a boolean.<tr><td><a name="l123" href="#l123">123</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a name="l124" href="#l124">124</a><td> * @return {boolean} false if any element fails the test.<tr><td><a name="l125" href="#l125">125</a><td> * @template T,K,V<tr><td><a name="l126" href="#l126">126</a><td> */<tr><td><a name="l127" href="#l127">127</a><td>goog.object.every = function(obj, f, opt_obj) {<tr><td><a name="l128" href="#l128">128</a><td>  for (var key in obj) {<tr><td><a name="l129" href="#l129">129</a><td>    if (!f.call(opt_obj, obj[key], key, obj)) {<tr><td><a name="l130" href="#l130">130</a><td>      return false;<tr><td><a name="l131" href="#l131">131</a><td>    }<tr><td><a name="l132" href="#l132">132</a><td>  }<tr><td><a name="l133" href="#l133">133</a><td>  return true;<tr><td><a name="l134" href="#l134">134</a><td>};<tr><td><a name="l135" href="#l135">135</a><td><tr><td><a name="l136" href="#l136">136</a><td><tr><td><a name="l137" href="#l137">137</a><td>/**<tr><td><a name="l138" href="#l138">138</a><td> * Returns the number of key-value pairs in the object map.<tr><td><a name="l139" href="#l139">139</a><td> *<tr><td><a name="l140" href="#l140">140</a><td> * @param {Object} obj The object for which to get the number of key-value<tr><td><a name="l141" href="#l141">141</a><td> *     pairs.<tr><td><a name="l142" href="#l142">142</a><td> * @return {number} The number of key-value pairs in the object map.<tr><td><a name="l143" href="#l143">143</a><td> */<tr><td><a name="l144" href="#l144">144</a><td>goog.object.getCount = function(obj) {<tr><td><a name="l145" href="#l145">145</a><td>  // JS1.5 has __count__ but it has been deprecated so it raises a warning...<tr><td><a name="l146" href="#l146">146</a><td>  // in other words do not use. Also __count__ only includes the fields on the<tr><td><a name="l147" href="#l147">147</a><td>  // actual object and not in the prototype chain.<tr><td><a name="l148" href="#l148">148</a><td>  var rv = 0;<tr><td><a name="l149" href="#l149">149</a><td>  for (var key in obj) {<tr><td><a name="l150" href="#l150">150</a><td>    rv++;<tr><td><a name="l151" href="#l151">151</a><td>  }<tr><td><a name="l152" href="#l152">152</a><td>  return rv;<tr><td><a name="l153" href="#l153">153</a><td>};<tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td><tr><td><a name="l156" href="#l156">156</a><td>/**<tr><td><a name="l157" href="#l157">157</a><td> * Returns one key from the object map, if any exists.<tr><td><a name="l158" href="#l158">158</a><td> * For map literals the returned key will be the first one in most of the<tr><td><a name="l159" href="#l159">159</a><td> * browsers (a know exception is Konqueror).<tr><td><a name="l160" href="#l160">160</a><td> *<tr><td><a name="l161" href="#l161">161</a><td> * @param {Object} obj The object to pick a key from.<tr><td><a name="l162" href="#l162">162</a><td> * @return {string|undefined} The key or undefined if the object is empty.<tr><td><a name="l163" href="#l163">163</a><td> */<tr><td><a name="l164" href="#l164">164</a><td>goog.object.getAnyKey = function(obj) {<tr><td><a name="l165" href="#l165">165</a><td>  for (var key in obj) {<tr><td><a name="l166" href="#l166">166</a><td>    return key;<tr><td><a name="l167" href="#l167">167</a><td>  }<tr><td><a name="l168" href="#l168">168</a><td>};<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/**<tr><td><a name="l172" href="#l172">172</a><td> * Returns one value from the object map, if any exists.<tr><td><a name="l173" href="#l173">173</a><td> * For map literals the returned value will be the first one in most of the<tr><td><a name="l174" href="#l174">174</a><td> * browsers (a know exception is Konqueror).<tr><td><a name="l175" href="#l175">175</a><td> *<tr><td><a name="l176" href="#l176">176</a><td> * @param {Object.&lt;K,V&gt;} obj The object to pick a value from.<tr><td><a name="l177" href="#l177">177</a><td> * @return {V|undefined} The value or undefined if the object is empty.<tr><td><a name="l178" href="#l178">178</a><td> * @template K,V<tr><td><a name="l179" href="#l179">179</a><td> */<tr><td><a name="l180" href="#l180">180</a><td>goog.object.getAnyValue = function(obj) {<tr><td><a name="l181" href="#l181">181</a><td>  for (var key in obj) {<tr><td><a name="l182" href="#l182">182</a><td>    return obj[key];<tr><td><a name="l183" href="#l183">183</a><td>  }<tr><td><a name="l184" href="#l184">184</a><td>};<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td>/**<tr><td><a name="l188" href="#l188">188</a><td> * Whether the object/hash/map contains the given object as a value.<tr><td><a name="l189" href="#l189">189</a><td> * An alias for goog.object.containsValue(obj, val).<tr><td><a name="l190" href="#l190">190</a><td> *<tr><td><a name="l191" href="#l191">191</a><td> * @param {Object.&lt;K,V&gt;} obj The object in which to look for val.<tr><td><a name="l192" href="#l192">192</a><td> * @param {V} val The object for which to check.<tr><td><a name="l193" href="#l193">193</a><td> * @return {boolean} true if val is present.<tr><td><a name="l194" href="#l194">194</a><td> * @template K,V<tr><td><a name="l195" href="#l195">195</a><td> */<tr><td><a name="l196" href="#l196">196</a><td>goog.object.contains = function(obj, val) {<tr><td><a name="l197" href="#l197">197</a><td>  return goog.object.containsValue(obj, val);<tr><td><a name="l198" href="#l198">198</a><td>};<tr><td><a name="l199" href="#l199">199</a><td><tr><td><a name="l200" href="#l200">200</a><td><tr><td><a name="l201" href="#l201">201</a><td>/**<tr><td><a name="l202" href="#l202">202</a><td> * Returns the values of the object/map/hash.<tr><td><a name="l203" href="#l203">203</a><td> *<tr><td><a name="l204" href="#l204">204</a><td> * @param {Object.&lt;K,V&gt;} obj The object from which to get the values.<tr><td><a name="l205" href="#l205">205</a><td> * @return {!Array.&lt;V&gt;} The values in the object/map/hash.<tr><td><a name="l206" href="#l206">206</a><td> * @template K,V<tr><td><a name="l207" href="#l207">207</a><td> */<tr><td><a name="l208" href="#l208">208</a><td>goog.object.getValues = function(obj) {<tr><td><a name="l209" href="#l209">209</a><td>  var res = [];<tr><td><a name="l210" href="#l210">210</a><td>  var i = 0;<tr><td><a name="l211" href="#l211">211</a><td>  for (var key in obj) {<tr><td><a name="l212" href="#l212">212</a><td>    res[i++] = obj[key];<tr><td><a name="l213" href="#l213">213</a><td>  }<tr><td><a name="l214" href="#l214">214</a><td>  return res;<tr><td><a name="l215" href="#l215">215</a><td>};<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * Returns the keys of the object/map/hash.<tr><td><a name="l220" href="#l220">220</a><td> *<tr><td><a name="l221" href="#l221">221</a><td> * @param {Object} obj The object from which to get the keys.<tr><td><a name="l222" href="#l222">222</a><td> * @return {!Array.&lt;string&gt;} Array of property keys.<tr><td><a name="l223" href="#l223">223</a><td> */<tr><td><a name="l224" href="#l224">224</a><td>goog.object.getKeys = function(obj) {<tr><td><a name="l225" href="#l225">225</a><td>  var res = [];<tr><td><a name="l226" href="#l226">226</a><td>  var i = 0;<tr><td><a name="l227" href="#l227">227</a><td>  for (var key in obj) {<tr><td><a name="l228" href="#l228">228</a><td>    res[i++] = key;<tr><td><a name="l229" href="#l229">229</a><td>  }<tr><td><a name="l230" href="#l230">230</a><td>  return res;<tr><td><a name="l231" href="#l231">231</a><td>};<tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td>/**<tr><td><a name="l235" href="#l235">235</a><td> * Get a value from an object multiple levels deep.  This is useful for<tr><td><a name="l236" href="#l236">236</a><td> * pulling values from deeply nested objects, such as JSON responses.<tr><td><a name="l237" href="#l237">237</a><td> * Example usage: getValueByKeys(jsonObj, &#39;foo&#39;, &#39;entries&#39;, 3)<tr><td><a name="l238" href="#l238">238</a><td> *<tr><td><a name="l239" href="#l239">239</a><td> * @param {!Object} obj An object to get the value from.  Can be array-like.<tr><td><a name="l240" href="#l240">240</a><td> * @param {...(string|number|!Array.&lt;number|string&gt;)} var_args A number of keys<tr><td><a name="l241" href="#l241">241</a><td> *     (as strings, or numbers, for array-like objects).  Can also be<tr><td><a name="l242" href="#l242">242</a><td> *     specified as a single array of keys.<tr><td><a name="l243" href="#l243">243</a><td> * @return {*} The resulting value.  If, at any point, the value for a key<tr><td><a name="l244" href="#l244">244</a><td> *     is undefined, returns undefined.<tr><td><a name="l245" href="#l245">245</a><td> */<tr><td><a name="l246" href="#l246">246</a><td>goog.object.getValueByKeys = function(obj, var_args) {<tr><td><a name="l247" href="#l247">247</a><td>  var isArrayLike = goog.isArrayLike(var_args);<tr><td><a name="l248" href="#l248">248</a><td>  var keys = isArrayLike ? var_args : arguments;<tr><td><a name="l249" href="#l249">249</a><td><tr><td><a name="l250" href="#l250">250</a><td>  // Start with the 2nd parameter for the variable parameters syntax.<tr><td><a name="l251" href="#l251">251</a><td>  for (var i = isArrayLike ? 0 : 1; i &lt; keys.length; i++) {<tr><td><a name="l252" href="#l252">252</a><td>    obj = obj[keys[i]];<tr><td><a name="l253" href="#l253">253</a><td>    if (!goog.isDef(obj)) {<tr><td><a name="l254" href="#l254">254</a><td>      break;<tr><td><a name="l255" href="#l255">255</a><td>    }<tr><td><a name="l256" href="#l256">256</a><td>  }<tr><td><a name="l257" href="#l257">257</a><td><tr><td><a name="l258" href="#l258">258</a><td>  return obj;<tr><td><a name="l259" href="#l259">259</a><td>};<tr><td><a name="l260" href="#l260">260</a><td><tr><td><a name="l261" href="#l261">261</a><td><tr><td><a name="l262" href="#l262">262</a><td>/**<tr><td><a name="l263" href="#l263">263</a><td> * Whether the object/map/hash contains the given key.<tr><td><a name="l264" href="#l264">264</a><td> *<tr><td><a name="l265" href="#l265">265</a><td> * @param {Object} obj The object in which to look for key.<tr><td><a name="l266" href="#l266">266</a><td> * @param {*} key The key for which to check.<tr><td><a name="l267" href="#l267">267</a><td> * @return {boolean} true If the map contains the key.<tr><td><a name="l268" href="#l268">268</a><td> */<tr><td><a name="l269" href="#l269">269</a><td>goog.object.containsKey = function(obj, key) {<tr><td><a name="l270" href="#l270">270</a><td>  return key in obj;<tr><td><a name="l271" href="#l271">271</a><td>};<tr><td><a name="l272" href="#l272">272</a><td><tr><td><a name="l273" href="#l273">273</a><td><tr><td><a name="l274" href="#l274">274</a><td>/**<tr><td><a name="l275" href="#l275">275</a><td> * Whether the object/map/hash contains the given value. This is O(n).<tr><td><a name="l276" href="#l276">276</a><td> *<tr><td><a name="l277" href="#l277">277</a><td> * @param {Object.&lt;K,V&gt;} obj The object in which to look for val.<tr><td><a name="l278" href="#l278">278</a><td> * @param {V} val The value for which to check.<tr><td><a name="l279" href="#l279">279</a><td> * @return {boolean} true If the map contains the value.<tr><td><a name="l280" href="#l280">280</a><td> * @template K,V<tr><td><a name="l281" href="#l281">281</a><td> */<tr><td><a name="l282" href="#l282">282</a><td>goog.object.containsValue = function(obj, val) {<tr><td><a name="l283" href="#l283">283</a><td>  for (var key in obj) {<tr><td><a name="l284" href="#l284">284</a><td>    if (obj[key] == val) {<tr><td><a name="l285" href="#l285">285</a><td>      return true;<tr><td><a name="l286" href="#l286">286</a><td>    }<tr><td><a name="l287" href="#l287">287</a><td>  }<tr><td><a name="l288" href="#l288">288</a><td>  return false;<tr><td><a name="l289" href="#l289">289</a><td>};<tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td><tr><td><a name="l292" href="#l292">292</a><td>/**<tr><td><a name="l293" href="#l293">293</a><td> * Searches an object for an element that satisfies the given condition and<tr><td><a name="l294" href="#l294">294</a><td> * returns its key.<tr><td><a name="l295" href="#l295">295</a><td> * @param {Object.&lt;K,V&gt;} obj The object to search in.<tr><td><a name="l296" href="#l296">296</a><td> * @param {function(this:T,V,string,Object.&lt;K,V&gt;):boolean} f The<tr><td><a name="l297" href="#l297">297</a><td> *      function to call for every element. Takes 3 arguments (the value,<tr><td><a name="l298" href="#l298">298</a><td> *     the key and the object) and should return a boolean.<tr><td><a name="l299" href="#l299">299</a><td> * @param {T=} opt_this An optional &quot;this&quot; context for the function.<tr><td><a name="l300" href="#l300">300</a><td> * @return {string|undefined} The key of an element for which the function<tr><td><a name="l301" href="#l301">301</a><td> *     returns true or undefined if no such element is found.<tr><td><a name="l302" href="#l302">302</a><td> * @template T,K,V<tr><td><a name="l303" href="#l303">303</a><td> */<tr><td><a name="l304" href="#l304">304</a><td>goog.object.findKey = function(obj, f, opt_this) {<tr><td><a name="l305" href="#l305">305</a><td>  for (var key in obj) {<tr><td><a name="l306" href="#l306">306</a><td>    if (f.call(opt_this, obj[key], key, obj)) {<tr><td><a name="l307" href="#l307">307</a><td>      return key;<tr><td><a name="l308" href="#l308">308</a><td>    }<tr><td><a name="l309" href="#l309">309</a><td>  }<tr><td><a name="l310" href="#l310">310</a><td>  return undefined;<tr><td><a name="l311" href="#l311">311</a><td>};<tr><td><a name="l312" href="#l312">312</a><td><tr><td><a name="l313" href="#l313">313</a><td><tr><td><a name="l314" href="#l314">314</a><td>/**<tr><td><a name="l315" href="#l315">315</a><td> * Searches an object for an element that satisfies the given condition and<tr><td><a name="l316" href="#l316">316</a><td> * returns its value.<tr><td><a name="l317" href="#l317">317</a><td> * @param {Object.&lt;K,V&gt;} obj The object to search in.<tr><td><a name="l318" href="#l318">318</a><td> * @param {function(this:T,V,string,Object.&lt;K,V&gt;):boolean} f The function<tr><td><a name="l319" href="#l319">319</a><td> *     to call for every element. Takes 3 arguments (the value, the key<tr><td><a name="l320" href="#l320">320</a><td> *     and the object) and should return a boolean.<tr><td><a name="l321" href="#l321">321</a><td> * @param {T=} opt_this An optional &quot;this&quot; context for the function.<tr><td><a name="l322" href="#l322">322</a><td> * @return {V} The value of an element for which the function returns true or<tr><td><a name="l323" href="#l323">323</a><td> *     undefined if no such element is found.<tr><td><a name="l324" href="#l324">324</a><td> * @template T,K,V<tr><td><a name="l325" href="#l325">325</a><td> */<tr><td><a name="l326" href="#l326">326</a><td>goog.object.findValue = function(obj, f, opt_this) {<tr><td><a name="l327" href="#l327">327</a><td>  var key = goog.object.findKey(obj, f, opt_this);<tr><td><a name="l328" href="#l328">328</a><td>  return key &amp;&amp; obj[key];<tr><td><a name="l329" href="#l329">329</a><td>};<tr><td><a name="l330" href="#l330">330</a><td><tr><td><a name="l331" href="#l331">331</a><td><tr><td><a name="l332" href="#l332">332</a><td>/**<tr><td><a name="l333" href="#l333">333</a><td> * Whether the object/map/hash is empty.<tr><td><a name="l334" href="#l334">334</a><td> *<tr><td><a name="l335" href="#l335">335</a><td> * @param {Object} obj The object to test.<tr><td><a name="l336" href="#l336">336</a><td> * @return {boolean} true if obj is empty.<tr><td><a name="l337" href="#l337">337</a><td> */<tr><td><a name="l338" href="#l338">338</a><td>goog.object.isEmpty = function(obj) {<tr><td><a name="l339" href="#l339">339</a><td>  for (var key in obj) {<tr><td><a name="l340" href="#l340">340</a><td>    return false;<tr><td><a name="l341" href="#l341">341</a><td>  }<tr><td><a name="l342" href="#l342">342</a><td>  return true;<tr><td><a name="l343" href="#l343">343</a><td>};<tr><td><a name="l344" href="#l344">344</a><td><tr><td><a name="l345" href="#l345">345</a><td><tr><td><a name="l346" href="#l346">346</a><td>/**<tr><td><a name="l347" href="#l347">347</a><td> * Removes all key value pairs from the object/map/hash.<tr><td><a name="l348" href="#l348">348</a><td> *<tr><td><a name="l349" href="#l349">349</a><td> * @param {Object} obj The object to clear.<tr><td><a name="l350" href="#l350">350</a><td> */<tr><td><a name="l351" href="#l351">351</a><td>goog.object.clear = function(obj) {<tr><td><a name="l352" href="#l352">352</a><td>  for (var i in obj) {<tr><td><a name="l353" href="#l353">353</a><td>    delete obj[i];<tr><td><a name="l354" href="#l354">354</a><td>  }<tr><td><a name="l355" href="#l355">355</a><td>};<tr><td><a name="l356" href="#l356">356</a><td><tr><td><a name="l357" href="#l357">357</a><td><tr><td><a name="l358" href="#l358">358</a><td>/**<tr><td><a name="l359" href="#l359">359</a><td> * Removes a key-value pair based on the key.<tr><td><a name="l360" href="#l360">360</a><td> *<tr><td><a name="l361" href="#l361">361</a><td> * @param {Object} obj The object from which to remove the key.<tr><td><a name="l362" href="#l362">362</a><td> * @param {*} key The key to remove.<tr><td><a name="l363" href="#l363">363</a><td> * @return {boolean} Whether an element was removed.<tr><td><a name="l364" href="#l364">364</a><td> */<tr><td><a name="l365" href="#l365">365</a><td>goog.object.remove = function(obj, key) {<tr><td><a name="l366" href="#l366">366</a><td>  var rv;<tr><td><a name="l367" href="#l367">367</a><td>  if ((rv = key in obj)) {<tr><td><a name="l368" href="#l368">368</a><td>    delete obj[key];<tr><td><a name="l369" href="#l369">369</a><td>  }<tr><td><a name="l370" href="#l370">370</a><td>  return rv;<tr><td><a name="l371" href="#l371">371</a><td>};<tr><td><a name="l372" href="#l372">372</a><td><tr><td><a name="l373" href="#l373">373</a><td><tr><td><a name="l374" href="#l374">374</a><td>/**<tr><td><a name="l375" href="#l375">375</a><td> * Adds a key-value pair to the object. Throws an exception if the key is<tr><td><a name="l376" href="#l376">376</a><td> * already in use. Use set if you want to change an existing pair.<tr><td><a name="l377" href="#l377">377</a><td> *<tr><td><a name="l378" href="#l378">378</a><td> * @param {Object.&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a name="l379" href="#l379">379</a><td> * @param {string} key The key to add.<tr><td><a name="l380" href="#l380">380</a><td> * @param {V} val The value to add.<tr><td><a name="l381" href="#l381">381</a><td> * @template K,V<tr><td><a name="l382" href="#l382">382</a><td> */<tr><td><a name="l383" href="#l383">383</a><td>goog.object.add = function(obj, key, val) {<tr><td><a name="l384" href="#l384">384</a><td>  if (key in obj) {<tr><td><a name="l385" href="#l385">385</a><td>    throw Error(&#39;The object already contains the key &quot;&#39; + key + &#39;&quot;&#39;);<tr><td><a name="l386" href="#l386">386</a><td>  }<tr><td><a name="l387" href="#l387">387</a><td>  goog.object.set(obj, key, val);<tr><td><a name="l388" href="#l388">388</a><td>};<tr><td><a name="l389" href="#l389">389</a><td><tr><td><a name="l390" href="#l390">390</a><td><tr><td><a name="l391" href="#l391">391</a><td>/**<tr><td><a name="l392" href="#l392">392</a><td> * Returns the value for the given key.<tr><td><a name="l393" href="#l393">393</a><td> *<tr><td><a name="l394" href="#l394">394</a><td> * @param {Object.&lt;K,V&gt;} obj The object from which to get the value.<tr><td><a name="l395" href="#l395">395</a><td> * @param {string} key The key for which to get the value.<tr><td><a name="l396" href="#l396">396</a><td> * @param {R=} opt_val The value to return if no item is found for the given<tr><td><a name="l397" href="#l397">397</a><td> *     key (default is undefined).<tr><td><a name="l398" href="#l398">398</a><td> * @return {V|R|undefined} The value for the given key.<tr><td><a name="l399" href="#l399">399</a><td> * @template K,V,R<tr><td><a name="l400" href="#l400">400</a><td> */<tr><td><a name="l401" href="#l401">401</a><td>goog.object.get = function(obj, key, opt_val) {<tr><td><a name="l402" href="#l402">402</a><td>  if (key in obj) {<tr><td><a name="l403" href="#l403">403</a><td>    return obj[key];<tr><td><a name="l404" href="#l404">404</a><td>  }<tr><td><a name="l405" href="#l405">405</a><td>  return opt_val;<tr><td><a name="l406" href="#l406">406</a><td>};<tr><td><a name="l407" href="#l407">407</a><td><tr><td><a name="l408" href="#l408">408</a><td><tr><td><a name="l409" href="#l409">409</a><td>/**<tr><td><a name="l410" href="#l410">410</a><td> * Adds a key-value pair to the object/map/hash.<tr><td><a name="l411" href="#l411">411</a><td> *<tr><td><a name="l412" href="#l412">412</a><td> * @param {Object.&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a name="l413" href="#l413">413</a><td> * @param {string} key The key to add.<tr><td><a name="l414" href="#l414">414</a><td> * @param {V} value The value to add.<tr><td><a name="l415" href="#l415">415</a><td> * @template K,V<tr><td><a name="l416" href="#l416">416</a><td> */<tr><td><a name="l417" href="#l417">417</a><td>goog.object.set = function(obj, key, value) {<tr><td><a name="l418" href="#l418">418</a><td>  obj[key] = value;<tr><td><a name="l419" href="#l419">419</a><td>};<tr><td><a name="l420" href="#l420">420</a><td><tr><td><a name="l421" href="#l421">421</a><td><tr><td><a name="l422" href="#l422">422</a><td>/**<tr><td><a name="l423" href="#l423">423</a><td> * Adds a key-value pair to the object/map/hash if it doesn&#39;t exist yet.<tr><td><a name="l424" href="#l424">424</a><td> *<tr><td><a name="l425" href="#l425">425</a><td> * @param {Object.&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a name="l426" href="#l426">426</a><td> * @param {string} key The key to add.<tr><td><a name="l427" href="#l427">427</a><td> * @param {V} value The value to add if the key wasn&#39;t present.<tr><td><a name="l428" href="#l428">428</a><td> * @return {V} The value of the entry at the end of the function.<tr><td><a name="l429" href="#l429">429</a><td> * @template K,V<tr><td><a name="l430" href="#l430">430</a><td> */<tr><td><a name="l431" href="#l431">431</a><td>goog.object.setIfUndefined = function(obj, key, value) {<tr><td><a name="l432" href="#l432">432</a><td>  return key in obj ? obj[key] : (obj[key] = value);<tr><td><a name="l433" href="#l433">433</a><td>};<tr><td><a name="l434" href="#l434">434</a><td><tr><td><a name="l435" href="#l435">435</a><td><tr><td><a name="l436" href="#l436">436</a><td>/**<tr><td><a name="l437" href="#l437">437</a><td> * Does a flat clone of the object.<tr><td><a name="l438" href="#l438">438</a><td> *<tr><td><a name="l439" href="#l439">439</a><td> * @param {Object.&lt;K,V&gt;} obj Object to clone.<tr><td><a name="l440" href="#l440">440</a><td> * @return {!Object.&lt;K,V&gt;} Clone of the input object.<tr><td><a name="l441" href="#l441">441</a><td> * @template K,V<tr><td><a name="l442" href="#l442">442</a><td> */<tr><td><a name="l443" href="#l443">443</a><td>goog.object.clone = function(obj) {<tr><td><a name="l444" href="#l444">444</a><td>  // We cannot use the prototype trick because a lot of methods depend on where<tr><td><a name="l445" href="#l445">445</a><td>  // the actual key is set.<tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td>  var res = {};<tr><td><a name="l448" href="#l448">448</a><td>  for (var key in obj) {<tr><td><a name="l449" href="#l449">449</a><td>    res[key] = obj[key];<tr><td><a name="l450" href="#l450">450</a><td>  }<tr><td><a name="l451" href="#l451">451</a><td>  return res;<tr><td><a name="l452" href="#l452">452</a><td>  // We could also use goog.mixin but I wanted this to be independent from that.<tr><td><a name="l453" href="#l453">453</a><td>};<tr><td><a name="l454" href="#l454">454</a><td><tr><td><a name="l455" href="#l455">455</a><td><tr><td><a name="l456" href="#l456">456</a><td>/**<tr><td><a name="l457" href="#l457">457</a><td> * Clones a value. The input may be an Object, Array, or basic type. Objects and<tr><td><a name="l458" href="#l458">458</a><td> * arrays will be cloned recursively.<tr><td><a name="l459" href="#l459">459</a><td> *<tr><td><a name="l460" href="#l460">460</a><td> * WARNINGS:<tr><td><a name="l461" href="#l461">461</a><td> * &lt;code&gt;goog.object.unsafeClone&lt;/code&gt; does not detect reference loops. Objects<tr><td><a name="l462" href="#l462">462</a><td> * that refer to themselves will cause infinite recursion.<tr><td><a name="l463" href="#l463">463</a><td> *<tr><td><a name="l464" href="#l464">464</a><td> * &lt;code&gt;goog.object.unsafeClone&lt;/code&gt; is unaware of unique identifiers, and<tr><td><a name="l465" href="#l465">465</a><td> * copies UIDs created by &lt;code&gt;getUid&lt;/code&gt; into cloned results.<tr><td><a name="l466" href="#l466">466</a><td> *<tr><td><a name="l467" href="#l467">467</a><td> * @param {*} obj The value to clone.<tr><td><a name="l468" href="#l468">468</a><td> * @return {*} A clone of the input value.<tr><td><a name="l469" href="#l469">469</a><td> */<tr><td><a name="l470" href="#l470">470</a><td>goog.object.unsafeClone = function(obj) {<tr><td><a name="l471" href="#l471">471</a><td>  var type = goog.typeOf(obj);<tr><td><a name="l472" href="#l472">472</a><td>  if (type == &#39;object&#39; || type == &#39;array&#39;) {<tr><td><a name="l473" href="#l473">473</a><td>    if (obj.clone) {<tr><td><a name="l474" href="#l474">474</a><td>      return obj.clone();<tr><td><a name="l475" href="#l475">475</a><td>    }<tr><td><a name="l476" href="#l476">476</a><td>    var clone = type == &#39;array&#39; ? [] : {};<tr><td><a name="l477" href="#l477">477</a><td>    for (var key in obj) {<tr><td><a name="l478" href="#l478">478</a><td>      clone[key] = goog.object.unsafeClone(obj[key]);<tr><td><a name="l479" href="#l479">479</a><td>    }<tr><td><a name="l480" href="#l480">480</a><td>    return clone;<tr><td><a name="l481" href="#l481">481</a><td>  }<tr><td><a name="l482" href="#l482">482</a><td><tr><td><a name="l483" href="#l483">483</a><td>  return obj;<tr><td><a name="l484" href="#l484">484</a><td>};<tr><td><a name="l485" href="#l485">485</a><td><tr><td><a name="l486" href="#l486">486</a><td><tr><td><a name="l487" href="#l487">487</a><td>/**<tr><td><a name="l488" href="#l488">488</a><td> * Returns a new object in which all the keys and values are interchanged<tr><td><a name="l489" href="#l489">489</a><td> * (keys become values and values become keys). If multiple keys map to the<tr><td><a name="l490" href="#l490">490</a><td> * same value, the chosen transposed value is implementation-dependent.<tr><td><a name="l491" href="#l491">491</a><td> *<tr><td><a name="l492" href="#l492">492</a><td> * @param {Object} obj The object to transpose.<tr><td><a name="l493" href="#l493">493</a><td> * @return {!Object} The transposed object.<tr><td><a name="l494" href="#l494">494</a><td> */<tr><td><a name="l495" href="#l495">495</a><td>goog.object.transpose = function(obj) {<tr><td><a name="l496" href="#l496">496</a><td>  var transposed = {};<tr><td><a name="l497" href="#l497">497</a><td>  for (var key in obj) {<tr><td><a name="l498" href="#l498">498</a><td>    transposed[obj[key]] = key;<tr><td><a name="l499" href="#l499">499</a><td>  }<tr><td><a name="l500" href="#l500">500</a><td>  return transposed;<tr><td><a name="l501" href="#l501">501</a><td>};<tr><td><a name="l502" href="#l502">502</a><td><tr><td><a name="l503" href="#l503">503</a><td><tr><td><a name="l504" href="#l504">504</a><td>/**<tr><td><a name="l505" href="#l505">505</a><td> * The names of the fields that are defined on Object.prototype.<tr><td><a name="l506" href="#l506">506</a><td> * @type {Array.&lt;string&gt;}<tr><td><a name="l507" href="#l507">507</a><td> * @private<tr><td><a name="l508" href="#l508">508</a><td> */<tr><td><a name="l509" href="#l509">509</a><td>goog.object.PROTOTYPE_FIELDS_ = [<tr><td><a name="l510" href="#l510">510</a><td>  &#39;constructor&#39;,<tr><td><a name="l511" href="#l511">511</a><td>  &#39;hasOwnProperty&#39;,<tr><td><a name="l512" href="#l512">512</a><td>  &#39;isPrototypeOf&#39;,<tr><td><a name="l513" href="#l513">513</a><td>  &#39;propertyIsEnumerable&#39;,<tr><td><a name="l514" href="#l514">514</a><td>  &#39;toLocaleString&#39;,<tr><td><a name="l515" href="#l515">515</a><td>  &#39;toString&#39;,<tr><td><a name="l516" href="#l516">516</a><td>  &#39;valueOf&#39;<tr><td><a name="l517" href="#l517">517</a><td>];<tr><td><a name="l518" href="#l518">518</a><td><tr><td><a name="l519" href="#l519">519</a><td><tr><td><a name="l520" href="#l520">520</a><td>/**<tr><td><a name="l521" href="#l521">521</a><td> * Extends an object with another object.<tr><td><a name="l522" href="#l522">522</a><td> * This operates &#39;in-place&#39;; it does not create a new Object.<tr><td><a name="l523" href="#l523">523</a><td> *<tr><td><a name="l524" href="#l524">524</a><td> * Example:<tr><td><a name="l525" href="#l525">525</a><td> * var o = {};<tr><td><a name="l526" href="#l526">526</a><td> * goog.object.extend(o, {a: 0, b: 1});<tr><td><a name="l527" href="#l527">527</a><td> * o; // {a: 0, b: 1}<tr><td><a name="l528" href="#l528">528</a><td> * goog.object.extend(o, {c: 2});<tr><td><a name="l529" href="#l529">529</a><td> * o; // {a: 0, b: 1, c: 2}<tr><td><a name="l530" href="#l530">530</a><td> *<tr><td><a name="l531" href="#l531">531</a><td> * @param {Object} target  The object to modify.<tr><td><a name="l532" href="#l532">532</a><td> * @param {...Object} var_args The objects from which values will be copied.<tr><td><a name="l533" href="#l533">533</a><td> */<tr><td><a name="l534" href="#l534">534</a><td>goog.object.extend = function(target, var_args) {<tr><td><a name="l535" href="#l535">535</a><td>  var key, source;<tr><td><a name="l536" href="#l536">536</a><td>  for (var i = 1; i &lt; arguments.length; i++) {<tr><td><a name="l537" href="#l537">537</a><td>    source = arguments[i];<tr><td><a name="l538" href="#l538">538</a><td>    for (key in source) {<tr><td><a name="l539" href="#l539">539</a><td>      target[key] = source[key];<tr><td><a name="l540" href="#l540">540</a><td>    }<tr><td><a name="l541" href="#l541">541</a><td><tr><td><a name="l542" href="#l542">542</a><td>    // For IE the for-in-loop does not contain any properties that are not<tr><td><a name="l543" href="#l543">543</a><td>    // enumerable on the prototype object (for example isPrototypeOf from<tr><td><a name="l544" href="#l544">544</a><td>    // Object.prototype) and it will also not include &#39;replace&#39; on objects that<tr><td><a name="l545" href="#l545">545</a><td>    // extend String and change &#39;replace&#39; (not that it is common for anyone to<tr><td><a name="l546" href="#l546">546</a><td>    // extend anything except Object).<tr><td><a name="l547" href="#l547">547</a><td><tr><td><a name="l548" href="#l548">548</a><td>    for (var j = 0; j &lt; goog.object.PROTOTYPE_FIELDS_.length; j++) {<tr><td><a name="l549" href="#l549">549</a><td>      key = goog.object.PROTOTYPE_FIELDS_[j];<tr><td><a name="l550" href="#l550">550</a><td>      if (Object.prototype.hasOwnProperty.call(source, key)) {<tr><td><a name="l551" href="#l551">551</a><td>        target[key] = source[key];<tr><td><a name="l552" href="#l552">552</a><td>      }<tr><td><a name="l553" href="#l553">553</a><td>    }<tr><td><a name="l554" href="#l554">554</a><td>  }<tr><td><a name="l555" href="#l555">555</a><td>};<tr><td><a name="l556" href="#l556">556</a><td><tr><td><a name="l557" href="#l557">557</a><td><tr><td><a name="l558" href="#l558">558</a><td>/**<tr><td><a name="l559" href="#l559">559</a><td> * Creates a new object built from the key-value pairs provided as arguments.<tr><td><a name="l560" href="#l560">560</a><td> * @param {...*} var_args If only one argument is provided and it is an array<tr><td><a name="l561" href="#l561">561</a><td> *     then this is used as the arguments,  otherwise even arguments are used as<tr><td><a name="l562" href="#l562">562</a><td> *     the property names and odd arguments are used as the property values.<tr><td><a name="l563" href="#l563">563</a><td> * @return {!Object} The new object.<tr><td><a name="l564" href="#l564">564</a><td> * @throws {Error} If there are uneven number of arguments or there is only one<tr><td><a name="l565" href="#l565">565</a><td> *     non array argument.<tr><td><a name="l566" href="#l566">566</a><td> */<tr><td><a name="l567" href="#l567">567</a><td>goog.object.create = function(var_args) {<tr><td><a name="l568" href="#l568">568</a><td>  var argLength = arguments.length;<tr><td><a name="l569" href="#l569">569</a><td>  if (argLength == 1 &amp;&amp; goog.isArray(arguments[0])) {<tr><td><a name="l570" href="#l570">570</a><td>    return goog.object.create.apply(null, arguments[0]);<tr><td><a name="l571" href="#l571">571</a><td>  }<tr><td><a name="l572" href="#l572">572</a><td><tr><td><a name="l573" href="#l573">573</a><td>  if (argLength % 2) {<tr><td><a name="l574" href="#l574">574</a><td>    throw Error(&#39;Uneven number of arguments&#39;);<tr><td><a name="l575" href="#l575">575</a><td>  }<tr><td><a name="l576" href="#l576">576</a><td><tr><td><a name="l577" href="#l577">577</a><td>  var rv = {};<tr><td><a name="l578" href="#l578">578</a><td>  for (var i = 0; i &lt; argLength; i += 2) {<tr><td><a name="l579" href="#l579">579</a><td>    rv[arguments[i]] = arguments[i + 1];<tr><td><a name="l580" href="#l580">580</a><td>  }<tr><td><a name="l581" href="#l581">581</a><td>  return rv;<tr><td><a name="l582" href="#l582">582</a><td>};<tr><td><a name="l583" href="#l583">583</a><td><tr><td><a name="l584" href="#l584">584</a><td><tr><td><a name="l585" href="#l585">585</a><td>/**<tr><td><a name="l586" href="#l586">586</a><td> * Creates a new object where the property names come from the arguments but<tr><td><a name="l587" href="#l587">587</a><td> * the value is always set to true<tr><td><a name="l588" href="#l588">588</a><td> * @param {...*} var_args If only one argument is provided and it is an array<tr><td><a name="l589" href="#l589">589</a><td> *     then this is used as the arguments,  otherwise the arguments are used<tr><td><a name="l590" href="#l590">590</a><td> *     as the property names.<tr><td><a name="l591" href="#l591">591</a><td> * @return {!Object} The new object.<tr><td><a name="l592" href="#l592">592</a><td> */<tr><td><a name="l593" href="#l593">593</a><td>goog.object.createSet = function(var_args) {<tr><td><a name="l594" href="#l594">594</a><td>  var argLength = arguments.length;<tr><td><a name="l595" href="#l595">595</a><td>  if (argLength == 1 &amp;&amp; goog.isArray(arguments[0])) {<tr><td><a name="l596" href="#l596">596</a><td>    return goog.object.createSet.apply(null, arguments[0]);<tr><td><a name="l597" href="#l597">597</a><td>  }<tr><td><a name="l598" href="#l598">598</a><td><tr><td><a name="l599" href="#l599">599</a><td>  var rv = {};<tr><td><a name="l600" href="#l600">600</a><td>  for (var i = 0; i &lt; argLength; i++) {<tr><td><a name="l601" href="#l601">601</a><td>    rv[arguments[i]] = true;<tr><td><a name="l602" href="#l602">602</a><td>  }<tr><td><a name="l603" href="#l603">603</a><td>  return rv;<tr><td><a name="l604" href="#l604">604</a><td>};<tr><td><a name="l605" href="#l605">605</a><td><tr><td><a name="l606" href="#l606">606</a><td><tr><td><a name="l607" href="#l607">607</a><td>/**<tr><td><a name="l608" href="#l608">608</a><td> * Creates an immutable view of the underlying object, if the browser<tr><td><a name="l609" href="#l609">609</a><td> * supports immutable objects.<tr><td><a name="l610" href="#l610">610</a><td> *<tr><td><a name="l611" href="#l611">611</a><td> * In default mode, writes to this view will fail silently. In strict mode,<tr><td><a name="l612" href="#l612">612</a><td> * they will throw an error.<tr><td><a name="l613" href="#l613">613</a><td> *<tr><td><a name="l614" href="#l614">614</a><td> * @param {!Object.&lt;K,V&gt;} obj An object.<tr><td><a name="l615" href="#l615">615</a><td> * @return {!Object.&lt;K,V&gt;} An immutable view of that object, or the<tr><td><a name="l616" href="#l616">616</a><td> *     original object if this browser does not support immutables.<tr><td><a name="l617" href="#l617">617</a><td> * @template K,V<tr><td><a name="l618" href="#l618">618</a><td> */<tr><td><a name="l619" href="#l619">619</a><td>goog.object.createImmutableView = function(obj) {<tr><td><a name="l620" href="#l620">620</a><td>  var result = obj;<tr><td><a name="l621" href="#l621">621</a><td>  if (Object.isFrozen &amp;&amp; !Object.isFrozen(obj)) {<tr><td><a name="l622" href="#l622">622</a><td>    result = Object.create(obj);<tr><td><a name="l623" href="#l623">623</a><td>    Object.freeze(result);<tr><td><a name="l624" href="#l624">624</a><td>  }<tr><td><a name="l625" href="#l625">625</a><td>  return result;<tr><td><a name="l626" href="#l626">626</a><td>};<tr><td><a name="l627" href="#l627">627</a><td><tr><td><a name="l628" href="#l628">628</a><td><tr><td><a name="l629" href="#l629">629</a><td>/**<tr><td><a name="l630" href="#l630">630</a><td> * @param {!Object} obj An object.<tr><td><a name="l631" href="#l631">631</a><td> * @return {boolean} Whether this is an immutable view of the object.<tr><td><a name="l632" href="#l632">632</a><td> */<tr><td><a name="l633" href="#l633">633</a><td>goog.object.isImmutableView = function(obj) {<tr><td><a name="l634" href="#l634">634</a><td>  return !!Object.isFrozen &amp;&amp; Object.isFrozen(obj);<tr><td><a name="l635" href="#l635">635</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>object.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/object/object.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities for manipulating objects/maps/hashes.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.object&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>/**<tr><td><a id="l24"></a><a href="#l24">24</a><td> * Calls a function for each element in an object/map/hash.<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @param {Object&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {function(this:T,V,?,Object&lt;K,V&gt;):?} f The function to call<tr><td><a id="l28"></a><a href="#l28">28</a><td> *     for every element. This function takes 3 arguments (the value, the<tr><td><a id="l29"></a><a href="#l29">29</a><td> *     key and the object) and the return value is ignored.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @template T,K,V<tr><td><a id="l32"></a><a href="#l32">32</a><td> */<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.object.forEach = function(obj, f, opt_obj) {<tr><td><a id="l34"></a><a href="#l34">34</a><td>  for (var key in obj) {<tr><td><a id="l35"></a><a href="#l35">35</a><td>    f.call(opt_obj, obj[key], key, obj);<tr><td><a id="l36"></a><a href="#l36">36</a><td>  }<tr><td><a id="l37"></a><a href="#l37">37</a><td>};<tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>/**<tr><td><a id="l41"></a><a href="#l41">41</a><td> * Calls a function for each element in an object/map/hash. If that call returns<tr><td><a id="l42"></a><a href="#l42">42</a><td> * true, adds the element to a new object.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {Object&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @param {function(this:T,V,?,Object&lt;K,V&gt;):boolean} f The function to call<tr><td><a id="l46"></a><a href="#l46">46</a><td> *     for every element. This<tr><td><a id="l47"></a><a href="#l47">47</a><td> *     function takes 3 arguments (the value, the key and the object)<tr><td><a id="l48"></a><a href="#l48">48</a><td> *     and should return a boolean. If the return value is true the<tr><td><a id="l49"></a><a href="#l49">49</a><td> *     element is added to the result object. If it is false the<tr><td><a id="l50"></a><a href="#l50">50</a><td> *     element is not included.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @return {!Object&lt;K,V&gt;} a new object in which only elements that passed the<tr><td><a id="l53"></a><a href="#l53">53</a><td> *     test are present.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @template T,K,V<tr><td><a id="l55"></a><a href="#l55">55</a><td> */<tr><td><a id="l56"></a><a href="#l56">56</a><td>goog.object.filter = function(obj, f, opt_obj) {<tr><td><a id="l57"></a><a href="#l57">57</a><td>  var res = {};<tr><td><a id="l58"></a><a href="#l58">58</a><td>  for (var key in obj) {<tr><td><a id="l59"></a><a href="#l59">59</a><td>    if (f.call(opt_obj, obj[key], key, obj)) {<tr><td><a id="l60"></a><a href="#l60">60</a><td>      res[key] = obj[key];<tr><td><a id="l61"></a><a href="#l61">61</a><td>    }<tr><td><a id="l62"></a><a href="#l62">62</a><td>  }<tr><td><a id="l63"></a><a href="#l63">63</a><td>  return res;<tr><td><a id="l64"></a><a href="#l64">64</a><td>};<tr><td><a id="l65"></a><a href="#l65">65</a><td><tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>/**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * For every element in an object/map/hash calls a function and inserts the<tr><td><a id="l69"></a><a href="#l69">69</a><td> * result into a new object.<tr><td><a id="l70"></a><a href="#l70">70</a><td> *<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @param {Object&lt;K,V&gt;} obj The object over which to iterate.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @param {function(this:T,V,?,Object&lt;K,V&gt;):R} f The function to call<tr><td><a id="l73"></a><a href="#l73">73</a><td> *     for every element. This function<tr><td><a id="l74"></a><a href="#l74">74</a><td> *     takes 3 arguments (the value, the key and the object)<tr><td><a id="l75"></a><a href="#l75">75</a><td> *     and should return something. The result will be inserted<tr><td><a id="l76"></a><a href="#l76">76</a><td> *     into a new object.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {!Object&lt;K,R&gt;} a new object with the results from f.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @template T,K,V,R<tr><td><a id="l80"></a><a href="#l80">80</a><td> */<tr><td><a id="l81"></a><a href="#l81">81</a><td>goog.object.map = function(obj, f, opt_obj) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>  var res = {};<tr><td><a id="l83"></a><a href="#l83">83</a><td>  for (var key in obj) {<tr><td><a id="l84"></a><a href="#l84">84</a><td>    res[key] = f.call(opt_obj, obj[key], key, obj);<tr><td><a id="l85"></a><a href="#l85">85</a><td>  }<tr><td><a id="l86"></a><a href="#l86">86</a><td>  return res;<tr><td><a id="l87"></a><a href="#l87">87</a><td>};<tr><td><a id="l88"></a><a href="#l88">88</a><td><tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td>/**<tr><td><a id="l91"></a><a href="#l91">91</a><td> * Calls a function for each element in an object/map/hash. If any<tr><td><a id="l92"></a><a href="#l92">92</a><td> * call returns true, returns true (without checking the rest). If<tr><td><a id="l93"></a><a href="#l93">93</a><td> * all calls return false, returns false.<tr><td><a id="l94"></a><a href="#l94">94</a><td> *<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @param {Object&lt;K,V&gt;} obj The object to check.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {function(this:T,V,?,Object&lt;K,V&gt;):boolean} f The function to<tr><td><a id="l97"></a><a href="#l97">97</a><td> *     call for every element. This function<tr><td><a id="l98"></a><a href="#l98">98</a><td> *     takes 3 arguments (the value, the key and the object) and should<tr><td><a id="l99"></a><a href="#l99">99</a><td> *     return a boolean.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @return {boolean} true if any element passes the test.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @template T,K,V<tr><td><a id="l103"></a><a href="#l103">103</a><td> */<tr><td><a id="l104"></a><a href="#l104">104</a><td>goog.object.some = function(obj, f, opt_obj) {<tr><td><a id="l105"></a><a href="#l105">105</a><td>  for (var key in obj) {<tr><td><a id="l106"></a><a href="#l106">106</a><td>    if (f.call(opt_obj, obj[key], key, obj)) {<tr><td><a id="l107"></a><a href="#l107">107</a><td>      return true;<tr><td><a id="l108"></a><a href="#l108">108</a><td>    }<tr><td><a id="l109"></a><a href="#l109">109</a><td>  }<tr><td><a id="l110"></a><a href="#l110">110</a><td>  return false;<tr><td><a id="l111"></a><a href="#l111">111</a><td>};<tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td><tr><td><a id="l114"></a><a href="#l114">114</a><td>/**<tr><td><a id="l115"></a><a href="#l115">115</a><td> * Calls a function for each element in an object/map/hash. If<tr><td><a id="l116"></a><a href="#l116">116</a><td> * all calls return true, returns true. If any call returns false, returns<tr><td><a id="l117"></a><a href="#l117">117</a><td> * false at this point and does not continue to check the remaining elements.<tr><td><a id="l118"></a><a href="#l118">118</a><td> *<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @param {Object&lt;K,V&gt;} obj The object to check.<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @param {?function(this:T,V,?,Object&lt;K,V&gt;):boolean} f The function to<tr><td><a id="l121"></a><a href="#l121">121</a><td> *     call for every element. This function<tr><td><a id="l122"></a><a href="#l122">122</a><td> *     takes 3 arguments (the value, the key and the object) and should<tr><td><a id="l123"></a><a href="#l123">123</a><td> *     return a boolean.<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {T=} opt_obj This is used as the &#39;this&#39; object within f.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @return {boolean} false if any element fails the test.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @template T,K,V<tr><td><a id="l127"></a><a href="#l127">127</a><td> */<tr><td><a id="l128"></a><a href="#l128">128</a><td>goog.object.every = function(obj, f, opt_obj) {<tr><td><a id="l129"></a><a href="#l129">129</a><td>  for (var key in obj) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>    if (!f.call(opt_obj, obj[key], key, obj)) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>      return false;<tr><td><a id="l132"></a><a href="#l132">132</a><td>    }<tr><td><a id="l133"></a><a href="#l133">133</a><td>  }<tr><td><a id="l134"></a><a href="#l134">134</a><td>  return true;<tr><td><a id="l135"></a><a href="#l135">135</a><td>};<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td>/**<tr><td><a id="l139"></a><a href="#l139">139</a><td> * Returns the number of key-value pairs in the object map.<tr><td><a id="l140"></a><a href="#l140">140</a><td> *<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {Object} obj The object for which to get the number of key-value<tr><td><a id="l142"></a><a href="#l142">142</a><td> *     pairs.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @return {number} The number of key-value pairs in the object map.<tr><td><a id="l144"></a><a href="#l144">144</a><td> */<tr><td><a id="l145"></a><a href="#l145">145</a><td>goog.object.getCount = function(obj) {<tr><td><a id="l146"></a><a href="#l146">146</a><td>  // JS1.5 has __count__ but it has been deprecated so it raises a warning...<tr><td><a id="l147"></a><a href="#l147">147</a><td>  // in other words do not use. Also __count__ only includes the fields on the<tr><td><a id="l148"></a><a href="#l148">148</a><td>  // actual object and not in the prototype chain.<tr><td><a id="l149"></a><a href="#l149">149</a><td>  var rv = 0;<tr><td><a id="l150"></a><a href="#l150">150</a><td>  for (var key in obj) {<tr><td><a id="l151"></a><a href="#l151">151</a><td>    rv++;<tr><td><a id="l152"></a><a href="#l152">152</a><td>  }<tr><td><a id="l153"></a><a href="#l153">153</a><td>  return rv;<tr><td><a id="l154"></a><a href="#l154">154</a><td>};<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td>/**<tr><td><a id="l158"></a><a href="#l158">158</a><td> * Returns one key from the object map, if any exists.<tr><td><a id="l159"></a><a href="#l159">159</a><td> * For map literals the returned key will be the first one in most of the<tr><td><a id="l160"></a><a href="#l160">160</a><td> * browsers (a know exception is Konqueror).<tr><td><a id="l161"></a><a href="#l161">161</a><td> *<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @param {Object} obj The object to pick a key from.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @return {string|undefined} The key or undefined if the object is empty.<tr><td><a id="l164"></a><a href="#l164">164</a><td> */<tr><td><a id="l165"></a><a href="#l165">165</a><td>goog.object.getAnyKey = function(obj) {<tr><td><a id="l166"></a><a href="#l166">166</a><td>  for (var key in obj) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>    return key;<tr><td><a id="l168"></a><a href="#l168">168</a><td>  }<tr><td><a id="l169"></a><a href="#l169">169</a><td>};<tr><td><a id="l170"></a><a href="#l170">170</a><td><tr><td><a id="l171"></a><a href="#l171">171</a><td><tr><td><a id="l172"></a><a href="#l172">172</a><td>/**<tr><td><a id="l173"></a><a href="#l173">173</a><td> * Returns one value from the object map, if any exists.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * For map literals the returned value will be the first one in most of the<tr><td><a id="l175"></a><a href="#l175">175</a><td> * browsers (a know exception is Konqueror).<tr><td><a id="l176"></a><a href="#l176">176</a><td> *<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @param {Object&lt;K,V&gt;} obj The object to pick a value from.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @return {V|undefined} The value or undefined if the object is empty.<tr><td><a id="l179"></a><a href="#l179">179</a><td> * @template K,V<tr><td><a id="l180"></a><a href="#l180">180</a><td> */<tr><td><a id="l181"></a><a href="#l181">181</a><td>goog.object.getAnyValue = function(obj) {<tr><td><a id="l182"></a><a href="#l182">182</a><td>  for (var key in obj) {<tr><td><a id="l183"></a><a href="#l183">183</a><td>    return obj[key];<tr><td><a id="l184"></a><a href="#l184">184</a><td>  }<tr><td><a id="l185"></a><a href="#l185">185</a><td>};<tr><td><a id="l186"></a><a href="#l186">186</a><td><tr><td><a id="l187"></a><a href="#l187">187</a><td><tr><td><a id="l188"></a><a href="#l188">188</a><td>/**<tr><td><a id="l189"></a><a href="#l189">189</a><td> * Whether the object/hash/map contains the given object as a value.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * An alias for goog.object.containsValue(obj, val).<tr><td><a id="l191"></a><a href="#l191">191</a><td> *<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @param {Object&lt;K,V&gt;} obj The object in which to look for val.<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @param {V} val The object for which to check.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @return {boolean} true if val is present.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @template K,V<tr><td><a id="l196"></a><a href="#l196">196</a><td> */<tr><td><a id="l197"></a><a href="#l197">197</a><td>goog.object.contains = function(obj, val) {<tr><td><a id="l198"></a><a href="#l198">198</a><td>  return goog.object.containsValue(obj, val);<tr><td><a id="l199"></a><a href="#l199">199</a><td>};<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td><tr><td><a id="l202"></a><a href="#l202">202</a><td>/**<tr><td><a id="l203"></a><a href="#l203">203</a><td> * Returns the values of the object/map/hash.<tr><td><a id="l204"></a><a href="#l204">204</a><td> *<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @param {Object&lt;K,V&gt;} obj The object from which to get the values.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {!Array&lt;V&gt;} The values in the object/map/hash.<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @template K,V<tr><td><a id="l208"></a><a href="#l208">208</a><td> */<tr><td><a id="l209"></a><a href="#l209">209</a><td>goog.object.getValues = function(obj) {<tr><td><a id="l210"></a><a href="#l210">210</a><td>  var res = [];<tr><td><a id="l211"></a><a href="#l211">211</a><td>  var i = 0;<tr><td><a id="l212"></a><a href="#l212">212</a><td>  for (var key in obj) {<tr><td><a id="l213"></a><a href="#l213">213</a><td>    res[i++] = obj[key];<tr><td><a id="l214"></a><a href="#l214">214</a><td>  }<tr><td><a id="l215"></a><a href="#l215">215</a><td>  return res;<tr><td><a id="l216"></a><a href="#l216">216</a><td>};<tr><td><a id="l217"></a><a href="#l217">217</a><td><tr><td><a id="l218"></a><a href="#l218">218</a><td><tr><td><a id="l219"></a><a href="#l219">219</a><td>/**<tr><td><a id="l220"></a><a href="#l220">220</a><td> * Returns the keys of the object/map/hash.<tr><td><a id="l221"></a><a href="#l221">221</a><td> *<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @param {Object} obj The object from which to get the keys.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @return {!Array&lt;string&gt;} Array of property keys.<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>goog.object.getKeys = function(obj) {<tr><td><a id="l226"></a><a href="#l226">226</a><td>  var res = [];<tr><td><a id="l227"></a><a href="#l227">227</a><td>  var i = 0;<tr><td><a id="l228"></a><a href="#l228">228</a><td>  for (var key in obj) {<tr><td><a id="l229"></a><a href="#l229">229</a><td>    res[i++] = key;<tr><td><a id="l230"></a><a href="#l230">230</a><td>  }<tr><td><a id="l231"></a><a href="#l231">231</a><td>  return res;<tr><td><a id="l232"></a><a href="#l232">232</a><td>};<tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td><tr><td><a id="l235"></a><a href="#l235">235</a><td>/**<tr><td><a id="l236"></a><a href="#l236">236</a><td> * Get a value from an object multiple levels deep.  This is useful for<tr><td><a id="l237"></a><a href="#l237">237</a><td> * pulling values from deeply nested objects, such as JSON responses.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * Example usage: getValueByKeys(jsonObj, &#39;foo&#39;, &#39;entries&#39;, 3)<tr><td><a id="l239"></a><a href="#l239">239</a><td> *<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {!Object} obj An object to get the value from.  Can be array-like.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {...(string|number|!Array&lt;number|string&gt;)} var_args A number of keys<tr><td><a id="l242"></a><a href="#l242">242</a><td> *     (as strings, or numbers, for array-like objects).  Can also be<tr><td><a id="l243"></a><a href="#l243">243</a><td> *     specified as a single array of keys.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @return {*} The resulting value.  If, at any point, the value for a key<tr><td><a id="l245"></a><a href="#l245">245</a><td> *     is undefined, returns undefined.<tr><td><a id="l246"></a><a href="#l246">246</a><td> */<tr><td><a id="l247"></a><a href="#l247">247</a><td>goog.object.getValueByKeys = function(obj, var_args) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>  var isArrayLike = goog.isArrayLike(var_args);<tr><td><a id="l249"></a><a href="#l249">249</a><td>  var keys = isArrayLike ? var_args : arguments;<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td>  // Start with the 2nd parameter for the variable parameters syntax.<tr><td><a id="l252"></a><a href="#l252">252</a><td>  for (var i = isArrayLike ? 0 : 1; i &lt; keys.length; i++) {<tr><td><a id="l253"></a><a href="#l253">253</a><td>    obj = obj[keys[i]];<tr><td><a id="l254"></a><a href="#l254">254</a><td>    if (!goog.isDef(obj)) {<tr><td><a id="l255"></a><a href="#l255">255</a><td>      break;<tr><td><a id="l256"></a><a href="#l256">256</a><td>    }<tr><td><a id="l257"></a><a href="#l257">257</a><td>  }<tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td>  return obj;<tr><td><a id="l260"></a><a href="#l260">260</a><td>};<tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td><tr><td><a id="l263"></a><a href="#l263">263</a><td>/**<tr><td><a id="l264"></a><a href="#l264">264</a><td> * Whether the object/map/hash contains the given key.<tr><td><a id="l265"></a><a href="#l265">265</a><td> *<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @param {Object} obj The object in which to look for key.<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @param {?} key The key for which to check.<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @return {boolean} true If the map contains the key.<tr><td><a id="l269"></a><a href="#l269">269</a><td> */<tr><td><a id="l270"></a><a href="#l270">270</a><td>goog.object.containsKey = function(obj, key) {<tr><td><a id="l271"></a><a href="#l271">271</a><td>  return obj !== null &amp;&amp; key in obj;<tr><td><a id="l272"></a><a href="#l272">272</a><td>};<tr><td><a id="l273"></a><a href="#l273">273</a><td><tr><td><a id="l274"></a><a href="#l274">274</a><td><tr><td><a id="l275"></a><a href="#l275">275</a><td>/**<tr><td><a id="l276"></a><a href="#l276">276</a><td> * Whether the object/map/hash contains the given value. This is O(n).<tr><td><a id="l277"></a><a href="#l277">277</a><td> *<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @param {Object&lt;K,V&gt;} obj The object in which to look for val.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {V} val The value for which to check.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @return {boolean} true If the map contains the value.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @template K,V<tr><td><a id="l282"></a><a href="#l282">282</a><td> */<tr><td><a id="l283"></a><a href="#l283">283</a><td>goog.object.containsValue = function(obj, val) {<tr><td><a id="l284"></a><a href="#l284">284</a><td>  for (var key in obj) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>    if (obj[key] == val) {<tr><td><a id="l286"></a><a href="#l286">286</a><td>      return true;<tr><td><a id="l287"></a><a href="#l287">287</a><td>    }<tr><td><a id="l288"></a><a href="#l288">288</a><td>  }<tr><td><a id="l289"></a><a href="#l289">289</a><td>  return false;<tr><td><a id="l290"></a><a href="#l290">290</a><td>};<tr><td><a id="l291"></a><a href="#l291">291</a><td><tr><td><a id="l292"></a><a href="#l292">292</a><td><tr><td><a id="l293"></a><a href="#l293">293</a><td>/**<tr><td><a id="l294"></a><a href="#l294">294</a><td> * Searches an object for an element that satisfies the given condition and<tr><td><a id="l295"></a><a href="#l295">295</a><td> * returns its key.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @param {Object&lt;K,V&gt;} obj The object to search in.<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @param {function(this:T,V,string,Object&lt;K,V&gt;):boolean} f The<tr><td><a id="l298"></a><a href="#l298">298</a><td> *      function to call for every element. Takes 3 arguments (the value,<tr><td><a id="l299"></a><a href="#l299">299</a><td> *     the key and the object) and should return a boolean.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @param {T=} opt_this An optional &quot;this&quot; context for the function.<tr><td><a id="l301"></a><a href="#l301">301</a><td> * @return {string|undefined} The key of an element for which the function<tr><td><a id="l302"></a><a href="#l302">302</a><td> *     returns true or undefined if no such element is found.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @template T,K,V<tr><td><a id="l304"></a><a href="#l304">304</a><td> */<tr><td><a id="l305"></a><a href="#l305">305</a><td>goog.object.findKey = function(obj, f, opt_this) {<tr><td><a id="l306"></a><a href="#l306">306</a><td>  for (var key in obj) {<tr><td><a id="l307"></a><a href="#l307">307</a><td>    if (f.call(opt_this, obj[key], key, obj)) {<tr><td><a id="l308"></a><a href="#l308">308</a><td>      return key;<tr><td><a id="l309"></a><a href="#l309">309</a><td>    }<tr><td><a id="l310"></a><a href="#l310">310</a><td>  }<tr><td><a id="l311"></a><a href="#l311">311</a><td>  return undefined;<tr><td><a id="l312"></a><a href="#l312">312</a><td>};<tr><td><a id="l313"></a><a href="#l313">313</a><td><tr><td><a id="l314"></a><a href="#l314">314</a><td><tr><td><a id="l315"></a><a href="#l315">315</a><td>/**<tr><td><a id="l316"></a><a href="#l316">316</a><td> * Searches an object for an element that satisfies the given condition and<tr><td><a id="l317"></a><a href="#l317">317</a><td> * returns its value.<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @param {Object&lt;K,V&gt;} obj The object to search in.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @param {function(this:T,V,string,Object&lt;K,V&gt;):boolean} f The function<tr><td><a id="l320"></a><a href="#l320">320</a><td> *     to call for every element. Takes 3 arguments (the value, the key<tr><td><a id="l321"></a><a href="#l321">321</a><td> *     and the object) and should return a boolean.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {T=} opt_this An optional &quot;this&quot; context for the function.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @return {V} The value of an element for which the function returns true or<tr><td><a id="l324"></a><a href="#l324">324</a><td> *     undefined if no such element is found.<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @template T,K,V<tr><td><a id="l326"></a><a href="#l326">326</a><td> */<tr><td><a id="l327"></a><a href="#l327">327</a><td>goog.object.findValue = function(obj, f, opt_this) {<tr><td><a id="l328"></a><a href="#l328">328</a><td>  var key = goog.object.findKey(obj, f, opt_this);<tr><td><a id="l329"></a><a href="#l329">329</a><td>  return key &amp;&amp; obj[key];<tr><td><a id="l330"></a><a href="#l330">330</a><td>};<tr><td><a id="l331"></a><a href="#l331">331</a><td><tr><td><a id="l332"></a><a href="#l332">332</a><td><tr><td><a id="l333"></a><a href="#l333">333</a><td>/**<tr><td><a id="l334"></a><a href="#l334">334</a><td> * Whether the object/map/hash is empty.<tr><td><a id="l335"></a><a href="#l335">335</a><td> *<tr><td><a id="l336"></a><a href="#l336">336</a><td> * @param {Object} obj The object to test.<tr><td><a id="l337"></a><a href="#l337">337</a><td> * @return {boolean} true if obj is empty.<tr><td><a id="l338"></a><a href="#l338">338</a><td> */<tr><td><a id="l339"></a><a href="#l339">339</a><td>goog.object.isEmpty = function(obj) {<tr><td><a id="l340"></a><a href="#l340">340</a><td>  for (var key in obj) {<tr><td><a id="l341"></a><a href="#l341">341</a><td>    return false;<tr><td><a id="l342"></a><a href="#l342">342</a><td>  }<tr><td><a id="l343"></a><a href="#l343">343</a><td>  return true;<tr><td><a id="l344"></a><a href="#l344">344</a><td>};<tr><td><a id="l345"></a><a href="#l345">345</a><td><tr><td><a id="l346"></a><a href="#l346">346</a><td><tr><td><a id="l347"></a><a href="#l347">347</a><td>/**<tr><td><a id="l348"></a><a href="#l348">348</a><td> * Removes all key value pairs from the object/map/hash.<tr><td><a id="l349"></a><a href="#l349">349</a><td> *<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @param {Object} obj The object to clear.<tr><td><a id="l351"></a><a href="#l351">351</a><td> */<tr><td><a id="l352"></a><a href="#l352">352</a><td>goog.object.clear = function(obj) {<tr><td><a id="l353"></a><a href="#l353">353</a><td>  for (var i in obj) {<tr><td><a id="l354"></a><a href="#l354">354</a><td>    delete obj[i];<tr><td><a id="l355"></a><a href="#l355">355</a><td>  }<tr><td><a id="l356"></a><a href="#l356">356</a><td>};<tr><td><a id="l357"></a><a href="#l357">357</a><td><tr><td><a id="l358"></a><a href="#l358">358</a><td><tr><td><a id="l359"></a><a href="#l359">359</a><td>/**<tr><td><a id="l360"></a><a href="#l360">360</a><td> * Removes a key-value pair based on the key.<tr><td><a id="l361"></a><a href="#l361">361</a><td> *<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @param {Object} obj The object from which to remove the key.<tr><td><a id="l363"></a><a href="#l363">363</a><td> * @param {*} key The key to remove.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @return {boolean} Whether an element was removed.<tr><td><a id="l365"></a><a href="#l365">365</a><td> */<tr><td><a id="l366"></a><a href="#l366">366</a><td>goog.object.remove = function(obj, key) {<tr><td><a id="l367"></a><a href="#l367">367</a><td>  var rv;<tr><td><a id="l368"></a><a href="#l368">368</a><td>  if (rv = key in /** @type {!Object} */ (obj)) {<tr><td><a id="l369"></a><a href="#l369">369</a><td>    delete obj[key];<tr><td><a id="l370"></a><a href="#l370">370</a><td>  }<tr><td><a id="l371"></a><a href="#l371">371</a><td>  return rv;<tr><td><a id="l372"></a><a href="#l372">372</a><td>};<tr><td><a id="l373"></a><a href="#l373">373</a><td><tr><td><a id="l374"></a><a href="#l374">374</a><td><tr><td><a id="l375"></a><a href="#l375">375</a><td>/**<tr><td><a id="l376"></a><a href="#l376">376</a><td> * Adds a key-value pair to the object. Throws an exception if the key is<tr><td><a id="l377"></a><a href="#l377">377</a><td> * already in use. Use set if you want to change an existing pair.<tr><td><a id="l378"></a><a href="#l378">378</a><td> *<tr><td><a id="l379"></a><a href="#l379">379</a><td> * @param {Object&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @param {string} key The key to add.<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @param {V} val The value to add.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @template K,V<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>goog.object.add = function(obj, key, val) {<tr><td><a id="l385"></a><a href="#l385">385</a><td>  if (obj !== null &amp;&amp; key in obj) {<tr><td><a id="l386"></a><a href="#l386">386</a><td>    throw Error(&#39;The object already contains the key &quot;&#39; + key + &#39;&quot;&#39;);<tr><td><a id="l387"></a><a href="#l387">387</a><td>  }<tr><td><a id="l388"></a><a href="#l388">388</a><td>  goog.object.set(obj, key, val);<tr><td><a id="l389"></a><a href="#l389">389</a><td>};<tr><td><a id="l390"></a><a href="#l390">390</a><td><tr><td><a id="l391"></a><a href="#l391">391</a><td><tr><td><a id="l392"></a><a href="#l392">392</a><td>/**<tr><td><a id="l393"></a><a href="#l393">393</a><td> * Returns the value for the given key.<tr><td><a id="l394"></a><a href="#l394">394</a><td> *<tr><td><a id="l395"></a><a href="#l395">395</a><td> * @param {Object&lt;K,V&gt;} obj The object from which to get the value.<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @param {string} key The key for which to get the value.<tr><td><a id="l397"></a><a href="#l397">397</a><td> * @param {R=} opt_val The value to return if no item is found for the given<tr><td><a id="l398"></a><a href="#l398">398</a><td> *     key (default is undefined).<tr><td><a id="l399"></a><a href="#l399">399</a><td> * @return {V|R|undefined} The value for the given key.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @template K,V,R<tr><td><a id="l401"></a><a href="#l401">401</a><td> */<tr><td><a id="l402"></a><a href="#l402">402</a><td>goog.object.get = function(obj, key, opt_val) {<tr><td><a id="l403"></a><a href="#l403">403</a><td>  if (obj !== null &amp;&amp; key in obj) {<tr><td><a id="l404"></a><a href="#l404">404</a><td>    return obj[key];<tr><td><a id="l405"></a><a href="#l405">405</a><td>  }<tr><td><a id="l406"></a><a href="#l406">406</a><td>  return opt_val;<tr><td><a id="l407"></a><a href="#l407">407</a><td>};<tr><td><a id="l408"></a><a href="#l408">408</a><td><tr><td><a id="l409"></a><a href="#l409">409</a><td><tr><td><a id="l410"></a><a href="#l410">410</a><td>/**<tr><td><a id="l411"></a><a href="#l411">411</a><td> * Adds a key-value pair to the object/map/hash.<tr><td><a id="l412"></a><a href="#l412">412</a><td> *<tr><td><a id="l413"></a><a href="#l413">413</a><td> * @param {Object&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a id="l414"></a><a href="#l414">414</a><td> * @param {string} key The key to add.<tr><td><a id="l415"></a><a href="#l415">415</a><td> * @param {V} value The value to add.<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @template K,V<tr><td><a id="l417"></a><a href="#l417">417</a><td> */<tr><td><a id="l418"></a><a href="#l418">418</a><td>goog.object.set = function(obj, key, value) {<tr><td><a id="l419"></a><a href="#l419">419</a><td>  obj[key] = value;<tr><td><a id="l420"></a><a href="#l420">420</a><td>};<tr><td><a id="l421"></a><a href="#l421">421</a><td><tr><td><a id="l422"></a><a href="#l422">422</a><td><tr><td><a id="l423"></a><a href="#l423">423</a><td>/**<tr><td><a id="l424"></a><a href="#l424">424</a><td> * Adds a key-value pair to the object/map/hash if it doesn&#39;t exist yet.<tr><td><a id="l425"></a><a href="#l425">425</a><td> *<tr><td><a id="l426"></a><a href="#l426">426</a><td> * @param {Object&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a id="l427"></a><a href="#l427">427</a><td> * @param {string} key The key to add.<tr><td><a id="l428"></a><a href="#l428">428</a><td> * @param {V} value The value to add if the key wasn&#39;t present.<tr><td><a id="l429"></a><a href="#l429">429</a><td> * @return {V} The value of the entry at the end of the function.<tr><td><a id="l430"></a><a href="#l430">430</a><td> * @template K,V<tr><td><a id="l431"></a><a href="#l431">431</a><td> */<tr><td><a id="l432"></a><a href="#l432">432</a><td>goog.object.setIfUndefined = function(obj, key, value) {<tr><td><a id="l433"></a><a href="#l433">433</a><td>  return key in /** @type {!Object} */ (obj) ? obj[key] : (obj[key] = value);<tr><td><a id="l434"></a><a href="#l434">434</a><td>};<tr><td><a id="l435"></a><a href="#l435">435</a><td><tr><td><a id="l436"></a><a href="#l436">436</a><td><tr><td><a id="l437"></a><a href="#l437">437</a><td>/**<tr><td><a id="l438"></a><a href="#l438">438</a><td> * Sets a key and value to an object if the key is not set. The value will be<tr><td><a id="l439"></a><a href="#l439">439</a><td> * the return value of the given function. If the key already exists, the<tr><td><a id="l440"></a><a href="#l440">440</a><td> * object will not be changed and the function will not be called (the function<tr><td><a id="l441"></a><a href="#l441">441</a><td> * will be lazily evaluated -- only called if necessary).<tr><td><a id="l442"></a><a href="#l442">442</a><td> *<tr><td><a id="l443"></a><a href="#l443">443</a><td> * This function is particularly useful for use with a map used a as a cache.<tr><td><a id="l444"></a><a href="#l444">444</a><td> *<tr><td><a id="l445"></a><a href="#l445">445</a><td> * @param {!Object&lt;K,V&gt;} obj The object to which to add the key-value pair.<tr><td><a id="l446"></a><a href="#l446">446</a><td> * @param {string} key The key to add.<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {function():V} f The value to add if the key wasn&#39;t present.<tr><td><a id="l448"></a><a href="#l448">448</a><td> * @return {V} The value of the entry at the end of the function.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @template K,V<tr><td><a id="l450"></a><a href="#l450">450</a><td> */<tr><td><a id="l451"></a><a href="#l451">451</a><td>goog.object.setWithReturnValueIfNotSet = function(obj, key, f) {<tr><td><a id="l452"></a><a href="#l452">452</a><td>  if (key in obj) {<tr><td><a id="l453"></a><a href="#l453">453</a><td>    return obj[key];<tr><td><a id="l454"></a><a href="#l454">454</a><td>  }<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td>  var val = f();<tr><td><a id="l457"></a><a href="#l457">457</a><td>  obj[key] = val;<tr><td><a id="l458"></a><a href="#l458">458</a><td>  return val;<tr><td><a id="l459"></a><a href="#l459">459</a><td>};<tr><td><a id="l460"></a><a href="#l460">460</a><td><tr><td><a id="l461"></a><a href="#l461">461</a><td><tr><td><a id="l462"></a><a href="#l462">462</a><td>/**<tr><td><a id="l463"></a><a href="#l463">463</a><td> * Compares two objects for equality using === on the values.<tr><td><a id="l464"></a><a href="#l464">464</a><td> *<tr><td><a id="l465"></a><a href="#l465">465</a><td> * @param {!Object&lt;K,V&gt;} a<tr><td><a id="l466"></a><a href="#l466">466</a><td> * @param {!Object&lt;K,V&gt;} b<tr><td><a id="l467"></a><a href="#l467">467</a><td> * @return {boolean}<tr><td><a id="l468"></a><a href="#l468">468</a><td> * @template K,V<tr><td><a id="l469"></a><a href="#l469">469</a><td> */<tr><td><a id="l470"></a><a href="#l470">470</a><td>goog.object.equals = function(a, b) {<tr><td><a id="l471"></a><a href="#l471">471</a><td>  for (var k in a) {<tr><td><a id="l472"></a><a href="#l472">472</a><td>    if (!(k in b) || a[k] !== b[k]) {<tr><td><a id="l473"></a><a href="#l473">473</a><td>      return false;<tr><td><a id="l474"></a><a href="#l474">474</a><td>    }<tr><td><a id="l475"></a><a href="#l475">475</a><td>  }<tr><td><a id="l476"></a><a href="#l476">476</a><td>  for (var k in b) {<tr><td><a id="l477"></a><a href="#l477">477</a><td>    if (!(k in a)) {<tr><td><a id="l478"></a><a href="#l478">478</a><td>      return false;<tr><td><a id="l479"></a><a href="#l479">479</a><td>    }<tr><td><a id="l480"></a><a href="#l480">480</a><td>  }<tr><td><a id="l481"></a><a href="#l481">481</a><td>  return true;<tr><td><a id="l482"></a><a href="#l482">482</a><td>};<tr><td><a id="l483"></a><a href="#l483">483</a><td><tr><td><a id="l484"></a><a href="#l484">484</a><td><tr><td><a id="l485"></a><a href="#l485">485</a><td>/**<tr><td><a id="l486"></a><a href="#l486">486</a><td> * Does a flat clone of the object.<tr><td><a id="l487"></a><a href="#l487">487</a><td> *<tr><td><a id="l488"></a><a href="#l488">488</a><td> * @param {Object&lt;K,V&gt;} obj Object to clone.<tr><td><a id="l489"></a><a href="#l489">489</a><td> * @return {!Object&lt;K,V&gt;} Clone of the input object.<tr><td><a id="l490"></a><a href="#l490">490</a><td> * @template K,V<tr><td><a id="l491"></a><a href="#l491">491</a><td> */<tr><td><a id="l492"></a><a href="#l492">492</a><td>goog.object.clone = function(obj) {<tr><td><a id="l493"></a><a href="#l493">493</a><td>  // We cannot use the prototype trick because a lot of methods depend on where<tr><td><a id="l494"></a><a href="#l494">494</a><td>  // the actual key is set.<tr><td><a id="l495"></a><a href="#l495">495</a><td><tr><td><a id="l496"></a><a href="#l496">496</a><td>  var res = {};<tr><td><a id="l497"></a><a href="#l497">497</a><td>  for (var key in obj) {<tr><td><a id="l498"></a><a href="#l498">498</a><td>    res[key] = obj[key];<tr><td><a id="l499"></a><a href="#l499">499</a><td>  }<tr><td><a id="l500"></a><a href="#l500">500</a><td>  return res;<tr><td><a id="l501"></a><a href="#l501">501</a><td>  // We could also use goog.mixin but I wanted this to be independent from that.<tr><td><a id="l502"></a><a href="#l502">502</a><td>};<tr><td><a id="l503"></a><a href="#l503">503</a><td><tr><td><a id="l504"></a><a href="#l504">504</a><td><tr><td><a id="l505"></a><a href="#l505">505</a><td>/**<tr><td><a id="l506"></a><a href="#l506">506</a><td> * Clones a value. The input may be an Object, Array, or basic type. Objects and<tr><td><a id="l507"></a><a href="#l507">507</a><td> * arrays will be cloned recursively.<tr><td><a id="l508"></a><a href="#l508">508</a><td> *<tr><td><a id="l509"></a><a href="#l509">509</a><td> * WARNINGS:<tr><td><a id="l510"></a><a href="#l510">510</a><td> * &lt;code&gt;goog.object.unsafeClone&lt;/code&gt; does not detect reference loops. Objects<tr><td><a id="l511"></a><a href="#l511">511</a><td> * that refer to themselves will cause infinite recursion.<tr><td><a id="l512"></a><a href="#l512">512</a><td> *<tr><td><a id="l513"></a><a href="#l513">513</a><td> * &lt;code&gt;goog.object.unsafeClone&lt;/code&gt; is unaware of unique identifiers, and<tr><td><a id="l514"></a><a href="#l514">514</a><td> * copies UIDs created by &lt;code&gt;getUid&lt;/code&gt; into cloned results.<tr><td><a id="l515"></a><a href="#l515">515</a><td> *<tr><td><a id="l516"></a><a href="#l516">516</a><td> * @param {*} obj The value to clone.<tr><td><a id="l517"></a><a href="#l517">517</a><td> * @return {*} A clone of the input value.<tr><td><a id="l518"></a><a href="#l518">518</a><td> */<tr><td><a id="l519"></a><a href="#l519">519</a><td>goog.object.unsafeClone = function(obj) {<tr><td><a id="l520"></a><a href="#l520">520</a><td>  var type = goog.typeOf(obj);<tr><td><a id="l521"></a><a href="#l521">521</a><td>  if (type == &#39;object&#39; || type == &#39;array&#39;) {<tr><td><a id="l522"></a><a href="#l522">522</a><td>    if (goog.isFunction(obj.clone)) {<tr><td><a id="l523"></a><a href="#l523">523</a><td>      return obj.clone();<tr><td><a id="l524"></a><a href="#l524">524</a><td>    }<tr><td><a id="l525"></a><a href="#l525">525</a><td>    var clone = type == &#39;array&#39; ? [] : {};<tr><td><a id="l526"></a><a href="#l526">526</a><td>    for (var key in obj) {<tr><td><a id="l527"></a><a href="#l527">527</a><td>      clone[key] = goog.object.unsafeClone(obj[key]);<tr><td><a id="l528"></a><a href="#l528">528</a><td>    }<tr><td><a id="l529"></a><a href="#l529">529</a><td>    return clone;<tr><td><a id="l530"></a><a href="#l530">530</a><td>  }<tr><td><a id="l531"></a><a href="#l531">531</a><td><tr><td><a id="l532"></a><a href="#l532">532</a><td>  return obj;<tr><td><a id="l533"></a><a href="#l533">533</a><td>};<tr><td><a id="l534"></a><a href="#l534">534</a><td><tr><td><a id="l535"></a><a href="#l535">535</a><td><tr><td><a id="l536"></a><a href="#l536">536</a><td>/**<tr><td><a id="l537"></a><a href="#l537">537</a><td> * Returns a new object in which all the keys and values are interchanged<tr><td><a id="l538"></a><a href="#l538">538</a><td> * (keys become values and values become keys). If multiple keys map to the<tr><td><a id="l539"></a><a href="#l539">539</a><td> * same value, the chosen transposed value is implementation-dependent.<tr><td><a id="l540"></a><a href="#l540">540</a><td> *<tr><td><a id="l541"></a><a href="#l541">541</a><td> * @param {Object} obj The object to transpose.<tr><td><a id="l542"></a><a href="#l542">542</a><td> * @return {!Object} The transposed object.<tr><td><a id="l543"></a><a href="#l543">543</a><td> */<tr><td><a id="l544"></a><a href="#l544">544</a><td>goog.object.transpose = function(obj) {<tr><td><a id="l545"></a><a href="#l545">545</a><td>  var transposed = {};<tr><td><a id="l546"></a><a href="#l546">546</a><td>  for (var key in obj) {<tr><td><a id="l547"></a><a href="#l547">547</a><td>    transposed[obj[key]] = key;<tr><td><a id="l548"></a><a href="#l548">548</a><td>  }<tr><td><a id="l549"></a><a href="#l549">549</a><td>  return transposed;<tr><td><a id="l550"></a><a href="#l550">550</a><td>};<tr><td><a id="l551"></a><a href="#l551">551</a><td><tr><td><a id="l552"></a><a href="#l552">552</a><td><tr><td><a id="l553"></a><a href="#l553">553</a><td>/**<tr><td><a id="l554"></a><a href="#l554">554</a><td> * The names of the fields that are defined on Object.prototype.<tr><td><a id="l555"></a><a href="#l555">555</a><td> * @type {Array&lt;string&gt;}<tr><td><a id="l556"></a><a href="#l556">556</a><td> * @private<tr><td><a id="l557"></a><a href="#l557">557</a><td> */<tr><td><a id="l558"></a><a href="#l558">558</a><td>goog.object.PROTOTYPE_FIELDS_ = [<tr><td><a id="l559"></a><a href="#l559">559</a><td>  &#39;constructor&#39;,<tr><td><a id="l560"></a><a href="#l560">560</a><td>  &#39;hasOwnProperty&#39;,<tr><td><a id="l561"></a><a href="#l561">561</a><td>  &#39;isPrototypeOf&#39;,<tr><td><a id="l562"></a><a href="#l562">562</a><td>  &#39;propertyIsEnumerable&#39;,<tr><td><a id="l563"></a><a href="#l563">563</a><td>  &#39;toLocaleString&#39;,<tr><td><a id="l564"></a><a href="#l564">564</a><td>  &#39;toString&#39;,<tr><td><a id="l565"></a><a href="#l565">565</a><td>  &#39;valueOf&#39;<tr><td><a id="l566"></a><a href="#l566">566</a><td>];<tr><td><a id="l567"></a><a href="#l567">567</a><td><tr><td><a id="l568"></a><a href="#l568">568</a><td><tr><td><a id="l569"></a><a href="#l569">569</a><td>/**<tr><td><a id="l570"></a><a href="#l570">570</a><td> * Extends an object with another object.<tr><td><a id="l571"></a><a href="#l571">571</a><td> * This operates &#39;in-place&#39;; it does not create a new Object.<tr><td><a id="l572"></a><a href="#l572">572</a><td> *<tr><td><a id="l573"></a><a href="#l573">573</a><td> * Example:<tr><td><a id="l574"></a><a href="#l574">574</a><td> * var o = {};<tr><td><a id="l575"></a><a href="#l575">575</a><td> * goog.object.extend(o, {a: 0, b: 1});<tr><td><a id="l576"></a><a href="#l576">576</a><td> * o; // {a: 0, b: 1}<tr><td><a id="l577"></a><a href="#l577">577</a><td> * goog.object.extend(o, {b: 2, c: 3});<tr><td><a id="l578"></a><a href="#l578">578</a><td> * o; // {a: 0, b: 2, c: 3}<tr><td><a id="l579"></a><a href="#l579">579</a><td> *<tr><td><a id="l580"></a><a href="#l580">580</a><td> * @param {Object} target The object to modify. Existing properties will be<tr><td><a id="l581"></a><a href="#l581">581</a><td> *     overwritten if they are also present in one of the objects in<tr><td><a id="l582"></a><a href="#l582">582</a><td> *     {@code var_args}.<tr><td><a id="l583"></a><a href="#l583">583</a><td> * @param {...Object} var_args The objects from which values will be copied.<tr><td><a id="l584"></a><a href="#l584">584</a><td> */<tr><td><a id="l585"></a><a href="#l585">585</a><td>goog.object.extend = function(target, var_args) {<tr><td><a id="l586"></a><a href="#l586">586</a><td>  var key, source;<tr><td><a id="l587"></a><a href="#l587">587</a><td>  for (var i = 1; i &lt; arguments.length; i++) {<tr><td><a id="l588"></a><a href="#l588">588</a><td>    source = arguments[i];<tr><td><a id="l589"></a><a href="#l589">589</a><td>    for (key in source) {<tr><td><a id="l590"></a><a href="#l590">590</a><td>      target[key] = source[key];<tr><td><a id="l591"></a><a href="#l591">591</a><td>    }<tr><td><a id="l592"></a><a href="#l592">592</a><td><tr><td><a id="l593"></a><a href="#l593">593</a><td>    // For IE the for-in-loop does not contain any properties that are not<tr><td><a id="l594"></a><a href="#l594">594</a><td>    // enumerable on the prototype object (for example isPrototypeOf from<tr><td><a id="l595"></a><a href="#l595">595</a><td>    // Object.prototype) and it will also not include &#39;replace&#39; on objects that<tr><td><a id="l596"></a><a href="#l596">596</a><td>    // extend String and change &#39;replace&#39; (not that it is common for anyone to<tr><td><a id="l597"></a><a href="#l597">597</a><td>    // extend anything except Object).<tr><td><a id="l598"></a><a href="#l598">598</a><td><tr><td><a id="l599"></a><a href="#l599">599</a><td>    for (var j = 0; j &lt; goog.object.PROTOTYPE_FIELDS_.length; j++) {<tr><td><a id="l600"></a><a href="#l600">600</a><td>      key = goog.object.PROTOTYPE_FIELDS_[j];<tr><td><a id="l601"></a><a href="#l601">601</a><td>      if (Object.prototype.hasOwnProperty.call(source, key)) {<tr><td><a id="l602"></a><a href="#l602">602</a><td>        target[key] = source[key];<tr><td><a id="l603"></a><a href="#l603">603</a><td>      }<tr><td><a id="l604"></a><a href="#l604">604</a><td>    }<tr><td><a id="l605"></a><a href="#l605">605</a><td>  }<tr><td><a id="l606"></a><a href="#l606">606</a><td>};<tr><td><a id="l607"></a><a href="#l607">607</a><td><tr><td><a id="l608"></a><a href="#l608">608</a><td><tr><td><a id="l609"></a><a href="#l609">609</a><td>/**<tr><td><a id="l610"></a><a href="#l610">610</a><td> * Creates a new object built from the key-value pairs provided as arguments.<tr><td><a id="l611"></a><a href="#l611">611</a><td> * @param {...*} var_args If only one argument is provided and it is an array<tr><td><a id="l612"></a><a href="#l612">612</a><td> *     then this is used as the arguments,  otherwise even arguments are used as<tr><td><a id="l613"></a><a href="#l613">613</a><td> *     the property names and odd arguments are used as the property values.<tr><td><a id="l614"></a><a href="#l614">614</a><td> * @return {!Object} The new object.<tr><td><a id="l615"></a><a href="#l615">615</a><td> * @throws {Error} If there are uneven number of arguments or there is only one<tr><td><a id="l616"></a><a href="#l616">616</a><td> *     non array argument.<tr><td><a id="l617"></a><a href="#l617">617</a><td> */<tr><td><a id="l618"></a><a href="#l618">618</a><td>goog.object.create = function(var_args) {<tr><td><a id="l619"></a><a href="#l619">619</a><td>  var argLength = arguments.length;<tr><td><a id="l620"></a><a href="#l620">620</a><td>  if (argLength == 1 &amp;&amp; goog.isArray(arguments[0])) {<tr><td><a id="l621"></a><a href="#l621">621</a><td>    return goog.object.create.apply(null, arguments[0]);<tr><td><a id="l622"></a><a href="#l622">622</a><td>  }<tr><td><a id="l623"></a><a href="#l623">623</a><td><tr><td><a id="l624"></a><a href="#l624">624</a><td>  if (argLength % 2) {<tr><td><a id="l625"></a><a href="#l625">625</a><td>    throw Error(&#39;Uneven number of arguments&#39;);<tr><td><a id="l626"></a><a href="#l626">626</a><td>  }<tr><td><a id="l627"></a><a href="#l627">627</a><td><tr><td><a id="l628"></a><a href="#l628">628</a><td>  var rv = {};<tr><td><a id="l629"></a><a href="#l629">629</a><td>  for (var i = 0; i &lt; argLength; i += 2) {<tr><td><a id="l630"></a><a href="#l630">630</a><td>    rv[arguments[i]] = arguments[i + 1];<tr><td><a id="l631"></a><a href="#l631">631</a><td>  }<tr><td><a id="l632"></a><a href="#l632">632</a><td>  return rv;<tr><td><a id="l633"></a><a href="#l633">633</a><td>};<tr><td><a id="l634"></a><a href="#l634">634</a><td><tr><td><a id="l635"></a><a href="#l635">635</a><td><tr><td><a id="l636"></a><a href="#l636">636</a><td>/**<tr><td><a id="l637"></a><a href="#l637">637</a><td> * Creates a new object where the property names come from the arguments but<tr><td><a id="l638"></a><a href="#l638">638</a><td> * the value is always set to true<tr><td><a id="l639"></a><a href="#l639">639</a><td> * @param {...*} var_args If only one argument is provided and it is an array<tr><td><a id="l640"></a><a href="#l640">640</a><td> *     then this is used as the arguments,  otherwise the arguments are used<tr><td><a id="l641"></a><a href="#l641">641</a><td> *     as the property names.<tr><td><a id="l642"></a><a href="#l642">642</a><td> * @return {!Object} The new object.<tr><td><a id="l643"></a><a href="#l643">643</a><td> */<tr><td><a id="l644"></a><a href="#l644">644</a><td>goog.object.createSet = function(var_args) {<tr><td><a id="l645"></a><a href="#l645">645</a><td>  var argLength = arguments.length;<tr><td><a id="l646"></a><a href="#l646">646</a><td>  if (argLength == 1 &amp;&amp; goog.isArray(arguments[0])) {<tr><td><a id="l647"></a><a href="#l647">647</a><td>    return goog.object.createSet.apply(null, arguments[0]);<tr><td><a id="l648"></a><a href="#l648">648</a><td>  }<tr><td><a id="l649"></a><a href="#l649">649</a><td><tr><td><a id="l650"></a><a href="#l650">650</a><td>  var rv = {};<tr><td><a id="l651"></a><a href="#l651">651</a><td>  for (var i = 0; i &lt; argLength; i++) {<tr><td><a id="l652"></a><a href="#l652">652</a><td>    rv[arguments[i]] = true;<tr><td><a id="l653"></a><a href="#l653">653</a><td>  }<tr><td><a id="l654"></a><a href="#l654">654</a><td>  return rv;<tr><td><a id="l655"></a><a href="#l655">655</a><td>};<tr><td><a id="l656"></a><a href="#l656">656</a><td><tr><td><a id="l657"></a><a href="#l657">657</a><td><tr><td><a id="l658"></a><a href="#l658">658</a><td>/**<tr><td><a id="l659"></a><a href="#l659">659</a><td> * Creates an immutable view of the underlying object, if the browser<tr><td><a id="l660"></a><a href="#l660">660</a><td> * supports immutable objects.<tr><td><a id="l661"></a><a href="#l661">661</a><td> *<tr><td><a id="l662"></a><a href="#l662">662</a><td> * In default mode, writes to this view will fail silently. In strict mode,<tr><td><a id="l663"></a><a href="#l663">663</a><td> * they will throw an error.<tr><td><a id="l664"></a><a href="#l664">664</a><td> *<tr><td><a id="l665"></a><a href="#l665">665</a><td> * @param {!Object&lt;K,V&gt;} obj An object.<tr><td><a id="l666"></a><a href="#l666">666</a><td> * @return {!Object&lt;K,V&gt;} An immutable view of that object, or the<tr><td><a id="l667"></a><a href="#l667">667</a><td> *     original object if this browser does not support immutables.<tr><td><a id="l668"></a><a href="#l668">668</a><td> * @template K,V<tr><td><a id="l669"></a><a href="#l669">669</a><td> */<tr><td><a id="l670"></a><a href="#l670">670</a><td>goog.object.createImmutableView = function(obj) {<tr><td><a id="l671"></a><a href="#l671">671</a><td>  var result = obj;<tr><td><a id="l672"></a><a href="#l672">672</a><td>  if (Object.isFrozen &amp;&amp; !Object.isFrozen(obj)) {<tr><td><a id="l673"></a><a href="#l673">673</a><td>    result = Object.create(obj);<tr><td><a id="l674"></a><a href="#l674">674</a><td>    Object.freeze(result);<tr><td><a id="l675"></a><a href="#l675">675</a><td>  }<tr><td><a id="l676"></a><a href="#l676">676</a><td>  return result;<tr><td><a id="l677"></a><a href="#l677">677</a><td>};<tr><td><a id="l678"></a><a href="#l678">678</a><td><tr><td><a id="l679"></a><a href="#l679">679</a><td><tr><td><a id="l680"></a><a href="#l680">680</a><td>/**<tr><td><a id="l681"></a><a href="#l681">681</a><td> * @param {!Object} obj An object.<tr><td><a id="l682"></a><a href="#l682">682</a><td> * @return {boolean} Whether this is an immutable view of the object.<tr><td><a id="l683"></a><a href="#l683">683</a><td> */<tr><td><a id="l684"></a><a href="#l684">684</a><td>goog.object.isImmutableView = function(obj) {<tr><td><a id="l685"></a><a href="#l685">685</a><td>  return !!Object.isFrozen &amp;&amp; Object.isFrozen(obj);<tr><td><a id="l686"></a><a href="#l686">686</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/promise/promise.js.src.html b/docs/source/lib/goog/promise/promise.js.src.html
new file mode 100644
index 0000000..a2081c3
--- /dev/null
+++ b/docs/source/lib/goog/promise/promise.js.src.html
@@ -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>promise.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/promise/promise.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.Promise&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td>goog.require(&#39;goog.Thenable&#39;);<tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l19"></a><a href="#l19">19</a><td>goog.require(&#39;goog.async.FreeList&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.require(&#39;goog.async.run&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.require(&#39;goog.async.throwException&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.debug.Error&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.promise.Resolver&#39;);<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><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * Promises provide a result that may be resolved asynchronously. A Promise may<tr><td><a id="l29"></a><a href="#l29">29</a><td> * be resolved by being fulfilled with a fulfillment value, rejected with a<tr><td><a id="l30"></a><a href="#l30">30</a><td> * rejection reason, or blocked by another Promise. A Promise is said to be<tr><td><a id="l31"></a><a href="#l31">31</a><td> * settled if it is either fulfilled or rejected. Once settled, the Promise<tr><td><a id="l32"></a><a href="#l32">32</a><td> * result is immutable.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * Promises may represent results of any type, including undefined. Rejection<tr><td><a id="l35"></a><a href="#l35">35</a><td> * reasons are typically Errors, but may also be of any type. Closure Promises<tr><td><a id="l36"></a><a href="#l36">36</a><td> * allow for optional type annotations that enforce that fulfillment values are<tr><td><a id="l37"></a><a href="#l37">37</a><td> * of the appropriate types at compile time.<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * The result of a Promise is accessible by calling {@code then} and registering<tr><td><a id="l40"></a><a href="#l40">40</a><td> * {@code onFulfilled} and {@code onRejected} callbacks. Once the Promise<tr><td><a id="l41"></a><a href="#l41">41</a><td> * is settled, the relevant callbacks are invoked with the fulfillment value or<tr><td><a id="l42"></a><a href="#l42">42</a><td> * rejection reason as argument. Callbacks are always invoked in the order they<tr><td><a id="l43"></a><a href="#l43">43</a><td> * were registered, even when additional {@code then} calls are made from inside<tr><td><a id="l44"></a><a href="#l44">44</a><td> * another callback. A callback is always run asynchronously sometime after the<tr><td><a id="l45"></a><a href="#l45">45</a><td> * scope containing the registering {@code then} invocation has returned.<tr><td><a id="l46"></a><a href="#l46">46</a><td> *<tr><td><a id="l47"></a><a href="#l47">47</a><td> * If a Promise is resolved with another Promise, the first Promise will block<tr><td><a id="l48"></a><a href="#l48">48</a><td> * until the second is settled, and then assumes the same result as the second<tr><td><a id="l49"></a><a href="#l49">49</a><td> * Promise. This allows Promises to depend on the results of other Promises,<tr><td><a id="l50"></a><a href="#l50">50</a><td> * linking together multiple asynchronous operations.<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * This implementation is compatible with the Promises/A+ specification and<tr><td><a id="l53"></a><a href="#l53">53</a><td> * passes that specification&#39;s conformance test suite. A Closure Promise may be<tr><td><a id="l54"></a><a href="#l54">54</a><td> * resolved with a Promise instance (or sufficiently compatible Promise-like<tr><td><a id="l55"></a><a href="#l55">55</a><td> * object) created by other Promise implementations. From the specification,<tr><td><a id="l56"></a><a href="#l56">56</a><td> * Promise-like objects are known as &quot;Thenables&quot;.<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @see http://promisesaplus.com/<tr><td><a id="l59"></a><a href="#l59">59</a><td> *<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {function(<tr><td><a id="l61"></a><a href="#l61">61</a><td> *             this:RESOLVER_CONTEXT,<tr><td><a id="l62"></a><a href="#l62">62</a><td> *             function((TYPE|IThenable&lt;TYPE&gt;|Thenable)=),<tr><td><a id="l63"></a><a href="#l63">63</a><td> *             function(*=)): void} resolver<tr><td><a id="l64"></a><a href="#l64">64</a><td> *     Initialization function that is invoked immediately with {@code resolve}<tr><td><a id="l65"></a><a href="#l65">65</a><td> *     and {@code reject} functions as arguments. The Promise is resolved or<tr><td><a id="l66"></a><a href="#l66">66</a><td> *     rejected with the first argument passed to either function.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @param {RESOLVER_CONTEXT=} opt_context An optional context for executing the<tr><td><a id="l68"></a><a href="#l68">68</a><td> *     resolver function. If unspecified, the resolver function will be executed<tr><td><a id="l69"></a><a href="#l69">69</a><td> *     in the default scope.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @constructor<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @struct<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @final<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @implements {goog.Thenable&lt;TYPE&gt;}<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @template TYPE,RESOLVER_CONTEXT<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.Promise = function(resolver, opt_context) {<tr><td><a id="l77"></a><a href="#l77">77</a><td>  /**<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * The internal state of this Promise. Either PENDING, FULFILLED, REJECTED, or<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * BLOCKED.<tr><td><a id="l80"></a><a href="#l80">80</a><td>   * @private {goog.Promise.State_}<tr><td><a id="l81"></a><a href="#l81">81</a><td>   */<tr><td><a id="l82"></a><a href="#l82">82</a><td>  this.state_ = goog.Promise.State_.PENDING;<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>   * The settled result of the Promise. Immutable once set with either a<tr><td><a id="l86"></a><a href="#l86">86</a><td>   * fulfillment value or rejection reason.<tr><td><a id="l87"></a><a href="#l87">87</a><td>   * @private {*}<tr><td><a id="l88"></a><a href="#l88">88</a><td>   */<tr><td><a id="l89"></a><a href="#l89">89</a><td>  this.result_ = undefined;<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>   * For Promises created by calling {@code then()}, the originating parent.<tr><td><a id="l93"></a><a href="#l93">93</a><td>   * @private {goog.Promise}<tr><td><a id="l94"></a><a href="#l94">94</a><td>   */<tr><td><a id="l95"></a><a href="#l95">95</a><td>  this.parent_ = null;<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>   * The linked list of {@code onFulfilled} and {@code onRejected} callbacks<tr><td><a id="l99"></a><a href="#l99">99</a><td>   * added to this Promise by calls to {@code then()}.<tr><td><a id="l100"></a><a href="#l100">100</a><td>   * @private {?goog.Promise.CallbackEntry_}<tr><td><a id="l101"></a><a href="#l101">101</a><td>   */<tr><td><a id="l102"></a><a href="#l102">102</a><td>  this.callbackEntries_ = null;<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>   * The tail of the linked list of {@code onFulfilled} and {@code onRejected}<tr><td><a id="l106"></a><a href="#l106">106</a><td>   * callbacks added to this Promise by calls to {@code then()}.<tr><td><a id="l107"></a><a href="#l107">107</a><td>   * @private {?goog.Promise.CallbackEntry_}<tr><td><a id="l108"></a><a href="#l108">108</a><td>   */<tr><td><a id="l109"></a><a href="#l109">109</a><td>  this.callbackEntriesTail_ = null;<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td>  /**<tr><td><a id="l112"></a><a href="#l112">112</a><td>   * Whether the Promise is in the queue of Promises to execute.<tr><td><a id="l113"></a><a href="#l113">113</a><td>   * @private {boolean}<tr><td><a id="l114"></a><a href="#l114">114</a><td>   */<tr><td><a id="l115"></a><a href="#l115">115</a><td>  this.executing_ = false;<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>  if (goog.Promise.UNHANDLED_REJECTION_DELAY &gt; 0) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    /**<tr><td><a id="l119"></a><a href="#l119">119</a><td>     * A timeout ID used when the {@code UNHANDLED_REJECTION_DELAY} is greater<tr><td><a id="l120"></a><a href="#l120">120</a><td>     * than 0 milliseconds. The ID is set when the Promise is rejected, and<tr><td><a id="l121"></a><a href="#l121">121</a><td>     * cleared only if an {@code onRejected} callback is invoked for the<tr><td><a id="l122"></a><a href="#l122">122</a><td>     * Promise (or one of its descendants) before the delay is exceeded.<tr><td><a id="l123"></a><a href="#l123">123</a><td>     *<tr><td><a id="l124"></a><a href="#l124">124</a><td>     * If the rejection is not handled before the timeout completes, the<tr><td><a id="l125"></a><a href="#l125">125</a><td>     * rejection reason is passed to the unhandled rejection handler.<tr><td><a id="l126"></a><a href="#l126">126</a><td>     * @private {number}<tr><td><a id="l127"></a><a href="#l127">127</a><td>     */<tr><td><a id="l128"></a><a href="#l128">128</a><td>    this.unhandledRejectionId_ = 0;<tr><td><a id="l129"></a><a href="#l129">129</a><td>  } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>    /**<tr><td><a id="l131"></a><a href="#l131">131</a><td>     * When the {@code UNHANDLED_REJECTION_DELAY} is set to 0 milliseconds, a<tr><td><a id="l132"></a><a href="#l132">132</a><td>     * boolean that is set if the Promise is rejected, and reset to false if an<tr><td><a id="l133"></a><a href="#l133">133</a><td>     * {@code onRejected} callback is invoked for the Promise (or one of its<tr><td><a id="l134"></a><a href="#l134">134</a><td>     * descendants). If the rejection is not handled before the next timestep,<tr><td><a id="l135"></a><a href="#l135">135</a><td>     * the rejection reason is passed to the unhandled rejection handler.<tr><td><a id="l136"></a><a href="#l136">136</a><td>     * @private {boolean}<tr><td><a id="l137"></a><a href="#l137">137</a><td>     */<tr><td><a id="l138"></a><a href="#l138">138</a><td>    this.hadUnhandledRejection_ = false;<tr><td><a id="l139"></a><a href="#l139">139</a><td>  }<tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td>  if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>    /**<tr><td><a id="l143"></a><a href="#l143">143</a><td>     * A list of stack trace frames pointing to the locations where this Promise<tr><td><a id="l144"></a><a href="#l144">144</a><td>     * was created or had callbacks added to it. Saved to add additional context<tr><td><a id="l145"></a><a href="#l145">145</a><td>     * to stack traces when an exception is thrown.<tr><td><a id="l146"></a><a href="#l146">146</a><td>     * @private {!Array&lt;string&gt;}<tr><td><a id="l147"></a><a href="#l147">147</a><td>     */<tr><td><a id="l148"></a><a href="#l148">148</a><td>    this.stack_ = [];<tr><td><a id="l149"></a><a href="#l149">149</a><td>    this.addStackTrace_(new Error(&#39;created&#39;));<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td>    /**<tr><td><a id="l152"></a><a href="#l152">152</a><td>     * Index of the most recently executed stack frame entry.<tr><td><a id="l153"></a><a href="#l153">153</a><td>     * @private {number}<tr><td><a id="l154"></a><a href="#l154">154</a><td>     */<tr><td><a id="l155"></a><a href="#l155">155</a><td>    this.currentStep_ = 0;<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>  // As an optimization, we can skip this if resolver is goog.nullFunction.<tr><td><a id="l159"></a><a href="#l159">159</a><td>  // This value is passed internally when creating a promise which will be<tr><td><a id="l160"></a><a href="#l160">160</a><td>  // resolved through a more optimized path.<tr><td><a id="l161"></a><a href="#l161">161</a><td>  if (resolver != goog.nullFunction) {<tr><td><a id="l162"></a><a href="#l162">162</a><td>    try {<tr><td><a id="l163"></a><a href="#l163">163</a><td>      var self = this;<tr><td><a id="l164"></a><a href="#l164">164</a><td>      resolver.call(<tr><td><a id="l165"></a><a href="#l165">165</a><td>          opt_context,<tr><td><a id="l166"></a><a href="#l166">166</a><td>          function(value) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>            self.resolve_(goog.Promise.State_.FULFILLED, value);<tr><td><a id="l168"></a><a href="#l168">168</a><td>          },<tr><td><a id="l169"></a><a href="#l169">169</a><td>          function(reason) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>            if (goog.DEBUG &amp;&amp;<tr><td><a id="l171"></a><a href="#l171">171</a><td>                !(reason instanceof goog.Promise.CancellationError)) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>              try {<tr><td><a id="l173"></a><a href="#l173">173</a><td>                // Promise was rejected. Step up one call frame to see why.<tr><td><a id="l174"></a><a href="#l174">174</a><td>                if (reason instanceof Error) {<tr><td><a id="l175"></a><a href="#l175">175</a><td>                  throw reason;<tr><td><a id="l176"></a><a href="#l176">176</a><td>                } else {<tr><td><a id="l177"></a><a href="#l177">177</a><td>                  throw new Error(&#39;Promise rejected.&#39;);<tr><td><a id="l178"></a><a href="#l178">178</a><td>                }<tr><td><a id="l179"></a><a href="#l179">179</a><td>              } catch (e) {<tr><td><a id="l180"></a><a href="#l180">180</a><td>                // Only thrown so browser dev tools can catch rejections of<tr><td><a id="l181"></a><a href="#l181">181</a><td>                // promises when the option to break on caught exceptions is<tr><td><a id="l182"></a><a href="#l182">182</a><td>                // activated.<tr><td><a id="l183"></a><a href="#l183">183</a><td>              }<tr><td><a id="l184"></a><a href="#l184">184</a><td>            }<tr><td><a id="l185"></a><a href="#l185">185</a><td>            self.resolve_(goog.Promise.State_.REJECTED, reason);<tr><td><a id="l186"></a><a href="#l186">186</a><td>          });<tr><td><a id="l187"></a><a href="#l187">187</a><td>    } catch (e) {<tr><td><a id="l188"></a><a href="#l188">188</a><td>      this.resolve_(goog.Promise.State_.REJECTED, e);<tr><td><a id="l189"></a><a href="#l189">189</a><td>    }<tr><td><a id="l190"></a><a href="#l190">190</a><td>  }<tr><td><a id="l191"></a><a href="#l191">191</a><td>};<tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td><tr><td><a id="l194"></a><a href="#l194">194</a><td>/**<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @define {boolean} Whether traces of {@code then} calls should be included in<tr><td><a id="l196"></a><a href="#l196">196</a><td> * exceptions thrown<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.define(&#39;goog.Promise.LONG_STACK_TRACES&#39;, false);<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> * @define {number} The delay in milliseconds before a rejected Promise&#39;s reason<tr><td><a id="l203"></a><a href="#l203">203</a><td> * is passed to the rejection handler. By default, the rejection handler<tr><td><a id="l204"></a><a href="#l204">204</a><td> * rethrows the rejection reason so that it appears in the developer console or<tr><td><a id="l205"></a><a href="#l205">205</a><td> * {@code window.onerror} handler.<tr><td><a id="l206"></a><a href="#l206">206</a><td> *<tr><td><a id="l207"></a><a href="#l207">207</a><td> * Rejections are rethrown as quickly as possible by default. A negative value<tr><td><a id="l208"></a><a href="#l208">208</a><td> * disables rejection handling entirely.<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>goog.define(&#39;goog.Promise.UNHANDLED_REJECTION_DELAY&#39;, 0);<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> * The possible internal states for a Promise. These states are not directly<tr><td><a id="l215"></a><a href="#l215">215</a><td> * observable to external callers.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @enum {number}<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @private<tr><td><a id="l218"></a><a href="#l218">218</a><td> */<tr><td><a id="l219"></a><a href="#l219">219</a><td>goog.Promise.State_ = {<tr><td><a id="l220"></a><a href="#l220">220</a><td>  /** The Promise is waiting for resolution. */<tr><td><a id="l221"></a><a href="#l221">221</a><td>  PENDING: 0,<tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td>  /** The Promise is blocked waiting for the result of another Thenable. */<tr><td><a id="l224"></a><a href="#l224">224</a><td>  BLOCKED: 1,<tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>  /** The Promise has been resolved with a fulfillment value. */<tr><td><a id="l227"></a><a href="#l227">227</a><td>  FULFILLED: 2,<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>  /** The Promise has been resolved with a rejection reason. */<tr><td><a id="l230"></a><a href="#l230">230</a><td>  REJECTED: 3<tr><td><a id="l231"></a><a href="#l231">231</a><td>};<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td><tr><td><a id="l235"></a><a href="#l235">235</a><td>/**<tr><td><a id="l236"></a><a href="#l236">236</a><td> * Entries in the callback chain. Each call to {@code then},<tr><td><a id="l237"></a><a href="#l237">237</a><td> * {@code thenCatch}, or {@code thenAlways} creates an entry containing the<tr><td><a id="l238"></a><a href="#l238">238</a><td> * functions that may be invoked once the Promise is settled.<tr><td><a id="l239"></a><a href="#l239">239</a><td> *<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @private @final @struct @constructor<tr><td><a id="l241"></a><a href="#l241">241</a><td> */<tr><td><a id="l242"></a><a href="#l242">242</a><td>goog.Promise.CallbackEntry_ = function() {<tr><td><a id="l243"></a><a href="#l243">243</a><td>  /** @type {?goog.Promise} */<tr><td><a id="l244"></a><a href="#l244">244</a><td>  this.child = null;<tr><td><a id="l245"></a><a href="#l245">245</a><td>  /** @type {Function} */<tr><td><a id="l246"></a><a href="#l246">246</a><td>  this.onFulfilled = null;<tr><td><a id="l247"></a><a href="#l247">247</a><td>  /** @type {Function} */<tr><td><a id="l248"></a><a href="#l248">248</a><td>  this.onRejected = null;<tr><td><a id="l249"></a><a href="#l249">249</a><td>  /** @type {?} */<tr><td><a id="l250"></a><a href="#l250">250</a><td>  this.context = null;<tr><td><a id="l251"></a><a href="#l251">251</a><td>  /** @type {?goog.Promise.CallbackEntry_} */<tr><td><a id="l252"></a><a href="#l252">252</a><td>  this.next = null;<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td>  /**<tr><td><a id="l255"></a><a href="#l255">255</a><td>   * A boolean value to indicate this is a &quot;thenAlways&quot; callback entry.<tr><td><a id="l256"></a><a href="#l256">256</a><td>   * Unlike a normal &quot;then/thenVoid&quot; a &quot;thenAlways doesn&#39;t participate<tr><td><a id="l257"></a><a href="#l257">257</a><td>   * in &quot;cancel&quot; considerations but is simply an observer and requires<tr><td><a id="l258"></a><a href="#l258">258</a><td>   * special handling.<tr><td><a id="l259"></a><a href="#l259">259</a><td>   * @type {boolean}<tr><td><a id="l260"></a><a href="#l260">260</a><td>   */<tr><td><a id="l261"></a><a href="#l261">261</a><td>  this.always = false;<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><tr><td><a id="l265"></a><a href="#l265">265</a><td>/** clear the object prior to reuse */<tr><td><a id="l266"></a><a href="#l266">266</a><td>goog.Promise.CallbackEntry_.prototype.reset = function() {<tr><td><a id="l267"></a><a href="#l267">267</a><td>  this.child = null;<tr><td><a id="l268"></a><a href="#l268">268</a><td>  this.onFulfilled = null;<tr><td><a id="l269"></a><a href="#l269">269</a><td>  this.onRejected = null;<tr><td><a id="l270"></a><a href="#l270">270</a><td>  this.context = null;<tr><td><a id="l271"></a><a href="#l271">271</a><td>  this.always = false;<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> * @define {number} The number of currently unused objects to keep around for<tr><td><a id="l277"></a><a href="#l277">277</a><td> *    reuse.<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>goog.define(&#39;goog.Promise.DEFAULT_MAX_UNUSED&#39;, 100);<tr><td><a id="l280"></a><a href="#l280">280</a><td><tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td>/** @const @private {goog.async.FreeList&lt;!goog.Promise.CallbackEntry_&gt;} */<tr><td><a id="l283"></a><a href="#l283">283</a><td>goog.Promise.freelist_ = new goog.async.FreeList(<tr><td><a id="l284"></a><a href="#l284">284</a><td>    function() {<tr><td><a id="l285"></a><a href="#l285">285</a><td>      return new goog.Promise.CallbackEntry_();<tr><td><a id="l286"></a><a href="#l286">286</a><td>    },<tr><td><a id="l287"></a><a href="#l287">287</a><td>    function(item) {<tr><td><a id="l288"></a><a href="#l288">288</a><td>      item.reset();<tr><td><a id="l289"></a><a href="#l289">289</a><td>    },<tr><td><a id="l290"></a><a href="#l290">290</a><td>    goog.Promise.DEFAULT_MAX_UNUSED);<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> * @param {Function} onFulfilled<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @param {Function} onRejected<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @param {?} context<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @return {!goog.Promise.CallbackEntry_}<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @private<tr><td><a id="l299"></a><a href="#l299">299</a><td> */<tr><td><a id="l300"></a><a href="#l300">300</a><td>goog.Promise.getCallbackEntry_ = function(onFulfilled, onRejected, context) {<tr><td><a id="l301"></a><a href="#l301">301</a><td>  var entry = goog.Promise.freelist_.get();<tr><td><a id="l302"></a><a href="#l302">302</a><td>  entry.onFulfilled = onFulfilled;<tr><td><a id="l303"></a><a href="#l303">303</a><td>  entry.onRejected = onRejected;<tr><td><a id="l304"></a><a href="#l304">304</a><td>  entry.context = context;<tr><td><a id="l305"></a><a href="#l305">305</a><td>  return entry;<tr><td><a id="l306"></a><a href="#l306">306</a><td>};<tr><td><a id="l307"></a><a href="#l307">307</a><td><tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td>/**<tr><td><a id="l310"></a><a href="#l310">310</a><td> * @param {!goog.Promise.CallbackEntry_} entry<tr><td><a id="l311"></a><a href="#l311">311</a><td> * @private<tr><td><a id="l312"></a><a href="#l312">312</a><td> */<tr><td><a id="l313"></a><a href="#l313">313</a><td>goog.Promise.returnEntry_ = function(entry) {<tr><td><a id="l314"></a><a href="#l314">314</a><td>  goog.Promise.freelist_.put(entry);<tr><td><a id="l315"></a><a href="#l315">315</a><td>};<tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td>// NOTE: this is the same template expression as is used for<tr><td><a id="l319"></a><a href="#l319">319</a><td>// goog.IThenable.prototype.then<tr><td><a id="l320"></a><a href="#l320">320</a><td><tr><td><a id="l321"></a><a href="#l321">321</a><td><tr><td><a id="l322"></a><a href="#l322">322</a><td>/**<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @param {VALUE=} opt_value<tr><td><a id="l324"></a><a href="#l324">324</a><td> * @return {RESULT} A new Promise that is immediately resolved<tr><td><a id="l325"></a><a href="#l325">325</a><td> *     with the given value. If the input value is already a goog.Promise, it<tr><td><a id="l326"></a><a href="#l326">326</a><td> *     will be returned immediately without creating a new instance.<tr><td><a id="l327"></a><a href="#l327">327</a><td> * @template VALUE<tr><td><a id="l328"></a><a href="#l328">328</a><td> * @template RESULT := type(&#39;goog.Promise&#39;,<tr><td><a id="l329"></a><a href="#l329">329</a><td> *     cond(isUnknown(VALUE), unknown(),<tr><td><a id="l330"></a><a href="#l330">330</a><td> *       mapunion(VALUE, (V) =&gt;<tr><td><a id="l331"></a><a href="#l331">331</a><td> *         cond(isTemplatized(V) &amp;&amp; sub(rawTypeOf(V), &#39;IThenable&#39;),<tr><td><a id="l332"></a><a href="#l332">332</a><td> *           templateTypeOf(V, 0),<tr><td><a id="l333"></a><a href="#l333">333</a><td> *           cond(sub(V, &#39;Thenable&#39;),<tr><td><a id="l334"></a><a href="#l334">334</a><td> *              unknown(),<tr><td><a id="l335"></a><a href="#l335">335</a><td> *              V)))))<tr><td><a id="l336"></a><a href="#l336">336</a><td> * =:<tr><td><a id="l337"></a><a href="#l337">337</a><td> */<tr><td><a id="l338"></a><a href="#l338">338</a><td>goog.Promise.resolve = function(opt_value) {<tr><td><a id="l339"></a><a href="#l339">339</a><td>  if (opt_value instanceof goog.Promise) {<tr><td><a id="l340"></a><a href="#l340">340</a><td>    // Avoid creating a new object if we already have a promise object<tr><td><a id="l341"></a><a href="#l341">341</a><td>    // of the correct type.<tr><td><a id="l342"></a><a href="#l342">342</a><td>    return opt_value;<tr><td><a id="l343"></a><a href="#l343">343</a><td>  }<tr><td><a id="l344"></a><a href="#l344">344</a><td><tr><td><a id="l345"></a><a href="#l345">345</a><td>  // Passing goog.nullFunction will cause the constructor to take an optimized<tr><td><a id="l346"></a><a href="#l346">346</a><td>  // path that skips calling the resolver function.<tr><td><a id="l347"></a><a href="#l347">347</a><td>  var promise = new goog.Promise(goog.nullFunction);<tr><td><a id="l348"></a><a href="#l348">348</a><td>  promise.resolve_(goog.Promise.State_.FULFILLED, opt_value);<tr><td><a id="l349"></a><a href="#l349">349</a><td>  return promise;<tr><td><a id="l350"></a><a href="#l350">350</a><td>};<tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td><tr><td><a id="l353"></a><a href="#l353">353</a><td>/**<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @param {*=} opt_reason<tr><td><a id="l355"></a><a href="#l355">355</a><td> * @return {!goog.Promise} A new Promise that is immediately rejected with the<tr><td><a id="l356"></a><a href="#l356">356</a><td> *     given reason.<tr><td><a id="l357"></a><a href="#l357">357</a><td> */<tr><td><a id="l358"></a><a href="#l358">358</a><td>goog.Promise.reject = function(opt_reason) {<tr><td><a id="l359"></a><a href="#l359">359</a><td>  return new goog.Promise(function(resolve, reject) {<tr><td><a id="l360"></a><a href="#l360">360</a><td>    reject(opt_reason);<tr><td><a id="l361"></a><a href="#l361">361</a><td>  });<tr><td><a id="l362"></a><a href="#l362">362</a><td>};<tr><td><a id="l363"></a><a href="#l363">363</a><td><tr><td><a id="l364"></a><a href="#l364">364</a><td><tr><td><a id="l365"></a><a href="#l365">365</a><td>/**<tr><td><a id="l366"></a><a href="#l366">366</a><td> * This is identical to<tr><td><a id="l367"></a><a href="#l367">367</a><td> * {@code goog.Promise.resolve(value).then(onFulfilled, onRejected)}, but it<tr><td><a id="l368"></a><a href="#l368">368</a><td> * avoids creating an unnecessary wrapper Promise when {@code value} is already<tr><td><a id="l369"></a><a href="#l369">369</a><td> * thenable.<tr><td><a id="l370"></a><a href="#l370">370</a><td> *<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @param {?(goog.Thenable&lt;TYPE&gt;|Thenable|TYPE)} value<tr><td><a id="l372"></a><a href="#l372">372</a><td> * @param {function(TYPE): ?} onFulfilled<tr><td><a id="l373"></a><a href="#l373">373</a><td> * @param {function(*): *} onRejected<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @template TYPE<tr><td><a id="l375"></a><a href="#l375">375</a><td> * @private<tr><td><a id="l376"></a><a href="#l376">376</a><td> */<tr><td><a id="l377"></a><a href="#l377">377</a><td>goog.Promise.resolveThen_ = function(value, onFulfilled, onRejected) {<tr><td><a id="l378"></a><a href="#l378">378</a><td>  var isThenable = goog.Promise.maybeThen_(<tr><td><a id="l379"></a><a href="#l379">379</a><td>      value, onFulfilled, onRejected, null);<tr><td><a id="l380"></a><a href="#l380">380</a><td>  if (!isThenable) {<tr><td><a id="l381"></a><a href="#l381">381</a><td>    goog.async.run(goog.partial(onFulfilled, value));<tr><td><a id="l382"></a><a href="#l382">382</a><td>  }<tr><td><a id="l383"></a><a href="#l383">383</a><td>};<tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td>/**<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @param {!Array&lt;?(goog.Promise&lt;TYPE&gt;|goog.Thenable&lt;TYPE&gt;|Thenable|*)&gt;}<tr><td><a id="l388"></a><a href="#l388">388</a><td> *     promises<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @return {!goog.Promise&lt;TYPE&gt;} A Promise that receives the result of the<tr><td><a id="l390"></a><a href="#l390">390</a><td> *     first Promise (or Promise-like) input to settle immediately after it<tr><td><a id="l391"></a><a href="#l391">391</a><td> *     settles.<tr><td><a id="l392"></a><a href="#l392">392</a><td> * @template TYPE<tr><td><a id="l393"></a><a href="#l393">393</a><td> */<tr><td><a id="l394"></a><a href="#l394">394</a><td>goog.Promise.race = function(promises) {<tr><td><a id="l395"></a><a href="#l395">395</a><td>  return new goog.Promise(function(resolve, reject) {<tr><td><a id="l396"></a><a href="#l396">396</a><td>    if (!promises.length) {<tr><td><a id="l397"></a><a href="#l397">397</a><td>      resolve(undefined);<tr><td><a id="l398"></a><a href="#l398">398</a><td>    }<tr><td><a id="l399"></a><a href="#l399">399</a><td>    for (var i = 0, promise; i &lt; promises.length; i++) {<tr><td><a id="l400"></a><a href="#l400">400</a><td>      promise = promises[i];<tr><td><a id="l401"></a><a href="#l401">401</a><td>      goog.Promise.resolveThen_(promise, resolve, reject);<tr><td><a id="l402"></a><a href="#l402">402</a><td>    }<tr><td><a id="l403"></a><a href="#l403">403</a><td>  });<tr><td><a id="l404"></a><a href="#l404">404</a><td>};<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td><tr><td><a id="l407"></a><a href="#l407">407</a><td>/**<tr><td><a id="l408"></a><a href="#l408">408</a><td> * @param {!Array&lt;?(goog.Promise&lt;TYPE&gt;|goog.Thenable&lt;TYPE&gt;|Thenable|*)&gt;}<tr><td><a id="l409"></a><a href="#l409">409</a><td> *     promises<tr><td><a id="l410"></a><a href="#l410">410</a><td> * @return {!goog.Promise&lt;!Array&lt;TYPE&gt;&gt;} A Promise that receives a list of<tr><td><a id="l411"></a><a href="#l411">411</a><td> *     every fulfilled value once every input Promise (or Promise-like) is<tr><td><a id="l412"></a><a href="#l412">412</a><td> *     successfully fulfilled, or is rejected with the first rejection reason<tr><td><a id="l413"></a><a href="#l413">413</a><td> *     immediately after it is rejected.<tr><td><a id="l414"></a><a href="#l414">414</a><td> * @template TYPE<tr><td><a id="l415"></a><a href="#l415">415</a><td> */<tr><td><a id="l416"></a><a href="#l416">416</a><td>goog.Promise.all = function(promises) {<tr><td><a id="l417"></a><a href="#l417">417</a><td>  return new goog.Promise(function(resolve, reject) {<tr><td><a id="l418"></a><a href="#l418">418</a><td>    var toFulfill = promises.length;<tr><td><a id="l419"></a><a href="#l419">419</a><td>    var values = [];<tr><td><a id="l420"></a><a href="#l420">420</a><td><tr><td><a id="l421"></a><a href="#l421">421</a><td>    if (!toFulfill) {<tr><td><a id="l422"></a><a href="#l422">422</a><td>      resolve(values);<tr><td><a id="l423"></a><a href="#l423">423</a><td>      return;<tr><td><a id="l424"></a><a href="#l424">424</a><td>    }<tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td>    var onFulfill = function(index, value) {<tr><td><a id="l427"></a><a href="#l427">427</a><td>      toFulfill--;<tr><td><a id="l428"></a><a href="#l428">428</a><td>      values[index] = value;<tr><td><a id="l429"></a><a href="#l429">429</a><td>      if (toFulfill == 0) {<tr><td><a id="l430"></a><a href="#l430">430</a><td>        resolve(values);<tr><td><a id="l431"></a><a href="#l431">431</a><td>      }<tr><td><a id="l432"></a><a href="#l432">432</a><td>    };<tr><td><a id="l433"></a><a href="#l433">433</a><td><tr><td><a id="l434"></a><a href="#l434">434</a><td>    var onReject = function(reason) {<tr><td><a id="l435"></a><a href="#l435">435</a><td>      reject(reason);<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>    for (var i = 0, promise; i &lt; promises.length; i++) {<tr><td><a id="l439"></a><a href="#l439">439</a><td>      promise = promises[i];<tr><td><a id="l440"></a><a href="#l440">440</a><td>      goog.Promise.resolveThen_(<tr><td><a id="l441"></a><a href="#l441">441</a><td>          promise, goog.partial(onFulfill, i), onReject);<tr><td><a id="l442"></a><a href="#l442">442</a><td>    }<tr><td><a id="l443"></a><a href="#l443">443</a><td>  });<tr><td><a id="l444"></a><a href="#l444">444</a><td>};<tr><td><a id="l445"></a><a href="#l445">445</a><td><tr><td><a id="l446"></a><a href="#l446">446</a><td><tr><td><a id="l447"></a><a href="#l447">447</a><td>/**<tr><td><a id="l448"></a><a href="#l448">448</a><td> * @param {!Array&lt;?(goog.Promise&lt;TYPE&gt;|goog.Thenable&lt;TYPE&gt;|Thenable|*)&gt;}<tr><td><a id="l449"></a><a href="#l449">449</a><td> *     promises<tr><td><a id="l450"></a><a href="#l450">450</a><td> * @return {!goog.Promise&lt;!Array&lt;{<tr><td><a id="l451"></a><a href="#l451">451</a><td> *     fulfilled: boolean,<tr><td><a id="l452"></a><a href="#l452">452</a><td> *     value: (TYPE|undefined),<tr><td><a id="l453"></a><a href="#l453">453</a><td> *     reason: (*|undefined)}&gt;&gt;} A Promise that resolves with a list of<tr><td><a id="l454"></a><a href="#l454">454</a><td> *         result objects once all input Promises (or Promise-like) have<tr><td><a id="l455"></a><a href="#l455">455</a><td> *         settled. Each result object contains a &#39;fulfilled&#39; boolean indicating<tr><td><a id="l456"></a><a href="#l456">456</a><td> *         whether an input Promise was fulfilled or rejected. For fulfilled<tr><td><a id="l457"></a><a href="#l457">457</a><td> *         Promises, the resulting value is stored in the &#39;value&#39; field. For<tr><td><a id="l458"></a><a href="#l458">458</a><td> *         rejected Promises, the rejection reason is stored in the &#39;reason&#39;<tr><td><a id="l459"></a><a href="#l459">459</a><td> *         field.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * @template TYPE<tr><td><a id="l461"></a><a href="#l461">461</a><td> */<tr><td><a id="l462"></a><a href="#l462">462</a><td>goog.Promise.allSettled = function(promises) {<tr><td><a id="l463"></a><a href="#l463">463</a><td>  return new goog.Promise(function(resolve, reject) {<tr><td><a id="l464"></a><a href="#l464">464</a><td>    var toSettle = promises.length;<tr><td><a id="l465"></a><a href="#l465">465</a><td>    var results = [];<tr><td><a id="l466"></a><a href="#l466">466</a><td><tr><td><a id="l467"></a><a href="#l467">467</a><td>    if (!toSettle) {<tr><td><a id="l468"></a><a href="#l468">468</a><td>      resolve(results);<tr><td><a id="l469"></a><a href="#l469">469</a><td>      return;<tr><td><a id="l470"></a><a href="#l470">470</a><td>    }<tr><td><a id="l471"></a><a href="#l471">471</a><td><tr><td><a id="l472"></a><a href="#l472">472</a><td>    var onSettled = function(index, fulfilled, result) {<tr><td><a id="l473"></a><a href="#l473">473</a><td>      toSettle--;<tr><td><a id="l474"></a><a href="#l474">474</a><td>      results[index] = fulfilled ?<tr><td><a id="l475"></a><a href="#l475">475</a><td>          {fulfilled: true, value: result} :<tr><td><a id="l476"></a><a href="#l476">476</a><td>          {fulfilled: false, reason: result};<tr><td><a id="l477"></a><a href="#l477">477</a><td>      if (toSettle == 0) {<tr><td><a id="l478"></a><a href="#l478">478</a><td>        resolve(results);<tr><td><a id="l479"></a><a href="#l479">479</a><td>      }<tr><td><a id="l480"></a><a href="#l480">480</a><td>    };<tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td>    for (var i = 0, promise; i &lt; promises.length; i++) {<tr><td><a id="l483"></a><a href="#l483">483</a><td>      promise = promises[i];<tr><td><a id="l484"></a><a href="#l484">484</a><td>      goog.Promise.resolveThen_(promise,<tr><td><a id="l485"></a><a href="#l485">485</a><td>          goog.partial(onSettled, i, true /* fulfilled */),<tr><td><a id="l486"></a><a href="#l486">486</a><td>          goog.partial(onSettled, i, false /* fulfilled */));<tr><td><a id="l487"></a><a href="#l487">487</a><td>    }<tr><td><a id="l488"></a><a href="#l488">488</a><td>  });<tr><td><a id="l489"></a><a href="#l489">489</a><td>};<tr><td><a id="l490"></a><a href="#l490">490</a><td><tr><td><a id="l491"></a><a href="#l491">491</a><td><tr><td><a id="l492"></a><a href="#l492">492</a><td>/**<tr><td><a id="l493"></a><a href="#l493">493</a><td> * @param {!Array&lt;?(goog.Promise&lt;TYPE&gt;|goog.Thenable&lt;TYPE&gt;|Thenable|*)&gt;}<tr><td><a id="l494"></a><a href="#l494">494</a><td> *     promises<tr><td><a id="l495"></a><a href="#l495">495</a><td> * @return {!goog.Promise&lt;TYPE&gt;} A Promise that receives the value of the first<tr><td><a id="l496"></a><a href="#l496">496</a><td> *     input to be fulfilled, or is rejected with a list of every rejection<tr><td><a id="l497"></a><a href="#l497">497</a><td> *     reason if all inputs are rejected.<tr><td><a id="l498"></a><a href="#l498">498</a><td> * @template TYPE<tr><td><a id="l499"></a><a href="#l499">499</a><td> */<tr><td><a id="l500"></a><a href="#l500">500</a><td>goog.Promise.firstFulfilled = function(promises) {<tr><td><a id="l501"></a><a href="#l501">501</a><td>  return new goog.Promise(function(resolve, reject) {<tr><td><a id="l502"></a><a href="#l502">502</a><td>    var toReject = promises.length;<tr><td><a id="l503"></a><a href="#l503">503</a><td>    var reasons = [];<tr><td><a id="l504"></a><a href="#l504">504</a><td><tr><td><a id="l505"></a><a href="#l505">505</a><td>    if (!toReject) {<tr><td><a id="l506"></a><a href="#l506">506</a><td>      resolve(undefined);<tr><td><a id="l507"></a><a href="#l507">507</a><td>      return;<tr><td><a id="l508"></a><a href="#l508">508</a><td>    }<tr><td><a id="l509"></a><a href="#l509">509</a><td><tr><td><a id="l510"></a><a href="#l510">510</a><td>    var onFulfill = function(value) {<tr><td><a id="l511"></a><a href="#l511">511</a><td>      resolve(value);<tr><td><a id="l512"></a><a href="#l512">512</a><td>    };<tr><td><a id="l513"></a><a href="#l513">513</a><td><tr><td><a id="l514"></a><a href="#l514">514</a><td>    var onReject = function(index, reason) {<tr><td><a id="l515"></a><a href="#l515">515</a><td>      toReject--;<tr><td><a id="l516"></a><a href="#l516">516</a><td>      reasons[index] = reason;<tr><td><a id="l517"></a><a href="#l517">517</a><td>      if (toReject == 0) {<tr><td><a id="l518"></a><a href="#l518">518</a><td>        reject(reasons);<tr><td><a id="l519"></a><a href="#l519">519</a><td>      }<tr><td><a id="l520"></a><a href="#l520">520</a><td>    };<tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td>    for (var i = 0, promise; i &lt; promises.length; i++) {<tr><td><a id="l523"></a><a href="#l523">523</a><td>      promise = promises[i];<tr><td><a id="l524"></a><a href="#l524">524</a><td>      goog.Promise.resolveThen_(<tr><td><a id="l525"></a><a href="#l525">525</a><td>          promise, onFulfill, goog.partial(onReject, i));<tr><td><a id="l526"></a><a href="#l526">526</a><td>    }<tr><td><a id="l527"></a><a href="#l527">527</a><td>  });<tr><td><a id="l528"></a><a href="#l528">528</a><td>};<tr><td><a id="l529"></a><a href="#l529">529</a><td><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 {!goog.promise.Resolver&lt;TYPE&gt;} Resolver wrapping the promise and its<tr><td><a id="l533"></a><a href="#l533">533</a><td> *     resolve / reject functions. Resolving or rejecting the resolver<tr><td><a id="l534"></a><a href="#l534">534</a><td> *     resolves or rejects the promise.<tr><td><a id="l535"></a><a href="#l535">535</a><td> * @template TYPE<tr><td><a id="l536"></a><a href="#l536">536</a><td> */<tr><td><a id="l537"></a><a href="#l537">537</a><td>goog.Promise.withResolver = function() {<tr><td><a id="l538"></a><a href="#l538">538</a><td>  var resolve, reject;<tr><td><a id="l539"></a><a href="#l539">539</a><td>  var promise = new goog.Promise(function(rs, rj) {<tr><td><a id="l540"></a><a href="#l540">540</a><td>    resolve = rs;<tr><td><a id="l541"></a><a href="#l541">541</a><td>    reject = rj;<tr><td><a id="l542"></a><a href="#l542">542</a><td>  });<tr><td><a id="l543"></a><a href="#l543">543</a><td>  return new goog.Promise.Resolver_(promise, resolve, reject);<tr><td><a id="l544"></a><a href="#l544">544</a><td>};<tr><td><a id="l545"></a><a href="#l545">545</a><td><tr><td><a id="l546"></a><a href="#l546">546</a><td><tr><td><a id="l547"></a><a href="#l547">547</a><td>/**<tr><td><a id="l548"></a><a href="#l548">548</a><td> * Adds callbacks that will operate on the result of the Promise, returning a<tr><td><a id="l549"></a><a href="#l549">549</a><td> * new child Promise.<tr><td><a id="l550"></a><a href="#l550">550</a><td> *<tr><td><a id="l551"></a><a href="#l551">551</a><td> * If the Promise is fulfilled, the {@code onFulfilled} callback will be invoked<tr><td><a id="l552"></a><a href="#l552">552</a><td> * with the fulfillment value as argument, and the child Promise will be<tr><td><a id="l553"></a><a href="#l553">553</a><td> * fulfilled with the return value of the callback. If the callback throws an<tr><td><a id="l554"></a><a href="#l554">554</a><td> * exception, the child Promise will be rejected with the thrown value instead.<tr><td><a id="l555"></a><a href="#l555">555</a><td> *<tr><td><a id="l556"></a><a href="#l556">556</a><td> * If the Promise is rejected, the {@code onRejected} callback will be invoked<tr><td><a id="l557"></a><a href="#l557">557</a><td> * with the rejection reason as argument, and the child Promise will be resolved<tr><td><a id="l558"></a><a href="#l558">558</a><td> * with the return value or rejected with the thrown value of the callback.<tr><td><a id="l559"></a><a href="#l559">559</a><td> *<tr><td><a id="l560"></a><a href="#l560">560</a><td> * @override<tr><td><a id="l561"></a><a href="#l561">561</a><td> */<tr><td><a id="l562"></a><a href="#l562">562</a><td>goog.Promise.prototype.then = function(<tr><td><a id="l563"></a><a href="#l563">563</a><td>    opt_onFulfilled, opt_onRejected, opt_context) {<tr><td><a id="l564"></a><a href="#l564">564</a><td><tr><td><a id="l565"></a><a href="#l565">565</a><td>  if (opt_onFulfilled != null) {<tr><td><a id="l566"></a><a href="#l566">566</a><td>    goog.asserts.assertFunction(opt_onFulfilled,<tr><td><a id="l567"></a><a href="#l567">567</a><td>        &#39;opt_onFulfilled should be a function.&#39;);<tr><td><a id="l568"></a><a href="#l568">568</a><td>  }<tr><td><a id="l569"></a><a href="#l569">569</a><td>  if (opt_onRejected != null) {<tr><td><a id="l570"></a><a href="#l570">570</a><td>    goog.asserts.assertFunction(opt_onRejected,<tr><td><a id="l571"></a><a href="#l571">571</a><td>        &#39;opt_onRejected should be a function. Did you pass opt_context &#39; +<tr><td><a id="l572"></a><a href="#l572">572</a><td>        &#39;as the second argument instead of the third?&#39;);<tr><td><a id="l573"></a><a href="#l573">573</a><td>  }<tr><td><a id="l574"></a><a href="#l574">574</a><td><tr><td><a id="l575"></a><a href="#l575">575</a><td>  if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l576"></a><a href="#l576">576</a><td>    this.addStackTrace_(new Error(&#39;then&#39;));<tr><td><a id="l577"></a><a href="#l577">577</a><td>  }<tr><td><a id="l578"></a><a href="#l578">578</a><td><tr><td><a id="l579"></a><a href="#l579">579</a><td>  return this.addChildPromise_(<tr><td><a id="l580"></a><a href="#l580">580</a><td>      goog.isFunction(opt_onFulfilled) ? opt_onFulfilled : null,<tr><td><a id="l581"></a><a href="#l581">581</a><td>      goog.isFunction(opt_onRejected) ? opt_onRejected : null,<tr><td><a id="l582"></a><a href="#l582">582</a><td>      opt_context);<tr><td><a id="l583"></a><a href="#l583">583</a><td>};<tr><td><a id="l584"></a><a href="#l584">584</a><td>goog.Thenable.addImplementation(goog.Promise);<tr><td><a id="l585"></a><a href="#l585">585</a><td><tr><td><a id="l586"></a><a href="#l586">586</a><td><tr><td><a id="l587"></a><a href="#l587">587</a><td>/**<tr><td><a id="l588"></a><a href="#l588">588</a><td> * Adds callbacks that will operate on the result of the Promise without<tr><td><a id="l589"></a><a href="#l589">589</a><td> * returning a child Promise (unlike &quot;then&quot;).<tr><td><a id="l590"></a><a href="#l590">590</a><td> *<tr><td><a id="l591"></a><a href="#l591">591</a><td> * If the Promise is fulfilled, the {@code onFulfilled} callback will be invoked<tr><td><a id="l592"></a><a href="#l592">592</a><td> * with the fulfillment value as argument.<tr><td><a id="l593"></a><a href="#l593">593</a><td> *<tr><td><a id="l594"></a><a href="#l594">594</a><td> * If the Promise is rejected, the {@code onRejected} callback will be invoked<tr><td><a id="l595"></a><a href="#l595">595</a><td> * with the rejection reason as argument.<tr><td><a id="l596"></a><a href="#l596">596</a><td> *<tr><td><a id="l597"></a><a href="#l597">597</a><td> * @param {?(function(this:THIS, TYPE):?)=} opt_onFulfilled A<tr><td><a id="l598"></a><a href="#l598">598</a><td> *     function that will be invoked with the fulfillment value if the Promise<tr><td><a id="l599"></a><a href="#l599">599</a><td> *     is fulfilled.<tr><td><a id="l600"></a><a href="#l600">600</a><td> * @param {?(function(this:THIS, *): *)=} opt_onRejected A function that will<tr><td><a id="l601"></a><a href="#l601">601</a><td> *     be invoked with the rejection reason if the Promise is rejected.<tr><td><a id="l602"></a><a href="#l602">602</a><td> * @param {THIS=} opt_context An optional context object that will be the<tr><td><a id="l603"></a><a href="#l603">603</a><td> *     execution context for the callbacks. By default, functions are executed<tr><td><a id="l604"></a><a href="#l604">604</a><td> *     with the default this.<tr><td><a id="l605"></a><a href="#l605">605</a><td> * @package<tr><td><a id="l606"></a><a href="#l606">606</a><td> * @template THIS<tr><td><a id="l607"></a><a href="#l607">607</a><td> */<tr><td><a id="l608"></a><a href="#l608">608</a><td>goog.Promise.prototype.thenVoid = function(<tr><td><a id="l609"></a><a href="#l609">609</a><td>    opt_onFulfilled, opt_onRejected, opt_context) {<tr><td><a id="l610"></a><a href="#l610">610</a><td><tr><td><a id="l611"></a><a href="#l611">611</a><td>  if (opt_onFulfilled != null) {<tr><td><a id="l612"></a><a href="#l612">612</a><td>    goog.asserts.assertFunction(opt_onFulfilled,<tr><td><a id="l613"></a><a href="#l613">613</a><td>        &#39;opt_onFulfilled should be a function.&#39;);<tr><td><a id="l614"></a><a href="#l614">614</a><td>  }<tr><td><a id="l615"></a><a href="#l615">615</a><td>  if (opt_onRejected != null) {<tr><td><a id="l616"></a><a href="#l616">616</a><td>    goog.asserts.assertFunction(opt_onRejected,<tr><td><a id="l617"></a><a href="#l617">617</a><td>        &#39;opt_onRejected should be a function. Did you pass opt_context &#39; +<tr><td><a id="l618"></a><a href="#l618">618</a><td>        &#39;as the second argument instead of the third?&#39;);<tr><td><a id="l619"></a><a href="#l619">619</a><td>  }<tr><td><a id="l620"></a><a href="#l620">620</a><td><tr><td><a id="l621"></a><a href="#l621">621</a><td>  if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l622"></a><a href="#l622">622</a><td>    this.addStackTrace_(new Error(&#39;then&#39;));<tr><td><a id="l623"></a><a href="#l623">623</a><td>  }<tr><td><a id="l624"></a><a href="#l624">624</a><td><tr><td><a id="l625"></a><a href="#l625">625</a><td>  // Note: no default rejection handler is provided here as we need to<tr><td><a id="l626"></a><a href="#l626">626</a><td>  // distinguish unhandled rejections.<tr><td><a id="l627"></a><a href="#l627">627</a><td>  this.addCallbackEntry_(goog.Promise.getCallbackEntry_(<tr><td><a id="l628"></a><a href="#l628">628</a><td>      opt_onFulfilled || goog.nullFunction,<tr><td><a id="l629"></a><a href="#l629">629</a><td>      opt_onRejected || null,<tr><td><a id="l630"></a><a href="#l630">630</a><td>      opt_context));<tr><td><a id="l631"></a><a href="#l631">631</a><td>};<tr><td><a id="l632"></a><a href="#l632">632</a><td><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> * Adds a callback that will be invoked when the Promise is settled (fulfilled<tr><td><a id="l636"></a><a href="#l636">636</a><td> * or rejected). The callback receives no argument, and no new child Promise is<tr><td><a id="l637"></a><a href="#l637">637</a><td> * created. This is useful for ensuring that cleanup takes place after certain<tr><td><a id="l638"></a><a href="#l638">638</a><td> * asynchronous operations. Callbacks added with {@code thenAlways} will be<tr><td><a id="l639"></a><a href="#l639">639</a><td> * executed in the same order with other calls to {@code then},<tr><td><a id="l640"></a><a href="#l640">640</a><td> * {@code thenAlways}, or {@code thenCatch}.<tr><td><a id="l641"></a><a href="#l641">641</a><td> *<tr><td><a id="l642"></a><a href="#l642">642</a><td> * Since it does not produce a new child Promise, cancellation propagation is<tr><td><a id="l643"></a><a href="#l643">643</a><td> * not prevented by adding callbacks with {@code thenAlways}. A Promise that has<tr><td><a id="l644"></a><a href="#l644">644</a><td> * a cleanup handler added with {@code thenAlways} will be canceled if all of<tr><td><a id="l645"></a><a href="#l645">645</a><td> * its children created by {@code then} (or {@code thenCatch}) are canceled.<tr><td><a id="l646"></a><a href="#l646">646</a><td> * Additionally, since any rejections are not passed to the callback, it does<tr><td><a id="l647"></a><a href="#l647">647</a><td> * not stop the unhandled rejection handler from running.<tr><td><a id="l648"></a><a href="#l648">648</a><td> *<tr><td><a id="l649"></a><a href="#l649">649</a><td> * @param {function(this:THIS): void} onSettled A function that will be invoked<tr><td><a id="l650"></a><a href="#l650">650</a><td> *     when the Promise is settled (fulfilled or rejected).<tr><td><a id="l651"></a><a href="#l651">651</a><td> * @param {THIS=} opt_context An optional context object that will be the<tr><td><a id="l652"></a><a href="#l652">652</a><td> *     execution context for the callbacks. By default, functions are executed<tr><td><a id="l653"></a><a href="#l653">653</a><td> *     in the global scope.<tr><td><a id="l654"></a><a href="#l654">654</a><td> * @return {!goog.Promise&lt;TYPE&gt;} This Promise, for chaining additional calls.<tr><td><a id="l655"></a><a href="#l655">655</a><td> * @template THIS<tr><td><a id="l656"></a><a href="#l656">656</a><td> */<tr><td><a id="l657"></a><a href="#l657">657</a><td>goog.Promise.prototype.thenAlways = function(onSettled, opt_context) {<tr><td><a id="l658"></a><a href="#l658">658</a><td>  if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l659"></a><a href="#l659">659</a><td>    this.addStackTrace_(new Error(&#39;thenAlways&#39;));<tr><td><a id="l660"></a><a href="#l660">660</a><td>  }<tr><td><a id="l661"></a><a href="#l661">661</a><td><tr><td><a id="l662"></a><a href="#l662">662</a><td>  var entry = goog.Promise.getCallbackEntry_(onSettled, onSettled, opt_context);<tr><td><a id="l663"></a><a href="#l663">663</a><td>  entry.always = true;<tr><td><a id="l664"></a><a href="#l664">664</a><td>  this.addCallbackEntry_(entry);<tr><td><a id="l665"></a><a href="#l665">665</a><td>  return this;<tr><td><a id="l666"></a><a href="#l666">666</a><td>};<tr><td><a id="l667"></a><a href="#l667">667</a><td><tr><td><a id="l668"></a><a href="#l668">668</a><td><tr><td><a id="l669"></a><a href="#l669">669</a><td>/**<tr><td><a id="l670"></a><a href="#l670">670</a><td> * Adds a callback that will be invoked only if the Promise is rejected. This<tr><td><a id="l671"></a><a href="#l671">671</a><td> * is equivalent to {@code then(null, onRejected)}.<tr><td><a id="l672"></a><a href="#l672">672</a><td> *<tr><td><a id="l673"></a><a href="#l673">673</a><td> * @param {!function(this:THIS, *): *} onRejected A function that will be<tr><td><a id="l674"></a><a href="#l674">674</a><td> *     invoked with the rejection reason if the Promise is rejected.<tr><td><a id="l675"></a><a href="#l675">675</a><td> * @param {THIS=} opt_context An optional context object that will be the<tr><td><a id="l676"></a><a href="#l676">676</a><td> *     execution context for the callbacks. By default, functions are executed<tr><td><a id="l677"></a><a href="#l677">677</a><td> *     in the global scope.<tr><td><a id="l678"></a><a href="#l678">678</a><td> * @return {!goog.Promise} A new Promise that will receive the result of the<tr><td><a id="l679"></a><a href="#l679">679</a><td> *     callback.<tr><td><a id="l680"></a><a href="#l680">680</a><td> * @template THIS<tr><td><a id="l681"></a><a href="#l681">681</a><td> */<tr><td><a id="l682"></a><a href="#l682">682</a><td>goog.Promise.prototype.thenCatch = function(onRejected, opt_context) {<tr><td><a id="l683"></a><a href="#l683">683</a><td>  if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l684"></a><a href="#l684">684</a><td>    this.addStackTrace_(new Error(&#39;thenCatch&#39;));<tr><td><a id="l685"></a><a href="#l685">685</a><td>  }<tr><td><a id="l686"></a><a href="#l686">686</a><td>  return this.addChildPromise_(null, onRejected, opt_context);<tr><td><a id="l687"></a><a href="#l687">687</a><td>};<tr><td><a id="l688"></a><a href="#l688">688</a><td><tr><td><a id="l689"></a><a href="#l689">689</a><td><tr><td><a id="l690"></a><a href="#l690">690</a><td>/**<tr><td><a id="l691"></a><a href="#l691">691</a><td> * Cancels the Promise if it is still pending by rejecting it with a cancel<tr><td><a id="l692"></a><a href="#l692">692</a><td> * Error. No action is performed if the Promise is already resolved.<tr><td><a id="l693"></a><a href="#l693">693</a><td> *<tr><td><a id="l694"></a><a href="#l694">694</a><td> * All child Promises of the canceled Promise will be rejected with the same<tr><td><a id="l695"></a><a href="#l695">695</a><td> * cancel error, as with normal Promise rejection. If the Promise to be canceled<tr><td><a id="l696"></a><a href="#l696">696</a><td> * is the only child of a pending Promise, the parent Promise will also be<tr><td><a id="l697"></a><a href="#l697">697</a><td> * canceled. Cancellation may propagate upward through multiple generations.<tr><td><a id="l698"></a><a href="#l698">698</a><td> *<tr><td><a id="l699"></a><a href="#l699">699</a><td> * @param {string=} opt_message An optional debugging message for describing the<tr><td><a id="l700"></a><a href="#l700">700</a><td> *     cancellation reason.<tr><td><a id="l701"></a><a href="#l701">701</a><td> */<tr><td><a id="l702"></a><a href="#l702">702</a><td>goog.Promise.prototype.cancel = function(opt_message) {<tr><td><a id="l703"></a><a href="#l703">703</a><td>  if (this.state_ == goog.Promise.State_.PENDING) {<tr><td><a id="l704"></a><a href="#l704">704</a><td>    goog.async.run(function() {<tr><td><a id="l705"></a><a href="#l705">705</a><td>      var err = new goog.Promise.CancellationError(opt_message);<tr><td><a id="l706"></a><a href="#l706">706</a><td>      this.cancelInternal_(err);<tr><td><a id="l707"></a><a href="#l707">707</a><td>    }, this);<tr><td><a id="l708"></a><a href="#l708">708</a><td>  }<tr><td><a id="l709"></a><a href="#l709">709</a><td>};<tr><td><a id="l710"></a><a href="#l710">710</a><td><tr><td><a id="l711"></a><a href="#l711">711</a><td><tr><td><a id="l712"></a><a href="#l712">712</a><td>/**<tr><td><a id="l713"></a><a href="#l713">713</a><td> * Cancels this Promise with the given error.<tr><td><a id="l714"></a><a href="#l714">714</a><td> *<tr><td><a id="l715"></a><a href="#l715">715</a><td> * @param {!Error} err The cancellation error.<tr><td><a id="l716"></a><a href="#l716">716</a><td> * @private<tr><td><a id="l717"></a><a href="#l717">717</a><td> */<tr><td><a id="l718"></a><a href="#l718">718</a><td>goog.Promise.prototype.cancelInternal_ = function(err) {<tr><td><a id="l719"></a><a href="#l719">719</a><td>  if (this.state_ == goog.Promise.State_.PENDING) {<tr><td><a id="l720"></a><a href="#l720">720</a><td>    if (this.parent_) {<tr><td><a id="l721"></a><a href="#l721">721</a><td>      // Cancel the Promise and remove it from the parent&#39;s child list.<tr><td><a id="l722"></a><a href="#l722">722</a><td>      this.parent_.cancelChild_(this, err);<tr><td><a id="l723"></a><a href="#l723">723</a><td>      this.parent_ = null;<tr><td><a id="l724"></a><a href="#l724">724</a><td>    } else {<tr><td><a id="l725"></a><a href="#l725">725</a><td>      this.resolve_(goog.Promise.State_.REJECTED, err);<tr><td><a id="l726"></a><a href="#l726">726</a><td>    }<tr><td><a id="l727"></a><a href="#l727">727</a><td>  }<tr><td><a id="l728"></a><a href="#l728">728</a><td>};<tr><td><a id="l729"></a><a href="#l729">729</a><td><tr><td><a id="l730"></a><a href="#l730">730</a><td><tr><td><a id="l731"></a><a href="#l731">731</a><td>/**<tr><td><a id="l732"></a><a href="#l732">732</a><td> * Cancels a child Promise from the list of callback entries. If the Promise has<tr><td><a id="l733"></a><a href="#l733">733</a><td> * not already been resolved, reject it with a cancel error. If there are no<tr><td><a id="l734"></a><a href="#l734">734</a><td> * other children in the list of callback entries, propagate the cancellation<tr><td><a id="l735"></a><a href="#l735">735</a><td> * by canceling this Promise as well.<tr><td><a id="l736"></a><a href="#l736">736</a><td> *<tr><td><a id="l737"></a><a href="#l737">737</a><td> * @param {!goog.Promise} childPromise The Promise to cancel.<tr><td><a id="l738"></a><a href="#l738">738</a><td> * @param {!Error} err The cancel error to use for rejecting the Promise.<tr><td><a id="l739"></a><a href="#l739">739</a><td> * @private<tr><td><a id="l740"></a><a href="#l740">740</a><td> */<tr><td><a id="l741"></a><a href="#l741">741</a><td>goog.Promise.prototype.cancelChild_ = function(childPromise, err) {<tr><td><a id="l742"></a><a href="#l742">742</a><td>  if (!this.callbackEntries_) {<tr><td><a id="l743"></a><a href="#l743">743</a><td>    return;<tr><td><a id="l744"></a><a href="#l744">744</a><td>  }<tr><td><a id="l745"></a><a href="#l745">745</a><td>  var childCount = 0;<tr><td><a id="l746"></a><a href="#l746">746</a><td>  var childEntry = null;<tr><td><a id="l747"></a><a href="#l747">747</a><td>  var beforeChildEntry = null;<tr><td><a id="l748"></a><a href="#l748">748</a><td><tr><td><a id="l749"></a><a href="#l749">749</a><td>  // Find the callback entry for the childPromise, and count whether there are<tr><td><a id="l750"></a><a href="#l750">750</a><td>  // additional child Promises.<tr><td><a id="l751"></a><a href="#l751">751</a><td>  for (var entry = this.callbackEntries_; entry; entry = entry.next) {<tr><td><a id="l752"></a><a href="#l752">752</a><td>    if (!entry.always) {<tr><td><a id="l753"></a><a href="#l753">753</a><td>      childCount++;<tr><td><a id="l754"></a><a href="#l754">754</a><td>      if (entry.child == childPromise) {<tr><td><a id="l755"></a><a href="#l755">755</a><td>        childEntry = entry;<tr><td><a id="l756"></a><a href="#l756">756</a><td>      }<tr><td><a id="l757"></a><a href="#l757">757</a><td>      if (childEntry &amp;&amp; childCount &gt; 1) {<tr><td><a id="l758"></a><a href="#l758">758</a><td>        break;<tr><td><a id="l759"></a><a href="#l759">759</a><td>      }<tr><td><a id="l760"></a><a href="#l760">760</a><td>    }<tr><td><a id="l761"></a><a href="#l761">761</a><td>    if (!childEntry) {<tr><td><a id="l762"></a><a href="#l762">762</a><td>      beforeChildEntry = entry;<tr><td><a id="l763"></a><a href="#l763">763</a><td>    }<tr><td><a id="l764"></a><a href="#l764">764</a><td>  }<tr><td><a id="l765"></a><a href="#l765">765</a><td><tr><td><a id="l766"></a><a href="#l766">766</a><td>  // Can a child entry be missing?<tr><td><a id="l767"></a><a href="#l767">767</a><td><tr><td><a id="l768"></a><a href="#l768">768</a><td>  // If the child Promise was the only child, cancel this Promise as well.<tr><td><a id="l769"></a><a href="#l769">769</a><td>  // Otherwise, reject only the child Promise with the cancel error.<tr><td><a id="l770"></a><a href="#l770">770</a><td>  if (childEntry) {<tr><td><a id="l771"></a><a href="#l771">771</a><td>    if (this.state_ == goog.Promise.State_.PENDING &amp;&amp; childCount == 1) {<tr><td><a id="l772"></a><a href="#l772">772</a><td>      this.cancelInternal_(err);<tr><td><a id="l773"></a><a href="#l773">773</a><td>    } else {<tr><td><a id="l774"></a><a href="#l774">774</a><td>      if (beforeChildEntry) {<tr><td><a id="l775"></a><a href="#l775">775</a><td>        this.removeEntryAfter_(beforeChildEntry);<tr><td><a id="l776"></a><a href="#l776">776</a><td>      } else {<tr><td><a id="l777"></a><a href="#l777">777</a><td>        this.popEntry_();<tr><td><a id="l778"></a><a href="#l778">778</a><td>      }<tr><td><a id="l779"></a><a href="#l779">779</a><td><tr><td><a id="l780"></a><a href="#l780">780</a><td>      this.executeCallback_(<tr><td><a id="l781"></a><a href="#l781">781</a><td>          childEntry, goog.Promise.State_.REJECTED, err);<tr><td><a id="l782"></a><a href="#l782">782</a><td>    }<tr><td><a id="l783"></a><a href="#l783">783</a><td>  }<tr><td><a id="l784"></a><a href="#l784">784</a><td>};<tr><td><a id="l785"></a><a href="#l785">785</a><td><tr><td><a id="l786"></a><a href="#l786">786</a><td><tr><td><a id="l787"></a><a href="#l787">787</a><td>/**<tr><td><a id="l788"></a><a href="#l788">788</a><td> * Adds a callback entry to the current Promise, and schedules callback<tr><td><a id="l789"></a><a href="#l789">789</a><td> * execution if the Promise has already been settled.<tr><td><a id="l790"></a><a href="#l790">790</a><td> *<tr><td><a id="l791"></a><a href="#l791">791</a><td> * @param {goog.Promise.CallbackEntry_} callbackEntry Record containing<tr><td><a id="l792"></a><a href="#l792">792</a><td> *     {@code onFulfilled} and {@code onRejected} callbacks to execute after<tr><td><a id="l793"></a><a href="#l793">793</a><td> *     the Promise is settled.<tr><td><a id="l794"></a><a href="#l794">794</a><td> * @private<tr><td><a id="l795"></a><a href="#l795">795</a><td> */<tr><td><a id="l796"></a><a href="#l796">796</a><td>goog.Promise.prototype.addCallbackEntry_ = function(callbackEntry) {<tr><td><a id="l797"></a><a href="#l797">797</a><td>  if (!this.hasEntry_() &amp;&amp;<tr><td><a id="l798"></a><a href="#l798">798</a><td>      (this.state_ == goog.Promise.State_.FULFILLED ||<tr><td><a id="l799"></a><a href="#l799">799</a><td>       this.state_ == goog.Promise.State_.REJECTED)) {<tr><td><a id="l800"></a><a href="#l800">800</a><td>    this.scheduleCallbacks_();<tr><td><a id="l801"></a><a href="#l801">801</a><td>  }<tr><td><a id="l802"></a><a href="#l802">802</a><td>  this.queueEntry_(callbackEntry);<tr><td><a id="l803"></a><a href="#l803">803</a><td>};<tr><td><a id="l804"></a><a href="#l804">804</a><td><tr><td><a id="l805"></a><a href="#l805">805</a><td><tr><td><a id="l806"></a><a href="#l806">806</a><td>/**<tr><td><a id="l807"></a><a href="#l807">807</a><td> * Creates a child Promise and adds it to the callback entry list. The result of<tr><td><a id="l808"></a><a href="#l808">808</a><td> * the child Promise is determined by the state of the parent Promise and the<tr><td><a id="l809"></a><a href="#l809">809</a><td> * result of the {@code onFulfilled} or {@code onRejected} callbacks as<tr><td><a id="l810"></a><a href="#l810">810</a><td> * specified in the Promise resolution procedure.<tr><td><a id="l811"></a><a href="#l811">811</a><td> *<tr><td><a id="l812"></a><a href="#l812">812</a><td> * @see http://promisesaplus.com/#the__method<tr><td><a id="l813"></a><a href="#l813">813</a><td> *<tr><td><a id="l814"></a><a href="#l814">814</a><td> * @param {?function(this:THIS, TYPE):<tr><td><a id="l815"></a><a href="#l815">815</a><td> *          (RESULT|goog.Promise&lt;RESULT&gt;|Thenable)} onFulfilled A callback that<tr><td><a id="l816"></a><a href="#l816">816</a><td> *     will be invoked if the Promise is fullfilled, or null.<tr><td><a id="l817"></a><a href="#l817">817</a><td> * @param {?function(this:THIS, *): *} onRejected A callback that will be<tr><td><a id="l818"></a><a href="#l818">818</a><td> *     invoked if the Promise is rejected, or null.<tr><td><a id="l819"></a><a href="#l819">819</a><td> * @param {THIS=} opt_context An optional execution context for the callbacks.<tr><td><a id="l820"></a><a href="#l820">820</a><td> *     in the default calling context.<tr><td><a id="l821"></a><a href="#l821">821</a><td> * @return {!goog.Promise} The child Promise.<tr><td><a id="l822"></a><a href="#l822">822</a><td> * @template RESULT,THIS<tr><td><a id="l823"></a><a href="#l823">823</a><td> * @private<tr><td><a id="l824"></a><a href="#l824">824</a><td> */<tr><td><a id="l825"></a><a href="#l825">825</a><td>goog.Promise.prototype.addChildPromise_ = function(<tr><td><a id="l826"></a><a href="#l826">826</a><td>    onFulfilled, onRejected, opt_context) {<tr><td><a id="l827"></a><a href="#l827">827</a><td><tr><td><a id="l828"></a><a href="#l828">828</a><td>  /** @type {goog.Promise.CallbackEntry_} */<tr><td><a id="l829"></a><a href="#l829">829</a><td>  var callbackEntry = goog.Promise.getCallbackEntry_(null, null, null);<tr><td><a id="l830"></a><a href="#l830">830</a><td><tr><td><a id="l831"></a><a href="#l831">831</a><td>  callbackEntry.child = new goog.Promise(function(resolve, reject) {<tr><td><a id="l832"></a><a href="#l832">832</a><td>    // Invoke onFulfilled, or resolve with the parent&#39;s value if absent.<tr><td><a id="l833"></a><a href="#l833">833</a><td>    callbackEntry.onFulfilled = onFulfilled ? function(value) {<tr><td><a id="l834"></a><a href="#l834">834</a><td>      try {<tr><td><a id="l835"></a><a href="#l835">835</a><td>        var result = onFulfilled.call(opt_context, value);<tr><td><a id="l836"></a><a href="#l836">836</a><td>        resolve(result);<tr><td><a id="l837"></a><a href="#l837">837</a><td>      } catch (err) {<tr><td><a id="l838"></a><a href="#l838">838</a><td>        reject(err);<tr><td><a id="l839"></a><a href="#l839">839</a><td>      }<tr><td><a id="l840"></a><a href="#l840">840</a><td>    } : resolve;<tr><td><a id="l841"></a><a href="#l841">841</a><td><tr><td><a id="l842"></a><a href="#l842">842</a><td>    // Invoke onRejected, or reject with the parent&#39;s reason if absent.<tr><td><a id="l843"></a><a href="#l843">843</a><td>    callbackEntry.onRejected = onRejected ? function(reason) {<tr><td><a id="l844"></a><a href="#l844">844</a><td>      try {<tr><td><a id="l845"></a><a href="#l845">845</a><td>        var result = onRejected.call(opt_context, reason);<tr><td><a id="l846"></a><a href="#l846">846</a><td>        if (!goog.isDef(result) &amp;&amp;<tr><td><a id="l847"></a><a href="#l847">847</a><td>            reason instanceof goog.Promise.CancellationError) {<tr><td><a id="l848"></a><a href="#l848">848</a><td>          // Propagate cancellation to children if no other result is returned.<tr><td><a id="l849"></a><a href="#l849">849</a><td>          reject(reason);<tr><td><a id="l850"></a><a href="#l850">850</a><td>        } else {<tr><td><a id="l851"></a><a href="#l851">851</a><td>          resolve(result);<tr><td><a id="l852"></a><a href="#l852">852</a><td>        }<tr><td><a id="l853"></a><a href="#l853">853</a><td>      } catch (err) {<tr><td><a id="l854"></a><a href="#l854">854</a><td>        reject(err);<tr><td><a id="l855"></a><a href="#l855">855</a><td>      }<tr><td><a id="l856"></a><a href="#l856">856</a><td>    } : reject;<tr><td><a id="l857"></a><a href="#l857">857</a><td>  });<tr><td><a id="l858"></a><a href="#l858">858</a><td><tr><td><a id="l859"></a><a href="#l859">859</a><td>  callbackEntry.child.parent_ = this;<tr><td><a id="l860"></a><a href="#l860">860</a><td>  this.addCallbackEntry_(callbackEntry);<tr><td><a id="l861"></a><a href="#l861">861</a><td>  return callbackEntry.child;<tr><td><a id="l862"></a><a href="#l862">862</a><td>};<tr><td><a id="l863"></a><a href="#l863">863</a><td><tr><td><a id="l864"></a><a href="#l864">864</a><td><tr><td><a id="l865"></a><a href="#l865">865</a><td>/**<tr><td><a id="l866"></a><a href="#l866">866</a><td> * Unblocks the Promise and fulfills it with the given value.<tr><td><a id="l867"></a><a href="#l867">867</a><td> *<tr><td><a id="l868"></a><a href="#l868">868</a><td> * @param {TYPE} value<tr><td><a id="l869"></a><a href="#l869">869</a><td> * @private<tr><td><a id="l870"></a><a href="#l870">870</a><td> */<tr><td><a id="l871"></a><a href="#l871">871</a><td>goog.Promise.prototype.unblockAndFulfill_ = function(value) {<tr><td><a id="l872"></a><a href="#l872">872</a><td>  goog.asserts.assert(this.state_ == goog.Promise.State_.BLOCKED);<tr><td><a id="l873"></a><a href="#l873">873</a><td>  this.state_ = goog.Promise.State_.PENDING;<tr><td><a id="l874"></a><a href="#l874">874</a><td>  this.resolve_(goog.Promise.State_.FULFILLED, value);<tr><td><a id="l875"></a><a href="#l875">875</a><td>};<tr><td><a id="l876"></a><a href="#l876">876</a><td><tr><td><a id="l877"></a><a href="#l877">877</a><td><tr><td><a id="l878"></a><a href="#l878">878</a><td>/**<tr><td><a id="l879"></a><a href="#l879">879</a><td> * Unblocks the Promise and rejects it with the given rejection reason.<tr><td><a id="l880"></a><a href="#l880">880</a><td> *<tr><td><a id="l881"></a><a href="#l881">881</a><td> * @param {*} reason<tr><td><a id="l882"></a><a href="#l882">882</a><td> * @private<tr><td><a id="l883"></a><a href="#l883">883</a><td> */<tr><td><a id="l884"></a><a href="#l884">884</a><td>goog.Promise.prototype.unblockAndReject_ = function(reason) {<tr><td><a id="l885"></a><a href="#l885">885</a><td>  goog.asserts.assert(this.state_ == goog.Promise.State_.BLOCKED);<tr><td><a id="l886"></a><a href="#l886">886</a><td>  this.state_ = goog.Promise.State_.PENDING;<tr><td><a id="l887"></a><a href="#l887">887</a><td>  this.resolve_(goog.Promise.State_.REJECTED, reason);<tr><td><a id="l888"></a><a href="#l888">888</a><td>};<tr><td><a id="l889"></a><a href="#l889">889</a><td><tr><td><a id="l890"></a><a href="#l890">890</a><td><tr><td><a id="l891"></a><a href="#l891">891</a><td>/**<tr><td><a id="l892"></a><a href="#l892">892</a><td> * Attempts to resolve a Promise with a given resolution state and value. This<tr><td><a id="l893"></a><a href="#l893">893</a><td> * is a no-op if the given Promise has already been resolved.<tr><td><a id="l894"></a><a href="#l894">894</a><td> *<tr><td><a id="l895"></a><a href="#l895">895</a><td> * If the given result is a Thenable (such as another Promise), the Promise will<tr><td><a id="l896"></a><a href="#l896">896</a><td> * be settled with the same state and result as the Thenable once it is itself<tr><td><a id="l897"></a><a href="#l897">897</a><td> * settled.<tr><td><a id="l898"></a><a href="#l898">898</a><td> *<tr><td><a id="l899"></a><a href="#l899">899</a><td> * If the given result is not a Thenable, the Promise will be settled (fulfilled<tr><td><a id="l900"></a><a href="#l900">900</a><td> * or rejected) with that result based on the given state.<tr><td><a id="l901"></a><a href="#l901">901</a><td> *<tr><td><a id="l902"></a><a href="#l902">902</a><td> * @see http://promisesaplus.com/#the_promise_resolution_procedure<tr><td><a id="l903"></a><a href="#l903">903</a><td> *<tr><td><a id="l904"></a><a href="#l904">904</a><td> * @param {goog.Promise.State_} state<tr><td><a id="l905"></a><a href="#l905">905</a><td> * @param {*} x The result to apply to the Promise.<tr><td><a id="l906"></a><a href="#l906">906</a><td> * @private<tr><td><a id="l907"></a><a href="#l907">907</a><td> */<tr><td><a id="l908"></a><a href="#l908">908</a><td>goog.Promise.prototype.resolve_ = function(state, x) {<tr><td><a id="l909"></a><a href="#l909">909</a><td>  if (this.state_ != goog.Promise.State_.PENDING) {<tr><td><a id="l910"></a><a href="#l910">910</a><td>    return;<tr><td><a id="l911"></a><a href="#l911">911</a><td>  }<tr><td><a id="l912"></a><a href="#l912">912</a><td><tr><td><a id="l913"></a><a href="#l913">913</a><td>  if (this == x) {<tr><td><a id="l914"></a><a href="#l914">914</a><td>    state = goog.Promise.State_.REJECTED;<tr><td><a id="l915"></a><a href="#l915">915</a><td>    x = new TypeError(&#39;Promise cannot resolve to itself&#39;);<tr><td><a id="l916"></a><a href="#l916">916</a><td>  }<tr><td><a id="l917"></a><a href="#l917">917</a><td><tr><td><a id="l918"></a><a href="#l918">918</a><td>  this.state_ = goog.Promise.State_.BLOCKED;<tr><td><a id="l919"></a><a href="#l919">919</a><td>  var isThenable = goog.Promise.maybeThen_(<tr><td><a id="l920"></a><a href="#l920">920</a><td>      x, this.unblockAndFulfill_, this.unblockAndReject_, this);<tr><td><a id="l921"></a><a href="#l921">921</a><td>  if (isThenable) {<tr><td><a id="l922"></a><a href="#l922">922</a><td>    return;<tr><td><a id="l923"></a><a href="#l923">923</a><td>  }<tr><td><a id="l924"></a><a href="#l924">924</a><td><tr><td><a id="l925"></a><a href="#l925">925</a><td>  this.result_ = x;<tr><td><a id="l926"></a><a href="#l926">926</a><td>  this.state_ = state;<tr><td><a id="l927"></a><a href="#l927">927</a><td>  // Since we can no longer be canceled, remove link to parent, so that the<tr><td><a id="l928"></a><a href="#l928">928</a><td>  // child promise does not keep the parent promise alive.<tr><td><a id="l929"></a><a href="#l929">929</a><td>  this.parent_ = null;<tr><td><a id="l930"></a><a href="#l930">930</a><td>  this.scheduleCallbacks_();<tr><td><a id="l931"></a><a href="#l931">931</a><td><tr><td><a id="l932"></a><a href="#l932">932</a><td>  if (state == goog.Promise.State_.REJECTED &amp;&amp;<tr><td><a id="l933"></a><a href="#l933">933</a><td>      !(x instanceof goog.Promise.CancellationError)) {<tr><td><a id="l934"></a><a href="#l934">934</a><td>    goog.Promise.addUnhandledRejection_(this, x);<tr><td><a id="l935"></a><a href="#l935">935</a><td>  }<tr><td><a id="l936"></a><a href="#l936">936</a><td>};<tr><td><a id="l937"></a><a href="#l937">937</a><td><tr><td><a id="l938"></a><a href="#l938">938</a><td><tr><td><a id="l939"></a><a href="#l939">939</a><td>/**<tr><td><a id="l940"></a><a href="#l940">940</a><td> * Invokes the &quot;then&quot; method of an input value if that value is a Thenable. This<tr><td><a id="l941"></a><a href="#l941">941</a><td> * is a no-op if the value is not thenable.<tr><td><a id="l942"></a><a href="#l942">942</a><td> *<tr><td><a id="l943"></a><a href="#l943">943</a><td> * @param {?} value A potentially thenable value.<tr><td><a id="l944"></a><a href="#l944">944</a><td> * @param {!Function} onFulfilled<tr><td><a id="l945"></a><a href="#l945">945</a><td> * @param {!Function} onRejected<tr><td><a id="l946"></a><a href="#l946">946</a><td> * @param {?} context<tr><td><a id="l947"></a><a href="#l947">947</a><td> * @return {boolean} Whether the input value was thenable.<tr><td><a id="l948"></a><a href="#l948">948</a><td> * @private<tr><td><a id="l949"></a><a href="#l949">949</a><td> */<tr><td><a id="l950"></a><a href="#l950">950</a><td>goog.Promise.maybeThen_ = function(value, onFulfilled, onRejected, context) {<tr><td><a id="l951"></a><a href="#l951">951</a><td>  if (value instanceof goog.Promise) {<tr><td><a id="l952"></a><a href="#l952">952</a><td>    value.thenVoid(onFulfilled, onRejected, context);<tr><td><a id="l953"></a><a href="#l953">953</a><td>    return true;<tr><td><a id="l954"></a><a href="#l954">954</a><td>  } else if (goog.Thenable.isImplementedBy(value)) {<tr><td><a id="l955"></a><a href="#l955">955</a><td>    value = /** @type {!goog.Thenable} */ (value);<tr><td><a id="l956"></a><a href="#l956">956</a><td>    value.then(onFulfilled, onRejected, context);<tr><td><a id="l957"></a><a href="#l957">957</a><td>    return true;<tr><td><a id="l958"></a><a href="#l958">958</a><td>  } else if (goog.isObject(value)) {<tr><td><a id="l959"></a><a href="#l959">959</a><td>    try {<tr><td><a id="l960"></a><a href="#l960">960</a><td>      var then = value[&#39;then&#39;];<tr><td><a id="l961"></a><a href="#l961">961</a><td>      if (goog.isFunction(then)) {<tr><td><a id="l962"></a><a href="#l962">962</a><td>        goog.Promise.tryThen_(<tr><td><a id="l963"></a><a href="#l963">963</a><td>            value, then, onFulfilled, onRejected, context);<tr><td><a id="l964"></a><a href="#l964">964</a><td>        return true;<tr><td><a id="l965"></a><a href="#l965">965</a><td>      }<tr><td><a id="l966"></a><a href="#l966">966</a><td>    } catch (e) {<tr><td><a id="l967"></a><a href="#l967">967</a><td>      onRejected.call(context, e);<tr><td><a id="l968"></a><a href="#l968">968</a><td>      return true;<tr><td><a id="l969"></a><a href="#l969">969</a><td>    }<tr><td><a id="l970"></a><a href="#l970">970</a><td>  }<tr><td><a id="l971"></a><a href="#l971">971</a><td><tr><td><a id="l972"></a><a href="#l972">972</a><td>  return false;<tr><td><a id="l973"></a><a href="#l973">973</a><td>};<tr><td><a id="l974"></a><a href="#l974">974</a><td><tr><td><a id="l975"></a><a href="#l975">975</a><td><tr><td><a id="l976"></a><a href="#l976">976</a><td>/**<tr><td><a id="l977"></a><a href="#l977">977</a><td> * Attempts to call the {@code then} method on an object in the hopes that it is<tr><td><a id="l978"></a><a href="#l978">978</a><td> * a Promise-compatible instance. This allows interoperation between different<tr><td><a id="l979"></a><a href="#l979">979</a><td> * Promise implementations, however a non-compliant object may cause a Promise<tr><td><a id="l980"></a><a href="#l980">980</a><td> * to hang indefinitely. If the {@code then} method throws an exception, the<tr><td><a id="l981"></a><a href="#l981">981</a><td> * dependent Promise will be rejected with the thrown value.<tr><td><a id="l982"></a><a href="#l982">982</a><td> *<tr><td><a id="l983"></a><a href="#l983">983</a><td> * @see http://promisesaplus.com/#point-70<tr><td><a id="l984"></a><a href="#l984">984</a><td> *<tr><td><a id="l985"></a><a href="#l985">985</a><td> * @param {Thenable} thenable An object with a {@code then} method that may be<tr><td><a id="l986"></a><a href="#l986">986</a><td> *     compatible with the Promise/A+ specification.<tr><td><a id="l987"></a><a href="#l987">987</a><td> * @param {!Function} then The {@code then} method of the Thenable object.<tr><td><a id="l988"></a><a href="#l988">988</a><td> * @param {!Function} onFulfilled<tr><td><a id="l989"></a><a href="#l989">989</a><td> * @param {!Function} onRejected<tr><td><a id="l990"></a><a href="#l990">990</a><td> * @param {*} context<tr><td><a id="l991"></a><a href="#l991">991</a><td> * @private<tr><td><a id="l992"></a><a href="#l992">992</a><td> */<tr><td><a id="l993"></a><a href="#l993">993</a><td>goog.Promise.tryThen_ = function(<tr><td><a id="l994"></a><a href="#l994">994</a><td>    thenable, then, onFulfilled, onRejected, context) {<tr><td><a id="l995"></a><a href="#l995">995</a><td><tr><td><a id="l996"></a><a href="#l996">996</a><td>  var called = false;<tr><td><a id="l997"></a><a href="#l997">997</a><td>  var resolve = function(value) {<tr><td><a id="l998"></a><a href="#l998">998</a><td>    if (!called) {<tr><td><a id="l999"></a><a href="#l999">999</a><td>      called = true;<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td>      onFulfilled.call(context, value);<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td>    }<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td>  };<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td><tr><td><a id="l1004"></a><a href="#l1004">1004</a><td>  var reject = function(reason) {<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td>    if (!called) {<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td>      called = true;<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>      onRejected.call(context, reason);<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td>    }<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td>  };<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td><tr><td><a id="l1011"></a><a href="#l1011">1011</a><td>  try {<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td>    then.call(thenable, resolve, reject);<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td>  } catch (e) {<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td>    reject(e);<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>  }<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td>};<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td><tr><td><a id="l1018"></a><a href="#l1018">1018</a><td><tr><td><a id="l1019"></a><a href="#l1019">1019</a><td>/**<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td> * Executes the pending callbacks of a settled Promise after a timeout.<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td> *<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td> * Section 2.2.4 of the Promises/A+ specification requires that Promise<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td> * callbacks must only be invoked from a call stack that only contains Promise<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td> * implementation code, which we accomplish by invoking callback execution after<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td> * a timeout. If {@code startExecution_} is called multiple times for the same<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td> * Promise, the callback chain will be evaluated only once. Additional callbacks<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td> * may be added during the evaluation phase, and will be executed in the same<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td> * event loop.<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td> *<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td> * All Promises added to the waiting list during the same browser event loop<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td> * will be executed in one batch to avoid using a separate timeout per Promise.<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td> *<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td> * @private<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td> */<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>goog.Promise.prototype.scheduleCallbacks_ = function() {<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>  if (!this.executing_) {<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td>    this.executing_ = true;<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td>    goog.async.run(this.executeCallbacks_, this);<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>  }<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>};<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td><tr><td><a id="l1042"></a><a href="#l1042">1042</a><td><tr><td><a id="l1043"></a><a href="#l1043">1043</a><td>/**<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td> * @return {boolean} Whether there are any pending callbacks queued.<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td> * @private<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td> */<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td>goog.Promise.prototype.hasEntry_ = function() {<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>  return !!this.callbackEntries_;<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td>};<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td><tr><td><a id="l1051"></a><a href="#l1051">1051</a><td><tr><td><a id="l1052"></a><a href="#l1052">1052</a><td>/**<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td> * @param {goog.Promise.CallbackEntry_} entry<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td> * @private<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td> */<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td>goog.Promise.prototype.queueEntry_ = function(entry) {<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td>  goog.asserts.assert(entry.onFulfilled != null);<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td><tr><td><a id="l1059"></a><a href="#l1059">1059</a><td>  if (this.callbackEntriesTail_) {<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td>    this.callbackEntriesTail_.next = entry;<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td>    this.callbackEntriesTail_ = entry;<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td>  } else {<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td>    // It the work queue was empty set the head too.<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td>    this.callbackEntries_ = entry;<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td>    this.callbackEntriesTail_ = entry;<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td>  }<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>};<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td><tr><td><a id="l1069"></a><a href="#l1069">1069</a><td><tr><td><a id="l1070"></a><a href="#l1070">1070</a><td>/**<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td> * @return {goog.Promise.CallbackEntry_} entry<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td> * @private<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td> */<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>goog.Promise.prototype.popEntry_ = function() {<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td>  var entry = null;<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td>  if (this.callbackEntries_) {<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td>    entry = this.callbackEntries_;<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td>    this.callbackEntries_ = entry.next;<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td>    entry.next = null;<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>  }<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td>  // It the work queue is empty clear the tail too.<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td>  if (!this.callbackEntries_) {<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>    this.callbackEntriesTail_ = null;<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td>  }<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td><tr><td><a id="l1086"></a><a href="#l1086">1086</a><td>  if (entry != null) {<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>    goog.asserts.assert(entry.onFulfilled != null);<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>  }<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>  return entry;<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>};<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td><tr><td><a id="l1092"></a><a href="#l1092">1092</a><td><tr><td><a id="l1093"></a><a href="#l1093">1093</a><td>/**<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td> * @param {goog.Promise.CallbackEntry_} previous<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td> * @private<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td> */<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>goog.Promise.prototype.removeEntryAfter_ = function(previous) {<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td>  goog.asserts.assert(this.callbackEntries_);<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td>  goog.asserts.assert(previous != null);<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>  // If the last entry is being removed, update the tail<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td>  if (previous.next == this.callbackEntriesTail_) {<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td>    this.callbackEntriesTail_ = previous;<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td>  }<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td><tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>  previous.next = previous.next.next;<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td>};<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td><tr><td><a id="l1108"></a><a href="#l1108">1108</a><td><tr><td><a id="l1109"></a><a href="#l1109">1109</a><td>/**<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td> * Executes all pending callbacks for this Promise.<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td> *<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td> * @private<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td> */<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td>goog.Promise.prototype.executeCallbacks_ = function() {<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td>  var entry = null;<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td>  while (entry = this.popEntry_()) {<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td>    if (goog.Promise.LONG_STACK_TRACES) {<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td>      this.currentStep_++;<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td>    }<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td>    this.executeCallback_(entry, this.state_, this.result_);<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td>  }<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td>  this.executing_ = false;<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td>};<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td><tr><td><a id="l1125"></a><a href="#l1125">1125</a><td><tr><td><a id="l1126"></a><a href="#l1126">1126</a><td>/**<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td> * Executes a pending callback for this Promise. Invokes an {@code onFulfilled}<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td> * or {@code onRejected} callback based on the settled state of the Promise.<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td> *<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td> * @param {!goog.Promise.CallbackEntry_} callbackEntry An entry containing the<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td> *     onFulfilled and/or onRejected callbacks for this step.<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td> * @param {goog.Promise.State_} state The resolution status of the Promise,<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td> *     either FULFILLED or REJECTED.<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td> * @param {*} result The settled result of the Promise.<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td> * @private<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td> */<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td>goog.Promise.prototype.executeCallback_ = function(<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td>    callbackEntry, state, result) {<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>  // Cancel an unhandled rejection if the then/thenVoid call had an onRejected.<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td>  if (state == goog.Promise.State_.REJECTED &amp;&amp;<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td>      callbackEntry.onRejected &amp;&amp; !callbackEntry.always) {<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>    this.removeUnhandledRejection_();<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>  }<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td><tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>  if (callbackEntry.child) {<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>    // When the parent is settled, the child no longer needs to hold on to it,<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td>    // as the parent can no longer be canceled.<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td>    callbackEntry.child.parent_ = null;<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td>    goog.Promise.invokeCallback_(callbackEntry, state, result);<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>  } else {<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td>    // Callbacks created with thenAlways or thenVoid do not have the rejection<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td>    // handling code normally set up in the child Promise.<tr><td><a id="l1153"></a><a href="#l1153">1153</a><td>    try {<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td>      callbackEntry.always ?<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td>          callbackEntry.onFulfilled.call(callbackEntry.context) :<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td>          goog.Promise.invokeCallback_(callbackEntry, state, result);<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td>    } catch (err) {<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td>      goog.Promise.handleRejection_.call(null, err);<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td>    }<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td>  }<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td>  goog.Promise.returnEntry_(callbackEntry);<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td>};<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td><tr><td><a id="l1164"></a><a href="#l1164">1164</a><td><tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>/**<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td> * Executes the onFulfilled or onRejected callback for a callbackEntry.<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td> *<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td> * @param {!goog.Promise.CallbackEntry_} callbackEntry<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td> * @param {goog.Promise.State_} state<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td> * @param {*} result<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td> * @private<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td> */<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td>goog.Promise.invokeCallback_ = function(callbackEntry, state, result) {<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td>  if (state == goog.Promise.State_.FULFILLED) {<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td>    callbackEntry.onFulfilled.call(callbackEntry.context, result);<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td>  } else if (callbackEntry.onRejected) {<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td>    callbackEntry.onRejected.call(callbackEntry.context, result);<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td>  }<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td>};<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td><tr><td><a id="l1181"></a><a href="#l1181">1181</a><td><tr><td><a id="l1182"></a><a href="#l1182">1182</a><td>/**<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td> * Records a stack trace entry for functions that call {@code then} or the<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td> * Promise constructor. May be disabled by unsetting {@code LONG_STACK_TRACES}.<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td> *<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td> * @param {!Error} err An Error object created by the calling function for<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td> *     providing a stack trace.<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td> * @private<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td> */<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td>goog.Promise.prototype.addStackTrace_ = function(err) {<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td>  if (goog.Promise.LONG_STACK_TRACES &amp;&amp; goog.isString(err.stack)) {<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>    // Extract the third line of the stack trace, which is the entry for the<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>    // user function that called into Promise code.<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td>    var trace = err.stack.split(&#39;\n&#39;, 4)[3];<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>    var message = err.message;<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td><tr><td><a id="l1197"></a><a href="#l1197">1197</a><td>    // Pad the message to align the traces.<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td>    message += Array(11 - message.length).join(&#39; &#39;);<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td>    this.stack_.push(message + trace);<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td>  }<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td>};<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td><tr><td><a id="l1203"></a><a href="#l1203">1203</a><td><tr><td><a id="l1204"></a><a href="#l1204">1204</a><td>/**<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td> * Adds extra stack trace information to an exception for the list of<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td> * asynchronous {@code then} calls that have been run for this Promise. Stack<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td> * trace information is recorded in {@see #addStackTrace_}, and appended to<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td> * rethrown errors when {@code LONG_STACK_TRACES} is enabled.<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td> *<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td> * @param {*} err An unhandled exception captured during callback execution.<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td> * @private<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td> */<tr><td><a id="l1213"></a><a href="#l1213">1213</a><td>goog.Promise.prototype.appendLongStack_ = function(err) {<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td>  if (goog.Promise.LONG_STACK_TRACES &amp;&amp;<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td>      err &amp;&amp; goog.isString(err.stack) &amp;&amp; this.stack_.length) {<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td>    var longTrace = [&#39;Promise trace:&#39;];<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td><tr><td><a id="l1218"></a><a href="#l1218">1218</a><td>    for (var promise = this; promise; promise = promise.parent_) {<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td>      for (var i = this.currentStep_; i &gt;= 0; i--) {<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td>        longTrace.push(promise.stack_[i]);<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td>      }<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>      longTrace.push(&#39;Value: &#39; +<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>          &#39;[&#39; + (promise.state_ == goog.Promise.State_.REJECTED ?<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td>              &#39;REJECTED&#39; : &#39;FULFILLED&#39;) + &#39;] &#39; +<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td>          &#39;&lt;&#39; + String(promise.result_) + &#39;&gt;&#39;);<tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>    }<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td>    err.stack += &#39;\n\n&#39; + longTrace.join(&#39;\n&#39;);<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td>  }<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td>};<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td><tr><td><a id="l1231"></a><a href="#l1231">1231</a><td><tr><td><a id="l1232"></a><a href="#l1232">1232</a><td>/**<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td> * Marks this rejected Promise as having being handled. Also marks any parent<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td> * Promises in the rejected state as handled. The rejection handler will no<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td> * longer be invoked for this Promise (if it has not been called already).<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td> *<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td> * @private<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td> */<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>goog.Promise.prototype.removeUnhandledRejection_ = function() {<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td>  if (goog.Promise.UNHANDLED_REJECTION_DELAY &gt; 0) {<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td>    for (var p = this; p &amp;&amp; p.unhandledRejectionId_; p = p.parent_) {<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td>      goog.global.clearTimeout(p.unhandledRejectionId_);<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td>      p.unhandledRejectionId_ = 0;<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td>    }<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td>  } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td>    for (var p = this; p &amp;&amp; p.hadUnhandledRejection_; p = p.parent_) {<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>      p.hadUnhandledRejection_ = false;<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>    }<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>  }<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>};<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td><tr><td><a id="l1252"></a><a href="#l1252">1252</a><td><tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>/**<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td> * Marks this rejected Promise as unhandled. If no {@code onRejected} callback<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td> * is called for this Promise before the {@code UNHANDLED_REJECTION_DELAY}<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td> * expires, the reason will be passed to the unhandled rejection handler. The<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td> * handler typically rethrows the rejection reason so that it becomes visible in<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td> * the developer console.<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td> *<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td> * @param {!goog.Promise} promise The rejected Promise.<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td> * @param {*} reason The Promise rejection reason.<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td> * @private<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td> */<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>goog.Promise.addUnhandledRejection_ = function(promise, reason) {<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>  if (goog.Promise.UNHANDLED_REJECTION_DELAY &gt; 0) {<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>    promise.unhandledRejectionId_ = goog.global.setTimeout(function() {<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>      promise.appendLongStack_(reason);<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td>      goog.Promise.handleRejection_.call(null, reason);<tr><td><a id="l1269"></a><a href="#l1269">1269</a><td>    }, goog.Promise.UNHANDLED_REJECTION_DELAY);<tr><td><a id="l1270"></a><a href="#l1270">1270</a><td><tr><td><a id="l1271"></a><a href="#l1271">1271</a><td>  } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td>    promise.hadUnhandledRejection_ = true;<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td>    goog.async.run(function() {<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td>      if (promise.hadUnhandledRejection_) {<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td>        promise.appendLongStack_(reason);<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td>        goog.Promise.handleRejection_.call(null, reason);<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td>      }<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>    });<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>  }<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td>};<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td><tr><td><a id="l1282"></a><a href="#l1282">1282</a><td><tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>/**<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td> * A method that is invoked with the rejection reasons for Promises that are<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td> * rejected but have no {@code onRejected} callbacks registered yet.<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td> * @type {function(*)}<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td> * @private<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td> */<tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>goog.Promise.handleRejection_ = goog.async.throwException;<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td><tr><td><a id="l1291"></a><a href="#l1291">1291</a><td><tr><td><a id="l1292"></a><a href="#l1292">1292</a><td>/**<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td> * Sets a handler that will be called with reasons from unhandled rejected<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td> * Promises. If the rejected Promise (or one of its descendants) has an<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td> * {@code onRejected} callback registered, the rejection will be considered<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td> * handled, and the rejection handler will not be called.<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td> *<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td> * By default, unhandled rejections are rethrown so that the error may be<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td> * captured by the developer console or a {@code window.onerror} handler.<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td> *<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td> * @param {function(*)} handler A function that will be called with reasons from<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td> *     rejected Promises. Defaults to {@code goog.async.throwException}.<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td> */<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>goog.Promise.setUnhandledRejectionHandler = function(handler) {<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td>  goog.Promise.handleRejection_ = handler;<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td>};<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td><tr><td><a id="l1308"></a><a href="#l1308">1308</a><td><tr><td><a id="l1309"></a><a href="#l1309">1309</a><td><tr><td><a id="l1310"></a><a href="#l1310">1310</a><td>/**<tr><td><a id="l1311"></a><a href="#l1311">1311</a><td> * Error used as a rejection reason for canceled Promises.<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td> *<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td> * @param {string=} opt_message<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td> * @constructor<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td> * @extends {goog.debug.Error}<tr><td><a id="l1316"></a><a href="#l1316">1316</a><td> * @final<tr><td><a id="l1317"></a><a href="#l1317">1317</a><td> */<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td>goog.Promise.CancellationError = function(opt_message) {<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td>  goog.Promise.CancellationError.base(this, &#39;constructor&#39;, opt_message);<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td>};<tr><td><a id="l1321"></a><a href="#l1321">1321</a><td>goog.inherits(goog.Promise.CancellationError, goog.debug.Error);<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td><tr><td><a id="l1323"></a><a href="#l1323">1323</a><td><tr><td><a id="l1324"></a><a href="#l1324">1324</a><td>/** @override */<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td>goog.Promise.CancellationError.prototype.name = &#39;cancel&#39;;<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td><tr><td><a id="l1327"></a><a href="#l1327">1327</a><td><tr><td><a id="l1328"></a><a href="#l1328">1328</a><td><tr><td><a id="l1329"></a><a href="#l1329">1329</a><td>/**<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td> * Internal implementation of the resolver interface.<tr><td><a id="l1331"></a><a href="#l1331">1331</a><td> *<tr><td><a id="l1332"></a><a href="#l1332">1332</a><td> * @param {!goog.Promise&lt;TYPE&gt;} promise<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td> * @param {function((TYPE|goog.Promise&lt;TYPE&gt;|Thenable)=)} resolve<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td> * @param {function(*=): void} reject<tr><td><a id="l1335"></a><a href="#l1335">1335</a><td> * @implements {goog.promise.Resolver&lt;TYPE&gt;}<tr><td><a id="l1336"></a><a href="#l1336">1336</a><td> * @final @struct<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td> * @constructor<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td> * @private<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td> * @template TYPE<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td> */<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td>goog.Promise.Resolver_ = function(promise, resolve, reject) {<tr><td><a id="l1342"></a><a href="#l1342">1342</a><td>  /** @const */<tr><td><a id="l1343"></a><a href="#l1343">1343</a><td>  this.promise = promise;<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td><tr><td><a id="l1345"></a><a href="#l1345">1345</a><td>  /** @const */<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td>  this.resolve = resolve;<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td><tr><td><a id="l1348"></a><a href="#l1348">1348</a><td>  /** @const */<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td>  this.reject = reject;<tr><td><a id="l1350"></a><a href="#l1350">1350</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/promise/resolver.js.src.html b/docs/source/lib/goog/promise/resolver.js.src.html
new file mode 100644
index 0000000..2c307f5
--- /dev/null
+++ b/docs/source/lib/goog/promise/resolver.js.src.html
@@ -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>resolver.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/promise/resolver.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.promise.Resolver&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Resolver interface for promises. The resolver is a convenience interface that<tr><td><a id="l21"></a><a href="#l21">21</a><td> * bundles the promise and its associated resolve and reject functions together,<tr><td><a id="l22"></a><a href="#l22">22</a><td> * for cases where the resolver needs to be persisted internally.<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> * @template TYPE<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.promise.Resolver = 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> * The promise that created this resolver.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @type {!goog.Promise&lt;TYPE&gt;}<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.promise.Resolver.prototype.promise;<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> * Resolves this resolver with the specified value.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @type {function((TYPE|goog.Promise&lt;TYPE&gt;|Thenable)=)}<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.promise.Resolver.prototype.resolve;<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> * Rejects this resolver with the specified reason.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @type {function(*=): void}<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.promise.Resolver.prototype.reject;</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/promise/thenable.js.src.html b/docs/source/lib/goog/promise/thenable.js.src.html
new file mode 100644
index 0000000..8fe1d98
--- /dev/null
+++ b/docs/source/lib/goog/promise/thenable.js.src.html
@@ -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>thenable.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/promise/thenable.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.Thenable&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Provides a more strict interface for Thenables in terms of<tr><td><a id="l21"></a><a href="#l21">21</a><td> * http://promisesaplus.com for interop with {@see goog.Promise}.<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * @interface<tr><td><a id="l24"></a><a href="#l24">24</a><td> * @extends {IThenable&lt;TYPE&gt;}<tr><td><a id="l25"></a><a href="#l25">25</a><td> * @template TYPE<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.Thenable = 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> * Adds callbacks that will operate on the result of the Thenable, returning a<tr><td><a id="l32"></a><a href="#l32">32</a><td> * new child Promise.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * If the Thenable is fulfilled, the {@code onFulfilled} callback will be<tr><td><a id="l35"></a><a href="#l35">35</a><td> * invoked with the fulfillment value as argument, and the child Promise will<tr><td><a id="l36"></a><a href="#l36">36</a><td> * be fulfilled with the return value of the callback. If the callback throws<tr><td><a id="l37"></a><a href="#l37">37</a><td> * an exception, the child Promise will be rejected with the thrown value<tr><td><a id="l38"></a><a href="#l38">38</a><td> * instead.<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * If the Thenable is rejected, the {@code onRejected} callback will be invoked<tr><td><a id="l41"></a><a href="#l41">41</a><td> * with the rejection reason as argument, and the child Promise will be rejected<tr><td><a id="l42"></a><a href="#l42">42</a><td> * with the return value of the callback or thrown value.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {?(function(this:THIS, TYPE): VALUE)=} opt_onFulfilled A<tr><td><a id="l45"></a><a href="#l45">45</a><td> *     function that will be invoked with the fulfillment value if the Promise<tr><td><a id="l46"></a><a href="#l46">46</a><td> *     is fullfilled.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @param {?(function(this:THIS, *): *)=} opt_onRejected A function that will<tr><td><a id="l48"></a><a href="#l48">48</a><td> *     be invoked with the rejection reason if the Promise is rejected.<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @param {THIS=} opt_context An optional context object that will be the<tr><td><a id="l50"></a><a href="#l50">50</a><td> *     execution context for the callbacks. By default, functions are executed<tr><td><a id="l51"></a><a href="#l51">51</a><td> *     with the default this.<tr><td><a id="l52"></a><a href="#l52">52</a><td> *<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @return {RESULT} A new Promise that will receive the result<tr><td><a id="l54"></a><a href="#l54">54</a><td> *     of the fulfillment or rejection callback.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @template VALUE<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @template THIS<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * When a Promise (or thenable) is returned from the fulfilled callback,<tr><td><a id="l59"></a><a href="#l59">59</a><td> * the result is the payload of that promise, not the promise itself.<tr><td><a id="l60"></a><a href="#l60">60</a><td> *<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @template RESULT := type(&#39;goog.Promise&#39;,<tr><td><a id="l62"></a><a href="#l62">62</a><td> *     cond(isUnknown(VALUE), unknown(),<tr><td><a id="l63"></a><a href="#l63">63</a><td> *       mapunion(VALUE, (V) =&gt;<tr><td><a id="l64"></a><a href="#l64">64</a><td> *         cond(isTemplatized(V) &amp;&amp; sub(rawTypeOf(V), &#39;IThenable&#39;),<tr><td><a id="l65"></a><a href="#l65">65</a><td> *           templateTypeOf(V, 0),<tr><td><a id="l66"></a><a href="#l66">66</a><td> *           cond(sub(V, &#39;Thenable&#39;),<tr><td><a id="l67"></a><a href="#l67">67</a><td> *              unknown(),<tr><td><a id="l68"></a><a href="#l68">68</a><td> *              V)))))<tr><td><a id="l69"></a><a href="#l69">69</a><td> *  =:<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>goog.Thenable.prototype.then = function(opt_onFulfilled, opt_onRejected,<tr><td><a id="l73"></a><a href="#l73">73</a><td>    opt_context) {};<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * An expando property to indicate that an object implements<tr><td><a id="l78"></a><a href="#l78">78</a><td> * {@code goog.Thenable}.<tr><td><a id="l79"></a><a href="#l79">79</a><td> *<tr><td><a id="l80"></a><a href="#l80">80</a><td> * {@see addImplementation}.<tr><td><a id="l81"></a><a href="#l81">81</a><td> *<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @const<tr><td><a id="l83"></a><a href="#l83">83</a><td> */<tr><td><a id="l84"></a><a href="#l84">84</a><td>goog.Thenable.IMPLEMENTED_BY_PROP = &#39;$goog_Thenable&#39;;<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>/**<tr><td><a id="l88"></a><a href="#l88">88</a><td> * Marks a given class (constructor) as an implementation of Thenable, so<tr><td><a id="l89"></a><a href="#l89">89</a><td> * that we can query that fact at runtime. The class must have already<tr><td><a id="l90"></a><a href="#l90">90</a><td> * implemented the interface.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * Exports a &#39;then&#39; method on the constructor prototype, so that the objects<tr><td><a id="l92"></a><a href="#l92">92</a><td> * also implement the extern {@see goog.Thenable} interface for interop with<tr><td><a id="l93"></a><a href="#l93">93</a><td> * other Promise implementations.<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @param {function(new:goog.Thenable,...?)} ctor The class constructor. The<tr><td><a id="l95"></a><a href="#l95">95</a><td> *     corresponding class must have already implemented the interface.<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.Thenable.addImplementation = function(ctor) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>  goog.exportProperty(ctor.prototype, &#39;then&#39;, ctor.prototype.then);<tr><td><a id="l99"></a><a href="#l99">99</a><td>  if (COMPILED) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>    ctor.prototype[goog.Thenable.IMPLEMENTED_BY_PROP] = true;<tr><td><a id="l101"></a><a href="#l101">101</a><td>  } else {<tr><td><a id="l102"></a><a href="#l102">102</a><td>    // Avoids dictionary access in uncompiled mode.<tr><td><a id="l103"></a><a href="#l103">103</a><td>    ctor.prototype.$goog_Thenable = true;<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><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> * @param {*} object<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @return {boolean} Whether a given instance implements {@code goog.Thenable}.<tr><td><a id="l111"></a><a href="#l111">111</a><td> *     The class/superclass of the instance must call {@code addImplementation}.<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.Thenable.isImplementedBy = function(object) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  if (!object) {<tr><td><a id="l115"></a><a href="#l115">115</a><td>    return false;<tr><td><a id="l116"></a><a href="#l116">116</a><td>  }<tr><td><a id="l117"></a><a href="#l117">117</a><td>  try {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    if (COMPILED) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>      return !!object[goog.Thenable.IMPLEMENTED_BY_PROP];<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 !!object.$goog_Thenable;<tr><td><a id="l122"></a><a href="#l122">122</a><td>  } catch (e) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>    // Property access seems to be forbidden.<tr><td><a id="l124"></a><a href="#l124">124</a><td>    return false;<tr><td><a id="l125"></a><a href="#l125">125</a><td>  }<tr><td><a id="l126"></a><a href="#l126">126</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/reflect/reflect.js.src.html b/docs/source/lib/goog/reflect/reflect.js.src.html
new file mode 100644
index 0000000..d849740
--- /dev/null
+++ b/docs/source/lib/goog/reflect/reflect.js.src.html
@@ -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>reflect.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/reflect/reflect.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Useful compiler idioms.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author johnlenz@google.com (John Lenz)<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.reflect&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>/**<tr><td><a id="l25"></a><a href="#l25">25</a><td> * Syntax for object literal casts.<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @see http://go/jscompiler-renaming<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @see https://github.com/google/closure-compiler/wiki/Type-Based-Property-Renaming<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Use this if you have an object literal whose keys need to have the same names<tr><td><a id="l30"></a><a href="#l30">30</a><td> * as the properties of some class even after they are renamed by the compiler.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {!Function} type Type to cast to.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {Object} object Object literal to cast.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @return {Object} The object literal.<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.reflect.object = function(type, object) {<tr><td><a id="l37"></a><a href="#l37">37</a><td>  return object;<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> * To assert to the compiler that an operation is needed when it would<tr><td><a id="l43"></a><a href="#l43">43</a><td> * otherwise be stripped. For example:<tr><td><a id="l44"></a><a href="#l44">44</a><td> * &lt;code&gt;<tr><td><a id="l45"></a><a href="#l45">45</a><td> *     // Force a layout<tr><td><a id="l46"></a><a href="#l46">46</a><td> *     goog.reflect.sinkValue(dialog.offsetHeight);<tr><td><a id="l47"></a><a href="#l47">47</a><td> * &lt;/code&gt;<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @type {!Function}<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.reflect.sinkValue = function(x) {<tr><td><a id="l51"></a><a href="#l51">51</a><td>  goog.reflect.sinkValue[&#39; &#39;](x);<tr><td><a id="l52"></a><a href="#l52">52</a><td>  return x;<tr><td><a id="l53"></a><a href="#l53">53</a><td>};<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * The compiler should optimize this function away iff no one ever uses<tr><td><a id="l58"></a><a href="#l58">58</a><td> * goog.reflect.sinkValue.<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.reflect.sinkValue[&#39; &#39;] = goog.nullFunction;<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> * Check if a property can be accessed without throwing an exception.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @param {Object} obj The owner of the property.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @param {string} prop The property name.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {boolean} Whether the property is accessible. Will also return true<tr><td><a id="l68"></a><a href="#l68">68</a><td> *     if obj is null.<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>goog.reflect.canAccessProperty = function(obj, prop) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>  /** @preserveTry */<tr><td><a id="l72"></a><a href="#l72">72</a><td>  try {<tr><td><a id="l73"></a><a href="#l73">73</a><td>    goog.reflect.sinkValue(obj[prop]);<tr><td><a id="l74"></a><a href="#l74">74</a><td>    return true;<tr><td><a id="l75"></a><a href="#l75">75</a><td>  } catch (e) {}<tr><td><a id="l76"></a><a href="#l76">76</a><td>  return false;<tr><td><a id="l77"></a><a href="#l77">77</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/string/const.js.src.html b/docs/source/lib/goog/string/const.js.src.html
new file mode 100644
index 0000000..dbe5526
--- /dev/null
+++ b/docs/source/lib/goog/string/const.js.src.html
@@ -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>const.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/string/const.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.string.Const&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.require(&#39;goog.string.TypedString&#39;);<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>/**<tr><td><a id="l23"></a><a href="#l23">23</a><td> * Wrapper for compile-time-constant strings.<tr><td><a id="l24"></a><a href="#l24">24</a><td> *<tr><td><a id="l25"></a><a href="#l25">25</a><td> * Const is a wrapper for strings that can only be created from program<tr><td><a id="l26"></a><a href="#l26">26</a><td> * constants (i.e., string literals).  This property relies on a custom Closure<tr><td><a id="l27"></a><a href="#l27">27</a><td> * compiler check that {@code goog.string.Const.from} is only invoked on<tr><td><a id="l28"></a><a href="#l28">28</a><td> * compile-time-constant expressions.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * Const is useful in APIs whose correct and secure use requires that certain<tr><td><a id="l31"></a><a href="#l31">31</a><td> * arguments are not attacker controlled: Compile-time constants are inherently<tr><td><a id="l32"></a><a href="#l32">32</a><td> * under the control of the application and not under control of external<tr><td><a id="l33"></a><a href="#l33">33</a><td> * attackers, and hence are safe to use in such contexts.<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Instances of this type must be created via its factory method<tr><td><a id="l36"></a><a href="#l36">36</a><td> * {@code goog.string.Const.from} and not by invoking its constructor.  The<tr><td><a id="l37"></a><a href="#l37">37</a><td> * constructor intentionally takes no parameters and the type is immutable;<tr><td><a id="l38"></a><a href="#l38">38</a><td> * hence only a default instance corresponding to the empty string can be<tr><td><a id="l39"></a><a href="#l39">39</a><td> * obtained via constructor invocation.<tr><td><a id="l40"></a><a href="#l40">40</a><td> *<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @see goog.string.Const#from<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @constructor<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @final<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @struct<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @implements {goog.string.TypedString}<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.string.Const = function() {<tr><td><a id="l48"></a><a href="#l48">48</a><td>  /**<tr><td><a id="l49"></a><a href="#l49">49</a><td>   * The wrapped value of this Const object.  The field has a purposely ugly<tr><td><a id="l50"></a><a href="#l50">50</a><td>   * name to make (non-compiled) code that attempts to directly access this<tr><td><a id="l51"></a><a href="#l51">51</a><td>   * field stand out.<tr><td><a id="l52"></a><a href="#l52">52</a><td>   * @private {string}<tr><td><a id="l53"></a><a href="#l53">53</a><td>   */<tr><td><a id="l54"></a><a href="#l54">54</a><td>  this.stringConstValueWithSecurityContract__googStringSecurityPrivate_ = &#39;&#39;;<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>   * A type marker used to implement additional run-time type checking.<tr><td><a id="l58"></a><a href="#l58">58</a><td>   * @see goog.string.Const#unwrap<tr><td><a id="l59"></a><a href="#l59">59</a><td>   * @const<tr><td><a id="l60"></a><a href="#l60">60</a><td>   * @private<tr><td><a id="l61"></a><a href="#l61">61</a><td>   */<tr><td><a id="l62"></a><a href="#l62">62</a><td>  this.STRING_CONST_TYPE_MARKER__GOOG_STRING_SECURITY_PRIVATE_ =<tr><td><a id="l63"></a><a href="#l63">63</a><td>      goog.string.Const.TYPE_MARKER_;<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> * @override<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @const<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>goog.string.Const.prototype.implementsGoogStringTypedString = true;<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>/**<tr><td><a id="l75"></a><a href="#l75">75</a><td> * Returns this Const&#39;s value a string.<tr><td><a id="l76"></a><a href="#l76">76</a><td> *<tr><td><a id="l77"></a><a href="#l77">77</a><td> * IMPORTANT: In code where it is security-relevant that an object&#39;s type is<tr><td><a id="l78"></a><a href="#l78">78</a><td> * indeed {@code goog.string.Const}, use {@code goog.string.Const.unwrap}<tr><td><a id="l79"></a><a href="#l79">79</a><td> * instead of this method.<tr><td><a id="l80"></a><a href="#l80">80</a><td> *<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @see goog.string.Const#unwrap<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @override<tr><td><a id="l83"></a><a href="#l83">83</a><td> */<tr><td><a id="l84"></a><a href="#l84">84</a><td>goog.string.Const.prototype.getTypedStringValue = function() {<tr><td><a id="l85"></a><a href="#l85">85</a><td>  return this.stringConstValueWithSecurityContract__googStringSecurityPrivate_;<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<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> * Returns a debug-string representation of this value.<tr><td><a id="l91"></a><a href="#l91">91</a><td> *<tr><td><a id="l92"></a><a href="#l92">92</a><td> * To obtain the actual string value wrapped inside an object of this type,<tr><td><a id="l93"></a><a href="#l93">93</a><td> * use {@code goog.string.Const.unwrap}.<tr><td><a id="l94"></a><a href="#l94">94</a><td> *<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @see goog.string.Const#unwrap<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @override<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.string.Const.prototype.toString = function() {<tr><td><a id="l99"></a><a href="#l99">99</a><td>  return &#39;Const{&#39; +<tr><td><a id="l100"></a><a href="#l100">100</a><td>         this.stringConstValueWithSecurityContract__googStringSecurityPrivate_ +<tr><td><a id="l101"></a><a href="#l101">101</a><td>         &#39;}&#39;;<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * Performs a runtime check that the provided object is indeed an instance<tr><td><a id="l107"></a><a href="#l107">107</a><td> * of {@code goog.string.Const}, and returns its value.<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @param {!goog.string.Const} stringConst The object to extract from.<tr><td><a id="l109"></a><a href="#l109">109</a><td> * @return {string} The Const object&#39;s contained string, unless the run-time<tr><td><a id="l110"></a><a href="#l110">110</a><td> *     type check fails. In that case, {@code unwrap} returns an innocuous<tr><td><a id="l111"></a><a href="#l111">111</a><td> *     string, or, if assertions are enabled, throws<tr><td><a id="l112"></a><a href="#l112">112</a><td> *     {@code goog.asserts.AssertionError}.<tr><td><a id="l113"></a><a href="#l113">113</a><td> */<tr><td><a id="l114"></a><a href="#l114">114</a><td>goog.string.Const.unwrap = function(stringConst) {<tr><td><a id="l115"></a><a href="#l115">115</a><td>  // Perform additional run-time type-checking to ensure that stringConst is<tr><td><a id="l116"></a><a href="#l116">116</a><td>  // indeed an instance of the expected type.  This provides some additional<tr><td><a id="l117"></a><a href="#l117">117</a><td>  // protection against security bugs due to application code that disables type<tr><td><a id="l118"></a><a href="#l118">118</a><td>  // checks.<tr><td><a id="l119"></a><a href="#l119">119</a><td>  if (stringConst instanceof goog.string.Const &amp;&amp;<tr><td><a id="l120"></a><a href="#l120">120</a><td>      stringConst.constructor === goog.string.Const &amp;&amp;<tr><td><a id="l121"></a><a href="#l121">121</a><td>      stringConst.STRING_CONST_TYPE_MARKER__GOOG_STRING_SECURITY_PRIVATE_ ===<tr><td><a id="l122"></a><a href="#l122">122</a><td>          goog.string.Const.TYPE_MARKER_) {<tr><td><a id="l123"></a><a href="#l123">123</a><td>    return stringConst.<tr><td><a id="l124"></a><a href="#l124">124</a><td>        stringConstValueWithSecurityContract__googStringSecurityPrivate_;<tr><td><a id="l125"></a><a href="#l125">125</a><td>  } else {<tr><td><a id="l126"></a><a href="#l126">126</a><td>    goog.asserts.fail(&#39;expected object of type Const, got \&#39;&#39; +<tr><td><a id="l127"></a><a href="#l127">127</a><td>                      stringConst + &#39;\&#39;&#39;);<tr><td><a id="l128"></a><a href="#l128">128</a><td>    return &#39;type_error:Const&#39;;<tr><td><a id="l129"></a><a href="#l129">129</a><td>  }<tr><td><a id="l130"></a><a href="#l130">130</a><td>};<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/**<tr><td><a id="l134"></a><a href="#l134">134</a><td> * Creates a Const object from a compile-time constant string.<tr><td><a id="l135"></a><a href="#l135">135</a><td> *<tr><td><a id="l136"></a><a href="#l136">136</a><td> * It is illegal to invoke this function on an expression whose<tr><td><a id="l137"></a><a href="#l137">137</a><td> * compile-time-contant value cannot be determined by the Closure compiler.<tr><td><a id="l138"></a><a href="#l138">138</a><td> *<tr><td><a id="l139"></a><a href="#l139">139</a><td> * Correct invocations include,<tr><td><a id="l140"></a><a href="#l140">140</a><td> * &lt;pre&gt;<tr><td><a id="l141"></a><a href="#l141">141</a><td> *   var s = goog.string.Const.from(&#39;hello&#39;);<tr><td><a id="l142"></a><a href="#l142">142</a><td> *   var t = goog.string.Const.from(&#39;hello&#39; + &#39;world&#39;);<tr><td><a id="l143"></a><a href="#l143">143</a><td> * &lt;/pre&gt;<tr><td><a id="l144"></a><a href="#l144">144</a><td> *<tr><td><a id="l145"></a><a href="#l145">145</a><td> * In contrast, the following are illegal:<tr><td><a id="l146"></a><a href="#l146">146</a><td> * &lt;pre&gt;<tr><td><a id="l147"></a><a href="#l147">147</a><td> *   var s = goog.string.Const.from(getHello());<tr><td><a id="l148"></a><a href="#l148">148</a><td> *   var t = goog.string.Const.from(&#39;hello&#39; + world);<tr><td><a id="l149"></a><a href="#l149">149</a><td> * &lt;/pre&gt;<tr><td><a id="l150"></a><a href="#l150">150</a><td> *<tr><td><a id="l151"></a><a href="#l151">151</a><td> * TODO(xtof): Compile-time checks that this function is only called<tr><td><a id="l152"></a><a href="#l152">152</a><td> * with compile-time constant expressions.<tr><td><a id="l153"></a><a href="#l153">153</a><td> *<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {string} s A constant string from which to create a Const.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @return {!goog.string.Const} A Const object initialized to stringConst.<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>goog.string.Const.from = function(s) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  return goog.string.Const.create__googStringSecurityPrivate_(s);<tr><td><a id="l159"></a><a href="#l159">159</a><td>};<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * Type marker for the Const type, used to implement additional run-time<tr><td><a id="l164"></a><a href="#l164">164</a><td> * type checking.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @const {!Object}<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @private<tr><td><a id="l167"></a><a href="#l167">167</a><td> */<tr><td><a id="l168"></a><a href="#l168">168</a><td>goog.string.Const.TYPE_MARKER_ = {};<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> * Utility method to create Const instances.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @param {string} s The string to initialize the Const object with.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {!goog.string.Const} The initialized Const object.<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @private<tr><td><a id="l176"></a><a href="#l176">176</a><td> */<tr><td><a id="l177"></a><a href="#l177">177</a><td>goog.string.Const.create__googStringSecurityPrivate_ = function(s) {<tr><td><a id="l178"></a><a href="#l178">178</a><td>  var stringConst = new goog.string.Const();<tr><td><a id="l179"></a><a href="#l179">179</a><td>  stringConst.stringConstValueWithSecurityContract__googStringSecurityPrivate_ =<tr><td><a id="l180"></a><a href="#l180">180</a><td>      s;<tr><td><a id="l181"></a><a href="#l181">181</a><td>  return stringConst;<tr><td><a id="l182"></a><a href="#l182">182</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/string/string.js.src.html b/docs/source/lib/goog/string/string.js.src.html
index 76c8210..a7cdf8f 100644
--- a/docs/source/lib/goog/string/string.js.src.html
+++ b/docs/source/lib/goog/string/string.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>string.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/string/string.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Utilities for string manipulation.<tr><td><a name="l17" href="#l17">17</a><td> */<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>/**<tr><td><a name="l21" href="#l21">21</a><td> * Namespace for string utilities<tr><td><a name="l22" href="#l22">22</a><td> */<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.string&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.provide(&#39;goog.string.Unicode&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td>/**<tr><td><a name="l28" href="#l28">28</a><td> * Common Unicode string characters.<tr><td><a name="l29" href="#l29">29</a><td> * @enum {string}<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>goog.string.Unicode = {<tr><td><a name="l32" href="#l32">32</a><td>  NBSP: &#39;\xa0&#39;<tr><td><a name="l33" href="#l33">33</a><td>};<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td>/**<tr><td><a name="l37" href="#l37">37</a><td> * Fast prefix-checker.<tr><td><a name="l38" href="#l38">38</a><td> * @param {string} str The string to check.<tr><td><a name="l39" href="#l39">39</a><td> * @param {string} prefix A string to look for at the start of {@code str}.<tr><td><a name="l40" href="#l40">40</a><td> * @return {boolean} True if {@code str} begins with {@code prefix}.<tr><td><a name="l41" href="#l41">41</a><td> */<tr><td><a name="l42" href="#l42">42</a><td>goog.string.startsWith = function(str, prefix) {<tr><td><a name="l43" href="#l43">43</a><td>  return str.lastIndexOf(prefix, 0) == 0;<tr><td><a name="l44" href="#l44">44</a><td>};<tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>/**<tr><td><a name="l48" href="#l48">48</a><td> * Fast suffix-checker.<tr><td><a name="l49" href="#l49">49</a><td> * @param {string} str The string to check.<tr><td><a name="l50" href="#l50">50</a><td> * @param {string} suffix A string to look for at the end of {@code str}.<tr><td><a name="l51" href="#l51">51</a><td> * @return {boolean} True if {@code str} ends with {@code suffix}.<tr><td><a name="l52" href="#l52">52</a><td> */<tr><td><a name="l53" href="#l53">53</a><td>goog.string.endsWith = function(str, suffix) {<tr><td><a name="l54" href="#l54">54</a><td>  var l = str.length - suffix.length;<tr><td><a name="l55" href="#l55">55</a><td>  return l &gt;= 0 &amp;&amp; str.indexOf(suffix, l) == l;<tr><td><a name="l56" href="#l56">56</a><td>};<tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td>/**<tr><td><a name="l60" href="#l60">60</a><td> * Case-insensitive prefix-checker.<tr><td><a name="l61" href="#l61">61</a><td> * @param {string} str The string to check.<tr><td><a name="l62" href="#l62">62</a><td> * @param {string} prefix  A string to look for at the end of {@code str}.<tr><td><a name="l63" href="#l63">63</a><td> * @return {boolean} True if {@code str} begins with {@code prefix} (ignoring<tr><td><a name="l64" href="#l64">64</a><td> *     case).<tr><td><a name="l65" href="#l65">65</a><td> */<tr><td><a name="l66" href="#l66">66</a><td>goog.string.caseInsensitiveStartsWith = function(str, prefix) {<tr><td><a name="l67" href="#l67">67</a><td>  return goog.string.caseInsensitiveCompare(<tr><td><a name="l68" href="#l68">68</a><td>      prefix, str.substr(0, prefix.length)) == 0;<tr><td><a name="l69" href="#l69">69</a><td>};<tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td>/**<tr><td><a name="l73" href="#l73">73</a><td> * Case-insensitive suffix-checker.<tr><td><a name="l74" href="#l74">74</a><td> * @param {string} str The string to check.<tr><td><a name="l75" href="#l75">75</a><td> * @param {string} suffix A string to look for at the end of {@code str}.<tr><td><a name="l76" href="#l76">76</a><td> * @return {boolean} True if {@code str} ends with {@code suffix} (ignoring<tr><td><a name="l77" href="#l77">77</a><td> *     case).<tr><td><a name="l78" href="#l78">78</a><td> */<tr><td><a name="l79" href="#l79">79</a><td>goog.string.caseInsensitiveEndsWith = function(str, suffix) {<tr><td><a name="l80" href="#l80">80</a><td>  return goog.string.caseInsensitiveCompare(<tr><td><a name="l81" href="#l81">81</a><td>      suffix, str.substr(str.length - suffix.length, suffix.length)) == 0;<tr><td><a name="l82" href="#l82">82</a><td>};<tr><td><a name="l83" href="#l83">83</a><td><tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td>/**<tr><td><a name="l86" href="#l86">86</a><td> * Case-insensitive equality checker.<tr><td><a name="l87" href="#l87">87</a><td> * @param {string} str1 First string to check.<tr><td><a name="l88" href="#l88">88</a><td> * @param {string} str2 Second string to check.<tr><td><a name="l89" href="#l89">89</a><td> * @return {boolean} True if {@code str1} and {@code str2} are the same string,<tr><td><a name="l90" href="#l90">90</a><td> *     ignoring case.<tr><td><a name="l91" href="#l91">91</a><td> */<tr><td><a name="l92" href="#l92">92</a><td>goog.string.caseInsensitiveEquals = function(str1, str2) {<tr><td><a name="l93" href="#l93">93</a><td>  return str1.toLowerCase() == str2.toLowerCase();<tr><td><a name="l94" href="#l94">94</a><td>};<tr><td><a name="l95" href="#l95">95</a><td><tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>/**<tr><td><a name="l98" href="#l98">98</a><td> * Does simple python-style string substitution.<tr><td><a name="l99" href="#l99">99</a><td> * subs(&quot;foo%s hot%s&quot;, &quot;bar&quot;, &quot;dog&quot;) becomes &quot;foobar hotdog&quot;.<tr><td><a name="l100" href="#l100">100</a><td> * @param {string} str The string containing the pattern.<tr><td><a name="l101" href="#l101">101</a><td> * @param {...*} var_args The items to substitute into the pattern.<tr><td><a name="l102" href="#l102">102</a><td> * @return {string} A copy of {@code str} in which each occurrence of<tr><td><a name="l103" href="#l103">103</a><td> *     {@code %s} has been replaced an argument from {@code var_args}.<tr><td><a name="l104" href="#l104">104</a><td> */<tr><td><a name="l105" href="#l105">105</a><td>goog.string.subs = function(str, var_args) {<tr><td><a name="l106" href="#l106">106</a><td>  var splitParts = str.split(&#39;%s&#39;);<tr><td><a name="l107" href="#l107">107</a><td>  var returnString = &#39;&#39;;<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td>  var subsArguments = Array.prototype.slice.call(arguments, 1);<tr><td><a name="l110" href="#l110">110</a><td>  while (subsArguments.length &amp;&amp;<tr><td><a name="l111" href="#l111">111</a><td>         // Replace up to the last split part. We are inserting in the<tr><td><a name="l112" href="#l112">112</a><td>         // positions between split parts.<tr><td><a name="l113" href="#l113">113</a><td>         splitParts.length &gt; 1) {<tr><td><a name="l114" href="#l114">114</a><td>    returnString += splitParts.shift() + subsArguments.shift();<tr><td><a name="l115" href="#l115">115</a><td>  }<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td>  return returnString + splitParts.join(&#39;%s&#39;); // Join unused &#39;%s&#39;<tr><td><a name="l118" href="#l118">118</a><td>};<tr><td><a name="l119" href="#l119">119</a><td><tr><td><a name="l120" href="#l120">120</a><td><tr><td><a name="l121" href="#l121">121</a><td>/**<tr><td><a name="l122" href="#l122">122</a><td> * Converts multiple whitespace chars (spaces, non-breaking-spaces, new lines<tr><td><a name="l123" href="#l123">123</a><td> * and tabs) to a single space, and strips leading and trailing whitespace.<tr><td><a name="l124" href="#l124">124</a><td> * @param {string} str Input string.<tr><td><a name="l125" href="#l125">125</a><td> * @return {string} A copy of {@code str} with collapsed whitespace.<tr><td><a name="l126" href="#l126">126</a><td> */<tr><td><a name="l127" href="#l127">127</a><td>goog.string.collapseWhitespace = function(str) {<tr><td><a name="l128" href="#l128">128</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a name="l129" href="#l129">129</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a name="l130" href="#l130">130</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a name="l131" href="#l131">131</a><td>  return str.replace(/[\s\xa0]+/g, &#39; &#39;).replace(/^\s+|\s+$/g, &#39;&#39;);<tr><td><a name="l132" href="#l132">132</a><td>};<tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td><tr><td><a name="l135" href="#l135">135</a><td>/**<tr><td><a name="l136" href="#l136">136</a><td> * Checks if a string is empty or contains only whitespaces.<tr><td><a name="l137" href="#l137">137</a><td> * @param {string} str The string to check.<tr><td><a name="l138" href="#l138">138</a><td> * @return {boolean} True if {@code str} is empty or whitespace only.<tr><td><a name="l139" href="#l139">139</a><td> */<tr><td><a name="l140" href="#l140">140</a><td>goog.string.isEmpty = function(str) {<tr><td><a name="l141" href="#l141">141</a><td>  // testing length == 0 first is actually slower in all browsers (about the<tr><td><a name="l142" href="#l142">142</a><td>  // same in Opera).<tr><td><a name="l143" href="#l143">143</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a name="l144" href="#l144">144</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a name="l145" href="#l145">145</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a name="l146" href="#l146">146</a><td>  return /^[\s\xa0]*$/.test(str);<tr><td><a name="l147" href="#l147">147</a><td>};<tr><td><a name="l148" href="#l148">148</a><td><tr><td><a name="l149" href="#l149">149</a><td><tr><td><a name="l150" href="#l150">150</a><td>/**<tr><td><a name="l151" href="#l151">151</a><td> * Checks if a string is null, undefined, empty or contains only whitespaces.<tr><td><a name="l152" href="#l152">152</a><td> * @param {*} str The string to check.<tr><td><a name="l153" href="#l153">153</a><td> * @return {boolean} True if{@code str} is null, undefined, empty, or<tr><td><a name="l154" href="#l154">154</a><td> *     whitespace only.<tr><td><a name="l155" href="#l155">155</a><td> */<tr><td><a name="l156" href="#l156">156</a><td>goog.string.isEmptySafe = function(str) {<tr><td><a name="l157" href="#l157">157</a><td>  return goog.string.isEmpty(goog.string.makeSafe(str));<tr><td><a name="l158" href="#l158">158</a><td>};<tr><td><a name="l159" href="#l159">159</a><td><tr><td><a name="l160" href="#l160">160</a><td><tr><td><a name="l161" href="#l161">161</a><td>/**<tr><td><a name="l162" href="#l162">162</a><td> * Checks if a string is all breaking whitespace.<tr><td><a name="l163" href="#l163">163</a><td> * @param {string} str The string to check.<tr><td><a name="l164" href="#l164">164</a><td> * @return {boolean} Whether the string is all breaking whitespace.<tr><td><a name="l165" href="#l165">165</a><td> */<tr><td><a name="l166" href="#l166">166</a><td>goog.string.isBreakingWhitespace = function(str) {<tr><td><a name="l167" href="#l167">167</a><td>  return !/[^\t\n\r ]/.test(str);<tr><td><a name="l168" href="#l168">168</a><td>};<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/**<tr><td><a name="l172" href="#l172">172</a><td> * Checks if a string contains all letters.<tr><td><a name="l173" href="#l173">173</a><td> * @param {string} str string to check.<tr><td><a name="l174" href="#l174">174</a><td> * @return {boolean} True if {@code str} consists entirely of letters.<tr><td><a name="l175" href="#l175">175</a><td> */<tr><td><a name="l176" href="#l176">176</a><td>goog.string.isAlpha = function(str) {<tr><td><a name="l177" href="#l177">177</a><td>  return !/[^a-zA-Z]/.test(str);<tr><td><a name="l178" href="#l178">178</a><td>};<tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td><tr><td><a name="l181" href="#l181">181</a><td>/**<tr><td><a name="l182" href="#l182">182</a><td> * Checks if a string contains only numbers.<tr><td><a name="l183" href="#l183">183</a><td> * @param {*} str string to check. If not a string, it will be<tr><td><a name="l184" href="#l184">184</a><td> *     casted to one.<tr><td><a name="l185" href="#l185">185</a><td> * @return {boolean} True if {@code str} is numeric.<tr><td><a name="l186" href="#l186">186</a><td> */<tr><td><a name="l187" href="#l187">187</a><td>goog.string.isNumeric = function(str) {<tr><td><a name="l188" href="#l188">188</a><td>  return !/[^0-9]/.test(str);<tr><td><a name="l189" href="#l189">189</a><td>};<tr><td><a name="l190" href="#l190">190</a><td><tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td>/**<tr><td><a name="l193" href="#l193">193</a><td> * Checks if a string contains only numbers or letters.<tr><td><a name="l194" href="#l194">194</a><td> * @param {string} str string to check.<tr><td><a name="l195" href="#l195">195</a><td> * @return {boolean} True if {@code str} is alphanumeric.<tr><td><a name="l196" href="#l196">196</a><td> */<tr><td><a name="l197" href="#l197">197</a><td>goog.string.isAlphaNumeric = function(str) {<tr><td><a name="l198" href="#l198">198</a><td>  return !/[^a-zA-Z0-9]/.test(str);<tr><td><a name="l199" href="#l199">199</a><td>};<tr><td><a name="l200" href="#l200">200</a><td><tr><td><a name="l201" href="#l201">201</a><td><tr><td><a name="l202" href="#l202">202</a><td>/**<tr><td><a name="l203" href="#l203">203</a><td> * Checks if a character is a space character.<tr><td><a name="l204" href="#l204">204</a><td> * @param {string} ch Character to check.<tr><td><a name="l205" href="#l205">205</a><td> * @return {boolean} True if {code ch} is a space.<tr><td><a name="l206" href="#l206">206</a><td> */<tr><td><a name="l207" href="#l207">207</a><td>goog.string.isSpace = function(ch) {<tr><td><a name="l208" href="#l208">208</a><td>  return ch == &#39; &#39;;<tr><td><a name="l209" href="#l209">209</a><td>};<tr><td><a name="l210" href="#l210">210</a><td><tr><td><a name="l211" href="#l211">211</a><td><tr><td><a name="l212" href="#l212">212</a><td>/**<tr><td><a name="l213" href="#l213">213</a><td> * Checks if a character is a valid unicode character.<tr><td><a name="l214" href="#l214">214</a><td> * @param {string} ch Character to check.<tr><td><a name="l215" href="#l215">215</a><td> * @return {boolean} True if {code ch} is a valid unicode character.<tr><td><a name="l216" href="#l216">216</a><td> */<tr><td><a name="l217" href="#l217">217</a><td>goog.string.isUnicodeChar = function(ch) {<tr><td><a name="l218" href="#l218">218</a><td>  return ch.length == 1 &amp;&amp; ch &gt;= &#39; &#39; &amp;&amp; ch &lt;= &#39;~&#39; ||<tr><td><a name="l219" href="#l219">219</a><td>         ch &gt;= &#39;\u0080&#39; &amp;&amp; ch &lt;= &#39;\uFFFD&#39;;<tr><td><a name="l220" href="#l220">220</a><td>};<tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td><tr><td><a name="l223" href="#l223">223</a><td>/**<tr><td><a name="l224" href="#l224">224</a><td> * Takes a string and replaces newlines with a space. Multiple lines are<tr><td><a name="l225" href="#l225">225</a><td> * replaced with a single space.<tr><td><a name="l226" href="#l226">226</a><td> * @param {string} str The string from which to strip newlines.<tr><td><a name="l227" href="#l227">227</a><td> * @return {string} A copy of {@code str} stripped of newlines.<tr><td><a name="l228" href="#l228">228</a><td> */<tr><td><a name="l229" href="#l229">229</a><td>goog.string.stripNewlines = function(str) {<tr><td><a name="l230" href="#l230">230</a><td>  return str.replace(/(\r\n|\r|\n)+/g, &#39; &#39;);<tr><td><a name="l231" href="#l231">231</a><td>};<tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td>/**<tr><td><a name="l235" href="#l235">235</a><td> * Replaces Windows and Mac new lines with unix style: \r or \r\n with \n.<tr><td><a name="l236" href="#l236">236</a><td> * @param {string} str The string to in which to canonicalize newlines.<tr><td><a name="l237" href="#l237">237</a><td> * @return {string} {@code str} A copy of {@code} with canonicalized newlines.<tr><td><a name="l238" href="#l238">238</a><td> */<tr><td><a name="l239" href="#l239">239</a><td>goog.string.canonicalizeNewlines = function(str) {<tr><td><a name="l240" href="#l240">240</a><td>  return str.replace(/(\r\n|\r|\n)/g, &#39;\n&#39;);<tr><td><a name="l241" href="#l241">241</a><td>};<tr><td><a name="l242" href="#l242">242</a><td><tr><td><a name="l243" href="#l243">243</a><td><tr><td><a name="l244" href="#l244">244</a><td>/**<tr><td><a name="l245" href="#l245">245</a><td> * Normalizes whitespace in a string, replacing all whitespace chars with<tr><td><a name="l246" href="#l246">246</a><td> * a space.<tr><td><a name="l247" href="#l247">247</a><td> * @param {string} str The string in which to normalize whitespace.<tr><td><a name="l248" href="#l248">248</a><td> * @return {string} A copy of {@code str} with all whitespace normalized.<tr><td><a name="l249" href="#l249">249</a><td> */<tr><td><a name="l250" href="#l250">250</a><td>goog.string.normalizeWhitespace = function(str) {<tr><td><a name="l251" href="#l251">251</a><td>  return str.replace(/\xa0|\s/g, &#39; &#39;);<tr><td><a name="l252" href="#l252">252</a><td>};<tr><td><a name="l253" href="#l253">253</a><td><tr><td><a name="l254" href="#l254">254</a><td><tr><td><a name="l255" href="#l255">255</a><td>/**<tr><td><a name="l256" href="#l256">256</a><td> * Normalizes spaces in a string, replacing all consecutive spaces and tabs<tr><td><a name="l257" href="#l257">257</a><td> * with a single space. Replaces non-breaking space with a space.<tr><td><a name="l258" href="#l258">258</a><td> * @param {string} str The string in which to normalize spaces.<tr><td><a name="l259" href="#l259">259</a><td> * @return {string} A copy of {@code str} with all consecutive spaces and tabs<tr><td><a name="l260" href="#l260">260</a><td> *    replaced with a single space.<tr><td><a name="l261" href="#l261">261</a><td> */<tr><td><a name="l262" href="#l262">262</a><td>goog.string.normalizeSpaces = function(str) {<tr><td><a name="l263" href="#l263">263</a><td>  return str.replace(/\xa0|[ \t]+/g, &#39; &#39;);<tr><td><a name="l264" href="#l264">264</a><td>};<tr><td><a name="l265" href="#l265">265</a><td><tr><td><a name="l266" href="#l266">266</a><td><tr><td><a name="l267" href="#l267">267</a><td>/**<tr><td><a name="l268" href="#l268">268</a><td> * Removes the breaking spaces from the left and right of the string and<tr><td><a name="l269" href="#l269">269</a><td> * collapses the sequences of breaking spaces in the middle into single spaces.<tr><td><a name="l270" href="#l270">270</a><td> * The original and the result strings render the same way in HTML.<tr><td><a name="l271" href="#l271">271</a><td> * @param {string} str A string in which to collapse spaces.<tr><td><a name="l272" href="#l272">272</a><td> * @return {string} Copy of the string with normalized breaking spaces.<tr><td><a name="l273" href="#l273">273</a><td> */<tr><td><a name="l274" href="#l274">274</a><td>goog.string.collapseBreakingSpaces = function(str) {<tr><td><a name="l275" href="#l275">275</a><td>  return str.replace(/[\t\r\n ]+/g, &#39; &#39;).replace(<tr><td><a name="l276" href="#l276">276</a><td>      /^[\t\r\n ]+|[\t\r\n ]+$/g, &#39;&#39;);<tr><td><a name="l277" href="#l277">277</a><td>};<tr><td><a name="l278" href="#l278">278</a><td><tr><td><a name="l279" href="#l279">279</a><td><tr><td><a name="l280" href="#l280">280</a><td>/**<tr><td><a name="l281" href="#l281">281</a><td> * Trims white spaces to the left and right of a string.<tr><td><a name="l282" href="#l282">282</a><td> * @param {string} str The string to trim.<tr><td><a name="l283" href="#l283">283</a><td> * @return {string} A trimmed copy of {@code str}.<tr><td><a name="l284" href="#l284">284</a><td> */<tr><td><a name="l285" href="#l285">285</a><td>goog.string.trim = function(str) {<tr><td><a name="l286" href="#l286">286</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a name="l287" href="#l287">287</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a name="l288" href="#l288">288</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a name="l289" href="#l289">289</a><td>  return str.replace(/^[\s\xa0]+|[\s\xa0]+$/g, &#39;&#39;);<tr><td><a name="l290" href="#l290">290</a><td>};<tr><td><a name="l291" href="#l291">291</a><td><tr><td><a name="l292" href="#l292">292</a><td><tr><td><a name="l293" href="#l293">293</a><td>/**<tr><td><a name="l294" href="#l294">294</a><td> * Trims whitespaces at the left end of a string.<tr><td><a name="l295" href="#l295">295</a><td> * @param {string} str The string to left trim.<tr><td><a name="l296" href="#l296">296</a><td> * @return {string} A trimmed copy of {@code str}.<tr><td><a name="l297" href="#l297">297</a><td> */<tr><td><a name="l298" href="#l298">298</a><td>goog.string.trimLeft = function(str) {<tr><td><a name="l299" href="#l299">299</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a name="l300" href="#l300">300</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a name="l301" href="#l301">301</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a name="l302" href="#l302">302</a><td>  return str.replace(/^[\s\xa0]+/, &#39;&#39;);<tr><td><a name="l303" href="#l303">303</a><td>};<tr><td><a name="l304" href="#l304">304</a><td><tr><td><a name="l305" href="#l305">305</a><td><tr><td><a name="l306" href="#l306">306</a><td>/**<tr><td><a name="l307" href="#l307">307</a><td> * Trims whitespaces at the right end of a string.<tr><td><a name="l308" href="#l308">308</a><td> * @param {string} str The string to right trim.<tr><td><a name="l309" href="#l309">309</a><td> * @return {string} A trimmed copy of {@code str}.<tr><td><a name="l310" href="#l310">310</a><td> */<tr><td><a name="l311" href="#l311">311</a><td>goog.string.trimRight = function(str) {<tr><td><a name="l312" href="#l312">312</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a name="l313" href="#l313">313</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a name="l314" href="#l314">314</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a name="l315" href="#l315">315</a><td>  return str.replace(/[\s\xa0]+$/, &#39;&#39;);<tr><td><a name="l316" href="#l316">316</a><td>};<tr><td><a name="l317" href="#l317">317</a><td><tr><td><a name="l318" href="#l318">318</a><td><tr><td><a name="l319" href="#l319">319</a><td>/**<tr><td><a name="l320" href="#l320">320</a><td> * A string comparator that ignores case.<tr><td><a name="l321" href="#l321">321</a><td> * -1 = str1 less than str2<tr><td><a name="l322" href="#l322">322</a><td> *  0 = str1 equals str2<tr><td><a name="l323" href="#l323">323</a><td> *  1 = str1 greater than str2<tr><td><a name="l324" href="#l324">324</a><td> *<tr><td><a name="l325" href="#l325">325</a><td> * @param {string} str1 The string to compare.<tr><td><a name="l326" href="#l326">326</a><td> * @param {string} str2 The string to compare {@code str1} to.<tr><td><a name="l327" href="#l327">327</a><td> * @return {number} The comparator result, as described above.<tr><td><a name="l328" href="#l328">328</a><td> */<tr><td><a name="l329" href="#l329">329</a><td>goog.string.caseInsensitiveCompare = function(str1, str2) {<tr><td><a name="l330" href="#l330">330</a><td>  var test1 = String(str1).toLowerCase();<tr><td><a name="l331" href="#l331">331</a><td>  var test2 = String(str2).toLowerCase();<tr><td><a name="l332" href="#l332">332</a><td><tr><td><a name="l333" href="#l333">333</a><td>  if (test1 &lt; test2) {<tr><td><a name="l334" href="#l334">334</a><td>    return -1;<tr><td><a name="l335" href="#l335">335</a><td>  } else if (test1 == test2) {<tr><td><a name="l336" href="#l336">336</a><td>    return 0;<tr><td><a name="l337" href="#l337">337</a><td>  } else {<tr><td><a name="l338" href="#l338">338</a><td>    return 1;<tr><td><a name="l339" href="#l339">339</a><td>  }<tr><td><a name="l340" href="#l340">340</a><td>};<tr><td><a name="l341" href="#l341">341</a><td><tr><td><a name="l342" href="#l342">342</a><td><tr><td><a name="l343" href="#l343">343</a><td>/**<tr><td><a name="l344" href="#l344">344</a><td> * Regular expression used for splitting a string into substrings of fractional<tr><td><a name="l345" href="#l345">345</a><td> * numbers, integers, and non-numeric characters.<tr><td><a name="l346" href="#l346">346</a><td> * @type {RegExp}<tr><td><a name="l347" href="#l347">347</a><td> * @private<tr><td><a name="l348" href="#l348">348</a><td> */<tr><td><a name="l349" href="#l349">349</a><td>goog.string.numerateCompareRegExp_ = /(\.\d+)|(\d+)|(\D+)/g;<tr><td><a name="l350" href="#l350">350</a><td><tr><td><a name="l351" href="#l351">351</a><td><tr><td><a name="l352" href="#l352">352</a><td>/**<tr><td><a name="l353" href="#l353">353</a><td> * String comparison function that handles numbers in a way humans might expect.<tr><td><a name="l354" href="#l354">354</a><td> * Using this function, the string &quot;File 2.jpg&quot; sorts before &quot;File 10.jpg&quot;. The<tr><td><a name="l355" href="#l355">355</a><td> * comparison is mostly case-insensitive, though strings that are identical<tr><td><a name="l356" href="#l356">356</a><td> * except for case are sorted with the upper-case strings before lower-case.<tr><td><a name="l357" href="#l357">357</a><td> *<tr><td><a name="l358" href="#l358">358</a><td> * This comparison function is significantly slower (about 500x) than either<tr><td><a name="l359" href="#l359">359</a><td> * the default or the case-insensitive compare. It should not be used in<tr><td><a name="l360" href="#l360">360</a><td> * time-critical code, but should be fast enough to sort several hundred short<tr><td><a name="l361" href="#l361">361</a><td> * strings (like filenames) with a reasonable delay.<tr><td><a name="l362" href="#l362">362</a><td> *<tr><td><a name="l363" href="#l363">363</a><td> * @param {string} str1 The string to compare in a numerically sensitive way.<tr><td><a name="l364" href="#l364">364</a><td> * @param {string} str2 The string to compare {@code str1} to.<tr><td><a name="l365" href="#l365">365</a><td> * @return {number} less than 0 if str1 &lt; str2, 0 if str1 == str2, greater than<tr><td><a name="l366" href="#l366">366</a><td> *     0 if str1 &gt; str2.<tr><td><a name="l367" href="#l367">367</a><td> */<tr><td><a name="l368" href="#l368">368</a><td>goog.string.numerateCompare = function(str1, str2) {<tr><td><a name="l369" href="#l369">369</a><td>  if (str1 == str2) {<tr><td><a name="l370" href="#l370">370</a><td>    return 0;<tr><td><a name="l371" href="#l371">371</a><td>  }<tr><td><a name="l372" href="#l372">372</a><td>  if (!str1) {<tr><td><a name="l373" href="#l373">373</a><td>    return -1;<tr><td><a name="l374" href="#l374">374</a><td>  }<tr><td><a name="l375" href="#l375">375</a><td>  if (!str2) {<tr><td><a name="l376" href="#l376">376</a><td>    return 1;<tr><td><a name="l377" href="#l377">377</a><td>  }<tr><td><a name="l378" href="#l378">378</a><td><tr><td><a name="l379" href="#l379">379</a><td>  // Using match to split the entire string ahead of time turns out to be faster<tr><td><a name="l380" href="#l380">380</a><td>  // for most inputs than using RegExp.exec or iterating over each character.<tr><td><a name="l381" href="#l381">381</a><td>  var tokens1 = str1.toLowerCase().match(goog.string.numerateCompareRegExp_);<tr><td><a name="l382" href="#l382">382</a><td>  var tokens2 = str2.toLowerCase().match(goog.string.numerateCompareRegExp_);<tr><td><a name="l383" href="#l383">383</a><td><tr><td><a name="l384" href="#l384">384</a><td>  var count = Math.min(tokens1.length, tokens2.length);<tr><td><a name="l385" href="#l385">385</a><td><tr><td><a name="l386" href="#l386">386</a><td>  for (var i = 0; i &lt; count; i++) {<tr><td><a name="l387" href="#l387">387</a><td>    var a = tokens1[i];<tr><td><a name="l388" href="#l388">388</a><td>    var b = tokens2[i];<tr><td><a name="l389" href="#l389">389</a><td><tr><td><a name="l390" href="#l390">390</a><td>    // Compare pairs of tokens, returning if one token sorts before the other.<tr><td><a name="l391" href="#l391">391</a><td>    if (a != b) {<tr><td><a name="l392" href="#l392">392</a><td><tr><td><a name="l393" href="#l393">393</a><td>      // Only if both tokens are integers is a special comparison required.<tr><td><a name="l394" href="#l394">394</a><td>      // Decimal numbers are sorted as strings (e.g., &#39;.09&#39; &lt; &#39;.1&#39;).<tr><td><a name="l395" href="#l395">395</a><td>      var num1 = parseInt(a, 10);<tr><td><a name="l396" href="#l396">396</a><td>      if (!isNaN(num1)) {<tr><td><a name="l397" href="#l397">397</a><td>        var num2 = parseInt(b, 10);<tr><td><a name="l398" href="#l398">398</a><td>        if (!isNaN(num2) &amp;&amp; num1 - num2) {<tr><td><a name="l399" href="#l399">399</a><td>          return num1 - num2;<tr><td><a name="l400" href="#l400">400</a><td>        }<tr><td><a name="l401" href="#l401">401</a><td>      }<tr><td><a name="l402" href="#l402">402</a><td>      return a &lt; b ? -1 : 1;<tr><td><a name="l403" href="#l403">403</a><td>    }<tr><td><a name="l404" href="#l404">404</a><td>  }<tr><td><a name="l405" href="#l405">405</a><td><tr><td><a name="l406" href="#l406">406</a><td>  // If one string is a substring of the other, the shorter string sorts first.<tr><td><a name="l407" href="#l407">407</a><td>  if (tokens1.length != tokens2.length) {<tr><td><a name="l408" href="#l408">408</a><td>    return tokens1.length - tokens2.length;<tr><td><a name="l409" href="#l409">409</a><td>  }<tr><td><a name="l410" href="#l410">410</a><td><tr><td><a name="l411" href="#l411">411</a><td>  // The two strings must be equivalent except for case (perfect equality is<tr><td><a name="l412" href="#l412">412</a><td>  // tested at the head of the function.) Revert to default ASCII-betical string<tr><td><a name="l413" href="#l413">413</a><td>  // comparison to stablize the sort.<tr><td><a name="l414" href="#l414">414</a><td>  return str1 &lt; str2 ? -1 : 1;<tr><td><a name="l415" href="#l415">415</a><td>};<tr><td><a name="l416" href="#l416">416</a><td><tr><td><a name="l417" href="#l417">417</a><td><tr><td><a name="l418" href="#l418">418</a><td>/**<tr><td><a name="l419" href="#l419">419</a><td> * URL-encodes a string<tr><td><a name="l420" href="#l420">420</a><td> * @param {*} str The string to url-encode.<tr><td><a name="l421" href="#l421">421</a><td> * @return {string} An encoded copy of {@code str} that is safe for urls.<tr><td><a name="l422" href="#l422">422</a><td> *     Note that &#39;#&#39;, &#39;:&#39;, and other characters used to delimit portions<tr><td><a name="l423" href="#l423">423</a><td> *     of URLs *will* be encoded.<tr><td><a name="l424" href="#l424">424</a><td> */<tr><td><a name="l425" href="#l425">425</a><td>goog.string.urlEncode = function(str) {<tr><td><a name="l426" href="#l426">426</a><td>  return encodeURIComponent(String(str));<tr><td><a name="l427" href="#l427">427</a><td>};<tr><td><a name="l428" href="#l428">428</a><td><tr><td><a name="l429" href="#l429">429</a><td><tr><td><a name="l430" href="#l430">430</a><td>/**<tr><td><a name="l431" href="#l431">431</a><td> * URL-decodes the string. We need to specially handle &#39;+&#39;s because<tr><td><a name="l432" href="#l432">432</a><td> * the javascript library doesn&#39;t convert them to spaces.<tr><td><a name="l433" href="#l433">433</a><td> * @param {string} str The string to url decode.<tr><td><a name="l434" href="#l434">434</a><td> * @return {string} The decoded {@code str}.<tr><td><a name="l435" href="#l435">435</a><td> */<tr><td><a name="l436" href="#l436">436</a><td>goog.string.urlDecode = function(str) {<tr><td><a name="l437" href="#l437">437</a><td>  return decodeURIComponent(str.replace(/\+/g, &#39; &#39;));<tr><td><a name="l438" href="#l438">438</a><td>};<tr><td><a name="l439" href="#l439">439</a><td><tr><td><a name="l440" href="#l440">440</a><td><tr><td><a name="l441" href="#l441">441</a><td>/**<tr><td><a name="l442" href="#l442">442</a><td> * Converts \n to &lt;br&gt;s or &lt;br /&gt;s.<tr><td><a name="l443" href="#l443">443</a><td> * @param {string} str The string in which to convert newlines.<tr><td><a name="l444" href="#l444">444</a><td> * @param {boolean=} opt_xml Whether to use XML compatible tags.<tr><td><a name="l445" href="#l445">445</a><td> * @return {string} A copy of {@code str} with converted newlines.<tr><td><a name="l446" href="#l446">446</a><td> */<tr><td><a name="l447" href="#l447">447</a><td>goog.string.newLineToBr = function(str, opt_xml) {<tr><td><a name="l448" href="#l448">448</a><td>  return str.replace(/(\r\n|\r|\n)/g, opt_xml ? &#39;&lt;br /&gt;&#39; : &#39;&lt;br&gt;&#39;);<tr><td><a name="l449" href="#l449">449</a><td>};<tr><td><a name="l450" href="#l450">450</a><td><tr><td><a name="l451" href="#l451">451</a><td><tr><td><a name="l452" href="#l452">452</a><td>/**<tr><td><a name="l453" href="#l453">453</a><td> * Escape double quote &#39;&quot;&#39; characters in addition to &#39;&amp;&#39;, &#39;&lt;&#39;, and &#39;&gt;&#39; so that a<tr><td><a name="l454" href="#l454">454</a><td> * string can be included in an HTML tag attribute value within double quotes.<tr><td><a name="l455" href="#l455">455</a><td> *<tr><td><a name="l456" href="#l456">456</a><td> * It should be noted that &gt; doesn&#39;t need to be escaped for the HTML or XML to<tr><td><a name="l457" href="#l457">457</a><td> * be valid, but it has been decided to escape it for consistency with other<tr><td><a name="l458" href="#l458">458</a><td> * implementations.<tr><td><a name="l459" href="#l459">459</a><td> *<tr><td><a name="l460" href="#l460">460</a><td> * NOTE(user):<tr><td><a name="l461" href="#l461">461</a><td> * HtmlEscape is often called during the generation of large blocks of HTML.<tr><td><a name="l462" href="#l462">462</a><td> * Using statics for the regular expressions and strings is an optimization<tr><td><a name="l463" href="#l463">463</a><td> * that can more than half the amount of time IE spends in this function for<tr><td><a name="l464" href="#l464">464</a><td> * large apps, since strings and regexes both contribute to GC allocations.<tr><td><a name="l465" href="#l465">465</a><td> *<tr><td><a name="l466" href="#l466">466</a><td> * Testing for the presence of a character before escaping increases the number<tr><td><a name="l467" href="#l467">467</a><td> * of function calls, but actually provides a speed increase for the average<tr><td><a name="l468" href="#l468">468</a><td> * case -- since the average case often doesn&#39;t require the escaping of all 4<tr><td><a name="l469" href="#l469">469</a><td> * characters and indexOf() is much cheaper than replace().<tr><td><a name="l470" href="#l470">470</a><td> * The worst case does suffer slightly from the additional calls, therefore the<tr><td><a name="l471" href="#l471">471</a><td> * opt_isLikelyToContainHtmlChars option has been included for situations<tr><td><a name="l472" href="#l472">472</a><td> * where all 4 HTML entities are very likely to be present and need escaping.<tr><td><a name="l473" href="#l473">473</a><td> *<tr><td><a name="l474" href="#l474">474</a><td> * Some benchmarks (times tended to fluctuate +-0.05ms):<tr><td><a name="l475" href="#l475">475</a><td> *                                     FireFox                     IE6<tr><td><a name="l476" href="#l476">476</a><td> * (no chars / average (mix of cases) / all 4 chars)<tr><td><a name="l477" href="#l477">477</a><td> * no checks                     0.13 / 0.22 / 0.22         0.23 / 0.53 / 0.80<tr><td><a name="l478" href="#l478">478</a><td> * indexOf                       0.08 / 0.17 / 0.26         0.22 / 0.54 / 0.84<tr><td><a name="l479" href="#l479">479</a><td> * indexOf + re test             0.07 / 0.17 / 0.28         0.19 / 0.50 / 0.85<tr><td><a name="l480" href="#l480">480</a><td> *<tr><td><a name="l481" href="#l481">481</a><td> * An additional advantage of checking if replace actually needs to be called<tr><td><a name="l482" href="#l482">482</a><td> * is a reduction in the number of object allocations, so as the size of the<tr><td><a name="l483" href="#l483">483</a><td> * application grows the difference between the various methods would increase.<tr><td><a name="l484" href="#l484">484</a><td> *<tr><td><a name="l485" href="#l485">485</a><td> * @param {string} str string to be escaped.<tr><td><a name="l486" href="#l486">486</a><td> * @param {boolean=} opt_isLikelyToContainHtmlChars Don&#39;t perform a check to see<tr><td><a name="l487" href="#l487">487</a><td> *     if the character needs replacing - use this option if you expect each of<tr><td><a name="l488" href="#l488">488</a><td> *     the characters to appear often. Leave false if you expect few html<tr><td><a name="l489" href="#l489">489</a><td> *     characters to occur in your strings, such as if you are escaping HTML.<tr><td><a name="l490" href="#l490">490</a><td> * @return {string} An escaped copy of {@code str}.<tr><td><a name="l491" href="#l491">491</a><td> */<tr><td><a name="l492" href="#l492">492</a><td>goog.string.htmlEscape = function(str, opt_isLikelyToContainHtmlChars) {<tr><td><a name="l493" href="#l493">493</a><td><tr><td><a name="l494" href="#l494">494</a><td>  if (opt_isLikelyToContainHtmlChars) {<tr><td><a name="l495" href="#l495">495</a><td>    return str.replace(goog.string.amperRe_, &#39;&amp;amp;&#39;)<tr><td><a name="l496" href="#l496">496</a><td>          .replace(goog.string.ltRe_, &#39;&amp;lt;&#39;)<tr><td><a name="l497" href="#l497">497</a><td>          .replace(goog.string.gtRe_, &#39;&amp;gt;&#39;)<tr><td><a name="l498" href="#l498">498</a><td>          .replace(goog.string.quotRe_, &#39;&amp;quot;&#39;);<tr><td><a name="l499" href="#l499">499</a><td><tr><td><a name="l500" href="#l500">500</a><td>  } else {<tr><td><a name="l501" href="#l501">501</a><td>    // quick test helps in the case when there are no chars to replace, in<tr><td><a name="l502" href="#l502">502</a><td>    // worst case this makes barely a difference to the time taken<tr><td><a name="l503" href="#l503">503</a><td>    if (!goog.string.allRe_.test(str)) return str;<tr><td><a name="l504" href="#l504">504</a><td><tr><td><a name="l505" href="#l505">505</a><td>    // str.indexOf is faster than regex.test in this case<tr><td><a name="l506" href="#l506">506</a><td>    if (str.indexOf(&#39;&amp;&#39;) != -1) {<tr><td><a name="l507" href="#l507">507</a><td>      str = str.replace(goog.string.amperRe_, &#39;&amp;amp;&#39;);<tr><td><a name="l508" href="#l508">508</a><td>    }<tr><td><a name="l509" href="#l509">509</a><td>    if (str.indexOf(&#39;&lt;&#39;) != -1) {<tr><td><a name="l510" href="#l510">510</a><td>      str = str.replace(goog.string.ltRe_, &#39;&amp;lt;&#39;);<tr><td><a name="l511" href="#l511">511</a><td>    }<tr><td><a name="l512" href="#l512">512</a><td>    if (str.indexOf(&#39;&gt;&#39;) != -1) {<tr><td><a name="l513" href="#l513">513</a><td>      str = str.replace(goog.string.gtRe_, &#39;&amp;gt;&#39;);<tr><td><a name="l514" href="#l514">514</a><td>    }<tr><td><a name="l515" href="#l515">515</a><td>    if (str.indexOf(&#39;&quot;&#39;) != -1) {<tr><td><a name="l516" href="#l516">516</a><td>      str = str.replace(goog.string.quotRe_, &#39;&amp;quot;&#39;);<tr><td><a name="l517" href="#l517">517</a><td>    }<tr><td><a name="l518" href="#l518">518</a><td>    return str;<tr><td><a name="l519" href="#l519">519</a><td>  }<tr><td><a name="l520" href="#l520">520</a><td>};<tr><td><a name="l521" href="#l521">521</a><td><tr><td><a name="l522" href="#l522">522</a><td><tr><td><a name="l523" href="#l523">523</a><td>/**<tr><td><a name="l524" href="#l524">524</a><td> * Regular expression that matches an ampersand, for use in escaping.<tr><td><a name="l525" href="#l525">525</a><td> * @type {RegExp}<tr><td><a name="l526" href="#l526">526</a><td> * @private<tr><td><a name="l527" href="#l527">527</a><td> */<tr><td><a name="l528" href="#l528">528</a><td>goog.string.amperRe_ = /&amp;/g;<tr><td><a name="l529" href="#l529">529</a><td><tr><td><a name="l530" href="#l530">530</a><td><tr><td><a name="l531" href="#l531">531</a><td>/**<tr><td><a name="l532" href="#l532">532</a><td> * Regular expression that matches a less than sign, for use in escaping.<tr><td><a name="l533" href="#l533">533</a><td> * @type {RegExp}<tr><td><a name="l534" href="#l534">534</a><td> * @private<tr><td><a name="l535" href="#l535">535</a><td> */<tr><td><a name="l536" href="#l536">536</a><td>goog.string.ltRe_ = /&lt;/g;<tr><td><a name="l537" href="#l537">537</a><td><tr><td><a name="l538" href="#l538">538</a><td><tr><td><a name="l539" href="#l539">539</a><td>/**<tr><td><a name="l540" href="#l540">540</a><td> * Regular expression that matches a greater than sign, for use in escaping.<tr><td><a name="l541" href="#l541">541</a><td> * @type {RegExp}<tr><td><a name="l542" href="#l542">542</a><td> * @private<tr><td><a name="l543" href="#l543">543</a><td> */<tr><td><a name="l544" href="#l544">544</a><td>goog.string.gtRe_ = /&gt;/g;<tr><td><a name="l545" href="#l545">545</a><td><tr><td><a name="l546" href="#l546">546</a><td><tr><td><a name="l547" href="#l547">547</a><td>/**<tr><td><a name="l548" href="#l548">548</a><td> * Regular expression that matches a double quote, for use in escaping.<tr><td><a name="l549" href="#l549">549</a><td> * @type {RegExp}<tr><td><a name="l550" href="#l550">550</a><td> * @private<tr><td><a name="l551" href="#l551">551</a><td> */<tr><td><a name="l552" href="#l552">552</a><td>goog.string.quotRe_ = /\&quot;/g;<tr><td><a name="l553" href="#l553">553</a><td><tr><td><a name="l554" href="#l554">554</a><td><tr><td><a name="l555" href="#l555">555</a><td>/**<tr><td><a name="l556" href="#l556">556</a><td> * Regular expression that matches any character that needs to be escaped.<tr><td><a name="l557" href="#l557">557</a><td> * @type {RegExp}<tr><td><a name="l558" href="#l558">558</a><td> * @private<tr><td><a name="l559" href="#l559">559</a><td> */<tr><td><a name="l560" href="#l560">560</a><td>goog.string.allRe_ = /[&amp;&lt;&gt;\&quot;]/;<tr><td><a name="l561" href="#l561">561</a><td><tr><td><a name="l562" href="#l562">562</a><td><tr><td><a name="l563" href="#l563">563</a><td>/**<tr><td><a name="l564" href="#l564">564</a><td> * Unescapes an HTML string.<tr><td><a name="l565" href="#l565">565</a><td> *<tr><td><a name="l566" href="#l566">566</a><td> * @param {string} str The string to unescape.<tr><td><a name="l567" href="#l567">567</a><td> * @return {string} An unescaped copy of {@code str}.<tr><td><a name="l568" href="#l568">568</a><td> */<tr><td><a name="l569" href="#l569">569</a><td>goog.string.unescapeEntities = function(str) {<tr><td><a name="l570" href="#l570">570</a><td>  if (goog.string.contains(str, &#39;&amp;&#39;)) {<tr><td><a name="l571" href="#l571">571</a><td>    // We are careful not to use a DOM if we do not have one. We use the []<tr><td><a name="l572" href="#l572">572</a><td>    // notation so that the JSCompiler will not complain about these objects and<tr><td><a name="l573" href="#l573">573</a><td>    // fields in the case where we have no DOM.<tr><td><a name="l574" href="#l574">574</a><td>    if (&#39;document&#39; in goog.global) {<tr><td><a name="l575" href="#l575">575</a><td>      return goog.string.unescapeEntitiesUsingDom_(str);<tr><td><a name="l576" href="#l576">576</a><td>    } else {<tr><td><a name="l577" href="#l577">577</a><td>      // Fall back on pure XML entities<tr><td><a name="l578" href="#l578">578</a><td>      return goog.string.unescapePureXmlEntities_(str);<tr><td><a name="l579" href="#l579">579</a><td>    }<tr><td><a name="l580" href="#l580">580</a><td>  }<tr><td><a name="l581" href="#l581">581</a><td>  return str;<tr><td><a name="l582" href="#l582">582</a><td>};<tr><td><a name="l583" href="#l583">583</a><td><tr><td><a name="l584" href="#l584">584</a><td><tr><td><a name="l585" href="#l585">585</a><td>/**<tr><td><a name="l586" href="#l586">586</a><td> * Unescapes an HTML string using a DOM to resolve non-XML, non-numeric<tr><td><a name="l587" href="#l587">587</a><td> * entities. This function is XSS-safe and whitespace-preserving.<tr><td><a name="l588" href="#l588">588</a><td> * @private<tr><td><a name="l589" href="#l589">589</a><td> * @param {string} str The string to unescape.<tr><td><a name="l590" href="#l590">590</a><td> * @return {string} The unescaped {@code str} string.<tr><td><a name="l591" href="#l591">591</a><td> */<tr><td><a name="l592" href="#l592">592</a><td>goog.string.unescapeEntitiesUsingDom_ = function(str) {<tr><td><a name="l593" href="#l593">593</a><td>  var seen = {&#39;&amp;amp;&#39;: &#39;&amp;&#39;, &#39;&amp;lt;&#39;: &#39;&lt;&#39;, &#39;&amp;gt;&#39;: &#39;&gt;&#39;, &#39;&amp;quot;&#39;: &#39;&quot;&#39;};<tr><td><a name="l594" href="#l594">594</a><td>  var div = document.createElement(&#39;div&#39;);<tr><td><a name="l595" href="#l595">595</a><td>  // Match as many valid entity characters as possible. If the actual entity<tr><td><a name="l596" href="#l596">596</a><td>  // happens to be shorter, it will still work as innerHTML will return the<tr><td><a name="l597" href="#l597">597</a><td>  // trailing characters unchanged. Since the entity characters do not include<tr><td><a name="l598" href="#l598">598</a><td>  // open angle bracket, there is no chance of XSS from the innerHTML use.<tr><td><a name="l599" href="#l599">599</a><td>  // Since no whitespace is passed to innerHTML, whitespace is preserved.<tr><td><a name="l600" href="#l600">600</a><td>  return str.replace(goog.string.HTML_ENTITY_PATTERN_, function(s, entity) {<tr><td><a name="l601" href="#l601">601</a><td>    // Check for cached entity.<tr><td><a name="l602" href="#l602">602</a><td>    var value = seen[s];<tr><td><a name="l603" href="#l603">603</a><td>    if (value) {<tr><td><a name="l604" href="#l604">604</a><td>      return value;<tr><td><a name="l605" href="#l605">605</a><td>    }<tr><td><a name="l606" href="#l606">606</a><td>    // Check for numeric entity.<tr><td><a name="l607" href="#l607">607</a><td>    if (entity.charAt(0) == &#39;#&#39;) {<tr><td><a name="l608" href="#l608">608</a><td>      // Prefix with 0 so that hex entities (e.g. &amp;#x10) parse as hex numbers.<tr><td><a name="l609" href="#l609">609</a><td>      var n = Number(&#39;0&#39; + entity.substr(1));<tr><td><a name="l610" href="#l610">610</a><td>      if (!isNaN(n)) {<tr><td><a name="l611" href="#l611">611</a><td>        value = String.fromCharCode(n);<tr><td><a name="l612" href="#l612">612</a><td>      }<tr><td><a name="l613" href="#l613">613</a><td>    }<tr><td><a name="l614" href="#l614">614</a><td>    // Fall back to innerHTML otherwise.<tr><td><a name="l615" href="#l615">615</a><td>    if (!value) {<tr><td><a name="l616" href="#l616">616</a><td>      // Append a non-entity character to avoid a bug in Webkit that parses<tr><td><a name="l617" href="#l617">617</a><td>      // an invalid entity at the end of innerHTML text as the empty string.<tr><td><a name="l618" href="#l618">618</a><td>      div.innerHTML = s + &#39; &#39;;<tr><td><a name="l619" href="#l619">619</a><td>      // Then remove the trailing character from the result.<tr><td><a name="l620" href="#l620">620</a><td>      value = div.firstChild.nodeValue.slice(0, -1);<tr><td><a name="l621" href="#l621">621</a><td>    }<tr><td><a name="l622" href="#l622">622</a><td>    // Cache and return.<tr><td><a name="l623" href="#l623">623</a><td>    return seen[s] = value;<tr><td><a name="l624" href="#l624">624</a><td>  });<tr><td><a name="l625" href="#l625">625</a><td>};<tr><td><a name="l626" href="#l626">626</a><td><tr><td><a name="l627" href="#l627">627</a><td><tr><td><a name="l628" href="#l628">628</a><td>/**<tr><td><a name="l629" href="#l629">629</a><td> * Unescapes XML entities.<tr><td><a name="l630" href="#l630">630</a><td> * @private<tr><td><a name="l631" href="#l631">631</a><td> * @param {string} str The string to unescape.<tr><td><a name="l632" href="#l632">632</a><td> * @return {string} An unescaped copy of {@code str}.<tr><td><a name="l633" href="#l633">633</a><td> */<tr><td><a name="l634" href="#l634">634</a><td>goog.string.unescapePureXmlEntities_ = function(str) {<tr><td><a name="l635" href="#l635">635</a><td>  return str.replace(/&amp;([^;]+);/g, function(s, entity) {<tr><td><a name="l636" href="#l636">636</a><td>    switch (entity) {<tr><td><a name="l637" href="#l637">637</a><td>      case &#39;amp&#39;:<tr><td><a name="l638" href="#l638">638</a><td>        return &#39;&amp;&#39;;<tr><td><a name="l639" href="#l639">639</a><td>      case &#39;lt&#39;:<tr><td><a name="l640" href="#l640">640</a><td>        return &#39;&lt;&#39;;<tr><td><a name="l641" href="#l641">641</a><td>      case &#39;gt&#39;:<tr><td><a name="l642" href="#l642">642</a><td>        return &#39;&gt;&#39;;<tr><td><a name="l643" href="#l643">643</a><td>      case &#39;quot&#39;:<tr><td><a name="l644" href="#l644">644</a><td>        return &#39;&quot;&#39;;<tr><td><a name="l645" href="#l645">645</a><td>      default:<tr><td><a name="l646" href="#l646">646</a><td>        if (entity.charAt(0) == &#39;#&#39;) {<tr><td><a name="l647" href="#l647">647</a><td>          // Prefix with 0 so that hex entities (e.g. &amp;#x10) parse as hex.<tr><td><a name="l648" href="#l648">648</a><td>          var n = Number(&#39;0&#39; + entity.substr(1));<tr><td><a name="l649" href="#l649">649</a><td>          if (!isNaN(n)) {<tr><td><a name="l650" href="#l650">650</a><td>            return String.fromCharCode(n);<tr><td><a name="l651" href="#l651">651</a><td>          }<tr><td><a name="l652" href="#l652">652</a><td>        }<tr><td><a name="l653" href="#l653">653</a><td>        // For invalid entities we just return the entity<tr><td><a name="l654" href="#l654">654</a><td>        return s;<tr><td><a name="l655" href="#l655">655</a><td>    }<tr><td><a name="l656" href="#l656">656</a><td>  });<tr><td><a name="l657" href="#l657">657</a><td>};<tr><td><a name="l658" href="#l658">658</a><td><tr><td><a name="l659" href="#l659">659</a><td><tr><td><a name="l660" href="#l660">660</a><td>/**<tr><td><a name="l661" href="#l661">661</a><td> * Regular expression that matches an HTML entity.<tr><td><a name="l662" href="#l662">662</a><td> * See also HTML5: Tokenization / Tokenizing character references.<tr><td><a name="l663" href="#l663">663</a><td> * @private<tr><td><a name="l664" href="#l664">664</a><td> * @type {!RegExp}<tr><td><a name="l665" href="#l665">665</a><td> */<tr><td><a name="l666" href="#l666">666</a><td>goog.string.HTML_ENTITY_PATTERN_ = /&amp;([^;\s&lt;&amp;]+);?/g;<tr><td><a name="l667" href="#l667">667</a><td><tr><td><a name="l668" href="#l668">668</a><td><tr><td><a name="l669" href="#l669">669</a><td>/**<tr><td><a name="l670" href="#l670">670</a><td> * Do escaping of whitespace to preserve spatial formatting. We use character<tr><td><a name="l671" href="#l671">671</a><td> * entity #160 to make it safer for xml.<tr><td><a name="l672" href="#l672">672</a><td> * @param {string} str The string in which to escape whitespace.<tr><td><a name="l673" href="#l673">673</a><td> * @param {boolean=} opt_xml Whether to use XML compatible tags.<tr><td><a name="l674" href="#l674">674</a><td> * @return {string} An escaped copy of {@code str}.<tr><td><a name="l675" href="#l675">675</a><td> */<tr><td><a name="l676" href="#l676">676</a><td>goog.string.whitespaceEscape = function(str, opt_xml) {<tr><td><a name="l677" href="#l677">677</a><td>  return goog.string.newLineToBr(str.replace(/  /g, &#39; &amp;#160;&#39;), opt_xml);<tr><td><a name="l678" href="#l678">678</a><td>};<tr><td><a name="l679" href="#l679">679</a><td><tr><td><a name="l680" href="#l680">680</a><td><tr><td><a name="l681" href="#l681">681</a><td>/**<tr><td><a name="l682" href="#l682">682</a><td> * Strip quote characters around a string.  The second argument is a string of<tr><td><a name="l683" href="#l683">683</a><td> * characters to treat as quotes.  This can be a single character or a string of<tr><td><a name="l684" href="#l684">684</a><td> * multiple character and in that case each of those are treated as possible<tr><td><a name="l685" href="#l685">685</a><td> * quote characters. For example:<tr><td><a name="l686" href="#l686">686</a><td> *<tr><td><a name="l687" href="#l687">687</a><td> * &lt;pre&gt;<tr><td><a name="l688" href="#l688">688</a><td> * goog.string.stripQuotes(&#39;&quot;abc&quot;&#39;, &#39;&quot;`&#39;) --&gt; &#39;abc&#39;<tr><td><a name="l689" href="#l689">689</a><td> * goog.string.stripQuotes(&#39;`abc`&#39;, &#39;&quot;`&#39;) --&gt; &#39;abc&#39;<tr><td><a name="l690" href="#l690">690</a><td> * &lt;/pre&gt;<tr><td><a name="l691" href="#l691">691</a><td> *<tr><td><a name="l692" href="#l692">692</a><td> * @param {string} str The string to strip.<tr><td><a name="l693" href="#l693">693</a><td> * @param {string} quoteChars The quote characters to strip.<tr><td><a name="l694" href="#l694">694</a><td> * @return {string} A copy of {@code str} without the quotes.<tr><td><a name="l695" href="#l695">695</a><td> */<tr><td><a name="l696" href="#l696">696</a><td>goog.string.stripQuotes = function(str, quoteChars) {<tr><td><a name="l697" href="#l697">697</a><td>  var length = quoteChars.length;<tr><td><a name="l698" href="#l698">698</a><td>  for (var i = 0; i &lt; length; i++) {<tr><td><a name="l699" href="#l699">699</a><td>    var quoteChar = length == 1 ? quoteChars : quoteChars.charAt(i);<tr><td><a name="l700" href="#l700">700</a><td>    if (str.charAt(0) == quoteChar &amp;&amp; str.charAt(str.length - 1) == quoteChar) {<tr><td><a name="l701" href="#l701">701</a><td>      return str.substring(1, str.length - 1);<tr><td><a name="l702" href="#l702">702</a><td>    }<tr><td><a name="l703" href="#l703">703</a><td>  }<tr><td><a name="l704" href="#l704">704</a><td>  return str;<tr><td><a name="l705" href="#l705">705</a><td>};<tr><td><a name="l706" href="#l706">706</a><td><tr><td><a name="l707" href="#l707">707</a><td><tr><td><a name="l708" href="#l708">708</a><td>/**<tr><td><a name="l709" href="#l709">709</a><td> * Truncates a string to a certain length and adds &#39;...&#39; if necessary.  The<tr><td><a name="l710" href="#l710">710</a><td> * length also accounts for the ellipsis, so a maximum length of 10 and a string<tr><td><a name="l711" href="#l711">711</a><td> * &#39;Hello World!&#39; produces &#39;Hello W...&#39;.<tr><td><a name="l712" href="#l712">712</a><td> * @param {string} str The string to truncate.<tr><td><a name="l713" href="#l713">713</a><td> * @param {number} chars Max number of characters.<tr><td><a name="l714" href="#l714">714</a><td> * @param {boolean=} opt_protectEscapedCharacters Whether to protect escaped<tr><td><a name="l715" href="#l715">715</a><td> *     characters from being cut off in the middle.<tr><td><a name="l716" href="#l716">716</a><td> * @return {string} The truncated {@code str} string.<tr><td><a name="l717" href="#l717">717</a><td> */<tr><td><a name="l718" href="#l718">718</a><td>goog.string.truncate = function(str, chars, opt_protectEscapedCharacters) {<tr><td><a name="l719" href="#l719">719</a><td>  if (opt_protectEscapedCharacters) {<tr><td><a name="l720" href="#l720">720</a><td>    str = goog.string.unescapeEntities(str);<tr><td><a name="l721" href="#l721">721</a><td>  }<tr><td><a name="l722" href="#l722">722</a><td><tr><td><a name="l723" href="#l723">723</a><td>  if (str.length &gt; chars) {<tr><td><a name="l724" href="#l724">724</a><td>    str = str.substring(0, chars - 3) + &#39;...&#39;;<tr><td><a name="l725" href="#l725">725</a><td>  }<tr><td><a name="l726" href="#l726">726</a><td><tr><td><a name="l727" href="#l727">727</a><td>  if (opt_protectEscapedCharacters) {<tr><td><a name="l728" href="#l728">728</a><td>    str = goog.string.htmlEscape(str);<tr><td><a name="l729" href="#l729">729</a><td>  }<tr><td><a name="l730" href="#l730">730</a><td><tr><td><a name="l731" href="#l731">731</a><td>  return str;<tr><td><a name="l732" href="#l732">732</a><td>};<tr><td><a name="l733" href="#l733">733</a><td><tr><td><a name="l734" href="#l734">734</a><td><tr><td><a name="l735" href="#l735">735</a><td>/**<tr><td><a name="l736" href="#l736">736</a><td> * Truncate a string in the middle, adding &quot;...&quot; if necessary,<tr><td><a name="l737" href="#l737">737</a><td> * and favoring the beginning of the string.<tr><td><a name="l738" href="#l738">738</a><td> * @param {string} str The string to truncate the middle of.<tr><td><a name="l739" href="#l739">739</a><td> * @param {number} chars Max number of characters.<tr><td><a name="l740" href="#l740">740</a><td> * @param {boolean=} opt_protectEscapedCharacters Whether to protect escaped<tr><td><a name="l741" href="#l741">741</a><td> *     characters from being cutoff in the middle.<tr><td><a name="l742" href="#l742">742</a><td> * @param {number=} opt_trailingChars Optional number of trailing characters to<tr><td><a name="l743" href="#l743">743</a><td> *     leave at the end of the string, instead of truncating as close to the<tr><td><a name="l744" href="#l744">744</a><td> *     middle as possible.<tr><td><a name="l745" href="#l745">745</a><td> * @return {string} A truncated copy of {@code str}.<tr><td><a name="l746" href="#l746">746</a><td> */<tr><td><a name="l747" href="#l747">747</a><td>goog.string.truncateMiddle = function(str, chars,<tr><td><a name="l748" href="#l748">748</a><td>    opt_protectEscapedCharacters, opt_trailingChars) {<tr><td><a name="l749" href="#l749">749</a><td>  if (opt_protectEscapedCharacters) {<tr><td><a name="l750" href="#l750">750</a><td>    str = goog.string.unescapeEntities(str);<tr><td><a name="l751" href="#l751">751</a><td>  }<tr><td><a name="l752" href="#l752">752</a><td><tr><td><a name="l753" href="#l753">753</a><td>  if (opt_trailingChars &amp;&amp; str.length &gt; chars) {<tr><td><a name="l754" href="#l754">754</a><td>    if (opt_trailingChars &gt; chars) {<tr><td><a name="l755" href="#l755">755</a><td>      opt_trailingChars = chars;<tr><td><a name="l756" href="#l756">756</a><td>    }<tr><td><a name="l757" href="#l757">757</a><td>    var endPoint = str.length - opt_trailingChars;<tr><td><a name="l758" href="#l758">758</a><td>    var startPoint = chars - opt_trailingChars;<tr><td><a name="l759" href="#l759">759</a><td>    str = str.substring(0, startPoint) + &#39;...&#39; + str.substring(endPoint);<tr><td><a name="l760" href="#l760">760</a><td>  } else if (str.length &gt; chars) {<tr><td><a name="l761" href="#l761">761</a><td>    // Favor the beginning of the string:<tr><td><a name="l762" href="#l762">762</a><td>    var half = Math.floor(chars / 2);<tr><td><a name="l763" href="#l763">763</a><td>    var endPos = str.length - half;<tr><td><a name="l764" href="#l764">764</a><td>    half += chars % 2;<tr><td><a name="l765" href="#l765">765</a><td>    str = str.substring(0, half) + &#39;...&#39; + str.substring(endPos);<tr><td><a name="l766" href="#l766">766</a><td>  }<tr><td><a name="l767" href="#l767">767</a><td><tr><td><a name="l768" href="#l768">768</a><td>  if (opt_protectEscapedCharacters) {<tr><td><a name="l769" href="#l769">769</a><td>    str = goog.string.htmlEscape(str);<tr><td><a name="l770" href="#l770">770</a><td>  }<tr><td><a name="l771" href="#l771">771</a><td><tr><td><a name="l772" href="#l772">772</a><td>  return str;<tr><td><a name="l773" href="#l773">773</a><td>};<tr><td><a name="l774" href="#l774">774</a><td><tr><td><a name="l775" href="#l775">775</a><td><tr><td><a name="l776" href="#l776">776</a><td>/**<tr><td><a name="l777" href="#l777">777</a><td> * Special chars that need to be escaped for goog.string.quote.<tr><td><a name="l778" href="#l778">778</a><td> * @private<tr><td><a name="l779" href="#l779">779</a><td> * @type {Object}<tr><td><a name="l780" href="#l780">780</a><td> */<tr><td><a name="l781" href="#l781">781</a><td>goog.string.specialEscapeChars_ = {<tr><td><a name="l782" href="#l782">782</a><td>  &#39;\0&#39;: &#39;\\0&#39;,<tr><td><a name="l783" href="#l783">783</a><td>  &#39;\b&#39;: &#39;\\b&#39;,<tr><td><a name="l784" href="#l784">784</a><td>  &#39;\f&#39;: &#39;\\f&#39;,<tr><td><a name="l785" href="#l785">785</a><td>  &#39;\n&#39;: &#39;\\n&#39;,<tr><td><a name="l786" href="#l786">786</a><td>  &#39;\r&#39;: &#39;\\r&#39;,<tr><td><a name="l787" href="#l787">787</a><td>  &#39;\t&#39;: &#39;\\t&#39;,<tr><td><a name="l788" href="#l788">788</a><td>  &#39;\x0B&#39;: &#39;\\x0B&#39;, // &#39;\v&#39; is not supported in JScript<tr><td><a name="l789" href="#l789">789</a><td>  &#39;&quot;&#39;: &#39;\\&quot;&#39;,<tr><td><a name="l790" href="#l790">790</a><td>  &#39;\\&#39;: &#39;\\\\&#39;<tr><td><a name="l791" href="#l791">791</a><td>};<tr><td><a name="l792" href="#l792">792</a><td><tr><td><a name="l793" href="#l793">793</a><td><tr><td><a name="l794" href="#l794">794</a><td>/**<tr><td><a name="l795" href="#l795">795</a><td> * Character mappings used internally for goog.string.escapeChar.<tr><td><a name="l796" href="#l796">796</a><td> * @private<tr><td><a name="l797" href="#l797">797</a><td> * @type {Object}<tr><td><a name="l798" href="#l798">798</a><td> */<tr><td><a name="l799" href="#l799">799</a><td>goog.string.jsEscapeCache_ = {<tr><td><a name="l800" href="#l800">800</a><td>  &#39;\&#39;&#39;: &#39;\\\&#39;&#39;<tr><td><a name="l801" href="#l801">801</a><td>};<tr><td><a name="l802" href="#l802">802</a><td><tr><td><a name="l803" href="#l803">803</a><td><tr><td><a name="l804" href="#l804">804</a><td>/**<tr><td><a name="l805" href="#l805">805</a><td> * Encloses a string in double quotes and escapes characters so that the<tr><td><a name="l806" href="#l806">806</a><td> * string is a valid JS string.<tr><td><a name="l807" href="#l807">807</a><td> * @param {string} s The string to quote.<tr><td><a name="l808" href="#l808">808</a><td> * @return {string} A copy of {@code s} surrounded by double quotes.<tr><td><a name="l809" href="#l809">809</a><td> */<tr><td><a name="l810" href="#l810">810</a><td>goog.string.quote = function(s) {<tr><td><a name="l811" href="#l811">811</a><td>  s = String(s);<tr><td><a name="l812" href="#l812">812</a><td>  if (s.quote) {<tr><td><a name="l813" href="#l813">813</a><td>    return s.quote();<tr><td><a name="l814" href="#l814">814</a><td>  } else {<tr><td><a name="l815" href="#l815">815</a><td>    var sb = [&#39;&quot;&#39;];<tr><td><a name="l816" href="#l816">816</a><td>    for (var i = 0; i &lt; s.length; i++) {<tr><td><a name="l817" href="#l817">817</a><td>      var ch = s.charAt(i);<tr><td><a name="l818" href="#l818">818</a><td>      var cc = ch.charCodeAt(0);<tr><td><a name="l819" href="#l819">819</a><td>      sb[i + 1] = goog.string.specialEscapeChars_[ch] ||<tr><td><a name="l820" href="#l820">820</a><td>          ((cc &gt; 31 &amp;&amp; cc &lt; 127) ? ch : goog.string.escapeChar(ch));<tr><td><a name="l821" href="#l821">821</a><td>    }<tr><td><a name="l822" href="#l822">822</a><td>    sb.push(&#39;&quot;&#39;);<tr><td><a name="l823" href="#l823">823</a><td>    return sb.join(&#39;&#39;);<tr><td><a name="l824" href="#l824">824</a><td>  }<tr><td><a name="l825" href="#l825">825</a><td>};<tr><td><a name="l826" href="#l826">826</a><td><tr><td><a name="l827" href="#l827">827</a><td><tr><td><a name="l828" href="#l828">828</a><td>/**<tr><td><a name="l829" href="#l829">829</a><td> * Takes a string and returns the escaped string for that character.<tr><td><a name="l830" href="#l830">830</a><td> * @param {string} str The string to escape.<tr><td><a name="l831" href="#l831">831</a><td> * @return {string} An escaped string representing {@code str}.<tr><td><a name="l832" href="#l832">832</a><td> */<tr><td><a name="l833" href="#l833">833</a><td>goog.string.escapeString = function(str) {<tr><td><a name="l834" href="#l834">834</a><td>  var sb = [];<tr><td><a name="l835" href="#l835">835</a><td>  for (var i = 0; i &lt; str.length; i++) {<tr><td><a name="l836" href="#l836">836</a><td>    sb[i] = goog.string.escapeChar(str.charAt(i));<tr><td><a name="l837" href="#l837">837</a><td>  }<tr><td><a name="l838" href="#l838">838</a><td>  return sb.join(&#39;&#39;);<tr><td><a name="l839" href="#l839">839</a><td>};<tr><td><a name="l840" href="#l840">840</a><td><tr><td><a name="l841" href="#l841">841</a><td><tr><td><a name="l842" href="#l842">842</a><td>/**<tr><td><a name="l843" href="#l843">843</a><td> * Takes a character and returns the escaped string for that character. For<tr><td><a name="l844" href="#l844">844</a><td> * example escapeChar(String.fromCharCode(15)) -&gt; &quot;\\x0E&quot;.<tr><td><a name="l845" href="#l845">845</a><td> * @param {string} c The character to escape.<tr><td><a name="l846" href="#l846">846</a><td> * @return {string} An escaped string representing {@code c}.<tr><td><a name="l847" href="#l847">847</a><td> */<tr><td><a name="l848" href="#l848">848</a><td>goog.string.escapeChar = function(c) {<tr><td><a name="l849" href="#l849">849</a><td>  if (c in goog.string.jsEscapeCache_) {<tr><td><a name="l850" href="#l850">850</a><td>    return goog.string.jsEscapeCache_[c];<tr><td><a name="l851" href="#l851">851</a><td>  }<tr><td><a name="l852" href="#l852">852</a><td><tr><td><a name="l853" href="#l853">853</a><td>  if (c in goog.string.specialEscapeChars_) {<tr><td><a name="l854" href="#l854">854</a><td>    return goog.string.jsEscapeCache_[c] = goog.string.specialEscapeChars_[c];<tr><td><a name="l855" href="#l855">855</a><td>  }<tr><td><a name="l856" href="#l856">856</a><td><tr><td><a name="l857" href="#l857">857</a><td>  var rv = c;<tr><td><a name="l858" href="#l858">858</a><td>  var cc = c.charCodeAt(0);<tr><td><a name="l859" href="#l859">859</a><td>  if (cc &gt; 31 &amp;&amp; cc &lt; 127) {<tr><td><a name="l860" href="#l860">860</a><td>    rv = c;<tr><td><a name="l861" href="#l861">861</a><td>  } else {<tr><td><a name="l862" href="#l862">862</a><td>    // tab is 9 but handled above<tr><td><a name="l863" href="#l863">863</a><td>    if (cc &lt; 256) {<tr><td><a name="l864" href="#l864">864</a><td>      rv = &#39;\\x&#39;;<tr><td><a name="l865" href="#l865">865</a><td>      if (cc &lt; 16 || cc &gt; 256) {<tr><td><a name="l866" href="#l866">866</a><td>        rv += &#39;0&#39;;<tr><td><a name="l867" href="#l867">867</a><td>      }<tr><td><a name="l868" href="#l868">868</a><td>    } else {<tr><td><a name="l869" href="#l869">869</a><td>      rv = &#39;\\u&#39;;<tr><td><a name="l870" href="#l870">870</a><td>      if (cc &lt; 4096) { // \u1000<tr><td><a name="l871" href="#l871">871</a><td>        rv += &#39;0&#39;;<tr><td><a name="l872" href="#l872">872</a><td>      }<tr><td><a name="l873" href="#l873">873</a><td>    }<tr><td><a name="l874" href="#l874">874</a><td>    rv += cc.toString(16).toUpperCase();<tr><td><a name="l875" href="#l875">875</a><td>  }<tr><td><a name="l876" href="#l876">876</a><td><tr><td><a name="l877" href="#l877">877</a><td>  return goog.string.jsEscapeCache_[c] = rv;<tr><td><a name="l878" href="#l878">878</a><td>};<tr><td><a name="l879" href="#l879">879</a><td><tr><td><a name="l880" href="#l880">880</a><td><tr><td><a name="l881" href="#l881">881</a><td>/**<tr><td><a name="l882" href="#l882">882</a><td> * Takes a string and creates a map (Object) in which the keys are the<tr><td><a name="l883" href="#l883">883</a><td> * characters in the string. The value for the key is set to true. You can<tr><td><a name="l884" href="#l884">884</a><td> * then use goog.object.map or goog.array.map to change the values.<tr><td><a name="l885" href="#l885">885</a><td> * @param {string} s The string to build the map from.<tr><td><a name="l886" href="#l886">886</a><td> * @return {Object} The map of characters used.<tr><td><a name="l887" href="#l887">887</a><td> */<tr><td><a name="l888" href="#l888">888</a><td>// TODO(arv): It seems like we should have a generic goog.array.toMap. But do<tr><td><a name="l889" href="#l889">889</a><td>//            we want a dependency on goog.array in goog.string?<tr><td><a name="l890" href="#l890">890</a><td>goog.string.toMap = function(s) {<tr><td><a name="l891" href="#l891">891</a><td>  var rv = {};<tr><td><a name="l892" href="#l892">892</a><td>  for (var i = 0; i &lt; s.length; i++) {<tr><td><a name="l893" href="#l893">893</a><td>    rv[s.charAt(i)] = true;<tr><td><a name="l894" href="#l894">894</a><td>  }<tr><td><a name="l895" href="#l895">895</a><td>  return rv;<tr><td><a name="l896" href="#l896">896</a><td>};<tr><td><a name="l897" href="#l897">897</a><td><tr><td><a name="l898" href="#l898">898</a><td><tr><td><a name="l899" href="#l899">899</a><td>/**<tr><td><a name="l900" href="#l900">900</a><td> * Checks whether a string contains a given substring.<tr><td><a name="l901" href="#l901">901</a><td> * @param {string} s The string to test.<tr><td><a name="l902" href="#l902">902</a><td> * @param {string} ss The substring to test for.<tr><td><a name="l903" href="#l903">903</a><td> * @return {boolean} True if {@code s} contains {@code ss}.<tr><td><a name="l904" href="#l904">904</a><td> */<tr><td><a name="l905" href="#l905">905</a><td>goog.string.contains = function(s, ss) {<tr><td><a name="l906" href="#l906">906</a><td>  return s.indexOf(ss) != -1;<tr><td><a name="l907" href="#l907">907</a><td>};<tr><td><a name="l908" href="#l908">908</a><td><tr><td><a name="l909" href="#l909">909</a><td><tr><td><a name="l910" href="#l910">910</a><td>/**<tr><td><a name="l911" href="#l911">911</a><td> * Returns the non-overlapping occurrences of ss in s.<tr><td><a name="l912" href="#l912">912</a><td> * If either s or ss evalutes to false, then returns zero.<tr><td><a name="l913" href="#l913">913</a><td> * @param {string} s The string to look in.<tr><td><a name="l914" href="#l914">914</a><td> * @param {string} ss The string to look for.<tr><td><a name="l915" href="#l915">915</a><td> * @return {number} Number of occurrences of ss in s.<tr><td><a name="l916" href="#l916">916</a><td> */<tr><td><a name="l917" href="#l917">917</a><td>goog.string.countOf = function(s, ss) {<tr><td><a name="l918" href="#l918">918</a><td>  return s &amp;&amp; ss ? s.split(ss).length - 1 : 0;<tr><td><a name="l919" href="#l919">919</a><td>};<tr><td><a name="l920" href="#l920">920</a><td><tr><td><a name="l921" href="#l921">921</a><td><tr><td><a name="l922" href="#l922">922</a><td>/**<tr><td><a name="l923" href="#l923">923</a><td> * Removes a substring of a specified length at a specific<tr><td><a name="l924" href="#l924">924</a><td> * index in a string.<tr><td><a name="l925" href="#l925">925</a><td> * @param {string} s The base string from which to remove.<tr><td><a name="l926" href="#l926">926</a><td> * @param {number} index The index at which to remove the substring.<tr><td><a name="l927" href="#l927">927</a><td> * @param {number} stringLength The length of the substring to remove.<tr><td><a name="l928" href="#l928">928</a><td> * @return {string} A copy of {@code s} with the substring removed or the full<tr><td><a name="l929" href="#l929">929</a><td> *     string if nothing is removed or the input is invalid.<tr><td><a name="l930" href="#l930">930</a><td> */<tr><td><a name="l931" href="#l931">931</a><td>goog.string.removeAt = function(s, index, stringLength) {<tr><td><a name="l932" href="#l932">932</a><td>  var resultStr = s;<tr><td><a name="l933" href="#l933">933</a><td>  // If the index is greater or equal to 0 then remove substring<tr><td><a name="l934" href="#l934">934</a><td>  if (index &gt;= 0 &amp;&amp; index &lt; s.length &amp;&amp; stringLength &gt; 0) {<tr><td><a name="l935" href="#l935">935</a><td>    resultStr = s.substr(0, index) +<tr><td><a name="l936" href="#l936">936</a><td>        s.substr(index + stringLength, s.length - index - stringLength);<tr><td><a name="l937" href="#l937">937</a><td>  }<tr><td><a name="l938" href="#l938">938</a><td>  return resultStr;<tr><td><a name="l939" href="#l939">939</a><td>};<tr><td><a name="l940" href="#l940">940</a><td><tr><td><a name="l941" href="#l941">941</a><td><tr><td><a name="l942" href="#l942">942</a><td>/**<tr><td><a name="l943" href="#l943">943</a><td> *  Removes the first occurrence of a substring from a string.<tr><td><a name="l944" href="#l944">944</a><td> *  @param {string} s The base string from which to remove.<tr><td><a name="l945" href="#l945">945</a><td> *  @param {string} ss The string to remove.<tr><td><a name="l946" href="#l946">946</a><td> *  @return {string} A copy of {@code s} with {@code ss} removed or the full<tr><td><a name="l947" href="#l947">947</a><td> *      string if nothing is removed.<tr><td><a name="l948" href="#l948">948</a><td> */<tr><td><a name="l949" href="#l949">949</a><td>goog.string.remove = function(s, ss) {<tr><td><a name="l950" href="#l950">950</a><td>  var re = new RegExp(goog.string.regExpEscape(ss), &#39;&#39;);<tr><td><a name="l951" href="#l951">951</a><td>  return s.replace(re, &#39;&#39;);<tr><td><a name="l952" href="#l952">952</a><td>};<tr><td><a name="l953" href="#l953">953</a><td><tr><td><a name="l954" href="#l954">954</a><td><tr><td><a name="l955" href="#l955">955</a><td>/**<tr><td><a name="l956" href="#l956">956</a><td> *  Removes all occurrences of a substring from a string.<tr><td><a name="l957" href="#l957">957</a><td> *  @param {string} s The base string from which to remove.<tr><td><a name="l958" href="#l958">958</a><td> *  @param {string} ss The string to remove.<tr><td><a name="l959" href="#l959">959</a><td> *  @return {string} A copy of {@code s} with {@code ss} removed or the full<tr><td><a name="l960" href="#l960">960</a><td> *      string if nothing is removed.<tr><td><a name="l961" href="#l961">961</a><td> */<tr><td><a name="l962" href="#l962">962</a><td>goog.string.removeAll = function(s, ss) {<tr><td><a name="l963" href="#l963">963</a><td>  var re = new RegExp(goog.string.regExpEscape(ss), &#39;g&#39;);<tr><td><a name="l964" href="#l964">964</a><td>  return s.replace(re, &#39;&#39;);<tr><td><a name="l965" href="#l965">965</a><td>};<tr><td><a name="l966" href="#l966">966</a><td><tr><td><a name="l967" href="#l967">967</a><td><tr><td><a name="l968" href="#l968">968</a><td>/**<tr><td><a name="l969" href="#l969">969</a><td> * Escapes characters in the string that are not safe to use in a RegExp.<tr><td><a name="l970" href="#l970">970</a><td> * @param {*} s The string to escape. If not a string, it will be casted<tr><td><a name="l971" href="#l971">971</a><td> *     to one.<tr><td><a name="l972" href="#l972">972</a><td> * @return {string} A RegExp safe, escaped copy of {@code s}.<tr><td><a name="l973" href="#l973">973</a><td> */<tr><td><a name="l974" href="#l974">974</a><td>goog.string.regExpEscape = function(s) {<tr><td><a name="l975" href="#l975">975</a><td>  return String(s).replace(/([-()\[\]{}+?*.$\^|,:#&lt;!\\])/g, &#39;\\$1&#39;).<tr><td><a name="l976" href="#l976">976</a><td>      replace(/\x08/g, &#39;\\x08&#39;);<tr><td><a name="l977" href="#l977">977</a><td>};<tr><td><a name="l978" href="#l978">978</a><td><tr><td><a name="l979" href="#l979">979</a><td><tr><td><a name="l980" href="#l980">980</a><td>/**<tr><td><a name="l981" href="#l981">981</a><td> * Repeats a string n times.<tr><td><a name="l982" href="#l982">982</a><td> * @param {string} string The string to repeat.<tr><td><a name="l983" href="#l983">983</a><td> * @param {number} length The number of times to repeat.<tr><td><a name="l984" href="#l984">984</a><td> * @return {string} A string containing {@code length} repetitions of<tr><td><a name="l985" href="#l985">985</a><td> *     {@code string}.<tr><td><a name="l986" href="#l986">986</a><td> */<tr><td><a name="l987" href="#l987">987</a><td>goog.string.repeat = function(string, length) {<tr><td><a name="l988" href="#l988">988</a><td>  return new Array(length + 1).join(string);<tr><td><a name="l989" href="#l989">989</a><td>};<tr><td><a name="l990" href="#l990">990</a><td><tr><td><a name="l991" href="#l991">991</a><td><tr><td><a name="l992" href="#l992">992</a><td>/**<tr><td><a name="l993" href="#l993">993</a><td> * Pads number to given length and optionally rounds it to a given precision.<tr><td><a name="l994" href="#l994">994</a><td> * For example:<tr><td><a name="l995" href="#l995">995</a><td> * &lt;pre&gt;padNumber(1.25, 2, 3) -&gt; &#39;01.250&#39;<tr><td><a name="l996" href="#l996">996</a><td> * padNumber(1.25, 2) -&gt; &#39;01.25&#39;<tr><td><a name="l997" href="#l997">997</a><td> * padNumber(1.25, 2, 1) -&gt; &#39;01.3&#39;<tr><td><a name="l998" href="#l998">998</a><td> * padNumber(1.25, 0) -&gt; &#39;1.25&#39;&lt;/pre&gt;<tr><td><a name="l999" href="#l999">999</a><td> *<tr><td><a name="l1000" href="#l1000">1000</a><td> * @param {number} num The number to pad.<tr><td><a name="l1001" href="#l1001">1001</a><td> * @param {number} length The desired length.<tr><td><a name="l1002" href="#l1002">1002</a><td> * @param {number=} opt_precision The desired precision.<tr><td><a name="l1003" href="#l1003">1003</a><td> * @return {string} {@code num} as a string with the given options.<tr><td><a name="l1004" href="#l1004">1004</a><td> */<tr><td><a name="l1005" href="#l1005">1005</a><td>goog.string.padNumber = function(num, length, opt_precision) {<tr><td><a name="l1006" href="#l1006">1006</a><td>  var s = goog.isDef(opt_precision) ? num.toFixed(opt_precision) : String(num);<tr><td><a name="l1007" href="#l1007">1007</a><td>  var index = s.indexOf(&#39;.&#39;);<tr><td><a name="l1008" href="#l1008">1008</a><td>  if (index == -1) {<tr><td><a name="l1009" href="#l1009">1009</a><td>    index = s.length;<tr><td><a name="l1010" href="#l1010">1010</a><td>  }<tr><td><a name="l1011" href="#l1011">1011</a><td>  return goog.string.repeat(&#39;0&#39;, Math.max(0, length - index)) + s;<tr><td><a name="l1012" href="#l1012">1012</a><td>};<tr><td><a name="l1013" href="#l1013">1013</a><td><tr><td><a name="l1014" href="#l1014">1014</a><td><tr><td><a name="l1015" href="#l1015">1015</a><td>/**<tr><td><a name="l1016" href="#l1016">1016</a><td> * Returns a string representation of the given object, with<tr><td><a name="l1017" href="#l1017">1017</a><td> * null and undefined being returned as the empty string.<tr><td><a name="l1018" href="#l1018">1018</a><td> *<tr><td><a name="l1019" href="#l1019">1019</a><td> * @param {*} obj The object to convert.<tr><td><a name="l1020" href="#l1020">1020</a><td> * @return {string} A string representation of the {@code obj}.<tr><td><a name="l1021" href="#l1021">1021</a><td> */<tr><td><a name="l1022" href="#l1022">1022</a><td>goog.string.makeSafe = function(obj) {<tr><td><a name="l1023" href="#l1023">1023</a><td>  return obj == null ? &#39;&#39; : String(obj);<tr><td><a name="l1024" href="#l1024">1024</a><td>};<tr><td><a name="l1025" href="#l1025">1025</a><td><tr><td><a name="l1026" href="#l1026">1026</a><td><tr><td><a name="l1027" href="#l1027">1027</a><td>/**<tr><td><a name="l1028" href="#l1028">1028</a><td> * Concatenates string expressions. This is useful<tr><td><a name="l1029" href="#l1029">1029</a><td> * since some browsers are very inefficient when it comes to using plus to<tr><td><a name="l1030" href="#l1030">1030</a><td> * concat strings. Be careful when using null and undefined here since<tr><td><a name="l1031" href="#l1031">1031</a><td> * these will not be included in the result. If you need to represent these<tr><td><a name="l1032" href="#l1032">1032</a><td> * be sure to cast the argument to a String first.<tr><td><a name="l1033" href="#l1033">1033</a><td> * For example:<tr><td><a name="l1034" href="#l1034">1034</a><td> * &lt;pre&gt;buildString(&#39;a&#39;, &#39;b&#39;, &#39;c&#39;, &#39;d&#39;) -&gt; &#39;abcd&#39;<tr><td><a name="l1035" href="#l1035">1035</a><td> * buildString(null, undefined) -&gt; &#39;&#39;<tr><td><a name="l1036" href="#l1036">1036</a><td> * &lt;/pre&gt;<tr><td><a name="l1037" href="#l1037">1037</a><td> * @param {...*} var_args A list of strings to concatenate. If not a string,<tr><td><a name="l1038" href="#l1038">1038</a><td> *     it will be casted to one.<tr><td><a name="l1039" href="#l1039">1039</a><td> * @return {string} The concatenation of {@code var_args}.<tr><td><a name="l1040" href="#l1040">1040</a><td> */<tr><td><a name="l1041" href="#l1041">1041</a><td>goog.string.buildString = function(var_args) {<tr><td><a name="l1042" href="#l1042">1042</a><td>  return Array.prototype.join.call(arguments, &#39;&#39;);<tr><td><a name="l1043" href="#l1043">1043</a><td>};<tr><td><a name="l1044" href="#l1044">1044</a><td><tr><td><a name="l1045" href="#l1045">1045</a><td><tr><td><a name="l1046" href="#l1046">1046</a><td>/**<tr><td><a name="l1047" href="#l1047">1047</a><td> * Returns a string with at least 64-bits of randomness.<tr><td><a name="l1048" href="#l1048">1048</a><td> *<tr><td><a name="l1049" href="#l1049">1049</a><td> * Doesn&#39;t trust Javascript&#39;s random function entirely. Uses a combination of<tr><td><a name="l1050" href="#l1050">1050</a><td> * random and current timestamp, and then encodes the string in base-36 to<tr><td><a name="l1051" href="#l1051">1051</a><td> * make it shorter.<tr><td><a name="l1052" href="#l1052">1052</a><td> *<tr><td><a name="l1053" href="#l1053">1053</a><td> * @return {string} A random string, e.g. sn1s7vb4gcic.<tr><td><a name="l1054" href="#l1054">1054</a><td> */<tr><td><a name="l1055" href="#l1055">1055</a><td>goog.string.getRandomString = function() {<tr><td><a name="l1056" href="#l1056">1056</a><td>  var x = 2147483648;<tr><td><a name="l1057" href="#l1057">1057</a><td>  return Math.floor(Math.random() * x).toString(36) +<tr><td><a name="l1058" href="#l1058">1058</a><td>         Math.abs(Math.floor(Math.random() * x) ^ goog.now()).toString(36);<tr><td><a name="l1059" href="#l1059">1059</a><td>};<tr><td><a name="l1060" href="#l1060">1060</a><td><tr><td><a name="l1061" href="#l1061">1061</a><td><tr><td><a name="l1062" href="#l1062">1062</a><td>/**<tr><td><a name="l1063" href="#l1063">1063</a><td> * Compares two version numbers.<tr><td><a name="l1064" href="#l1064">1064</a><td> *<tr><td><a name="l1065" href="#l1065">1065</a><td> * @param {string|number} version1 Version of first item.<tr><td><a name="l1066" href="#l1066">1066</a><td> * @param {string|number} version2 Version of second item.<tr><td><a name="l1067" href="#l1067">1067</a><td> *<tr><td><a name="l1068" href="#l1068">1068</a><td> * @return {number}  1 if {@code version1} is higher.<tr><td><a name="l1069" href="#l1069">1069</a><td> *                   0 if arguments are equal.<tr><td><a name="l1070" href="#l1070">1070</a><td> *                  -1 if {@code version2} is higher.<tr><td><a name="l1071" href="#l1071">1071</a><td> */<tr><td><a name="l1072" href="#l1072">1072</a><td>goog.string.compareVersions = function(version1, version2) {<tr><td><a name="l1073" href="#l1073">1073</a><td>  var order = 0;<tr><td><a name="l1074" href="#l1074">1074</a><td>  // Trim leading and trailing whitespace and split the versions into<tr><td><a name="l1075" href="#l1075">1075</a><td>  // subversions.<tr><td><a name="l1076" href="#l1076">1076</a><td>  var v1Subs = goog.string.trim(String(version1)).split(&#39;.&#39;);<tr><td><a name="l1077" href="#l1077">1077</a><td>  var v2Subs = goog.string.trim(String(version2)).split(&#39;.&#39;);<tr><td><a name="l1078" href="#l1078">1078</a><td>  var subCount = Math.max(v1Subs.length, v2Subs.length);<tr><td><a name="l1079" href="#l1079">1079</a><td><tr><td><a name="l1080" href="#l1080">1080</a><td>  // Iterate over the subversions, as long as they appear to be equivalent.<tr><td><a name="l1081" href="#l1081">1081</a><td>  for (var subIdx = 0; order == 0 &amp;&amp; subIdx &lt; subCount; subIdx++) {<tr><td><a name="l1082" href="#l1082">1082</a><td>    var v1Sub = v1Subs[subIdx] || &#39;&#39;;<tr><td><a name="l1083" href="#l1083">1083</a><td>    var v2Sub = v2Subs[subIdx] || &#39;&#39;;<tr><td><a name="l1084" href="#l1084">1084</a><td><tr><td><a name="l1085" href="#l1085">1085</a><td>    // Split the subversions into pairs of numbers and qualifiers (like &#39;b&#39;).<tr><td><a name="l1086" href="#l1086">1086</a><td>    // Two different RegExp objects are needed because they are both using<tr><td><a name="l1087" href="#l1087">1087</a><td>    // the &#39;g&#39; flag.<tr><td><a name="l1088" href="#l1088">1088</a><td>    var v1CompParser = new RegExp(&#39;(\\d*)(\\D*)&#39;, &#39;g&#39;);<tr><td><a name="l1089" href="#l1089">1089</a><td>    var v2CompParser = new RegExp(&#39;(\\d*)(\\D*)&#39;, &#39;g&#39;);<tr><td><a name="l1090" href="#l1090">1090</a><td>    do {<tr><td><a name="l1091" href="#l1091">1091</a><td>      var v1Comp = v1CompParser.exec(v1Sub) || [&#39;&#39;, &#39;&#39;, &#39;&#39;];<tr><td><a name="l1092" href="#l1092">1092</a><td>      var v2Comp = v2CompParser.exec(v2Sub) || [&#39;&#39;, &#39;&#39;, &#39;&#39;];<tr><td><a name="l1093" href="#l1093">1093</a><td>      // Break if there are no more matches.<tr><td><a name="l1094" href="#l1094">1094</a><td>      if (v1Comp[0].length == 0 &amp;&amp; v2Comp[0].length == 0) {<tr><td><a name="l1095" href="#l1095">1095</a><td>        break;<tr><td><a name="l1096" href="#l1096">1096</a><td>      }<tr><td><a name="l1097" href="#l1097">1097</a><td><tr><td><a name="l1098" href="#l1098">1098</a><td>      // Parse the numeric part of the subversion. A missing number is<tr><td><a name="l1099" href="#l1099">1099</a><td>      // equivalent to 0.<tr><td><a name="l1100" href="#l1100">1100</a><td>      var v1CompNum = v1Comp[1].length == 0 ? 0 : parseInt(v1Comp[1], 10);<tr><td><a name="l1101" href="#l1101">1101</a><td>      var v2CompNum = v2Comp[1].length == 0 ? 0 : parseInt(v2Comp[1], 10);<tr><td><a name="l1102" href="#l1102">1102</a><td><tr><td><a name="l1103" href="#l1103">1103</a><td>      // Compare the subversion components. The number has the highest<tr><td><a name="l1104" href="#l1104">1104</a><td>      // precedence. Next, if the numbers are equal, a subversion without any<tr><td><a name="l1105" href="#l1105">1105</a><td>      // qualifier is always higher than a subversion with any qualifier. Next,<tr><td><a name="l1106" href="#l1106">1106</a><td>      // the qualifiers are compared as strings.<tr><td><a name="l1107" href="#l1107">1107</a><td>      order = goog.string.compareElements_(v1CompNum, v2CompNum) ||<tr><td><a name="l1108" href="#l1108">1108</a><td>          goog.string.compareElements_(v1Comp[2].length == 0,<tr><td><a name="l1109" href="#l1109">1109</a><td>              v2Comp[2].length == 0) ||<tr><td><a name="l1110" href="#l1110">1110</a><td>          goog.string.compareElements_(v1Comp[2], v2Comp[2]);<tr><td><a name="l1111" href="#l1111">1111</a><td>      // Stop as soon as an inequality is discovered.<tr><td><a name="l1112" href="#l1112">1112</a><td>    } while (order == 0);<tr><td><a name="l1113" href="#l1113">1113</a><td>  }<tr><td><a name="l1114" href="#l1114">1114</a><td><tr><td><a name="l1115" href="#l1115">1115</a><td>  return order;<tr><td><a name="l1116" href="#l1116">1116</a><td>};<tr><td><a name="l1117" href="#l1117">1117</a><td><tr><td><a name="l1118" href="#l1118">1118</a><td><tr><td><a name="l1119" href="#l1119">1119</a><td>/**<tr><td><a name="l1120" href="#l1120">1120</a><td> * Compares elements of a version number.<tr><td><a name="l1121" href="#l1121">1121</a><td> *<tr><td><a name="l1122" href="#l1122">1122</a><td> * @param {string|number|boolean} left An element from a version number.<tr><td><a name="l1123" href="#l1123">1123</a><td> * @param {string|number|boolean} right An element from a version number.<tr><td><a name="l1124" href="#l1124">1124</a><td> *<tr><td><a name="l1125" href="#l1125">1125</a><td> * @return {number}  1 if {@code left} is higher.<tr><td><a name="l1126" href="#l1126">1126</a><td> *                   0 if arguments are equal.<tr><td><a name="l1127" href="#l1127">1127</a><td> *                  -1 if {@code right} is higher.<tr><td><a name="l1128" href="#l1128">1128</a><td> * @private<tr><td><a name="l1129" href="#l1129">1129</a><td> */<tr><td><a name="l1130" href="#l1130">1130</a><td>goog.string.compareElements_ = function(left, right) {<tr><td><a name="l1131" href="#l1131">1131</a><td>  if (left &lt; right) {<tr><td><a name="l1132" href="#l1132">1132</a><td>    return -1;<tr><td><a name="l1133" href="#l1133">1133</a><td>  } else if (left &gt; right) {<tr><td><a name="l1134" href="#l1134">1134</a><td>    return 1;<tr><td><a name="l1135" href="#l1135">1135</a><td>  }<tr><td><a name="l1136" href="#l1136">1136</a><td>  return 0;<tr><td><a name="l1137" href="#l1137">1137</a><td>};<tr><td><a name="l1138" href="#l1138">1138</a><td><tr><td><a name="l1139" href="#l1139">1139</a><td><tr><td><a name="l1140" href="#l1140">1140</a><td>/**<tr><td><a name="l1141" href="#l1141">1141</a><td> * Maximum value of #goog.string.hashCode, exclusive. 2^32.<tr><td><a name="l1142" href="#l1142">1142</a><td> * @type {number}<tr><td><a name="l1143" href="#l1143">1143</a><td> * @private<tr><td><a name="l1144" href="#l1144">1144</a><td> */<tr><td><a name="l1145" href="#l1145">1145</a><td>goog.string.HASHCODE_MAX_ = 0x100000000;<tr><td><a name="l1146" href="#l1146">1146</a><td><tr><td><a name="l1147" href="#l1147">1147</a><td><tr><td><a name="l1148" href="#l1148">1148</a><td>/**<tr><td><a name="l1149" href="#l1149">1149</a><td> * String hash function similar to java.lang.String.hashCode().<tr><td><a name="l1150" href="#l1150">1150</a><td> * The hash code for a string is computed as<tr><td><a name="l1151" href="#l1151">1151</a><td> * s[0] * 31 ^ (n - 1) + s[1] * 31 ^ (n - 2) + ... + s[n - 1],<tr><td><a name="l1152" href="#l1152">1152</a><td> * where s[i] is the ith character of the string and n is the length of<tr><td><a name="l1153" href="#l1153">1153</a><td> * the string. We mod the result to make it between 0 (inclusive) and 2^32<tr><td><a name="l1154" href="#l1154">1154</a><td> * (exclusive).<tr><td><a name="l1155" href="#l1155">1155</a><td> * @param {string} str A string.<tr><td><a name="l1156" href="#l1156">1156</a><td> * @return {number} Hash value for {@code str}, between 0 (inclusive) and 2^32<tr><td><a name="l1157" href="#l1157">1157</a><td> *  (exclusive). The empty string returns 0.<tr><td><a name="l1158" href="#l1158">1158</a><td> */<tr><td><a name="l1159" href="#l1159">1159</a><td>goog.string.hashCode = function(str) {<tr><td><a name="l1160" href="#l1160">1160</a><td>  var result = 0;<tr><td><a name="l1161" href="#l1161">1161</a><td>  for (var i = 0; i &lt; str.length; ++i) {<tr><td><a name="l1162" href="#l1162">1162</a><td>    result = 31 * result + str.charCodeAt(i);<tr><td><a name="l1163" href="#l1163">1163</a><td>    // Normalize to 4 byte range, 0 ... 2^32.<tr><td><a name="l1164" href="#l1164">1164</a><td>    result %= goog.string.HASHCODE_MAX_;<tr><td><a name="l1165" href="#l1165">1165</a><td>  }<tr><td><a name="l1166" href="#l1166">1166</a><td>  return result;<tr><td><a name="l1167" href="#l1167">1167</a><td>};<tr><td><a name="l1168" href="#l1168">1168</a><td><tr><td><a name="l1169" href="#l1169">1169</a><td><tr><td><a name="l1170" href="#l1170">1170</a><td>/**<tr><td><a name="l1171" href="#l1171">1171</a><td> * The most recent unique ID. |0 is equivalent to Math.floor in this case.<tr><td><a name="l1172" href="#l1172">1172</a><td> * @type {number}<tr><td><a name="l1173" href="#l1173">1173</a><td> * @private<tr><td><a name="l1174" href="#l1174">1174</a><td> */<tr><td><a name="l1175" href="#l1175">1175</a><td>goog.string.uniqueStringCounter_ = Math.random() * 0x80000000 | 0;<tr><td><a name="l1176" href="#l1176">1176</a><td><tr><td><a name="l1177" href="#l1177">1177</a><td><tr><td><a name="l1178" href="#l1178">1178</a><td>/**<tr><td><a name="l1179" href="#l1179">1179</a><td> * Generates and returns a string which is unique in the current document.<tr><td><a name="l1180" href="#l1180">1180</a><td> * This is useful, for example, to create unique IDs for DOM elements.<tr><td><a name="l1181" href="#l1181">1181</a><td> * @return {string} A unique id.<tr><td><a name="l1182" href="#l1182">1182</a><td> */<tr><td><a name="l1183" href="#l1183">1183</a><td>goog.string.createUniqueString = function() {<tr><td><a name="l1184" href="#l1184">1184</a><td>  return &#39;goog_&#39; + goog.string.uniqueStringCounter_++;<tr><td><a name="l1185" href="#l1185">1185</a><td>};<tr><td><a name="l1186" href="#l1186">1186</a><td><tr><td><a name="l1187" href="#l1187">1187</a><td><tr><td><a name="l1188" href="#l1188">1188</a><td>/**<tr><td><a name="l1189" href="#l1189">1189</a><td> * Converts the supplied string to a number, which may be Ininity or NaN.<tr><td><a name="l1190" href="#l1190">1190</a><td> * This function strips whitespace: (toNumber(&#39; 123&#39;) === 123)<tr><td><a name="l1191" href="#l1191">1191</a><td> * This function accepts scientific notation: (toNumber(&#39;1e1&#39;) === 10)<tr><td><a name="l1192" href="#l1192">1192</a><td> *<tr><td><a name="l1193" href="#l1193">1193</a><td> * This is better than Javascript&#39;s built-in conversions because, sadly:<tr><td><a name="l1194" href="#l1194">1194</a><td> *     (Number(&#39; &#39;) === 0) and (parseFloat(&#39;123a&#39;) === 123)<tr><td><a name="l1195" href="#l1195">1195</a><td> *<tr><td><a name="l1196" href="#l1196">1196</a><td> * @param {string} str The string to convert.<tr><td><a name="l1197" href="#l1197">1197</a><td> * @return {number} The number the supplied string represents, or NaN.<tr><td><a name="l1198" href="#l1198">1198</a><td> */<tr><td><a name="l1199" href="#l1199">1199</a><td>goog.string.toNumber = function(str) {<tr><td><a name="l1200" href="#l1200">1200</a><td>  var num = Number(str);<tr><td><a name="l1201" href="#l1201">1201</a><td>  if (num == 0 &amp;&amp; goog.string.isEmpty(str)) {<tr><td><a name="l1202" href="#l1202">1202</a><td>    return NaN;<tr><td><a name="l1203" href="#l1203">1203</a><td>  }<tr><td><a name="l1204" href="#l1204">1204</a><td>  return num;<tr><td><a name="l1205" href="#l1205">1205</a><td>};<tr><td><a name="l1206" href="#l1206">1206</a><td><tr><td><a name="l1207" href="#l1207">1207</a><td><tr><td><a name="l1208" href="#l1208">1208</a><td>/**<tr><td><a name="l1209" href="#l1209">1209</a><td> * Returns whether the given string is lower camel case (e.g. &quot;isFooBar&quot;).<tr><td><a name="l1210" href="#l1210">1210</a><td> *<tr><td><a name="l1211" href="#l1211">1211</a><td> * Note that this assumes the string is entirely letters.<tr><td><a name="l1212" href="#l1212">1212</a><td> * @see http://en.wikipedia.org/wiki/CamelCase#Variations_and_synonyms<tr><td><a name="l1213" href="#l1213">1213</a><td> *<tr><td><a name="l1214" href="#l1214">1214</a><td> * @param {string} str String to test.<tr><td><a name="l1215" href="#l1215">1215</a><td> * @return {boolean} Whether the string is lower camel case.<tr><td><a name="l1216" href="#l1216">1216</a><td> */<tr><td><a name="l1217" href="#l1217">1217</a><td>goog.string.isLowerCamelCase = function(str) {<tr><td><a name="l1218" href="#l1218">1218</a><td>  return /^[a-z]+([A-Z][a-z]*)*$/.test(str);<tr><td><a name="l1219" href="#l1219">1219</a><td>};<tr><td><a name="l1220" href="#l1220">1220</a><td><tr><td><a name="l1221" href="#l1221">1221</a><td><tr><td><a name="l1222" href="#l1222">1222</a><td>/**<tr><td><a name="l1223" href="#l1223">1223</a><td> * Returns whether the given string is upper camel case (e.g. &quot;FooBarBaz&quot;).<tr><td><a name="l1224" href="#l1224">1224</a><td> *<tr><td><a name="l1225" href="#l1225">1225</a><td> * Note that this assumes the string is entirely letters.<tr><td><a name="l1226" href="#l1226">1226</a><td> * @see http://en.wikipedia.org/wiki/CamelCase#Variations_and_synonyms<tr><td><a name="l1227" href="#l1227">1227</a><td> *<tr><td><a name="l1228" href="#l1228">1228</a><td> * @param {string} str String to test.<tr><td><a name="l1229" href="#l1229">1229</a><td> * @return {boolean} Whether the string is upper camel case.<tr><td><a name="l1230" href="#l1230">1230</a><td> */<tr><td><a name="l1231" href="#l1231">1231</a><td>goog.string.isUpperCamelCase = function(str) {<tr><td><a name="l1232" href="#l1232">1232</a><td>  return /^([A-Z][a-z]*)+$/.test(str);<tr><td><a name="l1233" href="#l1233">1233</a><td>};<tr><td><a name="l1234" href="#l1234">1234</a><td><tr><td><a name="l1235" href="#l1235">1235</a><td><tr><td><a name="l1236" href="#l1236">1236</a><td>/**<tr><td><a name="l1237" href="#l1237">1237</a><td> * Converts a string from selector-case to camelCase (e.g. from<tr><td><a name="l1238" href="#l1238">1238</a><td> * &quot;multi-part-string&quot; to &quot;multiPartString&quot;), useful for converting<tr><td><a name="l1239" href="#l1239">1239</a><td> * CSS selectors and HTML dataset keys to their equivalent JS properties.<tr><td><a name="l1240" href="#l1240">1240</a><td> * @param {string} str The string in selector-case form.<tr><td><a name="l1241" href="#l1241">1241</a><td> * @return {string} The string in camelCase form.<tr><td><a name="l1242" href="#l1242">1242</a><td> */<tr><td><a name="l1243" href="#l1243">1243</a><td>goog.string.toCamelCase = function(str) {<tr><td><a name="l1244" href="#l1244">1244</a><td>  return String(str).replace(/\-([a-z])/g, function(all, match) {<tr><td><a name="l1245" href="#l1245">1245</a><td>    return match.toUpperCase();<tr><td><a name="l1246" href="#l1246">1246</a><td>  });<tr><td><a name="l1247" href="#l1247">1247</a><td>};<tr><td><a name="l1248" href="#l1248">1248</a><td><tr><td><a name="l1249" href="#l1249">1249</a><td><tr><td><a name="l1250" href="#l1250">1250</a><td>/**<tr><td><a name="l1251" href="#l1251">1251</a><td> * Converts a string from camelCase to selector-case (e.g. from<tr><td><a name="l1252" href="#l1252">1252</a><td> * &quot;multiPartString&quot; to &quot;multi-part-string&quot;), useful for converting JS<tr><td><a name="l1253" href="#l1253">1253</a><td> * style and dataset properties to equivalent CSS selectors and HTML keys.<tr><td><a name="l1254" href="#l1254">1254</a><td> * @param {string} str The string in camelCase form.<tr><td><a name="l1255" href="#l1255">1255</a><td> * @return {string} The string in selector-case form.<tr><td><a name="l1256" href="#l1256">1256</a><td> */<tr><td><a name="l1257" href="#l1257">1257</a><td>goog.string.toSelectorCase = function(str) {<tr><td><a name="l1258" href="#l1258">1258</a><td>  return String(str).replace(/([A-Z])/g, &#39;-$1&#39;).toLowerCase();<tr><td><a name="l1259" href="#l1259">1259</a><td>};<tr><td><a name="l1260" href="#l1260">1260</a><td><tr><td><a name="l1261" href="#l1261">1261</a><td><tr><td><a name="l1262" href="#l1262">1262</a><td>/**<tr><td><a name="l1263" href="#l1263">1263</a><td> * Converts a string into TitleCase. First character of the string is always<tr><td><a name="l1264" href="#l1264">1264</a><td> * capitalized in addition to the first letter of every subsequent word.<tr><td><a name="l1265" href="#l1265">1265</a><td> * Words are delimited by one or more whitespaces by default. Custom delimiters<tr><td><a name="l1266" href="#l1266">1266</a><td> * can optionally be specified to replace the default, which doesn&#39;t preserve<tr><td><a name="l1267" href="#l1267">1267</a><td> * whitespace delimiters and instead must be explicitly included if needed.<tr><td><a name="l1268" href="#l1268">1268</a><td> *<tr><td><a name="l1269" href="#l1269">1269</a><td> * Default delimiter =&gt; &quot; &quot;:<tr><td><a name="l1270" href="#l1270">1270</a><td> *    goog.string.toTitleCase(&#39;oneTwoThree&#39;)    =&gt; &#39;OneTwoThree&#39;<tr><td><a name="l1271" href="#l1271">1271</a><td> *    goog.string.toTitleCase(&#39;one two three&#39;)  =&gt; &#39;One Two Three&#39;<tr><td><a name="l1272" href="#l1272">1272</a><td> *    goog.string.toTitleCase(&#39;  one   two   &#39;) =&gt; &#39;  One   Two   &#39;<tr><td><a name="l1273" href="#l1273">1273</a><td> *    goog.string.toTitleCase(&#39;one_two_three&#39;)  =&gt; &#39;One_two_three&#39;<tr><td><a name="l1274" href="#l1274">1274</a><td> *    goog.string.toTitleCase(&#39;one-two-three&#39;)  =&gt; &#39;One-two-three&#39;<tr><td><a name="l1275" href="#l1275">1275</a><td> *<tr><td><a name="l1276" href="#l1276">1276</a><td> * Custom delimiter =&gt; &quot;_-.&quot;:<tr><td><a name="l1277" href="#l1277">1277</a><td> *    goog.string.toTitleCase(&#39;oneTwoThree&#39;, &#39;_-.&#39;)       =&gt; &#39;OneTwoThree&#39;<tr><td><a name="l1278" href="#l1278">1278</a><td> *    goog.string.toTitleCase(&#39;one two three&#39;, &#39;_-.&#39;)     =&gt; &#39;One two three&#39;<tr><td><a name="l1279" href="#l1279">1279</a><td> *    goog.string.toTitleCase(&#39;  one   two   &#39;, &#39;_-.&#39;)    =&gt; &#39;  one   two   &#39;<tr><td><a name="l1280" href="#l1280">1280</a><td> *    goog.string.toTitleCase(&#39;one_two_three&#39;, &#39;_-.&#39;)     =&gt; &#39;One_Two_Three&#39;<tr><td><a name="l1281" href="#l1281">1281</a><td> *    goog.string.toTitleCase(&#39;one-two-three&#39;, &#39;_-.&#39;)     =&gt; &#39;One-Two-Three&#39;<tr><td><a name="l1282" href="#l1282">1282</a><td> *    goog.string.toTitleCase(&#39;one...two...three&#39;, &#39;_-.&#39;) =&gt; &#39;One...Two...Three&#39;<tr><td><a name="l1283" href="#l1283">1283</a><td> *    goog.string.toTitleCase(&#39;one. two. three&#39;, &#39;_-.&#39;)   =&gt; &#39;One. two. three&#39;<tr><td><a name="l1284" href="#l1284">1284</a><td> *    goog.string.toTitleCase(&#39;one-two.three&#39;, &#39;_-.&#39;)     =&gt; &#39;One-Two.Three&#39;<tr><td><a name="l1285" href="#l1285">1285</a><td> *<tr><td><a name="l1286" href="#l1286">1286</a><td> * @param {string} str String value in camelCase form.<tr><td><a name="l1287" href="#l1287">1287</a><td> * @param {string=} opt_delimiters Custom delimiter character set used to<tr><td><a name="l1288" href="#l1288">1288</a><td> *      distinguish words in the string value. Each character represents a<tr><td><a name="l1289" href="#l1289">1289</a><td> *      single delimiter. When provided, default whitespace delimiter is<tr><td><a name="l1290" href="#l1290">1290</a><td> *      overridden and must be explicitly included if needed.<tr><td><a name="l1291" href="#l1291">1291</a><td> * @return {string} String value in TitleCase form.<tr><td><a name="l1292" href="#l1292">1292</a><td> */<tr><td><a name="l1293" href="#l1293">1293</a><td>goog.string.toTitleCase = function(str, opt_delimiters) {<tr><td><a name="l1294" href="#l1294">1294</a><td>  var delimiters = goog.isString(opt_delimiters) ?<tr><td><a name="l1295" href="#l1295">1295</a><td>      goog.string.regExpEscape(opt_delimiters) : &#39;\\s&#39;;<tr><td><a name="l1296" href="#l1296">1296</a><td><tr><td><a name="l1297" href="#l1297">1297</a><td>  // For IE8, we need to prevent using an empty character set. Otherwise,<tr><td><a name="l1298" href="#l1298">1298</a><td>  // incorrect matching will occur.<tr><td><a name="l1299" href="#l1299">1299</a><td>  delimiters = delimiters ? &#39;|[&#39; + delimiters + &#39;]+&#39; : &#39;&#39;;<tr><td><a name="l1300" href="#l1300">1300</a><td><tr><td><a name="l1301" href="#l1301">1301</a><td>  var regexp = new RegExp(&#39;(^&#39; + delimiters + &#39;)([a-z])&#39;, &#39;g&#39;);<tr><td><a name="l1302" href="#l1302">1302</a><td>  return str.replace(regexp, function(all, p1, p2) {<tr><td><a name="l1303" href="#l1303">1303</a><td>    return p1 + p2.toUpperCase();<tr><td><a name="l1304" href="#l1304">1304</a><td>  });<tr><td><a name="l1305" href="#l1305">1305</a><td>};<tr><td><a name="l1306" href="#l1306">1306</a><td><tr><td><a name="l1307" href="#l1307">1307</a><td><tr><td><a name="l1308" href="#l1308">1308</a><td>/**<tr><td><a name="l1309" href="#l1309">1309</a><td> * Parse a string in decimal or hexidecimal (&#39;0xFFFF&#39;) form.<tr><td><a name="l1310" href="#l1310">1310</a><td> *<tr><td><a name="l1311" href="#l1311">1311</a><td> * To parse a particular radix, please use parseInt(string, radix) directly. See<tr><td><a name="l1312" href="#l1312">1312</a><td> * https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/parseInt<tr><td><a name="l1313" href="#l1313">1313</a><td> *<tr><td><a name="l1314" href="#l1314">1314</a><td> * This is a wrapper for the built-in parseInt function that will only parse<tr><td><a name="l1315" href="#l1315">1315</a><td> * numbers as base 10 or base 16.  Some JS implementations assume strings<tr><td><a name="l1316" href="#l1316">1316</a><td> * starting with &quot;0&quot; are intended to be octal. ES3 allowed but discouraged<tr><td><a name="l1317" href="#l1317">1317</a><td> * this behavior. ES5 forbids it.  This function emulates the ES5 behavior.<tr><td><a name="l1318" href="#l1318">1318</a><td> *<tr><td><a name="l1319" href="#l1319">1319</a><td> * For more information, see Mozilla JS Reference: http://goo.gl/8RiFj<tr><td><a name="l1320" href="#l1320">1320</a><td> *<tr><td><a name="l1321" href="#l1321">1321</a><td> * @param {string|number|null|undefined} value The value to be parsed.<tr><td><a name="l1322" href="#l1322">1322</a><td> * @return {number} The number, parsed. If the string failed to parse, this<tr><td><a name="l1323" href="#l1323">1323</a><td> *     will be NaN.<tr><td><a name="l1324" href="#l1324">1324</a><td> */<tr><td><a name="l1325" href="#l1325">1325</a><td>goog.string.parseInt = function(value) {<tr><td><a name="l1326" href="#l1326">1326</a><td>  // Force finite numbers to strings.<tr><td><a name="l1327" href="#l1327">1327</a><td>  if (isFinite(value)) {<tr><td><a name="l1328" href="#l1328">1328</a><td>    value = String(value);<tr><td><a name="l1329" href="#l1329">1329</a><td>  }<tr><td><a name="l1330" href="#l1330">1330</a><td><tr><td><a name="l1331" href="#l1331">1331</a><td>  if (goog.isString(value)) {<tr><td><a name="l1332" href="#l1332">1332</a><td>    // If the string starts with &#39;0x&#39; or &#39;-0x&#39;, parse as hex.<tr><td><a name="l1333" href="#l1333">1333</a><td>    return /^\s*-?0x/i.test(value) ?<tr><td><a name="l1334" href="#l1334">1334</a><td>        parseInt(value, 16) : parseInt(value, 10);<tr><td><a name="l1335" href="#l1335">1335</a><td>  }<tr><td><a name="l1336" href="#l1336">1336</a><td><tr><td><a name="l1337" href="#l1337">1337</a><td>  return NaN;<tr><td><a name="l1338" href="#l1338">1338</a><td>};<tr><td><a name="l1339" href="#l1339">1339</a><td><tr><td><a name="l1340" href="#l1340">1340</a><td><tr><td><a name="l1341" href="#l1341">1341</a><td>/**<tr><td><a name="l1342" href="#l1342">1342</a><td> * Splits a string on a separator a limited number of times.<tr><td><a name="l1343" href="#l1343">1343</a><td> *<tr><td><a name="l1344" href="#l1344">1344</a><td> * This implementation is more similar to Python or Java, where the limit<tr><td><a name="l1345" href="#l1345">1345</a><td> * parameter specifies the maximum number of splits rather than truncating<tr><td><a name="l1346" href="#l1346">1346</a><td> * the number of results.<tr><td><a name="l1347" href="#l1347">1347</a><td> *<tr><td><a name="l1348" href="#l1348">1348</a><td> * See http://docs.python.org/2/library/stdtypes.html#str.split<tr><td><a name="l1349" href="#l1349">1349</a><td> * See JavaDoc: http://goo.gl/F2AsY<tr><td><a name="l1350" href="#l1350">1350</a><td> * See Mozilla reference: http://goo.gl/dZdZs<tr><td><a name="l1351" href="#l1351">1351</a><td> *<tr><td><a name="l1352" href="#l1352">1352</a><td> * @param {string} str String to split.<tr><td><a name="l1353" href="#l1353">1353</a><td> * @param {string} separator The separator.<tr><td><a name="l1354" href="#l1354">1354</a><td> * @param {number} limit The limit to the number of splits. The resulting array<tr><td><a name="l1355" href="#l1355">1355</a><td> *     will have a maximum length of limit+1.  Negative numbers are the same<tr><td><a name="l1356" href="#l1356">1356</a><td> *     as zero.<tr><td><a name="l1357" href="#l1357">1357</a><td> * @return {!Array.&lt;string&gt;} The string, split.<tr><td><a name="l1358" href="#l1358">1358</a><td> */<tr><td><a name="l1359" href="#l1359">1359</a><td><tr><td><a name="l1360" href="#l1360">1360</a><td>goog.string.splitLimit = function(str, separator, limit) {<tr><td><a name="l1361" href="#l1361">1361</a><td>  var parts = str.split(separator);<tr><td><a name="l1362" href="#l1362">1362</a><td>  var returnVal = [];<tr><td><a name="l1363" href="#l1363">1363</a><td><tr><td><a name="l1364" href="#l1364">1364</a><td>  // Only continue doing this while we haven&#39;t hit the limit and we have<tr><td><a name="l1365" href="#l1365">1365</a><td>  // parts left.<tr><td><a name="l1366" href="#l1366">1366</a><td>  while (limit &gt; 0 &amp;&amp; parts.length) {<tr><td><a name="l1367" href="#l1367">1367</a><td>    returnVal.push(parts.shift());<tr><td><a name="l1368" href="#l1368">1368</a><td>    limit--;<tr><td><a name="l1369" href="#l1369">1369</a><td>  }<tr><td><a name="l1370" href="#l1370">1370</a><td><tr><td><a name="l1371" href="#l1371">1371</a><td>  // If there are remaining parts, append them to the end.<tr><td><a name="l1372" href="#l1372">1372</a><td>  if (parts.length) {<tr><td><a name="l1373" href="#l1373">1373</a><td>    returnVal.push(parts.join(separator));<tr><td><a name="l1374" href="#l1374">1374</a><td>  }<tr><td><a name="l1375" href="#l1375">1375</a><td><tr><td><a name="l1376" href="#l1376">1376</a><td>  return returnVal;<tr><td><a name="l1377" href="#l1377">1377</a><td>};<tr><td><a name="l1378" href="#l1378">1378</a><td></table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>string.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/string/string.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities for string manipulation.<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><tr><td><a id="l21"></a><a href="#l21">21</a><td>/**<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Namespace for string utilities<tr><td><a id="l23"></a><a href="#l23">23</a><td> */<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.string&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.string.Unicode&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @define {boolean} Enables HTML escaping of lowercase letter &quot;e&quot; which helps<tr><td><a id="l30"></a><a href="#l30">30</a><td> * with detection of double-escaping as this letter is frequently used.<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.define(&#39;goog.string.DETECT_DOUBLE_ESCAPING&#39;, false);<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> * @define {boolean} Whether to force non-dom html unescaping.<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.define(&#39;goog.string.FORCE_NON_DOM_HTML_UNESCAPING&#39;, false);<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> * Common Unicode string characters.<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @enum {string}<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.string.Unicode = {<tr><td><a id="l46"></a><a href="#l46">46</a><td>  NBSP: &#39;\xa0&#39;<tr><td><a id="l47"></a><a href="#l47">47</a><td>};<tr><td><a id="l48"></a><a href="#l48">48</a><td><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> * Fast prefix-checker.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @param {string} str The string to check.<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @param {string} prefix A string to look for at the start of {@code str}.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @return {boolean} True if {@code str} begins with {@code prefix}.<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.string.startsWith = function(str, prefix) {<tr><td><a id="l57"></a><a href="#l57">57</a><td>  return str.lastIndexOf(prefix, 0) == 0;<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>/**<tr><td><a id="l62"></a><a href="#l62">62</a><td> * Fast suffix-checker.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {string} str The string to check.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @param {string} suffix A string to look for at the end of {@code str}.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @return {boolean} True if {@code str} ends with {@code suffix}.<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.string.endsWith = function(str, suffix) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  var l = str.length - suffix.length;<tr><td><a id="l69"></a><a href="#l69">69</a><td>  return l &gt;= 0 &amp;&amp; str.indexOf(suffix, l) == l;<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> * Case-insensitive prefix-checker.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {string} str The string to check.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @param {string} prefix  A string to look for at the end of {@code str}.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @return {boolean} True if {@code str} begins with {@code prefix} (ignoring<tr><td><a id="l78"></a><a href="#l78">78</a><td> *     case).<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.string.caseInsensitiveStartsWith = function(str, prefix) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>  return goog.string.caseInsensitiveCompare(<tr><td><a id="l82"></a><a href="#l82">82</a><td>      prefix, str.substr(0, prefix.length)) == 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><tr><td><a id="l86"></a><a href="#l86">86</a><td>/**<tr><td><a id="l87"></a><a href="#l87">87</a><td> * Case-insensitive suffix-checker.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {string} str The string to check.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @param {string} suffix A string to look for at the end of {@code str}.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @return {boolean} True if {@code str} ends with {@code suffix} (ignoring<tr><td><a id="l91"></a><a href="#l91">91</a><td> *     case).<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.string.caseInsensitiveEndsWith = function(str, suffix) {<tr><td><a id="l94"></a><a href="#l94">94</a><td>  return goog.string.caseInsensitiveCompare(<tr><td><a id="l95"></a><a href="#l95">95</a><td>      suffix, str.substr(str.length - suffix.length, suffix.length)) == 0;<tr><td><a id="l96"></a><a href="#l96">96</a><td>};<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td>/**<tr><td><a id="l100"></a><a href="#l100">100</a><td> * Case-insensitive equality checker.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @param {string} str1 First string to check.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @param {string} str2 Second string to check.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @return {boolean} True if {@code str1} and {@code str2} are the same string,<tr><td><a id="l104"></a><a href="#l104">104</a><td> *     ignoring case.<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.string.caseInsensitiveEquals = function(str1, str2) {<tr><td><a id="l107"></a><a href="#l107">107</a><td>  return str1.toLowerCase() == str2.toLowerCase();<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>/**<tr><td><a id="l112"></a><a href="#l112">112</a><td> * Does simple python-style string substitution.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * subs(&quot;foo%s hot%s&quot;, &quot;bar&quot;, &quot;dog&quot;) becomes &quot;foobar hotdog&quot;.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @param {string} str The string containing the pattern.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {...*} var_args The items to substitute into the pattern.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @return {string} A copy of {@code str} in which each occurrence of<tr><td><a id="l117"></a><a href="#l117">117</a><td> *     {@code %s} has been replaced an argument from {@code var_args}.<tr><td><a id="l118"></a><a href="#l118">118</a><td> */<tr><td><a id="l119"></a><a href="#l119">119</a><td>goog.string.subs = function(str, var_args) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>  var splitParts = str.split(&#39;%s&#39;);<tr><td><a id="l121"></a><a href="#l121">121</a><td>  var returnString = &#39;&#39;;<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>  var subsArguments = Array.prototype.slice.call(arguments, 1);<tr><td><a id="l124"></a><a href="#l124">124</a><td>  while (subsArguments.length &amp;&amp;<tr><td><a id="l125"></a><a href="#l125">125</a><td>         // Replace up to the last split part. We are inserting in the<tr><td><a id="l126"></a><a href="#l126">126</a><td>         // positions between split parts.<tr><td><a id="l127"></a><a href="#l127">127</a><td>         splitParts.length &gt; 1) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>    returnString += splitParts.shift() + subsArguments.shift();<tr><td><a id="l129"></a><a href="#l129">129</a><td>  }<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>  return returnString + splitParts.join(&#39;%s&#39;); // Join unused &#39;%s&#39;<tr><td><a id="l132"></a><a href="#l132">132</a><td>};<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td><tr><td><a id="l135"></a><a href="#l135">135</a><td>/**<tr><td><a id="l136"></a><a href="#l136">136</a><td> * Converts multiple whitespace chars (spaces, non-breaking-spaces, new lines<tr><td><a id="l137"></a><a href="#l137">137</a><td> * and tabs) to a single space, and strips leading and trailing whitespace.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @param {string} str Input string.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @return {string} A copy of {@code str} with collapsed whitespace.<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.string.collapseWhitespace = function(str) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a id="l143"></a><a href="#l143">143</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a id="l144"></a><a href="#l144">144</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a id="l145"></a><a href="#l145">145</a><td>  return str.replace(/[\s\xa0]+/g, &#39; &#39;).replace(/^\s+|\s+$/g, &#39;&#39;);<tr><td><a id="l146"></a><a href="#l146">146</a><td>};<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>/**<tr><td><a id="l150"></a><a href="#l150">150</a><td> * Checks if a string is empty or contains only whitespaces.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {string} str The string to check.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @return {boolean} Whether {@code str} is empty or whitespace only.<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td>goog.string.isEmptyOrWhitespace = function(str) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>  // testing length == 0 first is actually slower in all browsers (about the<tr><td><a id="l156"></a><a href="#l156">156</a><td>  // same in Opera).<tr><td><a id="l157"></a><a href="#l157">157</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a id="l158"></a><a href="#l158">158</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a id="l159"></a><a href="#l159">159</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a id="l160"></a><a href="#l160">160</a><td>  return /^[\s\xa0]*$/.test(str);<tr><td><a id="l161"></a><a href="#l161">161</a><td>};<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>/**<tr><td><a id="l165"></a><a href="#l165">165</a><td> * Checks if a string is empty.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {string} str The string to check.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @return {boolean} Whether {@code str} is empty.<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>goog.string.isEmptyString = function(str) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>  return str.length == 0;<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><tr><td><a id="l174"></a><a href="#l174">174</a><td>/**<tr><td><a id="l175"></a><a href="#l175">175</a><td> * Checks if a string is empty or contains only whitespaces.<tr><td><a id="l176"></a><a href="#l176">176</a><td> *<tr><td><a id="l177"></a><a href="#l177">177</a><td> * TODO(user): Deprecate this when clients have been switched over to<tr><td><a id="l178"></a><a href="#l178">178</a><td> * goog.string.isEmptyOrWhitespace.<tr><td><a id="l179"></a><a href="#l179">179</a><td> *<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {string} str The string to check.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @return {boolean} Whether {@code str} is empty or whitespace only.<tr><td><a id="l182"></a><a href="#l182">182</a><td> */<tr><td><a id="l183"></a><a href="#l183">183</a><td>goog.string.isEmpty = goog.string.isEmptyOrWhitespace;<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> * Checks if a string is null, undefined, empty or contains only whitespaces.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @param {*} str The string to check.<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @return {boolean} Whether {@code str} is null, undefined, empty, or<tr><td><a id="l190"></a><a href="#l190">190</a><td> *     whitespace only.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @deprecated Use goog.string.isEmptyOrWhitespace(goog.string.makeSafe(str))<tr><td><a id="l192"></a><a href="#l192">192</a><td> *     instead.<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>goog.string.isEmptyOrWhitespaceSafe = function(str) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>  return goog.string.isEmptyOrWhitespace(goog.string.makeSafe(str));<tr><td><a id="l196"></a><a href="#l196">196</a><td>};<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>/**<tr><td><a id="l200"></a><a href="#l200">200</a><td> * Checks if a string is null, undefined, empty or contains only whitespaces.<tr><td><a id="l201"></a><a href="#l201">201</a><td> *<tr><td><a id="l202"></a><a href="#l202">202</a><td> * TODO(user): Deprecate this when clients have been switched over to<tr><td><a id="l203"></a><a href="#l203">203</a><td> * goog.string.isEmptyOrWhitespaceSafe.<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 {*} str The string to check.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {boolean} Whether {@code str} is null, undefined, empty, or<tr><td><a id="l207"></a><a href="#l207">207</a><td> *     whitespace only.<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.string.isEmptySafe = goog.string.isEmptyOrWhitespaceSafe;<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> * Checks if a string is all breaking whitespace.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @param {string} str The string to check.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @return {boolean} Whether the string is all breaking whitespace.<tr><td><a id="l216"></a><a href="#l216">216</a><td> */<tr><td><a id="l217"></a><a href="#l217">217</a><td>goog.string.isBreakingWhitespace = function(str) {<tr><td><a id="l218"></a><a href="#l218">218</a><td>  return !/[^\t\n\r ]/.test(str);<tr><td><a id="l219"></a><a href="#l219">219</a><td>};<tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td>/**<tr><td><a id="l223"></a><a href="#l223">223</a><td> * Checks if a string contains all letters.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @param {string} str string to check.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @return {boolean} True if {@code str} consists entirely of letters.<tr><td><a id="l226"></a><a href="#l226">226</a><td> */<tr><td><a id="l227"></a><a href="#l227">227</a><td>goog.string.isAlpha = function(str) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>  return !/[^a-zA-Z]/.test(str);<tr><td><a id="l229"></a><a href="#l229">229</a><td>};<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td>/**<tr><td><a id="l233"></a><a href="#l233">233</a><td> * Checks if a string contains only numbers.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @param {*} str string to check. If not a string, it will be<tr><td><a id="l235"></a><a href="#l235">235</a><td> *     casted to one.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @return {boolean} True if {@code str} is numeric.<tr><td><a id="l237"></a><a href="#l237">237</a><td> */<tr><td><a id="l238"></a><a href="#l238">238</a><td>goog.string.isNumeric = function(str) {<tr><td><a id="l239"></a><a href="#l239">239</a><td>  return !/[^0-9]/.test(str);<tr><td><a id="l240"></a><a href="#l240">240</a><td>};<tr><td><a id="l241"></a><a href="#l241">241</a><td><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> * Checks if a string contains only numbers or letters.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {string} str string to check.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @return {boolean} True if {@code str} is alphanumeric.<tr><td><a id="l247"></a><a href="#l247">247</a><td> */<tr><td><a id="l248"></a><a href="#l248">248</a><td>goog.string.isAlphaNumeric = function(str) {<tr><td><a id="l249"></a><a href="#l249">249</a><td>  return !/[^a-zA-Z0-9]/.test(str);<tr><td><a id="l250"></a><a href="#l250">250</a><td>};<tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td>/**<tr><td><a id="l254"></a><a href="#l254">254</a><td> * Checks if a character is a space character.<tr><td><a id="l255"></a><a href="#l255">255</a><td> * @param {string} ch Character to check.<tr><td><a id="l256"></a><a href="#l256">256</a><td> * @return {boolean} True if {@code ch} is a space.<tr><td><a id="l257"></a><a href="#l257">257</a><td> */<tr><td><a id="l258"></a><a href="#l258">258</a><td>goog.string.isSpace = function(ch) {<tr><td><a id="l259"></a><a href="#l259">259</a><td>  return ch == &#39; &#39;;<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> * Checks if a character is a valid unicode character.<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @param {string} ch Character to check.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @return {boolean} True if {@code ch} is a valid unicode character.<tr><td><a id="l267"></a><a href="#l267">267</a><td> */<tr><td><a id="l268"></a><a href="#l268">268</a><td>goog.string.isUnicodeChar = function(ch) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>  return ch.length == 1 &amp;&amp; ch &gt;= &#39; &#39; &amp;&amp; ch &lt;= &#39;~&#39; ||<tr><td><a id="l270"></a><a href="#l270">270</a><td>         ch &gt;= &#39;\u0080&#39; &amp;&amp; ch &lt;= &#39;\uFFFD&#39;;<tr><td><a id="l271"></a><a href="#l271">271</a><td>};<tr><td><a id="l272"></a><a href="#l272">272</a><td><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> * Takes a string and replaces newlines with a space. Multiple lines are<tr><td><a id="l276"></a><a href="#l276">276</a><td> * replaced with a single space.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {string} str The string from which to strip newlines.<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @return {string} A copy of {@code str} stripped of newlines.<tr><td><a id="l279"></a><a href="#l279">279</a><td> */<tr><td><a id="l280"></a><a href="#l280">280</a><td>goog.string.stripNewlines = function(str) {<tr><td><a id="l281"></a><a href="#l281">281</a><td>  return str.replace(/(\r\n|\r|\n)+/g, &#39; &#39;);<tr><td><a id="l282"></a><a href="#l282">282</a><td>};<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td>/**<tr><td><a id="l286"></a><a href="#l286">286</a><td> * Replaces Windows and Mac new lines with unix style: \r or \r\n with \n.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @param {string} str The string to in which to canonicalize newlines.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @return {string} {@code str} A copy of {@code} with canonicalized newlines.<tr><td><a id="l289"></a><a href="#l289">289</a><td> */<tr><td><a id="l290"></a><a href="#l290">290</a><td>goog.string.canonicalizeNewlines = function(str) {<tr><td><a id="l291"></a><a href="#l291">291</a><td>  return str.replace(/(\r\n|\r|\n)/g, &#39;\n&#39;);<tr><td><a id="l292"></a><a href="#l292">292</a><td>};<tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>/**<tr><td><a id="l296"></a><a href="#l296">296</a><td> * Normalizes whitespace in a string, replacing all whitespace chars with<tr><td><a id="l297"></a><a href="#l297">297</a><td> * a space.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @param {string} str The string in which to normalize whitespace.<tr><td><a id="l299"></a><a href="#l299">299</a><td> * @return {string} A copy of {@code str} with all whitespace normalized.<tr><td><a id="l300"></a><a href="#l300">300</a><td> */<tr><td><a id="l301"></a><a href="#l301">301</a><td>goog.string.normalizeWhitespace = function(str) {<tr><td><a id="l302"></a><a href="#l302">302</a><td>  return str.replace(/\xa0|\s/g, &#39; &#39;);<tr><td><a id="l303"></a><a href="#l303">303</a><td>};<tr><td><a id="l304"></a><a href="#l304">304</a><td><tr><td><a id="l305"></a><a href="#l305">305</a><td><tr><td><a id="l306"></a><a href="#l306">306</a><td>/**<tr><td><a id="l307"></a><a href="#l307">307</a><td> * Normalizes spaces in a string, replacing all consecutive spaces and tabs<tr><td><a id="l308"></a><a href="#l308">308</a><td> * with a single space. Replaces non-breaking space with a space.<tr><td><a id="l309"></a><a href="#l309">309</a><td> * @param {string} str The string in which to normalize spaces.<tr><td><a id="l310"></a><a href="#l310">310</a><td> * @return {string} A copy of {@code str} with all consecutive spaces and tabs<tr><td><a id="l311"></a><a href="#l311">311</a><td> *    replaced with a single space.<tr><td><a id="l312"></a><a href="#l312">312</a><td> */<tr><td><a id="l313"></a><a href="#l313">313</a><td>goog.string.normalizeSpaces = function(str) {<tr><td><a id="l314"></a><a href="#l314">314</a><td>  return str.replace(/\xa0|[ \t]+/g, &#39; &#39;);<tr><td><a id="l315"></a><a href="#l315">315</a><td>};<tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td>/**<tr><td><a id="l319"></a><a href="#l319">319</a><td> * Removes the breaking spaces from the left and right of the string and<tr><td><a id="l320"></a><a href="#l320">320</a><td> * collapses the sequences of breaking spaces in the middle into single spaces.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * The original and the result strings render the same way in HTML.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {string} str A string in which to collapse spaces.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @return {string} Copy of the string with normalized breaking spaces.<tr><td><a id="l324"></a><a href="#l324">324</a><td> */<tr><td><a id="l325"></a><a href="#l325">325</a><td>goog.string.collapseBreakingSpaces = function(str) {<tr><td><a id="l326"></a><a href="#l326">326</a><td>  return str.replace(/[\t\r\n ]+/g, &#39; &#39;).replace(<tr><td><a id="l327"></a><a href="#l327">327</a><td>      /^[\t\r\n ]+|[\t\r\n ]+$/g, &#39;&#39;);<tr><td><a id="l328"></a><a href="#l328">328</a><td>};<tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td><tr><td><a id="l331"></a><a href="#l331">331</a><td>/**<tr><td><a id="l332"></a><a href="#l332">332</a><td> * Trims white spaces to the left and right of a string.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @param {string} str The string to trim.<tr><td><a id="l334"></a><a href="#l334">334</a><td> * @return {string} A trimmed copy of {@code str}.<tr><td><a id="l335"></a><a href="#l335">335</a><td> */<tr><td><a id="l336"></a><a href="#l336">336</a><td>goog.string.trim = (goog.TRUSTED_SITE &amp;&amp; String.prototype.trim) ?<tr><td><a id="l337"></a><a href="#l337">337</a><td>    function(str) {<tr><td><a id="l338"></a><a href="#l338">338</a><td>      return str.trim();<tr><td><a id="l339"></a><a href="#l339">339</a><td>    } :<tr><td><a id="l340"></a><a href="#l340">340</a><td>    function(str) {<tr><td><a id="l341"></a><a href="#l341">341</a><td>      // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s<tr><td><a id="l342"></a><a href="#l342">342</a><td>      // character class (as required by section 7.2 of the ECMAScript spec),<tr><td><a id="l343"></a><a href="#l343">343</a><td>      // we explicitly include it in the regexp to enforce consistent<tr><td><a id="l344"></a><a href="#l344">344</a><td>      // cross-browser behavior.<tr><td><a id="l345"></a><a href="#l345">345</a><td>      return str.replace(/^[\s\xa0]+|[\s\xa0]+$/g, &#39;&#39;);<tr><td><a id="l346"></a><a href="#l346">346</a><td>    };<tr><td><a id="l347"></a><a href="#l347">347</a><td><tr><td><a id="l348"></a><a href="#l348">348</a><td><tr><td><a id="l349"></a><a href="#l349">349</a><td>/**<tr><td><a id="l350"></a><a href="#l350">350</a><td> * Trims whitespaces at the left end of a string.<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @param {string} str The string to left trim.<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @return {string} A trimmed copy of {@code str}.<tr><td><a id="l353"></a><a href="#l353">353</a><td> */<tr><td><a id="l354"></a><a href="#l354">354</a><td>goog.string.trimLeft = function(str) {<tr><td><a id="l355"></a><a href="#l355">355</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a id="l356"></a><a href="#l356">356</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a id="l357"></a><a href="#l357">357</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a id="l358"></a><a href="#l358">358</a><td>  return str.replace(/^[\s\xa0]+/, &#39;&#39;);<tr><td><a id="l359"></a><a href="#l359">359</a><td>};<tr><td><a id="l360"></a><a href="#l360">360</a><td><tr><td><a id="l361"></a><a href="#l361">361</a><td><tr><td><a id="l362"></a><a href="#l362">362</a><td>/**<tr><td><a id="l363"></a><a href="#l363">363</a><td> * Trims whitespaces at the right end of a string.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @param {string} str The string to right trim.<tr><td><a id="l365"></a><a href="#l365">365</a><td> * @return {string} A trimmed copy of {@code str}.<tr><td><a id="l366"></a><a href="#l366">366</a><td> */<tr><td><a id="l367"></a><a href="#l367">367</a><td>goog.string.trimRight = function(str) {<tr><td><a id="l368"></a><a href="#l368">368</a><td>  // Since IE doesn&#39;t include non-breaking-space (0xa0) in their \s character<tr><td><a id="l369"></a><a href="#l369">369</a><td>  // class (as required by section 7.2 of the ECMAScript spec), we explicitly<tr><td><a id="l370"></a><a href="#l370">370</a><td>  // include it in the regexp to enforce consistent cross-browser behavior.<tr><td><a id="l371"></a><a href="#l371">371</a><td>  return str.replace(/[\s\xa0]+$/, &#39;&#39;);<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> * A string comparator that ignores case.<tr><td><a id="l377"></a><a href="#l377">377</a><td> * -1 = str1 less than str2<tr><td><a id="l378"></a><a href="#l378">378</a><td> *  0 = str1 equals str2<tr><td><a id="l379"></a><a href="#l379">379</a><td> *  1 = str1 greater than str2<tr><td><a id="l380"></a><a href="#l380">380</a><td> *<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @param {string} str1 The string to compare.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @param {string} str2 The string to compare {@code str1} to.<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @return {number} The comparator result, as described above.<tr><td><a id="l384"></a><a href="#l384">384</a><td> */<tr><td><a id="l385"></a><a href="#l385">385</a><td>goog.string.caseInsensitiveCompare = function(str1, str2) {<tr><td><a id="l386"></a><a href="#l386">386</a><td>  var test1 = String(str1).toLowerCase();<tr><td><a id="l387"></a><a href="#l387">387</a><td>  var test2 = String(str2).toLowerCase();<tr><td><a id="l388"></a><a href="#l388">388</a><td><tr><td><a id="l389"></a><a href="#l389">389</a><td>  if (test1 &lt; test2) {<tr><td><a id="l390"></a><a href="#l390">390</a><td>    return -1;<tr><td><a id="l391"></a><a href="#l391">391</a><td>  } else if (test1 == test2) {<tr><td><a id="l392"></a><a href="#l392">392</a><td>    return 0;<tr><td><a id="l393"></a><a href="#l393">393</a><td>  } else {<tr><td><a id="l394"></a><a href="#l394">394</a><td>    return 1;<tr><td><a id="l395"></a><a href="#l395">395</a><td>  }<tr><td><a id="l396"></a><a href="#l396">396</a><td>};<tr><td><a id="l397"></a><a href="#l397">397</a><td><tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td>/**<tr><td><a id="l400"></a><a href="#l400">400</a><td> * Compares two strings interpreting their numeric substrings as numbers.<tr><td><a id="l401"></a><a href="#l401">401</a><td> *<tr><td><a id="l402"></a><a href="#l402">402</a><td> * @param {string} str1 First string.<tr><td><a id="l403"></a><a href="#l403">403</a><td> * @param {string} str2 Second string.<tr><td><a id="l404"></a><a href="#l404">404</a><td> * @param {!RegExp} tokenizerRegExp Splits a string into substrings of<tr><td><a id="l405"></a><a href="#l405">405</a><td> *     non-negative integers, non-numeric characters and optionally fractional<tr><td><a id="l406"></a><a href="#l406">406</a><td> *     numbers starting with a decimal point.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @return {number} Negative if str1 &lt; str2, 0 is str1 == str2, positive if<tr><td><a id="l408"></a><a href="#l408">408</a><td> *     str1 &gt; str2.<tr><td><a id="l409"></a><a href="#l409">409</a><td> * @private<tr><td><a id="l410"></a><a href="#l410">410</a><td> */<tr><td><a id="l411"></a><a href="#l411">411</a><td>goog.string.numberAwareCompare_ = function(str1, str2, tokenizerRegExp) {<tr><td><a id="l412"></a><a href="#l412">412</a><td>  if (str1 == str2) {<tr><td><a id="l413"></a><a href="#l413">413</a><td>    return 0;<tr><td><a id="l414"></a><a href="#l414">414</a><td>  }<tr><td><a id="l415"></a><a href="#l415">415</a><td>  if (!str1) {<tr><td><a id="l416"></a><a href="#l416">416</a><td>    return -1;<tr><td><a id="l417"></a><a href="#l417">417</a><td>  }<tr><td><a id="l418"></a><a href="#l418">418</a><td>  if (!str2) {<tr><td><a id="l419"></a><a href="#l419">419</a><td>    return 1;<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>  // Using match to split the entire string ahead of time turns out to be faster<tr><td><a id="l423"></a><a href="#l423">423</a><td>  // for most inputs than using RegExp.exec or iterating over each character.<tr><td><a id="l424"></a><a href="#l424">424</a><td>  var tokens1 = str1.toLowerCase().match(tokenizerRegExp);<tr><td><a id="l425"></a><a href="#l425">425</a><td>  var tokens2 = str2.toLowerCase().match(tokenizerRegExp);<tr><td><a id="l426"></a><a href="#l426">426</a><td><tr><td><a id="l427"></a><a href="#l427">427</a><td>  var count = Math.min(tokens1.length, tokens2.length);<tr><td><a id="l428"></a><a href="#l428">428</a><td><tr><td><a id="l429"></a><a href="#l429">429</a><td>  for (var i = 0; i &lt; count; i++) {<tr><td><a id="l430"></a><a href="#l430">430</a><td>    var a = tokens1[i];<tr><td><a id="l431"></a><a href="#l431">431</a><td>    var b = tokens2[i];<tr><td><a id="l432"></a><a href="#l432">432</a><td><tr><td><a id="l433"></a><a href="#l433">433</a><td>    // Compare pairs of tokens, returning if one token sorts before the other.<tr><td><a id="l434"></a><a href="#l434">434</a><td>    if (a != b) {<tr><td><a id="l435"></a><a href="#l435">435</a><td>      // Only if both tokens are integers is a special comparison required.<tr><td><a id="l436"></a><a href="#l436">436</a><td>      // Decimal numbers are sorted as strings (e.g., &#39;.09&#39; &lt; &#39;.1&#39;).<tr><td><a id="l437"></a><a href="#l437">437</a><td>      var num1 = parseInt(a, 10);<tr><td><a id="l438"></a><a href="#l438">438</a><td>      if (!isNaN(num1)) {<tr><td><a id="l439"></a><a href="#l439">439</a><td>        var num2 = parseInt(b, 10);<tr><td><a id="l440"></a><a href="#l440">440</a><td>        if (!isNaN(num2) &amp;&amp; num1 - num2) {<tr><td><a id="l441"></a><a href="#l441">441</a><td>          return num1 - num2;<tr><td><a id="l442"></a><a href="#l442">442</a><td>        }<tr><td><a id="l443"></a><a href="#l443">443</a><td>      }<tr><td><a id="l444"></a><a href="#l444">444</a><td>      return a &lt; b ? -1 : 1;<tr><td><a id="l445"></a><a href="#l445">445</a><td>    }<tr><td><a id="l446"></a><a href="#l446">446</a><td>  }<tr><td><a id="l447"></a><a href="#l447">447</a><td><tr><td><a id="l448"></a><a href="#l448">448</a><td>  // If one string is a substring of the other, the shorter string sorts first.<tr><td><a id="l449"></a><a href="#l449">449</a><td>  if (tokens1.length != tokens2.length) {<tr><td><a id="l450"></a><a href="#l450">450</a><td>    return tokens1.length - tokens2.length;<tr><td><a id="l451"></a><a href="#l451">451</a><td>  }<tr><td><a id="l452"></a><a href="#l452">452</a><td><tr><td><a id="l453"></a><a href="#l453">453</a><td>  // The two strings must be equivalent except for case (perfect equality is<tr><td><a id="l454"></a><a href="#l454">454</a><td>  // tested at the head of the function.) Revert to default ASCII string<tr><td><a id="l455"></a><a href="#l455">455</a><td>  // comparison to stabilize the sort.<tr><td><a id="l456"></a><a href="#l456">456</a><td>  return str1 &lt; str2 ? -1 : 1;<tr><td><a id="l457"></a><a href="#l457">457</a><td>};<tr><td><a id="l458"></a><a href="#l458">458</a><td><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> * String comparison function that handles non-negative integer numbers in a<tr><td><a id="l462"></a><a href="#l462">462</a><td> * way humans might expect. Using this function, the string &#39;File 2.jpg&#39; sorts<tr><td><a id="l463"></a><a href="#l463">463</a><td> * before &#39;File 10.jpg&#39;, and &#39;Version 1.9&#39; before &#39;Version 1.10&#39;. The comparison<tr><td><a id="l464"></a><a href="#l464">464</a><td> * is mostly case-insensitive, though strings that are identical except for case<tr><td><a id="l465"></a><a href="#l465">465</a><td> * are sorted with the upper-case strings before lower-case.<tr><td><a id="l466"></a><a href="#l466">466</a><td> *<tr><td><a id="l467"></a><a href="#l467">467</a><td> * This comparison function is up to 50x slower than either the default or the<tr><td><a id="l468"></a><a href="#l468">468</a><td> * case-insensitive compare. It should not be used in time-critical code, but<tr><td><a id="l469"></a><a href="#l469">469</a><td> * should be fast enough to sort several hundred short strings (like filenames)<tr><td><a id="l470"></a><a href="#l470">470</a><td> * with a reasonable delay.<tr><td><a id="l471"></a><a href="#l471">471</a><td> *<tr><td><a id="l472"></a><a href="#l472">472</a><td> * @param {string} str1 The string to compare in a numerically sensitive way.<tr><td><a id="l473"></a><a href="#l473">473</a><td> * @param {string} str2 The string to compare {@code str1} to.<tr><td><a id="l474"></a><a href="#l474">474</a><td> * @return {number} less than 0 if str1 &lt; str2, 0 if str1 == str2, greater than<tr><td><a id="l475"></a><a href="#l475">475</a><td> *     0 if str1 &gt; str2.<tr><td><a id="l476"></a><a href="#l476">476</a><td> */<tr><td><a id="l477"></a><a href="#l477">477</a><td>goog.string.intAwareCompare = function(str1, str2) {<tr><td><a id="l478"></a><a href="#l478">478</a><td>  return goog.string.numberAwareCompare_(str1, str2, /\d+|\D+/g);<tr><td><a id="l479"></a><a href="#l479">479</a><td>};<tr><td><a id="l480"></a><a href="#l480">480</a><td><tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td>/**<tr><td><a id="l483"></a><a href="#l483">483</a><td> * String comparison function that handles non-negative integer and fractional<tr><td><a id="l484"></a><a href="#l484">484</a><td> * numbers in a way humans might expect. Using this function, the string<tr><td><a id="l485"></a><a href="#l485">485</a><td> * &#39;File 2.jpg&#39; sorts before &#39;File 10.jpg&#39;, and &#39;3.14&#39; before &#39;3.2&#39;. Equivalent<tr><td><a id="l486"></a><a href="#l486">486</a><td> * to {@link goog.string.intAwareCompare} apart from the way how it interprets<tr><td><a id="l487"></a><a href="#l487">487</a><td> * dots.<tr><td><a id="l488"></a><a href="#l488">488</a><td> *<tr><td><a id="l489"></a><a href="#l489">489</a><td> * @param {string} str1 The string to compare in a numerically sensitive way.<tr><td><a id="l490"></a><a href="#l490">490</a><td> * @param {string} str2 The string to compare {@code str1} to.<tr><td><a id="l491"></a><a href="#l491">491</a><td> * @return {number} less than 0 if str1 &lt; str2, 0 if str1 == str2, greater than<tr><td><a id="l492"></a><a href="#l492">492</a><td> *     0 if str1 &gt; str2.<tr><td><a id="l493"></a><a href="#l493">493</a><td> */<tr><td><a id="l494"></a><a href="#l494">494</a><td>goog.string.floatAwareCompare = function(str1, str2) {<tr><td><a id="l495"></a><a href="#l495">495</a><td>  return goog.string.numberAwareCompare_(str1, str2, /\d+|\.\d+|\D+/g);<tr><td><a id="l496"></a><a href="#l496">496</a><td>};<tr><td><a id="l497"></a><a href="#l497">497</a><td><tr><td><a id="l498"></a><a href="#l498">498</a><td><tr><td><a id="l499"></a><a href="#l499">499</a><td>/**<tr><td><a id="l500"></a><a href="#l500">500</a><td> * Alias for {@link goog.string.floatAwareCompare}.<tr><td><a id="l501"></a><a href="#l501">501</a><td> *<tr><td><a id="l502"></a><a href="#l502">502</a><td> * @param {string} str1<tr><td><a id="l503"></a><a href="#l503">503</a><td> * @param {string} str2<tr><td><a id="l504"></a><a href="#l504">504</a><td> * @return {number}<tr><td><a id="l505"></a><a href="#l505">505</a><td> */<tr><td><a id="l506"></a><a href="#l506">506</a><td>goog.string.numerateCompare = goog.string.floatAwareCompare;<tr><td><a id="l507"></a><a href="#l507">507</a><td><tr><td><a id="l508"></a><a href="#l508">508</a><td><tr><td><a id="l509"></a><a href="#l509">509</a><td>/**<tr><td><a id="l510"></a><a href="#l510">510</a><td> * URL-encodes a string<tr><td><a id="l511"></a><a href="#l511">511</a><td> * @param {*} str The string to url-encode.<tr><td><a id="l512"></a><a href="#l512">512</a><td> * @return {string} An encoded copy of {@code str} that is safe for urls.<tr><td><a id="l513"></a><a href="#l513">513</a><td> *     Note that &#39;#&#39;, &#39;:&#39;, and other characters used to delimit portions<tr><td><a id="l514"></a><a href="#l514">514</a><td> *     of URLs *will* be encoded.<tr><td><a id="l515"></a><a href="#l515">515</a><td> */<tr><td><a id="l516"></a><a href="#l516">516</a><td>goog.string.urlEncode = function(str) {<tr><td><a id="l517"></a><a href="#l517">517</a><td>  return encodeURIComponent(String(str));<tr><td><a id="l518"></a><a href="#l518">518</a><td>};<tr><td><a id="l519"></a><a href="#l519">519</a><td><tr><td><a id="l520"></a><a href="#l520">520</a><td><tr><td><a id="l521"></a><a href="#l521">521</a><td>/**<tr><td><a id="l522"></a><a href="#l522">522</a><td> * URL-decodes the string. We need to specially handle &#39;+&#39;s because<tr><td><a id="l523"></a><a href="#l523">523</a><td> * the javascript library doesn&#39;t convert them to spaces.<tr><td><a id="l524"></a><a href="#l524">524</a><td> * @param {string} str The string to url decode.<tr><td><a id="l525"></a><a href="#l525">525</a><td> * @return {string} The decoded {@code str}.<tr><td><a id="l526"></a><a href="#l526">526</a><td> */<tr><td><a id="l527"></a><a href="#l527">527</a><td>goog.string.urlDecode = function(str) {<tr><td><a id="l528"></a><a href="#l528">528</a><td>  return decodeURIComponent(str.replace(/\+/g, &#39; &#39;));<tr><td><a id="l529"></a><a href="#l529">529</a><td>};<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>/**<tr><td><a id="l533"></a><a href="#l533">533</a><td> * Converts \n to &lt;br&gt;s or &lt;br /&gt;s.<tr><td><a id="l534"></a><a href="#l534">534</a><td> * @param {string} str The string in which to convert newlines.<tr><td><a id="l535"></a><a href="#l535">535</a><td> * @param {boolean=} opt_xml Whether to use XML compatible tags.<tr><td><a id="l536"></a><a href="#l536">536</a><td> * @return {string} A copy of {@code str} with converted newlines.<tr><td><a id="l537"></a><a href="#l537">537</a><td> */<tr><td><a id="l538"></a><a href="#l538">538</a><td>goog.string.newLineToBr = function(str, opt_xml) {<tr><td><a id="l539"></a><a href="#l539">539</a><td>  return str.replace(/(\r\n|\r|\n)/g, opt_xml ? &#39;&lt;br /&gt;&#39; : &#39;&lt;br&gt;&#39;);<tr><td><a id="l540"></a><a href="#l540">540</a><td>};<tr><td><a id="l541"></a><a href="#l541">541</a><td><tr><td><a id="l542"></a><a href="#l542">542</a><td><tr><td><a id="l543"></a><a href="#l543">543</a><td>/**<tr><td><a id="l544"></a><a href="#l544">544</a><td> * Escapes double quote &#39;&quot;&#39; and single quote &#39;\&#39;&#39; characters in addition to<tr><td><a id="l545"></a><a href="#l545">545</a><td> * &#39;&amp;&#39;, &#39;&lt;&#39;, and &#39;&gt;&#39; so that a string can be included in an HTML tag attribute<tr><td><a id="l546"></a><a href="#l546">546</a><td> * value within double or single quotes.<tr><td><a id="l547"></a><a href="#l547">547</a><td> *<tr><td><a id="l548"></a><a href="#l548">548</a><td> * It should be noted that &gt; doesn&#39;t need to be escaped for the HTML or XML to<tr><td><a id="l549"></a><a href="#l549">549</a><td> * be valid, but it has been decided to escape it for consistency with other<tr><td><a id="l550"></a><a href="#l550">550</a><td> * implementations.<tr><td><a id="l551"></a><a href="#l551">551</a><td> *<tr><td><a id="l552"></a><a href="#l552">552</a><td> * With goog.string.DETECT_DOUBLE_ESCAPING, this function escapes also the<tr><td><a id="l553"></a><a href="#l553">553</a><td> * lowercase letter &quot;e&quot;.<tr><td><a id="l554"></a><a href="#l554">554</a><td> *<tr><td><a id="l555"></a><a href="#l555">555</a><td> * NOTE(user):<tr><td><a id="l556"></a><a href="#l556">556</a><td> * HtmlEscape is often called during the generation of large blocks of HTML.<tr><td><a id="l557"></a><a href="#l557">557</a><td> * Using statics for the regular expressions and strings is an optimization<tr><td><a id="l558"></a><a href="#l558">558</a><td> * that can more than half the amount of time IE spends in this function for<tr><td><a id="l559"></a><a href="#l559">559</a><td> * large apps, since strings and regexes both contribute to GC allocations.<tr><td><a id="l560"></a><a href="#l560">560</a><td> *<tr><td><a id="l561"></a><a href="#l561">561</a><td> * Testing for the presence of a character before escaping increases the number<tr><td><a id="l562"></a><a href="#l562">562</a><td> * of function calls, but actually provides a speed increase for the average<tr><td><a id="l563"></a><a href="#l563">563</a><td> * case -- since the average case often doesn&#39;t require the escaping of all 4<tr><td><a id="l564"></a><a href="#l564">564</a><td> * characters and indexOf() is much cheaper than replace().<tr><td><a id="l565"></a><a href="#l565">565</a><td> * The worst case does suffer slightly from the additional calls, therefore the<tr><td><a id="l566"></a><a href="#l566">566</a><td> * opt_isLikelyToContainHtmlChars option has been included for situations<tr><td><a id="l567"></a><a href="#l567">567</a><td> * where all 4 HTML entities are very likely to be present and need escaping.<tr><td><a id="l568"></a><a href="#l568">568</a><td> *<tr><td><a id="l569"></a><a href="#l569">569</a><td> * Some benchmarks (times tended to fluctuate +-0.05ms):<tr><td><a id="l570"></a><a href="#l570">570</a><td> *                                     FireFox                     IE6<tr><td><a id="l571"></a><a href="#l571">571</a><td> * (no chars / average (mix of cases) / all 4 chars)<tr><td><a id="l572"></a><a href="#l572">572</a><td> * no checks                     0.13 / 0.22 / 0.22         0.23 / 0.53 / 0.80<tr><td><a id="l573"></a><a href="#l573">573</a><td> * indexOf                       0.08 / 0.17 / 0.26         0.22 / 0.54 / 0.84<tr><td><a id="l574"></a><a href="#l574">574</a><td> * indexOf + re test             0.07 / 0.17 / 0.28         0.19 / 0.50 / 0.85<tr><td><a id="l575"></a><a href="#l575">575</a><td> *<tr><td><a id="l576"></a><a href="#l576">576</a><td> * An additional advantage of checking if replace actually needs to be called<tr><td><a id="l577"></a><a href="#l577">577</a><td> * is a reduction in the number of object allocations, so as the size of the<tr><td><a id="l578"></a><a href="#l578">578</a><td> * application grows the difference between the various methods would increase.<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 {string} str string to be escaped.<tr><td><a id="l581"></a><a href="#l581">581</a><td> * @param {boolean=} opt_isLikelyToContainHtmlChars Don&#39;t perform a check to see<tr><td><a id="l582"></a><a href="#l582">582</a><td> *     if the character needs replacing - use this option if you expect each of<tr><td><a id="l583"></a><a href="#l583">583</a><td> *     the characters to appear often. Leave false if you expect few html<tr><td><a id="l584"></a><a href="#l584">584</a><td> *     characters to occur in your strings, such as if you are escaping HTML.<tr><td><a id="l585"></a><a href="#l585">585</a><td> * @return {string} An escaped copy of {@code str}.<tr><td><a id="l586"></a><a href="#l586">586</a><td> */<tr><td><a id="l587"></a><a href="#l587">587</a><td>goog.string.htmlEscape = function(str, opt_isLikelyToContainHtmlChars) {<tr><td><a id="l588"></a><a href="#l588">588</a><td><tr><td><a id="l589"></a><a href="#l589">589</a><td>  if (opt_isLikelyToContainHtmlChars) {<tr><td><a id="l590"></a><a href="#l590">590</a><td>    str = str.replace(goog.string.AMP_RE_, &#39;&amp;amp;&#39;)<tr><td><a id="l591"></a><a href="#l591">591</a><td>          .replace(goog.string.LT_RE_, &#39;&amp;lt;&#39;)<tr><td><a id="l592"></a><a href="#l592">592</a><td>          .replace(goog.string.GT_RE_, &#39;&amp;gt;&#39;)<tr><td><a id="l593"></a><a href="#l593">593</a><td>          .replace(goog.string.QUOT_RE_, &#39;&amp;quot;&#39;)<tr><td><a id="l594"></a><a href="#l594">594</a><td>          .replace(goog.string.SINGLE_QUOTE_RE_, &#39;&amp;#39;&#39;)<tr><td><a id="l595"></a><a href="#l595">595</a><td>          .replace(goog.string.NULL_RE_, &#39;&amp;#0;&#39;);<tr><td><a id="l596"></a><a href="#l596">596</a><td>    if (goog.string.DETECT_DOUBLE_ESCAPING) {<tr><td><a id="l597"></a><a href="#l597">597</a><td>      str = str.replace(goog.string.E_RE_, &#39;&amp;#101;&#39;);<tr><td><a id="l598"></a><a href="#l598">598</a><td>    }<tr><td><a id="l599"></a><a href="#l599">599</a><td>    return str;<tr><td><a id="l600"></a><a href="#l600">600</a><td><tr><td><a id="l601"></a><a href="#l601">601</a><td>  } else {<tr><td><a id="l602"></a><a href="#l602">602</a><td>    // quick test helps in the case when there are no chars to replace, in<tr><td><a id="l603"></a><a href="#l603">603</a><td>    // worst case this makes barely a difference to the time taken<tr><td><a id="l604"></a><a href="#l604">604</a><td>    if (!goog.string.ALL_RE_.test(str)) return str;<tr><td><a id="l605"></a><a href="#l605">605</a><td><tr><td><a id="l606"></a><a href="#l606">606</a><td>    // str.indexOf is faster than regex.test in this case<tr><td><a id="l607"></a><a href="#l607">607</a><td>    if (str.indexOf(&#39;&amp;&#39;) != -1) {<tr><td><a id="l608"></a><a href="#l608">608</a><td>      str = str.replace(goog.string.AMP_RE_, &#39;&amp;amp;&#39;);<tr><td><a id="l609"></a><a href="#l609">609</a><td>    }<tr><td><a id="l610"></a><a href="#l610">610</a><td>    if (str.indexOf(&#39;&lt;&#39;) != -1) {<tr><td><a id="l611"></a><a href="#l611">611</a><td>      str = str.replace(goog.string.LT_RE_, &#39;&amp;lt;&#39;);<tr><td><a id="l612"></a><a href="#l612">612</a><td>    }<tr><td><a id="l613"></a><a href="#l613">613</a><td>    if (str.indexOf(&#39;&gt;&#39;) != -1) {<tr><td><a id="l614"></a><a href="#l614">614</a><td>      str = str.replace(goog.string.GT_RE_, &#39;&amp;gt;&#39;);<tr><td><a id="l615"></a><a href="#l615">615</a><td>    }<tr><td><a id="l616"></a><a href="#l616">616</a><td>    if (str.indexOf(&#39;&quot;&#39;) != -1) {<tr><td><a id="l617"></a><a href="#l617">617</a><td>      str = str.replace(goog.string.QUOT_RE_, &#39;&amp;quot;&#39;);<tr><td><a id="l618"></a><a href="#l618">618</a><td>    }<tr><td><a id="l619"></a><a href="#l619">619</a><td>    if (str.indexOf(&#39;\&#39;&#39;) != -1) {<tr><td><a id="l620"></a><a href="#l620">620</a><td>      str = str.replace(goog.string.SINGLE_QUOTE_RE_, &#39;&amp;#39;&#39;);<tr><td><a id="l621"></a><a href="#l621">621</a><td>    }<tr><td><a id="l622"></a><a href="#l622">622</a><td>    if (str.indexOf(&#39;\x00&#39;) != -1) {<tr><td><a id="l623"></a><a href="#l623">623</a><td>      str = str.replace(goog.string.NULL_RE_, &#39;&amp;#0;&#39;);<tr><td><a id="l624"></a><a href="#l624">624</a><td>    }<tr><td><a id="l625"></a><a href="#l625">625</a><td>    if (goog.string.DETECT_DOUBLE_ESCAPING &amp;&amp; str.indexOf(&#39;e&#39;) != -1) {<tr><td><a id="l626"></a><a href="#l626">626</a><td>      str = str.replace(goog.string.E_RE_, &#39;&amp;#101;&#39;);<tr><td><a id="l627"></a><a href="#l627">627</a><td>    }<tr><td><a id="l628"></a><a href="#l628">628</a><td>    return str;<tr><td><a id="l629"></a><a href="#l629">629</a><td>  }<tr><td><a id="l630"></a><a href="#l630">630</a><td>};<tr><td><a id="l631"></a><a href="#l631">631</a><td><tr><td><a id="l632"></a><a href="#l632">632</a><td><tr><td><a id="l633"></a><a href="#l633">633</a><td>/**<tr><td><a id="l634"></a><a href="#l634">634</a><td> * Regular expression that matches an ampersand, for use in escaping.<tr><td><a id="l635"></a><a href="#l635">635</a><td> * @const {!RegExp}<tr><td><a id="l636"></a><a href="#l636">636</a><td> * @private<tr><td><a id="l637"></a><a href="#l637">637</a><td> */<tr><td><a id="l638"></a><a href="#l638">638</a><td>goog.string.AMP_RE_ = /&amp;/g;<tr><td><a id="l639"></a><a href="#l639">639</a><td><tr><td><a id="l640"></a><a href="#l640">640</a><td><tr><td><a id="l641"></a><a href="#l641">641</a><td>/**<tr><td><a id="l642"></a><a href="#l642">642</a><td> * Regular expression that matches a less than sign, for use in escaping.<tr><td><a id="l643"></a><a href="#l643">643</a><td> * @const {!RegExp}<tr><td><a id="l644"></a><a href="#l644">644</a><td> * @private<tr><td><a id="l645"></a><a href="#l645">645</a><td> */<tr><td><a id="l646"></a><a href="#l646">646</a><td>goog.string.LT_RE_ = /&lt;/g;<tr><td><a id="l647"></a><a href="#l647">647</a><td><tr><td><a id="l648"></a><a href="#l648">648</a><td><tr><td><a id="l649"></a><a href="#l649">649</a><td>/**<tr><td><a id="l650"></a><a href="#l650">650</a><td> * Regular expression that matches a greater than sign, for use in escaping.<tr><td><a id="l651"></a><a href="#l651">651</a><td> * @const {!RegExp}<tr><td><a id="l652"></a><a href="#l652">652</a><td> * @private<tr><td><a id="l653"></a><a href="#l653">653</a><td> */<tr><td><a id="l654"></a><a href="#l654">654</a><td>goog.string.GT_RE_ = /&gt;/g;<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> * Regular expression that matches a double quote, for use in escaping.<tr><td><a id="l659"></a><a href="#l659">659</a><td> * @const {!RegExp}<tr><td><a id="l660"></a><a href="#l660">660</a><td> * @private<tr><td><a id="l661"></a><a href="#l661">661</a><td> */<tr><td><a id="l662"></a><a href="#l662">662</a><td>goog.string.QUOT_RE_ = /&quot;/g;<tr><td><a id="l663"></a><a href="#l663">663</a><td><tr><td><a id="l664"></a><a href="#l664">664</a><td><tr><td><a id="l665"></a><a href="#l665">665</a><td>/**<tr><td><a id="l666"></a><a href="#l666">666</a><td> * Regular expression that matches a single quote, for use in escaping.<tr><td><a id="l667"></a><a href="#l667">667</a><td> * @const {!RegExp}<tr><td><a id="l668"></a><a href="#l668">668</a><td> * @private<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.string.SINGLE_QUOTE_RE_ = /&#39;/g;<tr><td><a id="l671"></a><a href="#l671">671</a><td><tr><td><a id="l672"></a><a href="#l672">672</a><td><tr><td><a id="l673"></a><a href="#l673">673</a><td>/**<tr><td><a id="l674"></a><a href="#l674">674</a><td> * Regular expression that matches null character, for use in escaping.<tr><td><a id="l675"></a><a href="#l675">675</a><td> * @const {!RegExp}<tr><td><a id="l676"></a><a href="#l676">676</a><td> * @private<tr><td><a id="l677"></a><a href="#l677">677</a><td> */<tr><td><a id="l678"></a><a href="#l678">678</a><td>goog.string.NULL_RE_ = /\x00/g;<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>/**<tr><td><a id="l682"></a><a href="#l682">682</a><td> * Regular expression that matches a lowercase letter &quot;e&quot;, for use in escaping.<tr><td><a id="l683"></a><a href="#l683">683</a><td> * @const {!RegExp}<tr><td><a id="l684"></a><a href="#l684">684</a><td> * @private<tr><td><a id="l685"></a><a href="#l685">685</a><td> */<tr><td><a id="l686"></a><a href="#l686">686</a><td>goog.string.E_RE_ = /e/g;<tr><td><a id="l687"></a><a href="#l687">687</a><td><tr><td><a id="l688"></a><a href="#l688">688</a><td><tr><td><a id="l689"></a><a href="#l689">689</a><td>/**<tr><td><a id="l690"></a><a href="#l690">690</a><td> * Regular expression that matches any character that needs to be escaped.<tr><td><a id="l691"></a><a href="#l691">691</a><td> * @const {!RegExp}<tr><td><a id="l692"></a><a href="#l692">692</a><td> * @private<tr><td><a id="l693"></a><a href="#l693">693</a><td> */<tr><td><a id="l694"></a><a href="#l694">694</a><td>goog.string.ALL_RE_ = (goog.string.DETECT_DOUBLE_ESCAPING ?<tr><td><a id="l695"></a><a href="#l695">695</a><td>    /[\x00&amp;&lt;&gt;&quot;&#39;e]/ :<tr><td><a id="l696"></a><a href="#l696">696</a><td>    /[\x00&amp;&lt;&gt;&quot;&#39;]/);<tr><td><a id="l697"></a><a href="#l697">697</a><td><tr><td><a id="l698"></a><a href="#l698">698</a><td><tr><td><a id="l699"></a><a href="#l699">699</a><td>/**<tr><td><a id="l700"></a><a href="#l700">700</a><td> * Unescapes an HTML string.<tr><td><a id="l701"></a><a href="#l701">701</a><td> *<tr><td><a id="l702"></a><a href="#l702">702</a><td> * @param {string} str The string to unescape.<tr><td><a id="l703"></a><a href="#l703">703</a><td> * @return {string} An unescaped copy of {@code str}.<tr><td><a id="l704"></a><a href="#l704">704</a><td> */<tr><td><a id="l705"></a><a href="#l705">705</a><td>goog.string.unescapeEntities = function(str) {<tr><td><a id="l706"></a><a href="#l706">706</a><td>  if (goog.string.contains(str, &#39;&amp;&#39;)) {<tr><td><a id="l707"></a><a href="#l707">707</a><td>    // We are careful not to use a DOM if we do not have one or we explicitly<tr><td><a id="l708"></a><a href="#l708">708</a><td>    // requested non-DOM html unescaping.<tr><td><a id="l709"></a><a href="#l709">709</a><td>    if (!goog.string.FORCE_NON_DOM_HTML_UNESCAPING &amp;&amp;<tr><td><a id="l710"></a><a href="#l710">710</a><td>        &#39;document&#39; in goog.global) {<tr><td><a id="l711"></a><a href="#l711">711</a><td>      return goog.string.unescapeEntitiesUsingDom_(str);<tr><td><a id="l712"></a><a href="#l712">712</a><td>    } else {<tr><td><a id="l713"></a><a href="#l713">713</a><td>      // Fall back on pure XML entities<tr><td><a id="l714"></a><a href="#l714">714</a><td>      return goog.string.unescapePureXmlEntities_(str);<tr><td><a id="l715"></a><a href="#l715">715</a><td>    }<tr><td><a id="l716"></a><a href="#l716">716</a><td>  }<tr><td><a id="l717"></a><a href="#l717">717</a><td>  return str;<tr><td><a id="l718"></a><a href="#l718">718</a><td>};<tr><td><a id="l719"></a><a href="#l719">719</a><td><tr><td><a id="l720"></a><a href="#l720">720</a><td><tr><td><a id="l721"></a><a href="#l721">721</a><td>/**<tr><td><a id="l722"></a><a href="#l722">722</a><td> * Unescapes a HTML string using the provided document.<tr><td><a id="l723"></a><a href="#l723">723</a><td> *<tr><td><a id="l724"></a><a href="#l724">724</a><td> * @param {string} str The string to unescape.<tr><td><a id="l725"></a><a href="#l725">725</a><td> * @param {!Document} document A document to use in escaping the string.<tr><td><a id="l726"></a><a href="#l726">726</a><td> * @return {string} An unescaped copy of {@code str}.<tr><td><a id="l727"></a><a href="#l727">727</a><td> */<tr><td><a id="l728"></a><a href="#l728">728</a><td>goog.string.unescapeEntitiesWithDocument = function(str, document) {<tr><td><a id="l729"></a><a href="#l729">729</a><td>  if (goog.string.contains(str, &#39;&amp;&#39;)) {<tr><td><a id="l730"></a><a href="#l730">730</a><td>    return goog.string.unescapeEntitiesUsingDom_(str, document);<tr><td><a id="l731"></a><a href="#l731">731</a><td>  }<tr><td><a id="l732"></a><a href="#l732">732</a><td>  return str;<tr><td><a id="l733"></a><a href="#l733">733</a><td>};<tr><td><a id="l734"></a><a href="#l734">734</a><td><tr><td><a id="l735"></a><a href="#l735">735</a><td><tr><td><a id="l736"></a><a href="#l736">736</a><td>/**<tr><td><a id="l737"></a><a href="#l737">737</a><td> * Unescapes an HTML string using a DOM to resolve non-XML, non-numeric<tr><td><a id="l738"></a><a href="#l738">738</a><td> * entities. This function is XSS-safe and whitespace-preserving.<tr><td><a id="l739"></a><a href="#l739">739</a><td> * @private<tr><td><a id="l740"></a><a href="#l740">740</a><td> * @param {string} str The string to unescape.<tr><td><a id="l741"></a><a href="#l741">741</a><td> * @param {Document=} opt_document An optional document to use for creating<tr><td><a id="l742"></a><a href="#l742">742</a><td> *     elements. If this is not specified then the default window.document<tr><td><a id="l743"></a><a href="#l743">743</a><td> *     will be used.<tr><td><a id="l744"></a><a href="#l744">744</a><td> * @return {string} The unescaped {@code str} string.<tr><td><a id="l745"></a><a href="#l745">745</a><td> */<tr><td><a id="l746"></a><a href="#l746">746</a><td>goog.string.unescapeEntitiesUsingDom_ = function(str, opt_document) {<tr><td><a id="l747"></a><a href="#l747">747</a><td>  /** @type {!Object&lt;string, string&gt;} */<tr><td><a id="l748"></a><a href="#l748">748</a><td>  var seen = {&#39;&amp;amp;&#39;: &#39;&amp;&#39;, &#39;&amp;lt;&#39;: &#39;&lt;&#39;, &#39;&amp;gt;&#39;: &#39;&gt;&#39;, &#39;&amp;quot;&#39;: &#39;&quot;&#39;};<tr><td><a id="l749"></a><a href="#l749">749</a><td>  var div;<tr><td><a id="l750"></a><a href="#l750">750</a><td>  if (opt_document) {<tr><td><a id="l751"></a><a href="#l751">751</a><td>    div = opt_document.createElement(&#39;div&#39;);<tr><td><a id="l752"></a><a href="#l752">752</a><td>  } else {<tr><td><a id="l753"></a><a href="#l753">753</a><td>    div = goog.global.document.createElement(&#39;div&#39;);<tr><td><a id="l754"></a><a href="#l754">754</a><td>  }<tr><td><a id="l755"></a><a href="#l755">755</a><td>  // Match as many valid entity characters as possible. If the actual entity<tr><td><a id="l756"></a><a href="#l756">756</a><td>  // happens to be shorter, it will still work as innerHTML will return the<tr><td><a id="l757"></a><a href="#l757">757</a><td>  // trailing characters unchanged. Since the entity characters do not include<tr><td><a id="l758"></a><a href="#l758">758</a><td>  // open angle bracket, there is no chance of XSS from the innerHTML use.<tr><td><a id="l759"></a><a href="#l759">759</a><td>  // Since no whitespace is passed to innerHTML, whitespace is preserved.<tr><td><a id="l760"></a><a href="#l760">760</a><td>  return str.replace(goog.string.HTML_ENTITY_PATTERN_, function(s, entity) {<tr><td><a id="l761"></a><a href="#l761">761</a><td>    // Check for cached entity.<tr><td><a id="l762"></a><a href="#l762">762</a><td>    var value = seen[s];<tr><td><a id="l763"></a><a href="#l763">763</a><td>    if (value) {<tr><td><a id="l764"></a><a href="#l764">764</a><td>      return value;<tr><td><a id="l765"></a><a href="#l765">765</a><td>    }<tr><td><a id="l766"></a><a href="#l766">766</a><td>    // Check for numeric entity.<tr><td><a id="l767"></a><a href="#l767">767</a><td>    if (entity.charAt(0) == &#39;#&#39;) {<tr><td><a id="l768"></a><a href="#l768">768</a><td>      // Prefix with 0 so that hex entities (e.g. &amp;#x10) parse as hex numbers.<tr><td><a id="l769"></a><a href="#l769">769</a><td>      var n = Number(&#39;0&#39; + entity.substr(1));<tr><td><a id="l770"></a><a href="#l770">770</a><td>      if (!isNaN(n)) {<tr><td><a id="l771"></a><a href="#l771">771</a><td>        value = String.fromCharCode(n);<tr><td><a id="l772"></a><a href="#l772">772</a><td>      }<tr><td><a id="l773"></a><a href="#l773">773</a><td>    }<tr><td><a id="l774"></a><a href="#l774">774</a><td>    // Fall back to innerHTML otherwise.<tr><td><a id="l775"></a><a href="#l775">775</a><td>    if (!value) {<tr><td><a id="l776"></a><a href="#l776">776</a><td>      // Append a non-entity character to avoid a bug in Webkit that parses<tr><td><a id="l777"></a><a href="#l777">777</a><td>      // an invalid entity at the end of innerHTML text as the empty string.<tr><td><a id="l778"></a><a href="#l778">778</a><td>      div.innerHTML = s + &#39; &#39;;<tr><td><a id="l779"></a><a href="#l779">779</a><td>      // Then remove the trailing character from the result.<tr><td><a id="l780"></a><a href="#l780">780</a><td>      value = div.firstChild.nodeValue.slice(0, -1);<tr><td><a id="l781"></a><a href="#l781">781</a><td>    }<tr><td><a id="l782"></a><a href="#l782">782</a><td>    // Cache and return.<tr><td><a id="l783"></a><a href="#l783">783</a><td>    return seen[s] = value;<tr><td><a id="l784"></a><a href="#l784">784</a><td>  });<tr><td><a id="l785"></a><a href="#l785">785</a><td>};<tr><td><a id="l786"></a><a href="#l786">786</a><td><tr><td><a id="l787"></a><a href="#l787">787</a><td><tr><td><a id="l788"></a><a href="#l788">788</a><td>/**<tr><td><a id="l789"></a><a href="#l789">789</a><td> * Unescapes XML entities.<tr><td><a id="l790"></a><a href="#l790">790</a><td> * @private<tr><td><a id="l791"></a><a href="#l791">791</a><td> * @param {string} str The string to unescape.<tr><td><a id="l792"></a><a href="#l792">792</a><td> * @return {string} An unescaped copy of {@code str}.<tr><td><a id="l793"></a><a href="#l793">793</a><td> */<tr><td><a id="l794"></a><a href="#l794">794</a><td>goog.string.unescapePureXmlEntities_ = function(str) {<tr><td><a id="l795"></a><a href="#l795">795</a><td>  return str.replace(/&amp;([^;]+);/g, function(s, entity) {<tr><td><a id="l796"></a><a href="#l796">796</a><td>    switch (entity) {<tr><td><a id="l797"></a><a href="#l797">797</a><td>      case &#39;amp&#39;:<tr><td><a id="l798"></a><a href="#l798">798</a><td>        return &#39;&amp;&#39;;<tr><td><a id="l799"></a><a href="#l799">799</a><td>      case &#39;lt&#39;:<tr><td><a id="l800"></a><a href="#l800">800</a><td>        return &#39;&lt;&#39;;<tr><td><a id="l801"></a><a href="#l801">801</a><td>      case &#39;gt&#39;:<tr><td><a id="l802"></a><a href="#l802">802</a><td>        return &#39;&gt;&#39;;<tr><td><a id="l803"></a><a href="#l803">803</a><td>      case &#39;quot&#39;:<tr><td><a id="l804"></a><a href="#l804">804</a><td>        return &#39;&quot;&#39;;<tr><td><a id="l805"></a><a href="#l805">805</a><td>      default:<tr><td><a id="l806"></a><a href="#l806">806</a><td>        if (entity.charAt(0) == &#39;#&#39;) {<tr><td><a id="l807"></a><a href="#l807">807</a><td>          // Prefix with 0 so that hex entities (e.g. &amp;#x10) parse as hex.<tr><td><a id="l808"></a><a href="#l808">808</a><td>          var n = Number(&#39;0&#39; + entity.substr(1));<tr><td><a id="l809"></a><a href="#l809">809</a><td>          if (!isNaN(n)) {<tr><td><a id="l810"></a><a href="#l810">810</a><td>            return String.fromCharCode(n);<tr><td><a id="l811"></a><a href="#l811">811</a><td>          }<tr><td><a id="l812"></a><a href="#l812">812</a><td>        }<tr><td><a id="l813"></a><a href="#l813">813</a><td>        // For invalid entities we just return the entity<tr><td><a id="l814"></a><a href="#l814">814</a><td>        return s;<tr><td><a id="l815"></a><a href="#l815">815</a><td>    }<tr><td><a id="l816"></a><a href="#l816">816</a><td>  });<tr><td><a id="l817"></a><a href="#l817">817</a><td>};<tr><td><a id="l818"></a><a href="#l818">818</a><td><tr><td><a id="l819"></a><a href="#l819">819</a><td><tr><td><a id="l820"></a><a href="#l820">820</a><td>/**<tr><td><a id="l821"></a><a href="#l821">821</a><td> * Regular expression that matches an HTML entity.<tr><td><a id="l822"></a><a href="#l822">822</a><td> * See also HTML5: Tokenization / Tokenizing character references.<tr><td><a id="l823"></a><a href="#l823">823</a><td> * @private<tr><td><a id="l824"></a><a href="#l824">824</a><td> * @type {!RegExp}<tr><td><a id="l825"></a><a href="#l825">825</a><td> */<tr><td><a id="l826"></a><a href="#l826">826</a><td>goog.string.HTML_ENTITY_PATTERN_ = /&amp;([^;\s&lt;&amp;]+);?/g;<tr><td><a id="l827"></a><a href="#l827">827</a><td><tr><td><a id="l828"></a><a href="#l828">828</a><td><tr><td><a id="l829"></a><a href="#l829">829</a><td>/**<tr><td><a id="l830"></a><a href="#l830">830</a><td> * Do escaping of whitespace to preserve spatial formatting. We use character<tr><td><a id="l831"></a><a href="#l831">831</a><td> * entity #160 to make it safer for xml.<tr><td><a id="l832"></a><a href="#l832">832</a><td> * @param {string} str The string in which to escape whitespace.<tr><td><a id="l833"></a><a href="#l833">833</a><td> * @param {boolean=} opt_xml Whether to use XML compatible tags.<tr><td><a id="l834"></a><a href="#l834">834</a><td> * @return {string} An escaped copy of {@code str}.<tr><td><a id="l835"></a><a href="#l835">835</a><td> */<tr><td><a id="l836"></a><a href="#l836">836</a><td>goog.string.whitespaceEscape = function(str, opt_xml) {<tr><td><a id="l837"></a><a href="#l837">837</a><td>  // This doesn&#39;t use goog.string.preserveSpaces for backwards compatibility.<tr><td><a id="l838"></a><a href="#l838">838</a><td>  return goog.string.newLineToBr(str.replace(/  /g, &#39; &amp;#160;&#39;), opt_xml);<tr><td><a id="l839"></a><a href="#l839">839</a><td>};<tr><td><a id="l840"></a><a href="#l840">840</a><td><tr><td><a id="l841"></a><a href="#l841">841</a><td><tr><td><a id="l842"></a><a href="#l842">842</a><td>/**<tr><td><a id="l843"></a><a href="#l843">843</a><td> * Preserve spaces that would be otherwise collapsed in HTML by replacing them<tr><td><a id="l844"></a><a href="#l844">844</a><td> * with non-breaking space Unicode characters.<tr><td><a id="l845"></a><a href="#l845">845</a><td> * @param {string} str The string in which to preserve whitespace.<tr><td><a id="l846"></a><a href="#l846">846</a><td> * @return {string} A copy of {@code str} with preserved whitespace.<tr><td><a id="l847"></a><a href="#l847">847</a><td> */<tr><td><a id="l848"></a><a href="#l848">848</a><td>goog.string.preserveSpaces = function(str) {<tr><td><a id="l849"></a><a href="#l849">849</a><td>  return str.replace(/(^|[\n ]) /g, &#39;$1&#39; + goog.string.Unicode.NBSP);<tr><td><a id="l850"></a><a href="#l850">850</a><td>};<tr><td><a id="l851"></a><a href="#l851">851</a><td><tr><td><a id="l852"></a><a href="#l852">852</a><td><tr><td><a id="l853"></a><a href="#l853">853</a><td>/**<tr><td><a id="l854"></a><a href="#l854">854</a><td> * Strip quote characters around a string.  The second argument is a string of<tr><td><a id="l855"></a><a href="#l855">855</a><td> * characters to treat as quotes.  This can be a single character or a string of<tr><td><a id="l856"></a><a href="#l856">856</a><td> * multiple character and in that case each of those are treated as possible<tr><td><a id="l857"></a><a href="#l857">857</a><td> * quote characters. For example:<tr><td><a id="l858"></a><a href="#l858">858</a><td> *<tr><td><a id="l859"></a><a href="#l859">859</a><td> * &lt;pre&gt;<tr><td><a id="l860"></a><a href="#l860">860</a><td> * goog.string.stripQuotes(&#39;&quot;abc&quot;&#39;, &#39;&quot;`&#39;) --&gt; &#39;abc&#39;<tr><td><a id="l861"></a><a href="#l861">861</a><td> * goog.string.stripQuotes(&#39;`abc`&#39;, &#39;&quot;`&#39;) --&gt; &#39;abc&#39;<tr><td><a id="l862"></a><a href="#l862">862</a><td> * &lt;/pre&gt;<tr><td><a id="l863"></a><a href="#l863">863</a><td> *<tr><td><a id="l864"></a><a href="#l864">864</a><td> * @param {string} str The string to strip.<tr><td><a id="l865"></a><a href="#l865">865</a><td> * @param {string} quoteChars The quote characters to strip.<tr><td><a id="l866"></a><a href="#l866">866</a><td> * @return {string} A copy of {@code str} without the quotes.<tr><td><a id="l867"></a><a href="#l867">867</a><td> */<tr><td><a id="l868"></a><a href="#l868">868</a><td>goog.string.stripQuotes = function(str, quoteChars) {<tr><td><a id="l869"></a><a href="#l869">869</a><td>  var length = quoteChars.length;<tr><td><a id="l870"></a><a href="#l870">870</a><td>  for (var i = 0; i &lt; length; i++) {<tr><td><a id="l871"></a><a href="#l871">871</a><td>    var quoteChar = length == 1 ? quoteChars : quoteChars.charAt(i);<tr><td><a id="l872"></a><a href="#l872">872</a><td>    if (str.charAt(0) == quoteChar &amp;&amp; str.charAt(str.length - 1) == quoteChar) {<tr><td><a id="l873"></a><a href="#l873">873</a><td>      return str.substring(1, str.length - 1);<tr><td><a id="l874"></a><a href="#l874">874</a><td>    }<tr><td><a id="l875"></a><a href="#l875">875</a><td>  }<tr><td><a id="l876"></a><a href="#l876">876</a><td>  return str;<tr><td><a id="l877"></a><a href="#l877">877</a><td>};<tr><td><a id="l878"></a><a href="#l878">878</a><td><tr><td><a id="l879"></a><a href="#l879">879</a><td><tr><td><a id="l880"></a><a href="#l880">880</a><td>/**<tr><td><a id="l881"></a><a href="#l881">881</a><td> * Truncates a string to a certain length and adds &#39;...&#39; if necessary.  The<tr><td><a id="l882"></a><a href="#l882">882</a><td> * length also accounts for the ellipsis, so a maximum length of 10 and a string<tr><td><a id="l883"></a><a href="#l883">883</a><td> * &#39;Hello World!&#39; produces &#39;Hello W...&#39;.<tr><td><a id="l884"></a><a href="#l884">884</a><td> * @param {string} str The string to truncate.<tr><td><a id="l885"></a><a href="#l885">885</a><td> * @param {number} chars Max number of characters.<tr><td><a id="l886"></a><a href="#l886">886</a><td> * @param {boolean=} opt_protectEscapedCharacters Whether to protect escaped<tr><td><a id="l887"></a><a href="#l887">887</a><td> *     characters from being cut off in the middle.<tr><td><a id="l888"></a><a href="#l888">888</a><td> * @return {string} The truncated {@code str} string.<tr><td><a id="l889"></a><a href="#l889">889</a><td> */<tr><td><a id="l890"></a><a href="#l890">890</a><td>goog.string.truncate = function(str, chars, opt_protectEscapedCharacters) {<tr><td><a id="l891"></a><a href="#l891">891</a><td>  if (opt_protectEscapedCharacters) {<tr><td><a id="l892"></a><a href="#l892">892</a><td>    str = goog.string.unescapeEntities(str);<tr><td><a id="l893"></a><a href="#l893">893</a><td>  }<tr><td><a id="l894"></a><a href="#l894">894</a><td><tr><td><a id="l895"></a><a href="#l895">895</a><td>  if (str.length &gt; chars) {<tr><td><a id="l896"></a><a href="#l896">896</a><td>    str = str.substring(0, chars - 3) + &#39;...&#39;;<tr><td><a id="l897"></a><a href="#l897">897</a><td>  }<tr><td><a id="l898"></a><a href="#l898">898</a><td><tr><td><a id="l899"></a><a href="#l899">899</a><td>  if (opt_protectEscapedCharacters) {<tr><td><a id="l900"></a><a href="#l900">900</a><td>    str = goog.string.htmlEscape(str);<tr><td><a id="l901"></a><a href="#l901">901</a><td>  }<tr><td><a id="l902"></a><a href="#l902">902</a><td><tr><td><a id="l903"></a><a href="#l903">903</a><td>  return str;<tr><td><a id="l904"></a><a href="#l904">904</a><td>};<tr><td><a id="l905"></a><a href="#l905">905</a><td><tr><td><a id="l906"></a><a href="#l906">906</a><td><tr><td><a id="l907"></a><a href="#l907">907</a><td>/**<tr><td><a id="l908"></a><a href="#l908">908</a><td> * Truncate a string in the middle, adding &quot;...&quot; if necessary,<tr><td><a id="l909"></a><a href="#l909">909</a><td> * and favoring the beginning of the string.<tr><td><a id="l910"></a><a href="#l910">910</a><td> * @param {string} str The string to truncate the middle of.<tr><td><a id="l911"></a><a href="#l911">911</a><td> * @param {number} chars Max number of characters.<tr><td><a id="l912"></a><a href="#l912">912</a><td> * @param {boolean=} opt_protectEscapedCharacters Whether to protect escaped<tr><td><a id="l913"></a><a href="#l913">913</a><td> *     characters from being cutoff in the middle.<tr><td><a id="l914"></a><a href="#l914">914</a><td> * @param {number=} opt_trailingChars Optional number of trailing characters to<tr><td><a id="l915"></a><a href="#l915">915</a><td> *     leave at the end of the string, instead of truncating as close to the<tr><td><a id="l916"></a><a href="#l916">916</a><td> *     middle as possible.<tr><td><a id="l917"></a><a href="#l917">917</a><td> * @return {string} A truncated copy of {@code str}.<tr><td><a id="l918"></a><a href="#l918">918</a><td> */<tr><td><a id="l919"></a><a href="#l919">919</a><td>goog.string.truncateMiddle = function(str, chars,<tr><td><a id="l920"></a><a href="#l920">920</a><td>    opt_protectEscapedCharacters, opt_trailingChars) {<tr><td><a id="l921"></a><a href="#l921">921</a><td>  if (opt_protectEscapedCharacters) {<tr><td><a id="l922"></a><a href="#l922">922</a><td>    str = goog.string.unescapeEntities(str);<tr><td><a id="l923"></a><a href="#l923">923</a><td>  }<tr><td><a id="l924"></a><a href="#l924">924</a><td><tr><td><a id="l925"></a><a href="#l925">925</a><td>  if (opt_trailingChars &amp;&amp; str.length &gt; chars) {<tr><td><a id="l926"></a><a href="#l926">926</a><td>    if (opt_trailingChars &gt; chars) {<tr><td><a id="l927"></a><a href="#l927">927</a><td>      opt_trailingChars = chars;<tr><td><a id="l928"></a><a href="#l928">928</a><td>    }<tr><td><a id="l929"></a><a href="#l929">929</a><td>    var endPoint = str.length - opt_trailingChars;<tr><td><a id="l930"></a><a href="#l930">930</a><td>    var startPoint = chars - opt_trailingChars;<tr><td><a id="l931"></a><a href="#l931">931</a><td>    str = str.substring(0, startPoint) + &#39;...&#39; + str.substring(endPoint);<tr><td><a id="l932"></a><a href="#l932">932</a><td>  } else if (str.length &gt; chars) {<tr><td><a id="l933"></a><a href="#l933">933</a><td>    // Favor the beginning of the string:<tr><td><a id="l934"></a><a href="#l934">934</a><td>    var half = Math.floor(chars / 2);<tr><td><a id="l935"></a><a href="#l935">935</a><td>    var endPos = str.length - half;<tr><td><a id="l936"></a><a href="#l936">936</a><td>    half += chars % 2;<tr><td><a id="l937"></a><a href="#l937">937</a><td>    str = str.substring(0, half) + &#39;...&#39; + str.substring(endPos);<tr><td><a id="l938"></a><a href="#l938">938</a><td>  }<tr><td><a id="l939"></a><a href="#l939">939</a><td><tr><td><a id="l940"></a><a href="#l940">940</a><td>  if (opt_protectEscapedCharacters) {<tr><td><a id="l941"></a><a href="#l941">941</a><td>    str = goog.string.htmlEscape(str);<tr><td><a id="l942"></a><a href="#l942">942</a><td>  }<tr><td><a id="l943"></a><a href="#l943">943</a><td><tr><td><a id="l944"></a><a href="#l944">944</a><td>  return str;<tr><td><a id="l945"></a><a href="#l945">945</a><td>};<tr><td><a id="l946"></a><a href="#l946">946</a><td><tr><td><a id="l947"></a><a href="#l947">947</a><td><tr><td><a id="l948"></a><a href="#l948">948</a><td>/**<tr><td><a id="l949"></a><a href="#l949">949</a><td> * Special chars that need to be escaped for goog.string.quote.<tr><td><a id="l950"></a><a href="#l950">950</a><td> * @private {!Object&lt;string, string&gt;}<tr><td><a id="l951"></a><a href="#l951">951</a><td> */<tr><td><a id="l952"></a><a href="#l952">952</a><td>goog.string.specialEscapeChars_ = {<tr><td><a id="l953"></a><a href="#l953">953</a><td>  &#39;\0&#39;: &#39;\\0&#39;,<tr><td><a id="l954"></a><a href="#l954">954</a><td>  &#39;\b&#39;: &#39;\\b&#39;,<tr><td><a id="l955"></a><a href="#l955">955</a><td>  &#39;\f&#39;: &#39;\\f&#39;,<tr><td><a id="l956"></a><a href="#l956">956</a><td>  &#39;\n&#39;: &#39;\\n&#39;,<tr><td><a id="l957"></a><a href="#l957">957</a><td>  &#39;\r&#39;: &#39;\\r&#39;,<tr><td><a id="l958"></a><a href="#l958">958</a><td>  &#39;\t&#39;: &#39;\\t&#39;,<tr><td><a id="l959"></a><a href="#l959">959</a><td>  &#39;\x0B&#39;: &#39;\\x0B&#39;, // &#39;\v&#39; is not supported in JScript<tr><td><a id="l960"></a><a href="#l960">960</a><td>  &#39;&quot;&#39;: &#39;\\&quot;&#39;,<tr><td><a id="l961"></a><a href="#l961">961</a><td>  &#39;\\&#39;: &#39;\\\\&#39;,<tr><td><a id="l962"></a><a href="#l962">962</a><td>  // To support the use case of embedding quoted strings inside of &lt;script&gt;<tr><td><a id="l963"></a><a href="#l963">963</a><td>  // tags, we have to make sure &quot;&lt;!--&quot;, &quot;&lt;script&quot;, and &quot;&lt;/script&quot; does not<tr><td><a id="l964"></a><a href="#l964">964</a><td>  // appear in the resulting string. The specific strings that must be escaped<tr><td><a id="l965"></a><a href="#l965">965</a><td>  // are documented at:<tr><td><a id="l966"></a><a href="#l966">966</a><td>  // http://www.w3.org/TR/html51/semantics.html#restrictions-for-contents-of-script-elements<tr><td><a id="l967"></a><a href="#l967">967</a><td>  &#39;&lt;&#39;: &#39;\x3c&#39;<tr><td><a id="l968"></a><a href="#l968">968</a><td>};<tr><td><a id="l969"></a><a href="#l969">969</a><td><tr><td><a id="l970"></a><a href="#l970">970</a><td><tr><td><a id="l971"></a><a href="#l971">971</a><td>/**<tr><td><a id="l972"></a><a href="#l972">972</a><td> * Character mappings used internally for goog.string.escapeChar.<tr><td><a id="l973"></a><a href="#l973">973</a><td> * @private {!Object&lt;string, string&gt;}<tr><td><a id="l974"></a><a href="#l974">974</a><td> */<tr><td><a id="l975"></a><a href="#l975">975</a><td>goog.string.jsEscapeCache_ = {<tr><td><a id="l976"></a><a href="#l976">976</a><td>  &#39;\&#39;&#39;: &#39;\\\&#39;&#39;<tr><td><a id="l977"></a><a href="#l977">977</a><td>};<tr><td><a id="l978"></a><a href="#l978">978</a><td><tr><td><a id="l979"></a><a href="#l979">979</a><td><tr><td><a id="l980"></a><a href="#l980">980</a><td>/**<tr><td><a id="l981"></a><a href="#l981">981</a><td> * Encloses a string in double quotes and escapes characters so that the<tr><td><a id="l982"></a><a href="#l982">982</a><td> * string is a valid JS string. The resulting string is safe to embed in<tr><td><a id="l983"></a><a href="#l983">983</a><td> * &lt;script&gt; tags as &quot;&lt;&quot; is escaped.<tr><td><a id="l984"></a><a href="#l984">984</a><td> * @param {string} s The string to quote.<tr><td><a id="l985"></a><a href="#l985">985</a><td> * @return {string} A copy of {@code s} surrounded by double quotes.<tr><td><a id="l986"></a><a href="#l986">986</a><td> */<tr><td><a id="l987"></a><a href="#l987">987</a><td>goog.string.quote = function(s) {<tr><td><a id="l988"></a><a href="#l988">988</a><td>  s = String(s);<tr><td><a id="l989"></a><a href="#l989">989</a><td>  var sb = [&#39;&quot;&#39;];<tr><td><a id="l990"></a><a href="#l990">990</a><td>  for (var i = 0; i &lt; s.length; i++) {<tr><td><a id="l991"></a><a href="#l991">991</a><td>    var ch = s.charAt(i);<tr><td><a id="l992"></a><a href="#l992">992</a><td>    var cc = ch.charCodeAt(0);<tr><td><a id="l993"></a><a href="#l993">993</a><td>    sb[i + 1] = goog.string.specialEscapeChars_[ch] ||<tr><td><a id="l994"></a><a href="#l994">994</a><td>                ((cc &gt; 31 &amp;&amp; cc &lt; 127) ? ch : goog.string.escapeChar(ch));<tr><td><a id="l995"></a><a href="#l995">995</a><td>  }<tr><td><a id="l996"></a><a href="#l996">996</a><td>  sb.push(&#39;&quot;&#39;);<tr><td><a id="l997"></a><a href="#l997">997</a><td>  return sb.join(&#39;&#39;);<tr><td><a id="l998"></a><a href="#l998">998</a><td>};<tr><td><a id="l999"></a><a href="#l999">999</a><td><tr><td><a id="l1000"></a><a href="#l1000">1000</a><td><tr><td><a id="l1001"></a><a href="#l1001">1001</a><td>/**<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td> * Takes a string and returns the escaped string for that character.<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td> * @param {string} str The string to escape.<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td> * @return {string} An escaped string representing {@code str}.<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td> */<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td>goog.string.escapeString = function(str) {<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>  var sb = [];<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td>  for (var i = 0; i &lt; str.length; i++) {<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td>    sb[i] = goog.string.escapeChar(str.charAt(i));<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td>  }<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td>  return sb.join(&#39;&#39;);<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td>};<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td><tr><td><a id="l1014"></a><a href="#l1014">1014</a><td><tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>/**<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td> * Takes a character and returns the escaped string for that character. For<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td> * example escapeChar(String.fromCharCode(15)) -&gt; &quot;\\x0E&quot;.<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td> * @param {string} c The character to escape.<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td> * @return {string} An escaped string representing {@code c}.<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td> */<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>goog.string.escapeChar = function(c) {<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td>  if (c in goog.string.jsEscapeCache_) {<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td>    return goog.string.jsEscapeCache_[c];<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td>  }<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td><tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>  if (c in goog.string.specialEscapeChars_) {<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>    return goog.string.jsEscapeCache_[c] = goog.string.specialEscapeChars_[c];<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>  }<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td><tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>  var rv = c;<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td>  var cc = c.charCodeAt(0);<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td>  if (cc &gt; 31 &amp;&amp; cc &lt; 127) {<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>    rv = c;<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>  } else {<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>    // tab is 9 but handled above<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>    if (cc &lt; 256) {<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td>      rv = &#39;\\x&#39;;<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td>      if (cc &lt; 16 || cc &gt; 256) {<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>        rv += &#39;0&#39;;<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>      }<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td>    } else {<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td>      rv = &#39;\\u&#39;;<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td>      if (cc &lt; 4096) { // \u1000<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>        rv += &#39;0&#39;;<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td>      }<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td>    }<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td>    rv += cc.toString(16).toUpperCase();<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>  }<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td><tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>  return goog.string.jsEscapeCache_[c] = rv;<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td>};<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td><tr><td><a id="l1053"></a><a href="#l1053">1053</a><td><tr><td><a id="l1054"></a><a href="#l1054">1054</a><td>/**<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td> * Determines whether a string contains a substring.<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td> * @param {string} str The string to search.<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td> * @param {string} subString The substring to search for.<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td> * @return {boolean} Whether {@code str} contains {@code subString}.<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td> */<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td>goog.string.contains = function(str, subString) {<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td>  return str.indexOf(subString) != -1;<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td>};<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td><tr><td><a id="l1064"></a><a href="#l1064">1064</a><td><tr><td><a id="l1065"></a><a href="#l1065">1065</a><td>/**<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td> * Determines whether a string contains a substring, ignoring case.<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td> * @param {string} str The string to search.<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td> * @param {string} subString The substring to search for.<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td> * @return {boolean} Whether {@code str} contains {@code subString}.<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td> */<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td>goog.string.caseInsensitiveContains = function(str, subString) {<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td>  return goog.string.contains(str.toLowerCase(), subString.toLowerCase());<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td>};<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td><tr><td><a id="l1075"></a><a href="#l1075">1075</a><td><tr><td><a id="l1076"></a><a href="#l1076">1076</a><td>/**<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td> * Returns the non-overlapping occurrences of ss in s.<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td> * If either s or ss evalutes to false, then returns zero.<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td> * @param {string} s The string to look in.<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td> * @param {string} ss The string to look for.<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td> * @return {number} Number of occurrences of ss in s.<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td> */<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>goog.string.countOf = function(s, ss) {<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td>  return s &amp;&amp; ss ? s.split(ss).length - 1 : 0;<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td>};<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td><tr><td><a id="l1087"></a><a href="#l1087">1087</a><td><tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>/**<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td> * Removes a substring of a specified length at a specific<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td> * index in a string.<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td> * @param {string} s The base string from which to remove.<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td> * @param {number} index The index at which to remove the substring.<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td> * @param {number} stringLength The length of the substring to remove.<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td> * @return {string} A copy of {@code s} with the substring removed or the full<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td> *     string if nothing is removed or the input is invalid.<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td> */<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>goog.string.removeAt = function(s, index, stringLength) {<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td>  var resultStr = s;<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td>  // If the index is greater or equal to 0 then remove substring<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>  if (index &gt;= 0 &amp;&amp; index &lt; s.length &amp;&amp; stringLength &gt; 0) {<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td>    resultStr = s.substr(0, index) +<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td>        s.substr(index + stringLength, s.length - index - stringLength);<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td>  }<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td>  return resultStr;<tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>};<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td><tr><td><a id="l1107"></a><a href="#l1107">1107</a><td><tr><td><a id="l1108"></a><a href="#l1108">1108</a><td>/**<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td> *  Removes the first occurrence of a substring from a string.<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td> *  @param {string} s The base string from which to remove.<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td> *  @param {string} ss The string to remove.<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td> *  @return {string} A copy of {@code s} with {@code ss} removed or the full<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td> *      string if nothing is removed.<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td> */<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td>goog.string.remove = function(s, ss) {<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td>  var re = new RegExp(goog.string.regExpEscape(ss), &#39;&#39;);<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td>  return s.replace(re, &#39;&#39;);<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td>};<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td><tr><td><a id="l1120"></a><a href="#l1120">1120</a><td><tr><td><a id="l1121"></a><a href="#l1121">1121</a><td>/**<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td> *  Removes all occurrences of a substring from a string.<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td> *  @param {string} s The base string from which to remove.<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td> *  @param {string} ss The string to remove.<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td> *  @return {string} A copy of {@code s} with {@code ss} removed or the full<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td> *      string if nothing is removed.<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td> */<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td>goog.string.removeAll = function(s, ss) {<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td>  var re = new RegExp(goog.string.regExpEscape(ss), &#39;g&#39;);<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td>  return s.replace(re, &#39;&#39;);<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td>};<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td><tr><td><a id="l1133"></a><a href="#l1133">1133</a><td><tr><td><a id="l1134"></a><a href="#l1134">1134</a><td>/**<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td> * Escapes characters in the string that are not safe to use in a RegExp.<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td> * @param {*} s The string to escape. If not a string, it will be casted<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td> *     to one.<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td> * @return {string} A RegExp safe, escaped copy of {@code s}.<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td> */<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td>goog.string.regExpEscape = function(s) {<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td>  return String(s).replace(/([-()\[\]{}+?*.$\^|,:#&lt;!\\])/g, &#39;\\$1&#39;).<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>      replace(/\x08/g, &#39;\\x08&#39;);<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>};<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td><tr><td><a id="l1145"></a><a href="#l1145">1145</a><td><tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>/**<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td> * Repeats a string n times.<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td> * @param {string} string The string to repeat.<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td> * @param {number} length The number of times to repeat.<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td> * @return {string} A string containing {@code length} repetitions of<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td> *     {@code string}.<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td> */<tr><td><a id="l1153"></a><a href="#l1153">1153</a><td>goog.string.repeat = (String.prototype.repeat) ?<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td>    function(string, length) {<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td>      // The native method is over 100 times faster than the alternative.<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td>      return string.repeat(length);<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td>    } :<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td>    function(string, length) {<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td>      return new Array(length + 1).join(string);<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td>    };<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td><tr><td><a id="l1162"></a><a href="#l1162">1162</a><td><tr><td><a id="l1163"></a><a href="#l1163">1163</a><td>/**<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td> * Pads number to given length and optionally rounds it to a given precision.<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td> * For example:<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td> * &lt;pre&gt;padNumber(1.25, 2, 3) -&gt; &#39;01.250&#39;<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td> * padNumber(1.25, 2) -&gt; &#39;01.25&#39;<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td> * padNumber(1.25, 2, 1) -&gt; &#39;01.3&#39;<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td> * padNumber(1.25, 0) -&gt; &#39;1.25&#39;&lt;/pre&gt;<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td> *<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td> * @param {number} num The number to pad.<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td> * @param {number} length The desired length.<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td> * @param {number=} opt_precision The desired precision.<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td> * @return {string} {@code num} as a string with the given options.<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td> */<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td>goog.string.padNumber = function(num, length, opt_precision) {<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td>  var s = goog.isDef(opt_precision) ? num.toFixed(opt_precision) : String(num);<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td>  var index = s.indexOf(&#39;.&#39;);<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td>  if (index == -1) {<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td>    index = s.length;<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td>  }<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td>  return goog.string.repeat(&#39;0&#39;, Math.max(0, length - index)) + s;<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td>};<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td><tr><td><a id="l1185"></a><a href="#l1185">1185</a><td><tr><td><a id="l1186"></a><a href="#l1186">1186</a><td>/**<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td> * Returns a string representation of the given object, with<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td> * null and undefined being returned as the empty string.<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td> *<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td> * @param {*} obj The object to convert.<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td> * @return {string} A string representation of the {@code obj}.<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td> */<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>goog.string.makeSafe = function(obj) {<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td>  return obj == null ? &#39;&#39; : String(obj);<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>};<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td><tr><td><a id="l1197"></a><a href="#l1197">1197</a><td><tr><td><a id="l1198"></a><a href="#l1198">1198</a><td>/**<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td> * Concatenates string expressions. This is useful<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td> * since some browsers are very inefficient when it comes to using plus to<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td> * concat strings. Be careful when using null and undefined here since<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td> * these will not be included in the result. If you need to represent these<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td> * be sure to cast the argument to a String first.<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td> * For example:<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td> * &lt;pre&gt;buildString(&#39;a&#39;, &#39;b&#39;, &#39;c&#39;, &#39;d&#39;) -&gt; &#39;abcd&#39;<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td> * buildString(null, undefined) -&gt; &#39;&#39;<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td> * &lt;/pre&gt;<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td> * @param {...*} var_args A list of strings to concatenate. If not a string,<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td> *     it will be casted to one.<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td> * @return {string} The concatenation of {@code var_args}.<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td> */<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td>goog.string.buildString = function(var_args) {<tr><td><a id="l1213"></a><a href="#l1213">1213</a><td>  return Array.prototype.join.call(arguments, &#39;&#39;);<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td>};<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td><tr><td><a id="l1216"></a><a href="#l1216">1216</a><td><tr><td><a id="l1217"></a><a href="#l1217">1217</a><td>/**<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td> * Returns a string with at least 64-bits of randomness.<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td> *<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td> * Doesn&#39;t trust Javascript&#39;s random function entirely. Uses a combination of<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td> * random and current timestamp, and then encodes the string in base-36 to<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td> * make it shorter.<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td> *<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td> * @return {string} A random string, e.g. sn1s7vb4gcic.<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td> */<tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>goog.string.getRandomString = function() {<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td>  var x = 2147483648;<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td>  return Math.floor(Math.random() * x).toString(36) +<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td>         Math.abs(Math.floor(Math.random() * x) ^ goog.now()).toString(36);<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td>};<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td><tr><td><a id="l1232"></a><a href="#l1232">1232</a><td><tr><td><a id="l1233"></a><a href="#l1233">1233</a><td>/**<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td> * Compares two version numbers.<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td> *<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td> * @param {string|number} version1 Version of first item.<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td> * @param {string|number} version2 Version of second item.<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td> *<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td> * @return {number}  1 if {@code version1} is higher.<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td> *                   0 if arguments are equal.<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td> *                  -1 if {@code version2} is higher.<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td> */<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td>goog.string.compareVersions = function(version1, version2) {<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td>  var order = 0;<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td>  // Trim leading and trailing whitespace and split the versions into<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td>  // subversions.<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>  var v1Subs = goog.string.trim(String(version1)).split(&#39;.&#39;);<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>  var v2Subs = goog.string.trim(String(version2)).split(&#39;.&#39;);<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>  var subCount = Math.max(v1Subs.length, v2Subs.length);<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td><tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>  // Iterate over the subversions, as long as they appear to be equivalent.<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td>  for (var subIdx = 0; order == 0 &amp;&amp; subIdx &lt; subCount; subIdx++) {<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>    var v1Sub = v1Subs[subIdx] || &#39;&#39;;<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td>    var v2Sub = v2Subs[subIdx] || &#39;&#39;;<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td><tr><td><a id="l1256"></a><a href="#l1256">1256</a><td>    // Split the subversions into pairs of numbers and qualifiers (like &#39;b&#39;).<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td>    // Two different RegExp objects are needed because they are both using<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td>    // the &#39;g&#39; flag.<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td>    var v1CompParser = new RegExp(&#39;(\\d*)(\\D*)&#39;, &#39;g&#39;);<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td>    var v2CompParser = new RegExp(&#39;(\\d*)(\\D*)&#39;, &#39;g&#39;);<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td>    do {<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td>      var v1Comp = v1CompParser.exec(v1Sub) || [&#39;&#39;, &#39;&#39;, &#39;&#39;];<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td>      var v2Comp = v2CompParser.exec(v2Sub) || [&#39;&#39;, &#39;&#39;, &#39;&#39;];<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>      // Break if there are no more matches.<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>      if (v1Comp[0].length == 0 &amp;&amp; v2Comp[0].length == 0) {<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>        break;<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>      }<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td><tr><td><a id="l1269"></a><a href="#l1269">1269</a><td>      // Parse the numeric part of the subversion. A missing number is<tr><td><a id="l1270"></a><a href="#l1270">1270</a><td>      // equivalent to 0.<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td>      var v1CompNum = v1Comp[1].length == 0 ? 0 : parseInt(v1Comp[1], 10);<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td>      var v2CompNum = v2Comp[1].length == 0 ? 0 : parseInt(v2Comp[1], 10);<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td><tr><td><a id="l1274"></a><a href="#l1274">1274</a><td>      // Compare the subversion components. The number has the highest<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td>      // precedence. Next, if the numbers are equal, a subversion without any<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td>      // qualifier is always higher than a subversion with any qualifier. Next,<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td>      // the qualifiers are compared as strings.<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>      order = goog.string.compareElements_(v1CompNum, v2CompNum) ||<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>          goog.string.compareElements_(v1Comp[2].length == 0,<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td>              v2Comp[2].length == 0) ||<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>          goog.string.compareElements_(v1Comp[2], v2Comp[2]);<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>      // Stop as soon as an inequality is discovered.<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>    } while (order == 0);<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>  }<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td><tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>  return order;<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>};<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td><tr><td><a id="l1289"></a><a href="#l1289">1289</a><td><tr><td><a id="l1290"></a><a href="#l1290">1290</a><td>/**<tr><td><a id="l1291"></a><a href="#l1291">1291</a><td> * Compares elements of a version number.<tr><td><a id="l1292"></a><a href="#l1292">1292</a><td> *<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td> * @param {string|number|boolean} left An element from a version number.<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td> * @param {string|number|boolean} right An element from a version number.<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td> *<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td> * @return {number}  1 if {@code left} is higher.<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td> *                   0 if arguments are equal.<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td> *                  -1 if {@code right} is higher.<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td> * @private<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td> */<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>goog.string.compareElements_ = function(left, right) {<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td>  if (left &lt; right) {<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td>    return -1;<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>  } else if (left &gt; right) {<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td>    return 1;<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td>  }<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td>  return 0;<tr><td><a id="l1308"></a><a href="#l1308">1308</a><td>};<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td><tr><td><a id="l1310"></a><a href="#l1310">1310</a><td><tr><td><a id="l1311"></a><a href="#l1311">1311</a><td>/**<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td> * String hash function similar to java.lang.String.hashCode().<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td> * The hash code for a string is computed as<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td> * s[0] * 31 ^ (n - 1) + s[1] * 31 ^ (n - 2) + ... + s[n - 1],<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td> * where s[i] is the ith character of the string and n is the length of<tr><td><a id="l1316"></a><a href="#l1316">1316</a><td> * the string. We mod the result to make it between 0 (inclusive) and 2^32<tr><td><a id="l1317"></a><a href="#l1317">1317</a><td> * (exclusive).<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td> * @param {string} str A string.<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td> * @return {number} Hash value for {@code str}, between 0 (inclusive) and 2^32<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td> *  (exclusive). The empty string returns 0.<tr><td><a id="l1321"></a><a href="#l1321">1321</a><td> */<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td>goog.string.hashCode = function(str) {<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td>  var result = 0;<tr><td><a id="l1324"></a><a href="#l1324">1324</a><td>  for (var i = 0; i &lt; str.length; ++i) {<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td>    // Normalize to 4 byte range, 0 ... 2^32.<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td>    result = (31 * result + str.charCodeAt(i)) &gt;&gt;&gt; 0;<tr><td><a id="l1327"></a><a href="#l1327">1327</a><td>  }<tr><td><a id="l1328"></a><a href="#l1328">1328</a><td>  return result;<tr><td><a id="l1329"></a><a href="#l1329">1329</a><td>};<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td><tr><td><a id="l1331"></a><a href="#l1331">1331</a><td><tr><td><a id="l1332"></a><a href="#l1332">1332</a><td>/**<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td> * The most recent unique ID. |0 is equivalent to Math.floor in this case.<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td> * @type {number}<tr><td><a id="l1335"></a><a href="#l1335">1335</a><td> * @private<tr><td><a id="l1336"></a><a href="#l1336">1336</a><td> */<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td>goog.string.uniqueStringCounter_ = Math.random() * 0x80000000 | 0;<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td><tr><td><a id="l1339"></a><a href="#l1339">1339</a><td><tr><td><a id="l1340"></a><a href="#l1340">1340</a><td>/**<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td> * Generates and returns a string which is unique in the current document.<tr><td><a id="l1342"></a><a href="#l1342">1342</a><td> * This is useful, for example, to create unique IDs for DOM elements.<tr><td><a id="l1343"></a><a href="#l1343">1343</a><td> * @return {string} A unique id.<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td> */<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td>goog.string.createUniqueString = function() {<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td>  return &#39;goog_&#39; + goog.string.uniqueStringCounter_++;<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td>};<tr><td><a id="l1348"></a><a href="#l1348">1348</a><td><tr><td><a id="l1349"></a><a href="#l1349">1349</a><td><tr><td><a id="l1350"></a><a href="#l1350">1350</a><td>/**<tr><td><a id="l1351"></a><a href="#l1351">1351</a><td> * Converts the supplied string to a number, which may be Infinity or NaN.<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td> * This function strips whitespace: (toNumber(&#39; 123&#39;) === 123)<tr><td><a id="l1353"></a><a href="#l1353">1353</a><td> * This function accepts scientific notation: (toNumber(&#39;1e1&#39;) === 10)<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td> *<tr><td><a id="l1355"></a><a href="#l1355">1355</a><td> * This is better than Javascript&#39;s built-in conversions because, sadly:<tr><td><a id="l1356"></a><a href="#l1356">1356</a><td> *     (Number(&#39; &#39;) === 0) and (parseFloat(&#39;123a&#39;) === 123)<tr><td><a id="l1357"></a><a href="#l1357">1357</a><td> *<tr><td><a id="l1358"></a><a href="#l1358">1358</a><td> * @param {string} str The string to convert.<tr><td><a id="l1359"></a><a href="#l1359">1359</a><td> * @return {number} The number the supplied string represents, or NaN.<tr><td><a id="l1360"></a><a href="#l1360">1360</a><td> */<tr><td><a id="l1361"></a><a href="#l1361">1361</a><td>goog.string.toNumber = function(str) {<tr><td><a id="l1362"></a><a href="#l1362">1362</a><td>  var num = Number(str);<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td>  if (num == 0 &amp;&amp; goog.string.isEmptyOrWhitespace(str)) {<tr><td><a id="l1364"></a><a href="#l1364">1364</a><td>    return NaN;<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td>  }<tr><td><a id="l1366"></a><a href="#l1366">1366</a><td>  return num;<tr><td><a id="l1367"></a><a href="#l1367">1367</a><td>};<tr><td><a id="l1368"></a><a href="#l1368">1368</a><td><tr><td><a id="l1369"></a><a href="#l1369">1369</a><td><tr><td><a id="l1370"></a><a href="#l1370">1370</a><td>/**<tr><td><a id="l1371"></a><a href="#l1371">1371</a><td> * Returns whether the given string is lower camel case (e.g. &quot;isFooBar&quot;).<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td> *<tr><td><a id="l1373"></a><a href="#l1373">1373</a><td> * Note that this assumes the string is entirely letters.<tr><td><a id="l1374"></a><a href="#l1374">1374</a><td> * @see http://en.wikipedia.org/wiki/CamelCase#Variations_and_synonyms<tr><td><a id="l1375"></a><a href="#l1375">1375</a><td> *<tr><td><a id="l1376"></a><a href="#l1376">1376</a><td> * @param {string} str String to test.<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td> * @return {boolean} Whether the string is lower camel case.<tr><td><a id="l1378"></a><a href="#l1378">1378</a><td> */<tr><td><a id="l1379"></a><a href="#l1379">1379</a><td>goog.string.isLowerCamelCase = function(str) {<tr><td><a id="l1380"></a><a href="#l1380">1380</a><td>  return /^[a-z]+([A-Z][a-z]*)*$/.test(str);<tr><td><a id="l1381"></a><a href="#l1381">1381</a><td>};<tr><td><a id="l1382"></a><a href="#l1382">1382</a><td><tr><td><a id="l1383"></a><a href="#l1383">1383</a><td><tr><td><a id="l1384"></a><a href="#l1384">1384</a><td>/**<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td> * Returns whether the given string is upper camel case (e.g. &quot;FooBarBaz&quot;).<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td> *<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td> * Note that this assumes the string is entirely letters.<tr><td><a id="l1388"></a><a href="#l1388">1388</a><td> * @see http://en.wikipedia.org/wiki/CamelCase#Variations_and_synonyms<tr><td><a id="l1389"></a><a href="#l1389">1389</a><td> *<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td> * @param {string} str String to test.<tr><td><a id="l1391"></a><a href="#l1391">1391</a><td> * @return {boolean} Whether the string is upper camel case.<tr><td><a id="l1392"></a><a href="#l1392">1392</a><td> */<tr><td><a id="l1393"></a><a href="#l1393">1393</a><td>goog.string.isUpperCamelCase = function(str) {<tr><td><a id="l1394"></a><a href="#l1394">1394</a><td>  return /^([A-Z][a-z]*)+$/.test(str);<tr><td><a id="l1395"></a><a href="#l1395">1395</a><td>};<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td><tr><td><a id="l1397"></a><a href="#l1397">1397</a><td><tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>/**<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td> * Converts a string from selector-case to camelCase (e.g. from<tr><td><a id="l1400"></a><a href="#l1400">1400</a><td> * &quot;multi-part-string&quot; to &quot;multiPartString&quot;), useful for converting<tr><td><a id="l1401"></a><a href="#l1401">1401</a><td> * CSS selectors and HTML dataset keys to their equivalent JS properties.<tr><td><a id="l1402"></a><a href="#l1402">1402</a><td> * @param {string} str The string in selector-case form.<tr><td><a id="l1403"></a><a href="#l1403">1403</a><td> * @return {string} The string in camelCase form.<tr><td><a id="l1404"></a><a href="#l1404">1404</a><td> */<tr><td><a id="l1405"></a><a href="#l1405">1405</a><td>goog.string.toCamelCase = function(str) {<tr><td><a id="l1406"></a><a href="#l1406">1406</a><td>  return String(str).replace(/\-([a-z])/g, function(all, match) {<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td>    return match.toUpperCase();<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td>  });<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td>};<tr><td><a id="l1410"></a><a href="#l1410">1410</a><td><tr><td><a id="l1411"></a><a href="#l1411">1411</a><td><tr><td><a id="l1412"></a><a href="#l1412">1412</a><td>/**<tr><td><a id="l1413"></a><a href="#l1413">1413</a><td> * Converts a string from camelCase to selector-case (e.g. from<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td> * &quot;multiPartString&quot; to &quot;multi-part-string&quot;), useful for converting JS<tr><td><a id="l1415"></a><a href="#l1415">1415</a><td> * style and dataset properties to equivalent CSS selectors and HTML keys.<tr><td><a id="l1416"></a><a href="#l1416">1416</a><td> * @param {string} str The string in camelCase form.<tr><td><a id="l1417"></a><a href="#l1417">1417</a><td> * @return {string} The string in selector-case form.<tr><td><a id="l1418"></a><a href="#l1418">1418</a><td> */<tr><td><a id="l1419"></a><a href="#l1419">1419</a><td>goog.string.toSelectorCase = function(str) {<tr><td><a id="l1420"></a><a href="#l1420">1420</a><td>  return String(str).replace(/([A-Z])/g, &#39;-$1&#39;).toLowerCase();<tr><td><a id="l1421"></a><a href="#l1421">1421</a><td>};<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td><tr><td><a id="l1423"></a><a href="#l1423">1423</a><td><tr><td><a id="l1424"></a><a href="#l1424">1424</a><td>/**<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td> * Converts a string into TitleCase. First character of the string is always<tr><td><a id="l1426"></a><a href="#l1426">1426</a><td> * capitalized in addition to the first letter of every subsequent word.<tr><td><a id="l1427"></a><a href="#l1427">1427</a><td> * Words are delimited by one or more whitespaces by default. Custom delimiters<tr><td><a id="l1428"></a><a href="#l1428">1428</a><td> * can optionally be specified to replace the default, which doesn&#39;t preserve<tr><td><a id="l1429"></a><a href="#l1429">1429</a><td> * whitespace delimiters and instead must be explicitly included if needed.<tr><td><a id="l1430"></a><a href="#l1430">1430</a><td> *<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td> * Default delimiter =&gt; &quot; &quot;:<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td> *    goog.string.toTitleCase(&#39;oneTwoThree&#39;)    =&gt; &#39;OneTwoThree&#39;<tr><td><a id="l1433"></a><a href="#l1433">1433</a><td> *    goog.string.toTitleCase(&#39;one two three&#39;)  =&gt; &#39;One Two Three&#39;<tr><td><a id="l1434"></a><a href="#l1434">1434</a><td> *    goog.string.toTitleCase(&#39;  one   two   &#39;) =&gt; &#39;  One   Two   &#39;<tr><td><a id="l1435"></a><a href="#l1435">1435</a><td> *    goog.string.toTitleCase(&#39;one_two_three&#39;)  =&gt; &#39;One_two_three&#39;<tr><td><a id="l1436"></a><a href="#l1436">1436</a><td> *    goog.string.toTitleCase(&#39;one-two-three&#39;)  =&gt; &#39;One-two-three&#39;<tr><td><a id="l1437"></a><a href="#l1437">1437</a><td> *<tr><td><a id="l1438"></a><a href="#l1438">1438</a><td> * Custom delimiter =&gt; &quot;_-.&quot;:<tr><td><a id="l1439"></a><a href="#l1439">1439</a><td> *    goog.string.toTitleCase(&#39;oneTwoThree&#39;, &#39;_-.&#39;)       =&gt; &#39;OneTwoThree&#39;<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td> *    goog.string.toTitleCase(&#39;one two three&#39;, &#39;_-.&#39;)     =&gt; &#39;One two three&#39;<tr><td><a id="l1441"></a><a href="#l1441">1441</a><td> *    goog.string.toTitleCase(&#39;  one   two   &#39;, &#39;_-.&#39;)    =&gt; &#39;  one   two   &#39;<tr><td><a id="l1442"></a><a href="#l1442">1442</a><td> *    goog.string.toTitleCase(&#39;one_two_three&#39;, &#39;_-.&#39;)     =&gt; &#39;One_Two_Three&#39;<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td> *    goog.string.toTitleCase(&#39;one-two-three&#39;, &#39;_-.&#39;)     =&gt; &#39;One-Two-Three&#39;<tr><td><a id="l1444"></a><a href="#l1444">1444</a><td> *    goog.string.toTitleCase(&#39;one...two...three&#39;, &#39;_-.&#39;) =&gt; &#39;One...Two...Three&#39;<tr><td><a id="l1445"></a><a href="#l1445">1445</a><td> *    goog.string.toTitleCase(&#39;one. two. three&#39;, &#39;_-.&#39;)   =&gt; &#39;One. two. three&#39;<tr><td><a id="l1446"></a><a href="#l1446">1446</a><td> *    goog.string.toTitleCase(&#39;one-two.three&#39;, &#39;_-.&#39;)     =&gt; &#39;One-Two.Three&#39;<tr><td><a id="l1447"></a><a href="#l1447">1447</a><td> *<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td> * @param {string} str String value in camelCase form.<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td> * @param {string=} opt_delimiters Custom delimiter character set used to<tr><td><a id="l1450"></a><a href="#l1450">1450</a><td> *      distinguish words in the string value. Each character represents a<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td> *      single delimiter. When provided, default whitespace delimiter is<tr><td><a id="l1452"></a><a href="#l1452">1452</a><td> *      overridden and must be explicitly included if needed.<tr><td><a id="l1453"></a><a href="#l1453">1453</a><td> * @return {string} String value in TitleCase form.<tr><td><a id="l1454"></a><a href="#l1454">1454</a><td> */<tr><td><a id="l1455"></a><a href="#l1455">1455</a><td>goog.string.toTitleCase = function(str, opt_delimiters) {<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td>  var delimiters = goog.isString(opt_delimiters) ?<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td>      goog.string.regExpEscape(opt_delimiters) : &#39;\\s&#39;;<tr><td><a id="l1458"></a><a href="#l1458">1458</a><td><tr><td><a id="l1459"></a><a href="#l1459">1459</a><td>  // For IE8, we need to prevent using an empty character set. Otherwise,<tr><td><a id="l1460"></a><a href="#l1460">1460</a><td>  // incorrect matching will occur.<tr><td><a id="l1461"></a><a href="#l1461">1461</a><td>  delimiters = delimiters ? &#39;|[&#39; + delimiters + &#39;]+&#39; : &#39;&#39;;<tr><td><a id="l1462"></a><a href="#l1462">1462</a><td><tr><td><a id="l1463"></a><a href="#l1463">1463</a><td>  var regexp = new RegExp(&#39;(^&#39; + delimiters + &#39;)([a-z])&#39;, &#39;g&#39;);<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td>  return str.replace(regexp, function(all, p1, p2) {<tr><td><a id="l1465"></a><a href="#l1465">1465</a><td>    return p1 + p2.toUpperCase();<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td>  });<tr><td><a id="l1467"></a><a href="#l1467">1467</a><td>};<tr><td><a id="l1468"></a><a href="#l1468">1468</a><td><tr><td><a id="l1469"></a><a href="#l1469">1469</a><td><tr><td><a id="l1470"></a><a href="#l1470">1470</a><td>/**<tr><td><a id="l1471"></a><a href="#l1471">1471</a><td> * Capitalizes a string, i.e. converts the first letter to uppercase<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td> * and all other letters to lowercase, e.g.:<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td> *<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td> * goog.string.capitalize(&#39;one&#39;)     =&gt; &#39;One&#39;<tr><td><a id="l1475"></a><a href="#l1475">1475</a><td> * goog.string.capitalize(&#39;ONE&#39;)     =&gt; &#39;One&#39;<tr><td><a id="l1476"></a><a href="#l1476">1476</a><td> * goog.string.capitalize(&#39;one two&#39;) =&gt; &#39;One two&#39;<tr><td><a id="l1477"></a><a href="#l1477">1477</a><td> *<tr><td><a id="l1478"></a><a href="#l1478">1478</a><td> * Note that this function does not trim initial whitespace.<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td> *<tr><td><a id="l1480"></a><a href="#l1480">1480</a><td> * @param {string} str String value to capitalize.<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td> * @return {string} String value with first letter in uppercase.<tr><td><a id="l1482"></a><a href="#l1482">1482</a><td> */<tr><td><a id="l1483"></a><a href="#l1483">1483</a><td>goog.string.capitalize = function(str) {<tr><td><a id="l1484"></a><a href="#l1484">1484</a><td>  return String(str.charAt(0)).toUpperCase() +<tr><td><a id="l1485"></a><a href="#l1485">1485</a><td>      String(str.substr(1)).toLowerCase();<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td>};<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td><tr><td><a id="l1488"></a><a href="#l1488">1488</a><td><tr><td><a id="l1489"></a><a href="#l1489">1489</a><td>/**<tr><td><a id="l1490"></a><a href="#l1490">1490</a><td> * Parse a string in decimal or hexidecimal (&#39;0xFFFF&#39;) form.<tr><td><a id="l1491"></a><a href="#l1491">1491</a><td> *<tr><td><a id="l1492"></a><a href="#l1492">1492</a><td> * To parse a particular radix, please use parseInt(string, radix) directly. See<tr><td><a id="l1493"></a><a href="#l1493">1493</a><td> * https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/parseInt<tr><td><a id="l1494"></a><a href="#l1494">1494</a><td> *<tr><td><a id="l1495"></a><a href="#l1495">1495</a><td> * This is a wrapper for the built-in parseInt function that will only parse<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td> * numbers as base 10 or base 16.  Some JS implementations assume strings<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td> * starting with &quot;0&quot; are intended to be octal. ES3 allowed but discouraged<tr><td><a id="l1498"></a><a href="#l1498">1498</a><td> * this behavior. ES5 forbids it.  This function emulates the ES5 behavior.<tr><td><a id="l1499"></a><a href="#l1499">1499</a><td> *<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td> * For more information, see Mozilla JS Reference: http://goo.gl/8RiFj<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td> *<tr><td><a id="l1502"></a><a href="#l1502">1502</a><td> * @param {string|number|null|undefined} value The value to be parsed.<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td> * @return {number} The number, parsed. If the string failed to parse, this<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td> *     will be NaN.<tr><td><a id="l1505"></a><a href="#l1505">1505</a><td> */<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td>goog.string.parseInt = function(value) {<tr><td><a id="l1507"></a><a href="#l1507">1507</a><td>  // Force finite numbers to strings.<tr><td><a id="l1508"></a><a href="#l1508">1508</a><td>  if (isFinite(value)) {<tr><td><a id="l1509"></a><a href="#l1509">1509</a><td>    value = String(value);<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td>  }<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td><tr><td><a id="l1512"></a><a href="#l1512">1512</a><td>  if (goog.isString(value)) {<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td>    // If the string starts with &#39;0x&#39; or &#39;-0x&#39;, parse as hex.<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td>    return /^\s*-?0x/i.test(value) ?<tr><td><a id="l1515"></a><a href="#l1515">1515</a><td>        parseInt(value, 16) : parseInt(value, 10);<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>  }<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td><tr><td><a id="l1518"></a><a href="#l1518">1518</a><td>  return NaN;<tr><td><a id="l1519"></a><a href="#l1519">1519</a><td>};<tr><td><a id="l1520"></a><a href="#l1520">1520</a><td><tr><td><a id="l1521"></a><a href="#l1521">1521</a><td><tr><td><a id="l1522"></a><a href="#l1522">1522</a><td>/**<tr><td><a id="l1523"></a><a href="#l1523">1523</a><td> * Splits a string on a separator a limited number of times.<tr><td><a id="l1524"></a><a href="#l1524">1524</a><td> *<tr><td><a id="l1525"></a><a href="#l1525">1525</a><td> * This implementation is more similar to Python or Java, where the limit<tr><td><a id="l1526"></a><a href="#l1526">1526</a><td> * parameter specifies the maximum number of splits rather than truncating<tr><td><a id="l1527"></a><a href="#l1527">1527</a><td> * the number of results.<tr><td><a id="l1528"></a><a href="#l1528">1528</a><td> *<tr><td><a id="l1529"></a><a href="#l1529">1529</a><td> * See http://docs.python.org/2/library/stdtypes.html#str.split<tr><td><a id="l1530"></a><a href="#l1530">1530</a><td> * See JavaDoc: http://goo.gl/F2AsY<tr><td><a id="l1531"></a><a href="#l1531">1531</a><td> * See Mozilla reference: http://goo.gl/dZdZs<tr><td><a id="l1532"></a><a href="#l1532">1532</a><td> *<tr><td><a id="l1533"></a><a href="#l1533">1533</a><td> * @param {string} str String to split.<tr><td><a id="l1534"></a><a href="#l1534">1534</a><td> * @param {string} separator The separator.<tr><td><a id="l1535"></a><a href="#l1535">1535</a><td> * @param {number} limit The limit to the number of splits. The resulting array<tr><td><a id="l1536"></a><a href="#l1536">1536</a><td> *     will have a maximum length of limit+1.  Negative numbers are the same<tr><td><a id="l1537"></a><a href="#l1537">1537</a><td> *     as zero.<tr><td><a id="l1538"></a><a href="#l1538">1538</a><td> * @return {!Array&lt;string&gt;} The string, split.<tr><td><a id="l1539"></a><a href="#l1539">1539</a><td> */<tr><td><a id="l1540"></a><a href="#l1540">1540</a><td><tr><td><a id="l1541"></a><a href="#l1541">1541</a><td>goog.string.splitLimit = function(str, separator, limit) {<tr><td><a id="l1542"></a><a href="#l1542">1542</a><td>  var parts = str.split(separator);<tr><td><a id="l1543"></a><a href="#l1543">1543</a><td>  var returnVal = [];<tr><td><a id="l1544"></a><a href="#l1544">1544</a><td><tr><td><a id="l1545"></a><a href="#l1545">1545</a><td>  // Only continue doing this while we haven&#39;t hit the limit and we have<tr><td><a id="l1546"></a><a href="#l1546">1546</a><td>  // parts left.<tr><td><a id="l1547"></a><a href="#l1547">1547</a><td>  while (limit &gt; 0 &amp;&amp; parts.length) {<tr><td><a id="l1548"></a><a href="#l1548">1548</a><td>    returnVal.push(parts.shift());<tr><td><a id="l1549"></a><a href="#l1549">1549</a><td>    limit--;<tr><td><a id="l1550"></a><a href="#l1550">1550</a><td>  }<tr><td><a id="l1551"></a><a href="#l1551">1551</a><td><tr><td><a id="l1552"></a><a href="#l1552">1552</a><td>  // If there are remaining parts, append them to the end.<tr><td><a id="l1553"></a><a href="#l1553">1553</a><td>  if (parts.length) {<tr><td><a id="l1554"></a><a href="#l1554">1554</a><td>    returnVal.push(parts.join(separator));<tr><td><a id="l1555"></a><a href="#l1555">1555</a><td>  }<tr><td><a id="l1556"></a><a href="#l1556">1556</a><td><tr><td><a id="l1557"></a><a href="#l1557">1557</a><td>  return returnVal;<tr><td><a id="l1558"></a><a href="#l1558">1558</a><td>};<tr><td><a id="l1559"></a><a href="#l1559">1559</a><td><tr><td><a id="l1560"></a><a href="#l1560">1560</a><td><tr><td><a id="l1561"></a><a href="#l1561">1561</a><td>/**<tr><td><a id="l1562"></a><a href="#l1562">1562</a><td> * Computes the Levenshtein edit distance between two strings.<tr><td><a id="l1563"></a><a href="#l1563">1563</a><td> * @param {string} a<tr><td><a id="l1564"></a><a href="#l1564">1564</a><td> * @param {string} b<tr><td><a id="l1565"></a><a href="#l1565">1565</a><td> * @return {number} The edit distance between the two strings.<tr><td><a id="l1566"></a><a href="#l1566">1566</a><td> */<tr><td><a id="l1567"></a><a href="#l1567">1567</a><td>goog.string.editDistance = function(a, b) {<tr><td><a id="l1568"></a><a href="#l1568">1568</a><td>  var v0 = [];<tr><td><a id="l1569"></a><a href="#l1569">1569</a><td>  var v1 = [];<tr><td><a id="l1570"></a><a href="#l1570">1570</a><td><tr><td><a id="l1571"></a><a href="#l1571">1571</a><td>  if (a == b) {<tr><td><a id="l1572"></a><a href="#l1572">1572</a><td>    return 0;<tr><td><a id="l1573"></a><a href="#l1573">1573</a><td>  }<tr><td><a id="l1574"></a><a href="#l1574">1574</a><td><tr><td><a id="l1575"></a><a href="#l1575">1575</a><td>  if (!a.length || !b.length) {<tr><td><a id="l1576"></a><a href="#l1576">1576</a><td>    return Math.max(a.length, b.length);<tr><td><a id="l1577"></a><a href="#l1577">1577</a><td>  }<tr><td><a id="l1578"></a><a href="#l1578">1578</a><td><tr><td><a id="l1579"></a><a href="#l1579">1579</a><td>  for (var i = 0; i &lt; b.length + 1; i++) {<tr><td><a id="l1580"></a><a href="#l1580">1580</a><td>    v0[i] = i;<tr><td><a id="l1581"></a><a href="#l1581">1581</a><td>  }<tr><td><a id="l1582"></a><a href="#l1582">1582</a><td><tr><td><a id="l1583"></a><a href="#l1583">1583</a><td>  for (var i = 0; i &lt; a.length; i++) {<tr><td><a id="l1584"></a><a href="#l1584">1584</a><td>    v1[0] = i + 1;<tr><td><a id="l1585"></a><a href="#l1585">1585</a><td><tr><td><a id="l1586"></a><a href="#l1586">1586</a><td>    for (var j = 0; j &lt; b.length; j++) {<tr><td><a id="l1587"></a><a href="#l1587">1587</a><td>      var cost = a[i] != b[j];<tr><td><a id="l1588"></a><a href="#l1588">1588</a><td>      // Cost for the substring is the minimum of adding one character, removing<tr><td><a id="l1589"></a><a href="#l1589">1589</a><td>      // one character, or a swap.<tr><td><a id="l1590"></a><a href="#l1590">1590</a><td>      v1[j + 1] = Math.min(v1[j] + 1, v0[j + 1] + 1, v0[j] + cost);<tr><td><a id="l1591"></a><a href="#l1591">1591</a><td>    }<tr><td><a id="l1592"></a><a href="#l1592">1592</a><td><tr><td><a id="l1593"></a><a href="#l1593">1593</a><td>    for (var j = 0; j &lt; v0.length; j++) {<tr><td><a id="l1594"></a><a href="#l1594">1594</a><td>      v0[j] = v1[j];<tr><td><a id="l1595"></a><a href="#l1595">1595</a><td>    }<tr><td><a id="l1596"></a><a href="#l1596">1596</a><td>  }<tr><td><a id="l1597"></a><a href="#l1597">1597</a><td><tr><td><a id="l1598"></a><a href="#l1598">1598</a><td>  return v1[b.length];<tr><td><a id="l1599"></a><a href="#l1599">1599</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/string/typedstring.js.src.html b/docs/source/lib/goog/string/typedstring.js.src.html
new file mode 100644
index 0000000..55103fb
--- /dev/null
+++ b/docs/source/lib/goog/string/typedstring.js.src.html
@@ -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>typedstring.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/string/typedstring.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.string.TypedString&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td><tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td><tr><td><a id="l19"></a><a href="#l19">19</a><td>/**<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Wrapper for strings that conform to a data type or language.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Implementations of this interface are wrappers for strings, and typically<tr><td><a id="l23"></a><a href="#l23">23</a><td> * associate a type contract with the wrapped string.  Concrete implementations<tr><td><a id="l24"></a><a href="#l24">24</a><td> * of this interface may choose to implement additional run-time type checking,<tr><td><a id="l25"></a><a href="#l25">25</a><td> * see for example {@code goog.html.SafeHtml}. If available, client code that<tr><td><a id="l26"></a><a href="#l26">26</a><td> * needs to ensure type membership of an object should use the type&#39;s function<tr><td><a id="l27"></a><a href="#l27">27</a><td> * to assert type membership, such as {@code goog.html.SafeHtml.unwrap}.<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @interface<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.string.TypedString = function() {};<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>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * Interface marker of the TypedString interface.<tr><td><a id="l35"></a><a href="#l35">35</a><td> *<tr><td><a id="l36"></a><a href="#l36">36</a><td> * This property can be used to determine at runtime whether or not an object<tr><td><a id="l37"></a><a href="#l37">37</a><td> * implements this interface.  All implementations of this interface set this<tr><td><a id="l38"></a><a href="#l38">38</a><td> * property to {@code true}.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @type {boolean}<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.string.TypedString.prototype.implementsGoogStringTypedString;<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> * Retrieves this wrapped string&#39;s value.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @return {!string} The wrapped string&#39;s value.<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.string.TypedString.prototype.getTypedStringValue;</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/structs/collection.js.src.html b/docs/source/lib/goog/structs/collection.js.src.html
new file mode 100644
index 0000000..59ede41
--- /dev/null
+++ b/docs/source/lib/goog/structs/collection.js.src.html
@@ -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>collection.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/structs/collection.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2011 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Defines the collection interface.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author nnaze@google.com (Nathan Naze)<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.structs.Collection&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>/**<tr><td><a id="l26"></a><a href="#l26">26</a><td> * An interface for a collection of values.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @interface<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @template T<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.structs.Collection = function() {};<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>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {T} value Value to add to the collection.<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.structs.Collection.prototype.add;<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> * @param {T} value Value to remove from the collection.<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.structs.Collection.prototype.remove;<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @param {T} value Value to find in the collection.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @return {boolean} Whether the collection contains the specified value.<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.structs.Collection.prototype.contains;<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>/**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @return {number} The number of values stored in the collection.<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.structs.Collection.prototype.getCount;<tr><td><a id="l56"></a><a href="#l56">56</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/structs/map.js.src.html b/docs/source/lib/goog/structs/map.js.src.html
index c9ff1a7..3b86438 100644
--- a/docs/source/lib/goog/structs/map.js.src.html
+++ b/docs/source/lib/goog/structs/map.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>map.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/structs/map.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Datastructure: Hash Map.<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a name="l19" href="#l19">19</a><td> * @author jonp@google.com (Jon Perlow) Optimized for IE6<tr><td><a name="l20" href="#l20">20</a><td> *<tr><td><a name="l21" href="#l21">21</a><td> * This file contains an implementation of a Map structure. It implements a lot<tr><td><a name="l22" href="#l22">22</a><td> * of the methods used in goog.structs so those functions work on hashes. This<tr><td><a name="l23" href="#l23">23</a><td> * is best suited for complex key types. For simple keys such as numbers and<tr><td><a name="l24" href="#l24">24</a><td> * strings, and where special names like __proto__ are not a concern, consider<tr><td><a name="l25" href="#l25">25</a><td> * using the lighter-weight utilities in goog.object.<tr><td><a name="l26" href="#l26">26</a><td> */<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td>goog.provide(&#39;goog.structs.Map&#39;);<tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>goog.require(&#39;goog.iter.Iterator&#39;);<tr><td><a name="l32" href="#l32">32</a><td>goog.require(&#39;goog.iter.StopIteration&#39;);<tr><td><a name="l33" href="#l33">33</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td>/**<tr><td><a name="l38" href="#l38">38</a><td> * Class for Hash Map datastructure.<tr><td><a name="l39" href="#l39">39</a><td> * @param {*=} opt_map Map or Object to initialize the map with.<tr><td><a name="l40" href="#l40">40</a><td> * @param {...*} var_args If 2 or more arguments are present then they<tr><td><a name="l41" href="#l41">41</a><td> *     will be used as key-value pairs.<tr><td><a name="l42" href="#l42">42</a><td> * @constructor<tr><td><a name="l43" href="#l43">43</a><td> */<tr><td><a name="l44" href="#l44">44</a><td>goog.structs.Map = function(opt_map, var_args) {<tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td>  /**<tr><td><a name="l47" href="#l47">47</a><td>   * Underlying JS object used to implement the map.<tr><td><a name="l48" href="#l48">48</a><td>   * @type {!Object}<tr><td><a name="l49" href="#l49">49</a><td>   * @private<tr><td><a name="l50" href="#l50">50</a><td>   */<tr><td><a name="l51" href="#l51">51</a><td>  this.map_ = {};<tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>  /**<tr><td><a name="l54" href="#l54">54</a><td>   * An array of keys. This is necessary for two reasons:<tr><td><a name="l55" href="#l55">55</a><td>   *   1. Iterating the keys using for (var key in this.map_) allocates an<tr><td><a name="l56" href="#l56">56</a><td>   *      object for every key in IE which is really bad for IE6 GC perf.<tr><td><a name="l57" href="#l57">57</a><td>   *   2. Without a side data structure, we would need to escape all the keys<tr><td><a name="l58" href="#l58">58</a><td>   *      as that would be the only way we could tell during iteration if the<tr><td><a name="l59" href="#l59">59</a><td>   *      key was an internal key or a property of the object.<tr><td><a name="l60" href="#l60">60</a><td>   *<tr><td><a name="l61" href="#l61">61</a><td>   * This array can contain deleted keys so it&#39;s necessary to check the map<tr><td><a name="l62" href="#l62">62</a><td>   * as well to see if the key is still in the map (this doesn&#39;t require a<tr><td><a name="l63" href="#l63">63</a><td>   * memory allocation in IE).<tr><td><a name="l64" href="#l64">64</a><td>   * @type {!Array.&lt;string&gt;}<tr><td><a name="l65" href="#l65">65</a><td>   * @private<tr><td><a name="l66" href="#l66">66</a><td>   */<tr><td><a name="l67" href="#l67">67</a><td>  this.keys_ = [];<tr><td><a name="l68" href="#l68">68</a><td><tr><td><a name="l69" href="#l69">69</a><td>  var argLength = arguments.length;<tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td>  if (argLength &gt; 1) {<tr><td><a name="l72" href="#l72">72</a><td>    if (argLength % 2) {<tr><td><a name="l73" href="#l73">73</a><td>      throw Error(&#39;Uneven number of arguments&#39;);<tr><td><a name="l74" href="#l74">74</a><td>    }<tr><td><a name="l75" href="#l75">75</a><td>    for (var i = 0; i &lt; argLength; i += 2) {<tr><td><a name="l76" href="#l76">76</a><td>      this.set(arguments[i], arguments[i + 1]);<tr><td><a name="l77" href="#l77">77</a><td>    }<tr><td><a name="l78" href="#l78">78</a><td>  } else if (opt_map) {<tr><td><a name="l79" href="#l79">79</a><td>    this.addAll(/** @type {Object} */ (opt_map));<tr><td><a name="l80" href="#l80">80</a><td>  }<tr><td><a name="l81" href="#l81">81</a><td>};<tr><td><a name="l82" href="#l82">82</a><td><tr><td><a name="l83" href="#l83">83</a><td><tr><td><a name="l84" href="#l84">84</a><td>/**<tr><td><a name="l85" href="#l85">85</a><td> * The number of key value pairs in the map.<tr><td><a name="l86" href="#l86">86</a><td> * @private<tr><td><a name="l87" href="#l87">87</a><td> * @type {number}<tr><td><a name="l88" href="#l88">88</a><td> */<tr><td><a name="l89" href="#l89">89</a><td>goog.structs.Map.prototype.count_ = 0;<tr><td><a name="l90" href="#l90">90</a><td><tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td>/**<tr><td><a name="l93" href="#l93">93</a><td> * Version used to detect changes while iterating.<tr><td><a name="l94" href="#l94">94</a><td> * @private<tr><td><a name="l95" href="#l95">95</a><td> * @type {number}<tr><td><a name="l96" href="#l96">96</a><td> */<tr><td><a name="l97" href="#l97">97</a><td>goog.structs.Map.prototype.version_ = 0;<tr><td><a name="l98" href="#l98">98</a><td><tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td>/**<tr><td><a name="l101" href="#l101">101</a><td> * @return {number} The number of key-value pairs in the map.<tr><td><a name="l102" href="#l102">102</a><td> */<tr><td><a name="l103" href="#l103">103</a><td>goog.structs.Map.prototype.getCount = function() {<tr><td><a name="l104" href="#l104">104</a><td>  return this.count_;<tr><td><a name="l105" href="#l105">105</a><td>};<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td>/**<tr><td><a name="l109" href="#l109">109</a><td> * Returns the values of the map.<tr><td><a name="l110" href="#l110">110</a><td> * @return {!Array} The values in the map.<tr><td><a name="l111" href="#l111">111</a><td> */<tr><td><a name="l112" href="#l112">112</a><td>goog.structs.Map.prototype.getValues = function() {<tr><td><a name="l113" href="#l113">113</a><td>  this.cleanupKeysArray_();<tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>  var rv = [];<tr><td><a name="l116" href="#l116">116</a><td>  for (var i = 0; i &lt; this.keys_.length; i++) {<tr><td><a name="l117" href="#l117">117</a><td>    var key = this.keys_[i];<tr><td><a name="l118" href="#l118">118</a><td>    rv.push(this.map_[key]);<tr><td><a name="l119" href="#l119">119</a><td>  }<tr><td><a name="l120" href="#l120">120</a><td>  return rv;<tr><td><a name="l121" href="#l121">121</a><td>};<tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td><tr><td><a name="l124" href="#l124">124</a><td>/**<tr><td><a name="l125" href="#l125">125</a><td> * Returns the keys of the map.<tr><td><a name="l126" href="#l126">126</a><td> * @return {!Array.&lt;string&gt;} Array of string values.<tr><td><a name="l127" href="#l127">127</a><td> */<tr><td><a name="l128" href="#l128">128</a><td>goog.structs.Map.prototype.getKeys = function() {<tr><td><a name="l129" href="#l129">129</a><td>  this.cleanupKeysArray_();<tr><td><a name="l130" href="#l130">130</a><td>  return /** @type {!Array.&lt;string&gt;} */ (this.keys_.concat());<tr><td><a name="l131" href="#l131">131</a><td>};<tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td>/**<tr><td><a name="l135" href="#l135">135</a><td> * Whether the map contains the given key.<tr><td><a name="l136" href="#l136">136</a><td> * @param {*} key The key to check for.<tr><td><a name="l137" href="#l137">137</a><td> * @return {boolean} Whether the map contains the key.<tr><td><a name="l138" href="#l138">138</a><td> */<tr><td><a name="l139" href="#l139">139</a><td>goog.structs.Map.prototype.containsKey = function(key) {<tr><td><a name="l140" href="#l140">140</a><td>  return goog.structs.Map.hasKey_(this.map_, key);<tr><td><a name="l141" href="#l141">141</a><td>};<tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td>/**<tr><td><a name="l145" href="#l145">145</a><td> * Whether the map contains the given value. This is O(n).<tr><td><a name="l146" href="#l146">146</a><td> * @param {*} val The value to check for.<tr><td><a name="l147" href="#l147">147</a><td> * @return {boolean} Whether the map contains the value.<tr><td><a name="l148" href="#l148">148</a><td> */<tr><td><a name="l149" href="#l149">149</a><td>goog.structs.Map.prototype.containsValue = function(val) {<tr><td><a name="l150" href="#l150">150</a><td>  for (var i = 0; i &lt; this.keys_.length; i++) {<tr><td><a name="l151" href="#l151">151</a><td>    var key = this.keys_[i];<tr><td><a name="l152" href="#l152">152</a><td>    if (goog.structs.Map.hasKey_(this.map_, key) &amp;&amp; this.map_[key] == val) {<tr><td><a name="l153" href="#l153">153</a><td>      return true;<tr><td><a name="l154" href="#l154">154</a><td>    }<tr><td><a name="l155" href="#l155">155</a><td>  }<tr><td><a name="l156" href="#l156">156</a><td>  return false;<tr><td><a name="l157" href="#l157">157</a><td>};<tr><td><a name="l158" href="#l158">158</a><td><tr><td><a name="l159" href="#l159">159</a><td><tr><td><a name="l160" href="#l160">160</a><td>/**<tr><td><a name="l161" href="#l161">161</a><td> * Whether this map is equal to the argument map.<tr><td><a name="l162" href="#l162">162</a><td> * @param {goog.structs.Map} otherMap The map against which to test equality.<tr><td><a name="l163" href="#l163">163</a><td> * @param {function(?, ?) : boolean=} opt_equalityFn Optional equality function<tr><td><a name="l164" href="#l164">164</a><td> *     to test equality of values. If not specified, this will test whether<tr><td><a name="l165" href="#l165">165</a><td> *     the values contained in each map are identical objects.<tr><td><a name="l166" href="#l166">166</a><td> * @return {boolean} Whether the maps are equal.<tr><td><a name="l167" href="#l167">167</a><td> */<tr><td><a name="l168" href="#l168">168</a><td>goog.structs.Map.prototype.equals = function(otherMap, opt_equalityFn) {<tr><td><a name="l169" href="#l169">169</a><td>  if (this === otherMap) {<tr><td><a name="l170" href="#l170">170</a><td>    return true;<tr><td><a name="l171" href="#l171">171</a><td>  }<tr><td><a name="l172" href="#l172">172</a><td><tr><td><a name="l173" href="#l173">173</a><td>  if (this.count_ != otherMap.getCount()) {<tr><td><a name="l174" href="#l174">174</a><td>    return false;<tr><td><a name="l175" href="#l175">175</a><td>  }<tr><td><a name="l176" href="#l176">176</a><td><tr><td><a name="l177" href="#l177">177</a><td>  var equalityFn = opt_equalityFn || goog.structs.Map.defaultEquals;<tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>  this.cleanupKeysArray_();<tr><td><a name="l180" href="#l180">180</a><td>  for (var key, i = 0; key = this.keys_[i]; i++) {<tr><td><a name="l181" href="#l181">181</a><td>    if (!equalityFn(this.get(key), otherMap.get(key))) {<tr><td><a name="l182" href="#l182">182</a><td>      return false;<tr><td><a name="l183" href="#l183">183</a><td>    }<tr><td><a name="l184" href="#l184">184</a><td>  }<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td>  return true;<tr><td><a name="l187" href="#l187">187</a><td>};<tr><td><a name="l188" href="#l188">188</a><td><tr><td><a name="l189" href="#l189">189</a><td><tr><td><a name="l190" href="#l190">190</a><td>/**<tr><td><a name="l191" href="#l191">191</a><td> * Default equality test for values.<tr><td><a name="l192" href="#l192">192</a><td> * @param {*} a The first value.<tr><td><a name="l193" href="#l193">193</a><td> * @param {*} b The second value.<tr><td><a name="l194" href="#l194">194</a><td> * @return {boolean} Whether a and b reference the same object.<tr><td><a name="l195" href="#l195">195</a><td> */<tr><td><a name="l196" href="#l196">196</a><td>goog.structs.Map.defaultEquals = function(a, b) {<tr><td><a name="l197" href="#l197">197</a><td>  return a === b;<tr><td><a name="l198" href="#l198">198</a><td>};<tr><td><a name="l199" href="#l199">199</a><td><tr><td><a name="l200" href="#l200">200</a><td><tr><td><a name="l201" href="#l201">201</a><td>/**<tr><td><a name="l202" href="#l202">202</a><td> * @return {boolean} Whether the map is empty.<tr><td><a name="l203" href="#l203">203</a><td> */<tr><td><a name="l204" href="#l204">204</a><td>goog.structs.Map.prototype.isEmpty = function() {<tr><td><a name="l205" href="#l205">205</a><td>  return this.count_ == 0;<tr><td><a name="l206" href="#l206">206</a><td>};<tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td><tr><td><a name="l209" href="#l209">209</a><td>/**<tr><td><a name="l210" href="#l210">210</a><td> * Removes all key-value pairs from the map.<tr><td><a name="l211" href="#l211">211</a><td> */<tr><td><a name="l212" href="#l212">212</a><td>goog.structs.Map.prototype.clear = function() {<tr><td><a name="l213" href="#l213">213</a><td>  this.map_ = {};<tr><td><a name="l214" href="#l214">214</a><td>  this.keys_.length = 0;<tr><td><a name="l215" href="#l215">215</a><td>  this.count_ = 0;<tr><td><a name="l216" href="#l216">216</a><td>  this.version_ = 0;<tr><td><a name="l217" href="#l217">217</a><td>};<tr><td><a name="l218" href="#l218">218</a><td><tr><td><a name="l219" href="#l219">219</a><td><tr><td><a name="l220" href="#l220">220</a><td>/**<tr><td><a name="l221" href="#l221">221</a><td> * Removes a key-value pair based on the key. This is O(logN) amortized due to<tr><td><a name="l222" href="#l222">222</a><td> * updating the keys array whenever the count becomes half the size of the keys<tr><td><a name="l223" href="#l223">223</a><td> * in the keys array.<tr><td><a name="l224" href="#l224">224</a><td> * @param {*} key  The key to remove.<tr><td><a name="l225" href="#l225">225</a><td> * @return {boolean} Whether object was removed.<tr><td><a name="l226" href="#l226">226</a><td> */<tr><td><a name="l227" href="#l227">227</a><td>goog.structs.Map.prototype.remove = function(key) {<tr><td><a name="l228" href="#l228">228</a><td>  if (goog.structs.Map.hasKey_(this.map_, key)) {<tr><td><a name="l229" href="#l229">229</a><td>    delete this.map_[key];<tr><td><a name="l230" href="#l230">230</a><td>    this.count_--;<tr><td><a name="l231" href="#l231">231</a><td>    this.version_++;<tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td>    // clean up the keys array if the threshhold is hit<tr><td><a name="l234" href="#l234">234</a><td>    if (this.keys_.length &gt; 2 * this.count_) {<tr><td><a name="l235" href="#l235">235</a><td>      this.cleanupKeysArray_();<tr><td><a name="l236" href="#l236">236</a><td>    }<tr><td><a name="l237" href="#l237">237</a><td><tr><td><a name="l238" href="#l238">238</a><td>    return true;<tr><td><a name="l239" href="#l239">239</a><td>  }<tr><td><a name="l240" href="#l240">240</a><td>  return false;<tr><td><a name="l241" href="#l241">241</a><td>};<tr><td><a name="l242" href="#l242">242</a><td><tr><td><a name="l243" href="#l243">243</a><td><tr><td><a name="l244" href="#l244">244</a><td>/**<tr><td><a name="l245" href="#l245">245</a><td> * Cleans up the temp keys array by removing entries that are no longer in the<tr><td><a name="l246" href="#l246">246</a><td> * map.<tr><td><a name="l247" href="#l247">247</a><td> * @private<tr><td><a name="l248" href="#l248">248</a><td> */<tr><td><a name="l249" href="#l249">249</a><td>goog.structs.Map.prototype.cleanupKeysArray_ = function() {<tr><td><a name="l250" href="#l250">250</a><td>  if (this.count_ != this.keys_.length) {<tr><td><a name="l251" href="#l251">251</a><td>    // First remove keys that are no longer in the map.<tr><td><a name="l252" href="#l252">252</a><td>    var srcIndex = 0;<tr><td><a name="l253" href="#l253">253</a><td>    var destIndex = 0;<tr><td><a name="l254" href="#l254">254</a><td>    while (srcIndex &lt; this.keys_.length) {<tr><td><a name="l255" href="#l255">255</a><td>      var key = this.keys_[srcIndex];<tr><td><a name="l256" href="#l256">256</a><td>      if (goog.structs.Map.hasKey_(this.map_, key)) {<tr><td><a name="l257" href="#l257">257</a><td>        this.keys_[destIndex++] = key;<tr><td><a name="l258" href="#l258">258</a><td>      }<tr><td><a name="l259" href="#l259">259</a><td>      srcIndex++;<tr><td><a name="l260" href="#l260">260</a><td>    }<tr><td><a name="l261" href="#l261">261</a><td>    this.keys_.length = destIndex;<tr><td><a name="l262" href="#l262">262</a><td>  }<tr><td><a name="l263" href="#l263">263</a><td><tr><td><a name="l264" href="#l264">264</a><td>  if (this.count_ != this.keys_.length) {<tr><td><a name="l265" href="#l265">265</a><td>    // If the count still isn&#39;t correct, that means we have duplicates. This can<tr><td><a name="l266" href="#l266">266</a><td>    // happen when the same key is added and removed multiple times. Now we have<tr><td><a name="l267" href="#l267">267</a><td>    // to allocate one extra Object to remove the duplicates. This could have<tr><td><a name="l268" href="#l268">268</a><td>    // been done in the first pass, but in the common case, we can avoid<tr><td><a name="l269" href="#l269">269</a><td>    // allocating an extra object by only doing this when necessary.<tr><td><a name="l270" href="#l270">270</a><td>    var seen = {};<tr><td><a name="l271" href="#l271">271</a><td>    var srcIndex = 0;<tr><td><a name="l272" href="#l272">272</a><td>    var destIndex = 0;<tr><td><a name="l273" href="#l273">273</a><td>    while (srcIndex &lt; this.keys_.length) {<tr><td><a name="l274" href="#l274">274</a><td>      var key = this.keys_[srcIndex];<tr><td><a name="l275" href="#l275">275</a><td>      if (!(goog.structs.Map.hasKey_(seen, key))) {<tr><td><a name="l276" href="#l276">276</a><td>        this.keys_[destIndex++] = key;<tr><td><a name="l277" href="#l277">277</a><td>        seen[key] = 1;<tr><td><a name="l278" href="#l278">278</a><td>      }<tr><td><a name="l279" href="#l279">279</a><td>      srcIndex++;<tr><td><a name="l280" href="#l280">280</a><td>    }<tr><td><a name="l281" href="#l281">281</a><td>    this.keys_.length = destIndex;<tr><td><a name="l282" href="#l282">282</a><td>  }<tr><td><a name="l283" href="#l283">283</a><td>};<tr><td><a name="l284" href="#l284">284</a><td><tr><td><a name="l285" href="#l285">285</a><td><tr><td><a name="l286" href="#l286">286</a><td>/**<tr><td><a name="l287" href="#l287">287</a><td> * Returns the value for the given key.  If the key is not found and the default<tr><td><a name="l288" href="#l288">288</a><td> * value is not given this will return {@code undefined}.<tr><td><a name="l289" href="#l289">289</a><td> * @param {*} key The key to get the value for.<tr><td><a name="l290" href="#l290">290</a><td> * @param {*=} opt_val The value to return if no item is found for the given<tr><td><a name="l291" href="#l291">291</a><td> *     key, defaults to undefined.<tr><td><a name="l292" href="#l292">292</a><td> * @return {*} The value for the given key.<tr><td><a name="l293" href="#l293">293</a><td> */<tr><td><a name="l294" href="#l294">294</a><td>goog.structs.Map.prototype.get = function(key, opt_val) {<tr><td><a name="l295" href="#l295">295</a><td>  if (goog.structs.Map.hasKey_(this.map_, key)) {<tr><td><a name="l296" href="#l296">296</a><td>    return this.map_[key];<tr><td><a name="l297" href="#l297">297</a><td>  }<tr><td><a name="l298" href="#l298">298</a><td>  return opt_val;<tr><td><a name="l299" href="#l299">299</a><td>};<tr><td><a name="l300" href="#l300">300</a><td><tr><td><a name="l301" href="#l301">301</a><td><tr><td><a name="l302" href="#l302">302</a><td>/**<tr><td><a name="l303" href="#l303">303</a><td> * Adds a key-value pair to the map.<tr><td><a name="l304" href="#l304">304</a><td> * @param {*} key The key.<tr><td><a name="l305" href="#l305">305</a><td> * @param {*} value The value to add.<tr><td><a name="l306" href="#l306">306</a><td> * @return {*} Some subclasses return a value.<tr><td><a name="l307" href="#l307">307</a><td> */<tr><td><a name="l308" href="#l308">308</a><td>goog.structs.Map.prototype.set = function(key, value) {<tr><td><a name="l309" href="#l309">309</a><td>  if (!(goog.structs.Map.hasKey_(this.map_, key))) {<tr><td><a name="l310" href="#l310">310</a><td>    this.count_++;<tr><td><a name="l311" href="#l311">311</a><td>    this.keys_.push(key);<tr><td><a name="l312" href="#l312">312</a><td>    // Only change the version if we add a new key.<tr><td><a name="l313" href="#l313">313</a><td>    this.version_++;<tr><td><a name="l314" href="#l314">314</a><td>  }<tr><td><a name="l315" href="#l315">315</a><td>  this.map_[key] = value;<tr><td><a name="l316" href="#l316">316</a><td>};<tr><td><a name="l317" href="#l317">317</a><td><tr><td><a name="l318" href="#l318">318</a><td><tr><td><a name="l319" href="#l319">319</a><td>/**<tr><td><a name="l320" href="#l320">320</a><td> * Adds multiple key-value pairs from another goog.structs.Map or Object.<tr><td><a name="l321" href="#l321">321</a><td> * @param {Object} map  Object containing the data to add.<tr><td><a name="l322" href="#l322">322</a><td> */<tr><td><a name="l323" href="#l323">323</a><td>goog.structs.Map.prototype.addAll = function(map) {<tr><td><a name="l324" href="#l324">324</a><td>  var keys, values;<tr><td><a name="l325" href="#l325">325</a><td>  if (map instanceof goog.structs.Map) {<tr><td><a name="l326" href="#l326">326</a><td>    keys = map.getKeys();<tr><td><a name="l327" href="#l327">327</a><td>    values = map.getValues();<tr><td><a name="l328" href="#l328">328</a><td>  } else {<tr><td><a name="l329" href="#l329">329</a><td>    keys = goog.object.getKeys(map);<tr><td><a name="l330" href="#l330">330</a><td>    values = goog.object.getValues(map);<tr><td><a name="l331" href="#l331">331</a><td>  }<tr><td><a name="l332" href="#l332">332</a><td>  // we could use goog.array.forEach here but I don&#39;t want to introduce that<tr><td><a name="l333" href="#l333">333</a><td>  // dependency just for this.<tr><td><a name="l334" href="#l334">334</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a name="l335" href="#l335">335</a><td>    this.set(keys[i], values[i]);<tr><td><a name="l336" href="#l336">336</a><td>  }<tr><td><a name="l337" href="#l337">337</a><td>};<tr><td><a name="l338" href="#l338">338</a><td><tr><td><a name="l339" href="#l339">339</a><td><tr><td><a name="l340" href="#l340">340</a><td>/**<tr><td><a name="l341" href="#l341">341</a><td> * Clones a map and returns a new map.<tr><td><a name="l342" href="#l342">342</a><td> * @return {!goog.structs.Map} A new map with the same key-value pairs.<tr><td><a name="l343" href="#l343">343</a><td> */<tr><td><a name="l344" href="#l344">344</a><td>goog.structs.Map.prototype.clone = function() {<tr><td><a name="l345" href="#l345">345</a><td>  return new goog.structs.Map(this);<tr><td><a name="l346" href="#l346">346</a><td>};<tr><td><a name="l347" href="#l347">347</a><td><tr><td><a name="l348" href="#l348">348</a><td><tr><td><a name="l349" href="#l349">349</a><td>/**<tr><td><a name="l350" href="#l350">350</a><td> * Returns a new map in which all the keys and values are interchanged<tr><td><a name="l351" href="#l351">351</a><td> * (keys become values and values become keys). If multiple keys map to the<tr><td><a name="l352" href="#l352">352</a><td> * same value, the chosen transposed value is implementation-dependent.<tr><td><a name="l353" href="#l353">353</a><td> *<tr><td><a name="l354" href="#l354">354</a><td> * It acts very similarly to {goog.object.transpose(Object)}.<tr><td><a name="l355" href="#l355">355</a><td> *<tr><td><a name="l356" href="#l356">356</a><td> * @return {!goog.structs.Map} The transposed map.<tr><td><a name="l357" href="#l357">357</a><td> */<tr><td><a name="l358" href="#l358">358</a><td>goog.structs.Map.prototype.transpose = function() {<tr><td><a name="l359" href="#l359">359</a><td>  var transposed = new goog.structs.Map();<tr><td><a name="l360" href="#l360">360</a><td>  for (var i = 0; i &lt; this.keys_.length; i++) {<tr><td><a name="l361" href="#l361">361</a><td>    var key = this.keys_[i];<tr><td><a name="l362" href="#l362">362</a><td>    var value = this.map_[key];<tr><td><a name="l363" href="#l363">363</a><td>    transposed.set(value, key);<tr><td><a name="l364" href="#l364">364</a><td>  }<tr><td><a name="l365" href="#l365">365</a><td><tr><td><a name="l366" href="#l366">366</a><td>  return transposed;<tr><td><a name="l367" href="#l367">367</a><td>};<tr><td><a name="l368" href="#l368">368</a><td><tr><td><a name="l369" href="#l369">369</a><td><tr><td><a name="l370" href="#l370">370</a><td>/**<tr><td><a name="l371" href="#l371">371</a><td> * @return {!Object} Object representation of the map.<tr><td><a name="l372" href="#l372">372</a><td> */<tr><td><a name="l373" href="#l373">373</a><td>goog.structs.Map.prototype.toObject = function() {<tr><td><a name="l374" href="#l374">374</a><td>  this.cleanupKeysArray_();<tr><td><a name="l375" href="#l375">375</a><td>  var obj = {};<tr><td><a name="l376" href="#l376">376</a><td>  for (var i = 0; i &lt; this.keys_.length; i++) {<tr><td><a name="l377" href="#l377">377</a><td>    var key = this.keys_[i];<tr><td><a name="l378" href="#l378">378</a><td>    obj[key] = this.map_[key];<tr><td><a name="l379" href="#l379">379</a><td>  }<tr><td><a name="l380" href="#l380">380</a><td>  return obj;<tr><td><a name="l381" href="#l381">381</a><td>};<tr><td><a name="l382" href="#l382">382</a><td><tr><td><a name="l383" href="#l383">383</a><td><tr><td><a name="l384" href="#l384">384</a><td>/**<tr><td><a name="l385" href="#l385">385</a><td> * Returns an iterator that iterates over the keys in the map.  Removal of keys<tr><td><a name="l386" href="#l386">386</a><td> * while iterating might have undesired side effects.<tr><td><a name="l387" href="#l387">387</a><td> * @return {!goog.iter.Iterator} An iterator over the keys in the map.<tr><td><a name="l388" href="#l388">388</a><td> */<tr><td><a name="l389" href="#l389">389</a><td>goog.structs.Map.prototype.getKeyIterator = function() {<tr><td><a name="l390" href="#l390">390</a><td>  return this.__iterator__(true);<tr><td><a name="l391" href="#l391">391</a><td>};<tr><td><a name="l392" href="#l392">392</a><td><tr><td><a name="l393" href="#l393">393</a><td><tr><td><a name="l394" href="#l394">394</a><td>/**<tr><td><a name="l395" href="#l395">395</a><td> * Returns an iterator that iterates over the values in the map.  Removal of<tr><td><a name="l396" href="#l396">396</a><td> * keys while iterating might have undesired side effects.<tr><td><a name="l397" href="#l397">397</a><td> * @return {!goog.iter.Iterator} An iterator over the values in the map.<tr><td><a name="l398" href="#l398">398</a><td> */<tr><td><a name="l399" href="#l399">399</a><td>goog.structs.Map.prototype.getValueIterator = function() {<tr><td><a name="l400" href="#l400">400</a><td>  return this.__iterator__(false);<tr><td><a name="l401" href="#l401">401</a><td>};<tr><td><a name="l402" href="#l402">402</a><td><tr><td><a name="l403" href="#l403">403</a><td><tr><td><a name="l404" href="#l404">404</a><td>/**<tr><td><a name="l405" href="#l405">405</a><td> * Returns an iterator that iterates over the values or the keys in the map.<tr><td><a name="l406" href="#l406">406</a><td> * This throws an exception if the map was mutated since the iterator was<tr><td><a name="l407" href="#l407">407</a><td> * created.<tr><td><a name="l408" href="#l408">408</a><td> * @param {boolean=} opt_keys True to iterate over the keys. False to iterate<tr><td><a name="l409" href="#l409">409</a><td> *     over the values.  The default value is false.<tr><td><a name="l410" href="#l410">410</a><td> * @return {!goog.iter.Iterator} An iterator over the values or keys in the map.<tr><td><a name="l411" href="#l411">411</a><td> */<tr><td><a name="l412" href="#l412">412</a><td>goog.structs.Map.prototype.__iterator__ = function(opt_keys) {<tr><td><a name="l413" href="#l413">413</a><td>  // Clean up keys to minimize the risk of iterating over dead keys.<tr><td><a name="l414" href="#l414">414</a><td>  this.cleanupKeysArray_();<tr><td><a name="l415" href="#l415">415</a><td><tr><td><a name="l416" href="#l416">416</a><td>  var i = 0;<tr><td><a name="l417" href="#l417">417</a><td>  var keys = this.keys_;<tr><td><a name="l418" href="#l418">418</a><td>  var map = this.map_;<tr><td><a name="l419" href="#l419">419</a><td>  var version = this.version_;<tr><td><a name="l420" href="#l420">420</a><td>  var selfObj = this;<tr><td><a name="l421" href="#l421">421</a><td><tr><td><a name="l422" href="#l422">422</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a name="l423" href="#l423">423</a><td>  newIter.next = function() {<tr><td><a name="l424" href="#l424">424</a><td>    while (true) {<tr><td><a name="l425" href="#l425">425</a><td>      if (version != selfObj.version_) {<tr><td><a name="l426" href="#l426">426</a><td>        throw Error(&#39;The map has changed since the iterator was created&#39;);<tr><td><a name="l427" href="#l427">427</a><td>      }<tr><td><a name="l428" href="#l428">428</a><td>      if (i &gt;= keys.length) {<tr><td><a name="l429" href="#l429">429</a><td>        throw goog.iter.StopIteration;<tr><td><a name="l430" href="#l430">430</a><td>      }<tr><td><a name="l431" href="#l431">431</a><td>      var key = keys[i++];<tr><td><a name="l432" href="#l432">432</a><td>      return opt_keys ? key : map[key];<tr><td><a name="l433" href="#l433">433</a><td>    }<tr><td><a name="l434" href="#l434">434</a><td>  };<tr><td><a name="l435" href="#l435">435</a><td>  return newIter;<tr><td><a name="l436" href="#l436">436</a><td>};<tr><td><a name="l437" href="#l437">437</a><td><tr><td><a name="l438" href="#l438">438</a><td><tr><td><a name="l439" href="#l439">439</a><td>/**<tr><td><a name="l440" href="#l440">440</a><td> * Safe way to test for hasOwnProperty.  It even allows testing for<tr><td><a name="l441" href="#l441">441</a><td> * &#39;hasOwnProperty&#39;.<tr><td><a name="l442" href="#l442">442</a><td> * @param {Object} obj The object to test for presence of the given key.<tr><td><a name="l443" href="#l443">443</a><td> * @param {*} key The key to check for.<tr><td><a name="l444" href="#l444">444</a><td> * @return {boolean} Whether the object has the key.<tr><td><a name="l445" href="#l445">445</a><td> * @private<tr><td><a name="l446" href="#l446">446</a><td> */<tr><td><a name="l447" href="#l447">447</a><td>goog.structs.Map.hasKey_ = function(obj, key) {<tr><td><a name="l448" href="#l448">448</a><td>  return Object.prototype.hasOwnProperty.call(obj, key);<tr><td><a name="l449" href="#l449">449</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>map.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/structs/map.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Datastructure: Hash Map.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * This file contains an implementation of a Map structure. It implements a lot<tr><td><a id="l21"></a><a href="#l21">21</a><td> * of the methods used in goog.structs so those functions work on hashes. This<tr><td><a id="l22"></a><a href="#l22">22</a><td> * is best suited for complex key types. For simple keys such as numbers and<tr><td><a id="l23"></a><a href="#l23">23</a><td> * strings consider using the lighter-weight utilities in goog.object.<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><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;goog.structs.Map&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.iter.Iterator&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.iter.StopIteration&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * Class for Hash Map datastructure.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {*=} opt_map Map or Object to initialize the map with.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @param {...*} var_args If 2 or more arguments are present then they<tr><td><a id="l39"></a><a href="#l39">39</a><td> *     will be used as key-value pairs.<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @constructor<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @template K, V<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.structs.Map = function(opt_map, var_args) {<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>  /**<tr><td><a id="l46"></a><a href="#l46">46</a><td>   * Underlying JS object used to implement the map.<tr><td><a id="l47"></a><a href="#l47">47</a><td>   * @private {!Object}<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.map_ = {};<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>   * An array of keys. This is necessary for two reasons:<tr><td><a id="l53"></a><a href="#l53">53</a><td>   *   1. Iterating the keys using for (var key in this.map_) allocates an<tr><td><a id="l54"></a><a href="#l54">54</a><td>   *      object for every key in IE which is really bad for IE6 GC perf.<tr><td><a id="l55"></a><a href="#l55">55</a><td>   *   2. Without a side data structure, we would need to escape all the keys<tr><td><a id="l56"></a><a href="#l56">56</a><td>   *      as that would be the only way we could tell during iteration if the<tr><td><a id="l57"></a><a href="#l57">57</a><td>   *      key was an internal key or a property of the object.<tr><td><a id="l58"></a><a href="#l58">58</a><td>   *<tr><td><a id="l59"></a><a href="#l59">59</a><td>   * This array can contain deleted keys so it&#39;s necessary to check the map<tr><td><a id="l60"></a><a href="#l60">60</a><td>   * as well to see if the key is still in the map (this doesn&#39;t require a<tr><td><a id="l61"></a><a href="#l61">61</a><td>   * memory allocation in IE).<tr><td><a id="l62"></a><a href="#l62">62</a><td>   * @private {!Array&lt;string&gt;}<tr><td><a id="l63"></a><a href="#l63">63</a><td>   */<tr><td><a id="l64"></a><a href="#l64">64</a><td>  this.keys_ = [];<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>   * The number of key value pairs in the map.<tr><td><a id="l68"></a><a href="#l68">68</a><td>   * @private {number}<tr><td><a id="l69"></a><a href="#l69">69</a><td>   */<tr><td><a id="l70"></a><a href="#l70">70</a><td>  this.count_ = 0;<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>   * Version used to detect changes while iterating.<tr><td><a id="l74"></a><a href="#l74">74</a><td>   * @private {number}<tr><td><a id="l75"></a><a href="#l75">75</a><td>   */<tr><td><a id="l76"></a><a href="#l76">76</a><td>  this.version_ = 0;<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>  var argLength = arguments.length;<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td>  if (argLength &gt; 1) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>    if (argLength % 2) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>      throw Error(&#39;Uneven number of arguments&#39;);<tr><td><a id="l83"></a><a href="#l83">83</a><td>    }<tr><td><a id="l84"></a><a href="#l84">84</a><td>    for (var i = 0; i &lt; argLength; i += 2) {<tr><td><a id="l85"></a><a href="#l85">85</a><td>      this.set(arguments[i], arguments[i + 1]);<tr><td><a id="l86"></a><a href="#l86">86</a><td>    }<tr><td><a id="l87"></a><a href="#l87">87</a><td>  } else if (opt_map) {<tr><td><a id="l88"></a><a href="#l88">88</a><td>    this.addAll(/** @type {Object} */ (opt_map));<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><tr><td><a id="l93"></a><a href="#l93">93</a><td>/**<tr><td><a id="l94"></a><a href="#l94">94</a><td> * @return {number} The number of key-value pairs in the map.<tr><td><a id="l95"></a><a href="#l95">95</a><td> */<tr><td><a id="l96"></a><a href="#l96">96</a><td>goog.structs.Map.prototype.getCount = function() {<tr><td><a id="l97"></a><a href="#l97">97</a><td>  return this.count_;<tr><td><a id="l98"></a><a href="#l98">98</a><td>};<tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td><tr><td><a id="l101"></a><a href="#l101">101</a><td>/**<tr><td><a id="l102"></a><a href="#l102">102</a><td> * Returns the values of the map.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @return {!Array&lt;V&gt;} The values in the map.<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.structs.Map.prototype.getValues = function() {<tr><td><a id="l106"></a><a href="#l106">106</a><td>  this.cleanupKeysArray_();<tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>  var rv = [];<tr><td><a id="l109"></a><a href="#l109">109</a><td>  for (var i = 0; i &lt; this.keys_.length; i++) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>    var key = this.keys_[i];<tr><td><a id="l111"></a><a href="#l111">111</a><td>    rv.push(this.map_[key]);<tr><td><a id="l112"></a><a href="#l112">112</a><td>  }<tr><td><a id="l113"></a><a href="#l113">113</a><td>  return rv;<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><tr><td><a id="l117"></a><a href="#l117">117</a><td>/**<tr><td><a id="l118"></a><a href="#l118">118</a><td> * Returns the keys of the map.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @return {!Array&lt;string&gt;} Array of string values.<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.structs.Map.prototype.getKeys = function() {<tr><td><a id="l122"></a><a href="#l122">122</a><td>  this.cleanupKeysArray_();<tr><td><a id="l123"></a><a href="#l123">123</a><td>  return /** @type {!Array&lt;string&gt;} */ (this.keys_.concat());<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> * Whether the map contains the given key.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {*} key The key to check for.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @return {boolean} Whether the map contains the key.<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.structs.Map.prototype.containsKey = function(key) {<tr><td><a id="l133"></a><a href="#l133">133</a><td>  return goog.structs.Map.hasKey_(this.map_, key);<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><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Whether the map contains the given value. This is O(n).<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {V} val The value to check for.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @return {boolean} Whether the map contains the value.<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td>goog.structs.Map.prototype.containsValue = function(val) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>  for (var i = 0; i &lt; this.keys_.length; i++) {<tr><td><a id="l144"></a><a href="#l144">144</a><td>    var key = this.keys_[i];<tr><td><a id="l145"></a><a href="#l145">145</a><td>    if (goog.structs.Map.hasKey_(this.map_, key) &amp;&amp; this.map_[key] == val) {<tr><td><a id="l146"></a><a href="#l146">146</a><td>      return true;<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>  return false;<tr><td><a id="l150"></a><a href="#l150">150</a><td>};<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>/**<tr><td><a id="l154"></a><a href="#l154">154</a><td> * Whether this map is equal to the argument map.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {goog.structs.Map} otherMap The map against which to test equality.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @param {function(V, V): boolean=} opt_equalityFn Optional equality function<tr><td><a id="l157"></a><a href="#l157">157</a><td> *     to test equality of values. If not specified, this will test whether<tr><td><a id="l158"></a><a href="#l158">158</a><td> *     the values contained in each map are identical objects.<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @return {boolean} Whether the maps are equal.<tr><td><a id="l160"></a><a href="#l160">160</a><td> */<tr><td><a id="l161"></a><a href="#l161">161</a><td>goog.structs.Map.prototype.equals = function(otherMap, opt_equalityFn) {<tr><td><a id="l162"></a><a href="#l162">162</a><td>  if (this === otherMap) {<tr><td><a id="l163"></a><a href="#l163">163</a><td>    return true;<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>  if (this.count_ != otherMap.getCount()) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>    return false;<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>  var equalityFn = opt_equalityFn || goog.structs.Map.defaultEquals;<tr><td><a id="l171"></a><a href="#l171">171</a><td><tr><td><a id="l172"></a><a href="#l172">172</a><td>  this.cleanupKeysArray_();<tr><td><a id="l173"></a><a href="#l173">173</a><td>  for (var key, i = 0; key = this.keys_[i]; i++) {<tr><td><a id="l174"></a><a href="#l174">174</a><td>    if (!equalityFn(this.get(key), otherMap.get(key))) {<tr><td><a id="l175"></a><a href="#l175">175</a><td>      return false;<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>  return true;<tr><td><a id="l180"></a><a href="#l180">180</a><td>};<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Default equality test for values.<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @param {*} a The first value.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @param {*} b The second value.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @return {boolean} Whether a and b reference the same object.<tr><td><a id="l188"></a><a href="#l188">188</a><td> */<tr><td><a id="l189"></a><a href="#l189">189</a><td>goog.structs.Map.defaultEquals = function(a, b) {<tr><td><a id="l190"></a><a href="#l190">190</a><td>  return a === b;<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> * @return {boolean} Whether the map is empty.<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.structs.Map.prototype.isEmpty = function() {<tr><td><a id="l198"></a><a href="#l198">198</a><td>  return this.count_ == 0;<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> * Removes all key-value pairs from the map.<tr><td><a id="l204"></a><a href="#l204">204</a><td> */<tr><td><a id="l205"></a><a href="#l205">205</a><td>goog.structs.Map.prototype.clear = function() {<tr><td><a id="l206"></a><a href="#l206">206</a><td>  this.map_ = {};<tr><td><a id="l207"></a><a href="#l207">207</a><td>  this.keys_.length = 0;<tr><td><a id="l208"></a><a href="#l208">208</a><td>  this.count_ = 0;<tr><td><a id="l209"></a><a href="#l209">209</a><td>  this.version_ = 0;<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> * Removes a key-value pair based on the key. This is O(logN) amortized due to<tr><td><a id="l215"></a><a href="#l215">215</a><td> * updating the keys array whenever the count becomes half the size of the keys<tr><td><a id="l216"></a><a href="#l216">216</a><td> * in the keys array.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @param {*} key  The key to remove.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @return {boolean} Whether object was removed.<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>goog.structs.Map.prototype.remove = function(key) {<tr><td><a id="l221"></a><a href="#l221">221</a><td>  if (goog.structs.Map.hasKey_(this.map_, key)) {<tr><td><a id="l222"></a><a href="#l222">222</a><td>    delete this.map_[key];<tr><td><a id="l223"></a><a href="#l223">223</a><td>    this.count_--;<tr><td><a id="l224"></a><a href="#l224">224</a><td>    this.version_++;<tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>    // clean up the keys array if the threshhold is hit<tr><td><a id="l227"></a><a href="#l227">227</a><td>    if (this.keys_.length &gt; 2 * this.count_) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>      this.cleanupKeysArray_();<tr><td><a id="l229"></a><a href="#l229">229</a><td>    }<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 true;<tr><td><a id="l232"></a><a href="#l232">232</a><td>  }<tr><td><a id="l233"></a><a href="#l233">233</a><td>  return false;<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><tr><td><a id="l237"></a><a href="#l237">237</a><td>/**<tr><td><a id="l238"></a><a href="#l238">238</a><td> * Cleans up the temp keys array by removing entries that are no longer in the<tr><td><a id="l239"></a><a href="#l239">239</a><td> * map.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @private<tr><td><a id="l241"></a><a href="#l241">241</a><td> */<tr><td><a id="l242"></a><a href="#l242">242</a><td>goog.structs.Map.prototype.cleanupKeysArray_ = function() {<tr><td><a id="l243"></a><a href="#l243">243</a><td>  if (this.count_ != this.keys_.length) {<tr><td><a id="l244"></a><a href="#l244">244</a><td>    // First remove keys that are no longer in the map.<tr><td><a id="l245"></a><a href="#l245">245</a><td>    var srcIndex = 0;<tr><td><a id="l246"></a><a href="#l246">246</a><td>    var destIndex = 0;<tr><td><a id="l247"></a><a href="#l247">247</a><td>    while (srcIndex &lt; this.keys_.length) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>      var key = this.keys_[srcIndex];<tr><td><a id="l249"></a><a href="#l249">249</a><td>      if (goog.structs.Map.hasKey_(this.map_, key)) {<tr><td><a id="l250"></a><a href="#l250">250</a><td>        this.keys_[destIndex++] = key;<tr><td><a id="l251"></a><a href="#l251">251</a><td>      }<tr><td><a id="l252"></a><a href="#l252">252</a><td>      srcIndex++;<tr><td><a id="l253"></a><a href="#l253">253</a><td>    }<tr><td><a id="l254"></a><a href="#l254">254</a><td>    this.keys_.length = destIndex;<tr><td><a id="l255"></a><a href="#l255">255</a><td>  }<tr><td><a id="l256"></a><a href="#l256">256</a><td><tr><td><a id="l257"></a><a href="#l257">257</a><td>  if (this.count_ != this.keys_.length) {<tr><td><a id="l258"></a><a href="#l258">258</a><td>    // If the count still isn&#39;t correct, that means we have duplicates. This can<tr><td><a id="l259"></a><a href="#l259">259</a><td>    // happen when the same key is added and removed multiple times. Now we have<tr><td><a id="l260"></a><a href="#l260">260</a><td>    // to allocate one extra Object to remove the duplicates. This could have<tr><td><a id="l261"></a><a href="#l261">261</a><td>    // been done in the first pass, but in the common case, we can avoid<tr><td><a id="l262"></a><a href="#l262">262</a><td>    // allocating an extra object by only doing this when necessary.<tr><td><a id="l263"></a><a href="#l263">263</a><td>    var seen = {};<tr><td><a id="l264"></a><a href="#l264">264</a><td>    var srcIndex = 0;<tr><td><a id="l265"></a><a href="#l265">265</a><td>    var destIndex = 0;<tr><td><a id="l266"></a><a href="#l266">266</a><td>    while (srcIndex &lt; this.keys_.length) {<tr><td><a id="l267"></a><a href="#l267">267</a><td>      var key = this.keys_[srcIndex];<tr><td><a id="l268"></a><a href="#l268">268</a><td>      if (!(goog.structs.Map.hasKey_(seen, key))) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>        this.keys_[destIndex++] = key;<tr><td><a id="l270"></a><a href="#l270">270</a><td>        seen[key] = 1;<tr><td><a id="l271"></a><a href="#l271">271</a><td>      }<tr><td><a id="l272"></a><a href="#l272">272</a><td>      srcIndex++;<tr><td><a id="l273"></a><a href="#l273">273</a><td>    }<tr><td><a id="l274"></a><a href="#l274">274</a><td>    this.keys_.length = destIndex;<tr><td><a id="l275"></a><a href="#l275">275</a><td>  }<tr><td><a id="l276"></a><a href="#l276">276</a><td>};<tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td>/**<tr><td><a id="l280"></a><a href="#l280">280</a><td> * Returns the value for the given key.  If the key is not found and the default<tr><td><a id="l281"></a><a href="#l281">281</a><td> * value is not given this will return {@code undefined}.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @param {*} key The key to get the value for.<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @param {DEFAULT=} opt_val The value to return if no item is found for the<tr><td><a id="l284"></a><a href="#l284">284</a><td> *     given key, defaults to undefined.<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @return {V|DEFAULT} The value for the given key.<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @template DEFAULT<tr><td><a id="l287"></a><a href="#l287">287</a><td> */<tr><td><a id="l288"></a><a href="#l288">288</a><td>goog.structs.Map.prototype.get = function(key, opt_val) {<tr><td><a id="l289"></a><a href="#l289">289</a><td>  if (goog.structs.Map.hasKey_(this.map_, key)) {<tr><td><a id="l290"></a><a href="#l290">290</a><td>    return this.map_[key];<tr><td><a id="l291"></a><a href="#l291">291</a><td>  }<tr><td><a id="l292"></a><a href="#l292">292</a><td>  return opt_val;<tr><td><a id="l293"></a><a href="#l293">293</a><td>};<tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td><tr><td><a id="l296"></a><a href="#l296">296</a><td>/**<tr><td><a id="l297"></a><a href="#l297">297</a><td> * Adds a key-value pair to the map.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @param {*} key The key.<tr><td><a id="l299"></a><a href="#l299">299</a><td> * @param {V} value The value to add.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @return {*} Some subclasses return a value.<tr><td><a id="l301"></a><a href="#l301">301</a><td> */<tr><td><a id="l302"></a><a href="#l302">302</a><td>goog.structs.Map.prototype.set = function(key, value) {<tr><td><a id="l303"></a><a href="#l303">303</a><td>  if (!(goog.structs.Map.hasKey_(this.map_, key))) {<tr><td><a id="l304"></a><a href="#l304">304</a><td>    this.count_++;<tr><td><a id="l305"></a><a href="#l305">305</a><td>    // TODO(johnlenz): This class lies, it claims to return an array of string<tr><td><a id="l306"></a><a href="#l306">306</a><td>    // keys, but instead returns the original object used.<tr><td><a id="l307"></a><a href="#l307">307</a><td>    this.keys_.push(/** @type {?} */ (key));<tr><td><a id="l308"></a><a href="#l308">308</a><td>    // Only change the version if we add a new key.<tr><td><a id="l309"></a><a href="#l309">309</a><td>    this.version_++;<tr><td><a id="l310"></a><a href="#l310">310</a><td>  }<tr><td><a id="l311"></a><a href="#l311">311</a><td>  this.map_[key] = value;<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> * Adds multiple key-value pairs from another goog.structs.Map or Object.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @param {Object} map  Object containing the data to add.<tr><td><a id="l318"></a><a href="#l318">318</a><td> */<tr><td><a id="l319"></a><a href="#l319">319</a><td>goog.structs.Map.prototype.addAll = function(map) {<tr><td><a id="l320"></a><a href="#l320">320</a><td>  var keys, values;<tr><td><a id="l321"></a><a href="#l321">321</a><td>  if (map instanceof goog.structs.Map) {<tr><td><a id="l322"></a><a href="#l322">322</a><td>    keys = map.getKeys();<tr><td><a id="l323"></a><a href="#l323">323</a><td>    values = map.getValues();<tr><td><a id="l324"></a><a href="#l324">324</a><td>  } else {<tr><td><a id="l325"></a><a href="#l325">325</a><td>    keys = goog.object.getKeys(map);<tr><td><a id="l326"></a><a href="#l326">326</a><td>    values = goog.object.getValues(map);<tr><td><a id="l327"></a><a href="#l327">327</a><td>  }<tr><td><a id="l328"></a><a href="#l328">328</a><td>  // we could use goog.array.forEach here but I don&#39;t want to introduce that<tr><td><a id="l329"></a><a href="#l329">329</a><td>  // dependency just for this.<tr><td><a id="l330"></a><a href="#l330">330</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a id="l331"></a><a href="#l331">331</a><td>    this.set(keys[i], values[i]);<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><tr><td><a id="l335"></a><a href="#l335">335</a><td><tr><td><a id="l336"></a><a href="#l336">336</a><td>/**<tr><td><a id="l337"></a><a href="#l337">337</a><td> * Calls the given function on each entry in the map.<tr><td><a id="l338"></a><a href="#l338">338</a><td> * @param {function(this:T, V, K, goog.structs.Map&lt;K,V&gt;)} f<tr><td><a id="l339"></a><a href="#l339">339</a><td> * @param {T=} opt_obj The value of &quot;this&quot; inside f.<tr><td><a id="l340"></a><a href="#l340">340</a><td> * @template T<tr><td><a id="l341"></a><a href="#l341">341</a><td> */<tr><td><a id="l342"></a><a href="#l342">342</a><td>goog.structs.Map.prototype.forEach = function(f, opt_obj) {<tr><td><a id="l343"></a><a href="#l343">343</a><td>  var keys = this.getKeys();<tr><td><a id="l344"></a><a href="#l344">344</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a id="l345"></a><a href="#l345">345</a><td>    var key = keys[i];<tr><td><a id="l346"></a><a href="#l346">346</a><td>    var value = this.get(key);<tr><td><a id="l347"></a><a href="#l347">347</a><td>    f.call(opt_obj, value, key, this);<tr><td><a id="l348"></a><a href="#l348">348</a><td>  }<tr><td><a id="l349"></a><a href="#l349">349</a><td>};<tr><td><a id="l350"></a><a href="#l350">350</a><td><tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td>/**<tr><td><a id="l353"></a><a href="#l353">353</a><td> * Clones a map and returns a new map.<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @return {!goog.structs.Map} A new map with the same key-value pairs.<tr><td><a id="l355"></a><a href="#l355">355</a><td> */<tr><td><a id="l356"></a><a href="#l356">356</a><td>goog.structs.Map.prototype.clone = function() {<tr><td><a id="l357"></a><a href="#l357">357</a><td>  return new goog.structs.Map(this);<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><tr><td><a id="l361"></a><a href="#l361">361</a><td>/**<tr><td><a id="l362"></a><a href="#l362">362</a><td> * Returns a new map in which all the keys and values are interchanged<tr><td><a id="l363"></a><a href="#l363">363</a><td> * (keys become values and values become keys). If multiple keys map to the<tr><td><a id="l364"></a><a href="#l364">364</a><td> * same value, the chosen transposed value is implementation-dependent.<tr><td><a id="l365"></a><a href="#l365">365</a><td> *<tr><td><a id="l366"></a><a href="#l366">366</a><td> * It acts very similarly to {goog.object.transpose(Object)}.<tr><td><a id="l367"></a><a href="#l367">367</a><td> *<tr><td><a id="l368"></a><a href="#l368">368</a><td> * @return {!goog.structs.Map} The transposed map.<tr><td><a id="l369"></a><a href="#l369">369</a><td> */<tr><td><a id="l370"></a><a href="#l370">370</a><td>goog.structs.Map.prototype.transpose = function() {<tr><td><a id="l371"></a><a href="#l371">371</a><td>  var transposed = new goog.structs.Map();<tr><td><a id="l372"></a><a href="#l372">372</a><td>  for (var i = 0; i &lt; this.keys_.length; i++) {<tr><td><a id="l373"></a><a href="#l373">373</a><td>    var key = this.keys_[i];<tr><td><a id="l374"></a><a href="#l374">374</a><td>    var value = this.map_[key];<tr><td><a id="l375"></a><a href="#l375">375</a><td>    transposed.set(value, key);<tr><td><a id="l376"></a><a href="#l376">376</a><td>  }<tr><td><a id="l377"></a><a href="#l377">377</a><td><tr><td><a id="l378"></a><a href="#l378">378</a><td>  return transposed;<tr><td><a id="l379"></a><a href="#l379">379</a><td>};<tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td><tr><td><a id="l382"></a><a href="#l382">382</a><td>/**<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @return {!Object} Object representation of the map.<tr><td><a id="l384"></a><a href="#l384">384</a><td> */<tr><td><a id="l385"></a><a href="#l385">385</a><td>goog.structs.Map.prototype.toObject = function() {<tr><td><a id="l386"></a><a href="#l386">386</a><td>  this.cleanupKeysArray_();<tr><td><a id="l387"></a><a href="#l387">387</a><td>  var obj = {};<tr><td><a id="l388"></a><a href="#l388">388</a><td>  for (var i = 0; i &lt; this.keys_.length; i++) {<tr><td><a id="l389"></a><a href="#l389">389</a><td>    var key = this.keys_[i];<tr><td><a id="l390"></a><a href="#l390">390</a><td>    obj[key] = this.map_[key];<tr><td><a id="l391"></a><a href="#l391">391</a><td>  }<tr><td><a id="l392"></a><a href="#l392">392</a><td>  return obj;<tr><td><a id="l393"></a><a href="#l393">393</a><td>};<tr><td><a id="l394"></a><a href="#l394">394</a><td><tr><td><a id="l395"></a><a href="#l395">395</a><td><tr><td><a id="l396"></a><a href="#l396">396</a><td>/**<tr><td><a id="l397"></a><a href="#l397">397</a><td> * Returns an iterator that iterates over the keys in the map.  Removal of keys<tr><td><a id="l398"></a><a href="#l398">398</a><td> * while iterating might have undesired side effects.<tr><td><a id="l399"></a><a href="#l399">399</a><td> * @return {!goog.iter.Iterator} An iterator over the keys in the map.<tr><td><a id="l400"></a><a href="#l400">400</a><td> */<tr><td><a id="l401"></a><a href="#l401">401</a><td>goog.structs.Map.prototype.getKeyIterator = function() {<tr><td><a id="l402"></a><a href="#l402">402</a><td>  return this.__iterator__(true);<tr><td><a id="l403"></a><a href="#l403">403</a><td>};<tr><td><a id="l404"></a><a href="#l404">404</a><td><tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td>/**<tr><td><a id="l407"></a><a href="#l407">407</a><td> * Returns an iterator that iterates over the values in the map.  Removal of<tr><td><a id="l408"></a><a href="#l408">408</a><td> * keys while iterating might have undesired side effects.<tr><td><a id="l409"></a><a href="#l409">409</a><td> * @return {!goog.iter.Iterator} An iterator over the values in the map.<tr><td><a id="l410"></a><a href="#l410">410</a><td> */<tr><td><a id="l411"></a><a href="#l411">411</a><td>goog.structs.Map.prototype.getValueIterator = function() {<tr><td><a id="l412"></a><a href="#l412">412</a><td>  return this.__iterator__(false);<tr><td><a id="l413"></a><a href="#l413">413</a><td>};<tr><td><a id="l414"></a><a href="#l414">414</a><td><tr><td><a id="l415"></a><a href="#l415">415</a><td><tr><td><a id="l416"></a><a href="#l416">416</a><td>/**<tr><td><a id="l417"></a><a href="#l417">417</a><td> * Returns an iterator that iterates over the values or the keys in the map.<tr><td><a id="l418"></a><a href="#l418">418</a><td> * This throws an exception if the map was mutated since the iterator was<tr><td><a id="l419"></a><a href="#l419">419</a><td> * created.<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @param {boolean=} opt_keys True to iterate over the keys. False to iterate<tr><td><a id="l421"></a><a href="#l421">421</a><td> *     over the values.  The default value is false.<tr><td><a id="l422"></a><a href="#l422">422</a><td> * @return {!goog.iter.Iterator} An iterator over the values or keys in the map.<tr><td><a id="l423"></a><a href="#l423">423</a><td> */<tr><td><a id="l424"></a><a href="#l424">424</a><td>goog.structs.Map.prototype.__iterator__ = function(opt_keys) {<tr><td><a id="l425"></a><a href="#l425">425</a><td>  // Clean up keys to minimize the risk of iterating over dead keys.<tr><td><a id="l426"></a><a href="#l426">426</a><td>  this.cleanupKeysArray_();<tr><td><a id="l427"></a><a href="#l427">427</a><td><tr><td><a id="l428"></a><a href="#l428">428</a><td>  var i = 0;<tr><td><a id="l429"></a><a href="#l429">429</a><td>  var version = this.version_;<tr><td><a id="l430"></a><a href="#l430">430</a><td>  var selfObj = this;<tr><td><a id="l431"></a><a href="#l431">431</a><td><tr><td><a id="l432"></a><a href="#l432">432</a><td>  var newIter = new goog.iter.Iterator;<tr><td><a id="l433"></a><a href="#l433">433</a><td>  newIter.next = function() {<tr><td><a id="l434"></a><a href="#l434">434</a><td>    if (version != selfObj.version_) {<tr><td><a id="l435"></a><a href="#l435">435</a><td>      throw Error(&#39;The map has changed since the iterator was created&#39;);<tr><td><a id="l436"></a><a href="#l436">436</a><td>    }<tr><td><a id="l437"></a><a href="#l437">437</a><td>    if (i &gt;= selfObj.keys_.length) {<tr><td><a id="l438"></a><a href="#l438">438</a><td>      throw goog.iter.StopIteration;<tr><td><a id="l439"></a><a href="#l439">439</a><td>    }<tr><td><a id="l440"></a><a href="#l440">440</a><td>    var key = selfObj.keys_[i++];<tr><td><a id="l441"></a><a href="#l441">441</a><td>    return opt_keys ? key : selfObj.map_[key];<tr><td><a id="l442"></a><a href="#l442">442</a><td>  };<tr><td><a id="l443"></a><a href="#l443">443</a><td>  return newIter;<tr><td><a id="l444"></a><a href="#l444">444</a><td>};<tr><td><a id="l445"></a><a href="#l445">445</a><td><tr><td><a id="l446"></a><a href="#l446">446</a><td><tr><td><a id="l447"></a><a href="#l447">447</a><td>/**<tr><td><a id="l448"></a><a href="#l448">448</a><td> * Safe way to test for hasOwnProperty.  It even allows testing for<tr><td><a id="l449"></a><a href="#l449">449</a><td> * &#39;hasOwnProperty&#39;.<tr><td><a id="l450"></a><a href="#l450">450</a><td> * @param {Object} obj The object to test for presence of the given key.<tr><td><a id="l451"></a><a href="#l451">451</a><td> * @param {*} key The key to check for.<tr><td><a id="l452"></a><a href="#l452">452</a><td> * @return {boolean} Whether the object has the key.<tr><td><a id="l453"></a><a href="#l453">453</a><td> * @private<tr><td><a id="l454"></a><a href="#l454">454</a><td> */<tr><td><a id="l455"></a><a href="#l455">455</a><td>goog.structs.Map.hasKey_ = function(obj, key) {<tr><td><a id="l456"></a><a href="#l456">456</a><td>  return Object.prototype.hasOwnProperty.call(obj, key);<tr><td><a id="l457"></a><a href="#l457">457</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/structs/set.js.src.html b/docs/source/lib/goog/structs/set.js.src.html
new file mode 100644
index 0000000..5c0c4e3
--- /dev/null
+++ b/docs/source/lib/goog/structs/set.js.src.html
@@ -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>set.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/structs/set.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Datastructure: Set.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * This class implements a set data structure. Adding and removing is O(1). It<tr><td><a id="l21"></a><a href="#l21">21</a><td> * supports both object and primitive values. Be careful because you can add<tr><td><a id="l22"></a><a href="#l22">22</a><td> * both 1 and new Number(1), because these are not the same. You can even add<tr><td><a id="l23"></a><a href="#l23">23</a><td> * multiple new Number(1) because these are not equal.<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><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;goog.structs.Set&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.structs&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.structs.Collection&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.structs.Map&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * A set that can contain both primitives and objects.  Adding and removing<tr><td><a id="l37"></a><a href="#l37">37</a><td> * elements is O(1).  Primitives are treated as identical if they have the same<tr><td><a id="l38"></a><a href="#l38">38</a><td> * type and convert to the same string.  Objects are treated as identical only<tr><td><a id="l39"></a><a href="#l39">39</a><td> * if they are references to the same object.  WARNING: A goog.structs.Set can<tr><td><a id="l40"></a><a href="#l40">40</a><td> * contain both 1 and (new Number(1)), because they are not the same.  WARNING:<tr><td><a id="l41"></a><a href="#l41">41</a><td> * Adding (new Number(1)) twice will yield two distinct elements, because they<tr><td><a id="l42"></a><a href="#l42">42</a><td> * are two different objects.  WARNING: Any object that is added to a<tr><td><a id="l43"></a><a href="#l43">43</a><td> * goog.structs.Set will be modified!  Because goog.getUid() is used to<tr><td><a id="l44"></a><a href="#l44">44</a><td> * identify objects, every object in the set will be mutated.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @param {Array&lt;T&gt;|Object&lt;?,T&gt;=} opt_values Initial values to start with.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @constructor<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @implements {goog.structs.Collection&lt;T&gt;}<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @final<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @template T<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.structs.Set = function(opt_values) {<tr><td><a id="l52"></a><a href="#l52">52</a><td>  this.map_ = new goog.structs.Map;<tr><td><a id="l53"></a><a href="#l53">53</a><td>  if (opt_values) {<tr><td><a id="l54"></a><a href="#l54">54</a><td>    this.addAll(opt_values);<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><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> * Obtains a unique key for an element of the set.  Primitives will yield the<tr><td><a id="l61"></a><a href="#l61">61</a><td> * same key if they have the same type and convert to the same string.  Object<tr><td><a id="l62"></a><a href="#l62">62</a><td> * references will yield the same key only if they refer to the same object.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {*} val Object or primitive value to get a key for.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @return {string} A unique key for this value/object.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @private<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.structs.Set.getKey_ = function(val) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  var type = typeof val;<tr><td><a id="l69"></a><a href="#l69">69</a><td>  if (type == &#39;object&#39; &amp;&amp; val || type == &#39;function&#39;) {<tr><td><a id="l70"></a><a href="#l70">70</a><td>    return &#39;o&#39; + goog.getUid(/** @type {Object} */ (val));<tr><td><a id="l71"></a><a href="#l71">71</a><td>  } else {<tr><td><a id="l72"></a><a href="#l72">72</a><td>    return type.substr(0, 1) + val;<tr><td><a id="l73"></a><a href="#l73">73</a><td>  }<tr><td><a id="l74"></a><a href="#l74">74</a><td>};<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {number} The number of elements in the set.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @override<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.structs.Set.prototype.getCount = function() {<tr><td><a id="l82"></a><a href="#l82">82</a><td>  return this.map_.getCount();<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> * Add a primitive or an object to the set.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {T} element The primitive or object to add.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @override<tr><td><a id="l90"></a><a href="#l90">90</a><td> */<tr><td><a id="l91"></a><a href="#l91">91</a><td>goog.structs.Set.prototype.add = function(element) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>  this.map_.set(goog.structs.Set.getKey_(element), element);<tr><td><a id="l93"></a><a href="#l93">93</a><td>};<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>/**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Adds all the values in the given collection to this set.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @param {Array&lt;T&gt;|goog.structs.Collection&lt;T&gt;|Object&lt;?,T&gt;} col A collection<tr><td><a id="l99"></a><a href="#l99">99</a><td> *     containing the elements to add.<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.structs.Set.prototype.addAll = function(col) {<tr><td><a id="l102"></a><a href="#l102">102</a><td>  var values = goog.structs.getValues(col);<tr><td><a id="l103"></a><a href="#l103">103</a><td>  var l = values.length;<tr><td><a id="l104"></a><a href="#l104">104</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a id="l105"></a><a href="#l105">105</a><td>    this.add(values[i]);<tr><td><a id="l106"></a><a href="#l106">106</a><td>  }<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> * Removes all values in the given collection from this set.<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @param {Array&lt;T&gt;|goog.structs.Collection&lt;T&gt;|Object&lt;?,T&gt;} col A collection<tr><td><a id="l113"></a><a href="#l113">113</a><td> *     containing the elements to remove.<tr><td><a id="l114"></a><a href="#l114">114</a><td> */<tr><td><a id="l115"></a><a href="#l115">115</a><td>goog.structs.Set.prototype.removeAll = function(col) {<tr><td><a id="l116"></a><a href="#l116">116</a><td>  var values = goog.structs.getValues(col);<tr><td><a id="l117"></a><a href="#l117">117</a><td>  var l = values.length;<tr><td><a id="l118"></a><a href="#l118">118</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>    this.remove(values[i]);<tr><td><a id="l120"></a><a href="#l120">120</a><td>  }<tr><td><a id="l121"></a><a href="#l121">121</a><td>};<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>/**<tr><td><a id="l125"></a><a href="#l125">125</a><td> * Removes the given element from this set.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @param {T} element The primitive or object to remove.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @return {boolean} Whether the element was found and removed.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @override<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.structs.Set.prototype.remove = function(element) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>  return this.map_.remove(goog.structs.Set.getKey_(element));<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> * Removes all elements from this set.<tr><td><a id="l137"></a><a href="#l137">137</a><td> */<tr><td><a id="l138"></a><a href="#l138">138</a><td>goog.structs.Set.prototype.clear = function() {<tr><td><a id="l139"></a><a href="#l139">139</a><td>  this.map_.clear();<tr><td><a id="l140"></a><a href="#l140">140</a><td>};<tr><td><a id="l141"></a><a href="#l141">141</a><td><tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>/**<tr><td><a id="l144"></a><a href="#l144">144</a><td> * Tests whether this set is empty.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @return {boolean} True if there are no elements in this set.<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.structs.Set.prototype.isEmpty = function() {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  return this.map_.isEmpty();<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * Tests whether this set contains the given element.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {T} element The primitive or object to test for.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @return {boolean} True if this set contains the given element.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @override<tr><td><a id="l157"></a><a href="#l157">157</a><td> */<tr><td><a id="l158"></a><a href="#l158">158</a><td>goog.structs.Set.prototype.contains = function(element) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>  return this.map_.containsKey(goog.structs.Set.getKey_(element));<tr><td><a id="l160"></a><a href="#l160">160</a><td>};<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>/**<tr><td><a id="l164"></a><a href="#l164">164</a><td> * Tests whether this set contains all the values in a given collection.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * Repeated elements in the collection are ignored, e.g.  (new<tr><td><a id="l166"></a><a href="#l166">166</a><td> * goog.structs.Set([1, 2])).containsAll([1, 1]) is True.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {goog.structs.Collection&lt;T&gt;|Object} col A collection-like object.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {boolean} True if the set contains all elements.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>goog.structs.Set.prototype.containsAll = function(col) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>  return goog.structs.every(col, this.contains, this);<tr><td><a id="l172"></a><a href="#l172">172</a><td>};<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * Finds all values that are present in both this set and the given collection.<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @param {Array&lt;S&gt;|Object&lt;?,S&gt;} col A collection.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @return {!goog.structs.Set&lt;T|S&gt;} A new set containing all the values<tr><td><a id="l179"></a><a href="#l179">179</a><td> *     (primitives or objects) present in both this set and the given<tr><td><a id="l180"></a><a href="#l180">180</a><td> *     collection.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @template S<tr><td><a id="l182"></a><a href="#l182">182</a><td> */<tr><td><a id="l183"></a><a href="#l183">183</a><td>goog.structs.Set.prototype.intersection = function(col) {<tr><td><a id="l184"></a><a href="#l184">184</a><td>  var result = new goog.structs.Set();<tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td>  var values = goog.structs.getValues(col);<tr><td><a id="l187"></a><a href="#l187">187</a><td>  for (var i = 0; i &lt; values.length; i++) {<tr><td><a id="l188"></a><a href="#l188">188</a><td>    var value = values[i];<tr><td><a id="l189"></a><a href="#l189">189</a><td>    if (this.contains(value)) {<tr><td><a id="l190"></a><a href="#l190">190</a><td>      result.add(value);<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>  return result;<tr><td><a id="l195"></a><a href="#l195">195</a><td>};<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>/**<tr><td><a id="l199"></a><a href="#l199">199</a><td> * Finds all values that are present in this set and not in the given<tr><td><a id="l200"></a><a href="#l200">200</a><td> * collection.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @param {Array&lt;T&gt;|goog.structs.Collection&lt;T&gt;|Object&lt;?,T&gt;} col A collection.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @return {!goog.structs.Set} A new set containing all the values<tr><td><a id="l203"></a><a href="#l203">203</a><td> *     (primitives or objects) present in this set but not in the given<tr><td><a id="l204"></a><a href="#l204">204</a><td> *     collection.<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.structs.Set.prototype.difference = function(col) {<tr><td><a id="l207"></a><a href="#l207">207</a><td>  var result = this.clone();<tr><td><a id="l208"></a><a href="#l208">208</a><td>  result.removeAll(col);<tr><td><a id="l209"></a><a href="#l209">209</a><td>  return result;<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> * Returns an array containing all the elements in this set.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @return {!Array&lt;T&gt;} An array containing all the elements in this set.<tr><td><a id="l216"></a><a href="#l216">216</a><td> */<tr><td><a id="l217"></a><a href="#l217">217</a><td>goog.structs.Set.prototype.getValues = function() {<tr><td><a id="l218"></a><a href="#l218">218</a><td>  return this.map_.getValues();<tr><td><a id="l219"></a><a href="#l219">219</a><td>};<tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td>/**<tr><td><a id="l223"></a><a href="#l223">223</a><td> * Creates a shallow clone of this set.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @return {!goog.structs.Set&lt;T&gt;} A new set containing all the same elements as<tr><td><a id="l225"></a><a href="#l225">225</a><td> *     this set.<tr><td><a id="l226"></a><a href="#l226">226</a><td> */<tr><td><a id="l227"></a><a href="#l227">227</a><td>goog.structs.Set.prototype.clone = function() {<tr><td><a id="l228"></a><a href="#l228">228</a><td>  return new goog.structs.Set(this);<tr><td><a id="l229"></a><a href="#l229">229</a><td>};<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td>/**<tr><td><a id="l233"></a><a href="#l233">233</a><td> * Tests whether the given collection consists of the same elements as this set,<tr><td><a id="l234"></a><a href="#l234">234</a><td> * regardless of order, without repetition.  Primitives are treated as equal if<tr><td><a id="l235"></a><a href="#l235">235</a><td> * they have the same type and convert to the same string; objects are treated<tr><td><a id="l236"></a><a href="#l236">236</a><td> * as equal if they are references to the same object.  This operation is O(n).<tr><td><a id="l237"></a><a href="#l237">237</a><td> * @param {goog.structs.Collection&lt;T&gt;|Object} col A collection.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @return {boolean} True if the given collection consists of the same elements<tr><td><a id="l239"></a><a href="#l239">239</a><td> *     as this set, regardless of order, without repetition.<tr><td><a id="l240"></a><a href="#l240">240</a><td> */<tr><td><a id="l241"></a><a href="#l241">241</a><td>goog.structs.Set.prototype.equals = function(col) {<tr><td><a id="l242"></a><a href="#l242">242</a><td>  return this.getCount() == goog.structs.getCount(col) &amp;&amp; this.isSubsetOf(col);<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><tr><td><a id="l246"></a><a href="#l246">246</a><td>/**<tr><td><a id="l247"></a><a href="#l247">247</a><td> * Tests whether the given collection contains all the elements in this set.<tr><td><a id="l248"></a><a href="#l248">248</a><td> * Primitives are treated as equal if they have the same type and convert to the<tr><td><a id="l249"></a><a href="#l249">249</a><td> * same string; objects are treated as equal if they are references to the same<tr><td><a id="l250"></a><a href="#l250">250</a><td> * object.  This operation is O(n).<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @param {goog.structs.Collection&lt;T&gt;|Object} col A collection.<tr><td><a id="l252"></a><a href="#l252">252</a><td> * @return {boolean} True if this set is a subset of the given collection.<tr><td><a id="l253"></a><a href="#l253">253</a><td> */<tr><td><a id="l254"></a><a href="#l254">254</a><td>goog.structs.Set.prototype.isSubsetOf = function(col) {<tr><td><a id="l255"></a><a href="#l255">255</a><td>  var colCount = goog.structs.getCount(col);<tr><td><a id="l256"></a><a href="#l256">256</a><td>  if (this.getCount() &gt; colCount) {<tr><td><a id="l257"></a><a href="#l257">257</a><td>    return false;<tr><td><a id="l258"></a><a href="#l258">258</a><td>  }<tr><td><a id="l259"></a><a href="#l259">259</a><td>  // TODO(user) Find the minimal collection size where the conversion makes<tr><td><a id="l260"></a><a href="#l260">260</a><td>  // the contains() method faster.<tr><td><a id="l261"></a><a href="#l261">261</a><td>  if (!(col instanceof goog.structs.Set) &amp;&amp; colCount &gt; 5) {<tr><td><a id="l262"></a><a href="#l262">262</a><td>    // Convert to a goog.structs.Set so that goog.structs.contains runs in<tr><td><a id="l263"></a><a href="#l263">263</a><td>    // O(1) time instead of O(n) time.<tr><td><a id="l264"></a><a href="#l264">264</a><td>    col = new goog.structs.Set(col);<tr><td><a id="l265"></a><a href="#l265">265</a><td>  }<tr><td><a id="l266"></a><a href="#l266">266</a><td>  return goog.structs.every(this, function(value) {<tr><td><a id="l267"></a><a href="#l267">267</a><td>    return goog.structs.contains(col, value);<tr><td><a id="l268"></a><a href="#l268">268</a><td>  });<tr><td><a id="l269"></a><a href="#l269">269</a><td>};<tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td><tr><td><a id="l272"></a><a href="#l272">272</a><td>/**<tr><td><a id="l273"></a><a href="#l273">273</a><td> * Returns an iterator that iterates over the elements in this set.<tr><td><a id="l274"></a><a href="#l274">274</a><td> * @param {boolean=} opt_keys This argument is ignored.<tr><td><a id="l275"></a><a href="#l275">275</a><td> * @return {!goog.iter.Iterator} An iterator over the elements in this set.<tr><td><a id="l276"></a><a href="#l276">276</a><td> */<tr><td><a id="l277"></a><a href="#l277">277</a><td>goog.structs.Set.prototype.__iterator__ = function(opt_keys) {<tr><td><a id="l278"></a><a href="#l278">278</a><td>  return this.map_.__iterator__(false);<tr><td><a id="l279"></a><a href="#l279">279</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/structs/structs.js.src.html b/docs/source/lib/goog/structs/structs.js.src.html
index bdc37d2..787c1a2 100644
--- a/docs/source/lib/goog/structs/structs.js.src.html
+++ b/docs/source/lib/goog/structs/structs.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>structs.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/structs/structs.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Generics method for collection-like classes and objects.<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a name="l19" href="#l19">19</a><td> *<tr><td><a name="l20" href="#l20">20</a><td> * This file contains functions to work with collections. It supports using<tr><td><a name="l21" href="#l21">21</a><td> * Map, Set, Array and Object and other classes that implement collection-like<tr><td><a name="l22" href="#l22">22</a><td> * methods.<tr><td><a name="l23" href="#l23">23</a><td> */<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>goog.provide(&#39;goog.structs&#39;);<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l29" href="#l29">29</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td>// We treat an object as a dictionary if it has getKeys or it is an object that<tr><td><a name="l33" href="#l33">33</a><td>// isn&#39;t arrayLike.<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td>/**<tr><td><a name="l37" href="#l37">37</a><td> * Returns the number of values in the collection-like object.<tr><td><a name="l38" href="#l38">38</a><td> * @param {Object} col The collection-like object.<tr><td><a name="l39" href="#l39">39</a><td> * @return {number} The number of values in the collection-like object.<tr><td><a name="l40" href="#l40">40</a><td> */<tr><td><a name="l41" href="#l41">41</a><td>goog.structs.getCount = function(col) {<tr><td><a name="l42" href="#l42">42</a><td>  if (typeof col.getCount == &#39;function&#39;) {<tr><td><a name="l43" href="#l43">43</a><td>    return col.getCount();<tr><td><a name="l44" href="#l44">44</a><td>  }<tr><td><a name="l45" href="#l45">45</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l46" href="#l46">46</a><td>    return col.length;<tr><td><a name="l47" href="#l47">47</a><td>  }<tr><td><a name="l48" href="#l48">48</a><td>  return goog.object.getCount(col);<tr><td><a name="l49" href="#l49">49</a><td>};<tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td>/**<tr><td><a name="l53" href="#l53">53</a><td> * Returns the values of the collection-like object.<tr><td><a name="l54" href="#l54">54</a><td> * @param {Object} col The collection-like object.<tr><td><a name="l55" href="#l55">55</a><td> * @return {!Array} The values in the collection-like object.<tr><td><a name="l56" href="#l56">56</a><td> */<tr><td><a name="l57" href="#l57">57</a><td>goog.structs.getValues = function(col) {<tr><td><a name="l58" href="#l58">58</a><td>  if (typeof col.getValues == &#39;function&#39;) {<tr><td><a name="l59" href="#l59">59</a><td>    return col.getValues();<tr><td><a name="l60" href="#l60">60</a><td>  }<tr><td><a name="l61" href="#l61">61</a><td>  if (goog.isString(col)) {<tr><td><a name="l62" href="#l62">62</a><td>    return col.split(&#39;&#39;);<tr><td><a name="l63" href="#l63">63</a><td>  }<tr><td><a name="l64" href="#l64">64</a><td>  if (goog.isArrayLike(col)) {<tr><td><a name="l65" href="#l65">65</a><td>    var rv = [];<tr><td><a name="l66" href="#l66">66</a><td>    var l = col.length;<tr><td><a name="l67" href="#l67">67</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a name="l68" href="#l68">68</a><td>      rv.push(col[i]);<tr><td><a name="l69" href="#l69">69</a><td>    }<tr><td><a name="l70" href="#l70">70</a><td>    return rv;<tr><td><a name="l71" href="#l71">71</a><td>  }<tr><td><a name="l72" href="#l72">72</a><td>  return goog.object.getValues(col);<tr><td><a name="l73" href="#l73">73</a><td>};<tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td>/**<tr><td><a name="l77" href="#l77">77</a><td> * Returns the keys of the collection. Some collections have no notion of<tr><td><a name="l78" href="#l78">78</a><td> * keys/indexes and this function will return undefined in those cases.<tr><td><a name="l79" href="#l79">79</a><td> * @param {Object} col The collection-like object.<tr><td><a name="l80" href="#l80">80</a><td> * @return {!Array|undefined} The keys in the collection.<tr><td><a name="l81" href="#l81">81</a><td> */<tr><td><a name="l82" href="#l82">82</a><td>goog.structs.getKeys = function(col) {<tr><td><a name="l83" href="#l83">83</a><td>  if (typeof col.getKeys == &#39;function&#39;) {<tr><td><a name="l84" href="#l84">84</a><td>    return col.getKeys();<tr><td><a name="l85" href="#l85">85</a><td>  }<tr><td><a name="l86" href="#l86">86</a><td>  // if we have getValues but no getKeys we know this is a key-less collection<tr><td><a name="l87" href="#l87">87</a><td>  if (typeof col.getValues == &#39;function&#39;) {<tr><td><a name="l88" href="#l88">88</a><td>    return undefined;<tr><td><a name="l89" href="#l89">89</a><td>  }<tr><td><a name="l90" href="#l90">90</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l91" href="#l91">91</a><td>    var rv = [];<tr><td><a name="l92" href="#l92">92</a><td>    var l = col.length;<tr><td><a name="l93" href="#l93">93</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a name="l94" href="#l94">94</a><td>      rv.push(i);<tr><td><a name="l95" href="#l95">95</a><td>    }<tr><td><a name="l96" href="#l96">96</a><td>    return rv;<tr><td><a name="l97" href="#l97">97</a><td>  }<tr><td><a name="l98" href="#l98">98</a><td><tr><td><a name="l99" href="#l99">99</a><td>  return goog.object.getKeys(col);<tr><td><a name="l100" href="#l100">100</a><td>};<tr><td><a name="l101" href="#l101">101</a><td><tr><td><a name="l102" href="#l102">102</a><td><tr><td><a name="l103" href="#l103">103</a><td>/**<tr><td><a name="l104" href="#l104">104</a><td> * Whether the collection contains the given value. This is O(n) and uses<tr><td><a name="l105" href="#l105">105</a><td> * equals (==) to test the existence.<tr><td><a name="l106" href="#l106">106</a><td> * @param {Object} col The collection-like object.<tr><td><a name="l107" href="#l107">107</a><td> * @param {*} val The value to check for.<tr><td><a name="l108" href="#l108">108</a><td> * @return {boolean} True if the map contains the value.<tr><td><a name="l109" href="#l109">109</a><td> */<tr><td><a name="l110" href="#l110">110</a><td>goog.structs.contains = function(col, val) {<tr><td><a name="l111" href="#l111">111</a><td>  if (typeof col.contains == &#39;function&#39;) {<tr><td><a name="l112" href="#l112">112</a><td>    return col.contains(val);<tr><td><a name="l113" href="#l113">113</a><td>  }<tr><td><a name="l114" href="#l114">114</a><td>  if (typeof col.containsValue == &#39;function&#39;) {<tr><td><a name="l115" href="#l115">115</a><td>    return col.containsValue(val);<tr><td><a name="l116" href="#l116">116</a><td>  }<tr><td><a name="l117" href="#l117">117</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l118" href="#l118">118</a><td>    return goog.array.contains(/** @type {Array} */ (col), val);<tr><td><a name="l119" href="#l119">119</a><td>  }<tr><td><a name="l120" href="#l120">120</a><td>  return goog.object.containsValue(col, val);<tr><td><a name="l121" href="#l121">121</a><td>};<tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td><tr><td><a name="l124" href="#l124">124</a><td>/**<tr><td><a name="l125" href="#l125">125</a><td> * Whether the collection is empty.<tr><td><a name="l126" href="#l126">126</a><td> * @param {Object} col The collection-like object.<tr><td><a name="l127" href="#l127">127</a><td> * @return {boolean} True if empty.<tr><td><a name="l128" href="#l128">128</a><td> */<tr><td><a name="l129" href="#l129">129</a><td>goog.structs.isEmpty = function(col) {<tr><td><a name="l130" href="#l130">130</a><td>  if (typeof col.isEmpty == &#39;function&#39;) {<tr><td><a name="l131" href="#l131">131</a><td>    return col.isEmpty();<tr><td><a name="l132" href="#l132">132</a><td>  }<tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td>  // We do not use goog.string.isEmpty because here we treat the string as<tr><td><a name="l135" href="#l135">135</a><td>  // collection and as such even whitespace matters<tr><td><a name="l136" href="#l136">136</a><td><tr><td><a name="l137" href="#l137">137</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l138" href="#l138">138</a><td>    return goog.array.isEmpty(/** @type {Array} */ (col));<tr><td><a name="l139" href="#l139">139</a><td>  }<tr><td><a name="l140" href="#l140">140</a><td>  return goog.object.isEmpty(col);<tr><td><a name="l141" href="#l141">141</a><td>};<tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td>/**<tr><td><a name="l145" href="#l145">145</a><td> * Removes all the elements from the collection.<tr><td><a name="l146" href="#l146">146</a><td> * @param {Object} col The collection-like object.<tr><td><a name="l147" href="#l147">147</a><td> */<tr><td><a name="l148" href="#l148">148</a><td>goog.structs.clear = function(col) {<tr><td><a name="l149" href="#l149">149</a><td>  // NOTE(arv): This should not contain strings because strings are immutable<tr><td><a name="l150" href="#l150">150</a><td>  if (typeof col.clear == &#39;function&#39;) {<tr><td><a name="l151" href="#l151">151</a><td>    col.clear();<tr><td><a name="l152" href="#l152">152</a><td>  } else if (goog.isArrayLike(col)) {<tr><td><a name="l153" href="#l153">153</a><td>    goog.array.clear(/** @type {goog.array.ArrayLike} */ (col));<tr><td><a name="l154" href="#l154">154</a><td>  } else {<tr><td><a name="l155" href="#l155">155</a><td>    goog.object.clear(col);<tr><td><a name="l156" href="#l156">156</a><td>  }<tr><td><a name="l157" href="#l157">157</a><td>};<tr><td><a name="l158" href="#l158">158</a><td><tr><td><a name="l159" href="#l159">159</a><td><tr><td><a name="l160" href="#l160">160</a><td>/**<tr><td><a name="l161" href="#l161">161</a><td> * Calls a function for each value in a collection. The function takes<tr><td><a name="l162" href="#l162">162</a><td> * three arguments; the value, the key and the collection.<tr><td><a name="l163" href="#l163">163</a><td> *<tr><td><a name="l164" href="#l164">164</a><td> * @param {S} col The collection-like object.<tr><td><a name="l165" href="#l165">165</a><td> * @param {function(this:T,?,?,S):?} f The function to call for every value.<tr><td><a name="l166" href="#l166">166</a><td> *     This function takes<tr><td><a name="l167" href="#l167">167</a><td> *     3 arguments (the value, the key or undefined if the collection has no<tr><td><a name="l168" href="#l168">168</a><td> *     notion of keys, and the collection) and the return value is irrelevant.<tr><td><a name="l169" href="#l169">169</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l170" href="#l170">170</a><td> *     within {@code f}.<tr><td><a name="l171" href="#l171">171</a><td> * @template T,S<tr><td><a name="l172" href="#l172">172</a><td> */<tr><td><a name="l173" href="#l173">173</a><td>goog.structs.forEach = function(col, f, opt_obj) {<tr><td><a name="l174" href="#l174">174</a><td>  if (typeof col.forEach == &#39;function&#39;) {<tr><td><a name="l175" href="#l175">175</a><td>    col.forEach(f, opt_obj);<tr><td><a name="l176" href="#l176">176</a><td>  } else if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l177" href="#l177">177</a><td>    goog.array.forEach(/** @type {Array} */ (col), f, opt_obj);<tr><td><a name="l178" href="#l178">178</a><td>  } else {<tr><td><a name="l179" href="#l179">179</a><td>    var keys = goog.structs.getKeys(col);<tr><td><a name="l180" href="#l180">180</a><td>    var values = goog.structs.getValues(col);<tr><td><a name="l181" href="#l181">181</a><td>    var l = values.length;<tr><td><a name="l182" href="#l182">182</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a name="l183" href="#l183">183</a><td>      f.call(opt_obj, values[i], keys &amp;&amp; keys[i], col);<tr><td><a name="l184" href="#l184">184</a><td>    }<tr><td><a name="l185" href="#l185">185</a><td>  }<tr><td><a name="l186" href="#l186">186</a><td>};<tr><td><a name="l187" href="#l187">187</a><td><tr><td><a name="l188" href="#l188">188</a><td><tr><td><a name="l189" href="#l189">189</a><td>/**<tr><td><a name="l190" href="#l190">190</a><td> * Calls a function for every value in the collection. When a call returns true,<tr><td><a name="l191" href="#l191">191</a><td> * adds the value to a new collection (Array is returned by default).<tr><td><a name="l192" href="#l192">192</a><td> *<tr><td><a name="l193" href="#l193">193</a><td> * @param {S} col The collection-like object.<tr><td><a name="l194" href="#l194">194</a><td> * @param {function(this:T,?,?,S):boolean} f The function to call for every<tr><td><a name="l195" href="#l195">195</a><td> *     value. This function takes<tr><td><a name="l196" href="#l196">196</a><td> *     3 arguments (the value, the key or undefined if the collection has no<tr><td><a name="l197" href="#l197">197</a><td> *     notion of keys, and the collection) and should return a Boolean. If the<tr><td><a name="l198" href="#l198">198</a><td> *     return value is true the value is added to the result collection. If it<tr><td><a name="l199" href="#l199">199</a><td> *     is false the value is not included.<tr><td><a name="l200" href="#l200">200</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a name="l201" href="#l201">201</a><td> *     within {@code f}.<tr><td><a name="l202" href="#l202">202</a><td> * @return {!Object|!Array} A new collection where the passed values are<tr><td><a name="l203" href="#l203">203</a><td> *     present. If col is a key-less collection an array is returned.  If col<tr><td><a name="l204" href="#l204">204</a><td> *     has keys and values a plain old JS object is returned.<tr><td><a name="l205" href="#l205">205</a><td> * @template T,S<tr><td><a name="l206" href="#l206">206</a><td> */<tr><td><a name="l207" href="#l207">207</a><td>goog.structs.filter = function(col, f, opt_obj) {<tr><td><a name="l208" href="#l208">208</a><td>  if (typeof col.filter == &#39;function&#39;) {<tr><td><a name="l209" href="#l209">209</a><td>    return col.filter(f, opt_obj);<tr><td><a name="l210" href="#l210">210</a><td>  }<tr><td><a name="l211" href="#l211">211</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l212" href="#l212">212</a><td>    return goog.array.filter(/** @type {!Array} */ (col), f, opt_obj);<tr><td><a name="l213" href="#l213">213</a><td>  }<tr><td><a name="l214" href="#l214">214</a><td><tr><td><a name="l215" href="#l215">215</a><td>  var rv;<tr><td><a name="l216" href="#l216">216</a><td>  var keys = goog.structs.getKeys(col);<tr><td><a name="l217" href="#l217">217</a><td>  var values = goog.structs.getValues(col);<tr><td><a name="l218" href="#l218">218</a><td>  var l = values.length;<tr><td><a name="l219" href="#l219">219</a><td>  if (keys) {<tr><td><a name="l220" href="#l220">220</a><td>    rv = {};<tr><td><a name="l221" href="#l221">221</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a name="l222" href="#l222">222</a><td>      if (f.call(opt_obj, values[i], keys[i], col)) {<tr><td><a name="l223" href="#l223">223</a><td>        rv[keys[i]] = values[i];<tr><td><a name="l224" href="#l224">224</a><td>      }<tr><td><a name="l225" href="#l225">225</a><td>    }<tr><td><a name="l226" href="#l226">226</a><td>  } else {<tr><td><a name="l227" href="#l227">227</a><td>    // We should not use goog.array.filter here since we want to make sure that<tr><td><a name="l228" href="#l228">228</a><td>    // the index is undefined as well as make sure that col is passed to the<tr><td><a name="l229" href="#l229">229</a><td>    // function.<tr><td><a name="l230" href="#l230">230</a><td>    rv = [];<tr><td><a name="l231" href="#l231">231</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a name="l232" href="#l232">232</a><td>      if (f.call(opt_obj, values[i], undefined, col)) {<tr><td><a name="l233" href="#l233">233</a><td>        rv.push(values[i]);<tr><td><a name="l234" href="#l234">234</a><td>      }<tr><td><a name="l235" href="#l235">235</a><td>    }<tr><td><a name="l236" href="#l236">236</a><td>  }<tr><td><a name="l237" href="#l237">237</a><td>  return rv;<tr><td><a name="l238" href="#l238">238</a><td>};<tr><td><a name="l239" href="#l239">239</a><td><tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td>/**<tr><td><a name="l242" href="#l242">242</a><td> * Calls a function for every value in the collection and adds the result into a<tr><td><a name="l243" href="#l243">243</a><td> * new collection (defaults to creating a new Array).<tr><td><a name="l244" href="#l244">244</a><td> *<tr><td><a name="l245" href="#l245">245</a><td> * @param {S} col The collection-like object.<tr><td><a name="l246" href="#l246">246</a><td> * @param {function(this:T,?,?,S):V} f The function to call for every value.<tr><td><a name="l247" href="#l247">247</a><td> *     This function takes 3 arguments (the value, the key or undefined if the<tr><td><a name="l248" href="#l248">248</a><td> *     collection has no notion of keys, and the collection) and should return<tr><td><a name="l249" href="#l249">249</a><td> *     something. The result will be used as the value in the new collection.<tr><td><a name="l250" href="#l250">250</a><td> * @param {T=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a name="l251" href="#l251">251</a><td> *     within {@code f}.<tr><td><a name="l252" href="#l252">252</a><td> * @return {!Object.&lt;V&gt;|!Array.&lt;V&gt;} A new collection with the new values.  If<tr><td><a name="l253" href="#l253">253</a><td> *     col is a key-less collection an array is returned.  If col has keys and<tr><td><a name="l254" href="#l254">254</a><td> *     values a plain old JS object is returned.<tr><td><a name="l255" href="#l255">255</a><td> * @template T,S,V<tr><td><a name="l256" href="#l256">256</a><td> */<tr><td><a name="l257" href="#l257">257</a><td>goog.structs.map = function(col, f, opt_obj) {<tr><td><a name="l258" href="#l258">258</a><td>  if (typeof col.map == &#39;function&#39;) {<tr><td><a name="l259" href="#l259">259</a><td>    return col.map(f, opt_obj);<tr><td><a name="l260" href="#l260">260</a><td>  }<tr><td><a name="l261" href="#l261">261</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l262" href="#l262">262</a><td>    return goog.array.map(/** @type {!Array} */ (col), f, opt_obj);<tr><td><a name="l263" href="#l263">263</a><td>  }<tr><td><a name="l264" href="#l264">264</a><td><tr><td><a name="l265" href="#l265">265</a><td>  var rv;<tr><td><a name="l266" href="#l266">266</a><td>  var keys = goog.structs.getKeys(col);<tr><td><a name="l267" href="#l267">267</a><td>  var values = goog.structs.getValues(col);<tr><td><a name="l268" href="#l268">268</a><td>  var l = values.length;<tr><td><a name="l269" href="#l269">269</a><td>  if (keys) {<tr><td><a name="l270" href="#l270">270</a><td>    rv = {};<tr><td><a name="l271" href="#l271">271</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a name="l272" href="#l272">272</a><td>      rv[keys[i]] = f.call(opt_obj, values[i], keys[i], col);<tr><td><a name="l273" href="#l273">273</a><td>    }<tr><td><a name="l274" href="#l274">274</a><td>  } else {<tr><td><a name="l275" href="#l275">275</a><td>    // We should not use goog.array.map here since we want to make sure that<tr><td><a name="l276" href="#l276">276</a><td>    // the index is undefined as well as make sure that col is passed to the<tr><td><a name="l277" href="#l277">277</a><td>    // function.<tr><td><a name="l278" href="#l278">278</a><td>    rv = [];<tr><td><a name="l279" href="#l279">279</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a name="l280" href="#l280">280</a><td>      rv[i] = f.call(opt_obj, values[i], undefined, col);<tr><td><a name="l281" href="#l281">281</a><td>    }<tr><td><a name="l282" href="#l282">282</a><td>  }<tr><td><a name="l283" href="#l283">283</a><td>  return rv;<tr><td><a name="l284" href="#l284">284</a><td>};<tr><td><a name="l285" href="#l285">285</a><td><tr><td><a name="l286" href="#l286">286</a><td><tr><td><a name="l287" href="#l287">287</a><td>/**<tr><td><a name="l288" href="#l288">288</a><td> * Calls f for each value in a collection. If any call returns true this returns<tr><td><a name="l289" href="#l289">289</a><td> * true (without checking the rest). If all returns false this returns false.<tr><td><a name="l290" href="#l290">290</a><td> *<tr><td><a name="l291" href="#l291">291</a><td> * @param {S} col The collection-like object.<tr><td><a name="l292" href="#l292">292</a><td> * @param {function(this:T,?,?,S):boolean} f The function to call for every<tr><td><a name="l293" href="#l293">293</a><td> *     value. This function takes 3 arguments (the value, the key or undefined<tr><td><a name="l294" href="#l294">294</a><td> *     if the collection has no notion of keys, and the collection) and should<tr><td><a name="l295" href="#l295">295</a><td> *     return a boolean.<tr><td><a name="l296" href="#l296">296</a><td> * @param {T=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a name="l297" href="#l297">297</a><td> *     within {@code f}.<tr><td><a name="l298" href="#l298">298</a><td> * @return {boolean} True if any value passes the test.<tr><td><a name="l299" href="#l299">299</a><td> * @template T,S<tr><td><a name="l300" href="#l300">300</a><td> */<tr><td><a name="l301" href="#l301">301</a><td>goog.structs.some = function(col, f, opt_obj) {<tr><td><a name="l302" href="#l302">302</a><td>  if (typeof col.some == &#39;function&#39;) {<tr><td><a name="l303" href="#l303">303</a><td>    return col.some(f, opt_obj);<tr><td><a name="l304" href="#l304">304</a><td>  }<tr><td><a name="l305" href="#l305">305</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l306" href="#l306">306</a><td>    return goog.array.some(/** @type {!Array} */ (col), f, opt_obj);<tr><td><a name="l307" href="#l307">307</a><td>  }<tr><td><a name="l308" href="#l308">308</a><td>  var keys = goog.structs.getKeys(col);<tr><td><a name="l309" href="#l309">309</a><td>  var values = goog.structs.getValues(col);<tr><td><a name="l310" href="#l310">310</a><td>  var l = values.length;<tr><td><a name="l311" href="#l311">311</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a name="l312" href="#l312">312</a><td>    if (f.call(opt_obj, values[i], keys &amp;&amp; keys[i], col)) {<tr><td><a name="l313" href="#l313">313</a><td>      return true;<tr><td><a name="l314" href="#l314">314</a><td>    }<tr><td><a name="l315" href="#l315">315</a><td>  }<tr><td><a name="l316" href="#l316">316</a><td>  return false;<tr><td><a name="l317" href="#l317">317</a><td>};<tr><td><a name="l318" href="#l318">318</a><td><tr><td><a name="l319" href="#l319">319</a><td><tr><td><a name="l320" href="#l320">320</a><td>/**<tr><td><a name="l321" href="#l321">321</a><td> * Calls f for each value in a collection. If all calls return true this return<tr><td><a name="l322" href="#l322">322</a><td> * true this returns true. If any returns false this returns false at this point<tr><td><a name="l323" href="#l323">323</a><td> *  and does not continue to check the remaining values.<tr><td><a name="l324" href="#l324">324</a><td> *<tr><td><a name="l325" href="#l325">325</a><td> * @param {S} col The collection-like object.<tr><td><a name="l326" href="#l326">326</a><td> * @param {function(this:T,?,?,S):boolean} f The function to call for every<tr><td><a name="l327" href="#l327">327</a><td> *     value. This function takes 3 arguments (the value, the key or<tr><td><a name="l328" href="#l328">328</a><td> *     undefined if the collection has no notion of keys, and the collection)<tr><td><a name="l329" href="#l329">329</a><td> *     and should return a boolean.<tr><td><a name="l330" href="#l330">330</a><td> * @param {T=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a name="l331" href="#l331">331</a><td> *     within {@code f}.<tr><td><a name="l332" href="#l332">332</a><td> * @return {boolean} True if all key-value pairs pass the test.<tr><td><a name="l333" href="#l333">333</a><td> * @template T,S<tr><td><a name="l334" href="#l334">334</a><td> */<tr><td><a name="l335" href="#l335">335</a><td>goog.structs.every = function(col, f, opt_obj) {<tr><td><a name="l336" href="#l336">336</a><td>  if (typeof col.every == &#39;function&#39;) {<tr><td><a name="l337" href="#l337">337</a><td>    return col.every(f, opt_obj);<tr><td><a name="l338" href="#l338">338</a><td>  }<tr><td><a name="l339" href="#l339">339</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a name="l340" href="#l340">340</a><td>    return goog.array.every(/** @type {!Array} */ (col), f, opt_obj);<tr><td><a name="l341" href="#l341">341</a><td>  }<tr><td><a name="l342" href="#l342">342</a><td>  var keys = goog.structs.getKeys(col);<tr><td><a name="l343" href="#l343">343</a><td>  var values = goog.structs.getValues(col);<tr><td><a name="l344" href="#l344">344</a><td>  var l = values.length;<tr><td><a name="l345" href="#l345">345</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a name="l346" href="#l346">346</a><td>    if (!f.call(opt_obj, values[i], keys &amp;&amp; keys[i], col)) {<tr><td><a name="l347" href="#l347">347</a><td>      return false;<tr><td><a name="l348" href="#l348">348</a><td>    }<tr><td><a name="l349" href="#l349">349</a><td>  }<tr><td><a name="l350" href="#l350">350</a><td>  return true;<tr><td><a name="l351" href="#l351">351</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>structs.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/structs/structs.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Generics method for collection-like classes and objects.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * This file contains functions to work with collections. It supports using<tr><td><a id="l21"></a><a href="#l21">21</a><td> * Map, Set, Array and Object and other classes that implement collection-like<tr><td><a id="l22"></a><a href="#l22">22</a><td> * methods.<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>goog.provide(&#39;goog.structs&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>// We treat an object as a dictionary if it has getKeys or it is an object that<tr><td><a id="l33"></a><a href="#l33">33</a><td>// isn&#39;t arrayLike.<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> * Returns the number of values in the collection-like object.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @param {Object} col The collection-like object.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @return {number} The number of values in the collection-like object.<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.structs.getCount = function(col) {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  if (col.getCount &amp;&amp; typeof col.getCount == &#39;function&#39;) {<tr><td><a id="l43"></a><a href="#l43">43</a><td>    return col.getCount();<tr><td><a id="l44"></a><a href="#l44">44</a><td>  }<tr><td><a id="l45"></a><a href="#l45">45</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l46"></a><a href="#l46">46</a><td>    return col.length;<tr><td><a id="l47"></a><a href="#l47">47</a><td>  }<tr><td><a id="l48"></a><a href="#l48">48</a><td>  return goog.object.getCount(col);<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>/**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * Returns the values of the collection-like object.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {Object} col The collection-like object.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @return {!Array&lt;?&gt;} The values in the collection-like object.<tr><td><a id="l56"></a><a href="#l56">56</a><td> */<tr><td><a id="l57"></a><a href="#l57">57</a><td>goog.structs.getValues = function(col) {<tr><td><a id="l58"></a><a href="#l58">58</a><td>  if (col.getValues &amp;&amp; typeof col.getValues == &#39;function&#39;) {<tr><td><a id="l59"></a><a href="#l59">59</a><td>    return col.getValues();<tr><td><a id="l60"></a><a href="#l60">60</a><td>  }<tr><td><a id="l61"></a><a href="#l61">61</a><td>  if (goog.isString(col)) {<tr><td><a id="l62"></a><a href="#l62">62</a><td>    return col.split(&#39;&#39;);<tr><td><a id="l63"></a><a href="#l63">63</a><td>  }<tr><td><a id="l64"></a><a href="#l64">64</a><td>  if (goog.isArrayLike(col)) {<tr><td><a id="l65"></a><a href="#l65">65</a><td>    var rv = [];<tr><td><a id="l66"></a><a href="#l66">66</a><td>    var l = col.length;<tr><td><a id="l67"></a><a href="#l67">67</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>      rv.push(col[i]);<tr><td><a id="l69"></a><a href="#l69">69</a><td>    }<tr><td><a id="l70"></a><a href="#l70">70</a><td>    return rv;<tr><td><a id="l71"></a><a href="#l71">71</a><td>  }<tr><td><a id="l72"></a><a href="#l72">72</a><td>  return goog.object.getValues(col);<tr><td><a id="l73"></a><a href="#l73">73</a><td>};<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * Returns the keys of the collection. Some collections have no notion of<tr><td><a id="l78"></a><a href="#l78">78</a><td> * keys/indexes and this function will return undefined in those cases.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @param {Object} col The collection-like object.<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @return {!Array|undefined} The keys in the collection.<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.structs.getKeys = function(col) {<tr><td><a id="l83"></a><a href="#l83">83</a><td>  if (col.getKeys &amp;&amp; typeof col.getKeys == &#39;function&#39;) {<tr><td><a id="l84"></a><a href="#l84">84</a><td>    return col.getKeys();<tr><td><a id="l85"></a><a href="#l85">85</a><td>  }<tr><td><a id="l86"></a><a href="#l86">86</a><td>  // if we have getValues but no getKeys we know this is a key-less collection<tr><td><a id="l87"></a><a href="#l87">87</a><td>  if (col.getValues &amp;&amp; typeof col.getValues == &#39;function&#39;) {<tr><td><a id="l88"></a><a href="#l88">88</a><td>    return undefined;<tr><td><a id="l89"></a><a href="#l89">89</a><td>  }<tr><td><a id="l90"></a><a href="#l90">90</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l91"></a><a href="#l91">91</a><td>    var rv = [];<tr><td><a id="l92"></a><a href="#l92">92</a><td>    var l = col.length;<tr><td><a id="l93"></a><a href="#l93">93</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a id="l94"></a><a href="#l94">94</a><td>      rv.push(i);<tr><td><a id="l95"></a><a href="#l95">95</a><td>    }<tr><td><a id="l96"></a><a href="#l96">96</a><td>    return rv;<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>  return goog.object.getKeys(col);<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>/**<tr><td><a id="l104"></a><a href="#l104">104</a><td> * Whether the collection contains the given value. This is O(n) and uses<tr><td><a id="l105"></a><a href="#l105">105</a><td> * equals (==) to test the existence.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @param {Object} col The collection-like object.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @param {*} val The value to check for.<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @return {boolean} True if the map contains the value.<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.structs.contains = function(col, val) {<tr><td><a id="l111"></a><a href="#l111">111</a><td>  if (col.contains &amp;&amp; typeof col.contains == &#39;function&#39;) {<tr><td><a id="l112"></a><a href="#l112">112</a><td>    return col.contains(val);<tr><td><a id="l113"></a><a href="#l113">113</a><td>  }<tr><td><a id="l114"></a><a href="#l114">114</a><td>  if (col.containsValue &amp;&amp; typeof col.containsValue == &#39;function&#39;) {<tr><td><a id="l115"></a><a href="#l115">115</a><td>    return col.containsValue(val);<tr><td><a id="l116"></a><a href="#l116">116</a><td>  }<tr><td><a id="l117"></a><a href="#l117">117</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    return goog.array.contains(/** @type {!Array&lt;?&gt;} */ (col), val);<tr><td><a id="l119"></a><a href="#l119">119</a><td>  }<tr><td><a id="l120"></a><a href="#l120">120</a><td>  return goog.object.containsValue(col, val);<tr><td><a id="l121"></a><a href="#l121">121</a><td>};<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td><tr><td><a id="l124"></a><a href="#l124">124</a><td>/**<tr><td><a id="l125"></a><a href="#l125">125</a><td> * Whether the collection is empty.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @param {Object} col The collection-like object.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @return {boolean} True if empty.<tr><td><a id="l128"></a><a href="#l128">128</a><td> */<tr><td><a id="l129"></a><a href="#l129">129</a><td>goog.structs.isEmpty = function(col) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>  if (col.isEmpty &amp;&amp; typeof col.isEmpty == &#39;function&#39;) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>    return col.isEmpty();<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>  // We do not use goog.string.isEmptyOrWhitespace because here we treat the string as<tr><td><a id="l135"></a><a href="#l135">135</a><td>  // collection and as such even whitespace matters<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l138"></a><a href="#l138">138</a><td>    return goog.array.isEmpty(/** @type {!Array&lt;?&gt;} */ (col));<tr><td><a id="l139"></a><a href="#l139">139</a><td>  }<tr><td><a id="l140"></a><a href="#l140">140</a><td>  return goog.object.isEmpty(col);<tr><td><a id="l141"></a><a href="#l141">141</a><td>};<tr><td><a id="l142"></a><a href="#l142">142</a><td><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> * Removes all the elements from the collection.<tr><td><a id="l146"></a><a href="#l146">146</a><td> * @param {Object} col The collection-like object.<tr><td><a id="l147"></a><a href="#l147">147</a><td> */<tr><td><a id="l148"></a><a href="#l148">148</a><td>goog.structs.clear = function(col) {<tr><td><a id="l149"></a><a href="#l149">149</a><td>  // NOTE(arv): This should not contain strings because strings are immutable<tr><td><a id="l150"></a><a href="#l150">150</a><td>  if (col.clear &amp;&amp; typeof col.clear == &#39;function&#39;) {<tr><td><a id="l151"></a><a href="#l151">151</a><td>    col.clear();<tr><td><a id="l152"></a><a href="#l152">152</a><td>  } else if (goog.isArrayLike(col)) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>    goog.array.clear(/** @type {goog.array.ArrayLike} */ (col));<tr><td><a id="l154"></a><a href="#l154">154</a><td>  } else {<tr><td><a id="l155"></a><a href="#l155">155</a><td>    goog.object.clear(col);<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><tr><td><a id="l160"></a><a href="#l160">160</a><td>/**<tr><td><a id="l161"></a><a href="#l161">161</a><td> * Calls a function for each value in a collection. The function takes<tr><td><a id="l162"></a><a href="#l162">162</a><td> * three arguments; the value, the key and the collection.<tr><td><a id="l163"></a><a href="#l163">163</a><td> *<tr><td><a id="l164"></a><a href="#l164">164</a><td> * NOTE: This will be deprecated soon! Please use a more specific method if<tr><td><a id="l165"></a><a href="#l165">165</a><td> * possible, e.g. goog.array.forEach, goog.object.forEach, etc.<tr><td><a id="l166"></a><a href="#l166">166</a><td> *<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {S} col The collection-like object.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @param {function(this:T,?,?,S):?} f The function to call for every value.<tr><td><a id="l169"></a><a href="#l169">169</a><td> *     This function takes<tr><td><a id="l170"></a><a href="#l170">170</a><td> *     3 arguments (the value, the key or undefined if the collection has no<tr><td><a id="l171"></a><a href="#l171">171</a><td> *     notion of keys, and the collection) and the return value is irrelevant.<tr><td><a id="l172"></a><a href="#l172">172</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a id="l173"></a><a href="#l173">173</a><td> *     within {@code f}.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @template T,S<tr><td><a id="l175"></a><a href="#l175">175</a><td> */<tr><td><a id="l176"></a><a href="#l176">176</a><td>goog.structs.forEach = function(col, f, opt_obj) {<tr><td><a id="l177"></a><a href="#l177">177</a><td>  if (col.forEach &amp;&amp; typeof col.forEach == &#39;function&#39;) {<tr><td><a id="l178"></a><a href="#l178">178</a><td>    col.forEach(f, opt_obj);<tr><td><a id="l179"></a><a href="#l179">179</a><td>  } else if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l180"></a><a href="#l180">180</a><td>    goog.array.forEach(/** @type {!Array&lt;?&gt;} */ (col), f, opt_obj);<tr><td><a id="l181"></a><a href="#l181">181</a><td>  } else {<tr><td><a id="l182"></a><a href="#l182">182</a><td>    var keys = goog.structs.getKeys(col);<tr><td><a id="l183"></a><a href="#l183">183</a><td>    var values = goog.structs.getValues(col);<tr><td><a id="l184"></a><a href="#l184">184</a><td>    var l = values.length;<tr><td><a id="l185"></a><a href="#l185">185</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>      f.call(opt_obj, values[i], keys &amp;&amp; keys[i], col);<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>};<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> * Calls a function for every value in the collection. When a call returns true,<tr><td><a id="l194"></a><a href="#l194">194</a><td> * adds the value to a new collection (Array is returned by default).<tr><td><a id="l195"></a><a href="#l195">195</a><td> *<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @param {S} col The collection-like object.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @param {function(this:T,?,?,S):boolean} f The function to call for every<tr><td><a id="l198"></a><a href="#l198">198</a><td> *     value. This function takes<tr><td><a id="l199"></a><a href="#l199">199</a><td> *     3 arguments (the value, the key or undefined if the collection has no<tr><td><a id="l200"></a><a href="#l200">200</a><td> *     notion of keys, and the collection) and should return a Boolean. If the<tr><td><a id="l201"></a><a href="#l201">201</a><td> *     return value is true the value is added to the result collection. If it<tr><td><a id="l202"></a><a href="#l202">202</a><td> *     is false the value is not included.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {T=} opt_obj The object to be used as the value of &#39;this&#39;<tr><td><a id="l204"></a><a href="#l204">204</a><td> *     within {@code f}.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @return {!Object|!Array&lt;?&gt;} A new collection where the passed values are<tr><td><a id="l206"></a><a href="#l206">206</a><td> *     present. If col is a key-less collection an array is returned.  If col<tr><td><a id="l207"></a><a href="#l207">207</a><td> *     has keys and values a plain old JS object is returned.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @template T,S<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>goog.structs.filter = function(col, f, opt_obj) {<tr><td><a id="l211"></a><a href="#l211">211</a><td>  if (typeof col.filter == &#39;function&#39;) {<tr><td><a id="l212"></a><a href="#l212">212</a><td>    return col.filter(f, opt_obj);<tr><td><a id="l213"></a><a href="#l213">213</a><td>  }<tr><td><a id="l214"></a><a href="#l214">214</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l215"></a><a href="#l215">215</a><td>    return goog.array.filter(/** @type {!Array&lt;?&gt;} */ (col), f, opt_obj);<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>  var rv;<tr><td><a id="l219"></a><a href="#l219">219</a><td>  var keys = goog.structs.getKeys(col);<tr><td><a id="l220"></a><a href="#l220">220</a><td>  var values = goog.structs.getValues(col);<tr><td><a id="l221"></a><a href="#l221">221</a><td>  var l = values.length;<tr><td><a id="l222"></a><a href="#l222">222</a><td>  if (keys) {<tr><td><a id="l223"></a><a href="#l223">223</a><td>    rv = {};<tr><td><a id="l224"></a><a href="#l224">224</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a id="l225"></a><a href="#l225">225</a><td>      if (f.call(opt_obj, values[i], keys[i], col)) {<tr><td><a id="l226"></a><a href="#l226">226</a><td>        rv[keys[i]] = values[i];<tr><td><a id="l227"></a><a href="#l227">227</a><td>      }<tr><td><a id="l228"></a><a href="#l228">228</a><td>    }<tr><td><a id="l229"></a><a href="#l229">229</a><td>  } else {<tr><td><a id="l230"></a><a href="#l230">230</a><td>    // We should not use goog.array.filter here since we want to make sure that<tr><td><a id="l231"></a><a href="#l231">231</a><td>    // the index is undefined as well as make sure that col is passed to the<tr><td><a id="l232"></a><a href="#l232">232</a><td>    // function.<tr><td><a id="l233"></a><a href="#l233">233</a><td>    rv = [];<tr><td><a id="l234"></a><a href="#l234">234</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a id="l235"></a><a href="#l235">235</a><td>      if (f.call(opt_obj, values[i], undefined, col)) {<tr><td><a id="l236"></a><a href="#l236">236</a><td>        rv.push(values[i]);<tr><td><a id="l237"></a><a href="#l237">237</a><td>      }<tr><td><a id="l238"></a><a href="#l238">238</a><td>    }<tr><td><a id="l239"></a><a href="#l239">239</a><td>  }<tr><td><a id="l240"></a><a href="#l240">240</a><td>  return rv;<tr><td><a id="l241"></a><a href="#l241">241</a><td>};<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> * Calls a function for every value in the collection and adds the result into a<tr><td><a id="l246"></a><a href="#l246">246</a><td> * new collection (defaults to creating a new Array).<tr><td><a id="l247"></a><a href="#l247">247</a><td> *<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @param {S} col The collection-like object.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @param {function(this:T,?,?,S):V} f The function to call for every value.<tr><td><a id="l250"></a><a href="#l250">250</a><td> *     This function takes 3 arguments (the value, the key or undefined if the<tr><td><a id="l251"></a><a href="#l251">251</a><td> *     collection has no notion of keys, and the collection) and should return<tr><td><a id="l252"></a><a href="#l252">252</a><td> *     something. The result will be used as the value in the new collection.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @param {T=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a id="l254"></a><a href="#l254">254</a><td> *     within {@code f}.<tr><td><a id="l255"></a><a href="#l255">255</a><td> * @return {!Object&lt;V&gt;|!Array&lt;V&gt;} A new collection with the new values.  If<tr><td><a id="l256"></a><a href="#l256">256</a><td> *     col is a key-less collection an array is returned.  If col has keys and<tr><td><a id="l257"></a><a href="#l257">257</a><td> *     values a plain old JS object is returned.<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @template T,S,V<tr><td><a id="l259"></a><a href="#l259">259</a><td> */<tr><td><a id="l260"></a><a href="#l260">260</a><td>goog.structs.map = function(col, f, opt_obj) {<tr><td><a id="l261"></a><a href="#l261">261</a><td>  if (typeof col.map == &#39;function&#39;) {<tr><td><a id="l262"></a><a href="#l262">262</a><td>    return col.map(f, opt_obj);<tr><td><a id="l263"></a><a href="#l263">263</a><td>  }<tr><td><a id="l264"></a><a href="#l264">264</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>    return goog.array.map(/** @type {!Array&lt;?&gt;} */ (col), f, opt_obj);<tr><td><a id="l266"></a><a href="#l266">266</a><td>  }<tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td>  var rv;<tr><td><a id="l269"></a><a href="#l269">269</a><td>  var keys = goog.structs.getKeys(col);<tr><td><a id="l270"></a><a href="#l270">270</a><td>  var values = goog.structs.getValues(col);<tr><td><a id="l271"></a><a href="#l271">271</a><td>  var l = values.length;<tr><td><a id="l272"></a><a href="#l272">272</a><td>  if (keys) {<tr><td><a id="l273"></a><a href="#l273">273</a><td>    rv = {};<tr><td><a id="l274"></a><a href="#l274">274</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a id="l275"></a><a href="#l275">275</a><td>      rv[keys[i]] = f.call(opt_obj, values[i], keys[i], col);<tr><td><a id="l276"></a><a href="#l276">276</a><td>    }<tr><td><a id="l277"></a><a href="#l277">277</a><td>  } else {<tr><td><a id="l278"></a><a href="#l278">278</a><td>    // We should not use goog.array.map here since we want to make sure that<tr><td><a id="l279"></a><a href="#l279">279</a><td>    // the index is undefined as well as make sure that col is passed to the<tr><td><a id="l280"></a><a href="#l280">280</a><td>    // function.<tr><td><a id="l281"></a><a href="#l281">281</a><td>    rv = [];<tr><td><a id="l282"></a><a href="#l282">282</a><td>    for (var i = 0; i &lt; l; i++) {<tr><td><a id="l283"></a><a href="#l283">283</a><td>      rv[i] = f.call(opt_obj, values[i], undefined, col);<tr><td><a id="l284"></a><a href="#l284">284</a><td>    }<tr><td><a id="l285"></a><a href="#l285">285</a><td>  }<tr><td><a id="l286"></a><a href="#l286">286</a><td>  return rv;<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><tr><td><a id="l290"></a><a href="#l290">290</a><td>/**<tr><td><a id="l291"></a><a href="#l291">291</a><td> * Calls f for each value in a collection. If any call returns true this returns<tr><td><a id="l292"></a><a href="#l292">292</a><td> * true (without checking the rest). If all returns false this returns false.<tr><td><a id="l293"></a><a href="#l293">293</a><td> *<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {S} col The collection-like object.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @param {function(this:T,?,?,S):boolean} f The function to call for every<tr><td><a id="l296"></a><a href="#l296">296</a><td> *     value. This function takes 3 arguments (the value, the key or undefined<tr><td><a id="l297"></a><a href="#l297">297</a><td> *     if the collection has no notion of keys, and the collection) and should<tr><td><a id="l298"></a><a href="#l298">298</a><td> *     return a boolean.<tr><td><a id="l299"></a><a href="#l299">299</a><td> * @param {T=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a id="l300"></a><a href="#l300">300</a><td> *     within {@code f}.<tr><td><a id="l301"></a><a href="#l301">301</a><td> * @return {boolean} True if any value passes the test.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @template T,S<tr><td><a id="l303"></a><a href="#l303">303</a><td> */<tr><td><a id="l304"></a><a href="#l304">304</a><td>goog.structs.some = function(col, f, opt_obj) {<tr><td><a id="l305"></a><a href="#l305">305</a><td>  if (typeof col.some == &#39;function&#39;) {<tr><td><a id="l306"></a><a href="#l306">306</a><td>    return col.some(f, opt_obj);<tr><td><a id="l307"></a><a href="#l307">307</a><td>  }<tr><td><a id="l308"></a><a href="#l308">308</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l309"></a><a href="#l309">309</a><td>    return goog.array.some(/** @type {!Array&lt;?&gt;} */ (col), f, opt_obj);<tr><td><a id="l310"></a><a href="#l310">310</a><td>  }<tr><td><a id="l311"></a><a href="#l311">311</a><td>  var keys = goog.structs.getKeys(col);<tr><td><a id="l312"></a><a href="#l312">312</a><td>  var values = goog.structs.getValues(col);<tr><td><a id="l313"></a><a href="#l313">313</a><td>  var l = values.length;<tr><td><a id="l314"></a><a href="#l314">314</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a id="l315"></a><a href="#l315">315</a><td>    if (f.call(opt_obj, values[i], keys &amp;&amp; keys[i], col)) {<tr><td><a id="l316"></a><a href="#l316">316</a><td>      return true;<tr><td><a id="l317"></a><a href="#l317">317</a><td>    }<tr><td><a id="l318"></a><a href="#l318">318</a><td>  }<tr><td><a id="l319"></a><a href="#l319">319</a><td>  return false;<tr><td><a id="l320"></a><a href="#l320">320</a><td>};<tr><td><a id="l321"></a><a href="#l321">321</a><td><tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td>/**<tr><td><a id="l324"></a><a href="#l324">324</a><td> * Calls f for each value in a collection. If all calls return true this return<tr><td><a id="l325"></a><a href="#l325">325</a><td> * true this returns true. If any returns false this returns false at this point<tr><td><a id="l326"></a><a href="#l326">326</a><td> *  and does not continue to check the remaining values.<tr><td><a id="l327"></a><a href="#l327">327</a><td> *<tr><td><a id="l328"></a><a href="#l328">328</a><td> * @param {S} col The collection-like object.<tr><td><a id="l329"></a><a href="#l329">329</a><td> * @param {function(this:T,?,?,S):boolean} f The function to call for every<tr><td><a id="l330"></a><a href="#l330">330</a><td> *     value. This function takes 3 arguments (the value, the key or<tr><td><a id="l331"></a><a href="#l331">331</a><td> *     undefined if the collection has no notion of keys, and the collection)<tr><td><a id="l332"></a><a href="#l332">332</a><td> *     and should return a boolean.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @param {T=} opt_obj  The object to be used as the value of &#39;this&#39;<tr><td><a id="l334"></a><a href="#l334">334</a><td> *     within {@code f}.<tr><td><a id="l335"></a><a href="#l335">335</a><td> * @return {boolean} True if all key-value pairs pass the test.<tr><td><a id="l336"></a><a href="#l336">336</a><td> * @template T,S<tr><td><a id="l337"></a><a href="#l337">337</a><td> */<tr><td><a id="l338"></a><a href="#l338">338</a><td>goog.structs.every = function(col, f, opt_obj) {<tr><td><a id="l339"></a><a href="#l339">339</a><td>  if (typeof col.every == &#39;function&#39;) {<tr><td><a id="l340"></a><a href="#l340">340</a><td>    return col.every(f, opt_obj);<tr><td><a id="l341"></a><a href="#l341">341</a><td>  }<tr><td><a id="l342"></a><a href="#l342">342</a><td>  if (goog.isArrayLike(col) || goog.isString(col)) {<tr><td><a id="l343"></a><a href="#l343">343</a><td>    return goog.array.every(/** @type {!Array&lt;?&gt;} */ (col), f, opt_obj);<tr><td><a id="l344"></a><a href="#l344">344</a><td>  }<tr><td><a id="l345"></a><a href="#l345">345</a><td>  var keys = goog.structs.getKeys(col);<tr><td><a id="l346"></a><a href="#l346">346</a><td>  var values = goog.structs.getValues(col);<tr><td><a id="l347"></a><a href="#l347">347</a><td>  var l = values.length;<tr><td><a id="l348"></a><a href="#l348">348</a><td>  for (var i = 0; i &lt; l; i++) {<tr><td><a id="l349"></a><a href="#l349">349</a><td>    if (!f.call(opt_obj, values[i], keys &amp;&amp; keys[i], col)) {<tr><td><a id="l350"></a><a href="#l350">350</a><td>      return false;<tr><td><a id="l351"></a><a href="#l351">351</a><td>    }<tr><td><a id="l352"></a><a href="#l352">352</a><td>  }<tr><td><a id="l353"></a><a href="#l353">353</a><td>  return true;<tr><td><a id="l354"></a><a href="#l354">354</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/style/style.js.src.html b/docs/source/lib/goog/style/style.js.src.html
new file mode 100644
index 0000000..854a738
--- /dev/null
+++ b/docs/source/lib/goog/style/style.js.src.html
@@ -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>style.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/style/style.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities for element styles.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l19"></a><a href="#l19">19</a><td> * @author eae@google.com (Emil A Eklund)<tr><td><a id="l20"></a><a href="#l20">20</a><td> * @see ../demos/inline_block_quirks.html<tr><td><a id="l21"></a><a href="#l21">21</a><td> * @see ../demos/inline_block_standards.html<tr><td><a id="l22"></a><a href="#l22">22</a><td> * @see ../demos/style_viewport.html<tr><td><a id="l23"></a><a href="#l23">23</a><td> */<tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.style&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.dom&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.dom.NodeType&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.dom.TagName&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;goog.dom.vendor&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.math.Box&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.math.Coordinate&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.math.Rect&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.math.Size&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.forwardDeclare(&#39;goog.events.BrowserEvent&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.forwardDeclare(&#39;goog.events.Event&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * Sets a style value on an element.<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 function is not indended to patch issues in the browser&#39;s style<tr><td><a id="l50"></a><a href="#l50">50</a><td> * handling, but to allow easy programmatic access to setting dash-separated<tr><td><a id="l51"></a><a href="#l51">51</a><td> * style properties.  An example is setting a batch of properties from a data<tr><td><a id="l52"></a><a href="#l52">52</a><td> * object without overwriting old styles.  When possible, use native APIs:<tr><td><a id="l53"></a><a href="#l53">53</a><td> * elem.style.propertyKey = &#39;value&#39; or (if obliterating old styles is fine)<tr><td><a id="l54"></a><a href="#l54">54</a><td> * elem.style.cssText = &#39;property1: value1; property2: value2&#39;.<tr><td><a id="l55"></a><a href="#l55">55</a><td> *<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @param {Element} element The element to change.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @param {string|Object} style If a string, a style name. If an object, a hash<tr><td><a id="l58"></a><a href="#l58">58</a><td> *     of style names to style values.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @param {string|number|boolean=} opt_value If style was a string, then this<tr><td><a id="l60"></a><a href="#l60">60</a><td> *     should be the value.<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.style.setStyle = function(element, style, opt_value) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  if (goog.isString(style)) {<tr><td><a id="l64"></a><a href="#l64">64</a><td>    goog.style.setStyle_(element, opt_value, style);<tr><td><a id="l65"></a><a href="#l65">65</a><td>  } else {<tr><td><a id="l66"></a><a href="#l66">66</a><td>    for (var key in style) {<tr><td><a id="l67"></a><a href="#l67">67</a><td>      goog.style.setStyle_(element, style[key], key);<tr><td><a id="l68"></a><a href="#l68">68</a><td>    }<tr><td><a id="l69"></a><a href="#l69">69</a><td>  }<tr><td><a id="l70"></a><a href="#l70">70</a><td>};<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> * Sets a style value on an element, with parameters swapped to work with<tr><td><a id="l75"></a><a href="#l75">75</a><td> * {@code goog.object.forEach()}. Prepends a vendor-specific prefix when<tr><td><a id="l76"></a><a href="#l76">76</a><td> * necessary.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {Element} element The element to change.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @param {string|number|boolean|undefined} value Style value.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @param {string} style Style name.<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @private<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.style.setStyle_ = function(element, value, style) {<tr><td><a id="l83"></a><a href="#l83">83</a><td>  var propertyName = goog.style.getVendorJsStyleName_(element, style);<tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>  if (propertyName) {<tr><td><a id="l86"></a><a href="#l86">86</a><td>    element.style[propertyName] = value;<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>/**<tr><td><a id="l92"></a><a href="#l92">92</a><td> * Style name cache that stores previous property name lookups.<tr><td><a id="l93"></a><a href="#l93">93</a><td> *<tr><td><a id="l94"></a><a href="#l94">94</a><td> * This is used by setStyle to speed up property lookups, entries look like:<tr><td><a id="l95"></a><a href="#l95">95</a><td> *   { StyleName: ActualPropertyName }<tr><td><a id="l96"></a><a href="#l96">96</a><td> *<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @private {!Object&lt;string, string&gt;}<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.style.styleNameCache_ = {};<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> * Returns the style property name in camel-case. If it does not exist and a<tr><td><a id="l104"></a><a href="#l104">104</a><td> * vendor-specific version of the property does exist, then return the vendor-<tr><td><a id="l105"></a><a href="#l105">105</a><td> * specific property name instead.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @param {Element} element The element to change.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @param {string} style Style name.<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @return {string} Vendor-specific style.<tr><td><a id="l109"></a><a href="#l109">109</a><td> * @private<tr><td><a id="l110"></a><a href="#l110">110</a><td> */<tr><td><a id="l111"></a><a href="#l111">111</a><td>goog.style.getVendorJsStyleName_ = function(element, style) {<tr><td><a id="l112"></a><a href="#l112">112</a><td>  var propertyName = goog.style.styleNameCache_[style];<tr><td><a id="l113"></a><a href="#l113">113</a><td>  if (!propertyName) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>    var camelStyle = goog.string.toCamelCase(style);<tr><td><a id="l115"></a><a href="#l115">115</a><td>    propertyName = camelStyle;<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>    if (element.style[camelStyle] === undefined) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>      var prefixedStyle = goog.dom.vendor.getVendorJsPrefix() +<tr><td><a id="l119"></a><a href="#l119">119</a><td>          goog.string.toTitleCase(camelStyle);<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>      if (element.style[prefixedStyle] !== undefined) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>        propertyName = prefixedStyle;<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>    goog.style.styleNameCache_[style] = propertyName;<tr><td><a id="l126"></a><a href="#l126">126</a><td>  }<tr><td><a id="l127"></a><a href="#l127">127</a><td><tr><td><a id="l128"></a><a href="#l128">128</a><td>  return propertyName;<tr><td><a id="l129"></a><a href="#l129">129</a><td>};<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * Returns the style property name in CSS notation. If it does not exist and a<tr><td><a id="l134"></a><a href="#l134">134</a><td> * vendor-specific version of the property does exist, then return the vendor-<tr><td><a id="l135"></a><a href="#l135">135</a><td> * specific property name instead.<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @param {Element} element The element to change.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @param {string} style Style name.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @return {string} Vendor-specific style.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @private<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.style.getVendorStyleName_ = function(element, style) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  var camelStyle = goog.string.toCamelCase(style);<tr><td><a id="l143"></a><a href="#l143">143</a><td><tr><td><a id="l144"></a><a href="#l144">144</a><td>  if (element.style[camelStyle] === undefined) {<tr><td><a id="l145"></a><a href="#l145">145</a><td>    var prefixedStyle = goog.dom.vendor.getVendorJsPrefix() +<tr><td><a id="l146"></a><a href="#l146">146</a><td>        goog.string.toTitleCase(camelStyle);<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td>    if (element.style[prefixedStyle] !== undefined) {<tr><td><a id="l149"></a><a href="#l149">149</a><td>      return goog.dom.vendor.getVendorPrefix() + &#39;-&#39; + style;<tr><td><a id="l150"></a><a href="#l150">150</a><td>    }<tr><td><a id="l151"></a><a href="#l151">151</a><td>  }<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 style;<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> * Retrieves an explicitly-set style value of a node. This returns &#39;&#39; if there<tr><td><a id="l159"></a><a href="#l159">159</a><td> * isn&#39;t a style attribute on the element or if this style property has not been<tr><td><a id="l160"></a><a href="#l160">160</a><td> * explicitly set in script.<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 {Element} element Element to get style of.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @param {string} property Property to get, css-style (if you have a camel-case<tr><td><a id="l164"></a><a href="#l164">164</a><td> * property, use element.style[style]).<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @return {string} Style value.<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.style.getStyle = function(element, property) {<tr><td><a id="l168"></a><a href="#l168">168</a><td>  // element.style is &#39;&#39; for well-known properties which are unset.<tr><td><a id="l169"></a><a href="#l169">169</a><td>  // For for browser specific styles as &#39;filter&#39; is undefined<tr><td><a id="l170"></a><a href="#l170">170</a><td>  // so we need to return &#39;&#39; explicitly to make it consistent across<tr><td><a id="l171"></a><a href="#l171">171</a><td>  // browsers.<tr><td><a id="l172"></a><a href="#l172">172</a><td>  var styleValue = element.style[goog.string.toCamelCase(property)];<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td>  // Using typeof here because of a bug in Safari 5.1, where this value<tr><td><a id="l175"></a><a href="#l175">175</a><td>  // was undefined, but === undefined returned false.<tr><td><a id="l176"></a><a href="#l176">176</a><td>  if (typeof(styleValue) !== &#39;undefined&#39;) {<tr><td><a id="l177"></a><a href="#l177">177</a><td>    return styleValue;<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>  return element.style[goog.style.getVendorJsStyleName_(element, property)] ||<tr><td><a id="l181"></a><a href="#l181">181</a><td>      &#39;&#39;;<tr><td><a id="l182"></a><a href="#l182">182</a><td>};<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>/**<tr><td><a id="l186"></a><a href="#l186">186</a><td> * Retrieves a computed style value of a node. It returns empty string if the<tr><td><a id="l187"></a><a href="#l187">187</a><td> * value cannot be computed (which will be the case in Internet Explorer) or<tr><td><a id="l188"></a><a href="#l188">188</a><td> * &quot;none&quot; if the property requested is an SVG one and it has not been<tr><td><a id="l189"></a><a href="#l189">189</a><td> * explicitly set (firefox and webkit).<tr><td><a id="l190"></a><a href="#l190">190</a><td> *<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {Element} element Element to get style of.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @param {string} property Property to get (camel-case).<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @return {string} Style value.<tr><td><a id="l194"></a><a href="#l194">194</a><td> */<tr><td><a id="l195"></a><a href="#l195">195</a><td>goog.style.getComputedStyle = function(element, property) {<tr><td><a id="l196"></a><a href="#l196">196</a><td>  var doc = goog.dom.getOwnerDocument(element);<tr><td><a id="l197"></a><a href="#l197">197</a><td>  if (doc.defaultView &amp;&amp; doc.defaultView.getComputedStyle) {<tr><td><a id="l198"></a><a href="#l198">198</a><td>    var styles = doc.defaultView.getComputedStyle(element, null);<tr><td><a id="l199"></a><a href="#l199">199</a><td>    if (styles) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>      // element.style[..] is undefined for browser specific styles<tr><td><a id="l201"></a><a href="#l201">201</a><td>      // as &#39;filter&#39;.<tr><td><a id="l202"></a><a href="#l202">202</a><td>      return styles[property] || styles.getPropertyValue(property) || &#39;&#39;;<tr><td><a id="l203"></a><a href="#l203">203</a><td>    }<tr><td><a id="l204"></a><a href="#l204">204</a><td>  }<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>  return &#39;&#39;;<tr><td><a id="l207"></a><a href="#l207">207</a><td>};<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td>/**<tr><td><a id="l211"></a><a href="#l211">211</a><td> * Gets the cascaded style value of a node, or null if the value cannot be<tr><td><a id="l212"></a><a href="#l212">212</a><td> * computed (only Internet Explorer can do this).<tr><td><a id="l213"></a><a href="#l213">213</a><td> *<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @param {Element} element Element to get style of.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @param {string} style Property to get (camel-case).<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @return {string} Style value.<tr><td><a id="l217"></a><a href="#l217">217</a><td> */<tr><td><a id="l218"></a><a href="#l218">218</a><td>goog.style.getCascadedStyle = function(element, style) {<tr><td><a id="l219"></a><a href="#l219">219</a><td>  // TODO(nicksantos): This should be documented to return null. #fixTypes<tr><td><a id="l220"></a><a href="#l220">220</a><td>  return element.currentStyle ? element.currentStyle[style] : null;<tr><td><a id="l221"></a><a href="#l221">221</a><td>};<tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td>/**<tr><td><a id="l225"></a><a href="#l225">225</a><td> * Cross-browser pseudo get computed style. It returns the computed style where<tr><td><a id="l226"></a><a href="#l226">226</a><td> * available. If not available it tries the cascaded style value (IE<tr><td><a id="l227"></a><a href="#l227">227</a><td> * currentStyle) and in worst case the inline style value.  It shouldn&#39;t be<tr><td><a id="l228"></a><a href="#l228">228</a><td> * called directly, see http://wiki/Main/ComputedStyleVsCascadedStyle for<tr><td><a id="l229"></a><a href="#l229">229</a><td> * discussion.<tr><td><a id="l230"></a><a href="#l230">230</a><td> *<tr><td><a id="l231"></a><a href="#l231">231</a><td> * @param {Element} element Element to get style of.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @param {string} style Property to get (must be camelCase, not css-style.).<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @return {string} Style value.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @private<tr><td><a id="l235"></a><a href="#l235">235</a><td> */<tr><td><a id="l236"></a><a href="#l236">236</a><td>goog.style.getStyle_ = function(element, style) {<tr><td><a id="l237"></a><a href="#l237">237</a><td>  return goog.style.getComputedStyle(element, style) ||<tr><td><a id="l238"></a><a href="#l238">238</a><td>         goog.style.getCascadedStyle(element, style) ||<tr><td><a id="l239"></a><a href="#l239">239</a><td>         (element.style &amp;&amp; element.style[style]);<tr><td><a id="l240"></a><a href="#l240">240</a><td>};<tr><td><a id="l241"></a><a href="#l241">241</a><td><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> * Retrieves the computed value of the box-sizing CSS attribute.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * Browser support: http://caniuse.com/css3-boxsizing.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @param {!Element} element The element whose box-sizing to get.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @return {?string} &#39;content-box&#39;, &#39;border-box&#39; or &#39;padding-box&#39;. null if<tr><td><a id="l248"></a><a href="#l248">248</a><td> *     box-sizing is not supported (IE7 and below).<tr><td><a id="l249"></a><a href="#l249">249</a><td> */<tr><td><a id="l250"></a><a href="#l250">250</a><td>goog.style.getComputedBoxSizing = function(element) {<tr><td><a id="l251"></a><a href="#l251">251</a><td>  return goog.style.getStyle_(element, &#39;boxSizing&#39;) ||<tr><td><a id="l252"></a><a href="#l252">252</a><td>      goog.style.getStyle_(element, &#39;MozBoxSizing&#39;) ||<tr><td><a id="l253"></a><a href="#l253">253</a><td>      goog.style.getStyle_(element, &#39;WebkitBoxSizing&#39;) || null;<tr><td><a id="l254"></a><a href="#l254">254</a><td>};<tr><td><a id="l255"></a><a href="#l255">255</a><td><tr><td><a id="l256"></a><a href="#l256">256</a><td><tr><td><a id="l257"></a><a href="#l257">257</a><td>/**<tr><td><a id="l258"></a><a href="#l258">258</a><td> * Retrieves the computed value of the position CSS attribute.<tr><td><a id="l259"></a><a href="#l259">259</a><td> * @param {Element} element The element to get the position of.<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @return {string} Position value.<tr><td><a id="l261"></a><a href="#l261">261</a><td> */<tr><td><a id="l262"></a><a href="#l262">262</a><td>goog.style.getComputedPosition = function(element) {<tr><td><a id="l263"></a><a href="#l263">263</a><td>  return goog.style.getStyle_(element, &#39;position&#39;);<tr><td><a id="l264"></a><a href="#l264">264</a><td>};<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>/**<tr><td><a id="l268"></a><a href="#l268">268</a><td> * Retrieves the computed background color string for a given element. The<tr><td><a id="l269"></a><a href="#l269">269</a><td> * string returned is suitable for assigning to another element&#39;s<tr><td><a id="l270"></a><a href="#l270">270</a><td> * background-color, but is not guaranteed to be in any particular string<tr><td><a id="l271"></a><a href="#l271">271</a><td> * format. Accessing the color in a numeric form may not be possible in all<tr><td><a id="l272"></a><a href="#l272">272</a><td> * browsers or with all input.<tr><td><a id="l273"></a><a href="#l273">273</a><td> *<tr><td><a id="l274"></a><a href="#l274">274</a><td> * If the background color for the element is defined as a hexadecimal value,<tr><td><a id="l275"></a><a href="#l275">275</a><td> * the resulting string can be parsed by goog.color.parse in all supported<tr><td><a id="l276"></a><a href="#l276">276</a><td> * browsers.<tr><td><a id="l277"></a><a href="#l277">277</a><td> *<tr><td><a id="l278"></a><a href="#l278">278</a><td> * Whether named colors like &quot;red&quot; or &quot;lightblue&quot; get translated into a<tr><td><a id="l279"></a><a href="#l279">279</a><td> * format which can be parsed is browser dependent. Calling this function on<tr><td><a id="l280"></a><a href="#l280">280</a><td> * transparent elements will return &quot;transparent&quot; in most browsers or<tr><td><a id="l281"></a><a href="#l281">281</a><td> * &quot;rgba(0, 0, 0, 0)&quot; in WebKit.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @param {Element} element The element to get the background color of.<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @return {string} The computed string value of the background color.<tr><td><a id="l284"></a><a href="#l284">284</a><td> */<tr><td><a id="l285"></a><a href="#l285">285</a><td>goog.style.getBackgroundColor = function(element) {<tr><td><a id="l286"></a><a href="#l286">286</a><td>  return goog.style.getStyle_(element, &#39;backgroundColor&#39;);<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><tr><td><a id="l290"></a><a href="#l290">290</a><td>/**<tr><td><a id="l291"></a><a href="#l291">291</a><td> * Retrieves the computed value of the overflow-x CSS attribute.<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @param {Element} element The element to get the overflow-x of.<tr><td><a id="l293"></a><a href="#l293">293</a><td> * @return {string} The computed string value of the overflow-x attribute.<tr><td><a id="l294"></a><a href="#l294">294</a><td> */<tr><td><a id="l295"></a><a href="#l295">295</a><td>goog.style.getComputedOverflowX = function(element) {<tr><td><a id="l296"></a><a href="#l296">296</a><td>  return goog.style.getStyle_(element, &#39;overflowX&#39;);<tr><td><a id="l297"></a><a href="#l297">297</a><td>};<tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>/**<tr><td><a id="l301"></a><a href="#l301">301</a><td> * Retrieves the computed value of the overflow-y CSS attribute.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @param {Element} element The element to get the overflow-y of.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @return {string} The computed string value of the overflow-y attribute.<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.style.getComputedOverflowY = function(element) {<tr><td><a id="l306"></a><a href="#l306">306</a><td>  return goog.style.getStyle_(element, &#39;overflowY&#39;);<tr><td><a id="l307"></a><a href="#l307">307</a><td>};<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>/**<tr><td><a id="l311"></a><a href="#l311">311</a><td> * Retrieves the computed value of the z-index CSS attribute.<tr><td><a id="l312"></a><a href="#l312">312</a><td> * @param {Element} element The element to get the z-index of.<tr><td><a id="l313"></a><a href="#l313">313</a><td> * @return {string|number} The computed value of the z-index attribute.<tr><td><a id="l314"></a><a href="#l314">314</a><td> */<tr><td><a id="l315"></a><a href="#l315">315</a><td>goog.style.getComputedZIndex = function(element) {<tr><td><a id="l316"></a><a href="#l316">316</a><td>  return goog.style.getStyle_(element, &#39;zIndex&#39;);<tr><td><a id="l317"></a><a href="#l317">317</a><td>};<tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>/**<tr><td><a id="l321"></a><a href="#l321">321</a><td> * Retrieves the computed value of the text-align CSS attribute.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {Element} element The element to get the text-align of.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @return {string} The computed string value of the text-align attribute.<tr><td><a id="l324"></a><a href="#l324">324</a><td> */<tr><td><a id="l325"></a><a href="#l325">325</a><td>goog.style.getComputedTextAlign = function(element) {<tr><td><a id="l326"></a><a href="#l326">326</a><td>  return goog.style.getStyle_(element, &#39;textAlign&#39;);<tr><td><a id="l327"></a><a href="#l327">327</a><td>};<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * Retrieves the computed value of the cursor CSS attribute.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @param {Element} element The element to get the cursor of.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @return {string} The computed string value of the cursor attribute.<tr><td><a id="l334"></a><a href="#l334">334</a><td> */<tr><td><a id="l335"></a><a href="#l335">335</a><td>goog.style.getComputedCursor = function(element) {<tr><td><a id="l336"></a><a href="#l336">336</a><td>  return goog.style.getStyle_(element, &#39;cursor&#39;);<tr><td><a id="l337"></a><a href="#l337">337</a><td>};<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Retrieves the computed value of the CSS transform attribute.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {Element} element The element to get the transform of.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @return {string} The computed string representation of the transform matrix.<tr><td><a id="l344"></a><a href="#l344">344</a><td> */<tr><td><a id="l345"></a><a href="#l345">345</a><td>goog.style.getComputedTransform = function(element) {<tr><td><a id="l346"></a><a href="#l346">346</a><td>  var property = goog.style.getVendorStyleName_(element, &#39;transform&#39;);<tr><td><a id="l347"></a><a href="#l347">347</a><td>  return goog.style.getStyle_(element, property) ||<tr><td><a id="l348"></a><a href="#l348">348</a><td>      goog.style.getStyle_(element, &#39;transform&#39;);<tr><td><a id="l349"></a><a href="#l349">349</a><td>};<tr><td><a id="l350"></a><a href="#l350">350</a><td><tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td>/**<tr><td><a id="l353"></a><a href="#l353">353</a><td> * Sets the top/left values of an element.  If no unit is specified in the<tr><td><a id="l354"></a><a href="#l354">354</a><td> * argument then it will add px. The second argument is required if the first<tr><td><a id="l355"></a><a href="#l355">355</a><td> * argument is a string or number and is ignored if the first argument<tr><td><a id="l356"></a><a href="#l356">356</a><td> * is a coordinate.<tr><td><a id="l357"></a><a href="#l357">357</a><td> * @param {Element} el Element to move.<tr><td><a id="l358"></a><a href="#l358">358</a><td> * @param {string|number|goog.math.Coordinate} arg1 Left position or coordinate.<tr><td><a id="l359"></a><a href="#l359">359</a><td> * @param {string|number=} opt_arg2 Top position.<tr><td><a id="l360"></a><a href="#l360">360</a><td> */<tr><td><a id="l361"></a><a href="#l361">361</a><td>goog.style.setPosition = function(el, arg1, opt_arg2) {<tr><td><a id="l362"></a><a href="#l362">362</a><td>  var x, y;<tr><td><a id="l363"></a><a href="#l363">363</a><td><tr><td><a id="l364"></a><a href="#l364">364</a><td>  if (arg1 instanceof goog.math.Coordinate) {<tr><td><a id="l365"></a><a href="#l365">365</a><td>    x = arg1.x;<tr><td><a id="l366"></a><a href="#l366">366</a><td>    y = arg1.y;<tr><td><a id="l367"></a><a href="#l367">367</a><td>  } else {<tr><td><a id="l368"></a><a href="#l368">368</a><td>    x = arg1;<tr><td><a id="l369"></a><a href="#l369">369</a><td>    y = opt_arg2;<tr><td><a id="l370"></a><a href="#l370">370</a><td>  }<tr><td><a id="l371"></a><a href="#l371">371</a><td><tr><td><a id="l372"></a><a href="#l372">372</a><td>  el.style.left = goog.style.getPixelStyleValue_(<tr><td><a id="l373"></a><a href="#l373">373</a><td>      /** @type {number|string} */ (x), false);<tr><td><a id="l374"></a><a href="#l374">374</a><td>  el.style.top = goog.style.getPixelStyleValue_(<tr><td><a id="l375"></a><a href="#l375">375</a><td>      /** @type {number|string} */ (y), false);<tr><td><a id="l376"></a><a href="#l376">376</a><td>};<tr><td><a id="l377"></a><a href="#l377">377</a><td><tr><td><a id="l378"></a><a href="#l378">378</a><td><tr><td><a id="l379"></a><a href="#l379">379</a><td>/**<tr><td><a id="l380"></a><a href="#l380">380</a><td> * Gets the offsetLeft and offsetTop properties of an element and returns them<tr><td><a id="l381"></a><a href="#l381">381</a><td> * in a Coordinate object<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @param {Element} element Element.<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @return {!goog.math.Coordinate} The position.<tr><td><a id="l384"></a><a href="#l384">384</a><td> */<tr><td><a id="l385"></a><a href="#l385">385</a><td>goog.style.getPosition = function(element) {<tr><td><a id="l386"></a><a href="#l386">386</a><td>  return new goog.math.Coordinate(<tr><td><a id="l387"></a><a href="#l387">387</a><td>      /** @type {!HTMLElement} */ (element).offsetLeft,<tr><td><a id="l388"></a><a href="#l388">388</a><td>      /** @type {!HTMLElement} */ (element).offsetTop);<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 viewport element for a particular document<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @param {Node=} opt_node DOM node (Document is OK) to get the viewport element<tr><td><a id="l395"></a><a href="#l395">395</a><td> *     of.<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @return {Element} document.documentElement or document.body.<tr><td><a id="l397"></a><a href="#l397">397</a><td> */<tr><td><a id="l398"></a><a href="#l398">398</a><td>goog.style.getClientViewportElement = function(opt_node) {<tr><td><a id="l399"></a><a href="#l399">399</a><td>  var doc;<tr><td><a id="l400"></a><a href="#l400">400</a><td>  if (opt_node) {<tr><td><a id="l401"></a><a href="#l401">401</a><td>    doc = goog.dom.getOwnerDocument(opt_node);<tr><td><a id="l402"></a><a href="#l402">402</a><td>  } else {<tr><td><a id="l403"></a><a href="#l403">403</a><td>    doc = goog.dom.getDocument();<tr><td><a id="l404"></a><a href="#l404">404</a><td>  }<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td>  // In old IE versions the document.body represented the viewport<tr><td><a id="l407"></a><a href="#l407">407</a><td>  if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isDocumentModeOrHigher(9) &amp;&amp;<tr><td><a id="l408"></a><a href="#l408">408</a><td>      !goog.dom.getDomHelper(doc).isCss1CompatMode()) {<tr><td><a id="l409"></a><a href="#l409">409</a><td>    return doc.body;<tr><td><a id="l410"></a><a href="#l410">410</a><td>  }<tr><td><a id="l411"></a><a href="#l411">411</a><td>  return doc.documentElement;<tr><td><a id="l412"></a><a href="#l412">412</a><td>};<tr><td><a id="l413"></a><a href="#l413">413</a><td><tr><td><a id="l414"></a><a href="#l414">414</a><td><tr><td><a id="l415"></a><a href="#l415">415</a><td>/**<tr><td><a id="l416"></a><a href="#l416">416</a><td> * Calculates the viewport coordinates relative to the page/document<tr><td><a id="l417"></a><a href="#l417">417</a><td> * containing the node. The viewport may be the browser viewport for<tr><td><a id="l418"></a><a href="#l418">418</a><td> * non-iframe document, or the iframe container for iframe&#39;d document.<tr><td><a id="l419"></a><a href="#l419">419</a><td> * @param {!Document} doc The document to use as the reference point.<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @return {!goog.math.Coordinate} The page offset of the viewport.<tr><td><a id="l421"></a><a href="#l421">421</a><td> */<tr><td><a id="l422"></a><a href="#l422">422</a><td>goog.style.getViewportPageOffset = function(doc) {<tr><td><a id="l423"></a><a href="#l423">423</a><td>  var body = doc.body;<tr><td><a id="l424"></a><a href="#l424">424</a><td>  var documentElement = doc.documentElement;<tr><td><a id="l425"></a><a href="#l425">425</a><td>  var scrollLeft = body.scrollLeft || documentElement.scrollLeft;<tr><td><a id="l426"></a><a href="#l426">426</a><td>  var scrollTop = body.scrollTop || documentElement.scrollTop;<tr><td><a id="l427"></a><a href="#l427">427</a><td>  return new goog.math.Coordinate(scrollLeft, scrollTop);<tr><td><a id="l428"></a><a href="#l428">428</a><td>};<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td>/**<tr><td><a id="l432"></a><a href="#l432">432</a><td> * Gets the client rectangle of the DOM element.<tr><td><a id="l433"></a><a href="#l433">433</a><td> *<tr><td><a id="l434"></a><a href="#l434">434</a><td> * getBoundingClientRect is part of a new CSS object model draft (with a<tr><td><a id="l435"></a><a href="#l435">435</a><td> * long-time presence in IE), replacing the error-prone parent offset<tr><td><a id="l436"></a><a href="#l436">436</a><td> * computation and the now-deprecated Gecko getBoxObjectFor.<tr><td><a id="l437"></a><a href="#l437">437</a><td> *<tr><td><a id="l438"></a><a href="#l438">438</a><td> * This utility patches common browser bugs in getBoundingClientRect. It<tr><td><a id="l439"></a><a href="#l439">439</a><td> * will fail if getBoundingClientRect is unsupported.<tr><td><a id="l440"></a><a href="#l440">440</a><td> *<tr><td><a id="l441"></a><a href="#l441">441</a><td> * If the element is not in the DOM, the result is undefined, and an error may<tr><td><a id="l442"></a><a href="#l442">442</a><td> * be thrown depending on user agent.<tr><td><a id="l443"></a><a href="#l443">443</a><td> *<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @param {!Element} el The element whose bounding rectangle is being queried.<tr><td><a id="l445"></a><a href="#l445">445</a><td> * @return {Object} A native bounding rectangle with numerical left, top,<tr><td><a id="l446"></a><a href="#l446">446</a><td> *     right, and bottom.  Reported by Firefox to be of object type ClientRect.<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @private<tr><td><a id="l448"></a><a href="#l448">448</a><td> */<tr><td><a id="l449"></a><a href="#l449">449</a><td>goog.style.getBoundingClientRect_ = function(el) {<tr><td><a id="l450"></a><a href="#l450">450</a><td>  var rect;<tr><td><a id="l451"></a><a href="#l451">451</a><td>  try {<tr><td><a id="l452"></a><a href="#l452">452</a><td>    rect = el.getBoundingClientRect();<tr><td><a id="l453"></a><a href="#l453">453</a><td>  } catch (e) {<tr><td><a id="l454"></a><a href="#l454">454</a><td>    // In IE &lt; 9, calling getBoundingClientRect on an orphan element raises an<tr><td><a id="l455"></a><a href="#l455">455</a><td>    // &quot;Unspecified Error&quot;. All other browsers return zeros.<tr><td><a id="l456"></a><a href="#l456">456</a><td>    return {&#39;left&#39;: 0, &#39;top&#39;: 0, &#39;right&#39;: 0, &#39;bottom&#39;: 0};<tr><td><a id="l457"></a><a href="#l457">457</a><td>  }<tr><td><a id="l458"></a><a href="#l458">458</a><td><tr><td><a id="l459"></a><a href="#l459">459</a><td>  // Patch the result in IE only, so that this function can be inlined if<tr><td><a id="l460"></a><a href="#l460">460</a><td>  // compiled for non-IE.<tr><td><a id="l461"></a><a href="#l461">461</a><td>  if (goog.userAgent.IE &amp;&amp; el.ownerDocument.body) {<tr><td><a id="l462"></a><a href="#l462">462</a><td><tr><td><a id="l463"></a><a href="#l463">463</a><td>    // In IE, most of the time, 2 extra pixels are added to the top and left<tr><td><a id="l464"></a><a href="#l464">464</a><td>    // due to the implicit 2-pixel inset border.  In IE6/7 quirks mode and<tr><td><a id="l465"></a><a href="#l465">465</a><td>    // IE6 standards mode, this border can be overridden by setting the<tr><td><a id="l466"></a><a href="#l466">466</a><td>    // document element&#39;s border to zero -- thus, we cannot rely on the<tr><td><a id="l467"></a><a href="#l467">467</a><td>    // offset always being 2 pixels.<tr><td><a id="l468"></a><a href="#l468">468</a><td><tr><td><a id="l469"></a><a href="#l469">469</a><td>    // In quirks mode, the offset can be determined by querying the body&#39;s<tr><td><a id="l470"></a><a href="#l470">470</a><td>    // clientLeft/clientTop, but in standards mode, it is found by querying<tr><td><a id="l471"></a><a href="#l471">471</a><td>    // the document element&#39;s clientLeft/clientTop.  Since we already called<tr><td><a id="l472"></a><a href="#l472">472</a><td>    // getBoundingClientRect we have already forced a reflow, so it is not<tr><td><a id="l473"></a><a href="#l473">473</a><td>    // too expensive just to query them all.<tr><td><a id="l474"></a><a href="#l474">474</a><td><tr><td><a id="l475"></a><a href="#l475">475</a><td>    // See: http://msdn.microsoft.com/en-us/library/ms536433(VS.85).aspx<tr><td><a id="l476"></a><a href="#l476">476</a><td>    var doc = el.ownerDocument;<tr><td><a id="l477"></a><a href="#l477">477</a><td>    rect.left -= doc.documentElement.clientLeft + doc.body.clientLeft;<tr><td><a id="l478"></a><a href="#l478">478</a><td>    rect.top -= doc.documentElement.clientTop + doc.body.clientTop;<tr><td><a id="l479"></a><a href="#l479">479</a><td>  }<tr><td><a id="l480"></a><a href="#l480">480</a><td>  return rect;<tr><td><a id="l481"></a><a href="#l481">481</a><td>};<tr><td><a id="l482"></a><a href="#l482">482</a><td><tr><td><a id="l483"></a><a href="#l483">483</a><td><tr><td><a id="l484"></a><a href="#l484">484</a><td>/**<tr><td><a id="l485"></a><a href="#l485">485</a><td> * Returns the first parent that could affect the position of a given element.<tr><td><a id="l486"></a><a href="#l486">486</a><td> * @param {Element} element The element to get the offset parent for.<tr><td><a id="l487"></a><a href="#l487">487</a><td> * @return {Element} The first offset parent or null if one cannot be found.<tr><td><a id="l488"></a><a href="#l488">488</a><td> */<tr><td><a id="l489"></a><a href="#l489">489</a><td>goog.style.getOffsetParent = function(element) {<tr><td><a id="l490"></a><a href="#l490">490</a><td>  // element.offsetParent does the right thing in IE7 and below.  In other<tr><td><a id="l491"></a><a href="#l491">491</a><td>  // browsers it only includes elements with position absolute, relative or<tr><td><a id="l492"></a><a href="#l492">492</a><td>  // fixed, not elements with overflow set to auto or scroll.<tr><td><a id="l493"></a><a href="#l493">493</a><td>  if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isDocumentModeOrHigher(8)) {<tr><td><a id="l494"></a><a href="#l494">494</a><td>    return element.offsetParent;<tr><td><a id="l495"></a><a href="#l495">495</a><td>  }<tr><td><a id="l496"></a><a href="#l496">496</a><td><tr><td><a id="l497"></a><a href="#l497">497</a><td>  var doc = goog.dom.getOwnerDocument(element);<tr><td><a id="l498"></a><a href="#l498">498</a><td>  var positionStyle = goog.style.getStyle_(element, &#39;position&#39;);<tr><td><a id="l499"></a><a href="#l499">499</a><td>  var skipStatic = positionStyle == &#39;fixed&#39; || positionStyle == &#39;absolute&#39;;<tr><td><a id="l500"></a><a href="#l500">500</a><td>  for (var parent = element.parentNode; parent &amp;&amp; parent != doc;<tr><td><a id="l501"></a><a href="#l501">501</a><td>       parent = parent.parentNode) {<tr><td><a id="l502"></a><a href="#l502">502</a><td>    // Skip shadowDOM roots.<tr><td><a id="l503"></a><a href="#l503">503</a><td>    if (parent.nodeType == goog.dom.NodeType.DOCUMENT_FRAGMENT &amp;&amp;<tr><td><a id="l504"></a><a href="#l504">504</a><td>        parent.host) {<tr><td><a id="l505"></a><a href="#l505">505</a><td>      parent = parent.host;<tr><td><a id="l506"></a><a href="#l506">506</a><td>    }<tr><td><a id="l507"></a><a href="#l507">507</a><td>    positionStyle =<tr><td><a id="l508"></a><a href="#l508">508</a><td>        goog.style.getStyle_(/** @type {!Element} */ (parent), &#39;position&#39;);<tr><td><a id="l509"></a><a href="#l509">509</a><td>    skipStatic = skipStatic &amp;&amp; positionStyle == &#39;static&#39; &amp;&amp;<tr><td><a id="l510"></a><a href="#l510">510</a><td>                 parent != doc.documentElement &amp;&amp; parent != doc.body;<tr><td><a id="l511"></a><a href="#l511">511</a><td>    if (!skipStatic &amp;&amp; (parent.scrollWidth &gt; parent.clientWidth ||<tr><td><a id="l512"></a><a href="#l512">512</a><td>                        parent.scrollHeight &gt; parent.clientHeight ||<tr><td><a id="l513"></a><a href="#l513">513</a><td>                        positionStyle == &#39;fixed&#39; ||<tr><td><a id="l514"></a><a href="#l514">514</a><td>                        positionStyle == &#39;absolute&#39; ||<tr><td><a id="l515"></a><a href="#l515">515</a><td>                        positionStyle == &#39;relative&#39;)) {<tr><td><a id="l516"></a><a href="#l516">516</a><td>      return /** @type {!Element} */ (parent);<tr><td><a id="l517"></a><a href="#l517">517</a><td>    }<tr><td><a id="l518"></a><a href="#l518">518</a><td>  }<tr><td><a id="l519"></a><a href="#l519">519</a><td>  return null;<tr><td><a id="l520"></a><a href="#l520">520</a><td>};<tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td><tr><td><a id="l523"></a><a href="#l523">523</a><td>/**<tr><td><a id="l524"></a><a href="#l524">524</a><td> * Calculates and returns the visible rectangle for a given element. Returns a<tr><td><a id="l525"></a><a href="#l525">525</a><td> * box describing the visible portion of the nearest scrollable offset ancestor.<tr><td><a id="l526"></a><a href="#l526">526</a><td> * Coordinates are given relative to the document.<tr><td><a id="l527"></a><a href="#l527">527</a><td> *<tr><td><a id="l528"></a><a href="#l528">528</a><td> * @param {Element} element Element to get the visible rect for.<tr><td><a id="l529"></a><a href="#l529">529</a><td> * @return {goog.math.Box} Bounding elementBox describing the visible rect or<tr><td><a id="l530"></a><a href="#l530">530</a><td> *     null if scrollable ancestor isn&#39;t inside the visible viewport.<tr><td><a id="l531"></a><a href="#l531">531</a><td> */<tr><td><a id="l532"></a><a href="#l532">532</a><td>goog.style.getVisibleRectForElement = function(element) {<tr><td><a id="l533"></a><a href="#l533">533</a><td>  var visibleRect = new goog.math.Box(0, Infinity, Infinity, 0);<tr><td><a id="l534"></a><a href="#l534">534</a><td>  var dom = goog.dom.getDomHelper(element);<tr><td><a id="l535"></a><a href="#l535">535</a><td>  var body = dom.getDocument().body;<tr><td><a id="l536"></a><a href="#l536">536</a><td>  var documentElement = dom.getDocument().documentElement;<tr><td><a id="l537"></a><a href="#l537">537</a><td>  var scrollEl = dom.getDocumentScrollElement();<tr><td><a id="l538"></a><a href="#l538">538</a><td><tr><td><a id="l539"></a><a href="#l539">539</a><td>  // Determine the size of the visible rect by climbing the dom accounting for<tr><td><a id="l540"></a><a href="#l540">540</a><td>  // all scrollable containers.<tr><td><a id="l541"></a><a href="#l541">541</a><td>  for (var el = element; el = goog.style.getOffsetParent(el); ) {<tr><td><a id="l542"></a><a href="#l542">542</a><td>    // clientWidth is zero for inline block elements in IE.<tr><td><a id="l543"></a><a href="#l543">543</a><td>    // on WEBKIT, body element can have clientHeight = 0 and scrollHeight &gt; 0<tr><td><a id="l544"></a><a href="#l544">544</a><td>    if ((!goog.userAgent.IE || el.clientWidth != 0) &amp;&amp;<tr><td><a id="l545"></a><a href="#l545">545</a><td>        (!goog.userAgent.WEBKIT || el.clientHeight != 0 || el != body) &amp;&amp;<tr><td><a id="l546"></a><a href="#l546">546</a><td>        // body may have overflow set on it, yet we still get the entire<tr><td><a id="l547"></a><a href="#l547">547</a><td>        // viewport. In some browsers, el.offsetParent may be<tr><td><a id="l548"></a><a href="#l548">548</a><td>        // document.documentElement, so check for that too.<tr><td><a id="l549"></a><a href="#l549">549</a><td>        (el != body &amp;&amp; el != documentElement &amp;&amp;<tr><td><a id="l550"></a><a href="#l550">550</a><td>            goog.style.getStyle_(el, &#39;overflow&#39;) != &#39;visible&#39;)) {<tr><td><a id="l551"></a><a href="#l551">551</a><td>      var pos = goog.style.getPageOffset(el);<tr><td><a id="l552"></a><a href="#l552">552</a><td>      var client = goog.style.getClientLeftTop(el);<tr><td><a id="l553"></a><a href="#l553">553</a><td>      pos.x += client.x;<tr><td><a id="l554"></a><a href="#l554">554</a><td>      pos.y += client.y;<tr><td><a id="l555"></a><a href="#l555">555</a><td><tr><td><a id="l556"></a><a href="#l556">556</a><td>      visibleRect.top = Math.max(visibleRect.top, pos.y);<tr><td><a id="l557"></a><a href="#l557">557</a><td>      visibleRect.right = Math.min(visibleRect.right,<tr><td><a id="l558"></a><a href="#l558">558</a><td>                                   pos.x + el.clientWidth);<tr><td><a id="l559"></a><a href="#l559">559</a><td>      visibleRect.bottom = Math.min(visibleRect.bottom,<tr><td><a id="l560"></a><a href="#l560">560</a><td>                                    pos.y + el.clientHeight);<tr><td><a id="l561"></a><a href="#l561">561</a><td>      visibleRect.left = Math.max(visibleRect.left, pos.x);<tr><td><a id="l562"></a><a href="#l562">562</a><td>    }<tr><td><a id="l563"></a><a href="#l563">563</a><td>  }<tr><td><a id="l564"></a><a href="#l564">564</a><td><tr><td><a id="l565"></a><a href="#l565">565</a><td>  // Clip by window&#39;s viewport.<tr><td><a id="l566"></a><a href="#l566">566</a><td>  var scrollX = scrollEl.scrollLeft, scrollY = scrollEl.scrollTop;<tr><td><a id="l567"></a><a href="#l567">567</a><td>  visibleRect.left = Math.max(visibleRect.left, scrollX);<tr><td><a id="l568"></a><a href="#l568">568</a><td>  visibleRect.top = Math.max(visibleRect.top, scrollY);<tr><td><a id="l569"></a><a href="#l569">569</a><td>  var winSize = dom.getViewportSize();<tr><td><a id="l570"></a><a href="#l570">570</a><td>  visibleRect.right = Math.min(visibleRect.right, scrollX + winSize.width);<tr><td><a id="l571"></a><a href="#l571">571</a><td>  visibleRect.bottom = Math.min(visibleRect.bottom, scrollY + winSize.height);<tr><td><a id="l572"></a><a href="#l572">572</a><td>  return visibleRect.top &gt;= 0 &amp;&amp; visibleRect.left &gt;= 0 &amp;&amp;<tr><td><a id="l573"></a><a href="#l573">573</a><td>         visibleRect.bottom &gt; visibleRect.top &amp;&amp;<tr><td><a id="l574"></a><a href="#l574">574</a><td>         visibleRect.right &gt; visibleRect.left ?<tr><td><a id="l575"></a><a href="#l575">575</a><td>         visibleRect : null;<tr><td><a id="l576"></a><a href="#l576">576</a><td>};<tr><td><a id="l577"></a><a href="#l577">577</a><td><tr><td><a id="l578"></a><a href="#l578">578</a><td><tr><td><a id="l579"></a><a href="#l579">579</a><td>/**<tr><td><a id="l580"></a><a href="#l580">580</a><td> * Calculate the scroll position of {@code container} with the minimum amount so<tr><td><a id="l581"></a><a href="#l581">581</a><td> * that the content and the borders of the given {@code element} become visible.<tr><td><a id="l582"></a><a href="#l582">582</a><td> * If the element is bigger than the container, its top left corner will be<tr><td><a id="l583"></a><a href="#l583">583</a><td> * aligned as close to the container&#39;s top left corner as possible.<tr><td><a id="l584"></a><a href="#l584">584</a><td> *<tr><td><a id="l585"></a><a href="#l585">585</a><td> * @param {Element} element The element to make visible.<tr><td><a id="l586"></a><a href="#l586">586</a><td> * @param {Element=} opt_container The container to scroll. If not set, then the<tr><td><a id="l587"></a><a href="#l587">587</a><td> *     document scroll element will be used.<tr><td><a id="l588"></a><a href="#l588">588</a><td> * @param {boolean=} opt_center Whether to center the element in the container.<tr><td><a id="l589"></a><a href="#l589">589</a><td> *     Defaults to false.<tr><td><a id="l590"></a><a href="#l590">590</a><td> * @return {!goog.math.Coordinate} The new scroll position of the container,<tr><td><a id="l591"></a><a href="#l591">591</a><td> *     in form of goog.math.Coordinate(scrollLeft, scrollTop).<tr><td><a id="l592"></a><a href="#l592">592</a><td> */<tr><td><a id="l593"></a><a href="#l593">593</a><td>goog.style.getContainerOffsetToScrollInto =<tr><td><a id="l594"></a><a href="#l594">594</a><td>    function(element, opt_container, opt_center) {<tr><td><a id="l595"></a><a href="#l595">595</a><td>  var container = opt_container || goog.dom.getDocumentScrollElement();<tr><td><a id="l596"></a><a href="#l596">596</a><td>  // Absolute position of the element&#39;s border&#39;s top left corner.<tr><td><a id="l597"></a><a href="#l597">597</a><td>  var elementPos = goog.style.getPageOffset(element);<tr><td><a id="l598"></a><a href="#l598">598</a><td>  // Absolute position of the container&#39;s border&#39;s top left corner.<tr><td><a id="l599"></a><a href="#l599">599</a><td>  var containerPos = goog.style.getPageOffset(container);<tr><td><a id="l600"></a><a href="#l600">600</a><td>  var containerBorder = goog.style.getBorderBox(container);<tr><td><a id="l601"></a><a href="#l601">601</a><td>  if (container == goog.dom.getDocumentScrollElement()) {<tr><td><a id="l602"></a><a href="#l602">602</a><td>    // The element position is calculated based on the page offset, and the<tr><td><a id="l603"></a><a href="#l603">603</a><td>    // document scroll element holds the scroll position within the page. We can<tr><td><a id="l604"></a><a href="#l604">604</a><td>    // use the scroll position to calculate the relative position from the<tr><td><a id="l605"></a><a href="#l605">605</a><td>    // element.<tr><td><a id="l606"></a><a href="#l606">606</a><td>    var relX = elementPos.x - container.scrollLeft;<tr><td><a id="l607"></a><a href="#l607">607</a><td>    var relY = elementPos.y - container.scrollTop;<tr><td><a id="l608"></a><a href="#l608">608</a><td>    if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isDocumentModeOrHigher(10)) {<tr><td><a id="l609"></a><a href="#l609">609</a><td>      // In older versions of IE getPageOffset(element) does not include the<tr><td><a id="l610"></a><a href="#l610">610</a><td>      // container border so it has to be added to accomodate.<tr><td><a id="l611"></a><a href="#l611">611</a><td>      relX += containerBorder.left;<tr><td><a id="l612"></a><a href="#l612">612</a><td>      relY += containerBorder.top;<tr><td><a id="l613"></a><a href="#l613">613</a><td>    }<tr><td><a id="l614"></a><a href="#l614">614</a><td>  } else {<tr><td><a id="l615"></a><a href="#l615">615</a><td>    // Relative pos. of the element&#39;s border box to the container&#39;s content box.<tr><td><a id="l616"></a><a href="#l616">616</a><td>    var relX = elementPos.x - containerPos.x - containerBorder.left;<tr><td><a id="l617"></a><a href="#l617">617</a><td>    var relY = elementPos.y - containerPos.y - containerBorder.top;<tr><td><a id="l618"></a><a href="#l618">618</a><td>  }<tr><td><a id="l619"></a><a href="#l619">619</a><td>  // How much the element can move in the container, i.e. the difference between<tr><td><a id="l620"></a><a href="#l620">620</a><td>  // the element&#39;s bottom-right-most and top-left-most position where it&#39;s<tr><td><a id="l621"></a><a href="#l621">621</a><td>  // fully visible.<tr><td><a id="l622"></a><a href="#l622">622</a><td>  var spaceX = container.clientWidth -<tr><td><a id="l623"></a><a href="#l623">623</a><td>      /** @type {HTMLElement} */ (element).offsetWidth;<tr><td><a id="l624"></a><a href="#l624">624</a><td>  var spaceY = container.clientHeight -<tr><td><a id="l625"></a><a href="#l625">625</a><td>      /** @type {HTMLElement} */ (element).offsetHeight;<tr><td><a id="l626"></a><a href="#l626">626</a><td><tr><td><a id="l627"></a><a href="#l627">627</a><td>  var scrollLeft = container.scrollLeft;<tr><td><a id="l628"></a><a href="#l628">628</a><td>  var scrollTop = container.scrollTop;<tr><td><a id="l629"></a><a href="#l629">629</a><td>  if (opt_center) {<tr><td><a id="l630"></a><a href="#l630">630</a><td>    // All browsers round non-integer scroll positions down.<tr><td><a id="l631"></a><a href="#l631">631</a><td>    scrollLeft += relX - spaceX / 2;<tr><td><a id="l632"></a><a href="#l632">632</a><td>    scrollTop += relY - spaceY / 2;<tr><td><a id="l633"></a><a href="#l633">633</a><td>  } else {<tr><td><a id="l634"></a><a href="#l634">634</a><td>    // This formula was designed to give the correct scroll values in the<tr><td><a id="l635"></a><a href="#l635">635</a><td>    // following cases:<tr><td><a id="l636"></a><a href="#l636">636</a><td>    // - element is higher than container (spaceY &lt; 0) =&gt; scroll down by relY<tr><td><a id="l637"></a><a href="#l637">637</a><td>    // - element is not higher that container (spaceY &gt;= 0):<tr><td><a id="l638"></a><a href="#l638">638</a><td>    //   - it is above container (relY &lt; 0) =&gt; scroll up by abs(relY)<tr><td><a id="l639"></a><a href="#l639">639</a><td>    //   - it is below container (relY &gt; spaceY) =&gt; scroll down by relY - spaceY<tr><td><a id="l640"></a><a href="#l640">640</a><td>    //   - it is in the container =&gt; don&#39;t scroll<tr><td><a id="l641"></a><a href="#l641">641</a><td>    scrollLeft += Math.min(relX, Math.max(relX - spaceX, 0));<tr><td><a id="l642"></a><a href="#l642">642</a><td>    scrollTop += Math.min(relY, Math.max(relY - spaceY, 0));<tr><td><a id="l643"></a><a href="#l643">643</a><td>  }<tr><td><a id="l644"></a><a href="#l644">644</a><td>  return new goog.math.Coordinate(scrollLeft, scrollTop);<tr><td><a id="l645"></a><a href="#l645">645</a><td>};<tr><td><a id="l646"></a><a href="#l646">646</a><td><tr><td><a id="l647"></a><a href="#l647">647</a><td><tr><td><a id="l648"></a><a href="#l648">648</a><td>/**<tr><td><a id="l649"></a><a href="#l649">649</a><td> * Changes the scroll position of {@code container} with the minimum amount so<tr><td><a id="l650"></a><a href="#l650">650</a><td> * that the content and the borders of the given {@code element} become visible.<tr><td><a id="l651"></a><a href="#l651">651</a><td> * If the element is bigger than the container, its top left corner will be<tr><td><a id="l652"></a><a href="#l652">652</a><td> * aligned as close to the container&#39;s top left corner as possible.<tr><td><a id="l653"></a><a href="#l653">653</a><td> *<tr><td><a id="l654"></a><a href="#l654">654</a><td> * @param {Element} element The element to make visible.<tr><td><a id="l655"></a><a href="#l655">655</a><td> * @param {Element=} opt_container The container to scroll. If not set, then the<tr><td><a id="l656"></a><a href="#l656">656</a><td> *     document scroll element will be used.<tr><td><a id="l657"></a><a href="#l657">657</a><td> * @param {boolean=} opt_center Whether to center the element in the container.<tr><td><a id="l658"></a><a href="#l658">658</a><td> *     Defaults to false.<tr><td><a id="l659"></a><a href="#l659">659</a><td> */<tr><td><a id="l660"></a><a href="#l660">660</a><td>goog.style.scrollIntoContainerView =<tr><td><a id="l661"></a><a href="#l661">661</a><td>    function(element, opt_container, opt_center) {<tr><td><a id="l662"></a><a href="#l662">662</a><td>  var container = opt_container || goog.dom.getDocumentScrollElement();<tr><td><a id="l663"></a><a href="#l663">663</a><td>  var offset =<tr><td><a id="l664"></a><a href="#l664">664</a><td>      goog.style.getContainerOffsetToScrollInto(element, container, opt_center);<tr><td><a id="l665"></a><a href="#l665">665</a><td>  container.scrollLeft = offset.x;<tr><td><a id="l666"></a><a href="#l666">666</a><td>  container.scrollTop = offset.y;<tr><td><a id="l667"></a><a href="#l667">667</a><td>};<tr><td><a id="l668"></a><a href="#l668">668</a><td><tr><td><a id="l669"></a><a href="#l669">669</a><td><tr><td><a id="l670"></a><a href="#l670">670</a><td>/**<tr><td><a id="l671"></a><a href="#l671">671</a><td> * Returns clientLeft (width of the left border and, if the directionality is<tr><td><a id="l672"></a><a href="#l672">672</a><td> * right to left, the vertical scrollbar) and clientTop as a coordinate object.<tr><td><a id="l673"></a><a href="#l673">673</a><td> *<tr><td><a id="l674"></a><a href="#l674">674</a><td> * @param {Element} el Element to get clientLeft for.<tr><td><a id="l675"></a><a href="#l675">675</a><td> * @return {!goog.math.Coordinate} Client left and top.<tr><td><a id="l676"></a><a href="#l676">676</a><td> */<tr><td><a id="l677"></a><a href="#l677">677</a><td>goog.style.getClientLeftTop = function(el) {<tr><td><a id="l678"></a><a href="#l678">678</a><td>  return new goog.math.Coordinate(el.clientLeft, el.clientTop);<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><tr><td><a id="l682"></a><a href="#l682">682</a><td>/**<tr><td><a id="l683"></a><a href="#l683">683</a><td> * Returns a Coordinate object relative to the top-left of the HTML document.<tr><td><a id="l684"></a><a href="#l684">684</a><td> * Implemented as a single function to save having to do two recursive loops in<tr><td><a id="l685"></a><a href="#l685">685</a><td> * opera and safari just to get both coordinates.  If you just want one value do<tr><td><a id="l686"></a><a href="#l686">686</a><td> * use goog.style.getPageOffsetLeft() and goog.style.getPageOffsetTop(), but<tr><td><a id="l687"></a><a href="#l687">687</a><td> * note if you call both those methods the tree will be analysed twice.<tr><td><a id="l688"></a><a href="#l688">688</a><td> *<tr><td><a id="l689"></a><a href="#l689">689</a><td> * @param {Element} el Element to get the page offset for.<tr><td><a id="l690"></a><a href="#l690">690</a><td> * @return {!goog.math.Coordinate} The page offset.<tr><td><a id="l691"></a><a href="#l691">691</a><td> */<tr><td><a id="l692"></a><a href="#l692">692</a><td>goog.style.getPageOffset = function(el) {<tr><td><a id="l693"></a><a href="#l693">693</a><td>  var doc = goog.dom.getOwnerDocument(el);<tr><td><a id="l694"></a><a href="#l694">694</a><td>  // TODO(gboyer): Update the jsdoc in a way that doesn&#39;t break the universe.<tr><td><a id="l695"></a><a href="#l695">695</a><td>  goog.asserts.assertObject(el, &#39;Parameter is required&#39;);<tr><td><a id="l696"></a><a href="#l696">696</a><td><tr><td><a id="l697"></a><a href="#l697">697</a><td>  // NOTE(arv): If element is hidden (display none or disconnected or any the<tr><td><a id="l698"></a><a href="#l698">698</a><td>  // ancestors are hidden) we get (0,0) by default but we still do the<tr><td><a id="l699"></a><a href="#l699">699</a><td>  // accumulation of scroll position.<tr><td><a id="l700"></a><a href="#l700">700</a><td><tr><td><a id="l701"></a><a href="#l701">701</a><td>  // TODO(arv): Should we check if the node is disconnected and in that case<tr><td><a id="l702"></a><a href="#l702">702</a><td>  //            return (0,0)?<tr><td><a id="l703"></a><a href="#l703">703</a><td><tr><td><a id="l704"></a><a href="#l704">704</a><td>  var pos = new goog.math.Coordinate(0, 0);<tr><td><a id="l705"></a><a href="#l705">705</a><td>  var viewportElement = goog.style.getClientViewportElement(doc);<tr><td><a id="l706"></a><a href="#l706">706</a><td>  if (el == viewportElement) {<tr><td><a id="l707"></a><a href="#l707">707</a><td>    // viewport is always at 0,0 as that defined the coordinate system for this<tr><td><a id="l708"></a><a href="#l708">708</a><td>    // function - this avoids special case checks in the code below<tr><td><a id="l709"></a><a href="#l709">709</a><td>    return pos;<tr><td><a id="l710"></a><a href="#l710">710</a><td>  }<tr><td><a id="l711"></a><a href="#l711">711</a><td><tr><td><a id="l712"></a><a href="#l712">712</a><td>  var box = goog.style.getBoundingClientRect_(el);<tr><td><a id="l713"></a><a href="#l713">713</a><td>  // Must add the scroll coordinates in to get the absolute page offset<tr><td><a id="l714"></a><a href="#l714">714</a><td>  // of element since getBoundingClientRect returns relative coordinates to<tr><td><a id="l715"></a><a href="#l715">715</a><td>  // the viewport.<tr><td><a id="l716"></a><a href="#l716">716</a><td>  var scrollCoord = goog.dom.getDomHelper(doc).getDocumentScroll();<tr><td><a id="l717"></a><a href="#l717">717</a><td>  pos.x = box.left + scrollCoord.x;<tr><td><a id="l718"></a><a href="#l718">718</a><td>  pos.y = box.top + scrollCoord.y;<tr><td><a id="l719"></a><a href="#l719">719</a><td><tr><td><a id="l720"></a><a href="#l720">720</a><td>  return pos;<tr><td><a id="l721"></a><a href="#l721">721</a><td>};<tr><td><a id="l722"></a><a href="#l722">722</a><td><tr><td><a id="l723"></a><a href="#l723">723</a><td><tr><td><a id="l724"></a><a href="#l724">724</a><td>/**<tr><td><a id="l725"></a><a href="#l725">725</a><td> * Returns the left coordinate of an element relative to the HTML document<tr><td><a id="l726"></a><a href="#l726">726</a><td> * @param {Element} el Elements.<tr><td><a id="l727"></a><a href="#l727">727</a><td> * @return {number} The left coordinate.<tr><td><a id="l728"></a><a href="#l728">728</a><td> */<tr><td><a id="l729"></a><a href="#l729">729</a><td>goog.style.getPageOffsetLeft = function(el) {<tr><td><a id="l730"></a><a href="#l730">730</a><td>  return goog.style.getPageOffset(el).x;<tr><td><a id="l731"></a><a href="#l731">731</a><td>};<tr><td><a id="l732"></a><a href="#l732">732</a><td><tr><td><a id="l733"></a><a href="#l733">733</a><td><tr><td><a id="l734"></a><a href="#l734">734</a><td>/**<tr><td><a id="l735"></a><a href="#l735">735</a><td> * Returns the top coordinate of an element relative to the HTML document<tr><td><a id="l736"></a><a href="#l736">736</a><td> * @param {Element} el Elements.<tr><td><a id="l737"></a><a href="#l737">737</a><td> * @return {number} The top coordinate.<tr><td><a id="l738"></a><a href="#l738">738</a><td> */<tr><td><a id="l739"></a><a href="#l739">739</a><td>goog.style.getPageOffsetTop = function(el) {<tr><td><a id="l740"></a><a href="#l740">740</a><td>  return goog.style.getPageOffset(el).y;<tr><td><a id="l741"></a><a href="#l741">741</a><td>};<tr><td><a id="l742"></a><a href="#l742">742</a><td><tr><td><a id="l743"></a><a href="#l743">743</a><td><tr><td><a id="l744"></a><a href="#l744">744</a><td>/**<tr><td><a id="l745"></a><a href="#l745">745</a><td> * Returns a Coordinate object relative to the top-left of an HTML document<tr><td><a id="l746"></a><a href="#l746">746</a><td> * in an ancestor frame of this element. Used for measuring the position of<tr><td><a id="l747"></a><a href="#l747">747</a><td> * an element inside a frame relative to a containing frame.<tr><td><a id="l748"></a><a href="#l748">748</a><td> *<tr><td><a id="l749"></a><a href="#l749">749</a><td> * @param {Element} el Element to get the page offset for.<tr><td><a id="l750"></a><a href="#l750">750</a><td> * @param {Window} relativeWin The window to measure relative to. If relativeWin<tr><td><a id="l751"></a><a href="#l751">751</a><td> *     is not in the ancestor frame chain of the element, we measure relative to<tr><td><a id="l752"></a><a href="#l752">752</a><td> *     the top-most window.<tr><td><a id="l753"></a><a href="#l753">753</a><td> * @return {!goog.math.Coordinate} The page offset.<tr><td><a id="l754"></a><a href="#l754">754</a><td> */<tr><td><a id="l755"></a><a href="#l755">755</a><td>goog.style.getFramedPageOffset = function(el, relativeWin) {<tr><td><a id="l756"></a><a href="#l756">756</a><td>  var position = new goog.math.Coordinate(0, 0);<tr><td><a id="l757"></a><a href="#l757">757</a><td><tr><td><a id="l758"></a><a href="#l758">758</a><td>  // Iterate up the ancestor frame chain, keeping track of the current window<tr><td><a id="l759"></a><a href="#l759">759</a><td>  // and the current element in that window.<tr><td><a id="l760"></a><a href="#l760">760</a><td>  var currentWin = goog.dom.getWindow(goog.dom.getOwnerDocument(el));<tr><td><a id="l761"></a><a href="#l761">761</a><td>  var currentEl = el;<tr><td><a id="l762"></a><a href="#l762">762</a><td>  do {<tr><td><a id="l763"></a><a href="#l763">763</a><td>    // if we&#39;re at the top window, we want to get the page offset.<tr><td><a id="l764"></a><a href="#l764">764</a><td>    // if we&#39;re at an inner frame, we only want to get the window position<tr><td><a id="l765"></a><a href="#l765">765</a><td>    // so that we can determine the actual page offset in the context of<tr><td><a id="l766"></a><a href="#l766">766</a><td>    // the outer window.<tr><td><a id="l767"></a><a href="#l767">767</a><td>    var offset = currentWin == relativeWin ?<tr><td><a id="l768"></a><a href="#l768">768</a><td>        goog.style.getPageOffset(currentEl) :<tr><td><a id="l769"></a><a href="#l769">769</a><td>        goog.style.getClientPositionForElement_(<tr><td><a id="l770"></a><a href="#l770">770</a><td>            goog.asserts.assert(currentEl));<tr><td><a id="l771"></a><a href="#l771">771</a><td><tr><td><a id="l772"></a><a href="#l772">772</a><td>    position.x += offset.x;<tr><td><a id="l773"></a><a href="#l773">773</a><td>    position.y += offset.y;<tr><td><a id="l774"></a><a href="#l774">774</a><td>  } while (currentWin &amp;&amp; currentWin != relativeWin &amp;&amp;<tr><td><a id="l775"></a><a href="#l775">775</a><td>      currentWin != currentWin.parent &amp;&amp;<tr><td><a id="l776"></a><a href="#l776">776</a><td>      (currentEl = currentWin.frameElement) &amp;&amp;<tr><td><a id="l777"></a><a href="#l777">777</a><td>      (currentWin = currentWin.parent));<tr><td><a id="l778"></a><a href="#l778">778</a><td><tr><td><a id="l779"></a><a href="#l779">779</a><td>  return position;<tr><td><a id="l780"></a><a href="#l780">780</a><td>};<tr><td><a id="l781"></a><a href="#l781">781</a><td><tr><td><a id="l782"></a><a href="#l782">782</a><td><tr><td><a id="l783"></a><a href="#l783">783</a><td>/**<tr><td><a id="l784"></a><a href="#l784">784</a><td> * Translates the specified rect relative to origBase page, for newBase page.<tr><td><a id="l785"></a><a href="#l785">785</a><td> * If origBase and newBase are the same, this function does nothing.<tr><td><a id="l786"></a><a href="#l786">786</a><td> *<tr><td><a id="l787"></a><a href="#l787">787</a><td> * @param {goog.math.Rect} rect The source rectangle relative to origBase page,<tr><td><a id="l788"></a><a href="#l788">788</a><td> *     and it will have the translated result.<tr><td><a id="l789"></a><a href="#l789">789</a><td> * @param {goog.dom.DomHelper} origBase The DomHelper for the input rectangle.<tr><td><a id="l790"></a><a href="#l790">790</a><td> * @param {goog.dom.DomHelper} newBase The DomHelper for the resultant<tr><td><a id="l791"></a><a href="#l791">791</a><td> *     coordinate.  This must be a DOM for an ancestor frame of origBase<tr><td><a id="l792"></a><a href="#l792">792</a><td> *     or the same as origBase.<tr><td><a id="l793"></a><a href="#l793">793</a><td> */<tr><td><a id="l794"></a><a href="#l794">794</a><td>goog.style.translateRectForAnotherFrame = function(rect, origBase, newBase) {<tr><td><a id="l795"></a><a href="#l795">795</a><td>  if (origBase.getDocument() != newBase.getDocument()) {<tr><td><a id="l796"></a><a href="#l796">796</a><td>    var body = origBase.getDocument().body;<tr><td><a id="l797"></a><a href="#l797">797</a><td>    var pos = goog.style.getFramedPageOffset(body, newBase.getWindow());<tr><td><a id="l798"></a><a href="#l798">798</a><td><tr><td><a id="l799"></a><a href="#l799">799</a><td>    // Adjust Body&#39;s margin.<tr><td><a id="l800"></a><a href="#l800">800</a><td>    pos = goog.math.Coordinate.difference(pos, goog.style.getPageOffset(body));<tr><td><a id="l801"></a><a href="#l801">801</a><td><tr><td><a id="l802"></a><a href="#l802">802</a><td>    if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isDocumentModeOrHigher(9) &amp;&amp;<tr><td><a id="l803"></a><a href="#l803">803</a><td>        !origBase.isCss1CompatMode()) {<tr><td><a id="l804"></a><a href="#l804">804</a><td>      pos = goog.math.Coordinate.difference(pos, origBase.getDocumentScroll());<tr><td><a id="l805"></a><a href="#l805">805</a><td>    }<tr><td><a id="l806"></a><a href="#l806">806</a><td><tr><td><a id="l807"></a><a href="#l807">807</a><td>    rect.left += pos.x;<tr><td><a id="l808"></a><a href="#l808">808</a><td>    rect.top += pos.y;<tr><td><a id="l809"></a><a href="#l809">809</a><td>  }<tr><td><a id="l810"></a><a href="#l810">810</a><td>};<tr><td><a id="l811"></a><a href="#l811">811</a><td><tr><td><a id="l812"></a><a href="#l812">812</a><td><tr><td><a id="l813"></a><a href="#l813">813</a><td>/**<tr><td><a id="l814"></a><a href="#l814">814</a><td> * Returns the position of an element relative to another element in the<tr><td><a id="l815"></a><a href="#l815">815</a><td> * document.  A relative to B<tr><td><a id="l816"></a><a href="#l816">816</a><td> * @param {Element|Event|goog.events.Event} a Element or mouse event whose<tr><td><a id="l817"></a><a href="#l817">817</a><td> *     position we&#39;re calculating.<tr><td><a id="l818"></a><a href="#l818">818</a><td> * @param {Element|Event|goog.events.Event} b Element or mouse event position<tr><td><a id="l819"></a><a href="#l819">819</a><td> *     is relative to.<tr><td><a id="l820"></a><a href="#l820">820</a><td> * @return {!goog.math.Coordinate} The relative position.<tr><td><a id="l821"></a><a href="#l821">821</a><td> */<tr><td><a id="l822"></a><a href="#l822">822</a><td>goog.style.getRelativePosition = function(a, b) {<tr><td><a id="l823"></a><a href="#l823">823</a><td>  var ap = goog.style.getClientPosition(a);<tr><td><a id="l824"></a><a href="#l824">824</a><td>  var bp = goog.style.getClientPosition(b);<tr><td><a id="l825"></a><a href="#l825">825</a><td>  return new goog.math.Coordinate(ap.x - bp.x, ap.y - bp.y);<tr><td><a id="l826"></a><a href="#l826">826</a><td>};<tr><td><a id="l827"></a><a href="#l827">827</a><td><tr><td><a id="l828"></a><a href="#l828">828</a><td><tr><td><a id="l829"></a><a href="#l829">829</a><td>/**<tr><td><a id="l830"></a><a href="#l830">830</a><td> * Returns the position of the event or the element&#39;s border box relative to<tr><td><a id="l831"></a><a href="#l831">831</a><td> * the client viewport.<tr><td><a id="l832"></a><a href="#l832">832</a><td> * @param {!Element} el Element whose position to get.<tr><td><a id="l833"></a><a href="#l833">833</a><td> * @return {!goog.math.Coordinate} The position.<tr><td><a id="l834"></a><a href="#l834">834</a><td> * @private<tr><td><a id="l835"></a><a href="#l835">835</a><td> */<tr><td><a id="l836"></a><a href="#l836">836</a><td>goog.style.getClientPositionForElement_ = function(el) {<tr><td><a id="l837"></a><a href="#l837">837</a><td>  var box = goog.style.getBoundingClientRect_(el);<tr><td><a id="l838"></a><a href="#l838">838</a><td>  return new goog.math.Coordinate(box.left, box.top);<tr><td><a id="l839"></a><a href="#l839">839</a><td>};<tr><td><a id="l840"></a><a href="#l840">840</a><td><tr><td><a id="l841"></a><a href="#l841">841</a><td><tr><td><a id="l842"></a><a href="#l842">842</a><td>/**<tr><td><a id="l843"></a><a href="#l843">843</a><td> * Returns the position of the event or the element&#39;s border box relative to<tr><td><a id="l844"></a><a href="#l844">844</a><td> * the client viewport. If an event is passed, and if this event is a &quot;touch&quot;<tr><td><a id="l845"></a><a href="#l845">845</a><td> * event, then the position of the first changedTouches will be returned.<tr><td><a id="l846"></a><a href="#l846">846</a><td> * @param {Element|Event|goog.events.Event} el Element or a mouse / touch event.<tr><td><a id="l847"></a><a href="#l847">847</a><td> * @return {!goog.math.Coordinate} The position.<tr><td><a id="l848"></a><a href="#l848">848</a><td> */<tr><td><a id="l849"></a><a href="#l849">849</a><td>goog.style.getClientPosition = function(el) {<tr><td><a id="l850"></a><a href="#l850">850</a><td>  goog.asserts.assert(el);<tr><td><a id="l851"></a><a href="#l851">851</a><td>  if (el.nodeType == goog.dom.NodeType.ELEMENT) {<tr><td><a id="l852"></a><a href="#l852">852</a><td>    return goog.style.getClientPositionForElement_(<tr><td><a id="l853"></a><a href="#l853">853</a><td>        /** @type {!Element} */ (el));<tr><td><a id="l854"></a><a href="#l854">854</a><td>  } else {<tr><td><a id="l855"></a><a href="#l855">855</a><td>    var targetEvent = el.changedTouches ? el.changedTouches[0] : el;<tr><td><a id="l856"></a><a href="#l856">856</a><td>    return new goog.math.Coordinate(<tr><td><a id="l857"></a><a href="#l857">857</a><td>        targetEvent.clientX,<tr><td><a id="l858"></a><a href="#l858">858</a><td>        targetEvent.clientY);<tr><td><a id="l859"></a><a href="#l859">859</a><td>  }<tr><td><a id="l860"></a><a href="#l860">860</a><td>};<tr><td><a id="l861"></a><a href="#l861">861</a><td><tr><td><a id="l862"></a><a href="#l862">862</a><td><tr><td><a id="l863"></a><a href="#l863">863</a><td>/**<tr><td><a id="l864"></a><a href="#l864">864</a><td> * Moves an element to the given coordinates relative to the client viewport.<tr><td><a id="l865"></a><a href="#l865">865</a><td> * @param {Element} el Absolutely positioned element to set page offset for.<tr><td><a id="l866"></a><a href="#l866">866</a><td> *     It must be in the document.<tr><td><a id="l867"></a><a href="#l867">867</a><td> * @param {number|goog.math.Coordinate} x Left position of the element&#39;s margin<tr><td><a id="l868"></a><a href="#l868">868</a><td> *     box or a coordinate object.<tr><td><a id="l869"></a><a href="#l869">869</a><td> * @param {number=} opt_y Top position of the element&#39;s margin box.<tr><td><a id="l870"></a><a href="#l870">870</a><td> */<tr><td><a id="l871"></a><a href="#l871">871</a><td>goog.style.setPageOffset = function(el, x, opt_y) {<tr><td><a id="l872"></a><a href="#l872">872</a><td>  // Get current pageoffset<tr><td><a id="l873"></a><a href="#l873">873</a><td>  var cur = goog.style.getPageOffset(el);<tr><td><a id="l874"></a><a href="#l874">874</a><td><tr><td><a id="l875"></a><a href="#l875">875</a><td>  if (x instanceof goog.math.Coordinate) {<tr><td><a id="l876"></a><a href="#l876">876</a><td>    opt_y = x.y;<tr><td><a id="l877"></a><a href="#l877">877</a><td>    x = x.x;<tr><td><a id="l878"></a><a href="#l878">878</a><td>  }<tr><td><a id="l879"></a><a href="#l879">879</a><td><tr><td><a id="l880"></a><a href="#l880">880</a><td>  // NOTE(arv): We cannot allow strings for x and y. We could but that would<tr><td><a id="l881"></a><a href="#l881">881</a><td>  // require us to manually transform between different units<tr><td><a id="l882"></a><a href="#l882">882</a><td><tr><td><a id="l883"></a><a href="#l883">883</a><td>  // Work out deltas<tr><td><a id="l884"></a><a href="#l884">884</a><td>  var dx = x - cur.x;<tr><td><a id="l885"></a><a href="#l885">885</a><td>  var dy = opt_y - cur.y;<tr><td><a id="l886"></a><a href="#l886">886</a><td><tr><td><a id="l887"></a><a href="#l887">887</a><td>  // Set position to current left/top + delta<tr><td><a id="l888"></a><a href="#l888">888</a><td>  goog.style.setPosition(el, /** @type {!HTMLElement} */ (el).offsetLeft + dx,<tr><td><a id="l889"></a><a href="#l889">889</a><td>                         /** @type {!HTMLElement} */ (el).offsetTop + dy);<tr><td><a id="l890"></a><a href="#l890">890</a><td>};<tr><td><a id="l891"></a><a href="#l891">891</a><td><tr><td><a id="l892"></a><a href="#l892">892</a><td><tr><td><a id="l893"></a><a href="#l893">893</a><td>/**<tr><td><a id="l894"></a><a href="#l894">894</a><td> * Sets the width/height values of an element.  If an argument is numeric,<tr><td><a id="l895"></a><a href="#l895">895</a><td> * or a goog.math.Size is passed, it is assumed to be pixels and will add<tr><td><a id="l896"></a><a href="#l896">896</a><td> * &#39;px&#39; after converting it to an integer in string form. (This just sets the<tr><td><a id="l897"></a><a href="#l897">897</a><td> * CSS width and height properties so it might set content-box or border-box<tr><td><a id="l898"></a><a href="#l898">898</a><td> * size depending on the box model the browser is using.)<tr><td><a id="l899"></a><a href="#l899">899</a><td> *<tr><td><a id="l900"></a><a href="#l900">900</a><td> * @param {Element} element Element to set the size of.<tr><td><a id="l901"></a><a href="#l901">901</a><td> * @param {string|number|goog.math.Size} w Width of the element, or a<tr><td><a id="l902"></a><a href="#l902">902</a><td> *     size object.<tr><td><a id="l903"></a><a href="#l903">903</a><td> * @param {string|number=} opt_h Height of the element. Required if w is not a<tr><td><a id="l904"></a><a href="#l904">904</a><td> *     size object.<tr><td><a id="l905"></a><a href="#l905">905</a><td> */<tr><td><a id="l906"></a><a href="#l906">906</a><td>goog.style.setSize = function(element, w, opt_h) {<tr><td><a id="l907"></a><a href="#l907">907</a><td>  var h;<tr><td><a id="l908"></a><a href="#l908">908</a><td>  if (w instanceof goog.math.Size) {<tr><td><a id="l909"></a><a href="#l909">909</a><td>    h = w.height;<tr><td><a id="l910"></a><a href="#l910">910</a><td>    w = w.width;<tr><td><a id="l911"></a><a href="#l911">911</a><td>  } else {<tr><td><a id="l912"></a><a href="#l912">912</a><td>    if (opt_h == undefined) {<tr><td><a id="l913"></a><a href="#l913">913</a><td>      throw Error(&#39;missing height argument&#39;);<tr><td><a id="l914"></a><a href="#l914">914</a><td>    }<tr><td><a id="l915"></a><a href="#l915">915</a><td>    h = opt_h;<tr><td><a id="l916"></a><a href="#l916">916</a><td>  }<tr><td><a id="l917"></a><a href="#l917">917</a><td><tr><td><a id="l918"></a><a href="#l918">918</a><td>  goog.style.setWidth(element, /** @type {string|number} */ (w));<tr><td><a id="l919"></a><a href="#l919">919</a><td>  goog.style.setHeight(element, h);<tr><td><a id="l920"></a><a href="#l920">920</a><td>};<tr><td><a id="l921"></a><a href="#l921">921</a><td><tr><td><a id="l922"></a><a href="#l922">922</a><td><tr><td><a id="l923"></a><a href="#l923">923</a><td>/**<tr><td><a id="l924"></a><a href="#l924">924</a><td> * Helper function to create a string to be set into a pixel-value style<tr><td><a id="l925"></a><a href="#l925">925</a><td> * property of an element. Can round to the nearest integer value.<tr><td><a id="l926"></a><a href="#l926">926</a><td> *<tr><td><a id="l927"></a><a href="#l927">927</a><td> * @param {string|number} value The style value to be used. If a number,<tr><td><a id="l928"></a><a href="#l928">928</a><td> *     &#39;px&#39; will be appended, otherwise the value will be applied directly.<tr><td><a id="l929"></a><a href="#l929">929</a><td> * @param {boolean} round Whether to round the nearest integer (if property<tr><td><a id="l930"></a><a href="#l930">930</a><td> *     is a number).<tr><td><a id="l931"></a><a href="#l931">931</a><td> * @return {string} The string value for the property.<tr><td><a id="l932"></a><a href="#l932">932</a><td> * @private<tr><td><a id="l933"></a><a href="#l933">933</a><td> */<tr><td><a id="l934"></a><a href="#l934">934</a><td>goog.style.getPixelStyleValue_ = function(value, round) {<tr><td><a id="l935"></a><a href="#l935">935</a><td>  if (typeof value == &#39;number&#39;) {<tr><td><a id="l936"></a><a href="#l936">936</a><td>    value = (round ? Math.round(value) : value) + &#39;px&#39;;<tr><td><a id="l937"></a><a href="#l937">937</a><td>  }<tr><td><a id="l938"></a><a href="#l938">938</a><td><tr><td><a id="l939"></a><a href="#l939">939</a><td>  return value;<tr><td><a id="l940"></a><a href="#l940">940</a><td>};<tr><td><a id="l941"></a><a href="#l941">941</a><td><tr><td><a id="l942"></a><a href="#l942">942</a><td><tr><td><a id="l943"></a><a href="#l943">943</a><td>/**<tr><td><a id="l944"></a><a href="#l944">944</a><td> * Set the height of an element.  Sets the element&#39;s style property.<tr><td><a id="l945"></a><a href="#l945">945</a><td> * @param {Element} element Element to set the height of.<tr><td><a id="l946"></a><a href="#l946">946</a><td> * @param {string|number} height The height value to set.  If a number, &#39;px&#39;<tr><td><a id="l947"></a><a href="#l947">947</a><td> *     will be appended, otherwise the value will be applied directly.<tr><td><a id="l948"></a><a href="#l948">948</a><td> */<tr><td><a id="l949"></a><a href="#l949">949</a><td>goog.style.setHeight = function(element, height) {<tr><td><a id="l950"></a><a href="#l950">950</a><td>  element.style.height = goog.style.getPixelStyleValue_(height, true);<tr><td><a id="l951"></a><a href="#l951">951</a><td>};<tr><td><a id="l952"></a><a href="#l952">952</a><td><tr><td><a id="l953"></a><a href="#l953">953</a><td><tr><td><a id="l954"></a><a href="#l954">954</a><td>/**<tr><td><a id="l955"></a><a href="#l955">955</a><td> * Set the width of an element.  Sets the element&#39;s style property.<tr><td><a id="l956"></a><a href="#l956">956</a><td> * @param {Element} element Element to set the width of.<tr><td><a id="l957"></a><a href="#l957">957</a><td> * @param {string|number} width The width value to set.  If a number, &#39;px&#39;<tr><td><a id="l958"></a><a href="#l958">958</a><td> *     will be appended, otherwise the value will be applied directly.<tr><td><a id="l959"></a><a href="#l959">959</a><td> */<tr><td><a id="l960"></a><a href="#l960">960</a><td>goog.style.setWidth = function(element, width) {<tr><td><a id="l961"></a><a href="#l961">961</a><td>  element.style.width = goog.style.getPixelStyleValue_(width, true);<tr><td><a id="l962"></a><a href="#l962">962</a><td>};<tr><td><a id="l963"></a><a href="#l963">963</a><td><tr><td><a id="l964"></a><a href="#l964">964</a><td><tr><td><a id="l965"></a><a href="#l965">965</a><td>/**<tr><td><a id="l966"></a><a href="#l966">966</a><td> * Gets the height and width of an element, even if its display is none.<tr><td><a id="l967"></a><a href="#l967">967</a><td> *<tr><td><a id="l968"></a><a href="#l968">968</a><td> * Specifically, this returns the height and width of the border box,<tr><td><a id="l969"></a><a href="#l969">969</a><td> * irrespective of the box model in effect.<tr><td><a id="l970"></a><a href="#l970">970</a><td> *<tr><td><a id="l971"></a><a href="#l971">971</a><td> * Note that this function does not take CSS transforms into account. Please see<tr><td><a id="l972"></a><a href="#l972">972</a><td> * {@code goog.style.getTransformedSize}.<tr><td><a id="l973"></a><a href="#l973">973</a><td> * @param {Element} element Element to get size of.<tr><td><a id="l974"></a><a href="#l974">974</a><td> * @return {!goog.math.Size} Object with width/height properties.<tr><td><a id="l975"></a><a href="#l975">975</a><td> */<tr><td><a id="l976"></a><a href="#l976">976</a><td>goog.style.getSize = function(element) {<tr><td><a id="l977"></a><a href="#l977">977</a><td>  return goog.style.evaluateWithTemporaryDisplay_(<tr><td><a id="l978"></a><a href="#l978">978</a><td>      goog.style.getSizeWithDisplay_, /** @type {!Element} */ (element));<tr><td><a id="l979"></a><a href="#l979">979</a><td>};<tr><td><a id="l980"></a><a href="#l980">980</a><td><tr><td><a id="l981"></a><a href="#l981">981</a><td><tr><td><a id="l982"></a><a href="#l982">982</a><td>/**<tr><td><a id="l983"></a><a href="#l983">983</a><td> * Call {@code fn} on {@code element} such that {@code element}&#39;s dimensions are<tr><td><a id="l984"></a><a href="#l984">984</a><td> * accurate when it&#39;s passed to {@code fn}.<tr><td><a id="l985"></a><a href="#l985">985</a><td> * @param {function(!Element): T} fn Function to call with {@code element} as<tr><td><a id="l986"></a><a href="#l986">986</a><td> *     an argument after temporarily changing {@code element}&#39;s display such<tr><td><a id="l987"></a><a href="#l987">987</a><td> *     that its dimensions are accurate.<tr><td><a id="l988"></a><a href="#l988">988</a><td> * @param {!Element} element Element (which may have display none) to use as<tr><td><a id="l989"></a><a href="#l989">989</a><td> *     argument to {@code fn}.<tr><td><a id="l990"></a><a href="#l990">990</a><td> * @return {T} Value returned by calling {@code fn} with {@code element}.<tr><td><a id="l991"></a><a href="#l991">991</a><td> * @template T<tr><td><a id="l992"></a><a href="#l992">992</a><td> * @private<tr><td><a id="l993"></a><a href="#l993">993</a><td> */<tr><td><a id="l994"></a><a href="#l994">994</a><td>goog.style.evaluateWithTemporaryDisplay_ = function(fn, element) {<tr><td><a id="l995"></a><a href="#l995">995</a><td>  if (goog.style.getStyle_(element, &#39;display&#39;) != &#39;none&#39;) {<tr><td><a id="l996"></a><a href="#l996">996</a><td>    return fn(element);<tr><td><a id="l997"></a><a href="#l997">997</a><td>  }<tr><td><a id="l998"></a><a href="#l998">998</a><td><tr><td><a id="l999"></a><a href="#l999">999</a><td>  var style = element.style;<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td>  var originalDisplay = style.display;<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td>  var originalVisibility = style.visibility;<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td>  var originalPosition = style.position;<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td><tr><td><a id="l1004"></a><a href="#l1004">1004</a><td>  style.visibility = &#39;hidden&#39;;<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td>  style.position = &#39;absolute&#39;;<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td>  style.display = &#39;inline&#39;;<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td><tr><td><a id="l1008"></a><a href="#l1008">1008</a><td>  var retVal = fn(element);<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td><tr><td><a id="l1010"></a><a href="#l1010">1010</a><td>  style.display = originalDisplay;<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td>  style.position = originalPosition;<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td>  style.visibility = originalVisibility;<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td><tr><td><a id="l1014"></a><a href="#l1014">1014</a><td>  return retVal;<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>};<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td><tr><td><a id="l1017"></a><a href="#l1017">1017</a><td><tr><td><a id="l1018"></a><a href="#l1018">1018</a><td>/**<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td> * Gets the height and width of an element when the display is not none.<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td> * @param {Element} element Element to get size of.<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td> * @return {!goog.math.Size} Object with width/height properties.<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td> * @private<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td> */<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td>goog.style.getSizeWithDisplay_ = function(element) {<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td>  var offsetWidth = /** @type {!HTMLElement} */ (element).offsetWidth;<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>  var offsetHeight = /** @type {!HTMLElement} */ (element).offsetHeight;<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>  var webkitOffsetsZero =<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>      goog.userAgent.WEBKIT &amp;&amp; !offsetWidth &amp;&amp; !offsetHeight;<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td>  if ((!goog.isDef(offsetWidth) || webkitOffsetsZero) &amp;&amp;<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>      element.getBoundingClientRect) {<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td>    // Fall back to calling getBoundingClientRect when offsetWidth or<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td>    // offsetHeight are not defined, or when they are zero in WebKit browsers.<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>    // This makes sure that we return for the correct size for SVG elements, but<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>    // will still return 0 on Webkit prior to 534.8, see<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>    // http://trac.webkit.org/changeset/67252.<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>    var clientRect = goog.style.getBoundingClientRect_(element);<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td>    return new goog.math.Size(clientRect.right - clientRect.left,<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td>        clientRect.bottom - clientRect.top);<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>  }<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>  return new goog.math.Size(offsetWidth, offsetHeight);<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td>};<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td><tr><td><a id="l1043"></a><a href="#l1043">1043</a><td><tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>/**<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td> * Gets the height and width of an element, post transform, even if its display<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td> * is none.<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td> *<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td> * This is like {@code goog.style.getSize}, except:<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td> * &lt;ol&gt;<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td> * &lt;li&gt;Takes webkitTransforms such as rotate and scale into account.<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td> * &lt;li&gt;Will return null if {@code element} doesn&#39;t respond to<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td> *     {@code getBoundingClientRect}.<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td> * &lt;li&gt;Currently doesn&#39;t make sense on non-WebKit browsers which don&#39;t support<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td> *    webkitTransforms.<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td> * &lt;/ol&gt;<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td> * @param {!Element} element Element to get size of.<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td> * @return {goog.math.Size} Object with width/height properties.<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td> */<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td>goog.style.getTransformedSize = function(element) {<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td>  if (!element.getBoundingClientRect) {<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td>    return null;<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td>  }<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td><tr><td><a id="l1064"></a><a href="#l1064">1064</a><td>  var clientRect = goog.style.evaluateWithTemporaryDisplay_(<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td>      goog.style.getBoundingClientRect_, element);<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td>  return new goog.math.Size(clientRect.right - clientRect.left,<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>      clientRect.bottom - clientRect.top);<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td>};<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td><tr><td><a id="l1070"></a><a href="#l1070">1070</a><td><tr><td><a id="l1071"></a><a href="#l1071">1071</a><td>/**<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td> * Returns a bounding rectangle for a given element in page space.<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td> * @param {Element} element Element to get bounds of. Must not be display none.<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td> * @return {!goog.math.Rect} Bounding rectangle for the element.<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td> */<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td>goog.style.getBounds = function(element) {<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td>  var o = goog.style.getPageOffset(element);<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td>  var s = goog.style.getSize(element);<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td>  return new goog.math.Rect(o.x, o.y, s.width, s.height);<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>};<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td><tr><td><a id="l1082"></a><a href="#l1082">1082</a><td><tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>/**<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td> * Converts a CSS selector in the form style-property to styleProperty.<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td> * @param {*} selector CSS Selector.<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td> * @return {string} Camel case selector.<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td> * @deprecated Use goog.string.toCamelCase instead.<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td> */<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>goog.style.toCamelCase = function(selector) {<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>  return goog.string.toCamelCase(String(selector));<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td>};<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td><tr><td><a id="l1093"></a><a href="#l1093">1093</a><td><tr><td><a id="l1094"></a><a href="#l1094">1094</a><td>/**<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td> * Converts a CSS selector in the form styleProperty to style-property.<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td> * @param {string} selector Camel case selector.<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td> * @return {string} Selector cased.<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td> * @deprecated Use goog.string.toSelectorCase instead.<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td> */<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>goog.style.toSelectorCase = function(selector) {<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td>  return goog.string.toSelectorCase(selector);<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td>};<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td><tr><td><a id="l1104"></a><a href="#l1104">1104</a><td><tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>/**<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td> * Gets the opacity of a node (x-browser). This gets the inline style opacity<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td> * of the node, and does not take into account the cascaded or the computed<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td> * style for this node.<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td> * @param {Element} el Element whose opacity has to be found.<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td> * @return {number|string} Opacity between 0 and 1 or an empty string {@code &#39;&#39;}<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td> *     if the opacity is not set.<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td> */<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td>goog.style.getOpacity = function(el) {<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td>  var style = el.style;<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td>  var result = &#39;&#39;;<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td>  if (&#39;opacity&#39; in style) {<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td>    result = style.opacity;<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td>  } else if (&#39;MozOpacity&#39; in style) {<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td>    result = style.MozOpacity;<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td>  } else if (&#39;filter&#39; in style) {<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td>    var match = style.filter.match(/alpha\(opacity=([\d.]+)\)/);<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td>    if (match) {<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td>      result = String(match[1] / 100);<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td>    }<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td>  }<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td>  return result == &#39;&#39; ? result : Number(result);<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td>};<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td><tr><td><a id="l1129"></a><a href="#l1129">1129</a><td><tr><td><a id="l1130"></a><a href="#l1130">1130</a><td>/**<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td> * Sets the opacity of a node (x-browser).<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td> * @param {Element} el Elements whose opacity has to be set.<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td> * @param {number|string} alpha Opacity between 0 and 1 or an empty string<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td> *     {@code &#39;&#39;} to clear the opacity.<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td> */<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td>goog.style.setOpacity = function(el, alpha) {<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td>  var style = el.style;<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td>  if (&#39;opacity&#39; in style) {<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>    style.opacity = alpha;<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td>  } else if (&#39;MozOpacity&#39; in style) {<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td>    style.MozOpacity = alpha;<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>  } else if (&#39;filter&#39; in style) {<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>    // TODO(arv): Overwriting the filter might have undesired side effects.<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td>    if (alpha === &#39;&#39;) {<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>      style.filter = &#39;&#39;;<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>    } else {<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td>      style.filter = &#39;alpha(opacity=&#39; + alpha * 100 + &#39;)&#39;;<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td>    }<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td>  }<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>};<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td><tr><td><a id="l1152"></a><a href="#l1152">1152</a><td><tr><td><a id="l1153"></a><a href="#l1153">1153</a><td>/**<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td> * Sets the background of an element to a transparent image in a browser-<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td> * independent manner.<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td> *<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td> * This function does not support repeating backgrounds or alternate background<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td> * positions to match the behavior of Internet Explorer. It also does not<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td> * support sizingMethods other than crop since they cannot be replicated in<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td> * browsers other than Internet Explorer.<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td> *<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td> * @param {Element} el The element to set background on.<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td> * @param {string} src The image source URL.<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td> */<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>goog.style.setTransparentBackgroundImage = function(el, src) {<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td>  var style = el.style;<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>  // It is safe to use the style.filter in IE only. In Safari &#39;filter&#39; is in<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td>  // style object but access to style.filter causes it to throw an exception.<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td>  // Note: IE8 supports images with an alpha channel.<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td>  if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isVersionOrHigher(&#39;8&#39;)) {<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td>    // See TODO in setOpacity.<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td>    style.filter = &#39;progid:DXImageTransform.Microsoft.AlphaImageLoader(&#39; +<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td>        &#39;src=&quot;&#39; + src + &#39;&quot;, sizingMethod=&quot;crop&quot;)&#39;;<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td>  } else {<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td>    // Set style properties individually instead of using background shorthand<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td>    // to prevent overwriting a pre-existing background color.<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td>    style.backgroundImage = &#39;url(&#39; + src + &#39;)&#39;;<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td>    style.backgroundPosition = &#39;top left&#39;;<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td>    style.backgroundRepeat = &#39;no-repeat&#39;;<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td>  }<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td>};<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td><tr><td><a id="l1183"></a><a href="#l1183">1183</a><td><tr><td><a id="l1184"></a><a href="#l1184">1184</a><td>/**<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td> * Clears the background image of an element in a browser independent manner.<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td> * @param {Element} el The element to clear background image for.<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td> */<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td>goog.style.clearTransparentBackgroundImage = function(el) {<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td>  var style = el.style;<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td>  if (&#39;filter&#39; in style) {<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td>    // See TODO in setOpacity.<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>    style.filter = &#39;&#39;;<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>  } else {<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td>    // Set style properties individually instead of using background shorthand<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>    // to prevent overwriting a pre-existing background color.<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td>    style.backgroundImage = &#39;none&#39;;<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td>  }<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td>};<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td><tr><td><a id="l1200"></a><a href="#l1200">1200</a><td><tr><td><a id="l1201"></a><a href="#l1201">1201</a><td>/**<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td> * Shows or hides an element from the page. Hiding the element is done by<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td> * setting the display property to &quot;none&quot;, removing the element from the<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td> * rendering hierarchy so it takes up no space. To show the element, the default<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td> * inherited display property is restored (defined either in stylesheets or by<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td> * the browser&#39;s default style rules.)<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td> *<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td> * Caveat 1: if the inherited display property for the element is set to &quot;none&quot;<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td> * by the stylesheets, that is the property that will be restored by a call to<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td> * showElement(), effectively toggling the display between &quot;none&quot; and &quot;none&quot;.<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td> *<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td> * Caveat 2: if the element display style is set inline (by setting either<tr><td><a id="l1213"></a><a href="#l1213">1213</a><td> * element.style.display or a style attribute in the HTML), a call to<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td> * showElement will clear that setting and defer to the inherited style in the<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td> * stylesheet.<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td> * @param {Element} el Element to show or hide.<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td> * @param {*} display True to render the element in its default style,<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td> *     false to disable rendering the element.<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td> * @deprecated Use goog.style.setElementShown instead.<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td> */<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td>goog.style.showElement = function(el, display) {<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>  goog.style.setElementShown(el, display);<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>};<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td><tr><td><a id="l1225"></a><a href="#l1225">1225</a><td><tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>/**<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td> * Shows or hides an element from the page. Hiding the element is done by<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td> * setting the display property to &quot;none&quot;, removing the element from the<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td> * rendering hierarchy so it takes up no space. To show the element, the default<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td> * inherited display property is restored (defined either in stylesheets or by<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td> * the browser&#39;s default style rules).<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td> *<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td> * Caveat 1: if the inherited display property for the element is set to &quot;none&quot;<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td> * by the stylesheets, that is the property that will be restored by a call to<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td> * setElementShown(), effectively toggling the display between &quot;none&quot; and<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td> * &quot;none&quot;.<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td> *<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td> * Caveat 2: if the element display style is set inline (by setting either<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td> * element.style.display or a style attribute in the HTML), a call to<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td> * setElementShown will clear that setting and defer to the inherited style in<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td> * the stylesheet.<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td> * @param {Element} el Element to show or hide.<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td> * @param {*} isShown True to render the element in its default style,<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td> *     false to disable rendering the element.<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td> */<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td>goog.style.setElementShown = function(el, isShown) {<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>  el.style.display = isShown ? &#39;&#39; : &#39;none&#39;;<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>};<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td><tr><td><a id="l1250"></a><a href="#l1250">1250</a><td><tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>/**<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td> * Test whether the given element has been shown or hidden via a call to<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td> * {@link #setElementShown}.<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td> *<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td> * Note this is strictly a companion method for a call<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td> * to {@link #setElementShown} and the same caveats apply; in particular, this<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td> * method does not guarantee that the return value will be consistent with<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td> * whether or not the element is actually visible.<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td> *<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td> * @param {Element} el The element to test.<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td> * @return {boolean} Whether the element has been shown.<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td> * @see #setElementShown<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td> */<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>goog.style.isElementShown = function(el) {<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>  return el.style.display != &#39;none&#39;;<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>};<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td><tr><td><a id="l1268"></a><a href="#l1268">1268</a><td><tr><td><a id="l1269"></a><a href="#l1269">1269</a><td>/**<tr><td><a id="l1270"></a><a href="#l1270">1270</a><td> * Installs the styles string into the window that contains opt_element.  If<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td> * opt_element is null, the main window is used.<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td> * @param {string} stylesString The style string to install.<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td> * @param {Node=} opt_node Node whose parent document should have the<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td> *     styles installed.<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td> * @return {Element|StyleSheet} The style element created.<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td> */<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td>goog.style.installStyles = function(stylesString, opt_node) {<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>  var dh = goog.dom.getDomHelper(opt_node);<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>  var styleSheet = null;<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td><tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>  // IE &lt; 11 requires createStyleSheet. Note that doc.createStyleSheet will be<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>  // undefined as of IE 11.<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>  var doc = dh.getDocument();<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>  if (goog.userAgent.IE &amp;&amp; doc.createStyleSheet) {<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>    styleSheet = doc.createStyleSheet();<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>    goog.style.setStyles(styleSheet, stylesString);<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>  } else {<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td>    var head = dh.getElementsByTagNameAndClass(goog.dom.TagName.HEAD)[0];<tr><td><a id="l1289"></a><a href="#l1289">1289</a><td><tr><td><a id="l1290"></a><a href="#l1290">1290</a><td>    // In opera documents are not guaranteed to have a head element, thus we<tr><td><a id="l1291"></a><a href="#l1291">1291</a><td>    // have to make sure one exists before using it.<tr><td><a id="l1292"></a><a href="#l1292">1292</a><td>    if (!head) {<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td>      var body = dh.getElementsByTagNameAndClass(goog.dom.TagName.BODY)[0];<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td>      head = dh.createDom(goog.dom.TagName.HEAD);<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td>      body.parentNode.insertBefore(head, body);<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td>    }<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td>    styleSheet = dh.createDom(goog.dom.TagName.STYLE);<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td>    // NOTE(user): Setting styles after the style element has been appended<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td>    // to the head results in a nasty Webkit bug in certain scenarios. Please<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td>    // refer to https://bugs.webkit.org/show_bug.cgi?id=26307 for additional<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>    // details.<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td>    goog.style.setStyles(styleSheet, stylesString);<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td>    dh.appendChild(head, styleSheet);<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>  }<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td>  return styleSheet;<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td>};<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td><tr><td><a id="l1308"></a><a href="#l1308">1308</a><td><tr><td><a id="l1309"></a><a href="#l1309">1309</a><td>/**<tr><td><a id="l1310"></a><a href="#l1310">1310</a><td> * Removes the styles added by {@link #installStyles}.<tr><td><a id="l1311"></a><a href="#l1311">1311</a><td> * @param {Element|StyleSheet} styleSheet The value returned by<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td> *     {@link #installStyles}.<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td> */<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td>goog.style.uninstallStyles = function(styleSheet) {<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td>  var node = styleSheet.ownerNode || styleSheet.owningElement ||<tr><td><a id="l1316"></a><a href="#l1316">1316</a><td>      /** @type {Element} */ (styleSheet);<tr><td><a id="l1317"></a><a href="#l1317">1317</a><td>  goog.dom.removeNode(node);<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td>};<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td><tr><td><a id="l1320"></a><a href="#l1320">1320</a><td><tr><td><a id="l1321"></a><a href="#l1321">1321</a><td>/**<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td> * Sets the content of a style element.  The style element can be any valid<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td> * style element.  This element will have its content completely replaced by<tr><td><a id="l1324"></a><a href="#l1324">1324</a><td> * the new stylesString.<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td> * @param {Element|StyleSheet} element A stylesheet element as returned by<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td> *     installStyles.<tr><td><a id="l1327"></a><a href="#l1327">1327</a><td> * @param {string} stylesString The new content of the stylesheet.<tr><td><a id="l1328"></a><a href="#l1328">1328</a><td> */<tr><td><a id="l1329"></a><a href="#l1329">1329</a><td>goog.style.setStyles = function(element, stylesString) {<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td>  if (goog.userAgent.IE &amp;&amp; goog.isDef(element.cssText)) {<tr><td><a id="l1331"></a><a href="#l1331">1331</a><td>    // Adding the selectors individually caused the browser to hang if the<tr><td><a id="l1332"></a><a href="#l1332">1332</a><td>    // selector was invalid or there were CSS comments.  Setting the cssText of<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td>    // the style node works fine and ignores CSS that IE doesn&#39;t understand.<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td>    // However IE &gt;= 11 doesn&#39;t support cssText any more, so we make sure that<tr><td><a id="l1335"></a><a href="#l1335">1335</a><td>    // cssText is a defined property and otherwise fall back to innerHTML.<tr><td><a id="l1336"></a><a href="#l1336">1336</a><td>    element.cssText = stylesString;<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td>  } else {<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td>    element.innerHTML = stylesString;<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td>  }<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td>};<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td><tr><td><a id="l1342"></a><a href="#l1342">1342</a><td><tr><td><a id="l1343"></a><a href="#l1343">1343</a><td>/**<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td> * Sets &#39;white-space: pre-wrap&#39; for a node (x-browser).<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td> *<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td> * There are as many ways of specifying pre-wrap as there are browsers.<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td> *<tr><td><a id="l1348"></a><a href="#l1348">1348</a><td> * CSS3/IE8: white-space: pre-wrap;<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td> * Mozilla:  white-space: -moz-pre-wrap;<tr><td><a id="l1350"></a><a href="#l1350">1350</a><td> * Opera:    white-space: -o-pre-wrap;<tr><td><a id="l1351"></a><a href="#l1351">1351</a><td> * IE6/7:    white-space: pre; word-wrap: break-word;<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td> *<tr><td><a id="l1353"></a><a href="#l1353">1353</a><td> * @param {Element} el Element to enable pre-wrap for.<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td> */<tr><td><a id="l1355"></a><a href="#l1355">1355</a><td>goog.style.setPreWrap = function(el) {<tr><td><a id="l1356"></a><a href="#l1356">1356</a><td>  var style = el.style;<tr><td><a id="l1357"></a><a href="#l1357">1357</a><td>  if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isVersionOrHigher(&#39;8&#39;)) {<tr><td><a id="l1358"></a><a href="#l1358">1358</a><td>    style.whiteSpace = &#39;pre&#39;;<tr><td><a id="l1359"></a><a href="#l1359">1359</a><td>    style.wordWrap = &#39;break-word&#39;;<tr><td><a id="l1360"></a><a href="#l1360">1360</a><td>  } else if (goog.userAgent.GECKO) {<tr><td><a id="l1361"></a><a href="#l1361">1361</a><td>    style.whiteSpace = &#39;-moz-pre-wrap&#39;;<tr><td><a id="l1362"></a><a href="#l1362">1362</a><td>  } else {<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td>    style.whiteSpace = &#39;pre-wrap&#39;;<tr><td><a id="l1364"></a><a href="#l1364">1364</a><td>  }<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td>};<tr><td><a id="l1366"></a><a href="#l1366">1366</a><td><tr><td><a id="l1367"></a><a href="#l1367">1367</a><td><tr><td><a id="l1368"></a><a href="#l1368">1368</a><td>/**<tr><td><a id="l1369"></a><a href="#l1369">1369</a><td> * Sets &#39;display: inline-block&#39; for an element (cross-browser).<tr><td><a id="l1370"></a><a href="#l1370">1370</a><td> * @param {Element} el Element to which the inline-block display style is to be<tr><td><a id="l1371"></a><a href="#l1371">1371</a><td> *    applied.<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td> * @see ../demos/inline_block_quirks.html<tr><td><a id="l1373"></a><a href="#l1373">1373</a><td> * @see ../demos/inline_block_standards.html<tr><td><a id="l1374"></a><a href="#l1374">1374</a><td> */<tr><td><a id="l1375"></a><a href="#l1375">1375</a><td>goog.style.setInlineBlock = function(el) {<tr><td><a id="l1376"></a><a href="#l1376">1376</a><td>  var style = el.style;<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td>  // Without position:relative, weirdness ensues.  Just accept it and move on.<tr><td><a id="l1378"></a><a href="#l1378">1378</a><td>  style.position = &#39;relative&#39;;<tr><td><a id="l1379"></a><a href="#l1379">1379</a><td><tr><td><a id="l1380"></a><a href="#l1380">1380</a><td>  if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isVersionOrHigher(&#39;8&#39;)) {<tr><td><a id="l1381"></a><a href="#l1381">1381</a><td>    // IE8 supports inline-block so fall through to the else<tr><td><a id="l1382"></a><a href="#l1382">1382</a><td>    // Zoom:1 forces hasLayout, display:inline gives inline behavior.<tr><td><a id="l1383"></a><a href="#l1383">1383</a><td>    style.zoom = &#39;1&#39;;<tr><td><a id="l1384"></a><a href="#l1384">1384</a><td>    style.display = &#39;inline&#39;;<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td>  } else {<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td>    // Opera, Webkit, and Safari seem to do OK with the standard inline-block<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td>    // style.<tr><td><a id="l1388"></a><a href="#l1388">1388</a><td>    style.display = &#39;inline-block&#39;;<tr><td><a id="l1389"></a><a href="#l1389">1389</a><td>  }<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td>};<tr><td><a id="l1391"></a><a href="#l1391">1391</a><td><tr><td><a id="l1392"></a><a href="#l1392">1392</a><td><tr><td><a id="l1393"></a><a href="#l1393">1393</a><td>/**<tr><td><a id="l1394"></a><a href="#l1394">1394</a><td> * Returns true if the element is using right to left (rtl) direction.<tr><td><a id="l1395"></a><a href="#l1395">1395</a><td> * @param {Element} el  The element to test.<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td> * @return {boolean} True for right to left, false for left to right.<tr><td><a id="l1397"></a><a href="#l1397">1397</a><td> */<tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>goog.style.isRightToLeft = function(el) {<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td>  return &#39;rtl&#39; == goog.style.getStyle_(el, &#39;direction&#39;);<tr><td><a id="l1400"></a><a href="#l1400">1400</a><td>};<tr><td><a id="l1401"></a><a href="#l1401">1401</a><td><tr><td><a id="l1402"></a><a href="#l1402">1402</a><td><tr><td><a id="l1403"></a><a href="#l1403">1403</a><td>/**<tr><td><a id="l1404"></a><a href="#l1404">1404</a><td> * The CSS style property corresponding to an element being<tr><td><a id="l1405"></a><a href="#l1405">1405</a><td> * unselectable on the current browser platform (null if none).<tr><td><a id="l1406"></a><a href="#l1406">1406</a><td> * Opera and IE instead use a DOM attribute &#39;unselectable&#39;.<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td> * @type {?string}<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td> * @private<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td> */<tr><td><a id="l1410"></a><a href="#l1410">1410</a><td>goog.style.unselectableStyle_ =<tr><td><a id="l1411"></a><a href="#l1411">1411</a><td>    goog.userAgent.GECKO ? &#39;MozUserSelect&#39; :<tr><td><a id="l1412"></a><a href="#l1412">1412</a><td>    goog.userAgent.WEBKIT ? &#39;WebkitUserSelect&#39; :<tr><td><a id="l1413"></a><a href="#l1413">1413</a><td>    null;<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td><tr><td><a id="l1415"></a><a href="#l1415">1415</a><td><tr><td><a id="l1416"></a><a href="#l1416">1416</a><td>/**<tr><td><a id="l1417"></a><a href="#l1417">1417</a><td> * Returns true if the element is set to be unselectable, false otherwise.<tr><td><a id="l1418"></a><a href="#l1418">1418</a><td> * Note that on some platforms (e.g. Mozilla), even if an element isn&#39;t set<tr><td><a id="l1419"></a><a href="#l1419">1419</a><td> * to be unselectable, it will behave as such if any of its ancestors is<tr><td><a id="l1420"></a><a href="#l1420">1420</a><td> * unselectable.<tr><td><a id="l1421"></a><a href="#l1421">1421</a><td> * @param {Element} el  Element to check.<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td> * @return {boolean}  Whether the element is set to be unselectable.<tr><td><a id="l1423"></a><a href="#l1423">1423</a><td> */<tr><td><a id="l1424"></a><a href="#l1424">1424</a><td>goog.style.isUnselectable = function(el) {<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td>  if (goog.style.unselectableStyle_) {<tr><td><a id="l1426"></a><a href="#l1426">1426</a><td>    return el.style[goog.style.unselectableStyle_].toLowerCase() == &#39;none&#39;;<tr><td><a id="l1427"></a><a href="#l1427">1427</a><td>  } else if (goog.userAgent.IE || goog.userAgent.OPERA) {<tr><td><a id="l1428"></a><a href="#l1428">1428</a><td>    return el.getAttribute(&#39;unselectable&#39;) == &#39;on&#39;;<tr><td><a id="l1429"></a><a href="#l1429">1429</a><td>  }<tr><td><a id="l1430"></a><a href="#l1430">1430</a><td>  return false;<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td>};<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td><tr><td><a id="l1433"></a><a href="#l1433">1433</a><td><tr><td><a id="l1434"></a><a href="#l1434">1434</a><td>/**<tr><td><a id="l1435"></a><a href="#l1435">1435</a><td> * Makes the element and its descendants selectable or unselectable.  Note<tr><td><a id="l1436"></a><a href="#l1436">1436</a><td> * that on some platforms (e.g. Mozilla), even if an element isn&#39;t set to<tr><td><a id="l1437"></a><a href="#l1437">1437</a><td> * be unselectable, it will behave as such if any of its ancestors is<tr><td><a id="l1438"></a><a href="#l1438">1438</a><td> * unselectable.<tr><td><a id="l1439"></a><a href="#l1439">1439</a><td> * @param {Element} el  The element to alter.<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td> * @param {boolean} unselectable  Whether the element and its descendants<tr><td><a id="l1441"></a><a href="#l1441">1441</a><td> *     should be made unselectable.<tr><td><a id="l1442"></a><a href="#l1442">1442</a><td> * @param {boolean=} opt_noRecurse  Whether to only alter the element&#39;s own<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td> *     selectable state, and leave its descendants alone; defaults to false.<tr><td><a id="l1444"></a><a href="#l1444">1444</a><td> */<tr><td><a id="l1445"></a><a href="#l1445">1445</a><td>goog.style.setUnselectable = function(el, unselectable, opt_noRecurse) {<tr><td><a id="l1446"></a><a href="#l1446">1446</a><td>  // TODO(attila): Do we need all of TR_DomUtil.makeUnselectable() in Closure?<tr><td><a id="l1447"></a><a href="#l1447">1447</a><td>  var descendants = !opt_noRecurse ? el.getElementsByTagName(&#39;*&#39;) : null;<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td>  var name = goog.style.unselectableStyle_;<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td>  if (name) {<tr><td><a id="l1450"></a><a href="#l1450">1450</a><td>    // Add/remove the appropriate CSS style to/from the element and its<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td>    // descendants.<tr><td><a id="l1452"></a><a href="#l1452">1452</a><td>    var value = unselectable ? &#39;none&#39; : &#39;&#39;;<tr><td><a id="l1453"></a><a href="#l1453">1453</a><td>    // MathML elements do not have a style property. Verify before setting.<tr><td><a id="l1454"></a><a href="#l1454">1454</a><td>    if (el.style) {<tr><td><a id="l1455"></a><a href="#l1455">1455</a><td>      el.style[name] = value;<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td>    }<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td>    if (descendants) {<tr><td><a id="l1458"></a><a href="#l1458">1458</a><td>      for (var i = 0, descendant; descendant = descendants[i]; i++) {<tr><td><a id="l1459"></a><a href="#l1459">1459</a><td>        if (descendant.style) {<tr><td><a id="l1460"></a><a href="#l1460">1460</a><td>          descendant.style[name] = value;<tr><td><a id="l1461"></a><a href="#l1461">1461</a><td>        }<tr><td><a id="l1462"></a><a href="#l1462">1462</a><td>      }<tr><td><a id="l1463"></a><a href="#l1463">1463</a><td>    }<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td>  } else if (goog.userAgent.IE || goog.userAgent.OPERA) {<tr><td><a id="l1465"></a><a href="#l1465">1465</a><td>    // Toggle the &#39;unselectable&#39; attribute on the element and its descendants.<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td>    var value = unselectable ? &#39;on&#39; : &#39;&#39;;<tr><td><a id="l1467"></a><a href="#l1467">1467</a><td>    el.setAttribute(&#39;unselectable&#39;, value);<tr><td><a id="l1468"></a><a href="#l1468">1468</a><td>    if (descendants) {<tr><td><a id="l1469"></a><a href="#l1469">1469</a><td>      for (var i = 0, descendant; descendant = descendants[i]; i++) {<tr><td><a id="l1470"></a><a href="#l1470">1470</a><td>        descendant.setAttribute(&#39;unselectable&#39;, value);<tr><td><a id="l1471"></a><a href="#l1471">1471</a><td>      }<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td>    }<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td>  }<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td>};<tr><td><a id="l1475"></a><a href="#l1475">1475</a><td><tr><td><a id="l1476"></a><a href="#l1476">1476</a><td><tr><td><a id="l1477"></a><a href="#l1477">1477</a><td>/**<tr><td><a id="l1478"></a><a href="#l1478">1478</a><td> * Gets the border box size for an element.<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td> * @param {Element} element  The element to get the size for.<tr><td><a id="l1480"></a><a href="#l1480">1480</a><td> * @return {!goog.math.Size} The border box size.<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td> */<tr><td><a id="l1482"></a><a href="#l1482">1482</a><td>goog.style.getBorderBoxSize = function(element) {<tr><td><a id="l1483"></a><a href="#l1483">1483</a><td>  return new goog.math.Size(<tr><td><a id="l1484"></a><a href="#l1484">1484</a><td>      /** @type {!HTMLElement} */ (element).offsetWidth,<tr><td><a id="l1485"></a><a href="#l1485">1485</a><td>      /** @type {!HTMLElement} */ (element).offsetHeight);<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td>};<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td><tr><td><a id="l1488"></a><a href="#l1488">1488</a><td><tr><td><a id="l1489"></a><a href="#l1489">1489</a><td>/**<tr><td><a id="l1490"></a><a href="#l1490">1490</a><td> * Sets the border box size of an element. This is potentially expensive in IE<tr><td><a id="l1491"></a><a href="#l1491">1491</a><td> * if the document is CSS1Compat mode<tr><td><a id="l1492"></a><a href="#l1492">1492</a><td> * @param {Element} element  The element to set the size on.<tr><td><a id="l1493"></a><a href="#l1493">1493</a><td> * @param {goog.math.Size} size  The new size.<tr><td><a id="l1494"></a><a href="#l1494">1494</a><td> */<tr><td><a id="l1495"></a><a href="#l1495">1495</a><td>goog.style.setBorderBoxSize = function(element, size) {<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td>  var doc = goog.dom.getOwnerDocument(element);<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td>  var isCss1CompatMode = goog.dom.getDomHelper(doc).isCss1CompatMode();<tr><td><a id="l1498"></a><a href="#l1498">1498</a><td><tr><td><a id="l1499"></a><a href="#l1499">1499</a><td>  if (goog.userAgent.IE &amp;&amp;<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td>      !goog.userAgent.isVersionOrHigher(&#39;10&#39;) &amp;&amp;<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td>      (!isCss1CompatMode || !goog.userAgent.isVersionOrHigher(&#39;8&#39;))) {<tr><td><a id="l1502"></a><a href="#l1502">1502</a><td>    var style = element.style;<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td>    if (isCss1CompatMode) {<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td>      var paddingBox = goog.style.getPaddingBox(element);<tr><td><a id="l1505"></a><a href="#l1505">1505</a><td>      var borderBox = goog.style.getBorderBox(element);<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td>      style.pixelWidth = size.width - borderBox.left - paddingBox.left -<tr><td><a id="l1507"></a><a href="#l1507">1507</a><td>                         paddingBox.right - borderBox.right;<tr><td><a id="l1508"></a><a href="#l1508">1508</a><td>      style.pixelHeight = size.height - borderBox.top - paddingBox.top -<tr><td><a id="l1509"></a><a href="#l1509">1509</a><td>                          paddingBox.bottom - borderBox.bottom;<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td>    } else {<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td>      style.pixelWidth = size.width;<tr><td><a id="l1512"></a><a href="#l1512">1512</a><td>      style.pixelHeight = size.height;<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td>    }<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td>  } else {<tr><td><a id="l1515"></a><a href="#l1515">1515</a><td>    goog.style.setBoxSizingSize_(element, size, &#39;border-box&#39;);<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>  }<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td>};<tr><td><a id="l1518"></a><a href="#l1518">1518</a><td><tr><td><a id="l1519"></a><a href="#l1519">1519</a><td><tr><td><a id="l1520"></a><a href="#l1520">1520</a><td>/**<tr><td><a id="l1521"></a><a href="#l1521">1521</a><td> * Gets the content box size for an element.  This is potentially expensive in<tr><td><a id="l1522"></a><a href="#l1522">1522</a><td> * all browsers.<tr><td><a id="l1523"></a><a href="#l1523">1523</a><td> * @param {Element} element  The element to get the size for.<tr><td><a id="l1524"></a><a href="#l1524">1524</a><td> * @return {!goog.math.Size} The content box size.<tr><td><a id="l1525"></a><a href="#l1525">1525</a><td> */<tr><td><a id="l1526"></a><a href="#l1526">1526</a><td>goog.style.getContentBoxSize = function(element) {<tr><td><a id="l1527"></a><a href="#l1527">1527</a><td>  var doc = goog.dom.getOwnerDocument(element);<tr><td><a id="l1528"></a><a href="#l1528">1528</a><td>  var ieCurrentStyle = goog.userAgent.IE &amp;&amp; element.currentStyle;<tr><td><a id="l1529"></a><a href="#l1529">1529</a><td>  if (ieCurrentStyle &amp;&amp;<tr><td><a id="l1530"></a><a href="#l1530">1530</a><td>      goog.dom.getDomHelper(doc).isCss1CompatMode() &amp;&amp;<tr><td><a id="l1531"></a><a href="#l1531">1531</a><td>      ieCurrentStyle.width != &#39;auto&#39; &amp;&amp; ieCurrentStyle.height != &#39;auto&#39; &amp;&amp;<tr><td><a id="l1532"></a><a href="#l1532">1532</a><td>      !ieCurrentStyle.boxSizing) {<tr><td><a id="l1533"></a><a href="#l1533">1533</a><td>    // If IE in CSS1Compat mode than just use the width and height.<tr><td><a id="l1534"></a><a href="#l1534">1534</a><td>    // If we have a boxSizing then fall back on measuring the borders etc.<tr><td><a id="l1535"></a><a href="#l1535">1535</a><td>    var width = goog.style.getIePixelValue_(element, ieCurrentStyle.width,<tr><td><a id="l1536"></a><a href="#l1536">1536</a><td>                                            &#39;width&#39;, &#39;pixelWidth&#39;);<tr><td><a id="l1537"></a><a href="#l1537">1537</a><td>    var height = goog.style.getIePixelValue_(element, ieCurrentStyle.height,<tr><td><a id="l1538"></a><a href="#l1538">1538</a><td>                                             &#39;height&#39;, &#39;pixelHeight&#39;);<tr><td><a id="l1539"></a><a href="#l1539">1539</a><td>    return new goog.math.Size(width, height);<tr><td><a id="l1540"></a><a href="#l1540">1540</a><td>  } else {<tr><td><a id="l1541"></a><a href="#l1541">1541</a><td>    var borderBoxSize = goog.style.getBorderBoxSize(element);<tr><td><a id="l1542"></a><a href="#l1542">1542</a><td>    var paddingBox = goog.style.getPaddingBox(element);<tr><td><a id="l1543"></a><a href="#l1543">1543</a><td>    var borderBox = goog.style.getBorderBox(element);<tr><td><a id="l1544"></a><a href="#l1544">1544</a><td>    return new goog.math.Size(borderBoxSize.width -<tr><td><a id="l1545"></a><a href="#l1545">1545</a><td>                              borderBox.left - paddingBox.left -<tr><td><a id="l1546"></a><a href="#l1546">1546</a><td>                              paddingBox.right - borderBox.right,<tr><td><a id="l1547"></a><a href="#l1547">1547</a><td>                              borderBoxSize.height -<tr><td><a id="l1548"></a><a href="#l1548">1548</a><td>                              borderBox.top - paddingBox.top -<tr><td><a id="l1549"></a><a href="#l1549">1549</a><td>                              paddingBox.bottom - borderBox.bottom);<tr><td><a id="l1550"></a><a href="#l1550">1550</a><td>  }<tr><td><a id="l1551"></a><a href="#l1551">1551</a><td>};<tr><td><a id="l1552"></a><a href="#l1552">1552</a><td><tr><td><a id="l1553"></a><a href="#l1553">1553</a><td><tr><td><a id="l1554"></a><a href="#l1554">1554</a><td>/**<tr><td><a id="l1555"></a><a href="#l1555">1555</a><td> * Sets the content box size of an element. This is potentially expensive in IE<tr><td><a id="l1556"></a><a href="#l1556">1556</a><td> * if the document is BackCompat mode.<tr><td><a id="l1557"></a><a href="#l1557">1557</a><td> * @param {Element} element  The element to set the size on.<tr><td><a id="l1558"></a><a href="#l1558">1558</a><td> * @param {goog.math.Size} size  The new size.<tr><td><a id="l1559"></a><a href="#l1559">1559</a><td> */<tr><td><a id="l1560"></a><a href="#l1560">1560</a><td>goog.style.setContentBoxSize = function(element, size) {<tr><td><a id="l1561"></a><a href="#l1561">1561</a><td>  var doc = goog.dom.getOwnerDocument(element);<tr><td><a id="l1562"></a><a href="#l1562">1562</a><td>  var isCss1CompatMode = goog.dom.getDomHelper(doc).isCss1CompatMode();<tr><td><a id="l1563"></a><a href="#l1563">1563</a><td>  if (goog.userAgent.IE &amp;&amp;<tr><td><a id="l1564"></a><a href="#l1564">1564</a><td>      !goog.userAgent.isVersionOrHigher(&#39;10&#39;) &amp;&amp;<tr><td><a id="l1565"></a><a href="#l1565">1565</a><td>      (!isCss1CompatMode || !goog.userAgent.isVersionOrHigher(&#39;8&#39;))) {<tr><td><a id="l1566"></a><a href="#l1566">1566</a><td>    var style = element.style;<tr><td><a id="l1567"></a><a href="#l1567">1567</a><td>    if (isCss1CompatMode) {<tr><td><a id="l1568"></a><a href="#l1568">1568</a><td>      style.pixelWidth = size.width;<tr><td><a id="l1569"></a><a href="#l1569">1569</a><td>      style.pixelHeight = size.height;<tr><td><a id="l1570"></a><a href="#l1570">1570</a><td>    } else {<tr><td><a id="l1571"></a><a href="#l1571">1571</a><td>      var paddingBox = goog.style.getPaddingBox(element);<tr><td><a id="l1572"></a><a href="#l1572">1572</a><td>      var borderBox = goog.style.getBorderBox(element);<tr><td><a id="l1573"></a><a href="#l1573">1573</a><td>      style.pixelWidth = size.width + borderBox.left + paddingBox.left +<tr><td><a id="l1574"></a><a href="#l1574">1574</a><td>                         paddingBox.right + borderBox.right;<tr><td><a id="l1575"></a><a href="#l1575">1575</a><td>      style.pixelHeight = size.height + borderBox.top + paddingBox.top +<tr><td><a id="l1576"></a><a href="#l1576">1576</a><td>                          paddingBox.bottom + borderBox.bottom;<tr><td><a id="l1577"></a><a href="#l1577">1577</a><td>    }<tr><td><a id="l1578"></a><a href="#l1578">1578</a><td>  } else {<tr><td><a id="l1579"></a><a href="#l1579">1579</a><td>    goog.style.setBoxSizingSize_(element, size, &#39;content-box&#39;);<tr><td><a id="l1580"></a><a href="#l1580">1580</a><td>  }<tr><td><a id="l1581"></a><a href="#l1581">1581</a><td>};<tr><td><a id="l1582"></a><a href="#l1582">1582</a><td><tr><td><a id="l1583"></a><a href="#l1583">1583</a><td><tr><td><a id="l1584"></a><a href="#l1584">1584</a><td>/**<tr><td><a id="l1585"></a><a href="#l1585">1585</a><td> * Helper function that sets the box sizing as well as the width and height<tr><td><a id="l1586"></a><a href="#l1586">1586</a><td> * @param {Element} element  The element to set the size on.<tr><td><a id="l1587"></a><a href="#l1587">1587</a><td> * @param {goog.math.Size} size  The new size to set.<tr><td><a id="l1588"></a><a href="#l1588">1588</a><td> * @param {string} boxSizing  The box-sizing value.<tr><td><a id="l1589"></a><a href="#l1589">1589</a><td> * @private<tr><td><a id="l1590"></a><a href="#l1590">1590</a><td> */<tr><td><a id="l1591"></a><a href="#l1591">1591</a><td>goog.style.setBoxSizingSize_ = function(element, size, boxSizing) {<tr><td><a id="l1592"></a><a href="#l1592">1592</a><td>  var style = element.style;<tr><td><a id="l1593"></a><a href="#l1593">1593</a><td>  if (goog.userAgent.GECKO) {<tr><td><a id="l1594"></a><a href="#l1594">1594</a><td>    style.MozBoxSizing = boxSizing;<tr><td><a id="l1595"></a><a href="#l1595">1595</a><td>  } else if (goog.userAgent.WEBKIT) {<tr><td><a id="l1596"></a><a href="#l1596">1596</a><td>    style.WebkitBoxSizing = boxSizing;<tr><td><a id="l1597"></a><a href="#l1597">1597</a><td>  } else {<tr><td><a id="l1598"></a><a href="#l1598">1598</a><td>    // Includes IE8 and Opera 9.50+<tr><td><a id="l1599"></a><a href="#l1599">1599</a><td>    style.boxSizing = boxSizing;<tr><td><a id="l1600"></a><a href="#l1600">1600</a><td>  }<tr><td><a id="l1601"></a><a href="#l1601">1601</a><td><tr><td><a id="l1602"></a><a href="#l1602">1602</a><td>  // Setting this to a negative value will throw an exception on IE<tr><td><a id="l1603"></a><a href="#l1603">1603</a><td>  // (and doesn&#39;t do anything different than setting it to 0).<tr><td><a id="l1604"></a><a href="#l1604">1604</a><td>  style.width = Math.max(size.width, 0) + &#39;px&#39;;<tr><td><a id="l1605"></a><a href="#l1605">1605</a><td>  style.height = Math.max(size.height, 0) + &#39;px&#39;;<tr><td><a id="l1606"></a><a href="#l1606">1606</a><td>};<tr><td><a id="l1607"></a><a href="#l1607">1607</a><td><tr><td><a id="l1608"></a><a href="#l1608">1608</a><td><tr><td><a id="l1609"></a><a href="#l1609">1609</a><td>/**<tr><td><a id="l1610"></a><a href="#l1610">1610</a><td> * IE specific function that converts a non pixel unit to pixels.<tr><td><a id="l1611"></a><a href="#l1611">1611</a><td> * @param {Element} element  The element to convert the value for.<tr><td><a id="l1612"></a><a href="#l1612">1612</a><td> * @param {string} value  The current value as a string. The value must not be<tr><td><a id="l1613"></a><a href="#l1613">1613</a><td> *     &#39;&#39;.<tr><td><a id="l1614"></a><a href="#l1614">1614</a><td> * @param {string} name  The CSS property name to use for the converstion. This<tr><td><a id="l1615"></a><a href="#l1615">1615</a><td> *     should be &#39;left&#39;, &#39;top&#39;, &#39;width&#39; or &#39;height&#39;.<tr><td><a id="l1616"></a><a href="#l1616">1616</a><td> * @param {string} pixelName  The CSS pixel property name to use to get the<tr><td><a id="l1617"></a><a href="#l1617">1617</a><td> *     value in pixels.<tr><td><a id="l1618"></a><a href="#l1618">1618</a><td> * @return {number} The value in pixels.<tr><td><a id="l1619"></a><a href="#l1619">1619</a><td> * @private<tr><td><a id="l1620"></a><a href="#l1620">1620</a><td> */<tr><td><a id="l1621"></a><a href="#l1621">1621</a><td>goog.style.getIePixelValue_ = function(element, value, name, pixelName) {<tr><td><a id="l1622"></a><a href="#l1622">1622</a><td>  // Try if we already have a pixel value. IE does not do half pixels so we<tr><td><a id="l1623"></a><a href="#l1623">1623</a><td>  // only check if it matches a number followed by &#39;px&#39;.<tr><td><a id="l1624"></a><a href="#l1624">1624</a><td>  if (/^\d+px?$/.test(value)) {<tr><td><a id="l1625"></a><a href="#l1625">1625</a><td>    return parseInt(value, 10);<tr><td><a id="l1626"></a><a href="#l1626">1626</a><td>  } else {<tr><td><a id="l1627"></a><a href="#l1627">1627</a><td>    var oldStyleValue = element.style[name];<tr><td><a id="l1628"></a><a href="#l1628">1628</a><td>    var oldRuntimeValue = element.runtimeStyle[name];<tr><td><a id="l1629"></a><a href="#l1629">1629</a><td>    // set runtime style to prevent changes<tr><td><a id="l1630"></a><a href="#l1630">1630</a><td>    element.runtimeStyle[name] = element.currentStyle[name];<tr><td><a id="l1631"></a><a href="#l1631">1631</a><td>    element.style[name] = value;<tr><td><a id="l1632"></a><a href="#l1632">1632</a><td>    var pixelValue = element.style[pixelName];<tr><td><a id="l1633"></a><a href="#l1633">1633</a><td>    // restore<tr><td><a id="l1634"></a><a href="#l1634">1634</a><td>    element.style[name] = oldStyleValue;<tr><td><a id="l1635"></a><a href="#l1635">1635</a><td>    element.runtimeStyle[name] = oldRuntimeValue;<tr><td><a id="l1636"></a><a href="#l1636">1636</a><td>    return pixelValue;<tr><td><a id="l1637"></a><a href="#l1637">1637</a><td>  }<tr><td><a id="l1638"></a><a href="#l1638">1638</a><td>};<tr><td><a id="l1639"></a><a href="#l1639">1639</a><td><tr><td><a id="l1640"></a><a href="#l1640">1640</a><td><tr><td><a id="l1641"></a><a href="#l1641">1641</a><td>/**<tr><td><a id="l1642"></a><a href="#l1642">1642</a><td> * Helper function for getting the pixel padding or margin for IE.<tr><td><a id="l1643"></a><a href="#l1643">1643</a><td> * @param {Element} element  The element to get the padding for.<tr><td><a id="l1644"></a><a href="#l1644">1644</a><td> * @param {string} propName  The property name.<tr><td><a id="l1645"></a><a href="#l1645">1645</a><td> * @return {number} The pixel padding.<tr><td><a id="l1646"></a><a href="#l1646">1646</a><td> * @private<tr><td><a id="l1647"></a><a href="#l1647">1647</a><td> */<tr><td><a id="l1648"></a><a href="#l1648">1648</a><td>goog.style.getIePixelDistance_ = function(element, propName) {<tr><td><a id="l1649"></a><a href="#l1649">1649</a><td>  var value = goog.style.getCascadedStyle(element, propName);<tr><td><a id="l1650"></a><a href="#l1650">1650</a><td>  return value ?<tr><td><a id="l1651"></a><a href="#l1651">1651</a><td>      goog.style.getIePixelValue_(element, value, &#39;left&#39;, &#39;pixelLeft&#39;) : 0;<tr><td><a id="l1652"></a><a href="#l1652">1652</a><td>};<tr><td><a id="l1653"></a><a href="#l1653">1653</a><td><tr><td><a id="l1654"></a><a href="#l1654">1654</a><td><tr><td><a id="l1655"></a><a href="#l1655">1655</a><td>/**<tr><td><a id="l1656"></a><a href="#l1656">1656</a><td> * Gets the computed paddings or margins (on all sides) in pixels.<tr><td><a id="l1657"></a><a href="#l1657">1657</a><td> * @param {Element} element  The element to get the padding for.<tr><td><a id="l1658"></a><a href="#l1658">1658</a><td> * @param {string} stylePrefix  Pass &#39;padding&#39; to retrieve the padding box,<tr><td><a id="l1659"></a><a href="#l1659">1659</a><td> *     or &#39;margin&#39; to retrieve the margin box.<tr><td><a id="l1660"></a><a href="#l1660">1660</a><td> * @return {!goog.math.Box} The computed paddings or margins.<tr><td><a id="l1661"></a><a href="#l1661">1661</a><td> * @private<tr><td><a id="l1662"></a><a href="#l1662">1662</a><td> */<tr><td><a id="l1663"></a><a href="#l1663">1663</a><td>goog.style.getBox_ = function(element, stylePrefix) {<tr><td><a id="l1664"></a><a href="#l1664">1664</a><td>  if (goog.userAgent.IE) {<tr><td><a id="l1665"></a><a href="#l1665">1665</a><td>    var left = goog.style.getIePixelDistance_(element, stylePrefix + &#39;Left&#39;);<tr><td><a id="l1666"></a><a href="#l1666">1666</a><td>    var right = goog.style.getIePixelDistance_(element, stylePrefix + &#39;Right&#39;);<tr><td><a id="l1667"></a><a href="#l1667">1667</a><td>    var top = goog.style.getIePixelDistance_(element, stylePrefix + &#39;Top&#39;);<tr><td><a id="l1668"></a><a href="#l1668">1668</a><td>    var bottom = goog.style.getIePixelDistance_(<tr><td><a id="l1669"></a><a href="#l1669">1669</a><td>        element, stylePrefix + &#39;Bottom&#39;);<tr><td><a id="l1670"></a><a href="#l1670">1670</a><td>    return new goog.math.Box(top, right, bottom, left);<tr><td><a id="l1671"></a><a href="#l1671">1671</a><td>  } else {<tr><td><a id="l1672"></a><a href="#l1672">1672</a><td>    // On non-IE browsers, getComputedStyle is always non-null.<tr><td><a id="l1673"></a><a href="#l1673">1673</a><td>    var left = goog.style.getComputedStyle(element, stylePrefix + &#39;Left&#39;);<tr><td><a id="l1674"></a><a href="#l1674">1674</a><td>    var right = goog.style.getComputedStyle(element, stylePrefix + &#39;Right&#39;);<tr><td><a id="l1675"></a><a href="#l1675">1675</a><td>    var top = goog.style.getComputedStyle(element, stylePrefix + &#39;Top&#39;);<tr><td><a id="l1676"></a><a href="#l1676">1676</a><td>    var bottom = goog.style.getComputedStyle(element, stylePrefix + &#39;Bottom&#39;);<tr><td><a id="l1677"></a><a href="#l1677">1677</a><td><tr><td><a id="l1678"></a><a href="#l1678">1678</a><td>    // NOTE(arv): Gecko can return floating point numbers for the computed<tr><td><a id="l1679"></a><a href="#l1679">1679</a><td>    // style values.<tr><td><a id="l1680"></a><a href="#l1680">1680</a><td>    return new goog.math.Box(parseFloat(top),<tr><td><a id="l1681"></a><a href="#l1681">1681</a><td>                             parseFloat(right),<tr><td><a id="l1682"></a><a href="#l1682">1682</a><td>                             parseFloat(bottom),<tr><td><a id="l1683"></a><a href="#l1683">1683</a><td>                             parseFloat(left));<tr><td><a id="l1684"></a><a href="#l1684">1684</a><td>  }<tr><td><a id="l1685"></a><a href="#l1685">1685</a><td>};<tr><td><a id="l1686"></a><a href="#l1686">1686</a><td><tr><td><a id="l1687"></a><a href="#l1687">1687</a><td><tr><td><a id="l1688"></a><a href="#l1688">1688</a><td>/**<tr><td><a id="l1689"></a><a href="#l1689">1689</a><td> * Gets the computed paddings (on all sides) in pixels.<tr><td><a id="l1690"></a><a href="#l1690">1690</a><td> * @param {Element} element  The element to get the padding for.<tr><td><a id="l1691"></a><a href="#l1691">1691</a><td> * @return {!goog.math.Box} The computed paddings.<tr><td><a id="l1692"></a><a href="#l1692">1692</a><td> */<tr><td><a id="l1693"></a><a href="#l1693">1693</a><td>goog.style.getPaddingBox = function(element) {<tr><td><a id="l1694"></a><a href="#l1694">1694</a><td>  return goog.style.getBox_(element, &#39;padding&#39;);<tr><td><a id="l1695"></a><a href="#l1695">1695</a><td>};<tr><td><a id="l1696"></a><a href="#l1696">1696</a><td><tr><td><a id="l1697"></a><a href="#l1697">1697</a><td><tr><td><a id="l1698"></a><a href="#l1698">1698</a><td>/**<tr><td><a id="l1699"></a><a href="#l1699">1699</a><td> * Gets the computed margins (on all sides) in pixels.<tr><td><a id="l1700"></a><a href="#l1700">1700</a><td> * @param {Element} element  The element to get the margins for.<tr><td><a id="l1701"></a><a href="#l1701">1701</a><td> * @return {!goog.math.Box} The computed margins.<tr><td><a id="l1702"></a><a href="#l1702">1702</a><td> */<tr><td><a id="l1703"></a><a href="#l1703">1703</a><td>goog.style.getMarginBox = function(element) {<tr><td><a id="l1704"></a><a href="#l1704">1704</a><td>  return goog.style.getBox_(element, &#39;margin&#39;);<tr><td><a id="l1705"></a><a href="#l1705">1705</a><td>};<tr><td><a id="l1706"></a><a href="#l1706">1706</a><td><tr><td><a id="l1707"></a><a href="#l1707">1707</a><td><tr><td><a id="l1708"></a><a href="#l1708">1708</a><td>/**<tr><td><a id="l1709"></a><a href="#l1709">1709</a><td> * A map used to map the border width keywords to a pixel width.<tr><td><a id="l1710"></a><a href="#l1710">1710</a><td> * @type {Object}<tr><td><a id="l1711"></a><a href="#l1711">1711</a><td> * @private<tr><td><a id="l1712"></a><a href="#l1712">1712</a><td> */<tr><td><a id="l1713"></a><a href="#l1713">1713</a><td>goog.style.ieBorderWidthKeywords_ = {<tr><td><a id="l1714"></a><a href="#l1714">1714</a><td>  &#39;thin&#39;: 2,<tr><td><a id="l1715"></a><a href="#l1715">1715</a><td>  &#39;medium&#39;: 4,<tr><td><a id="l1716"></a><a href="#l1716">1716</a><td>  &#39;thick&#39;: 6<tr><td><a id="l1717"></a><a href="#l1717">1717</a><td>};<tr><td><a id="l1718"></a><a href="#l1718">1718</a><td><tr><td><a id="l1719"></a><a href="#l1719">1719</a><td><tr><td><a id="l1720"></a><a href="#l1720">1720</a><td>/**<tr><td><a id="l1721"></a><a href="#l1721">1721</a><td> * Helper function for IE to get the pixel border.<tr><td><a id="l1722"></a><a href="#l1722">1722</a><td> * @param {Element} element  The element to get the pixel border for.<tr><td><a id="l1723"></a><a href="#l1723">1723</a><td> * @param {string} prop  The part of the property name.<tr><td><a id="l1724"></a><a href="#l1724">1724</a><td> * @return {number} The value in pixels.<tr><td><a id="l1725"></a><a href="#l1725">1725</a><td> * @private<tr><td><a id="l1726"></a><a href="#l1726">1726</a><td> */<tr><td><a id="l1727"></a><a href="#l1727">1727</a><td>goog.style.getIePixelBorder_ = function(element, prop) {<tr><td><a id="l1728"></a><a href="#l1728">1728</a><td>  if (goog.style.getCascadedStyle(element, prop + &#39;Style&#39;) == &#39;none&#39;) {<tr><td><a id="l1729"></a><a href="#l1729">1729</a><td>    return 0;<tr><td><a id="l1730"></a><a href="#l1730">1730</a><td>  }<tr><td><a id="l1731"></a><a href="#l1731">1731</a><td>  var width = goog.style.getCascadedStyle(element, prop + &#39;Width&#39;);<tr><td><a id="l1732"></a><a href="#l1732">1732</a><td>  if (width in goog.style.ieBorderWidthKeywords_) {<tr><td><a id="l1733"></a><a href="#l1733">1733</a><td>    return goog.style.ieBorderWidthKeywords_[width];<tr><td><a id="l1734"></a><a href="#l1734">1734</a><td>  }<tr><td><a id="l1735"></a><a href="#l1735">1735</a><td>  return goog.style.getIePixelValue_(element, width, &#39;left&#39;, &#39;pixelLeft&#39;);<tr><td><a id="l1736"></a><a href="#l1736">1736</a><td>};<tr><td><a id="l1737"></a><a href="#l1737">1737</a><td><tr><td><a id="l1738"></a><a href="#l1738">1738</a><td><tr><td><a id="l1739"></a><a href="#l1739">1739</a><td>/**<tr><td><a id="l1740"></a><a href="#l1740">1740</a><td> * Gets the computed border widths (on all sides) in pixels<tr><td><a id="l1741"></a><a href="#l1741">1741</a><td> * @param {Element} element  The element to get the border widths for.<tr><td><a id="l1742"></a><a href="#l1742">1742</a><td> * @return {!goog.math.Box} The computed border widths.<tr><td><a id="l1743"></a><a href="#l1743">1743</a><td> */<tr><td><a id="l1744"></a><a href="#l1744">1744</a><td>goog.style.getBorderBox = function(element) {<tr><td><a id="l1745"></a><a href="#l1745">1745</a><td>  if (goog.userAgent.IE &amp;&amp; !goog.userAgent.isDocumentModeOrHigher(9)) {<tr><td><a id="l1746"></a><a href="#l1746">1746</a><td>    var left = goog.style.getIePixelBorder_(element, &#39;borderLeft&#39;);<tr><td><a id="l1747"></a><a href="#l1747">1747</a><td>    var right = goog.style.getIePixelBorder_(element, &#39;borderRight&#39;);<tr><td><a id="l1748"></a><a href="#l1748">1748</a><td>    var top = goog.style.getIePixelBorder_(element, &#39;borderTop&#39;);<tr><td><a id="l1749"></a><a href="#l1749">1749</a><td>    var bottom = goog.style.getIePixelBorder_(element, &#39;borderBottom&#39;);<tr><td><a id="l1750"></a><a href="#l1750">1750</a><td>    return new goog.math.Box(top, right, bottom, left);<tr><td><a id="l1751"></a><a href="#l1751">1751</a><td>  } else {<tr><td><a id="l1752"></a><a href="#l1752">1752</a><td>    // On non-IE browsers, getComputedStyle is always non-null.<tr><td><a id="l1753"></a><a href="#l1753">1753</a><td>    var left = goog.style.getComputedStyle(element, &#39;borderLeftWidth&#39;);<tr><td><a id="l1754"></a><a href="#l1754">1754</a><td>    var right = goog.style.getComputedStyle(element, &#39;borderRightWidth&#39;);<tr><td><a id="l1755"></a><a href="#l1755">1755</a><td>    var top = goog.style.getComputedStyle(element, &#39;borderTopWidth&#39;);<tr><td><a id="l1756"></a><a href="#l1756">1756</a><td>    var bottom = goog.style.getComputedStyle(element, &#39;borderBottomWidth&#39;);<tr><td><a id="l1757"></a><a href="#l1757">1757</a><td><tr><td><a id="l1758"></a><a href="#l1758">1758</a><td>    return new goog.math.Box(parseFloat(top),<tr><td><a id="l1759"></a><a href="#l1759">1759</a><td>                             parseFloat(right),<tr><td><a id="l1760"></a><a href="#l1760">1760</a><td>                             parseFloat(bottom),<tr><td><a id="l1761"></a><a href="#l1761">1761</a><td>                             parseFloat(left));<tr><td><a id="l1762"></a><a href="#l1762">1762</a><td>  }<tr><td><a id="l1763"></a><a href="#l1763">1763</a><td>};<tr><td><a id="l1764"></a><a href="#l1764">1764</a><td><tr><td><a id="l1765"></a><a href="#l1765">1765</a><td><tr><td><a id="l1766"></a><a href="#l1766">1766</a><td>/**<tr><td><a id="l1767"></a><a href="#l1767">1767</a><td> * Returns the font face applied to a given node. Opera and IE should return<tr><td><a id="l1768"></a><a href="#l1768">1768</a><td> * the font actually displayed. Firefox returns the author&#39;s most-preferred<tr><td><a id="l1769"></a><a href="#l1769">1769</a><td> * font (whether the browser is capable of displaying it or not.)<tr><td><a id="l1770"></a><a href="#l1770">1770</a><td> * @param {Element} el  The element whose font family is returned.<tr><td><a id="l1771"></a><a href="#l1771">1771</a><td> * @return {string} The font family applied to el.<tr><td><a id="l1772"></a><a href="#l1772">1772</a><td> */<tr><td><a id="l1773"></a><a href="#l1773">1773</a><td>goog.style.getFontFamily = function(el) {<tr><td><a id="l1774"></a><a href="#l1774">1774</a><td>  var doc = goog.dom.getOwnerDocument(el);<tr><td><a id="l1775"></a><a href="#l1775">1775</a><td>  var font = &#39;&#39;;<tr><td><a id="l1776"></a><a href="#l1776">1776</a><td>  // The moveToElementText method from the TextRange only works if the element<tr><td><a id="l1777"></a><a href="#l1777">1777</a><td>  // is attached to the owner document.<tr><td><a id="l1778"></a><a href="#l1778">1778</a><td>  if (doc.body.createTextRange &amp;&amp; goog.dom.contains(doc, el)) {<tr><td><a id="l1779"></a><a href="#l1779">1779</a><td>    var range = doc.body.createTextRange();<tr><td><a id="l1780"></a><a href="#l1780">1780</a><td>    range.moveToElementText(el);<tr><td><a id="l1781"></a><a href="#l1781">1781</a><td>    /** @preserveTry */<tr><td><a id="l1782"></a><a href="#l1782">1782</a><td>    try {<tr><td><a id="l1783"></a><a href="#l1783">1783</a><td>      font = range.queryCommandValue(&#39;FontName&#39;);<tr><td><a id="l1784"></a><a href="#l1784">1784</a><td>    } catch (e) {<tr><td><a id="l1785"></a><a href="#l1785">1785</a><td>      // This is a workaround for a awkward exception.<tr><td><a id="l1786"></a><a href="#l1786">1786</a><td>      // On some IE, there is an exception coming from it.<tr><td><a id="l1787"></a><a href="#l1787">1787</a><td>      // The error description from this exception is:<tr><td><a id="l1788"></a><a href="#l1788">1788</a><td>      // This window has already been registered as a drop target<tr><td><a id="l1789"></a><a href="#l1789">1789</a><td>      // This is bogus description, likely due to a bug in ie.<tr><td><a id="l1790"></a><a href="#l1790">1790</a><td>      font = &#39;&#39;;<tr><td><a id="l1791"></a><a href="#l1791">1791</a><td>    }<tr><td><a id="l1792"></a><a href="#l1792">1792</a><td>  }<tr><td><a id="l1793"></a><a href="#l1793">1793</a><td>  if (!font) {<tr><td><a id="l1794"></a><a href="#l1794">1794</a><td>    // Note if for some reason IE can&#39;t derive FontName with a TextRange, we<tr><td><a id="l1795"></a><a href="#l1795">1795</a><td>    // fallback to using currentStyle<tr><td><a id="l1796"></a><a href="#l1796">1796</a><td>    font = goog.style.getStyle_(el, &#39;fontFamily&#39;);<tr><td><a id="l1797"></a><a href="#l1797">1797</a><td>  }<tr><td><a id="l1798"></a><a href="#l1798">1798</a><td><tr><td><a id="l1799"></a><a href="#l1799">1799</a><td>  // Firefox returns the applied font-family string (author&#39;s list of<tr><td><a id="l1800"></a><a href="#l1800">1800</a><td>  // preferred fonts.) We want to return the most-preferred font, in lieu of<tr><td><a id="l1801"></a><a href="#l1801">1801</a><td>  // the *actually* applied font.<tr><td><a id="l1802"></a><a href="#l1802">1802</a><td>  var fontsArray = font.split(&#39;,&#39;);<tr><td><a id="l1803"></a><a href="#l1803">1803</a><td>  if (fontsArray.length &gt; 1) font = fontsArray[0];<tr><td><a id="l1804"></a><a href="#l1804">1804</a><td><tr><td><a id="l1805"></a><a href="#l1805">1805</a><td>  // Sanitize for x-browser consistency:<tr><td><a id="l1806"></a><a href="#l1806">1806</a><td>  // Strip quotes because browsers aren&#39;t consistent with how they&#39;re<tr><td><a id="l1807"></a><a href="#l1807">1807</a><td>  // applied; Opera always encloses, Firefox sometimes, and IE never.<tr><td><a id="l1808"></a><a href="#l1808">1808</a><td>  return goog.string.stripQuotes(font, &#39;&quot;\&#39;&#39;);<tr><td><a id="l1809"></a><a href="#l1809">1809</a><td>};<tr><td><a id="l1810"></a><a href="#l1810">1810</a><td><tr><td><a id="l1811"></a><a href="#l1811">1811</a><td><tr><td><a id="l1812"></a><a href="#l1812">1812</a><td>/**<tr><td><a id="l1813"></a><a href="#l1813">1813</a><td> * Regular expression used for getLengthUnits.<tr><td><a id="l1814"></a><a href="#l1814">1814</a><td> * @type {RegExp}<tr><td><a id="l1815"></a><a href="#l1815">1815</a><td> * @private<tr><td><a id="l1816"></a><a href="#l1816">1816</a><td> */<tr><td><a id="l1817"></a><a href="#l1817">1817</a><td>goog.style.lengthUnitRegex_ = /[^\d]+$/;<tr><td><a id="l1818"></a><a href="#l1818">1818</a><td><tr><td><a id="l1819"></a><a href="#l1819">1819</a><td><tr><td><a id="l1820"></a><a href="#l1820">1820</a><td>/**<tr><td><a id="l1821"></a><a href="#l1821">1821</a><td> * Returns the units used for a CSS length measurement.<tr><td><a id="l1822"></a><a href="#l1822">1822</a><td> * @param {string} value  A CSS length quantity.<tr><td><a id="l1823"></a><a href="#l1823">1823</a><td> * @return {?string} The units of measurement.<tr><td><a id="l1824"></a><a href="#l1824">1824</a><td> */<tr><td><a id="l1825"></a><a href="#l1825">1825</a><td>goog.style.getLengthUnits = function(value) {<tr><td><a id="l1826"></a><a href="#l1826">1826</a><td>  var units = value.match(goog.style.lengthUnitRegex_);<tr><td><a id="l1827"></a><a href="#l1827">1827</a><td>  return units &amp;&amp; units[0] || null;<tr><td><a id="l1828"></a><a href="#l1828">1828</a><td>};<tr><td><a id="l1829"></a><a href="#l1829">1829</a><td><tr><td><a id="l1830"></a><a href="#l1830">1830</a><td><tr><td><a id="l1831"></a><a href="#l1831">1831</a><td>/**<tr><td><a id="l1832"></a><a href="#l1832">1832</a><td> * Map of absolute CSS length units<tr><td><a id="l1833"></a><a href="#l1833">1833</a><td> * @type {Object}<tr><td><a id="l1834"></a><a href="#l1834">1834</a><td> * @private<tr><td><a id="l1835"></a><a href="#l1835">1835</a><td> */<tr><td><a id="l1836"></a><a href="#l1836">1836</a><td>goog.style.ABSOLUTE_CSS_LENGTH_UNITS_ = {<tr><td><a id="l1837"></a><a href="#l1837">1837</a><td>  &#39;cm&#39; : 1,<tr><td><a id="l1838"></a><a href="#l1838">1838</a><td>  &#39;in&#39; : 1,<tr><td><a id="l1839"></a><a href="#l1839">1839</a><td>  &#39;mm&#39; : 1,<tr><td><a id="l1840"></a><a href="#l1840">1840</a><td>  &#39;pc&#39; : 1,<tr><td><a id="l1841"></a><a href="#l1841">1841</a><td>  &#39;pt&#39; : 1<tr><td><a id="l1842"></a><a href="#l1842">1842</a><td>};<tr><td><a id="l1843"></a><a href="#l1843">1843</a><td><tr><td><a id="l1844"></a><a href="#l1844">1844</a><td><tr><td><a id="l1845"></a><a href="#l1845">1845</a><td>/**<tr><td><a id="l1846"></a><a href="#l1846">1846</a><td> * Map of relative CSS length units that can be accurately converted to px<tr><td><a id="l1847"></a><a href="#l1847">1847</a><td> * font-size values using getIePixelValue_. Only units that are defined in<tr><td><a id="l1848"></a><a href="#l1848">1848</a><td> * relation to a font size are convertible (%, small, etc. are not).<tr><td><a id="l1849"></a><a href="#l1849">1849</a><td> * @type {Object}<tr><td><a id="l1850"></a><a href="#l1850">1850</a><td> * @private<tr><td><a id="l1851"></a><a href="#l1851">1851</a><td> */<tr><td><a id="l1852"></a><a href="#l1852">1852</a><td>goog.style.CONVERTIBLE_RELATIVE_CSS_UNITS_ = {<tr><td><a id="l1853"></a><a href="#l1853">1853</a><td>  &#39;em&#39; : 1,<tr><td><a id="l1854"></a><a href="#l1854">1854</a><td>  &#39;ex&#39; : 1<tr><td><a id="l1855"></a><a href="#l1855">1855</a><td>};<tr><td><a id="l1856"></a><a href="#l1856">1856</a><td><tr><td><a id="l1857"></a><a href="#l1857">1857</a><td><tr><td><a id="l1858"></a><a href="#l1858">1858</a><td>/**<tr><td><a id="l1859"></a><a href="#l1859">1859</a><td> * Returns the font size, in pixels, of text in an element.<tr><td><a id="l1860"></a><a href="#l1860">1860</a><td> * @param {Element} el  The element whose font size is returned.<tr><td><a id="l1861"></a><a href="#l1861">1861</a><td> * @return {number} The font size (in pixels).<tr><td><a id="l1862"></a><a href="#l1862">1862</a><td> */<tr><td><a id="l1863"></a><a href="#l1863">1863</a><td>goog.style.getFontSize = function(el) {<tr><td><a id="l1864"></a><a href="#l1864">1864</a><td>  var fontSize = goog.style.getStyle_(el, &#39;fontSize&#39;);<tr><td><a id="l1865"></a><a href="#l1865">1865</a><td>  var sizeUnits = goog.style.getLengthUnits(fontSize);<tr><td><a id="l1866"></a><a href="#l1866">1866</a><td>  if (fontSize &amp;&amp; &#39;px&#39; == sizeUnits) {<tr><td><a id="l1867"></a><a href="#l1867">1867</a><td>    // NOTE(user): This could be parseFloat instead, but IE doesn&#39;t return<tr><td><a id="l1868"></a><a href="#l1868">1868</a><td>    // decimal fractions in getStyle_ and Firefox reports the fractions, but<tr><td><a id="l1869"></a><a href="#l1869">1869</a><td>    // ignores them when rendering. Interestingly enough, when we force the<tr><td><a id="l1870"></a><a href="#l1870">1870</a><td>    // issue and size something to e.g., 50% of 25px, the browsers round in<tr><td><a id="l1871"></a><a href="#l1871">1871</a><td>    // opposite directions with Firefox reporting 12px and IE 13px. I punt.<tr><td><a id="l1872"></a><a href="#l1872">1872</a><td>    return parseInt(fontSize, 10);<tr><td><a id="l1873"></a><a href="#l1873">1873</a><td>  }<tr><td><a id="l1874"></a><a href="#l1874">1874</a><td><tr><td><a id="l1875"></a><a href="#l1875">1875</a><td>  // In IE, we can convert absolute length units to a px value using<tr><td><a id="l1876"></a><a href="#l1876">1876</a><td>  // goog.style.getIePixelValue_. Units defined in relation to a font size<tr><td><a id="l1877"></a><a href="#l1877">1877</a><td>  // (em, ex) are applied relative to the element&#39;s parentNode and can also<tr><td><a id="l1878"></a><a href="#l1878">1878</a><td>  // be converted.<tr><td><a id="l1879"></a><a href="#l1879">1879</a><td>  if (goog.userAgent.IE) {<tr><td><a id="l1880"></a><a href="#l1880">1880</a><td>    if (sizeUnits in goog.style.ABSOLUTE_CSS_LENGTH_UNITS_) {<tr><td><a id="l1881"></a><a href="#l1881">1881</a><td>      return goog.style.getIePixelValue_(el,<tr><td><a id="l1882"></a><a href="#l1882">1882</a><td>                                         fontSize,<tr><td><a id="l1883"></a><a href="#l1883">1883</a><td>                                         &#39;left&#39;,<tr><td><a id="l1884"></a><a href="#l1884">1884</a><td>                                         &#39;pixelLeft&#39;);<tr><td><a id="l1885"></a><a href="#l1885">1885</a><td>    } else if (el.parentNode &amp;&amp;<tr><td><a id="l1886"></a><a href="#l1886">1886</a><td>               el.parentNode.nodeType == goog.dom.NodeType.ELEMENT &amp;&amp;<tr><td><a id="l1887"></a><a href="#l1887">1887</a><td>               sizeUnits in goog.style.CONVERTIBLE_RELATIVE_CSS_UNITS_) {<tr><td><a id="l1888"></a><a href="#l1888">1888</a><td>      // Check the parent size - if it is the same it means the relative size<tr><td><a id="l1889"></a><a href="#l1889">1889</a><td>      // value is inherited and we therefore don&#39;t want to count it twice.  If<tr><td><a id="l1890"></a><a href="#l1890">1890</a><td>      // it is different, this element either has explicit style or has a CSS<tr><td><a id="l1891"></a><a href="#l1891">1891</a><td>      // rule applying to it.<tr><td><a id="l1892"></a><a href="#l1892">1892</a><td>      var parentElement = /** @type {!Element} */ (el.parentNode);<tr><td><a id="l1893"></a><a href="#l1893">1893</a><td>      var parentSize = goog.style.getStyle_(parentElement, &#39;fontSize&#39;);<tr><td><a id="l1894"></a><a href="#l1894">1894</a><td>      return goog.style.getIePixelValue_(parentElement,<tr><td><a id="l1895"></a><a href="#l1895">1895</a><td>                                         fontSize == parentSize ?<tr><td><a id="l1896"></a><a href="#l1896">1896</a><td>                                             &#39;1em&#39; : fontSize,<tr><td><a id="l1897"></a><a href="#l1897">1897</a><td>                                         &#39;left&#39;,<tr><td><a id="l1898"></a><a href="#l1898">1898</a><td>                                         &#39;pixelLeft&#39;);<tr><td><a id="l1899"></a><a href="#l1899">1899</a><td>    }<tr><td><a id="l1900"></a><a href="#l1900">1900</a><td>  }<tr><td><a id="l1901"></a><a href="#l1901">1901</a><td><tr><td><a id="l1902"></a><a href="#l1902">1902</a><td>  // Sometimes we can&#39;t cleanly find the font size (some units relative to a<tr><td><a id="l1903"></a><a href="#l1903">1903</a><td>  // node&#39;s parent&#39;s font size are difficult: %, smaller et al), so we create<tr><td><a id="l1904"></a><a href="#l1904">1904</a><td>  // an invisible, absolutely-positioned span sized to be the height of an &#39;M&#39;<tr><td><a id="l1905"></a><a href="#l1905">1905</a><td>  // rendered in its parent&#39;s (i.e., our target element&#39;s) font size. This is<tr><td><a id="l1906"></a><a href="#l1906">1906</a><td>  // the definition of CSS&#39;s font size attribute.<tr><td><a id="l1907"></a><a href="#l1907">1907</a><td>  var sizeElement = goog.dom.createDom(<tr><td><a id="l1908"></a><a href="#l1908">1908</a><td>      goog.dom.TagName.SPAN,<tr><td><a id="l1909"></a><a href="#l1909">1909</a><td>      {&#39;style&#39;: &#39;visibility:hidden;position:absolute;&#39; +<tr><td><a id="l1910"></a><a href="#l1910">1910</a><td>            &#39;line-height:0;padding:0;margin:0;border:0;height:1em;&#39;});<tr><td><a id="l1911"></a><a href="#l1911">1911</a><td>  goog.dom.appendChild(el, sizeElement);<tr><td><a id="l1912"></a><a href="#l1912">1912</a><td>  fontSize = sizeElement.offsetHeight;<tr><td><a id="l1913"></a><a href="#l1913">1913</a><td>  goog.dom.removeNode(sizeElement);<tr><td><a id="l1914"></a><a href="#l1914">1914</a><td><tr><td><a id="l1915"></a><a href="#l1915">1915</a><td>  return fontSize;<tr><td><a id="l1916"></a><a href="#l1916">1916</a><td>};<tr><td><a id="l1917"></a><a href="#l1917">1917</a><td><tr><td><a id="l1918"></a><a href="#l1918">1918</a><td><tr><td><a id="l1919"></a><a href="#l1919">1919</a><td>/**<tr><td><a id="l1920"></a><a href="#l1920">1920</a><td> * Parses a style attribute value.  Converts CSS property names to camel case.<tr><td><a id="l1921"></a><a href="#l1921">1921</a><td> * @param {string} value The style attribute value.<tr><td><a id="l1922"></a><a href="#l1922">1922</a><td> * @return {!Object} Map of CSS properties to string values.<tr><td><a id="l1923"></a><a href="#l1923">1923</a><td> */<tr><td><a id="l1924"></a><a href="#l1924">1924</a><td>goog.style.parseStyleAttribute = function(value) {<tr><td><a id="l1925"></a><a href="#l1925">1925</a><td>  var result = {};<tr><td><a id="l1926"></a><a href="#l1926">1926</a><td>  goog.array.forEach(value.split(/\s*;\s*/), function(pair) {<tr><td><a id="l1927"></a><a href="#l1927">1927</a><td>    var keyValue = pair.match(/\s*([\w-]+)\s*\:(.+)/);<tr><td><a id="l1928"></a><a href="#l1928">1928</a><td>    if (keyValue) {<tr><td><a id="l1929"></a><a href="#l1929">1929</a><td>      var styleName = keyValue[1];<tr><td><a id="l1930"></a><a href="#l1930">1930</a><td>      var styleValue = goog.string.trim(keyValue[2]);<tr><td><a id="l1931"></a><a href="#l1931">1931</a><td>      result[goog.string.toCamelCase(styleName.toLowerCase())] = styleValue;<tr><td><a id="l1932"></a><a href="#l1932">1932</a><td>    }<tr><td><a id="l1933"></a><a href="#l1933">1933</a><td>  });<tr><td><a id="l1934"></a><a href="#l1934">1934</a><td>  return result;<tr><td><a id="l1935"></a><a href="#l1935">1935</a><td>};<tr><td><a id="l1936"></a><a href="#l1936">1936</a><td><tr><td><a id="l1937"></a><a href="#l1937">1937</a><td><tr><td><a id="l1938"></a><a href="#l1938">1938</a><td>/**<tr><td><a id="l1939"></a><a href="#l1939">1939</a><td> * Reverse of parseStyleAttribute; that is, takes a style object and returns the<tr><td><a id="l1940"></a><a href="#l1940">1940</a><td> * corresponding attribute value.  Converts camel case property names to proper<tr><td><a id="l1941"></a><a href="#l1941">1941</a><td> * CSS selector names.<tr><td><a id="l1942"></a><a href="#l1942">1942</a><td> * @param {Object} obj Map of CSS properties to values.<tr><td><a id="l1943"></a><a href="#l1943">1943</a><td> * @return {string} The style attribute value.<tr><td><a id="l1944"></a><a href="#l1944">1944</a><td> */<tr><td><a id="l1945"></a><a href="#l1945">1945</a><td>goog.style.toStyleAttribute = function(obj) {<tr><td><a id="l1946"></a><a href="#l1946">1946</a><td>  var buffer = [];<tr><td><a id="l1947"></a><a href="#l1947">1947</a><td>  goog.object.forEach(obj, function(value, key) {<tr><td><a id="l1948"></a><a href="#l1948">1948</a><td>    buffer.push(goog.string.toSelectorCase(key), &#39;:&#39;, value, &#39;;&#39;);<tr><td><a id="l1949"></a><a href="#l1949">1949</a><td>  });<tr><td><a id="l1950"></a><a href="#l1950">1950</a><td>  return buffer.join(&#39;&#39;);<tr><td><a id="l1951"></a><a href="#l1951">1951</a><td>};<tr><td><a id="l1952"></a><a href="#l1952">1952</a><td><tr><td><a id="l1953"></a><a href="#l1953">1953</a><td><tr><td><a id="l1954"></a><a href="#l1954">1954</a><td>/**<tr><td><a id="l1955"></a><a href="#l1955">1955</a><td> * Sets CSS float property on an element.<tr><td><a id="l1956"></a><a href="#l1956">1956</a><td> * @param {Element} el The element to set float property on.<tr><td><a id="l1957"></a><a href="#l1957">1957</a><td> * @param {string} value The value of float CSS property to set on this element.<tr><td><a id="l1958"></a><a href="#l1958">1958</a><td> */<tr><td><a id="l1959"></a><a href="#l1959">1959</a><td>goog.style.setFloat = function(el, value) {<tr><td><a id="l1960"></a><a href="#l1960">1960</a><td>  el.style[goog.userAgent.IE ? &#39;styleFloat&#39; : &#39;cssFloat&#39;] = value;<tr><td><a id="l1961"></a><a href="#l1961">1961</a><td>};<tr><td><a id="l1962"></a><a href="#l1962">1962</a><td><tr><td><a id="l1963"></a><a href="#l1963">1963</a><td><tr><td><a id="l1964"></a><a href="#l1964">1964</a><td>/**<tr><td><a id="l1965"></a><a href="#l1965">1965</a><td> * Gets value of explicitly-set float CSS property on an element.<tr><td><a id="l1966"></a><a href="#l1966">1966</a><td> * @param {Element} el The element to get float property of.<tr><td><a id="l1967"></a><a href="#l1967">1967</a><td> * @return {string} The value of explicitly-set float CSS property on this<tr><td><a id="l1968"></a><a href="#l1968">1968</a><td> *     element.<tr><td><a id="l1969"></a><a href="#l1969">1969</a><td> */<tr><td><a id="l1970"></a><a href="#l1970">1970</a><td>goog.style.getFloat = function(el) {<tr><td><a id="l1971"></a><a href="#l1971">1971</a><td>  return el.style[goog.userAgent.IE ? &#39;styleFloat&#39; : &#39;cssFloat&#39;] || &#39;&#39;;<tr><td><a id="l1972"></a><a href="#l1972">1972</a><td>};<tr><td><a id="l1973"></a><a href="#l1973">1973</a><td><tr><td><a id="l1974"></a><a href="#l1974">1974</a><td><tr><td><a id="l1975"></a><a href="#l1975">1975</a><td>/**<tr><td><a id="l1976"></a><a href="#l1976">1976</a><td> * Returns the scroll bar width (represents the width of both horizontal<tr><td><a id="l1977"></a><a href="#l1977">1977</a><td> * and vertical scroll).<tr><td><a id="l1978"></a><a href="#l1978">1978</a><td> *<tr><td><a id="l1979"></a><a href="#l1979">1979</a><td> * @param {string=} opt_className An optional class name (or names) to apply<tr><td><a id="l1980"></a><a href="#l1980">1980</a><td> *     to the invisible div created to measure the scrollbar. This is necessary<tr><td><a id="l1981"></a><a href="#l1981">1981</a><td> *     if some scrollbars are styled differently than others.<tr><td><a id="l1982"></a><a href="#l1982">1982</a><td> * @return {number} The scroll bar width in px.<tr><td><a id="l1983"></a><a href="#l1983">1983</a><td> */<tr><td><a id="l1984"></a><a href="#l1984">1984</a><td>goog.style.getScrollbarWidth = function(opt_className) {<tr><td><a id="l1985"></a><a href="#l1985">1985</a><td>  // Add two hidden divs.  The child div is larger than the parent and<tr><td><a id="l1986"></a><a href="#l1986">1986</a><td>  // forces scrollbars to appear on it.<tr><td><a id="l1987"></a><a href="#l1987">1987</a><td>  // Using overflow:scroll does not work consistently with scrollbars that<tr><td><a id="l1988"></a><a href="#l1988">1988</a><td>  // are styled with ::-webkit-scrollbar.<tr><td><a id="l1989"></a><a href="#l1989">1989</a><td>  var outerDiv = goog.dom.createElement(goog.dom.TagName.DIV);<tr><td><a id="l1990"></a><a href="#l1990">1990</a><td>  if (opt_className) {<tr><td><a id="l1991"></a><a href="#l1991">1991</a><td>    outerDiv.className = opt_className;<tr><td><a id="l1992"></a><a href="#l1992">1992</a><td>  }<tr><td><a id="l1993"></a><a href="#l1993">1993</a><td>  outerDiv.style.cssText = &#39;overflow:auto;&#39; +<tr><td><a id="l1994"></a><a href="#l1994">1994</a><td>      &#39;position:absolute;top:0;width:100px;height:100px&#39;;<tr><td><a id="l1995"></a><a href="#l1995">1995</a><td>  var innerDiv = goog.dom.createElement(goog.dom.TagName.DIV);<tr><td><a id="l1996"></a><a href="#l1996">1996</a><td>  goog.style.setSize(innerDiv, &#39;200px&#39;, &#39;200px&#39;);<tr><td><a id="l1997"></a><a href="#l1997">1997</a><td>  outerDiv.appendChild(innerDiv);<tr><td><a id="l1998"></a><a href="#l1998">1998</a><td>  goog.dom.appendChild(goog.dom.getDocument().body, outerDiv);<tr><td><a id="l1999"></a><a href="#l1999">1999</a><td>  var width = outerDiv.offsetWidth - outerDiv.clientWidth;<tr><td><a id="l2000"></a><a href="#l2000">2000</a><td>  goog.dom.removeNode(outerDiv);<tr><td><a id="l2001"></a><a href="#l2001">2001</a><td>  return width;<tr><td><a id="l2002"></a><a href="#l2002">2002</a><td>};<tr><td><a id="l2003"></a><a href="#l2003">2003</a><td><tr><td><a id="l2004"></a><a href="#l2004">2004</a><td><tr><td><a id="l2005"></a><a href="#l2005">2005</a><td>/**<tr><td><a id="l2006"></a><a href="#l2006">2006</a><td> * Regular expression to extract x and y translation components from a CSS<tr><td><a id="l2007"></a><a href="#l2007">2007</a><td> * transform Matrix representation.<tr><td><a id="l2008"></a><a href="#l2008">2008</a><td> *<tr><td><a id="l2009"></a><a href="#l2009">2009</a><td> * @type {!RegExp}<tr><td><a id="l2010"></a><a href="#l2010">2010</a><td> * @const<tr><td><a id="l2011"></a><a href="#l2011">2011</a><td> * @private<tr><td><a id="l2012"></a><a href="#l2012">2012</a><td> */<tr><td><a id="l2013"></a><a href="#l2013">2013</a><td>goog.style.MATRIX_TRANSLATION_REGEX_ =<tr><td><a id="l2014"></a><a href="#l2014">2014</a><td>    new RegExp(&#39;matrix\\([0-9\\.\\-]+, [0-9\\.\\-]+, &#39; +<tr><td><a id="l2015"></a><a href="#l2015">2015</a><td>               &#39;[0-9\\.\\-]+, [0-9\\.\\-]+, &#39; +<tr><td><a id="l2016"></a><a href="#l2016">2016</a><td>               &#39;([0-9\\.\\-]+)p?x?, ([0-9\\.\\-]+)p?x?\\)&#39;);<tr><td><a id="l2017"></a><a href="#l2017">2017</a><td><tr><td><a id="l2018"></a><a href="#l2018">2018</a><td><tr><td><a id="l2019"></a><a href="#l2019">2019</a><td>/**<tr><td><a id="l2020"></a><a href="#l2020">2020</a><td> * Returns the x,y translation component of any CSS transforms applied to the<tr><td><a id="l2021"></a><a href="#l2021">2021</a><td> * element, in pixels.<tr><td><a id="l2022"></a><a href="#l2022">2022</a><td> *<tr><td><a id="l2023"></a><a href="#l2023">2023</a><td> * @param {!Element} element The element to get the translation of.<tr><td><a id="l2024"></a><a href="#l2024">2024</a><td> * @return {!goog.math.Coordinate} The CSS translation of the element in px.<tr><td><a id="l2025"></a><a href="#l2025">2025</a><td> */<tr><td><a id="l2026"></a><a href="#l2026">2026</a><td>goog.style.getCssTranslation = function(element) {<tr><td><a id="l2027"></a><a href="#l2027">2027</a><td>  var transform = goog.style.getComputedTransform(element);<tr><td><a id="l2028"></a><a href="#l2028">2028</a><td>  if (!transform) {<tr><td><a id="l2029"></a><a href="#l2029">2029</a><td>    return new goog.math.Coordinate(0, 0);<tr><td><a id="l2030"></a><a href="#l2030">2030</a><td>  }<tr><td><a id="l2031"></a><a href="#l2031">2031</a><td>  var matches = transform.match(goog.style.MATRIX_TRANSLATION_REGEX_);<tr><td><a id="l2032"></a><a href="#l2032">2032</a><td>  if (!matches) {<tr><td><a id="l2033"></a><a href="#l2033">2033</a><td>    return new goog.math.Coordinate(0, 0);<tr><td><a id="l2034"></a><a href="#l2034">2034</a><td>  }<tr><td><a id="l2035"></a><a href="#l2035">2035</a><td>  return new goog.math.Coordinate(parseFloat(matches[1]),<tr><td><a id="l2036"></a><a href="#l2036">2036</a><td>                                  parseFloat(matches[2]));<tr><td><a id="l2037"></a><a href="#l2037">2037</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/asserts.js.src.html b/docs/source/lib/goog/testing/asserts.js.src.html
new file mode 100644
index 0000000..0bcf36a
--- /dev/null
+++ b/docs/source/lib/goog/testing/asserts.js.src.html
@@ -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>asserts.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/asserts.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td>goog.provide(&#39;goog.testing.JsUnitException&#39;);<tr><td><a id="l15"></a><a href="#l15">15</a><td>goog.provide(&#39;goog.testing.asserts&#39;);<tr><td><a id="l16"></a><a href="#l16">16</a><td>goog.provide(&#39;goog.testing.asserts.ArrayLike&#39;);<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.require(&#39;goog.testing.stacktrace&#39;);<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>// TODO(user): Copied from JsUnit with some small modifications, we should<tr><td><a id="l21"></a><a href="#l21">21</a><td>// reimplement the asserters.<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> * @typedef {Array|NodeList|Arguments|{length: number}}<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.testing.asserts.ArrayLike;<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>var DOUBLE_EQUALITY_PREDICATE = function(var1, var2) {<tr><td><a id="l30"></a><a href="#l30">30</a><td>  return var1 == var2;<tr><td><a id="l31"></a><a href="#l31">31</a><td>};<tr><td><a id="l32"></a><a href="#l32">32</a><td>var JSUNIT_UNDEFINED_VALUE = void 0;<tr><td><a id="l33"></a><a href="#l33">33</a><td>var TO_STRING_EQUALITY_PREDICATE = function(var1, var2) {<tr><td><a id="l34"></a><a href="#l34">34</a><td>  return var1.toString() === var2.toString();<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>/** @typedef {function(?, ?):boolean} */<tr><td><a id="l38"></a><a href="#l38">38</a><td>var PredicateFunctionType;<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> * @const {{<tr><td><a id="l42"></a><a href="#l42">42</a><td> *   String : PredicateFunctionType,<tr><td><a id="l43"></a><a href="#l43">43</a><td> *   Number : PredicateFunctionType,<tr><td><a id="l44"></a><a href="#l44">44</a><td> *   Boolean : PredicateFunctionType,<tr><td><a id="l45"></a><a href="#l45">45</a><td> *   Date : PredicateFunctionType,<tr><td><a id="l46"></a><a href="#l46">46</a><td> *   RegExp : PredicateFunctionType,<tr><td><a id="l47"></a><a href="#l47">47</a><td> *   Function : PredicateFunctionType<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>var PRIMITIVE_EQUALITY_PREDICATES = {<tr><td><a id="l51"></a><a href="#l51">51</a><td>  &#39;String&#39;: DOUBLE_EQUALITY_PREDICATE,<tr><td><a id="l52"></a><a href="#l52">52</a><td>  &#39;Number&#39;: DOUBLE_EQUALITY_PREDICATE,<tr><td><a id="l53"></a><a href="#l53">53</a><td>  &#39;Boolean&#39;: DOUBLE_EQUALITY_PREDICATE,<tr><td><a id="l54"></a><a href="#l54">54</a><td>  &#39;Date&#39;: function(date1, date2) {<tr><td><a id="l55"></a><a href="#l55">55</a><td>    return date1.getTime() == date2.getTime();<tr><td><a id="l56"></a><a href="#l56">56</a><td>  },<tr><td><a id="l57"></a><a href="#l57">57</a><td>  &#39;RegExp&#39;: TO_STRING_EQUALITY_PREDICATE,<tr><td><a id="l58"></a><a href="#l58">58</a><td>  &#39;Function&#39;: TO_STRING_EQUALITY_PREDICATE<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><tr><td><a id="l62"></a><a href="#l62">62</a><td>/**<tr><td><a id="l63"></a><a href="#l63">63</a><td> * Compares equality of two numbers, allowing them to differ up to a given<tr><td><a id="l64"></a><a href="#l64">64</a><td> * tolerance.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @param {number} var1 A number.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @param {number} var2 A number.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @param {number} tolerance the maximum allowed difference.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @return {boolean} Whether the two variables are sufficiently close.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @private<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>goog.testing.asserts.numberRoughEqualityPredicate_ = function(<tr><td><a id="l72"></a><a href="#l72">72</a><td>    var1, var2, tolerance) {<tr><td><a id="l73"></a><a href="#l73">73</a><td>  return Math.abs(var1 - var2) &lt;= tolerance;<tr><td><a id="l74"></a><a href="#l74">74</a><td>};<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/**<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @type {Object&lt;string, function(*, *, number): boolean&gt;}<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @private<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.testing.asserts.primitiveRoughEqualityPredicates_ = {<tr><td><a id="l82"></a><a href="#l82">82</a><td>  &#39;Number&#39;: goog.testing.asserts.numberRoughEqualityPredicate_<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>var _trueTypeOf = function(something) {<tr><td><a id="l87"></a><a href="#l87">87</a><td>  var result = typeof something;<tr><td><a id="l88"></a><a href="#l88">88</a><td>  try {<tr><td><a id="l89"></a><a href="#l89">89</a><td>    switch (result) {<tr><td><a id="l90"></a><a href="#l90">90</a><td>      case &#39;string&#39;:<tr><td><a id="l91"></a><a href="#l91">91</a><td>        break;<tr><td><a id="l92"></a><a href="#l92">92</a><td>      case &#39;boolean&#39;:<tr><td><a id="l93"></a><a href="#l93">93</a><td>        break;<tr><td><a id="l94"></a><a href="#l94">94</a><td>      case &#39;number&#39;:<tr><td><a id="l95"></a><a href="#l95">95</a><td>        break;<tr><td><a id="l96"></a><a href="#l96">96</a><td>      case &#39;object&#39;:<tr><td><a id="l97"></a><a href="#l97">97</a><td>        if (something == null) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>          result = &#39;null&#39;;<tr><td><a id="l99"></a><a href="#l99">99</a><td>          break;<tr><td><a id="l100"></a><a href="#l100">100</a><td>        }<tr><td><a id="l101"></a><a href="#l101">101</a><td>      case &#39;function&#39;:<tr><td><a id="l102"></a><a href="#l102">102</a><td>        switch (something.constructor) {<tr><td><a id="l103"></a><a href="#l103">103</a><td>          case new String(&#39;&#39;).constructor:<tr><td><a id="l104"></a><a href="#l104">104</a><td>            result = &#39;String&#39;;<tr><td><a id="l105"></a><a href="#l105">105</a><td>            break;<tr><td><a id="l106"></a><a href="#l106">106</a><td>          case new Boolean(true).constructor:<tr><td><a id="l107"></a><a href="#l107">107</a><td>            result = &#39;Boolean&#39;;<tr><td><a id="l108"></a><a href="#l108">108</a><td>            break;<tr><td><a id="l109"></a><a href="#l109">109</a><td>          case new Number(0).constructor:<tr><td><a id="l110"></a><a href="#l110">110</a><td>            result = &#39;Number&#39;;<tr><td><a id="l111"></a><a href="#l111">111</a><td>            break;<tr><td><a id="l112"></a><a href="#l112">112</a><td>          case new Array().constructor:<tr><td><a id="l113"></a><a href="#l113">113</a><td>            result = &#39;Array&#39;;<tr><td><a id="l114"></a><a href="#l114">114</a><td>            break;<tr><td><a id="l115"></a><a href="#l115">115</a><td>          case new RegExp().constructor:<tr><td><a id="l116"></a><a href="#l116">116</a><td>            result = &#39;RegExp&#39;;<tr><td><a id="l117"></a><a href="#l117">117</a><td>            break;<tr><td><a id="l118"></a><a href="#l118">118</a><td>          case new Date().constructor:<tr><td><a id="l119"></a><a href="#l119">119</a><td>            result = &#39;Date&#39;;<tr><td><a id="l120"></a><a href="#l120">120</a><td>            break;<tr><td><a id="l121"></a><a href="#l121">121</a><td>          case Function:<tr><td><a id="l122"></a><a href="#l122">122</a><td>            result = &#39;Function&#39;;<tr><td><a id="l123"></a><a href="#l123">123</a><td>            break;<tr><td><a id="l124"></a><a href="#l124">124</a><td>          default:<tr><td><a id="l125"></a><a href="#l125">125</a><td>            var m = something.constructor.toString().match(<tr><td><a id="l126"></a><a href="#l126">126</a><td>                /function\s*([^( ]+)\(/);<tr><td><a id="l127"></a><a href="#l127">127</a><td>            if (m) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>              result = m[1];<tr><td><a id="l129"></a><a href="#l129">129</a><td>            } else {<tr><td><a id="l130"></a><a href="#l130">130</a><td>              break;<tr><td><a id="l131"></a><a href="#l131">131</a><td>            }<tr><td><a id="l132"></a><a href="#l132">132</a><td>        }<tr><td><a id="l133"></a><a href="#l133">133</a><td>        break;<tr><td><a id="l134"></a><a href="#l134">134</a><td>    }<tr><td><a id="l135"></a><a href="#l135">135</a><td>  } catch (e) {<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>  } finally {<tr><td><a id="l138"></a><a href="#l138">138</a><td>    result = result.substr(0, 1).toUpperCase() + result.substr(1);<tr><td><a id="l139"></a><a href="#l139">139</a><td>  }<tr><td><a id="l140"></a><a href="#l140">140</a><td>  return result;<tr><td><a id="l141"></a><a href="#l141">141</a><td>};<tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>var _displayStringForValue = function(aVar) {<tr><td><a id="l144"></a><a href="#l144">144</a><td>  var result;<tr><td><a id="l145"></a><a href="#l145">145</a><td>  try {<tr><td><a id="l146"></a><a href="#l146">146</a><td>    result = &#39;&lt;&#39; + String(aVar) + &#39;&gt;&#39;;<tr><td><a id="l147"></a><a href="#l147">147</a><td>  } catch (ex) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>    result = &#39;&lt;toString failed: &#39; + ex.message + &#39;&gt;&#39;;<tr><td><a id="l149"></a><a href="#l149">149</a><td>    // toString does not work on this object :-(<tr><td><a id="l150"></a><a href="#l150">150</a><td>  }<tr><td><a id="l151"></a><a href="#l151">151</a><td>  if (!(aVar === null || aVar === JSUNIT_UNDEFINED_VALUE)) {<tr><td><a id="l152"></a><a href="#l152">152</a><td>    result += &#39; (&#39; + _trueTypeOf(aVar) + &#39;)&#39;;<tr><td><a id="l153"></a><a href="#l153">153</a><td>  }<tr><td><a id="l154"></a><a href="#l154">154</a><td>  return result;<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>var fail = function(failureMessage) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  goog.testing.asserts.raiseException(&#39;Call to fail()&#39;, failureMessage);<tr><td><a id="l159"></a><a href="#l159">159</a><td>};<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td>var argumentsIncludeComments = function(expectedNumberOfNonCommentArgs, args) {<tr><td><a id="l162"></a><a href="#l162">162</a><td>  return args.length == expectedNumberOfNonCommentArgs + 1;<tr><td><a id="l163"></a><a href="#l163">163</a><td>};<tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td>var commentArg = function(expectedNumberOfNonCommentArgs, args) {<tr><td><a id="l166"></a><a href="#l166">166</a><td>  if (argumentsIncludeComments(expectedNumberOfNonCommentArgs, args)) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>    return args[0];<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>  return null;<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>var nonCommentArg = function(desiredNonCommentArgIndex,<tr><td><a id="l174"></a><a href="#l174">174</a><td>    expectedNumberOfNonCommentArgs, args) {<tr><td><a id="l175"></a><a href="#l175">175</a><td>  return argumentsIncludeComments(expectedNumberOfNonCommentArgs, args) ?<tr><td><a id="l176"></a><a href="#l176">176</a><td>      args[desiredNonCommentArgIndex] :<tr><td><a id="l177"></a><a href="#l177">177</a><td>      args[desiredNonCommentArgIndex - 1];<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>var _validateArguments = function(expectedNumberOfNonCommentArgs, args) {<tr><td><a id="l181"></a><a href="#l181">181</a><td>  var valid = args.length == expectedNumberOfNonCommentArgs ||<tr><td><a id="l182"></a><a href="#l182">182</a><td>      args.length == expectedNumberOfNonCommentArgs + 1 &amp;&amp;<tr><td><a id="l183"></a><a href="#l183">183</a><td>      goog.isString(args[0]);<tr><td><a id="l184"></a><a href="#l184">184</a><td>  _assert(null, valid, &#39;Incorrect arguments passed to assert function&#39;);<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>var _assert = function(comment, booleanValue, failureMessage) {<tr><td><a id="l188"></a><a href="#l188">188</a><td>  if (!booleanValue) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>    goog.testing.asserts.raiseException(comment, failureMessage);<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>/**<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @param {*} expected The expected value.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @param {*} actual The actual value.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @return {string} A failure message of the values don&#39;t match.<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @private<tr><td><a id="l199"></a><a href="#l199">199</a><td> */<tr><td><a id="l200"></a><a href="#l200">200</a><td>goog.testing.asserts.getDefaultErrorMsg_ = function(expected, actual) {<tr><td><a id="l201"></a><a href="#l201">201</a><td>  var msg = &#39;Expected &#39; + _displayStringForValue(expected) + &#39; but was &#39; +<tr><td><a id="l202"></a><a href="#l202">202</a><td>      _displayStringForValue(actual);<tr><td><a id="l203"></a><a href="#l203">203</a><td>  if ((typeof expected == &#39;string&#39;) &amp;&amp; (typeof actual == &#39;string&#39;)) {<tr><td><a id="l204"></a><a href="#l204">204</a><td>    // Try to find a human-readable difference.<tr><td><a id="l205"></a><a href="#l205">205</a><td>    var limit = Math.min(expected.length, actual.length);<tr><td><a id="l206"></a><a href="#l206">206</a><td>    var commonPrefix = 0;<tr><td><a id="l207"></a><a href="#l207">207</a><td>    while (commonPrefix &lt; limit &amp;&amp;<tr><td><a id="l208"></a><a href="#l208">208</a><td>        expected.charAt(commonPrefix) == actual.charAt(commonPrefix)) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>      commonPrefix++;<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>    var commonSuffix = 0;<tr><td><a id="l213"></a><a href="#l213">213</a><td>    while (commonSuffix &lt; limit &amp;&amp;<tr><td><a id="l214"></a><a href="#l214">214</a><td>        expected.charAt(expected.length - commonSuffix - 1) ==<tr><td><a id="l215"></a><a href="#l215">215</a><td>            actual.charAt(actual.length - commonSuffix - 1)) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>      commonSuffix++;<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>    if (commonPrefix + commonSuffix &gt; limit) {<tr><td><a id="l220"></a><a href="#l220">220</a><td>      commonSuffix = 0;<tr><td><a id="l221"></a><a href="#l221">221</a><td>    }<tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td>    if (commonPrefix &gt; 2 || commonSuffix &gt; 2) {<tr><td><a id="l224"></a><a href="#l224">224</a><td>      var printString = function(str) {<tr><td><a id="l225"></a><a href="#l225">225</a><td>        var startIndex = Math.max(0, commonPrefix - 2);<tr><td><a id="l226"></a><a href="#l226">226</a><td>        var endIndex = Math.min(str.length, str.length - (commonSuffix - 2));<tr><td><a id="l227"></a><a href="#l227">227</a><td>        return (startIndex &gt; 0 ? &#39;...&#39; : &#39;&#39;) +<tr><td><a id="l228"></a><a href="#l228">228</a><td>            str.substring(startIndex, endIndex) +<tr><td><a id="l229"></a><a href="#l229">229</a><td>            (endIndex &lt; str.length ? &#39;...&#39; : &#39;&#39;);<tr><td><a id="l230"></a><a href="#l230">230</a><td>      };<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td>      msg += &#39;\nDifference was at position &#39; + commonPrefix +<tr><td><a id="l233"></a><a href="#l233">233</a><td>          &#39;. Expected [&#39; + printString(expected) +<tr><td><a id="l234"></a><a href="#l234">234</a><td>          &#39;] vs. actual [&#39; + printString(actual) + &#39;]&#39;;<tr><td><a id="l235"></a><a href="#l235">235</a><td>    }<tr><td><a id="l236"></a><a href="#l236">236</a><td>  }<tr><td><a id="l237"></a><a href="#l237">237</a><td>  return msg;<tr><td><a id="l238"></a><a href="#l238">238</a><td>};<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>/**<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l244"></a><a href="#l244">244</a><td> */<tr><td><a id="l245"></a><a href="#l245">245</a><td>var assert = function(a, opt_b) {<tr><td><a id="l246"></a><a href="#l246">246</a><td>  _validateArguments(1, arguments);<tr><td><a id="l247"></a><a href="#l247">247</a><td>  var comment = commentArg(1, arguments);<tr><td><a id="l248"></a><a href="#l248">248</a><td>  var booleanValue = nonCommentArg(1, 1, arguments);<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td>  _assert(comment, goog.isBoolean(booleanValue),<tr><td><a id="l251"></a><a href="#l251">251</a><td>      &#39;Bad argument to assert(boolean)&#39;);<tr><td><a id="l252"></a><a href="#l252">252</a><td>  _assert(comment, booleanValue, &#39;Call to assert(boolean) with false&#39;);<tr><td><a id="l253"></a><a href="#l253">253</a><td>};<tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td><tr><td><a id="l256"></a><a href="#l256">256</a><td>/**<tr><td><a id="l257"></a><a href="#l257">257</a><td> * Asserts that the function throws an error.<tr><td><a id="l258"></a><a href="#l258">258</a><td> *<tr><td><a id="l259"></a><a href="#l259">259</a><td> * @param {!(string|Function)} a The assertion comment or the function to call.<tr><td><a id="l260"></a><a href="#l260">260</a><td> * @param {!Function=} opt_b The function to call (if the first argument of<tr><td><a id="l261"></a><a href="#l261">261</a><td> *     {@code assertThrows} was the comment).<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @return {*} The error thrown by the function.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @throws {goog.testing.JsUnitException} If the assertion failed.<tr><td><a id="l264"></a><a href="#l264">264</a><td> */<tr><td><a id="l265"></a><a href="#l265">265</a><td>var assertThrows = function(a, opt_b) {<tr><td><a id="l266"></a><a href="#l266">266</a><td>  _validateArguments(1, arguments);<tr><td><a id="l267"></a><a href="#l267">267</a><td>  var func = nonCommentArg(1, 1, arguments);<tr><td><a id="l268"></a><a href="#l268">268</a><td>  var comment = commentArg(1, arguments);<tr><td><a id="l269"></a><a href="#l269">269</a><td>  _assert(comment, typeof func == &#39;function&#39;,<tr><td><a id="l270"></a><a href="#l270">270</a><td>      &#39;Argument passed to assertThrows is not a function&#39;);<tr><td><a id="l271"></a><a href="#l271">271</a><td><tr><td><a id="l272"></a><a href="#l272">272</a><td>  try {<tr><td><a id="l273"></a><a href="#l273">273</a><td>    func();<tr><td><a id="l274"></a><a href="#l274">274</a><td>  } catch (e) {<tr><td><a id="l275"></a><a href="#l275">275</a><td>    if (e &amp;&amp; goog.isString(e[&#39;stacktrace&#39;]) &amp;&amp; goog.isString(e[&#39;message&#39;])) {<tr><td><a id="l276"></a><a href="#l276">276</a><td>      // Remove the stack trace appended to the error message by Opera 10.0<tr><td><a id="l277"></a><a href="#l277">277</a><td>      var startIndex = e[&#39;message&#39;].length - e[&#39;stacktrace&#39;].length;<tr><td><a id="l278"></a><a href="#l278">278</a><td>      if (e[&#39;message&#39;].indexOf(e[&#39;stacktrace&#39;], startIndex) == startIndex) {<tr><td><a id="l279"></a><a href="#l279">279</a><td>        e[&#39;message&#39;] = e[&#39;message&#39;].substr(0, startIndex - 14);<tr><td><a id="l280"></a><a href="#l280">280</a><td>      }<tr><td><a id="l281"></a><a href="#l281">281</a><td>    }<tr><td><a id="l282"></a><a href="#l282">282</a><td>    return e;<tr><td><a id="l283"></a><a href="#l283">283</a><td>  }<tr><td><a id="l284"></a><a href="#l284">284</a><td>  goog.testing.asserts.raiseException(comment,<tr><td><a id="l285"></a><a href="#l285">285</a><td>      &#39;No exception thrown from function passed to assertThrows&#39;);<tr><td><a id="l286"></a><a href="#l286">286</a><td>};<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>/**<tr><td><a id="l290"></a><a href="#l290">290</a><td> * Asserts that the function does not throw an error.<tr><td><a id="l291"></a><a href="#l291">291</a><td> *<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @param {!(string|Function)} a The assertion comment or the function to call.<tr><td><a id="l293"></a><a href="#l293">293</a><td> * @param {!Function=} opt_b The function to call (if the first argument of<tr><td><a id="l294"></a><a href="#l294">294</a><td> *     {@code assertNotThrows} was the comment).<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @return {*} The return value of the function.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @throws {goog.testing.JsUnitException} If the assertion failed.<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>var assertNotThrows = function(a, opt_b) {<tr><td><a id="l299"></a><a href="#l299">299</a><td>  _validateArguments(1, arguments);<tr><td><a id="l300"></a><a href="#l300">300</a><td>  var comment = commentArg(1, arguments);<tr><td><a id="l301"></a><a href="#l301">301</a><td>  var func = nonCommentArg(1, 1, arguments);<tr><td><a id="l302"></a><a href="#l302">302</a><td>  _assert(comment, typeof func == &#39;function&#39;,<tr><td><a id="l303"></a><a href="#l303">303</a><td>      &#39;Argument passed to assertNotThrows is not a function&#39;);<tr><td><a id="l304"></a><a href="#l304">304</a><td><tr><td><a id="l305"></a><a href="#l305">305</a><td>  try {<tr><td><a id="l306"></a><a href="#l306">306</a><td>    return func();<tr><td><a id="l307"></a><a href="#l307">307</a><td>  } catch (e) {<tr><td><a id="l308"></a><a href="#l308">308</a><td>    comment = comment ? (comment + &#39;\n&#39;) : &#39;&#39;;<tr><td><a id="l309"></a><a href="#l309">309</a><td>    comment += &#39;A non expected exception was thrown from function passed to &#39; +<tr><td><a id="l310"></a><a href="#l310">310</a><td>               &#39;assertNotThrows&#39;;<tr><td><a id="l311"></a><a href="#l311">311</a><td>    // Some browsers don&#39;t have a stack trace so at least have the error<tr><td><a id="l312"></a><a href="#l312">312</a><td>    // description.<tr><td><a id="l313"></a><a href="#l313">313</a><td>    var stackTrace = e[&#39;stack&#39;] || e[&#39;stacktrace&#39;] || e.toString();<tr><td><a id="l314"></a><a href="#l314">314</a><td>    goog.testing.asserts.raiseException(comment, stackTrace);<tr><td><a id="l315"></a><a href="#l315">315</a><td>  }<tr><td><a id="l316"></a><a href="#l316">316</a><td>};<tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td>/**<tr><td><a id="l320"></a><a href="#l320">320</a><td> * Asserts that the given callback function results in a JsUnitException when<tr><td><a id="l321"></a><a href="#l321">321</a><td> * called, and that the resulting failure message matches the given expected<tr><td><a id="l322"></a><a href="#l322">322</a><td> * message.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @param {function() : void} callback Function to be run expected to result<tr><td><a id="l324"></a><a href="#l324">324</a><td> *     in a JsUnitException (usually contains a call to an assert).<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @param {string=} opt_expectedMessage Failure message expected to be given<tr><td><a id="l326"></a><a href="#l326">326</a><td> *     with the exception.<tr><td><a id="l327"></a><a href="#l327">327</a><td> */<tr><td><a id="l328"></a><a href="#l328">328</a><td>var assertThrowsJsUnitException = function(callback, opt_expectedMessage) {<tr><td><a id="l329"></a><a href="#l329">329</a><td>  var failed = false;<tr><td><a id="l330"></a><a href="#l330">330</a><td>  try {<tr><td><a id="l331"></a><a href="#l331">331</a><td>    goog.testing.asserts.callWithoutLogging(callback);<tr><td><a id="l332"></a><a href="#l332">332</a><td>  } catch (ex) {<tr><td><a id="l333"></a><a href="#l333">333</a><td>    if (!ex.isJsUnitException) {<tr><td><a id="l334"></a><a href="#l334">334</a><td>      fail(&#39;Expected a JsUnitException&#39;);<tr><td><a id="l335"></a><a href="#l335">335</a><td>    }<tr><td><a id="l336"></a><a href="#l336">336</a><td>    if (typeof opt_expectedMessage != &#39;undefined&#39; &amp;&amp;<tr><td><a id="l337"></a><a href="#l337">337</a><td>        ex.message != opt_expectedMessage) {<tr><td><a id="l338"></a><a href="#l338">338</a><td>      fail(&#39;Expected message [&#39; + opt_expectedMessage + &#39;] but got [&#39; +<tr><td><a id="l339"></a><a href="#l339">339</a><td>          ex.message + &#39;]&#39;);<tr><td><a id="l340"></a><a href="#l340">340</a><td>    }<tr><td><a id="l341"></a><a href="#l341">341</a><td>    failed = true;<tr><td><a id="l342"></a><a href="#l342">342</a><td>  }<tr><td><a id="l343"></a><a href="#l343">343</a><td>  if (!failed) {<tr><td><a id="l344"></a><a href="#l344">344</a><td>    fail(&#39;Expected a failure: &#39; + opt_expectedMessage);<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><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 {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l352"></a><a href="#l352">352</a><td> */<tr><td><a id="l353"></a><a href="#l353">353</a><td>var assertTrue = function(a, opt_b) {<tr><td><a id="l354"></a><a href="#l354">354</a><td>  _validateArguments(1, arguments);<tr><td><a id="l355"></a><a href="#l355">355</a><td>  var comment = commentArg(1, arguments);<tr><td><a id="l356"></a><a href="#l356">356</a><td>  var booleanValue = nonCommentArg(1, 1, arguments);<tr><td><a id="l357"></a><a href="#l357">357</a><td><tr><td><a id="l358"></a><a href="#l358">358</a><td>  _assert(comment, goog.isBoolean(booleanValue),<tr><td><a id="l359"></a><a href="#l359">359</a><td>      &#39;Bad argument to assertTrue(boolean)&#39;);<tr><td><a id="l360"></a><a href="#l360">360</a><td>  _assert(comment, booleanValue, &#39;Call to assertTrue(boolean) with false&#39;);<tr><td><a id="l361"></a><a href="#l361">361</a><td>};<tr><td><a id="l362"></a><a href="#l362">362</a><td><tr><td><a id="l363"></a><a href="#l363">363</a><td><tr><td><a id="l364"></a><a href="#l364">364</a><td>/**<tr><td><a id="l365"></a><a href="#l365">365</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l366"></a><a href="#l366">366</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l367"></a><a href="#l367">367</a><td> */<tr><td><a id="l368"></a><a href="#l368">368</a><td>var assertFalse = function(a, opt_b) {<tr><td><a id="l369"></a><a href="#l369">369</a><td>  _validateArguments(1, arguments);<tr><td><a id="l370"></a><a href="#l370">370</a><td>  var comment = commentArg(1, arguments);<tr><td><a id="l371"></a><a href="#l371">371</a><td>  var booleanValue = nonCommentArg(1, 1, arguments);<tr><td><a id="l372"></a><a href="#l372">372</a><td><tr><td><a id="l373"></a><a href="#l373">373</a><td>  _assert(comment, goog.isBoolean(booleanValue),<tr><td><a id="l374"></a><a href="#l374">374</a><td>      &#39;Bad argument to assertFalse(boolean)&#39;);<tr><td><a id="l375"></a><a href="#l375">375</a><td>  _assert(comment, !booleanValue, &#39;Call to assertFalse(boolean) with true&#39;);<tr><td><a id="l376"></a><a href="#l376">376</a><td>};<tr><td><a id="l377"></a><a href="#l377">377</a><td><tr><td><a id="l378"></a><a href="#l378">378</a><td><tr><td><a id="l379"></a><a href="#l379">379</a><td>/**<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @param {*} a The expected value (2 args) or the debug message (3 args).<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @param {*} b The actual value (2 args) or the expected value (3 args).<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @param {*=} opt_c The actual value (3 args only).<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>var assertEquals = function(a, b, opt_c) {<tr><td><a id="l385"></a><a href="#l385">385</a><td>  _validateArguments(2, arguments);<tr><td><a id="l386"></a><a href="#l386">386</a><td>  var var1 = nonCommentArg(1, 2, arguments);<tr><td><a id="l387"></a><a href="#l387">387</a><td>  var var2 = nonCommentArg(2, 2, arguments);<tr><td><a id="l388"></a><a href="#l388">388</a><td>  _assert(commentArg(2, arguments), var1 === var2,<tr><td><a id="l389"></a><a href="#l389">389</a><td>          goog.testing.asserts.getDefaultErrorMsg_(var1, var2));<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>/**<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @param {*} a The expected value (2 args) or the debug message (3 args).<tr><td><a id="l395"></a><a href="#l395">395</a><td> * @param {*} b The actual value (2 args) or the expected value (3 args).<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @param {*=} opt_c The actual value (3 args only).<tr><td><a id="l397"></a><a href="#l397">397</a><td> */<tr><td><a id="l398"></a><a href="#l398">398</a><td>var assertNotEquals = function(a, b, opt_c) {<tr><td><a id="l399"></a><a href="#l399">399</a><td>  _validateArguments(2, arguments);<tr><td><a id="l400"></a><a href="#l400">400</a><td>  var var1 = nonCommentArg(1, 2, arguments);<tr><td><a id="l401"></a><a href="#l401">401</a><td>  var var2 = nonCommentArg(2, 2, arguments);<tr><td><a id="l402"></a><a href="#l402">402</a><td>  _assert(commentArg(2, arguments), var1 !== var2,<tr><td><a id="l403"></a><a href="#l403">403</a><td>      &#39;Expected not to be &#39; + _displayStringForValue(var2));<tr><td><a id="l404"></a><a href="#l404">404</a><td>};<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td><tr><td><a id="l407"></a><a href="#l407">407</a><td>/**<tr><td><a id="l408"></a><a href="#l408">408</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l409"></a><a href="#l409">409</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l410"></a><a href="#l410">410</a><td> */<tr><td><a id="l411"></a><a href="#l411">411</a><td>var assertNull = function(a, opt_b) {<tr><td><a id="l412"></a><a href="#l412">412</a><td>  _validateArguments(1, arguments);<tr><td><a id="l413"></a><a href="#l413">413</a><td>  var aVar = nonCommentArg(1, 1, arguments);<tr><td><a id="l414"></a><a href="#l414">414</a><td>  _assert(commentArg(1, arguments), aVar === null,<tr><td><a id="l415"></a><a href="#l415">415</a><td>      goog.testing.asserts.getDefaultErrorMsg_(null, aVar));<tr><td><a id="l416"></a><a href="#l416">416</a><td>};<tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td><tr><td><a id="l419"></a><a href="#l419">419</a><td>/**<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l421"></a><a href="#l421">421</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l422"></a><a href="#l422">422</a><td> */<tr><td><a id="l423"></a><a href="#l423">423</a><td>var assertNotNull = function(a, opt_b) {<tr><td><a id="l424"></a><a href="#l424">424</a><td>  _validateArguments(1, arguments);<tr><td><a id="l425"></a><a href="#l425">425</a><td>  var aVar = nonCommentArg(1, 1, arguments);<tr><td><a id="l426"></a><a href="#l426">426</a><td>  _assert(commentArg(1, arguments), aVar !== null,<tr><td><a id="l427"></a><a href="#l427">427</a><td>      &#39;Expected not to be &#39; + _displayStringForValue(null));<tr><td><a id="l428"></a><a href="#l428">428</a><td>};<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td>/**<tr><td><a id="l432"></a><a href="#l432">432</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l433"></a><a href="#l433">433</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l434"></a><a href="#l434">434</a><td> */<tr><td><a id="l435"></a><a href="#l435">435</a><td>var assertUndefined = function(a, opt_b) {<tr><td><a id="l436"></a><a href="#l436">436</a><td>  _validateArguments(1, arguments);<tr><td><a id="l437"></a><a href="#l437">437</a><td>  var aVar = nonCommentArg(1, 1, arguments);<tr><td><a id="l438"></a><a href="#l438">438</a><td>  _assert(commentArg(1, arguments), aVar === JSUNIT_UNDEFINED_VALUE,<tr><td><a id="l439"></a><a href="#l439">439</a><td>      goog.testing.asserts.getDefaultErrorMsg_(JSUNIT_UNDEFINED_VALUE, aVar));<tr><td><a id="l440"></a><a href="#l440">440</a><td>};<tr><td><a id="l441"></a><a href="#l441">441</a><td><tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td>/**<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l445"></a><a href="#l445">445</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l446"></a><a href="#l446">446</a><td> */<tr><td><a id="l447"></a><a href="#l447">447</a><td>var assertNotUndefined = function(a, opt_b) {<tr><td><a id="l448"></a><a href="#l448">448</a><td>  _validateArguments(1, arguments);<tr><td><a id="l449"></a><a href="#l449">449</a><td>  var aVar = nonCommentArg(1, 1, arguments);<tr><td><a id="l450"></a><a href="#l450">450</a><td>  _assert(commentArg(1, arguments), aVar !== JSUNIT_UNDEFINED_VALUE,<tr><td><a id="l451"></a><a href="#l451">451</a><td>      &#39;Expected not to be &#39; + _displayStringForValue(JSUNIT_UNDEFINED_VALUE));<tr><td><a id="l452"></a><a href="#l452">452</a><td>};<tr><td><a id="l453"></a><a href="#l453">453</a><td><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> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l457"></a><a href="#l457">457</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l458"></a><a href="#l458">458</a><td> */<tr><td><a id="l459"></a><a href="#l459">459</a><td>var assertNotNullNorUndefined = function(a, opt_b) {<tr><td><a id="l460"></a><a href="#l460">460</a><td>  _validateArguments(1, arguments);<tr><td><a id="l461"></a><a href="#l461">461</a><td>  assertNotNull.apply(null, arguments);<tr><td><a id="l462"></a><a href="#l462">462</a><td>  assertNotUndefined.apply(null, arguments);<tr><td><a id="l463"></a><a href="#l463">463</a><td>};<tr><td><a id="l464"></a><a href="#l464">464</a><td><tr><td><a id="l465"></a><a href="#l465">465</a><td><tr><td><a id="l466"></a><a href="#l466">466</a><td>/**<tr><td><a id="l467"></a><a href="#l467">467</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l468"></a><a href="#l468">468</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l469"></a><a href="#l469">469</a><td> */<tr><td><a id="l470"></a><a href="#l470">470</a><td>var assertNonEmptyString = function(a, opt_b) {<tr><td><a id="l471"></a><a href="#l471">471</a><td>  _validateArguments(1, arguments);<tr><td><a id="l472"></a><a href="#l472">472</a><td>  var aVar = nonCommentArg(1, 1, arguments);<tr><td><a id="l473"></a><a href="#l473">473</a><td>  _assert(commentArg(1, arguments),<tr><td><a id="l474"></a><a href="#l474">474</a><td>      aVar !== JSUNIT_UNDEFINED_VALUE &amp;&amp; aVar !== null &amp;&amp;<tr><td><a id="l475"></a><a href="#l475">475</a><td>      typeof aVar == &#39;string&#39; &amp;&amp; aVar !== &#39;&#39;,<tr><td><a id="l476"></a><a href="#l476">476</a><td>      &#39;Expected non-empty string but was &#39; + _displayStringForValue(aVar));<tr><td><a id="l477"></a><a href="#l477">477</a><td>};<tr><td><a id="l478"></a><a href="#l478">478</a><td><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> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l482"></a><a href="#l482">482</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l483"></a><a href="#l483">483</a><td> */<tr><td><a id="l484"></a><a href="#l484">484</a><td>var assertNaN = function(a, opt_b) {<tr><td><a id="l485"></a><a href="#l485">485</a><td>  _validateArguments(1, arguments);<tr><td><a id="l486"></a><a href="#l486">486</a><td>  var aVar = nonCommentArg(1, 1, arguments);<tr><td><a id="l487"></a><a href="#l487">487</a><td>  _assert(commentArg(1, arguments), isNaN(aVar), &#39;Expected NaN&#39;);<tr><td><a id="l488"></a><a href="#l488">488</a><td>};<tr><td><a id="l489"></a><a href="#l489">489</a><td><tr><td><a id="l490"></a><a href="#l490">490</a><td><tr><td><a id="l491"></a><a href="#l491">491</a><td>/**<tr><td><a id="l492"></a><a href="#l492">492</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l493"></a><a href="#l493">493</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l494"></a><a href="#l494">494</a><td> */<tr><td><a id="l495"></a><a href="#l495">495</a><td>var assertNotNaN = function(a, opt_b) {<tr><td><a id="l496"></a><a href="#l496">496</a><td>  _validateArguments(1, arguments);<tr><td><a id="l497"></a><a href="#l497">497</a><td>  var aVar = nonCommentArg(1, 1, arguments);<tr><td><a id="l498"></a><a href="#l498">498</a><td>  _assert(commentArg(1, arguments), !isNaN(aVar), &#39;Expected not NaN&#39;);<tr><td><a id="l499"></a><a href="#l499">499</a><td>};<tr><td><a id="l500"></a><a href="#l500">500</a><td><tr><td><a id="l501"></a><a href="#l501">501</a><td><tr><td><a id="l502"></a><a href="#l502">502</a><td>/**<tr><td><a id="l503"></a><a href="#l503">503</a><td> * Runs a function in an environment where test failures are not logged. This is<tr><td><a id="l504"></a><a href="#l504">504</a><td> * useful for testing test code, where failures can be a normal part of a test.<tr><td><a id="l505"></a><a href="#l505">505</a><td> * @param {function() : void} fn Function to run without logging failures.<tr><td><a id="l506"></a><a href="#l506">506</a><td> */<tr><td><a id="l507"></a><a href="#l507">507</a><td>goog.testing.asserts.callWithoutLogging = function(fn) {<tr><td><a id="l508"></a><a href="#l508">508</a><td>  var testRunner = goog.global[&#39;G_testRunner&#39;];<tr><td><a id="l509"></a><a href="#l509">509</a><td>  var oldLogTestFailure = testRunner[&#39;logTestFailure&#39;];<tr><td><a id="l510"></a><a href="#l510">510</a><td>  try {<tr><td><a id="l511"></a><a href="#l511">511</a><td>    // Any failures in the callback shouldn&#39;t be recorded.<tr><td><a id="l512"></a><a href="#l512">512</a><td>    testRunner[&#39;logTestFailure&#39;] = undefined;<tr><td><a id="l513"></a><a href="#l513">513</a><td>    fn();<tr><td><a id="l514"></a><a href="#l514">514</a><td>  } finally {<tr><td><a id="l515"></a><a href="#l515">515</a><td>    testRunner[&#39;logTestFailure&#39;] = oldLogTestFailure;<tr><td><a id="l516"></a><a href="#l516">516</a><td>  }<tr><td><a id="l517"></a><a href="#l517">517</a><td>};<tr><td><a id="l518"></a><a href="#l518">518</a><td><tr><td><a id="l519"></a><a href="#l519">519</a><td><tr><td><a id="l520"></a><a href="#l520">520</a><td>/**<tr><td><a id="l521"></a><a href="#l521">521</a><td> * The return value of the equality predicate passed to findDifferences below,<tr><td><a id="l522"></a><a href="#l522">522</a><td> * in cases where the predicate can&#39;t test the input variables for equality.<tr><td><a id="l523"></a><a href="#l523">523</a><td> * @type {?string}<tr><td><a id="l524"></a><a href="#l524">524</a><td> */<tr><td><a id="l525"></a><a href="#l525">525</a><td>goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS = null;<tr><td><a id="l526"></a><a href="#l526">526</a><td><tr><td><a id="l527"></a><a href="#l527">527</a><td><tr><td><a id="l528"></a><a href="#l528">528</a><td>/**<tr><td><a id="l529"></a><a href="#l529">529</a><td> * The return value of the equality predicate passed to findDifferences below,<tr><td><a id="l530"></a><a href="#l530">530</a><td> * in cases where the input vriables are equal.<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @type {?string}<tr><td><a id="l532"></a><a href="#l532">532</a><td> */<tr><td><a id="l533"></a><a href="#l533">533</a><td>goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL = &#39;&#39;;<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> * Determines if two items of any type match, and formulates an error message<tr><td><a id="l538"></a><a href="#l538">538</a><td> * if not.<tr><td><a id="l539"></a><a href="#l539">539</a><td> * @param {*} expected Expected argument to match.<tr><td><a id="l540"></a><a href="#l540">540</a><td> * @param {*} actual Argument as a result of performing the test.<tr><td><a id="l541"></a><a href="#l541">541</a><td> * @param {(function(string, *, *): ?string)=} opt_equalityPredicate An optional<tr><td><a id="l542"></a><a href="#l542">542</a><td> *     function that can be used to check equality of variables. It accepts 3<tr><td><a id="l543"></a><a href="#l543">543</a><td> *     arguments: type-of-variables, var1, var2 (in that order) and returns an<tr><td><a id="l544"></a><a href="#l544">544</a><td> *     error message if the variables are not equal,<tr><td><a id="l545"></a><a href="#l545">545</a><td> *     goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL if the variables<tr><td><a id="l546"></a><a href="#l546">546</a><td> *     are equal, or<tr><td><a id="l547"></a><a href="#l547">547</a><td> *     goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS if the predicate<tr><td><a id="l548"></a><a href="#l548">548</a><td> *     couldn&#39;t check the input variables. The function will be called only if<tr><td><a id="l549"></a><a href="#l549">549</a><td> *     the types of var1 and var2 are identical.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * @return {?string} Null on success, error message on failure.<tr><td><a id="l551"></a><a href="#l551">551</a><td> */<tr><td><a id="l552"></a><a href="#l552">552</a><td>goog.testing.asserts.findDifferences = function(expected, actual,<tr><td><a id="l553"></a><a href="#l553">553</a><td>    opt_equalityPredicate) {<tr><td><a id="l554"></a><a href="#l554">554</a><td>  var failures = [];<tr><td><a id="l555"></a><a href="#l555">555</a><td>  var seen1 = [];<tr><td><a id="l556"></a><a href="#l556">556</a><td>  var seen2 = [];<tr><td><a id="l557"></a><a href="#l557">557</a><td><tr><td><a id="l558"></a><a href="#l558">558</a><td>  // To avoid infinite recursion when the two parameters are self-referential<tr><td><a id="l559"></a><a href="#l559">559</a><td>  // along the same path of properties, keep track of the object pairs already<tr><td><a id="l560"></a><a href="#l560">560</a><td>  // seen in this call subtree, and abort when a cycle is detected.<tr><td><a id="l561"></a><a href="#l561">561</a><td>  function innerAssertWithCycleCheck(var1, var2, path) {<tr><td><a id="l562"></a><a href="#l562">562</a><td>    // This is used for testing, so we can afford to be slow (but more<tr><td><a id="l563"></a><a href="#l563">563</a><td>    // accurate). So we just check whether var1 is in seen1. If we<tr><td><a id="l564"></a><a href="#l564">564</a><td>    // found var1 in index i, we simply need to check whether var2 is<tr><td><a id="l565"></a><a href="#l565">565</a><td>    // in seen2[i]. If it is, we do not recurse to check var1/var2. If<tr><td><a id="l566"></a><a href="#l566">566</a><td>    // it isn&#39;t, we know that the structures of the two objects must be<tr><td><a id="l567"></a><a href="#l567">567</a><td>    // different.<tr><td><a id="l568"></a><a href="#l568">568</a><td>    //<tr><td><a id="l569"></a><a href="#l569">569</a><td>    // This is based on the fact that values at index i in seen1 and<tr><td><a id="l570"></a><a href="#l570">570</a><td>    // seen2 will be checked for equality eventually (when<tr><td><a id="l571"></a><a href="#l571">571</a><td>    // innerAssertImplementation(seen1[i], seen2[i], path) finishes).<tr><td><a id="l572"></a><a href="#l572">572</a><td>    for (var i = 0; i &lt; seen1.length; ++i) {<tr><td><a id="l573"></a><a href="#l573">573</a><td>      var match1 = seen1[i] === var1;<tr><td><a id="l574"></a><a href="#l574">574</a><td>      var match2 = seen2[i] === var2;<tr><td><a id="l575"></a><a href="#l575">575</a><td>      if (match1 || match2) {<tr><td><a id="l576"></a><a href="#l576">576</a><td>        if (!match1 || !match2) {<tr><td><a id="l577"></a><a href="#l577">577</a><td>          // Asymmetric cycles, so the objects have different structure.<tr><td><a id="l578"></a><a href="#l578">578</a><td>          failures.push(&#39;Asymmetric cycle detected at &#39; + path);<tr><td><a id="l579"></a><a href="#l579">579</a><td>        }<tr><td><a id="l580"></a><a href="#l580">580</a><td>        return;<tr><td><a id="l581"></a><a href="#l581">581</a><td>      }<tr><td><a id="l582"></a><a href="#l582">582</a><td>    }<tr><td><a id="l583"></a><a href="#l583">583</a><td><tr><td><a id="l584"></a><a href="#l584">584</a><td>    seen1.push(var1);<tr><td><a id="l585"></a><a href="#l585">585</a><td>    seen2.push(var2);<tr><td><a id="l586"></a><a href="#l586">586</a><td>    innerAssertImplementation(var1, var2, path);<tr><td><a id="l587"></a><a href="#l587">587</a><td>    seen1.pop();<tr><td><a id="l588"></a><a href="#l588">588</a><td>    seen2.pop();<tr><td><a id="l589"></a><a href="#l589">589</a><td>  }<tr><td><a id="l590"></a><a href="#l590">590</a><td><tr><td><a id="l591"></a><a href="#l591">591</a><td>  var equalityPredicate = opt_equalityPredicate || function(type, var1, var2) {<tr><td><a id="l592"></a><a href="#l592">592</a><td>    var typedPredicate = PRIMITIVE_EQUALITY_PREDICATES[type];<tr><td><a id="l593"></a><a href="#l593">593</a><td>    if (!typedPredicate) {<tr><td><a id="l594"></a><a href="#l594">594</a><td>      return goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS;<tr><td><a id="l595"></a><a href="#l595">595</a><td>    }<tr><td><a id="l596"></a><a href="#l596">596</a><td>    var equal = typedPredicate(var1, var2);<tr><td><a id="l597"></a><a href="#l597">597</a><td>    return equal ? goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL :<tr><td><a id="l598"></a><a href="#l598">598</a><td>        goog.testing.asserts.getDefaultErrorMsg_(var1, var2);<tr><td><a id="l599"></a><a href="#l599">599</a><td>  };<tr><td><a id="l600"></a><a href="#l600">600</a><td><tr><td><a id="l601"></a><a href="#l601">601</a><td>  /**<tr><td><a id="l602"></a><a href="#l602">602</a><td>   * @param {*} var1 An item in the expected object.<tr><td><a id="l603"></a><a href="#l603">603</a><td>   * @param {*} var2 The corresponding item in the actual object.<tr><td><a id="l604"></a><a href="#l604">604</a><td>   * @param {string} path Their path in the objects.<tr><td><a id="l605"></a><a href="#l605">605</a><td>   * @suppress {missingProperties} The map_ property is unknown to the compiler<tr><td><a id="l606"></a><a href="#l606">606</a><td>   *     unless goog.structs.Map is loaded.<tr><td><a id="l607"></a><a href="#l607">607</a><td>   */<tr><td><a id="l608"></a><a href="#l608">608</a><td>  function innerAssertImplementation(var1, var2, path) {<tr><td><a id="l609"></a><a href="#l609">609</a><td>    if (var1 === var2) {<tr><td><a id="l610"></a><a href="#l610">610</a><td>      return;<tr><td><a id="l611"></a><a href="#l611">611</a><td>    }<tr><td><a id="l612"></a><a href="#l612">612</a><td><tr><td><a id="l613"></a><a href="#l613">613</a><td>    var typeOfVar1 = _trueTypeOf(var1);<tr><td><a id="l614"></a><a href="#l614">614</a><td>    var typeOfVar2 = _trueTypeOf(var2);<tr><td><a id="l615"></a><a href="#l615">615</a><td><tr><td><a id="l616"></a><a href="#l616">616</a><td>    if (typeOfVar1 == typeOfVar2) {<tr><td><a id="l617"></a><a href="#l617">617</a><td>      var isArray = typeOfVar1 == &#39;Array&#39;;<tr><td><a id="l618"></a><a href="#l618">618</a><td>      var errorMessage = equalityPredicate(typeOfVar1, var1, var2);<tr><td><a id="l619"></a><a href="#l619">619</a><td>      if (errorMessage !=<tr><td><a id="l620"></a><a href="#l620">620</a><td>          goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS) {<tr><td><a id="l621"></a><a href="#l621">621</a><td>        if (errorMessage !=<tr><td><a id="l622"></a><a href="#l622">622</a><td>            goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL) {<tr><td><a id="l623"></a><a href="#l623">623</a><td>          failures.push(path + &#39;: &#39; + errorMessage);<tr><td><a id="l624"></a><a href="#l624">624</a><td>        }<tr><td><a id="l625"></a><a href="#l625">625</a><td>      } else if (isArray &amp;&amp; var1.length != var2.length) {<tr><td><a id="l626"></a><a href="#l626">626</a><td>        failures.push(path + &#39;: Expected &#39; + var1.length + &#39;-element array &#39; +<tr><td><a id="l627"></a><a href="#l627">627</a><td>                      &#39;but got a &#39; + var2.length + &#39;-element array&#39;);<tr><td><a id="l628"></a><a href="#l628">628</a><td>      } else {<tr><td><a id="l629"></a><a href="#l629">629</a><td>        var childPath = path + (isArray ? &#39;[%s]&#39; : (path ? &#39;.%s&#39; : &#39;%s&#39;));<tr><td><a id="l630"></a><a href="#l630">630</a><td><tr><td><a id="l631"></a><a href="#l631">631</a><td>        // if an object has an __iterator__ property, we have no way of<tr><td><a id="l632"></a><a href="#l632">632</a><td>        // actually inspecting its raw properties, and JS 1.7 doesn&#39;t<tr><td><a id="l633"></a><a href="#l633">633</a><td>        // overload [] to make it possible for someone to generically<tr><td><a id="l634"></a><a href="#l634">634</a><td>        // use what the iterator returns to compare the object-managed<tr><td><a id="l635"></a><a href="#l635">635</a><td>        // properties. This gets us into deep poo with things like<tr><td><a id="l636"></a><a href="#l636">636</a><td>        // goog.structs.Map, at least on systems that support iteration.<tr><td><a id="l637"></a><a href="#l637">637</a><td>        if (!var1[&#39;__iterator__&#39;]) {<tr><td><a id="l638"></a><a href="#l638">638</a><td>          for (var prop in var1) {<tr><td><a id="l639"></a><a href="#l639">639</a><td>            if (isArray &amp;&amp; goog.testing.asserts.isArrayIndexProp_(prop)) {<tr><td><a id="l640"></a><a href="#l640">640</a><td>              // Skip array indices for now. We&#39;ll handle them later.<tr><td><a id="l641"></a><a href="#l641">641</a><td>              continue;<tr><td><a id="l642"></a><a href="#l642">642</a><td>            }<tr><td><a id="l643"></a><a href="#l643">643</a><td><tr><td><a id="l644"></a><a href="#l644">644</a><td>            if (prop in var2) {<tr><td><a id="l645"></a><a href="#l645">645</a><td>              innerAssertWithCycleCheck(var1[prop], var2[prop],<tr><td><a id="l646"></a><a href="#l646">646</a><td>                  childPath.replace(&#39;%s&#39;, prop));<tr><td><a id="l647"></a><a href="#l647">647</a><td>            } else {<tr><td><a id="l648"></a><a href="#l648">648</a><td>              failures.push(&#39;property &#39; + prop +<tr><td><a id="l649"></a><a href="#l649">649</a><td>                            &#39; not present in actual &#39; + (path || typeOfVar2));<tr><td><a id="l650"></a><a href="#l650">650</a><td>            }<tr><td><a id="l651"></a><a href="#l651">651</a><td>          }<tr><td><a id="l652"></a><a href="#l652">652</a><td>          // make sure there aren&#39;t properties in var2 that are missing<tr><td><a id="l653"></a><a href="#l653">653</a><td>          // from var1. if there are, then by definition they don&#39;t<tr><td><a id="l654"></a><a href="#l654">654</a><td>          // match.<tr><td><a id="l655"></a><a href="#l655">655</a><td>          for (var prop in var2) {<tr><td><a id="l656"></a><a href="#l656">656</a><td>            if (isArray &amp;&amp; goog.testing.asserts.isArrayIndexProp_(prop)) {<tr><td><a id="l657"></a><a href="#l657">657</a><td>              // Skip array indices for now. We&#39;ll handle them later.<tr><td><a id="l658"></a><a href="#l658">658</a><td>              continue;<tr><td><a id="l659"></a><a href="#l659">659</a><td>            }<tr><td><a id="l660"></a><a href="#l660">660</a><td><tr><td><a id="l661"></a><a href="#l661">661</a><td>            if (!(prop in var1)) {<tr><td><a id="l662"></a><a href="#l662">662</a><td>              failures.push(&#39;property &#39; + prop +<tr><td><a id="l663"></a><a href="#l663">663</a><td>                            &#39; not present in expected &#39; +<tr><td><a id="l664"></a><a href="#l664">664</a><td>                            (path || typeOfVar1));<tr><td><a id="l665"></a><a href="#l665">665</a><td>            }<tr><td><a id="l666"></a><a href="#l666">666</a><td>          }<tr><td><a id="l667"></a><a href="#l667">667</a><td><tr><td><a id="l668"></a><a href="#l668">668</a><td>          // Handle array indices by iterating from 0 to arr.length.<tr><td><a id="l669"></a><a href="#l669">669</a><td>          //<tr><td><a id="l670"></a><a href="#l670">670</a><td>          // Although all browsers allow holes in arrays, browsers<tr><td><a id="l671"></a><a href="#l671">671</a><td>          // are inconsistent in what they consider a hole. For example,<tr><td><a id="l672"></a><a href="#l672">672</a><td>          // &quot;[0,undefined,2]&quot; has a hole on IE but not on Firefox.<tr><td><a id="l673"></a><a href="#l673">673</a><td>          //<tr><td><a id="l674"></a><a href="#l674">674</a><td>          // Because our style guide bans for...in iteration over arrays,<tr><td><a id="l675"></a><a href="#l675">675</a><td>          // we assume that most users don&#39;t care about holes in arrays,<tr><td><a id="l676"></a><a href="#l676">676</a><td>          // and that it is ok to say that a hole is equivalent to a slot<tr><td><a id="l677"></a><a href="#l677">677</a><td>          // populated with &#39;undefined&#39;.<tr><td><a id="l678"></a><a href="#l678">678</a><td>          if (isArray) {<tr><td><a id="l679"></a><a href="#l679">679</a><td>            for (prop = 0; prop &lt; var1.length; prop++) {<tr><td><a id="l680"></a><a href="#l680">680</a><td>              innerAssertWithCycleCheck(var1[prop], var2[prop],<tr><td><a id="l681"></a><a href="#l681">681</a><td>                  childPath.replace(&#39;%s&#39;, String(prop)));<tr><td><a id="l682"></a><a href="#l682">682</a><td>            }<tr><td><a id="l683"></a><a href="#l683">683</a><td>          }<tr><td><a id="l684"></a><a href="#l684">684</a><td>        } else {<tr><td><a id="l685"></a><a href="#l685">685</a><td>          // special-case for closure objects that have iterators<tr><td><a id="l686"></a><a href="#l686">686</a><td>          if (goog.isFunction(var1.equals)) {<tr><td><a id="l687"></a><a href="#l687">687</a><td>            // use the object&#39;s own equals function, assuming it accepts an<tr><td><a id="l688"></a><a href="#l688">688</a><td>            // object and returns a boolean<tr><td><a id="l689"></a><a href="#l689">689</a><td>            if (!var1.equals(var2)) {<tr><td><a id="l690"></a><a href="#l690">690</a><td>              failures.push(&#39;equals() returned false for &#39; +<tr><td><a id="l691"></a><a href="#l691">691</a><td>                            (path || typeOfVar1));<tr><td><a id="l692"></a><a href="#l692">692</a><td>            }<tr><td><a id="l693"></a><a href="#l693">693</a><td>          } else if (var1.map_) {<tr><td><a id="l694"></a><a href="#l694">694</a><td>            // assume goog.structs.Map or goog.structs.Set, where comparing<tr><td><a id="l695"></a><a href="#l695">695</a><td>            // their private map_ field is sufficient<tr><td><a id="l696"></a><a href="#l696">696</a><td>            innerAssertWithCycleCheck(var1.map_, var2.map_,<tr><td><a id="l697"></a><a href="#l697">697</a><td>                childPath.replace(&#39;%s&#39;, &#39;map_&#39;));<tr><td><a id="l698"></a><a href="#l698">698</a><td>          } else {<tr><td><a id="l699"></a><a href="#l699">699</a><td>            // else die, so user knows we can&#39;t do anything<tr><td><a id="l700"></a><a href="#l700">700</a><td>            failures.push(&#39;unable to check &#39; + (path || typeOfVar1) +<tr><td><a id="l701"></a><a href="#l701">701</a><td>                          &#39; for equality: it has an iterator we do not &#39; +<tr><td><a id="l702"></a><a href="#l702">702</a><td>                          &#39;know how to handle. please add an equals method&#39;);<tr><td><a id="l703"></a><a href="#l703">703</a><td>          }<tr><td><a id="l704"></a><a href="#l704">704</a><td>        }<tr><td><a id="l705"></a><a href="#l705">705</a><td>      }<tr><td><a id="l706"></a><a href="#l706">706</a><td>    } else {<tr><td><a id="l707"></a><a href="#l707">707</a><td>      failures.push(path + &#39; &#39; +<tr><td><a id="l708"></a><a href="#l708">708</a><td>          goog.testing.asserts.getDefaultErrorMsg_(var1, var2));<tr><td><a id="l709"></a><a href="#l709">709</a><td>    }<tr><td><a id="l710"></a><a href="#l710">710</a><td>  }<tr><td><a id="l711"></a><a href="#l711">711</a><td><tr><td><a id="l712"></a><a href="#l712">712</a><td>  innerAssertWithCycleCheck(expected, actual, &#39;&#39;);<tr><td><a id="l713"></a><a href="#l713">713</a><td>  return failures.length == 0 ? null :<tr><td><a id="l714"></a><a href="#l714">714</a><td>      goog.testing.asserts.getDefaultErrorMsg_(expected, actual) +<tr><td><a id="l715"></a><a href="#l715">715</a><td>          &#39;\n   &#39; + failures.join(&#39;\n   &#39;);<tr><td><a id="l716"></a><a href="#l716">716</a><td>};<tr><td><a id="l717"></a><a href="#l717">717</a><td><tr><td><a id="l718"></a><a href="#l718">718</a><td><tr><td><a id="l719"></a><a href="#l719">719</a><td>/**<tr><td><a id="l720"></a><a href="#l720">720</a><td> * Notes:<tr><td><a id="l721"></a><a href="#l721">721</a><td> * Object equality has some nasty browser quirks, and this implementation is<tr><td><a id="l722"></a><a href="#l722">722</a><td> * not 100% correct. For example,<tr><td><a id="l723"></a><a href="#l723">723</a><td> *<tr><td><a id="l724"></a><a href="#l724">724</a><td> * &lt;code&gt;<tr><td><a id="l725"></a><a href="#l725">725</a><td> * var a = [0, 1, 2];<tr><td><a id="l726"></a><a href="#l726">726</a><td> * var b = [0, 1, 2];<tr><td><a id="l727"></a><a href="#l727">727</a><td> * delete a[1];<tr><td><a id="l728"></a><a href="#l728">728</a><td> * b[1] = undefined;<tr><td><a id="l729"></a><a href="#l729">729</a><td> * assertObjectEquals(a, b); // should fail, but currently passes<tr><td><a id="l730"></a><a href="#l730">730</a><td> * &lt;/code&gt;<tr><td><a id="l731"></a><a href="#l731">731</a><td> *<tr><td><a id="l732"></a><a href="#l732">732</a><td> * See asserts_test.html for more interesting edge cases.<tr><td><a id="l733"></a><a href="#l733">733</a><td> *<tr><td><a id="l734"></a><a href="#l734">734</a><td> * The first comparison object provided is the expected value, the second is<tr><td><a id="l735"></a><a href="#l735">735</a><td> * the actual.<tr><td><a id="l736"></a><a href="#l736">736</a><td> *<tr><td><a id="l737"></a><a href="#l737">737</a><td> * @param {*} a Assertion message or comparison object.<tr><td><a id="l738"></a><a href="#l738">738</a><td> * @param {*} b Comparison object.<tr><td><a id="l739"></a><a href="#l739">739</a><td> * @param {*=} opt_c Comparison object, if an assertion message was provided.<tr><td><a id="l740"></a><a href="#l740">740</a><td> */<tr><td><a id="l741"></a><a href="#l741">741</a><td>var assertObjectEquals = function(a, b, opt_c) {<tr><td><a id="l742"></a><a href="#l742">742</a><td>  _validateArguments(2, arguments);<tr><td><a id="l743"></a><a href="#l743">743</a><td>  var v1 = nonCommentArg(1, 2, arguments);<tr><td><a id="l744"></a><a href="#l744">744</a><td>  var v2 = nonCommentArg(2, 2, arguments);<tr><td><a id="l745"></a><a href="#l745">745</a><td>  var failureMessage = commentArg(2, arguments) ? commentArg(2, arguments) : &#39;&#39;;<tr><td><a id="l746"></a><a href="#l746">746</a><td>  var differences = goog.testing.asserts.findDifferences(v1, v2);<tr><td><a id="l747"></a><a href="#l747">747</a><td><tr><td><a id="l748"></a><a href="#l748">748</a><td>  _assert(failureMessage, !differences, differences);<tr><td><a id="l749"></a><a href="#l749">749</a><td>};<tr><td><a id="l750"></a><a href="#l750">750</a><td><tr><td><a id="l751"></a><a href="#l751">751</a><td><tr><td><a id="l752"></a><a href="#l752">752</a><td>/**<tr><td><a id="l753"></a><a href="#l753">753</a><td> * Similar to assertObjectEquals above, but accepts a tolerance margin.<tr><td><a id="l754"></a><a href="#l754">754</a><td> *<tr><td><a id="l755"></a><a href="#l755">755</a><td> * @param {*} a Assertion message or comparison object.<tr><td><a id="l756"></a><a href="#l756">756</a><td> * @param {*} b Comparison object.<tr><td><a id="l757"></a><a href="#l757">757</a><td> * @param {*} c Comparison object or tolerance.<tr><td><a id="l758"></a><a href="#l758">758</a><td> * @param {*=} opt_d Tolerance, if an assertion message was provided.<tr><td><a id="l759"></a><a href="#l759">759</a><td> */<tr><td><a id="l760"></a><a href="#l760">760</a><td>var assertObjectRoughlyEquals = function(a, b, c, opt_d) {<tr><td><a id="l761"></a><a href="#l761">761</a><td>  _validateArguments(3, arguments);<tr><td><a id="l762"></a><a href="#l762">762</a><td>  var v1 = nonCommentArg(1, 3, arguments);<tr><td><a id="l763"></a><a href="#l763">763</a><td>  var v2 = nonCommentArg(2, 3, arguments);<tr><td><a id="l764"></a><a href="#l764">764</a><td>  var tolerance = nonCommentArg(3, 3, arguments);<tr><td><a id="l765"></a><a href="#l765">765</a><td>  var failureMessage = commentArg(3, arguments) ? commentArg(3, arguments) : &#39;&#39;;<tr><td><a id="l766"></a><a href="#l766">766</a><td>  var equalityPredicate = function(type, var1, var2) {<tr><td><a id="l767"></a><a href="#l767">767</a><td>    var typedPredicate =<tr><td><a id="l768"></a><a href="#l768">768</a><td>        goog.testing.asserts.primitiveRoughEqualityPredicates_[type];<tr><td><a id="l769"></a><a href="#l769">769</a><td>    if (!typedPredicate) {<tr><td><a id="l770"></a><a href="#l770">770</a><td>      return goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS;<tr><td><a id="l771"></a><a href="#l771">771</a><td>    }<tr><td><a id="l772"></a><a href="#l772">772</a><td>    var equal = typedPredicate(var1, var2, tolerance);<tr><td><a id="l773"></a><a href="#l773">773</a><td>    return equal ? goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL :<tr><td><a id="l774"></a><a href="#l774">774</a><td>        goog.testing.asserts.getDefaultErrorMsg_(var1, var2) +<tr><td><a id="l775"></a><a href="#l775">775</a><td>        &#39; which was more than &#39; + tolerance + &#39; away&#39;;<tr><td><a id="l776"></a><a href="#l776">776</a><td>  };<tr><td><a id="l777"></a><a href="#l777">777</a><td>  var differences = goog.testing.asserts.findDifferences(<tr><td><a id="l778"></a><a href="#l778">778</a><td>      v1, v2, equalityPredicate);<tr><td><a id="l779"></a><a href="#l779">779</a><td><tr><td><a id="l780"></a><a href="#l780">780</a><td>  _assert(failureMessage, !differences, differences);<tr><td><a id="l781"></a><a href="#l781">781</a><td>};<tr><td><a id="l782"></a><a href="#l782">782</a><td><tr><td><a id="l783"></a><a href="#l783">783</a><td><tr><td><a id="l784"></a><a href="#l784">784</a><td>/**<tr><td><a id="l785"></a><a href="#l785">785</a><td> * Compares two arbitrary objects for non-equalness.<tr><td><a id="l786"></a><a href="#l786">786</a><td> *<tr><td><a id="l787"></a><a href="#l787">787</a><td> * All the same caveats as for assertObjectEquals apply here:<tr><td><a id="l788"></a><a href="#l788">788</a><td> * Undefined values may be confused for missing values, or vice versa.<tr><td><a id="l789"></a><a href="#l789">789</a><td> *<tr><td><a id="l790"></a><a href="#l790">790</a><td> * @param {*} a Assertion message or comparison object.<tr><td><a id="l791"></a><a href="#l791">791</a><td> * @param {*} b Comparison object.<tr><td><a id="l792"></a><a href="#l792">792</a><td> * @param {*=} opt_c Comparison object, if an assertion message was provided.<tr><td><a id="l793"></a><a href="#l793">793</a><td> */<tr><td><a id="l794"></a><a href="#l794">794</a><td>var assertObjectNotEquals = function(a, b, opt_c) {<tr><td><a id="l795"></a><a href="#l795">795</a><td>  _validateArguments(2, arguments);<tr><td><a id="l796"></a><a href="#l796">796</a><td>  var v1 = nonCommentArg(1, 2, arguments);<tr><td><a id="l797"></a><a href="#l797">797</a><td>  var v2 = nonCommentArg(2, 2, arguments);<tr><td><a id="l798"></a><a href="#l798">798</a><td>  var failureMessage = commentArg(2, arguments) ? commentArg(2, arguments) : &#39;&#39;;<tr><td><a id="l799"></a><a href="#l799">799</a><td>  var differences = goog.testing.asserts.findDifferences(v1, v2);<tr><td><a id="l800"></a><a href="#l800">800</a><td><tr><td><a id="l801"></a><a href="#l801">801</a><td>  _assert(failureMessage, differences, &#39;Objects should not be equal&#39;);<tr><td><a id="l802"></a><a href="#l802">802</a><td>};<tr><td><a id="l803"></a><a href="#l803">803</a><td><tr><td><a id="l804"></a><a href="#l804">804</a><td><tr><td><a id="l805"></a><a href="#l805">805</a><td>/**<tr><td><a id="l806"></a><a href="#l806">806</a><td> * Compares two arrays ignoring negative indexes and extra properties on the<tr><td><a id="l807"></a><a href="#l807">807</a><td> * array objects. Use case: Internet Explorer adds the index, lastIndex and<tr><td><a id="l808"></a><a href="#l808">808</a><td> * input enumerable fields to the result of string.match(/regexp/g), which makes<tr><td><a id="l809"></a><a href="#l809">809</a><td> * assertObjectEquals fail.<tr><td><a id="l810"></a><a href="#l810">810</a><td> * @param {*} a The expected array (2 args) or the debug message (3 args).<tr><td><a id="l811"></a><a href="#l811">811</a><td> * @param {*} b The actual array (2 args) or the expected array (3 args).<tr><td><a id="l812"></a><a href="#l812">812</a><td> * @param {*=} opt_c The actual array (3 args only).<tr><td><a id="l813"></a><a href="#l813">813</a><td> */<tr><td><a id="l814"></a><a href="#l814">814</a><td>var assertArrayEquals = function(a, b, opt_c) {<tr><td><a id="l815"></a><a href="#l815">815</a><td>  _validateArguments(2, arguments);<tr><td><a id="l816"></a><a href="#l816">816</a><td>  var v1 = nonCommentArg(1, 2, arguments);<tr><td><a id="l817"></a><a href="#l817">817</a><td>  var v2 = nonCommentArg(2, 2, arguments);<tr><td><a id="l818"></a><a href="#l818">818</a><td>  var failureMessage = commentArg(2, arguments) ? commentArg(2, arguments) : &#39;&#39;;<tr><td><a id="l819"></a><a href="#l819">819</a><td><tr><td><a id="l820"></a><a href="#l820">820</a><td>  var typeOfVar1 = _trueTypeOf(v1);<tr><td><a id="l821"></a><a href="#l821">821</a><td>  _assert(failureMessage,<tr><td><a id="l822"></a><a href="#l822">822</a><td>          typeOfVar1 == &#39;Array&#39;,<tr><td><a id="l823"></a><a href="#l823">823</a><td>          &#39;Expected an array for assertArrayEquals but found a &#39; + typeOfVar1);<tr><td><a id="l824"></a><a href="#l824">824</a><td><tr><td><a id="l825"></a><a href="#l825">825</a><td>  var typeOfVar2 = _trueTypeOf(v2);<tr><td><a id="l826"></a><a href="#l826">826</a><td>  _assert(failureMessage,<tr><td><a id="l827"></a><a href="#l827">827</a><td>          typeOfVar2 == &#39;Array&#39;,<tr><td><a id="l828"></a><a href="#l828">828</a><td>          &#39;Expected an array for assertArrayEquals but found a &#39; + typeOfVar2);<tr><td><a id="l829"></a><a href="#l829">829</a><td><tr><td><a id="l830"></a><a href="#l830">830</a><td>  assertObjectEquals(failureMessage,<tr><td><a id="l831"></a><a href="#l831">831</a><td>      Array.prototype.concat.call(v1), Array.prototype.concat.call(v2));<tr><td><a id="l832"></a><a href="#l832">832</a><td>};<tr><td><a id="l833"></a><a href="#l833">833</a><td><tr><td><a id="l834"></a><a href="#l834">834</a><td><tr><td><a id="l835"></a><a href="#l835">835</a><td>/**<tr><td><a id="l836"></a><a href="#l836">836</a><td> * Compares two objects that can be accessed like an array and assert that<tr><td><a id="l837"></a><a href="#l837">837</a><td> * each element is equal.<tr><td><a id="l838"></a><a href="#l838">838</a><td> * @param {string|Object} a Failure message (3 arguments)<tr><td><a id="l839"></a><a href="#l839">839</a><td> *     or object #1 (2 arguments).<tr><td><a id="l840"></a><a href="#l840">840</a><td> * @param {Object} b Object #1 (2 arguments) or object #2 (3 arguments).<tr><td><a id="l841"></a><a href="#l841">841</a><td> * @param {Object=} opt_c Object #2 (3 arguments).<tr><td><a id="l842"></a><a href="#l842">842</a><td> */<tr><td><a id="l843"></a><a href="#l843">843</a><td>var assertElementsEquals = function(a, b, opt_c) {<tr><td><a id="l844"></a><a href="#l844">844</a><td>  _validateArguments(2, arguments);<tr><td><a id="l845"></a><a href="#l845">845</a><td><tr><td><a id="l846"></a><a href="#l846">846</a><td>  var v1 = nonCommentArg(1, 2, arguments);<tr><td><a id="l847"></a><a href="#l847">847</a><td>  var v2 = nonCommentArg(2, 2, arguments);<tr><td><a id="l848"></a><a href="#l848">848</a><td>  var failureMessage = commentArg(2, arguments) ? commentArg(2, arguments) : &#39;&#39;;<tr><td><a id="l849"></a><a href="#l849">849</a><td><tr><td><a id="l850"></a><a href="#l850">850</a><td>  if (!v1) {<tr><td><a id="l851"></a><a href="#l851">851</a><td>    assert(failureMessage, !v2);<tr><td><a id="l852"></a><a href="#l852">852</a><td>  } else {<tr><td><a id="l853"></a><a href="#l853">853</a><td>    assertEquals(&#39;length mismatch: &#39; + failureMessage, v1.length, v2.length);<tr><td><a id="l854"></a><a href="#l854">854</a><td>    for (var i = 0; i &lt; v1.length; ++i) {<tr><td><a id="l855"></a><a href="#l855">855</a><td>      assertEquals(<tr><td><a id="l856"></a><a href="#l856">856</a><td>          &#39;mismatch at index &#39; + i + &#39;: &#39; + failureMessage, v1[i], v2[i]);<tr><td><a id="l857"></a><a href="#l857">857</a><td>    }<tr><td><a id="l858"></a><a href="#l858">858</a><td>  }<tr><td><a id="l859"></a><a href="#l859">859</a><td>};<tr><td><a id="l860"></a><a href="#l860">860</a><td><tr><td><a id="l861"></a><a href="#l861">861</a><td><tr><td><a id="l862"></a><a href="#l862">862</a><td>/**<tr><td><a id="l863"></a><a href="#l863">863</a><td> * Compares two objects that can be accessed like an array and assert that<tr><td><a id="l864"></a><a href="#l864">864</a><td> * each element is roughly equal.<tr><td><a id="l865"></a><a href="#l865">865</a><td> * @param {string|Object} a Failure message (4 arguments)<tr><td><a id="l866"></a><a href="#l866">866</a><td> *     or object #1 (3 arguments).<tr><td><a id="l867"></a><a href="#l867">867</a><td> * @param {Object} b Object #1 (4 arguments) or object #2 (3 arguments).<tr><td><a id="l868"></a><a href="#l868">868</a><td> * @param {Object|number} c Object #2 (4 arguments) or tolerance (3 arguments).<tr><td><a id="l869"></a><a href="#l869">869</a><td> * @param {number=} opt_d tolerance (4 arguments).<tr><td><a id="l870"></a><a href="#l870">870</a><td> */<tr><td><a id="l871"></a><a href="#l871">871</a><td>var assertElementsRoughlyEqual = function(a, b, c, opt_d) {<tr><td><a id="l872"></a><a href="#l872">872</a><td>  _validateArguments(3, arguments);<tr><td><a id="l873"></a><a href="#l873">873</a><td><tr><td><a id="l874"></a><a href="#l874">874</a><td>  var v1 = nonCommentArg(1, 3, arguments);<tr><td><a id="l875"></a><a href="#l875">875</a><td>  var v2 = nonCommentArg(2, 3, arguments);<tr><td><a id="l876"></a><a href="#l876">876</a><td>  var tolerance = nonCommentArg(3, 3, arguments);<tr><td><a id="l877"></a><a href="#l877">877</a><td>  var failureMessage = commentArg(3, arguments) ? commentArg(3, arguments) : &#39;&#39;;<tr><td><a id="l878"></a><a href="#l878">878</a><td><tr><td><a id="l879"></a><a href="#l879">879</a><td>  if (!v1) {<tr><td><a id="l880"></a><a href="#l880">880</a><td>    assert(failureMessage, !v2);<tr><td><a id="l881"></a><a href="#l881">881</a><td>  } else {<tr><td><a id="l882"></a><a href="#l882">882</a><td>    assertEquals(&#39;length mismatch: &#39; + failureMessage, v1.length, v2.length);<tr><td><a id="l883"></a><a href="#l883">883</a><td>    for (var i = 0; i &lt; v1.length; ++i) {<tr><td><a id="l884"></a><a href="#l884">884</a><td>      assertRoughlyEquals(failureMessage, v1[i], v2[i], tolerance);<tr><td><a id="l885"></a><a href="#l885">885</a><td>    }<tr><td><a id="l886"></a><a href="#l886">886</a><td>  }<tr><td><a id="l887"></a><a href="#l887">887</a><td>};<tr><td><a id="l888"></a><a href="#l888">888</a><td><tr><td><a id="l889"></a><a href="#l889">889</a><td><tr><td><a id="l890"></a><a href="#l890">890</a><td>/**<tr><td><a id="l891"></a><a href="#l891">891</a><td> * Compares two array-like objects without taking their order into account.<tr><td><a id="l892"></a><a href="#l892">892</a><td> * @param {string|goog.testing.asserts.ArrayLike} a Assertion message or the<tr><td><a id="l893"></a><a href="#l893">893</a><td> *     expected elements.<tr><td><a id="l894"></a><a href="#l894">894</a><td> * @param {goog.testing.asserts.ArrayLike} b Expected elements or the actual<tr><td><a id="l895"></a><a href="#l895">895</a><td> *     elements.<tr><td><a id="l896"></a><a href="#l896">896</a><td> * @param {goog.testing.asserts.ArrayLike=} opt_c Actual elements.<tr><td><a id="l897"></a><a href="#l897">897</a><td> */<tr><td><a id="l898"></a><a href="#l898">898</a><td>var assertSameElements = function(a, b, opt_c) {<tr><td><a id="l899"></a><a href="#l899">899</a><td>  _validateArguments(2, arguments);<tr><td><a id="l900"></a><a href="#l900">900</a><td>  var expected = nonCommentArg(1, 2, arguments);<tr><td><a id="l901"></a><a href="#l901">901</a><td>  var actual = nonCommentArg(2, 2, arguments);<tr><td><a id="l902"></a><a href="#l902">902</a><td>  var message = commentArg(2, arguments);<tr><td><a id="l903"></a><a href="#l903">903</a><td><tr><td><a id="l904"></a><a href="#l904">904</a><td>  assertTrue(&#39;Bad arguments to assertSameElements(opt_message, expected: &#39; +<tr><td><a id="l905"></a><a href="#l905">905</a><td>      &#39;ArrayLike, actual: ArrayLike)&#39;,<tr><td><a id="l906"></a><a href="#l906">906</a><td>      goog.isArrayLike(expected) &amp;&amp; goog.isArrayLike(actual));<tr><td><a id="l907"></a><a href="#l907">907</a><td><tr><td><a id="l908"></a><a href="#l908">908</a><td>  // Clones expected and actual and converts them to real arrays.<tr><td><a id="l909"></a><a href="#l909">909</a><td>  expected = goog.testing.asserts.toArray_(expected);<tr><td><a id="l910"></a><a href="#l910">910</a><td>  actual = goog.testing.asserts.toArray_(actual);<tr><td><a id="l911"></a><a href="#l911">911</a><td>  // TODO(user): It would be great to show only the difference<tr><td><a id="l912"></a><a href="#l912">912</a><td>  // between the expected and actual elements.<tr><td><a id="l913"></a><a href="#l913">913</a><td>  _assert(message, expected.length == actual.length,<tr><td><a id="l914"></a><a href="#l914">914</a><td>      &#39;Expected &#39; + expected.length + &#39; elements: [&#39; + expected + &#39;], &#39; +<tr><td><a id="l915"></a><a href="#l915">915</a><td>      &#39;got &#39; + actual.length + &#39; elements: [&#39; + actual + &#39;]&#39;);<tr><td><a id="l916"></a><a href="#l916">916</a><td><tr><td><a id="l917"></a><a href="#l917">917</a><td>  var toFind = goog.testing.asserts.toArray_(expected);<tr><td><a id="l918"></a><a href="#l918">918</a><td>  for (var i = 0; i &lt; actual.length; i++) {<tr><td><a id="l919"></a><a href="#l919">919</a><td>    var index = goog.testing.asserts.indexOf_(toFind, actual[i]);<tr><td><a id="l920"></a><a href="#l920">920</a><td>    _assert(message, index != -1, &#39;Expected [&#39; + expected + &#39;], got [&#39; +<tr><td><a id="l921"></a><a href="#l921">921</a><td>        actual + &#39;]&#39;);<tr><td><a id="l922"></a><a href="#l922">922</a><td>    toFind.splice(index, 1);<tr><td><a id="l923"></a><a href="#l923">923</a><td>  }<tr><td><a id="l924"></a><a href="#l924">924</a><td>};<tr><td><a id="l925"></a><a href="#l925">925</a><td><tr><td><a id="l926"></a><a href="#l926">926</a><td><tr><td><a id="l927"></a><a href="#l927">927</a><td>/**<tr><td><a id="l928"></a><a href="#l928">928</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l929"></a><a href="#l929">929</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l930"></a><a href="#l930">930</a><td> */<tr><td><a id="l931"></a><a href="#l931">931</a><td>var assertEvaluatesToTrue = function(a, opt_b) {<tr><td><a id="l932"></a><a href="#l932">932</a><td>  _validateArguments(1, arguments);<tr><td><a id="l933"></a><a href="#l933">933</a><td>  var value = nonCommentArg(1, 1, arguments);<tr><td><a id="l934"></a><a href="#l934">934</a><td>  if (!value) {<tr><td><a id="l935"></a><a href="#l935">935</a><td>    _assert(commentArg(1, arguments), false, &#39;Expected to evaluate to true&#39;);<tr><td><a id="l936"></a><a href="#l936">936</a><td>  }<tr><td><a id="l937"></a><a href="#l937">937</a><td>};<tr><td><a id="l938"></a><a href="#l938">938</a><td><tr><td><a id="l939"></a><a href="#l939">939</a><td><tr><td><a id="l940"></a><a href="#l940">940</a><td>/**<tr><td><a id="l941"></a><a href="#l941">941</a><td> * @param {*} a The value to assert (1 arg) or debug message (2 args).<tr><td><a id="l942"></a><a href="#l942">942</a><td> * @param {*=} opt_b The value to assert (2 args only).<tr><td><a id="l943"></a><a href="#l943">943</a><td> */<tr><td><a id="l944"></a><a href="#l944">944</a><td>var assertEvaluatesToFalse = function(a, opt_b) {<tr><td><a id="l945"></a><a href="#l945">945</a><td>  _validateArguments(1, arguments);<tr><td><a id="l946"></a><a href="#l946">946</a><td>  var value = nonCommentArg(1, 1, arguments);<tr><td><a id="l947"></a><a href="#l947">947</a><td>  if (value) {<tr><td><a id="l948"></a><a href="#l948">948</a><td>    _assert(commentArg(1, arguments), false, &#39;Expected to evaluate to false&#39;);<tr><td><a id="l949"></a><a href="#l949">949</a><td>  }<tr><td><a id="l950"></a><a href="#l950">950</a><td>};<tr><td><a id="l951"></a><a href="#l951">951</a><td><tr><td><a id="l952"></a><a href="#l952">952</a><td><tr><td><a id="l953"></a><a href="#l953">953</a><td>/**<tr><td><a id="l954"></a><a href="#l954">954</a><td> * Compares two HTML snippets.<tr><td><a id="l955"></a><a href="#l955">955</a><td> *<tr><td><a id="l956"></a><a href="#l956">956</a><td> * Take extra care if attributes are involved. {@code assertHTMLEquals}&#39;s<tr><td><a id="l957"></a><a href="#l957">957</a><td> * implementation isn&#39;t prepared for complex cases. For example, the following<tr><td><a id="l958"></a><a href="#l958">958</a><td> * comparisons erroneously fail:<tr><td><a id="l959"></a><a href="#l959">959</a><td> * &lt;pre&gt;<tr><td><a id="l960"></a><a href="#l960">960</a><td> * assertHTMLEquals(&#39;&lt;a href=&quot;x&quot; target=&quot;y&quot;&gt;&#39;, &#39;&lt;a target=&quot;y&quot; href=&quot;x&quot;&gt;&#39;);<tr><td><a id="l961"></a><a href="#l961">961</a><td> * assertHTMLEquals(&#39;&lt;div class=&quot;a b&quot;&gt;&#39;, &#39;&lt;div class=&quot;b a&quot;&gt;&#39;);<tr><td><a id="l962"></a><a href="#l962">962</a><td> * assertHTMLEquals(&#39;&lt;input disabled&gt;&#39;, &#39;&lt;input disabled=&quot;disabled&quot;&gt;&#39;);<tr><td><a id="l963"></a><a href="#l963">963</a><td> * &lt;/pre&gt;<tr><td><a id="l964"></a><a href="#l964">964</a><td> *<tr><td><a id="l965"></a><a href="#l965">965</a><td> * When in doubt, use {@code goog.testing.dom.assertHtmlMatches}.<tr><td><a id="l966"></a><a href="#l966">966</a><td> *<tr><td><a id="l967"></a><a href="#l967">967</a><td> * @param {*} a The expected value (2 args) or the debug message (3 args).<tr><td><a id="l968"></a><a href="#l968">968</a><td> * @param {*} b The actual value (2 args) or the expected value (3 args).<tr><td><a id="l969"></a><a href="#l969">969</a><td> * @param {*=} opt_c The actual value (3 args only).<tr><td><a id="l970"></a><a href="#l970">970</a><td> */<tr><td><a id="l971"></a><a href="#l971">971</a><td>var assertHTMLEquals = function(a, b, opt_c) {<tr><td><a id="l972"></a><a href="#l972">972</a><td>  _validateArguments(2, arguments);<tr><td><a id="l973"></a><a href="#l973">973</a><td>  var var1 = nonCommentArg(1, 2, arguments);<tr><td><a id="l974"></a><a href="#l974">974</a><td>  var var2 = nonCommentArg(2, 2, arguments);<tr><td><a id="l975"></a><a href="#l975">975</a><td>  var var1Standardized = standardizeHTML(var1);<tr><td><a id="l976"></a><a href="#l976">976</a><td>  var var2Standardized = standardizeHTML(var2);<tr><td><a id="l977"></a><a href="#l977">977</a><td><tr><td><a id="l978"></a><a href="#l978">978</a><td>  _assert(commentArg(2, arguments), var1Standardized === var2Standardized,<tr><td><a id="l979"></a><a href="#l979">979</a><td>          goog.testing.asserts.getDefaultErrorMsg_(<tr><td><a id="l980"></a><a href="#l980">980</a><td>              var1Standardized, var2Standardized));<tr><td><a id="l981"></a><a href="#l981">981</a><td>};<tr><td><a id="l982"></a><a href="#l982">982</a><td><tr><td><a id="l983"></a><a href="#l983">983</a><td><tr><td><a id="l984"></a><a href="#l984">984</a><td>/**<tr><td><a id="l985"></a><a href="#l985">985</a><td> * Compares two CSS property values to make sure that they represent the same<tr><td><a id="l986"></a><a href="#l986">986</a><td> * things. This will normalize values in the browser. For example, in Firefox,<tr><td><a id="l987"></a><a href="#l987">987</a><td> * this assertion will consider &quot;rgb(0, 0, 255)&quot; and &quot;#0000ff&quot; to be identical<tr><td><a id="l988"></a><a href="#l988">988</a><td> * values for the &quot;color&quot; property. This function won&#39;t normalize everything --<tr><td><a id="l989"></a><a href="#l989">989</a><td> * for example, in most browsers, &quot;blue&quot; will not match &quot;#0000ff&quot;. It is<tr><td><a id="l990"></a><a href="#l990">990</a><td> * intended only to compensate for unexpected normalizations performed by<tr><td><a id="l991"></a><a href="#l991">991</a><td> * the browser that should also affect your expected value.<tr><td><a id="l992"></a><a href="#l992">992</a><td> * @param {string} a Assertion message, or the CSS property name.<tr><td><a id="l993"></a><a href="#l993">993</a><td> * @param {string} b CSS property name, or the expected value.<tr><td><a id="l994"></a><a href="#l994">994</a><td> * @param {string} c The expected value, or the actual value.<tr><td><a id="l995"></a><a href="#l995">995</a><td> * @param {string=} opt_d The actual value.<tr><td><a id="l996"></a><a href="#l996">996</a><td> */<tr><td><a id="l997"></a><a href="#l997">997</a><td>var assertCSSValueEquals = function(a, b, c, opt_d) {<tr><td><a id="l998"></a><a href="#l998">998</a><td>  _validateArguments(3, arguments);<tr><td><a id="l999"></a><a href="#l999">999</a><td>  var propertyName = nonCommentArg(1, 3, arguments);<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td>  var expectedValue = nonCommentArg(2, 3, arguments);<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td>  var actualValue = nonCommentArg(3, 3, arguments);<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td>  var expectedValueStandardized =<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td>      standardizeCSSValue(propertyName, expectedValue);<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td>  var actualValueStandardized =<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td>      standardizeCSSValue(propertyName, actualValue);<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td><tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>  _assert(commentArg(3, arguments),<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td>          expectedValueStandardized == actualValueStandardized,<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td>          goog.testing.asserts.getDefaultErrorMsg_(<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td>              expectedValueStandardized, actualValueStandardized));<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td>};<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td><tr><td><a id="l1013"></a><a href="#l1013">1013</a><td><tr><td><a id="l1014"></a><a href="#l1014">1014</a><td>/**<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td> * @param {*} a The expected value (2 args) or the debug message (3 args).<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td> * @param {*} b The actual value (2 args) or the expected value (3 args).<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td> * @param {*=} opt_c The actual value (3 args only).<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td> */<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td>var assertHashEquals = function(a, b, opt_c) {<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td>  _validateArguments(2, arguments);<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>  var var1 = nonCommentArg(1, 2, arguments);<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td>  var var2 = nonCommentArg(2, 2, arguments);<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td>  var message = commentArg(2, arguments);<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td>  for (var key in var1) {<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td>    _assert(message,<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>        key in var2, &#39;Expected hash had key &#39; + key + &#39; that was not found&#39;);<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>    _assert(message, var1[key] == var2[key], &#39;Value for key &#39; + key +<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>        &#39; mismatch - expected = &#39; + var1[key] + &#39;, actual = &#39; + var2[key]);<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td>  }<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td><tr><td><a id="l1031"></a><a href="#l1031">1031</a><td>  for (var key in var2) {<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td>    _assert(message, key in var1, &#39;Actual hash had key &#39; + key +<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>        &#39; that was not expected&#39;);<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>  }<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>};<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td><tr><td><a id="l1037"></a><a href="#l1037">1037</a><td><tr><td><a id="l1038"></a><a href="#l1038">1038</a><td>/**<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td> * @param {*} a The expected value (3 args) or the debug message (4 args).<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td> * @param {*} b The actual value (3 args) or the expected value (4 args).<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td> * @param {*} c The tolerance (3 args) or the actual value (4 args).<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td> * @param {*=} opt_d The tolerance (4 args only).<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td> */<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>var assertRoughlyEquals = function(a, b, c, opt_d) {<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td>  _validateArguments(3, arguments);<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td>  var expected = nonCommentArg(1, 3, arguments);<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td>  var actual = nonCommentArg(2, 3, arguments);<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>  var tolerance = nonCommentArg(3, 3, arguments);<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td>  _assert(commentArg(3, arguments),<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>      goog.testing.asserts.numberRoughEqualityPredicate_(<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td>          expected, actual, tolerance),<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td>      &#39;Expected &#39; + expected + &#39;, but got &#39; + actual +<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td>      &#39; which was more than &#39; + tolerance + &#39; away&#39;);<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td>};<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td><tr><td><a id="l1056"></a><a href="#l1056">1056</a><td><tr><td><a id="l1057"></a><a href="#l1057">1057</a><td>/**<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td> * Checks if the test value is a member of the given container.  Uses<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td> * container.indexOf as the underlying function, so this works for strings<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td> * and arrays.<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td> * @param {*} a Failure message (3 arguments) or the test value<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td> *     (2 arguments).<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td> * @param {*} b The test value (3 arguments) or the container<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td> *     (2 arguments).<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td> * @param {*=} opt_c The container.<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td> */<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>var assertContains = function(a, b, opt_c) {<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td>  _validateArguments(2, arguments);<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td>  var contained = nonCommentArg(1, 2, arguments);<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td>  var container = nonCommentArg(2, 2, arguments);<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td>  _assert(commentArg(2, arguments),<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td>      goog.testing.asserts.contains_(container, contained),<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td>      &#39;Expected \&#39;&#39; + container + &#39;\&#39; to contain \&#39;&#39; + contained + &#39;\&#39;&#39;);<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>};<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td><tr><td><a id="l1076"></a><a href="#l1076">1076</a><td><tr><td><a id="l1077"></a><a href="#l1077">1077</a><td>/**<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td> * Checks if the given element is not the member of the given container.<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td> * @param {*} a Failure message (3 arguments) or the contained element<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td> *     (2 arguments).<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td> * @param {*} b The contained element (3 arguments) or the container<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td> *     (2 arguments).<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td> * @param {*=} opt_c The container.<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td> */<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td>var assertNotContains = function(a, b, opt_c) {<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td>  _validateArguments(2, arguments);<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>  var contained = nonCommentArg(1, 2, arguments);<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>  var container = nonCommentArg(2, 2, arguments);<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>  _assert(commentArg(2, arguments),<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>      !goog.testing.asserts.contains_(container, contained),<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td>      &#39;Expected \&#39;&#39; + container + &#39;\&#39; not to contain \&#39;&#39; + contained + &#39;\&#39;&#39;);<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td>};<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td><tr><td><a id="l1094"></a><a href="#l1094">1094</a><td><tr><td><a id="l1095"></a><a href="#l1095">1095</a><td>/**<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td> * Checks if the given string matches the given regular expression.<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td> * @param {*} a Failure message (3 arguments) or the expected regular<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td> *     expression as a string or RegExp (2 arguments).<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td> * @param {*} b The regular expression (3 arguments) or the string to test<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td> *     (2 arguments).<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td> * @param {*=} opt_c The string to test.<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td> */<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td>var assertRegExp = function(a, b, opt_c) {<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td>  _validateArguments(2, arguments);<tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>  var regexp = nonCommentArg(1, 2, arguments);<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td>  var string = nonCommentArg(2, 2, arguments);<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td>  if (typeof(regexp) == &#39;string&#39;) {<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td>    regexp = new RegExp(regexp);<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td>  }<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td>  _assert(commentArg(2, arguments),<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td>      regexp.test(string),<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td>      &#39;Expected \&#39;&#39; + string + &#39;\&#39; to match RegExp &#39; + regexp.toString());<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td>};<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td><tr><td><a id="l1115"></a><a href="#l1115">1115</a><td><tr><td><a id="l1116"></a><a href="#l1116">1116</a><td>/**<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td> * Converts an array like object to array or clones it if it&#39;s already array.<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td> * @param {goog.testing.asserts.ArrayLike} arrayLike The collection.<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td> * @return {!Array&lt;?&gt;} Copy of the collection as array.<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td> * @private<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td> */<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td>goog.testing.asserts.toArray_ = function(arrayLike) {<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td>  var ret = [];<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td>  for (var i = 0; i &lt; arrayLike.length; i++) {<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td>    ret[i] = arrayLike[i];<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td>  }<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td>  return ret;<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td>};<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td><tr><td><a id="l1130"></a><a href="#l1130">1130</a><td><tr><td><a id="l1131"></a><a href="#l1131">1131</a><td>/**<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td> * Finds the position of the first occurrence of an element in a container.<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td> * @param {goog.testing.asserts.ArrayLike} container<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td> *     The array to find the element in.<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td> * @param {*} contained Element to find.<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td> * @return {number} Index of the first occurrence or -1 if not found.<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td> * @private<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td> */<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>goog.testing.asserts.indexOf_ = function(container, contained) {<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td>  if (container.indexOf) {<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td>    return container.indexOf(contained);<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>  } else {<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>    // IE6/7 do not have indexOf so do a search.<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td>    for (var i = 0; i &lt; container.length; i++) {<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>      if (container[i] === contained) {<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>        return i;<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td>      }<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td>    }<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td>    return -1;<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>  }<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td>};<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td><tr><td><a id="l1153"></a><a href="#l1153">1153</a><td><tr><td><a id="l1154"></a><a href="#l1154">1154</a><td>/**<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td> * Tells whether the array contains the given element.<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td> * @param {goog.testing.asserts.ArrayLike} container The array to<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td> *     find the element in.<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td> * @param {*} contained Element to find.<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td> * @return {boolean} Whether the element is in the array.<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td> * @private<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td> */<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td>goog.testing.asserts.contains_ = function(container, contained) {<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td>  // TODO(user): Can we check for container.contains as well?<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td>  // That would give us support for most goog.structs (though weird results<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>  // with anything else with a contains method, like goog.math.Range). Falling<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td>  // back with container.some would catch all iterables, too.<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>  return goog.testing.asserts.indexOf_(container, contained) != -1;<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td>};<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td><tr><td><a id="l1170"></a><a href="#l1170">1170</a><td>var standardizeHTML = function(html) {<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td>  var translator = document.createElement(&#39;DIV&#39;);<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td>  translator.innerHTML = html;<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td><tr><td><a id="l1174"></a><a href="#l1174">1174</a><td>  // Trim whitespace from result (without relying on goog.string)<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td>  return translator.innerHTML.replace(/^\s+|\s+$/g, &#39;&#39;);<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td>};<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td><tr><td><a id="l1178"></a><a href="#l1178">1178</a><td><tr><td><a id="l1179"></a><a href="#l1179">1179</a><td>/**<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td> * Standardizes a CSS value for a given property by applying it to an element<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td> * and then reading it back.<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td> * @param {string} propertyName CSS property name.<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td> * @param {string} value CSS value.<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td> * @return {string} Normalized CSS value.<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td> */<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td>var standardizeCSSValue = function(propertyName, value) {<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td>  var styleDeclaration = document.createElement(&#39;DIV&#39;).style;<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td>  styleDeclaration[propertyName] = value;<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td>  return styleDeclaration[propertyName];<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td>};<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td><tr><td><a id="l1192"></a><a href="#l1192">1192</a><td><tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>/**<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td> * Raises a JsUnit exception with the given comment.<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td> * @param {string} comment A summary for the exception.<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td> * @param {string=} opt_message A description of the exception.<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td> */<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td>goog.testing.asserts.raiseException = function(comment, opt_message) {<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td>  throw new goog.testing.JsUnitException(comment, opt_message);<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td>};<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td><tr><td><a id="l1202"></a><a href="#l1202">1202</a><td><tr><td><a id="l1203"></a><a href="#l1203">1203</a><td>/**<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td> * Helper function for assertObjectEquals.<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td> * @param {string} prop A property name.<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td> * @return {boolean} If the property name is an array index.<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td> * @private<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td> */<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td>goog.testing.asserts.isArrayIndexProp_ = function(prop) {<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td>  return (prop | 0) == prop;<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td>};<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td><tr><td><a id="l1213"></a><a href="#l1213">1213</a><td><tr><td><a id="l1214"></a><a href="#l1214">1214</a><td><tr><td><a id="l1215"></a><a href="#l1215">1215</a><td>/**<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td> * @param {string} comment A summary for the exception.<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td> * @param {?string=} opt_message A description of the exception.<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td> * @constructor<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td> * @extends {Error}<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td> * @final<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td> */<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>goog.testing.JsUnitException = function(comment, opt_message) {<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>  this.isJsUnitException = true;<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td>  this.message = (comment ? comment : &#39;&#39;) +<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td>                 (comment &amp;&amp; opt_message ? &#39;\n&#39; : &#39;&#39;) +<tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>                 (opt_message ? opt_message : &#39;&#39;);<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td>  this.stackTrace = goog.testing.stacktrace.get();<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td>  // These fields are for compatibility with jsUnitTestManager.<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td>  this.comment = comment || null;<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td>  this.jsUnitMessage = opt_message || &#39;&#39;;<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td><tr><td><a id="l1232"></a><a href="#l1232">1232</a><td>  // Ensure there is a stack trace.<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td>  if (Error.captureStackTrace) {<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td>    Error.captureStackTrace(this, goog.testing.JsUnitException);<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td>  } else {<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td>    this.stack = new Error().stack || &#39;&#39;;<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td>  }<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td>};<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>goog.inherits(goog.testing.JsUnitException, Error);<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td><tr><td><a id="l1241"></a><a href="#l1241">1241</a><td><tr><td><a id="l1242"></a><a href="#l1242">1242</a><td>/** @override */<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td>goog.testing.JsUnitException.prototype.toString = function() {<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td>  return this.message;<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td>};<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td><tr><td><a id="l1247"></a><a href="#l1247">1247</a><td><tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>goog.exportSymbol(&#39;fail&#39;, fail);<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>goog.exportSymbol(&#39;assert&#39;, assert);<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>goog.exportSymbol(&#39;assertThrows&#39;, assertThrows);<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>goog.exportSymbol(&#39;assertNotThrows&#39;, assertNotThrows);<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td>goog.exportSymbol(&#39;assertTrue&#39;, assertTrue);<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>goog.exportSymbol(&#39;assertFalse&#39;, assertFalse);<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td>goog.exportSymbol(&#39;assertEquals&#39;, assertEquals);<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td>goog.exportSymbol(&#39;assertNotEquals&#39;, assertNotEquals);<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td>goog.exportSymbol(&#39;assertNull&#39;, assertNull);<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td>goog.exportSymbol(&#39;assertNotNull&#39;, assertNotNull);<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td>goog.exportSymbol(&#39;assertUndefined&#39;, assertUndefined);<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td>goog.exportSymbol(&#39;assertNotUndefined&#39;, assertNotUndefined);<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td>goog.exportSymbol(&#39;assertNotNullNorUndefined&#39;, assertNotNullNorUndefined);<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td>goog.exportSymbol(&#39;assertNonEmptyString&#39;, assertNonEmptyString);<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td>goog.exportSymbol(&#39;assertNaN&#39;, assertNaN);<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td>goog.exportSymbol(&#39;assertNotNaN&#39;, assertNotNaN);<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>goog.exportSymbol(&#39;assertObjectEquals&#39;, assertObjectEquals);<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>goog.exportSymbol(&#39;assertObjectRoughlyEquals&#39;, assertObjectRoughlyEquals);<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>goog.exportSymbol(&#39;assertObjectNotEquals&#39;, assertObjectNotEquals);<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>goog.exportSymbol(&#39;assertArrayEquals&#39;, assertArrayEquals);<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td>goog.exportSymbol(&#39;assertElementsEquals&#39;, assertElementsEquals);<tr><td><a id="l1269"></a><a href="#l1269">1269</a><td>goog.exportSymbol(&#39;assertElementsRoughlyEqual&#39;, assertElementsRoughlyEqual);<tr><td><a id="l1270"></a><a href="#l1270">1270</a><td>goog.exportSymbol(&#39;assertSameElements&#39;, assertSameElements);<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td>goog.exportSymbol(&#39;assertEvaluatesToTrue&#39;, assertEvaluatesToTrue);<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td>goog.exportSymbol(&#39;assertEvaluatesToFalse&#39;, assertEvaluatesToFalse);<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td>goog.exportSymbol(&#39;assertHTMLEquals&#39;, assertHTMLEquals);<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td>goog.exportSymbol(&#39;assertHashEquals&#39;, assertHashEquals);<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td>goog.exportSymbol(&#39;assertRoughlyEquals&#39;, assertRoughlyEquals);<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td>goog.exportSymbol(&#39;assertContains&#39;, assertContains);<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td>goog.exportSymbol(&#39;assertNotContains&#39;, assertNotContains);<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>goog.exportSymbol(&#39;assertRegExp&#39;, assertRegExp);</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/asynctestcase.js.src.html b/docs/source/lib/goog/testing/asynctestcase.js.src.html
new file mode 100644
index 0000000..0c164e4
--- /dev/null
+++ b/docs/source/lib/goog/testing/asynctestcase.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>asynctestcase.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/testing/asynctestcase.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td>// All Rights Reserved.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview A class representing a set of test functions that use<tr><td><a name="l18" href="#l18">18</a><td> * asynchronous functions that cannot be meaningfully mocked.<tr><td><a name="l19" href="#l19">19</a><td> *<tr><td><a name="l20" href="#l20">20</a><td> * To create a Google-compatable JsUnit test using this test case, put the<tr><td><a name="l21" href="#l21">21</a><td> * following snippet in your test:<tr><td><a name="l22" href="#l22">22</a><td> *<tr><td><a name="l23" href="#l23">23</a><td> *   var asyncTestCase = goog.testing.AsyncTestCase.createAndInstall();<tr><td><a name="l24" href="#l24">24</a><td> *<tr><td><a name="l25" href="#l25">25</a><td> * To make the test runner wait for your asynchronous behaviour, use:<tr><td><a name="l26" href="#l26">26</a><td> *<tr><td><a name="l27" href="#l27">27</a><td> *   asyncTestCase.waitForAsync(&#39;Waiting for xhr to respond&#39;);<tr><td><a name="l28" href="#l28">28</a><td> *<tr><td><a name="l29" href="#l29">29</a><td> * The next test will not start until the following call is made, or a<tr><td><a name="l30" href="#l30">30</a><td> * timeout occurs:<tr><td><a name="l31" href="#l31">31</a><td> *<tr><td><a name="l32" href="#l32">32</a><td> *   asyncTestCase.continueTesting();<tr><td><a name="l33" href="#l33">33</a><td> *<tr><td><a name="l34" href="#l34">34</a><td> * There does NOT need to be a 1:1 mapping of waitForAsync calls and<tr><td><a name="l35" href="#l35">35</a><td> * continueTesting calls. The next test will be run after a single call to<tr><td><a name="l36" href="#l36">36</a><td> * continueTesting is made, as long as there is no subsequent call to<tr><td><a name="l37" href="#l37">37</a><td> * waitForAsync in the same thread.<tr><td><a name="l38" href="#l38">38</a><td> *<tr><td><a name="l39" href="#l39">39</a><td> * Example:<tr><td><a name="l40" href="#l40">40</a><td> *   // Returning here would cause the next test to be run.<tr><td><a name="l41" href="#l41">41</a><td> *   asyncTestCase.waitForAsync(&#39;description 1&#39;);<tr><td><a name="l42" href="#l42">42</a><td> *   // Returning here would *not* cause the next test to be run.<tr><td><a name="l43" href="#l43">43</a><td> *   // Only effect of additional waitForAsync() calls is an updated<tr><td><a name="l44" href="#l44">44</a><td> *   // description in the case of a timeout.<tr><td><a name="l45" href="#l45">45</a><td> *   asyncTestCase.waitForAsync(&#39;updated description&#39;);<tr><td><a name="l46" href="#l46">46</a><td> *   asyncTestCase.continueTesting();<tr><td><a name="l47" href="#l47">47</a><td> *   // Returning here would cause the next test to be run.<tr><td><a name="l48" href="#l48">48</a><td> *   asyncTestCase.waitForAsync(&#39;just kidding, still running.&#39;);<tr><td><a name="l49" href="#l49">49</a><td> *   // Returning here would *not* cause the next test to be run.<tr><td><a name="l50" href="#l50">50</a><td> *<tr><td><a name="l51" href="#l51">51</a><td> * The test runner can also be made to wait for more than one asynchronous<tr><td><a name="l52" href="#l52">52</a><td> * event with:<tr><td><a name="l53" href="#l53">53</a><td> *<tr><td><a name="l54" href="#l54">54</a><td> *   asyncTestCase.waitForSignals(n);<tr><td><a name="l55" href="#l55">55</a><td> *<tr><td><a name="l56" href="#l56">56</a><td> * The next test will not start until asyncTestCase.signal() is called n times,<tr><td><a name="l57" href="#l57">57</a><td> * or the test step timeout is exceeded.<tr><td><a name="l58" href="#l58">58</a><td> *<tr><td><a name="l59" href="#l59">59</a><td> * This class supports asynchronous behaviour in all test functions except for<tr><td><a name="l60" href="#l60">60</a><td> * tearDownPage. If such support is needed, it can be added.<tr><td><a name="l61" href="#l61">61</a><td> *<tr><td><a name="l62" href="#l62">62</a><td> * Example Usage:<tr><td><a name="l63" href="#l63">63</a><td> *<tr><td><a name="l64" href="#l64">64</a><td> *   var asyncTestCase = goog.testing.AsyncTestCase.createAndInstall();<tr><td><a name="l65" href="#l65">65</a><td> *   // Optionally, set a longer-than-normal step timeout.<tr><td><a name="l66" href="#l66">66</a><td> *   asyncTestCase.stepTimeout = 30 * 1000;<tr><td><a name="l67" href="#l67">67</a><td> *<tr><td><a name="l68" href="#l68">68</a><td> *   function testSetTimeout() {<tr><td><a name="l69" href="#l69">69</a><td> *     var step = 0;<tr><td><a name="l70" href="#l70">70</a><td> *     function stepCallback() {<tr><td><a name="l71" href="#l71">71</a><td> *       step++;<tr><td><a name="l72" href="#l72">72</a><td> *       switch (step) {<tr><td><a name="l73" href="#l73">73</a><td> *         case 1:<tr><td><a name="l74" href="#l74">74</a><td> *           var startTime = goog.now();<tr><td><a name="l75" href="#l75">75</a><td> *           asyncTestCase.waitForAsync(&#39;step 1&#39;);<tr><td><a name="l76" href="#l76">76</a><td> *           window.setTimeout(stepCallback, 100);<tr><td><a name="l77" href="#l77">77</a><td> *           break;<tr><td><a name="l78" href="#l78">78</a><td> *         case 2:<tr><td><a name="l79" href="#l79">79</a><td> *           assertTrue(&#39;Timeout fired too soon&#39;,<tr><td><a name="l80" href="#l80">80</a><td> *               goog.now() - startTime &gt;= 100);<tr><td><a name="l81" href="#l81">81</a><td> *           asyncTestCase.waitForAsync(&#39;step 2&#39;);<tr><td><a name="l82" href="#l82">82</a><td> *           window.setTimeout(stepCallback, 100);<tr><td><a name="l83" href="#l83">83</a><td> *           break;<tr><td><a name="l84" href="#l84">84</a><td> *         case 3:<tr><td><a name="l85" href="#l85">85</a><td> *           assertTrue(&#39;Timeout fired too soon&#39;,<tr><td><a name="l86" href="#l86">86</a><td> *               goog.now() - startTime &gt;= 200);<tr><td><a name="l87" href="#l87">87</a><td> *           asyncTestCase.continueTesting();<tr><td><a name="l88" href="#l88">88</a><td> *           break;<tr><td><a name="l89" href="#l89">89</a><td> *         default:<tr><td><a name="l90" href="#l90">90</a><td> *           fail(&#39;Unexpected call to stepCallback&#39;);<tr><td><a name="l91" href="#l91">91</a><td> *       }<tr><td><a name="l92" href="#l92">92</a><td> *     }<tr><td><a name="l93" href="#l93">93</a><td> *     stepCallback();<tr><td><a name="l94" href="#l94">94</a><td> *   }<tr><td><a name="l95" href="#l95">95</a><td> *<tr><td><a name="l96" href="#l96">96</a><td> * Known Issues:<tr><td><a name="l97" href="#l97">97</a><td> *   IE7 Exceptions:<tr><td><a name="l98" href="#l98">98</a><td> *     As the failingtest.html will show, it appears as though ie7 does not<tr><td><a name="l99" href="#l99">99</a><td> *     propagate an exception past a function called using the func.call()<tr><td><a name="l100" href="#l100">100</a><td> *     syntax. This causes case 3 of the failing tests (exceptions) to show up<tr><td><a name="l101" href="#l101">101</a><td> *     as timeouts in IE.<tr><td><a name="l102" href="#l102">102</a><td> *   window.onerror:<tr><td><a name="l103" href="#l103">103</a><td> *     This seems to catch errors only in ff2/ff3. It does not work in Safari or<tr><td><a name="l104" href="#l104">104</a><td> *     IE7. The consequence of this is that exceptions that would have been<tr><td><a name="l105" href="#l105">105</a><td> *     caught by window.onerror show up as timeouts.<tr><td><a name="l106" href="#l106">106</a><td> *<tr><td><a name="l107" href="#l107">107</a><td> * @author agrieve@google.com (Andrew Grieve)<tr><td><a name="l108" href="#l108">108</a><td> */<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>goog.provide(&#39;goog.testing.AsyncTestCase&#39;);<tr><td><a name="l111" href="#l111">111</a><td>goog.provide(&#39;goog.testing.AsyncTestCase.ControlBreakingException&#39;);<tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td>goog.require(&#39;goog.testing.TestCase&#39;);<tr><td><a name="l114" href="#l114">114</a><td>goog.require(&#39;goog.testing.TestCase.Test&#39;);<tr><td><a name="l115" href="#l115">115</a><td>goog.require(&#39;goog.testing.asserts&#39;);<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td><tr><td><a name="l119" href="#l119">119</a><td>/**<tr><td><a name="l120" href="#l120">120</a><td> * A test case that is capable of running tests the contain asynchronous logic.<tr><td><a name="l121" href="#l121">121</a><td> * @param {string=} opt_name A descriptive name for the test case.<tr><td><a name="l122" href="#l122">122</a><td> * @extends {goog.testing.TestCase}<tr><td><a name="l123" href="#l123">123</a><td> * @constructor<tr><td><a name="l124" href="#l124">124</a><td> */<tr><td><a name="l125" href="#l125">125</a><td>goog.testing.AsyncTestCase = function(opt_name) {<tr><td><a name="l126" href="#l126">126</a><td>  goog.testing.TestCase.call(this, opt_name);<tr><td><a name="l127" href="#l127">127</a><td>};<tr><td><a name="l128" href="#l128">128</a><td>goog.inherits(goog.testing.AsyncTestCase, goog.testing.TestCase);<tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td>/**<tr><td><a name="l132" href="#l132">132</a><td> * Represents result of top stack function call.<tr><td><a name="l133" href="#l133">133</a><td> * @typedef {{controlBreakingExceptionThrown: boolean, message: string}}<tr><td><a name="l134" href="#l134">134</a><td> * @private<tr><td><a name="l135" href="#l135">135</a><td> */<tr><td><a name="l136" href="#l136">136</a><td>goog.testing.AsyncTestCase.TopStackFuncResult_;<tr><td><a name="l137" href="#l137">137</a><td><tr><td><a name="l138" href="#l138">138</a><td><tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td>/**<tr><td><a name="l141" href="#l141">141</a><td> * An exception class used solely for control flow.<tr><td><a name="l142" href="#l142">142</a><td> * @param {string=} opt_message Error message.<tr><td><a name="l143" href="#l143">143</a><td> * @constructor<tr><td><a name="l144" href="#l144">144</a><td> * @final<tr><td><a name="l145" href="#l145">145</a><td> */<tr><td><a name="l146" href="#l146">146</a><td>goog.testing.AsyncTestCase.ControlBreakingException = function(opt_message) {<tr><td><a name="l147" href="#l147">147</a><td>  /**<tr><td><a name="l148" href="#l148">148</a><td>   * The exception message.<tr><td><a name="l149" href="#l149">149</a><td>   * @type {string}<tr><td><a name="l150" href="#l150">150</a><td>   */<tr><td><a name="l151" href="#l151">151</a><td>  this.message = opt_message || &#39;&#39;;<tr><td><a name="l152" href="#l152">152</a><td>};<tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td>/**<tr><td><a name="l156" href="#l156">156</a><td> * Return value for .toString().<tr><td><a name="l157" href="#l157">157</a><td> * @type {string}<tr><td><a name="l158" href="#l158">158</a><td> */<tr><td><a name="l159" href="#l159">159</a><td>goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING =<tr><td><a name="l160" href="#l160">160</a><td>    &#39;[AsyncTestCase.ControlBreakingException]&#39;;<tr><td><a name="l161" href="#l161">161</a><td><tr><td><a name="l162" href="#l162">162</a><td><tr><td><a name="l163" href="#l163">163</a><td>/**<tr><td><a name="l164" href="#l164">164</a><td> * Marks this object as a ControlBreakingException<tr><td><a name="l165" href="#l165">165</a><td> * @type {boolean}<tr><td><a name="l166" href="#l166">166</a><td> */<tr><td><a name="l167" href="#l167">167</a><td>goog.testing.AsyncTestCase.ControlBreakingException.prototype.<tr><td><a name="l168" href="#l168">168</a><td>    isControlBreakingException = true;<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/** @override */<tr><td><a name="l172" href="#l172">172</a><td>goog.testing.AsyncTestCase.ControlBreakingException.prototype.toString =<tr><td><a name="l173" href="#l173">173</a><td>    function() {<tr><td><a name="l174" href="#l174">174</a><td>  // This shows up in the console when the exception is not caught.<tr><td><a name="l175" href="#l175">175</a><td>  return goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING;<tr><td><a name="l176" href="#l176">176</a><td>};<tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>/**<tr><td><a name="l180" href="#l180">180</a><td> * How long to wait for a single step of a test to complete in milliseconds.<tr><td><a name="l181" href="#l181">181</a><td> * A step starts when a call to waitForAsync() is made.<tr><td><a name="l182" href="#l182">182</a><td> * @type {number}<tr><td><a name="l183" href="#l183">183</a><td> */<tr><td><a name="l184" href="#l184">184</a><td>goog.testing.AsyncTestCase.prototype.stepTimeout = 1000;<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td>/**<tr><td><a name="l188" href="#l188">188</a><td> * How long to wait after a failed test before moving onto the next one.<tr><td><a name="l189" href="#l189">189</a><td> * The purpose of this is to allow any pending async callbacks from the failing<tr><td><a name="l190" href="#l190">190</a><td> * test to finish up and not cause the next test to fail.<tr><td><a name="l191" href="#l191">191</a><td> * @type {number}<tr><td><a name="l192" href="#l192">192</a><td> */<tr><td><a name="l193" href="#l193">193</a><td>goog.testing.AsyncTestCase.prototype.timeToSleepAfterFailure = 500;<tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td><tr><td><a name="l196" href="#l196">196</a><td>/**<tr><td><a name="l197" href="#l197">197</a><td> * Turn on extra logging to help debug failing async. tests.<tr><td><a name="l198" href="#l198">198</a><td> * @type {boolean}<tr><td><a name="l199" href="#l199">199</a><td> * @private<tr><td><a name="l200" href="#l200">200</a><td> */<tr><td><a name="l201" href="#l201">201</a><td>goog.testing.AsyncTestCase.prototype.enableDebugLogs_ = false;<tr><td><a name="l202" href="#l202">202</a><td><tr><td><a name="l203" href="#l203">203</a><td><tr><td><a name="l204" href="#l204">204</a><td>/**<tr><td><a name="l205" href="#l205">205</a><td> * A reference to the original asserts.js assert_() function.<tr><td><a name="l206" href="#l206">206</a><td> * @private<tr><td><a name="l207" href="#l207">207</a><td> */<tr><td><a name="l208" href="#l208">208</a><td>goog.testing.AsyncTestCase.prototype.origAssert_;<tr><td><a name="l209" href="#l209">209</a><td><tr><td><a name="l210" href="#l210">210</a><td><tr><td><a name="l211" href="#l211">211</a><td>/**<tr><td><a name="l212" href="#l212">212</a><td> * A reference to the original asserts.js fail() function.<tr><td><a name="l213" href="#l213">213</a><td> * @private<tr><td><a name="l214" href="#l214">214</a><td> */<tr><td><a name="l215" href="#l215">215</a><td>goog.testing.AsyncTestCase.prototype.origFail_;<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * A reference to the original window.onerror function.<tr><td><a name="l220" href="#l220">220</a><td> * @type {Function|undefined}<tr><td><a name="l221" href="#l221">221</a><td> * @private<tr><td><a name="l222" href="#l222">222</a><td> */<tr><td><a name="l223" href="#l223">223</a><td>goog.testing.AsyncTestCase.prototype.origOnError_;<tr><td><a name="l224" href="#l224">224</a><td><tr><td><a name="l225" href="#l225">225</a><td><tr><td><a name="l226" href="#l226">226</a><td>/**<tr><td><a name="l227" href="#l227">227</a><td> * The stage of the test we are currently on.<tr><td><a name="l228" href="#l228">228</a><td> * @type {Function|undefined}}<tr><td><a name="l229" href="#l229">229</a><td> * @private<tr><td><a name="l230" href="#l230">230</a><td> */<tr><td><a name="l231" href="#l231">231</a><td>goog.testing.AsyncTestCase.prototype.curStepFunc_;<tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td>/**<tr><td><a name="l235" href="#l235">235</a><td> * The name of the stage of the test we are currently on.<tr><td><a name="l236" href="#l236">236</a><td> * @type {string}<tr><td><a name="l237" href="#l237">237</a><td> * @private<tr><td><a name="l238" href="#l238">238</a><td> */<tr><td><a name="l239" href="#l239">239</a><td>goog.testing.AsyncTestCase.prototype.curStepName_ = &#39;&#39;;<tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td><tr><td><a name="l242" href="#l242">242</a><td>/**<tr><td><a name="l243" href="#l243">243</a><td> * The stage of the test we should run next.<tr><td><a name="l244" href="#l244">244</a><td> * @type {Function|undefined}<tr><td><a name="l245" href="#l245">245</a><td> * @private<tr><td><a name="l246" href="#l246">246</a><td> */<tr><td><a name="l247" href="#l247">247</a><td>goog.testing.AsyncTestCase.prototype.nextStepFunc;<tr><td><a name="l248" href="#l248">248</a><td><tr><td><a name="l249" href="#l249">249</a><td><tr><td><a name="l250" href="#l250">250</a><td>/**<tr><td><a name="l251" href="#l251">251</a><td> * The name of the stage of the test we should run next.<tr><td><a name="l252" href="#l252">252</a><td> * @type {string}<tr><td><a name="l253" href="#l253">253</a><td> * @private<tr><td><a name="l254" href="#l254">254</a><td> */<tr><td><a name="l255" href="#l255">255</a><td>goog.testing.AsyncTestCase.prototype.nextStepName_ = &#39;&#39;;<tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td><tr><td><a name="l258" href="#l258">258</a><td>/**<tr><td><a name="l259" href="#l259">259</a><td> * The handle to the current setTimeout timer.<tr><td><a name="l260" href="#l260">260</a><td> * @type {number}<tr><td><a name="l261" href="#l261">261</a><td> * @private<tr><td><a name="l262" href="#l262">262</a><td> */<tr><td><a name="l263" href="#l263">263</a><td>goog.testing.AsyncTestCase.prototype.timeoutHandle_ = 0;<tr><td><a name="l264" href="#l264">264</a><td><tr><td><a name="l265" href="#l265">265</a><td><tr><td><a name="l266" href="#l266">266</a><td>/**<tr><td><a name="l267" href="#l267">267</a><td> * Marks if the cleanUp() function has been called for the currently running<tr><td><a name="l268" href="#l268">268</a><td> * test.<tr><td><a name="l269" href="#l269">269</a><td> * @type {boolean}<tr><td><a name="l270" href="#l270">270</a><td> * @private<tr><td><a name="l271" href="#l271">271</a><td> */<tr><td><a name="l272" href="#l272">272</a><td>goog.testing.AsyncTestCase.prototype.cleanedUp_ = false;<tr><td><a name="l273" href="#l273">273</a><td><tr><td><a name="l274" href="#l274">274</a><td><tr><td><a name="l275" href="#l275">275</a><td>/**<tr><td><a name="l276" href="#l276">276</a><td> * The currently active test.<tr><td><a name="l277" href="#l277">277</a><td> * @type {goog.testing.TestCase.Test|undefined}<tr><td><a name="l278" href="#l278">278</a><td> * @protected<tr><td><a name="l279" href="#l279">279</a><td> */<tr><td><a name="l280" href="#l280">280</a><td>goog.testing.AsyncTestCase.prototype.activeTest;<tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td><tr><td><a name="l283" href="#l283">283</a><td>/**<tr><td><a name="l284" href="#l284">284</a><td> * A flag to prevent recursive exception handling.<tr><td><a name="l285" href="#l285">285</a><td> * @type {boolean}<tr><td><a name="l286" href="#l286">286</a><td> * @private<tr><td><a name="l287" href="#l287">287</a><td> */<tr><td><a name="l288" href="#l288">288</a><td>goog.testing.AsyncTestCase.prototype.inException_ = false;<tr><td><a name="l289" href="#l289">289</a><td><tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td>/**<tr><td><a name="l292" href="#l292">292</a><td> * Flag used to determine if we can move to the next step in the testing loop.<tr><td><a name="l293" href="#l293">293</a><td> * @type {boolean}<tr><td><a name="l294" href="#l294">294</a><td> * @private<tr><td><a name="l295" href="#l295">295</a><td> */<tr><td><a name="l296" href="#l296">296</a><td>goog.testing.AsyncTestCase.prototype.isReady_ = true;<tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td><tr><td><a name="l299" href="#l299">299</a><td>/**<tr><td><a name="l300" href="#l300">300</a><td> * Number of signals to wait for before continuing testing when waitForSignals<tr><td><a name="l301" href="#l301">301</a><td> * is used.<tr><td><a name="l302" href="#l302">302</a><td> * @type {number}<tr><td><a name="l303" href="#l303">303</a><td> * @private<tr><td><a name="l304" href="#l304">304</a><td> */<tr><td><a name="l305" href="#l305">305</a><td>goog.testing.AsyncTestCase.prototype.expectedSignalCount_ = 0;<tr><td><a name="l306" href="#l306">306</a><td><tr><td><a name="l307" href="#l307">307</a><td><tr><td><a name="l308" href="#l308">308</a><td>/**<tr><td><a name="l309" href="#l309">309</a><td> * Number of signals received.<tr><td><a name="l310" href="#l310">310</a><td> * @type {number}<tr><td><a name="l311" href="#l311">311</a><td> * @private<tr><td><a name="l312" href="#l312">312</a><td> */<tr><td><a name="l313" href="#l313">313</a><td>goog.testing.AsyncTestCase.prototype.receivedSignalCount_ = 0;<tr><td><a name="l314" href="#l314">314</a><td><tr><td><a name="l315" href="#l315">315</a><td><tr><td><a name="l316" href="#l316">316</a><td>/**<tr><td><a name="l317" href="#l317">317</a><td> * Flag that tells us if there is a function in the call stack that will make<tr><td><a name="l318" href="#l318">318</a><td> * a call to pump_().<tr><td><a name="l319" href="#l319">319</a><td> * @type {boolean}<tr><td><a name="l320" href="#l320">320</a><td> * @private<tr><td><a name="l321" href="#l321">321</a><td> */<tr><td><a name="l322" href="#l322">322</a><td>goog.testing.AsyncTestCase.prototype.returnWillPump_ = false;<tr><td><a name="l323" href="#l323">323</a><td><tr><td><a name="l324" href="#l324">324</a><td><tr><td><a name="l325" href="#l325">325</a><td>/**<tr><td><a name="l326" href="#l326">326</a><td> * The number of times we have thrown a ControlBreakingException so that we<tr><td><a name="l327" href="#l327">327</a><td> * know not to complain in our window.onerror handler. In Webkit, window.onerror<tr><td><a name="l328" href="#l328">328</a><td> * is not supported, and so this counter will keep going up but we won&#39;t care<tr><td><a name="l329" href="#l329">329</a><td> * about it.<tr><td><a name="l330" href="#l330">330</a><td> * @type {number}<tr><td><a name="l331" href="#l331">331</a><td> * @private<tr><td><a name="l332" href="#l332">332</a><td> */<tr><td><a name="l333" href="#l333">333</a><td>goog.testing.AsyncTestCase.prototype.numControlExceptionsExpected_ = 0;<tr><td><a name="l334" href="#l334">334</a><td><tr><td><a name="l335" href="#l335">335</a><td><tr><td><a name="l336" href="#l336">336</a><td>/**<tr><td><a name="l337" href="#l337">337</a><td> * The current step name.<tr><td><a name="l338" href="#l338">338</a><td> * @return {!string} Step name.<tr><td><a name="l339" href="#l339">339</a><td> * @protected<tr><td><a name="l340" href="#l340">340</a><td> */<tr><td><a name="l341" href="#l341">341</a><td>goog.testing.AsyncTestCase.prototype.getCurrentStepName = function() {<tr><td><a name="l342" href="#l342">342</a><td>  return this.curStepName_;<tr><td><a name="l343" href="#l343">343</a><td>};<tr><td><a name="l344" href="#l344">344</a><td><tr><td><a name="l345" href="#l345">345</a><td><tr><td><a name="l346" href="#l346">346</a><td>/**<tr><td><a name="l347" href="#l347">347</a><td> * Preferred way of creating an AsyncTestCase. Creates one and initializes it<tr><td><a name="l348" href="#l348">348</a><td> * with the G_testRunner.<tr><td><a name="l349" href="#l349">349</a><td> * @param {string=} opt_name A descriptive name for the test case.<tr><td><a name="l350" href="#l350">350</a><td> * @return {!goog.testing.AsyncTestCase} The created AsyncTestCase.<tr><td><a name="l351" href="#l351">351</a><td> */<tr><td><a name="l352" href="#l352">352</a><td>goog.testing.AsyncTestCase.createAndInstall = function(opt_name) {<tr><td><a name="l353" href="#l353">353</a><td>  var asyncTestCase = new goog.testing.AsyncTestCase(opt_name);<tr><td><a name="l354" href="#l354">354</a><td>  goog.testing.TestCase.initializeTestRunner(asyncTestCase);<tr><td><a name="l355" href="#l355">355</a><td>  return asyncTestCase;<tr><td><a name="l356" href="#l356">356</a><td>};<tr><td><a name="l357" href="#l357">357</a><td><tr><td><a name="l358" href="#l358">358</a><td><tr><td><a name="l359" href="#l359">359</a><td>/**<tr><td><a name="l360" href="#l360">360</a><td> * Informs the testcase not to continue to the next step in the test cycle<tr><td><a name="l361" href="#l361">361</a><td> * until continueTesting is called.<tr><td><a name="l362" href="#l362">362</a><td> * @param {string=} opt_name A description of what we are waiting for.<tr><td><a name="l363" href="#l363">363</a><td> */<tr><td><a name="l364" href="#l364">364</a><td>goog.testing.AsyncTestCase.prototype.waitForAsync = function(opt_name) {<tr><td><a name="l365" href="#l365">365</a><td>  this.isReady_ = false;<tr><td><a name="l366" href="#l366">366</a><td>  this.curStepName_ = opt_name || this.curStepName_;<tr><td><a name="l367" href="#l367">367</a><td><tr><td><a name="l368" href="#l368">368</a><td>  // Reset the timer that tracks if the async test takes too long.<tr><td><a name="l369" href="#l369">369</a><td>  this.stopTimeoutTimer_();<tr><td><a name="l370" href="#l370">370</a><td>  this.startTimeoutTimer_();<tr><td><a name="l371" href="#l371">371</a><td>};<tr><td><a name="l372" href="#l372">372</a><td><tr><td><a name="l373" href="#l373">373</a><td><tr><td><a name="l374" href="#l374">374</a><td>/**<tr><td><a name="l375" href="#l375">375</a><td> * Continue with the next step in the test cycle.<tr><td><a name="l376" href="#l376">376</a><td> */<tr><td><a name="l377" href="#l377">377</a><td>goog.testing.AsyncTestCase.prototype.continueTesting = function() {<tr><td><a name="l378" href="#l378">378</a><td>  if (this.receivedSignalCount_ &lt; this.expectedSignalCount_) {<tr><td><a name="l379" href="#l379">379</a><td>    var remaining = this.expectedSignalCount_ - this.receivedSignalCount_;<tr><td><a name="l380" href="#l380">380</a><td>    throw Error(&#39;Still waiting for &#39; + remaining + &#39; signals.&#39;);<tr><td><a name="l381" href="#l381">381</a><td>  }<tr><td><a name="l382" href="#l382">382</a><td>  this.endCurrentStep_();<tr><td><a name="l383" href="#l383">383</a><td>};<tr><td><a name="l384" href="#l384">384</a><td><tr><td><a name="l385" href="#l385">385</a><td><tr><td><a name="l386" href="#l386">386</a><td>/**<tr><td><a name="l387" href="#l387">387</a><td> * Ends the current test step and queues the next test step to run.<tr><td><a name="l388" href="#l388">388</a><td> * @private<tr><td><a name="l389" href="#l389">389</a><td> */<tr><td><a name="l390" href="#l390">390</a><td>goog.testing.AsyncTestCase.prototype.endCurrentStep_ = function() {<tr><td><a name="l391" href="#l391">391</a><td>  if (!this.isReady_) {<tr><td><a name="l392" href="#l392">392</a><td>    // We are a potential entry point, so we pump.<tr><td><a name="l393" href="#l393">393</a><td>    this.isReady_ = true;<tr><td><a name="l394" href="#l394">394</a><td>    this.stopTimeoutTimer_();<tr><td><a name="l395" href="#l395">395</a><td>    // Run this in a setTimeout so that the caller has a chance to call<tr><td><a name="l396" href="#l396">396</a><td>    // waitForAsync() again before we continue.<tr><td><a name="l397" href="#l397">397</a><td>    this.timeout(goog.bind(this.pump_, this, null), 0);<tr><td><a name="l398" href="#l398">398</a><td>  }<tr><td><a name="l399" href="#l399">399</a><td>};<tr><td><a name="l400" href="#l400">400</a><td><tr><td><a name="l401" href="#l401">401</a><td><tr><td><a name="l402" href="#l402">402</a><td>/**<tr><td><a name="l403" href="#l403">403</a><td> * Informs the testcase not to continue to the next step in the test cycle<tr><td><a name="l404" href="#l404">404</a><td> * until signal is called the specified number of times. Within a test, this<tr><td><a name="l405" href="#l405">405</a><td> * function behaves additively if called multiple times; the number of signals<tr><td><a name="l406" href="#l406">406</a><td> * to wait for will be the sum of all expected number of signals this function<tr><td><a name="l407" href="#l407">407</a><td> * was called with.<tr><td><a name="l408" href="#l408">408</a><td> * @param {number} times The number of signals to receive before<tr><td><a name="l409" href="#l409">409</a><td> *    continuing testing.<tr><td><a name="l410" href="#l410">410</a><td> * @param {string=} opt_name A description of what we are waiting for.<tr><td><a name="l411" href="#l411">411</a><td> */<tr><td><a name="l412" href="#l412">412</a><td>goog.testing.AsyncTestCase.prototype.waitForSignals =<tr><td><a name="l413" href="#l413">413</a><td>    function(times, opt_name) {<tr><td><a name="l414" href="#l414">414</a><td>  this.expectedSignalCount_ += times;<tr><td><a name="l415" href="#l415">415</a><td>  if (this.receivedSignalCount_ &lt; this.expectedSignalCount_) {<tr><td><a name="l416" href="#l416">416</a><td>    this.waitForAsync(opt_name);<tr><td><a name="l417" href="#l417">417</a><td>  }<tr><td><a name="l418" href="#l418">418</a><td>};<tr><td><a name="l419" href="#l419">419</a><td><tr><td><a name="l420" href="#l420">420</a><td><tr><td><a name="l421" href="#l421">421</a><td>/**<tr><td><a name="l422" href="#l422">422</a><td> * Signals once to continue with the test. If this is the last signal that the<tr><td><a name="l423" href="#l423">423</a><td> * test was waiting on, call continueTesting.<tr><td><a name="l424" href="#l424">424</a><td> */<tr><td><a name="l425" href="#l425">425</a><td>goog.testing.AsyncTestCase.prototype.signal = function() {<tr><td><a name="l426" href="#l426">426</a><td>  if (++this.receivedSignalCount_ === this.expectedSignalCount_ &amp;&amp;<tr><td><a name="l427" href="#l427">427</a><td>      this.expectedSignalCount_ &gt; 0) {<tr><td><a name="l428" href="#l428">428</a><td>    this.endCurrentStep_();<tr><td><a name="l429" href="#l429">429</a><td>  }<tr><td><a name="l430" href="#l430">430</a><td>};<tr><td><a name="l431" href="#l431">431</a><td><tr><td><a name="l432" href="#l432">432</a><td><tr><td><a name="l433" href="#l433">433</a><td>/**<tr><td><a name="l434" href="#l434">434</a><td> * Handles an exception thrown by a test.<tr><td><a name="l435" href="#l435">435</a><td> * @param {*=} opt_e The exception object associated with the failure<tr><td><a name="l436" href="#l436">436</a><td> *     or a string.<tr><td><a name="l437" href="#l437">437</a><td> * @throws Always throws a ControlBreakingException.<tr><td><a name="l438" href="#l438">438</a><td> */<tr><td><a name="l439" href="#l439">439</a><td>goog.testing.AsyncTestCase.prototype.doAsyncError = function(opt_e) {<tr><td><a name="l440" href="#l440">440</a><td>  // If we&#39;ve caught an exception that we threw, then just pass it along. This<tr><td><a name="l441" href="#l441">441</a><td>  // can happen if doAsyncError() was called from a call to assert and then<tr><td><a name="l442" href="#l442">442</a><td>  // again by pump_().<tr><td><a name="l443" href="#l443">443</a><td>  if (opt_e &amp;&amp; opt_e.isControlBreakingException) {<tr><td><a name="l444" href="#l444">444</a><td>    throw opt_e;<tr><td><a name="l445" href="#l445">445</a><td>  }<tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td>  // Prevent another timeout error from triggering for this test step.<tr><td><a name="l448" href="#l448">448</a><td>  this.stopTimeoutTimer_();<tr><td><a name="l449" href="#l449">449</a><td><tr><td><a name="l450" href="#l450">450</a><td>  // doError() uses test.name. Here, we create a dummy test and give it a more<tr><td><a name="l451" href="#l451">451</a><td>  // helpful name based on the step we&#39;re currently on.<tr><td><a name="l452" href="#l452">452</a><td>  var fakeTestObj = new goog.testing.TestCase.Test(this.curStepName_,<tr><td><a name="l453" href="#l453">453</a><td>                                                   goog.nullFunction);<tr><td><a name="l454" href="#l454">454</a><td>  if (this.activeTest) {<tr><td><a name="l455" href="#l455">455</a><td>    fakeTestObj.name = this.activeTest.name + &#39; [&#39; + fakeTestObj.name + &#39;]&#39;;<tr><td><a name="l456" href="#l456">456</a><td>  }<tr><td><a name="l457" href="#l457">457</a><td><tr><td><a name="l458" href="#l458">458</a><td>  if (this.activeTest) {<tr><td><a name="l459" href="#l459">459</a><td>    // Note: if the test has an error, and then tearDown has an error, they will<tr><td><a name="l460" href="#l460">460</a><td>    // both be reported.<tr><td><a name="l461" href="#l461">461</a><td>    this.doError(fakeTestObj, opt_e);<tr><td><a name="l462" href="#l462">462</a><td>  } else {<tr><td><a name="l463" href="#l463">463</a><td>    this.exceptionBeforeTest = opt_e;<tr><td><a name="l464" href="#l464">464</a><td>  }<tr><td><a name="l465" href="#l465">465</a><td><tr><td><a name="l466" href="#l466">466</a><td>  // This is a potential entry point, so we pump. We also add in a bit of a<tr><td><a name="l467" href="#l467">467</a><td>  // delay to try and prevent any async behavior from the failed test from<tr><td><a name="l468" href="#l468">468</a><td>  // causing the next test to fail.<tr><td><a name="l469" href="#l469">469</a><td>  this.timeout(goog.bind(this.pump_, this, this.doAsyncErrorTearDown_),<tr><td><a name="l470" href="#l470">470</a><td>      this.timeToSleepAfterFailure);<tr><td><a name="l471" href="#l471">471</a><td><tr><td><a name="l472" href="#l472">472</a><td>  // We just caught an exception, so we do not want the code above us on the<tr><td><a name="l473" href="#l473">473</a><td>  // stack to continue executing. If pump_ is in our call-stack, then it will<tr><td><a name="l474" href="#l474">474</a><td>  // batch together multiple errors, so we only increment the count if pump_ is<tr><td><a name="l475" href="#l475">475</a><td>  // not in the stack and let pump_ increment the count when it batches them.<tr><td><a name="l476" href="#l476">476</a><td>  if (!this.returnWillPump_) {<tr><td><a name="l477" href="#l477">477</a><td>    this.numControlExceptionsExpected_ += 1;<tr><td><a name="l478" href="#l478">478</a><td>    this.dbgLog_(&#39;doAsynError: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l479" href="#l479">479</a><td>        this.numControlExceptionsExpected_ + &#39; and throwing exception.&#39;);<tr><td><a name="l480" href="#l480">480</a><td>  }<tr><td><a name="l481" href="#l481">481</a><td><tr><td><a name="l482" href="#l482">482</a><td>  // Copy the error message to ControlBreakingException.<tr><td><a name="l483" href="#l483">483</a><td>  var message = &#39;&#39;;<tr><td><a name="l484" href="#l484">484</a><td>  if (typeof opt_e == &#39;string&#39;) {<tr><td><a name="l485" href="#l485">485</a><td>    message = opt_e;<tr><td><a name="l486" href="#l486">486</a><td>  } else if (opt_e &amp;&amp; opt_e.message) {<tr><td><a name="l487" href="#l487">487</a><td>    message = opt_e.message;<tr><td><a name="l488" href="#l488">488</a><td>  }<tr><td><a name="l489" href="#l489">489</a><td>  throw new goog.testing.AsyncTestCase.ControlBreakingException(message);<tr><td><a name="l490" href="#l490">490</a><td>};<tr><td><a name="l491" href="#l491">491</a><td><tr><td><a name="l492" href="#l492">492</a><td><tr><td><a name="l493" href="#l493">493</a><td>/**<tr><td><a name="l494" href="#l494">494</a><td> * Sets up the test page and then waits until the test case has been marked<tr><td><a name="l495" href="#l495">495</a><td> * as ready before executing the tests.<tr><td><a name="l496" href="#l496">496</a><td> * @override<tr><td><a name="l497" href="#l497">497</a><td> */<tr><td><a name="l498" href="#l498">498</a><td>goog.testing.AsyncTestCase.prototype.runTests = function() {<tr><td><a name="l499" href="#l499">499</a><td>  this.hookAssert_();<tr><td><a name="l500" href="#l500">500</a><td>  this.hookOnError_();<tr><td><a name="l501" href="#l501">501</a><td><tr><td><a name="l502" href="#l502">502</a><td>  this.setNextStep_(this.doSetUpPage_, &#39;setUpPage&#39;);<tr><td><a name="l503" href="#l503">503</a><td>  // We are an entry point, so we pump.<tr><td><a name="l504" href="#l504">504</a><td>  this.pump_();<tr><td><a name="l505" href="#l505">505</a><td>};<tr><td><a name="l506" href="#l506">506</a><td><tr><td><a name="l507" href="#l507">507</a><td><tr><td><a name="l508" href="#l508">508</a><td>/**<tr><td><a name="l509" href="#l509">509</a><td> * Starts the tests.<tr><td><a name="l510" href="#l510">510</a><td> * @override<tr><td><a name="l511" href="#l511">511</a><td> */<tr><td><a name="l512" href="#l512">512</a><td>goog.testing.AsyncTestCase.prototype.cycleTests = function() {<tr><td><a name="l513" href="#l513">513</a><td>  // We are an entry point, so we pump.<tr><td><a name="l514" href="#l514">514</a><td>  this.saveMessage(&#39;Start&#39;);<tr><td><a name="l515" href="#l515">515</a><td>  this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l516" href="#l516">516</a><td>  this.pump_();<tr><td><a name="l517" href="#l517">517</a><td>};<tr><td><a name="l518" href="#l518">518</a><td><tr><td><a name="l519" href="#l519">519</a><td><tr><td><a name="l520" href="#l520">520</a><td>/**<tr><td><a name="l521" href="#l521">521</a><td> * Finalizes the test case, called when the tests have finished executing.<tr><td><a name="l522" href="#l522">522</a><td> * @override<tr><td><a name="l523" href="#l523">523</a><td> */<tr><td><a name="l524" href="#l524">524</a><td>goog.testing.AsyncTestCase.prototype.finalize = function() {<tr><td><a name="l525" href="#l525">525</a><td>  this.unhookAll_();<tr><td><a name="l526" href="#l526">526</a><td>  this.setNextStep_(null, &#39;finalized&#39;);<tr><td><a name="l527" href="#l527">527</a><td>  goog.testing.AsyncTestCase.superClass_.finalize.call(this);<tr><td><a name="l528" href="#l528">528</a><td>};<tr><td><a name="l529" href="#l529">529</a><td><tr><td><a name="l530" href="#l530">530</a><td><tr><td><a name="l531" href="#l531">531</a><td>/**<tr><td><a name="l532" href="#l532">532</a><td> * Enables verbose logging of what is happening inside of the AsyncTestCase.<tr><td><a name="l533" href="#l533">533</a><td> */<tr><td><a name="l534" href="#l534">534</a><td>goog.testing.AsyncTestCase.prototype.enableDebugLogging = function() {<tr><td><a name="l535" href="#l535">535</a><td>  this.enableDebugLogs_ = true;<tr><td><a name="l536" href="#l536">536</a><td>};<tr><td><a name="l537" href="#l537">537</a><td><tr><td><a name="l538" href="#l538">538</a><td><tr><td><a name="l539" href="#l539">539</a><td>/**<tr><td><a name="l540" href="#l540">540</a><td> * Logs the given debug message to the console (when enabled).<tr><td><a name="l541" href="#l541">541</a><td> * @param {string} message The message to log.<tr><td><a name="l542" href="#l542">542</a><td> * @private<tr><td><a name="l543" href="#l543">543</a><td> */<tr><td><a name="l544" href="#l544">544</a><td>goog.testing.AsyncTestCase.prototype.dbgLog_ = function(message) {<tr><td><a name="l545" href="#l545">545</a><td>  if (this.enableDebugLogs_) {<tr><td><a name="l546" href="#l546">546</a><td>    this.log(&#39;AsyncTestCase - &#39; + message);<tr><td><a name="l547" href="#l547">547</a><td>  }<tr><td><a name="l548" href="#l548">548</a><td>};<tr><td><a name="l549" href="#l549">549</a><td><tr><td><a name="l550" href="#l550">550</a><td><tr><td><a name="l551" href="#l551">551</a><td>/**<tr><td><a name="l552" href="#l552">552</a><td> * Wraps doAsyncError() for when we are sure that the test runner has no user<tr><td><a name="l553" href="#l553">553</a><td> * code above it in the stack.<tr><td><a name="l554" href="#l554">554</a><td> * @param {string|Error=} opt_e The exception object associated with the<tr><td><a name="l555" href="#l555">555</a><td> *     failure or a string.<tr><td><a name="l556" href="#l556">556</a><td> * @private<tr><td><a name="l557" href="#l557">557</a><td> */<tr><td><a name="l558" href="#l558">558</a><td>goog.testing.AsyncTestCase.prototype.doTopOfStackAsyncError_ =<tr><td><a name="l559" href="#l559">559</a><td>    function(opt_e) {<tr><td><a name="l560" href="#l560">560</a><td>  /** @preserveTry */<tr><td><a name="l561" href="#l561">561</a><td>  try {<tr><td><a name="l562" href="#l562">562</a><td>    this.doAsyncError(opt_e);<tr><td><a name="l563" href="#l563">563</a><td>  } catch (e) {<tr><td><a name="l564" href="#l564">564</a><td>    // We know that we are on the top of the stack, so there is no need to<tr><td><a name="l565" href="#l565">565</a><td>    // throw this exception in this case.<tr><td><a name="l566" href="#l566">566</a><td>    if (e.isControlBreakingException) {<tr><td><a name="l567" href="#l567">567</a><td>      this.numControlExceptionsExpected_ -= 1;<tr><td><a name="l568" href="#l568">568</a><td>      this.dbgLog_(&#39;doTopOfStackAsyncError_: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l569" href="#l569">569</a><td>          this.numControlExceptionsExpected_ + &#39; and catching exception.&#39;);<tr><td><a name="l570" href="#l570">570</a><td>    } else {<tr><td><a name="l571" href="#l571">571</a><td>      throw e;<tr><td><a name="l572" href="#l572">572</a><td>    }<tr><td><a name="l573" href="#l573">573</a><td>  }<tr><td><a name="l574" href="#l574">574</a><td>};<tr><td><a name="l575" href="#l575">575</a><td><tr><td><a name="l576" href="#l576">576</a><td><tr><td><a name="l577" href="#l577">577</a><td>/**<tr><td><a name="l578" href="#l578">578</a><td> * Calls the tearDown function, catching any errors, and then moves on to<tr><td><a name="l579" href="#l579">579</a><td> * the next step in the testing cycle.<tr><td><a name="l580" href="#l580">580</a><td> * @private<tr><td><a name="l581" href="#l581">581</a><td> */<tr><td><a name="l582" href="#l582">582</a><td>goog.testing.AsyncTestCase.prototype.doAsyncErrorTearDown_ = function() {<tr><td><a name="l583" href="#l583">583</a><td>  if (this.inException_) {<tr><td><a name="l584" href="#l584">584</a><td>    // We get here if tearDown is throwing the error.<tr><td><a name="l585" href="#l585">585</a><td>    // Upon calling continueTesting, the inline function &#39;doAsyncError&#39; (set<tr><td><a name="l586" href="#l586">586</a><td>    // below) is run.<tr><td><a name="l587" href="#l587">587</a><td>    this.endCurrentStep_();<tr><td><a name="l588" href="#l588">588</a><td>  } else {<tr><td><a name="l589" href="#l589">589</a><td>    this.inException_ = true;<tr><td><a name="l590" href="#l590">590</a><td>    this.isReady_ = true;<tr><td><a name="l591" href="#l591">591</a><td><tr><td><a name="l592" href="#l592">592</a><td>    // The continue point is different depending on if the error happened in<tr><td><a name="l593" href="#l593">593</a><td>    // setUpPage() or in setUp()/test*()/tearDown().<tr><td><a name="l594" href="#l594">594</a><td>    var stepFuncAfterError = this.nextStepFunc_;<tr><td><a name="l595" href="#l595">595</a><td>    var stepNameAfterError = &#39;TestCase.execute (after error)&#39;;<tr><td><a name="l596" href="#l596">596</a><td>    if (this.activeTest) {<tr><td><a name="l597" href="#l597">597</a><td>      stepFuncAfterError = this.doIteration_;<tr><td><a name="l598" href="#l598">598</a><td>      stepNameAfterError = &#39;doIteration (after error)&#39;;<tr><td><a name="l599" href="#l599">599</a><td>    }<tr><td><a name="l600" href="#l600">600</a><td><tr><td><a name="l601" href="#l601">601</a><td>    // We must set the next step before calling tearDown.<tr><td><a name="l602" href="#l602">602</a><td>    this.setNextStep_(function() {<tr><td><a name="l603" href="#l603">603</a><td>      this.inException_ = false;<tr><td><a name="l604" href="#l604">604</a><td>      // This is null when an error happens in setUpPage.<tr><td><a name="l605" href="#l605">605</a><td>      this.setNextStep_(stepFuncAfterError, stepNameAfterError);<tr><td><a name="l606" href="#l606">606</a><td>    }, &#39;doAsyncError&#39;);<tr><td><a name="l607" href="#l607">607</a><td><tr><td><a name="l608" href="#l608">608</a><td>    // Call the test&#39;s tearDown().<tr><td><a name="l609" href="#l609">609</a><td>    if (!this.cleanedUp_) {<tr><td><a name="l610" href="#l610">610</a><td>      this.cleanedUp_ = true;<tr><td><a name="l611" href="#l611">611</a><td>      this.tearDown();<tr><td><a name="l612" href="#l612">612</a><td>    }<tr><td><a name="l613" href="#l613">613</a><td>  }<tr><td><a name="l614" href="#l614">614</a><td>};<tr><td><a name="l615" href="#l615">615</a><td><tr><td><a name="l616" href="#l616">616</a><td><tr><td><a name="l617" href="#l617">617</a><td>/**<tr><td><a name="l618" href="#l618">618</a><td> * Replaces the asserts.js assert_() and fail() functions with a wrappers to<tr><td><a name="l619" href="#l619">619</a><td> * catch the exceptions.<tr><td><a name="l620" href="#l620">620</a><td> * @private<tr><td><a name="l621" href="#l621">621</a><td> */<tr><td><a name="l622" href="#l622">622</a><td>goog.testing.AsyncTestCase.prototype.hookAssert_ = function() {<tr><td><a name="l623" href="#l623">623</a><td>  if (!this.origAssert_) {<tr><td><a name="l624" href="#l624">624</a><td>    this.origAssert_ = _assert;<tr><td><a name="l625" href="#l625">625</a><td>    this.origFail_ = fail;<tr><td><a name="l626" href="#l626">626</a><td>    var self = this;<tr><td><a name="l627" href="#l627">627</a><td>    _assert = function() {<tr><td><a name="l628" href="#l628">628</a><td>      /** @preserveTry */<tr><td><a name="l629" href="#l629">629</a><td>      try {<tr><td><a name="l630" href="#l630">630</a><td>        self.origAssert_.apply(this, arguments);<tr><td><a name="l631" href="#l631">631</a><td>      } catch (e) {<tr><td><a name="l632" href="#l632">632</a><td>        self.dbgLog_(&#39;Wrapping failed assert()&#39;);<tr><td><a name="l633" href="#l633">633</a><td>        self.doAsyncError(e);<tr><td><a name="l634" href="#l634">634</a><td>      }<tr><td><a name="l635" href="#l635">635</a><td>    };<tr><td><a name="l636" href="#l636">636</a><td>    fail = function() {<tr><td><a name="l637" href="#l637">637</a><td>      /** @preserveTry */<tr><td><a name="l638" href="#l638">638</a><td>      try {<tr><td><a name="l639" href="#l639">639</a><td>        self.origFail_.apply(this, arguments);<tr><td><a name="l640" href="#l640">640</a><td>      } catch (e) {<tr><td><a name="l641" href="#l641">641</a><td>        self.dbgLog_(&#39;Wrapping fail()&#39;);<tr><td><a name="l642" href="#l642">642</a><td>        self.doAsyncError(e);<tr><td><a name="l643" href="#l643">643</a><td>      }<tr><td><a name="l644" href="#l644">644</a><td>    };<tr><td><a name="l645" href="#l645">645</a><td>  }<tr><td><a name="l646" href="#l646">646</a><td>};<tr><td><a name="l647" href="#l647">647</a><td><tr><td><a name="l648" href="#l648">648</a><td><tr><td><a name="l649" href="#l649">649</a><td>/**<tr><td><a name="l650" href="#l650">650</a><td> * Sets a window.onerror handler for catching exceptions that happen in async<tr><td><a name="l651" href="#l651">651</a><td> * callbacks. Note that as of Safari 3.1, Safari does not support this.<tr><td><a name="l652" href="#l652">652</a><td> * @private<tr><td><a name="l653" href="#l653">653</a><td> */<tr><td><a name="l654" href="#l654">654</a><td>goog.testing.AsyncTestCase.prototype.hookOnError_ = function() {<tr><td><a name="l655" href="#l655">655</a><td>  if (!this.origOnError_) {<tr><td><a name="l656" href="#l656">656</a><td>    this.origOnError_ = window.onerror;<tr><td><a name="l657" href="#l657">657</a><td>    var self = this;<tr><td><a name="l658" href="#l658">658</a><td>    window.onerror = function(error, url, line) {<tr><td><a name="l659" href="#l659">659</a><td>      // Ignore exceptions that we threw on purpose.<tr><td><a name="l660" href="#l660">660</a><td>      var cbe =<tr><td><a name="l661" href="#l661">661</a><td>          goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING;<tr><td><a name="l662" href="#l662">662</a><td>      if (String(error).indexOf(cbe) != -1 &amp;&amp;<tr><td><a name="l663" href="#l663">663</a><td>          self.numControlExceptionsExpected_) {<tr><td><a name="l664" href="#l664">664</a><td>        self.numControlExceptionsExpected_ -= 1;<tr><td><a name="l665" href="#l665">665</a><td>        self.dbgLog_(&#39;window.onerror: numControlExceptionsExpected_ = &#39; +<tr><td><a name="l666" href="#l666">666</a><td>            self.numControlExceptionsExpected_ + &#39; and ignoring exception. &#39; +<tr><td><a name="l667" href="#l667">667</a><td>            error);<tr><td><a name="l668" href="#l668">668</a><td>        // Tell the browser not to compain about the error.<tr><td><a name="l669" href="#l669">669</a><td>        return true;<tr><td><a name="l670" href="#l670">670</a><td>      } else {<tr><td><a name="l671" href="#l671">671</a><td>        self.dbgLog_(&#39;window.onerror caught exception.&#39;);<tr><td><a name="l672" href="#l672">672</a><td>        var message = error + &#39;\nURL: &#39; + url + &#39;\nLine: &#39; + line;<tr><td><a name="l673" href="#l673">673</a><td>        self.doTopOfStackAsyncError_(message);<tr><td><a name="l674" href="#l674">674</a><td>        // Tell the browser to complain about the error.<tr><td><a name="l675" href="#l675">675</a><td>        return false;<tr><td><a name="l676" href="#l676">676</a><td>      }<tr><td><a name="l677" href="#l677">677</a><td>    };<tr><td><a name="l678" href="#l678">678</a><td>  }<tr><td><a name="l679" href="#l679">679</a><td>};<tr><td><a name="l680" href="#l680">680</a><td><tr><td><a name="l681" href="#l681">681</a><td><tr><td><a name="l682" href="#l682">682</a><td>/**<tr><td><a name="l683" href="#l683">683</a><td> * Unhooks window.onerror and _assert.<tr><td><a name="l684" href="#l684">684</a><td> * @private<tr><td><a name="l685" href="#l685">685</a><td> */<tr><td><a name="l686" href="#l686">686</a><td>goog.testing.AsyncTestCase.prototype.unhookAll_ = function() {<tr><td><a name="l687" href="#l687">687</a><td>  if (this.origOnError_) {<tr><td><a name="l688" href="#l688">688</a><td>    window.onerror = this.origOnError_;<tr><td><a name="l689" href="#l689">689</a><td>    this.origOnError_ = null;<tr><td><a name="l690" href="#l690">690</a><td>    _assert = this.origAssert_;<tr><td><a name="l691" href="#l691">691</a><td>    this.origAssert_ = null;<tr><td><a name="l692" href="#l692">692</a><td>    fail = this.origFail_;<tr><td><a name="l693" href="#l693">693</a><td>    this.origFail_ = null;<tr><td><a name="l694" href="#l694">694</a><td>  }<tr><td><a name="l695" href="#l695">695</a><td>};<tr><td><a name="l696" href="#l696">696</a><td><tr><td><a name="l697" href="#l697">697</a><td><tr><td><a name="l698" href="#l698">698</a><td>/**<tr><td><a name="l699" href="#l699">699</a><td> * Enables the timeout timer. This timer fires unless continueTesting is<tr><td><a name="l700" href="#l700">700</a><td> * called.<tr><td><a name="l701" href="#l701">701</a><td> * @private<tr><td><a name="l702" href="#l702">702</a><td> */<tr><td><a name="l703" href="#l703">703</a><td>goog.testing.AsyncTestCase.prototype.startTimeoutTimer_ = function() {<tr><td><a name="l704" href="#l704">704</a><td>  if (!this.timeoutHandle_ &amp;&amp; this.stepTimeout &gt; 0) {<tr><td><a name="l705" href="#l705">705</a><td>    this.timeoutHandle_ = this.timeout(goog.bind(function() {<tr><td><a name="l706" href="#l706">706</a><td>      this.dbgLog_(&#39;Timeout timer fired with id &#39; + this.timeoutHandle_);<tr><td><a name="l707" href="#l707">707</a><td>      this.timeoutHandle_ = 0;<tr><td><a name="l708" href="#l708">708</a><td><tr><td><a name="l709" href="#l709">709</a><td>      this.doTopOfStackAsyncError_(&#39;Timed out while waiting for &#39; +<tr><td><a name="l710" href="#l710">710</a><td>          &#39;continueTesting() to be called.&#39;);<tr><td><a name="l711" href="#l711">711</a><td>    }, this, null), this.stepTimeout);<tr><td><a name="l712" href="#l712">712</a><td>    this.dbgLog_(&#39;Started timeout timer with id &#39; + this.timeoutHandle_);<tr><td><a name="l713" href="#l713">713</a><td>  }<tr><td><a name="l714" href="#l714">714</a><td>};<tr><td><a name="l715" href="#l715">715</a><td><tr><td><a name="l716" href="#l716">716</a><td><tr><td><a name="l717" href="#l717">717</a><td>/**<tr><td><a name="l718" href="#l718">718</a><td> * Disables the timeout timer.<tr><td><a name="l719" href="#l719">719</a><td> * @private<tr><td><a name="l720" href="#l720">720</a><td> */<tr><td><a name="l721" href="#l721">721</a><td>goog.testing.AsyncTestCase.prototype.stopTimeoutTimer_ = function() {<tr><td><a name="l722" href="#l722">722</a><td>  if (this.timeoutHandle_) {<tr><td><a name="l723" href="#l723">723</a><td>    this.dbgLog_(&#39;Clearing timeout timer with id &#39; + this.timeoutHandle_);<tr><td><a name="l724" href="#l724">724</a><td>    this.clearTimeout(this.timeoutHandle_);<tr><td><a name="l725" href="#l725">725</a><td>    this.timeoutHandle_ = 0;<tr><td><a name="l726" href="#l726">726</a><td>  }<tr><td><a name="l727" href="#l727">727</a><td>};<tr><td><a name="l728" href="#l728">728</a><td><tr><td><a name="l729" href="#l729">729</a><td><tr><td><a name="l730" href="#l730">730</a><td>/**<tr><td><a name="l731" href="#l731">731</a><td> * Sets the next function to call in our sequence of async callbacks.<tr><td><a name="l732" href="#l732">732</a><td> * @param {Function} func The function that executes the next step.<tr><td><a name="l733" href="#l733">733</a><td> * @param {string} name A description of the next step.<tr><td><a name="l734" href="#l734">734</a><td> * @private<tr><td><a name="l735" href="#l735">735</a><td> */<tr><td><a name="l736" href="#l736">736</a><td>goog.testing.AsyncTestCase.prototype.setNextStep_ = function(func, name) {<tr><td><a name="l737" href="#l737">737</a><td>  this.nextStepFunc_ = func &amp;&amp; goog.bind(func, this);<tr><td><a name="l738" href="#l738">738</a><td>  this.nextStepName_ = name;<tr><td><a name="l739" href="#l739">739</a><td>};<tr><td><a name="l740" href="#l740">740</a><td><tr><td><a name="l741" href="#l741">741</a><td><tr><td><a name="l742" href="#l742">742</a><td>/**<tr><td><a name="l743" href="#l743">743</a><td> * Calls the given function, redirecting any exceptions to doAsyncError.<tr><td><a name="l744" href="#l744">744</a><td> * @param {Function} func The function to call.<tr><td><a name="l745" href="#l745">745</a><td> * @return {!goog.testing.AsyncTestCase.TopStackFuncResult_} Returns a<tr><td><a name="l746" href="#l746">746</a><td> * TopStackFuncResult_.<tr><td><a name="l747" href="#l747">747</a><td> * @private<tr><td><a name="l748" href="#l748">748</a><td> */<tr><td><a name="l749" href="#l749">749</a><td>goog.testing.AsyncTestCase.prototype.callTopOfStackFunc_ = function(func) {<tr><td><a name="l750" href="#l750">750</a><td>  /** @preserveTry */<tr><td><a name="l751" href="#l751">751</a><td>  try {<tr><td><a name="l752" href="#l752">752</a><td>    func.call(this);<tr><td><a name="l753" href="#l753">753</a><td>    return {controlBreakingExceptionThrown: false, message: &#39;&#39;};<tr><td><a name="l754" href="#l754">754</a><td>  } catch (e) {<tr><td><a name="l755" href="#l755">755</a><td>    this.dbgLog_(&#39;Caught exception in callTopOfStackFunc_&#39;);<tr><td><a name="l756" href="#l756">756</a><td>    /** @preserveTry */<tr><td><a name="l757" href="#l757">757</a><td>    try {<tr><td><a name="l758" href="#l758">758</a><td>      this.doAsyncError(e);<tr><td><a name="l759" href="#l759">759</a><td>      return {controlBreakingExceptionThrown: false, message: &#39;&#39;};<tr><td><a name="l760" href="#l760">760</a><td>    } catch (e2) {<tr><td><a name="l761" href="#l761">761</a><td>      if (!e2.isControlBreakingException) {<tr><td><a name="l762" href="#l762">762</a><td>        throw e2;<tr><td><a name="l763" href="#l763">763</a><td>      }<tr><td><a name="l764" href="#l764">764</a><td>      return {controlBreakingExceptionThrown: true, message: e2.message};<tr><td><a name="l765" href="#l765">765</a><td>    }<tr><td><a name="l766" href="#l766">766</a><td>  }<tr><td><a name="l767" href="#l767">767</a><td>};<tr><td><a name="l768" href="#l768">768</a><td><tr><td><a name="l769" href="#l769">769</a><td><tr><td><a name="l770" href="#l770">770</a><td>/**<tr><td><a name="l771" href="#l771">771</a><td> * Calls the next callback when the isReady_ flag is true.<tr><td><a name="l772" href="#l772">772</a><td> * @param {Function=} opt_doFirst A function to call before pumping.<tr><td><a name="l773" href="#l773">773</a><td> * @private<tr><td><a name="l774" href="#l774">774</a><td> * @throws Throws a ControlBreakingException if there were any failing steps.<tr><td><a name="l775" href="#l775">775</a><td> */<tr><td><a name="l776" href="#l776">776</a><td>goog.testing.AsyncTestCase.prototype.pump_ = function(opt_doFirst) {<tr><td><a name="l777" href="#l777">777</a><td>  // If this function is already above us in the call-stack, then we should<tr><td><a name="l778" href="#l778">778</a><td>  // return rather than pumping in order to minimize call-stack depth.<tr><td><a name="l779" href="#l779">779</a><td>  if (!this.returnWillPump_) {<tr><td><a name="l780" href="#l780">780</a><td>    this.setBatchTime(this.now());<tr><td><a name="l781" href="#l781">781</a><td>    this.returnWillPump_ = true;<tr><td><a name="l782" href="#l782">782</a><td>    var topFuncResult = {};<tr><td><a name="l783" href="#l783">783</a><td><tr><td><a name="l784" href="#l784">784</a><td>    if (opt_doFirst) {<tr><td><a name="l785" href="#l785">785</a><td>      topFuncResult = this.callTopOfStackFunc_(opt_doFirst);<tr><td><a name="l786" href="#l786">786</a><td>    }<tr><td><a name="l787" href="#l787">787</a><td>    // Note: we don&#39;t check for this.running here because it is not set to true<tr><td><a name="l788" href="#l788">788</a><td>    // while executing setUpPage and tearDownPage.<tr><td><a name="l789" href="#l789">789</a><td>    // Also, if isReady_ is false, then one of two things will happen:<tr><td><a name="l790" href="#l790">790</a><td>    // 1. Our timeout callback will be called.<tr><td><a name="l791" href="#l791">791</a><td>    // 2. The tests will call continueTesting(), which will call pump_() again.<tr><td><a name="l792" href="#l792">792</a><td>    while (this.isReady_ &amp;&amp; this.nextStepFunc_ &amp;&amp;<tr><td><a name="l793" href="#l793">793</a><td>        !topFuncResult.controlBreakingExceptionThrown) {<tr><td><a name="l794" href="#l794">794</a><td>      this.curStepFunc_ = this.nextStepFunc_;<tr><td><a name="l795" href="#l795">795</a><td>      this.curStepName_ = this.nextStepName_;<tr><td><a name="l796" href="#l796">796</a><td>      this.nextStepFunc_ = null;<tr><td><a name="l797" href="#l797">797</a><td>      this.nextStepName_ = &#39;&#39;;<tr><td><a name="l798" href="#l798">798</a><td><tr><td><a name="l799" href="#l799">799</a><td>      this.dbgLog_(&#39;Performing step: &#39; + this.curStepName_);<tr><td><a name="l800" href="#l800">800</a><td>      topFuncResult =<tr><td><a name="l801" href="#l801">801</a><td>          this.callTopOfStackFunc_(/** @type {Function} */(this.curStepFunc_));<tr><td><a name="l802" href="#l802">802</a><td><tr><td><a name="l803" href="#l803">803</a><td>      // If the max run time is exceeded call this function again async so as<tr><td><a name="l804" href="#l804">804</a><td>      // not to block the browser.<tr><td><a name="l805" href="#l805">805</a><td>      var delta = this.now() - this.getBatchTime();<tr><td><a name="l806" href="#l806">806</a><td>      if (delta &gt; goog.testing.TestCase.maxRunTime &amp;&amp;<tr><td><a name="l807" href="#l807">807</a><td>          !topFuncResult.controlBreakingExceptionThrown) {<tr><td><a name="l808" href="#l808">808</a><td>        this.saveMessage(&#39;Breaking async&#39;);<tr><td><a name="l809" href="#l809">809</a><td>        var self = this;<tr><td><a name="l810" href="#l810">810</a><td>        this.timeout(function() { self.pump_(); }, 100);<tr><td><a name="l811" href="#l811">811</a><td>        break;<tr><td><a name="l812" href="#l812">812</a><td>      }<tr><td><a name="l813" href="#l813">813</a><td>    }<tr><td><a name="l814" href="#l814">814</a><td>    this.returnWillPump_ = false;<tr><td><a name="l815" href="#l815">815</a><td>  } else if (opt_doFirst) {<tr><td><a name="l816" href="#l816">816</a><td>    opt_doFirst.call(this);<tr><td><a name="l817" href="#l817">817</a><td>  }<tr><td><a name="l818" href="#l818">818</a><td>};<tr><td><a name="l819" href="#l819">819</a><td><tr><td><a name="l820" href="#l820">820</a><td><tr><td><a name="l821" href="#l821">821</a><td>/**<tr><td><a name="l822" href="#l822">822</a><td> * Sets up the test page and then waits untill the test case has been marked<tr><td><a name="l823" href="#l823">823</a><td> * as ready before executing the tests.<tr><td><a name="l824" href="#l824">824</a><td> * @private<tr><td><a name="l825" href="#l825">825</a><td> */<tr><td><a name="l826" href="#l826">826</a><td>goog.testing.AsyncTestCase.prototype.doSetUpPage_ = function() {<tr><td><a name="l827" href="#l827">827</a><td>  this.setNextStep_(this.execute, &#39;TestCase.execute&#39;);<tr><td><a name="l828" href="#l828">828</a><td>  this.setUpPage();<tr><td><a name="l829" href="#l829">829</a><td>};<tr><td><a name="l830" href="#l830">830</a><td><tr><td><a name="l831" href="#l831">831</a><td><tr><td><a name="l832" href="#l832">832</a><td>/**<tr><td><a name="l833" href="#l833">833</a><td> * Step 1: Move to the next test.<tr><td><a name="l834" href="#l834">834</a><td> * @private<tr><td><a name="l835" href="#l835">835</a><td> */<tr><td><a name="l836" href="#l836">836</a><td>goog.testing.AsyncTestCase.prototype.doIteration_ = function() {<tr><td><a name="l837" href="#l837">837</a><td>  this.expectedSignalCount_ = 0;<tr><td><a name="l838" href="#l838">838</a><td>  this.receivedSignalCount_ = 0;<tr><td><a name="l839" href="#l839">839</a><td>  this.activeTest = this.next();<tr><td><a name="l840" href="#l840">840</a><td>  if (this.activeTest &amp;&amp; this.running) {<tr><td><a name="l841" href="#l841">841</a><td>    this.result_.runCount++;<tr><td><a name="l842" href="#l842">842</a><td>    // If this test should be marked as having failed, doIteration will go<tr><td><a name="l843" href="#l843">843</a><td>    // straight to the next test.<tr><td><a name="l844" href="#l844">844</a><td>    if (this.maybeFailTestEarly(this.activeTest)) {<tr><td><a name="l845" href="#l845">845</a><td>      this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l846" href="#l846">846</a><td>    } else {<tr><td><a name="l847" href="#l847">847</a><td>      this.setNextStep_(this.doSetUp_, &#39;setUp&#39;);<tr><td><a name="l848" href="#l848">848</a><td>    }<tr><td><a name="l849" href="#l849">849</a><td>  } else {<tr><td><a name="l850" href="#l850">850</a><td>    // All tests done.<tr><td><a name="l851" href="#l851">851</a><td>    this.finalize();<tr><td><a name="l852" href="#l852">852</a><td>  }<tr><td><a name="l853" href="#l853">853</a><td>};<tr><td><a name="l854" href="#l854">854</a><td><tr><td><a name="l855" href="#l855">855</a><td><tr><td><a name="l856" href="#l856">856</a><td>/**<tr><td><a name="l857" href="#l857">857</a><td> * Step 2: Call setUp().<tr><td><a name="l858" href="#l858">858</a><td> * @private<tr><td><a name="l859" href="#l859">859</a><td> */<tr><td><a name="l860" href="#l860">860</a><td>goog.testing.AsyncTestCase.prototype.doSetUp_ = function() {<tr><td><a name="l861" href="#l861">861</a><td>  this.log(&#39;Running test: &#39; + this.activeTest.name);<tr><td><a name="l862" href="#l862">862</a><td>  this.cleanedUp_ = false;<tr><td><a name="l863" href="#l863">863</a><td>  this.setNextStep_(this.doExecute_, this.activeTest.name);<tr><td><a name="l864" href="#l864">864</a><td>  this.setUp();<tr><td><a name="l865" href="#l865">865</a><td>};<tr><td><a name="l866" href="#l866">866</a><td><tr><td><a name="l867" href="#l867">867</a><td><tr><td><a name="l868" href="#l868">868</a><td>/**<tr><td><a name="l869" href="#l869">869</a><td> * Step 3: Call test.execute().<tr><td><a name="l870" href="#l870">870</a><td> * @private<tr><td><a name="l871" href="#l871">871</a><td> */<tr><td><a name="l872" href="#l872">872</a><td>goog.testing.AsyncTestCase.prototype.doExecute_ = function() {<tr><td><a name="l873" href="#l873">873</a><td>  this.setNextStep_(this.doTearDown_, &#39;tearDown&#39;);<tr><td><a name="l874" href="#l874">874</a><td>  this.activeTest.execute();<tr><td><a name="l875" href="#l875">875</a><td>};<tr><td><a name="l876" href="#l876">876</a><td><tr><td><a name="l877" href="#l877">877</a><td><tr><td><a name="l878" href="#l878">878</a><td>/**<tr><td><a name="l879" href="#l879">879</a><td> * Step 4: Call tearDown().<tr><td><a name="l880" href="#l880">880</a><td> * @private<tr><td><a name="l881" href="#l881">881</a><td> */<tr><td><a name="l882" href="#l882">882</a><td>goog.testing.AsyncTestCase.prototype.doTearDown_ = function() {<tr><td><a name="l883" href="#l883">883</a><td>  this.cleanedUp_ = true;<tr><td><a name="l884" href="#l884">884</a><td>  this.setNextStep_(this.doNext_, &#39;doNext&#39;);<tr><td><a name="l885" href="#l885">885</a><td>  this.tearDown();<tr><td><a name="l886" href="#l886">886</a><td>};<tr><td><a name="l887" href="#l887">887</a><td><tr><td><a name="l888" href="#l888">888</a><td><tr><td><a name="l889" href="#l889">889</a><td>/**<tr><td><a name="l890" href="#l890">890</a><td> * Step 5: Call doSuccess()<tr><td><a name="l891" href="#l891">891</a><td> * @private<tr><td><a name="l892" href="#l892">892</a><td> */<tr><td><a name="l893" href="#l893">893</a><td>goog.testing.AsyncTestCase.prototype.doNext_ = function() {<tr><td><a name="l894" href="#l894">894</a><td>  this.setNextStep_(this.doIteration_, &#39;doIteration&#39;);<tr><td><a name="l895" href="#l895">895</a><td>  this.doSuccess(/** @type {goog.testing.TestCase.Test} */(this.activeTest));<tr><td><a name="l896" href="#l896">896</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/events/events.js.src.html b/docs/source/lib/goog/testing/events/events.js.src.html
new file mode 100644
index 0000000..c0627db
--- /dev/null
+++ b/docs/source/lib/goog/testing/events/events.js.src.html
@@ -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>events.js</title><link href="../../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/events/events.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Event Simulation.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * Utility functions for simulating events at the Closure level. All functions<tr><td><a id="l19"></a><a href="#l19">19</a><td> * in this package generate events by calling goog.events.fireListeners,<tr><td><a id="l20"></a><a href="#l20">20</a><td> * rather than interfacing with the browser directly. This is intended for<tr><td><a id="l21"></a><a href="#l21">21</a><td> * testing purposes, and should not be used in production code.<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * The decision to use Closure events and dispatchers instead of the browser&#39;s<tr><td><a id="l24"></a><a href="#l24">24</a><td> * native events and dispatchers was conscious and deliberate. Native event<tr><td><a id="l25"></a><a href="#l25">25</a><td> * dispatchers have their own set of quirks and edge cases. Pure JS dispatchers<tr><td><a id="l26"></a><a href="#l26">26</a><td> * are more robust and transparent.<tr><td><a id="l27"></a><a href="#l27">27</a><td> *<tr><td><a id="l28"></a><a href="#l28">28</a><td> * If you think you need a testing mechanism that uses native Event objects,<tr><td><a id="l29"></a><a href="#l29">29</a><td> * please, please email closure-tech first to explain your use case before you<tr><td><a id="l30"></a><a href="#l30">30</a><td> * sink time into this.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @author nicksantos@google.com (Nick Santos)<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>goog.provide(&#39;goog.testing.events&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.provide(&#39;goog.testing.events.Event&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td><tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.Disposable&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.dom.NodeType&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.events&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.events.BrowserEvent&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.events.BrowserFeature&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;goog.events.EventTarget&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;goog.events.EventType&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.require(&#39;goog.events.KeyCodes&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.require(&#39;goog.style&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.require(&#39;goog.userAgent&#39;);<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><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.events.BrowserEvent expects an Event so we provide one for JSCompiler.<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 clones a lot of the functionality of goog.events.Event. This used to<tr><td><a id="l57"></a><a href="#l57">57</a><td> * use a mixin, but the mixin results in confusing the two types when compiled.<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @param {string} type Event Type.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {Object=} opt_target Reference to the object that is the target of<tr><td><a id="l61"></a><a href="#l61">61</a><td> *     this event.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @constructor<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @extends {Event}<tr><td><a id="l64"></a><a href="#l64">64</a><td> */<tr><td><a id="l65"></a><a href="#l65">65</a><td>goog.testing.events.Event = function(type, opt_target) {<tr><td><a id="l66"></a><a href="#l66">66</a><td>  this.type = type;<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td>  this.target = /** @type {EventTarget} */ (opt_target || null);<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>  this.currentTarget = this.target;<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>/**<tr><td><a id="l75"></a><a href="#l75">75</a><td> * Whether to cancel the event in internal capture/bubble processing for IE.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @type {boolean}<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @public<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @suppress {underscore|visibility} Technically public, but referencing this<tr><td><a id="l79"></a><a href="#l79">79</a><td> *     outside this package is strongly discouraged.<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.testing.events.Event.prototype.propagationStopped_ = false;<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>/** @override */<tr><td><a id="l85"></a><a href="#l85">85</a><td>goog.testing.events.Event.prototype.defaultPrevented = false;<tr><td><a id="l86"></a><a href="#l86">86</a><td><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> * Return value for in internal capture/bubble processing for IE.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @type {boolean}<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @public<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @suppress {underscore|visibility} Technically public, but referencing this<tr><td><a id="l93"></a><a href="#l93">93</a><td> *     outside this package is strongly discouraged.<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.testing.events.Event.prototype.returnValue_ = true;<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>/** @override */<tr><td><a id="l99"></a><a href="#l99">99</a><td>goog.testing.events.Event.prototype.stopPropagation = function() {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  this.propagationStopped_ = true;<tr><td><a id="l101"></a><a href="#l101">101</a><td>};<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>/** @override */<tr><td><a id="l105"></a><a href="#l105">105</a><td>goog.testing.events.Event.prototype.preventDefault = function() {<tr><td><a id="l106"></a><a href="#l106">106</a><td>  this.defaultPrevented = true;<tr><td><a id="l107"></a><a href="#l107">107</a><td>  this.returnValue_ = false;<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>/**<tr><td><a id="l112"></a><a href="#l112">112</a><td> * Asserts an event target exists.  This will fail if target is not defined.<tr><td><a id="l113"></a><a href="#l113">113</a><td> *<tr><td><a id="l114"></a><a href="#l114">114</a><td> * TODO(nnaze): Gradually add this to the methods in this file, and eventually<tr><td><a id="l115"></a><a href="#l115">115</a><td> *     update the method signatures to not take nullables.  See http://b/8961907<tr><td><a id="l116"></a><a href="#l116">116</a><td> *<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @param {EventTarget} target A target to assert.<tr><td><a id="l118"></a><a href="#l118">118</a><td> * @return {!EventTarget} The target, guaranteed to exist.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @private<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.testing.events.assertEventTarget_ = function(target) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>  return goog.asserts.assert(target, &#39;EventTarget should be defined.&#39;);<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> * A static helper function that sets the mouse position to the event.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {Event} event A simulated native event.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l130"></a><a href="#l130">130</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @private<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>goog.testing.events.setEventClientXY_ = function(event, opt_coords) {<tr><td><a id="l134"></a><a href="#l134">134</a><td>  if (!opt_coords &amp;&amp; event.target &amp;&amp;<tr><td><a id="l135"></a><a href="#l135">135</a><td>      event.target.nodeType == goog.dom.NodeType.ELEMENT) {<tr><td><a id="l136"></a><a href="#l136">136</a><td>    try {<tr><td><a id="l137"></a><a href="#l137">137</a><td>      opt_coords =<tr><td><a id="l138"></a><a href="#l138">138</a><td>          goog.style.getClientPosition(/** @type {!Element} **/ (event.target));<tr><td><a id="l139"></a><a href="#l139">139</a><td>    } catch (ex) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>      // IE sometimes throws if it can&#39;t get the position.<tr><td><a id="l141"></a><a href="#l141">141</a><td>    }<tr><td><a id="l142"></a><a href="#l142">142</a><td>  }<tr><td><a id="l143"></a><a href="#l143">143</a><td>  event.clientX = opt_coords ? opt_coords.x : 0;<tr><td><a id="l144"></a><a href="#l144">144</a><td>  event.clientY = opt_coords ? opt_coords.y : 0;<tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td>  // Pretend the browser window is at (0, 0).<tr><td><a id="l147"></a><a href="#l147">147</a><td>  event.screenX = event.clientX;<tr><td><a id="l148"></a><a href="#l148">148</a><td>  event.screenY = event.clientY;<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * Simulates a mousedown, mouseup, and then click on the given event target,<tr><td><a id="l154"></a><a href="#l154">154</a><td> * with the left mouse button.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;<tr><td><a id="l157"></a><a href="#l157">157</a><td> *     defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l159"></a><a href="#l159">159</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l161"></a><a href="#l161">161</a><td> *     BrowserEvent.<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @return {boolean} The returnValue of the sequence: false if preventDefault()<tr><td><a id="l163"></a><a href="#l163">163</a><td> *     was called on any of the events, true otherwise.<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.testing.events.fireClickSequence =<tr><td><a id="l166"></a><a href="#l166">166</a><td>    function(target, opt_button, opt_coords, opt_eventProperties) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>  // Fire mousedown, mouseup, and click. Then return the bitwise AND of the 3.<tr><td><a id="l168"></a><a href="#l168">168</a><td>  return !!(goog.testing.events.fireMouseDownEvent(<tr><td><a id="l169"></a><a href="#l169">169</a><td>      target, opt_button, opt_coords, opt_eventProperties) &amp;<tr><td><a id="l170"></a><a href="#l170">170</a><td>            goog.testing.events.fireMouseUpEvent(<tr><td><a id="l171"></a><a href="#l171">171</a><td>                target, opt_button, opt_coords, opt_eventProperties) &amp;<tr><td><a id="l172"></a><a href="#l172">172</a><td>            goog.testing.events.fireClickEvent(<tr><td><a id="l173"></a><a href="#l173">173</a><td>                target, opt_button, opt_coords, opt_eventProperties));<tr><td><a id="l174"></a><a href="#l174">174</a><td>};<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * Simulates the sequence of events fired by the browser when the user double-<tr><td><a id="l179"></a><a href="#l179">179</a><td> * clicks the given target.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l182"></a><a href="#l182">182</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l184"></a><a href="#l184">184</a><td> *     BrowserEvent.<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @return {boolean} The returnValue of the sequence: false if preventDefault()<tr><td><a id="l186"></a><a href="#l186">186</a><td> *     was called on any of the events, true otherwise.<tr><td><a id="l187"></a><a href="#l187">187</a><td> */<tr><td><a id="l188"></a><a href="#l188">188</a><td>goog.testing.events.fireDoubleClickSequence = function(<tr><td><a id="l189"></a><a href="#l189">189</a><td>    target, opt_coords, opt_eventProperties) {<tr><td><a id="l190"></a><a href="#l190">190</a><td>  // Fire mousedown, mouseup, click, mousedown, mouseup, click, dblclick.<tr><td><a id="l191"></a><a href="#l191">191</a><td>  // Then return the bitwise AND of the 7.<tr><td><a id="l192"></a><a href="#l192">192</a><td>  var btn = goog.events.BrowserEvent.MouseButton.LEFT;<tr><td><a id="l193"></a><a href="#l193">193</a><td>  return !!(goog.testing.events.fireMouseDownEvent(<tr><td><a id="l194"></a><a href="#l194">194</a><td>      target, btn, opt_coords, opt_eventProperties) &amp;<tr><td><a id="l195"></a><a href="#l195">195</a><td>            goog.testing.events.fireMouseUpEvent(<tr><td><a id="l196"></a><a href="#l196">196</a><td>                target, btn, opt_coords, opt_eventProperties) &amp;<tr><td><a id="l197"></a><a href="#l197">197</a><td>            goog.testing.events.fireClickEvent(<tr><td><a id="l198"></a><a href="#l198">198</a><td>                target, btn, opt_coords, opt_eventProperties) &amp;<tr><td><a id="l199"></a><a href="#l199">199</a><td>            // IE fires a selectstart instead of the second mousedown in a<tr><td><a id="l200"></a><a href="#l200">200</a><td>            // dblclick, but we don&#39;t care about selectstart.<tr><td><a id="l201"></a><a href="#l201">201</a><td>            (goog.userAgent.IE ||<tr><td><a id="l202"></a><a href="#l202">202</a><td>            goog.testing.events.fireMouseDownEvent(<tr><td><a id="l203"></a><a href="#l203">203</a><td>                target, btn, opt_coords, opt_eventProperties)) &amp;<tr><td><a id="l204"></a><a href="#l204">204</a><td>            goog.testing.events.fireMouseUpEvent(<tr><td><a id="l205"></a><a href="#l205">205</a><td>                target, btn, opt_coords, opt_eventProperties) &amp;<tr><td><a id="l206"></a><a href="#l206">206</a><td>            // IE doesn&#39;t fire the second click in a dblclick.<tr><td><a id="l207"></a><a href="#l207">207</a><td>            (goog.userAgent.IE ||<tr><td><a id="l208"></a><a href="#l208">208</a><td>            goog.testing.events.fireClickEvent(<tr><td><a id="l209"></a><a href="#l209">209</a><td>                target, btn, opt_coords, opt_eventProperties)) &amp;<tr><td><a id="l210"></a><a href="#l210">210</a><td>            goog.testing.events.fireDoubleClickEvent(<tr><td><a id="l211"></a><a href="#l211">211</a><td>                target, opt_coords, opt_eventProperties));<tr><td><a id="l212"></a><a href="#l212">212</a><td>};<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * Simulates a complete keystroke (keydown, keypress, and keyup). Note that<tr><td><a id="l217"></a><a href="#l217">217</a><td> * if preventDefault is called on the keydown, the keypress will not fire.<tr><td><a id="l218"></a><a href="#l218">218</a><td> *<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @param {number} keyCode The keycode of the key pressed.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l222"></a><a href="#l222">222</a><td> *     BrowserEvent.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @return {boolean} The returnValue of the sequence: false if preventDefault()<tr><td><a id="l224"></a><a href="#l224">224</a><td> *     was called on any of the events, true otherwise.<tr><td><a id="l225"></a><a href="#l225">225</a><td> */<tr><td><a id="l226"></a><a href="#l226">226</a><td>goog.testing.events.fireKeySequence = function(<tr><td><a id="l227"></a><a href="#l227">227</a><td>    target, keyCode, opt_eventProperties) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>  return goog.testing.events.fireNonAsciiKeySequence(target, keyCode, keyCode,<tr><td><a id="l229"></a><a href="#l229">229</a><td>                                                     opt_eventProperties);<tr><td><a id="l230"></a><a href="#l230">230</a><td>};<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Simulates a complete keystroke (keydown, keypress, and keyup) when typing<tr><td><a id="l235"></a><a href="#l235">235</a><td> * a non-ASCII character. Same as fireKeySequence, the keypress will not fire<tr><td><a id="l236"></a><a href="#l236">236</a><td> * if preventDefault is called on the keydown.<tr><td><a id="l237"></a><a href="#l237">237</a><td> *<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l239"></a><a href="#l239">239</a><td> * @param {number} keyCode The keycode of the keydown and keyup events.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {number} keyPressKeyCode The keycode of the keypress event.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l242"></a><a href="#l242">242</a><td> *     BrowserEvent.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @return {boolean} The returnValue of the sequence: false if preventDefault()<tr><td><a id="l244"></a><a href="#l244">244</a><td> *     was called on any of the events, true otherwise.<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>goog.testing.events.fireNonAsciiKeySequence = function(<tr><td><a id="l247"></a><a href="#l247">247</a><td>    target, keyCode, keyPressKeyCode, opt_eventProperties) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>  var keydown =<tr><td><a id="l249"></a><a href="#l249">249</a><td>      new goog.testing.events.Event(goog.events.EventType.KEYDOWN, target);<tr><td><a id="l250"></a><a href="#l250">250</a><td>  var keyup =<tr><td><a id="l251"></a><a href="#l251">251</a><td>      new goog.testing.events.Event(goog.events.EventType.KEYUP, target);<tr><td><a id="l252"></a><a href="#l252">252</a><td>  var keypress =<tr><td><a id="l253"></a><a href="#l253">253</a><td>      new goog.testing.events.Event(goog.events.EventType.KEYPRESS, target);<tr><td><a id="l254"></a><a href="#l254">254</a><td>  keydown.keyCode = keyup.keyCode = keyCode;<tr><td><a id="l255"></a><a href="#l255">255</a><td>  keypress.keyCode = keyPressKeyCode;<tr><td><a id="l256"></a><a href="#l256">256</a><td><tr><td><a id="l257"></a><a href="#l257">257</a><td>  if (opt_eventProperties) {<tr><td><a id="l258"></a><a href="#l258">258</a><td>    goog.object.extend(keydown, opt_eventProperties);<tr><td><a id="l259"></a><a href="#l259">259</a><td>    goog.object.extend(keyup, opt_eventProperties);<tr><td><a id="l260"></a><a href="#l260">260</a><td>    goog.object.extend(keypress, opt_eventProperties);<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>  // Fire keydown, keypress, and keyup. Note that if the keydown is<tr><td><a id="l264"></a><a href="#l264">264</a><td>  // prevent-defaulted, then the keypress will not fire.<tr><td><a id="l265"></a><a href="#l265">265</a><td>  var result = true;<tr><td><a id="l266"></a><a href="#l266">266</a><td>  if (!goog.testing.events.isBrokenGeckoMacActionKey_(keydown)) {<tr><td><a id="l267"></a><a href="#l267">267</a><td>    result = goog.testing.events.fireBrowserEvent(keydown);<tr><td><a id="l268"></a><a href="#l268">268</a><td>  }<tr><td><a id="l269"></a><a href="#l269">269</a><td>  if (goog.events.KeyCodes.firesKeyPressEvent(<tr><td><a id="l270"></a><a href="#l270">270</a><td>      keyCode, undefined, keydown.shiftKey, keydown.ctrlKey,<tr><td><a id="l271"></a><a href="#l271">271</a><td>      keydown.altKey) &amp;&amp; result) {<tr><td><a id="l272"></a><a href="#l272">272</a><td>    result &amp;= goog.testing.events.fireBrowserEvent(keypress);<tr><td><a id="l273"></a><a href="#l273">273</a><td>  }<tr><td><a id="l274"></a><a href="#l274">274</a><td>  return !!(result &amp; goog.testing.events.fireBrowserEvent(keyup));<tr><td><a id="l275"></a><a href="#l275">275</a><td>};<tr><td><a id="l276"></a><a href="#l276">276</a><td><tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td>/**<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {goog.testing.events.Event} e The event.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @return {boolean} Whether this is the Gecko/Mac&#39;s Meta-C/V/X, which<tr><td><a id="l281"></a><a href="#l281">281</a><td> *     is broken and requires special handling.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @private<tr><td><a id="l283"></a><a href="#l283">283</a><td> */<tr><td><a id="l284"></a><a href="#l284">284</a><td>goog.testing.events.isBrokenGeckoMacActionKey_ = function(e) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>  return goog.userAgent.MAC &amp;&amp; goog.userAgent.GECKO &amp;&amp;<tr><td><a id="l286"></a><a href="#l286">286</a><td>      (e.keyCode == goog.events.KeyCodes.C ||<tr><td><a id="l287"></a><a href="#l287">287</a><td>       e.keyCode == goog.events.KeyCodes.X ||<tr><td><a id="l288"></a><a href="#l288">288</a><td>       e.keyCode == goog.events.KeyCodes.V) &amp;&amp; e.metaKey;<tr><td><a id="l289"></a><a href="#l289">289</a><td>};<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> * Simulates a mouseenter event on the given target.<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {!EventTarget} target The target for the event.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @param {?EventTarget} relatedTarget The related target for the event (e.g.,<tr><td><a id="l296"></a><a href="#l296">296</a><td> *     the node that the mouse is being moved out of).<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @param {!goog.math.Coordinate=} opt_coords Mouse position. Defaults to<tr><td><a id="l298"></a><a href="#l298">298</a><td> *     event&#39;s target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l299"></a><a href="#l299">299</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l300"></a><a href="#l300">300</a><td> *     called on it, true otherwise.<tr><td><a id="l301"></a><a href="#l301">301</a><td> */<tr><td><a id="l302"></a><a href="#l302">302</a><td>goog.testing.events.fireMouseEnterEvent = function(target, relatedTarget,<tr><td><a id="l303"></a><a href="#l303">303</a><td>    opt_coords) {<tr><td><a id="l304"></a><a href="#l304">304</a><td>  var mouseenter =<tr><td><a id="l305"></a><a href="#l305">305</a><td>      new goog.testing.events.Event(goog.events.EventType.MOUSEENTER, target);<tr><td><a id="l306"></a><a href="#l306">306</a><td>  mouseenter.relatedTarget = relatedTarget;<tr><td><a id="l307"></a><a href="#l307">307</a><td>  goog.testing.events.setEventClientXY_(mouseenter, opt_coords);<tr><td><a id="l308"></a><a href="#l308">308</a><td>  return goog.testing.events.fireBrowserEvent(mouseenter);<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><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Simulates a mouseleave event on the given target.<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @param {!EventTarget} target The target for the event.<tr><td><a id="l315"></a><a href="#l315">315</a><td> * @param {?EventTarget} relatedTarget The related target for the event (e.g.,<tr><td><a id="l316"></a><a href="#l316">316</a><td> *     the node that the mouse is being moved into).<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @param {!goog.math.Coordinate=} opt_coords Mouse position. Defaults to<tr><td><a id="l318"></a><a href="#l318">318</a><td> *     event&#39;s target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l320"></a><a href="#l320">320</a><td> *     called on it, true otherwise.<tr><td><a id="l321"></a><a href="#l321">321</a><td> */<tr><td><a id="l322"></a><a href="#l322">322</a><td>goog.testing.events.fireMouseLeaveEvent = function(target, relatedTarget,<tr><td><a id="l323"></a><a href="#l323">323</a><td>    opt_coords) {<tr><td><a id="l324"></a><a href="#l324">324</a><td>  var mouseleave =<tr><td><a id="l325"></a><a href="#l325">325</a><td>      new goog.testing.events.Event(goog.events.EventType.MOUSELEAVE, target);<tr><td><a id="l326"></a><a href="#l326">326</a><td>  mouseleave.relatedTarget = relatedTarget;<tr><td><a id="l327"></a><a href="#l327">327</a><td>  goog.testing.events.setEventClientXY_(mouseleave, opt_coords);<tr><td><a id="l328"></a><a href="#l328">328</a><td>  return goog.testing.events.fireBrowserEvent(mouseleave);<tr><td><a id="l329"></a><a href="#l329">329</a><td>};<tr><td><a id="l330"></a><a href="#l330">330</a><td><tr><td><a id="l331"></a><a href="#l331">331</a><td><tr><td><a id="l332"></a><a href="#l332">332</a><td>/**<tr><td><a id="l333"></a><a href="#l333">333</a><td> * Simulates a mouseover event on the given target.<tr><td><a id="l334"></a><a href="#l334">334</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l335"></a><a href="#l335">335</a><td> * @param {EventTarget} relatedTarget The related target for the event (e.g.,<tr><td><a id="l336"></a><a href="#l336">336</a><td> *     the node that the mouse is being moved out of).<tr><td><a id="l337"></a><a href="#l337">337</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l338"></a><a href="#l338">338</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l339"></a><a href="#l339">339</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l340"></a><a href="#l340">340</a><td> *     called on it, true otherwise.<tr><td><a id="l341"></a><a href="#l341">341</a><td> */<tr><td><a id="l342"></a><a href="#l342">342</a><td>goog.testing.events.fireMouseOverEvent = function(target, relatedTarget,<tr><td><a id="l343"></a><a href="#l343">343</a><td>    opt_coords) {<tr><td><a id="l344"></a><a href="#l344">344</a><td>  var mouseover =<tr><td><a id="l345"></a><a href="#l345">345</a><td>      new goog.testing.events.Event(goog.events.EventType.MOUSEOVER, target);<tr><td><a id="l346"></a><a href="#l346">346</a><td>  mouseover.relatedTarget = relatedTarget;<tr><td><a id="l347"></a><a href="#l347">347</a><td>  goog.testing.events.setEventClientXY_(mouseover, opt_coords);<tr><td><a id="l348"></a><a href="#l348">348</a><td>  return goog.testing.events.fireBrowserEvent(mouseover);<tr><td><a id="l349"></a><a href="#l349">349</a><td>};<tr><td><a id="l350"></a><a href="#l350">350</a><td><tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td>/**<tr><td><a id="l353"></a><a href="#l353">353</a><td> * Simulates a mousemove event on the given target.<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l355"></a><a href="#l355">355</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l356"></a><a href="#l356">356</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l357"></a><a href="#l357">357</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l358"></a><a href="#l358">358</a><td> *     called on it, true otherwise.<tr><td><a id="l359"></a><a href="#l359">359</a><td> */<tr><td><a id="l360"></a><a href="#l360">360</a><td>goog.testing.events.fireMouseMoveEvent = function(target, opt_coords) {<tr><td><a id="l361"></a><a href="#l361">361</a><td>  var mousemove =<tr><td><a id="l362"></a><a href="#l362">362</a><td>      new goog.testing.events.Event(goog.events.EventType.MOUSEMOVE, target);<tr><td><a id="l363"></a><a href="#l363">363</a><td><tr><td><a id="l364"></a><a href="#l364">364</a><td>  goog.testing.events.setEventClientXY_(mousemove, opt_coords);<tr><td><a id="l365"></a><a href="#l365">365</a><td>  return goog.testing.events.fireBrowserEvent(mousemove);<tr><td><a id="l366"></a><a href="#l366">366</a><td>};<tr><td><a id="l367"></a><a href="#l367">367</a><td><tr><td><a id="l368"></a><a href="#l368">368</a><td><tr><td><a id="l369"></a><a href="#l369">369</a><td>/**<tr><td><a id="l370"></a><a href="#l370">370</a><td> * Simulates a mouseout event on the given target.<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l372"></a><a href="#l372">372</a><td> * @param {EventTarget} relatedTarget The related target for the event (e.g.,<tr><td><a id="l373"></a><a href="#l373">373</a><td> *     the node that the mouse is being moved into).<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l375"></a><a href="#l375">375</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l377"></a><a href="#l377">377</a><td> *     called on it, true otherwise.<tr><td><a id="l378"></a><a href="#l378">378</a><td> */<tr><td><a id="l379"></a><a href="#l379">379</a><td>goog.testing.events.fireMouseOutEvent = function(target, relatedTarget,<tr><td><a id="l380"></a><a href="#l380">380</a><td>    opt_coords) {<tr><td><a id="l381"></a><a href="#l381">381</a><td>  var mouseout =<tr><td><a id="l382"></a><a href="#l382">382</a><td>      new goog.testing.events.Event(goog.events.EventType.MOUSEOUT, target);<tr><td><a id="l383"></a><a href="#l383">383</a><td>  mouseout.relatedTarget = relatedTarget;<tr><td><a id="l384"></a><a href="#l384">384</a><td>  goog.testing.events.setEventClientXY_(mouseout, opt_coords);<tr><td><a id="l385"></a><a href="#l385">385</a><td>  return goog.testing.events.fireBrowserEvent(mouseout);<tr><td><a id="l386"></a><a href="#l386">386</a><td>};<tr><td><a id="l387"></a><a href="#l387">387</a><td><tr><td><a id="l388"></a><a href="#l388">388</a><td><tr><td><a id="l389"></a><a href="#l389">389</a><td>/**<tr><td><a id="l390"></a><a href="#l390">390</a><td> * Simulates a mousedown event on the given target.<tr><td><a id="l391"></a><a href="#l391">391</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l392"></a><a href="#l392">392</a><td> * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;<tr><td><a id="l393"></a><a href="#l393">393</a><td> *     defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l395"></a><a href="#l395">395</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l397"></a><a href="#l397">397</a><td> *     BrowserEvent.<tr><td><a id="l398"></a><a href="#l398">398</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l399"></a><a href="#l399">399</a><td> *     called on it, true otherwise.<tr><td><a id="l400"></a><a href="#l400">400</a><td> */<tr><td><a id="l401"></a><a href="#l401">401</a><td>goog.testing.events.fireMouseDownEvent =<tr><td><a id="l402"></a><a href="#l402">402</a><td>    function(target, opt_button, opt_coords, opt_eventProperties) {<tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td>  var button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;<tr><td><a id="l405"></a><a href="#l405">405</a><td>  button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?<tr><td><a id="l406"></a><a href="#l406">406</a><td>      goog.events.BrowserEvent.IEButtonMap[button] : button;<tr><td><a id="l407"></a><a href="#l407">407</a><td>  return goog.testing.events.fireMouseButtonEvent_(<tr><td><a id="l408"></a><a href="#l408">408</a><td>      goog.events.EventType.MOUSEDOWN, target, button, opt_coords,<tr><td><a id="l409"></a><a href="#l409">409</a><td>      opt_eventProperties);<tr><td><a id="l410"></a><a href="#l410">410</a><td>};<tr><td><a id="l411"></a><a href="#l411">411</a><td><tr><td><a id="l412"></a><a href="#l412">412</a><td><tr><td><a id="l413"></a><a href="#l413">413</a><td>/**<tr><td><a id="l414"></a><a href="#l414">414</a><td> * Simulates a mouseup event on the given target.<tr><td><a id="l415"></a><a href="#l415">415</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;<tr><td><a id="l417"></a><a href="#l417">417</a><td> *     defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.<tr><td><a id="l418"></a><a href="#l418">418</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l419"></a><a href="#l419">419</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l421"></a><a href="#l421">421</a><td> *     BrowserEvent.<tr><td><a id="l422"></a><a href="#l422">422</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l423"></a><a href="#l423">423</a><td> *     called on it, true otherwise.<tr><td><a id="l424"></a><a href="#l424">424</a><td> */<tr><td><a id="l425"></a><a href="#l425">425</a><td>goog.testing.events.fireMouseUpEvent =<tr><td><a id="l426"></a><a href="#l426">426</a><td>    function(target, opt_button, opt_coords, opt_eventProperties) {<tr><td><a id="l427"></a><a href="#l427">427</a><td>  var button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;<tr><td><a id="l428"></a><a href="#l428">428</a><td>  button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?<tr><td><a id="l429"></a><a href="#l429">429</a><td>      goog.events.BrowserEvent.IEButtonMap[button] : button;<tr><td><a id="l430"></a><a href="#l430">430</a><td>  return goog.testing.events.fireMouseButtonEvent_(<tr><td><a id="l431"></a><a href="#l431">431</a><td>      goog.events.EventType.MOUSEUP, target, button, opt_coords,<tr><td><a id="l432"></a><a href="#l432">432</a><td>      opt_eventProperties);<tr><td><a id="l433"></a><a href="#l433">433</a><td>};<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> * Simulates a click event on the given target. IE only supports click with<tr><td><a id="l438"></a><a href="#l438">438</a><td> * the left mouse button.<tr><td><a id="l439"></a><a href="#l439">439</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l440"></a><a href="#l440">440</a><td> * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;<tr><td><a id="l441"></a><a href="#l441">441</a><td> *     defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.<tr><td><a id="l442"></a><a href="#l442">442</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l443"></a><a href="#l443">443</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l445"></a><a href="#l445">445</a><td> *     BrowserEvent.<tr><td><a id="l446"></a><a href="#l446">446</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l447"></a><a href="#l447">447</a><td> *     called on it, true otherwise.<tr><td><a id="l448"></a><a href="#l448">448</a><td> */<tr><td><a id="l449"></a><a href="#l449">449</a><td>goog.testing.events.fireClickEvent =<tr><td><a id="l450"></a><a href="#l450">450</a><td>    function(target, opt_button, opt_coords, opt_eventProperties) {<tr><td><a id="l451"></a><a href="#l451">451</a><td>  return goog.testing.events.fireMouseButtonEvent_(goog.events.EventType.CLICK,<tr><td><a id="l452"></a><a href="#l452">452</a><td>      target, opt_button, opt_coords, opt_eventProperties);<tr><td><a id="l453"></a><a href="#l453">453</a><td>};<tr><td><a id="l454"></a><a href="#l454">454</a><td><tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td>/**<tr><td><a id="l457"></a><a href="#l457">457</a><td> * Simulates a double-click event on the given target. Always double-clicks<tr><td><a id="l458"></a><a href="#l458">458</a><td> * with the left mouse button since no browser supports double-clicking with<tr><td><a id="l459"></a><a href="#l459">459</a><td> * any other buttons.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l461"></a><a href="#l461">461</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l462"></a><a href="#l462">462</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l464"></a><a href="#l464">464</a><td> *     BrowserEvent.<tr><td><a id="l465"></a><a href="#l465">465</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l466"></a><a href="#l466">466</a><td> *     called on it, true otherwise.<tr><td><a id="l467"></a><a href="#l467">467</a><td> */<tr><td><a id="l468"></a><a href="#l468">468</a><td>goog.testing.events.fireDoubleClickEvent =<tr><td><a id="l469"></a><a href="#l469">469</a><td>    function(target, opt_coords, opt_eventProperties) {<tr><td><a id="l470"></a><a href="#l470">470</a><td>  return goog.testing.events.fireMouseButtonEvent_(<tr><td><a id="l471"></a><a href="#l471">471</a><td>      goog.events.EventType.DBLCLICK, target,<tr><td><a id="l472"></a><a href="#l472">472</a><td>      goog.events.BrowserEvent.MouseButton.LEFT, opt_coords,<tr><td><a id="l473"></a><a href="#l473">473</a><td>      opt_eventProperties);<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><tr><td><a id="l477"></a><a href="#l477">477</a><td>/**<tr><td><a id="l478"></a><a href="#l478">478</a><td> * Helper function to fire a mouse event.<tr><td><a id="l479"></a><a href="#l479">479</a><td> * with the left mouse button since no browser supports double-clicking with<tr><td><a id="l480"></a><a href="#l480">480</a><td> * any other buttons.<tr><td><a id="l481"></a><a href="#l481">481</a><td> * @param {string} type The event type.<tr><td><a id="l482"></a><a href="#l482">482</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l483"></a><a href="#l483">483</a><td> * @param {number=} opt_button Mouse button; defaults to<tr><td><a id="l484"></a><a href="#l484">484</a><td> *     {@code goog.events.BrowserEvent.MouseButton.LEFT}.<tr><td><a id="l485"></a><a href="#l485">485</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l486"></a><a href="#l486">486</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l487"></a><a href="#l487">487</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l488"></a><a href="#l488">488</a><td> *     BrowserEvent.<tr><td><a id="l489"></a><a href="#l489">489</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l490"></a><a href="#l490">490</a><td> *     called on it, true otherwise.<tr><td><a id="l491"></a><a href="#l491">491</a><td> * @private<tr><td><a id="l492"></a><a href="#l492">492</a><td> */<tr><td><a id="l493"></a><a href="#l493">493</a><td>goog.testing.events.fireMouseButtonEvent_ =<tr><td><a id="l494"></a><a href="#l494">494</a><td>    function(type, target, opt_button, opt_coords, opt_eventProperties) {<tr><td><a id="l495"></a><a href="#l495">495</a><td>  var e =<tr><td><a id="l496"></a><a href="#l496">496</a><td>      new goog.testing.events.Event(type, target);<tr><td><a id="l497"></a><a href="#l497">497</a><td>  e.button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;<tr><td><a id="l498"></a><a href="#l498">498</a><td>  goog.testing.events.setEventClientXY_(e, opt_coords);<tr><td><a id="l499"></a><a href="#l499">499</a><td>  if (opt_eventProperties) {<tr><td><a id="l500"></a><a href="#l500">500</a><td>    goog.object.extend(e, opt_eventProperties);<tr><td><a id="l501"></a><a href="#l501">501</a><td>  }<tr><td><a id="l502"></a><a href="#l502">502</a><td>  return goog.testing.events.fireBrowserEvent(e);<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>/**<tr><td><a id="l507"></a><a href="#l507">507</a><td> * Simulates a contextmenu event on the given target.<tr><td><a id="l508"></a><a href="#l508">508</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l509"></a><a href="#l509">509</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l510"></a><a href="#l510">510</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l511"></a><a href="#l511">511</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l512"></a><a href="#l512">512</a><td> *     called on it, true otherwise.<tr><td><a id="l513"></a><a href="#l513">513</a><td> */<tr><td><a id="l514"></a><a href="#l514">514</a><td>goog.testing.events.fireContextMenuEvent = function(target, opt_coords) {<tr><td><a id="l515"></a><a href="#l515">515</a><td>  var button = (goog.userAgent.MAC &amp;&amp; goog.userAgent.WEBKIT) ?<tr><td><a id="l516"></a><a href="#l516">516</a><td>      goog.events.BrowserEvent.MouseButton.LEFT :<tr><td><a id="l517"></a><a href="#l517">517</a><td>      goog.events.BrowserEvent.MouseButton.RIGHT;<tr><td><a id="l518"></a><a href="#l518">518</a><td>  var contextmenu =<tr><td><a id="l519"></a><a href="#l519">519</a><td>      new goog.testing.events.Event(goog.events.EventType.CONTEXTMENU, target);<tr><td><a id="l520"></a><a href="#l520">520</a><td>  contextmenu.button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?<tr><td><a id="l521"></a><a href="#l521">521</a><td>      goog.events.BrowserEvent.IEButtonMap[button] : button;<tr><td><a id="l522"></a><a href="#l522">522</a><td>  contextmenu.ctrlKey = goog.userAgent.MAC;<tr><td><a id="l523"></a><a href="#l523">523</a><td>  goog.testing.events.setEventClientXY_(contextmenu, opt_coords);<tr><td><a id="l524"></a><a href="#l524">524</a><td>  return goog.testing.events.fireBrowserEvent(contextmenu);<tr><td><a id="l525"></a><a href="#l525">525</a><td>};<tr><td><a id="l526"></a><a href="#l526">526</a><td><tr><td><a id="l527"></a><a href="#l527">527</a><td><tr><td><a id="l528"></a><a href="#l528">528</a><td>/**<tr><td><a id="l529"></a><a href="#l529">529</a><td> * Simulates a mousedown, contextmenu, and the mouseup on the given event<tr><td><a id="l530"></a><a href="#l530">530</a><td> * target, with the right mouse button.<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l532"></a><a href="#l532">532</a><td> * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event&#39;s<tr><td><a id="l533"></a><a href="#l533">533</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l534"></a><a href="#l534">534</a><td> * @return {boolean} The returnValue of the sequence: false if preventDefault()<tr><td><a id="l535"></a><a href="#l535">535</a><td> *     was called on any of the events, true otherwise.<tr><td><a id="l536"></a><a href="#l536">536</a><td> */<tr><td><a id="l537"></a><a href="#l537">537</a><td>goog.testing.events.fireContextMenuSequence = function(target, opt_coords) {<tr><td><a id="l538"></a><a href="#l538">538</a><td>  var props = goog.userAgent.MAC ? {ctrlKey: true} : {};<tr><td><a id="l539"></a><a href="#l539">539</a><td>  var button = (goog.userAgent.MAC &amp;&amp; goog.userAgent.WEBKIT) ?<tr><td><a id="l540"></a><a href="#l540">540</a><td>      goog.events.BrowserEvent.MouseButton.LEFT :<tr><td><a id="l541"></a><a href="#l541">541</a><td>      goog.events.BrowserEvent.MouseButton.RIGHT;<tr><td><a id="l542"></a><a href="#l542">542</a><td><tr><td><a id="l543"></a><a href="#l543">543</a><td>  var result = goog.testing.events.fireMouseDownEvent(target,<tr><td><a id="l544"></a><a href="#l544">544</a><td>      button, opt_coords, props);<tr><td><a id="l545"></a><a href="#l545">545</a><td>  if (goog.userAgent.WINDOWS) {<tr><td><a id="l546"></a><a href="#l546">546</a><td>    // All browsers are consistent on Windows.<tr><td><a id="l547"></a><a href="#l547">547</a><td>    result &amp;= goog.testing.events.fireMouseUpEvent(target,<tr><td><a id="l548"></a><a href="#l548">548</a><td>        button, opt_coords) &amp;<tr><td><a id="l549"></a><a href="#l549">549</a><td>              goog.testing.events.fireContextMenuEvent(target, opt_coords);<tr><td><a id="l550"></a><a href="#l550">550</a><td>  } else {<tr><td><a id="l551"></a><a href="#l551">551</a><td>    result &amp;= goog.testing.events.fireContextMenuEvent(target, opt_coords);<tr><td><a id="l552"></a><a href="#l552">552</a><td><tr><td><a id="l553"></a><a href="#l553">553</a><td>    // GECKO on Mac and Linux always fires the mouseup after the contextmenu.<tr><td><a id="l554"></a><a href="#l554">554</a><td><tr><td><a id="l555"></a><a href="#l555">555</a><td>    // WEBKIT is really weird.<tr><td><a id="l556"></a><a href="#l556">556</a><td>    //<tr><td><a id="l557"></a><a href="#l557">557</a><td>    // On Linux, it sometimes fires mouseup, but most of the time doesn&#39;t.<tr><td><a id="l558"></a><a href="#l558">558</a><td>    // It&#39;s really hard to reproduce consistently. I think there&#39;s some<tr><td><a id="l559"></a><a href="#l559">559</a><td>    // internal race condition. If contextmenu is preventDefaulted, then<tr><td><a id="l560"></a><a href="#l560">560</a><td>    // mouseup always fires.<tr><td><a id="l561"></a><a href="#l561">561</a><td>    //<tr><td><a id="l562"></a><a href="#l562">562</a><td>    // On Mac, it always fires mouseup and then fires a click.<tr><td><a id="l563"></a><a href="#l563">563</a><td>    result &amp;= goog.testing.events.fireMouseUpEvent(target,<tr><td><a id="l564"></a><a href="#l564">564</a><td>        button, opt_coords, props);<tr><td><a id="l565"></a><a href="#l565">565</a><td><tr><td><a id="l566"></a><a href="#l566">566</a><td>    if (goog.userAgent.WEBKIT &amp;&amp; goog.userAgent.MAC) {<tr><td><a id="l567"></a><a href="#l567">567</a><td>      result &amp;= goog.testing.events.fireClickEvent(<tr><td><a id="l568"></a><a href="#l568">568</a><td>          target, button, opt_coords, props);<tr><td><a id="l569"></a><a href="#l569">569</a><td>    }<tr><td><a id="l570"></a><a href="#l570">570</a><td>  }<tr><td><a id="l571"></a><a href="#l571">571</a><td>  return !!result;<tr><td><a id="l572"></a><a href="#l572">572</a><td>};<tr><td><a id="l573"></a><a href="#l573">573</a><td><tr><td><a id="l574"></a><a href="#l574">574</a><td><tr><td><a id="l575"></a><a href="#l575">575</a><td>/**<tr><td><a id="l576"></a><a href="#l576">576</a><td> * Simulates a popstate event on the given target.<tr><td><a id="l577"></a><a href="#l577">577</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l578"></a><a href="#l578">578</a><td> * @param {Object} state History state object.<tr><td><a id="l579"></a><a href="#l579">579</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l580"></a><a href="#l580">580</a><td> *     called on it, true otherwise.<tr><td><a id="l581"></a><a href="#l581">581</a><td> */<tr><td><a id="l582"></a><a href="#l582">582</a><td>goog.testing.events.firePopStateEvent = function(target, state) {<tr><td><a id="l583"></a><a href="#l583">583</a><td>  var e = new goog.testing.events.Event(goog.events.EventType.POPSTATE, target);<tr><td><a id="l584"></a><a href="#l584">584</a><td>  e.state = state;<tr><td><a id="l585"></a><a href="#l585">585</a><td>  return goog.testing.events.fireBrowserEvent(e);<tr><td><a id="l586"></a><a href="#l586">586</a><td>};<tr><td><a id="l587"></a><a href="#l587">587</a><td><tr><td><a id="l588"></a><a href="#l588">588</a><td><tr><td><a id="l589"></a><a href="#l589">589</a><td>/**<tr><td><a id="l590"></a><a href="#l590">590</a><td> * Simulate a blur event on the given target.<tr><td><a id="l591"></a><a href="#l591">591</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l592"></a><a href="#l592">592</a><td> * @return {boolean} The value returned by firing the blur browser event,<tr><td><a id="l593"></a><a href="#l593">593</a><td> *      which returns false iff &#39;preventDefault&#39; was invoked.<tr><td><a id="l594"></a><a href="#l594">594</a><td> */<tr><td><a id="l595"></a><a href="#l595">595</a><td>goog.testing.events.fireBlurEvent = function(target) {<tr><td><a id="l596"></a><a href="#l596">596</a><td>  var e = new goog.testing.events.Event(<tr><td><a id="l597"></a><a href="#l597">597</a><td>      goog.events.EventType.BLUR, target);<tr><td><a id="l598"></a><a href="#l598">598</a><td>  return goog.testing.events.fireBrowserEvent(e);<tr><td><a id="l599"></a><a href="#l599">599</a><td>};<tr><td><a id="l600"></a><a href="#l600">600</a><td><tr><td><a id="l601"></a><a href="#l601">601</a><td><tr><td><a id="l602"></a><a href="#l602">602</a><td>/**<tr><td><a id="l603"></a><a href="#l603">603</a><td> * Simulate a focus event on the given target.<tr><td><a id="l604"></a><a href="#l604">604</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l605"></a><a href="#l605">605</a><td> * @return {boolean} The value returned by firing the focus browser event,<tr><td><a id="l606"></a><a href="#l606">606</a><td> *     which returns false iff &#39;preventDefault&#39; was invoked.<tr><td><a id="l607"></a><a href="#l607">607</a><td> */<tr><td><a id="l608"></a><a href="#l608">608</a><td>goog.testing.events.fireFocusEvent = function(target) {<tr><td><a id="l609"></a><a href="#l609">609</a><td>  var e = new goog.testing.events.Event(<tr><td><a id="l610"></a><a href="#l610">610</a><td>      goog.events.EventType.FOCUS, target);<tr><td><a id="l611"></a><a href="#l611">611</a><td>  return goog.testing.events.fireBrowserEvent(e);<tr><td><a id="l612"></a><a href="#l612">612</a><td>};<tr><td><a id="l613"></a><a href="#l613">613</a><td><tr><td><a id="l614"></a><a href="#l614">614</a><td><tr><td><a id="l615"></a><a href="#l615">615</a><td>/**<tr><td><a id="l616"></a><a href="#l616">616</a><td> * Simulates an event&#39;s capturing and bubbling phases.<tr><td><a id="l617"></a><a href="#l617">617</a><td> * @param {Event} event A simulated native event. It will be wrapped in a<tr><td><a id="l618"></a><a href="#l618">618</a><td> *     normalized BrowserEvent and dispatched to Closure listeners on all<tr><td><a id="l619"></a><a href="#l619">619</a><td> *     ancestors of its target (inclusive).<tr><td><a id="l620"></a><a href="#l620">620</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l621"></a><a href="#l621">621</a><td> *     called on it, true otherwise.<tr><td><a id="l622"></a><a href="#l622">622</a><td> */<tr><td><a id="l623"></a><a href="#l623">623</a><td>goog.testing.events.fireBrowserEvent = function(event) {<tr><td><a id="l624"></a><a href="#l624">624</a><td>  event.returnValue_ = true;<tr><td><a id="l625"></a><a href="#l625">625</a><td><tr><td><a id="l626"></a><a href="#l626">626</a><td>  // generate a list of ancestors<tr><td><a id="l627"></a><a href="#l627">627</a><td>  var ancestors = [];<tr><td><a id="l628"></a><a href="#l628">628</a><td>  for (var current = event.target; current; current = current.parentNode) {<tr><td><a id="l629"></a><a href="#l629">629</a><td>    ancestors.push(current);<tr><td><a id="l630"></a><a href="#l630">630</a><td>  }<tr><td><a id="l631"></a><a href="#l631">631</a><td><tr><td><a id="l632"></a><a href="#l632">632</a><td>  // dispatch capturing listeners<tr><td><a id="l633"></a><a href="#l633">633</a><td>  for (var j = ancestors.length - 1;<tr><td><a id="l634"></a><a href="#l634">634</a><td>       j &gt;= 0 &amp;&amp; !event.propagationStopped_;<tr><td><a id="l635"></a><a href="#l635">635</a><td>       j--) {<tr><td><a id="l636"></a><a href="#l636">636</a><td>    goog.events.fireListeners(ancestors[j], event.type, true,<tr><td><a id="l637"></a><a href="#l637">637</a><td>        new goog.events.BrowserEvent(event, ancestors[j]));<tr><td><a id="l638"></a><a href="#l638">638</a><td>  }<tr><td><a id="l639"></a><a href="#l639">639</a><td><tr><td><a id="l640"></a><a href="#l640">640</a><td>  // dispatch bubbling listeners<tr><td><a id="l641"></a><a href="#l641">641</a><td>  for (var j = 0;<tr><td><a id="l642"></a><a href="#l642">642</a><td>       j &lt; ancestors.length &amp;&amp; !event.propagationStopped_;<tr><td><a id="l643"></a><a href="#l643">643</a><td>       j++) {<tr><td><a id="l644"></a><a href="#l644">644</a><td>    goog.events.fireListeners(ancestors[j], event.type, false,<tr><td><a id="l645"></a><a href="#l645">645</a><td>        new goog.events.BrowserEvent(event, ancestors[j]));<tr><td><a id="l646"></a><a href="#l646">646</a><td>  }<tr><td><a id="l647"></a><a href="#l647">647</a><td><tr><td><a id="l648"></a><a href="#l648">648</a><td>  return event.returnValue_;<tr><td><a id="l649"></a><a href="#l649">649</a><td>};<tr><td><a id="l650"></a><a href="#l650">650</a><td><tr><td><a id="l651"></a><a href="#l651">651</a><td><tr><td><a id="l652"></a><a href="#l652">652</a><td>/**<tr><td><a id="l653"></a><a href="#l653">653</a><td> * Simulates a touchstart event on the given target.<tr><td><a id="l654"></a><a href="#l654">654</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l655"></a><a href="#l655">655</a><td> * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event&#39;s<tr><td><a id="l656"></a><a href="#l656">656</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l657"></a><a href="#l657">657</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l658"></a><a href="#l658">658</a><td> *     BrowserEvent.<tr><td><a id="l659"></a><a href="#l659">659</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l660"></a><a href="#l660">660</a><td> *     called on it, true otherwise.<tr><td><a id="l661"></a><a href="#l661">661</a><td> */<tr><td><a id="l662"></a><a href="#l662">662</a><td>goog.testing.events.fireTouchStartEvent = function(<tr><td><a id="l663"></a><a href="#l663">663</a><td>    target, opt_coords, opt_eventProperties) {<tr><td><a id="l664"></a><a href="#l664">664</a><td>  // TODO: Support multi-touch events with array of coordinates.<tr><td><a id="l665"></a><a href="#l665">665</a><td>  var touchstart =<tr><td><a id="l666"></a><a href="#l666">666</a><td>      new goog.testing.events.Event(goog.events.EventType.TOUCHSTART, target);<tr><td><a id="l667"></a><a href="#l667">667</a><td>  goog.testing.events.setEventClientXY_(touchstart, opt_coords);<tr><td><a id="l668"></a><a href="#l668">668</a><td>  if (opt_eventProperties) {<tr><td><a id="l669"></a><a href="#l669">669</a><td>    goog.object.extend(touchstart, opt_eventProperties);<tr><td><a id="l670"></a><a href="#l670">670</a><td>  }<tr><td><a id="l671"></a><a href="#l671">671</a><td>  return goog.testing.events.fireBrowserEvent(touchstart);<tr><td><a id="l672"></a><a href="#l672">672</a><td>};<tr><td><a id="l673"></a><a href="#l673">673</a><td><tr><td><a id="l674"></a><a href="#l674">674</a><td><tr><td><a id="l675"></a><a href="#l675">675</a><td>/**<tr><td><a id="l676"></a><a href="#l676">676</a><td> * Simulates a touchmove event on the given target.<tr><td><a id="l677"></a><a href="#l677">677</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l678"></a><a href="#l678">678</a><td> * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event&#39;s<tr><td><a id="l679"></a><a href="#l679">679</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l680"></a><a href="#l680">680</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l681"></a><a href="#l681">681</a><td> *     BrowserEvent.<tr><td><a id="l682"></a><a href="#l682">682</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l683"></a><a href="#l683">683</a><td> *     called on it, true otherwise.<tr><td><a id="l684"></a><a href="#l684">684</a><td> */<tr><td><a id="l685"></a><a href="#l685">685</a><td>goog.testing.events.fireTouchMoveEvent = function(<tr><td><a id="l686"></a><a href="#l686">686</a><td>    target, opt_coords, opt_eventProperties) {<tr><td><a id="l687"></a><a href="#l687">687</a><td>  // TODO: Support multi-touch events with array of coordinates.<tr><td><a id="l688"></a><a href="#l688">688</a><td>  var touchmove =<tr><td><a id="l689"></a><a href="#l689">689</a><td>      new goog.testing.events.Event(goog.events.EventType.TOUCHMOVE, target);<tr><td><a id="l690"></a><a href="#l690">690</a><td>  goog.testing.events.setEventClientXY_(touchmove, opt_coords);<tr><td><a id="l691"></a><a href="#l691">691</a><td>  if (opt_eventProperties) {<tr><td><a id="l692"></a><a href="#l692">692</a><td>    goog.object.extend(touchmove, opt_eventProperties);<tr><td><a id="l693"></a><a href="#l693">693</a><td>  }<tr><td><a id="l694"></a><a href="#l694">694</a><td>  return goog.testing.events.fireBrowserEvent(touchmove);<tr><td><a id="l695"></a><a href="#l695">695</a><td>};<tr><td><a id="l696"></a><a href="#l696">696</a><td><tr><td><a id="l697"></a><a href="#l697">697</a><td><tr><td><a id="l698"></a><a href="#l698">698</a><td>/**<tr><td><a id="l699"></a><a href="#l699">699</a><td> * Simulates a touchend event on the given target.<tr><td><a id="l700"></a><a href="#l700">700</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l701"></a><a href="#l701">701</a><td> * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event&#39;s<tr><td><a id="l702"></a><a href="#l702">702</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l703"></a><a href="#l703">703</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l704"></a><a href="#l704">704</a><td> *     BrowserEvent.<tr><td><a id="l705"></a><a href="#l705">705</a><td> * @return {boolean} The returnValue of the event: false if preventDefault() was<tr><td><a id="l706"></a><a href="#l706">706</a><td> *     called on it, true otherwise.<tr><td><a id="l707"></a><a href="#l707">707</a><td> */<tr><td><a id="l708"></a><a href="#l708">708</a><td>goog.testing.events.fireTouchEndEvent = function(<tr><td><a id="l709"></a><a href="#l709">709</a><td>    target, opt_coords, opt_eventProperties) {<tr><td><a id="l710"></a><a href="#l710">710</a><td>  // TODO: Support multi-touch events with array of coordinates.<tr><td><a id="l711"></a><a href="#l711">711</a><td>  var touchend =<tr><td><a id="l712"></a><a href="#l712">712</a><td>      new goog.testing.events.Event(goog.events.EventType.TOUCHEND, target);<tr><td><a id="l713"></a><a href="#l713">713</a><td>  goog.testing.events.setEventClientXY_(touchend, opt_coords);<tr><td><a id="l714"></a><a href="#l714">714</a><td>  if (opt_eventProperties) {<tr><td><a id="l715"></a><a href="#l715">715</a><td>    goog.object.extend(touchend, opt_eventProperties);<tr><td><a id="l716"></a><a href="#l716">716</a><td>  }<tr><td><a id="l717"></a><a href="#l717">717</a><td>  return goog.testing.events.fireBrowserEvent(touchend);<tr><td><a id="l718"></a><a href="#l718">718</a><td>};<tr><td><a id="l719"></a><a href="#l719">719</a><td><tr><td><a id="l720"></a><a href="#l720">720</a><td><tr><td><a id="l721"></a><a href="#l721">721</a><td>/**<tr><td><a id="l722"></a><a href="#l722">722</a><td> * Simulates a simple touch sequence on the given target.<tr><td><a id="l723"></a><a href="#l723">723</a><td> * @param {EventTarget} target The target for the event.<tr><td><a id="l724"></a><a href="#l724">724</a><td> * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event<tr><td><a id="l725"></a><a href="#l725">725</a><td> *     target&#39;s position (if available), otherwise (0, 0).<tr><td><a id="l726"></a><a href="#l726">726</a><td> * @param {Object=} opt_eventProperties Event properties to be mixed into the<tr><td><a id="l727"></a><a href="#l727">727</a><td> *     BrowserEvent.<tr><td><a id="l728"></a><a href="#l728">728</a><td> * @return {boolean} The returnValue of the sequence: false if preventDefault()<tr><td><a id="l729"></a><a href="#l729">729</a><td> *     was called on any of the events, true otherwise.<tr><td><a id="l730"></a><a href="#l730">730</a><td> */<tr><td><a id="l731"></a><a href="#l731">731</a><td>goog.testing.events.fireTouchSequence = function(<tr><td><a id="l732"></a><a href="#l732">732</a><td>    target, opt_coords, opt_eventProperties) {<tr><td><a id="l733"></a><a href="#l733">733</a><td>  // TODO: Support multi-touch events with array of coordinates.<tr><td><a id="l734"></a><a href="#l734">734</a><td>  // Fire touchstart, touchmove, touchend then return the bitwise AND of the 3.<tr><td><a id="l735"></a><a href="#l735">735</a><td>  return !!(goog.testing.events.fireTouchStartEvent(<tr><td><a id="l736"></a><a href="#l736">736</a><td>      target, opt_coords, opt_eventProperties) &amp;<tr><td><a id="l737"></a><a href="#l737">737</a><td>            goog.testing.events.fireTouchEndEvent(<tr><td><a id="l738"></a><a href="#l738">738</a><td>                target, opt_coords, opt_eventProperties));<tr><td><a id="l739"></a><a href="#l739">739</a><td>};<tr><td><a id="l740"></a><a href="#l740">740</a><td><tr><td><a id="l741"></a><a href="#l741">741</a><td><tr><td><a id="l742"></a><a href="#l742">742</a><td>/**<tr><td><a id="l743"></a><a href="#l743">743</a><td> * Mixins a listenable into the given object. This turns the object<tr><td><a id="l744"></a><a href="#l744">744</a><td> * into a goog.events.Listenable. This is useful, for example, when<tr><td><a id="l745"></a><a href="#l745">745</a><td> * you need to mock a implementation of listenable and still want it<tr><td><a id="l746"></a><a href="#l746">746</a><td> * to work with goog.events.<tr><td><a id="l747"></a><a href="#l747">747</a><td> * @param {!Object} obj The object to mixin into.<tr><td><a id="l748"></a><a href="#l748">748</a><td> */<tr><td><a id="l749"></a><a href="#l749">749</a><td>goog.testing.events.mixinListenable = function(obj) {<tr><td><a id="l750"></a><a href="#l750">750</a><td>  var listenable = new goog.events.EventTarget();<tr><td><a id="l751"></a><a href="#l751">751</a><td><tr><td><a id="l752"></a><a href="#l752">752</a><td>  listenable.setTargetForTesting(obj);<tr><td><a id="l753"></a><a href="#l753">753</a><td><tr><td><a id="l754"></a><a href="#l754">754</a><td>  var listenablePrototype = goog.events.EventTarget.prototype;<tr><td><a id="l755"></a><a href="#l755">755</a><td>  var disposablePrototype = goog.Disposable.prototype;<tr><td><a id="l756"></a><a href="#l756">756</a><td>  for (var key in listenablePrototype) {<tr><td><a id="l757"></a><a href="#l757">757</a><td>    if (listenablePrototype.hasOwnProperty(key) ||<tr><td><a id="l758"></a><a href="#l758">758</a><td>        disposablePrototype.hasOwnProperty(key)) {<tr><td><a id="l759"></a><a href="#l759">759</a><td>      var member = listenablePrototype[key];<tr><td><a id="l760"></a><a href="#l760">760</a><td>      if (goog.isFunction(member)) {<tr><td><a id="l761"></a><a href="#l761">761</a><td>        obj[key] = goog.bind(member, listenable);<tr><td><a id="l762"></a><a href="#l762">762</a><td>      } else {<tr><td><a id="l763"></a><a href="#l763">763</a><td>        obj[key] = member;<tr><td><a id="l764"></a><a href="#l764">764</a><td>      }<tr><td><a id="l765"></a><a href="#l765">765</a><td>    }<tr><td><a id="l766"></a><a href="#l766">766</a><td>  }<tr><td><a id="l767"></a><a href="#l767">767</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/functionmock.js.src.html b/docs/source/lib/goog/testing/functionmock.js.src.html
new file mode 100644
index 0000000..7689b4b
--- /dev/null
+++ b/docs/source/lib/goog/testing/functionmock.js.src.html
@@ -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>functionmock.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/functionmock.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Enable mocking of functions not attached to objects<tr><td><a id="l17"></a><a href="#l17">17</a><td> * whether they be global / top-level or anonymous methods / closures.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * See the unit tests for usage.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<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>goog.provide(&#39;goog.testing&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.testing.FunctionMock&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.testing.GlobalFunctionMock&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.testing.MethodMock&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.testing.LooseMock&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.testing.Mock&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.testing.PropertyReplacer&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.testing.StrictMock&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * Class used to mock a function. Useful for mocking closures and anonymous<tr><td><a id="l37"></a><a href="#l37">37</a><td> * callbacks etc. Creates a function object that extends goog.testing.Mock.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @param {string=} opt_functionName The optional name of the function to mock.<tr><td><a id="l39"></a><a href="#l39">39</a><td> *     Set to &#39;[anonymous mocked function]&#39; if not passed in.<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l41"></a><a href="#l41">41</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @return {!goog.testing.MockInterface} The mocked function.<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @suppress {missingProperties} Mocks do not fit in the type system well.<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.testing.FunctionMock = function(opt_functionName, opt_strictness) {<tr><td><a id="l46"></a><a href="#l46">46</a><td>  var fn = function() {<tr><td><a id="l47"></a><a href="#l47">47</a><td>    var args = Array.prototype.slice.call(arguments);<tr><td><a id="l48"></a><a href="#l48">48</a><td>    args.splice(0, 0, opt_functionName || &#39;[anonymous mocked function]&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td>    return fn.$mockMethod.apply(fn, args);<tr><td><a id="l50"></a><a href="#l50">50</a><td>  };<tr><td><a id="l51"></a><a href="#l51">51</a><td>  var base = opt_strictness === goog.testing.Mock.LOOSE ?<tr><td><a id="l52"></a><a href="#l52">52</a><td>      goog.testing.LooseMock : goog.testing.StrictMock;<tr><td><a id="l53"></a><a href="#l53">53</a><td>  goog.object.extend(fn, new base({}));<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>  return /** @type {!goog.testing.MockInterface} */ (fn);<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>/**<tr><td><a id="l60"></a><a href="#l60">60</a><td> * Mocks an existing function. Creates a goog.testing.FunctionMock<tr><td><a id="l61"></a><a href="#l61">61</a><td> * and registers it in the given scope with the name specified by functionName.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {Object} scope The scope of the method to be mocked out.<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @param {string} functionName The name of the function we&#39;re going to mock.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l65"></a><a href="#l65">65</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @return {!goog.testing.MockInterface} The mocked method.<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.testing.MethodMock = function(scope, functionName, opt_strictness) {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  if (!(functionName in scope)) {<tr><td><a id="l70"></a><a href="#l70">70</a><td>    throw Error(functionName + &#39; is not a property of the given scope.&#39;);<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>  var fn = goog.testing.FunctionMock(functionName, opt_strictness);<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td>  fn.$propertyReplacer_ = new goog.testing.PropertyReplacer();<tr><td><a id="l76"></a><a href="#l76">76</a><td>  fn.$propertyReplacer_.set(scope, functionName, fn);<tr><td><a id="l77"></a><a href="#l77">77</a><td>  fn.$tearDown = goog.testing.MethodMock.$tearDown;<tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td>  return fn;<tr><td><a id="l80"></a><a href="#l80">80</a><td>};<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>/**<tr><td><a id="l84"></a><a href="#l84">84</a><td> * Resets the global function that we mocked back to its original state.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @this {goog.testing.MockInterface}<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.testing.MethodMock.$tearDown = function() {<tr><td><a id="l88"></a><a href="#l88">88</a><td>  this.$propertyReplacer_.reset();<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>/**<tr><td><a id="l93"></a><a href="#l93">93</a><td> * Mocks a global / top-level function. Creates a goog.testing.MethodMock<tr><td><a id="l94"></a><a href="#l94">94</a><td> * in the global scope with the name specified by functionName.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @param {string} functionName The name of the function we&#39;re going to mock.<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l97"></a><a href="#l97">97</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @return {!goog.testing.MockInterface} The mocked global function.<tr><td><a id="l99"></a><a href="#l99">99</a><td> */<tr><td><a id="l100"></a><a href="#l100">100</a><td>goog.testing.GlobalFunctionMock = function(functionName, opt_strictness) {<tr><td><a id="l101"></a><a href="#l101">101</a><td>  return goog.testing.MethodMock(goog.global, functionName, opt_strictness);<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * Convenience method for creating a mock for a function.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @param {string=} opt_functionName The optional name of the function to mock<tr><td><a id="l108"></a><a href="#l108">108</a><td> *     set to &#39;[anonymous mocked function]&#39; if not passed in.<tr><td><a id="l109"></a><a href="#l109">109</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l110"></a><a href="#l110">110</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @return {!goog.testing.MockInterface} The mocked function.<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.testing.createFunctionMock = function(opt_functionName, opt_strictness) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  return goog.testing.FunctionMock(opt_functionName, opt_strictness);<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> * Convenience method for creating a mock for a method.<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @param {Object} scope The scope of the method to be mocked out.<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @param {string} functionName The name of the function we&#39;re going to mock.<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l123"></a><a href="#l123">123</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @return {!goog.testing.MockInterface} The mocked global function.<tr><td><a id="l125"></a><a href="#l125">125</a><td> */<tr><td><a id="l126"></a><a href="#l126">126</a><td>goog.testing.createMethodMock = function(scope, functionName, opt_strictness) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>  return goog.testing.MethodMock(scope, functionName, opt_strictness);<tr><td><a id="l128"></a><a href="#l128">128</a><td>};<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>/**<tr><td><a id="l132"></a><a href="#l132">132</a><td> * Convenience method for creating a mock for a constructor. Copies class<tr><td><a id="l133"></a><a href="#l133">133</a><td> * members to the mock.<tr><td><a id="l134"></a><a href="#l134">134</a><td> *<tr><td><a id="l135"></a><a href="#l135">135</a><td> * &lt;p&gt;When mocking a constructor to return a mocked instance, remember to create<tr><td><a id="l136"></a><a href="#l136">136</a><td> * the instance mock before mocking the constructor. If you mock the constructor<tr><td><a id="l137"></a><a href="#l137">137</a><td> * first, then the mock framework will be unable to examine the prototype chain<tr><td><a id="l138"></a><a href="#l138">138</a><td> * when creating the mock instance.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {Object} scope The scope of the constructor to be mocked out.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @param {string} constructorName The name of the constructor we&#39;re going to<tr><td><a id="l141"></a><a href="#l141">141</a><td> *     mock.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l143"></a><a href="#l143">143</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @return {!goog.testing.MockInterface} The mocked constructor.<tr><td><a id="l145"></a><a href="#l145">145</a><td> */<tr><td><a id="l146"></a><a href="#l146">146</a><td>goog.testing.createConstructorMock = function(scope, constructorName,<tr><td><a id="l147"></a><a href="#l147">147</a><td>                                              opt_strictness) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  var realConstructor = scope[constructorName];<tr><td><a id="l149"></a><a href="#l149">149</a><td>  var constructorMock = goog.testing.MethodMock(scope, constructorName,<tr><td><a id="l150"></a><a href="#l150">150</a><td>                                                opt_strictness);<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>  // Copy class members from the real constructor to the mock. Do not copy<tr><td><a id="l153"></a><a href="#l153">153</a><td>  // the closure superClass_ property (see goog.inherits), the built-in<tr><td><a id="l154"></a><a href="#l154">154</a><td>  // prototype property, or properties added to Function.prototype<tr><td><a id="l155"></a><a href="#l155">155</a><td>  for (var property in realConstructor) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>    if (property != &#39;superClass_&#39; &amp;&amp;<tr><td><a id="l157"></a><a href="#l157">157</a><td>        property != &#39;prototype&#39; &amp;&amp;<tr><td><a id="l158"></a><a href="#l158">158</a><td>        realConstructor.hasOwnProperty(property)) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>      constructorMock[property] = realConstructor[property];<tr><td><a id="l160"></a><a href="#l160">160</a><td>    }<tr><td><a id="l161"></a><a href="#l161">161</a><td>  }<tr><td><a id="l162"></a><a href="#l162">162</a><td>  return constructorMock;<tr><td><a id="l163"></a><a href="#l163">163</a><td>};<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> * Convenience method for creating a mocks for a global / top-level function.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @param {string} functionName The name of the function we&#39;re going to mock.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l170"></a><a href="#l170">170</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @return {!goog.testing.MockInterface} The mocked global function.<tr><td><a id="l172"></a><a href="#l172">172</a><td> */<tr><td><a id="l173"></a><a href="#l173">173</a><td>goog.testing.createGlobalFunctionMock = function(functionName, opt_strictness) {<tr><td><a id="l174"></a><a href="#l174">174</a><td>  return goog.testing.GlobalFunctionMock(functionName, opt_strictness);<tr><td><a id="l175"></a><a href="#l175">175</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/jsunit.js.src.html b/docs/source/lib/goog/testing/jsunit.js.src.html
new file mode 100644
index 0000000..d93c3b7
--- /dev/null
+++ b/docs/source/lib/goog/testing/jsunit.js.src.html
@@ -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>jsunit.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/jsunit.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Utilities for working with JsUnit.  Writes out the JsUnit file<tr><td><a id="l17"></a><a href="#l17">17</a><td> * that needs to be included in every unit test.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * Testing code should not have dependencies outside of goog.testing so as to<tr><td><a id="l20"></a><a href="#l20">20</a><td> * reduce the chance of masking missing dependencies.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.testing.jsunit&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.dom.TagName&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.testing.TestCase&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.testing.TestRunner&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td>/**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * Base path for JsUnit app files, relative to Closure&#39;s base path.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @type {string}<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.testing.jsunit.BASE_PATH =<tr><td><a id="l36"></a><a href="#l36">36</a><td>    &#39;../../third_party/java/jsunit/core/app/&#39;;<tr><td><a id="l37"></a><a href="#l37">37</a><td><tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td>/**<tr><td><a id="l40"></a><a href="#l40">40</a><td> * Filename for the core JS Unit script.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @type {string}<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.testing.jsunit.CORE_SCRIPT =<tr><td><a id="l44"></a><a href="#l44">44</a><td>    goog.testing.jsunit.BASE_PATH + &#39;jsUnitCore.js&#39;;<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> * @define {boolean} If this code is being parsed by JsTestC, we let it disable<tr><td><a id="l49"></a><a href="#l49">49</a><td> * the onload handler to avoid running the test in JsTestC.<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.define(&#39;goog.testing.jsunit.AUTO_RUN_ONLOAD&#39;, true);<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>/**<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @define {number} Sets a delay in milliseconds after the window onload event<tr><td><a id="l56"></a><a href="#l56">56</a><td> * and running the tests. Used to prevent interference with Selenium and give<tr><td><a id="l57"></a><a href="#l57">57</a><td> * tests with asynchronous operations time to finish loading.<tr><td><a id="l58"></a><a href="#l58">58</a><td> */<tr><td><a id="l59"></a><a href="#l59">59</a><td>goog.define(&#39;goog.testing.jsunit.AUTO_RUN_DELAY_IN_MS&#39;, 500);<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td>(function() {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  // Only allow one global test runner to be created on a page.<tr><td><a id="l64"></a><a href="#l64">64</a><td>  if (goog.global[&#39;G_testRunner&#39;] instanceof goog.testing.TestRunner) {<tr><td><a id="l65"></a><a href="#l65">65</a><td>    return;<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>  // Increases the maximum number of stack frames in Google Chrome from the<tr><td><a id="l69"></a><a href="#l69">69</a><td>  // default 10 to 50 to get more useful stack traces.<tr><td><a id="l70"></a><a href="#l70">70</a><td>  Error.stackTraceLimit = 50;<tr><td><a id="l71"></a><a href="#l71">71</a><td><tr><td><a id="l72"></a><a href="#l72">72</a><td>  // Store a reference to the window&#39;s timeout so that it can&#39;t be overridden<tr><td><a id="l73"></a><a href="#l73">73</a><td>  // by tests.<tr><td><a id="l74"></a><a href="#l74">74</a><td>  /** @type {!Function} */<tr><td><a id="l75"></a><a href="#l75">75</a><td>  var realTimeout = window.setTimeout;<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>  // Check for JsUnit&#39;s test runner (need to check for &gt;2.2 and &lt;=2.2)<tr><td><a id="l78"></a><a href="#l78">78</a><td>  if (top[&#39;JsUnitTestManager&#39;] || top[&#39;jsUnitTestManager&#39;]) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>    // Running inside JsUnit so add support code.<tr><td><a id="l80"></a><a href="#l80">80</a><td>    var path = goog.basePath + goog.testing.jsunit.CORE_SCRIPT;<tr><td><a id="l81"></a><a href="#l81">81</a><td>    document.write(&#39;&lt;script type=&quot;text/javascript&quot; src=&quot;&#39; +<tr><td><a id="l82"></a><a href="#l82">82</a><td>                   path + &#39;&quot;&gt;&lt;/&#39; + &#39;script&gt;&#39;);<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td>  } else {<tr><td><a id="l85"></a><a href="#l85">85</a><td><tr><td><a id="l86"></a><a href="#l86">86</a><td>    // Create a test runner.<tr><td><a id="l87"></a><a href="#l87">87</a><td>    var tr = new goog.testing.TestRunner();<tr><td><a id="l88"></a><a href="#l88">88</a><td><tr><td><a id="l89"></a><a href="#l89">89</a><td>    // Export it so that it can be queried by Selenium and tests that use a<tr><td><a id="l90"></a><a href="#l90">90</a><td>    // compiled test runner.<tr><td><a id="l91"></a><a href="#l91">91</a><td>    goog.exportSymbol(&#39;G_testRunner&#39;, tr);<tr><td><a id="l92"></a><a href="#l92">92</a><td>    goog.exportSymbol(&#39;G_testRunner.initialize&#39;, tr.initialize);<tr><td><a id="l93"></a><a href="#l93">93</a><td>    goog.exportSymbol(&#39;G_testRunner.isInitialized&#39;, tr.isInitialized);<tr><td><a id="l94"></a><a href="#l94">94</a><td>    goog.exportSymbol(&#39;G_testRunner.isFinished&#39;, tr.isFinished);<tr><td><a id="l95"></a><a href="#l95">95</a><td>    goog.exportSymbol(&#39;G_testRunner.isSuccess&#39;, tr.isSuccess);<tr><td><a id="l96"></a><a href="#l96">96</a><td>    goog.exportSymbol(&#39;G_testRunner.getReport&#39;, tr.getReport);<tr><td><a id="l97"></a><a href="#l97">97</a><td>    goog.exportSymbol(&#39;G_testRunner.getRunTime&#39;, tr.getRunTime);<tr><td><a id="l98"></a><a href="#l98">98</a><td>    goog.exportSymbol(&#39;G_testRunner.getNumFilesLoaded&#39;, tr.getNumFilesLoaded);<tr><td><a id="l99"></a><a href="#l99">99</a><td>    goog.exportSymbol(&#39;G_testRunner.setStrict&#39;, tr.setStrict);<tr><td><a id="l100"></a><a href="#l100">100</a><td>    goog.exportSymbol(&#39;G_testRunner.logTestFailure&#39;, tr.logTestFailure);<tr><td><a id="l101"></a><a href="#l101">101</a><td>    goog.exportSymbol(&#39;G_testRunner.getTestResults&#39;, tr.getTestResults);<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td>    // Export debug as a global function for JSUnit compatibility.  This just<tr><td><a id="l104"></a><a href="#l104">104</a><td>    // calls log on the current test case.<tr><td><a id="l105"></a><a href="#l105">105</a><td>    if (!goog.global[&#39;debug&#39;]) {<tr><td><a id="l106"></a><a href="#l106">106</a><td>      goog.exportSymbol(&#39;debug&#39;, goog.bind(tr.log, tr));<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>    // If the application has defined a global error filter, set it now.  This<tr><td><a id="l110"></a><a href="#l110">110</a><td>    // allows users who use a base test include to set the error filter before<tr><td><a id="l111"></a><a href="#l111">111</a><td>    // the testing code is loaded.<tr><td><a id="l112"></a><a href="#l112">112</a><td>    if (goog.global[&#39;G_errorFilter&#39;]) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>      tr.setErrorFilter(goog.global[&#39;G_errorFilter&#39;]);<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>    // Add an error handler to report errors that may occur during<tr><td><a id="l117"></a><a href="#l117">117</a><td>    // initialization of the page.<tr><td><a id="l118"></a><a href="#l118">118</a><td>    var onerror = window.onerror;<tr><td><a id="l119"></a><a href="#l119">119</a><td>    window.onerror = function(error, url, line) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>      // Call any existing onerror handlers.<tr><td><a id="l121"></a><a href="#l121">121</a><td>      if (onerror) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>        onerror(error, url, line);<tr><td><a id="l123"></a><a href="#l123">123</a><td>      }<tr><td><a id="l124"></a><a href="#l124">124</a><td>      if (typeof error == &#39;object&#39;) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>        // Webkit started passing an event object as the only argument to<tr><td><a id="l126"></a><a href="#l126">126</a><td>        // window.onerror.  It doesn&#39;t contain an error message, url or line<tr><td><a id="l127"></a><a href="#l127">127</a><td>        // number.  We therefore log as much info as we can.<tr><td><a id="l128"></a><a href="#l128">128</a><td>        if (error.target &amp;&amp; error.target.tagName == goog.dom.TagName.SCRIPT) {<tr><td><a id="l129"></a><a href="#l129">129</a><td>          tr.logError(&#39;UNKNOWN ERROR: Script &#39; + error.target.src);<tr><td><a id="l130"></a><a href="#l130">130</a><td>        } else {<tr><td><a id="l131"></a><a href="#l131">131</a><td>          tr.logError(&#39;UNKNOWN ERROR: No error information available.&#39;);<tr><td><a id="l132"></a><a href="#l132">132</a><td>        }<tr><td><a id="l133"></a><a href="#l133">133</a><td>      } else {<tr><td><a id="l134"></a><a href="#l134">134</a><td>        tr.logError(&#39;JS ERROR: &#39; + error + &#39;\nURL: &#39; + url + &#39;\nLine: &#39; + line);<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>    // Create an onload handler, if the test runner hasn&#39;t been initialized then<tr><td><a id="l139"></a><a href="#l139">139</a><td>    // no test has been registered with the test runner by the test file.  We<tr><td><a id="l140"></a><a href="#l140">140</a><td>    // then create a new test case and auto discover any tests in the global<tr><td><a id="l141"></a><a href="#l141">141</a><td>    // scope. If this code is being parsed by JsTestC, we let it disable the<tr><td><a id="l142"></a><a href="#l142">142</a><td>    // onload handler to avoid running the test in JsTestC.<tr><td><a id="l143"></a><a href="#l143">143</a><td>    if (goog.testing.jsunit.AUTO_RUN_ONLOAD) {<tr><td><a id="l144"></a><a href="#l144">144</a><td>      var onload = window.onload;<tr><td><a id="l145"></a><a href="#l145">145</a><td>      window.onload = function(e) {<tr><td><a id="l146"></a><a href="#l146">146</a><td>        // Call any existing onload handlers.<tr><td><a id="l147"></a><a href="#l147">147</a><td>        if (onload) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>          onload(e);<tr><td><a id="l149"></a><a href="#l149">149</a><td>        }<tr><td><a id="l150"></a><a href="#l150">150</a><td>        // Wait so that we don&#39;t interfere with WebDriver.<tr><td><a id="l151"></a><a href="#l151">151</a><td>        realTimeout(function() {<tr><td><a id="l152"></a><a href="#l152">152</a><td>          if (!tr.initialized) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>            var testCase = new goog.testing.TestCase(document.title);<tr><td><a id="l154"></a><a href="#l154">154</a><td>            goog.testing.TestCase.initializeTestRunner(testCase);<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.execute();<tr><td><a id="l157"></a><a href="#l157">157</a><td>        }, goog.testing.jsunit.AUTO_RUN_DELAY_IN_MS);<tr><td><a id="l158"></a><a href="#l158">158</a><td>        window.onload = null;<tr><td><a id="l159"></a><a href="#l159">159</a><td>      };<tr><td><a id="l160"></a><a href="#l160">160</a><td>    }<tr><td><a id="l161"></a><a href="#l161">161</a><td>  }<tr><td><a id="l162"></a><a href="#l162">162</a><td>})();</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/loosemock.js.src.html b/docs/source/lib/goog/testing/loosemock.js.src.html
new file mode 100644
index 0000000..1aacbe1
--- /dev/null
+++ b/docs/source/lib/goog/testing/loosemock.js.src.html
@@ -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>loosemock.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/loosemock.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview This file defines a loose mock implementation.<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>goog.provide(&#39;goog.testing.LooseExpectationCollection&#39;);<tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.testing.LooseMock&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.structs.Map&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.testing.Mock&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * This class is an ordered collection of expectations for one method. Since<tr><td><a id="l30"></a><a href="#l30">30</a><td> * the loose mock does most of its verification at the time of $verify, this<tr><td><a id="l31"></a><a href="#l31">31</a><td> * class is necessary to manage the return/throw behavior when the mock is<tr><td><a id="l32"></a><a href="#l32">32</a><td> * being called.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @constructor<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @final<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.testing.LooseExpectationCollection = function() {<tr><td><a id="l37"></a><a href="#l37">37</a><td>  /**<tr><td><a id="l38"></a><a href="#l38">38</a><td>   * The list of expectations. All of these should have the same name.<tr><td><a id="l39"></a><a href="#l39">39</a><td>   * @type {Array&lt;goog.testing.MockExpectation&gt;}<tr><td><a id="l40"></a><a href="#l40">40</a><td>   * @private<tr><td><a id="l41"></a><a href="#l41">41</a><td>   */<tr><td><a id="l42"></a><a href="#l42">42</a><td>  this.expectations_ = [];<tr><td><a id="l43"></a><a href="#l43">43</a><td>};<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * Adds an expectation to this collection.<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @param {goog.testing.MockExpectation} expectation The expectation to add.<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.testing.LooseExpectationCollection.prototype.addExpectation =<tr><td><a id="l51"></a><a href="#l51">51</a><td>    function(expectation) {<tr><td><a id="l52"></a><a href="#l52">52</a><td>  this.expectations_.push(expectation);<tr><td><a id="l53"></a><a href="#l53">53</a><td>};<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * Gets the list of expectations in this collection.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @return {Array&lt;goog.testing.MockExpectation&gt;} The array of expectations.<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.testing.LooseExpectationCollection.prototype.getExpectations = function() {<tr><td><a id="l61"></a><a href="#l61">61</a><td>  return this.expectations_;<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><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> * This is a mock that does not care about the order of method calls. As a<tr><td><a id="l68"></a><a href="#l68">68</a><td> * result, it won&#39;t throw exceptions until verify() is called. The only<tr><td><a id="l69"></a><a href="#l69">69</a><td> * exception is that if a method is called that has no expectations, then an<tr><td><a id="l70"></a><a href="#l70">70</a><td> * exception will be thrown.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @param {Object|Function} objectToMock The object that should be mocked, or<tr><td><a id="l72"></a><a href="#l72">72</a><td> *    the constructor of an object to mock.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @param {boolean=} opt_ignoreUnexpectedCalls Whether to ignore unexpected<tr><td><a id="l74"></a><a href="#l74">74</a><td> *     calls.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {boolean=} opt_mockStaticMethods An optional argument denoting that<tr><td><a id="l76"></a><a href="#l76">76</a><td> *     a mock should be constructed from the static functions of a class.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {boolean=} opt_createProxy An optional argument denoting that<tr><td><a id="l78"></a><a href="#l78">78</a><td> *     a proxy for the target mock should be created.<tr><td><a id="l79"></a><a href="#l79">79</a><td> * @constructor<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @extends {goog.testing.Mock}<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>goog.testing.LooseMock = function(objectToMock, opt_ignoreUnexpectedCalls,<tr><td><a id="l83"></a><a href="#l83">83</a><td>    opt_mockStaticMethods, opt_createProxy) {<tr><td><a id="l84"></a><a href="#l84">84</a><td>  goog.testing.Mock.call(this, objectToMock, opt_mockStaticMethods,<tr><td><a id="l85"></a><a href="#l85">85</a><td>      opt_createProxy);<tr><td><a id="l86"></a><a href="#l86">86</a><td><tr><td><a id="l87"></a><a href="#l87">87</a><td>  /**<tr><td><a id="l88"></a><a href="#l88">88</a><td>   * A map of method names to a LooseExpectationCollection for that method.<tr><td><a id="l89"></a><a href="#l89">89</a><td>   * @type {goog.structs.Map}<tr><td><a id="l90"></a><a href="#l90">90</a><td>   * @private<tr><td><a id="l91"></a><a href="#l91">91</a><td>   */<tr><td><a id="l92"></a><a href="#l92">92</a><td>  this.$expectations_ = new goog.structs.Map();<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>   * The calls that have been made; we cache them to verify at the end. Each<tr><td><a id="l96"></a><a href="#l96">96</a><td>   * element is an array where the first element is the name, and the second<tr><td><a id="l97"></a><a href="#l97">97</a><td>   * element is the arguments.<tr><td><a id="l98"></a><a href="#l98">98</a><td>   * @type {Array&lt;Array&lt;*&gt;&gt;}<tr><td><a id="l99"></a><a href="#l99">99</a><td>   * @private<tr><td><a id="l100"></a><a href="#l100">100</a><td>   */<tr><td><a id="l101"></a><a href="#l101">101</a><td>  this.$calls_ = [];<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>   * Whether to ignore unexpected calls.<tr><td><a id="l105"></a><a href="#l105">105</a><td>   * @type {boolean}<tr><td><a id="l106"></a><a href="#l106">106</a><td>   * @private<tr><td><a id="l107"></a><a href="#l107">107</a><td>   */<tr><td><a id="l108"></a><a href="#l108">108</a><td>  this.$ignoreUnexpectedCalls_ = !!opt_ignoreUnexpectedCalls;<tr><td><a id="l109"></a><a href="#l109">109</a><td>};<tr><td><a id="l110"></a><a href="#l110">110</a><td>goog.inherits(goog.testing.LooseMock, goog.testing.Mock);<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> * A setter for the ignoreUnexpectedCalls field.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {boolean} ignoreUnexpectedCalls Whether to ignore unexpected calls.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @return {!goog.testing.LooseMock} This mock object.<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.testing.LooseMock.prototype.$setIgnoreUnexpectedCalls = function(<tr><td><a id="l119"></a><a href="#l119">119</a><td>    ignoreUnexpectedCalls) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>  this.$ignoreUnexpectedCalls_ = ignoreUnexpectedCalls;<tr><td><a id="l121"></a><a href="#l121">121</a><td>  return this;<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<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>/** @override */<tr><td><a id="l126"></a><a href="#l126">126</a><td>goog.testing.LooseMock.prototype.$recordExpectation = function() {<tr><td><a id="l127"></a><a href="#l127">127</a><td>  if (!this.$expectations_.containsKey(this.$pendingExpectation.name)) {<tr><td><a id="l128"></a><a href="#l128">128</a><td>    this.$expectations_.set(this.$pendingExpectation.name,<tr><td><a id="l129"></a><a href="#l129">129</a><td>        new goog.testing.LooseExpectationCollection());<tr><td><a id="l130"></a><a href="#l130">130</a><td>  }<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>  var collection = this.$expectations_.get(this.$pendingExpectation.name);<tr><td><a id="l133"></a><a href="#l133">133</a><td>  collection.addExpectation(this.$pendingExpectation);<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><tr><td><a id="l137"></a><a href="#l137">137</a><td>/** @override */<tr><td><a id="l138"></a><a href="#l138">138</a><td>goog.testing.LooseMock.prototype.$recordCall = function(name, args) {<tr><td><a id="l139"></a><a href="#l139">139</a><td>  if (!this.$expectations_.containsKey(name)) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>    if (this.$ignoreUnexpectedCalls_) {<tr><td><a id="l141"></a><a href="#l141">141</a><td>      return;<tr><td><a id="l142"></a><a href="#l142">142</a><td>    }<tr><td><a id="l143"></a><a href="#l143">143</a><td>    this.$throwCallException(name, args);<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>  // Start from the beginning of the expectations for this name,<tr><td><a id="l147"></a><a href="#l147">147</a><td>  // and iterate over them until we find an expectation that matches<tr><td><a id="l148"></a><a href="#l148">148</a><td>  // and also has calls remaining.<tr><td><a id="l149"></a><a href="#l149">149</a><td>  var collection = this.$expectations_.get(name);<tr><td><a id="l150"></a><a href="#l150">150</a><td>  var matchingExpectation = null;<tr><td><a id="l151"></a><a href="#l151">151</a><td>  var expectations = collection.getExpectations();<tr><td><a id="l152"></a><a href="#l152">152</a><td>  for (var i = 0; i &lt; expectations.length; i++) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>    var expectation = expectations[i];<tr><td><a id="l154"></a><a href="#l154">154</a><td>    if (this.$verifyCall(expectation, name, args)) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>      matchingExpectation = expectation;<tr><td><a id="l156"></a><a href="#l156">156</a><td>      if (expectation.actualCalls &lt; expectation.maxCalls) {<tr><td><a id="l157"></a><a href="#l157">157</a><td>        break;<tr><td><a id="l158"></a><a href="#l158">158</a><td>      } // else continue and see if we can find something that does match<tr><td><a id="l159"></a><a href="#l159">159</a><td>    }<tr><td><a id="l160"></a><a href="#l160">160</a><td>  }<tr><td><a id="l161"></a><a href="#l161">161</a><td>  if (matchingExpectation == null) {<tr><td><a id="l162"></a><a href="#l162">162</a><td>    this.$throwCallException(name, args, expectation);<tr><td><a id="l163"></a><a href="#l163">163</a><td>  }<tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td>  matchingExpectation.actualCalls++;<tr><td><a id="l166"></a><a href="#l166">166</a><td>  if (matchingExpectation.actualCalls &gt; matchingExpectation.maxCalls) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>    this.$throwException(&#39;Too many calls to &#39; + matchingExpectation.name +<tr><td><a id="l168"></a><a href="#l168">168</a><td>            &#39;\nExpected: &#39; + matchingExpectation.maxCalls + &#39; but was: &#39; +<tr><td><a id="l169"></a><a href="#l169">169</a><td>            matchingExpectation.actualCalls);<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>  this.$calls_.push([name, args]);<tr><td><a id="l173"></a><a href="#l173">173</a><td>  return this.$do(matchingExpectation, args);<tr><td><a id="l174"></a><a href="#l174">174</a><td>};<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/** @override */<tr><td><a id="l178"></a><a href="#l178">178</a><td>goog.testing.LooseMock.prototype.$reset = function() {<tr><td><a id="l179"></a><a href="#l179">179</a><td>  goog.testing.LooseMock.superClass_.$reset.call(this);<tr><td><a id="l180"></a><a href="#l180">180</a><td><tr><td><a id="l181"></a><a href="#l181">181</a><td>  this.$expectations_ = new goog.structs.Map();<tr><td><a id="l182"></a><a href="#l182">182</a><td>  this.$calls_ = [];<tr><td><a id="l183"></a><a href="#l183">183</a><td>};<tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td>/** @override */<tr><td><a id="l187"></a><a href="#l187">187</a><td>goog.testing.LooseMock.prototype.$replay = function() {<tr><td><a id="l188"></a><a href="#l188">188</a><td>  goog.testing.LooseMock.superClass_.$replay.call(this);<tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td>  // Verify that there are no expectations that can never be reached.<tr><td><a id="l191"></a><a href="#l191">191</a><td>  // This can&#39;t catch every situation, but it is a decent sanity check<tr><td><a id="l192"></a><a href="#l192">192</a><td>  // and it&#39;s similar to the behavior of EasyMock in java.<tr><td><a id="l193"></a><a href="#l193">193</a><td>  var collections = this.$expectations_.getValues();<tr><td><a id="l194"></a><a href="#l194">194</a><td>  for (var i = 0; i &lt; collections.length; i++) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>    var expectations = collections[i].getExpectations();<tr><td><a id="l196"></a><a href="#l196">196</a><td>    for (var j = 0; j &lt; expectations.length; j++) {<tr><td><a id="l197"></a><a href="#l197">197</a><td>      var expectation = expectations[j];<tr><td><a id="l198"></a><a href="#l198">198</a><td>      // If this expectation can be called infinite times, then<tr><td><a id="l199"></a><a href="#l199">199</a><td>      // check if any subsequent expectation has the exact same<tr><td><a id="l200"></a><a href="#l200">200</a><td>      // argument list.<tr><td><a id="l201"></a><a href="#l201">201</a><td>      if (!isFinite(expectation.maxCalls)) {<tr><td><a id="l202"></a><a href="#l202">202</a><td>        for (var k = j + 1; k &lt; expectations.length; k++) {<tr><td><a id="l203"></a><a href="#l203">203</a><td>          var laterExpectation = expectations[k];<tr><td><a id="l204"></a><a href="#l204">204</a><td>          if (laterExpectation.minCalls &gt; 0 &amp;&amp;<tr><td><a id="l205"></a><a href="#l205">205</a><td>              goog.array.equals(expectation.argumentList,<tr><td><a id="l206"></a><a href="#l206">206</a><td>                  laterExpectation.argumentList)) {<tr><td><a id="l207"></a><a href="#l207">207</a><td>            var name = expectation.name;<tr><td><a id="l208"></a><a href="#l208">208</a><td>            var argsString = this.$argumentsAsString(expectation.argumentList);<tr><td><a id="l209"></a><a href="#l209">209</a><td>            this.$throwException([<tr><td><a id="l210"></a><a href="#l210">210</a><td>              &#39;Expected call to &#39;, name, &#39; with arguments &#39;, argsString,<tr><td><a id="l211"></a><a href="#l211">211</a><td>              &#39; has an infinite max number of calls; can\&#39;t expect an&#39;,<tr><td><a id="l212"></a><a href="#l212">212</a><td>              &#39; identical call later with a positive min number of calls&#39;<tr><td><a id="l213"></a><a href="#l213">213</a><td>            ].join(&#39;&#39;));<tr><td><a id="l214"></a><a href="#l214">214</a><td>          }<tr><td><a id="l215"></a><a href="#l215">215</a><td>        }<tr><td><a id="l216"></a><a href="#l216">216</a><td>      }<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><tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td>/** @override */<tr><td><a id="l223"></a><a href="#l223">223</a><td>goog.testing.LooseMock.prototype.$verify = function() {<tr><td><a id="l224"></a><a href="#l224">224</a><td>  goog.testing.LooseMock.superClass_.$verify.call(this);<tr><td><a id="l225"></a><a href="#l225">225</a><td>  var collections = this.$expectations_.getValues();<tr><td><a id="l226"></a><a href="#l226">226</a><td><tr><td><a id="l227"></a><a href="#l227">227</a><td>  for (var i = 0; i &lt; collections.length; i++) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>    var expectations = collections[i].getExpectations();<tr><td><a id="l229"></a><a href="#l229">229</a><td>    for (var j = 0; j &lt; expectations.length; j++) {<tr><td><a id="l230"></a><a href="#l230">230</a><td>      var expectation = expectations[j];<tr><td><a id="l231"></a><a href="#l231">231</a><td>      if (expectation.actualCalls &gt; expectation.maxCalls) {<tr><td><a id="l232"></a><a href="#l232">232</a><td>        this.$throwException(&#39;Too many calls to &#39; + expectation.name +<tr><td><a id="l233"></a><a href="#l233">233</a><td>            &#39;\nExpected: &#39; + expectation.maxCalls + &#39; but was: &#39; +<tr><td><a id="l234"></a><a href="#l234">234</a><td>            expectation.actualCalls);<tr><td><a id="l235"></a><a href="#l235">235</a><td>      } else if (expectation.actualCalls &lt; expectation.minCalls) {<tr><td><a id="l236"></a><a href="#l236">236</a><td>        this.$throwException(&#39;Not enough calls to &#39; + expectation.name +<tr><td><a id="l237"></a><a href="#l237">237</a><td>            &#39;\nExpected: &#39; + expectation.minCalls + &#39; but was: &#39; +<tr><td><a id="l238"></a><a href="#l238">238</a><td>            expectation.actualCalls);<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>  }<tr><td><a id="l242"></a><a href="#l242">242</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/mock.js.src.html b/docs/source/lib/goog/testing/mock.js.src.html
new file mode 100644
index 0000000..6793480
--- /dev/null
+++ b/docs/source/lib/goog/testing/mock.js.src.html
@@ -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>mock.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/mock.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview This file defines base classes used for creating mocks in<tr><td><a id="l17"></a><a href="#l17">17</a><td> * JavaScript. The API was inspired by EasyMock.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * The basic API is:<tr><td><a id="l20"></a><a href="#l20">20</a><td> * &lt;ul&gt;<tr><td><a id="l21"></a><a href="#l21">21</a><td> *   &lt;li&gt;Create an object to be mocked<tr><td><a id="l22"></a><a href="#l22">22</a><td> *   &lt;li&gt;Create a mock object, passing in the above object to the constructor<tr><td><a id="l23"></a><a href="#l23">23</a><td> *   &lt;li&gt;Set expectations by calling methods on the mock object<tr><td><a id="l24"></a><a href="#l24">24</a><td> *   &lt;li&gt;Call $replay() on the mock object<tr><td><a id="l25"></a><a href="#l25">25</a><td> *   &lt;li&gt;Pass the mock to code that will make real calls on it<tr><td><a id="l26"></a><a href="#l26">26</a><td> *   &lt;li&gt;Call $verify() to make sure that expectations were met<tr><td><a id="l27"></a><a href="#l27">27</a><td> * &lt;/ul&gt;<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * For examples, please see the unit tests for LooseMock and StrictMock.<tr><td><a id="l30"></a><a href="#l30">30</a><td> *<tr><td><a id="l31"></a><a href="#l31">31</a><td> * Still TODO<tr><td><a id="l32"></a><a href="#l32">32</a><td> *   implement better (and pluggable) argument matching<tr><td><a id="l33"></a><a href="#l33">33</a><td> *   Have the exceptions for LooseMock show the number of expected/actual calls<tr><td><a id="l34"></a><a href="#l34">34</a><td> *   loose and strict mocks share a lot of code - move it to the base class<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>goog.provide(&#39;goog.testing.Mock&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.provide(&#39;goog.testing.MockExpectation&#39;);<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.require(&#39;goog.array&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.testing.JsUnitException&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;goog.testing.MockInterface&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;goog.testing.mockmatchers&#39;);<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>/**<tr><td><a id="l50"></a><a href="#l50">50</a><td> * This is a class that represents an expectation.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @param {string} name The name of the method for this expectation.<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @constructor<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @final<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.testing.MockExpectation = function(name) {<tr><td><a id="l56"></a><a href="#l56">56</a><td>  /**<tr><td><a id="l57"></a><a href="#l57">57</a><td>   * The name of the method that is expected to be called.<tr><td><a id="l58"></a><a href="#l58">58</a><td>   * @type {string}<tr><td><a id="l59"></a><a href="#l59">59</a><td>   */<tr><td><a id="l60"></a><a href="#l60">60</a><td>  this.name = name;<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>   * An array of error messages for expectations not met.<tr><td><a id="l64"></a><a href="#l64">64</a><td>   * @type {Array&lt;string&gt;}<tr><td><a id="l65"></a><a href="#l65">65</a><td>   */<tr><td><a id="l66"></a><a href="#l66">66</a><td>  this.errorMessages = [];<tr><td><a id="l67"></a><a href="#l67">67</a><td>};<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>/**<tr><td><a id="l71"></a><a href="#l71">71</a><td> * The minimum number of times this method should be called.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @type {number}<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td>goog.testing.MockExpectation.prototype.minCalls = 1;<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/**<tr><td><a id="l78"></a><a href="#l78">78</a><td>  * The maximum number of times this method should be called.<tr><td><a id="l79"></a><a href="#l79">79</a><td>  * @type {number}<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.testing.MockExpectation.prototype.maxCalls = 1;<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> * The value that this method should return.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @type {*}<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>goog.testing.MockExpectation.prototype.returnValue;<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> * The value that will be thrown when the method is called<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @type {*}<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.testing.MockExpectation.prototype.exceptionToThrow;<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> * The arguments that are expected to be passed to this function<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @type {Array&lt;*&gt;}<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>goog.testing.MockExpectation.prototype.argumentList;<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * The number of times this method is called by real code.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @type {number}<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.testing.MockExpectation.prototype.actualCalls = 0;<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> * The number of times this method is called during the verification phase.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @type {number}<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.testing.MockExpectation.prototype.verificationCalls = 0;<tr><td><a id="l117"></a><a href="#l117">117</a><td><tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td>/**<tr><td><a id="l120"></a><a href="#l120">120</a><td> * The function which will be executed when this method is called.<tr><td><a id="l121"></a><a href="#l121">121</a><td> * Method arguments will be passed to this function, and return value<tr><td><a id="l122"></a><a href="#l122">122</a><td> * of this function will be returned by the method.<tr><td><a id="l123"></a><a href="#l123">123</a><td> * @type {Function}<tr><td><a id="l124"></a><a href="#l124">124</a><td> */<tr><td><a id="l125"></a><a href="#l125">125</a><td>goog.testing.MockExpectation.prototype.toDo;<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>/**<tr><td><a id="l129"></a><a href="#l129">129</a><td> * Allow expectation failures to include messages.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {string} message The failure message.<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.testing.MockExpectation.prototype.addErrorMessage = function(message) {<tr><td><a id="l133"></a><a href="#l133">133</a><td>  this.errorMessages.push(message);<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><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Get the error messages seen so far.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @return {string} Error messages separated by \n.<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.testing.MockExpectation.prototype.getErrorMessage = function() {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  return this.errorMessages.join(&#39;\n&#39;);<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> * Get how many error messages have been seen so far.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @return {number} Count of error messages.<tr><td><a id="l149"></a><a href="#l149">149</a><td> */<tr><td><a id="l150"></a><a href="#l150">150</a><td>goog.testing.MockExpectation.prototype.getErrorMessageCount = function() {<tr><td><a id="l151"></a><a href="#l151">151</a><td>  return this.errorMessages.length;<tr><td><a id="l152"></a><a href="#l152">152</a><td>};<tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td><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> * The base class for a mock object.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @param {Object|Function} objectToMock The object that should be mocked, or<tr><td><a id="l159"></a><a href="#l159">159</a><td> *    the constructor of an object to mock.<tr><td><a id="l160"></a><a href="#l160">160</a><td> * @param {boolean=} opt_mockStaticMethods An optional argument denoting that<tr><td><a id="l161"></a><a href="#l161">161</a><td> *     a mock should be constructed from the static functions of a class.<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @param {boolean=} opt_createProxy An optional argument denoting that<tr><td><a id="l163"></a><a href="#l163">163</a><td> *     a proxy for the target mock should be created.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @constructor<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @implements {goog.testing.MockInterface}<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.testing.Mock = function(objectToMock, opt_mockStaticMethods,<tr><td><a id="l168"></a><a href="#l168">168</a><td>    opt_createProxy) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>  if (!goog.isObject(objectToMock) &amp;&amp; !goog.isFunction(objectToMock)) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>    throw new Error(&#39;objectToMock must be an object or constructor.&#39;);<tr><td><a id="l171"></a><a href="#l171">171</a><td>  }<tr><td><a id="l172"></a><a href="#l172">172</a><td>  if (opt_createProxy &amp;&amp; !opt_mockStaticMethods &amp;&amp;<tr><td><a id="l173"></a><a href="#l173">173</a><td>      goog.isFunction(objectToMock)) {<tr><td><a id="l174"></a><a href="#l174">174</a><td>    /**<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @constructor<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @final<tr><td><a id="l177"></a><a href="#l177">177</a><td> */<tr><td><a id="l178"></a><a href="#l178">178</a><td>    var tempCtor = function() {};<tr><td><a id="l179"></a><a href="#l179">179</a><td>    goog.inherits(tempCtor, objectToMock);<tr><td><a id="l180"></a><a href="#l180">180</a><td>    this.$proxy = new tempCtor();<tr><td><a id="l181"></a><a href="#l181">181</a><td>  } else if (opt_createProxy &amp;&amp; opt_mockStaticMethods &amp;&amp;<tr><td><a id="l182"></a><a href="#l182">182</a><td>      goog.isFunction(objectToMock)) {<tr><td><a id="l183"></a><a href="#l183">183</a><td>    throw Error(&#39;Cannot create a proxy when opt_mockStaticMethods is true&#39;);<tr><td><a id="l184"></a><a href="#l184">184</a><td>  } else if (opt_createProxy &amp;&amp; !goog.isFunction(objectToMock)) {<tr><td><a id="l185"></a><a href="#l185">185</a><td>    throw Error(&#39;Must have a constructor to create a proxy&#39;);<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>  if (goog.isFunction(objectToMock) &amp;&amp; !opt_mockStaticMethods) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>    this.$initializeFunctions_(objectToMock.prototype);<tr><td><a id="l190"></a><a href="#l190">190</a><td>  } else {<tr><td><a id="l191"></a><a href="#l191">191</a><td>    this.$initializeFunctions_(objectToMock);<tr><td><a id="l192"></a><a href="#l192">192</a><td>  }<tr><td><a id="l193"></a><a href="#l193">193</a><td>  this.$argumentListVerifiers_ = {};<tr><td><a id="l194"></a><a href="#l194">194</a><td>};<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/**<tr><td><a id="l198"></a><a href="#l198">198</a><td> * Option that may be passed when constructing function, method, and<tr><td><a id="l199"></a><a href="#l199">199</a><td> * constructor mocks. Indicates that the expected calls should be accepted in<tr><td><a id="l200"></a><a href="#l200">200</a><td> * any order.<tr><td><a id="l201"></a><a href="#l201">201</a><td> * @const<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @type {number}<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.testing.Mock.LOOSE = 1;<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td>/**<tr><td><a id="l208"></a><a href="#l208">208</a><td> * Option that may be passed when constructing function, method, and<tr><td><a id="l209"></a><a href="#l209">209</a><td> * constructor mocks. Indicates that the expected calls should be accepted in<tr><td><a id="l210"></a><a href="#l210">210</a><td> * the recorded order only.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @const<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @type {number}<tr><td><a id="l213"></a><a href="#l213">213</a><td> */<tr><td><a id="l214"></a><a href="#l214">214</a><td>goog.testing.Mock.STRICT = 0;<tr><td><a id="l215"></a><a href="#l215">215</a><td><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> * This array contains the name of the functions that are part of the base<tr><td><a id="l219"></a><a href="#l219">219</a><td> * Object prototype.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * Basically a copy of goog.object.PROTOTYPE_FIELDS_.<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @const<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @type {!Array&lt;string&gt;}<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @private<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.testing.Mock.PROTOTYPE_FIELDS_ = [<tr><td><a id="l226"></a><a href="#l226">226</a><td>  &#39;constructor&#39;,<tr><td><a id="l227"></a><a href="#l227">227</a><td>  &#39;hasOwnProperty&#39;,<tr><td><a id="l228"></a><a href="#l228">228</a><td>  &#39;isPrototypeOf&#39;,<tr><td><a id="l229"></a><a href="#l229">229</a><td>  &#39;propertyIsEnumerable&#39;,<tr><td><a id="l230"></a><a href="#l230">230</a><td>  &#39;toLocaleString&#39;,<tr><td><a id="l231"></a><a href="#l231">231</a><td>  &#39;toString&#39;,<tr><td><a id="l232"></a><a href="#l232">232</a><td>  &#39;valueOf&#39;<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>/**<tr><td><a id="l237"></a><a href="#l237">237</a><td> * A proxy for the mock.  This can be used for dependency injection in lieu of<tr><td><a id="l238"></a><a href="#l238">238</a><td> * the mock if the test requires a strict instanceof check.<tr><td><a id="l239"></a><a href="#l239">239</a><td> * @type {Object}<tr><td><a id="l240"></a><a href="#l240">240</a><td> */<tr><td><a id="l241"></a><a href="#l241">241</a><td>goog.testing.Mock.prototype.$proxy = null;<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> * Map of argument name to optional argument list verifier function.<tr><td><a id="l246"></a><a href="#l246">246</a><td> * @type {Object}<tr><td><a id="l247"></a><a href="#l247">247</a><td> */<tr><td><a id="l248"></a><a href="#l248">248</a><td>goog.testing.Mock.prototype.$argumentListVerifiers_;<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td>/**<tr><td><a id="l252"></a><a href="#l252">252</a><td> * Whether or not we are in recording mode.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @type {boolean}<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @private<tr><td><a id="l255"></a><a href="#l255">255</a><td> */<tr><td><a id="l256"></a><a href="#l256">256</a><td>goog.testing.Mock.prototype.$recording_ = true;<tr><td><a id="l257"></a><a href="#l257">257</a><td><tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td>/**<tr><td><a id="l260"></a><a href="#l260">260</a><td> * The expectation currently being created. All methods that modify the<tr><td><a id="l261"></a><a href="#l261">261</a><td> * current expectation return the Mock object for easy chaining, so this is<tr><td><a id="l262"></a><a href="#l262">262</a><td> * where we keep track of the expectation that&#39;s currently being modified.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @type {goog.testing.MockExpectation}<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @protected<tr><td><a id="l265"></a><a href="#l265">265</a><td> */<tr><td><a id="l266"></a><a href="#l266">266</a><td>goog.testing.Mock.prototype.$pendingExpectation;<tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td>/**<tr><td><a id="l270"></a><a href="#l270">270</a><td> * First exception thrown by this mock; used in $verify.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @type {Object}<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @private<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td>goog.testing.Mock.prototype.$threwException_ = null;<tr><td><a id="l275"></a><a href="#l275">275</a><td><tr><td><a id="l276"></a><a href="#l276">276</a><td><tr><td><a id="l277"></a><a href="#l277">277</a><td>/**<tr><td><a id="l278"></a><a href="#l278">278</a><td> * Initializes the functions on the mock object.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @param {Object} objectToMock The object being mocked.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @private<tr><td><a id="l281"></a><a href="#l281">281</a><td> */<tr><td><a id="l282"></a><a href="#l282">282</a><td>goog.testing.Mock.prototype.$initializeFunctions_ = function(objectToMock) {<tr><td><a id="l283"></a><a href="#l283">283</a><td>  // Gets the object properties.<tr><td><a id="l284"></a><a href="#l284">284</a><td>  var enumerableProperties = goog.object.getKeys(objectToMock);<tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td>  // The non enumerable properties are added if they override the ones in the<tr><td><a id="l287"></a><a href="#l287">287</a><td>  // Object prototype. This is due to the fact that IE8 does not enumerate any<tr><td><a id="l288"></a><a href="#l288">288</a><td>  // of the prototype Object functions even when overriden and mocking these is<tr><td><a id="l289"></a><a href="#l289">289</a><td>  // sometimes needed.<tr><td><a id="l290"></a><a href="#l290">290</a><td>  for (var i = 0; i &lt; goog.testing.Mock.PROTOTYPE_FIELDS_.length; i++) {<tr><td><a id="l291"></a><a href="#l291">291</a><td>    var prop = goog.testing.Mock.PROTOTYPE_FIELDS_[i];<tr><td><a id="l292"></a><a href="#l292">292</a><td>    // Look at b/6758711 if you&#39;re considering adding ALL properties to ALL<tr><td><a id="l293"></a><a href="#l293">293</a><td>    // mocks.<tr><td><a id="l294"></a><a href="#l294">294</a><td>    if (objectToMock[prop] !== Object.prototype[prop]) {<tr><td><a id="l295"></a><a href="#l295">295</a><td>      enumerableProperties.push(prop);<tr><td><a id="l296"></a><a href="#l296">296</a><td>    }<tr><td><a id="l297"></a><a href="#l297">297</a><td>  }<tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td>  // Adds the properties to the mock.<tr><td><a id="l300"></a><a href="#l300">300</a><td>  for (var i = 0; i &lt; enumerableProperties.length; i++) {<tr><td><a id="l301"></a><a href="#l301">301</a><td>    var prop = enumerableProperties[i];<tr><td><a id="l302"></a><a href="#l302">302</a><td>    if (typeof objectToMock[prop] == &#39;function&#39;) {<tr><td><a id="l303"></a><a href="#l303">303</a><td>      this[prop] = goog.bind(this.$mockMethod, this, prop);<tr><td><a id="l304"></a><a href="#l304">304</a><td>      if (this.$proxy) {<tr><td><a id="l305"></a><a href="#l305">305</a><td>        this.$proxy[prop] = goog.bind(this.$mockMethod, this, prop);<tr><td><a id="l306"></a><a href="#l306">306</a><td>      }<tr><td><a id="l307"></a><a href="#l307">307</a><td>    }<tr><td><a id="l308"></a><a href="#l308">308</a><td>  }<tr><td><a id="l309"></a><a href="#l309">309</a><td>};<tr><td><a id="l310"></a><a href="#l310">310</a><td><tr><td><a id="l311"></a><a href="#l311">311</a><td><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Registers a verifier function to use when verifying method argument lists.<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @param {string} methodName The name of the method for which the verifierFn<tr><td><a id="l315"></a><a href="#l315">315</a><td> *     should be used.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @param {Function} fn Argument list verifier function.  Should take 2 argument<tr><td><a id="l317"></a><a href="#l317">317</a><td> *     arrays as arguments, and return true if they are considered equivalent.<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l319"></a><a href="#l319">319</a><td> */<tr><td><a id="l320"></a><a href="#l320">320</a><td>goog.testing.Mock.prototype.$registerArgumentListVerifier = function(methodName,<tr><td><a id="l321"></a><a href="#l321">321</a><td>                                                                     fn) {<tr><td><a id="l322"></a><a href="#l322">322</a><td>  this.$argumentListVerifiers_[methodName] = fn;<tr><td><a id="l323"></a><a href="#l323">323</a><td>  return this;<tr><td><a id="l324"></a><a href="#l324">324</a><td>};<tr><td><a id="l325"></a><a href="#l325">325</a><td><tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td>/**<tr><td><a id="l328"></a><a href="#l328">328</a><td> * The function that replaces all methods on the mock object.<tr><td><a id="l329"></a><a href="#l329">329</a><td> * @param {string} name The name of the method being mocked.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @return {*} In record mode, returns the mock object. In replay mode, returns<tr><td><a id="l331"></a><a href="#l331">331</a><td> *    whatever the creator of the mock set as the return value.<tr><td><a id="l332"></a><a href="#l332">332</a><td> */<tr><td><a id="l333"></a><a href="#l333">333</a><td>goog.testing.Mock.prototype.$mockMethod = function(name) {<tr><td><a id="l334"></a><a href="#l334">334</a><td>  try {<tr><td><a id="l335"></a><a href="#l335">335</a><td>    // Shift off the name argument so that args contains the arguments to<tr><td><a id="l336"></a><a href="#l336">336</a><td>    // the mocked method.<tr><td><a id="l337"></a><a href="#l337">337</a><td>    var args = goog.array.slice(arguments, 1);<tr><td><a id="l338"></a><a href="#l338">338</a><td>    if (this.$recording_) {<tr><td><a id="l339"></a><a href="#l339">339</a><td>      this.$pendingExpectation = new goog.testing.MockExpectation(name);<tr><td><a id="l340"></a><a href="#l340">340</a><td>      this.$pendingExpectation.argumentList = args;<tr><td><a id="l341"></a><a href="#l341">341</a><td>      this.$recordExpectation();<tr><td><a id="l342"></a><a href="#l342">342</a><td>      return this;<tr><td><a id="l343"></a><a href="#l343">343</a><td>    } else {<tr><td><a id="l344"></a><a href="#l344">344</a><td>      return this.$recordCall(name, args);<tr><td><a id="l345"></a><a href="#l345">345</a><td>    }<tr><td><a id="l346"></a><a href="#l346">346</a><td>  } catch (ex) {<tr><td><a id="l347"></a><a href="#l347">347</a><td>    this.$recordAndThrow(ex);<tr><td><a id="l348"></a><a href="#l348">348</a><td>  }<tr><td><a id="l349"></a><a href="#l349">349</a><td>};<tr><td><a id="l350"></a><a href="#l350">350</a><td><tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td>/**<tr><td><a id="l353"></a><a href="#l353">353</a><td> * Records the currently pending expectation, intended to be overridden by a<tr><td><a id="l354"></a><a href="#l354">354</a><td> * subclass.<tr><td><a id="l355"></a><a href="#l355">355</a><td> * @protected<tr><td><a id="l356"></a><a href="#l356">356</a><td> */<tr><td><a id="l357"></a><a href="#l357">357</a><td>goog.testing.Mock.prototype.$recordExpectation = function() {};<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>/**<tr><td><a id="l361"></a><a href="#l361">361</a><td> * Records an actual method call, intended to be overridden by a<tr><td><a id="l362"></a><a href="#l362">362</a><td> * subclass. The subclass must find the pending expectation and return the<tr><td><a id="l363"></a><a href="#l363">363</a><td> * correct value.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @param {string} name The name of the method being called.<tr><td><a id="l365"></a><a href="#l365">365</a><td> * @param {Array&lt;?&gt;} args The arguments to the method.<tr><td><a id="l366"></a><a href="#l366">366</a><td> * @return {*} The return expected by the mock.<tr><td><a id="l367"></a><a href="#l367">367</a><td> * @protected<tr><td><a id="l368"></a><a href="#l368">368</a><td> */<tr><td><a id="l369"></a><a href="#l369">369</a><td>goog.testing.Mock.prototype.$recordCall = function(name, args) {<tr><td><a id="l370"></a><a href="#l370">370</a><td>  return undefined;<tr><td><a id="l371"></a><a href="#l371">371</a><td>};<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> * If the expectation expects to throw, this method will throw.<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @param {goog.testing.MockExpectation} expectation The expectation.<tr><td><a id="l377"></a><a href="#l377">377</a><td> */<tr><td><a id="l378"></a><a href="#l378">378</a><td>goog.testing.Mock.prototype.$maybeThrow = function(expectation) {<tr><td><a id="l379"></a><a href="#l379">379</a><td>  if (typeof expectation.exceptionToThrow != &#39;undefined&#39;) {<tr><td><a id="l380"></a><a href="#l380">380</a><td>    throw expectation.exceptionToThrow;<tr><td><a id="l381"></a><a href="#l381">381</a><td>  }<tr><td><a id="l382"></a><a href="#l382">382</a><td>};<tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td>/**<tr><td><a id="l386"></a><a href="#l386">386</a><td> * If this expectation defines a function to be called,<tr><td><a id="l387"></a><a href="#l387">387</a><td> * it will be called and its result will be returned.<tr><td><a id="l388"></a><a href="#l388">388</a><td> * Otherwise, if the expectation expects to throw, it will throw.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * Otherwise, this method will return defined value.<tr><td><a id="l390"></a><a href="#l390">390</a><td> * @param {goog.testing.MockExpectation} expectation The expectation.<tr><td><a id="l391"></a><a href="#l391">391</a><td> * @param {Array&lt;?&gt;} args The arguments to the method.<tr><td><a id="l392"></a><a href="#l392">392</a><td> * @return {*} The return value expected by the mock.<tr><td><a id="l393"></a><a href="#l393">393</a><td> */<tr><td><a id="l394"></a><a href="#l394">394</a><td>goog.testing.Mock.prototype.$do = function(expectation, args) {<tr><td><a id="l395"></a><a href="#l395">395</a><td>  if (typeof expectation.toDo == &#39;undefined&#39;) {<tr><td><a id="l396"></a><a href="#l396">396</a><td>    this.$maybeThrow(expectation);<tr><td><a id="l397"></a><a href="#l397">397</a><td>    return expectation.returnValue;<tr><td><a id="l398"></a><a href="#l398">398</a><td>  } else {<tr><td><a id="l399"></a><a href="#l399">399</a><td>    return expectation.toDo.apply(this, args);<tr><td><a id="l400"></a><a href="#l400">400</a><td>  }<tr><td><a id="l401"></a><a href="#l401">401</a><td>};<tr><td><a id="l402"></a><a href="#l402">402</a><td><tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td>/**<tr><td><a id="l405"></a><a href="#l405">405</a><td> * Specifies a return value for the currently pending expectation.<tr><td><a id="l406"></a><a href="#l406">406</a><td> * @param {*} val The return value.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l408"></a><a href="#l408">408</a><td> */<tr><td><a id="l409"></a><a href="#l409">409</a><td>goog.testing.Mock.prototype.$returns = function(val) {<tr><td><a id="l410"></a><a href="#l410">410</a><td>  this.$pendingExpectation.returnValue = val;<tr><td><a id="l411"></a><a href="#l411">411</a><td>  return this;<tr><td><a id="l412"></a><a href="#l412">412</a><td>};<tr><td><a id="l413"></a><a href="#l413">413</a><td><tr><td><a id="l414"></a><a href="#l414">414</a><td><tr><td><a id="l415"></a><a href="#l415">415</a><td>/**<tr><td><a id="l416"></a><a href="#l416">416</a><td> * Specifies a value for the currently pending expectation to throw.<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @param {*} val The value to throw.<tr><td><a id="l418"></a><a href="#l418">418</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l419"></a><a href="#l419">419</a><td> */<tr><td><a id="l420"></a><a href="#l420">420</a><td>goog.testing.Mock.prototype.$throws = function(val) {<tr><td><a id="l421"></a><a href="#l421">421</a><td>  this.$pendingExpectation.exceptionToThrow = val;<tr><td><a id="l422"></a><a href="#l422">422</a><td>  return this;<tr><td><a id="l423"></a><a href="#l423">423</a><td>};<tr><td><a id="l424"></a><a href="#l424">424</a><td><tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td>/**<tr><td><a id="l427"></a><a href="#l427">427</a><td> * Specifies a function to call for currently pending expectation.<tr><td><a id="l428"></a><a href="#l428">428</a><td> * Note, that using this method overrides declarations made<tr><td><a id="l429"></a><a href="#l429">429</a><td> * using $returns() and $throws() methods.<tr><td><a id="l430"></a><a href="#l430">430</a><td> * @param {Function} func The function to call.<tr><td><a id="l431"></a><a href="#l431">431</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l432"></a><a href="#l432">432</a><td> */<tr><td><a id="l433"></a><a href="#l433">433</a><td>goog.testing.Mock.prototype.$does = function(func) {<tr><td><a id="l434"></a><a href="#l434">434</a><td>  this.$pendingExpectation.toDo = func;<tr><td><a id="l435"></a><a href="#l435">435</a><td>  return this;<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><tr><td><a id="l439"></a><a href="#l439">439</a><td>/**<tr><td><a id="l440"></a><a href="#l440">440</a><td> * Allows the expectation to be called 0 or 1 times.<tr><td><a id="l441"></a><a href="#l441">441</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l442"></a><a href="#l442">442</a><td> */<tr><td><a id="l443"></a><a href="#l443">443</a><td>goog.testing.Mock.prototype.$atMostOnce = function() {<tr><td><a id="l444"></a><a href="#l444">444</a><td>  this.$pendingExpectation.minCalls = 0;<tr><td><a id="l445"></a><a href="#l445">445</a><td>  this.$pendingExpectation.maxCalls = 1;<tr><td><a id="l446"></a><a href="#l446">446</a><td>  return this;<tr><td><a id="l447"></a><a href="#l447">447</a><td>};<tr><td><a id="l448"></a><a href="#l448">448</a><td><tr><td><a id="l449"></a><a href="#l449">449</a><td><tr><td><a id="l450"></a><a href="#l450">450</a><td>/**<tr><td><a id="l451"></a><a href="#l451">451</a><td> * Allows the expectation to be called any number of times, as long as it&#39;s<tr><td><a id="l452"></a><a href="#l452">452</a><td> * called once.<tr><td><a id="l453"></a><a href="#l453">453</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l454"></a><a href="#l454">454</a><td> */<tr><td><a id="l455"></a><a href="#l455">455</a><td>goog.testing.Mock.prototype.$atLeastOnce = function() {<tr><td><a id="l456"></a><a href="#l456">456</a><td>  this.$pendingExpectation.maxCalls = Infinity;<tr><td><a id="l457"></a><a href="#l457">457</a><td>  return this;<tr><td><a id="l458"></a><a href="#l458">458</a><td>};<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> * Allows the expectation to be called exactly once.<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l464"></a><a href="#l464">464</a><td> */<tr><td><a id="l465"></a><a href="#l465">465</a><td>goog.testing.Mock.prototype.$once = function() {<tr><td><a id="l466"></a><a href="#l466">466</a><td>  this.$pendingExpectation.minCalls = 1;<tr><td><a id="l467"></a><a href="#l467">467</a><td>  this.$pendingExpectation.maxCalls = 1;<tr><td><a id="l468"></a><a href="#l468">468</a><td>  return this;<tr><td><a id="l469"></a><a href="#l469">469</a><td>};<tr><td><a id="l470"></a><a href="#l470">470</a><td><tr><td><a id="l471"></a><a href="#l471">471</a><td><tr><td><a id="l472"></a><a href="#l472">472</a><td>/**<tr><td><a id="l473"></a><a href="#l473">473</a><td> * Disallows the expectation from being called.<tr><td><a id="l474"></a><a href="#l474">474</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l475"></a><a href="#l475">475</a><td> */<tr><td><a id="l476"></a><a href="#l476">476</a><td>goog.testing.Mock.prototype.$never = function() {<tr><td><a id="l477"></a><a href="#l477">477</a><td>  this.$pendingExpectation.minCalls = 0;<tr><td><a id="l478"></a><a href="#l478">478</a><td>  this.$pendingExpectation.maxCalls = 0;<tr><td><a id="l479"></a><a href="#l479">479</a><td>  return this;<tr><td><a id="l480"></a><a href="#l480">480</a><td>};<tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td><tr><td><a id="l483"></a><a href="#l483">483</a><td>/**<tr><td><a id="l484"></a><a href="#l484">484</a><td> * Allows the expectation to be called any number of times.<tr><td><a id="l485"></a><a href="#l485">485</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l486"></a><a href="#l486">486</a><td> */<tr><td><a id="l487"></a><a href="#l487">487</a><td>goog.testing.Mock.prototype.$anyTimes = function() {<tr><td><a id="l488"></a><a href="#l488">488</a><td>  this.$pendingExpectation.minCalls = 0;<tr><td><a id="l489"></a><a href="#l489">489</a><td>  this.$pendingExpectation.maxCalls = Infinity;<tr><td><a id="l490"></a><a href="#l490">490</a><td>  return this;<tr><td><a id="l491"></a><a href="#l491">491</a><td>};<tr><td><a id="l492"></a><a href="#l492">492</a><td><tr><td><a id="l493"></a><a href="#l493">493</a><td><tr><td><a id="l494"></a><a href="#l494">494</a><td>/**<tr><td><a id="l495"></a><a href="#l495">495</a><td> * Specifies the number of times the expectation should be called.<tr><td><a id="l496"></a><a href="#l496">496</a><td> * @param {number} times The number of times this method will be called.<tr><td><a id="l497"></a><a href="#l497">497</a><td> * @return {!goog.testing.Mock} This mock object.<tr><td><a id="l498"></a><a href="#l498">498</a><td> */<tr><td><a id="l499"></a><a href="#l499">499</a><td>goog.testing.Mock.prototype.$times = function(times) {<tr><td><a id="l500"></a><a href="#l500">500</a><td>  this.$pendingExpectation.minCalls = times;<tr><td><a id="l501"></a><a href="#l501">501</a><td>  this.$pendingExpectation.maxCalls = times;<tr><td><a id="l502"></a><a href="#l502">502</a><td>  return this;<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>/**<tr><td><a id="l507"></a><a href="#l507">507</a><td> * Switches from recording to replay mode.<tr><td><a id="l508"></a><a href="#l508">508</a><td> * @override<tr><td><a id="l509"></a><a href="#l509">509</a><td> */<tr><td><a id="l510"></a><a href="#l510">510</a><td>goog.testing.Mock.prototype.$replay = function() {<tr><td><a id="l511"></a><a href="#l511">511</a><td>  this.$recording_ = false;<tr><td><a id="l512"></a><a href="#l512">512</a><td>};<tr><td><a id="l513"></a><a href="#l513">513</a><td><tr><td><a id="l514"></a><a href="#l514">514</a><td><tr><td><a id="l515"></a><a href="#l515">515</a><td>/**<tr><td><a id="l516"></a><a href="#l516">516</a><td> * Resets the state of this mock object. This clears all pending expectations<tr><td><a id="l517"></a><a href="#l517">517</a><td> * without verifying, and puts the mock in recording mode.<tr><td><a id="l518"></a><a href="#l518">518</a><td> * @override<tr><td><a id="l519"></a><a href="#l519">519</a><td> */<tr><td><a id="l520"></a><a href="#l520">520</a><td>goog.testing.Mock.prototype.$reset = function() {<tr><td><a id="l521"></a><a href="#l521">521</a><td>  this.$recording_ = true;<tr><td><a id="l522"></a><a href="#l522">522</a><td>  this.$threwException_ = null;<tr><td><a id="l523"></a><a href="#l523">523</a><td>  delete this.$pendingExpectation;<tr><td><a id="l524"></a><a href="#l524">524</a><td>};<tr><td><a id="l525"></a><a href="#l525">525</a><td><tr><td><a id="l526"></a><a href="#l526">526</a><td><tr><td><a id="l527"></a><a href="#l527">527</a><td>/**<tr><td><a id="l528"></a><a href="#l528">528</a><td> * Throws an exception and records that an exception was thrown.<tr><td><a id="l529"></a><a href="#l529">529</a><td> * @param {string} comment A short comment about the exception.<tr><td><a id="l530"></a><a href="#l530">530</a><td> * @param {?string=} opt_message A longer message about the exception.<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @throws {Object} JsUnitException object.<tr><td><a id="l532"></a><a href="#l532">532</a><td> * @protected<tr><td><a id="l533"></a><a href="#l533">533</a><td> */<tr><td><a id="l534"></a><a href="#l534">534</a><td>goog.testing.Mock.prototype.$throwException = function(comment, opt_message) {<tr><td><a id="l535"></a><a href="#l535">535</a><td>  this.$recordAndThrow(new goog.testing.JsUnitException(comment, opt_message));<tr><td><a id="l536"></a><a href="#l536">536</a><td>};<tr><td><a id="l537"></a><a href="#l537">537</a><td><tr><td><a id="l538"></a><a href="#l538">538</a><td><tr><td><a id="l539"></a><a href="#l539">539</a><td>/**<tr><td><a id="l540"></a><a href="#l540">540</a><td> * Throws an exception and records that an exception was thrown.<tr><td><a id="l541"></a><a href="#l541">541</a><td> * @param {Object} ex Exception.<tr><td><a id="l542"></a><a href="#l542">542</a><td> * @throws {Object} #ex.<tr><td><a id="l543"></a><a href="#l543">543</a><td> * @protected<tr><td><a id="l544"></a><a href="#l544">544</a><td> */<tr><td><a id="l545"></a><a href="#l545">545</a><td>goog.testing.Mock.prototype.$recordAndThrow = function(ex) {<tr><td><a id="l546"></a><a href="#l546">546</a><td>  // If it&#39;s an assert exception, record it.<tr><td><a id="l547"></a><a href="#l547">547</a><td>  if (ex[&#39;isJsUnitException&#39;]) {<tr><td><a id="l548"></a><a href="#l548">548</a><td>    var testRunner = goog.global[&#39;G_testRunner&#39;];<tr><td><a id="l549"></a><a href="#l549">549</a><td>    if (testRunner) {<tr><td><a id="l550"></a><a href="#l550">550</a><td>      var logTestFailureFunction = testRunner[&#39;logTestFailure&#39;];<tr><td><a id="l551"></a><a href="#l551">551</a><td>      if (logTestFailureFunction) {<tr><td><a id="l552"></a><a href="#l552">552</a><td>        logTestFailureFunction.call(testRunner, ex);<tr><td><a id="l553"></a><a href="#l553">553</a><td>      }<tr><td><a id="l554"></a><a href="#l554">554</a><td>    }<tr><td><a id="l555"></a><a href="#l555">555</a><td><tr><td><a id="l556"></a><a href="#l556">556</a><td>    if (!this.$threwException_) {<tr><td><a id="l557"></a><a href="#l557">557</a><td>      // Only remember first exception thrown.<tr><td><a id="l558"></a><a href="#l558">558</a><td>      this.$threwException_ = ex;<tr><td><a id="l559"></a><a href="#l559">559</a><td>    }<tr><td><a id="l560"></a><a href="#l560">560</a><td>  }<tr><td><a id="l561"></a><a href="#l561">561</a><td>  throw ex;<tr><td><a id="l562"></a><a href="#l562">562</a><td>};<tr><td><a id="l563"></a><a href="#l563">563</a><td><tr><td><a id="l564"></a><a href="#l564">564</a><td><tr><td><a id="l565"></a><a href="#l565">565</a><td>/**<tr><td><a id="l566"></a><a href="#l566">566</a><td> * Verify that all of the expectations were met. Should be overridden by<tr><td><a id="l567"></a><a href="#l567">567</a><td> * subclasses.<tr><td><a id="l568"></a><a href="#l568">568</a><td> * @override<tr><td><a id="l569"></a><a href="#l569">569</a><td> */<tr><td><a id="l570"></a><a href="#l570">570</a><td>goog.testing.Mock.prototype.$verify = function() {<tr><td><a id="l571"></a><a href="#l571">571</a><td>  if (this.$threwException_) {<tr><td><a id="l572"></a><a href="#l572">572</a><td>    throw this.$threwException_;<tr><td><a id="l573"></a><a href="#l573">573</a><td>  }<tr><td><a id="l574"></a><a href="#l574">574</a><td>};<tr><td><a id="l575"></a><a href="#l575">575</a><td><tr><td><a id="l576"></a><a href="#l576">576</a><td><tr><td><a id="l577"></a><a href="#l577">577</a><td>/**<tr><td><a id="l578"></a><a href="#l578">578</a><td> * Verifies that a method call matches an expectation.<tr><td><a id="l579"></a><a href="#l579">579</a><td> * @param {goog.testing.MockExpectation} expectation The expectation to check.<tr><td><a id="l580"></a><a href="#l580">580</a><td> * @param {string} name The name of the called method.<tr><td><a id="l581"></a><a href="#l581">581</a><td> * @param {Array&lt;*&gt;?} args The arguments passed to the mock.<tr><td><a id="l582"></a><a href="#l582">582</a><td> * @return {boolean} Whether the call matches the expectation.<tr><td><a id="l583"></a><a href="#l583">583</a><td> */<tr><td><a id="l584"></a><a href="#l584">584</a><td>goog.testing.Mock.prototype.$verifyCall = function(expectation, name, args) {<tr><td><a id="l585"></a><a href="#l585">585</a><td>  if (expectation.name != name) {<tr><td><a id="l586"></a><a href="#l586">586</a><td>    return false;<tr><td><a id="l587"></a><a href="#l587">587</a><td>  }<tr><td><a id="l588"></a><a href="#l588">588</a><td>  var verifierFn =<tr><td><a id="l589"></a><a href="#l589">589</a><td>      this.$argumentListVerifiers_.hasOwnProperty(expectation.name) ?<tr><td><a id="l590"></a><a href="#l590">590</a><td>      this.$argumentListVerifiers_[expectation.name] :<tr><td><a id="l591"></a><a href="#l591">591</a><td>      goog.testing.mockmatchers.flexibleArrayMatcher;<tr><td><a id="l592"></a><a href="#l592">592</a><td><tr><td><a id="l593"></a><a href="#l593">593</a><td>  return verifierFn(expectation.argumentList, args, expectation);<tr><td><a id="l594"></a><a href="#l594">594</a><td>};<tr><td><a id="l595"></a><a href="#l595">595</a><td><tr><td><a id="l596"></a><a href="#l596">596</a><td><tr><td><a id="l597"></a><a href="#l597">597</a><td>/**<tr><td><a id="l598"></a><a href="#l598">598</a><td> * Render the provided argument array to a string to help<tr><td><a id="l599"></a><a href="#l599">599</a><td> * clients with debugging tests.<tr><td><a id="l600"></a><a href="#l600">600</a><td> * @param {Array&lt;*&gt;?} args The arguments passed to the mock.<tr><td><a id="l601"></a><a href="#l601">601</a><td> * @return {string} Human-readable string.<tr><td><a id="l602"></a><a href="#l602">602</a><td> */<tr><td><a id="l603"></a><a href="#l603">603</a><td>goog.testing.Mock.prototype.$argumentsAsString = function(args) {<tr><td><a id="l604"></a><a href="#l604">604</a><td>  var retVal = [];<tr><td><a id="l605"></a><a href="#l605">605</a><td>  for (var i = 0; i &lt; args.length; i++) {<tr><td><a id="l606"></a><a href="#l606">606</a><td>    try {<tr><td><a id="l607"></a><a href="#l607">607</a><td>      retVal.push(goog.typeOf(args[i]));<tr><td><a id="l608"></a><a href="#l608">608</a><td>    } catch (e) {<tr><td><a id="l609"></a><a href="#l609">609</a><td>      retVal.push(&#39;[unknown]&#39;);<tr><td><a id="l610"></a><a href="#l610">610</a><td>    }<tr><td><a id="l611"></a><a href="#l611">611</a><td>  }<tr><td><a id="l612"></a><a href="#l612">612</a><td>  return &#39;(&#39; + retVal.join(&#39;, &#39;) + &#39;)&#39;;<tr><td><a id="l613"></a><a href="#l613">613</a><td>};<tr><td><a id="l614"></a><a href="#l614">614</a><td><tr><td><a id="l615"></a><a href="#l615">615</a><td><tr><td><a id="l616"></a><a href="#l616">616</a><td>/**<tr><td><a id="l617"></a><a href="#l617">617</a><td> * Throw an exception based on an incorrect method call.<tr><td><a id="l618"></a><a href="#l618">618</a><td> * @param {string} name Name of method called.<tr><td><a id="l619"></a><a href="#l619">619</a><td> * @param {Array&lt;*&gt;?} args Arguments passed to the mock.<tr><td><a id="l620"></a><a href="#l620">620</a><td> * @param {goog.testing.MockExpectation=} opt_expectation Expected next call,<tr><td><a id="l621"></a><a href="#l621">621</a><td> *     if any.<tr><td><a id="l622"></a><a href="#l622">622</a><td> */<tr><td><a id="l623"></a><a href="#l623">623</a><td>goog.testing.Mock.prototype.$throwCallException = function(name, args,<tr><td><a id="l624"></a><a href="#l624">624</a><td>                                                           opt_expectation) {<tr><td><a id="l625"></a><a href="#l625">625</a><td>  var errorStringBuffer = [];<tr><td><a id="l626"></a><a href="#l626">626</a><td>  var actualArgsString = this.$argumentsAsString(args);<tr><td><a id="l627"></a><a href="#l627">627</a><td>  var expectedArgsString = opt_expectation ?<tr><td><a id="l628"></a><a href="#l628">628</a><td>      this.$argumentsAsString(opt_expectation.argumentList) : &#39;&#39;;<tr><td><a id="l629"></a><a href="#l629">629</a><td><tr><td><a id="l630"></a><a href="#l630">630</a><td>  if (opt_expectation &amp;&amp; opt_expectation.name == name) {<tr><td><a id="l631"></a><a href="#l631">631</a><td>    errorStringBuffer.push(&#39;Bad arguments to &#39;, name, &#39;().\n&#39;,<tr><td><a id="l632"></a><a href="#l632">632</a><td>                           &#39;Actual: &#39;, actualArgsString, &#39;\n&#39;,<tr><td><a id="l633"></a><a href="#l633">633</a><td>                           &#39;Expected: &#39;, expectedArgsString, &#39;\n&#39;,<tr><td><a id="l634"></a><a href="#l634">634</a><td>                           opt_expectation.getErrorMessage());<tr><td><a id="l635"></a><a href="#l635">635</a><td>  } else {<tr><td><a id="l636"></a><a href="#l636">636</a><td>    errorStringBuffer.push(&#39;Unexpected call to &#39;, name,<tr><td><a id="l637"></a><a href="#l637">637</a><td>                           actualArgsString, &#39;.&#39;);<tr><td><a id="l638"></a><a href="#l638">638</a><td>    if (opt_expectation) {<tr><td><a id="l639"></a><a href="#l639">639</a><td>      errorStringBuffer.push(&#39;\nNext expected call was to &#39;,<tr><td><a id="l640"></a><a href="#l640">640</a><td>                             opt_expectation.name,<tr><td><a id="l641"></a><a href="#l641">641</a><td>                             expectedArgsString);<tr><td><a id="l642"></a><a href="#l642">642</a><td>    }<tr><td><a id="l643"></a><a href="#l643">643</a><td>  }<tr><td><a id="l644"></a><a href="#l644">644</a><td>  this.$throwException(errorStringBuffer.join(&#39;&#39;));<tr><td><a id="l645"></a><a href="#l645">645</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/mockclock.js.src.html b/docs/source/lib/goog/testing/mockclock.js.src.html
new file mode 100644
index 0000000..d353de5
--- /dev/null
+++ b/docs/source/lib/goog/testing/mockclock.js.src.html
@@ -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>mockclock.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/mockclock.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Mock Clock implementation for working with setTimeout,<tr><td><a id="l17"></a><a href="#l17">17</a><td> * setInterval, clearTimeout and clearInterval within unit tests.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> * Derived from jsUnitMockTimeout.js, contributed to JsUnit by<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Pivotal Computer Systems, www.pivotalsf.com<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.testing.MockClock&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.Disposable&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.async.run&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.testing.PropertyReplacer&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.testing.events&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.testing.events.Event&#39;);<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><tr><td><a id="l34"></a><a href="#l34">34</a><td>/**<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Class for unit testing code that uses setTimeout and clearTimeout.<tr><td><a id="l36"></a><a href="#l36">36</a><td> *<tr><td><a id="l37"></a><a href="#l37">37</a><td> * NOTE: If you are using MockClock to test code that makes use of<tr><td><a id="l38"></a><a href="#l38">38</a><td> *       goog.fx.Animation, then you must either:<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * 1. Install and dispose of the MockClock in setUpPage() and tearDownPage()<tr><td><a id="l41"></a><a href="#l41">41</a><td> *    respectively (rather than setUp()/tearDown()).<tr><td><a id="l42"></a><a href="#l42">42</a><td> *<tr><td><a id="l43"></a><a href="#l43">43</a><td> * or<tr><td><a id="l44"></a><a href="#l44">44</a><td> *<tr><td><a id="l45"></a><a href="#l45">45</a><td> * 2. Ensure that every test clears the animation queue by calling<tr><td><a id="l46"></a><a href="#l46">46</a><td> *    mockClock.tick(x) at the end of each test function (where `x` is large<tr><td><a id="l47"></a><a href="#l47">47</a><td> *    enough to complete all animations).<tr><td><a id="l48"></a><a href="#l48">48</a><td> *<tr><td><a id="l49"></a><a href="#l49">49</a><td> * Otherwise, if any animation is left pending at the time that<tr><td><a id="l50"></a><a href="#l50">50</a><td> * MockClock.dispose() is called, that will permanently prevent any future<tr><td><a id="l51"></a><a href="#l51">51</a><td> * animations from playing on the page.<tr><td><a id="l52"></a><a href="#l52">52</a><td> *<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @param {boolean=} opt_autoInstall Install the MockClock at construction time.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @constructor<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @extends {goog.Disposable}<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @final<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>goog.testing.MockClock = function(opt_autoInstall) {<tr><td><a id="l59"></a><a href="#l59">59</a><td>  goog.Disposable.call(this);<tr><td><a id="l60"></a><a href="#l60">60</a><td><tr><td><a id="l61"></a><a href="#l61">61</a><td>  /**<tr><td><a id="l62"></a><a href="#l62">62</a><td>   * Reverse-order queue of timers to fire.<tr><td><a id="l63"></a><a href="#l63">63</a><td>   *<tr><td><a id="l64"></a><a href="#l64">64</a><td>   * The last item of the queue is popped off.  Insertion happens from the<tr><td><a id="l65"></a><a href="#l65">65</a><td>   * right.  For example, the expiration times for each element of the queue<tr><td><a id="l66"></a><a href="#l66">66</a><td>   * might be in the order 300, 200, 200.<tr><td><a id="l67"></a><a href="#l67">67</a><td>   *<tr><td><a id="l68"></a><a href="#l68">68</a><td>   * @type {Array&lt;Object&gt;}<tr><td><a id="l69"></a><a href="#l69">69</a><td>   * @private<tr><td><a id="l70"></a><a href="#l70">70</a><td>   */<tr><td><a id="l71"></a><a href="#l71">71</a><td>  this.queue_ = [];<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>   * Set of timeouts that should be treated as cancelled.<tr><td><a id="l75"></a><a href="#l75">75</a><td>   *<tr><td><a id="l76"></a><a href="#l76">76</a><td>   * Rather than removing cancelled timers directly from the queue, this set<tr><td><a id="l77"></a><a href="#l77">77</a><td>   * simply marks them as deleted so that they can be ignored when their<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * turn comes up.  The keys are the timeout keys that are cancelled, each<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * mapping to true.<tr><td><a id="l80"></a><a href="#l80">80</a><td>   *<tr><td><a id="l81"></a><a href="#l81">81</a><td>   * @private {Object&lt;number, boolean&gt;}<tr><td><a id="l82"></a><a href="#l82">82</a><td>   */<tr><td><a id="l83"></a><a href="#l83">83</a><td>  this.deletedKeys_ = {};<tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>  if (opt_autoInstall) {<tr><td><a id="l86"></a><a href="#l86">86</a><td>    this.install();<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>goog.inherits(goog.testing.MockClock, goog.Disposable);<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> * Default wait timeout for mocking requestAnimationFrame (in milliseconds).<tr><td><a id="l94"></a><a href="#l94">94</a><td> *<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @type {number}<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @const<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>goog.testing.MockClock.REQUEST_ANIMATION_FRAME_TIMEOUT = 20;<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> * ID to use for next timeout.  Timeout IDs must never be reused, even across<tr><td><a id="l103"></a><a href="#l103">103</a><td> * MockClock instances.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @public {number}<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.testing.MockClock.nextId = Math.round(Math.random() * 10000);<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> * Count of the number of timeouts made by this instance.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @type {number}<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @private<tr><td><a id="l113"></a><a href="#l113">113</a><td> */<tr><td><a id="l114"></a><a href="#l114">114</a><td>goog.testing.MockClock.prototype.timeoutsMade_ = 0;<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> * PropertyReplacer instance which overwrites and resets setTimeout,<tr><td><a id="l119"></a><a href="#l119">119</a><td> * setInterval, etc. or null if the MockClock is not installed.<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @type {goog.testing.PropertyReplacer}<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @private<tr><td><a id="l122"></a><a href="#l122">122</a><td> */<tr><td><a id="l123"></a><a href="#l123">123</a><td>goog.testing.MockClock.prototype.replacer_ = null;<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> * The current simulated time in milliseconds.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @type {number}<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @private<tr><td><a id="l130"></a><a href="#l130">130</a><td> */<tr><td><a id="l131"></a><a href="#l131">131</a><td>goog.testing.MockClock.prototype.nowMillis_ = 0;<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> * Additional delay between the time a timeout was set to fire, and the time<tr><td><a id="l136"></a><a href="#l136">136</a><td> * it actually fires.  Useful for testing workarounds for this Firefox 2 bug:<tr><td><a id="l137"></a><a href="#l137">137</a><td> * https://bugzilla.mozilla.org/show_bug.cgi?id=291386<tr><td><a id="l138"></a><a href="#l138">138</a><td> * May be negative.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @type {number}<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @private<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td>goog.testing.MockClock.prototype.timeoutDelay_ = 0;<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> * The real set timeout for reference.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @const @private {!Function}<tr><td><a id="l148"></a><a href="#l148">148</a><td> */<tr><td><a id="l149"></a><a href="#l149">149</a><td>goog.testing.MockClock.REAL_SETTIMEOUT_ = goog.global.setTimeout;<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * Installs the MockClock by overriding the global object&#39;s implementation of<tr><td><a id="l154"></a><a href="#l154">154</a><td> * setTimeout, setInterval, clearTimeout and clearInterval.<tr><td><a id="l155"></a><a href="#l155">155</a><td> */<tr><td><a id="l156"></a><a href="#l156">156</a><td>goog.testing.MockClock.prototype.install = function() {<tr><td><a id="l157"></a><a href="#l157">157</a><td>  if (!this.replacer_) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>    if (goog.testing.MockClock.REAL_SETTIMEOUT_ !== goog.global.setTimeout) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>      if (typeof console !== &#39;undefined&#39; &amp;&amp; console.warn) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>        console.warn(&#39;Non default setTimeout detected. &#39; +<tr><td><a id="l161"></a><a href="#l161">161</a><td>            &#39;Use of multiple MockClock instances or other clock mocking &#39; +<tr><td><a id="l162"></a><a href="#l162">162</a><td>            &#39;should be avoided due to unspecified behavior and &#39; +<tr><td><a id="l163"></a><a href="#l163">163</a><td>            &#39;the resulting fragility.&#39;);<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>    var r = this.replacer_ = new goog.testing.PropertyReplacer();<tr><td><a id="l168"></a><a href="#l168">168</a><td>    r.set(goog.global, &#39;setTimeout&#39;, goog.bind(this.setTimeout_, this));<tr><td><a id="l169"></a><a href="#l169">169</a><td>    r.set(goog.global, &#39;setInterval&#39;, goog.bind(this.setInterval_, this));<tr><td><a id="l170"></a><a href="#l170">170</a><td>    r.set(goog.global, &#39;setImmediate&#39;, goog.bind(this.setImmediate_, this));<tr><td><a id="l171"></a><a href="#l171">171</a><td>    r.set(goog.global, &#39;clearTimeout&#39;, goog.bind(this.clearTimeout_, this));<tr><td><a id="l172"></a><a href="#l172">172</a><td>    r.set(goog.global, &#39;clearInterval&#39;, goog.bind(this.clearInterval_, this));<tr><td><a id="l173"></a><a href="#l173">173</a><td>    // goog.Promise uses goog.async.run. In order to be able to test<tr><td><a id="l174"></a><a href="#l174">174</a><td>    // Promise-based code, we need to make sure that goog.async.run uses<tr><td><a id="l175"></a><a href="#l175">175</a><td>    // nextTick instead of native browser Promises. This means that it will<tr><td><a id="l176"></a><a href="#l176">176</a><td>    // default to setImmediate, which is replaced above. Note that we test for<tr><td><a id="l177"></a><a href="#l177">177</a><td>    // the presence of goog.async.run.forceNextTick to be resilient to the case<tr><td><a id="l178"></a><a href="#l178">178</a><td>    // where tests replace goog.async.run directly.<tr><td><a id="l179"></a><a href="#l179">179</a><td>    goog.async.run.forceNextTick &amp;&amp; goog.async.run.forceNextTick(<tr><td><a id="l180"></a><a href="#l180">180</a><td>        goog.testing.MockClock.REAL_SETTIMEOUT_);<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td>    // Replace the requestAnimationFrame functions.<tr><td><a id="l183"></a><a href="#l183">183</a><td>    this.replaceRequestAnimationFrame_();<tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td>    // PropertyReplacer#set can&#39;t be called with renameable functions.<tr><td><a id="l186"></a><a href="#l186">186</a><td>    this.oldGoogNow_ = goog.now;<tr><td><a id="l187"></a><a href="#l187">187</a><td>    goog.now = goog.bind(this.getCurrentTime, this);<tr><td><a id="l188"></a><a href="#l188">188</a><td>  }<tr><td><a id="l189"></a><a href="#l189">189</a><td>};<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td>/**<tr><td><a id="l193"></a><a href="#l193">193</a><td> * Installs the mocks for requestAnimationFrame and cancelRequestAnimationFrame.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @private<tr><td><a id="l195"></a><a href="#l195">195</a><td> */<tr><td><a id="l196"></a><a href="#l196">196</a><td>goog.testing.MockClock.prototype.replaceRequestAnimationFrame_ = function() {<tr><td><a id="l197"></a><a href="#l197">197</a><td>  var r = this.replacer_;<tr><td><a id="l198"></a><a href="#l198">198</a><td>  var requestFuncs = [&#39;requestAnimationFrame&#39;,<tr><td><a id="l199"></a><a href="#l199">199</a><td>                      &#39;webkitRequestAnimationFrame&#39;,<tr><td><a id="l200"></a><a href="#l200">200</a><td>                      &#39;mozRequestAnimationFrame&#39;,<tr><td><a id="l201"></a><a href="#l201">201</a><td>                      &#39;oRequestAnimationFrame&#39;,<tr><td><a id="l202"></a><a href="#l202">202</a><td>                      &#39;msRequestAnimationFrame&#39;];<tr><td><a id="l203"></a><a href="#l203">203</a><td><tr><td><a id="l204"></a><a href="#l204">204</a><td>  var cancelFuncs = [&#39;cancelAnimationFrame&#39;,<tr><td><a id="l205"></a><a href="#l205">205</a><td>                     &#39;cancelRequestAnimationFrame&#39;,<tr><td><a id="l206"></a><a href="#l206">206</a><td>                     &#39;webkitCancelRequestAnimationFrame&#39;,<tr><td><a id="l207"></a><a href="#l207">207</a><td>                     &#39;mozCancelRequestAnimationFrame&#39;,<tr><td><a id="l208"></a><a href="#l208">208</a><td>                     &#39;oCancelRequestAnimationFrame&#39;,<tr><td><a id="l209"></a><a href="#l209">209</a><td>                     &#39;msCancelRequestAnimationFrame&#39;];<tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>  for (var i = 0; i &lt; requestFuncs.length; ++i) {<tr><td><a id="l212"></a><a href="#l212">212</a><td>    if (goog.global &amp;&amp; goog.global[requestFuncs[i]]) {<tr><td><a id="l213"></a><a href="#l213">213</a><td>      r.set(goog.global, requestFuncs[i],<tr><td><a id="l214"></a><a href="#l214">214</a><td>          goog.bind(this.requestAnimationFrame_, this));<tr><td><a id="l215"></a><a href="#l215">215</a><td>    }<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>  for (var i = 0; i &lt; cancelFuncs.length; ++i) {<tr><td><a id="l219"></a><a href="#l219">219</a><td>    if (goog.global &amp;&amp; goog.global[cancelFuncs[i]]) {<tr><td><a id="l220"></a><a href="#l220">220</a><td>      r.set(goog.global, cancelFuncs[i],<tr><td><a id="l221"></a><a href="#l221">221</a><td>          goog.bind(this.cancelRequestAnimationFrame_, this));<tr><td><a id="l222"></a><a href="#l222">222</a><td>    }<tr><td><a id="l223"></a><a href="#l223">223</a><td>  }<tr><td><a id="l224"></a><a href="#l224">224</a><td>};<tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td><tr><td><a id="l227"></a><a href="#l227">227</a><td>/**<tr><td><a id="l228"></a><a href="#l228">228</a><td> * Removes the MockClock&#39;s hooks into the global object&#39;s functions and revert<tr><td><a id="l229"></a><a href="#l229">229</a><td> * to their original values.<tr><td><a id="l230"></a><a href="#l230">230</a><td> */<tr><td><a id="l231"></a><a href="#l231">231</a><td>goog.testing.MockClock.prototype.uninstall = function() {<tr><td><a id="l232"></a><a href="#l232">232</a><td>  if (this.replacer_) {<tr><td><a id="l233"></a><a href="#l233">233</a><td>    this.replacer_.reset();<tr><td><a id="l234"></a><a href="#l234">234</a><td>    this.replacer_ = null;<tr><td><a id="l235"></a><a href="#l235">235</a><td>    goog.now = this.oldGoogNow_;<tr><td><a id="l236"></a><a href="#l236">236</a><td>  }<tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>  this.resetAsyncQueue_();<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><tr><td><a id="l242"></a><a href="#l242">242</a><td>/** @override */<tr><td><a id="l243"></a><a href="#l243">243</a><td>goog.testing.MockClock.prototype.disposeInternal = function() {<tr><td><a id="l244"></a><a href="#l244">244</a><td>  this.uninstall();<tr><td><a id="l245"></a><a href="#l245">245</a><td>  this.queue_ = null;<tr><td><a id="l246"></a><a href="#l246">246</a><td>  this.deletedKeys_ = null;<tr><td><a id="l247"></a><a href="#l247">247</a><td>  goog.testing.MockClock.superClass_.disposeInternal.call(this);<tr><td><a id="l248"></a><a href="#l248">248</a><td>};<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td>/**<tr><td><a id="l252"></a><a href="#l252">252</a><td> * Resets the MockClock, removing all timeouts that are scheduled and resets<tr><td><a id="l253"></a><a href="#l253">253</a><td> * the fake timer count.<tr><td><a id="l254"></a><a href="#l254">254</a><td> */<tr><td><a id="l255"></a><a href="#l255">255</a><td>goog.testing.MockClock.prototype.reset = function() {<tr><td><a id="l256"></a><a href="#l256">256</a><td>  this.queue_ = [];<tr><td><a id="l257"></a><a href="#l257">257</a><td>  this.deletedKeys_ = {};<tr><td><a id="l258"></a><a href="#l258">258</a><td>  this.nowMillis_ = 0;<tr><td><a id="l259"></a><a href="#l259">259</a><td>  this.timeoutsMade_ = 0;<tr><td><a id="l260"></a><a href="#l260">260</a><td>  this.timeoutDelay_ = 0;<tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td>  this.resetAsyncQueue_();<tr><td><a id="l263"></a><a href="#l263">263</a><td>};<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td>/**<tr><td><a id="l267"></a><a href="#l267">267</a><td> * Resets the async queue when this clock resets.<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @private<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.testing.MockClock.prototype.resetAsyncQueue_ = function() {<tr><td><a id="l271"></a><a href="#l271">271</a><td>  goog.async.run.resetQueue();<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> * Sets the amount of time between when a timeout is scheduled to fire and when<tr><td><a id="l277"></a><a href="#l277">277</a><td> * it actually fires.<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @param {number} delay The delay in milliseconds.  May be negative.<tr><td><a id="l279"></a><a href="#l279">279</a><td> */<tr><td><a id="l280"></a><a href="#l280">280</a><td>goog.testing.MockClock.prototype.setTimeoutDelay = function(delay) {<tr><td><a id="l281"></a><a href="#l281">281</a><td>  this.timeoutDelay_ = delay;<tr><td><a id="l282"></a><a href="#l282">282</a><td>};<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td>/**<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @return {number} delay The amount of time between when a timeout is<tr><td><a id="l287"></a><a href="#l287">287</a><td> *     scheduled to fire and when it actually fires, in milliseconds.  May<tr><td><a id="l288"></a><a href="#l288">288</a><td> *     be negative.<tr><td><a id="l289"></a><a href="#l289">289</a><td> */<tr><td><a id="l290"></a><a href="#l290">290</a><td>goog.testing.MockClock.prototype.getTimeoutDelay = function() {<tr><td><a id="l291"></a><a href="#l291">291</a><td>  return this.timeoutDelay_;<tr><td><a id="l292"></a><a href="#l292">292</a><td>};<tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>/**<tr><td><a id="l296"></a><a href="#l296">296</a><td> * Increments the MockClock&#39;s time by a given number of milliseconds, running<tr><td><a id="l297"></a><a href="#l297">297</a><td> * any functions that are now overdue.<tr><td><a id="l298"></a><a href="#l298">298</a><td> * @param {number=} opt_millis Number of milliseconds to increment the counter.<tr><td><a id="l299"></a><a href="#l299">299</a><td> *     If not specified, clock ticks 1 millisecond.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @return {number} Current mock time in milliseconds.<tr><td><a id="l301"></a><a href="#l301">301</a><td> */<tr><td><a id="l302"></a><a href="#l302">302</a><td>goog.testing.MockClock.prototype.tick = function(opt_millis) {<tr><td><a id="l303"></a><a href="#l303">303</a><td>  if (typeof opt_millis != &#39;number&#39;) {<tr><td><a id="l304"></a><a href="#l304">304</a><td>    opt_millis = 1;<tr><td><a id="l305"></a><a href="#l305">305</a><td>  }<tr><td><a id="l306"></a><a href="#l306">306</a><td>  var endTime = this.nowMillis_ + opt_millis;<tr><td><a id="l307"></a><a href="#l307">307</a><td>  this.runFunctionsWithinRange_(endTime);<tr><td><a id="l308"></a><a href="#l308">308</a><td>  this.nowMillis_ = endTime;<tr><td><a id="l309"></a><a href="#l309">309</a><td>  return endTime;<tr><td><a id="l310"></a><a href="#l310">310</a><td>};<tr><td><a id="l311"></a><a href="#l311">311</a><td><tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td>/**<tr><td><a id="l314"></a><a href="#l314">314</a><td> * Takes a promise and then ticks the mock clock. If the promise successfully<tr><td><a id="l315"></a><a href="#l315">315</a><td> * resolves, returns the value produced by the promise. If the promise is<tr><td><a id="l316"></a><a href="#l316">316</a><td> * rejected, it throws the rejection as an exception. If the promise is not<tr><td><a id="l317"></a><a href="#l317">317</a><td> * resolved at all, throws an exception.<tr><td><a id="l318"></a><a href="#l318">318</a><td> * Also ticks the general clock by the specified amount.<tr><td><a id="l319"></a><a href="#l319">319</a><td> *<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {!goog.Thenable&lt;T&gt;} promise A promise that should be resolved after<tr><td><a id="l321"></a><a href="#l321">321</a><td> *     the mockClock is ticked for the given opt_millis.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {number=} opt_millis Number of milliseconds to increment the counter.<tr><td><a id="l323"></a><a href="#l323">323</a><td> *     If not specified, clock ticks 1 millisecond.<tr><td><a id="l324"></a><a href="#l324">324</a><td> * @return {T}<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @template T<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.testing.MockClock.prototype.tickPromise = function(promise, opt_millis) {<tr><td><a id="l328"></a><a href="#l328">328</a><td>  var value;<tr><td><a id="l329"></a><a href="#l329">329</a><td>  var error;<tr><td><a id="l330"></a><a href="#l330">330</a><td>  var resolved = false;<tr><td><a id="l331"></a><a href="#l331">331</a><td>  promise.then(function(v) {<tr><td><a id="l332"></a><a href="#l332">332</a><td>    value = v;<tr><td><a id="l333"></a><a href="#l333">333</a><td>    resolved = true;<tr><td><a id="l334"></a><a href="#l334">334</a><td>  }, function(e) {<tr><td><a id="l335"></a><a href="#l335">335</a><td>    error = e;<tr><td><a id="l336"></a><a href="#l336">336</a><td>    resolved = true;<tr><td><a id="l337"></a><a href="#l337">337</a><td>  });<tr><td><a id="l338"></a><a href="#l338">338</a><td>  this.tick(opt_millis);<tr><td><a id="l339"></a><a href="#l339">339</a><td>  if (!resolved) {<tr><td><a id="l340"></a><a href="#l340">340</a><td>    throw new Error(<tr><td><a id="l341"></a><a href="#l341">341</a><td>        &#39;Promise was expected to be resolved after mock clock tick.&#39;);<tr><td><a id="l342"></a><a href="#l342">342</a><td>  }<tr><td><a id="l343"></a><a href="#l343">343</a><td>  if (error) {<tr><td><a id="l344"></a><a href="#l344">344</a><td>    throw error;<tr><td><a id="l345"></a><a href="#l345">345</a><td>  }<tr><td><a id="l346"></a><a href="#l346">346</a><td>  return value;<tr><td><a id="l347"></a><a href="#l347">347</a><td>};<tr><td><a id="l348"></a><a href="#l348">348</a><td><tr><td><a id="l349"></a><a href="#l349">349</a><td><tr><td><a id="l350"></a><a href="#l350">350</a><td>/**<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @return {number} The number of timeouts that have been scheduled.<tr><td><a id="l352"></a><a href="#l352">352</a><td> */<tr><td><a id="l353"></a><a href="#l353">353</a><td>goog.testing.MockClock.prototype.getTimeoutsMade = function() {<tr><td><a id="l354"></a><a href="#l354">354</a><td>  return this.timeoutsMade_;<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> * @return {number} The MockClock&#39;s current time in milliseconds.<tr><td><a id="l360"></a><a href="#l360">360</a><td> */<tr><td><a id="l361"></a><a href="#l361">361</a><td>goog.testing.MockClock.prototype.getCurrentTime = function() {<tr><td><a id="l362"></a><a href="#l362">362</a><td>  return this.nowMillis_;<tr><td><a id="l363"></a><a href="#l363">363</a><td>};<tr><td><a id="l364"></a><a href="#l364">364</a><td><tr><td><a id="l365"></a><a href="#l365">365</a><td><tr><td><a id="l366"></a><a href="#l366">366</a><td>/**<tr><td><a id="l367"></a><a href="#l367">367</a><td> * @param {number} timeoutKey The timeout key.<tr><td><a id="l368"></a><a href="#l368">368</a><td> * @return {boolean} Whether the timer has been set and not cleared,<tr><td><a id="l369"></a><a href="#l369">369</a><td> *     independent of the timeout&#39;s expiration.  In other words, the timeout<tr><td><a id="l370"></a><a href="#l370">370</a><td> *     could have passed or could be scheduled for the future.  Either way,<tr><td><a id="l371"></a><a href="#l371">371</a><td> *     this function returns true or false depending only on whether the<tr><td><a id="l372"></a><a href="#l372">372</a><td> *     provided timeoutKey represents a timeout that has been set and not<tr><td><a id="l373"></a><a href="#l373">373</a><td> *     cleared.<tr><td><a id="l374"></a><a href="#l374">374</a><td> */<tr><td><a id="l375"></a><a href="#l375">375</a><td>goog.testing.MockClock.prototype.isTimeoutSet = function(timeoutKey) {<tr><td><a id="l376"></a><a href="#l376">376</a><td>  return timeoutKey &lt; goog.testing.MockClock.nextId &amp;&amp;<tr><td><a id="l377"></a><a href="#l377">377</a><td>      timeoutKey &gt;= goog.testing.MockClock.nextId - this.timeoutsMade_ &amp;&amp;<tr><td><a id="l378"></a><a href="#l378">378</a><td>      !this.deletedKeys_[timeoutKey];<tr><td><a id="l379"></a><a href="#l379">379</a><td>};<tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td><tr><td><a id="l382"></a><a href="#l382">382</a><td>/**<tr><td><a id="l383"></a><a href="#l383">383</a><td> * Runs any function that is scheduled before a certain time.  Timeouts can<tr><td><a id="l384"></a><a href="#l384">384</a><td> * be made to fire early or late if timeoutDelay_ is non-0.<tr><td><a id="l385"></a><a href="#l385">385</a><td> * @param {number} endTime The latest time in the range, in milliseconds.<tr><td><a id="l386"></a><a href="#l386">386</a><td> * @private<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.testing.MockClock.prototype.runFunctionsWithinRange_ = function(<tr><td><a id="l389"></a><a href="#l389">389</a><td>    endTime) {<tr><td><a id="l390"></a><a href="#l390">390</a><td>  var adjustedEndTime = endTime - this.timeoutDelay_;<tr><td><a id="l391"></a><a href="#l391">391</a><td><tr><td><a id="l392"></a><a href="#l392">392</a><td>  // Repeatedly pop off the last item since the queue is always sorted.<tr><td><a id="l393"></a><a href="#l393">393</a><td>  while (this.queue_ &amp;&amp; this.queue_.length &amp;&amp;<tr><td><a id="l394"></a><a href="#l394">394</a><td>      this.queue_[this.queue_.length - 1].runAtMillis &lt;= adjustedEndTime) {<tr><td><a id="l395"></a><a href="#l395">395</a><td>    var timeout = this.queue_.pop();<tr><td><a id="l396"></a><a href="#l396">396</a><td><tr><td><a id="l397"></a><a href="#l397">397</a><td>    if (!(timeout.timeoutKey in this.deletedKeys_)) {<tr><td><a id="l398"></a><a href="#l398">398</a><td>      // Only move time forwards.<tr><td><a id="l399"></a><a href="#l399">399</a><td>      this.nowMillis_ = Math.max(this.nowMillis_,<tr><td><a id="l400"></a><a href="#l400">400</a><td>          timeout.runAtMillis + this.timeoutDelay_);<tr><td><a id="l401"></a><a href="#l401">401</a><td>      // Call timeout in global scope and pass the timeout key as the argument.<tr><td><a id="l402"></a><a href="#l402">402</a><td>      timeout.funcToCall.call(goog.global, timeout.timeoutKey);<tr><td><a id="l403"></a><a href="#l403">403</a><td>      // In case the interval was cleared in the funcToCall<tr><td><a id="l404"></a><a href="#l404">404</a><td>      if (timeout.recurring) {<tr><td><a id="l405"></a><a href="#l405">405</a><td>        this.scheduleFunction_(<tr><td><a id="l406"></a><a href="#l406">406</a><td>            timeout.timeoutKey, timeout.funcToCall, timeout.millis, true);<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><tr><td><a id="l412"></a><a href="#l412">412</a><td><tr><td><a id="l413"></a><a href="#l413">413</a><td>/**<tr><td><a id="l414"></a><a href="#l414">414</a><td> * Schedules a function to be run at a certain time.<tr><td><a id="l415"></a><a href="#l415">415</a><td> * @param {number} timeoutKey The timeout key.<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @param {Function} funcToCall The function to call.<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @param {number} millis The number of milliseconds to call it in.<tr><td><a id="l418"></a><a href="#l418">418</a><td> * @param {boolean} recurring Whether to function call should recur.<tr><td><a id="l419"></a><a href="#l419">419</a><td> * @private<tr><td><a id="l420"></a><a href="#l420">420</a><td> */<tr><td><a id="l421"></a><a href="#l421">421</a><td>goog.testing.MockClock.prototype.scheduleFunction_ = function(<tr><td><a id="l422"></a><a href="#l422">422</a><td>    timeoutKey, funcToCall, millis, recurring) {<tr><td><a id="l423"></a><a href="#l423">423</a><td>  if (!goog.isFunction(funcToCall)) {<tr><td><a id="l424"></a><a href="#l424">424</a><td>    // Early error for debuggability rather than dying in the next .tick()<tr><td><a id="l425"></a><a href="#l425">425</a><td>    throw new TypeError(&#39;The provided callback must be a function, not a &#39; +<tr><td><a id="l426"></a><a href="#l426">426</a><td>        typeof funcToCall);<tr><td><a id="l427"></a><a href="#l427">427</a><td>  }<tr><td><a id="l428"></a><a href="#l428">428</a><td><tr><td><a id="l429"></a><a href="#l429">429</a><td>  var timeout = {<tr><td><a id="l430"></a><a href="#l430">430</a><td>    runAtMillis: this.nowMillis_ + millis,<tr><td><a id="l431"></a><a href="#l431">431</a><td>    funcToCall: funcToCall,<tr><td><a id="l432"></a><a href="#l432">432</a><td>    recurring: recurring,<tr><td><a id="l433"></a><a href="#l433">433</a><td>    timeoutKey: timeoutKey,<tr><td><a id="l434"></a><a href="#l434">434</a><td>    millis: millis<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>  goog.testing.MockClock.insert_(timeout, this.queue_);<tr><td><a id="l438"></a><a href="#l438">438</a><td>};<tr><td><a id="l439"></a><a href="#l439">439</a><td><tr><td><a id="l440"></a><a href="#l440">440</a><td><tr><td><a id="l441"></a><a href="#l441">441</a><td>/**<tr><td><a id="l442"></a><a href="#l442">442</a><td> * Inserts a timer descriptor into a descending-order queue.<tr><td><a id="l443"></a><a href="#l443">443</a><td> *<tr><td><a id="l444"></a><a href="#l444">444</a><td> * Later-inserted duplicates appear at lower indices.  For example, the<tr><td><a id="l445"></a><a href="#l445">445</a><td> * asterisk in (5,4,*,3,2,1) would be the insertion point for 3.<tr><td><a id="l446"></a><a href="#l446">446</a><td> *<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {Object} timeout The timeout to insert, with numerical runAtMillis<tr><td><a id="l448"></a><a href="#l448">448</a><td> *     property.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @param {Array&lt;Object&gt;} queue The queue to insert into, with each element<tr><td><a id="l450"></a><a href="#l450">450</a><td> *     having a numerical runAtMillis property.<tr><td><a id="l451"></a><a href="#l451">451</a><td> * @private<tr><td><a id="l452"></a><a href="#l452">452</a><td> */<tr><td><a id="l453"></a><a href="#l453">453</a><td>goog.testing.MockClock.insert_ = function(timeout, queue) {<tr><td><a id="l454"></a><a href="#l454">454</a><td>  // Although insertion of N items is quadratic, requiring goog.structs.Heap<tr><td><a id="l455"></a><a href="#l455">455</a><td>  // from a unit test will make tests more prone to breakage.  Since unit<tr><td><a id="l456"></a><a href="#l456">456</a><td>  // tests are normally small, scalability is not a primary issue.<tr><td><a id="l457"></a><a href="#l457">457</a><td><tr><td><a id="l458"></a><a href="#l458">458</a><td>  // Find an insertion point.  Since the queue is in reverse order (so we<tr><td><a id="l459"></a><a href="#l459">459</a><td>  // can pop rather than unshift), and later timers with the same time stamp<tr><td><a id="l460"></a><a href="#l460">460</a><td>  // should be executed later, we look for the element strictly greater than<tr><td><a id="l461"></a><a href="#l461">461</a><td>  // the one we are inserting.<tr><td><a id="l462"></a><a href="#l462">462</a><td><tr><td><a id="l463"></a><a href="#l463">463</a><td>  for (var i = queue.length; i != 0; i--) {<tr><td><a id="l464"></a><a href="#l464">464</a><td>    if (queue[i - 1].runAtMillis &gt; timeout.runAtMillis) {<tr><td><a id="l465"></a><a href="#l465">465</a><td>      break;<tr><td><a id="l466"></a><a href="#l466">466</a><td>    }<tr><td><a id="l467"></a><a href="#l467">467</a><td>    queue[i] = queue[i - 1];<tr><td><a id="l468"></a><a href="#l468">468</a><td>  }<tr><td><a id="l469"></a><a href="#l469">469</a><td><tr><td><a id="l470"></a><a href="#l470">470</a><td>  queue[i] = timeout;<tr><td><a id="l471"></a><a href="#l471">471</a><td>};<tr><td><a id="l472"></a><a href="#l472">472</a><td><tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td>/**<tr><td><a id="l475"></a><a href="#l475">475</a><td> * Maximum 32-bit signed integer.<tr><td><a id="l476"></a><a href="#l476">476</a><td> *<tr><td><a id="l477"></a><a href="#l477">477</a><td> * Timeouts over this time return immediately in many browsers, due to integer<tr><td><a id="l478"></a><a href="#l478">478</a><td> * overflow.  Such known browsers include Firefox, Chrome, and Safari, but not<tr><td><a id="l479"></a><a href="#l479">479</a><td> * IE.<tr><td><a id="l480"></a><a href="#l480">480</a><td> *<tr><td><a id="l481"></a><a href="#l481">481</a><td> * @type {number}<tr><td><a id="l482"></a><a href="#l482">482</a><td> * @private<tr><td><a id="l483"></a><a href="#l483">483</a><td> */<tr><td><a id="l484"></a><a href="#l484">484</a><td>goog.testing.MockClock.MAX_INT_ = 2147483647;<tr><td><a id="l485"></a><a href="#l485">485</a><td><tr><td><a id="l486"></a><a href="#l486">486</a><td><tr><td><a id="l487"></a><a href="#l487">487</a><td>/**<tr><td><a id="l488"></a><a href="#l488">488</a><td> * Schedules a function to be called after {@code millis} milliseconds.<tr><td><a id="l489"></a><a href="#l489">489</a><td> * Mock implementation for setTimeout.<tr><td><a id="l490"></a><a href="#l490">490</a><td> * @param {Function} funcToCall The function to call.<tr><td><a id="l491"></a><a href="#l491">491</a><td> * @param {number=} opt_millis The number of milliseconds to call it after.<tr><td><a id="l492"></a><a href="#l492">492</a><td> * @return {number} The number of timeouts created.<tr><td><a id="l493"></a><a href="#l493">493</a><td> * @private<tr><td><a id="l494"></a><a href="#l494">494</a><td> */<tr><td><a id="l495"></a><a href="#l495">495</a><td>goog.testing.MockClock.prototype.setTimeout_ = function(<tr><td><a id="l496"></a><a href="#l496">496</a><td>    funcToCall, opt_millis) {<tr><td><a id="l497"></a><a href="#l497">497</a><td>  var millis = opt_millis || 0;<tr><td><a id="l498"></a><a href="#l498">498</a><td>  if (millis &gt; goog.testing.MockClock.MAX_INT_) {<tr><td><a id="l499"></a><a href="#l499">499</a><td>    throw Error(<tr><td><a id="l500"></a><a href="#l500">500</a><td>        &#39;Bad timeout value: &#39; + millis + &#39;.  Timeouts over MAX_INT &#39; +<tr><td><a id="l501"></a><a href="#l501">501</a><td>        &#39;(24.8 days) cause timeouts to be fired &#39; +<tr><td><a id="l502"></a><a href="#l502">502</a><td>        &#39;immediately in most browsers, except for IE.&#39;);<tr><td><a id="l503"></a><a href="#l503">503</a><td>  }<tr><td><a id="l504"></a><a href="#l504">504</a><td>  this.timeoutsMade_++;<tr><td><a id="l505"></a><a href="#l505">505</a><td>  this.scheduleFunction_(goog.testing.MockClock.nextId, funcToCall, millis,<tr><td><a id="l506"></a><a href="#l506">506</a><td>      false);<tr><td><a id="l507"></a><a href="#l507">507</a><td>  return goog.testing.MockClock.nextId++;<tr><td><a id="l508"></a><a href="#l508">508</a><td>};<tr><td><a id="l509"></a><a href="#l509">509</a><td><tr><td><a id="l510"></a><a href="#l510">510</a><td><tr><td><a id="l511"></a><a href="#l511">511</a><td>/**<tr><td><a id="l512"></a><a href="#l512">512</a><td> * Schedules a function to be called every {@code millis} milliseconds.<tr><td><a id="l513"></a><a href="#l513">513</a><td> * Mock implementation for setInterval.<tr><td><a id="l514"></a><a href="#l514">514</a><td> * @param {Function} funcToCall The function to call.<tr><td><a id="l515"></a><a href="#l515">515</a><td> * @param {number=} opt_millis The number of milliseconds between calls.<tr><td><a id="l516"></a><a href="#l516">516</a><td> * @return {number} The number of timeouts created.<tr><td><a id="l517"></a><a href="#l517">517</a><td> * @private<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.testing.MockClock.prototype.setInterval_ =<tr><td><a id="l520"></a><a href="#l520">520</a><td>    function(funcToCall, opt_millis) {<tr><td><a id="l521"></a><a href="#l521">521</a><td>  var millis = opt_millis || 0;<tr><td><a id="l522"></a><a href="#l522">522</a><td>  this.timeoutsMade_++;<tr><td><a id="l523"></a><a href="#l523">523</a><td>  this.scheduleFunction_(goog.testing.MockClock.nextId, funcToCall, millis,<tr><td><a id="l524"></a><a href="#l524">524</a><td>      true);<tr><td><a id="l525"></a><a href="#l525">525</a><td>  return goog.testing.MockClock.nextId++;<tr><td><a id="l526"></a><a href="#l526">526</a><td>};<tr><td><a id="l527"></a><a href="#l527">527</a><td><tr><td><a id="l528"></a><a href="#l528">528</a><td><tr><td><a id="l529"></a><a href="#l529">529</a><td>/**<tr><td><a id="l530"></a><a href="#l530">530</a><td> * Schedules a function to be called when an animation frame is triggered.<tr><td><a id="l531"></a><a href="#l531">531</a><td> * Mock implementation for requestAnimationFrame.<tr><td><a id="l532"></a><a href="#l532">532</a><td> * @param {Function} funcToCall The function to call.<tr><td><a id="l533"></a><a href="#l533">533</a><td> * @return {number} The number of timeouts created.<tr><td><a id="l534"></a><a href="#l534">534</a><td> * @private<tr><td><a id="l535"></a><a href="#l535">535</a><td> */<tr><td><a id="l536"></a><a href="#l536">536</a><td>goog.testing.MockClock.prototype.requestAnimationFrame_ = function(funcToCall) {<tr><td><a id="l537"></a><a href="#l537">537</a><td>  return this.setTimeout_(goog.bind(function() {<tr><td><a id="l538"></a><a href="#l538">538</a><td>    if (funcToCall) {<tr><td><a id="l539"></a><a href="#l539">539</a><td>      funcToCall(this.getCurrentTime());<tr><td><a id="l540"></a><a href="#l540">540</a><td>    } else if (goog.global.mozRequestAnimationFrame) {<tr><td><a id="l541"></a><a href="#l541">541</a><td>      var event = new goog.testing.events.Event(&#39;MozBeforePaint&#39;, goog.global);<tr><td><a id="l542"></a><a href="#l542">542</a><td>      event[&#39;timeStamp&#39;] = this.getCurrentTime();<tr><td><a id="l543"></a><a href="#l543">543</a><td>      goog.testing.events.fireBrowserEvent(event);<tr><td><a id="l544"></a><a href="#l544">544</a><td>    }<tr><td><a id="l545"></a><a href="#l545">545</a><td>  }, this), goog.testing.MockClock.REQUEST_ANIMATION_FRAME_TIMEOUT);<tr><td><a id="l546"></a><a href="#l546">546</a><td>};<tr><td><a id="l547"></a><a href="#l547">547</a><td><tr><td><a id="l548"></a><a href="#l548">548</a><td><tr><td><a id="l549"></a><a href="#l549">549</a><td>/**<tr><td><a id="l550"></a><a href="#l550">550</a><td> * Schedules a function to be called immediately after the current JS<tr><td><a id="l551"></a><a href="#l551">551</a><td> * execution.<tr><td><a id="l552"></a><a href="#l552">552</a><td> * Mock implementation for setImmediate.<tr><td><a id="l553"></a><a href="#l553">553</a><td> * @param {Function} funcToCall The function to call.<tr><td><a id="l554"></a><a href="#l554">554</a><td> * @return {number} The number of timeouts created.<tr><td><a id="l555"></a><a href="#l555">555</a><td> * @private<tr><td><a id="l556"></a><a href="#l556">556</a><td> */<tr><td><a id="l557"></a><a href="#l557">557</a><td>goog.testing.MockClock.prototype.setImmediate_ = function(funcToCall) {<tr><td><a id="l558"></a><a href="#l558">558</a><td>  return this.setTimeout_(funcToCall, 0);<tr><td><a id="l559"></a><a href="#l559">559</a><td>};<tr><td><a id="l560"></a><a href="#l560">560</a><td><tr><td><a id="l561"></a><a href="#l561">561</a><td><tr><td><a id="l562"></a><a href="#l562">562</a><td>/**<tr><td><a id="l563"></a><a href="#l563">563</a><td> * Clears a timeout.<tr><td><a id="l564"></a><a href="#l564">564</a><td> * Mock implementation for clearTimeout.<tr><td><a id="l565"></a><a href="#l565">565</a><td> * @param {number} timeoutKey The timeout key to clear.<tr><td><a id="l566"></a><a href="#l566">566</a><td> * @private<tr><td><a id="l567"></a><a href="#l567">567</a><td> */<tr><td><a id="l568"></a><a href="#l568">568</a><td>goog.testing.MockClock.prototype.clearTimeout_ = function(timeoutKey) {<tr><td><a id="l569"></a><a href="#l569">569</a><td>  // Some common libraries register static state with timers.<tr><td><a id="l570"></a><a href="#l570">570</a><td>  // This is bad. It leads to all sorts of crazy test problems where<tr><td><a id="l571"></a><a href="#l571">571</a><td>  // 1) Test A sets up a new mock clock and a static timer.<tr><td><a id="l572"></a><a href="#l572">572</a><td>  // 2) Test B sets up a new mock clock, but re-uses the static timer<tr><td><a id="l573"></a><a href="#l573">573</a><td>  //    from Test A.<tr><td><a id="l574"></a><a href="#l574">574</a><td>  // 3) A timeout key from test A gets cleared, breaking a timeout in<tr><td><a id="l575"></a><a href="#l575">575</a><td>  //    Test B.<tr><td><a id="l576"></a><a href="#l576">576</a><td>  //<tr><td><a id="l577"></a><a href="#l577">577</a><td>  // For now, we just hackily fail silently if someone tries to clear a timeout<tr><td><a id="l578"></a><a href="#l578">578</a><td>  // key before we&#39;ve allocated it.<tr><td><a id="l579"></a><a href="#l579">579</a><td>  // Ideally, we should throw an exception if we see this happening.<tr><td><a id="l580"></a><a href="#l580">580</a><td>  if (this.isTimeoutSet(timeoutKey)) {<tr><td><a id="l581"></a><a href="#l581">581</a><td>    this.deletedKeys_[timeoutKey] = true;<tr><td><a id="l582"></a><a href="#l582">582</a><td>  }<tr><td><a id="l583"></a><a href="#l583">583</a><td>};<tr><td><a id="l584"></a><a href="#l584">584</a><td><tr><td><a id="l585"></a><a href="#l585">585</a><td><tr><td><a id="l586"></a><a href="#l586">586</a><td>/**<tr><td><a id="l587"></a><a href="#l587">587</a><td> * Clears an interval.<tr><td><a id="l588"></a><a href="#l588">588</a><td> * Mock implementation for clearInterval.<tr><td><a id="l589"></a><a href="#l589">589</a><td> * @param {number} timeoutKey The interval key to clear.<tr><td><a id="l590"></a><a href="#l590">590</a><td> * @private<tr><td><a id="l591"></a><a href="#l591">591</a><td> */<tr><td><a id="l592"></a><a href="#l592">592</a><td>goog.testing.MockClock.prototype.clearInterval_ = function(timeoutKey) {<tr><td><a id="l593"></a><a href="#l593">593</a><td>  this.clearTimeout_(timeoutKey);<tr><td><a id="l594"></a><a href="#l594">594</a><td>};<tr><td><a id="l595"></a><a href="#l595">595</a><td><tr><td><a id="l596"></a><a href="#l596">596</a><td><tr><td><a id="l597"></a><a href="#l597">597</a><td>/**<tr><td><a id="l598"></a><a href="#l598">598</a><td> * Clears a requestAnimationFrame.<tr><td><a id="l599"></a><a href="#l599">599</a><td> * Mock implementation for cancelRequestAnimationFrame.<tr><td><a id="l600"></a><a href="#l600">600</a><td> * @param {number} timeoutKey The requestAnimationFrame key to clear.<tr><td><a id="l601"></a><a href="#l601">601</a><td> * @private<tr><td><a id="l602"></a><a href="#l602">602</a><td> */<tr><td><a id="l603"></a><a href="#l603">603</a><td>goog.testing.MockClock.prototype.cancelRequestAnimationFrame_ =<tr><td><a id="l604"></a><a href="#l604">604</a><td>    function(timeoutKey) {<tr><td><a id="l605"></a><a href="#l605">605</a><td>  this.clearTimeout_(timeoutKey);<tr><td><a id="l606"></a><a href="#l606">606</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/mockcontrol.js.src.html b/docs/source/lib/goog/testing/mockcontrol.js.src.html
new file mode 100644
index 0000000..f596062
--- /dev/null
+++ b/docs/source/lib/goog/testing/mockcontrol.js.src.html
@@ -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>mockcontrol.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/mockcontrol.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A MockControl holds a set of mocks for a particular test.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * It consolidates calls to $replay, $verify, and $tearDown, which simplifies<tr><td><a id="l18"></a><a href="#l18">18</a><td> * the test and helps avoid omissions.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * You can create and control a mock:<tr><td><a id="l21"></a><a href="#l21">21</a><td> *   var mockFoo = mockControl.addMock(new MyMock(Foo));<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * MockControl also exposes some convenience functions that create<tr><td><a id="l24"></a><a href="#l24">24</a><td> * controlled mocks for common mocks: StrictMock, LooseMock,<tr><td><a id="l25"></a><a href="#l25">25</a><td> * FunctionMock, MethodMock, and GlobalFunctionMock.<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>goog.provide(&#39;goog.testing.MockControl&#39;);<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.require(&#39;goog.array&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;goog.testing&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.testing.LooseMock&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.testing.StrictMock&#39;);<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> * Controls a set of mocks.  Controlled mocks are replayed, verified, and<tr><td><a id="l41"></a><a href="#l41">41</a><td> * cleaned-up at the same time.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @constructor<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.testing.MockControl = function() {<tr><td><a id="l45"></a><a href="#l45">45</a><td>  /**<tr><td><a id="l46"></a><a href="#l46">46</a><td>   * The list of mocks being controlled.<tr><td><a id="l47"></a><a href="#l47">47</a><td>   * @type {Array&lt;goog.testing.MockInterface&gt;}<tr><td><a id="l48"></a><a href="#l48">48</a><td>   * @private<tr><td><a id="l49"></a><a href="#l49">49</a><td>   */<tr><td><a id="l50"></a><a href="#l50">50</a><td>  this.mocks_ = [];<tr><td><a id="l51"></a><a href="#l51">51</a><td>};<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>/**<tr><td><a id="l55"></a><a href="#l55">55</a><td> * Takes control of this mock.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @param {goog.testing.MockInterface} mock Mock to be controlled.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @return {goog.testing.MockInterface} The same mock passed in,<tr><td><a id="l58"></a><a href="#l58">58</a><td> *     for convenience.<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.testing.MockControl.prototype.addMock = function(mock) {<tr><td><a id="l61"></a><a href="#l61">61</a><td>  this.mocks_.push(mock);<tr><td><a id="l62"></a><a href="#l62">62</a><td>  return mock;<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> * Calls replay on each controlled mock.<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.testing.MockControl.prototype.$replayAll = function() {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  goog.array.forEach(this.mocks_, function(m) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>    m.$replay();<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><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * Calls reset on each controlled mock.<tr><td><a id="l78"></a><a href="#l78">78</a><td> */<tr><td><a id="l79"></a><a href="#l79">79</a><td>goog.testing.MockControl.prototype.$resetAll = function() {<tr><td><a id="l80"></a><a href="#l80">80</a><td>  goog.array.forEach(this.mocks_, function(m) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>    m.$reset();<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> * Calls verify on each controlled mock.<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.testing.MockControl.prototype.$verifyAll = function() {<tr><td><a id="l90"></a><a href="#l90">90</a><td>  goog.array.forEach(this.mocks_, function(m) {<tr><td><a id="l91"></a><a href="#l91">91</a><td>    m.$verify();<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><tr><td><a id="l96"></a><a href="#l96">96</a><td>/**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Calls tearDown on each controlled mock, if necesssary.<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.testing.MockControl.prototype.$tearDown = function() {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  goog.array.forEach(this.mocks_, function(m) {<tr><td><a id="l101"></a><a href="#l101">101</a><td>    // $tearDown if defined.<tr><td><a id="l102"></a><a href="#l102">102</a><td>    if (m.$tearDown) {<tr><td><a id="l103"></a><a href="#l103">103</a><td>      m.$tearDown();<tr><td><a id="l104"></a><a href="#l104">104</a><td>    }<tr><td><a id="l105"></a><a href="#l105">105</a><td>    // TODO(user): Somehow determine if verifyAll should have been called<tr><td><a id="l106"></a><a href="#l106">106</a><td>    // but was not.<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>/**<tr><td><a id="l112"></a><a href="#l112">112</a><td> * Creates a controlled StrictMock.  Passes its arguments through to the<tr><td><a id="l113"></a><a href="#l113">113</a><td> * StrictMock constructor.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @param {Object|Function} objectToMock The object that should be mocked, or<tr><td><a id="l115"></a><a href="#l115">115</a><td> *    the constructor of an object to mock.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @param {boolean=} opt_mockStaticMethods An optional argument denoting that<tr><td><a id="l117"></a><a href="#l117">117</a><td> *     a mock should be constructed from the static functions of a class.<tr><td><a id="l118"></a><a href="#l118">118</a><td> * @param {boolean=} opt_createProxy An optional argument denoting that<tr><td><a id="l119"></a><a href="#l119">119</a><td> *     a proxy for the target mock should be created.<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @return {!goog.testing.StrictMock} The mock object.<tr><td><a id="l121"></a><a href="#l121">121</a><td> */<tr><td><a id="l122"></a><a href="#l122">122</a><td>goog.testing.MockControl.prototype.createStrictMock = function(<tr><td><a id="l123"></a><a href="#l123">123</a><td>    objectToMock, opt_mockStaticMethods, opt_createProxy) {<tr><td><a id="l124"></a><a href="#l124">124</a><td>  var m = new goog.testing.StrictMock(objectToMock, opt_mockStaticMethods,<tr><td><a id="l125"></a><a href="#l125">125</a><td>                                      opt_createProxy);<tr><td><a id="l126"></a><a href="#l126">126</a><td>  this.addMock(m);<tr><td><a id="l127"></a><a href="#l127">127</a><td>  return m;<tr><td><a id="l128"></a><a href="#l128">128</a><td>};<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>/**<tr><td><a id="l132"></a><a href="#l132">132</a><td> * Creates a controlled LooseMock.  Passes its arguments through to the<tr><td><a id="l133"></a><a href="#l133">133</a><td> * LooseMock constructor.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @param {Object|Function} objectToMock The object that should be mocked, or<tr><td><a id="l135"></a><a href="#l135">135</a><td> *    the constructor of an object to mock.<tr><td><a id="l136"></a><a href="#l136">136</a><td> * @param {boolean=} opt_ignoreUnexpectedCalls Whether to ignore unexpected<tr><td><a id="l137"></a><a href="#l137">137</a><td> *     calls.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @param {boolean=} opt_mockStaticMethods An optional argument denoting that<tr><td><a id="l139"></a><a href="#l139">139</a><td> *     a mock should be constructed from the static functions of a class.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @param {boolean=} opt_createProxy An optional argument denoting that<tr><td><a id="l141"></a><a href="#l141">141</a><td> *     a proxy for the target mock should be created.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @return {!goog.testing.LooseMock} The mock object.<tr><td><a id="l143"></a><a href="#l143">143</a><td> */<tr><td><a id="l144"></a><a href="#l144">144</a><td>goog.testing.MockControl.prototype.createLooseMock = function(<tr><td><a id="l145"></a><a href="#l145">145</a><td>    objectToMock, opt_ignoreUnexpectedCalls,<tr><td><a id="l146"></a><a href="#l146">146</a><td>    opt_mockStaticMethods, opt_createProxy) {<tr><td><a id="l147"></a><a href="#l147">147</a><td>  var m = new goog.testing.LooseMock(objectToMock, opt_ignoreUnexpectedCalls,<tr><td><a id="l148"></a><a href="#l148">148</a><td>                                     opt_mockStaticMethods, opt_createProxy);<tr><td><a id="l149"></a><a href="#l149">149</a><td>  this.addMock(m);<tr><td><a id="l150"></a><a href="#l150">150</a><td>  return m;<tr><td><a id="l151"></a><a href="#l151">151</a><td>};<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td>/**<tr><td><a id="l155"></a><a href="#l155">155</a><td> * Creates a controlled FunctionMock.  Passes its arguments through to the<tr><td><a id="l156"></a><a href="#l156">156</a><td> * FunctionMock constructor.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @param {string=} opt_functionName The optional name of the function to mock<tr><td><a id="l158"></a><a href="#l158">158</a><td> *     set to &#39;[anonymous mocked function]&#39; if not passed in.<tr><td><a id="l159"></a><a href="#l159">159</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l160"></a><a href="#l160">160</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @return {goog.testing.MockInterface} The mocked function.<tr><td><a id="l162"></a><a href="#l162">162</a><td> */<tr><td><a id="l163"></a><a href="#l163">163</a><td>goog.testing.MockControl.prototype.createFunctionMock = function(<tr><td><a id="l164"></a><a href="#l164">164</a><td>    opt_functionName, opt_strictness) {<tr><td><a id="l165"></a><a href="#l165">165</a><td>  var m = goog.testing.createFunctionMock(opt_functionName, opt_strictness);<tr><td><a id="l166"></a><a href="#l166">166</a><td>  this.addMock(m);<tr><td><a id="l167"></a><a href="#l167">167</a><td>  return m;<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> * Creates a controlled MethodMock.  Passes its arguments through to the<tr><td><a id="l173"></a><a href="#l173">173</a><td> * MethodMock constructor.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @param {Object} scope The scope of the method to be mocked out.<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @param {string} functionName The name of the function we&#39;re going to mock.<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l177"></a><a href="#l177">177</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @return {!goog.testing.MockInterface} The mocked method.<tr><td><a id="l179"></a><a href="#l179">179</a><td> */<tr><td><a id="l180"></a><a href="#l180">180</a><td>goog.testing.MockControl.prototype.createMethodMock = function(<tr><td><a id="l181"></a><a href="#l181">181</a><td>    scope, functionName, opt_strictness) {<tr><td><a id="l182"></a><a href="#l182">182</a><td>  var m = goog.testing.createMethodMock(scope, functionName, opt_strictness);<tr><td><a id="l183"></a><a href="#l183">183</a><td>  this.addMock(m);<tr><td><a id="l184"></a><a href="#l184">184</a><td>  return m;<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> * Creates a controlled MethodMock for a constructor.  Passes its arguments<tr><td><a id="l190"></a><a href="#l190">190</a><td> * through to the MethodMock constructor. See<tr><td><a id="l191"></a><a href="#l191">191</a><td> * {@link goog.testing.createConstructorMock} for details.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @param {Object} scope The scope of the constructor to be mocked out.<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @param {string} constructorName The name of the function we&#39;re going to mock.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l195"></a><a href="#l195">195</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @return {!goog.testing.MockInterface} The mocked method.<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.testing.MockControl.prototype.createConstructorMock = function(<tr><td><a id="l199"></a><a href="#l199">199</a><td>    scope, constructorName, opt_strictness) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>  var m = goog.testing.createConstructorMock(scope, constructorName,<tr><td><a id="l201"></a><a href="#l201">201</a><td>                                             opt_strictness);<tr><td><a id="l202"></a><a href="#l202">202</a><td>  this.addMock(m);<tr><td><a id="l203"></a><a href="#l203">203</a><td>  return m;<tr><td><a id="l204"></a><a href="#l204">204</a><td>};<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td><tr><td><a id="l207"></a><a href="#l207">207</a><td>/**<tr><td><a id="l208"></a><a href="#l208">208</a><td> * Creates a controlled GlobalFunctionMock.  Passes its arguments through to the<tr><td><a id="l209"></a><a href="#l209">209</a><td> * GlobalFunctionMock constructor.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {string} functionName The name of the function we&#39;re going to mock.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or<tr><td><a id="l212"></a><a href="#l212">212</a><td> *     goog.testing.Mock.STRICT. The default is STRICT.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @return {!goog.testing.MockInterface} The mocked function.<tr><td><a id="l214"></a><a href="#l214">214</a><td> */<tr><td><a id="l215"></a><a href="#l215">215</a><td>goog.testing.MockControl.prototype.createGlobalFunctionMock = function(<tr><td><a id="l216"></a><a href="#l216">216</a><td>    functionName, opt_strictness) {<tr><td><a id="l217"></a><a href="#l217">217</a><td>  var m = goog.testing.createGlobalFunctionMock(functionName, opt_strictness);<tr><td><a id="l218"></a><a href="#l218">218</a><td>  this.addMock(m);<tr><td><a id="l219"></a><a href="#l219">219</a><td>  return m;<tr><td><a id="l220"></a><a href="#l220">220</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/mockinterface.js.src.html b/docs/source/lib/goog/testing/mockinterface.js.src.html
new file mode 100644
index 0000000..b644f39
--- /dev/null
+++ b/docs/source/lib/goog/testing/mockinterface.js.src.html
@@ -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>mockinterface.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/mockinterface.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview An interface that all mocks should share.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @author nicksantos@google.com (Nick Santos)<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.testing.MockInterface&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>/** @interface */<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.testing.MockInterface = function() {};<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> * Write down all the expected functions that have been called on the<tr><td><a id="l30"></a><a href="#l30">30</a><td> * mock so far. From here on out, future function calls will be<tr><td><a id="l31"></a><a href="#l31">31</a><td> * compared against this list.<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.testing.MockInterface.prototype.$replay = function() {};<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> * Reset the mock.<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.testing.MockInterface.prototype.$reset = function() {};<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>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * Assert that the expected function calls match the actual calls.<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.testing.MockInterface.prototype.$verify = 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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/mockmatchers.js.src.html b/docs/source/lib/goog/testing/mockmatchers.js.src.html
new file mode 100644
index 0000000..fda5916
--- /dev/null
+++ b/docs/source/lib/goog/testing/mockmatchers.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>mockmatchers.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/mockmatchers.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Matchers to be used with the mock utilities.  They allow for<tr><td><a id="l17"></a><a href="#l17">17</a><td> * flexible matching by type.  Custom matchers can be created by passing a<tr><td><a id="l18"></a><a href="#l18">18</a><td> * matcher function into an ArgumentMatcher instance.<tr><td><a id="l19"></a><a href="#l19">19</a><td> *<tr><td><a id="l20"></a><a href="#l20">20</a><td> * For examples, please see the unit test.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;goog.testing.mockmatchers&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;goog.testing.mockmatchers.ArgumentMatcher&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;goog.testing.mockmatchers.IgnoreArgument&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.provide(&#39;goog.testing.mockmatchers.InstanceOf&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.provide(&#39;goog.testing.mockmatchers.ObjectEquals&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.provide(&#39;goog.testing.mockmatchers.RegexpMatch&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.provide(&#39;goog.testing.mockmatchers.SaveArgument&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.provide(&#39;goog.testing.mockmatchers.TypeOf&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.dom&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.testing.asserts&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td><tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td>/**<tr><td><a id="l41"></a><a href="#l41">41</a><td> * A simple interface for executing argument matching.  A match in this case is<tr><td><a id="l42"></a><a href="#l42">42</a><td> * testing to see if a supplied object fits a given criteria.  True is returned<tr><td><a id="l43"></a><a href="#l43">43</a><td> * if the given criteria is met.<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {Function=} opt_matchFn A function that evaluates a given argument<tr><td><a id="l45"></a><a href="#l45">45</a><td> *     and returns true if it meets a given criteria.<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @param {?string=} opt_matchName The name expressing intent as part of<tr><td><a id="l47"></a><a href="#l47">47</a><td> *      an error message for when a match fails.<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @constructor<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.testing.mockmatchers.ArgumentMatcher =<tr><td><a id="l51"></a><a href="#l51">51</a><td>    function(opt_matchFn, opt_matchName) {<tr><td><a id="l52"></a><a href="#l52">52</a><td>  /**<tr><td><a id="l53"></a><a href="#l53">53</a><td>   * A function that evaluates a given argument and returns true if it meets a<tr><td><a id="l54"></a><a href="#l54">54</a><td>   * given criteria.<tr><td><a id="l55"></a><a href="#l55">55</a><td>   * @type {Function}<tr><td><a id="l56"></a><a href="#l56">56</a><td>   * @private<tr><td><a id="l57"></a><a href="#l57">57</a><td>   */<tr><td><a id="l58"></a><a href="#l58">58</a><td>  this.matchFn_ = opt_matchFn || null;<tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td>  /**<tr><td><a id="l61"></a><a href="#l61">61</a><td>   * A string indicating the match intent (e.g. isBoolean or isString).<tr><td><a id="l62"></a><a href="#l62">62</a><td>   * @type {?string}<tr><td><a id="l63"></a><a href="#l63">63</a><td>   * @private<tr><td><a id="l64"></a><a href="#l64">64</a><td>   */<tr><td><a id="l65"></a><a href="#l65">65</a><td>  this.matchName_ = opt_matchName || null;<tr><td><a id="l66"></a><a href="#l66">66</a><td>};<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>/**<tr><td><a id="l70"></a><a href="#l70">70</a><td> * A function that takes a match argument and an optional MockExpectation<tr><td><a id="l71"></a><a href="#l71">71</a><td> * which (if provided) will get error information and returns whether or<tr><td><a id="l72"></a><a href="#l72">72</a><td> * not it matches.<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @param {*} toVerify The argument that should be verified.<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @param {goog.testing.MockExpectation?=} opt_expectation The expectation<tr><td><a id="l75"></a><a href="#l75">75</a><td> *     for this match.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {boolean} Whether or not a given argument passes verification.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.testing.mockmatchers.ArgumentMatcher.prototype.matches =<tr><td><a id="l79"></a><a href="#l79">79</a><td>    function(toVerify, opt_expectation) {<tr><td><a id="l80"></a><a href="#l80">80</a><td>  if (this.matchFn_) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>    var isamatch = this.matchFn_(toVerify);<tr><td><a id="l82"></a><a href="#l82">82</a><td>    if (!isamatch &amp;&amp; opt_expectation) {<tr><td><a id="l83"></a><a href="#l83">83</a><td>      if (this.matchName_) {<tr><td><a id="l84"></a><a href="#l84">84</a><td>        opt_expectation.addErrorMessage(&#39;Expected: &#39; +<tr><td><a id="l85"></a><a href="#l85">85</a><td>            this.matchName_ + &#39; but was: &#39; + _displayStringForValue(toVerify));<tr><td><a id="l86"></a><a href="#l86">86</a><td>      } else {<tr><td><a id="l87"></a><a href="#l87">87</a><td>        opt_expectation.addErrorMessage(&#39;Expected: missing mockmatcher&#39; +<tr><td><a id="l88"></a><a href="#l88">88</a><td>            &#39; description but was: &#39; +<tr><td><a id="l89"></a><a href="#l89">89</a><td>            _displayStringForValue(toVerify));<tr><td><a id="l90"></a><a href="#l90">90</a><td>      }<tr><td><a id="l91"></a><a href="#l91">91</a><td>    }<tr><td><a id="l92"></a><a href="#l92">92</a><td>    return isamatch;<tr><td><a id="l93"></a><a href="#l93">93</a><td>  } else {<tr><td><a id="l94"></a><a href="#l94">94</a><td>    throw Error(&#39;No match function defined for this mock matcher&#39;);<tr><td><a id="l95"></a><a href="#l95">95</a><td>  }<tr><td><a id="l96"></a><a href="#l96">96</a><td>};<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * A matcher that verifies that an argument is an instance of a given class.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @param {Function} ctor The class that will be used for verification.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @constructor<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @final<tr><td><a id="l106"></a><a href="#l106">106</a><td> */<tr><td><a id="l107"></a><a href="#l107">107</a><td>goog.testing.mockmatchers.InstanceOf = function(ctor) {<tr><td><a id="l108"></a><a href="#l108">108</a><td>  goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l109"></a><a href="#l109">109</a><td>      function(obj) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>        return obj instanceof ctor;<tr><td><a id="l111"></a><a href="#l111">111</a><td>        // NOTE: Browser differences on ctor.toString() output<tr><td><a id="l112"></a><a href="#l112">112</a><td>        // make using that here problematic. So for now, just let<tr><td><a id="l113"></a><a href="#l113">113</a><td>        // people know the instanceOf() failed without providing<tr><td><a id="l114"></a><a href="#l114">114</a><td>        // browser specific details...<tr><td><a id="l115"></a><a href="#l115">115</a><td>      }, &#39;instanceOf()&#39;);<tr><td><a id="l116"></a><a href="#l116">116</a><td>};<tr><td><a id="l117"></a><a href="#l117">117</a><td>goog.inherits(goog.testing.mockmatchers.InstanceOf,<tr><td><a id="l118"></a><a href="#l118">118</a><td>    goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td>/**<tr><td><a id="l123"></a><a href="#l123">123</a><td> * A matcher that verifies that an argument is of a given type (e.g. &quot;object&quot;).<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {string} type The type that a given argument must have.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @constructor<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @final<tr><td><a id="l128"></a><a href="#l128">128</a><td> */<tr><td><a id="l129"></a><a href="#l129">129</a><td>goog.testing.mockmatchers.TypeOf = function(type) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>  goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l131"></a><a href="#l131">131</a><td>      function(obj) {<tr><td><a id="l132"></a><a href="#l132">132</a><td>        return goog.typeOf(obj) == type;<tr><td><a id="l133"></a><a href="#l133">133</a><td>      }, &#39;typeOf(&#39; + type + &#39;)&#39;);<tr><td><a id="l134"></a><a href="#l134">134</a><td>};<tr><td><a id="l135"></a><a href="#l135">135</a><td>goog.inherits(goog.testing.mockmatchers.TypeOf,<tr><td><a id="l136"></a><a href="#l136">136</a><td>    goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td>/**<tr><td><a id="l141"></a><a href="#l141">141</a><td> * A matcher that verifies that an argument matches a given RegExp.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {RegExp} regexp The regular expression that the argument must match.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @constructor<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @final<tr><td><a id="l146"></a><a href="#l146">146</a><td> */<tr><td><a id="l147"></a><a href="#l147">147</a><td>goog.testing.mockmatchers.RegexpMatch = function(regexp) {<tr><td><a id="l148"></a><a href="#l148">148</a><td>  goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l149"></a><a href="#l149">149</a><td>      function(str) {<tr><td><a id="l150"></a><a href="#l150">150</a><td>        return regexp.test(str);<tr><td><a id="l151"></a><a href="#l151">151</a><td>      }, &#39;match(&#39; + regexp + &#39;)&#39;);<tr><td><a id="l152"></a><a href="#l152">152</a><td>};<tr><td><a id="l153"></a><a href="#l153">153</a><td>goog.inherits(goog.testing.mockmatchers.RegexpMatch,<tr><td><a id="l154"></a><a href="#l154">154</a><td>    goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td>/**<tr><td><a id="l159"></a><a href="#l159">159</a><td> * A matcher that always returns true. It is useful when the user does not care<tr><td><a id="l160"></a><a href="#l160">160</a><td> * for some arguments.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * For example: mockFunction(&#39;username&#39;, &#39;password&#39;, IgnoreArgument);<tr><td><a id="l162"></a><a href="#l162">162</a><td> * @constructor<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @final<tr><td><a id="l165"></a><a href="#l165">165</a><td> */<tr><td><a id="l166"></a><a href="#l166">166</a><td>goog.testing.mockmatchers.IgnoreArgument = function() {<tr><td><a id="l167"></a><a href="#l167">167</a><td>  goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l168"></a><a href="#l168">168</a><td>      function() {<tr><td><a id="l169"></a><a href="#l169">169</a><td>        return true;<tr><td><a id="l170"></a><a href="#l170">170</a><td>      }, &#39;true&#39;);<tr><td><a id="l171"></a><a href="#l171">171</a><td>};<tr><td><a id="l172"></a><a href="#l172">172</a><td>goog.inherits(goog.testing.mockmatchers.IgnoreArgument,<tr><td><a id="l173"></a><a href="#l173">173</a><td>    goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * A matcher that verifies that the argument is an object that equals the given<tr><td><a id="l179"></a><a href="#l179">179</a><td> * expected object, using a deep comparison.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {Object} expectedObject An object to match against when<tr><td><a id="l181"></a><a href="#l181">181</a><td> *     verifying the argument.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @constructor<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>goog.testing.mockmatchers.ObjectEquals = function(expectedObject) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>  goog.testing.mockmatchers.ArgumentMatcher.call(this,<tr><td><a id="l187"></a><a href="#l187">187</a><td>      function(matchObject) {<tr><td><a id="l188"></a><a href="#l188">188</a><td>        assertObjectEquals(&#39;Expected equal objects&#39;, expectedObject,<tr><td><a id="l189"></a><a href="#l189">189</a><td>            matchObject);<tr><td><a id="l190"></a><a href="#l190">190</a><td>        return true;<tr><td><a id="l191"></a><a href="#l191">191</a><td>      }, &#39;objectEquals(&#39; + expectedObject + &#39;)&#39;);<tr><td><a id="l192"></a><a href="#l192">192</a><td>};<tr><td><a id="l193"></a><a href="#l193">193</a><td>goog.inherits(goog.testing.mockmatchers.ObjectEquals,<tr><td><a id="l194"></a><a href="#l194">194</a><td>    goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>/** @override */<tr><td><a id="l198"></a><a href="#l198">198</a><td>goog.testing.mockmatchers.ObjectEquals.prototype.matches =<tr><td><a id="l199"></a><a href="#l199">199</a><td>    function(toVerify, opt_expectation) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>  // Override the default matches implementation to capture the exception thrown<tr><td><a id="l201"></a><a href="#l201">201</a><td>  // by assertObjectEquals (if any) and add that message to the expectation.<tr><td><a id="l202"></a><a href="#l202">202</a><td>  try {<tr><td><a id="l203"></a><a href="#l203">203</a><td>    return goog.testing.mockmatchers.ObjectEquals.superClass_.matches.call(<tr><td><a id="l204"></a><a href="#l204">204</a><td>        this, toVerify, opt_expectation);<tr><td><a id="l205"></a><a href="#l205">205</a><td>  } catch (e) {<tr><td><a id="l206"></a><a href="#l206">206</a><td>    if (opt_expectation) {<tr><td><a id="l207"></a><a href="#l207">207</a><td>      opt_expectation.addErrorMessage(e.message);<tr><td><a id="l208"></a><a href="#l208">208</a><td>    }<tr><td><a id="l209"></a><a href="#l209">209</a><td>    return false;<tr><td><a id="l210"></a><a href="#l210">210</a><td>  }<tr><td><a id="l211"></a><a href="#l211">211</a><td>};<tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * A matcher that saves the argument that it is verifying so that your unit test<tr><td><a id="l217"></a><a href="#l217">217</a><td> * can perform extra tests with this argument later.  For example, if the<tr><td><a id="l218"></a><a href="#l218">218</a><td> * argument is a callback method, the unit test can then later call this<tr><td><a id="l219"></a><a href="#l219">219</a><td> * callback to test the asynchronous portion of the call.<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @param {goog.testing.mockmatchers.ArgumentMatcher|Function=} opt_matcher<tr><td><a id="l221"></a><a href="#l221">221</a><td> *     Argument matcher or matching function that will be used to validate the<tr><td><a id="l222"></a><a href="#l222">222</a><td> *     argument.  By default, argument will always be valid.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @param {?string=} opt_matchName The name expressing intent as part of<tr><td><a id="l224"></a><a href="#l224">224</a><td> *      an error message for when a match fails.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @constructor<tr><td><a id="l226"></a><a href="#l226">226</a><td> * @extends {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @final<tr><td><a id="l228"></a><a href="#l228">228</a><td> */<tr><td><a id="l229"></a><a href="#l229">229</a><td>goog.testing.mockmatchers.SaveArgument = function(opt_matcher, opt_matchName) {<tr><td><a id="l230"></a><a href="#l230">230</a><td>  goog.testing.mockmatchers.ArgumentMatcher.call(<tr><td><a id="l231"></a><a href="#l231">231</a><td>      this, /** @type {Function} */ (opt_matcher), opt_matchName);<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>  if (opt_matcher instanceof goog.testing.mockmatchers.ArgumentMatcher) {<tr><td><a id="l234"></a><a href="#l234">234</a><td>    /**<tr><td><a id="l235"></a><a href="#l235">235</a><td>     * Delegate match requests to this matcher.<tr><td><a id="l236"></a><a href="#l236">236</a><td>     * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l237"></a><a href="#l237">237</a><td>     * @private<tr><td><a id="l238"></a><a href="#l238">238</a><td>     */<tr><td><a id="l239"></a><a href="#l239">239</a><td>    this.delegateMatcher_ = opt_matcher;<tr><td><a id="l240"></a><a href="#l240">240</a><td>  } else if (!opt_matcher) {<tr><td><a id="l241"></a><a href="#l241">241</a><td>    this.delegateMatcher_ = goog.testing.mockmatchers.ignoreArgument;<tr><td><a id="l242"></a><a href="#l242">242</a><td>  }<tr><td><a id="l243"></a><a href="#l243">243</a><td>};<tr><td><a id="l244"></a><a href="#l244">244</a><td>goog.inherits(goog.testing.mockmatchers.SaveArgument,<tr><td><a id="l245"></a><a href="#l245">245</a><td>    goog.testing.mockmatchers.ArgumentMatcher);<tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td>/** @override */<tr><td><a id="l249"></a><a href="#l249">249</a><td>goog.testing.mockmatchers.SaveArgument.prototype.matches = function(<tr><td><a id="l250"></a><a href="#l250">250</a><td>    toVerify, opt_expectation) {<tr><td><a id="l251"></a><a href="#l251">251</a><td>  this.arg = toVerify;<tr><td><a id="l252"></a><a href="#l252">252</a><td>  if (this.delegateMatcher_) {<tr><td><a id="l253"></a><a href="#l253">253</a><td>    return this.delegateMatcher_.matches(toVerify, opt_expectation);<tr><td><a id="l254"></a><a href="#l254">254</a><td>  }<tr><td><a id="l255"></a><a href="#l255">255</a><td>  return goog.testing.mockmatchers.SaveArgument.superClass_.matches.call(<tr><td><a id="l256"></a><a href="#l256">256</a><td>      this, toVerify, opt_expectation);<tr><td><a id="l257"></a><a href="#l257">257</a><td>};<tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td>/**<tr><td><a id="l261"></a><a href="#l261">261</a><td> * Saved argument that was verified.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @type {*}<tr><td><a id="l263"></a><a href="#l263">263</a><td> */<tr><td><a id="l264"></a><a href="#l264">264</a><td>goog.testing.mockmatchers.SaveArgument.prototype.arg;<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>/**<tr><td><a id="l268"></a><a href="#l268">268</a><td> * An instance of the IgnoreArgument matcher. Returns true for all matches.<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @type {goog.testing.mockmatchers.IgnoreArgument}<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>goog.testing.mockmatchers.ignoreArgument =<tr><td><a id="l272"></a><a href="#l272">272</a><td>    new goog.testing.mockmatchers.IgnoreArgument();<tr><td><a id="l273"></a><a href="#l273">273</a><td><tr><td><a id="l274"></a><a href="#l274">274</a><td><tr><td><a id="l275"></a><a href="#l275">275</a><td>/**<tr><td><a id="l276"></a><a href="#l276">276</a><td> * A matcher that verifies that an argument is an array.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>goog.testing.mockmatchers.isArray =<tr><td><a id="l280"></a><a href="#l280">280</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.isArray,<tr><td><a id="l281"></a><a href="#l281">281</a><td>        &#39;isArray&#39;);<tr><td><a id="l282"></a><a href="#l282">282</a><td><tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td>/**<tr><td><a id="l285"></a><a href="#l285">285</a><td> * A matcher that verifies that an argument is a array-like.  A NodeList is an<tr><td><a id="l286"></a><a href="#l286">286</a><td> * example of a collection that is very close to an array.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l288"></a><a href="#l288">288</a><td> */<tr><td><a id="l289"></a><a href="#l289">289</a><td>goog.testing.mockmatchers.isArrayLike =<tr><td><a id="l290"></a><a href="#l290">290</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.isArrayLike,<tr><td><a id="l291"></a><a href="#l291">291</a><td>        &#39;isArrayLike&#39;);<tr><td><a id="l292"></a><a href="#l292">292</a><td><tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td>/**<tr><td><a id="l295"></a><a href="#l295">295</a><td> * A matcher that verifies that an argument is a date-like.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>goog.testing.mockmatchers.isDateLike =<tr><td><a id="l299"></a><a href="#l299">299</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.isDateLike,<tr><td><a id="l300"></a><a href="#l300">300</a><td>        &#39;isDateLike&#39;);<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td>/**<tr><td><a id="l304"></a><a href="#l304">304</a><td> * A matcher that verifies that an argument is a string.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>goog.testing.mockmatchers.isString =<tr><td><a id="l308"></a><a href="#l308">308</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.isString,<tr><td><a id="l309"></a><a href="#l309">309</a><td>        &#39;isString&#39;);<tr><td><a id="l310"></a><a href="#l310">310</a><td><tr><td><a id="l311"></a><a href="#l311">311</a><td><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * A matcher that verifies that an argument is a boolean.<tr><td><a id="l314"></a><a href="#l314">314</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l315"></a><a href="#l315">315</a><td> */<tr><td><a id="l316"></a><a href="#l316">316</a><td>goog.testing.mockmatchers.isBoolean =<tr><td><a id="l317"></a><a href="#l317">317</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.isBoolean,<tr><td><a id="l318"></a><a href="#l318">318</a><td>        &#39;isBoolean&#39;);<tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td><tr><td><a id="l321"></a><a href="#l321">321</a><td>/**<tr><td><a id="l322"></a><a href="#l322">322</a><td> * A matcher that verifies that an argument is a number.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l324"></a><a href="#l324">324</a><td> */<tr><td><a id="l325"></a><a href="#l325">325</a><td>goog.testing.mockmatchers.isNumber =<tr><td><a id="l326"></a><a href="#l326">326</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.isNumber,<tr><td><a id="l327"></a><a href="#l327">327</a><td>        &#39;isNumber&#39;);<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * A matcher that verifies that an argument is a function.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>goog.testing.mockmatchers.isFunction =<tr><td><a id="l335"></a><a href="#l335">335</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.isFunction,<tr><td><a id="l336"></a><a href="#l336">336</a><td>        &#39;isFunction&#39;);<tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td>/**<tr><td><a id="l340"></a><a href="#l340">340</a><td> * A matcher that verifies that an argument is an object.<tr><td><a id="l341"></a><a href="#l341">341</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l342"></a><a href="#l342">342</a><td> */<tr><td><a id="l343"></a><a href="#l343">343</a><td>goog.testing.mockmatchers.isObject =<tr><td><a id="l344"></a><a href="#l344">344</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.isObject,<tr><td><a id="l345"></a><a href="#l345">345</a><td>        &#39;isObject&#39;);<tr><td><a id="l346"></a><a href="#l346">346</a><td><tr><td><a id="l347"></a><a href="#l347">347</a><td><tr><td><a id="l348"></a><a href="#l348">348</a><td>/**<tr><td><a id="l349"></a><a href="#l349">349</a><td> * A matcher that verifies that an argument is like a DOM node.<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @type {goog.testing.mockmatchers.ArgumentMatcher}<tr><td><a id="l351"></a><a href="#l351">351</a><td> */<tr><td><a id="l352"></a><a href="#l352">352</a><td>goog.testing.mockmatchers.isNodeLike =<tr><td><a id="l353"></a><a href="#l353">353</a><td>    new goog.testing.mockmatchers.ArgumentMatcher(goog.dom.isNodeLike,<tr><td><a id="l354"></a><a href="#l354">354</a><td>        &#39;isNodeLike&#39;);<tr><td><a id="l355"></a><a href="#l355">355</a><td><tr><td><a id="l356"></a><a href="#l356">356</a><td><tr><td><a id="l357"></a><a href="#l357">357</a><td>/**<tr><td><a id="l358"></a><a href="#l358">358</a><td> * A function that checks to see if an array matches a given set of<tr><td><a id="l359"></a><a href="#l359">359</a><td> * expectations.  The expectations array can be a mix of ArgumentMatcher<tr><td><a id="l360"></a><a href="#l360">360</a><td> * implementations and values.  True will be returned if values are identical or<tr><td><a id="l361"></a><a href="#l361">361</a><td> * if a matcher returns a positive result.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @param {Array&lt;?&gt;} expectedArr An array of expectations which can be either<tr><td><a id="l363"></a><a href="#l363">363</a><td> *     values to check for equality or ArgumentMatchers.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @param {Array&lt;?&gt;} arr The array to match.<tr><td><a id="l365"></a><a href="#l365">365</a><td> * @param {goog.testing.MockExpectation?=} opt_expectation The expectation<tr><td><a id="l366"></a><a href="#l366">366</a><td> *     for this match.<tr><td><a id="l367"></a><a href="#l367">367</a><td> * @return {boolean} Whether or not the given array matches the expectations.<tr><td><a id="l368"></a><a href="#l368">368</a><td> */<tr><td><a id="l369"></a><a href="#l369">369</a><td>goog.testing.mockmatchers.flexibleArrayMatcher =<tr><td><a id="l370"></a><a href="#l370">370</a><td>    function(expectedArr, arr, opt_expectation) {<tr><td><a id="l371"></a><a href="#l371">371</a><td>  return goog.array.equals(expectedArr, arr, function(a, b) {<tr><td><a id="l372"></a><a href="#l372">372</a><td>    var errCount = 0;<tr><td><a id="l373"></a><a href="#l373">373</a><td>    if (opt_expectation) {<tr><td><a id="l374"></a><a href="#l374">374</a><td>      errCount = opt_expectation.getErrorMessageCount();<tr><td><a id="l375"></a><a href="#l375">375</a><td>    }<tr><td><a id="l376"></a><a href="#l376">376</a><td>    var isamatch = a === b ||<tr><td><a id="l377"></a><a href="#l377">377</a><td>        a instanceof goog.testing.mockmatchers.ArgumentMatcher &amp;&amp;<tr><td><a id="l378"></a><a href="#l378">378</a><td>        a.matches(b, opt_expectation);<tr><td><a id="l379"></a><a href="#l379">379</a><td>    var failureMessage = null;<tr><td><a id="l380"></a><a href="#l380">380</a><td>    if (!isamatch) {<tr><td><a id="l381"></a><a href="#l381">381</a><td>      failureMessage = goog.testing.asserts.findDifferences(a, b);<tr><td><a id="l382"></a><a href="#l382">382</a><td>      isamatch = !failureMessage;<tr><td><a id="l383"></a><a href="#l383">383</a><td>    }<tr><td><a id="l384"></a><a href="#l384">384</a><td>    if (!isamatch &amp;&amp; opt_expectation) {<tr><td><a id="l385"></a><a href="#l385">385</a><td>      // If the error count changed, the match sent out an error<tr><td><a id="l386"></a><a href="#l386">386</a><td>      // message. If the error count has not changed, then<tr><td><a id="l387"></a><a href="#l387">387</a><td>      // we need to send out an error message...<tr><td><a id="l388"></a><a href="#l388">388</a><td>      if (errCount == opt_expectation.getErrorMessageCount()) {<tr><td><a id="l389"></a><a href="#l389">389</a><td>        // Use the _displayStringForValue() from assert.js<tr><td><a id="l390"></a><a href="#l390">390</a><td>        // for consistency...<tr><td><a id="l391"></a><a href="#l391">391</a><td>        if (!failureMessage) {<tr><td><a id="l392"></a><a href="#l392">392</a><td>          failureMessage = &#39;Expected: &#39; + _displayStringForValue(a) +<tr><td><a id="l393"></a><a href="#l393">393</a><td>              &#39; but was: &#39; + _displayStringForValue(b);<tr><td><a id="l394"></a><a href="#l394">394</a><td>        }<tr><td><a id="l395"></a><a href="#l395">395</a><td>        opt_expectation.addErrorMessage(failureMessage);<tr><td><a id="l396"></a><a href="#l396">396</a><td>      }<tr><td><a id="l397"></a><a href="#l397">397</a><td>    }<tr><td><a id="l398"></a><a href="#l398">398</a><td>    return isamatch;<tr><td><a id="l399"></a><a href="#l399">399</a><td>  });<tr><td><a id="l400"></a><a href="#l400">400</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/objectpropertystring.js.src.html b/docs/source/lib/goog/testing/objectpropertystring.js.src.html
new file mode 100644
index 0000000..df83670
--- /dev/null
+++ b/docs/source/lib/goog/testing/objectpropertystring.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>objectpropertystring.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/objectpropertystring.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Helper for passing property names as string literals in<tr><td><a id="l17"></a><a href="#l17">17</a><td> * compiled test code.<tr><td><a id="l18"></a><a href="#l18">18</a><td> *<tr><td><a id="l19"></a><a href="#l19">19</a><td> */<tr><td><a id="l20"></a><a href="#l20">20</a><td><tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.testing.ObjectPropertyString&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>/**<tr><td><a id="l26"></a><a href="#l26">26</a><td> * Object to pass a property name as a string literal and its containing object<tr><td><a id="l27"></a><a href="#l27">27</a><td> * when the JSCompiler is rewriting these names. This should only be used in<tr><td><a id="l28"></a><a href="#l28">28</a><td> * test code.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {Object} object The containing object.<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @param {Object|string} propertyString Property name as a string literal.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @constructor<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @final<tr><td><a id="l34"></a><a href="#l34">34</a><td> */<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.testing.ObjectPropertyString = function(object, propertyString) {<tr><td><a id="l36"></a><a href="#l36">36</a><td>  this.object_ = object;<tr><td><a id="l37"></a><a href="#l37">37</a><td>  this.propertyString_ = /** @type {string} */ (propertyString);<tr><td><a id="l38"></a><a href="#l38">38</a><td>};<tr><td><a id="l39"></a><a href="#l39">39</a><td><tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td>/**<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @type {Object}<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @private<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.testing.ObjectPropertyString.prototype.object_;<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>/**<tr><td><a id="l49"></a><a href="#l49">49</a><td> * @type {string}<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @private<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.testing.ObjectPropertyString.prototype.propertyString_;<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>/**<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @return {Object} The object.<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>goog.testing.ObjectPropertyString.prototype.getObject = function() {<tr><td><a id="l59"></a><a href="#l59">59</a><td>  return this.object_;<tr><td><a id="l60"></a><a href="#l60">60</a><td>};<tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td>/**<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @return {string} The property string.<tr><td><a id="l65"></a><a href="#l65">65</a><td> */<tr><td><a id="l66"></a><a href="#l66">66</a><td>goog.testing.ObjectPropertyString.prototype.getPropertyString = function() {<tr><td><a id="l67"></a><a href="#l67">67</a><td>  return this.propertyString_;<tr><td><a id="l68"></a><a href="#l68">68</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/propertyreplacer.js.src.html b/docs/source/lib/goog/testing/propertyreplacer.js.src.html
new file mode 100644
index 0000000..fd59747
--- /dev/null
+++ b/docs/source/lib/goog/testing/propertyreplacer.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>propertyreplacer.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/propertyreplacer.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Helper class for creating stubs for testing.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.testing.PropertyReplacer&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>/** @suppress {extraRequire} Needed for some tests to compile. */<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.testing.ObjectPropertyString&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Helper class for stubbing out variables and object properties for unit tests.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * This class can change the value of some variables before running the test<tr><td><a id="l31"></a><a href="#l31">31</a><td> * cases, and to reset them in the tearDown phase.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * See googletest.StubOutForTesting as an analogy in Python:<tr><td><a id="l33"></a><a href="#l33">33</a><td> * http://protobuf.googlecode.com/svn/trunk/python/stubout.py<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Example usage:<tr><td><a id="l36"></a><a href="#l36">36</a><td> *<tr><td><a id="l37"></a><a href="#l37">37</a><td> *     var stubs = new goog.testing.PropertyReplacer();<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> *     function setUp() {<tr><td><a id="l40"></a><a href="#l40">40</a><td> *       // Mock functions used in all test cases.<tr><td><a id="l41"></a><a href="#l41">41</a><td> *       stubs.set(Math, &#39;random&#39;, function() {<tr><td><a id="l42"></a><a href="#l42">42</a><td> *         return 4;  // Chosen by fair dice roll. Guaranteed to be random.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *       });<tr><td><a id="l44"></a><a href="#l44">44</a><td> *     }<tr><td><a id="l45"></a><a href="#l45">45</a><td> *<tr><td><a id="l46"></a><a href="#l46">46</a><td> *     function tearDown() {<tr><td><a id="l47"></a><a href="#l47">47</a><td> *       stubs.reset();<tr><td><a id="l48"></a><a href="#l48">48</a><td> *     }<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> *     function testThreeDice() {<tr><td><a id="l51"></a><a href="#l51">51</a><td> *       // Mock a constant used only in this test case.<tr><td><a id="l52"></a><a href="#l52">52</a><td> *       stubs.set(goog.global, &#39;DICE_COUNT&#39;, 3);<tr><td><a id="l53"></a><a href="#l53">53</a><td> *       assertEquals(12, rollAllDice());<tr><td><a id="l54"></a><a href="#l54">54</a><td> *     }<tr><td><a id="l55"></a><a href="#l55">55</a><td> *<tr><td><a id="l56"></a><a href="#l56">56</a><td> * Constraints on altered objects:<tr><td><a id="l57"></a><a href="#l57">57</a><td> * &lt;ul&gt;<tr><td><a id="l58"></a><a href="#l58">58</a><td> *   &lt;li&gt;DOM subclasses aren&#39;t supported.<tr><td><a id="l59"></a><a href="#l59">59</a><td> *   &lt;li&gt;The value of the objects&#39; constructor property must either be equal to<tr><td><a id="l60"></a><a href="#l60">60</a><td> *       the real constructor or kept untouched.<tr><td><a id="l61"></a><a href="#l61">61</a><td> * &lt;/ul&gt;<tr><td><a id="l62"></a><a href="#l62">62</a><td> *<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @constructor<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @final<tr><td><a id="l65"></a><a href="#l65">65</a><td> */<tr><td><a id="l66"></a><a href="#l66">66</a><td>goog.testing.PropertyReplacer = function() {<tr><td><a id="l67"></a><a href="#l67">67</a><td>  /**<tr><td><a id="l68"></a><a href="#l68">68</a><td>   * Stores the values changed by the set() method in chronological order.<tr><td><a id="l69"></a><a href="#l69">69</a><td>   * Its items are objects with 3 fields: &#39;object&#39;, &#39;key&#39;, &#39;value&#39;. The<tr><td><a id="l70"></a><a href="#l70">70</a><td>   * original value for the given key in the given object is stored under the<tr><td><a id="l71"></a><a href="#l71">71</a><td>   * &#39;value&#39; key.<tr><td><a id="l72"></a><a href="#l72">72</a><td>   * @type {Array&lt;{ object: ?, key: string, value: ? }&gt;}<tr><td><a id="l73"></a><a href="#l73">73</a><td>   * @private<tr><td><a id="l74"></a><a href="#l74">74</a><td>   */<tr><td><a id="l75"></a><a href="#l75">75</a><td>  this.original_ = [];<tr><td><a id="l76"></a><a href="#l76">76</a><td>};<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td><tr><td><a id="l79"></a><a href="#l79">79</a><td>/**<tr><td><a id="l80"></a><a href="#l80">80</a><td> * Indicates that a key didn&#39;t exist before having been set by the set() method.<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @private @const<tr><td><a id="l82"></a><a href="#l82">82</a><td> */<tr><td><a id="l83"></a><a href="#l83">83</a><td>goog.testing.PropertyReplacer.NO_SUCH_KEY_ = {};<tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td><tr><td><a id="l86"></a><a href="#l86">86</a><td>/**<tr><td><a id="l87"></a><a href="#l87">87</a><td> * Tells if the given key exists in the object. Ignores inherited fields.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {Object|Function} obj The JavaScript or native object or function<tr><td><a id="l89"></a><a href="#l89">89</a><td> *     whose key is to be checked.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @param {string} key The key to check.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @return {boolean} Whether the object has the key as own key.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @private<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td>goog.testing.PropertyReplacer.hasKey_ = function(obj, key) {<tr><td><a id="l95"></a><a href="#l95">95</a><td>  if (!(key in obj)) {<tr><td><a id="l96"></a><a href="#l96">96</a><td>    return false;<tr><td><a id="l97"></a><a href="#l97">97</a><td>  }<tr><td><a id="l98"></a><a href="#l98">98</a><td>  // hasOwnProperty is only reliable with JavaScript objects. It returns false<tr><td><a id="l99"></a><a href="#l99">99</a><td>  // for built-in DOM attributes.<tr><td><a id="l100"></a><a href="#l100">100</a><td>  if (Object.prototype.hasOwnProperty.call(obj, key)) {<tr><td><a id="l101"></a><a href="#l101">101</a><td>    return true;<tr><td><a id="l102"></a><a href="#l102">102</a><td>  }<tr><td><a id="l103"></a><a href="#l103">103</a><td>  // In all browsers except Opera obj.constructor never equals to Object if<tr><td><a id="l104"></a><a href="#l104">104</a><td>  // obj is an instance of a native class. In Opera we have to fall back on<tr><td><a id="l105"></a><a href="#l105">105</a><td>  // examining obj.toString().<tr><td><a id="l106"></a><a href="#l106">106</a><td>  if (obj.constructor == Object &amp;&amp;<tr><td><a id="l107"></a><a href="#l107">107</a><td>      (!goog.userAgent.OPERA ||<tr><td><a id="l108"></a><a href="#l108">108</a><td>          Object.prototype.toString.call(obj) == &#39;[object Object]&#39;)) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>    return false;<tr><td><a id="l110"></a><a href="#l110">110</a><td>  }<tr><td><a id="l111"></a><a href="#l111">111</a><td>  try {<tr><td><a id="l112"></a><a href="#l112">112</a><td>    // Firefox hack to consider &quot;className&quot; part of the HTML elements or<tr><td><a id="l113"></a><a href="#l113">113</a><td>    // &quot;body&quot; part of document. Although they are defined in the prototype of<tr><td><a id="l114"></a><a href="#l114">114</a><td>    // HTMLElement or Document, accessing them this way throws an exception.<tr><td><a id="l115"></a><a href="#l115">115</a><td>    // &lt;pre&gt;<tr><td><a id="l116"></a><a href="#l116">116</a><td>    //   var dummy = document.body.constructor.prototype.className<tr><td><a id="l117"></a><a href="#l117">117</a><td>    //   [Exception... &quot;Cannot modify properties of a WrappedNative&quot;]<tr><td><a id="l118"></a><a href="#l118">118</a><td>    // &lt;/pre&gt;<tr><td><a id="l119"></a><a href="#l119">119</a><td>    var dummy = obj.constructor.prototype[key];<tr><td><a id="l120"></a><a href="#l120">120</a><td>  } catch (e) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>    return true;<tr><td><a id="l122"></a><a href="#l122">122</a><td>  }<tr><td><a id="l123"></a><a href="#l123">123</a><td>  return !(key in obj.constructor.prototype);<tr><td><a id="l124"></a><a href="#l124">124</a><td>};<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td><tr><td><a id="l127"></a><a href="#l127">127</a><td>/**<tr><td><a id="l128"></a><a href="#l128">128</a><td> * Deletes a key from an object. Sets it to undefined or empty string if the<tr><td><a id="l129"></a><a href="#l129">129</a><td> * delete failed.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {Object|Function} obj The object or function to delete a key from.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @param {string} key The key to delete.<tr><td><a id="l132"></a><a href="#l132">132</a><td> * @throws {Error} In case of trying to set a read-only property<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @private<tr><td><a id="l134"></a><a href="#l134">134</a><td> */<tr><td><a id="l135"></a><a href="#l135">135</a><td>goog.testing.PropertyReplacer.deleteKey_ = function(obj, key) {<tr><td><a id="l136"></a><a href="#l136">136</a><td>  try {<tr><td><a id="l137"></a><a href="#l137">137</a><td>    delete obj[key];<tr><td><a id="l138"></a><a href="#l138">138</a><td>    // Delete has no effect for built-in properties of DOM nodes in FF.<tr><td><a id="l139"></a><a href="#l139">139</a><td>    if (!goog.testing.PropertyReplacer.hasKey_(obj, key)) {<tr><td><a id="l140"></a><a href="#l140">140</a><td>      return;<tr><td><a id="l141"></a><a href="#l141">141</a><td>    }<tr><td><a id="l142"></a><a href="#l142">142</a><td>  } catch (e) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>    // IE throws TypeError when trying to delete properties of native objects<tr><td><a id="l144"></a><a href="#l144">144</a><td>    // (e.g. DOM nodes or window), even if they have been added by JavaScript.<tr><td><a id="l145"></a><a href="#l145">145</a><td>  }<tr><td><a id="l146"></a><a href="#l146">146</a><td><tr><td><a id="l147"></a><a href="#l147">147</a><td>  obj[key] = undefined;<tr><td><a id="l148"></a><a href="#l148">148</a><td>  if (obj[key] == &#39;undefined&#39;) {<tr><td><a id="l149"></a><a href="#l149">149</a><td>    // Some properties such as className in IE are always evaluated as string<tr><td><a id="l150"></a><a href="#l150">150</a><td>    // so undefined will become &#39;undefined&#39;.<tr><td><a id="l151"></a><a href="#l151">151</a><td>    obj[key] = &#39;&#39;;<tr><td><a id="l152"></a><a href="#l152">152</a><td>  }<tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td>  if (obj[key]) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>    throw Error(&#39;Cannot delete non configurable property &quot;&#39; + key + &#39;&quot; in &#39; +<tr><td><a id="l156"></a><a href="#l156">156</a><td>                obj);<tr><td><a id="l157"></a><a href="#l157">157</a><td>  }<tr><td><a id="l158"></a><a href="#l158">158</a><td>};<tr><td><a id="l159"></a><a href="#l159">159</a><td><tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td>/**<tr><td><a id="l162"></a><a href="#l162">162</a><td> * Adds or changes a value in an object while saving its original state.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l164"></a><a href="#l164">164</a><td> *     alter. See the constraints in the class description.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {string} key The key to change the value for.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {*} value The new value to set.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @throws {Error} In case of trying to set a read-only property.<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>goog.testing.PropertyReplacer.prototype.set = function(obj, key, value) {<tr><td><a id="l170"></a><a href="#l170">170</a><td>  var origValue = goog.testing.PropertyReplacer.hasKey_(obj, key) ? obj[key] :<tr><td><a id="l171"></a><a href="#l171">171</a><td>                  goog.testing.PropertyReplacer.NO_SUCH_KEY_;<tr><td><a id="l172"></a><a href="#l172">172</a><td>  this.original_.push({object: obj, key: key, value: origValue});<tr><td><a id="l173"></a><a href="#l173">173</a><td>  obj[key] = value;<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>  // Check whether obj[key] was a read-only value and the assignment failed.<tr><td><a id="l176"></a><a href="#l176">176</a><td>  // Also, check that we&#39;re not comparing returned pixel values when &quot;value&quot;<tr><td><a id="l177"></a><a href="#l177">177</a><td>  // is 0. In other words, account for this case:<tr><td><a id="l178"></a><a href="#l178">178</a><td>  // document.body.style.margin = 0;<tr><td><a id="l179"></a><a href="#l179">179</a><td>  // document.body.style.margin; // returns &quot;0px&quot;<tr><td><a id="l180"></a><a href="#l180">180</a><td>  if (obj[key] != value &amp;&amp; (value + &#39;px&#39;) != obj[key]) {<tr><td><a id="l181"></a><a href="#l181">181</a><td>    throw Error(&#39;Cannot overwrite read-only property &quot;&#39; + key + &#39;&quot; in &#39; + obj);<tr><td><a id="l182"></a><a href="#l182">182</a><td>  }<tr><td><a id="l183"></a><a href="#l183">183</a><td>};<tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td>/**<tr><td><a id="l187"></a><a href="#l187">187</a><td> * Changes an existing value in an object to another one of the same type while<tr><td><a id="l188"></a><a href="#l188">188</a><td> * saving its original state. The advantage of {@code replace} over {@link #set}<tr><td><a id="l189"></a><a href="#l189">189</a><td> * is that {@code replace} protects against typos and erroneously passing tests<tr><td><a id="l190"></a><a href="#l190">190</a><td> * after some members have been renamed during a refactoring.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l192"></a><a href="#l192">192</a><td> *     alter. See the constraints in the class description.<tr><td><a id="l193"></a><a href="#l193">193</a><td> * @param {string} key The key to change the value for. It has to be present<tr><td><a id="l194"></a><a href="#l194">194</a><td> *     either in {@code obj} or in its prototype chain.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @param {*} value The new value to set. It has to have the same type as the<tr><td><a id="l196"></a><a href="#l196">196</a><td> *     original value. The types are compared with {@link goog.typeOf}.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @throws {Error} In case of missing key or type mismatch.<tr><td><a id="l198"></a><a href="#l198">198</a><td> */<tr><td><a id="l199"></a><a href="#l199">199</a><td>goog.testing.PropertyReplacer.prototype.replace = function(obj, key, value) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>  if (!(key in obj)) {<tr><td><a id="l201"></a><a href="#l201">201</a><td>    throw Error(&#39;Cannot replace missing property &quot;&#39; + key + &#39;&quot; in &#39; + obj);<tr><td><a id="l202"></a><a href="#l202">202</a><td>  }<tr><td><a id="l203"></a><a href="#l203">203</a><td>  if (goog.typeOf(obj[key]) != goog.typeOf(value)) {<tr><td><a id="l204"></a><a href="#l204">204</a><td>    throw Error(&#39;Cannot replace property &quot;&#39; + key + &#39;&quot; in &#39; + obj +<tr><td><a id="l205"></a><a href="#l205">205</a><td>        &#39; with a value of different type&#39;);<tr><td><a id="l206"></a><a href="#l206">206</a><td>  }<tr><td><a id="l207"></a><a href="#l207">207</a><td>  this.set(obj, key, value);<tr><td><a id="l208"></a><a href="#l208">208</a><td>};<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Builds an object structure for the provided namespace path.  Doesn&#39;t<tr><td><a id="l213"></a><a href="#l213">213</a><td> * overwrite those prefixes of the path that are already objects or functions.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @param {string} path The path to create or alter, e.g. &#39;goog.ui.Menu&#39;.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @param {*} value The value to set.<tr><td><a id="l216"></a><a href="#l216">216</a><td> */<tr><td><a id="l217"></a><a href="#l217">217</a><td>goog.testing.PropertyReplacer.prototype.setPath = function(path, value) {<tr><td><a id="l218"></a><a href="#l218">218</a><td>  var parts = path.split(&#39;.&#39;);<tr><td><a id="l219"></a><a href="#l219">219</a><td>  var obj = goog.global;<tr><td><a id="l220"></a><a href="#l220">220</a><td>  for (var i = 0; i &lt; parts.length - 1; i++) {<tr><td><a id="l221"></a><a href="#l221">221</a><td>    var part = parts[i];<tr><td><a id="l222"></a><a href="#l222">222</a><td>    if (part == &#39;prototype&#39; &amp;&amp; !obj[part]) {<tr><td><a id="l223"></a><a href="#l223">223</a><td>      throw Error(&#39;Cannot set the prototype of &#39; + parts.slice(0, i).join(&#39;.&#39;));<tr><td><a id="l224"></a><a href="#l224">224</a><td>    }<tr><td><a id="l225"></a><a href="#l225">225</a><td>    if (!goog.isObject(obj[part]) &amp;&amp; !goog.isFunction(obj[part])) {<tr><td><a id="l226"></a><a href="#l226">226</a><td>      this.set(obj, part, {});<tr><td><a id="l227"></a><a href="#l227">227</a><td>    }<tr><td><a id="l228"></a><a href="#l228">228</a><td>    obj = obj[part];<tr><td><a id="l229"></a><a href="#l229">229</a><td>  }<tr><td><a id="l230"></a><a href="#l230">230</a><td>  this.set(obj, parts[parts.length - 1], value);<tr><td><a id="l231"></a><a href="#l231">231</a><td>};<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>/**<tr><td><a id="l235"></a><a href="#l235">235</a><td> * Deletes the key from the object while saving its original value.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @param {Object|Function} obj The JavaScript or native object or function to<tr><td><a id="l237"></a><a href="#l237">237</a><td> *     alter. See the constraints in the class description.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @param {string} key The key to delete.<tr><td><a id="l239"></a><a href="#l239">239</a><td> */<tr><td><a id="l240"></a><a href="#l240">240</a><td>goog.testing.PropertyReplacer.prototype.remove = function(obj, key) {<tr><td><a id="l241"></a><a href="#l241">241</a><td>  if (goog.testing.PropertyReplacer.hasKey_(obj, key)) {<tr><td><a id="l242"></a><a href="#l242">242</a><td>    this.original_.push({object: obj, key: key, value: obj[key]});<tr><td><a id="l243"></a><a href="#l243">243</a><td>    goog.testing.PropertyReplacer.deleteKey_(obj, key);<tr><td><a id="l244"></a><a href="#l244">244</a><td>  }<tr><td><a id="l245"></a><a href="#l245">245</a><td>};<tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td>/**<tr><td><a id="l249"></a><a href="#l249">249</a><td> * Resets all changes made by goog.testing.PropertyReplacer.prototype.set.<tr><td><a id="l250"></a><a href="#l250">250</a><td> */<tr><td><a id="l251"></a><a href="#l251">251</a><td>goog.testing.PropertyReplacer.prototype.reset = function() {<tr><td><a id="l252"></a><a href="#l252">252</a><td>  for (var i = this.original_.length - 1; i &gt;= 0; i--) {<tr><td><a id="l253"></a><a href="#l253">253</a><td>    var original = this.original_[i];<tr><td><a id="l254"></a><a href="#l254">254</a><td>    if (original.value == goog.testing.PropertyReplacer.NO_SUCH_KEY_) {<tr><td><a id="l255"></a><a href="#l255">255</a><td>      goog.testing.PropertyReplacer.deleteKey_(original.object, original.key);<tr><td><a id="l256"></a><a href="#l256">256</a><td>    } else {<tr><td><a id="l257"></a><a href="#l257">257</a><td>      original.object[original.key] = original.value;<tr><td><a id="l258"></a><a href="#l258">258</a><td>    }<tr><td><a id="l259"></a><a href="#l259">259</a><td>    delete this.original_[i];<tr><td><a id="l260"></a><a href="#l260">260</a><td>  }<tr><td><a id="l261"></a><a href="#l261">261</a><td>  this.original_.length = 0;<tr><td><a id="l262"></a><a href="#l262">262</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/recordfunction.js.src.html b/docs/source/lib/goog/testing/recordfunction.js.src.html
new file mode 100644
index 0000000..2a596df
--- /dev/null
+++ b/docs/source/lib/goog/testing/recordfunction.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>recordfunction.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/recordfunction.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2010 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Helper class for recording the calls of a function.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * Example:<tr><td><a id="l19"></a><a href="#l19">19</a><td> * &lt;pre&gt;<tr><td><a id="l20"></a><a href="#l20">20</a><td> * var stubs = new goog.testing.PropertyReplacer();<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * function tearDown() {<tr><td><a id="l23"></a><a href="#l23">23</a><td> *   stubs.reset();<tr><td><a id="l24"></a><a href="#l24">24</a><td> * }<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * function testShuffle() {<tr><td><a id="l27"></a><a href="#l27">27</a><td> *   stubs.set(Math, &#39;random&#39;, goog.testing.recordFunction(Math.random));<tr><td><a id="l28"></a><a href="#l28">28</a><td> *   var arr = shuffle([1, 2, 3, 4, 5]);<tr><td><a id="l29"></a><a href="#l29">29</a><td> *   assertSameElements([1, 2, 3, 4, 5], arr);<tr><td><a id="l30"></a><a href="#l30">30</a><td> *   assertEquals(4, Math.random.getCallCount());<tr><td><a id="l31"></a><a href="#l31">31</a><td> * }<tr><td><a id="l32"></a><a href="#l32">32</a><td> *<tr><td><a id="l33"></a><a href="#l33">33</a><td> * function testOpenDialog() {<tr><td><a id="l34"></a><a href="#l34">34</a><td> *   stubs.set(goog.ui, &#39;Dialog&#39;,<tr><td><a id="l35"></a><a href="#l35">35</a><td> *       goog.testing.recordConstructor(goog.ui.Dialog));<tr><td><a id="l36"></a><a href="#l36">36</a><td> *   openConfirmDialog();<tr><td><a id="l37"></a><a href="#l37">37</a><td> *   var lastDialogInstance = goog.ui.Dialog.getLastCall().getThis();<tr><td><a id="l38"></a><a href="#l38">38</a><td> *   assertEquals(&#39;confirm&#39;, lastDialogInstance.getTitle());<tr><td><a id="l39"></a><a href="#l39">39</a><td> * }<tr><td><a id="l40"></a><a href="#l40">40</a><td> * &lt;/pre&gt;<tr><td><a id="l41"></a><a href="#l41">41</a><td> *<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.provide(&#39;goog.testing.FunctionCall&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.provide(&#39;goog.testing.recordConstructor&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.provide(&#39;goog.testing.recordFunction&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td><tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.require(&#39;goog.testing.asserts&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>/**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * Wraps the function into another one which calls the inner function and<tr><td><a id="l53"></a><a href="#l53">53</a><td> * records its calls. The recorded function will have 3 static methods:<tr><td><a id="l54"></a><a href="#l54">54</a><td> * {@code getCallCount}, {@code getCalls} and {@code getLastCall} but won&#39;t<tr><td><a id="l55"></a><a href="#l55">55</a><td> * inherit the original function&#39;s prototype and static fields.<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @param {!Function=} opt_f The function to wrap and record. Defaults to<tr><td><a id="l58"></a><a href="#l58">58</a><td> *     {@link goog.nullFunction}.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @return {!Function} The wrapped function.<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>goog.testing.recordFunction = function(opt_f) {<tr><td><a id="l62"></a><a href="#l62">62</a><td>  var f = opt_f || goog.nullFunction;<tr><td><a id="l63"></a><a href="#l63">63</a><td>  var calls = [];<tr><td><a id="l64"></a><a href="#l64">64</a><td><tr><td><a id="l65"></a><a href="#l65">65</a><td>  function recordedFunction() {<tr><td><a id="l66"></a><a href="#l66">66</a><td>    try {<tr><td><a id="l67"></a><a href="#l67">67</a><td>      var ret = f.apply(this, arguments);<tr><td><a id="l68"></a><a href="#l68">68</a><td>      calls.push(new goog.testing.FunctionCall(f, this, arguments, ret, null));<tr><td><a id="l69"></a><a href="#l69">69</a><td>      return ret;<tr><td><a id="l70"></a><a href="#l70">70</a><td>    } catch (err) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>      calls.push(new goog.testing.FunctionCall(f, this, arguments, undefined,<tr><td><a id="l72"></a><a href="#l72">72</a><td>          err));<tr><td><a id="l73"></a><a href="#l73">73</a><td>      throw err;<tr><td><a id="l74"></a><a href="#l74">74</a><td>    }<tr><td><a id="l75"></a><a href="#l75">75</a><td>  }<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>  /**<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * @return {number} Total number of calls.<tr><td><a id="l79"></a><a href="#l79">79</a><td>   */<tr><td><a id="l80"></a><a href="#l80">80</a><td>  recordedFunction.getCallCount = function() {<tr><td><a id="l81"></a><a href="#l81">81</a><td>    return calls.length;<tr><td><a id="l82"></a><a href="#l82">82</a><td>  };<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td>  /**<tr><td><a id="l85"></a><a href="#l85">85</a><td>   * Asserts that the function was called {@code expected} times.<tr><td><a id="l86"></a><a href="#l86">86</a><td>   * @param {number} expected The expected number of calls.<tr><td><a id="l87"></a><a href="#l87">87</a><td>   */<tr><td><a id="l88"></a><a href="#l88">88</a><td>  recordedFunction.assertCallCount = function(expected) {<tr><td><a id="l89"></a><a href="#l89">89</a><td>    var actual = calls.length;<tr><td><a id="l90"></a><a href="#l90">90</a><td>    assertEquals(<tr><td><a id="l91"></a><a href="#l91">91</a><td>        &#39;Expected &#39; + expected + &#39; call(s), but was &#39; + actual + &#39;.&#39;,<tr><td><a id="l92"></a><a href="#l92">92</a><td>        expected, actual);<tr><td><a id="l93"></a><a href="#l93">93</a><td>  };<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td>  /**<tr><td><a id="l96"></a><a href="#l96">96</a><td>   * @return {!Array&lt;!goog.testing.FunctionCall&gt;} All calls of the recorded<tr><td><a id="l97"></a><a href="#l97">97</a><td>   *     function.<tr><td><a id="l98"></a><a href="#l98">98</a><td>   */<tr><td><a id="l99"></a><a href="#l99">99</a><td>  recordedFunction.getCalls = function() {<tr><td><a id="l100"></a><a href="#l100">100</a><td>    return calls;<tr><td><a id="l101"></a><a href="#l101">101</a><td>  };<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>  /**<tr><td><a id="l105"></a><a href="#l105">105</a><td>   * @return {goog.testing.FunctionCall} Last call of the recorded function or<tr><td><a id="l106"></a><a href="#l106">106</a><td>   *     null if it hasn&#39;t been called.<tr><td><a id="l107"></a><a href="#l107">107</a><td>   */<tr><td><a id="l108"></a><a href="#l108">108</a><td>  recordedFunction.getLastCall = function() {<tr><td><a id="l109"></a><a href="#l109">109</a><td>    return calls[calls.length - 1] || null;<tr><td><a id="l110"></a><a href="#l110">110</a><td>  };<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>  /**<tr><td><a id="l113"></a><a href="#l113">113</a><td>   * Returns and removes the last call of the recorded function.<tr><td><a id="l114"></a><a href="#l114">114</a><td>   * @return {goog.testing.FunctionCall} Last call of the recorded function or<tr><td><a id="l115"></a><a href="#l115">115</a><td>   *     null if it hasn&#39;t been called.<tr><td><a id="l116"></a><a href="#l116">116</a><td>   */<tr><td><a id="l117"></a><a href="#l117">117</a><td>  recordedFunction.popLastCall = function() {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    return calls.pop() || null;<tr><td><a id="l119"></a><a href="#l119">119</a><td>  };<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>  /**<tr><td><a id="l122"></a><a href="#l122">122</a><td>   * Resets the recorded function and removes all calls.<tr><td><a id="l123"></a><a href="#l123">123</a><td>   */<tr><td><a id="l124"></a><a href="#l124">124</a><td>  recordedFunction.reset = function() {<tr><td><a id="l125"></a><a href="#l125">125</a><td>    calls.length = 0;<tr><td><a id="l126"></a><a href="#l126">126</a><td>  };<tr><td><a id="l127"></a><a href="#l127">127</a><td><tr><td><a id="l128"></a><a href="#l128">128</a><td>  return recordedFunction;<tr><td><a id="l129"></a><a href="#l129">129</a><td>};<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * Same as {@link goog.testing.recordFunction} but the recorded function will<tr><td><a id="l134"></a><a href="#l134">134</a><td> * have the same prototype and static fields as the original one. It can be<tr><td><a id="l135"></a><a href="#l135">135</a><td> * used with constructors.<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @param {!Function} ctor The function to wrap and record.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @return {!Function} The wrapped function.<tr><td><a id="l139"></a><a href="#l139">139</a><td> */<tr><td><a id="l140"></a><a href="#l140">140</a><td>goog.testing.recordConstructor = function(ctor) {<tr><td><a id="l141"></a><a href="#l141">141</a><td>  var recordedConstructor = goog.testing.recordFunction(ctor);<tr><td><a id="l142"></a><a href="#l142">142</a><td>  recordedConstructor.prototype = ctor.prototype;<tr><td><a id="l143"></a><a href="#l143">143</a><td>  goog.mixin(recordedConstructor, ctor);<tr><td><a id="l144"></a><a href="#l144">144</a><td>  return recordedConstructor;<tr><td><a id="l145"></a><a href="#l145">145</a><td>};<tr><td><a id="l146"></a><a href="#l146">146</a><td><tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>/**<tr><td><a id="l150"></a><a href="#l150">150</a><td> * Struct for a single function call.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {!Function} func The called function.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @param {!Object} thisContext {@code this} context of called function.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @param {!Arguments} args Arguments of the called function.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {*} ret Return value of the function or undefined in case of error.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @param {*} error The error thrown by the function or null if none.<tr><td><a id="l156"></a><a href="#l156">156</a><td> * @constructor<tr><td><a id="l157"></a><a href="#l157">157</a><td> */<tr><td><a id="l158"></a><a href="#l158">158</a><td>goog.testing.FunctionCall = function(func, thisContext, args, ret, error) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>  this.function_ = func;<tr><td><a id="l160"></a><a href="#l160">160</a><td>  this.thisContext_ = thisContext;<tr><td><a id="l161"></a><a href="#l161">161</a><td>  this.arguments_ = Array.prototype.slice.call(args);<tr><td><a id="l162"></a><a href="#l162">162</a><td>  this.returnValue_ = ret;<tr><td><a id="l163"></a><a href="#l163">163</a><td>  this.error_ = error;<tr><td><a id="l164"></a><a href="#l164">164</a><td>};<tr><td><a id="l165"></a><a href="#l165">165</a><td><tr><td><a id="l166"></a><a href="#l166">166</a><td><tr><td><a id="l167"></a><a href="#l167">167</a><td>/**<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {!Function} The called function.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>goog.testing.FunctionCall.prototype.getFunction = function() {<tr><td><a id="l171"></a><a href="#l171">171</a><td>  return this.function_;<tr><td><a id="l172"></a><a href="#l172">172</a><td>};<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @return {!Object} {@code this} context of called function. It is the same as<tr><td><a id="l177"></a><a href="#l177">177</a><td> *     the created object if the function is a constructor.<tr><td><a id="l178"></a><a href="#l178">178</a><td> */<tr><td><a id="l179"></a><a href="#l179">179</a><td>goog.testing.FunctionCall.prototype.getThis = function() {<tr><td><a id="l180"></a><a href="#l180">180</a><td>  return this.thisContext_;<tr><td><a id="l181"></a><a href="#l181">181</a><td>};<tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td>/**<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @return {!Array&lt;?&gt;} Arguments of the called function.<tr><td><a id="l186"></a><a href="#l186">186</a><td> */<tr><td><a id="l187"></a><a href="#l187">187</a><td>goog.testing.FunctionCall.prototype.getArguments = function() {<tr><td><a id="l188"></a><a href="#l188">188</a><td>  return this.arguments_;<tr><td><a id="l189"></a><a href="#l189">189</a><td>};<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td>/**<tr><td><a id="l193"></a><a href="#l193">193</a><td> * Returns the nth argument of the called function.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @param {number} index 0-based index of the argument.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @return {*} The argument value or undefined if there is no such argument.<tr><td><a id="l196"></a><a href="#l196">196</a><td> */<tr><td><a id="l197"></a><a href="#l197">197</a><td>goog.testing.FunctionCall.prototype.getArgument = function(index) {<tr><td><a id="l198"></a><a href="#l198">198</a><td>  return this.arguments_[index];<tr><td><a id="l199"></a><a href="#l199">199</a><td>};<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td><tr><td><a id="l202"></a><a href="#l202">202</a><td>/**<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @return {*} Return value of the function or undefined in case of error.<tr><td><a id="l204"></a><a href="#l204">204</a><td> */<tr><td><a id="l205"></a><a href="#l205">205</a><td>goog.testing.FunctionCall.prototype.getReturnValue = function() {<tr><td><a id="l206"></a><a href="#l206">206</a><td>  return this.returnValue_;<tr><td><a id="l207"></a><a href="#l207">207</a><td>};<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td>/**<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @return {*} The error thrown by the function or null if none.<tr><td><a id="l212"></a><a href="#l212">212</a><td> */<tr><td><a id="l213"></a><a href="#l213">213</a><td>goog.testing.FunctionCall.prototype.getError = function() {<tr><td><a id="l214"></a><a href="#l214">214</a><td>  return this.error_;<tr><td><a id="l215"></a><a href="#l215">215</a><td>};</table></div></article><nav><h3><a href="../../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/stacktrace.js.src.html b/docs/source/lib/goog/testing/stacktrace.js.src.html
new file mode 100644
index 0000000..5fdefd0
--- /dev/null
+++ b/docs/source/lib/goog/testing/stacktrace.js.src.html
@@ -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>stacktrace.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/stacktrace.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Tools for parsing and pretty printing error stack traces.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.testing.stacktrace&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.provide(&#39;goog.testing.stacktrace.Frame&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td><tr><td><a id="l25"></a><a href="#l25">25</a><td>/**<tr><td><a id="l26"></a><a href="#l26">26</a><td> * Class representing one stack frame.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {string} context Context object, empty in case of global functions or<tr><td><a id="l28"></a><a href="#l28">28</a><td> *     if the browser doesn&#39;t provide this information.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @param {string} name Function name, empty in case of anonymous functions.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {string} alias Alias of the function if available. For example the<tr><td><a id="l31"></a><a href="#l31">31</a><td> *     function name will be &#39;c&#39; and the alias will be &#39;b&#39; if the function is<tr><td><a id="l32"></a><a href="#l32">32</a><td> *     defined as &lt;code&gt;a.b = function c() {};&lt;/code&gt;.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @param {string} args Arguments of the function in parentheses if available.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {string} path File path or URL including line number and optionally<tr><td><a id="l35"></a><a href="#l35">35</a><td> *     column number separated by colons.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @constructor<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @final<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.testing.stacktrace.Frame = function(context, name, alias, args, path) {<tr><td><a id="l40"></a><a href="#l40">40</a><td>  this.context_ = context;<tr><td><a id="l41"></a><a href="#l41">41</a><td>  this.name_ = name;<tr><td><a id="l42"></a><a href="#l42">42</a><td>  this.alias_ = alias;<tr><td><a id="l43"></a><a href="#l43">43</a><td>  this.args_ = args;<tr><td><a id="l44"></a><a href="#l44">44</a><td>  this.path_ = path;<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> * @return {string} The function name or empty string if the function is<tr><td><a id="l50"></a><a href="#l50">50</a><td> *     anonymous and the object field which it&#39;s assigned to is unknown.<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>goog.testing.stacktrace.Frame.prototype.getName = function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td>  return this.name_;<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>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @return {boolean} Whether the stack frame contains an anonymous function.<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.testing.stacktrace.Frame.prototype.isAnonymous = function() {<tr><td><a id="l61"></a><a href="#l61">61</a><td>  return !this.name_ || this.context_ == &#39;[object Object]&#39;;<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><tr><td><a id="l65"></a><a href="#l65">65</a><td>/**<tr><td><a id="l66"></a><a href="#l66">66</a><td> * Brings one frame of the stack trace into a common format across browsers.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {string} Pretty printed stack frame.<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.testing.stacktrace.Frame.prototype.toCanonicalString = function() {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  var htmlEscape = goog.testing.stacktrace.htmlEscape_;<tr><td><a id="l71"></a><a href="#l71">71</a><td>  var deobfuscate = goog.testing.stacktrace.maybeDeobfuscateFunctionName_;<tr><td><a id="l72"></a><a href="#l72">72</a><td><tr><td><a id="l73"></a><a href="#l73">73</a><td>  var canonical = [<tr><td><a id="l74"></a><a href="#l74">74</a><td>    this.context_ ? htmlEscape(this.context_) + &#39;.&#39; : &#39;&#39;,<tr><td><a id="l75"></a><a href="#l75">75</a><td>    this.name_ ? htmlEscape(deobfuscate(this.name_)) : &#39;anonymous&#39;,<tr><td><a id="l76"></a><a href="#l76">76</a><td>    htmlEscape(this.args_),<tr><td><a id="l77"></a><a href="#l77">77</a><td>    this.alias_ ? &#39; [as &#39; + htmlEscape(deobfuscate(this.alias_)) + &#39;]&#39; : &#39;&#39;<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>  if (this.path_) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>    canonical.push(&#39; at &#39;);<tr><td><a id="l82"></a><a href="#l82">82</a><td>    canonical.push(htmlEscape(this.path_));<tr><td><a id="l83"></a><a href="#l83">83</a><td>  }<tr><td><a id="l84"></a><a href="#l84">84</a><td>  return canonical.join(&#39;&#39;);<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><tr><td><a id="l88"></a><a href="#l88">88</a><td>/**<tr><td><a id="l89"></a><a href="#l89">89</a><td> * Maximum number of steps while the call chain is followed.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @private {number}<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @const<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>goog.testing.stacktrace.MAX_DEPTH_ = 20;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td>/**<tr><td><a id="l97"></a><a href="#l97">97</a><td> * Maximum length of a string that can be matched with a RegExp on<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Firefox 3x. Exceeding this approximate length will cause string.match<tr><td><a id="l99"></a><a href="#l99">99</a><td> * to exceed Firefox&#39;s stack quota. This situation can be encountered<tr><td><a id="l100"></a><a href="#l100">100</a><td> * when goog.globalEval is invoked with a long argument; such as<tr><td><a id="l101"></a><a href="#l101">101</a><td> * when loading a module.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @private {number}<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @const<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.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_ = 500000;<tr><td><a id="l106"></a><a href="#l106">106</a><td><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> * RegExp pattern for JavaScript identifiers. We don&#39;t support Unicode<tr><td><a id="l110"></a><a href="#l110">110</a><td> * identifiers defined in ECMAScript v3.<tr><td><a id="l111"></a><a href="#l111">111</a><td> * @private {string}<tr><td><a id="l112"></a><a href="#l112">112</a><td> * @const<tr><td><a id="l113"></a><a href="#l113">113</a><td> */<tr><td><a id="l114"></a><a href="#l114">114</a><td>goog.testing.stacktrace.IDENTIFIER_PATTERN_ = &#39;[a-zA-Z_$][\\w$]*&#39;;<tr><td><a id="l115"></a><a href="#l115">115</a><td><tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>/**<tr><td><a id="l118"></a><a href="#l118">118</a><td> * RegExp pattern for function name alias in the V8 stack trace.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @private {string}<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @const<tr><td><a id="l121"></a><a href="#l121">121</a><td> */<tr><td><a id="l122"></a><a href="#l122">122</a><td>goog.testing.stacktrace.V8_ALIAS_PATTERN_ =<tr><td><a id="l123"></a><a href="#l123">123</a><td>    &#39;(?: \\[as (&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)\\])?&#39;;<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> * RegExp pattern for the context of a function call in a V8 stack trace.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * Creates an optional submatch for the namespace identifier including the<tr><td><a id="l129"></a><a href="#l129">129</a><td> * &quot;new&quot; keyword for constructor calls (e.g. &quot;new foo.Bar&quot;).<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @private {string}<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @const<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>goog.testing.stacktrace.V8_CONTEXT_PATTERN_ =<tr><td><a id="l134"></a><a href="#l134">134</a><td>    &#39;(?:((?:new )?(?:\\[object Object\\]|&#39; +<tr><td><a id="l135"></a><a href="#l135">135</a><td>    goog.testing.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l136"></a><a href="#l136">136</a><td>    &#39;(?:\\.&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*))\\.)?&#39;;<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * RegExp pattern for function names and constructor calls in the V8 stack<tr><td><a id="l141"></a><a href="#l141">141</a><td> * trace.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @private {string}<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @const<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.testing.stacktrace.V8_FUNCTION_NAME_PATTERN_ =<tr><td><a id="l146"></a><a href="#l146">146</a><td>    &#39;(?:new )?(?:&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l147"></a><a href="#l147">147</a><td>    &#39;|&lt;anonymous&gt;)&#39;;<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>/**<tr><td><a id="l151"></a><a href="#l151">151</a><td> * RegExp pattern for function call in the V8 stack trace. Creates 3 submatches<tr><td><a id="l152"></a><a href="#l152">152</a><td> * with context object (optional), function name and function alias (optional).<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @private {string}<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @const<tr><td><a id="l155"></a><a href="#l155">155</a><td> */<tr><td><a id="l156"></a><a href="#l156">156</a><td>goog.testing.stacktrace.V8_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l157"></a><a href="#l157">157</a><td>    &#39; &#39; + goog.testing.stacktrace.V8_CONTEXT_PATTERN_ +<tr><td><a id="l158"></a><a href="#l158">158</a><td>    &#39;(&#39; + goog.testing.stacktrace.V8_FUNCTION_NAME_PATTERN_ + &#39;)&#39; +<tr><td><a id="l159"></a><a href="#l159">159</a><td>    goog.testing.stacktrace.V8_ALIAS_PATTERN_;<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * RegExp pattern for an URL + position inside the file.<tr><td><a id="l164"></a><a href="#l164">164</a><td> * @private {string}<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @const<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.testing.stacktrace.URL_PATTERN_ =<tr><td><a id="l168"></a><a href="#l168">168</a><td>    &#39;((?:http|https|file)://[^\\s)]+|javascript:.*)&#39;;<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> * RegExp pattern for an URL + line number + column number in V8.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * The URL is either in submatch 1 or submatch 2.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @private {string}<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @const<tr><td><a id="l176"></a><a href="#l176">176</a><td> */<tr><td><a id="l177"></a><a href="#l177">177</a><td>goog.testing.stacktrace.CHROME_URL_PATTERN_ = &#39; (?:&#39; +<tr><td><a id="l178"></a><a href="#l178">178</a><td>    &#39;\\(unknown source\\)&#39; + &#39;|&#39; +<tr><td><a id="l179"></a><a href="#l179">179</a><td>    &#39;\\(native\\)&#39; + &#39;|&#39; +<tr><td><a id="l180"></a><a href="#l180">180</a><td>    &#39;\\((.+)\\)|(.+))&#39;;<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Regular expression for parsing one stack frame in V8. For more information<tr><td><a id="l185"></a><a href="#l185">185</a><td> * on V8 stack frame formats, see<tr><td><a id="l186"></a><a href="#l186">186</a><td> * https://code.google.com/p/v8/wiki/JavaScriptStackTraceApi.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @private {!RegExp}<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @const<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_ = new RegExp(&#39;^    at&#39; +<tr><td><a id="l191"></a><a href="#l191">191</a><td>    &#39;(?:&#39; + goog.testing.stacktrace.V8_FUNCTION_CALL_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l192"></a><a href="#l192">192</a><td>    goog.testing.stacktrace.CHROME_URL_PATTERN_ + &#39;$&#39;);<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>/**<tr><td><a id="l196"></a><a href="#l196">196</a><td> * RegExp pattern for function call in the Firefox stack trace.<tr><td><a id="l197"></a><a href="#l197">197</a><td> * Creates 2 submatches with function name (optional) and arguments.<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @private {string}<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @const<tr><td><a id="l200"></a><a href="#l200">200</a><td> */<tr><td><a id="l201"></a><a href="#l201">201</a><td>goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l202"></a><a href="#l202">202</a><td>    &#39;(&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l203"></a><a href="#l203">203</a><td>    &#39;(\\(.*\\))?@&#39;;<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * Regular expression for parsing one stack frame in Firefox.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @private {!RegExp}<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @const<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&#39; +<tr><td><a id="l212"></a><a href="#l212">212</a><td>    goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l213"></a><a href="#l213">213</a><td>    &#39;(?::0|&#39; + goog.testing.stacktrace.URL_PATTERN_ + &#39;)$&#39;);<tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td>/**<tr><td><a id="l217"></a><a href="#l217">217</a><td> * RegExp pattern for an anonymous function call in an Opera stack frame.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * Creates 2 (optional) submatches: the context object and function name.<tr><td><a id="l219"></a><a href="#l219">219</a><td> * @private {string}<tr><td><a id="l220"></a><a href="#l220">220</a><td> * @const<tr><td><a id="l221"></a><a href="#l221">221</a><td> */<tr><td><a id="l222"></a><a href="#l222">222</a><td>goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ =<tr><td><a id="l223"></a><a href="#l223">223</a><td>    &#39;&lt;anonymous function(?:\\: &#39; +<tr><td><a id="l224"></a><a href="#l224">224</a><td>    &#39;(?:(&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l225"></a><a href="#l225">225</a><td>    &#39;(?:\\.&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)\\.)?&#39; +<tr><td><a id="l226"></a><a href="#l226">226</a><td>    &#39;(&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;))?&gt;&#39;;<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>/**<tr><td><a id="l230"></a><a href="#l230">230</a><td> * RegExp pattern for a function call in an Opera stack frame.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * Creates 4 (optional) submatches: the function name (if not anonymous),<tr><td><a id="l232"></a><a href="#l232">232</a><td> * the aliased context object and function name (if anonymous), and the<tr><td><a id="l233"></a><a href="#l233">233</a><td> * function call arguments.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @private {string}<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @const<tr><td><a id="l236"></a><a href="#l236">236</a><td> */<tr><td><a id="l237"></a><a href="#l237">237</a><td>goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l238"></a><a href="#l238">238</a><td>    &#39;(?:(?:(&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)|&#39; +<tr><td><a id="l239"></a><a href="#l239">239</a><td>    goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ +<tr><td><a id="l240"></a><a href="#l240">240</a><td>    &#39;)(\\(.*\\)))?@&#39;;<tr><td><a id="l241"></a><a href="#l241">241</a><td><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> * Regular expression for parsing on stack frame in Opera 11.68 - 12.17.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * Newer versions of Opera use V8 and stack frames should match against<tr><td><a id="l246"></a><a href="#l246">246</a><td> * goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @private {!RegExp}<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @const<tr><td><a id="l249"></a><a href="#l249">249</a><td> */<tr><td><a id="l250"></a><a href="#l250">250</a><td>goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&#39; +<tr><td><a id="l251"></a><a href="#l251">251</a><td>    goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l252"></a><a href="#l252">252</a><td>    goog.testing.stacktrace.URL_PATTERN_ + &#39;?$&#39;);<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * Regular expression for finding the function name in its source.<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @private {!RegExp}<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @const<tr><td><a id="l259"></a><a href="#l259">259</a><td> */<tr><td><a id="l260"></a><a href="#l260">260</a><td>goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_ = new RegExp(<tr><td><a id="l261"></a><a href="#l261">261</a><td>    &#39;^function (&#39; + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;)&#39;);<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>/**<tr><td><a id="l265"></a><a href="#l265">265</a><td> * RegExp pattern for function call in a IE stack trace. This expression allows<tr><td><a id="l266"></a><a href="#l266">266</a><td> * for identifiers like &#39;Anonymous function&#39;, &#39;eval code&#39;, and &#39;Global code&#39;.<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @private {string}<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @const<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.testing.stacktrace.IE_FUNCTION_CALL_PATTERN_ = &#39;(&#39; +<tr><td><a id="l271"></a><a href="#l271">271</a><td>    goog.testing.stacktrace.IDENTIFIER_PATTERN_ + &#39;(?:\\s+\\w+)*)&#39;;<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> * Regular expression for parsing a stack frame in IE.<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @private {!RegExp}<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @const<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>goog.testing.stacktrace.IE_STACK_FRAME_REGEXP_ = new RegExp(&#39;^   at &#39; +<tr><td><a id="l280"></a><a href="#l280">280</a><td>    goog.testing.stacktrace.IE_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l281"></a><a href="#l281">281</a><td>    &#39;\\s*\\((eval code:[^)]*|&#39; + goog.testing.stacktrace.URL_PATTERN_ +<tr><td><a id="l282"></a><a href="#l282">282</a><td>    &#39;)\\)?$&#39;);<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td>/**<tr><td><a id="l286"></a><a href="#l286">286</a><td> * Creates a stack trace by following the call chain. Based on<tr><td><a id="l287"></a><a href="#l287">287</a><td> * {@link goog.debug.getStacktrace}.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @return {!Array&lt;!goog.testing.stacktrace.Frame&gt;} Stack frames.<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @private<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @suppress {es5Strict}<tr><td><a id="l291"></a><a href="#l291">291</a><td> */<tr><td><a id="l292"></a><a href="#l292">292</a><td>goog.testing.stacktrace.followCallChain_ = function() {<tr><td><a id="l293"></a><a href="#l293">293</a><td>  var frames = [];<tr><td><a id="l294"></a><a href="#l294">294</a><td>  var fn = arguments.callee.caller;<tr><td><a id="l295"></a><a href="#l295">295</a><td>  var depth = 0;<tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td>  while (fn &amp;&amp; depth &lt; goog.testing.stacktrace.MAX_DEPTH_) {<tr><td><a id="l298"></a><a href="#l298">298</a><td>    var fnString = Function.prototype.toString.call(fn);<tr><td><a id="l299"></a><a href="#l299">299</a><td>    var match = fnString.match(goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_);<tr><td><a id="l300"></a><a href="#l300">300</a><td>    var functionName = match ? match[1] : &#39;&#39;;<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td>    var argsBuilder = [&#39;(&#39;];<tr><td><a id="l303"></a><a href="#l303">303</a><td>    if (fn.arguments) {<tr><td><a id="l304"></a><a href="#l304">304</a><td>      for (var i = 0; i &lt; fn.arguments.length; i++) {<tr><td><a id="l305"></a><a href="#l305">305</a><td>        var arg = fn.arguments[i];<tr><td><a id="l306"></a><a href="#l306">306</a><td>        if (i &gt; 0) {<tr><td><a id="l307"></a><a href="#l307">307</a><td>          argsBuilder.push(&#39;, &#39;);<tr><td><a id="l308"></a><a href="#l308">308</a><td>        }<tr><td><a id="l309"></a><a href="#l309">309</a><td>        if (goog.isString(arg)) {<tr><td><a id="l310"></a><a href="#l310">310</a><td>          argsBuilder.push(&#39;&quot;&#39;, arg, &#39;&quot;&#39;);<tr><td><a id="l311"></a><a href="#l311">311</a><td>        } else {<tr><td><a id="l312"></a><a href="#l312">312</a><td>          // Some args are mocks, and we don&#39;t want to fail from them not having<tr><td><a id="l313"></a><a href="#l313">313</a><td>          // expected a call to toString, so instead insert a static string.<tr><td><a id="l314"></a><a href="#l314">314</a><td>          if (arg &amp;&amp; arg[&#39;$replay&#39;]) {<tr><td><a id="l315"></a><a href="#l315">315</a><td>            argsBuilder.push(&#39;goog.testing.Mock&#39;);<tr><td><a id="l316"></a><a href="#l316">316</a><td>          } else {<tr><td><a id="l317"></a><a href="#l317">317</a><td>            argsBuilder.push(String(arg));<tr><td><a id="l318"></a><a href="#l318">318</a><td>          }<tr><td><a id="l319"></a><a href="#l319">319</a><td>        }<tr><td><a id="l320"></a><a href="#l320">320</a><td>      }<tr><td><a id="l321"></a><a href="#l321">321</a><td>    } else {<tr><td><a id="l322"></a><a href="#l322">322</a><td>      // Opera 10 doesn&#39;t know the arguments of native functions.<tr><td><a id="l323"></a><a href="#l323">323</a><td>      argsBuilder.push(&#39;unknown&#39;);<tr><td><a id="l324"></a><a href="#l324">324</a><td>    }<tr><td><a id="l325"></a><a href="#l325">325</a><td>    argsBuilder.push(&#39;)&#39;);<tr><td><a id="l326"></a><a href="#l326">326</a><td>    var args = argsBuilder.join(&#39;&#39;);<tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>    frames.push(new goog.testing.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, args,<tr><td><a id="l329"></a><a href="#l329">329</a><td>        &#39;&#39;));<tr><td><a id="l330"></a><a href="#l330">330</a><td><tr><td><a id="l331"></a><a href="#l331">331</a><td>    /** @preserveTry */<tr><td><a id="l332"></a><a href="#l332">332</a><td>    try {<tr><td><a id="l333"></a><a href="#l333">333</a><td>      fn = fn.caller;<tr><td><a id="l334"></a><a href="#l334">334</a><td>    } catch (e) {<tr><td><a id="l335"></a><a href="#l335">335</a><td>      break;<tr><td><a id="l336"></a><a href="#l336">336</a><td>    }<tr><td><a id="l337"></a><a href="#l337">337</a><td>    depth++;<tr><td><a id="l338"></a><a href="#l338">338</a><td>  }<tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>  return frames;<tr><td><a id="l341"></a><a href="#l341">341</a><td>};<tr><td><a id="l342"></a><a href="#l342">342</a><td><tr><td><a id="l343"></a><a href="#l343">343</a><td><tr><td><a id="l344"></a><a href="#l344">344</a><td>/**<tr><td><a id="l345"></a><a href="#l345">345</a><td> * Parses one stack frame.<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a id="l347"></a><a href="#l347">347</a><td> * @return {goog.testing.stacktrace.Frame} Stack frame object or null if the<tr><td><a id="l348"></a><a href="#l348">348</a><td> *     parsing failed.<tr><td><a id="l349"></a><a href="#l349">349</a><td> * @private<tr><td><a id="l350"></a><a href="#l350">350</a><td> */<tr><td><a id="l351"></a><a href="#l351">351</a><td>goog.testing.stacktrace.parseStackFrame_ = function(frameStr) {<tr><td><a id="l352"></a><a href="#l352">352</a><td>  // This match includes newer versions of Opera (15+).<tr><td><a id="l353"></a><a href="#l353">353</a><td>  var m = frameStr.match(goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_);<tr><td><a id="l354"></a><a href="#l354">354</a><td>  if (m) {<tr><td><a id="l355"></a><a href="#l355">355</a><td>    return new goog.testing.stacktrace.Frame(m[1] || &#39;&#39;, m[2] || &#39;&#39;, m[3] || &#39;&#39;,<tr><td><a id="l356"></a><a href="#l356">356</a><td>        &#39;&#39;, m[4] || m[5] || m[6] || &#39;&#39;);<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>  if (frameStr.length &gt;<tr><td><a id="l360"></a><a href="#l360">360</a><td>      goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_) {<tr><td><a id="l361"></a><a href="#l361">361</a><td>    return goog.testing.stacktrace.parseLongFirefoxFrame_(frameStr);<tr><td><a id="l362"></a><a href="#l362">362</a><td>  }<tr><td><a id="l363"></a><a href="#l363">363</a><td><tr><td><a id="l364"></a><a href="#l364">364</a><td>  m = frameStr.match(goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_);<tr><td><a id="l365"></a><a href="#l365">365</a><td>  if (m) {<tr><td><a id="l366"></a><a href="#l366">366</a><td>    return new goog.testing.stacktrace.Frame(&#39;&#39;, m[1] || &#39;&#39;, &#39;&#39;, m[2] || &#39;&#39;,<tr><td><a id="l367"></a><a href="#l367">367</a><td>        m[3] || &#39;&#39;);<tr><td><a id="l368"></a><a href="#l368">368</a><td>  }<tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td>  // Match against Presto Opera 11.68 - 12.17.<tr><td><a id="l371"></a><a href="#l371">371</a><td>  m = frameStr.match(goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_);<tr><td><a id="l372"></a><a href="#l372">372</a><td>  if (m) {<tr><td><a id="l373"></a><a href="#l373">373</a><td>    return new goog.testing.stacktrace.Frame(m[2] || &#39;&#39;, m[1] || m[3] || &#39;&#39;,<tr><td><a id="l374"></a><a href="#l374">374</a><td>        &#39;&#39;, m[4] || &#39;&#39;, m[5] || &#39;&#39;);<tr><td><a id="l375"></a><a href="#l375">375</a><td>  }<tr><td><a id="l376"></a><a href="#l376">376</a><td><tr><td><a id="l377"></a><a href="#l377">377</a><td>  m = frameStr.match(goog.testing.stacktrace.IE_STACK_FRAME_REGEXP_);<tr><td><a id="l378"></a><a href="#l378">378</a><td>  if (m) {<tr><td><a id="l379"></a><a href="#l379">379</a><td>    return new goog.testing.stacktrace.Frame(&#39;&#39;, m[1] || &#39;&#39;, &#39;&#39;, &#39;&#39;,<tr><td><a id="l380"></a><a href="#l380">380</a><td>        m[2] || &#39;&#39;);<tr><td><a id="l381"></a><a href="#l381">381</a><td>  }<tr><td><a id="l382"></a><a href="#l382">382</a><td><tr><td><a id="l383"></a><a href="#l383">383</a><td>  return null;<tr><td><a id="l384"></a><a href="#l384">384</a><td>};<tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td><tr><td><a id="l387"></a><a href="#l387">387</a><td>/**<tr><td><a id="l388"></a><a href="#l388">388</a><td> * Parses a long firefox stack frame.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a id="l390"></a><a href="#l390">390</a><td> * @return {!goog.testing.stacktrace.Frame} Stack frame object.<tr><td><a id="l391"></a><a href="#l391">391</a><td> * @private<tr><td><a id="l392"></a><a href="#l392">392</a><td> */<tr><td><a id="l393"></a><a href="#l393">393</a><td>goog.testing.stacktrace.parseLongFirefoxFrame_ = function(frameStr) {<tr><td><a id="l394"></a><a href="#l394">394</a><td>  var firstParen = frameStr.indexOf(&#39;(&#39;);<tr><td><a id="l395"></a><a href="#l395">395</a><td>  var lastAmpersand = frameStr.lastIndexOf(&#39;@&#39;);<tr><td><a id="l396"></a><a href="#l396">396</a><td>  var lastColon = frameStr.lastIndexOf(&#39;:&#39;);<tr><td><a id="l397"></a><a href="#l397">397</a><td>  var functionName = &#39;&#39;;<tr><td><a id="l398"></a><a href="#l398">398</a><td>  if ((firstParen &gt;= 0) &amp;&amp; (firstParen &lt; lastAmpersand)) {<tr><td><a id="l399"></a><a href="#l399">399</a><td>    functionName = frameStr.substring(0, firstParen);<tr><td><a id="l400"></a><a href="#l400">400</a><td>  }<tr><td><a id="l401"></a><a href="#l401">401</a><td>  var loc = &#39;&#39;;<tr><td><a id="l402"></a><a href="#l402">402</a><td>  if ((lastAmpersand &gt;= 0) &amp;&amp; (lastAmpersand + 1 &lt; lastColon)) {<tr><td><a id="l403"></a><a href="#l403">403</a><td>    loc = frameStr.substring(lastAmpersand + 1);<tr><td><a id="l404"></a><a href="#l404">404</a><td>  }<tr><td><a id="l405"></a><a href="#l405">405</a><td>  var args = &#39;&#39;;<tr><td><a id="l406"></a><a href="#l406">406</a><td>  if ((firstParen &gt;= 0 &amp;&amp; lastAmpersand &gt; 0) &amp;&amp;<tr><td><a id="l407"></a><a href="#l407">407</a><td>      (firstParen &lt; lastAmpersand)) {<tr><td><a id="l408"></a><a href="#l408">408</a><td>    args = frameStr.substring(firstParen, lastAmpersand);<tr><td><a id="l409"></a><a href="#l409">409</a><td>  }<tr><td><a id="l410"></a><a href="#l410">410</a><td>  return new goog.testing.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, args, loc);<tr><td><a id="l411"></a><a href="#l411">411</a><td>};<tr><td><a id="l412"></a><a href="#l412">412</a><td><tr><td><a id="l413"></a><a href="#l413">413</a><td><tr><td><a id="l414"></a><a href="#l414">414</a><td>/**<tr><td><a id="l415"></a><a href="#l415">415</a><td> * Function to deobfuscate function names.<tr><td><a id="l416"></a><a href="#l416">416</a><td> * @type {function(string): string}<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @private<tr><td><a id="l418"></a><a href="#l418">418</a><td> */<tr><td><a id="l419"></a><a href="#l419">419</a><td>goog.testing.stacktrace.deobfuscateFunctionName_;<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> * Sets function to deobfuscate function names.<tr><td><a id="l424"></a><a href="#l424">424</a><td> * @param {function(string): string} fn function to deobfuscate function names.<tr><td><a id="l425"></a><a href="#l425">425</a><td> */<tr><td><a id="l426"></a><a href="#l426">426</a><td>goog.testing.stacktrace.setDeobfuscateFunctionName = function(fn) {<tr><td><a id="l427"></a><a href="#l427">427</a><td>  goog.testing.stacktrace.deobfuscateFunctionName_ = fn;<tr><td><a id="l428"></a><a href="#l428">428</a><td>};<tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td>/**<tr><td><a id="l432"></a><a href="#l432">432</a><td> * Deobfuscates a compiled function name with the function passed to<tr><td><a id="l433"></a><a href="#l433">433</a><td> * {@link #setDeobfuscateFunctionName}. Returns the original function name if<tr><td><a id="l434"></a><a href="#l434">434</a><td> * the deobfuscator hasn&#39;t been set.<tr><td><a id="l435"></a><a href="#l435">435</a><td> * @param {string} name The function name to deobfuscate.<tr><td><a id="l436"></a><a href="#l436">436</a><td> * @return {string} The deobfuscated function name.<tr><td><a id="l437"></a><a href="#l437">437</a><td> * @private<tr><td><a id="l438"></a><a href="#l438">438</a><td> */<tr><td><a id="l439"></a><a href="#l439">439</a><td>goog.testing.stacktrace.maybeDeobfuscateFunctionName_ = function(name) {<tr><td><a id="l440"></a><a href="#l440">440</a><td>  return goog.testing.stacktrace.deobfuscateFunctionName_ ?<tr><td><a id="l441"></a><a href="#l441">441</a><td>      goog.testing.stacktrace.deobfuscateFunctionName_(name) : name;<tr><td><a id="l442"></a><a href="#l442">442</a><td>};<tr><td><a id="l443"></a><a href="#l443">443</a><td><tr><td><a id="l444"></a><a href="#l444">444</a><td><tr><td><a id="l445"></a><a href="#l445">445</a><td>/**<tr><td><a id="l446"></a><a href="#l446">446</a><td> * Escapes the special character in HTML.<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {string} text Plain text.<tr><td><a id="l448"></a><a href="#l448">448</a><td> * @return {string} Escaped text.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @private<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.testing.stacktrace.htmlEscape_ = function(text) {<tr><td><a id="l452"></a><a href="#l452">452</a><td>  return text.replace(/&amp;/g, &#39;&amp;amp;&#39;).<tr><td><a id="l453"></a><a href="#l453">453</a><td>             replace(/&lt;/g, &#39;&amp;lt;&#39;).<tr><td><a id="l454"></a><a href="#l454">454</a><td>             replace(/&gt;/g, &#39;&amp;gt;&#39;).<tr><td><a id="l455"></a><a href="#l455">455</a><td>             replace(/&quot;/g, &#39;&amp;quot;&#39;);<tr><td><a id="l456"></a><a href="#l456">456</a><td>};<tr><td><a id="l457"></a><a href="#l457">457</a><td><tr><td><a id="l458"></a><a href="#l458">458</a><td><tr><td><a id="l459"></a><a href="#l459">459</a><td>/**<tr><td><a id="l460"></a><a href="#l460">460</a><td> * Converts the stack frames into canonical format. Chops the beginning and the<tr><td><a id="l461"></a><a href="#l461">461</a><td> * end of it which come from the testing environment, not from the test itself.<tr><td><a id="l462"></a><a href="#l462">462</a><td> * @param {!Array&lt;goog.testing.stacktrace.Frame&gt;} frames The frames.<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @return {string} Canonical, pretty printed stack trace.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @private<tr><td><a id="l465"></a><a href="#l465">465</a><td> */<tr><td><a id="l466"></a><a href="#l466">466</a><td>goog.testing.stacktrace.framesToString_ = function(frames) {<tr><td><a id="l467"></a><a href="#l467">467</a><td>  // Removes the anonymous calls from the end of the stack trace (they come<tr><td><a id="l468"></a><a href="#l468">468</a><td>  // from testrunner.js, testcase.js and asserts.js), so the stack trace will<tr><td><a id="l469"></a><a href="#l469">469</a><td>  // end with the test... method.<tr><td><a id="l470"></a><a href="#l470">470</a><td>  var lastIndex = frames.length - 1;<tr><td><a id="l471"></a><a href="#l471">471</a><td>  while (frames[lastIndex] &amp;&amp; frames[lastIndex].isAnonymous()) {<tr><td><a id="l472"></a><a href="#l472">472</a><td>    lastIndex--;<tr><td><a id="l473"></a><a href="#l473">473</a><td>  }<tr><td><a id="l474"></a><a href="#l474">474</a><td><tr><td><a id="l475"></a><a href="#l475">475</a><td>  // Removes the beginning of the stack trace until the call of the private<tr><td><a id="l476"></a><a href="#l476">476</a><td>  // _assert function (inclusive), so the stack trace will begin with a public<tr><td><a id="l477"></a><a href="#l477">477</a><td>  // asserter. Does nothing if _assert is not present in the stack trace.<tr><td><a id="l478"></a><a href="#l478">478</a><td>  var privateAssertIndex = -1;<tr><td><a id="l479"></a><a href="#l479">479</a><td>  for (var i = 0; i &lt; frames.length; i++) {<tr><td><a id="l480"></a><a href="#l480">480</a><td>    if (frames[i] &amp;&amp; frames[i].getName() == &#39;_assert&#39;) {<tr><td><a id="l481"></a><a href="#l481">481</a><td>      privateAssertIndex = i;<tr><td><a id="l482"></a><a href="#l482">482</a><td>      break;<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>  var canonical = [];<tr><td><a id="l487"></a><a href="#l487">487</a><td>  for (var i = privateAssertIndex + 1; i &lt;= lastIndex; i++) {<tr><td><a id="l488"></a><a href="#l488">488</a><td>    canonical.push(&#39;&gt; &#39;);<tr><td><a id="l489"></a><a href="#l489">489</a><td>    if (frames[i]) {<tr><td><a id="l490"></a><a href="#l490">490</a><td>      canonical.push(frames[i].toCanonicalString());<tr><td><a id="l491"></a><a href="#l491">491</a><td>    } else {<tr><td><a id="l492"></a><a href="#l492">492</a><td>      canonical.push(&#39;(unknown)&#39;);<tr><td><a id="l493"></a><a href="#l493">493</a><td>    }<tr><td><a id="l494"></a><a href="#l494">494</a><td>    canonical.push(&#39;\n&#39;);<tr><td><a id="l495"></a><a href="#l495">495</a><td>  }<tr><td><a id="l496"></a><a href="#l496">496</a><td>  return canonical.join(&#39;&#39;);<tr><td><a id="l497"></a><a href="#l497">497</a><td>};<tr><td><a id="l498"></a><a href="#l498">498</a><td><tr><td><a id="l499"></a><a href="#l499">499</a><td><tr><td><a id="l500"></a><a href="#l500">500</a><td>/**<tr><td><a id="l501"></a><a href="#l501">501</a><td> * Parses the browser&#39;s native stack trace.<tr><td><a id="l502"></a><a href="#l502">502</a><td> * @param {string} stack Stack trace.<tr><td><a id="l503"></a><a href="#l503">503</a><td> * @return {!Array&lt;goog.testing.stacktrace.Frame&gt;} Stack frames. The<tr><td><a id="l504"></a><a href="#l504">504</a><td> *     unrecognized frames will be nulled out.<tr><td><a id="l505"></a><a href="#l505">505</a><td> * @private<tr><td><a id="l506"></a><a href="#l506">506</a><td> */<tr><td><a id="l507"></a><a href="#l507">507</a><td>goog.testing.stacktrace.parse_ = function(stack) {<tr><td><a id="l508"></a><a href="#l508">508</a><td>  var lines = stack.replace(/\s*$/, &#39;&#39;).split(&#39;\n&#39;);<tr><td><a id="l509"></a><a href="#l509">509</a><td>  var frames = [];<tr><td><a id="l510"></a><a href="#l510">510</a><td>  for (var i = 0; i &lt; lines.length; i++) {<tr><td><a id="l511"></a><a href="#l511">511</a><td>    frames.push(goog.testing.stacktrace.parseStackFrame_(lines[i]));<tr><td><a id="l512"></a><a href="#l512">512</a><td>  }<tr><td><a id="l513"></a><a href="#l513">513</a><td>  return frames;<tr><td><a id="l514"></a><a href="#l514">514</a><td>};<tr><td><a id="l515"></a><a href="#l515">515</a><td><tr><td><a id="l516"></a><a href="#l516">516</a><td><tr><td><a id="l517"></a><a href="#l517">517</a><td>/**<tr><td><a id="l518"></a><a href="#l518">518</a><td> * Brings the stack trace into a common format across browsers.<tr><td><a id="l519"></a><a href="#l519">519</a><td> * @param {string} stack Browser-specific stack trace.<tr><td><a id="l520"></a><a href="#l520">520</a><td> * @return {string} Same stack trace in common format.<tr><td><a id="l521"></a><a href="#l521">521</a><td> */<tr><td><a id="l522"></a><a href="#l522">522</a><td>goog.testing.stacktrace.canonicalize = function(stack) {<tr><td><a id="l523"></a><a href="#l523">523</a><td>  var frames = goog.testing.stacktrace.parse_(stack);<tr><td><a id="l524"></a><a href="#l524">524</a><td>  return goog.testing.stacktrace.framesToString_(frames);<tr><td><a id="l525"></a><a href="#l525">525</a><td>};<tr><td><a id="l526"></a><a href="#l526">526</a><td><tr><td><a id="l527"></a><a href="#l527">527</a><td><tr><td><a id="l528"></a><a href="#l528">528</a><td>/**<tr><td><a id="l529"></a><a href="#l529">529</a><td> * Returns the native stack trace.<tr><td><a id="l530"></a><a href="#l530">530</a><td> * @return {string|!Array&lt;!CallSite&gt;}<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @private<tr><td><a id="l532"></a><a href="#l532">532</a><td> */<tr><td><a id="l533"></a><a href="#l533">533</a><td>goog.testing.stacktrace.getNativeStack_ = function() {<tr><td><a id="l534"></a><a href="#l534">534</a><td>  var tmpError = new Error();<tr><td><a id="l535"></a><a href="#l535">535</a><td>  if (tmpError.stack) {<tr><td><a id="l536"></a><a href="#l536">536</a><td>    return tmpError.stack;<tr><td><a id="l537"></a><a href="#l537">537</a><td>  }<tr><td><a id="l538"></a><a href="#l538">538</a><td><tr><td><a id="l539"></a><a href="#l539">539</a><td>  // IE10 will only create a stack trace when the Error is thrown.<tr><td><a id="l540"></a><a href="#l540">540</a><td>  // We use null.x() to throw an exception because the closure compiler may<tr><td><a id="l541"></a><a href="#l541">541</a><td>  // replace &quot;throw&quot; with a function call in an attempt to minimize the binary<tr><td><a id="l542"></a><a href="#l542">542</a><td>  // size, which in turn has the side effect of adding an unwanted stack frame.<tr><td><a id="l543"></a><a href="#l543">543</a><td>  try {<tr><td><a id="l544"></a><a href="#l544">544</a><td>    null.x();<tr><td><a id="l545"></a><a href="#l545">545</a><td>  } catch (e) {<tr><td><a id="l546"></a><a href="#l546">546</a><td>    return e.stack;<tr><td><a id="l547"></a><a href="#l547">547</a><td>  }<tr><td><a id="l548"></a><a href="#l548">548</a><td>  return &#39;&#39;;<tr><td><a id="l549"></a><a href="#l549">549</a><td>};<tr><td><a id="l550"></a><a href="#l550">550</a><td><tr><td><a id="l551"></a><a href="#l551">551</a><td><tr><td><a id="l552"></a><a href="#l552">552</a><td>/**<tr><td><a id="l553"></a><a href="#l553">553</a><td> * Gets the native stack trace if available otherwise follows the call chain.<tr><td><a id="l554"></a><a href="#l554">554</a><td> * @return {string} The stack trace in canonical format.<tr><td><a id="l555"></a><a href="#l555">555</a><td> */<tr><td><a id="l556"></a><a href="#l556">556</a><td>goog.testing.stacktrace.get = function() {<tr><td><a id="l557"></a><a href="#l557">557</a><td>  var stack = goog.testing.stacktrace.getNativeStack_();<tr><td><a id="l558"></a><a href="#l558">558</a><td>  var frames;<tr><td><a id="l559"></a><a href="#l559">559</a><td>  if (!stack) {<tr><td><a id="l560"></a><a href="#l560">560</a><td>    frames = goog.testing.stacktrace.followCallChain_();<tr><td><a id="l561"></a><a href="#l561">561</a><td>  } else if (goog.isArray(stack)) {<tr><td><a id="l562"></a><a href="#l562">562</a><td>    frames = goog.testing.stacktrace.callSitesToFrames_(stack);<tr><td><a id="l563"></a><a href="#l563">563</a><td>  } else {<tr><td><a id="l564"></a><a href="#l564">564</a><td>    frames = goog.testing.stacktrace.parse_(stack);<tr><td><a id="l565"></a><a href="#l565">565</a><td>  }<tr><td><a id="l566"></a><a href="#l566">566</a><td>  return goog.testing.stacktrace.framesToString_(frames);<tr><td><a id="l567"></a><a href="#l567">567</a><td>};<tr><td><a id="l568"></a><a href="#l568">568</a><td><tr><td><a id="l569"></a><a href="#l569">569</a><td><tr><td><a id="l570"></a><a href="#l570">570</a><td>/**<tr><td><a id="l571"></a><a href="#l571">571</a><td> * Converts an array of CallSite (elements of a stack trace in V8) to an array<tr><td><a id="l572"></a><a href="#l572">572</a><td> * of Frames.<tr><td><a id="l573"></a><a href="#l573">573</a><td> * @param {!Array&lt;!CallSite&gt;} stack The stack as an array of CallSites.<tr><td><a id="l574"></a><a href="#l574">574</a><td> * @return {!Array&lt;!goog.testing.stacktrace.Frame&gt;} The stack as an array of<tr><td><a id="l575"></a><a href="#l575">575</a><td> *     Frames.<tr><td><a id="l576"></a><a href="#l576">576</a><td> * @private<tr><td><a id="l577"></a><a href="#l577">577</a><td> */<tr><td><a id="l578"></a><a href="#l578">578</a><td>goog.testing.stacktrace.callSitesToFrames_ = function(stack) {<tr><td><a id="l579"></a><a href="#l579">579</a><td>  var frames = [];<tr><td><a id="l580"></a><a href="#l580">580</a><td>  for (var i = 0; i &lt; stack.length; i++) {<tr><td><a id="l581"></a><a href="#l581">581</a><td>    var callSite = stack[i];<tr><td><a id="l582"></a><a href="#l582">582</a><td>    var functionName = callSite.getFunctionName() || &#39;unknown&#39;;<tr><td><a id="l583"></a><a href="#l583">583</a><td>    var fileName = callSite.getFileName();<tr><td><a id="l584"></a><a href="#l584">584</a><td>    var path = fileName ? fileName + &#39;:&#39; + callSite.getLineNumber() + &#39;:&#39; +<tr><td><a id="l585"></a><a href="#l585">585</a><td>        callSite.getColumnNumber() : &#39;unknown&#39;;<tr><td><a id="l586"></a><a href="#l586">586</a><td>    frames.push(<tr><td><a id="l587"></a><a href="#l587">587</a><td>        new goog.testing.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, &#39;&#39;, path));<tr><td><a id="l588"></a><a href="#l588">588</a><td>  }<tr><td><a id="l589"></a><a href="#l589">589</a><td>  return frames;<tr><td><a id="l590"></a><a href="#l590">590</a><td>};<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>goog.exportSymbol(&#39;setDeobfuscateFunctionName&#39;,<tr><td><a id="l594"></a><a href="#l594">594</a><td>    goog.testing.stacktrace.setDeobfuscateFunctionName);</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/strictmock.js.src.html b/docs/source/lib/goog/testing/strictmock.js.src.html
new file mode 100644
index 0000000..755a5ca
--- /dev/null
+++ b/docs/source/lib/goog/testing/strictmock.js.src.html
@@ -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>strictmock.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/strictmock.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview This file defines a strict mock implementation.<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>goog.provide(&#39;goog.testing.StrictMock&#39;);<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.require(&#39;goog.array&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.testing.Mock&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * This is a mock that verifies that methods are called in the order that they<tr><td><a id="l28"></a><a href="#l28">28</a><td> * are specified during the recording phase. Since it verifies order, it<tr><td><a id="l29"></a><a href="#l29">29</a><td> * follows &#39;fail fast&#39; semantics. If it detects a deviation from the<tr><td><a id="l30"></a><a href="#l30">30</a><td> * expectations, it will throw an exception and not wait for verify to be<tr><td><a id="l31"></a><a href="#l31">31</a><td> * called.<tr><td><a id="l32"></a><a href="#l32">32</a><td> * @param {Object|Function} objectToMock The object that should be mocked, or<tr><td><a id="l33"></a><a href="#l33">33</a><td> *    the constructor of an object to mock.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {boolean=} opt_mockStaticMethods An optional argument denoting that<tr><td><a id="l35"></a><a href="#l35">35</a><td> *     a mock should be constructed from the static functions of a class.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @param {boolean=} opt_createProxy An optional argument denoting that<tr><td><a id="l37"></a><a href="#l37">37</a><td> *     a proxy for the target mock should be created.<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> * @extends {goog.testing.Mock}<tr><td><a id="l40"></a><a href="#l40">40</a><td> * @final<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.testing.StrictMock = function(objectToMock, opt_mockStaticMethods,<tr><td><a id="l43"></a><a href="#l43">43</a><td>    opt_createProxy) {<tr><td><a id="l44"></a><a href="#l44">44</a><td>  goog.testing.Mock.call(this, objectToMock, opt_mockStaticMethods,<tr><td><a id="l45"></a><a href="#l45">45</a><td>      opt_createProxy);<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>   * An array of MockExpectations.<tr><td><a id="l49"></a><a href="#l49">49</a><td>   * @type {Array&lt;goog.testing.MockExpectation&gt;}<tr><td><a id="l50"></a><a href="#l50">50</a><td>   * @private<tr><td><a id="l51"></a><a href="#l51">51</a><td>   */<tr><td><a id="l52"></a><a href="#l52">52</a><td>  this.$expectations_ = [];<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.inherits(goog.testing.StrictMock, goog.testing.Mock);<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>/** @override */<tr><td><a id="l58"></a><a href="#l58">58</a><td>goog.testing.StrictMock.prototype.$recordExpectation = function() {<tr><td><a id="l59"></a><a href="#l59">59</a><td>  this.$expectations_.push(this.$pendingExpectation);<tr><td><a id="l60"></a><a href="#l60">60</a><td>};<tr><td><a id="l61"></a><a href="#l61">61</a><td><tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td>/** @override */<tr><td><a id="l64"></a><a href="#l64">64</a><td>goog.testing.StrictMock.prototype.$recordCall = function(name, args) {<tr><td><a id="l65"></a><a href="#l65">65</a><td>  if (this.$expectations_.length == 0) {<tr><td><a id="l66"></a><a href="#l66">66</a><td>    this.$throwCallException(name, args);<tr><td><a id="l67"></a><a href="#l67">67</a><td>  }<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>  // If the current expectation has a different name, make sure it was called<tr><td><a id="l70"></a><a href="#l70">70</a><td>  // enough and then discard it. We&#39;re through with it.<tr><td><a id="l71"></a><a href="#l71">71</a><td>  var currentExpectation = this.$expectations_[0];<tr><td><a id="l72"></a><a href="#l72">72</a><td>  while (!this.$verifyCall(currentExpectation, name, args)) {<tr><td><a id="l73"></a><a href="#l73">73</a><td><tr><td><a id="l74"></a><a href="#l74">74</a><td>    // This might be an item which has passed its min, and we can now<tr><td><a id="l75"></a><a href="#l75">75</a><td>    // look past it, or it might be below its min and generate an error.<tr><td><a id="l76"></a><a href="#l76">76</a><td>    if (currentExpectation.actualCalls &lt; currentExpectation.minCalls) {<tr><td><a id="l77"></a><a href="#l77">77</a><td>      this.$throwCallException(name, args, currentExpectation);<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>    this.$expectations_.shift();<tr><td><a id="l81"></a><a href="#l81">81</a><td>    if (this.$expectations_.length &lt; 1) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>      // Nothing left, but this may be a failed attempt to call the previous<tr><td><a id="l83"></a><a href="#l83">83</a><td>      // item on the list, which may have been between its min and max.<tr><td><a id="l84"></a><a href="#l84">84</a><td>      this.$throwCallException(name, args, currentExpectation);<tr><td><a id="l85"></a><a href="#l85">85</a><td>    }<tr><td><a id="l86"></a><a href="#l86">86</a><td>    currentExpectation = this.$expectations_[0];<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>  if (currentExpectation.maxCalls == 0) {<tr><td><a id="l90"></a><a href="#l90">90</a><td>    this.$throwCallException(name, args);<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>  currentExpectation.actualCalls++;<tr><td><a id="l94"></a><a href="#l94">94</a><td>  // If we hit the max number of calls for this expectation, we&#39;re finished<tr><td><a id="l95"></a><a href="#l95">95</a><td>  // with it.<tr><td><a id="l96"></a><a href="#l96">96</a><td>  if (currentExpectation.actualCalls == currentExpectation.maxCalls) {<tr><td><a id="l97"></a><a href="#l97">97</a><td>    this.$expectations_.shift();<tr><td><a id="l98"></a><a href="#l98">98</a><td>  }<tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>  return this.$do(currentExpectation, args);<tr><td><a id="l101"></a><a href="#l101">101</a><td>};<tr><td><a id="l102"></a><a href="#l102">102</a><td><tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>/** @override */<tr><td><a id="l105"></a><a href="#l105">105</a><td>goog.testing.StrictMock.prototype.$reset = function() {<tr><td><a id="l106"></a><a href="#l106">106</a><td>  goog.testing.StrictMock.superClass_.$reset.call(this);<tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>  goog.array.clear(this.$expectations_);<tr><td><a id="l109"></a><a href="#l109">109</a><td>};<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>/** @override */<tr><td><a id="l113"></a><a href="#l113">113</a><td>goog.testing.StrictMock.prototype.$verify = function() {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  goog.testing.StrictMock.superClass_.$verify.call(this);<tr><td><a id="l115"></a><a href="#l115">115</a><td><tr><td><a id="l116"></a><a href="#l116">116</a><td>  while (this.$expectations_.length &gt; 0) {<tr><td><a id="l117"></a><a href="#l117">117</a><td>    var expectation = this.$expectations_[0];<tr><td><a id="l118"></a><a href="#l118">118</a><td>    if (expectation.actualCalls &lt; expectation.minCalls) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>      this.$throwException(&#39;Missing a call to &#39; + expectation.name +<tr><td><a id="l120"></a><a href="#l120">120</a><td>          &#39;\nExpected: &#39; + expectation.minCalls + &#39; but was: &#39; +<tr><td><a id="l121"></a><a href="#l121">121</a><td>          expectation.actualCalls);<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>    } else {<tr><td><a id="l124"></a><a href="#l124">124</a><td>      // Don&#39;t need to check max, that&#39;s handled when the call is made<tr><td><a id="l125"></a><a href="#l125">125</a><td>      this.$expectations_.shift();<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>};<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/testcase.js.src.html b/docs/source/lib/goog/testing/testcase.js.src.html
new file mode 100644
index 0000000..3e72364
--- /dev/null
+++ b/docs/source/lib/goog/testing/testcase.js.src.html
@@ -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>testcase.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/testcase.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview A class representing a set of test functions to be run.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * Testing code should not have dependencies outside of goog.testing so as to<tr><td><a id="l19"></a><a href="#l19">19</a><td> * reduce the chance of masking missing dependencies.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * This file does not compile correctly with --collapse_properties. Use<tr><td><a id="l22"></a><a href="#l22">22</a><td> * --property_renaming=ALL_UNQUOTED instead.<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>goog.provide(&#39;goog.testing.TestCase&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;goog.testing.TestCase.Error&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.provide(&#39;goog.testing.TestCase.Order&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.provide(&#39;goog.testing.TestCase.Result&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.provide(&#39;goog.testing.TestCase.Test&#39;);<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>goog.require(&#39;goog.Promise&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.Thenable&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.dom.TagName&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.testing.asserts&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.testing.stacktrace&#39;);<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><tr><td><a id="l43"></a><a href="#l43">43</a><td>/**<tr><td><a id="l44"></a><a href="#l44">44</a><td> * A class representing a JsUnit test case.  A TestCase is made up of a number<tr><td><a id="l45"></a><a href="#l45">45</a><td> * of test functions which can be run.  Individual test cases can override the<tr><td><a id="l46"></a><a href="#l46">46</a><td> * following functions to set up their test environment:<tr><td><a id="l47"></a><a href="#l47">47</a><td> *   - runTests - completely override the test&#39;s runner<tr><td><a id="l48"></a><a href="#l48">48</a><td> *   - setUpPage - called before any of the test functions are run<tr><td><a id="l49"></a><a href="#l49">49</a><td> *   - tearDownPage - called after all tests are finished<tr><td><a id="l50"></a><a href="#l50">50</a><td> *   - setUp - called before each of the test functions<tr><td><a id="l51"></a><a href="#l51">51</a><td> *   - tearDown - called after each of the test functions<tr><td><a id="l52"></a><a href="#l52">52</a><td> *   - shouldRunTests - called before a test run, all tests are skipped if it<tr><td><a id="l53"></a><a href="#l53">53</a><td> *                      returns false.  Can be used to disable tests on browsers<tr><td><a id="l54"></a><a href="#l54">54</a><td> *                      where they aren&#39;t expected to pass.<tr><td><a id="l55"></a><a href="#l55">55</a><td> *<tr><td><a id="l56"></a><a href="#l56">56</a><td> * Use {@link #autoDiscoverLifecycle} and {@link #autoDiscoverTests}<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {string=} opt_name The name of the test case, defaults to<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     &#39;Untitled Test Case&#39;.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @constructor<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.testing.TestCase = function(opt_name) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  /**<tr><td><a id="l64"></a><a href="#l64">64</a><td>   * A name for the test case.<tr><td><a id="l65"></a><a href="#l65">65</a><td>   * @type {string}<tr><td><a id="l66"></a><a href="#l66">66</a><td>   * @private<tr><td><a id="l67"></a><a href="#l67">67</a><td>   */<tr><td><a id="l68"></a><a href="#l68">68</a><td>  this.name_ = opt_name || &#39;Untitled Test Case&#39;;<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>  /**<tr><td><a id="l71"></a><a href="#l71">71</a><td>   * Array of test functions that can be executed.<tr><td><a id="l72"></a><a href="#l72">72</a><td>   * @type {!Array&lt;!goog.testing.TestCase.Test&gt;}<tr><td><a id="l73"></a><a href="#l73">73</a><td>   * @private<tr><td><a id="l74"></a><a href="#l74">74</a><td>   */<tr><td><a id="l75"></a><a href="#l75">75</a><td>  this.tests_ = [];<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>  /**<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * Set of test names and/or indices to execute, or null if all tests should<tr><td><a id="l79"></a><a href="#l79">79</a><td>   * be executed.<tr><td><a id="l80"></a><a href="#l80">80</a><td>   *<tr><td><a id="l81"></a><a href="#l81">81</a><td>   * Indices are included to allow automation tools to run a subset of the<tr><td><a id="l82"></a><a href="#l82">82</a><td>   * tests without knowing the exact contents of the test file.<tr><td><a id="l83"></a><a href="#l83">83</a><td>   *<tr><td><a id="l84"></a><a href="#l84">84</a><td>   * Indices should only be used with SORTED ordering.<tr><td><a id="l85"></a><a href="#l85">85</a><td>   *<tr><td><a id="l86"></a><a href="#l86">86</a><td>   * Example valid values:<tr><td><a id="l87"></a><a href="#l87">87</a><td>   * &lt;ul&gt;<tr><td><a id="l88"></a><a href="#l88">88</a><td>   * &lt;li&gt;[testName]<tr><td><a id="l89"></a><a href="#l89">89</a><td>   * &lt;li&gt;[testName1, testName2]<tr><td><a id="l90"></a><a href="#l90">90</a><td>   * &lt;li&gt;[2] - will run the 3rd test in the order specified<tr><td><a id="l91"></a><a href="#l91">91</a><td>   * &lt;li&gt;[1,3,5]<tr><td><a id="l92"></a><a href="#l92">92</a><td>   * &lt;li&gt;[testName1, testName2, 3, 5] - will work<tr><td><a id="l93"></a><a href="#l93">93</a><td>   * &lt;ul&gt;<tr><td><a id="l94"></a><a href="#l94">94</a><td>   * @type {Object}<tr><td><a id="l95"></a><a href="#l95">95</a><td>   * @private<tr><td><a id="l96"></a><a href="#l96">96</a><td>   */<tr><td><a id="l97"></a><a href="#l97">97</a><td>  this.testsToRun_ = null;<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td>  /**<tr><td><a id="l100"></a><a href="#l100">100</a><td>   * The order to run the auto-discovered tests in.<tr><td><a id="l101"></a><a href="#l101">101</a><td>   * @type {string}<tr><td><a id="l102"></a><a href="#l102">102</a><td>   */<tr><td><a id="l103"></a><a href="#l103">103</a><td>  this.order = goog.testing.TestCase.Order.SORTED;<tr><td><a id="l104"></a><a href="#l104">104</a><td><tr><td><a id="l105"></a><a href="#l105">105</a><td>  /** @private {function(!goog.testing.TestCase.Result)} */<tr><td><a id="l106"></a><a href="#l106">106</a><td>  this.runNextTestCallback_ = goog.nullFunction;<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>   * The number of {@link runNextTest_} frames currently on the stack.<tr><td><a id="l110"></a><a href="#l110">110</a><td>   * When this exceeds {@link MAX_STACK_DEPTH_}, test execution is rescheduled<tr><td><a id="l111"></a><a href="#l111">111</a><td>   * for a later tick of the event loop.<tr><td><a id="l112"></a><a href="#l112">112</a><td>   * @see {finishTestInvocation_}<tr><td><a id="l113"></a><a href="#l113">113</a><td>   * @private {number}<tr><td><a id="l114"></a><a href="#l114">114</a><td>   */<tr><td><a id="l115"></a><a href="#l115">115</a><td>  this.depth_ = 0;<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>  /** @private {goog.testing.TestCase.Test} */<tr><td><a id="l118"></a><a href="#l118">118</a><td>  this.curTest_ = null;<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>  /**<tr><td><a id="l121"></a><a href="#l121">121</a><td>   * Object used to encapsulate the test results.<tr><td><a id="l122"></a><a href="#l122">122</a><td>   * @type {!goog.testing.TestCase.Result}<tr><td><a id="l123"></a><a href="#l123">123</a><td>   * @protected<tr><td><a id="l124"></a><a href="#l124">124</a><td>   * @suppress {underscore|visibility}<tr><td><a id="l125"></a><a href="#l125">125</a><td>   */<tr><td><a id="l126"></a><a href="#l126">126</a><td>  this.result_ = new goog.testing.TestCase.Result(this);<tr><td><a id="l127"></a><a href="#l127">127</a><td><tr><td><a id="l128"></a><a href="#l128">128</a><td>  /**<tr><td><a id="l129"></a><a href="#l129">129</a><td>   * The maximum time in milliseconds a promise returned from a test function<tr><td><a id="l130"></a><a href="#l130">130</a><td>   * may remain pending before the test fails due to timeout.<tr><td><a id="l131"></a><a href="#l131">131</a><td>   * @type {number}<tr><td><a id="l132"></a><a href="#l132">132</a><td>   */<tr><td><a id="l133"></a><a href="#l133">133</a><td>  this.promiseTimeout = 1000; // 1s<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><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * The order to run the auto-discovered tests.<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @enum {string}<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.testing.TestCase.Order = {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  /**<tr><td><a id="l143"></a><a href="#l143">143</a><td>   * This is browser dependent and known to be different in FF and Safari<tr><td><a id="l144"></a><a href="#l144">144</a><td>   * compared to others.<tr><td><a id="l145"></a><a href="#l145">145</a><td>   */<tr><td><a id="l146"></a><a href="#l146">146</a><td>  NATURAL: &#39;natural&#39;,<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td>  /** Random order. */<tr><td><a id="l149"></a><a href="#l149">149</a><td>  RANDOM: &#39;random&#39;,<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td>  /** Sorted based on the name. */<tr><td><a id="l152"></a><a href="#l152">152</a><td>  SORTED: &#39;sorted&#39;<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> * @return {string} The name of the test.<tr><td><a id="l158"></a><a href="#l158">158</a><td> */<tr><td><a id="l159"></a><a href="#l159">159</a><td>goog.testing.TestCase.prototype.getName = function() {<tr><td><a id="l160"></a><a href="#l160">160</a><td>  return this.name_;<tr><td><a id="l161"></a><a href="#l161">161</a><td>};<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>/**<tr><td><a id="l165"></a><a href="#l165">165</a><td> * The maximum amount of time in milliseconds that the test case can take<tr><td><a id="l166"></a><a href="#l166">166</a><td> * before it is forced to yield and reschedule. This prevents the test runner<tr><td><a id="l167"></a><a href="#l167">167</a><td> * from blocking the browser and potentially hurting the test harness.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @type {number}<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>goog.testing.TestCase.maxRunTime = 200;<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>/**<tr><td><a id="l174"></a><a href="#l174">174</a><td> * The maximum number of {@link runNextTest_} frames that can be on the stack<tr><td><a id="l175"></a><a href="#l175">175</a><td> * before the test case is forced to yield and reschedule. Although modern<tr><td><a id="l176"></a><a href="#l176">176</a><td> * browsers can handle thousands of stack frames, this is set conservatively<tr><td><a id="l177"></a><a href="#l177">177</a><td> * because maximum stack depth has never been standardized, and engine-specific<tr><td><a id="l178"></a><a href="#l178">178</a><td> * techniques like tail cail optimization can affect the exact depth.<tr><td><a id="l179"></a><a href="#l179">179</a><td> * @private @const<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.testing.TestCase.MAX_STACK_DEPTH_ = 50;<tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td>/**<tr><td><a id="l185"></a><a href="#l185">185</a><td> * Save a reference to {@code window.setTimeout}, so any code that overrides the<tr><td><a id="l186"></a><a href="#l186">186</a><td> * default behavior (the MockClock, for example) doesn&#39;t affect our runner.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @type {function((Function|string), number=, *=): number}<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @private<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>goog.testing.TestCase.protectedSetTimeout_ = goog.global.setTimeout;<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> * Save a reference to {@code window.clearTimeout}, so any code that overrides<tr><td><a id="l195"></a><a href="#l195">195</a><td> * the default behavior (e.g. MockClock) doesn&#39;t affect our runner.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @type {function((null|number|undefined)): void}<tr><td><a id="l197"></a><a href="#l197">197</a><td> * @private<tr><td><a id="l198"></a><a href="#l198">198</a><td> */<tr><td><a id="l199"></a><a href="#l199">199</a><td>goog.testing.TestCase.protectedClearTimeout_ = goog.global.clearTimeout;<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> * Save a reference to {@code window.Date}, so any code that overrides<tr><td><a id="l204"></a><a href="#l204">204</a><td> * the default behavior doesn&#39;t affect our runner.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @type {function(new: Date)}<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @private<tr><td><a id="l207"></a><a href="#l207">207</a><td> */<tr><td><a id="l208"></a><a href="#l208">208</a><td>goog.testing.TestCase.protectedDate_ = Date;<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Saved string referencing goog.global.setTimeout&#39;s string serialization.  IE<tr><td><a id="l213"></a><a href="#l213">213</a><td> * sometimes fails to uphold equality for setTimeout, but the string version<tr><td><a id="l214"></a><a href="#l214">214</a><td> * stays the same.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @type {string}<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @private<tr><td><a id="l217"></a><a href="#l217">217</a><td> */<tr><td><a id="l218"></a><a href="#l218">218</a><td>goog.testing.TestCase.setTimeoutAsString_ = String(goog.global.setTimeout);<tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * TODO(user) replace this with prototype.currentTest.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * Name of the current test that is running, or null if none is running.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @type {?string}<tr><td><a id="l225"></a><a href="#l225">225</a><td> */<tr><td><a id="l226"></a><a href="#l226">226</a><td>goog.testing.TestCase.currentTestName = null;<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>/**<tr><td><a id="l230"></a><a href="#l230">230</a><td> * Avoid a dependency on goog.userAgent and keep our own reference of whether<tr><td><a id="l231"></a><a href="#l231">231</a><td> * the browser is IE.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @type {boolean}<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>goog.testing.TestCase.IS_IE = typeof opera == &#39;undefined&#39; &amp;&amp;<tr><td><a id="l235"></a><a href="#l235">235</a><td>    !!goog.global.navigator &amp;&amp;<tr><td><a id="l236"></a><a href="#l236">236</a><td>    goog.global.navigator.userAgent.indexOf(&#39;MSIE&#39;) != -1;<tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td><tr><td><a id="l239"></a><a href="#l239">239</a><td>/**<tr><td><a id="l240"></a><a href="#l240">240</a><td> * Exception object that was detected before a test runs.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @type {*}<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @protected<tr><td><a id="l243"></a><a href="#l243">243</a><td> */<tr><td><a id="l244"></a><a href="#l244">244</a><td>goog.testing.TestCase.prototype.exceptionBeforeTest;<tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>/**<tr><td><a id="l248"></a><a href="#l248">248</a><td> * Whether the test case has ever tried to execute.<tr><td><a id="l249"></a><a href="#l249">249</a><td> * @type {boolean}<tr><td><a id="l250"></a><a href="#l250">250</a><td> */<tr><td><a id="l251"></a><a href="#l251">251</a><td>goog.testing.TestCase.prototype.started = false;<tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td>/**<tr><td><a id="l255"></a><a href="#l255">255</a><td> * Whether the test case is running.<tr><td><a id="l256"></a><a href="#l256">256</a><td> * @type {boolean}<tr><td><a id="l257"></a><a href="#l257">257</a><td> */<tr><td><a id="l258"></a><a href="#l258">258</a><td>goog.testing.TestCase.prototype.running = false;<tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td>/**<tr><td><a id="l262"></a><a href="#l262">262</a><td> * Timestamp for when the test was started.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @type {number}<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @private<tr><td><a id="l265"></a><a href="#l265">265</a><td> */<tr><td><a id="l266"></a><a href="#l266">266</a><td>goog.testing.TestCase.prototype.startTime_ = 0;<tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td>/**<tr><td><a id="l270"></a><a href="#l270">270</a><td> * Time since the last batch of tests was started, if batchTime exceeds<tr><td><a id="l271"></a><a href="#l271">271</a><td> * {@link #maxRunTime} a timeout will be used to stop the tests blocking the<tr><td><a id="l272"></a><a href="#l272">272</a><td> * browser and a new batch will be started.<tr><td><a id="l273"></a><a href="#l273">273</a><td> * @type {number}<tr><td><a id="l274"></a><a href="#l274">274</a><td> * @private<tr><td><a id="l275"></a><a href="#l275">275</a><td> */<tr><td><a id="l276"></a><a href="#l276">276</a><td>goog.testing.TestCase.prototype.batchTime_ = 0;<tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td>/**<tr><td><a id="l280"></a><a href="#l280">280</a><td> * Pointer to the current test.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @type {number}<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @private<tr><td><a id="l283"></a><a href="#l283">283</a><td> */<tr><td><a id="l284"></a><a href="#l284">284</a><td>goog.testing.TestCase.prototype.currentTestPointer_ = 0;<tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td><tr><td><a id="l287"></a><a href="#l287">287</a><td>/**<tr><td><a id="l288"></a><a href="#l288">288</a><td> * Optional callback that will be executed when the test has finalized.<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @type {Function}<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @private<tr><td><a id="l291"></a><a href="#l291">291</a><td> */<tr><td><a id="l292"></a><a href="#l292">292</a><td>goog.testing.TestCase.prototype.onCompleteCallback_ = null;<tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>/**<tr><td><a id="l296"></a><a href="#l296">296</a><td> * Adds a new test to the test case.<tr><td><a id="l297"></a><a href="#l297">297</a><td> * @param {!goog.testing.TestCase.Test} test The test to add.<tr><td><a id="l298"></a><a href="#l298">298</a><td> */<tr><td><a id="l299"></a><a href="#l299">299</a><td>goog.testing.TestCase.prototype.add = function(test) {<tr><td><a id="l300"></a><a href="#l300">300</a><td>  goog.asserts.assert(test);<tr><td><a id="l301"></a><a href="#l301">301</a><td>  if (this.started) {<tr><td><a id="l302"></a><a href="#l302">302</a><td>    throw Error(&#39;Tests cannot be added after execute() has been called. &#39; +<tr><td><a id="l303"></a><a href="#l303">303</a><td>                &#39;Test: &#39; + test.name);<tr><td><a id="l304"></a><a href="#l304">304</a><td>  }<tr><td><a id="l305"></a><a href="#l305">305</a><td><tr><td><a id="l306"></a><a href="#l306">306</a><td>  this.tests_.push(test);<tr><td><a id="l307"></a><a href="#l307">307</a><td>};<tr><td><a id="l308"></a><a href="#l308">308</a><td><tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>/**<tr><td><a id="l311"></a><a href="#l311">311</a><td> * Creates and adds a new test.<tr><td><a id="l312"></a><a href="#l312">312</a><td> *<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Convenience function to make syntax less awkward when not using automatic<tr><td><a id="l314"></a><a href="#l314">314</a><td> * test discovery.<tr><td><a id="l315"></a><a href="#l315">315</a><td> *<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @param {string} name The test name.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @param {!Function} ref Reference to the test function.<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @param {!Object=} opt_scope Optional scope that the test function should be<tr><td><a id="l319"></a><a href="#l319">319</a><td> *     called in.<tr><td><a id="l320"></a><a href="#l320">320</a><td> */<tr><td><a id="l321"></a><a href="#l321">321</a><td>goog.testing.TestCase.prototype.addNewTest = function(name, ref, opt_scope) {<tr><td><a id="l322"></a><a href="#l322">322</a><td>  var test = new goog.testing.TestCase.Test(name, ref, opt_scope || this);<tr><td><a id="l323"></a><a href="#l323">323</a><td>  this.add(test);<tr><td><a id="l324"></a><a href="#l324">324</a><td>};<tr><td><a id="l325"></a><a href="#l325">325</a><td><tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td>/**<tr><td><a id="l328"></a><a href="#l328">328</a><td> * Sets the tests.<tr><td><a id="l329"></a><a href="#l329">329</a><td> * @param {!Array&lt;goog.testing.TestCase.Test&gt;} tests A new test array.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @protected<tr><td><a id="l331"></a><a href="#l331">331</a><td> */<tr><td><a id="l332"></a><a href="#l332">332</a><td>goog.testing.TestCase.prototype.setTests = function(tests) {<tr><td><a id="l333"></a><a href="#l333">333</a><td>  this.tests_ = tests;<tr><td><a id="l334"></a><a href="#l334">334</a><td>};<tr><td><a id="l335"></a><a href="#l335">335</a><td><tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td>/**<tr><td><a id="l338"></a><a href="#l338">338</a><td> * Gets the tests.<tr><td><a id="l339"></a><a href="#l339">339</a><td> * @return {!Array&lt;goog.testing.TestCase.Test&gt;} The test array.<tr><td><a id="l340"></a><a href="#l340">340</a><td> */<tr><td><a id="l341"></a><a href="#l341">341</a><td>goog.testing.TestCase.prototype.getTests = function() {<tr><td><a id="l342"></a><a href="#l342">342</a><td>  return this.tests_;<tr><td><a id="l343"></a><a href="#l343">343</a><td>};<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> * Returns the number of tests contained in the test case.<tr><td><a id="l348"></a><a href="#l348">348</a><td> * @return {number} The number of tests.<tr><td><a id="l349"></a><a href="#l349">349</a><td> */<tr><td><a id="l350"></a><a href="#l350">350</a><td>goog.testing.TestCase.prototype.getCount = function() {<tr><td><a id="l351"></a><a href="#l351">351</a><td>  return this.tests_.length;<tr><td><a id="l352"></a><a href="#l352">352</a><td>};<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td><tr><td><a id="l355"></a><a href="#l355">355</a><td>/**<tr><td><a id="l356"></a><a href="#l356">356</a><td> * Returns the number of tests actually run in the test case, i.e. subtracting<tr><td><a id="l357"></a><a href="#l357">357</a><td> * any which are skipped.<tr><td><a id="l358"></a><a href="#l358">358</a><td> * @return {number} The number of un-ignored tests.<tr><td><a id="l359"></a><a href="#l359">359</a><td> */<tr><td><a id="l360"></a><a href="#l360">360</a><td>goog.testing.TestCase.prototype.getActuallyRunCount = function() {<tr><td><a id="l361"></a><a href="#l361">361</a><td>  return this.testsToRun_ ? goog.object.getCount(this.testsToRun_) : 0;<tr><td><a id="l362"></a><a href="#l362">362</a><td>};<tr><td><a id="l363"></a><a href="#l363">363</a><td><tr><td><a id="l364"></a><a href="#l364">364</a><td><tr><td><a id="l365"></a><a href="#l365">365</a><td>/**<tr><td><a id="l366"></a><a href="#l366">366</a><td> * Returns the current test and increments the pointer.<tr><td><a id="l367"></a><a href="#l367">367</a><td> * @return {goog.testing.TestCase.Test} The current test case.<tr><td><a id="l368"></a><a href="#l368">368</a><td> */<tr><td><a id="l369"></a><a href="#l369">369</a><td>goog.testing.TestCase.prototype.next = function() {<tr><td><a id="l370"></a><a href="#l370">370</a><td>  var test;<tr><td><a id="l371"></a><a href="#l371">371</a><td>  while ((test = this.tests_[this.currentTestPointer_++])) {<tr><td><a id="l372"></a><a href="#l372">372</a><td>    if (!this.testsToRun_ || this.testsToRun_[test.name] ||<tr><td><a id="l373"></a><a href="#l373">373</a><td>        this.testsToRun_[this.currentTestPointer_ - 1]) {<tr><td><a id="l374"></a><a href="#l374">374</a><td>      return test;<tr><td><a id="l375"></a><a href="#l375">375</a><td>    }<tr><td><a id="l376"></a><a href="#l376">376</a><td>  }<tr><td><a id="l377"></a><a href="#l377">377</a><td>  return null;<tr><td><a id="l378"></a><a href="#l378">378</a><td>};<tr><td><a id="l379"></a><a href="#l379">379</a><td><tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td>/**<tr><td><a id="l382"></a><a href="#l382">382</a><td> * Resets the test case pointer, so that next returns the first test.<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.testing.TestCase.prototype.reset = function() {<tr><td><a id="l385"></a><a href="#l385">385</a><td>  this.currentTestPointer_ = 0;<tr><td><a id="l386"></a><a href="#l386">386</a><td>  this.result_ = new goog.testing.TestCase.Result(this);<tr><td><a id="l387"></a><a href="#l387">387</a><td>};<tr><td><a id="l388"></a><a href="#l388">388</a><td><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> * Sets the callback function that should be executed when the tests have<tr><td><a id="l392"></a><a href="#l392">392</a><td> * completed.<tr><td><a id="l393"></a><a href="#l393">393</a><td> * @param {Function} fn The callback function.<tr><td><a id="l394"></a><a href="#l394">394</a><td> */<tr><td><a id="l395"></a><a href="#l395">395</a><td>goog.testing.TestCase.prototype.setCompletedCallback = function(fn) {<tr><td><a id="l396"></a><a href="#l396">396</a><td>  this.onCompleteCallback_ = fn;<tr><td><a id="l397"></a><a href="#l397">397</a><td>};<tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td><tr><td><a id="l400"></a><a href="#l400">400</a><td>/**<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @param {goog.testing.TestCase.Order} order The sort order for running tests.<tr><td><a id="l402"></a><a href="#l402">402</a><td> */<tr><td><a id="l403"></a><a href="#l403">403</a><td>goog.testing.TestCase.prototype.setOrder = function(order) {<tr><td><a id="l404"></a><a href="#l404">404</a><td>  this.order = order;<tr><td><a id="l405"></a><a href="#l405">405</a><td>};<tr><td><a id="l406"></a><a href="#l406">406</a><td><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> * @param {Object&lt;string, boolean&gt;} testsToRun Set of tests to run. Entries in<tr><td><a id="l410"></a><a href="#l410">410</a><td> *     the set may be test names, like &quot;testFoo&quot;, or numeric indicies. Only<tr><td><a id="l411"></a><a href="#l411">411</a><td> *     tests identified by name or by index will be executed.<tr><td><a id="l412"></a><a href="#l412">412</a><td> */<tr><td><a id="l413"></a><a href="#l413">413</a><td>goog.testing.TestCase.prototype.setTestsToRun = function(testsToRun) {<tr><td><a id="l414"></a><a href="#l414">414</a><td>  this.testsToRun_ = testsToRun;<tr><td><a id="l415"></a><a href="#l415">415</a><td>};<tr><td><a id="l416"></a><a href="#l416">416</a><td><tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td>/**<tr><td><a id="l419"></a><a href="#l419">419</a><td> * Can be overridden in test classes to indicate whether the tests in a case<tr><td><a id="l420"></a><a href="#l420">420</a><td> * should be run in that particular situation.  For example, this could be used<tr><td><a id="l421"></a><a href="#l421">421</a><td> * to stop tests running in a particular browser, where browser support for<tr><td><a id="l422"></a><a href="#l422">422</a><td> * the class under test was absent.<tr><td><a id="l423"></a><a href="#l423">423</a><td> * @return {boolean} Whether any of the tests in the case should be run.<tr><td><a id="l424"></a><a href="#l424">424</a><td> */<tr><td><a id="l425"></a><a href="#l425">425</a><td>goog.testing.TestCase.prototype.shouldRunTests = function() {<tr><td><a id="l426"></a><a href="#l426">426</a><td>  return true;<tr><td><a id="l427"></a><a href="#l427">427</a><td>};<tr><td><a id="l428"></a><a href="#l428">428</a><td><tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td>/**<tr><td><a id="l431"></a><a href="#l431">431</a><td> * Executes the tests, yielding asynchronously if execution time exceeds<tr><td><a id="l432"></a><a href="#l432">432</a><td> * {@link maxRunTime}. There is no guarantee that the test case has finished<tr><td><a id="l433"></a><a href="#l433">433</a><td> * once this method has returned. To be notified when the test case<tr><td><a id="l434"></a><a href="#l434">434</a><td> * has finished, use {@link #setCompletedCallback} or<tr><td><a id="l435"></a><a href="#l435">435</a><td> * {@link #runTestsReturningPromise}.<tr><td><a id="l436"></a><a href="#l436">436</a><td> */<tr><td><a id="l437"></a><a href="#l437">437</a><td>goog.testing.TestCase.prototype.execute = function() {<tr><td><a id="l438"></a><a href="#l438">438</a><td>  if (!this.prepareForRun_()) {<tr><td><a id="l439"></a><a href="#l439">439</a><td>    return;<tr><td><a id="l440"></a><a href="#l440">440</a><td>  }<tr><td><a id="l441"></a><a href="#l441">441</a><td>  this.log(&#39;Starting tests: &#39; + this.name_);<tr><td><a id="l442"></a><a href="#l442">442</a><td>  this.cycleTests();<tr><td><a id="l443"></a><a href="#l443">443</a><td>};<tr><td><a id="l444"></a><a href="#l444">444</a><td><tr><td><a id="l445"></a><a href="#l445">445</a><td><tr><td><a id="l446"></a><a href="#l446">446</a><td>/**<tr><td><a id="l447"></a><a href="#l447">447</a><td> * Sets up the internal state of the test case for a run.<tr><td><a id="l448"></a><a href="#l448">448</a><td> * @return {boolean} If false, preparation failed because the test case<tr><td><a id="l449"></a><a href="#l449">449</a><td> *     is not supposed to run in the present environment.<tr><td><a id="l450"></a><a href="#l450">450</a><td> * @private<tr><td><a id="l451"></a><a href="#l451">451</a><td> */<tr><td><a id="l452"></a><a href="#l452">452</a><td>goog.testing.TestCase.prototype.prepareForRun_ = function() {<tr><td><a id="l453"></a><a href="#l453">453</a><td>  this.started = true;<tr><td><a id="l454"></a><a href="#l454">454</a><td>  this.reset();<tr><td><a id="l455"></a><a href="#l455">455</a><td>  this.startTime_ = this.now();<tr><td><a id="l456"></a><a href="#l456">456</a><td>  this.running = true;<tr><td><a id="l457"></a><a href="#l457">457</a><td>  this.result_.totalCount = this.getCount();<tr><td><a id="l458"></a><a href="#l458">458</a><td>  if (!this.shouldRunTests()) {<tr><td><a id="l459"></a><a href="#l459">459</a><td>    this.log(&#39;shouldRunTests() returned false, skipping these tests.&#39;);<tr><td><a id="l460"></a><a href="#l460">460</a><td>    this.result_.testSuppressed = true;<tr><td><a id="l461"></a><a href="#l461">461</a><td>    this.finalize();<tr><td><a id="l462"></a><a href="#l462">462</a><td>    return false;<tr><td><a id="l463"></a><a href="#l463">463</a><td>  }<tr><td><a id="l464"></a><a href="#l464">464</a><td>  return true;<tr><td><a id="l465"></a><a href="#l465">465</a><td>};<tr><td><a id="l466"></a><a href="#l466">466</a><td><tr><td><a id="l467"></a><a href="#l467">467</a><td><tr><td><a id="l468"></a><a href="#l468">468</a><td>/**<tr><td><a id="l469"></a><a href="#l469">469</a><td> * Finalizes the test case, called when the tests have finished executing.<tr><td><a id="l470"></a><a href="#l470">470</a><td> */<tr><td><a id="l471"></a><a href="#l471">471</a><td>goog.testing.TestCase.prototype.finalize = function() {<tr><td><a id="l472"></a><a href="#l472">472</a><td>  this.saveMessage(&#39;Done&#39;);<tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td>  this.tearDownPage();<tr><td><a id="l475"></a><a href="#l475">475</a><td><tr><td><a id="l476"></a><a href="#l476">476</a><td>  var restoredSetTimeout =<tr><td><a id="l477"></a><a href="#l477">477</a><td>      goog.testing.TestCase.protectedSetTimeout_ == goog.global.setTimeout &amp;&amp;<tr><td><a id="l478"></a><a href="#l478">478</a><td>      goog.testing.TestCase.protectedClearTimeout_ == goog.global.clearTimeout;<tr><td><a id="l479"></a><a href="#l479">479</a><td>  if (!restoredSetTimeout &amp;&amp; goog.testing.TestCase.IS_IE &amp;&amp;<tr><td><a id="l480"></a><a href="#l480">480</a><td>      String(goog.global.setTimeout) ==<tr><td><a id="l481"></a><a href="#l481">481</a><td>          goog.testing.TestCase.setTimeoutAsString_) {<tr><td><a id="l482"></a><a href="#l482">482</a><td>    // In strange cases, IE&#39;s value of setTimeout *appears* to change, but<tr><td><a id="l483"></a><a href="#l483">483</a><td>    // the string representation stays stable.<tr><td><a id="l484"></a><a href="#l484">484</a><td>    restoredSetTimeout = true;<tr><td><a id="l485"></a><a href="#l485">485</a><td>  }<tr><td><a id="l486"></a><a href="#l486">486</a><td><tr><td><a id="l487"></a><a href="#l487">487</a><td>  if (!restoredSetTimeout) {<tr><td><a id="l488"></a><a href="#l488">488</a><td>    var message = &#39;ERROR: Test did not restore setTimeout and clearTimeout&#39;;<tr><td><a id="l489"></a><a href="#l489">489</a><td>    this.saveMessage(message);<tr><td><a id="l490"></a><a href="#l490">490</a><td>    var err = new goog.testing.TestCase.Error(this.name_, message);<tr><td><a id="l491"></a><a href="#l491">491</a><td>    this.result_.errors.push(err);<tr><td><a id="l492"></a><a href="#l492">492</a><td>  }<tr><td><a id="l493"></a><a href="#l493">493</a><td>  goog.global.clearTimeout = goog.testing.TestCase.protectedClearTimeout_;<tr><td><a id="l494"></a><a href="#l494">494</a><td>  goog.global.setTimeout = goog.testing.TestCase.protectedSetTimeout_;<tr><td><a id="l495"></a><a href="#l495">495</a><td>  this.endTime_ = this.now();<tr><td><a id="l496"></a><a href="#l496">496</a><td>  this.running = false;<tr><td><a id="l497"></a><a href="#l497">497</a><td>  this.result_.runTime = this.endTime_ - this.startTime_;<tr><td><a id="l498"></a><a href="#l498">498</a><td>  this.result_.numFilesLoaded = this.countNumFilesLoaded_();<tr><td><a id="l499"></a><a href="#l499">499</a><td>  this.result_.complete = true;<tr><td><a id="l500"></a><a href="#l500">500</a><td><tr><td><a id="l501"></a><a href="#l501">501</a><td>  this.log(this.result_.getSummary());<tr><td><a id="l502"></a><a href="#l502">502</a><td>  if (this.result_.isSuccess()) {<tr><td><a id="l503"></a><a href="#l503">503</a><td>    this.log(&#39;Tests complete&#39;);<tr><td><a id="l504"></a><a href="#l504">504</a><td>  } else {<tr><td><a id="l505"></a><a href="#l505">505</a><td>    this.log(&#39;Tests Failed&#39;);<tr><td><a id="l506"></a><a href="#l506">506</a><td>  }<tr><td><a id="l507"></a><a href="#l507">507</a><td>  if (this.onCompleteCallback_) {<tr><td><a id="l508"></a><a href="#l508">508</a><td>    var fn = this.onCompleteCallback_;<tr><td><a id="l509"></a><a href="#l509">509</a><td>    // Execute&#39;s the completed callback in the context of the global object.<tr><td><a id="l510"></a><a href="#l510">510</a><td>    fn();<tr><td><a id="l511"></a><a href="#l511">511</a><td>    this.onCompleteCallback_ = null;<tr><td><a id="l512"></a><a href="#l512">512</a><td>  }<tr><td><a id="l513"></a><a href="#l513">513</a><td>};<tr><td><a id="l514"></a><a href="#l514">514</a><td><tr><td><a id="l515"></a><a href="#l515">515</a><td><tr><td><a id="l516"></a><a href="#l516">516</a><td>/**<tr><td><a id="l517"></a><a href="#l517">517</a><td> * Saves a message to the result set.<tr><td><a id="l518"></a><a href="#l518">518</a><td> * @param {string} message The message to save.<tr><td><a id="l519"></a><a href="#l519">519</a><td> */<tr><td><a id="l520"></a><a href="#l520">520</a><td>goog.testing.TestCase.prototype.saveMessage = function(message) {<tr><td><a id="l521"></a><a href="#l521">521</a><td>  this.result_.messages.push(this.getTimeStamp_() + &#39;  &#39; + message);<tr><td><a id="l522"></a><a href="#l522">522</a><td>};<tr><td><a id="l523"></a><a href="#l523">523</a><td><tr><td><a id="l524"></a><a href="#l524">524</a><td><tr><td><a id="l525"></a><a href="#l525">525</a><td>/**<tr><td><a id="l526"></a><a href="#l526">526</a><td> * @return {boolean} Whether the test case is running inside the multi test<tr><td><a id="l527"></a><a href="#l527">527</a><td> *     runner.<tr><td><a id="l528"></a><a href="#l528">528</a><td> */<tr><td><a id="l529"></a><a href="#l529">529</a><td>goog.testing.TestCase.prototype.isInsideMultiTestRunner = function() {<tr><td><a id="l530"></a><a href="#l530">530</a><td>  var top = goog.global[&#39;top&#39;];<tr><td><a id="l531"></a><a href="#l531">531</a><td>  return top &amp;&amp; typeof top[&#39;_allTests&#39;] != &#39;undefined&#39;;<tr><td><a id="l532"></a><a href="#l532">532</a><td>};<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> * Logs an object to the console, if available.<tr><td><a id="l537"></a><a href="#l537">537</a><td> * @param {*} val The value to log. Will be ToString&#39;d.<tr><td><a id="l538"></a><a href="#l538">538</a><td> */<tr><td><a id="l539"></a><a href="#l539">539</a><td>goog.testing.TestCase.prototype.log = function(val) {<tr><td><a id="l540"></a><a href="#l540">540</a><td>  if (!this.isInsideMultiTestRunner() &amp;&amp; goog.global.console) {<tr><td><a id="l541"></a><a href="#l541">541</a><td>    if (typeof val == &#39;string&#39;) {<tr><td><a id="l542"></a><a href="#l542">542</a><td>      val = this.getTimeStamp_() + &#39; : &#39; + val;<tr><td><a id="l543"></a><a href="#l543">543</a><td>    }<tr><td><a id="l544"></a><a href="#l544">544</a><td>    if (val instanceof Error &amp;&amp; val.stack) {<tr><td><a id="l545"></a><a href="#l545">545</a><td>      // Chrome does console.log asynchronously in a different process<tr><td><a id="l546"></a><a href="#l546">546</a><td>      // (http://code.google.com/p/chromium/issues/detail?id=50316).<tr><td><a id="l547"></a><a href="#l547">547</a><td>      // This is an acute problem for Errors, which almost never survive.<tr><td><a id="l548"></a><a href="#l548">548</a><td>      // Grab references to the immutable strings so they survive.<tr><td><a id="l549"></a><a href="#l549">549</a><td>      goog.global.console.log(val, val.message, val.stack);<tr><td><a id="l550"></a><a href="#l550">550</a><td>      // TODO(gboyer): Consider for Chrome cloning any object if we can ensure<tr><td><a id="l551"></a><a href="#l551">551</a><td>      // there are no circular references.<tr><td><a id="l552"></a><a href="#l552">552</a><td>    } else {<tr><td><a id="l553"></a><a href="#l553">553</a><td>      goog.global.console.log(val);<tr><td><a id="l554"></a><a href="#l554">554</a><td>    }<tr><td><a id="l555"></a><a href="#l555">555</a><td>  }<tr><td><a id="l556"></a><a href="#l556">556</a><td>};<tr><td><a id="l557"></a><a href="#l557">557</a><td><tr><td><a id="l558"></a><a href="#l558">558</a><td><tr><td><a id="l559"></a><a href="#l559">559</a><td>/**<tr><td><a id="l560"></a><a href="#l560">560</a><td> * @return {boolean} Whether the test was a success.<tr><td><a id="l561"></a><a href="#l561">561</a><td> */<tr><td><a id="l562"></a><a href="#l562">562</a><td>goog.testing.TestCase.prototype.isSuccess = function() {<tr><td><a id="l563"></a><a href="#l563">563</a><td>  return !!this.result_ &amp;&amp; this.result_.isSuccess();<tr><td><a id="l564"></a><a href="#l564">564</a><td>};<tr><td><a id="l565"></a><a href="#l565">565</a><td><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> * Returns a string detailing the results from the test.<tr><td><a id="l569"></a><a href="#l569">569</a><td> * @param {boolean=} opt_verbose If true results will include data about all<tr><td><a id="l570"></a><a href="#l570">570</a><td> *     tests, not just what failed.<tr><td><a id="l571"></a><a href="#l571">571</a><td> * @return {string} The results from the test.<tr><td><a id="l572"></a><a href="#l572">572</a><td> */<tr><td><a id="l573"></a><a href="#l573">573</a><td>goog.testing.TestCase.prototype.getReport = function(opt_verbose) {<tr><td><a id="l574"></a><a href="#l574">574</a><td>  var rv = [];<tr><td><a id="l575"></a><a href="#l575">575</a><td><tr><td><a id="l576"></a><a href="#l576">576</a><td>  if (this.running) {<tr><td><a id="l577"></a><a href="#l577">577</a><td>    rv.push(this.name_ + &#39; [RUNNING]&#39;);<tr><td><a id="l578"></a><a href="#l578">578</a><td>  } else {<tr><td><a id="l579"></a><a href="#l579">579</a><td>    var label = this.result_.isSuccess() ? &#39;PASSED&#39; : &#39;FAILED&#39;;<tr><td><a id="l580"></a><a href="#l580">580</a><td>    rv.push(this.name_ + &#39; [&#39; + label + &#39;]&#39;);<tr><td><a id="l581"></a><a href="#l581">581</a><td>  }<tr><td><a id="l582"></a><a href="#l582">582</a><td><tr><td><a id="l583"></a><a href="#l583">583</a><td>  if (goog.global.location) {<tr><td><a id="l584"></a><a href="#l584">584</a><td>    rv.push(this.trimPath_(goog.global.location.href));<tr><td><a id="l585"></a><a href="#l585">585</a><td>  }<tr><td><a id="l586"></a><a href="#l586">586</a><td><tr><td><a id="l587"></a><a href="#l587">587</a><td>  rv.push(this.result_.getSummary());<tr><td><a id="l588"></a><a href="#l588">588</a><td><tr><td><a id="l589"></a><a href="#l589">589</a><td>  if (opt_verbose) {<tr><td><a id="l590"></a><a href="#l590">590</a><td>    rv.push(&#39;.&#39;, this.result_.messages.join(&#39;\n&#39;));<tr><td><a id="l591"></a><a href="#l591">591</a><td>  } else if (!this.result_.isSuccess()) {<tr><td><a id="l592"></a><a href="#l592">592</a><td>    rv.push(this.result_.errors.join(&#39;\n&#39;));<tr><td><a id="l593"></a><a href="#l593">593</a><td>  }<tr><td><a id="l594"></a><a href="#l594">594</a><td><tr><td><a id="l595"></a><a href="#l595">595</a><td>  rv.push(&#39; &#39;);<tr><td><a id="l596"></a><a href="#l596">596</a><td><tr><td><a id="l597"></a><a href="#l597">597</a><td>  return rv.join(&#39;\n&#39;);<tr><td><a id="l598"></a><a href="#l598">598</a><td>};<tr><td><a id="l599"></a><a href="#l599">599</a><td><tr><td><a id="l600"></a><a href="#l600">600</a><td><tr><td><a id="l601"></a><a href="#l601">601</a><td>/**<tr><td><a id="l602"></a><a href="#l602">602</a><td> * Returns the test results.<tr><td><a id="l603"></a><a href="#l603">603</a><td> * @return {!goog.testing.TestCase.Result}<tr><td><a id="l604"></a><a href="#l604">604</a><td> * @package<tr><td><a id="l605"></a><a href="#l605">605</a><td> */<tr><td><a id="l606"></a><a href="#l606">606</a><td>goog.testing.TestCase.prototype.getResult = function() {<tr><td><a id="l607"></a><a href="#l607">607</a><td>  return this.result_;<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><tr><td><a id="l611"></a><a href="#l611">611</a><td>/**<tr><td><a id="l612"></a><a href="#l612">612</a><td> * Returns the amount of time it took for the test to run.<tr><td><a id="l613"></a><a href="#l613">613</a><td> * @return {number} The run time, in milliseconds.<tr><td><a id="l614"></a><a href="#l614">614</a><td> */<tr><td><a id="l615"></a><a href="#l615">615</a><td>goog.testing.TestCase.prototype.getRunTime = function() {<tr><td><a id="l616"></a><a href="#l616">616</a><td>  return this.result_.runTime;<tr><td><a id="l617"></a><a href="#l617">617</a><td>};<tr><td><a id="l618"></a><a href="#l618">618</a><td><tr><td><a id="l619"></a><a href="#l619">619</a><td><tr><td><a id="l620"></a><a href="#l620">620</a><td>/**<tr><td><a id="l621"></a><a href="#l621">621</a><td> * Returns the number of script files that were loaded in order to run the test.<tr><td><a id="l622"></a><a href="#l622">622</a><td> * @return {number} The number of script files.<tr><td><a id="l623"></a><a href="#l623">623</a><td> */<tr><td><a id="l624"></a><a href="#l624">624</a><td>goog.testing.TestCase.prototype.getNumFilesLoaded = function() {<tr><td><a id="l625"></a><a href="#l625">625</a><td>  return this.result_.numFilesLoaded;<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><tr><td><a id="l629"></a><a href="#l629">629</a><td>/**<tr><td><a id="l630"></a><a href="#l630">630</a><td> * Returns the test results object: a map from test names to a list of test<tr><td><a id="l631"></a><a href="#l631">631</a><td> * failures (if any exist).<tr><td><a id="l632"></a><a href="#l632">632</a><td> * @return {!Object&lt;string, !Array&lt;string&gt;&gt;} Tests results object.<tr><td><a id="l633"></a><a href="#l633">633</a><td> */<tr><td><a id="l634"></a><a href="#l634">634</a><td>goog.testing.TestCase.prototype.getTestResults = function() {<tr><td><a id="l635"></a><a href="#l635">635</a><td>  return this.result_.resultsByName;<tr><td><a id="l636"></a><a href="#l636">636</a><td>};<tr><td><a id="l637"></a><a href="#l637">637</a><td><tr><td><a id="l638"></a><a href="#l638">638</a><td><tr><td><a id="l639"></a><a href="#l639">639</a><td>/**<tr><td><a id="l640"></a><a href="#l640">640</a><td> * Executes each of the tests, yielding asynchronously if execution time<tr><td><a id="l641"></a><a href="#l641">641</a><td> * exceeds {@link #maxRunTime}. There is no guarantee that the test case<tr><td><a id="l642"></a><a href="#l642">642</a><td> * has finished execution once this method has returned.<tr><td><a id="l643"></a><a href="#l643">643</a><td> * To be notified when the test case has finished execution, use<tr><td><a id="l644"></a><a href="#l644">644</a><td> * {@link #setCompletedCallback} or {@link #runTestsReturningPromise}.<tr><td><a id="l645"></a><a href="#l645">645</a><td> *<tr><td><a id="l646"></a><a href="#l646">646</a><td> * Overridable by the individual test case.  This allows test cases to defer<tr><td><a id="l647"></a><a href="#l647">647</a><td> * when the test is actually started.  If overridden, finalize must be called<tr><td><a id="l648"></a><a href="#l648">648</a><td> * by the test to indicate it has finished.<tr><td><a id="l649"></a><a href="#l649">649</a><td> */<tr><td><a id="l650"></a><a href="#l650">650</a><td>goog.testing.TestCase.prototype.runTests = function() {<tr><td><a id="l651"></a><a href="#l651">651</a><td>  try {<tr><td><a id="l652"></a><a href="#l652">652</a><td>    this.setUpPage();<tr><td><a id="l653"></a><a href="#l653">653</a><td>  } catch (e) {<tr><td><a id="l654"></a><a href="#l654">654</a><td>    this.exceptionBeforeTest = e;<tr><td><a id="l655"></a><a href="#l655">655</a><td>  }<tr><td><a id="l656"></a><a href="#l656">656</a><td>  this.execute();<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><tr><td><a id="l660"></a><a href="#l660">660</a><td>/**<tr><td><a id="l661"></a><a href="#l661">661</a><td> * Executes each of the tests, returning a promise that resolves with the<tr><td><a id="l662"></a><a href="#l662">662</a><td> * test results once they are done running.<tr><td><a id="l663"></a><a href="#l663">663</a><td> * @return {!IThenable&lt;!goog.testing.TestCase.Result&gt;}<tr><td><a id="l664"></a><a href="#l664">664</a><td> * @final<tr><td><a id="l665"></a><a href="#l665">665</a><td> * @package<tr><td><a id="l666"></a><a href="#l666">666</a><td> */<tr><td><a id="l667"></a><a href="#l667">667</a><td>goog.testing.TestCase.prototype.runTestsReturningPromise = function() {<tr><td><a id="l668"></a><a href="#l668">668</a><td>  try {<tr><td><a id="l669"></a><a href="#l669">669</a><td>    this.setUpPage();<tr><td><a id="l670"></a><a href="#l670">670</a><td>  } catch (e) {<tr><td><a id="l671"></a><a href="#l671">671</a><td>    this.exceptionBeforeTest = e;<tr><td><a id="l672"></a><a href="#l672">672</a><td>  }<tr><td><a id="l673"></a><a href="#l673">673</a><td>  if (!this.prepareForRun_()) {<tr><td><a id="l674"></a><a href="#l674">674</a><td>    return goog.Promise.resolve(this.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>  this.log(&#39;Starting tests: &#39; + this.name_);<tr><td><a id="l677"></a><a href="#l677">677</a><td>  this.saveMessage(&#39;Start&#39;);<tr><td><a id="l678"></a><a href="#l678">678</a><td>  this.batchTime_ = this.now();<tr><td><a id="l679"></a><a href="#l679">679</a><td>  return new goog.Promise(function(resolve) {<tr><td><a id="l680"></a><a href="#l680">680</a><td>    this.runNextTestCallback_ = resolve;<tr><td><a id="l681"></a><a href="#l681">681</a><td>    this.runNextTest_();<tr><td><a id="l682"></a><a href="#l682">682</a><td>  }, this);<tr><td><a id="l683"></a><a href="#l683">683</a><td>};<tr><td><a id="l684"></a><a href="#l684">684</a><td><tr><td><a id="l685"></a><a href="#l685">685</a><td><tr><td><a id="l686"></a><a href="#l686">686</a><td>/**<tr><td><a id="l687"></a><a href="#l687">687</a><td> * Executes the next test method synchronously or with promises, depending on<tr><td><a id="l688"></a><a href="#l688">688</a><td> * the test method&#39;s return value.<tr><td><a id="l689"></a><a href="#l689">689</a><td> *<tr><td><a id="l690"></a><a href="#l690">690</a><td> * If the test method returns a promise, the next test method will run once<tr><td><a id="l691"></a><a href="#l691">691</a><td> * the promise is resolved or rejected. If the test method does not<tr><td><a id="l692"></a><a href="#l692">692</a><td> * return a promise, it is assumed to be synchronous, and execution proceeds<tr><td><a id="l693"></a><a href="#l693">693</a><td> * immediately to the next test method. This means that test cases can run<tr><td><a id="l694"></a><a href="#l694">694</a><td> * partially synchronously and partially asynchronously, depending on<tr><td><a id="l695"></a><a href="#l695">695</a><td> * the return values of their test methods. In particular, a test case<tr><td><a id="l696"></a><a href="#l696">696</a><td> * executes synchronously until the first promise is returned from a<tr><td><a id="l697"></a><a href="#l697">697</a><td> * test method (or until a resource limit is reached; see<tr><td><a id="l698"></a><a href="#l698">698</a><td> * {@link finishTestInvocation_}).<tr><td><a id="l699"></a><a href="#l699">699</a><td> * @private<tr><td><a id="l700"></a><a href="#l700">700</a><td> */<tr><td><a id="l701"></a><a href="#l701">701</a><td>goog.testing.TestCase.prototype.runNextTest_ = function() {<tr><td><a id="l702"></a><a href="#l702">702</a><td>  this.curTest_ = this.next();<tr><td><a id="l703"></a><a href="#l703">703</a><td>  if (!this.curTest_ || !this.running) {<tr><td><a id="l704"></a><a href="#l704">704</a><td>    this.finalize();<tr><td><a id="l705"></a><a href="#l705">705</a><td>    this.runNextTestCallback_(this.result_);<tr><td><a id="l706"></a><a href="#l706">706</a><td>    return;<tr><td><a id="l707"></a><a href="#l707">707</a><td>  }<tr><td><a id="l708"></a><a href="#l708">708</a><td>  this.result_.runCount++;<tr><td><a id="l709"></a><a href="#l709">709</a><td>  this.log(&#39;Running test: &#39; + this.curTest_.name);<tr><td><a id="l710"></a><a href="#l710">710</a><td>  if (this.maybeFailTestEarly(this.curTest_)) {<tr><td><a id="l711"></a><a href="#l711">711</a><td>    this.finishTestInvocation_();<tr><td><a id="l712"></a><a href="#l712">712</a><td>    return;<tr><td><a id="l713"></a><a href="#l713">713</a><td>  }<tr><td><a id="l714"></a><a href="#l714">714</a><td>  goog.testing.TestCase.currentTestName = this.curTest_.name;<tr><td><a id="l715"></a><a href="#l715">715</a><td>  this.invokeTestFunction_(<tr><td><a id="l716"></a><a href="#l716">716</a><td>      this.setUp, this.safeRunTest_, this.safeTearDown_,<tr><td><a id="l717"></a><a href="#l717">717</a><td>      &#39;setUp&#39;);<tr><td><a id="l718"></a><a href="#l718">718</a><td>};<tr><td><a id="l719"></a><a href="#l719">719</a><td><tr><td><a id="l720"></a><a href="#l720">720</a><td><tr><td><a id="l721"></a><a href="#l721">721</a><td>/**<tr><td><a id="l722"></a><a href="#l722">722</a><td> * Calls the given test function, handling errors appropriately.<tr><td><a id="l723"></a><a href="#l723">723</a><td> * @private<tr><td><a id="l724"></a><a href="#l724">724</a><td> */<tr><td><a id="l725"></a><a href="#l725">725</a><td>goog.testing.TestCase.prototype.safeRunTest_ = function() {<tr><td><a id="l726"></a><a href="#l726">726</a><td>  this.invokeTestFunction_(<tr><td><a id="l727"></a><a href="#l727">727</a><td>      goog.bind(this.curTest_.ref, this.curTest_.scope),<tr><td><a id="l728"></a><a href="#l728">728</a><td>      this.safeTearDown_,<tr><td><a id="l729"></a><a href="#l729">729</a><td>      this.safeTearDown_,<tr><td><a id="l730"></a><a href="#l730">730</a><td>      this.curTest_.name);<tr><td><a id="l731"></a><a href="#l731">731</a><td>};<tr><td><a id="l732"></a><a href="#l732">732</a><td><tr><td><a id="l733"></a><a href="#l733">733</a><td><tr><td><a id="l734"></a><a href="#l734">734</a><td>/**<tr><td><a id="l735"></a><a href="#l735">735</a><td> * Calls {@link tearDown}, handling errors appropriately.<tr><td><a id="l736"></a><a href="#l736">736</a><td> * @param {*=} opt_error Error associated with the test, if any.<tr><td><a id="l737"></a><a href="#l737">737</a><td> * @private<tr><td><a id="l738"></a><a href="#l738">738</a><td> */<tr><td><a id="l739"></a><a href="#l739">739</a><td>goog.testing.TestCase.prototype.safeTearDown_ = function(opt_error) {<tr><td><a id="l740"></a><a href="#l740">740</a><td>  if (arguments.length == 1) {<tr><td><a id="l741"></a><a href="#l741">741</a><td>    this.doError(this.curTest_, opt_error);<tr><td><a id="l742"></a><a href="#l742">742</a><td>  }<tr><td><a id="l743"></a><a href="#l743">743</a><td>  this.invokeTestFunction_(<tr><td><a id="l744"></a><a href="#l744">744</a><td>      this.tearDown, this.finishTestInvocation_, this.finishTestInvocation_,<tr><td><a id="l745"></a><a href="#l745">745</a><td>      &#39;tearDown&#39;);<tr><td><a id="l746"></a><a href="#l746">746</a><td>};<tr><td><a id="l747"></a><a href="#l747">747</a><td><tr><td><a id="l748"></a><a href="#l748">748</a><td><tr><td><a id="l749"></a><a href="#l749">749</a><td>/**<tr><td><a id="l750"></a><a href="#l750">750</a><td> * Calls the given {@code fn}, then calls either {@code onSuccess} or<tr><td><a id="l751"></a><a href="#l751">751</a><td> * {@code onFailure}, either synchronously or using promises, depending on<tr><td><a id="l752"></a><a href="#l752">752</a><td> * {@code fn}&#39;s return value.<tr><td><a id="l753"></a><a href="#l753">753</a><td> *<tr><td><a id="l754"></a><a href="#l754">754</a><td> * If {@code fn} throws an exception, {@code onFailure} is called immediately<tr><td><a id="l755"></a><a href="#l755">755</a><td> * with the exception.<tr><td><a id="l756"></a><a href="#l756">756</a><td> *<tr><td><a id="l757"></a><a href="#l757">757</a><td> * If {@code fn} returns a promise, and the promise is eventually resolved,<tr><td><a id="l758"></a><a href="#l758">758</a><td> * {@code onSuccess} is called with no arguments. If the promise is eventually<tr><td><a id="l759"></a><a href="#l759">759</a><td> * rejected, {@code onFailure} is called with the rejection reason.<tr><td><a id="l760"></a><a href="#l760">760</a><td> *<tr><td><a id="l761"></a><a href="#l761">761</a><td> * Otherwise, if {@code fn} neither returns a promise nor throws an exception,<tr><td><a id="l762"></a><a href="#l762">762</a><td> * {@code onSuccess} is called immediately with no arguments.<tr><td><a id="l763"></a><a href="#l763">763</a><td> *<tr><td><a id="l764"></a><a href="#l764">764</a><td> * {@code fn}, {@code onSuccess}, and {@code onFailure} are all called with<tr><td><a id="l765"></a><a href="#l765">765</a><td> * the TestCase instance as the method receiver.<tr><td><a id="l766"></a><a href="#l766">766</a><td> *<tr><td><a id="l767"></a><a href="#l767">767</a><td> * @param {function()} fn The function to call.<tr><td><a id="l768"></a><a href="#l768">768</a><td> * @param {function()} onSuccess Success callback.<tr><td><a id="l769"></a><a href="#l769">769</a><td> * @param {function(*)} onFailure Failure callback.<tr><td><a id="l770"></a><a href="#l770">770</a><td> * @param {string} fnName Name of the function being invoked e.g. &#39;setUp&#39;.<tr><td><a id="l771"></a><a href="#l771">771</a><td> * @private<tr><td><a id="l772"></a><a href="#l772">772</a><td> */<tr><td><a id="l773"></a><a href="#l773">773</a><td>goog.testing.TestCase.prototype.invokeTestFunction_ = function(<tr><td><a id="l774"></a><a href="#l774">774</a><td>    fn, onSuccess, onFailure, fnName) {<tr><td><a id="l775"></a><a href="#l775">775</a><td>  try {<tr><td><a id="l776"></a><a href="#l776">776</a><td>    var retval = fn.call(this);<tr><td><a id="l777"></a><a href="#l777">777</a><td>    if (goog.Thenable.isImplementedBy(retval) ||<tr><td><a id="l778"></a><a href="#l778">778</a><td>        goog.isFunction(retval &amp;&amp; retval[&#39;then&#39;])) {<tr><td><a id="l779"></a><a href="#l779">779</a><td>      var self = this;<tr><td><a id="l780"></a><a href="#l780">780</a><td>      retval = this.rejectIfPromiseTimesOut_(<tr><td><a id="l781"></a><a href="#l781">781</a><td>          retval, self.promiseTimeout,<tr><td><a id="l782"></a><a href="#l782">782</a><td>          &#39;Timed out while waiting for a promise returned from &#39; + fnName +<tr><td><a id="l783"></a><a href="#l783">783</a><td>          &#39; to resolve. Set goog.testing.TestCase.getActiveTestCase()&#39; +<tr><td><a id="l784"></a><a href="#l784">784</a><td>          &#39;.promiseTimeout to adjust the timeout.&#39;);<tr><td><a id="l785"></a><a href="#l785">785</a><td>      retval.then(<tr><td><a id="l786"></a><a href="#l786">786</a><td>          function() {<tr><td><a id="l787"></a><a href="#l787">787</a><td>            self.resetBatchTimeAfterPromise_();<tr><td><a id="l788"></a><a href="#l788">788</a><td>            onSuccess.call(self);<tr><td><a id="l789"></a><a href="#l789">789</a><td>          },<tr><td><a id="l790"></a><a href="#l790">790</a><td>          function(e) {<tr><td><a id="l791"></a><a href="#l791">791</a><td>            self.resetBatchTimeAfterPromise_();<tr><td><a id="l792"></a><a href="#l792">792</a><td>            onFailure.call(self, e);<tr><td><a id="l793"></a><a href="#l793">793</a><td>          });<tr><td><a id="l794"></a><a href="#l794">794</a><td>    } else {<tr><td><a id="l795"></a><a href="#l795">795</a><td>      onSuccess.call(this);<tr><td><a id="l796"></a><a href="#l796">796</a><td>    }<tr><td><a id="l797"></a><a href="#l797">797</a><td>  } catch (e) {<tr><td><a id="l798"></a><a href="#l798">798</a><td>    onFailure.call(this, e);<tr><td><a id="l799"></a><a href="#l799">799</a><td>  }<tr><td><a id="l800"></a><a href="#l800">800</a><td>};<tr><td><a id="l801"></a><a href="#l801">801</a><td><tr><td><a id="l802"></a><a href="#l802">802</a><td><tr><td><a id="l803"></a><a href="#l803">803</a><td>/**<tr><td><a id="l804"></a><a href="#l804">804</a><td> * Resets the batch run timer. This should only be called after resolving a<tr><td><a id="l805"></a><a href="#l805">805</a><td> * promise since Promise.then() has an implicit yield.<tr><td><a id="l806"></a><a href="#l806">806</a><td> * @private<tr><td><a id="l807"></a><a href="#l807">807</a><td> */<tr><td><a id="l808"></a><a href="#l808">808</a><td>goog.testing.TestCase.prototype.resetBatchTimeAfterPromise_ = function() {<tr><td><a id="l809"></a><a href="#l809">809</a><td>  this.batchTime_ = this.now();<tr><td><a id="l810"></a><a href="#l810">810</a><td>};<tr><td><a id="l811"></a><a href="#l811">811</a><td><tr><td><a id="l812"></a><a href="#l812">812</a><td><tr><td><a id="l813"></a><a href="#l813">813</a><td>/**<tr><td><a id="l814"></a><a href="#l814">814</a><td> * Finishes up bookkeeping for the current test function, and schedules<tr><td><a id="l815"></a><a href="#l815">815</a><td> * the next test function to run, either immediately or asychronously.<tr><td><a id="l816"></a><a href="#l816">816</a><td> * @param {*=} opt_error Optional error resulting from the test invocation.<tr><td><a id="l817"></a><a href="#l817">817</a><td> * @private<tr><td><a id="l818"></a><a href="#l818">818</a><td> */<tr><td><a id="l819"></a><a href="#l819">819</a><td>goog.testing.TestCase.prototype.finishTestInvocation_ = function(opt_error) {<tr><td><a id="l820"></a><a href="#l820">820</a><td>  if (arguments.length == 1) {<tr><td><a id="l821"></a><a href="#l821">821</a><td>    this.doError(this.curTest_, opt_error);<tr><td><a id="l822"></a><a href="#l822">822</a><td>  }<tr><td><a id="l823"></a><a href="#l823">823</a><td><tr><td><a id="l824"></a><a href="#l824">824</a><td>  // If no errors have been recorded for the test, it is a success.<tr><td><a id="l825"></a><a href="#l825">825</a><td>  if (!(this.curTest_.name in this.result_.resultsByName) ||<tr><td><a id="l826"></a><a href="#l826">826</a><td>      !this.result_.resultsByName[this.curTest_.name].length) {<tr><td><a id="l827"></a><a href="#l827">827</a><td>    this.doSuccess(this.curTest_);<tr><td><a id="l828"></a><a href="#l828">828</a><td>  }<tr><td><a id="l829"></a><a href="#l829">829</a><td><tr><td><a id="l830"></a><a href="#l830">830</a><td>  goog.testing.TestCase.currentTestName = null;<tr><td><a id="l831"></a><a href="#l831">831</a><td><tr><td><a id="l832"></a><a href="#l832">832</a><td>  // If the test case has consumed too much time or stack space,<tr><td><a id="l833"></a><a href="#l833">833</a><td>  // yield to avoid blocking the browser. Otherwise, proceed to the next test.<tr><td><a id="l834"></a><a href="#l834">834</a><td>  if (this.depth_ &gt; goog.testing.TestCase.MAX_STACK_DEPTH_ ||<tr><td><a id="l835"></a><a href="#l835">835</a><td>      this.now() - this.batchTime_ &gt; goog.testing.TestCase.maxRunTime) {<tr><td><a id="l836"></a><a href="#l836">836</a><td>    this.saveMessage(&#39;Breaking async&#39;);<tr><td><a id="l837"></a><a href="#l837">837</a><td>    this.timeout(goog.bind(this.startNextBatch_, this), 0);<tr><td><a id="l838"></a><a href="#l838">838</a><td>  } else {<tr><td><a id="l839"></a><a href="#l839">839</a><td>    ++this.depth_;<tr><td><a id="l840"></a><a href="#l840">840</a><td>    this.runNextTest_();<tr><td><a id="l841"></a><a href="#l841">841</a><td>  }<tr><td><a id="l842"></a><a href="#l842">842</a><td>};<tr><td><a id="l843"></a><a href="#l843">843</a><td><tr><td><a id="l844"></a><a href="#l844">844</a><td><tr><td><a id="l845"></a><a href="#l845">845</a><td>/**<tr><td><a id="l846"></a><a href="#l846">846</a><td> * Start a new batch to tests after yielding, resetting batchTime and depth.<tr><td><a id="l847"></a><a href="#l847">847</a><td> * @private<tr><td><a id="l848"></a><a href="#l848">848</a><td> */<tr><td><a id="l849"></a><a href="#l849">849</a><td>goog.testing.TestCase.prototype.startNextBatch_ = function() {<tr><td><a id="l850"></a><a href="#l850">850</a><td>  this.batchTime_ = this.now();<tr><td><a id="l851"></a><a href="#l851">851</a><td>  this.depth_ = 0;<tr><td><a id="l852"></a><a href="#l852">852</a><td>  this.runNextTest_();<tr><td><a id="l853"></a><a href="#l853">853</a><td>};<tr><td><a id="l854"></a><a href="#l854">854</a><td><tr><td><a id="l855"></a><a href="#l855">855</a><td><tr><td><a id="l856"></a><a href="#l856">856</a><td>/**<tr><td><a id="l857"></a><a href="#l857">857</a><td> * Reorders the tests depending on the {@code order} field.<tr><td><a id="l858"></a><a href="#l858">858</a><td> * @private<tr><td><a id="l859"></a><a href="#l859">859</a><td> */<tr><td><a id="l860"></a><a href="#l860">860</a><td>goog.testing.TestCase.prototype.orderTests_ = function() {<tr><td><a id="l861"></a><a href="#l861">861</a><td>  switch (this.order) {<tr><td><a id="l862"></a><a href="#l862">862</a><td>    case goog.testing.TestCase.Order.RANDOM:<tr><td><a id="l863"></a><a href="#l863">863</a><td>      // Fisher-Yates shuffle<tr><td><a id="l864"></a><a href="#l864">864</a><td>      var i = this.tests_.length;<tr><td><a id="l865"></a><a href="#l865">865</a><td>      while (i &gt; 1) {<tr><td><a id="l866"></a><a href="#l866">866</a><td>        // goog.math.randomInt is inlined to reduce dependencies.<tr><td><a id="l867"></a><a href="#l867">867</a><td>        var j = Math.floor(Math.random() * i); // exclusive<tr><td><a id="l868"></a><a href="#l868">868</a><td>        i--;<tr><td><a id="l869"></a><a href="#l869">869</a><td>        var tmp = this.tests_[i];<tr><td><a id="l870"></a><a href="#l870">870</a><td>        this.tests_[i] = this.tests_[j];<tr><td><a id="l871"></a><a href="#l871">871</a><td>        this.tests_[j] = tmp;<tr><td><a id="l872"></a><a href="#l872">872</a><td>      }<tr><td><a id="l873"></a><a href="#l873">873</a><td>      break;<tr><td><a id="l874"></a><a href="#l874">874</a><td><tr><td><a id="l875"></a><a href="#l875">875</a><td>    case goog.testing.TestCase.Order.SORTED:<tr><td><a id="l876"></a><a href="#l876">876</a><td>      this.tests_.sort(function(t1, t2) {<tr><td><a id="l877"></a><a href="#l877">877</a><td>        if (t1.name == t2.name) {<tr><td><a id="l878"></a><a href="#l878">878</a><td>          return 0;<tr><td><a id="l879"></a><a href="#l879">879</a><td>        }<tr><td><a id="l880"></a><a href="#l880">880</a><td>        return t1.name &lt; t2.name ? -1 : 1;<tr><td><a id="l881"></a><a href="#l881">881</a><td>      });<tr><td><a id="l882"></a><a href="#l882">882</a><td>      break;<tr><td><a id="l883"></a><a href="#l883">883</a><td><tr><td><a id="l884"></a><a href="#l884">884</a><td>      // Do nothing for NATURAL.<tr><td><a id="l885"></a><a href="#l885">885</a><td>  }<tr><td><a id="l886"></a><a href="#l886">886</a><td>};<tr><td><a id="l887"></a><a href="#l887">887</a><td><tr><td><a id="l888"></a><a href="#l888">888</a><td><tr><td><a id="l889"></a><a href="#l889">889</a><td>/**<tr><td><a id="l890"></a><a href="#l890">890</a><td> * Gets list of objects that potentially contain test cases. For IE 8 and below,<tr><td><a id="l891"></a><a href="#l891">891</a><td> * this is the global &quot;this&quot; (for properties set directly on the global this or<tr><td><a id="l892"></a><a href="#l892">892</a><td> * window) and the RuntimeObject (for global variables and functions). For all<tr><td><a id="l893"></a><a href="#l893">893</a><td> * other browsers, the array simply contains the global this.<tr><td><a id="l894"></a><a href="#l894">894</a><td> *<tr><td><a id="l895"></a><a href="#l895">895</a><td> * @param {string=} opt_prefix An optional prefix. If specified, only get things<tr><td><a id="l896"></a><a href="#l896">896</a><td> *     under this prefix. Note that the prefix is only honored in IE, since it<tr><td><a id="l897"></a><a href="#l897">897</a><td> *     supports the RuntimeObject:<tr><td><a id="l898"></a><a href="#l898">898</a><td> *     http://msdn.microsoft.com/en-us/library/ff521039%28VS.85%29.aspx<tr><td><a id="l899"></a><a href="#l899">899</a><td> *     TODO: Remove this option.<tr><td><a id="l900"></a><a href="#l900">900</a><td> * @return {!Array&lt;!Object&gt;} A list of objects that should be inspected.<tr><td><a id="l901"></a><a href="#l901">901</a><td> */<tr><td><a id="l902"></a><a href="#l902">902</a><td>goog.testing.TestCase.prototype.getGlobals = function(opt_prefix) {<tr><td><a id="l903"></a><a href="#l903">903</a><td>  return goog.testing.TestCase.getGlobals(opt_prefix);<tr><td><a id="l904"></a><a href="#l904">904</a><td>};<tr><td><a id="l905"></a><a href="#l905">905</a><td><tr><td><a id="l906"></a><a href="#l906">906</a><td><tr><td><a id="l907"></a><a href="#l907">907</a><td>/**<tr><td><a id="l908"></a><a href="#l908">908</a><td> * Gets list of objects that potentially contain test cases. For IE 8 and below,<tr><td><a id="l909"></a><a href="#l909">909</a><td> * this is the global &quot;this&quot; (for properties set directly on the global this or<tr><td><a id="l910"></a><a href="#l910">910</a><td> * window) and the RuntimeObject (for global variables and functions). For all<tr><td><a id="l911"></a><a href="#l911">911</a><td> * other browsers, the array simply contains the global this.<tr><td><a id="l912"></a><a href="#l912">912</a><td> *<tr><td><a id="l913"></a><a href="#l913">913</a><td> * @param {string=} opt_prefix An optional prefix. If specified, only get things<tr><td><a id="l914"></a><a href="#l914">914</a><td> *     under this prefix. Note that the prefix is only honored in IE, since it<tr><td><a id="l915"></a><a href="#l915">915</a><td> *     supports the RuntimeObject:<tr><td><a id="l916"></a><a href="#l916">916</a><td> *     http://msdn.microsoft.com/en-us/library/ff521039%28VS.85%29.aspx<tr><td><a id="l917"></a><a href="#l917">917</a><td> *     TODO: Remove this option.<tr><td><a id="l918"></a><a href="#l918">918</a><td> * @return {!Array&lt;!Object&gt;} A list of objects that should be inspected.<tr><td><a id="l919"></a><a href="#l919">919</a><td> */<tr><td><a id="l920"></a><a href="#l920">920</a><td>goog.testing.TestCase.getGlobals = function(opt_prefix) {<tr><td><a id="l921"></a><a href="#l921">921</a><td>  // Look in the global scope for most browsers, on IE we use the little known<tr><td><a id="l922"></a><a href="#l922">922</a><td>  // RuntimeObject which holds references to all globals. We reference this<tr><td><a id="l923"></a><a href="#l923">923</a><td>  // via goog.global so that there isn&#39;t an aliasing that throws an exception<tr><td><a id="l924"></a><a href="#l924">924</a><td>  // in Firefox.<tr><td><a id="l925"></a><a href="#l925">925</a><td>  return typeof goog.global[&#39;RuntimeObject&#39;] != &#39;undefined&#39; ?<tr><td><a id="l926"></a><a href="#l926">926</a><td>      [goog.global[&#39;RuntimeObject&#39;]((opt_prefix || &#39;&#39;) + &#39;*&#39;), goog.global] :<tr><td><a id="l927"></a><a href="#l927">927</a><td>      [goog.global];<tr><td><a id="l928"></a><a href="#l928">928</a><td>};<tr><td><a id="l929"></a><a href="#l929">929</a><td><tr><td><a id="l930"></a><a href="#l930">930</a><td><tr><td><a id="l931"></a><a href="#l931">931</a><td>/**<tr><td><a id="l932"></a><a href="#l932">932</a><td> * @return {?goog.testing.TestCase} currently active test case or null if not<tr><td><a id="l933"></a><a href="#l933">933</a><td> *     test is currently running.<tr><td><a id="l934"></a><a href="#l934">934</a><td> */<tr><td><a id="l935"></a><a href="#l935">935</a><td>goog.testing.TestCase.getActiveTestCase = function() {<tr><td><a id="l936"></a><a href="#l936">936</a><td>  var gTestRunner = goog.global[&#39;G_testRunner&#39;];<tr><td><a id="l937"></a><a href="#l937">937</a><td>  if (gTestRunner &amp;&amp; gTestRunner.testCase) {<tr><td><a id="l938"></a><a href="#l938">938</a><td>    return gTestRunner.testCase;<tr><td><a id="l939"></a><a href="#l939">939</a><td>  } else {<tr><td><a id="l940"></a><a href="#l940">940</a><td>    return null;<tr><td><a id="l941"></a><a href="#l941">941</a><td>  }<tr><td><a id="l942"></a><a href="#l942">942</a><td>};<tr><td><a id="l943"></a><a href="#l943">943</a><td><tr><td><a id="l944"></a><a href="#l944">944</a><td><tr><td><a id="l945"></a><a href="#l945">945</a><td>/**<tr><td><a id="l946"></a><a href="#l946">946</a><td> * Gets called before any tests are executed.  Can be overridden to set up the<tr><td><a id="l947"></a><a href="#l947">947</a><td> * environment for the whole test case.<tr><td><a id="l948"></a><a href="#l948">948</a><td> */<tr><td><a id="l949"></a><a href="#l949">949</a><td>goog.testing.TestCase.prototype.setUpPage = function() {};<tr><td><a id="l950"></a><a href="#l950">950</a><td><tr><td><a id="l951"></a><a href="#l951">951</a><td><tr><td><a id="l952"></a><a href="#l952">952</a><td>/**<tr><td><a id="l953"></a><a href="#l953">953</a><td> * Gets called after all tests have been executed.  Can be overridden to tear<tr><td><a id="l954"></a><a href="#l954">954</a><td> * down the entire test case.<tr><td><a id="l955"></a><a href="#l955">955</a><td> */<tr><td><a id="l956"></a><a href="#l956">956</a><td>goog.testing.TestCase.prototype.tearDownPage = function() {};<tr><td><a id="l957"></a><a href="#l957">957</a><td><tr><td><a id="l958"></a><a href="#l958">958</a><td><tr><td><a id="l959"></a><a href="#l959">959</a><td>/**<tr><td><a id="l960"></a><a href="#l960">960</a><td> * Gets called before every goog.testing.TestCase.Test is been executed. Can be<tr><td><a id="l961"></a><a href="#l961">961</a><td> * overridden to add set up functionality to each test.<tr><td><a id="l962"></a><a href="#l962">962</a><td> */<tr><td><a id="l963"></a><a href="#l963">963</a><td>goog.testing.TestCase.prototype.setUp = function() {};<tr><td><a id="l964"></a><a href="#l964">964</a><td><tr><td><a id="l965"></a><a href="#l965">965</a><td><tr><td><a id="l966"></a><a href="#l966">966</a><td>/**<tr><td><a id="l967"></a><a href="#l967">967</a><td> * Gets called after every goog.testing.TestCase.Test has been executed. Can be<tr><td><a id="l968"></a><a href="#l968">968</a><td> * overriden to add tear down functionality to each test.<tr><td><a id="l969"></a><a href="#l969">969</a><td> */<tr><td><a id="l970"></a><a href="#l970">970</a><td>goog.testing.TestCase.prototype.tearDown = function() {};<tr><td><a id="l971"></a><a href="#l971">971</a><td><tr><td><a id="l972"></a><a href="#l972">972</a><td><tr><td><a id="l973"></a><a href="#l973">973</a><td>/**<tr><td><a id="l974"></a><a href="#l974">974</a><td> * @return {string} The function name prefix used to auto-discover tests.<tr><td><a id="l975"></a><a href="#l975">975</a><td> */<tr><td><a id="l976"></a><a href="#l976">976</a><td>goog.testing.TestCase.prototype.getAutoDiscoveryPrefix = function() {<tr><td><a id="l977"></a><a href="#l977">977</a><td>  return &#39;test&#39;;<tr><td><a id="l978"></a><a href="#l978">978</a><td>};<tr><td><a id="l979"></a><a href="#l979">979</a><td><tr><td><a id="l980"></a><a href="#l980">980</a><td><tr><td><a id="l981"></a><a href="#l981">981</a><td>/**<tr><td><a id="l982"></a><a href="#l982">982</a><td> * @return {number} Time since the last batch of tests was started.<tr><td><a id="l983"></a><a href="#l983">983</a><td> * @protected<tr><td><a id="l984"></a><a href="#l984">984</a><td> */<tr><td><a id="l985"></a><a href="#l985">985</a><td>goog.testing.TestCase.prototype.getBatchTime = function() {<tr><td><a id="l986"></a><a href="#l986">986</a><td>  return this.batchTime_;<tr><td><a id="l987"></a><a href="#l987">987</a><td>};<tr><td><a id="l988"></a><a href="#l988">988</a><td><tr><td><a id="l989"></a><a href="#l989">989</a><td><tr><td><a id="l990"></a><a href="#l990">990</a><td>/**<tr><td><a id="l991"></a><a href="#l991">991</a><td> * @param {number} batchTime Time since the last batch of tests was started.<tr><td><a id="l992"></a><a href="#l992">992</a><td> * @protected<tr><td><a id="l993"></a><a href="#l993">993</a><td> */<tr><td><a id="l994"></a><a href="#l994">994</a><td>goog.testing.TestCase.prototype.setBatchTime = function(batchTime) {<tr><td><a id="l995"></a><a href="#l995">995</a><td>  this.batchTime_ = batchTime;<tr><td><a id="l996"></a><a href="#l996">996</a><td>};<tr><td><a id="l997"></a><a href="#l997">997</a><td><tr><td><a id="l998"></a><a href="#l998">998</a><td><tr><td><a id="l999"></a><a href="#l999">999</a><td>/**<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td> * Creates a {@code goog.testing.TestCase.Test} from an auto-discovered<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td> *     function.<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td> * @param {string} name The name of the function.<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td> * @param {function() : void} ref The auto-discovered function.<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td> * @return {!goog.testing.TestCase.Test} The newly created test.<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td> * @protected<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td> */<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>goog.testing.TestCase.prototype.createTestFromAutoDiscoveredFunction =<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td>    function(name, ref) {<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td>  return new goog.testing.TestCase.Test(name, ref, goog.global);<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td>};<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td><tr><td><a id="l1012"></a><a href="#l1012">1012</a><td><tr><td><a id="l1013"></a><a href="#l1013">1013</a><td>/**<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td> * Adds any functions defined on &#39;obj&#39; (the global object, by default)<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td> * that correspond to lifecycle events for the test case. Overrides<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td> * setUp, tearDown, setUpPage, tearDownPage, runTests, and shouldRunTests<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td> * if they are defined on &#39;obj&#39;.<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td> * @param {!Object=} opt_obj Defaults to goog.global.<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td> */<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td>goog.testing.TestCase.prototype.autoDiscoverLifecycle = function(opt_obj) {<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>  var obj = opt_obj || goog.global;<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td>  if (obj[&#39;setUp&#39;]) {<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td>    this.setUp = goog.bind(obj[&#39;setUp&#39;], obj);<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td>  }<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td>  if (obj[&#39;tearDown&#39;]) {<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>    this.tearDown = goog.bind(obj[&#39;tearDown&#39;], obj);<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>  }<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>  if (obj[&#39;setUpPage&#39;]) {<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td>    this.setUpPage = goog.bind(obj[&#39;setUpPage&#39;], obj);<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>  }<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td>  if (obj[&#39;tearDownPage&#39;]) {<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td>    this.tearDownPage = goog.bind(obj[&#39;tearDownPage&#39;], obj);<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>  }<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>  if (obj[&#39;runTests&#39;]) {<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>    this.runTests = goog.bind(obj[&#39;runTests&#39;], obj);<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>  }<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td>  if (obj[&#39;shouldRunTests&#39;]) {<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td>    this.shouldRunTests = goog.bind(obj[&#39;shouldRunTests&#39;], obj);<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>  }<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>};<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td><tr><td><a id="l1042"></a><a href="#l1042">1042</a><td><tr><td><a id="l1043"></a><a href="#l1043">1043</a><td>// TODO(johnlenz): make this package private<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>/**<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td> * @param {!Object} obj  An object from which to extract test and lifecycle<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td> * methods.<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td> */<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>goog.testing.TestCase.prototype.setTestObj = function(obj) {<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td>  // Drop any previously added (likely auto-discovered) tests, only one source<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>  // of discovered test and life-cycle methods is allowed.<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td>  goog.asserts.assert(this.tests_.length == 0,<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td>      &#39;Test methods have already been configured.&#39;);<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td><tr><td><a id="l1054"></a><a href="#l1054">1054</a><td>  var regex = new RegExp(&#39;^&#39; + this.getAutoDiscoveryPrefix());<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td>  for (var name in obj) {<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td>    if (regex.test(name)) {<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td>      var testMethod = obj[name];<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td>      if (goog.isFunction(testMethod)) {<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td>        this.addNewTest(name, testMethod, obj);<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td>      }<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td>    }<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td>  }<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td><tr><td><a id="l1064"></a><a href="#l1064">1064</a><td>  this.autoDiscoverLifecycle(obj);<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td>};<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td><tr><td><a id="l1067"></a><a href="#l1067">1067</a><td><tr><td><a id="l1068"></a><a href="#l1068">1068</a><td>/**<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td> * Adds any functions defined in the global scope that are prefixed with &quot;test&quot;<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td> * to the test case.<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td> */<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td>goog.testing.TestCase.prototype.autoDiscoverTests = function() {<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td>  var prefix = this.getAutoDiscoveryPrefix();<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>  var testSources = this.getGlobals(prefix);<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td><tr><td><a id="l1076"></a><a href="#l1076">1076</a><td>  var foundTests = [];<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td><tr><td><a id="l1078"></a><a href="#l1078">1078</a><td>  for (var i = 0; i &lt; testSources.length; i++) {<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td>    var testSource = testSources[i];<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>    for (var name in testSource) {<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td>      if ((new RegExp(&#39;^&#39; + prefix)).test(name)) {<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td>        var ref;<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>        try {<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td>          ref = testSource[name];<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td>        } catch (ex) {<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td>          // NOTE(brenneman): When running tests from a file:// URL on Firefox<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>          // 3.5 for Windows, any reference to goog.global.sessionStorage raises<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>          // an &quot;Operation is not supported&quot; exception. Ignore any exceptions<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>          // raised by simply accessing global properties.<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>          ref = undefined;<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td>        }<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td><tr><td><a id="l1093"></a><a href="#l1093">1093</a><td>        if (goog.isFunction(ref)) {<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td>          foundTests.push(this.createTestFromAutoDiscoveredFunction(name, ref));<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td>        }<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td>      }<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>    }<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td>  }<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td><tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>  for (var i = 0; i &lt; foundTests.length; i++) {<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td>    this.add(foundTests[i]);<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td>  }<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td>  this.orderTests_();<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td><tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>  this.log(this.getCount() + &#39; tests auto-discovered&#39;);<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td><tr><td><a id="l1107"></a><a href="#l1107">1107</a><td>  // TODO(user): Do this as a separate call. Unfortunately, a lot of projects<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td>  // currently override autoDiscoverTests and expect lifecycle events to be<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td>  // registered as a part of this call.<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td>  this.autoDiscoverLifecycle();<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td>};<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td><tr><td><a id="l1113"></a><a href="#l1113">1113</a><td><tr><td><a id="l1114"></a><a href="#l1114">1114</a><td>/**<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td> * Checks to see if the test should be marked as failed before it is run.<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td> *<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td> * If there was an error in setUpPage, we treat that as a failure for all tests<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td> * and mark them all as having failed.<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td> *<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td> * @param {goog.testing.TestCase.Test} testCase The current test case.<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td> * @return {boolean} Whether the test was marked as failed.<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td> * @protected<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td> */<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td>goog.testing.TestCase.prototype.maybeFailTestEarly = function(testCase) {<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td>  if (this.exceptionBeforeTest) {<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td>    // We just use the first error to report an error on a failed test.<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td>    testCase.name = &#39;setUpPage for &#39; + testCase.name;<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td>    this.doError(testCase, this.exceptionBeforeTest);<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td>    return true;<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td>  }<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td>  return false;<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td>};<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td><tr><td><a id="l1134"></a><a href="#l1134">1134</a><td><tr><td><a id="l1135"></a><a href="#l1135">1135</a><td>/**<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td> * Cycles through the tests, yielding asynchronously if the execution time<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td> * execeeds {@link #maxRunTime}. In particular, there is no guarantee that<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td> * the test case has finished execution once this method has returned.<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td> * To be notified when the test case has finished execution, use<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td> * {@link #setCompletedCallback} or {@link #runTestsReturningPromise}.<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td> */<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>goog.testing.TestCase.prototype.cycleTests = function() {<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>  this.saveMessage(&#39;Start&#39;);<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td>  this.batchTime_ = this.now();<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>  if (this.running) {<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>    this.runNextTestCallback_ = goog.nullFunction;<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td>    // Kick off the tests. runNextTest_ will schedule all of the tests,<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td>    // using a mixture of synchronous and asynchronous strategies.<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td>    this.runNextTest_();<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>  }<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td>};<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td><tr><td><a id="l1153"></a><a href="#l1153">1153</a><td><tr><td><a id="l1154"></a><a href="#l1154">1154</a><td>/**<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td> * Counts the number of files that were loaded for dependencies that are<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td> * required to run the test.<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td> * @return {number} The number of files loaded.<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td> * @private<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td> */<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td>goog.testing.TestCase.prototype.countNumFilesLoaded_ = function() {<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td>  var scripts = document.getElementsByTagName(goog.dom.TagName.SCRIPT);<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td>  var count = 0;<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td>  for (var i = 0, n = scripts.length; i &lt; n; i++) {<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td>    if (scripts[i].src) {<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>      count++;<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td>    }<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>  }<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td>  return count;<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td>};<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td><tr><td><a id="l1171"></a><a href="#l1171">1171</a><td><tr><td><a id="l1172"></a><a href="#l1172">1172</a><td>/**<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td> * Calls a function after a delay, using the protected timeout.<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td> * @param {Function} fn The function to call.<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td> * @param {number} time Delay in milliseconds.<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td> * @return {number} The timeout id.<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td> * @protected<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td> */<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td>goog.testing.TestCase.prototype.timeout = function(fn, time) {<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td>  // NOTE: invoking protectedSetTimeout_ as a member of goog.testing.TestCase<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td>  // would result in an Illegal Invocation error. The method must be executed<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td>  // with the global context.<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td>  var protectedSetTimeout = goog.testing.TestCase.protectedSetTimeout_;<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td>  return protectedSetTimeout(fn, time);<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td>};<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td><tr><td><a id="l1187"></a><a href="#l1187">1187</a><td><tr><td><a id="l1188"></a><a href="#l1188">1188</a><td>/**<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td> * Clears a timeout created by {@code this.timeout()}.<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td> * @param {number} id A timeout id.<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td> * @protected<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td> */<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>goog.testing.TestCase.prototype.clearTimeout = function(id) {<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td>  // NOTE: see execution note for protectedSetTimeout above.<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>  var protectedClearTimeout = goog.testing.TestCase.protectedClearTimeout_;<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td>  protectedClearTimeout(id);<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td>};<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td><tr><td><a id="l1199"></a><a href="#l1199">1199</a><td><tr><td><a id="l1200"></a><a href="#l1200">1200</a><td>/**<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td> * @return {number} The current time in milliseconds, don&#39;t use goog.now as some<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td> *     tests override it.<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td> * @protected<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td> */<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td>goog.testing.TestCase.prototype.now = function() {<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td>  // Cannot use &quot;new goog.testing.TestCase.protectedDate_()&quot; due to b/8323223.<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td>  var protectedDate = goog.testing.TestCase.protectedDate_;<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td>  return new protectedDate().getTime();<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td>};<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td><tr><td><a id="l1211"></a><a href="#l1211">1211</a><td><tr><td><a id="l1212"></a><a href="#l1212">1212</a><td>/**<tr><td><a id="l1213"></a><a href="#l1213">1213</a><td> * Returns the current time.<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td> * @return {string} HH:MM:SS.<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td> * @private<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td> */<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td>goog.testing.TestCase.prototype.getTimeStamp_ = function() {<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td>  // Cannot use &quot;new goog.testing.TestCase.protectedDate_()&quot; due to b/8323223.<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td>  var protectedDate = goog.testing.TestCase.protectedDate_;<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td>  var d = new protectedDate();<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td><tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>  // Ensure millis are always 3-digits<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>  var millis = &#39;00&#39; + d.getMilliseconds();<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td>  millis = millis.substr(millis.length - 3);<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td><tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>  return this.pad_(d.getHours()) + &#39;:&#39; + this.pad_(d.getMinutes()) + &#39;:&#39; +<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td>         this.pad_(d.getSeconds()) + &#39;.&#39; + millis;<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td>};<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td><tr><td><a id="l1230"></a><a href="#l1230">1230</a><td><tr><td><a id="l1231"></a><a href="#l1231">1231</a><td>/**<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td> * Pads a number to make it have a leading zero if it&#39;s less than 10.<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td> * @param {number} number The number to pad.<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td> * @return {string} The resulting string.<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td> * @private<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td> */<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td>goog.testing.TestCase.prototype.pad_ = function(number) {<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td>  return number &lt; 10 ? &#39;0&#39; + number : String(number);<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>};<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td><tr><td><a id="l1241"></a><a href="#l1241">1241</a><td><tr><td><a id="l1242"></a><a href="#l1242">1242</a><td>/**<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td> * Trims a path to be only that after google3.<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td> * @param {string} path The path to trim.<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td> * @return {string} The resulting string.<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td> * @private<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td> */<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>goog.testing.TestCase.prototype.trimPath_ = function(path) {<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>  return path.substring(path.indexOf(&#39;google3&#39;) + 8);<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>};<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td><tr><td><a id="l1252"></a><a href="#l1252">1252</a><td><tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>/**<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td> * Handles a test that passed.<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td> * @param {goog.testing.TestCase.Test} test The test that passed.<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td> * @protected<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td> */<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td>goog.testing.TestCase.prototype.doSuccess = function(test) {<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td>  this.result_.successCount++;<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td>  // An empty list of error messages indicates that the test passed.<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td>  // If we already have a failure for this test, do not set to empty list.<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td>  if (!(test.name in this.result_.resultsByName)) {<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td>    this.result_.resultsByName[test.name] = [];<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>  }<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>  var message = test.name + &#39; : PASSED&#39;;<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>  this.saveMessage(message);<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>  this.log(message);<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td>};<tr><td><a id="l1269"></a><a href="#l1269">1269</a><td><tr><td><a id="l1270"></a><a href="#l1270">1270</a><td><tr><td><a id="l1271"></a><a href="#l1271">1271</a><td>/**<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td> * Handles a test that failed.<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td> * @param {goog.testing.TestCase.Test} test The test that failed.<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td> * @param {*=} opt_e The exception object associated with the<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td> *     failure or a string.<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td> * @protected<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td> */<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>goog.testing.TestCase.prototype.doError = function(test, opt_e) {<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>  var message = test.name + &#39; : FAILED&#39;;<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td>  this.log(message);<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>  this.saveMessage(message);<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>  var err = this.logError(test.name, opt_e);<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>  this.result_.errors.push(err);<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>  if (test.name in this.result_.resultsByName) {<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>    this.result_.resultsByName[test.name].push(err.toString());<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>  } else {<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>    this.result_.resultsByName[test.name] = [err.toString()];<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td>  }<tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>};<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td><tr><td><a id="l1291"></a><a href="#l1291">1291</a><td><tr><td><a id="l1292"></a><a href="#l1292">1292</a><td>/**<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td> * @param {string} name Failed test name.<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td> * @param {*=} opt_e The exception object associated with the<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td> *     failure or a string.<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td> * @return {!goog.testing.TestCase.Error} Error object.<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td> */<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td>goog.testing.TestCase.prototype.logError = function(name, opt_e) {<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td>  var errMsg = null;<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td>  var stack = null;<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>  if (opt_e) {<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td>    this.log(opt_e);<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td>    if (goog.isString(opt_e)) {<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>      errMsg = opt_e;<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td>    } else {<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td>      errMsg = opt_e.message || opt_e.description || opt_e.toString();<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td>      stack = opt_e.stack ? goog.testing.stacktrace.canonicalize(opt_e.stack) :<tr><td><a id="l1308"></a><a href="#l1308">1308</a><td>          opt_e[&#39;stackTrace&#39;];<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td>    }<tr><td><a id="l1310"></a><a href="#l1310">1310</a><td>  } else {<tr><td><a id="l1311"></a><a href="#l1311">1311</a><td>    errMsg = &#39;An unknown error occurred&#39;;<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td>  }<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td>  var err = new goog.testing.TestCase.Error(name, errMsg, stack);<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td><tr><td><a id="l1315"></a><a href="#l1315">1315</a><td>  // Avoid double logging.<tr><td><a id="l1316"></a><a href="#l1316">1316</a><td>  if (!opt_e || !opt_e[&#39;isJsUnitException&#39;] ||<tr><td><a id="l1317"></a><a href="#l1317">1317</a><td>      !opt_e[&#39;loggedJsUnitException&#39;]) {<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td>    this.saveMessage(err.toString());<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td>  }<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td>  if (opt_e &amp;&amp; opt_e[&#39;isJsUnitException&#39;]) {<tr><td><a id="l1321"></a><a href="#l1321">1321</a><td>    opt_e[&#39;loggedJsUnitException&#39;] = true;<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td>  }<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td><tr><td><a id="l1324"></a><a href="#l1324">1324</a><td>  return err;<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td>};<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td><tr><td><a id="l1327"></a><a href="#l1327">1327</a><td><tr><td><a id="l1328"></a><a href="#l1328">1328</a><td><tr><td><a id="l1329"></a><a href="#l1329">1329</a><td>/**<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td> * A class representing a single test function.<tr><td><a id="l1331"></a><a href="#l1331">1331</a><td> * @param {string} name The test name.<tr><td><a id="l1332"></a><a href="#l1332">1332</a><td> * @param {Function} ref Reference to the test function.<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td> * @param {Object=} opt_scope Optional scope that the test function should be<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td> *     called in.<tr><td><a id="l1335"></a><a href="#l1335">1335</a><td> * @constructor<tr><td><a id="l1336"></a><a href="#l1336">1336</a><td> */<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td>goog.testing.TestCase.Test = function(name, ref, opt_scope) {<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td>  /**<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td>   * The name of the test.<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td>   * @type {string}<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td>   */<tr><td><a id="l1342"></a><a href="#l1342">1342</a><td>  this.name = name;<tr><td><a id="l1343"></a><a href="#l1343">1343</a><td><tr><td><a id="l1344"></a><a href="#l1344">1344</a><td>  /**<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td>   * Reference to the test function.<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td>   * @type {Function}<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td>   */<tr><td><a id="l1348"></a><a href="#l1348">1348</a><td>  this.ref = ref;<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td><tr><td><a id="l1350"></a><a href="#l1350">1350</a><td>  /**<tr><td><a id="l1351"></a><a href="#l1351">1351</a><td>   * Scope that the test function should be called in.<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td>   * @type {Object}<tr><td><a id="l1353"></a><a href="#l1353">1353</a><td>   */<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td>  this.scope = opt_scope || null;<tr><td><a id="l1355"></a><a href="#l1355">1355</a><td>};<tr><td><a id="l1356"></a><a href="#l1356">1356</a><td><tr><td><a id="l1357"></a><a href="#l1357">1357</a><td><tr><td><a id="l1358"></a><a href="#l1358">1358</a><td>/**<tr><td><a id="l1359"></a><a href="#l1359">1359</a><td> * Executes the test function.<tr><td><a id="l1360"></a><a href="#l1360">1360</a><td> * @package<tr><td><a id="l1361"></a><a href="#l1361">1361</a><td> */<tr><td><a id="l1362"></a><a href="#l1362">1362</a><td>goog.testing.TestCase.Test.prototype.execute = function() {<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td>  this.ref.call(this.scope);<tr><td><a id="l1364"></a><a href="#l1364">1364</a><td>};<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td><tr><td><a id="l1366"></a><a href="#l1366">1366</a><td><tr><td><a id="l1367"></a><a href="#l1367">1367</a><td><tr><td><a id="l1368"></a><a href="#l1368">1368</a><td>/**<tr><td><a id="l1369"></a><a href="#l1369">1369</a><td> * A class for representing test results.  A bag of public properties.<tr><td><a id="l1370"></a><a href="#l1370">1370</a><td> * @param {goog.testing.TestCase} testCase The test case that owns this result.<tr><td><a id="l1371"></a><a href="#l1371">1371</a><td> * @constructor<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td> * @final<tr><td><a id="l1373"></a><a href="#l1373">1373</a><td> */<tr><td><a id="l1374"></a><a href="#l1374">1374</a><td>goog.testing.TestCase.Result = function(testCase) {<tr><td><a id="l1375"></a><a href="#l1375">1375</a><td>  /**<tr><td><a id="l1376"></a><a href="#l1376">1376</a><td>   * The test case that owns this result.<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td>   * @type {goog.testing.TestCase}<tr><td><a id="l1378"></a><a href="#l1378">1378</a><td>   * @private<tr><td><a id="l1379"></a><a href="#l1379">1379</a><td>   */<tr><td><a id="l1380"></a><a href="#l1380">1380</a><td>  this.testCase_ = testCase;<tr><td><a id="l1381"></a><a href="#l1381">1381</a><td><tr><td><a id="l1382"></a><a href="#l1382">1382</a><td>  /**<tr><td><a id="l1383"></a><a href="#l1383">1383</a><td>   * Total number of tests that should have been run.<tr><td><a id="l1384"></a><a href="#l1384">1384</a><td>   * @type {number}<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td>   */<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td>  this.totalCount = 0;<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td><tr><td><a id="l1388"></a><a href="#l1388">1388</a><td>  /**<tr><td><a id="l1389"></a><a href="#l1389">1389</a><td>   * Total number of tests that were actually run.<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td>   * @type {number}<tr><td><a id="l1391"></a><a href="#l1391">1391</a><td>   */<tr><td><a id="l1392"></a><a href="#l1392">1392</a><td>  this.runCount = 0;<tr><td><a id="l1393"></a><a href="#l1393">1393</a><td><tr><td><a id="l1394"></a><a href="#l1394">1394</a><td>  /**<tr><td><a id="l1395"></a><a href="#l1395">1395</a><td>   * Number of successful tests.<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td>   * @type {number}<tr><td><a id="l1397"></a><a href="#l1397">1397</a><td>   */<tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>  this.successCount = 0;<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td><tr><td><a id="l1400"></a><a href="#l1400">1400</a><td>  /**<tr><td><a id="l1401"></a><a href="#l1401">1401</a><td>   * The amount of time the tests took to run.<tr><td><a id="l1402"></a><a href="#l1402">1402</a><td>   * @type {number}<tr><td><a id="l1403"></a><a href="#l1403">1403</a><td>   */<tr><td><a id="l1404"></a><a href="#l1404">1404</a><td>  this.runTime = 0;<tr><td><a id="l1405"></a><a href="#l1405">1405</a><td><tr><td><a id="l1406"></a><a href="#l1406">1406</a><td>  /**<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td>   * The number of files loaded to run this test.<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td>   * @type {number}<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td>   */<tr><td><a id="l1410"></a><a href="#l1410">1410</a><td>  this.numFilesLoaded = 0;<tr><td><a id="l1411"></a><a href="#l1411">1411</a><td><tr><td><a id="l1412"></a><a href="#l1412">1412</a><td>  /**<tr><td><a id="l1413"></a><a href="#l1413">1413</a><td>   * Whether this test case was suppressed by shouldRunTests() returning false.<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td>   * @type {boolean}<tr><td><a id="l1415"></a><a href="#l1415">1415</a><td>   */<tr><td><a id="l1416"></a><a href="#l1416">1416</a><td>  this.testSuppressed = false;<tr><td><a id="l1417"></a><a href="#l1417">1417</a><td><tr><td><a id="l1418"></a><a href="#l1418">1418</a><td>  /**<tr><td><a id="l1419"></a><a href="#l1419">1419</a><td>   * Test results for each test that was run. The test name is always added<tr><td><a id="l1420"></a><a href="#l1420">1420</a><td>   * as the key in the map, and the array of strings is an optional list<tr><td><a id="l1421"></a><a href="#l1421">1421</a><td>   * of failure messages. If the array is empty, the test passed. Otherwise,<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td>   * the test failed.<tr><td><a id="l1423"></a><a href="#l1423">1423</a><td>   * @type {!Object&lt;string, !Array&lt;string&gt;&gt;}<tr><td><a id="l1424"></a><a href="#l1424">1424</a><td>   */<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td>  this.resultsByName = {};<tr><td><a id="l1426"></a><a href="#l1426">1426</a><td><tr><td><a id="l1427"></a><a href="#l1427">1427</a><td>  /**<tr><td><a id="l1428"></a><a href="#l1428">1428</a><td>   * Errors encountered while running the test.<tr><td><a id="l1429"></a><a href="#l1429">1429</a><td>   * @type {!Array&lt;goog.testing.TestCase.Error&gt;}<tr><td><a id="l1430"></a><a href="#l1430">1430</a><td>   */<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td>  this.errors = [];<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td><tr><td><a id="l1433"></a><a href="#l1433">1433</a><td>  /**<tr><td><a id="l1434"></a><a href="#l1434">1434</a><td>   * Messages to show the user after running the test.<tr><td><a id="l1435"></a><a href="#l1435">1435</a><td>   * @type {!Array&lt;string&gt;}<tr><td><a id="l1436"></a><a href="#l1436">1436</a><td>   */<tr><td><a id="l1437"></a><a href="#l1437">1437</a><td>  this.messages = [];<tr><td><a id="l1438"></a><a href="#l1438">1438</a><td><tr><td><a id="l1439"></a><a href="#l1439">1439</a><td>  /**<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td>   * Whether the tests have completed.<tr><td><a id="l1441"></a><a href="#l1441">1441</a><td>   * @type {boolean}<tr><td><a id="l1442"></a><a href="#l1442">1442</a><td>   */<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td>  this.complete = false;<tr><td><a id="l1444"></a><a href="#l1444">1444</a><td>};<tr><td><a id="l1445"></a><a href="#l1445">1445</a><td><tr><td><a id="l1446"></a><a href="#l1446">1446</a><td><tr><td><a id="l1447"></a><a href="#l1447">1447</a><td>/**<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td> * @return {boolean} Whether the test was successful.<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td> */<tr><td><a id="l1450"></a><a href="#l1450">1450</a><td>goog.testing.TestCase.Result.prototype.isSuccess = function() {<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td>  return this.complete &amp;&amp; this.errors.length == 0;<tr><td><a id="l1452"></a><a href="#l1452">1452</a><td>};<tr><td><a id="l1453"></a><a href="#l1453">1453</a><td><tr><td><a id="l1454"></a><a href="#l1454">1454</a><td><tr><td><a id="l1455"></a><a href="#l1455">1455</a><td>/**<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td> * @return {string} A summary of the tests, including total number of tests that<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td> *     passed, failed, and the time taken.<tr><td><a id="l1458"></a><a href="#l1458">1458</a><td> */<tr><td><a id="l1459"></a><a href="#l1459">1459</a><td>goog.testing.TestCase.Result.prototype.getSummary = function() {<tr><td><a id="l1460"></a><a href="#l1460">1460</a><td>  var summary = this.runCount + &#39; of &#39; + this.totalCount + &#39; tests run in &#39; +<tr><td><a id="l1461"></a><a href="#l1461">1461</a><td>      this.runTime + &#39;ms.\n&#39;;<tr><td><a id="l1462"></a><a href="#l1462">1462</a><td>  if (this.testSuppressed) {<tr><td><a id="l1463"></a><a href="#l1463">1463</a><td>    summary += &#39;Tests not run because shouldRunTests() returned false.&#39;;<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td>  } else {<tr><td><a id="l1465"></a><a href="#l1465">1465</a><td>    var failures = this.totalCount - this.successCount;<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td>    var suppressionMessage = &#39;&#39;;<tr><td><a id="l1467"></a><a href="#l1467">1467</a><td><tr><td><a id="l1468"></a><a href="#l1468">1468</a><td>    var countOfRunTests = this.testCase_.getActuallyRunCount();<tr><td><a id="l1469"></a><a href="#l1469">1469</a><td>    if (countOfRunTests) {<tr><td><a id="l1470"></a><a href="#l1470">1470</a><td>      failures = countOfRunTests - this.successCount;<tr><td><a id="l1471"></a><a href="#l1471">1471</a><td>      suppressionMessage = &#39;, &#39; +<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td>          (this.totalCount - countOfRunTests) + &#39; suppressed by querystring&#39;;<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td>    }<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td>    summary += this.successCount + &#39; passed, &#39; +<tr><td><a id="l1475"></a><a href="#l1475">1475</a><td>        failures + &#39; failed&#39; + suppressionMessage + &#39;.\n&#39; +<tr><td><a id="l1476"></a><a href="#l1476">1476</a><td>        Math.round(this.runTime / this.runCount) + &#39; ms/test. &#39; +<tr><td><a id="l1477"></a><a href="#l1477">1477</a><td>        this.numFilesLoaded + &#39; files loaded.&#39;;<tr><td><a id="l1478"></a><a href="#l1478">1478</a><td>  }<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td><tr><td><a id="l1480"></a><a href="#l1480">1480</a><td>  return summary;<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td>};<tr><td><a id="l1482"></a><a href="#l1482">1482</a><td><tr><td><a id="l1483"></a><a href="#l1483">1483</a><td><tr><td><a id="l1484"></a><a href="#l1484">1484</a><td>/**<tr><td><a id="l1485"></a><a href="#l1485">1485</a><td> * Initializes the given test case with the global test runner &#39;G_testRunner&#39;.<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td> * @param {goog.testing.TestCase} testCase The test case to install.<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td> */<tr><td><a id="l1488"></a><a href="#l1488">1488</a><td>goog.testing.TestCase.initializeTestRunner = function(testCase) {<tr><td><a id="l1489"></a><a href="#l1489">1489</a><td>  testCase.autoDiscoverTests();<tr><td><a id="l1490"></a><a href="#l1490">1490</a><td><tr><td><a id="l1491"></a><a href="#l1491">1491</a><td>  if (goog.global.location) {<tr><td><a id="l1492"></a><a href="#l1492">1492</a><td>    var search = goog.global.location.search;<tr><td><a id="l1493"></a><a href="#l1493">1493</a><td>    testCase.setOrder(goog.testing.TestCase.parseOrder_(search) ||<tr><td><a id="l1494"></a><a href="#l1494">1494</a><td>        goog.testing.TestCase.Order.SORTED);<tr><td><a id="l1495"></a><a href="#l1495">1495</a><td>    testCase.setTestsToRun(goog.testing.TestCase.parseRunTests_(search));<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td>  }<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td><tr><td><a id="l1498"></a><a href="#l1498">1498</a><td>  var gTestRunner = goog.global[&#39;G_testRunner&#39;];<tr><td><a id="l1499"></a><a href="#l1499">1499</a><td>  if (gTestRunner) {<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td>    gTestRunner[&#39;initialize&#39;](testCase);<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td>  } else {<tr><td><a id="l1502"></a><a href="#l1502">1502</a><td>    throw Error(&#39;G_testRunner is undefined. Please ensure goog.testing.jsunit&#39; +<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td>        &#39; is included.&#39;);<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td>  }<tr><td><a id="l1505"></a><a href="#l1505">1505</a><td>};<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td><tr><td><a id="l1507"></a><a href="#l1507">1507</a><td><tr><td><a id="l1508"></a><a href="#l1508">1508</a><td>/**<tr><td><a id="l1509"></a><a href="#l1509">1509</a><td> * Parses URL query parameters for the &#39;order&#39; parameter.<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td> * @param {string} search The URL query string.<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td> * @return {?goog.testing.TestCase.Order} The sort order for running tests.<tr><td><a id="l1512"></a><a href="#l1512">1512</a><td> * @private<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td> */<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td>goog.testing.TestCase.parseOrder_ = function(search) {<tr><td><a id="l1515"></a><a href="#l1515">1515</a><td>  var order = null;<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>  var orderMatch = search.match(<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td>      /(?:\?|&amp;)order=(natural|random|sorted)/i);<tr><td><a id="l1518"></a><a href="#l1518">1518</a><td>  if (orderMatch) {<tr><td><a id="l1519"></a><a href="#l1519">1519</a><td>    order = /** @type {goog.testing.TestCase.Order} */ (<tr><td><a id="l1520"></a><a href="#l1520">1520</a><td>        orderMatch[1].toLowerCase());<tr><td><a id="l1521"></a><a href="#l1521">1521</a><td>  }<tr><td><a id="l1522"></a><a href="#l1522">1522</a><td>  return order;<tr><td><a id="l1523"></a><a href="#l1523">1523</a><td>};<tr><td><a id="l1524"></a><a href="#l1524">1524</a><td><tr><td><a id="l1525"></a><a href="#l1525">1525</a><td><tr><td><a id="l1526"></a><a href="#l1526">1526</a><td>/**<tr><td><a id="l1527"></a><a href="#l1527">1527</a><td> * Parses URL query parameters for the &#39;runTests&#39; parameter.<tr><td><a id="l1528"></a><a href="#l1528">1528</a><td> * @param {string} search The URL query string.<tr><td><a id="l1529"></a><a href="#l1529">1529</a><td> * @return {Object&lt;string, boolean&gt;} A set of test names or test indices to be<tr><td><a id="l1530"></a><a href="#l1530">1530</a><td> *     run by the test runner.<tr><td><a id="l1531"></a><a href="#l1531">1531</a><td> * @private<tr><td><a id="l1532"></a><a href="#l1532">1532</a><td> */<tr><td><a id="l1533"></a><a href="#l1533">1533</a><td>goog.testing.TestCase.parseRunTests_ = function(search) {<tr><td><a id="l1534"></a><a href="#l1534">1534</a><td>  var testsToRun = null;<tr><td><a id="l1535"></a><a href="#l1535">1535</a><td>  var runTestsMatch = search.match(/(?:\?|&amp;)runTests=([^?&amp;]+)/i);<tr><td><a id="l1536"></a><a href="#l1536">1536</a><td>  if (runTestsMatch) {<tr><td><a id="l1537"></a><a href="#l1537">1537</a><td>    testsToRun = {};<tr><td><a id="l1538"></a><a href="#l1538">1538</a><td>    var arr = runTestsMatch[1].split(&#39;,&#39;);<tr><td><a id="l1539"></a><a href="#l1539">1539</a><td>    for (var i = 0, len = arr.length; i &lt; len; i++) {<tr><td><a id="l1540"></a><a href="#l1540">1540</a><td>      testsToRun[arr[i]] = true;<tr><td><a id="l1541"></a><a href="#l1541">1541</a><td>    }<tr><td><a id="l1542"></a><a href="#l1542">1542</a><td>  }<tr><td><a id="l1543"></a><a href="#l1543">1543</a><td>  return testsToRun;<tr><td><a id="l1544"></a><a href="#l1544">1544</a><td>};<tr><td><a id="l1545"></a><a href="#l1545">1545</a><td><tr><td><a id="l1546"></a><a href="#l1546">1546</a><td><tr><td><a id="l1547"></a><a href="#l1547">1547</a><td>/**<tr><td><a id="l1548"></a><a href="#l1548">1548</a><td> * Wraps provided promise and returns a new promise which will be rejected<tr><td><a id="l1549"></a><a href="#l1549">1549</a><td> * if the original promise does not settle within the given timeout.<tr><td><a id="l1550"></a><a href="#l1550">1550</a><td> * @param {!IThenable&lt;T&gt;} promise<tr><td><a id="l1551"></a><a href="#l1551">1551</a><td> * @param {number} timeoutInMs Number of milliseconds to wait for the promise to<tr><td><a id="l1552"></a><a href="#l1552">1552</a><td> *     settle before failing it with a timeout error.<tr><td><a id="l1553"></a><a href="#l1553">1553</a><td> * @param {string} errorMsg Error message to use if the promise times out.<tr><td><a id="l1554"></a><a href="#l1554">1554</a><td> * @return {!goog.Promise&lt;T&gt;} A promise that will settle with the original<tr><td><a id="l1555"></a><a href="#l1555">1555</a><td>       promise unless the timeout is exceeded.<tr><td><a id="l1556"></a><a href="#l1556">1556</a><td> *     errror.<tr><td><a id="l1557"></a><a href="#l1557">1557</a><td> * @template T<tr><td><a id="l1558"></a><a href="#l1558">1558</a><td> * @private<tr><td><a id="l1559"></a><a href="#l1559">1559</a><td> */<tr><td><a id="l1560"></a><a href="#l1560">1560</a><td>goog.testing.TestCase.prototype.rejectIfPromiseTimesOut_ =<tr><td><a id="l1561"></a><a href="#l1561">1561</a><td>    function(promise, timeoutInMs, errorMsg) {<tr><td><a id="l1562"></a><a href="#l1562">1562</a><td>  var self = this;<tr><td><a id="l1563"></a><a href="#l1563">1563</a><td>  var start = this.now();<tr><td><a id="l1564"></a><a href="#l1564">1564</a><td>  return new goog.Promise(function(resolve, reject) {<tr><td><a id="l1565"></a><a href="#l1565">1565</a><td>    var timeoutId = self.timeout(function() {<tr><td><a id="l1566"></a><a href="#l1566">1566</a><td>      var elapsed = self.now() - start;<tr><td><a id="l1567"></a><a href="#l1567">1567</a><td>      reject(new Error(errorMsg + &#39;\nElapsed time: &#39; + elapsed + &#39;ms.&#39;));<tr><td><a id="l1568"></a><a href="#l1568">1568</a><td>    }, timeoutInMs);<tr><td><a id="l1569"></a><a href="#l1569">1569</a><td>    promise.then(resolve, reject);<tr><td><a id="l1570"></a><a href="#l1570">1570</a><td>    var clearTimeout = goog.bind(self.clearTimeout, self, timeoutId);<tr><td><a id="l1571"></a><a href="#l1571">1571</a><td>    promise.then(clearTimeout, clearTimeout);<tr><td><a id="l1572"></a><a href="#l1572">1572</a><td>  });<tr><td><a id="l1573"></a><a href="#l1573">1573</a><td>};<tr><td><a id="l1574"></a><a href="#l1574">1574</a><td><tr><td><a id="l1575"></a><a href="#l1575">1575</a><td><tr><td><a id="l1576"></a><a href="#l1576">1576</a><td><tr><td><a id="l1577"></a><a href="#l1577">1577</a><td>/**<tr><td><a id="l1578"></a><a href="#l1578">1578</a><td> * A class representing an error thrown by the test<tr><td><a id="l1579"></a><a href="#l1579">1579</a><td> * @param {string} source The name of the test which threw the error.<tr><td><a id="l1580"></a><a href="#l1580">1580</a><td> * @param {string} message The error message.<tr><td><a id="l1581"></a><a href="#l1581">1581</a><td> * @param {string=} opt_stack A string showing the execution stack.<tr><td><a id="l1582"></a><a href="#l1582">1582</a><td> * @constructor<tr><td><a id="l1583"></a><a href="#l1583">1583</a><td> * @final<tr><td><a id="l1584"></a><a href="#l1584">1584</a><td> */<tr><td><a id="l1585"></a><a href="#l1585">1585</a><td>goog.testing.TestCase.Error = function(source, message, opt_stack) {<tr><td><a id="l1586"></a><a href="#l1586">1586</a><td>  /**<tr><td><a id="l1587"></a><a href="#l1587">1587</a><td>   * The name of the test which threw the error.<tr><td><a id="l1588"></a><a href="#l1588">1588</a><td>   * @type {string}<tr><td><a id="l1589"></a><a href="#l1589">1589</a><td>   */<tr><td><a id="l1590"></a><a href="#l1590">1590</a><td>  this.source = source;<tr><td><a id="l1591"></a><a href="#l1591">1591</a><td><tr><td><a id="l1592"></a><a href="#l1592">1592</a><td>  /**<tr><td><a id="l1593"></a><a href="#l1593">1593</a><td>   * Reference to the test function.<tr><td><a id="l1594"></a><a href="#l1594">1594</a><td>   * @type {string}<tr><td><a id="l1595"></a><a href="#l1595">1595</a><td>   */<tr><td><a id="l1596"></a><a href="#l1596">1596</a><td>  this.message = message;<tr><td><a id="l1597"></a><a href="#l1597">1597</a><td><tr><td><a id="l1598"></a><a href="#l1598">1598</a><td>  /**<tr><td><a id="l1599"></a><a href="#l1599">1599</a><td>   * The stack.<tr><td><a id="l1600"></a><a href="#l1600">1600</a><td>   * @type {?string}<tr><td><a id="l1601"></a><a href="#l1601">1601</a><td>   */<tr><td><a id="l1602"></a><a href="#l1602">1602</a><td>  this.stack = null;<tr><td><a id="l1603"></a><a href="#l1603">1603</a><td><tr><td><a id="l1604"></a><a href="#l1604">1604</a><td>  if (opt_stack) {<tr><td><a id="l1605"></a><a href="#l1605">1605</a><td>    this.stack = opt_stack;<tr><td><a id="l1606"></a><a href="#l1606">1606</a><td>  } else {<tr><td><a id="l1607"></a><a href="#l1607">1607</a><td>    // Attempt to capture a stack trace.<tr><td><a id="l1608"></a><a href="#l1608">1608</a><td>    if (Error.captureStackTrace) {<tr><td><a id="l1609"></a><a href="#l1609">1609</a><td>      // See https://code.google.com/p/v8-wiki/wiki/JavaScriptStackTraceApi<tr><td><a id="l1610"></a><a href="#l1610">1610</a><td>      Error.captureStackTrace(this, goog.testing.TestCase.Error);<tr><td><a id="l1611"></a><a href="#l1611">1611</a><td>    } else {<tr><td><a id="l1612"></a><a href="#l1612">1612</a><td>      var stack = new Error().stack;<tr><td><a id="l1613"></a><a href="#l1613">1613</a><td>      if (stack) {<tr><td><a id="l1614"></a><a href="#l1614">1614</a><td>        this.stack = stack;<tr><td><a id="l1615"></a><a href="#l1615">1615</a><td>      }<tr><td><a id="l1616"></a><a href="#l1616">1616</a><td>    }<tr><td><a id="l1617"></a><a href="#l1617">1617</a><td>  }<tr><td><a id="l1618"></a><a href="#l1618">1618</a><td>};<tr><td><a id="l1619"></a><a href="#l1619">1619</a><td><tr><td><a id="l1620"></a><a href="#l1620">1620</a><td><tr><td><a id="l1621"></a><a href="#l1621">1621</a><td>/**<tr><td><a id="l1622"></a><a href="#l1622">1622</a><td> * Returns a string representing the error object.<tr><td><a id="l1623"></a><a href="#l1623">1623</a><td> * @return {string} A string representation of the error.<tr><td><a id="l1624"></a><a href="#l1624">1624</a><td> * @override<tr><td><a id="l1625"></a><a href="#l1625">1625</a><td> */<tr><td><a id="l1626"></a><a href="#l1626">1626</a><td>goog.testing.TestCase.Error.prototype.toString = function() {<tr><td><a id="l1627"></a><a href="#l1627">1627</a><td>  return &#39;ERROR in &#39; + this.source + &#39;\n&#39; +<tr><td><a id="l1628"></a><a href="#l1628">1628</a><td>      this.message + (this.stack ? &#39;\n&#39; + this.stack : &#39;&#39;);<tr><td><a id="l1629"></a><a href="#l1629">1629</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/testrunner.js.src.html b/docs/source/lib/goog/testing/testrunner.js.src.html
new file mode 100644
index 0000000..8edf546
--- /dev/null
+++ b/docs/source/lib/goog/testing/testrunner.js.src.html
@@ -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>testrunner.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/goog/testing/testrunner.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2007 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview The test runner is a singleton object that is used to execute<tr><td><a id="l17"></a><a href="#l17">17</a><td> * a goog.testing.TestCases, display the results, and expose the results to<tr><td><a id="l18"></a><a href="#l18">18</a><td> * Selenium for automation.  If a TestCase hasn&#39;t been registered with the<tr><td><a id="l19"></a><a href="#l19">19</a><td> * runner by the time window.onload occurs, the testRunner will try to auto-<tr><td><a id="l20"></a><a href="#l20">20</a><td> * discover JsUnit style test pages.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * The hooks for selenium are (see http://go/selenium-hook-setup):-<tr><td><a id="l23"></a><a href="#l23">23</a><td> *  - Boolean G_testRunner.isFinished()<tr><td><a id="l24"></a><a href="#l24">24</a><td> *  - Boolean G_testRunner.isSuccess()<tr><td><a id="l25"></a><a href="#l25">25</a><td> *  - String G_testRunner.getReport()<tr><td><a id="l26"></a><a href="#l26">26</a><td> *  - number G_testRunner.getRunTime()<tr><td><a id="l27"></a><a href="#l27">27</a><td> *  - Object&lt;string, Array&lt;string&gt;&gt; G_testRunner.getTestResults()<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Testing code should not have dependencies outside of goog.testing so as to<tr><td><a id="l30"></a><a href="#l30">30</a><td> * reduce the chance of masking missing dependencies.<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><tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.provide(&#39;goog.testing.TestRunner&#39;);<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.require(&#39;goog.dom.TagName&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.testing.TestCase&#39;);<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> * Construct a test runner.<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * NOTE(user): This is currently pretty weird, I&#39;m essentially trying to<tr><td><a id="l45"></a><a href="#l45">45</a><td> * create a wrapper that the Selenium test can hook into to query the state of<tr><td><a id="l46"></a><a href="#l46">46</a><td> * the running test case, while making goog.testing.TestCase general.<tr><td><a id="l47"></a><a href="#l47">47</a><td> *<tr><td><a id="l48"></a><a href="#l48">48</a><td> * @constructor<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.testing.TestRunner = function() {<tr><td><a id="l51"></a><a href="#l51">51</a><td>  /**<tr><td><a id="l52"></a><a href="#l52">52</a><td>   * Errors that occurred in the window.<tr><td><a id="l53"></a><a href="#l53">53</a><td>   * @type {Array&lt;string&gt;}<tr><td><a id="l54"></a><a href="#l54">54</a><td>   */<tr><td><a id="l55"></a><a href="#l55">55</a><td>  this.errors = [];<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>/**<tr><td><a id="l60"></a><a href="#l60">60</a><td> * Reference to the active test case.<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @type {goog.testing.TestCase?}<tr><td><a id="l62"></a><a href="#l62">62</a><td> */<tr><td><a id="l63"></a><a href="#l63">63</a><td>goog.testing.TestRunner.prototype.testCase = null;<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> * Whether the test runner has been initialized yet.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @type {boolean}<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>goog.testing.TestRunner.prototype.initialized = false;<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> * Element created in the document to add test results to.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @type {Element}<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @private<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>goog.testing.TestRunner.prototype.logEl_ = null;<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td>/**<tr><td><a id="l82"></a><a href="#l82">82</a><td> * Function to use when filtering errors.<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @type {(function(string))?}<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @private<tr><td><a id="l85"></a><a href="#l85">85</a><td> */<tr><td><a id="l86"></a><a href="#l86">86</a><td>goog.testing.TestRunner.prototype.errorFilter_ = null;<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> * Whether an empty test case counts as an error.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @type {boolean}<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @private<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td>goog.testing.TestRunner.prototype.strict_ = true;<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Initializes the test runner.<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @param {goog.testing.TestCase} testCase The test case to initialize with.<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.testing.TestRunner.prototype.initialize = function(testCase) {<tr><td><a id="l102"></a><a href="#l102">102</a><td>  if (this.testCase &amp;&amp; this.testCase.running) {<tr><td><a id="l103"></a><a href="#l103">103</a><td>    throw Error(&#39;The test runner is already waiting for a test to complete&#39;);<tr><td><a id="l104"></a><a href="#l104">104</a><td>  }<tr><td><a id="l105"></a><a href="#l105">105</a><td>  this.testCase = testCase;<tr><td><a id="l106"></a><a href="#l106">106</a><td>  this.initialized = true;<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> * By default, the test runner is strict, and fails if it runs an empty<tr><td><a id="l112"></a><a href="#l112">112</a><td> * test case.<tr><td><a id="l113"></a><a href="#l113">113</a><td> * @param {boolean} strict Whether the test runner should fail on an empty<tr><td><a id="l114"></a><a href="#l114">114</a><td> *     test case.<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>goog.testing.TestRunner.prototype.setStrict = function(strict) {<tr><td><a id="l117"></a><a href="#l117">117</a><td>  this.strict_ = strict;<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>/**<tr><td><a id="l122"></a><a href="#l122">122</a><td> * @return {boolean} Whether the test runner should fail on an empty<tr><td><a id="l123"></a><a href="#l123">123</a><td> *     test case.<tr><td><a id="l124"></a><a href="#l124">124</a><td> */<tr><td><a id="l125"></a><a href="#l125">125</a><td>goog.testing.TestRunner.prototype.isStrict = function() {<tr><td><a id="l126"></a><a href="#l126">126</a><td>  return this.strict_;<tr><td><a id="l127"></a><a href="#l127">127</a><td>};<tr><td><a id="l128"></a><a href="#l128">128</a><td><tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>/**<tr><td><a id="l131"></a><a href="#l131">131</a><td> * Returns true if the test runner is initialized.<tr><td><a id="l132"></a><a href="#l132">132</a><td> * Used by Selenium Hooks.<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @return {boolean} Whether the test runner is active.<tr><td><a id="l134"></a><a href="#l134">134</a><td> */<tr><td><a id="l135"></a><a href="#l135">135</a><td>goog.testing.TestRunner.prototype.isInitialized = function() {<tr><td><a id="l136"></a><a href="#l136">136</a><td>  return this.initialized;<tr><td><a id="l137"></a><a href="#l137">137</a><td>};<tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td>/**<tr><td><a id="l141"></a><a href="#l141">141</a><td> * Returns true if the test runner is finished.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * Used by Selenium Hooks.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @return {boolean} Whether the test runner is active.<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.testing.TestRunner.prototype.isFinished = function() {<tr><td><a id="l146"></a><a href="#l146">146</a><td>  return this.errors.length &gt; 0 ||<tr><td><a id="l147"></a><a href="#l147">147</a><td>      this.initialized &amp;&amp; !!this.testCase &amp;&amp; this.testCase.started &amp;&amp;<tr><td><a id="l148"></a><a href="#l148">148</a><td>      !this.testCase.running;<tr><td><a id="l149"></a><a href="#l149">149</a><td>};<tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>/**<tr><td><a id="l153"></a><a href="#l153">153</a><td> * Returns true if the test case didn&#39;t fail.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * Used by Selenium Hooks.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @return {boolean} Whether the current test returned successfully.<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>goog.testing.TestRunner.prototype.isSuccess = function() {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  return !this.hasErrors() &amp;&amp; !!this.testCase &amp;&amp; this.testCase.isSuccess();<tr><td><a id="l159"></a><a href="#l159">159</a><td>};<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * Returns true if the test case runner has errors that were caught outside of<tr><td><a id="l164"></a><a href="#l164">164</a><td> * the test case.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @return {boolean} Whether there were JS errors.<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.testing.TestRunner.prototype.hasErrors = function() {<tr><td><a id="l168"></a><a href="#l168">168</a><td>  return this.errors.length &gt; 0;<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> * Logs an error that occurred.  Used in the case of environment setting up<tr><td><a id="l174"></a><a href="#l174">174</a><td> * an onerror handler.<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @param {string} msg Error message.<tr><td><a id="l176"></a><a href="#l176">176</a><td> */<tr><td><a id="l177"></a><a href="#l177">177</a><td>goog.testing.TestRunner.prototype.logError = function(msg) {<tr><td><a id="l178"></a><a href="#l178">178</a><td>  if (!this.errorFilter_ || this.errorFilter_.call(null, msg)) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>    this.errors.push(msg);<tr><td><a id="l180"></a><a href="#l180">180</a><td>  }<tr><td><a id="l181"></a><a href="#l181">181</a><td>};<tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td>/**<tr><td><a id="l185"></a><a href="#l185">185</a><td> * Log failure in current running test.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @param {Error} ex Exception.<tr><td><a id="l187"></a><a href="#l187">187</a><td> */<tr><td><a id="l188"></a><a href="#l188">188</a><td>goog.testing.TestRunner.prototype.logTestFailure = function(ex) {<tr><td><a id="l189"></a><a href="#l189">189</a><td>  var testName = /** @type {string} */ (goog.testing.TestCase.currentTestName);<tr><td><a id="l190"></a><a href="#l190">190</a><td>  if (this.testCase) {<tr><td><a id="l191"></a><a href="#l191">191</a><td>    this.testCase.logError(testName, ex);<tr><td><a id="l192"></a><a href="#l192">192</a><td>  } else {<tr><td><a id="l193"></a><a href="#l193">193</a><td>    // NOTE: Do not forget to log the original exception raised.<tr><td><a id="l194"></a><a href="#l194">194</a><td>    throw new Error(&#39;Test runner not initialized with a test case. Original &#39; +<tr><td><a id="l195"></a><a href="#l195">195</a><td>                    &#39;exception: &#39; + ex.message);<tr><td><a id="l196"></a><a href="#l196">196</a><td>  }<tr><td><a id="l197"></a><a href="#l197">197</a><td>};<tr><td><a id="l198"></a><a href="#l198">198</a><td><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> * Sets a function to use as a filter for errors.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @param {function(string)} fn Filter function.<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.testing.TestRunner.prototype.setErrorFilter = function(fn) {<tr><td><a id="l205"></a><a href="#l205">205</a><td>  this.errorFilter_ = fn;<tr><td><a id="l206"></a><a href="#l206">206</a><td>};<tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td>/**<tr><td><a id="l210"></a><a href="#l210">210</a><td> * Returns a report of the test case that ran.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * Used by Selenium Hooks.<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @param {boolean=} opt_verbose If true results will include data about all<tr><td><a id="l213"></a><a href="#l213">213</a><td> *     tests, not just what failed.<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @return {string} A report summary of the test.<tr><td><a id="l215"></a><a href="#l215">215</a><td> */<tr><td><a id="l216"></a><a href="#l216">216</a><td>goog.testing.TestRunner.prototype.getReport = function(opt_verbose) {<tr><td><a id="l217"></a><a href="#l217">217</a><td>  var report = [];<tr><td><a id="l218"></a><a href="#l218">218</a><td>  if (this.testCase) {<tr><td><a id="l219"></a><a href="#l219">219</a><td>    report.push(this.testCase.getReport(opt_verbose));<tr><td><a id="l220"></a><a href="#l220">220</a><td>  }<tr><td><a id="l221"></a><a href="#l221">221</a><td>  if (this.errors.length &gt; 0) {<tr><td><a id="l222"></a><a href="#l222">222</a><td>    report.push(&#39;JavaScript errors detected by test runner:&#39;);<tr><td><a id="l223"></a><a href="#l223">223</a><td>    report.push.apply(report, this.errors);<tr><td><a id="l224"></a><a href="#l224">224</a><td>    report.push(&#39;\n&#39;);<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 report.join(&#39;\n&#39;);<tr><td><a id="l227"></a><a href="#l227">227</a><td>};<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>/**<tr><td><a id="l231"></a><a href="#l231">231</a><td> * Returns the amount of time it took for the test to run.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * Used by Selenium Hooks.<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @return {number} The run time, in milliseconds.<tr><td><a id="l234"></a><a href="#l234">234</a><td> */<tr><td><a id="l235"></a><a href="#l235">235</a><td>goog.testing.TestRunner.prototype.getRunTime = function() {<tr><td><a id="l236"></a><a href="#l236">236</a><td>  return this.testCase ? this.testCase.getRunTime() : 0;<tr><td><a id="l237"></a><a href="#l237">237</a><td>};<tr><td><a id="l238"></a><a href="#l238">238</a><td><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> * Returns the number of script files that were loaded in order to run the test.<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @return {number} The number of script files.<tr><td><a id="l243"></a><a href="#l243">243</a><td> */<tr><td><a id="l244"></a><a href="#l244">244</a><td>goog.testing.TestRunner.prototype.getNumFilesLoaded = function() {<tr><td><a id="l245"></a><a href="#l245">245</a><td>  return this.testCase ? this.testCase.getNumFilesLoaded() : 0;<tr><td><a id="l246"></a><a href="#l246">246</a><td>};<tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td><tr><td><a id="l249"></a><a href="#l249">249</a><td>/**<tr><td><a id="l250"></a><a href="#l250">250</a><td> * Executes a test case and prints the results to the window.<tr><td><a id="l251"></a><a href="#l251">251</a><td> */<tr><td><a id="l252"></a><a href="#l252">252</a><td>goog.testing.TestRunner.prototype.execute = function() {<tr><td><a id="l253"></a><a href="#l253">253</a><td>  if (!this.testCase) {<tr><td><a id="l254"></a><a href="#l254">254</a><td>    throw Error(&#39;The test runner must be initialized with a test case &#39; +<tr><td><a id="l255"></a><a href="#l255">255</a><td>                &#39;before execute can be called.&#39;);<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>  if (this.strict_ &amp;&amp; this.testCase.getCount() == 0) {<tr><td><a id="l259"></a><a href="#l259">259</a><td>    throw Error(<tr><td><a id="l260"></a><a href="#l260">260</a><td>        &#39;No tests found in given test case: &#39; +<tr><td><a id="l261"></a><a href="#l261">261</a><td>        this.testCase.getName() + &#39; &#39; +<tr><td><a id="l262"></a><a href="#l262">262</a><td>        &#39;By default, the test runner fails if a test case has no tests. &#39; +<tr><td><a id="l263"></a><a href="#l263">263</a><td>        &#39;To modify this behavior, see goog.testing.TestRunner\&#39;s &#39; +<tr><td><a id="l264"></a><a href="#l264">264</a><td>        &#39;setStrict() method, or G_testRunner.setStrict()&#39;);<tr><td><a id="l265"></a><a href="#l265">265</a><td>  }<tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>  this.testCase.setCompletedCallback(goog.bind(this.onComplete_, this));<tr><td><a id="l268"></a><a href="#l268">268</a><td>  if (goog.testing.TestRunner.shouldUsePromises_(this.testCase)) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>    this.testCase.runTestsReturningPromise();<tr><td><a id="l270"></a><a href="#l270">270</a><td>  } else {<tr><td><a id="l271"></a><a href="#l271">271</a><td>    this.testCase.runTests();<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>/**<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @param {!goog.testing.TestCase} testCase<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @return {boolean}<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @private<tr><td><a id="l280"></a><a href="#l280">280</a><td> */<tr><td><a id="l281"></a><a href="#l281">281</a><td>goog.testing.TestRunner.shouldUsePromises_ = function(testCase) {<tr><td><a id="l282"></a><a href="#l282">282</a><td>  return testCase.constructor === goog.testing.TestCase;<tr><td><a id="l283"></a><a href="#l283">283</a><td>};<tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td>/**<tr><td><a id="l287"></a><a href="#l287">287</a><td> * Writes the results to the document when the test case completes.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @private<tr><td><a id="l289"></a><a href="#l289">289</a><td> */<tr><td><a id="l290"></a><a href="#l290">290</a><td>goog.testing.TestRunner.prototype.onComplete_ = function() {<tr><td><a id="l291"></a><a href="#l291">291</a><td>  var log = this.testCase.getReport(true);<tr><td><a id="l292"></a><a href="#l292">292</a><td>  if (this.errors.length &gt; 0) {<tr><td><a id="l293"></a><a href="#l293">293</a><td>    log += &#39;\n&#39; + this.errors.join(&#39;\n&#39;);<tr><td><a id="l294"></a><a href="#l294">294</a><td>  }<tr><td><a id="l295"></a><a href="#l295">295</a><td><tr><td><a id="l296"></a><a href="#l296">296</a><td>  if (!this.logEl_) {<tr><td><a id="l297"></a><a href="#l297">297</a><td>    var el = document.getElementById(&#39;closureTestRunnerLog&#39;);<tr><td><a id="l298"></a><a href="#l298">298</a><td>    if (el == null) {<tr><td><a id="l299"></a><a href="#l299">299</a><td>      el = document.createElement(goog.dom.TagName.DIV);<tr><td><a id="l300"></a><a href="#l300">300</a><td>      document.body.appendChild(el);<tr><td><a id="l301"></a><a href="#l301">301</a><td>    }<tr><td><a id="l302"></a><a href="#l302">302</a><td>    this.logEl_ = el;<tr><td><a id="l303"></a><a href="#l303">303</a><td>  }<tr><td><a id="l304"></a><a href="#l304">304</a><td><tr><td><a id="l305"></a><a href="#l305">305</a><td>  // Highlight the page to indicate the overall outcome.<tr><td><a id="l306"></a><a href="#l306">306</a><td>  this.writeLog(log);<tr><td><a id="l307"></a><a href="#l307">307</a><td><tr><td><a id="l308"></a><a href="#l308">308</a><td>  // TODO(chrishenry): Make this work with multiple test cases (b/8603638).<tr><td><a id="l309"></a><a href="#l309">309</a><td>  var runAgainLink = document.createElement(goog.dom.TagName.A);<tr><td><a id="l310"></a><a href="#l310">310</a><td>  runAgainLink.style.display = &#39;inline-block&#39;;<tr><td><a id="l311"></a><a href="#l311">311</a><td>  runAgainLink.style.fontSize = &#39;small&#39;;<tr><td><a id="l312"></a><a href="#l312">312</a><td>  runAgainLink.style.marginBottom = &#39;16px&#39;;<tr><td><a id="l313"></a><a href="#l313">313</a><td>  runAgainLink.href = &#39;&#39;;<tr><td><a id="l314"></a><a href="#l314">314</a><td>  runAgainLink.onclick = goog.bind(function() {<tr><td><a id="l315"></a><a href="#l315">315</a><td>    this.execute();<tr><td><a id="l316"></a><a href="#l316">316</a><td>    return false;<tr><td><a id="l317"></a><a href="#l317">317</a><td>  }, this);<tr><td><a id="l318"></a><a href="#l318">318</a><td>  runAgainLink.innerHTML = &#39;Run again without reloading&#39;;<tr><td><a id="l319"></a><a href="#l319">319</a><td>  this.logEl_.appendChild(runAgainLink);<tr><td><a id="l320"></a><a href="#l320">320</a><td>};<tr><td><a id="l321"></a><a href="#l321">321</a><td><tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td>/**<tr><td><a id="l324"></a><a href="#l324">324</a><td> * Writes a nicely formatted log out to the document.<tr><td><a id="l325"></a><a href="#l325">325</a><td> * @param {string} log The string to write.<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.testing.TestRunner.prototype.writeLog = function(log) {<tr><td><a id="l328"></a><a href="#l328">328</a><td>  var lines = log.split(&#39;\n&#39;);<tr><td><a id="l329"></a><a href="#l329">329</a><td>  for (var i = 0; i &lt; lines.length; i++) {<tr><td><a id="l330"></a><a href="#l330">330</a><td>    var line = lines[i];<tr><td><a id="l331"></a><a href="#l331">331</a><td>    var color;<tr><td><a id="l332"></a><a href="#l332">332</a><td>    var isFailOrError = /FAILED/.test(line) || /ERROR/.test(line);<tr><td><a id="l333"></a><a href="#l333">333</a><td>    if (/PASSED/.test(line)) {<tr><td><a id="l334"></a><a href="#l334">334</a><td>      color = &#39;darkgreen&#39;;<tr><td><a id="l335"></a><a href="#l335">335</a><td>    } else if (isFailOrError) {<tr><td><a id="l336"></a><a href="#l336">336</a><td>      color = &#39;darkred&#39;;<tr><td><a id="l337"></a><a href="#l337">337</a><td>    } else {<tr><td><a id="l338"></a><a href="#l338">338</a><td>      color = &#39;#333&#39;;<tr><td><a id="l339"></a><a href="#l339">339</a><td>    }<tr><td><a id="l340"></a><a href="#l340">340</a><td>    var div = document.createElement(goog.dom.TagName.DIV);<tr><td><a id="l341"></a><a href="#l341">341</a><td>    if (line.substr(0, 2) == &#39;&gt; &#39;) {<tr><td><a id="l342"></a><a href="#l342">342</a><td>      // The stack trace may contain links so it has to be interpreted as HTML.<tr><td><a id="l343"></a><a href="#l343">343</a><td>      div.innerHTML = line;<tr><td><a id="l344"></a><a href="#l344">344</a><td>    } else {<tr><td><a id="l345"></a><a href="#l345">345</a><td>      div.appendChild(document.createTextNode(line));<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>    var testNameMatch =<tr><td><a id="l349"></a><a href="#l349">349</a><td>        /(\S+) (\[[^\]]*] )?: (FAILED|ERROR|PASSED)/.exec(line);<tr><td><a id="l350"></a><a href="#l350">350</a><td>    if (testNameMatch) {<tr><td><a id="l351"></a><a href="#l351">351</a><td>      // Build a URL to run the test individually.  If this test was already<tr><td><a id="l352"></a><a href="#l352">352</a><td>      // part of another subset test, we need to overwrite the old runTests<tr><td><a id="l353"></a><a href="#l353">353</a><td>      // query parameter.  We also need to do this without bringing in any<tr><td><a id="l354"></a><a href="#l354">354</a><td>      // extra dependencies, otherwise we could mask missing dependency bugs.<tr><td><a id="l355"></a><a href="#l355">355</a><td>      var newSearch = &#39;runTests=&#39; + testNameMatch[1];<tr><td><a id="l356"></a><a href="#l356">356</a><td>      var search = window.location.search;<tr><td><a id="l357"></a><a href="#l357">357</a><td>      if (search) {<tr><td><a id="l358"></a><a href="#l358">358</a><td>        var oldTests = /runTests=([^&amp;]*)/.exec(search);<tr><td><a id="l359"></a><a href="#l359">359</a><td>        if (oldTests) {<tr><td><a id="l360"></a><a href="#l360">360</a><td>          newSearch = search.substr(0, oldTests.index) +<tr><td><a id="l361"></a><a href="#l361">361</a><td>                      newSearch +<tr><td><a id="l362"></a><a href="#l362">362</a><td>                      search.substr(oldTests.index + oldTests[0].length);<tr><td><a id="l363"></a><a href="#l363">363</a><td>        } else {<tr><td><a id="l364"></a><a href="#l364">364</a><td>          newSearch = search + &#39;&amp;&#39; + newSearch;<tr><td><a id="l365"></a><a href="#l365">365</a><td>        }<tr><td><a id="l366"></a><a href="#l366">366</a><td>      } else {<tr><td><a id="l367"></a><a href="#l367">367</a><td>        newSearch = &#39;?&#39; + newSearch;<tr><td><a id="l368"></a><a href="#l368">368</a><td>      }<tr><td><a id="l369"></a><a href="#l369">369</a><td>      var href = window.location.href;<tr><td><a id="l370"></a><a href="#l370">370</a><td>      var hash = window.location.hash;<tr><td><a id="l371"></a><a href="#l371">371</a><td>      if (hash &amp;&amp; hash.charAt(0) != &#39;#&#39;) {<tr><td><a id="l372"></a><a href="#l372">372</a><td>        hash = &#39;#&#39; + hash;<tr><td><a id="l373"></a><a href="#l373">373</a><td>      }<tr><td><a id="l374"></a><a href="#l374">374</a><td>      href = href.split(&#39;#&#39;)[0].split(&#39;?&#39;)[0] + newSearch + hash;<tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td>      // Add the link.<tr><td><a id="l377"></a><a href="#l377">377</a><td>      var a = document.createElement(goog.dom.TagName.A);<tr><td><a id="l378"></a><a href="#l378">378</a><td>      a.innerHTML = &#39;(run individually)&#39;;<tr><td><a id="l379"></a><a href="#l379">379</a><td>      a.style.fontSize = &#39;0.8em&#39;;<tr><td><a id="l380"></a><a href="#l380">380</a><td>      a.style.color = &#39;#888&#39;;<tr><td><a id="l381"></a><a href="#l381">381</a><td>      a.href = href;<tr><td><a id="l382"></a><a href="#l382">382</a><td>      div.appendChild(document.createTextNode(&#39; &#39;));<tr><td><a id="l383"></a><a href="#l383">383</a><td>      div.appendChild(a);<tr><td><a id="l384"></a><a href="#l384">384</a><td>    }<tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td>    div.style.color = color;<tr><td><a id="l387"></a><a href="#l387">387</a><td>    div.style.font = &#39;normal 100% monospace&#39;;<tr><td><a id="l388"></a><a href="#l388">388</a><td>    div.style.wordWrap = &#39;break-word&#39;;<tr><td><a id="l389"></a><a href="#l389">389</a><td>    if (i == 0) {<tr><td><a id="l390"></a><a href="#l390">390</a><td>      // Highlight the first line as a header that indicates the test outcome.<tr><td><a id="l391"></a><a href="#l391">391</a><td>      div.style.padding = &#39;20px&#39;;<tr><td><a id="l392"></a><a href="#l392">392</a><td>      div.style.marginBottom = &#39;10px&#39;;<tr><td><a id="l393"></a><a href="#l393">393</a><td>      if (isFailOrError) {<tr><td><a id="l394"></a><a href="#l394">394</a><td>        div.style.border = &#39;5px solid &#39; + color;<tr><td><a id="l395"></a><a href="#l395">395</a><td>        div.style.backgroundColor = &#39;#ffeeee&#39;;<tr><td><a id="l396"></a><a href="#l396">396</a><td>      } else {<tr><td><a id="l397"></a><a href="#l397">397</a><td>        div.style.border = &#39;1px solid black&#39;;<tr><td><a id="l398"></a><a href="#l398">398</a><td>        div.style.backgroundColor = &#39;#eeffee&#39;;<tr><td><a id="l399"></a><a href="#l399">399</a><td>      }<tr><td><a id="l400"></a><a href="#l400">400</a><td>    }<tr><td><a id="l401"></a><a href="#l401">401</a><td><tr><td><a id="l402"></a><a href="#l402">402</a><td>    try {<tr><td><a id="l403"></a><a href="#l403">403</a><td>      div.style.whiteSpace = &#39;pre-wrap&#39;;<tr><td><a id="l404"></a><a href="#l404">404</a><td>    } catch (e) {<tr><td><a id="l405"></a><a href="#l405">405</a><td>      // NOTE(brenneman): IE raises an exception when assigning to pre-wrap.<tr><td><a id="l406"></a><a href="#l406">406</a><td>      // Thankfully, it doesn&#39;t collapse whitespace when using monospace fonts,<tr><td><a id="l407"></a><a href="#l407">407</a><td>      // so it will display correctly if we ignore the exception.<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>    if (i &lt; 2) {<tr><td><a id="l411"></a><a href="#l411">411</a><td>      div.style.fontWeight = &#39;bold&#39;;<tr><td><a id="l412"></a><a href="#l412">412</a><td>    }<tr><td><a id="l413"></a><a href="#l413">413</a><td>    this.logEl_.appendChild(div);<tr><td><a id="l414"></a><a href="#l414">414</a><td>  }<tr><td><a id="l415"></a><a href="#l415">415</a><td>};<tr><td><a id="l416"></a><a href="#l416">416</a><td><tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td>/**<tr><td><a id="l419"></a><a href="#l419">419</a><td> * Logs a message to the current test case.<tr><td><a id="l420"></a><a href="#l420">420</a><td> * @param {string} s The text to output to the log.<tr><td><a id="l421"></a><a href="#l421">421</a><td> */<tr><td><a id="l422"></a><a href="#l422">422</a><td>goog.testing.TestRunner.prototype.log = function(s) {<tr><td><a id="l423"></a><a href="#l423">423</a><td>  if (this.testCase) {<tr><td><a id="l424"></a><a href="#l424">424</a><td>    this.testCase.log(s);<tr><td><a id="l425"></a><a href="#l425">425</a><td>  }<tr><td><a id="l426"></a><a href="#l426">426</a><td>};<tr><td><a id="l427"></a><a href="#l427">427</a><td><tr><td><a id="l428"></a><a href="#l428">428</a><td><tr><td><a id="l429"></a><a href="#l429">429</a><td>// TODO(nnaze): Properly handle serving test results when multiple test cases<tr><td><a id="l430"></a><a href="#l430">430</a><td>// are run.<tr><td><a id="l431"></a><a href="#l431">431</a><td>/**<tr><td><a id="l432"></a><a href="#l432">432</a><td> * @return {Object&lt;string, !Array&lt;string&gt;&gt;} A map of test names to a list of<tr><td><a id="l433"></a><a href="#l433">433</a><td> * test failures (if any) to provide formatted data for the test runner.<tr><td><a id="l434"></a><a href="#l434">434</a><td> */<tr><td><a id="l435"></a><a href="#l435">435</a><td>goog.testing.TestRunner.prototype.getTestResults = function() {<tr><td><a id="l436"></a><a href="#l436">436</a><td>  if (this.testCase) {<tr><td><a id="l437"></a><a href="#l437">437</a><td>    return this.testCase.getTestResults();<tr><td><a id="l438"></a><a href="#l438">438</a><td>  }<tr><td><a id="l439"></a><a href="#l439">439</a><td>  return null;<tr><td><a id="l440"></a><a href="#l440">440</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/testing/watchers.js.src.html b/docs/source/lib/goog/testing/watchers.js.src.html
new file mode 100644
index 0000000..af097a8
--- /dev/null
+++ b/docs/source/lib/goog/testing/watchers.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>watchers.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/testing/watchers.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Simple notifiers for the Closure testing framework.<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> * @author johnlenz@google.com (John Lenz)<tr><td><a name="l19" href="#l19">19</a><td> */<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;goog.testing.watchers&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td>/** @private {!Array.&lt;function()&gt;} */<tr><td><a name="l25" href="#l25">25</a><td>goog.testing.watchers.resetWatchers_ = [];<tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>/**<tr><td><a name="l29" href="#l29">29</a><td> * Fires clock reset watching functions.<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>goog.testing.watchers.signalClockReset = function() {<tr><td><a name="l32" href="#l32">32</a><td>  var watchers = goog.testing.watchers.resetWatchers_;<tr><td><a name="l33" href="#l33">33</a><td>  for (var i = 0; i &lt; watchers.length; i++) {<tr><td><a name="l34" href="#l34">34</a><td>    goog.testing.watchers.resetWatchers_[i]();<tr><td><a name="l35" href="#l35">35</a><td>  }<tr><td><a name="l36" href="#l36">36</a><td>};<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>/**<tr><td><a name="l40" href="#l40">40</a><td> * Enqueues a function to be called when the clock used for setTimeout is reset.<tr><td><a name="l41" href="#l41">41</a><td> * @param {function()} fn<tr><td><a name="l42" href="#l42">42</a><td> */<tr><td><a name="l43" href="#l43">43</a><td>goog.testing.watchers.watchClockReset = function(fn) {<tr><td><a name="l44" href="#l44">44</a><td>  goog.testing.watchers.resetWatchers_.push(fn);<tr><td><a name="l45" href="#l45">45</a><td>};<tr><td><a name="l46" href="#l46">46</a><td></table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/goog/uri/uri.js.src.html b/docs/source/lib/goog/uri/uri.js.src.html
index 99b4e2b..8bd4094 100644
--- a/docs/source/lib/goog/uri/uri.js.src.html
+++ b/docs/source/lib/goog/uri/uri.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>uri.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/uri/uri.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Class for parsing and formatting URIs.<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> * Use goog.Uri(string) to parse a URI string.  Use goog.Uri.create(...) to<tr><td><a name="l19" href="#l19">19</a><td> * create a new instance of the goog.Uri object from Uri parts.<tr><td><a name="l20" href="#l20">20</a><td> *<tr><td><a name="l21" href="#l21">21</a><td> * e.g: &lt;code&gt;var myUri = new goog.Uri(window.location);&lt;/code&gt;<tr><td><a name="l22" href="#l22">22</a><td> *<tr><td><a name="l23" href="#l23">23</a><td> * Implements RFC 3986 for parsing/formatting URIs.<tr><td><a name="l24" href="#l24">24</a><td> * http://www.ietf.org/rfc/rfc3986.txt<tr><td><a name="l25" href="#l25">25</a><td> *<tr><td><a name="l26" href="#l26">26</a><td> * Some changes have been made to the interface (more like .NETs), though the<tr><td><a name="l27" href="#l27">27</a><td> * internal representation is now of un-encoded parts, this will change the<tr><td><a name="l28" href="#l28">28</a><td> * behavior slightly.<tr><td><a name="l29" href="#l29">29</a><td> *<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td>goog.provide(&#39;goog.Uri&#39;);<tr><td><a name="l33" href="#l33">33</a><td>goog.provide(&#39;goog.Uri.QueryData&#39;);<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l36" href="#l36">36</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l37" href="#l37">37</a><td>goog.require(&#39;goog.structs&#39;);<tr><td><a name="l38" href="#l38">38</a><td>goog.require(&#39;goog.structs.Map&#39;);<tr><td><a name="l39" href="#l39">39</a><td>goog.require(&#39;goog.uri.utils&#39;);<tr><td><a name="l40" href="#l40">40</a><td>goog.require(&#39;goog.uri.utils.ComponentIndex&#39;);<tr><td><a name="l41" href="#l41">41</a><td>goog.require(&#39;goog.uri.utils.StandardQueryParam&#39;);<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>/**<tr><td><a name="l46" href="#l46">46</a><td> * This class contains setters and getters for the parts of the URI.<tr><td><a name="l47" href="#l47">47</a><td> * The &lt;code&gt;getXyz&lt;/code&gt;/&lt;code&gt;setXyz&lt;/code&gt; methods return the decoded part<tr><td><a name="l48" href="#l48">48</a><td> * -- so&lt;code&gt;goog.Uri.parse(&#39;/foo%20bar&#39;).getPath()&lt;/code&gt; will return the<tr><td><a name="l49" href="#l49">49</a><td> * decoded path, &lt;code&gt;/foo bar&lt;/code&gt;.<tr><td><a name="l50" href="#l50">50</a><td> *<tr><td><a name="l51" href="#l51">51</a><td> * The constructor accepts an optional unparsed, raw URI string.  The parser<tr><td><a name="l52" href="#l52">52</a><td> * is relaxed, so special characters that aren&#39;t escaped but don&#39;t cause<tr><td><a name="l53" href="#l53">53</a><td> * ambiguities will not cause parse failures.<tr><td><a name="l54" href="#l54">54</a><td> *<tr><td><a name="l55" href="#l55">55</a><td> * All setters return &lt;code&gt;this&lt;/code&gt; and so may be chained, a la<tr><td><a name="l56" href="#l56">56</a><td> * &lt;code&gt;goog.Uri.parse(&#39;/foo&#39;).setFragment(&#39;part&#39;).toString()&lt;/code&gt;.<tr><td><a name="l57" href="#l57">57</a><td> *<tr><td><a name="l58" href="#l58">58</a><td> * @param {*=} opt_uri Optional string URI to parse<tr><td><a name="l59" href="#l59">59</a><td> *        (use goog.Uri.create() to create a URI from parts), or if<tr><td><a name="l60" href="#l60">60</a><td> *        a goog.Uri is passed, a clone is created.<tr><td><a name="l61" href="#l61">61</a><td> * @param {boolean=} opt_ignoreCase If true, #getParameterValue will ignore<tr><td><a name="l62" href="#l62">62</a><td> * the case of the parameter name.<tr><td><a name="l63" href="#l63">63</a><td> *<tr><td><a name="l64" href="#l64">64</a><td> * @constructor<tr><td><a name="l65" href="#l65">65</a><td> */<tr><td><a name="l66" href="#l66">66</a><td>goog.Uri = function(opt_uri, opt_ignoreCase) {<tr><td><a name="l67" href="#l67">67</a><td>  // Parse in the uri string<tr><td><a name="l68" href="#l68">68</a><td>  var m;<tr><td><a name="l69" href="#l69">69</a><td>  if (opt_uri instanceof goog.Uri) {<tr><td><a name="l70" href="#l70">70</a><td>    this.ignoreCase_ = goog.isDef(opt_ignoreCase) ?<tr><td><a name="l71" href="#l71">71</a><td>        opt_ignoreCase : opt_uri.getIgnoreCase();<tr><td><a name="l72" href="#l72">72</a><td>    this.setScheme(opt_uri.getScheme());<tr><td><a name="l73" href="#l73">73</a><td>    this.setUserInfo(opt_uri.getUserInfo());<tr><td><a name="l74" href="#l74">74</a><td>    this.setDomain(opt_uri.getDomain());<tr><td><a name="l75" href="#l75">75</a><td>    this.setPort(opt_uri.getPort());<tr><td><a name="l76" href="#l76">76</a><td>    this.setPath(opt_uri.getPath());<tr><td><a name="l77" href="#l77">77</a><td>    this.setQueryData(opt_uri.getQueryData().clone());<tr><td><a name="l78" href="#l78">78</a><td>    this.setFragment(opt_uri.getFragment());<tr><td><a name="l79" href="#l79">79</a><td>  } else if (opt_uri &amp;&amp; (m = goog.uri.utils.split(String(opt_uri)))) {<tr><td><a name="l80" href="#l80">80</a><td>    this.ignoreCase_ = !!opt_ignoreCase;<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td>    // Set the parts -- decoding as we do so.<tr><td><a name="l83" href="#l83">83</a><td>    // COMPATABILITY NOTE - In IE, unmatched fields may be empty strings,<tr><td><a name="l84" href="#l84">84</a><td>    // whereas in other browsers they will be undefined.<tr><td><a name="l85" href="#l85">85</a><td>    this.setScheme(m[goog.uri.utils.ComponentIndex.SCHEME] || &#39;&#39;, true);<tr><td><a name="l86" href="#l86">86</a><td>    this.setUserInfo(m[goog.uri.utils.ComponentIndex.USER_INFO] || &#39;&#39;, true);<tr><td><a name="l87" href="#l87">87</a><td>    this.setDomain(m[goog.uri.utils.ComponentIndex.DOMAIN] || &#39;&#39;, true);<tr><td><a name="l88" href="#l88">88</a><td>    this.setPort(m[goog.uri.utils.ComponentIndex.PORT]);<tr><td><a name="l89" href="#l89">89</a><td>    this.setPath(m[goog.uri.utils.ComponentIndex.PATH] || &#39;&#39;, true);<tr><td><a name="l90" href="#l90">90</a><td>    this.setQueryData(m[goog.uri.utils.ComponentIndex.QUERY_DATA] || &#39;&#39;, true);<tr><td><a name="l91" href="#l91">91</a><td>    this.setFragment(m[goog.uri.utils.ComponentIndex.FRAGMENT] || &#39;&#39;, true);<tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>  } else {<tr><td><a name="l94" href="#l94">94</a><td>    this.ignoreCase_ = !!opt_ignoreCase;<tr><td><a name="l95" href="#l95">95</a><td>    this.queryData_ = new goog.Uri.QueryData(null, null, this.ignoreCase_);<tr><td><a name="l96" href="#l96">96</a><td>  }<tr><td><a name="l97" href="#l97">97</a><td>};<tr><td><a name="l98" href="#l98">98</a><td><tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td>/**<tr><td><a name="l101" href="#l101">101</a><td> * If true, we preserve the type of query parameters set programmatically.<tr><td><a name="l102" href="#l102">102</a><td> *<tr><td><a name="l103" href="#l103">103</a><td> * This means that if you set a parameter to a boolean, and then call<tr><td><a name="l104" href="#l104">104</a><td> * getParameterValue, you will get a boolean back.<tr><td><a name="l105" href="#l105">105</a><td> *<tr><td><a name="l106" href="#l106">106</a><td> * If false, we will coerce parameters to strings, just as they would<tr><td><a name="l107" href="#l107">107</a><td> * appear in real URIs.<tr><td><a name="l108" href="#l108">108</a><td> *<tr><td><a name="l109" href="#l109">109</a><td> * TODO(nicksantos): Remove this once people have time to fix all tests.<tr><td><a name="l110" href="#l110">110</a><td> *<tr><td><a name="l111" href="#l111">111</a><td> * @type {boolean}<tr><td><a name="l112" href="#l112">112</a><td> */<tr><td><a name="l113" href="#l113">113</a><td>goog.Uri.preserveParameterTypesCompatibilityFlag = false;<tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td>/**<tr><td><a name="l117" href="#l117">117</a><td> * Parameter name added to stop caching.<tr><td><a name="l118" href="#l118">118</a><td> * @type {string}<tr><td><a name="l119" href="#l119">119</a><td> */<tr><td><a name="l120" href="#l120">120</a><td>goog.Uri.RANDOM_PARAM = goog.uri.utils.StandardQueryParam.RANDOM;<tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td>/**<tr><td><a name="l124" href="#l124">124</a><td> * Scheme such as &quot;http&quot;.<tr><td><a name="l125" href="#l125">125</a><td> * @type {string}<tr><td><a name="l126" href="#l126">126</a><td> * @private<tr><td><a name="l127" href="#l127">127</a><td> */<tr><td><a name="l128" href="#l128">128</a><td>goog.Uri.prototype.scheme_ = &#39;&#39;;<tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td>/**<tr><td><a name="l132" href="#l132">132</a><td> * User credentials in the form &quot;username:password&quot;.<tr><td><a name="l133" href="#l133">133</a><td> * @type {string}<tr><td><a name="l134" href="#l134">134</a><td> * @private<tr><td><a name="l135" href="#l135">135</a><td> */<tr><td><a name="l136" href="#l136">136</a><td>goog.Uri.prototype.userInfo_ = &#39;&#39;;<tr><td><a name="l137" href="#l137">137</a><td><tr><td><a name="l138" href="#l138">138</a><td><tr><td><a name="l139" href="#l139">139</a><td>/**<tr><td><a name="l140" href="#l140">140</a><td> * Domain part, e.g. &quot;www.google.com&quot;.<tr><td><a name="l141" href="#l141">141</a><td> * @type {string}<tr><td><a name="l142" href="#l142">142</a><td> * @private<tr><td><a name="l143" href="#l143">143</a><td> */<tr><td><a name="l144" href="#l144">144</a><td>goog.Uri.prototype.domain_ = &#39;&#39;;<tr><td><a name="l145" href="#l145">145</a><td><tr><td><a name="l146" href="#l146">146</a><td><tr><td><a name="l147" href="#l147">147</a><td>/**<tr><td><a name="l148" href="#l148">148</a><td> * Port, e.g. 8080.<tr><td><a name="l149" href="#l149">149</a><td> * @type {?number}<tr><td><a name="l150" href="#l150">150</a><td> * @private<tr><td><a name="l151" href="#l151">151</a><td> */<tr><td><a name="l152" href="#l152">152</a><td>goog.Uri.prototype.port_ = null;<tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td>/**<tr><td><a name="l156" href="#l156">156</a><td> * Path, e.g. &quot;/tests/img.png&quot;.<tr><td><a name="l157" href="#l157">157</a><td> * @type {string}<tr><td><a name="l158" href="#l158">158</a><td> * @private<tr><td><a name="l159" href="#l159">159</a><td> */<tr><td><a name="l160" href="#l160">160</a><td>goog.Uri.prototype.path_ = &#39;&#39;;<tr><td><a name="l161" href="#l161">161</a><td><tr><td><a name="l162" href="#l162">162</a><td><tr><td><a name="l163" href="#l163">163</a><td>/**<tr><td><a name="l164" href="#l164">164</a><td> * Object representing query data.<tr><td><a name="l165" href="#l165">165</a><td> * @type {!goog.Uri.QueryData}<tr><td><a name="l166" href="#l166">166</a><td> * @private<tr><td><a name="l167" href="#l167">167</a><td> */<tr><td><a name="l168" href="#l168">168</a><td>goog.Uri.prototype.queryData_;<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/**<tr><td><a name="l172" href="#l172">172</a><td> * The fragment without the #.<tr><td><a name="l173" href="#l173">173</a><td> * @type {string}<tr><td><a name="l174" href="#l174">174</a><td> * @private<tr><td><a name="l175" href="#l175">175</a><td> */<tr><td><a name="l176" href="#l176">176</a><td>goog.Uri.prototype.fragment_ = &#39;&#39;;<tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>/**<tr><td><a name="l180" href="#l180">180</a><td> * Whether or not this Uri should be treated as Read Only.<tr><td><a name="l181" href="#l181">181</a><td> * @type {boolean}<tr><td><a name="l182" href="#l182">182</a><td> * @private<tr><td><a name="l183" href="#l183">183</a><td> */<tr><td><a name="l184" href="#l184">184</a><td>goog.Uri.prototype.isReadOnly_ = false;<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td>/**<tr><td><a name="l188" href="#l188">188</a><td> * Whether or not to ignore case when comparing query params.<tr><td><a name="l189" href="#l189">189</a><td> * @type {boolean}<tr><td><a name="l190" href="#l190">190</a><td> * @private<tr><td><a name="l191" href="#l191">191</a><td> */<tr><td><a name="l192" href="#l192">192</a><td>goog.Uri.prototype.ignoreCase_ = false;<tr><td><a name="l193" href="#l193">193</a><td><tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td>/**<tr><td><a name="l196" href="#l196">196</a><td> * @return {string} The string form of the url.<tr><td><a name="l197" href="#l197">197</a><td> * @override<tr><td><a name="l198" href="#l198">198</a><td> */<tr><td><a name="l199" href="#l199">199</a><td>goog.Uri.prototype.toString = function() {<tr><td><a name="l200" href="#l200">200</a><td>  var out = [];<tr><td><a name="l201" href="#l201">201</a><td><tr><td><a name="l202" href="#l202">202</a><td>  var scheme = this.getScheme();<tr><td><a name="l203" href="#l203">203</a><td>  if (scheme) {<tr><td><a name="l204" href="#l204">204</a><td>    out.push(goog.Uri.encodeSpecialChars_(<tr><td><a name="l205" href="#l205">205</a><td>        scheme, goog.Uri.reDisallowedInSchemeOrUserInfo_), &#39;:&#39;);<tr><td><a name="l206" href="#l206">206</a><td>  }<tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td>  var domain = this.getDomain();<tr><td><a name="l209" href="#l209">209</a><td>  if (domain) {<tr><td><a name="l210" href="#l210">210</a><td>    out.push(&#39;//&#39;);<tr><td><a name="l211" href="#l211">211</a><td><tr><td><a name="l212" href="#l212">212</a><td>    var userInfo = this.getUserInfo();<tr><td><a name="l213" href="#l213">213</a><td>    if (userInfo) {<tr><td><a name="l214" href="#l214">214</a><td>      out.push(goog.Uri.encodeSpecialChars_(<tr><td><a name="l215" href="#l215">215</a><td>          userInfo, goog.Uri.reDisallowedInSchemeOrUserInfo_), &#39;@&#39;);<tr><td><a name="l216" href="#l216">216</a><td>    }<tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>    out.push(goog.string.urlEncode(domain));<tr><td><a name="l219" href="#l219">219</a><td><tr><td><a name="l220" href="#l220">220</a><td>    var port = this.getPort();<tr><td><a name="l221" href="#l221">221</a><td>    if (port != null) {<tr><td><a name="l222" href="#l222">222</a><td>      out.push(&#39;:&#39;, String(port));<tr><td><a name="l223" href="#l223">223</a><td>    }<tr><td><a name="l224" href="#l224">224</a><td>  }<tr><td><a name="l225" href="#l225">225</a><td><tr><td><a name="l226" href="#l226">226</a><td>  var path = this.getPath();<tr><td><a name="l227" href="#l227">227</a><td>  if (path) {<tr><td><a name="l228" href="#l228">228</a><td>    if (this.hasDomain() &amp;&amp; path.charAt(0) != &#39;/&#39;) {<tr><td><a name="l229" href="#l229">229</a><td>      out.push(&#39;/&#39;);<tr><td><a name="l230" href="#l230">230</a><td>    }<tr><td><a name="l231" href="#l231">231</a><td>    out.push(goog.Uri.encodeSpecialChars_(<tr><td><a name="l232" href="#l232">232</a><td>        path,<tr><td><a name="l233" href="#l233">233</a><td>        path.charAt(0) == &#39;/&#39; ?<tr><td><a name="l234" href="#l234">234</a><td>            goog.Uri.reDisallowedInAbsolutePath_ :<tr><td><a name="l235" href="#l235">235</a><td>            goog.Uri.reDisallowedInRelativePath_));<tr><td><a name="l236" href="#l236">236</a><td>  }<tr><td><a name="l237" href="#l237">237</a><td><tr><td><a name="l238" href="#l238">238</a><td>  var query = this.getEncodedQuery();<tr><td><a name="l239" href="#l239">239</a><td>  if (query) {<tr><td><a name="l240" href="#l240">240</a><td>    out.push(&#39;?&#39;, query);<tr><td><a name="l241" href="#l241">241</a><td>  }<tr><td><a name="l242" href="#l242">242</a><td><tr><td><a name="l243" href="#l243">243</a><td>  var fragment = this.getFragment();<tr><td><a name="l244" href="#l244">244</a><td>  if (fragment) {<tr><td><a name="l245" href="#l245">245</a><td>    out.push(&#39;#&#39;, goog.Uri.encodeSpecialChars_(<tr><td><a name="l246" href="#l246">246</a><td>        fragment, goog.Uri.reDisallowedInFragment_));<tr><td><a name="l247" href="#l247">247</a><td>  }<tr><td><a name="l248" href="#l248">248</a><td>  return out.join(&#39;&#39;);<tr><td><a name="l249" href="#l249">249</a><td>};<tr><td><a name="l250" href="#l250">250</a><td><tr><td><a name="l251" href="#l251">251</a><td><tr><td><a name="l252" href="#l252">252</a><td>/**<tr><td><a name="l253" href="#l253">253</a><td> * Resolves the given relative URI (a goog.Uri object), using the URI<tr><td><a name="l254" href="#l254">254</a><td> * represented by this instance as the base URI.<tr><td><a name="l255" href="#l255">255</a><td> *<tr><td><a name="l256" href="#l256">256</a><td> * There are several kinds of relative URIs:&lt;br&gt;<tr><td><a name="l257" href="#l257">257</a><td> * 1. foo - replaces the last part of the path, the whole query and fragment&lt;br&gt;<tr><td><a name="l258" href="#l258">258</a><td> * 2. /foo - replaces the the path, the query and fragment&lt;br&gt;<tr><td><a name="l259" href="#l259">259</a><td> * 3. //foo - replaces everything from the domain on.  foo is a domain name&lt;br&gt;<tr><td><a name="l260" href="#l260">260</a><td> * 4. ?foo - replace the query and fragment&lt;br&gt;<tr><td><a name="l261" href="#l261">261</a><td> * 5. #foo - replace the fragment only<tr><td><a name="l262" href="#l262">262</a><td> *<tr><td><a name="l263" href="#l263">263</a><td> * Additionally, if relative URI has a non-empty path, all &quot;..&quot; and &quot;.&quot;<tr><td><a name="l264" href="#l264">264</a><td> * segments will be resolved, as described in RFC 3986.<tr><td><a name="l265" href="#l265">265</a><td> *<tr><td><a name="l266" href="#l266">266</a><td> * @param {goog.Uri} relativeUri The relative URI to resolve.<tr><td><a name="l267" href="#l267">267</a><td> * @return {!goog.Uri} The resolved URI.<tr><td><a name="l268" href="#l268">268</a><td> */<tr><td><a name="l269" href="#l269">269</a><td>goog.Uri.prototype.resolve = function(relativeUri) {<tr><td><a name="l270" href="#l270">270</a><td><tr><td><a name="l271" href="#l271">271</a><td>  var absoluteUri = this.clone();<tr><td><a name="l272" href="#l272">272</a><td><tr><td><a name="l273" href="#l273">273</a><td>  // we satisfy these conditions by looking for the first part of relativeUri<tr><td><a name="l274" href="#l274">274</a><td>  // that is not blank and applying defaults to the rest<tr><td><a name="l275" href="#l275">275</a><td><tr><td><a name="l276" href="#l276">276</a><td>  var overridden = relativeUri.hasScheme();<tr><td><a name="l277" href="#l277">277</a><td><tr><td><a name="l278" href="#l278">278</a><td>  if (overridden) {<tr><td><a name="l279" href="#l279">279</a><td>    absoluteUri.setScheme(relativeUri.getScheme());<tr><td><a name="l280" href="#l280">280</a><td>  } else {<tr><td><a name="l281" href="#l281">281</a><td>    overridden = relativeUri.hasUserInfo();<tr><td><a name="l282" href="#l282">282</a><td>  }<tr><td><a name="l283" href="#l283">283</a><td><tr><td><a name="l284" href="#l284">284</a><td>  if (overridden) {<tr><td><a name="l285" href="#l285">285</a><td>    absoluteUri.setUserInfo(relativeUri.getUserInfo());<tr><td><a name="l286" href="#l286">286</a><td>  } else {<tr><td><a name="l287" href="#l287">287</a><td>    overridden = relativeUri.hasDomain();<tr><td><a name="l288" href="#l288">288</a><td>  }<tr><td><a name="l289" href="#l289">289</a><td><tr><td><a name="l290" href="#l290">290</a><td>  if (overridden) {<tr><td><a name="l291" href="#l291">291</a><td>    absoluteUri.setDomain(relativeUri.getDomain());<tr><td><a name="l292" href="#l292">292</a><td>  } else {<tr><td><a name="l293" href="#l293">293</a><td>    overridden = relativeUri.hasPort();<tr><td><a name="l294" href="#l294">294</a><td>  }<tr><td><a name="l295" href="#l295">295</a><td><tr><td><a name="l296" href="#l296">296</a><td>  var path = relativeUri.getPath();<tr><td><a name="l297" href="#l297">297</a><td>  if (overridden) {<tr><td><a name="l298" href="#l298">298</a><td>    absoluteUri.setPort(relativeUri.getPort());<tr><td><a name="l299" href="#l299">299</a><td>  } else {<tr><td><a name="l300" href="#l300">300</a><td>    overridden = relativeUri.hasPath();<tr><td><a name="l301" href="#l301">301</a><td>    if (overridden) {<tr><td><a name="l302" href="#l302">302</a><td>      // resolve path properly<tr><td><a name="l303" href="#l303">303</a><td>      if (path.charAt(0) != &#39;/&#39;) {<tr><td><a name="l304" href="#l304">304</a><td>        // path is relative<tr><td><a name="l305" href="#l305">305</a><td>        if (this.hasDomain() &amp;&amp; !this.hasPath()) {<tr><td><a name="l306" href="#l306">306</a><td>          // RFC 3986, section 5.2.3, case 1<tr><td><a name="l307" href="#l307">307</a><td>          path = &#39;/&#39; + path;<tr><td><a name="l308" href="#l308">308</a><td>        } else {<tr><td><a name="l309" href="#l309">309</a><td>          // RFC 3986, section 5.2.3, case 2<tr><td><a name="l310" href="#l310">310</a><td>          var lastSlashIndex = absoluteUri.getPath().lastIndexOf(&#39;/&#39;);<tr><td><a name="l311" href="#l311">311</a><td>          if (lastSlashIndex != -1) {<tr><td><a name="l312" href="#l312">312</a><td>            path = absoluteUri.getPath().substr(0, lastSlashIndex + 1) + path;<tr><td><a name="l313" href="#l313">313</a><td>          }<tr><td><a name="l314" href="#l314">314</a><td>        }<tr><td><a name="l315" href="#l315">315</a><td>      }<tr><td><a name="l316" href="#l316">316</a><td>      path = goog.Uri.removeDotSegments(path);<tr><td><a name="l317" href="#l317">317</a><td>    }<tr><td><a name="l318" href="#l318">318</a><td>  }<tr><td><a name="l319" href="#l319">319</a><td><tr><td><a name="l320" href="#l320">320</a><td>  if (overridden) {<tr><td><a name="l321" href="#l321">321</a><td>    absoluteUri.setPath(path);<tr><td><a name="l322" href="#l322">322</a><td>  } else {<tr><td><a name="l323" href="#l323">323</a><td>    overridden = relativeUri.hasQuery();<tr><td><a name="l324" href="#l324">324</a><td>  }<tr><td><a name="l325" href="#l325">325</a><td><tr><td><a name="l326" href="#l326">326</a><td>  if (overridden) {<tr><td><a name="l327" href="#l327">327</a><td>    absoluteUri.setQueryData(relativeUri.getDecodedQuery());<tr><td><a name="l328" href="#l328">328</a><td>  } else {<tr><td><a name="l329" href="#l329">329</a><td>    overridden = relativeUri.hasFragment();<tr><td><a name="l330" href="#l330">330</a><td>  }<tr><td><a name="l331" href="#l331">331</a><td><tr><td><a name="l332" href="#l332">332</a><td>  if (overridden) {<tr><td><a name="l333" href="#l333">333</a><td>    absoluteUri.setFragment(relativeUri.getFragment());<tr><td><a name="l334" href="#l334">334</a><td>  }<tr><td><a name="l335" href="#l335">335</a><td><tr><td><a name="l336" href="#l336">336</a><td>  return absoluteUri;<tr><td><a name="l337" href="#l337">337</a><td>};<tr><td><a name="l338" href="#l338">338</a><td><tr><td><a name="l339" href="#l339">339</a><td><tr><td><a name="l340" href="#l340">340</a><td>/**<tr><td><a name="l341" href="#l341">341</a><td> * Clones the URI instance.<tr><td><a name="l342" href="#l342">342</a><td> * @return {!goog.Uri} New instance of the URI objcet.<tr><td><a name="l343" href="#l343">343</a><td> */<tr><td><a name="l344" href="#l344">344</a><td>goog.Uri.prototype.clone = function() {<tr><td><a name="l345" href="#l345">345</a><td>  return new goog.Uri(this);<tr><td><a name="l346" href="#l346">346</a><td>};<tr><td><a name="l347" href="#l347">347</a><td><tr><td><a name="l348" href="#l348">348</a><td><tr><td><a name="l349" href="#l349">349</a><td>/**<tr><td><a name="l350" href="#l350">350</a><td> * @return {string} The encoded scheme/protocol for the URI.<tr><td><a name="l351" href="#l351">351</a><td> */<tr><td><a name="l352" href="#l352">352</a><td>goog.Uri.prototype.getScheme = function() {<tr><td><a name="l353" href="#l353">353</a><td>  return this.scheme_;<tr><td><a name="l354" href="#l354">354</a><td>};<tr><td><a name="l355" href="#l355">355</a><td><tr><td><a name="l356" href="#l356">356</a><td><tr><td><a name="l357" href="#l357">357</a><td>/**<tr><td><a name="l358" href="#l358">358</a><td> * Sets the scheme/protocol.<tr><td><a name="l359" href="#l359">359</a><td> * @param {string} newScheme New scheme value.<tr><td><a name="l360" href="#l360">360</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a name="l361" href="#l361">361</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l362" href="#l362">362</a><td> */<tr><td><a name="l363" href="#l363">363</a><td>goog.Uri.prototype.setScheme = function(newScheme, opt_decode) {<tr><td><a name="l364" href="#l364">364</a><td>  this.enforceReadOnly();<tr><td><a name="l365" href="#l365">365</a><td>  this.scheme_ = opt_decode ? goog.Uri.decodeOrEmpty_(newScheme) : newScheme;<tr><td><a name="l366" href="#l366">366</a><td><tr><td><a name="l367" href="#l367">367</a><td>  // remove an : at the end of the scheme so somebody can pass in<tr><td><a name="l368" href="#l368">368</a><td>  // window.location.protocol<tr><td><a name="l369" href="#l369">369</a><td>  if (this.scheme_) {<tr><td><a name="l370" href="#l370">370</a><td>    this.scheme_ = this.scheme_.replace(/:$/, &#39;&#39;);<tr><td><a name="l371" href="#l371">371</a><td>  }<tr><td><a name="l372" href="#l372">372</a><td>  return this;<tr><td><a name="l373" href="#l373">373</a><td>};<tr><td><a name="l374" href="#l374">374</a><td><tr><td><a name="l375" href="#l375">375</a><td><tr><td><a name="l376" href="#l376">376</a><td>/**<tr><td><a name="l377" href="#l377">377</a><td> * @return {boolean} Whether the scheme has been set.<tr><td><a name="l378" href="#l378">378</a><td> */<tr><td><a name="l379" href="#l379">379</a><td>goog.Uri.prototype.hasScheme = function() {<tr><td><a name="l380" href="#l380">380</a><td>  return !!this.scheme_;<tr><td><a name="l381" href="#l381">381</a><td>};<tr><td><a name="l382" href="#l382">382</a><td><tr><td><a name="l383" href="#l383">383</a><td><tr><td><a name="l384" href="#l384">384</a><td>/**<tr><td><a name="l385" href="#l385">385</a><td> * @return {string} The decoded user info.<tr><td><a name="l386" href="#l386">386</a><td> */<tr><td><a name="l387" href="#l387">387</a><td>goog.Uri.prototype.getUserInfo = function() {<tr><td><a name="l388" href="#l388">388</a><td>  return this.userInfo_;<tr><td><a name="l389" href="#l389">389</a><td>};<tr><td><a name="l390" href="#l390">390</a><td><tr><td><a name="l391" href="#l391">391</a><td><tr><td><a name="l392" href="#l392">392</a><td>/**<tr><td><a name="l393" href="#l393">393</a><td> * Sets the userInfo.<tr><td><a name="l394" href="#l394">394</a><td> * @param {string} newUserInfo New userInfo value.<tr><td><a name="l395" href="#l395">395</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a name="l396" href="#l396">396</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l397" href="#l397">397</a><td> */<tr><td><a name="l398" href="#l398">398</a><td>goog.Uri.prototype.setUserInfo = function(newUserInfo, opt_decode) {<tr><td><a name="l399" href="#l399">399</a><td>  this.enforceReadOnly();<tr><td><a name="l400" href="#l400">400</a><td>  this.userInfo_ = opt_decode ? goog.Uri.decodeOrEmpty_(newUserInfo) :<tr><td><a name="l401" href="#l401">401</a><td>                   newUserInfo;<tr><td><a name="l402" href="#l402">402</a><td>  return this;<tr><td><a name="l403" href="#l403">403</a><td>};<tr><td><a name="l404" href="#l404">404</a><td><tr><td><a name="l405" href="#l405">405</a><td><tr><td><a name="l406" href="#l406">406</a><td>/**<tr><td><a name="l407" href="#l407">407</a><td> * @return {boolean} Whether the user info has been set.<tr><td><a name="l408" href="#l408">408</a><td> */<tr><td><a name="l409" href="#l409">409</a><td>goog.Uri.prototype.hasUserInfo = function() {<tr><td><a name="l410" href="#l410">410</a><td>  return !!this.userInfo_;<tr><td><a name="l411" href="#l411">411</a><td>};<tr><td><a name="l412" href="#l412">412</a><td><tr><td><a name="l413" href="#l413">413</a><td><tr><td><a name="l414" href="#l414">414</a><td>/**<tr><td><a name="l415" href="#l415">415</a><td> * @return {string} The decoded domain.<tr><td><a name="l416" href="#l416">416</a><td> */<tr><td><a name="l417" href="#l417">417</a><td>goog.Uri.prototype.getDomain = function() {<tr><td><a name="l418" href="#l418">418</a><td>  return this.domain_;<tr><td><a name="l419" href="#l419">419</a><td>};<tr><td><a name="l420" href="#l420">420</a><td><tr><td><a name="l421" href="#l421">421</a><td><tr><td><a name="l422" href="#l422">422</a><td>/**<tr><td><a name="l423" href="#l423">423</a><td> * Sets the domain.<tr><td><a name="l424" href="#l424">424</a><td> * @param {string} newDomain New domain value.<tr><td><a name="l425" href="#l425">425</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a name="l426" href="#l426">426</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l427" href="#l427">427</a><td> */<tr><td><a name="l428" href="#l428">428</a><td>goog.Uri.prototype.setDomain = function(newDomain, opt_decode) {<tr><td><a name="l429" href="#l429">429</a><td>  this.enforceReadOnly();<tr><td><a name="l430" href="#l430">430</a><td>  this.domain_ = opt_decode ? goog.Uri.decodeOrEmpty_(newDomain) : newDomain;<tr><td><a name="l431" href="#l431">431</a><td>  return this;<tr><td><a name="l432" href="#l432">432</a><td>};<tr><td><a name="l433" href="#l433">433</a><td><tr><td><a name="l434" href="#l434">434</a><td><tr><td><a name="l435" href="#l435">435</a><td>/**<tr><td><a name="l436" href="#l436">436</a><td> * @return {boolean} Whether the domain has been set.<tr><td><a name="l437" href="#l437">437</a><td> */<tr><td><a name="l438" href="#l438">438</a><td>goog.Uri.prototype.hasDomain = function() {<tr><td><a name="l439" href="#l439">439</a><td>  return !!this.domain_;<tr><td><a name="l440" href="#l440">440</a><td>};<tr><td><a name="l441" href="#l441">441</a><td><tr><td><a name="l442" href="#l442">442</a><td><tr><td><a name="l443" href="#l443">443</a><td>/**<tr><td><a name="l444" href="#l444">444</a><td> * @return {?number} The port number.<tr><td><a name="l445" href="#l445">445</a><td> */<tr><td><a name="l446" href="#l446">446</a><td>goog.Uri.prototype.getPort = function() {<tr><td><a name="l447" href="#l447">447</a><td>  return this.port_;<tr><td><a name="l448" href="#l448">448</a><td>};<tr><td><a name="l449" href="#l449">449</a><td><tr><td><a name="l450" href="#l450">450</a><td><tr><td><a name="l451" href="#l451">451</a><td>/**<tr><td><a name="l452" href="#l452">452</a><td> * Sets the port number.<tr><td><a name="l453" href="#l453">453</a><td> * @param {*} newPort Port number. Will be explicitly casted to a number.<tr><td><a name="l454" href="#l454">454</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l455" href="#l455">455</a><td> */<tr><td><a name="l456" href="#l456">456</a><td>goog.Uri.prototype.setPort = function(newPort) {<tr><td><a name="l457" href="#l457">457</a><td>  this.enforceReadOnly();<tr><td><a name="l458" href="#l458">458</a><td><tr><td><a name="l459" href="#l459">459</a><td>  if (newPort) {<tr><td><a name="l460" href="#l460">460</a><td>    newPort = Number(newPort);<tr><td><a name="l461" href="#l461">461</a><td>    if (isNaN(newPort) || newPort &lt; 0) {<tr><td><a name="l462" href="#l462">462</a><td>      throw Error(&#39;Bad port number &#39; + newPort);<tr><td><a name="l463" href="#l463">463</a><td>    }<tr><td><a name="l464" href="#l464">464</a><td>    this.port_ = newPort;<tr><td><a name="l465" href="#l465">465</a><td>  } else {<tr><td><a name="l466" href="#l466">466</a><td>    this.port_ = null;<tr><td><a name="l467" href="#l467">467</a><td>  }<tr><td><a name="l468" href="#l468">468</a><td><tr><td><a name="l469" href="#l469">469</a><td>  return this;<tr><td><a name="l470" href="#l470">470</a><td>};<tr><td><a name="l471" href="#l471">471</a><td><tr><td><a name="l472" href="#l472">472</a><td><tr><td><a name="l473" href="#l473">473</a><td>/**<tr><td><a name="l474" href="#l474">474</a><td> * @return {boolean} Whether the port has been set.<tr><td><a name="l475" href="#l475">475</a><td> */<tr><td><a name="l476" href="#l476">476</a><td>goog.Uri.prototype.hasPort = function() {<tr><td><a name="l477" href="#l477">477</a><td>  return this.port_ != null;<tr><td><a name="l478" href="#l478">478</a><td>};<tr><td><a name="l479" href="#l479">479</a><td><tr><td><a name="l480" href="#l480">480</a><td><tr><td><a name="l481" href="#l481">481</a><td>/**<tr><td><a name="l482" href="#l482">482</a><td>  * @return {string} The decoded path.<tr><td><a name="l483" href="#l483">483</a><td> */<tr><td><a name="l484" href="#l484">484</a><td>goog.Uri.prototype.getPath = function() {<tr><td><a name="l485" href="#l485">485</a><td>  return this.path_;<tr><td><a name="l486" href="#l486">486</a><td>};<tr><td><a name="l487" href="#l487">487</a><td><tr><td><a name="l488" href="#l488">488</a><td><tr><td><a name="l489" href="#l489">489</a><td>/**<tr><td><a name="l490" href="#l490">490</a><td> * Sets the path.<tr><td><a name="l491" href="#l491">491</a><td> * @param {string} newPath New path value.<tr><td><a name="l492" href="#l492">492</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a name="l493" href="#l493">493</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l494" href="#l494">494</a><td> */<tr><td><a name="l495" href="#l495">495</a><td>goog.Uri.prototype.setPath = function(newPath, opt_decode) {<tr><td><a name="l496" href="#l496">496</a><td>  this.enforceReadOnly();<tr><td><a name="l497" href="#l497">497</a><td>  this.path_ = opt_decode ? goog.Uri.decodeOrEmpty_(newPath) : newPath;<tr><td><a name="l498" href="#l498">498</a><td>  return this;<tr><td><a name="l499" href="#l499">499</a><td>};<tr><td><a name="l500" href="#l500">500</a><td><tr><td><a name="l501" href="#l501">501</a><td><tr><td><a name="l502" href="#l502">502</a><td>/**<tr><td><a name="l503" href="#l503">503</a><td> * @return {boolean} Whether the path has been set.<tr><td><a name="l504" href="#l504">504</a><td> */<tr><td><a name="l505" href="#l505">505</a><td>goog.Uri.prototype.hasPath = function() {<tr><td><a name="l506" href="#l506">506</a><td>  return !!this.path_;<tr><td><a name="l507" href="#l507">507</a><td>};<tr><td><a name="l508" href="#l508">508</a><td><tr><td><a name="l509" href="#l509">509</a><td><tr><td><a name="l510" href="#l510">510</a><td>/**<tr><td><a name="l511" href="#l511">511</a><td> * @return {boolean} Whether the query string has been set.<tr><td><a name="l512" href="#l512">512</a><td> */<tr><td><a name="l513" href="#l513">513</a><td>goog.Uri.prototype.hasQuery = function() {<tr><td><a name="l514" href="#l514">514</a><td>  return this.queryData_.toString() !== &#39;&#39;;<tr><td><a name="l515" href="#l515">515</a><td>};<tr><td><a name="l516" href="#l516">516</a><td><tr><td><a name="l517" href="#l517">517</a><td><tr><td><a name="l518" href="#l518">518</a><td>/**<tr><td><a name="l519" href="#l519">519</a><td> * Sets the query data.<tr><td><a name="l520" href="#l520">520</a><td> * @param {goog.Uri.QueryData|string|undefined} queryData QueryData object.<tr><td><a name="l521" href="#l521">521</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a name="l522" href="#l522">522</a><td> *     Applies only if queryData is a string.<tr><td><a name="l523" href="#l523">523</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l524" href="#l524">524</a><td> */<tr><td><a name="l525" href="#l525">525</a><td>goog.Uri.prototype.setQueryData = function(queryData, opt_decode) {<tr><td><a name="l526" href="#l526">526</a><td>  this.enforceReadOnly();<tr><td><a name="l527" href="#l527">527</a><td><tr><td><a name="l528" href="#l528">528</a><td>  if (queryData instanceof goog.Uri.QueryData) {<tr><td><a name="l529" href="#l529">529</a><td>    this.queryData_ = queryData;<tr><td><a name="l530" href="#l530">530</a><td>    this.queryData_.setIgnoreCase(this.ignoreCase_);<tr><td><a name="l531" href="#l531">531</a><td>  } else {<tr><td><a name="l532" href="#l532">532</a><td>    if (!opt_decode) {<tr><td><a name="l533" href="#l533">533</a><td>      // QueryData accepts encoded query string, so encode it if<tr><td><a name="l534" href="#l534">534</a><td>      // opt_decode flag is not true.<tr><td><a name="l535" href="#l535">535</a><td>      queryData = goog.Uri.encodeSpecialChars_(queryData,<tr><td><a name="l536" href="#l536">536</a><td>                                               goog.Uri.reDisallowedInQuery_);<tr><td><a name="l537" href="#l537">537</a><td>    }<tr><td><a name="l538" href="#l538">538</a><td>    this.queryData_ = new goog.Uri.QueryData(queryData, null, this.ignoreCase_);<tr><td><a name="l539" href="#l539">539</a><td>  }<tr><td><a name="l540" href="#l540">540</a><td><tr><td><a name="l541" href="#l541">541</a><td>  return this;<tr><td><a name="l542" href="#l542">542</a><td>};<tr><td><a name="l543" href="#l543">543</a><td><tr><td><a name="l544" href="#l544">544</a><td><tr><td><a name="l545" href="#l545">545</a><td>/**<tr><td><a name="l546" href="#l546">546</a><td> * Sets the URI query.<tr><td><a name="l547" href="#l547">547</a><td> * @param {string} newQuery New query value.<tr><td><a name="l548" href="#l548">548</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a name="l549" href="#l549">549</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l550" href="#l550">550</a><td> */<tr><td><a name="l551" href="#l551">551</a><td>goog.Uri.prototype.setQuery = function(newQuery, opt_decode) {<tr><td><a name="l552" href="#l552">552</a><td>  return this.setQueryData(newQuery, opt_decode);<tr><td><a name="l553" href="#l553">553</a><td>};<tr><td><a name="l554" href="#l554">554</a><td><tr><td><a name="l555" href="#l555">555</a><td><tr><td><a name="l556" href="#l556">556</a><td>/**<tr><td><a name="l557" href="#l557">557</a><td> * @return {string} The encoded URI query, not including the ?.<tr><td><a name="l558" href="#l558">558</a><td> */<tr><td><a name="l559" href="#l559">559</a><td>goog.Uri.prototype.getEncodedQuery = function() {<tr><td><a name="l560" href="#l560">560</a><td>  return this.queryData_.toString();<tr><td><a name="l561" href="#l561">561</a><td>};<tr><td><a name="l562" href="#l562">562</a><td><tr><td><a name="l563" href="#l563">563</a><td><tr><td><a name="l564" href="#l564">564</a><td>/**<tr><td><a name="l565" href="#l565">565</a><td> * @return {string} The decoded URI query, not including the ?.<tr><td><a name="l566" href="#l566">566</a><td> */<tr><td><a name="l567" href="#l567">567</a><td>goog.Uri.prototype.getDecodedQuery = function() {<tr><td><a name="l568" href="#l568">568</a><td>  return this.queryData_.toDecodedString();<tr><td><a name="l569" href="#l569">569</a><td>};<tr><td><a name="l570" href="#l570">570</a><td><tr><td><a name="l571" href="#l571">571</a><td><tr><td><a name="l572" href="#l572">572</a><td>/**<tr><td><a name="l573" href="#l573">573</a><td> * Returns the query data.<tr><td><a name="l574" href="#l574">574</a><td> * @return {goog.Uri.QueryData} QueryData object.<tr><td><a name="l575" href="#l575">575</a><td> */<tr><td><a name="l576" href="#l576">576</a><td>goog.Uri.prototype.getQueryData = function() {<tr><td><a name="l577" href="#l577">577</a><td>  return this.queryData_;<tr><td><a name="l578" href="#l578">578</a><td>};<tr><td><a name="l579" href="#l579">579</a><td><tr><td><a name="l580" href="#l580">580</a><td><tr><td><a name="l581" href="#l581">581</a><td>/**<tr><td><a name="l582" href="#l582">582</a><td> * @return {string} The encoded URI query, not including the ?.<tr><td><a name="l583" href="#l583">583</a><td> *<tr><td><a name="l584" href="#l584">584</a><td> * Warning: This method, unlike other getter methods, returns encoded<tr><td><a name="l585" href="#l585">585</a><td> * value, instead of decoded one.<tr><td><a name="l586" href="#l586">586</a><td> */<tr><td><a name="l587" href="#l587">587</a><td>goog.Uri.prototype.getQuery = function() {<tr><td><a name="l588" href="#l588">588</a><td>  return this.getEncodedQuery();<tr><td><a name="l589" href="#l589">589</a><td>};<tr><td><a name="l590" href="#l590">590</a><td><tr><td><a name="l591" href="#l591">591</a><td><tr><td><a name="l592" href="#l592">592</a><td>/**<tr><td><a name="l593" href="#l593">593</a><td> * Sets the value of the named query parameters, clearing previous values for<tr><td><a name="l594" href="#l594">594</a><td> * that key.<tr><td><a name="l595" href="#l595">595</a><td> *<tr><td><a name="l596" href="#l596">596</a><td> * @param {string} key The parameter to set.<tr><td><a name="l597" href="#l597">597</a><td> * @param {*} value The new value.<tr><td><a name="l598" href="#l598">598</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l599" href="#l599">599</a><td> */<tr><td><a name="l600" href="#l600">600</a><td>goog.Uri.prototype.setParameterValue = function(key, value) {<tr><td><a name="l601" href="#l601">601</a><td>  this.enforceReadOnly();<tr><td><a name="l602" href="#l602">602</a><td>  this.queryData_.set(key, value);<tr><td><a name="l603" href="#l603">603</a><td>  return this;<tr><td><a name="l604" href="#l604">604</a><td>};<tr><td><a name="l605" href="#l605">605</a><td><tr><td><a name="l606" href="#l606">606</a><td><tr><td><a name="l607" href="#l607">607</a><td>/**<tr><td><a name="l608" href="#l608">608</a><td> * Sets the values of the named query parameters, clearing previous values for<tr><td><a name="l609" href="#l609">609</a><td> * that key.  Not new values will currently be moved to the end of the query<tr><td><a name="l610" href="#l610">610</a><td> * string.<tr><td><a name="l611" href="#l611">611</a><td> *<tr><td><a name="l612" href="#l612">612</a><td> * So, &lt;code&gt;goog.Uri.parse(&#39;foo?a=b&amp;c=d&amp;e=f&#39;).setParameterValues(&#39;c&#39;, [&#39;new&#39;])<tr><td><a name="l613" href="#l613">613</a><td> * &lt;/code&gt; yields &lt;tt&gt;foo?a=b&amp;e=f&amp;c=new&lt;/tt&gt;.&lt;/p&gt;<tr><td><a name="l614" href="#l614">614</a><td> *<tr><td><a name="l615" href="#l615">615</a><td> * @param {string} key The parameter to set.<tr><td><a name="l616" href="#l616">616</a><td> * @param {*} values The new values. If values is a single<tr><td><a name="l617" href="#l617">617</a><td> *     string then it will be treated as the sole value.<tr><td><a name="l618" href="#l618">618</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l619" href="#l619">619</a><td> */<tr><td><a name="l620" href="#l620">620</a><td>goog.Uri.prototype.setParameterValues = function(key, values) {<tr><td><a name="l621" href="#l621">621</a><td>  this.enforceReadOnly();<tr><td><a name="l622" href="#l622">622</a><td><tr><td><a name="l623" href="#l623">623</a><td>  if (!goog.isArray(values)) {<tr><td><a name="l624" href="#l624">624</a><td>    values = [String(values)];<tr><td><a name="l625" href="#l625">625</a><td>  }<tr><td><a name="l626" href="#l626">626</a><td><tr><td><a name="l627" href="#l627">627</a><td>  // TODO(nicksantos): This cast shouldn&#39;t be necessary.<tr><td><a name="l628" href="#l628">628</a><td>  this.queryData_.setValues(key, /** @type {Array} */ (values));<tr><td><a name="l629" href="#l629">629</a><td><tr><td><a name="l630" href="#l630">630</a><td>  return this;<tr><td><a name="l631" href="#l631">631</a><td>};<tr><td><a name="l632" href="#l632">632</a><td><tr><td><a name="l633" href="#l633">633</a><td><tr><td><a name="l634" href="#l634">634</a><td>/**<tr><td><a name="l635" href="#l635">635</a><td> * Returns the value&lt;b&gt;s&lt;/b&gt; for a given cgi parameter as a list of decoded<tr><td><a name="l636" href="#l636">636</a><td> * query parameter values.<tr><td><a name="l637" href="#l637">637</a><td> * @param {string} name The parameter to get values for.<tr><td><a name="l638" href="#l638">638</a><td> * @return {Array} The values for a given cgi parameter as a list of<tr><td><a name="l639" href="#l639">639</a><td> *     decoded query parameter values.<tr><td><a name="l640" href="#l640">640</a><td> */<tr><td><a name="l641" href="#l641">641</a><td>goog.Uri.prototype.getParameterValues = function(name) {<tr><td><a name="l642" href="#l642">642</a><td>  return this.queryData_.getValues(name);<tr><td><a name="l643" href="#l643">643</a><td>};<tr><td><a name="l644" href="#l644">644</a><td><tr><td><a name="l645" href="#l645">645</a><td><tr><td><a name="l646" href="#l646">646</a><td>/**<tr><td><a name="l647" href="#l647">647</a><td> * Returns the first value for a given cgi parameter or undefined if the given<tr><td><a name="l648" href="#l648">648</a><td> * parameter name does not appear in the query string.<tr><td><a name="l649" href="#l649">649</a><td> * @param {string} paramName Unescaped parameter name.<tr><td><a name="l650" href="#l650">650</a><td> * @return {string|undefined} The first value for a given cgi parameter or<tr><td><a name="l651" href="#l651">651</a><td> *     undefined if the given parameter name does not appear in the query<tr><td><a name="l652" href="#l652">652</a><td> *     string.<tr><td><a name="l653" href="#l653">653</a><td> */<tr><td><a name="l654" href="#l654">654</a><td>goog.Uri.prototype.getParameterValue = function(paramName) {<tr><td><a name="l655" href="#l655">655</a><td>  // NOTE(nicksantos): This type-cast is a lie when<tr><td><a name="l656" href="#l656">656</a><td>  // preserveParameterTypesCompatibilityFlag is set to true.<tr><td><a name="l657" href="#l657">657</a><td>  // But this should only be set to true in tests.<tr><td><a name="l658" href="#l658">658</a><td>  return /** @type {string|undefined} */ (this.queryData_.get(paramName));<tr><td><a name="l659" href="#l659">659</a><td>};<tr><td><a name="l660" href="#l660">660</a><td><tr><td><a name="l661" href="#l661">661</a><td><tr><td><a name="l662" href="#l662">662</a><td>/**<tr><td><a name="l663" href="#l663">663</a><td> * @return {string} The URI fragment, not including the #.<tr><td><a name="l664" href="#l664">664</a><td> */<tr><td><a name="l665" href="#l665">665</a><td>goog.Uri.prototype.getFragment = function() {<tr><td><a name="l666" href="#l666">666</a><td>  return this.fragment_;<tr><td><a name="l667" href="#l667">667</a><td>};<tr><td><a name="l668" href="#l668">668</a><td><tr><td><a name="l669" href="#l669">669</a><td><tr><td><a name="l670" href="#l670">670</a><td>/**<tr><td><a name="l671" href="#l671">671</a><td> * Sets the URI fragment.<tr><td><a name="l672" href="#l672">672</a><td> * @param {string} newFragment New fragment value.<tr><td><a name="l673" href="#l673">673</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a name="l674" href="#l674">674</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l675" href="#l675">675</a><td> */<tr><td><a name="l676" href="#l676">676</a><td>goog.Uri.prototype.setFragment = function(newFragment, opt_decode) {<tr><td><a name="l677" href="#l677">677</a><td>  this.enforceReadOnly();<tr><td><a name="l678" href="#l678">678</a><td>  this.fragment_ = opt_decode ? goog.Uri.decodeOrEmpty_(newFragment) :<tr><td><a name="l679" href="#l679">679</a><td>                   newFragment;<tr><td><a name="l680" href="#l680">680</a><td>  return this;<tr><td><a name="l681" href="#l681">681</a><td>};<tr><td><a name="l682" href="#l682">682</a><td><tr><td><a name="l683" href="#l683">683</a><td><tr><td><a name="l684" href="#l684">684</a><td>/**<tr><td><a name="l685" href="#l685">685</a><td> * @return {boolean} Whether the URI has a fragment set.<tr><td><a name="l686" href="#l686">686</a><td> */<tr><td><a name="l687" href="#l687">687</a><td>goog.Uri.prototype.hasFragment = function() {<tr><td><a name="l688" href="#l688">688</a><td>  return !!this.fragment_;<tr><td><a name="l689" href="#l689">689</a><td>};<tr><td><a name="l690" href="#l690">690</a><td><tr><td><a name="l691" href="#l691">691</a><td><tr><td><a name="l692" href="#l692">692</a><td>/**<tr><td><a name="l693" href="#l693">693</a><td> * Returns true if this has the same domain as that of uri2.<tr><td><a name="l694" href="#l694">694</a><td> * @param {goog.Uri} uri2 The URI object to compare to.<tr><td><a name="l695" href="#l695">695</a><td> * @return {boolean} true if same domain; false otherwise.<tr><td><a name="l696" href="#l696">696</a><td> */<tr><td><a name="l697" href="#l697">697</a><td>goog.Uri.prototype.hasSameDomainAs = function(uri2) {<tr><td><a name="l698" href="#l698">698</a><td>  return ((!this.hasDomain() &amp;&amp; !uri2.hasDomain()) ||<tr><td><a name="l699" href="#l699">699</a><td>          this.getDomain() == uri2.getDomain()) &amp;&amp;<tr><td><a name="l700" href="#l700">700</a><td>      ((!this.hasPort() &amp;&amp; !uri2.hasPort()) ||<tr><td><a name="l701" href="#l701">701</a><td>          this.getPort() == uri2.getPort());<tr><td><a name="l702" href="#l702">702</a><td>};<tr><td><a name="l703" href="#l703">703</a><td><tr><td><a name="l704" href="#l704">704</a><td><tr><td><a name="l705" href="#l705">705</a><td>/**<tr><td><a name="l706" href="#l706">706</a><td> * Adds a random parameter to the Uri.<tr><td><a name="l707" href="#l707">707</a><td> * @return {!goog.Uri} Reference to this Uri object.<tr><td><a name="l708" href="#l708">708</a><td> */<tr><td><a name="l709" href="#l709">709</a><td>goog.Uri.prototype.makeUnique = function() {<tr><td><a name="l710" href="#l710">710</a><td>  this.enforceReadOnly();<tr><td><a name="l711" href="#l711">711</a><td>  this.setParameterValue(goog.Uri.RANDOM_PARAM, goog.string.getRandomString());<tr><td><a name="l712" href="#l712">712</a><td><tr><td><a name="l713" href="#l713">713</a><td>  return this;<tr><td><a name="l714" href="#l714">714</a><td>};<tr><td><a name="l715" href="#l715">715</a><td><tr><td><a name="l716" href="#l716">716</a><td><tr><td><a name="l717" href="#l717">717</a><td>/**<tr><td><a name="l718" href="#l718">718</a><td> * Removes the named query parameter.<tr><td><a name="l719" href="#l719">719</a><td> *<tr><td><a name="l720" href="#l720">720</a><td> * @param {string} key The parameter to remove.<tr><td><a name="l721" href="#l721">721</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a name="l722" href="#l722">722</a><td> */<tr><td><a name="l723" href="#l723">723</a><td>goog.Uri.prototype.removeParameter = function(key) {<tr><td><a name="l724" href="#l724">724</a><td>  this.enforceReadOnly();<tr><td><a name="l725" href="#l725">725</a><td>  this.queryData_.remove(key);<tr><td><a name="l726" href="#l726">726</a><td>  return this;<tr><td><a name="l727" href="#l727">727</a><td>};<tr><td><a name="l728" href="#l728">728</a><td><tr><td><a name="l729" href="#l729">729</a><td><tr><td><a name="l730" href="#l730">730</a><td>/**<tr><td><a name="l731" href="#l731">731</a><td> * Sets whether Uri is read only. If this goog.Uri is read-only,<tr><td><a name="l732" href="#l732">732</a><td> * enforceReadOnly_ will be called at the start of any function that may modify<tr><td><a name="l733" href="#l733">733</a><td> * this Uri.<tr><td><a name="l734" href="#l734">734</a><td> * @param {boolean} isReadOnly whether this goog.Uri should be read only.<tr><td><a name="l735" href="#l735">735</a><td> * @return {!goog.Uri} Reference to this Uri object.<tr><td><a name="l736" href="#l736">736</a><td> */<tr><td><a name="l737" href="#l737">737</a><td>goog.Uri.prototype.setReadOnly = function(isReadOnly) {<tr><td><a name="l738" href="#l738">738</a><td>  this.isReadOnly_ = isReadOnly;<tr><td><a name="l739" href="#l739">739</a><td>  return this;<tr><td><a name="l740" href="#l740">740</a><td>};<tr><td><a name="l741" href="#l741">741</a><td><tr><td><a name="l742" href="#l742">742</a><td><tr><td><a name="l743" href="#l743">743</a><td>/**<tr><td><a name="l744" href="#l744">744</a><td> * @return {boolean} Whether the URI is read only.<tr><td><a name="l745" href="#l745">745</a><td> */<tr><td><a name="l746" href="#l746">746</a><td>goog.Uri.prototype.isReadOnly = function() {<tr><td><a name="l747" href="#l747">747</a><td>  return this.isReadOnly_;<tr><td><a name="l748" href="#l748">748</a><td>};<tr><td><a name="l749" href="#l749">749</a><td><tr><td><a name="l750" href="#l750">750</a><td><tr><td><a name="l751" href="#l751">751</a><td>/**<tr><td><a name="l752" href="#l752">752</a><td> * Checks if this Uri has been marked as read only, and if so, throws an error.<tr><td><a name="l753" href="#l753">753</a><td> * This should be called whenever any modifying function is called.<tr><td><a name="l754" href="#l754">754</a><td> */<tr><td><a name="l755" href="#l755">755</a><td>goog.Uri.prototype.enforceReadOnly = function() {<tr><td><a name="l756" href="#l756">756</a><td>  if (this.isReadOnly_) {<tr><td><a name="l757" href="#l757">757</a><td>    throw Error(&#39;Tried to modify a read-only Uri&#39;);<tr><td><a name="l758" href="#l758">758</a><td>  }<tr><td><a name="l759" href="#l759">759</a><td>};<tr><td><a name="l760" href="#l760">760</a><td><tr><td><a name="l761" href="#l761">761</a><td><tr><td><a name="l762" href="#l762">762</a><td>/**<tr><td><a name="l763" href="#l763">763</a><td> * Sets whether to ignore case.<tr><td><a name="l764" href="#l764">764</a><td> * NOTE: If there are already key/value pairs in the QueryData, and<tr><td><a name="l765" href="#l765">765</a><td> * ignoreCase_ is set to false, the keys will all be lower-cased.<tr><td><a name="l766" href="#l766">766</a><td> * @param {boolean} ignoreCase whether this goog.Uri should ignore case.<tr><td><a name="l767" href="#l767">767</a><td> * @return {!goog.Uri} Reference to this Uri object.<tr><td><a name="l768" href="#l768">768</a><td> */<tr><td><a name="l769" href="#l769">769</a><td>goog.Uri.prototype.setIgnoreCase = function(ignoreCase) {<tr><td><a name="l770" href="#l770">770</a><td>  this.ignoreCase_ = ignoreCase;<tr><td><a name="l771" href="#l771">771</a><td>  if (this.queryData_) {<tr><td><a name="l772" href="#l772">772</a><td>    this.queryData_.setIgnoreCase(ignoreCase);<tr><td><a name="l773" href="#l773">773</a><td>  }<tr><td><a name="l774" href="#l774">774</a><td>  return this;<tr><td><a name="l775" href="#l775">775</a><td>};<tr><td><a name="l776" href="#l776">776</a><td><tr><td><a name="l777" href="#l777">777</a><td><tr><td><a name="l778" href="#l778">778</a><td>/**<tr><td><a name="l779" href="#l779">779</a><td> * @return {boolean} Whether to ignore case.<tr><td><a name="l780" href="#l780">780</a><td> */<tr><td><a name="l781" href="#l781">781</a><td>goog.Uri.prototype.getIgnoreCase = function() {<tr><td><a name="l782" href="#l782">782</a><td>  return this.ignoreCase_;<tr><td><a name="l783" href="#l783">783</a><td>};<tr><td><a name="l784" href="#l784">784</a><td><tr><td><a name="l785" href="#l785">785</a><td><tr><td><a name="l786" href="#l786">786</a><td>//==============================================================================<tr><td><a name="l787" href="#l787">787</a><td>// Static members<tr><td><a name="l788" href="#l788">788</a><td>//==============================================================================<tr><td><a name="l789" href="#l789">789</a><td><tr><td><a name="l790" href="#l790">790</a><td><tr><td><a name="l791" href="#l791">791</a><td>/**<tr><td><a name="l792" href="#l792">792</a><td> * Creates a uri from the string form.  Basically an alias of new goog.Uri().<tr><td><a name="l793" href="#l793">793</a><td> * If a Uri object is passed to parse then it will return a clone of the object.<tr><td><a name="l794" href="#l794">794</a><td> *<tr><td><a name="l795" href="#l795">795</a><td> * @param {*} uri Raw URI string or instance of Uri<tr><td><a name="l796" href="#l796">796</a><td> *     object.<tr><td><a name="l797" href="#l797">797</a><td> * @param {boolean=} opt_ignoreCase Whether to ignore the case of parameter<tr><td><a name="l798" href="#l798">798</a><td> * names in #getParameterValue.<tr><td><a name="l799" href="#l799">799</a><td> * @return {!goog.Uri} The new URI object.<tr><td><a name="l800" href="#l800">800</a><td> */<tr><td><a name="l801" href="#l801">801</a><td>goog.Uri.parse = function(uri, opt_ignoreCase) {<tr><td><a name="l802" href="#l802">802</a><td>  return uri instanceof goog.Uri ?<tr><td><a name="l803" href="#l803">803</a><td>         uri.clone() : new goog.Uri(uri, opt_ignoreCase);<tr><td><a name="l804" href="#l804">804</a><td>};<tr><td><a name="l805" href="#l805">805</a><td><tr><td><a name="l806" href="#l806">806</a><td><tr><td><a name="l807" href="#l807">807</a><td>/**<tr><td><a name="l808" href="#l808">808</a><td> * Creates a new goog.Uri object from unencoded parts.<tr><td><a name="l809" href="#l809">809</a><td> *<tr><td><a name="l810" href="#l810">810</a><td> * @param {?string=} opt_scheme Scheme/protocol or full URI to parse.<tr><td><a name="l811" href="#l811">811</a><td> * @param {?string=} opt_userInfo username:password.<tr><td><a name="l812" href="#l812">812</a><td> * @param {?string=} opt_domain www.google.com.<tr><td><a name="l813" href="#l813">813</a><td> * @param {?number=} opt_port 9830.<tr><td><a name="l814" href="#l814">814</a><td> * @param {?string=} opt_path /some/path/to/a/file.html.<tr><td><a name="l815" href="#l815">815</a><td> * @param {string|goog.Uri.QueryData=} opt_query a=1&amp;b=2.<tr><td><a name="l816" href="#l816">816</a><td> * @param {?string=} opt_fragment The fragment without the #.<tr><td><a name="l817" href="#l817">817</a><td> * @param {boolean=} opt_ignoreCase Whether to ignore parameter name case in<tr><td><a name="l818" href="#l818">818</a><td> *     #getParameterValue.<tr><td><a name="l819" href="#l819">819</a><td> *<tr><td><a name="l820" href="#l820">820</a><td> * @return {!goog.Uri} The new URI object.<tr><td><a name="l821" href="#l821">821</a><td> */<tr><td><a name="l822" href="#l822">822</a><td>goog.Uri.create = function(opt_scheme, opt_userInfo, opt_domain, opt_port,<tr><td><a name="l823" href="#l823">823</a><td>                           opt_path, opt_query, opt_fragment, opt_ignoreCase) {<tr><td><a name="l824" href="#l824">824</a><td><tr><td><a name="l825" href="#l825">825</a><td>  var uri = new goog.Uri(null, opt_ignoreCase);<tr><td><a name="l826" href="#l826">826</a><td><tr><td><a name="l827" href="#l827">827</a><td>  // Only set the parts if they are defined and not empty strings.<tr><td><a name="l828" href="#l828">828</a><td>  opt_scheme &amp;&amp; uri.setScheme(opt_scheme);<tr><td><a name="l829" href="#l829">829</a><td>  opt_userInfo &amp;&amp; uri.setUserInfo(opt_userInfo);<tr><td><a name="l830" href="#l830">830</a><td>  opt_domain &amp;&amp; uri.setDomain(opt_domain);<tr><td><a name="l831" href="#l831">831</a><td>  opt_port &amp;&amp; uri.setPort(opt_port);<tr><td><a name="l832" href="#l832">832</a><td>  opt_path &amp;&amp; uri.setPath(opt_path);<tr><td><a name="l833" href="#l833">833</a><td>  opt_query &amp;&amp; uri.setQueryData(opt_query);<tr><td><a name="l834" href="#l834">834</a><td>  opt_fragment &amp;&amp; uri.setFragment(opt_fragment);<tr><td><a name="l835" href="#l835">835</a><td><tr><td><a name="l836" href="#l836">836</a><td>  return uri;<tr><td><a name="l837" href="#l837">837</a><td>};<tr><td><a name="l838" href="#l838">838</a><td><tr><td><a name="l839" href="#l839">839</a><td><tr><td><a name="l840" href="#l840">840</a><td>/**<tr><td><a name="l841" href="#l841">841</a><td> * Resolves a relative Uri against a base Uri, accepting both strings and<tr><td><a name="l842" href="#l842">842</a><td> * Uri objects.<tr><td><a name="l843" href="#l843">843</a><td> *<tr><td><a name="l844" href="#l844">844</a><td> * @param {*} base Base Uri.<tr><td><a name="l845" href="#l845">845</a><td> * @param {*} rel Relative Uri.<tr><td><a name="l846" href="#l846">846</a><td> * @return {!goog.Uri} Resolved uri.<tr><td><a name="l847" href="#l847">847</a><td> */<tr><td><a name="l848" href="#l848">848</a><td>goog.Uri.resolve = function(base, rel) {<tr><td><a name="l849" href="#l849">849</a><td>  if (!(base instanceof goog.Uri)) {<tr><td><a name="l850" href="#l850">850</a><td>    base = goog.Uri.parse(base);<tr><td><a name="l851" href="#l851">851</a><td>  }<tr><td><a name="l852" href="#l852">852</a><td><tr><td><a name="l853" href="#l853">853</a><td>  if (!(rel instanceof goog.Uri)) {<tr><td><a name="l854" href="#l854">854</a><td>    rel = goog.Uri.parse(rel);<tr><td><a name="l855" href="#l855">855</a><td>  }<tr><td><a name="l856" href="#l856">856</a><td><tr><td><a name="l857" href="#l857">857</a><td>  return base.resolve(rel);<tr><td><a name="l858" href="#l858">858</a><td>};<tr><td><a name="l859" href="#l859">859</a><td><tr><td><a name="l860" href="#l860">860</a><td><tr><td><a name="l861" href="#l861">861</a><td>/**<tr><td><a name="l862" href="#l862">862</a><td> * Removes dot segments in given path component, as described in<tr><td><a name="l863" href="#l863">863</a><td> * RFC 3986, section 5.2.4.<tr><td><a name="l864" href="#l864">864</a><td> *<tr><td><a name="l865" href="#l865">865</a><td> * @param {string} path A non-empty path component.<tr><td><a name="l866" href="#l866">866</a><td> * @return {string} Path component with removed dot segments.<tr><td><a name="l867" href="#l867">867</a><td> */<tr><td><a name="l868" href="#l868">868</a><td>goog.Uri.removeDotSegments = function(path) {<tr><td><a name="l869" href="#l869">869</a><td>  if (path == &#39;..&#39; || path == &#39;.&#39;) {<tr><td><a name="l870" href="#l870">870</a><td>    return &#39;&#39;;<tr><td><a name="l871" href="#l871">871</a><td><tr><td><a name="l872" href="#l872">872</a><td>  } else if (!goog.string.contains(path, &#39;./&#39;) &amp;&amp;<tr><td><a name="l873" href="#l873">873</a><td>             !goog.string.contains(path, &#39;/.&#39;)) {<tr><td><a name="l874" href="#l874">874</a><td>    // This optimization detects uris which do not contain dot-segments,<tr><td><a name="l875" href="#l875">875</a><td>    // and as a consequence do not require any processing.<tr><td><a name="l876" href="#l876">876</a><td>    return path;<tr><td><a name="l877" href="#l877">877</a><td><tr><td><a name="l878" href="#l878">878</a><td>  } else {<tr><td><a name="l879" href="#l879">879</a><td>    var leadingSlash = goog.string.startsWith(path, &#39;/&#39;);<tr><td><a name="l880" href="#l880">880</a><td>    var segments = path.split(&#39;/&#39;);<tr><td><a name="l881" href="#l881">881</a><td>    var out = [];<tr><td><a name="l882" href="#l882">882</a><td><tr><td><a name="l883" href="#l883">883</a><td>    for (var pos = 0; pos &lt; segments.length; ) {<tr><td><a name="l884" href="#l884">884</a><td>      var segment = segments[pos++];<tr><td><a name="l885" href="#l885">885</a><td><tr><td><a name="l886" href="#l886">886</a><td>      if (segment == &#39;.&#39;) {<tr><td><a name="l887" href="#l887">887</a><td>        if (leadingSlash &amp;&amp; pos == segments.length) {<tr><td><a name="l888" href="#l888">888</a><td>          out.push(&#39;&#39;);<tr><td><a name="l889" href="#l889">889</a><td>        }<tr><td><a name="l890" href="#l890">890</a><td>      } else if (segment == &#39;..&#39;) {<tr><td><a name="l891" href="#l891">891</a><td>        if (out.length &gt; 1 || out.length == 1 &amp;&amp; out[0] != &#39;&#39;) {<tr><td><a name="l892" href="#l892">892</a><td>          out.pop();<tr><td><a name="l893" href="#l893">893</a><td>        }<tr><td><a name="l894" href="#l894">894</a><td>        if (leadingSlash &amp;&amp; pos == segments.length) {<tr><td><a name="l895" href="#l895">895</a><td>          out.push(&#39;&#39;);<tr><td><a name="l896" href="#l896">896</a><td>        }<tr><td><a name="l897" href="#l897">897</a><td>      } else {<tr><td><a name="l898" href="#l898">898</a><td>        out.push(segment);<tr><td><a name="l899" href="#l899">899</a><td>        leadingSlash = true;<tr><td><a name="l900" href="#l900">900</a><td>      }<tr><td><a name="l901" href="#l901">901</a><td>    }<tr><td><a name="l902" href="#l902">902</a><td><tr><td><a name="l903" href="#l903">903</a><td>    return out.join(&#39;/&#39;);<tr><td><a name="l904" href="#l904">904</a><td>  }<tr><td><a name="l905" href="#l905">905</a><td>};<tr><td><a name="l906" href="#l906">906</a><td><tr><td><a name="l907" href="#l907">907</a><td><tr><td><a name="l908" href="#l908">908</a><td>/**<tr><td><a name="l909" href="#l909">909</a><td> * Decodes a value or returns the empty string if it isn&#39;t defined or empty.<tr><td><a name="l910" href="#l910">910</a><td> * @param {string|undefined} val Value to decode.<tr><td><a name="l911" href="#l911">911</a><td> * @return {string} Decoded value.<tr><td><a name="l912" href="#l912">912</a><td> * @private<tr><td><a name="l913" href="#l913">913</a><td> */<tr><td><a name="l914" href="#l914">914</a><td>goog.Uri.decodeOrEmpty_ = function(val) {<tr><td><a name="l915" href="#l915">915</a><td>  // Don&#39;t use UrlDecode() here because val is not a query parameter.<tr><td><a name="l916" href="#l916">916</a><td>  return val ? decodeURIComponent(val) : &#39;&#39;;<tr><td><a name="l917" href="#l917">917</a><td>};<tr><td><a name="l918" href="#l918">918</a><td><tr><td><a name="l919" href="#l919">919</a><td><tr><td><a name="l920" href="#l920">920</a><td>/**<tr><td><a name="l921" href="#l921">921</a><td> * If unescapedPart is non null, then escapes any characters in it that aren&#39;t<tr><td><a name="l922" href="#l922">922</a><td> * valid characters in a url and also escapes any special characters that<tr><td><a name="l923" href="#l923">923</a><td> * appear in extra.<tr><td><a name="l924" href="#l924">924</a><td> *<tr><td><a name="l925" href="#l925">925</a><td> * @param {*} unescapedPart The string to encode.<tr><td><a name="l926" href="#l926">926</a><td> * @param {RegExp} extra A character set of characters in [\01-\177].<tr><td><a name="l927" href="#l927">927</a><td> * @return {?string} null iff unescapedPart == null.<tr><td><a name="l928" href="#l928">928</a><td> * @private<tr><td><a name="l929" href="#l929">929</a><td> */<tr><td><a name="l930" href="#l930">930</a><td>goog.Uri.encodeSpecialChars_ = function(unescapedPart, extra) {<tr><td><a name="l931" href="#l931">931</a><td>  if (goog.isString(unescapedPart)) {<tr><td><a name="l932" href="#l932">932</a><td>    return encodeURI(unescapedPart).replace(extra, goog.Uri.encodeChar_);<tr><td><a name="l933" href="#l933">933</a><td>  }<tr><td><a name="l934" href="#l934">934</a><td>  return null;<tr><td><a name="l935" href="#l935">935</a><td>};<tr><td><a name="l936" href="#l936">936</a><td><tr><td><a name="l937" href="#l937">937</a><td><tr><td><a name="l938" href="#l938">938</a><td>/**<tr><td><a name="l939" href="#l939">939</a><td> * Converts a character in [\01-\177] to its unicode character equivalent.<tr><td><a name="l940" href="#l940">940</a><td> * @param {string} ch One character string.<tr><td><a name="l941" href="#l941">941</a><td> * @return {string} Encoded string.<tr><td><a name="l942" href="#l942">942</a><td> * @private<tr><td><a name="l943" href="#l943">943</a><td> */<tr><td><a name="l944" href="#l944">944</a><td>goog.Uri.encodeChar_ = function(ch) {<tr><td><a name="l945" href="#l945">945</a><td>  var n = ch.charCodeAt(0);<tr><td><a name="l946" href="#l946">946</a><td>  return &#39;%&#39; + ((n &gt;&gt; 4) &amp; 0xf).toString(16) + (n &amp; 0xf).toString(16);<tr><td><a name="l947" href="#l947">947</a><td>};<tr><td><a name="l948" href="#l948">948</a><td><tr><td><a name="l949" href="#l949">949</a><td><tr><td><a name="l950" href="#l950">950</a><td>/**<tr><td><a name="l951" href="#l951">951</a><td> * Regular expression for characters that are disallowed in the scheme or<tr><td><a name="l952" href="#l952">952</a><td> * userInfo part of the URI.<tr><td><a name="l953" href="#l953">953</a><td> * @type {RegExp}<tr><td><a name="l954" href="#l954">954</a><td> * @private<tr><td><a name="l955" href="#l955">955</a><td> */<tr><td><a name="l956" href="#l956">956</a><td>goog.Uri.reDisallowedInSchemeOrUserInfo_ = /[#\/\?@]/g;<tr><td><a name="l957" href="#l957">957</a><td><tr><td><a name="l958" href="#l958">958</a><td><tr><td><a name="l959" href="#l959">959</a><td>/**<tr><td><a name="l960" href="#l960">960</a><td> * Regular expression for characters that are disallowed in a relative path.<tr><td><a name="l961" href="#l961">961</a><td> * @type {RegExp}<tr><td><a name="l962" href="#l962">962</a><td> * @private<tr><td><a name="l963" href="#l963">963</a><td> */<tr><td><a name="l964" href="#l964">964</a><td>goog.Uri.reDisallowedInRelativePath_ = /[\#\?:]/g;<tr><td><a name="l965" href="#l965">965</a><td><tr><td><a name="l966" href="#l966">966</a><td><tr><td><a name="l967" href="#l967">967</a><td>/**<tr><td><a name="l968" href="#l968">968</a><td> * Regular expression for characters that are disallowed in an absolute path.<tr><td><a name="l969" href="#l969">969</a><td> * @type {RegExp}<tr><td><a name="l970" href="#l970">970</a><td> * @private<tr><td><a name="l971" href="#l971">971</a><td> */<tr><td><a name="l972" href="#l972">972</a><td>goog.Uri.reDisallowedInAbsolutePath_ = /[\#\?]/g;<tr><td><a name="l973" href="#l973">973</a><td><tr><td><a name="l974" href="#l974">974</a><td><tr><td><a name="l975" href="#l975">975</a><td>/**<tr><td><a name="l976" href="#l976">976</a><td> * Regular expression for characters that are disallowed in the query.<tr><td><a name="l977" href="#l977">977</a><td> * @type {RegExp}<tr><td><a name="l978" href="#l978">978</a><td> * @private<tr><td><a name="l979" href="#l979">979</a><td> */<tr><td><a name="l980" href="#l980">980</a><td>goog.Uri.reDisallowedInQuery_ = /[\#\?@]/g;<tr><td><a name="l981" href="#l981">981</a><td><tr><td><a name="l982" href="#l982">982</a><td><tr><td><a name="l983" href="#l983">983</a><td>/**<tr><td><a name="l984" href="#l984">984</a><td> * Regular expression for characters that are disallowed in the fragment.<tr><td><a name="l985" href="#l985">985</a><td> * @type {RegExp}<tr><td><a name="l986" href="#l986">986</a><td> * @private<tr><td><a name="l987" href="#l987">987</a><td> */<tr><td><a name="l988" href="#l988">988</a><td>goog.Uri.reDisallowedInFragment_ = /#/g;<tr><td><a name="l989" href="#l989">989</a><td><tr><td><a name="l990" href="#l990">990</a><td><tr><td><a name="l991" href="#l991">991</a><td>/**<tr><td><a name="l992" href="#l992">992</a><td> * Checks whether two URIs have the same domain.<tr><td><a name="l993" href="#l993">993</a><td> * @param {string} uri1String First URI string.<tr><td><a name="l994" href="#l994">994</a><td> * @param {string} uri2String Second URI string.<tr><td><a name="l995" href="#l995">995</a><td> * @return {boolean} true if the two URIs have the same domain; false otherwise.<tr><td><a name="l996" href="#l996">996</a><td> */<tr><td><a name="l997" href="#l997">997</a><td>goog.Uri.haveSameDomain = function(uri1String, uri2String) {<tr><td><a name="l998" href="#l998">998</a><td>  // Differs from goog.uri.utils.haveSameDomain, since this ignores scheme.<tr><td><a name="l999" href="#l999">999</a><td>  // TODO(gboyer): Have this just call goog.uri.util.haveSameDomain.<tr><td><a name="l1000" href="#l1000">1000</a><td>  var pieces1 = goog.uri.utils.split(uri1String);<tr><td><a name="l1001" href="#l1001">1001</a><td>  var pieces2 = goog.uri.utils.split(uri2String);<tr><td><a name="l1002" href="#l1002">1002</a><td>  return pieces1[goog.uri.utils.ComponentIndex.DOMAIN] ==<tr><td><a name="l1003" href="#l1003">1003</a><td>             pieces2[goog.uri.utils.ComponentIndex.DOMAIN] &amp;&amp;<tr><td><a name="l1004" href="#l1004">1004</a><td>         pieces1[goog.uri.utils.ComponentIndex.PORT] ==<tr><td><a name="l1005" href="#l1005">1005</a><td>             pieces2[goog.uri.utils.ComponentIndex.PORT];<tr><td><a name="l1006" href="#l1006">1006</a><td>};<tr><td><a name="l1007" href="#l1007">1007</a><td><tr><td><a name="l1008" href="#l1008">1008</a><td><tr><td><a name="l1009" href="#l1009">1009</a><td><tr><td><a name="l1010" href="#l1010">1010</a><td>/**<tr><td><a name="l1011" href="#l1011">1011</a><td> * Class used to represent URI query parameters.  It is essentially a hash of<tr><td><a name="l1012" href="#l1012">1012</a><td> * name-value pairs, though a name can be present more than once.<tr><td><a name="l1013" href="#l1013">1013</a><td> *<tr><td><a name="l1014" href="#l1014">1014</a><td> * Has the same interface as the collections in goog.structs.<tr><td><a name="l1015" href="#l1015">1015</a><td> *<tr><td><a name="l1016" href="#l1016">1016</a><td> * @param {?string=} opt_query Optional encoded query string to parse into<tr><td><a name="l1017" href="#l1017">1017</a><td> *     the object.<tr><td><a name="l1018" href="#l1018">1018</a><td> * @param {goog.Uri=} opt_uri Optional uri object that should have its<tr><td><a name="l1019" href="#l1019">1019</a><td> *     cache invalidated when this object updates. Deprecated -- this<tr><td><a name="l1020" href="#l1020">1020</a><td> *     is no longer required.<tr><td><a name="l1021" href="#l1021">1021</a><td> * @param {boolean=} opt_ignoreCase If true, ignore the case of the parameter<tr><td><a name="l1022" href="#l1022">1022</a><td> *     name in #get.<tr><td><a name="l1023" href="#l1023">1023</a><td> * @constructor<tr><td><a name="l1024" href="#l1024">1024</a><td> */<tr><td><a name="l1025" href="#l1025">1025</a><td>goog.Uri.QueryData = function(opt_query, opt_uri, opt_ignoreCase) {<tr><td><a name="l1026" href="#l1026">1026</a><td>  /**<tr><td><a name="l1027" href="#l1027">1027</a><td>   * Encoded query string, or null if it requires computing from the key map.<tr><td><a name="l1028" href="#l1028">1028</a><td>   * @type {?string}<tr><td><a name="l1029" href="#l1029">1029</a><td>   * @private<tr><td><a name="l1030" href="#l1030">1030</a><td>   */<tr><td><a name="l1031" href="#l1031">1031</a><td>  this.encodedQuery_ = opt_query || null;<tr><td><a name="l1032" href="#l1032">1032</a><td><tr><td><a name="l1033" href="#l1033">1033</a><td>  /**<tr><td><a name="l1034" href="#l1034">1034</a><td>   * If true, ignore the case of the parameter name in #get.<tr><td><a name="l1035" href="#l1035">1035</a><td>   * @type {boolean}<tr><td><a name="l1036" href="#l1036">1036</a><td>   * @private<tr><td><a name="l1037" href="#l1037">1037</a><td>   */<tr><td><a name="l1038" href="#l1038">1038</a><td>  this.ignoreCase_ = !!opt_ignoreCase;<tr><td><a name="l1039" href="#l1039">1039</a><td>};<tr><td><a name="l1040" href="#l1040">1040</a><td><tr><td><a name="l1041" href="#l1041">1041</a><td><tr><td><a name="l1042" href="#l1042">1042</a><td>/**<tr><td><a name="l1043" href="#l1043">1043</a><td> * If the underlying key map is not yet initialized, it parses the<tr><td><a name="l1044" href="#l1044">1044</a><td> * query string and fills the map with parsed data.<tr><td><a name="l1045" href="#l1045">1045</a><td> * @private<tr><td><a name="l1046" href="#l1046">1046</a><td> */<tr><td><a name="l1047" href="#l1047">1047</a><td>goog.Uri.QueryData.prototype.ensureKeyMapInitialized_ = function() {<tr><td><a name="l1048" href="#l1048">1048</a><td>  if (!this.keyMap_) {<tr><td><a name="l1049" href="#l1049">1049</a><td>    this.keyMap_ = new goog.structs.Map();<tr><td><a name="l1050" href="#l1050">1050</a><td>    this.count_ = 0;<tr><td><a name="l1051" href="#l1051">1051</a><td><tr><td><a name="l1052" href="#l1052">1052</a><td>    if (this.encodedQuery_) {<tr><td><a name="l1053" href="#l1053">1053</a><td>      var pairs = this.encodedQuery_.split(&#39;&amp;&#39;);<tr><td><a name="l1054" href="#l1054">1054</a><td>      for (var i = 0; i &lt; pairs.length; i++) {<tr><td><a name="l1055" href="#l1055">1055</a><td>        var indexOfEquals = pairs[i].indexOf(&#39;=&#39;);<tr><td><a name="l1056" href="#l1056">1056</a><td>        var name = null;<tr><td><a name="l1057" href="#l1057">1057</a><td>        var value = null;<tr><td><a name="l1058" href="#l1058">1058</a><td>        if (indexOfEquals &gt;= 0) {<tr><td><a name="l1059" href="#l1059">1059</a><td>          name = pairs[i].substring(0, indexOfEquals);<tr><td><a name="l1060" href="#l1060">1060</a><td>          value = pairs[i].substring(indexOfEquals + 1);<tr><td><a name="l1061" href="#l1061">1061</a><td>        } else {<tr><td><a name="l1062" href="#l1062">1062</a><td>          name = pairs[i];<tr><td><a name="l1063" href="#l1063">1063</a><td>        }<tr><td><a name="l1064" href="#l1064">1064</a><td>        name = goog.string.urlDecode(name);<tr><td><a name="l1065" href="#l1065">1065</a><td>        name = this.getKeyName_(name);<tr><td><a name="l1066" href="#l1066">1066</a><td>        this.add(name, value ? goog.string.urlDecode(value) : &#39;&#39;);<tr><td><a name="l1067" href="#l1067">1067</a><td>      }<tr><td><a name="l1068" href="#l1068">1068</a><td>    }<tr><td><a name="l1069" href="#l1069">1069</a><td>  }<tr><td><a name="l1070" href="#l1070">1070</a><td>};<tr><td><a name="l1071" href="#l1071">1071</a><td><tr><td><a name="l1072" href="#l1072">1072</a><td><tr><td><a name="l1073" href="#l1073">1073</a><td>/**<tr><td><a name="l1074" href="#l1074">1074</a><td> * Creates a new query data instance from a map of names and values.<tr><td><a name="l1075" href="#l1075">1075</a><td> *<tr><td><a name="l1076" href="#l1076">1076</a><td> * @param {!goog.structs.Map|!Object} map Map of string parameter<tr><td><a name="l1077" href="#l1077">1077</a><td> *     names to parameter value. If parameter value is an array, it is<tr><td><a name="l1078" href="#l1078">1078</a><td> *     treated as if the key maps to each individual value in the<tr><td><a name="l1079" href="#l1079">1079</a><td> *     array.<tr><td><a name="l1080" href="#l1080">1080</a><td> * @param {goog.Uri=} opt_uri URI object that should have its cache<tr><td><a name="l1081" href="#l1081">1081</a><td> *     invalidated when this object updates.<tr><td><a name="l1082" href="#l1082">1082</a><td> * @param {boolean=} opt_ignoreCase If true, ignore the case of the parameter<tr><td><a name="l1083" href="#l1083">1083</a><td> *     name in #get.<tr><td><a name="l1084" href="#l1084">1084</a><td> * @return {!goog.Uri.QueryData} The populated query data instance.<tr><td><a name="l1085" href="#l1085">1085</a><td> */<tr><td><a name="l1086" href="#l1086">1086</a><td>goog.Uri.QueryData.createFromMap = function(map, opt_uri, opt_ignoreCase) {<tr><td><a name="l1087" href="#l1087">1087</a><td>  var keys = goog.structs.getKeys(map);<tr><td><a name="l1088" href="#l1088">1088</a><td>  if (typeof keys == &#39;undefined&#39;) {<tr><td><a name="l1089" href="#l1089">1089</a><td>    throw Error(&#39;Keys are undefined&#39;);<tr><td><a name="l1090" href="#l1090">1090</a><td>  }<tr><td><a name="l1091" href="#l1091">1091</a><td><tr><td><a name="l1092" href="#l1092">1092</a><td>  var queryData = new goog.Uri.QueryData(null, null, opt_ignoreCase);<tr><td><a name="l1093" href="#l1093">1093</a><td>  var values = goog.structs.getValues(map);<tr><td><a name="l1094" href="#l1094">1094</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a name="l1095" href="#l1095">1095</a><td>    var key = keys[i];<tr><td><a name="l1096" href="#l1096">1096</a><td>    var value = values[i];<tr><td><a name="l1097" href="#l1097">1097</a><td>    if (!goog.isArray(value)) {<tr><td><a name="l1098" href="#l1098">1098</a><td>      queryData.add(key, value);<tr><td><a name="l1099" href="#l1099">1099</a><td>    } else {<tr><td><a name="l1100" href="#l1100">1100</a><td>      queryData.setValues(key, value);<tr><td><a name="l1101" href="#l1101">1101</a><td>    }<tr><td><a name="l1102" href="#l1102">1102</a><td>  }<tr><td><a name="l1103" href="#l1103">1103</a><td>  return queryData;<tr><td><a name="l1104" href="#l1104">1104</a><td>};<tr><td><a name="l1105" href="#l1105">1105</a><td><tr><td><a name="l1106" href="#l1106">1106</a><td><tr><td><a name="l1107" href="#l1107">1107</a><td>/**<tr><td><a name="l1108" href="#l1108">1108</a><td> * Creates a new query data instance from parallel arrays of parameter names<tr><td><a name="l1109" href="#l1109">1109</a><td> * and values. Allows for duplicate parameter names. Throws an error if the<tr><td><a name="l1110" href="#l1110">1110</a><td> * lengths of the arrays differ.<tr><td><a name="l1111" href="#l1111">1111</a><td> *<tr><td><a name="l1112" href="#l1112">1112</a><td> * @param {Array.&lt;string&gt;} keys Parameter names.<tr><td><a name="l1113" href="#l1113">1113</a><td> * @param {Array} values Parameter values.<tr><td><a name="l1114" href="#l1114">1114</a><td> * @param {goog.Uri=} opt_uri URI object that should have its cache<tr><td><a name="l1115" href="#l1115">1115</a><td> *     invalidated when this object updates.<tr><td><a name="l1116" href="#l1116">1116</a><td> * @param {boolean=} opt_ignoreCase If true, ignore the case of the parameter<tr><td><a name="l1117" href="#l1117">1117</a><td> *     name in #get.<tr><td><a name="l1118" href="#l1118">1118</a><td> * @return {!goog.Uri.QueryData} The populated query data instance.<tr><td><a name="l1119" href="#l1119">1119</a><td> */<tr><td><a name="l1120" href="#l1120">1120</a><td>goog.Uri.QueryData.createFromKeysValues = function(<tr><td><a name="l1121" href="#l1121">1121</a><td>    keys, values, opt_uri, opt_ignoreCase) {<tr><td><a name="l1122" href="#l1122">1122</a><td>  if (keys.length != values.length) {<tr><td><a name="l1123" href="#l1123">1123</a><td>    throw Error(&#39;Mismatched lengths for keys/values&#39;);<tr><td><a name="l1124" href="#l1124">1124</a><td>  }<tr><td><a name="l1125" href="#l1125">1125</a><td>  var queryData = new goog.Uri.QueryData(null, null, opt_ignoreCase);<tr><td><a name="l1126" href="#l1126">1126</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a name="l1127" href="#l1127">1127</a><td>    queryData.add(keys[i], values[i]);<tr><td><a name="l1128" href="#l1128">1128</a><td>  }<tr><td><a name="l1129" href="#l1129">1129</a><td>  return queryData;<tr><td><a name="l1130" href="#l1130">1130</a><td>};<tr><td><a name="l1131" href="#l1131">1131</a><td><tr><td><a name="l1132" href="#l1132">1132</a><td><tr><td><a name="l1133" href="#l1133">1133</a><td>/**<tr><td><a name="l1134" href="#l1134">1134</a><td> * The map containing name/value or name/array-of-values pairs.<tr><td><a name="l1135" href="#l1135">1135</a><td> * May be null if it requires parsing from the query string.<tr><td><a name="l1136" href="#l1136">1136</a><td> *<tr><td><a name="l1137" href="#l1137">1137</a><td> * We need to use a Map because we cannot guarantee that the key names will<tr><td><a name="l1138" href="#l1138">1138</a><td> * not be problematic for IE.<tr><td><a name="l1139" href="#l1139">1139</a><td> *<tr><td><a name="l1140" href="#l1140">1140</a><td> * @type {goog.structs.Map}<tr><td><a name="l1141" href="#l1141">1141</a><td> * @private<tr><td><a name="l1142" href="#l1142">1142</a><td> */<tr><td><a name="l1143" href="#l1143">1143</a><td>goog.Uri.QueryData.prototype.keyMap_ = null;<tr><td><a name="l1144" href="#l1144">1144</a><td><tr><td><a name="l1145" href="#l1145">1145</a><td><tr><td><a name="l1146" href="#l1146">1146</a><td>/**<tr><td><a name="l1147" href="#l1147">1147</a><td> * The number of params, or null if it requires computing.<tr><td><a name="l1148" href="#l1148">1148</a><td> * @type {?number}<tr><td><a name="l1149" href="#l1149">1149</a><td> * @private<tr><td><a name="l1150" href="#l1150">1150</a><td> */<tr><td><a name="l1151" href="#l1151">1151</a><td>goog.Uri.QueryData.prototype.count_ = null;<tr><td><a name="l1152" href="#l1152">1152</a><td><tr><td><a name="l1153" href="#l1153">1153</a><td><tr><td><a name="l1154" href="#l1154">1154</a><td>/**<tr><td><a name="l1155" href="#l1155">1155</a><td> * @return {?number} The number of parameters.<tr><td><a name="l1156" href="#l1156">1156</a><td> */<tr><td><a name="l1157" href="#l1157">1157</a><td>goog.Uri.QueryData.prototype.getCount = function() {<tr><td><a name="l1158" href="#l1158">1158</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1159" href="#l1159">1159</a><td>  return this.count_;<tr><td><a name="l1160" href="#l1160">1160</a><td>};<tr><td><a name="l1161" href="#l1161">1161</a><td><tr><td><a name="l1162" href="#l1162">1162</a><td><tr><td><a name="l1163" href="#l1163">1163</a><td>/**<tr><td><a name="l1164" href="#l1164">1164</a><td> * Adds a key value pair.<tr><td><a name="l1165" href="#l1165">1165</a><td> * @param {string} key Name.<tr><td><a name="l1166" href="#l1166">1166</a><td> * @param {*} value Value.<tr><td><a name="l1167" href="#l1167">1167</a><td> * @return {!goog.Uri.QueryData} Instance of this object.<tr><td><a name="l1168" href="#l1168">1168</a><td> */<tr><td><a name="l1169" href="#l1169">1169</a><td>goog.Uri.QueryData.prototype.add = function(key, value) {<tr><td><a name="l1170" href="#l1170">1170</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1171" href="#l1171">1171</a><td>  this.invalidateCache_();<tr><td><a name="l1172" href="#l1172">1172</a><td><tr><td><a name="l1173" href="#l1173">1173</a><td>  key = this.getKeyName_(key);<tr><td><a name="l1174" href="#l1174">1174</a><td>  var values = this.keyMap_.get(key);<tr><td><a name="l1175" href="#l1175">1175</a><td>  if (!values) {<tr><td><a name="l1176" href="#l1176">1176</a><td>    this.keyMap_.set(key, (values = []));<tr><td><a name="l1177" href="#l1177">1177</a><td>  }<tr><td><a name="l1178" href="#l1178">1178</a><td>  values.push(value);<tr><td><a name="l1179" href="#l1179">1179</a><td>  this.count_++;<tr><td><a name="l1180" href="#l1180">1180</a><td>  return this;<tr><td><a name="l1181" href="#l1181">1181</a><td>};<tr><td><a name="l1182" href="#l1182">1182</a><td><tr><td><a name="l1183" href="#l1183">1183</a><td><tr><td><a name="l1184" href="#l1184">1184</a><td>/**<tr><td><a name="l1185" href="#l1185">1185</a><td> * Removes all the params with the given key.<tr><td><a name="l1186" href="#l1186">1186</a><td> * @param {string} key Name.<tr><td><a name="l1187" href="#l1187">1187</a><td> * @return {boolean} Whether any parameter was removed.<tr><td><a name="l1188" href="#l1188">1188</a><td> */<tr><td><a name="l1189" href="#l1189">1189</a><td>goog.Uri.QueryData.prototype.remove = function(key) {<tr><td><a name="l1190" href="#l1190">1190</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1191" href="#l1191">1191</a><td><tr><td><a name="l1192" href="#l1192">1192</a><td>  key = this.getKeyName_(key);<tr><td><a name="l1193" href="#l1193">1193</a><td>  if (this.keyMap_.containsKey(key)) {<tr><td><a name="l1194" href="#l1194">1194</a><td>    this.invalidateCache_();<tr><td><a name="l1195" href="#l1195">1195</a><td><tr><td><a name="l1196" href="#l1196">1196</a><td>    // Decrement parameter count.<tr><td><a name="l1197" href="#l1197">1197</a><td>    this.count_ -= this.keyMap_.get(key).length;<tr><td><a name="l1198" href="#l1198">1198</a><td>    return this.keyMap_.remove(key);<tr><td><a name="l1199" href="#l1199">1199</a><td>  }<tr><td><a name="l1200" href="#l1200">1200</a><td>  return false;<tr><td><a name="l1201" href="#l1201">1201</a><td>};<tr><td><a name="l1202" href="#l1202">1202</a><td><tr><td><a name="l1203" href="#l1203">1203</a><td><tr><td><a name="l1204" href="#l1204">1204</a><td>/**<tr><td><a name="l1205" href="#l1205">1205</a><td> * Clears the parameters.<tr><td><a name="l1206" href="#l1206">1206</a><td> */<tr><td><a name="l1207" href="#l1207">1207</a><td>goog.Uri.QueryData.prototype.clear = function() {<tr><td><a name="l1208" href="#l1208">1208</a><td>  this.invalidateCache_();<tr><td><a name="l1209" href="#l1209">1209</a><td>  this.keyMap_ = null;<tr><td><a name="l1210" href="#l1210">1210</a><td>  this.count_ = 0;<tr><td><a name="l1211" href="#l1211">1211</a><td>};<tr><td><a name="l1212" href="#l1212">1212</a><td><tr><td><a name="l1213" href="#l1213">1213</a><td><tr><td><a name="l1214" href="#l1214">1214</a><td>/**<tr><td><a name="l1215" href="#l1215">1215</a><td> * @return {boolean} Whether we have any parameters.<tr><td><a name="l1216" href="#l1216">1216</a><td> */<tr><td><a name="l1217" href="#l1217">1217</a><td>goog.Uri.QueryData.prototype.isEmpty = function() {<tr><td><a name="l1218" href="#l1218">1218</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1219" href="#l1219">1219</a><td>  return this.count_ == 0;<tr><td><a name="l1220" href="#l1220">1220</a><td>};<tr><td><a name="l1221" href="#l1221">1221</a><td><tr><td><a name="l1222" href="#l1222">1222</a><td><tr><td><a name="l1223" href="#l1223">1223</a><td>/**<tr><td><a name="l1224" href="#l1224">1224</a><td> * Whether there is a parameter with the given name<tr><td><a name="l1225" href="#l1225">1225</a><td> * @param {string} key The parameter name to check for.<tr><td><a name="l1226" href="#l1226">1226</a><td> * @return {boolean} Whether there is a parameter with the given name.<tr><td><a name="l1227" href="#l1227">1227</a><td> */<tr><td><a name="l1228" href="#l1228">1228</a><td>goog.Uri.QueryData.prototype.containsKey = function(key) {<tr><td><a name="l1229" href="#l1229">1229</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1230" href="#l1230">1230</a><td>  key = this.getKeyName_(key);<tr><td><a name="l1231" href="#l1231">1231</a><td>  return this.keyMap_.containsKey(key);<tr><td><a name="l1232" href="#l1232">1232</a><td>};<tr><td><a name="l1233" href="#l1233">1233</a><td><tr><td><a name="l1234" href="#l1234">1234</a><td><tr><td><a name="l1235" href="#l1235">1235</a><td>/**<tr><td><a name="l1236" href="#l1236">1236</a><td> * Whether there is a parameter with the given value.<tr><td><a name="l1237" href="#l1237">1237</a><td> * @param {*} value The value to check for.<tr><td><a name="l1238" href="#l1238">1238</a><td> * @return {boolean} Whether there is a parameter with the given value.<tr><td><a name="l1239" href="#l1239">1239</a><td> */<tr><td><a name="l1240" href="#l1240">1240</a><td>goog.Uri.QueryData.prototype.containsValue = function(value) {<tr><td><a name="l1241" href="#l1241">1241</a><td>  // NOTE(arv): This solution goes through all the params even if it was the<tr><td><a name="l1242" href="#l1242">1242</a><td>  // first param. We can get around this by not reusing code or by switching to<tr><td><a name="l1243" href="#l1243">1243</a><td>  // iterators.<tr><td><a name="l1244" href="#l1244">1244</a><td>  var vals = this.getValues();<tr><td><a name="l1245" href="#l1245">1245</a><td>  return goog.array.contains(vals, value);<tr><td><a name="l1246" href="#l1246">1246</a><td>};<tr><td><a name="l1247" href="#l1247">1247</a><td><tr><td><a name="l1248" href="#l1248">1248</a><td><tr><td><a name="l1249" href="#l1249">1249</a><td>/**<tr><td><a name="l1250" href="#l1250">1250</a><td> * Returns all the keys of the parameters. If a key is used multiple times<tr><td><a name="l1251" href="#l1251">1251</a><td> * it will be included multiple times in the returned array<tr><td><a name="l1252" href="#l1252">1252</a><td> * @return {!Array.&lt;string&gt;} All the keys of the parameters.<tr><td><a name="l1253" href="#l1253">1253</a><td> */<tr><td><a name="l1254" href="#l1254">1254</a><td>goog.Uri.QueryData.prototype.getKeys = function() {<tr><td><a name="l1255" href="#l1255">1255</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1256" href="#l1256">1256</a><td>  // We need to get the values to know how many keys to add.<tr><td><a name="l1257" href="#l1257">1257</a><td>  var vals = /** @type {Array.&lt;Array|*&gt;} */ (this.keyMap_.getValues());<tr><td><a name="l1258" href="#l1258">1258</a><td>  var keys = this.keyMap_.getKeys();<tr><td><a name="l1259" href="#l1259">1259</a><td>  var rv = [];<tr><td><a name="l1260" href="#l1260">1260</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a name="l1261" href="#l1261">1261</a><td>    var val = vals[i];<tr><td><a name="l1262" href="#l1262">1262</a><td>    for (var j = 0; j &lt; val.length; j++) {<tr><td><a name="l1263" href="#l1263">1263</a><td>      rv.push(keys[i]);<tr><td><a name="l1264" href="#l1264">1264</a><td>    }<tr><td><a name="l1265" href="#l1265">1265</a><td>  }<tr><td><a name="l1266" href="#l1266">1266</a><td>  return rv;<tr><td><a name="l1267" href="#l1267">1267</a><td>};<tr><td><a name="l1268" href="#l1268">1268</a><td><tr><td><a name="l1269" href="#l1269">1269</a><td><tr><td><a name="l1270" href="#l1270">1270</a><td>/**<tr><td><a name="l1271" href="#l1271">1271</a><td> * Returns all the values of the parameters with the given name. If the query<tr><td><a name="l1272" href="#l1272">1272</a><td> * data has no such key this will return an empty array. If no key is given<tr><td><a name="l1273" href="#l1273">1273</a><td> * all values wil be returned.<tr><td><a name="l1274" href="#l1274">1274</a><td> * @param {string=} opt_key The name of the parameter to get the values for.<tr><td><a name="l1275" href="#l1275">1275</a><td> * @return {!Array} All the values of the parameters with the given name.<tr><td><a name="l1276" href="#l1276">1276</a><td> */<tr><td><a name="l1277" href="#l1277">1277</a><td>goog.Uri.QueryData.prototype.getValues = function(opt_key) {<tr><td><a name="l1278" href="#l1278">1278</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1279" href="#l1279">1279</a><td>  var rv = [];<tr><td><a name="l1280" href="#l1280">1280</a><td>  if (opt_key) {<tr><td><a name="l1281" href="#l1281">1281</a><td>    if (this.containsKey(opt_key)) {<tr><td><a name="l1282" href="#l1282">1282</a><td>      rv = goog.array.concat(rv, this.keyMap_.get(this.getKeyName_(opt_key)));<tr><td><a name="l1283" href="#l1283">1283</a><td>    }<tr><td><a name="l1284" href="#l1284">1284</a><td>  } else {<tr><td><a name="l1285" href="#l1285">1285</a><td>    // Return all values.<tr><td><a name="l1286" href="#l1286">1286</a><td>    var values = /** @type {Array.&lt;Array|*&gt;} */ (this.keyMap_.getValues());<tr><td><a name="l1287" href="#l1287">1287</a><td>    for (var i = 0; i &lt; values.length; i++) {<tr><td><a name="l1288" href="#l1288">1288</a><td>      rv = goog.array.concat(rv, values[i]);<tr><td><a name="l1289" href="#l1289">1289</a><td>    }<tr><td><a name="l1290" href="#l1290">1290</a><td>  }<tr><td><a name="l1291" href="#l1291">1291</a><td>  return rv;<tr><td><a name="l1292" href="#l1292">1292</a><td>};<tr><td><a name="l1293" href="#l1293">1293</a><td><tr><td><a name="l1294" href="#l1294">1294</a><td><tr><td><a name="l1295" href="#l1295">1295</a><td>/**<tr><td><a name="l1296" href="#l1296">1296</a><td> * Sets a key value pair and removes all other keys with the same value.<tr><td><a name="l1297" href="#l1297">1297</a><td> *<tr><td><a name="l1298" href="#l1298">1298</a><td> * @param {string} key Name.<tr><td><a name="l1299" href="#l1299">1299</a><td> * @param {*} value Value.<tr><td><a name="l1300" href="#l1300">1300</a><td> * @return {!goog.Uri.QueryData} Instance of this object.<tr><td><a name="l1301" href="#l1301">1301</a><td> */<tr><td><a name="l1302" href="#l1302">1302</a><td>goog.Uri.QueryData.prototype.set = function(key, value) {<tr><td><a name="l1303" href="#l1303">1303</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1304" href="#l1304">1304</a><td>  this.invalidateCache_();<tr><td><a name="l1305" href="#l1305">1305</a><td><tr><td><a name="l1306" href="#l1306">1306</a><td>  // TODO(user): This could be better written as<tr><td><a name="l1307" href="#l1307">1307</a><td>  // this.remove(key), this.add(key, value), but that would reorder<tr><td><a name="l1308" href="#l1308">1308</a><td>  // the key (since the key is first removed and then added at the<tr><td><a name="l1309" href="#l1309">1309</a><td>  // end) and we would have to fix unit tests that depend on key<tr><td><a name="l1310" href="#l1310">1310</a><td>  // ordering.<tr><td><a name="l1311" href="#l1311">1311</a><td>  key = this.getKeyName_(key);<tr><td><a name="l1312" href="#l1312">1312</a><td>  if (this.containsKey(key)) {<tr><td><a name="l1313" href="#l1313">1313</a><td>    this.count_ -= this.keyMap_.get(key).length;<tr><td><a name="l1314" href="#l1314">1314</a><td>  }<tr><td><a name="l1315" href="#l1315">1315</a><td>  this.keyMap_.set(key, [value]);<tr><td><a name="l1316" href="#l1316">1316</a><td>  this.count_++;<tr><td><a name="l1317" href="#l1317">1317</a><td>  return this;<tr><td><a name="l1318" href="#l1318">1318</a><td>};<tr><td><a name="l1319" href="#l1319">1319</a><td><tr><td><a name="l1320" href="#l1320">1320</a><td><tr><td><a name="l1321" href="#l1321">1321</a><td>/**<tr><td><a name="l1322" href="#l1322">1322</a><td> * Returns the first value associated with the key. If the query data has no<tr><td><a name="l1323" href="#l1323">1323</a><td> * such key this will return undefined or the optional default.<tr><td><a name="l1324" href="#l1324">1324</a><td> * @param {string} key The name of the parameter to get the value for.<tr><td><a name="l1325" href="#l1325">1325</a><td> * @param {*=} opt_default The default value to return if the query data<tr><td><a name="l1326" href="#l1326">1326</a><td> *     has no such key.<tr><td><a name="l1327" href="#l1327">1327</a><td> * @return {*} The first string value associated with the key, or opt_default<tr><td><a name="l1328" href="#l1328">1328</a><td> *     if there&#39;s no value.<tr><td><a name="l1329" href="#l1329">1329</a><td> */<tr><td><a name="l1330" href="#l1330">1330</a><td>goog.Uri.QueryData.prototype.get = function(key, opt_default) {<tr><td><a name="l1331" href="#l1331">1331</a><td>  var values = key ? this.getValues(key) : [];<tr><td><a name="l1332" href="#l1332">1332</a><td>  if (goog.Uri.preserveParameterTypesCompatibilityFlag) {<tr><td><a name="l1333" href="#l1333">1333</a><td>    return values.length &gt; 0 ? values[0] : opt_default;<tr><td><a name="l1334" href="#l1334">1334</a><td>  } else {<tr><td><a name="l1335" href="#l1335">1335</a><td>    return values.length &gt; 0 ? String(values[0]) : opt_default;<tr><td><a name="l1336" href="#l1336">1336</a><td>  }<tr><td><a name="l1337" href="#l1337">1337</a><td>};<tr><td><a name="l1338" href="#l1338">1338</a><td><tr><td><a name="l1339" href="#l1339">1339</a><td><tr><td><a name="l1340" href="#l1340">1340</a><td>/**<tr><td><a name="l1341" href="#l1341">1341</a><td> * Sets the values for a key. If the key already exists, this will<tr><td><a name="l1342" href="#l1342">1342</a><td> * override all of the existing values that correspond to the key.<tr><td><a name="l1343" href="#l1343">1343</a><td> * @param {string} key The key to set values for.<tr><td><a name="l1344" href="#l1344">1344</a><td> * @param {Array} values The values to set.<tr><td><a name="l1345" href="#l1345">1345</a><td> */<tr><td><a name="l1346" href="#l1346">1346</a><td>goog.Uri.QueryData.prototype.setValues = function(key, values) {<tr><td><a name="l1347" href="#l1347">1347</a><td>  this.remove(key);<tr><td><a name="l1348" href="#l1348">1348</a><td><tr><td><a name="l1349" href="#l1349">1349</a><td>  if (values.length &gt; 0) {<tr><td><a name="l1350" href="#l1350">1350</a><td>    this.invalidateCache_();<tr><td><a name="l1351" href="#l1351">1351</a><td>    this.keyMap_.set(this.getKeyName_(key), goog.array.clone(values));<tr><td><a name="l1352" href="#l1352">1352</a><td>    this.count_ += values.length;<tr><td><a name="l1353" href="#l1353">1353</a><td>  }<tr><td><a name="l1354" href="#l1354">1354</a><td>};<tr><td><a name="l1355" href="#l1355">1355</a><td><tr><td><a name="l1356" href="#l1356">1356</a><td><tr><td><a name="l1357" href="#l1357">1357</a><td>/**<tr><td><a name="l1358" href="#l1358">1358</a><td> * @return {string} Encoded query string.<tr><td><a name="l1359" href="#l1359">1359</a><td> * @override<tr><td><a name="l1360" href="#l1360">1360</a><td> */<tr><td><a name="l1361" href="#l1361">1361</a><td>goog.Uri.QueryData.prototype.toString = function() {<tr><td><a name="l1362" href="#l1362">1362</a><td>  if (this.encodedQuery_) {<tr><td><a name="l1363" href="#l1363">1363</a><td>    return this.encodedQuery_;<tr><td><a name="l1364" href="#l1364">1364</a><td>  }<tr><td><a name="l1365" href="#l1365">1365</a><td><tr><td><a name="l1366" href="#l1366">1366</a><td>  if (!this.keyMap_) {<tr><td><a name="l1367" href="#l1367">1367</a><td>    return &#39;&#39;;<tr><td><a name="l1368" href="#l1368">1368</a><td>  }<tr><td><a name="l1369" href="#l1369">1369</a><td><tr><td><a name="l1370" href="#l1370">1370</a><td>  var sb = [];<tr><td><a name="l1371" href="#l1371">1371</a><td><tr><td><a name="l1372" href="#l1372">1372</a><td>  // In the past, we use this.getKeys() and this.getVals(), but that<tr><td><a name="l1373" href="#l1373">1373</a><td>  // generates a lot of allocations as compared to simply iterating<tr><td><a name="l1374" href="#l1374">1374</a><td>  // over the keys.<tr><td><a name="l1375" href="#l1375">1375</a><td>  var keys = this.keyMap_.getKeys();<tr><td><a name="l1376" href="#l1376">1376</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a name="l1377" href="#l1377">1377</a><td>    var key = keys[i];<tr><td><a name="l1378" href="#l1378">1378</a><td>    var encodedKey = goog.string.urlEncode(key);<tr><td><a name="l1379" href="#l1379">1379</a><td>    var val = this.getValues(key);<tr><td><a name="l1380" href="#l1380">1380</a><td>    for (var j = 0; j &lt; val.length; j++) {<tr><td><a name="l1381" href="#l1381">1381</a><td>      var param = encodedKey;<tr><td><a name="l1382" href="#l1382">1382</a><td>      // Ensure that null and undefined are encoded into the url as<tr><td><a name="l1383" href="#l1383">1383</a><td>      // literal strings.<tr><td><a name="l1384" href="#l1384">1384</a><td>      if (val[j] !== &#39;&#39;) {<tr><td><a name="l1385" href="#l1385">1385</a><td>        param += &#39;=&#39; + goog.string.urlEncode(val[j]);<tr><td><a name="l1386" href="#l1386">1386</a><td>      }<tr><td><a name="l1387" href="#l1387">1387</a><td>      sb.push(param);<tr><td><a name="l1388" href="#l1388">1388</a><td>    }<tr><td><a name="l1389" href="#l1389">1389</a><td>  }<tr><td><a name="l1390" href="#l1390">1390</a><td><tr><td><a name="l1391" href="#l1391">1391</a><td>  return this.encodedQuery_ = sb.join(&#39;&amp;&#39;);<tr><td><a name="l1392" href="#l1392">1392</a><td>};<tr><td><a name="l1393" href="#l1393">1393</a><td><tr><td><a name="l1394" href="#l1394">1394</a><td><tr><td><a name="l1395" href="#l1395">1395</a><td>/**<tr><td><a name="l1396" href="#l1396">1396</a><td> * @return {string} Decoded query string.<tr><td><a name="l1397" href="#l1397">1397</a><td> */<tr><td><a name="l1398" href="#l1398">1398</a><td>goog.Uri.QueryData.prototype.toDecodedString = function() {<tr><td><a name="l1399" href="#l1399">1399</a><td>  return goog.Uri.decodeOrEmpty_(this.toString());<tr><td><a name="l1400" href="#l1400">1400</a><td>};<tr><td><a name="l1401" href="#l1401">1401</a><td><tr><td><a name="l1402" href="#l1402">1402</a><td><tr><td><a name="l1403" href="#l1403">1403</a><td>/**<tr><td><a name="l1404" href="#l1404">1404</a><td> * Invalidate the cache.<tr><td><a name="l1405" href="#l1405">1405</a><td> * @private<tr><td><a name="l1406" href="#l1406">1406</a><td> */<tr><td><a name="l1407" href="#l1407">1407</a><td>goog.Uri.QueryData.prototype.invalidateCache_ = function() {<tr><td><a name="l1408" href="#l1408">1408</a><td>  this.encodedQuery_ = null;<tr><td><a name="l1409" href="#l1409">1409</a><td>};<tr><td><a name="l1410" href="#l1410">1410</a><td><tr><td><a name="l1411" href="#l1411">1411</a><td><tr><td><a name="l1412" href="#l1412">1412</a><td>/**<tr><td><a name="l1413" href="#l1413">1413</a><td> * Removes all keys that are not in the provided list. (Modifies this object.)<tr><td><a name="l1414" href="#l1414">1414</a><td> * @param {Array.&lt;string&gt;} keys The desired keys.<tr><td><a name="l1415" href="#l1415">1415</a><td> * @return {!goog.Uri.QueryData} a reference to this object.<tr><td><a name="l1416" href="#l1416">1416</a><td> */<tr><td><a name="l1417" href="#l1417">1417</a><td>goog.Uri.QueryData.prototype.filterKeys = function(keys) {<tr><td><a name="l1418" href="#l1418">1418</a><td>  this.ensureKeyMapInitialized_();<tr><td><a name="l1419" href="#l1419">1419</a><td>  goog.structs.forEach(this.keyMap_,<tr><td><a name="l1420" href="#l1420">1420</a><td>      /** @this {goog.Uri.QueryData} */<tr><td><a name="l1421" href="#l1421">1421</a><td>      function(value, key, map) {<tr><td><a name="l1422" href="#l1422">1422</a><td>        if (!goog.array.contains(keys, key)) {<tr><td><a name="l1423" href="#l1423">1423</a><td>          this.remove(key);<tr><td><a name="l1424" href="#l1424">1424</a><td>        }<tr><td><a name="l1425" href="#l1425">1425</a><td>      }, this);<tr><td><a name="l1426" href="#l1426">1426</a><td>  return this;<tr><td><a name="l1427" href="#l1427">1427</a><td>};<tr><td><a name="l1428" href="#l1428">1428</a><td><tr><td><a name="l1429" href="#l1429">1429</a><td><tr><td><a name="l1430" href="#l1430">1430</a><td>/**<tr><td><a name="l1431" href="#l1431">1431</a><td> * Clone the query data instance.<tr><td><a name="l1432" href="#l1432">1432</a><td> * @return {!goog.Uri.QueryData} New instance of the QueryData object.<tr><td><a name="l1433" href="#l1433">1433</a><td> */<tr><td><a name="l1434" href="#l1434">1434</a><td>goog.Uri.QueryData.prototype.clone = function() {<tr><td><a name="l1435" href="#l1435">1435</a><td>  var rv = new goog.Uri.QueryData();<tr><td><a name="l1436" href="#l1436">1436</a><td>  rv.encodedQuery_ = this.encodedQuery_;<tr><td><a name="l1437" href="#l1437">1437</a><td>  if (this.keyMap_) {<tr><td><a name="l1438" href="#l1438">1438</a><td>    rv.keyMap_ = this.keyMap_.clone();<tr><td><a name="l1439" href="#l1439">1439</a><td>    rv.count_ = this.count_;<tr><td><a name="l1440" href="#l1440">1440</a><td>  }<tr><td><a name="l1441" href="#l1441">1441</a><td>  return rv;<tr><td><a name="l1442" href="#l1442">1442</a><td>};<tr><td><a name="l1443" href="#l1443">1443</a><td><tr><td><a name="l1444" href="#l1444">1444</a><td><tr><td><a name="l1445" href="#l1445">1445</a><td>/**<tr><td><a name="l1446" href="#l1446">1446</a><td> * Helper function to get the key name from a JavaScript object. Converts<tr><td><a name="l1447" href="#l1447">1447</a><td> * the object to a string, and to lower case if necessary.<tr><td><a name="l1448" href="#l1448">1448</a><td> * @private<tr><td><a name="l1449" href="#l1449">1449</a><td> * @param {*} arg The object to get a key name from.<tr><td><a name="l1450" href="#l1450">1450</a><td> * @return {string} valid key name which can be looked up in #keyMap_.<tr><td><a name="l1451" href="#l1451">1451</a><td> */<tr><td><a name="l1452" href="#l1452">1452</a><td>goog.Uri.QueryData.prototype.getKeyName_ = function(arg) {<tr><td><a name="l1453" href="#l1453">1453</a><td>  var keyName = String(arg);<tr><td><a name="l1454" href="#l1454">1454</a><td>  if (this.ignoreCase_) {<tr><td><a name="l1455" href="#l1455">1455</a><td>    keyName = keyName.toLowerCase();<tr><td><a name="l1456" href="#l1456">1456</a><td>  }<tr><td><a name="l1457" href="#l1457">1457</a><td>  return keyName;<tr><td><a name="l1458" href="#l1458">1458</a><td>};<tr><td><a name="l1459" href="#l1459">1459</a><td><tr><td><a name="l1460" href="#l1460">1460</a><td><tr><td><a name="l1461" href="#l1461">1461</a><td>/**<tr><td><a name="l1462" href="#l1462">1462</a><td> * Ignore case in parameter names.<tr><td><a name="l1463" href="#l1463">1463</a><td> * NOTE: If there are already key/value pairs in the QueryData, and<tr><td><a name="l1464" href="#l1464">1464</a><td> * ignoreCase_ is set to false, the keys will all be lower-cased.<tr><td><a name="l1465" href="#l1465">1465</a><td> * @param {boolean} ignoreCase whether this goog.Uri should ignore case.<tr><td><a name="l1466" href="#l1466">1466</a><td> */<tr><td><a name="l1467" href="#l1467">1467</a><td>goog.Uri.QueryData.prototype.setIgnoreCase = function(ignoreCase) {<tr><td><a name="l1468" href="#l1468">1468</a><td>  var resetKeys = ignoreCase &amp;&amp; !this.ignoreCase_;<tr><td><a name="l1469" href="#l1469">1469</a><td>  if (resetKeys) {<tr><td><a name="l1470" href="#l1470">1470</a><td>    this.ensureKeyMapInitialized_();<tr><td><a name="l1471" href="#l1471">1471</a><td>    this.invalidateCache_();<tr><td><a name="l1472" href="#l1472">1472</a><td>    goog.structs.forEach(this.keyMap_,<tr><td><a name="l1473" href="#l1473">1473</a><td>        /** @this {goog.Uri.QueryData} */<tr><td><a name="l1474" href="#l1474">1474</a><td>        function(value, key) {<tr><td><a name="l1475" href="#l1475">1475</a><td>          var lowerCase = key.toLowerCase();<tr><td><a name="l1476" href="#l1476">1476</a><td>          if (key != lowerCase) {<tr><td><a name="l1477" href="#l1477">1477</a><td>            this.remove(key);<tr><td><a name="l1478" href="#l1478">1478</a><td>            this.setValues(lowerCase, value);<tr><td><a name="l1479" href="#l1479">1479</a><td>          }<tr><td><a name="l1480" href="#l1480">1480</a><td>        }, this);<tr><td><a name="l1481" href="#l1481">1481</a><td>  }<tr><td><a name="l1482" href="#l1482">1482</a><td>  this.ignoreCase_ = ignoreCase;<tr><td><a name="l1483" href="#l1483">1483</a><td>};<tr><td><a name="l1484" href="#l1484">1484</a><td><tr><td><a name="l1485" href="#l1485">1485</a><td><tr><td><a name="l1486" href="#l1486">1486</a><td>/**<tr><td><a name="l1487" href="#l1487">1487</a><td> * Extends a query data object with another query data or map like object. This<tr><td><a name="l1488" href="#l1488">1488</a><td> * operates &#39;in-place&#39;, it does not create a new QueryData object.<tr><td><a name="l1489" href="#l1489">1489</a><td> *<tr><td><a name="l1490" href="#l1490">1490</a><td> * @param {...(goog.Uri.QueryData|goog.structs.Map|Object)} var_args The object<tr><td><a name="l1491" href="#l1491">1491</a><td> *     from which key value pairs will be copied.<tr><td><a name="l1492" href="#l1492">1492</a><td> */<tr><td><a name="l1493" href="#l1493">1493</a><td>goog.Uri.QueryData.prototype.extend = function(var_args) {<tr><td><a name="l1494" href="#l1494">1494</a><td>  for (var i = 0; i &lt; arguments.length; i++) {<tr><td><a name="l1495" href="#l1495">1495</a><td>    var data = arguments[i];<tr><td><a name="l1496" href="#l1496">1496</a><td>    goog.structs.forEach(data,<tr><td><a name="l1497" href="#l1497">1497</a><td>        /** @this {goog.Uri.QueryData} */<tr><td><a name="l1498" href="#l1498">1498</a><td>        function(value, key) {<tr><td><a name="l1499" href="#l1499">1499</a><td>          this.add(key, value);<tr><td><a name="l1500" href="#l1500">1500</a><td>        }, this);<tr><td><a name="l1501" href="#l1501">1501</a><td>  }<tr><td><a name="l1502" href="#l1502">1502</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>uri.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/uri/uri.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Class for parsing and formatting URIs.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * Use goog.Uri(string) to parse a URI string.  Use goog.Uri.create(...) to<tr><td><a id="l19"></a><a href="#l19">19</a><td> * create a new instance of the goog.Uri object from Uri parts.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * e.g: &lt;code&gt;var myUri = new goog.Uri(window.location);&lt;/code&gt;<tr><td><a id="l22"></a><a href="#l22">22</a><td> *<tr><td><a id="l23"></a><a href="#l23">23</a><td> * Implements RFC 3986 for parsing/formatting URIs.<tr><td><a id="l24"></a><a href="#l24">24</a><td> * http://www.ietf.org/rfc/rfc3986.txt<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * Some changes have been made to the interface (more like .NETs), though the<tr><td><a id="l27"></a><a href="#l27">27</a><td> * internal representation is now of un-encoded parts, this will change the<tr><td><a id="l28"></a><a href="#l28">28</a><td> * behavior slightly.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> */<tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.provide(&#39;goog.Uri&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.provide(&#39;goog.Uri.QueryData&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.structs&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.structs.Map&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.uri.utils&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.uri.utils.ComponentIndex&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.uri.utils.StandardQueryParam&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * This class contains setters and getters for the parts of the URI.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * The &lt;code&gt;getXyz&lt;/code&gt;/&lt;code&gt;setXyz&lt;/code&gt; methods return the decoded part<tr><td><a id="l48"></a><a href="#l48">48</a><td> * -- so&lt;code&gt;goog.Uri.parse(&#39;/foo%20bar&#39;).getPath()&lt;/code&gt; will return the<tr><td><a id="l49"></a><a href="#l49">49</a><td> * decoded path, &lt;code&gt;/foo bar&lt;/code&gt;.<tr><td><a id="l50"></a><a href="#l50">50</a><td> *<tr><td><a id="l51"></a><a href="#l51">51</a><td> * Reserved characters (see RFC 3986 section 2.2) can be present in<tr><td><a id="l52"></a><a href="#l52">52</a><td> * their percent-encoded form in scheme, domain, and path URI components and<tr><td><a id="l53"></a><a href="#l53">53</a><td> * will not be auto-decoded. For example:<tr><td><a id="l54"></a><a href="#l54">54</a><td> * &lt;code&gt;goog.Uri.parse(&#39;rel%61tive/path%2fto/resource&#39;).getPath()&lt;/code&gt; will<tr><td><a id="l55"></a><a href="#l55">55</a><td> * return &lt;code&gt;relative/path%2fto/resource&lt;/code&gt;.<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * The constructor accepts an optional unparsed, raw URI string.  The parser<tr><td><a id="l58"></a><a href="#l58">58</a><td> * is relaxed, so special characters that aren&#39;t escaped but don&#39;t cause<tr><td><a id="l59"></a><a href="#l59">59</a><td> * ambiguities will not cause parse failures.<tr><td><a id="l60"></a><a href="#l60">60</a><td> *<tr><td><a id="l61"></a><a href="#l61">61</a><td> * All setters return &lt;code&gt;this&lt;/code&gt; and so may be chained, a la<tr><td><a id="l62"></a><a href="#l62">62</a><td> * &lt;code&gt;goog.Uri.parse(&#39;/foo&#39;).setFragment(&#39;part&#39;).toString()&lt;/code&gt;.<tr><td><a id="l63"></a><a href="#l63">63</a><td> *<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @param {*=} opt_uri Optional string URI to parse<tr><td><a id="l65"></a><a href="#l65">65</a><td> *        (use goog.Uri.create() to create a URI from parts), or if<tr><td><a id="l66"></a><a href="#l66">66</a><td> *        a goog.Uri is passed, a clone is created.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @param {boolean=} opt_ignoreCase If true, #getParameterValue will ignore<tr><td><a id="l68"></a><a href="#l68">68</a><td> * the case of the parameter name.<tr><td><a id="l69"></a><a href="#l69">69</a><td> *<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @throws URIError If opt_uri is provided and URI is malformed (that is,<tr><td><a id="l71"></a><a href="#l71">71</a><td> *     if decodeURIComponent fails on any of the URI components).<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @constructor<tr><td><a id="l73"></a><a href="#l73">73</a><td> * @struct<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td>goog.Uri = function(opt_uri, opt_ignoreCase) {<tr><td><a id="l76"></a><a href="#l76">76</a><td>  /**<tr><td><a id="l77"></a><a href="#l77">77</a><td>   * Scheme such as &quot;http&quot;.<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * @private {string}<tr><td><a id="l79"></a><a href="#l79">79</a><td>   */<tr><td><a id="l80"></a><a href="#l80">80</a><td>  this.scheme_ = &#39;&#39;;<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>  /**<tr><td><a id="l83"></a><a href="#l83">83</a><td>   * User credentials in the form &quot;username:password&quot;.<tr><td><a id="l84"></a><a href="#l84">84</a><td>   * @private {string}<tr><td><a id="l85"></a><a href="#l85">85</a><td>   */<tr><td><a id="l86"></a><a href="#l86">86</a><td>  this.userInfo_ = &#39;&#39;;<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>   * Domain part, e.g. &quot;www.google.com&quot;.<tr><td><a id="l90"></a><a href="#l90">90</a><td>   * @private {string}<tr><td><a id="l91"></a><a href="#l91">91</a><td>   */<tr><td><a id="l92"></a><a href="#l92">92</a><td>  this.domain_ = &#39;&#39;;<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>   * Port, e.g. 8080.<tr><td><a id="l96"></a><a href="#l96">96</a><td>   * @private {?number}<tr><td><a id="l97"></a><a href="#l97">97</a><td>   */<tr><td><a id="l98"></a><a href="#l98">98</a><td>  this.port_ = null;<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>   * Path, e.g. &quot;/tests/img.png&quot;.<tr><td><a id="l102"></a><a href="#l102">102</a><td>   * @private {string}<tr><td><a id="l103"></a><a href="#l103">103</a><td>   */<tr><td><a id="l104"></a><a href="#l104">104</a><td>  this.path_ = &#39;&#39;;<tr><td><a id="l105"></a><a href="#l105">105</a><td><tr><td><a id="l106"></a><a href="#l106">106</a><td>  /**<tr><td><a id="l107"></a><a href="#l107">107</a><td>   * The fragment without the #.<tr><td><a id="l108"></a><a href="#l108">108</a><td>   * @private {string}<tr><td><a id="l109"></a><a href="#l109">109</a><td>   */<tr><td><a id="l110"></a><a href="#l110">110</a><td>  this.fragment_ = &#39;&#39;;<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>   * Whether or not this Uri should be treated as Read Only.<tr><td><a id="l114"></a><a href="#l114">114</a><td>   * @private {boolean}<tr><td><a id="l115"></a><a href="#l115">115</a><td>   */<tr><td><a id="l116"></a><a href="#l116">116</a><td>  this.isReadOnly_ = false;<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>   * Whether or not to ignore case when comparing query params.<tr><td><a id="l120"></a><a href="#l120">120</a><td>   * @private {boolean}<tr><td><a id="l121"></a><a href="#l121">121</a><td>   */<tr><td><a id="l122"></a><a href="#l122">122</a><td>  this.ignoreCase_ = false;<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>   * Object representing query data.<tr><td><a id="l126"></a><a href="#l126">126</a><td>   * @private {!goog.Uri.QueryData}<tr><td><a id="l127"></a><a href="#l127">127</a><td>   */<tr><td><a id="l128"></a><a href="#l128">128</a><td>  this.queryData_;<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>  // Parse in the uri string<tr><td><a id="l131"></a><a href="#l131">131</a><td>  var m;<tr><td><a id="l132"></a><a href="#l132">132</a><td>  if (opt_uri instanceof goog.Uri) {<tr><td><a id="l133"></a><a href="#l133">133</a><td>    this.ignoreCase_ = goog.isDef(opt_ignoreCase) ?<tr><td><a id="l134"></a><a href="#l134">134</a><td>        opt_ignoreCase : opt_uri.getIgnoreCase();<tr><td><a id="l135"></a><a href="#l135">135</a><td>    this.setScheme(opt_uri.getScheme());<tr><td><a id="l136"></a><a href="#l136">136</a><td>    this.setUserInfo(opt_uri.getUserInfo());<tr><td><a id="l137"></a><a href="#l137">137</a><td>    this.setDomain(opt_uri.getDomain());<tr><td><a id="l138"></a><a href="#l138">138</a><td>    this.setPort(opt_uri.getPort());<tr><td><a id="l139"></a><a href="#l139">139</a><td>    this.setPath(opt_uri.getPath());<tr><td><a id="l140"></a><a href="#l140">140</a><td>    this.setQueryData(opt_uri.getQueryData().clone());<tr><td><a id="l141"></a><a href="#l141">141</a><td>    this.setFragment(opt_uri.getFragment());<tr><td><a id="l142"></a><a href="#l142">142</a><td>  } else if (opt_uri &amp;&amp; (m = goog.uri.utils.split(String(opt_uri)))) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>    this.ignoreCase_ = !!opt_ignoreCase;<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td>    // Set the parts -- decoding as we do so.<tr><td><a id="l146"></a><a href="#l146">146</a><td>    // COMPATABILITY NOTE - In IE, unmatched fields may be empty strings,<tr><td><a id="l147"></a><a href="#l147">147</a><td>    // whereas in other browsers they will be undefined.<tr><td><a id="l148"></a><a href="#l148">148</a><td>    this.setScheme(m[goog.uri.utils.ComponentIndex.SCHEME] || &#39;&#39;, true);<tr><td><a id="l149"></a><a href="#l149">149</a><td>    this.setUserInfo(m[goog.uri.utils.ComponentIndex.USER_INFO] || &#39;&#39;, true);<tr><td><a id="l150"></a><a href="#l150">150</a><td>    this.setDomain(m[goog.uri.utils.ComponentIndex.DOMAIN] || &#39;&#39;, true);<tr><td><a id="l151"></a><a href="#l151">151</a><td>    this.setPort(m[goog.uri.utils.ComponentIndex.PORT]);<tr><td><a id="l152"></a><a href="#l152">152</a><td>    this.setPath(m[goog.uri.utils.ComponentIndex.PATH] || &#39;&#39;, true);<tr><td><a id="l153"></a><a href="#l153">153</a><td>    this.setQueryData(m[goog.uri.utils.ComponentIndex.QUERY_DATA] || &#39;&#39;, true);<tr><td><a id="l154"></a><a href="#l154">154</a><td>    this.setFragment(m[goog.uri.utils.ComponentIndex.FRAGMENT] || &#39;&#39;, true);<tr><td><a id="l155"></a><a href="#l155">155</a><td><tr><td><a id="l156"></a><a href="#l156">156</a><td>  } else {<tr><td><a id="l157"></a><a href="#l157">157</a><td>    this.ignoreCase_ = !!opt_ignoreCase;<tr><td><a id="l158"></a><a href="#l158">158</a><td>    this.queryData_ = new goog.Uri.QueryData(null, null, this.ignoreCase_);<tr><td><a id="l159"></a><a href="#l159">159</a><td>  }<tr><td><a id="l160"></a><a href="#l160">160</a><td>};<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>/**<tr><td><a id="l164"></a><a href="#l164">164</a><td> * If true, we preserve the type of query parameters set programmatically.<tr><td><a id="l165"></a><a href="#l165">165</a><td> *<tr><td><a id="l166"></a><a href="#l166">166</a><td> * This means that if you set a parameter to a boolean, and then call<tr><td><a id="l167"></a><a href="#l167">167</a><td> * getParameterValue, you will get a boolean back.<tr><td><a id="l168"></a><a href="#l168">168</a><td> *<tr><td><a id="l169"></a><a href="#l169">169</a><td> * If false, we will coerce parameters to strings, just as they would<tr><td><a id="l170"></a><a href="#l170">170</a><td> * appear in real URIs.<tr><td><a id="l171"></a><a href="#l171">171</a><td> *<tr><td><a id="l172"></a><a href="#l172">172</a><td> * TODO(nicksantos): Remove this once people have time to fix all tests.<tr><td><a id="l173"></a><a href="#l173">173</a><td> *<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @type {boolean}<tr><td><a id="l175"></a><a href="#l175">175</a><td> */<tr><td><a id="l176"></a><a href="#l176">176</a><td>goog.Uri.preserveParameterTypesCompatibilityFlag = false;<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> * Parameter name added to stop caching.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @type {string}<tr><td><a id="l182"></a><a href="#l182">182</a><td> */<tr><td><a id="l183"></a><a href="#l183">183</a><td>goog.Uri.RANDOM_PARAM = goog.uri.utils.StandardQueryParam.RANDOM;<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> * @return {string} The string form of the url.<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @override<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>goog.Uri.prototype.toString = function() {<tr><td><a id="l191"></a><a href="#l191">191</a><td>  var out = [];<tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td>  var scheme = this.getScheme();<tr><td><a id="l194"></a><a href="#l194">194</a><td>  if (scheme) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>    out.push(goog.Uri.encodeSpecialChars_(<tr><td><a id="l196"></a><a href="#l196">196</a><td>        scheme, goog.Uri.reDisallowedInSchemeOrUserInfo_, true), &#39;:&#39;);<tr><td><a id="l197"></a><a href="#l197">197</a><td>  }<tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>  var domain = this.getDomain();<tr><td><a id="l200"></a><a href="#l200">200</a><td>  if (domain || scheme == &#39;file&#39;) {<tr><td><a id="l201"></a><a href="#l201">201</a><td>    out.push(&#39;//&#39;);<tr><td><a id="l202"></a><a href="#l202">202</a><td><tr><td><a id="l203"></a><a href="#l203">203</a><td>    var userInfo = this.getUserInfo();<tr><td><a id="l204"></a><a href="#l204">204</a><td>    if (userInfo) {<tr><td><a id="l205"></a><a href="#l205">205</a><td>      out.push(goog.Uri.encodeSpecialChars_(<tr><td><a id="l206"></a><a href="#l206">206</a><td>          userInfo, goog.Uri.reDisallowedInSchemeOrUserInfo_, true), &#39;@&#39;);<tr><td><a id="l207"></a><a href="#l207">207</a><td>    }<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td>    out.push(goog.Uri.removeDoubleEncoding_(goog.string.urlEncode(domain)));<tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>    var port = this.getPort();<tr><td><a id="l212"></a><a href="#l212">212</a><td>    if (port != null) {<tr><td><a id="l213"></a><a href="#l213">213</a><td>      out.push(&#39;:&#39;, String(port));<tr><td><a id="l214"></a><a href="#l214">214</a><td>    }<tr><td><a id="l215"></a><a href="#l215">215</a><td>  }<tr><td><a id="l216"></a><a href="#l216">216</a><td><tr><td><a id="l217"></a><a href="#l217">217</a><td>  var path = this.getPath();<tr><td><a id="l218"></a><a href="#l218">218</a><td>  if (path) {<tr><td><a id="l219"></a><a href="#l219">219</a><td>    if (this.hasDomain() &amp;&amp; path.charAt(0) != &#39;/&#39;) {<tr><td><a id="l220"></a><a href="#l220">220</a><td>      out.push(&#39;/&#39;);<tr><td><a id="l221"></a><a href="#l221">221</a><td>    }<tr><td><a id="l222"></a><a href="#l222">222</a><td>    out.push(goog.Uri.encodeSpecialChars_(<tr><td><a id="l223"></a><a href="#l223">223</a><td>        path,<tr><td><a id="l224"></a><a href="#l224">224</a><td>        path.charAt(0) == &#39;/&#39; ?<tr><td><a id="l225"></a><a href="#l225">225</a><td>            goog.Uri.reDisallowedInAbsolutePath_ :<tr><td><a id="l226"></a><a href="#l226">226</a><td>            goog.Uri.reDisallowedInRelativePath_,<tr><td><a id="l227"></a><a href="#l227">227</a><td>        true));<tr><td><a id="l228"></a><a href="#l228">228</a><td>  }<tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>  var query = this.getEncodedQuery();<tr><td><a id="l231"></a><a href="#l231">231</a><td>  if (query) {<tr><td><a id="l232"></a><a href="#l232">232</a><td>    out.push(&#39;?&#39;, query);<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>  var fragment = this.getFragment();<tr><td><a id="l236"></a><a href="#l236">236</a><td>  if (fragment) {<tr><td><a id="l237"></a><a href="#l237">237</a><td>    out.push(&#39;#&#39;, goog.Uri.encodeSpecialChars_(<tr><td><a id="l238"></a><a href="#l238">238</a><td>        fragment, goog.Uri.reDisallowedInFragment_));<tr><td><a id="l239"></a><a href="#l239">239</a><td>  }<tr><td><a id="l240"></a><a href="#l240">240</a><td>  return out.join(&#39;&#39;);<tr><td><a id="l241"></a><a href="#l241">241</a><td>};<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> * Resolves the given relative URI (a goog.Uri object), using the URI<tr><td><a id="l246"></a><a href="#l246">246</a><td> * represented by this instance as the base URI.<tr><td><a id="l247"></a><a href="#l247">247</a><td> *<tr><td><a id="l248"></a><a href="#l248">248</a><td> * There are several kinds of relative URIs:&lt;br&gt;<tr><td><a id="l249"></a><a href="#l249">249</a><td> * 1. foo - replaces the last part of the path, the whole query and fragment&lt;br&gt;<tr><td><a id="l250"></a><a href="#l250">250</a><td> * 2. /foo - replaces the the path, the query and fragment&lt;br&gt;<tr><td><a id="l251"></a><a href="#l251">251</a><td> * 3. //foo - replaces everything from the domain on.  foo is a domain name&lt;br&gt;<tr><td><a id="l252"></a><a href="#l252">252</a><td> * 4. ?foo - replace the query and fragment&lt;br&gt;<tr><td><a id="l253"></a><a href="#l253">253</a><td> * 5. #foo - replace the fragment only<tr><td><a id="l254"></a><a href="#l254">254</a><td> *<tr><td><a id="l255"></a><a href="#l255">255</a><td> * Additionally, if relative URI has a non-empty path, all &quot;..&quot; and &quot;.&quot;<tr><td><a id="l256"></a><a href="#l256">256</a><td> * segments will be resolved, as described in RFC 3986.<tr><td><a id="l257"></a><a href="#l257">257</a><td> *<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @param {!goog.Uri} relativeUri The relative URI to resolve.<tr><td><a id="l259"></a><a href="#l259">259</a><td> * @return {!goog.Uri} The resolved URI.<tr><td><a id="l260"></a><a href="#l260">260</a><td> */<tr><td><a id="l261"></a><a href="#l261">261</a><td>goog.Uri.prototype.resolve = function(relativeUri) {<tr><td><a id="l262"></a><a href="#l262">262</a><td><tr><td><a id="l263"></a><a href="#l263">263</a><td>  var absoluteUri = this.clone();<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td>  // we satisfy these conditions by looking for the first part of relativeUri<tr><td><a id="l266"></a><a href="#l266">266</a><td>  // that is not blank and applying defaults to the rest<tr><td><a id="l267"></a><a href="#l267">267</a><td><tr><td><a id="l268"></a><a href="#l268">268</a><td>  var overridden = relativeUri.hasScheme();<tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td>  if (overridden) {<tr><td><a id="l271"></a><a href="#l271">271</a><td>    absoluteUri.setScheme(relativeUri.getScheme());<tr><td><a id="l272"></a><a href="#l272">272</a><td>  } else {<tr><td><a id="l273"></a><a href="#l273">273</a><td>    overridden = relativeUri.hasUserInfo();<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>  if (overridden) {<tr><td><a id="l277"></a><a href="#l277">277</a><td>    absoluteUri.setUserInfo(relativeUri.getUserInfo());<tr><td><a id="l278"></a><a href="#l278">278</a><td>  } else {<tr><td><a id="l279"></a><a href="#l279">279</a><td>    overridden = relativeUri.hasDomain();<tr><td><a id="l280"></a><a href="#l280">280</a><td>  }<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td>  if (overridden) {<tr><td><a id="l283"></a><a href="#l283">283</a><td>    absoluteUri.setDomain(relativeUri.getDomain());<tr><td><a id="l284"></a><a href="#l284">284</a><td>  } else {<tr><td><a id="l285"></a><a href="#l285">285</a><td>    overridden = relativeUri.hasPort();<tr><td><a id="l286"></a><a href="#l286">286</a><td>  }<tr><td><a id="l287"></a><a href="#l287">287</a><td><tr><td><a id="l288"></a><a href="#l288">288</a><td>  var path = relativeUri.getPath();<tr><td><a id="l289"></a><a href="#l289">289</a><td>  if (overridden) {<tr><td><a id="l290"></a><a href="#l290">290</a><td>    absoluteUri.setPort(relativeUri.getPort());<tr><td><a id="l291"></a><a href="#l291">291</a><td>  } else {<tr><td><a id="l292"></a><a href="#l292">292</a><td>    overridden = relativeUri.hasPath();<tr><td><a id="l293"></a><a href="#l293">293</a><td>    if (overridden) {<tr><td><a id="l294"></a><a href="#l294">294</a><td>      // resolve path properly<tr><td><a id="l295"></a><a href="#l295">295</a><td>      if (path.charAt(0) != &#39;/&#39;) {<tr><td><a id="l296"></a><a href="#l296">296</a><td>        // path is relative<tr><td><a id="l297"></a><a href="#l297">297</a><td>        if (this.hasDomain() &amp;&amp; !this.hasPath()) {<tr><td><a id="l298"></a><a href="#l298">298</a><td>          // RFC 3986, section 5.2.3, case 1<tr><td><a id="l299"></a><a href="#l299">299</a><td>          path = &#39;/&#39; + path;<tr><td><a id="l300"></a><a href="#l300">300</a><td>        } else {<tr><td><a id="l301"></a><a href="#l301">301</a><td>          // RFC 3986, section 5.2.3, case 2<tr><td><a id="l302"></a><a href="#l302">302</a><td>          var lastSlashIndex = absoluteUri.getPath().lastIndexOf(&#39;/&#39;);<tr><td><a id="l303"></a><a href="#l303">303</a><td>          if (lastSlashIndex != -1) {<tr><td><a id="l304"></a><a href="#l304">304</a><td>            path = absoluteUri.getPath().substr(0, lastSlashIndex + 1) + path;<tr><td><a id="l305"></a><a href="#l305">305</a><td>          }<tr><td><a id="l306"></a><a href="#l306">306</a><td>        }<tr><td><a id="l307"></a><a href="#l307">307</a><td>      }<tr><td><a id="l308"></a><a href="#l308">308</a><td>      path = goog.Uri.removeDotSegments(path);<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><tr><td><a id="l312"></a><a href="#l312">312</a><td>  if (overridden) {<tr><td><a id="l313"></a><a href="#l313">313</a><td>    absoluteUri.setPath(path);<tr><td><a id="l314"></a><a href="#l314">314</a><td>  } else {<tr><td><a id="l315"></a><a href="#l315">315</a><td>    overridden = relativeUri.hasQuery();<tr><td><a id="l316"></a><a href="#l316">316</a><td>  }<tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td>  if (overridden) {<tr><td><a id="l319"></a><a href="#l319">319</a><td>    absoluteUri.setQueryData(relativeUri.getDecodedQuery());<tr><td><a id="l320"></a><a href="#l320">320</a><td>  } else {<tr><td><a id="l321"></a><a href="#l321">321</a><td>    overridden = relativeUri.hasFragment();<tr><td><a id="l322"></a><a href="#l322">322</a><td>  }<tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td>  if (overridden) {<tr><td><a id="l325"></a><a href="#l325">325</a><td>    absoluteUri.setFragment(relativeUri.getFragment());<tr><td><a id="l326"></a><a href="#l326">326</a><td>  }<tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>  return absoluteUri;<tr><td><a id="l329"></a><a href="#l329">329</a><td>};<tr><td><a id="l330"></a><a href="#l330">330</a><td><tr><td><a id="l331"></a><a href="#l331">331</a><td><tr><td><a id="l332"></a><a href="#l332">332</a><td>/**<tr><td><a id="l333"></a><a href="#l333">333</a><td> * Clones the URI instance.<tr><td><a id="l334"></a><a href="#l334">334</a><td> * @return {!goog.Uri} New instance of the URI object.<tr><td><a id="l335"></a><a href="#l335">335</a><td> */<tr><td><a id="l336"></a><a href="#l336">336</a><td>goog.Uri.prototype.clone = function() {<tr><td><a id="l337"></a><a href="#l337">337</a><td>  return new goog.Uri(this);<tr><td><a id="l338"></a><a href="#l338">338</a><td>};<tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td>/**<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @return {string} The encoded scheme/protocol for the URI.<tr><td><a id="l343"></a><a href="#l343">343</a><td> */<tr><td><a id="l344"></a><a href="#l344">344</a><td>goog.Uri.prototype.getScheme = function() {<tr><td><a id="l345"></a><a href="#l345">345</a><td>  return this.scheme_;<tr><td><a id="l346"></a><a href="#l346">346</a><td>};<tr><td><a id="l347"></a><a href="#l347">347</a><td><tr><td><a id="l348"></a><a href="#l348">348</a><td><tr><td><a id="l349"></a><a href="#l349">349</a><td>/**<tr><td><a id="l350"></a><a href="#l350">350</a><td> * Sets the scheme/protocol.<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @throws URIError If opt_decode is true and newScheme is malformed (that is,<tr><td><a id="l352"></a><a href="#l352">352</a><td> *     if decodeURIComponent fails).<tr><td><a id="l353"></a><a href="#l353">353</a><td> * @param {string} newScheme New scheme value.<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a id="l355"></a><a href="#l355">355</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l356"></a><a href="#l356">356</a><td> */<tr><td><a id="l357"></a><a href="#l357">357</a><td>goog.Uri.prototype.setScheme = function(newScheme, opt_decode) {<tr><td><a id="l358"></a><a href="#l358">358</a><td>  this.enforceReadOnly();<tr><td><a id="l359"></a><a href="#l359">359</a><td>  this.scheme_ = opt_decode ? goog.Uri.decodeOrEmpty_(newScheme, true) :<tr><td><a id="l360"></a><a href="#l360">360</a><td>      newScheme;<tr><td><a id="l361"></a><a href="#l361">361</a><td><tr><td><a id="l362"></a><a href="#l362">362</a><td>  // remove an : at the end of the scheme so somebody can pass in<tr><td><a id="l363"></a><a href="#l363">363</a><td>  // window.location.protocol<tr><td><a id="l364"></a><a href="#l364">364</a><td>  if (this.scheme_) {<tr><td><a id="l365"></a><a href="#l365">365</a><td>    this.scheme_ = this.scheme_.replace(/:$/, &#39;&#39;);<tr><td><a id="l366"></a><a href="#l366">366</a><td>  }<tr><td><a id="l367"></a><a href="#l367">367</a><td>  return this;<tr><td><a id="l368"></a><a href="#l368">368</a><td>};<tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td>/**<tr><td><a id="l372"></a><a href="#l372">372</a><td> * @return {boolean} Whether the scheme has been set.<tr><td><a id="l373"></a><a href="#l373">373</a><td> */<tr><td><a id="l374"></a><a href="#l374">374</a><td>goog.Uri.prototype.hasScheme = function() {<tr><td><a id="l375"></a><a href="#l375">375</a><td>  return !!this.scheme_;<tr><td><a id="l376"></a><a href="#l376">376</a><td>};<tr><td><a id="l377"></a><a href="#l377">377</a><td><tr><td><a id="l378"></a><a href="#l378">378</a><td><tr><td><a id="l379"></a><a href="#l379">379</a><td>/**<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @return {string} The decoded user info.<tr><td><a id="l381"></a><a href="#l381">381</a><td> */<tr><td><a id="l382"></a><a href="#l382">382</a><td>goog.Uri.prototype.getUserInfo = function() {<tr><td><a id="l383"></a><a href="#l383">383</a><td>  return this.userInfo_;<tr><td><a id="l384"></a><a href="#l384">384</a><td>};<tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td><tr><td><a id="l387"></a><a href="#l387">387</a><td>/**<tr><td><a id="l388"></a><a href="#l388">388</a><td> * Sets the userInfo.<tr><td><a id="l389"></a><a href="#l389">389</a><td> * @throws URIError If opt_decode is true and newUserInfo is malformed (that is,<tr><td><a id="l390"></a><a href="#l390">390</a><td> *     if decodeURIComponent fails).<tr><td><a id="l391"></a><a href="#l391">391</a><td> * @param {string} newUserInfo New userInfo value.<tr><td><a id="l392"></a><a href="#l392">392</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a id="l393"></a><a href="#l393">393</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l394"></a><a href="#l394">394</a><td> */<tr><td><a id="l395"></a><a href="#l395">395</a><td>goog.Uri.prototype.setUserInfo = function(newUserInfo, opt_decode) {<tr><td><a id="l396"></a><a href="#l396">396</a><td>  this.enforceReadOnly();<tr><td><a id="l397"></a><a href="#l397">397</a><td>  this.userInfo_ = opt_decode ? goog.Uri.decodeOrEmpty_(newUserInfo) :<tr><td><a id="l398"></a><a href="#l398">398</a><td>                   newUserInfo;<tr><td><a id="l399"></a><a href="#l399">399</a><td>  return this;<tr><td><a id="l400"></a><a href="#l400">400</a><td>};<tr><td><a id="l401"></a><a href="#l401">401</a><td><tr><td><a id="l402"></a><a href="#l402">402</a><td><tr><td><a id="l403"></a><a href="#l403">403</a><td>/**<tr><td><a id="l404"></a><a href="#l404">404</a><td> * @return {boolean} Whether the user info has been set.<tr><td><a id="l405"></a><a href="#l405">405</a><td> */<tr><td><a id="l406"></a><a href="#l406">406</a><td>goog.Uri.prototype.hasUserInfo = function() {<tr><td><a id="l407"></a><a href="#l407">407</a><td>  return !!this.userInfo_;<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>/**<tr><td><a id="l412"></a><a href="#l412">412</a><td> * @return {string} The decoded domain.<tr><td><a id="l413"></a><a href="#l413">413</a><td> */<tr><td><a id="l414"></a><a href="#l414">414</a><td>goog.Uri.prototype.getDomain = function() {<tr><td><a id="l415"></a><a href="#l415">415</a><td>  return this.domain_;<tr><td><a id="l416"></a><a href="#l416">416</a><td>};<tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td><tr><td><a id="l419"></a><a href="#l419">419</a><td>/**<tr><td><a id="l420"></a><a href="#l420">420</a><td> * Sets the domain.<tr><td><a id="l421"></a><a href="#l421">421</a><td> * @throws URIError If opt_decode is true and newDomain is malformed (that is,<tr><td><a id="l422"></a><a href="#l422">422</a><td> *     if decodeURIComponent fails).<tr><td><a id="l423"></a><a href="#l423">423</a><td> * @param {string} newDomain New domain value.<tr><td><a id="l424"></a><a href="#l424">424</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a id="l425"></a><a href="#l425">425</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l426"></a><a href="#l426">426</a><td> */<tr><td><a id="l427"></a><a href="#l427">427</a><td>goog.Uri.prototype.setDomain = function(newDomain, opt_decode) {<tr><td><a id="l428"></a><a href="#l428">428</a><td>  this.enforceReadOnly();<tr><td><a id="l429"></a><a href="#l429">429</a><td>  this.domain_ = opt_decode ? goog.Uri.decodeOrEmpty_(newDomain, true) :<tr><td><a id="l430"></a><a href="#l430">430</a><td>      newDomain;<tr><td><a id="l431"></a><a href="#l431">431</a><td>  return this;<tr><td><a id="l432"></a><a href="#l432">432</a><td>};<tr><td><a id="l433"></a><a href="#l433">433</a><td><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> * @return {boolean} Whether the domain has been set.<tr><td><a id="l437"></a><a href="#l437">437</a><td> */<tr><td><a id="l438"></a><a href="#l438">438</a><td>goog.Uri.prototype.hasDomain = function() {<tr><td><a id="l439"></a><a href="#l439">439</a><td>  return !!this.domain_;<tr><td><a id="l440"></a><a href="#l440">440</a><td>};<tr><td><a id="l441"></a><a href="#l441">441</a><td><tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td>/**<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @return {?number} The port number.<tr><td><a id="l445"></a><a href="#l445">445</a><td> */<tr><td><a id="l446"></a><a href="#l446">446</a><td>goog.Uri.prototype.getPort = function() {<tr><td><a id="l447"></a><a href="#l447">447</a><td>  return this.port_;<tr><td><a id="l448"></a><a href="#l448">448</a><td>};<tr><td><a id="l449"></a><a href="#l449">449</a><td><tr><td><a id="l450"></a><a href="#l450">450</a><td><tr><td><a id="l451"></a><a href="#l451">451</a><td>/**<tr><td><a id="l452"></a><a href="#l452">452</a><td> * Sets the port number.<tr><td><a id="l453"></a><a href="#l453">453</a><td> * @param {*} newPort Port number. Will be explicitly casted to a number.<tr><td><a id="l454"></a><a href="#l454">454</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l455"></a><a href="#l455">455</a><td> */<tr><td><a id="l456"></a><a href="#l456">456</a><td>goog.Uri.prototype.setPort = function(newPort) {<tr><td><a id="l457"></a><a href="#l457">457</a><td>  this.enforceReadOnly();<tr><td><a id="l458"></a><a href="#l458">458</a><td><tr><td><a id="l459"></a><a href="#l459">459</a><td>  if (newPort) {<tr><td><a id="l460"></a><a href="#l460">460</a><td>    newPort = Number(newPort);<tr><td><a id="l461"></a><a href="#l461">461</a><td>    if (isNaN(newPort) || newPort &lt; 0) {<tr><td><a id="l462"></a><a href="#l462">462</a><td>      throw Error(&#39;Bad port number &#39; + newPort);<tr><td><a id="l463"></a><a href="#l463">463</a><td>    }<tr><td><a id="l464"></a><a href="#l464">464</a><td>    this.port_ = newPort;<tr><td><a id="l465"></a><a href="#l465">465</a><td>  } else {<tr><td><a id="l466"></a><a href="#l466">466</a><td>    this.port_ = null;<tr><td><a id="l467"></a><a href="#l467">467</a><td>  }<tr><td><a id="l468"></a><a href="#l468">468</a><td><tr><td><a id="l469"></a><a href="#l469">469</a><td>  return this;<tr><td><a id="l470"></a><a href="#l470">470</a><td>};<tr><td><a id="l471"></a><a href="#l471">471</a><td><tr><td><a id="l472"></a><a href="#l472">472</a><td><tr><td><a id="l473"></a><a href="#l473">473</a><td>/**<tr><td><a id="l474"></a><a href="#l474">474</a><td> * @return {boolean} Whether the port has been set.<tr><td><a id="l475"></a><a href="#l475">475</a><td> */<tr><td><a id="l476"></a><a href="#l476">476</a><td>goog.Uri.prototype.hasPort = function() {<tr><td><a id="l477"></a><a href="#l477">477</a><td>  return this.port_ != null;<tr><td><a id="l478"></a><a href="#l478">478</a><td>};<tr><td><a id="l479"></a><a href="#l479">479</a><td><tr><td><a id="l480"></a><a href="#l480">480</a><td><tr><td><a id="l481"></a><a href="#l481">481</a><td>/**<tr><td><a id="l482"></a><a href="#l482">482</a><td>  * @return {string} The decoded path.<tr><td><a id="l483"></a><a href="#l483">483</a><td> */<tr><td><a id="l484"></a><a href="#l484">484</a><td>goog.Uri.prototype.getPath = function() {<tr><td><a id="l485"></a><a href="#l485">485</a><td>  return this.path_;<tr><td><a id="l486"></a><a href="#l486">486</a><td>};<tr><td><a id="l487"></a><a href="#l487">487</a><td><tr><td><a id="l488"></a><a href="#l488">488</a><td><tr><td><a id="l489"></a><a href="#l489">489</a><td>/**<tr><td><a id="l490"></a><a href="#l490">490</a><td> * Sets the path.<tr><td><a id="l491"></a><a href="#l491">491</a><td> * @throws URIError If opt_decode is true and newPath is malformed (that is,<tr><td><a id="l492"></a><a href="#l492">492</a><td> *     if decodeURIComponent fails).<tr><td><a id="l493"></a><a href="#l493">493</a><td> * @param {string} newPath New path value.<tr><td><a id="l494"></a><a href="#l494">494</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a id="l495"></a><a href="#l495">495</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l496"></a><a href="#l496">496</a><td> */<tr><td><a id="l497"></a><a href="#l497">497</a><td>goog.Uri.prototype.setPath = function(newPath, opt_decode) {<tr><td><a id="l498"></a><a href="#l498">498</a><td>  this.enforceReadOnly();<tr><td><a id="l499"></a><a href="#l499">499</a><td>  this.path_ = opt_decode ? goog.Uri.decodeOrEmpty_(newPath, true) : newPath;<tr><td><a id="l500"></a><a href="#l500">500</a><td>  return this;<tr><td><a id="l501"></a><a href="#l501">501</a><td>};<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> * @return {boolean} Whether the path has been set.<tr><td><a id="l506"></a><a href="#l506">506</a><td> */<tr><td><a id="l507"></a><a href="#l507">507</a><td>goog.Uri.prototype.hasPath = function() {<tr><td><a id="l508"></a><a href="#l508">508</a><td>  return !!this.path_;<tr><td><a id="l509"></a><a href="#l509">509</a><td>};<tr><td><a id="l510"></a><a href="#l510">510</a><td><tr><td><a id="l511"></a><a href="#l511">511</a><td><tr><td><a id="l512"></a><a href="#l512">512</a><td>/**<tr><td><a id="l513"></a><a href="#l513">513</a><td> * @return {boolean} Whether the query string has been set.<tr><td><a id="l514"></a><a href="#l514">514</a><td> */<tr><td><a id="l515"></a><a href="#l515">515</a><td>goog.Uri.prototype.hasQuery = function() {<tr><td><a id="l516"></a><a href="#l516">516</a><td>  return this.queryData_.toString() !== &#39;&#39;;<tr><td><a id="l517"></a><a href="#l517">517</a><td>};<tr><td><a id="l518"></a><a href="#l518">518</a><td><tr><td><a id="l519"></a><a href="#l519">519</a><td><tr><td><a id="l520"></a><a href="#l520">520</a><td>/**<tr><td><a id="l521"></a><a href="#l521">521</a><td> * Sets the query data.<tr><td><a id="l522"></a><a href="#l522">522</a><td> * @param {goog.Uri.QueryData|string|undefined} queryData QueryData object.<tr><td><a id="l523"></a><a href="#l523">523</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a id="l524"></a><a href="#l524">524</a><td> *     Applies only if queryData is a string.<tr><td><a id="l525"></a><a href="#l525">525</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l526"></a><a href="#l526">526</a><td> */<tr><td><a id="l527"></a><a href="#l527">527</a><td>goog.Uri.prototype.setQueryData = function(queryData, opt_decode) {<tr><td><a id="l528"></a><a href="#l528">528</a><td>  this.enforceReadOnly();<tr><td><a id="l529"></a><a href="#l529">529</a><td><tr><td><a id="l530"></a><a href="#l530">530</a><td>  if (queryData instanceof goog.Uri.QueryData) {<tr><td><a id="l531"></a><a href="#l531">531</a><td>    this.queryData_ = queryData;<tr><td><a id="l532"></a><a href="#l532">532</a><td>    this.queryData_.setIgnoreCase(this.ignoreCase_);<tr><td><a id="l533"></a><a href="#l533">533</a><td>  } else {<tr><td><a id="l534"></a><a href="#l534">534</a><td>    if (!opt_decode) {<tr><td><a id="l535"></a><a href="#l535">535</a><td>      // QueryData accepts encoded query string, so encode it if<tr><td><a id="l536"></a><a href="#l536">536</a><td>      // opt_decode flag is not true.<tr><td><a id="l537"></a><a href="#l537">537</a><td>      queryData = goog.Uri.encodeSpecialChars_(queryData,<tr><td><a id="l538"></a><a href="#l538">538</a><td>                                               goog.Uri.reDisallowedInQuery_);<tr><td><a id="l539"></a><a href="#l539">539</a><td>    }<tr><td><a id="l540"></a><a href="#l540">540</a><td>    this.queryData_ = new goog.Uri.QueryData(queryData, null, this.ignoreCase_);<tr><td><a id="l541"></a><a href="#l541">541</a><td>  }<tr><td><a id="l542"></a><a href="#l542">542</a><td><tr><td><a id="l543"></a><a href="#l543">543</a><td>  return this;<tr><td><a id="l544"></a><a href="#l544">544</a><td>};<tr><td><a id="l545"></a><a href="#l545">545</a><td><tr><td><a id="l546"></a><a href="#l546">546</a><td><tr><td><a id="l547"></a><a href="#l547">547</a><td>/**<tr><td><a id="l548"></a><a href="#l548">548</a><td> * Sets the URI query.<tr><td><a id="l549"></a><a href="#l549">549</a><td> * @param {string} newQuery New query value.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a id="l551"></a><a href="#l551">551</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l552"></a><a href="#l552">552</a><td> */<tr><td><a id="l553"></a><a href="#l553">553</a><td>goog.Uri.prototype.setQuery = function(newQuery, opt_decode) {<tr><td><a id="l554"></a><a href="#l554">554</a><td>  return this.setQueryData(newQuery, opt_decode);<tr><td><a id="l555"></a><a href="#l555">555</a><td>};<tr><td><a id="l556"></a><a href="#l556">556</a><td><tr><td><a id="l557"></a><a href="#l557">557</a><td><tr><td><a id="l558"></a><a href="#l558">558</a><td>/**<tr><td><a id="l559"></a><a href="#l559">559</a><td> * @return {string} The encoded URI query, not including the ?.<tr><td><a id="l560"></a><a href="#l560">560</a><td> */<tr><td><a id="l561"></a><a href="#l561">561</a><td>goog.Uri.prototype.getEncodedQuery = function() {<tr><td><a id="l562"></a><a href="#l562">562</a><td>  return this.queryData_.toString();<tr><td><a id="l563"></a><a href="#l563">563</a><td>};<tr><td><a id="l564"></a><a href="#l564">564</a><td><tr><td><a id="l565"></a><a href="#l565">565</a><td><tr><td><a id="l566"></a><a href="#l566">566</a><td>/**<tr><td><a id="l567"></a><a href="#l567">567</a><td> * @return {string} The decoded URI query, not including the ?.<tr><td><a id="l568"></a><a href="#l568">568</a><td> */<tr><td><a id="l569"></a><a href="#l569">569</a><td>goog.Uri.prototype.getDecodedQuery = function() {<tr><td><a id="l570"></a><a href="#l570">570</a><td>  return this.queryData_.toDecodedString();<tr><td><a id="l571"></a><a href="#l571">571</a><td>};<tr><td><a id="l572"></a><a href="#l572">572</a><td><tr><td><a id="l573"></a><a href="#l573">573</a><td><tr><td><a id="l574"></a><a href="#l574">574</a><td>/**<tr><td><a id="l575"></a><a href="#l575">575</a><td> * Returns the query data.<tr><td><a id="l576"></a><a href="#l576">576</a><td> * @return {!goog.Uri.QueryData} QueryData object.<tr><td><a id="l577"></a><a href="#l577">577</a><td> */<tr><td><a id="l578"></a><a href="#l578">578</a><td>goog.Uri.prototype.getQueryData = function() {<tr><td><a id="l579"></a><a href="#l579">579</a><td>  return this.queryData_;<tr><td><a id="l580"></a><a href="#l580">580</a><td>};<tr><td><a id="l581"></a><a href="#l581">581</a><td><tr><td><a id="l582"></a><a href="#l582">582</a><td><tr><td><a id="l583"></a><a href="#l583">583</a><td>/**<tr><td><a id="l584"></a><a href="#l584">584</a><td> * @return {string} The encoded URI query, not including the ?.<tr><td><a id="l585"></a><a href="#l585">585</a><td> *<tr><td><a id="l586"></a><a href="#l586">586</a><td> * Warning: This method, unlike other getter methods, returns encoded<tr><td><a id="l587"></a><a href="#l587">587</a><td> * value, instead of decoded one.<tr><td><a id="l588"></a><a href="#l588">588</a><td> */<tr><td><a id="l589"></a><a href="#l589">589</a><td>goog.Uri.prototype.getQuery = function() {<tr><td><a id="l590"></a><a href="#l590">590</a><td>  return this.getEncodedQuery();<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><tr><td><a id="l594"></a><a href="#l594">594</a><td>/**<tr><td><a id="l595"></a><a href="#l595">595</a><td> * Sets the value of the named query parameters, clearing previous values for<tr><td><a id="l596"></a><a href="#l596">596</a><td> * that key.<tr><td><a id="l597"></a><a href="#l597">597</a><td> *<tr><td><a id="l598"></a><a href="#l598">598</a><td> * @param {string} key The parameter to set.<tr><td><a id="l599"></a><a href="#l599">599</a><td> * @param {*} value The new value.<tr><td><a id="l600"></a><a href="#l600">600</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l601"></a><a href="#l601">601</a><td> */<tr><td><a id="l602"></a><a href="#l602">602</a><td>goog.Uri.prototype.setParameterValue = function(key, value) {<tr><td><a id="l603"></a><a href="#l603">603</a><td>  this.enforceReadOnly();<tr><td><a id="l604"></a><a href="#l604">604</a><td>  this.queryData_.set(key, value);<tr><td><a id="l605"></a><a href="#l605">605</a><td>  return this;<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> * Sets the values of the named query parameters, clearing previous values for<tr><td><a id="l611"></a><a href="#l611">611</a><td> * that key.  Not new values will currently be moved to the end of the query<tr><td><a id="l612"></a><a href="#l612">612</a><td> * string.<tr><td><a id="l613"></a><a href="#l613">613</a><td> *<tr><td><a id="l614"></a><a href="#l614">614</a><td> * So, &lt;code&gt;goog.Uri.parse(&#39;foo?a=b&amp;c=d&amp;e=f&#39;).setParameterValues(&#39;c&#39;, [&#39;new&#39;])<tr><td><a id="l615"></a><a href="#l615">615</a><td> * &lt;/code&gt; yields &lt;tt&gt;foo?a=b&amp;e=f&amp;c=new&lt;/tt&gt;.&lt;/p&gt;<tr><td><a id="l616"></a><a href="#l616">616</a><td> *<tr><td><a id="l617"></a><a href="#l617">617</a><td> * @param {string} key The parameter to set.<tr><td><a id="l618"></a><a href="#l618">618</a><td> * @param {*} values The new values. If values is a single<tr><td><a id="l619"></a><a href="#l619">619</a><td> *     string then it will be treated as the sole value.<tr><td><a id="l620"></a><a href="#l620">620</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l621"></a><a href="#l621">621</a><td> */<tr><td><a id="l622"></a><a href="#l622">622</a><td>goog.Uri.prototype.setParameterValues = function(key, values) {<tr><td><a id="l623"></a><a href="#l623">623</a><td>  this.enforceReadOnly();<tr><td><a id="l624"></a><a href="#l624">624</a><td><tr><td><a id="l625"></a><a href="#l625">625</a><td>  if (!goog.isArray(values)) {<tr><td><a id="l626"></a><a href="#l626">626</a><td>    values = [String(values)];<tr><td><a id="l627"></a><a href="#l627">627</a><td>  }<tr><td><a id="l628"></a><a href="#l628">628</a><td><tr><td><a id="l629"></a><a href="#l629">629</a><td>  this.queryData_.setValues(key, values);<tr><td><a id="l630"></a><a href="#l630">630</a><td><tr><td><a id="l631"></a><a href="#l631">631</a><td>  return this;<tr><td><a id="l632"></a><a href="#l632">632</a><td>};<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> * Returns the value&lt;b&gt;s&lt;/b&gt; for a given cgi parameter as a list of decoded<tr><td><a id="l637"></a><a href="#l637">637</a><td> * query parameter values.<tr><td><a id="l638"></a><a href="#l638">638</a><td> * @param {string} name The parameter to get values for.<tr><td><a id="l639"></a><a href="#l639">639</a><td> * @return {!Array&lt;?&gt;} The values for a given cgi parameter as a list of<tr><td><a id="l640"></a><a href="#l640">640</a><td> *     decoded query parameter values.<tr><td><a id="l641"></a><a href="#l641">641</a><td> */<tr><td><a id="l642"></a><a href="#l642">642</a><td>goog.Uri.prototype.getParameterValues = function(name) {<tr><td><a id="l643"></a><a href="#l643">643</a><td>  return this.queryData_.getValues(name);<tr><td><a id="l644"></a><a href="#l644">644</a><td>};<tr><td><a id="l645"></a><a href="#l645">645</a><td><tr><td><a id="l646"></a><a href="#l646">646</a><td><tr><td><a id="l647"></a><a href="#l647">647</a><td>/**<tr><td><a id="l648"></a><a href="#l648">648</a><td> * Returns the first value for a given cgi parameter or undefined if the given<tr><td><a id="l649"></a><a href="#l649">649</a><td> * parameter name does not appear in the query string.<tr><td><a id="l650"></a><a href="#l650">650</a><td> * @param {string} paramName Unescaped parameter name.<tr><td><a id="l651"></a><a href="#l651">651</a><td> * @return {string|undefined} The first value for a given cgi parameter or<tr><td><a id="l652"></a><a href="#l652">652</a><td> *     undefined if the given parameter name does not appear in the query<tr><td><a id="l653"></a><a href="#l653">653</a><td> *     string.<tr><td><a id="l654"></a><a href="#l654">654</a><td> */<tr><td><a id="l655"></a><a href="#l655">655</a><td>goog.Uri.prototype.getParameterValue = function(paramName) {<tr><td><a id="l656"></a><a href="#l656">656</a><td>  // NOTE(nicksantos): This type-cast is a lie when<tr><td><a id="l657"></a><a href="#l657">657</a><td>  // preserveParameterTypesCompatibilityFlag is set to true.<tr><td><a id="l658"></a><a href="#l658">658</a><td>  // But this should only be set to true in tests.<tr><td><a id="l659"></a><a href="#l659">659</a><td>  return /** @type {string|undefined} */ (this.queryData_.get(paramName));<tr><td><a id="l660"></a><a href="#l660">660</a><td>};<tr><td><a id="l661"></a><a href="#l661">661</a><td><tr><td><a id="l662"></a><a href="#l662">662</a><td><tr><td><a id="l663"></a><a href="#l663">663</a><td>/**<tr><td><a id="l664"></a><a href="#l664">664</a><td> * @return {string} The URI fragment, not including the #.<tr><td><a id="l665"></a><a href="#l665">665</a><td> */<tr><td><a id="l666"></a><a href="#l666">666</a><td>goog.Uri.prototype.getFragment = function() {<tr><td><a id="l667"></a><a href="#l667">667</a><td>  return this.fragment_;<tr><td><a id="l668"></a><a href="#l668">668</a><td>};<tr><td><a id="l669"></a><a href="#l669">669</a><td><tr><td><a id="l670"></a><a href="#l670">670</a><td><tr><td><a id="l671"></a><a href="#l671">671</a><td>/**<tr><td><a id="l672"></a><a href="#l672">672</a><td> * Sets the URI fragment.<tr><td><a id="l673"></a><a href="#l673">673</a><td> * @throws URIError If opt_decode is true and newFragment is malformed (that is,<tr><td><a id="l674"></a><a href="#l674">674</a><td> *     if decodeURIComponent fails).<tr><td><a id="l675"></a><a href="#l675">675</a><td> * @param {string} newFragment New fragment value.<tr><td><a id="l676"></a><a href="#l676">676</a><td> * @param {boolean=} opt_decode Optional param for whether to decode new value.<tr><td><a id="l677"></a><a href="#l677">677</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l678"></a><a href="#l678">678</a><td> */<tr><td><a id="l679"></a><a href="#l679">679</a><td>goog.Uri.prototype.setFragment = function(newFragment, opt_decode) {<tr><td><a id="l680"></a><a href="#l680">680</a><td>  this.enforceReadOnly();<tr><td><a id="l681"></a><a href="#l681">681</a><td>  this.fragment_ = opt_decode ? goog.Uri.decodeOrEmpty_(newFragment) :<tr><td><a id="l682"></a><a href="#l682">682</a><td>                   newFragment;<tr><td><a id="l683"></a><a href="#l683">683</a><td>  return this;<tr><td><a id="l684"></a><a href="#l684">684</a><td>};<tr><td><a id="l685"></a><a href="#l685">685</a><td><tr><td><a id="l686"></a><a href="#l686">686</a><td><tr><td><a id="l687"></a><a href="#l687">687</a><td>/**<tr><td><a id="l688"></a><a href="#l688">688</a><td> * @return {boolean} Whether the URI has a fragment set.<tr><td><a id="l689"></a><a href="#l689">689</a><td> */<tr><td><a id="l690"></a><a href="#l690">690</a><td>goog.Uri.prototype.hasFragment = function() {<tr><td><a id="l691"></a><a href="#l691">691</a><td>  return !!this.fragment_;<tr><td><a id="l692"></a><a href="#l692">692</a><td>};<tr><td><a id="l693"></a><a href="#l693">693</a><td><tr><td><a id="l694"></a><a href="#l694">694</a><td><tr><td><a id="l695"></a><a href="#l695">695</a><td>/**<tr><td><a id="l696"></a><a href="#l696">696</a><td> * Returns true if this has the same domain as that of uri2.<tr><td><a id="l697"></a><a href="#l697">697</a><td> * @param {!goog.Uri} uri2 The URI object to compare to.<tr><td><a id="l698"></a><a href="#l698">698</a><td> * @return {boolean} true if same domain; false otherwise.<tr><td><a id="l699"></a><a href="#l699">699</a><td> */<tr><td><a id="l700"></a><a href="#l700">700</a><td>goog.Uri.prototype.hasSameDomainAs = function(uri2) {<tr><td><a id="l701"></a><a href="#l701">701</a><td>  return ((!this.hasDomain() &amp;&amp; !uri2.hasDomain()) ||<tr><td><a id="l702"></a><a href="#l702">702</a><td>          this.getDomain() == uri2.getDomain()) &amp;&amp;<tr><td><a id="l703"></a><a href="#l703">703</a><td>      ((!this.hasPort() &amp;&amp; !uri2.hasPort()) ||<tr><td><a id="l704"></a><a href="#l704">704</a><td>          this.getPort() == uri2.getPort());<tr><td><a id="l705"></a><a href="#l705">705</a><td>};<tr><td><a id="l706"></a><a href="#l706">706</a><td><tr><td><a id="l707"></a><a href="#l707">707</a><td><tr><td><a id="l708"></a><a href="#l708">708</a><td>/**<tr><td><a id="l709"></a><a href="#l709">709</a><td> * Adds a random parameter to the Uri.<tr><td><a id="l710"></a><a href="#l710">710</a><td> * @return {!goog.Uri} Reference to this Uri object.<tr><td><a id="l711"></a><a href="#l711">711</a><td> */<tr><td><a id="l712"></a><a href="#l712">712</a><td>goog.Uri.prototype.makeUnique = function() {<tr><td><a id="l713"></a><a href="#l713">713</a><td>  this.enforceReadOnly();<tr><td><a id="l714"></a><a href="#l714">714</a><td>  this.setParameterValue(goog.Uri.RANDOM_PARAM, goog.string.getRandomString());<tr><td><a id="l715"></a><a href="#l715">715</a><td><tr><td><a id="l716"></a><a href="#l716">716</a><td>  return this;<tr><td><a id="l717"></a><a href="#l717">717</a><td>};<tr><td><a id="l718"></a><a href="#l718">718</a><td><tr><td><a id="l719"></a><a href="#l719">719</a><td><tr><td><a id="l720"></a><a href="#l720">720</a><td>/**<tr><td><a id="l721"></a><a href="#l721">721</a><td> * Removes the named query parameter.<tr><td><a id="l722"></a><a href="#l722">722</a><td> *<tr><td><a id="l723"></a><a href="#l723">723</a><td> * @param {string} key The parameter to remove.<tr><td><a id="l724"></a><a href="#l724">724</a><td> * @return {!goog.Uri} Reference to this URI object.<tr><td><a id="l725"></a><a href="#l725">725</a><td> */<tr><td><a id="l726"></a><a href="#l726">726</a><td>goog.Uri.prototype.removeParameter = function(key) {<tr><td><a id="l727"></a><a href="#l727">727</a><td>  this.enforceReadOnly();<tr><td><a id="l728"></a><a href="#l728">728</a><td>  this.queryData_.remove(key);<tr><td><a id="l729"></a><a href="#l729">729</a><td>  return this;<tr><td><a id="l730"></a><a href="#l730">730</a><td>};<tr><td><a id="l731"></a><a href="#l731">731</a><td><tr><td><a id="l732"></a><a href="#l732">732</a><td><tr><td><a id="l733"></a><a href="#l733">733</a><td>/**<tr><td><a id="l734"></a><a href="#l734">734</a><td> * Sets whether Uri is read only. If this goog.Uri is read-only,<tr><td><a id="l735"></a><a href="#l735">735</a><td> * enforceReadOnly_ will be called at the start of any function that may modify<tr><td><a id="l736"></a><a href="#l736">736</a><td> * this Uri.<tr><td><a id="l737"></a><a href="#l737">737</a><td> * @param {boolean} isReadOnly whether this goog.Uri should be read only.<tr><td><a id="l738"></a><a href="#l738">738</a><td> * @return {!goog.Uri} Reference to this Uri object.<tr><td><a id="l739"></a><a href="#l739">739</a><td> */<tr><td><a id="l740"></a><a href="#l740">740</a><td>goog.Uri.prototype.setReadOnly = function(isReadOnly) {<tr><td><a id="l741"></a><a href="#l741">741</a><td>  this.isReadOnly_ = isReadOnly;<tr><td><a id="l742"></a><a href="#l742">742</a><td>  return this;<tr><td><a id="l743"></a><a href="#l743">743</a><td>};<tr><td><a id="l744"></a><a href="#l744">744</a><td><tr><td><a id="l745"></a><a href="#l745">745</a><td><tr><td><a id="l746"></a><a href="#l746">746</a><td>/**<tr><td><a id="l747"></a><a href="#l747">747</a><td> * @return {boolean} Whether the URI is read only.<tr><td><a id="l748"></a><a href="#l748">748</a><td> */<tr><td><a id="l749"></a><a href="#l749">749</a><td>goog.Uri.prototype.isReadOnly = function() {<tr><td><a id="l750"></a><a href="#l750">750</a><td>  return this.isReadOnly_;<tr><td><a id="l751"></a><a href="#l751">751</a><td>};<tr><td><a id="l752"></a><a href="#l752">752</a><td><tr><td><a id="l753"></a><a href="#l753">753</a><td><tr><td><a id="l754"></a><a href="#l754">754</a><td>/**<tr><td><a id="l755"></a><a href="#l755">755</a><td> * Checks if this Uri has been marked as read only, and if so, throws an error.<tr><td><a id="l756"></a><a href="#l756">756</a><td> * This should be called whenever any modifying function is called.<tr><td><a id="l757"></a><a href="#l757">757</a><td> */<tr><td><a id="l758"></a><a href="#l758">758</a><td>goog.Uri.prototype.enforceReadOnly = function() {<tr><td><a id="l759"></a><a href="#l759">759</a><td>  if (this.isReadOnly_) {<tr><td><a id="l760"></a><a href="#l760">760</a><td>    throw Error(&#39;Tried to modify a read-only Uri&#39;);<tr><td><a id="l761"></a><a href="#l761">761</a><td>  }<tr><td><a id="l762"></a><a href="#l762">762</a><td>};<tr><td><a id="l763"></a><a href="#l763">763</a><td><tr><td><a id="l764"></a><a href="#l764">764</a><td><tr><td><a id="l765"></a><a href="#l765">765</a><td>/**<tr><td><a id="l766"></a><a href="#l766">766</a><td> * Sets whether to ignore case.<tr><td><a id="l767"></a><a href="#l767">767</a><td> * NOTE: If there are already key/value pairs in the QueryData, and<tr><td><a id="l768"></a><a href="#l768">768</a><td> * ignoreCase_ is set to false, the keys will all be lower-cased.<tr><td><a id="l769"></a><a href="#l769">769</a><td> * @param {boolean} ignoreCase whether this goog.Uri should ignore case.<tr><td><a id="l770"></a><a href="#l770">770</a><td> * @return {!goog.Uri} Reference to this Uri object.<tr><td><a id="l771"></a><a href="#l771">771</a><td> */<tr><td><a id="l772"></a><a href="#l772">772</a><td>goog.Uri.prototype.setIgnoreCase = function(ignoreCase) {<tr><td><a id="l773"></a><a href="#l773">773</a><td>  this.ignoreCase_ = ignoreCase;<tr><td><a id="l774"></a><a href="#l774">774</a><td>  if (this.queryData_) {<tr><td><a id="l775"></a><a href="#l775">775</a><td>    this.queryData_.setIgnoreCase(ignoreCase);<tr><td><a id="l776"></a><a href="#l776">776</a><td>  }<tr><td><a id="l777"></a><a href="#l777">777</a><td>  return this;<tr><td><a id="l778"></a><a href="#l778">778</a><td>};<tr><td><a id="l779"></a><a href="#l779">779</a><td><tr><td><a id="l780"></a><a href="#l780">780</a><td><tr><td><a id="l781"></a><a href="#l781">781</a><td>/**<tr><td><a id="l782"></a><a href="#l782">782</a><td> * @return {boolean} Whether to ignore case.<tr><td><a id="l783"></a><a href="#l783">783</a><td> */<tr><td><a id="l784"></a><a href="#l784">784</a><td>goog.Uri.prototype.getIgnoreCase = function() {<tr><td><a id="l785"></a><a href="#l785">785</a><td>  return this.ignoreCase_;<tr><td><a id="l786"></a><a href="#l786">786</a><td>};<tr><td><a id="l787"></a><a href="#l787">787</a><td><tr><td><a id="l788"></a><a href="#l788">788</a><td><tr><td><a id="l789"></a><a href="#l789">789</a><td>//==============================================================================<tr><td><a id="l790"></a><a href="#l790">790</a><td>// Static members<tr><td><a id="l791"></a><a href="#l791">791</a><td>//==============================================================================<tr><td><a id="l792"></a><a href="#l792">792</a><td><tr><td><a id="l793"></a><a href="#l793">793</a><td><tr><td><a id="l794"></a><a href="#l794">794</a><td>/**<tr><td><a id="l795"></a><a href="#l795">795</a><td> * Creates a uri from the string form.  Basically an alias of new goog.Uri().<tr><td><a id="l796"></a><a href="#l796">796</a><td> * If a Uri object is passed to parse then it will return a clone of the object.<tr><td><a id="l797"></a><a href="#l797">797</a><td> *<tr><td><a id="l798"></a><a href="#l798">798</a><td> * @throws URIError If parsing the URI is malformed. The passed URI components<tr><td><a id="l799"></a><a href="#l799">799</a><td> *     should all be parseable by decodeURIComponent.<tr><td><a id="l800"></a><a href="#l800">800</a><td> * @param {*} uri Raw URI string or instance of Uri<tr><td><a id="l801"></a><a href="#l801">801</a><td> *     object.<tr><td><a id="l802"></a><a href="#l802">802</a><td> * @param {boolean=} opt_ignoreCase Whether to ignore the case of parameter<tr><td><a id="l803"></a><a href="#l803">803</a><td> * names in #getParameterValue.<tr><td><a id="l804"></a><a href="#l804">804</a><td> * @return {!goog.Uri} The new URI object.<tr><td><a id="l805"></a><a href="#l805">805</a><td> */<tr><td><a id="l806"></a><a href="#l806">806</a><td>goog.Uri.parse = function(uri, opt_ignoreCase) {<tr><td><a id="l807"></a><a href="#l807">807</a><td>  return uri instanceof goog.Uri ?<tr><td><a id="l808"></a><a href="#l808">808</a><td>         uri.clone() : new goog.Uri(uri, opt_ignoreCase);<tr><td><a id="l809"></a><a href="#l809">809</a><td>};<tr><td><a id="l810"></a><a href="#l810">810</a><td><tr><td><a id="l811"></a><a href="#l811">811</a><td><tr><td><a id="l812"></a><a href="#l812">812</a><td>/**<tr><td><a id="l813"></a><a href="#l813">813</a><td> * Creates a new goog.Uri object from unencoded parts.<tr><td><a id="l814"></a><a href="#l814">814</a><td> *<tr><td><a id="l815"></a><a href="#l815">815</a><td> * @param {?string=} opt_scheme Scheme/protocol or full URI to parse.<tr><td><a id="l816"></a><a href="#l816">816</a><td> * @param {?string=} opt_userInfo username:password.<tr><td><a id="l817"></a><a href="#l817">817</a><td> * @param {?string=} opt_domain www.google.com.<tr><td><a id="l818"></a><a href="#l818">818</a><td> * @param {?number=} opt_port 9830.<tr><td><a id="l819"></a><a href="#l819">819</a><td> * @param {?string=} opt_path /some/path/to/a/file.html.<tr><td><a id="l820"></a><a href="#l820">820</a><td> * @param {string|goog.Uri.QueryData=} opt_query a=1&amp;b=2.<tr><td><a id="l821"></a><a href="#l821">821</a><td> * @param {?string=} opt_fragment The fragment without the #.<tr><td><a id="l822"></a><a href="#l822">822</a><td> * @param {boolean=} opt_ignoreCase Whether to ignore parameter name case in<tr><td><a id="l823"></a><a href="#l823">823</a><td> *     #getParameterValue.<tr><td><a id="l824"></a><a href="#l824">824</a><td> *<tr><td><a id="l825"></a><a href="#l825">825</a><td> * @return {!goog.Uri} The new URI object.<tr><td><a id="l826"></a><a href="#l826">826</a><td> */<tr><td><a id="l827"></a><a href="#l827">827</a><td>goog.Uri.create = function(opt_scheme, opt_userInfo, opt_domain, opt_port,<tr><td><a id="l828"></a><a href="#l828">828</a><td>                           opt_path, opt_query, opt_fragment, opt_ignoreCase) {<tr><td><a id="l829"></a><a href="#l829">829</a><td><tr><td><a id="l830"></a><a href="#l830">830</a><td>  var uri = new goog.Uri(null, opt_ignoreCase);<tr><td><a id="l831"></a><a href="#l831">831</a><td><tr><td><a id="l832"></a><a href="#l832">832</a><td>  // Only set the parts if they are defined and not empty strings.<tr><td><a id="l833"></a><a href="#l833">833</a><td>  opt_scheme &amp;&amp; uri.setScheme(opt_scheme);<tr><td><a id="l834"></a><a href="#l834">834</a><td>  opt_userInfo &amp;&amp; uri.setUserInfo(opt_userInfo);<tr><td><a id="l835"></a><a href="#l835">835</a><td>  opt_domain &amp;&amp; uri.setDomain(opt_domain);<tr><td><a id="l836"></a><a href="#l836">836</a><td>  opt_port &amp;&amp; uri.setPort(opt_port);<tr><td><a id="l837"></a><a href="#l837">837</a><td>  opt_path &amp;&amp; uri.setPath(opt_path);<tr><td><a id="l838"></a><a href="#l838">838</a><td>  opt_query &amp;&amp; uri.setQueryData(opt_query);<tr><td><a id="l839"></a><a href="#l839">839</a><td>  opt_fragment &amp;&amp; uri.setFragment(opt_fragment);<tr><td><a id="l840"></a><a href="#l840">840</a><td><tr><td><a id="l841"></a><a href="#l841">841</a><td>  return uri;<tr><td><a id="l842"></a><a href="#l842">842</a><td>};<tr><td><a id="l843"></a><a href="#l843">843</a><td><tr><td><a id="l844"></a><a href="#l844">844</a><td><tr><td><a id="l845"></a><a href="#l845">845</a><td>/**<tr><td><a id="l846"></a><a href="#l846">846</a><td> * Resolves a relative Uri against a base Uri, accepting both strings and<tr><td><a id="l847"></a><a href="#l847">847</a><td> * Uri objects.<tr><td><a id="l848"></a><a href="#l848">848</a><td> *<tr><td><a id="l849"></a><a href="#l849">849</a><td> * @param {*} base Base Uri.<tr><td><a id="l850"></a><a href="#l850">850</a><td> * @param {*} rel Relative Uri.<tr><td><a id="l851"></a><a href="#l851">851</a><td> * @return {!goog.Uri} Resolved uri.<tr><td><a id="l852"></a><a href="#l852">852</a><td> */<tr><td><a id="l853"></a><a href="#l853">853</a><td>goog.Uri.resolve = function(base, rel) {<tr><td><a id="l854"></a><a href="#l854">854</a><td>  if (!(base instanceof goog.Uri)) {<tr><td><a id="l855"></a><a href="#l855">855</a><td>    base = goog.Uri.parse(base);<tr><td><a id="l856"></a><a href="#l856">856</a><td>  }<tr><td><a id="l857"></a><a href="#l857">857</a><td><tr><td><a id="l858"></a><a href="#l858">858</a><td>  if (!(rel instanceof goog.Uri)) {<tr><td><a id="l859"></a><a href="#l859">859</a><td>    rel = goog.Uri.parse(rel);<tr><td><a id="l860"></a><a href="#l860">860</a><td>  }<tr><td><a id="l861"></a><a href="#l861">861</a><td><tr><td><a id="l862"></a><a href="#l862">862</a><td>  return base.resolve(rel);<tr><td><a id="l863"></a><a href="#l863">863</a><td>};<tr><td><a id="l864"></a><a href="#l864">864</a><td><tr><td><a id="l865"></a><a href="#l865">865</a><td><tr><td><a id="l866"></a><a href="#l866">866</a><td>/**<tr><td><a id="l867"></a><a href="#l867">867</a><td> * Removes dot segments in given path component, as described in<tr><td><a id="l868"></a><a href="#l868">868</a><td> * RFC 3986, section 5.2.4.<tr><td><a id="l869"></a><a href="#l869">869</a><td> *<tr><td><a id="l870"></a><a href="#l870">870</a><td> * @param {string} path A non-empty path component.<tr><td><a id="l871"></a><a href="#l871">871</a><td> * @return {string} Path component with removed dot segments.<tr><td><a id="l872"></a><a href="#l872">872</a><td> */<tr><td><a id="l873"></a><a href="#l873">873</a><td>goog.Uri.removeDotSegments = function(path) {<tr><td><a id="l874"></a><a href="#l874">874</a><td>  if (path == &#39;..&#39; || path == &#39;.&#39;) {<tr><td><a id="l875"></a><a href="#l875">875</a><td>    return &#39;&#39;;<tr><td><a id="l876"></a><a href="#l876">876</a><td><tr><td><a id="l877"></a><a href="#l877">877</a><td>  } else if (!goog.string.contains(path, &#39;./&#39;) &amp;&amp;<tr><td><a id="l878"></a><a href="#l878">878</a><td>             !goog.string.contains(path, &#39;/.&#39;)) {<tr><td><a id="l879"></a><a href="#l879">879</a><td>    // This optimization detects uris which do not contain dot-segments,<tr><td><a id="l880"></a><a href="#l880">880</a><td>    // and as a consequence do not require any processing.<tr><td><a id="l881"></a><a href="#l881">881</a><td>    return path;<tr><td><a id="l882"></a><a href="#l882">882</a><td><tr><td><a id="l883"></a><a href="#l883">883</a><td>  } else {<tr><td><a id="l884"></a><a href="#l884">884</a><td>    var leadingSlash = goog.string.startsWith(path, &#39;/&#39;);<tr><td><a id="l885"></a><a href="#l885">885</a><td>    var segments = path.split(&#39;/&#39;);<tr><td><a id="l886"></a><a href="#l886">886</a><td>    var out = [];<tr><td><a id="l887"></a><a href="#l887">887</a><td><tr><td><a id="l888"></a><a href="#l888">888</a><td>    for (var pos = 0; pos &lt; segments.length; ) {<tr><td><a id="l889"></a><a href="#l889">889</a><td>      var segment = segments[pos++];<tr><td><a id="l890"></a><a href="#l890">890</a><td><tr><td><a id="l891"></a><a href="#l891">891</a><td>      if (segment == &#39;.&#39;) {<tr><td><a id="l892"></a><a href="#l892">892</a><td>        if (leadingSlash &amp;&amp; pos == segments.length) {<tr><td><a id="l893"></a><a href="#l893">893</a><td>          out.push(&#39;&#39;);<tr><td><a id="l894"></a><a href="#l894">894</a><td>        }<tr><td><a id="l895"></a><a href="#l895">895</a><td>      } else if (segment == &#39;..&#39;) {<tr><td><a id="l896"></a><a href="#l896">896</a><td>        if (out.length &gt; 1 || out.length == 1 &amp;&amp; out[0] != &#39;&#39;) {<tr><td><a id="l897"></a><a href="#l897">897</a><td>          out.pop();<tr><td><a id="l898"></a><a href="#l898">898</a><td>        }<tr><td><a id="l899"></a><a href="#l899">899</a><td>        if (leadingSlash &amp;&amp; pos == segments.length) {<tr><td><a id="l900"></a><a href="#l900">900</a><td>          out.push(&#39;&#39;);<tr><td><a id="l901"></a><a href="#l901">901</a><td>        }<tr><td><a id="l902"></a><a href="#l902">902</a><td>      } else {<tr><td><a id="l903"></a><a href="#l903">903</a><td>        out.push(segment);<tr><td><a id="l904"></a><a href="#l904">904</a><td>        leadingSlash = true;<tr><td><a id="l905"></a><a href="#l905">905</a><td>      }<tr><td><a id="l906"></a><a href="#l906">906</a><td>    }<tr><td><a id="l907"></a><a href="#l907">907</a><td><tr><td><a id="l908"></a><a href="#l908">908</a><td>    return out.join(&#39;/&#39;);<tr><td><a id="l909"></a><a href="#l909">909</a><td>  }<tr><td><a id="l910"></a><a href="#l910">910</a><td>};<tr><td><a id="l911"></a><a href="#l911">911</a><td><tr><td><a id="l912"></a><a href="#l912">912</a><td><tr><td><a id="l913"></a><a href="#l913">913</a><td>/**<tr><td><a id="l914"></a><a href="#l914">914</a><td> * Decodes a value or returns the empty string if it isn&#39;t defined or empty.<tr><td><a id="l915"></a><a href="#l915">915</a><td> * @throws URIError If decodeURIComponent fails to decode val.<tr><td><a id="l916"></a><a href="#l916">916</a><td> * @param {string|undefined} val Value to decode.<tr><td><a id="l917"></a><a href="#l917">917</a><td> * @param {boolean=} opt_preserveReserved If true, restricted characters will<tr><td><a id="l918"></a><a href="#l918">918</a><td> *     not be decoded.<tr><td><a id="l919"></a><a href="#l919">919</a><td> * @return {string} Decoded value.<tr><td><a id="l920"></a><a href="#l920">920</a><td> * @private<tr><td><a id="l921"></a><a href="#l921">921</a><td> */<tr><td><a id="l922"></a><a href="#l922">922</a><td>goog.Uri.decodeOrEmpty_ = function(val, opt_preserveReserved) {<tr><td><a id="l923"></a><a href="#l923">923</a><td>  // Don&#39;t use UrlDecode() here because val is not a query parameter.<tr><td><a id="l924"></a><a href="#l924">924</a><td>  if (!val) {<tr><td><a id="l925"></a><a href="#l925">925</a><td>    return &#39;&#39;;<tr><td><a id="l926"></a><a href="#l926">926</a><td>  }<tr><td><a id="l927"></a><a href="#l927">927</a><td><tr><td><a id="l928"></a><a href="#l928">928</a><td>  // decodeURI has the same output for &#39;%2f&#39; and &#39;%252f&#39;. We double encode %25<tr><td><a id="l929"></a><a href="#l929">929</a><td>  // so that we can distinguish between the 2 inputs. This is later undone by<tr><td><a id="l930"></a><a href="#l930">930</a><td>  // removeDoubleEncoding_.<tr><td><a id="l931"></a><a href="#l931">931</a><td>  return opt_preserveReserved ?<tr><td><a id="l932"></a><a href="#l932">932</a><td>      decodeURI(val.replace(/%25/g, &#39;%2525&#39;)) : decodeURIComponent(val);<tr><td><a id="l933"></a><a href="#l933">933</a><td>};<tr><td><a id="l934"></a><a href="#l934">934</a><td><tr><td><a id="l935"></a><a href="#l935">935</a><td><tr><td><a id="l936"></a><a href="#l936">936</a><td>/**<tr><td><a id="l937"></a><a href="#l937">937</a><td> * If unescapedPart is non null, then escapes any characters in it that aren&#39;t<tr><td><a id="l938"></a><a href="#l938">938</a><td> * valid characters in a url and also escapes any special characters that<tr><td><a id="l939"></a><a href="#l939">939</a><td> * appear in extra.<tr><td><a id="l940"></a><a href="#l940">940</a><td> *<tr><td><a id="l941"></a><a href="#l941">941</a><td> * @param {*} unescapedPart The string to encode.<tr><td><a id="l942"></a><a href="#l942">942</a><td> * @param {RegExp} extra A character set of characters in [\01-\177].<tr><td><a id="l943"></a><a href="#l943">943</a><td> * @param {boolean=} opt_removeDoubleEncoding If true, remove double percent<tr><td><a id="l944"></a><a href="#l944">944</a><td> *     encoding.<tr><td><a id="l945"></a><a href="#l945">945</a><td> * @return {?string} null iff unescapedPart == null.<tr><td><a id="l946"></a><a href="#l946">946</a><td> * @private<tr><td><a id="l947"></a><a href="#l947">947</a><td> */<tr><td><a id="l948"></a><a href="#l948">948</a><td>goog.Uri.encodeSpecialChars_ = function(unescapedPart, extra,<tr><td><a id="l949"></a><a href="#l949">949</a><td>    opt_removeDoubleEncoding) {<tr><td><a id="l950"></a><a href="#l950">950</a><td>  if (goog.isString(unescapedPart)) {<tr><td><a id="l951"></a><a href="#l951">951</a><td>    var encoded = encodeURI(unescapedPart).<tr><td><a id="l952"></a><a href="#l952">952</a><td>        replace(extra, goog.Uri.encodeChar_);<tr><td><a id="l953"></a><a href="#l953">953</a><td>    if (opt_removeDoubleEncoding) {<tr><td><a id="l954"></a><a href="#l954">954</a><td>      // encodeURI double-escapes %XX sequences used to represent restricted<tr><td><a id="l955"></a><a href="#l955">955</a><td>      // characters in some URI components, remove the double escaping here.<tr><td><a id="l956"></a><a href="#l956">956</a><td>      encoded = goog.Uri.removeDoubleEncoding_(encoded);<tr><td><a id="l957"></a><a href="#l957">957</a><td>    }<tr><td><a id="l958"></a><a href="#l958">958</a><td>    return encoded;<tr><td><a id="l959"></a><a href="#l959">959</a><td>  }<tr><td><a id="l960"></a><a href="#l960">960</a><td>  return null;<tr><td><a id="l961"></a><a href="#l961">961</a><td>};<tr><td><a id="l962"></a><a href="#l962">962</a><td><tr><td><a id="l963"></a><a href="#l963">963</a><td><tr><td><a id="l964"></a><a href="#l964">964</a><td>/**<tr><td><a id="l965"></a><a href="#l965">965</a><td> * Converts a character in [\01-\177] to its unicode character equivalent.<tr><td><a id="l966"></a><a href="#l966">966</a><td> * @param {string} ch One character string.<tr><td><a id="l967"></a><a href="#l967">967</a><td> * @return {string} Encoded string.<tr><td><a id="l968"></a><a href="#l968">968</a><td> * @private<tr><td><a id="l969"></a><a href="#l969">969</a><td> */<tr><td><a id="l970"></a><a href="#l970">970</a><td>goog.Uri.encodeChar_ = function(ch) {<tr><td><a id="l971"></a><a href="#l971">971</a><td>  var n = ch.charCodeAt(0);<tr><td><a id="l972"></a><a href="#l972">972</a><td>  return &#39;%&#39; + ((n &gt;&gt; 4) &amp; 0xf).toString(16) + (n &amp; 0xf).toString(16);<tr><td><a id="l973"></a><a href="#l973">973</a><td>};<tr><td><a id="l974"></a><a href="#l974">974</a><td><tr><td><a id="l975"></a><a href="#l975">975</a><td><tr><td><a id="l976"></a><a href="#l976">976</a><td>/**<tr><td><a id="l977"></a><a href="#l977">977</a><td> * Removes double percent-encoding from a string.<tr><td><a id="l978"></a><a href="#l978">978</a><td> * @param  {string} doubleEncodedString String<tr><td><a id="l979"></a><a href="#l979">979</a><td> * @return {string} String with double encoding removed.<tr><td><a id="l980"></a><a href="#l980">980</a><td> * @private<tr><td><a id="l981"></a><a href="#l981">981</a><td> */<tr><td><a id="l982"></a><a href="#l982">982</a><td>goog.Uri.removeDoubleEncoding_ = function(doubleEncodedString) {<tr><td><a id="l983"></a><a href="#l983">983</a><td>  return doubleEncodedString.replace(/%25([0-9a-fA-F]{2})/g, &#39;%$1&#39;);<tr><td><a id="l984"></a><a href="#l984">984</a><td>};<tr><td><a id="l985"></a><a href="#l985">985</a><td><tr><td><a id="l986"></a><a href="#l986">986</a><td><tr><td><a id="l987"></a><a href="#l987">987</a><td>/**<tr><td><a id="l988"></a><a href="#l988">988</a><td> * Regular expression for characters that are disallowed in the scheme or<tr><td><a id="l989"></a><a href="#l989">989</a><td> * userInfo part of the URI.<tr><td><a id="l990"></a><a href="#l990">990</a><td> * @type {RegExp}<tr><td><a id="l991"></a><a href="#l991">991</a><td> * @private<tr><td><a id="l992"></a><a href="#l992">992</a><td> */<tr><td><a id="l993"></a><a href="#l993">993</a><td>goog.Uri.reDisallowedInSchemeOrUserInfo_ = /[#\/\?@]/g;<tr><td><a id="l994"></a><a href="#l994">994</a><td><tr><td><a id="l995"></a><a href="#l995">995</a><td><tr><td><a id="l996"></a><a href="#l996">996</a><td>/**<tr><td><a id="l997"></a><a href="#l997">997</a><td> * Regular expression for characters that are disallowed in a relative path.<tr><td><a id="l998"></a><a href="#l998">998</a><td> * Colon is included due to RFC 3986 3.3.<tr><td><a id="l999"></a><a href="#l999">999</a><td> * @type {RegExp}<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td> * @private<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td> */<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td>goog.Uri.reDisallowedInRelativePath_ = /[\#\?:]/g;<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td><tr><td><a id="l1004"></a><a href="#l1004">1004</a><td><tr><td><a id="l1005"></a><a href="#l1005">1005</a><td>/**<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td> * Regular expression for characters that are disallowed in an absolute path.<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td> * @type {RegExp}<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td> * @private<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td> */<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td>goog.Uri.reDisallowedInAbsolutePath_ = /[\#\?]/g;<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td><tr><td><a id="l1012"></a><a href="#l1012">1012</a><td><tr><td><a id="l1013"></a><a href="#l1013">1013</a><td>/**<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td> * Regular expression for characters that are disallowed in the query.<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td> * @type {RegExp}<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td> * @private<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td> */<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td>goog.Uri.reDisallowedInQuery_ = /[\#\?@]/g;<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td><tr><td><a id="l1020"></a><a href="#l1020">1020</a><td><tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>/**<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td> * Regular expression for characters that are disallowed in the fragment.<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td> * @type {RegExp}<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td> * @private<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td> */<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>goog.Uri.reDisallowedInFragment_ = /#/g;<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td><tr><td><a id="l1028"></a><a href="#l1028">1028</a><td><tr><td><a id="l1029"></a><a href="#l1029">1029</a><td>/**<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td> * Checks whether two URIs have the same domain.<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td> * @param {string} uri1String First URI string.<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td> * @param {string} uri2String Second URI string.<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td> * @return {boolean} true if the two URIs have the same domain; false otherwise.<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td> */<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>goog.Uri.haveSameDomain = function(uri1String, uri2String) {<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>  // Differs from goog.uri.utils.haveSameDomain, since this ignores scheme.<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td>  // TODO(gboyer): Have this just call goog.uri.util.haveSameDomain.<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td>  var pieces1 = goog.uri.utils.split(uri1String);<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>  var pieces2 = goog.uri.utils.split(uri2String);<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>  return pieces1[goog.uri.utils.ComponentIndex.DOMAIN] ==<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td>             pieces2[goog.uri.utils.ComponentIndex.DOMAIN] &amp;&amp;<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td>         pieces1[goog.uri.utils.ComponentIndex.PORT] ==<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td>             pieces2[goog.uri.utils.ComponentIndex.PORT];<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>};<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td><tr><td><a id="l1046"></a><a href="#l1046">1046</a><td><tr><td><a id="l1047"></a><a href="#l1047">1047</a><td><tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>/**<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td> * Class used to represent URI query parameters.  It is essentially a hash of<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td> * name-value pairs, though a name can be present more than once.<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td> *<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td> * Has the same interface as the collections in goog.structs.<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td> *<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td> * @param {?string=} opt_query Optional encoded query string to parse into<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td> *     the object.<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td> * @param {goog.Uri=} opt_uri Optional uri object that should have its<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td> *     cache invalidated when this object updates. Deprecated -- this<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td> *     is no longer required.<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td> * @param {boolean=} opt_ignoreCase If true, ignore the case of the parameter<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td> *     name in #get.<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td> * @constructor<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td> * @struct<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td> * @final<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td> */<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td>goog.Uri.QueryData = function(opt_query, opt_uri, opt_ignoreCase) {<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td>  /**<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>   * The map containing name/value or name/array-of-values pairs.<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td>   * May be null if it requires parsing from the query string.<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td>   *<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td>   * We need to use a Map because we cannot guarantee that the key names will<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td>   * not be problematic for IE.<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td>   *<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td>   * @private {goog.structs.Map&lt;string, !Array&lt;*&gt;&gt;}<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>   */<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td>  this.keyMap_ = null;<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td><tr><td><a id="l1077"></a><a href="#l1077">1077</a><td>  /**<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td>   * The number of params, or null if it requires computing.<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td>   * @private {?number}<tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>   */<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td>  this.count_ = null;<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td><tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>  /**<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td>   * Encoded query string, or null if it requires computing from the key map.<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td>   * @private {?string}<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td>   */<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>  this.encodedQuery_ = opt_query || null;<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td><tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>  /**<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>   * If true, ignore the case of the parameter name in #get.<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td>   * @private {boolean}<tr><td><a id="l1092"></a><a href="#l1092">1092</a><td>   */<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td>  this.ignoreCase_ = !!opt_ignoreCase;<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td>};<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td><tr><td><a id="l1096"></a><a href="#l1096">1096</a><td><tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>/**<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td> * If the underlying key map is not yet initialized, it parses the<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td> * query string and fills the map with parsed data.<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td> * @private<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td> */<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td>goog.Uri.QueryData.prototype.ensureKeyMapInitialized_ = function() {<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td>  if (!this.keyMap_) {<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td>    this.keyMap_ = new goog.structs.Map();<tr><td><a id="l1105"></a><a href="#l1105">1105</a><td>    this.count_ = 0;<tr><td><a id="l1106"></a><a href="#l1106">1106</a><td>    if (this.encodedQuery_) {<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td>      var self = this;<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td>      goog.uri.utils.parseQueryData(this.encodedQuery_, function(name, value) {<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td>        self.add(goog.string.urlDecode(name), value);<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td>      });<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td>    }<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td>  }<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td>};<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td><tr><td><a id="l1115"></a><a href="#l1115">1115</a><td><tr><td><a id="l1116"></a><a href="#l1116">1116</a><td>/**<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td> * Creates a new query data instance from a map of names and values.<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td> *<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td> * @param {!goog.structs.Map&lt;string, ?&gt;|!Object} map Map of string parameter<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td> *     names to parameter value. If parameter value is an array, it is<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td> *     treated as if the key maps to each individual value in the<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td> *     array.<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td> * @param {goog.Uri=} opt_uri URI object that should have its cache<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td> *     invalidated when this object updates.<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td> * @param {boolean=} opt_ignoreCase If true, ignore the case of the parameter<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td> *     name in #get.<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td> * @return {!goog.Uri.QueryData} The populated query data instance.<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td> */<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td>goog.Uri.QueryData.createFromMap = function(map, opt_uri, opt_ignoreCase) {<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td>  var keys = goog.structs.getKeys(map);<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td>  if (typeof keys == &#39;undefined&#39;) {<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td>    throw Error(&#39;Keys are undefined&#39;);<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td>  }<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td><tr><td><a id="l1135"></a><a href="#l1135">1135</a><td>  var queryData = new goog.Uri.QueryData(null, null, opt_ignoreCase);<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td>  var values = goog.structs.getValues(map);<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td>    var key = keys[i];<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>    var value = values[i];<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td>    if (!goog.isArray(value)) {<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td>      queryData.add(key, value);<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>    } else {<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>      queryData.setValues(key, value);<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td>    }<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>  }<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>  return queryData;<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td>};<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td><tr><td><a id="l1149"></a><a href="#l1149">1149</a><td><tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>/**<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td> * Creates a new query data instance from parallel arrays of parameter names<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td> * and values. Allows for duplicate parameter names. Throws an error if the<tr><td><a id="l1153"></a><a href="#l1153">1153</a><td> * lengths of the arrays differ.<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td> *<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td> * @param {!Array&lt;string&gt;} keys Parameter names.<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td> * @param {!Array&lt;?&gt;} values Parameter values.<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td> * @param {goog.Uri=} opt_uri URI object that should have its cache<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td> *     invalidated when this object updates.<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td> * @param {boolean=} opt_ignoreCase If true, ignore the case of the parameter<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td> *     name in #get.<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td> * @return {!goog.Uri.QueryData} The populated query data instance.<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td> */<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td>goog.Uri.QueryData.createFromKeysValues = function(<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td>    keys, values, opt_uri, opt_ignoreCase) {<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>  if (keys.length != values.length) {<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td>    throw Error(&#39;Mismatched lengths for keys/values&#39;);<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>  }<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td>  var queryData = new goog.Uri.QueryData(null, null, opt_ignoreCase);<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td>    queryData.add(keys[i], values[i]);<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td>  }<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td>  return queryData;<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td>};<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td><tr><td><a id="l1175"></a><a href="#l1175">1175</a><td><tr><td><a id="l1176"></a><a href="#l1176">1176</a><td>/**<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td> * @return {?number} The number of parameters.<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td> */<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td>goog.Uri.QueryData.prototype.getCount = function() {<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td>  return this.count_;<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td>};<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td><tr><td><a id="l1184"></a><a href="#l1184">1184</a><td><tr><td><a id="l1185"></a><a href="#l1185">1185</a><td>/**<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td> * Adds a key value pair.<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td> * @param {string} key Name.<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td> * @param {*} value Value.<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td> * @return {!goog.Uri.QueryData} Instance of this object.<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td> */<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td>goog.Uri.QueryData.prototype.add = function(key, value) {<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>  this.invalidateCache_();<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td><tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>  key = this.getKeyName_(key);<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td>  var values = this.keyMap_.get(key);<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td>  if (!values) {<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td>    this.keyMap_.set(key, (values = []));<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td>  }<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td>  values.push(value);<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td>  this.count_++;<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td>  return this;<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td>};<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td><tr><td><a id="l1205"></a><a href="#l1205">1205</a><td><tr><td><a id="l1206"></a><a href="#l1206">1206</a><td>/**<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td> * Removes all the params with the given key.<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td> * @param {string} key Name.<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td> * @return {boolean} Whether any parameter was removed.<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td> */<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td>goog.Uri.QueryData.prototype.remove = function(key) {<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1213"></a><a href="#l1213">1213</a><td><tr><td><a id="l1214"></a><a href="#l1214">1214</a><td>  key = this.getKeyName_(key);<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td>  if (this.keyMap_.containsKey(key)) {<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td>    this.invalidateCache_();<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td><tr><td><a id="l1218"></a><a href="#l1218">1218</a><td>    // Decrement parameter count.<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td>    this.count_ -= this.keyMap_.get(key).length;<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td>    return this.keyMap_.remove(key);<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td>  }<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>  return false;<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>};<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td><tr><td><a id="l1225"></a><a href="#l1225">1225</a><td><tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>/**<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td> * Clears the parameters.<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td> */<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td>goog.Uri.QueryData.prototype.clear = function() {<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td>  this.invalidateCache_();<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td>  this.keyMap_ = null;<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td>  this.count_ = 0;<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td>};<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td><tr><td><a id="l1235"></a><a href="#l1235">1235</a><td><tr><td><a id="l1236"></a><a href="#l1236">1236</a><td>/**<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td> * @return {boolean} Whether we have any parameters.<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td> */<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>goog.Uri.QueryData.prototype.isEmpty = function() {<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td>  return this.count_ == 0;<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td>};<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td><tr><td><a id="l1244"></a><a href="#l1244">1244</a><td><tr><td><a id="l1245"></a><a href="#l1245">1245</a><td>/**<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td> * Whether there is a parameter with the given name<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td> * @param {string} key The parameter name to check for.<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td> * @return {boolean} Whether there is a parameter with the given name.<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td> */<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>goog.Uri.QueryData.prototype.containsKey = function(key) {<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td>  key = this.getKeyName_(key);<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>  return this.keyMap_.containsKey(key);<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td>};<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td><tr><td><a id="l1256"></a><a href="#l1256">1256</a><td><tr><td><a id="l1257"></a><a href="#l1257">1257</a><td>/**<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td> * Whether there is a parameter with the given value.<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td> * @param {*} value The value to check for.<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td> * @return {boolean} Whether there is a parameter with the given value.<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td> */<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td>goog.Uri.QueryData.prototype.containsValue = function(value) {<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td>  // NOTE(arv): This solution goes through all the params even if it was the<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>  // first param. We can get around this by not reusing code or by switching to<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>  // iterators.<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>  var vals = this.getValues();<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>  return goog.array.contains(vals, value);<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td>};<tr><td><a id="l1269"></a><a href="#l1269">1269</a><td><tr><td><a id="l1270"></a><a href="#l1270">1270</a><td><tr><td><a id="l1271"></a><a href="#l1271">1271</a><td>/**<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td> * Returns all the keys of the parameters. If a key is used multiple times<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td> * it will be included multiple times in the returned array<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td> * @return {!Array&lt;string&gt;} All the keys of the parameters.<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td> */<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td>goog.Uri.QueryData.prototype.getKeys = function() {<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td>  // We need to get the values to know how many keys to add.<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>  var vals = /** @type {!Array&lt;*&gt;} */ (this.keyMap_.getValues());<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td>  var keys = this.keyMap_.getKeys();<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>  var rv = [];<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>    var val = vals[i];<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>    for (var j = 0; j &lt; val.length; j++) {<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>      rv.push(keys[i]);<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>    }<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>  }<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td>  return rv;<tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>};<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td><tr><td><a id="l1291"></a><a href="#l1291">1291</a><td><tr><td><a id="l1292"></a><a href="#l1292">1292</a><td>/**<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td> * Returns all the values of the parameters with the given name. If the query<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td> * data has no such key this will return an empty array. If no key is given<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td> * all values wil be returned.<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td> * @param {string=} opt_key The name of the parameter to get the values for.<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td> * @return {!Array&lt;?&gt;} All the values of the parameters with the given name.<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td> */<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td>goog.Uri.QueryData.prototype.getValues = function(opt_key) {<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>  var rv = [];<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td>  if (goog.isString(opt_key)) {<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td>    if (this.containsKey(opt_key)) {<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>      rv = goog.array.concat(rv, this.keyMap_.get(this.getKeyName_(opt_key)));<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td>    }<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td>  } else {<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td>    // Return all values.<tr><td><a id="l1308"></a><a href="#l1308">1308</a><td>    var values = this.keyMap_.getValues();<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td>    for (var i = 0; i &lt; values.length; i++) {<tr><td><a id="l1310"></a><a href="#l1310">1310</a><td>      rv = goog.array.concat(rv, values[i]);<tr><td><a id="l1311"></a><a href="#l1311">1311</a><td>    }<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td>  }<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td>  return rv;<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td>};<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td><tr><td><a id="l1316"></a><a href="#l1316">1316</a><td><tr><td><a id="l1317"></a><a href="#l1317">1317</a><td>/**<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td> * Sets a key value pair and removes all other keys with the same value.<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td> *<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td> * @param {string} key Name.<tr><td><a id="l1321"></a><a href="#l1321">1321</a><td> * @param {*} value Value.<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td> * @return {!goog.Uri.QueryData} Instance of this object.<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td> */<tr><td><a id="l1324"></a><a href="#l1324">1324</a><td>goog.Uri.QueryData.prototype.set = function(key, value) {<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td>  this.invalidateCache_();<tr><td><a id="l1327"></a><a href="#l1327">1327</a><td><tr><td><a id="l1328"></a><a href="#l1328">1328</a><td>  // TODO(chrishenry): This could be better written as<tr><td><a id="l1329"></a><a href="#l1329">1329</a><td>  // this.remove(key), this.add(key, value), but that would reorder<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td>  // the key (since the key is first removed and then added at the<tr><td><a id="l1331"></a><a href="#l1331">1331</a><td>  // end) and we would have to fix unit tests that depend on key<tr><td><a id="l1332"></a><a href="#l1332">1332</a><td>  // ordering.<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td>  key = this.getKeyName_(key);<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td>  if (this.containsKey(key)) {<tr><td><a id="l1335"></a><a href="#l1335">1335</a><td>    this.count_ -= this.keyMap_.get(key).length;<tr><td><a id="l1336"></a><a href="#l1336">1336</a><td>  }<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td>  this.keyMap_.set(key, [value]);<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td>  this.count_++;<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td>  return this;<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td>};<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td><tr><td><a id="l1342"></a><a href="#l1342">1342</a><td><tr><td><a id="l1343"></a><a href="#l1343">1343</a><td>/**<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td> * Returns the first value associated with the key. If the query data has no<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td> * such key this will return undefined or the optional default.<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td> * @param {string} key The name of the parameter to get the value for.<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td> * @param {*=} opt_default The default value to return if the query data<tr><td><a id="l1348"></a><a href="#l1348">1348</a><td> *     has no such key.<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td> * @return {*} The first string value associated with the key, or opt_default<tr><td><a id="l1350"></a><a href="#l1350">1350</a><td> *     if there&#39;s no value.<tr><td><a id="l1351"></a><a href="#l1351">1351</a><td> */<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td>goog.Uri.QueryData.prototype.get = function(key, opt_default) {<tr><td><a id="l1353"></a><a href="#l1353">1353</a><td>  var values = key ? this.getValues(key) : [];<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td>  if (goog.Uri.preserveParameterTypesCompatibilityFlag) {<tr><td><a id="l1355"></a><a href="#l1355">1355</a><td>    return values.length &gt; 0 ? values[0] : opt_default;<tr><td><a id="l1356"></a><a href="#l1356">1356</a><td>  } else {<tr><td><a id="l1357"></a><a href="#l1357">1357</a><td>    return values.length &gt; 0 ? String(values[0]) : opt_default;<tr><td><a id="l1358"></a><a href="#l1358">1358</a><td>  }<tr><td><a id="l1359"></a><a href="#l1359">1359</a><td>};<tr><td><a id="l1360"></a><a href="#l1360">1360</a><td><tr><td><a id="l1361"></a><a href="#l1361">1361</a><td><tr><td><a id="l1362"></a><a href="#l1362">1362</a><td>/**<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td> * Sets the values for a key. If the key already exists, this will<tr><td><a id="l1364"></a><a href="#l1364">1364</a><td> * override all of the existing values that correspond to the key.<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td> * @param {string} key The key to set values for.<tr><td><a id="l1366"></a><a href="#l1366">1366</a><td> * @param {!Array&lt;?&gt;} values The values to set.<tr><td><a id="l1367"></a><a href="#l1367">1367</a><td> */<tr><td><a id="l1368"></a><a href="#l1368">1368</a><td>goog.Uri.QueryData.prototype.setValues = function(key, values) {<tr><td><a id="l1369"></a><a href="#l1369">1369</a><td>  this.remove(key);<tr><td><a id="l1370"></a><a href="#l1370">1370</a><td><tr><td><a id="l1371"></a><a href="#l1371">1371</a><td>  if (values.length &gt; 0) {<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td>    this.invalidateCache_();<tr><td><a id="l1373"></a><a href="#l1373">1373</a><td>    this.keyMap_.set(this.getKeyName_(key), goog.array.clone(values));<tr><td><a id="l1374"></a><a href="#l1374">1374</a><td>    this.count_ += values.length;<tr><td><a id="l1375"></a><a href="#l1375">1375</a><td>  }<tr><td><a id="l1376"></a><a href="#l1376">1376</a><td>};<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td><tr><td><a id="l1378"></a><a href="#l1378">1378</a><td><tr><td><a id="l1379"></a><a href="#l1379">1379</a><td>/**<tr><td><a id="l1380"></a><a href="#l1380">1380</a><td> * @return {string} Encoded query string.<tr><td><a id="l1381"></a><a href="#l1381">1381</a><td> * @override<tr><td><a id="l1382"></a><a href="#l1382">1382</a><td> */<tr><td><a id="l1383"></a><a href="#l1383">1383</a><td>goog.Uri.QueryData.prototype.toString = function() {<tr><td><a id="l1384"></a><a href="#l1384">1384</a><td>  if (this.encodedQuery_) {<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td>    return this.encodedQuery_;<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td>  }<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td><tr><td><a id="l1388"></a><a href="#l1388">1388</a><td>  if (!this.keyMap_) {<tr><td><a id="l1389"></a><a href="#l1389">1389</a><td>    return &#39;&#39;;<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td>  }<tr><td><a id="l1391"></a><a href="#l1391">1391</a><td><tr><td><a id="l1392"></a><a href="#l1392">1392</a><td>  var sb = [];<tr><td><a id="l1393"></a><a href="#l1393">1393</a><td><tr><td><a id="l1394"></a><a href="#l1394">1394</a><td>  // In the past, we use this.getKeys() and this.getVals(), but that<tr><td><a id="l1395"></a><a href="#l1395">1395</a><td>  // generates a lot of allocations as compared to simply iterating<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td>  // over the keys.<tr><td><a id="l1397"></a><a href="#l1397">1397</a><td>  var keys = this.keyMap_.getKeys();<tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>  for (var i = 0; i &lt; keys.length; i++) {<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td>    var key = keys[i];<tr><td><a id="l1400"></a><a href="#l1400">1400</a><td>    var encodedKey = goog.string.urlEncode(key);<tr><td><a id="l1401"></a><a href="#l1401">1401</a><td>    var val = this.getValues(key);<tr><td><a id="l1402"></a><a href="#l1402">1402</a><td>    for (var j = 0; j &lt; val.length; j++) {<tr><td><a id="l1403"></a><a href="#l1403">1403</a><td>      var param = encodedKey;<tr><td><a id="l1404"></a><a href="#l1404">1404</a><td>      // Ensure that null and undefined are encoded into the url as<tr><td><a id="l1405"></a><a href="#l1405">1405</a><td>      // literal strings.<tr><td><a id="l1406"></a><a href="#l1406">1406</a><td>      if (val[j] !== &#39;&#39;) {<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td>        param += &#39;=&#39; + goog.string.urlEncode(val[j]);<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td>      }<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td>      sb.push(param);<tr><td><a id="l1410"></a><a href="#l1410">1410</a><td>    }<tr><td><a id="l1411"></a><a href="#l1411">1411</a><td>  }<tr><td><a id="l1412"></a><a href="#l1412">1412</a><td><tr><td><a id="l1413"></a><a href="#l1413">1413</a><td>  return this.encodedQuery_ = sb.join(&#39;&amp;&#39;);<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td>};<tr><td><a id="l1415"></a><a href="#l1415">1415</a><td><tr><td><a id="l1416"></a><a href="#l1416">1416</a><td><tr><td><a id="l1417"></a><a href="#l1417">1417</a><td>/**<tr><td><a id="l1418"></a><a href="#l1418">1418</a><td> * @throws URIError If URI is malformed (that is, if decodeURIComponent fails on<tr><td><a id="l1419"></a><a href="#l1419">1419</a><td> *     any of the URI components).<tr><td><a id="l1420"></a><a href="#l1420">1420</a><td> * @return {string} Decoded query string.<tr><td><a id="l1421"></a><a href="#l1421">1421</a><td> */<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td>goog.Uri.QueryData.prototype.toDecodedString = function() {<tr><td><a id="l1423"></a><a href="#l1423">1423</a><td>  return goog.Uri.decodeOrEmpty_(this.toString());<tr><td><a id="l1424"></a><a href="#l1424">1424</a><td>};<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td><tr><td><a id="l1426"></a><a href="#l1426">1426</a><td><tr><td><a id="l1427"></a><a href="#l1427">1427</a><td>/**<tr><td><a id="l1428"></a><a href="#l1428">1428</a><td> * Invalidate the cache.<tr><td><a id="l1429"></a><a href="#l1429">1429</a><td> * @private<tr><td><a id="l1430"></a><a href="#l1430">1430</a><td> */<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td>goog.Uri.QueryData.prototype.invalidateCache_ = function() {<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td>  this.encodedQuery_ = null;<tr><td><a id="l1433"></a><a href="#l1433">1433</a><td>};<tr><td><a id="l1434"></a><a href="#l1434">1434</a><td><tr><td><a id="l1435"></a><a href="#l1435">1435</a><td><tr><td><a id="l1436"></a><a href="#l1436">1436</a><td>/**<tr><td><a id="l1437"></a><a href="#l1437">1437</a><td> * Removes all keys that are not in the provided list. (Modifies this object.)<tr><td><a id="l1438"></a><a href="#l1438">1438</a><td> * @param {Array&lt;string&gt;} keys The desired keys.<tr><td><a id="l1439"></a><a href="#l1439">1439</a><td> * @return {!goog.Uri.QueryData} a reference to this object.<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td> */<tr><td><a id="l1441"></a><a href="#l1441">1441</a><td>goog.Uri.QueryData.prototype.filterKeys = function(keys) {<tr><td><a id="l1442"></a><a href="#l1442">1442</a><td>  this.ensureKeyMapInitialized_();<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td>  this.keyMap_.forEach(<tr><td><a id="l1444"></a><a href="#l1444">1444</a><td>      function(value, key) {<tr><td><a id="l1445"></a><a href="#l1445">1445</a><td>        if (!goog.array.contains(keys, key)) {<tr><td><a id="l1446"></a><a href="#l1446">1446</a><td>          this.remove(key);<tr><td><a id="l1447"></a><a href="#l1447">1447</a><td>        }<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td>      }, this);<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td>  return this;<tr><td><a id="l1450"></a><a href="#l1450">1450</a><td>};<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td><tr><td><a id="l1452"></a><a href="#l1452">1452</a><td><tr><td><a id="l1453"></a><a href="#l1453">1453</a><td>/**<tr><td><a id="l1454"></a><a href="#l1454">1454</a><td> * Clone the query data instance.<tr><td><a id="l1455"></a><a href="#l1455">1455</a><td> * @return {!goog.Uri.QueryData} New instance of the QueryData object.<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td> */<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td>goog.Uri.QueryData.prototype.clone = function() {<tr><td><a id="l1458"></a><a href="#l1458">1458</a><td>  var rv = new goog.Uri.QueryData();<tr><td><a id="l1459"></a><a href="#l1459">1459</a><td>  rv.encodedQuery_ = this.encodedQuery_;<tr><td><a id="l1460"></a><a href="#l1460">1460</a><td>  if (this.keyMap_) {<tr><td><a id="l1461"></a><a href="#l1461">1461</a><td>    rv.keyMap_ = this.keyMap_.clone();<tr><td><a id="l1462"></a><a href="#l1462">1462</a><td>    rv.count_ = this.count_;<tr><td><a id="l1463"></a><a href="#l1463">1463</a><td>  }<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td>  return rv;<tr><td><a id="l1465"></a><a href="#l1465">1465</a><td>};<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td><tr><td><a id="l1467"></a><a href="#l1467">1467</a><td><tr><td><a id="l1468"></a><a href="#l1468">1468</a><td>/**<tr><td><a id="l1469"></a><a href="#l1469">1469</a><td> * Helper function to get the key name from a JavaScript object. Converts<tr><td><a id="l1470"></a><a href="#l1470">1470</a><td> * the object to a string, and to lower case if necessary.<tr><td><a id="l1471"></a><a href="#l1471">1471</a><td> * @private<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td> * @param {*} arg The object to get a key name from.<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td> * @return {string} valid key name which can be looked up in #keyMap_.<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td> */<tr><td><a id="l1475"></a><a href="#l1475">1475</a><td>goog.Uri.QueryData.prototype.getKeyName_ = function(arg) {<tr><td><a id="l1476"></a><a href="#l1476">1476</a><td>  var keyName = String(arg);<tr><td><a id="l1477"></a><a href="#l1477">1477</a><td>  if (this.ignoreCase_) {<tr><td><a id="l1478"></a><a href="#l1478">1478</a><td>    keyName = keyName.toLowerCase();<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td>  }<tr><td><a id="l1480"></a><a href="#l1480">1480</a><td>  return keyName;<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td>};<tr><td><a id="l1482"></a><a href="#l1482">1482</a><td><tr><td><a id="l1483"></a><a href="#l1483">1483</a><td><tr><td><a id="l1484"></a><a href="#l1484">1484</a><td>/**<tr><td><a id="l1485"></a><a href="#l1485">1485</a><td> * Ignore case in parameter names.<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td> * NOTE: If there are already key/value pairs in the QueryData, and<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td> * ignoreCase_ is set to false, the keys will all be lower-cased.<tr><td><a id="l1488"></a><a href="#l1488">1488</a><td> * @param {boolean} ignoreCase whether this goog.Uri should ignore case.<tr><td><a id="l1489"></a><a href="#l1489">1489</a><td> */<tr><td><a id="l1490"></a><a href="#l1490">1490</a><td>goog.Uri.QueryData.prototype.setIgnoreCase = function(ignoreCase) {<tr><td><a id="l1491"></a><a href="#l1491">1491</a><td>  var resetKeys = ignoreCase &amp;&amp; !this.ignoreCase_;<tr><td><a id="l1492"></a><a href="#l1492">1492</a><td>  if (resetKeys) {<tr><td><a id="l1493"></a><a href="#l1493">1493</a><td>    this.ensureKeyMapInitialized_();<tr><td><a id="l1494"></a><a href="#l1494">1494</a><td>    this.invalidateCache_();<tr><td><a id="l1495"></a><a href="#l1495">1495</a><td>    this.keyMap_.forEach(<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td>        function(value, key) {<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td>          var lowerCase = key.toLowerCase();<tr><td><a id="l1498"></a><a href="#l1498">1498</a><td>          if (key != lowerCase) {<tr><td><a id="l1499"></a><a href="#l1499">1499</a><td>            this.remove(key);<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td>            this.setValues(lowerCase, value);<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td>          }<tr><td><a id="l1502"></a><a href="#l1502">1502</a><td>        }, this);<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td>  }<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td>  this.ignoreCase_ = ignoreCase;<tr><td><a id="l1505"></a><a href="#l1505">1505</a><td>};<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td><tr><td><a id="l1507"></a><a href="#l1507">1507</a><td><tr><td><a id="l1508"></a><a href="#l1508">1508</a><td>/**<tr><td><a id="l1509"></a><a href="#l1509">1509</a><td> * Extends a query data object with another query data or map like object. This<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td> * operates &#39;in-place&#39;, it does not create a new QueryData object.<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td> *<tr><td><a id="l1512"></a><a href="#l1512">1512</a><td> * @param {...(goog.Uri.QueryData|goog.structs.Map&lt;?, ?&gt;|Object)} var_args<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td> *     The object from which key value pairs will be copied.<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td> */<tr><td><a id="l1515"></a><a href="#l1515">1515</a><td>goog.Uri.QueryData.prototype.extend = function(var_args) {<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>  for (var i = 0; i &lt; arguments.length; i++) {<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td>    var data = arguments[i];<tr><td><a id="l1518"></a><a href="#l1518">1518</a><td>    goog.structs.forEach(data,<tr><td><a id="l1519"></a><a href="#l1519">1519</a><td>        /** @this {goog.Uri.QueryData} */<tr><td><a id="l1520"></a><a href="#l1520">1520</a><td>        function(value, key) {<tr><td><a id="l1521"></a><a href="#l1521">1521</a><td>          this.add(key, value);<tr><td><a id="l1522"></a><a href="#l1522">1522</a><td>        }, this);<tr><td><a id="l1523"></a><a href="#l1523">1523</a><td>  }<tr><td><a id="l1524"></a><a href="#l1524">1524</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/uri/utils.js.src.html b/docs/source/lib/goog/uri/utils.js.src.html
index 0313591..80dc8b1 100644
--- a/docs/source/lib/goog/uri/utils.js.src.html
+++ b/docs/source/lib/goog/uri/utils.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>utils.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/uri/utils.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Simple utilities for dealing with URI strings.<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> * This is intended to be a lightweight alternative to constructing goog.Uri<tr><td><a name="l19" href="#l19">19</a><td> * objects.  Whereas goog.Uri adds several kilobytes to the binary regardless<tr><td><a name="l20" href="#l20">20</a><td> * of how much of its functionality you use, this is designed to be a set of<tr><td><a name="l21" href="#l21">21</a><td> * mostly-independent utilities so that the compiler includes only what is<tr><td><a name="l22" href="#l22">22</a><td> * necessary for the task.  Estimated savings of porting is 5k pre-gzip and<tr><td><a name="l23" href="#l23">23</a><td> * 1.5k post-gzip.  To ensure the savings remain, future developers should<tr><td><a name="l24" href="#l24">24</a><td> * avoid adding new functionality to existing functions, but instead create<tr><td><a name="l25" href="#l25">25</a><td> * new ones and factor out shared code.<tr><td><a name="l26" href="#l26">26</a><td> *<tr><td><a name="l27" href="#l27">27</a><td> * Many of these utilities have limited functionality, tailored to common<tr><td><a name="l28" href="#l28">28</a><td> * cases.  The query parameter utilities assume that the parameter keys are<tr><td><a name="l29" href="#l29">29</a><td> * already encoded, since most keys are compile-time alphanumeric strings.  The<tr><td><a name="l30" href="#l30">30</a><td> * query parameter mutation utilities also do not tolerate fragment identifiers.<tr><td><a name="l31" href="#l31">31</a><td> *<tr><td><a name="l32" href="#l32">32</a><td> * By design, these functions can be slower than goog.Uri equivalents.<tr><td><a name="l33" href="#l33">33</a><td> * Repeated calls to some of functions may be quadratic in behavior for IE,<tr><td><a name="l34" href="#l34">34</a><td> * although the effect is somewhat limited given the 2kb limit.<tr><td><a name="l35" href="#l35">35</a><td> *<tr><td><a name="l36" href="#l36">36</a><td> * One advantage of the limited functionality here is that this approach is<tr><td><a name="l37" href="#l37">37</a><td> * less sensitive to differences in URI encodings than goog.Uri, since these<tr><td><a name="l38" href="#l38">38</a><td> * functions modify the strings in place, rather than decoding and<tr><td><a name="l39" href="#l39">39</a><td> * re-encoding.<tr><td><a name="l40" href="#l40">40</a><td> *<tr><td><a name="l41" href="#l41">41</a><td> * Uses features of RFC 3986 for parsing/formatting URIs:<tr><td><a name="l42" href="#l42">42</a><td> *   http://www.ietf.org/rfc/rfc3986.txt<tr><td><a name="l43" href="#l43">43</a><td> *<tr><td><a name="l44" href="#l44">44</a><td> * @author gboyer@google.com (Garrett Boyer) - The &quot;lightened&quot; design.<tr><td><a name="l45" href="#l45">45</a><td> * @author msamuel@google.com (Mike Samuel) - Domain knowledge and regexes.<tr><td><a name="l46" href="#l46">46</a><td> */<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td>goog.provide(&#39;goog.uri.utils&#39;);<tr><td><a name="l49" href="#l49">49</a><td>goog.provide(&#39;goog.uri.utils.ComponentIndex&#39;);<tr><td><a name="l50" href="#l50">50</a><td>goog.provide(&#39;goog.uri.utils.QueryArray&#39;);<tr><td><a name="l51" href="#l51">51</a><td>goog.provide(&#39;goog.uri.utils.QueryValue&#39;);<tr><td><a name="l52" href="#l52">52</a><td>goog.provide(&#39;goog.uri.utils.StandardQueryParam&#39;);<tr><td><a name="l53" href="#l53">53</a><td><tr><td><a name="l54" href="#l54">54</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a name="l55" href="#l55">55</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l56" href="#l56">56</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td>/**<tr><td><a name="l60" href="#l60">60</a><td> * Character codes inlined to avoid object allocations due to charCode.<tr><td><a name="l61" href="#l61">61</a><td> * @enum {number}<tr><td><a name="l62" href="#l62">62</a><td> * @private<tr><td><a name="l63" href="#l63">63</a><td> */<tr><td><a name="l64" href="#l64">64</a><td>goog.uri.utils.CharCode_ = {<tr><td><a name="l65" href="#l65">65</a><td>  AMPERSAND: 38,<tr><td><a name="l66" href="#l66">66</a><td>  EQUAL: 61,<tr><td><a name="l67" href="#l67">67</a><td>  HASH: 35,<tr><td><a name="l68" href="#l68">68</a><td>  QUESTION: 63<tr><td><a name="l69" href="#l69">69</a><td>};<tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td>/**<tr><td><a name="l73" href="#l73">73</a><td> * Builds a URI string from already-encoded parts.<tr><td><a name="l74" href="#l74">74</a><td> *<tr><td><a name="l75" href="#l75">75</a><td> * No encoding is performed.  Any component may be omitted as either null or<tr><td><a name="l76" href="#l76">76</a><td> * undefined.<tr><td><a name="l77" href="#l77">77</a><td> *<tr><td><a name="l78" href="#l78">78</a><td> * @param {?string=} opt_scheme The scheme such as &#39;http&#39;.<tr><td><a name="l79" href="#l79">79</a><td> * @param {?string=} opt_userInfo The user name before the &#39;@&#39;.<tr><td><a name="l80" href="#l80">80</a><td> * @param {?string=} opt_domain The domain such as &#39;www.google.com&#39;, already<tr><td><a name="l81" href="#l81">81</a><td> *     URI-encoded.<tr><td><a name="l82" href="#l82">82</a><td> * @param {(string|number|null)=} opt_port The port number.<tr><td><a name="l83" href="#l83">83</a><td> * @param {?string=} opt_path The path, already URI-encoded.  If it is not<tr><td><a name="l84" href="#l84">84</a><td> *     empty, it must begin with a slash.<tr><td><a name="l85" href="#l85">85</a><td> * @param {?string=} opt_queryData The URI-encoded query data.<tr><td><a name="l86" href="#l86">86</a><td> * @param {?string=} opt_fragment The URI-encoded fragment identifier.<tr><td><a name="l87" href="#l87">87</a><td> * @return {string} The fully combined URI.<tr><td><a name="l88" href="#l88">88</a><td> */<tr><td><a name="l89" href="#l89">89</a><td>goog.uri.utils.buildFromEncodedParts = function(opt_scheme, opt_userInfo,<tr><td><a name="l90" href="#l90">90</a><td>    opt_domain, opt_port, opt_path, opt_queryData, opt_fragment) {<tr><td><a name="l91" href="#l91">91</a><td>  var out = &#39;&#39;;<tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>  if (opt_scheme) {<tr><td><a name="l94" href="#l94">94</a><td>    out += opt_scheme + &#39;:&#39;;<tr><td><a name="l95" href="#l95">95</a><td>  }<tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>  if (opt_domain) {<tr><td><a name="l98" href="#l98">98</a><td>    out += &#39;//&#39;;<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td>    if (opt_userInfo) {<tr><td><a name="l101" href="#l101">101</a><td>      out += opt_userInfo + &#39;@&#39;;<tr><td><a name="l102" href="#l102">102</a><td>    }<tr><td><a name="l103" href="#l103">103</a><td><tr><td><a name="l104" href="#l104">104</a><td>    out += opt_domain;<tr><td><a name="l105" href="#l105">105</a><td><tr><td><a name="l106" href="#l106">106</a><td>    if (opt_port) {<tr><td><a name="l107" href="#l107">107</a><td>      out += &#39;:&#39; + opt_port;<tr><td><a name="l108" href="#l108">108</a><td>    }<tr><td><a name="l109" href="#l109">109</a><td>  }<tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td>  if (opt_path) {<tr><td><a name="l112" href="#l112">112</a><td>    out += opt_path;<tr><td><a name="l113" href="#l113">113</a><td>  }<tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>  if (opt_queryData) {<tr><td><a name="l116" href="#l116">116</a><td>    out += &#39;?&#39; + opt_queryData;<tr><td><a name="l117" href="#l117">117</a><td>  }<tr><td><a name="l118" href="#l118">118</a><td><tr><td><a name="l119" href="#l119">119</a><td>  if (opt_fragment) {<tr><td><a name="l120" href="#l120">120</a><td>    out += &#39;#&#39; + opt_fragment;<tr><td><a name="l121" href="#l121">121</a><td>  }<tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td>  return out;<tr><td><a name="l124" href="#l124">124</a><td>};<tr><td><a name="l125" href="#l125">125</a><td><tr><td><a name="l126" href="#l126">126</a><td><tr><td><a name="l127" href="#l127">127</a><td>/**<tr><td><a name="l128" href="#l128">128</a><td> * A regular expression for breaking a URI into its component parts.<tr><td><a name="l129" href="#l129">129</a><td> *<tr><td><a name="l130" href="#l130">130</a><td> * {@link http://www.ietf.org/rfc/rfc3986.txt} says in Appendix B<tr><td><a name="l131" href="#l131">131</a><td> * As the &quot;first-match-wins&quot; algorithm is identical to the &quot;greedy&quot;<tr><td><a name="l132" href="#l132">132</a><td> * disambiguation method used by POSIX regular expressions, it is natural and<tr><td><a name="l133" href="#l133">133</a><td> * commonplace to use a regular expression for parsing the potential five<tr><td><a name="l134" href="#l134">134</a><td> * components of a URI reference.<tr><td><a name="l135" href="#l135">135</a><td> *<tr><td><a name="l136" href="#l136">136</a><td> * The following line is the regular expression for breaking-down a<tr><td><a name="l137" href="#l137">137</a><td> * well-formed URI reference into its components.<tr><td><a name="l138" href="#l138">138</a><td> *<tr><td><a name="l139" href="#l139">139</a><td> * &lt;pre&gt;<tr><td><a name="l140" href="#l140">140</a><td> * ^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?<tr><td><a name="l141" href="#l141">141</a><td> *  12            3  4          5       6  7        8 9<tr><td><a name="l142" href="#l142">142</a><td> * &lt;/pre&gt;<tr><td><a name="l143" href="#l143">143</a><td> *<tr><td><a name="l144" href="#l144">144</a><td> * The numbers in the second line above are only to assist readability; they<tr><td><a name="l145" href="#l145">145</a><td> * indicate the reference points for each subexpression (i.e., each paired<tr><td><a name="l146" href="#l146">146</a><td> * parenthesis). We refer to the value matched for subexpression &lt;n&gt; as $&lt;n&gt;.<tr><td><a name="l147" href="#l147">147</a><td> * For example, matching the above expression to<tr><td><a name="l148" href="#l148">148</a><td> * &lt;pre&gt;<tr><td><a name="l149" href="#l149">149</a><td> *     http://www.ics.uci.edu/pub/ietf/uri/#Related<tr><td><a name="l150" href="#l150">150</a><td> * &lt;/pre&gt;<tr><td><a name="l151" href="#l151">151</a><td> * results in the following subexpression matches:<tr><td><a name="l152" href="#l152">152</a><td> * &lt;pre&gt;<tr><td><a name="l153" href="#l153">153</a><td> *    $1 = http:<tr><td><a name="l154" href="#l154">154</a><td> *    $2 = http<tr><td><a name="l155" href="#l155">155</a><td> *    $3 = //www.ics.uci.edu<tr><td><a name="l156" href="#l156">156</a><td> *    $4 = www.ics.uci.edu<tr><td><a name="l157" href="#l157">157</a><td> *    $5 = /pub/ietf/uri/<tr><td><a name="l158" href="#l158">158</a><td> *    $6 = &lt;undefined&gt;<tr><td><a name="l159" href="#l159">159</a><td> *    $7 = &lt;undefined&gt;<tr><td><a name="l160" href="#l160">160</a><td> *    $8 = #Related<tr><td><a name="l161" href="#l161">161</a><td> *    $9 = Related<tr><td><a name="l162" href="#l162">162</a><td> * &lt;/pre&gt;<tr><td><a name="l163" href="#l163">163</a><td> * where &lt;undefined&gt; indicates that the component is not present, as is the<tr><td><a name="l164" href="#l164">164</a><td> * case for the query component in the above example. Therefore, we can<tr><td><a name="l165" href="#l165">165</a><td> * determine the value of the five components as<tr><td><a name="l166" href="#l166">166</a><td> * &lt;pre&gt;<tr><td><a name="l167" href="#l167">167</a><td> *    scheme    = $2<tr><td><a name="l168" href="#l168">168</a><td> *    authority = $4<tr><td><a name="l169" href="#l169">169</a><td> *    path      = $5<tr><td><a name="l170" href="#l170">170</a><td> *    query     = $7<tr><td><a name="l171" href="#l171">171</a><td> *    fragment  = $9<tr><td><a name="l172" href="#l172">172</a><td> * &lt;/pre&gt;<tr><td><a name="l173" href="#l173">173</a><td> *<tr><td><a name="l174" href="#l174">174</a><td> * The regular expression has been modified slightly to expose the<tr><td><a name="l175" href="#l175">175</a><td> * userInfo, domain, and port separately from the authority.<tr><td><a name="l176" href="#l176">176</a><td> * The modified version yields<tr><td><a name="l177" href="#l177">177</a><td> * &lt;pre&gt;<tr><td><a name="l178" href="#l178">178</a><td> *    $1 = http              scheme<tr><td><a name="l179" href="#l179">179</a><td> *    $2 = &lt;undefined&gt;       userInfo -\<tr><td><a name="l180" href="#l180">180</a><td> *    $3 = www.ics.uci.edu   domain     | authority<tr><td><a name="l181" href="#l181">181</a><td> *    $4 = &lt;undefined&gt;       port     -/<tr><td><a name="l182" href="#l182">182</a><td> *    $5 = /pub/ietf/uri/    path<tr><td><a name="l183" href="#l183">183</a><td> *    $6 = &lt;undefined&gt;       query without ?<tr><td><a name="l184" href="#l184">184</a><td> *    $7 = Related           fragment without #<tr><td><a name="l185" href="#l185">185</a><td> * &lt;/pre&gt;<tr><td><a name="l186" href="#l186">186</a><td> * @type {!RegExp}<tr><td><a name="l187" href="#l187">187</a><td> * @private<tr><td><a name="l188" href="#l188">188</a><td> */<tr><td><a name="l189" href="#l189">189</a><td>goog.uri.utils.splitRe_ = new RegExp(<tr><td><a name="l190" href="#l190">190</a><td>    &#39;^&#39; +<tr><td><a name="l191" href="#l191">191</a><td>    &#39;(?:&#39; +<tr><td><a name="l192" href="#l192">192</a><td>      &#39;([^:/?#.]+)&#39; +                     // scheme - ignore special characters<tr><td><a name="l193" href="#l193">193</a><td>                                          // used by other URL parts such as :,<tr><td><a name="l194" href="#l194">194</a><td>                                          // ?, /, #, and .<tr><td><a name="l195" href="#l195">195</a><td>    &#39;:)?&#39; +<tr><td><a name="l196" href="#l196">196</a><td>    &#39;(?://&#39; +<tr><td><a name="l197" href="#l197">197</a><td>      &#39;(?:([^/?#]*)@)?&#39; +                 // userInfo<tr><td><a name="l198" href="#l198">198</a><td>      &#39;([^/#?]*?)&#39; +                      // domain<tr><td><a name="l199" href="#l199">199</a><td>      &#39;(?::([0-9]+))?&#39; +                  // port<tr><td><a name="l200" href="#l200">200</a><td>      &#39;(?=[/#?]|$)&#39; +                     // authority-terminating character<tr><td><a name="l201" href="#l201">201</a><td>    &#39;)?&#39; +<tr><td><a name="l202" href="#l202">202</a><td>    &#39;([^?#]+)?&#39; +                         // path<tr><td><a name="l203" href="#l203">203</a><td>    &#39;(?:\\?([^#]*))?&#39; +                   // query<tr><td><a name="l204" href="#l204">204</a><td>    &#39;(?:#(.*))?&#39; +                        // fragment<tr><td><a name="l205" href="#l205">205</a><td>    &#39;$&#39;);<tr><td><a name="l206" href="#l206">206</a><td><tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td>/**<tr><td><a name="l209" href="#l209">209</a><td> * The index of each URI component in the return value of goog.uri.utils.split.<tr><td><a name="l210" href="#l210">210</a><td> * @enum {number}<tr><td><a name="l211" href="#l211">211</a><td> */<tr><td><a name="l212" href="#l212">212</a><td>goog.uri.utils.ComponentIndex = {<tr><td><a name="l213" href="#l213">213</a><td>  SCHEME: 1,<tr><td><a name="l214" href="#l214">214</a><td>  USER_INFO: 2,<tr><td><a name="l215" href="#l215">215</a><td>  DOMAIN: 3,<tr><td><a name="l216" href="#l216">216</a><td>  PORT: 4,<tr><td><a name="l217" href="#l217">217</a><td>  PATH: 5,<tr><td><a name="l218" href="#l218">218</a><td>  QUERY_DATA: 6,<tr><td><a name="l219" href="#l219">219</a><td>  FRAGMENT: 7<tr><td><a name="l220" href="#l220">220</a><td>};<tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td><tr><td><a name="l223" href="#l223">223</a><td>/**<tr><td><a name="l224" href="#l224">224</a><td> * Splits a URI into its component parts.<tr><td><a name="l225" href="#l225">225</a><td> *<tr><td><a name="l226" href="#l226">226</a><td> * Each component can be accessed via the component indices; for example:<tr><td><a name="l227" href="#l227">227</a><td> * &lt;pre&gt;<tr><td><a name="l228" href="#l228">228</a><td> * goog.uri.utils.split(someStr)[goog.uri.utils.CompontentIndex.QUERY_DATA];<tr><td><a name="l229" href="#l229">229</a><td> * &lt;/pre&gt;<tr><td><a name="l230" href="#l230">230</a><td> *<tr><td><a name="l231" href="#l231">231</a><td> * @param {string} uri The URI string to examine.<tr><td><a name="l232" href="#l232">232</a><td> * @return {!Array.&lt;string|undefined&gt;} Each component still URI-encoded.<tr><td><a name="l233" href="#l233">233</a><td> *     Each component that is present will contain the encoded value, whereas<tr><td><a name="l234" href="#l234">234</a><td> *     components that are not present will be undefined or empty, depending<tr><td><a name="l235" href="#l235">235</a><td> *     on the browser&#39;s regular expression implementation.  Never null, since<tr><td><a name="l236" href="#l236">236</a><td> *     arbitrary strings may still look like path names.<tr><td><a name="l237" href="#l237">237</a><td> */<tr><td><a name="l238" href="#l238">238</a><td>goog.uri.utils.split = function(uri) {<tr><td><a name="l239" href="#l239">239</a><td>  goog.uri.utils.phishingProtection_();<tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td>  // See @return comment -- never null.<tr><td><a name="l242" href="#l242">242</a><td>  return /** @type {!Array.&lt;string|undefined&gt;} */ (<tr><td><a name="l243" href="#l243">243</a><td>      uri.match(goog.uri.utils.splitRe_));<tr><td><a name="l244" href="#l244">244</a><td>};<tr><td><a name="l245" href="#l245">245</a><td><tr><td><a name="l246" href="#l246">246</a><td><tr><td><a name="l247" href="#l247">247</a><td>/**<tr><td><a name="l248" href="#l248">248</a><td> * Safari has a nasty bug where if you have an http URL with a username, e.g.,<tr><td><a name="l249" href="#l249">249</a><td> * http://evil.com%2F@google.com/<tr><td><a name="l250" href="#l250">250</a><td> * Safari will report that window.location.href is<tr><td><a name="l251" href="#l251">251</a><td> * http://evil.com/google.com/<tr><td><a name="l252" href="#l252">252</a><td> * so that anyone who tries to parse the domain of that URL will get<tr><td><a name="l253" href="#l253">253</a><td> * the wrong domain. We&#39;ve seen exploits where people use this to trick<tr><td><a name="l254" href="#l254">254</a><td> * Safari into loading resources from evil domains.<tr><td><a name="l255" href="#l255">255</a><td> *<tr><td><a name="l256" href="#l256">256</a><td> * To work around this, we run a little &quot;Safari phishing check&quot;, and throw<tr><td><a name="l257" href="#l257">257</a><td> * an exception if we see this happening.<tr><td><a name="l258" href="#l258">258</a><td> *<tr><td><a name="l259" href="#l259">259</a><td> * There is no convenient place to put this check. We apply it to<tr><td><a name="l260" href="#l260">260</a><td> * anyone doing URI parsing on Webkit. We&#39;re not happy about this, but<tr><td><a name="l261" href="#l261">261</a><td> * it fixes the problem.<tr><td><a name="l262" href="#l262">262</a><td> *<tr><td><a name="l263" href="#l263">263</a><td> * This should be removed once Safari fixes their bug.<tr><td><a name="l264" href="#l264">264</a><td> *<tr><td><a name="l265" href="#l265">265</a><td> * Exploit reported by Masato Kinugawa.<tr><td><a name="l266" href="#l266">266</a><td> *<tr><td><a name="l267" href="#l267">267</a><td> * @type {boolean}<tr><td><a name="l268" href="#l268">268</a><td> * @private<tr><td><a name="l269" href="#l269">269</a><td> */<tr><td><a name="l270" href="#l270">270</a><td>goog.uri.utils.needsPhishingProtection_ = goog.userAgent.WEBKIT;<tr><td><a name="l271" href="#l271">271</a><td><tr><td><a name="l272" href="#l272">272</a><td><tr><td><a name="l273" href="#l273">273</a><td>/**<tr><td><a name="l274" href="#l274">274</a><td> * Check to see if the user is being phished.<tr><td><a name="l275" href="#l275">275</a><td> * @private<tr><td><a name="l276" href="#l276">276</a><td> */<tr><td><a name="l277" href="#l277">277</a><td>goog.uri.utils.phishingProtection_ = function() {<tr><td><a name="l278" href="#l278">278</a><td>  if (goog.uri.utils.needsPhishingProtection_) {<tr><td><a name="l279" href="#l279">279</a><td>    // Turn protection off, so that we don&#39;t recurse.<tr><td><a name="l280" href="#l280">280</a><td>    goog.uri.utils.needsPhishingProtection_ = false;<tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td>    // Use quoted access, just in case the user isn&#39;t using location externs.<tr><td><a name="l283" href="#l283">283</a><td>    var location = goog.global[&#39;location&#39;];<tr><td><a name="l284" href="#l284">284</a><td>    if (location) {<tr><td><a name="l285" href="#l285">285</a><td>      var href = location[&#39;href&#39;];<tr><td><a name="l286" href="#l286">286</a><td>      if (href) {<tr><td><a name="l287" href="#l287">287</a><td>        var domain = goog.uri.utils.getDomain(href);<tr><td><a name="l288" href="#l288">288</a><td>        if (domain &amp;&amp; domain != location[&#39;hostname&#39;]) {<tr><td><a name="l289" href="#l289">289</a><td>          // Phishing attack<tr><td><a name="l290" href="#l290">290</a><td>          goog.uri.utils.needsPhishingProtection_ = true;<tr><td><a name="l291" href="#l291">291</a><td>          throw Error();<tr><td><a name="l292" href="#l292">292</a><td>        }<tr><td><a name="l293" href="#l293">293</a><td>      }<tr><td><a name="l294" href="#l294">294</a><td>    }<tr><td><a name="l295" href="#l295">295</a><td>  }<tr><td><a name="l296" href="#l296">296</a><td>};<tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td><tr><td><a name="l299" href="#l299">299</a><td>/**<tr><td><a name="l300" href="#l300">300</a><td> * @param {?string} uri A possibly null string.<tr><td><a name="l301" href="#l301">301</a><td> * @return {?string} The string URI-decoded, or null if uri is null.<tr><td><a name="l302" href="#l302">302</a><td> * @private<tr><td><a name="l303" href="#l303">303</a><td> */<tr><td><a name="l304" href="#l304">304</a><td>goog.uri.utils.decodeIfPossible_ = function(uri) {<tr><td><a name="l305" href="#l305">305</a><td>  return uri &amp;&amp; decodeURIComponent(uri);<tr><td><a name="l306" href="#l306">306</a><td>};<tr><td><a name="l307" href="#l307">307</a><td><tr><td><a name="l308" href="#l308">308</a><td><tr><td><a name="l309" href="#l309">309</a><td>/**<tr><td><a name="l310" href="#l310">310</a><td> * Gets a URI component by index.<tr><td><a name="l311" href="#l311">311</a><td> *<tr><td><a name="l312" href="#l312">312</a><td> * It is preferred to use the getPathEncoded() variety of functions ahead,<tr><td><a name="l313" href="#l313">313</a><td> * since they are more readable.<tr><td><a name="l314" href="#l314">314</a><td> *<tr><td><a name="l315" href="#l315">315</a><td> * @param {goog.uri.utils.ComponentIndex} componentIndex The component index.<tr><td><a name="l316" href="#l316">316</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l317" href="#l317">317</a><td> * @return {?string} The still-encoded component, or null if the component<tr><td><a name="l318" href="#l318">318</a><td> *     is not present.<tr><td><a name="l319" href="#l319">319</a><td> * @private<tr><td><a name="l320" href="#l320">320</a><td> */<tr><td><a name="l321" href="#l321">321</a><td>goog.uri.utils.getComponentByIndex_ = function(componentIndex, uri) {<tr><td><a name="l322" href="#l322">322</a><td>  // Convert undefined, null, and empty string into null.<tr><td><a name="l323" href="#l323">323</a><td>  return goog.uri.utils.split(uri)[componentIndex] || null;<tr><td><a name="l324" href="#l324">324</a><td>};<tr><td><a name="l325" href="#l325">325</a><td><tr><td><a name="l326" href="#l326">326</a><td><tr><td><a name="l327" href="#l327">327</a><td>/**<tr><td><a name="l328" href="#l328">328</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l329" href="#l329">329</a><td> * @return {?string} The protocol or scheme, or null if none.  Does not<tr><td><a name="l330" href="#l330">330</a><td> *     include trailing colons or slashes.<tr><td><a name="l331" href="#l331">331</a><td> */<tr><td><a name="l332" href="#l332">332</a><td>goog.uri.utils.getScheme = function(uri) {<tr><td><a name="l333" href="#l333">333</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a name="l334" href="#l334">334</a><td>      goog.uri.utils.ComponentIndex.SCHEME, uri);<tr><td><a name="l335" href="#l335">335</a><td>};<tr><td><a name="l336" href="#l336">336</a><td><tr><td><a name="l337" href="#l337">337</a><td><tr><td><a name="l338" href="#l338">338</a><td>/**<tr><td><a name="l339" href="#l339">339</a><td> * Gets the effective scheme for the URL.  If the URL is relative then the<tr><td><a name="l340" href="#l340">340</a><td> * scheme is derived from the page&#39;s location.<tr><td><a name="l341" href="#l341">341</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l342" href="#l342">342</a><td> * @return {string} The protocol or scheme, always lower case.<tr><td><a name="l343" href="#l343">343</a><td> */<tr><td><a name="l344" href="#l344">344</a><td>goog.uri.utils.getEffectiveScheme = function(uri) {<tr><td><a name="l345" href="#l345">345</a><td>  var scheme = goog.uri.utils.getScheme(uri);<tr><td><a name="l346" href="#l346">346</a><td>  if (!scheme &amp;&amp; self.location) {<tr><td><a name="l347" href="#l347">347</a><td>    var protocol = self.location.protocol;<tr><td><a name="l348" href="#l348">348</a><td>    scheme = protocol.substr(0, protocol.length - 1);<tr><td><a name="l349" href="#l349">349</a><td>  }<tr><td><a name="l350" href="#l350">350</a><td>  // NOTE: When called from a web worker in Firefox 3.5, location maybe null.<tr><td><a name="l351" href="#l351">351</a><td>  // All other browsers with web workers support self.location from the worker.<tr><td><a name="l352" href="#l352">352</a><td>  return scheme ? scheme.toLowerCase() : &#39;&#39;;<tr><td><a name="l353" href="#l353">353</a><td>};<tr><td><a name="l354" href="#l354">354</a><td><tr><td><a name="l355" href="#l355">355</a><td><tr><td><a name="l356" href="#l356">356</a><td>/**<tr><td><a name="l357" href="#l357">357</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l358" href="#l358">358</a><td> * @return {?string} The user name still encoded, or null if none.<tr><td><a name="l359" href="#l359">359</a><td> */<tr><td><a name="l360" href="#l360">360</a><td>goog.uri.utils.getUserInfoEncoded = function(uri) {<tr><td><a name="l361" href="#l361">361</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a name="l362" href="#l362">362</a><td>      goog.uri.utils.ComponentIndex.USER_INFO, uri);<tr><td><a name="l363" href="#l363">363</a><td>};<tr><td><a name="l364" href="#l364">364</a><td><tr><td><a name="l365" href="#l365">365</a><td><tr><td><a name="l366" href="#l366">366</a><td>/**<tr><td><a name="l367" href="#l367">367</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l368" href="#l368">368</a><td> * @return {?string} The decoded user info, or null if none.<tr><td><a name="l369" href="#l369">369</a><td> */<tr><td><a name="l370" href="#l370">370</a><td>goog.uri.utils.getUserInfo = function(uri) {<tr><td><a name="l371" href="#l371">371</a><td>  return goog.uri.utils.decodeIfPossible_(<tr><td><a name="l372" href="#l372">372</a><td>      goog.uri.utils.getUserInfoEncoded(uri));<tr><td><a name="l373" href="#l373">373</a><td>};<tr><td><a name="l374" href="#l374">374</a><td><tr><td><a name="l375" href="#l375">375</a><td><tr><td><a name="l376" href="#l376">376</a><td>/**<tr><td><a name="l377" href="#l377">377</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l378" href="#l378">378</a><td> * @return {?string} The domain name still encoded, or null if none.<tr><td><a name="l379" href="#l379">379</a><td> */<tr><td><a name="l380" href="#l380">380</a><td>goog.uri.utils.getDomainEncoded = function(uri) {<tr><td><a name="l381" href="#l381">381</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a name="l382" href="#l382">382</a><td>      goog.uri.utils.ComponentIndex.DOMAIN, uri);<tr><td><a name="l383" href="#l383">383</a><td>};<tr><td><a name="l384" href="#l384">384</a><td><tr><td><a name="l385" href="#l385">385</a><td><tr><td><a name="l386" href="#l386">386</a><td>/**<tr><td><a name="l387" href="#l387">387</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l388" href="#l388">388</a><td> * @return {?string} The decoded domain, or null if none.<tr><td><a name="l389" href="#l389">389</a><td> */<tr><td><a name="l390" href="#l390">390</a><td>goog.uri.utils.getDomain = function(uri) {<tr><td><a name="l391" href="#l391">391</a><td>  return goog.uri.utils.decodeIfPossible_(goog.uri.utils.getDomainEncoded(uri));<tr><td><a name="l392" href="#l392">392</a><td>};<tr><td><a name="l393" href="#l393">393</a><td><tr><td><a name="l394" href="#l394">394</a><td><tr><td><a name="l395" href="#l395">395</a><td>/**<tr><td><a name="l396" href="#l396">396</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l397" href="#l397">397</a><td> * @return {?number} The port number, or null if none.<tr><td><a name="l398" href="#l398">398</a><td> */<tr><td><a name="l399" href="#l399">399</a><td>goog.uri.utils.getPort = function(uri) {<tr><td><a name="l400" href="#l400">400</a><td>  // Coerce to a number.  If the result of getComponentByIndex_ is null or<tr><td><a name="l401" href="#l401">401</a><td>  // non-numeric, the number coersion yields NaN.  This will then return<tr><td><a name="l402" href="#l402">402</a><td>  // null for all non-numeric cases (though also zero, which isn&#39;t a relevant<tr><td><a name="l403" href="#l403">403</a><td>  // port number).<tr><td><a name="l404" href="#l404">404</a><td>  return Number(goog.uri.utils.getComponentByIndex_(<tr><td><a name="l405" href="#l405">405</a><td>      goog.uri.utils.ComponentIndex.PORT, uri)) || null;<tr><td><a name="l406" href="#l406">406</a><td>};<tr><td><a name="l407" href="#l407">407</a><td><tr><td><a name="l408" href="#l408">408</a><td><tr><td><a name="l409" href="#l409">409</a><td>/**<tr><td><a name="l410" href="#l410">410</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l411" href="#l411">411</a><td> * @return {?string} The path still encoded, or null if none. Includes the<tr><td><a name="l412" href="#l412">412</a><td> *     leading slash, if any.<tr><td><a name="l413" href="#l413">413</a><td> */<tr><td><a name="l414" href="#l414">414</a><td>goog.uri.utils.getPathEncoded = function(uri) {<tr><td><a name="l415" href="#l415">415</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a name="l416" href="#l416">416</a><td>      goog.uri.utils.ComponentIndex.PATH, uri);<tr><td><a name="l417" href="#l417">417</a><td>};<tr><td><a name="l418" href="#l418">418</a><td><tr><td><a name="l419" href="#l419">419</a><td><tr><td><a name="l420" href="#l420">420</a><td>/**<tr><td><a name="l421" href="#l421">421</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l422" href="#l422">422</a><td> * @return {?string} The decoded path, or null if none.  Includes the leading<tr><td><a name="l423" href="#l423">423</a><td> *     slash, if any.<tr><td><a name="l424" href="#l424">424</a><td> */<tr><td><a name="l425" href="#l425">425</a><td>goog.uri.utils.getPath = function(uri) {<tr><td><a name="l426" href="#l426">426</a><td>  return goog.uri.utils.decodeIfPossible_(goog.uri.utils.getPathEncoded(uri));<tr><td><a name="l427" href="#l427">427</a><td>};<tr><td><a name="l428" href="#l428">428</a><td><tr><td><a name="l429" href="#l429">429</a><td><tr><td><a name="l430" href="#l430">430</a><td>/**<tr><td><a name="l431" href="#l431">431</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l432" href="#l432">432</a><td> * @return {?string} The query data still encoded, or null if none.  Does not<tr><td><a name="l433" href="#l433">433</a><td> *     include the question mark itself.<tr><td><a name="l434" href="#l434">434</a><td> */<tr><td><a name="l435" href="#l435">435</a><td>goog.uri.utils.getQueryData = function(uri) {<tr><td><a name="l436" href="#l436">436</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a name="l437" href="#l437">437</a><td>      goog.uri.utils.ComponentIndex.QUERY_DATA, uri);<tr><td><a name="l438" href="#l438">438</a><td>};<tr><td><a name="l439" href="#l439">439</a><td><tr><td><a name="l440" href="#l440">440</a><td><tr><td><a name="l441" href="#l441">441</a><td>/**<tr><td><a name="l442" href="#l442">442</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l443" href="#l443">443</a><td> * @return {?string} The fragment identifier, or null if none.  Does not<tr><td><a name="l444" href="#l444">444</a><td> *     include the hash mark itself.<tr><td><a name="l445" href="#l445">445</a><td> */<tr><td><a name="l446" href="#l446">446</a><td>goog.uri.utils.getFragmentEncoded = function(uri) {<tr><td><a name="l447" href="#l447">447</a><td>  // The hash mark may not appear in any other part of the URL.<tr><td><a name="l448" href="#l448">448</a><td>  var hashIndex = uri.indexOf(&#39;#&#39;);<tr><td><a name="l449" href="#l449">449</a><td>  return hashIndex &lt; 0 ? null : uri.substr(hashIndex + 1);<tr><td><a name="l450" href="#l450">450</a><td>};<tr><td><a name="l451" href="#l451">451</a><td><tr><td><a name="l452" href="#l452">452</a><td><tr><td><a name="l453" href="#l453">453</a><td>/**<tr><td><a name="l454" href="#l454">454</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l455" href="#l455">455</a><td> * @param {?string} fragment The encoded fragment identifier, or null if none.<tr><td><a name="l456" href="#l456">456</a><td> *     Does not include the hash mark itself.<tr><td><a name="l457" href="#l457">457</a><td> * @return {string} The URI with the fragment set.<tr><td><a name="l458" href="#l458">458</a><td> */<tr><td><a name="l459" href="#l459">459</a><td>goog.uri.utils.setFragmentEncoded = function(uri, fragment) {<tr><td><a name="l460" href="#l460">460</a><td>  return goog.uri.utils.removeFragment(uri) + (fragment ? &#39;#&#39; + fragment : &#39;&#39;);<tr><td><a name="l461" href="#l461">461</a><td>};<tr><td><a name="l462" href="#l462">462</a><td><tr><td><a name="l463" href="#l463">463</a><td><tr><td><a name="l464" href="#l464">464</a><td>/**<tr><td><a name="l465" href="#l465">465</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l466" href="#l466">466</a><td> * @return {?string} The decoded fragment identifier, or null if none.  Does<tr><td><a name="l467" href="#l467">467</a><td> *     not include the hash mark.<tr><td><a name="l468" href="#l468">468</a><td> */<tr><td><a name="l469" href="#l469">469</a><td>goog.uri.utils.getFragment = function(uri) {<tr><td><a name="l470" href="#l470">470</a><td>  return goog.uri.utils.decodeIfPossible_(<tr><td><a name="l471" href="#l471">471</a><td>      goog.uri.utils.getFragmentEncoded(uri));<tr><td><a name="l472" href="#l472">472</a><td>};<tr><td><a name="l473" href="#l473">473</a><td><tr><td><a name="l474" href="#l474">474</a><td><tr><td><a name="l475" href="#l475">475</a><td>/**<tr><td><a name="l476" href="#l476">476</a><td> * Extracts everything up to the port of the URI.<tr><td><a name="l477" href="#l477">477</a><td> * @param {string} uri The URI string.<tr><td><a name="l478" href="#l478">478</a><td> * @return {string} Everything up to and including the port.<tr><td><a name="l479" href="#l479">479</a><td> */<tr><td><a name="l480" href="#l480">480</a><td>goog.uri.utils.getHost = function(uri) {<tr><td><a name="l481" href="#l481">481</a><td>  var pieces = goog.uri.utils.split(uri);<tr><td><a name="l482" href="#l482">482</a><td>  return goog.uri.utils.buildFromEncodedParts(<tr><td><a name="l483" href="#l483">483</a><td>      pieces[goog.uri.utils.ComponentIndex.SCHEME],<tr><td><a name="l484" href="#l484">484</a><td>      pieces[goog.uri.utils.ComponentIndex.USER_INFO],<tr><td><a name="l485" href="#l485">485</a><td>      pieces[goog.uri.utils.ComponentIndex.DOMAIN],<tr><td><a name="l486" href="#l486">486</a><td>      pieces[goog.uri.utils.ComponentIndex.PORT]);<tr><td><a name="l487" href="#l487">487</a><td>};<tr><td><a name="l488" href="#l488">488</a><td><tr><td><a name="l489" href="#l489">489</a><td><tr><td><a name="l490" href="#l490">490</a><td>/**<tr><td><a name="l491" href="#l491">491</a><td> * Extracts the path of the URL and everything after.<tr><td><a name="l492" href="#l492">492</a><td> * @param {string} uri The URI string.<tr><td><a name="l493" href="#l493">493</a><td> * @return {string} The URI, starting at the path and including the query<tr><td><a name="l494" href="#l494">494</a><td> *     parameters and fragment identifier.<tr><td><a name="l495" href="#l495">495</a><td> */<tr><td><a name="l496" href="#l496">496</a><td>goog.uri.utils.getPathAndAfter = function(uri) {<tr><td><a name="l497" href="#l497">497</a><td>  var pieces = goog.uri.utils.split(uri);<tr><td><a name="l498" href="#l498">498</a><td>  return goog.uri.utils.buildFromEncodedParts(null, null, null, null,<tr><td><a name="l499" href="#l499">499</a><td>      pieces[goog.uri.utils.ComponentIndex.PATH],<tr><td><a name="l500" href="#l500">500</a><td>      pieces[goog.uri.utils.ComponentIndex.QUERY_DATA],<tr><td><a name="l501" href="#l501">501</a><td>      pieces[goog.uri.utils.ComponentIndex.FRAGMENT]);<tr><td><a name="l502" href="#l502">502</a><td>};<tr><td><a name="l503" href="#l503">503</a><td><tr><td><a name="l504" href="#l504">504</a><td><tr><td><a name="l505" href="#l505">505</a><td>/**<tr><td><a name="l506" href="#l506">506</a><td> * Gets the URI with the fragment identifier removed.<tr><td><a name="l507" href="#l507">507</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l508" href="#l508">508</a><td> * @return {string} Everything preceding the hash mark.<tr><td><a name="l509" href="#l509">509</a><td> */<tr><td><a name="l510" href="#l510">510</a><td>goog.uri.utils.removeFragment = function(uri) {<tr><td><a name="l511" href="#l511">511</a><td>  // The hash mark may not appear in any other part of the URL.<tr><td><a name="l512" href="#l512">512</a><td>  var hashIndex = uri.indexOf(&#39;#&#39;);<tr><td><a name="l513" href="#l513">513</a><td>  return hashIndex &lt; 0 ? uri : uri.substr(0, hashIndex);<tr><td><a name="l514" href="#l514">514</a><td>};<tr><td><a name="l515" href="#l515">515</a><td><tr><td><a name="l516" href="#l516">516</a><td><tr><td><a name="l517" href="#l517">517</a><td>/**<tr><td><a name="l518" href="#l518">518</a><td> * Ensures that two URI&#39;s have the exact same domain, scheme, and port.<tr><td><a name="l519" href="#l519">519</a><td> *<tr><td><a name="l520" href="#l520">520</a><td> * Unlike the version in goog.Uri, this checks protocol, and therefore is<tr><td><a name="l521" href="#l521">521</a><td> * suitable for checking against the browser&#39;s same-origin policy.<tr><td><a name="l522" href="#l522">522</a><td> *<tr><td><a name="l523" href="#l523">523</a><td> * @param {string} uri1 The first URI.<tr><td><a name="l524" href="#l524">524</a><td> * @param {string} uri2 The second URI.<tr><td><a name="l525" href="#l525">525</a><td> * @return {boolean} Whether they have the same domain and port.<tr><td><a name="l526" href="#l526">526</a><td> */<tr><td><a name="l527" href="#l527">527</a><td>goog.uri.utils.haveSameDomain = function(uri1, uri2) {<tr><td><a name="l528" href="#l528">528</a><td>  var pieces1 = goog.uri.utils.split(uri1);<tr><td><a name="l529" href="#l529">529</a><td>  var pieces2 = goog.uri.utils.split(uri2);<tr><td><a name="l530" href="#l530">530</a><td>  return pieces1[goog.uri.utils.ComponentIndex.DOMAIN] ==<tr><td><a name="l531" href="#l531">531</a><td>             pieces2[goog.uri.utils.ComponentIndex.DOMAIN] &amp;&amp;<tr><td><a name="l532" href="#l532">532</a><td>         pieces1[goog.uri.utils.ComponentIndex.SCHEME] ==<tr><td><a name="l533" href="#l533">533</a><td>             pieces2[goog.uri.utils.ComponentIndex.SCHEME] &amp;&amp;<tr><td><a name="l534" href="#l534">534</a><td>         pieces1[goog.uri.utils.ComponentIndex.PORT] ==<tr><td><a name="l535" href="#l535">535</a><td>             pieces2[goog.uri.utils.ComponentIndex.PORT];<tr><td><a name="l536" href="#l536">536</a><td>};<tr><td><a name="l537" href="#l537">537</a><td><tr><td><a name="l538" href="#l538">538</a><td><tr><td><a name="l539" href="#l539">539</a><td>/**<tr><td><a name="l540" href="#l540">540</a><td> * Asserts that there are no fragment or query identifiers, only in uncompiled<tr><td><a name="l541" href="#l541">541</a><td> * mode.<tr><td><a name="l542" href="#l542">542</a><td> * @param {string} uri The URI to examine.<tr><td><a name="l543" href="#l543">543</a><td> * @private<tr><td><a name="l544" href="#l544">544</a><td> */<tr><td><a name="l545" href="#l545">545</a><td>goog.uri.utils.assertNoFragmentsOrQueries_ = function(uri) {<tr><td><a name="l546" href="#l546">546</a><td>  // NOTE: would use goog.asserts here, but jscompiler doesn&#39;t know that<tr><td><a name="l547" href="#l547">547</a><td>  // indexOf has no side effects.<tr><td><a name="l548" href="#l548">548</a><td>  if (goog.DEBUG &amp;&amp; (uri.indexOf(&#39;#&#39;) &gt;= 0 || uri.indexOf(&#39;?&#39;) &gt;= 0)) {<tr><td><a name="l549" href="#l549">549</a><td>    throw Error(&#39;goog.uri.utils: Fragment or query identifiers are not &#39; +<tr><td><a name="l550" href="#l550">550</a><td>        &#39;supported: [&#39; + uri + &#39;]&#39;);<tr><td><a name="l551" href="#l551">551</a><td>  }<tr><td><a name="l552" href="#l552">552</a><td>};<tr><td><a name="l553" href="#l553">553</a><td><tr><td><a name="l554" href="#l554">554</a><td><tr><td><a name="l555" href="#l555">555</a><td>/**<tr><td><a name="l556" href="#l556">556</a><td> * Supported query parameter values by the parameter serializing utilities.<tr><td><a name="l557" href="#l557">557</a><td> *<tr><td><a name="l558" href="#l558">558</a><td> * If a value is null or undefined, the key-value pair is skipped, as an easy<tr><td><a name="l559" href="#l559">559</a><td> * way to omit parameters conditionally.  Non-array parameters are converted<tr><td><a name="l560" href="#l560">560</a><td> * to a string and URI encoded.  Array values are expanded into multiple<tr><td><a name="l561" href="#l561">561</a><td> * &amp;key=value pairs, with each element stringized and URI-encoded.<tr><td><a name="l562" href="#l562">562</a><td> *<tr><td><a name="l563" href="#l563">563</a><td> * @typedef {*}<tr><td><a name="l564" href="#l564">564</a><td> */<tr><td><a name="l565" href="#l565">565</a><td>goog.uri.utils.QueryValue;<tr><td><a name="l566" href="#l566">566</a><td><tr><td><a name="l567" href="#l567">567</a><td><tr><td><a name="l568" href="#l568">568</a><td>/**<tr><td><a name="l569" href="#l569">569</a><td> * An array representing a set of query parameters with alternating keys<tr><td><a name="l570" href="#l570">570</a><td> * and values.<tr><td><a name="l571" href="#l571">571</a><td> *<tr><td><a name="l572" href="#l572">572</a><td> * Keys are assumed to be URI encoded already and live at even indices.  See<tr><td><a name="l573" href="#l573">573</a><td> * goog.uri.utils.QueryValue for details on how parameter values are encoded.<tr><td><a name="l574" href="#l574">574</a><td> *<tr><td><a name="l575" href="#l575">575</a><td> * Example:<tr><td><a name="l576" href="#l576">576</a><td> * &lt;pre&gt;<tr><td><a name="l577" href="#l577">577</a><td> * var data = [<tr><td><a name="l578" href="#l578">578</a><td> *   // Simple param: ?name=BobBarker<tr><td><a name="l579" href="#l579">579</a><td> *   &#39;name&#39;, &#39;BobBarker&#39;,<tr><td><a name="l580" href="#l580">580</a><td> *   // Conditional param -- may be omitted entirely.<tr><td><a name="l581" href="#l581">581</a><td> *   &#39;specialDietaryNeeds&#39;, hasDietaryNeeds() ? getDietaryNeeds() : null,<tr><td><a name="l582" href="#l582">582</a><td> *   // Multi-valued param: &amp;house=LosAngeles&amp;house=NewYork&amp;house=null<tr><td><a name="l583" href="#l583">583</a><td> *   &#39;house&#39;, [&#39;LosAngeles&#39;, &#39;NewYork&#39;, null]<tr><td><a name="l584" href="#l584">584</a><td> * ];<tr><td><a name="l585" href="#l585">585</a><td> * &lt;/pre&gt;<tr><td><a name="l586" href="#l586">586</a><td> *<tr><td><a name="l587" href="#l587">587</a><td> * @typedef {!Array.&lt;string|goog.uri.utils.QueryValue&gt;}<tr><td><a name="l588" href="#l588">588</a><td> */<tr><td><a name="l589" href="#l589">589</a><td>goog.uri.utils.QueryArray;<tr><td><a name="l590" href="#l590">590</a><td><tr><td><a name="l591" href="#l591">591</a><td><tr><td><a name="l592" href="#l592">592</a><td>/**<tr><td><a name="l593" href="#l593">593</a><td> * Appends a URI and query data in a string buffer with special preconditions.<tr><td><a name="l594" href="#l594">594</a><td> *<tr><td><a name="l595" href="#l595">595</a><td> * Internal implementation utility, performing very few object allocations.<tr><td><a name="l596" href="#l596">596</a><td> *<tr><td><a name="l597" href="#l597">597</a><td> * @param {!Array.&lt;string|undefined&gt;} buffer A string buffer.  The first element<tr><td><a name="l598" href="#l598">598</a><td> *     must be the base URI, and may have a fragment identifier.  If the array<tr><td><a name="l599" href="#l599">599</a><td> *     contains more than one element, the second element must be an ampersand,<tr><td><a name="l600" href="#l600">600</a><td> *     and may be overwritten, depending on the base URI.  Undefined elements<tr><td><a name="l601" href="#l601">601</a><td> *     are treated as empty-string.<tr><td><a name="l602" href="#l602">602</a><td> * @return {string} The concatenated URI and query data.<tr><td><a name="l603" href="#l603">603</a><td> * @private<tr><td><a name="l604" href="#l604">604</a><td> */<tr><td><a name="l605" href="#l605">605</a><td>goog.uri.utils.appendQueryData_ = function(buffer) {<tr><td><a name="l606" href="#l606">606</a><td>  if (buffer[1]) {<tr><td><a name="l607" href="#l607">607</a><td>    // At least one query parameter was added.  We need to check the<tr><td><a name="l608" href="#l608">608</a><td>    // punctuation mark, which is currently an ampersand, and also make sure<tr><td><a name="l609" href="#l609">609</a><td>    // there aren&#39;t any interfering fragment identifiers.<tr><td><a name="l610" href="#l610">610</a><td>    var baseUri = /** @type {string} */ (buffer[0]);<tr><td><a name="l611" href="#l611">611</a><td>    var hashIndex = baseUri.indexOf(&#39;#&#39;);<tr><td><a name="l612" href="#l612">612</a><td>    if (hashIndex &gt;= 0) {<tr><td><a name="l613" href="#l613">613</a><td>      // Move the fragment off the base part of the URI into the end.<tr><td><a name="l614" href="#l614">614</a><td>      buffer.push(baseUri.substr(hashIndex));<tr><td><a name="l615" href="#l615">615</a><td>      buffer[0] = baseUri = baseUri.substr(0, hashIndex);<tr><td><a name="l616" href="#l616">616</a><td>    }<tr><td><a name="l617" href="#l617">617</a><td>    var questionIndex = baseUri.indexOf(&#39;?&#39;);<tr><td><a name="l618" href="#l618">618</a><td>    if (questionIndex &lt; 0) {<tr><td><a name="l619" href="#l619">619</a><td>      // No question mark, so we need a question mark instead of an ampersand.<tr><td><a name="l620" href="#l620">620</a><td>      buffer[1] = &#39;?&#39;;<tr><td><a name="l621" href="#l621">621</a><td>    } else if (questionIndex == baseUri.length - 1) {<tr><td><a name="l622" href="#l622">622</a><td>      // Question mark is the very last character of the existing URI, so don&#39;t<tr><td><a name="l623" href="#l623">623</a><td>      // append an additional delimiter.<tr><td><a name="l624" href="#l624">624</a><td>      buffer[1] = undefined;<tr><td><a name="l625" href="#l625">625</a><td>    }<tr><td><a name="l626" href="#l626">626</a><td>  }<tr><td><a name="l627" href="#l627">627</a><td><tr><td><a name="l628" href="#l628">628</a><td>  return buffer.join(&#39;&#39;);<tr><td><a name="l629" href="#l629">629</a><td>};<tr><td><a name="l630" href="#l630">630</a><td><tr><td><a name="l631" href="#l631">631</a><td><tr><td><a name="l632" href="#l632">632</a><td>/**<tr><td><a name="l633" href="#l633">633</a><td> * Appends key=value pairs to an array, supporting multi-valued objects.<tr><td><a name="l634" href="#l634">634</a><td> * @param {string} key The key prefix.<tr><td><a name="l635" href="#l635">635</a><td> * @param {goog.uri.utils.QueryValue} value The value to serialize.<tr><td><a name="l636" href="#l636">636</a><td> * @param {!Array.&lt;string&gt;} pairs The array to which the &#39;key=value&#39; strings<tr><td><a name="l637" href="#l637">637</a><td> *     should be appended.<tr><td><a name="l638" href="#l638">638</a><td> * @private<tr><td><a name="l639" href="#l639">639</a><td> */<tr><td><a name="l640" href="#l640">640</a><td>goog.uri.utils.appendKeyValuePairs_ = function(key, value, pairs) {<tr><td><a name="l641" href="#l641">641</a><td>  if (goog.isArray(value)) {<tr><td><a name="l642" href="#l642">642</a><td>    // Convince the compiler it&#39;s an array.<tr><td><a name="l643" href="#l643">643</a><td>    goog.asserts.assertArray(value);<tr><td><a name="l644" href="#l644">644</a><td>    for (var j = 0; j &lt; value.length; j++) {<tr><td><a name="l645" href="#l645">645</a><td>      // Convert to string explicitly, to short circuit the null and array<tr><td><a name="l646" href="#l646">646</a><td>      // logic in this function -- this ensures that null and undefined get<tr><td><a name="l647" href="#l647">647</a><td>      // written as literal &#39;null&#39; and &#39;undefined&#39;, and arrays don&#39;t get<tr><td><a name="l648" href="#l648">648</a><td>      // expanded out but instead encoded in the default way.<tr><td><a name="l649" href="#l649">649</a><td>      goog.uri.utils.appendKeyValuePairs_(key, String(value[j]), pairs);<tr><td><a name="l650" href="#l650">650</a><td>    }<tr><td><a name="l651" href="#l651">651</a><td>  } else if (value != null) {<tr><td><a name="l652" href="#l652">652</a><td>    // Skip a top-level null or undefined entirely.<tr><td><a name="l653" href="#l653">653</a><td>    pairs.push(&#39;&amp;&#39;, key,<tr><td><a name="l654" href="#l654">654</a><td>        // Check for empty string. Zero gets encoded into the url as literal<tr><td><a name="l655" href="#l655">655</a><td>        // strings.  For empty string, skip the equal sign, to be consistent<tr><td><a name="l656" href="#l656">656</a><td>        // with UriBuilder.java.<tr><td><a name="l657" href="#l657">657</a><td>        value === &#39;&#39; ? &#39;&#39; : &#39;=&#39;,<tr><td><a name="l658" href="#l658">658</a><td>        goog.string.urlEncode(value));<tr><td><a name="l659" href="#l659">659</a><td>  }<tr><td><a name="l660" href="#l660">660</a><td>};<tr><td><a name="l661" href="#l661">661</a><td><tr><td><a name="l662" href="#l662">662</a><td><tr><td><a name="l663" href="#l663">663</a><td>/**<tr><td><a name="l664" href="#l664">664</a><td> * Builds a buffer of query data from a sequence of alternating keys and values.<tr><td><a name="l665" href="#l665">665</a><td> *<tr><td><a name="l666" href="#l666">666</a><td> * @param {!Array.&lt;string|undefined&gt;} buffer A string buffer to append to.  The<tr><td><a name="l667" href="#l667">667</a><td> *     first element appended will be an &#39;&amp;&#39;, and may be replaced by the caller.<tr><td><a name="l668" href="#l668">668</a><td> * @param {goog.uri.utils.QueryArray|Arguments} keysAndValues An array with<tr><td><a name="l669" href="#l669">669</a><td> *     alternating keys and values -- see the typedef.<tr><td><a name="l670" href="#l670">670</a><td> * @param {number=} opt_startIndex A start offset into the arary, defaults to 0.<tr><td><a name="l671" href="#l671">671</a><td> * @return {!Array.&lt;string|undefined&gt;} The buffer argument.<tr><td><a name="l672" href="#l672">672</a><td> * @private<tr><td><a name="l673" href="#l673">673</a><td> */<tr><td><a name="l674" href="#l674">674</a><td>goog.uri.utils.buildQueryDataBuffer_ = function(<tr><td><a name="l675" href="#l675">675</a><td>    buffer, keysAndValues, opt_startIndex) {<tr><td><a name="l676" href="#l676">676</a><td>  goog.asserts.assert(Math.max(keysAndValues.length - (opt_startIndex || 0),<tr><td><a name="l677" href="#l677">677</a><td>      0) % 2 == 0, &#39;goog.uri.utils: Key/value lists must be even in length.&#39;);<tr><td><a name="l678" href="#l678">678</a><td><tr><td><a name="l679" href="#l679">679</a><td>  for (var i = opt_startIndex || 0; i &lt; keysAndValues.length; i += 2) {<tr><td><a name="l680" href="#l680">680</a><td>    goog.uri.utils.appendKeyValuePairs_(<tr><td><a name="l681" href="#l681">681</a><td>        keysAndValues[i], keysAndValues[i + 1], buffer);<tr><td><a name="l682" href="#l682">682</a><td>  }<tr><td><a name="l683" href="#l683">683</a><td><tr><td><a name="l684" href="#l684">684</a><td>  return buffer;<tr><td><a name="l685" href="#l685">685</a><td>};<tr><td><a name="l686" href="#l686">686</a><td><tr><td><a name="l687" href="#l687">687</a><td><tr><td><a name="l688" href="#l688">688</a><td>/**<tr><td><a name="l689" href="#l689">689</a><td> * Builds a query data string from a sequence of alternating keys and values.<tr><td><a name="l690" href="#l690">690</a><td> * Currently generates &quot;&amp;key&amp;&quot; for empty args.<tr><td><a name="l691" href="#l691">691</a><td> *<tr><td><a name="l692" href="#l692">692</a><td> * @param {goog.uri.utils.QueryArray} keysAndValues Alternating keys and<tr><td><a name="l693" href="#l693">693</a><td> *     values.  See the typedef.<tr><td><a name="l694" href="#l694">694</a><td> * @param {number=} opt_startIndex A start offset into the arary, defaults to 0.<tr><td><a name="l695" href="#l695">695</a><td> * @return {string} The encoded query string, in the for &#39;a=1&amp;b=2&#39;.<tr><td><a name="l696" href="#l696">696</a><td> */<tr><td><a name="l697" href="#l697">697</a><td>goog.uri.utils.buildQueryData = function(keysAndValues, opt_startIndex) {<tr><td><a name="l698" href="#l698">698</a><td>  var buffer = goog.uri.utils.buildQueryDataBuffer_(<tr><td><a name="l699" href="#l699">699</a><td>      [], keysAndValues, opt_startIndex);<tr><td><a name="l700" href="#l700">700</a><td>  buffer[0] = &#39;&#39;; // Remove the leading ampersand.<tr><td><a name="l701" href="#l701">701</a><td>  return buffer.join(&#39;&#39;);<tr><td><a name="l702" href="#l702">702</a><td>};<tr><td><a name="l703" href="#l703">703</a><td><tr><td><a name="l704" href="#l704">704</a><td><tr><td><a name="l705" href="#l705">705</a><td>/**<tr><td><a name="l706" href="#l706">706</a><td> * Builds a buffer of query data from a map.<tr><td><a name="l707" href="#l707">707</a><td> *<tr><td><a name="l708" href="#l708">708</a><td> * @param {!Array.&lt;string|undefined&gt;} buffer A string buffer to append to.  The<tr><td><a name="l709" href="#l709">709</a><td> *     first element appended will be an &#39;&amp;&#39;, and may be replaced by the caller.<tr><td><a name="l710" href="#l710">710</a><td> * @param {Object.&lt;goog.uri.utils.QueryValue&gt;} map An object where keys are<tr><td><a name="l711" href="#l711">711</a><td> *     URI-encoded parameter keys, and the values conform to the contract<tr><td><a name="l712" href="#l712">712</a><td> *     specified in the goog.uri.utils.QueryValue typedef.<tr><td><a name="l713" href="#l713">713</a><td> * @return {!Array.&lt;string|undefined&gt;} The buffer argument.<tr><td><a name="l714" href="#l714">714</a><td> * @private<tr><td><a name="l715" href="#l715">715</a><td> */<tr><td><a name="l716" href="#l716">716</a><td>goog.uri.utils.buildQueryDataBufferFromMap_ = function(buffer, map) {<tr><td><a name="l717" href="#l717">717</a><td>  for (var key in map) {<tr><td><a name="l718" href="#l718">718</a><td>    goog.uri.utils.appendKeyValuePairs_(key, map[key], buffer);<tr><td><a name="l719" href="#l719">719</a><td>  }<tr><td><a name="l720" href="#l720">720</a><td><tr><td><a name="l721" href="#l721">721</a><td>  return buffer;<tr><td><a name="l722" href="#l722">722</a><td>};<tr><td><a name="l723" href="#l723">723</a><td><tr><td><a name="l724" href="#l724">724</a><td><tr><td><a name="l725" href="#l725">725</a><td>/**<tr><td><a name="l726" href="#l726">726</a><td> * Builds a query data string from a map.<tr><td><a name="l727" href="#l727">727</a><td> * Currently generates &quot;&amp;key&amp;&quot; for empty args.<tr><td><a name="l728" href="#l728">728</a><td> *<tr><td><a name="l729" href="#l729">729</a><td> * @param {Object} map An object where keys are URI-encoded parameter keys,<tr><td><a name="l730" href="#l730">730</a><td> *     and the values are arbitrary types or arrays.  Keys with a null value<tr><td><a name="l731" href="#l731">731</a><td> *     are dropped.<tr><td><a name="l732" href="#l732">732</a><td> * @return {string} The encoded query string, in the for &#39;a=1&amp;b=2&#39;.<tr><td><a name="l733" href="#l733">733</a><td> */<tr><td><a name="l734" href="#l734">734</a><td>goog.uri.utils.buildQueryDataFromMap = function(map) {<tr><td><a name="l735" href="#l735">735</a><td>  var buffer = goog.uri.utils.buildQueryDataBufferFromMap_([], map);<tr><td><a name="l736" href="#l736">736</a><td>  buffer[0] = &#39;&#39;;<tr><td><a name="l737" href="#l737">737</a><td>  return buffer.join(&#39;&#39;);<tr><td><a name="l738" href="#l738">738</a><td>};<tr><td><a name="l739" href="#l739">739</a><td><tr><td><a name="l740" href="#l740">740</a><td><tr><td><a name="l741" href="#l741">741</a><td>/**<tr><td><a name="l742" href="#l742">742</a><td> * Appends URI parameters to an existing URI.<tr><td><a name="l743" href="#l743">743</a><td> *<tr><td><a name="l744" href="#l744">744</a><td> * The variable arguments may contain alternating keys and values.  Keys are<tr><td><a name="l745" href="#l745">745</a><td> * assumed to be already URI encoded.  The values should not be URI-encoded,<tr><td><a name="l746" href="#l746">746</a><td> * and will instead be encoded by this function.<tr><td><a name="l747" href="#l747">747</a><td> * &lt;pre&gt;<tr><td><a name="l748" href="#l748">748</a><td> * appendParams(&#39;http://www.foo.com?existing=true&#39;,<tr><td><a name="l749" href="#l749">749</a><td> *     &#39;key1&#39;, &#39;value1&#39;,<tr><td><a name="l750" href="#l750">750</a><td> *     &#39;key2&#39;, &#39;value?willBeEncoded&#39;,<tr><td><a name="l751" href="#l751">751</a><td> *     &#39;key3&#39;, [&#39;valueA&#39;, &#39;valueB&#39;, &#39;valueC&#39;],<tr><td><a name="l752" href="#l752">752</a><td> *     &#39;key4&#39;, null);<tr><td><a name="l753" href="#l753">753</a><td> * result: &#39;http://www.foo.com?existing=true&amp;&#39; +<tr><td><a name="l754" href="#l754">754</a><td> *     &#39;key1=value1&amp;&#39; +<tr><td><a name="l755" href="#l755">755</a><td> *     &#39;key2=value%3FwillBeEncoded&amp;&#39; +<tr><td><a name="l756" href="#l756">756</a><td> *     &#39;key3=valueA&amp;key3=valueB&amp;key3=valueC&#39;<tr><td><a name="l757" href="#l757">757</a><td> * &lt;/pre&gt;<tr><td><a name="l758" href="#l758">758</a><td> *<tr><td><a name="l759" href="#l759">759</a><td> * A single call to this function will not exhibit quadratic behavior in IE,<tr><td><a name="l760" href="#l760">760</a><td> * whereas multiple repeated calls may, although the effect is limited by<tr><td><a name="l761" href="#l761">761</a><td> * fact that URL&#39;s generally can&#39;t exceed 2kb.<tr><td><a name="l762" href="#l762">762</a><td> *<tr><td><a name="l763" href="#l763">763</a><td> * @param {string} uri The original URI, which may already have query data.<tr><td><a name="l764" href="#l764">764</a><td> * @param {...(goog.uri.utils.QueryArray|string|goog.uri.utils.QueryValue)} var_args<tr><td><a name="l765" href="#l765">765</a><td> *     An array or argument list conforming to goog.uri.utils.QueryArray.<tr><td><a name="l766" href="#l766">766</a><td> * @return {string} The URI with all query parameters added.<tr><td><a name="l767" href="#l767">767</a><td> */<tr><td><a name="l768" href="#l768">768</a><td>goog.uri.utils.appendParams = function(uri, var_args) {<tr><td><a name="l769" href="#l769">769</a><td>  return goog.uri.utils.appendQueryData_(<tr><td><a name="l770" href="#l770">770</a><td>      arguments.length == 2 ?<tr><td><a name="l771" href="#l771">771</a><td>      goog.uri.utils.buildQueryDataBuffer_([uri], arguments[1], 0) :<tr><td><a name="l772" href="#l772">772</a><td>      goog.uri.utils.buildQueryDataBuffer_([uri], arguments, 1));<tr><td><a name="l773" href="#l773">773</a><td>};<tr><td><a name="l774" href="#l774">774</a><td><tr><td><a name="l775" href="#l775">775</a><td><tr><td><a name="l776" href="#l776">776</a><td>/**<tr><td><a name="l777" href="#l777">777</a><td> * Appends query parameters from a map.<tr><td><a name="l778" href="#l778">778</a><td> *<tr><td><a name="l779" href="#l779">779</a><td> * @param {string} uri The original URI, which may already have query data.<tr><td><a name="l780" href="#l780">780</a><td> * @param {Object} map An object where keys are URI-encoded parameter keys,<tr><td><a name="l781" href="#l781">781</a><td> *     and the values are arbitrary types or arrays.  Keys with a null value<tr><td><a name="l782" href="#l782">782</a><td> *     are dropped.<tr><td><a name="l783" href="#l783">783</a><td> * @return {string} The new parameters.<tr><td><a name="l784" href="#l784">784</a><td> */<tr><td><a name="l785" href="#l785">785</a><td>goog.uri.utils.appendParamsFromMap = function(uri, map) {<tr><td><a name="l786" href="#l786">786</a><td>  return goog.uri.utils.appendQueryData_(<tr><td><a name="l787" href="#l787">787</a><td>      goog.uri.utils.buildQueryDataBufferFromMap_([uri], map));<tr><td><a name="l788" href="#l788">788</a><td>};<tr><td><a name="l789" href="#l789">789</a><td><tr><td><a name="l790" href="#l790">790</a><td><tr><td><a name="l791" href="#l791">791</a><td>/**<tr><td><a name="l792" href="#l792">792</a><td> * Appends a single URI parameter.<tr><td><a name="l793" href="#l793">793</a><td> *<tr><td><a name="l794" href="#l794">794</a><td> * Repeated calls to this can exhibit quadratic behavior in IE6 due to the<tr><td><a name="l795" href="#l795">795</a><td> * way string append works, though it should be limited given the 2kb limit.<tr><td><a name="l796" href="#l796">796</a><td> *<tr><td><a name="l797" href="#l797">797</a><td> * @param {string} uri The original URI, which may already have query data.<tr><td><a name="l798" href="#l798">798</a><td> * @param {string} key The key, which must already be URI encoded.<tr><td><a name="l799" href="#l799">799</a><td> * @param {*=} opt_value The value, which will be stringized and encoded<tr><td><a name="l800" href="#l800">800</a><td> *     (assumed not already to be encoded).  If omitted, undefined, or null, the<tr><td><a name="l801" href="#l801">801</a><td> *     key will be added as a valueless parameter.<tr><td><a name="l802" href="#l802">802</a><td> * @return {string} The URI with the query parameter added.<tr><td><a name="l803" href="#l803">803</a><td> */<tr><td><a name="l804" href="#l804">804</a><td>goog.uri.utils.appendParam = function(uri, key, opt_value) {<tr><td><a name="l805" href="#l805">805</a><td>  var paramArr = [uri, &#39;&amp;&#39;, key];<tr><td><a name="l806" href="#l806">806</a><td>  if (goog.isDefAndNotNull(opt_value)) {<tr><td><a name="l807" href="#l807">807</a><td>    paramArr.push(&#39;=&#39;, goog.string.urlEncode(opt_value));<tr><td><a name="l808" href="#l808">808</a><td>  }<tr><td><a name="l809" href="#l809">809</a><td>  return goog.uri.utils.appendQueryData_(paramArr);<tr><td><a name="l810" href="#l810">810</a><td>};<tr><td><a name="l811" href="#l811">811</a><td><tr><td><a name="l812" href="#l812">812</a><td><tr><td><a name="l813" href="#l813">813</a><td>/**<tr><td><a name="l814" href="#l814">814</a><td> * Finds the next instance of a query parameter with the specified name.<tr><td><a name="l815" href="#l815">815</a><td> *<tr><td><a name="l816" href="#l816">816</a><td> * Does not instantiate any objects.<tr><td><a name="l817" href="#l817">817</a><td> *<tr><td><a name="l818" href="#l818">818</a><td> * @param {string} uri The URI to search.  May contain a fragment identifier<tr><td><a name="l819" href="#l819">819</a><td> *     if opt_hashIndex is specified.<tr><td><a name="l820" href="#l820">820</a><td> * @param {number} startIndex The index to begin searching for the key at.  A<tr><td><a name="l821" href="#l821">821</a><td> *     match may be found even if this is one character after the ampersand.<tr><td><a name="l822" href="#l822">822</a><td> * @param {string} keyEncoded The URI-encoded key.<tr><td><a name="l823" href="#l823">823</a><td> * @param {number} hashOrEndIndex Index to stop looking at.  If a hash<tr><td><a name="l824" href="#l824">824</a><td> *     mark is present, it should be its index, otherwise it should be the<tr><td><a name="l825" href="#l825">825</a><td> *     length of the string.<tr><td><a name="l826" href="#l826">826</a><td> * @return {number} The position of the first character in the key&#39;s name,<tr><td><a name="l827" href="#l827">827</a><td> *     immediately after either a question mark or a dot.<tr><td><a name="l828" href="#l828">828</a><td> * @private<tr><td><a name="l829" href="#l829">829</a><td> */<tr><td><a name="l830" href="#l830">830</a><td>goog.uri.utils.findParam_ = function(<tr><td><a name="l831" href="#l831">831</a><td>    uri, startIndex, keyEncoded, hashOrEndIndex) {<tr><td><a name="l832" href="#l832">832</a><td>  var index = startIndex;<tr><td><a name="l833" href="#l833">833</a><td>  var keyLength = keyEncoded.length;<tr><td><a name="l834" href="#l834">834</a><td><tr><td><a name="l835" href="#l835">835</a><td>  // Search for the key itself and post-filter for surronuding punctuation,<tr><td><a name="l836" href="#l836">836</a><td>  // rather than expensively building a regexp.<tr><td><a name="l837" href="#l837">837</a><td>  while ((index = uri.indexOf(keyEncoded, index)) &gt;= 0 &amp;&amp;<tr><td><a name="l838" href="#l838">838</a><td>      index &lt; hashOrEndIndex) {<tr><td><a name="l839" href="#l839">839</a><td>    var precedingChar = uri.charCodeAt(index - 1);<tr><td><a name="l840" href="#l840">840</a><td>    // Ensure that the preceding character is &#39;&amp;&#39; or &#39;?&#39;.<tr><td><a name="l841" href="#l841">841</a><td>    if (precedingChar == goog.uri.utils.CharCode_.AMPERSAND ||<tr><td><a name="l842" href="#l842">842</a><td>        precedingChar == goog.uri.utils.CharCode_.QUESTION) {<tr><td><a name="l843" href="#l843">843</a><td>      // Ensure the following character is &#39;&amp;&#39;, &#39;=&#39;, &#39;#&#39;, or NaN<tr><td><a name="l844" href="#l844">844</a><td>      // (end of string).<tr><td><a name="l845" href="#l845">845</a><td>      var followingChar = uri.charCodeAt(index + keyLength);<tr><td><a name="l846" href="#l846">846</a><td>      if (!followingChar ||<tr><td><a name="l847" href="#l847">847</a><td>          followingChar == goog.uri.utils.CharCode_.EQUAL ||<tr><td><a name="l848" href="#l848">848</a><td>          followingChar == goog.uri.utils.CharCode_.AMPERSAND ||<tr><td><a name="l849" href="#l849">849</a><td>          followingChar == goog.uri.utils.CharCode_.HASH) {<tr><td><a name="l850" href="#l850">850</a><td>        return index;<tr><td><a name="l851" href="#l851">851</a><td>      }<tr><td><a name="l852" href="#l852">852</a><td>    }<tr><td><a name="l853" href="#l853">853</a><td>    index += keyLength + 1;<tr><td><a name="l854" href="#l854">854</a><td>  }<tr><td><a name="l855" href="#l855">855</a><td><tr><td><a name="l856" href="#l856">856</a><td>  return -1;<tr><td><a name="l857" href="#l857">857</a><td>};<tr><td><a name="l858" href="#l858">858</a><td><tr><td><a name="l859" href="#l859">859</a><td><tr><td><a name="l860" href="#l860">860</a><td>/**<tr><td><a name="l861" href="#l861">861</a><td> * Regular expression for finding a hash mark or end of string.<tr><td><a name="l862" href="#l862">862</a><td> * @type {RegExp}<tr><td><a name="l863" href="#l863">863</a><td> * @private<tr><td><a name="l864" href="#l864">864</a><td> */<tr><td><a name="l865" href="#l865">865</a><td>goog.uri.utils.hashOrEndRe_ = /#|$/;<tr><td><a name="l866" href="#l866">866</a><td><tr><td><a name="l867" href="#l867">867</a><td><tr><td><a name="l868" href="#l868">868</a><td>/**<tr><td><a name="l869" href="#l869">869</a><td> * Determines if the URI contains a specific key.<tr><td><a name="l870" href="#l870">870</a><td> *<tr><td><a name="l871" href="#l871">871</a><td> * Performs no object instantiations.<tr><td><a name="l872" href="#l872">872</a><td> *<tr><td><a name="l873" href="#l873">873</a><td> * @param {string} uri The URI to process.  May contain a fragment<tr><td><a name="l874" href="#l874">874</a><td> *     identifier.<tr><td><a name="l875" href="#l875">875</a><td> * @param {string} keyEncoded The URI-encoded key.  Case-sensitive.<tr><td><a name="l876" href="#l876">876</a><td> * @return {boolean} Whether the key is present.<tr><td><a name="l877" href="#l877">877</a><td> */<tr><td><a name="l878" href="#l878">878</a><td>goog.uri.utils.hasParam = function(uri, keyEncoded) {<tr><td><a name="l879" href="#l879">879</a><td>  return goog.uri.utils.findParam_(uri, 0, keyEncoded,<tr><td><a name="l880" href="#l880">880</a><td>      uri.search(goog.uri.utils.hashOrEndRe_)) &gt;= 0;<tr><td><a name="l881" href="#l881">881</a><td>};<tr><td><a name="l882" href="#l882">882</a><td><tr><td><a name="l883" href="#l883">883</a><td><tr><td><a name="l884" href="#l884">884</a><td>/**<tr><td><a name="l885" href="#l885">885</a><td> * Gets the first value of a query parameter.<tr><td><a name="l886" href="#l886">886</a><td> * @param {string} uri The URI to process.  May contain a fragment.<tr><td><a name="l887" href="#l887">887</a><td> * @param {string} keyEncoded The URI-encoded key.  Case-sensitive.<tr><td><a name="l888" href="#l888">888</a><td> * @return {?string} The first value of the parameter (URI-decoded), or null<tr><td><a name="l889" href="#l889">889</a><td> *     if the parameter is not found.<tr><td><a name="l890" href="#l890">890</a><td> */<tr><td><a name="l891" href="#l891">891</a><td>goog.uri.utils.getParamValue = function(uri, keyEncoded) {<tr><td><a name="l892" href="#l892">892</a><td>  var hashOrEndIndex = uri.search(goog.uri.utils.hashOrEndRe_);<tr><td><a name="l893" href="#l893">893</a><td>  var foundIndex = goog.uri.utils.findParam_(<tr><td><a name="l894" href="#l894">894</a><td>      uri, 0, keyEncoded, hashOrEndIndex);<tr><td><a name="l895" href="#l895">895</a><td><tr><td><a name="l896" href="#l896">896</a><td>  if (foundIndex &lt; 0) {<tr><td><a name="l897" href="#l897">897</a><td>    return null;<tr><td><a name="l898" href="#l898">898</a><td>  } else {<tr><td><a name="l899" href="#l899">899</a><td>    var endPosition = uri.indexOf(&#39;&amp;&#39;, foundIndex);<tr><td><a name="l900" href="#l900">900</a><td>    if (endPosition &lt; 0 || endPosition &gt; hashOrEndIndex) {<tr><td><a name="l901" href="#l901">901</a><td>      endPosition = hashOrEndIndex;<tr><td><a name="l902" href="#l902">902</a><td>    }<tr><td><a name="l903" href="#l903">903</a><td>    // Progress forth to the end of the &quot;key=&quot; or &quot;key&amp;&quot; substring.<tr><td><a name="l904" href="#l904">904</a><td>    foundIndex += keyEncoded.length + 1;<tr><td><a name="l905" href="#l905">905</a><td>    // Use substr, because it (unlike substring) will return empty string<tr><td><a name="l906" href="#l906">906</a><td>    // if foundIndex &gt; endPosition.<tr><td><a name="l907" href="#l907">907</a><td>    return goog.string.urlDecode(<tr><td><a name="l908" href="#l908">908</a><td>        uri.substr(foundIndex, endPosition - foundIndex));<tr><td><a name="l909" href="#l909">909</a><td>  }<tr><td><a name="l910" href="#l910">910</a><td>};<tr><td><a name="l911" href="#l911">911</a><td><tr><td><a name="l912" href="#l912">912</a><td><tr><td><a name="l913" href="#l913">913</a><td>/**<tr><td><a name="l914" href="#l914">914</a><td> * Gets all values of a query parameter.<tr><td><a name="l915" href="#l915">915</a><td> * @param {string} uri The URI to process.  May contain a framgnet.<tr><td><a name="l916" href="#l916">916</a><td> * @param {string} keyEncoded The URI-encoded key.  Case-snsitive.<tr><td><a name="l917" href="#l917">917</a><td> * @return {!Array.&lt;string&gt;} All URI-decoded values with the given key.<tr><td><a name="l918" href="#l918">918</a><td> *     If the key is not found, this will have length 0, but never be null.<tr><td><a name="l919" href="#l919">919</a><td> */<tr><td><a name="l920" href="#l920">920</a><td>goog.uri.utils.getParamValues = function(uri, keyEncoded) {<tr><td><a name="l921" href="#l921">921</a><td>  var hashOrEndIndex = uri.search(goog.uri.utils.hashOrEndRe_);<tr><td><a name="l922" href="#l922">922</a><td>  var position = 0;<tr><td><a name="l923" href="#l923">923</a><td>  var foundIndex;<tr><td><a name="l924" href="#l924">924</a><td>  var result = [];<tr><td><a name="l925" href="#l925">925</a><td><tr><td><a name="l926" href="#l926">926</a><td>  while ((foundIndex = goog.uri.utils.findParam_(<tr><td><a name="l927" href="#l927">927</a><td>      uri, position, keyEncoded, hashOrEndIndex)) &gt;= 0) {<tr><td><a name="l928" href="#l928">928</a><td>    // Find where this parameter ends, either the &#39;&amp;&#39; or the end of the<tr><td><a name="l929" href="#l929">929</a><td>    // query parameters.<tr><td><a name="l930" href="#l930">930</a><td>    position = uri.indexOf(&#39;&amp;&#39;, foundIndex);<tr><td><a name="l931" href="#l931">931</a><td>    if (position &lt; 0 || position &gt; hashOrEndIndex) {<tr><td><a name="l932" href="#l932">932</a><td>      position = hashOrEndIndex;<tr><td><a name="l933" href="#l933">933</a><td>    }<tr><td><a name="l934" href="#l934">934</a><td><tr><td><a name="l935" href="#l935">935</a><td>    // Progress forth to the end of the &quot;key=&quot; or &quot;key&amp;&quot; substring.<tr><td><a name="l936" href="#l936">936</a><td>    foundIndex += keyEncoded.length + 1;<tr><td><a name="l937" href="#l937">937</a><td>    // Use substr, because it (unlike substring) will return empty string<tr><td><a name="l938" href="#l938">938</a><td>    // if foundIndex &gt; position.<tr><td><a name="l939" href="#l939">939</a><td>    result.push(goog.string.urlDecode(uri.substr(<tr><td><a name="l940" href="#l940">940</a><td>        foundIndex, position - foundIndex)));<tr><td><a name="l941" href="#l941">941</a><td>  }<tr><td><a name="l942" href="#l942">942</a><td><tr><td><a name="l943" href="#l943">943</a><td>  return result;<tr><td><a name="l944" href="#l944">944</a><td>};<tr><td><a name="l945" href="#l945">945</a><td><tr><td><a name="l946" href="#l946">946</a><td><tr><td><a name="l947" href="#l947">947</a><td>/**<tr><td><a name="l948" href="#l948">948</a><td> * Regexp to find trailing question marks and ampersands.<tr><td><a name="l949" href="#l949">949</a><td> * @type {RegExp}<tr><td><a name="l950" href="#l950">950</a><td> * @private<tr><td><a name="l951" href="#l951">951</a><td> */<tr><td><a name="l952" href="#l952">952</a><td>goog.uri.utils.trailingQueryPunctuationRe_ = /[?&amp;]($|#)/;<tr><td><a name="l953" href="#l953">953</a><td><tr><td><a name="l954" href="#l954">954</a><td><tr><td><a name="l955" href="#l955">955</a><td>/**<tr><td><a name="l956" href="#l956">956</a><td> * Removes all instances of a query parameter.<tr><td><a name="l957" href="#l957">957</a><td> * @param {string} uri The URI to process.  Must not contain a fragment.<tr><td><a name="l958" href="#l958">958</a><td> * @param {string} keyEncoded The URI-encoded key.<tr><td><a name="l959" href="#l959">959</a><td> * @return {string} The URI with all instances of the parameter removed.<tr><td><a name="l960" href="#l960">960</a><td> */<tr><td><a name="l961" href="#l961">961</a><td>goog.uri.utils.removeParam = function(uri, keyEncoded) {<tr><td><a name="l962" href="#l962">962</a><td>  var hashOrEndIndex = uri.search(goog.uri.utils.hashOrEndRe_);<tr><td><a name="l963" href="#l963">963</a><td>  var position = 0;<tr><td><a name="l964" href="#l964">964</a><td>  var foundIndex;<tr><td><a name="l965" href="#l965">965</a><td>  var buffer = [];<tr><td><a name="l966" href="#l966">966</a><td><tr><td><a name="l967" href="#l967">967</a><td>  // Look for a query parameter.<tr><td><a name="l968" href="#l968">968</a><td>  while ((foundIndex = goog.uri.utils.findParam_(<tr><td><a name="l969" href="#l969">969</a><td>      uri, position, keyEncoded, hashOrEndIndex)) &gt;= 0) {<tr><td><a name="l970" href="#l970">970</a><td>    // Get the portion of the query string up to, but not including, the ?<tr><td><a name="l971" href="#l971">971</a><td>    // or &amp; starting the parameter.<tr><td><a name="l972" href="#l972">972</a><td>    buffer.push(uri.substring(position, foundIndex));<tr><td><a name="l973" href="#l973">973</a><td>    // Progress to immediately after the &#39;&amp;&#39;.  If not found, go to the end.<tr><td><a name="l974" href="#l974">974</a><td>    // Avoid including the hash mark.<tr><td><a name="l975" href="#l975">975</a><td>    position = Math.min((uri.indexOf(&#39;&amp;&#39;, foundIndex) + 1) || hashOrEndIndex,<tr><td><a name="l976" href="#l976">976</a><td>        hashOrEndIndex);<tr><td><a name="l977" href="#l977">977</a><td>  }<tr><td><a name="l978" href="#l978">978</a><td><tr><td><a name="l979" href="#l979">979</a><td>  // Append everything that is remaining.<tr><td><a name="l980" href="#l980">980</a><td>  buffer.push(uri.substr(position));<tr><td><a name="l981" href="#l981">981</a><td><tr><td><a name="l982" href="#l982">982</a><td>  // Join the buffer, and remove trailing punctuation that remains.<tr><td><a name="l983" href="#l983">983</a><td>  return buffer.join(&#39;&#39;).replace(<tr><td><a name="l984" href="#l984">984</a><td>      goog.uri.utils.trailingQueryPunctuationRe_, &#39;$1&#39;);<tr><td><a name="l985" href="#l985">985</a><td>};<tr><td><a name="l986" href="#l986">986</a><td><tr><td><a name="l987" href="#l987">987</a><td><tr><td><a name="l988" href="#l988">988</a><td>/**<tr><td><a name="l989" href="#l989">989</a><td> * Replaces all existing definitions of a parameter with a single definition.<tr><td><a name="l990" href="#l990">990</a><td> *<tr><td><a name="l991" href="#l991">991</a><td> * Repeated calls to this can exhibit quadratic behavior due to the need to<tr><td><a name="l992" href="#l992">992</a><td> * find existing instances and reconstruct the string, though it should be<tr><td><a name="l993" href="#l993">993</a><td> * limited given the 2kb limit.  Consider using appendParams to append multiple<tr><td><a name="l994" href="#l994">994</a><td> * parameters in bulk.<tr><td><a name="l995" href="#l995">995</a><td> *<tr><td><a name="l996" href="#l996">996</a><td> * @param {string} uri The original URI, which may already have query data.<tr><td><a name="l997" href="#l997">997</a><td> * @param {string} keyEncoded The key, which must already be URI encoded.<tr><td><a name="l998" href="#l998">998</a><td> * @param {*} value The value, which will be stringized and encoded (assumed<tr><td><a name="l999" href="#l999">999</a><td> *     not already to be encoded).<tr><td><a name="l1000" href="#l1000">1000</a><td> * @return {string} The URI with the query parameter added.<tr><td><a name="l1001" href="#l1001">1001</a><td> */<tr><td><a name="l1002" href="#l1002">1002</a><td>goog.uri.utils.setParam = function(uri, keyEncoded, value) {<tr><td><a name="l1003" href="#l1003">1003</a><td>  return goog.uri.utils.appendParam(<tr><td><a name="l1004" href="#l1004">1004</a><td>      goog.uri.utils.removeParam(uri, keyEncoded), keyEncoded, value);<tr><td><a name="l1005" href="#l1005">1005</a><td>};<tr><td><a name="l1006" href="#l1006">1006</a><td><tr><td><a name="l1007" href="#l1007">1007</a><td><tr><td><a name="l1008" href="#l1008">1008</a><td>/**<tr><td><a name="l1009" href="#l1009">1009</a><td> * Generates a URI path using a given URI and a path with checks to<tr><td><a name="l1010" href="#l1010">1010</a><td> * prevent consecutive &quot;//&quot;. The baseUri passed in must not contain<tr><td><a name="l1011" href="#l1011">1011</a><td> * query or fragment identifiers. The path to append may not contain query or<tr><td><a name="l1012" href="#l1012">1012</a><td> * fragment identifiers.<tr><td><a name="l1013" href="#l1013">1013</a><td> *<tr><td><a name="l1014" href="#l1014">1014</a><td> * @param {string} baseUri URI to use as the base.<tr><td><a name="l1015" href="#l1015">1015</a><td> * @param {string} path Path to append.<tr><td><a name="l1016" href="#l1016">1016</a><td> * @return {string} Updated URI.<tr><td><a name="l1017" href="#l1017">1017</a><td> */<tr><td><a name="l1018" href="#l1018">1018</a><td>goog.uri.utils.appendPath = function(baseUri, path) {<tr><td><a name="l1019" href="#l1019">1019</a><td>  goog.uri.utils.assertNoFragmentsOrQueries_(baseUri);<tr><td><a name="l1020" href="#l1020">1020</a><td><tr><td><a name="l1021" href="#l1021">1021</a><td>  // Remove any trailing &#39;/&#39;<tr><td><a name="l1022" href="#l1022">1022</a><td>  if (goog.string.endsWith(baseUri, &#39;/&#39;)) {<tr><td><a name="l1023" href="#l1023">1023</a><td>    baseUri = baseUri.substr(0, baseUri.length - 1);<tr><td><a name="l1024" href="#l1024">1024</a><td>  }<tr><td><a name="l1025" href="#l1025">1025</a><td>  // Remove any leading &#39;/&#39;<tr><td><a name="l1026" href="#l1026">1026</a><td>  if (goog.string.startsWith(path, &#39;/&#39;)) {<tr><td><a name="l1027" href="#l1027">1027</a><td>    path = path.substr(1);<tr><td><a name="l1028" href="#l1028">1028</a><td>  }<tr><td><a name="l1029" href="#l1029">1029</a><td>  return goog.string.buildString(baseUri, &#39;/&#39;, path);<tr><td><a name="l1030" href="#l1030">1030</a><td>};<tr><td><a name="l1031" href="#l1031">1031</a><td><tr><td><a name="l1032" href="#l1032">1032</a><td><tr><td><a name="l1033" href="#l1033">1033</a><td>/**<tr><td><a name="l1034" href="#l1034">1034</a><td> * Standard supported query parameters.<tr><td><a name="l1035" href="#l1035">1035</a><td> * @enum {string}<tr><td><a name="l1036" href="#l1036">1036</a><td> */<tr><td><a name="l1037" href="#l1037">1037</a><td>goog.uri.utils.StandardQueryParam = {<tr><td><a name="l1038" href="#l1038">1038</a><td><tr><td><a name="l1039" href="#l1039">1039</a><td>  /** Unused parameter for unique-ifying. */<tr><td><a name="l1040" href="#l1040">1040</a><td>  RANDOM: &#39;zx&#39;<tr><td><a name="l1041" href="#l1041">1041</a><td>};<tr><td><a name="l1042" href="#l1042">1042</a><td><tr><td><a name="l1043" href="#l1043">1043</a><td><tr><td><a name="l1044" href="#l1044">1044</a><td>/**<tr><td><a name="l1045" href="#l1045">1045</a><td> * Sets the zx parameter of a URI to a random value.<tr><td><a name="l1046" href="#l1046">1046</a><td> * @param {string} uri Any URI.<tr><td><a name="l1047" href="#l1047">1047</a><td> * @return {string} That URI with the &quot;zx&quot; parameter added or replaced to<tr><td><a name="l1048" href="#l1048">1048</a><td> *     contain a random string.<tr><td><a name="l1049" href="#l1049">1049</a><td> */<tr><td><a name="l1050" href="#l1050">1050</a><td>goog.uri.utils.makeUnique = function(uri) {<tr><td><a name="l1051" href="#l1051">1051</a><td>  return goog.uri.utils.setParam(uri,<tr><td><a name="l1052" href="#l1052">1052</a><td>      goog.uri.utils.StandardQueryParam.RANDOM, goog.string.getRandomString());<tr><td><a name="l1053" href="#l1053">1053</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>utils.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/uri/utils.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Simple utilities for dealing with URI strings.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> * This is intended to be a lightweight alternative to constructing goog.Uri<tr><td><a id="l19"></a><a href="#l19">19</a><td> * objects.  Whereas goog.Uri adds several kilobytes to the binary regardless<tr><td><a id="l20"></a><a href="#l20">20</a><td> * of how much of its functionality you use, this is designed to be a set of<tr><td><a id="l21"></a><a href="#l21">21</a><td> * mostly-independent utilities so that the compiler includes only what is<tr><td><a id="l22"></a><a href="#l22">22</a><td> * necessary for the task.  Estimated savings of porting is 5k pre-gzip and<tr><td><a id="l23"></a><a href="#l23">23</a><td> * 1.5k post-gzip.  To ensure the savings remain, future developers should<tr><td><a id="l24"></a><a href="#l24">24</a><td> * avoid adding new functionality to existing functions, but instead create<tr><td><a id="l25"></a><a href="#l25">25</a><td> * new ones and factor out shared code.<tr><td><a id="l26"></a><a href="#l26">26</a><td> *<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Many of these utilities have limited functionality, tailored to common<tr><td><a id="l28"></a><a href="#l28">28</a><td> * cases.  The query parameter utilities assume that the parameter keys are<tr><td><a id="l29"></a><a href="#l29">29</a><td> * already encoded, since most keys are compile-time alphanumeric strings.  The<tr><td><a id="l30"></a><a href="#l30">30</a><td> * query parameter mutation utilities also do not tolerate fragment identifiers.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * By design, these functions can be slower than goog.Uri equivalents.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Repeated calls to some of functions may be quadratic in behavior for IE,<tr><td><a id="l34"></a><a href="#l34">34</a><td> * although the effect is somewhat limited given the 2kb limit.<tr><td><a id="l35"></a><a href="#l35">35</a><td> *<tr><td><a id="l36"></a><a href="#l36">36</a><td> * One advantage of the limited functionality here is that this approach is<tr><td><a id="l37"></a><a href="#l37">37</a><td> * less sensitive to differences in URI encodings than goog.Uri, since these<tr><td><a id="l38"></a><a href="#l38">38</a><td> * functions operate on strings directly, rather than decoding them and<tr><td><a id="l39"></a><a href="#l39">39</a><td> * then re-encoding.<tr><td><a id="l40"></a><a href="#l40">40</a><td> *<tr><td><a id="l41"></a><a href="#l41">41</a><td> * Uses features of RFC 3986 for parsing/formatting URIs:<tr><td><a id="l42"></a><a href="#l42">42</a><td> *   http://www.ietf.org/rfc/rfc3986.txt<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @author gboyer@google.com (Garrett Boyer) - The &quot;lightened&quot; design.<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>goog.provide(&#39;goog.uri.utils&#39;);<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.provide(&#39;goog.uri.utils.ComponentIndex&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.provide(&#39;goog.uri.utils.QueryArray&#39;);<tr><td><a id="l50"></a><a href="#l50">50</a><td>goog.provide(&#39;goog.uri.utils.QueryValue&#39;);<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.provide(&#39;goog.uri.utils.StandardQueryParam&#39;);<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l54"></a><a href="#l54">54</a><td>goog.require(&#39;goog.string&#39;);<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>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * Character codes inlined to avoid object allocations due to charCode.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @enum {number}<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @private<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.uri.utils.CharCode_ = {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  AMPERSAND: 38,<tr><td><a id="l64"></a><a href="#l64">64</a><td>  EQUAL: 61,<tr><td><a id="l65"></a><a href="#l65">65</a><td>  HASH: 35,<tr><td><a id="l66"></a><a href="#l66">66</a><td>  QUESTION: 63<tr><td><a id="l67"></a><a href="#l67">67</a><td>};<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>/**<tr><td><a id="l71"></a><a href="#l71">71</a><td> * Builds a URI string from already-encoded parts.<tr><td><a id="l72"></a><a href="#l72">72</a><td> *<tr><td><a id="l73"></a><a href="#l73">73</a><td> * No encoding is performed.  Any component may be omitted as either null or<tr><td><a id="l74"></a><a href="#l74">74</a><td> * undefined.<tr><td><a id="l75"></a><a href="#l75">75</a><td> *<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @param {?string=} opt_scheme The scheme such as &#39;http&#39;.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {?string=} opt_userInfo The user name before the &#39;@&#39;.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @param {?string=} opt_domain The domain such as &#39;www.google.com&#39;, already<tr><td><a id="l79"></a><a href="#l79">79</a><td> *     URI-encoded.<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @param {(string|number|null)=} opt_port The port number.<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @param {?string=} opt_path The path, already URI-encoded.  If it is not<tr><td><a id="l82"></a><a href="#l82">82</a><td> *     empty, it must begin with a slash.<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @param {?string=} opt_queryData The URI-encoded query data.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {?string=} opt_fragment The URI-encoded fragment identifier.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @return {string} The fully combined URI.<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.uri.utils.buildFromEncodedParts = function(opt_scheme, opt_userInfo,<tr><td><a id="l88"></a><a href="#l88">88</a><td>    opt_domain, opt_port, opt_path, opt_queryData, opt_fragment) {<tr><td><a id="l89"></a><a href="#l89">89</a><td>  var out = &#39;&#39;;<tr><td><a id="l90"></a><a href="#l90">90</a><td><tr><td><a id="l91"></a><a href="#l91">91</a><td>  if (opt_scheme) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>    out += opt_scheme + &#39;:&#39;;<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>  if (opt_domain) {<tr><td><a id="l96"></a><a href="#l96">96</a><td>    out += &#39;//&#39;;<tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>    if (opt_userInfo) {<tr><td><a id="l99"></a><a href="#l99">99</a><td>      out += opt_userInfo + &#39;@&#39;;<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>    out += opt_domain;<tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>    if (opt_port) {<tr><td><a id="l105"></a><a href="#l105">105</a><td>      out += &#39;:&#39; + opt_port;<tr><td><a id="l106"></a><a href="#l106">106</a><td>    }<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>  if (opt_path) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>    out += opt_path;<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>  if (opt_queryData) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>    out += &#39;?&#39; + opt_queryData;<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>  if (opt_fragment) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    out += &#39;#&#39; + opt_fragment;<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 out;<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<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> * A regular expression for breaking a URI into its component parts.<tr><td><a id="l127"></a><a href="#l127">127</a><td> *<tr><td><a id="l128"></a><a href="#l128">128</a><td> * {@link http://www.ietf.org/rfc/rfc3986.txt} says in Appendix B<tr><td><a id="l129"></a><a href="#l129">129</a><td> * As the &quot;first-match-wins&quot; algorithm is identical to the &quot;greedy&quot;<tr><td><a id="l130"></a><a href="#l130">130</a><td> * disambiguation method used by POSIX regular expressions, it is natural and<tr><td><a id="l131"></a><a href="#l131">131</a><td> * commonplace to use a regular expression for parsing the potential five<tr><td><a id="l132"></a><a href="#l132">132</a><td> * components of a URI reference.<tr><td><a id="l133"></a><a href="#l133">133</a><td> *<tr><td><a id="l134"></a><a href="#l134">134</a><td> * The following line is the regular expression for breaking-down a<tr><td><a id="l135"></a><a href="#l135">135</a><td> * well-formed URI reference into its components.<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * &lt;pre&gt;<tr><td><a id="l138"></a><a href="#l138">138</a><td> * ^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?<tr><td><a id="l139"></a><a href="#l139">139</a><td> *  12            3  4          5       6  7        8 9<tr><td><a id="l140"></a><a href="#l140">140</a><td> * &lt;/pre&gt;<tr><td><a id="l141"></a><a href="#l141">141</a><td> *<tr><td><a id="l142"></a><a href="#l142">142</a><td> * The numbers in the second line above are only to assist readability; they<tr><td><a id="l143"></a><a href="#l143">143</a><td> * indicate the reference points for each subexpression (i.e., each paired<tr><td><a id="l144"></a><a href="#l144">144</a><td> * parenthesis). We refer to the value matched for subexpression &lt;n&gt; as $&lt;n&gt;.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * For example, matching the above expression to<tr><td><a id="l146"></a><a href="#l146">146</a><td> * &lt;pre&gt;<tr><td><a id="l147"></a><a href="#l147">147</a><td> *     http://www.ics.uci.edu/pub/ietf/uri/#Related<tr><td><a id="l148"></a><a href="#l148">148</a><td> * &lt;/pre&gt;<tr><td><a id="l149"></a><a href="#l149">149</a><td> * results in the following subexpression matches:<tr><td><a id="l150"></a><a href="#l150">150</a><td> * &lt;pre&gt;<tr><td><a id="l151"></a><a href="#l151">151</a><td> *    $1 = http:<tr><td><a id="l152"></a><a href="#l152">152</a><td> *    $2 = http<tr><td><a id="l153"></a><a href="#l153">153</a><td> *    $3 = //www.ics.uci.edu<tr><td><a id="l154"></a><a href="#l154">154</a><td> *    $4 = www.ics.uci.edu<tr><td><a id="l155"></a><a href="#l155">155</a><td> *    $5 = /pub/ietf/uri/<tr><td><a id="l156"></a><a href="#l156">156</a><td> *    $6 = &lt;undefined&gt;<tr><td><a id="l157"></a><a href="#l157">157</a><td> *    $7 = &lt;undefined&gt;<tr><td><a id="l158"></a><a href="#l158">158</a><td> *    $8 = #Related<tr><td><a id="l159"></a><a href="#l159">159</a><td> *    $9 = Related<tr><td><a id="l160"></a><a href="#l160">160</a><td> * &lt;/pre&gt;<tr><td><a id="l161"></a><a href="#l161">161</a><td> * where &lt;undefined&gt; indicates that the component is not present, as is the<tr><td><a id="l162"></a><a href="#l162">162</a><td> * case for the query component in the above example. Therefore, we can<tr><td><a id="l163"></a><a href="#l163">163</a><td> * determine the value of the five components as<tr><td><a id="l164"></a><a href="#l164">164</a><td> * &lt;pre&gt;<tr><td><a id="l165"></a><a href="#l165">165</a><td> *    scheme    = $2<tr><td><a id="l166"></a><a href="#l166">166</a><td> *    authority = $4<tr><td><a id="l167"></a><a href="#l167">167</a><td> *    path      = $5<tr><td><a id="l168"></a><a href="#l168">168</a><td> *    query     = $7<tr><td><a id="l169"></a><a href="#l169">169</a><td> *    fragment  = $9<tr><td><a id="l170"></a><a href="#l170">170</a><td> * &lt;/pre&gt;<tr><td><a id="l171"></a><a href="#l171">171</a><td> *<tr><td><a id="l172"></a><a href="#l172">172</a><td> * The regular expression has been modified slightly to expose the<tr><td><a id="l173"></a><a href="#l173">173</a><td> * userInfo, domain, and port separately from the authority.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * The modified version yields<tr><td><a id="l175"></a><a href="#l175">175</a><td> * &lt;pre&gt;<tr><td><a id="l176"></a><a href="#l176">176</a><td> *    $1 = http              scheme<tr><td><a id="l177"></a><a href="#l177">177</a><td> *    $2 = &lt;undefined&gt;       userInfo -\<tr><td><a id="l178"></a><a href="#l178">178</a><td> *    $3 = www.ics.uci.edu   domain     | authority<tr><td><a id="l179"></a><a href="#l179">179</a><td> *    $4 = &lt;undefined&gt;       port     -/<tr><td><a id="l180"></a><a href="#l180">180</a><td> *    $5 = /pub/ietf/uri/    path<tr><td><a id="l181"></a><a href="#l181">181</a><td> *    $6 = &lt;undefined&gt;       query without ?<tr><td><a id="l182"></a><a href="#l182">182</a><td> *    $7 = Related           fragment without #<tr><td><a id="l183"></a><a href="#l183">183</a><td> * &lt;/pre&gt;<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @type {!RegExp}<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @private<tr><td><a id="l186"></a><a href="#l186">186</a><td> */<tr><td><a id="l187"></a><a href="#l187">187</a><td>goog.uri.utils.splitRe_ = new RegExp(<tr><td><a id="l188"></a><a href="#l188">188</a><td>    &#39;^&#39; +<tr><td><a id="l189"></a><a href="#l189">189</a><td>    &#39;(?:&#39; +<tr><td><a id="l190"></a><a href="#l190">190</a><td>        &#39;([^:/?#.]+)&#39; +                  // scheme - ignore special characters<tr><td><a id="l191"></a><a href="#l191">191</a><td>                                         // used by other URL parts such as :,<tr><td><a id="l192"></a><a href="#l192">192</a><td>                                         // ?, /, #, and .<tr><td><a id="l193"></a><a href="#l193">193</a><td>    &#39;:)?&#39; +<tr><td><a id="l194"></a><a href="#l194">194</a><td>    &#39;(?://&#39; +<tr><td><a id="l195"></a><a href="#l195">195</a><td>        &#39;(?:([^/?#]*)@)?&#39; +              // userInfo<tr><td><a id="l196"></a><a href="#l196">196</a><td>        &#39;([^/#?]*?)&#39; +                   // domain<tr><td><a id="l197"></a><a href="#l197">197</a><td>        &#39;(?::([0-9]+))?&#39; +               // port<tr><td><a id="l198"></a><a href="#l198">198</a><td>        &#39;(?=[/#?]|$)&#39; +                  // authority-terminating character<tr><td><a id="l199"></a><a href="#l199">199</a><td>    &#39;)?&#39; +<tr><td><a id="l200"></a><a href="#l200">200</a><td>    &#39;([^?#]+)?&#39; +                        // path<tr><td><a id="l201"></a><a href="#l201">201</a><td>    &#39;(?:\\?([^#]*))?&#39; +                  // query<tr><td><a id="l202"></a><a href="#l202">202</a><td>    &#39;(?:#(.*))?&#39; +                       // fragment<tr><td><a id="l203"></a><a href="#l203">203</a><td>    &#39;$&#39;);<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * The index of each URI component in the return value of goog.uri.utils.split.<tr><td><a id="l208"></a><a href="#l208">208</a><td> * @enum {number}<tr><td><a id="l209"></a><a href="#l209">209</a><td> */<tr><td><a id="l210"></a><a href="#l210">210</a><td>goog.uri.utils.ComponentIndex = {<tr><td><a id="l211"></a><a href="#l211">211</a><td>  SCHEME: 1,<tr><td><a id="l212"></a><a href="#l212">212</a><td>  USER_INFO: 2,<tr><td><a id="l213"></a><a href="#l213">213</a><td>  DOMAIN: 3,<tr><td><a id="l214"></a><a href="#l214">214</a><td>  PORT: 4,<tr><td><a id="l215"></a><a href="#l215">215</a><td>  PATH: 5,<tr><td><a id="l216"></a><a href="#l216">216</a><td>  QUERY_DATA: 6,<tr><td><a id="l217"></a><a href="#l217">217</a><td>  FRAGMENT: 7<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><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Splits a URI into its component parts.<tr><td><a id="l223"></a><a href="#l223">223</a><td> *<tr><td><a id="l224"></a><a href="#l224">224</a><td> * Each component can be accessed via the component indices; for example:<tr><td><a id="l225"></a><a href="#l225">225</a><td> * &lt;pre&gt;<tr><td><a id="l226"></a><a href="#l226">226</a><td> * goog.uri.utils.split(someStr)[goog.uri.utils.CompontentIndex.QUERY_DATA];<tr><td><a id="l227"></a><a href="#l227">227</a><td> * &lt;/pre&gt;<tr><td><a id="l228"></a><a href="#l228">228</a><td> *<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @param {string} uri The URI string to examine.<tr><td><a id="l230"></a><a href="#l230">230</a><td> * @return {!Array&lt;string|undefined&gt;} Each component still URI-encoded.<tr><td><a id="l231"></a><a href="#l231">231</a><td> *     Each component that is present will contain the encoded value, whereas<tr><td><a id="l232"></a><a href="#l232">232</a><td> *     components that are not present will be undefined or empty, depending<tr><td><a id="l233"></a><a href="#l233">233</a><td> *     on the browser&#39;s regular expression implementation.  Never null, since<tr><td><a id="l234"></a><a href="#l234">234</a><td> *     arbitrary strings may still look like path names.<tr><td><a id="l235"></a><a href="#l235">235</a><td> */<tr><td><a id="l236"></a><a href="#l236">236</a><td>goog.uri.utils.split = function(uri) {<tr><td><a id="l237"></a><a href="#l237">237</a><td>  // See @return comment -- never null.<tr><td><a id="l238"></a><a href="#l238">238</a><td>  return /** @type {!Array&lt;string|undefined&gt;} */ (<tr><td><a id="l239"></a><a href="#l239">239</a><td>      uri.match(goog.uri.utils.splitRe_));<tr><td><a id="l240"></a><a href="#l240">240</a><td>};<tr><td><a id="l241"></a><a href="#l241">241</a><td><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> * @param {?string} uri A possibly null string.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {boolean=} opt_preserveReserved If true, percent-encoding of RFC-3986<tr><td><a id="l246"></a><a href="#l246">246</a><td> *     reserved characters will not be removed.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @return {?string} The string URI-decoded, or null if uri is null.<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @private<tr><td><a id="l249"></a><a href="#l249">249</a><td> */<tr><td><a id="l250"></a><a href="#l250">250</a><td>goog.uri.utils.decodeIfPossible_ = function(uri, opt_preserveReserved) {<tr><td><a id="l251"></a><a href="#l251">251</a><td>  if (!uri) {<tr><td><a id="l252"></a><a href="#l252">252</a><td>    return uri;<tr><td><a id="l253"></a><a href="#l253">253</a><td>  }<tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>  return opt_preserveReserved ? decodeURI(uri) : decodeURIComponent(uri);<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>/**<tr><td><a id="l260"></a><a href="#l260">260</a><td> * Gets a URI component by index.<tr><td><a id="l261"></a><a href="#l261">261</a><td> *<tr><td><a id="l262"></a><a href="#l262">262</a><td> * It is preferred to use the getPathEncoded() variety of functions ahead,<tr><td><a id="l263"></a><a href="#l263">263</a><td> * since they are more readable.<tr><td><a id="l264"></a><a href="#l264">264</a><td> *<tr><td><a id="l265"></a><a href="#l265">265</a><td> * @param {goog.uri.utils.ComponentIndex} componentIndex The component index.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @return {?string} The still-encoded component, or null if the component<tr><td><a id="l268"></a><a href="#l268">268</a><td> *     is not present.<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @private<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>goog.uri.utils.getComponentByIndex_ = function(componentIndex, uri) {<tr><td><a id="l272"></a><a href="#l272">272</a><td>  // Convert undefined, null, and empty string into null.<tr><td><a id="l273"></a><a href="#l273">273</a><td>  return goog.uri.utils.split(uri)[componentIndex] || null;<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><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 {string} uri The URI to examine.<tr><td><a id="l279"></a><a href="#l279">279</a><td> * @return {?string} The protocol or scheme, or null if none.  Does not<tr><td><a id="l280"></a><a href="#l280">280</a><td> *     include trailing colons or slashes.<tr><td><a id="l281"></a><a href="#l281">281</a><td> */<tr><td><a id="l282"></a><a href="#l282">282</a><td>goog.uri.utils.getScheme = function(uri) {<tr><td><a id="l283"></a><a href="#l283">283</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a id="l284"></a><a href="#l284">284</a><td>      goog.uri.utils.ComponentIndex.SCHEME, uri);<tr><td><a id="l285"></a><a href="#l285">285</a><td>};<tr><td><a id="l286"></a><a href="#l286">286</a><td><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> * Gets the effective scheme for the URL.  If the URL is relative then the<tr><td><a id="l290"></a><a href="#l290">290</a><td> * scheme is derived from the page&#39;s location.<tr><td><a id="l291"></a><a href="#l291">291</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @return {string} The protocol or scheme, always lower case.<tr><td><a id="l293"></a><a href="#l293">293</a><td> */<tr><td><a id="l294"></a><a href="#l294">294</a><td>goog.uri.utils.getEffectiveScheme = function(uri) {<tr><td><a id="l295"></a><a href="#l295">295</a><td>  var scheme = goog.uri.utils.getScheme(uri);<tr><td><a id="l296"></a><a href="#l296">296</a><td>  if (!scheme &amp;&amp; goog.global.self &amp;&amp; goog.global.self.location) {<tr><td><a id="l297"></a><a href="#l297">297</a><td>    var protocol = goog.global.self.location.protocol;<tr><td><a id="l298"></a><a href="#l298">298</a><td>    scheme = protocol.substr(0, protocol.length - 1);<tr><td><a id="l299"></a><a href="#l299">299</a><td>  }<tr><td><a id="l300"></a><a href="#l300">300</a><td>  // NOTE: When called from a web worker in Firefox 3.5, location maybe null.<tr><td><a id="l301"></a><a href="#l301">301</a><td>  // All other browsers with web workers support self.location from the worker.<tr><td><a id="l302"></a><a href="#l302">302</a><td>  return scheme ? scheme.toLowerCase() : &#39;&#39;;<tr><td><a id="l303"></a><a href="#l303">303</a><td>};<tr><td><a id="l304"></a><a href="#l304">304</a><td><tr><td><a id="l305"></a><a href="#l305">305</a><td><tr><td><a id="l306"></a><a href="#l306">306</a><td>/**<tr><td><a id="l307"></a><a href="#l307">307</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l308"></a><a href="#l308">308</a><td> * @return {?string} The user name still encoded, or null if none.<tr><td><a id="l309"></a><a href="#l309">309</a><td> */<tr><td><a id="l310"></a><a href="#l310">310</a><td>goog.uri.utils.getUserInfoEncoded = function(uri) {<tr><td><a id="l311"></a><a href="#l311">311</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a id="l312"></a><a href="#l312">312</a><td>      goog.uri.utils.ComponentIndex.USER_INFO, uri);<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>/**<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l318"></a><a href="#l318">318</a><td> * @return {?string} The decoded user info, or null if none.<tr><td><a id="l319"></a><a href="#l319">319</a><td> */<tr><td><a id="l320"></a><a href="#l320">320</a><td>goog.uri.utils.getUserInfo = function(uri) {<tr><td><a id="l321"></a><a href="#l321">321</a><td>  return goog.uri.utils.decodeIfPossible_(<tr><td><a id="l322"></a><a href="#l322">322</a><td>      goog.uri.utils.getUserInfoEncoded(uri));<tr><td><a id="l323"></a><a href="#l323">323</a><td>};<tr><td><a id="l324"></a><a href="#l324">324</a><td><tr><td><a id="l325"></a><a href="#l325">325</a><td><tr><td><a id="l326"></a><a href="#l326">326</a><td>/**<tr><td><a id="l327"></a><a href="#l327">327</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l328"></a><a href="#l328">328</a><td> * @return {?string} The domain name still encoded, or null if none.<tr><td><a id="l329"></a><a href="#l329">329</a><td> */<tr><td><a id="l330"></a><a href="#l330">330</a><td>goog.uri.utils.getDomainEncoded = function(uri) {<tr><td><a id="l331"></a><a href="#l331">331</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a id="l332"></a><a href="#l332">332</a><td>      goog.uri.utils.ComponentIndex.DOMAIN, uri);<tr><td><a id="l333"></a><a href="#l333">333</a><td>};<tr><td><a id="l334"></a><a href="#l334">334</a><td><tr><td><a id="l335"></a><a href="#l335">335</a><td><tr><td><a id="l336"></a><a href="#l336">336</a><td>/**<tr><td><a id="l337"></a><a href="#l337">337</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l338"></a><a href="#l338">338</a><td> * @return {?string} The decoded domain, or null if none.<tr><td><a id="l339"></a><a href="#l339">339</a><td> */<tr><td><a id="l340"></a><a href="#l340">340</a><td>goog.uri.utils.getDomain = function(uri) {<tr><td><a id="l341"></a><a href="#l341">341</a><td>  return goog.uri.utils.decodeIfPossible_(<tr><td><a id="l342"></a><a href="#l342">342</a><td>      goog.uri.utils.getDomainEncoded(uri), true /* opt_preserveReserved */);<tr><td><a id="l343"></a><a href="#l343">343</a><td>};<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> * @param {string} uri The URI to examine.<tr><td><a id="l348"></a><a href="#l348">348</a><td> * @return {?number} The port number, or null if none.<tr><td><a id="l349"></a><a href="#l349">349</a><td> */<tr><td><a id="l350"></a><a href="#l350">350</a><td>goog.uri.utils.getPort = function(uri) {<tr><td><a id="l351"></a><a href="#l351">351</a><td>  // Coerce to a number.  If the result of getComponentByIndex_ is null or<tr><td><a id="l352"></a><a href="#l352">352</a><td>  // non-numeric, the number coersion yields NaN.  This will then return<tr><td><a id="l353"></a><a href="#l353">353</a><td>  // null for all non-numeric cases (though also zero, which isn&#39;t a relevant<tr><td><a id="l354"></a><a href="#l354">354</a><td>  // port number).<tr><td><a id="l355"></a><a href="#l355">355</a><td>  return Number(goog.uri.utils.getComponentByIndex_(<tr><td><a id="l356"></a><a href="#l356">356</a><td>      goog.uri.utils.ComponentIndex.PORT, uri)) || null;<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>/**<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @return {?string} The path still encoded, or null if none. Includes the<tr><td><a id="l363"></a><a href="#l363">363</a><td> *     leading slash, if any.<tr><td><a id="l364"></a><a href="#l364">364</a><td> */<tr><td><a id="l365"></a><a href="#l365">365</a><td>goog.uri.utils.getPathEncoded = function(uri) {<tr><td><a id="l366"></a><a href="#l366">366</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a id="l367"></a><a href="#l367">367</a><td>      goog.uri.utils.ComponentIndex.PATH, uri);<tr><td><a id="l368"></a><a href="#l368">368</a><td>};<tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td>/**<tr><td><a id="l372"></a><a href="#l372">372</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l373"></a><a href="#l373">373</a><td> * @return {?string} The decoded path, or null if none.  Includes the leading<tr><td><a id="l374"></a><a href="#l374">374</a><td> *     slash, if any.<tr><td><a id="l375"></a><a href="#l375">375</a><td> */<tr><td><a id="l376"></a><a href="#l376">376</a><td>goog.uri.utils.getPath = function(uri) {<tr><td><a id="l377"></a><a href="#l377">377</a><td>  return goog.uri.utils.decodeIfPossible_(<tr><td><a id="l378"></a><a href="#l378">378</a><td>      goog.uri.utils.getPathEncoded(uri), true /* opt_preserveReserved */);<tr><td><a id="l379"></a><a href="#l379">379</a><td>};<tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td><tr><td><a id="l382"></a><a href="#l382">382</a><td>/**<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l384"></a><a href="#l384">384</a><td> * @return {?string} The query data still encoded, or null if none.  Does not<tr><td><a id="l385"></a><a href="#l385">385</a><td> *     include the question mark itself.<tr><td><a id="l386"></a><a href="#l386">386</a><td> */<tr><td><a id="l387"></a><a href="#l387">387</a><td>goog.uri.utils.getQueryData = function(uri) {<tr><td><a id="l388"></a><a href="#l388">388</a><td>  return goog.uri.utils.getComponentByIndex_(<tr><td><a id="l389"></a><a href="#l389">389</a><td>      goog.uri.utils.ComponentIndex.QUERY_DATA, uri);<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>/**<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l395"></a><a href="#l395">395</a><td> * @return {?string} The fragment identifier, or null if none.  Does not<tr><td><a id="l396"></a><a href="#l396">396</a><td> *     include the hash mark itself.<tr><td><a id="l397"></a><a href="#l397">397</a><td> */<tr><td><a id="l398"></a><a href="#l398">398</a><td>goog.uri.utils.getFragmentEncoded = function(uri) {<tr><td><a id="l399"></a><a href="#l399">399</a><td>  // The hash mark may not appear in any other part of the URL.<tr><td><a id="l400"></a><a href="#l400">400</a><td>  var hashIndex = uri.indexOf(&#39;#&#39;);<tr><td><a id="l401"></a><a href="#l401">401</a><td>  return hashIndex &lt; 0 ? null : uri.substr(hashIndex + 1);<tr><td><a id="l402"></a><a href="#l402">402</a><td>};<tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td><tr><td><a id="l405"></a><a href="#l405">405</a><td>/**<tr><td><a id="l406"></a><a href="#l406">406</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @param {?string} fragment The encoded fragment identifier, or null if none.<tr><td><a id="l408"></a><a href="#l408">408</a><td> *     Does not include the hash mark itself.<tr><td><a id="l409"></a><a href="#l409">409</a><td> * @return {string} The URI with the fragment set.<tr><td><a id="l410"></a><a href="#l410">410</a><td> */<tr><td><a id="l411"></a><a href="#l411">411</a><td>goog.uri.utils.setFragmentEncoded = function(uri, fragment) {<tr><td><a id="l412"></a><a href="#l412">412</a><td>  return goog.uri.utils.removeFragment(uri) + (fragment ? &#39;#&#39; + fragment : &#39;&#39;);<tr><td><a id="l413"></a><a href="#l413">413</a><td>};<tr><td><a id="l414"></a><a href="#l414">414</a><td><tr><td><a id="l415"></a><a href="#l415">415</a><td><tr><td><a id="l416"></a><a href="#l416">416</a><td>/**<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l418"></a><a href="#l418">418</a><td> * @return {?string} The decoded fragment identifier, or null if none.  Does<tr><td><a id="l419"></a><a href="#l419">419</a><td> *     not include the hash mark.<tr><td><a id="l420"></a><a href="#l420">420</a><td> */<tr><td><a id="l421"></a><a href="#l421">421</a><td>goog.uri.utils.getFragment = function(uri) {<tr><td><a id="l422"></a><a href="#l422">422</a><td>  return goog.uri.utils.decodeIfPossible_(<tr><td><a id="l423"></a><a href="#l423">423</a><td>      goog.uri.utils.getFragmentEncoded(uri));<tr><td><a id="l424"></a><a href="#l424">424</a><td>};<tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td><tr><td><a id="l427"></a><a href="#l427">427</a><td>/**<tr><td><a id="l428"></a><a href="#l428">428</a><td> * Extracts everything up to the port of the URI.<tr><td><a id="l429"></a><a href="#l429">429</a><td> * @param {string} uri The URI string.<tr><td><a id="l430"></a><a href="#l430">430</a><td> * @return {string} Everything up to and including the port.<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.uri.utils.getHost = function(uri) {<tr><td><a id="l433"></a><a href="#l433">433</a><td>  var pieces = goog.uri.utils.split(uri);<tr><td><a id="l434"></a><a href="#l434">434</a><td>  return goog.uri.utils.buildFromEncodedParts(<tr><td><a id="l435"></a><a href="#l435">435</a><td>      pieces[goog.uri.utils.ComponentIndex.SCHEME],<tr><td><a id="l436"></a><a href="#l436">436</a><td>      pieces[goog.uri.utils.ComponentIndex.USER_INFO],<tr><td><a id="l437"></a><a href="#l437">437</a><td>      pieces[goog.uri.utils.ComponentIndex.DOMAIN],<tr><td><a id="l438"></a><a href="#l438">438</a><td>      pieces[goog.uri.utils.ComponentIndex.PORT]);<tr><td><a id="l439"></a><a href="#l439">439</a><td>};<tr><td><a id="l440"></a><a href="#l440">440</a><td><tr><td><a id="l441"></a><a href="#l441">441</a><td><tr><td><a id="l442"></a><a href="#l442">442</a><td>/**<tr><td><a id="l443"></a><a href="#l443">443</a><td> * Extracts the path of the URL and everything after.<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @param {string} uri The URI string.<tr><td><a id="l445"></a><a href="#l445">445</a><td> * @return {string} The URI, starting at the path and including the query<tr><td><a id="l446"></a><a href="#l446">446</a><td> *     parameters and fragment identifier.<tr><td><a id="l447"></a><a href="#l447">447</a><td> */<tr><td><a id="l448"></a><a href="#l448">448</a><td>goog.uri.utils.getPathAndAfter = function(uri) {<tr><td><a id="l449"></a><a href="#l449">449</a><td>  var pieces = goog.uri.utils.split(uri);<tr><td><a id="l450"></a><a href="#l450">450</a><td>  return goog.uri.utils.buildFromEncodedParts(null, null, null, null,<tr><td><a id="l451"></a><a href="#l451">451</a><td>      pieces[goog.uri.utils.ComponentIndex.PATH],<tr><td><a id="l452"></a><a href="#l452">452</a><td>      pieces[goog.uri.utils.ComponentIndex.QUERY_DATA],<tr><td><a id="l453"></a><a href="#l453">453</a><td>      pieces[goog.uri.utils.ComponentIndex.FRAGMENT]);<tr><td><a id="l454"></a><a href="#l454">454</a><td>};<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td><tr><td><a id="l457"></a><a href="#l457">457</a><td>/**<tr><td><a id="l458"></a><a href="#l458">458</a><td> * Gets the URI with the fragment identifier removed.<tr><td><a id="l459"></a><a href="#l459">459</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l460"></a><a href="#l460">460</a><td> * @return {string} Everything preceding the hash mark.<tr><td><a id="l461"></a><a href="#l461">461</a><td> */<tr><td><a id="l462"></a><a href="#l462">462</a><td>goog.uri.utils.removeFragment = function(uri) {<tr><td><a id="l463"></a><a href="#l463">463</a><td>  // The hash mark may not appear in any other part of the URL.<tr><td><a id="l464"></a><a href="#l464">464</a><td>  var hashIndex = uri.indexOf(&#39;#&#39;);<tr><td><a id="l465"></a><a href="#l465">465</a><td>  return hashIndex &lt; 0 ? uri : uri.substr(0, hashIndex);<tr><td><a id="l466"></a><a href="#l466">466</a><td>};<tr><td><a id="l467"></a><a href="#l467">467</a><td><tr><td><a id="l468"></a><a href="#l468">468</a><td><tr><td><a id="l469"></a><a href="#l469">469</a><td>/**<tr><td><a id="l470"></a><a href="#l470">470</a><td> * Ensures that two URI&#39;s have the exact same domain, scheme, and port.<tr><td><a id="l471"></a><a href="#l471">471</a><td> *<tr><td><a id="l472"></a><a href="#l472">472</a><td> * Unlike the version in goog.Uri, this checks protocol, and therefore is<tr><td><a id="l473"></a><a href="#l473">473</a><td> * suitable for checking against the browser&#39;s same-origin policy.<tr><td><a id="l474"></a><a href="#l474">474</a><td> *<tr><td><a id="l475"></a><a href="#l475">475</a><td> * @param {string} uri1 The first URI.<tr><td><a id="l476"></a><a href="#l476">476</a><td> * @param {string} uri2 The second URI.<tr><td><a id="l477"></a><a href="#l477">477</a><td> * @return {boolean} Whether they have the same scheme, domain and port.<tr><td><a id="l478"></a><a href="#l478">478</a><td> */<tr><td><a id="l479"></a><a href="#l479">479</a><td>goog.uri.utils.haveSameDomain = function(uri1, uri2) {<tr><td><a id="l480"></a><a href="#l480">480</a><td>  var pieces1 = goog.uri.utils.split(uri1);<tr><td><a id="l481"></a><a href="#l481">481</a><td>  var pieces2 = goog.uri.utils.split(uri2);<tr><td><a id="l482"></a><a href="#l482">482</a><td>  return pieces1[goog.uri.utils.ComponentIndex.DOMAIN] ==<tr><td><a id="l483"></a><a href="#l483">483</a><td>             pieces2[goog.uri.utils.ComponentIndex.DOMAIN] &amp;&amp;<tr><td><a id="l484"></a><a href="#l484">484</a><td>         pieces1[goog.uri.utils.ComponentIndex.SCHEME] ==<tr><td><a id="l485"></a><a href="#l485">485</a><td>             pieces2[goog.uri.utils.ComponentIndex.SCHEME] &amp;&amp;<tr><td><a id="l486"></a><a href="#l486">486</a><td>         pieces1[goog.uri.utils.ComponentIndex.PORT] ==<tr><td><a id="l487"></a><a href="#l487">487</a><td>             pieces2[goog.uri.utils.ComponentIndex.PORT];<tr><td><a id="l488"></a><a href="#l488">488</a><td>};<tr><td><a id="l489"></a><a href="#l489">489</a><td><tr><td><a id="l490"></a><a href="#l490">490</a><td><tr><td><a id="l491"></a><a href="#l491">491</a><td>/**<tr><td><a id="l492"></a><a href="#l492">492</a><td> * Asserts that there are no fragment or query identifiers, only in uncompiled<tr><td><a id="l493"></a><a href="#l493">493</a><td> * mode.<tr><td><a id="l494"></a><a href="#l494">494</a><td> * @param {string} uri The URI to examine.<tr><td><a id="l495"></a><a href="#l495">495</a><td> * @private<tr><td><a id="l496"></a><a href="#l496">496</a><td> */<tr><td><a id="l497"></a><a href="#l497">497</a><td>goog.uri.utils.assertNoFragmentsOrQueries_ = function(uri) {<tr><td><a id="l498"></a><a href="#l498">498</a><td>  // NOTE: would use goog.asserts here, but jscompiler doesn&#39;t know that<tr><td><a id="l499"></a><a href="#l499">499</a><td>  // indexOf has no side effects.<tr><td><a id="l500"></a><a href="#l500">500</a><td>  if (goog.DEBUG &amp;&amp; (uri.indexOf(&#39;#&#39;) &gt;= 0 || uri.indexOf(&#39;?&#39;) &gt;= 0)) {<tr><td><a id="l501"></a><a href="#l501">501</a><td>    throw Error(&#39;goog.uri.utils: Fragment or query identifiers are not &#39; +<tr><td><a id="l502"></a><a href="#l502">502</a><td>        &#39;supported: [&#39; + uri + &#39;]&#39;);<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><tr><td><a id="l507"></a><a href="#l507">507</a><td>/**<tr><td><a id="l508"></a><a href="#l508">508</a><td> * Supported query parameter values by the parameter serializing utilities.<tr><td><a id="l509"></a><a href="#l509">509</a><td> *<tr><td><a id="l510"></a><a href="#l510">510</a><td> * If a value is null or undefined, the key-value pair is skipped, as an easy<tr><td><a id="l511"></a><a href="#l511">511</a><td> * way to omit parameters conditionally.  Non-array parameters are converted<tr><td><a id="l512"></a><a href="#l512">512</a><td> * to a string and URI encoded.  Array values are expanded into multiple<tr><td><a id="l513"></a><a href="#l513">513</a><td> * &amp;key=value pairs, with each element stringized and URI-encoded.<tr><td><a id="l514"></a><a href="#l514">514</a><td> *<tr><td><a id="l515"></a><a href="#l515">515</a><td> * @typedef {*}<tr><td><a id="l516"></a><a href="#l516">516</a><td> */<tr><td><a id="l517"></a><a href="#l517">517</a><td>goog.uri.utils.QueryValue;<tr><td><a id="l518"></a><a href="#l518">518</a><td><tr><td><a id="l519"></a><a href="#l519">519</a><td><tr><td><a id="l520"></a><a href="#l520">520</a><td>/**<tr><td><a id="l521"></a><a href="#l521">521</a><td> * An array representing a set of query parameters with alternating keys<tr><td><a id="l522"></a><a href="#l522">522</a><td> * and values.<tr><td><a id="l523"></a><a href="#l523">523</a><td> *<tr><td><a id="l524"></a><a href="#l524">524</a><td> * Keys are assumed to be URI encoded already and live at even indices.  See<tr><td><a id="l525"></a><a href="#l525">525</a><td> * goog.uri.utils.QueryValue for details on how parameter values are encoded.<tr><td><a id="l526"></a><a href="#l526">526</a><td> *<tr><td><a id="l527"></a><a href="#l527">527</a><td> * Example:<tr><td><a id="l528"></a><a href="#l528">528</a><td> * &lt;pre&gt;<tr><td><a id="l529"></a><a href="#l529">529</a><td> * var data = [<tr><td><a id="l530"></a><a href="#l530">530</a><td> *   // Simple param: ?name=BobBarker<tr><td><a id="l531"></a><a href="#l531">531</a><td> *   &#39;name&#39;, &#39;BobBarker&#39;,<tr><td><a id="l532"></a><a href="#l532">532</a><td> *   // Conditional param -- may be omitted entirely.<tr><td><a id="l533"></a><a href="#l533">533</a><td> *   &#39;specialDietaryNeeds&#39;, hasDietaryNeeds() ? getDietaryNeeds() : null,<tr><td><a id="l534"></a><a href="#l534">534</a><td> *   // Multi-valued param: &amp;house=LosAngeles&amp;house=NewYork&amp;house=null<tr><td><a id="l535"></a><a href="#l535">535</a><td> *   &#39;house&#39;, [&#39;LosAngeles&#39;, &#39;NewYork&#39;, null]<tr><td><a id="l536"></a><a href="#l536">536</a><td> * ];<tr><td><a id="l537"></a><a href="#l537">537</a><td> * &lt;/pre&gt;<tr><td><a id="l538"></a><a href="#l538">538</a><td> *<tr><td><a id="l539"></a><a href="#l539">539</a><td> * @typedef {!Array&lt;string|goog.uri.utils.QueryValue&gt;}<tr><td><a id="l540"></a><a href="#l540">540</a><td> */<tr><td><a id="l541"></a><a href="#l541">541</a><td>goog.uri.utils.QueryArray;<tr><td><a id="l542"></a><a href="#l542">542</a><td><tr><td><a id="l543"></a><a href="#l543">543</a><td><tr><td><a id="l544"></a><a href="#l544">544</a><td>/**<tr><td><a id="l545"></a><a href="#l545">545</a><td> * Parses encoded query parameters and calls callback function for every<tr><td><a id="l546"></a><a href="#l546">546</a><td> * parameter found in the string.<tr><td><a id="l547"></a><a href="#l547">547</a><td> *<tr><td><a id="l548"></a><a href="#l548">548</a><td> * Missing value of parameter (e.g. “…&amp;key&amp;…”) is treated as if the value was an<tr><td><a id="l549"></a><a href="#l549">549</a><td> * empty string.  Keys may be empty strings (e.g. “…&amp;=value&amp;…”) which also means<tr><td><a id="l550"></a><a href="#l550">550</a><td> * that “…&amp;=&amp;…” and “…&amp;&amp;…” will result in an empty key and value.<tr><td><a id="l551"></a><a href="#l551">551</a><td> *<tr><td><a id="l552"></a><a href="#l552">552</a><td> * @param {string} encodedQuery Encoded query string excluding question mark at<tr><td><a id="l553"></a><a href="#l553">553</a><td> *     the beginning.<tr><td><a id="l554"></a><a href="#l554">554</a><td> * @param {function(string, string)} callback Function called for every<tr><td><a id="l555"></a><a href="#l555">555</a><td> *     parameter found in query string.  The first argument (name) will not be<tr><td><a id="l556"></a><a href="#l556">556</a><td> *     urldecoded (so the function is consistent with buildQueryData), but the<tr><td><a id="l557"></a><a href="#l557">557</a><td> *     second will.  If the parameter has no value (i.e. “=” was not present)<tr><td><a id="l558"></a><a href="#l558">558</a><td> *     the second argument (value) will be an empty string.<tr><td><a id="l559"></a><a href="#l559">559</a><td> */<tr><td><a id="l560"></a><a href="#l560">560</a><td>goog.uri.utils.parseQueryData = function(encodedQuery, callback) {<tr><td><a id="l561"></a><a href="#l561">561</a><td>  if (!encodedQuery) {<tr><td><a id="l562"></a><a href="#l562">562</a><td>    return;<tr><td><a id="l563"></a><a href="#l563">563</a><td>  }<tr><td><a id="l564"></a><a href="#l564">564</a><td>  var pairs = encodedQuery.split(&#39;&amp;&#39;);<tr><td><a id="l565"></a><a href="#l565">565</a><td>  for (var i = 0; i &lt; pairs.length; i++) {<tr><td><a id="l566"></a><a href="#l566">566</a><td>    var indexOfEquals = pairs[i].indexOf(&#39;=&#39;);<tr><td><a id="l567"></a><a href="#l567">567</a><td>    var name = null;<tr><td><a id="l568"></a><a href="#l568">568</a><td>    var value = null;<tr><td><a id="l569"></a><a href="#l569">569</a><td>    if (indexOfEquals &gt;= 0) {<tr><td><a id="l570"></a><a href="#l570">570</a><td>      name = pairs[i].substring(0, indexOfEquals);<tr><td><a id="l571"></a><a href="#l571">571</a><td>      value = pairs[i].substring(indexOfEquals + 1);<tr><td><a id="l572"></a><a href="#l572">572</a><td>    } else {<tr><td><a id="l573"></a><a href="#l573">573</a><td>      name = pairs[i];<tr><td><a id="l574"></a><a href="#l574">574</a><td>    }<tr><td><a id="l575"></a><a href="#l575">575</a><td>    callback(name, value ? goog.string.urlDecode(value) : &#39;&#39;);<tr><td><a id="l576"></a><a href="#l576">576</a><td>  }<tr><td><a id="l577"></a><a href="#l577">577</a><td>};<tr><td><a id="l578"></a><a href="#l578">578</a><td><tr><td><a id="l579"></a><a href="#l579">579</a><td><tr><td><a id="l580"></a><a href="#l580">580</a><td>/**<tr><td><a id="l581"></a><a href="#l581">581</a><td> * Appends a URI and query data in a string buffer with special preconditions.<tr><td><a id="l582"></a><a href="#l582">582</a><td> *<tr><td><a id="l583"></a><a href="#l583">583</a><td> * Internal implementation utility, performing very few object allocations.<tr><td><a id="l584"></a><a href="#l584">584</a><td> *<tr><td><a id="l585"></a><a href="#l585">585</a><td> * @param {!Array&lt;string|undefined&gt;} buffer A string buffer.  The first element<tr><td><a id="l586"></a><a href="#l586">586</a><td> *     must be the base URI, and may have a fragment identifier.  If the array<tr><td><a id="l587"></a><a href="#l587">587</a><td> *     contains more than one element, the second element must be an ampersand,<tr><td><a id="l588"></a><a href="#l588">588</a><td> *     and may be overwritten, depending on the base URI.  Undefined elements<tr><td><a id="l589"></a><a href="#l589">589</a><td> *     are treated as empty-string.<tr><td><a id="l590"></a><a href="#l590">590</a><td> * @return {string} The concatenated URI and query data.<tr><td><a id="l591"></a><a href="#l591">591</a><td> * @private<tr><td><a id="l592"></a><a href="#l592">592</a><td> */<tr><td><a id="l593"></a><a href="#l593">593</a><td>goog.uri.utils.appendQueryData_ = function(buffer) {<tr><td><a id="l594"></a><a href="#l594">594</a><td>  if (buffer[1]) {<tr><td><a id="l595"></a><a href="#l595">595</a><td>    // At least one query parameter was added.  We need to check the<tr><td><a id="l596"></a><a href="#l596">596</a><td>    // punctuation mark, which is currently an ampersand, and also make sure<tr><td><a id="l597"></a><a href="#l597">597</a><td>    // there aren&#39;t any interfering fragment identifiers.<tr><td><a id="l598"></a><a href="#l598">598</a><td>    var baseUri = /** @type {string} */ (buffer[0]);<tr><td><a id="l599"></a><a href="#l599">599</a><td>    var hashIndex = baseUri.indexOf(&#39;#&#39;);<tr><td><a id="l600"></a><a href="#l600">600</a><td>    if (hashIndex &gt;= 0) {<tr><td><a id="l601"></a><a href="#l601">601</a><td>      // Move the fragment off the base part of the URI into the end.<tr><td><a id="l602"></a><a href="#l602">602</a><td>      buffer.push(baseUri.substr(hashIndex));<tr><td><a id="l603"></a><a href="#l603">603</a><td>      buffer[0] = baseUri = baseUri.substr(0, hashIndex);<tr><td><a id="l604"></a><a href="#l604">604</a><td>    }<tr><td><a id="l605"></a><a href="#l605">605</a><td>    var questionIndex = baseUri.indexOf(&#39;?&#39;);<tr><td><a id="l606"></a><a href="#l606">606</a><td>    if (questionIndex &lt; 0) {<tr><td><a id="l607"></a><a href="#l607">607</a><td>      // No question mark, so we need a question mark instead of an ampersand.<tr><td><a id="l608"></a><a href="#l608">608</a><td>      buffer[1] = &#39;?&#39;;<tr><td><a id="l609"></a><a href="#l609">609</a><td>    } else if (questionIndex == baseUri.length - 1) {<tr><td><a id="l610"></a><a href="#l610">610</a><td>      // Question mark is the very last character of the existing URI, so don&#39;t<tr><td><a id="l611"></a><a href="#l611">611</a><td>      // append an additional delimiter.<tr><td><a id="l612"></a><a href="#l612">612</a><td>      buffer[1] = undefined;<tr><td><a id="l613"></a><a href="#l613">613</a><td>    }<tr><td><a id="l614"></a><a href="#l614">614</a><td>  }<tr><td><a id="l615"></a><a href="#l615">615</a><td><tr><td><a id="l616"></a><a href="#l616">616</a><td>  return buffer.join(&#39;&#39;);<tr><td><a id="l617"></a><a href="#l617">617</a><td>};<tr><td><a id="l618"></a><a href="#l618">618</a><td><tr><td><a id="l619"></a><a href="#l619">619</a><td><tr><td><a id="l620"></a><a href="#l620">620</a><td>/**<tr><td><a id="l621"></a><a href="#l621">621</a><td> * Appends key=value pairs to an array, supporting multi-valued objects.<tr><td><a id="l622"></a><a href="#l622">622</a><td> * @param {string} key The key prefix.<tr><td><a id="l623"></a><a href="#l623">623</a><td> * @param {goog.uri.utils.QueryValue} value The value to serialize.<tr><td><a id="l624"></a><a href="#l624">624</a><td> * @param {!Array&lt;string&gt;} pairs The array to which the &#39;key=value&#39; strings<tr><td><a id="l625"></a><a href="#l625">625</a><td> *     should be appended.<tr><td><a id="l626"></a><a href="#l626">626</a><td> * @private<tr><td><a id="l627"></a><a href="#l627">627</a><td> */<tr><td><a id="l628"></a><a href="#l628">628</a><td>goog.uri.utils.appendKeyValuePairs_ = function(key, value, pairs) {<tr><td><a id="l629"></a><a href="#l629">629</a><td>  if (goog.isArray(value)) {<tr><td><a id="l630"></a><a href="#l630">630</a><td>    // Convince the compiler it&#39;s an array.<tr><td><a id="l631"></a><a href="#l631">631</a><td>    goog.asserts.assertArray(value);<tr><td><a id="l632"></a><a href="#l632">632</a><td>    for (var j = 0; j &lt; value.length; j++) {<tr><td><a id="l633"></a><a href="#l633">633</a><td>      // Convert to string explicitly, to short circuit the null and array<tr><td><a id="l634"></a><a href="#l634">634</a><td>      // logic in this function -- this ensures that null and undefined get<tr><td><a id="l635"></a><a href="#l635">635</a><td>      // written as literal &#39;null&#39; and &#39;undefined&#39;, and arrays don&#39;t get<tr><td><a id="l636"></a><a href="#l636">636</a><td>      // expanded out but instead encoded in the default way.<tr><td><a id="l637"></a><a href="#l637">637</a><td>      goog.uri.utils.appendKeyValuePairs_(key, String(value[j]), pairs);<tr><td><a id="l638"></a><a href="#l638">638</a><td>    }<tr><td><a id="l639"></a><a href="#l639">639</a><td>  } else if (value != null) {<tr><td><a id="l640"></a><a href="#l640">640</a><td>    // Skip a top-level null or undefined entirely.<tr><td><a id="l641"></a><a href="#l641">641</a><td>    pairs.push(&#39;&amp;&#39;, key,<tr><td><a id="l642"></a><a href="#l642">642</a><td>        // Check for empty string. Zero gets encoded into the url as literal<tr><td><a id="l643"></a><a href="#l643">643</a><td>        // strings.  For empty string, skip the equal sign, to be consistent<tr><td><a id="l644"></a><a href="#l644">644</a><td>        // with UriBuilder.java.<tr><td><a id="l645"></a><a href="#l645">645</a><td>        value === &#39;&#39; ? &#39;&#39; : &#39;=&#39;,<tr><td><a id="l646"></a><a href="#l646">646</a><td>        goog.string.urlEncode(value));<tr><td><a id="l647"></a><a href="#l647">647</a><td>  }<tr><td><a id="l648"></a><a href="#l648">648</a><td>};<tr><td><a id="l649"></a><a href="#l649">649</a><td><tr><td><a id="l650"></a><a href="#l650">650</a><td><tr><td><a id="l651"></a><a href="#l651">651</a><td>/**<tr><td><a id="l652"></a><a href="#l652">652</a><td> * Builds a buffer of query data from a sequence of alternating keys and values.<tr><td><a id="l653"></a><a href="#l653">653</a><td> *<tr><td><a id="l654"></a><a href="#l654">654</a><td> * @param {!Array&lt;string|undefined&gt;} buffer A string buffer to append to.  The<tr><td><a id="l655"></a><a href="#l655">655</a><td> *     first element appended will be an &#39;&amp;&#39;, and may be replaced by the caller.<tr><td><a id="l656"></a><a href="#l656">656</a><td> * @param {!goog.uri.utils.QueryArray|!Arguments} keysAndValues An array with<tr><td><a id="l657"></a><a href="#l657">657</a><td> *     alternating keys and values -- see the typedef.<tr><td><a id="l658"></a><a href="#l658">658</a><td> * @param {number=} opt_startIndex A start offset into the arary, defaults to 0.<tr><td><a id="l659"></a><a href="#l659">659</a><td> * @return {!Array&lt;string|undefined&gt;} The buffer argument.<tr><td><a id="l660"></a><a href="#l660">660</a><td> * @private<tr><td><a id="l661"></a><a href="#l661">661</a><td> */<tr><td><a id="l662"></a><a href="#l662">662</a><td>goog.uri.utils.buildQueryDataBuffer_ = function(<tr><td><a id="l663"></a><a href="#l663">663</a><td>    buffer, keysAndValues, opt_startIndex) {<tr><td><a id="l664"></a><a href="#l664">664</a><td>  goog.asserts.assert(Math.max(keysAndValues.length - (opt_startIndex || 0),<tr><td><a id="l665"></a><a href="#l665">665</a><td>      0) % 2 == 0, &#39;goog.uri.utils: Key/value lists must be even in length.&#39;);<tr><td><a id="l666"></a><a href="#l666">666</a><td><tr><td><a id="l667"></a><a href="#l667">667</a><td>  for (var i = opt_startIndex || 0; i &lt; keysAndValues.length; i += 2) {<tr><td><a id="l668"></a><a href="#l668">668</a><td>    goog.uri.utils.appendKeyValuePairs_(<tr><td><a id="l669"></a><a href="#l669">669</a><td>        keysAndValues[i], keysAndValues[i + 1], buffer);<tr><td><a id="l670"></a><a href="#l670">670</a><td>  }<tr><td><a id="l671"></a><a href="#l671">671</a><td><tr><td><a id="l672"></a><a href="#l672">672</a><td>  return buffer;<tr><td><a id="l673"></a><a href="#l673">673</a><td>};<tr><td><a id="l674"></a><a href="#l674">674</a><td><tr><td><a id="l675"></a><a href="#l675">675</a><td><tr><td><a id="l676"></a><a href="#l676">676</a><td>/**<tr><td><a id="l677"></a><a href="#l677">677</a><td> * Builds a query data string from a sequence of alternating keys and values.<tr><td><a id="l678"></a><a href="#l678">678</a><td> * Currently generates &quot;&amp;key&amp;&quot; for empty args.<tr><td><a id="l679"></a><a href="#l679">679</a><td> *<tr><td><a id="l680"></a><a href="#l680">680</a><td> * @param {goog.uri.utils.QueryArray} keysAndValues Alternating keys and<tr><td><a id="l681"></a><a href="#l681">681</a><td> *     values.  See the typedef.<tr><td><a id="l682"></a><a href="#l682">682</a><td> * @param {number=} opt_startIndex A start offset into the arary, defaults to 0.<tr><td><a id="l683"></a><a href="#l683">683</a><td> * @return {string} The encoded query string, in the form &#39;a=1&amp;b=2&#39;.<tr><td><a id="l684"></a><a href="#l684">684</a><td> */<tr><td><a id="l685"></a><a href="#l685">685</a><td>goog.uri.utils.buildQueryData = function(keysAndValues, opt_startIndex) {<tr><td><a id="l686"></a><a href="#l686">686</a><td>  var buffer = goog.uri.utils.buildQueryDataBuffer_(<tr><td><a id="l687"></a><a href="#l687">687</a><td>      [], keysAndValues, opt_startIndex);<tr><td><a id="l688"></a><a href="#l688">688</a><td>  buffer[0] = &#39;&#39;; // Remove the leading ampersand.<tr><td><a id="l689"></a><a href="#l689">689</a><td>  return buffer.join(&#39;&#39;);<tr><td><a id="l690"></a><a href="#l690">690</a><td>};<tr><td><a id="l691"></a><a href="#l691">691</a><td><tr><td><a id="l692"></a><a href="#l692">692</a><td><tr><td><a id="l693"></a><a href="#l693">693</a><td>/**<tr><td><a id="l694"></a><a href="#l694">694</a><td> * Builds a buffer of query data from a map.<tr><td><a id="l695"></a><a href="#l695">695</a><td> *<tr><td><a id="l696"></a><a href="#l696">696</a><td> * @param {!Array&lt;string|undefined&gt;} buffer A string buffer to append to.  The<tr><td><a id="l697"></a><a href="#l697">697</a><td> *     first element appended will be an &#39;&amp;&#39;, and may be replaced by the caller.<tr><td><a id="l698"></a><a href="#l698">698</a><td> * @param {!Object&lt;string, goog.uri.utils.QueryValue&gt;} map An object where keys<tr><td><a id="l699"></a><a href="#l699">699</a><td> *     are URI-encoded parameter keys, and the values conform to the contract<tr><td><a id="l700"></a><a href="#l700">700</a><td> *     specified in the goog.uri.utils.QueryValue typedef.<tr><td><a id="l701"></a><a href="#l701">701</a><td> * @return {!Array&lt;string|undefined&gt;} The buffer argument.<tr><td><a id="l702"></a><a href="#l702">702</a><td> * @private<tr><td><a id="l703"></a><a href="#l703">703</a><td> */<tr><td><a id="l704"></a><a href="#l704">704</a><td>goog.uri.utils.buildQueryDataBufferFromMap_ = function(buffer, map) {<tr><td><a id="l705"></a><a href="#l705">705</a><td>  for (var key in map) {<tr><td><a id="l706"></a><a href="#l706">706</a><td>    goog.uri.utils.appendKeyValuePairs_(key, map[key], buffer);<tr><td><a id="l707"></a><a href="#l707">707</a><td>  }<tr><td><a id="l708"></a><a href="#l708">708</a><td><tr><td><a id="l709"></a><a href="#l709">709</a><td>  return buffer;<tr><td><a id="l710"></a><a href="#l710">710</a><td>};<tr><td><a id="l711"></a><a href="#l711">711</a><td><tr><td><a id="l712"></a><a href="#l712">712</a><td><tr><td><a id="l713"></a><a href="#l713">713</a><td>/**<tr><td><a id="l714"></a><a href="#l714">714</a><td> * Builds a query data string from a map.<tr><td><a id="l715"></a><a href="#l715">715</a><td> * Currently generates &quot;&amp;key&amp;&quot; for empty args.<tr><td><a id="l716"></a><a href="#l716">716</a><td> *<tr><td><a id="l717"></a><a href="#l717">717</a><td> * @param {!Object&lt;string, goog.uri.utils.QueryValue&gt;} map An object where keys<tr><td><a id="l718"></a><a href="#l718">718</a><td> *     are URI-encoded parameter keys, and the values are arbitrary types<tr><td><a id="l719"></a><a href="#l719">719</a><td> *     or arrays. Keys with a null value are dropped.<tr><td><a id="l720"></a><a href="#l720">720</a><td> * @return {string} The encoded query string, in the form &#39;a=1&amp;b=2&#39;.<tr><td><a id="l721"></a><a href="#l721">721</a><td> */<tr><td><a id="l722"></a><a href="#l722">722</a><td>goog.uri.utils.buildQueryDataFromMap = function(map) {<tr><td><a id="l723"></a><a href="#l723">723</a><td>  var buffer = goog.uri.utils.buildQueryDataBufferFromMap_([], map);<tr><td><a id="l724"></a><a href="#l724">724</a><td>  buffer[0] = &#39;&#39;;<tr><td><a id="l725"></a><a href="#l725">725</a><td>  return buffer.join(&#39;&#39;);<tr><td><a id="l726"></a><a href="#l726">726</a><td>};<tr><td><a id="l727"></a><a href="#l727">727</a><td><tr><td><a id="l728"></a><a href="#l728">728</a><td><tr><td><a id="l729"></a><a href="#l729">729</a><td>/**<tr><td><a id="l730"></a><a href="#l730">730</a><td> * Appends URI parameters to an existing URI.<tr><td><a id="l731"></a><a href="#l731">731</a><td> *<tr><td><a id="l732"></a><a href="#l732">732</a><td> * The variable arguments may contain alternating keys and values.  Keys are<tr><td><a id="l733"></a><a href="#l733">733</a><td> * assumed to be already URI encoded.  The values should not be URI-encoded,<tr><td><a id="l734"></a><a href="#l734">734</a><td> * and will instead be encoded by this function.<tr><td><a id="l735"></a><a href="#l735">735</a><td> * &lt;pre&gt;<tr><td><a id="l736"></a><a href="#l736">736</a><td> * appendParams(&#39;http://www.foo.com?existing=true&#39;,<tr><td><a id="l737"></a><a href="#l737">737</a><td> *     &#39;key1&#39;, &#39;value1&#39;,<tr><td><a id="l738"></a><a href="#l738">738</a><td> *     &#39;key2&#39;, &#39;value?willBeEncoded&#39;,<tr><td><a id="l739"></a><a href="#l739">739</a><td> *     &#39;key3&#39;, [&#39;valueA&#39;, &#39;valueB&#39;, &#39;valueC&#39;],<tr><td><a id="l740"></a><a href="#l740">740</a><td> *     &#39;key4&#39;, null);<tr><td><a id="l741"></a><a href="#l741">741</a><td> * result: &#39;http://www.foo.com?existing=true&amp;&#39; +<tr><td><a id="l742"></a><a href="#l742">742</a><td> *     &#39;key1=value1&amp;&#39; +<tr><td><a id="l743"></a><a href="#l743">743</a><td> *     &#39;key2=value%3FwillBeEncoded&amp;&#39; +<tr><td><a id="l744"></a><a href="#l744">744</a><td> *     &#39;key3=valueA&amp;key3=valueB&amp;key3=valueC&#39;<tr><td><a id="l745"></a><a href="#l745">745</a><td> * &lt;/pre&gt;<tr><td><a id="l746"></a><a href="#l746">746</a><td> *<tr><td><a id="l747"></a><a href="#l747">747</a><td> * A single call to this function will not exhibit quadratic behavior in IE,<tr><td><a id="l748"></a><a href="#l748">748</a><td> * whereas multiple repeated calls may, although the effect is limited by<tr><td><a id="l749"></a><a href="#l749">749</a><td> * fact that URL&#39;s generally can&#39;t exceed 2kb.<tr><td><a id="l750"></a><a href="#l750">750</a><td> *<tr><td><a id="l751"></a><a href="#l751">751</a><td> * @param {string} uri The original URI, which may already have query data.<tr><td><a id="l752"></a><a href="#l752">752</a><td> * @param {...(goog.uri.utils.QueryArray|string|goog.uri.utils.QueryValue)} var_args<tr><td><a id="l753"></a><a href="#l753">753</a><td> *     An array or argument list conforming to goog.uri.utils.QueryArray.<tr><td><a id="l754"></a><a href="#l754">754</a><td> * @return {string} The URI with all query parameters added.<tr><td><a id="l755"></a><a href="#l755">755</a><td> */<tr><td><a id="l756"></a><a href="#l756">756</a><td>goog.uri.utils.appendParams = function(uri, var_args) {<tr><td><a id="l757"></a><a href="#l757">757</a><td>  return goog.uri.utils.appendQueryData_(<tr><td><a id="l758"></a><a href="#l758">758</a><td>      arguments.length == 2 ?<tr><td><a id="l759"></a><a href="#l759">759</a><td>      goog.uri.utils.buildQueryDataBuffer_([uri], arguments[1], 0) :<tr><td><a id="l760"></a><a href="#l760">760</a><td>      goog.uri.utils.buildQueryDataBuffer_([uri], arguments, 1));<tr><td><a id="l761"></a><a href="#l761">761</a><td>};<tr><td><a id="l762"></a><a href="#l762">762</a><td><tr><td><a id="l763"></a><a href="#l763">763</a><td><tr><td><a id="l764"></a><a href="#l764">764</a><td>/**<tr><td><a id="l765"></a><a href="#l765">765</a><td> * Appends query parameters from a map.<tr><td><a id="l766"></a><a href="#l766">766</a><td> *<tr><td><a id="l767"></a><a href="#l767">767</a><td> * @param {string} uri The original URI, which may already have query data.<tr><td><a id="l768"></a><a href="#l768">768</a><td> * @param {!Object&lt;goog.uri.utils.QueryValue&gt;} map An object where keys are<tr><td><a id="l769"></a><a href="#l769">769</a><td> *     URI-encoded parameter keys, and the values are arbitrary types or arrays.<tr><td><a id="l770"></a><a href="#l770">770</a><td> *     Keys with a null value are dropped.<tr><td><a id="l771"></a><a href="#l771">771</a><td> * @return {string} The new parameters.<tr><td><a id="l772"></a><a href="#l772">772</a><td> */<tr><td><a id="l773"></a><a href="#l773">773</a><td>goog.uri.utils.appendParamsFromMap = function(uri, map) {<tr><td><a id="l774"></a><a href="#l774">774</a><td>  return goog.uri.utils.appendQueryData_(<tr><td><a id="l775"></a><a href="#l775">775</a><td>      goog.uri.utils.buildQueryDataBufferFromMap_([uri], map));<tr><td><a id="l776"></a><a href="#l776">776</a><td>};<tr><td><a id="l777"></a><a href="#l777">777</a><td><tr><td><a id="l778"></a><a href="#l778">778</a><td><tr><td><a id="l779"></a><a href="#l779">779</a><td>/**<tr><td><a id="l780"></a><a href="#l780">780</a><td> * Appends a single URI parameter.<tr><td><a id="l781"></a><a href="#l781">781</a><td> *<tr><td><a id="l782"></a><a href="#l782">782</a><td> * Repeated calls to this can exhibit quadratic behavior in IE6 due to the<tr><td><a id="l783"></a><a href="#l783">783</a><td> * way string append works, though it should be limited given the 2kb limit.<tr><td><a id="l784"></a><a href="#l784">784</a><td> *<tr><td><a id="l785"></a><a href="#l785">785</a><td> * @param {string} uri The original URI, which may already have query data.<tr><td><a id="l786"></a><a href="#l786">786</a><td> * @param {string} key The key, which must already be URI encoded.<tr><td><a id="l787"></a><a href="#l787">787</a><td> * @param {*=} opt_value The value, which will be stringized and encoded<tr><td><a id="l788"></a><a href="#l788">788</a><td> *     (assumed not already to be encoded).  If omitted, undefined, or null, the<tr><td><a id="l789"></a><a href="#l789">789</a><td> *     key will be added as a valueless parameter.<tr><td><a id="l790"></a><a href="#l790">790</a><td> * @return {string} The URI with the query parameter added.<tr><td><a id="l791"></a><a href="#l791">791</a><td> */<tr><td><a id="l792"></a><a href="#l792">792</a><td>goog.uri.utils.appendParam = function(uri, key, opt_value) {<tr><td><a id="l793"></a><a href="#l793">793</a><td>  var paramArr = [uri, &#39;&amp;&#39;, key];<tr><td><a id="l794"></a><a href="#l794">794</a><td>  if (goog.isDefAndNotNull(opt_value)) {<tr><td><a id="l795"></a><a href="#l795">795</a><td>    paramArr.push(&#39;=&#39;, goog.string.urlEncode(opt_value));<tr><td><a id="l796"></a><a href="#l796">796</a><td>  }<tr><td><a id="l797"></a><a href="#l797">797</a><td>  return goog.uri.utils.appendQueryData_(paramArr);<tr><td><a id="l798"></a><a href="#l798">798</a><td>};<tr><td><a id="l799"></a><a href="#l799">799</a><td><tr><td><a id="l800"></a><a href="#l800">800</a><td><tr><td><a id="l801"></a><a href="#l801">801</a><td>/**<tr><td><a id="l802"></a><a href="#l802">802</a><td> * Finds the next instance of a query parameter with the specified name.<tr><td><a id="l803"></a><a href="#l803">803</a><td> *<tr><td><a id="l804"></a><a href="#l804">804</a><td> * Does not instantiate any objects.<tr><td><a id="l805"></a><a href="#l805">805</a><td> *<tr><td><a id="l806"></a><a href="#l806">806</a><td> * @param {string} uri The URI to search.  May contain a fragment identifier<tr><td><a id="l807"></a><a href="#l807">807</a><td> *     if opt_hashIndex is specified.<tr><td><a id="l808"></a><a href="#l808">808</a><td> * @param {number} startIndex The index to begin searching for the key at.  A<tr><td><a id="l809"></a><a href="#l809">809</a><td> *     match may be found even if this is one character after the ampersand.<tr><td><a id="l810"></a><a href="#l810">810</a><td> * @param {string} keyEncoded The URI-encoded key.<tr><td><a id="l811"></a><a href="#l811">811</a><td> * @param {number} hashOrEndIndex Index to stop looking at.  If a hash<tr><td><a id="l812"></a><a href="#l812">812</a><td> *     mark is present, it should be its index, otherwise it should be the<tr><td><a id="l813"></a><a href="#l813">813</a><td> *     length of the string.<tr><td><a id="l814"></a><a href="#l814">814</a><td> * @return {number} The position of the first character in the key&#39;s name,<tr><td><a id="l815"></a><a href="#l815">815</a><td> *     immediately after either a question mark or a dot.<tr><td><a id="l816"></a><a href="#l816">816</a><td> * @private<tr><td><a id="l817"></a><a href="#l817">817</a><td> */<tr><td><a id="l818"></a><a href="#l818">818</a><td>goog.uri.utils.findParam_ = function(<tr><td><a id="l819"></a><a href="#l819">819</a><td>    uri, startIndex, keyEncoded, hashOrEndIndex) {<tr><td><a id="l820"></a><a href="#l820">820</a><td>  var index = startIndex;<tr><td><a id="l821"></a><a href="#l821">821</a><td>  var keyLength = keyEncoded.length;<tr><td><a id="l822"></a><a href="#l822">822</a><td><tr><td><a id="l823"></a><a href="#l823">823</a><td>  // Search for the key itself and post-filter for surronuding punctuation,<tr><td><a id="l824"></a><a href="#l824">824</a><td>  // rather than expensively building a regexp.<tr><td><a id="l825"></a><a href="#l825">825</a><td>  while ((index = uri.indexOf(keyEncoded, index)) &gt;= 0 &amp;&amp;<tr><td><a id="l826"></a><a href="#l826">826</a><td>      index &lt; hashOrEndIndex) {<tr><td><a id="l827"></a><a href="#l827">827</a><td>    var precedingChar = uri.charCodeAt(index - 1);<tr><td><a id="l828"></a><a href="#l828">828</a><td>    // Ensure that the preceding character is &#39;&amp;&#39; or &#39;?&#39;.<tr><td><a id="l829"></a><a href="#l829">829</a><td>    if (precedingChar == goog.uri.utils.CharCode_.AMPERSAND ||<tr><td><a id="l830"></a><a href="#l830">830</a><td>        precedingChar == goog.uri.utils.CharCode_.QUESTION) {<tr><td><a id="l831"></a><a href="#l831">831</a><td>      // Ensure the following character is &#39;&amp;&#39;, &#39;=&#39;, &#39;#&#39;, or NaN<tr><td><a id="l832"></a><a href="#l832">832</a><td>      // (end of string).<tr><td><a id="l833"></a><a href="#l833">833</a><td>      var followingChar = uri.charCodeAt(index + keyLength);<tr><td><a id="l834"></a><a href="#l834">834</a><td>      if (!followingChar ||<tr><td><a id="l835"></a><a href="#l835">835</a><td>          followingChar == goog.uri.utils.CharCode_.EQUAL ||<tr><td><a id="l836"></a><a href="#l836">836</a><td>          followingChar == goog.uri.utils.CharCode_.AMPERSAND ||<tr><td><a id="l837"></a><a href="#l837">837</a><td>          followingChar == goog.uri.utils.CharCode_.HASH) {<tr><td><a id="l838"></a><a href="#l838">838</a><td>        return index;<tr><td><a id="l839"></a><a href="#l839">839</a><td>      }<tr><td><a id="l840"></a><a href="#l840">840</a><td>    }<tr><td><a id="l841"></a><a href="#l841">841</a><td>    index += keyLength + 1;<tr><td><a id="l842"></a><a href="#l842">842</a><td>  }<tr><td><a id="l843"></a><a href="#l843">843</a><td><tr><td><a id="l844"></a><a href="#l844">844</a><td>  return -1;<tr><td><a id="l845"></a><a href="#l845">845</a><td>};<tr><td><a id="l846"></a><a href="#l846">846</a><td><tr><td><a id="l847"></a><a href="#l847">847</a><td><tr><td><a id="l848"></a><a href="#l848">848</a><td>/**<tr><td><a id="l849"></a><a href="#l849">849</a><td> * Regular expression for finding a hash mark or end of string.<tr><td><a id="l850"></a><a href="#l850">850</a><td> * @type {RegExp}<tr><td><a id="l851"></a><a href="#l851">851</a><td> * @private<tr><td><a id="l852"></a><a href="#l852">852</a><td> */<tr><td><a id="l853"></a><a href="#l853">853</a><td>goog.uri.utils.hashOrEndRe_ = /#|$/;<tr><td><a id="l854"></a><a href="#l854">854</a><td><tr><td><a id="l855"></a><a href="#l855">855</a><td><tr><td><a id="l856"></a><a href="#l856">856</a><td>/**<tr><td><a id="l857"></a><a href="#l857">857</a><td> * Determines if the URI contains a specific key.<tr><td><a id="l858"></a><a href="#l858">858</a><td> *<tr><td><a id="l859"></a><a href="#l859">859</a><td> * Performs no object instantiations.<tr><td><a id="l860"></a><a href="#l860">860</a><td> *<tr><td><a id="l861"></a><a href="#l861">861</a><td> * @param {string} uri The URI to process.  May contain a fragment<tr><td><a id="l862"></a><a href="#l862">862</a><td> *     identifier.<tr><td><a id="l863"></a><a href="#l863">863</a><td> * @param {string} keyEncoded The URI-encoded key.  Case-sensitive.<tr><td><a id="l864"></a><a href="#l864">864</a><td> * @return {boolean} Whether the key is present.<tr><td><a id="l865"></a><a href="#l865">865</a><td> */<tr><td><a id="l866"></a><a href="#l866">866</a><td>goog.uri.utils.hasParam = function(uri, keyEncoded) {<tr><td><a id="l867"></a><a href="#l867">867</a><td>  return goog.uri.utils.findParam_(uri, 0, keyEncoded,<tr><td><a id="l868"></a><a href="#l868">868</a><td>      uri.search(goog.uri.utils.hashOrEndRe_)) &gt;= 0;<tr><td><a id="l869"></a><a href="#l869">869</a><td>};<tr><td><a id="l870"></a><a href="#l870">870</a><td><tr><td><a id="l871"></a><a href="#l871">871</a><td><tr><td><a id="l872"></a><a href="#l872">872</a><td>/**<tr><td><a id="l873"></a><a href="#l873">873</a><td> * Gets the first value of a query parameter.<tr><td><a id="l874"></a><a href="#l874">874</a><td> * @param {string} uri The URI to process.  May contain a fragment.<tr><td><a id="l875"></a><a href="#l875">875</a><td> * @param {string} keyEncoded The URI-encoded key.  Case-sensitive.<tr><td><a id="l876"></a><a href="#l876">876</a><td> * @return {?string} The first value of the parameter (URI-decoded), or null<tr><td><a id="l877"></a><a href="#l877">877</a><td> *     if the parameter is not found.<tr><td><a id="l878"></a><a href="#l878">878</a><td> */<tr><td><a id="l879"></a><a href="#l879">879</a><td>goog.uri.utils.getParamValue = function(uri, keyEncoded) {<tr><td><a id="l880"></a><a href="#l880">880</a><td>  var hashOrEndIndex = uri.search(goog.uri.utils.hashOrEndRe_);<tr><td><a id="l881"></a><a href="#l881">881</a><td>  var foundIndex = goog.uri.utils.findParam_(<tr><td><a id="l882"></a><a href="#l882">882</a><td>      uri, 0, keyEncoded, hashOrEndIndex);<tr><td><a id="l883"></a><a href="#l883">883</a><td><tr><td><a id="l884"></a><a href="#l884">884</a><td>  if (foundIndex &lt; 0) {<tr><td><a id="l885"></a><a href="#l885">885</a><td>    return null;<tr><td><a id="l886"></a><a href="#l886">886</a><td>  } else {<tr><td><a id="l887"></a><a href="#l887">887</a><td>    var endPosition = uri.indexOf(&#39;&amp;&#39;, foundIndex);<tr><td><a id="l888"></a><a href="#l888">888</a><td>    if (endPosition &lt; 0 || endPosition &gt; hashOrEndIndex) {<tr><td><a id="l889"></a><a href="#l889">889</a><td>      endPosition = hashOrEndIndex;<tr><td><a id="l890"></a><a href="#l890">890</a><td>    }<tr><td><a id="l891"></a><a href="#l891">891</a><td>    // Progress forth to the end of the &quot;key=&quot; or &quot;key&amp;&quot; substring.<tr><td><a id="l892"></a><a href="#l892">892</a><td>    foundIndex += keyEncoded.length + 1;<tr><td><a id="l893"></a><a href="#l893">893</a><td>    // Use substr, because it (unlike substring) will return empty string<tr><td><a id="l894"></a><a href="#l894">894</a><td>    // if foundIndex &gt; endPosition.<tr><td><a id="l895"></a><a href="#l895">895</a><td>    return goog.string.urlDecode(<tr><td><a id="l896"></a><a href="#l896">896</a><td>        uri.substr(foundIndex, endPosition - foundIndex));<tr><td><a id="l897"></a><a href="#l897">897</a><td>  }<tr><td><a id="l898"></a><a href="#l898">898</a><td>};<tr><td><a id="l899"></a><a href="#l899">899</a><td><tr><td><a id="l900"></a><a href="#l900">900</a><td><tr><td><a id="l901"></a><a href="#l901">901</a><td>/**<tr><td><a id="l902"></a><a href="#l902">902</a><td> * Gets all values of a query parameter.<tr><td><a id="l903"></a><a href="#l903">903</a><td> * @param {string} uri The URI to process.  May contain a fragment.<tr><td><a id="l904"></a><a href="#l904">904</a><td> * @param {string} keyEncoded The URI-encoded key.  Case-sensitive.<tr><td><a id="l905"></a><a href="#l905">905</a><td> * @return {!Array&lt;string&gt;} All URI-decoded values with the given key.<tr><td><a id="l906"></a><a href="#l906">906</a><td> *     If the key is not found, this will have length 0, but never be null.<tr><td><a id="l907"></a><a href="#l907">907</a><td> */<tr><td><a id="l908"></a><a href="#l908">908</a><td>goog.uri.utils.getParamValues = function(uri, keyEncoded) {<tr><td><a id="l909"></a><a href="#l909">909</a><td>  var hashOrEndIndex = uri.search(goog.uri.utils.hashOrEndRe_);<tr><td><a id="l910"></a><a href="#l910">910</a><td>  var position = 0;<tr><td><a id="l911"></a><a href="#l911">911</a><td>  var foundIndex;<tr><td><a id="l912"></a><a href="#l912">912</a><td>  var result = [];<tr><td><a id="l913"></a><a href="#l913">913</a><td><tr><td><a id="l914"></a><a href="#l914">914</a><td>  while ((foundIndex = goog.uri.utils.findParam_(<tr><td><a id="l915"></a><a href="#l915">915</a><td>      uri, position, keyEncoded, hashOrEndIndex)) &gt;= 0) {<tr><td><a id="l916"></a><a href="#l916">916</a><td>    // Find where this parameter ends, either the &#39;&amp;&#39; or the end of the<tr><td><a id="l917"></a><a href="#l917">917</a><td>    // query parameters.<tr><td><a id="l918"></a><a href="#l918">918</a><td>    position = uri.indexOf(&#39;&amp;&#39;, foundIndex);<tr><td><a id="l919"></a><a href="#l919">919</a><td>    if (position &lt; 0 || position &gt; hashOrEndIndex) {<tr><td><a id="l920"></a><a href="#l920">920</a><td>      position = hashOrEndIndex;<tr><td><a id="l921"></a><a href="#l921">921</a><td>    }<tr><td><a id="l922"></a><a href="#l922">922</a><td><tr><td><a id="l923"></a><a href="#l923">923</a><td>    // Progress forth to the end of the &quot;key=&quot; or &quot;key&amp;&quot; substring.<tr><td><a id="l924"></a><a href="#l924">924</a><td>    foundIndex += keyEncoded.length + 1;<tr><td><a id="l925"></a><a href="#l925">925</a><td>    // Use substr, because it (unlike substring) will return empty string<tr><td><a id="l926"></a><a href="#l926">926</a><td>    // if foundIndex &gt; position.<tr><td><a id="l927"></a><a href="#l927">927</a><td>    result.push(goog.string.urlDecode(uri.substr(<tr><td><a id="l928"></a><a href="#l928">928</a><td>        foundIndex, position - foundIndex)));<tr><td><a id="l929"></a><a href="#l929">929</a><td>  }<tr><td><a id="l930"></a><a href="#l930">930</a><td><tr><td><a id="l931"></a><a href="#l931">931</a><td>  return result;<tr><td><a id="l932"></a><a href="#l932">932</a><td>};<tr><td><a id="l933"></a><a href="#l933">933</a><td><tr><td><a id="l934"></a><a href="#l934">934</a><td><tr><td><a id="l935"></a><a href="#l935">935</a><td>/**<tr><td><a id="l936"></a><a href="#l936">936</a><td> * Regexp to find trailing question marks and ampersands.<tr><td><a id="l937"></a><a href="#l937">937</a><td> * @type {RegExp}<tr><td><a id="l938"></a><a href="#l938">938</a><td> * @private<tr><td><a id="l939"></a><a href="#l939">939</a><td> */<tr><td><a id="l940"></a><a href="#l940">940</a><td>goog.uri.utils.trailingQueryPunctuationRe_ = /[?&amp;]($|#)/;<tr><td><a id="l941"></a><a href="#l941">941</a><td><tr><td><a id="l942"></a><a href="#l942">942</a><td><tr><td><a id="l943"></a><a href="#l943">943</a><td>/**<tr><td><a id="l944"></a><a href="#l944">944</a><td> * Removes all instances of a query parameter.<tr><td><a id="l945"></a><a href="#l945">945</a><td> * @param {string} uri The URI to process.  Must not contain a fragment.<tr><td><a id="l946"></a><a href="#l946">946</a><td> * @param {string} keyEncoded The URI-encoded key.<tr><td><a id="l947"></a><a href="#l947">947</a><td> * @return {string} The URI with all instances of the parameter removed.<tr><td><a id="l948"></a><a href="#l948">948</a><td> */<tr><td><a id="l949"></a><a href="#l949">949</a><td>goog.uri.utils.removeParam = function(uri, keyEncoded) {<tr><td><a id="l950"></a><a href="#l950">950</a><td>  var hashOrEndIndex = uri.search(goog.uri.utils.hashOrEndRe_);<tr><td><a id="l951"></a><a href="#l951">951</a><td>  var position = 0;<tr><td><a id="l952"></a><a href="#l952">952</a><td>  var foundIndex;<tr><td><a id="l953"></a><a href="#l953">953</a><td>  var buffer = [];<tr><td><a id="l954"></a><a href="#l954">954</a><td><tr><td><a id="l955"></a><a href="#l955">955</a><td>  // Look for a query parameter.<tr><td><a id="l956"></a><a href="#l956">956</a><td>  while ((foundIndex = goog.uri.utils.findParam_(<tr><td><a id="l957"></a><a href="#l957">957</a><td>      uri, position, keyEncoded, hashOrEndIndex)) &gt;= 0) {<tr><td><a id="l958"></a><a href="#l958">958</a><td>    // Get the portion of the query string up to, but not including, the ?<tr><td><a id="l959"></a><a href="#l959">959</a><td>    // or &amp; starting the parameter.<tr><td><a id="l960"></a><a href="#l960">960</a><td>    buffer.push(uri.substring(position, foundIndex));<tr><td><a id="l961"></a><a href="#l961">961</a><td>    // Progress to immediately after the &#39;&amp;&#39;.  If not found, go to the end.<tr><td><a id="l962"></a><a href="#l962">962</a><td>    // Avoid including the hash mark.<tr><td><a id="l963"></a><a href="#l963">963</a><td>    position = Math.min((uri.indexOf(&#39;&amp;&#39;, foundIndex) + 1) || hashOrEndIndex,<tr><td><a id="l964"></a><a href="#l964">964</a><td>        hashOrEndIndex);<tr><td><a id="l965"></a><a href="#l965">965</a><td>  }<tr><td><a id="l966"></a><a href="#l966">966</a><td><tr><td><a id="l967"></a><a href="#l967">967</a><td>  // Append everything that is remaining.<tr><td><a id="l968"></a><a href="#l968">968</a><td>  buffer.push(uri.substr(position));<tr><td><a id="l969"></a><a href="#l969">969</a><td><tr><td><a id="l970"></a><a href="#l970">970</a><td>  // Join the buffer, and remove trailing punctuation that remains.<tr><td><a id="l971"></a><a href="#l971">971</a><td>  return buffer.join(&#39;&#39;).replace(<tr><td><a id="l972"></a><a href="#l972">972</a><td>      goog.uri.utils.trailingQueryPunctuationRe_, &#39;$1&#39;);<tr><td><a id="l973"></a><a href="#l973">973</a><td>};<tr><td><a id="l974"></a><a href="#l974">974</a><td><tr><td><a id="l975"></a><a href="#l975">975</a><td><tr><td><a id="l976"></a><a href="#l976">976</a><td>/**<tr><td><a id="l977"></a><a href="#l977">977</a><td> * Replaces all existing definitions of a parameter with a single definition.<tr><td><a id="l978"></a><a href="#l978">978</a><td> *<tr><td><a id="l979"></a><a href="#l979">979</a><td> * Repeated calls to this can exhibit quadratic behavior due to the need to<tr><td><a id="l980"></a><a href="#l980">980</a><td> * find existing instances and reconstruct the string, though it should be<tr><td><a id="l981"></a><a href="#l981">981</a><td> * limited given the 2kb limit.  Consider using appendParams to append multiple<tr><td><a id="l982"></a><a href="#l982">982</a><td> * parameters in bulk.<tr><td><a id="l983"></a><a href="#l983">983</a><td> *<tr><td><a id="l984"></a><a href="#l984">984</a><td> * @param {string} uri The original URI, which may already have query data.<tr><td><a id="l985"></a><a href="#l985">985</a><td> * @param {string} keyEncoded The key, which must already be URI encoded.<tr><td><a id="l986"></a><a href="#l986">986</a><td> * @param {*} value The value, which will be stringized and encoded (assumed<tr><td><a id="l987"></a><a href="#l987">987</a><td> *     not already to be encoded).<tr><td><a id="l988"></a><a href="#l988">988</a><td> * @return {string} The URI with the query parameter added.<tr><td><a id="l989"></a><a href="#l989">989</a><td> */<tr><td><a id="l990"></a><a href="#l990">990</a><td>goog.uri.utils.setParam = function(uri, keyEncoded, value) {<tr><td><a id="l991"></a><a href="#l991">991</a><td>  return goog.uri.utils.appendParam(<tr><td><a id="l992"></a><a href="#l992">992</a><td>      goog.uri.utils.removeParam(uri, keyEncoded), keyEncoded, value);<tr><td><a id="l993"></a><a href="#l993">993</a><td>};<tr><td><a id="l994"></a><a href="#l994">994</a><td><tr><td><a id="l995"></a><a href="#l995">995</a><td><tr><td><a id="l996"></a><a href="#l996">996</a><td>/**<tr><td><a id="l997"></a><a href="#l997">997</a><td> * Generates a URI path using a given URI and a path with checks to<tr><td><a id="l998"></a><a href="#l998">998</a><td> * prevent consecutive &quot;//&quot;. The baseUri passed in must not contain<tr><td><a id="l999"></a><a href="#l999">999</a><td> * query or fragment identifiers. The path to append may not contain query or<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td> * fragment identifiers.<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td> *<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td> * @param {string} baseUri URI to use as the base.<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td> * @param {string} path Path to append.<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td> * @return {string} Updated URI.<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td> */<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td>goog.uri.utils.appendPath = function(baseUri, path) {<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>  goog.uri.utils.assertNoFragmentsOrQueries_(baseUri);<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td><tr><td><a id="l1009"></a><a href="#l1009">1009</a><td>  // Remove any trailing &#39;/&#39;<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td>  if (goog.string.endsWith(baseUri, &#39;/&#39;)) {<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td>    baseUri = baseUri.substr(0, baseUri.length - 1);<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td>  }<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td>  // Remove any leading &#39;/&#39;<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td>  if (goog.string.startsWith(path, &#39;/&#39;)) {<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>    path = path.substr(1);<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td>  }<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td>  return goog.string.buildString(baseUri, &#39;/&#39;, path);<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td>};<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td><tr><td><a id="l1020"></a><a href="#l1020">1020</a><td><tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>/**<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td> * Replaces the path.<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td> * @param {string} uri URI to use as the base.<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td> * @param {string} path New path.<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td> * @return {string} Updated URI.<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td> */<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>goog.uri.utils.setPath = function(uri, path) {<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>  // Add any missing &#39;/&#39;.<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td>  if (!goog.string.startsWith(path, &#39;/&#39;)) {<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>    path = &#39;/&#39; + path;<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td>  }<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td>  var parts = goog.uri.utils.split(uri);<tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>  return goog.uri.utils.buildFromEncodedParts(<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>      parts[goog.uri.utils.ComponentIndex.SCHEME],<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td>      parts[goog.uri.utils.ComponentIndex.USER_INFO],<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>      parts[goog.uri.utils.ComponentIndex.DOMAIN],<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td>      parts[goog.uri.utils.ComponentIndex.PORT],<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td>      path,<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>      parts[goog.uri.utils.ComponentIndex.QUERY_DATA],<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>      parts[goog.uri.utils.ComponentIndex.FRAGMENT]);<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td>};<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td><tr><td><a id="l1043"></a><a href="#l1043">1043</a><td><tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>/**<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td> * Standard supported query parameters.<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td> * @enum {string}<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td> */<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>goog.uri.utils.StandardQueryParam = {<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td><tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>  /** Unused parameter for unique-ifying. */<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td>  RANDOM: &#39;zx&#39;<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td>};<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td><tr><td><a id="l1054"></a><a href="#l1054">1054</a><td><tr><td><a id="l1055"></a><a href="#l1055">1055</a><td>/**<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td> * Sets the zx parameter of a URI to a random value.<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td> * @param {string} uri Any URI.<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td> * @return {string} That URI with the &quot;zx&quot; parameter added or replaced to<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td> *     contain a random string.<tr><td><a id="l1060"></a><a href="#l1060">1060</a><td> */<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td>goog.uri.utils.makeUnique = function(uri) {<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td>  return goog.uri.utils.setParam(uri,<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td>      goog.uri.utils.StandardQueryParam.RANDOM, goog.string.getRandomString());<tr><td><a id="l1064"></a><a href="#l1064">1064</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/useragent/product.js.src.html b/docs/source/lib/goog/useragent/product.js.src.html
index 1ff8b1c..244d4d3 100644
--- a/docs/source/lib/goog/useragent/product.js.src.html
+++ b/docs/source/lib/goog/useragent/product.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>product.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/useragent/product.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Detects the specific browser and not just the rendering engine.<tr><td><a name="l17" href="#l17">17</a><td> *<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;goog.userAgent.product&#39;);<tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * @define {boolean} Whether the code is running on the Firefox web browser.<tr><td><a name="l27" href="#l27">27</a><td> */<tr><td><a name="l28" href="#l28">28</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_FIREFOX&#39;, false);<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>/**<tr><td><a name="l32" href="#l32">32</a><td> * @define {boolean} Whether the code is running on the Camino web browser.<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_CAMINO&#39;, false);<tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td>/**<tr><td><a name="l38" href="#l38">38</a><td> * @define {boolean} Whether we know at compile-time that the product is an<tr><td><a name="l39" href="#l39">39</a><td> *     iPhone.<tr><td><a name="l40" href="#l40">40</a><td> */<tr><td><a name="l41" href="#l41">41</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_IPHONE&#39;, false);<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td>/**<tr><td><a name="l45" href="#l45">45</a><td> * @define {boolean} Whether we know at compile-time that the product is an<tr><td><a name="l46" href="#l46">46</a><td> *     iPad.<tr><td><a name="l47" href="#l47">47</a><td> */<tr><td><a name="l48" href="#l48">48</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_IPAD&#39;, false);<tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td>/**<tr><td><a name="l52" href="#l52">52</a><td> * @define {boolean} Whether we know at compile-time that the product is an<tr><td><a name="l53" href="#l53">53</a><td> *     Android phone.<tr><td><a name="l54" href="#l54">54</a><td> */<tr><td><a name="l55" href="#l55">55</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_ANDROID&#39;, false);<tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td>/**<tr><td><a name="l59" href="#l59">59</a><td> * @define {boolean} Whether the code is running on the Chrome web browser.<tr><td><a name="l60" href="#l60">60</a><td> */<tr><td><a name="l61" href="#l61">61</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_CHROME&#39;, false);<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/**<tr><td><a name="l65" href="#l65">65</a><td> * @define {boolean} Whether the code is running on the Safari web browser.<tr><td><a name="l66" href="#l66">66</a><td> */<tr><td><a name="l67" href="#l67">67</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_SAFARI&#39;, false);<tr><td><a name="l68" href="#l68">68</a><td><tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td>/**<tr><td><a name="l71" href="#l71">71</a><td> * Whether we know the product type at compile-time.<tr><td><a name="l72" href="#l72">72</a><td> * @type {boolean}<tr><td><a name="l73" href="#l73">73</a><td> * @private<tr><td><a name="l74" href="#l74">74</a><td> */<tr><td><a name="l75" href="#l75">75</a><td>goog.userAgent.product.PRODUCT_KNOWN_ =<tr><td><a name="l76" href="#l76">76</a><td>    goog.userAgent.ASSUME_IE ||<tr><td><a name="l77" href="#l77">77</a><td>    goog.userAgent.ASSUME_OPERA ||<tr><td><a name="l78" href="#l78">78</a><td>    goog.userAgent.product.ASSUME_FIREFOX ||<tr><td><a name="l79" href="#l79">79</a><td>    goog.userAgent.product.ASSUME_CAMINO ||<tr><td><a name="l80" href="#l80">80</a><td>    goog.userAgent.product.ASSUME_IPHONE ||<tr><td><a name="l81" href="#l81">81</a><td>    goog.userAgent.product.ASSUME_IPAD ||<tr><td><a name="l82" href="#l82">82</a><td>    goog.userAgent.product.ASSUME_ANDROID ||<tr><td><a name="l83" href="#l83">83</a><td>    goog.userAgent.product.ASSUME_CHROME ||<tr><td><a name="l84" href="#l84">84</a><td>    goog.userAgent.product.ASSUME_SAFARI;<tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td><tr><td><a name="l87" href="#l87">87</a><td>/**<tr><td><a name="l88" href="#l88">88</a><td> * Right now we just focus on Tier 1-3 browsers at:<tr><td><a name="l89" href="#l89">89</a><td> * http://wiki/Nonconf/ProductPlatformGuidelines<tr><td><a name="l90" href="#l90">90</a><td> * As well as the YUI grade A browsers at:<tr><td><a name="l91" href="#l91">91</a><td> * http://developer.yahoo.com/yui/articles/gbs/<tr><td><a name="l92" href="#l92">92</a><td> *<tr><td><a name="l93" href="#l93">93</a><td> * @private<tr><td><a name="l94" href="#l94">94</a><td> */<tr><td><a name="l95" href="#l95">95</a><td>goog.userAgent.product.init_ = function() {<tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>  /**<tr><td><a name="l98" href="#l98">98</a><td>   * Whether the code is running on the Firefox web browser.<tr><td><a name="l99" href="#l99">99</a><td>   * @type {boolean}<tr><td><a name="l100" href="#l100">100</a><td>   * @private<tr><td><a name="l101" href="#l101">101</a><td>   */<tr><td><a name="l102" href="#l102">102</a><td>  goog.userAgent.product.detectedFirefox_ = false;<tr><td><a name="l103" href="#l103">103</a><td><tr><td><a name="l104" href="#l104">104</a><td>  /**<tr><td><a name="l105" href="#l105">105</a><td>   * Whether the code is running on the Camino web browser.<tr><td><a name="l106" href="#l106">106</a><td>   * @type {boolean}<tr><td><a name="l107" href="#l107">107</a><td>   * @private<tr><td><a name="l108" href="#l108">108</a><td>   */<tr><td><a name="l109" href="#l109">109</a><td>  goog.userAgent.product.detectedCamino_ = false;<tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td>  /**<tr><td><a name="l112" href="#l112">112</a><td>   * Whether the code is running on an iPhone or iPod touch.<tr><td><a name="l113" href="#l113">113</a><td>   * @type {boolean}<tr><td><a name="l114" href="#l114">114</a><td>   * @private<tr><td><a name="l115" href="#l115">115</a><td>   */<tr><td><a name="l116" href="#l116">116</a><td>  goog.userAgent.product.detectedIphone_ = false;<tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td>  /**<tr><td><a name="l119" href="#l119">119</a><td>   * Whether the code is running on an iPad<tr><td><a name="l120" href="#l120">120</a><td>   * @type {boolean}<tr><td><a name="l121" href="#l121">121</a><td>   * @private<tr><td><a name="l122" href="#l122">122</a><td>   */<tr><td><a name="l123" href="#l123">123</a><td>  goog.userAgent.product.detectedIpad_ = false;<tr><td><a name="l124" href="#l124">124</a><td><tr><td><a name="l125" href="#l125">125</a><td>  /**<tr><td><a name="l126" href="#l126">126</a><td>   * Whether the code is running on the default browser on an Android phone.<tr><td><a name="l127" href="#l127">127</a><td>   * @type {boolean}<tr><td><a name="l128" href="#l128">128</a><td>   * @private<tr><td><a name="l129" href="#l129">129</a><td>   */<tr><td><a name="l130" href="#l130">130</a><td>  goog.userAgent.product.detectedAndroid_ = false;<tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td>  /**<tr><td><a name="l133" href="#l133">133</a><td>   * Whether the code is running on the Chrome web browser.<tr><td><a name="l134" href="#l134">134</a><td>   * @type {boolean}<tr><td><a name="l135" href="#l135">135</a><td>   * @private<tr><td><a name="l136" href="#l136">136</a><td>   */<tr><td><a name="l137" href="#l137">137</a><td>  goog.userAgent.product.detectedChrome_ = false;<tr><td><a name="l138" href="#l138">138</a><td><tr><td><a name="l139" href="#l139">139</a><td>  /**<tr><td><a name="l140" href="#l140">140</a><td>   * Whether the code is running on the Safari web browser.<tr><td><a name="l141" href="#l141">141</a><td>   * @type {boolean}<tr><td><a name="l142" href="#l142">142</a><td>   * @private<tr><td><a name="l143" href="#l143">143</a><td>   */<tr><td><a name="l144" href="#l144">144</a><td>  goog.userAgent.product.detectedSafari_ = false;<tr><td><a name="l145" href="#l145">145</a><td><tr><td><a name="l146" href="#l146">146</a><td>  var ua = goog.userAgent.getUserAgentString();<tr><td><a name="l147" href="#l147">147</a><td>  if (!ua) {<tr><td><a name="l148" href="#l148">148</a><td>    return;<tr><td><a name="l149" href="#l149">149</a><td>  }<tr><td><a name="l150" href="#l150">150</a><td><tr><td><a name="l151" href="#l151">151</a><td>  // The order of the if-statements in the following code is important.<tr><td><a name="l152" href="#l152">152</a><td>  // For example, in the WebKit section, we put Chrome in front of Safari<tr><td><a name="l153" href="#l153">153</a><td>  // because the string &#39;Safari&#39; is present on both of those browsers&#39;<tr><td><a name="l154" href="#l154">154</a><td>  // userAgent strings as well as the string we are looking for.<tr><td><a name="l155" href="#l155">155</a><td>  // The idea is to prevent accidental detection of more than one client.<tr><td><a name="l156" href="#l156">156</a><td><tr><td><a name="l157" href="#l157">157</a><td>  if (ua.indexOf(&#39;Firefox&#39;) != -1) {<tr><td><a name="l158" href="#l158">158</a><td>    goog.userAgent.product.detectedFirefox_ = true;<tr><td><a name="l159" href="#l159">159</a><td>  } else if (ua.indexOf(&#39;Camino&#39;) != -1) {<tr><td><a name="l160" href="#l160">160</a><td>    goog.userAgent.product.detectedCamino_ = true;<tr><td><a name="l161" href="#l161">161</a><td>  } else if (ua.indexOf(&#39;iPhone&#39;) != -1 || ua.indexOf(&#39;iPod&#39;) != -1) {<tr><td><a name="l162" href="#l162">162</a><td>    goog.userAgent.product.detectedIphone_ = true;<tr><td><a name="l163" href="#l163">163</a><td>  } else if (ua.indexOf(&#39;iPad&#39;) != -1) {<tr><td><a name="l164" href="#l164">164</a><td>    goog.userAgent.product.detectedIpad_ = true;<tr><td><a name="l165" href="#l165">165</a><td>  } else if (ua.indexOf(&#39;Android&#39;) != -1) {<tr><td><a name="l166" href="#l166">166</a><td>    goog.userAgent.product.detectedAndroid_ = true;<tr><td><a name="l167" href="#l167">167</a><td>  } else if (ua.indexOf(&#39;Chrome&#39;) != -1) {<tr><td><a name="l168" href="#l168">168</a><td>    goog.userAgent.product.detectedChrome_ = true;<tr><td><a name="l169" href="#l169">169</a><td>  } else if (ua.indexOf(&#39;Safari&#39;) != -1) {<tr><td><a name="l170" href="#l170">170</a><td>    goog.userAgent.product.detectedSafari_ = true;<tr><td><a name="l171" href="#l171">171</a><td>  }<tr><td><a name="l172" href="#l172">172</a><td>};<tr><td><a name="l173" href="#l173">173</a><td><tr><td><a name="l174" href="#l174">174</a><td>if (!goog.userAgent.product.PRODUCT_KNOWN_) {<tr><td><a name="l175" href="#l175">175</a><td>  goog.userAgent.product.init_();<tr><td><a name="l176" href="#l176">176</a><td>}<tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td>/**<tr><td><a name="l180" href="#l180">180</a><td> * Whether the code is running on the Opera web browser.<tr><td><a name="l181" href="#l181">181</a><td> * @type {boolean}<tr><td><a name="l182" href="#l182">182</a><td> */<tr><td><a name="l183" href="#l183">183</a><td>goog.userAgent.product.OPERA = goog.userAgent.OPERA;<tr><td><a name="l184" href="#l184">184</a><td><tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td>/**<tr><td><a name="l187" href="#l187">187</a><td> * Whether the code is running on an IE web browser.<tr><td><a name="l188" href="#l188">188</a><td> * @type {boolean}<tr><td><a name="l189" href="#l189">189</a><td> */<tr><td><a name="l190" href="#l190">190</a><td>goog.userAgent.product.IE = goog.userAgent.IE;<tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td><tr><td><a name="l193" href="#l193">193</a><td>/**<tr><td><a name="l194" href="#l194">194</a><td> * Whether the code is running on the Firefox web browser.<tr><td><a name="l195" href="#l195">195</a><td> * @type {boolean}<tr><td><a name="l196" href="#l196">196</a><td> */<tr><td><a name="l197" href="#l197">197</a><td>goog.userAgent.product.FIREFOX = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a name="l198" href="#l198">198</a><td>    goog.userAgent.product.ASSUME_FIREFOX :<tr><td><a name="l199" href="#l199">199</a><td>    goog.userAgent.product.detectedFirefox_;<tr><td><a name="l200" href="#l200">200</a><td><tr><td><a name="l201" href="#l201">201</a><td><tr><td><a name="l202" href="#l202">202</a><td>/**<tr><td><a name="l203" href="#l203">203</a><td> * Whether the code is running on the Camino web browser.<tr><td><a name="l204" href="#l204">204</a><td> * @type {boolean}<tr><td><a name="l205" href="#l205">205</a><td> */<tr><td><a name="l206" href="#l206">206</a><td>goog.userAgent.product.CAMINO = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a name="l207" href="#l207">207</a><td>    goog.userAgent.product.ASSUME_CAMINO :<tr><td><a name="l208" href="#l208">208</a><td>    goog.userAgent.product.detectedCamino_;<tr><td><a name="l209" href="#l209">209</a><td><tr><td><a name="l210" href="#l210">210</a><td><tr><td><a name="l211" href="#l211">211</a><td>/**<tr><td><a name="l212" href="#l212">212</a><td> * Whether the code is running on an iPhone or iPod touch.<tr><td><a name="l213" href="#l213">213</a><td> * @type {boolean}<tr><td><a name="l214" href="#l214">214</a><td> */<tr><td><a name="l215" href="#l215">215</a><td>goog.userAgent.product.IPHONE = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a name="l216" href="#l216">216</a><td>    goog.userAgent.product.ASSUME_IPHONE :<tr><td><a name="l217" href="#l217">217</a><td>    goog.userAgent.product.detectedIphone_;<tr><td><a name="l218" href="#l218">218</a><td><tr><td><a name="l219" href="#l219">219</a><td><tr><td><a name="l220" href="#l220">220</a><td>/**<tr><td><a name="l221" href="#l221">221</a><td> * Whether the code is running on an iPad.<tr><td><a name="l222" href="#l222">222</a><td> * @type {boolean}<tr><td><a name="l223" href="#l223">223</a><td> */<tr><td><a name="l224" href="#l224">224</a><td>goog.userAgent.product.IPAD = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a name="l225" href="#l225">225</a><td>    goog.userAgent.product.ASSUME_IPAD :<tr><td><a name="l226" href="#l226">226</a><td>    goog.userAgent.product.detectedIpad_;<tr><td><a name="l227" href="#l227">227</a><td><tr><td><a name="l228" href="#l228">228</a><td><tr><td><a name="l229" href="#l229">229</a><td>/**<tr><td><a name="l230" href="#l230">230</a><td> * Whether the code is running on the default browser on an Android phone.<tr><td><a name="l231" href="#l231">231</a><td> * @type {boolean}<tr><td><a name="l232" href="#l232">232</a><td> */<tr><td><a name="l233" href="#l233">233</a><td>goog.userAgent.product.ANDROID = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a name="l234" href="#l234">234</a><td>    goog.userAgent.product.ASSUME_ANDROID :<tr><td><a name="l235" href="#l235">235</a><td>    goog.userAgent.product.detectedAndroid_;<tr><td><a name="l236" href="#l236">236</a><td><tr><td><a name="l237" href="#l237">237</a><td><tr><td><a name="l238" href="#l238">238</a><td>/**<tr><td><a name="l239" href="#l239">239</a><td> * Whether the code is running on the Chrome web browser.<tr><td><a name="l240" href="#l240">240</a><td> * @type {boolean}<tr><td><a name="l241" href="#l241">241</a><td> */<tr><td><a name="l242" href="#l242">242</a><td>goog.userAgent.product.CHROME = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a name="l243" href="#l243">243</a><td>    goog.userAgent.product.ASSUME_CHROME :<tr><td><a name="l244" href="#l244">244</a><td>    goog.userAgent.product.detectedChrome_;<tr><td><a name="l245" href="#l245">245</a><td><tr><td><a name="l246" href="#l246">246</a><td><tr><td><a name="l247" href="#l247">247</a><td>/**<tr><td><a name="l248" href="#l248">248</a><td> * Whether the code is running on the Safari web browser.<tr><td><a name="l249" href="#l249">249</a><td> * @type {boolean}<tr><td><a name="l250" href="#l250">250</a><td> */<tr><td><a name="l251" href="#l251">251</a><td>goog.userAgent.product.SAFARI = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a name="l252" href="#l252">252</a><td>    goog.userAgent.product.ASSUME_SAFARI :<tr><td><a name="l253" href="#l253">253</a><td>    goog.userAgent.product.detectedSafari_;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>product.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/useragent/product.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2008 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Detects the specific browser and not just the rendering engine.<tr><td><a id="l17"></a><a href="#l17">17</a><td> *<tr><td><a id="l18"></a><a href="#l18">18</a><td> */<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>goog.provide(&#39;goog.userAgent.product&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;goog.labs.userAgent.browser&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;goog.labs.userAgent.platform&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>/**<tr><td><a id="l28"></a><a href="#l28">28</a><td> * @define {boolean} Whether the code is running on the Firefox web browser.<tr><td><a id="l29"></a><a href="#l29">29</a><td> */<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_FIREFOX&#39;, false);<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>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @define {boolean} Whether we know at compile-time that the product is an<tr><td><a id="l35"></a><a href="#l35">35</a><td> *     iPhone.<tr><td><a id="l36"></a><a href="#l36">36</a><td> */<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_IPHONE&#39;, false);<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> * @define {boolean} Whether we know at compile-time that the product is an<tr><td><a id="l42"></a><a href="#l42">42</a><td> *     iPad.<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_IPAD&#39;, false);<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> * @define {boolean} Whether we know at compile-time that the product is an<tr><td><a id="l49"></a><a href="#l49">49</a><td> *     AOSP browser or WebView inside a pre KitKat Android phone or tablet.<tr><td><a id="l50"></a><a href="#l50">50</a><td> */<tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_ANDROID&#39;, false);<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>/**<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @define {boolean} Whether the code is running on the Chrome web browser on<tr><td><a id="l56"></a><a href="#l56">56</a><td> * any platform or AOSP browser or WebView in a KitKat+ Android phone or tablet.<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.define(&#39;goog.userAgent.product.ASSUME_CHROME&#39;, false);<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>/**<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @define {boolean} Whether the code is running on the Safari web browser.<tr><td><a id="l63"></a><a href="#l63">63</a><td> */<tr><td><a id="l64"></a><a href="#l64">64</a><td>goog.define(&#39;goog.userAgent.product.ASSUME_SAFARI&#39;, false);<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> * Whether we know the product type at compile-time.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @type {boolean}<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @private<tr><td><a id="l71"></a><a href="#l71">71</a><td> */<tr><td><a id="l72"></a><a href="#l72">72</a><td>goog.userAgent.product.PRODUCT_KNOWN_ =<tr><td><a id="l73"></a><a href="#l73">73</a><td>    goog.userAgent.ASSUME_IE ||<tr><td><a id="l74"></a><a href="#l74">74</a><td>    goog.userAgent.ASSUME_EDGE ||<tr><td><a id="l75"></a><a href="#l75">75</a><td>    goog.userAgent.ASSUME_OPERA ||<tr><td><a id="l76"></a><a href="#l76">76</a><td>    goog.userAgent.product.ASSUME_FIREFOX ||<tr><td><a id="l77"></a><a href="#l77">77</a><td>    goog.userAgent.product.ASSUME_IPHONE ||<tr><td><a id="l78"></a><a href="#l78">78</a><td>    goog.userAgent.product.ASSUME_IPAD ||<tr><td><a id="l79"></a><a href="#l79">79</a><td>    goog.userAgent.product.ASSUME_ANDROID ||<tr><td><a id="l80"></a><a href="#l80">80</a><td>    goog.userAgent.product.ASSUME_CHROME ||<tr><td><a id="l81"></a><a href="#l81">81</a><td>    goog.userAgent.product.ASSUME_SAFARI;<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> * Whether the code is running on the Opera web browser.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @type {boolean}<tr><td><a id="l87"></a><a href="#l87">87</a><td> */<tr><td><a id="l88"></a><a href="#l88">88</a><td>goog.userAgent.product.OPERA = goog.userAgent.OPERA;<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> * Whether the code is running on an IE web browser.<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @type {boolean}<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.userAgent.product.IE = goog.userAgent.IE;<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> * Whether the code is running on an Edge web browser.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @type {boolean}<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>goog.userAgent.product.EDGE = goog.userAgent.EDGE;<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * Whether the code is running on the Firefox web browser.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @type {boolean}<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.userAgent.product.FIREFOX = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a id="l110"></a><a href="#l110">110</a><td>    goog.userAgent.product.ASSUME_FIREFOX :<tr><td><a id="l111"></a><a href="#l111">111</a><td>    goog.labs.userAgent.browser.isFirefox();<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> * Whether the user agent is an iPhone or iPod (as in iPod touch).<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @return {boolean}<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @private<tr><td><a id="l118"></a><a href="#l118">118</a><td> */<tr><td><a id="l119"></a><a href="#l119">119</a><td>goog.userAgent.product.isIphoneOrIpod_ = function() {<tr><td><a id="l120"></a><a href="#l120">120</a><td>  return goog.labs.userAgent.platform.isIphone() ||<tr><td><a id="l121"></a><a href="#l121">121</a><td>      goog.labs.userAgent.platform.isIpod();<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<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> * Whether the code is running on an iPhone or iPod touch.<tr><td><a id="l127"></a><a href="#l127">127</a><td> *<tr><td><a id="l128"></a><a href="#l128">128</a><td> * iPod touch is considered an iPhone for legacy reasons.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @type {boolean}<tr><td><a id="l130"></a><a href="#l130">130</a><td> */<tr><td><a id="l131"></a><a href="#l131">131</a><td>goog.userAgent.product.IPHONE = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a id="l132"></a><a href="#l132">132</a><td>    goog.userAgent.product.ASSUME_IPHONE :<tr><td><a id="l133"></a><a href="#l133">133</a><td>    goog.userAgent.product.isIphoneOrIpod_();<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>/**<tr><td><a id="l137"></a><a href="#l137">137</a><td> * Whether the code is running on an iPad.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @type {boolean}<tr><td><a id="l139"></a><a href="#l139">139</a><td> */<tr><td><a id="l140"></a><a href="#l140">140</a><td>goog.userAgent.product.IPAD = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a id="l141"></a><a href="#l141">141</a><td>    goog.userAgent.product.ASSUME_IPAD :<tr><td><a id="l142"></a><a href="#l142">142</a><td>    goog.labs.userAgent.platform.isIpad();<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> * Whether the code is running on AOSP browser or WebView inside<tr><td><a id="l147"></a><a href="#l147">147</a><td> * a pre KitKat Android phone or tablet.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @type {boolean}<tr><td><a id="l149"></a><a href="#l149">149</a><td> */<tr><td><a id="l150"></a><a href="#l150">150</a><td>goog.userAgent.product.ANDROID = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a id="l151"></a><a href="#l151">151</a><td>    goog.userAgent.product.ASSUME_ANDROID :<tr><td><a id="l152"></a><a href="#l152">152</a><td>    goog.labs.userAgent.browser.isAndroidBrowser();<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> * Whether the code is running on the Chrome web browser on any platform<tr><td><a id="l157"></a><a href="#l157">157</a><td> * or AOSP browser or WebView in a KitKat+ Android phone or tablet.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @type {boolean}<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.userAgent.product.CHROME = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a id="l161"></a><a href="#l161">161</a><td>    goog.userAgent.product.ASSUME_CHROME :<tr><td><a id="l162"></a><a href="#l162">162</a><td>    goog.labs.userAgent.browser.isChrome();<tr><td><a id="l163"></a><a href="#l163">163</a><td><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> * @return {boolean} Whether the browser is Safari on desktop.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @private<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>goog.userAgent.product.isSafariDesktop_ = function() {<tr><td><a id="l170"></a><a href="#l170">170</a><td>  return goog.labs.userAgent.browser.isSafari() &amp;&amp;<tr><td><a id="l171"></a><a href="#l171">171</a><td>      !goog.labs.userAgent.platform.isIos();<tr><td><a id="l172"></a><a href="#l172">172</a><td>};<tr><td><a id="l173"></a><a href="#l173">173</a><td><tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>/**<tr><td><a id="l176"></a><a href="#l176">176</a><td> * Whether the code is running on the desktop Safari web browser.<tr><td><a id="l177"></a><a href="#l177">177</a><td> * Note: the legacy behavior here is only true for Safari not running<tr><td><a id="l178"></a><a href="#l178">178</a><td> * on iOS.<tr><td><a id="l179"></a><a href="#l179">179</a><td> * @type {boolean}<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.userAgent.product.SAFARI = goog.userAgent.product.PRODUCT_KNOWN_ ?<tr><td><a id="l182"></a><a href="#l182">182</a><td>    goog.userAgent.product.ASSUME_SAFARI :<tr><td><a id="l183"></a><a href="#l183">183</a><td>    goog.userAgent.product.isSafariDesktop_();</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/useragent/product_isversion.js.src.html b/docs/source/lib/goog/useragent/product_isversion.js.src.html
index 4f99683..6b9f54b 100644
--- a/docs/source/lib/goog/useragent/product_isversion.js.src.html
+++ b/docs/source/lib/goog/useragent/product_isversion.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>product_isversion.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/useragent/product_isversion.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Functions for understanding the version of the browser.<tr><td><a name="l17" href="#l17">17</a><td> * This is pulled out of product.js to ensure that only builds that need<tr><td><a name="l18" href="#l18">18</a><td> * this functionality actually get it, without having to rely on the compiler<tr><td><a name="l19" href="#l19">19</a><td> * to strip out unneeded pieces.<tr><td><a name="l20" href="#l20">20</a><td> *<tr><td><a name="l21" href="#l21">21</a><td> * TODO(nnaze): Move to more appropriate filename/namespace.<tr><td><a name="l22" href="#l22">22</a><td> *<tr><td><a name="l23" href="#l23">23</a><td> */<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>goog.provide(&#39;goog.userAgent.product.isVersion&#39;);<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td>goog.require(&#39;goog.userAgent.product&#39;);<tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td>/**<tr><td><a name="l33" href="#l33">33</a><td> * @return {string} The string that describes the version number of the user<tr><td><a name="l34" href="#l34">34</a><td> *     agent product.  This is a string rather than a number because it may<tr><td><a name="l35" href="#l35">35</a><td> *     contain &#39;b&#39;, &#39;a&#39;, and so on.<tr><td><a name="l36" href="#l36">36</a><td> * @private<tr><td><a name="l37" href="#l37">37</a><td> */<tr><td><a name="l38" href="#l38">38</a><td>goog.userAgent.product.determineVersion_ = function() {<tr><td><a name="l39" href="#l39">39</a><td>  // All browsers have different ways to detect the version and they all have<tr><td><a name="l40" href="#l40">40</a><td>  // different naming schemes.<tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td>  if (goog.userAgent.product.FIREFOX) {<tr><td><a name="l43" href="#l43">43</a><td>    // Firefox/2.0.0.1 or Firefox/3.5.3<tr><td><a name="l44" href="#l44">44</a><td>    return goog.userAgent.product.getFirstRegExpGroup_(/Firefox\/([0-9.]+)/);<tr><td><a name="l45" href="#l45">45</a><td>  }<tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>  if (goog.userAgent.product.IE || goog.userAgent.product.OPERA) {<tr><td><a name="l48" href="#l48">48</a><td>    return goog.userAgent.VERSION;<tr><td><a name="l49" href="#l49">49</a><td>  }<tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td>  if (goog.userAgent.product.CHROME) {<tr><td><a name="l52" href="#l52">52</a><td>    // Chrome/4.0.223.1<tr><td><a name="l53" href="#l53">53</a><td>    return goog.userAgent.product.getFirstRegExpGroup_(/Chrome\/([0-9.]+)/);<tr><td><a name="l54" href="#l54">54</a><td>  }<tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td>  if (goog.userAgent.product.SAFARI) {<tr><td><a name="l57" href="#l57">57</a><td>    // Version/5.0.3<tr><td><a name="l58" href="#l58">58</a><td>    //<tr><td><a name="l59" href="#l59">59</a><td>    // NOTE: Before version 3, Safari did not report a product version number.<tr><td><a name="l60" href="#l60">60</a><td>    // The product version number for these browsers will be the empty string.<tr><td><a name="l61" href="#l61">61</a><td>    // They may be differentiated by WebKit version number in goog.userAgent.<tr><td><a name="l62" href="#l62">62</a><td>    return goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);<tr><td><a name="l63" href="#l63">63</a><td>  }<tr><td><a name="l64" href="#l64">64</a><td><tr><td><a name="l65" href="#l65">65</a><td>  if (goog.userAgent.product.IPHONE || goog.userAgent.product.IPAD) {<tr><td><a name="l66" href="#l66">66</a><td>    // Mozilla/5.0 (iPod; U; CPU like Mac OS X; en) AppleWebKit/420.1<tr><td><a name="l67" href="#l67">67</a><td>    // (KHTML, like Gecko) Version/3.0 Mobile/3A100a Safari/419.3<tr><td><a name="l68" href="#l68">68</a><td>    // Version is the browser version, Mobile is the build number. We combine<tr><td><a name="l69" href="#l69">69</a><td>    // the version string with the build number: 3.0.3A100a for the example.<tr><td><a name="l70" href="#l70">70</a><td>    var arr = goog.userAgent.product.execRegExp_(<tr><td><a name="l71" href="#l71">71</a><td>        /Version\/(\S+).*Mobile\/(\S+)/);<tr><td><a name="l72" href="#l72">72</a><td>    if (arr) {<tr><td><a name="l73" href="#l73">73</a><td>      return arr[1] + &#39;.&#39; + arr[2];<tr><td><a name="l74" href="#l74">74</a><td>    }<tr><td><a name="l75" href="#l75">75</a><td>  } else if (goog.userAgent.product.ANDROID) {<tr><td><a name="l76" href="#l76">76</a><td>    // Mozilla/5.0 (Linux; U; Android 0.5; en-us) AppleWebKit/522+<tr><td><a name="l77" href="#l77">77</a><td>    // (KHTML, like Gecko) Safari/419.3<tr><td><a name="l78" href="#l78">78</a><td>    //<tr><td><a name="l79" href="#l79">79</a><td>    // Mozilla/5.0 (Linux; U; Android 1.0; en-us; dream) AppleWebKit/525.10+<tr><td><a name="l80" href="#l80">80</a><td>    // (KHTML, like Gecko) Version/3.0.4 Mobile Safari/523.12.2<tr><td><a name="l81" href="#l81">81</a><td>    //<tr><td><a name="l82" href="#l82">82</a><td>    // Prefer Version number if present, else make do with the OS number<tr><td><a name="l83" href="#l83">83</a><td>    var version = goog.userAgent.product.getFirstRegExpGroup_(<tr><td><a name="l84" href="#l84">84</a><td>        /Android\s+([0-9.]+)/);<tr><td><a name="l85" href="#l85">85</a><td>    if (version) {<tr><td><a name="l86" href="#l86">86</a><td>      return version;<tr><td><a name="l87" href="#l87">87</a><td>    }<tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>    return goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);<tr><td><a name="l90" href="#l90">90</a><td>  } else if (goog.userAgent.product.CAMINO) {<tr><td><a name="l91" href="#l91">91</a><td>    return goog.userAgent.product.getFirstRegExpGroup_(/Camino\/([0-9.]+)/);<tr><td><a name="l92" href="#l92">92</a><td>  }<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td>  return &#39;&#39;;<tr><td><a name="l95" href="#l95">95</a><td>};<tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td><tr><td><a name="l98" href="#l98">98</a><td>/**<tr><td><a name="l99" href="#l99">99</a><td> * Return the first group of the given regex.<tr><td><a name="l100" href="#l100">100</a><td> * @param {!RegExp} re Regular expression with at least one group.<tr><td><a name="l101" href="#l101">101</a><td> * @return {string} Contents of the first group or an empty string if no match.<tr><td><a name="l102" href="#l102">102</a><td> * @private<tr><td><a name="l103" href="#l103">103</a><td> */<tr><td><a name="l104" href="#l104">104</a><td>goog.userAgent.product.getFirstRegExpGroup_ = function(re) {<tr><td><a name="l105" href="#l105">105</a><td>  var arr = goog.userAgent.product.execRegExp_(re);<tr><td><a name="l106" href="#l106">106</a><td>  return arr ? arr[1] : &#39;&#39;;<tr><td><a name="l107" href="#l107">107</a><td>};<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>/**<tr><td><a name="l111" href="#l111">111</a><td> * Run regexp&#39;s exec() on the userAgent string.<tr><td><a name="l112" href="#l112">112</a><td> * @param {!RegExp} re Regular expression.<tr><td><a name="l113" href="#l113">113</a><td> * @return {Array} A result array, or null for no match.<tr><td><a name="l114" href="#l114">114</a><td> * @private<tr><td><a name="l115" href="#l115">115</a><td> */<tr><td><a name="l116" href="#l116">116</a><td>goog.userAgent.product.execRegExp_ = function(re) {<tr><td><a name="l117" href="#l117">117</a><td>  return re.exec(goog.userAgent.getUserAgentString());<tr><td><a name="l118" href="#l118">118</a><td>};<tr><td><a name="l119" href="#l119">119</a><td><tr><td><a name="l120" href="#l120">120</a><td><tr><td><a name="l121" href="#l121">121</a><td>/**<tr><td><a name="l122" href="#l122">122</a><td> * The version of the user agent. This is a string because it might contain<tr><td><a name="l123" href="#l123">123</a><td> * &#39;b&#39; (as in beta) as well as multiple dots.<tr><td><a name="l124" href="#l124">124</a><td> * @type {string}<tr><td><a name="l125" href="#l125">125</a><td> */<tr><td><a name="l126" href="#l126">126</a><td>goog.userAgent.product.VERSION = goog.userAgent.product.determineVersion_();<tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td>/**<tr><td><a name="l130" href="#l130">130</a><td> * Whether the user agent product version is higher or the same as the given<tr><td><a name="l131" href="#l131">131</a><td> * version.<tr><td><a name="l132" href="#l132">132</a><td> *<tr><td><a name="l133" href="#l133">133</a><td> * @param {string|number} version The version to check.<tr><td><a name="l134" href="#l134">134</a><td> * @return {boolean} Whether the user agent product version is higher or the<tr><td><a name="l135" href="#l135">135</a><td> *     same as the given version.<tr><td><a name="l136" href="#l136">136</a><td> */<tr><td><a name="l137" href="#l137">137</a><td>goog.userAgent.product.isVersion = function(version) {<tr><td><a name="l138" href="#l138">138</a><td>  return goog.string.compareVersions(<tr><td><a name="l139" href="#l139">139</a><td>      goog.userAgent.product.VERSION, version) &gt;= 0;<tr><td><a name="l140" href="#l140">140</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>product_isversion.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/useragent/product_isversion.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Functions for understanding the version of the browser.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * This is pulled out of product.js to ensure that only builds that need<tr><td><a id="l18"></a><a href="#l18">18</a><td> * this functionality actually get it, without having to rely on the compiler<tr><td><a id="l19"></a><a href="#l19">19</a><td> * to strip out unneeded pieces.<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> * TODO(nnaze): Move to more appropriate filename/namespace.<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>goog.provide(&#39;goog.userAgent.product.isVersion&#39;);<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>goog.require(&#39;goog.labs.userAgent.platform&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.userAgent.product&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>/**<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @return {string} The string that describes the version number of the user<tr><td><a id="l37"></a><a href="#l37">37</a><td> *     agent product.  This is a string rather than a number because it may<tr><td><a id="l38"></a><a href="#l38">38</a><td> *     contain &#39;b&#39;, &#39;a&#39;, and so on.<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.userAgent.product.determineVersion_ = function() {<tr><td><a id="l42"></a><a href="#l42">42</a><td>  // All browsers have different ways to detect the version and they all have<tr><td><a id="l43"></a><a href="#l43">43</a><td>  // different naming schemes.<tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>  if (goog.userAgent.product.FIREFOX) {<tr><td><a id="l46"></a><a href="#l46">46</a><td>    // Firefox/2.0.0.1 or Firefox/3.5.3<tr><td><a id="l47"></a><a href="#l47">47</a><td>    return goog.userAgent.product.getFirstRegExpGroup_(/Firefox\/([0-9.]+)/);<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>  if (goog.userAgent.product.IE || goog.userAgent.product.EDGE ||<tr><td><a id="l51"></a><a href="#l51">51</a><td>      goog.userAgent.product.OPERA) {<tr><td><a id="l52"></a><a href="#l52">52</a><td>    return goog.userAgent.VERSION;<tr><td><a id="l53"></a><a href="#l53">53</a><td>  }<tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>  if (goog.userAgent.product.CHROME) {<tr><td><a id="l56"></a><a href="#l56">56</a><td>    // Chrome/4.0.223.1<tr><td><a id="l57"></a><a href="#l57">57</a><td>    return goog.userAgent.product.getFirstRegExpGroup_(/Chrome\/([0-9.]+)/);<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>  // This replicates legacy logic, which considered Safari and iOS to be<tr><td><a id="l61"></a><a href="#l61">61</a><td>  // different products.<tr><td><a id="l62"></a><a href="#l62">62</a><td>  if (goog.userAgent.product.SAFARI &amp;&amp; !goog.labs.userAgent.platform.isIos()) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>    // Version/5.0.3<tr><td><a id="l64"></a><a href="#l64">64</a><td>    //<tr><td><a id="l65"></a><a href="#l65">65</a><td>    // NOTE: Before version 3, Safari did not report a product version number.<tr><td><a id="l66"></a><a href="#l66">66</a><td>    // The product version number for these browsers will be the empty string.<tr><td><a id="l67"></a><a href="#l67">67</a><td>    // They may be differentiated by WebKit version number in goog.userAgent.<tr><td><a id="l68"></a><a href="#l68">68</a><td>    return goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);<tr><td><a id="l69"></a><a href="#l69">69</a><td>  }<tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td>  if (goog.userAgent.product.IPHONE || goog.userAgent.product.IPAD) {<tr><td><a id="l72"></a><a href="#l72">72</a><td>    // Mozilla/5.0 (iPod; U; CPU like Mac OS X; en) AppleWebKit/420.1<tr><td><a id="l73"></a><a href="#l73">73</a><td>    // (KHTML, like Gecko) Version/3.0 Mobile/3A100a Safari/419.3<tr><td><a id="l74"></a><a href="#l74">74</a><td>    // Version is the browser version, Mobile is the build number. We combine<tr><td><a id="l75"></a><a href="#l75">75</a><td>    // the version string with the build number: 3.0.3A100a for the example.<tr><td><a id="l76"></a><a href="#l76">76</a><td>    var arr = goog.userAgent.product.execRegExp_(<tr><td><a id="l77"></a><a href="#l77">77</a><td>        /Version\/(\S+).*Mobile\/(\S+)/);<tr><td><a id="l78"></a><a href="#l78">78</a><td>    if (arr) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>      return arr[1] + &#39;.&#39; + arr[2];<tr><td><a id="l80"></a><a href="#l80">80</a><td>    }<tr><td><a id="l81"></a><a href="#l81">81</a><td>  } else if (goog.userAgent.product.ANDROID) {<tr><td><a id="l82"></a><a href="#l82">82</a><td>    // Mozilla/5.0 (Linux; U; Android 0.5; en-us) AppleWebKit/522+<tr><td><a id="l83"></a><a href="#l83">83</a><td>    // (KHTML, like Gecko) Safari/419.3<tr><td><a id="l84"></a><a href="#l84">84</a><td>    //<tr><td><a id="l85"></a><a href="#l85">85</a><td>    // Mozilla/5.0 (Linux; U; Android 1.0; en-us; dream) AppleWebKit/525.10+<tr><td><a id="l86"></a><a href="#l86">86</a><td>    // (KHTML, like Gecko) Version/3.0.4 Mobile Safari/523.12.2<tr><td><a id="l87"></a><a href="#l87">87</a><td>    //<tr><td><a id="l88"></a><a href="#l88">88</a><td>    // Prefer Version number if present, else make do with the OS number<tr><td><a id="l89"></a><a href="#l89">89</a><td>    var version = goog.userAgent.product.getFirstRegExpGroup_(<tr><td><a id="l90"></a><a href="#l90">90</a><td>        /Android\s+([0-9.]+)/);<tr><td><a id="l91"></a><a href="#l91">91</a><td>    if (version) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>      return version;<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 goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);<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>  return &#39;&#39;;<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 the first group of the given regex.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @param {!RegExp} re Regular expression with at least one group.<tr><td><a id="l105"></a><a href="#l105">105</a><td> * @return {string} Contents of the first group or an empty string if no match.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @private<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td>goog.userAgent.product.getFirstRegExpGroup_ = function(re) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>  var arr = goog.userAgent.product.execRegExp_(re);<tr><td><a id="l110"></a><a href="#l110">110</a><td>  return arr ? arr[1] : &#39;&#39;;<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> * Run regexp&#39;s exec() on the userAgent string.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @param {!RegExp} re Regular expression.<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @return {Array&lt;?&gt;} A result array, or null for no match.<tr><td><a id="l118"></a><a href="#l118">118</a><td> * @private<tr><td><a id="l119"></a><a href="#l119">119</a><td> */<tr><td><a id="l120"></a><a href="#l120">120</a><td>goog.userAgent.product.execRegExp_ = function(re) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>  return re.exec(goog.userAgent.getUserAgentString());<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<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> * The version of the user agent. This is a string because it might contain<tr><td><a id="l127"></a><a href="#l127">127</a><td> * &#39;b&#39; (as in beta) as well as multiple dots.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @type {string}<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.userAgent.product.VERSION = goog.userAgent.product.determineVersion_();<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/**<tr><td><a id="l134"></a><a href="#l134">134</a><td> * Whether the user agent product version is higher or the same as the given<tr><td><a id="l135"></a><a href="#l135">135</a><td> * version.<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @param {string|number} version The version to check.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @return {boolean} Whether the user agent product version is higher or the<tr><td><a id="l139"></a><a href="#l139">139</a><td> *     same as the given version.<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.userAgent.product.isVersion = function(version) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  return goog.string.compareVersions(<tr><td><a id="l143"></a><a href="#l143">143</a><td>      goog.userAgent.product.VERSION, version) &gt;= 0;<tr><td><a id="l144"></a><a href="#l144">144</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>
\ No newline at end of file
diff --git a/docs/source/lib/goog/useragent/useragent.js.src.html b/docs/source/lib/goog/useragent/useragent.js.src.html
index 3f33e48..f121aa3 100644
--- a/docs/source/lib/goog/useragent/useragent.js.src.html
+++ b/docs/source/lib/goog/useragent/useragent.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>useragent.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/useragent/useragent.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Rendering engine detection.<tr><td><a name="l17" href="#l17">17</a><td> * @see &lt;a href=&quot;http://www.useragentstring.com/&quot;&gt;User agent strings&lt;/a&gt;<tr><td><a name="l18" href="#l18">18</a><td> * For information on the browser brand (such as Safari versus Chrome), see<tr><td><a name="l19" href="#l19">19</a><td> * goog.userAgent.product.<tr><td><a name="l20" href="#l20">20</a><td> * @see ../demos/useragent.html<tr><td><a name="l21" href="#l21">21</a><td> */<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.userAgent&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>/**<tr><td><a name="l29" href="#l29">29</a><td> * @define {boolean} Whether we know at compile-time that the browser is IE.<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>goog.define(&#39;goog.userAgent.ASSUME_IE&#39;, false);<tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td>/**<tr><td><a name="l35" href="#l35">35</a><td> * @define {boolean} Whether we know at compile-time that the browser is GECKO.<tr><td><a name="l36" href="#l36">36</a><td> */<tr><td><a name="l37" href="#l37">37</a><td>goog.define(&#39;goog.userAgent.ASSUME_GECKO&#39;, false);<tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td><tr><td><a name="l40" href="#l40">40</a><td>/**<tr><td><a name="l41" href="#l41">41</a><td> * @define {boolean} Whether we know at compile-time that the browser is WEBKIT.<tr><td><a name="l42" href="#l42">42</a><td> */<tr><td><a name="l43" href="#l43">43</a><td>goog.define(&#39;goog.userAgent.ASSUME_WEBKIT&#39;, false);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td>/**<tr><td><a name="l47" href="#l47">47</a><td> * @define {boolean} Whether we know at compile-time that the browser is a<tr><td><a name="l48" href="#l48">48</a><td> *     mobile device running WebKit e.g. iPhone or Android.<tr><td><a name="l49" href="#l49">49</a><td> */<tr><td><a name="l50" href="#l50">50</a><td>goog.define(&#39;goog.userAgent.ASSUME_MOBILE_WEBKIT&#39;, false);<tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>/**<tr><td><a name="l54" href="#l54">54</a><td> * @define {boolean} Whether we know at compile-time that the browser is OPERA.<tr><td><a name="l55" href="#l55">55</a><td> */<tr><td><a name="l56" href="#l56">56</a><td>goog.define(&#39;goog.userAgent.ASSUME_OPERA&#39;, false);<tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td>/**<tr><td><a name="l60" href="#l60">60</a><td> * @define {boolean} Whether the<tr><td><a name="l61" href="#l61">61</a><td> *     {@code goog.userAgent.isVersionOrHigher}<tr><td><a name="l62" href="#l62">62</a><td> *     function will return true for any version.<tr><td><a name="l63" href="#l63">63</a><td> */<tr><td><a name="l64" href="#l64">64</a><td>goog.define(&#39;goog.userAgent.ASSUME_ANY_VERSION&#39;, false);<tr><td><a name="l65" href="#l65">65</a><td><tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td>/**<tr><td><a name="l68" href="#l68">68</a><td> * Whether we know the browser engine at compile-time.<tr><td><a name="l69" href="#l69">69</a><td> * @type {boolean}<tr><td><a name="l70" href="#l70">70</a><td> * @private<tr><td><a name="l71" href="#l71">71</a><td> */<tr><td><a name="l72" href="#l72">72</a><td>goog.userAgent.BROWSER_KNOWN_ =<tr><td><a name="l73" href="#l73">73</a><td>    goog.userAgent.ASSUME_IE ||<tr><td><a name="l74" href="#l74">74</a><td>    goog.userAgent.ASSUME_GECKO ||<tr><td><a name="l75" href="#l75">75</a><td>    goog.userAgent.ASSUME_MOBILE_WEBKIT ||<tr><td><a name="l76" href="#l76">76</a><td>    goog.userAgent.ASSUME_WEBKIT ||<tr><td><a name="l77" href="#l77">77</a><td>    goog.userAgent.ASSUME_OPERA;<tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td><tr><td><a name="l80" href="#l80">80</a><td>/**<tr><td><a name="l81" href="#l81">81</a><td> * Returns the userAgent string for the current browser.<tr><td><a name="l82" href="#l82">82</a><td> * Some user agents (I&#39;m thinking of you, Gears WorkerPool) do not expose a<tr><td><a name="l83" href="#l83">83</a><td> * navigator object off the global scope.  In that case we return null.<tr><td><a name="l84" href="#l84">84</a><td> *<tr><td><a name="l85" href="#l85">85</a><td> * @return {?string} The userAgent string or null if there is none.<tr><td><a name="l86" href="#l86">86</a><td> */<tr><td><a name="l87" href="#l87">87</a><td>goog.userAgent.getUserAgentString = function() {<tr><td><a name="l88" href="#l88">88</a><td>  return goog.global[&#39;navigator&#39;] ? goog.global[&#39;navigator&#39;].userAgent : null;<tr><td><a name="l89" href="#l89">89</a><td>};<tr><td><a name="l90" href="#l90">90</a><td><tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td>/**<tr><td><a name="l93" href="#l93">93</a><td> * @return {Object} The native navigator object.<tr><td><a name="l94" href="#l94">94</a><td> */<tr><td><a name="l95" href="#l95">95</a><td>goog.userAgent.getNavigator = function() {<tr><td><a name="l96" href="#l96">96</a><td>  // Need a local navigator reference instead of using the global one,<tr><td><a name="l97" href="#l97">97</a><td>  // to avoid the rare case where they reference different objects.<tr><td><a name="l98" href="#l98">98</a><td>  // (in a WorkerPool, for example).<tr><td><a name="l99" href="#l99">99</a><td>  return goog.global[&#39;navigator&#39;];<tr><td><a name="l100" href="#l100">100</a><td>};<tr><td><a name="l101" href="#l101">101</a><td><tr><td><a name="l102" href="#l102">102</a><td><tr><td><a name="l103" href="#l103">103</a><td>/**<tr><td><a name="l104" href="#l104">104</a><td> * Initializer for goog.userAgent.<tr><td><a name="l105" href="#l105">105</a><td> *<tr><td><a name="l106" href="#l106">106</a><td> * This is a named function so that it can be stripped via the jscompiler<tr><td><a name="l107" href="#l107">107</a><td> * option for stripping types.<tr><td><a name="l108" href="#l108">108</a><td> * @private<tr><td><a name="l109" href="#l109">109</a><td> */<tr><td><a name="l110" href="#l110">110</a><td>goog.userAgent.init_ = function() {<tr><td><a name="l111" href="#l111">111</a><td>  /**<tr><td><a name="l112" href="#l112">112</a><td>   * Whether the user agent string denotes Opera.<tr><td><a name="l113" href="#l113">113</a><td>   * @type {boolean}<tr><td><a name="l114" href="#l114">114</a><td>   * @private<tr><td><a name="l115" href="#l115">115</a><td>   */<tr><td><a name="l116" href="#l116">116</a><td>  goog.userAgent.detectedOpera_ = false;<tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td>  /**<tr><td><a name="l119" href="#l119">119</a><td>   * Whether the user agent string denotes Internet Explorer. This includes<tr><td><a name="l120" href="#l120">120</a><td>   * other browsers using Trident as its rendering engine. For example AOL<tr><td><a name="l121" href="#l121">121</a><td>   * and Netscape 8<tr><td><a name="l122" href="#l122">122</a><td>   * @type {boolean}<tr><td><a name="l123" href="#l123">123</a><td>   * @private<tr><td><a name="l124" href="#l124">124</a><td>   */<tr><td><a name="l125" href="#l125">125</a><td>  goog.userAgent.detectedIe_ = false;<tr><td><a name="l126" href="#l126">126</a><td><tr><td><a name="l127" href="#l127">127</a><td>  /**<tr><td><a name="l128" href="#l128">128</a><td>   * Whether the user agent string denotes WebKit. WebKit is the rendering<tr><td><a name="l129" href="#l129">129</a><td>   * engine that Safari, Android and others use.<tr><td><a name="l130" href="#l130">130</a><td>   * @type {boolean}<tr><td><a name="l131" href="#l131">131</a><td>   * @private<tr><td><a name="l132" href="#l132">132</a><td>   */<tr><td><a name="l133" href="#l133">133</a><td>  goog.userAgent.detectedWebkit_ = false;<tr><td><a name="l134" href="#l134">134</a><td><tr><td><a name="l135" href="#l135">135</a><td>  /**<tr><td><a name="l136" href="#l136">136</a><td>   * Whether the user agent string denotes a mobile device.<tr><td><a name="l137" href="#l137">137</a><td>   * @type {boolean}<tr><td><a name="l138" href="#l138">138</a><td>   * @private<tr><td><a name="l139" href="#l139">139</a><td>   */<tr><td><a name="l140" href="#l140">140</a><td>  goog.userAgent.detectedMobile_ = false;<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td>  /**<tr><td><a name="l143" href="#l143">143</a><td>   * Whether the user agent string denotes Gecko. Gecko is the rendering<tr><td><a name="l144" href="#l144">144</a><td>   * engine used by Mozilla, Mozilla Firefox, Camino and many more.<tr><td><a name="l145" href="#l145">145</a><td>   * @type {boolean}<tr><td><a name="l146" href="#l146">146</a><td>   * @private<tr><td><a name="l147" href="#l147">147</a><td>   */<tr><td><a name="l148" href="#l148">148</a><td>  goog.userAgent.detectedGecko_ = false;<tr><td><a name="l149" href="#l149">149</a><td><tr><td><a name="l150" href="#l150">150</a><td>  var ua;<tr><td><a name="l151" href="#l151">151</a><td>  if (!goog.userAgent.BROWSER_KNOWN_ &amp;&amp;<tr><td><a name="l152" href="#l152">152</a><td>      (ua = goog.userAgent.getUserAgentString())) {<tr><td><a name="l153" href="#l153">153</a><td>    var navigator = goog.userAgent.getNavigator();<tr><td><a name="l154" href="#l154">154</a><td>    goog.userAgent.detectedOpera_ = ua.indexOf(&#39;Opera&#39;) == 0;<tr><td><a name="l155" href="#l155">155</a><td>    goog.userAgent.detectedIe_ = !goog.userAgent.detectedOpera_ &amp;&amp;<tr><td><a name="l156" href="#l156">156</a><td>        ua.indexOf(&#39;MSIE&#39;) != -1;<tr><td><a name="l157" href="#l157">157</a><td>    goog.userAgent.detectedWebkit_ = !goog.userAgent.detectedOpera_ &amp;&amp;<tr><td><a name="l158" href="#l158">158</a><td>        ua.indexOf(&#39;WebKit&#39;) != -1;<tr><td><a name="l159" href="#l159">159</a><td>    // WebKit also gives navigator.product string equal to &#39;Gecko&#39;.<tr><td><a name="l160" href="#l160">160</a><td>    goog.userAgent.detectedMobile_ = goog.userAgent.detectedWebkit_ &amp;&amp;<tr><td><a name="l161" href="#l161">161</a><td>        ua.indexOf(&#39;Mobile&#39;) != -1;<tr><td><a name="l162" href="#l162">162</a><td>    goog.userAgent.detectedGecko_ = !goog.userAgent.detectedOpera_ &amp;&amp;<tr><td><a name="l163" href="#l163">163</a><td>        !goog.userAgent.detectedWebkit_ &amp;&amp; navigator.product == &#39;Gecko&#39;;<tr><td><a name="l164" href="#l164">164</a><td>  }<tr><td><a name="l165" href="#l165">165</a><td>};<tr><td><a name="l166" href="#l166">166</a><td><tr><td><a name="l167" href="#l167">167</a><td><tr><td><a name="l168" href="#l168">168</a><td>if (!goog.userAgent.BROWSER_KNOWN_) {<tr><td><a name="l169" href="#l169">169</a><td>  goog.userAgent.init_();<tr><td><a name="l170" href="#l170">170</a><td>}<tr><td><a name="l171" href="#l171">171</a><td><tr><td><a name="l172" href="#l172">172</a><td><tr><td><a name="l173" href="#l173">173</a><td>/**<tr><td><a name="l174" href="#l174">174</a><td> * Whether the user agent is Opera.<tr><td><a name="l175" href="#l175">175</a><td> * @type {boolean}<tr><td><a name="l176" href="#l176">176</a><td> */<tr><td><a name="l177" href="#l177">177</a><td>goog.userAgent.OPERA = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l178" href="#l178">178</a><td>    goog.userAgent.ASSUME_OPERA : goog.userAgent.detectedOpera_;<tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td><tr><td><a name="l181" href="#l181">181</a><td>/**<tr><td><a name="l182" href="#l182">182</a><td> * Whether the user agent is Internet Explorer. This includes other browsers<tr><td><a name="l183" href="#l183">183</a><td> * using Trident as its rendering engine. For example AOL and Netscape 8<tr><td><a name="l184" href="#l184">184</a><td> * @type {boolean}<tr><td><a name="l185" href="#l185">185</a><td> */<tr><td><a name="l186" href="#l186">186</a><td>goog.userAgent.IE = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l187" href="#l187">187</a><td>    goog.userAgent.ASSUME_IE : goog.userAgent.detectedIe_;<tr><td><a name="l188" href="#l188">188</a><td><tr><td><a name="l189" href="#l189">189</a><td><tr><td><a name="l190" href="#l190">190</a><td>/**<tr><td><a name="l191" href="#l191">191</a><td> * Whether the user agent is Gecko. Gecko is the rendering engine used by<tr><td><a name="l192" href="#l192">192</a><td> * Mozilla, Mozilla Firefox, Camino and many more.<tr><td><a name="l193" href="#l193">193</a><td> * @type {boolean}<tr><td><a name="l194" href="#l194">194</a><td> */<tr><td><a name="l195" href="#l195">195</a><td>goog.userAgent.GECKO = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l196" href="#l196">196</a><td>    goog.userAgent.ASSUME_GECKO :<tr><td><a name="l197" href="#l197">197</a><td>    goog.userAgent.detectedGecko_;<tr><td><a name="l198" href="#l198">198</a><td><tr><td><a name="l199" href="#l199">199</a><td><tr><td><a name="l200" href="#l200">200</a><td>/**<tr><td><a name="l201" href="#l201">201</a><td> * Whether the user agent is WebKit. WebKit is the rendering engine that<tr><td><a name="l202" href="#l202">202</a><td> * Safari, Android and others use.<tr><td><a name="l203" href="#l203">203</a><td> * @type {boolean}<tr><td><a name="l204" href="#l204">204</a><td> */<tr><td><a name="l205" href="#l205">205</a><td>goog.userAgent.WEBKIT = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l206" href="#l206">206</a><td>    goog.userAgent.ASSUME_WEBKIT || goog.userAgent.ASSUME_MOBILE_WEBKIT :<tr><td><a name="l207" href="#l207">207</a><td>    goog.userAgent.detectedWebkit_;<tr><td><a name="l208" href="#l208">208</a><td><tr><td><a name="l209" href="#l209">209</a><td><tr><td><a name="l210" href="#l210">210</a><td>/**<tr><td><a name="l211" href="#l211">211</a><td> * Whether the user agent is running on a mobile device.<tr><td><a name="l212" href="#l212">212</a><td> * @type {boolean}<tr><td><a name="l213" href="#l213">213</a><td> */<tr><td><a name="l214" href="#l214">214</a><td>goog.userAgent.MOBILE = goog.userAgent.ASSUME_MOBILE_WEBKIT ||<tr><td><a name="l215" href="#l215">215</a><td>                        goog.userAgent.detectedMobile_;<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * Used while transitioning code to use WEBKIT instead.<tr><td><a name="l220" href="#l220">220</a><td> * @type {boolean}<tr><td><a name="l221" href="#l221">221</a><td> * @deprecated Use {@link goog.userAgent.product.SAFARI} instead.<tr><td><a name="l222" href="#l222">222</a><td> * TODO(nicksantos): Delete this from goog.userAgent.<tr><td><a name="l223" href="#l223">223</a><td> */<tr><td><a name="l224" href="#l224">224</a><td>goog.userAgent.SAFARI = goog.userAgent.WEBKIT;<tr><td><a name="l225" href="#l225">225</a><td><tr><td><a name="l226" href="#l226">226</a><td><tr><td><a name="l227" href="#l227">227</a><td>/**<tr><td><a name="l228" href="#l228">228</a><td> * @return {string} the platform (operating system) the user agent is running<tr><td><a name="l229" href="#l229">229</a><td> *     on. Default to empty string because navigator.platform may not be defined<tr><td><a name="l230" href="#l230">230</a><td> *     (on Rhino, for example).<tr><td><a name="l231" href="#l231">231</a><td> * @private<tr><td><a name="l232" href="#l232">232</a><td> */<tr><td><a name="l233" href="#l233">233</a><td>goog.userAgent.determinePlatform_ = function() {<tr><td><a name="l234" href="#l234">234</a><td>  var navigator = goog.userAgent.getNavigator();<tr><td><a name="l235" href="#l235">235</a><td>  return navigator &amp;&amp; navigator.platform || &#39;&#39;;<tr><td><a name="l236" href="#l236">236</a><td>};<tr><td><a name="l237" href="#l237">237</a><td><tr><td><a name="l238" href="#l238">238</a><td><tr><td><a name="l239" href="#l239">239</a><td>/**<tr><td><a name="l240" href="#l240">240</a><td> * The platform (operating system) the user agent is running on. Default to<tr><td><a name="l241" href="#l241">241</a><td> * empty string because navigator.platform may not be defined (on Rhino, for<tr><td><a name="l242" href="#l242">242</a><td> * example).<tr><td><a name="l243" href="#l243">243</a><td> * @type {string}<tr><td><a name="l244" href="#l244">244</a><td> */<tr><td><a name="l245" href="#l245">245</a><td>goog.userAgent.PLATFORM = goog.userAgent.determinePlatform_();<tr><td><a name="l246" href="#l246">246</a><td><tr><td><a name="l247" href="#l247">247</a><td><tr><td><a name="l248" href="#l248">248</a><td>/**<tr><td><a name="l249" href="#l249">249</a><td> * @define {boolean} Whether the user agent is running on a Macintosh operating<tr><td><a name="l250" href="#l250">250</a><td> *     system.<tr><td><a name="l251" href="#l251">251</a><td> */<tr><td><a name="l252" href="#l252">252</a><td>goog.define(&#39;goog.userAgent.ASSUME_MAC&#39;, false);<tr><td><a name="l253" href="#l253">253</a><td><tr><td><a name="l254" href="#l254">254</a><td><tr><td><a name="l255" href="#l255">255</a><td>/**<tr><td><a name="l256" href="#l256">256</a><td> * @define {boolean} Whether the user agent is running on a Windows operating<tr><td><a name="l257" href="#l257">257</a><td> *     system.<tr><td><a name="l258" href="#l258">258</a><td> */<tr><td><a name="l259" href="#l259">259</a><td>goog.define(&#39;goog.userAgent.ASSUME_WINDOWS&#39;, false);<tr><td><a name="l260" href="#l260">260</a><td><tr><td><a name="l261" href="#l261">261</a><td><tr><td><a name="l262" href="#l262">262</a><td>/**<tr><td><a name="l263" href="#l263">263</a><td> * @define {boolean} Whether the user agent is running on a Linux operating<tr><td><a name="l264" href="#l264">264</a><td> *     system.<tr><td><a name="l265" href="#l265">265</a><td> */<tr><td><a name="l266" href="#l266">266</a><td>goog.define(&#39;goog.userAgent.ASSUME_LINUX&#39;, false);<tr><td><a name="l267" href="#l267">267</a><td><tr><td><a name="l268" href="#l268">268</a><td><tr><td><a name="l269" href="#l269">269</a><td>/**<tr><td><a name="l270" href="#l270">270</a><td> * @define {boolean} Whether the user agent is running on a X11 windowing<tr><td><a name="l271" href="#l271">271</a><td> *     system.<tr><td><a name="l272" href="#l272">272</a><td> */<tr><td><a name="l273" href="#l273">273</a><td>goog.define(&#39;goog.userAgent.ASSUME_X11&#39;, false);<tr><td><a name="l274" href="#l274">274</a><td><tr><td><a name="l275" href="#l275">275</a><td><tr><td><a name="l276" href="#l276">276</a><td>/**<tr><td><a name="l277" href="#l277">277</a><td> * @define {boolean} Whether the user agent is running on Android.<tr><td><a name="l278" href="#l278">278</a><td> */<tr><td><a name="l279" href="#l279">279</a><td>goog.define(&#39;goog.userAgent.ASSUME_ANDROID&#39;, false);<tr><td><a name="l280" href="#l280">280</a><td><tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td>/**<tr><td><a name="l283" href="#l283">283</a><td> * @define {boolean} Whether the user agent is running on an iPhone.<tr><td><a name="l284" href="#l284">284</a><td> */<tr><td><a name="l285" href="#l285">285</a><td>goog.define(&#39;goog.userAgent.ASSUME_IPHONE&#39;, false);<tr><td><a name="l286" href="#l286">286</a><td><tr><td><a name="l287" href="#l287">287</a><td><tr><td><a name="l288" href="#l288">288</a><td>/**<tr><td><a name="l289" href="#l289">289</a><td> * @define {boolean} Whether the user agent is running on an iPad.<tr><td><a name="l290" href="#l290">290</a><td> */<tr><td><a name="l291" href="#l291">291</a><td>goog.define(&#39;goog.userAgent.ASSUME_IPAD&#39;, false);<tr><td><a name="l292" href="#l292">292</a><td><tr><td><a name="l293" href="#l293">293</a><td><tr><td><a name="l294" href="#l294">294</a><td>/**<tr><td><a name="l295" href="#l295">295</a><td> * @type {boolean}<tr><td><a name="l296" href="#l296">296</a><td> * @private<tr><td><a name="l297" href="#l297">297</a><td> */<tr><td><a name="l298" href="#l298">298</a><td>goog.userAgent.PLATFORM_KNOWN_ =<tr><td><a name="l299" href="#l299">299</a><td>    goog.userAgent.ASSUME_MAC ||<tr><td><a name="l300" href="#l300">300</a><td>    goog.userAgent.ASSUME_WINDOWS ||<tr><td><a name="l301" href="#l301">301</a><td>    goog.userAgent.ASSUME_LINUX ||<tr><td><a name="l302" href="#l302">302</a><td>    goog.userAgent.ASSUME_X11 ||<tr><td><a name="l303" href="#l303">303</a><td>    goog.userAgent.ASSUME_ANDROID ||<tr><td><a name="l304" href="#l304">304</a><td>    goog.userAgent.ASSUME_IPHONE ||<tr><td><a name="l305" href="#l305">305</a><td>    goog.userAgent.ASSUME_IPAD;<tr><td><a name="l306" href="#l306">306</a><td><tr><td><a name="l307" href="#l307">307</a><td><tr><td><a name="l308" href="#l308">308</a><td>/**<tr><td><a name="l309" href="#l309">309</a><td> * Initialize the goog.userAgent constants that define which platform the user<tr><td><a name="l310" href="#l310">310</a><td> * agent is running on.<tr><td><a name="l311" href="#l311">311</a><td> * @private<tr><td><a name="l312" href="#l312">312</a><td> */<tr><td><a name="l313" href="#l313">313</a><td>goog.userAgent.initPlatform_ = function() {<tr><td><a name="l314" href="#l314">314</a><td>  /**<tr><td><a name="l315" href="#l315">315</a><td>   * Whether the user agent is running on a Macintosh operating system.<tr><td><a name="l316" href="#l316">316</a><td>   * @type {boolean}<tr><td><a name="l317" href="#l317">317</a><td>   * @private<tr><td><a name="l318" href="#l318">318</a><td>   */<tr><td><a name="l319" href="#l319">319</a><td>  goog.userAgent.detectedMac_ = goog.string.contains(goog.userAgent.PLATFORM,<tr><td><a name="l320" href="#l320">320</a><td>      &#39;Mac&#39;);<tr><td><a name="l321" href="#l321">321</a><td><tr><td><a name="l322" href="#l322">322</a><td>  /**<tr><td><a name="l323" href="#l323">323</a><td>   * Whether the user agent is running on a Windows operating system.<tr><td><a name="l324" href="#l324">324</a><td>   * @type {boolean}<tr><td><a name="l325" href="#l325">325</a><td>   * @private<tr><td><a name="l326" href="#l326">326</a><td>   */<tr><td><a name="l327" href="#l327">327</a><td>  goog.userAgent.detectedWindows_ = goog.string.contains(<tr><td><a name="l328" href="#l328">328</a><td>      goog.userAgent.PLATFORM, &#39;Win&#39;);<tr><td><a name="l329" href="#l329">329</a><td><tr><td><a name="l330" href="#l330">330</a><td>  /**<tr><td><a name="l331" href="#l331">331</a><td>   * Whether the user agent is running on a Linux operating system.<tr><td><a name="l332" href="#l332">332</a><td>   * @type {boolean}<tr><td><a name="l333" href="#l333">333</a><td>   * @private<tr><td><a name="l334" href="#l334">334</a><td>   */<tr><td><a name="l335" href="#l335">335</a><td>  goog.userAgent.detectedLinux_ = goog.string.contains(goog.userAgent.PLATFORM,<tr><td><a name="l336" href="#l336">336</a><td>      &#39;Linux&#39;);<tr><td><a name="l337" href="#l337">337</a><td><tr><td><a name="l338" href="#l338">338</a><td>  /**<tr><td><a name="l339" href="#l339">339</a><td>   * Whether the user agent is running on a X11 windowing system.<tr><td><a name="l340" href="#l340">340</a><td>   * @type {boolean}<tr><td><a name="l341" href="#l341">341</a><td>   * @private<tr><td><a name="l342" href="#l342">342</a><td>   */<tr><td><a name="l343" href="#l343">343</a><td>  goog.userAgent.detectedX11_ = !!goog.userAgent.getNavigator() &amp;&amp;<tr><td><a name="l344" href="#l344">344</a><td>      goog.string.contains(goog.userAgent.getNavigator()[&#39;appVersion&#39;] || &#39;&#39;,<tr><td><a name="l345" href="#l345">345</a><td>          &#39;X11&#39;);<tr><td><a name="l346" href="#l346">346</a><td><tr><td><a name="l347" href="#l347">347</a><td>  // Need user agent string for Android/IOS detection<tr><td><a name="l348" href="#l348">348</a><td>  var ua = goog.userAgent.getUserAgentString();<tr><td><a name="l349" href="#l349">349</a><td><tr><td><a name="l350" href="#l350">350</a><td>  /**<tr><td><a name="l351" href="#l351">351</a><td>   * Whether the user agent is running on Android.<tr><td><a name="l352" href="#l352">352</a><td>   * @type {boolean}<tr><td><a name="l353" href="#l353">353</a><td>   * @private<tr><td><a name="l354" href="#l354">354</a><td>   */<tr><td><a name="l355" href="#l355">355</a><td>  goog.userAgent.detectedAndroid_ = !!ua &amp;&amp; ua.indexOf(&#39;Android&#39;) &gt;= 0;<tr><td><a name="l356" href="#l356">356</a><td><tr><td><a name="l357" href="#l357">357</a><td>  /**<tr><td><a name="l358" href="#l358">358</a><td>   * Whether the user agent is running on an iPhone.<tr><td><a name="l359" href="#l359">359</a><td>   * @type {boolean}<tr><td><a name="l360" href="#l360">360</a><td>   * @private<tr><td><a name="l361" href="#l361">361</a><td>   */<tr><td><a name="l362" href="#l362">362</a><td>  goog.userAgent.detectedIPhone_ = !!ua &amp;&amp; ua.indexOf(&#39;iPhone&#39;) &gt;= 0;<tr><td><a name="l363" href="#l363">363</a><td><tr><td><a name="l364" href="#l364">364</a><td>  /**<tr><td><a name="l365" href="#l365">365</a><td>   * Whether the user agent is running on an iPad.<tr><td><a name="l366" href="#l366">366</a><td>   * @type {boolean}<tr><td><a name="l367" href="#l367">367</a><td>   * @private<tr><td><a name="l368" href="#l368">368</a><td>   */<tr><td><a name="l369" href="#l369">369</a><td>  goog.userAgent.detectedIPad_ = !!ua &amp;&amp; ua.indexOf(&#39;iPad&#39;) &gt;= 0;<tr><td><a name="l370" href="#l370">370</a><td>};<tr><td><a name="l371" href="#l371">371</a><td><tr><td><a name="l372" href="#l372">372</a><td><tr><td><a name="l373" href="#l373">373</a><td>if (!goog.userAgent.PLATFORM_KNOWN_) {<tr><td><a name="l374" href="#l374">374</a><td>  goog.userAgent.initPlatform_();<tr><td><a name="l375" href="#l375">375</a><td>}<tr><td><a name="l376" href="#l376">376</a><td><tr><td><a name="l377" href="#l377">377</a><td><tr><td><a name="l378" href="#l378">378</a><td>/**<tr><td><a name="l379" href="#l379">379</a><td> * Whether the user agent is running on a Macintosh operating system.<tr><td><a name="l380" href="#l380">380</a><td> * @type {boolean}<tr><td><a name="l381" href="#l381">381</a><td> */<tr><td><a name="l382" href="#l382">382</a><td>goog.userAgent.MAC = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l383" href="#l383">383</a><td>    goog.userAgent.ASSUME_MAC : goog.userAgent.detectedMac_;<tr><td><a name="l384" href="#l384">384</a><td><tr><td><a name="l385" href="#l385">385</a><td><tr><td><a name="l386" href="#l386">386</a><td>/**<tr><td><a name="l387" href="#l387">387</a><td> * Whether the user agent is running on a Windows operating system.<tr><td><a name="l388" href="#l388">388</a><td> * @type {boolean}<tr><td><a name="l389" href="#l389">389</a><td> */<tr><td><a name="l390" href="#l390">390</a><td>goog.userAgent.WINDOWS = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l391" href="#l391">391</a><td>    goog.userAgent.ASSUME_WINDOWS : goog.userAgent.detectedWindows_;<tr><td><a name="l392" href="#l392">392</a><td><tr><td><a name="l393" href="#l393">393</a><td><tr><td><a name="l394" href="#l394">394</a><td>/**<tr><td><a name="l395" href="#l395">395</a><td> * Whether the user agent is running on a Linux operating system.<tr><td><a name="l396" href="#l396">396</a><td> * @type {boolean}<tr><td><a name="l397" href="#l397">397</a><td> */<tr><td><a name="l398" href="#l398">398</a><td>goog.userAgent.LINUX = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l399" href="#l399">399</a><td>    goog.userAgent.ASSUME_LINUX : goog.userAgent.detectedLinux_;<tr><td><a name="l400" href="#l400">400</a><td><tr><td><a name="l401" href="#l401">401</a><td><tr><td><a name="l402" href="#l402">402</a><td>/**<tr><td><a name="l403" href="#l403">403</a><td> * Whether the user agent is running on a X11 windowing system.<tr><td><a name="l404" href="#l404">404</a><td> * @type {boolean}<tr><td><a name="l405" href="#l405">405</a><td> */<tr><td><a name="l406" href="#l406">406</a><td>goog.userAgent.X11 = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l407" href="#l407">407</a><td>    goog.userAgent.ASSUME_X11 : goog.userAgent.detectedX11_;<tr><td><a name="l408" href="#l408">408</a><td><tr><td><a name="l409" href="#l409">409</a><td><tr><td><a name="l410" href="#l410">410</a><td>/**<tr><td><a name="l411" href="#l411">411</a><td> * Whether the user agent is running on Android.<tr><td><a name="l412" href="#l412">412</a><td> * @type {boolean}<tr><td><a name="l413" href="#l413">413</a><td> */<tr><td><a name="l414" href="#l414">414</a><td>goog.userAgent.ANDROID = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l415" href="#l415">415</a><td>    goog.userAgent.ASSUME_ANDROID : goog.userAgent.detectedAndroid_;<tr><td><a name="l416" href="#l416">416</a><td><tr><td><a name="l417" href="#l417">417</a><td><tr><td><a name="l418" href="#l418">418</a><td>/**<tr><td><a name="l419" href="#l419">419</a><td> * Whether the user agent is running on an iPhone.<tr><td><a name="l420" href="#l420">420</a><td> * @type {boolean}<tr><td><a name="l421" href="#l421">421</a><td> */<tr><td><a name="l422" href="#l422">422</a><td>goog.userAgent.IPHONE = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l423" href="#l423">423</a><td>    goog.userAgent.ASSUME_IPHONE : goog.userAgent.detectedIPhone_;<tr><td><a name="l424" href="#l424">424</a><td><tr><td><a name="l425" href="#l425">425</a><td><tr><td><a name="l426" href="#l426">426</a><td>/**<tr><td><a name="l427" href="#l427">427</a><td> * Whether the user agent is running on an iPad.<tr><td><a name="l428" href="#l428">428</a><td> * @type {boolean}<tr><td><a name="l429" href="#l429">429</a><td> */<tr><td><a name="l430" href="#l430">430</a><td>goog.userAgent.IPAD = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l431" href="#l431">431</a><td>    goog.userAgent.ASSUME_IPAD : goog.userAgent.detectedIPad_;<tr><td><a name="l432" href="#l432">432</a><td><tr><td><a name="l433" href="#l433">433</a><td><tr><td><a name="l434" href="#l434">434</a><td>/**<tr><td><a name="l435" href="#l435">435</a><td> * @return {string} The string that describes the version number of the user<tr><td><a name="l436" href="#l436">436</a><td> *     agent.<tr><td><a name="l437" href="#l437">437</a><td> * @private<tr><td><a name="l438" href="#l438">438</a><td> */<tr><td><a name="l439" href="#l439">439</a><td>goog.userAgent.determineVersion_ = function() {<tr><td><a name="l440" href="#l440">440</a><td>  // All browsers have different ways to detect the version and they all have<tr><td><a name="l441" href="#l441">441</a><td>  // different naming schemes.<tr><td><a name="l442" href="#l442">442</a><td><tr><td><a name="l443" href="#l443">443</a><td>  // version is a string rather than a number because it may contain &#39;b&#39;, &#39;a&#39;,<tr><td><a name="l444" href="#l444">444</a><td>  // and so on.<tr><td><a name="l445" href="#l445">445</a><td>  var version = &#39;&#39;, re;<tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td>  if (goog.userAgent.OPERA &amp;&amp; goog.global[&#39;opera&#39;]) {<tr><td><a name="l448" href="#l448">448</a><td>    var operaVersion = goog.global[&#39;opera&#39;].version;<tr><td><a name="l449" href="#l449">449</a><td>    version = typeof operaVersion == &#39;function&#39; ? operaVersion() : operaVersion;<tr><td><a name="l450" href="#l450">450</a><td>  } else {<tr><td><a name="l451" href="#l451">451</a><td>    if (goog.userAgent.GECKO) {<tr><td><a name="l452" href="#l452">452</a><td>      re = /rv\:([^\);]+)(\)|;)/;<tr><td><a name="l453" href="#l453">453</a><td>    } else if (goog.userAgent.IE) {<tr><td><a name="l454" href="#l454">454</a><td>      re = /MSIE\s+([^\);]+)(\)|;)/;<tr><td><a name="l455" href="#l455">455</a><td>    } else if (goog.userAgent.WEBKIT) {<tr><td><a name="l456" href="#l456">456</a><td>      // WebKit/125.4<tr><td><a name="l457" href="#l457">457</a><td>      re = /WebKit\/(\S+)/;<tr><td><a name="l458" href="#l458">458</a><td>    }<tr><td><a name="l459" href="#l459">459</a><td>    if (re) {<tr><td><a name="l460" href="#l460">460</a><td>      var arr = re.exec(goog.userAgent.getUserAgentString());<tr><td><a name="l461" href="#l461">461</a><td>      version = arr ? arr[1] : &#39;&#39;;<tr><td><a name="l462" href="#l462">462</a><td>    }<tr><td><a name="l463" href="#l463">463</a><td>  }<tr><td><a name="l464" href="#l464">464</a><td>  if (goog.userAgent.IE) {<tr><td><a name="l465" href="#l465">465</a><td>    // IE9 can be in document mode 9 but be reporting an inconsistent user agent<tr><td><a name="l466" href="#l466">466</a><td>    // version.  If it is identifying as a version lower than 9 we take the<tr><td><a name="l467" href="#l467">467</a><td>    // documentMode as the version instead.  IE8 has similar behavior.<tr><td><a name="l468" href="#l468">468</a><td>    // It is recommended to set the X-UA-Compatible header to ensure that IE9<tr><td><a name="l469" href="#l469">469</a><td>    // uses documentMode 9.<tr><td><a name="l470" href="#l470">470</a><td>    var docMode = goog.userAgent.getDocumentMode_();<tr><td><a name="l471" href="#l471">471</a><td>    if (docMode &gt; parseFloat(version)) {<tr><td><a name="l472" href="#l472">472</a><td>      return String(docMode);<tr><td><a name="l473" href="#l473">473</a><td>    }<tr><td><a name="l474" href="#l474">474</a><td>  }<tr><td><a name="l475" href="#l475">475</a><td>  return version;<tr><td><a name="l476" href="#l476">476</a><td>};<tr><td><a name="l477" href="#l477">477</a><td><tr><td><a name="l478" href="#l478">478</a><td><tr><td><a name="l479" href="#l479">479</a><td>/**<tr><td><a name="l480" href="#l480">480</a><td> * @return {number|undefined} Returns the document mode (for testing).<tr><td><a name="l481" href="#l481">481</a><td> * @private<tr><td><a name="l482" href="#l482">482</a><td> */<tr><td><a name="l483" href="#l483">483</a><td>goog.userAgent.getDocumentMode_ = function() {<tr><td><a name="l484" href="#l484">484</a><td>  // NOTE(user): goog.userAgent may be used in context where there is no DOM.<tr><td><a name="l485" href="#l485">485</a><td>  var doc = goog.global[&#39;document&#39;];<tr><td><a name="l486" href="#l486">486</a><td>  return doc ? doc[&#39;documentMode&#39;] : undefined;<tr><td><a name="l487" href="#l487">487</a><td>};<tr><td><a name="l488" href="#l488">488</a><td><tr><td><a name="l489" href="#l489">489</a><td><tr><td><a name="l490" href="#l490">490</a><td>/**<tr><td><a name="l491" href="#l491">491</a><td> * The version of the user agent. This is a string because it might contain<tr><td><a name="l492" href="#l492">492</a><td> * &#39;b&#39; (as in beta) as well as multiple dots.<tr><td><a name="l493" href="#l493">493</a><td> * @type {string}<tr><td><a name="l494" href="#l494">494</a><td> */<tr><td><a name="l495" href="#l495">495</a><td>goog.userAgent.VERSION = goog.userAgent.determineVersion_();<tr><td><a name="l496" href="#l496">496</a><td><tr><td><a name="l497" href="#l497">497</a><td><tr><td><a name="l498" href="#l498">498</a><td>/**<tr><td><a name="l499" href="#l499">499</a><td> * Compares two version numbers.<tr><td><a name="l500" href="#l500">500</a><td> *<tr><td><a name="l501" href="#l501">501</a><td> * @param {string} v1 Version of first item.<tr><td><a name="l502" href="#l502">502</a><td> * @param {string} v2 Version of second item.<tr><td><a name="l503" href="#l503">503</a><td> *<tr><td><a name="l504" href="#l504">504</a><td> * @return {number}  1 if first argument is higher<tr><td><a name="l505" href="#l505">505</a><td> *                   0 if arguments are equal<tr><td><a name="l506" href="#l506">506</a><td> *                  -1 if second argument is higher.<tr><td><a name="l507" href="#l507">507</a><td> * @deprecated Use goog.string.compareVersions.<tr><td><a name="l508" href="#l508">508</a><td> */<tr><td><a name="l509" href="#l509">509</a><td>goog.userAgent.compare = function(v1, v2) {<tr><td><a name="l510" href="#l510">510</a><td>  return goog.string.compareVersions(v1, v2);<tr><td><a name="l511" href="#l511">511</a><td>};<tr><td><a name="l512" href="#l512">512</a><td><tr><td><a name="l513" href="#l513">513</a><td><tr><td><a name="l514" href="#l514">514</a><td>/**<tr><td><a name="l515" href="#l515">515</a><td> * Cache for {@link goog.userAgent.isVersionOrHigher}.<tr><td><a name="l516" href="#l516">516</a><td> * Calls to compareVersions are surprisingly expensive and, as a browser&#39;s<tr><td><a name="l517" href="#l517">517</a><td> * version number is unlikely to change during a session, we cache the results.<tr><td><a name="l518" href="#l518">518</a><td> * @const<tr><td><a name="l519" href="#l519">519</a><td> * @private<tr><td><a name="l520" href="#l520">520</a><td> */<tr><td><a name="l521" href="#l521">521</a><td>goog.userAgent.isVersionOrHigherCache_ = {};<tr><td><a name="l522" href="#l522">522</a><td><tr><td><a name="l523" href="#l523">523</a><td><tr><td><a name="l524" href="#l524">524</a><td>/**<tr><td><a name="l525" href="#l525">525</a><td> * Whether the user agent version is higher or the same as the given version.<tr><td><a name="l526" href="#l526">526</a><td> * NOTE: When checking the version numbers for Firefox and Safari, be sure to<tr><td><a name="l527" href="#l527">527</a><td> * use the engine&#39;s version, not the browser&#39;s version number.  For example,<tr><td><a name="l528" href="#l528">528</a><td> * Firefox 3.0 corresponds to Gecko 1.9 and Safari 3.0 to Webkit 522.11.<tr><td><a name="l529" href="#l529">529</a><td> * Opera and Internet Explorer versions match the product release number.&lt;br&gt;<tr><td><a name="l530" href="#l530">530</a><td> * @see &lt;a href=&quot;http://en.wikipedia.org/wiki/Safari_version_history&quot;&gt;<tr><td><a name="l531" href="#l531">531</a><td> *     Webkit&lt;/a&gt;<tr><td><a name="l532" href="#l532">532</a><td> * @see &lt;a href=&quot;http://en.wikipedia.org/wiki/Gecko_engine&quot;&gt;Gecko&lt;/a&gt;<tr><td><a name="l533" href="#l533">533</a><td> *<tr><td><a name="l534" href="#l534">534</a><td> * @param {string|number} version The version to check.<tr><td><a name="l535" href="#l535">535</a><td> * @return {boolean} Whether the user agent version is higher or the same as<tr><td><a name="l536" href="#l536">536</a><td> *     the given version.<tr><td><a name="l537" href="#l537">537</a><td> */<tr><td><a name="l538" href="#l538">538</a><td>goog.userAgent.isVersionOrHigher = function(version) {<tr><td><a name="l539" href="#l539">539</a><td>  return goog.userAgent.ASSUME_ANY_VERSION ||<tr><td><a name="l540" href="#l540">540</a><td>      goog.userAgent.isVersionOrHigherCache_[version] ||<tr><td><a name="l541" href="#l541">541</a><td>      (goog.userAgent.isVersionOrHigherCache_[version] =<tr><td><a name="l542" href="#l542">542</a><td>          goog.string.compareVersions(goog.userAgent.VERSION, version) &gt;= 0);<tr><td><a name="l543" href="#l543">543</a><td>};<tr><td><a name="l544" href="#l544">544</a><td><tr><td><a name="l545" href="#l545">545</a><td><tr><td><a name="l546" href="#l546">546</a><td>/**<tr><td><a name="l547" href="#l547">547</a><td> * Deprecated alias to {@code goog.userAgent.isVersionOrHigher}.<tr><td><a name="l548" href="#l548">548</a><td> * @param {string|number} version The version to check.<tr><td><a name="l549" href="#l549">549</a><td> * @return {boolean} Whether the user agent version is higher or the same as<tr><td><a name="l550" href="#l550">550</a><td> *     the given version.<tr><td><a name="l551" href="#l551">551</a><td> * @deprecated Use goog.userAgent.isVersionOrHigher().<tr><td><a name="l552" href="#l552">552</a><td> */<tr><td><a name="l553" href="#l553">553</a><td>goog.userAgent.isVersion = goog.userAgent.isVersionOrHigher;<tr><td><a name="l554" href="#l554">554</a><td><tr><td><a name="l555" href="#l555">555</a><td><tr><td><a name="l556" href="#l556">556</a><td>/**<tr><td><a name="l557" href="#l557">557</a><td> * Whether the IE effective document mode is higher or the same as the given<tr><td><a name="l558" href="#l558">558</a><td> * document mode version.<tr><td><a name="l559" href="#l559">559</a><td> * NOTE: Only for IE, return false for another browser.<tr><td><a name="l560" href="#l560">560</a><td> *<tr><td><a name="l561" href="#l561">561</a><td> * @param {number} documentMode The document mode version to check.<tr><td><a name="l562" href="#l562">562</a><td> * @return {boolean} Whether the IE effective document mode is higher or the<tr><td><a name="l563" href="#l563">563</a><td> *     same as the given version.<tr><td><a name="l564" href="#l564">564</a><td> */<tr><td><a name="l565" href="#l565">565</a><td>goog.userAgent.isDocumentModeOrHigher = function(documentMode) {<tr><td><a name="l566" href="#l566">566</a><td>  return goog.userAgent.IE &amp;&amp; goog.userAgent.DOCUMENT_MODE &gt;= documentMode;<tr><td><a name="l567" href="#l567">567</a><td>};<tr><td><a name="l568" href="#l568">568</a><td><tr><td><a name="l569" href="#l569">569</a><td><tr><td><a name="l570" href="#l570">570</a><td>/**<tr><td><a name="l571" href="#l571">571</a><td> * Deprecated alias to {@code goog.userAgent.isDocumentModeOrHigher}.<tr><td><a name="l572" href="#l572">572</a><td> * @param {number} version The version to check.<tr><td><a name="l573" href="#l573">573</a><td> * @return {boolean} Whether the IE effective document mode is higher or the<tr><td><a name="l574" href="#l574">574</a><td> *      same as the given version.<tr><td><a name="l575" href="#l575">575</a><td> */<tr><td><a name="l576" href="#l576">576</a><td>goog.userAgent.isDocumentMode = goog.userAgent.isDocumentModeOrHigher;<tr><td><a name="l577" href="#l577">577</a><td><tr><td><a name="l578" href="#l578">578</a><td><tr><td><a name="l579" href="#l579">579</a><td>/**<tr><td><a name="l580" href="#l580">580</a><td> * For IE version &lt; 7, documentMode is undefined, so attempt to use the<tr><td><a name="l581" href="#l581">581</a><td> * CSS1Compat property to see if we are in standards mode. If we are in<tr><td><a name="l582" href="#l582">582</a><td> * standards mode, treat the browser version as the document mode. Otherwise,<tr><td><a name="l583" href="#l583">583</a><td> * IE is emulating version 5.<tr><td><a name="l584" href="#l584">584</a><td> * @type {number|undefined}<tr><td><a name="l585" href="#l585">585</a><td> * @const<tr><td><a name="l586" href="#l586">586</a><td> */<tr><td><a name="l587" href="#l587">587</a><td>goog.userAgent.DOCUMENT_MODE = (function() {<tr><td><a name="l588" href="#l588">588</a><td>  var doc = goog.global[&#39;document&#39;];<tr><td><a name="l589" href="#l589">589</a><td>  if (!doc || !goog.userAgent.IE) {<tr><td><a name="l590" href="#l590">590</a><td>    return undefined;<tr><td><a name="l591" href="#l591">591</a><td>  }<tr><td><a name="l592" href="#l592">592</a><td>  var mode = goog.userAgent.getDocumentMode_();<tr><td><a name="l593" href="#l593">593</a><td>  return mode || (doc[&#39;compatMode&#39;] == &#39;CSS1Compat&#39; ?<tr><td><a name="l594" href="#l594">594</a><td>      parseInt(goog.userAgent.VERSION, 10) : 5);<tr><td><a name="l595" href="#l595">595</a><td>})();</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>useragent.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/useragent/useragent.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a id="l2"></a><a href="#l2">2</a><td>//<tr><td><a id="l3"></a><a href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a id="l4"></a><a href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a id="l5"></a><a href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a id="l6"></a><a href="#l6">6</a><td>//<tr><td><a id="l7"></a><a href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a id="l10"></a><a href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a id="l11"></a><a href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a id="l12"></a><a href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a id="l13"></a><a href="#l13">13</a><td>// limitations under the License.<tr><td><a id="l14"></a><a href="#l14">14</a><td><tr><td><a id="l15"></a><a href="#l15">15</a><td>/**<tr><td><a id="l16"></a><a href="#l16">16</a><td> * @fileoverview Rendering engine detection.<tr><td><a id="l17"></a><a href="#l17">17</a><td> * @see &lt;a href=&quot;http://www.useragentstring.com/&quot;&gt;User agent strings&lt;/a&gt;<tr><td><a id="l18"></a><a href="#l18">18</a><td> * For information on the browser brand (such as Safari versus Chrome), see<tr><td><a id="l19"></a><a href="#l19">19</a><td> * goog.userAgent.product.<tr><td><a id="l20"></a><a href="#l20">20</a><td> * @author arv@google.com (Erik Arvidsson)<tr><td><a id="l21"></a><a href="#l21">21</a><td> * @see ../demos/useragent.html<tr><td><a id="l22"></a><a href="#l22">22</a><td> */<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;goog.userAgent&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.labs.userAgent.browser&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.labs.userAgent.engine&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.labs.userAgent.platform&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.labs.userAgent.util&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.string&#39;);<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>/**<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @define {boolean} Whether we know at compile-time that the browser is IE.<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.define(&#39;goog.userAgent.ASSUME_IE&#39;, false);<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> * @define {boolean} Whether we know at compile-time that the browser is EDGE.<tr><td><a id="l41"></a><a href="#l41">41</a><td> */<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.define(&#39;goog.userAgent.ASSUME_EDGE&#39;, false);<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * @define {boolean} Whether we know at compile-time that the browser is GECKO.<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.define(&#39;goog.userAgent.ASSUME_GECKO&#39;, false);<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> * @define {boolean} Whether we know at compile-time that the browser is WEBKIT.<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.define(&#39;goog.userAgent.ASSUME_WEBKIT&#39;, false);<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>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @define {boolean} Whether we know at compile-time that the browser is a<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     mobile device running WebKit e.g. iPhone or Android.<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>goog.define(&#39;goog.userAgent.ASSUME_MOBILE_WEBKIT&#39;, false);<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>/**<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @define {boolean} Whether we know at compile-time that the browser is OPERA.<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.define(&#39;goog.userAgent.ASSUME_OPERA&#39;, false);<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>/**<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @define {boolean} Whether the<tr><td><a id="l72"></a><a href="#l72">72</a><td> *     {@code goog.userAgent.isVersionOrHigher}<tr><td><a id="l73"></a><a href="#l73">73</a><td> *     function will return true for any version.<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td>goog.define(&#39;goog.userAgent.ASSUME_ANY_VERSION&#39;, false);<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>/**<tr><td><a id="l79"></a><a href="#l79">79</a><td> * Whether we know the browser engine at compile-time.<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @type {boolean}<tr><td><a id="l81"></a><a href="#l81">81</a><td> * @private<tr><td><a id="l82"></a><a href="#l82">82</a><td> */<tr><td><a id="l83"></a><a href="#l83">83</a><td>goog.userAgent.BROWSER_KNOWN_ =<tr><td><a id="l84"></a><a href="#l84">84</a><td>    goog.userAgent.ASSUME_IE ||<tr><td><a id="l85"></a><a href="#l85">85</a><td>    goog.userAgent.ASSUME_EDGE ||<tr><td><a id="l86"></a><a href="#l86">86</a><td>    goog.userAgent.ASSUME_GECKO ||<tr><td><a id="l87"></a><a href="#l87">87</a><td>    goog.userAgent.ASSUME_MOBILE_WEBKIT ||<tr><td><a id="l88"></a><a href="#l88">88</a><td>    goog.userAgent.ASSUME_WEBKIT ||<tr><td><a id="l89"></a><a href="#l89">89</a><td>    goog.userAgent.ASSUME_OPERA;<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> * Returns the userAgent string for the current browser.<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 {string} The userAgent string.<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.userAgent.getUserAgentString = function() {<tr><td><a id="l98"></a><a href="#l98">98</a><td>  return goog.labs.userAgent.util.getUserAgent();<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> * TODO(nnaze): Change type to &quot;Navigator&quot; and update compilation targets.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @return {Object} The native navigator object.<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>goog.userAgent.getNavigator = function() {<tr><td><a id="l107"></a><a href="#l107">107</a><td>  // Need a local navigator reference instead of using the global one,<tr><td><a id="l108"></a><a href="#l108">108</a><td>  // to avoid the rare case where they reference different objects.<tr><td><a id="l109"></a><a href="#l109">109</a><td>  // (in a WorkerPool, for example).<tr><td><a id="l110"></a><a href="#l110">110</a><td>  return goog.global[&#39;navigator&#39;] || null;<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> * Whether the user agent is Opera.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @type {boolean}<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>goog.userAgent.OPERA = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a id="l119"></a><a href="#l119">119</a><td>    goog.userAgent.ASSUME_OPERA :<tr><td><a id="l120"></a><a href="#l120">120</a><td>    goog.labs.userAgent.browser.isOpera();<tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>/**<tr><td><a id="l124"></a><a href="#l124">124</a><td> * Whether the user agent is Internet Explorer.<tr><td><a id="l125"></a><a href="#l125">125</a><td> * @type {boolean}<tr><td><a id="l126"></a><a href="#l126">126</a><td> */<tr><td><a id="l127"></a><a href="#l127">127</a><td>goog.userAgent.IE = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a id="l128"></a><a href="#l128">128</a><td>    goog.userAgent.ASSUME_IE :<tr><td><a id="l129"></a><a href="#l129">129</a><td>    goog.labs.userAgent.browser.isIE();<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>/**<tr><td><a id="l133"></a><a href="#l133">133</a><td> * Whether the user agent is Microsoft Edge.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @type {boolean}<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td>goog.userAgent.EDGE = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a id="l137"></a><a href="#l137">137</a><td>    goog.userAgent.ASSUME_EDGE :<tr><td><a id="l138"></a><a href="#l138">138</a><td>    goog.labs.userAgent.engine.isEdge();<tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td>/**<tr><td><a id="l142"></a><a href="#l142">142</a><td> * Whether the user agent is MS Internet Explorer or MS Edge.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @type {boolean}<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.userAgent.EDGE_OR_IE = goog.userAgent.EDGE || goog.userAgent.IE;<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> * Whether the user agent is Gecko. Gecko is the rendering engine used by<tr><td><a id="l150"></a><a href="#l150">150</a><td> * Mozilla, Firefox, and others.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @type {boolean}<tr><td><a id="l152"></a><a href="#l152">152</a><td> */<tr><td><a id="l153"></a><a href="#l153">153</a><td>goog.userAgent.GECKO = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a id="l154"></a><a href="#l154">154</a><td>    goog.userAgent.ASSUME_GECKO :<tr><td><a id="l155"></a><a href="#l155">155</a><td>    goog.labs.userAgent.engine.isGecko();<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> * Whether the user agent is WebKit. WebKit is the rendering engine that<tr><td><a id="l160"></a><a href="#l160">160</a><td> * Safari, Android and others use.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @type {boolean}<tr><td><a id="l162"></a><a href="#l162">162</a><td> */<tr><td><a id="l163"></a><a href="#l163">163</a><td>goog.userAgent.WEBKIT = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a id="l164"></a><a href="#l164">164</a><td>    goog.userAgent.ASSUME_WEBKIT || goog.userAgent.ASSUME_MOBILE_WEBKIT :<tr><td><a id="l165"></a><a href="#l165">165</a><td>    goog.labs.userAgent.engine.isWebKit();<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>/**<tr><td><a id="l169"></a><a href="#l169">169</a><td> * Whether the user agent is running on a mobile device.<tr><td><a id="l170"></a><a href="#l170">170</a><td> *<tr><td><a id="l171"></a><a href="#l171">171</a><td> * This is a separate function so that the logic can be tested.<tr><td><a id="l172"></a><a href="#l172">172</a><td> *<tr><td><a id="l173"></a><a href="#l173">173</a><td> * TODO(nnaze): Investigate swapping in goog.labs.userAgent.device.isMobile().<tr><td><a id="l174"></a><a href="#l174">174</a><td> *<tr><td><a id="l175"></a><a href="#l175">175</a><td> * @return {boolean} Whether the user agent is running on a mobile device.<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @private<tr><td><a id="l177"></a><a href="#l177">177</a><td> */<tr><td><a id="l178"></a><a href="#l178">178</a><td>goog.userAgent.isMobile_ = function() {<tr><td><a id="l179"></a><a href="#l179">179</a><td>  return goog.userAgent.WEBKIT &amp;&amp;<tr><td><a id="l180"></a><a href="#l180">180</a><td>         goog.labs.userAgent.util.matchUserAgent(&#39;Mobile&#39;);<tr><td><a id="l181"></a><a href="#l181">181</a><td>};<tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td>/**<tr><td><a id="l185"></a><a href="#l185">185</a><td> * Whether the user agent is running on a mobile device.<tr><td><a id="l186"></a><a href="#l186">186</a><td> *<tr><td><a id="l187"></a><a href="#l187">187</a><td> * TODO(nnaze): Consider deprecating MOBILE when labs.userAgent<tr><td><a id="l188"></a><a href="#l188">188</a><td> *   is promoted as the gecko/webkit logic is likely inaccurate.<tr><td><a id="l189"></a><a href="#l189">189</a><td> *<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @type {boolean}<tr><td><a id="l191"></a><a href="#l191">191</a><td> */<tr><td><a id="l192"></a><a href="#l192">192</a><td>goog.userAgent.MOBILE = goog.userAgent.ASSUME_MOBILE_WEBKIT ||<tr><td><a id="l193"></a><a href="#l193">193</a><td>                        goog.userAgent.isMobile_();<tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td>/**<tr><td><a id="l197"></a><a href="#l197">197</a><td> * Used while transitioning code to use WEBKIT instead.<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @type {boolean}<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @deprecated Use {@link goog.userAgent.product.SAFARI} instead.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * TODO(nicksantos): Delete this from goog.userAgent.<tr><td><a id="l201"></a><a href="#l201">201</a><td> */<tr><td><a id="l202"></a><a href="#l202">202</a><td>goog.userAgent.SAFARI = goog.userAgent.WEBKIT;<tr><td><a id="l203"></a><a href="#l203">203</a><td><tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td>/**<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {string} the platform (operating system) the user agent is running<tr><td><a id="l207"></a><a href="#l207">207</a><td> *     on. Default to empty string because navigator.platform may not be defined<tr><td><a id="l208"></a><a href="#l208">208</a><td> *     (on Rhino, for example).<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @private<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>goog.userAgent.determinePlatform_ = function() {<tr><td><a id="l212"></a><a href="#l212">212</a><td>  var navigator = goog.userAgent.getNavigator();<tr><td><a id="l213"></a><a href="#l213">213</a><td>  return navigator &amp;&amp; navigator.platform || &#39;&#39;;<tr><td><a id="l214"></a><a href="#l214">214</a><td>};<tr><td><a id="l215"></a><a href="#l215">215</a><td><tr><td><a id="l216"></a><a href="#l216">216</a><td><tr><td><a id="l217"></a><a href="#l217">217</a><td>/**<tr><td><a id="l218"></a><a href="#l218">218</a><td> * The platform (operating system) the user agent is running on. Default to<tr><td><a id="l219"></a><a href="#l219">219</a><td> * empty string because navigator.platform may not be defined (on Rhino, for<tr><td><a id="l220"></a><a href="#l220">220</a><td> * example).<tr><td><a id="l221"></a><a href="#l221">221</a><td> * @type {string}<tr><td><a id="l222"></a><a href="#l222">222</a><td> */<tr><td><a id="l223"></a><a href="#l223">223</a><td>goog.userAgent.PLATFORM = goog.userAgent.determinePlatform_();<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td><tr><td><a id="l226"></a><a href="#l226">226</a><td>/**<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @define {boolean} Whether the user agent is running on a Macintosh operating<tr><td><a id="l228"></a><a href="#l228">228</a><td> *     system.<tr><td><a id="l229"></a><a href="#l229">229</a><td> */<tr><td><a id="l230"></a><a href="#l230">230</a><td>goog.define(&#39;goog.userAgent.ASSUME_MAC&#39;, false);<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @define {boolean} Whether the user agent is running on a Windows operating<tr><td><a id="l235"></a><a href="#l235">235</a><td> *     system.<tr><td><a id="l236"></a><a href="#l236">236</a><td> */<tr><td><a id="l237"></a><a href="#l237">237</a><td>goog.define(&#39;goog.userAgent.ASSUME_WINDOWS&#39;, false);<tr><td><a id="l238"></a><a href="#l238">238</a><td><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> * @define {boolean} Whether the user agent is running on a Linux operating<tr><td><a id="l242"></a><a href="#l242">242</a><td> *     system.<tr><td><a id="l243"></a><a href="#l243">243</a><td> */<tr><td><a id="l244"></a><a href="#l244">244</a><td>goog.define(&#39;goog.userAgent.ASSUME_LINUX&#39;, false);<tr><td><a id="l245"></a><a href="#l245">245</a><td><tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>/**<tr><td><a id="l248"></a><a href="#l248">248</a><td> * @define {boolean} Whether the user agent is running on a X11 windowing<tr><td><a id="l249"></a><a href="#l249">249</a><td> *     system.<tr><td><a id="l250"></a><a href="#l250">250</a><td> */<tr><td><a id="l251"></a><a href="#l251">251</a><td>goog.define(&#39;goog.userAgent.ASSUME_X11&#39;, false);<tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td>/**<tr><td><a id="l255"></a><a href="#l255">255</a><td> * @define {boolean} Whether the user agent is running on Android.<tr><td><a id="l256"></a><a href="#l256">256</a><td> */<tr><td><a id="l257"></a><a href="#l257">257</a><td>goog.define(&#39;goog.userAgent.ASSUME_ANDROID&#39;, false);<tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td>/**<tr><td><a id="l261"></a><a href="#l261">261</a><td> * @define {boolean} Whether the user agent is running on an iPhone.<tr><td><a id="l262"></a><a href="#l262">262</a><td> */<tr><td><a id="l263"></a><a href="#l263">263</a><td>goog.define(&#39;goog.userAgent.ASSUME_IPHONE&#39;, false);<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td>/**<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @define {boolean} Whether the user agent is running on an iPad.<tr><td><a id="l268"></a><a href="#l268">268</a><td> */<tr><td><a id="l269"></a><a href="#l269">269</a><td>goog.define(&#39;goog.userAgent.ASSUME_IPAD&#39;, false);<tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td><tr><td><a id="l272"></a><a href="#l272">272</a><td>/**<tr><td><a id="l273"></a><a href="#l273">273</a><td> * @type {boolean}<tr><td><a id="l274"></a><a href="#l274">274</a><td> * @private<tr><td><a id="l275"></a><a href="#l275">275</a><td> */<tr><td><a id="l276"></a><a href="#l276">276</a><td>goog.userAgent.PLATFORM_KNOWN_ =<tr><td><a id="l277"></a><a href="#l277">277</a><td>    goog.userAgent.ASSUME_MAC ||<tr><td><a id="l278"></a><a href="#l278">278</a><td>    goog.userAgent.ASSUME_WINDOWS ||<tr><td><a id="l279"></a><a href="#l279">279</a><td>    goog.userAgent.ASSUME_LINUX ||<tr><td><a id="l280"></a><a href="#l280">280</a><td>    goog.userAgent.ASSUME_X11 ||<tr><td><a id="l281"></a><a href="#l281">281</a><td>    goog.userAgent.ASSUME_ANDROID ||<tr><td><a id="l282"></a><a href="#l282">282</a><td>    goog.userAgent.ASSUME_IPHONE ||<tr><td><a id="l283"></a><a href="#l283">283</a><td>    goog.userAgent.ASSUME_IPAD;<tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td>/**<tr><td><a id="l287"></a><a href="#l287">287</a><td> * Whether the user agent is running on a Macintosh operating system.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @type {boolean}<tr><td><a id="l289"></a><a href="#l289">289</a><td> */<tr><td><a id="l290"></a><a href="#l290">290</a><td>goog.userAgent.MAC = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a id="l291"></a><a href="#l291">291</a><td>    goog.userAgent.ASSUME_MAC : goog.labs.userAgent.platform.isMacintosh();<tr><td><a id="l292"></a><a href="#l292">292</a><td><tr><td><a id="l293"></a><a href="#l293">293</a><td><tr><td><a id="l294"></a><a href="#l294">294</a><td>/**<tr><td><a id="l295"></a><a href="#l295">295</a><td> * Whether the user agent is running on a Windows operating system.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @type {boolean}<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>goog.userAgent.WINDOWS = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a id="l299"></a><a href="#l299">299</a><td>    goog.userAgent.ASSUME_WINDOWS :<tr><td><a id="l300"></a><a href="#l300">300</a><td>    goog.labs.userAgent.platform.isWindows();<tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td><tr><td><a id="l303"></a><a href="#l303">303</a><td>/**<tr><td><a id="l304"></a><a href="#l304">304</a><td> * Whether the user agent is Linux per the legacy behavior of<tr><td><a id="l305"></a><a href="#l305">305</a><td> * goog.userAgent.LINUX, which considered ChromeOS to also be<tr><td><a id="l306"></a><a href="#l306">306</a><td> * Linux.<tr><td><a id="l307"></a><a href="#l307">307</a><td> * @return {boolean}<tr><td><a id="l308"></a><a href="#l308">308</a><td> * @private<tr><td><a id="l309"></a><a href="#l309">309</a><td> */<tr><td><a id="l310"></a><a href="#l310">310</a><td>goog.userAgent.isLegacyLinux_ = function() {<tr><td><a id="l311"></a><a href="#l311">311</a><td>  return goog.labs.userAgent.platform.isLinux() ||<tr><td><a id="l312"></a><a href="#l312">312</a><td>      goog.labs.userAgent.platform.isChromeOS();<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>/**<tr><td><a id="l317"></a><a href="#l317">317</a><td> * Whether the user agent is running on a Linux operating system.<tr><td><a id="l318"></a><a href="#l318">318</a><td> *<tr><td><a id="l319"></a><a href="#l319">319</a><td> * Note that goog.userAgent.LINUX considers ChromeOS to be Linux,<tr><td><a id="l320"></a><a href="#l320">320</a><td> * while goog.labs.userAgent.platform considers ChromeOS and<tr><td><a id="l321"></a><a href="#l321">321</a><td> * Linux to be different OSes.<tr><td><a id="l322"></a><a href="#l322">322</a><td> *<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @type {boolean}<tr><td><a id="l324"></a><a href="#l324">324</a><td> */<tr><td><a id="l325"></a><a href="#l325">325</a><td>goog.userAgent.LINUX = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a id="l326"></a><a href="#l326">326</a><td>    goog.userAgent.ASSUME_LINUX :<tr><td><a id="l327"></a><a href="#l327">327</a><td>    goog.userAgent.isLegacyLinux_();<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @return {boolean} Whether the user agent is an X11 windowing system.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @private<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>goog.userAgent.isX11_ = function() {<tr><td><a id="l335"></a><a href="#l335">335</a><td>  var navigator = goog.userAgent.getNavigator();<tr><td><a id="l336"></a><a href="#l336">336</a><td>  return !!navigator &amp;&amp;<tr><td><a id="l337"></a><a href="#l337">337</a><td>      goog.string.contains(navigator[&#39;appVersion&#39;] || &#39;&#39;, &#39;X11&#39;);<tr><td><a id="l338"></a><a href="#l338">338</a><td>};<tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td>/**<tr><td><a id="l342"></a><a href="#l342">342</a><td> * Whether the user agent is running on a X11 windowing system.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @type {boolean}<tr><td><a id="l344"></a><a href="#l344">344</a><td> */<tr><td><a id="l345"></a><a href="#l345">345</a><td>goog.userAgent.X11 = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a id="l346"></a><a href="#l346">346</a><td>    goog.userAgent.ASSUME_X11 :<tr><td><a id="l347"></a><a href="#l347">347</a><td>    goog.userAgent.isX11_();<tr><td><a id="l348"></a><a href="#l348">348</a><td><tr><td><a id="l349"></a><a href="#l349">349</a><td><tr><td><a id="l350"></a><a href="#l350">350</a><td>/**<tr><td><a id="l351"></a><a href="#l351">351</a><td> * Whether the user agent is running on Android.<tr><td><a id="l352"></a><a href="#l352">352</a><td> * @type {boolean}<tr><td><a id="l353"></a><a href="#l353">353</a><td> */<tr><td><a id="l354"></a><a href="#l354">354</a><td>goog.userAgent.ANDROID = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a id="l355"></a><a href="#l355">355</a><td>    goog.userAgent.ASSUME_ANDROID :<tr><td><a id="l356"></a><a href="#l356">356</a><td>    goog.labs.userAgent.platform.isAndroid();<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> * Whether the user agent is running on an iPhone.<tr><td><a id="l361"></a><a href="#l361">361</a><td> * @type {boolean}<tr><td><a id="l362"></a><a href="#l362">362</a><td> */<tr><td><a id="l363"></a><a href="#l363">363</a><td>goog.userAgent.IPHONE = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a id="l364"></a><a href="#l364">364</a><td>    goog.userAgent.ASSUME_IPHONE :<tr><td><a id="l365"></a><a href="#l365">365</a><td>    goog.labs.userAgent.platform.isIphone();<tr><td><a id="l366"></a><a href="#l366">366</a><td><tr><td><a id="l367"></a><a href="#l367">367</a><td><tr><td><a id="l368"></a><a href="#l368">368</a><td>/**<tr><td><a id="l369"></a><a href="#l369">369</a><td> * Whether the user agent is running on an iPad.<tr><td><a id="l370"></a><a href="#l370">370</a><td> * @type {boolean}<tr><td><a id="l371"></a><a href="#l371">371</a><td> */<tr><td><a id="l372"></a><a href="#l372">372</a><td>goog.userAgent.IPAD = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a id="l373"></a><a href="#l373">373</a><td>    goog.userAgent.ASSUME_IPAD :<tr><td><a id="l374"></a><a href="#l374">374</a><td>    goog.labs.userAgent.platform.isIpad();<tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td><tr><td><a id="l377"></a><a href="#l377">377</a><td>/**<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @return {string} The string that describes the version number of the user<tr><td><a id="l379"></a><a href="#l379">379</a><td> *     agent.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * Assumes user agent is opera.<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @private<tr><td><a id="l382"></a><a href="#l382">382</a><td> */<tr><td><a id="l383"></a><a href="#l383">383</a><td>goog.userAgent.operaVersion_ = function() {<tr><td><a id="l384"></a><a href="#l384">384</a><td>  var version = goog.global.opera.version;<tr><td><a id="l385"></a><a href="#l385">385</a><td>  try {<tr><td><a id="l386"></a><a href="#l386">386</a><td>    return version();<tr><td><a id="l387"></a><a href="#l387">387</a><td>  } catch (e) {<tr><td><a id="l388"></a><a href="#l388">388</a><td>    return version;<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>/**<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @return {string} The string that describes the version number of the user<tr><td><a id="l395"></a><a href="#l395">395</a><td> *     agent.<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @private<tr><td><a id="l397"></a><a href="#l397">397</a><td> */<tr><td><a id="l398"></a><a href="#l398">398</a><td>goog.userAgent.determineVersion_ = function() {<tr><td><a id="l399"></a><a href="#l399">399</a><td>  // All browsers have different ways to detect the version and they all have<tr><td><a id="l400"></a><a href="#l400">400</a><td>  // different naming schemes.<tr><td><a id="l401"></a><a href="#l401">401</a><td><tr><td><a id="l402"></a><a href="#l402">402</a><td>  if (goog.userAgent.OPERA &amp;&amp; goog.global[&#39;opera&#39;]) {<tr><td><a id="l403"></a><a href="#l403">403</a><td>    return goog.userAgent.operaVersion_();<tr><td><a id="l404"></a><a href="#l404">404</a><td>  }<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td>  // version is a string rather than a number because it may contain &#39;b&#39;, &#39;a&#39;,<tr><td><a id="l407"></a><a href="#l407">407</a><td>  // and so on.<tr><td><a id="l408"></a><a href="#l408">408</a><td>  var version = &#39;&#39;;<tr><td><a id="l409"></a><a href="#l409">409</a><td>  var arr = goog.userAgent.getVersionRegexResult_();<tr><td><a id="l410"></a><a href="#l410">410</a><td>  if (arr) {<tr><td><a id="l411"></a><a href="#l411">411</a><td>    version = arr ? arr[1] : &#39;&#39;;<tr><td><a id="l412"></a><a href="#l412">412</a><td>  }<tr><td><a id="l413"></a><a href="#l413">413</a><td><tr><td><a id="l414"></a><a href="#l414">414</a><td>  if (goog.userAgent.IE) {<tr><td><a id="l415"></a><a href="#l415">415</a><td>    // IE9 can be in document mode 9 but be reporting an inconsistent user agent<tr><td><a id="l416"></a><a href="#l416">416</a><td>    // version.  If it is identifying as a version lower than 9 we take the<tr><td><a id="l417"></a><a href="#l417">417</a><td>    // documentMode as the version instead.  IE8 has similar behavior.<tr><td><a id="l418"></a><a href="#l418">418</a><td>    // It is recommended to set the X-UA-Compatible header to ensure that IE9<tr><td><a id="l419"></a><a href="#l419">419</a><td>    // uses documentMode 9.<tr><td><a id="l420"></a><a href="#l420">420</a><td>    var docMode = goog.userAgent.getDocumentMode_();<tr><td><a id="l421"></a><a href="#l421">421</a><td>    if (docMode &gt; parseFloat(version)) {<tr><td><a id="l422"></a><a href="#l422">422</a><td>      return String(docMode);<tr><td><a id="l423"></a><a href="#l423">423</a><td>    }<tr><td><a id="l424"></a><a href="#l424">424</a><td>  }<tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td>  return version;<tr><td><a id="l427"></a><a href="#l427">427</a><td>};<tr><td><a id="l428"></a><a href="#l428">428</a><td><tr><td><a id="l429"></a><a href="#l429">429</a><td><tr><td><a id="l430"></a><a href="#l430">430</a><td>/**<tr><td><a id="l431"></a><a href="#l431">431</a><td> * @return {Array|undefined} The version regex matches from parsing the user<tr><td><a id="l432"></a><a href="#l432">432</a><td> *     agent string. These regex statements must be executed inline so they can<tr><td><a id="l433"></a><a href="#l433">433</a><td> *     be compiled out by the closure compiler with the rest of the useragent<tr><td><a id="l434"></a><a href="#l434">434</a><td> *     detection logic when ASSUME_* is specified.<tr><td><a id="l435"></a><a href="#l435">435</a><td> * @private<tr><td><a id="l436"></a><a href="#l436">436</a><td> */<tr><td><a id="l437"></a><a href="#l437">437</a><td>goog.userAgent.getVersionRegexResult_ = function() {<tr><td><a id="l438"></a><a href="#l438">438</a><td>  var userAgent = goog.userAgent.getUserAgentString();<tr><td><a id="l439"></a><a href="#l439">439</a><td>  if (goog.userAgent.GECKO) {<tr><td><a id="l440"></a><a href="#l440">440</a><td>    return /rv\:([^\);]+)(\)|;)/.exec(userAgent);<tr><td><a id="l441"></a><a href="#l441">441</a><td>  }<tr><td><a id="l442"></a><a href="#l442">442</a><td>  if (goog.userAgent.EDGE) {<tr><td><a id="l443"></a><a href="#l443">443</a><td>    return /Edge\/([\d\.]+)/.exec(userAgent);<tr><td><a id="l444"></a><a href="#l444">444</a><td>  }<tr><td><a id="l445"></a><a href="#l445">445</a><td>  if (goog.userAgent.IE) {<tr><td><a id="l446"></a><a href="#l446">446</a><td>    return /\b(?:MSIE|rv)[: ]([^\);]+)(\)|;)/.exec(userAgent);<tr><td><a id="l447"></a><a href="#l447">447</a><td>  }<tr><td><a id="l448"></a><a href="#l448">448</a><td>  if (goog.userAgent.WEBKIT) {<tr><td><a id="l449"></a><a href="#l449">449</a><td>    // WebKit/125.4<tr><td><a id="l450"></a><a href="#l450">450</a><td>    return /WebKit\/(\S+)/.exec(userAgent);<tr><td><a id="l451"></a><a href="#l451">451</a><td>  }<tr><td><a id="l452"></a><a href="#l452">452</a><td>};<tr><td><a id="l453"></a><a href="#l453">453</a><td><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> * @return {number|undefined} Returns the document mode (for testing).<tr><td><a id="l457"></a><a href="#l457">457</a><td> * @private<tr><td><a id="l458"></a><a href="#l458">458</a><td> */<tr><td><a id="l459"></a><a href="#l459">459</a><td>goog.userAgent.getDocumentMode_ = function() {<tr><td><a id="l460"></a><a href="#l460">460</a><td>  // NOTE(user): goog.userAgent may be used in context where there is no DOM.<tr><td><a id="l461"></a><a href="#l461">461</a><td>  var doc = goog.global[&#39;document&#39;];<tr><td><a id="l462"></a><a href="#l462">462</a><td>  return doc ? doc[&#39;documentMode&#39;] : undefined;<tr><td><a id="l463"></a><a href="#l463">463</a><td>};<tr><td><a id="l464"></a><a href="#l464">464</a><td><tr><td><a id="l465"></a><a href="#l465">465</a><td><tr><td><a id="l466"></a><a href="#l466">466</a><td>/**<tr><td><a id="l467"></a><a href="#l467">467</a><td> * The version of the user agent. This is a string because it might contain<tr><td><a id="l468"></a><a href="#l468">468</a><td> * &#39;b&#39; (as in beta) as well as multiple dots.<tr><td><a id="l469"></a><a href="#l469">469</a><td> * @type {string}<tr><td><a id="l470"></a><a href="#l470">470</a><td> */<tr><td><a id="l471"></a><a href="#l471">471</a><td>goog.userAgent.VERSION = goog.userAgent.determineVersion_();<tr><td><a id="l472"></a><a href="#l472">472</a><td><tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td>/**<tr><td><a id="l475"></a><a href="#l475">475</a><td> * Compares two version numbers.<tr><td><a id="l476"></a><a href="#l476">476</a><td> *<tr><td><a id="l477"></a><a href="#l477">477</a><td> * @param {string} v1 Version of first item.<tr><td><a id="l478"></a><a href="#l478">478</a><td> * @param {string} v2 Version of second item.<tr><td><a id="l479"></a><a href="#l479">479</a><td> *<tr><td><a id="l480"></a><a href="#l480">480</a><td> * @return {number}  1 if first argument is higher<tr><td><a id="l481"></a><a href="#l481">481</a><td> *                   0 if arguments are equal<tr><td><a id="l482"></a><a href="#l482">482</a><td> *                  -1 if second argument is higher.<tr><td><a id="l483"></a><a href="#l483">483</a><td> * @deprecated Use goog.string.compareVersions.<tr><td><a id="l484"></a><a href="#l484">484</a><td> */<tr><td><a id="l485"></a><a href="#l485">485</a><td>goog.userAgent.compare = function(v1, v2) {<tr><td><a id="l486"></a><a href="#l486">486</a><td>  return goog.string.compareVersions(v1, v2);<tr><td><a id="l487"></a><a href="#l487">487</a><td>};<tr><td><a id="l488"></a><a href="#l488">488</a><td><tr><td><a id="l489"></a><a href="#l489">489</a><td><tr><td><a id="l490"></a><a href="#l490">490</a><td>/**<tr><td><a id="l491"></a><a href="#l491">491</a><td> * Cache for {@link goog.userAgent.isVersionOrHigher}.<tr><td><a id="l492"></a><a href="#l492">492</a><td> * Calls to compareVersions are surprisingly expensive and, as a browser&#39;s<tr><td><a id="l493"></a><a href="#l493">493</a><td> * version number is unlikely to change during a session, we cache the results.<tr><td><a id="l494"></a><a href="#l494">494</a><td> * @const<tr><td><a id="l495"></a><a href="#l495">495</a><td> * @private<tr><td><a id="l496"></a><a href="#l496">496</a><td> */<tr><td><a id="l497"></a><a href="#l497">497</a><td>goog.userAgent.isVersionOrHigherCache_ = {};<tr><td><a id="l498"></a><a href="#l498">498</a><td><tr><td><a id="l499"></a><a href="#l499">499</a><td><tr><td><a id="l500"></a><a href="#l500">500</a><td>/**<tr><td><a id="l501"></a><a href="#l501">501</a><td> * Whether the user agent version is higher or the same as the given version.<tr><td><a id="l502"></a><a href="#l502">502</a><td> * NOTE: When checking the version numbers for Firefox and Safari, be sure to<tr><td><a id="l503"></a><a href="#l503">503</a><td> * use the engine&#39;s version, not the browser&#39;s version number.  For example,<tr><td><a id="l504"></a><a href="#l504">504</a><td> * Firefox 3.0 corresponds to Gecko 1.9 and Safari 3.0 to Webkit 522.11.<tr><td><a id="l505"></a><a href="#l505">505</a><td> * Opera and Internet Explorer versions match the product release number.&lt;br&gt;<tr><td><a id="l506"></a><a href="#l506">506</a><td> * @see &lt;a href=&quot;http://en.wikipedia.org/wiki/Safari_version_history&quot;&gt;<tr><td><a id="l507"></a><a href="#l507">507</a><td> *     Webkit&lt;/a&gt;<tr><td><a id="l508"></a><a href="#l508">508</a><td> * @see &lt;a href=&quot;http://en.wikipedia.org/wiki/Gecko_engine&quot;&gt;Gecko&lt;/a&gt;<tr><td><a id="l509"></a><a href="#l509">509</a><td> *<tr><td><a id="l510"></a><a href="#l510">510</a><td> * @param {string|number} version The version to check.<tr><td><a id="l511"></a><a href="#l511">511</a><td> * @return {boolean} Whether the user agent version is higher or the same as<tr><td><a id="l512"></a><a href="#l512">512</a><td> *     the given version.<tr><td><a id="l513"></a><a href="#l513">513</a><td> */<tr><td><a id="l514"></a><a href="#l514">514</a><td>goog.userAgent.isVersionOrHigher = function(version) {<tr><td><a id="l515"></a><a href="#l515">515</a><td>  return goog.userAgent.ASSUME_ANY_VERSION ||<tr><td><a id="l516"></a><a href="#l516">516</a><td>      goog.userAgent.isVersionOrHigherCache_[version] ||<tr><td><a id="l517"></a><a href="#l517">517</a><td>      (goog.userAgent.isVersionOrHigherCache_[version] =<tr><td><a id="l518"></a><a href="#l518">518</a><td>          goog.string.compareVersions(goog.userAgent.VERSION, version) &gt;= 0);<tr><td><a id="l519"></a><a href="#l519">519</a><td>};<tr><td><a id="l520"></a><a href="#l520">520</a><td><tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td>/**<tr><td><a id="l523"></a><a href="#l523">523</a><td> * Deprecated alias to {@code goog.userAgent.isVersionOrHigher}.<tr><td><a id="l524"></a><a href="#l524">524</a><td> * @param {string|number} version The version to check.<tr><td><a id="l525"></a><a href="#l525">525</a><td> * @return {boolean} Whether the user agent version is higher or the same as<tr><td><a id="l526"></a><a href="#l526">526</a><td> *     the given version.<tr><td><a id="l527"></a><a href="#l527">527</a><td> * @deprecated Use goog.userAgent.isVersionOrHigher().<tr><td><a id="l528"></a><a href="#l528">528</a><td> */<tr><td><a id="l529"></a><a href="#l529">529</a><td>goog.userAgent.isVersion = goog.userAgent.isVersionOrHigher;<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>/**<tr><td><a id="l533"></a><a href="#l533">533</a><td> * Whether the IE effective document mode is higher or the same as the given<tr><td><a id="l534"></a><a href="#l534">534</a><td> * document mode version.<tr><td><a id="l535"></a><a href="#l535">535</a><td> * NOTE: Only for IE, return false for another browser.<tr><td><a id="l536"></a><a href="#l536">536</a><td> *<tr><td><a id="l537"></a><a href="#l537">537</a><td> * @param {number} documentMode The document mode version to check.<tr><td><a id="l538"></a><a href="#l538">538</a><td> * @return {boolean} Whether the IE effective document mode is higher or the<tr><td><a id="l539"></a><a href="#l539">539</a><td> *     same as the given version.<tr><td><a id="l540"></a><a href="#l540">540</a><td> */<tr><td><a id="l541"></a><a href="#l541">541</a><td>goog.userAgent.isDocumentModeOrHigher = function(documentMode) {<tr><td><a id="l542"></a><a href="#l542">542</a><td>  return goog.userAgent.DOCUMENT_MODE &gt;= documentMode;<tr><td><a id="l543"></a><a href="#l543">543</a><td>};<tr><td><a id="l544"></a><a href="#l544">544</a><td><tr><td><a id="l545"></a><a href="#l545">545</a><td><tr><td><a id="l546"></a><a href="#l546">546</a><td>/**<tr><td><a id="l547"></a><a href="#l547">547</a><td> * Deprecated alias to {@code goog.userAgent.isDocumentModeOrHigher}.<tr><td><a id="l548"></a><a href="#l548">548</a><td> * @param {number} version The version to check.<tr><td><a id="l549"></a><a href="#l549">549</a><td> * @return {boolean} Whether the IE effective document mode is higher or the<tr><td><a id="l550"></a><a href="#l550">550</a><td> *      same as the given version.<tr><td><a id="l551"></a><a href="#l551">551</a><td> * @deprecated Use goog.userAgent.isDocumentModeOrHigher().<tr><td><a id="l552"></a><a href="#l552">552</a><td> */<tr><td><a id="l553"></a><a href="#l553">553</a><td>goog.userAgent.isDocumentMode = goog.userAgent.isDocumentModeOrHigher;<tr><td><a id="l554"></a><a href="#l554">554</a><td><tr><td><a id="l555"></a><a href="#l555">555</a><td><tr><td><a id="l556"></a><a href="#l556">556</a><td>/**<tr><td><a id="l557"></a><a href="#l557">557</a><td> * For IE version &lt; 7, documentMode is undefined, so attempt to use the<tr><td><a id="l558"></a><a href="#l558">558</a><td> * CSS1Compat property to see if we are in standards mode. If we are in<tr><td><a id="l559"></a><a href="#l559">559</a><td> * standards mode, treat the browser version as the document mode. Otherwise,<tr><td><a id="l560"></a><a href="#l560">560</a><td> * IE is emulating version 5.<tr><td><a id="l561"></a><a href="#l561">561</a><td> * @type {number|undefined}<tr><td><a id="l562"></a><a href="#l562">562</a><td> * @const<tr><td><a id="l563"></a><a href="#l563">563</a><td> */<tr><td><a id="l564"></a><a href="#l564">564</a><td>goog.userAgent.DOCUMENT_MODE = (function() {<tr><td><a id="l565"></a><a href="#l565">565</a><td>  var doc = goog.global[&#39;document&#39;];<tr><td><a id="l566"></a><a href="#l566">566</a><td>  var mode = goog.userAgent.getDocumentMode_();<tr><td><a id="l567"></a><a href="#l567">567</a><td>  if (!doc || !goog.userAgent.IE) {<tr><td><a id="l568"></a><a href="#l568">568</a><td>    return undefined;<tr><td><a id="l569"></a><a href="#l569">569</a><td>  }<tr><td><a id="l570"></a><a href="#l570">570</a><td>  return mode || (doc[&#39;compatMode&#39;] == &#39;CSS1Compat&#39; ?<tr><td><a id="l571"></a><a href="#l571">571</a><td>      parseInt(goog.userAgent.VERSION, 10) : 5);<tr><td><a id="l572"></a><a href="#l572">572</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/abstractbuilder.js.src.html b/docs/source/lib/webdriver/abstractbuilder.js.src.html
index 242c7a7..a0de85a 100644
--- a/docs/source/lib/webdriver/abstractbuilder.js.src.html
+++ b/docs/source/lib/webdriver/abstractbuilder.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>abstractbuilder.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/abstractbuilder.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.AbstractBuilder&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;webdriver.Capabilities&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;webdriver.process&#39;);<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>/**<tr><td><a name="l23" href="#l23">23</a><td> * Creates new {@code webdriver.WebDriver} clients.  Upon instantiation, each<tr><td><a name="l24" href="#l24">24</a><td> * Builder will configure itself based on the following environment variables:<tr><td><a name="l25" href="#l25">25</a><td> * &lt;dl&gt;<tr><td><a name="l26" href="#l26">26</a><td> *   &lt;dt&gt;{@code webdriver.AbstractBuilder.SERVER_URL_ENV}&lt;/dt&gt;<tr><td><a name="l27" href="#l27">27</a><td> *   &lt;dd&gt;Defines the remote WebDriver server that should be used for command<tr><td><a name="l28" href="#l28">28</a><td> *       command execution; may be overridden using<tr><td><a name="l29" href="#l29">29</a><td> *       {@code webdriver.AbstractBuilder.prototype.usingServer}.&lt;/dd&gt;<tr><td><a name="l30" href="#l30">30</a><td> * &lt;/dl&gt;<tr><td><a name="l31" href="#l31">31</a><td> * @constructor<tr><td><a name="l32" href="#l32">32</a><td> */<tr><td><a name="l33" href="#l33">33</a><td>webdriver.AbstractBuilder = function() {<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>  /**<tr><td><a name="l36" href="#l36">36</a><td>   * URL of the remote server to use for new clients; initialized from the<tr><td><a name="l37" href="#l37">37</a><td>   * value of the {@link webdriver.AbstractBuilder.SERVER_URL_ENV} environment<tr><td><a name="l38" href="#l38">38</a><td>   * variable, but may be overridden using<tr><td><a name="l39" href="#l39">39</a><td>   * {@link webdriver.AbstractBuilder#usingServer}.<tr><td><a name="l40" href="#l40">40</a><td>   * @private {string}<tr><td><a name="l41" href="#l41">41</a><td>   */<tr><td><a name="l42" href="#l42">42</a><td>  this.serverUrl_ = webdriver.process.getEnv(<tr><td><a name="l43" href="#l43">43</a><td>      webdriver.AbstractBuilder.SERVER_URL_ENV);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>  /**<tr><td><a name="l46" href="#l46">46</a><td>   * The desired capabilities to use when creating a new session.<tr><td><a name="l47" href="#l47">47</a><td>   * @private {!webdriver.Capabilities}<tr><td><a name="l48" href="#l48">48</a><td>   */<tr><td><a name="l49" href="#l49">49</a><td>  this.capabilities_ = new webdriver.Capabilities();<tr><td><a name="l50" href="#l50">50</a><td>};<tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>/**<tr><td><a name="l54" href="#l54">54</a><td> * Environment variable that defines the URL of the WebDriver server that<tr><td><a name="l55" href="#l55">55</a><td> * should be used for all new WebDriver clients. This setting may be overridden<tr><td><a name="l56" href="#l56">56</a><td> * using {@code #usingServer(url)}.<tr><td><a name="l57" href="#l57">57</a><td> * @type {string}<tr><td><a name="l58" href="#l58">58</a><td> * @const<tr><td><a name="l59" href="#l59">59</a><td> * @see webdriver.process.getEnv<tr><td><a name="l60" href="#l60">60</a><td> */<tr><td><a name="l61" href="#l61">61</a><td>webdriver.AbstractBuilder.SERVER_URL_ENV = &#39;wdurl&#39;;<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/**<tr><td><a name="l65" href="#l65">65</a><td> * The default URL of the WebDriver server to use if<tr><td><a name="l66" href="#l66">66</a><td> * {@link webdriver.AbstractBuilder.SERVER_URL_ENV} is not set.<tr><td><a name="l67" href="#l67">67</a><td> * @type {string}<tr><td><a name="l68" href="#l68">68</a><td> * @const<tr><td><a name="l69" href="#l69">69</a><td> */<tr><td><a name="l70" href="#l70">70</a><td>webdriver.AbstractBuilder.DEFAULT_SERVER_URL = &#39;http://localhost:4444/wd/hub&#39;;<tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>/**<tr><td><a name="l74" href="#l74">74</a><td> * Configures which WebDriver server should be used for new sessions. Overrides<tr><td><a name="l75" href="#l75">75</a><td> * the value loaded from the {@link webdriver.AbstractBuilder.SERVER_URL_ENV}<tr><td><a name="l76" href="#l76">76</a><td> * upon creation of this instance.<tr><td><a name="l77" href="#l77">77</a><td> * @param {string} url URL of the server to use.<tr><td><a name="l78" href="#l78">78</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l79" href="#l79">79</a><td> */<tr><td><a name="l80" href="#l80">80</a><td>webdriver.AbstractBuilder.prototype.usingServer = function(url) {<tr><td><a name="l81" href="#l81">81</a><td>  this.serverUrl_ = url;<tr><td><a name="l82" href="#l82">82</a><td>  return this;<tr><td><a name="l83" href="#l83">83</a><td>};<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td>/**<tr><td><a name="l87" href="#l87">87</a><td> * @return {string} The URL of the WebDriver server this instance is configured<tr><td><a name="l88" href="#l88">88</a><td> *     to use.<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.AbstractBuilder.prototype.getServerUrl = function() {<tr><td><a name="l91" href="#l91">91</a><td>  return this.serverUrl_;<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/**<tr><td><a name="l96" href="#l96">96</a><td> * Sets the desired capabilities when requesting a new session. This will<tr><td><a name="l97" href="#l97">97</a><td> * overwrite any previously set desired capabilities.<tr><td><a name="l98" href="#l98">98</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The desired<tr><td><a name="l99" href="#l99">99</a><td> *     capabilities for a new session.<tr><td><a name="l100" href="#l100">100</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l101" href="#l101">101</a><td> */<tr><td><a name="l102" href="#l102">102</a><td>webdriver.AbstractBuilder.prototype.withCapabilities = function(capabilities) {<tr><td><a name="l103" href="#l103">103</a><td>  this.capabilities_ = new webdriver.Capabilities(capabilities);<tr><td><a name="l104" href="#l104">104</a><td>  return this;<tr><td><a name="l105" href="#l105">105</a><td>};<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td>/**<tr><td><a name="l109" href="#l109">109</a><td> * @return {!webdriver.Capabilities} The current desired capabilities for this<tr><td><a name="l110" href="#l110">110</a><td> *     builder.<tr><td><a name="l111" href="#l111">111</a><td> */<tr><td><a name="l112" href="#l112">112</a><td>webdriver.AbstractBuilder.prototype.getCapabilities = function() {<tr><td><a name="l113" href="#l113">113</a><td>  return this.capabilities_;<tr><td><a name="l114" href="#l114">114</a><td>};<tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td>/**<tr><td><a name="l118" href="#l118">118</a><td> * Builds a new {@link webdriver.WebDriver} instance using this builder&#39;s<tr><td><a name="l119" href="#l119">119</a><td> * current configuration.<tr><td><a name="l120" href="#l120">120</a><td> * @return {!webdriver.WebDriver} A new WebDriver client.<tr><td><a name="l121" href="#l121">121</a><td> */<tr><td><a name="l122" href="#l122">122</a><td>webdriver.AbstractBuilder.prototype.build = goog.abstractMethod;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>abstractbuilder.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/abstractbuilder.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.AbstractBuilder&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;webdriver.Capabilities&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;webdriver.process&#39;);<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>/**<tr><td><a name="l23" href="#l23">23</a><td> * Creates new {@code webdriver.WebDriver} clients.  Upon instantiation, each<tr><td><a name="l24" href="#l24">24</a><td> * Builder will configure itself based on the following environment variables:<tr><td><a name="l25" href="#l25">25</a><td> * &lt;dl&gt;<tr><td><a name="l26" href="#l26">26</a><td> *   &lt;dt&gt;{@code webdriver.AbstractBuilder.SERVER_URL_ENV}&lt;/dt&gt;<tr><td><a name="l27" href="#l27">27</a><td> *   &lt;dd&gt;Defines the remote WebDriver server that should be used for command<tr><td><a name="l28" href="#l28">28</a><td> *       command execution; may be overridden using<tr><td><a name="l29" href="#l29">29</a><td> *       {@code webdriver.AbstractBuilder.prototype.usingServer}.&lt;/dd&gt;<tr><td><a name="l30" href="#l30">30</a><td> * &lt;/dl&gt;<tr><td><a name="l31" href="#l31">31</a><td> * @constructor<tr><td><a name="l32" href="#l32">32</a><td> */<tr><td><a name="l33" href="#l33">33</a><td>webdriver.AbstractBuilder = function() {<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>  /**<tr><td><a name="l36" href="#l36">36</a><td>   * URL of the remote server to use for new clients; initialized from the<tr><td><a name="l37" href="#l37">37</a><td>   * value of the {@link webdriver.AbstractBuilder.SERVER_URL_ENV} environment<tr><td><a name="l38" href="#l38">38</a><td>   * variable, but may be overridden using<tr><td><a name="l39" href="#l39">39</a><td>   * {@link webdriver.AbstractBuilder#usingServer}.<tr><td><a name="l40" href="#l40">40</a><td>   * @private {string}<tr><td><a name="l41" href="#l41">41</a><td>   */<tr><td><a name="l42" href="#l42">42</a><td>  this.serverUrl_ = webdriver.process.getEnv(<tr><td><a name="l43" href="#l43">43</a><td>      webdriver.AbstractBuilder.SERVER_URL_ENV);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>  /**<tr><td><a name="l46" href="#l46">46</a><td>   * The desired capabilities to use when creating a new session.<tr><td><a name="l47" href="#l47">47</a><td>   * @private {!webdriver.Capabilities}<tr><td><a name="l48" href="#l48">48</a><td>   */<tr><td><a name="l49" href="#l49">49</a><td>  this.capabilities_ = new webdriver.Capabilities();<tr><td><a name="l50" href="#l50">50</a><td>};<tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>/**<tr><td><a name="l54" href="#l54">54</a><td> * Environment variable that defines the URL of the WebDriver server that<tr><td><a name="l55" href="#l55">55</a><td> * should be used for all new WebDriver clients. This setting may be overridden<tr><td><a name="l56" href="#l56">56</a><td> * using {@code #usingServer(url)}.<tr><td><a name="l57" href="#l57">57</a><td> * @type {string}<tr><td><a name="l58" href="#l58">58</a><td> * @const<tr><td><a name="l59" href="#l59">59</a><td> * @see webdriver.process.getEnv<tr><td><a name="l60" href="#l60">60</a><td> */<tr><td><a name="l61" href="#l61">61</a><td>webdriver.AbstractBuilder.SERVER_URL_ENV = &#39;wdurl&#39;;<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/**<tr><td><a name="l65" href="#l65">65</a><td> * The default URL of the WebDriver server to use if<tr><td><a name="l66" href="#l66">66</a><td> * {@link webdriver.AbstractBuilder.SERVER_URL_ENV} is not set.<tr><td><a name="l67" href="#l67">67</a><td> * @type {string}<tr><td><a name="l68" href="#l68">68</a><td> * @const<tr><td><a name="l69" href="#l69">69</a><td> */<tr><td><a name="l70" href="#l70">70</a><td>webdriver.AbstractBuilder.DEFAULT_SERVER_URL = &#39;http://localhost:4444/wd/hub&#39;;<tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>/**<tr><td><a name="l74" href="#l74">74</a><td> * Configures which WebDriver server should be used for new sessions. Overrides<tr><td><a name="l75" href="#l75">75</a><td> * the value loaded from the {@link webdriver.AbstractBuilder.SERVER_URL_ENV}<tr><td><a name="l76" href="#l76">76</a><td> * upon creation of this instance.<tr><td><a name="l77" href="#l77">77</a><td> * @param {string} url URL of the server to use.<tr><td><a name="l78" href="#l78">78</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l79" href="#l79">79</a><td> */<tr><td><a name="l80" href="#l80">80</a><td>webdriver.AbstractBuilder.prototype.usingServer = function(url) {<tr><td><a name="l81" href="#l81">81</a><td>  this.serverUrl_ = url;<tr><td><a name="l82" href="#l82">82</a><td>  return this;<tr><td><a name="l83" href="#l83">83</a><td>};<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td>/**<tr><td><a name="l87" href="#l87">87</a><td> * @return {string} The URL of the WebDriver server this instance is configured<tr><td><a name="l88" href="#l88">88</a><td> *     to use.<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.AbstractBuilder.prototype.getServerUrl = function() {<tr><td><a name="l91" href="#l91">91</a><td>  return this.serverUrl_;<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/**<tr><td><a name="l96" href="#l96">96</a><td> * Sets the desired capabilities when requesting a new session. This will<tr><td><a name="l97" href="#l97">97</a><td> * overwrite any previously set desired capabilities.<tr><td><a name="l98" href="#l98">98</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The desired<tr><td><a name="l99" href="#l99">99</a><td> *     capabilities for a new session.<tr><td><a name="l100" href="#l100">100</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l101" href="#l101">101</a><td> */<tr><td><a name="l102" href="#l102">102</a><td>webdriver.AbstractBuilder.prototype.withCapabilities = function(capabilities) {<tr><td><a name="l103" href="#l103">103</a><td>  this.capabilities_ = new webdriver.Capabilities(capabilities);<tr><td><a name="l104" href="#l104">104</a><td>  return this;<tr><td><a name="l105" href="#l105">105</a><td>};<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td>/**<tr><td><a name="l109" href="#l109">109</a><td> * @return {!webdriver.Capabilities} The current desired capabilities for this<tr><td><a name="l110" href="#l110">110</a><td> *     builder.<tr><td><a name="l111" href="#l111">111</a><td> */<tr><td><a name="l112" href="#l112">112</a><td>webdriver.AbstractBuilder.prototype.getCapabilities = function() {<tr><td><a name="l113" href="#l113">113</a><td>  return this.capabilities_;<tr><td><a name="l114" href="#l114">114</a><td>};<tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td>/**<tr><td><a name="l118" href="#l118">118</a><td> * Sets the logging preferences for the created session. Preferences may be<tr><td><a name="l119" href="#l119">119</a><td> * changed by repeated calls, or by calling {@link #withCapabilities}.<tr><td><a name="l120" href="#l120">120</a><td> * @param {!(webdriver.logging.Preferences|Object.&lt;string, string&gt;)} prefs The<tr><td><a name="l121" href="#l121">121</a><td> *     desired logging preferences.<tr><td><a name="l122" href="#l122">122</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l123" href="#l123">123</a><td> */<tr><td><a name="l124" href="#l124">124</a><td>webdriver.AbstractBuilder.prototype.setLoggingPreferences = function(prefs) {<tr><td><a name="l125" href="#l125">125</a><td>  this.capabilities_.set(webdriver.Capability.LOGGING_PREFS, prefs);<tr><td><a name="l126" href="#l126">126</a><td>  return this;<tr><td><a name="l127" href="#l127">127</a><td>};<tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td>/**<tr><td><a name="l131" href="#l131">131</a><td> * Builds a new {@link webdriver.WebDriver} instance using this builder&#39;s<tr><td><a name="l132" href="#l132">132</a><td> * current configuration.<tr><td><a name="l133" href="#l133">133</a><td> * @return {!webdriver.WebDriver} A new WebDriver client.<tr><td><a name="l134" href="#l134">134</a><td> */<tr><td><a name="l135" href="#l135">135</a><td>webdriver.AbstractBuilder.prototype.build = goog.abstractMethod;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/actionsequence.js.src.html b/docs/source/lib/webdriver/actionsequence.js.src.html
index 711b4de..265273a 100644
--- a/docs/source/lib/webdriver/actionsequence.js.src.html
+++ b/docs/source/lib/webdriver/actionsequence.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>actionsequence.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/actionsequence.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Selenium comitters<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2012 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>// You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>goog.provide(&#39;webdriver.ActionSequence&#39;);<tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l19" href="#l19">19</a><td>goog.require(&#39;webdriver.Button&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.require(&#39;webdriver.Command&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.require(&#39;webdriver.Key&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>/**<tr><td><a name="l27" href="#l27">27</a><td> * Class for defining sequences of complex user interactions. Each sequence<tr><td><a name="l28" href="#l28">28</a><td> * will not be executed until {@link #perform} is called.<tr><td><a name="l29" href="#l29">29</a><td> *<tr><td><a name="l30" href="#l30">30</a><td> * &lt;p&gt;Example:&lt;pre&gt;&lt;code&gt;<tr><td><a name="l31" href="#l31">31</a><td> *   new webdriver.ActionSequence(driver).<tr><td><a name="l32" href="#l32">32</a><td> *       keyDown(webdriver.Key.SHIFT).<tr><td><a name="l33" href="#l33">33</a><td> *       click(element1).<tr><td><a name="l34" href="#l34">34</a><td> *       click(element2).<tr><td><a name="l35" href="#l35">35</a><td> *       dragAndDrop(element3, element4).<tr><td><a name="l36" href="#l36">36</a><td> *       keyUp(webdriver.Key.SHIFT).<tr><td><a name="l37" href="#l37">37</a><td> *       perform();<tr><td><a name="l38" href="#l38">38</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l39" href="#l39">39</a><td> *<tr><td><a name="l40" href="#l40">40</a><td> * @param {!webdriver.WebDriver} driver The driver instance to use.<tr><td><a name="l41" href="#l41">41</a><td> * @constructor<tr><td><a name="l42" href="#l42">42</a><td> */<tr><td><a name="l43" href="#l43">43</a><td>webdriver.ActionSequence = function(driver) {<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a name="l46" href="#l46">46</a><td>  this.driver_ = driver;<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td>  /** @private {!Array.&lt;{description: string, command: !webdriver.Command}&gt;} */<tr><td><a name="l49" href="#l49">49</a><td>  this.actions_ = [];<tr><td><a name="l50" href="#l50">50</a><td>};<tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>/**<tr><td><a name="l54" href="#l54">54</a><td> * Schedules an action to be executed each time {@link #perform} is called on<tr><td><a name="l55" href="#l55">55</a><td> * this instance.<tr><td><a name="l56" href="#l56">56</a><td> * @param {string} description A description of the command.<tr><td><a name="l57" href="#l57">57</a><td> * @param {!webdriver.Command} command The command.<tr><td><a name="l58" href="#l58">58</a><td> * @private<tr><td><a name="l59" href="#l59">59</a><td> */<tr><td><a name="l60" href="#l60">60</a><td>webdriver.ActionSequence.prototype.schedule_ = function(description, command) {<tr><td><a name="l61" href="#l61">61</a><td>  this.actions_.push({<tr><td><a name="l62" href="#l62">62</a><td>    description: description,<tr><td><a name="l63" href="#l63">63</a><td>    command: command<tr><td><a name="l64" href="#l64">64</a><td>  });<tr><td><a name="l65" href="#l65">65</a><td>};<tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td>/**<tr><td><a name="l69" href="#l69">69</a><td> * Executes this action sequence.<tr><td><a name="l70" href="#l70">70</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved once<tr><td><a name="l71" href="#l71">71</a><td> *     this sequence has completed.<tr><td><a name="l72" href="#l72">72</a><td> */<tr><td><a name="l73" href="#l73">73</a><td>webdriver.ActionSequence.prototype.perform = function() {<tr><td><a name="l74" href="#l74">74</a><td>  // Make a protected copy of the scheduled actions. This will protect against<tr><td><a name="l75" href="#l75">75</a><td>  // users defining additional commands before this sequence is actually<tr><td><a name="l76" href="#l76">76</a><td>  // executed.<tr><td><a name="l77" href="#l77">77</a><td>  var actions = goog.array.clone(this.actions_);<tr><td><a name="l78" href="#l78">78</a><td>  var driver = this.driver_;<tr><td><a name="l79" href="#l79">79</a><td>  return driver.controlFlow().execute(function() {<tr><td><a name="l80" href="#l80">80</a><td>    goog.array.forEach(actions, function(action) {<tr><td><a name="l81" href="#l81">81</a><td>      driver.schedule(action.command, action.description);<tr><td><a name="l82" href="#l82">82</a><td>    });<tr><td><a name="l83" href="#l83">83</a><td>  }, &#39;ActionSequence.perform&#39;);<tr><td><a name="l84" href="#l84">84</a><td>};<tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td><tr><td><a name="l87" href="#l87">87</a><td>/**<tr><td><a name="l88" href="#l88">88</a><td> * Moves the mouse.  The location to move to may be specified in terms of the<tr><td><a name="l89" href="#l89">89</a><td> * mouse&#39;s current location, an offset relative to the top-left corner of an<tr><td><a name="l90" href="#l90">90</a><td> * element, or an element (in which case the middle of the element is used).<tr><td><a name="l91" href="#l91">91</a><td> * @param {(!webdriver.WebElement|{x: number, y: number})} location The<tr><td><a name="l92" href="#l92">92</a><td> *     location to drag to, as either another WebElement or an offset in pixels.<tr><td><a name="l93" href="#l93">93</a><td> * @param {{x: number, y: number}=} opt_offset If the target {@code location}<tr><td><a name="l94" href="#l94">94</a><td> *     is defined as a {@link webdriver.WebElement}, this parameter defines an<tr><td><a name="l95" href="#l95">95</a><td> *     offset within that element. The offset should be specified in pixels<tr><td><a name="l96" href="#l96">96</a><td> *     relative to the top-left corner of the element&#39;s bounding box. If<tr><td><a name="l97" href="#l97">97</a><td> *     omitted, the element&#39;s center will be used as the target offset.<tr><td><a name="l98" href="#l98">98</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l99" href="#l99">99</a><td> */<tr><td><a name="l100" href="#l100">100</a><td>webdriver.ActionSequence.prototype.mouseMove = function(location, opt_offset) {<tr><td><a name="l101" href="#l101">101</a><td>  var command = new webdriver.Command(webdriver.CommandName.MOVE_TO);<tr><td><a name="l102" href="#l102">102</a><td><tr><td><a name="l103" href="#l103">103</a><td>  if (goog.isNumber(location.x)) {<tr><td><a name="l104" href="#l104">104</a><td>    setOffset(/** @type {{x: number, y: number}} */(location));<tr><td><a name="l105" href="#l105">105</a><td>  } else {<tr><td><a name="l106" href="#l106">106</a><td>    // The interactions API expect the element ID to be encoded as a simple<tr><td><a name="l107" href="#l107">107</a><td>    // string, not the usual JSON object.<tr><td><a name="l108" href="#l108">108</a><td>    var id = /** @type {!webdriver.WebElement} */ (location).toWireValue().<tr><td><a name="l109" href="#l109">109</a><td>        then(function(value) {<tr><td><a name="l110" href="#l110">110</a><td>          return value[&#39;ELEMENT&#39;];<tr><td><a name="l111" href="#l111">111</a><td>        });<tr><td><a name="l112" href="#l112">112</a><td>    command.setParameter(&#39;element&#39;, id);<tr><td><a name="l113" href="#l113">113</a><td>    if (opt_offset) {<tr><td><a name="l114" href="#l114">114</a><td>      setOffset(opt_offset);<tr><td><a name="l115" href="#l115">115</a><td>    }<tr><td><a name="l116" href="#l116">116</a><td>  }<tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td>  this.schedule_(&#39;mouseMove&#39;, command);<tr><td><a name="l119" href="#l119">119</a><td>  return this;<tr><td><a name="l120" href="#l120">120</a><td><tr><td><a name="l121" href="#l121">121</a><td>  /** @param {{x: number, y: number}} offset The offset to use. */<tr><td><a name="l122" href="#l122">122</a><td>  function setOffset(offset) {<tr><td><a name="l123" href="#l123">123</a><td>    command.setParameter(&#39;xoffset&#39;, offset.x || 0);<tr><td><a name="l124" href="#l124">124</a><td>    command.setParameter(&#39;yoffset&#39;, offset.y || 0);<tr><td><a name="l125" href="#l125">125</a><td>  }<tr><td><a name="l126" href="#l126">126</a><td>};<tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td>/**<tr><td><a name="l130" href="#l130">130</a><td> * Schedules a mouse action.<tr><td><a name="l131" href="#l131">131</a><td> * @param {string} description A simple descriptive label for the scheduled<tr><td><a name="l132" href="#l132">132</a><td> *     action.<tr><td><a name="l133" href="#l133">133</a><td> * @param {!webdriver.CommandName} commandName The name of the command.<tr><td><a name="l134" href="#l134">134</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a name="l135" href="#l135">135</a><td> *     the element to interact with or the button to click with.<tr><td><a name="l136" href="#l136">136</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a name="l137" href="#l137">137</a><td> *     button is specified.<tr><td><a name="l138" href="#l138">138</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a name="l139" href="#l139">139</a><td> *     {@link webdriver.Button.LEFT}. Ignored if the previous argument is<tr><td><a name="l140" href="#l140">140</a><td> *     provided as a button.<tr><td><a name="l141" href="#l141">141</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l142" href="#l142">142</a><td> * @private<tr><td><a name="l143" href="#l143">143</a><td> */<tr><td><a name="l144" href="#l144">144</a><td>webdriver.ActionSequence.prototype.scheduleMouseAction_ = function(<tr><td><a name="l145" href="#l145">145</a><td>    description, commandName, opt_elementOrButton, opt_button) {<tr><td><a name="l146" href="#l146">146</a><td>  var button;<tr><td><a name="l147" href="#l147">147</a><td>  if (goog.isNumber(opt_elementOrButton)) {<tr><td><a name="l148" href="#l148">148</a><td>    button = opt_elementOrButton;<tr><td><a name="l149" href="#l149">149</a><td>  } else {<tr><td><a name="l150" href="#l150">150</a><td>    if (opt_elementOrButton) {<tr><td><a name="l151" href="#l151">151</a><td>      this.mouseMove(<tr><td><a name="l152" href="#l152">152</a><td>          /** @type {!webdriver.WebElement} */ (opt_elementOrButton));<tr><td><a name="l153" href="#l153">153</a><td>    }<tr><td><a name="l154" href="#l154">154</a><td>    button = goog.isDef(opt_button) ? opt_button : webdriver.Button.LEFT;<tr><td><a name="l155" href="#l155">155</a><td>  }<tr><td><a name="l156" href="#l156">156</a><td><tr><td><a name="l157" href="#l157">157</a><td>  var command = new webdriver.Command(commandName).<tr><td><a name="l158" href="#l158">158</a><td>      setParameter(&#39;button&#39;, button);<tr><td><a name="l159" href="#l159">159</a><td>  this.schedule_(description, command);<tr><td><a name="l160" href="#l160">160</a><td>  return this;<tr><td><a name="l161" href="#l161">161</a><td>};<tr><td><a name="l162" href="#l162">162</a><td><tr><td><a name="l163" href="#l163">163</a><td><tr><td><a name="l164" href="#l164">164</a><td>/**<tr><td><a name="l165" href="#l165">165</a><td> * Presses a mouse button. The mouse button will not be released until<tr><td><a name="l166" href="#l166">166</a><td> * {@link #mouseUp} is called, regardless of whether that call is made in this<tr><td><a name="l167" href="#l167">167</a><td> * sequence or another. The behavior for out-of-order events (e.g. mouseDown,<tr><td><a name="l168" href="#l168">168</a><td> * click) is undefined.<tr><td><a name="l169" href="#l169">169</a><td> *<tr><td><a name="l170" href="#l170">170</a><td> * &lt;p&gt;If an element is provided, the mouse will first be moved to the center<tr><td><a name="l171" href="#l171">171</a><td> * of that element. This is equivalent to:<tr><td><a name="l172" href="#l172">172</a><td> * &lt;pre&gt;&lt;code&gt;sequence.mouseMove(element).mouseDown()&lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l173" href="#l173">173</a><td> *<tr><td><a name="l174" href="#l174">174</a><td> * &lt;p&gt;Warning: this method currently only supports the left mouse button. See<tr><td><a name="l175" href="#l175">175</a><td> * http://code.google.com/p/selenium/issues/detail?id=4047<tr><td><a name="l176" href="#l176">176</a><td> *<tr><td><a name="l177" href="#l177">177</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a name="l178" href="#l178">178</a><td> *     the element to interact with or the button to click with.<tr><td><a name="l179" href="#l179">179</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a name="l180" href="#l180">180</a><td> *     button is specified.<tr><td><a name="l181" href="#l181">181</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a name="l182" href="#l182">182</a><td> *     {@link webdriver.Button.LEFT}. Ignored if a button is provided as the<tr><td><a name="l183" href="#l183">183</a><td> *     first argument.<tr><td><a name="l184" href="#l184">184</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l185" href="#l185">185</a><td> */<tr><td><a name="l186" href="#l186">186</a><td>webdriver.ActionSequence.prototype.mouseDown = function(opt_elementOrButton,<tr><td><a name="l187" href="#l187">187</a><td>                                                        opt_button) {<tr><td><a name="l188" href="#l188">188</a><td>  return this.scheduleMouseAction_(&#39;mouseDown&#39;,<tr><td><a name="l189" href="#l189">189</a><td>      webdriver.CommandName.MOUSE_DOWN, opt_elementOrButton, opt_button);<tr><td><a name="l190" href="#l190">190</a><td>};<tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td><tr><td><a name="l193" href="#l193">193</a><td>/**<tr><td><a name="l194" href="#l194">194</a><td> * Releases a mouse button. Behavior is undefined for calling this function<tr><td><a name="l195" href="#l195">195</a><td> * without a previous call to {@link #mouseDown}.<tr><td><a name="l196" href="#l196">196</a><td> *<tr><td><a name="l197" href="#l197">197</a><td> * &lt;p&gt;If an element is provided, the mouse will first be moved to the center<tr><td><a name="l198" href="#l198">198</a><td> * of that element. This is equivalent to:<tr><td><a name="l199" href="#l199">199</a><td> * &lt;pre&gt;&lt;code&gt;sequence.mouseMove(element).mouseUp()&lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l200" href="#l200">200</a><td> *<tr><td><a name="l201" href="#l201">201</a><td> * &lt;p&gt;Warning: this method currently only supports the left mouse button. See<tr><td><a name="l202" href="#l202">202</a><td> * http://code.google.com/p/selenium/issues/detail?id=4047<tr><td><a name="l203" href="#l203">203</a><td> *<tr><td><a name="l204" href="#l204">204</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a name="l205" href="#l205">205</a><td> *     the element to interact with or the button to click with.<tr><td><a name="l206" href="#l206">206</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a name="l207" href="#l207">207</a><td> *     button is specified.<tr><td><a name="l208" href="#l208">208</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a name="l209" href="#l209">209</a><td> *     {@link webdriver.Button.LEFT}. Ignored if a button is provided as the<tr><td><a name="l210" href="#l210">210</a><td> *     first argument.<tr><td><a name="l211" href="#l211">211</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l212" href="#l212">212</a><td> */<tr><td><a name="l213" href="#l213">213</a><td>webdriver.ActionSequence.prototype.mouseUp = function(opt_elementOrButton,<tr><td><a name="l214" href="#l214">214</a><td>                                                      opt_button) {<tr><td><a name="l215" href="#l215">215</a><td>  return this.scheduleMouseAction_(&#39;mouseUp&#39;,<tr><td><a name="l216" href="#l216">216</a><td>      webdriver.CommandName.MOUSE_UP, opt_elementOrButton, opt_button);<tr><td><a name="l217" href="#l217">217</a><td>};<tr><td><a name="l218" href="#l218">218</a><td><tr><td><a name="l219" href="#l219">219</a><td><tr><td><a name="l220" href="#l220">220</a><td>/**<tr><td><a name="l221" href="#l221">221</a><td> * Convenience function for performing a &quot;drag and drop&quot; manuever. The target<tr><td><a name="l222" href="#l222">222</a><td> * element may be moved to the location of another element, or by an offset (in<tr><td><a name="l223" href="#l223">223</a><td> * pixels).<tr><td><a name="l224" href="#l224">224</a><td> * @param {!webdriver.WebElement} element The element to drag.<tr><td><a name="l225" href="#l225">225</a><td> * @param {(!webdriver.WebElement|{x: number, y: number})} location The<tr><td><a name="l226" href="#l226">226</a><td> *     location to drag to, either as another WebElement or an offset in pixels.<tr><td><a name="l227" href="#l227">227</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l228" href="#l228">228</a><td> */<tr><td><a name="l229" href="#l229">229</a><td>webdriver.ActionSequence.prototype.dragAndDrop = function(element, location) {<tr><td><a name="l230" href="#l230">230</a><td>  return this.mouseDown(element).mouseMove(location).mouseUp();<tr><td><a name="l231" href="#l231">231</a><td>};<tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td>/**<tr><td><a name="l235" href="#l235">235</a><td> * Clicks a mouse button.<tr><td><a name="l236" href="#l236">236</a><td> *<tr><td><a name="l237" href="#l237">237</a><td> * &lt;p&gt;If an element is provided, the mouse will first be moved to the center<tr><td><a name="l238" href="#l238">238</a><td> * of that element. This is equivalent to:<tr><td><a name="l239" href="#l239">239</a><td> * &lt;pre&gt;&lt;code&gt;sequence.mouseMove(element).click()&lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l240" href="#l240">240</a><td> *<tr><td><a name="l241" href="#l241">241</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a name="l242" href="#l242">242</a><td> *     the element to interact with or the button to click with.<tr><td><a name="l243" href="#l243">243</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a name="l244" href="#l244">244</a><td> *     button is specified.<tr><td><a name="l245" href="#l245">245</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a name="l246" href="#l246">246</a><td> *     {@link webdriver.Button.LEFT}. Ignored if a button is provided as the<tr><td><a name="l247" href="#l247">247</a><td> *     first argument.<tr><td><a name="l248" href="#l248">248</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l249" href="#l249">249</a><td> */<tr><td><a name="l250" href="#l250">250</a><td>webdriver.ActionSequence.prototype.click = function(opt_elementOrButton,<tr><td><a name="l251" href="#l251">251</a><td>                                                    opt_button) {<tr><td><a name="l252" href="#l252">252</a><td>  return this.scheduleMouseAction_(&#39;click&#39;,<tr><td><a name="l253" href="#l253">253</a><td>      webdriver.CommandName.CLICK, opt_elementOrButton, opt_button);<tr><td><a name="l254" href="#l254">254</a><td>};<tr><td><a name="l255" href="#l255">255</a><td><tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td>/**<tr><td><a name="l258" href="#l258">258</a><td> * Double-clicks a mouse button.<tr><td><a name="l259" href="#l259">259</a><td> *<tr><td><a name="l260" href="#l260">260</a><td> * &lt;p&gt;If an element is provided, the mouse will first be moved to the center of<tr><td><a name="l261" href="#l261">261</a><td> * that element. This is equivalent to:<tr><td><a name="l262" href="#l262">262</a><td> * &lt;pre&gt;&lt;code&gt;sequence.mouseMove(element).doubleClick()&lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l263" href="#l263">263</a><td> *<tr><td><a name="l264" href="#l264">264</a><td> * &lt;p&gt;Warning: this method currently only supports the left mouse button. See<tr><td><a name="l265" href="#l265">265</a><td> * http://code.google.com/p/selenium/issues/detail?id=4047<tr><td><a name="l266" href="#l266">266</a><td> *<tr><td><a name="l267" href="#l267">267</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a name="l268" href="#l268">268</a><td> *     the element to interact with or the button to click with.<tr><td><a name="l269" href="#l269">269</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a name="l270" href="#l270">270</a><td> *     button is specified.<tr><td><a name="l271" href="#l271">271</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a name="l272" href="#l272">272</a><td> *     {@link webdriver.Button.LEFT}. Ignored if a button is provided as the<tr><td><a name="l273" href="#l273">273</a><td> *     first argument.<tr><td><a name="l274" href="#l274">274</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l275" href="#l275">275</a><td> */<tr><td><a name="l276" href="#l276">276</a><td>webdriver.ActionSequence.prototype.doubleClick = function(opt_elementOrButton,<tr><td><a name="l277" href="#l277">277</a><td>                                                          opt_button) {<tr><td><a name="l278" href="#l278">278</a><td>  return this.scheduleMouseAction_(&#39;doubleClick&#39;,<tr><td><a name="l279" href="#l279">279</a><td>      webdriver.CommandName.DOUBLE_CLICK, opt_elementOrButton, opt_button);<tr><td><a name="l280" href="#l280">280</a><td>};<tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td><tr><td><a name="l283" href="#l283">283</a><td>/**<tr><td><a name="l284" href="#l284">284</a><td> * Schedules a keyboard action.<tr><td><a name="l285" href="#l285">285</a><td> * @param {string} description A simple descriptive label for the scheduled<tr><td><a name="l286" href="#l286">286</a><td> *     action.<tr><td><a name="l287" href="#l287">287</a><td> * @param {!Array.&lt;(string|!webdriver.Key)&gt;} keys The keys to send.<tr><td><a name="l288" href="#l288">288</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l289" href="#l289">289</a><td> * @private<tr><td><a name="l290" href="#l290">290</a><td> */<tr><td><a name="l291" href="#l291">291</a><td>webdriver.ActionSequence.prototype.scheduleKeyboardAction_ = function(<tr><td><a name="l292" href="#l292">292</a><td>    description, keys) {<tr><td><a name="l293" href="#l293">293</a><td>  var command =<tr><td><a name="l294" href="#l294">294</a><td>      new webdriver.Command(webdriver.CommandName.SEND_KEYS_TO_ACTIVE_ELEMENT).<tr><td><a name="l295" href="#l295">295</a><td>          setParameter(&#39;value&#39;, keys);<tr><td><a name="l296" href="#l296">296</a><td>  this.schedule_(description, command);<tr><td><a name="l297" href="#l297">297</a><td>  return this;<tr><td><a name="l298" href="#l298">298</a><td>};<tr><td><a name="l299" href="#l299">299</a><td><tr><td><a name="l300" href="#l300">300</a><td><tr><td><a name="l301" href="#l301">301</a><td>/**<tr><td><a name="l302" href="#l302">302</a><td> * Checks that a key is a modifier key.<tr><td><a name="l303" href="#l303">303</a><td> * @param {!webdriver.Key} key The key to check.<tr><td><a name="l304" href="#l304">304</a><td> * @throws {Error} If the key is not a modifier key.<tr><td><a name="l305" href="#l305">305</a><td> * @private<tr><td><a name="l306" href="#l306">306</a><td> */<tr><td><a name="l307" href="#l307">307</a><td>webdriver.ActionSequence.checkModifierKey_ = function(key) {<tr><td><a name="l308" href="#l308">308</a><td>  if (key !== webdriver.Key.ALT &amp;&amp; key !== webdriver.Key.CONTROL &amp;&amp;<tr><td><a name="l309" href="#l309">309</a><td>      key !== webdriver.Key.SHIFT &amp;&amp; key !== webdriver.Key.COMMAND) {<tr><td><a name="l310" href="#l310">310</a><td>    throw Error(&#39;Not a modifier key&#39;);<tr><td><a name="l311" href="#l311">311</a><td>  }<tr><td><a name="l312" href="#l312">312</a><td>};<tr><td><a name="l313" href="#l313">313</a><td><tr><td><a name="l314" href="#l314">314</a><td><tr><td><a name="l315" href="#l315">315</a><td>/**<tr><td><a name="l316" href="#l316">316</a><td> * Performs a modifier key press. The modifier key is &lt;em&gt;not released&lt;/em&gt;<tr><td><a name="l317" href="#l317">317</a><td> * until {@link #keyUp} or {@link #sendKeys} is called. The key press will be<tr><td><a name="l318" href="#l318">318</a><td> * targetted at the currently focused element.<tr><td><a name="l319" href="#l319">319</a><td> * @param {!webdriver.Key} key The modifier key to push. Must be one of<tr><td><a name="l320" href="#l320">320</a><td> *     {ALT, CONTROL, SHIFT, COMMAND, META}.<tr><td><a name="l321" href="#l321">321</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l322" href="#l322">322</a><td> * @throws {Error} If the key is not a valid modifier key.<tr><td><a name="l323" href="#l323">323</a><td> */<tr><td><a name="l324" href="#l324">324</a><td>webdriver.ActionSequence.prototype.keyDown = function(key) {<tr><td><a name="l325" href="#l325">325</a><td>  webdriver.ActionSequence.checkModifierKey_(key);<tr><td><a name="l326" href="#l326">326</a><td>  return this.scheduleKeyboardAction_(&#39;keyDown&#39;, [key]);<tr><td><a name="l327" href="#l327">327</a><td>};<tr><td><a name="l328" href="#l328">328</a><td><tr><td><a name="l329" href="#l329">329</a><td><tr><td><a name="l330" href="#l330">330</a><td>/**<tr><td><a name="l331" href="#l331">331</a><td> * Performs a modifier key release. The release is targetted at the currently<tr><td><a name="l332" href="#l332">332</a><td> * focused element.<tr><td><a name="l333" href="#l333">333</a><td> * @param {!webdriver.Key} key The modifier key to release. Must be one of<tr><td><a name="l334" href="#l334">334</a><td> *     {ALT, CONTROL, SHIFT, COMMAND, META}.<tr><td><a name="l335" href="#l335">335</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l336" href="#l336">336</a><td> * @throws {Error} If the key is not a valid modifier key.<tr><td><a name="l337" href="#l337">337</a><td> */<tr><td><a name="l338" href="#l338">338</a><td>webdriver.ActionSequence.prototype.keyUp = function(key) {<tr><td><a name="l339" href="#l339">339</a><td>  webdriver.ActionSequence.checkModifierKey_(key);<tr><td><a name="l340" href="#l340">340</a><td>  return this.scheduleKeyboardAction_(&#39;keyUp&#39;, [key]);<tr><td><a name="l341" href="#l341">341</a><td>};<tr><td><a name="l342" href="#l342">342</a><td><tr><td><a name="l343" href="#l343">343</a><td><tr><td><a name="l344" href="#l344">344</a><td>/**<tr><td><a name="l345" href="#l345">345</a><td> * Simulates typing multiple keys. Each modifier key encountered in the<tr><td><a name="l346" href="#l346">346</a><td> * sequence will not be released until it is encountered again. All key events<tr><td><a name="l347" href="#l347">347</a><td> * will be targetted at the currently focused element.<tr><td><a name="l348" href="#l348">348</a><td> * @param {...(string|!webdriver.Key|!Array.&lt;(string|!webdriver.Key)&gt;)} var_args<tr><td><a name="l349" href="#l349">349</a><td> *     The keys to type.<tr><td><a name="l350" href="#l350">350</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a name="l351" href="#l351">351</a><td> * @throws {Error} If the key is not a valid modifier key.<tr><td><a name="l352" href="#l352">352</a><td> */<tr><td><a name="l353" href="#l353">353</a><td>webdriver.ActionSequence.prototype.sendKeys = function(var_args) {<tr><td><a name="l354" href="#l354">354</a><td>  var keys = goog.array.flatten(goog.array.slice(arguments, 0));<tr><td><a name="l355" href="#l355">355</a><td>  return this.scheduleKeyboardAction_(&#39;sendKeys&#39;, keys);<tr><td><a name="l356" href="#l356">356</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>actionsequence.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/webdriver/actionsequence.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.provide(&#39;webdriver.ActionSequence&#39;);<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.require(&#39;goog.array&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.require(&#39;webdriver.Button&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;webdriver.Command&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.require(&#39;webdriver.Key&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Class for defining sequences of complex user interactions. Each sequence<tr><td><a id="l30"></a><a href="#l30">30</a><td> * will not be executed until {@link #perform} is called.<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> * Example:<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> *     new webdriver.ActionSequence(driver).<tr><td><a id="l35"></a><a href="#l35">35</a><td> *         keyDown(webdriver.Key.SHIFT).<tr><td><a id="l36"></a><a href="#l36">36</a><td> *         click(element1).<tr><td><a id="l37"></a><a href="#l37">37</a><td> *         click(element2).<tr><td><a id="l38"></a><a href="#l38">38</a><td> *         dragAndDrop(element3, element4).<tr><td><a id="l39"></a><a href="#l39">39</a><td> *         keyUp(webdriver.Key.SHIFT).<tr><td><a id="l40"></a><a href="#l40">40</a><td> *         perform();<tr><td><a id="l41"></a><a href="#l41">41</a><td> *<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @param {!webdriver.WebDriver} driver The driver instance to use.<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @constructor<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>webdriver.ActionSequence = function(driver) {<tr><td><a id="l46"></a><a href="#l46">46</a><td><tr><td><a id="l47"></a><a href="#l47">47</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l48"></a><a href="#l48">48</a><td>  this.driver_ = driver;<tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td>  /** @private {!Array.&lt;{description: string, command: !webdriver.Command}&gt;} */<tr><td><a id="l51"></a><a href="#l51">51</a><td>  this.actions_ = [];<tr><td><a id="l52"></a><a href="#l52">52</a><td>};<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td>/**<tr><td><a id="l56"></a><a href="#l56">56</a><td> * Schedules an action to be executed each time {@link #perform} is called on<tr><td><a id="l57"></a><a href="#l57">57</a><td> * this instance.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {string} description A description of the command.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @param {!webdriver.Command} command The command.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @private<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>webdriver.ActionSequence.prototype.schedule_ = function(description, command) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  this.actions_.push({<tr><td><a id="l64"></a><a href="#l64">64</a><td>    description: description,<tr><td><a id="l65"></a><a href="#l65">65</a><td>    command: command<tr><td><a id="l66"></a><a href="#l66">66</a><td>  });<tr><td><a id="l67"></a><a href="#l67">67</a><td>};<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>/**<tr><td><a id="l71"></a><a href="#l71">71</a><td> * Executes this action sequence.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved once<tr><td><a id="l73"></a><a href="#l73">73</a><td> *     this sequence has completed.<tr><td><a id="l74"></a><a href="#l74">74</a><td> */<tr><td><a id="l75"></a><a href="#l75">75</a><td>webdriver.ActionSequence.prototype.perform = function() {<tr><td><a id="l76"></a><a href="#l76">76</a><td>  // Make a protected copy of the scheduled actions. This will protect against<tr><td><a id="l77"></a><a href="#l77">77</a><td>  // users defining additional commands before this sequence is actually<tr><td><a id="l78"></a><a href="#l78">78</a><td>  // executed.<tr><td><a id="l79"></a><a href="#l79">79</a><td>  var actions = goog.array.clone(this.actions_);<tr><td><a id="l80"></a><a href="#l80">80</a><td>  var driver = this.driver_;<tr><td><a id="l81"></a><a href="#l81">81</a><td>  return driver.controlFlow().execute(function() {<tr><td><a id="l82"></a><a href="#l82">82</a><td>    goog.array.forEach(actions, function(action) {<tr><td><a id="l83"></a><a href="#l83">83</a><td>      driver.schedule(action.command, action.description);<tr><td><a id="l84"></a><a href="#l84">84</a><td>    });<tr><td><a id="l85"></a><a href="#l85">85</a><td>  }, &#39;ActionSequence.perform&#39;);<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<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> * Moves the mouse.  The location to move to may be specified in terms of the<tr><td><a id="l91"></a><a href="#l91">91</a><td> * mouse&#39;s current location, an offset relative to the top-left corner of an<tr><td><a id="l92"></a><a href="#l92">92</a><td> * element, or an element (in which case the middle of the element is used).<tr><td><a id="l93"></a><a href="#l93">93</a><td> * @param {(!webdriver.WebElement|{x: number, y: number})} location The<tr><td><a id="l94"></a><a href="#l94">94</a><td> *     location to drag to, as either another WebElement or an offset in pixels.<tr><td><a id="l95"></a><a href="#l95">95</a><td> * @param {{x: number, y: number}=} opt_offset If the target {@code location}<tr><td><a id="l96"></a><a href="#l96">96</a><td> *     is defined as a {@link webdriver.WebElement}, this parameter defines an<tr><td><a id="l97"></a><a href="#l97">97</a><td> *     offset within that element. The offset should be specified in pixels<tr><td><a id="l98"></a><a href="#l98">98</a><td> *     relative to the top-left corner of the element&#39;s bounding box. If<tr><td><a id="l99"></a><a href="#l99">99</a><td> *     omitted, the element&#39;s center will be used as the target offset.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>webdriver.ActionSequence.prototype.mouseMove = function(location, opt_offset) {<tr><td><a id="l103"></a><a href="#l103">103</a><td>  var command = new webdriver.Command(webdriver.CommandName.MOVE_TO);<tr><td><a id="l104"></a><a href="#l104">104</a><td><tr><td><a id="l105"></a><a href="#l105">105</a><td>  if (goog.isNumber(location.x)) {<tr><td><a id="l106"></a><a href="#l106">106</a><td>    setOffset(/** @type {{x: number, y: number}} */(location));<tr><td><a id="l107"></a><a href="#l107">107</a><td>  } else {<tr><td><a id="l108"></a><a href="#l108">108</a><td>    command.setParameter(&#39;element&#39;, location.getRawId());<tr><td><a id="l109"></a><a href="#l109">109</a><td>    if (opt_offset) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>      setOffset(opt_offset);<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>  this.schedule_(&#39;mouseMove&#39;, command);<tr><td><a id="l115"></a><a href="#l115">115</a><td>  return this;<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>  /** @param {{x: number, y: number}} offset The offset to use. */<tr><td><a id="l118"></a><a href="#l118">118</a><td>  function setOffset(offset) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>    command.setParameter(&#39;xoffset&#39;, offset.x || 0);<tr><td><a id="l120"></a><a href="#l120">120</a><td>    command.setParameter(&#39;yoffset&#39;, offset.y || 0);<tr><td><a id="l121"></a><a href="#l121">121</a><td>  }<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<tr><td><a id="l123"></a><a href="#l123">123</a><td><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> * Schedules a mouse action.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @param {string} description A simple descriptive label for the scheduled<tr><td><a id="l128"></a><a href="#l128">128</a><td> *     action.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {!webdriver.CommandName} commandName The name of the command.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a id="l131"></a><a href="#l131">131</a><td> *     the element to interact with or the button to click with.<tr><td><a id="l132"></a><a href="#l132">132</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a id="l133"></a><a href="#l133">133</a><td> *     button is specified.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a id="l135"></a><a href="#l135">135</a><td> *     {@link webdriver.Button.LEFT}. Ignored if the previous argument is<tr><td><a id="l136"></a><a href="#l136">136</a><td> *     provided as a button.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @private<tr><td><a id="l139"></a><a href="#l139">139</a><td> */<tr><td><a id="l140"></a><a href="#l140">140</a><td>webdriver.ActionSequence.prototype.scheduleMouseAction_ = function(<tr><td><a id="l141"></a><a href="#l141">141</a><td>    description, commandName, opt_elementOrButton, opt_button) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>  var button;<tr><td><a id="l143"></a><a href="#l143">143</a><td>  if (goog.isNumber(opt_elementOrButton)) {<tr><td><a id="l144"></a><a href="#l144">144</a><td>    button = opt_elementOrButton;<tr><td><a id="l145"></a><a href="#l145">145</a><td>  } else {<tr><td><a id="l146"></a><a href="#l146">146</a><td>    if (opt_elementOrButton) {<tr><td><a id="l147"></a><a href="#l147">147</a><td>      this.mouseMove(<tr><td><a id="l148"></a><a href="#l148">148</a><td>          /** @type {!webdriver.WebElement} */ (opt_elementOrButton));<tr><td><a id="l149"></a><a href="#l149">149</a><td>    }<tr><td><a id="l150"></a><a href="#l150">150</a><td>    button = goog.isDef(opt_button) ? opt_button : webdriver.Button.LEFT;<tr><td><a id="l151"></a><a href="#l151">151</a><td>  }<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>  var command = new webdriver.Command(commandName).<tr><td><a id="l154"></a><a href="#l154">154</a><td>      setParameter(&#39;button&#39;, button);<tr><td><a id="l155"></a><a href="#l155">155</a><td>  this.schedule_(description, command);<tr><td><a id="l156"></a><a href="#l156">156</a><td>  return this;<tr><td><a id="l157"></a><a href="#l157">157</a><td>};<tr><td><a id="l158"></a><a href="#l158">158</a><td><tr><td><a id="l159"></a><a href="#l159">159</a><td><tr><td><a id="l160"></a><a href="#l160">160</a><td>/**<tr><td><a id="l161"></a><a href="#l161">161</a><td> * Presses a mouse button. The mouse button will not be released until<tr><td><a id="l162"></a><a href="#l162">162</a><td> * {@link #mouseUp} is called, regardless of whether that call is made in this<tr><td><a id="l163"></a><a href="#l163">163</a><td> * sequence or another. The behavior for out-of-order events (e.g. mouseDown,<tr><td><a id="l164"></a><a href="#l164">164</a><td> * click) is undefined.<tr><td><a id="l165"></a><a href="#l165">165</a><td> *<tr><td><a id="l166"></a><a href="#l166">166</a><td> * If an element is provided, the mouse will first be moved to the center<tr><td><a id="l167"></a><a href="#l167">167</a><td> * of that element. This is equivalent to:<tr><td><a id="l168"></a><a href="#l168">168</a><td> *<tr><td><a id="l169"></a><a href="#l169">169</a><td> *     sequence.mouseMove(element).mouseDown()<tr><td><a id="l170"></a><a href="#l170">170</a><td> *<tr><td><a id="l171"></a><a href="#l171">171</a><td> * Warning: this method currently only supports the left mouse button. See<tr><td><a id="l172"></a><a href="#l172">172</a><td> * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).<tr><td><a id="l173"></a><a href="#l173">173</a><td> *<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a id="l175"></a><a href="#l175">175</a><td> *     the element to interact with or the button to click with.<tr><td><a id="l176"></a><a href="#l176">176</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a id="l177"></a><a href="#l177">177</a><td> *     button is specified.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a id="l179"></a><a href="#l179">179</a><td> *     {@link webdriver.Button.LEFT}. Ignored if a button is provided as the<tr><td><a id="l180"></a><a href="#l180">180</a><td> *     first argument.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l182"></a><a href="#l182">182</a><td> */<tr><td><a id="l183"></a><a href="#l183">183</a><td>webdriver.ActionSequence.prototype.mouseDown = function(opt_elementOrButton,<tr><td><a id="l184"></a><a href="#l184">184</a><td>                                                        opt_button) {<tr><td><a id="l185"></a><a href="#l185">185</a><td>  return this.scheduleMouseAction_(&#39;mouseDown&#39;,<tr><td><a id="l186"></a><a href="#l186">186</a><td>      webdriver.CommandName.MOUSE_DOWN, opt_elementOrButton, opt_button);<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><tr><td><a id="l190"></a><a href="#l190">190</a><td>/**<tr><td><a id="l191"></a><a href="#l191">191</a><td> * Releases a mouse button. Behavior is undefined for calling this function<tr><td><a id="l192"></a><a href="#l192">192</a><td> * without a previous call to {@link #mouseDown}.<tr><td><a id="l193"></a><a href="#l193">193</a><td> *<tr><td><a id="l194"></a><a href="#l194">194</a><td> * If an element is provided, the mouse will first be moved to the center<tr><td><a id="l195"></a><a href="#l195">195</a><td> * of that element. This is equivalent to:<tr><td><a id="l196"></a><a href="#l196">196</a><td> *<tr><td><a id="l197"></a><a href="#l197">197</a><td> *     sequence.mouseMove(element).mouseUp()<tr><td><a id="l198"></a><a href="#l198">198</a><td> *<tr><td><a id="l199"></a><a href="#l199">199</a><td> * Warning: this method currently only supports the left mouse button. See<tr><td><a id="l200"></a><a href="#l200">200</a><td> * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).<tr><td><a id="l201"></a><a href="#l201">201</a><td> *<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a id="l203"></a><a href="#l203">203</a><td> *     the element to interact with or the button to click with.<tr><td><a id="l204"></a><a href="#l204">204</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a id="l205"></a><a href="#l205">205</a><td> *     button is specified.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a id="l207"></a><a href="#l207">207</a><td> *     {@link webdriver.Button.LEFT}. Ignored if a button is provided as the<tr><td><a id="l208"></a><a href="#l208">208</a><td> *     first argument.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>webdriver.ActionSequence.prototype.mouseUp = function(opt_elementOrButton,<tr><td><a id="l212"></a><a href="#l212">212</a><td>                                                      opt_button) {<tr><td><a id="l213"></a><a href="#l213">213</a><td>  return this.scheduleMouseAction_(&#39;mouseUp&#39;,<tr><td><a id="l214"></a><a href="#l214">214</a><td>      webdriver.CommandName.MOUSE_UP, opt_elementOrButton, opt_button);<tr><td><a id="l215"></a><a href="#l215">215</a><td>};<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> * Convenience function for performing a &quot;drag and drop&quot; manuever. The target<tr><td><a id="l220"></a><a href="#l220">220</a><td> * element may be moved to the location of another element, or by an offset (in<tr><td><a id="l221"></a><a href="#l221">221</a><td> * pixels).<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @param {!webdriver.WebElement} element The element to drag.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @param {(!webdriver.WebElement|{x: number, y: number})} location The<tr><td><a id="l224"></a><a href="#l224">224</a><td> *     location to drag to, either as another WebElement or an offset in pixels.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l226"></a><a href="#l226">226</a><td> */<tr><td><a id="l227"></a><a href="#l227">227</a><td>webdriver.ActionSequence.prototype.dragAndDrop = function(element, location) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>  return this.mouseDown(element).mouseMove(location).mouseUp();<tr><td><a id="l229"></a><a href="#l229">229</a><td>};<tr><td><a id="l230"></a><a href="#l230">230</a><td><tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td>/**<tr><td><a id="l233"></a><a href="#l233">233</a><td> * Clicks a mouse button.<tr><td><a id="l234"></a><a href="#l234">234</a><td> *<tr><td><a id="l235"></a><a href="#l235">235</a><td> * If an element is provided, the mouse will first be moved to the center<tr><td><a id="l236"></a><a href="#l236">236</a><td> * of that element. This is equivalent to:<tr><td><a id="l237"></a><a href="#l237">237</a><td> *<tr><td><a id="l238"></a><a href="#l238">238</a><td> *     sequence.mouseMove(element).click()<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 {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a id="l241"></a><a href="#l241">241</a><td> *     the element to interact with or the button to click with.<tr><td><a id="l242"></a><a href="#l242">242</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a id="l243"></a><a href="#l243">243</a><td> *     button is specified.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a id="l245"></a><a href="#l245">245</a><td> *     {@link webdriver.Button.LEFT}. Ignored if a button is provided as the<tr><td><a id="l246"></a><a href="#l246">246</a><td> *     first argument.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l248"></a><a href="#l248">248</a><td> */<tr><td><a id="l249"></a><a href="#l249">249</a><td>webdriver.ActionSequence.prototype.click = function(opt_elementOrButton,<tr><td><a id="l250"></a><a href="#l250">250</a><td>                                                    opt_button) {<tr><td><a id="l251"></a><a href="#l251">251</a><td>  return this.scheduleMouseAction_(&#39;click&#39;,<tr><td><a id="l252"></a><a href="#l252">252</a><td>      webdriver.CommandName.CLICK, opt_elementOrButton, opt_button);<tr><td><a id="l253"></a><a href="#l253">253</a><td>};<tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td><tr><td><a id="l256"></a><a href="#l256">256</a><td>/**<tr><td><a id="l257"></a><a href="#l257">257</a><td> * Double-clicks a mouse button.<tr><td><a id="l258"></a><a href="#l258">258</a><td> *<tr><td><a id="l259"></a><a href="#l259">259</a><td> * If an element is provided, the mouse will first be moved to the center of<tr><td><a id="l260"></a><a href="#l260">260</a><td> * that element. This is equivalent to:<tr><td><a id="l261"></a><a href="#l261">261</a><td> *<tr><td><a id="l262"></a><a href="#l262">262</a><td> *     sequence.mouseMove(element).doubleClick()<tr><td><a id="l263"></a><a href="#l263">263</a><td> *<tr><td><a id="l264"></a><a href="#l264">264</a><td> * Warning: this method currently only supports the left mouse button. See<tr><td><a id="l265"></a><a href="#l265">265</a><td> * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).<tr><td><a id="l266"></a><a href="#l266">266</a><td> *<tr><td><a id="l267"></a><a href="#l267">267</a><td> * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either<tr><td><a id="l268"></a><a href="#l268">268</a><td> *     the element to interact with or the button to click with.<tr><td><a id="l269"></a><a href="#l269">269</a><td> *     Defaults to {@link webdriver.Button.LEFT} if neither an element nor<tr><td><a id="l270"></a><a href="#l270">270</a><td> *     button is specified.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @param {webdriver.Button=} opt_button The button to use. Defaults to<tr><td><a id="l272"></a><a href="#l272">272</a><td> *     {@link webdriver.Button.LEFT}. Ignored if a button is provided as the<tr><td><a id="l273"></a><a href="#l273">273</a><td> *     first argument.<tr><td><a id="l274"></a><a href="#l274">274</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l275"></a><a href="#l275">275</a><td> */<tr><td><a id="l276"></a><a href="#l276">276</a><td>webdriver.ActionSequence.prototype.doubleClick = function(opt_elementOrButton,<tr><td><a id="l277"></a><a href="#l277">277</a><td>                                                          opt_button) {<tr><td><a id="l278"></a><a href="#l278">278</a><td>  return this.scheduleMouseAction_(&#39;doubleClick&#39;,<tr><td><a id="l279"></a><a href="#l279">279</a><td>      webdriver.CommandName.DOUBLE_CLICK, opt_elementOrButton, opt_button);<tr><td><a id="l280"></a><a href="#l280">280</a><td>};<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td><tr><td><a id="l283"></a><a href="#l283">283</a><td>/**<tr><td><a id="l284"></a><a href="#l284">284</a><td> * Schedules a keyboard action.<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @param {string} description A simple descriptive label for the scheduled<tr><td><a id="l286"></a><a href="#l286">286</a><td> *     action.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @param {!Array.&lt;(string|!webdriver.Key)&gt;} keys The keys to send.<tr><td><a id="l288"></a><a href="#l288">288</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @private<tr><td><a id="l290"></a><a href="#l290">290</a><td> */<tr><td><a id="l291"></a><a href="#l291">291</a><td>webdriver.ActionSequence.prototype.scheduleKeyboardAction_ = function(<tr><td><a id="l292"></a><a href="#l292">292</a><td>    description, keys) {<tr><td><a id="l293"></a><a href="#l293">293</a><td>  var command =<tr><td><a id="l294"></a><a href="#l294">294</a><td>      new webdriver.Command(webdriver.CommandName.SEND_KEYS_TO_ACTIVE_ELEMENT).<tr><td><a id="l295"></a><a href="#l295">295</a><td>          setParameter(&#39;value&#39;, keys);<tr><td><a id="l296"></a><a href="#l296">296</a><td>  this.schedule_(description, command);<tr><td><a id="l297"></a><a href="#l297">297</a><td>  return this;<tr><td><a id="l298"></a><a href="#l298">298</a><td>};<tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td>/**<tr><td><a id="l302"></a><a href="#l302">302</a><td> * Checks that a key is a modifier key.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @param {!webdriver.Key} key The key to check.<tr><td><a id="l304"></a><a href="#l304">304</a><td> * @throws {Error} If the key is not a modifier key.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @private<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>webdriver.ActionSequence.checkModifierKey_ = function(key) {<tr><td><a id="l308"></a><a href="#l308">308</a><td>  if (key !== webdriver.Key.ALT &amp;&amp; key !== webdriver.Key.CONTROL &amp;&amp;<tr><td><a id="l309"></a><a href="#l309">309</a><td>      key !== webdriver.Key.SHIFT &amp;&amp; key !== webdriver.Key.COMMAND) {<tr><td><a id="l310"></a><a href="#l310">310</a><td>    throw Error(&#39;Not a modifier key&#39;);<tr><td><a id="l311"></a><a href="#l311">311</a><td>  }<tr><td><a id="l312"></a><a href="#l312">312</a><td>};<tr><td><a id="l313"></a><a href="#l313">313</a><td><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> * Performs a modifier key press. The modifier key is &lt;em&gt;not released&lt;/em&gt;<tr><td><a id="l317"></a><a href="#l317">317</a><td> * until {@link #keyUp} or {@link #sendKeys} is called. The key press will be<tr><td><a id="l318"></a><a href="#l318">318</a><td> * targetted at the currently focused element.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @param {!webdriver.Key} key The modifier key to push. Must be one of<tr><td><a id="l320"></a><a href="#l320">320</a><td> *     {ALT, CONTROL, SHIFT, COMMAND, META}.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @throws {Error} If the key is not a valid modifier key.<tr><td><a id="l323"></a><a href="#l323">323</a><td> */<tr><td><a id="l324"></a><a href="#l324">324</a><td>webdriver.ActionSequence.prototype.keyDown = function(key) {<tr><td><a id="l325"></a><a href="#l325">325</a><td>  webdriver.ActionSequence.checkModifierKey_(key);<tr><td><a id="l326"></a><a href="#l326">326</a><td>  return this.scheduleKeyboardAction_(&#39;keyDown&#39;, [key]);<tr><td><a id="l327"></a><a href="#l327">327</a><td>};<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * Performs a modifier key release. The release is targetted at the currently<tr><td><a id="l332"></a><a href="#l332">332</a><td> * focused element.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @param {!webdriver.Key} key The modifier key to release. Must be one of<tr><td><a id="l334"></a><a href="#l334">334</a><td> *     {ALT, CONTROL, SHIFT, COMMAND, META}.<tr><td><a id="l335"></a><a href="#l335">335</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l336"></a><a href="#l336">336</a><td> * @throws {Error} If the key is not a valid modifier key.<tr><td><a id="l337"></a><a href="#l337">337</a><td> */<tr><td><a id="l338"></a><a href="#l338">338</a><td>webdriver.ActionSequence.prototype.keyUp = function(key) {<tr><td><a id="l339"></a><a href="#l339">339</a><td>  webdriver.ActionSequence.checkModifierKey_(key);<tr><td><a id="l340"></a><a href="#l340">340</a><td>  return this.scheduleKeyboardAction_(&#39;keyUp&#39;, [key]);<tr><td><a id="l341"></a><a href="#l341">341</a><td>};<tr><td><a id="l342"></a><a href="#l342">342</a><td><tr><td><a id="l343"></a><a href="#l343">343</a><td><tr><td><a id="l344"></a><a href="#l344">344</a><td>/**<tr><td><a id="l345"></a><a href="#l345">345</a><td> * Simulates typing multiple keys. Each modifier key encountered in the<tr><td><a id="l346"></a><a href="#l346">346</a><td> * sequence will not be released until it is encountered again. All key events<tr><td><a id="l347"></a><a href="#l347">347</a><td> * will be targetted at the currently focused element.<tr><td><a id="l348"></a><a href="#l348">348</a><td> * @param {...(string|!webdriver.Key|!Array.&lt;(string|!webdriver.Key)&gt;)} var_args<tr><td><a id="l349"></a><a href="#l349">349</a><td> *     The keys to type.<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @return {!webdriver.ActionSequence} A self reference.<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @throws {Error} If the key is not a valid modifier key.<tr><td><a id="l352"></a><a href="#l352">352</a><td> */<tr><td><a id="l353"></a><a href="#l353">353</a><td>webdriver.ActionSequence.prototype.sendKeys = function(var_args) {<tr><td><a id="l354"></a><a href="#l354">354</a><td>  var keys = goog.array.flatten(goog.array.slice(arguments, 0));<tr><td><a id="l355"></a><a href="#l355">355</a><td>  return this.scheduleKeyboardAction_(&#39;sendKeys&#39;, keys);<tr><td><a id="l356"></a><a href="#l356">356</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/builder.js.src.html b/docs/source/lib/webdriver/builder.js.src.html
index 8e10924..c51d70d 100644
--- a/docs/source/lib/webdriver/builder.js.src.html
+++ b/docs/source/lib/webdriver/builder.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>builder.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/builder.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.Builder&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;webdriver.AbstractBuilder&#39;);<tr><td><a name="l19" href="#l19">19</a><td>goog.require(&#39;webdriver.FirefoxDomExecutor&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.require(&#39;webdriver.WebDriver&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.require(&#39;webdriver.http.CorsClient&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.require(&#39;webdriver.http.Executor&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.require(&#39;webdriver.http.XhrClient&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;webdriver.process&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>/**<tr><td><a name="l29" href="#l29">29</a><td> * @constructor<tr><td><a name="l30" href="#l30">30</a><td> * @extends {webdriver.AbstractBuilder}<tr><td><a name="l31" href="#l31">31</a><td> */<tr><td><a name="l32" href="#l32">32</a><td>webdriver.Builder = function() {<tr><td><a name="l33" href="#l33">33</a><td>  goog.base(this);<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>  /**<tr><td><a name="l36" href="#l36">36</a><td>   * ID of an existing WebDriver session that new clients should use.<tr><td><a name="l37" href="#l37">37</a><td>   * Initialized from the value of the<tr><td><a name="l38" href="#l38">38</a><td>   * {@link webdriver.AbstractBuilder.SESSION_ID_ENV} environment variable, but<tr><td><a name="l39" href="#l39">39</a><td>   * may be overridden using<tr><td><a name="l40" href="#l40">40</a><td>   * {@link webdriver.AbstractBuilder#usingSession}.<tr><td><a name="l41" href="#l41">41</a><td>   * @private {string}<tr><td><a name="l42" href="#l42">42</a><td>   */<tr><td><a name="l43" href="#l43">43</a><td>  this.sessionId_ =<tr><td><a name="l44" href="#l44">44</a><td>      webdriver.process.getEnv(webdriver.Builder.SESSION_ID_ENV);<tr><td><a name="l45" href="#l45">45</a><td>};<tr><td><a name="l46" href="#l46">46</a><td>goog.inherits(webdriver.Builder, webdriver.AbstractBuilder);<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>/**<tr><td><a name="l50" href="#l50">50</a><td> * Environment variable that defines the session ID of an existing WebDriver<tr><td><a name="l51" href="#l51">51</a><td> * session to use when creating clients. If set, all new Builder instances will<tr><td><a name="l52" href="#l52">52</a><td> * default to creating clients that use this session. To create a new session,<tr><td><a name="l53" href="#l53">53</a><td> * use {@code #useExistingSession(boolean)}. The use of this environment<tr><td><a name="l54" href="#l54">54</a><td> * variable requires that {@link webdriver.AbstractBuilder.SERVER_URL_ENV} also<tr><td><a name="l55" href="#l55">55</a><td> * be set.<tr><td><a name="l56" href="#l56">56</a><td> * @type {string}<tr><td><a name="l57" href="#l57">57</a><td> * @const<tr><td><a name="l58" href="#l58">58</a><td> * @see webdriver.process.getEnv<tr><td><a name="l59" href="#l59">59</a><td> */<tr><td><a name="l60" href="#l60">60</a><td>webdriver.Builder.SESSION_ID_ENV = &#39;wdsid&#39;;<tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td>/**<tr><td><a name="l64" href="#l64">64</a><td> * Configures the builder to create a client that will use an existing WebDriver<tr><td><a name="l65" href="#l65">65</a><td> * session.<tr><td><a name="l66" href="#l66">66</a><td> * @param {string} id The existing session ID to use.<tr><td><a name="l67" href="#l67">67</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l68" href="#l68">68</a><td> */<tr><td><a name="l69" href="#l69">69</a><td>webdriver.Builder.prototype.usingSession = function(id) {<tr><td><a name="l70" href="#l70">70</a><td>  this.sessionId_ = id;<tr><td><a name="l71" href="#l71">71</a><td>  return this;<tr><td><a name="l72" href="#l72">72</a><td>};<tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td>/**<tr><td><a name="l76" href="#l76">76</a><td> * @return {string} The ID of the session, if any, this builder is configured<tr><td><a name="l77" href="#l77">77</a><td> *     to reuse.<tr><td><a name="l78" href="#l78">78</a><td> */<tr><td><a name="l79" href="#l79">79</a><td>webdriver.Builder.prototype.getSession = function() {<tr><td><a name="l80" href="#l80">80</a><td>  return this.sessionId_;<tr><td><a name="l81" href="#l81">81</a><td>};<tr><td><a name="l82" href="#l82">82</a><td><tr><td><a name="l83" href="#l83">83</a><td><tr><td><a name="l84" href="#l84">84</a><td>/**<tr><td><a name="l85" href="#l85">85</a><td> * @override<tr><td><a name="l86" href="#l86">86</a><td> */<tr><td><a name="l87" href="#l87">87</a><td>webdriver.Builder.prototype.build = function() {<tr><td><a name="l88" href="#l88">88</a><td>  if (goog.userAgent.GECKO &amp;&amp; document.readyState != &#39;complete&#39;) {<tr><td><a name="l89" href="#l89">89</a><td>    throw Error(&#39;Cannot create driver instance before window.onload&#39;);<tr><td><a name="l90" href="#l90">90</a><td>  }<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td>  var executor;<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td>  if (webdriver.FirefoxDomExecutor.isAvailable()) {<tr><td><a name="l95" href="#l95">95</a><td>    executor = new webdriver.FirefoxDomExecutor();<tr><td><a name="l96" href="#l96">96</a><td>    return webdriver.WebDriver.createSession(executor, this.getCapabilities());<tr><td><a name="l97" href="#l97">97</a><td>  } else {<tr><td><a name="l98" href="#l98">98</a><td>    var url = this.getServerUrl() ||<tr><td><a name="l99" href="#l99">99</a><td>        webdriver.AbstractBuilder.DEFAULT_SERVER_URL;<tr><td><a name="l100" href="#l100">100</a><td>    var client;<tr><td><a name="l101" href="#l101">101</a><td>    if (url[0] == &#39;/&#39;) {<tr><td><a name="l102" href="#l102">102</a><td>      var origin = window.location.origin ||<tr><td><a name="l103" href="#l103">103</a><td>          (window.location.protocol + &#39;//&#39; + window.location.host);<tr><td><a name="l104" href="#l104">104</a><td>      client = new webdriver.http.XhrClient(origin + url);<tr><td><a name="l105" href="#l105">105</a><td>    } else {<tr><td><a name="l106" href="#l106">106</a><td>      client = new webdriver.http.CorsClient(url);<tr><td><a name="l107" href="#l107">107</a><td>    }<tr><td><a name="l108" href="#l108">108</a><td>    executor = new webdriver.http.Executor(client);<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>    if (this.getSession()) {<tr><td><a name="l111" href="#l111">111</a><td>      return webdriver.WebDriver.attachToSession(executor, this.getSession());<tr><td><a name="l112" href="#l112">112</a><td>    } else {<tr><td><a name="l113" href="#l113">113</a><td>      throw new Error(&#39;Unable to create a new client for this browser. The &#39; +<tr><td><a name="l114" href="#l114">114</a><td>          &#39;WebDriver session ID has not been defined.&#39;);<tr><td><a name="l115" href="#l115">115</a><td>    }<tr><td><a name="l116" href="#l116">116</a><td>  }<tr><td><a name="l117" href="#l117">117</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>builder.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/builder.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.Builder&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;webdriver.AbstractBuilder&#39;);<tr><td><a name="l19" href="#l19">19</a><td>goog.require(&#39;webdriver.FirefoxDomExecutor&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.require(&#39;webdriver.WebDriver&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.require(&#39;webdriver.http.CorsClient&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.require(&#39;webdriver.http.Executor&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.require(&#39;webdriver.http.XhrClient&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;webdriver.process&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>/**<tr><td><a name="l29" href="#l29">29</a><td> * @constructor<tr><td><a name="l30" href="#l30">30</a><td> * @extends {webdriver.AbstractBuilder}<tr><td><a name="l31" href="#l31">31</a><td> */<tr><td><a name="l32" href="#l32">32</a><td>webdriver.Builder = function() {<tr><td><a name="l33" href="#l33">33</a><td>  goog.base(this);<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>  /**<tr><td><a name="l36" href="#l36">36</a><td>   * ID of an existing WebDriver session that new clients should use.<tr><td><a name="l37" href="#l37">37</a><td>   * Initialized from the value of the<tr><td><a name="l38" href="#l38">38</a><td>   * {@link webdriver.AbstractBuilder.SESSION_ID_ENV} environment variable, but<tr><td><a name="l39" href="#l39">39</a><td>   * may be overridden using<tr><td><a name="l40" href="#l40">40</a><td>   * {@link webdriver.AbstractBuilder#usingSession}.<tr><td><a name="l41" href="#l41">41</a><td>   * @private {string}<tr><td><a name="l42" href="#l42">42</a><td>   */<tr><td><a name="l43" href="#l43">43</a><td>  this.sessionId_ =<tr><td><a name="l44" href="#l44">44</a><td>      webdriver.process.getEnv(webdriver.Builder.SESSION_ID_ENV);<tr><td><a name="l45" href="#l45">45</a><td>};<tr><td><a name="l46" href="#l46">46</a><td>goog.inherits(webdriver.Builder, webdriver.AbstractBuilder);<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>/**<tr><td><a name="l50" href="#l50">50</a><td> * Environment variable that defines the session ID of an existing WebDriver<tr><td><a name="l51" href="#l51">51</a><td> * session to use when creating clients. If set, all new Builder instances will<tr><td><a name="l52" href="#l52">52</a><td> * default to creating clients that use this session. To create a new session,<tr><td><a name="l53" href="#l53">53</a><td> * use {@code #useExistingSession(boolean)}. The use of this environment<tr><td><a name="l54" href="#l54">54</a><td> * variable requires that {@link webdriver.AbstractBuilder.SERVER_URL_ENV} also<tr><td><a name="l55" href="#l55">55</a><td> * be set.<tr><td><a name="l56" href="#l56">56</a><td> * @type {string}<tr><td><a name="l57" href="#l57">57</a><td> * @const<tr><td><a name="l58" href="#l58">58</a><td> * @see webdriver.process.getEnv<tr><td><a name="l59" href="#l59">59</a><td> */<tr><td><a name="l60" href="#l60">60</a><td>webdriver.Builder.SESSION_ID_ENV = &#39;wdsid&#39;;<tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td>/**<tr><td><a name="l64" href="#l64">64</a><td> * Configures the builder to create a client that will use an existing WebDriver<tr><td><a name="l65" href="#l65">65</a><td> * session.<tr><td><a name="l66" href="#l66">66</a><td> * @param {string} id The existing session ID to use.<tr><td><a name="l67" href="#l67">67</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l68" href="#l68">68</a><td> */<tr><td><a name="l69" href="#l69">69</a><td>webdriver.Builder.prototype.usingSession = function(id) {<tr><td><a name="l70" href="#l70">70</a><td>  this.sessionId_ = id;<tr><td><a name="l71" href="#l71">71</a><td>  return this;<tr><td><a name="l72" href="#l72">72</a><td>};<tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td>/**<tr><td><a name="l76" href="#l76">76</a><td> * @return {string} The ID of the session, if any, this builder is configured<tr><td><a name="l77" href="#l77">77</a><td> *     to reuse.<tr><td><a name="l78" href="#l78">78</a><td> */<tr><td><a name="l79" href="#l79">79</a><td>webdriver.Builder.prototype.getSession = function() {<tr><td><a name="l80" href="#l80">80</a><td>  return this.sessionId_;<tr><td><a name="l81" href="#l81">81</a><td>};<tr><td><a name="l82" href="#l82">82</a><td><tr><td><a name="l83" href="#l83">83</a><td><tr><td><a name="l84" href="#l84">84</a><td>/**<tr><td><a name="l85" href="#l85">85</a><td> * @override<tr><td><a name="l86" href="#l86">86</a><td> */<tr><td><a name="l87" href="#l87">87</a><td>webdriver.Builder.prototype.build = function() {<tr><td><a name="l88" href="#l88">88</a><td>  if (goog.userAgent.GECKO &amp;&amp; document.readyState != &#39;complete&#39;) {<tr><td><a name="l89" href="#l89">89</a><td>    throw Error(&#39;Cannot create driver instance before window.onload&#39;);<tr><td><a name="l90" href="#l90">90</a><td>  }<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td>  var executor;<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td>  if (webdriver.FirefoxDomExecutor.isAvailable()) {<tr><td><a name="l95" href="#l95">95</a><td>    executor = new webdriver.FirefoxDomExecutor();<tr><td><a name="l96" href="#l96">96</a><td>    return webdriver.WebDriver.createSession(executor, this.getCapabilities());<tr><td><a name="l97" href="#l97">97</a><td>  } else {<tr><td><a name="l98" href="#l98">98</a><td>    var url = this.getServerUrl() ||<tr><td><a name="l99" href="#l99">99</a><td>        webdriver.AbstractBuilder.DEFAULT_SERVER_URL;<tr><td><a name="l100" href="#l100">100</a><td>    var client;<tr><td><a name="l101" href="#l101">101</a><td>    if (url[0] == &#39;/&#39;) {<tr><td><a name="l102" href="#l102">102</a><td>      var origin = window.location.origin ||<tr><td><a name="l103" href="#l103">103</a><td>          (window.location.protocol + &#39;//&#39; + window.location.host);<tr><td><a name="l104" href="#l104">104</a><td>      client = new webdriver.http.XhrClient(origin + url);<tr><td><a name="l105" href="#l105">105</a><td>    } else {<tr><td><a name="l106" href="#l106">106</a><td>      client = new webdriver.http.CorsClient(url);<tr><td><a name="l107" href="#l107">107</a><td>    }<tr><td><a name="l108" href="#l108">108</a><td>    executor = new webdriver.http.Executor(client);<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>    if (this.getSession()) {<tr><td><a name="l111" href="#l111">111</a><td>      return webdriver.WebDriver.attachToSession(executor, this.getSession());<tr><td><a name="l112" href="#l112">112</a><td>    } else {<tr><td><a name="l113" href="#l113">113</a><td>      throw new Error(&#39;Unable to create a new client for this browser. The &#39; +<tr><td><a name="l114" href="#l114">114</a><td>          &#39;WebDriver session ID has not been defined.&#39;);<tr><td><a name="l115" href="#l115">115</a><td>    }<tr><td><a name="l116" href="#l116">116</a><td>  }<tr><td><a name="l117" href="#l117">117</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/button.js.src.html b/docs/source/lib/webdriver/button.js.src.html
index 2a8728a..6d00b9a 100644
--- a/docs/source/lib/webdriver/button.js.src.html
+++ b/docs/source/lib/webdriver/button.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>button.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/button.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Selenium comitters<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2012 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>// You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>goog.provide(&#39;webdriver.Button&#39;);<tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>/**<tr><td><a name="l20" href="#l20">20</a><td> * Enumeration of the buttons used in the advanced interactions API.<tr><td><a name="l21" href="#l21">21</a><td> * @enum {number}<tr><td><a name="l22" href="#l22">22</a><td> */<tr><td><a name="l23" href="#l23">23</a><td>webdriver.Button = {<tr><td><a name="l24" href="#l24">24</a><td>  LEFT: 0,<tr><td><a name="l25" href="#l25">25</a><td>  MIDDLE: 1,<tr><td><a name="l26" href="#l26">26</a><td>  RIGHT: 2<tr><td><a name="l27" href="#l27">27</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>button.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/webdriver/button.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.provide(&#39;webdriver.Button&#39;);<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>/**<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Enumeration of the buttons used in the advanced interactions API.<tr><td><a id="l23"></a><a href="#l23">23</a><td> * @enum {number}<tr><td><a id="l24"></a><a href="#l24">24</a><td> */<tr><td><a id="l25"></a><a href="#l25">25</a><td>webdriver.Button = {<tr><td><a id="l26"></a><a href="#l26">26</a><td>  LEFT: 0,<tr><td><a id="l27"></a><a href="#l27">27</a><td>  MIDDLE: 1,<tr><td><a id="l28"></a><a href="#l28">28</a><td>  RIGHT: 2<tr><td><a id="l29"></a><a href="#l29">29</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/capabilities.js.src.html b/docs/source/lib/webdriver/capabilities.js.src.html
index bd1a54b..4d1e7de 100644
--- a/docs/source/lib/webdriver/capabilities.js.src.html
+++ b/docs/source/lib/webdriver/capabilities.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>capabilities.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/capabilities.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Defines the webdriver.Capabilities class.<tr><td><a name="l17" href="#l17">17</a><td> */<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.provide(&#39;webdriver.Browser&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;webdriver.Capabilities&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;webdriver.Capability&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * Recognized browser names.<tr><td><a name="l27" href="#l27">27</a><td> * @enum {string}<tr><td><a name="l28" href="#l28">28</a><td> */<tr><td><a name="l29" href="#l29">29</a><td>webdriver.Browser = {<tr><td><a name="l30" href="#l30">30</a><td>  ANDROID: &#39;android&#39;,<tr><td><a name="l31" href="#l31">31</a><td>  CHROME: &#39;chrome&#39;,<tr><td><a name="l32" href="#l32">32</a><td>  FIREFOX: &#39;firefox&#39;,<tr><td><a name="l33" href="#l33">33</a><td>  INTERNET_EXPLORER: &#39;internet explorer&#39;,<tr><td><a name="l34" href="#l34">34</a><td>  IPAD: &#39;iPad&#39;,<tr><td><a name="l35" href="#l35">35</a><td>  IPHONE: &#39;iPhone&#39;,<tr><td><a name="l36" href="#l36">36</a><td>  OPERA: &#39;opera&#39;,<tr><td><a name="l37" href="#l37">37</a><td>  PHANTOM_JS: &#39;phantomjs&#39;,<tr><td><a name="l38" href="#l38">38</a><td>  SAFARI: &#39;safari&#39;,<tr><td><a name="l39" href="#l39">39</a><td>  HTMLUNIT: &#39;htmlunit&#39;<tr><td><a name="l40" href="#l40">40</a><td>};<tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td>/**<tr><td><a name="l45" href="#l45">45</a><td> * Common webdriver capability keys.<tr><td><a name="l46" href="#l46">46</a><td> * @enum {string}<tr><td><a name="l47" href="#l47">47</a><td> */<tr><td><a name="l48" href="#l48">48</a><td>webdriver.Capability = {<tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td>  /**<tr><td><a name="l51" href="#l51">51</a><td>   * Indicates whether a driver should accept all SSL certs by default. This<tr><td><a name="l52" href="#l52">52</a><td>   * capability only applies when requesting a new session. To query whether<tr><td><a name="l53" href="#l53">53</a><td>   * a driver can handle insecure SSL certs, see<tr><td><a name="l54" href="#l54">54</a><td>   * {@link webdriver.Capability.SECURE_SSL}.<tr><td><a name="l55" href="#l55">55</a><td>   */<tr><td><a name="l56" href="#l56">56</a><td>  ACCEPT_SSL_CERTS: &#39;acceptSslCerts&#39;,<tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td>  /**<tr><td><a name="l60" href="#l60">60</a><td>   * The browser name. Common browser names are defined in the<tr><td><a name="l61" href="#l61">61</a><td>   * {@link webdriver.Browser} enum.<tr><td><a name="l62" href="#l62">62</a><td>   */<tr><td><a name="l63" href="#l63">63</a><td>  BROWSER_NAME: &#39;browserName&#39;,<tr><td><a name="l64" href="#l64">64</a><td><tr><td><a name="l65" href="#l65">65</a><td>  /**<tr><td><a name="l66" href="#l66">66</a><td>   * Whether the driver is capable of handling modal alerts (e.g. alert,<tr><td><a name="l67" href="#l67">67</a><td>   * confirm, prompt). To define how a driver &lt;i&gt;should&lt;/i&gt; handle alerts,<tr><td><a name="l68" href="#l68">68</a><td>   * use {@link webdriver.Capability.UNEXPECTED_ALERT_BEHAVIOR}.<tr><td><a name="l69" href="#l69">69</a><td>   */<tr><td><a name="l70" href="#l70">70</a><td>  HANDLES_ALERTS: &#39;handlesAlerts&#39;,<tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td>  /**<tr><td><a name="l73" href="#l73">73</a><td>   * Key for the logging driver logging preferences.<tr><td><a name="l74" href="#l74">74</a><td>   */<tr><td><a name="l75" href="#l75">75</a><td>  LOGGING_PREFS: &#39;loggingPrefs&#39;,<tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td>  /**<tr><td><a name="l78" href="#l78">78</a><td>   * Describes the platform the browser is running on. Will be one of<tr><td><a name="l79" href="#l79">79</a><td>   * ANDROID, IOS, LINUX, MAC, UNIX, or WINDOWS. When &lt;i&gt;requesting&lt;/i&gt; a<tr><td><a name="l80" href="#l80">80</a><td>   * session, ANY may be used to indicate no platform preference (this is<tr><td><a name="l81" href="#l81">81</a><td>   * semantically equivalent to omitting the platform capability).<tr><td><a name="l82" href="#l82">82</a><td>   */<tr><td><a name="l83" href="#l83">83</a><td>  PLATFORM: &#39;platform&#39;,<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td>  /**<tr><td><a name="l86" href="#l86">86</a><td>   * Describes the proxy configuration to use for a new WebDriver session.<tr><td><a name="l87" href="#l87">87</a><td>   */<tr><td><a name="l88" href="#l88">88</a><td>  PROXY: &#39;proxy&#39;,<tr><td><a name="l89" href="#l89">89</a><td><tr><td><a name="l90" href="#l90">90</a><td>  /** Whether the driver supports changing the brower&#39;s orientation. */<tr><td><a name="l91" href="#l91">91</a><td>  ROTATABLE: &#39;rotatable&#39;,<tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>  /**<tr><td><a name="l94" href="#l94">94</a><td>   * Whether a driver is only capable of handling secure SSL certs. To request<tr><td><a name="l95" href="#l95">95</a><td>   * that a driver accept insecure SSL certs by default, use<tr><td><a name="l96" href="#l96">96</a><td>   * {@link webdriver.Capability.ACCEPT_SSL_CERTS}.<tr><td><a name="l97" href="#l97">97</a><td>   */<tr><td><a name="l98" href="#l98">98</a><td>  SECURE_SSL: &#39;secureSsl&#39;,<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td>  /** Whether the driver supports manipulating the app cache. */<tr><td><a name="l101" href="#l101">101</a><td>  SUPPORTS_APPLICATION_CACHE: &#39;applicationCacheEnabled&#39;,<tr><td><a name="l102" href="#l102">102</a><td><tr><td><a name="l103" href="#l103">103</a><td>  /**<tr><td><a name="l104" href="#l104">104</a><td>   * Whether the driver supports controlling the browser&#39;s internet<tr><td><a name="l105" href="#l105">105</a><td>   * connectivity.<tr><td><a name="l106" href="#l106">106</a><td>   */<tr><td><a name="l107" href="#l107">107</a><td>  SUPPORTS_BROWSER_CONNECTION: &#39;browserConnectionEnabled&#39;,<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td>  /** Whether the driver supports locating elements with CSS selectors. */<tr><td><a name="l110" href="#l110">110</a><td>  SUPPORTS_CSS_SELECTORS: &#39;cssSelectorsEnabled&#39;,<tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td>  /** Whether the browser supports JavaScript. */<tr><td><a name="l113" href="#l113">113</a><td>  SUPPORTS_JAVASCRIPT: &#39;javascriptEnabled&#39;,<tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>  /** Whether the driver supports controlling the browser&#39;s location info. */<tr><td><a name="l116" href="#l116">116</a><td>  SUPPORTS_LOCATION_CONTEXT: &#39;locationContextEnabled&#39;,<tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td>  /** Whether the driver supports taking screenshots. */<tr><td><a name="l119" href="#l119">119</a><td>  TAKES_SCREENSHOT: &#39;takesScreenshot&#39;,<tr><td><a name="l120" href="#l120">120</a><td><tr><td><a name="l121" href="#l121">121</a><td>  /**<tr><td><a name="l122" href="#l122">122</a><td>   * Defines how the driver should handle unexpected alerts. The value should<tr><td><a name="l123" href="#l123">123</a><td>   * be one of &quot;accept&quot;, &quot;dismiss&quot;, or &quot;ignore.<tr><td><a name="l124" href="#l124">124</a><td>   */<tr><td><a name="l125" href="#l125">125</a><td>  UNEXPECTED_ALERT_BEHAVIOR: &#39;unexpectedAlertBehavior&#39;,<tr><td><a name="l126" href="#l126">126</a><td><tr><td><a name="l127" href="#l127">127</a><td>  /** Defines the browser version. */<tr><td><a name="l128" href="#l128">128</a><td>  VERSION: &#39;version&#39;<tr><td><a name="l129" href="#l129">129</a><td>};<tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td>/**<tr><td><a name="l134" href="#l134">134</a><td> * @param {(webdriver.Capabilities|Object)=} opt_other Another set of<tr><td><a name="l135" href="#l135">135</a><td> *     capabilities to merge into this instance.<tr><td><a name="l136" href="#l136">136</a><td> * @constructor<tr><td><a name="l137" href="#l137">137</a><td> */<tr><td><a name="l138" href="#l138">138</a><td>webdriver.Capabilities = function(opt_other) {<tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td>  /** @private {!Object} */<tr><td><a name="l141" href="#l141">141</a><td>  this.caps_ = {};<tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td>  if (opt_other) {<tr><td><a name="l144" href="#l144">144</a><td>    this.merge(opt_other);<tr><td><a name="l145" href="#l145">145</a><td>  }<tr><td><a name="l146" href="#l146">146</a><td>};<tr><td><a name="l147" href="#l147">147</a><td><tr><td><a name="l148" href="#l148">148</a><td><tr><td><a name="l149" href="#l149">149</a><td>/**<tr><td><a name="l150" href="#l150">150</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for Android.<tr><td><a name="l151" href="#l151">151</a><td> */<tr><td><a name="l152" href="#l152">152</a><td>webdriver.Capabilities.android = function() {<tr><td><a name="l153" href="#l153">153</a><td>  return new webdriver.Capabilities().<tr><td><a name="l154" href="#l154">154</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.ANDROID).<tr><td><a name="l155" href="#l155">155</a><td>      set(webdriver.Capability.PLATFORM, &#39;ANDROID&#39;);<tr><td><a name="l156" href="#l156">156</a><td>};<tr><td><a name="l157" href="#l157">157</a><td><tr><td><a name="l158" href="#l158">158</a><td><tr><td><a name="l159" href="#l159">159</a><td>/**<tr><td><a name="l160" href="#l160">160</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for Chrome.<tr><td><a name="l161" href="#l161">161</a><td> */<tr><td><a name="l162" href="#l162">162</a><td>webdriver.Capabilities.chrome = function() {<tr><td><a name="l163" href="#l163">163</a><td>  return new webdriver.Capabilities().<tr><td><a name="l164" href="#l164">164</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.CHROME);<tr><td><a name="l165" href="#l165">165</a><td>};<tr><td><a name="l166" href="#l166">166</a><td><tr><td><a name="l167" href="#l167">167</a><td><tr><td><a name="l168" href="#l168">168</a><td>/**<tr><td><a name="l169" href="#l169">169</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for Firefox.<tr><td><a name="l170" href="#l170">170</a><td> */<tr><td><a name="l171" href="#l171">171</a><td>webdriver.Capabilities.firefox = function() {<tr><td><a name="l172" href="#l172">172</a><td>  return new webdriver.Capabilities().<tr><td><a name="l173" href="#l173">173</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.FIREFOX);<tr><td><a name="l174" href="#l174">174</a><td>};<tr><td><a name="l175" href="#l175">175</a><td><tr><td><a name="l176" href="#l176">176</a><td><tr><td><a name="l177" href="#l177">177</a><td>/**<tr><td><a name="l178" href="#l178">178</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for<tr><td><a name="l179" href="#l179">179</a><td> *     Internet Explorer.<tr><td><a name="l180" href="#l180">180</a><td> */<tr><td><a name="l181" href="#l181">181</a><td>webdriver.Capabilities.ie = function() {<tr><td><a name="l182" href="#l182">182</a><td>  return new webdriver.Capabilities().<tr><td><a name="l183" href="#l183">183</a><td>      set(webdriver.Capability.BROWSER_NAME,<tr><td><a name="l184" href="#l184">184</a><td>          webdriver.Browser.INTERNET_EXPLORER).<tr><td><a name="l185" href="#l185">185</a><td>      set(webdriver.Capability.PLATFORM, &#39;WINDOWS&#39;);<tr><td><a name="l186" href="#l186">186</a><td>};<tr><td><a name="l187" href="#l187">187</a><td><tr><td><a name="l188" href="#l188">188</a><td><tr><td><a name="l189" href="#l189">189</a><td>/**<tr><td><a name="l190" href="#l190">190</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for iPad.<tr><td><a name="l191" href="#l191">191</a><td> */<tr><td><a name="l192" href="#l192">192</a><td>webdriver.Capabilities.ipad = function() {<tr><td><a name="l193" href="#l193">193</a><td>  return new webdriver.Capabilities().<tr><td><a name="l194" href="#l194">194</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.IPAD).<tr><td><a name="l195" href="#l195">195</a><td>      set(webdriver.Capability.PLATFORM, &#39;MAC&#39;);<tr><td><a name="l196" href="#l196">196</a><td>};<tr><td><a name="l197" href="#l197">197</a><td><tr><td><a name="l198" href="#l198">198</a><td><tr><td><a name="l199" href="#l199">199</a><td>/**<tr><td><a name="l200" href="#l200">200</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for iPhone.<tr><td><a name="l201" href="#l201">201</a><td> */<tr><td><a name="l202" href="#l202">202</a><td>webdriver.Capabilities.iphone = function() {<tr><td><a name="l203" href="#l203">203</a><td>  return new webdriver.Capabilities().<tr><td><a name="l204" href="#l204">204</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.IPHONE).<tr><td><a name="l205" href="#l205">205</a><td>      set(webdriver.Capability.PLATFORM, &#39;MAC&#39;);<tr><td><a name="l206" href="#l206">206</a><td>};<tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td><tr><td><a name="l209" href="#l209">209</a><td>/**<tr><td><a name="l210" href="#l210">210</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for Opera.<tr><td><a name="l211" href="#l211">211</a><td> */<tr><td><a name="l212" href="#l212">212</a><td>webdriver.Capabilities.opera = function() {<tr><td><a name="l213" href="#l213">213</a><td>  return new webdriver.Capabilities().<tr><td><a name="l214" href="#l214">214</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.OPERA);<tr><td><a name="l215" href="#l215">215</a><td>};<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for<tr><td><a name="l220" href="#l220">220</a><td> *     PhantomJS.<tr><td><a name="l221" href="#l221">221</a><td> */<tr><td><a name="l222" href="#l222">222</a><td>webdriver.Capabilities.phantomjs = function() {<tr><td><a name="l223" href="#l223">223</a><td>  return new webdriver.Capabilities().<tr><td><a name="l224" href="#l224">224</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.PHANTOM_JS);<tr><td><a name="l225" href="#l225">225</a><td>};<tr><td><a name="l226" href="#l226">226</a><td><tr><td><a name="l227" href="#l227">227</a><td><tr><td><a name="l228" href="#l228">228</a><td>/**<tr><td><a name="l229" href="#l229">229</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for Safari.<tr><td><a name="l230" href="#l230">230</a><td> */<tr><td><a name="l231" href="#l231">231</a><td>webdriver.Capabilities.safari = function() {<tr><td><a name="l232" href="#l232">232</a><td>  return new webdriver.Capabilities().<tr><td><a name="l233" href="#l233">233</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.SAFARI);<tr><td><a name="l234" href="#l234">234</a><td>};<tr><td><a name="l235" href="#l235">235</a><td><tr><td><a name="l236" href="#l236">236</a><td><tr><td><a name="l237" href="#l237">237</a><td>/**<tr><td><a name="l238" href="#l238">238</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for HTMLUnit.<tr><td><a name="l239" href="#l239">239</a><td> */<tr><td><a name="l240" href="#l240">240</a><td>webdriver.Capabilities.htmlunit = function() {<tr><td><a name="l241" href="#l241">241</a><td>  return new webdriver.Capabilities().<tr><td><a name="l242" href="#l242">242</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.HTMLUNIT);<tr><td><a name="l243" href="#l243">243</a><td>};<tr><td><a name="l244" href="#l244">244</a><td><tr><td><a name="l245" href="#l245">245</a><td><tr><td><a name="l246" href="#l246">246</a><td>/**<tr><td><a name="l247" href="#l247">247</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for HTMLUnit<tr><td><a name="l248" href="#l248">248</a><td> *     with enabled Javascript.<tr><td><a name="l249" href="#l249">249</a><td> */<tr><td><a name="l250" href="#l250">250</a><td>webdriver.Capabilities.htmlunitwithjs = function() {<tr><td><a name="l251" href="#l251">251</a><td>  return new webdriver.Capabilities().<tr><td><a name="l252" href="#l252">252</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.HTMLUNIT).<tr><td><a name="l253" href="#l253">253</a><td>      set(webdriver.Capability.SUPPORTS_JAVASCRIPT, true);<tr><td><a name="l254" href="#l254">254</a><td>};<tr><td><a name="l255" href="#l255">255</a><td><tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td>/** @return {!Object} The JSON representation of this instance. */<tr><td><a name="l258" href="#l258">258</a><td>webdriver.Capabilities.prototype.toJSON = function() {<tr><td><a name="l259" href="#l259">259</a><td>  return this.caps_;<tr><td><a name="l260" href="#l260">260</a><td>};<tr><td><a name="l261" href="#l261">261</a><td><tr><td><a name="l262" href="#l262">262</a><td><tr><td><a name="l263" href="#l263">263</a><td>/**<tr><td><a name="l264" href="#l264">264</a><td> * Merges another set of capabilities into this instance. Any duplicates in<tr><td><a name="l265" href="#l265">265</a><td> * the provided set will override those already set on this instance.<tr><td><a name="l266" href="#l266">266</a><td> * @param {!(webdriver.Capabilities|Object)} other The capabilities to<tr><td><a name="l267" href="#l267">267</a><td> *     merge into this instance.<tr><td><a name="l268" href="#l268">268</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a name="l269" href="#l269">269</a><td> */<tr><td><a name="l270" href="#l270">270</a><td>webdriver.Capabilities.prototype.merge = function(other) {<tr><td><a name="l271" href="#l271">271</a><td>  var caps = other instanceof webdriver.Capabilities ?<tr><td><a name="l272" href="#l272">272</a><td>      other.caps_ : other;<tr><td><a name="l273" href="#l273">273</a><td>  for (var key in caps) {<tr><td><a name="l274" href="#l274">274</a><td>    if (caps.hasOwnProperty(key)) {<tr><td><a name="l275" href="#l275">275</a><td>      this.set(key, caps[key]);<tr><td><a name="l276" href="#l276">276</a><td>    }<tr><td><a name="l277" href="#l277">277</a><td>  }<tr><td><a name="l278" href="#l278">278</a><td>  return this;<tr><td><a name="l279" href="#l279">279</a><td>};<tr><td><a name="l280" href="#l280">280</a><td><tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td>/**<tr><td><a name="l283" href="#l283">283</a><td> * @param {string} key The capability to set.<tr><td><a name="l284" href="#l284">284</a><td> * @param {*} value The capability value.  Capability values must be JSON<tr><td><a name="l285" href="#l285">285</a><td> *     serializable. Pass {@code null} to unset the capability.<tr><td><a name="l286" href="#l286">286</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a name="l287" href="#l287">287</a><td> */<tr><td><a name="l288" href="#l288">288</a><td>webdriver.Capabilities.prototype.set = function(key, value) {<tr><td><a name="l289" href="#l289">289</a><td>  if (goog.isDefAndNotNull(value)) {<tr><td><a name="l290" href="#l290">290</a><td>    this.caps_[key] = value;<tr><td><a name="l291" href="#l291">291</a><td>  } else {<tr><td><a name="l292" href="#l292">292</a><td>    delete this.caps_[key];<tr><td><a name="l293" href="#l293">293</a><td>  }<tr><td><a name="l294" href="#l294">294</a><td>  return this;<tr><td><a name="l295" href="#l295">295</a><td>};<tr><td><a name="l296" href="#l296">296</a><td><tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td>/**<tr><td><a name="l299" href="#l299">299</a><td> * @param {string} key The capability to return.<tr><td><a name="l300" href="#l300">300</a><td> * @return {*} The capability with the given key, or {@code null} if it has<tr><td><a name="l301" href="#l301">301</a><td> *     not been set.<tr><td><a name="l302" href="#l302">302</a><td> */<tr><td><a name="l303" href="#l303">303</a><td>webdriver.Capabilities.prototype.get = function(key) {<tr><td><a name="l304" href="#l304">304</a><td>  var val = null;<tr><td><a name="l305" href="#l305">305</a><td>  if (this.caps_.hasOwnProperty(key)) {<tr><td><a name="l306" href="#l306">306</a><td>    val = this.caps_[key];<tr><td><a name="l307" href="#l307">307</a><td>  }<tr><td><a name="l308" href="#l308">308</a><td>  return goog.isDefAndNotNull(val) ? val : null;<tr><td><a name="l309" href="#l309">309</a><td>};<tr><td><a name="l310" href="#l310">310</a><td><tr><td><a name="l311" href="#l311">311</a><td><tr><td><a name="l312" href="#l312">312</a><td>/**<tr><td><a name="l313" href="#l313">313</a><td> * @param {string} key The capability to check.<tr><td><a name="l314" href="#l314">314</a><td> * @return {boolean} Whether the specified capability is set.<tr><td><a name="l315" href="#l315">315</a><td> */<tr><td><a name="l316" href="#l316">316</a><td>webdriver.Capabilities.prototype.has = function(key) {<tr><td><a name="l317" href="#l317">317</a><td>  return !!this.get(key);<tr><td><a name="l318" href="#l318">318</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>capabilities.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/webdriver/capabilities.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines the webdriver.Capabilities class.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;webdriver.Browser&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;webdriver.Capabilities&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.Capability&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;webdriver.ProxyConfig&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;webdriver.Serializable&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;webdriver.logging&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Recognized browser names.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @enum {string}<tr><td><a id="l35"></a><a href="#l35">35</a><td> */<tr><td><a id="l36"></a><a href="#l36">36</a><td>webdriver.Browser = {<tr><td><a id="l37"></a><a href="#l37">37</a><td>  ANDROID: &#39;android&#39;,<tr><td><a id="l38"></a><a href="#l38">38</a><td>  CHROME: &#39;chrome&#39;,<tr><td><a id="l39"></a><a href="#l39">39</a><td>  FIREFOX: &#39;firefox&#39;,<tr><td><a id="l40"></a><a href="#l40">40</a><td>  IE: &#39;internet explorer&#39;,<tr><td><a id="l41"></a><a href="#l41">41</a><td>  INTERNET_EXPLORER: &#39;internet explorer&#39;,<tr><td><a id="l42"></a><a href="#l42">42</a><td>  IPAD: &#39;iPad&#39;,<tr><td><a id="l43"></a><a href="#l43">43</a><td>  IPHONE: &#39;iPhone&#39;,<tr><td><a id="l44"></a><a href="#l44">44</a><td>  OPERA: &#39;opera&#39;,<tr><td><a id="l45"></a><a href="#l45">45</a><td>  PHANTOM_JS: &#39;phantomjs&#39;,<tr><td><a id="l46"></a><a href="#l46">46</a><td>  SAFARI: &#39;safari&#39;,<tr><td><a id="l47"></a><a href="#l47">47</a><td>  HTMLUNIT: &#39;htmlunit&#39;<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><tr><td><a id="l52"></a><a href="#l52">52</a><td>/**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * Describes how a proxy should be configured for a WebDriver session.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * Proxy configuration object, as defined by the WebDriver wire protocol.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @typedef {(<tr><td><a id="l56"></a><a href="#l56">56</a><td> *     {proxyType: string}|<tr><td><a id="l57"></a><a href="#l57">57</a><td> *     {proxyType: string,<tr><td><a id="l58"></a><a href="#l58">58</a><td> *      proxyAutoconfigUrl: string}|<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     {proxyType: string,<tr><td><a id="l60"></a><a href="#l60">60</a><td> *      ftpProxy: string,<tr><td><a id="l61"></a><a href="#l61">61</a><td> *      httpProxy: string,<tr><td><a id="l62"></a><a href="#l62">62</a><td> *      sslProxy: string,<tr><td><a id="l63"></a><a href="#l63">63</a><td> *      noProxy: string})}<tr><td><a id="l64"></a><a href="#l64">64</a><td> */<tr><td><a id="l65"></a><a href="#l65">65</a><td>webdriver.ProxyConfig;<tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>/**<tr><td><a id="l70"></a><a href="#l70">70</a><td> * Common webdriver capability keys.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @enum {string}<tr><td><a id="l72"></a><a href="#l72">72</a><td> */<tr><td><a id="l73"></a><a href="#l73">73</a><td>webdriver.Capability = {<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td>  /**<tr><td><a id="l76"></a><a href="#l76">76</a><td>   * Indicates whether a driver should accept all SSL certs by default. This<tr><td><a id="l77"></a><a href="#l77">77</a><td>   * capability only applies when requesting a new session. To query whether<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * a driver can handle insecure SSL certs, see {@link #SECURE_SSL}.<tr><td><a id="l79"></a><a href="#l79">79</a><td>   */<tr><td><a id="l80"></a><a href="#l80">80</a><td>  ACCEPT_SSL_CERTS: &#39;acceptSslCerts&#39;,<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>  /**<tr><td><a id="l84"></a><a href="#l84">84</a><td>   * The browser name. Common browser names are defined in the<tr><td><a id="l85"></a><a href="#l85">85</a><td>   * {@link webdriver.Browser} enum.<tr><td><a id="l86"></a><a href="#l86">86</a><td>   */<tr><td><a id="l87"></a><a href="#l87">87</a><td>  BROWSER_NAME: &#39;browserName&#39;,<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>   * Defines how elements should be scrolled into the viewport for interaction.<tr><td><a id="l91"></a><a href="#l91">91</a><td>   * This capability will be set to zero (0) if elements are aligned with the<tr><td><a id="l92"></a><a href="#l92">92</a><td>   * top of the viewport, or one (1) if aligned with the bottom. The default<tr><td><a id="l93"></a><a href="#l93">93</a><td>   * behavior is to align with the top of the viewport.<tr><td><a id="l94"></a><a href="#l94">94</a><td>   */<tr><td><a id="l95"></a><a href="#l95">95</a><td>  ELEMENT_SCROLL_BEHAVIOR: &#39;elementScrollBehavior&#39;,<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>   * Whether the driver is capable of handling modal alerts (e.g. alert,<tr><td><a id="l99"></a><a href="#l99">99</a><td>   * confirm, prompt). To define how a driver &lt;i&gt;should&lt;/i&gt; handle alerts,<tr><td><a id="l100"></a><a href="#l100">100</a><td>   * use {@link #UNEXPECTED_ALERT_BEHAVIOR}.<tr><td><a id="l101"></a><a href="#l101">101</a><td>   */<tr><td><a id="l102"></a><a href="#l102">102</a><td>  HANDLES_ALERTS: &#39;handlesAlerts&#39;,<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>   * Key for the logging driver logging preferences.<tr><td><a id="l106"></a><a href="#l106">106</a><td>   */<tr><td><a id="l107"></a><a href="#l107">107</a><td>  LOGGING_PREFS: &#39;loggingPrefs&#39;,<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>   * Whether this session generates native events when simulating user input.<tr><td><a id="l111"></a><a href="#l111">111</a><td>   */<tr><td><a id="l112"></a><a href="#l112">112</a><td>  NATIVE_EVENTS: &#39;nativeEvents&#39;,<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>   * Describes the platform the browser is running on. Will be one of<tr><td><a id="l116"></a><a href="#l116">116</a><td>   * ANDROID, IOS, LINUX, MAC, UNIX, or WINDOWS. When &lt;i&gt;requesting&lt;/i&gt; a<tr><td><a id="l117"></a><a href="#l117">117</a><td>   * session, ANY may be used to indicate no platform preference (this is<tr><td><a id="l118"></a><a href="#l118">118</a><td>   * semantically equivalent to omitting the platform capability).<tr><td><a id="l119"></a><a href="#l119">119</a><td>   */<tr><td><a id="l120"></a><a href="#l120">120</a><td>  PLATFORM: &#39;platform&#39;,<tr><td><a id="l121"></a><a href="#l121">121</a><td><tr><td><a id="l122"></a><a href="#l122">122</a><td>  /**<tr><td><a id="l123"></a><a href="#l123">123</a><td>   * Describes the proxy configuration to use for a new WebDriver session.<tr><td><a id="l124"></a><a href="#l124">124</a><td>   */<tr><td><a id="l125"></a><a href="#l125">125</a><td>  PROXY: &#39;proxy&#39;,<tr><td><a id="l126"></a><a href="#l126">126</a><td><tr><td><a id="l127"></a><a href="#l127">127</a><td>  /** Whether the driver supports changing the brower&#39;s orientation. */<tr><td><a id="l128"></a><a href="#l128">128</a><td>  ROTATABLE: &#39;rotatable&#39;,<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>  /**<tr><td><a id="l131"></a><a href="#l131">131</a><td>   * Whether a driver is only capable of handling secure SSL certs. To request<tr><td><a id="l132"></a><a href="#l132">132</a><td>   * that a driver accept insecure SSL certs by default, use<tr><td><a id="l133"></a><a href="#l133">133</a><td>   * {@link #ACCEPT_SSL_CERTS}.<tr><td><a id="l134"></a><a href="#l134">134</a><td>   */<tr><td><a id="l135"></a><a href="#l135">135</a><td>  SECURE_SSL: &#39;secureSsl&#39;,<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>  /** Whether the driver supports manipulating the app cache. */<tr><td><a id="l138"></a><a href="#l138">138</a><td>  SUPPORTS_APPLICATION_CACHE: &#39;applicationCacheEnabled&#39;,<tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td>  /** Whether the driver supports locating elements with CSS selectors. */<tr><td><a id="l141"></a><a href="#l141">141</a><td>  SUPPORTS_CSS_SELECTORS: &#39;cssSelectorsEnabled&#39;,<tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>  /** Whether the browser supports JavaScript. */<tr><td><a id="l144"></a><a href="#l144">144</a><td>  SUPPORTS_JAVASCRIPT: &#39;javascriptEnabled&#39;,<tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td>  /** Whether the driver supports controlling the browser&#39;s location info. */<tr><td><a id="l147"></a><a href="#l147">147</a><td>  SUPPORTS_LOCATION_CONTEXT: &#39;locationContextEnabled&#39;,<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>  /** Whether the driver supports taking screenshots. */<tr><td><a id="l150"></a><a href="#l150">150</a><td>  TAKES_SCREENSHOT: &#39;takesScreenshot&#39;,<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>  /**<tr><td><a id="l153"></a><a href="#l153">153</a><td>   * Defines how the driver should handle unexpected alerts. The value should<tr><td><a id="l154"></a><a href="#l154">154</a><td>   * be one of &quot;accept&quot;, &quot;dismiss&quot;, or &quot;ignore.<tr><td><a id="l155"></a><a href="#l155">155</a><td>   */<tr><td><a id="l156"></a><a href="#l156">156</a><td>  UNEXPECTED_ALERT_BEHAVIOR: &#39;unexpectedAlertBehavior&#39;,<tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td>  /** Defines the browser version. */<tr><td><a id="l159"></a><a href="#l159">159</a><td>  VERSION: &#39;version&#39;<tr><td><a id="l160"></a><a href="#l160">160</a><td>};<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>/**<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {(webdriver.Capabilities|Object)=} opt_other Another set of<tr><td><a id="l166"></a><a href="#l166">166</a><td> *     capabilities to merge into this instance.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @constructor<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @extends {webdriver.Serializable.&lt;!Object.&lt;string, ?&gt;&gt;}<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>webdriver.Capabilities = function(opt_other) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>  webdriver.Serializable.call(this);<tr><td><a id="l172"></a><a href="#l172">172</a><td><tr><td><a id="l173"></a><a href="#l173">173</a><td>  /** @private {!Object.&lt;string, ?&gt;} */<tr><td><a id="l174"></a><a href="#l174">174</a><td>  this.caps_ = {};<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td>  if (opt_other) {<tr><td><a id="l177"></a><a href="#l177">177</a><td>    this.merge(opt_other);<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>goog.inherits(webdriver.Capabilities, webdriver.Serializable);<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for Android.<tr><td><a id="l185"></a><a href="#l185">185</a><td> */<tr><td><a id="l186"></a><a href="#l186">186</a><td>webdriver.Capabilities.android = function() {<tr><td><a id="l187"></a><a href="#l187">187</a><td>  return new webdriver.Capabilities().<tr><td><a id="l188"></a><a href="#l188">188</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.ANDROID).<tr><td><a id="l189"></a><a href="#l189">189</a><td>      set(webdriver.Capability.PLATFORM, &#39;ANDROID&#39;);<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> * @return {!webdriver.Capabilities} A basic set of capabilities for Chrome.<tr><td><a id="l195"></a><a href="#l195">195</a><td> */<tr><td><a id="l196"></a><a href="#l196">196</a><td>webdriver.Capabilities.chrome = function() {<tr><td><a id="l197"></a><a href="#l197">197</a><td>  return new webdriver.Capabilities().<tr><td><a id="l198"></a><a href="#l198">198</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.CHROME);<tr><td><a id="l199"></a><a href="#l199">199</a><td>};<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td><tr><td><a id="l202"></a><a href="#l202">202</a><td>/**<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for Firefox.<tr><td><a id="l204"></a><a href="#l204">204</a><td> */<tr><td><a id="l205"></a><a href="#l205">205</a><td>webdriver.Capabilities.firefox = function() {<tr><td><a id="l206"></a><a href="#l206">206</a><td>  return new webdriver.Capabilities().<tr><td><a id="l207"></a><a href="#l207">207</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.FIREFOX);<tr><td><a id="l208"></a><a href="#l208">208</a><td>};<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for<tr><td><a id="l213"></a><a href="#l213">213</a><td> *     Internet Explorer.<tr><td><a id="l214"></a><a href="#l214">214</a><td> */<tr><td><a id="l215"></a><a href="#l215">215</a><td>webdriver.Capabilities.ie = function() {<tr><td><a id="l216"></a><a href="#l216">216</a><td>  return new webdriver.Capabilities().<tr><td><a id="l217"></a><a href="#l217">217</a><td>      set(webdriver.Capability.BROWSER_NAME,<tr><td><a id="l218"></a><a href="#l218">218</a><td>          webdriver.Browser.INTERNET_EXPLORER).<tr><td><a id="l219"></a><a href="#l219">219</a><td>      set(webdriver.Capability.PLATFORM, &#39;WINDOWS&#39;);<tr><td><a id="l220"></a><a href="#l220">220</a><td>};<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td>/**<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for iPad.<tr><td><a id="l225"></a><a href="#l225">225</a><td> */<tr><td><a id="l226"></a><a href="#l226">226</a><td>webdriver.Capabilities.ipad = function() {<tr><td><a id="l227"></a><a href="#l227">227</a><td>  return new webdriver.Capabilities().<tr><td><a id="l228"></a><a href="#l228">228</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.IPAD).<tr><td><a id="l229"></a><a href="#l229">229</a><td>      set(webdriver.Capability.PLATFORM, &#39;MAC&#39;);<tr><td><a id="l230"></a><a href="#l230">230</a><td>};<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for iPhone.<tr><td><a id="l235"></a><a href="#l235">235</a><td> */<tr><td><a id="l236"></a><a href="#l236">236</a><td>webdriver.Capabilities.iphone = function() {<tr><td><a id="l237"></a><a href="#l237">237</a><td>  return new webdriver.Capabilities().<tr><td><a id="l238"></a><a href="#l238">238</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.IPHONE).<tr><td><a id="l239"></a><a href="#l239">239</a><td>      set(webdriver.Capability.PLATFORM, &#39;MAC&#39;);<tr><td><a id="l240"></a><a href="#l240">240</a><td>};<tr><td><a id="l241"></a><a href="#l241">241</a><td><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> * @return {!webdriver.Capabilities} A basic set of capabilities for Opera.<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>webdriver.Capabilities.opera = function() {<tr><td><a id="l247"></a><a href="#l247">247</a><td>  return new webdriver.Capabilities().<tr><td><a id="l248"></a><a href="#l248">248</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.OPERA);<tr><td><a id="l249"></a><a href="#l249">249</a><td>};<tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td>/**<tr><td><a id="l252"></a><a href="#l252">252</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for<tr><td><a id="l253"></a><a href="#l253">253</a><td> *     PhantomJS.<tr><td><a id="l254"></a><a href="#l254">254</a><td> */<tr><td><a id="l255"></a><a href="#l255">255</a><td>webdriver.Capabilities.phantomjs = function() {<tr><td><a id="l256"></a><a href="#l256">256</a><td>  return new webdriver.Capabilities().<tr><td><a id="l257"></a><a href="#l257">257</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.PHANTOM_JS);<tr><td><a id="l258"></a><a href="#l258">258</a><td>};<tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td>/**<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for Safari.<tr><td><a id="l263"></a><a href="#l263">263</a><td> */<tr><td><a id="l264"></a><a href="#l264">264</a><td>webdriver.Capabilities.safari = function() {<tr><td><a id="l265"></a><a href="#l265">265</a><td>  return new webdriver.Capabilities().<tr><td><a id="l266"></a><a href="#l266">266</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.SAFARI);<tr><td><a id="l267"></a><a href="#l267">267</a><td>};<tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td>/**<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for HTMLUnit.<tr><td><a id="l272"></a><a href="#l272">272</a><td> */<tr><td><a id="l273"></a><a href="#l273">273</a><td>webdriver.Capabilities.htmlunit = function() {<tr><td><a id="l274"></a><a href="#l274">274</a><td>  return new webdriver.Capabilities().<tr><td><a id="l275"></a><a href="#l275">275</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.HTMLUNIT);<tr><td><a id="l276"></a><a href="#l276">276</a><td>};<tr><td><a id="l277"></a><a href="#l277">277</a><td><tr><td><a id="l278"></a><a href="#l278">278</a><td><tr><td><a id="l279"></a><a href="#l279">279</a><td>/**<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @return {!webdriver.Capabilities} A basic set of capabilities for HTMLUnit<tr><td><a id="l281"></a><a href="#l281">281</a><td> *     with enabled Javascript.<tr><td><a id="l282"></a><a href="#l282">282</a><td> */<tr><td><a id="l283"></a><a href="#l283">283</a><td>webdriver.Capabilities.htmlunitwithjs = function() {<tr><td><a id="l284"></a><a href="#l284">284</a><td>  return new webdriver.Capabilities().<tr><td><a id="l285"></a><a href="#l285">285</a><td>      set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.HTMLUNIT).<tr><td><a id="l286"></a><a href="#l286">286</a><td>      set(webdriver.Capability.SUPPORTS_JAVASCRIPT, 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><tr><td><a id="l290"></a><a href="#l290">290</a><td>/**<tr><td><a id="l291"></a><a href="#l291">291</a><td> * @return {!Object.&lt;string, ?&gt;} The JSON representation of this instance. Note,<tr><td><a id="l292"></a><a href="#l292">292</a><td> *    the returned object may contain nested promises that are promised values.<tr><td><a id="l293"></a><a href="#l293">293</a><td> * @override<tr><td><a id="l294"></a><a href="#l294">294</a><td> */<tr><td><a id="l295"></a><a href="#l295">295</a><td>webdriver.Capabilities.prototype.serialize = function() {<tr><td><a id="l296"></a><a href="#l296">296</a><td>  return this.caps_;<tr><td><a id="l297"></a><a href="#l297">297</a><td>};<tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>/**<tr><td><a id="l301"></a><a href="#l301">301</a><td> * Merges another set of capabilities into this instance. Any duplicates in<tr><td><a id="l302"></a><a href="#l302">302</a><td> * the provided set will override those already set on this instance.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @param {!(webdriver.Capabilities|Object)} other The capabilities to<tr><td><a id="l304"></a><a href="#l304">304</a><td> *     merge into this instance.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>webdriver.Capabilities.prototype.merge = function(other) {<tr><td><a id="l308"></a><a href="#l308">308</a><td>  var caps = other instanceof webdriver.Capabilities ?<tr><td><a id="l309"></a><a href="#l309">309</a><td>      other.caps_ : other;<tr><td><a id="l310"></a><a href="#l310">310</a><td>  for (var key in caps) {<tr><td><a id="l311"></a><a href="#l311">311</a><td>    if (caps.hasOwnProperty(key)) {<tr><td><a id="l312"></a><a href="#l312">312</a><td>      this.set(key, caps[key]);<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>  return this;<tr><td><a id="l316"></a><a href="#l316">316</a><td>};<tr><td><a id="l317"></a><a href="#l317">317</a><td><tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td>/**<tr><td><a id="l320"></a><a href="#l320">320</a><td> * @param {string} key The capability to set.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @param {*} value The capability value.  Capability values must be JSON<tr><td><a id="l322"></a><a href="#l322">322</a><td> *     serializable. Pass {@code null} to unset the capability.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a id="l324"></a><a href="#l324">324</a><td> */<tr><td><a id="l325"></a><a href="#l325">325</a><td>webdriver.Capabilities.prototype.set = function(key, value) {<tr><td><a id="l326"></a><a href="#l326">326</a><td>  if (goog.isDefAndNotNull(value)) {<tr><td><a id="l327"></a><a href="#l327">327</a><td>    this.caps_[key] = value;<tr><td><a id="l328"></a><a href="#l328">328</a><td>  } else {<tr><td><a id="l329"></a><a href="#l329">329</a><td>    delete this.caps_[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>  return this;<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><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 {string} key The capability to return.<tr><td><a id="l337"></a><a href="#l337">337</a><td> * @return {*} The capability with the given key, or {@code null} if it has<tr><td><a id="l338"></a><a href="#l338">338</a><td> *     not been set.<tr><td><a id="l339"></a><a href="#l339">339</a><td> */<tr><td><a id="l340"></a><a href="#l340">340</a><td>webdriver.Capabilities.prototype.get = function(key) {<tr><td><a id="l341"></a><a href="#l341">341</a><td>  var val = null;<tr><td><a id="l342"></a><a href="#l342">342</a><td>  if (this.caps_.hasOwnProperty(key)) {<tr><td><a id="l343"></a><a href="#l343">343</a><td>    val = this.caps_[key];<tr><td><a id="l344"></a><a href="#l344">344</a><td>  }<tr><td><a id="l345"></a><a href="#l345">345</a><td>  return goog.isDefAndNotNull(val) ? val : null;<tr><td><a id="l346"></a><a href="#l346">346</a><td>};<tr><td><a id="l347"></a><a href="#l347">347</a><td><tr><td><a id="l348"></a><a href="#l348">348</a><td><tr><td><a id="l349"></a><a href="#l349">349</a><td>/**<tr><td><a id="l350"></a><a href="#l350">350</a><td> * @param {string} key The capability to check.<tr><td><a id="l351"></a><a href="#l351">351</a><td> * @return {boolean} Whether the specified capability is set.<tr><td><a id="l352"></a><a href="#l352">352</a><td> */<tr><td><a id="l353"></a><a href="#l353">353</a><td>webdriver.Capabilities.prototype.has = function(key) {<tr><td><a id="l354"></a><a href="#l354">354</a><td>  return !!this.get(key);<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> * Sets the logging preferences. Preferences may be specified as a<tr><td><a id="l360"></a><a href="#l360">360</a><td> * {@link webdriver.logging.Preferences} instance, or a as a map of log-type to<tr><td><a id="l361"></a><a href="#l361">361</a><td> * log-level.<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @param {!(webdriver.logging.Preferences|Object.&lt;string, string&gt;)} prefs The<tr><td><a id="l363"></a><a href="#l363">363</a><td> *     logging preferences.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a id="l365"></a><a href="#l365">365</a><td> */<tr><td><a id="l366"></a><a href="#l366">366</a><td>webdriver.Capabilities.prototype.setLoggingPrefs = function(prefs) {<tr><td><a id="l367"></a><a href="#l367">367</a><td>  return this.set(webdriver.Capability.LOGGING_PREFS, prefs);<tr><td><a id="l368"></a><a href="#l368">368</a><td>};<tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td>/**<tr><td><a id="l372"></a><a href="#l372">372</a><td> * Sets the proxy configuration for this instance.<tr><td><a id="l373"></a><a href="#l373">373</a><td> * @param {webdriver.ProxyConfig} proxy The desired proxy configuration.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a id="l375"></a><a href="#l375">375</a><td> */<tr><td><a id="l376"></a><a href="#l376">376</a><td>webdriver.Capabilities.prototype.setProxy = function(proxy) {<tr><td><a id="l377"></a><a href="#l377">377</a><td>  return this.set(webdriver.Capability.PROXY, proxy);<tr><td><a id="l378"></a><a href="#l378">378</a><td>};<tr><td><a id="l379"></a><a href="#l379">379</a><td><tr><td><a id="l380"></a><a href="#l380">380</a><td><tr><td><a id="l381"></a><a href="#l381">381</a><td>/**<tr><td><a id="l382"></a><a href="#l382">382</a><td> * Sets whether native events should be used.<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @param {boolean} enabled Whether to enable native events.<tr><td><a id="l384"></a><a href="#l384">384</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a id="l385"></a><a href="#l385">385</a><td> */<tr><td><a id="l386"></a><a href="#l386">386</a><td>webdriver.Capabilities.prototype.setEnableNativeEvents = function(enabled) {<tr><td><a id="l387"></a><a href="#l387">387</a><td>  return this.set(webdriver.Capability.NATIVE_EVENTS, enabled);<tr><td><a id="l388"></a><a href="#l388">388</a><td>};<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> * Sets how elements should be scrolled into view for interaction.<tr><td><a id="l393"></a><a href="#l393">393</a><td> * @param {number} behavior The desired scroll behavior: either 0 to align with<tr><td><a id="l394"></a><a href="#l394">394</a><td> *     the top of the viewport or 1 to align with the bottom.<tr><td><a id="l395"></a><a href="#l395">395</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a id="l396"></a><a href="#l396">396</a><td> */<tr><td><a id="l397"></a><a href="#l397">397</a><td>webdriver.Capabilities.prototype.setScrollBehavior = function(behavior) {<tr><td><a id="l398"></a><a href="#l398">398</a><td>  return this.set(webdriver.Capability.ELEMENT_SCROLL_BEHAVIOR, behavior);<tr><td><a id="l399"></a><a href="#l399">399</a><td>};<tr><td><a id="l400"></a><a href="#l400">400</a><td><tr><td><a id="l401"></a><a href="#l401">401</a><td><tr><td><a id="l402"></a><a href="#l402">402</a><td>/**<tr><td><a id="l403"></a><a href="#l403">403</a><td> * Sets the default action to take with an unexpected alert before returning<tr><td><a id="l404"></a><a href="#l404">404</a><td> * an error.<tr><td><a id="l405"></a><a href="#l405">405</a><td> * @param {string} behavior The desired behavior; should be &quot;accept&quot;, &quot;dismiss&quot;,<tr><td><a id="l406"></a><a href="#l406">406</a><td> *     or &quot;ignore&quot;. Defaults to &quot;dismiss&quot;.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @return {!webdriver.Capabilities} A self reference.<tr><td><a id="l408"></a><a href="#l408">408</a><td> */<tr><td><a id="l409"></a><a href="#l409">409</a><td>webdriver.Capabilities.prototype.setAlertBehavior = function(behavior) {<tr><td><a id="l410"></a><a href="#l410">410</a><td>  return this.set(webdriver.Capability.UNEXPECTED_ALERT_BEHAVIOR, behavior);<tr><td><a id="l411"></a><a href="#l411">411</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/command.js.src.html b/docs/source/lib/webdriver/command.js.src.html
index 903630f..6eeaf6e 100644
--- a/docs/source/lib/webdriver/command.js.src.html
+++ b/docs/source/lib/webdriver/command.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>command.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/command.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Contains several classes for handling commands.<tr><td><a name="l17" href="#l17">17</a><td> */<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.provide(&#39;webdriver.Command&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;webdriver.CommandExecutor&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;webdriver.CommandName&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * Describes a command to be executed by the WebDriverJS framework.<tr><td><a name="l27" href="#l27">27</a><td> * @param {!webdriver.CommandName} name The name of this command.<tr><td><a name="l28" href="#l28">28</a><td> * @constructor<tr><td><a name="l29" href="#l29">29</a><td> */<tr><td><a name="l30" href="#l30">30</a><td>webdriver.Command = function(name) {<tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td>  /**<tr><td><a name="l33" href="#l33">33</a><td>   * The name of this command.<tr><td><a name="l34" href="#l34">34</a><td>   * @private {!webdriver.CommandName}<tr><td><a name="l35" href="#l35">35</a><td>   */<tr><td><a name="l36" href="#l36">36</a><td>  this.name_ = name;<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td>  /**<tr><td><a name="l39" href="#l39">39</a><td>   * The parameters to this command.<tr><td><a name="l40" href="#l40">40</a><td>   * @private {!Object.&lt;*&gt;}<tr><td><a name="l41" href="#l41">41</a><td>   */<tr><td><a name="l42" href="#l42">42</a><td>  this.parameters_ = {};<tr><td><a name="l43" href="#l43">43</a><td>};<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td>/**<tr><td><a name="l47" href="#l47">47</a><td> * @return {!webdriver.CommandName} This command&#39;s name.<tr><td><a name="l48" href="#l48">48</a><td> */<tr><td><a name="l49" href="#l49">49</a><td>webdriver.Command.prototype.getName = function() {<tr><td><a name="l50" href="#l50">50</a><td>  return this.name_;<tr><td><a name="l51" href="#l51">51</a><td>};<tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td><tr><td><a name="l54" href="#l54">54</a><td>/**<tr><td><a name="l55" href="#l55">55</a><td> * Sets a parameter to send with this command.<tr><td><a name="l56" href="#l56">56</a><td> * @param {string} name The parameter name.<tr><td><a name="l57" href="#l57">57</a><td> * @param {*} value The parameter value.<tr><td><a name="l58" href="#l58">58</a><td> * @return {!webdriver.Command} A self reference.<tr><td><a name="l59" href="#l59">59</a><td> */<tr><td><a name="l60" href="#l60">60</a><td>webdriver.Command.prototype.setParameter = function(name, value) {<tr><td><a name="l61" href="#l61">61</a><td>  this.parameters_[name] = value;<tr><td><a name="l62" href="#l62">62</a><td>  return this;<tr><td><a name="l63" href="#l63">63</a><td>};<tr><td><a name="l64" href="#l64">64</a><td><tr><td><a name="l65" href="#l65">65</a><td><tr><td><a name="l66" href="#l66">66</a><td>/**<tr><td><a name="l67" href="#l67">67</a><td> * Sets the parameters for this command.<tr><td><a name="l68" href="#l68">68</a><td> * @param {!Object.&lt;*&gt;} parameters The command parameters.<tr><td><a name="l69" href="#l69">69</a><td> * @return {!webdriver.Command} A self reference.<tr><td><a name="l70" href="#l70">70</a><td> */<tr><td><a name="l71" href="#l71">71</a><td>webdriver.Command.prototype.setParameters = function(parameters) {<tr><td><a name="l72" href="#l72">72</a><td>  this.parameters_ = parameters;<tr><td><a name="l73" href="#l73">73</a><td>  return this;<tr><td><a name="l74" href="#l74">74</a><td>};<tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td>/**<tr><td><a name="l78" href="#l78">78</a><td> * Returns a named command parameter.<tr><td><a name="l79" href="#l79">79</a><td> * @param {string} key The parameter key to look up.<tr><td><a name="l80" href="#l80">80</a><td> * @return {*} The parameter value, or undefined if it has not been set.<tr><td><a name="l81" href="#l81">81</a><td> */<tr><td><a name="l82" href="#l82">82</a><td>webdriver.Command.prototype.getParameter = function(key) {<tr><td><a name="l83" href="#l83">83</a><td>  return this.parameters_[key];<tr><td><a name="l84" href="#l84">84</a><td>};<tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td><tr><td><a name="l87" href="#l87">87</a><td>/**<tr><td><a name="l88" href="#l88">88</a><td> * @return {!Object.&lt;*&gt;} The parameters to send with this command.<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.Command.prototype.getParameters = function() {<tr><td><a name="l91" href="#l91">91</a><td>  return this.parameters_;<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/**<tr><td><a name="l96" href="#l96">96</a><td> * Enumeration of predefined names command names that all command processors<tr><td><a name="l97" href="#l97">97</a><td> * will support.<tr><td><a name="l98" href="#l98">98</a><td> * @enum {string}<tr><td><a name="l99" href="#l99">99</a><td> */<tr><td><a name="l100" href="#l100">100</a><td>// TODO: Delete obsolete command names.<tr><td><a name="l101" href="#l101">101</a><td>webdriver.CommandName = {<tr><td><a name="l102" href="#l102">102</a><td>  GET_SERVER_STATUS: &#39;getStatus&#39;,<tr><td><a name="l103" href="#l103">103</a><td><tr><td><a name="l104" href="#l104">104</a><td>  NEW_SESSION: &#39;newSession&#39;,<tr><td><a name="l105" href="#l105">105</a><td>  GET_SESSIONS: &#39;getSessions&#39;,<tr><td><a name="l106" href="#l106">106</a><td>  DESCRIBE_SESSION: &#39;getSessionCapabilities&#39;,<tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td>  CLOSE: &#39;close&#39;,<tr><td><a name="l109" href="#l109">109</a><td>  QUIT: &#39;quit&#39;,<tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td>  GET_CURRENT_URL: &#39;getCurrentUrl&#39;,<tr><td><a name="l112" href="#l112">112</a><td>  GET: &#39;get&#39;,<tr><td><a name="l113" href="#l113">113</a><td>  GO_BACK: &#39;goBack&#39;,<tr><td><a name="l114" href="#l114">114</a><td>  GO_FORWARD: &#39;goForward&#39;,<tr><td><a name="l115" href="#l115">115</a><td>  REFRESH: &#39;refresh&#39;,<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td>  ADD_COOKIE: &#39;addCookie&#39;,<tr><td><a name="l118" href="#l118">118</a><td>  GET_COOKIE: &#39;getCookie&#39;,<tr><td><a name="l119" href="#l119">119</a><td>  GET_ALL_COOKIES: &#39;getCookies&#39;,<tr><td><a name="l120" href="#l120">120</a><td>  DELETE_COOKIE: &#39;deleteCookie&#39;,<tr><td><a name="l121" href="#l121">121</a><td>  DELETE_ALL_COOKIES: &#39;deleteAllCookies&#39;,<tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td>  GET_ACTIVE_ELEMENT: &#39;getActiveElement&#39;,<tr><td><a name="l124" href="#l124">124</a><td>  FIND_ELEMENT: &#39;findElement&#39;,<tr><td><a name="l125" href="#l125">125</a><td>  FIND_ELEMENTS: &#39;findElements&#39;,<tr><td><a name="l126" href="#l126">126</a><td>  FIND_CHILD_ELEMENT: &#39;findChildElement&#39;,<tr><td><a name="l127" href="#l127">127</a><td>  FIND_CHILD_ELEMENTS: &#39;findChildElements&#39;,<tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td>  CLEAR_ELEMENT: &#39;clearElement&#39;,<tr><td><a name="l130" href="#l130">130</a><td>  CLICK_ELEMENT: &#39;clickElement&#39;,<tr><td><a name="l131" href="#l131">131</a><td>  SEND_KEYS_TO_ELEMENT: &#39;sendKeysToElement&#39;,<tr><td><a name="l132" href="#l132">132</a><td>  SUBMIT_ELEMENT: &#39;submitElement&#39;,<tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td>  GET_CURRENT_WINDOW_HANDLE: &#39;getCurrentWindowHandle&#39;,<tr><td><a name="l135" href="#l135">135</a><td>  GET_WINDOW_HANDLES: &#39;getWindowHandles&#39;,<tr><td><a name="l136" href="#l136">136</a><td>  GET_WINDOW_POSITION: &#39;getWindowPosition&#39;,<tr><td><a name="l137" href="#l137">137</a><td>  SET_WINDOW_POSITION: &#39;setWindowPosition&#39;,<tr><td><a name="l138" href="#l138">138</a><td>  GET_WINDOW_SIZE: &#39;getWindowSize&#39;,<tr><td><a name="l139" href="#l139">139</a><td>  SET_WINDOW_SIZE: &#39;setWindowSize&#39;,<tr><td><a name="l140" href="#l140">140</a><td>  MAXIMIZE_WINDOW: &#39;maximizeWindow&#39;,<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td>  SWITCH_TO_WINDOW: &#39;switchToWindow&#39;,<tr><td><a name="l143" href="#l143">143</a><td>  SWITCH_TO_FRAME: &#39;switchToFrame&#39;,<tr><td><a name="l144" href="#l144">144</a><td>  GET_PAGE_SOURCE: &#39;getPageSource&#39;,<tr><td><a name="l145" href="#l145">145</a><td>  GET_TITLE: &#39;getTitle&#39;,<tr><td><a name="l146" href="#l146">146</a><td><tr><td><a name="l147" href="#l147">147</a><td>  EXECUTE_SCRIPT: &#39;executeScript&#39;,<tr><td><a name="l148" href="#l148">148</a><td>  EXECUTE_ASYNC_SCRIPT: &#39;executeAsyncScript&#39;,<tr><td><a name="l149" href="#l149">149</a><td><tr><td><a name="l150" href="#l150">150</a><td>  GET_ELEMENT_TEXT: &#39;getElementText&#39;,<tr><td><a name="l151" href="#l151">151</a><td>  GET_ELEMENT_TAG_NAME: &#39;getElementTagName&#39;,<tr><td><a name="l152" href="#l152">152</a><td>  IS_ELEMENT_SELECTED: &#39;isElementSelected&#39;,<tr><td><a name="l153" href="#l153">153</a><td>  IS_ELEMENT_ENABLED: &#39;isElementEnabled&#39;,<tr><td><a name="l154" href="#l154">154</a><td>  IS_ELEMENT_DISPLAYED: &#39;isElementDisplayed&#39;,<tr><td><a name="l155" href="#l155">155</a><td>  GET_ELEMENT_LOCATION: &#39;getElementLocation&#39;,<tr><td><a name="l156" href="#l156">156</a><td>  GET_ELEMENT_LOCATION_IN_VIEW: &#39;getElementLocationOnceScrolledIntoView&#39;,<tr><td><a name="l157" href="#l157">157</a><td>  GET_ELEMENT_SIZE: &#39;getElementSize&#39;,<tr><td><a name="l158" href="#l158">158</a><td>  GET_ELEMENT_ATTRIBUTE: &#39;getElementAttribute&#39;,<tr><td><a name="l159" href="#l159">159</a><td>  GET_ELEMENT_VALUE_OF_CSS_PROPERTY: &#39;getElementValueOfCssProperty&#39;,<tr><td><a name="l160" href="#l160">160</a><td>  ELEMENT_EQUALS: &#39;elementEquals&#39;,<tr><td><a name="l161" href="#l161">161</a><td><tr><td><a name="l162" href="#l162">162</a><td>  SCREENSHOT: &#39;screenshot&#39;,<tr><td><a name="l163" href="#l163">163</a><td>  IMPLICITLY_WAIT: &#39;implicitlyWait&#39;,<tr><td><a name="l164" href="#l164">164</a><td>  SET_SCRIPT_TIMEOUT: &#39;setScriptTimeout&#39;,<tr><td><a name="l165" href="#l165">165</a><td>  SET_TIMEOUT: &#39;setTimeout&#39;,<tr><td><a name="l166" href="#l166">166</a><td><tr><td><a name="l167" href="#l167">167</a><td>  ACCEPT_ALERT: &#39;acceptAlert&#39;,<tr><td><a name="l168" href="#l168">168</a><td>  DISMISS_ALERT: &#39;dismissAlert&#39;,<tr><td><a name="l169" href="#l169">169</a><td>  GET_ALERT_TEXT: &#39;getAlertText&#39;,<tr><td><a name="l170" href="#l170">170</a><td>  SET_ALERT_TEXT: &#39;setAlertValue&#39;,<tr><td><a name="l171" href="#l171">171</a><td><tr><td><a name="l172" href="#l172">172</a><td>  EXECUTE_SQL: &#39;executeSQL&#39;,<tr><td><a name="l173" href="#l173">173</a><td>  GET_LOCATION: &#39;getLocation&#39;,<tr><td><a name="l174" href="#l174">174</a><td>  SET_LOCATION: &#39;setLocation&#39;,<tr><td><a name="l175" href="#l175">175</a><td>  GET_APP_CACHE: &#39;getAppCache&#39;,<tr><td><a name="l176" href="#l176">176</a><td>  GET_APP_CACHE_STATUS: &#39;getStatus&#39;,<tr><td><a name="l177" href="#l177">177</a><td>  CLEAR_APP_CACHE: &#39;clearAppCache&#39;,<tr><td><a name="l178" href="#l178">178</a><td>  IS_BROWSER_ONLINE: &#39;isBrowserOnline&#39;,<tr><td><a name="l179" href="#l179">179</a><td>  SET_BROWSER_ONLINE: &#39;setBrowserOnline&#39;,<tr><td><a name="l180" href="#l180">180</a><td><tr><td><a name="l181" href="#l181">181</a><td>  GET_LOCAL_STORAGE_ITEM: &#39;getLocalStorageItem&#39;,<tr><td><a name="l182" href="#l182">182</a><td>  GET_LOCAL_STORAGE_KEYS: &#39;getLocalStorageKeys&#39;,<tr><td><a name="l183" href="#l183">183</a><td>  SET_LOCAL_STORAGE_ITEM: &#39;setLocalStorageItem&#39;,<tr><td><a name="l184" href="#l184">184</a><td>  REMOVE_LOCAL_STORAGE_ITEM: &#39;removeLocalStorageItem&#39;,<tr><td><a name="l185" href="#l185">185</a><td>  CLEAR_LOCAL_STORAGE: &#39;clearLocalStorage&#39;,<tr><td><a name="l186" href="#l186">186</a><td>  GET_LOCAL_STORAGE_SIZE: &#39;getLocalStorageSize&#39;,<tr><td><a name="l187" href="#l187">187</a><td><tr><td><a name="l188" href="#l188">188</a><td>  GET_SESSION_STORAGE_ITEM: &#39;getSessionStorageItem&#39;,<tr><td><a name="l189" href="#l189">189</a><td>  GET_SESSION_STORAGE_KEYS: &#39;getSessionStorageKey&#39;,<tr><td><a name="l190" href="#l190">190</a><td>  SET_SESSION_STORAGE_ITEM: &#39;setSessionStorageItem&#39;,<tr><td><a name="l191" href="#l191">191</a><td>  REMOVE_SESSION_STORAGE_ITEM: &#39;removeSessionStorageItem&#39;,<tr><td><a name="l192" href="#l192">192</a><td>  CLEAR_SESSION_STORAGE: &#39;clearSessionStorage&#39;,<tr><td><a name="l193" href="#l193">193</a><td>  GET_SESSION_STORAGE_SIZE: &#39;getSessionStorageSize&#39;,<tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td>  SET_SCREEN_ORIENTATION: &#39;setScreenOrientation&#39;,<tr><td><a name="l196" href="#l196">196</a><td>  GET_SCREEN_ORIENTATION: &#39;getScreenOrientation&#39;,<tr><td><a name="l197" href="#l197">197</a><td><tr><td><a name="l198" href="#l198">198</a><td>  // These belong to the Advanced user interactions - an element is<tr><td><a name="l199" href="#l199">199</a><td>  // optional for these commands.<tr><td><a name="l200" href="#l200">200</a><td>  CLICK: &#39;mouseClick&#39;,<tr><td><a name="l201" href="#l201">201</a><td>  DOUBLE_CLICK: &#39;mouseDoubleClick&#39;,<tr><td><a name="l202" href="#l202">202</a><td>  MOUSE_DOWN: &#39;mouseDown&#39;,<tr><td><a name="l203" href="#l203">203</a><td>  MOUSE_UP: &#39;mouseUp&#39;,<tr><td><a name="l204" href="#l204">204</a><td>  MOVE_TO: &#39;mouseMove&#39;,<tr><td><a name="l205" href="#l205">205</a><td>  SEND_KEYS_TO_ACTIVE_ELEMENT: &#39;sendKeysToActiveElement&#39;,<tr><td><a name="l206" href="#l206">206</a><td><tr><td><a name="l207" href="#l207">207</a><td>  // These belong to the Advanced Touch API<tr><td><a name="l208" href="#l208">208</a><td>  TOUCH_SINGLE_TAP: &#39;touchSingleTap&#39;,<tr><td><a name="l209" href="#l209">209</a><td>  TOUCH_DOWN: &#39;touchDown&#39;,<tr><td><a name="l210" href="#l210">210</a><td>  TOUCH_UP: &#39;touchUp&#39;,<tr><td><a name="l211" href="#l211">211</a><td>  TOUCH_MOVE: &#39;touchMove&#39;,<tr><td><a name="l212" href="#l212">212</a><td>  TOUCH_SCROLL: &#39;touchScroll&#39;,<tr><td><a name="l213" href="#l213">213</a><td>  TOUCH_DOUBLE_TAP: &#39;touchDoubleTap&#39;,<tr><td><a name="l214" href="#l214">214</a><td>  TOUCH_LONG_PRESS: &#39;touchLongPress&#39;,<tr><td><a name="l215" href="#l215">215</a><td>  TOUCH_FLICK: &#39;touchFlick&#39;,<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td>  GET_AVAILABLE_LOG_TYPES: &#39;getAvailableLogTypes&#39;,<tr><td><a name="l218" href="#l218">218</a><td>  GET_LOG: &#39;getLog&#39;,<tr><td><a name="l219" href="#l219">219</a><td>  GET_SESSION_LOGS: &#39;getSessionLogs&#39;<tr><td><a name="l220" href="#l220">220</a><td>};<tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td><tr><td><a name="l223" href="#l223">223</a><td><tr><td><a name="l224" href="#l224">224</a><td>/**<tr><td><a name="l225" href="#l225">225</a><td> * Handles the execution of {@code webdriver.Command} objects.<tr><td><a name="l226" href="#l226">226</a><td> * @interface<tr><td><a name="l227" href="#l227">227</a><td> */<tr><td><a name="l228" href="#l228">228</a><td>webdriver.CommandExecutor = function() {};<tr><td><a name="l229" href="#l229">229</a><td><tr><td><a name="l230" href="#l230">230</a><td><tr><td><a name="l231" href="#l231">231</a><td>/**<tr><td><a name="l232" href="#l232">232</a><td> * Executes the given {@code command}. If there is an error executing the<tr><td><a name="l233" href="#l233">233</a><td> * command, the provided callback will be invoked with the offending error.<tr><td><a name="l234" href="#l234">234</a><td> * Otherwise, the callback will be invoked with a null Error and non-null<tr><td><a name="l235" href="#l235">235</a><td> * {@link bot.response.ResponseObject} object.<tr><td><a name="l236" href="#l236">236</a><td> * @param {!webdriver.Command} command The command to execute.<tr><td><a name="l237" href="#l237">237</a><td> * @param {function(Error, !bot.response.ResponseObject=)} callback the function<tr><td><a name="l238" href="#l238">238</a><td> *     to invoke when the command response is ready.<tr><td><a name="l239" href="#l239">239</a><td> */<tr><td><a name="l240" href="#l240">240</a><td>webdriver.CommandExecutor.prototype.execute = goog.abstractMethod;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>command.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/webdriver/command.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Contains several classes for handling commands.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;webdriver.Command&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;webdriver.CommandExecutor&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.CommandName&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>/**<tr><td><a id="l29"></a><a href="#l29">29</a><td> * Describes a command to be executed by the WebDriverJS framework.<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @param {!webdriver.CommandName} name The name of this command.<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>webdriver.Command = function(name) {<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>   * The name of this command.<tr><td><a id="l37"></a><a href="#l37">37</a><td>   * @private {!webdriver.CommandName}<tr><td><a id="l38"></a><a href="#l38">38</a><td>   */<tr><td><a id="l39"></a><a href="#l39">39</a><td>  this.name_ = name;<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>   * The parameters to this command.<tr><td><a id="l43"></a><a href="#l43">43</a><td>   * @private {!Object.&lt;*&gt;}<tr><td><a id="l44"></a><a href="#l44">44</a><td>   */<tr><td><a id="l45"></a><a href="#l45">45</a><td>  this.parameters_ = {};<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>/**<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @return {!webdriver.CommandName} This command&#39;s name.<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>webdriver.Command.prototype.getName = function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td>  return this.name_;<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>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * Sets a parameter to send with this command.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @param {string} name The parameter name.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {*} value The parameter value.<tr><td><a id="l61"></a><a href="#l61">61</a><td> * @return {!webdriver.Command} A self reference.<tr><td><a id="l62"></a><a href="#l62">62</a><td> */<tr><td><a id="l63"></a><a href="#l63">63</a><td>webdriver.Command.prototype.setParameter = function(name, value) {<tr><td><a id="l64"></a><a href="#l64">64</a><td>  this.parameters_[name] = value;<tr><td><a id="l65"></a><a href="#l65">65</a><td>  return this;<tr><td><a id="l66"></a><a href="#l66">66</a><td>};<tr><td><a id="l67"></a><a href="#l67">67</a><td><tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>/**<tr><td><a id="l70"></a><a href="#l70">70</a><td> * Sets the parameters for this command.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * @param {!Object.&lt;*&gt;} parameters The command parameters.<tr><td><a id="l72"></a><a href="#l72">72</a><td> * @return {!webdriver.Command} A self reference.<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td>webdriver.Command.prototype.setParameters = function(parameters) {<tr><td><a id="l75"></a><a href="#l75">75</a><td>  this.parameters_ = parameters;<tr><td><a id="l76"></a><a href="#l76">76</a><td>  return this;<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>/**<tr><td><a id="l81"></a><a href="#l81">81</a><td> * Returns a named command parameter.<tr><td><a id="l82"></a><a href="#l82">82</a><td> * @param {string} key The parameter key to look up.<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @return {*} The parameter value, or undefined if it has not been set.<tr><td><a id="l84"></a><a href="#l84">84</a><td> */<tr><td><a id="l85"></a><a href="#l85">85</a><td>webdriver.Command.prototype.getParameter = function(key) {<tr><td><a id="l86"></a><a href="#l86">86</a><td>  return this.parameters_[key];<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> * @return {!Object.&lt;*&gt;} The parameters to send with this command.<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>webdriver.Command.prototype.getParameters = function() {<tr><td><a id="l94"></a><a href="#l94">94</a><td>  return this.parameters_;<tr><td><a id="l95"></a><a href="#l95">95</a><td>};<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>/**<tr><td><a id="l99"></a><a href="#l99">99</a><td> * Enumeration of predefined names command names that all command processors<tr><td><a id="l100"></a><a href="#l100">100</a><td> * will support.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @enum {string}<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td>// TODO: Delete obsolete command names.<tr><td><a id="l104"></a><a href="#l104">104</a><td>webdriver.CommandName = {<tr><td><a id="l105"></a><a href="#l105">105</a><td>  GET_SERVER_STATUS: &#39;getStatus&#39;,<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td>  NEW_SESSION: &#39;newSession&#39;,<tr><td><a id="l108"></a><a href="#l108">108</a><td>  GET_SESSIONS: &#39;getSessions&#39;,<tr><td><a id="l109"></a><a href="#l109">109</a><td>  DESCRIBE_SESSION: &#39;getSessionCapabilities&#39;,<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td>  CLOSE: &#39;close&#39;,<tr><td><a id="l112"></a><a href="#l112">112</a><td>  QUIT: &#39;quit&#39;,<tr><td><a id="l113"></a><a href="#l113">113</a><td><tr><td><a id="l114"></a><a href="#l114">114</a><td>  GET_CURRENT_URL: &#39;getCurrentUrl&#39;,<tr><td><a id="l115"></a><a href="#l115">115</a><td>  GET: &#39;get&#39;,<tr><td><a id="l116"></a><a href="#l116">116</a><td>  GO_BACK: &#39;goBack&#39;,<tr><td><a id="l117"></a><a href="#l117">117</a><td>  GO_FORWARD: &#39;goForward&#39;,<tr><td><a id="l118"></a><a href="#l118">118</a><td>  REFRESH: &#39;refresh&#39;,<tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>  ADD_COOKIE: &#39;addCookie&#39;,<tr><td><a id="l121"></a><a href="#l121">121</a><td>  GET_COOKIE: &#39;getCookie&#39;,<tr><td><a id="l122"></a><a href="#l122">122</a><td>  GET_ALL_COOKIES: &#39;getCookies&#39;,<tr><td><a id="l123"></a><a href="#l123">123</a><td>  DELETE_COOKIE: &#39;deleteCookie&#39;,<tr><td><a id="l124"></a><a href="#l124">124</a><td>  DELETE_ALL_COOKIES: &#39;deleteAllCookies&#39;,<tr><td><a id="l125"></a><a href="#l125">125</a><td><tr><td><a id="l126"></a><a href="#l126">126</a><td>  GET_ACTIVE_ELEMENT: &#39;getActiveElement&#39;,<tr><td><a id="l127"></a><a href="#l127">127</a><td>  FIND_ELEMENT: &#39;findElement&#39;,<tr><td><a id="l128"></a><a href="#l128">128</a><td>  FIND_ELEMENTS: &#39;findElements&#39;,<tr><td><a id="l129"></a><a href="#l129">129</a><td>  FIND_CHILD_ELEMENT: &#39;findChildElement&#39;,<tr><td><a id="l130"></a><a href="#l130">130</a><td>  FIND_CHILD_ELEMENTS: &#39;findChildElements&#39;,<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td>  CLEAR_ELEMENT: &#39;clearElement&#39;,<tr><td><a id="l133"></a><a href="#l133">133</a><td>  CLICK_ELEMENT: &#39;clickElement&#39;,<tr><td><a id="l134"></a><a href="#l134">134</a><td>  SEND_KEYS_TO_ELEMENT: &#39;sendKeysToElement&#39;,<tr><td><a id="l135"></a><a href="#l135">135</a><td>  SUBMIT_ELEMENT: &#39;submitElement&#39;,<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>  GET_CURRENT_WINDOW_HANDLE: &#39;getCurrentWindowHandle&#39;,<tr><td><a id="l138"></a><a href="#l138">138</a><td>  GET_WINDOW_HANDLES: &#39;getWindowHandles&#39;,<tr><td><a id="l139"></a><a href="#l139">139</a><td>  GET_WINDOW_POSITION: &#39;getWindowPosition&#39;,<tr><td><a id="l140"></a><a href="#l140">140</a><td>  SET_WINDOW_POSITION: &#39;setWindowPosition&#39;,<tr><td><a id="l141"></a><a href="#l141">141</a><td>  GET_WINDOW_SIZE: &#39;getWindowSize&#39;,<tr><td><a id="l142"></a><a href="#l142">142</a><td>  SET_WINDOW_SIZE: &#39;setWindowSize&#39;,<tr><td><a id="l143"></a><a href="#l143">143</a><td>  MAXIMIZE_WINDOW: &#39;maximizeWindow&#39;,<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td>  SWITCH_TO_WINDOW: &#39;switchToWindow&#39;,<tr><td><a id="l146"></a><a href="#l146">146</a><td>  SWITCH_TO_FRAME: &#39;switchToFrame&#39;,<tr><td><a id="l147"></a><a href="#l147">147</a><td>  GET_PAGE_SOURCE: &#39;getPageSource&#39;,<tr><td><a id="l148"></a><a href="#l148">148</a><td>  GET_TITLE: &#39;getTitle&#39;,<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>  EXECUTE_SCRIPT: &#39;executeScript&#39;,<tr><td><a id="l151"></a><a href="#l151">151</a><td>  EXECUTE_ASYNC_SCRIPT: &#39;executeAsyncScript&#39;,<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td>  GET_ELEMENT_TEXT: &#39;getElementText&#39;,<tr><td><a id="l154"></a><a href="#l154">154</a><td>  GET_ELEMENT_TAG_NAME: &#39;getElementTagName&#39;,<tr><td><a id="l155"></a><a href="#l155">155</a><td>  IS_ELEMENT_SELECTED: &#39;isElementSelected&#39;,<tr><td><a id="l156"></a><a href="#l156">156</a><td>  IS_ELEMENT_ENABLED: &#39;isElementEnabled&#39;,<tr><td><a id="l157"></a><a href="#l157">157</a><td>  IS_ELEMENT_DISPLAYED: &#39;isElementDisplayed&#39;,<tr><td><a id="l158"></a><a href="#l158">158</a><td>  GET_ELEMENT_LOCATION: &#39;getElementLocation&#39;,<tr><td><a id="l159"></a><a href="#l159">159</a><td>  GET_ELEMENT_LOCATION_IN_VIEW: &#39;getElementLocationOnceScrolledIntoView&#39;,<tr><td><a id="l160"></a><a href="#l160">160</a><td>  GET_ELEMENT_SIZE: &#39;getElementSize&#39;,<tr><td><a id="l161"></a><a href="#l161">161</a><td>  GET_ELEMENT_ATTRIBUTE: &#39;getElementAttribute&#39;,<tr><td><a id="l162"></a><a href="#l162">162</a><td>  GET_ELEMENT_VALUE_OF_CSS_PROPERTY: &#39;getElementValueOfCssProperty&#39;,<tr><td><a id="l163"></a><a href="#l163">163</a><td>  ELEMENT_EQUALS: &#39;elementEquals&#39;,<tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td>  SCREENSHOT: &#39;screenshot&#39;,<tr><td><a id="l166"></a><a href="#l166">166</a><td>  IMPLICITLY_WAIT: &#39;implicitlyWait&#39;,<tr><td><a id="l167"></a><a href="#l167">167</a><td>  SET_SCRIPT_TIMEOUT: &#39;setScriptTimeout&#39;,<tr><td><a id="l168"></a><a href="#l168">168</a><td>  SET_TIMEOUT: &#39;setTimeout&#39;,<tr><td><a id="l169"></a><a href="#l169">169</a><td><tr><td><a id="l170"></a><a href="#l170">170</a><td>  ACCEPT_ALERT: &#39;acceptAlert&#39;,<tr><td><a id="l171"></a><a href="#l171">171</a><td>  DISMISS_ALERT: &#39;dismissAlert&#39;,<tr><td><a id="l172"></a><a href="#l172">172</a><td>  GET_ALERT_TEXT: &#39;getAlertText&#39;,<tr><td><a id="l173"></a><a href="#l173">173</a><td>  SET_ALERT_TEXT: &#39;setAlertValue&#39;,<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td>  EXECUTE_SQL: &#39;executeSQL&#39;,<tr><td><a id="l176"></a><a href="#l176">176</a><td>  GET_LOCATION: &#39;getLocation&#39;,<tr><td><a id="l177"></a><a href="#l177">177</a><td>  SET_LOCATION: &#39;setLocation&#39;,<tr><td><a id="l178"></a><a href="#l178">178</a><td>  GET_APP_CACHE: &#39;getAppCache&#39;,<tr><td><a id="l179"></a><a href="#l179">179</a><td>  GET_APP_CACHE_STATUS: &#39;getStatus&#39;,<tr><td><a id="l180"></a><a href="#l180">180</a><td>  CLEAR_APP_CACHE: &#39;clearAppCache&#39;,<tr><td><a id="l181"></a><a href="#l181">181</a><td>  IS_BROWSER_ONLINE: &#39;isBrowserOnline&#39;,<tr><td><a id="l182"></a><a href="#l182">182</a><td>  SET_BROWSER_ONLINE: &#39;setBrowserOnline&#39;,<tr><td><a id="l183"></a><a href="#l183">183</a><td><tr><td><a id="l184"></a><a href="#l184">184</a><td>  GET_LOCAL_STORAGE_ITEM: &#39;getLocalStorageItem&#39;,<tr><td><a id="l185"></a><a href="#l185">185</a><td>  GET_LOCAL_STORAGE_KEYS: &#39;getLocalStorageKeys&#39;,<tr><td><a id="l186"></a><a href="#l186">186</a><td>  SET_LOCAL_STORAGE_ITEM: &#39;setLocalStorageItem&#39;,<tr><td><a id="l187"></a><a href="#l187">187</a><td>  REMOVE_LOCAL_STORAGE_ITEM: &#39;removeLocalStorageItem&#39;,<tr><td><a id="l188"></a><a href="#l188">188</a><td>  CLEAR_LOCAL_STORAGE: &#39;clearLocalStorage&#39;,<tr><td><a id="l189"></a><a href="#l189">189</a><td>  GET_LOCAL_STORAGE_SIZE: &#39;getLocalStorageSize&#39;,<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td>  GET_SESSION_STORAGE_ITEM: &#39;getSessionStorageItem&#39;,<tr><td><a id="l192"></a><a href="#l192">192</a><td>  GET_SESSION_STORAGE_KEYS: &#39;getSessionStorageKey&#39;,<tr><td><a id="l193"></a><a href="#l193">193</a><td>  SET_SESSION_STORAGE_ITEM: &#39;setSessionStorageItem&#39;,<tr><td><a id="l194"></a><a href="#l194">194</a><td>  REMOVE_SESSION_STORAGE_ITEM: &#39;removeSessionStorageItem&#39;,<tr><td><a id="l195"></a><a href="#l195">195</a><td>  CLEAR_SESSION_STORAGE: &#39;clearSessionStorage&#39;,<tr><td><a id="l196"></a><a href="#l196">196</a><td>  GET_SESSION_STORAGE_SIZE: &#39;getSessionStorageSize&#39;,<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>  SET_SCREEN_ORIENTATION: &#39;setScreenOrientation&#39;,<tr><td><a id="l199"></a><a href="#l199">199</a><td>  GET_SCREEN_ORIENTATION: &#39;getScreenOrientation&#39;,<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td>  // These belong to the Advanced user interactions - an element is<tr><td><a id="l202"></a><a href="#l202">202</a><td>  // optional for these commands.<tr><td><a id="l203"></a><a href="#l203">203</a><td>  CLICK: &#39;mouseClick&#39;,<tr><td><a id="l204"></a><a href="#l204">204</a><td>  DOUBLE_CLICK: &#39;mouseDoubleClick&#39;,<tr><td><a id="l205"></a><a href="#l205">205</a><td>  MOUSE_DOWN: &#39;mouseButtonDown&#39;,<tr><td><a id="l206"></a><a href="#l206">206</a><td>  MOUSE_UP: &#39;mouseButtonUp&#39;,<tr><td><a id="l207"></a><a href="#l207">207</a><td>  MOVE_TO: &#39;mouseMoveTo&#39;,<tr><td><a id="l208"></a><a href="#l208">208</a><td>  SEND_KEYS_TO_ACTIVE_ELEMENT: &#39;sendKeysToActiveElement&#39;,<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td>  // These belong to the Advanced Touch API<tr><td><a id="l211"></a><a href="#l211">211</a><td>  TOUCH_SINGLE_TAP: &#39;touchSingleTap&#39;,<tr><td><a id="l212"></a><a href="#l212">212</a><td>  TOUCH_DOWN: &#39;touchDown&#39;,<tr><td><a id="l213"></a><a href="#l213">213</a><td>  TOUCH_UP: &#39;touchUp&#39;,<tr><td><a id="l214"></a><a href="#l214">214</a><td>  TOUCH_MOVE: &#39;touchMove&#39;,<tr><td><a id="l215"></a><a href="#l215">215</a><td>  TOUCH_SCROLL: &#39;touchScroll&#39;,<tr><td><a id="l216"></a><a href="#l216">216</a><td>  TOUCH_DOUBLE_TAP: &#39;touchDoubleTap&#39;,<tr><td><a id="l217"></a><a href="#l217">217</a><td>  TOUCH_LONG_PRESS: &#39;touchLongPress&#39;,<tr><td><a id="l218"></a><a href="#l218">218</a><td>  TOUCH_FLICK: &#39;touchFlick&#39;,<tr><td><a id="l219"></a><a href="#l219">219</a><td><tr><td><a id="l220"></a><a href="#l220">220</a><td>  GET_AVAILABLE_LOG_TYPES: &#39;getAvailableLogTypes&#39;,<tr><td><a id="l221"></a><a href="#l221">221</a><td>  GET_LOG: &#39;getLog&#39;,<tr><td><a id="l222"></a><a href="#l222">222</a><td>  GET_SESSION_LOGS: &#39;getSessionLogs&#39;,<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td>  // Non-standard commands used by the standalone Selenium server.<tr><td><a id="l225"></a><a href="#l225">225</a><td>  UPLOAD_FILE: &#39;uploadFile&#39;<tr><td><a id="l226"></a><a href="#l226">226</a><td>};<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>/**<tr><td><a id="l231"></a><a href="#l231">231</a><td> * Handles the execution of WebDriver {@link webdriver.Command commands}.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @interface<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>webdriver.CommandExecutor = function() {};<tr><td><a id="l235"></a><a href="#l235">235</a><td><tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td>/**<tr><td><a id="l238"></a><a href="#l238">238</a><td> * Executes the given {@code command}. If there is an error executing the<tr><td><a id="l239"></a><a href="#l239">239</a><td> * command, the provided callback will be invoked with the offending error.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * Otherwise, the callback will be invoked with a null Error and non-null<tr><td><a id="l241"></a><a href="#l241">241</a><td> * {@link bot.response.ResponseObject} object.<tr><td><a id="l242"></a><a href="#l242">242</a><td> * @param {!webdriver.Command} command The command to execute.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {function(Error, !bot.response.ResponseObject=)} callback the function<tr><td><a id="l244"></a><a href="#l244">244</a><td> *     to invoke when the command response is ready.<tr><td><a id="l245"></a><a href="#l245">245</a><td> */<tr><td><a id="l246"></a><a href="#l246">246</a><td>webdriver.CommandExecutor.prototype.execute = 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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/events.js.src.html b/docs/source/lib/webdriver/events.js.src.html
index c60d9c5..8d50f5d 100644
--- a/docs/source/lib/webdriver/events.js.src.html
+++ b/docs/source/lib/webdriver/events.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>events.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/events.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview A light weight event system modeled after Node&#39;s EventEmitter.<tr><td><a name="l17" href="#l17">17</a><td> */<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.provide(&#39;webdriver.EventEmitter&#39;);<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>/**<tr><td><a name="l24" href="#l24">24</a><td> * Object that can emit events for others to listen for. This is used instead<tr><td><a name="l25" href="#l25">25</a><td> * of Closure&#39;s event system because it is much more light weight. The API is<tr><td><a name="l26" href="#l26">26</a><td> * based on Node&#39;s EventEmitters.<tr><td><a name="l27" href="#l27">27</a><td> * @constructor<tr><td><a name="l28" href="#l28">28</a><td> */<tr><td><a name="l29" href="#l29">29</a><td>webdriver.EventEmitter = function() {<tr><td><a name="l30" href="#l30">30</a><td>  /**<tr><td><a name="l31" href="#l31">31</a><td>   * Map of events to registered listeners.<tr><td><a name="l32" href="#l32">32</a><td>   * @private {!Object.&lt;!Array.&lt;{fn: !Function, oneshot: boolean,<tr><td><a name="l33" href="#l33">33</a><td>   *                             scope: (Object|undefined)}&gt;&gt;}<tr><td><a name="l34" href="#l34">34</a><td>   */<tr><td><a name="l35" href="#l35">35</a><td>  this.events_ = {};<tr><td><a name="l36" href="#l36">36</a><td>};<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>/**<tr><td><a name="l40" href="#l40">40</a><td> * Fires an event and calls all listeners.<tr><td><a name="l41" href="#l41">41</a><td> * @param {string} type The type of event to emit.<tr><td><a name="l42" href="#l42">42</a><td> * @param {...*} var_args Any arguments to pass to each listener.<tr><td><a name="l43" href="#l43">43</a><td> */<tr><td><a name="l44" href="#l44">44</a><td>webdriver.EventEmitter.prototype.emit = function(type, var_args) {<tr><td><a name="l45" href="#l45">45</a><td>  var args = Array.prototype.slice.call(arguments, 1);<tr><td><a name="l46" href="#l46">46</a><td>  var listeners = this.events_[type];<tr><td><a name="l47" href="#l47">47</a><td>  if (!listeners) {<tr><td><a name="l48" href="#l48">48</a><td>    return;<tr><td><a name="l49" href="#l49">49</a><td>  }<tr><td><a name="l50" href="#l50">50</a><td>  for (var i = 0; i &lt; listeners.length;) {<tr><td><a name="l51" href="#l51">51</a><td>    var listener = listeners[i];<tr><td><a name="l52" href="#l52">52</a><td>    listener.fn.apply(listener.scope, args);<tr><td><a name="l53" href="#l53">53</a><td>    if (listeners[i] === listener) {<tr><td><a name="l54" href="#l54">54</a><td>      if (listeners[i].oneshot) {<tr><td><a name="l55" href="#l55">55</a><td>        listeners.splice(i, 1);<tr><td><a name="l56" href="#l56">56</a><td>      } else {<tr><td><a name="l57" href="#l57">57</a><td>        i += 1;<tr><td><a name="l58" href="#l58">58</a><td>      }<tr><td><a name="l59" href="#l59">59</a><td>    }<tr><td><a name="l60" href="#l60">60</a><td>  }<tr><td><a name="l61" href="#l61">61</a><td>};<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/**<tr><td><a name="l65" href="#l65">65</a><td> * Returns a mutable list of listeners for a specific type of event.<tr><td><a name="l66" href="#l66">66</a><td> * @param {string} type The type of event to retrieve the listeners for.<tr><td><a name="l67" href="#l67">67</a><td> * @return {!Array.&lt;{fn: !Function, oneshot: boolean,<tr><td><a name="l68" href="#l68">68</a><td> *                   scope: (Object|undefined)}&gt;} The registered listeners for<tr><td><a name="l69" href="#l69">69</a><td> *     the given event type.<tr><td><a name="l70" href="#l70">70</a><td> */<tr><td><a name="l71" href="#l71">71</a><td>webdriver.EventEmitter.prototype.listeners = function(type) {<tr><td><a name="l72" href="#l72">72</a><td>  var listeners = this.events_[type];<tr><td><a name="l73" href="#l73">73</a><td>  if (!listeners) {<tr><td><a name="l74" href="#l74">74</a><td>    listeners = this.events_[type] = [];<tr><td><a name="l75" href="#l75">75</a><td>  }<tr><td><a name="l76" href="#l76">76</a><td>  return listeners;<tr><td><a name="l77" href="#l77">77</a><td>};<tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td><tr><td><a name="l80" href="#l80">80</a><td>/**<tr><td><a name="l81" href="#l81">81</a><td> * Registers a listener.<tr><td><a name="l82" href="#l82">82</a><td> * @param {string} type The type of event to listen for.<tr><td><a name="l83" href="#l83">83</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a name="l84" href="#l84">84</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a name="l85" href="#l85">85</a><td> * @param {boolean=} opt_oneshot Whether the listener should be removed after<tr><td><a name="l86" href="#l86">86</a><td> *    the first event is fired.<tr><td><a name="l87" href="#l87">87</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a name="l88" href="#l88">88</a><td> * @private<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.EventEmitter.prototype.addListener_ = function(type, listenerFn,<tr><td><a name="l91" href="#l91">91</a><td>    opt_scope, opt_oneshot) {<tr><td><a name="l92" href="#l92">92</a><td>  var listeners = this.listeners(type);<tr><td><a name="l93" href="#l93">93</a><td>  var n = listeners.length;<tr><td><a name="l94" href="#l94">94</a><td>  for (var i = 0; i &lt; n; ++i) {<tr><td><a name="l95" href="#l95">95</a><td>    if (listeners[i].fn == listenerFn) {<tr><td><a name="l96" href="#l96">96</a><td>      return this;<tr><td><a name="l97" href="#l97">97</a><td>    }<tr><td><a name="l98" href="#l98">98</a><td>  }<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td>  listeners.push({<tr><td><a name="l101" href="#l101">101</a><td>    fn: listenerFn,<tr><td><a name="l102" href="#l102">102</a><td>    scope: opt_scope,<tr><td><a name="l103" href="#l103">103</a><td>    oneshot: !!opt_oneshot<tr><td><a name="l104" href="#l104">104</a><td>  });<tr><td><a name="l105" href="#l105">105</a><td>  return this;<tr><td><a name="l106" href="#l106">106</a><td>};<tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td>/**<tr><td><a name="l110" href="#l110">110</a><td> * Registers a listener.<tr><td><a name="l111" href="#l111">111</a><td> * @param {string} type The type of event to listen for.<tr><td><a name="l112" href="#l112">112</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a name="l113" href="#l113">113</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a name="l114" href="#l114">114</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a name="l115" href="#l115">115</a><td> */<tr><td><a name="l116" href="#l116">116</a><td>webdriver.EventEmitter.prototype.addListener = function(type, listenerFn,<tr><td><a name="l117" href="#l117">117</a><td>    opt_scope) {<tr><td><a name="l118" href="#l118">118</a><td>  return this.addListener_(type, listenerFn, opt_scope);<tr><td><a name="l119" href="#l119">119</a><td>};<tr><td><a name="l120" href="#l120">120</a><td><tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td>/**<tr><td><a name="l123" href="#l123">123</a><td> * Registers a one-time listener which will be called only the first time an<tr><td><a name="l124" href="#l124">124</a><td> * event is emitted, after which it will be removed.<tr><td><a name="l125" href="#l125">125</a><td> * @param {string} type The type of event to listen for.<tr><td><a name="l126" href="#l126">126</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a name="l127" href="#l127">127</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a name="l128" href="#l128">128</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a name="l129" href="#l129">129</a><td> */<tr><td><a name="l130" href="#l130">130</a><td>webdriver.EventEmitter.prototype.once = function(type, listenerFn, opt_scope) {<tr><td><a name="l131" href="#l131">131</a><td>  return this.addListener_(type, listenerFn, opt_scope, true);<tr><td><a name="l132" href="#l132">132</a><td>};<tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td><tr><td><a name="l135" href="#l135">135</a><td>/**<tr><td><a name="l136" href="#l136">136</a><td> * An alias for {@code #addListener()}.<tr><td><a name="l137" href="#l137">137</a><td> * @param {string} type The type of event to listen for.<tr><td><a name="l138" href="#l138">138</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a name="l139" href="#l139">139</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a name="l140" href="#l140">140</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a name="l141" href="#l141">141</a><td> */<tr><td><a name="l142" href="#l142">142</a><td>webdriver.EventEmitter.prototype.on =<tr><td><a name="l143" href="#l143">143</a><td>    webdriver.EventEmitter.prototype.addListener;<tr><td><a name="l144" href="#l144">144</a><td><tr><td><a name="l145" href="#l145">145</a><td><tr><td><a name="l146" href="#l146">146</a><td>/**<tr><td><a name="l147" href="#l147">147</a><td> * Removes a previously registered event listener.<tr><td><a name="l148" href="#l148">148</a><td> * @param {string} type The type of event to unregister.<tr><td><a name="l149" href="#l149">149</a><td> * @param {!Function} listenerFn The handler function to remove.<tr><td><a name="l150" href="#l150">150</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a name="l151" href="#l151">151</a><td> */<tr><td><a name="l152" href="#l152">152</a><td>webdriver.EventEmitter.prototype.removeListener = function(type, listenerFn) {<tr><td><a name="l153" href="#l153">153</a><td>  var listeners = this.events_[type];<tr><td><a name="l154" href="#l154">154</a><td>  if (listeners) {<tr><td><a name="l155" href="#l155">155</a><td>    var n = listeners.length;<tr><td><a name="l156" href="#l156">156</a><td>    for (var i = 0; i &lt; n; ++i) {<tr><td><a name="l157" href="#l157">157</a><td>      if (listeners[i].fn == listenerFn) {<tr><td><a name="l158" href="#l158">158</a><td>        listeners.splice(i, 1);<tr><td><a name="l159" href="#l159">159</a><td>        return this;<tr><td><a name="l160" href="#l160">160</a><td>      }<tr><td><a name="l161" href="#l161">161</a><td>    }<tr><td><a name="l162" href="#l162">162</a><td>  }<tr><td><a name="l163" href="#l163">163</a><td>  return this;<tr><td><a name="l164" href="#l164">164</a><td>};<tr><td><a name="l165" href="#l165">165</a><td><tr><td><a name="l166" href="#l166">166</a><td><tr><td><a name="l167" href="#l167">167</a><td>/**<tr><td><a name="l168" href="#l168">168</a><td> * Removes all listeners for a specific type of event. If no event is<tr><td><a name="l169" href="#l169">169</a><td> * specified, all listeners across all types will be removed.<tr><td><a name="l170" href="#l170">170</a><td> * @param {string=} opt_type The type of event to remove listeners from.<tr><td><a name="l171" href="#l171">171</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a name="l172" href="#l172">172</a><td> */<tr><td><a name="l173" href="#l173">173</a><td>webdriver.EventEmitter.prototype.removeAllListeners = function(opt_type) {<tr><td><a name="l174" href="#l174">174</a><td>  goog.isDef(opt_type) ? delete this.events_[opt_type] : this.events_ = {};<tr><td><a name="l175" href="#l175">175</a><td>  return this;<tr><td><a name="l176" href="#l176">176</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>events.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/webdriver/events.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview A light weight event system modeled after Node&#39;s EventEmitter.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;webdriver.EventEmitter&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Object that can emit events for others to listen for. This is used instead<tr><td><a id="l28"></a><a href="#l28">28</a><td> * of Closure&#39;s event system because it is much more light weight. The API is<tr><td><a id="l29"></a><a href="#l29">29</a><td> * based on Node&#39;s EventEmitters.<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>webdriver.EventEmitter = 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>   * Map of events to registered listeners.<tr><td><a id="l35"></a><a href="#l35">35</a><td>   * @private {!Object.&lt;!Array.&lt;{fn: !Function, oneshot: boolean,<tr><td><a id="l36"></a><a href="#l36">36</a><td>   *                             scope: (Object|undefined)}&gt;&gt;}<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.events_ = {};<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>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * Fires an event and calls all listeners.<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {string} type The type of event to emit.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @param {...*} var_args Any arguments to pass to each listener.<tr><td><a id="l46"></a><a href="#l46">46</a><td> */<tr><td><a id="l47"></a><a href="#l47">47</a><td>webdriver.EventEmitter.prototype.emit = function(type, var_args) {<tr><td><a id="l48"></a><a href="#l48">48</a><td>  var args = Array.prototype.slice.call(arguments, 1);<tr><td><a id="l49"></a><a href="#l49">49</a><td>  var listeners = this.events_[type];<tr><td><a id="l50"></a><a href="#l50">50</a><td>  if (!listeners) {<tr><td><a id="l51"></a><a href="#l51">51</a><td>    return;<tr><td><a id="l52"></a><a href="#l52">52</a><td>  }<tr><td><a id="l53"></a><a href="#l53">53</a><td>  for (var i = 0; i &lt; listeners.length;) {<tr><td><a id="l54"></a><a href="#l54">54</a><td>    var listener = listeners[i];<tr><td><a id="l55"></a><a href="#l55">55</a><td>    listener.fn.apply(listener.scope, args);<tr><td><a id="l56"></a><a href="#l56">56</a><td>    if (listeners[i] === listener) {<tr><td><a id="l57"></a><a href="#l57">57</a><td>      if (listeners[i].oneshot) {<tr><td><a id="l58"></a><a href="#l58">58</a><td>        listeners.splice(i, 1);<tr><td><a id="l59"></a><a href="#l59">59</a><td>      } else {<tr><td><a id="l60"></a><a href="#l60">60</a><td>        i += 1;<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>};<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> * Returns a mutable list of listeners for a specific type of event.<tr><td><a id="l69"></a><a href="#l69">69</a><td> * @param {string} type The type of event to retrieve the listeners for.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @return {!Array.&lt;{fn: !Function, oneshot: boolean,<tr><td><a id="l71"></a><a href="#l71">71</a><td> *                   scope: (Object|undefined)}&gt;} The registered listeners for<tr><td><a id="l72"></a><a href="#l72">72</a><td> *     the given event type.<tr><td><a id="l73"></a><a href="#l73">73</a><td> */<tr><td><a id="l74"></a><a href="#l74">74</a><td>webdriver.EventEmitter.prototype.listeners = function(type) {<tr><td><a id="l75"></a><a href="#l75">75</a><td>  var listeners = this.events_[type];<tr><td><a id="l76"></a><a href="#l76">76</a><td>  if (!listeners) {<tr><td><a id="l77"></a><a href="#l77">77</a><td>    listeners = this.events_[type] = [];<tr><td><a id="l78"></a><a href="#l78">78</a><td>  }<tr><td><a id="l79"></a><a href="#l79">79</a><td>  return listeners;<tr><td><a id="l80"></a><a href="#l80">80</a><td>};<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>/**<tr><td><a id="l84"></a><a href="#l84">84</a><td> * Registers a listener.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @param {string} type The type of event to listen for.<tr><td><a id="l86"></a><a href="#l86">86</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {boolean=} opt_oneshot Whether the listener should be removed after<tr><td><a id="l89"></a><a href="#l89">89</a><td> *    the first event is fired.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * @private<tr><td><a id="l92"></a><a href="#l92">92</a><td> */<tr><td><a id="l93"></a><a href="#l93">93</a><td>webdriver.EventEmitter.prototype.addListener_ = function(type, listenerFn,<tr><td><a id="l94"></a><a href="#l94">94</a><td>    opt_scope, opt_oneshot) {<tr><td><a id="l95"></a><a href="#l95">95</a><td>  var listeners = this.listeners(type);<tr><td><a id="l96"></a><a href="#l96">96</a><td>  var n = listeners.length;<tr><td><a id="l97"></a><a href="#l97">97</a><td>  for (var i = 0; i &lt; n; ++i) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>    if (listeners[i].fn == listenerFn) {<tr><td><a id="l99"></a><a href="#l99">99</a><td>      return this;<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>  listeners.push({<tr><td><a id="l104"></a><a href="#l104">104</a><td>    fn: listenerFn,<tr><td><a id="l105"></a><a href="#l105">105</a><td>    scope: opt_scope,<tr><td><a id="l106"></a><a href="#l106">106</a><td>    oneshot: !!opt_oneshot<tr><td><a id="l107"></a><a href="#l107">107</a><td>  });<tr><td><a id="l108"></a><a href="#l108">108</a><td>  return this;<tr><td><a id="l109"></a><a href="#l109">109</a><td>};<tr><td><a id="l110"></a><a href="#l110">110</a><td><tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td>/**<tr><td><a id="l113"></a><a href="#l113">113</a><td> * Registers a listener.<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @param {string} type The type of event to listen for.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l118"></a><a href="#l118">118</a><td> */<tr><td><a id="l119"></a><a href="#l119">119</a><td>webdriver.EventEmitter.prototype.addListener = function(type, listenerFn,<tr><td><a id="l120"></a><a href="#l120">120</a><td>    opt_scope) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>  return this.addListener_(type, listenerFn, opt_scope);<tr><td><a id="l122"></a><a href="#l122">122</a><td>};<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> * Registers a one-time listener which will be called only the first time an<tr><td><a id="l127"></a><a href="#l127">127</a><td> * event is emitted, after which it will be removed.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {string} type The type of event to listen for.<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>webdriver.EventEmitter.prototype.once = function(type, listenerFn, opt_scope) {<tr><td><a id="l134"></a><a href="#l134">134</a><td>  return this.addListener_(type, listenerFn, opt_scope, 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> * An alias for {@code #addListener()}.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @param {string} type The type of event to listen for.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {!Function} listenerFn The function to invoke when the event is fired.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {Object=} opt_scope The object in whose scope to invoke the listener.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l144"></a><a href="#l144">144</a><td> */<tr><td><a id="l145"></a><a href="#l145">145</a><td>webdriver.EventEmitter.prototype.on =<tr><td><a id="l146"></a><a href="#l146">146</a><td>    webdriver.EventEmitter.prototype.addListener;<tr><td><a id="l147"></a><a href="#l147">147</a><td><tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>/**<tr><td><a id="l150"></a><a href="#l150">150</a><td> * Removes a previously registered event listener.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {string} type The type of event to unregister.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @param {!Function} listenerFn The handler function to remove.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l154"></a><a href="#l154">154</a><td> */<tr><td><a id="l155"></a><a href="#l155">155</a><td>webdriver.EventEmitter.prototype.removeListener = function(type, listenerFn) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>  var listeners = this.events_[type];<tr><td><a id="l157"></a><a href="#l157">157</a><td>  if (listeners) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>    var n = listeners.length;<tr><td><a id="l159"></a><a href="#l159">159</a><td>    for (var i = 0; i &lt; n; ++i) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>      if (listeners[i].fn == listenerFn) {<tr><td><a id="l161"></a><a href="#l161">161</a><td>        listeners.splice(i, 1);<tr><td><a id="l162"></a><a href="#l162">162</a><td>        return this;<tr><td><a id="l163"></a><a href="#l163">163</a><td>      }<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>  return this;<tr><td><a id="l167"></a><a href="#l167">167</a><td>};<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> * Removes all listeners for a specific type of event. If no event is<tr><td><a id="l172"></a><a href="#l172">172</a><td> * specified, all listeners across all types will be removed.<tr><td><a id="l173"></a><a href="#l173">173</a><td> * @param {string=} opt_type The type of event to remove listeners from.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {!webdriver.EventEmitter} A self reference.<tr><td><a id="l175"></a><a href="#l175">175</a><td> */<tr><td><a id="l176"></a><a href="#l176">176</a><td>webdriver.EventEmitter.prototype.removeAllListeners = function(opt_type) {<tr><td><a id="l177"></a><a href="#l177">177</a><td>  goog.isDef(opt_type) ? delete this.events_[opt_type] : this.events_ = {};<tr><td><a id="l178"></a><a href="#l178">178</a><td>  return this;<tr><td><a id="l179"></a><a href="#l179">179</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/firefoxdomexecutor.js.src.html b/docs/source/lib/webdriver/firefoxdomexecutor.js.src.html
index a463d7e..3fb0708 100644
--- a/docs/source/lib/webdriver/firefoxdomexecutor.js.src.html
+++ b/docs/source/lib/webdriver/firefoxdomexecutor.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>firefoxdomexecutor.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/firefoxdomexecutor.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.FirefoxDomExecutor&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;bot.response&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l19" href="#l19">19</a><td>goog.require(&#39;goog.userAgent.product&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.require(&#39;webdriver.Command&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * @constructor<tr><td><a name="l27" href="#l27">27</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a name="l28" href="#l28">28</a><td> */<tr><td><a name="l29" href="#l29">29</a><td>webdriver.FirefoxDomExecutor = function() {<tr><td><a name="l30" href="#l30">30</a><td>  if (!webdriver.FirefoxDomExecutor.isAvailable()) {<tr><td><a name="l31" href="#l31">31</a><td>    throw Error(<tr><td><a name="l32" href="#l32">32</a><td>        &#39;The current environment does not support the FirefoxDomExecutor&#39;);<tr><td><a name="l33" href="#l33">33</a><td>  }<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>  /** @private {!Document} */<tr><td><a name="l36" href="#l36">36</a><td>  this.doc_ = document;<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td>  /** @private {!Element} */<tr><td><a name="l39" href="#l39">39</a><td>  this.docElement_ = document.documentElement;<tr><td><a name="l40" href="#l40">40</a><td><tr><td><a name="l41" href="#l41">41</a><td>  this.docElement_.addEventListener(<tr><td><a name="l42" href="#l42">42</a><td>      webdriver.FirefoxDomExecutor.EventType_.RESPONSE,<tr><td><a name="l43" href="#l43">43</a><td>      goog.bind(this.onResponse_, this), false);<tr><td><a name="l44" href="#l44">44</a><td>};<tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>/**<tr><td><a name="l48" href="#l48">48</a><td> * @return {boolean} Whether the current environment supports the<tr><td><a name="l49" href="#l49">49</a><td> *     FirefoxDomExecutor.<tr><td><a name="l50" href="#l50">50</a><td> */<tr><td><a name="l51" href="#l51">51</a><td>webdriver.FirefoxDomExecutor.isAvailable = function() {<tr><td><a name="l52" href="#l52">52</a><td>  return goog.userAgent.product.FIREFOX &amp;&amp;<tr><td><a name="l53" href="#l53">53</a><td>      typeof document !== &#39;undefined&#39; &amp;&amp;<tr><td><a name="l54" href="#l54">54</a><td>      document.documentElement &amp;&amp;<tr><td><a name="l55" href="#l55">55</a><td>      goog.isFunction(document.documentElement.hasAttribute) &amp;&amp;<tr><td><a name="l56" href="#l56">56</a><td>      document.documentElement.hasAttribute(&#39;webdriver&#39;);<tr><td><a name="l57" href="#l57">57</a><td>};<tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td>/**<tr><td><a name="l61" href="#l61">61</a><td> * Attributes used to communicate with the FirefoxDriver extension.<tr><td><a name="l62" href="#l62">62</a><td> * @enum {string}<tr><td><a name="l63" href="#l63">63</a><td> * @private<tr><td><a name="l64" href="#l64">64</a><td> */<tr><td><a name="l65" href="#l65">65</a><td>webdriver.FirefoxDomExecutor.Attribute_ = {<tr><td><a name="l66" href="#l66">66</a><td>  COMMAND: &#39;command&#39;,<tr><td><a name="l67" href="#l67">67</a><td>  RESPONSE: &#39;response&#39;<tr><td><a name="l68" href="#l68">68</a><td>};<tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td>/**<tr><td><a name="l72" href="#l72">72</a><td> * Events used to communicate with the FirefoxDriver extension.<tr><td><a name="l73" href="#l73">73</a><td> * @enum {string}<tr><td><a name="l74" href="#l74">74</a><td> * @private<tr><td><a name="l75" href="#l75">75</a><td> */<tr><td><a name="l76" href="#l76">76</a><td>webdriver.FirefoxDomExecutor.EventType_ = {<tr><td><a name="l77" href="#l77">77</a><td>  COMMAND: &#39;webdriverCommand&#39;,<tr><td><a name="l78" href="#l78">78</a><td>  RESPONSE: &#39;webdriverResponse&#39;<tr><td><a name="l79" href="#l79">79</a><td>};<tr><td><a name="l80" href="#l80">80</a><td><tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td>/**<tr><td><a name="l83" href="#l83">83</a><td> * The pending command, if any.<tr><td><a name="l84" href="#l84">84</a><td> * @private {?{name:string, callback:!Function}}<tr><td><a name="l85" href="#l85">85</a><td> */<tr><td><a name="l86" href="#l86">86</a><td>webdriver.FirefoxDomExecutor.prototype.pendingCommand_ = null;<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>/** @override */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.FirefoxDomExecutor.prototype.execute = function(command, callback) {<tr><td><a name="l91" href="#l91">91</a><td>  if (this.pendingCommand_) {<tr><td><a name="l92" href="#l92">92</a><td>    throw Error(&#39;Currently awaiting a command response!&#39;);<tr><td><a name="l93" href="#l93">93</a><td>  }<tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>  this.pendingCommand_ = {<tr><td><a name="l96" href="#l96">96</a><td>    name: command.getName(),<tr><td><a name="l97" href="#l97">97</a><td>    callback: callback<tr><td><a name="l98" href="#l98">98</a><td>  };<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td>  var parameters = command.getParameters();<tr><td><a name="l101" href="#l101">101</a><td><tr><td><a name="l102" href="#l102">102</a><td>  // There are two means for communicating with the FirefoxDriver: via<tr><td><a name="l103" href="#l103">103</a><td>  // HTTP using WebDriver&#39;s wire protocol and over the DOM using a custom<tr><td><a name="l104" href="#l104">104</a><td>  // JSON protocol. This class uses the latter. When the FirefoxDriver receives<tr><td><a name="l105" href="#l105">105</a><td>  // commands over HTTP, it builds a parameters object from the URL parameters.<tr><td><a name="l106" href="#l106">106</a><td>  // When an element ID is sent in the URL, it&#39;ll be decoded as just id:string<tr><td><a name="l107" href="#l107">107</a><td>  // instead of id:{ELEMENT:string}. When switching to a frame by element,<tr><td><a name="l108" href="#l108">108</a><td>  // however, the element ID is not sent through the URL, so we must make sure<tr><td><a name="l109" href="#l109">109</a><td>  // to encode that parameter properly here. It would be nice if we unified<tr><td><a name="l110" href="#l110">110</a><td>  // the two protocols used by the FirefoxDriver...<tr><td><a name="l111" href="#l111">111</a><td>  if (parameters[&#39;id&#39;] &amp;&amp;<tr><td><a name="l112" href="#l112">112</a><td>      parameters[&#39;id&#39;][&#39;ELEMENT&#39;] &amp;&amp;<tr><td><a name="l113" href="#l113">113</a><td>      command.getName() != webdriver.CommandName.SWITCH_TO_FRAME) {<tr><td><a name="l114" href="#l114">114</a><td>    parameters[&#39;id&#39;] = parameters[&#39;id&#39;][&#39;ELEMENT&#39;];<tr><td><a name="l115" href="#l115">115</a><td>  }<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td>  var json = goog.json.serialize({<tr><td><a name="l118" href="#l118">118</a><td>    &#39;name&#39;: command.getName(),<tr><td><a name="l119" href="#l119">119</a><td>    &#39;sessionId&#39;: {<tr><td><a name="l120" href="#l120">120</a><td>      &#39;value&#39;: parameters[&#39;sessionId&#39;]<tr><td><a name="l121" href="#l121">121</a><td>    },<tr><td><a name="l122" href="#l122">122</a><td>    &#39;parameters&#39;: parameters<tr><td><a name="l123" href="#l123">123</a><td>  });<tr><td><a name="l124" href="#l124">124</a><td>  this.docElement_.setAttribute(<tr><td><a name="l125" href="#l125">125</a><td>      webdriver.FirefoxDomExecutor.Attribute_.COMMAND, json);<tr><td><a name="l126" href="#l126">126</a><td><tr><td><a name="l127" href="#l127">127</a><td>  var event = this.doc_.createEvent(&#39;Event&#39;);<tr><td><a name="l128" href="#l128">128</a><td>  event.initEvent(webdriver.FirefoxDomExecutor.EventType_.COMMAND,<tr><td><a name="l129" href="#l129">129</a><td>      /*canBubble=*/true, /*cancelable=*/true);<tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td>  this.docElement_.dispatchEvent(event);<tr><td><a name="l132" href="#l132">132</a><td>};<tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td><tr><td><a name="l135" href="#l135">135</a><td>/** @private */<tr><td><a name="l136" href="#l136">136</a><td>webdriver.FirefoxDomExecutor.prototype.onResponse_ = function() {<tr><td><a name="l137" href="#l137">137</a><td>  if (!this.pendingCommand_) {<tr><td><a name="l138" href="#l138">138</a><td>    return;  // Not expecting a response.<tr><td><a name="l139" href="#l139">139</a><td>  }<tr><td><a name="l140" href="#l140">140</a><td><tr><td><a name="l141" href="#l141">141</a><td>  var command = this.pendingCommand_;<tr><td><a name="l142" href="#l142">142</a><td>  this.pendingCommand_ = null;<tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td>  var json = this.docElement_.getAttribute(<tr><td><a name="l145" href="#l145">145</a><td>      webdriver.FirefoxDomExecutor.Attribute_.RESPONSE);<tr><td><a name="l146" href="#l146">146</a><td>  if (!json) {<tr><td><a name="l147" href="#l147">147</a><td>    command.callback(Error(&#39;Empty command response!&#39;));<tr><td><a name="l148" href="#l148">148</a><td>    return;<tr><td><a name="l149" href="#l149">149</a><td>  }<tr><td><a name="l150" href="#l150">150</a><td><tr><td><a name="l151" href="#l151">151</a><td>  this.docElement_.removeAttribute(<tr><td><a name="l152" href="#l152">152</a><td>      webdriver.FirefoxDomExecutor.Attribute_.COMMAND);<tr><td><a name="l153" href="#l153">153</a><td>  this.docElement_.removeAttribute(<tr><td><a name="l154" href="#l154">154</a><td>      webdriver.FirefoxDomExecutor.Attribute_.RESPONSE);<tr><td><a name="l155" href="#l155">155</a><td><tr><td><a name="l156" href="#l156">156</a><td>  try {<tr><td><a name="l157" href="#l157">157</a><td>    var response = bot.response.checkResponse(<tr><td><a name="l158" href="#l158">158</a><td>        /** @type {!bot.response.ResponseObject} */ (goog.json.parse(json)));<tr><td><a name="l159" href="#l159">159</a><td>  } catch (ex) {<tr><td><a name="l160" href="#l160">160</a><td>    command.callback(ex);<tr><td><a name="l161" href="#l161">161</a><td>    return;<tr><td><a name="l162" href="#l162">162</a><td>  }<tr><td><a name="l163" href="#l163">163</a><td><tr><td><a name="l164" href="#l164">164</a><td>  // Prior to Selenium 2.35.0, two commands are required to fully create a<tr><td><a name="l165" href="#l165">165</a><td>  // session: one to allocate the session, and another to fetch the<tr><td><a name="l166" href="#l166">166</a><td>  // capabilities.<tr><td><a name="l167" href="#l167">167</a><td>  if (command.name == webdriver.CommandName.NEW_SESSION &amp;&amp;<tr><td><a name="l168" href="#l168">168</a><td>      goog.isString(response[&#39;value&#39;])) {<tr><td><a name="l169" href="#l169">169</a><td>    var cmd = new webdriver.Command(webdriver.CommandName.DESCRIBE_SESSION).<tr><td><a name="l170" href="#l170">170</a><td>        setParameter(&#39;sessionId&#39;, response[&#39;value&#39;]);<tr><td><a name="l171" href="#l171">171</a><td>    this.execute(cmd, command.callback);<tr><td><a name="l172" href="#l172">172</a><td>  } else {<tr><td><a name="l173" href="#l173">173</a><td>    command.callback(null, response);<tr><td><a name="l174" href="#l174">174</a><td>  }<tr><td><a name="l175" href="#l175">175</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>firefoxdomexecutor.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/firefoxdomexecutor.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.FirefoxDomExecutor&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;bot.response&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l19" href="#l19">19</a><td>goog.require(&#39;goog.userAgent.product&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.require(&#39;webdriver.Command&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * @constructor<tr><td><a name="l27" href="#l27">27</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a name="l28" href="#l28">28</a><td> */<tr><td><a name="l29" href="#l29">29</a><td>webdriver.FirefoxDomExecutor = function() {<tr><td><a name="l30" href="#l30">30</a><td>  if (!webdriver.FirefoxDomExecutor.isAvailable()) {<tr><td><a name="l31" href="#l31">31</a><td>    throw Error(<tr><td><a name="l32" href="#l32">32</a><td>        &#39;The current environment does not support the FirefoxDomExecutor&#39;);<tr><td><a name="l33" href="#l33">33</a><td>  }<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>  /** @private {!Document} */<tr><td><a name="l36" href="#l36">36</a><td>  this.doc_ = document;<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td>  /** @private {!Element} */<tr><td><a name="l39" href="#l39">39</a><td>  this.docElement_ = document.documentElement;<tr><td><a name="l40" href="#l40">40</a><td><tr><td><a name="l41" href="#l41">41</a><td>  this.docElement_.addEventListener(<tr><td><a name="l42" href="#l42">42</a><td>      webdriver.FirefoxDomExecutor.EventType_.RESPONSE,<tr><td><a name="l43" href="#l43">43</a><td>      goog.bind(this.onResponse_, this), false);<tr><td><a name="l44" href="#l44">44</a><td>};<tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>/**<tr><td><a name="l48" href="#l48">48</a><td> * @return {boolean} Whether the current environment supports the<tr><td><a name="l49" href="#l49">49</a><td> *     FirefoxDomExecutor.<tr><td><a name="l50" href="#l50">50</a><td> */<tr><td><a name="l51" href="#l51">51</a><td>webdriver.FirefoxDomExecutor.isAvailable = function() {<tr><td><a name="l52" href="#l52">52</a><td>  return goog.userAgent.product.FIREFOX &amp;&amp;<tr><td><a name="l53" href="#l53">53</a><td>      typeof document !== &#39;undefined&#39; &amp;&amp;<tr><td><a name="l54" href="#l54">54</a><td>      document.documentElement &amp;&amp;<tr><td><a name="l55" href="#l55">55</a><td>      goog.isFunction(document.documentElement.hasAttribute) &amp;&amp;<tr><td><a name="l56" href="#l56">56</a><td>      document.documentElement.hasAttribute(&#39;webdriver&#39;);<tr><td><a name="l57" href="#l57">57</a><td>};<tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td>/**<tr><td><a name="l61" href="#l61">61</a><td> * Attributes used to communicate with the FirefoxDriver extension.<tr><td><a name="l62" href="#l62">62</a><td> * @enum {string}<tr><td><a name="l63" href="#l63">63</a><td> * @private<tr><td><a name="l64" href="#l64">64</a><td> */<tr><td><a name="l65" href="#l65">65</a><td>webdriver.FirefoxDomExecutor.Attribute_ = {<tr><td><a name="l66" href="#l66">66</a><td>  COMMAND: &#39;command&#39;,<tr><td><a name="l67" href="#l67">67</a><td>  RESPONSE: &#39;response&#39;<tr><td><a name="l68" href="#l68">68</a><td>};<tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td>/**<tr><td><a name="l72" href="#l72">72</a><td> * Events used to communicate with the FirefoxDriver extension.<tr><td><a name="l73" href="#l73">73</a><td> * @enum {string}<tr><td><a name="l74" href="#l74">74</a><td> * @private<tr><td><a name="l75" href="#l75">75</a><td> */<tr><td><a name="l76" href="#l76">76</a><td>webdriver.FirefoxDomExecutor.EventType_ = {<tr><td><a name="l77" href="#l77">77</a><td>  COMMAND: &#39;webdriverCommand&#39;,<tr><td><a name="l78" href="#l78">78</a><td>  RESPONSE: &#39;webdriverResponse&#39;<tr><td><a name="l79" href="#l79">79</a><td>};<tr><td><a name="l80" href="#l80">80</a><td><tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td>/**<tr><td><a name="l83" href="#l83">83</a><td> * The pending command, if any.<tr><td><a name="l84" href="#l84">84</a><td> * @private {?{name:string, callback:!Function}}<tr><td><a name="l85" href="#l85">85</a><td> */<tr><td><a name="l86" href="#l86">86</a><td>webdriver.FirefoxDomExecutor.prototype.pendingCommand_ = null;<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>/** @override */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.FirefoxDomExecutor.prototype.execute = function(command, callback) {<tr><td><a name="l91" href="#l91">91</a><td>  if (this.pendingCommand_) {<tr><td><a name="l92" href="#l92">92</a><td>    throw Error(&#39;Currently awaiting a command response!&#39;);<tr><td><a name="l93" href="#l93">93</a><td>  }<tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>  this.pendingCommand_ = {<tr><td><a name="l96" href="#l96">96</a><td>    name: command.getName(),<tr><td><a name="l97" href="#l97">97</a><td>    callback: callback<tr><td><a name="l98" href="#l98">98</a><td>  };<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td>  var parameters = command.getParameters();<tr><td><a name="l101" href="#l101">101</a><td><tr><td><a name="l102" href="#l102">102</a><td>  // There are two means for communicating with the FirefoxDriver: via<tr><td><a name="l103" href="#l103">103</a><td>  // HTTP using WebDriver&#39;s wire protocol and over the DOM using a custom<tr><td><a name="l104" href="#l104">104</a><td>  // JSON protocol. This class uses the latter. When the FirefoxDriver receives<tr><td><a name="l105" href="#l105">105</a><td>  // commands over HTTP, it builds a parameters object from the URL parameters.<tr><td><a name="l106" href="#l106">106</a><td>  // When an element ID is sent in the URL, it&#39;ll be decoded as just id:string<tr><td><a name="l107" href="#l107">107</a><td>  // instead of id:{ELEMENT:string}. When switching to a frame by element,<tr><td><a name="l108" href="#l108">108</a><td>  // however, the element ID is not sent through the URL, so we must make sure<tr><td><a name="l109" href="#l109">109</a><td>  // to encode that parameter properly here. It would be nice if we unified<tr><td><a name="l110" href="#l110">110</a><td>  // the two protocols used by the FirefoxDriver...<tr><td><a name="l111" href="#l111">111</a><td>  if (parameters[&#39;id&#39;] &amp;&amp;<tr><td><a name="l112" href="#l112">112</a><td>      parameters[&#39;id&#39;][&#39;ELEMENT&#39;] &amp;&amp;<tr><td><a name="l113" href="#l113">113</a><td>      command.getName() != webdriver.CommandName.SWITCH_TO_FRAME) {<tr><td><a name="l114" href="#l114">114</a><td>    parameters[&#39;id&#39;] = parameters[&#39;id&#39;][&#39;ELEMENT&#39;];<tr><td><a name="l115" href="#l115">115</a><td>  }<tr><td><a name="l116" href="#l116">116</a><td>  var json = goog.json.serialize({<tr><td><a name="l117" href="#l117">117</a><td>    &#39;name&#39;: command.getName(),<tr><td><a name="l118" href="#l118">118</a><td>    &#39;sessionId&#39;: parameters[&#39;sessionId&#39;],<tr><td><a name="l119" href="#l119">119</a><td>    &#39;parameters&#39;: parameters<tr><td><a name="l120" href="#l120">120</a><td>  });<tr><td><a name="l121" href="#l121">121</a><td>  this.docElement_.setAttribute(<tr><td><a name="l122" href="#l122">122</a><td>      webdriver.FirefoxDomExecutor.Attribute_.COMMAND, json);<tr><td><a name="l123" href="#l123">123</a><td><tr><td><a name="l124" href="#l124">124</a><td>  var event = this.doc_.createEvent(&#39;Event&#39;);<tr><td><a name="l125" href="#l125">125</a><td>  event.initEvent(webdriver.FirefoxDomExecutor.EventType_.COMMAND,<tr><td><a name="l126" href="#l126">126</a><td>      /*canBubble=*/true, /*cancelable=*/true);<tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td>  this.docElement_.dispatchEvent(event);<tr><td><a name="l129" href="#l129">129</a><td>};<tr><td><a name="l130" href="#l130">130</a><td><tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td>/** @private */<tr><td><a name="l133" href="#l133">133</a><td>webdriver.FirefoxDomExecutor.prototype.onResponse_ = function() {<tr><td><a name="l134" href="#l134">134</a><td>  if (!this.pendingCommand_) {<tr><td><a name="l135" href="#l135">135</a><td>    return;  // Not expecting a response.<tr><td><a name="l136" href="#l136">136</a><td>  }<tr><td><a name="l137" href="#l137">137</a><td><tr><td><a name="l138" href="#l138">138</a><td>  var command = this.pendingCommand_;<tr><td><a name="l139" href="#l139">139</a><td>  this.pendingCommand_ = null;<tr><td><a name="l140" href="#l140">140</a><td><tr><td><a name="l141" href="#l141">141</a><td>  var json = this.docElement_.getAttribute(<tr><td><a name="l142" href="#l142">142</a><td>      webdriver.FirefoxDomExecutor.Attribute_.RESPONSE);<tr><td><a name="l143" href="#l143">143</a><td>  if (!json) {<tr><td><a name="l144" href="#l144">144</a><td>    command.callback(Error(&#39;Empty command response!&#39;));<tr><td><a name="l145" href="#l145">145</a><td>    return;<tr><td><a name="l146" href="#l146">146</a><td>  }<tr><td><a name="l147" href="#l147">147</a><td><tr><td><a name="l148" href="#l148">148</a><td>  this.docElement_.removeAttribute(<tr><td><a name="l149" href="#l149">149</a><td>      webdriver.FirefoxDomExecutor.Attribute_.COMMAND);<tr><td><a name="l150" href="#l150">150</a><td>  this.docElement_.removeAttribute(<tr><td><a name="l151" href="#l151">151</a><td>      webdriver.FirefoxDomExecutor.Attribute_.RESPONSE);<tr><td><a name="l152" href="#l152">152</a><td><tr><td><a name="l153" href="#l153">153</a><td>  try {<tr><td><a name="l154" href="#l154">154</a><td>    var response = bot.response.checkResponse(<tr><td><a name="l155" href="#l155">155</a><td>        /** @type {!bot.response.ResponseObject} */ (goog.json.parse(json)));<tr><td><a name="l156" href="#l156">156</a><td>  } catch (ex) {<tr><td><a name="l157" href="#l157">157</a><td>    command.callback(ex);<tr><td><a name="l158" href="#l158">158</a><td>    return;<tr><td><a name="l159" href="#l159">159</a><td>  }<tr><td><a name="l160" href="#l160">160</a><td><tr><td><a name="l161" href="#l161">161</a><td>  // Prior to Selenium 2.35.0, two commands are required to fully create a<tr><td><a name="l162" href="#l162">162</a><td>  // session: one to allocate the session, and another to fetch the<tr><td><a name="l163" href="#l163">163</a><td>  // capabilities.<tr><td><a name="l164" href="#l164">164</a><td>  if (command.name == webdriver.CommandName.NEW_SESSION &amp;&amp;<tr><td><a name="l165" href="#l165">165</a><td>      goog.isString(response[&#39;value&#39;])) {<tr><td><a name="l166" href="#l166">166</a><td>    var cmd = new webdriver.Command(webdriver.CommandName.DESCRIBE_SESSION).<tr><td><a name="l167" href="#l167">167</a><td>        setParameter(&#39;sessionId&#39;, response[&#39;value&#39;]);<tr><td><a name="l168" href="#l168">168</a><td>    this.execute(cmd, command.callback);<tr><td><a name="l169" href="#l169">169</a><td>  } else {<tr><td><a name="l170" href="#l170">170</a><td>    command.callback(null, response);<tr><td><a name="l171" href="#l171">171</a><td>  }<tr><td><a name="l172" href="#l172">172</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/http/corsclient.js.src.html b/docs/source/lib/webdriver/http/corsclient.js.src.html
index f33da44..cb2a928 100644
--- a/docs/source/lib/webdriver/http/corsclient.js.src.html
+++ b/docs/source/lib/webdriver/http/corsclient.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>corsclient.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/http/corsclient.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.http.CorsClient&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;webdriver.http.Response&#39;);<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>/**<tr><td><a name="l23" href="#l23">23</a><td> * Communicates with a WebDriver server, which may be on a different domain,<tr><td><a name="l24" href="#l24">24</a><td> * using the &lt;a href=&quot;http://www.w3.org/TR/cors/&quot;&gt;cross-origin resource sharing<tr><td><a name="l25" href="#l25">25</a><td> * &lt;/a&gt; (CORS) extension to WebDriver&#39;s JSON wire protocol.<tr><td><a name="l26" href="#l26">26</a><td> *<tr><td><a name="l27" href="#l27">27</a><td> * &lt;p&gt;Each command from the standard JSON protocol will be encoded in a<tr><td><a name="l28" href="#l28">28</a><td> * JSON object with the following form:<tr><td><a name="l29" href="#l29">29</a><td> * {method:string, path:string, data:!Object}<tr><td><a name="l30" href="#l30">30</a><td> *<tr><td><a name="l31" href="#l31">31</a><td> * &lt;p&gt;The encoded command is then sent as a POST request to the server&#39;s /xdrpc<tr><td><a name="l32" href="#l32">32</a><td> * endpoint.  The server will decode the command, re-route it to the appropriate<tr><td><a name="l33" href="#l33">33</a><td> * handler, and then return the command&#39;s response as a standard JSON response<tr><td><a name="l34" href="#l34">34</a><td> * object.  The JSON responses will &lt;em&gt;always&lt;/em&gt; be returned with a 200<tr><td><a name="l35" href="#l35">35</a><td> * response from the server; clients must rely on the response&#39;s &quot;status&quot; field<tr><td><a name="l36" href="#l36">36</a><td> * to determine whether the command succeeded.<tr><td><a name="l37" href="#l37">37</a><td> *<tr><td><a name="l38" href="#l38">38</a><td> * &lt;p&gt;This client cannot be used with the standard wire protocol due to<tr><td><a name="l39" href="#l39">39</a><td> * limitations in the various browser implementations of the CORS specification:<tr><td><a name="l40" href="#l40">40</a><td> * &lt;ul&gt;<tr><td><a name="l41" href="#l41">41</a><td> *   &lt;li&gt;IE&#39;s &lt;a href=&quot;http://goo.gl/6l3kA&quot;&gt;XDomainRequest&lt;/a&gt; object is only<tr><td><a name="l42" href="#l42">42</a><td> *     capable of generating the types of requests that may be generated through<tr><td><a name="l43" href="#l43">43</a><td> *     a standard &lt;a href=&quot;http://goo.gl/vgzAU&quot;&gt;HTML form&lt;/a&gt; - it can not send<tr><td><a name="l44" href="#l44">44</a><td> *     DELETE requests, as is required in the wire protocol.<tr><td><a name="l45" href="#l45">45</a><td> *   &lt;li&gt;WebKit&#39;s implementation of CORS does not follow the spec and forbids<tr><td><a name="l46" href="#l46">46</a><td> *     redirects: https://bugs.webkit.org/show_bug.cgi?id=57600<tr><td><a name="l47" href="#l47">47</a><td> *     This limitation appears to be intentional and is documented in WebKit&#39;s<tr><td><a name="l48" href="#l48">48</a><td> *     Layout tests:<tr><td><a name="l49" href="#l49">49</a><td> *     //LayoutTests/http/tests/xmlhttprequest/access-control-and-redirects.html<tr><td><a name="l50" href="#l50">50</a><td> *   &lt;li&gt;If the server does not return a 2xx response, IE and Opera&#39;s<tr><td><a name="l51" href="#l51">51</a><td> *     implementations will fire the XDomainRequest/XMLHttpRequest object&#39;s<tr><td><a name="l52" href="#l52">52</a><td> *     onerror handler, but without the corresponding response text returned by<tr><td><a name="l53" href="#l53">53</a><td> *     the server. This renders IE and Opera incapable of handling command<tr><td><a name="l54" href="#l54">54</a><td> *     failures in the standard JSON protocol.<tr><td><a name="l55" href="#l55">55</a><td> * &lt;/ul&gt;<tr><td><a name="l56" href="#l56">56</a><td> *<tr><td><a name="l57" href="#l57">57</a><td> * @param {string} url URL for the WebDriver server to send commands to.<tr><td><a name="l58" href="#l58">58</a><td> * @constructor<tr><td><a name="l59" href="#l59">59</a><td> * @implements {webdriver.http.Client}<tr><td><a name="l60" href="#l60">60</a><td> * @see &lt;a href=&quot;http://www.w3.org/TR/cors/&quot;&gt;CORS Spec&lt;/a&gt;<tr><td><a name="l61" href="#l61">61</a><td> * @see &lt;a href=&quot;http://code.google.com/p/selenium/wiki/JsonWireProtocol&quot;&gt;<tr><td><a name="l62" href="#l62">62</a><td> *     JSON wire protocol&lt;/a&gt;<tr><td><a name="l63" href="#l63">63</a><td> */<tr><td><a name="l64" href="#l64">64</a><td>webdriver.http.CorsClient = function(url) {<tr><td><a name="l65" href="#l65">65</a><td>  if (!webdriver.http.CorsClient.isAvailable()) {<tr><td><a name="l66" href="#l66">66</a><td>    throw Error(&#39;The current environment does not support cross-origin &#39; +<tr><td><a name="l67" href="#l67">67</a><td>        &#39;resource sharing&#39;);<tr><td><a name="l68" href="#l68">68</a><td>  }<tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td>  /** @private {string} */<tr><td><a name="l71" href="#l71">71</a><td>  this.url_ = url + webdriver.http.CorsClient.XDRPC_ENDPOINT;<tr><td><a name="l72" href="#l72">72</a><td>};<tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td>/**<tr><td><a name="l76" href="#l76">76</a><td> * Resource URL to send commands to on the server.<tr><td><a name="l77" href="#l77">77</a><td> * @type {string}<tr><td><a name="l78" href="#l78">78</a><td> * @const<tr><td><a name="l79" href="#l79">79</a><td> */<tr><td><a name="l80" href="#l80">80</a><td>webdriver.http.CorsClient.XDRPC_ENDPOINT = &#39;/xdrpc&#39;;<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td><tr><td><a name="l83" href="#l83">83</a><td>/**<tr><td><a name="l84" href="#l84">84</a><td> * Tests whether the current environment supports cross-origin resource sharing.<tr><td><a name="l85" href="#l85">85</a><td> * @return {boolean} Whether cross-origin resource sharing is supported.<tr><td><a name="l86" href="#l86">86</a><td> * @see http://www.w3.org/TR/cors/<tr><td><a name="l87" href="#l87">87</a><td> */<tr><td><a name="l88" href="#l88">88</a><td>webdriver.http.CorsClient.isAvailable = function() {<tr><td><a name="l89" href="#l89">89</a><td>  return typeof XDomainRequest !== &#39;undefined&#39; ||<tr><td><a name="l90" href="#l90">90</a><td>      (typeof XMLHttpRequest !== &#39;undefined&#39; &amp;&amp;<tr><td><a name="l91" href="#l91">91</a><td>          goog.isBoolean(new XMLHttpRequest().withCredentials));<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/** @override */<tr><td><a name="l96" href="#l96">96</a><td>webdriver.http.CorsClient.prototype.send = function(request, callback) {<tr><td><a name="l97" href="#l97">97</a><td>  try {<tr><td><a name="l98" href="#l98">98</a><td>    var xhr = new (typeof XDomainRequest !== &#39;undefined&#39; ?<tr><td><a name="l99" href="#l99">99</a><td>        XDomainRequest : XMLHttpRequest);<tr><td><a name="l100" href="#l100">100</a><td>    xhr.open(&#39;POST&#39;, this.url_, true);<tr><td><a name="l101" href="#l101">101</a><td><tr><td><a name="l102" href="#l102">102</a><td>    xhr.onload = function() {<tr><td><a name="l103" href="#l103">103</a><td>      callback(null, webdriver.http.Response.fromXmlHttpRequest(<tr><td><a name="l104" href="#l104">104</a><td>          /** @type {!XMLHttpRequest} */ (xhr)));<tr><td><a name="l105" href="#l105">105</a><td>    };<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td>    var url = this.url_;<tr><td><a name="l108" href="#l108">108</a><td>    xhr.onerror = function() {<tr><td><a name="l109" href="#l109">109</a><td>      callback(Error([<tr><td><a name="l110" href="#l110">110</a><td>        &#39;Unable to send request: POST &#39;, url,<tr><td><a name="l111" href="#l111">111</a><td>        &#39;\nPerhaps the server did not respond to the preflight request &#39;,<tr><td><a name="l112" href="#l112">112</a><td>        &#39;with valid access control headers?&#39;<tr><td><a name="l113" href="#l113">113</a><td>      ].join(&#39;&#39;)));<tr><td><a name="l114" href="#l114">114</a><td>    };<tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td>    // Define event handlers for all events on the XDomainRequest. Apparently,<tr><td><a name="l117" href="#l117">117</a><td>    // if we don&#39;t do this, IE9+10 will silently abort our request. Yay IE.<tr><td><a name="l118" href="#l118">118</a><td>    // Note, we&#39;re not using goog.nullFunction, because it tends to get<tr><td><a name="l119" href="#l119">119</a><td>    // optimized away by the compiler, which leaves us where we were before.<tr><td><a name="l120" href="#l120">120</a><td>    xhr.onprogress = xhr.ontimeout = function() {};<tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td>    xhr.send(goog.json.serialize({<tr><td><a name="l123" href="#l123">123</a><td>      &#39;method&#39;: request.method,<tr><td><a name="l124" href="#l124">124</a><td>      &#39;path&#39;: request.path,<tr><td><a name="l125" href="#l125">125</a><td>      &#39;data&#39;: request.data<tr><td><a name="l126" href="#l126">126</a><td>    }));<tr><td><a name="l127" href="#l127">127</a><td>  } catch (ex) {<tr><td><a name="l128" href="#l128">128</a><td>    callback(ex);<tr><td><a name="l129" href="#l129">129</a><td>  }<tr><td><a name="l130" href="#l130">130</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>corsclient.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/http/corsclient.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.http.CorsClient&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;webdriver.http.Response&#39;);<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>/**<tr><td><a name="l23" href="#l23">23</a><td> * Communicates with a WebDriver server, which may be on a different domain,<tr><td><a name="l24" href="#l24">24</a><td> * using the &lt;a href=&quot;http://www.w3.org/TR/cors/&quot;&gt;cross-origin resource sharing<tr><td><a name="l25" href="#l25">25</a><td> * &lt;/a&gt; (CORS) extension to WebDriver&#39;s JSON wire protocol.<tr><td><a name="l26" href="#l26">26</a><td> *<tr><td><a name="l27" href="#l27">27</a><td> * &lt;p&gt;Each command from the standard JSON protocol will be encoded in a<tr><td><a name="l28" href="#l28">28</a><td> * JSON object with the following form:<tr><td><a name="l29" href="#l29">29</a><td> * {method:string, path:string, data:!Object}<tr><td><a name="l30" href="#l30">30</a><td> *<tr><td><a name="l31" href="#l31">31</a><td> * &lt;p&gt;The encoded command is then sent as a POST request to the server&#39;s /xdrpc<tr><td><a name="l32" href="#l32">32</a><td> * endpoint.  The server will decode the command, re-route it to the appropriate<tr><td><a name="l33" href="#l33">33</a><td> * handler, and then return the command&#39;s response as a standard JSON response<tr><td><a name="l34" href="#l34">34</a><td> * object.  The JSON responses will &lt;em&gt;always&lt;/em&gt; be returned with a 200<tr><td><a name="l35" href="#l35">35</a><td> * response from the server; clients must rely on the response&#39;s &quot;status&quot; field<tr><td><a name="l36" href="#l36">36</a><td> * to determine whether the command succeeded.<tr><td><a name="l37" href="#l37">37</a><td> *<tr><td><a name="l38" href="#l38">38</a><td> * &lt;p&gt;This client cannot be used with the standard wire protocol due to<tr><td><a name="l39" href="#l39">39</a><td> * limitations in the various browser implementations of the CORS specification:<tr><td><a name="l40" href="#l40">40</a><td> * &lt;ul&gt;<tr><td><a name="l41" href="#l41">41</a><td> *   &lt;li&gt;IE&#39;s &lt;a href=&quot;http://goo.gl/6l3kA&quot;&gt;XDomainRequest&lt;/a&gt; object is only<tr><td><a name="l42" href="#l42">42</a><td> *     capable of generating the types of requests that may be generated through<tr><td><a name="l43" href="#l43">43</a><td> *     a standard &lt;a href=&quot;http://goo.gl/vgzAU&quot;&gt;HTML form&lt;/a&gt; - it can not send<tr><td><a name="l44" href="#l44">44</a><td> *     DELETE requests, as is required in the wire protocol.<tr><td><a name="l45" href="#l45">45</a><td> *   &lt;li&gt;WebKit&#39;s implementation of CORS does not follow the spec and forbids<tr><td><a name="l46" href="#l46">46</a><td> *     redirects: https://bugs.webkit.org/show_bug.cgi?id=57600<tr><td><a name="l47" href="#l47">47</a><td> *     This limitation appears to be intentional and is documented in WebKit&#39;s<tr><td><a name="l48" href="#l48">48</a><td> *     Layout tests:<tr><td><a name="l49" href="#l49">49</a><td> *     //LayoutTests/http/tests/xmlhttprequest/access-control-and-redirects.html<tr><td><a name="l50" href="#l50">50</a><td> *   &lt;li&gt;If the server does not return a 2xx response, IE and Opera&#39;s<tr><td><a name="l51" href="#l51">51</a><td> *     implementations will fire the XDomainRequest/XMLHttpRequest object&#39;s<tr><td><a name="l52" href="#l52">52</a><td> *     onerror handler, but without the corresponding response text returned by<tr><td><a name="l53" href="#l53">53</a><td> *     the server. This renders IE and Opera incapable of handling command<tr><td><a name="l54" href="#l54">54</a><td> *     failures in the standard JSON protocol.<tr><td><a name="l55" href="#l55">55</a><td> * &lt;/ul&gt;<tr><td><a name="l56" href="#l56">56</a><td> *<tr><td><a name="l57" href="#l57">57</a><td> * @param {string} url URL for the WebDriver server to send commands to.<tr><td><a name="l58" href="#l58">58</a><td> * @constructor<tr><td><a name="l59" href="#l59">59</a><td> * @implements {webdriver.http.Client}<tr><td><a name="l60" href="#l60">60</a><td> * @see &lt;a href=&quot;http://www.w3.org/TR/cors/&quot;&gt;CORS Spec&lt;/a&gt;<tr><td><a name="l61" href="#l61">61</a><td> * @see &lt;a href=&quot;http://code.google.com/p/selenium/wiki/JsonWireProtocol&quot;&gt;<tr><td><a name="l62" href="#l62">62</a><td> *     JSON wire protocol&lt;/a&gt;<tr><td><a name="l63" href="#l63">63</a><td> */<tr><td><a name="l64" href="#l64">64</a><td>webdriver.http.CorsClient = function(url) {<tr><td><a name="l65" href="#l65">65</a><td>  if (!webdriver.http.CorsClient.isAvailable()) {<tr><td><a name="l66" href="#l66">66</a><td>    throw Error(&#39;The current environment does not support cross-origin &#39; +<tr><td><a name="l67" href="#l67">67</a><td>        &#39;resource sharing&#39;);<tr><td><a name="l68" href="#l68">68</a><td>  }<tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td>  /** @private {string} */<tr><td><a name="l71" href="#l71">71</a><td>  this.url_ = url + webdriver.http.CorsClient.XDRPC_ENDPOINT;<tr><td><a name="l72" href="#l72">72</a><td>};<tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td>/**<tr><td><a name="l76" href="#l76">76</a><td> * Resource URL to send commands to on the server.<tr><td><a name="l77" href="#l77">77</a><td> * @type {string}<tr><td><a name="l78" href="#l78">78</a><td> * @const<tr><td><a name="l79" href="#l79">79</a><td> */<tr><td><a name="l80" href="#l80">80</a><td>webdriver.http.CorsClient.XDRPC_ENDPOINT = &#39;/xdrpc&#39;;<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td><tr><td><a name="l83" href="#l83">83</a><td>/**<tr><td><a name="l84" href="#l84">84</a><td> * Tests whether the current environment supports cross-origin resource sharing.<tr><td><a name="l85" href="#l85">85</a><td> * @return {boolean} Whether cross-origin resource sharing is supported.<tr><td><a name="l86" href="#l86">86</a><td> * @see http://www.w3.org/TR/cors/<tr><td><a name="l87" href="#l87">87</a><td> */<tr><td><a name="l88" href="#l88">88</a><td>webdriver.http.CorsClient.isAvailable = function() {<tr><td><a name="l89" href="#l89">89</a><td>  return typeof XDomainRequest !== &#39;undefined&#39; ||<tr><td><a name="l90" href="#l90">90</a><td>      (typeof XMLHttpRequest !== &#39;undefined&#39; &amp;&amp;<tr><td><a name="l91" href="#l91">91</a><td>          goog.isBoolean(new XMLHttpRequest().withCredentials));<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/** @override */<tr><td><a name="l96" href="#l96">96</a><td>webdriver.http.CorsClient.prototype.send = function(request, callback) {<tr><td><a name="l97" href="#l97">97</a><td>  try {<tr><td><a name="l98" href="#l98">98</a><td>    var xhr = new (typeof XDomainRequest !== &#39;undefined&#39; ?<tr><td><a name="l99" href="#l99">99</a><td>        XDomainRequest : XMLHttpRequest);<tr><td><a name="l100" href="#l100">100</a><td>    xhr.open(&#39;POST&#39;, this.url_, true);<tr><td><a name="l101" href="#l101">101</a><td><tr><td><a name="l102" href="#l102">102</a><td>    xhr.onload = function() {<tr><td><a name="l103" href="#l103">103</a><td>      callback(null, webdriver.http.Response.fromXmlHttpRequest(<tr><td><a name="l104" href="#l104">104</a><td>          /** @type {!XMLHttpRequest} */ (xhr)));<tr><td><a name="l105" href="#l105">105</a><td>    };<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td>    var url = this.url_;<tr><td><a name="l108" href="#l108">108</a><td>    xhr.onerror = function() {<tr><td><a name="l109" href="#l109">109</a><td>      callback(Error([<tr><td><a name="l110" href="#l110">110</a><td>        &#39;Unable to send request: POST &#39;, url,<tr><td><a name="l111" href="#l111">111</a><td>        &#39;\nPerhaps the server did not respond to the preflight request &#39;,<tr><td><a name="l112" href="#l112">112</a><td>        &#39;with valid access control headers?&#39;<tr><td><a name="l113" href="#l113">113</a><td>      ].join(&#39;&#39;)));<tr><td><a name="l114" href="#l114">114</a><td>    };<tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td>    // Define event handlers for all events on the XDomainRequest. Apparently,<tr><td><a name="l117" href="#l117">117</a><td>    // if we don&#39;t do this, IE9+10 will silently abort our request. Yay IE.<tr><td><a name="l118" href="#l118">118</a><td>    // Note, we&#39;re not using goog.nullFunction, because it tends to get<tr><td><a name="l119" href="#l119">119</a><td>    // optimized away by the compiler, which leaves us where we were before.<tr><td><a name="l120" href="#l120">120</a><td>    xhr.onprogress = xhr.ontimeout = function() {};<tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td>    xhr.send(goog.json.serialize({<tr><td><a name="l123" href="#l123">123</a><td>      &#39;method&#39;: request.method,<tr><td><a name="l124" href="#l124">124</a><td>      &#39;path&#39;: request.path,<tr><td><a name="l125" href="#l125">125</a><td>      &#39;data&#39;: request.data<tr><td><a name="l126" href="#l126">126</a><td>    }));<tr><td><a name="l127" href="#l127">127</a><td>  } catch (ex) {<tr><td><a name="l128" href="#l128">128</a><td>    callback(ex);<tr><td><a name="l129" href="#l129">129</a><td>  }<tr><td><a name="l130" href="#l130">130</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/http/http.js.src.html b/docs/source/lib/webdriver/http/http.js.src.html
index 291e8c3..2ac026c 100644
--- a/docs/source/lib/webdriver/http/http.js.src.html
+++ b/docs/source/lib/webdriver/http/http.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>http.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/http/http.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Defines a {@code webdriver.CommandExecutor} that communicates<tr><td><a name="l17" href="#l17">17</a><td> * with a server over HTTP.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;webdriver.http.Client&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;webdriver.http.Executor&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;webdriver.http.Request&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;webdriver.http.Response&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;bot.ErrorCode&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l28" href="#l28">28</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a name="l29" href="#l29">29</a><td>goog.require(&#39;webdriver.promise.Deferred&#39;);<tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td>/**<tr><td><a name="l34" href="#l34">34</a><td> * Interface used for sending individual HTTP requests to the server.<tr><td><a name="l35" href="#l35">35</a><td> * @interface<tr><td><a name="l36" href="#l36">36</a><td> */<tr><td><a name="l37" href="#l37">37</a><td>webdriver.http.Client = function() {<tr><td><a name="l38" href="#l38">38</a><td>};<tr><td><a name="l39" href="#l39">39</a><td><tr><td><a name="l40" href="#l40">40</a><td><tr><td><a name="l41" href="#l41">41</a><td>/**<tr><td><a name="l42" href="#l42">42</a><td> * Sends a request to the server. If an error occurs while sending the request,<tr><td><a name="l43" href="#l43">43</a><td> * such as a failure to connect to the server, the provided callback will be<tr><td><a name="l44" href="#l44">44</a><td> * invoked with a non-null {@code Error} describing the error. Otherwise, when<tr><td><a name="l45" href="#l45">45</a><td> * the server&#39;s response has been received, the callback will be invoked with a<tr><td><a name="l46" href="#l46">46</a><td> * null Error and non-null {@code webdriver.http.Response} object.<tr><td><a name="l47" href="#l47">47</a><td> *<tr><td><a name="l48" href="#l48">48</a><td> * @param {!webdriver.http.Request} request The request to send.<tr><td><a name="l49" href="#l49">49</a><td> * @param {function(Error, !webdriver.http.Response=)} callback the function to<tr><td><a name="l50" href="#l50">50</a><td> *     invoke when the server&#39;s response is ready.<tr><td><a name="l51" href="#l51">51</a><td> */<tr><td><a name="l52" href="#l52">52</a><td>webdriver.http.Client.prototype.send = function(request, callback) {<tr><td><a name="l53" href="#l53">53</a><td>};<tr><td><a name="l54" href="#l54">54</a><td><tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td>/**<tr><td><a name="l58" href="#l58">58</a><td> * A command executor that communicates with a server using the WebDriver<tr><td><a name="l59" href="#l59">59</a><td> * command protocol.<tr><td><a name="l60" href="#l60">60</a><td> * @param {!webdriver.http.Client} client The client to use when sending<tr><td><a name="l61" href="#l61">61</a><td> *     requests to the server.<tr><td><a name="l62" href="#l62">62</a><td> * @constructor<tr><td><a name="l63" href="#l63">63</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a name="l64" href="#l64">64</a><td> */<tr><td><a name="l65" href="#l65">65</a><td>webdriver.http.Executor = function(client) {<tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td>  /**<tr><td><a name="l68" href="#l68">68</a><td>   * Client used to communicate with the server.<tr><td><a name="l69" href="#l69">69</a><td>   * @private {!webdriver.http.Client}<tr><td><a name="l70" href="#l70">70</a><td>   */<tr><td><a name="l71" href="#l71">71</a><td>  this.client_ = client;<tr><td><a name="l72" href="#l72">72</a><td>};<tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td><tr><td><a name="l75" href="#l75">75</a><td>/** @override */<tr><td><a name="l76" href="#l76">76</a><td>webdriver.http.Executor.prototype.execute = function(command, callback) {<tr><td><a name="l77" href="#l77">77</a><td>  var resource = webdriver.http.Executor.COMMAND_MAP_[command.getName()];<tr><td><a name="l78" href="#l78">78</a><td>  if (!resource) {<tr><td><a name="l79" href="#l79">79</a><td>    throw new Error(&#39;Unrecognized command: &#39; + command.getName());<tr><td><a name="l80" href="#l80">80</a><td>  }<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td>  var parameters = command.getParameters();<tr><td><a name="l83" href="#l83">83</a><td>  var path = webdriver.http.Executor.buildPath_(resource.path, parameters);<tr><td><a name="l84" href="#l84">84</a><td>  var request = new webdriver.http.Request(resource.method, path, parameters);<tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td>  this.client_.send(request, function(e, response) {<tr><td><a name="l87" href="#l87">87</a><td>    var responseObj;<tr><td><a name="l88" href="#l88">88</a><td>    if (!e) {<tr><td><a name="l89" href="#l89">89</a><td>      try {<tr><td><a name="l90" href="#l90">90</a><td>        responseObj = webdriver.http.Executor.parseHttpResponse_(<tr><td><a name="l91" href="#l91">91</a><td>            /** @type {!webdriver.http.Response} */ (response));<tr><td><a name="l92" href="#l92">92</a><td>      } catch (ex) {<tr><td><a name="l93" href="#l93">93</a><td>        e = ex;<tr><td><a name="l94" href="#l94">94</a><td>      }<tr><td><a name="l95" href="#l95">95</a><td>    }<tr><td><a name="l96" href="#l96">96</a><td>    callback(e, responseObj);<tr><td><a name="l97" href="#l97">97</a><td>  });<tr><td><a name="l98" href="#l98">98</a><td>};<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td><tr><td><a name="l101" href="#l101">101</a><td>/**<tr><td><a name="l102" href="#l102">102</a><td> * Builds a fully qualified path using the given set of command parameters. Each<tr><td><a name="l103" href="#l103">103</a><td> * path segment prefixed with &#39;:&#39; will be replaced by the value of the<tr><td><a name="l104" href="#l104">104</a><td> * corresponding parameter. All parameters spliced into the path will be<tr><td><a name="l105" href="#l105">105</a><td> * removed from the parameter map.<tr><td><a name="l106" href="#l106">106</a><td> * @param {string} path The original resource path.<tr><td><a name="l107" href="#l107">107</a><td> * @param {!Object.&lt;*&gt;} parameters The parameters object to splice into<tr><td><a name="l108" href="#l108">108</a><td> *     the path.<tr><td><a name="l109" href="#l109">109</a><td> * @return {string} The modified path.<tr><td><a name="l110" href="#l110">110</a><td> * @private<tr><td><a name="l111" href="#l111">111</a><td> */<tr><td><a name="l112" href="#l112">112</a><td>webdriver.http.Executor.buildPath_ = function(path, parameters) {<tr><td><a name="l113" href="#l113">113</a><td>  var pathParameters = path.match(/\/:(\w+)\b/g);<tr><td><a name="l114" href="#l114">114</a><td>  if (pathParameters) {<tr><td><a name="l115" href="#l115">115</a><td>    for (var i = 0; i &lt; pathParameters.length; ++i) {<tr><td><a name="l116" href="#l116">116</a><td>      var key = pathParameters[i].substring(2);  // Trim the /:<tr><td><a name="l117" href="#l117">117</a><td>      if (key in parameters) {<tr><td><a name="l118" href="#l118">118</a><td>        var value = parameters[key];<tr><td><a name="l119" href="#l119">119</a><td>        // TODO: move webdriver.WebElement.ELEMENT definition to a<tr><td><a name="l120" href="#l120">120</a><td>        // common file so we can reference it here without pulling in all of<tr><td><a name="l121" href="#l121">121</a><td>        // webdriver.WebElement&#39;s dependencies.<tr><td><a name="l122" href="#l122">122</a><td>        if (value &amp;&amp; value[&#39;ELEMENT&#39;]) {<tr><td><a name="l123" href="#l123">123</a><td>          // When inserting a WebElement into the URL, only use its ID value,<tr><td><a name="l124" href="#l124">124</a><td>          // not the full JSON.<tr><td><a name="l125" href="#l125">125</a><td>          value = value[&#39;ELEMENT&#39;];<tr><td><a name="l126" href="#l126">126</a><td>        }<tr><td><a name="l127" href="#l127">127</a><td>        path = path.replace(pathParameters[i], &#39;/&#39; + value);<tr><td><a name="l128" href="#l128">128</a><td>        delete parameters[key];<tr><td><a name="l129" href="#l129">129</a><td>      } else {<tr><td><a name="l130" href="#l130">130</a><td>        throw new Error(&#39;Missing required parameter: &#39; + key);<tr><td><a name="l131" href="#l131">131</a><td>      }<tr><td><a name="l132" href="#l132">132</a><td>    }<tr><td><a name="l133" href="#l133">133</a><td>  }<tr><td><a name="l134" href="#l134">134</a><td>  return path;<tr><td><a name="l135" href="#l135">135</a><td>};<tr><td><a name="l136" href="#l136">136</a><td><tr><td><a name="l137" href="#l137">137</a><td><tr><td><a name="l138" href="#l138">138</a><td>/**<tr><td><a name="l139" href="#l139">139</a><td> * Callback used to parse {@link webdriver.http.Response} objects from a<tr><td><a name="l140" href="#l140">140</a><td> * {@link webdriver.http.Client}.<tr><td><a name="l141" href="#l141">141</a><td> * @param {!webdriver.http.Response} httpResponse The HTTP response to parse.<tr><td><a name="l142" href="#l142">142</a><td> * @return {!bot.response.ResponseObject} The parsed response.<tr><td><a name="l143" href="#l143">143</a><td> * @private<tr><td><a name="l144" href="#l144">144</a><td> */<tr><td><a name="l145" href="#l145">145</a><td>webdriver.http.Executor.parseHttpResponse_ = function(httpResponse) {<tr><td><a name="l146" href="#l146">146</a><td>  try {<tr><td><a name="l147" href="#l147">147</a><td>    return /** @type {!bot.response.ResponseObject} */ (goog.json.parse(<tr><td><a name="l148" href="#l148">148</a><td>        httpResponse.body));<tr><td><a name="l149" href="#l149">149</a><td>  } catch (ex) {<tr><td><a name="l150" href="#l150">150</a><td>    // Whoops, looks like the server sent us a malformed response. We&#39;ll need<tr><td><a name="l151" href="#l151">151</a><td>    // to manually build a response object based on the response code.<tr><td><a name="l152" href="#l152">152</a><td>  }<tr><td><a name="l153" href="#l153">153</a><td><tr><td><a name="l154" href="#l154">154</a><td>  var response = {<tr><td><a name="l155" href="#l155">155</a><td>    &#39;status&#39;: bot.ErrorCode.SUCCESS,<tr><td><a name="l156" href="#l156">156</a><td>    &#39;value&#39;: httpResponse.body.replace(/\r\n/g, &#39;\n&#39;)<tr><td><a name="l157" href="#l157">157</a><td>  };<tr><td><a name="l158" href="#l158">158</a><td><tr><td><a name="l159" href="#l159">159</a><td>  if (!(httpResponse.status &gt; 199 &amp;&amp; httpResponse.status &lt; 300)) {<tr><td><a name="l160" href="#l160">160</a><td>    // 404 represents an unknown command; anything else is a generic unknown<tr><td><a name="l161" href="#l161">161</a><td>    // error.<tr><td><a name="l162" href="#l162">162</a><td>    response[&#39;status&#39;] = httpResponse.status == 404 ?<tr><td><a name="l163" href="#l163">163</a><td>        bot.ErrorCode.UNKNOWN_COMMAND :<tr><td><a name="l164" href="#l164">164</a><td>        bot.ErrorCode.UNKNOWN_ERROR;<tr><td><a name="l165" href="#l165">165</a><td>  }<tr><td><a name="l166" href="#l166">166</a><td><tr><td><a name="l167" href="#l167">167</a><td>  return response;<tr><td><a name="l168" href="#l168">168</a><td>};<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/**<tr><td><a name="l172" href="#l172">172</a><td> * Maps command names to resource locator.<tr><td><a name="l173" href="#l173">173</a><td> * @private {!Object.&lt;{method:string, path:string}&gt;}<tr><td><a name="l174" href="#l174">174</a><td> * @const<tr><td><a name="l175" href="#l175">175</a><td> */<tr><td><a name="l176" href="#l176">176</a><td>webdriver.http.Executor.COMMAND_MAP_ = (function() {<tr><td><a name="l177" href="#l177">177</a><td>  return new Builder().<tr><td><a name="l178" href="#l178">178</a><td>      put(webdriver.CommandName.GET_SERVER_STATUS, get(&#39;/status&#39;)).<tr><td><a name="l179" href="#l179">179</a><td>      put(webdriver.CommandName.NEW_SESSION, post(&#39;/session&#39;)).<tr><td><a name="l180" href="#l180">180</a><td>      put(webdriver.CommandName.GET_SESSIONS, get(&#39;/sessions&#39;)).<tr><td><a name="l181" href="#l181">181</a><td>      put(webdriver.CommandName.DESCRIBE_SESSION, get(&#39;/session/:sessionId&#39;)).<tr><td><a name="l182" href="#l182">182</a><td>      put(webdriver.CommandName.QUIT, del(&#39;/session/:sessionId&#39;)).<tr><td><a name="l183" href="#l183">183</a><td>      put(webdriver.CommandName.CLOSE, del(&#39;/session/:sessionId/window&#39;)).<tr><td><a name="l184" href="#l184">184</a><td>      put(webdriver.CommandName.GET_CURRENT_WINDOW_HANDLE,<tr><td><a name="l185" href="#l185">185</a><td>          get(&#39;/session/:sessionId/window_handle&#39;)).<tr><td><a name="l186" href="#l186">186</a><td>      put(webdriver.CommandName.GET_WINDOW_HANDLES,<tr><td><a name="l187" href="#l187">187</a><td>          get(&#39;/session/:sessionId/window_handles&#39;)).<tr><td><a name="l188" href="#l188">188</a><td>      put(webdriver.CommandName.GET_CURRENT_URL,<tr><td><a name="l189" href="#l189">189</a><td>          get(&#39;/session/:sessionId/url&#39;)).<tr><td><a name="l190" href="#l190">190</a><td>      put(webdriver.CommandName.GET, post(&#39;/session/:sessionId/url&#39;)).<tr><td><a name="l191" href="#l191">191</a><td>      put(webdriver.CommandName.GO_BACK, post(&#39;/session/:sessionId/back&#39;)).<tr><td><a name="l192" href="#l192">192</a><td>      put(webdriver.CommandName.GO_FORWARD,<tr><td><a name="l193" href="#l193">193</a><td>          post(&#39;/session/:sessionId/forward&#39;)).<tr><td><a name="l194" href="#l194">194</a><td>      put(webdriver.CommandName.REFRESH,<tr><td><a name="l195" href="#l195">195</a><td>          post(&#39;/session/:sessionId/refresh&#39;)).<tr><td><a name="l196" href="#l196">196</a><td>      put(webdriver.CommandName.ADD_COOKIE,<tr><td><a name="l197" href="#l197">197</a><td>          post(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a name="l198" href="#l198">198</a><td>      put(webdriver.CommandName.GET_ALL_COOKIES,<tr><td><a name="l199" href="#l199">199</a><td>          get(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a name="l200" href="#l200">200</a><td>      put(webdriver.CommandName.DELETE_ALL_COOKIES,<tr><td><a name="l201" href="#l201">201</a><td>          del(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a name="l202" href="#l202">202</a><td>      put(webdriver.CommandName.DELETE_COOKIE,<tr><td><a name="l203" href="#l203">203</a><td>          del(&#39;/session/:sessionId/cookie/:name&#39;)).<tr><td><a name="l204" href="#l204">204</a><td>      put(webdriver.CommandName.FIND_ELEMENT,<tr><td><a name="l205" href="#l205">205</a><td>          post(&#39;/session/:sessionId/element&#39;)).<tr><td><a name="l206" href="#l206">206</a><td>      put(webdriver.CommandName.FIND_ELEMENTS,<tr><td><a name="l207" href="#l207">207</a><td>          post(&#39;/session/:sessionId/elements&#39;)).<tr><td><a name="l208" href="#l208">208</a><td>      put(webdriver.CommandName.GET_ACTIVE_ELEMENT,<tr><td><a name="l209" href="#l209">209</a><td>          post(&#39;/session/:sessionId/element/active&#39;)).<tr><td><a name="l210" href="#l210">210</a><td>      put(webdriver.CommandName.FIND_CHILD_ELEMENT,<tr><td><a name="l211" href="#l211">211</a><td>          post(&#39;/session/:sessionId/element/:id/element&#39;)).<tr><td><a name="l212" href="#l212">212</a><td>      put(webdriver.CommandName.FIND_CHILD_ELEMENTS,<tr><td><a name="l213" href="#l213">213</a><td>          post(&#39;/session/:sessionId/element/:id/elements&#39;)).<tr><td><a name="l214" href="#l214">214</a><td>      put(webdriver.CommandName.CLEAR_ELEMENT,<tr><td><a name="l215" href="#l215">215</a><td>          post(&#39;/session/:sessionId/element/:id/clear&#39;)).<tr><td><a name="l216" href="#l216">216</a><td>      put(webdriver.CommandName.CLICK_ELEMENT,<tr><td><a name="l217" href="#l217">217</a><td>          post(&#39;/session/:sessionId/element/:id/click&#39;)).<tr><td><a name="l218" href="#l218">218</a><td>      put(webdriver.CommandName.SEND_KEYS_TO_ELEMENT,<tr><td><a name="l219" href="#l219">219</a><td>          post(&#39;/session/:sessionId/element/:id/value&#39;)).<tr><td><a name="l220" href="#l220">220</a><td>      put(webdriver.CommandName.SUBMIT_ELEMENT,<tr><td><a name="l221" href="#l221">221</a><td>          post(&#39;/session/:sessionId/element/:id/submit&#39;)).<tr><td><a name="l222" href="#l222">222</a><td>      put(webdriver.CommandName.GET_ELEMENT_TEXT,<tr><td><a name="l223" href="#l223">223</a><td>          get(&#39;/session/:sessionId/element/:id/text&#39;)).<tr><td><a name="l224" href="#l224">224</a><td>      put(webdriver.CommandName.GET_ELEMENT_TAG_NAME,<tr><td><a name="l225" href="#l225">225</a><td>          get(&#39;/session/:sessionId/element/:id/name&#39;)).<tr><td><a name="l226" href="#l226">226</a><td>      put(webdriver.CommandName.IS_ELEMENT_SELECTED,<tr><td><a name="l227" href="#l227">227</a><td>          get(&#39;/session/:sessionId/element/:id/selected&#39;)).<tr><td><a name="l228" href="#l228">228</a><td>      put(webdriver.CommandName.IS_ELEMENT_ENABLED,<tr><td><a name="l229" href="#l229">229</a><td>          get(&#39;/session/:sessionId/element/:id/enabled&#39;)).<tr><td><a name="l230" href="#l230">230</a><td>      put(webdriver.CommandName.IS_ELEMENT_DISPLAYED,<tr><td><a name="l231" href="#l231">231</a><td>          get(&#39;/session/:sessionId/element/:id/displayed&#39;)).<tr><td><a name="l232" href="#l232">232</a><td>      put(webdriver.CommandName.GET_ELEMENT_LOCATION,<tr><td><a name="l233" href="#l233">233</a><td>          get(&#39;/session/:sessionId/element/:id/location&#39;)).<tr><td><a name="l234" href="#l234">234</a><td>      put(webdriver.CommandName.GET_ELEMENT_SIZE,<tr><td><a name="l235" href="#l235">235</a><td>          get(&#39;/session/:sessionId/element/:id/size&#39;)).<tr><td><a name="l236" href="#l236">236</a><td>      put(webdriver.CommandName.GET_ELEMENT_ATTRIBUTE,<tr><td><a name="l237" href="#l237">237</a><td>          get(&#39;/session/:sessionId/element/:id/attribute/:name&#39;)).<tr><td><a name="l238" href="#l238">238</a><td>      put(webdriver.CommandName.GET_ELEMENT_VALUE_OF_CSS_PROPERTY,<tr><td><a name="l239" href="#l239">239</a><td>          get(&#39;/session/:sessionId/element/:id/css/:propertyName&#39;)).<tr><td><a name="l240" href="#l240">240</a><td>      put(webdriver.CommandName.ELEMENT_EQUALS,<tr><td><a name="l241" href="#l241">241</a><td>          get(&#39;/session/:sessionId/element/:id/equals/:other&#39;)).<tr><td><a name="l242" href="#l242">242</a><td>      put(webdriver.CommandName.SWITCH_TO_WINDOW,<tr><td><a name="l243" href="#l243">243</a><td>          post(&#39;/session/:sessionId/window&#39;)).<tr><td><a name="l244" href="#l244">244</a><td>      put(webdriver.CommandName.MAXIMIZE_WINDOW,<tr><td><a name="l245" href="#l245">245</a><td>          post(&#39;/session/:sessionId/window/:windowHandle/maximize&#39;)).<tr><td><a name="l246" href="#l246">246</a><td>      put(webdriver.CommandName.GET_WINDOW_POSITION,<tr><td><a name="l247" href="#l247">247</a><td>          get(&#39;/session/:sessionId/window/:windowHandle/position&#39;)).<tr><td><a name="l248" href="#l248">248</a><td>      put(webdriver.CommandName.SET_WINDOW_POSITION,<tr><td><a name="l249" href="#l249">249</a><td>          post(&#39;/session/:sessionId/window/:windowHandle/position&#39;)).<tr><td><a name="l250" href="#l250">250</a><td>      put(webdriver.CommandName.GET_WINDOW_SIZE,<tr><td><a name="l251" href="#l251">251</a><td>          get(&#39;/session/:sessionId/window/:windowHandle/size&#39;)).<tr><td><a name="l252" href="#l252">252</a><td>      put(webdriver.CommandName.SET_WINDOW_SIZE,<tr><td><a name="l253" href="#l253">253</a><td>          post(&#39;/session/:sessionId/window/:windowHandle/size&#39;)).<tr><td><a name="l254" href="#l254">254</a><td>      put(webdriver.CommandName.SWITCH_TO_FRAME,<tr><td><a name="l255" href="#l255">255</a><td>          post(&#39;/session/:sessionId/frame&#39;)).<tr><td><a name="l256" href="#l256">256</a><td>      put(webdriver.CommandName.GET_PAGE_SOURCE,<tr><td><a name="l257" href="#l257">257</a><td>          get(&#39;/session/:sessionId/source&#39;)).<tr><td><a name="l258" href="#l258">258</a><td>      put(webdriver.CommandName.GET_TITLE,<tr><td><a name="l259" href="#l259">259</a><td>          get(&#39;/session/:sessionId/title&#39;)).<tr><td><a name="l260" href="#l260">260</a><td>      put(webdriver.CommandName.EXECUTE_SCRIPT,<tr><td><a name="l261" href="#l261">261</a><td>          post(&#39;/session/:sessionId/execute&#39;)).<tr><td><a name="l262" href="#l262">262</a><td>      put(webdriver.CommandName.EXECUTE_ASYNC_SCRIPT,<tr><td><a name="l263" href="#l263">263</a><td>          post(&#39;/session/:sessionId/execute_async&#39;)).<tr><td><a name="l264" href="#l264">264</a><td>      put(webdriver.CommandName.SCREENSHOT,<tr><td><a name="l265" href="#l265">265</a><td>          get(&#39;/session/:sessionId/screenshot&#39;)).<tr><td><a name="l266" href="#l266">266</a><td>      put(webdriver.CommandName.SET_TIMEOUT,<tr><td><a name="l267" href="#l267">267</a><td>          post(&#39;/session/:sessionId/timeouts&#39;)).<tr><td><a name="l268" href="#l268">268</a><td>      put(webdriver.CommandName.SET_SCRIPT_TIMEOUT,<tr><td><a name="l269" href="#l269">269</a><td>          post(&#39;/session/:sessionId/timeouts/async_script&#39;)).<tr><td><a name="l270" href="#l270">270</a><td>      put(webdriver.CommandName.IMPLICITLY_WAIT,<tr><td><a name="l271" href="#l271">271</a><td>          post(&#39;/session/:sessionId/timeouts/implicit_wait&#39;)).<tr><td><a name="l272" href="#l272">272</a><td>      put(webdriver.CommandName.MOVE_TO, post(&#39;/session/:sessionId/moveto&#39;)).<tr><td><a name="l273" href="#l273">273</a><td>      put(webdriver.CommandName.CLICK, post(&#39;/session/:sessionId/click&#39;)).<tr><td><a name="l274" href="#l274">274</a><td>      put(webdriver.CommandName.DOUBLE_CLICK,<tr><td><a name="l275" href="#l275">275</a><td>          post(&#39;/session/:sessionId/doubleclick&#39;)).<tr><td><a name="l276" href="#l276">276</a><td>      put(webdriver.CommandName.MOUSE_DOWN,<tr><td><a name="l277" href="#l277">277</a><td>          post(&#39;/session/:sessionId/buttondown&#39;)).<tr><td><a name="l278" href="#l278">278</a><td>      put(webdriver.CommandName.MOUSE_UP, post(&#39;/session/:sessionId/buttonup&#39;)).<tr><td><a name="l279" href="#l279">279</a><td>      put(webdriver.CommandName.MOVE_TO, post(&#39;/session/:sessionId/moveto&#39;)).<tr><td><a name="l280" href="#l280">280</a><td>      put(webdriver.CommandName.SEND_KEYS_TO_ACTIVE_ELEMENT,<tr><td><a name="l281" href="#l281">281</a><td>          post(&#39;/session/:sessionId/keys&#39;)).<tr><td><a name="l282" href="#l282">282</a><td>      put(webdriver.CommandName.ACCEPT_ALERT,<tr><td><a name="l283" href="#l283">283</a><td>          post(&#39;/session/:sessionId/accept_alert&#39;)).<tr><td><a name="l284" href="#l284">284</a><td>      put(webdriver.CommandName.DISMISS_ALERT,<tr><td><a name="l285" href="#l285">285</a><td>          post(&#39;/session/:sessionId/dismiss_alert&#39;)).<tr><td><a name="l286" href="#l286">286</a><td>      put(webdriver.CommandName.GET_ALERT_TEXT,<tr><td><a name="l287" href="#l287">287</a><td>          get(&#39;/session/:sessionId/alert_text&#39;)).<tr><td><a name="l288" href="#l288">288</a><td>      put(webdriver.CommandName.SET_ALERT_TEXT,<tr><td><a name="l289" href="#l289">289</a><td>          post(&#39;/session/:sessionId/alert_text&#39;)).<tr><td><a name="l290" href="#l290">290</a><td>      put(webdriver.CommandName.GET_LOG, post(&#39;/session/:sessionId/log&#39;)).<tr><td><a name="l291" href="#l291">291</a><td>      put(webdriver.CommandName.GET_AVAILABLE_LOG_TYPES,<tr><td><a name="l292" href="#l292">292</a><td>          get(&#39;/session/:sessionId/log/types&#39;)).<tr><td><a name="l293" href="#l293">293</a><td>      put(webdriver.CommandName.GET_SESSION_LOGS, post(&#39;/logs&#39;)).<tr><td><a name="l294" href="#l294">294</a><td>      build();<tr><td><a name="l295" href="#l295">295</a><td><tr><td><a name="l296" href="#l296">296</a><td>  /** @constructor */<tr><td><a name="l297" href="#l297">297</a><td>  function Builder() {<tr><td><a name="l298" href="#l298">298</a><td>    var map = {};<tr><td><a name="l299" href="#l299">299</a><td><tr><td><a name="l300" href="#l300">300</a><td>    this.put = function(name, resource) {<tr><td><a name="l301" href="#l301">301</a><td>      map[name] = resource;<tr><td><a name="l302" href="#l302">302</a><td>      return this;<tr><td><a name="l303" href="#l303">303</a><td>    };<tr><td><a name="l304" href="#l304">304</a><td><tr><td><a name="l305" href="#l305">305</a><td>    this.build = function() {<tr><td><a name="l306" href="#l306">306</a><td>      return map;<tr><td><a name="l307" href="#l307">307</a><td>    };<tr><td><a name="l308" href="#l308">308</a><td>  }<tr><td><a name="l309" href="#l309">309</a><td><tr><td><a name="l310" href="#l310">310</a><td>  function post(path) { return resource(&#39;POST&#39;, path); }<tr><td><a name="l311" href="#l311">311</a><td>  function del(path)  { return resource(&#39;DELETE&#39;, path); }<tr><td><a name="l312" href="#l312">312</a><td>  function get(path)  { return resource(&#39;GET&#39;, path); }<tr><td><a name="l313" href="#l313">313</a><td>  function resource(method, path) { return {method: method, path: path}; }<tr><td><a name="l314" href="#l314">314</a><td>})();<tr><td><a name="l315" href="#l315">315</a><td><tr><td><a name="l316" href="#l316">316</a><td><tr><td><a name="l317" href="#l317">317</a><td>/**<tr><td><a name="l318" href="#l318">318</a><td> * Converts a headers object to a HTTP header block string.<tr><td><a name="l319" href="#l319">319</a><td> * @param {!Object.&lt;string&gt;} headers The headers object to convert.<tr><td><a name="l320" href="#l320">320</a><td> * @return {string} The headers as a string.<tr><td><a name="l321" href="#l321">321</a><td> * @private<tr><td><a name="l322" href="#l322">322</a><td> */<tr><td><a name="l323" href="#l323">323</a><td>webdriver.http.headersToString_ = function(headers) {<tr><td><a name="l324" href="#l324">324</a><td>  var ret = [];<tr><td><a name="l325" href="#l325">325</a><td>  for (var key in headers) {<tr><td><a name="l326" href="#l326">326</a><td>    ret.push(key + &#39;: &#39; + headers[key]);<tr><td><a name="l327" href="#l327">327</a><td>  }<tr><td><a name="l328" href="#l328">328</a><td>  return ret.join(&#39;\n&#39;);<tr><td><a name="l329" href="#l329">329</a><td>};<tr><td><a name="l330" href="#l330">330</a><td><tr><td><a name="l331" href="#l331">331</a><td><tr><td><a name="l332" href="#l332">332</a><td><tr><td><a name="l333" href="#l333">333</a><td>/**<tr><td><a name="l334" href="#l334">334</a><td> * Describes a partial HTTP request. This class is a &quot;partial&quot; request and only<tr><td><a name="l335" href="#l335">335</a><td> * defines the path on the server to send a request to. It is each<tr><td><a name="l336" href="#l336">336</a><td> * {@code webdriver.http.Client}&#39;s responsibility to build the full URL for the<tr><td><a name="l337" href="#l337">337</a><td> * final request.<tr><td><a name="l338" href="#l338">338</a><td> * @param {string} method The HTTP method to use for the request.<tr><td><a name="l339" href="#l339">339</a><td> * @param {string} path Path on the server to send the request to.<tr><td><a name="l340" href="#l340">340</a><td> * @param {Object=} opt_data This request&#39;s JSON data.<tr><td><a name="l341" href="#l341">341</a><td> * @constructor<tr><td><a name="l342" href="#l342">342</a><td> */<tr><td><a name="l343" href="#l343">343</a><td>webdriver.http.Request = function(method, path, opt_data) {<tr><td><a name="l344" href="#l344">344</a><td><tr><td><a name="l345" href="#l345">345</a><td>  /**<tr><td><a name="l346" href="#l346">346</a><td>   * The HTTP method to use for the request.<tr><td><a name="l347" href="#l347">347</a><td>   * @type {string}<tr><td><a name="l348" href="#l348">348</a><td>   */<tr><td><a name="l349" href="#l349">349</a><td>  this.method = method;<tr><td><a name="l350" href="#l350">350</a><td><tr><td><a name="l351" href="#l351">351</a><td>  /**<tr><td><a name="l352" href="#l352">352</a><td>   * The path on the server to send the request to.<tr><td><a name="l353" href="#l353">353</a><td>   * @type {string}<tr><td><a name="l354" href="#l354">354</a><td>   */<tr><td><a name="l355" href="#l355">355</a><td>  this.path = path;<tr><td><a name="l356" href="#l356">356</a><td><tr><td><a name="l357" href="#l357">357</a><td>  /**<tr><td><a name="l358" href="#l358">358</a><td>   * This request&#39;s body.<tr><td><a name="l359" href="#l359">359</a><td>   * @type {!Object}<tr><td><a name="l360" href="#l360">360</a><td>   */<tr><td><a name="l361" href="#l361">361</a><td>  this.data = opt_data || {};<tr><td><a name="l362" href="#l362">362</a><td><tr><td><a name="l363" href="#l363">363</a><td>  /**<tr><td><a name="l364" href="#l364">364</a><td>   * The headers to send with the request.<tr><td><a name="l365" href="#l365">365</a><td>   * @type {!Object.&lt;(string|number)&gt;}<tr><td><a name="l366" href="#l366">366</a><td>   */<tr><td><a name="l367" href="#l367">367</a><td>  this.headers = {&#39;Accept&#39;: &#39;application/json; charset=utf-8&#39;};<tr><td><a name="l368" href="#l368">368</a><td>};<tr><td><a name="l369" href="#l369">369</a><td><tr><td><a name="l370" href="#l370">370</a><td><tr><td><a name="l371" href="#l371">371</a><td>/** @override */<tr><td><a name="l372" href="#l372">372</a><td>webdriver.http.Request.prototype.toString = function() {<tr><td><a name="l373" href="#l373">373</a><td>  return [<tr><td><a name="l374" href="#l374">374</a><td>    this.method + &#39; &#39; + this.path + &#39; HTTP/1.1&#39;,<tr><td><a name="l375" href="#l375">375</a><td>    webdriver.http.headersToString_(this.headers),<tr><td><a name="l376" href="#l376">376</a><td>    &#39;&#39;,<tr><td><a name="l377" href="#l377">377</a><td>    goog.json.serialize(this.data)<tr><td><a name="l378" href="#l378">378</a><td>  ].join(&#39;\n&#39;);<tr><td><a name="l379" href="#l379">379</a><td>};<tr><td><a name="l380" href="#l380">380</a><td><tr><td><a name="l381" href="#l381">381</a><td><tr><td><a name="l382" href="#l382">382</a><td><tr><td><a name="l383" href="#l383">383</a><td>/**<tr><td><a name="l384" href="#l384">384</a><td> * Represents a HTTP response.<tr><td><a name="l385" href="#l385">385</a><td> * @param {number} status The response code.<tr><td><a name="l386" href="#l386">386</a><td> * @param {!Object.&lt;string&gt;} headers The response headers. All header<tr><td><a name="l387" href="#l387">387</a><td> *     names will be converted to lowercase strings for consistent lookups.<tr><td><a name="l388" href="#l388">388</a><td> * @param {string} body The response body.<tr><td><a name="l389" href="#l389">389</a><td> * @constructor<tr><td><a name="l390" href="#l390">390</a><td> */<tr><td><a name="l391" href="#l391">391</a><td>webdriver.http.Response = function(status, headers, body) {<tr><td><a name="l392" href="#l392">392</a><td><tr><td><a name="l393" href="#l393">393</a><td>  /**<tr><td><a name="l394" href="#l394">394</a><td>   * The HTTP response code.<tr><td><a name="l395" href="#l395">395</a><td>   * @type {number}<tr><td><a name="l396" href="#l396">396</a><td>   */<tr><td><a name="l397" href="#l397">397</a><td>  this.status = status;<tr><td><a name="l398" href="#l398">398</a><td><tr><td><a name="l399" href="#l399">399</a><td>  /**<tr><td><a name="l400" href="#l400">400</a><td>   * The response body.<tr><td><a name="l401" href="#l401">401</a><td>   * @type {string}<tr><td><a name="l402" href="#l402">402</a><td>   */<tr><td><a name="l403" href="#l403">403</a><td>  this.body = body;<tr><td><a name="l404" href="#l404">404</a><td><tr><td><a name="l405" href="#l405">405</a><td>  /**<tr><td><a name="l406" href="#l406">406</a><td>   * The response body.<tr><td><a name="l407" href="#l407">407</a><td>   * @type {!Object.&lt;string&gt;}<tr><td><a name="l408" href="#l408">408</a><td>   */<tr><td><a name="l409" href="#l409">409</a><td>  this.headers = {};<tr><td><a name="l410" href="#l410">410</a><td>  for (var header in headers) {<tr><td><a name="l411" href="#l411">411</a><td>    this.headers[header.toLowerCase()] = headers[header];<tr><td><a name="l412" href="#l412">412</a><td>  }<tr><td><a name="l413" href="#l413">413</a><td>};<tr><td><a name="l414" href="#l414">414</a><td><tr><td><a name="l415" href="#l415">415</a><td><tr><td><a name="l416" href="#l416">416</a><td>/**<tr><td><a name="l417" href="#l417">417</a><td> * Builds a {@code webdriver.http.Response} from a {@code XMLHttpRequest} or<tr><td><a name="l418" href="#l418">418</a><td> * {@code XDomainRequest} response object.<tr><td><a name="l419" href="#l419">419</a><td> * @param {!(XDomainRequest|XMLHttpRequest)} xhr The request to parse.<tr><td><a name="l420" href="#l420">420</a><td> * @return {!webdriver.http.Response} The parsed response.<tr><td><a name="l421" href="#l421">421</a><td> */<tr><td><a name="l422" href="#l422">422</a><td>webdriver.http.Response.fromXmlHttpRequest = function(xhr) {<tr><td><a name="l423" href="#l423">423</a><td>  var headers = {};<tr><td><a name="l424" href="#l424">424</a><td><tr><td><a name="l425" href="#l425">425</a><td>  // getAllResponseHeaders is only available on XMLHttpRequest objects.<tr><td><a name="l426" href="#l426">426</a><td>  if (xhr.getAllResponseHeaders) {<tr><td><a name="l427" href="#l427">427</a><td>    var tmp = xhr.getAllResponseHeaders();<tr><td><a name="l428" href="#l428">428</a><td>    if (tmp) {<tr><td><a name="l429" href="#l429">429</a><td>      tmp = tmp.replace(/\r\n/g, &#39;\n&#39;).split(&#39;\n&#39;);<tr><td><a name="l430" href="#l430">430</a><td>      goog.array.forEach(tmp, function(header) {<tr><td><a name="l431" href="#l431">431</a><td>        var parts = header.split(/\s*:\s*/, 2);<tr><td><a name="l432" href="#l432">432</a><td>        if (parts[0]) {<tr><td><a name="l433" href="#l433">433</a><td>          headers[parts[0]] = parts[1] || &#39;&#39;;<tr><td><a name="l434" href="#l434">434</a><td>        }<tr><td><a name="l435" href="#l435">435</a><td>      });<tr><td><a name="l436" href="#l436">436</a><td>    }<tr><td><a name="l437" href="#l437">437</a><td>  }<tr><td><a name="l438" href="#l438">438</a><td><tr><td><a name="l439" href="#l439">439</a><td>  // If xhr is a XDomainRequest object, it will not have a status.<tr><td><a name="l440" href="#l440">440</a><td>  // However, if we&#39;re parsing the response from a XDomainRequest, then<tr><td><a name="l441" href="#l441">441</a><td>  // that request must have been a success, so we can assume status == 200.<tr><td><a name="l442" href="#l442">442</a><td>  var status = xhr.status || 200;<tr><td><a name="l443" href="#l443">443</a><td>  return new webdriver.http.Response(status, headers,<tr><td><a name="l444" href="#l444">444</a><td>      xhr.responseText.replace(/\0/g, &#39;&#39;));<tr><td><a name="l445" href="#l445">445</a><td>};<tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td><tr><td><a name="l448" href="#l448">448</a><td>/** @override */<tr><td><a name="l449" href="#l449">449</a><td>webdriver.http.Response.prototype.toString = function() {<tr><td><a name="l450" href="#l450">450</a><td>  var headers = webdriver.http.headersToString_(this.headers);<tr><td><a name="l451" href="#l451">451</a><td>  var ret = [&#39;HTTP/1.1 &#39; + this.status, headers];<tr><td><a name="l452" href="#l452">452</a><td><tr><td><a name="l453" href="#l453">453</a><td>  if (headers) {<tr><td><a name="l454" href="#l454">454</a><td>    ret.push(&#39;&#39;);<tr><td><a name="l455" href="#l455">455</a><td>  }<tr><td><a name="l456" href="#l456">456</a><td><tr><td><a name="l457" href="#l457">457</a><td>  if (this.body) {<tr><td><a name="l458" href="#l458">458</a><td>    ret.push(this.body);<tr><td><a name="l459" href="#l459">459</a><td>  }<tr><td><a name="l460" href="#l460">460</a><td><tr><td><a name="l461" href="#l461">461</a><td>  return ret.join(&#39;\n&#39;);<tr><td><a name="l462" href="#l462">462</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>http.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/webdriver/http/http.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines a {@code webdriver.CommandExecutor} that communicates<tr><td><a id="l20"></a><a href="#l20">20</a><td> * with a server over HTTP.<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>goog.provide(&#39;webdriver.http.Client&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.http.Executor&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;webdriver.http.Request&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;webdriver.http.Response&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td><tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;bot.ErrorCode&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;webdriver.CommandExecutor&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;webdriver.logging&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;webdriver.promise&#39;);<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>/**<tr><td><a id="l38"></a><a href="#l38">38</a><td> * Interface used for sending individual HTTP requests to the server.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @interface<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>webdriver.http.Client = function() {<tr><td><a id="l42"></a><a href="#l42">42</a><td>};<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td><tr><td><a id="l45"></a><a href="#l45">45</a><td>/**<tr><td><a id="l46"></a><a href="#l46">46</a><td> * Sends a request to the server. If an error occurs while sending the request,<tr><td><a id="l47"></a><a href="#l47">47</a><td> * such as a failure to connect to the server, the provided callback will be<tr><td><a id="l48"></a><a href="#l48">48</a><td> * invoked with a non-null {@link Error} describing the error. Otherwise, when<tr><td><a id="l49"></a><a href="#l49">49</a><td> * the server&#39;s response has been received, the callback will be invoked with a<tr><td><a id="l50"></a><a href="#l50">50</a><td> * null Error and non-null {@link webdriver.http.Response} object.<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * @param {!webdriver.http.Request} request The request to send.<tr><td><a id="l53"></a><a href="#l53">53</a><td> * @param {function(Error, !webdriver.http.Response=)} callback the function to<tr><td><a id="l54"></a><a href="#l54">54</a><td> *     invoke when the server&#39;s response is ready.<tr><td><a id="l55"></a><a href="#l55">55</a><td> */<tr><td><a id="l56"></a><a href="#l56">56</a><td>webdriver.http.Client.prototype.send = function(request, callback) {<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>/**<tr><td><a id="l62"></a><a href="#l62">62</a><td> * A command executor that communicates with a server using the WebDriver<tr><td><a id="l63"></a><a href="#l63">63</a><td> * command protocol.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @param {!webdriver.http.Client} client The client to use when sending<tr><td><a id="l65"></a><a href="#l65">65</a><td> *     requests to the server.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @constructor<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>webdriver.http.Executor = function(client) {<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>   * Client used to communicate with the server.<tr><td><a id="l73"></a><a href="#l73">73</a><td>   * @private {!webdriver.http.Client}<tr><td><a id="l74"></a><a href="#l74">74</a><td>   */<tr><td><a id="l75"></a><a href="#l75">75</a><td>  this.client_ = client;<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>  /**<tr><td><a id="l78"></a><a href="#l78">78</a><td>   * @private {!Object&lt;{method:string, path:string}&gt;}<tr><td><a id="l79"></a><a href="#l79">79</a><td>   */<tr><td><a id="l80"></a><a href="#l80">80</a><td>  this.customCommands_ = {};<tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>  /**<tr><td><a id="l83"></a><a href="#l83">83</a><td>   * @private {!webdriver.logging.Logger}<tr><td><a id="l84"></a><a href="#l84">84</a><td>   */<tr><td><a id="l85"></a><a href="#l85">85</a><td>  this.log_ = webdriver.logging.getLogger(&#39;webdriver.http.Executor&#39;);<tr><td><a id="l86"></a><a href="#l86">86</a><td>};<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> * Defines a new command for use with this executor. When a command is sent,<tr><td><a id="l91"></a><a href="#l91">91</a><td> * the {@code path} will be preprocessed using the command&#39;s parameters; any<tr><td><a id="l92"></a><a href="#l92">92</a><td> * path segments prefixed with &quot;:&quot; will be replaced by the parameter of the<tr><td><a id="l93"></a><a href="#l93">93</a><td> * same name. For example, given &quot;/person/:name&quot; and the parameters<tr><td><a id="l94"></a><a href="#l94">94</a><td> * &quot;{name: &#39;Bob&#39;}&quot;, the final command path will be &quot;/person/Bob&quot;.<tr><td><a id="l95"></a><a href="#l95">95</a><td> *<tr><td><a id="l96"></a><a href="#l96">96</a><td> * @param {string} name The command name.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @param {string} method The HTTP method to use when sending this command.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @param {string} path The path to send the command to, relative to<tr><td><a id="l99"></a><a href="#l99">99</a><td> *     the WebDriver server&#39;s command root and of the form<tr><td><a id="l100"></a><a href="#l100">100</a><td> *     &quot;/path/:variable/segment&quot;.<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>webdriver.http.Executor.prototype.defineCommand = function(<tr><td><a id="l103"></a><a href="#l103">103</a><td>    name, method, path) {<tr><td><a id="l104"></a><a href="#l104">104</a><td>  this.customCommands_[name] = {method: method, path: path};<tr><td><a id="l105"></a><a href="#l105">105</a><td>};<tr><td><a id="l106"></a><a href="#l106">106</a><td><tr><td><a id="l107"></a><a href="#l107">107</a><td><tr><td><a id="l108"></a><a href="#l108">108</a><td>/** @override */<tr><td><a id="l109"></a><a href="#l109">109</a><td>webdriver.http.Executor.prototype.execute = function(command, callback) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>  var resource =<tr><td><a id="l111"></a><a href="#l111">111</a><td>      this.customCommands_[command.getName()] ||<tr><td><a id="l112"></a><a href="#l112">112</a><td>      webdriver.http.Executor.COMMAND_MAP_[command.getName()];<tr><td><a id="l113"></a><a href="#l113">113</a><td>  if (!resource) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>    throw new Error(&#39;Unrecognized command: &#39; + command.getName());<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>  var parameters = command.getParameters();<tr><td><a id="l118"></a><a href="#l118">118</a><td>  var path = webdriver.http.Executor.buildPath_(resource.path, parameters);<tr><td><a id="l119"></a><a href="#l119">119</a><td>  var request = new webdriver.http.Request(resource.method, path, parameters);<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>  var log = this.log_;<tr><td><a id="l122"></a><a href="#l122">122</a><td>  log.finer(function() {<tr><td><a id="l123"></a><a href="#l123">123</a><td>    return &#39;&gt;&gt;&gt;\n&#39; + request;<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>  this.client_.send(request, function(e, response) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>    var responseObj;<tr><td><a id="l128"></a><a href="#l128">128</a><td>    if (!e) {<tr><td><a id="l129"></a><a href="#l129">129</a><td>      log.finer(function() {<tr><td><a id="l130"></a><a href="#l130">130</a><td>        return &#39;&lt;&lt;&lt;\n&#39; + response;<tr><td><a id="l131"></a><a href="#l131">131</a><td>      });<tr><td><a id="l132"></a><a href="#l132">132</a><td>      try {<tr><td><a id="l133"></a><a href="#l133">133</a><td>        responseObj = webdriver.http.Executor.parseHttpResponse_(<tr><td><a id="l134"></a><a href="#l134">134</a><td>            /** @type {!webdriver.http.Response} */ (response));<tr><td><a id="l135"></a><a href="#l135">135</a><td>      } catch (ex) {<tr><td><a id="l136"></a><a href="#l136">136</a><td>        log.warning(&#39;Error parsing response&#39;, ex);<tr><td><a id="l137"></a><a href="#l137">137</a><td>        e = ex;<tr><td><a id="l138"></a><a href="#l138">138</a><td>      }<tr><td><a id="l139"></a><a href="#l139">139</a><td>    }<tr><td><a id="l140"></a><a href="#l140">140</a><td>    callback(e, responseObj);<tr><td><a id="l141"></a><a href="#l141">141</a><td>  });<tr><td><a id="l142"></a><a href="#l142">142</a><td>};<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> * Builds a fully qualified path using the given set of command parameters. Each<tr><td><a id="l147"></a><a href="#l147">147</a><td> * path segment prefixed with &#39;:&#39; will be replaced by the value of the<tr><td><a id="l148"></a><a href="#l148">148</a><td> * corresponding parameter. All parameters spliced into the path will be<tr><td><a id="l149"></a><a href="#l149">149</a><td> * removed from the parameter map.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @param {string} path The original resource path.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {!Object.&lt;*&gt;} parameters The parameters object to splice into<tr><td><a id="l152"></a><a href="#l152">152</a><td> *     the path.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @return {string} The modified path.<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @private<tr><td><a id="l155"></a><a href="#l155">155</a><td> */<tr><td><a id="l156"></a><a href="#l156">156</a><td>webdriver.http.Executor.buildPath_ = function(path, parameters) {<tr><td><a id="l157"></a><a href="#l157">157</a><td>  var pathParameters = path.match(/\/:(\w+)\b/g);<tr><td><a id="l158"></a><a href="#l158">158</a><td>  if (pathParameters) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>    for (var i = 0; i &lt; pathParameters.length; ++i) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>      var key = pathParameters[i].substring(2);  // Trim the /:<tr><td><a id="l161"></a><a href="#l161">161</a><td>      if (key in parameters) {<tr><td><a id="l162"></a><a href="#l162">162</a><td>        var value = parameters[key];<tr><td><a id="l163"></a><a href="#l163">163</a><td>        // TODO: move webdriver.WebElement.ELEMENT definition to a<tr><td><a id="l164"></a><a href="#l164">164</a><td>        // common file so we can reference it here without pulling in all of<tr><td><a id="l165"></a><a href="#l165">165</a><td>        // webdriver.WebElement&#39;s dependencies.<tr><td><a id="l166"></a><a href="#l166">166</a><td>        if (value &amp;&amp; value[&#39;ELEMENT&#39;]) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>          // When inserting a WebElement into the URL, only use its ID value,<tr><td><a id="l168"></a><a href="#l168">168</a><td>          // not the full JSON.<tr><td><a id="l169"></a><a href="#l169">169</a><td>          value = value[&#39;ELEMENT&#39;];<tr><td><a id="l170"></a><a href="#l170">170</a><td>        }<tr><td><a id="l171"></a><a href="#l171">171</a><td>        path = path.replace(pathParameters[i], &#39;/&#39; + value);<tr><td><a id="l172"></a><a href="#l172">172</a><td>        delete parameters[key];<tr><td><a id="l173"></a><a href="#l173">173</a><td>      } else {<tr><td><a id="l174"></a><a href="#l174">174</a><td>        throw new Error(&#39;Missing required parameter: &#39; + key);<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>  return path;<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><tr><td><a id="l182"></a><a href="#l182">182</a><td>/**<tr><td><a id="l183"></a><a href="#l183">183</a><td> * Callback used to parse {@link webdriver.http.Response} objects from a<tr><td><a id="l184"></a><a href="#l184">184</a><td> * {@link webdriver.http.Client}.<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @param {!webdriver.http.Response} httpResponse The HTTP response to parse.<tr><td><a id="l186"></a><a href="#l186">186</a><td> * @return {!bot.response.ResponseObject} The parsed response.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @private<tr><td><a id="l188"></a><a href="#l188">188</a><td> */<tr><td><a id="l189"></a><a href="#l189">189</a><td>webdriver.http.Executor.parseHttpResponse_ = function(httpResponse) {<tr><td><a id="l190"></a><a href="#l190">190</a><td>  try {<tr><td><a id="l191"></a><a href="#l191">191</a><td>    return /** @type {!bot.response.ResponseObject} */ (JSON.parse(<tr><td><a id="l192"></a><a href="#l192">192</a><td>        httpResponse.body));<tr><td><a id="l193"></a><a href="#l193">193</a><td>  } catch (ex) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>    // Whoops, looks like the server sent us a malformed response. We&#39;ll need<tr><td><a id="l195"></a><a href="#l195">195</a><td>    // to manually build a response object based on the response code.<tr><td><a id="l196"></a><a href="#l196">196</a><td>  }<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>  var response = {<tr><td><a id="l199"></a><a href="#l199">199</a><td>    &#39;status&#39;: bot.ErrorCode.SUCCESS,<tr><td><a id="l200"></a><a href="#l200">200</a><td>    &#39;value&#39;: httpResponse.body.replace(/\r\n/g, &#39;\n&#39;)<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>  if (!(httpResponse.status &gt; 199 &amp;&amp; httpResponse.status &lt; 300)) {<tr><td><a id="l204"></a><a href="#l204">204</a><td>    // 404 represents an unknown command; anything else is a generic unknown<tr><td><a id="l205"></a><a href="#l205">205</a><td>    // error.<tr><td><a id="l206"></a><a href="#l206">206</a><td>    response[&#39;status&#39;] = httpResponse.status == 404 ?<tr><td><a id="l207"></a><a href="#l207">207</a><td>        bot.ErrorCode.UNKNOWN_COMMAND :<tr><td><a id="l208"></a><a href="#l208">208</a><td>        bot.ErrorCode.UNKNOWN_ERROR;<tr><td><a id="l209"></a><a href="#l209">209</a><td>  }<tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>  return response;<tr><td><a id="l212"></a><a href="#l212">212</a><td>};<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * Maps command names to resource locator.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @private {!Object.&lt;{method:string, path:string}&gt;}<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @const<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>webdriver.http.Executor.COMMAND_MAP_ = (function() {<tr><td><a id="l221"></a><a href="#l221">221</a><td>  return new Builder().<tr><td><a id="l222"></a><a href="#l222">222</a><td>      put(webdriver.CommandName.GET_SERVER_STATUS, get(&#39;/status&#39;)).<tr><td><a id="l223"></a><a href="#l223">223</a><td>      put(webdriver.CommandName.NEW_SESSION, post(&#39;/session&#39;)).<tr><td><a id="l224"></a><a href="#l224">224</a><td>      put(webdriver.CommandName.GET_SESSIONS, get(&#39;/sessions&#39;)).<tr><td><a id="l225"></a><a href="#l225">225</a><td>      put(webdriver.CommandName.DESCRIBE_SESSION, get(&#39;/session/:sessionId&#39;)).<tr><td><a id="l226"></a><a href="#l226">226</a><td>      put(webdriver.CommandName.QUIT, del(&#39;/session/:sessionId&#39;)).<tr><td><a id="l227"></a><a href="#l227">227</a><td>      put(webdriver.CommandName.CLOSE, del(&#39;/session/:sessionId/window&#39;)).<tr><td><a id="l228"></a><a href="#l228">228</a><td>      put(webdriver.CommandName.GET_CURRENT_WINDOW_HANDLE,<tr><td><a id="l229"></a><a href="#l229">229</a><td>          get(&#39;/session/:sessionId/window_handle&#39;)).<tr><td><a id="l230"></a><a href="#l230">230</a><td>      put(webdriver.CommandName.GET_WINDOW_HANDLES,<tr><td><a id="l231"></a><a href="#l231">231</a><td>          get(&#39;/session/:sessionId/window_handles&#39;)).<tr><td><a id="l232"></a><a href="#l232">232</a><td>      put(webdriver.CommandName.GET_CURRENT_URL,<tr><td><a id="l233"></a><a href="#l233">233</a><td>          get(&#39;/session/:sessionId/url&#39;)).<tr><td><a id="l234"></a><a href="#l234">234</a><td>      put(webdriver.CommandName.GET, post(&#39;/session/:sessionId/url&#39;)).<tr><td><a id="l235"></a><a href="#l235">235</a><td>      put(webdriver.CommandName.GO_BACK, post(&#39;/session/:sessionId/back&#39;)).<tr><td><a id="l236"></a><a href="#l236">236</a><td>      put(webdriver.CommandName.GO_FORWARD,<tr><td><a id="l237"></a><a href="#l237">237</a><td>          post(&#39;/session/:sessionId/forward&#39;)).<tr><td><a id="l238"></a><a href="#l238">238</a><td>      put(webdriver.CommandName.REFRESH,<tr><td><a id="l239"></a><a href="#l239">239</a><td>          post(&#39;/session/:sessionId/refresh&#39;)).<tr><td><a id="l240"></a><a href="#l240">240</a><td>      put(webdriver.CommandName.ADD_COOKIE,<tr><td><a id="l241"></a><a href="#l241">241</a><td>          post(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a id="l242"></a><a href="#l242">242</a><td>      put(webdriver.CommandName.GET_ALL_COOKIES,<tr><td><a id="l243"></a><a href="#l243">243</a><td>          get(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a id="l244"></a><a href="#l244">244</a><td>      put(webdriver.CommandName.DELETE_ALL_COOKIES,<tr><td><a id="l245"></a><a href="#l245">245</a><td>          del(&#39;/session/:sessionId/cookie&#39;)).<tr><td><a id="l246"></a><a href="#l246">246</a><td>      put(webdriver.CommandName.DELETE_COOKIE,<tr><td><a id="l247"></a><a href="#l247">247</a><td>          del(&#39;/session/:sessionId/cookie/:name&#39;)).<tr><td><a id="l248"></a><a href="#l248">248</a><td>      put(webdriver.CommandName.FIND_ELEMENT,<tr><td><a id="l249"></a><a href="#l249">249</a><td>          post(&#39;/session/:sessionId/element&#39;)).<tr><td><a id="l250"></a><a href="#l250">250</a><td>      put(webdriver.CommandName.FIND_ELEMENTS,<tr><td><a id="l251"></a><a href="#l251">251</a><td>          post(&#39;/session/:sessionId/elements&#39;)).<tr><td><a id="l252"></a><a href="#l252">252</a><td>      put(webdriver.CommandName.GET_ACTIVE_ELEMENT,<tr><td><a id="l253"></a><a href="#l253">253</a><td>          post(&#39;/session/:sessionId/element/active&#39;)).<tr><td><a id="l254"></a><a href="#l254">254</a><td>      put(webdriver.CommandName.FIND_CHILD_ELEMENT,<tr><td><a id="l255"></a><a href="#l255">255</a><td>          post(&#39;/session/:sessionId/element/:id/element&#39;)).<tr><td><a id="l256"></a><a href="#l256">256</a><td>      put(webdriver.CommandName.FIND_CHILD_ELEMENTS,<tr><td><a id="l257"></a><a href="#l257">257</a><td>          post(&#39;/session/:sessionId/element/:id/elements&#39;)).<tr><td><a id="l258"></a><a href="#l258">258</a><td>      put(webdriver.CommandName.CLEAR_ELEMENT,<tr><td><a id="l259"></a><a href="#l259">259</a><td>          post(&#39;/session/:sessionId/element/:id/clear&#39;)).<tr><td><a id="l260"></a><a href="#l260">260</a><td>      put(webdriver.CommandName.CLICK_ELEMENT,<tr><td><a id="l261"></a><a href="#l261">261</a><td>          post(&#39;/session/:sessionId/element/:id/click&#39;)).<tr><td><a id="l262"></a><a href="#l262">262</a><td>      put(webdriver.CommandName.SEND_KEYS_TO_ELEMENT,<tr><td><a id="l263"></a><a href="#l263">263</a><td>          post(&#39;/session/:sessionId/element/:id/value&#39;)).<tr><td><a id="l264"></a><a href="#l264">264</a><td>      put(webdriver.CommandName.SUBMIT_ELEMENT,<tr><td><a id="l265"></a><a href="#l265">265</a><td>          post(&#39;/session/:sessionId/element/:id/submit&#39;)).<tr><td><a id="l266"></a><a href="#l266">266</a><td>      put(webdriver.CommandName.GET_ELEMENT_TEXT,<tr><td><a id="l267"></a><a href="#l267">267</a><td>          get(&#39;/session/:sessionId/element/:id/text&#39;)).<tr><td><a id="l268"></a><a href="#l268">268</a><td>      put(webdriver.CommandName.GET_ELEMENT_TAG_NAME,<tr><td><a id="l269"></a><a href="#l269">269</a><td>          get(&#39;/session/:sessionId/element/:id/name&#39;)).<tr><td><a id="l270"></a><a href="#l270">270</a><td>      put(webdriver.CommandName.IS_ELEMENT_SELECTED,<tr><td><a id="l271"></a><a href="#l271">271</a><td>          get(&#39;/session/:sessionId/element/:id/selected&#39;)).<tr><td><a id="l272"></a><a href="#l272">272</a><td>      put(webdriver.CommandName.IS_ELEMENT_ENABLED,<tr><td><a id="l273"></a><a href="#l273">273</a><td>          get(&#39;/session/:sessionId/element/:id/enabled&#39;)).<tr><td><a id="l274"></a><a href="#l274">274</a><td>      put(webdriver.CommandName.IS_ELEMENT_DISPLAYED,<tr><td><a id="l275"></a><a href="#l275">275</a><td>          get(&#39;/session/:sessionId/element/:id/displayed&#39;)).<tr><td><a id="l276"></a><a href="#l276">276</a><td>      put(webdriver.CommandName.GET_ELEMENT_LOCATION,<tr><td><a id="l277"></a><a href="#l277">277</a><td>          get(&#39;/session/:sessionId/element/:id/location&#39;)).<tr><td><a id="l278"></a><a href="#l278">278</a><td>      put(webdriver.CommandName.GET_ELEMENT_SIZE,<tr><td><a id="l279"></a><a href="#l279">279</a><td>          get(&#39;/session/:sessionId/element/:id/size&#39;)).<tr><td><a id="l280"></a><a href="#l280">280</a><td>      put(webdriver.CommandName.GET_ELEMENT_ATTRIBUTE,<tr><td><a id="l281"></a><a href="#l281">281</a><td>          get(&#39;/session/:sessionId/element/:id/attribute/:name&#39;)).<tr><td><a id="l282"></a><a href="#l282">282</a><td>      put(webdriver.CommandName.GET_ELEMENT_VALUE_OF_CSS_PROPERTY,<tr><td><a id="l283"></a><a href="#l283">283</a><td>          get(&#39;/session/:sessionId/element/:id/css/:propertyName&#39;)).<tr><td><a id="l284"></a><a href="#l284">284</a><td>      put(webdriver.CommandName.ELEMENT_EQUALS,<tr><td><a id="l285"></a><a href="#l285">285</a><td>          get(&#39;/session/:sessionId/element/:id/equals/:other&#39;)).<tr><td><a id="l286"></a><a href="#l286">286</a><td>      put(webdriver.CommandName.SWITCH_TO_WINDOW,<tr><td><a id="l287"></a><a href="#l287">287</a><td>          post(&#39;/session/:sessionId/window&#39;)).<tr><td><a id="l288"></a><a href="#l288">288</a><td>      put(webdriver.CommandName.MAXIMIZE_WINDOW,<tr><td><a id="l289"></a><a href="#l289">289</a><td>          post(&#39;/session/:sessionId/window/:windowHandle/maximize&#39;)).<tr><td><a id="l290"></a><a href="#l290">290</a><td>      put(webdriver.CommandName.GET_WINDOW_POSITION,<tr><td><a id="l291"></a><a href="#l291">291</a><td>          get(&#39;/session/:sessionId/window/:windowHandle/position&#39;)).<tr><td><a id="l292"></a><a href="#l292">292</a><td>      put(webdriver.CommandName.SET_WINDOW_POSITION,<tr><td><a id="l293"></a><a href="#l293">293</a><td>          post(&#39;/session/:sessionId/window/:windowHandle/position&#39;)).<tr><td><a id="l294"></a><a href="#l294">294</a><td>      put(webdriver.CommandName.GET_WINDOW_SIZE,<tr><td><a id="l295"></a><a href="#l295">295</a><td>          get(&#39;/session/:sessionId/window/:windowHandle/size&#39;)).<tr><td><a id="l296"></a><a href="#l296">296</a><td>      put(webdriver.CommandName.SET_WINDOW_SIZE,<tr><td><a id="l297"></a><a href="#l297">297</a><td>          post(&#39;/session/:sessionId/window/:windowHandle/size&#39;)).<tr><td><a id="l298"></a><a href="#l298">298</a><td>      put(webdriver.CommandName.SWITCH_TO_FRAME,<tr><td><a id="l299"></a><a href="#l299">299</a><td>          post(&#39;/session/:sessionId/frame&#39;)).<tr><td><a id="l300"></a><a href="#l300">300</a><td>      put(webdriver.CommandName.GET_PAGE_SOURCE,<tr><td><a id="l301"></a><a href="#l301">301</a><td>          get(&#39;/session/:sessionId/source&#39;)).<tr><td><a id="l302"></a><a href="#l302">302</a><td>      put(webdriver.CommandName.GET_TITLE,<tr><td><a id="l303"></a><a href="#l303">303</a><td>          get(&#39;/session/:sessionId/title&#39;)).<tr><td><a id="l304"></a><a href="#l304">304</a><td>      put(webdriver.CommandName.EXECUTE_SCRIPT,<tr><td><a id="l305"></a><a href="#l305">305</a><td>          post(&#39;/session/:sessionId/execute&#39;)).<tr><td><a id="l306"></a><a href="#l306">306</a><td>      put(webdriver.CommandName.EXECUTE_ASYNC_SCRIPT,<tr><td><a id="l307"></a><a href="#l307">307</a><td>          post(&#39;/session/:sessionId/execute_async&#39;)).<tr><td><a id="l308"></a><a href="#l308">308</a><td>      put(webdriver.CommandName.SCREENSHOT,<tr><td><a id="l309"></a><a href="#l309">309</a><td>          get(&#39;/session/:sessionId/screenshot&#39;)).<tr><td><a id="l310"></a><a href="#l310">310</a><td>      put(webdriver.CommandName.SET_TIMEOUT,<tr><td><a id="l311"></a><a href="#l311">311</a><td>          post(&#39;/session/:sessionId/timeouts&#39;)).<tr><td><a id="l312"></a><a href="#l312">312</a><td>      put(webdriver.CommandName.SET_SCRIPT_TIMEOUT,<tr><td><a id="l313"></a><a href="#l313">313</a><td>          post(&#39;/session/:sessionId/timeouts/async_script&#39;)).<tr><td><a id="l314"></a><a href="#l314">314</a><td>      put(webdriver.CommandName.IMPLICITLY_WAIT,<tr><td><a id="l315"></a><a href="#l315">315</a><td>          post(&#39;/session/:sessionId/timeouts/implicit_wait&#39;)).<tr><td><a id="l316"></a><a href="#l316">316</a><td>      put(webdriver.CommandName.MOVE_TO, post(&#39;/session/:sessionId/moveto&#39;)).<tr><td><a id="l317"></a><a href="#l317">317</a><td>      put(webdriver.CommandName.CLICK, post(&#39;/session/:sessionId/click&#39;)).<tr><td><a id="l318"></a><a href="#l318">318</a><td>      put(webdriver.CommandName.DOUBLE_CLICK,<tr><td><a id="l319"></a><a href="#l319">319</a><td>          post(&#39;/session/:sessionId/doubleclick&#39;)).<tr><td><a id="l320"></a><a href="#l320">320</a><td>      put(webdriver.CommandName.MOUSE_DOWN,<tr><td><a id="l321"></a><a href="#l321">321</a><td>          post(&#39;/session/:sessionId/buttondown&#39;)).<tr><td><a id="l322"></a><a href="#l322">322</a><td>      put(webdriver.CommandName.MOUSE_UP, post(&#39;/session/:sessionId/buttonup&#39;)).<tr><td><a id="l323"></a><a href="#l323">323</a><td>      put(webdriver.CommandName.MOVE_TO, post(&#39;/session/:sessionId/moveto&#39;)).<tr><td><a id="l324"></a><a href="#l324">324</a><td>      put(webdriver.CommandName.SEND_KEYS_TO_ACTIVE_ELEMENT,<tr><td><a id="l325"></a><a href="#l325">325</a><td>          post(&#39;/session/:sessionId/keys&#39;)).<tr><td><a id="l326"></a><a href="#l326">326</a><td>      put(webdriver.CommandName.TOUCH_SINGLE_TAP,<tr><td><a id="l327"></a><a href="#l327">327</a><td>          post(&#39;/session/:sessionId/touch/click&#39;)).<tr><td><a id="l328"></a><a href="#l328">328</a><td>      put(webdriver.CommandName.TOUCH_DOUBLE_TAP,<tr><td><a id="l329"></a><a href="#l329">329</a><td>          post(&#39;/session/:sessionId/touch/doubleclick&#39;)).<tr><td><a id="l330"></a><a href="#l330">330</a><td>      put(webdriver.CommandName.TOUCH_DOWN,<tr><td><a id="l331"></a><a href="#l331">331</a><td>          post(&#39;/session/:sessionId/touch/down&#39;)).<tr><td><a id="l332"></a><a href="#l332">332</a><td>      put(webdriver.CommandName.TOUCH_UP,<tr><td><a id="l333"></a><a href="#l333">333</a><td>          post(&#39;/session/:sessionId/touch/up&#39;)).<tr><td><a id="l334"></a><a href="#l334">334</a><td>      put(webdriver.CommandName.TOUCH_MOVE,<tr><td><a id="l335"></a><a href="#l335">335</a><td>          post(&#39;/session/:sessionId/touch/move&#39;)).<tr><td><a id="l336"></a><a href="#l336">336</a><td>      put(webdriver.CommandName.TOUCH_SCROLL,<tr><td><a id="l337"></a><a href="#l337">337</a><td>          post(&#39;/session/:sessionId/touch/scroll&#39;)).<tr><td><a id="l338"></a><a href="#l338">338</a><td>      put(webdriver.CommandName.TOUCH_LONG_PRESS,<tr><td><a id="l339"></a><a href="#l339">339</a><td>          post(&#39;/session/:sessionId/touch/longclick&#39;)).<tr><td><a id="l340"></a><a href="#l340">340</a><td>      put(webdriver.CommandName.TOUCH_FLICK,<tr><td><a id="l341"></a><a href="#l341">341</a><td>          post(&#39;/session/:sessionId/touch/flick&#39;)).<tr><td><a id="l342"></a><a href="#l342">342</a><td>      put(webdriver.CommandName.ACCEPT_ALERT,<tr><td><a id="l343"></a><a href="#l343">343</a><td>          post(&#39;/session/:sessionId/accept_alert&#39;)).<tr><td><a id="l344"></a><a href="#l344">344</a><td>      put(webdriver.CommandName.DISMISS_ALERT,<tr><td><a id="l345"></a><a href="#l345">345</a><td>          post(&#39;/session/:sessionId/dismiss_alert&#39;)).<tr><td><a id="l346"></a><a href="#l346">346</a><td>      put(webdriver.CommandName.GET_ALERT_TEXT,<tr><td><a id="l347"></a><a href="#l347">347</a><td>          get(&#39;/session/:sessionId/alert_text&#39;)).<tr><td><a id="l348"></a><a href="#l348">348</a><td>      put(webdriver.CommandName.SET_ALERT_TEXT,<tr><td><a id="l349"></a><a href="#l349">349</a><td>          post(&#39;/session/:sessionId/alert_text&#39;)).<tr><td><a id="l350"></a><a href="#l350">350</a><td>      put(webdriver.CommandName.GET_LOG, post(&#39;/session/:sessionId/log&#39;)).<tr><td><a id="l351"></a><a href="#l351">351</a><td>      put(webdriver.CommandName.GET_AVAILABLE_LOG_TYPES,<tr><td><a id="l352"></a><a href="#l352">352</a><td>          get(&#39;/session/:sessionId/log/types&#39;)).<tr><td><a id="l353"></a><a href="#l353">353</a><td>      put(webdriver.CommandName.GET_SESSION_LOGS, post(&#39;/logs&#39;)).<tr><td><a id="l354"></a><a href="#l354">354</a><td>      put(webdriver.CommandName.UPLOAD_FILE, post(&#39;/session/:sessionId/file&#39;)).<tr><td><a id="l355"></a><a href="#l355">355</a><td>      build();<tr><td><a id="l356"></a><a href="#l356">356</a><td><tr><td><a id="l357"></a><a href="#l357">357</a><td>  /** @constructor */<tr><td><a id="l358"></a><a href="#l358">358</a><td>  function Builder() {<tr><td><a id="l359"></a><a href="#l359">359</a><td>    var map = {};<tr><td><a id="l360"></a><a href="#l360">360</a><td><tr><td><a id="l361"></a><a href="#l361">361</a><td>    this.put = function(name, resource) {<tr><td><a id="l362"></a><a href="#l362">362</a><td>      map[name] = resource;<tr><td><a id="l363"></a><a href="#l363">363</a><td>      return this;<tr><td><a id="l364"></a><a href="#l364">364</a><td>    };<tr><td><a id="l365"></a><a href="#l365">365</a><td><tr><td><a id="l366"></a><a href="#l366">366</a><td>    this.build = function() {<tr><td><a id="l367"></a><a href="#l367">367</a><td>      return map;<tr><td><a id="l368"></a><a href="#l368">368</a><td>    };<tr><td><a id="l369"></a><a href="#l369">369</a><td>  }<tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td>  function post(path) { return resource(&#39;POST&#39;, path); }<tr><td><a id="l372"></a><a href="#l372">372</a><td>  function del(path)  { return resource(&#39;DELETE&#39;, path); }<tr><td><a id="l373"></a><a href="#l373">373</a><td>  function get(path)  { return resource(&#39;GET&#39;, path); }<tr><td><a id="l374"></a><a href="#l374">374</a><td>  function resource(method, path) { return {method: method, path: path}; }<tr><td><a id="l375"></a><a href="#l375">375</a><td>})();<tr><td><a id="l376"></a><a href="#l376">376</a><td><tr><td><a id="l377"></a><a href="#l377">377</a><td><tr><td><a id="l378"></a><a href="#l378">378</a><td>/**<tr><td><a id="l379"></a><a href="#l379">379</a><td> * Converts a headers object to a HTTP header block string.<tr><td><a id="l380"></a><a href="#l380">380</a><td> * @param {!Object.&lt;string&gt;} headers The headers object to convert.<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @return {string} The headers as a string.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @private<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>webdriver.http.headersToString_ = function(headers) {<tr><td><a id="l385"></a><a href="#l385">385</a><td>  var ret = [];<tr><td><a id="l386"></a><a href="#l386">386</a><td>  for (var key in headers) {<tr><td><a id="l387"></a><a href="#l387">387</a><td>    ret.push(key + &#39;: &#39; + headers[key]);<tr><td><a id="l388"></a><a href="#l388">388</a><td>  }<tr><td><a id="l389"></a><a href="#l389">389</a><td>  return ret.join(&#39;\n&#39;);<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><tr><td><a id="l394"></a><a href="#l394">394</a><td>/**<tr><td><a id="l395"></a><a href="#l395">395</a><td> * Describes a partial HTTP request. This class is a &quot;partial&quot; request and only<tr><td><a id="l396"></a><a href="#l396">396</a><td> * defines the path on the server to send a request to. It is each<tr><td><a id="l397"></a><a href="#l397">397</a><td> * {@link webdriver.http.Client}&#39;s responsibility to build the full URL for the<tr><td><a id="l398"></a><a href="#l398">398</a><td> * final request.<tr><td><a id="l399"></a><a href="#l399">399</a><td> * @param {string} method The HTTP method to use for the request.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @param {string} path Path on the server to send the request to.<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @param {Object=} opt_data This request&#39;s JSON data.<tr><td><a id="l402"></a><a href="#l402">402</a><td> * @constructor<tr><td><a id="l403"></a><a href="#l403">403</a><td> */<tr><td><a id="l404"></a><a href="#l404">404</a><td>webdriver.http.Request = function(method, path, opt_data) {<tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td>  /**<tr><td><a id="l407"></a><a href="#l407">407</a><td>   * The HTTP method to use for the request.<tr><td><a id="l408"></a><a href="#l408">408</a><td>   * @type {string}<tr><td><a id="l409"></a><a href="#l409">409</a><td>   */<tr><td><a id="l410"></a><a href="#l410">410</a><td>  this.method = method;<tr><td><a id="l411"></a><a href="#l411">411</a><td><tr><td><a id="l412"></a><a href="#l412">412</a><td>  /**<tr><td><a id="l413"></a><a href="#l413">413</a><td>   * The path on the server to send the request to.<tr><td><a id="l414"></a><a href="#l414">414</a><td>   * @type {string}<tr><td><a id="l415"></a><a href="#l415">415</a><td>   */<tr><td><a id="l416"></a><a href="#l416">416</a><td>  this.path = path;<tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td>  /**<tr><td><a id="l419"></a><a href="#l419">419</a><td>   * This request&#39;s body.<tr><td><a id="l420"></a><a href="#l420">420</a><td>   * @type {!Object}<tr><td><a id="l421"></a><a href="#l421">421</a><td>   */<tr><td><a id="l422"></a><a href="#l422">422</a><td>  this.data = opt_data || {};<tr><td><a id="l423"></a><a href="#l423">423</a><td><tr><td><a id="l424"></a><a href="#l424">424</a><td>  /**<tr><td><a id="l425"></a><a href="#l425">425</a><td>   * The headers to send with the request.<tr><td><a id="l426"></a><a href="#l426">426</a><td>   * @type {!Object.&lt;(string|number)&gt;}<tr><td><a id="l427"></a><a href="#l427">427</a><td>   */<tr><td><a id="l428"></a><a href="#l428">428</a><td>  this.headers = {&#39;Accept&#39;: &#39;application/json; charset=utf-8&#39;};<tr><td><a id="l429"></a><a href="#l429">429</a><td>};<tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td><tr><td><a id="l432"></a><a href="#l432">432</a><td>/** @override */<tr><td><a id="l433"></a><a href="#l433">433</a><td>webdriver.http.Request.prototype.toString = function() {<tr><td><a id="l434"></a><a href="#l434">434</a><td>  return [<tr><td><a id="l435"></a><a href="#l435">435</a><td>    this.method + &#39; &#39; + this.path + &#39; HTTP/1.1&#39;,<tr><td><a id="l436"></a><a href="#l436">436</a><td>    webdriver.http.headersToString_(this.headers),<tr><td><a id="l437"></a><a href="#l437">437</a><td>    &#39;&#39;,<tr><td><a id="l438"></a><a href="#l438">438</a><td>    JSON.stringify(this.data)<tr><td><a id="l439"></a><a href="#l439">439</a><td>  ].join(&#39;\n&#39;);<tr><td><a id="l440"></a><a href="#l440">440</a><td>};<tr><td><a id="l441"></a><a href="#l441">441</a><td><tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td><tr><td><a id="l444"></a><a href="#l444">444</a><td>/**<tr><td><a id="l445"></a><a href="#l445">445</a><td> * Represents a HTTP response.<tr><td><a id="l446"></a><a href="#l446">446</a><td> * @param {number} status The response code.<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {!Object.&lt;string&gt;} headers The response headers. All header<tr><td><a id="l448"></a><a href="#l448">448</a><td> *     names will be converted to lowercase strings for consistent lookups.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @param {string} body The response body.<tr><td><a id="l450"></a><a href="#l450">450</a><td> * @constructor<tr><td><a id="l451"></a><a href="#l451">451</a><td> */<tr><td><a id="l452"></a><a href="#l452">452</a><td>webdriver.http.Response = function(status, headers, body) {<tr><td><a id="l453"></a><a href="#l453">453</a><td><tr><td><a id="l454"></a><a href="#l454">454</a><td>  /**<tr><td><a id="l455"></a><a href="#l455">455</a><td>   * The HTTP response code.<tr><td><a id="l456"></a><a href="#l456">456</a><td>   * @type {number}<tr><td><a id="l457"></a><a href="#l457">457</a><td>   */<tr><td><a id="l458"></a><a href="#l458">458</a><td>  this.status = status;<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>   * The response body.<tr><td><a id="l462"></a><a href="#l462">462</a><td>   * @type {string}<tr><td><a id="l463"></a><a href="#l463">463</a><td>   */<tr><td><a id="l464"></a><a href="#l464">464</a><td>  this.body = body;<tr><td><a id="l465"></a><a href="#l465">465</a><td><tr><td><a id="l466"></a><a href="#l466">466</a><td>  /**<tr><td><a id="l467"></a><a href="#l467">467</a><td>   * The response body.<tr><td><a id="l468"></a><a href="#l468">468</a><td>   * @type {!Object.&lt;string&gt;}<tr><td><a id="l469"></a><a href="#l469">469</a><td>   */<tr><td><a id="l470"></a><a href="#l470">470</a><td>  this.headers = {};<tr><td><a id="l471"></a><a href="#l471">471</a><td>  for (var header in headers) {<tr><td><a id="l472"></a><a href="#l472">472</a><td>    this.headers[header.toLowerCase()] = headers[header];<tr><td><a id="l473"></a><a href="#l473">473</a><td>  }<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><tr><td><a id="l477"></a><a href="#l477">477</a><td>/**<tr><td><a id="l478"></a><a href="#l478">478</a><td> * Builds a {@link webdriver.http.Response} from a {@link XMLHttpRequest} or<tr><td><a id="l479"></a><a href="#l479">479</a><td> * {@link XDomainRequest} response object.<tr><td><a id="l480"></a><a href="#l480">480</a><td> * @param {!(XDomainRequest|XMLHttpRequest)} xhr The request to parse.<tr><td><a id="l481"></a><a href="#l481">481</a><td> * @return {!webdriver.http.Response} The parsed response.<tr><td><a id="l482"></a><a href="#l482">482</a><td> */<tr><td><a id="l483"></a><a href="#l483">483</a><td>webdriver.http.Response.fromXmlHttpRequest = function(xhr) {<tr><td><a id="l484"></a><a href="#l484">484</a><td>  var headers = {};<tr><td><a id="l485"></a><a href="#l485">485</a><td><tr><td><a id="l486"></a><a href="#l486">486</a><td>  // getAllResponseHeaders is only available on XMLHttpRequest objects.<tr><td><a id="l487"></a><a href="#l487">487</a><td>  if (xhr.getAllResponseHeaders) {<tr><td><a id="l488"></a><a href="#l488">488</a><td>    var tmp = xhr.getAllResponseHeaders();<tr><td><a id="l489"></a><a href="#l489">489</a><td>    if (tmp) {<tr><td><a id="l490"></a><a href="#l490">490</a><td>      tmp = tmp.replace(/\r\n/g, &#39;\n&#39;).split(&#39;\n&#39;);<tr><td><a id="l491"></a><a href="#l491">491</a><td>      goog.array.forEach(tmp, function(header) {<tr><td><a id="l492"></a><a href="#l492">492</a><td>        var parts = header.split(/\s*:\s*/, 2);<tr><td><a id="l493"></a><a href="#l493">493</a><td>        if (parts[0]) {<tr><td><a id="l494"></a><a href="#l494">494</a><td>          headers[parts[0]] = parts[1] || &#39;&#39;;<tr><td><a id="l495"></a><a href="#l495">495</a><td>        }<tr><td><a id="l496"></a><a href="#l496">496</a><td>      });<tr><td><a id="l497"></a><a href="#l497">497</a><td>    }<tr><td><a id="l498"></a><a href="#l498">498</a><td>  }<tr><td><a id="l499"></a><a href="#l499">499</a><td><tr><td><a id="l500"></a><a href="#l500">500</a><td>  // If xhr is a XDomainRequest object, it will not have a status.<tr><td><a id="l501"></a><a href="#l501">501</a><td>  // However, if we&#39;re parsing the response from a XDomainRequest, then<tr><td><a id="l502"></a><a href="#l502">502</a><td>  // that request must have been a success, so we can assume status == 200.<tr><td><a id="l503"></a><a href="#l503">503</a><td>  var status = xhr.status || 200;<tr><td><a id="l504"></a><a href="#l504">504</a><td>  return new webdriver.http.Response(status, headers,<tr><td><a id="l505"></a><a href="#l505">505</a><td>      xhr.responseText.replace(/\0/g, &#39;&#39;));<tr><td><a id="l506"></a><a href="#l506">506</a><td>};<tr><td><a id="l507"></a><a href="#l507">507</a><td><tr><td><a id="l508"></a><a href="#l508">508</a><td><tr><td><a id="l509"></a><a href="#l509">509</a><td>/** @override */<tr><td><a id="l510"></a><a href="#l510">510</a><td>webdriver.http.Response.prototype.toString = function() {<tr><td><a id="l511"></a><a href="#l511">511</a><td>  var headers = webdriver.http.headersToString_(this.headers);<tr><td><a id="l512"></a><a href="#l512">512</a><td>  var ret = [&#39;HTTP/1.1 &#39; + this.status, headers];<tr><td><a id="l513"></a><a href="#l513">513</a><td><tr><td><a id="l514"></a><a href="#l514">514</a><td>  if (headers) {<tr><td><a id="l515"></a><a href="#l515">515</a><td>    ret.push(&#39;&#39;);<tr><td><a id="l516"></a><a href="#l516">516</a><td>  }<tr><td><a id="l517"></a><a href="#l517">517</a><td><tr><td><a id="l518"></a><a href="#l518">518</a><td>  if (this.body) {<tr><td><a id="l519"></a><a href="#l519">519</a><td>    ret.push(this.body);<tr><td><a id="l520"></a><a href="#l520">520</a><td>  }<tr><td><a id="l521"></a><a href="#l521">521</a><td><tr><td><a id="l522"></a><a href="#l522">522</a><td>  return ret.join(&#39;\n&#39;);<tr><td><a id="l523"></a><a href="#l523">523</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/http/xhrclient.js.src.html b/docs/source/lib/webdriver/http/xhrclient.js.src.html
index d810afe..a71f98f 100644
--- a/docs/source/lib/webdriver/http/xhrclient.js.src.html
+++ b/docs/source/lib/webdriver/http/xhrclient.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>xhrclient.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/http/xhrclient.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/** @fileoverview A XHR client. */<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.provide(&#39;webdriver.http.XhrClient&#39;);<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.require(&#39;goog.net.XmlHttp&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.require(&#39;webdriver.http.Response&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * A HTTP client that sends requests using XMLHttpRequests.<tr><td><a name="l27" href="#l27">27</a><td> * @param {string} url URL for the WebDriver server to send commands to.<tr><td><a name="l28" href="#l28">28</a><td> * @constructor<tr><td><a name="l29" href="#l29">29</a><td> * @implements {webdriver.http.Client}<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>webdriver.http.XhrClient = function(url) {<tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td>  /** @private {string} */<tr><td><a name="l34" href="#l34">34</a><td>  this.url_ = url;<tr><td><a name="l35" href="#l35">35</a><td>};<tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td>/** @override */<tr><td><a name="l39" href="#l39">39</a><td>webdriver.http.XhrClient.prototype.send = function(request, callback) {<tr><td><a name="l40" href="#l40">40</a><td>  try {<tr><td><a name="l41" href="#l41">41</a><td>    var xhr = /** @type {!XMLHttpRequest} */ (goog.net.XmlHttp());<tr><td><a name="l42" href="#l42">42</a><td>    var url = this.url_ + request.path;<tr><td><a name="l43" href="#l43">43</a><td>    xhr.open(request.method, url, true);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>    xhr.onload = function() {<tr><td><a name="l46" href="#l46">46</a><td>      callback(null, webdriver.http.Response.fromXmlHttpRequest(xhr));<tr><td><a name="l47" href="#l47">47</a><td>    };<tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>    xhr.onerror = function() {<tr><td><a name="l50" href="#l50">50</a><td>      callback(Error([<tr><td><a name="l51" href="#l51">51</a><td>        &#39;Unable to send request: &#39;, request.method, &#39; &#39;, url,<tr><td><a name="l52" href="#l52">52</a><td>        &#39;\nOriginal request:\n&#39;, request<tr><td><a name="l53" href="#l53">53</a><td>      ].join(&#39;&#39;)));<tr><td><a name="l54" href="#l54">54</a><td>    };<tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td>    for (var header in request.headers) {<tr><td><a name="l57" href="#l57">57</a><td>      xhr.setRequestHeader(header, request.headers[header] + &#39;&#39;);<tr><td><a name="l58" href="#l58">58</a><td>    }<tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td>    xhr.send(goog.json.serialize(request.data));<tr><td><a name="l61" href="#l61">61</a><td>  } catch (ex) {<tr><td><a name="l62" href="#l62">62</a><td>    callback(ex);<tr><td><a name="l63" href="#l63">63</a><td>  }<tr><td><a name="l64" href="#l64">64</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>xhrclient.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/http/xhrclient.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/** @fileoverview A XHR client. */<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.provide(&#39;webdriver.http.XhrClient&#39;);<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.require(&#39;goog.net.XmlHttp&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.require(&#39;webdriver.http.Response&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * A HTTP client that sends requests using XMLHttpRequests.<tr><td><a name="l27" href="#l27">27</a><td> * @param {string} url URL for the WebDriver server to send commands to.<tr><td><a name="l28" href="#l28">28</a><td> * @constructor<tr><td><a name="l29" href="#l29">29</a><td> * @implements {webdriver.http.Client}<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>webdriver.http.XhrClient = function(url) {<tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td>  /** @private {string} */<tr><td><a name="l34" href="#l34">34</a><td>  this.url_ = url;<tr><td><a name="l35" href="#l35">35</a><td>};<tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td>/** @override */<tr><td><a name="l39" href="#l39">39</a><td>webdriver.http.XhrClient.prototype.send = function(request, callback) {<tr><td><a name="l40" href="#l40">40</a><td>  try {<tr><td><a name="l41" href="#l41">41</a><td>    var xhr = /** @type {!XMLHttpRequest} */ (goog.net.XmlHttp());<tr><td><a name="l42" href="#l42">42</a><td>    var url = this.url_ + request.path;<tr><td><a name="l43" href="#l43">43</a><td>    xhr.open(request.method, url, true);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td>    xhr.onload = function() {<tr><td><a name="l46" href="#l46">46</a><td>      callback(null, webdriver.http.Response.fromXmlHttpRequest(xhr));<tr><td><a name="l47" href="#l47">47</a><td>    };<tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>    xhr.onerror = function() {<tr><td><a name="l50" href="#l50">50</a><td>      callback(Error([<tr><td><a name="l51" href="#l51">51</a><td>        &#39;Unable to send request: &#39;, request.method, &#39; &#39;, url,<tr><td><a name="l52" href="#l52">52</a><td>        &#39;\nOriginal request:\n&#39;, request<tr><td><a name="l53" href="#l53">53</a><td>      ].join(&#39;&#39;)));<tr><td><a name="l54" href="#l54">54</a><td>    };<tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td>    for (var header in request.headers) {<tr><td><a name="l57" href="#l57">57</a><td>      xhr.setRequestHeader(header, request.headers[header] + &#39;&#39;);<tr><td><a name="l58" href="#l58">58</a><td>    }<tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td>    xhr.send(goog.json.serialize(request.data));<tr><td><a name="l61" href="#l61">61</a><td>  } catch (ex) {<tr><td><a name="l62" href="#l62">62</a><td>    callback(ex);<tr><td><a name="l63" href="#l63">63</a><td>  }<tr><td><a name="l64" href="#l64">64</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/key.js.src.html b/docs/source/lib/webdriver/key.js.src.html
index 4cb50ac..1813550 100644
--- a/docs/source/lib/webdriver/key.js.src.html
+++ b/docs/source/lib/webdriver/key.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>key.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/key.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.Key&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td>/**<tr><td><a name="l19" href="#l19">19</a><td> * Representations of pressable keys that aren&#39;t text.  These are stored in<tr><td><a name="l20" href="#l20">20</a><td> * the Unicode PUA (Private Use Area) code points, 0xE000-0xF8FF.  Refer to<tr><td><a name="l21" href="#l21">21</a><td> * http://www.google.com.au/search?&amp;q=unicode+pua&amp;btnG=Search<tr><td><a name="l22" href="#l22">22</a><td> *<tr><td><a name="l23" href="#l23">23</a><td> * @enum {string}<tr><td><a name="l24" href="#l24">24</a><td> */<tr><td><a name="l25" href="#l25">25</a><td>webdriver.Key = {<tr><td><a name="l26" href="#l26">26</a><td>  NULL:         &#39;\uE000&#39;,<tr><td><a name="l27" href="#l27">27</a><td>  CANCEL:       &#39;\uE001&#39;,  // ^break<tr><td><a name="l28" href="#l28">28</a><td>  HELP:         &#39;\uE002&#39;,<tr><td><a name="l29" href="#l29">29</a><td>  BACK_SPACE:   &#39;\uE003&#39;,<tr><td><a name="l30" href="#l30">30</a><td>  TAB:          &#39;\uE004&#39;,<tr><td><a name="l31" href="#l31">31</a><td>  CLEAR:        &#39;\uE005&#39;,<tr><td><a name="l32" href="#l32">32</a><td>  RETURN:       &#39;\uE006&#39;,<tr><td><a name="l33" href="#l33">33</a><td>  ENTER:        &#39;\uE007&#39;,<tr><td><a name="l34" href="#l34">34</a><td>  SHIFT:        &#39;\uE008&#39;,<tr><td><a name="l35" href="#l35">35</a><td>  CONTROL:      &#39;\uE009&#39;,<tr><td><a name="l36" href="#l36">36</a><td>  ALT:          &#39;\uE00A&#39;,<tr><td><a name="l37" href="#l37">37</a><td>  PAUSE:        &#39;\uE00B&#39;,<tr><td><a name="l38" href="#l38">38</a><td>  ESCAPE:       &#39;\uE00C&#39;,<tr><td><a name="l39" href="#l39">39</a><td>  SPACE:        &#39;\uE00D&#39;,<tr><td><a name="l40" href="#l40">40</a><td>  PAGE_UP:      &#39;\uE00E&#39;,<tr><td><a name="l41" href="#l41">41</a><td>  PAGE_DOWN:    &#39;\uE00F&#39;,<tr><td><a name="l42" href="#l42">42</a><td>  END:          &#39;\uE010&#39;,<tr><td><a name="l43" href="#l43">43</a><td>  HOME:         &#39;\uE011&#39;,<tr><td><a name="l44" href="#l44">44</a><td>  ARROW_LEFT:   &#39;\uE012&#39;,<tr><td><a name="l45" href="#l45">45</a><td>  LEFT:         &#39;\uE012&#39;,<tr><td><a name="l46" href="#l46">46</a><td>  ARROW_UP:     &#39;\uE013&#39;,<tr><td><a name="l47" href="#l47">47</a><td>  UP:           &#39;\uE013&#39;,<tr><td><a name="l48" href="#l48">48</a><td>  ARROW_RIGHT:  &#39;\uE014&#39;,<tr><td><a name="l49" href="#l49">49</a><td>  RIGHT:        &#39;\uE014&#39;,<tr><td><a name="l50" href="#l50">50</a><td>  ARROW_DOWN:   &#39;\uE015&#39;,<tr><td><a name="l51" href="#l51">51</a><td>  DOWN:         &#39;\uE015&#39;,<tr><td><a name="l52" href="#l52">52</a><td>  INSERT:       &#39;\uE016&#39;,<tr><td><a name="l53" href="#l53">53</a><td>  DELETE:       &#39;\uE017&#39;,<tr><td><a name="l54" href="#l54">54</a><td>  SEMICOLON:    &#39;\uE018&#39;,<tr><td><a name="l55" href="#l55">55</a><td>  EQUALS:       &#39;\uE019&#39;,<tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td>  NUMPAD0:      &#39;\uE01A&#39;,  // number pad keys<tr><td><a name="l58" href="#l58">58</a><td>  NUMPAD1:      &#39;\uE01B&#39;,<tr><td><a name="l59" href="#l59">59</a><td>  NUMPAD2:      &#39;\uE01C&#39;,<tr><td><a name="l60" href="#l60">60</a><td>  NUMPAD3:      &#39;\uE01D&#39;,<tr><td><a name="l61" href="#l61">61</a><td>  NUMPAD4:      &#39;\uE01E&#39;,<tr><td><a name="l62" href="#l62">62</a><td>  NUMPAD5:      &#39;\uE01F&#39;,<tr><td><a name="l63" href="#l63">63</a><td>  NUMPAD6:      &#39;\uE020&#39;,<tr><td><a name="l64" href="#l64">64</a><td>  NUMPAD7:      &#39;\uE021&#39;,<tr><td><a name="l65" href="#l65">65</a><td>  NUMPAD8:      &#39;\uE022&#39;,<tr><td><a name="l66" href="#l66">66</a><td>  NUMPAD9:      &#39;\uE023&#39;,<tr><td><a name="l67" href="#l67">67</a><td>  MULTIPLY:     &#39;\uE024&#39;,<tr><td><a name="l68" href="#l68">68</a><td>  ADD:          &#39;\uE025&#39;,<tr><td><a name="l69" href="#l69">69</a><td>  SEPARATOR:    &#39;\uE026&#39;,<tr><td><a name="l70" href="#l70">70</a><td>  SUBTRACT:     &#39;\uE027&#39;,<tr><td><a name="l71" href="#l71">71</a><td>  DECIMAL:      &#39;\uE028&#39;,<tr><td><a name="l72" href="#l72">72</a><td>  DIVIDE:       &#39;\uE029&#39;,<tr><td><a name="l73" href="#l73">73</a><td><tr><td><a name="l74" href="#l74">74</a><td>  F1:           &#39;\uE031&#39;,  // function keys<tr><td><a name="l75" href="#l75">75</a><td>  F2:           &#39;\uE032&#39;,<tr><td><a name="l76" href="#l76">76</a><td>  F3:           &#39;\uE033&#39;,<tr><td><a name="l77" href="#l77">77</a><td>  F4:           &#39;\uE034&#39;,<tr><td><a name="l78" href="#l78">78</a><td>  F5:           &#39;\uE035&#39;,<tr><td><a name="l79" href="#l79">79</a><td>  F6:           &#39;\uE036&#39;,<tr><td><a name="l80" href="#l80">80</a><td>  F7:           &#39;\uE037&#39;,<tr><td><a name="l81" href="#l81">81</a><td>  F8:           &#39;\uE038&#39;,<tr><td><a name="l82" href="#l82">82</a><td>  F9:           &#39;\uE039&#39;,<tr><td><a name="l83" href="#l83">83</a><td>  F10:          &#39;\uE03A&#39;,<tr><td><a name="l84" href="#l84">84</a><td>  F11:          &#39;\uE03B&#39;,<tr><td><a name="l85" href="#l85">85</a><td>  F12:          &#39;\uE03C&#39;,<tr><td><a name="l86" href="#l86">86</a><td><tr><td><a name="l87" href="#l87">87</a><td>  COMMAND:      &#39;\uE03D&#39;,  // Apple command key<tr><td><a name="l88" href="#l88">88</a><td>  META:         &#39;\uE03D&#39;   // alias for Windows key<tr><td><a name="l89" href="#l89">89</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>key.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/webdriver/key.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.provide(&#39;webdriver.Key&#39;);<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>/**<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Representations of pressable keys that aren&#39;t text.  These are stored in<tr><td><a id="l23"></a><a href="#l23">23</a><td> * the Unicode PUA (Private Use Area) code points, 0xE000-0xF8FF.  Refer to<tr><td><a id="l24"></a><a href="#l24">24</a><td> * http://www.google.com.au/search?&amp;q=unicode+pua&amp;btnG=Search<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @enum {string}<tr><td><a id="l27"></a><a href="#l27">27</a><td> */<tr><td><a id="l28"></a><a href="#l28">28</a><td>webdriver.Key = {<tr><td><a id="l29"></a><a href="#l29">29</a><td>  NULL:         &#39;\uE000&#39;,<tr><td><a id="l30"></a><a href="#l30">30</a><td>  CANCEL:       &#39;\uE001&#39;,  // ^break<tr><td><a id="l31"></a><a href="#l31">31</a><td>  HELP:         &#39;\uE002&#39;,<tr><td><a id="l32"></a><a href="#l32">32</a><td>  BACK_SPACE:   &#39;\uE003&#39;,<tr><td><a id="l33"></a><a href="#l33">33</a><td>  TAB:          &#39;\uE004&#39;,<tr><td><a id="l34"></a><a href="#l34">34</a><td>  CLEAR:        &#39;\uE005&#39;,<tr><td><a id="l35"></a><a href="#l35">35</a><td>  RETURN:       &#39;\uE006&#39;,<tr><td><a id="l36"></a><a href="#l36">36</a><td>  ENTER:        &#39;\uE007&#39;,<tr><td><a id="l37"></a><a href="#l37">37</a><td>  SHIFT:        &#39;\uE008&#39;,<tr><td><a id="l38"></a><a href="#l38">38</a><td>  CONTROL:      &#39;\uE009&#39;,<tr><td><a id="l39"></a><a href="#l39">39</a><td>  ALT:          &#39;\uE00A&#39;,<tr><td><a id="l40"></a><a href="#l40">40</a><td>  PAUSE:        &#39;\uE00B&#39;,<tr><td><a id="l41"></a><a href="#l41">41</a><td>  ESCAPE:       &#39;\uE00C&#39;,<tr><td><a id="l42"></a><a href="#l42">42</a><td>  SPACE:        &#39;\uE00D&#39;,<tr><td><a id="l43"></a><a href="#l43">43</a><td>  PAGE_UP:      &#39;\uE00E&#39;,<tr><td><a id="l44"></a><a href="#l44">44</a><td>  PAGE_DOWN:    &#39;\uE00F&#39;,<tr><td><a id="l45"></a><a href="#l45">45</a><td>  END:          &#39;\uE010&#39;,<tr><td><a id="l46"></a><a href="#l46">46</a><td>  HOME:         &#39;\uE011&#39;,<tr><td><a id="l47"></a><a href="#l47">47</a><td>  ARROW_LEFT:   &#39;\uE012&#39;,<tr><td><a id="l48"></a><a href="#l48">48</a><td>  LEFT:         &#39;\uE012&#39;,<tr><td><a id="l49"></a><a href="#l49">49</a><td>  ARROW_UP:     &#39;\uE013&#39;,<tr><td><a id="l50"></a><a href="#l50">50</a><td>  UP:           &#39;\uE013&#39;,<tr><td><a id="l51"></a><a href="#l51">51</a><td>  ARROW_RIGHT:  &#39;\uE014&#39;,<tr><td><a id="l52"></a><a href="#l52">52</a><td>  RIGHT:        &#39;\uE014&#39;,<tr><td><a id="l53"></a><a href="#l53">53</a><td>  ARROW_DOWN:   &#39;\uE015&#39;,<tr><td><a id="l54"></a><a href="#l54">54</a><td>  DOWN:         &#39;\uE015&#39;,<tr><td><a id="l55"></a><a href="#l55">55</a><td>  INSERT:       &#39;\uE016&#39;,<tr><td><a id="l56"></a><a href="#l56">56</a><td>  DELETE:       &#39;\uE017&#39;,<tr><td><a id="l57"></a><a href="#l57">57</a><td>  SEMICOLON:    &#39;\uE018&#39;,<tr><td><a id="l58"></a><a href="#l58">58</a><td>  EQUALS:       &#39;\uE019&#39;,<tr><td><a id="l59"></a><a href="#l59">59</a><td><tr><td><a id="l60"></a><a href="#l60">60</a><td>  NUMPAD0:      &#39;\uE01A&#39;,  // number pad keys<tr><td><a id="l61"></a><a href="#l61">61</a><td>  NUMPAD1:      &#39;\uE01B&#39;,<tr><td><a id="l62"></a><a href="#l62">62</a><td>  NUMPAD2:      &#39;\uE01C&#39;,<tr><td><a id="l63"></a><a href="#l63">63</a><td>  NUMPAD3:      &#39;\uE01D&#39;,<tr><td><a id="l64"></a><a href="#l64">64</a><td>  NUMPAD4:      &#39;\uE01E&#39;,<tr><td><a id="l65"></a><a href="#l65">65</a><td>  NUMPAD5:      &#39;\uE01F&#39;,<tr><td><a id="l66"></a><a href="#l66">66</a><td>  NUMPAD6:      &#39;\uE020&#39;,<tr><td><a id="l67"></a><a href="#l67">67</a><td>  NUMPAD7:      &#39;\uE021&#39;,<tr><td><a id="l68"></a><a href="#l68">68</a><td>  NUMPAD8:      &#39;\uE022&#39;,<tr><td><a id="l69"></a><a href="#l69">69</a><td>  NUMPAD9:      &#39;\uE023&#39;,<tr><td><a id="l70"></a><a href="#l70">70</a><td>  MULTIPLY:     &#39;\uE024&#39;,<tr><td><a id="l71"></a><a href="#l71">71</a><td>  ADD:          &#39;\uE025&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td>  SEPARATOR:    &#39;\uE026&#39;,<tr><td><a id="l73"></a><a href="#l73">73</a><td>  SUBTRACT:     &#39;\uE027&#39;,<tr><td><a id="l74"></a><a href="#l74">74</a><td>  DECIMAL:      &#39;\uE028&#39;,<tr><td><a id="l75"></a><a href="#l75">75</a><td>  DIVIDE:       &#39;\uE029&#39;,<tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>  F1:           &#39;\uE031&#39;,  // function keys<tr><td><a id="l78"></a><a href="#l78">78</a><td>  F2:           &#39;\uE032&#39;,<tr><td><a id="l79"></a><a href="#l79">79</a><td>  F3:           &#39;\uE033&#39;,<tr><td><a id="l80"></a><a href="#l80">80</a><td>  F4:           &#39;\uE034&#39;,<tr><td><a id="l81"></a><a href="#l81">81</a><td>  F5:           &#39;\uE035&#39;,<tr><td><a id="l82"></a><a href="#l82">82</a><td>  F6:           &#39;\uE036&#39;,<tr><td><a id="l83"></a><a href="#l83">83</a><td>  F7:           &#39;\uE037&#39;,<tr><td><a id="l84"></a><a href="#l84">84</a><td>  F8:           &#39;\uE038&#39;,<tr><td><a id="l85"></a><a href="#l85">85</a><td>  F9:           &#39;\uE039&#39;,<tr><td><a id="l86"></a><a href="#l86">86</a><td>  F10:          &#39;\uE03A&#39;,<tr><td><a id="l87"></a><a href="#l87">87</a><td>  F11:          &#39;\uE03B&#39;,<tr><td><a id="l88"></a><a href="#l88">88</a><td>  F12:          &#39;\uE03C&#39;,<tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td>  COMMAND:      &#39;\uE03D&#39;,  // Apple command key<tr><td><a id="l91"></a><a href="#l91">91</a><td>  META:         &#39;\uE03D&#39;   // alias for Windows key<tr><td><a id="l92"></a><a href="#l92">92</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/locators.js.src.html b/docs/source/lib/webdriver/locators.js.src.html
index 6587c12..8cedcb3 100644
--- a/docs/source/lib/webdriver/locators.js.src.html
+++ b/docs/source/lib/webdriver/locators.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>locators.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/locators.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Factory methods for the supported locator strategies.<tr><td><a name="l17" href="#l17">17</a><td> */<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.provide(&#39;webdriver.By&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;webdriver.Locator&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;webdriver.Locator.Strategy&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l26" href="#l26">26</a><td><tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td>/**<tr><td><a name="l30" href="#l30">30</a><td> * An element locator.<tr><td><a name="l31" href="#l31">31</a><td> * @param {string} using The type of strategy to use for this locator.<tr><td><a name="l32" href="#l32">32</a><td> * @param {string} value The search target of this locator.<tr><td><a name="l33" href="#l33">33</a><td> * @constructor<tr><td><a name="l34" href="#l34">34</a><td> */<tr><td><a name="l35" href="#l35">35</a><td>webdriver.Locator = function(using, value) {<tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td>  /**<tr><td><a name="l38" href="#l38">38</a><td>   * The search strategy to use when searching for an element.<tr><td><a name="l39" href="#l39">39</a><td>   * @type {string}<tr><td><a name="l40" href="#l40">40</a><td>   */<tr><td><a name="l41" href="#l41">41</a><td>  this.using = using;<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>  /**<tr><td><a name="l44" href="#l44">44</a><td>   * The search target for this locator.<tr><td><a name="l45" href="#l45">45</a><td>   * @type {string}<tr><td><a name="l46" href="#l46">46</a><td>   */<tr><td><a name="l47" href="#l47">47</a><td>  this.value = value;<tr><td><a name="l48" href="#l48">48</a><td>};<tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td>/**<tr><td><a name="l52" href="#l52">52</a><td> * Creates a factory function for a {@link webdriver.Locator}.<tr><td><a name="l53" href="#l53">53</a><td> * @param {string} type The type of locator for the factory.<tr><td><a name="l54" href="#l54">54</a><td> * @return {function(string): !webdriver.Locator} The new factory function.<tr><td><a name="l55" href="#l55">55</a><td> * @private<tr><td><a name="l56" href="#l56">56</a><td> */<tr><td><a name="l57" href="#l57">57</a><td>webdriver.Locator.factory_ = function(type) {<tr><td><a name="l58" href="#l58">58</a><td>  return function(value) {<tr><td><a name="l59" href="#l59">59</a><td>    return new webdriver.Locator(type, value);<tr><td><a name="l60" href="#l60">60</a><td>  };<tr><td><a name="l61" href="#l61">61</a><td>};<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/**<tr><td><a name="l65" href="#l65">65</a><td> * A collection of factory functions for creating {@link webdriver.Locator}<tr><td><a name="l66" href="#l66">66</a><td> * instances.<tr><td><a name="l67" href="#l67">67</a><td> */<tr><td><a name="l68" href="#l68">68</a><td>webdriver.By = {};<tr><td><a name="l69" href="#l69">69</a><td>// Exported to the global scope for legacy reasons.<tr><td><a name="l70" href="#l70">70</a><td>goog.exportSymbol(&#39;By&#39;, webdriver.By);<tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>/**<tr><td><a name="l74" href="#l74">74</a><td> * Short-hand expressions for the primary element locator strategies.<tr><td><a name="l75" href="#l75">75</a><td> * For example the following two statements are equivalent:<tr><td><a name="l76" href="#l76">76</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l77" href="#l77">77</a><td> * var e1 = driver.findElement(webdriver.By.id(&#39;foo&#39;));<tr><td><a name="l78" href="#l78">78</a><td> * var e2 = driver.findElement({id: &#39;foo&#39;});<tr><td><a name="l79" href="#l79">79</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l80" href="#l80">80</a><td> *<tr><td><a name="l81" href="#l81">81</a><td> * &lt;p&gt;Care should be taken when using JavaScript minifiers (such as the<tr><td><a name="l82" href="#l82">82</a><td> * Closure compiler), as locator hashes will always be parsed using<tr><td><a name="l83" href="#l83">83</a><td> * the un-obfuscated properties listed below.<tr><td><a name="l84" href="#l84">84</a><td> *<tr><td><a name="l85" href="#l85">85</a><td> * @typedef {(<tr><td><a name="l86" href="#l86">86</a><td> *     {className: string}|<tr><td><a name="l87" href="#l87">87</a><td> *     {css: string}|<tr><td><a name="l88" href="#l88">88</a><td> *     {id: string}|<tr><td><a name="l89" href="#l89">89</a><td> *     {js: string}|<tr><td><a name="l90" href="#l90">90</a><td> *     {linkText: string}|<tr><td><a name="l91" href="#l91">91</a><td> *     {name: string}|<tr><td><a name="l92" href="#l92">92</a><td> *     {partialLinkText: string}|<tr><td><a name="l93" href="#l93">93</a><td> *     {tagName: string}|<tr><td><a name="l94" href="#l94">94</a><td> *     {xpath: string})}<tr><td><a name="l95" href="#l95">95</a><td> */<tr><td><a name="l96" href="#l96">96</a><td>webdriver.By.Hash;<tr><td><a name="l97" href="#l97">97</a><td><tr><td><a name="l98" href="#l98">98</a><td><tr><td><a name="l99" href="#l99">99</a><td>/**<tr><td><a name="l100" href="#l100">100</a><td> * Locates elements that have a specific class name. The returned locator<tr><td><a name="l101" href="#l101">101</a><td> * is equivalent to searching for elements with the CSS selector &quot;.clazz&quot;.<tr><td><a name="l102" href="#l102">102</a><td> *<tr><td><a name="l103" href="#l103">103</a><td> * @param {string} className The class name to search for.<tr><td><a name="l104" href="#l104">104</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a name="l105" href="#l105">105</a><td> * @see http://www.w3.org/TR/2011/WD-html5-20110525/elements.html#classes<tr><td><a name="l106" href="#l106">106</a><td> * @see http://www.w3.org/TR/CSS2/selector.html#class-html<tr><td><a name="l107" href="#l107">107</a><td> */<tr><td><a name="l108" href="#l108">108</a><td>webdriver.By.className = webdriver.Locator.factory_(&#39;class name&#39;);<tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td>/**<tr><td><a name="l112" href="#l112">112</a><td> * Locates elements using a CSS selector. For browsers that do not support<tr><td><a name="l113" href="#l113">113</a><td> * CSS selectors, WebDriver implementations may return an<tr><td><a name="l114" href="#l114">114</a><td> * {@link bot.Error.State.INVALID_SELECTOR invalid selector} error. An<tr><td><a name="l115" href="#l115">115</a><td> * implementation may, however, emulate the CSS selector API.<tr><td><a name="l116" href="#l116">116</a><td> *<tr><td><a name="l117" href="#l117">117</a><td> * @param {string} selector The CSS selector to use.<tr><td><a name="l118" href="#l118">118</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a name="l119" href="#l119">119</a><td> * @see http://www.w3.org/TR/CSS2/selector.html<tr><td><a name="l120" href="#l120">120</a><td> */<tr><td><a name="l121" href="#l121">121</a><td>webdriver.By.css = webdriver.Locator.factory_(&#39;css selector&#39;);<tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td><tr><td><a name="l124" href="#l124">124</a><td>/**<tr><td><a name="l125" href="#l125">125</a><td> * Locates an element by its ID.<tr><td><a name="l126" href="#l126">126</a><td> *<tr><td><a name="l127" href="#l127">127</a><td> * @param {string} id The ID to search for.<tr><td><a name="l128" href="#l128">128</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a name="l129" href="#l129">129</a><td> */<tr><td><a name="l130" href="#l130">130</a><td>webdriver.By.id = webdriver.Locator.factory_(&#39;id&#39;);<tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td>/**<tr><td><a name="l134" href="#l134">134</a><td> * Locates link elements whose {@link webdriver.WebElement#getText visible<tr><td><a name="l135" href="#l135">135</a><td> * text} matches the given string.<tr><td><a name="l136" href="#l136">136</a><td> *<tr><td><a name="l137" href="#l137">137</a><td> * @param {string} text The link text to search for.<tr><td><a name="l138" href="#l138">138</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a name="l139" href="#l139">139</a><td> */<tr><td><a name="l140" href="#l140">140</a><td>webdriver.By.linkText = webdriver.Locator.factory_(&#39;link text&#39;);<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td>/**<tr><td><a name="l144" href="#l144">144</a><td> * Locates an elements by evaluating a<tr><td><a name="l145" href="#l145">145</a><td> * {@link webdriver.WebDriver#executeScript JavaScript expression}.<tr><td><a name="l146" href="#l146">146</a><td> * The result of this expression must be an element or list of elements.<tr><td><a name="l147" href="#l147">147</a><td> *<tr><td><a name="l148" href="#l148">148</a><td> * @param {!(string|Function)} script The script to execute.<tr><td><a name="l149" href="#l149">149</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a name="l150" href="#l150">150</a><td> * @return {function(!webdriver.WebDriver): !webdriver.promise.Promise} A new,<tr><td><a name="l151" href="#l151">151</a><td> *     JavaScript-based locator function.<tr><td><a name="l152" href="#l152">152</a><td> */<tr><td><a name="l153" href="#l153">153</a><td>webdriver.By.js = function(script, var_args) {<tr><td><a name="l154" href="#l154">154</a><td>  var args = goog.array.slice(arguments, 0);<tr><td><a name="l155" href="#l155">155</a><td>  return function(driver) {<tr><td><a name="l156" href="#l156">156</a><td>    return driver.executeScript.apply(driver, args);<tr><td><a name="l157" href="#l157">157</a><td>  };<tr><td><a name="l158" href="#l158">158</a><td>};<tr><td><a name="l159" href="#l159">159</a><td><tr><td><a name="l160" href="#l160">160</a><td><tr><td><a name="l161" href="#l161">161</a><td>/**<tr><td><a name="l162" href="#l162">162</a><td> * Locates elements whose {@code name} attribute has the given value.<tr><td><a name="l163" href="#l163">163</a><td> *<tr><td><a name="l164" href="#l164">164</a><td> * @param {string} name The name attribute to search for.<tr><td><a name="l165" href="#l165">165</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a name="l166" href="#l166">166</a><td> */<tr><td><a name="l167" href="#l167">167</a><td>webdriver.By.name = webdriver.Locator.factory_(&#39;name&#39;);<tr><td><a name="l168" href="#l168">168</a><td><tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td>/**<tr><td><a name="l171" href="#l171">171</a><td> * Locates link elements whose {@link webdriver.WebElement#getText visible<tr><td><a name="l172" href="#l172">172</a><td> * text} contains the given substring.<tr><td><a name="l173" href="#l173">173</a><td> *<tr><td><a name="l174" href="#l174">174</a><td> * @param {string} text The substring to check for in a link&#39;s visible text.<tr><td><a name="l175" href="#l175">175</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a name="l176" href="#l176">176</a><td> */<tr><td><a name="l177" href="#l177">177</a><td>webdriver.By.partialLinkText = webdriver.Locator.factory_(<tr><td><a name="l178" href="#l178">178</a><td>    &#39;partial link text&#39;);<tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td><tr><td><a name="l181" href="#l181">181</a><td>/**<tr><td><a name="l182" href="#l182">182</a><td> * Locates elements with a given tag name. The returned locator is<tr><td><a name="l183" href="#l183">183</a><td> * equivalent to using the {@code getElementsByTagName} DOM function.<tr><td><a name="l184" href="#l184">184</a><td> *<tr><td><a name="l185" href="#l185">185</a><td> * @param {string} text The substring to check for in a link&#39;s visible text.<tr><td><a name="l186" href="#l186">186</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a name="l187" href="#l187">187</a><td> * @see http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html<tr><td><a name="l188" href="#l188">188</a><td> */<tr><td><a name="l189" href="#l189">189</a><td>webdriver.By.tagName = webdriver.Locator.factory_(&#39;tag name&#39;);<tr><td><a name="l190" href="#l190">190</a><td><tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td>/**<tr><td><a name="l193" href="#l193">193</a><td> * Locates elements matching a XPath selector. Care should be taken when<tr><td><a name="l194" href="#l194">194</a><td> * using an XPath selector with a {@link webdriver.WebElement} as WebDriver<tr><td><a name="l195" href="#l195">195</a><td> * will respect the context in the specified in the selector. For example,<tr><td><a name="l196" href="#l196">196</a><td> * given the selector {@code &quot;//div&quot;}, WebDriver will search from the<tr><td><a name="l197" href="#l197">197</a><td> * document root regardless of whether the locator was used with a<tr><td><a name="l198" href="#l198">198</a><td> * WebElement.<tr><td><a name="l199" href="#l199">199</a><td> *<tr><td><a name="l200" href="#l200">200</a><td> * @param {string} xpath The XPath selector to use.<tr><td><a name="l201" href="#l201">201</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a name="l202" href="#l202">202</a><td> * @see http://www.w3.org/TR/xpath/<tr><td><a name="l203" href="#l203">203</a><td> */<tr><td><a name="l204" href="#l204">204</a><td>webdriver.By.xpath = webdriver.Locator.factory_(&#39;xpath&#39;);<tr><td><a name="l205" href="#l205">205</a><td><tr><td><a name="l206" href="#l206">206</a><td><tr><td><a name="l207" href="#l207">207</a><td>/**<tr><td><a name="l208" href="#l208">208</a><td> * Maps {@link webdriver.By.Hash} keys to the appropriate factory function.<tr><td><a name="l209" href="#l209">209</a><td> * @type {!Object.&lt;string, function(string): !(Function|webdriver.Locator)&gt;}<tr><td><a name="l210" href="#l210">210</a><td> * @const<tr><td><a name="l211" href="#l211">211</a><td> */<tr><td><a name="l212" href="#l212">212</a><td>webdriver.Locator.Strategy = {<tr><td><a name="l213" href="#l213">213</a><td>  &#39;className&#39;: webdriver.By.className,<tr><td><a name="l214" href="#l214">214</a><td>  &#39;css&#39;: webdriver.By.css,<tr><td><a name="l215" href="#l215">215</a><td>  &#39;id&#39;: webdriver.By.id,<tr><td><a name="l216" href="#l216">216</a><td>  &#39;js&#39;: webdriver.By.js,<tr><td><a name="l217" href="#l217">217</a><td>  &#39;linkText&#39;: webdriver.By.linkText,<tr><td><a name="l218" href="#l218">218</a><td>  &#39;name&#39;: webdriver.By.name,<tr><td><a name="l219" href="#l219">219</a><td>  &#39;partialLinkText&#39;: webdriver.By.partialLinkText,<tr><td><a name="l220" href="#l220">220</a><td>  &#39;tagName&#39;: webdriver.By.tagName,<tr><td><a name="l221" href="#l221">221</a><td>  &#39;xpath&#39;: webdriver.By.xpath<tr><td><a name="l222" href="#l222">222</a><td>};<tr><td><a name="l223" href="#l223">223</a><td><tr><td><a name="l224" href="#l224">224</a><td><tr><td><a name="l225" href="#l225">225</a><td>/**<tr><td><a name="l226" href="#l226">226</a><td> * Verifies that a {@code value} is a valid locator to use for searching for<tr><td><a name="l227" href="#l227">227</a><td> * elements on the page.<tr><td><a name="l228" href="#l228">228</a><td> *<tr><td><a name="l229" href="#l229">229</a><td> * @param {*} value The value to check is a valid locator.<tr><td><a name="l230" href="#l230">230</a><td> * @return {!(webdriver.Locator|Function)} A valid locator object or function.<tr><td><a name="l231" href="#l231">231</a><td> * @throws {TypeError} If the given value is an invalid locator.<tr><td><a name="l232" href="#l232">232</a><td> */<tr><td><a name="l233" href="#l233">233</a><td>webdriver.Locator.checkLocator = function(value) {<tr><td><a name="l234" href="#l234">234</a><td>  if (goog.isFunction(value) || value instanceof webdriver.Locator) {<tr><td><a name="l235" href="#l235">235</a><td>    return value;<tr><td><a name="l236" href="#l236">236</a><td>  }<tr><td><a name="l237" href="#l237">237</a><td>  for (var key in value) {<tr><td><a name="l238" href="#l238">238</a><td>    if (value.hasOwnProperty(key) &amp;&amp;<tr><td><a name="l239" href="#l239">239</a><td>        webdriver.Locator.Strategy.hasOwnProperty(key)) {<tr><td><a name="l240" href="#l240">240</a><td>      return webdriver.Locator.Strategy[key](value[key]);<tr><td><a name="l241" href="#l241">241</a><td>    }<tr><td><a name="l242" href="#l242">242</a><td>  }<tr><td><a name="l243" href="#l243">243</a><td>  throw new TypeError(&#39;Invalid locator&#39;);<tr><td><a name="l244" href="#l244">244</a><td>};<tr><td><a name="l245" href="#l245">245</a><td><tr><td><a name="l246" href="#l246">246</a><td><tr><td><a name="l247" href="#l247">247</a><td><tr><td><a name="l248" href="#l248">248</a><td>/** @override */<tr><td><a name="l249" href="#l249">249</a><td>webdriver.Locator.prototype.toString = function() {<tr><td><a name="l250" href="#l250">250</a><td>  return &#39;By.&#39; + this.using.replace(/ ([a-z])/g, function(all, match) {<tr><td><a name="l251" href="#l251">251</a><td>    return match.toUpperCase();<tr><td><a name="l252" href="#l252">252</a><td>  }) + &#39;(&#39; + goog.string.quote(this.value) + &#39;)&#39;;<tr><td><a name="l253" href="#l253">253</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>locators.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/webdriver/locators.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Factory methods for the supported locator strategies.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;webdriver.By&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;webdriver.Locator&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.Locator.Strategy&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * An element locator.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @param {string} using The type of strategy to use for this locator.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {string} value The search target of this locator.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @constructor<tr><td><a id="l37"></a><a href="#l37">37</a><td> */<tr><td><a id="l38"></a><a href="#l38">38</a><td>webdriver.Locator = function(using, value) {<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>   * The search strategy to use when searching for an element.<tr><td><a id="l42"></a><a href="#l42">42</a><td>   * @type {string}<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.using = using;<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>   * The search target for this locator.<tr><td><a id="l48"></a><a href="#l48">48</a><td>   * @type {string}<tr><td><a id="l49"></a><a href="#l49">49</a><td>   */<tr><td><a id="l50"></a><a href="#l50">50</a><td>  this.value = value;<tr><td><a id="l51"></a><a href="#l51">51</a><td>};<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td>/**<tr><td><a id="l55"></a><a href="#l55">55</a><td> * Creates a factory function for a {@link webdriver.Locator}.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @param {string} type The type of locator for the factory.<tr><td><a id="l57"></a><a href="#l57">57</a><td> * @return {function(string): !webdriver.Locator} The new factory function.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @private<tr><td><a id="l59"></a><a href="#l59">59</a><td> */<tr><td><a id="l60"></a><a href="#l60">60</a><td>webdriver.Locator.factory_ = function(type) {<tr><td><a id="l61"></a><a href="#l61">61</a><td>  return function(value) {<tr><td><a id="l62"></a><a href="#l62">62</a><td>    return new webdriver.Locator(type, value);<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>/**<tr><td><a id="l68"></a><a href="#l68">68</a><td> * A collection of factory functions for creating {@link webdriver.Locator}<tr><td><a id="l69"></a><a href="#l69">69</a><td> * instances.<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>webdriver.By = {};<tr><td><a id="l72"></a><a href="#l72">72</a><td>// Exported to the global scope for legacy reasons.<tr><td><a id="l73"></a><a href="#l73">73</a><td>goog.exportSymbol(&#39;By&#39;, webdriver.By);<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/**<tr><td><a id="l77"></a><a href="#l77">77</a><td> * Short-hand expressions for the primary element locator strategies.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * For example the following two statements are equivalent:<tr><td><a id="l79"></a><a href="#l79">79</a><td> *<tr><td><a id="l80"></a><a href="#l80">80</a><td> *     var e1 = driver.findElement(webdriver.By.id(&#39;foo&#39;));<tr><td><a id="l81"></a><a href="#l81">81</a><td> *     var e2 = driver.findElement({id: &#39;foo&#39;});<tr><td><a id="l82"></a><a href="#l82">82</a><td> *<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Care should be taken when using JavaScript minifiers (such as the<tr><td><a id="l84"></a><a href="#l84">84</a><td> * Closure compiler), as locator hashes will always be parsed using<tr><td><a id="l85"></a><a href="#l85">85</a><td> * the un-obfuscated properties listed.<tr><td><a id="l86"></a><a href="#l86">86</a><td> *<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @typedef {(<tr><td><a id="l88"></a><a href="#l88">88</a><td> *     {className: string}|<tr><td><a id="l89"></a><a href="#l89">89</a><td> *     {css: string}|<tr><td><a id="l90"></a><a href="#l90">90</a><td> *     {id: string}|<tr><td><a id="l91"></a><a href="#l91">91</a><td> *     {js: string}|<tr><td><a id="l92"></a><a href="#l92">92</a><td> *     {linkText: string}|<tr><td><a id="l93"></a><a href="#l93">93</a><td> *     {name: string}|<tr><td><a id="l94"></a><a href="#l94">94</a><td> *     {partialLinkText: string}|<tr><td><a id="l95"></a><a href="#l95">95</a><td> *     {tagName: string}|<tr><td><a id="l96"></a><a href="#l96">96</a><td> *     {xpath: string})}<tr><td><a id="l97"></a><a href="#l97">97</a><td> */<tr><td><a id="l98"></a><a href="#l98">98</a><td>webdriver.By.Hash;<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> * Locates elements that have a specific class name. The returned locator<tr><td><a id="l103"></a><a href="#l103">103</a><td> * is equivalent to searching for elements with the CSS selector &quot;.clazz&quot;.<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} className The class name to search for.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l107"></a><a href="#l107">107</a><td> * @see http://www.w3.org/TR/2011/WD-html5-20110525/elements.html#classes<tr><td><a id="l108"></a><a href="#l108">108</a><td> * @see http://www.w3.org/TR/CSS2/selector.html#class-html<tr><td><a id="l109"></a><a href="#l109">109</a><td> */<tr><td><a id="l110"></a><a href="#l110">110</a><td>webdriver.By.className = webdriver.Locator.factory_(&#39;class name&#39;);<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> * Locates elements using a CSS selector. For browsers that do not support<tr><td><a id="l115"></a><a href="#l115">115</a><td> * CSS selectors, WebDriver implementations may return an<tr><td><a id="l116"></a><a href="#l116">116</a><td> * {@linkplain bot.Error.State.INVALID_SELECTOR invalid selector} error. An<tr><td><a id="l117"></a><a href="#l117">117</a><td> * implementation may, however, emulate the CSS selector API.<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 {string} selector The CSS selector to use.<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @see http://www.w3.org/TR/CSS2/selector.html<tr><td><a id="l122"></a><a href="#l122">122</a><td> */<tr><td><a id="l123"></a><a href="#l123">123</a><td>webdriver.By.css = webdriver.Locator.factory_(&#39;css selector&#39;);<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> * Locates an element by its ID.<tr><td><a id="l128"></a><a href="#l128">128</a><td> *<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @param {string} id The ID to search for.<tr><td><a id="l130"></a><a href="#l130">130</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l131"></a><a href="#l131">131</a><td> */<tr><td><a id="l132"></a><a href="#l132">132</a><td>webdriver.By.id = webdriver.Locator.factory_(&#39;id&#39;);<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> * Locates link elements whose {@linkplain webdriver.WebElement#getText visible<tr><td><a id="l137"></a><a href="#l137">137</a><td> * text} matches the given string.<tr><td><a id="l138"></a><a href="#l138">138</a><td> *<tr><td><a id="l139"></a><a href="#l139">139</a><td> * @param {string} text The link text to search for.<tr><td><a id="l140"></a><a href="#l140">140</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l141"></a><a href="#l141">141</a><td> */<tr><td><a id="l142"></a><a href="#l142">142</a><td>webdriver.By.linkText = webdriver.Locator.factory_(&#39;link text&#39;);<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> * Locates an elements by evaluating a<tr><td><a id="l147"></a><a href="#l147">147</a><td> * {@linkplain webdriver.WebDriver#executeScript JavaScript expression}.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * The result of this expression must be an element or list of elements.<tr><td><a id="l149"></a><a href="#l149">149</a><td> *<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @param {!(string|Function)} script The script to execute.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @return {function(!webdriver.WebDriver): !webdriver.promise.Promise} A new,<tr><td><a id="l153"></a><a href="#l153">153</a><td> *     JavaScript-based locator function.<tr><td><a id="l154"></a><a href="#l154">154</a><td> */<tr><td><a id="l155"></a><a href="#l155">155</a><td>webdriver.By.js = function(script, var_args) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>  var args = goog.array.slice(arguments, 0);<tr><td><a id="l157"></a><a href="#l157">157</a><td>  return function(driver) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>    return driver.executeScript.apply(driver, args);<tr><td><a id="l159"></a><a href="#l159">159</a><td>  };<tr><td><a id="l160"></a><a href="#l160">160</a><td>};<tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td>/**<tr><td><a id="l164"></a><a href="#l164">164</a><td> * Locates elements whose {@code name} attribute has the given value.<tr><td><a id="l165"></a><a href="#l165">165</a><td> *<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {string} name The name attribute to search for.<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l168"></a><a href="#l168">168</a><td> */<tr><td><a id="l169"></a><a href="#l169">169</a><td>webdriver.By.name = webdriver.Locator.factory_(&#39;name&#39;);<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> * Locates link elements whose {@linkplain webdriver.WebElement#getText visible<tr><td><a id="l174"></a><a href="#l174">174</a><td> * text} contains the given substring.<tr><td><a id="l175"></a><a href="#l175">175</a><td> *<tr><td><a id="l176"></a><a href="#l176">176</a><td> * @param {string} text The substring to check for in a link&#39;s visible text.<tr><td><a id="l177"></a><a href="#l177">177</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l178"></a><a href="#l178">178</a><td> */<tr><td><a id="l179"></a><a href="#l179">179</a><td>webdriver.By.partialLinkText = webdriver.Locator.factory_(<tr><td><a id="l180"></a><a href="#l180">180</a><td>    &#39;partial link text&#39;);<tr><td><a id="l181"></a><a href="#l181">181</a><td><tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>/**<tr><td><a id="l184"></a><a href="#l184">184</a><td> * Locates elements with a given tag name. The returned locator is<tr><td><a id="l185"></a><a href="#l185">185</a><td> * equivalent to using the<tr><td><a id="l186"></a><a href="#l186">186</a><td> * [getElementsByTagName](https://developer.mozilla.org/en-US/docs/Web/API/Element.getElementsByTagName)<tr><td><a id="l187"></a><a href="#l187">187</a><td> * DOM function.<tr><td><a id="l188"></a><a href="#l188">188</a><td> *<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @param {string} text The substring to check for in a link&#39;s visible text.<tr><td><a id="l190"></a><a href="#l190">190</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @see http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>webdriver.By.tagName = webdriver.Locator.factory_(&#39;tag name&#39;);<tr><td><a id="l194"></a><a href="#l194">194</a><td><tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td>/**<tr><td><a id="l197"></a><a href="#l197">197</a><td> * Locates elements matching a XPath selector. Care should be taken when<tr><td><a id="l198"></a><a href="#l198">198</a><td> * using an XPath selector with a {@link webdriver.WebElement} as WebDriver<tr><td><a id="l199"></a><a href="#l199">199</a><td> * will respect the context in the specified in the selector. For example,<tr><td><a id="l200"></a><a href="#l200">200</a><td> * given the selector {@code &quot;//div&quot;}, WebDriver will search from the<tr><td><a id="l201"></a><a href="#l201">201</a><td> * document root regardless of whether the locator was used with a<tr><td><a id="l202"></a><a href="#l202">202</a><td> * WebElement.<tr><td><a id="l203"></a><a href="#l203">203</a><td> *<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @param {string} xpath The XPath selector to use.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @return {!webdriver.Locator} The new locator.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @see http://www.w3.org/TR/xpath/<tr><td><a id="l207"></a><a href="#l207">207</a><td> */<tr><td><a id="l208"></a><a href="#l208">208</a><td>webdriver.By.xpath = webdriver.Locator.factory_(&#39;xpath&#39;);<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Maps {@link webdriver.By.Hash} keys to the appropriate factory function.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @type {!Object.&lt;string, function(string): !(Function|webdriver.Locator)&gt;}<tr><td><a id="l214"></a><a href="#l214">214</a><td> * @const<tr><td><a id="l215"></a><a href="#l215">215</a><td> */<tr><td><a id="l216"></a><a href="#l216">216</a><td>webdriver.Locator.Strategy = {<tr><td><a id="l217"></a><a href="#l217">217</a><td>  &#39;className&#39;: webdriver.By.className,<tr><td><a id="l218"></a><a href="#l218">218</a><td>  &#39;css&#39;: webdriver.By.css,<tr><td><a id="l219"></a><a href="#l219">219</a><td>  &#39;id&#39;: webdriver.By.id,<tr><td><a id="l220"></a><a href="#l220">220</a><td>  &#39;js&#39;: webdriver.By.js,<tr><td><a id="l221"></a><a href="#l221">221</a><td>  &#39;linkText&#39;: webdriver.By.linkText,<tr><td><a id="l222"></a><a href="#l222">222</a><td>  &#39;name&#39;: webdriver.By.name,<tr><td><a id="l223"></a><a href="#l223">223</a><td>  &#39;partialLinkText&#39;: webdriver.By.partialLinkText,<tr><td><a id="l224"></a><a href="#l224">224</a><td>  &#39;tagName&#39;: webdriver.By.tagName,<tr><td><a id="l225"></a><a href="#l225">225</a><td>  &#39;xpath&#39;: webdriver.By.xpath<tr><td><a id="l226"></a><a href="#l226">226</a><td>};<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td>/**<tr><td><a id="l230"></a><a href="#l230">230</a><td> * Verifies that a {@code value} is a valid locator to use for searching for<tr><td><a id="l231"></a><a href="#l231">231</a><td> * elements on the page.<tr><td><a id="l232"></a><a href="#l232">232</a><td> *<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @param {*} value The value to check is a valid locator.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @return {!(webdriver.Locator|Function)} A valid locator object or function.<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @throws {TypeError} If the given value is an invalid locator.<tr><td><a id="l236"></a><a href="#l236">236</a><td> */<tr><td><a id="l237"></a><a href="#l237">237</a><td>webdriver.Locator.checkLocator = function(value) {<tr><td><a id="l238"></a><a href="#l238">238</a><td>  if (goog.isFunction(value) || value instanceof webdriver.Locator) {<tr><td><a id="l239"></a><a href="#l239">239</a><td>    return value;<tr><td><a id="l240"></a><a href="#l240">240</a><td>  }<tr><td><a id="l241"></a><a href="#l241">241</a><td>  for (var key in value) {<tr><td><a id="l242"></a><a href="#l242">242</a><td>    if (value.hasOwnProperty(key) &amp;&amp;<tr><td><a id="l243"></a><a href="#l243">243</a><td>        webdriver.Locator.Strategy.hasOwnProperty(key)) {<tr><td><a id="l244"></a><a href="#l244">244</a><td>      return webdriver.Locator.Strategy[key](value[key]);<tr><td><a id="l245"></a><a href="#l245">245</a><td>    }<tr><td><a id="l246"></a><a href="#l246">246</a><td>  }<tr><td><a id="l247"></a><a href="#l247">247</a><td>  throw new TypeError(&#39;Invalid locator&#39;);<tr><td><a id="l248"></a><a href="#l248">248</a><td>};<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td>/** @override */<tr><td><a id="l253"></a><a href="#l253">253</a><td>webdriver.Locator.prototype.toString = function() {<tr><td><a id="l254"></a><a href="#l254">254</a><td>  return &#39;By.&#39; + this.using.replace(/ ([a-z])/g, function(all, match) {<tr><td><a id="l255"></a><a href="#l255">255</a><td>    return match.toUpperCase();<tr><td><a id="l256"></a><a href="#l256">256</a><td>  }) + &#39;(&#39; + goog.string.quote(this.value) + &#39;)&#39;;<tr><td><a id="l257"></a><a href="#l257">257</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/logging.js.src.html b/docs/source/lib/webdriver/logging.js.src.html
index b9153c0..6d4709c 100644
--- a/docs/source/lib/webdriver/logging.js.src.html
+++ b/docs/source/lib/webdriver/logging.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>logging.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/logging.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium comitters<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>// You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>goog.provide(&#39;webdriver.logging&#39;);<tr><td><a name="l17" href="#l17">17</a><td>goog.provide(&#39;webdriver.logging.Preferences&#39;);<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>/**<tr><td><a name="l23" href="#l23">23</a><td> * Log level names from WebDriver&#39;s JSON wire protocol.<tr><td><a name="l24" href="#l24">24</a><td> * @enum {string}<tr><td><a name="l25" href="#l25">25</a><td> */<tr><td><a name="l26" href="#l26">26</a><td>webdriver.logging.LevelName = {<tr><td><a name="l27" href="#l27">27</a><td>  ALL: &#39;ALL&#39;,<tr><td><a name="l28" href="#l28">28</a><td>  DEBUG: &#39;DEBUG&#39;,<tr><td><a name="l29" href="#l29">29</a><td>  INFO: &#39;INFO&#39;,<tr><td><a name="l30" href="#l30">30</a><td>  WARNING: &#39;WARNING&#39;,<tr><td><a name="l31" href="#l31">31</a><td>  SEVERE: &#39;SEVERE&#39;,<tr><td><a name="l32" href="#l32">32</a><td>  OFF: &#39;OFF&#39;<tr><td><a name="l33" href="#l33">33</a><td>};<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td>/**<tr><td><a name="l37" href="#l37">37</a><td> * Logging levels.<tr><td><a name="l38" href="#l38">38</a><td> * @enum {{value: number, name: webdriver.logging.LevelName}}<tr><td><a name="l39" href="#l39">39</a><td> */<tr><td><a name="l40" href="#l40">40</a><td>webdriver.logging.Level = {<tr><td><a name="l41" href="#l41">41</a><td>  ALL: {value: Number.MIN_VALUE, name: webdriver.logging.LevelName.ALL},<tr><td><a name="l42" href="#l42">42</a><td>  DEBUG: {value: 700, name: webdriver.logging.LevelName.DEBUG},<tr><td><a name="l43" href="#l43">43</a><td>  INFO: {value: 800, name: webdriver.logging.LevelName.INFO},<tr><td><a name="l44" href="#l44">44</a><td>  WARNING: {value: 900, name: webdriver.logging.LevelName.WARNING},<tr><td><a name="l45" href="#l45">45</a><td>  SEVERE: {value: 1000, name: webdriver.logging.LevelName.SEVERE},<tr><td><a name="l46" href="#l46">46</a><td>  OFF: {value: Number.MAX_VALUE, name: webdriver.logging.LevelName.OFF}<tr><td><a name="l47" href="#l47">47</a><td>};<tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td><tr><td><a name="l50" href="#l50">50</a><td>/**<tr><td><a name="l51" href="#l51">51</a><td> * Converts a level name or value to a {@link webdriver.logging.Level} value.<tr><td><a name="l52" href="#l52">52</a><td> * If the name/value is not recognized, {@link webdriver.logging.Level.ALL}<tr><td><a name="l53" href="#l53">53</a><td> * will be returned.<tr><td><a name="l54" href="#l54">54</a><td> * @param {(number|string)} nameOrValue The log level name, or value, to<tr><td><a name="l55" href="#l55">55</a><td> *     convert .<tr><td><a name="l56" href="#l56">56</a><td> * @return {!webdriver.logging.Level} The converted level.<tr><td><a name="l57" href="#l57">57</a><td> */<tr><td><a name="l58" href="#l58">58</a><td>webdriver.logging.getLevel = function(nameOrValue) {<tr><td><a name="l59" href="#l59">59</a><td>  var predicate = goog.isString(nameOrValue) ?<tr><td><a name="l60" href="#l60">60</a><td>      function(val) { return val.name === nameOrValue; } :<tr><td><a name="l61" href="#l61">61</a><td>      function(val) { return val.value === nameOrValue; };<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td>  return goog.object.findValue(webdriver.logging.Level, predicate) ||<tr><td><a name="l64" href="#l64">64</a><td>      webdriver.logging.Level.ALL;<tr><td><a name="l65" href="#l65">65</a><td>};<tr><td><a name="l66" href="#l66">66</a><td><tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td>/**<tr><td><a name="l69" href="#l69">69</a><td> * Common log types.<tr><td><a name="l70" href="#l70">70</a><td> * @enum {string}<tr><td><a name="l71" href="#l71">71</a><td> */<tr><td><a name="l72" href="#l72">72</a><td>webdriver.logging.Type = {<tr><td><a name="l73" href="#l73">73</a><td>  /** Logs originating from the browser. */<tr><td><a name="l74" href="#l74">74</a><td>  BROWSER: &#39;browser&#39;,<tr><td><a name="l75" href="#l75">75</a><td>  /** Logs from a WebDriver client. */<tr><td><a name="l76" href="#l76">76</a><td>  CLIENT: &#39;client&#39;,<tr><td><a name="l77" href="#l77">77</a><td>  /** Logs from a WebDriver implementation. */<tr><td><a name="l78" href="#l78">78</a><td>  DRIVER: &#39;driver&#39;,<tr><td><a name="l79" href="#l79">79</a><td>  /** Logs related to performance. */<tr><td><a name="l80" href="#l80">80</a><td>  PERFORMANCE: &#39;performance&#39;,<tr><td><a name="l81" href="#l81">81</a><td>  /** Logs from the remote server. */<tr><td><a name="l82" href="#l82">82</a><td>  SERVER: &#39;server&#39;<tr><td><a name="l83" href="#l83">83</a><td>};<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td>/**<tr><td><a name="l87" href="#l87">87</a><td> * A hash describing log preferences.<tr><td><a name="l88" href="#l88">88</a><td> * @typedef {Object.&lt;webdriver.logging.Type, webdriver.logging.LevelName&gt;}<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.logging.Preferences;<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>/**<tr><td><a name="l94" href="#l94">94</a><td> * A single log entry.<tr><td><a name="l95" href="#l95">95</a><td> * @param {(!webdriver.logging.Level|string)} level The entry level.<tr><td><a name="l96" href="#l96">96</a><td> * @param {string} message The log message.<tr><td><a name="l97" href="#l97">97</a><td> * @param {number=} opt_timestamp The time this entry was generated, in<tr><td><a name="l98" href="#l98">98</a><td> *     milliseconds since 0:00:00, January 1, 1970 UTC. If omitted, the<tr><td><a name="l99" href="#l99">99</a><td> *     current time will be used.<tr><td><a name="l100" href="#l100">100</a><td> * @param {string=} opt_type The log type, if known.<tr><td><a name="l101" href="#l101">101</a><td> * @constructor<tr><td><a name="l102" href="#l102">102</a><td> */<tr><td><a name="l103" href="#l103">103</a><td>webdriver.logging.Entry = function(level, message, opt_timestamp, opt_type) {<tr><td><a name="l104" href="#l104">104</a><td><tr><td><a name="l105" href="#l105">105</a><td>  /** @type {!webdriver.logging.Level} */<tr><td><a name="l106" href="#l106">106</a><td>  this.level =<tr><td><a name="l107" href="#l107">107</a><td>      goog.isString(level) ? webdriver.logging.getLevel(level) : level;<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td>  /** @type {string} */<tr><td><a name="l110" href="#l110">110</a><td>  this.message = message;<tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td>  /** @type {number} */<tr><td><a name="l113" href="#l113">113</a><td>  this.timestamp = goog.isNumber(opt_timestamp) ? opt_timestamp : goog.now();<tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>  /** @type {string} */<tr><td><a name="l116" href="#l116">116</a><td>  this.type = opt_type || &#39;&#39;;<tr><td><a name="l117" href="#l117">117</a><td>};<tr><td><a name="l118" href="#l118">118</a><td><tr><td><a name="l119" href="#l119">119</a><td><tr><td><a name="l120" href="#l120">120</a><td>/**<tr><td><a name="l121" href="#l121">121</a><td> * @return {{level: string, message: string, timestamp: number,<tr><td><a name="l122" href="#l122">122</a><td> *           type: string}} The JSON representation of this entry.<tr><td><a name="l123" href="#l123">123</a><td> */<tr><td><a name="l124" href="#l124">124</a><td>webdriver.logging.Entry.prototype.toJSON = function() {<tr><td><a name="l125" href="#l125">125</a><td>  return {<tr><td><a name="l126" href="#l126">126</a><td>    &#39;level&#39;: this.level.name,<tr><td><a name="l127" href="#l127">127</a><td>    &#39;message&#39;: this.message,<tr><td><a name="l128" href="#l128">128</a><td>    &#39;timestamp&#39;: this.timestamp,<tr><td><a name="l129" href="#l129">129</a><td>    &#39;type&#39;: this.type<tr><td><a name="l130" href="#l130">130</a><td>  };<tr><td><a name="l131" href="#l131">131</a><td>};<tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td>/**<tr><td><a name="l135" href="#l135">135</a><td> * Converts a {@link goog.debug.LogRecord} into a<tr><td><a name="l136" href="#l136">136</a><td> * {@link webdriver.logging.Entry}.<tr><td><a name="l137" href="#l137">137</a><td> * @param {!goog.debug.LogRecord} logRecord The record to convert.<tr><td><a name="l138" href="#l138">138</a><td> * @param {string=} opt_type The log type.<tr><td><a name="l139" href="#l139">139</a><td> * @return {!webdriver.logging.Entry} The converted entry.<tr><td><a name="l140" href="#l140">140</a><td> */<tr><td><a name="l141" href="#l141">141</a><td>webdriver.logging.Entry.fromClosureLogRecord = function(logRecord, opt_type) {<tr><td><a name="l142" href="#l142">142</a><td>  var closureLevel = logRecord.getLevel();<tr><td><a name="l143" href="#l143">143</a><td>  var level = webdriver.logging.Level.SEVERE;<tr><td><a name="l144" href="#l144">144</a><td><tr><td><a name="l145" href="#l145">145</a><td>  if (closureLevel.value &lt;= webdriver.logging.Level.DEBUG.value) {<tr><td><a name="l146" href="#l146">146</a><td>    level = webdriver.logging.Level.DEBUG;<tr><td><a name="l147" href="#l147">147</a><td>  } else if (closureLevel.value &lt;= webdriver.logging.Level.INFO.value) {<tr><td><a name="l148" href="#l148">148</a><td>    level = webdriver.logging.Level.INFO;<tr><td><a name="l149" href="#l149">149</a><td>  } else if (closureLevel.value &lt;= webdriver.logging.Level.WARNING.value) {<tr><td><a name="l150" href="#l150">150</a><td>    level = webdriver.logging.Level.WARNING;<tr><td><a name="l151" href="#l151">151</a><td>  }<tr><td><a name="l152" href="#l152">152</a><td><tr><td><a name="l153" href="#l153">153</a><td>  return new webdriver.logging.Entry(<tr><td><a name="l154" href="#l154">154</a><td>      level,<tr><td><a name="l155" href="#l155">155</a><td>      &#39;[&#39; + logRecord.getLoggerName() + &#39;] &#39; + logRecord.getMessage(),<tr><td><a name="l156" href="#l156">156</a><td>      logRecord.getMillis(),<tr><td><a name="l157" href="#l157">157</a><td>      opt_type);<tr><td><a name="l158" href="#l158">158</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>logging.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/webdriver/logging.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines WebDriver&#39;s logging system. The logging system is<tr><td><a id="l20"></a><a href="#l20">20</a><td> * broken into major components: local and remote logging.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * The local logging API, which is anchored by the<tr><td><a id="l23"></a><a href="#l23">23</a><td> * {@link webdriver.logging.Logger Logger} class, is similar to Java&#39;s<tr><td><a id="l24"></a><a href="#l24">24</a><td> * logging API. Loggers, retrieved by {@link webdriver.logging.getLogger}, use<tr><td><a id="l25"></a><a href="#l25">25</a><td> * hierarchical, dot-delimited namespaces<tr><td><a id="l26"></a><a href="#l26">26</a><td> * (e.g. &quot;&quot; &gt; &quot;webdriver&quot; &gt; &quot;webdriver.logging&quot;). Recorded log messages are<tr><td><a id="l27"></a><a href="#l27">27</a><td> * represented by the {@link webdriver.logging.LogRecord LogRecord} class. You<tr><td><a id="l28"></a><a href="#l28">28</a><td> * can capture log records by<tr><td><a id="l29"></a><a href="#l29">29</a><td> * {@linkplain webdriver.logging.Logger#addHandler attaching} a handler function<tr><td><a id="l30"></a><a href="#l30">30</a><td> * to the desired logger. For convenience, you can quickly enable logging to<tr><td><a id="l31"></a><a href="#l31">31</a><td> * the console by simply calling<tr><td><a id="l32"></a><a href="#l32">32</a><td> * {@link webdriver.logging.installConsoleHandler()}.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * The [remote logging API](https://github.com/SeleniumHQ/selenium/wiki/Logging)<tr><td><a id="l35"></a><a href="#l35">35</a><td> * allows you to retrieve logs from a remote WebDriver server. This API uses the<tr><td><a id="l36"></a><a href="#l36">36</a><td> * {@link Preferences} class to define desired log levels prior to create a<tr><td><a id="l37"></a><a href="#l37">37</a><td> * WebDriver session:<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> *     var prefs = new webdriver.logging.Preferences();<tr><td><a id="l40"></a><a href="#l40">40</a><td> *     prefs.setLevel(webdriver.logging.Type.BROWSER,<tr><td><a id="l41"></a><a href="#l41">41</a><td> *                    webdriver.logging.Level.DEBUG);<tr><td><a id="l42"></a><a href="#l42">42</a><td> *<tr><td><a id="l43"></a><a href="#l43">43</a><td> *     var caps = webdriver.Capabilities.chrome();<tr><td><a id="l44"></a><a href="#l44">44</a><td> *     caps.setLoggingPrefs(prefs);<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> * Remote log entries are represented by the {@link Entry} class and may be<tr><td><a id="l48"></a><a href="#l48">48</a><td> * retrieved via {@link webdriver.WebDriver.Logs}:<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> *     driver.manage().logs().get(webdriver.logging.Type.BROWSER)<tr><td><a id="l51"></a><a href="#l51">51</a><td> *         .then(function(entries) {<tr><td><a id="l52"></a><a href="#l52">52</a><td> *            entries.forEach(function(entry) {<tr><td><a id="l53"></a><a href="#l53">53</a><td> *              console.log(&#39;[%s] %s&#39;, entry.level.name, entry.message);<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> * **NOTE:** Only a few browsers support the remote logging API (notably<tr><td><a id="l58"></a><a href="#l58">58</a><td> * Firefox and Chrome). Firefox supports basic logging functionality, while<tr><td><a id="l59"></a><a href="#l59">59</a><td> * Chrome exposes robust<tr><td><a id="l60"></a><a href="#l60">60</a><td> * [performance logging](https://sites.google.com/a/chromium.org/chromedriver/logging)<tr><td><a id="l61"></a><a href="#l61">61</a><td> * options. Remote logging is still considered a non-standard feature, and the<tr><td><a id="l62"></a><a href="#l62">62</a><td> * APIs exposed by this module for it are non-frozen. Once logging is officially<tr><td><a id="l63"></a><a href="#l63">63</a><td> * defined by the [W3C WebDriver spec](http://www.w3.org/TR/webdriver/), this<tr><td><a id="l64"></a><a href="#l64">64</a><td> * module will be updated to use a consistent API for local and remote logging.<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>goog.module(&#39;webdriver.logging&#39;);<tr><td><a id="l68"></a><a href="#l68">68</a><td>goog.module.declareLegacyNamespace();<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>var LogManager = goog.require(&#39;goog.debug.LogManager&#39;);<tr><td><a id="l71"></a><a href="#l71">71</a><td>var LogRecord = goog.require(&#39;goog.debug.LogRecord&#39;);<tr><td><a id="l72"></a><a href="#l72">72</a><td>var Logger = goog.require(&#39;goog.debug.Logger&#39;);<tr><td><a id="l73"></a><a href="#l73">73</a><td>var Objects = goog.require(&#39;goog.object&#39;);<tr><td><a id="l74"></a><a href="#l74">74</a><td>var padNumber = goog.require(&#39;goog.string&#39;).padNumber;<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/** @const */<tr><td><a id="l78"></a><a href="#l78">78</a><td>exports.LogRecord = LogRecord;<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td>/** @const */<tr><td><a id="l82"></a><a href="#l82">82</a><td>exports.Logger = Logger;<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>/** @const */<tr><td><a id="l86"></a><a href="#l86">86</a><td>exports.Level = Logger.Level;<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> * DEBUG is a message level for debugging messages and has the same log level<tr><td><a id="l91"></a><a href="#l91">91</a><td> * as the {@link Logger.Level.CONFIG} message level.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @const {!Logger.Level}<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td>Logger.Level.DEBUG = new Logger.Level(&#39;DEBUG&#39;, Logger.Level.CONFIG.value);<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Finds a named logger.<tr><td><a id="l99"></a><a href="#l99">99</a><td> *<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {string=} opt_name The dot-delimited logger name, such as<tr><td><a id="l101"></a><a href="#l101">101</a><td> *     &quot;webdriver.logging.Logger&quot;. Defaults to the name of the root logger.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @return {!Logger} The named logger.<tr><td><a id="l103"></a><a href="#l103">103</a><td> */<tr><td><a id="l104"></a><a href="#l104">104</a><td>function getLogger(opt_name) {<tr><td><a id="l105"></a><a href="#l105">105</a><td>  return LogManager.getLogger(opt_name || Logger.ROOT_LOGGER_NAME);<tr><td><a id="l106"></a><a href="#l106">106</a><td>}<tr><td><a id="l107"></a><a href="#l107">107</a><td>exports.getLogger = getLogger;<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> * Logs all messages to the Console API.<tr><td><a id="l112"></a><a href="#l112">112</a><td> */<tr><td><a id="l113"></a><a href="#l113">113</a><td>function consoleHandler(record) {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  if (typeof console === &#39;undefined&#39; || !console) {<tr><td><a id="l115"></a><a href="#l115">115</a><td>    return;<tr><td><a id="l116"></a><a href="#l116">116</a><td>  }<tr><td><a id="l117"></a><a href="#l117">117</a><td>  record = /** @type {!LogRecord} */(record);<tr><td><a id="l118"></a><a href="#l118">118</a><td>  var timestamp = new Date(record.getMillis());<tr><td><a id="l119"></a><a href="#l119">119</a><td>  var msg =<tr><td><a id="l120"></a><a href="#l120">120</a><td>      &#39;[&#39; + timestamp.getUTCFullYear() + &#39;-&#39; +<tr><td><a id="l121"></a><a href="#l121">121</a><td>      padNumber(timestamp.getUTCMonth() + 1, 2) + &#39;-&#39; +<tr><td><a id="l122"></a><a href="#l122">122</a><td>      padNumber(timestamp.getUTCDate(), 2) + &#39;T&#39; +<tr><td><a id="l123"></a><a href="#l123">123</a><td>      padNumber(timestamp.getUTCHours(), 2) + &#39;:&#39; +<tr><td><a id="l124"></a><a href="#l124">124</a><td>      padNumber(timestamp.getUTCMinutes(), 2) + &#39;:&#39; +<tr><td><a id="l125"></a><a href="#l125">125</a><td>      padNumber(timestamp.getUTCSeconds(), 2) + &#39;Z]&#39; +<tr><td><a id="l126"></a><a href="#l126">126</a><td>      &#39;[&#39; + record.getLevel().name + &#39;]&#39; +<tr><td><a id="l127"></a><a href="#l127">127</a><td>      &#39;[&#39; + record.getLoggerName() + &#39;] &#39; +<tr><td><a id="l128"></a><a href="#l128">128</a><td>      record.getMessage();<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>  var level = record.getLevel().value;<tr><td><a id="l131"></a><a href="#l131">131</a><td>  if (level &gt;= Logger.Level.SEVERE.value) {<tr><td><a id="l132"></a><a href="#l132">132</a><td>    console.error(msg);<tr><td><a id="l133"></a><a href="#l133">133</a><td>  } else if (level &gt;= Logger.Level.WARNING.value) {<tr><td><a id="l134"></a><a href="#l134">134</a><td>    console.warn(msg);<tr><td><a id="l135"></a><a href="#l135">135</a><td>  } else {<tr><td><a id="l136"></a><a href="#l136">136</a><td>    console.log(msg);<tr><td><a id="l137"></a><a href="#l137">137</a><td>  }<tr><td><a id="l138"></a><a href="#l138">138</a><td>}<tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td>/**<tr><td><a id="l142"></a><a href="#l142">142</a><td> * Adds the console handler to the given logger. The console handler will log<tr><td><a id="l143"></a><a href="#l143">143</a><td> * all messages using the JavaScript Console API.<tr><td><a id="l144"></a><a href="#l144">144</a><td> *<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {Logger=} opt_logger The logger to add the handler to; defaults<tr><td><a id="l146"></a><a href="#l146">146</a><td> *     to the root logger.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @see exports.removeConsoleHandler<tr><td><a id="l148"></a><a href="#l148">148</a><td> */<tr><td><a id="l149"></a><a href="#l149">149</a><td>exports.addConsoleHandler = function(opt_logger) {<tr><td><a id="l150"></a><a href="#l150">150</a><td>  var logger = opt_logger || getLogger();<tr><td><a id="l151"></a><a href="#l151">151</a><td>  logger.addHandler(consoleHandler);<tr><td><a id="l152"></a><a href="#l152">152</a><td>};<tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td>/**<tr><td><a id="l156"></a><a href="#l156">156</a><td> * Installs the console log handler on the root logger.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @see exports.addConsoleHandler<tr><td><a id="l158"></a><a href="#l158">158</a><td> */<tr><td><a id="l159"></a><a href="#l159">159</a><td>exports.installConsoleHandler = function() {<tr><td><a id="l160"></a><a href="#l160">160</a><td>  exports.addConsoleHandler();<tr><td><a id="l161"></a><a href="#l161">161</a><td>};<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>/**<tr><td><a id="l165"></a><a href="#l165">165</a><td> * Removes the console log handler from the given logger.<tr><td><a id="l166"></a><a href="#l166">166</a><td> *<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {Logger=} opt_logger The logger to remove the handler from; defaults<tr><td><a id="l168"></a><a href="#l168">168</a><td> *     to the root logger.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @see exports.addConsoleHandler<tr><td><a id="l170"></a><a href="#l170">170</a><td> */<tr><td><a id="l171"></a><a href="#l171">171</a><td>exports.removeConsoleHandler = function(opt_logger) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>  var logger = opt_logger || getLogger();<tr><td><a id="l173"></a><a href="#l173">173</a><td>  logger.removeHandler(consoleHandler);<tr><td><a id="l174"></a><a href="#l174">174</a><td>};<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * Converts a level name or value to a {@link webdriver.logging.Level} value.<tr><td><a id="l179"></a><a href="#l179">179</a><td> * If the name/value is not recognized, {@link webdriver.logging.Level.ALL}<tr><td><a id="l180"></a><a href="#l180">180</a><td> * will be returned.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {(number|string)} nameOrValue The log level name, or value, to<tr><td><a id="l182"></a><a href="#l182">182</a><td> *     convert .<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @return {!Logger.Level} The converted level.<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>function getLevel(nameOrValue) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>  // DEBUG is not a predefined Closure log level, but maps to CONFIG. Since<tr><td><a id="l187"></a><a href="#l187">187</a><td>  // DEBUG is a predefined level for the WebDriver protocol, we prefer it over<tr><td><a id="l188"></a><a href="#l188">188</a><td>  // CONFIG.<tr><td><a id="l189"></a><a href="#l189">189</a><td>  if (&#39;DEBUG&#39; === nameOrValue || Logger.Level.DEBUG.value === nameOrValue) {<tr><td><a id="l190"></a><a href="#l190">190</a><td>    return Logger.Level.DEBUG;<tr><td><a id="l191"></a><a href="#l191">191</a><td>  } else if (goog.isString(nameOrValue)) {<tr><td><a id="l192"></a><a href="#l192">192</a><td>    return Logger.Level.getPredefinedLevel(/** @type {string} */(nameOrValue))<tr><td><a id="l193"></a><a href="#l193">193</a><td>        || Logger.Level.ALL;<tr><td><a id="l194"></a><a href="#l194">194</a><td>  } else {<tr><td><a id="l195"></a><a href="#l195">195</a><td>    return Logger.Level.getPredefinedLevelByValue(<tr><td><a id="l196"></a><a href="#l196">196</a><td>        /** @type {number} */(nameOrValue)) || Logger.Level.ALL;<tr><td><a id="l197"></a><a href="#l197">197</a><td>  }<tr><td><a id="l198"></a><a href="#l198">198</a><td>}<tr><td><a id="l199"></a><a href="#l199">199</a><td>exports.getLevel = getLevel;<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> * Normalizes a {@link Logger.Level} to one of the distinct values recognized<tr><td><a id="l204"></a><a href="#l204">204</a><td> * by WebDriver&#39;s wire protocol.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @param {!Logger.Level} level The input level.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {!Logger.Level} The normalized level.<tr><td><a id="l207"></a><a href="#l207">207</a><td> */<tr><td><a id="l208"></a><a href="#l208">208</a><td>function normalizeLevel(level) {<tr><td><a id="l209"></a><a href="#l209">209</a><td>  if (level.value &lt;= Logger.Level.ALL.value) {          // ALL is 0.<tr><td><a id="l210"></a><a href="#l210">210</a><td>    return Logger.Level.ALL;<tr><td><a id="l211"></a><a href="#l211">211</a><td><tr><td><a id="l212"></a><a href="#l212">212</a><td>  } else if (level.value === Logger.Level.OFF.value) {  // OFF is Infinity<tr><td><a id="l213"></a><a href="#l213">213</a><td>    return Logger.Level.OFF;<tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>  } else if (level.value &lt; Logger.Level.INFO.value) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>    return Logger.Level.DEBUG;<tr><td><a id="l217"></a><a href="#l217">217</a><td><tr><td><a id="l218"></a><a href="#l218">218</a><td>  } else if (level.value &lt; Logger.Level.WARNING.value) {<tr><td><a id="l219"></a><a href="#l219">219</a><td>    return Logger.Level.INFO;<tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td>  } else if (level.value &lt; Logger.Level.SEVERE.value) {<tr><td><a id="l222"></a><a href="#l222">222</a><td>    return Logger.Level.WARNING;<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td>  } else {<tr><td><a id="l225"></a><a href="#l225">225</a><td>    return Logger.Level.SEVERE;<tr><td><a id="l226"></a><a href="#l226">226</a><td>  }<tr><td><a id="l227"></a><a href="#l227">227</a><td>}<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>/**<tr><td><a id="l231"></a><a href="#l231">231</a><td> * Common log types.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @enum {string}<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>var Type = {<tr><td><a id="l235"></a><a href="#l235">235</a><td>  /** Logs originating from the browser. */<tr><td><a id="l236"></a><a href="#l236">236</a><td>  BROWSER: &#39;browser&#39;,<tr><td><a id="l237"></a><a href="#l237">237</a><td>  /** Logs from a WebDriver client. */<tr><td><a id="l238"></a><a href="#l238">238</a><td>  CLIENT: &#39;client&#39;,<tr><td><a id="l239"></a><a href="#l239">239</a><td>  /** Logs from a WebDriver implementation. */<tr><td><a id="l240"></a><a href="#l240">240</a><td>  DRIVER: &#39;driver&#39;,<tr><td><a id="l241"></a><a href="#l241">241</a><td>  /** Logs related to performance. */<tr><td><a id="l242"></a><a href="#l242">242</a><td>  PERFORMANCE: &#39;performance&#39;,<tr><td><a id="l243"></a><a href="#l243">243</a><td>  /** Logs from the remote server. */<tr><td><a id="l244"></a><a href="#l244">244</a><td>  SERVER: &#39;server&#39;<tr><td><a id="l245"></a><a href="#l245">245</a><td>};<tr><td><a id="l246"></a><a href="#l246">246</a><td>exports.Type = Type;<tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td><tr><td><a id="l249"></a><a href="#l249">249</a><td>/**<tr><td><a id="l250"></a><a href="#l250">250</a><td> * Describes the log preferences for a WebDriver session.<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @final<tr><td><a id="l252"></a><a href="#l252">252</a><td> */<tr><td><a id="l253"></a><a href="#l253">253</a><td>var Preferences = goog.defineClass(null, {<tr><td><a id="l254"></a><a href="#l254">254</a><td>  /** @constructor */<tr><td><a id="l255"></a><a href="#l255">255</a><td>  constructor: function() {<tr><td><a id="l256"></a><a href="#l256">256</a><td>    /** @private {!Object.&lt;string, Logger.Level&gt;} */<tr><td><a id="l257"></a><a href="#l257">257</a><td>    this.prefs_ = {};<tr><td><a id="l258"></a><a href="#l258">258</a><td>  },<tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td>  /**<tr><td><a id="l261"></a><a href="#l261">261</a><td>   * Sets the desired logging level for a particular log type.<tr><td><a id="l262"></a><a href="#l262">262</a><td>   * @param {(string|Type)} type The log type.<tr><td><a id="l263"></a><a href="#l263">263</a><td>   * @param {!Logger.Level} level The desired log level.<tr><td><a id="l264"></a><a href="#l264">264</a><td>   */<tr><td><a id="l265"></a><a href="#l265">265</a><td>  setLevel: function(type, level) {<tr><td><a id="l266"></a><a href="#l266">266</a><td>    this.prefs_[type] = normalizeLevel(level);<tr><td><a id="l267"></a><a href="#l267">267</a><td>  },<tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td>  /**<tr><td><a id="l270"></a><a href="#l270">270</a><td>   * Converts this instance to its JSON representation.<tr><td><a id="l271"></a><a href="#l271">271</a><td>   * @return {!Object.&lt;string, string&gt;} The JSON representation of this set of<tr><td><a id="l272"></a><a href="#l272">272</a><td>   *     preferences.<tr><td><a id="l273"></a><a href="#l273">273</a><td>   */<tr><td><a id="l274"></a><a href="#l274">274</a><td>  toJSON: function() {<tr><td><a id="l275"></a><a href="#l275">275</a><td>    var obj = {};<tr><td><a id="l276"></a><a href="#l276">276</a><td>    for (var type in this.prefs_) {<tr><td><a id="l277"></a><a href="#l277">277</a><td>      if (this.prefs_.hasOwnProperty(type)) {<tr><td><a id="l278"></a><a href="#l278">278</a><td>        obj[type] = this.prefs_[type].name;<tr><td><a id="l279"></a><a href="#l279">279</a><td>      }<tr><td><a id="l280"></a><a href="#l280">280</a><td>    }<tr><td><a id="l281"></a><a href="#l281">281</a><td>    return obj;<tr><td><a id="l282"></a><a href="#l282">282</a><td>  }<tr><td><a id="l283"></a><a href="#l283">283</a><td>});<tr><td><a id="l284"></a><a href="#l284">284</a><td>exports.Preferences = Preferences;<tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td><tr><td><a id="l287"></a><a href="#l287">287</a><td>/**<tr><td><a id="l288"></a><a href="#l288">288</a><td> * A single log entry recorded by a WebDriver component, such as a remote<tr><td><a id="l289"></a><a href="#l289">289</a><td> * WebDriver server.<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @final<tr><td><a id="l291"></a><a href="#l291">291</a><td> */<tr><td><a id="l292"></a><a href="#l292">292</a><td>var Entry = goog.defineClass(null, {<tr><td><a id="l293"></a><a href="#l293">293</a><td>  /**<tr><td><a id="l294"></a><a href="#l294">294</a><td>   * @param {(!Logger.Level|string)} level The entry level.<tr><td><a id="l295"></a><a href="#l295">295</a><td>   * @param {string} message The log message.<tr><td><a id="l296"></a><a href="#l296">296</a><td>   * @param {number=} opt_timestamp The time this entry was generated, in<tr><td><a id="l297"></a><a href="#l297">297</a><td>   *     milliseconds since 0:00:00, January 1, 1970 UTC. If omitted, the<tr><td><a id="l298"></a><a href="#l298">298</a><td>   *     current time will be used.<tr><td><a id="l299"></a><a href="#l299">299</a><td>   * @param {string=} opt_type The log type, if known.<tr><td><a id="l300"></a><a href="#l300">300</a><td>   * @constructor<tr><td><a id="l301"></a><a href="#l301">301</a><td>   */<tr><td><a id="l302"></a><a href="#l302">302</a><td>  constructor: function(level, message, opt_timestamp, opt_type) {<tr><td><a id="l303"></a><a href="#l303">303</a><td><tr><td><a id="l304"></a><a href="#l304">304</a><td>    /** @type {!Logger.Level} */<tr><td><a id="l305"></a><a href="#l305">305</a><td>    this.level = goog.isString(level) ? getLevel(level) : level;<tr><td><a id="l306"></a><a href="#l306">306</a><td><tr><td><a id="l307"></a><a href="#l307">307</a><td>    /** @type {string} */<tr><td><a id="l308"></a><a href="#l308">308</a><td>    this.message = message;<tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>    /** @type {number} */<tr><td><a id="l311"></a><a href="#l311">311</a><td>    this.timestamp = goog.isNumber(opt_timestamp) ? opt_timestamp : goog.now();<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td>    /** @type {string} */<tr><td><a id="l314"></a><a href="#l314">314</a><td>    this.type = opt_type || &#39;&#39;;<tr><td><a id="l315"></a><a href="#l315">315</a><td>  },<tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td>  statics: {<tr><td><a id="l318"></a><a href="#l318">318</a><td>    /**<tr><td><a id="l319"></a><a href="#l319">319</a><td>     * Converts a {@link goog.debug.LogRecord} into a<tr><td><a id="l320"></a><a href="#l320">320</a><td>     * {@link webdriver.logging.Entry}.<tr><td><a id="l321"></a><a href="#l321">321</a><td>     * @param {!goog.debug.LogRecord} logRecord The record to convert.<tr><td><a id="l322"></a><a href="#l322">322</a><td>     * @param {string=} opt_type The log type.<tr><td><a id="l323"></a><a href="#l323">323</a><td>     * @return {!Entry} The converted entry.<tr><td><a id="l324"></a><a href="#l324">324</a><td>     */<tr><td><a id="l325"></a><a href="#l325">325</a><td>    fromClosureLogRecord: function(logRecord, opt_type) {<tr><td><a id="l326"></a><a href="#l326">326</a><td>      return new Entry(<tr><td><a id="l327"></a><a href="#l327">327</a><td>          normalizeLevel(/** @type {!Logger.Level} */(logRecord.getLevel())),<tr><td><a id="l328"></a><a href="#l328">328</a><td>          &#39;[&#39; + logRecord.getLoggerName() + &#39;] &#39; + logRecord.getMessage(),<tr><td><a id="l329"></a><a href="#l329">329</a><td>          logRecord.getMillis(),<tr><td><a id="l330"></a><a href="#l330">330</a><td>          opt_type);<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>  /**<tr><td><a id="l335"></a><a href="#l335">335</a><td>   * @return {{level: string, message: string, timestamp: number,<tr><td><a id="l336"></a><a href="#l336">336</a><td>   *           type: string}} The JSON representation of this entry.<tr><td><a id="l337"></a><a href="#l337">337</a><td>   */<tr><td><a id="l338"></a><a href="#l338">338</a><td>  toJSON: function() {<tr><td><a id="l339"></a><a href="#l339">339</a><td>    return {<tr><td><a id="l340"></a><a href="#l340">340</a><td>      &#39;level&#39;: this.level.name,<tr><td><a id="l341"></a><a href="#l341">341</a><td>      &#39;message&#39;: this.message,<tr><td><a id="l342"></a><a href="#l342">342</a><td>      &#39;timestamp&#39;: this.timestamp,<tr><td><a id="l343"></a><a href="#l343">343</a><td>      &#39;type&#39;: this.type<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>exports.Entry = Entry;</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/process.js.src.html b/docs/source/lib/webdriver/process.js.src.html
index e0d858c..3d53566 100644
--- a/docs/source/lib/webdriver/process.js.src.html
+++ b/docs/source/lib/webdriver/process.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>process.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/process.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides access to the current process&#39; environment variables.<tr><td><a name="l17" href="#l17">17</a><td> * When running in node, this is simply a wrapper for {@code process.env}.<tr><td><a name="l18" href="#l18">18</a><td> * When running in a browser, environment variables are loaded by parsing the<tr><td><a name="l19" href="#l19">19</a><td> * current URL&#39;s query string. Variables that have more than one variable will<tr><td><a name="l20" href="#l20">20</a><td> * be initialized to the JSON representation of the array of all values,<tr><td><a name="l21" href="#l21">21</a><td> * otherwise the variable will be initialized to a sole string value. If a<tr><td><a name="l22" href="#l22">22</a><td> * variable does not have any values, but is nonetheless present in the query<tr><td><a name="l23" href="#l23">23</a><td> * string, it will be initialized to an empty string.<tr><td><a name="l24" href="#l24">24</a><td> * After the initial parsing, environment variables must be queried and set<tr><td><a name="l25" href="#l25">25</a><td> * through the API defined in this file.<tr><td><a name="l26" href="#l26">26</a><td> */<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>goog.provide(&#39;webdriver.process&#39;);<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td>goog.require(&#39;goog.Uri&#39;);<tr><td><a name="l31" href="#l31">31</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l32" href="#l32">32</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>/**<tr><td><a name="l36" href="#l36">36</a><td> * @return {boolean} Whether the current process is Node&#39;s native process<tr><td><a name="l37" href="#l37">37</a><td> *     object.<tr><td><a name="l38" href="#l38">38</a><td> */<tr><td><a name="l39" href="#l39">39</a><td>webdriver.process.isNative = function() {<tr><td><a name="l40" href="#l40">40</a><td>  return webdriver.process.IS_NATIVE_PROCESS_;<tr><td><a name="l41" href="#l41">41</a><td>};<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td>/**<tr><td><a name="l45" href="#l45">45</a><td> * Queries for a named environment variable.<tr><td><a name="l46" href="#l46">46</a><td> * @param {string} name The name of the environment variable to look up.<tr><td><a name="l47" href="#l47">47</a><td> * @param {string=} opt_default The default value if the named variable is not<tr><td><a name="l48" href="#l48">48</a><td> *     defined.<tr><td><a name="l49" href="#l49">49</a><td> * @return {string} The queried environment variable.<tr><td><a name="l50" href="#l50">50</a><td> */<tr><td><a name="l51" href="#l51">51</a><td>webdriver.process.getEnv = function(name, opt_default) {<tr><td><a name="l52" href="#l52">52</a><td>  var value = webdriver.process.PROCESS_.env[name];<tr><td><a name="l53" href="#l53">53</a><td>  return goog.isDefAndNotNull(value) ? value : opt_default;<tr><td><a name="l54" href="#l54">54</a><td>};<tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td>/**<tr><td><a name="l58" href="#l58">58</a><td> * Sets an environment value. If the new value is either null or undefined, the<tr><td><a name="l59" href="#l59">59</a><td> *     environment variable will be cleared.<tr><td><a name="l60" href="#l60">60</a><td> * @param {string} name The value to set.<tr><td><a name="l61" href="#l61">61</a><td> * @param {*} value The new value; will be coerced to a string.<tr><td><a name="l62" href="#l62">62</a><td> */<tr><td><a name="l63" href="#l63">63</a><td>webdriver.process.setEnv = function(name, value) {<tr><td><a name="l64" href="#l64">64</a><td>  webdriver.process.PROCESS_.env[name] =<tr><td><a name="l65" href="#l65">65</a><td>      goog.isDefAndNotNull(value) ? value + &#39;&#39; : null;<tr><td><a name="l66" href="#l66">66</a><td>};<tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td><tr><td><a name="l69" href="#l69">69</a><td>/**<tr><td><a name="l70" href="#l70">70</a><td> * Whether the current environment is using Node&#39;s native process object.<tr><td><a name="l71" href="#l71">71</a><td> * @private {boolean}<tr><td><a name="l72" href="#l72">72</a><td> * @const<tr><td><a name="l73" href="#l73">73</a><td> */<tr><td><a name="l74" href="#l74">74</a><td>webdriver.process.IS_NATIVE_PROCESS_ = typeof process !== &#39;undefined&#39;;<tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td>/**<tr><td><a name="l78" href="#l78">78</a><td> * Initializes a process object for use in a browser window.<tr><td><a name="l79" href="#l79">79</a><td> * @param {!Window=} opt_window The window object to initialize the process<tr><td><a name="l80" href="#l80">80</a><td> *     from; if not specified, will default to the current window. Should only<tr><td><a name="l81" href="#l81">81</a><td> *     be set for unit testing.<tr><td><a name="l82" href="#l82">82</a><td> * @return {!Object} The new process object.<tr><td><a name="l83" href="#l83">83</a><td> * @private<tr><td><a name="l84" href="#l84">84</a><td> */<tr><td><a name="l85" href="#l85">85</a><td>webdriver.process.initBrowserProcess_ = function(opt_window) {<tr><td><a name="l86" href="#l86">86</a><td>  var process = {&#39;env&#39;: {}};<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td>  var win = opt_window;<tr><td><a name="l89" href="#l89">89</a><td>  if (!win &amp;&amp; typeof window != &#39;undefined&#39;) {<tr><td><a name="l90" href="#l90">90</a><td>    win = window;<tr><td><a name="l91" href="#l91">91</a><td>  }<tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>  // Initialize the global error handler.<tr><td><a name="l94" href="#l94">94</a><td>  if (win) {<tr><td><a name="l95" href="#l95">95</a><td>    // Initialize the environment variable map by parsing the current URL query<tr><td><a name="l96" href="#l96">96</a><td>    // string.<tr><td><a name="l97" href="#l97">97</a><td>    if (win.location) {<tr><td><a name="l98" href="#l98">98</a><td>      var data = new goog.Uri(win.location).getQueryData();<tr><td><a name="l99" href="#l99">99</a><td>      goog.array.forEach(data.getKeys(), function(key) {<tr><td><a name="l100" href="#l100">100</a><td>        var values = data.getValues(key);<tr><td><a name="l101" href="#l101">101</a><td>        process.env[key] = values.length == 0 ? &#39;&#39; :<tr><td><a name="l102" href="#l102">102</a><td>                           values.length == 1 ? values[0] :<tr><td><a name="l103" href="#l103">103</a><td>                           goog.json.serialize(values);<tr><td><a name="l104" href="#l104">104</a><td>      });<tr><td><a name="l105" href="#l105">105</a><td>    }<tr><td><a name="l106" href="#l106">106</a><td>  }<tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td>  return process;<tr><td><a name="l109" href="#l109">109</a><td>};<tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td>/**<tr><td><a name="l113" href="#l113">113</a><td> * The global process object to use. Will either be Node&#39;s global<tr><td><a name="l114" href="#l114">114</a><td> * {@code process} object, or an approximation of it for use in a browser<tr><td><a name="l115" href="#l115">115</a><td> * environment.<tr><td><a name="l116" href="#l116">116</a><td> * @private {!Object}<tr><td><a name="l117" href="#l117">117</a><td> * @const<tr><td><a name="l118" href="#l118">118</a><td> */<tr><td><a name="l119" href="#l119">119</a><td>webdriver.process.PROCESS_ = webdriver.process.IS_NATIVE_PROCESS_ ? process :<tr><td><a name="l120" href="#l120">120</a><td>    webdriver.process.initBrowserProcess_();</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>process.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/process.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Provides access to the current process&#39; environment variables.<tr><td><a name="l17" href="#l17">17</a><td> * When running in node, this is simply a wrapper for {@code process.env}.<tr><td><a name="l18" href="#l18">18</a><td> * When running in a browser, environment variables are loaded by parsing the<tr><td><a name="l19" href="#l19">19</a><td> * current URL&#39;s query string. Variables that have more than one variable will<tr><td><a name="l20" href="#l20">20</a><td> * be initialized to the JSON representation of the array of all values,<tr><td><a name="l21" href="#l21">21</a><td> * otherwise the variable will be initialized to a sole string value. If a<tr><td><a name="l22" href="#l22">22</a><td> * variable does not have any values, but is nonetheless present in the query<tr><td><a name="l23" href="#l23">23</a><td> * string, it will be initialized to an empty string.<tr><td><a name="l24" href="#l24">24</a><td> * After the initial parsing, environment variables must be queried and set<tr><td><a name="l25" href="#l25">25</a><td> * through the API defined in this file.<tr><td><a name="l26" href="#l26">26</a><td> */<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>goog.provide(&#39;webdriver.process&#39;);<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td>goog.require(&#39;goog.Uri&#39;);<tr><td><a name="l31" href="#l31">31</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l32" href="#l32">32</a><td>goog.require(&#39;goog.json&#39;);<tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>/**<tr><td><a name="l36" href="#l36">36</a><td> * @return {boolean} Whether the current process is Node&#39;s native process<tr><td><a name="l37" href="#l37">37</a><td> *     object.<tr><td><a name="l38" href="#l38">38</a><td> */<tr><td><a name="l39" href="#l39">39</a><td>webdriver.process.isNative = function() {<tr><td><a name="l40" href="#l40">40</a><td>  return webdriver.process.IS_NATIVE_PROCESS_;<tr><td><a name="l41" href="#l41">41</a><td>};<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td><tr><td><a name="l44" href="#l44">44</a><td>/**<tr><td><a name="l45" href="#l45">45</a><td> * Queries for a named environment variable.<tr><td><a name="l46" href="#l46">46</a><td> * @param {string} name The name of the environment variable to look up.<tr><td><a name="l47" href="#l47">47</a><td> * @param {string=} opt_default The default value if the named variable is not<tr><td><a name="l48" href="#l48">48</a><td> *     defined.<tr><td><a name="l49" href="#l49">49</a><td> * @return {string} The queried environment variable.<tr><td><a name="l50" href="#l50">50</a><td> */<tr><td><a name="l51" href="#l51">51</a><td>webdriver.process.getEnv = function(name, opt_default) {<tr><td><a name="l52" href="#l52">52</a><td>  var value = webdriver.process.PROCESS_.env[name];<tr><td><a name="l53" href="#l53">53</a><td>  return goog.isDefAndNotNull(value) ? value : opt_default;<tr><td><a name="l54" href="#l54">54</a><td>};<tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td>/**<tr><td><a name="l58" href="#l58">58</a><td> * Sets an environment value. If the new value is either null or undefined, the<tr><td><a name="l59" href="#l59">59</a><td> *     environment variable will be cleared.<tr><td><a name="l60" href="#l60">60</a><td> * @param {string} name The value to set.<tr><td><a name="l61" href="#l61">61</a><td> * @param {*} value The new value; will be coerced to a string.<tr><td><a name="l62" href="#l62">62</a><td> */<tr><td><a name="l63" href="#l63">63</a><td>webdriver.process.setEnv = function(name, value) {<tr><td><a name="l64" href="#l64">64</a><td>  webdriver.process.PROCESS_.env[name] =<tr><td><a name="l65" href="#l65">65</a><td>      goog.isDefAndNotNull(value) ? value + &#39;&#39; : null;<tr><td><a name="l66" href="#l66">66</a><td>};<tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td><tr><td><a name="l69" href="#l69">69</a><td>/**<tr><td><a name="l70" href="#l70">70</a><td> * Whether the current environment is using Node&#39;s native process object.<tr><td><a name="l71" href="#l71">71</a><td> * @private {boolean}<tr><td><a name="l72" href="#l72">72</a><td> * @const<tr><td><a name="l73" href="#l73">73</a><td> */<tr><td><a name="l74" href="#l74">74</a><td>webdriver.process.IS_NATIVE_PROCESS_ = typeof process !== &#39;undefined&#39;;<tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td>/**<tr><td><a name="l78" href="#l78">78</a><td> * Initializes a process object for use in a browser window.<tr><td><a name="l79" href="#l79">79</a><td> * @param {!Window=} opt_window The window object to initialize the process<tr><td><a name="l80" href="#l80">80</a><td> *     from; if not specified, will default to the current window. Should only<tr><td><a name="l81" href="#l81">81</a><td> *     be set for unit testing.<tr><td><a name="l82" href="#l82">82</a><td> * @return {!Object} The new process object.<tr><td><a name="l83" href="#l83">83</a><td> * @private<tr><td><a name="l84" href="#l84">84</a><td> */<tr><td><a name="l85" href="#l85">85</a><td>webdriver.process.initBrowserProcess_ = function(opt_window) {<tr><td><a name="l86" href="#l86">86</a><td>  var process = {&#39;env&#39;: {}};<tr><td><a name="l87" href="#l87">87</a><td><tr><td><a name="l88" href="#l88">88</a><td>  var win = opt_window;<tr><td><a name="l89" href="#l89">89</a><td>  if (!win &amp;&amp; typeof window != &#39;undefined&#39;) {<tr><td><a name="l90" href="#l90">90</a><td>    win = window;<tr><td><a name="l91" href="#l91">91</a><td>  }<tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>  // Initialize the global error handler.<tr><td><a name="l94" href="#l94">94</a><td>  if (win) {<tr><td><a name="l95" href="#l95">95</a><td>    // Initialize the environment variable map by parsing the current URL query<tr><td><a name="l96" href="#l96">96</a><td>    // string.<tr><td><a name="l97" href="#l97">97</a><td>    if (win.location) {<tr><td><a name="l98" href="#l98">98</a><td>      var data = new goog.Uri(win.location).getQueryData();<tr><td><a name="l99" href="#l99">99</a><td>      goog.array.forEach(data.getKeys(), function(key) {<tr><td><a name="l100" href="#l100">100</a><td>        var values = data.getValues(key);<tr><td><a name="l101" href="#l101">101</a><td>        process.env[key] = values.length == 0 ? &#39;&#39; :<tr><td><a name="l102" href="#l102">102</a><td>                           values.length == 1 ? values[0] :<tr><td><a name="l103" href="#l103">103</a><td>                           goog.json.serialize(values);<tr><td><a name="l104" href="#l104">104</a><td>      });<tr><td><a name="l105" href="#l105">105</a><td>    }<tr><td><a name="l106" href="#l106">106</a><td>  }<tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td>  return process;<tr><td><a name="l109" href="#l109">109</a><td>};<tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td><tr><td><a name="l112" href="#l112">112</a><td>/**<tr><td><a name="l113" href="#l113">113</a><td> * The global process object to use. Will either be Node&#39;s global<tr><td><a name="l114" href="#l114">114</a><td> * {@code process} object, or an approximation of it for use in a browser<tr><td><a name="l115" href="#l115">115</a><td> * environment.<tr><td><a name="l116" href="#l116">116</a><td> * @private {!Object}<tr><td><a name="l117" href="#l117">117</a><td> * @const<tr><td><a name="l118" href="#l118">118</a><td> */<tr><td><a name="l119" href="#l119">119</a><td>webdriver.process.PROCESS_ = webdriver.process.IS_NATIVE_PROCESS_ ? process :<tr><td><a name="l120" href="#l120">120</a><td>    webdriver.process.initBrowserProcess_();</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/promise.js.src.html b/docs/source/lib/webdriver/promise.js.src.html
index 3867895..59098c6 100644
--- a/docs/source/lib/webdriver/promise.js.src.html
+++ b/docs/source/lib/webdriver/promise.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>promise.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/promise.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @license Portions of this code are from the Dojo toolkit, received under the<tr><td><a name="l17" href="#l17">17</a><td> * BSD License:<tr><td><a name="l18" href="#l18">18</a><td> * Redistribution and use in source and binary forms, with or without<tr><td><a name="l19" href="#l19">19</a><td> * modification, are permitted provided that the following conditions are met:<tr><td><a name="l20" href="#l20">20</a><td> *<tr><td><a name="l21" href="#l21">21</a><td> *   * Redistributions of source code must retain the above copyright notice,<tr><td><a name="l22" href="#l22">22</a><td> *     this list of conditions and the following disclaimer.<tr><td><a name="l23" href="#l23">23</a><td> *   * Redistributions in binary form must reproduce the above copyright notice,<tr><td><a name="l24" href="#l24">24</a><td> *     this list of conditions and the following disclaimer in the documentation<tr><td><a name="l25" href="#l25">25</a><td> *     and/or other materials provided with the distribution.<tr><td><a name="l26" href="#l26">26</a><td> *   * Neither the name of the Dojo Foundation nor the names of its contributors<tr><td><a name="l27" href="#l27">27</a><td> *     may be used to endorse or promote products derived from this software<tr><td><a name="l28" href="#l28">28</a><td> *     without specific prior written permission.<tr><td><a name="l29" href="#l29">29</a><td> *<tr><td><a name="l30" href="#l30">30</a><td> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS &quot;AS IS&quot;<tr><td><a name="l31" href="#l31">31</a><td> * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE<tr><td><a name="l32" href="#l32">32</a><td> * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE<tr><td><a name="l33" href="#l33">33</a><td> * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE<tr><td><a name="l34" href="#l34">34</a><td> * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR<tr><td><a name="l35" href="#l35">35</a><td> * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF<tr><td><a name="l36" href="#l36">36</a><td> * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS<tr><td><a name="l37" href="#l37">37</a><td> * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN<tr><td><a name="l38" href="#l38">38</a><td> * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)<tr><td><a name="l39" href="#l39">39</a><td> * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE<tr><td><a name="l40" href="#l40">40</a><td> * POSSIBILITY OF SUCH DAMAGE.<tr><td><a name="l41" href="#l41">41</a><td> */<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>/**<tr><td><a name="l44" href="#l44">44</a><td> * @fileoverview A promise implementation based on the CommonJS promise/A and<tr><td><a name="l45" href="#l45">45</a><td> * promise/B proposals. For more information, see<tr><td><a name="l46" href="#l46">46</a><td> * http://wiki.commonjs.org/wiki/Promises.<tr><td><a name="l47" href="#l47">47</a><td> */<tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>goog.provide(&#39;webdriver.promise&#39;);<tr><td><a name="l50" href="#l50">50</a><td>goog.provide(&#39;webdriver.promise.ControlFlow&#39;);<tr><td><a name="l51" href="#l51">51</a><td>goog.provide(&#39;webdriver.promise.ControlFlow.Timer&#39;);<tr><td><a name="l52" href="#l52">52</a><td>goog.provide(&#39;webdriver.promise.Deferred&#39;);<tr><td><a name="l53" href="#l53">53</a><td>goog.provide(&#39;webdriver.promise.Promise&#39;);<tr><td><a name="l54" href="#l54">54</a><td><tr><td><a name="l55" href="#l55">55</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l56" href="#l56">56</a><td>goog.require(&#39;goog.debug.Error&#39;);<tr><td><a name="l57" href="#l57">57</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a name="l58" href="#l58">58</a><td>goog.require(&#39;webdriver.EventEmitter&#39;);<tr><td><a name="l59" href="#l59">59</a><td>goog.require(&#39;webdriver.stacktrace.Snapshot&#39;);<tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td>/**<tr><td><a name="l64" href="#l64">64</a><td> * Represents the eventual value of a completed operation. Each promise may be<tr><td><a name="l65" href="#l65">65</a><td> * in one of three states: pending, resolved, or rejected. Each promise starts<tr><td><a name="l66" href="#l66">66</a><td> * in the pending state and may make a single transition to either a<tr><td><a name="l67" href="#l67">67</a><td> * fulfilled or failed state.<tr><td><a name="l68" href="#l68">68</a><td> *<tr><td><a name="l69" href="#l69">69</a><td> * &lt;p/&gt;This class is based on the Promise/A proposal from CommonJS. Additional<tr><td><a name="l70" href="#l70">70</a><td> * functions are provided for API compatibility with Dojo Deferred objects.<tr><td><a name="l71" href="#l71">71</a><td> *<tr><td><a name="l72" href="#l72">72</a><td> * @constructor<tr><td><a name="l73" href="#l73">73</a><td> * @see http://wiki.commonjs.org/wiki/Promises/A<tr><td><a name="l74" href="#l74">74</a><td> */<tr><td><a name="l75" href="#l75">75</a><td>webdriver.promise.Promise = function() {<tr><td><a name="l76" href="#l76">76</a><td>};<tr><td><a name="l77" href="#l77">77</a><td><tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td>/**<tr><td><a name="l80" href="#l80">80</a><td> * Cancels the computation of this promise&#39;s value, rejecting the promise in the<tr><td><a name="l81" href="#l81">81</a><td> * process.<tr><td><a name="l82" href="#l82">82</a><td> * @param {*} reason The reason this promise is being cancelled. If not an<tr><td><a name="l83" href="#l83">83</a><td> *     {@code Error}, one will be created using the value&#39;s string<tr><td><a name="l84" href="#l84">84</a><td> *     representation.<tr><td><a name="l85" href="#l85">85</a><td> */<tr><td><a name="l86" href="#l86">86</a><td>webdriver.promise.Promise.prototype.cancel = function(reason) {<tr><td><a name="l87" href="#l87">87</a><td>  throw new TypeError(&#39;Unimplemented function: &quot;cancel&quot;&#39;);<tr><td><a name="l88" href="#l88">88</a><td>};<tr><td><a name="l89" href="#l89">89</a><td><tr><td><a name="l90" href="#l90">90</a><td><tr><td><a name="l91" href="#l91">91</a><td>/** @return {boolean} Whether this promise&#39;s value is still being computed. */<tr><td><a name="l92" href="#l92">92</a><td>webdriver.promise.Promise.prototype.isPending = function() {<tr><td><a name="l93" href="#l93">93</a><td>  throw new TypeError(&#39;Unimplemented function: &quot;isPending&quot;&#39;);<tr><td><a name="l94" href="#l94">94</a><td>};<tr><td><a name="l95" href="#l95">95</a><td><tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>/**<tr><td><a name="l98" href="#l98">98</a><td> * Registers listeners for when this instance is resolved. This function most<tr><td><a name="l99" href="#l99">99</a><td> * overridden by subtypes.<tr><td><a name="l100" href="#l100">100</a><td> *<tr><td><a name="l101" href="#l101">101</a><td> * @param {Function=} opt_callback The function to call if this promise is<tr><td><a name="l102" href="#l102">102</a><td> *     successfully resolved. The function should expect a single argument: the<tr><td><a name="l103" href="#l103">103</a><td> *     promise&#39;s resolved value.<tr><td><a name="l104" href="#l104">104</a><td> * @param {Function=} opt_errback The function to call if this promise is<tr><td><a name="l105" href="#l105">105</a><td> *     rejected. The function should expect a single argument: the rejection<tr><td><a name="l106" href="#l106">106</a><td> *     reason.<tr><td><a name="l107" href="#l107">107</a><td> * @return {!webdriver.promise.Promise} A new promise which will be resolved<tr><td><a name="l108" href="#l108">108</a><td> *     with the result of the invoked callback.<tr><td><a name="l109" href="#l109">109</a><td> */<tr><td><a name="l110" href="#l110">110</a><td>webdriver.promise.Promise.prototype.then = function(<tr><td><a name="l111" href="#l111">111</a><td>    opt_callback, opt_errback) {<tr><td><a name="l112" href="#l112">112</a><td>  throw new TypeError(&#39;Unimplemented function: &quot;then&quot;&#39;);<tr><td><a name="l113" href="#l113">113</a><td>};<tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td>/**<tr><td><a name="l117" href="#l117">117</a><td> * Registers a listener for when this promise is rejected. This is synonymous<tr><td><a name="l118" href="#l118">118</a><td> * with the {@code catch} clause in a synchronous API:<tr><td><a name="l119" href="#l119">119</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l120" href="#l120">120</a><td> *   // Synchronous API:<tr><td><a name="l121" href="#l121">121</a><td> *   try {<tr><td><a name="l122" href="#l122">122</a><td> *     doSynchronousWork();<tr><td><a name="l123" href="#l123">123</a><td> *   } catch (ex) {<tr><td><a name="l124" href="#l124">124</a><td> *     console.error(ex);<tr><td><a name="l125" href="#l125">125</a><td> *   }<tr><td><a name="l126" href="#l126">126</a><td> *<tr><td><a name="l127" href="#l127">127</a><td> *   // Asynchronous promise API:<tr><td><a name="l128" href="#l128">128</a><td> *   doAsynchronousWork().thenCatch(function(ex) {<tr><td><a name="l129" href="#l129">129</a><td> *     console.error(ex);<tr><td><a name="l130" href="#l130">130</a><td> *   });<tr><td><a name="l131" href="#l131">131</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l132" href="#l132">132</a><td> *<tr><td><a name="l133" href="#l133">133</a><td> * @param {!Function} errback The function to call if this promise is<tr><td><a name="l134" href="#l134">134</a><td> *     rejected. The function should expect a single argument: the rejection<tr><td><a name="l135" href="#l135">135</a><td> *     reason.<tr><td><a name="l136" href="#l136">136</a><td> * @return {!webdriver.promise.Promise} A new promise which will be resolved<tr><td><a name="l137" href="#l137">137</a><td> *     with the result of the invoked callback.<tr><td><a name="l138" href="#l138">138</a><td> */<tr><td><a name="l139" href="#l139">139</a><td>webdriver.promise.Promise.prototype.thenCatch = function(errback) {<tr><td><a name="l140" href="#l140">140</a><td>  return this.then(null, errback);<tr><td><a name="l141" href="#l141">141</a><td>};<tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td>/**<tr><td><a name="l145" href="#l145">145</a><td> * Registers a listener to invoke when this promise is resolved, regardless<tr><td><a name="l146" href="#l146">146</a><td> * of whether the promise&#39;s value was successfully computed. This function<tr><td><a name="l147" href="#l147">147</a><td> * is synonymous with the {@code finally} clause in a synchronous API:<tr><td><a name="l148" href="#l148">148</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l149" href="#l149">149</a><td> *   // Synchronous API:<tr><td><a name="l150" href="#l150">150</a><td> *   try {<tr><td><a name="l151" href="#l151">151</a><td> *     doSynchronousWork();<tr><td><a name="l152" href="#l152">152</a><td> *   } finally {<tr><td><a name="l153" href="#l153">153</a><td> *     cleanUp();<tr><td><a name="l154" href="#l154">154</a><td> *   }<tr><td><a name="l155" href="#l155">155</a><td> *<tr><td><a name="l156" href="#l156">156</a><td> *   // Asynchronous promise API:<tr><td><a name="l157" href="#l157">157</a><td> *   doAsynchronousWork().thenFinally(cleanUp);<tr><td><a name="l158" href="#l158">158</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l159" href="#l159">159</a><td> *<tr><td><a name="l160" href="#l160">160</a><td> * &lt;b&gt;Note:&lt;/b&gt; similar to the {@code finally} clause, if the registered<tr><td><a name="l161" href="#l161">161</a><td> * callback returns a rejected promise or throws an error, it will silently<tr><td><a name="l162" href="#l162">162</a><td> * replace the rejection error (if any) from this promise:<tr><td><a name="l163" href="#l163">163</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l164" href="#l164">164</a><td> *   try {<tr><td><a name="l165" href="#l165">165</a><td> *     throw Error(&#39;one&#39;);<tr><td><a name="l166" href="#l166">166</a><td> *   } finally {<tr><td><a name="l167" href="#l167">167</a><td> *     throw Error(&#39;two&#39;);  // Hides Error: one<tr><td><a name="l168" href="#l168">168</a><td> *   }<tr><td><a name="l169" href="#l169">169</a><td> *<tr><td><a name="l170" href="#l170">170</a><td> *   webdriver.promise.rejected(Error(&#39;one&#39;))<tr><td><a name="l171" href="#l171">171</a><td> *       .thenFinally(function() {<tr><td><a name="l172" href="#l172">172</a><td> *         throw Error(&#39;two&#39;);  // Hides Error: one<tr><td><a name="l173" href="#l173">173</a><td> *       });<tr><td><a name="l174" href="#l174">174</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l175" href="#l175">175</a><td> *<tr><td><a name="l176" href="#l176">176</a><td> *<tr><td><a name="l177" href="#l177">177</a><td> * @param callback<tr><td><a name="l178" href="#l178">178</a><td> * @returns {!webdriver.promise.Promise}<tr><td><a name="l179" href="#l179">179</a><td> */<tr><td><a name="l180" href="#l180">180</a><td>webdriver.promise.Promise.prototype.thenFinally = function(callback) {<tr><td><a name="l181" href="#l181">181</a><td>  return this.then(callback, callback);<tr><td><a name="l182" href="#l182">182</a><td>};<tr><td><a name="l183" href="#l183">183</a><td><tr><td><a name="l184" href="#l184">184</a><td><tr><td><a name="l185" href="#l185">185</a><td>/**<tr><td><a name="l186" href="#l186">186</a><td> * Registers a function to be invoked when this promise is successfully<tr><td><a name="l187" href="#l187">187</a><td> * resolved. This function is provided for backwards compatibility with the<tr><td><a name="l188" href="#l188">188</a><td> * Dojo Deferred API.<tr><td><a name="l189" href="#l189">189</a><td> *<tr><td><a name="l190" href="#l190">190</a><td> * @param {Function} callback The function to call if this promise is<tr><td><a name="l191" href="#l191">191</a><td> *     successfully resolved. The function should expect a single argument: the<tr><td><a name="l192" href="#l192">192</a><td> *     promise&#39;s resolved value.<tr><td><a name="l193" href="#l193">193</a><td> * @param {!Object=} opt_self The object which |this| should refer to when the<tr><td><a name="l194" href="#l194">194</a><td> *     function is invoked.<tr><td><a name="l195" href="#l195">195</a><td> * @return {!webdriver.promise.Promise} A new promise which will be resolved<tr><td><a name="l196" href="#l196">196</a><td> *     with the result of the invoked callback.<tr><td><a name="l197" href="#l197">197</a><td> * @deprecated Use {@link #then()} instead.<tr><td><a name="l198" href="#l198">198</a><td> */<tr><td><a name="l199" href="#l199">199</a><td>webdriver.promise.Promise.prototype.addCallback = function(callback, opt_self) {<tr><td><a name="l200" href="#l200">200</a><td>  return this.then(goog.bind(callback, opt_self));<tr><td><a name="l201" href="#l201">201</a><td>};<tr><td><a name="l202" href="#l202">202</a><td><tr><td><a name="l203" href="#l203">203</a><td><tr><td><a name="l204" href="#l204">204</a><td>/**<tr><td><a name="l205" href="#l205">205</a><td> * Registers a function to be invoked when this promise is rejected.<tr><td><a name="l206" href="#l206">206</a><td> * This function is provided for backwards compatibility with the<tr><td><a name="l207" href="#l207">207</a><td> * Dojo Deferred API.<tr><td><a name="l208" href="#l208">208</a><td> *<tr><td><a name="l209" href="#l209">209</a><td> * @param {Function} errback The function to call if this promise is<tr><td><a name="l210" href="#l210">210</a><td> *     rejected. The function should expect a single argument: the rejection<tr><td><a name="l211" href="#l211">211</a><td> *     reason.<tr><td><a name="l212" href="#l212">212</a><td> * @param {!Object=} opt_self The object which |this| should refer to when the<tr><td><a name="l213" href="#l213">213</a><td> *     function is invoked.<tr><td><a name="l214" href="#l214">214</a><td> * @return {!webdriver.promise.Promise} A new promise which will be resolved<tr><td><a name="l215" href="#l215">215</a><td> *     with the result of the invoked callback.<tr><td><a name="l216" href="#l216">216</a><td> * @deprecated Use {@link #thenCatch()} instead.<tr><td><a name="l217" href="#l217">217</a><td> */<tr><td><a name="l218" href="#l218">218</a><td>webdriver.promise.Promise.prototype.addErrback = function(errback, opt_self) {<tr><td><a name="l219" href="#l219">219</a><td>  return this.thenCatch(goog.bind(errback, opt_self));<tr><td><a name="l220" href="#l220">220</a><td>};<tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td><tr><td><a name="l223" href="#l223">223</a><td>/**<tr><td><a name="l224" href="#l224">224</a><td> * Registers a function to be invoked when this promise is either rejected or<tr><td><a name="l225" href="#l225">225</a><td> * resolved. This function is provided for backwards compatibility with the<tr><td><a name="l226" href="#l226">226</a><td> * Dojo Deferred API.<tr><td><a name="l227" href="#l227">227</a><td> *<tr><td><a name="l228" href="#l228">228</a><td> * @param {Function} callback The function to call when this promise is<tr><td><a name="l229" href="#l229">229</a><td> *     either resolved or rejected. The function should expect a single<tr><td><a name="l230" href="#l230">230</a><td> *     argument: the resolved value or rejection error.<tr><td><a name="l231" href="#l231">231</a><td> * @param {!Object=} opt_self The object which |this| should refer to when the<tr><td><a name="l232" href="#l232">232</a><td> *     function is invoked.<tr><td><a name="l233" href="#l233">233</a><td> * @return {!webdriver.promise.Promise} A new promise which will be resolved<tr><td><a name="l234" href="#l234">234</a><td> *     with the result of the invoked callback.<tr><td><a name="l235" href="#l235">235</a><td> * @deprecated Use {@link #thenFinally()} instead.<tr><td><a name="l236" href="#l236">236</a><td> */<tr><td><a name="l237" href="#l237">237</a><td>webdriver.promise.Promise.prototype.addBoth = function(callback, opt_self) {<tr><td><a name="l238" href="#l238">238</a><td>  return this.thenFinally(goog.bind(callback, opt_self));<tr><td><a name="l239" href="#l239">239</a><td>};<tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td><tr><td><a name="l242" href="#l242">242</a><td>/**<tr><td><a name="l243" href="#l243">243</a><td> * An alias for {@code webdriver.promise.Promise.prototype.then} that permits<tr><td><a name="l244" href="#l244">244</a><td> * the scope of the invoked function to be specified. This function is provided<tr><td><a name="l245" href="#l245">245</a><td> * for backwards compatibility with the Dojo Deferred API.<tr><td><a name="l246" href="#l246">246</a><td> *<tr><td><a name="l247" href="#l247">247</a><td> * @param {Function} callback The function to call if this promise is<tr><td><a name="l248" href="#l248">248</a><td> *     successfully resolved. The function should expect a single argument: the<tr><td><a name="l249" href="#l249">249</a><td> *     promise&#39;s resolved value.<tr><td><a name="l250" href="#l250">250</a><td> * @param {Function} errback The function to call if this promise is<tr><td><a name="l251" href="#l251">251</a><td> *     rejected. The function should expect a single argument: the rejection<tr><td><a name="l252" href="#l252">252</a><td> *     reason.<tr><td><a name="l253" href="#l253">253</a><td> * @param {!Object=} opt_self The object which |this| should refer to when the<tr><td><a name="l254" href="#l254">254</a><td> *     function is invoked.<tr><td><a name="l255" href="#l255">255</a><td> * @return {!webdriver.promise.Promise} A new promise which will be resolved<tr><td><a name="l256" href="#l256">256</a><td> *     with the result of the invoked callback.<tr><td><a name="l257" href="#l257">257</a><td> * @deprecated Use {@link #then()} instead.<tr><td><a name="l258" href="#l258">258</a><td> */<tr><td><a name="l259" href="#l259">259</a><td>webdriver.promise.Promise.prototype.addCallbacks = function(<tr><td><a name="l260" href="#l260">260</a><td>    callback, errback, opt_self) {<tr><td><a name="l261" href="#l261">261</a><td>  return this.then(goog.bind(callback, opt_self),<tr><td><a name="l262" href="#l262">262</a><td>      goog.bind(errback, opt_self));<tr><td><a name="l263" href="#l263">263</a><td>};<tr><td><a name="l264" href="#l264">264</a><td><tr><td><a name="l265" href="#l265">265</a><td><tr><td><a name="l266" href="#l266">266</a><td><tr><td><a name="l267" href="#l267">267</a><td>/**<tr><td><a name="l268" href="#l268">268</a><td> * Represents a value that will be resolved at some point in the future. This<tr><td><a name="l269" href="#l269">269</a><td> * class represents the protected &quot;producer&quot; half of a Promise - each Deferred<tr><td><a name="l270" href="#l270">270</a><td> * has a {@code promise} property that may be returned to consumers for<tr><td><a name="l271" href="#l271">271</a><td> * registering callbacks, reserving the ability to resolve the deferred to the<tr><td><a name="l272" href="#l272">272</a><td> * producer.<tr><td><a name="l273" href="#l273">273</a><td> *<tr><td><a name="l274" href="#l274">274</a><td> * &lt;p&gt;If this Deferred is rejected and there are no listeners registered before<tr><td><a name="l275" href="#l275">275</a><td> * the next turn of the event loop, the rejection will be passed to the<tr><td><a name="l276" href="#l276">276</a><td> * {@link webdriver.promise.ControlFlow} as an unhandled failure.<tr><td><a name="l277" href="#l277">277</a><td> *<tr><td><a name="l278" href="#l278">278</a><td> * &lt;p&gt;If this Deferred is cancelled, the cancellation reason will be forward to<tr><td><a name="l279" href="#l279">279</a><td> * the Deferred&#39;s canceller function (if provided). The canceller may return a<tr><td><a name="l280" href="#l280">280</a><td> * truth-y value to override the reason provided for rejection.<tr><td><a name="l281" href="#l281">281</a><td> *<tr><td><a name="l282" href="#l282">282</a><td> * @param {Function=} opt_canceller Function to call when cancelling the<tr><td><a name="l283" href="#l283">283</a><td> *     computation of this instance&#39;s value.<tr><td><a name="l284" href="#l284">284</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow<tr><td><a name="l285" href="#l285">285</a><td> *     this instance was created under. This should only be provided during<tr><td><a name="l286" href="#l286">286</a><td> *     unit tests.<tr><td><a name="l287" href="#l287">287</a><td> * @constructor<tr><td><a name="l288" href="#l288">288</a><td> * @extends {webdriver.promise.Promise}<tr><td><a name="l289" href="#l289">289</a><td> */<tr><td><a name="l290" href="#l290">290</a><td>webdriver.promise.Deferred = function(opt_canceller, opt_flow) {<tr><td><a name="l291" href="#l291">291</a><td>  /* NOTE: This class&#39;s implementation diverges from the prototypical style<tr><td><a name="l292" href="#l292">292</a><td>   * used in the rest of the atoms library. This was done intentionally to<tr><td><a name="l293" href="#l293">293</a><td>   * protect the internal Deferred state from consumers, as outlined by<tr><td><a name="l294" href="#l294">294</a><td>   *     http://wiki.commonjs.org/wiki/Promises<tr><td><a name="l295" href="#l295">295</a><td>   */<tr><td><a name="l296" href="#l296">296</a><td>  goog.base(this);<tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td>  var flow = opt_flow || webdriver.promise.controlFlow();<tr><td><a name="l299" href="#l299">299</a><td><tr><td><a name="l300" href="#l300">300</a><td>  /**<tr><td><a name="l301" href="#l301">301</a><td>   * The listeners registered with this Deferred. Each element in the list will<tr><td><a name="l302" href="#l302">302</a><td>   * be a 3-tuple of the callback function, errback function, and the<tr><td><a name="l303" href="#l303">303</a><td>   * corresponding deferred object.<tr><td><a name="l304" href="#l304">304</a><td>   * @type {!Array.&lt;!webdriver.promise.Deferred.Listener_&gt;}<tr><td><a name="l305" href="#l305">305</a><td>   */<tr><td><a name="l306" href="#l306">306</a><td>  var listeners = [];<tr><td><a name="l307" href="#l307">307</a><td><tr><td><a name="l308" href="#l308">308</a><td>  /**<tr><td><a name="l309" href="#l309">309</a><td>   * Whether this Deferred&#39;s resolution was ever handled by a listener.<tr><td><a name="l310" href="#l310">310</a><td>   * If the Deferred is rejected and its value is not handled by a listener<tr><td><a name="l311" href="#l311">311</a><td>   * before the next turn of the event loop, the error will be passed to the<tr><td><a name="l312" href="#l312">312</a><td>   * global error handler.<tr><td><a name="l313" href="#l313">313</a><td>   * @type {boolean}<tr><td><a name="l314" href="#l314">314</a><td>   */<tr><td><a name="l315" href="#l315">315</a><td>  var handled = false;<tr><td><a name="l316" href="#l316">316</a><td><tr><td><a name="l317" href="#l317">317</a><td>  /**<tr><td><a name="l318" href="#l318">318</a><td>   * Key for the timeout used to delay reproting an unhandled rejection to the<tr><td><a name="l319" href="#l319">319</a><td>   * parent {@link webdriver.promise.ControlFlow}.<tr><td><a name="l320" href="#l320">320</a><td>   * @type {?number}<tr><td><a name="l321" href="#l321">321</a><td>   */<tr><td><a name="l322" href="#l322">322</a><td>  var pendingRejectionKey = null;<tr><td><a name="l323" href="#l323">323</a><td><tr><td><a name="l324" href="#l324">324</a><td>  /**<tr><td><a name="l325" href="#l325">325</a><td>   * This Deferred&#39;s current state.<tr><td><a name="l326" href="#l326">326</a><td>   * @type {!webdriver.promise.Deferred.State_}<tr><td><a name="l327" href="#l327">327</a><td>   */<tr><td><a name="l328" href="#l328">328</a><td>  var state = webdriver.promise.Deferred.State_.PENDING;<tr><td><a name="l329" href="#l329">329</a><td><tr><td><a name="l330" href="#l330">330</a><td>  /**<tr><td><a name="l331" href="#l331">331</a><td>   * This Deferred&#39;s resolved value; set when the state transitions from<tr><td><a name="l332" href="#l332">332</a><td>   * {@code webdriver.promise.Deferred.State_.PENDING}.<tr><td><a name="l333" href="#l333">333</a><td>   * @type {*}<tr><td><a name="l334" href="#l334">334</a><td>   */<tr><td><a name="l335" href="#l335">335</a><td>  var value;<tr><td><a name="l336" href="#l336">336</a><td><tr><td><a name="l337" href="#l337">337</a><td>  /** @return {boolean} Whether this promise&#39;s value is still pending. */<tr><td><a name="l338" href="#l338">338</a><td>  function isPending() {<tr><td><a name="l339" href="#l339">339</a><td>    return state == webdriver.promise.Deferred.State_.PENDING;<tr><td><a name="l340" href="#l340">340</a><td>  }<tr><td><a name="l341" href="#l341">341</a><td><tr><td><a name="l342" href="#l342">342</a><td>  /**<tr><td><a name="l343" href="#l343">343</a><td>   * Removes all of the listeners previously registered on this deferred.<tr><td><a name="l344" href="#l344">344</a><td>   * @throws {Error} If this deferred has already been resolved.<tr><td><a name="l345" href="#l345">345</a><td>   */<tr><td><a name="l346" href="#l346">346</a><td>  function removeAll() {<tr><td><a name="l347" href="#l347">347</a><td>    listeners = [];<tr><td><a name="l348" href="#l348">348</a><td>  }<tr><td><a name="l349" href="#l349">349</a><td><tr><td><a name="l350" href="#l350">350</a><td>  /**<tr><td><a name="l351" href="#l351">351</a><td>   * Resolves this deferred. If the new value is a promise, this function will<tr><td><a name="l352" href="#l352">352</a><td>   * wait for it to be resolved before notifying the registered listeners.<tr><td><a name="l353" href="#l353">353</a><td>   * @param {!webdriver.promise.Deferred.State_} newState The deferred&#39;s new<tr><td><a name="l354" href="#l354">354</a><td>   *     state.<tr><td><a name="l355" href="#l355">355</a><td>   * @param {*} newValue The deferred&#39;s new value.<tr><td><a name="l356" href="#l356">356</a><td>   */<tr><td><a name="l357" href="#l357">357</a><td>  function resolve(newState, newValue) {<tr><td><a name="l358" href="#l358">358</a><td>    if (webdriver.promise.Deferred.State_.PENDING !== state) {<tr><td><a name="l359" href="#l359">359</a><td>      return;<tr><td><a name="l360" href="#l360">360</a><td>    }<tr><td><a name="l361" href="#l361">361</a><td><tr><td><a name="l362" href="#l362">362</a><td>    state = webdriver.promise.Deferred.State_.BLOCKED;<tr><td><a name="l363" href="#l363">363</a><td><tr><td><a name="l364" href="#l364">364</a><td>    if (webdriver.promise.isPromise(newValue) &amp;&amp; newValue !== self) {<tr><td><a name="l365" href="#l365">365</a><td>      var onFulfill = goog.partial(notifyAll, newState);<tr><td><a name="l366" href="#l366">366</a><td>      var onReject = goog.partial(<tr><td><a name="l367" href="#l367">367</a><td>          notifyAll, webdriver.promise.Deferred.State_.REJECTED);<tr><td><a name="l368" href="#l368">368</a><td>      if (newValue instanceof webdriver.promise.Deferred) {<tr><td><a name="l369" href="#l369">369</a><td>        newValue.then(onFulfill, onReject);<tr><td><a name="l370" href="#l370">370</a><td>      } else {<tr><td><a name="l371" href="#l371">371</a><td>        webdriver.promise.asap(newValue, onFulfill, onReject);<tr><td><a name="l372" href="#l372">372</a><td>      }<tr><td><a name="l373" href="#l373">373</a><td><tr><td><a name="l374" href="#l374">374</a><td>    } else {<tr><td><a name="l375" href="#l375">375</a><td>      notifyAll(newState, newValue);<tr><td><a name="l376" href="#l376">376</a><td>    }<tr><td><a name="l377" href="#l377">377</a><td>  }<tr><td><a name="l378" href="#l378">378</a><td><tr><td><a name="l379" href="#l379">379</a><td>  /**<tr><td><a name="l380" href="#l380">380</a><td>   * Notifies all of the listeners registered with this Deferred that its state<tr><td><a name="l381" href="#l381">381</a><td>   * has changed.<tr><td><a name="l382" href="#l382">382</a><td>   * @param {!webdriver.promise.Deferred.State_} newState The deferred&#39;s new<tr><td><a name="l383" href="#l383">383</a><td>   *     state.<tr><td><a name="l384" href="#l384">384</a><td>   * @param {*} newValue The deferred&#39;s new value.<tr><td><a name="l385" href="#l385">385</a><td>   */<tr><td><a name="l386" href="#l386">386</a><td>  function notifyAll(newState, newValue) {<tr><td><a name="l387" href="#l387">387</a><td>    if (newState === webdriver.promise.Deferred.State_.REJECTED &amp;&amp;<tr><td><a name="l388" href="#l388">388</a><td>        // We cannot check instanceof Error since the object may have been<tr><td><a name="l389" href="#l389">389</a><td>        // created in a different JS context.<tr><td><a name="l390" href="#l390">390</a><td>        goog.isObject(newValue) &amp;&amp; goog.isString(newValue.message)) {<tr><td><a name="l391" href="#l391">391</a><td>      newValue = flow.annotateError(/** @type {!Error} */(newValue));<tr><td><a name="l392" href="#l392">392</a><td>    }<tr><td><a name="l393" href="#l393">393</a><td><tr><td><a name="l394" href="#l394">394</a><td>    state = newState;<tr><td><a name="l395" href="#l395">395</a><td>    value = newValue;<tr><td><a name="l396" href="#l396">396</a><td>    while (listeners.length) {<tr><td><a name="l397" href="#l397">397</a><td>      notify(listeners.shift());<tr><td><a name="l398" href="#l398">398</a><td>    }<tr><td><a name="l399" href="#l399">399</a><td><tr><td><a name="l400" href="#l400">400</a><td>    if (!handled &amp;&amp; state == webdriver.promise.Deferred.State_.REJECTED) {<tr><td><a name="l401" href="#l401">401</a><td>      pendingRejectionKey = propagateError(value);<tr><td><a name="l402" href="#l402">402</a><td>    }<tr><td><a name="l403" href="#l403">403</a><td>  }<tr><td><a name="l404" href="#l404">404</a><td><tr><td><a name="l405" href="#l405">405</a><td>  /**<tr><td><a name="l406" href="#l406">406</a><td>   * Propagates an unhandled rejection to the parent ControlFlow in a<tr><td><a name="l407" href="#l407">407</a><td>   * future turn of the JavaScript event loop.<tr><td><a name="l408" href="#l408">408</a><td>   * @param {*} error The error value to report.<tr><td><a name="l409" href="#l409">409</a><td>   * @return {number} The key for the registered timeout.<tr><td><a name="l410" href="#l410">410</a><td>   */<tr><td><a name="l411" href="#l411">411</a><td>  function propagateError(error) {<tr><td><a name="l412" href="#l412">412</a><td>    flow.pendingRejections_ += 1;<tr><td><a name="l413" href="#l413">413</a><td>    return flow.timer.setTimeout(function() {<tr><td><a name="l414" href="#l414">414</a><td>      flow.pendingRejections_ -= 1;<tr><td><a name="l415" href="#l415">415</a><td>      flow.abortFrame_(error);<tr><td><a name="l416" href="#l416">416</a><td>    }, 0);<tr><td><a name="l417" href="#l417">417</a><td>  }<tr><td><a name="l418" href="#l418">418</a><td><tr><td><a name="l419" href="#l419">419</a><td>  /**<tr><td><a name="l420" href="#l420">420</a><td>   * Notifies a single listener of this Deferred&#39;s change in state.<tr><td><a name="l421" href="#l421">421</a><td>   * @param {!webdriver.promise.Deferred.Listener_} listener The listener to<tr><td><a name="l422" href="#l422">422</a><td>   *     notify.<tr><td><a name="l423" href="#l423">423</a><td>   */<tr><td><a name="l424" href="#l424">424</a><td>  function notify(listener) {<tr><td><a name="l425" href="#l425">425</a><td>    var func = state == webdriver.promise.Deferred.State_.RESOLVED ?<tr><td><a name="l426" href="#l426">426</a><td>        listener.callback : listener.errback;<tr><td><a name="l427" href="#l427">427</a><td>    if (func) {<tr><td><a name="l428" href="#l428">428</a><td>      flow.runInNewFrame_(goog.partial(func, value),<tr><td><a name="l429" href="#l429">429</a><td>          listener.fulfill, listener.reject);<tr><td><a name="l430" href="#l430">430</a><td>    } else if (state == webdriver.promise.Deferred.State_.REJECTED) {<tr><td><a name="l431" href="#l431">431</a><td>      listener.reject(value);<tr><td><a name="l432" href="#l432">432</a><td>    } else {<tr><td><a name="l433" href="#l433">433</a><td>      listener.fulfill(value);<tr><td><a name="l434" href="#l434">434</a><td>    }<tr><td><a name="l435" href="#l435">435</a><td>  }<tr><td><a name="l436" href="#l436">436</a><td><tr><td><a name="l437" href="#l437">437</a><td>  /**<tr><td><a name="l438" href="#l438">438</a><td>   * The consumer promise for this instance. Provides protected access to the<tr><td><a name="l439" href="#l439">439</a><td>   * callback registering functions.<tr><td><a name="l440" href="#l440">440</a><td>   * @type {!webdriver.promise.Promise}<tr><td><a name="l441" href="#l441">441</a><td>   */<tr><td><a name="l442" href="#l442">442</a><td>  var promise = new webdriver.promise.Promise();<tr><td><a name="l443" href="#l443">443</a><td><tr><td><a name="l444" href="#l444">444</a><td>  /**<tr><td><a name="l445" href="#l445">445</a><td>   * Registers a callback on this Deferred.<tr><td><a name="l446" href="#l446">446</a><td>   * @param {Function=} opt_callback The callback.<tr><td><a name="l447" href="#l447">447</a><td>   * @param {Function=} opt_errback The errback.<tr><td><a name="l448" href="#l448">448</a><td>   * @return {!webdriver.promise.Promise} A new promise representing the result<tr><td><a name="l449" href="#l449">449</a><td>   *     of the callback.<tr><td><a name="l450" href="#l450">450</a><td>   * @see webdriver.promise.Promise#then<tr><td><a name="l451" href="#l451">451</a><td>   */<tr><td><a name="l452" href="#l452">452</a><td>  function then(opt_callback, opt_errback) {<tr><td><a name="l453" href="#l453">453</a><td>    // Avoid unnecessary allocations if we weren&#39;t given any callback functions.<tr><td><a name="l454" href="#l454">454</a><td>    if (!opt_callback &amp;&amp; !opt_errback) {<tr><td><a name="l455" href="#l455">455</a><td>      return promise;<tr><td><a name="l456" href="#l456">456</a><td>    }<tr><td><a name="l457" href="#l457">457</a><td><tr><td><a name="l458" href="#l458">458</a><td>    // The moment a listener is registered, we consider this deferred to be<tr><td><a name="l459" href="#l459">459</a><td>    // handled; the callback must handle any rejection errors.<tr><td><a name="l460" href="#l460">460</a><td>    handled = true;<tr><td><a name="l461" href="#l461">461</a><td>    if (pendingRejectionKey) {<tr><td><a name="l462" href="#l462">462</a><td>      flow.pendingRejections_ -= 1;<tr><td><a name="l463" href="#l463">463</a><td>      flow.timer.clearTimeout(pendingRejectionKey);<tr><td><a name="l464" href="#l464">464</a><td>    }<tr><td><a name="l465" href="#l465">465</a><td><tr><td><a name="l466" href="#l466">466</a><td>    var deferred = new webdriver.promise.Deferred(cancel, flow);<tr><td><a name="l467" href="#l467">467</a><td>    var listener = {<tr><td><a name="l468" href="#l468">468</a><td>      callback: opt_callback,<tr><td><a name="l469" href="#l469">469</a><td>      errback: opt_errback,<tr><td><a name="l470" href="#l470">470</a><td>      fulfill: deferred.fulfill,<tr><td><a name="l471" href="#l471">471</a><td>      reject: deferred.reject<tr><td><a name="l472" href="#l472">472</a><td>    };<tr><td><a name="l473" href="#l473">473</a><td><tr><td><a name="l474" href="#l474">474</a><td>    if (state == webdriver.promise.Deferred.State_.PENDING ||<tr><td><a name="l475" href="#l475">475</a><td>        state == webdriver.promise.Deferred.State_.BLOCKED) {<tr><td><a name="l476" href="#l476">476</a><td>      listeners.push(listener);<tr><td><a name="l477" href="#l477">477</a><td>    } else {<tr><td><a name="l478" href="#l478">478</a><td>      notify(listener);<tr><td><a name="l479" href="#l479">479</a><td>    }<tr><td><a name="l480" href="#l480">480</a><td><tr><td><a name="l481" href="#l481">481</a><td>    return deferred.promise;<tr><td><a name="l482" href="#l482">482</a><td>  }<tr><td><a name="l483" href="#l483">483</a><td><tr><td><a name="l484" href="#l484">484</a><td>  var self = this;<tr><td><a name="l485" href="#l485">485</a><td><tr><td><a name="l486" href="#l486">486</a><td>  /**<tr><td><a name="l487" href="#l487">487</a><td>   * Resolves this promise with the given value. If the value is itself a<tr><td><a name="l488" href="#l488">488</a><td>   * promise and not a reference to this deferred, this instance will wait for<tr><td><a name="l489" href="#l489">489</a><td>   * it before resolving.<tr><td><a name="l490" href="#l490">490</a><td>   * @param {*=} opt_value The resolved value.<tr><td><a name="l491" href="#l491">491</a><td>   */<tr><td><a name="l492" href="#l492">492</a><td>  function fulfill(opt_value) {<tr><td><a name="l493" href="#l493">493</a><td>    resolve(webdriver.promise.Deferred.State_.RESOLVED, opt_value);<tr><td><a name="l494" href="#l494">494</a><td>  }<tr><td><a name="l495" href="#l495">495</a><td><tr><td><a name="l496" href="#l496">496</a><td>  /**<tr><td><a name="l497" href="#l497">497</a><td>   * Rejects this promise. If the error is itself a promise, this instance will<tr><td><a name="l498" href="#l498">498</a><td>   * be chained to it and be rejected with the error&#39;s resolved value.<tr><td><a name="l499" href="#l499">499</a><td>   * @param {*=} opt_error The rejection reason, typically either a<tr><td><a name="l500" href="#l500">500</a><td>   *     {@code Error} or a {@code string}.<tr><td><a name="l501" href="#l501">501</a><td>   */<tr><td><a name="l502" href="#l502">502</a><td>  function reject(opt_error) {<tr><td><a name="l503" href="#l503">503</a><td>    resolve(webdriver.promise.Deferred.State_.REJECTED, opt_error);<tr><td><a name="l504" href="#l504">504</a><td>  }<tr><td><a name="l505" href="#l505">505</a><td><tr><td><a name="l506" href="#l506">506</a><td>  /**<tr><td><a name="l507" href="#l507">507</a><td>   * Attempts to cancel the computation of this instance&#39;s value. This attempt<tr><td><a name="l508" href="#l508">508</a><td>   * will silently fail if this instance has already resolved.<tr><td><a name="l509" href="#l509">509</a><td>   * @param {*=} opt_reason The reason for cancelling this promise.<tr><td><a name="l510" href="#l510">510</a><td>   */<tr><td><a name="l511" href="#l511">511</a><td>  function cancel(opt_reason) {<tr><td><a name="l512" href="#l512">512</a><td>    if (!isPending()) {<tr><td><a name="l513" href="#l513">513</a><td>      return;<tr><td><a name="l514" href="#l514">514</a><td>    }<tr><td><a name="l515" href="#l515">515</a><td><tr><td><a name="l516" href="#l516">516</a><td>    if (opt_canceller) {<tr><td><a name="l517" href="#l517">517</a><td>      opt_reason = opt_canceller(opt_reason) || opt_reason;<tr><td><a name="l518" href="#l518">518</a><td>    }<tr><td><a name="l519" href="#l519">519</a><td><tr><td><a name="l520" href="#l520">520</a><td>    reject(opt_reason);<tr><td><a name="l521" href="#l521">521</a><td>  }<tr><td><a name="l522" href="#l522">522</a><td><tr><td><a name="l523" href="#l523">523</a><td>  this.promise = promise;<tr><td><a name="l524" href="#l524">524</a><td>  this.promise.then = this.then = then;<tr><td><a name="l525" href="#l525">525</a><td>  this.promise.cancel = this.cancel = cancel;<tr><td><a name="l526" href="#l526">526</a><td>  this.promise.isPending = this.isPending = isPending;<tr><td><a name="l527" href="#l527">527</a><td>  this.fulfill = fulfill;<tr><td><a name="l528" href="#l528">528</a><td>  this.reject = this.errback = reject;<tr><td><a name="l529" href="#l529">529</a><td><tr><td><a name="l530" href="#l530">530</a><td>  // Only expose this function to our internal classes.<tr><td><a name="l531" href="#l531">531</a><td>  // TODO: find a cleaner way of handling this.<tr><td><a name="l532" href="#l532">532</a><td>  if (this instanceof webdriver.promise.Task_) {<tr><td><a name="l533" href="#l533">533</a><td>    this.removeAll = removeAll;<tr><td><a name="l534" href="#l534">534</a><td>  }<tr><td><a name="l535" href="#l535">535</a><td><tr><td><a name="l536" href="#l536">536</a><td>  // Export symbols necessary for the contract on this object to work in<tr><td><a name="l537" href="#l537">537</a><td>  // compiled mode.<tr><td><a name="l538" href="#l538">538</a><td>  goog.exportProperty(this, &#39;then&#39;, this.then);<tr><td><a name="l539" href="#l539">539</a><td>  goog.exportProperty(this, &#39;cancel&#39;, cancel);<tr><td><a name="l540" href="#l540">540</a><td>  goog.exportProperty(this, &#39;fulfill&#39;, fulfill);<tr><td><a name="l541" href="#l541">541</a><td>  goog.exportProperty(this, &#39;reject&#39;, reject);<tr><td><a name="l542" href="#l542">542</a><td>  goog.exportProperty(this, &#39;isPending&#39;, isPending);<tr><td><a name="l543" href="#l543">543</a><td>  goog.exportProperty(this, &#39;promise&#39;, this.promise);<tr><td><a name="l544" href="#l544">544</a><td>  goog.exportProperty(this.promise, &#39;then&#39;, this.then);<tr><td><a name="l545" href="#l545">545</a><td>  goog.exportProperty(this.promise, &#39;cancel&#39;, cancel);<tr><td><a name="l546" href="#l546">546</a><td>  goog.exportProperty(this.promise, &#39;isPending&#39;, isPending);<tr><td><a name="l547" href="#l547">547</a><td>};<tr><td><a name="l548" href="#l548">548</a><td>goog.inherits(webdriver.promise.Deferred, webdriver.promise.Promise);<tr><td><a name="l549" href="#l549">549</a><td><tr><td><a name="l550" href="#l550">550</a><td><tr><td><a name="l551" href="#l551">551</a><td>/**<tr><td><a name="l552" href="#l552">552</a><td> * Type definition for a listener registered on a Deferred object.<tr><td><a name="l553" href="#l553">553</a><td> * @typedef {{callback:(Function|undefined),<tr><td><a name="l554" href="#l554">554</a><td> *            errback:(Function|undefined),<tr><td><a name="l555" href="#l555">555</a><td> *            fulfill: function(*), reject: function(*)}}<tr><td><a name="l556" href="#l556">556</a><td> * @private<tr><td><a name="l557" href="#l557">557</a><td> */<tr><td><a name="l558" href="#l558">558</a><td>webdriver.promise.Deferred.Listener_;<tr><td><a name="l559" href="#l559">559</a><td><tr><td><a name="l560" href="#l560">560</a><td><tr><td><a name="l561" href="#l561">561</a><td>/**<tr><td><a name="l562" href="#l562">562</a><td> * The three states a {@link webdriver.promise.Deferred} object may be in.<tr><td><a name="l563" href="#l563">563</a><td> * @enum {number}<tr><td><a name="l564" href="#l564">564</a><td> * @private<tr><td><a name="l565" href="#l565">565</a><td> */<tr><td><a name="l566" href="#l566">566</a><td>webdriver.promise.Deferred.State_ = {<tr><td><a name="l567" href="#l567">567</a><td>  REJECTED: -1,<tr><td><a name="l568" href="#l568">568</a><td>  PENDING: 0,<tr><td><a name="l569" href="#l569">569</a><td>  BLOCKED: 1,<tr><td><a name="l570" href="#l570">570</a><td>  RESOLVED: 2<tr><td><a name="l571" href="#l571">571</a><td>};<tr><td><a name="l572" href="#l572">572</a><td><tr><td><a name="l573" href="#l573">573</a><td><tr><td><a name="l574" href="#l574">574</a><td>/**<tr><td><a name="l575" href="#l575">575</a><td> * Tests if a value is an Error-like object. This is more than an straight<tr><td><a name="l576" href="#l576">576</a><td> * instanceof check since the value may originate from another context.<tr><td><a name="l577" href="#l577">577</a><td> * @param {*} value The value to test.<tr><td><a name="l578" href="#l578">578</a><td> * @return {boolean} Whether the value is an error.<tr><td><a name="l579" href="#l579">579</a><td> * @private<tr><td><a name="l580" href="#l580">580</a><td> */<tr><td><a name="l581" href="#l581">581</a><td>webdriver.promise.isError_ = function(value) {<tr><td><a name="l582" href="#l582">582</a><td>  return value instanceof Error ||<tr><td><a name="l583" href="#l583">583</a><td>      goog.isObject(value) &amp;&amp;<tr><td><a name="l584" href="#l584">584</a><td>      (Object.prototype.toString.call(value) === &#39;[object Error]&#39; ||<tr><td><a name="l585" href="#l585">585</a><td>       // A special test for goog.testing.JsUnitException.<tr><td><a name="l586" href="#l586">586</a><td>       value.isJsUnitException);<tr><td><a name="l587" href="#l587">587</a><td><tr><td><a name="l588" href="#l588">588</a><td>};<tr><td><a name="l589" href="#l589">589</a><td><tr><td><a name="l590" href="#l590">590</a><td><tr><td><a name="l591" href="#l591">591</a><td>/**<tr><td><a name="l592" href="#l592">592</a><td> * Determines whether a {@code value} should be treated as a promise.<tr><td><a name="l593" href="#l593">593</a><td> * Any object whose &quot;then&quot; property is a function will be considered a promise.<tr><td><a name="l594" href="#l594">594</a><td> *<tr><td><a name="l595" href="#l595">595</a><td> * @param {*} value The value to test.<tr><td><a name="l596" href="#l596">596</a><td> * @return {boolean} Whether the value is a promise.<tr><td><a name="l597" href="#l597">597</a><td> */<tr><td><a name="l598" href="#l598">598</a><td>webdriver.promise.isPromise = function(value) {<tr><td><a name="l599" href="#l599">599</a><td>  return !!value &amp;&amp; goog.isObject(value) &amp;&amp;<tr><td><a name="l600" href="#l600">600</a><td>      // Use array notation so the Closure compiler does not obfuscate away our<tr><td><a name="l601" href="#l601">601</a><td>      // contract.<tr><td><a name="l602" href="#l602">602</a><td>      goog.isFunction(value[&#39;then&#39;]);<tr><td><a name="l603" href="#l603">603</a><td>};<tr><td><a name="l604" href="#l604">604</a><td><tr><td><a name="l605" href="#l605">605</a><td><tr><td><a name="l606" href="#l606">606</a><td>/**<tr><td><a name="l607" href="#l607">607</a><td> * Creates a promise that will be resolved at a set time in the future.<tr><td><a name="l608" href="#l608">608</a><td> * @param {number} ms The amount of time, in milliseconds, to wait before<tr><td><a name="l609" href="#l609">609</a><td> *     resolving the promise.<tr><td><a name="l610" href="#l610">610</a><td> * @return {!webdriver.promise.Promise} The promise.<tr><td><a name="l611" href="#l611">611</a><td> */<tr><td><a name="l612" href="#l612">612</a><td>webdriver.promise.delayed = function(ms) {<tr><td><a name="l613" href="#l613">613</a><td>  var timer = webdriver.promise.controlFlow().timer;<tr><td><a name="l614" href="#l614">614</a><td>  var key;<tr><td><a name="l615" href="#l615">615</a><td>  var deferred = new webdriver.promise.Deferred(function() {<tr><td><a name="l616" href="#l616">616</a><td>    timer.clearTimeout(key);<tr><td><a name="l617" href="#l617">617</a><td>  });<tr><td><a name="l618" href="#l618">618</a><td>  key = timer.setTimeout(deferred.fulfill, ms);<tr><td><a name="l619" href="#l619">619</a><td>  return deferred.promise;<tr><td><a name="l620" href="#l620">620</a><td>};<tr><td><a name="l621" href="#l621">621</a><td><tr><td><a name="l622" href="#l622">622</a><td><tr><td><a name="l623" href="#l623">623</a><td>/**<tr><td><a name="l624" href="#l624">624</a><td> * Creates a new deferred object.<tr><td><a name="l625" href="#l625">625</a><td> * @param {Function=} opt_canceller Function to call when cancelling the<tr><td><a name="l626" href="#l626">626</a><td> *     computation of this instance&#39;s value.<tr><td><a name="l627" href="#l627">627</a><td> * @return {!webdriver.promise.Deferred} The new deferred object.<tr><td><a name="l628" href="#l628">628</a><td> */<tr><td><a name="l629" href="#l629">629</a><td>webdriver.promise.defer = function(opt_canceller) {<tr><td><a name="l630" href="#l630">630</a><td>  return new webdriver.promise.Deferred(opt_canceller);<tr><td><a name="l631" href="#l631">631</a><td>};<tr><td><a name="l632" href="#l632">632</a><td><tr><td><a name="l633" href="#l633">633</a><td><tr><td><a name="l634" href="#l634">634</a><td>/**<tr><td><a name="l635" href="#l635">635</a><td> * Creates a promise that has been resolved with the given value.<tr><td><a name="l636" href="#l636">636</a><td> * @param {*=} opt_value The resolved value.<tr><td><a name="l637" href="#l637">637</a><td> * @return {!webdriver.promise.Promise} The resolved promise.<tr><td><a name="l638" href="#l638">638</a><td> */<tr><td><a name="l639" href="#l639">639</a><td>webdriver.promise.fulfilled = function(opt_value) {<tr><td><a name="l640" href="#l640">640</a><td>  if (opt_value instanceof webdriver.promise.Promise) {<tr><td><a name="l641" href="#l641">641</a><td>    return opt_value;<tr><td><a name="l642" href="#l642">642</a><td>  }<tr><td><a name="l643" href="#l643">643</a><td>  var deferred = new webdriver.promise.Deferred();<tr><td><a name="l644" href="#l644">644</a><td>  deferred.fulfill(opt_value);<tr><td><a name="l645" href="#l645">645</a><td>  return deferred.promise;<tr><td><a name="l646" href="#l646">646</a><td>};<tr><td><a name="l647" href="#l647">647</a><td><tr><td><a name="l648" href="#l648">648</a><td><tr><td><a name="l649" href="#l649">649</a><td>/**<tr><td><a name="l650" href="#l650">650</a><td> * Creates a promise that has been rejected with the given reason.<tr><td><a name="l651" href="#l651">651</a><td> * @param {*=} opt_reason The rejection reason; may be any value, but is<tr><td><a name="l652" href="#l652">652</a><td> *     usually an Error or a string.<tr><td><a name="l653" href="#l653">653</a><td> * @return {!webdriver.promise.Promise} The rejected promise.<tr><td><a name="l654" href="#l654">654</a><td> */<tr><td><a name="l655" href="#l655">655</a><td>webdriver.promise.rejected = function(opt_reason) {<tr><td><a name="l656" href="#l656">656</a><td>  var deferred = new webdriver.promise.Deferred();<tr><td><a name="l657" href="#l657">657</a><td>  deferred.reject(opt_reason);<tr><td><a name="l658" href="#l658">658</a><td>  return deferred.promise;<tr><td><a name="l659" href="#l659">659</a><td>};<tr><td><a name="l660" href="#l660">660</a><td><tr><td><a name="l661" href="#l661">661</a><td><tr><td><a name="l662" href="#l662">662</a><td>/**<tr><td><a name="l663" href="#l663">663</a><td> * Wraps a function that is assumed to be a node-style callback as its final<tr><td><a name="l664" href="#l664">664</a><td> * argument. This callback takes two arguments: an error value (which will be<tr><td><a name="l665" href="#l665">665</a><td> * null if the call succeeded), and the success value as the second argument.<tr><td><a name="l666" href="#l666">666</a><td> * If the call fails, the returned promise will be rejected, otherwise it will<tr><td><a name="l667" href="#l667">667</a><td> * be resolved with the result.<tr><td><a name="l668" href="#l668">668</a><td> * @param {!Function} fn The function to wrap.<tr><td><a name="l669" href="#l669">669</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l670" href="#l670">670</a><td> *     result of the provided function&#39;s callback.<tr><td><a name="l671" href="#l671">671</a><td> */<tr><td><a name="l672" href="#l672">672</a><td>webdriver.promise.checkedNodeCall = function(fn) {<tr><td><a name="l673" href="#l673">673</a><td>  var deferred = new webdriver.promise.Deferred(function() {<tr><td><a name="l674" href="#l674">674</a><td>    throw Error(&#39;This Deferred may not be cancelled&#39;);<tr><td><a name="l675" href="#l675">675</a><td>  });<tr><td><a name="l676" href="#l676">676</a><td>  try {<tr><td><a name="l677" href="#l677">677</a><td>    fn(function(error, value) {<tr><td><a name="l678" href="#l678">678</a><td>      error ? deferred.reject(error) : deferred.fulfill(value);<tr><td><a name="l679" href="#l679">679</a><td>    });<tr><td><a name="l680" href="#l680">680</a><td>  } catch (ex) {<tr><td><a name="l681" href="#l681">681</a><td>    deferred.reject(ex);<tr><td><a name="l682" href="#l682">682</a><td>  }<tr><td><a name="l683" href="#l683">683</a><td>  return deferred.promise;<tr><td><a name="l684" href="#l684">684</a><td>};<tr><td><a name="l685" href="#l685">685</a><td><tr><td><a name="l686" href="#l686">686</a><td><tr><td><a name="l687" href="#l687">687</a><td>/**<tr><td><a name="l688" href="#l688">688</a><td> * Registers an observer on a promised {@code value}, returning a new promise<tr><td><a name="l689" href="#l689">689</a><td> * that will be resolved when the value is. If {@code value} is not a promise,<tr><td><a name="l690" href="#l690">690</a><td> * then the return promise will be immediately resolved.<tr><td><a name="l691" href="#l691">691</a><td> * @param {*} value The value to observe.<tr><td><a name="l692" href="#l692">692</a><td> * @param {Function=} opt_callback The function to call when the value is<tr><td><a name="l693" href="#l693">693</a><td> *     resolved successfully.<tr><td><a name="l694" href="#l694">694</a><td> * @param {Function=} opt_errback The function to call when the value is<tr><td><a name="l695" href="#l695">695</a><td> *     rejected.<tr><td><a name="l696" href="#l696">696</a><td> * @return {!webdriver.promise.Promise} A new promise.<tr><td><a name="l697" href="#l697">697</a><td> */<tr><td><a name="l698" href="#l698">698</a><td>webdriver.promise.when = function(value, opt_callback, opt_errback) {<tr><td><a name="l699" href="#l699">699</a><td>  if (value instanceof webdriver.promise.Promise) {<tr><td><a name="l700" href="#l700">700</a><td>    return value.then(opt_callback, opt_errback);<tr><td><a name="l701" href="#l701">701</a><td>  }<tr><td><a name="l702" href="#l702">702</a><td><tr><td><a name="l703" href="#l703">703</a><td>  var deferred = new webdriver.promise.Deferred();<tr><td><a name="l704" href="#l704">704</a><td><tr><td><a name="l705" href="#l705">705</a><td>  webdriver.promise.asap(value, deferred.fulfill, deferred.reject);<tr><td><a name="l706" href="#l706">706</a><td><tr><td><a name="l707" href="#l707">707</a><td>  return deferred.then(opt_callback, opt_errback);<tr><td><a name="l708" href="#l708">708</a><td>};<tr><td><a name="l709" href="#l709">709</a><td><tr><td><a name="l710" href="#l710">710</a><td><tr><td><a name="l711" href="#l711">711</a><td>/**<tr><td><a name="l712" href="#l712">712</a><td> * Invokes the appropriate callback function as soon as a promised<tr><td><a name="l713" href="#l713">713</a><td> * {@code value} is resolved. This function is similar to<tr><td><a name="l714" href="#l714">714</a><td> * {@link webdriver.promise.when}, except it does not return a new promise.<tr><td><a name="l715" href="#l715">715</a><td> * @param {*} value The value to observe.<tr><td><a name="l716" href="#l716">716</a><td> * @param {Function} callback The function to call when the value is<tr><td><a name="l717" href="#l717">717</a><td> *     resolved successfully.<tr><td><a name="l718" href="#l718">718</a><td> * @param {Function=} opt_errback The function to call when the value is<tr><td><a name="l719" href="#l719">719</a><td> *     rejected.<tr><td><a name="l720" href="#l720">720</a><td> */<tr><td><a name="l721" href="#l721">721</a><td>webdriver.promise.asap = function(value, callback, opt_errback) {<tr><td><a name="l722" href="#l722">722</a><td>  if (webdriver.promise.isPromise(value)) {<tr><td><a name="l723" href="#l723">723</a><td>    value.then(callback, opt_errback);<tr><td><a name="l724" href="#l724">724</a><td><tr><td><a name="l725" href="#l725">725</a><td>  // Maybe a Dojo-like deferred object?<tr><td><a name="l726" href="#l726">726</a><td>  } else if (!!value &amp;&amp; goog.isObject(value) &amp;&amp;<tr><td><a name="l727" href="#l727">727</a><td>      goog.isFunction(value.addCallbacks)) {<tr><td><a name="l728" href="#l728">728</a><td>    value.addCallbacks(callback, opt_errback);<tr><td><a name="l729" href="#l729">729</a><td><tr><td><a name="l730" href="#l730">730</a><td>  // A raw value, return a resolved promise.<tr><td><a name="l731" href="#l731">731</a><td>  } else if (callback) {<tr><td><a name="l732" href="#l732">732</a><td>    callback(value);<tr><td><a name="l733" href="#l733">733</a><td>  }<tr><td><a name="l734" href="#l734">734</a><td>};<tr><td><a name="l735" href="#l735">735</a><td><tr><td><a name="l736" href="#l736">736</a><td><tr><td><a name="l737" href="#l737">737</a><td>/**<tr><td><a name="l738" href="#l738">738</a><td> * Given an array of promises, will return a promise that will be fulfilled<tr><td><a name="l739" href="#l739">739</a><td> * with the fulfillment values of the input array&#39;s values. If any of the<tr><td><a name="l740" href="#l740">740</a><td> * input array&#39;s promises are rejected, the returned promise will be rejected<tr><td><a name="l741" href="#l741">741</a><td> * with the same reason.<tr><td><a name="l742" href="#l742">742</a><td> *<tr><td><a name="l743" href="#l743">743</a><td> * @param {!Array.&lt;(T|!webdriver.promise.Promise.&lt;T&gt;)&gt;} arr An array of<tr><td><a name="l744" href="#l744">744</a><td> *     promises to wait on.<tr><td><a name="l745" href="#l745">745</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;T&gt;&gt;} A promise that is<tr><td><a name="l746" href="#l746">746</a><td> *     fulfilled with an array containing the fulfilled values of the<tr><td><a name="l747" href="#l747">747</a><td> *     input array, or rejected with the same reason as the first<tr><td><a name="l748" href="#l748">748</a><td> *     rejected value.<tr><td><a name="l749" href="#l749">749</a><td> * @template T<tr><td><a name="l750" href="#l750">750</a><td> */<tr><td><a name="l751" href="#l751">751</a><td>webdriver.promise.all = function(arr) {<tr><td><a name="l752" href="#l752">752</a><td>  var n = arr.length;<tr><td><a name="l753" href="#l753">753</a><td>  if (!n) {<tr><td><a name="l754" href="#l754">754</a><td>    return webdriver.promise.fulfilled([]);<tr><td><a name="l755" href="#l755">755</a><td>  }<tr><td><a name="l756" href="#l756">756</a><td><tr><td><a name="l757" href="#l757">757</a><td>  var toFulfill = n;<tr><td><a name="l758" href="#l758">758</a><td>  var result = webdriver.promise.defer();<tr><td><a name="l759" href="#l759">759</a><td>  var values = [];<tr><td><a name="l760" href="#l760">760</a><td><tr><td><a name="l761" href="#l761">761</a><td>  var onFulfill = function(index, value) {<tr><td><a name="l762" href="#l762">762</a><td>    values[index] = value;<tr><td><a name="l763" href="#l763">763</a><td>    toFulfill--;<tr><td><a name="l764" href="#l764">764</a><td>    if (toFulfill == 0) {<tr><td><a name="l765" href="#l765">765</a><td>      result.fulfill(values);<tr><td><a name="l766" href="#l766">766</a><td>    }<tr><td><a name="l767" href="#l767">767</a><td>  };<tr><td><a name="l768" href="#l768">768</a><td><tr><td><a name="l769" href="#l769">769</a><td>  for (var i = 0; i &lt; n; ++i) {<tr><td><a name="l770" href="#l770">770</a><td>    webdriver.promise.asap(<tr><td><a name="l771" href="#l771">771</a><td>        arr[i], goog.partial(onFulfill, i), result.reject);<tr><td><a name="l772" href="#l772">772</a><td>  }<tr><td><a name="l773" href="#l773">773</a><td><tr><td><a name="l774" href="#l774">774</a><td>  return result.promise;<tr><td><a name="l775" href="#l775">775</a><td>};<tr><td><a name="l776" href="#l776">776</a><td><tr><td><a name="l777" href="#l777">777</a><td><tr><td><a name="l778" href="#l778">778</a><td>/**<tr><td><a name="l779" href="#l779">779</a><td> * Calls a function for each element in an array and inserts the result into a<tr><td><a name="l780" href="#l780">780</a><td> * new array, which is used as the fulfillment value of the promise returned<tr><td><a name="l781" href="#l781">781</a><td> * by this function.<tr><td><a name="l782" href="#l782">782</a><td> *<tr><td><a name="l783" href="#l783">783</a><td> * &lt;p&gt;If the return value of the mapping function is a promise, this function<tr><td><a name="l784" href="#l784">784</a><td> * will wait for it to be fulfilled before inserting it into the new array.<tr><td><a name="l785" href="#l785">785</a><td> *<tr><td><a name="l786" href="#l786">786</a><td> * &lt;p&gt;If the mapping function throws or returns a rejected promise, the<tr><td><a name="l787" href="#l787">787</a><td> * promise returned by this function will be rejected with the same reason.<tr><td><a name="l788" href="#l788">788</a><td> * Only the first failure will be reported; all subsequent errors will be<tr><td><a name="l789" href="#l789">789</a><td> * silently ignored.<tr><td><a name="l790" href="#l790">790</a><td> *<tr><td><a name="l791" href="#l791">791</a><td> * @param {!(Array.&lt;TYPE&gt;|webdriver.promise.Promise.&lt;!Array.&lt;TYPE&gt;&gt;)} arr The<tr><td><a name="l792" href="#l792">792</a><td> *     array to iterator over, or a promise that will resolve to said array.<tr><td><a name="l793" href="#l793">793</a><td> * @param {function(this: SELF, TYPE, number, !Array.&lt;TYPE&gt;): ?} fn The<tr><td><a name="l794" href="#l794">794</a><td> *     function to call for each element in the array. This function should<tr><td><a name="l795" href="#l795">795</a><td> *     expect three arguments (the element, the index, and the array itself.<tr><td><a name="l796" href="#l796">796</a><td> * @param {SELF=} opt_self The object to be used as the value of &#39;this&#39; within<tr><td><a name="l797" href="#l797">797</a><td> *     {@code fn}.<tr><td><a name="l798" href="#l798">798</a><td> * @template TYPE, SELF<tr><td><a name="l799" href="#l799">799</a><td> */<tr><td><a name="l800" href="#l800">800</a><td>webdriver.promise.map = function(arr, fn, opt_self) {<tr><td><a name="l801" href="#l801">801</a><td>  return webdriver.promise.when(arr, function(arr) {<tr><td><a name="l802" href="#l802">802</a><td>    var result = goog.array.map(arr, fn, opt_self);<tr><td><a name="l803" href="#l803">803</a><td>    return webdriver.promise.all(result);<tr><td><a name="l804" href="#l804">804</a><td>  });<tr><td><a name="l805" href="#l805">805</a><td>};<tr><td><a name="l806" href="#l806">806</a><td><tr><td><a name="l807" href="#l807">807</a><td><tr><td><a name="l808" href="#l808">808</a><td>/**<tr><td><a name="l809" href="#l809">809</a><td> * Calls a function for each element in an array, and if the function returns<tr><td><a name="l810" href="#l810">810</a><td> * true adds the element to a new array.<tr><td><a name="l811" href="#l811">811</a><td> *<tr><td><a name="l812" href="#l812">812</a><td> * &lt;p&gt;If the return value of the filter function is a promise, this function<tr><td><a name="l813" href="#l813">813</a><td> * will wait for it to be fulfilled before determining whether to insert the<tr><td><a name="l814" href="#l814">814</a><td> * element into the new array.<tr><td><a name="l815" href="#l815">815</a><td> *<tr><td><a name="l816" href="#l816">816</a><td> * &lt;p&gt;If the filter function throws or returns a rejected promise, the promise<tr><td><a name="l817" href="#l817">817</a><td> * returned by this function will be rejected with the same reason. Only the<tr><td><a name="l818" href="#l818">818</a><td> * first failure will be reported; all subsequent errors will be silently<tr><td><a name="l819" href="#l819">819</a><td> * ignored.<tr><td><a name="l820" href="#l820">820</a><td> *<tr><td><a name="l821" href="#l821">821</a><td> * @param {!(Array.&lt;TYPE&gt;|webdriver.promise.Promise.&lt;!Array.&lt;TYPE&gt;&gt;)} arr The<tr><td><a name="l822" href="#l822">822</a><td> *     array to iterator over, or a promise that will resolve to said array.<tr><td><a name="l823" href="#l823">823</a><td> * @param {function(this: SELF, TYPE, number, !Array.&lt;TYPE&gt;): (<tr><td><a name="l824" href="#l824">824</a><td> *             boolean|webdriver.promise.Promise.&lt;boolean&gt;)} fn The function<tr><td><a name="l825" href="#l825">825</a><td> *     to call for each element in the array.<tr><td><a name="l826" href="#l826">826</a><td> * @param {SELF=} opt_self The object to be used as the value of &#39;this&#39; within<tr><td><a name="l827" href="#l827">827</a><td> *     {@code fn}.<tr><td><a name="l828" href="#l828">828</a><td> * @template TYPE, SELF<tr><td><a name="l829" href="#l829">829</a><td> */<tr><td><a name="l830" href="#l830">830</a><td>webdriver.promise.filter = function(arr, fn, opt_self) {<tr><td><a name="l831" href="#l831">831</a><td>  return webdriver.promise.when(arr, function(arr) {<tr><td><a name="l832" href="#l832">832</a><td>    var originalValues = goog.array.clone(arr);<tr><td><a name="l833" href="#l833">833</a><td>    return webdriver.promise.map(arr, fn, opt_self).then(function(include) {<tr><td><a name="l834" href="#l834">834</a><td>      return goog.array.filter(originalValues, function(value, index) {<tr><td><a name="l835" href="#l835">835</a><td>        return include[index];<tr><td><a name="l836" href="#l836">836</a><td>      });<tr><td><a name="l837" href="#l837">837</a><td>    });<tr><td><a name="l838" href="#l838">838</a><td>  });<tr><td><a name="l839" href="#l839">839</a><td>};<tr><td><a name="l840" href="#l840">840</a><td><tr><td><a name="l841" href="#l841">841</a><td><tr><td><a name="l842" href="#l842">842</a><td>/**<tr><td><a name="l843" href="#l843">843</a><td> * Returns a promise that will be resolved with the input value in a<tr><td><a name="l844" href="#l844">844</a><td> * fully-resolved state. If the value is an array, each element will be fully<tr><td><a name="l845" href="#l845">845</a><td> * resolved. Likewise, if the value is an object, all keys will be fully<tr><td><a name="l846" href="#l846">846</a><td> * resolved. In both cases, all nested arrays and objects will also be<tr><td><a name="l847" href="#l847">847</a><td> * fully resolved.  All fields are resolved in place; the returned promise will<tr><td><a name="l848" href="#l848">848</a><td> * resolve on {@code value} and not a copy.<tr><td><a name="l849" href="#l849">849</a><td> *<tr><td><a name="l850" href="#l850">850</a><td> * Warning: This function makes no checks against objects that contain<tr><td><a name="l851" href="#l851">851</a><td> * cyclical references:<tr><td><a name="l852" href="#l852">852</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l853" href="#l853">853</a><td> *   var value = {};<tr><td><a name="l854" href="#l854">854</a><td> *   value[&#39;self&#39;] = value;<tr><td><a name="l855" href="#l855">855</a><td> *   webdriver.promise.fullyResolved(value);  // Stack overflow.<tr><td><a name="l856" href="#l856">856</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l857" href="#l857">857</a><td> *<tr><td><a name="l858" href="#l858">858</a><td> * @param {*} value The value to fully resolve.<tr><td><a name="l859" href="#l859">859</a><td> * @return {!webdriver.promise.Promise} A promise for a fully resolved version<tr><td><a name="l860" href="#l860">860</a><td> *     of the input value.<tr><td><a name="l861" href="#l861">861</a><td> */<tr><td><a name="l862" href="#l862">862</a><td>webdriver.promise.fullyResolved = function(value) {<tr><td><a name="l863" href="#l863">863</a><td>  if (webdriver.promise.isPromise(value)) {<tr><td><a name="l864" href="#l864">864</a><td>    return webdriver.promise.when(value, webdriver.promise.fullyResolveValue_);<tr><td><a name="l865" href="#l865">865</a><td>  }<tr><td><a name="l866" href="#l866">866</a><td>  return webdriver.promise.fullyResolveValue_(value);<tr><td><a name="l867" href="#l867">867</a><td>};<tr><td><a name="l868" href="#l868">868</a><td><tr><td><a name="l869" href="#l869">869</a><td><tr><td><a name="l870" href="#l870">870</a><td>/**<tr><td><a name="l871" href="#l871">871</a><td> * @param {*} value The value to fully resolve. If a promise, assumed to<tr><td><a name="l872" href="#l872">872</a><td> *     already be resolved.<tr><td><a name="l873" href="#l873">873</a><td> * @return {!webdriver.promise.Promise} A promise for a fully resolved version<tr><td><a name="l874" href="#l874">874</a><td> *     of the input value.<tr><td><a name="l875" href="#l875">875</a><td> * @private<tr><td><a name="l876" href="#l876">876</a><td> */<tr><td><a name="l877" href="#l877">877</a><td>webdriver.promise.fullyResolveValue_ = function(value) {<tr><td><a name="l878" href="#l878">878</a><td>  switch (goog.typeOf(value)) {<tr><td><a name="l879" href="#l879">879</a><td>    case &#39;array&#39;:<tr><td><a name="l880" href="#l880">880</a><td>      return webdriver.promise.fullyResolveKeys_(<tr><td><a name="l881" href="#l881">881</a><td>          /** @type {!Array} */ (value));<tr><td><a name="l882" href="#l882">882</a><td><tr><td><a name="l883" href="#l883">883</a><td>    case &#39;object&#39;:<tr><td><a name="l884" href="#l884">884</a><td>      if (webdriver.promise.isPromise(value)) {<tr><td><a name="l885" href="#l885">885</a><td>        // We get here when the original input value is a promise that<tr><td><a name="l886" href="#l886">886</a><td>        // resolves to itself. When the user provides us with such a promise,<tr><td><a name="l887" href="#l887">887</a><td>        // trust that it counts as a &quot;fully resolved&quot; value and return it.<tr><td><a name="l888" href="#l888">888</a><td>        // Of course, since it&#39;s already a promise, we can just return it<tr><td><a name="l889" href="#l889">889</a><td>        // to the user instead of wrapping it in another promise.<tr><td><a name="l890" href="#l890">890</a><td>        return /** @type {!webdriver.promise.Promise} */ (value);<tr><td><a name="l891" href="#l891">891</a><td>      }<tr><td><a name="l892" href="#l892">892</a><td><tr><td><a name="l893" href="#l893">893</a><td>      if (goog.isNumber(value.nodeType) &amp;&amp;<tr><td><a name="l894" href="#l894">894</a><td>          goog.isObject(value.ownerDocument) &amp;&amp;<tr><td><a name="l895" href="#l895">895</a><td>          goog.isNumber(value.ownerDocument.nodeType)) {<tr><td><a name="l896" href="#l896">896</a><td>        // DOM node; return early to avoid infinite recursion. Should we<tr><td><a name="l897" href="#l897">897</a><td>        // only support objects with a certain level of nesting?<tr><td><a name="l898" href="#l898">898</a><td>        return webdriver.promise.fulfilled(value);<tr><td><a name="l899" href="#l899">899</a><td>      }<tr><td><a name="l900" href="#l900">900</a><td><tr><td><a name="l901" href="#l901">901</a><td>      return webdriver.promise.fullyResolveKeys_(<tr><td><a name="l902" href="#l902">902</a><td>          /** @type {!Object} */ (value));<tr><td><a name="l903" href="#l903">903</a><td><tr><td><a name="l904" href="#l904">904</a><td>    default:  // boolean, function, null, number, string, undefined<tr><td><a name="l905" href="#l905">905</a><td>      return webdriver.promise.fulfilled(value);<tr><td><a name="l906" href="#l906">906</a><td>  }<tr><td><a name="l907" href="#l907">907</a><td>};<tr><td><a name="l908" href="#l908">908</a><td><tr><td><a name="l909" href="#l909">909</a><td><tr><td><a name="l910" href="#l910">910</a><td>/**<tr><td><a name="l911" href="#l911">911</a><td> * @param {!(Array|Object)} obj the object to resolve.<tr><td><a name="l912" href="#l912">912</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l913" href="#l913">913</a><td> *     input object once all of its values have been fully resolved.<tr><td><a name="l914" href="#l914">914</a><td> * @private<tr><td><a name="l915" href="#l915">915</a><td> */<tr><td><a name="l916" href="#l916">916</a><td>webdriver.promise.fullyResolveKeys_ = function(obj) {<tr><td><a name="l917" href="#l917">917</a><td>  var isArray = goog.isArray(obj);<tr><td><a name="l918" href="#l918">918</a><td>  var numKeys = isArray ? obj.length : goog.object.getCount(obj);<tr><td><a name="l919" href="#l919">919</a><td>  if (!numKeys) {<tr><td><a name="l920" href="#l920">920</a><td>    return webdriver.promise.fulfilled(obj);<tr><td><a name="l921" href="#l921">921</a><td>  }<tr><td><a name="l922" href="#l922">922</a><td><tr><td><a name="l923" href="#l923">923</a><td>  var numResolved = 0;<tr><td><a name="l924" href="#l924">924</a><td>  var deferred = new webdriver.promise.Deferred();<tr><td><a name="l925" href="#l925">925</a><td><tr><td><a name="l926" href="#l926">926</a><td>  // In pre-IE9, goog.array.forEach will not iterate properly over arrays<tr><td><a name="l927" href="#l927">927</a><td>  // containing undefined values because &quot;index in array&quot; returns false<tr><td><a name="l928" href="#l928">928</a><td>  // when array[index] === undefined (even for x = [undefined, 1]). To get<tr><td><a name="l929" href="#l929">929</a><td>  // around this, we need to use our own forEach implementation.<tr><td><a name="l930" href="#l930">930</a><td>  // DO NOT REMOVE THIS UNTIL WE NO LONGER SUPPORT IE8. This cannot be<tr><td><a name="l931" href="#l931">931</a><td>  // reproduced in IE9 by changing the browser/document modes, it requires an<tr><td><a name="l932" href="#l932">932</a><td>  // actual pre-IE9 browser.  Yay, IE!<tr><td><a name="l933" href="#l933">933</a><td>  var forEachKey = !isArray ? goog.object.forEach : function(arr, fn) {<tr><td><a name="l934" href="#l934">934</a><td>    var n = arr.length;<tr><td><a name="l935" href="#l935">935</a><td>    for (var i = 0; i &lt; n; ++i) {<tr><td><a name="l936" href="#l936">936</a><td>      fn.call(null, arr[i], i, arr);<tr><td><a name="l937" href="#l937">937</a><td>    }<tr><td><a name="l938" href="#l938">938</a><td>  };<tr><td><a name="l939" href="#l939">939</a><td><tr><td><a name="l940" href="#l940">940</a><td>  forEachKey(obj, function(partialValue, key) {<tr><td><a name="l941" href="#l941">941</a><td>    var type = goog.typeOf(partialValue);<tr><td><a name="l942" href="#l942">942</a><td>    if (type != &#39;array&#39; &amp;&amp; type != &#39;object&#39;) {<tr><td><a name="l943" href="#l943">943</a><td>      maybeResolveValue();<tr><td><a name="l944" href="#l944">944</a><td>      return;<tr><td><a name="l945" href="#l945">945</a><td>    }<tr><td><a name="l946" href="#l946">946</a><td><tr><td><a name="l947" href="#l947">947</a><td>    webdriver.promise.fullyResolved(partialValue).then(<tr><td><a name="l948" href="#l948">948</a><td>        function(resolvedValue) {<tr><td><a name="l949" href="#l949">949</a><td>          obj[key] = resolvedValue;<tr><td><a name="l950" href="#l950">950</a><td>          maybeResolveValue();<tr><td><a name="l951" href="#l951">951</a><td>        },<tr><td><a name="l952" href="#l952">952</a><td>        deferred.reject);<tr><td><a name="l953" href="#l953">953</a><td>  });<tr><td><a name="l954" href="#l954">954</a><td><tr><td><a name="l955" href="#l955">955</a><td>  return deferred.promise;<tr><td><a name="l956" href="#l956">956</a><td><tr><td><a name="l957" href="#l957">957</a><td>  function maybeResolveValue() {<tr><td><a name="l958" href="#l958">958</a><td>    if (++numResolved == numKeys) {<tr><td><a name="l959" href="#l959">959</a><td>      deferred.fulfill(obj);<tr><td><a name="l960" href="#l960">960</a><td>    }<tr><td><a name="l961" href="#l961">961</a><td>  }<tr><td><a name="l962" href="#l962">962</a><td>};<tr><td><a name="l963" href="#l963">963</a><td><tr><td><a name="l964" href="#l964">964</a><td><tr><td><a name="l965" href="#l965">965</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a name="l966" href="#l966">966</a><td>//<tr><td><a name="l967" href="#l967">967</a><td>//  webdriver.promise.ControlFlow<tr><td><a name="l968" href="#l968">968</a><td>//<tr><td><a name="l969" href="#l969">969</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a name="l970" href="#l970">970</a><td><tr><td><a name="l971" href="#l971">971</a><td><tr><td><a name="l972" href="#l972">972</a><td><tr><td><a name="l973" href="#l973">973</a><td>/**<tr><td><a name="l974" href="#l974">974</a><td> * Handles the execution of scheduled tasks, each of which may be an<tr><td><a name="l975" href="#l975">975</a><td> * asynchronous operation. The control flow will ensure tasks are executed in<tr><td><a name="l976" href="#l976">976</a><td> * the ordered scheduled, starting each task only once those before it have<tr><td><a name="l977" href="#l977">977</a><td> * completed.<tr><td><a name="l978" href="#l978">978</a><td> *<tr><td><a name="l979" href="#l979">979</a><td> * &lt;p&gt;Each task scheduled within this flow may return a<tr><td><a name="l980" href="#l980">980</a><td> * {@link webdriver.promise.Promise} to indicate it is an asynchronous<tr><td><a name="l981" href="#l981">981</a><td> * operation. The ControlFlow will wait for such promises to be resolved before<tr><td><a name="l982" href="#l982">982</a><td> * marking the task as completed.<tr><td><a name="l983" href="#l983">983</a><td> *<tr><td><a name="l984" href="#l984">984</a><td> * &lt;p&gt;Tasks and each callback registered on a {@link webdriver.promise.Deferred}<tr><td><a name="l985" href="#l985">985</a><td> * will be run in their own ControlFlow frame.  Any tasks scheduled within a<tr><td><a name="l986" href="#l986">986</a><td> * frame will have priority over previously scheduled tasks. Furthermore, if<tr><td><a name="l987" href="#l987">987</a><td> * any of the tasks in the frame fails, the remainder of the tasks in that frame<tr><td><a name="l988" href="#l988">988</a><td> * will be discarded and the failure will be propagated to the user through the<tr><td><a name="l989" href="#l989">989</a><td> * callback/task&#39;s promised result.<tr><td><a name="l990" href="#l990">990</a><td> *<tr><td><a name="l991" href="#l991">991</a><td> * &lt;p&gt;Each time a ControlFlow empties its task queue, it will fire an<tr><td><a name="l992" href="#l992">992</a><td> * {@link webdriver.promise.ControlFlow.EventType.IDLE} event. Conversely,<tr><td><a name="l993" href="#l993">993</a><td> * whenever the flow terminates due to an unhandled error, it will remove all<tr><td><a name="l994" href="#l994">994</a><td> * remaining tasks in its queue and fire an<tr><td><a name="l995" href="#l995">995</a><td> * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION} event. If<tr><td><a name="l996" href="#l996">996</a><td> * there are no listeners registered with the flow, the error will be<tr><td><a name="l997" href="#l997">997</a><td> * rethrown to the global error handler.<tr><td><a name="l998" href="#l998">998</a><td> *<tr><td><a name="l999" href="#l999">999</a><td> * @param {webdriver.promise.ControlFlow.Timer=} opt_timer The timer object<tr><td><a name="l1000" href="#l1000">1000</a><td> *     to use. Should only be set for testing.<tr><td><a name="l1001" href="#l1001">1001</a><td> * @constructor<tr><td><a name="l1002" href="#l1002">1002</a><td> * @extends {webdriver.EventEmitter}<tr><td><a name="l1003" href="#l1003">1003</a><td> */<tr><td><a name="l1004" href="#l1004">1004</a><td>webdriver.promise.ControlFlow = function(opt_timer) {<tr><td><a name="l1005" href="#l1005">1005</a><td>  webdriver.EventEmitter.call(this);<tr><td><a name="l1006" href="#l1006">1006</a><td><tr><td><a name="l1007" href="#l1007">1007</a><td>  /**<tr><td><a name="l1008" href="#l1008">1008</a><td>   * The timer used by this instance.<tr><td><a name="l1009" href="#l1009">1009</a><td>   * @type {webdriver.promise.ControlFlow.Timer}<tr><td><a name="l1010" href="#l1010">1010</a><td>   */<tr><td><a name="l1011" href="#l1011">1011</a><td>  this.timer = opt_timer || webdriver.promise.ControlFlow.defaultTimer;<tr><td><a name="l1012" href="#l1012">1012</a><td><tr><td><a name="l1013" href="#l1013">1013</a><td>  /**<tr><td><a name="l1014" href="#l1014">1014</a><td>   * A list of recent tasks. Each time a new task is started, or a frame is<tr><td><a name="l1015" href="#l1015">1015</a><td>   * completed, the previously recorded task is removed from this list. If<tr><td><a name="l1016" href="#l1016">1016</a><td>   * there are multiple tasks, task N+1 is considered a sub-task of task<tr><td><a name="l1017" href="#l1017">1017</a><td>   * N.<tr><td><a name="l1018" href="#l1018">1018</a><td>   * @private {!Array.&lt;!webdriver.promise.Task_&gt;}<tr><td><a name="l1019" href="#l1019">1019</a><td>   */<tr><td><a name="l1020" href="#l1020">1020</a><td>  this.history_ = [];<tr><td><a name="l1021" href="#l1021">1021</a><td>};<tr><td><a name="l1022" href="#l1022">1022</a><td>goog.inherits(webdriver.promise.ControlFlow, webdriver.EventEmitter);<tr><td><a name="l1023" href="#l1023">1023</a><td><tr><td><a name="l1024" href="#l1024">1024</a><td><tr><td><a name="l1025" href="#l1025">1025</a><td>/**<tr><td><a name="l1026" href="#l1026">1026</a><td> * @typedef {{clearInterval: function(number),<tr><td><a name="l1027" href="#l1027">1027</a><td> *            clearTimeout: function(number),<tr><td><a name="l1028" href="#l1028">1028</a><td> *            setInterval: function(!Function, number): number,<tr><td><a name="l1029" href="#l1029">1029</a><td> *            setTimeout: function(!Function, number): number}}<tr><td><a name="l1030" href="#l1030">1030</a><td> */<tr><td><a name="l1031" href="#l1031">1031</a><td>webdriver.promise.ControlFlow.Timer;<tr><td><a name="l1032" href="#l1032">1032</a><td><tr><td><a name="l1033" href="#l1033">1033</a><td><tr><td><a name="l1034" href="#l1034">1034</a><td>/**<tr><td><a name="l1035" href="#l1035">1035</a><td> * The default timer object, which uses the global timer functions.<tr><td><a name="l1036" href="#l1036">1036</a><td> * @type {webdriver.promise.ControlFlow.Timer}<tr><td><a name="l1037" href="#l1037">1037</a><td> */<tr><td><a name="l1038" href="#l1038">1038</a><td>webdriver.promise.ControlFlow.defaultTimer = (function() {<tr><td><a name="l1039" href="#l1039">1039</a><td>  // The default timer functions may be defined as free variables for the<tr><td><a name="l1040" href="#l1040">1040</a><td>  // current context, so do not reference them using &quot;window&quot; or<tr><td><a name="l1041" href="#l1041">1041</a><td>  // &quot;goog.global&quot;.  Also, we must invoke them in a closure, and not using<tr><td><a name="l1042" href="#l1042">1042</a><td>  // bind(), so we do not get &quot;TypeError: Illegal invocation&quot; (WebKit) or<tr><td><a name="l1043" href="#l1043">1043</a><td>  // &quot;Invalid calling object&quot; (IE) errors.<tr><td><a name="l1044" href="#l1044">1044</a><td>  return {<tr><td><a name="l1045" href="#l1045">1045</a><td>    clearInterval: wrap(clearInterval),<tr><td><a name="l1046" href="#l1046">1046</a><td>    clearTimeout: wrap(clearTimeout),<tr><td><a name="l1047" href="#l1047">1047</a><td>    setInterval: wrap(setInterval),<tr><td><a name="l1048" href="#l1048">1048</a><td>    setTimeout: wrap(setTimeout)<tr><td><a name="l1049" href="#l1049">1049</a><td>  };<tr><td><a name="l1050" href="#l1050">1050</a><td><tr><td><a name="l1051" href="#l1051">1051</a><td>  function wrap(fn) {<tr><td><a name="l1052" href="#l1052">1052</a><td>    return function() {<tr><td><a name="l1053" href="#l1053">1053</a><td>      // Cannot use .call() or .apply() since we do not know which variable<tr><td><a name="l1054" href="#l1054">1054</a><td>      // the function is bound to, and using the wrong one will generate<tr><td><a name="l1055" href="#l1055">1055</a><td>      // an error.<tr><td><a name="l1056" href="#l1056">1056</a><td>      return fn(arguments[0], arguments[1]);<tr><td><a name="l1057" href="#l1057">1057</a><td>    };<tr><td><a name="l1058" href="#l1058">1058</a><td>  }<tr><td><a name="l1059" href="#l1059">1059</a><td>})();<tr><td><a name="l1060" href="#l1060">1060</a><td><tr><td><a name="l1061" href="#l1061">1061</a><td><tr><td><a name="l1062" href="#l1062">1062</a><td>/**<tr><td><a name="l1063" href="#l1063">1063</a><td> * Events that may be emitted by an {@link webdriver.promise.ControlFlow}.<tr><td><a name="l1064" href="#l1064">1064</a><td> * @enum {string}<tr><td><a name="l1065" href="#l1065">1065</a><td> */<tr><td><a name="l1066" href="#l1066">1066</a><td>webdriver.promise.ControlFlow.EventType = {<tr><td><a name="l1067" href="#l1067">1067</a><td><tr><td><a name="l1068" href="#l1068">1068</a><td>  /** Emitted when all tasks have been successfully executed. */<tr><td><a name="l1069" href="#l1069">1069</a><td>  IDLE: &#39;idle&#39;,<tr><td><a name="l1070" href="#l1070">1070</a><td><tr><td><a name="l1071" href="#l1071">1071</a><td>  /** Emitted whenever a new task has been scheduled. */<tr><td><a name="l1072" href="#l1072">1072</a><td>  SCHEDULE_TASK: &#39;scheduleTask&#39;,<tr><td><a name="l1073" href="#l1073">1073</a><td><tr><td><a name="l1074" href="#l1074">1074</a><td>  /**<tr><td><a name="l1075" href="#l1075">1075</a><td>   * Emitted whenever a control flow aborts due to an unhandled promise<tr><td><a name="l1076" href="#l1076">1076</a><td>   * rejection. This event will be emitted along with the offending rejection<tr><td><a name="l1077" href="#l1077">1077</a><td>   * reason. Upon emitting this event, the control flow will empty its task<tr><td><a name="l1078" href="#l1078">1078</a><td>   * queue and revert to its initial state.<tr><td><a name="l1079" href="#l1079">1079</a><td>   */<tr><td><a name="l1080" href="#l1080">1080</a><td>  UNCAUGHT_EXCEPTION: &#39;uncaughtException&#39;<tr><td><a name="l1081" href="#l1081">1081</a><td>};<tr><td><a name="l1082" href="#l1082">1082</a><td><tr><td><a name="l1083" href="#l1083">1083</a><td><tr><td><a name="l1084" href="#l1084">1084</a><td>/**<tr><td><a name="l1085" href="#l1085">1085</a><td> * How often, in milliseconds, the event loop should run.<tr><td><a name="l1086" href="#l1086">1086</a><td> * @type {number}<tr><td><a name="l1087" href="#l1087">1087</a><td> * @const<tr><td><a name="l1088" href="#l1088">1088</a><td> */<tr><td><a name="l1089" href="#l1089">1089</a><td>webdriver.promise.ControlFlow.EVENT_LOOP_FREQUENCY = 10;<tr><td><a name="l1090" href="#l1090">1090</a><td><tr><td><a name="l1091" href="#l1091">1091</a><td><tr><td><a name="l1092" href="#l1092">1092</a><td>/**<tr><td><a name="l1093" href="#l1093">1093</a><td> * Tracks the active execution frame for this instance. Lazily initialized<tr><td><a name="l1094" href="#l1094">1094</a><td> * when the first task is scheduled.<tr><td><a name="l1095" href="#l1095">1095</a><td> * @private {webdriver.promise.Frame_}<tr><td><a name="l1096" href="#l1096">1096</a><td> */<tr><td><a name="l1097" href="#l1097">1097</a><td>webdriver.promise.ControlFlow.prototype.activeFrame_ = null;<tr><td><a name="l1098" href="#l1098">1098</a><td><tr><td><a name="l1099" href="#l1099">1099</a><td><tr><td><a name="l1100" href="#l1100">1100</a><td>/**<tr><td><a name="l1101" href="#l1101">1101</a><td> * A reference to the frame in which new tasks should be scheduled. If<tr><td><a name="l1102" href="#l1102">1102</a><td> * {@code null}, tasks will be scheduled within the active frame. When forcing<tr><td><a name="l1103" href="#l1103">1103</a><td> * a function to run in the context of a new frame, this pointer is used to<tr><td><a name="l1104" href="#l1104">1104</a><td> * ensure tasks are scheduled within the newly created frame, even though it<tr><td><a name="l1105" href="#l1105">1105</a><td> * won&#39;t be active yet.<tr><td><a name="l1106" href="#l1106">1106</a><td> * @private {webdriver.promise.Frame_}<tr><td><a name="l1107" href="#l1107">1107</a><td> * @see {#runInNewFrame_}<tr><td><a name="l1108" href="#l1108">1108</a><td> */<tr><td><a name="l1109" href="#l1109">1109</a><td>webdriver.promise.ControlFlow.prototype.schedulingFrame_ = null;<tr><td><a name="l1110" href="#l1110">1110</a><td><tr><td><a name="l1111" href="#l1111">1111</a><td><tr><td><a name="l1112" href="#l1112">1112</a><td>/**<tr><td><a name="l1113" href="#l1113">1113</a><td> * Timeout ID set when the flow is about to shutdown without any errors<tr><td><a name="l1114" href="#l1114">1114</a><td> * being detected. Upon shutting down, the flow will emit an<tr><td><a name="l1115" href="#l1115">1115</a><td> * {@link webdriver.promise.ControlFlow.EventType.IDLE} event. Idle events<tr><td><a name="l1116" href="#l1116">1116</a><td> * always follow a brief timeout in order to catch latent errors from the last<tr><td><a name="l1117" href="#l1117">1117</a><td> * completed task. If this task had a callback registered, but no errback, and<tr><td><a name="l1118" href="#l1118">1118</a><td> * the task fails, the unhandled failure would not be reported by the promise<tr><td><a name="l1119" href="#l1119">1119</a><td> * system until the next turn of the event loop:<tr><td><a name="l1120" href="#l1120">1120</a><td> *<tr><td><a name="l1121" href="#l1121">1121</a><td> *   // Schedule 1 task that fails.<tr><td><a name="l1122" href="#l1122">1122</a><td> *   var result = webriver.promise.controlFlow().schedule(&#39;example&#39;,<tr><td><a name="l1123" href="#l1123">1123</a><td> *       function() { return webdriver.promise.rejected(&#39;failed&#39;); });<tr><td><a name="l1124" href="#l1124">1124</a><td> *   // Set a callback on the result. This delays reporting the unhandled<tr><td><a name="l1125" href="#l1125">1125</a><td> *   // failure for 1 turn of the event loop.<tr><td><a name="l1126" href="#l1126">1126</a><td> *   result.then(goog.nullFunction);<tr><td><a name="l1127" href="#l1127">1127</a><td> *<tr><td><a name="l1128" href="#l1128">1128</a><td> * @private {?number}<tr><td><a name="l1129" href="#l1129">1129</a><td> */<tr><td><a name="l1130" href="#l1130">1130</a><td>webdriver.promise.ControlFlow.prototype.shutdownId_ = null;<tr><td><a name="l1131" href="#l1131">1131</a><td><tr><td><a name="l1132" href="#l1132">1132</a><td><tr><td><a name="l1133" href="#l1133">1133</a><td>/**<tr><td><a name="l1134" href="#l1134">1134</a><td> * Interval ID for this instance&#39;s event loop.<tr><td><a name="l1135" href="#l1135">1135</a><td> * @private {?number}<tr><td><a name="l1136" href="#l1136">1136</a><td> */<tr><td><a name="l1137" href="#l1137">1137</a><td>webdriver.promise.ControlFlow.prototype.eventLoopId_ = null;<tr><td><a name="l1138" href="#l1138">1138</a><td><tr><td><a name="l1139" href="#l1139">1139</a><td><tr><td><a name="l1140" href="#l1140">1140</a><td>/**<tr><td><a name="l1141" href="#l1141">1141</a><td> * The number of &quot;pending&quot; promise rejections.<tr><td><a name="l1142" href="#l1142">1142</a><td> *<tr><td><a name="l1143" href="#l1143">1143</a><td> * &lt;p&gt;Each time a promise is rejected and is not handled by a listener, it will<tr><td><a name="l1144" href="#l1144">1144</a><td> * schedule a 0-based timeout to check if it is still unrejected in the next<tr><td><a name="l1145" href="#l1145">1145</a><td> * turn of the JS-event loop. This allows listeners to attach to, and handle,<tr><td><a name="l1146" href="#l1146">1146</a><td> * the rejected promise at any point in same turn of the event loop that the<tr><td><a name="l1147" href="#l1147">1147</a><td> * promise was rejected.<tr><td><a name="l1148" href="#l1148">1148</a><td> *<tr><td><a name="l1149" href="#l1149">1149</a><td> * &lt;p&gt;When this flow&#39;s own event loop triggers, it will not run if there<tr><td><a name="l1150" href="#l1150">1150</a><td> * are any outstanding promise rejections. This allows unhandled promises to<tr><td><a name="l1151" href="#l1151">1151</a><td> * be reported before a new task is started, ensuring the error is reported to<tr><td><a name="l1152" href="#l1152">1152</a><td> * the current task queue.<tr><td><a name="l1153" href="#l1153">1153</a><td> *<tr><td><a name="l1154" href="#l1154">1154</a><td> * @private {number}<tr><td><a name="l1155" href="#l1155">1155</a><td> */<tr><td><a name="l1156" href="#l1156">1156</a><td>webdriver.promise.ControlFlow.prototype.pendingRejections_ = 0;<tr><td><a name="l1157" href="#l1157">1157</a><td><tr><td><a name="l1158" href="#l1158">1158</a><td><tr><td><a name="l1159" href="#l1159">1159</a><td>/**<tr><td><a name="l1160" href="#l1160">1160</a><td> * The number of aborted frames since the last time a task was executed or a<tr><td><a name="l1161" href="#l1161">1161</a><td> * frame completed successfully.<tr><td><a name="l1162" href="#l1162">1162</a><td> * @private {number}<tr><td><a name="l1163" href="#l1163">1163</a><td> */<tr><td><a name="l1164" href="#l1164">1164</a><td>webdriver.promise.ControlFlow.prototype.numAbortedFrames_ = 0;<tr><td><a name="l1165" href="#l1165">1165</a><td><tr><td><a name="l1166" href="#l1166">1166</a><td><tr><td><a name="l1167" href="#l1167">1167</a><td>/**<tr><td><a name="l1168" href="#l1168">1168</a><td> * Resets this instance, clearing its queue and removing all event listeners.<tr><td><a name="l1169" href="#l1169">1169</a><td> */<tr><td><a name="l1170" href="#l1170">1170</a><td>webdriver.promise.ControlFlow.prototype.reset = function() {<tr><td><a name="l1171" href="#l1171">1171</a><td>  this.activeFrame_ = null;<tr><td><a name="l1172" href="#l1172">1172</a><td>  this.clearHistory();<tr><td><a name="l1173" href="#l1173">1173</a><td>  this.removeAllListeners();<tr><td><a name="l1174" href="#l1174">1174</a><td>  this.cancelShutdown_();<tr><td><a name="l1175" href="#l1175">1175</a><td>  this.cancelEventLoop_();<tr><td><a name="l1176" href="#l1176">1176</a><td>};<tr><td><a name="l1177" href="#l1177">1177</a><td><tr><td><a name="l1178" href="#l1178">1178</a><td><tr><td><a name="l1179" href="#l1179">1179</a><td>/**<tr><td><a name="l1180" href="#l1180">1180</a><td> * Returns a summary of the recent task activity for this instance. This<tr><td><a name="l1181" href="#l1181">1181</a><td> * includes the most recently completed task, as well as any parent tasks. In<tr><td><a name="l1182" href="#l1182">1182</a><td> * the returned summary, the task at index N is considered a sub-task of the<tr><td><a name="l1183" href="#l1183">1183</a><td> * task at index N+1.<tr><td><a name="l1184" href="#l1184">1184</a><td> * @return {!Array.&lt;string&gt;} A summary of this instance&#39;s recent task<tr><td><a name="l1185" href="#l1185">1185</a><td> *     activity.<tr><td><a name="l1186" href="#l1186">1186</a><td> */<tr><td><a name="l1187" href="#l1187">1187</a><td>webdriver.promise.ControlFlow.prototype.getHistory = function() {<tr><td><a name="l1188" href="#l1188">1188</a><td>  var pendingTasks = [];<tr><td><a name="l1189" href="#l1189">1189</a><td>  var currentFrame = this.activeFrame_;<tr><td><a name="l1190" href="#l1190">1190</a><td>  while (currentFrame) {<tr><td><a name="l1191" href="#l1191">1191</a><td>    var task = currentFrame.getPendingTask();<tr><td><a name="l1192" href="#l1192">1192</a><td>    if (task) {<tr><td><a name="l1193" href="#l1193">1193</a><td>      pendingTasks.push(task);<tr><td><a name="l1194" href="#l1194">1194</a><td>    }<tr><td><a name="l1195" href="#l1195">1195</a><td>    // A frame&#39;s parent node will always be another frame.<tr><td><a name="l1196" href="#l1196">1196</a><td>    currentFrame =<tr><td><a name="l1197" href="#l1197">1197</a><td>        /** @type {webdriver.promise.Frame_} */ (currentFrame.getParent());<tr><td><a name="l1198" href="#l1198">1198</a><td>  }<tr><td><a name="l1199" href="#l1199">1199</a><td><tr><td><a name="l1200" href="#l1200">1200</a><td>  var fullHistory = goog.array.concat(this.history_, pendingTasks);<tr><td><a name="l1201" href="#l1201">1201</a><td>  return goog.array.map(fullHistory, function(task) {<tr><td><a name="l1202" href="#l1202">1202</a><td>    return task.toString();<tr><td><a name="l1203" href="#l1203">1203</a><td>  });<tr><td><a name="l1204" href="#l1204">1204</a><td>};<tr><td><a name="l1205" href="#l1205">1205</a><td><tr><td><a name="l1206" href="#l1206">1206</a><td><tr><td><a name="l1207" href="#l1207">1207</a><td>/** Clears this instance&#39;s task history. */<tr><td><a name="l1208" href="#l1208">1208</a><td>webdriver.promise.ControlFlow.prototype.clearHistory = function() {<tr><td><a name="l1209" href="#l1209">1209</a><td>  this.history_ = [];<tr><td><a name="l1210" href="#l1210">1210</a><td>};<tr><td><a name="l1211" href="#l1211">1211</a><td><tr><td><a name="l1212" href="#l1212">1212</a><td><tr><td><a name="l1213" href="#l1213">1213</a><td>/**<tr><td><a name="l1214" href="#l1214">1214</a><td> * Removes a completed task from this instance&#39;s history record. If any<tr><td><a name="l1215" href="#l1215">1215</a><td> * tasks remain from aborted frames, those will be removed as well.<tr><td><a name="l1216" href="#l1216">1216</a><td> * @private<tr><td><a name="l1217" href="#l1217">1217</a><td> */<tr><td><a name="l1218" href="#l1218">1218</a><td>webdriver.promise.ControlFlow.prototype.trimHistory_ = function() {<tr><td><a name="l1219" href="#l1219">1219</a><td>  if (this.numAbortedFrames_) {<tr><td><a name="l1220" href="#l1220">1220</a><td>    goog.array.splice(this.history_,<tr><td><a name="l1221" href="#l1221">1221</a><td>        this.history_.length - this.numAbortedFrames_,<tr><td><a name="l1222" href="#l1222">1222</a><td>        this.numAbortedFrames_);<tr><td><a name="l1223" href="#l1223">1223</a><td>    this.numAbortedFrames_ = 0;<tr><td><a name="l1224" href="#l1224">1224</a><td>  }<tr><td><a name="l1225" href="#l1225">1225</a><td>  this.history_.pop();<tr><td><a name="l1226" href="#l1226">1226</a><td>};<tr><td><a name="l1227" href="#l1227">1227</a><td><tr><td><a name="l1228" href="#l1228">1228</a><td><tr><td><a name="l1229" href="#l1229">1229</a><td>/**<tr><td><a name="l1230" href="#l1230">1230</a><td> * Property used to track whether an error has been annotated by<tr><td><a name="l1231" href="#l1231">1231</a><td> * {@link webdriver.promise.ControlFlow#annotateError}.<tr><td><a name="l1232" href="#l1232">1232</a><td> * @private {string}<tr><td><a name="l1233" href="#l1233">1233</a><td> * @const<tr><td><a name="l1234" href="#l1234">1234</a><td> */<tr><td><a name="l1235" href="#l1235">1235</a><td>webdriver.promise.ControlFlow.ANNOTATION_PROPERTY_ =<tr><td><a name="l1236" href="#l1236">1236</a><td>    &#39;webdriver_promise_error_&#39;;<tr><td><a name="l1237" href="#l1237">1237</a><td><tr><td><a name="l1238" href="#l1238">1238</a><td><tr><td><a name="l1239" href="#l1239">1239</a><td>/**<tr><td><a name="l1240" href="#l1240">1240</a><td> * Appends a summary of this instance&#39;s recent task history to the given<tr><td><a name="l1241" href="#l1241">1241</a><td> * error&#39;s stack trace. This function will also ensure the error&#39;s stack trace<tr><td><a name="l1242" href="#l1242">1242</a><td> * is in canonical form.<tr><td><a name="l1243" href="#l1243">1243</a><td> * @param {!(Error|goog.testing.JsUnitException)} e The error to annotate.<tr><td><a name="l1244" href="#l1244">1244</a><td> * @return {!(Error|goog.testing.JsUnitException)} The annotated error.<tr><td><a name="l1245" href="#l1245">1245</a><td> */<tr><td><a name="l1246" href="#l1246">1246</a><td>webdriver.promise.ControlFlow.prototype.annotateError = function(e) {<tr><td><a name="l1247" href="#l1247">1247</a><td>  if (!!e[webdriver.promise.ControlFlow.ANNOTATION_PROPERTY_]) {<tr><td><a name="l1248" href="#l1248">1248</a><td>    return e;<tr><td><a name="l1249" href="#l1249">1249</a><td>  }<tr><td><a name="l1250" href="#l1250">1250</a><td><tr><td><a name="l1251" href="#l1251">1251</a><td>  var history = this.getHistory();<tr><td><a name="l1252" href="#l1252">1252</a><td>  if (history.length) {<tr><td><a name="l1253" href="#l1253">1253</a><td>    e = webdriver.stacktrace.format(e);<tr><td><a name="l1254" href="#l1254">1254</a><td><tr><td><a name="l1255" href="#l1255">1255</a><td>    /** @type {!Error} */(e).stack += [<tr><td><a name="l1256" href="#l1256">1256</a><td>      &#39;\n==== async task ====\n&#39;,<tr><td><a name="l1257" href="#l1257">1257</a><td>      history.join(&#39;\n==== async task ====\n&#39;)<tr><td><a name="l1258" href="#l1258">1258</a><td>    ].join(&#39;&#39;);<tr><td><a name="l1259" href="#l1259">1259</a><td><tr><td><a name="l1260" href="#l1260">1260</a><td>    e[webdriver.promise.ControlFlow.ANNOTATION_PROPERTY_] = true;<tr><td><a name="l1261" href="#l1261">1261</a><td>  }<tr><td><a name="l1262" href="#l1262">1262</a><td><tr><td><a name="l1263" href="#l1263">1263</a><td>  return e;<tr><td><a name="l1264" href="#l1264">1264</a><td>};<tr><td><a name="l1265" href="#l1265">1265</a><td><tr><td><a name="l1266" href="#l1266">1266</a><td><tr><td><a name="l1267" href="#l1267">1267</a><td>/**<tr><td><a name="l1268" href="#l1268">1268</a><td> * @return {string} The scheduled tasks still pending with this instance.<tr><td><a name="l1269" href="#l1269">1269</a><td> */<tr><td><a name="l1270" href="#l1270">1270</a><td>webdriver.promise.ControlFlow.prototype.getSchedule = function() {<tr><td><a name="l1271" href="#l1271">1271</a><td>  return this.activeFrame_ ? this.activeFrame_.getRoot().toString() : &#39;[]&#39;;<tr><td><a name="l1272" href="#l1272">1272</a><td>};<tr><td><a name="l1273" href="#l1273">1273</a><td><tr><td><a name="l1274" href="#l1274">1274</a><td><tr><td><a name="l1275" href="#l1275">1275</a><td>/**<tr><td><a name="l1276" href="#l1276">1276</a><td> * Schedules a task for execution. If there is nothing currently in the<tr><td><a name="l1277" href="#l1277">1277</a><td> * queue, the task will be executed in the next turn of the event loop.<tr><td><a name="l1278" href="#l1278">1278</a><td> *<tr><td><a name="l1279" href="#l1279">1279</a><td> * @param {!Function} fn The function to call to start the task. If the<tr><td><a name="l1280" href="#l1280">1280</a><td> *     function returns a {@link webdriver.promise.Promise}, this instance<tr><td><a name="l1281" href="#l1281">1281</a><td> *     will wait for it to be resolved before starting the next task.<tr><td><a name="l1282" href="#l1282">1282</a><td> * @param {string=} opt_description A description of the task.<tr><td><a name="l1283" href="#l1283">1283</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with<tr><td><a name="l1284" href="#l1284">1284</a><td> *     the result of the action.<tr><td><a name="l1285" href="#l1285">1285</a><td> */<tr><td><a name="l1286" href="#l1286">1286</a><td>webdriver.promise.ControlFlow.prototype.execute = function(<tr><td><a name="l1287" href="#l1287">1287</a><td>    fn, opt_description) {<tr><td><a name="l1288" href="#l1288">1288</a><td>  this.cancelShutdown_();<tr><td><a name="l1289" href="#l1289">1289</a><td><tr><td><a name="l1290" href="#l1290">1290</a><td>  if (!this.activeFrame_) {<tr><td><a name="l1291" href="#l1291">1291</a><td>    this.activeFrame_ = new webdriver.promise.Frame_(this);<tr><td><a name="l1292" href="#l1292">1292</a><td>  }<tr><td><a name="l1293" href="#l1293">1293</a><td><tr><td><a name="l1294" href="#l1294">1294</a><td>  // Trim an extra frame off the generated stack trace for the call to this<tr><td><a name="l1295" href="#l1295">1295</a><td>  // function.<tr><td><a name="l1296" href="#l1296">1296</a><td>  var snapshot = new webdriver.stacktrace.Snapshot(1);<tr><td><a name="l1297" href="#l1297">1297</a><td>  var task = new webdriver.promise.Task_(<tr><td><a name="l1298" href="#l1298">1298</a><td>      this, fn, opt_description || &#39;&#39;, snapshot);<tr><td><a name="l1299" href="#l1299">1299</a><td>  var scheduleIn = this.schedulingFrame_ || this.activeFrame_;<tr><td><a name="l1300" href="#l1300">1300</a><td>  scheduleIn.addChild(task);<tr><td><a name="l1301" href="#l1301">1301</a><td><tr><td><a name="l1302" href="#l1302">1302</a><td>  this.emit(webdriver.promise.ControlFlow.EventType.SCHEDULE_TASK);<tr><td><a name="l1303" href="#l1303">1303</a><td><tr><td><a name="l1304" href="#l1304">1304</a><td>  this.scheduleEventLoopStart_();<tr><td><a name="l1305" href="#l1305">1305</a><td>  return task.promise;<tr><td><a name="l1306" href="#l1306">1306</a><td>};<tr><td><a name="l1307" href="#l1307">1307</a><td><tr><td><a name="l1308" href="#l1308">1308</a><td><tr><td><a name="l1309" href="#l1309">1309</a><td>/**<tr><td><a name="l1310" href="#l1310">1310</a><td> * Inserts a {@code setTimeout} into the command queue. This is equivalent to<tr><td><a name="l1311" href="#l1311">1311</a><td> * a thread sleep in a synchronous programming language.<tr><td><a name="l1312" href="#l1312">1312</a><td> *<tr><td><a name="l1313" href="#l1313">1313</a><td> * @param {number} ms The timeout delay, in milliseconds.<tr><td><a name="l1314" href="#l1314">1314</a><td> * @param {string=} opt_description A description to accompany the timeout.<tr><td><a name="l1315" href="#l1315">1315</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with<tr><td><a name="l1316" href="#l1316">1316</a><td> *     the result of the action.<tr><td><a name="l1317" href="#l1317">1317</a><td> */<tr><td><a name="l1318" href="#l1318">1318</a><td>webdriver.promise.ControlFlow.prototype.timeout = function(<tr><td><a name="l1319" href="#l1319">1319</a><td>    ms, opt_description) {<tr><td><a name="l1320" href="#l1320">1320</a><td>  return this.execute(function() {<tr><td><a name="l1321" href="#l1321">1321</a><td>    return webdriver.promise.delayed(ms);<tr><td><a name="l1322" href="#l1322">1322</a><td>  }, opt_description);<tr><td><a name="l1323" href="#l1323">1323</a><td>};<tr><td><a name="l1324" href="#l1324">1324</a><td><tr><td><a name="l1325" href="#l1325">1325</a><td><tr><td><a name="l1326" href="#l1326">1326</a><td>/**<tr><td><a name="l1327" href="#l1327">1327</a><td> * Schedules a task that shall wait for a condition to hold. Each condition<tr><td><a name="l1328" href="#l1328">1328</a><td> * function may return any value, but it will always be evaluated as a boolean.<tr><td><a name="l1329" href="#l1329">1329</a><td> *<tr><td><a name="l1330" href="#l1330">1330</a><td> * &lt;p&gt;Condition functions may schedule sub-tasks with this instance, however,<tr><td><a name="l1331" href="#l1331">1331</a><td> * their execution time will be factored into whether a wait has timed out.<tr><td><a name="l1332" href="#l1332">1332</a><td> *<tr><td><a name="l1333" href="#l1333">1333</a><td> * &lt;p&gt;In the event a condition returns a Promise, the polling loop will wait for<tr><td><a name="l1334" href="#l1334">1334</a><td> * it to be resolved before evaluating whether the condition has been satisfied.<tr><td><a name="l1335" href="#l1335">1335</a><td> * The resolution time for a promise is factored into whether a wait has timed<tr><td><a name="l1336" href="#l1336">1336</a><td> * out.<tr><td><a name="l1337" href="#l1337">1337</a><td> *<tr><td><a name="l1338" href="#l1338">1338</a><td> * &lt;p&gt;If the condition function throws, or returns a rejected promise, the<tr><td><a name="l1339" href="#l1339">1339</a><td> * wait task will fail.<tr><td><a name="l1340" href="#l1340">1340</a><td> *<tr><td><a name="l1341" href="#l1341">1341</a><td> * @param {!Function} condition The condition function to poll.<tr><td><a name="l1342" href="#l1342">1342</a><td> * @param {number} timeout How long to wait, in milliseconds, for the condition<tr><td><a name="l1343" href="#l1343">1343</a><td> *     to hold before timing out.<tr><td><a name="l1344" href="#l1344">1344</a><td> * @param {string=} opt_message An optional error message to include if the<tr><td><a name="l1345" href="#l1345">1345</a><td> *     wait times out; defaults to the empty string.<tr><td><a name="l1346" href="#l1346">1346</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1347" href="#l1347">1347</a><td> *     condition has been satisified. The promise shall be rejected if the wait<tr><td><a name="l1348" href="#l1348">1348</a><td> *     times out waiting for the condition.<tr><td><a name="l1349" href="#l1349">1349</a><td> */<tr><td><a name="l1350" href="#l1350">1350</a><td>webdriver.promise.ControlFlow.prototype.wait = function(<tr><td><a name="l1351" href="#l1351">1351</a><td>    condition, timeout, opt_message) {<tr><td><a name="l1352" href="#l1352">1352</a><td>  var sleep = Math.min(timeout, 100);<tr><td><a name="l1353" href="#l1353">1353</a><td>  var self = this;<tr><td><a name="l1354" href="#l1354">1354</a><td><tr><td><a name="l1355" href="#l1355">1355</a><td>  return this.execute(function() {<tr><td><a name="l1356" href="#l1356">1356</a><td>    var startTime = goog.now();<tr><td><a name="l1357" href="#l1357">1357</a><td>    var waitResult = new webdriver.promise.Deferred();<tr><td><a name="l1358" href="#l1358">1358</a><td>    var waitFrame = self.activeFrame_;<tr><td><a name="l1359" href="#l1359">1359</a><td>    waitFrame.isWaiting = true;<tr><td><a name="l1360" href="#l1360">1360</a><td>    pollCondition();<tr><td><a name="l1361" href="#l1361">1361</a><td>    return waitResult.promise;<tr><td><a name="l1362" href="#l1362">1362</a><td><tr><td><a name="l1363" href="#l1363">1363</a><td>    function pollCondition() {<tr><td><a name="l1364" href="#l1364">1364</a><td>      self.runInNewFrame_(condition, function(value) {<tr><td><a name="l1365" href="#l1365">1365</a><td>        var elapsed = goog.now() - startTime;<tr><td><a name="l1366" href="#l1366">1366</a><td>        if (!!value) {<tr><td><a name="l1367" href="#l1367">1367</a><td>          waitFrame.isWaiting = false;<tr><td><a name="l1368" href="#l1368">1368</a><td>          waitResult.fulfill(value);<tr><td><a name="l1369" href="#l1369">1369</a><td>        } else if (elapsed &gt;= timeout) {<tr><td><a name="l1370" href="#l1370">1370</a><td>          waitResult.reject(new Error((opt_message ? opt_message + &#39;\n&#39; : &#39;&#39;) +<tr><td><a name="l1371" href="#l1371">1371</a><td>              &#39;Wait timed out after &#39; + elapsed + &#39;ms&#39;));<tr><td><a name="l1372" href="#l1372">1372</a><td>        } else {<tr><td><a name="l1373" href="#l1373">1373</a><td>          self.timer.setTimeout(pollCondition, sleep);<tr><td><a name="l1374" href="#l1374">1374</a><td>        }<tr><td><a name="l1375" href="#l1375">1375</a><td>      }, waitResult.reject, true);<tr><td><a name="l1376" href="#l1376">1376</a><td>    }<tr><td><a name="l1377" href="#l1377">1377</a><td>  }, opt_message);<tr><td><a name="l1378" href="#l1378">1378</a><td>};<tr><td><a name="l1379" href="#l1379">1379</a><td><tr><td><a name="l1380" href="#l1380">1380</a><td><tr><td><a name="l1381" href="#l1381">1381</a><td>/**<tr><td><a name="l1382" href="#l1382">1382</a><td> * Schedules a task that will wait for another promise to resolve.  The resolved<tr><td><a name="l1383" href="#l1383">1383</a><td> * promise&#39;s value will be returned as the task result.<tr><td><a name="l1384" href="#l1384">1384</a><td> * @param {!webdriver.promise.Promise} promise The promise to wait on.<tr><td><a name="l1385" href="#l1385">1385</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve when the<tr><td><a name="l1386" href="#l1386">1386</a><td> *     task has completed.<tr><td><a name="l1387" href="#l1387">1387</a><td> */<tr><td><a name="l1388" href="#l1388">1388</a><td>webdriver.promise.ControlFlow.prototype.await = function(promise) {<tr><td><a name="l1389" href="#l1389">1389</a><td>  return this.execute(function() {<tr><td><a name="l1390" href="#l1390">1390</a><td>    return promise;<tr><td><a name="l1391" href="#l1391">1391</a><td>  });<tr><td><a name="l1392" href="#l1392">1392</a><td>};<tr><td><a name="l1393" href="#l1393">1393</a><td><tr><td><a name="l1394" href="#l1394">1394</a><td><tr><td><a name="l1395" href="#l1395">1395</a><td>/**<tr><td><a name="l1396" href="#l1396">1396</a><td> * Schedules the interval for this instance&#39;s event loop, if necessary.<tr><td><a name="l1397" href="#l1397">1397</a><td> * @private<tr><td><a name="l1398" href="#l1398">1398</a><td> */<tr><td><a name="l1399" href="#l1399">1399</a><td>webdriver.promise.ControlFlow.prototype.scheduleEventLoopStart_ = function() {<tr><td><a name="l1400" href="#l1400">1400</a><td>  if (!this.eventLoopId_) {<tr><td><a name="l1401" href="#l1401">1401</a><td>    this.eventLoopId_ = this.timer.setInterval(<tr><td><a name="l1402" href="#l1402">1402</a><td>        goog.bind(this.runEventLoop_, this),<tr><td><a name="l1403" href="#l1403">1403</a><td>        webdriver.promise.ControlFlow.EVENT_LOOP_FREQUENCY);<tr><td><a name="l1404" href="#l1404">1404</a><td>  }<tr><td><a name="l1405" href="#l1405">1405</a><td>};<tr><td><a name="l1406" href="#l1406">1406</a><td><tr><td><a name="l1407" href="#l1407">1407</a><td><tr><td><a name="l1408" href="#l1408">1408</a><td>/**<tr><td><a name="l1409" href="#l1409">1409</a><td> * Cancels the event loop, if necessary.<tr><td><a name="l1410" href="#l1410">1410</a><td> * @private<tr><td><a name="l1411" href="#l1411">1411</a><td> */<tr><td><a name="l1412" href="#l1412">1412</a><td>webdriver.promise.ControlFlow.prototype.cancelEventLoop_ = function() {<tr><td><a name="l1413" href="#l1413">1413</a><td>  if (this.eventLoopId_) {<tr><td><a name="l1414" href="#l1414">1414</a><td>    this.timer.clearInterval(this.eventLoopId_);<tr><td><a name="l1415" href="#l1415">1415</a><td>    this.eventLoopId_ = null;<tr><td><a name="l1416" href="#l1416">1416</a><td>  }<tr><td><a name="l1417" href="#l1417">1417</a><td>};<tr><td><a name="l1418" href="#l1418">1418</a><td><tr><td><a name="l1419" href="#l1419">1419</a><td><tr><td><a name="l1420" href="#l1420">1420</a><td>/**<tr><td><a name="l1421" href="#l1421">1421</a><td> * Executes the next task for the current frame. If the current frame has no<tr><td><a name="l1422" href="#l1422">1422</a><td> * more tasks, the frame&#39;s result will be resolved, returning control to the<tr><td><a name="l1423" href="#l1423">1423</a><td> * frame&#39;s creator. This will terminate the flow if the completed frame was at<tr><td><a name="l1424" href="#l1424">1424</a><td> * the top of the stack.<tr><td><a name="l1425" href="#l1425">1425</a><td> * @private<tr><td><a name="l1426" href="#l1426">1426</a><td> */<tr><td><a name="l1427" href="#l1427">1427</a><td>webdriver.promise.ControlFlow.prototype.runEventLoop_ = function() {<tr><td><a name="l1428" href="#l1428">1428</a><td>  // If we get here and there are pending promise rejections, then those<tr><td><a name="l1429" href="#l1429">1429</a><td>  // promises are queued up to run as soon as this (JS) event loop terminates.<tr><td><a name="l1430" href="#l1430">1430</a><td>  // Short-circuit our loop to give those promises a chance to run. Otherwise,<tr><td><a name="l1431" href="#l1431">1431</a><td>  // we might start a new task only to have it fail because of one of these<tr><td><a name="l1432" href="#l1432">1432</a><td>  // pending rejections.<tr><td><a name="l1433" href="#l1433">1433</a><td>  if (this.pendingRejections_) {<tr><td><a name="l1434" href="#l1434">1434</a><td>    return;<tr><td><a name="l1435" href="#l1435">1435</a><td>  }<tr><td><a name="l1436" href="#l1436">1436</a><td><tr><td><a name="l1437" href="#l1437">1437</a><td>  // If the flow aborts due to an unhandled exception after we&#39;ve scheduled<tr><td><a name="l1438" href="#l1438">1438</a><td>  // another turn of the execution loop, we can end up in here with no tasks<tr><td><a name="l1439" href="#l1439">1439</a><td>  // left. This is OK, just quietly return.<tr><td><a name="l1440" href="#l1440">1440</a><td>  if (!this.activeFrame_) {<tr><td><a name="l1441" href="#l1441">1441</a><td>    this.commenceShutdown_();<tr><td><a name="l1442" href="#l1442">1442</a><td>    return;<tr><td><a name="l1443" href="#l1443">1443</a><td>  }<tr><td><a name="l1444" href="#l1444">1444</a><td><tr><td><a name="l1445" href="#l1445">1445</a><td>  var task;<tr><td><a name="l1446" href="#l1446">1446</a><td>  if (this.activeFrame_.getPendingTask() || !(task = this.getNextTask_())) {<tr><td><a name="l1447" href="#l1447">1447</a><td>    // Either the current frame is blocked on a pending task, or we don&#39;t have<tr><td><a name="l1448" href="#l1448">1448</a><td>    // a task to finish because we&#39;ve completed a frame. When completing a<tr><td><a name="l1449" href="#l1449">1449</a><td>    // frame, we must abort the event loop to allow the frame&#39;s promise&#39;s<tr><td><a name="l1450" href="#l1450">1450</a><td>    // callbacks to execute.<tr><td><a name="l1451" href="#l1451">1451</a><td>    return;<tr><td><a name="l1452" href="#l1452">1452</a><td>  }<tr><td><a name="l1453" href="#l1453">1453</a><td><tr><td><a name="l1454" href="#l1454">1454</a><td>  var activeFrame = this.activeFrame_;<tr><td><a name="l1455" href="#l1455">1455</a><td>  activeFrame.setPendingTask(task);<tr><td><a name="l1456" href="#l1456">1456</a><td>  var markTaskComplete = goog.bind(function() {<tr><td><a name="l1457" href="#l1457">1457</a><td>    this.history_.push(/** @type {!webdriver.promise.Task_} */ (task));<tr><td><a name="l1458" href="#l1458">1458</a><td>    activeFrame.setPendingTask(null);<tr><td><a name="l1459" href="#l1459">1459</a><td>  }, this);<tr><td><a name="l1460" href="#l1460">1460</a><td><tr><td><a name="l1461" href="#l1461">1461</a><td>  this.trimHistory_();<tr><td><a name="l1462" href="#l1462">1462</a><td>  var self = this;<tr><td><a name="l1463" href="#l1463">1463</a><td>  this.runInNewFrame_(task.execute, function(result) {<tr><td><a name="l1464" href="#l1464">1464</a><td>    markTaskComplete();<tr><td><a name="l1465" href="#l1465">1465</a><td>    task.fulfill(result);<tr><td><a name="l1466" href="#l1466">1466</a><td>  }, function(error) {<tr><td><a name="l1467" href="#l1467">1467</a><td>    markTaskComplete();<tr><td><a name="l1468" href="#l1468">1468</a><td><tr><td><a name="l1469" href="#l1469">1469</a><td>    if (!webdriver.promise.isError_(error) &amp;&amp;<tr><td><a name="l1470" href="#l1470">1470</a><td>        !webdriver.promise.isPromise(error)) {<tr><td><a name="l1471" href="#l1471">1471</a><td>      error = Error(error);<tr><td><a name="l1472" href="#l1472">1472</a><td>    }<tr><td><a name="l1473" href="#l1473">1473</a><td><tr><td><a name="l1474" href="#l1474">1474</a><td>    task.reject(self.annotateError(/** @type {!Error} */ (error)));<tr><td><a name="l1475" href="#l1475">1475</a><td>  }, true);<tr><td><a name="l1476" href="#l1476">1476</a><td>};<tr><td><a name="l1477" href="#l1477">1477</a><td><tr><td><a name="l1478" href="#l1478">1478</a><td><tr><td><a name="l1479" href="#l1479">1479</a><td>/**<tr><td><a name="l1480" href="#l1480">1480</a><td> * @return {webdriver.promise.Task_} The next task to execute, or<tr><td><a name="l1481" href="#l1481">1481</a><td> *     {@code null} if a frame was resolved.<tr><td><a name="l1482" href="#l1482">1482</a><td> * @private<tr><td><a name="l1483" href="#l1483">1483</a><td> */<tr><td><a name="l1484" href="#l1484">1484</a><td>webdriver.promise.ControlFlow.prototype.getNextTask_ = function() {<tr><td><a name="l1485" href="#l1485">1485</a><td>  var firstChild = this.activeFrame_.getFirstChild();<tr><td><a name="l1486" href="#l1486">1486</a><td>  if (!firstChild) {<tr><td><a name="l1487" href="#l1487">1487</a><td>    if (!this.activeFrame_.isWaiting) {<tr><td><a name="l1488" href="#l1488">1488</a><td>      this.resolveFrame_(this.activeFrame_);<tr><td><a name="l1489" href="#l1489">1489</a><td>    }<tr><td><a name="l1490" href="#l1490">1490</a><td>    return null;<tr><td><a name="l1491" href="#l1491">1491</a><td>  }<tr><td><a name="l1492" href="#l1492">1492</a><td><tr><td><a name="l1493" href="#l1493">1493</a><td>  if (firstChild instanceof webdriver.promise.Frame_) {<tr><td><a name="l1494" href="#l1494">1494</a><td>    this.activeFrame_ = firstChild;<tr><td><a name="l1495" href="#l1495">1495</a><td>    return this.getNextTask_();<tr><td><a name="l1496" href="#l1496">1496</a><td>  }<tr><td><a name="l1497" href="#l1497">1497</a><td><tr><td><a name="l1498" href="#l1498">1498</a><td>  firstChild.getParent().removeChild(firstChild);<tr><td><a name="l1499" href="#l1499">1499</a><td>  return firstChild;<tr><td><a name="l1500" href="#l1500">1500</a><td>};<tr><td><a name="l1501" href="#l1501">1501</a><td><tr><td><a name="l1502" href="#l1502">1502</a><td><tr><td><a name="l1503" href="#l1503">1503</a><td>/**<tr><td><a name="l1504" href="#l1504">1504</a><td> * @param {!webdriver.promise.Frame_} frame The frame to resolve.<tr><td><a name="l1505" href="#l1505">1505</a><td> * @private<tr><td><a name="l1506" href="#l1506">1506</a><td> */<tr><td><a name="l1507" href="#l1507">1507</a><td>webdriver.promise.ControlFlow.prototype.resolveFrame_ = function(frame) {<tr><td><a name="l1508" href="#l1508">1508</a><td>  if (this.activeFrame_ === frame) {<tr><td><a name="l1509" href="#l1509">1509</a><td>    // Frame parent is always another frame, but the compiler is not smart<tr><td><a name="l1510" href="#l1510">1510</a><td>    // enough to recognize this.<tr><td><a name="l1511" href="#l1511">1511</a><td>    this.activeFrame_ =<tr><td><a name="l1512" href="#l1512">1512</a><td>        /** @type {webdriver.promise.Frame_} */ (frame.getParent());<tr><td><a name="l1513" href="#l1513">1513</a><td>  }<tr><td><a name="l1514" href="#l1514">1514</a><td><tr><td><a name="l1515" href="#l1515">1515</a><td>  if (frame.getParent()) {<tr><td><a name="l1516" href="#l1516">1516</a><td>    frame.getParent().removeChild(frame);<tr><td><a name="l1517" href="#l1517">1517</a><td>  }<tr><td><a name="l1518" href="#l1518">1518</a><td>  this.trimHistory_();<tr><td><a name="l1519" href="#l1519">1519</a><td>  frame.fulfill();<tr><td><a name="l1520" href="#l1520">1520</a><td><tr><td><a name="l1521" href="#l1521">1521</a><td>  if (!this.activeFrame_) {<tr><td><a name="l1522" href="#l1522">1522</a><td>    this.commenceShutdown_();<tr><td><a name="l1523" href="#l1523">1523</a><td>  }<tr><td><a name="l1524" href="#l1524">1524</a><td>};<tr><td><a name="l1525" href="#l1525">1525</a><td><tr><td><a name="l1526" href="#l1526">1526</a><td><tr><td><a name="l1527" href="#l1527">1527</a><td>/**<tr><td><a name="l1528" href="#l1528">1528</a><td> * Aborts the current frame. The frame, and all of the tasks scheduled within it<tr><td><a name="l1529" href="#l1529">1529</a><td> * will be discarded. If this instance does not have an active frame, it will<tr><td><a name="l1530" href="#l1530">1530</a><td> * immediately terminate all execution.<tr><td><a name="l1531" href="#l1531">1531</a><td> * @param {*} error The reason the frame is being aborted; typically either<tr><td><a name="l1532" href="#l1532">1532</a><td> *     an Error or string.<tr><td><a name="l1533" href="#l1533">1533</a><td> * @private<tr><td><a name="l1534" href="#l1534">1534</a><td> */<tr><td><a name="l1535" href="#l1535">1535</a><td>webdriver.promise.ControlFlow.prototype.abortFrame_ = function(error) {<tr><td><a name="l1536" href="#l1536">1536</a><td>  // Annotate the error value if it is Error-like.<tr><td><a name="l1537" href="#l1537">1537</a><td>  if (webdriver.promise.isError_(error)) {<tr><td><a name="l1538" href="#l1538">1538</a><td>    this.annotateError(/** @type {!Error} */ (error));<tr><td><a name="l1539" href="#l1539">1539</a><td>  }<tr><td><a name="l1540" href="#l1540">1540</a><td>  this.numAbortedFrames_++;<tr><td><a name="l1541" href="#l1541">1541</a><td><tr><td><a name="l1542" href="#l1542">1542</a><td>  if (!this.activeFrame_) {<tr><td><a name="l1543" href="#l1543">1543</a><td>    this.abortNow_(error);<tr><td><a name="l1544" href="#l1544">1544</a><td>    return;<tr><td><a name="l1545" href="#l1545">1545</a><td>  }<tr><td><a name="l1546" href="#l1546">1546</a><td><tr><td><a name="l1547" href="#l1547">1547</a><td>  // Frame parent is always another frame, but the compiler is not smart<tr><td><a name="l1548" href="#l1548">1548</a><td>  // enough to recognize this.<tr><td><a name="l1549" href="#l1549">1549</a><td>  var parent = /** @type {webdriver.promise.Frame_} */ (<tr><td><a name="l1550" href="#l1550">1550</a><td>      this.activeFrame_.getParent());<tr><td><a name="l1551" href="#l1551">1551</a><td>  if (parent) {<tr><td><a name="l1552" href="#l1552">1552</a><td>    parent.removeChild(this.activeFrame_);<tr><td><a name="l1553" href="#l1553">1553</a><td>  }<tr><td><a name="l1554" href="#l1554">1554</a><td><tr><td><a name="l1555" href="#l1555">1555</a><td>  var frame = this.activeFrame_;<tr><td><a name="l1556" href="#l1556">1556</a><td>  this.activeFrame_ = parent;<tr><td><a name="l1557" href="#l1557">1557</a><td>  frame.reject(error);<tr><td><a name="l1558" href="#l1558">1558</a><td>};<tr><td><a name="l1559" href="#l1559">1559</a><td><tr><td><a name="l1560" href="#l1560">1560</a><td><tr><td><a name="l1561" href="#l1561">1561</a><td>/**<tr><td><a name="l1562" href="#l1562">1562</a><td> * Executes a function in a new frame. If the function does not schedule any new<tr><td><a name="l1563" href="#l1563">1563</a><td> * tasks, the frame will be discarded and the function&#39;s result returned<tr><td><a name="l1564" href="#l1564">1564</a><td> * immediately. Otherwise, a promise will be returned. This promise will be<tr><td><a name="l1565" href="#l1565">1565</a><td> * resolved with the function&#39;s result once all of the tasks scheduled within<tr><td><a name="l1566" href="#l1566">1566</a><td> * the function have been completed. If the function&#39;s frame is aborted, the<tr><td><a name="l1567" href="#l1567">1567</a><td> * returned promise will be rejected.<tr><td><a name="l1568" href="#l1568">1568</a><td> *<tr><td><a name="l1569" href="#l1569">1569</a><td> * @param {!Function} fn The function to execute.<tr><td><a name="l1570" href="#l1570">1570</a><td> * @param {function(*)} callback The function to call with a successful result.<tr><td><a name="l1571" href="#l1571">1571</a><td> * @param {function(*)} errback The function to call if there is an error.<tr><td><a name="l1572" href="#l1572">1572</a><td> * @param {boolean=} opt_activate Whether the active frame should be updated to<tr><td><a name="l1573" href="#l1573">1573</a><td> *     the newly created frame so tasks are treated as sub-tasks.<tr><td><a name="l1574" href="#l1574">1574</a><td> * @private<tr><td><a name="l1575" href="#l1575">1575</a><td> */<tr><td><a name="l1576" href="#l1576">1576</a><td>webdriver.promise.ControlFlow.prototype.runInNewFrame_ = function(<tr><td><a name="l1577" href="#l1577">1577</a><td>    fn, callback, errback, opt_activate) {<tr><td><a name="l1578" href="#l1578">1578</a><td>  var newFrame = new webdriver.promise.Frame_(this),<tr><td><a name="l1579" href="#l1579">1579</a><td>      self = this,<tr><td><a name="l1580" href="#l1580">1580</a><td>      oldFrame = this.activeFrame_;<tr><td><a name="l1581" href="#l1581">1581</a><td><tr><td><a name="l1582" href="#l1582">1582</a><td>  try {<tr><td><a name="l1583" href="#l1583">1583</a><td>    if (!this.activeFrame_) {<tr><td><a name="l1584" href="#l1584">1584</a><td>      this.activeFrame_ = newFrame;<tr><td><a name="l1585" href="#l1585">1585</a><td>    } else {<tr><td><a name="l1586" href="#l1586">1586</a><td>      this.activeFrame_.addChild(newFrame);<tr><td><a name="l1587" href="#l1587">1587</a><td>    }<tr><td><a name="l1588" href="#l1588">1588</a><td><tr><td><a name="l1589" href="#l1589">1589</a><td>    // Activate the new frame to force tasks to be treated as sub-tasks of<tr><td><a name="l1590" href="#l1590">1590</a><td>    // the parent frame.<tr><td><a name="l1591" href="#l1591">1591</a><td>    if (opt_activate) {<tr><td><a name="l1592" href="#l1592">1592</a><td>      this.activeFrame_ = newFrame;<tr><td><a name="l1593" href="#l1593">1593</a><td>    }<tr><td><a name="l1594" href="#l1594">1594</a><td><tr><td><a name="l1595" href="#l1595">1595</a><td>    try {<tr><td><a name="l1596" href="#l1596">1596</a><td>      this.schedulingFrame_ = newFrame;<tr><td><a name="l1597" href="#l1597">1597</a><td>      webdriver.promise.pushFlow_(this);<tr><td><a name="l1598" href="#l1598">1598</a><td>      var result = fn();<tr><td><a name="l1599" href="#l1599">1599</a><td>    } finally {<tr><td><a name="l1600" href="#l1600">1600</a><td>      webdriver.promise.popFlow_();<tr><td><a name="l1601" href="#l1601">1601</a><td>      this.schedulingFrame_ = null;<tr><td><a name="l1602" href="#l1602">1602</a><td>    }<tr><td><a name="l1603" href="#l1603">1603</a><td>    newFrame.lockFrame();<tr><td><a name="l1604" href="#l1604">1604</a><td><tr><td><a name="l1605" href="#l1605">1605</a><td>    // If there was nothing scheduled in the new frame we can discard the<tr><td><a name="l1606" href="#l1606">1606</a><td>    // frame and return immediately.<tr><td><a name="l1607" href="#l1607">1607</a><td>    if (!newFrame.children_.length) {<tr><td><a name="l1608" href="#l1608">1608</a><td>      removeNewFrame();<tr><td><a name="l1609" href="#l1609">1609</a><td>      webdriver.promise.asap(result, callback, errback);<tr><td><a name="l1610" href="#l1610">1610</a><td>      return;<tr><td><a name="l1611" href="#l1611">1611</a><td>    }<tr><td><a name="l1612" href="#l1612">1612</a><td><tr><td><a name="l1613" href="#l1613">1613</a><td>    newFrame.then(function() {<tr><td><a name="l1614" href="#l1614">1614</a><td>      webdriver.promise.asap(result, callback, errback);<tr><td><a name="l1615" href="#l1615">1615</a><td>    }, function(e) {<tr><td><a name="l1616" href="#l1616">1616</a><td>      if (result instanceof webdriver.promise.Promise &amp;&amp; result.isPending()) {<tr><td><a name="l1617" href="#l1617">1617</a><td>        result.cancel(e);<tr><td><a name="l1618" href="#l1618">1618</a><td>        e = result;<tr><td><a name="l1619" href="#l1619">1619</a><td>      }<tr><td><a name="l1620" href="#l1620">1620</a><td>      errback(e);<tr><td><a name="l1621" href="#l1621">1621</a><td>    });<tr><td><a name="l1622" href="#l1622">1622</a><td>  } catch (ex) {<tr><td><a name="l1623" href="#l1623">1623</a><td>    removeNewFrame(new webdriver.promise.CanceledTaskError_(ex));<tr><td><a name="l1624" href="#l1624">1624</a><td>    errback(ex);<tr><td><a name="l1625" href="#l1625">1625</a><td>  }<tr><td><a name="l1626" href="#l1626">1626</a><td><tr><td><a name="l1627" href="#l1627">1627</a><td>  /**<tr><td><a name="l1628" href="#l1628">1628</a><td>   * @param {webdriver.promise.CanceledTaskError_=} opt_err If provided, the<tr><td><a name="l1629" href="#l1629">1629</a><td>   *     error that triggered the removal of this frame.<tr><td><a name="l1630" href="#l1630">1630</a><td>   */<tr><td><a name="l1631" href="#l1631">1631</a><td>  function removeNewFrame(opt_err) {<tr><td><a name="l1632" href="#l1632">1632</a><td>    var parent = newFrame.getParent();<tr><td><a name="l1633" href="#l1633">1633</a><td>    if (parent) {<tr><td><a name="l1634" href="#l1634">1634</a><td>      parent.removeChild(newFrame);<tr><td><a name="l1635" href="#l1635">1635</a><td>    }<tr><td><a name="l1636" href="#l1636">1636</a><td><tr><td><a name="l1637" href="#l1637">1637</a><td>    if (opt_err) {<tr><td><a name="l1638" href="#l1638">1638</a><td>      newFrame.cancelRemainingTasks(opt_err);<tr><td><a name="l1639" href="#l1639">1639</a><td>    }<tr><td><a name="l1640" href="#l1640">1640</a><td>    self.activeFrame_ = oldFrame;<tr><td><a name="l1641" href="#l1641">1641</a><td>  }<tr><td><a name="l1642" href="#l1642">1642</a><td>};<tr><td><a name="l1643" href="#l1643">1643</a><td><tr><td><a name="l1644" href="#l1644">1644</a><td><tr><td><a name="l1645" href="#l1645">1645</a><td>/**<tr><td><a name="l1646" href="#l1646">1646</a><td> * Commences the shutdown sequence for this instance. After one turn of the<tr><td><a name="l1647" href="#l1647">1647</a><td> * event loop, this object will emit the<tr><td><a name="l1648" href="#l1648">1648</a><td> * {@link webdriver.promise.ControlFlow.EventType.IDLE} event to signal<tr><td><a name="l1649" href="#l1649">1649</a><td> * listeners that it has completed. During this wait, if another task is<tr><td><a name="l1650" href="#l1650">1650</a><td> * scheduled, the shutdown will be aborted.<tr><td><a name="l1651" href="#l1651">1651</a><td> * @private<tr><td><a name="l1652" href="#l1652">1652</a><td> */<tr><td><a name="l1653" href="#l1653">1653</a><td>webdriver.promise.ControlFlow.prototype.commenceShutdown_ = function() {<tr><td><a name="l1654" href="#l1654">1654</a><td>  if (!this.shutdownId_) {<tr><td><a name="l1655" href="#l1655">1655</a><td>    // Go ahead and stop the event loop now.  If we&#39;re in here, then there are<tr><td><a name="l1656" href="#l1656">1656</a><td>    // no more frames with tasks to execute. If we waited to cancel the event<tr><td><a name="l1657" href="#l1657">1657</a><td>    // loop in our timeout below, the event loop could trigger *before* the<tr><td><a name="l1658" href="#l1658">1658</a><td>    // timeout, generating an error from there being no frames.<tr><td><a name="l1659" href="#l1659">1659</a><td>    // If #execute is called before the timeout below fires, it will cancel<tr><td><a name="l1660" href="#l1660">1660</a><td>    // the timeout and restart the event loop.<tr><td><a name="l1661" href="#l1661">1661</a><td>    this.cancelEventLoop_();<tr><td><a name="l1662" href="#l1662">1662</a><td><tr><td><a name="l1663" href="#l1663">1663</a><td>    var self = this;<tr><td><a name="l1664" href="#l1664">1664</a><td>    self.shutdownId_ = self.timer.setTimeout(function() {<tr><td><a name="l1665" href="#l1665">1665</a><td>      self.shutdownId_ = null;<tr><td><a name="l1666" href="#l1666">1666</a><td>      self.emit(webdriver.promise.ControlFlow.EventType.IDLE);<tr><td><a name="l1667" href="#l1667">1667</a><td>    }, 0);<tr><td><a name="l1668" href="#l1668">1668</a><td>  }<tr><td><a name="l1669" href="#l1669">1669</a><td>};<tr><td><a name="l1670" href="#l1670">1670</a><td><tr><td><a name="l1671" href="#l1671">1671</a><td><tr><td><a name="l1672" href="#l1672">1672</a><td>/**<tr><td><a name="l1673" href="#l1673">1673</a><td> * Cancels the shutdown sequence if it is currently scheduled.<tr><td><a name="l1674" href="#l1674">1674</a><td> * @private<tr><td><a name="l1675" href="#l1675">1675</a><td> */<tr><td><a name="l1676" href="#l1676">1676</a><td>webdriver.promise.ControlFlow.prototype.cancelShutdown_ = function() {<tr><td><a name="l1677" href="#l1677">1677</a><td>  if (this.shutdownId_) {<tr><td><a name="l1678" href="#l1678">1678</a><td>    this.timer.clearTimeout(this.shutdownId_);<tr><td><a name="l1679" href="#l1679">1679</a><td>    this.shutdownId_ = null;<tr><td><a name="l1680" href="#l1680">1680</a><td>  }<tr><td><a name="l1681" href="#l1681">1681</a><td>};<tr><td><a name="l1682" href="#l1682">1682</a><td><tr><td><a name="l1683" href="#l1683">1683</a><td><tr><td><a name="l1684" href="#l1684">1684</a><td>/**<tr><td><a name="l1685" href="#l1685">1685</a><td> * Aborts this flow, abandoning all remaining tasks. If there are<tr><td><a name="l1686" href="#l1686">1686</a><td> * listeners registered, an {@code UNCAUGHT_EXCEPTION} will be emitted with the<tr><td><a name="l1687" href="#l1687">1687</a><td> * offending {@code error}, otherwise, the {@code error} will be rethrown to the<tr><td><a name="l1688" href="#l1688">1688</a><td> * global error handler.<tr><td><a name="l1689" href="#l1689">1689</a><td> * @param {*} error Object describing the error that caused the flow to<tr><td><a name="l1690" href="#l1690">1690</a><td> *     abort; usually either an Error or string value.<tr><td><a name="l1691" href="#l1691">1691</a><td> * @private<tr><td><a name="l1692" href="#l1692">1692</a><td> */<tr><td><a name="l1693" href="#l1693">1693</a><td>webdriver.promise.ControlFlow.prototype.abortNow_ = function(error) {<tr><td><a name="l1694" href="#l1694">1694</a><td>  this.activeFrame_ = null;<tr><td><a name="l1695" href="#l1695">1695</a><td>  this.cancelShutdown_();<tr><td><a name="l1696" href="#l1696">1696</a><td>  this.cancelEventLoop_();<tr><td><a name="l1697" href="#l1697">1697</a><td><tr><td><a name="l1698" href="#l1698">1698</a><td>  var listeners = this.listeners(<tr><td><a name="l1699" href="#l1699">1699</a><td>      webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);<tr><td><a name="l1700" href="#l1700">1700</a><td>  if (!listeners.length) {<tr><td><a name="l1701" href="#l1701">1701</a><td>    this.timer.setTimeout(function() {<tr><td><a name="l1702" href="#l1702">1702</a><td>      throw error;<tr><td><a name="l1703" href="#l1703">1703</a><td>    }, 0);<tr><td><a name="l1704" href="#l1704">1704</a><td>  } else {<tr><td><a name="l1705" href="#l1705">1705</a><td>    this.emit(webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,<tr><td><a name="l1706" href="#l1706">1706</a><td>        error);<tr><td><a name="l1707" href="#l1707">1707</a><td>  }<tr><td><a name="l1708" href="#l1708">1708</a><td>};<tr><td><a name="l1709" href="#l1709">1709</a><td><tr><td><a name="l1710" href="#l1710">1710</a><td><tr><td><a name="l1711" href="#l1711">1711</a><td><tr><td><a name="l1712" href="#l1712">1712</a><td>/**<tr><td><a name="l1713" href="#l1713">1713</a><td> * A single node in an {@link webdriver.promise.ControlFlow}&#39;s task tree.<tr><td><a name="l1714" href="#l1714">1714</a><td> * @param {!webdriver.promise.ControlFlow} flow The flow this instance belongs<tr><td><a name="l1715" href="#l1715">1715</a><td> *     to.<tr><td><a name="l1716" href="#l1716">1716</a><td> * @constructor<tr><td><a name="l1717" href="#l1717">1717</a><td> * @extends {webdriver.promise.Deferred}<tr><td><a name="l1718" href="#l1718">1718</a><td> * @private<tr><td><a name="l1719" href="#l1719">1719</a><td> */<tr><td><a name="l1720" href="#l1720">1720</a><td>webdriver.promise.Node_ = function(flow) {<tr><td><a name="l1721" href="#l1721">1721</a><td>  webdriver.promise.Deferred.call(this, null, flow);<tr><td><a name="l1722" href="#l1722">1722</a><td>};<tr><td><a name="l1723" href="#l1723">1723</a><td>goog.inherits(webdriver.promise.Node_, webdriver.promise.Deferred);<tr><td><a name="l1724" href="#l1724">1724</a><td><tr><td><a name="l1725" href="#l1725">1725</a><td><tr><td><a name="l1726" href="#l1726">1726</a><td>/**<tr><td><a name="l1727" href="#l1727">1727</a><td> * This node&#39;s parent.<tr><td><a name="l1728" href="#l1728">1728</a><td> * @private {webdriver.promise.Node_}<tr><td><a name="l1729" href="#l1729">1729</a><td> */<tr><td><a name="l1730" href="#l1730">1730</a><td>webdriver.promise.Node_.prototype.parent_ = null;<tr><td><a name="l1731" href="#l1731">1731</a><td><tr><td><a name="l1732" href="#l1732">1732</a><td><tr><td><a name="l1733" href="#l1733">1733</a><td>/** @return {webdriver.promise.Node_} This node&#39;s parent. */<tr><td><a name="l1734" href="#l1734">1734</a><td>webdriver.promise.Node_.prototype.getParent = function() {<tr><td><a name="l1735" href="#l1735">1735</a><td>  return this.parent_;<tr><td><a name="l1736" href="#l1736">1736</a><td>};<tr><td><a name="l1737" href="#l1737">1737</a><td><tr><td><a name="l1738" href="#l1738">1738</a><td><tr><td><a name="l1739" href="#l1739">1739</a><td>/**<tr><td><a name="l1740" href="#l1740">1740</a><td> * @param {webdriver.promise.Node_} parent This node&#39;s new parent.<tr><td><a name="l1741" href="#l1741">1741</a><td> */<tr><td><a name="l1742" href="#l1742">1742</a><td>webdriver.promise.Node_.prototype.setParent = function(parent) {<tr><td><a name="l1743" href="#l1743">1743</a><td>  this.parent_ = parent;<tr><td><a name="l1744" href="#l1744">1744</a><td>};<tr><td><a name="l1745" href="#l1745">1745</a><td><tr><td><a name="l1746" href="#l1746">1746</a><td><tr><td><a name="l1747" href="#l1747">1747</a><td>/**<tr><td><a name="l1748" href="#l1748">1748</a><td> * @return {!webdriver.promise.Node_} The root of this node&#39;s tree.<tr><td><a name="l1749" href="#l1749">1749</a><td> */<tr><td><a name="l1750" href="#l1750">1750</a><td>webdriver.promise.Node_.prototype.getRoot = function() {<tr><td><a name="l1751" href="#l1751">1751</a><td>  var root = this;<tr><td><a name="l1752" href="#l1752">1752</a><td>  while (root.parent_) {<tr><td><a name="l1753" href="#l1753">1753</a><td>    root = root.parent_;<tr><td><a name="l1754" href="#l1754">1754</a><td>  }<tr><td><a name="l1755" href="#l1755">1755</a><td>  return root;<tr><td><a name="l1756" href="#l1756">1756</a><td>};<tr><td><a name="l1757" href="#l1757">1757</a><td><tr><td><a name="l1758" href="#l1758">1758</a><td><tr><td><a name="l1759" href="#l1759">1759</a><td><tr><td><a name="l1760" href="#l1760">1760</a><td>/**<tr><td><a name="l1761" href="#l1761">1761</a><td> * An execution frame within a {@link webdriver.promise.ControlFlow}.  Each<tr><td><a name="l1762" href="#l1762">1762</a><td> * frame represents the execution context for either a<tr><td><a name="l1763" href="#l1763">1763</a><td> * {@link webdriver.promise.Task_} or a callback on a<tr><td><a name="l1764" href="#l1764">1764</a><td> * {@link webdriver.promise.Deferred}.<tr><td><a name="l1765" href="#l1765">1765</a><td> *<tr><td><a name="l1766" href="#l1766">1766</a><td> * &lt;p&gt;Each frame may contain sub-frames.  If child N is a sub-frame, then the<tr><td><a name="l1767" href="#l1767">1767</a><td> * items queued within it are given priority over child N+1.<tr><td><a name="l1768" href="#l1768">1768</a><td> *<tr><td><a name="l1769" href="#l1769">1769</a><td> * @param {!webdriver.promise.ControlFlow} flow The flow this instance belongs<tr><td><a name="l1770" href="#l1770">1770</a><td> *     to.<tr><td><a name="l1771" href="#l1771">1771</a><td> * @constructor<tr><td><a name="l1772" href="#l1772">1772</a><td> * @extends {webdriver.promise.Node_}<tr><td><a name="l1773" href="#l1773">1773</a><td> * @private<tr><td><a name="l1774" href="#l1774">1774</a><td> */<tr><td><a name="l1775" href="#l1775">1775</a><td>webdriver.promise.Frame_ = function(flow) {<tr><td><a name="l1776" href="#l1776">1776</a><td>  webdriver.promise.Node_.call(this, flow);<tr><td><a name="l1777" href="#l1777">1777</a><td><tr><td><a name="l1778" href="#l1778">1778</a><td>  var reject = goog.bind(this.reject, this);<tr><td><a name="l1779" href="#l1779">1779</a><td>  var cancelRemainingTasks = goog.bind(this.cancelRemainingTasks, this);<tr><td><a name="l1780" href="#l1780">1780</a><td><tr><td><a name="l1781" href="#l1781">1781</a><td>  /** @override */<tr><td><a name="l1782" href="#l1782">1782</a><td>  this.reject = function(e) {<tr><td><a name="l1783" href="#l1783">1783</a><td>    cancelRemainingTasks(new webdriver.promise.CanceledTaskError_(e));<tr><td><a name="l1784" href="#l1784">1784</a><td>    reject(e);<tr><td><a name="l1785" href="#l1785">1785</a><td>  };<tr><td><a name="l1786" href="#l1786">1786</a><td><tr><td><a name="l1787" href="#l1787">1787</a><td>  /**<tr><td><a name="l1788" href="#l1788">1788</a><td>   * @private {!Array.&lt;!(webdriver.promise.Frame_|webdriver.promise.Task_)&gt;}<tr><td><a name="l1789" href="#l1789">1789</a><td>   */<tr><td><a name="l1790" href="#l1790">1790</a><td>  this.children_ = [];<tr><td><a name="l1791" href="#l1791">1791</a><td>};<tr><td><a name="l1792" href="#l1792">1792</a><td>goog.inherits(webdriver.promise.Frame_, webdriver.promise.Node_);<tr><td><a name="l1793" href="#l1793">1793</a><td><tr><td><a name="l1794" href="#l1794">1794</a><td><tr><td><a name="l1795" href="#l1795">1795</a><td>/**<tr><td><a name="l1796" href="#l1796">1796</a><td> * The task currently being executed within this frame.<tr><td><a name="l1797" href="#l1797">1797</a><td> * @private {webdriver.promise.Task_}<tr><td><a name="l1798" href="#l1798">1798</a><td> */<tr><td><a name="l1799" href="#l1799">1799</a><td>webdriver.promise.Frame_.prototype.pendingTask_ = null;<tr><td><a name="l1800" href="#l1800">1800</a><td><tr><td><a name="l1801" href="#l1801">1801</a><td><tr><td><a name="l1802" href="#l1802">1802</a><td>/**<tr><td><a name="l1803" href="#l1803">1803</a><td> * Whether this frame is active. A frame is considered active once one of its<tr><td><a name="l1804" href="#l1804">1804</a><td> * descendants has been removed for execution.<tr><td><a name="l1805" href="#l1805">1805</a><td> *<tr><td><a name="l1806" href="#l1806">1806</a><td> * Adding a sub-frame as a child to an active frame is an indication that<tr><td><a name="l1807" href="#l1807">1807</a><td> * a callback to a {@link webdriver.promise.Deferred} is being invoked and any<tr><td><a name="l1808" href="#l1808">1808</a><td> * tasks scheduled within it should have priority over previously scheduled<tr><td><a name="l1809" href="#l1809">1809</a><td> * tasks:<tr><td><a name="l1810" href="#l1810">1810</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l1811" href="#l1811">1811</a><td> *   var flow = webdriver.promise.controlFlow();<tr><td><a name="l1812" href="#l1812">1812</a><td> *   flow.execute(&#39;start here&#39;, goog.nullFunction).then(function() {<tr><td><a name="l1813" href="#l1813">1813</a><td> *     flow.execute(&#39;this should execute 2nd&#39;, goog.nullFunction);<tr><td><a name="l1814" href="#l1814">1814</a><td> *   });<tr><td><a name="l1815" href="#l1815">1815</a><td> *   flow.execute(&#39;this should execute last&#39;, goog.nullFunction);<tr><td><a name="l1816" href="#l1816">1816</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l1817" href="#l1817">1817</a><td> *<tr><td><a name="l1818" href="#l1818">1818</a><td> * @private {boolean}<tr><td><a name="l1819" href="#l1819">1819</a><td> */<tr><td><a name="l1820" href="#l1820">1820</a><td>webdriver.promise.Frame_.prototype.isActive_ = false;<tr><td><a name="l1821" href="#l1821">1821</a><td><tr><td><a name="l1822" href="#l1822">1822</a><td><tr><td><a name="l1823" href="#l1823">1823</a><td>/**<tr><td><a name="l1824" href="#l1824">1824</a><td> * Whether this frame is currently locked. A locked frame represents a callback<tr><td><a name="l1825" href="#l1825">1825</a><td> * or task function which has run to completion and scheduled all of its tasks.<tr><td><a name="l1826" href="#l1826">1826</a><td> *<tr><td><a name="l1827" href="#l1827">1827</a><td> * &lt;p&gt;Once a frame becomes {@link #isActive_ active}, any new frames which are<tr><td><a name="l1828" href="#l1828">1828</a><td> * added represent callbacks on a {@link webdriver.promise.Deferred}, whose<tr><td><a name="l1829" href="#l1829">1829</a><td> * tasks must be given priority over previously scheduled tasks.<tr><td><a name="l1830" href="#l1830">1830</a><td> *<tr><td><a name="l1831" href="#l1831">1831</a><td> * @private {boolean}<tr><td><a name="l1832" href="#l1832">1832</a><td> */<tr><td><a name="l1833" href="#l1833">1833</a><td>webdriver.promise.Frame_.prototype.isLocked_ = false;<tr><td><a name="l1834" href="#l1834">1834</a><td><tr><td><a name="l1835" href="#l1835">1835</a><td><tr><td><a name="l1836" href="#l1836">1836</a><td>/**<tr><td><a name="l1837" href="#l1837">1837</a><td> * A reference to the last node inserted in this frame.<tr><td><a name="l1838" href="#l1838">1838</a><td> * @private {webdriver.promise.Node_}<tr><td><a name="l1839" href="#l1839">1839</a><td> */<tr><td><a name="l1840" href="#l1840">1840</a><td>webdriver.promise.Frame_.prototype.lastInsertedChild_ = null;<tr><td><a name="l1841" href="#l1841">1841</a><td><tr><td><a name="l1842" href="#l1842">1842</a><td><tr><td><a name="l1843" href="#l1843">1843</a><td>/**<tr><td><a name="l1844" href="#l1844">1844</a><td> * Marks all of the tasks that are descendants of this frame in the execution<tr><td><a name="l1845" href="#l1845">1845</a><td> * tree as cancelled. This is necessary for callbacks scheduled asynchronous.<tr><td><a name="l1846" href="#l1846">1846</a><td> * For example:<tr><td><a name="l1847" href="#l1847">1847</a><td> *<tr><td><a name="l1848" href="#l1848">1848</a><td> *     var someResult;<tr><td><a name="l1849" href="#l1849">1849</a><td> *     webdriver.promise.createFlow(function(flow) {<tr><td><a name="l1850" href="#l1850">1850</a><td> *       someResult = flow.execute(function() {});<tr><td><a name="l1851" href="#l1851">1851</a><td> *       throw Error();<tr><td><a name="l1852" href="#l1852">1852</a><td> *     }).addErrback(function(err) {<tr><td><a name="l1853" href="#l1853">1853</a><td> *       console.log(&#39;flow failed: &#39; + err);<tr><td><a name="l1854" href="#l1854">1854</a><td> *       someResult.then(function() {<tr><td><a name="l1855" href="#l1855">1855</a><td> *         console.log(&#39;task succeeded!&#39;);<tr><td><a name="l1856" href="#l1856">1856</a><td> *       }, function(err) {<tr><td><a name="l1857" href="#l1857">1857</a><td> *         console.log(&#39;task failed! &#39; + err);<tr><td><a name="l1858" href="#l1858">1858</a><td> *       });<tr><td><a name="l1859" href="#l1859">1859</a><td> *     });<tr><td><a name="l1860" href="#l1860">1860</a><td> *     // flow failed: Error: boom<tr><td><a name="l1861" href="#l1861">1861</a><td> *     // task failed! CanceledTaskError: Task discarded due to a previous<tr><td><a name="l1862" href="#l1862">1862</a><td> *     // task failure: Error: boom<tr><td><a name="l1863" href="#l1863">1863</a><td> *<tr><td><a name="l1864" href="#l1864">1864</a><td> * @param {!webdriver.promise.CanceledTaskError_} error The cancellation<tr><td><a name="l1865" href="#l1865">1865</a><td> *     error.<tr><td><a name="l1866" href="#l1866">1866</a><td> */<tr><td><a name="l1867" href="#l1867">1867</a><td>webdriver.promise.Frame_.prototype.cancelRemainingTasks = function(error) {<tr><td><a name="l1868" href="#l1868">1868</a><td>  goog.array.forEach(this.children_, function(child) {<tr><td><a name="l1869" href="#l1869">1869</a><td>    if (child instanceof webdriver.promise.Frame_) {<tr><td><a name="l1870" href="#l1870">1870</a><td>      child.cancelRemainingTasks(error);<tr><td><a name="l1871" href="#l1871">1871</a><td>    } else {<tr><td><a name="l1872" href="#l1872">1872</a><td>      // None of the previously registered listeners should be notified that<tr><td><a name="l1873" href="#l1873">1873</a><td>      // the task is being canceled, however, we need at least one errback<tr><td><a name="l1874" href="#l1874">1874</a><td>      // to prevent the cancellation from bubbling up.<tr><td><a name="l1875" href="#l1875">1875</a><td>      child.removeAll();<tr><td><a name="l1876" href="#l1876">1876</a><td>      child.thenCatch(goog.nullFunction);<tr><td><a name="l1877" href="#l1877">1877</a><td>      child.cancel(error);<tr><td><a name="l1878" href="#l1878">1878</a><td>    }<tr><td><a name="l1879" href="#l1879">1879</a><td>  });<tr><td><a name="l1880" href="#l1880">1880</a><td>};<tr><td><a name="l1881" href="#l1881">1881</a><td><tr><td><a name="l1882" href="#l1882">1882</a><td><tr><td><a name="l1883" href="#l1883">1883</a><td>/**<tr><td><a name="l1884" href="#l1884">1884</a><td> * @return {webdriver.promise.Task_} The task currently executing<tr><td><a name="l1885" href="#l1885">1885</a><td> *     within this frame, if any.<tr><td><a name="l1886" href="#l1886">1886</a><td> */<tr><td><a name="l1887" href="#l1887">1887</a><td>webdriver.promise.Frame_.prototype.getPendingTask = function() {<tr><td><a name="l1888" href="#l1888">1888</a><td>  return this.pendingTask_;<tr><td><a name="l1889" href="#l1889">1889</a><td>};<tr><td><a name="l1890" href="#l1890">1890</a><td><tr><td><a name="l1891" href="#l1891">1891</a><td><tr><td><a name="l1892" href="#l1892">1892</a><td>/**<tr><td><a name="l1893" href="#l1893">1893</a><td> * @param {webdriver.promise.Task_} task The task currently<tr><td><a name="l1894" href="#l1894">1894</a><td> *     executing within this frame, if any.<tr><td><a name="l1895" href="#l1895">1895</a><td> */<tr><td><a name="l1896" href="#l1896">1896</a><td>webdriver.promise.Frame_.prototype.setPendingTask = function(task) {<tr><td><a name="l1897" href="#l1897">1897</a><td>  this.pendingTask_ = task;<tr><td><a name="l1898" href="#l1898">1898</a><td>};<tr><td><a name="l1899" href="#l1899">1899</a><td><tr><td><a name="l1900" href="#l1900">1900</a><td><tr><td><a name="l1901" href="#l1901">1901</a><td>/** Locks this frame. */<tr><td><a name="l1902" href="#l1902">1902</a><td>webdriver.promise.Frame_.prototype.lockFrame = function() {<tr><td><a name="l1903" href="#l1903">1903</a><td>  this.isLocked_ = true;<tr><td><a name="l1904" href="#l1904">1904</a><td>};<tr><td><a name="l1905" href="#l1905">1905</a><td><tr><td><a name="l1906" href="#l1906">1906</a><td><tr><td><a name="l1907" href="#l1907">1907</a><td>/**<tr><td><a name="l1908" href="#l1908">1908</a><td> * Adds a new node to this frame.<tr><td><a name="l1909" href="#l1909">1909</a><td> * @param {!(webdriver.promise.Frame_|webdriver.promise.Task_)} node<tr><td><a name="l1910" href="#l1910">1910</a><td> *     The node to insert.<tr><td><a name="l1911" href="#l1911">1911</a><td> */<tr><td><a name="l1912" href="#l1912">1912</a><td>webdriver.promise.Frame_.prototype.addChild = function(node) {<tr><td><a name="l1913" href="#l1913">1913</a><td>  if (this.lastInsertedChild_ &amp;&amp;<tr><td><a name="l1914" href="#l1914">1914</a><td>      this.lastInsertedChild_ instanceof webdriver.promise.Frame_ &amp;&amp;<tr><td><a name="l1915" href="#l1915">1915</a><td>      !this.lastInsertedChild_.isLocked_) {<tr><td><a name="l1916" href="#l1916">1916</a><td>    this.lastInsertedChild_.addChild(node);<tr><td><a name="l1917" href="#l1917">1917</a><td>    return;<tr><td><a name="l1918" href="#l1918">1918</a><td>  }<tr><td><a name="l1919" href="#l1919">1919</a><td><tr><td><a name="l1920" href="#l1920">1920</a><td>  node.setParent(this);<tr><td><a name="l1921" href="#l1921">1921</a><td><tr><td><a name="l1922" href="#l1922">1922</a><td>  if (this.isActive_ &amp;&amp; node instanceof webdriver.promise.Frame_) {<tr><td><a name="l1923" href="#l1923">1923</a><td>    var index = 0;<tr><td><a name="l1924" href="#l1924">1924</a><td>    if (this.lastInsertedChild_ instanceof<tr><td><a name="l1925" href="#l1925">1925</a><td>        webdriver.promise.Frame_) {<tr><td><a name="l1926" href="#l1926">1926</a><td>      index = goog.array.indexOf(this.children_, this.lastInsertedChild_) + 1;<tr><td><a name="l1927" href="#l1927">1927</a><td>    }<tr><td><a name="l1928" href="#l1928">1928</a><td>    goog.array.insertAt(this.children_, node, index);<tr><td><a name="l1929" href="#l1929">1929</a><td>    this.lastInsertedChild_ = node;<tr><td><a name="l1930" href="#l1930">1930</a><td>    return;<tr><td><a name="l1931" href="#l1931">1931</a><td>  }<tr><td><a name="l1932" href="#l1932">1932</a><td><tr><td><a name="l1933" href="#l1933">1933</a><td>  this.lastInsertedChild_ = node;<tr><td><a name="l1934" href="#l1934">1934</a><td>  this.children_.push(node);<tr><td><a name="l1935" href="#l1935">1935</a><td>};<tr><td><a name="l1936" href="#l1936">1936</a><td><tr><td><a name="l1937" href="#l1937">1937</a><td><tr><td><a name="l1938" href="#l1938">1938</a><td>/**<tr><td><a name="l1939" href="#l1939">1939</a><td> * @return {(webdriver.promise.Frame_|webdriver.promise.Task_)} This frame&#39;s<tr><td><a name="l1940" href="#l1940">1940</a><td> *     fist child.<tr><td><a name="l1941" href="#l1941">1941</a><td> */<tr><td><a name="l1942" href="#l1942">1942</a><td>webdriver.promise.Frame_.prototype.getFirstChild = function() {<tr><td><a name="l1943" href="#l1943">1943</a><td>  this.isActive_ = true;<tr><td><a name="l1944" href="#l1944">1944</a><td>  this.lastInsertedChild_ = null;<tr><td><a name="l1945" href="#l1945">1945</a><td>  return this.children_[0];<tr><td><a name="l1946" href="#l1946">1946</a><td>};<tr><td><a name="l1947" href="#l1947">1947</a><td><tr><td><a name="l1948" href="#l1948">1948</a><td><tr><td><a name="l1949" href="#l1949">1949</a><td>/**<tr><td><a name="l1950" href="#l1950">1950</a><td> * Removes a child from this frame.<tr><td><a name="l1951" href="#l1951">1951</a><td> * @param {!(webdriver.promise.Frame_|webdriver.promise.Task_)} child<tr><td><a name="l1952" href="#l1952">1952</a><td> *     The child to remove.<tr><td><a name="l1953" href="#l1953">1953</a><td> */<tr><td><a name="l1954" href="#l1954">1954</a><td>webdriver.promise.Frame_.prototype.removeChild = function(child) {<tr><td><a name="l1955" href="#l1955">1955</a><td>  var index = goog.array.indexOf(this.children_, child);<tr><td><a name="l1956" href="#l1956">1956</a><td>  child.setParent(null);<tr><td><a name="l1957" href="#l1957">1957</a><td>  goog.array.removeAt(this.children_, index);<tr><td><a name="l1958" href="#l1958">1958</a><td>  if (this.lastInsertedChild_ === child) {<tr><td><a name="l1959" href="#l1959">1959</a><td>    this.lastInsertedChild_ = null;<tr><td><a name="l1960" href="#l1960">1960</a><td>  }<tr><td><a name="l1961" href="#l1961">1961</a><td>};<tr><td><a name="l1962" href="#l1962">1962</a><td><tr><td><a name="l1963" href="#l1963">1963</a><td><tr><td><a name="l1964" href="#l1964">1964</a><td>/** @override */<tr><td><a name="l1965" href="#l1965">1965</a><td>webdriver.promise.Frame_.prototype.toString = function() {<tr><td><a name="l1966" href="#l1966">1966</a><td>  return &#39;[&#39; + goog.array.map(this.children_, function(child) {<tr><td><a name="l1967" href="#l1967">1967</a><td>    return child.toString();<tr><td><a name="l1968" href="#l1968">1968</a><td>  }).join(&#39;, &#39;) + &#39;]&#39;;<tr><td><a name="l1969" href="#l1969">1969</a><td>};<tr><td><a name="l1970" href="#l1970">1970</a><td><tr><td><a name="l1971" href="#l1971">1971</a><td><tr><td><a name="l1972" href="#l1972">1972</a><td><tr><td><a name="l1973" href="#l1973">1973</a><td>/**<tr><td><a name="l1974" href="#l1974">1974</a><td> * A task to be executed by a {@link webdriver.promise.ControlFlow}.<tr><td><a name="l1975" href="#l1975">1975</a><td> *<tr><td><a name="l1976" href="#l1976">1976</a><td> * @param {!webdriver.promise.ControlFlow} flow The flow this instances belongs<tr><td><a name="l1977" href="#l1977">1977</a><td> *     to.<tr><td><a name="l1978" href="#l1978">1978</a><td> * @param {!Function} fn The function to call when the task executes. If it<tr><td><a name="l1979" href="#l1979">1979</a><td> *     returns a {@code webdriver.promise.Promise}, the flow will wait<tr><td><a name="l1980" href="#l1980">1980</a><td> *     for it to be resolved before starting the next task.<tr><td><a name="l1981" href="#l1981">1981</a><td> * @param {string} description A description of the task for debugging.<tr><td><a name="l1982" href="#l1982">1982</a><td> * @param {!webdriver.stacktrace.Snapshot} snapshot A snapshot of the stack<tr><td><a name="l1983" href="#l1983">1983</a><td> *     when this task was scheduled.<tr><td><a name="l1984" href="#l1984">1984</a><td> * @constructor<tr><td><a name="l1985" href="#l1985">1985</a><td> * @extends {webdriver.promise.Node_}<tr><td><a name="l1986" href="#l1986">1986</a><td> * @private<tr><td><a name="l1987" href="#l1987">1987</a><td> */<tr><td><a name="l1988" href="#l1988">1988</a><td>webdriver.promise.Task_ = function(flow, fn, description, snapshot) {<tr><td><a name="l1989" href="#l1989">1989</a><td>  webdriver.promise.Node_.call(this, flow);<tr><td><a name="l1990" href="#l1990">1990</a><td><tr><td><a name="l1991" href="#l1991">1991</a><td>  /**<tr><td><a name="l1992" href="#l1992">1992</a><td>   * Executes this task.<tr><td><a name="l1993" href="#l1993">1993</a><td>   * @type {!Function}<tr><td><a name="l1994" href="#l1994">1994</a><td>   */<tr><td><a name="l1995" href="#l1995">1995</a><td>  this.execute = fn;<tr><td><a name="l1996" href="#l1996">1996</a><td><tr><td><a name="l1997" href="#l1997">1997</a><td>  /** @private {string} */<tr><td><a name="l1998" href="#l1998">1998</a><td>  this.description_ = description;<tr><td><a name="l1999" href="#l1999">1999</a><td><tr><td><a name="l2000" href="#l2000">2000</a><td>  /** @private {!webdriver.stacktrace.Snapshot} */<tr><td><a name="l2001" href="#l2001">2001</a><td>  this.snapshot_ = snapshot;<tr><td><a name="l2002" href="#l2002">2002</a><td>};<tr><td><a name="l2003" href="#l2003">2003</a><td>goog.inherits(webdriver.promise.Task_, webdriver.promise.Node_);<tr><td><a name="l2004" href="#l2004">2004</a><td><tr><td><a name="l2005" href="#l2005">2005</a><td><tr><td><a name="l2006" href="#l2006">2006</a><td>/** @return {string} This task&#39;s description. */<tr><td><a name="l2007" href="#l2007">2007</a><td>webdriver.promise.Task_.prototype.getDescription = function() {<tr><td><a name="l2008" href="#l2008">2008</a><td>  return this.description_;<tr><td><a name="l2009" href="#l2009">2009</a><td>};<tr><td><a name="l2010" href="#l2010">2010</a><td><tr><td><a name="l2011" href="#l2011">2011</a><td><tr><td><a name="l2012" href="#l2012">2012</a><td>/** @override */<tr><td><a name="l2013" href="#l2013">2013</a><td>webdriver.promise.Task_.prototype.toString = function() {<tr><td><a name="l2014" href="#l2014">2014</a><td>  var stack = this.snapshot_.getStacktrace();<tr><td><a name="l2015" href="#l2015">2015</a><td>  var ret = this.description_;<tr><td><a name="l2016" href="#l2016">2016</a><td>  if (stack.length) {<tr><td><a name="l2017" href="#l2017">2017</a><td>    if (this.description_) {<tr><td><a name="l2018" href="#l2018">2018</a><td>      ret += &#39;\n&#39;;<tr><td><a name="l2019" href="#l2019">2019</a><td>    }<tr><td><a name="l2020" href="#l2020">2020</a><td>    ret += stack.join(&#39;\n&#39;);<tr><td><a name="l2021" href="#l2021">2021</a><td>  }<tr><td><a name="l2022" href="#l2022">2022</a><td>  return ret;<tr><td><a name="l2023" href="#l2023">2023</a><td>};<tr><td><a name="l2024" href="#l2024">2024</a><td><tr><td><a name="l2025" href="#l2025">2025</a><td><tr><td><a name="l2026" href="#l2026">2026</a><td><tr><td><a name="l2027" href="#l2027">2027</a><td>/**<tr><td><a name="l2028" href="#l2028">2028</a><td> * Special error used to signal when a task is canceled because a previous<tr><td><a name="l2029" href="#l2029">2029</a><td> * task in the same frame failed.<tr><td><a name="l2030" href="#l2030">2030</a><td> * @param {*} err The error that caused the task cancellation.<tr><td><a name="l2031" href="#l2031">2031</a><td> * @constructor<tr><td><a name="l2032" href="#l2032">2032</a><td> * @extends {goog.debug.Error}<tr><td><a name="l2033" href="#l2033">2033</a><td> * @private<tr><td><a name="l2034" href="#l2034">2034</a><td> */<tr><td><a name="l2035" href="#l2035">2035</a><td>webdriver.promise.CanceledTaskError_ = function(err) {<tr><td><a name="l2036" href="#l2036">2036</a><td>  goog.base(this, &#39;Task discarded due to a previous task failure: &#39; + err);<tr><td><a name="l2037" href="#l2037">2037</a><td>};<tr><td><a name="l2038" href="#l2038">2038</a><td>goog.inherits(webdriver.promise.CanceledTaskError_, goog.debug.Error);<tr><td><a name="l2039" href="#l2039">2039</a><td><tr><td><a name="l2040" href="#l2040">2040</a><td><tr><td><a name="l2041" href="#l2041">2041</a><td>/** @override */<tr><td><a name="l2042" href="#l2042">2042</a><td>webdriver.promise.CanceledTaskError_.prototype.name = &#39;CanceledTaskError&#39;;<tr><td><a name="l2043" href="#l2043">2043</a><td><tr><td><a name="l2044" href="#l2044">2044</a><td><tr><td><a name="l2045" href="#l2045">2045</a><td><tr><td><a name="l2046" href="#l2046">2046</a><td>/**<tr><td><a name="l2047" href="#l2047">2047</a><td> * The default flow to use if no others are active.<tr><td><a name="l2048" href="#l2048">2048</a><td> * @private {!webdriver.promise.ControlFlow}<tr><td><a name="l2049" href="#l2049">2049</a><td> */<tr><td><a name="l2050" href="#l2050">2050</a><td>webdriver.promise.defaultFlow_ = new webdriver.promise.ControlFlow();<tr><td><a name="l2051" href="#l2051">2051</a><td><tr><td><a name="l2052" href="#l2052">2052</a><td><tr><td><a name="l2053" href="#l2053">2053</a><td>/**<tr><td><a name="l2054" href="#l2054">2054</a><td> * A stack of active control flows, with the top of the stack used to schedule<tr><td><a name="l2055" href="#l2055">2055</a><td> * commands. When there are multiple flows on the stack, the flow at index N<tr><td><a name="l2056" href="#l2056">2056</a><td> * represents a callback triggered within a task owned by the flow at index<tr><td><a name="l2057" href="#l2057">2057</a><td> * N-1.<tr><td><a name="l2058" href="#l2058">2058</a><td> * @private {!Array.&lt;!webdriver.promise.ControlFlow&gt;}<tr><td><a name="l2059" href="#l2059">2059</a><td> */<tr><td><a name="l2060" href="#l2060">2060</a><td>webdriver.promise.activeFlows_ = [];<tr><td><a name="l2061" href="#l2061">2061</a><td><tr><td><a name="l2062" href="#l2062">2062</a><td><tr><td><a name="l2063" href="#l2063">2063</a><td>/**<tr><td><a name="l2064" href="#l2064">2064</a><td> * Changes the default flow to use when no others are active.<tr><td><a name="l2065" href="#l2065">2065</a><td> * @param {!webdriver.promise.ControlFlow} flow The new default flow.<tr><td><a name="l2066" href="#l2066">2066</a><td> * @throws {Error} If the default flow is not currently active.<tr><td><a name="l2067" href="#l2067">2067</a><td> */<tr><td><a name="l2068" href="#l2068">2068</a><td>webdriver.promise.setDefaultFlow = function(flow) {<tr><td><a name="l2069" href="#l2069">2069</a><td>  if (webdriver.promise.activeFlows_.length) {<tr><td><a name="l2070" href="#l2070">2070</a><td>    throw Error(&#39;You may only change the default flow while it is active&#39;);<tr><td><a name="l2071" href="#l2071">2071</a><td>  }<tr><td><a name="l2072" href="#l2072">2072</a><td>  webdriver.promise.defaultFlow_ = flow;<tr><td><a name="l2073" href="#l2073">2073</a><td>};<tr><td><a name="l2074" href="#l2074">2074</a><td><tr><td><a name="l2075" href="#l2075">2075</a><td><tr><td><a name="l2076" href="#l2076">2076</a><td>/**<tr><td><a name="l2077" href="#l2077">2077</a><td> * @return {!webdriver.promise.ControlFlow} The currently active control flow.<tr><td><a name="l2078" href="#l2078">2078</a><td> */<tr><td><a name="l2079" href="#l2079">2079</a><td>webdriver.promise.controlFlow = function() {<tr><td><a name="l2080" href="#l2080">2080</a><td>  return /** @type {!webdriver.promise.ControlFlow} */ (<tr><td><a name="l2081" href="#l2081">2081</a><td>      goog.array.peek(webdriver.promise.activeFlows_) ||<tr><td><a name="l2082" href="#l2082">2082</a><td>      webdriver.promise.defaultFlow_);<tr><td><a name="l2083" href="#l2083">2083</a><td>};<tr><td><a name="l2084" href="#l2084">2084</a><td><tr><td><a name="l2085" href="#l2085">2085</a><td><tr><td><a name="l2086" href="#l2086">2086</a><td>/**<tr><td><a name="l2087" href="#l2087">2087</a><td> * @param {!webdriver.promise.ControlFlow} flow The new flow.<tr><td><a name="l2088" href="#l2088">2088</a><td> * @private<tr><td><a name="l2089" href="#l2089">2089</a><td> */<tr><td><a name="l2090" href="#l2090">2090</a><td>webdriver.promise.pushFlow_ = function(flow) {<tr><td><a name="l2091" href="#l2091">2091</a><td>  webdriver.promise.activeFlows_.push(flow);<tr><td><a name="l2092" href="#l2092">2092</a><td>};<tr><td><a name="l2093" href="#l2093">2093</a><td><tr><td><a name="l2094" href="#l2094">2094</a><td><tr><td><a name="l2095" href="#l2095">2095</a><td>/** @private */<tr><td><a name="l2096" href="#l2096">2096</a><td>webdriver.promise.popFlow_ = function() {<tr><td><a name="l2097" href="#l2097">2097</a><td>  webdriver.promise.activeFlows_.pop();<tr><td><a name="l2098" href="#l2098">2098</a><td>};<tr><td><a name="l2099" href="#l2099">2099</a><td><tr><td><a name="l2100" href="#l2100">2100</a><td><tr><td><a name="l2101" href="#l2101">2101</a><td>/**<tr><td><a name="l2102" href="#l2102">2102</a><td> * Creates a new control flow. The provided callback will be invoked as the<tr><td><a name="l2103" href="#l2103">2103</a><td> * first task within the new flow, with the flow as its sole argument. Returns<tr><td><a name="l2104" href="#l2104">2104</a><td> * a promise that resolves to the callback result.<tr><td><a name="l2105" href="#l2105">2105</a><td> * @param {function(!webdriver.promise.ControlFlow)} callback The entry point<tr><td><a name="l2106" href="#l2106">2106</a><td> *     to the newly created flow.<tr><td><a name="l2107" href="#l2107">2107</a><td> * @return {!webdriver.promise.Promise} A promise that resolves to the callback<tr><td><a name="l2108" href="#l2108">2108</a><td> *     result.<tr><td><a name="l2109" href="#l2109">2109</a><td> */<tr><td><a name="l2110" href="#l2110">2110</a><td>webdriver.promise.createFlow = function(callback) {<tr><td><a name="l2111" href="#l2111">2111</a><td>  var flow = new webdriver.promise.ControlFlow(<tr><td><a name="l2112" href="#l2112">2112</a><td>      webdriver.promise.defaultFlow_.timer);<tr><td><a name="l2113" href="#l2113">2113</a><td>  return flow.execute(function() {<tr><td><a name="l2114" href="#l2114">2114</a><td>    return callback(flow);<tr><td><a name="l2115" href="#l2115">2115</a><td>  });<tr><td><a name="l2116" href="#l2116">2116</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>promise.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/webdriver/promise.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @license Portions of this code are from the Dojo toolkit, received under the<tr><td><a id="l20"></a><a href="#l20">20</a><td> * BSD License:<tr><td><a id="l21"></a><a href="#l21">21</a><td> * Redistribution and use in source and binary forms, with or without<tr><td><a id="l22"></a><a href="#l22">22</a><td> * modification, are permitted provided that the following conditions are met:<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> *   * Redistributions of source code must retain the above copyright notice,<tr><td><a id="l25"></a><a href="#l25">25</a><td> *     this list of conditions and the following disclaimer.<tr><td><a id="l26"></a><a href="#l26">26</a><td> *   * Redistributions in binary form must reproduce the above copyright notice,<tr><td><a id="l27"></a><a href="#l27">27</a><td> *     this list of conditions and the following disclaimer in the documentation<tr><td><a id="l28"></a><a href="#l28">28</a><td> *     and/or other materials provided with the distribution.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *   * Neither the name of the Dojo Foundation nor the names of its contributors<tr><td><a id="l30"></a><a href="#l30">30</a><td> *     may be used to endorse or promote products derived from this software<tr><td><a id="l31"></a><a href="#l31">31</a><td> *     without specific prior written permission.<tr><td><a id="l32"></a><a href="#l32">32</a><td> *<tr><td><a id="l33"></a><a href="#l33">33</a><td> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS &quot;AS IS&quot;<tr><td><a id="l34"></a><a href="#l34">34</a><td> * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE<tr><td><a id="l35"></a><a href="#l35">35</a><td> * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE<tr><td><a id="l36"></a><a href="#l36">36</a><td> * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE<tr><td><a id="l37"></a><a href="#l37">37</a><td> * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR<tr><td><a id="l38"></a><a href="#l38">38</a><td> * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF<tr><td><a id="l39"></a><a href="#l39">39</a><td> * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS<tr><td><a id="l40"></a><a href="#l40">40</a><td> * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN<tr><td><a id="l41"></a><a href="#l41">41</a><td> * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)<tr><td><a id="l42"></a><a href="#l42">42</a><td> * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE<tr><td><a id="l43"></a><a href="#l43">43</a><td> * POSSIBILITY OF SUCH DAMAGE.<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>/**<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @fileoverview<tr><td><a id="l48"></a><a href="#l48">48</a><td> * The promise module is centered around the<tr><td><a id="l49"></a><a href="#l49">49</a><td> * {@linkplain webdriver.promise.ControlFlow ControlFlow}, a class that<tr><td><a id="l50"></a><a href="#l50">50</a><td> * coordinates the execution of asynchronous tasks. The ControlFlow allows users<tr><td><a id="l51"></a><a href="#l51">51</a><td> * to focus on the imperative commands for their script without worrying about<tr><td><a id="l52"></a><a href="#l52">52</a><td> * chaining together every single asynchronous action, which can be tedious and<tr><td><a id="l53"></a><a href="#l53">53</a><td> * verbose. APIs may be layered on top of the control flow to read as if they<tr><td><a id="l54"></a><a href="#l54">54</a><td> * were synchronous. For instance, the core<tr><td><a id="l55"></a><a href="#l55">55</a><td> * {@linkplain webdriver.WebDriver WebDriver} API is built on top of the<tr><td><a id="l56"></a><a href="#l56">56</a><td> * control flow, allowing users to write<tr><td><a id="l57"></a><a href="#l57">57</a><td> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> *     driver.get(&#39;http://www.google.com/ncr&#39;);<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     driver.findElement({name: &#39;q&#39;}).sendKeys(&#39;webdriver&#39;);<tr><td><a id="l60"></a><a href="#l60">60</a><td> *     driver.findElement({name: &#39;btnGn&#39;}).click();<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * instead of<tr><td><a id="l63"></a><a href="#l63">63</a><td> *<tr><td><a id="l64"></a><a href="#l64">64</a><td> *     driver.get(&#39;http://www.google.com/ncr&#39;)<tr><td><a id="l65"></a><a href="#l65">65</a><td> *     .then(function() {<tr><td><a id="l66"></a><a href="#l66">66</a><td> *       return driver.findElement({name: &#39;q&#39;});<tr><td><a id="l67"></a><a href="#l67">67</a><td> *     })<tr><td><a id="l68"></a><a href="#l68">68</a><td> *     .then(function(q) {<tr><td><a id="l69"></a><a href="#l69">69</a><td> *       return q.sendKeys(&#39;webdriver&#39;);<tr><td><a id="l70"></a><a href="#l70">70</a><td> *     })<tr><td><a id="l71"></a><a href="#l71">71</a><td> *     .then(function() {<tr><td><a id="l72"></a><a href="#l72">72</a><td> *       return driver.findElement({name: &#39;btnG&#39;});<tr><td><a id="l73"></a><a href="#l73">73</a><td> *     })<tr><td><a id="l74"></a><a href="#l74">74</a><td> *     .then(function(btnG) {<tr><td><a id="l75"></a><a href="#l75">75</a><td> *       return btnG.click();<tr><td><a id="l76"></a><a href="#l76">76</a><td> *     });<tr><td><a id="l77"></a><a href="#l77">77</a><td> *<tr><td><a id="l78"></a><a href="#l78">78</a><td> * ## Tasks and Task Queues<tr><td><a id="l79"></a><a href="#l79">79</a><td> *<tr><td><a id="l80"></a><a href="#l80">80</a><td> * The control flow is based on the concept of tasks and task queues. Tasks are<tr><td><a id="l81"></a><a href="#l81">81</a><td> * functions that define the basic unit of work for the control flow to execute.<tr><td><a id="l82"></a><a href="#l82">82</a><td> * Each task is scheduled via<tr><td><a id="l83"></a><a href="#l83">83</a><td> * {@link webdriver.promise.ControlFlow#execute() ControlFlow#execute()}, which<tr><td><a id="l84"></a><a href="#l84">84</a><td> * will return a {@link webdriver.promise.Promise Promise} that will be resolved<tr><td><a id="l85"></a><a href="#l85">85</a><td> * with the task&#39;s result.<tr><td><a id="l86"></a><a href="#l86">86</a><td> *<tr><td><a id="l87"></a><a href="#l87">87</a><td> * A task queue contains all of the tasks scheduled within a single turn of the<tr><td><a id="l88"></a><a href="#l88">88</a><td> * [JavaScript event loop][JSEL]. The control flow will create a new task queue<tr><td><a id="l89"></a><a href="#l89">89</a><td> * the first time a task is scheduled within an event loop.<tr><td><a id="l90"></a><a href="#l90">90</a><td> *<tr><td><a id="l91"></a><a href="#l91">91</a><td> *     var flow = promise.controlFlow();<tr><td><a id="l92"></a><a href="#l92">92</a><td> *     flow.execute(foo);       // Creates a new task queue and inserts foo.<tr><td><a id="l93"></a><a href="#l93">93</a><td> *     flow.execute(bar);       // Inserts bar into the same queue as foo.<tr><td><a id="l94"></a><a href="#l94">94</a><td> *     setTimeout(function() {<tr><td><a id="l95"></a><a href="#l95">95</a><td> *       flow.execute(baz);     // Creates a new task queue and inserts baz.<tr><td><a id="l96"></a><a href="#l96">96</a><td> *     }, 0);<tr><td><a id="l97"></a><a href="#l97">97</a><td> *<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Whenever the control flow creates a new task queue, it will automatically<tr><td><a id="l99"></a><a href="#l99">99</a><td> * begin executing tasks in the next available turn of the event loop. This<tr><td><a id="l100"></a><a href="#l100">100</a><td> * execution is scheduled using a &quot;micro-task&quot; timer, such as a (native)<tr><td><a id="l101"></a><a href="#l101">101</a><td> * `Promise.then()` callback.<tr><td><a id="l102"></a><a href="#l102">102</a><td> *<tr><td><a id="l103"></a><a href="#l103">103</a><td> *     setTimeout(() =&gt; console.log(&#39;a&#39;));<tr><td><a id="l104"></a><a href="#l104">104</a><td> *     Promise.resolve().then(() =&gt; console.log(&#39;b&#39;));  // A native promise.<tr><td><a id="l105"></a><a href="#l105">105</a><td> *     flow.execute(() =&gt; console.log(&#39;c&#39;));<tr><td><a id="l106"></a><a href="#l106">106</a><td> *     Promise.resolve().then(() =&gt; console.log(&#39;d&#39;));<tr><td><a id="l107"></a><a href="#l107">107</a><td> *     setTimeout(() =&gt; console.log(&#39;fin&#39;));<tr><td><a id="l108"></a><a href="#l108">108</a><td> *     // b<tr><td><a id="l109"></a><a href="#l109">109</a><td> *     // c<tr><td><a id="l110"></a><a href="#l110">110</a><td> *     // d<tr><td><a id="l111"></a><a href="#l111">111</a><td> *     // a<tr><td><a id="l112"></a><a href="#l112">112</a><td> *     // fin<tr><td><a id="l113"></a><a href="#l113">113</a><td> *<tr><td><a id="l114"></a><a href="#l114">114</a><td> * In the example above, b/c/d is logged before a/fin because native promises<tr><td><a id="l115"></a><a href="#l115">115</a><td> * and this module use &quot;micro-task&quot; timers, which have a higher priority than<tr><td><a id="l116"></a><a href="#l116">116</a><td> * &quot;macro-tasks&quot; like `setTimeout`.<tr><td><a id="l117"></a><a href="#l117">117</a><td> *<tr><td><a id="l118"></a><a href="#l118">118</a><td> * ## Task Execution<tr><td><a id="l119"></a><a href="#l119">119</a><td> *<tr><td><a id="l120"></a><a href="#l120">120</a><td> * Upon creating a task queue, and whenever an exisiting queue completes a task,<tr><td><a id="l121"></a><a href="#l121">121</a><td> * the control flow will schedule a micro-task timer to process any scheduled<tr><td><a id="l122"></a><a href="#l122">122</a><td> * tasks. This ensures no task is ever started within the same turn of the<tr><td><a id="l123"></a><a href="#l123">123</a><td> * JavaScript event loop in which it was scheduled, nor is a task ever started<tr><td><a id="l124"></a><a href="#l124">124</a><td> * within the same turn that another finishes.<tr><td><a id="l125"></a><a href="#l125">125</a><td> *<tr><td><a id="l126"></a><a href="#l126">126</a><td> * When the execution timer fires, a single task will be dequeued and executed.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * There are several important events that may occur while executing a task<tr><td><a id="l128"></a><a href="#l128">128</a><td> * function:<tr><td><a id="l129"></a><a href="#l129">129</a><td> *<tr><td><a id="l130"></a><a href="#l130">130</a><td> * 1. A new task queue is created by a call to<tr><td><a id="l131"></a><a href="#l131">131</a><td> *    {@link webdriver.promise.ControlFlow#execute ControlFlow#execute()}. Any<tr><td><a id="l132"></a><a href="#l132">132</a><td> *    tasks scheduled within this task queue are considered subtasks of the<tr><td><a id="l133"></a><a href="#l133">133</a><td> *    current task.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * 2. The task function throws an error. Any scheduled tasks are immediately<tr><td><a id="l135"></a><a href="#l135">135</a><td> *    discarded and the task&#39;s promised result (previously returned by<tr><td><a id="l136"></a><a href="#l136">136</a><td> *    {@link webdriver.promise.ControlFlow#execute ControlFlow#execute()}) is<tr><td><a id="l137"></a><a href="#l137">137</a><td> *    immediately rejected with the thrown error.<tr><td><a id="l138"></a><a href="#l138">138</a><td> * 3. The task function returns sucessfully.<tr><td><a id="l139"></a><a href="#l139">139</a><td> *<tr><td><a id="l140"></a><a href="#l140">140</a><td> * If a task function created a new task queue, the control flow will wait for<tr><td><a id="l141"></a><a href="#l141">141</a><td> * that queue to complete before processing the task result. If the queue<tr><td><a id="l142"></a><a href="#l142">142</a><td> * completes without error, the flow will settle the task&#39;s promise with the<tr><td><a id="l143"></a><a href="#l143">143</a><td> * value originaly returned by the task function. On the other hand, if the task<tr><td><a id="l144"></a><a href="#l144">144</a><td> * queue termintes with an error, the task&#39;s promise will be rejected with that<tr><td><a id="l145"></a><a href="#l145">145</a><td> * error.<tr><td><a id="l146"></a><a href="#l146">146</a><td> *<tr><td><a id="l147"></a><a href="#l147">147</a><td> *     flow.execute(function() {<tr><td><a id="l148"></a><a href="#l148">148</a><td> *       flow.execute(() =&gt; console.log(&#39;a&#39;));<tr><td><a id="l149"></a><a href="#l149">149</a><td> *       flow.execute(() =&gt; console.log(&#39;b&#39;));<tr><td><a id="l150"></a><a href="#l150">150</a><td> *     });<tr><td><a id="l151"></a><a href="#l151">151</a><td> *     flow.execute(() =&gt; console.log(&#39;c&#39;));<tr><td><a id="l152"></a><a href="#l152">152</a><td> *     // a<tr><td><a id="l153"></a><a href="#l153">153</a><td> *     // b<tr><td><a id="l154"></a><a href="#l154">154</a><td> *     // c<tr><td><a id="l155"></a><a href="#l155">155</a><td> *<tr><td><a id="l156"></a><a href="#l156">156</a><td> * ## Promise Integration<tr><td><a id="l157"></a><a href="#l157">157</a><td> *<tr><td><a id="l158"></a><a href="#l158">158</a><td> * In addition to the {@link webdriver.promise.ControlFlow ControlFlow} class,<tr><td><a id="l159"></a><a href="#l159">159</a><td> * the promise module also exports a [Promise/A+]<tr><td><a id="l160"></a><a href="#l160">160</a><td> * {@linkplain webdriver.promise.Promise implementation} that is deeply<tr><td><a id="l161"></a><a href="#l161">161</a><td> * integrated with the ControlFlow. First and foremost, each promise<tr><td><a id="l162"></a><a href="#l162">162</a><td> * {@linkplain webdriver.promise.Promise#then() callback} is scheduled with the<tr><td><a id="l163"></a><a href="#l163">163</a><td> * control flow as a task. As a result, each callback is invoked in its own turn<tr><td><a id="l164"></a><a href="#l164">164</a><td> * of the JavaScript event loop with its own task queue. If any tasks are<tr><td><a id="l165"></a><a href="#l165">165</a><td> * scheduled within a callback, the callback&#39;s promised result will not be<tr><td><a id="l166"></a><a href="#l166">166</a><td> * settled until the task queue has completed.<tr><td><a id="l167"></a><a href="#l167">167</a><td> *<tr><td><a id="l168"></a><a href="#l168">168</a><td> *     promise.fulfilled().then(function() {<tr><td><a id="l169"></a><a href="#l169">169</a><td> *       flow.execute(function() {<tr><td><a id="l170"></a><a href="#l170">170</a><td> *         console.log(&#39;b&#39;);<tr><td><a id="l171"></a><a href="#l171">171</a><td> *       });<tr><td><a id="l172"></a><a href="#l172">172</a><td> *     }).then(() =&gt; console.log(&#39;a&#39;));<tr><td><a id="l173"></a><a href="#l173">173</a><td> *     // b<tr><td><a id="l174"></a><a href="#l174">174</a><td> *     // a<tr><td><a id="l175"></a><a href="#l175">175</a><td> *<tr><td><a id="l176"></a><a href="#l176">176</a><td> * ### Scheduling Promise Callbacks &lt;a id=&quot;scheduling_callbacks&quot;&gt;&lt;/a&gt;<tr><td><a id="l177"></a><a href="#l177">177</a><td> *<tr><td><a id="l178"></a><a href="#l178">178</a><td> * How callbacks are scheduled in the control flow depends on when they are<tr><td><a id="l179"></a><a href="#l179">179</a><td> * attached to the promise. Callbacks attached to a _previously_ resolved<tr><td><a id="l180"></a><a href="#l180">180</a><td> * promise are immediately enqueued as subtasks of the currently running task.<tr><td><a id="l181"></a><a href="#l181">181</a><td> *<tr><td><a id="l182"></a><a href="#l182">182</a><td> *     var p = promise.fulfilled();<tr><td><a id="l183"></a><a href="#l183">183</a><td> *     flow.execute(function() {<tr><td><a id="l184"></a><a href="#l184">184</a><td> *       flow.execute(() =&gt; console.log(&#39;A&#39;));<tr><td><a id="l185"></a><a href="#l185">185</a><td> *       p.then(      () =&gt; console.log(&#39;B&#39;));<tr><td><a id="l186"></a><a href="#l186">186</a><td> *       flow.execute(() =&gt; console.log(&#39;C&#39;));<tr><td><a id="l187"></a><a href="#l187">187</a><td> *       p.then(      () =&gt; console.log(&#39;D&#39;));<tr><td><a id="l188"></a><a href="#l188">188</a><td> *     }).then(function() {<tr><td><a id="l189"></a><a href="#l189">189</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l190"></a><a href="#l190">190</a><td> *     });<tr><td><a id="l191"></a><a href="#l191">191</a><td> *     // A<tr><td><a id="l192"></a><a href="#l192">192</a><td> *     // B<tr><td><a id="l193"></a><a href="#l193">193</a><td> *     // C<tr><td><a id="l194"></a><a href="#l194">194</a><td> *     // D<tr><td><a id="l195"></a><a href="#l195">195</a><td> *     // fin<tr><td><a id="l196"></a><a href="#l196">196</a><td> *<tr><td><a id="l197"></a><a href="#l197">197</a><td> * When a promise is resolved while a task function is on the call stack, any<tr><td><a id="l198"></a><a href="#l198">198</a><td> * callbacks also registered in that stack frame are scheduled as if the promise<tr><td><a id="l199"></a><a href="#l199">199</a><td> * were already resolved:<tr><td><a id="l200"></a><a href="#l200">200</a><td> *<tr><td><a id="l201"></a><a href="#l201">201</a><td> *     var d = promise.defer();<tr><td><a id="l202"></a><a href="#l202">202</a><td> *     flow.execute(function() {<tr><td><a id="l203"></a><a href="#l203">203</a><td> *       flow.execute(  () =&gt; console.log(&#39;A&#39;));<tr><td><a id="l204"></a><a href="#l204">204</a><td> *       d.promise.then(() =&gt; console.log(&#39;B&#39;));<tr><td><a id="l205"></a><a href="#l205">205</a><td> *       flow.execute(  () =&gt; console.log(&#39;C&#39;));<tr><td><a id="l206"></a><a href="#l206">206</a><td> *       d.promise.then(() =&gt; console.log(&#39;D&#39;));<tr><td><a id="l207"></a><a href="#l207">207</a><td> *<tr><td><a id="l208"></a><a href="#l208">208</a><td> *       d.fulfill();<tr><td><a id="l209"></a><a href="#l209">209</a><td> *     }).then(function() {<tr><td><a id="l210"></a><a href="#l210">210</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l211"></a><a href="#l211">211</a><td> *     });<tr><td><a id="l212"></a><a href="#l212">212</a><td> *     // A<tr><td><a id="l213"></a><a href="#l213">213</a><td> *     // B<tr><td><a id="l214"></a><a href="#l214">214</a><td> *     // C<tr><td><a id="l215"></a><a href="#l215">215</a><td> *     // D<tr><td><a id="l216"></a><a href="#l216">216</a><td> *     // fin<tr><td><a id="l217"></a><a href="#l217">217</a><td> *<tr><td><a id="l218"></a><a href="#l218">218</a><td> * If a promise is resolved while a task function is on the call stack, any<tr><td><a id="l219"></a><a href="#l219">219</a><td> * previously registered callbacks (i.e. attached while the task was _not_ on<tr><td><a id="l220"></a><a href="#l220">220</a><td> * the call stack), act as _interrupts_ and are inserted at the front of the<tr><td><a id="l221"></a><a href="#l221">221</a><td> * task queue. If multiple promises are fulfilled, their interrupts are enqueued<tr><td><a id="l222"></a><a href="#l222">222</a><td> * in the order the promises are resolved.<tr><td><a id="l223"></a><a href="#l223">223</a><td> *<tr><td><a id="l224"></a><a href="#l224">224</a><td> *     var d1 = promise.defer();<tr><td><a id="l225"></a><a href="#l225">225</a><td> *     d1.promise.then(() =&gt; console.log(&#39;A&#39;));<tr><td><a id="l226"></a><a href="#l226">226</a><td> *<tr><td><a id="l227"></a><a href="#l227">227</a><td> *     var d2 = promise.defer();<tr><td><a id="l228"></a><a href="#l228">228</a><td> *     d2.promise.then(() =&gt; console.log(&#39;B&#39;));<tr><td><a id="l229"></a><a href="#l229">229</a><td> *<tr><td><a id="l230"></a><a href="#l230">230</a><td> *     flow.execute(function() {<tr><td><a id="l231"></a><a href="#l231">231</a><td> *       flow.execute(() =&gt; console.log(&#39;C&#39;));<tr><td><a id="l232"></a><a href="#l232">232</a><td> *       flow.execute(() =&gt; console.log(&#39;D&#39;));<tr><td><a id="l233"></a><a href="#l233">233</a><td> *       d1.fulfill();<tr><td><a id="l234"></a><a href="#l234">234</a><td> *       d2.fulfill();<tr><td><a id="l235"></a><a href="#l235">235</a><td> *     }).then(function() {<tr><td><a id="l236"></a><a href="#l236">236</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l237"></a><a href="#l237">237</a><td> *     });<tr><td><a id="l238"></a><a href="#l238">238</a><td> *     // A<tr><td><a id="l239"></a><a href="#l239">239</a><td> *     // B<tr><td><a id="l240"></a><a href="#l240">240</a><td> *     // C<tr><td><a id="l241"></a><a href="#l241">241</a><td> *     // D<tr><td><a id="l242"></a><a href="#l242">242</a><td> *     // fin<tr><td><a id="l243"></a><a href="#l243">243</a><td> *<tr><td><a id="l244"></a><a href="#l244">244</a><td> * Within a task function (or callback), each step of a promise chain acts as<tr><td><a id="l245"></a><a href="#l245">245</a><td> * an interrupt on the task queue:<tr><td><a id="l246"></a><a href="#l246">246</a><td> *<tr><td><a id="l247"></a><a href="#l247">247</a><td> *     var d = promise.defer();<tr><td><a id="l248"></a><a href="#l248">248</a><td> *     flow.execute(function() {<tr><td><a id="l249"></a><a href="#l249">249</a><td> *       d.promise.<tr><td><a id="l250"></a><a href="#l250">250</a><td> *           then(() =&gt; console.log(&#39;A&#39;)).<tr><td><a id="l251"></a><a href="#l251">251</a><td> *           then(() =&gt; console.log(&#39;B&#39;)).<tr><td><a id="l252"></a><a href="#l252">252</a><td> *           then(() =&gt; console.log(&#39;C&#39;)).<tr><td><a id="l253"></a><a href="#l253">253</a><td> *           then(() =&gt; console.log(&#39;D&#39;));<tr><td><a id="l254"></a><a href="#l254">254</a><td> *<tr><td><a id="l255"></a><a href="#l255">255</a><td> *       flow.execute(() =&gt; console.log(&#39;E&#39;));<tr><td><a id="l256"></a><a href="#l256">256</a><td> *       d.fulfill();<tr><td><a id="l257"></a><a href="#l257">257</a><td> *     }).then(function() {<tr><td><a id="l258"></a><a href="#l258">258</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l259"></a><a href="#l259">259</a><td> *     });<tr><td><a id="l260"></a><a href="#l260">260</a><td> *     // A<tr><td><a id="l261"></a><a href="#l261">261</a><td> *     // B<tr><td><a id="l262"></a><a href="#l262">262</a><td> *     // C<tr><td><a id="l263"></a><a href="#l263">263</a><td> *     // D<tr><td><a id="l264"></a><a href="#l264">264</a><td> *     // E<tr><td><a id="l265"></a><a href="#l265">265</a><td> *     // fin<tr><td><a id="l266"></a><a href="#l266">266</a><td> *<tr><td><a id="l267"></a><a href="#l267">267</a><td> * If there are multiple promise chains derived from a single promise, they are<tr><td><a id="l268"></a><a href="#l268">268</a><td> * processed in the order created:<tr><td><a id="l269"></a><a href="#l269">269</a><td> *<tr><td><a id="l270"></a><a href="#l270">270</a><td> *     var d = promise.defer();<tr><td><a id="l271"></a><a href="#l271">271</a><td> *     flow.execute(function() {<tr><td><a id="l272"></a><a href="#l272">272</a><td> *       var chain = d.promise.then(() =&gt; console.log(&#39;A&#39;));<tr><td><a id="l273"></a><a href="#l273">273</a><td> *<tr><td><a id="l274"></a><a href="#l274">274</a><td> *       chain.then(() =&gt; console.log(&#39;B&#39;)).<tr><td><a id="l275"></a><a href="#l275">275</a><td> *           then(() =&gt; console.log(&#39;C&#39;));<tr><td><a id="l276"></a><a href="#l276">276</a><td> *<tr><td><a id="l277"></a><a href="#l277">277</a><td> *       chain.then(() =&gt; console.log(&#39;D&#39;)).<tr><td><a id="l278"></a><a href="#l278">278</a><td> *           then(() =&gt; console.log(&#39;E&#39;));<tr><td><a id="l279"></a><a href="#l279">279</a><td> *<tr><td><a id="l280"></a><a href="#l280">280</a><td> *       flow.execute(() =&gt; console.log(&#39;F&#39;));<tr><td><a id="l281"></a><a href="#l281">281</a><td> *<tr><td><a id="l282"></a><a href="#l282">282</a><td> *       d.fulfill();<tr><td><a id="l283"></a><a href="#l283">283</a><td> *     }).then(function() {<tr><td><a id="l284"></a><a href="#l284">284</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l285"></a><a href="#l285">285</a><td> *     });<tr><td><a id="l286"></a><a href="#l286">286</a><td> *     // A<tr><td><a id="l287"></a><a href="#l287">287</a><td> *     // B<tr><td><a id="l288"></a><a href="#l288">288</a><td> *     // C<tr><td><a id="l289"></a><a href="#l289">289</a><td> *     // D<tr><td><a id="l290"></a><a href="#l290">290</a><td> *     // E<tr><td><a id="l291"></a><a href="#l291">291</a><td> *     // F<tr><td><a id="l292"></a><a href="#l292">292</a><td> *     // fin<tr><td><a id="l293"></a><a href="#l293">293</a><td> *<tr><td><a id="l294"></a><a href="#l294">294</a><td> * Even though a subtask&#39;s promised result will never resolve while the task<tr><td><a id="l295"></a><a href="#l295">295</a><td> * function is on the stack, it will be treated as a promise resolved within the<tr><td><a id="l296"></a><a href="#l296">296</a><td> * task. In all other scenarios, a task&#39;s promise behaves just like a normal<tr><td><a id="l297"></a><a href="#l297">297</a><td> * promise. In the sample below, `C/D` is loggged before `B` because the<tr><td><a id="l298"></a><a href="#l298">298</a><td> * resolution of `subtask1` interrupts the flow of the enclosing task. Within<tr><td><a id="l299"></a><a href="#l299">299</a><td> * the final subtask, `E/F` is logged in order because `subtask1` is a resolved<tr><td><a id="l300"></a><a href="#l300">300</a><td> * promise when that task runs.<tr><td><a id="l301"></a><a href="#l301">301</a><td> *<tr><td><a id="l302"></a><a href="#l302">302</a><td> *     flow.execute(function() {<tr><td><a id="l303"></a><a href="#l303">303</a><td> *       var subtask1 = flow.execute(() =&gt; console.log(&#39;A&#39;));<tr><td><a id="l304"></a><a href="#l304">304</a><td> *       var subtask2 = flow.execute(() =&gt; console.log(&#39;B&#39;));<tr><td><a id="l305"></a><a href="#l305">305</a><td> *<tr><td><a id="l306"></a><a href="#l306">306</a><td> *       subtask1.then(() =&gt; console.log(&#39;C&#39;));<tr><td><a id="l307"></a><a href="#l307">307</a><td> *       subtask1.then(() =&gt; console.log(&#39;D&#39;));<tr><td><a id="l308"></a><a href="#l308">308</a><td> *<tr><td><a id="l309"></a><a href="#l309">309</a><td> *       flow.execute(function() {<tr><td><a id="l310"></a><a href="#l310">310</a><td> *         flow.execute(() =&gt; console.log(&#39;E&#39;));<tr><td><a id="l311"></a><a href="#l311">311</a><td> *         subtask1.then(() =&gt; console.log(&#39;F&#39;));<tr><td><a id="l312"></a><a href="#l312">312</a><td> *       });<tr><td><a id="l313"></a><a href="#l313">313</a><td> *     }).then(function() {<tr><td><a id="l314"></a><a href="#l314">314</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l315"></a><a href="#l315">315</a><td> *     });<tr><td><a id="l316"></a><a href="#l316">316</a><td> *     // A<tr><td><a id="l317"></a><a href="#l317">317</a><td> *     // C<tr><td><a id="l318"></a><a href="#l318">318</a><td> *     // D<tr><td><a id="l319"></a><a href="#l319">319</a><td> *     // B<tr><td><a id="l320"></a><a href="#l320">320</a><td> *     // E<tr><td><a id="l321"></a><a href="#l321">321</a><td> *     // F<tr><td><a id="l322"></a><a href="#l322">322</a><td> *     // fin<tr><td><a id="l323"></a><a href="#l323">323</a><td> *<tr><td><a id="l324"></a><a href="#l324">324</a><td> * __Note__: while the ControlFlow will wait for<tr><td><a id="l325"></a><a href="#l325">325</a><td> * {@linkplain webdriver.promise.ControlFlow#execute tasks} and<tr><td><a id="l326"></a><a href="#l326">326</a><td> * {@linkplain webdriver.promise.Promise#then callbacks} to complete, it<tr><td><a id="l327"></a><a href="#l327">327</a><td> * _will not_ wait for unresolved promises created within a task:<tr><td><a id="l328"></a><a href="#l328">328</a><td> *<tr><td><a id="l329"></a><a href="#l329">329</a><td> *     flow.execute(function() {<tr><td><a id="l330"></a><a href="#l330">330</a><td> *       var p = new promise.Promise(function(fulfill) {<tr><td><a id="l331"></a><a href="#l331">331</a><td> *         setTimeout(fulfill, 100);<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> *       p.then(() =&gt; console.log(&#39;promise resolved!&#39;));<tr><td><a id="l335"></a><a href="#l335">335</a><td> *<tr><td><a id="l336"></a><a href="#l336">336</a><td> *     }).then(function() {<tr><td><a id="l337"></a><a href="#l337">337</a><td> *       console.log(&#39;task complete!&#39;);<tr><td><a id="l338"></a><a href="#l338">338</a><td> *     });<tr><td><a id="l339"></a><a href="#l339">339</a><td> *     // task complete!<tr><td><a id="l340"></a><a href="#l340">340</a><td> *     // promise resolved!<tr><td><a id="l341"></a><a href="#l341">341</a><td> *<tr><td><a id="l342"></a><a href="#l342">342</a><td> * Finally, consider the following:<tr><td><a id="l343"></a><a href="#l343">343</a><td> *<tr><td><a id="l344"></a><a href="#l344">344</a><td> *     var d = promise.defer();<tr><td><a id="l345"></a><a href="#l345">345</a><td> *     d.promise.then(() =&gt; console.log(&#39;A&#39;));<tr><td><a id="l346"></a><a href="#l346">346</a><td> *     d.promise.then(() =&gt; console.log(&#39;B&#39;));<tr><td><a id="l347"></a><a href="#l347">347</a><td> *<tr><td><a id="l348"></a><a href="#l348">348</a><td> *     flow.execute(function() {<tr><td><a id="l349"></a><a href="#l349">349</a><td> *       flow.execute(  () =&gt; console.log(&#39;C&#39;));<tr><td><a id="l350"></a><a href="#l350">350</a><td> *       d.promise.then(() =&gt; console.log(&#39;D&#39;));<tr><td><a id="l351"></a><a href="#l351">351</a><td> *<tr><td><a id="l352"></a><a href="#l352">352</a><td> *       flow.execute(  () =&gt; console.log(&#39;E&#39;));<tr><td><a id="l353"></a><a href="#l353">353</a><td> *       d.promise.then(() =&gt; console.log(&#39;F&#39;));<tr><td><a id="l354"></a><a href="#l354">354</a><td> *<tr><td><a id="l355"></a><a href="#l355">355</a><td> *       d.fulfill();<tr><td><a id="l356"></a><a href="#l356">356</a><td> *<tr><td><a id="l357"></a><a href="#l357">357</a><td> *       flow.execute(  () =&gt; console.log(&#39;G&#39;));<tr><td><a id="l358"></a><a href="#l358">358</a><td> *       d.promise.then(() =&gt; console.log(&#39;H&#39;));<tr><td><a id="l359"></a><a href="#l359">359</a><td> *     }).then(function() {<tr><td><a id="l360"></a><a href="#l360">360</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l361"></a><a href="#l361">361</a><td> *     });<tr><td><a id="l362"></a><a href="#l362">362</a><td> *     // A<tr><td><a id="l363"></a><a href="#l363">363</a><td> *     // B<tr><td><a id="l364"></a><a href="#l364">364</a><td> *     // C<tr><td><a id="l365"></a><a href="#l365">365</a><td> *     // D<tr><td><a id="l366"></a><a href="#l366">366</a><td> *     // E<tr><td><a id="l367"></a><a href="#l367">367</a><td> *     // F<tr><td><a id="l368"></a><a href="#l368">368</a><td> *     // G<tr><td><a id="l369"></a><a href="#l369">369</a><td> *     // H<tr><td><a id="l370"></a><a href="#l370">370</a><td> *     // fin<tr><td><a id="l371"></a><a href="#l371">371</a><td> *<tr><td><a id="l372"></a><a href="#l372">372</a><td> * In this example, callbacks are registered on `d.promise` both before and<tr><td><a id="l373"></a><a href="#l373">373</a><td> * during the invocation of the task function. When `d.fulfill()` is called,<tr><td><a id="l374"></a><a href="#l374">374</a><td> * the callbacks registered before the task (`A` &amp; `B`) are registered as<tr><td><a id="l375"></a><a href="#l375">375</a><td> * interrupts. The remaining callbacks were all attached within the task and<tr><td><a id="l376"></a><a href="#l376">376</a><td> * are scheduled in the flow as standard tasks.<tr><td><a id="l377"></a><a href="#l377">377</a><td> *<tr><td><a id="l378"></a><a href="#l378">378</a><td> * ## Generator Support<tr><td><a id="l379"></a><a href="#l379">379</a><td> *<tr><td><a id="l380"></a><a href="#l380">380</a><td> * [Generators][GF] may be scheduled as tasks within a control flow or attached<tr><td><a id="l381"></a><a href="#l381">381</a><td> * as callbacks to a promise. Each time the generator yields a promise, the<tr><td><a id="l382"></a><a href="#l382">382</a><td> * control flow will wait for that promise to settle before executing the next<tr><td><a id="l383"></a><a href="#l383">383</a><td> * iteration of the generator. The yielded promise&#39;s fulfilled value will be<tr><td><a id="l384"></a><a href="#l384">384</a><td> * passed back into the generator:<tr><td><a id="l385"></a><a href="#l385">385</a><td> *<tr><td><a id="l386"></a><a href="#l386">386</a><td> *     flow.execute(function* () {<tr><td><a id="l387"></a><a href="#l387">387</a><td> *       var d = promise.defer();<tr><td><a id="l388"></a><a href="#l388">388</a><td> *<tr><td><a id="l389"></a><a href="#l389">389</a><td> *       setTimeout(() =&gt; console.log(&#39;...waiting...&#39;), 25);<tr><td><a id="l390"></a><a href="#l390">390</a><td> *       setTimeout(() =&gt; d.fulfill(123), 50);<tr><td><a id="l391"></a><a href="#l391">391</a><td> *<tr><td><a id="l392"></a><a href="#l392">392</a><td> *       console.log(&#39;start: &#39; + Date.now());<tr><td><a id="l393"></a><a href="#l393">393</a><td> *<tr><td><a id="l394"></a><a href="#l394">394</a><td> *       var value = yield d.promise;<tr><td><a id="l395"></a><a href="#l395">395</a><td> *       console.log(&#39;mid: %d; value = %d&#39;, Date.now(), value);<tr><td><a id="l396"></a><a href="#l396">396</a><td> *<tr><td><a id="l397"></a><a href="#l397">397</a><td> *       yield promise.delayed(10);<tr><td><a id="l398"></a><a href="#l398">398</a><td> *       console.log(&#39;end: &#39; + Date.now());<tr><td><a id="l399"></a><a href="#l399">399</a><td> *     }).then(function() {<tr><td><a id="l400"></a><a href="#l400">400</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l401"></a><a href="#l401">401</a><td> *     });<tr><td><a id="l402"></a><a href="#l402">402</a><td> *     // start: 0<tr><td><a id="l403"></a><a href="#l403">403</a><td> *     // ...waiting...<tr><td><a id="l404"></a><a href="#l404">404</a><td> *     // mid: 50; value = 123<tr><td><a id="l405"></a><a href="#l405">405</a><td> *     // end: 60<tr><td><a id="l406"></a><a href="#l406">406</a><td> *     // fin<tr><td><a id="l407"></a><a href="#l407">407</a><td> *<tr><td><a id="l408"></a><a href="#l408">408</a><td> * Yielding the result of a promise chain will wait for the entire chain to<tr><td><a id="l409"></a><a href="#l409">409</a><td> * complete:<tr><td><a id="l410"></a><a href="#l410">410</a><td> *<tr><td><a id="l411"></a><a href="#l411">411</a><td> *     promise.fulfilled().then(function* () {<tr><td><a id="l412"></a><a href="#l412">412</a><td> *       console.log(&#39;start: &#39; + Date.now());<tr><td><a id="l413"></a><a href="#l413">413</a><td> *<tr><td><a id="l414"></a><a href="#l414">414</a><td> *       var value = yield flow.<tr><td><a id="l415"></a><a href="#l415">415</a><td> *           execute(() =&gt; console.log(&#39;A&#39;)).<tr><td><a id="l416"></a><a href="#l416">416</a><td> *           then(   () =&gt; console.log(&#39;B&#39;)).<tr><td><a id="l417"></a><a href="#l417">417</a><td> *           then(   () =&gt; 123);<tr><td><a id="l418"></a><a href="#l418">418</a><td> *<tr><td><a id="l419"></a><a href="#l419">419</a><td> *       console.log(&#39;mid: %s; value = %d&#39;, Date.now(), 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> *       yield flow.execute(() =&gt; console.log(&#39;C&#39;));<tr><td><a id="l422"></a><a href="#l422">422</a><td> *     }).then(function() {<tr><td><a id="l423"></a><a href="#l423">423</a><td> *       console.log(&#39;fin&#39;);<tr><td><a id="l424"></a><a href="#l424">424</a><td> *     });<tr><td><a id="l425"></a><a href="#l425">425</a><td> *     // start: 0<tr><td><a id="l426"></a><a href="#l426">426</a><td> *     // A<tr><td><a id="l427"></a><a href="#l427">427</a><td> *     // B<tr><td><a id="l428"></a><a href="#l428">428</a><td> *     // mid: 2; value = 123<tr><td><a id="l429"></a><a href="#l429">429</a><td> *     // C<tr><td><a id="l430"></a><a href="#l430">430</a><td> *     // fin<tr><td><a id="l431"></a><a href="#l431">431</a><td> *<tr><td><a id="l432"></a><a href="#l432">432</a><td> * Yielding a _rejected_ promise will cause the rejected value to be thrown<tr><td><a id="l433"></a><a href="#l433">433</a><td> * within the generator function:<tr><td><a id="l434"></a><a href="#l434">434</a><td> *<tr><td><a id="l435"></a><a href="#l435">435</a><td> *     flow.execute(function* () {<tr><td><a id="l436"></a><a href="#l436">436</a><td> *       console.log(&#39;start: &#39; + Date.now());<tr><td><a id="l437"></a><a href="#l437">437</a><td> *       try {<tr><td><a id="l438"></a><a href="#l438">438</a><td> *         yield promise.delayed(10).then(function() {<tr><td><a id="l439"></a><a href="#l439">439</a><td> *           throw Error(&#39;boom&#39;);<tr><td><a id="l440"></a><a href="#l440">440</a><td> *         });<tr><td><a id="l441"></a><a href="#l441">441</a><td> *       } catch (ex) {<tr><td><a id="l442"></a><a href="#l442">442</a><td> *         console.log(&#39;caught time: &#39; + Date.now());<tr><td><a id="l443"></a><a href="#l443">443</a><td> *         console.log(ex.message);<tr><td><a id="l444"></a><a href="#l444">444</a><td> *       }<tr><td><a id="l445"></a><a href="#l445">445</a><td> *     });<tr><td><a id="l446"></a><a href="#l446">446</a><td> *     // start: 0<tr><td><a id="l447"></a><a href="#l447">447</a><td> *     // caught time: 10<tr><td><a id="l448"></a><a href="#l448">448</a><td> *     // boom<tr><td><a id="l449"></a><a href="#l449">449</a><td> *<tr><td><a id="l450"></a><a href="#l450">450</a><td> * # Error Handling<tr><td><a id="l451"></a><a href="#l451">451</a><td> *<tr><td><a id="l452"></a><a href="#l452">452</a><td> * ES6 promises do not require users to handle a promise rejections. This can<tr><td><a id="l453"></a><a href="#l453">453</a><td> * result in subtle bugs as the rejections are silently &quot;swallowed&quot; by the<tr><td><a id="l454"></a><a href="#l454">454</a><td> * Promise class.<tr><td><a id="l455"></a><a href="#l455">455</a><td> *<tr><td><a id="l456"></a><a href="#l456">456</a><td> *     Promise.reject(Error(&#39;boom&#39;));<tr><td><a id="l457"></a><a href="#l457">457</a><td> *     // ... *crickets* ...<tr><td><a id="l458"></a><a href="#l458">458</a><td> *<tr><td><a id="l459"></a><a href="#l459">459</a><td> * Selenium&#39;s {@link webdriver.promise promise} module, on the other hand,<tr><td><a id="l460"></a><a href="#l460">460</a><td> * requires that every rejection be explicitly handled. When a<tr><td><a id="l461"></a><a href="#l461">461</a><td> * {@linkplain webdriver.promise.Promise Promise} is rejected and no callbacks<tr><td><a id="l462"></a><a href="#l462">462</a><td> * are defined on that promise, it is considered an _unhandled rejection_ and<tr><td><a id="l463"></a><a href="#l463">463</a><td> * reproted to the active task queue. If the rejection remains unhandled after<tr><td><a id="l464"></a><a href="#l464">464</a><td> * a single turn of the [event loop][JSEL] (scheduled with a micro-task), it<tr><td><a id="l465"></a><a href="#l465">465</a><td> * will propagate up the stack.<tr><td><a id="l466"></a><a href="#l466">466</a><td> *<tr><td><a id="l467"></a><a href="#l467">467</a><td> * ## Error Propagation<tr><td><a id="l468"></a><a href="#l468">468</a><td> *<tr><td><a id="l469"></a><a href="#l469">469</a><td> * If an unhandled rejection occurs within a task function, that task&#39;s promised<tr><td><a id="l470"></a><a href="#l470">470</a><td> * result is rejected and all remaining subtasks are discarded:<tr><td><a id="l471"></a><a href="#l471">471</a><td> *<tr><td><a id="l472"></a><a href="#l472">472</a><td> *     flow.execute(function() {<tr><td><a id="l473"></a><a href="#l473">473</a><td> *       // No callbacks registered on promise -&gt; unhandled rejection<tr><td><a id="l474"></a><a href="#l474">474</a><td> *       promise.rejected(Error(&#39;boom&#39;));<tr><td><a id="l475"></a><a href="#l475">475</a><td> *       flow.execute(function() { console.log(&#39;this will never run&#39;); });<tr><td><a id="l476"></a><a href="#l476">476</a><td> *     }).thenCatch(function(e) {<tr><td><a id="l477"></a><a href="#l477">477</a><td> *       console.log(e.message);<tr><td><a id="l478"></a><a href="#l478">478</a><td> *     });<tr><td><a id="l479"></a><a href="#l479">479</a><td> *     // boom<tr><td><a id="l480"></a><a href="#l480">480</a><td> *<tr><td><a id="l481"></a><a href="#l481">481</a><td> * The promised results for discarded tasks are silently rejected with a<tr><td><a id="l482"></a><a href="#l482">482</a><td> * cancellation error and existing callback chains will never fire.<tr><td><a id="l483"></a><a href="#l483">483</a><td> *<tr><td><a id="l484"></a><a href="#l484">484</a><td> *     flow.execute(function() {<tr><td><a id="l485"></a><a href="#l485">485</a><td> *       promise.rejected(Error(&#39;boom&#39;));<tr><td><a id="l486"></a><a href="#l486">486</a><td> *       flow.execute(function() { console.log(&#39;a&#39;); }).<tr><td><a id="l487"></a><a href="#l487">487</a><td> *           then(function() { console.log(&#39;b&#39;); });<tr><td><a id="l488"></a><a href="#l488">488</a><td> *     }).thenCatch(function(e) {<tr><td><a id="l489"></a><a href="#l489">489</a><td> *       console.log(e.message);<tr><td><a id="l490"></a><a href="#l490">490</a><td> *     });<tr><td><a id="l491"></a><a href="#l491">491</a><td> *     // boom<tr><td><a id="l492"></a><a href="#l492">492</a><td> *<tr><td><a id="l493"></a><a href="#l493">493</a><td> * An unhandled rejection takes precedence over a task function&#39;s returned<tr><td><a id="l494"></a><a href="#l494">494</a><td> * result, even if that value is another promise:<tr><td><a id="l495"></a><a href="#l495">495</a><td> *<tr><td><a id="l496"></a><a href="#l496">496</a><td> *     flow.execute(function() {<tr><td><a id="l497"></a><a href="#l497">497</a><td> *       promise.rejected(Error(&#39;boom&#39;));<tr><td><a id="l498"></a><a href="#l498">498</a><td> *       return flow.execute(someOtherTask);<tr><td><a id="l499"></a><a href="#l499">499</a><td> *     }).thenCatch(function(e) {<tr><td><a id="l500"></a><a href="#l500">500</a><td> *       console.log(e.message);<tr><td><a id="l501"></a><a href="#l501">501</a><td> *     });<tr><td><a id="l502"></a><a href="#l502">502</a><td> *     // boom<tr><td><a id="l503"></a><a href="#l503">503</a><td> *<tr><td><a id="l504"></a><a href="#l504">504</a><td> * If there are multiple unhandled rejections within a task, they are packaged<tr><td><a id="l505"></a><a href="#l505">505</a><td> * in a {@link webdriver.promise.MultipleUnhandledRejectionError<tr><td><a id="l506"></a><a href="#l506">506</a><td> * MultipleUnhandledRejectionError}, which has an `errors` property that is a<tr><td><a id="l507"></a><a href="#l507">507</a><td> * `Set` of the recorded unhandled rejections:<tr><td><a id="l508"></a><a href="#l508">508</a><td> *<tr><td><a id="l509"></a><a href="#l509">509</a><td> *     flow.execute(function() {<tr><td><a id="l510"></a><a href="#l510">510</a><td> *       promise.rejected(Error(&#39;boom1&#39;));<tr><td><a id="l511"></a><a href="#l511">511</a><td> *       promise.rejected(Error(&#39;boom2&#39;));<tr><td><a id="l512"></a><a href="#l512">512</a><td> *     }).thenCatch(function(ex) {<tr><td><a id="l513"></a><a href="#l513">513</a><td> *       console.log(ex instanceof promise.MultipleUnhandledRejectionError);<tr><td><a id="l514"></a><a href="#l514">514</a><td> *       for (var e of ex.errors) {<tr><td><a id="l515"></a><a href="#l515">515</a><td> *         console.log(e.message);<tr><td><a id="l516"></a><a href="#l516">516</a><td> *       }<tr><td><a id="l517"></a><a href="#l517">517</a><td> *     });<tr><td><a id="l518"></a><a href="#l518">518</a><td> *     // boom1<tr><td><a id="l519"></a><a href="#l519">519</a><td> *     // boom2<tr><td><a id="l520"></a><a href="#l520">520</a><td> *<tr><td><a id="l521"></a><a href="#l521">521</a><td> * When a subtask is discarded due to an unreported rejection in its parent<tr><td><a id="l522"></a><a href="#l522">522</a><td> * frame, the existing callbacks on that task will never settle and the<tr><td><a id="l523"></a><a href="#l523">523</a><td> * callbacks will not be invoked. If a new callback is attached ot the subtask<tr><td><a id="l524"></a><a href="#l524">524</a><td> * _after_ it has been discarded, it is handled the same as adding a callback<tr><td><a id="l525"></a><a href="#l525">525</a><td> * to a cancelled promise: the error-callback path is invoked. This behavior is<tr><td><a id="l526"></a><a href="#l526">526</a><td> * intended to handle cases where the user saves a reference to a task promise,<tr><td><a id="l527"></a><a href="#l527">527</a><td> * as illustrated below.<tr><td><a id="l528"></a><a href="#l528">528</a><td> *<tr><td><a id="l529"></a><a href="#l529">529</a><td> *     var subTask;<tr><td><a id="l530"></a><a href="#l530">530</a><td> *     flow.execute(function() {<tr><td><a id="l531"></a><a href="#l531">531</a><td> *       promise.rejected(Error(&#39;boom&#39;));<tr><td><a id="l532"></a><a href="#l532">532</a><td> *       subTask = flow.execute(function() {});<tr><td><a id="l533"></a><a href="#l533">533</a><td> *     }).thenCatch(function(e) {<tr><td><a id="l534"></a><a href="#l534">534</a><td> *       console.log(e.message);<tr><td><a id="l535"></a><a href="#l535">535</a><td> *     }).then(function() {<tr><td><a id="l536"></a><a href="#l536">536</a><td> *       return subTask.then(<tr><td><a id="l537"></a><a href="#l537">537</a><td> *           () =&gt; console.log(&#39;subtask success!&#39;),<tr><td><a id="l538"></a><a href="#l538">538</a><td> *           (e) =&gt; console.log(&#39;subtask failed:\n&#39; + e));<tr><td><a id="l539"></a><a href="#l539">539</a><td> *     });<tr><td><a id="l540"></a><a href="#l540">540</a><td> *     // boom<tr><td><a id="l541"></a><a href="#l541">541</a><td> *     // subtask failed:<tr><td><a id="l542"></a><a href="#l542">542</a><td> *     // DiscardedTaskError: Task was discarded due to a previous failure: boom<tr><td><a id="l543"></a><a href="#l543">543</a><td> *<tr><td><a id="l544"></a><a href="#l544">544</a><td> * When a subtask fails, its promised result is treated the same as any other<tr><td><a id="l545"></a><a href="#l545">545</a><td> * promise: it must be handled within one turn of the rejection or the unhandled<tr><td><a id="l546"></a><a href="#l546">546</a><td> * rejection is propagated to the parent task. This means users can catch errors<tr><td><a id="l547"></a><a href="#l547">547</a><td> * from complex flows from the top level task:<tr><td><a id="l548"></a><a href="#l548">548</a><td> *<tr><td><a id="l549"></a><a href="#l549">549</a><td> *     flow.execute(function() {<tr><td><a id="l550"></a><a href="#l550">550</a><td> *       flow.execute(function() {<tr><td><a id="l551"></a><a href="#l551">551</a><td> *         flow.execute(function() {<tr><td><a id="l552"></a><a href="#l552">552</a><td> *           throw Error(&#39;fail!&#39;);<tr><td><a id="l553"></a><a href="#l553">553</a><td> *         });<tr><td><a id="l554"></a><a href="#l554">554</a><td> *       });<tr><td><a id="l555"></a><a href="#l555">555</a><td> *     }).thenCatch(function(e) {<tr><td><a id="l556"></a><a href="#l556">556</a><td> *       console.log(e.message);<tr><td><a id="l557"></a><a href="#l557">557</a><td> *     });<tr><td><a id="l558"></a><a href="#l558">558</a><td> *     // fail!<tr><td><a id="l559"></a><a href="#l559">559</a><td> *<tr><td><a id="l560"></a><a href="#l560">560</a><td> * ## Unhandled Rejection Events<tr><td><a id="l561"></a><a href="#l561">561</a><td> *<tr><td><a id="l562"></a><a href="#l562">562</a><td> * When an unhandled rejection propagates to the root of the control flow, the<tr><td><a id="l563"></a><a href="#l563">563</a><td> * flow will emit an __uncaughtException__ event. If no listeners are registered<tr><td><a id="l564"></a><a href="#l564">564</a><td> * on the flow, the error will be rethrown to the global error handler: an<tr><td><a id="l565"></a><a href="#l565">565</a><td> * __uncaughtException__ event from the<tr><td><a id="l566"></a><a href="#l566">566</a><td> * [`process`](https://nodejs.org/api/process.html) object in node, or<tr><td><a id="l567"></a><a href="#l567">567</a><td> * `window.onerror` when running in a browser.<tr><td><a id="l568"></a><a href="#l568">568</a><td> *<tr><td><a id="l569"></a><a href="#l569">569</a><td> * Bottom line: you __*must*__ handle rejected promises.<tr><td><a id="l570"></a><a href="#l570">570</a><td> *<tr><td><a id="l571"></a><a href="#l571">571</a><td> * # Promise/A+ Compatibility<tr><td><a id="l572"></a><a href="#l572">572</a><td> *<tr><td><a id="l573"></a><a href="#l573">573</a><td> * This `promise` module is compliant with the [Promise/A+][] specification<tr><td><a id="l574"></a><a href="#l574">574</a><td> * except for sections `2.2.6.1` and `2.2.6.2`:<tr><td><a id="l575"></a><a href="#l575">575</a><td> *<tr><td><a id="l576"></a><a href="#l576">576</a><td> * &gt;<tr><td><a id="l577"></a><a href="#l577">577</a><td> * &gt; - `then` may be called multiple times on the same promise.<tr><td><a id="l578"></a><a href="#l578">578</a><td> * &gt;    - If/when `promise` is fulfilled, all respective `onFulfilled` callbacks<tr><td><a id="l579"></a><a href="#l579">579</a><td> * &gt;      must execute in the order of their originating calls to `then`.<tr><td><a id="l580"></a><a href="#l580">580</a><td> * &gt;    - If/when `promise` is rejected, all respective `onRejected` callbacks<tr><td><a id="l581"></a><a href="#l581">581</a><td> * &gt;      must execute in the order of their originating calls to `then`.<tr><td><a id="l582"></a><a href="#l582">582</a><td> * &gt;<tr><td><a id="l583"></a><a href="#l583">583</a><td> *<tr><td><a id="l584"></a><a href="#l584">584</a><td> * Specifically, the conformance tests contains the following scenario (for<tr><td><a id="l585"></a><a href="#l585">585</a><td> * brevity, only the fulfillment version is shown):<tr><td><a id="l586"></a><a href="#l586">586</a><td> *<tr><td><a id="l587"></a><a href="#l587">587</a><td> *     var p1 = Promise.resolve();<tr><td><a id="l588"></a><a href="#l588">588</a><td> *     p1.then(function() {<tr><td><a id="l589"></a><a href="#l589">589</a><td> *       console.log(&#39;A&#39;);<tr><td><a id="l590"></a><a href="#l590">590</a><td> *       p1.then(() =&gt; console.log(&#39;B&#39;));<tr><td><a id="l591"></a><a href="#l591">591</a><td> *     });<tr><td><a id="l592"></a><a href="#l592">592</a><td> *     p1.then(() =&gt; console.log(&#39;C&#39;));<tr><td><a id="l593"></a><a href="#l593">593</a><td> *     // A<tr><td><a id="l594"></a><a href="#l594">594</a><td> *     // C<tr><td><a id="l595"></a><a href="#l595">595</a><td> *     // B<tr><td><a id="l596"></a><a href="#l596">596</a><td> *<tr><td><a id="l597"></a><a href="#l597">597</a><td> * Since the [ControlFlow](#scheduling_callbacks) executes promise callbacks as<tr><td><a id="l598"></a><a href="#l598">598</a><td> * tasks, with this module, the result would be<tr><td><a id="l599"></a><a href="#l599">599</a><td> *<tr><td><a id="l600"></a><a href="#l600">600</a><td> *     var p2 = promise.fulfilled();<tr><td><a id="l601"></a><a href="#l601">601</a><td> *     p2.then(function() {<tr><td><a id="l602"></a><a href="#l602">602</a><td> *       console.log(&#39;A&#39;);<tr><td><a id="l603"></a><a href="#l603">603</a><td> *       p2.then(() =&gt; console.log(&#39;B&#39;);<tr><td><a id="l604"></a><a href="#l604">604</a><td> *     });<tr><td><a id="l605"></a><a href="#l605">605</a><td> *     p2.then(() =&gt; console.log(&#39;C&#39;));<tr><td><a id="l606"></a><a href="#l606">606</a><td> *     // A<tr><td><a id="l607"></a><a href="#l607">607</a><td> *     // B<tr><td><a id="l608"></a><a href="#l608">608</a><td> *     // C<tr><td><a id="l609"></a><a href="#l609">609</a><td> *<tr><td><a id="l610"></a><a href="#l610">610</a><td> * [JSEL]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop<tr><td><a id="l611"></a><a href="#l611">611</a><td> * [GF]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*<tr><td><a id="l612"></a><a href="#l612">612</a><td> * [Promise/A+]: https://promisesaplus.com/<tr><td><a id="l613"></a><a href="#l613">613</a><td> */<tr><td><a id="l614"></a><a href="#l614">614</a><td><tr><td><a id="l615"></a><a href="#l615">615</a><td>goog.module(&#39;webdriver.promise&#39;);<tr><td><a id="l616"></a><a href="#l616">616</a><td>goog.module.declareLegacyNamespace();<tr><td><a id="l617"></a><a href="#l617">617</a><td><tr><td><a id="l618"></a><a href="#l618">618</a><td>var Arrays = goog.require(&#39;goog.array&#39;);<tr><td><a id="l619"></a><a href="#l619">619</a><td>var asserts = goog.require(&#39;goog.asserts&#39;);<tr><td><a id="l620"></a><a href="#l620">620</a><td>var asyncRun = goog.require(&#39;goog.async.run&#39;);<tr><td><a id="l621"></a><a href="#l621">621</a><td>var throwException = goog.require(&#39;goog.async.throwException&#39;);<tr><td><a id="l622"></a><a href="#l622">622</a><td>var DebugError = goog.require(&#39;goog.debug.Error&#39;);<tr><td><a id="l623"></a><a href="#l623">623</a><td>var log = goog.require(&#39;goog.log&#39;);<tr><td><a id="l624"></a><a href="#l624">624</a><td>var Objects = goog.require(&#39;goog.object&#39;);<tr><td><a id="l625"></a><a href="#l625">625</a><td>var EventEmitter = goog.require(&#39;webdriver.EventEmitter&#39;);<tr><td><a id="l626"></a><a href="#l626">626</a><td>var stacktrace = goog.require(&#39;webdriver.stacktrace&#39;);<tr><td><a id="l627"></a><a href="#l627">627</a><td><tr><td><a id="l628"></a><a href="#l628">628</a><td><tr><td><a id="l629"></a><a href="#l629">629</a><td><tr><td><a id="l630"></a><a href="#l630">630</a><td>/**<tr><td><a id="l631"></a><a href="#l631">631</a><td> * @define {boolean} Whether to append traces of {@code then} to rejection<tr><td><a id="l632"></a><a href="#l632">632</a><td> *     errors.<tr><td><a id="l633"></a><a href="#l633">633</a><td> */<tr><td><a id="l634"></a><a href="#l634">634</a><td>goog.define(&#39;webdriver.promise.LONG_STACK_TRACES&#39;, false);<tr><td><a id="l635"></a><a href="#l635">635</a><td><tr><td><a id="l636"></a><a href="#l636">636</a><td>/** @const */<tr><td><a id="l637"></a><a href="#l637">637</a><td>var promise = exports;<tr><td><a id="l638"></a><a href="#l638">638</a><td><tr><td><a id="l639"></a><a href="#l639">639</a><td><tr><td><a id="l640"></a><a href="#l640">640</a><td>/** @const */<tr><td><a id="l641"></a><a href="#l641">641</a><td>var LOG = log.getLogger(&#39;webdriver.promise&#39;);<tr><td><a id="l642"></a><a href="#l642">642</a><td><tr><td><a id="l643"></a><a href="#l643">643</a><td><tr><td><a id="l644"></a><a href="#l644">644</a><td>/**<tr><td><a id="l645"></a><a href="#l645">645</a><td> * @param {number} level What level of verbosity to log with.<tr><td><a id="l646"></a><a href="#l646">646</a><td> * @param {(string|function(this: T): string)} loggable The message to log.<tr><td><a id="l647"></a><a href="#l647">647</a><td> * @param {T=} opt_self The object in whose context to run the loggable<tr><td><a id="l648"></a><a href="#l648">648</a><td> *     function.<tr><td><a id="l649"></a><a href="#l649">649</a><td> * @template T<tr><td><a id="l650"></a><a href="#l650">650</a><td> */<tr><td><a id="l651"></a><a href="#l651">651</a><td>function vlog(level, loggable, opt_self) {<tr><td><a id="l652"></a><a href="#l652">652</a><td>  var logLevel = log.Level.FINE;<tr><td><a id="l653"></a><a href="#l653">653</a><td>  if (level &gt; 1) {<tr><td><a id="l654"></a><a href="#l654">654</a><td>    logLevel = log.Level.FINEST;<tr><td><a id="l655"></a><a href="#l655">655</a><td>  } else if (level &gt; 0) {<tr><td><a id="l656"></a><a href="#l656">656</a><td>    logLevel = log.Level.FINER;<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>  if (typeof loggable === &#39;function&#39;) {<tr><td><a id="l660"></a><a href="#l660">660</a><td>    loggable = loggable.bind(opt_self);<tr><td><a id="l661"></a><a href="#l661">661</a><td>  }<tr><td><a id="l662"></a><a href="#l662">662</a><td><tr><td><a id="l663"></a><a href="#l663">663</a><td>  log.log(LOG, logLevel, loggable);<tr><td><a id="l664"></a><a href="#l664">664</a><td>}<tr><td><a id="l665"></a><a href="#l665">665</a><td><tr><td><a id="l666"></a><a href="#l666">666</a><td><tr><td><a id="l667"></a><a href="#l667">667</a><td>/**<tr><td><a id="l668"></a><a href="#l668">668</a><td> * Generates an error to capture the current stack trace.<tr><td><a id="l669"></a><a href="#l669">669</a><td> * @param {string} name Error name for this stack trace.<tr><td><a id="l670"></a><a href="#l670">670</a><td> * @param {string} msg Message to record.<tr><td><a id="l671"></a><a href="#l671">671</a><td> * @param {!Function} topFn The function that should appear at the top of the<tr><td><a id="l672"></a><a href="#l672">672</a><td> *     stack; only applicable in V8.<tr><td><a id="l673"></a><a href="#l673">673</a><td> * @return {!Error} The generated error.<tr><td><a id="l674"></a><a href="#l674">674</a><td> */<tr><td><a id="l675"></a><a href="#l675">675</a><td>promise.captureStackTrace = function(name, msg, topFn) {<tr><td><a id="l676"></a><a href="#l676">676</a><td>  var e = Error(msg);<tr><td><a id="l677"></a><a href="#l677">677</a><td>  e.name = name;<tr><td><a id="l678"></a><a href="#l678">678</a><td>  if (Error.captureStackTrace) {<tr><td><a id="l679"></a><a href="#l679">679</a><td>    Error.captureStackTrace(e, topFn);<tr><td><a id="l680"></a><a href="#l680">680</a><td>  } else {<tr><td><a id="l681"></a><a href="#l681">681</a><td>    var stack = stacktrace.getStack(e);<tr><td><a id="l682"></a><a href="#l682">682</a><td>    e.stack = e.toString();<tr><td><a id="l683"></a><a href="#l683">683</a><td>    if (stack) {<tr><td><a id="l684"></a><a href="#l684">684</a><td>      e.stack += &#39;\n&#39; + stack;<tr><td><a id="l685"></a><a href="#l685">685</a><td>    }<tr><td><a id="l686"></a><a href="#l686">686</a><td>  }<tr><td><a id="l687"></a><a href="#l687">687</a><td>  return e;<tr><td><a id="l688"></a><a href="#l688">688</a><td>};<tr><td><a id="l689"></a><a href="#l689">689</a><td><tr><td><a id="l690"></a><a href="#l690">690</a><td><tr><td><a id="l691"></a><a href="#l691">691</a><td>/**<tr><td><a id="l692"></a><a href="#l692">692</a><td> * Error used when the computation of a promise is cancelled.<tr><td><a id="l693"></a><a href="#l693">693</a><td> *<tr><td><a id="l694"></a><a href="#l694">694</a><td> * @unrestricted<tr><td><a id="l695"></a><a href="#l695">695</a><td> */<tr><td><a id="l696"></a><a href="#l696">696</a><td>promise.CancellationError = goog.defineClass(DebugError, {<tr><td><a id="l697"></a><a href="#l697">697</a><td>  /**<tr><td><a id="l698"></a><a href="#l698">698</a><td>   * @param {string=} opt_msg The cancellation message.<tr><td><a id="l699"></a><a href="#l699">699</a><td>   */<tr><td><a id="l700"></a><a href="#l700">700</a><td>  constructor: function(opt_msg) {<tr><td><a id="l701"></a><a href="#l701">701</a><td>    promise.CancellationError.base(this, &#39;constructor&#39;, opt_msg);<tr><td><a id="l702"></a><a href="#l702">702</a><td><tr><td><a id="l703"></a><a href="#l703">703</a><td>    /** @override */<tr><td><a id="l704"></a><a href="#l704">704</a><td>    this.name = &#39;CancellationError&#39;;<tr><td><a id="l705"></a><a href="#l705">705</a><td><tr><td><a id="l706"></a><a href="#l706">706</a><td>    /** @private {boolean} */<tr><td><a id="l707"></a><a href="#l707">707</a><td>    this.silent_ = false;<tr><td><a id="l708"></a><a href="#l708">708</a><td>  },<tr><td><a id="l709"></a><a href="#l709">709</a><td><tr><td><a id="l710"></a><a href="#l710">710</a><td>  statics: {<tr><td><a id="l711"></a><a href="#l711">711</a><td>    /**<tr><td><a id="l712"></a><a href="#l712">712</a><td>     * Wraps the given error in a CancellationError.<tr><td><a id="l713"></a><a href="#l713">713</a><td>     *<tr><td><a id="l714"></a><a href="#l714">714</a><td>     * @param {*} error The error to wrap.<tr><td><a id="l715"></a><a href="#l715">715</a><td>     * @param {string=} opt_msg The prefix message to use.<tr><td><a id="l716"></a><a href="#l716">716</a><td>     * @return {!promise.CancellationError} A cancellation error.<tr><td><a id="l717"></a><a href="#l717">717</a><td>     */<tr><td><a id="l718"></a><a href="#l718">718</a><td>    wrap: function(error, opt_msg) {<tr><td><a id="l719"></a><a href="#l719">719</a><td>      var message;<tr><td><a id="l720"></a><a href="#l720">720</a><td>      if (error instanceof promise.CancellationError) {<tr><td><a id="l721"></a><a href="#l721">721</a><td>        return new promise.CancellationError(<tr><td><a id="l722"></a><a href="#l722">722</a><td>            opt_msg ? (opt_msg + &#39;: &#39; + error.message) : error.message);<tr><td><a id="l723"></a><a href="#l723">723</a><td>      } else if (opt_msg) {<tr><td><a id="l724"></a><a href="#l724">724</a><td>        message = opt_msg;<tr><td><a id="l725"></a><a href="#l725">725</a><td>        if (error) {<tr><td><a id="l726"></a><a href="#l726">726</a><td>          message += &#39;: &#39; + error;<tr><td><a id="l727"></a><a href="#l727">727</a><td>        }<tr><td><a id="l728"></a><a href="#l728">728</a><td>        return new promise.CancellationError(message);<tr><td><a id="l729"></a><a href="#l729">729</a><td>      }<tr><td><a id="l730"></a><a href="#l730">730</a><td>      if (error) {<tr><td><a id="l731"></a><a href="#l731">731</a><td>        message = error + &#39;&#39;;<tr><td><a id="l732"></a><a href="#l732">732</a><td>      }<tr><td><a id="l733"></a><a href="#l733">733</a><td>      return new promise.CancellationError(message);<tr><td><a id="l734"></a><a href="#l734">734</a><td>    }<tr><td><a id="l735"></a><a href="#l735">735</a><td>  }<tr><td><a id="l736"></a><a href="#l736">736</a><td>});<tr><td><a id="l737"></a><a href="#l737">737</a><td><tr><td><a id="l738"></a><a href="#l738">738</a><td><tr><td><a id="l739"></a><a href="#l739">739</a><td>/**<tr><td><a id="l740"></a><a href="#l740">740</a><td> * Error used to cancel tasks when a control flow is reset.<tr><td><a id="l741"></a><a href="#l741">741</a><td> * @unrestricted<tr><td><a id="l742"></a><a href="#l742">742</a><td> * @final<tr><td><a id="l743"></a><a href="#l743">743</a><td> */<tr><td><a id="l744"></a><a href="#l744">744</a><td>var FlowResetError = goog.defineClass(promise.CancellationError, {<tr><td><a id="l745"></a><a href="#l745">745</a><td>  constructor: function() {<tr><td><a id="l746"></a><a href="#l746">746</a><td>    FlowResetError.base(this, &#39;constructor&#39;, &#39;ControlFlow was reset&#39;);<tr><td><a id="l747"></a><a href="#l747">747</a><td><tr><td><a id="l748"></a><a href="#l748">748</a><td>    /** @override */<tr><td><a id="l749"></a><a href="#l749">749</a><td>    this.name = &#39;FlowResetError&#39;;<tr><td><a id="l750"></a><a href="#l750">750</a><td><tr><td><a id="l751"></a><a href="#l751">751</a><td>    this.silent_ = true;<tr><td><a id="l752"></a><a href="#l752">752</a><td>  }<tr><td><a id="l753"></a><a href="#l753">753</a><td>});<tr><td><a id="l754"></a><a href="#l754">754</a><td><tr><td><a id="l755"></a><a href="#l755">755</a><td><tr><td><a id="l756"></a><a href="#l756">756</a><td>/**<tr><td><a id="l757"></a><a href="#l757">757</a><td> * Error used to cancel tasks that have been discarded due to an uncaught error<tr><td><a id="l758"></a><a href="#l758">758</a><td> * reported earlier in the control flow.<tr><td><a id="l759"></a><a href="#l759">759</a><td> * @unrestricted<tr><td><a id="l760"></a><a href="#l760">760</a><td> * @final<tr><td><a id="l761"></a><a href="#l761">761</a><td> */<tr><td><a id="l762"></a><a href="#l762">762</a><td>var DiscardedTaskError = goog.defineClass(promise.CancellationError, {<tr><td><a id="l763"></a><a href="#l763">763</a><td>  /** @param {*} error The original error. */<tr><td><a id="l764"></a><a href="#l764">764</a><td>  constructor: function(error) {<tr><td><a id="l765"></a><a href="#l765">765</a><td>    if (error instanceof DiscardedTaskError) {<tr><td><a id="l766"></a><a href="#l766">766</a><td>      return /** @type {!DiscardedTaskError} */(error);<tr><td><a id="l767"></a><a href="#l767">767</a><td>    }<tr><td><a id="l768"></a><a href="#l768">768</a><td><tr><td><a id="l769"></a><a href="#l769">769</a><td>    var msg = &#39;&#39;;<tr><td><a id="l770"></a><a href="#l770">770</a><td>    if (error) {<tr><td><a id="l771"></a><a href="#l771">771</a><td>      msg = &#39;: &#39; + (typeof error.message === &#39;string&#39; ? error.message : error);<tr><td><a id="l772"></a><a href="#l772">772</a><td>    }<tr><td><a id="l773"></a><a href="#l773">773</a><td><tr><td><a id="l774"></a><a href="#l774">774</a><td>    DiscardedTaskError.base(this, &#39;constructor&#39;,<tr><td><a id="l775"></a><a href="#l775">775</a><td>        &#39;Task was discarded due to a previous failure&#39; + msg);<tr><td><a id="l776"></a><a href="#l776">776</a><td><tr><td><a id="l777"></a><a href="#l777">777</a><td>    /** @override */<tr><td><a id="l778"></a><a href="#l778">778</a><td>    this.name = &#39;DiscardedTaskError&#39;;<tr><td><a id="l779"></a><a href="#l779">779</a><td>    this.silent_ = true;<tr><td><a id="l780"></a><a href="#l780">780</a><td>  }<tr><td><a id="l781"></a><a href="#l781">781</a><td>});<tr><td><a id="l782"></a><a href="#l782">782</a><td><tr><td><a id="l783"></a><a href="#l783">783</a><td><tr><td><a id="l784"></a><a href="#l784">784</a><td>/**<tr><td><a id="l785"></a><a href="#l785">785</a><td> * Error used when there are multiple unhandled promise rejections detected<tr><td><a id="l786"></a><a href="#l786">786</a><td> * within a task or callback.<tr><td><a id="l787"></a><a href="#l787">787</a><td> *<tr><td><a id="l788"></a><a href="#l788">788</a><td> * @unrestricted<tr><td><a id="l789"></a><a href="#l789">789</a><td> * @final<tr><td><a id="l790"></a><a href="#l790">790</a><td> */<tr><td><a id="l791"></a><a href="#l791">791</a><td>promise.MultipleUnhandledRejectionError = goog.defineClass(DebugError, {<tr><td><a id="l792"></a><a href="#l792">792</a><td>  /**<tr><td><a id="l793"></a><a href="#l793">793</a><td>   * @param {!(Set&lt;*&gt;)} errors The errors to report.<tr><td><a id="l794"></a><a href="#l794">794</a><td>   */<tr><td><a id="l795"></a><a href="#l795">795</a><td>  constructor: function(errors) {<tr><td><a id="l796"></a><a href="#l796">796</a><td>    promise.MultipleUnhandledRejectionError.base(<tr><td><a id="l797"></a><a href="#l797">797</a><td>        this, &#39;constructor&#39;, &#39;Multiple unhandled promise rejections reported&#39;);<tr><td><a id="l798"></a><a href="#l798">798</a><td><tr><td><a id="l799"></a><a href="#l799">799</a><td>    /** @override */<tr><td><a id="l800"></a><a href="#l800">800</a><td>    this.name = &#39;MultipleUnhandledRejectionError&#39;;<tr><td><a id="l801"></a><a href="#l801">801</a><td><tr><td><a id="l802"></a><a href="#l802">802</a><td>    /** @type {!Set&lt;*&gt;} */<tr><td><a id="l803"></a><a href="#l803">803</a><td>    this.errors = errors;<tr><td><a id="l804"></a><a href="#l804">804</a><td>  }<tr><td><a id="l805"></a><a href="#l805">805</a><td>});<tr><td><a id="l806"></a><a href="#l806">806</a><td><tr><td><a id="l807"></a><a href="#l807">807</a><td><tr><td><a id="l808"></a><a href="#l808">808</a><td>/**<tr><td><a id="l809"></a><a href="#l809">809</a><td> * Property used to flag constructor&#39;s as implementing the Thenable interface<tr><td><a id="l810"></a><a href="#l810">810</a><td> * for runtime type checking.<tr><td><a id="l811"></a><a href="#l811">811</a><td> * @type {string}<tr><td><a id="l812"></a><a href="#l812">812</a><td> * @const<tr><td><a id="l813"></a><a href="#l813">813</a><td> */<tr><td><a id="l814"></a><a href="#l814">814</a><td>var IMPLEMENTED_BY_PROP = &#39;$webdriver_Thenable&#39;;<tr><td><a id="l815"></a><a href="#l815">815</a><td><tr><td><a id="l816"></a><a href="#l816">816</a><td><tr><td><a id="l817"></a><a href="#l817">817</a><td>/**<tr><td><a id="l818"></a><a href="#l818">818</a><td> * Thenable is a promise-like object with a {@code then} method which may be<tr><td><a id="l819"></a><a href="#l819">819</a><td> * used to schedule callbacks on a promised value.<tr><td><a id="l820"></a><a href="#l820">820</a><td> *<tr><td><a id="l821"></a><a href="#l821">821</a><td> * @interface<tr><td><a id="l822"></a><a href="#l822">822</a><td> * @extends {IThenable&lt;T&gt;}<tr><td><a id="l823"></a><a href="#l823">823</a><td> * @template T<tr><td><a id="l824"></a><a href="#l824">824</a><td> */<tr><td><a id="l825"></a><a href="#l825">825</a><td>promise.Thenable = goog.defineClass(null, {<tr><td><a id="l826"></a><a href="#l826">826</a><td>  statics: {<tr><td><a id="l827"></a><a href="#l827">827</a><td>    /**<tr><td><a id="l828"></a><a href="#l828">828</a><td>     * Adds a property to a class prototype to allow runtime checks of whether<tr><td><a id="l829"></a><a href="#l829">829</a><td>     * instances of that class implement the Thenable interface. This function<tr><td><a id="l830"></a><a href="#l830">830</a><td>     * will also ensure the prototype&#39;s {@code then} function is exported from<tr><td><a id="l831"></a><a href="#l831">831</a><td>     * compiled code.<tr><td><a id="l832"></a><a href="#l832">832</a><td>     * @param {function(new: promise.Thenable, ...?)} ctor The<tr><td><a id="l833"></a><a href="#l833">833</a><td>     *     constructor whose prototype to modify.<tr><td><a id="l834"></a><a href="#l834">834</a><td>     */<tr><td><a id="l835"></a><a href="#l835">835</a><td>    addImplementation: function(ctor) {<tr><td><a id="l836"></a><a href="#l836">836</a><td>      // Based on goog.promise.Thenable.isImplementation.<tr><td><a id="l837"></a><a href="#l837">837</a><td>      ctor.prototype[&#39;then&#39;] = ctor.prototype.then;<tr><td><a id="l838"></a><a href="#l838">838</a><td>      try {<tr><td><a id="l839"></a><a href="#l839">839</a><td>        // Old IE7 does not support defineProperty; IE8 only supports it for<tr><td><a id="l840"></a><a href="#l840">840</a><td>        // DOM elements.<tr><td><a id="l841"></a><a href="#l841">841</a><td>        Object.defineProperty(<tr><td><a id="l842"></a><a href="#l842">842</a><td>          ctor.prototype,<tr><td><a id="l843"></a><a href="#l843">843</a><td>          IMPLEMENTED_BY_PROP,<tr><td><a id="l844"></a><a href="#l844">844</a><td>          {&#39;value&#39;: true, &#39;enumerable&#39;: false});<tr><td><a id="l845"></a><a href="#l845">845</a><td>      } catch (ex) {<tr><td><a id="l846"></a><a href="#l846">846</a><td>        ctor.prototype[IMPLEMENTED_BY_PROP] = true;<tr><td><a id="l847"></a><a href="#l847">847</a><td>      }<tr><td><a id="l848"></a><a href="#l848">848</a><td>    },<tr><td><a id="l849"></a><a href="#l849">849</a><td><tr><td><a id="l850"></a><a href="#l850">850</a><td>    /**<tr><td><a id="l851"></a><a href="#l851">851</a><td>     * Checks if an object has been tagged for implementing the Thenable<tr><td><a id="l852"></a><a href="#l852">852</a><td>     * interface as defined by<tr><td><a id="l853"></a><a href="#l853">853</a><td>     * {@link webdriver.promise.Thenable.addImplementation}.<tr><td><a id="l854"></a><a href="#l854">854</a><td>     * @param {*} object The object to test.<tr><td><a id="l855"></a><a href="#l855">855</a><td>     * @return {boolean} Whether the object is an implementation of the Thenable<tr><td><a id="l856"></a><a href="#l856">856</a><td>     *     interface.<tr><td><a id="l857"></a><a href="#l857">857</a><td>     */<tr><td><a id="l858"></a><a href="#l858">858</a><td>    isImplementation: function(object) {<tr><td><a id="l859"></a><a href="#l859">859</a><td>      // Based on goog.promise.Thenable.isImplementation.<tr><td><a id="l860"></a><a href="#l860">860</a><td>      if (!object) {<tr><td><a id="l861"></a><a href="#l861">861</a><td>        return false;<tr><td><a id="l862"></a><a href="#l862">862</a><td>      }<tr><td><a id="l863"></a><a href="#l863">863</a><td>      try {<tr><td><a id="l864"></a><a href="#l864">864</a><td>        return !!object[IMPLEMENTED_BY_PROP];<tr><td><a id="l865"></a><a href="#l865">865</a><td>      } catch (e) {<tr><td><a id="l866"></a><a href="#l866">866</a><td>        return false;  // Property access seems to be forbidden.<tr><td><a id="l867"></a><a href="#l867">867</a><td>      }<tr><td><a id="l868"></a><a href="#l868">868</a><td>    }<tr><td><a id="l869"></a><a href="#l869">869</a><td>  },<tr><td><a id="l870"></a><a href="#l870">870</a><td><tr><td><a id="l871"></a><a href="#l871">871</a><td>  /**<tr><td><a id="l872"></a><a href="#l872">872</a><td>   * Cancels the computation of this promise&#39;s value, rejecting the promise in<tr><td><a id="l873"></a><a href="#l873">873</a><td>   * the process. This method is a no-op if the promise has already been<tr><td><a id="l874"></a><a href="#l874">874</a><td>   * resolved.<tr><td><a id="l875"></a><a href="#l875">875</a><td>   *<tr><td><a id="l876"></a><a href="#l876">876</a><td>   * @param {(string|promise.CancellationError)=} opt_reason The reason this<tr><td><a id="l877"></a><a href="#l877">877</a><td>   *     promise is being cancelled.<tr><td><a id="l878"></a><a href="#l878">878</a><td>   */<tr><td><a id="l879"></a><a href="#l879">879</a><td>  cancel: function(opt_reason) {},<tr><td><a id="l880"></a><a href="#l880">880</a><td><tr><td><a id="l881"></a><a href="#l881">881</a><td>  /** @return {boolean} Whether this promise&#39;s value is still being computed. */<tr><td><a id="l882"></a><a href="#l882">882</a><td>  isPending: function() {},<tr><td><a id="l883"></a><a href="#l883">883</a><td><tr><td><a id="l884"></a><a href="#l884">884</a><td>  /**<tr><td><a id="l885"></a><a href="#l885">885</a><td>   * Registers listeners for when this instance is resolved.<tr><td><a id="l886"></a><a href="#l886">886</a><td>   *<tr><td><a id="l887"></a><a href="#l887">887</a><td>   * @param {?(function(T): (R|IThenable&lt;R&gt;))=} opt_callback The<tr><td><a id="l888"></a><a href="#l888">888</a><td>   *     function to call if this promise is successfully resolved. The function<tr><td><a id="l889"></a><a href="#l889">889</a><td>   *     should expect a single argument: the promise&#39;s resolved value.<tr><td><a id="l890"></a><a href="#l890">890</a><td>   * @param {?(function(*): (R|IThenable&lt;R&gt;))=} opt_errback<tr><td><a id="l891"></a><a href="#l891">891</a><td>   *     The function to call if this promise is rejected. The function should<tr><td><a id="l892"></a><a href="#l892">892</a><td>   *     expect a single argument: the rejection reason.<tr><td><a id="l893"></a><a href="#l893">893</a><td>   * @return {!promise.Promise&lt;R&gt;} A new promise which will be<tr><td><a id="l894"></a><a href="#l894">894</a><td>   *     resolved with the result of the invoked callback.<tr><td><a id="l895"></a><a href="#l895">895</a><td>   * @template R<tr><td><a id="l896"></a><a href="#l896">896</a><td>   */<tr><td><a id="l897"></a><a href="#l897">897</a><td>  then: function(opt_callback, opt_errback) {},<tr><td><a id="l898"></a><a href="#l898">898</a><td><tr><td><a id="l899"></a><a href="#l899">899</a><td>  /**<tr><td><a id="l900"></a><a href="#l900">900</a><td>   * Registers a listener for when this promise is rejected. This is synonymous<tr><td><a id="l901"></a><a href="#l901">901</a><td>   * with the {@code catch} clause in a synchronous API:<tr><td><a id="l902"></a><a href="#l902">902</a><td>   *<tr><td><a id="l903"></a><a href="#l903">903</a><td>   *     // Synchronous API:<tr><td><a id="l904"></a><a href="#l904">904</a><td>   *     try {<tr><td><a id="l905"></a><a href="#l905">905</a><td>   *       doSynchronousWork();<tr><td><a id="l906"></a><a href="#l906">906</a><td>   *     } catch (ex) {<tr><td><a id="l907"></a><a href="#l907">907</a><td>   *       console.error(ex);<tr><td><a id="l908"></a><a href="#l908">908</a><td>   *     }<tr><td><a id="l909"></a><a href="#l909">909</a><td>   *<tr><td><a id="l910"></a><a href="#l910">910</a><td>   *     // Asynchronous promise API:<tr><td><a id="l911"></a><a href="#l911">911</a><td>   *     doAsynchronousWork().thenCatch(function(ex) {<tr><td><a id="l912"></a><a href="#l912">912</a><td>   *       console.error(ex);<tr><td><a id="l913"></a><a href="#l913">913</a><td>   *     });<tr><td><a id="l914"></a><a href="#l914">914</a><td>   *<tr><td><a id="l915"></a><a href="#l915">915</a><td>   * @param {function(*): (R|IThenable&lt;R&gt;)} errback The<tr><td><a id="l916"></a><a href="#l916">916</a><td>   *     function to call if this promise is rejected. The function should<tr><td><a id="l917"></a><a href="#l917">917</a><td>   *     expect a single argument: the rejection reason.<tr><td><a id="l918"></a><a href="#l918">918</a><td>   * @return {!promise.Promise&lt;R&gt;} A new promise which will be<tr><td><a id="l919"></a><a href="#l919">919</a><td>   *     resolved with the result of the invoked callback.<tr><td><a id="l920"></a><a href="#l920">920</a><td>   * @template R<tr><td><a id="l921"></a><a href="#l921">921</a><td>   */<tr><td><a id="l922"></a><a href="#l922">922</a><td>  thenCatch: function(errback) {},<tr><td><a id="l923"></a><a href="#l923">923</a><td><tr><td><a id="l924"></a><a href="#l924">924</a><td>  /**<tr><td><a id="l925"></a><a href="#l925">925</a><td>   * Registers a listener to invoke when this promise is resolved, regardless<tr><td><a id="l926"></a><a href="#l926">926</a><td>   * of whether the promise&#39;s value was successfully computed. This function<tr><td><a id="l927"></a><a href="#l927">927</a><td>   * is synonymous with the {@code finally} clause in a synchronous API:<tr><td><a id="l928"></a><a href="#l928">928</a><td>   *<tr><td><a id="l929"></a><a href="#l929">929</a><td>   *     // Synchronous API:<tr><td><a id="l930"></a><a href="#l930">930</a><td>   *     try {<tr><td><a id="l931"></a><a href="#l931">931</a><td>   *       doSynchronousWork();<tr><td><a id="l932"></a><a href="#l932">932</a><td>   *     } finally {<tr><td><a id="l933"></a><a href="#l933">933</a><td>   *       cleanUp();<tr><td><a id="l934"></a><a href="#l934">934</a><td>   *     }<tr><td><a id="l935"></a><a href="#l935">935</a><td>   *<tr><td><a id="l936"></a><a href="#l936">936</a><td>   *     // Asynchronous promise API:<tr><td><a id="l937"></a><a href="#l937">937</a><td>   *     doAsynchronousWork().thenFinally(cleanUp);<tr><td><a id="l938"></a><a href="#l938">938</a><td>   *<tr><td><a id="l939"></a><a href="#l939">939</a><td>   * __Note:__ similar to the {@code finally} clause, if the registered<tr><td><a id="l940"></a><a href="#l940">940</a><td>   * callback returns a rejected promise or throws an error, it will silently<tr><td><a id="l941"></a><a href="#l941">941</a><td>   * replace the rejection error (if any) from this promise:<tr><td><a id="l942"></a><a href="#l942">942</a><td>   *<tr><td><a id="l943"></a><a href="#l943">943</a><td>   *     try {<tr><td><a id="l944"></a><a href="#l944">944</a><td>   *       throw Error(&#39;one&#39;);<tr><td><a id="l945"></a><a href="#l945">945</a><td>   *     } finally {<tr><td><a id="l946"></a><a href="#l946">946</a><td>   *       throw Error(&#39;two&#39;);  // Hides Error: one<tr><td><a id="l947"></a><a href="#l947">947</a><td>   *     }<tr><td><a id="l948"></a><a href="#l948">948</a><td>   *<tr><td><a id="l949"></a><a href="#l949">949</a><td>   *     promise.rejected(Error(&#39;one&#39;))<tr><td><a id="l950"></a><a href="#l950">950</a><td>   *         .thenFinally(function() {<tr><td><a id="l951"></a><a href="#l951">951</a><td>   *           throw Error(&#39;two&#39;);  // Hides Error: one<tr><td><a id="l952"></a><a href="#l952">952</a><td>   *         });<tr><td><a id="l953"></a><a href="#l953">953</a><td>   *<tr><td><a id="l954"></a><a href="#l954">954</a><td>   * @param {function(): (R|IThenable&lt;R&gt;)} callback The function<tr><td><a id="l955"></a><a href="#l955">955</a><td>   *     to call when this promise is resolved.<tr><td><a id="l956"></a><a href="#l956">956</a><td>   * @return {!promise.Promise&lt;R&gt;} A promise that will be fulfilled<tr><td><a id="l957"></a><a href="#l957">957</a><td>   *     with the callback result.<tr><td><a id="l958"></a><a href="#l958">958</a><td>   * @template R<tr><td><a id="l959"></a><a href="#l959">959</a><td>   */<tr><td><a id="l960"></a><a href="#l960">960</a><td>  thenFinally: function(callback) {}<tr><td><a id="l961"></a><a href="#l961">961</a><td>});<tr><td><a id="l962"></a><a href="#l962">962</a><td><tr><td><a id="l963"></a><a href="#l963">963</a><td><tr><td><a id="l964"></a><a href="#l964">964</a><td><tr><td><a id="l965"></a><a href="#l965">965</a><td>/**<tr><td><a id="l966"></a><a href="#l966">966</a><td> * @enum {string}<tr><td><a id="l967"></a><a href="#l967">967</a><td> */<tr><td><a id="l968"></a><a href="#l968">968</a><td>var PromiseState = {<tr><td><a id="l969"></a><a href="#l969">969</a><td>  PENDING: &#39;pending&#39;,<tr><td><a id="l970"></a><a href="#l970">970</a><td>  BLOCKED: &#39;blocked&#39;,<tr><td><a id="l971"></a><a href="#l971">971</a><td>  REJECTED: &#39;rejected&#39;,<tr><td><a id="l972"></a><a href="#l972">972</a><td>  FULFILLED: &#39;fulfilled&#39;<tr><td><a id="l973"></a><a href="#l973">973</a><td>};<tr><td><a id="l974"></a><a href="#l974">974</a><td><tr><td><a id="l975"></a><a href="#l975">975</a><td><tr><td><a id="l976"></a><a href="#l976">976</a><td>/**<tr><td><a id="l977"></a><a href="#l977">977</a><td> * Internal symbol used to store a cancellation handler for<tr><td><a id="l978"></a><a href="#l978">978</a><td> * {@link promise.Promise} objects. This is an internal implementation detail<tr><td><a id="l979"></a><a href="#l979">979</a><td> * used by the {@link TaskQueue} class to monitor for when a promise is<tr><td><a id="l980"></a><a href="#l980">980</a><td> * cancelled without generating an extra promise via then().<tr><td><a id="l981"></a><a href="#l981">981</a><td> */<tr><td><a id="l982"></a><a href="#l982">982</a><td>var CANCEL_HANDLER_SYMBOL = Symbol(&#39;on cancel&#39;);<tr><td><a id="l983"></a><a href="#l983">983</a><td><tr><td><a id="l984"></a><a href="#l984">984</a><td><tr><td><a id="l985"></a><a href="#l985">985</a><td>/**<tr><td><a id="l986"></a><a href="#l986">986</a><td> * Represents the eventual value of a completed operation. Each promise may be<tr><td><a id="l987"></a><a href="#l987">987</a><td> * in one of three states: pending, fulfilled, or rejected. Each promise starts<tr><td><a id="l988"></a><a href="#l988">988</a><td> * in the pending state and may make a single transition to either a<tr><td><a id="l989"></a><a href="#l989">989</a><td> * fulfilled or rejected state, at which point the promise is considered<tr><td><a id="l990"></a><a href="#l990">990</a><td> * resolved.<tr><td><a id="l991"></a><a href="#l991">991</a><td> *<tr><td><a id="l992"></a><a href="#l992">992</a><td> * @implements {promise.Thenable&lt;T&gt;}<tr><td><a id="l993"></a><a href="#l993">993</a><td> * @template T<tr><td><a id="l994"></a><a href="#l994">994</a><td> * @see http://promises-aplus.github.io/promises-spec/<tr><td><a id="l995"></a><a href="#l995">995</a><td> * @unrestricted  // For using CANCEL_HANDLER_SYMBOL.<tr><td><a id="l996"></a><a href="#l996">996</a><td> */<tr><td><a id="l997"></a><a href="#l997">997</a><td>promise.Promise = goog.defineClass(null, {<tr><td><a id="l998"></a><a href="#l998">998</a><td>  /**<tr><td><a id="l999"></a><a href="#l999">999</a><td>   * @param {function(<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td>   *           function((T|IThenable&lt;T&gt;|Thenable)=),<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td>   *           function(*=))} resolver<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td>   *     Function that is invoked immediately to begin computation of this<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td>   *     promise&#39;s value. The function should accept a pair of callback<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td>   *     functions, one for fulfilling the promise and another for rejecting it.<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td>   * @param {promise.ControlFlow=} opt_flow The control flow<tr><td><a id="l1006"></a><a href="#l1006">1006</a><td>   *     this instance was created under. Defaults to the currently active flow.<tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>   */<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td>  constructor: function(resolver, opt_flow) {<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td>    goog.getUid(this);<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td><tr><td><a id="l1011"></a><a href="#l1011">1011</a><td>    /** @private {!promise.ControlFlow} */<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td>    this.flow_ = opt_flow || promise.controlFlow();<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td><tr><td><a id="l1014"></a><a href="#l1014">1014</a><td>    /** @private {Error} */<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>    this.stack_ = null;<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td>    if (promise.LONG_STACK_TRACES) {<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td>      this.stack_ = promise.captureStackTrace(<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td>        &#39;Promise&#39;, &#39;new&#39;, promise.Promise);<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td>    }<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td><tr><td><a id="l1021"></a><a href="#l1021">1021</a><td>    /** @private {promise.Promise&lt;?&gt;} */<tr><td><a id="l1022"></a><a href="#l1022">1022</a><td>    this.parent_ = null;<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td><tr><td><a id="l1024"></a><a href="#l1024">1024</a><td>    /** @private {Array&lt;!Task&gt;} */<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td>    this.callbacks_ = null;<tr><td><a id="l1026"></a><a href="#l1026">1026</a><td><tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>    /** @private {PromiseState} */<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>    this.state_ = PromiseState.PENDING;<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td><tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>    /** @private {boolean} */<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td>    this.handled_ = false;<tr><td><a id="l1032"></a><a href="#l1032">1032</a><td><tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>    /** @private {*} */<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td>    this.value_ = undefined;<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td><tr><td><a id="l1036"></a><a href="#l1036">1036</a><td>    /** @private {TaskQueue} */<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td>    this.queue_ = null;<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td><tr><td><a id="l1039"></a><a href="#l1039">1039</a><td>    /** @private {(function(promise.CancellationError)|null)} */<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td>    this[CANCEL_HANDLER_SYMBOL] = null;<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td><tr><td><a id="l1042"></a><a href="#l1042">1042</a><td>    try {<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td>      var self = this;<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td>      resolver(function(value) {<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td>        self.resolve_(PromiseState.FULFILLED, value);<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td>      }, function(reason) {<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td>        self.resolve_(PromiseState.REJECTED, reason);<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>      });<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td>    } catch (ex) {<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td>      this.resolve_(PromiseState.REJECTED, ex);<tr><td><a id="l1051"></a><a href="#l1051">1051</a><td>    }<tr><td><a id="l1052"></a><a href="#l1052">1052</a><td>  },<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td><tr><td><a id="l1054"></a><a href="#l1054">1054</a><td>  /** @override */<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td>  toString: function() {<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td>    return &#39;Promise::&#39; + goog.getUid(this) +<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td>      &#39; {[[PromiseStatus]]: &quot;&#39; + this.state_ + &#39;&quot;}&#39;;<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td>  },<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td><tr><td><a id="l1060"></a><a href="#l1060">1060</a><td>  /**<tr><td><a id="l1061"></a><a href="#l1061">1061</a><td>   * Resolves this promise. If the new value is itself a promise, this function<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td>   * will wait for it to be resolved before notifying the registered listeners.<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td>   * @param {PromiseState} newState The promise&#39;s new state.<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td>   * @param {*} newValue The promise&#39;s new value.<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td>   * @throws {TypeError} If {@code newValue === this}.<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td>   * @private<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>   */<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td>  resolve_: function(newState, newValue) {<tr><td><a id="l1069"></a><a href="#l1069">1069</a><td>    if (PromiseState.PENDING !== this.state_) {<tr><td><a id="l1070"></a><a href="#l1070">1070</a><td>      return;<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td>    }<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td><tr><td><a id="l1073"></a><a href="#l1073">1073</a><td>    if (newValue === this) {<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>      // See promise a+, 2.3.1<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td>      // http://promises-aplus.github.io/promises-spec/#point-48<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td>      newValue = new TypeError(&#39;A promise may not resolve to itself&#39;);<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td>      newState = PromiseState.REJECTED;<tr><td><a id="l1078"></a><a href="#l1078">1078</a><td>    }<tr><td><a id="l1079"></a><a href="#l1079">1079</a><td><tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>    this.parent_ = null;<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td>    this.state_ = PromiseState.BLOCKED;<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td><tr><td><a id="l1083"></a><a href="#l1083">1083</a><td>    if (newState !== PromiseState.REJECTED) {<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td>      if (promise.Thenable.isImplementation(newValue)) {<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td>        // 2.3.2<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td>        newValue = /** @type {!promise.Thenable} */(newValue);<tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>        newValue.then(<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>            this.unblockAndResolve_.bind(this, PromiseState.FULFILLED),<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>            this.unblockAndResolve_.bind(this, PromiseState.REJECTED));<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td>        return;<tr><td><a id="l1091"></a><a href="#l1091">1091</a><td><tr><td><a id="l1092"></a><a href="#l1092">1092</a><td>      } else if (goog.isObject(newValue)) {<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td>        // 2.3.3<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td><tr><td><a id="l1095"></a><a href="#l1095">1095</a><td>        try {<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td>          // 2.3.3.1<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td>          var then = newValue[&#39;then&#39;];<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td>        } catch (e) {<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td>          // 2.3.3.2<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>          this.state_ = PromiseState.REJECTED;<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td>          this.value_ = e;<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td>          this.scheduleNotifications_();<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td>          return;<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td>        }<tr><td><a id="l1105"></a><a href="#l1105">1105</a><td><tr><td><a id="l1106"></a><a href="#l1106">1106</a><td>        // NB: goog.isFunction is loose and will accept instanceof Function.<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td>        if (typeof then === &#39;function&#39;) {<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td>          // 2.3.3.3<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td>          this.invokeThen_(newValue, then);<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td>          return;<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td>        }<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td>      }<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td>    }<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td><tr><td><a id="l1115"></a><a href="#l1115">1115</a><td>    if (newState === PromiseState.REJECTED &amp;&amp;<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td>        isError(newValue) &amp;&amp; newValue.stack &amp;&amp; this.stack_) {<tr><td><a id="l1117"></a><a href="#l1117">1117</a><td>      newValue.stack += &#39;\nFrom: &#39; + (this.stack_.stack || this.stack_);<tr><td><a id="l1118"></a><a href="#l1118">1118</a><td>    }<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td><tr><td><a id="l1120"></a><a href="#l1120">1120</a><td>    // 2.3.3.4 and 2.3.4<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td>    this.state_ = newState;<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td>    this.value_ = newValue;<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td>    this.scheduleNotifications_();<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td>  },<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td><tr><td><a id="l1126"></a><a href="#l1126">1126</a><td>  /**<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td>   * Invokes a thenable&#39;s &quot;then&quot; method according to 2.3.3.3 of the promise<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td>   * A+ spec.<tr><td><a id="l1129"></a><a href="#l1129">1129</a><td>   * @param {!Object} x The thenable object.<tr><td><a id="l1130"></a><a href="#l1130">1130</a><td>   * @param {!Function} then The &quot;then&quot; function to invoke.<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td>   * @private<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td>   */<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td>  invokeThen_: function(x, then) {<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td>    var called = false;<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td>    var self = this;<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td><tr><td><a id="l1137"></a><a href="#l1137">1137</a><td>    var resolvePromise = function(value) {<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td>      if (!called) {  // 2.3.3.3.3<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>        called = true;<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td>        // 2.3.3.3.1<tr><td><a id="l1141"></a><a href="#l1141">1141</a><td>        self.unblockAndResolve_(PromiseState.FULFILLED, value);<tr><td><a id="l1142"></a><a href="#l1142">1142</a><td>      }<tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>    };<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td><tr><td><a id="l1145"></a><a href="#l1145">1145</a><td>    var rejectPromise = function(reason) {<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td>      if (!called) {  // 2.3.3.3.3<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td>        called = true;<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td>        // 2.3.3.3.2<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td>        self.unblockAndResolve_(PromiseState.REJECTED, reason);<tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>      }<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td>    };<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td><tr><td><a id="l1153"></a><a href="#l1153">1153</a><td>    try {<tr><td><a id="l1154"></a><a href="#l1154">1154</a><td>      // 2.3.3.3<tr><td><a id="l1155"></a><a href="#l1155">1155</a><td>      then.call(x, resolvePromise, rejectPromise);<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td>    } catch (e) {<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td>      // 2.3.3.3.4.2<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td>      rejectPromise(e);<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td>    }<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td>  },<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td><tr><td><a id="l1162"></a><a href="#l1162">1162</a><td>  /**<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td>   * @param {PromiseState} newState The promise&#39;s new state.<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td>   * @param {*} newValue The promise&#39;s new value.<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td>   * @private<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td>   */<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>  unblockAndResolve_: function(newState, newValue) {<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td>    if (this.state_ === PromiseState.BLOCKED) {<tr><td><a id="l1169"></a><a href="#l1169">1169</a><td>      this.state_ = PromiseState.PENDING;<tr><td><a id="l1170"></a><a href="#l1170">1170</a><td>      this.resolve_(newState, newValue);<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td>    }<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td>  },<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td><tr><td><a id="l1174"></a><a href="#l1174">1174</a><td>  /**<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td>   * @private<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td>   */<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td>  scheduleNotifications_: function() {<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td>    vlog(2, () =&gt; this + &#39; scheduling notifications&#39;, this);<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td><tr><td><a id="l1180"></a><a href="#l1180">1180</a><td>    this[CANCEL_HANDLER_SYMBOL] = null;<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td>    if (this.value_ instanceof promise.CancellationError<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td>        &amp;&amp; this.value_.silent_) {<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td>      this.callbacks_ = null;<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td>    }<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td><tr><td><a id="l1186"></a><a href="#l1186">1186</a><td>    if (!this.queue_) {<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td>      this.queue_ = this.flow_.getActiveQueue_();<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td>    }<tr><td><a id="l1189"></a><a href="#l1189">1189</a><td><tr><td><a id="l1190"></a><a href="#l1190">1190</a><td>    if (!this.handled_ &amp;&amp;<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td>        this.state_ === PromiseState.REJECTED &amp;&amp;<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>        !(this.value_ instanceof promise.CancellationError)) {<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td>      this.queue_.addUnhandledRejection(this);<tr><td><a id="l1194"></a><a href="#l1194">1194</a><td>    }<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>    this.queue_.scheduleCallbacks(this);<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td>  },<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td><tr><td><a id="l1198"></a><a href="#l1198">1198</a><td>  /** @override */<tr><td><a id="l1199"></a><a href="#l1199">1199</a><td>  cancel: function(opt_reason) {<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td>    if (!canCancel(this)) {<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td>      return;<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td>    }<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td><tr><td><a id="l1204"></a><a href="#l1204">1204</a><td>    if (this.parent_ &amp;&amp; canCancel(this.parent_)) {<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td>      this.parent_.cancel(opt_reason);<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td>    } else {<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td>      var reason = promise.CancellationError.wrap(opt_reason);<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td>      if (this[CANCEL_HANDLER_SYMBOL]) {<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td>        this[CANCEL_HANDLER_SYMBOL](reason);<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td>        this[CANCEL_HANDLER_SYMBOL] = null;<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td>      }<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td><tr><td><a id="l1213"></a><a href="#l1213">1213</a><td>      if (this.state_ === PromiseState.BLOCKED) {<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td>        this.unblockAndResolve_(PromiseState.REJECTED, reason);<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td>      } else {<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td>        this.resolve_(PromiseState.REJECTED, reason);<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td>      }<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td>    }<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td><tr><td><a id="l1220"></a><a href="#l1220">1220</a><td>    function canCancel(promise) {<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td>      return promise.state_ === PromiseState.PENDING<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>          || promise.state_ === PromiseState.BLOCKED;<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>    }<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td>  },<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td><tr><td><a id="l1226"></a><a href="#l1226">1226</a><td>  /** @override */<tr><td><a id="l1227"></a><a href="#l1227">1227</a><td>  isPending: function() {<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td>    return this.state_ === PromiseState.PENDING;<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td>  },<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td><tr><td><a id="l1231"></a><a href="#l1231">1231</a><td>  /** @override */<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td>  then: function(opt_callback, opt_errback) {<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td>    return this.addCallback_(<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td>        opt_callback, opt_errback, &#39;then&#39;, promise.Promise.prototype.then);<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td>  },<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td><tr><td><a id="l1237"></a><a href="#l1237">1237</a><td>  /** @override */<tr><td><a id="l1238"></a><a href="#l1238">1238</a><td>  thenCatch: function(errback) {<tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>    return this.addCallback_(<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td>        null, errback, &#39;thenCatch&#39;, promise.Promise.prototype.thenCatch);<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td>  },<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td><tr><td><a id="l1243"></a><a href="#l1243">1243</a><td>  /** @override */<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td>  thenFinally: function(callback) {<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td>    var error;<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td>    var mustThrow = false;<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>    return this.then(function() {<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>      return callback();<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>    }, function(err) {<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>      error = err;<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>      mustThrow = true;<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td>      return callback();<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td>    }).then(function() {<tr><td><a id="l1254"></a><a href="#l1254">1254</a><td>      if (mustThrow) {<tr><td><a id="l1255"></a><a href="#l1255">1255</a><td>        throw error;<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td>      }<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td>    });<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td>  },<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td><tr><td><a id="l1260"></a><a href="#l1260">1260</a><td>  /**<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td>   * Registers a new callback with this promise<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td>   * @param {(function(T): (R|IThenable&lt;R&gt;)|null|undefined)} callback The<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td>   *    fulfillment callback.<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>   * @param {(function(*): (R|IThenable&lt;R&gt;)|null|undefined)} errback The<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>   *    rejection callback.<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>   * @param {string} name The callback name.<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>   * @param {!Function} fn The function to use as the top of the stack when<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td>   *     recording the callback&#39;s creation point.<tr><td><a id="l1269"></a><a href="#l1269">1269</a><td>   * @return {!promise.Promise&lt;R&gt;} A new promise which will be resolved with the<tr><td><a id="l1270"></a><a href="#l1270">1270</a><td>   *     esult of the invoked callback.<tr><td><a id="l1271"></a><a href="#l1271">1271</a><td>   * @template R<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td>   * @private<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td>   */<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td>  addCallback_: function(callback, errback, name, fn) {<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td>    if (!goog.isFunction(callback) &amp;&amp; !goog.isFunction(errback)) {<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td>      return this;<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td>    }<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td><tr><td><a id="l1279"></a><a href="#l1279">1279</a><td>    this.handled_ = true;<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td>    if (this.queue_) {<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>      this.queue_.clearUnhandledRejection(this);<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>    }<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td><tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>    var cb = new Task(<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>        this.flow_,<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>        this.invokeCallback_.bind(this, callback, errback),<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>        name,<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td>        promise.LONG_STACK_TRACES ? {name: &#39;Promise&#39;, top: fn} : undefined);<tr><td><a id="l1289"></a><a href="#l1289">1289</a><td>    cb.promise.parent_ = this;<tr><td><a id="l1290"></a><a href="#l1290">1290</a><td><tr><td><a id="l1291"></a><a href="#l1291">1291</a><td>    if (this.state_ !== PromiseState.PENDING &amp;&amp;<tr><td><a id="l1292"></a><a href="#l1292">1292</a><td>        this.state_ !== PromiseState.BLOCKED) {<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td>      this.flow_.getActiveQueue_().enqueue(cb);<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td>    } else {<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td>      if (!this.callbacks_) {<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td>        this.callbacks_ = [];<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td>      }<tr><td><a id="l1298"></a><a href="#l1298">1298</a><td>      this.callbacks_.push(cb);<tr><td><a id="l1299"></a><a href="#l1299">1299</a><td>      cb.isVolatile = true;<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td>      this.flow_.getActiveQueue_().enqueue(cb);<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td>    }<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td><tr><td><a id="l1303"></a><a href="#l1303">1303</a><td>    return cb.promise;<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>  },<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td><tr><td><a id="l1306"></a><a href="#l1306">1306</a><td>  /**<tr><td><a id="l1307"></a><a href="#l1307">1307</a><td>   * Invokes a callback function attached to this promise.<tr><td><a id="l1308"></a><a href="#l1308">1308</a><td>   * @param {(function(T): (R|IThenable&lt;R&gt;)|null|undefined)} callback The<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td>   *    fulfillment callback.<tr><td><a id="l1310"></a><a href="#l1310">1310</a><td>   * @param {(function(*): (R|IThenable&lt;R&gt;)|null|undefined)} errback The<tr><td><a id="l1311"></a><a href="#l1311">1311</a><td>   *    rejection callback.<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td>   * @template R<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td>   * @private<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td>   */<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td>  invokeCallback_: function(callback, errback) {<tr><td><a id="l1316"></a><a href="#l1316">1316</a><td>    var callbackFn = callback;<tr><td><a id="l1317"></a><a href="#l1317">1317</a><td>    if (this.state_ === PromiseState.REJECTED) {<tr><td><a id="l1318"></a><a href="#l1318">1318</a><td>      callbackFn = errback;<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td>    }<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td><tr><td><a id="l1321"></a><a href="#l1321">1321</a><td>    if (goog.isFunction(callbackFn)) {<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td>      if (promise.isGenerator(callbackFn)) {<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td>        return promise.consume(callbackFn, null, this.value_);<tr><td><a id="l1324"></a><a href="#l1324">1324</a><td>      }<tr><td><a id="l1325"></a><a href="#l1325">1325</a><td>      return callbackFn(this.value_);<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td>    } else if (this.state_ === PromiseState.REJECTED) {<tr><td><a id="l1327"></a><a href="#l1327">1327</a><td>      throw this.value_;<tr><td><a id="l1328"></a><a href="#l1328">1328</a><td>    } else {<tr><td><a id="l1329"></a><a href="#l1329">1329</a><td>      return this.value_;<tr><td><a id="l1330"></a><a href="#l1330">1330</a><td>    }<tr><td><a id="l1331"></a><a href="#l1331">1331</a><td>  }<tr><td><a id="l1332"></a><a href="#l1332">1332</a><td>});<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td>promise.Thenable.addImplementation(promise.Promise);<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td><tr><td><a id="l1335"></a><a href="#l1335">1335</a><td><tr><td><a id="l1336"></a><a href="#l1336">1336</a><td>/**<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td> * Represents a value that will be resolved at some point in the future. This<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td> * class represents the protected &quot;producer&quot; half of a Promise - each Deferred<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td> * has a {@code promise} property that may be returned to consumers for<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td> * registering callbacks, reserving the ability to resolve the deferred to the<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td> * producer.<tr><td><a id="l1342"></a><a href="#l1342">1342</a><td> *<tr><td><a id="l1343"></a><a href="#l1343">1343</a><td> * If this Deferred is rejected and there are no listeners registered before<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td> * the next turn of the event loop, the rejection will be passed to the<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td> * {@link webdriver.promise.ControlFlow} as an unhandled failure.<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td> *<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td> * @implements {promise.Thenable&lt;T&gt;}<tr><td><a id="l1348"></a><a href="#l1348">1348</a><td> * @template T<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td> */<tr><td><a id="l1350"></a><a href="#l1350">1350</a><td>promise.Deferred = goog.defineClass(null, {<tr><td><a id="l1351"></a><a href="#l1351">1351</a><td>  /**<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td>   * @param {promise.ControlFlow=} opt_flow The control flow this instance was<tr><td><a id="l1353"></a><a href="#l1353">1353</a><td>   *     created under. This should only be provided during unit tests.<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td>   */<tr><td><a id="l1355"></a><a href="#l1355">1355</a><td>  constructor: function(opt_flow) {<tr><td><a id="l1356"></a><a href="#l1356">1356</a><td>    var fulfill, reject;<tr><td><a id="l1357"></a><a href="#l1357">1357</a><td><tr><td><a id="l1358"></a><a href="#l1358">1358</a><td>    /** @type {!promise.Promise&lt;T&gt;} */<tr><td><a id="l1359"></a><a href="#l1359">1359</a><td>    this.promise = new promise.Promise(function(f, r) {<tr><td><a id="l1360"></a><a href="#l1360">1360</a><td>      fulfill = f;<tr><td><a id="l1361"></a><a href="#l1361">1361</a><td>      reject = r;<tr><td><a id="l1362"></a><a href="#l1362">1362</a><td>    }, opt_flow);<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td><tr><td><a id="l1364"></a><a href="#l1364">1364</a><td>    var self = this;<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td>    var checkNotSelf = function(value) {<tr><td><a id="l1366"></a><a href="#l1366">1366</a><td>      if (value === self) {<tr><td><a id="l1367"></a><a href="#l1367">1367</a><td>        throw new TypeError(&#39;May not resolve a Deferred with itself&#39;);<tr><td><a id="l1368"></a><a href="#l1368">1368</a><td>      }<tr><td><a id="l1369"></a><a href="#l1369">1369</a><td>    };<tr><td><a id="l1370"></a><a href="#l1370">1370</a><td><tr><td><a id="l1371"></a><a href="#l1371">1371</a><td>    /**<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td>     * Resolves this deferred with the given value. It is safe to call this as a<tr><td><a id="l1373"></a><a href="#l1373">1373</a><td>     * normal function (with no bound &quot;this&quot;).<tr><td><a id="l1374"></a><a href="#l1374">1374</a><td>     * @param {(T|IThenable&lt;T&gt;|Thenable)=} opt_value The fulfilled value.<tr><td><a id="l1375"></a><a href="#l1375">1375</a><td>     */<tr><td><a id="l1376"></a><a href="#l1376">1376</a><td>    this.fulfill = function(opt_value) {<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td>      checkNotSelf(opt_value);<tr><td><a id="l1378"></a><a href="#l1378">1378</a><td>      fulfill(opt_value);<tr><td><a id="l1379"></a><a href="#l1379">1379</a><td>    };<tr><td><a id="l1380"></a><a href="#l1380">1380</a><td><tr><td><a id="l1381"></a><a href="#l1381">1381</a><td>    /**<tr><td><a id="l1382"></a><a href="#l1382">1382</a><td>     * Rejects this promise with the given reason. It is safe to call this as a<tr><td><a id="l1383"></a><a href="#l1383">1383</a><td>     * normal function (with no bound &quot;this&quot;).<tr><td><a id="l1384"></a><a href="#l1384">1384</a><td>     * @param {*=} opt_reason The rejection reason.<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td>     */<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td>    this.reject = function(opt_reason) {<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td>      checkNotSelf(opt_reason);<tr><td><a id="l1388"></a><a href="#l1388">1388</a><td>      reject(opt_reason);<tr><td><a id="l1389"></a><a href="#l1389">1389</a><td>    };<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td>  },<tr><td><a id="l1391"></a><a href="#l1391">1391</a><td><tr><td><a id="l1392"></a><a href="#l1392">1392</a><td>  /** @override */<tr><td><a id="l1393"></a><a href="#l1393">1393</a><td>  isPending: function() {<tr><td><a id="l1394"></a><a href="#l1394">1394</a><td>    return this.promise.isPending();<tr><td><a id="l1395"></a><a href="#l1395">1395</a><td>  },<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td><tr><td><a id="l1397"></a><a href="#l1397">1397</a><td>  /** @override */<tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>  cancel: function(opt_reason) {<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td>    this.promise.cancel(opt_reason);<tr><td><a id="l1400"></a><a href="#l1400">1400</a><td>  },<tr><td><a id="l1401"></a><a href="#l1401">1401</a><td><tr><td><a id="l1402"></a><a href="#l1402">1402</a><td>  /**<tr><td><a id="l1403"></a><a href="#l1403">1403</a><td>   * @override<tr><td><a id="l1404"></a><a href="#l1404">1404</a><td>   * @deprecated Use {@code then} from the promise property directly.<tr><td><a id="l1405"></a><a href="#l1405">1405</a><td>   */<tr><td><a id="l1406"></a><a href="#l1406">1406</a><td>  then: function(opt_cb, opt_eb) {<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td>    return this.promise.then(opt_cb, opt_eb);<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td>  },<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td><tr><td><a id="l1410"></a><a href="#l1410">1410</a><td>  /**<tr><td><a id="l1411"></a><a href="#l1411">1411</a><td>   * @override<tr><td><a id="l1412"></a><a href="#l1412">1412</a><td>   * @deprecated Use {@code thenCatch} from the promise property directly.<tr><td><a id="l1413"></a><a href="#l1413">1413</a><td>   */<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td>  thenCatch: function(opt_eb) {<tr><td><a id="l1415"></a><a href="#l1415">1415</a><td>    return this.promise.thenCatch(opt_eb);<tr><td><a id="l1416"></a><a href="#l1416">1416</a><td>  },<tr><td><a id="l1417"></a><a href="#l1417">1417</a><td><tr><td><a id="l1418"></a><a href="#l1418">1418</a><td>  /**<tr><td><a id="l1419"></a><a href="#l1419">1419</a><td>   * @override<tr><td><a id="l1420"></a><a href="#l1420">1420</a><td>   * @deprecated Use {@code thenFinally} from the promise property directly.<tr><td><a id="l1421"></a><a href="#l1421">1421</a><td>   */<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td>  thenFinally: function(opt_cb) {<tr><td><a id="l1423"></a><a href="#l1423">1423</a><td>    return this.promise.thenFinally(opt_cb);<tr><td><a id="l1424"></a><a href="#l1424">1424</a><td>  }<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td>});<tr><td><a id="l1426"></a><a href="#l1426">1426</a><td>promise.Thenable.addImplementation(promise.Deferred);<tr><td><a id="l1427"></a><a href="#l1427">1427</a><td><tr><td><a id="l1428"></a><a href="#l1428">1428</a><td><tr><td><a id="l1429"></a><a href="#l1429">1429</a><td>/**<tr><td><a id="l1430"></a><a href="#l1430">1430</a><td> * Tests if a value is an Error-like object. This is more than an straight<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td> * instanceof check since the value may originate from another context.<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td> * @param {*} value The value to test.<tr><td><a id="l1433"></a><a href="#l1433">1433</a><td> * @return {boolean} Whether the value is an error.<tr><td><a id="l1434"></a><a href="#l1434">1434</a><td> */<tr><td><a id="l1435"></a><a href="#l1435">1435</a><td>function isError(value) {<tr><td><a id="l1436"></a><a href="#l1436">1436</a><td>  return value instanceof Error ||<tr><td><a id="l1437"></a><a href="#l1437">1437</a><td>      goog.isObject(value) &amp;&amp;<tr><td><a id="l1438"></a><a href="#l1438">1438</a><td>      (goog.isString(value.message) ||<tr><td><a id="l1439"></a><a href="#l1439">1439</a><td>       // A special test for goog.testing.JsUnitException.<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td>       value.isJsUnitException);<tr><td><a id="l1441"></a><a href="#l1441">1441</a><td><tr><td><a id="l1442"></a><a href="#l1442">1442</a><td>}<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td><tr><td><a id="l1444"></a><a href="#l1444">1444</a><td><tr><td><a id="l1445"></a><a href="#l1445">1445</a><td>/**<tr><td><a id="l1446"></a><a href="#l1446">1446</a><td> * Determines whether a {@code value} should be treated as a promise.<tr><td><a id="l1447"></a><a href="#l1447">1447</a><td> * Any object whose &quot;then&quot; property is a function will be considered a promise.<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td> *<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td> * @param {*} value The value to test.<tr><td><a id="l1450"></a><a href="#l1450">1450</a><td> * @return {boolean} Whether the value is a promise.<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td> */<tr><td><a id="l1452"></a><a href="#l1452">1452</a><td>promise.isPromise = function(value) {<tr><td><a id="l1453"></a><a href="#l1453">1453</a><td>  return !!value &amp;&amp; goog.isObject(value) &amp;&amp;<tr><td><a id="l1454"></a><a href="#l1454">1454</a><td>      // Use array notation so the Closure compiler does not obfuscate away our<tr><td><a id="l1455"></a><a href="#l1455">1455</a><td>      // contract. Use typeof rather than goog.isFunction because<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td>      // goog.isFunction accepts instanceof Function, which the promise spec<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td>      // does not.<tr><td><a id="l1458"></a><a href="#l1458">1458</a><td>      typeof value[&#39;then&#39;] === &#39;function&#39;;<tr><td><a id="l1459"></a><a href="#l1459">1459</a><td>};<tr><td><a id="l1460"></a><a href="#l1460">1460</a><td><tr><td><a id="l1461"></a><a href="#l1461">1461</a><td><tr><td><a id="l1462"></a><a href="#l1462">1462</a><td>/**<tr><td><a id="l1463"></a><a href="#l1463">1463</a><td> * Creates a promise that will be resolved at a set time in the future.<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td> * @param {number} ms The amount of time, in milliseconds, to wait before<tr><td><a id="l1465"></a><a href="#l1465">1465</a><td> *     resolving the promise.<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td> * @return {!promise.Promise} The promise.<tr><td><a id="l1467"></a><a href="#l1467">1467</a><td> */<tr><td><a id="l1468"></a><a href="#l1468">1468</a><td>promise.delayed = function(ms) {<tr><td><a id="l1469"></a><a href="#l1469">1469</a><td>  var key;<tr><td><a id="l1470"></a><a href="#l1470">1470</a><td>  return new promise.Promise(function(fulfill) {<tr><td><a id="l1471"></a><a href="#l1471">1471</a><td>    key = setTimeout(function() {<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td>      key = null;<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td>      fulfill();<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td>    }, ms);<tr><td><a id="l1475"></a><a href="#l1475">1475</a><td>  }).thenCatch(function(e) {<tr><td><a id="l1476"></a><a href="#l1476">1476</a><td>    clearTimeout(key);<tr><td><a id="l1477"></a><a href="#l1477">1477</a><td>    key = null;<tr><td><a id="l1478"></a><a href="#l1478">1478</a><td>    throw e;<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td>  });<tr><td><a id="l1480"></a><a href="#l1480">1480</a><td>};<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td><tr><td><a id="l1482"></a><a href="#l1482">1482</a><td><tr><td><a id="l1483"></a><a href="#l1483">1483</a><td>/**<tr><td><a id="l1484"></a><a href="#l1484">1484</a><td> * Creates a new deferred object.<tr><td><a id="l1485"></a><a href="#l1485">1485</a><td> * @return {!promise.Deferred&lt;T&gt;} The new deferred object.<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td> * @template T<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td> */<tr><td><a id="l1488"></a><a href="#l1488">1488</a><td>promise.defer = function() {<tr><td><a id="l1489"></a><a href="#l1489">1489</a><td>  return new promise.Deferred();<tr><td><a id="l1490"></a><a href="#l1490">1490</a><td>};<tr><td><a id="l1491"></a><a href="#l1491">1491</a><td><tr><td><a id="l1492"></a><a href="#l1492">1492</a><td><tr><td><a id="l1493"></a><a href="#l1493">1493</a><td>/**<tr><td><a id="l1494"></a><a href="#l1494">1494</a><td> * Creates a promise that has been resolved with the given value.<tr><td><a id="l1495"></a><a href="#l1495">1495</a><td> * @param {T=} opt_value The resolved value.<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td> * @return {!promise.Promise&lt;T&gt;} The resolved promise.<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td> * @template T<tr><td><a id="l1498"></a><a href="#l1498">1498</a><td> */<tr><td><a id="l1499"></a><a href="#l1499">1499</a><td>promise.fulfilled = function(opt_value) {<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td>  if (opt_value instanceof promise.Promise) {<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td>    return opt_value;<tr><td><a id="l1502"></a><a href="#l1502">1502</a><td>  }<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td>  return new promise.Promise(function(fulfill) {<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td>    fulfill(opt_value);<tr><td><a id="l1505"></a><a href="#l1505">1505</a><td>  });<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td>};<tr><td><a id="l1507"></a><a href="#l1507">1507</a><td><tr><td><a id="l1508"></a><a href="#l1508">1508</a><td><tr><td><a id="l1509"></a><a href="#l1509">1509</a><td>/**<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td> * Creates a promise that has been rejected with the given reason.<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td> * @param {*=} opt_reason The rejection reason; may be any value, but is<tr><td><a id="l1512"></a><a href="#l1512">1512</a><td> *     usually an Error or a string.<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td> * @return {!promise.Promise&lt;T&gt;} The rejected promise.<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td> * @template T<tr><td><a id="l1515"></a><a href="#l1515">1515</a><td> */<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>promise.rejected = function(opt_reason) {<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td>  if (opt_reason instanceof promise.Promise) {<tr><td><a id="l1518"></a><a href="#l1518">1518</a><td>    return opt_reason;<tr><td><a id="l1519"></a><a href="#l1519">1519</a><td>  }<tr><td><a id="l1520"></a><a href="#l1520">1520</a><td>  return new promise.Promise(function(_, reject) {<tr><td><a id="l1521"></a><a href="#l1521">1521</a><td>    reject(opt_reason);<tr><td><a id="l1522"></a><a href="#l1522">1522</a><td>  });<tr><td><a id="l1523"></a><a href="#l1523">1523</a><td>};<tr><td><a id="l1524"></a><a href="#l1524">1524</a><td><tr><td><a id="l1525"></a><a href="#l1525">1525</a><td><tr><td><a id="l1526"></a><a href="#l1526">1526</a><td>/**<tr><td><a id="l1527"></a><a href="#l1527">1527</a><td> * Wraps a function that expects a node-style callback as its final<tr><td><a id="l1528"></a><a href="#l1528">1528</a><td> * argument. This callback expects two arguments: an error value (which will be<tr><td><a id="l1529"></a><a href="#l1529">1529</a><td> * null if the call succeeded), and the success value as the second argument.<tr><td><a id="l1530"></a><a href="#l1530">1530</a><td> * The callback will the resolve or reject the returned promise, based on its arguments.<tr><td><a id="l1531"></a><a href="#l1531">1531</a><td> * @param {!Function} fn The function to wrap.<tr><td><a id="l1532"></a><a href="#l1532">1532</a><td> * @param {...?} var_args The arguments to apply to the function, excluding the<tr><td><a id="l1533"></a><a href="#l1533">1533</a><td> *     final callback.<tr><td><a id="l1534"></a><a href="#l1534">1534</a><td> * @return {!promise.Promise} A promise that will be resolved with the<tr><td><a id="l1535"></a><a href="#l1535">1535</a><td> *     result of the provided function&#39;s callback.<tr><td><a id="l1536"></a><a href="#l1536">1536</a><td> */<tr><td><a id="l1537"></a><a href="#l1537">1537</a><td>promise.checkedNodeCall = function(fn, var_args) {<tr><td><a id="l1538"></a><a href="#l1538">1538</a><td>  var args = Arrays.slice(arguments, 1);<tr><td><a id="l1539"></a><a href="#l1539">1539</a><td>  return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l1540"></a><a href="#l1540">1540</a><td>    try {<tr><td><a id="l1541"></a><a href="#l1541">1541</a><td>      args.push(function(error, value) {<tr><td><a id="l1542"></a><a href="#l1542">1542</a><td>        error ? reject(error) : fulfill(value);<tr><td><a id="l1543"></a><a href="#l1543">1543</a><td>      });<tr><td><a id="l1544"></a><a href="#l1544">1544</a><td>      fn.apply(undefined, args);<tr><td><a id="l1545"></a><a href="#l1545">1545</a><td>    } catch (ex) {<tr><td><a id="l1546"></a><a href="#l1546">1546</a><td>      reject(ex);<tr><td><a id="l1547"></a><a href="#l1547">1547</a><td>    }<tr><td><a id="l1548"></a><a href="#l1548">1548</a><td>  });<tr><td><a id="l1549"></a><a href="#l1549">1549</a><td>};<tr><td><a id="l1550"></a><a href="#l1550">1550</a><td><tr><td><a id="l1551"></a><a href="#l1551">1551</a><td><tr><td><a id="l1552"></a><a href="#l1552">1552</a><td>/**<tr><td><a id="l1553"></a><a href="#l1553">1553</a><td> * Registers an observer on a promised {@code value}, returning a new promise<tr><td><a id="l1554"></a><a href="#l1554">1554</a><td> * that will be resolved when the value is. If {@code value} is not a promise,<tr><td><a id="l1555"></a><a href="#l1555">1555</a><td> * then the return promise will be immediately resolved.<tr><td><a id="l1556"></a><a href="#l1556">1556</a><td> * @param {*} value The value to observe.<tr><td><a id="l1557"></a><a href="#l1557">1557</a><td> * @param {Function=} opt_callback The function to call when the value is<tr><td><a id="l1558"></a><a href="#l1558">1558</a><td> *     resolved successfully.<tr><td><a id="l1559"></a><a href="#l1559">1559</a><td> * @param {Function=} opt_errback The function to call when the value is<tr><td><a id="l1560"></a><a href="#l1560">1560</a><td> *     rejected.<tr><td><a id="l1561"></a><a href="#l1561">1561</a><td> * @return {!promise.Promise} A new promise.<tr><td><a id="l1562"></a><a href="#l1562">1562</a><td> */<tr><td><a id="l1563"></a><a href="#l1563">1563</a><td>promise.when = function(value, opt_callback, opt_errback) {<tr><td><a id="l1564"></a><a href="#l1564">1564</a><td>  if (promise.Thenable.isImplementation(value)) {<tr><td><a id="l1565"></a><a href="#l1565">1565</a><td>    return value.then(opt_callback, opt_errback);<tr><td><a id="l1566"></a><a href="#l1566">1566</a><td>  }<tr><td><a id="l1567"></a><a href="#l1567">1567</a><td><tr><td><a id="l1568"></a><a href="#l1568">1568</a><td>  return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l1569"></a><a href="#l1569">1569</a><td>    promise.asap(value, fulfill, reject);<tr><td><a id="l1570"></a><a href="#l1570">1570</a><td>  }).then(opt_callback, opt_errback);<tr><td><a id="l1571"></a><a href="#l1571">1571</a><td>};<tr><td><a id="l1572"></a><a href="#l1572">1572</a><td><tr><td><a id="l1573"></a><a href="#l1573">1573</a><td><tr><td><a id="l1574"></a><a href="#l1574">1574</a><td>/**<tr><td><a id="l1575"></a><a href="#l1575">1575</a><td> * Invokes the appropriate callback function as soon as a promised<tr><td><a id="l1576"></a><a href="#l1576">1576</a><td> * {@code value} is resolved. This function is similar to<tr><td><a id="l1577"></a><a href="#l1577">1577</a><td> * {@link webdriver.promise.when}, except it does not return a new promise.<tr><td><a id="l1578"></a><a href="#l1578">1578</a><td> * @param {*} value The value to observe.<tr><td><a id="l1579"></a><a href="#l1579">1579</a><td> * @param {Function} callback The function to call when the value is<tr><td><a id="l1580"></a><a href="#l1580">1580</a><td> *     resolved successfully.<tr><td><a id="l1581"></a><a href="#l1581">1581</a><td> * @param {Function=} opt_errback The function to call when the value is<tr><td><a id="l1582"></a><a href="#l1582">1582</a><td> *     rejected.<tr><td><a id="l1583"></a><a href="#l1583">1583</a><td> */<tr><td><a id="l1584"></a><a href="#l1584">1584</a><td>promise.asap = function(value, callback, opt_errback) {<tr><td><a id="l1585"></a><a href="#l1585">1585</a><td>  if (promise.isPromise(value)) {<tr><td><a id="l1586"></a><a href="#l1586">1586</a><td>    value.then(callback, opt_errback);<tr><td><a id="l1587"></a><a href="#l1587">1587</a><td><tr><td><a id="l1588"></a><a href="#l1588">1588</a><td>  // Maybe a Dojo-like deferred object?<tr><td><a id="l1589"></a><a href="#l1589">1589</a><td>  } else if (!!value &amp;&amp; goog.isObject(value) &amp;&amp;<tr><td><a id="l1590"></a><a href="#l1590">1590</a><td>      goog.isFunction(value.addCallbacks)) {<tr><td><a id="l1591"></a><a href="#l1591">1591</a><td>    value.addCallbacks(callback, opt_errback);<tr><td><a id="l1592"></a><a href="#l1592">1592</a><td><tr><td><a id="l1593"></a><a href="#l1593">1593</a><td>  // A raw value, return a resolved promise.<tr><td><a id="l1594"></a><a href="#l1594">1594</a><td>  } else if (callback) {<tr><td><a id="l1595"></a><a href="#l1595">1595</a><td>    callback(value);<tr><td><a id="l1596"></a><a href="#l1596">1596</a><td>  }<tr><td><a id="l1597"></a><a href="#l1597">1597</a><td>};<tr><td><a id="l1598"></a><a href="#l1598">1598</a><td><tr><td><a id="l1599"></a><a href="#l1599">1599</a><td><tr><td><a id="l1600"></a><a href="#l1600">1600</a><td>/**<tr><td><a id="l1601"></a><a href="#l1601">1601</a><td> * Given an array of promises, will return a promise that will be fulfilled<tr><td><a id="l1602"></a><a href="#l1602">1602</a><td> * with the fulfillment values of the input array&#39;s values. If any of the<tr><td><a id="l1603"></a><a href="#l1603">1603</a><td> * input array&#39;s promises are rejected, the returned promise will be rejected<tr><td><a id="l1604"></a><a href="#l1604">1604</a><td> * with the same reason.<tr><td><a id="l1605"></a><a href="#l1605">1605</a><td> *<tr><td><a id="l1606"></a><a href="#l1606">1606</a><td> * @param {!Array&lt;(T|!promise.Promise&lt;T&gt;)&gt;} arr An array of<tr><td><a id="l1607"></a><a href="#l1607">1607</a><td> *     promises to wait on.<tr><td><a id="l1608"></a><a href="#l1608">1608</a><td> * @return {!promise.Promise&lt;!Array&lt;T&gt;&gt;} A promise that is<tr><td><a id="l1609"></a><a href="#l1609">1609</a><td> *     fulfilled with an array containing the fulfilled values of the<tr><td><a id="l1610"></a><a href="#l1610">1610</a><td> *     input array, or rejected with the same reason as the first<tr><td><a id="l1611"></a><a href="#l1611">1611</a><td> *     rejected value.<tr><td><a id="l1612"></a><a href="#l1612">1612</a><td> * @template T<tr><td><a id="l1613"></a><a href="#l1613">1613</a><td> */<tr><td><a id="l1614"></a><a href="#l1614">1614</a><td>promise.all = function(arr) {<tr><td><a id="l1615"></a><a href="#l1615">1615</a><td>  return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l1616"></a><a href="#l1616">1616</a><td>    var n = arr.length;<tr><td><a id="l1617"></a><a href="#l1617">1617</a><td>    var values = [];<tr><td><a id="l1618"></a><a href="#l1618">1618</a><td><tr><td><a id="l1619"></a><a href="#l1619">1619</a><td>    if (!n) {<tr><td><a id="l1620"></a><a href="#l1620">1620</a><td>      fulfill(values);<tr><td><a id="l1621"></a><a href="#l1621">1621</a><td>      return;<tr><td><a id="l1622"></a><a href="#l1622">1622</a><td>    }<tr><td><a id="l1623"></a><a href="#l1623">1623</a><td><tr><td><a id="l1624"></a><a href="#l1624">1624</a><td>    var toFulfill = n;<tr><td><a id="l1625"></a><a href="#l1625">1625</a><td>    var onFulfilled = function(index, value) {<tr><td><a id="l1626"></a><a href="#l1626">1626</a><td>      values[index] = value;<tr><td><a id="l1627"></a><a href="#l1627">1627</a><td>      toFulfill--;<tr><td><a id="l1628"></a><a href="#l1628">1628</a><td>      if (toFulfill == 0) {<tr><td><a id="l1629"></a><a href="#l1629">1629</a><td>        fulfill(values);<tr><td><a id="l1630"></a><a href="#l1630">1630</a><td>      }<tr><td><a id="l1631"></a><a href="#l1631">1631</a><td>    };<tr><td><a id="l1632"></a><a href="#l1632">1632</a><td><tr><td><a id="l1633"></a><a href="#l1633">1633</a><td>    for (var i = 0; i &lt; n; ++i) {<tr><td><a id="l1634"></a><a href="#l1634">1634</a><td>      promise.asap(arr[i], goog.partial(onFulfilled, i), reject);<tr><td><a id="l1635"></a><a href="#l1635">1635</a><td>    }<tr><td><a id="l1636"></a><a href="#l1636">1636</a><td>  });<tr><td><a id="l1637"></a><a href="#l1637">1637</a><td>};<tr><td><a id="l1638"></a><a href="#l1638">1638</a><td><tr><td><a id="l1639"></a><a href="#l1639">1639</a><td><tr><td><a id="l1640"></a><a href="#l1640">1640</a><td>/**<tr><td><a id="l1641"></a><a href="#l1641">1641</a><td> * Calls a function for each element in an array and inserts the result into a<tr><td><a id="l1642"></a><a href="#l1642">1642</a><td> * new array, which is used as the fulfillment value of the promise returned<tr><td><a id="l1643"></a><a href="#l1643">1643</a><td> * by this function.<tr><td><a id="l1644"></a><a href="#l1644">1644</a><td> *<tr><td><a id="l1645"></a><a href="#l1645">1645</a><td> * If the return value of the mapping function is a promise, this function<tr><td><a id="l1646"></a><a href="#l1646">1646</a><td> * will wait for it to be fulfilled before inserting it into the new array.<tr><td><a id="l1647"></a><a href="#l1647">1647</a><td> *<tr><td><a id="l1648"></a><a href="#l1648">1648</a><td> * If the mapping function throws or returns a rejected promise, the<tr><td><a id="l1649"></a><a href="#l1649">1649</a><td> * promise returned by this function will be rejected with the same reason.<tr><td><a id="l1650"></a><a href="#l1650">1650</a><td> * Only the first failure will be reported; all subsequent errors will be<tr><td><a id="l1651"></a><a href="#l1651">1651</a><td> * silently ignored.<tr><td><a id="l1652"></a><a href="#l1652">1652</a><td> *<tr><td><a id="l1653"></a><a href="#l1653">1653</a><td> * @param {!(Array&lt;TYPE&gt;|promise.Promise&lt;!Array&lt;TYPE&gt;&gt;)} arr The<tr><td><a id="l1654"></a><a href="#l1654">1654</a><td> *     array to iterator over, or a promise that will resolve to said array.<tr><td><a id="l1655"></a><a href="#l1655">1655</a><td> * @param {function(this: SELF, TYPE, number, !Array&lt;TYPE&gt;): ?} fn The<tr><td><a id="l1656"></a><a href="#l1656">1656</a><td> *     function to call for each element in the array. This function should<tr><td><a id="l1657"></a><a href="#l1657">1657</a><td> *     expect three arguments (the element, the index, and the array itself.<tr><td><a id="l1658"></a><a href="#l1658">1658</a><td> * @param {SELF=} opt_self The object to be used as the value of &#39;this&#39; within<tr><td><a id="l1659"></a><a href="#l1659">1659</a><td> *     {@code fn}.<tr><td><a id="l1660"></a><a href="#l1660">1660</a><td> * @template TYPE, SELF<tr><td><a id="l1661"></a><a href="#l1661">1661</a><td> */<tr><td><a id="l1662"></a><a href="#l1662">1662</a><td>promise.map = function(arr, fn, opt_self) {<tr><td><a id="l1663"></a><a href="#l1663">1663</a><td>  return promise.fulfilled(arr).then(function(v) {<tr><td><a id="l1664"></a><a href="#l1664">1664</a><td>    goog.asserts.assertNumber(v.length, &#39;not an array like value&#39;);<tr><td><a id="l1665"></a><a href="#l1665">1665</a><td>    var arr = /** @type {!Array} */(v);<tr><td><a id="l1666"></a><a href="#l1666">1666</a><td>    return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l1667"></a><a href="#l1667">1667</a><td>      var n = arr.length;<tr><td><a id="l1668"></a><a href="#l1668">1668</a><td>      var values = new Array(n);<tr><td><a id="l1669"></a><a href="#l1669">1669</a><td>      (function processNext(i) {<tr><td><a id="l1670"></a><a href="#l1670">1670</a><td>        for (; i &lt; n; i++) {<tr><td><a id="l1671"></a><a href="#l1671">1671</a><td>          if (i in arr) {<tr><td><a id="l1672"></a><a href="#l1672">1672</a><td>            break;<tr><td><a id="l1673"></a><a href="#l1673">1673</a><td>          }<tr><td><a id="l1674"></a><a href="#l1674">1674</a><td>        }<tr><td><a id="l1675"></a><a href="#l1675">1675</a><td>        if (i &gt;= n) {<tr><td><a id="l1676"></a><a href="#l1676">1676</a><td>          fulfill(values);<tr><td><a id="l1677"></a><a href="#l1677">1677</a><td>          return;<tr><td><a id="l1678"></a><a href="#l1678">1678</a><td>        }<tr><td><a id="l1679"></a><a href="#l1679">1679</a><td>        try {<tr><td><a id="l1680"></a><a href="#l1680">1680</a><td>          promise.asap(<tr><td><a id="l1681"></a><a href="#l1681">1681</a><td>              fn.call(opt_self, arr[i], i, /** @type {!Array} */(arr)),<tr><td><a id="l1682"></a><a href="#l1682">1682</a><td>              function(value) {<tr><td><a id="l1683"></a><a href="#l1683">1683</a><td>                values[i] = value;<tr><td><a id="l1684"></a><a href="#l1684">1684</a><td>                processNext(i + 1);<tr><td><a id="l1685"></a><a href="#l1685">1685</a><td>              },<tr><td><a id="l1686"></a><a href="#l1686">1686</a><td>              reject);<tr><td><a id="l1687"></a><a href="#l1687">1687</a><td>        } catch (ex) {<tr><td><a id="l1688"></a><a href="#l1688">1688</a><td>          reject(ex);<tr><td><a id="l1689"></a><a href="#l1689">1689</a><td>        }<tr><td><a id="l1690"></a><a href="#l1690">1690</a><td>      })(0);<tr><td><a id="l1691"></a><a href="#l1691">1691</a><td>    });<tr><td><a id="l1692"></a><a href="#l1692">1692</a><td>  });<tr><td><a id="l1693"></a><a href="#l1693">1693</a><td>};<tr><td><a id="l1694"></a><a href="#l1694">1694</a><td><tr><td><a id="l1695"></a><a href="#l1695">1695</a><td><tr><td><a id="l1696"></a><a href="#l1696">1696</a><td>/**<tr><td><a id="l1697"></a><a href="#l1697">1697</a><td> * Calls a function for each element in an array, and if the function returns<tr><td><a id="l1698"></a><a href="#l1698">1698</a><td> * true adds the element to a new array.<tr><td><a id="l1699"></a><a href="#l1699">1699</a><td> *<tr><td><a id="l1700"></a><a href="#l1700">1700</a><td> * If the return value of the filter function is a promise, this function<tr><td><a id="l1701"></a><a href="#l1701">1701</a><td> * will wait for it to be fulfilled before determining whether to insert the<tr><td><a id="l1702"></a><a href="#l1702">1702</a><td> * element into the new array.<tr><td><a id="l1703"></a><a href="#l1703">1703</a><td> *<tr><td><a id="l1704"></a><a href="#l1704">1704</a><td> * If the filter function throws or returns a rejected promise, the promise<tr><td><a id="l1705"></a><a href="#l1705">1705</a><td> * returned by this function will be rejected with the same reason. Only the<tr><td><a id="l1706"></a><a href="#l1706">1706</a><td> * first failure will be reported; all subsequent errors will be silently<tr><td><a id="l1707"></a><a href="#l1707">1707</a><td> * ignored.<tr><td><a id="l1708"></a><a href="#l1708">1708</a><td> *<tr><td><a id="l1709"></a><a href="#l1709">1709</a><td> * @param {!(Array&lt;TYPE&gt;|promise.Promise&lt;!Array&lt;TYPE&gt;&gt;)} arr The<tr><td><a id="l1710"></a><a href="#l1710">1710</a><td> *     array to iterator over, or a promise that will resolve to said array.<tr><td><a id="l1711"></a><a href="#l1711">1711</a><td> * @param {function(this: SELF, TYPE, number, !Array&lt;TYPE&gt;): (<tr><td><a id="l1712"></a><a href="#l1712">1712</a><td> *             boolean|promise.Promise&lt;boolean&gt;)} fn The function<tr><td><a id="l1713"></a><a href="#l1713">1713</a><td> *     to call for each element in the array.<tr><td><a id="l1714"></a><a href="#l1714">1714</a><td> * @param {SELF=} opt_self The object to be used as the value of &#39;this&#39; within<tr><td><a id="l1715"></a><a href="#l1715">1715</a><td> *     {@code fn}.<tr><td><a id="l1716"></a><a href="#l1716">1716</a><td> * @template TYPE, SELF<tr><td><a id="l1717"></a><a href="#l1717">1717</a><td> */<tr><td><a id="l1718"></a><a href="#l1718">1718</a><td>promise.filter = function(arr, fn, opt_self) {<tr><td><a id="l1719"></a><a href="#l1719">1719</a><td>  return promise.fulfilled(arr).then(function(v) {<tr><td><a id="l1720"></a><a href="#l1720">1720</a><td>    goog.asserts.assertNumber(v.length, &#39;not an array like value&#39;);<tr><td><a id="l1721"></a><a href="#l1721">1721</a><td>    var arr = /** @type {!Array} */(v);<tr><td><a id="l1722"></a><a href="#l1722">1722</a><td>    return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l1723"></a><a href="#l1723">1723</a><td>      var n = arr.length;<tr><td><a id="l1724"></a><a href="#l1724">1724</a><td>      var values = [];<tr><td><a id="l1725"></a><a href="#l1725">1725</a><td>      var valuesLength = 0;<tr><td><a id="l1726"></a><a href="#l1726">1726</a><td>      (function processNext(i) {<tr><td><a id="l1727"></a><a href="#l1727">1727</a><td>        for (; i &lt; n; i++) {<tr><td><a id="l1728"></a><a href="#l1728">1728</a><td>          if (i in arr) {<tr><td><a id="l1729"></a><a href="#l1729">1729</a><td>            break;<tr><td><a id="l1730"></a><a href="#l1730">1730</a><td>          }<tr><td><a id="l1731"></a><a href="#l1731">1731</a><td>        }<tr><td><a id="l1732"></a><a href="#l1732">1732</a><td>        if (i &gt;= n) {<tr><td><a id="l1733"></a><a href="#l1733">1733</a><td>          fulfill(values);<tr><td><a id="l1734"></a><a href="#l1734">1734</a><td>          return;<tr><td><a id="l1735"></a><a href="#l1735">1735</a><td>        }<tr><td><a id="l1736"></a><a href="#l1736">1736</a><td>        try {<tr><td><a id="l1737"></a><a href="#l1737">1737</a><td>          var value = arr[i];<tr><td><a id="l1738"></a><a href="#l1738">1738</a><td>          var include = fn.call(opt_self, value, i, /** @type {!Array} */(arr));<tr><td><a id="l1739"></a><a href="#l1739">1739</a><td>          promise.asap(include, function(include) {<tr><td><a id="l1740"></a><a href="#l1740">1740</a><td>            if (include) {<tr><td><a id="l1741"></a><a href="#l1741">1741</a><td>              values[valuesLength++] = value;<tr><td><a id="l1742"></a><a href="#l1742">1742</a><td>            }<tr><td><a id="l1743"></a><a href="#l1743">1743</a><td>            processNext(i + 1);<tr><td><a id="l1744"></a><a href="#l1744">1744</a><td>            }, reject);<tr><td><a id="l1745"></a><a href="#l1745">1745</a><td>        } catch (ex) {<tr><td><a id="l1746"></a><a href="#l1746">1746</a><td>          reject(ex);<tr><td><a id="l1747"></a><a href="#l1747">1747</a><td>        }<tr><td><a id="l1748"></a><a href="#l1748">1748</a><td>      })(0);<tr><td><a id="l1749"></a><a href="#l1749">1749</a><td>    });<tr><td><a id="l1750"></a><a href="#l1750">1750</a><td>  });<tr><td><a id="l1751"></a><a href="#l1751">1751</a><td>};<tr><td><a id="l1752"></a><a href="#l1752">1752</a><td><tr><td><a id="l1753"></a><a href="#l1753">1753</a><td><tr><td><a id="l1754"></a><a href="#l1754">1754</a><td>/**<tr><td><a id="l1755"></a><a href="#l1755">1755</a><td> * Returns a promise that will be resolved with the input value in a<tr><td><a id="l1756"></a><a href="#l1756">1756</a><td> * fully-resolved state. If the value is an array, each element will be fully<tr><td><a id="l1757"></a><a href="#l1757">1757</a><td> * resolved. Likewise, if the value is an object, all keys will be fully<tr><td><a id="l1758"></a><a href="#l1758">1758</a><td> * resolved. In both cases, all nested arrays and objects will also be<tr><td><a id="l1759"></a><a href="#l1759">1759</a><td> * fully resolved.  All fields are resolved in place; the returned promise will<tr><td><a id="l1760"></a><a href="#l1760">1760</a><td> * resolve on {@code value} and not a copy.<tr><td><a id="l1761"></a><a href="#l1761">1761</a><td> *<tr><td><a id="l1762"></a><a href="#l1762">1762</a><td> * Warning: This function makes no checks against objects that contain<tr><td><a id="l1763"></a><a href="#l1763">1763</a><td> * cyclical references:<tr><td><a id="l1764"></a><a href="#l1764">1764</a><td> *<tr><td><a id="l1765"></a><a href="#l1765">1765</a><td> *     var value = {};<tr><td><a id="l1766"></a><a href="#l1766">1766</a><td> *     value[&#39;self&#39;] = value;<tr><td><a id="l1767"></a><a href="#l1767">1767</a><td> *     promise.fullyResolved(value);  // Stack overflow.<tr><td><a id="l1768"></a><a href="#l1768">1768</a><td> *<tr><td><a id="l1769"></a><a href="#l1769">1769</a><td> * @param {*} value The value to fully resolve.<tr><td><a id="l1770"></a><a href="#l1770">1770</a><td> * @return {!promise.Promise} A promise for a fully resolved version<tr><td><a id="l1771"></a><a href="#l1771">1771</a><td> *     of the input value.<tr><td><a id="l1772"></a><a href="#l1772">1772</a><td> */<tr><td><a id="l1773"></a><a href="#l1773">1773</a><td>promise.fullyResolved = function(value) {<tr><td><a id="l1774"></a><a href="#l1774">1774</a><td>  if (promise.isPromise(value)) {<tr><td><a id="l1775"></a><a href="#l1775">1775</a><td>    return promise.when(value, fullyResolveValue);<tr><td><a id="l1776"></a><a href="#l1776">1776</a><td>  }<tr><td><a id="l1777"></a><a href="#l1777">1777</a><td>  return fullyResolveValue(value);<tr><td><a id="l1778"></a><a href="#l1778">1778</a><td>};<tr><td><a id="l1779"></a><a href="#l1779">1779</a><td><tr><td><a id="l1780"></a><a href="#l1780">1780</a><td><tr><td><a id="l1781"></a><a href="#l1781">1781</a><td>/**<tr><td><a id="l1782"></a><a href="#l1782">1782</a><td> * @param {*} value The value to fully resolve. If a promise, assumed to<tr><td><a id="l1783"></a><a href="#l1783">1783</a><td> *     already be resolved.<tr><td><a id="l1784"></a><a href="#l1784">1784</a><td> * @return {!promise.Promise} A promise for a fully resolved version<tr><td><a id="l1785"></a><a href="#l1785">1785</a><td> *     of the input value.<tr><td><a id="l1786"></a><a href="#l1786">1786</a><td> */<tr><td><a id="l1787"></a><a href="#l1787">1787</a><td> function fullyResolveValue(value) {<tr><td><a id="l1788"></a><a href="#l1788">1788</a><td>  switch (goog.typeOf(value)) {<tr><td><a id="l1789"></a><a href="#l1789">1789</a><td>    case &#39;array&#39;:<tr><td><a id="l1790"></a><a href="#l1790">1790</a><td>      return fullyResolveKeys(/** @type {!Array} */ (value));<tr><td><a id="l1791"></a><a href="#l1791">1791</a><td><tr><td><a id="l1792"></a><a href="#l1792">1792</a><td>    case &#39;object&#39;:<tr><td><a id="l1793"></a><a href="#l1793">1793</a><td>      if (promise.isPromise(value)) {<tr><td><a id="l1794"></a><a href="#l1794">1794</a><td>        // We get here when the original input value is a promise that<tr><td><a id="l1795"></a><a href="#l1795">1795</a><td>        // resolves to itself. When the user provides us with such a promise,<tr><td><a id="l1796"></a><a href="#l1796">1796</a><td>        // trust that it counts as a &quot;fully resolved&quot; value and return it.<tr><td><a id="l1797"></a><a href="#l1797">1797</a><td>        // Of course, since it&#39;s already a promise, we can just return it<tr><td><a id="l1798"></a><a href="#l1798">1798</a><td>        // to the user instead of wrapping it in another promise.<tr><td><a id="l1799"></a><a href="#l1799">1799</a><td>        return /** @type {!promise.Promise} */ (value);<tr><td><a id="l1800"></a><a href="#l1800">1800</a><td>      }<tr><td><a id="l1801"></a><a href="#l1801">1801</a><td><tr><td><a id="l1802"></a><a href="#l1802">1802</a><td>      if (goog.isNumber(value.nodeType) &amp;&amp;<tr><td><a id="l1803"></a><a href="#l1803">1803</a><td>          goog.isObject(value.ownerDocument) &amp;&amp;<tr><td><a id="l1804"></a><a href="#l1804">1804</a><td>          goog.isNumber(value.ownerDocument.nodeType)) {<tr><td><a id="l1805"></a><a href="#l1805">1805</a><td>        // DOM node; return early to avoid infinite recursion. Should we<tr><td><a id="l1806"></a><a href="#l1806">1806</a><td>        // only support objects with a certain level of nesting?<tr><td><a id="l1807"></a><a href="#l1807">1807</a><td>        return promise.fulfilled(value);<tr><td><a id="l1808"></a><a href="#l1808">1808</a><td>      }<tr><td><a id="l1809"></a><a href="#l1809">1809</a><td><tr><td><a id="l1810"></a><a href="#l1810">1810</a><td>      return fullyResolveKeys(/** @type {!Object} */ (value));<tr><td><a id="l1811"></a><a href="#l1811">1811</a><td><tr><td><a id="l1812"></a><a href="#l1812">1812</a><td>    default:  // boolean, function, null, number, string, undefined<tr><td><a id="l1813"></a><a href="#l1813">1813</a><td>      return promise.fulfilled(value);<tr><td><a id="l1814"></a><a href="#l1814">1814</a><td>  }<tr><td><a id="l1815"></a><a href="#l1815">1815</a><td>}<tr><td><a id="l1816"></a><a href="#l1816">1816</a><td><tr><td><a id="l1817"></a><a href="#l1817">1817</a><td><tr><td><a id="l1818"></a><a href="#l1818">1818</a><td>/**<tr><td><a id="l1819"></a><a href="#l1819">1819</a><td> * @param {!(Array|Object)} obj the object to resolve.<tr><td><a id="l1820"></a><a href="#l1820">1820</a><td> * @return {!promise.Promise} A promise that will be resolved with the<tr><td><a id="l1821"></a><a href="#l1821">1821</a><td> *     input object once all of its values have been fully resolved.<tr><td><a id="l1822"></a><a href="#l1822">1822</a><td> */<tr><td><a id="l1823"></a><a href="#l1823">1823</a><td> function fullyResolveKeys(obj) {<tr><td><a id="l1824"></a><a href="#l1824">1824</a><td>  var isArray = goog.isArray(obj);<tr><td><a id="l1825"></a><a href="#l1825">1825</a><td>  var numKeys = isArray ? obj.length : Objects.getCount(obj);<tr><td><a id="l1826"></a><a href="#l1826">1826</a><td>  if (!numKeys) {<tr><td><a id="l1827"></a><a href="#l1827">1827</a><td>    return promise.fulfilled(obj);<tr><td><a id="l1828"></a><a href="#l1828">1828</a><td>  }<tr><td><a id="l1829"></a><a href="#l1829">1829</a><td><tr><td><a id="l1830"></a><a href="#l1830">1830</a><td>  var numResolved = 0;<tr><td><a id="l1831"></a><a href="#l1831">1831</a><td>  return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l1832"></a><a href="#l1832">1832</a><td>    // In pre-IE9, goog.array.forEach will not iterate properly over arrays<tr><td><a id="l1833"></a><a href="#l1833">1833</a><td>    // containing undefined values because &quot;index in array&quot; returns false<tr><td><a id="l1834"></a><a href="#l1834">1834</a><td>    // when array[index] === undefined (even for x = [undefined, 1]). To get<tr><td><a id="l1835"></a><a href="#l1835">1835</a><td>    // around this, we need to use our own forEach implementation.<tr><td><a id="l1836"></a><a href="#l1836">1836</a><td>    // DO NOT REMOVE THIS UNTIL WE NO LONGER SUPPORT IE8. This cannot be<tr><td><a id="l1837"></a><a href="#l1837">1837</a><td>    // reproduced in IE9 by changing the browser/document modes, it requires an<tr><td><a id="l1838"></a><a href="#l1838">1838</a><td>    // actual pre-IE9 browser.  Yay, IE!<tr><td><a id="l1839"></a><a href="#l1839">1839</a><td>    var forEachKey = !isArray ? Objects.forEach : function(arr, fn) {<tr><td><a id="l1840"></a><a href="#l1840">1840</a><td>      var n = arr.length;<tr><td><a id="l1841"></a><a href="#l1841">1841</a><td>      for (var i = 0; i &lt; n; ++i) {<tr><td><a id="l1842"></a><a href="#l1842">1842</a><td>        fn.call(null, arr[i], i, arr);<tr><td><a id="l1843"></a><a href="#l1843">1843</a><td>      }<tr><td><a id="l1844"></a><a href="#l1844">1844</a><td>    };<tr><td><a id="l1845"></a><a href="#l1845">1845</a><td><tr><td><a id="l1846"></a><a href="#l1846">1846</a><td>    forEachKey(obj, function(partialValue, key) {<tr><td><a id="l1847"></a><a href="#l1847">1847</a><td>      var type = goog.typeOf(partialValue);<tr><td><a id="l1848"></a><a href="#l1848">1848</a><td>      if (type != &#39;array&#39; &amp;&amp; type != &#39;object&#39;) {<tr><td><a id="l1849"></a><a href="#l1849">1849</a><td>        maybeResolveValue();<tr><td><a id="l1850"></a><a href="#l1850">1850</a><td>        return;<tr><td><a id="l1851"></a><a href="#l1851">1851</a><td>      }<tr><td><a id="l1852"></a><a href="#l1852">1852</a><td><tr><td><a id="l1853"></a><a href="#l1853">1853</a><td>      promise.fullyResolved(partialValue).then(<tr><td><a id="l1854"></a><a href="#l1854">1854</a><td>          function(resolvedValue) {<tr><td><a id="l1855"></a><a href="#l1855">1855</a><td>            obj[key] = resolvedValue;<tr><td><a id="l1856"></a><a href="#l1856">1856</a><td>            maybeResolveValue();<tr><td><a id="l1857"></a><a href="#l1857">1857</a><td>          },<tr><td><a id="l1858"></a><a href="#l1858">1858</a><td>          reject);<tr><td><a id="l1859"></a><a href="#l1859">1859</a><td>    });<tr><td><a id="l1860"></a><a href="#l1860">1860</a><td><tr><td><a id="l1861"></a><a href="#l1861">1861</a><td>    function maybeResolveValue() {<tr><td><a id="l1862"></a><a href="#l1862">1862</a><td>      if (++numResolved == numKeys) {<tr><td><a id="l1863"></a><a href="#l1863">1863</a><td>        fulfill(obj);<tr><td><a id="l1864"></a><a href="#l1864">1864</a><td>      }<tr><td><a id="l1865"></a><a href="#l1865">1865</a><td>    }<tr><td><a id="l1866"></a><a href="#l1866">1866</a><td>  });<tr><td><a id="l1867"></a><a href="#l1867">1867</a><td>}<tr><td><a id="l1868"></a><a href="#l1868">1868</a><td><tr><td><a id="l1869"></a><a href="#l1869">1869</a><td><tr><td><a id="l1870"></a><a href="#l1870">1870</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a id="l1871"></a><a href="#l1871">1871</a><td>//<tr><td><a id="l1872"></a><a href="#l1872">1872</a><td>//  promise.ControlFlow<tr><td><a id="l1873"></a><a href="#l1873">1873</a><td>//<tr><td><a id="l1874"></a><a href="#l1874">1874</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a id="l1875"></a><a href="#l1875">1875</a><td><tr><td><a id="l1876"></a><a href="#l1876">1876</a><td><tr><td><a id="l1877"></a><a href="#l1877">1877</a><td><tr><td><a id="l1878"></a><a href="#l1878">1878</a><td>/**<tr><td><a id="l1879"></a><a href="#l1879">1879</a><td> * Handles the execution of scheduled tasks, each of which may be an<tr><td><a id="l1880"></a><a href="#l1880">1880</a><td> * asynchronous operation. The control flow will ensure tasks are executed in<tr><td><a id="l1881"></a><a href="#l1881">1881</a><td> * the ordered scheduled, starting each task only once those before it have<tr><td><a id="l1882"></a><a href="#l1882">1882</a><td> * completed.<tr><td><a id="l1883"></a><a href="#l1883">1883</a><td> *<tr><td><a id="l1884"></a><a href="#l1884">1884</a><td> * Each task scheduled within this flow may return a<tr><td><a id="l1885"></a><a href="#l1885">1885</a><td> * {@link webdriver.promise.Promise} to indicate it is an asynchronous<tr><td><a id="l1886"></a><a href="#l1886">1886</a><td> * operation. The ControlFlow will wait for such promises to be resolved before<tr><td><a id="l1887"></a><a href="#l1887">1887</a><td> * marking the task as completed.<tr><td><a id="l1888"></a><a href="#l1888">1888</a><td> *<tr><td><a id="l1889"></a><a href="#l1889">1889</a><td> * Tasks and each callback registered on a {@link webdriver.promise.Promise}<tr><td><a id="l1890"></a><a href="#l1890">1890</a><td> * will be run in their own ControlFlow frame.  Any tasks scheduled within a<tr><td><a id="l1891"></a><a href="#l1891">1891</a><td> * frame will take priority over previously scheduled tasks. Furthermore, if any<tr><td><a id="l1892"></a><a href="#l1892">1892</a><td> * of the tasks in the frame fail, the remainder of the tasks in that frame will<tr><td><a id="l1893"></a><a href="#l1893">1893</a><td> * be discarded and the failure will be propagated to the user through the<tr><td><a id="l1894"></a><a href="#l1894">1894</a><td> * callback/task&#39;s promised result.<tr><td><a id="l1895"></a><a href="#l1895">1895</a><td> *<tr><td><a id="l1896"></a><a href="#l1896">1896</a><td> * Each time a ControlFlow empties its task queue, it will fire an<tr><td><a id="l1897"></a><a href="#l1897">1897</a><td> * {@link webdriver.promise.ControlFlow.EventType.IDLE IDLE} event. Conversely,<tr><td><a id="l1898"></a><a href="#l1898">1898</a><td> * whenever the flow terminates due to an unhandled error, it will remove all<tr><td><a id="l1899"></a><a href="#l1899">1899</a><td> * remaining tasks in its queue and fire an<tr><td><a id="l1900"></a><a href="#l1900">1900</a><td> * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION<tr><td><a id="l1901"></a><a href="#l1901">1901</a><td> * UNCAUGHT_EXCEPTION} event. If there are no listeners registered with the<tr><td><a id="l1902"></a><a href="#l1902">1902</a><td> * flow, the error will be rethrown to the global error handler.<tr><td><a id="l1903"></a><a href="#l1903">1903</a><td> *<tr><td><a id="l1904"></a><a href="#l1904">1904</a><td> * Refer to the {@link webdriver.promise} module documentation for a detailed<tr><td><a id="l1905"></a><a href="#l1905">1905</a><td> * explanation of how the ControlFlow coordinates task execution.<tr><td><a id="l1906"></a><a href="#l1906">1906</a><td> *<tr><td><a id="l1907"></a><a href="#l1907">1907</a><td> * @final<tr><td><a id="l1908"></a><a href="#l1908">1908</a><td> */<tr><td><a id="l1909"></a><a href="#l1909">1909</a><td>promise.ControlFlow = goog.defineClass(EventEmitter, {<tr><td><a id="l1910"></a><a href="#l1910">1910</a><td>  // TODO: remove this empty comment when the compiler properly handles<tr><td><a id="l1911"></a><a href="#l1911">1911</a><td>  // goog.defineClass with a missing constructor comment.<tr><td><a id="l1912"></a><a href="#l1912">1912</a><td>  /** @constructor */<tr><td><a id="l1913"></a><a href="#l1913">1913</a><td>  constructor: function() {<tr><td><a id="l1914"></a><a href="#l1914">1914</a><td>    promise.ControlFlow.base(this, &#39;constructor&#39;);<tr><td><a id="l1915"></a><a href="#l1915">1915</a><td><tr><td><a id="l1916"></a><a href="#l1916">1916</a><td>    /** @private {boolean} */<tr><td><a id="l1917"></a><a href="#l1917">1917</a><td>    this.propagateUnhandledRejections_ = true;<tr><td><a id="l1918"></a><a href="#l1918">1918</a><td><tr><td><a id="l1919"></a><a href="#l1919">1919</a><td>    /** @private {TaskQueue} */<tr><td><a id="l1920"></a><a href="#l1920">1920</a><td>    this.activeQueue_ = null;<tr><td><a id="l1921"></a><a href="#l1921">1921</a><td><tr><td><a id="l1922"></a><a href="#l1922">1922</a><td>    /** @private {Set&lt;TaskQueue&gt;} */<tr><td><a id="l1923"></a><a href="#l1923">1923</a><td>    this.taskQueues_ = null;<tr><td><a id="l1924"></a><a href="#l1924">1924</a><td><tr><td><a id="l1925"></a><a href="#l1925">1925</a><td>    /**<tr><td><a id="l1926"></a><a href="#l1926">1926</a><td>     * Micro task that controls shutting down the control flow. Upon shut down,<tr><td><a id="l1927"></a><a href="#l1927">1927</a><td>     * the flow will emit an<tr><td><a id="l1928"></a><a href="#l1928">1928</a><td>     * {@link webdriver.promise.ControlFlow.EventType.IDLE} event. Idle events<tr><td><a id="l1929"></a><a href="#l1929">1929</a><td>     * always follow a brief timeout in order to catch latent errors from the<tr><td><a id="l1930"></a><a href="#l1930">1930</a><td>     * last completed task. If this task had a callback registered, but no<tr><td><a id="l1931"></a><a href="#l1931">1931</a><td>     * errback, and the task fails, the unhandled failure would not be reported<tr><td><a id="l1932"></a><a href="#l1932">1932</a><td>     * by the promise system until the next turn of the event loop:<tr><td><a id="l1933"></a><a href="#l1933">1933</a><td>     *<tr><td><a id="l1934"></a><a href="#l1934">1934</a><td>     *   // Schedule 1 task that fails.<tr><td><a id="l1935"></a><a href="#l1935">1935</a><td>     *   var result = promise.controlFlow().schedule(&#39;example&#39;,<tr><td><a id="l1936"></a><a href="#l1936">1936</a><td>     *       function() { return promise.rejected(&#39;failed&#39;); });<tr><td><a id="l1937"></a><a href="#l1937">1937</a><td>     *   // Set a callback on the result. This delays reporting the unhandled<tr><td><a id="l1938"></a><a href="#l1938">1938</a><td>     *   // failure for 1 turn of the event loop.<tr><td><a id="l1939"></a><a href="#l1939">1939</a><td>     *   result.then(goog.nullFunction);<tr><td><a id="l1940"></a><a href="#l1940">1940</a><td>     *<tr><td><a id="l1941"></a><a href="#l1941">1941</a><td>     * @private {MicroTask}<tr><td><a id="l1942"></a><a href="#l1942">1942</a><td>     */<tr><td><a id="l1943"></a><a href="#l1943">1943</a><td>    this.shutdownTask_ = null;<tr><td><a id="l1944"></a><a href="#l1944">1944</a><td><tr><td><a id="l1945"></a><a href="#l1945">1945</a><td>    /**<tr><td><a id="l1946"></a><a href="#l1946">1946</a><td>     * ID for a long running interval used to keep a Node.js process running<tr><td><a id="l1947"></a><a href="#l1947">1947</a><td>     * while a control flow&#39;s event loop is still working. This is a cheap hack<tr><td><a id="l1948"></a><a href="#l1948">1948</a><td>     * required since JS events are only scheduled to run when there is<tr><td><a id="l1949"></a><a href="#l1949">1949</a><td>     * _actually_ something to run. When a control flow is waiting on a task,<tr><td><a id="l1950"></a><a href="#l1950">1950</a><td>     * there will be nothing in the JS event loop and the process would<tr><td><a id="l1951"></a><a href="#l1951">1951</a><td>     * terminate without this.<tr><td><a id="l1952"></a><a href="#l1952">1952</a><td>     *<tr><td><a id="l1953"></a><a href="#l1953">1953</a><td>     * @private {?number}<tr><td><a id="l1954"></a><a href="#l1954">1954</a><td>     */<tr><td><a id="l1955"></a><a href="#l1955">1955</a><td>    this.hold_ = null;<tr><td><a id="l1956"></a><a href="#l1956">1956</a><td>  },<tr><td><a id="l1957"></a><a href="#l1957">1957</a><td><tr><td><a id="l1958"></a><a href="#l1958">1958</a><td>  /**<tr><td><a id="l1959"></a><a href="#l1959">1959</a><td>   * Returns a string representation of this control flow, which is its current<tr><td><a id="l1960"></a><a href="#l1960">1960</a><td>   * {@link #getSchedule() schedule}, sans task stack traces.<tr><td><a id="l1961"></a><a href="#l1961">1961</a><td>   * @return {string} The string representation of this contorl flow.<tr><td><a id="l1962"></a><a href="#l1962">1962</a><td>   * @override<tr><td><a id="l1963"></a><a href="#l1963">1963</a><td>   */<tr><td><a id="l1964"></a><a href="#l1964">1964</a><td>  toString: function() {<tr><td><a id="l1965"></a><a href="#l1965">1965</a><td>    return this.getSchedule();<tr><td><a id="l1966"></a><a href="#l1966">1966</a><td>  },<tr><td><a id="l1967"></a><a href="#l1967">1967</a><td><tr><td><a id="l1968"></a><a href="#l1968">1968</a><td>  /**<tr><td><a id="l1969"></a><a href="#l1969">1969</a><td>   * Sets whether any unhandled rejections should propagate up through the<tr><td><a id="l1970"></a><a href="#l1970">1970</a><td>   * control flow stack and cause rejections within parent tasks. If error<tr><td><a id="l1971"></a><a href="#l1971">1971</a><td>   * propagation is disabled, tasks will not be aborted when an unhandled<tr><td><a id="l1972"></a><a href="#l1972">1972</a><td>   * promise rejection is detected, but the rejection _will_ trigger an<tr><td><a id="l1973"></a><a href="#l1973">1973</a><td>   * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION}<tr><td><a id="l1974"></a><a href="#l1974">1974</a><td>   * event.<tr><td><a id="l1975"></a><a href="#l1975">1975</a><td>   *<tr><td><a id="l1976"></a><a href="#l1976">1976</a><td>   * The default behavior is to propagate all unhandled rejections. _The use<tr><td><a id="l1977"></a><a href="#l1977">1977</a><td>   * of this option is highly discouraged._<tr><td><a id="l1978"></a><a href="#l1978">1978</a><td>   *<tr><td><a id="l1979"></a><a href="#l1979">1979</a><td>   * @param {boolean} propagate whether to propagate errors.<tr><td><a id="l1980"></a><a href="#l1980">1980</a><td>   */<tr><td><a id="l1981"></a><a href="#l1981">1981</a><td>  setPropagateUnhandledRejections: function(propagate) {<tr><td><a id="l1982"></a><a href="#l1982">1982</a><td>    this.propagateUnhandledRejections_ = propagate;<tr><td><a id="l1983"></a><a href="#l1983">1983</a><td>  },<tr><td><a id="l1984"></a><a href="#l1984">1984</a><td><tr><td><a id="l1985"></a><a href="#l1985">1985</a><td>  /**<tr><td><a id="l1986"></a><a href="#l1986">1986</a><td>   * @return {boolean} Whether this flow is currently idle.<tr><td><a id="l1987"></a><a href="#l1987">1987</a><td>   */<tr><td><a id="l1988"></a><a href="#l1988">1988</a><td>  isIdle: function() {<tr><td><a id="l1989"></a><a href="#l1989">1989</a><td>    return !this.shutdownTask_ &amp;&amp; (!this.taskQueues_ || !this.taskQueues_.size);<tr><td><a id="l1990"></a><a href="#l1990">1990</a><td>  },<tr><td><a id="l1991"></a><a href="#l1991">1991</a><td><tr><td><a id="l1992"></a><a href="#l1992">1992</a><td>  /**<tr><td><a id="l1993"></a><a href="#l1993">1993</a><td>   * Resets this instance, clearing its queue and removing all event listeners.<tr><td><a id="l1994"></a><a href="#l1994">1994</a><td>   */<tr><td><a id="l1995"></a><a href="#l1995">1995</a><td>  reset: function() {<tr><td><a id="l1996"></a><a href="#l1996">1996</a><td>    this.cancelQueues_(new FlowResetError);<tr><td><a id="l1997"></a><a href="#l1997">1997</a><td>    this.emit(promise.ControlFlow.EventType.RESET);<tr><td><a id="l1998"></a><a href="#l1998">1998</a><td>    this.removeAllListeners();<tr><td><a id="l1999"></a><a href="#l1999">1999</a><td>    this.cancelShutdown_();<tr><td><a id="l2000"></a><a href="#l2000">2000</a><td>  },<tr><td><a id="l2001"></a><a href="#l2001">2001</a><td><tr><td><a id="l2002"></a><a href="#l2002">2002</a><td>  /**<tr><td><a id="l2003"></a><a href="#l2003">2003</a><td>   * Generates an annotated string describing the internal state of this control<tr><td><a id="l2004"></a><a href="#l2004">2004</a><td>   * flow, including the currently executing as well as pending tasks. If<tr><td><a id="l2005"></a><a href="#l2005">2005</a><td>   * {@code opt_includeStackTraces === true}, the string will include the<tr><td><a id="l2006"></a><a href="#l2006">2006</a><td>   * stack trace from when each task was scheduled.<tr><td><a id="l2007"></a><a href="#l2007">2007</a><td>   * @param {string=} opt_includeStackTraces Whether to include the stack traces<tr><td><a id="l2008"></a><a href="#l2008">2008</a><td>   *     from when each task was scheduled. Defaults to false.<tr><td><a id="l2009"></a><a href="#l2009">2009</a><td>   * @return {string} String representation of this flow&#39;s internal state.<tr><td><a id="l2010"></a><a href="#l2010">2010</a><td>   */<tr><td><a id="l2011"></a><a href="#l2011">2011</a><td>  getSchedule: function(opt_includeStackTraces) {<tr><td><a id="l2012"></a><a href="#l2012">2012</a><td>    var ret = &#39;ControlFlow::&#39; + goog.getUid(this);<tr><td><a id="l2013"></a><a href="#l2013">2013</a><td>    var activeQueue = this.activeQueue_;<tr><td><a id="l2014"></a><a href="#l2014">2014</a><td>    if (!this.taskQueues_ || !this.taskQueues_.size) {<tr><td><a id="l2015"></a><a href="#l2015">2015</a><td>      return ret;<tr><td><a id="l2016"></a><a href="#l2016">2016</a><td>    }<tr><td><a id="l2017"></a><a href="#l2017">2017</a><td>    var childIndent = &#39;| &#39;;<tr><td><a id="l2018"></a><a href="#l2018">2018</a><td>    for (var q of this.taskQueues_) {<tr><td><a id="l2019"></a><a href="#l2019">2019</a><td>      ret += &#39;\n&#39; + printQ(q, childIndent);<tr><td><a id="l2020"></a><a href="#l2020">2020</a><td>    }<tr><td><a id="l2021"></a><a href="#l2021">2021</a><td>    return ret;<tr><td><a id="l2022"></a><a href="#l2022">2022</a><td><tr><td><a id="l2023"></a><a href="#l2023">2023</a><td>    function printQ(q, indent) {<tr><td><a id="l2024"></a><a href="#l2024">2024</a><td>      var ret = q.toString();<tr><td><a id="l2025"></a><a href="#l2025">2025</a><td>      if (q === activeQueue) {<tr><td><a id="l2026"></a><a href="#l2026">2026</a><td>        ret = &#39;(active) &#39; + ret;<tr><td><a id="l2027"></a><a href="#l2027">2027</a><td>      }<tr><td><a id="l2028"></a><a href="#l2028">2028</a><td>      var prefix = indent + childIndent;<tr><td><a id="l2029"></a><a href="#l2029">2029</a><td>      if (q.pending_) {<tr><td><a id="l2030"></a><a href="#l2030">2030</a><td>        if (q.pending_.q.state_ !== TaskQueueState.FINISHED) {<tr><td><a id="l2031"></a><a href="#l2031">2031</a><td>          ret += &#39;\n&#39; + prefix + &#39;(pending) &#39; + q.pending_.task;<tr><td><a id="l2032"></a><a href="#l2032">2032</a><td>          ret += &#39;\n&#39; + printQ(q.pending_.q, prefix + childIndent);<tr><td><a id="l2033"></a><a href="#l2033">2033</a><td>        } else {<tr><td><a id="l2034"></a><a href="#l2034">2034</a><td>          ret += &#39;\n&#39; + prefix + &#39;(blocked) &#39; + q.pending_.task;<tr><td><a id="l2035"></a><a href="#l2035">2035</a><td>        }<tr><td><a id="l2036"></a><a href="#l2036">2036</a><td>      }<tr><td><a id="l2037"></a><a href="#l2037">2037</a><td>      if (q.interrupts_) {<tr><td><a id="l2038"></a><a href="#l2038">2038</a><td>        q.interrupts_.forEach((task) =&gt; {<tr><td><a id="l2039"></a><a href="#l2039">2039</a><td>          ret += &#39;\n&#39; + prefix + task;<tr><td><a id="l2040"></a><a href="#l2040">2040</a><td>        });<tr><td><a id="l2041"></a><a href="#l2041">2041</a><td>      }<tr><td><a id="l2042"></a><a href="#l2042">2042</a><td>      if (q.tasks_) {<tr><td><a id="l2043"></a><a href="#l2043">2043</a><td>        q.tasks_.forEach((task) =&gt; ret += printTask(task, &#39;\n&#39; + prefix));<tr><td><a id="l2044"></a><a href="#l2044">2044</a><td>      }<tr><td><a id="l2045"></a><a href="#l2045">2045</a><td>      return indent + ret;<tr><td><a id="l2046"></a><a href="#l2046">2046</a><td>    }<tr><td><a id="l2047"></a><a href="#l2047">2047</a><td><tr><td><a id="l2048"></a><a href="#l2048">2048</a><td>    function printTask(task, prefix) {<tr><td><a id="l2049"></a><a href="#l2049">2049</a><td>      var ret = prefix + task;<tr><td><a id="l2050"></a><a href="#l2050">2050</a><td>      if (opt_includeStackTraces &amp;&amp; task.promise.stack_) {<tr><td><a id="l2051"></a><a href="#l2051">2051</a><td>        ret += prefix + childIndent<tr><td><a id="l2052"></a><a href="#l2052">2052</a><td>            + (task.promise.stack_.stack || task.promise.stack_)<tr><td><a id="l2053"></a><a href="#l2053">2053</a><td>                  .replace(/\n/g, prefix);<tr><td><a id="l2054"></a><a href="#l2054">2054</a><td>      }<tr><td><a id="l2055"></a><a href="#l2055">2055</a><td>      return ret;<tr><td><a id="l2056"></a><a href="#l2056">2056</a><td>    }<tr><td><a id="l2057"></a><a href="#l2057">2057</a><td>  },<tr><td><a id="l2058"></a><a href="#l2058">2058</a><td><tr><td><a id="l2059"></a><a href="#l2059">2059</a><td>  /**<tr><td><a id="l2060"></a><a href="#l2060">2060</a><td>   * Returns the currently actively task queue for this flow. If there is no<tr><td><a id="l2061"></a><a href="#l2061">2061</a><td>   * active queue, one will be created.<tr><td><a id="l2062"></a><a href="#l2062">2062</a><td>   * @return {!TaskQueue} the currently active task queue for this flow.<tr><td><a id="l2063"></a><a href="#l2063">2063</a><td>   * @private<tr><td><a id="l2064"></a><a href="#l2064">2064</a><td>   */<tr><td><a id="l2065"></a><a href="#l2065">2065</a><td>  getActiveQueue_: function() {<tr><td><a id="l2066"></a><a href="#l2066">2066</a><td>    if (this.activeQueue_) {<tr><td><a id="l2067"></a><a href="#l2067">2067</a><td>      return this.activeQueue_;<tr><td><a id="l2068"></a><a href="#l2068">2068</a><td>    }<tr><td><a id="l2069"></a><a href="#l2069">2069</a><td><tr><td><a id="l2070"></a><a href="#l2070">2070</a><td>    this.activeQueue_ = new TaskQueue(this);<tr><td><a id="l2071"></a><a href="#l2071">2071</a><td>    if (!this.taskQueues_) {<tr><td><a id="l2072"></a><a href="#l2072">2072</a><td>      this.taskQueues_ = new Set();<tr><td><a id="l2073"></a><a href="#l2073">2073</a><td>    }<tr><td><a id="l2074"></a><a href="#l2074">2074</a><td>    this.taskQueues_.add(this.activeQueue_);<tr><td><a id="l2075"></a><a href="#l2075">2075</a><td>    this.activeQueue_<tr><td><a id="l2076"></a><a href="#l2076">2076</a><td>        .once(&#39;end&#39;, this.onQueueEnd_, this)<tr><td><a id="l2077"></a><a href="#l2077">2077</a><td>        .once(&#39;error&#39;, this.onQueueError_, this);<tr><td><a id="l2078"></a><a href="#l2078">2078</a><td><tr><td><a id="l2079"></a><a href="#l2079">2079</a><td>    asyncRun(() =&gt; this.activeQueue_ = null, this);<tr><td><a id="l2080"></a><a href="#l2080">2080</a><td>    this.activeQueue_.start();<tr><td><a id="l2081"></a><a href="#l2081">2081</a><td>    return this.activeQueue_;<tr><td><a id="l2082"></a><a href="#l2082">2082</a><td>  },<tr><td><a id="l2083"></a><a href="#l2083">2083</a><td><tr><td><a id="l2084"></a><a href="#l2084">2084</a><td>  /**<tr><td><a id="l2085"></a><a href="#l2085">2085</a><td>   * Schedules a task for execution. If there is nothing currently in the<tr><td><a id="l2086"></a><a href="#l2086">2086</a><td>   * queue, the task will be executed in the next turn of the event loop. If<tr><td><a id="l2087"></a><a href="#l2087">2087</a><td>   * the task function is a generator, the task will be executed using<tr><td><a id="l2088"></a><a href="#l2088">2088</a><td>   * {@link webdriver.promise.consume}.<tr><td><a id="l2089"></a><a href="#l2089">2089</a><td>   *<tr><td><a id="l2090"></a><a href="#l2090">2090</a><td>   * @param {function(): (T|promise.Promise&lt;T&gt;)} fn The function to<tr><td><a id="l2091"></a><a href="#l2091">2091</a><td>   *     call to start the task. If the function returns a<tr><td><a id="l2092"></a><a href="#l2092">2092</a><td>   *     {@link webdriver.promise.Promise}, this instance will wait for it to be<tr><td><a id="l2093"></a><a href="#l2093">2093</a><td>   *     resolved before starting the next task.<tr><td><a id="l2094"></a><a href="#l2094">2094</a><td>   * @param {string=} opt_description A description of the task.<tr><td><a id="l2095"></a><a href="#l2095">2095</a><td>   * @return {!promise.Promise&lt;T&gt;} A promise that will be resolved<tr><td><a id="l2096"></a><a href="#l2096">2096</a><td>   *     with the result of the action.<tr><td><a id="l2097"></a><a href="#l2097">2097</a><td>   * @template T<tr><td><a id="l2098"></a><a href="#l2098">2098</a><td>   */<tr><td><a id="l2099"></a><a href="#l2099">2099</a><td>  execute: function(fn, opt_description) {<tr><td><a id="l2100"></a><a href="#l2100">2100</a><td>    if (promise.isGenerator(fn)) {<tr><td><a id="l2101"></a><a href="#l2101">2101</a><td>      fn = goog.partial(promise.consume, fn);<tr><td><a id="l2102"></a><a href="#l2102">2102</a><td>    }<tr><td><a id="l2103"></a><a href="#l2103">2103</a><td><tr><td><a id="l2104"></a><a href="#l2104">2104</a><td>    if (!this.hold_) {<tr><td><a id="l2105"></a><a href="#l2105">2105</a><td>      var holdIntervalMs = 2147483647;  // 2^31-1; max timer length for Node.js<tr><td><a id="l2106"></a><a href="#l2106">2106</a><td>      this.hold_ = setInterval(goog.nullFunction, holdIntervalMs);<tr><td><a id="l2107"></a><a href="#l2107">2107</a><td>    }<tr><td><a id="l2108"></a><a href="#l2108">2108</a><td><tr><td><a id="l2109"></a><a href="#l2109">2109</a><td>    var task = new Task(<tr><td><a id="l2110"></a><a href="#l2110">2110</a><td>        this, fn, opt_description || &#39;&lt;anonymous&gt;&#39;,<tr><td><a id="l2111"></a><a href="#l2111">2111</a><td>        {name: &#39;Task&#39;, top: promise.ControlFlow.prototype.execute});<tr><td><a id="l2112"></a><a href="#l2112">2112</a><td><tr><td><a id="l2113"></a><a href="#l2113">2113</a><td>    var q = this.getActiveQueue_();<tr><td><a id="l2114"></a><a href="#l2114">2114</a><td>    q.enqueue(task);<tr><td><a id="l2115"></a><a href="#l2115">2115</a><td>    this.emit(promise.ControlFlow.EventType.SCHEDULE_TASK, task.description);<tr><td><a id="l2116"></a><a href="#l2116">2116</a><td>    return task.promise;<tr><td><a id="l2117"></a><a href="#l2117">2117</a><td>  },<tr><td><a id="l2118"></a><a href="#l2118">2118</a><td><tr><td><a id="l2119"></a><a href="#l2119">2119</a><td>  /**<tr><td><a id="l2120"></a><a href="#l2120">2120</a><td>   * Inserts a {@code setTimeout} into the command queue. This is equivalent to<tr><td><a id="l2121"></a><a href="#l2121">2121</a><td>   * a thread sleep in a synchronous programming language.<tr><td><a id="l2122"></a><a href="#l2122">2122</a><td>   *<tr><td><a id="l2123"></a><a href="#l2123">2123</a><td>   * @param {number} ms The timeout delay, in milliseconds.<tr><td><a id="l2124"></a><a href="#l2124">2124</a><td>   * @param {string=} opt_description A description to accompany the timeout.<tr><td><a id="l2125"></a><a href="#l2125">2125</a><td>   * @return {!promise.Promise} A promise that will be resolved with<tr><td><a id="l2126"></a><a href="#l2126">2126</a><td>   *     the result of the action.<tr><td><a id="l2127"></a><a href="#l2127">2127</a><td>   */<tr><td><a id="l2128"></a><a href="#l2128">2128</a><td>  timeout: function(ms, opt_description) {<tr><td><a id="l2129"></a><a href="#l2129">2129</a><td>    return this.execute(function() {<tr><td><a id="l2130"></a><a href="#l2130">2130</a><td>      return promise.delayed(ms);<tr><td><a id="l2131"></a><a href="#l2131">2131</a><td>    }, opt_description);<tr><td><a id="l2132"></a><a href="#l2132">2132</a><td>  },<tr><td><a id="l2133"></a><a href="#l2133">2133</a><td><tr><td><a id="l2134"></a><a href="#l2134">2134</a><td>  /**<tr><td><a id="l2135"></a><a href="#l2135">2135</a><td>   * Schedules a task that shall wait for a condition to hold. Each condition<tr><td><a id="l2136"></a><a href="#l2136">2136</a><td>   * function may return any value, but it will always be evaluated as a<tr><td><a id="l2137"></a><a href="#l2137">2137</a><td>   * boolean.<tr><td><a id="l2138"></a><a href="#l2138">2138</a><td>   *<tr><td><a id="l2139"></a><a href="#l2139">2139</a><td>   * Condition functions may schedule sub-tasks with this instance, however,<tr><td><a id="l2140"></a><a href="#l2140">2140</a><td>   * their execution time will be factored into whether a wait has timed out.<tr><td><a id="l2141"></a><a href="#l2141">2141</a><td>   *<tr><td><a id="l2142"></a><a href="#l2142">2142</a><td>   * In the event a condition returns a Promise, the polling loop will wait for<tr><td><a id="l2143"></a><a href="#l2143">2143</a><td>   * it to be resolved before evaluating whether the condition has been<tr><td><a id="l2144"></a><a href="#l2144">2144</a><td>   * satisfied. The resolution time for a promise is factored into whether a<tr><td><a id="l2145"></a><a href="#l2145">2145</a><td>   * wait has timed out.<tr><td><a id="l2146"></a><a href="#l2146">2146</a><td>   *<tr><td><a id="l2147"></a><a href="#l2147">2147</a><td>   * If the condition function throws, or returns a rejected promise, the<tr><td><a id="l2148"></a><a href="#l2148">2148</a><td>   * wait task will fail.<tr><td><a id="l2149"></a><a href="#l2149">2149</a><td>   *<tr><td><a id="l2150"></a><a href="#l2150">2150</a><td>   * If the condition is defined as a promise, the flow will wait for it to<tr><td><a id="l2151"></a><a href="#l2151">2151</a><td>   * settle. If the timeout expires before the promise settles, the promise<tr><td><a id="l2152"></a><a href="#l2152">2152</a><td>   * returned by this function will be rejected.<tr><td><a id="l2153"></a><a href="#l2153">2153</a><td>   *<tr><td><a id="l2154"></a><a href="#l2154">2154</a><td>   * If this function is invoked with `timeout === 0`, or the timeout is<tr><td><a id="l2155"></a><a href="#l2155">2155</a><td>   * omitted, the flow will wait indefinitely for the condition to be satisfied.<tr><td><a id="l2156"></a><a href="#l2156">2156</a><td>   *<tr><td><a id="l2157"></a><a href="#l2157">2157</a><td>   * @param {(!promise.Promise&lt;T&gt;|function())} condition The condition to poll,<tr><td><a id="l2158"></a><a href="#l2158">2158</a><td>   *     or a promise to wait on.<tr><td><a id="l2159"></a><a href="#l2159">2159</a><td>   * @param {number=} opt_timeout How long to wait, in milliseconds, for the<tr><td><a id="l2160"></a><a href="#l2160">2160</a><td>   *     condition to hold before timing out. If omitted, the flow will wait<tr><td><a id="l2161"></a><a href="#l2161">2161</a><td>   *     indefinitely.<tr><td><a id="l2162"></a><a href="#l2162">2162</a><td>   * @param {string=} opt_message An optional error message to include if the<tr><td><a id="l2163"></a><a href="#l2163">2163</a><td>   *     wait times out; defaults to the empty string.<tr><td><a id="l2164"></a><a href="#l2164">2164</a><td>   * @return {!promise.Promise&lt;T&gt;} A promise that will be fulfilled<tr><td><a id="l2165"></a><a href="#l2165">2165</a><td>   *     when the condition has been satisified. The promise shall be rejected<tr><td><a id="l2166"></a><a href="#l2166">2166</a><td>   *     if the wait times out waiting for the condition.<tr><td><a id="l2167"></a><a href="#l2167">2167</a><td>   * @throws {TypeError} If condition is not a function or promise or if timeout<tr><td><a id="l2168"></a><a href="#l2168">2168</a><td>   *     is not a number &gt;= 0.<tr><td><a id="l2169"></a><a href="#l2169">2169</a><td>   * @template T<tr><td><a id="l2170"></a><a href="#l2170">2170</a><td>   */<tr><td><a id="l2171"></a><a href="#l2171">2171</a><td>  wait: function(condition, opt_timeout, opt_message) {<tr><td><a id="l2172"></a><a href="#l2172">2172</a><td>    var timeout = opt_timeout || 0;<tr><td><a id="l2173"></a><a href="#l2173">2173</a><td>    if (!goog.isNumber(timeout) || timeout &lt; 0) {<tr><td><a id="l2174"></a><a href="#l2174">2174</a><td>      throw TypeError(&#39;timeout must be a number &gt;= 0: &#39; + timeout);<tr><td><a id="l2175"></a><a href="#l2175">2175</a><td>    }<tr><td><a id="l2176"></a><a href="#l2176">2176</a><td><tr><td><a id="l2177"></a><a href="#l2177">2177</a><td>    if (promise.isPromise(condition)) {<tr><td><a id="l2178"></a><a href="#l2178">2178</a><td>      return this.execute(function() {<tr><td><a id="l2179"></a><a href="#l2179">2179</a><td>        if (!timeout) {<tr><td><a id="l2180"></a><a href="#l2180">2180</a><td>          return condition;<tr><td><a id="l2181"></a><a href="#l2181">2181</a><td>        }<tr><td><a id="l2182"></a><a href="#l2182">2182</a><td>        return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l2183"></a><a href="#l2183">2183</a><td>          var start = goog.now();<tr><td><a id="l2184"></a><a href="#l2184">2184</a><td>          var timer = setTimeout(function() {<tr><td><a id="l2185"></a><a href="#l2185">2185</a><td>            timer = null;<tr><td><a id="l2186"></a><a href="#l2186">2186</a><td>            reject(Error((opt_message ? opt_message + &#39;\n&#39; : &#39;&#39;) +<tr><td><a id="l2187"></a><a href="#l2187">2187</a><td>                         &#39;Timed out waiting for promise to resolve after &#39; +<tr><td><a id="l2188"></a><a href="#l2188">2188</a><td>                         (goog.now() - start) + &#39;ms&#39;));<tr><td><a id="l2189"></a><a href="#l2189">2189</a><td>          }, timeout);<tr><td><a id="l2190"></a><a href="#l2190">2190</a><td><tr><td><a id="l2191"></a><a href="#l2191">2191</a><td>          /** @type {Thenable} */(condition).then(<tr><td><a id="l2192"></a><a href="#l2192">2192</a><td>            function(value) {<tr><td><a id="l2193"></a><a href="#l2193">2193</a><td>              timer &amp;&amp; clearTimeout(timer);<tr><td><a id="l2194"></a><a href="#l2194">2194</a><td>              fulfill(value);<tr><td><a id="l2195"></a><a href="#l2195">2195</a><td>            },<tr><td><a id="l2196"></a><a href="#l2196">2196</a><td>            function(error) {<tr><td><a id="l2197"></a><a href="#l2197">2197</a><td>              timer &amp;&amp; clearTimeout(timer);<tr><td><a id="l2198"></a><a href="#l2198">2198</a><td>              reject(error);<tr><td><a id="l2199"></a><a href="#l2199">2199</a><td>            });<tr><td><a id="l2200"></a><a href="#l2200">2200</a><td>        });<tr><td><a id="l2201"></a><a href="#l2201">2201</a><td>      }, opt_message || &#39;&lt;anonymous wait: promise resolution&gt;&#39;);<tr><td><a id="l2202"></a><a href="#l2202">2202</a><td>    }<tr><td><a id="l2203"></a><a href="#l2203">2203</a><td><tr><td><a id="l2204"></a><a href="#l2204">2204</a><td>    if (!goog.isFunction(condition)) {<tr><td><a id="l2205"></a><a href="#l2205">2205</a><td>      throw TypeError(&#39;Invalid condition; must be a function or promise: &#39; +<tr><td><a id="l2206"></a><a href="#l2206">2206</a><td>                      goog.typeOf(condition));<tr><td><a id="l2207"></a><a href="#l2207">2207</a><td>    }<tr><td><a id="l2208"></a><a href="#l2208">2208</a><td><tr><td><a id="l2209"></a><a href="#l2209">2209</a><td>    if (promise.isGenerator(condition)) {<tr><td><a id="l2210"></a><a href="#l2210">2210</a><td>      condition = goog.partial(promise.consume, condition);<tr><td><a id="l2211"></a><a href="#l2211">2211</a><td>    }<tr><td><a id="l2212"></a><a href="#l2212">2212</a><td><tr><td><a id="l2213"></a><a href="#l2213">2213</a><td>    var self = this;<tr><td><a id="l2214"></a><a href="#l2214">2214</a><td>    return this.execute(function() {<tr><td><a id="l2215"></a><a href="#l2215">2215</a><td>      var startTime = goog.now();<tr><td><a id="l2216"></a><a href="#l2216">2216</a><td>      return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l2217"></a><a href="#l2217">2217</a><td>        pollCondition();<tr><td><a id="l2218"></a><a href="#l2218">2218</a><td><tr><td><a id="l2219"></a><a href="#l2219">2219</a><td>        function pollCondition() {<tr><td><a id="l2220"></a><a href="#l2220">2220</a><td>          var conditionFn = /** @type {function()} */(condition);<tr><td><a id="l2221"></a><a href="#l2221">2221</a><td>          self.execute(conditionFn).then(function(value) {<tr><td><a id="l2222"></a><a href="#l2222">2222</a><td>            var elapsed = goog.now() - startTime;<tr><td><a id="l2223"></a><a href="#l2223">2223</a><td>            if (!!value) {<tr><td><a id="l2224"></a><a href="#l2224">2224</a><td>              fulfill(value);<tr><td><a id="l2225"></a><a href="#l2225">2225</a><td>            } else if (timeout &amp;&amp; elapsed &gt;= timeout) {<tr><td><a id="l2226"></a><a href="#l2226">2226</a><td>              reject(new Error((opt_message ? opt_message + &#39;\n&#39; : &#39;&#39;) +<tr><td><a id="l2227"></a><a href="#l2227">2227</a><td>                               &#39;Wait timed out after &#39; + elapsed + &#39;ms&#39;));<tr><td><a id="l2228"></a><a href="#l2228">2228</a><td>            } else {<tr><td><a id="l2229"></a><a href="#l2229">2229</a><td>              // Do not use asyncRun here because we need a non-micro yield<tr><td><a id="l2230"></a><a href="#l2230">2230</a><td>              // here so the UI thread is given a chance when running in a<tr><td><a id="l2231"></a><a href="#l2231">2231</a><td>              // browser.<tr><td><a id="l2232"></a><a href="#l2232">2232</a><td>              setTimeout(pollCondition, 0);<tr><td><a id="l2233"></a><a href="#l2233">2233</a><td>            }<tr><td><a id="l2234"></a><a href="#l2234">2234</a><td>          }, reject);<tr><td><a id="l2235"></a><a href="#l2235">2235</a><td>        }<tr><td><a id="l2236"></a><a href="#l2236">2236</a><td>      });<tr><td><a id="l2237"></a><a href="#l2237">2237</a><td>    }, opt_message || &#39;&lt;anonymous wait&gt;&#39;);<tr><td><a id="l2238"></a><a href="#l2238">2238</a><td>  },<tr><td><a id="l2239"></a><a href="#l2239">2239</a><td><tr><td><a id="l2240"></a><a href="#l2240">2240</a><td>  /**<tr><td><a id="l2241"></a><a href="#l2241">2241</a><td>   * Executes a function in the next available turn of the JavaScript event<tr><td><a id="l2242"></a><a href="#l2242">2242</a><td>   * loop. This ensures the function runs with its own task queue and any<tr><td><a id="l2243"></a><a href="#l2243">2243</a><td>   * scheduled tasks will run in &quot;parallel&quot; to those scheduled in the current<tr><td><a id="l2244"></a><a href="#l2244">2244</a><td>   * function.<tr><td><a id="l2245"></a><a href="#l2245">2245</a><td>   *<tr><td><a id="l2246"></a><a href="#l2246">2246</a><td>   *     flow.execute(() =&gt; console.log(&#39;a&#39;));<tr><td><a id="l2247"></a><a href="#l2247">2247</a><td>   *     flow.execute(() =&gt; console.log(&#39;b&#39;));<tr><td><a id="l2248"></a><a href="#l2248">2248</a><td>   *     flow.execute(() =&gt; console.log(&#39;c&#39;));<tr><td><a id="l2249"></a><a href="#l2249">2249</a><td>   *     flow.async(() =&gt; {<tr><td><a id="l2250"></a><a href="#l2250">2250</a><td>   *        flow.execute(() =&gt; console.log(&#39;d&#39;));<tr><td><a id="l2251"></a><a href="#l2251">2251</a><td>   *        flow.execute(() =&gt; console.log(&#39;e&#39;));<tr><td><a id="l2252"></a><a href="#l2252">2252</a><td>   *     });<tr><td><a id="l2253"></a><a href="#l2253">2253</a><td>   *     flow.async(() =&gt; {<tr><td><a id="l2254"></a><a href="#l2254">2254</a><td>   *        flow.execute(() =&gt; console.log(&#39;f&#39;));<tr><td><a id="l2255"></a><a href="#l2255">2255</a><td>   *        flow.execute(() =&gt; console.log(&#39;g&#39;));<tr><td><a id="l2256"></a><a href="#l2256">2256</a><td>   *     });<tr><td><a id="l2257"></a><a href="#l2257">2257</a><td>   *     flow.once(&#39;idle&#39;, () =&gt; console.log(&#39;fin&#39;));<tr><td><a id="l2258"></a><a href="#l2258">2258</a><td>   *     // a<tr><td><a id="l2259"></a><a href="#l2259">2259</a><td>   *     // d<tr><td><a id="l2260"></a><a href="#l2260">2260</a><td>   *     // f<tr><td><a id="l2261"></a><a href="#l2261">2261</a><td>   *     // b<tr><td><a id="l2262"></a><a href="#l2262">2262</a><td>   *     // e<tr><td><a id="l2263"></a><a href="#l2263">2263</a><td>   *     // g<tr><td><a id="l2264"></a><a href="#l2264">2264</a><td>   *     // c<tr><td><a id="l2265"></a><a href="#l2265">2265</a><td>   *     // fin<tr><td><a id="l2266"></a><a href="#l2266">2266</a><td>   *<tr><td><a id="l2267"></a><a href="#l2267">2267</a><td>   * If the function itself throws, the error will be treated the same as an<tr><td><a id="l2268"></a><a href="#l2268">2268</a><td>   * unhandled rejection within the control flow.<tr><td><a id="l2269"></a><a href="#l2269">2269</a><td>   *<tr><td><a id="l2270"></a><a href="#l2270">2270</a><td>   * __NOTE__: This function is considered _unstable_.<tr><td><a id="l2271"></a><a href="#l2271">2271</a><td>   *<tr><td><a id="l2272"></a><a href="#l2272">2272</a><td>   * @param {!Function} fn The function to execute.<tr><td><a id="l2273"></a><a href="#l2273">2273</a><td>   * @param {Object=} opt_self The object in whose context to run the function.<tr><td><a id="l2274"></a><a href="#l2274">2274</a><td>   * @param {...*} var_args Any arguments to pass to the function.<tr><td><a id="l2275"></a><a href="#l2275">2275</a><td>   */<tr><td><a id="l2276"></a><a href="#l2276">2276</a><td>  async: function(fn, opt_self, var_args) {<tr><td><a id="l2277"></a><a href="#l2277">2277</a><td>    asyncRun(function() {<tr><td><a id="l2278"></a><a href="#l2278">2278</a><td>      // Clear any lingering queues, forces getActiveQueue_ to create a new one.<tr><td><a id="l2279"></a><a href="#l2279">2279</a><td>      this.activeQueue_ = null;<tr><td><a id="l2280"></a><a href="#l2280">2280</a><td>      var q = this.getActiveQueue_();<tr><td><a id="l2281"></a><a href="#l2281">2281</a><td>      try {<tr><td><a id="l2282"></a><a href="#l2282">2282</a><td>        q.execute_(fn.bind(opt_self, var_args));<tr><td><a id="l2283"></a><a href="#l2283">2283</a><td>      } catch (ex) {<tr><td><a id="l2284"></a><a href="#l2284">2284</a><td>        var cancellationError = promise.CancellationError.wrap(ex,<tr><td><a id="l2285"></a><a href="#l2285">2285</a><td>            &#39;Function passed to ControlFlow.async() threw&#39;);<tr><td><a id="l2286"></a><a href="#l2286">2286</a><td>        cancellationError.silent_ = true;<tr><td><a id="l2287"></a><a href="#l2287">2287</a><td>        q.abort_(cancellationError);<tr><td><a id="l2288"></a><a href="#l2288">2288</a><td>      } finally {<tr><td><a id="l2289"></a><a href="#l2289">2289</a><td>        this.activeQueue_ = null;<tr><td><a id="l2290"></a><a href="#l2290">2290</a><td>      }<tr><td><a id="l2291"></a><a href="#l2291">2291</a><td>    }, this);<tr><td><a id="l2292"></a><a href="#l2292">2292</a><td>  },<tr><td><a id="l2293"></a><a href="#l2293">2293</a><td><tr><td><a id="l2294"></a><a href="#l2294">2294</a><td>  /**<tr><td><a id="l2295"></a><a href="#l2295">2295</a><td>   * Event handler for when a task queue is exhausted. This starts the shutdown<tr><td><a id="l2296"></a><a href="#l2296">2296</a><td>   * sequence for this instance if there are no remaining task queues: after<tr><td><a id="l2297"></a><a href="#l2297">2297</a><td>   * one turn of the event loop, this object will emit the<tr><td><a id="l2298"></a><a href="#l2298">2298</a><td>   * {@link webdriver.promise.ControlFlow.EventType.IDLE IDLE} event to signal<tr><td><a id="l2299"></a><a href="#l2299">2299</a><td>   * listeners that it has completed. During this wait, if another task is<tr><td><a id="l2300"></a><a href="#l2300">2300</a><td>   * scheduled, the shutdown will be aborted.<tr><td><a id="l2301"></a><a href="#l2301">2301</a><td>   *<tr><td><a id="l2302"></a><a href="#l2302">2302</a><td>   * @param {!TaskQueue} q the completed task queue.<tr><td><a id="l2303"></a><a href="#l2303">2303</a><td>   * @private<tr><td><a id="l2304"></a><a href="#l2304">2304</a><td>   */<tr><td><a id="l2305"></a><a href="#l2305">2305</a><td>  onQueueEnd_: function(q) {<tr><td><a id="l2306"></a><a href="#l2306">2306</a><td>    if (!this.taskQueues_) {<tr><td><a id="l2307"></a><a href="#l2307">2307</a><td>      return;<tr><td><a id="l2308"></a><a href="#l2308">2308</a><td>    }<tr><td><a id="l2309"></a><a href="#l2309">2309</a><td>    this.taskQueues_.delete(q);<tr><td><a id="l2310"></a><a href="#l2310">2310</a><td><tr><td><a id="l2311"></a><a href="#l2311">2311</a><td>    vlog(1, () =&gt; q + &#39; has finished&#39;);<tr><td><a id="l2312"></a><a href="#l2312">2312</a><td>    vlog(1, () =&gt; this.taskQueues_.size + &#39; queues remain\n&#39; + this, this);<tr><td><a id="l2313"></a><a href="#l2313">2313</a><td><tr><td><a id="l2314"></a><a href="#l2314">2314</a><td>    if (!this.taskQueues_.size) {<tr><td><a id="l2315"></a><a href="#l2315">2315</a><td>      asserts.assert(!this.shutdownTask_, &#39;Already have a shutdown task??&#39;);<tr><td><a id="l2316"></a><a href="#l2316">2316</a><td>      this.shutdownTask_ = new MicroTask(this.shutdown_, this);<tr><td><a id="l2317"></a><a href="#l2317">2317</a><td>    }<tr><td><a id="l2318"></a><a href="#l2318">2318</a><td>  },<tr><td><a id="l2319"></a><a href="#l2319">2319</a><td><tr><td><a id="l2320"></a><a href="#l2320">2320</a><td>  /**<tr><td><a id="l2321"></a><a href="#l2321">2321</a><td>   * Event handler for when a task queue terminates with an error. This triggers<tr><td><a id="l2322"></a><a href="#l2322">2322</a><td>   * the cancellation of all other task queues and a<tr><td><a id="l2323"></a><a href="#l2323">2323</a><td>   * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION} event.<tr><td><a id="l2324"></a><a href="#l2324">2324</a><td>   * If there are no error event listeners registered with this instance, the<tr><td><a id="l2325"></a><a href="#l2325">2325</a><td>   * error will be rethrown to the global error handler.<tr><td><a id="l2326"></a><a href="#l2326">2326</a><td>   *<tr><td><a id="l2327"></a><a href="#l2327">2327</a><td>   * @param {*} error the error that caused the task queue to terminate.<tr><td><a id="l2328"></a><a href="#l2328">2328</a><td>   * @param {!TaskQueue} q the task queue.<tr><td><a id="l2329"></a><a href="#l2329">2329</a><td>   * @private<tr><td><a id="l2330"></a><a href="#l2330">2330</a><td>   */<tr><td><a id="l2331"></a><a href="#l2331">2331</a><td>  onQueueError_: function(error, q) {<tr><td><a id="l2332"></a><a href="#l2332">2332</a><td>    if (this.taskQueues_) {<tr><td><a id="l2333"></a><a href="#l2333">2333</a><td>      this.taskQueues_.delete(q);<tr><td><a id="l2334"></a><a href="#l2334">2334</a><td>    }<tr><td><a id="l2335"></a><a href="#l2335">2335</a><td>    this.cancelQueues_(promise.CancellationError.wrap(<tr><td><a id="l2336"></a><a href="#l2336">2336</a><td>        error, &#39;There was an uncaught error in the control flow&#39;));<tr><td><a id="l2337"></a><a href="#l2337">2337</a><td>    this.cancelShutdown_();<tr><td><a id="l2338"></a><a href="#l2338">2338</a><td>    this.cancelHold_();<tr><td><a id="l2339"></a><a href="#l2339">2339</a><td><tr><td><a id="l2340"></a><a href="#l2340">2340</a><td>    var listeners = this.listeners(<tr><td><a id="l2341"></a><a href="#l2341">2341</a><td>      promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);<tr><td><a id="l2342"></a><a href="#l2342">2342</a><td>    if (!listeners.length) {<tr><td><a id="l2343"></a><a href="#l2343">2343</a><td>      throwException(error);<tr><td><a id="l2344"></a><a href="#l2344">2344</a><td>    } else {<tr><td><a id="l2345"></a><a href="#l2345">2345</a><td>      this.reportUncaughtException_(error);<tr><td><a id="l2346"></a><a href="#l2346">2346</a><td>    }<tr><td><a id="l2347"></a><a href="#l2347">2347</a><td>  },<tr><td><a id="l2348"></a><a href="#l2348">2348</a><td><tr><td><a id="l2349"></a><a href="#l2349">2349</a><td>  /**<tr><td><a id="l2350"></a><a href="#l2350">2350</a><td>   * Cancels all remaining task queues.<tr><td><a id="l2351"></a><a href="#l2351">2351</a><td>   * @param {!promise.CancellationError} reason The cancellation reason.<tr><td><a id="l2352"></a><a href="#l2352">2352</a><td>   * @private<tr><td><a id="l2353"></a><a href="#l2353">2353</a><td>   */<tr><td><a id="l2354"></a><a href="#l2354">2354</a><td>  cancelQueues_: function(reason) {<tr><td><a id="l2355"></a><a href="#l2355">2355</a><td>    reason.silent_ = true;<tr><td><a id="l2356"></a><a href="#l2356">2356</a><td>    if (this.taskQueues_) {<tr><td><a id="l2357"></a><a href="#l2357">2357</a><td>      for (var q of this.taskQueues_) {<tr><td><a id="l2358"></a><a href="#l2358">2358</a><td>        q.removeAllListeners();<tr><td><a id="l2359"></a><a href="#l2359">2359</a><td>        q.abort_(reason);<tr><td><a id="l2360"></a><a href="#l2360">2360</a><td>      }<tr><td><a id="l2361"></a><a href="#l2361">2361</a><td>      this.taskQueues_.clear();<tr><td><a id="l2362"></a><a href="#l2362">2362</a><td>      this.taskQueues_ = null;<tr><td><a id="l2363"></a><a href="#l2363">2363</a><td>    }<tr><td><a id="l2364"></a><a href="#l2364">2364</a><td>  },<tr><td><a id="l2365"></a><a href="#l2365">2365</a><td><tr><td><a id="l2366"></a><a href="#l2366">2366</a><td>  /**<tr><td><a id="l2367"></a><a href="#l2367">2367</a><td>   * Reports an uncaught exception using a<tr><td><a id="l2368"></a><a href="#l2368">2368</a><td>   * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION} event.<tr><td><a id="l2369"></a><a href="#l2369">2369</a><td>   *<tr><td><a id="l2370"></a><a href="#l2370">2370</a><td>   * @param {*} e the error to report.<tr><td><a id="l2371"></a><a href="#l2371">2371</a><td>   * @private<tr><td><a id="l2372"></a><a href="#l2372">2372</a><td>   */<tr><td><a id="l2373"></a><a href="#l2373">2373</a><td>  reportUncaughtException_: function(e) {<tr><td><a id="l2374"></a><a href="#l2374">2374</a><td>    this.emit(promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION, e);<tr><td><a id="l2375"></a><a href="#l2375">2375</a><td>  },<tr><td><a id="l2376"></a><a href="#l2376">2376</a><td><tr><td><a id="l2377"></a><a href="#l2377">2377</a><td>  /** @private */<tr><td><a id="l2378"></a><a href="#l2378">2378</a><td>  cancelHold_: function() {<tr><td><a id="l2379"></a><a href="#l2379">2379</a><td>    if (this.hold_) {<tr><td><a id="l2380"></a><a href="#l2380">2380</a><td>      clearInterval(this.hold_);<tr><td><a id="l2381"></a><a href="#l2381">2381</a><td>      this.hold_ = null;<tr><td><a id="l2382"></a><a href="#l2382">2382</a><td>    }<tr><td><a id="l2383"></a><a href="#l2383">2383</a><td>  },<tr><td><a id="l2384"></a><a href="#l2384">2384</a><td><tr><td><a id="l2385"></a><a href="#l2385">2385</a><td>  /** @private */<tr><td><a id="l2386"></a><a href="#l2386">2386</a><td>  shutdown_: function() {<tr><td><a id="l2387"></a><a href="#l2387">2387</a><td>    vlog(1, () =&gt; &#39;Going idle: &#39; + this);<tr><td><a id="l2388"></a><a href="#l2388">2388</a><td>    this.cancelHold_();<tr><td><a id="l2389"></a><a href="#l2389">2389</a><td>    this.shutdownTask_ = null;<tr><td><a id="l2390"></a><a href="#l2390">2390</a><td>    this.emit(promise.ControlFlow.EventType.IDLE);<tr><td><a id="l2391"></a><a href="#l2391">2391</a><td>  },<tr><td><a id="l2392"></a><a href="#l2392">2392</a><td><tr><td><a id="l2393"></a><a href="#l2393">2393</a><td>  /**<tr><td><a id="l2394"></a><a href="#l2394">2394</a><td>   * Cancels the shutdown sequence if it is currently scheduled.<tr><td><a id="l2395"></a><a href="#l2395">2395</a><td>   * @private<tr><td><a id="l2396"></a><a href="#l2396">2396</a><td>   */<tr><td><a id="l2397"></a><a href="#l2397">2397</a><td>  cancelShutdown_: function() {<tr><td><a id="l2398"></a><a href="#l2398">2398</a><td>    if (this.shutdownTask_) {<tr><td><a id="l2399"></a><a href="#l2399">2399</a><td>      this.shutdownTask_.cancel();<tr><td><a id="l2400"></a><a href="#l2400">2400</a><td>      this.shutdownTask_ = null;<tr><td><a id="l2401"></a><a href="#l2401">2401</a><td>    }<tr><td><a id="l2402"></a><a href="#l2402">2402</a><td>  }<tr><td><a id="l2403"></a><a href="#l2403">2403</a><td>});<tr><td><a id="l2404"></a><a href="#l2404">2404</a><td><tr><td><a id="l2405"></a><a href="#l2405">2405</a><td><tr><td><a id="l2406"></a><a href="#l2406">2406</a><td>/**<tr><td><a id="l2407"></a><a href="#l2407">2407</a><td> * Events that may be emitted by an {@link webdriver.promise.ControlFlow}.<tr><td><a id="l2408"></a><a href="#l2408">2408</a><td> * @enum {string}<tr><td><a id="l2409"></a><a href="#l2409">2409</a><td> */<tr><td><a id="l2410"></a><a href="#l2410">2410</a><td>promise.ControlFlow.EventType = {<tr><td><a id="l2411"></a><a href="#l2411">2411</a><td><tr><td><a id="l2412"></a><a href="#l2412">2412</a><td>  /** Emitted when all tasks have been successfully executed. */<tr><td><a id="l2413"></a><a href="#l2413">2413</a><td>  IDLE: &#39;idle&#39;,<tr><td><a id="l2414"></a><a href="#l2414">2414</a><td><tr><td><a id="l2415"></a><a href="#l2415">2415</a><td>  /** Emitted when a ControlFlow has been reset. */<tr><td><a id="l2416"></a><a href="#l2416">2416</a><td>  RESET: &#39;reset&#39;,<tr><td><a id="l2417"></a><a href="#l2417">2417</a><td><tr><td><a id="l2418"></a><a href="#l2418">2418</a><td>  /** Emitted whenever a new task has been scheduled. */<tr><td><a id="l2419"></a><a href="#l2419">2419</a><td>  SCHEDULE_TASK: &#39;scheduleTask&#39;,<tr><td><a id="l2420"></a><a href="#l2420">2420</a><td><tr><td><a id="l2421"></a><a href="#l2421">2421</a><td>  /**<tr><td><a id="l2422"></a><a href="#l2422">2422</a><td>   * Emitted whenever a control flow aborts due to an unhandled promise<tr><td><a id="l2423"></a><a href="#l2423">2423</a><td>   * rejection. This event will be emitted along with the offending rejection<tr><td><a id="l2424"></a><a href="#l2424">2424</a><td>   * reason. Upon emitting this event, the control flow will empty its task<tr><td><a id="l2425"></a><a href="#l2425">2425</a><td>   * queue and revert to its initial state.<tr><td><a id="l2426"></a><a href="#l2426">2426</a><td>   */<tr><td><a id="l2427"></a><a href="#l2427">2427</a><td>  UNCAUGHT_EXCEPTION: &#39;uncaughtException&#39;<tr><td><a id="l2428"></a><a href="#l2428">2428</a><td>};<tr><td><a id="l2429"></a><a href="#l2429">2429</a><td><tr><td><a id="l2430"></a><a href="#l2430">2430</a><td><tr><td><a id="l2431"></a><a href="#l2431">2431</a><td>/**<tr><td><a id="l2432"></a><a href="#l2432">2432</a><td> * Wraps a function to execute as a cancellable micro task.<tr><td><a id="l2433"></a><a href="#l2433">2433</a><td> * @final<tr><td><a id="l2434"></a><a href="#l2434">2434</a><td> */<tr><td><a id="l2435"></a><a href="#l2435">2435</a><td>var MicroTask = goog.defineClass(null, {<tr><td><a id="l2436"></a><a href="#l2436">2436</a><td>  /**<tr><td><a id="l2437"></a><a href="#l2437">2437</a><td>   * @param {function(this: THIS)} fn The function to run as a micro task.<tr><td><a id="l2438"></a><a href="#l2438">2438</a><td>   * @param {THIS=} opt_scope The scope to run the function in.<tr><td><a id="l2439"></a><a href="#l2439">2439</a><td>   * @template THIS<tr><td><a id="l2440"></a><a href="#l2440">2440</a><td>   */<tr><td><a id="l2441"></a><a href="#l2441">2441</a><td>  constructor: function(fn, opt_scope) {<tr><td><a id="l2442"></a><a href="#l2442">2442</a><td>    /** @private {boolean} */<tr><td><a id="l2443"></a><a href="#l2443">2443</a><td>    this.cancelled_ = false;<tr><td><a id="l2444"></a><a href="#l2444">2444</a><td>    asyncRun(function() {<tr><td><a id="l2445"></a><a href="#l2445">2445</a><td>      if (!this.cancelled_) {<tr><td><a id="l2446"></a><a href="#l2446">2446</a><td>        fn.call(opt_scope);<tr><td><a id="l2447"></a><a href="#l2447">2447</a><td>      }<tr><td><a id="l2448"></a><a href="#l2448">2448</a><td>    }, this);<tr><td><a id="l2449"></a><a href="#l2449">2449</a><td>  },<tr><td><a id="l2450"></a><a href="#l2450">2450</a><td><tr><td><a id="l2451"></a><a href="#l2451">2451</a><td>  /**<tr><td><a id="l2452"></a><a href="#l2452">2452</a><td>   * Cancels the execution of this task. Note: this will not prevent the task<tr><td><a id="l2453"></a><a href="#l2453">2453</a><td>   * timer from firing, just the invocation of the wrapped function.<tr><td><a id="l2454"></a><a href="#l2454">2454</a><td>   */<tr><td><a id="l2455"></a><a href="#l2455">2455</a><td>  cancel: function() {<tr><td><a id="l2456"></a><a href="#l2456">2456</a><td>    this.cancelled_ = true;<tr><td><a id="l2457"></a><a href="#l2457">2457</a><td>  }<tr><td><a id="l2458"></a><a href="#l2458">2458</a><td>});<tr><td><a id="l2459"></a><a href="#l2459">2459</a><td><tr><td><a id="l2460"></a><a href="#l2460">2460</a><td><tr><td><a id="l2461"></a><a href="#l2461">2461</a><td>/**<tr><td><a id="l2462"></a><a href="#l2462">2462</a><td> * A task to be executed by a {@link webdriver.promise.ControlFlow}.<tr><td><a id="l2463"></a><a href="#l2463">2463</a><td> *<tr><td><a id="l2464"></a><a href="#l2464">2464</a><td> * @final<tr><td><a id="l2465"></a><a href="#l2465">2465</a><td> */<tr><td><a id="l2466"></a><a href="#l2466">2466</a><td>var Task = goog.defineClass(promise.Deferred, {<tr><td><a id="l2467"></a><a href="#l2467">2467</a><td>  /**<tr><td><a id="l2468"></a><a href="#l2468">2468</a><td>   * @param {!promise.ControlFlow} flow The flow this instances belongs<tr><td><a id="l2469"></a><a href="#l2469">2469</a><td>   *     to.<tr><td><a id="l2470"></a><a href="#l2470">2470</a><td>   * @param {function(): (T|!promise.Promise&lt;T&gt;)} fn The function to<tr><td><a id="l2471"></a><a href="#l2471">2471</a><td>   *     call when the task executes. If it returns a<tr><td><a id="l2472"></a><a href="#l2472">2472</a><td>   *     {@link webdriver.promise.Promise}, the flow will wait for it to be<tr><td><a id="l2473"></a><a href="#l2473">2473</a><td>   *     resolved before starting the next task.<tr><td><a id="l2474"></a><a href="#l2474">2474</a><td>   * @param {string} description A description of the task for debugging.<tr><td><a id="l2475"></a><a href="#l2475">2475</a><td>   * @param {{name: string, top: !Function}=} opt_stackOptions Options to use<tr><td><a id="l2476"></a><a href="#l2476">2476</a><td>   *     when capturing the stacktrace for when this task was created.<tr><td><a id="l2477"></a><a href="#l2477">2477</a><td>   * @constructor<tr><td><a id="l2478"></a><a href="#l2478">2478</a><td>   * @extends {promise.Deferred&lt;T&gt;}<tr><td><a id="l2479"></a><a href="#l2479">2479</a><td>   * @template T<tr><td><a id="l2480"></a><a href="#l2480">2480</a><td>   */<tr><td><a id="l2481"></a><a href="#l2481">2481</a><td>  constructor: function(flow, fn, description, opt_stackOptions) {<tr><td><a id="l2482"></a><a href="#l2482">2482</a><td>    Task.base(this, &#39;constructor&#39;, flow);<tr><td><a id="l2483"></a><a href="#l2483">2483</a><td><tr><td><a id="l2484"></a><a href="#l2484">2484</a><td>    /** @type {function(): (T|!promise.Promise&lt;T&gt;)} */<tr><td><a id="l2485"></a><a href="#l2485">2485</a><td>    this.execute = fn;<tr><td><a id="l2486"></a><a href="#l2486">2486</a><td><tr><td><a id="l2487"></a><a href="#l2487">2487</a><td>    /** @type {string} */<tr><td><a id="l2488"></a><a href="#l2488">2488</a><td>    this.description = description;<tr><td><a id="l2489"></a><a href="#l2489">2489</a><td><tr><td><a id="l2490"></a><a href="#l2490">2490</a><td>    /** @type {TaskQueue} */<tr><td><a id="l2491"></a><a href="#l2491">2491</a><td>    this.queue = null;<tr><td><a id="l2492"></a><a href="#l2492">2492</a><td><tr><td><a id="l2493"></a><a href="#l2493">2493</a><td>    /**<tr><td><a id="l2494"></a><a href="#l2494">2494</a><td>     * Whether this task is volatile. Volatile tasks may be registered in a<tr><td><a id="l2495"></a><a href="#l2495">2495</a><td>     * a task queue, but will be dropped on the next turn of the JS event loop<tr><td><a id="l2496"></a><a href="#l2496">2496</a><td>     * if still marked volatile.<tr><td><a id="l2497"></a><a href="#l2497">2497</a><td>     * @type {boolean}<tr><td><a id="l2498"></a><a href="#l2498">2498</a><td>     */<tr><td><a id="l2499"></a><a href="#l2499">2499</a><td>    this.isVolatile = false;<tr><td><a id="l2500"></a><a href="#l2500">2500</a><td><tr><td><a id="l2501"></a><a href="#l2501">2501</a><td>    if (opt_stackOptions) {<tr><td><a id="l2502"></a><a href="#l2502">2502</a><td>      this.promise.stack_ = promise.captureStackTrace(<tr><td><a id="l2503"></a><a href="#l2503">2503</a><td>          opt_stackOptions.name, this.description, opt_stackOptions.top);<tr><td><a id="l2504"></a><a href="#l2504">2504</a><td>    }<tr><td><a id="l2505"></a><a href="#l2505">2505</a><td>  },<tr><td><a id="l2506"></a><a href="#l2506">2506</a><td><tr><td><a id="l2507"></a><a href="#l2507">2507</a><td>  /** @override */<tr><td><a id="l2508"></a><a href="#l2508">2508</a><td>  toString: function() {<tr><td><a id="l2509"></a><a href="#l2509">2509</a><td>    return &#39;Task::&#39; + goog.getUid(this) + &#39;&lt;&#39; + this.description + &#39;&gt;&#39;;<tr><td><a id="l2510"></a><a href="#l2510">2510</a><td>  }<tr><td><a id="l2511"></a><a href="#l2511">2511</a><td>});<tr><td><a id="l2512"></a><a href="#l2512">2512</a><td><tr><td><a id="l2513"></a><a href="#l2513">2513</a><td><tr><td><a id="l2514"></a><a href="#l2514">2514</a><td>/** @enum {string} */<tr><td><a id="l2515"></a><a href="#l2515">2515</a><td>var TaskQueueState = {<tr><td><a id="l2516"></a><a href="#l2516">2516</a><td>  NEW: &#39;new&#39;,<tr><td><a id="l2517"></a><a href="#l2517">2517</a><td>  STARTED: &#39;started&#39;,<tr><td><a id="l2518"></a><a href="#l2518">2518</a><td>  FINISHED: &#39;finished&#39;<tr><td><a id="l2519"></a><a href="#l2519">2519</a><td>};<tr><td><a id="l2520"></a><a href="#l2520">2520</a><td><tr><td><a id="l2521"></a><a href="#l2521">2521</a><td><tr><td><a id="l2522"></a><a href="#l2522">2522</a><td>/**<tr><td><a id="l2523"></a><a href="#l2523">2523</a><td> * @final<tr><td><a id="l2524"></a><a href="#l2524">2524</a><td> */<tr><td><a id="l2525"></a><a href="#l2525">2525</a><td>var TaskQueue = goog.defineClass(EventEmitter, {<tr><td><a id="l2526"></a><a href="#l2526">2526</a><td>  /** @param {!promise.ControlFlow} flow . */<tr><td><a id="l2527"></a><a href="#l2527">2527</a><td>  constructor: function(flow) {<tr><td><a id="l2528"></a><a href="#l2528">2528</a><td>    TaskQueue.base(this, &#39;constructor&#39;);<tr><td><a id="l2529"></a><a href="#l2529">2529</a><td>    goog.getUid(this);<tr><td><a id="l2530"></a><a href="#l2530">2530</a><td><tr><td><a id="l2531"></a><a href="#l2531">2531</a><td>    /** @private {string} */<tr><td><a id="l2532"></a><a href="#l2532">2532</a><td>    this.name_ = &#39;TaskQueue::&#39; + goog.getUid(this);<tr><td><a id="l2533"></a><a href="#l2533">2533</a><td><tr><td><a id="l2534"></a><a href="#l2534">2534</a><td>    /** @private {!promise.ControlFlow} */<tr><td><a id="l2535"></a><a href="#l2535">2535</a><td>    this.flow_ = flow;<tr><td><a id="l2536"></a><a href="#l2536">2536</a><td><tr><td><a id="l2537"></a><a href="#l2537">2537</a><td>    /** @private {!Array&lt;!Task&gt;} */<tr><td><a id="l2538"></a><a href="#l2538">2538</a><td>    this.tasks_ = [];<tr><td><a id="l2539"></a><a href="#l2539">2539</a><td><tr><td><a id="l2540"></a><a href="#l2540">2540</a><td>    /** @private {Array&lt;!Task&gt;} */<tr><td><a id="l2541"></a><a href="#l2541">2541</a><td>    this.volatileTasks_ = null;<tr><td><a id="l2542"></a><a href="#l2542">2542</a><td><tr><td><a id="l2543"></a><a href="#l2543">2543</a><td>    /** @private {Array&lt;!Task&gt;} */<tr><td><a id="l2544"></a><a href="#l2544">2544</a><td>    this.interrupts_ = null;<tr><td><a id="l2545"></a><a href="#l2545">2545</a><td><tr><td><a id="l2546"></a><a href="#l2546">2546</a><td>    /** @private {({task: !Task, q: !TaskQueue}|null)} */<tr><td><a id="l2547"></a><a href="#l2547">2547</a><td>    this.pending_ = null;<tr><td><a id="l2548"></a><a href="#l2548">2548</a><td><tr><td><a id="l2549"></a><a href="#l2549">2549</a><td>    /** @private {TaskQueueState} */<tr><td><a id="l2550"></a><a href="#l2550">2550</a><td>    this.state_ = TaskQueueState.NEW;<tr><td><a id="l2551"></a><a href="#l2551">2551</a><td><tr><td><a id="l2552"></a><a href="#l2552">2552</a><td>    /** @private {!Set&lt;!webdriver.promise.Promise&gt;} */<tr><td><a id="l2553"></a><a href="#l2553">2553</a><td>    this.unhandledRejections_ = new Set();<tr><td><a id="l2554"></a><a href="#l2554">2554</a><td>  },<tr><td><a id="l2555"></a><a href="#l2555">2555</a><td><tr><td><a id="l2556"></a><a href="#l2556">2556</a><td>  /** @override */<tr><td><a id="l2557"></a><a href="#l2557">2557</a><td>  toString: function() {<tr><td><a id="l2558"></a><a href="#l2558">2558</a><td>    return &#39;TaskQueue::&#39; + goog.getUid(this);<tr><td><a id="l2559"></a><a href="#l2559">2559</a><td>  },<tr><td><a id="l2560"></a><a href="#l2560">2560</a><td><tr><td><a id="l2561"></a><a href="#l2561">2561</a><td>  /**<tr><td><a id="l2562"></a><a href="#l2562">2562</a><td>   * @param {!webdriver.promise.Promise} promise .<tr><td><a id="l2563"></a><a href="#l2563">2563</a><td>   */<tr><td><a id="l2564"></a><a href="#l2564">2564</a><td>  addUnhandledRejection: function(promise) {<tr><td><a id="l2565"></a><a href="#l2565">2565</a><td>    // TODO: node 4.0.0+<tr><td><a id="l2566"></a><a href="#l2566">2566</a><td>    vlog(2, () =&gt; this + &#39; registering unhandled rejection: &#39; + promise, this);<tr><td><a id="l2567"></a><a href="#l2567">2567</a><td>    this.unhandledRejections_.add(promise);<tr><td><a id="l2568"></a><a href="#l2568">2568</a><td>  },<tr><td><a id="l2569"></a><a href="#l2569">2569</a><td><tr><td><a id="l2570"></a><a href="#l2570">2570</a><td>  /**<tr><td><a id="l2571"></a><a href="#l2571">2571</a><td>   * @param {!webdriver.promise.Promise} promise .<tr><td><a id="l2572"></a><a href="#l2572">2572</a><td>   */<tr><td><a id="l2573"></a><a href="#l2573">2573</a><td>  clearUnhandledRejection: function(promise) {<tr><td><a id="l2574"></a><a href="#l2574">2574</a><td>    var deleted = this.unhandledRejections_.delete(promise);<tr><td><a id="l2575"></a><a href="#l2575">2575</a><td>    if (deleted) {<tr><td><a id="l2576"></a><a href="#l2576">2576</a><td>      // TODO: node 4.0.0+<tr><td><a id="l2577"></a><a href="#l2577">2577</a><td>      vlog(2, () =&gt; this + &#39; clearing unhandled rejection: &#39; + promise, this);<tr><td><a id="l2578"></a><a href="#l2578">2578</a><td>    }<tr><td><a id="l2579"></a><a href="#l2579">2579</a><td>  },<tr><td><a id="l2580"></a><a href="#l2580">2580</a><td><tr><td><a id="l2581"></a><a href="#l2581">2581</a><td>  /**<tr><td><a id="l2582"></a><a href="#l2582">2582</a><td>   * Enqueues a new task for execution.<tr><td><a id="l2583"></a><a href="#l2583">2583</a><td>   * @param {!Task} task The task to enqueue.<tr><td><a id="l2584"></a><a href="#l2584">2584</a><td>   * @throws {Error} If this instance has already started execution.<tr><td><a id="l2585"></a><a href="#l2585">2585</a><td>   */<tr><td><a id="l2586"></a><a href="#l2586">2586</a><td>  enqueue: function(task) {<tr><td><a id="l2587"></a><a href="#l2587">2587</a><td>    if (this.state_ !== TaskQueueState.NEW) {<tr><td><a id="l2588"></a><a href="#l2588">2588</a><td>      throw Error(&#39;TaskQueue has started: &#39; + this);<tr><td><a id="l2589"></a><a href="#l2589">2589</a><td>    }<tr><td><a id="l2590"></a><a href="#l2590">2590</a><td><tr><td><a id="l2591"></a><a href="#l2591">2591</a><td>    if (task.queue) {<tr><td><a id="l2592"></a><a href="#l2592">2592</a><td>      throw Error(&#39;Task is already scheduled in another queue&#39;);<tr><td><a id="l2593"></a><a href="#l2593">2593</a><td>    }<tr><td><a id="l2594"></a><a href="#l2594">2594</a><td><tr><td><a id="l2595"></a><a href="#l2595">2595</a><td>    if (task.isVolatile) {<tr><td><a id="l2596"></a><a href="#l2596">2596</a><td>      this.volatileTasks_ = this.volatileTasks_ || [];<tr><td><a id="l2597"></a><a href="#l2597">2597</a><td>      this.volatileTasks_.push(task);<tr><td><a id="l2598"></a><a href="#l2598">2598</a><td>    }<tr><td><a id="l2599"></a><a href="#l2599">2599</a><td><tr><td><a id="l2600"></a><a href="#l2600">2600</a><td>    this.tasks_.push(task);<tr><td><a id="l2601"></a><a href="#l2601">2601</a><td>    task.queue = this;<tr><td><a id="l2602"></a><a href="#l2602">2602</a><td>    task.promise[CANCEL_HANDLER_SYMBOL] =<tr><td><a id="l2603"></a><a href="#l2603">2603</a><td>        this.onTaskCancelled_.bind(this, task);<tr><td><a id="l2604"></a><a href="#l2604">2604</a><td><tr><td><a id="l2605"></a><a href="#l2605">2605</a><td>    vlog(1, () =&gt; this + &#39;.enqueue(&#39; + task + &#39;)&#39;, this);<tr><td><a id="l2606"></a><a href="#l2606">2606</a><td>    vlog(2, () =&gt; this.flow_.toString(), this);<tr><td><a id="l2607"></a><a href="#l2607">2607</a><td>  },<tr><td><a id="l2608"></a><a href="#l2608">2608</a><td><tr><td><a id="l2609"></a><a href="#l2609">2609</a><td>  /**<tr><td><a id="l2610"></a><a href="#l2610">2610</a><td>   * Schedules the callbacks registered on the given promise in this queue.<tr><td><a id="l2611"></a><a href="#l2611">2611</a><td>   *<tr><td><a id="l2612"></a><a href="#l2612">2612</a><td>   * @param {!promise.Promise} promise the promise whose callbacks should be<tr><td><a id="l2613"></a><a href="#l2613">2613</a><td>   *     registered as interrupts in this task queue.<tr><td><a id="l2614"></a><a href="#l2614">2614</a><td>   * @throws {Error} if this queue has already finished.<tr><td><a id="l2615"></a><a href="#l2615">2615</a><td>   */<tr><td><a id="l2616"></a><a href="#l2616">2616</a><td>  scheduleCallbacks: function(promise) {<tr><td><a id="l2617"></a><a href="#l2617">2617</a><td>    if (this.state_ === TaskQueueState.FINISHED) {<tr><td><a id="l2618"></a><a href="#l2618">2618</a><td>      throw new Error(&#39;cannot interrupt a finished q(&#39; + this + &#39;)&#39;);<tr><td><a id="l2619"></a><a href="#l2619">2619</a><td>    }<tr><td><a id="l2620"></a><a href="#l2620">2620</a><td><tr><td><a id="l2621"></a><a href="#l2621">2621</a><td>    if (this.pending_ &amp;&amp; this.pending_.task.promise === promise) {<tr><td><a id="l2622"></a><a href="#l2622">2622</a><td>      this.pending_.task.promise.queue_ = null;<tr><td><a id="l2623"></a><a href="#l2623">2623</a><td>      this.pending_ = null;<tr><td><a id="l2624"></a><a href="#l2624">2624</a><td>      asyncRun(this.executeNext_, this);<tr><td><a id="l2625"></a><a href="#l2625">2625</a><td>    }<tr><td><a id="l2626"></a><a href="#l2626">2626</a><td><tr><td><a id="l2627"></a><a href="#l2627">2627</a><td>    if (!promise.callbacks_) {<tr><td><a id="l2628"></a><a href="#l2628">2628</a><td>      return;<tr><td><a id="l2629"></a><a href="#l2629">2629</a><td>    }<tr><td><a id="l2630"></a><a href="#l2630">2630</a><td>    promise.callbacks_.forEach(function(cb) {<tr><td><a id="l2631"></a><a href="#l2631">2631</a><td>      cb.promise[CANCEL_HANDLER_SYMBOL] =<tr><td><a id="l2632"></a><a href="#l2632">2632</a><td>        this.onTaskCancelled_.bind(this, cb);<tr><td><a id="l2633"></a><a href="#l2633">2633</a><td><tr><td><a id="l2634"></a><a href="#l2634">2634</a><td>      cb.isVolatile = false;<tr><td><a id="l2635"></a><a href="#l2635">2635</a><td>      if (cb.queue === this &amp;&amp; this.tasks_.indexOf(cb) !== -1) {<tr><td><a id="l2636"></a><a href="#l2636">2636</a><td>        return;<tr><td><a id="l2637"></a><a href="#l2637">2637</a><td>      }<tr><td><a id="l2638"></a><a href="#l2638">2638</a><td><tr><td><a id="l2639"></a><a href="#l2639">2639</a><td>      if (cb.queue) {<tr><td><a id="l2640"></a><a href="#l2640">2640</a><td>        cb.queue.dropTask_(cb);<tr><td><a id="l2641"></a><a href="#l2641">2641</a><td>      }<tr><td><a id="l2642"></a><a href="#l2642">2642</a><td><tr><td><a id="l2643"></a><a href="#l2643">2643</a><td>      cb.queue = this;<tr><td><a id="l2644"></a><a href="#l2644">2644</a><td>      if (!this.interrupts_) {<tr><td><a id="l2645"></a><a href="#l2645">2645</a><td>        this.interrupts_ = [];<tr><td><a id="l2646"></a><a href="#l2646">2646</a><td>      }<tr><td><a id="l2647"></a><a href="#l2647">2647</a><td>      this.interrupts_.push(cb);<tr><td><a id="l2648"></a><a href="#l2648">2648</a><td>    }, this);<tr><td><a id="l2649"></a><a href="#l2649">2649</a><td>    promise.callbacks_ = null;<tr><td><a id="l2650"></a><a href="#l2650">2650</a><td>    vlog(2, () =&gt; this + &#39; interrupted\n&#39; + this.flow_, this);<tr><td><a id="l2651"></a><a href="#l2651">2651</a><td>  },<tr><td><a id="l2652"></a><a href="#l2652">2652</a><td><tr><td><a id="l2653"></a><a href="#l2653">2653</a><td>  /**<tr><td><a id="l2654"></a><a href="#l2654">2654</a><td>   * Starts executing tasks in this queue. Once called, no further tasks may<tr><td><a id="l2655"></a><a href="#l2655">2655</a><td>   * be {@linkplain #enqueue() enqueued} with this instance.<tr><td><a id="l2656"></a><a href="#l2656">2656</a><td>   *<tr><td><a id="l2657"></a><a href="#l2657">2657</a><td>   * @throws {Error} if this queue has already been started.<tr><td><a id="l2658"></a><a href="#l2658">2658</a><td>   */<tr><td><a id="l2659"></a><a href="#l2659">2659</a><td>  start: function() {<tr><td><a id="l2660"></a><a href="#l2660">2660</a><td>    if (this.state_ !== TaskQueueState.NEW) {<tr><td><a id="l2661"></a><a href="#l2661">2661</a><td>      throw new Error(&#39;TaskQueue has already started&#39;);<tr><td><a id="l2662"></a><a href="#l2662">2662</a><td>    }<tr><td><a id="l2663"></a><a href="#l2663">2663</a><td>    // Always asynchronously execute next, even if there doesn&#39;t look like<tr><td><a id="l2664"></a><a href="#l2664">2664</a><td>    // there is anything in the queue. This will catch pending unhandled<tr><td><a id="l2665"></a><a href="#l2665">2665</a><td>    // rejections that were registered before start was called.<tr><td><a id="l2666"></a><a href="#l2666">2666</a><td>    asyncRun(this.executeNext_, this);<tr><td><a id="l2667"></a><a href="#l2667">2667</a><td>  },<tr><td><a id="l2668"></a><a href="#l2668">2668</a><td><tr><td><a id="l2669"></a><a href="#l2669">2669</a><td>  /**<tr><td><a id="l2670"></a><a href="#l2670">2670</a><td>   * Aborts this task queue. If there are any scheduled tasks, they are silently<tr><td><a id="l2671"></a><a href="#l2671">2671</a><td>   * cancelled and discarded (their callbacks will never fire). If this queue<tr><td><a id="l2672"></a><a href="#l2672">2672</a><td>   * has a _pending_ task, the abortion error is used to cancel that task.<tr><td><a id="l2673"></a><a href="#l2673">2673</a><td>   * Otherwise, this queue will emit an error event.<tr><td><a id="l2674"></a><a href="#l2674">2674</a><td>   *<tr><td><a id="l2675"></a><a href="#l2675">2675</a><td>   * @param {*} error The abortion reason.<tr><td><a id="l2676"></a><a href="#l2676">2676</a><td>   * @private<tr><td><a id="l2677"></a><a href="#l2677">2677</a><td>   */<tr><td><a id="l2678"></a><a href="#l2678">2678</a><td>  abort_: function(error) {<tr><td><a id="l2679"></a><a href="#l2679">2679</a><td>    var cancellation;<tr><td><a id="l2680"></a><a href="#l2680">2680</a><td><tr><td><a id="l2681"></a><a href="#l2681">2681</a><td>    if (error instanceof FlowResetError) {<tr><td><a id="l2682"></a><a href="#l2682">2682</a><td>      cancellation = error;<tr><td><a id="l2683"></a><a href="#l2683">2683</a><td>    } else {<tr><td><a id="l2684"></a><a href="#l2684">2684</a><td>      cancellation = new DiscardedTaskError(error);<tr><td><a id="l2685"></a><a href="#l2685">2685</a><td>    }<tr><td><a id="l2686"></a><a href="#l2686">2686</a><td><tr><td><a id="l2687"></a><a href="#l2687">2687</a><td>    if (this.interrupts_ &amp;&amp; this.interrupts_.length) {<tr><td><a id="l2688"></a><a href="#l2688">2688</a><td>      this.interrupts_.forEach((t) =&gt; t.reject(cancellation));<tr><td><a id="l2689"></a><a href="#l2689">2689</a><td>      this.interrupts_ = [];<tr><td><a id="l2690"></a><a href="#l2690">2690</a><td>    }<tr><td><a id="l2691"></a><a href="#l2691">2691</a><td><tr><td><a id="l2692"></a><a href="#l2692">2692</a><td>    if (this.tasks_ &amp;&amp; this.tasks_.length) {<tr><td><a id="l2693"></a><a href="#l2693">2693</a><td>      this.tasks_.forEach((t) =&gt; t.reject(cancellation));<tr><td><a id="l2694"></a><a href="#l2694">2694</a><td>      this.tasks_ = [];<tr><td><a id="l2695"></a><a href="#l2695">2695</a><td>    }<tr><td><a id="l2696"></a><a href="#l2696">2696</a><td><tr><td><a id="l2697"></a><a href="#l2697">2697</a><td>    if (this.pending_) {<tr><td><a id="l2698"></a><a href="#l2698">2698</a><td>      vlog(2, () =&gt; this + &#39;.abort(); cancelling pending task&#39;, this);<tr><td><a id="l2699"></a><a href="#l2699">2699</a><td>      this.pending_.task.cancel(<tr><td><a id="l2700"></a><a href="#l2700">2700</a><td>          /** @type {!webdriver.promise.CancellationError} */(error));<tr><td><a id="l2701"></a><a href="#l2701">2701</a><td><tr><td><a id="l2702"></a><a href="#l2702">2702</a><td>    } else {<tr><td><a id="l2703"></a><a href="#l2703">2703</a><td>      vlog(2, () =&gt; this + &#39;.abort(); emitting error event&#39;, this);<tr><td><a id="l2704"></a><a href="#l2704">2704</a><td>      this.emit(&#39;error&#39;, error, this);<tr><td><a id="l2705"></a><a href="#l2705">2705</a><td>    }<tr><td><a id="l2706"></a><a href="#l2706">2706</a><td>  },<tr><td><a id="l2707"></a><a href="#l2707">2707</a><td><tr><td><a id="l2708"></a><a href="#l2708">2708</a><td>  /** @private */<tr><td><a id="l2709"></a><a href="#l2709">2709</a><td>  executeNext_: function() {<tr><td><a id="l2710"></a><a href="#l2710">2710</a><td>    if (this.state_ === TaskQueueState.FINISHED) {<tr><td><a id="l2711"></a><a href="#l2711">2711</a><td>      return;<tr><td><a id="l2712"></a><a href="#l2712">2712</a><td>    }<tr><td><a id="l2713"></a><a href="#l2713">2713</a><td>    this.state_ = TaskQueueState.STARTED;<tr><td><a id="l2714"></a><a href="#l2714">2714</a><td>    this.dropVolatileTasks_();<tr><td><a id="l2715"></a><a href="#l2715">2715</a><td><tr><td><a id="l2716"></a><a href="#l2716">2716</a><td>    if (this.pending_ != null || this.processUnhandledRejections_()) {<tr><td><a id="l2717"></a><a href="#l2717">2717</a><td>      return;<tr><td><a id="l2718"></a><a href="#l2718">2718</a><td>    }<tr><td><a id="l2719"></a><a href="#l2719">2719</a><td><tr><td><a id="l2720"></a><a href="#l2720">2720</a><td>    var task;<tr><td><a id="l2721"></a><a href="#l2721">2721</a><td>    do {<tr><td><a id="l2722"></a><a href="#l2722">2722</a><td>      task = this.getNextTask_();<tr><td><a id="l2723"></a><a href="#l2723">2723</a><td>    } while (task &amp;&amp; !task.promise.isPending());<tr><td><a id="l2724"></a><a href="#l2724">2724</a><td><tr><td><a id="l2725"></a><a href="#l2725">2725</a><td>    if (!task) {<tr><td><a id="l2726"></a><a href="#l2726">2726</a><td>      this.state_ = TaskQueueState.FINISHED;<tr><td><a id="l2727"></a><a href="#l2727">2727</a><td>      this.tasks_ = [];<tr><td><a id="l2728"></a><a href="#l2728">2728</a><td>      this.interrupts_ = null;<tr><td><a id="l2729"></a><a href="#l2729">2729</a><td>      vlog(2, () =&gt; this + &#39;.emit(end)&#39;, this);<tr><td><a id="l2730"></a><a href="#l2730">2730</a><td>      this.emit(&#39;end&#39;, this);<tr><td><a id="l2731"></a><a href="#l2731">2731</a><td>      return;<tr><td><a id="l2732"></a><a href="#l2732">2732</a><td>    }<tr><td><a id="l2733"></a><a href="#l2733">2733</a><td><tr><td><a id="l2734"></a><a href="#l2734">2734</a><td>    var self = this;<tr><td><a id="l2735"></a><a href="#l2735">2735</a><td>    var subQ = new TaskQueue(this.flow_);<tr><td><a id="l2736"></a><a href="#l2736">2736</a><td>    subQ.once(&#39;end&#39;, () =&gt; self.onTaskComplete_(result))<tr><td><a id="l2737"></a><a href="#l2737">2737</a><td>        .once(&#39;error&#39;, (e) =&gt; self.onTaskFailure_(result, e));<tr><td><a id="l2738"></a><a href="#l2738">2738</a><td>    vlog(2, () =&gt; self + &#39; created &#39; + subQ + &#39; for &#39; + task);<tr><td><a id="l2739"></a><a href="#l2739">2739</a><td><tr><td><a id="l2740"></a><a href="#l2740">2740</a><td>    var result = undefined;<tr><td><a id="l2741"></a><a href="#l2741">2741</a><td>    try {<tr><td><a id="l2742"></a><a href="#l2742">2742</a><td>      this.pending_ = {task: task, q: subQ};<tr><td><a id="l2743"></a><a href="#l2743">2743</a><td>      task.promise.queue_ = this;<tr><td><a id="l2744"></a><a href="#l2744">2744</a><td>      result = subQ.execute_(task.execute);<tr><td><a id="l2745"></a><a href="#l2745">2745</a><td>      subQ.start();<tr><td><a id="l2746"></a><a href="#l2746">2746</a><td>    } catch (ex) {<tr><td><a id="l2747"></a><a href="#l2747">2747</a><td>      subQ.abort_(ex);<tr><td><a id="l2748"></a><a href="#l2748">2748</a><td>    }<tr><td><a id="l2749"></a><a href="#l2749">2749</a><td>  },<tr><td><a id="l2750"></a><a href="#l2750">2750</a><td><tr><td><a id="l2751"></a><a href="#l2751">2751</a><td><tr><td><a id="l2752"></a><a href="#l2752">2752</a><td>  /**<tr><td><a id="l2753"></a><a href="#l2753">2753</a><td>   * @param {!Function} fn .<tr><td><a id="l2754"></a><a href="#l2754">2754</a><td>   * @return {T} .<tr><td><a id="l2755"></a><a href="#l2755">2755</a><td>   * @template T<tr><td><a id="l2756"></a><a href="#l2756">2756</a><td>   * @private<tr><td><a id="l2757"></a><a href="#l2757">2757</a><td>   */<tr><td><a id="l2758"></a><a href="#l2758">2758</a><td>  execute_: function(fn) {<tr><td><a id="l2759"></a><a href="#l2759">2759</a><td>    try {<tr><td><a id="l2760"></a><a href="#l2760">2760</a><td>      activeFlows.push(this.flow_);<tr><td><a id="l2761"></a><a href="#l2761">2761</a><td>      this.flow_.activeQueue_ = this;<tr><td><a id="l2762"></a><a href="#l2762">2762</a><td>      return fn();<tr><td><a id="l2763"></a><a href="#l2763">2763</a><td>    } finally {<tr><td><a id="l2764"></a><a href="#l2764">2764</a><td>      this.flow_.activeQueue_ = null;<tr><td><a id="l2765"></a><a href="#l2765">2765</a><td>      this.dropVolatileTasks_();<tr><td><a id="l2766"></a><a href="#l2766">2766</a><td>      activeFlows.pop();<tr><td><a id="l2767"></a><a href="#l2767">2767</a><td>    }<tr><td><a id="l2768"></a><a href="#l2768">2768</a><td>  },<tr><td><a id="l2769"></a><a href="#l2769">2769</a><td><tr><td><a id="l2770"></a><a href="#l2770">2770</a><td>  /**<tr><td><a id="l2771"></a><a href="#l2771">2771</a><td>   * Process any unhandled rejections registered with this task queue. If there<tr><td><a id="l2772"></a><a href="#l2772">2772</a><td>   * is a rejection, this queue will be aborted with the rejection error. If<tr><td><a id="l2773"></a><a href="#l2773">2773</a><td>   * there are multiple rejections registered, this queue will be aborted with<tr><td><a id="l2774"></a><a href="#l2774">2774</a><td>   * a {@link promise.MultipleUnhandledRejectionError}.<tr><td><a id="l2775"></a><a href="#l2775">2775</a><td>   * @return {boolean} whether there was an unhandled rejection.<tr><td><a id="l2776"></a><a href="#l2776">2776</a><td>   * @private<tr><td><a id="l2777"></a><a href="#l2777">2777</a><td>   */<tr><td><a id="l2778"></a><a href="#l2778">2778</a><td>  processUnhandledRejections_: function() {<tr><td><a id="l2779"></a><a href="#l2779">2779</a><td>    if (!this.unhandledRejections_.size) {<tr><td><a id="l2780"></a><a href="#l2780">2780</a><td>      return false;<tr><td><a id="l2781"></a><a href="#l2781">2781</a><td>    }<tr><td><a id="l2782"></a><a href="#l2782">2782</a><td><tr><td><a id="l2783"></a><a href="#l2783">2783</a><td>    var errors = new Set();<tr><td><a id="l2784"></a><a href="#l2784">2784</a><td>    for (var rejection of this.unhandledRejections_) {<tr><td><a id="l2785"></a><a href="#l2785">2785</a><td>      errors.add(rejection.value_);<tr><td><a id="l2786"></a><a href="#l2786">2786</a><td>    }<tr><td><a id="l2787"></a><a href="#l2787">2787</a><td>    this.unhandledRejections_.clear();<tr><td><a id="l2788"></a><a href="#l2788">2788</a><td><tr><td><a id="l2789"></a><a href="#l2789">2789</a><td>    var errorToReport = errors.size === 1<tr><td><a id="l2790"></a><a href="#l2790">2790</a><td>        ? errors.values().next().value<tr><td><a id="l2791"></a><a href="#l2791">2791</a><td>        : new promise.MultipleUnhandledRejectionError(errors);<tr><td><a id="l2792"></a><a href="#l2792">2792</a><td><tr><td><a id="l2793"></a><a href="#l2793">2793</a><td>    vlog(1, () =&gt; this + &#39; aborting due to unhandled rejections&#39;, this);<tr><td><a id="l2794"></a><a href="#l2794">2794</a><td>    if (this.flow_.propagateUnhandledRejections_) {<tr><td><a id="l2795"></a><a href="#l2795">2795</a><td>      this.abort_(errorToReport);<tr><td><a id="l2796"></a><a href="#l2796">2796</a><td>      return true;<tr><td><a id="l2797"></a><a href="#l2797">2797</a><td>    } else {<tr><td><a id="l2798"></a><a href="#l2798">2798</a><td>      vlog(1, &#39;error propagation disabled; reporting to control flow&#39;);<tr><td><a id="l2799"></a><a href="#l2799">2799</a><td>      this.flow_.reportUncaughtException_(errorToReport);<tr><td><a id="l2800"></a><a href="#l2800">2800</a><td>      return false;<tr><td><a id="l2801"></a><a href="#l2801">2801</a><td>    }<tr><td><a id="l2802"></a><a href="#l2802">2802</a><td>  },<tr><td><a id="l2803"></a><a href="#l2803">2803</a><td><tr><td><a id="l2804"></a><a href="#l2804">2804</a><td>  /**<tr><td><a id="l2805"></a><a href="#l2805">2805</a><td>   * Drops any volatile tasks scheduled within this task queue.<tr><td><a id="l2806"></a><a href="#l2806">2806</a><td>   * @private<tr><td><a id="l2807"></a><a href="#l2807">2807</a><td>   */<tr><td><a id="l2808"></a><a href="#l2808">2808</a><td>  dropVolatileTasks_: function() {<tr><td><a id="l2809"></a><a href="#l2809">2809</a><td>    if (!this.volatileTasks_) {<tr><td><a id="l2810"></a><a href="#l2810">2810</a><td>      return;<tr><td><a id="l2811"></a><a href="#l2811">2811</a><td>    }<tr><td><a id="l2812"></a><a href="#l2812">2812</a><td>    for (var task of this.volatileTasks_) {<tr><td><a id="l2813"></a><a href="#l2813">2813</a><td>      if (task.isVolatile) {<tr><td><a id="l2814"></a><a href="#l2814">2814</a><td>        vlog(2, () =&gt; this + &#39; dropping volatile task &#39; + task, this);<tr><td><a id="l2815"></a><a href="#l2815">2815</a><td>        this.dropTask_(task);<tr><td><a id="l2816"></a><a href="#l2816">2816</a><td>      }<tr><td><a id="l2817"></a><a href="#l2817">2817</a><td>    }<tr><td><a id="l2818"></a><a href="#l2818">2818</a><td>    this.volatileTasks_ = null;<tr><td><a id="l2819"></a><a href="#l2819">2819</a><td>  },<tr><td><a id="l2820"></a><a href="#l2820">2820</a><td><tr><td><a id="l2821"></a><a href="#l2821">2821</a><td>  /**<tr><td><a id="l2822"></a><a href="#l2822">2822</a><td>   * @param {!Task} task The task to drop.<tr><td><a id="l2823"></a><a href="#l2823">2823</a><td>   * @private<tr><td><a id="l2824"></a><a href="#l2824">2824</a><td>   */<tr><td><a id="l2825"></a><a href="#l2825">2825</a><td>  dropTask_: function(task) {<tr><td><a id="l2826"></a><a href="#l2826">2826</a><td>    var index;<tr><td><a id="l2827"></a><a href="#l2827">2827</a><td>    if (this.interrupts_) {<tr><td><a id="l2828"></a><a href="#l2828">2828</a><td>      index = this.interrupts_.indexOf(task);<tr><td><a id="l2829"></a><a href="#l2829">2829</a><td>      if (index != -1) {<tr><td><a id="l2830"></a><a href="#l2830">2830</a><td>        task.queue = null;<tr><td><a id="l2831"></a><a href="#l2831">2831</a><td>        this.interrupts_.splice(index, 1);<tr><td><a id="l2832"></a><a href="#l2832">2832</a><td>        return;<tr><td><a id="l2833"></a><a href="#l2833">2833</a><td>      }<tr><td><a id="l2834"></a><a href="#l2834">2834</a><td>    }<tr><td><a id="l2835"></a><a href="#l2835">2835</a><td><tr><td><a id="l2836"></a><a href="#l2836">2836</a><td>    index = this.tasks_.indexOf(task);<tr><td><a id="l2837"></a><a href="#l2837">2837</a><td>    if (index != -1) {<tr><td><a id="l2838"></a><a href="#l2838">2838</a><td>      task.queue = null;<tr><td><a id="l2839"></a><a href="#l2839">2839</a><td>      this.tasks_.splice(index, 1);<tr><td><a id="l2840"></a><a href="#l2840">2840</a><td>    }<tr><td><a id="l2841"></a><a href="#l2841">2841</a><td>  },<tr><td><a id="l2842"></a><a href="#l2842">2842</a><td><tr><td><a id="l2843"></a><a href="#l2843">2843</a><td>  /**<tr><td><a id="l2844"></a><a href="#l2844">2844</a><td>   * @param {!Task} task The task that was cancelled.<tr><td><a id="l2845"></a><a href="#l2845">2845</a><td>   * @param {!promise.CancellationError} reason The cancellation reason.<tr><td><a id="l2846"></a><a href="#l2846">2846</a><td>   * @private<tr><td><a id="l2847"></a><a href="#l2847">2847</a><td>   */<tr><td><a id="l2848"></a><a href="#l2848">2848</a><td>  onTaskCancelled_: function(task, reason) {<tr><td><a id="l2849"></a><a href="#l2849">2849</a><td>    if (this.pending_ &amp;&amp; this.pending_.task === task) {<tr><td><a id="l2850"></a><a href="#l2850">2850</a><td>      this.pending_.q.abort_(reason);<tr><td><a id="l2851"></a><a href="#l2851">2851</a><td>    } else {<tr><td><a id="l2852"></a><a href="#l2852">2852</a><td>      this.dropTask_(task);<tr><td><a id="l2853"></a><a href="#l2853">2853</a><td>    }<tr><td><a id="l2854"></a><a href="#l2854">2854</a><td>  },<tr><td><a id="l2855"></a><a href="#l2855">2855</a><td><tr><td><a id="l2856"></a><a href="#l2856">2856</a><td>  /**<tr><td><a id="l2857"></a><a href="#l2857">2857</a><td>   * @param {*} value the value originally returned by the task function.<tr><td><a id="l2858"></a><a href="#l2858">2858</a><td>   * @private<tr><td><a id="l2859"></a><a href="#l2859">2859</a><td>   */<tr><td><a id="l2860"></a><a href="#l2860">2860</a><td>  onTaskComplete_: function(value) {<tr><td><a id="l2861"></a><a href="#l2861">2861</a><td>    if (this.pending_) {<tr><td><a id="l2862"></a><a href="#l2862">2862</a><td>      this.pending_.task.fulfill(value);<tr><td><a id="l2863"></a><a href="#l2863">2863</a><td>    }<tr><td><a id="l2864"></a><a href="#l2864">2864</a><td>  },<tr><td><a id="l2865"></a><a href="#l2865">2865</a><td><tr><td><a id="l2866"></a><a href="#l2866">2866</a><td>  /**<tr><td><a id="l2867"></a><a href="#l2867">2867</a><td>   * @param {*} taskFnResult the value originally returned by the task function.<tr><td><a id="l2868"></a><a href="#l2868">2868</a><td>   * @param {*} error the error that caused the task function to terminate.<tr><td><a id="l2869"></a><a href="#l2869">2869</a><td>   * @private<tr><td><a id="l2870"></a><a href="#l2870">2870</a><td>   */<tr><td><a id="l2871"></a><a href="#l2871">2871</a><td>  onTaskFailure_: function(taskFnResult, error) {<tr><td><a id="l2872"></a><a href="#l2872">2872</a><td>    if (promise.Thenable.isImplementation(taskFnResult)) {<tr><td><a id="l2873"></a><a href="#l2873">2873</a><td>      taskFnResult.cancel(promise.CancellationError.wrap(error));<tr><td><a id="l2874"></a><a href="#l2874">2874</a><td>    }<tr><td><a id="l2875"></a><a href="#l2875">2875</a><td>    this.pending_.task.reject(error);<tr><td><a id="l2876"></a><a href="#l2876">2876</a><td>  },<tr><td><a id="l2877"></a><a href="#l2877">2877</a><td><tr><td><a id="l2878"></a><a href="#l2878">2878</a><td>  /**<tr><td><a id="l2879"></a><a href="#l2879">2879</a><td>   * @return {(Task|undefined)} the next task scheduled within this queue,<tr><td><a id="l2880"></a><a href="#l2880">2880</a><td>   *     if any.<tr><td><a id="l2881"></a><a href="#l2881">2881</a><td>   * @private<tr><td><a id="l2882"></a><a href="#l2882">2882</a><td>   */<tr><td><a id="l2883"></a><a href="#l2883">2883</a><td>  getNextTask_: function() {<tr><td><a id="l2884"></a><a href="#l2884">2884</a><td>    var task = undefined;<tr><td><a id="l2885"></a><a href="#l2885">2885</a><td>    if (this.interrupts_) {<tr><td><a id="l2886"></a><a href="#l2886">2886</a><td>      task = this.interrupts_.shift();<tr><td><a id="l2887"></a><a href="#l2887">2887</a><td>    }<tr><td><a id="l2888"></a><a href="#l2888">2888</a><td>    if (!task &amp;&amp; this.tasks_) {<tr><td><a id="l2889"></a><a href="#l2889">2889</a><td>      task = this.tasks_.shift();<tr><td><a id="l2890"></a><a href="#l2890">2890</a><td>    }<tr><td><a id="l2891"></a><a href="#l2891">2891</a><td>    return task;<tr><td><a id="l2892"></a><a href="#l2892">2892</a><td>  }<tr><td><a id="l2893"></a><a href="#l2893">2893</a><td>});<tr><td><a id="l2894"></a><a href="#l2894">2894</a><td><tr><td><a id="l2895"></a><a href="#l2895">2895</a><td><tr><td><a id="l2896"></a><a href="#l2896">2896</a><td><tr><td><a id="l2897"></a><a href="#l2897">2897</a><td>/**<tr><td><a id="l2898"></a><a href="#l2898">2898</a><td> * The default flow to use if no others are active.<tr><td><a id="l2899"></a><a href="#l2899">2899</a><td> * @type {!promise.ControlFlow}<tr><td><a id="l2900"></a><a href="#l2900">2900</a><td> */<tr><td><a id="l2901"></a><a href="#l2901">2901</a><td>var defaultFlow = new promise.ControlFlow();<tr><td><a id="l2902"></a><a href="#l2902">2902</a><td><tr><td><a id="l2903"></a><a href="#l2903">2903</a><td><tr><td><a id="l2904"></a><a href="#l2904">2904</a><td>/**<tr><td><a id="l2905"></a><a href="#l2905">2905</a><td> * A stack of active control flows, with the top of the stack used to schedule<tr><td><a id="l2906"></a><a href="#l2906">2906</a><td> * commands. When there are multiple flows on the stack, the flow at index N<tr><td><a id="l2907"></a><a href="#l2907">2907</a><td> * represents a callback triggered within a task owned by the flow at index<tr><td><a id="l2908"></a><a href="#l2908">2908</a><td> * N-1.<tr><td><a id="l2909"></a><a href="#l2909">2909</a><td> * @type {!Array&lt;!promise.ControlFlow&gt;}<tr><td><a id="l2910"></a><a href="#l2910">2910</a><td> */<tr><td><a id="l2911"></a><a href="#l2911">2911</a><td>var activeFlows = [];<tr><td><a id="l2912"></a><a href="#l2912">2912</a><td><tr><td><a id="l2913"></a><a href="#l2913">2913</a><td><tr><td><a id="l2914"></a><a href="#l2914">2914</a><td>/**<tr><td><a id="l2915"></a><a href="#l2915">2915</a><td> * Changes the default flow to use when no others are active.<tr><td><a id="l2916"></a><a href="#l2916">2916</a><td> * @param {!promise.ControlFlow} flow The new default flow.<tr><td><a id="l2917"></a><a href="#l2917">2917</a><td> * @throws {Error} If the default flow is not currently active.<tr><td><a id="l2918"></a><a href="#l2918">2918</a><td> */<tr><td><a id="l2919"></a><a href="#l2919">2919</a><td>promise.setDefaultFlow = function(flow) {<tr><td><a id="l2920"></a><a href="#l2920">2920</a><td>  if (activeFlows.length) {<tr><td><a id="l2921"></a><a href="#l2921">2921</a><td>    throw Error(&#39;You may only change the default flow while it is active&#39;);<tr><td><a id="l2922"></a><a href="#l2922">2922</a><td>  }<tr><td><a id="l2923"></a><a href="#l2923">2923</a><td>  defaultFlow = flow;<tr><td><a id="l2924"></a><a href="#l2924">2924</a><td>};<tr><td><a id="l2925"></a><a href="#l2925">2925</a><td><tr><td><a id="l2926"></a><a href="#l2926">2926</a><td><tr><td><a id="l2927"></a><a href="#l2927">2927</a><td>/**<tr><td><a id="l2928"></a><a href="#l2928">2928</a><td> * @return {!promise.ControlFlow} The currently active control flow.<tr><td><a id="l2929"></a><a href="#l2929">2929</a><td> */<tr><td><a id="l2930"></a><a href="#l2930">2930</a><td>promise.controlFlow = function() {<tr><td><a id="l2931"></a><a href="#l2931">2931</a><td>  return /** @type {!promise.ControlFlow} */ (<tr><td><a id="l2932"></a><a href="#l2932">2932</a><td>      Arrays.peek(activeFlows) || defaultFlow);<tr><td><a id="l2933"></a><a href="#l2933">2933</a><td>};<tr><td><a id="l2934"></a><a href="#l2934">2934</a><td><tr><td><a id="l2935"></a><a href="#l2935">2935</a><td><tr><td><a id="l2936"></a><a href="#l2936">2936</a><td>/**<tr><td><a id="l2937"></a><a href="#l2937">2937</a><td> * Creates a new control flow. The provided callback will be invoked as the<tr><td><a id="l2938"></a><a href="#l2938">2938</a><td> * first task within the new flow, with the flow as its sole argument. Returns<tr><td><a id="l2939"></a><a href="#l2939">2939</a><td> * a promise that resolves to the callback result.<tr><td><a id="l2940"></a><a href="#l2940">2940</a><td> * @param {function(!promise.ControlFlow)} callback The entry point<tr><td><a id="l2941"></a><a href="#l2941">2941</a><td> *     to the newly created flow.<tr><td><a id="l2942"></a><a href="#l2942">2942</a><td> * @return {!promise.Promise} A promise that resolves to the callback<tr><td><a id="l2943"></a><a href="#l2943">2943</a><td> *     result.<tr><td><a id="l2944"></a><a href="#l2944">2944</a><td> */<tr><td><a id="l2945"></a><a href="#l2945">2945</a><td>promise.createFlow = function(callback) {<tr><td><a id="l2946"></a><a href="#l2946">2946</a><td>  var flow = new promise.ControlFlow;<tr><td><a id="l2947"></a><a href="#l2947">2947</a><td>  return flow.execute(function() {<tr><td><a id="l2948"></a><a href="#l2948">2948</a><td>    return callback(flow);<tr><td><a id="l2949"></a><a href="#l2949">2949</a><td>  });<tr><td><a id="l2950"></a><a href="#l2950">2950</a><td>};<tr><td><a id="l2951"></a><a href="#l2951">2951</a><td><tr><td><a id="l2952"></a><a href="#l2952">2952</a><td><tr><td><a id="l2953"></a><a href="#l2953">2953</a><td>/**<tr><td><a id="l2954"></a><a href="#l2954">2954</a><td> * Tests is a function is a generator.<tr><td><a id="l2955"></a><a href="#l2955">2955</a><td> * @param {!Function} fn The function to test.<tr><td><a id="l2956"></a><a href="#l2956">2956</a><td> * @return {boolean} Whether the function is a generator.<tr><td><a id="l2957"></a><a href="#l2957">2957</a><td> */<tr><td><a id="l2958"></a><a href="#l2958">2958</a><td>promise.isGenerator = function(fn) {<tr><td><a id="l2959"></a><a href="#l2959">2959</a><td>  return fn.constructor.name === &#39;GeneratorFunction&#39;;<tr><td><a id="l2960"></a><a href="#l2960">2960</a><td>};<tr><td><a id="l2961"></a><a href="#l2961">2961</a><td><tr><td><a id="l2962"></a><a href="#l2962">2962</a><td><tr><td><a id="l2963"></a><a href="#l2963">2963</a><td>/**<tr><td><a id="l2964"></a><a href="#l2964">2964</a><td> * Consumes a {@code GeneratorFunction}. Each time the generator yields a<tr><td><a id="l2965"></a><a href="#l2965">2965</a><td> * promise, this function will wait for it to be fulfilled before feeding the<tr><td><a id="l2966"></a><a href="#l2966">2966</a><td> * fulfilled value back into {@code next}. Likewise, if a yielded promise is<tr><td><a id="l2967"></a><a href="#l2967">2967</a><td> * rejected, the rejection error will be passed to {@code throw}.<tr><td><a id="l2968"></a><a href="#l2968">2968</a><td> *<tr><td><a id="l2969"></a><a href="#l2969">2969</a><td> * __Example 1:__ the Fibonacci Sequence.<tr><td><a id="l2970"></a><a href="#l2970">2970</a><td> *<tr><td><a id="l2971"></a><a href="#l2971">2971</a><td> *     promise.consume(function* fibonacci() {<tr><td><a id="l2972"></a><a href="#l2972">2972</a><td> *       var n1 = 1, n2 = 1;<tr><td><a id="l2973"></a><a href="#l2973">2973</a><td> *       for (var i = 0; i &lt; 4; ++i) {<tr><td><a id="l2974"></a><a href="#l2974">2974</a><td> *         var tmp = yield n1 + n2;<tr><td><a id="l2975"></a><a href="#l2975">2975</a><td> *         n1 = n2;<tr><td><a id="l2976"></a><a href="#l2976">2976</a><td> *         n2 = tmp;<tr><td><a id="l2977"></a><a href="#l2977">2977</a><td> *       }<tr><td><a id="l2978"></a><a href="#l2978">2978</a><td> *       return n1 + n2;<tr><td><a id="l2979"></a><a href="#l2979">2979</a><td> *     }).then(function(result) {<tr><td><a id="l2980"></a><a href="#l2980">2980</a><td> *       console.log(result);  // 13<tr><td><a id="l2981"></a><a href="#l2981">2981</a><td> *     });<tr><td><a id="l2982"></a><a href="#l2982">2982</a><td> *<tr><td><a id="l2983"></a><a href="#l2983">2983</a><td> * __Example 2:__ a generator that throws.<tr><td><a id="l2984"></a><a href="#l2984">2984</a><td> *<tr><td><a id="l2985"></a><a href="#l2985">2985</a><td> *     promise.consume(function* () {<tr><td><a id="l2986"></a><a href="#l2986">2986</a><td> *       yield promise.delayed(250).then(function() {<tr><td><a id="l2987"></a><a href="#l2987">2987</a><td> *         throw Error(&#39;boom&#39;);<tr><td><a id="l2988"></a><a href="#l2988">2988</a><td> *       });<tr><td><a id="l2989"></a><a href="#l2989">2989</a><td> *     }).thenCatch(function(e) {<tr><td><a id="l2990"></a><a href="#l2990">2990</a><td> *       console.log(e.toString());  // Error: boom<tr><td><a id="l2991"></a><a href="#l2991">2991</a><td> *     });<tr><td><a id="l2992"></a><a href="#l2992">2992</a><td> *<tr><td><a id="l2993"></a><a href="#l2993">2993</a><td> * @param {!Function} generatorFn The generator function to execute.<tr><td><a id="l2994"></a><a href="#l2994">2994</a><td> * @param {Object=} opt_self The object to use as &quot;this&quot; when invoking the<tr><td><a id="l2995"></a><a href="#l2995">2995</a><td> *     initial generator.<tr><td><a id="l2996"></a><a href="#l2996">2996</a><td> * @param {...*} var_args Any arguments to pass to the initial generator.<tr><td><a id="l2997"></a><a href="#l2997">2997</a><td> * @return {!promise.Promise&lt;?&gt;} A promise that will resolve to the<tr><td><a id="l2998"></a><a href="#l2998">2998</a><td> *     generator&#39;s final result.<tr><td><a id="l2999"></a><a href="#l2999">2999</a><td> * @throws {TypeError} If the given function is not a generator.<tr><td><a id="l3000"></a><a href="#l3000">3000</a><td> */<tr><td><a id="l3001"></a><a href="#l3001">3001</a><td>promise.consume = function(generatorFn, opt_self, var_args) {<tr><td><a id="l3002"></a><a href="#l3002">3002</a><td>  if (!promise.isGenerator(generatorFn)) {<tr><td><a id="l3003"></a><a href="#l3003">3003</a><td>    throw new TypeError(&#39;Input is not a GeneratorFunction: &#39; +<tr><td><a id="l3004"></a><a href="#l3004">3004</a><td>        generatorFn.constructor.name);<tr><td><a id="l3005"></a><a href="#l3005">3005</a><td>  }<tr><td><a id="l3006"></a><a href="#l3006">3006</a><td><tr><td><a id="l3007"></a><a href="#l3007">3007</a><td>  var deferred = promise.defer();<tr><td><a id="l3008"></a><a href="#l3008">3008</a><td>  var generator = generatorFn.apply(opt_self, Arrays.slice(arguments, 2));<tr><td><a id="l3009"></a><a href="#l3009">3009</a><td>  callNext();<tr><td><a id="l3010"></a><a href="#l3010">3010</a><td>  return deferred.promise;<tr><td><a id="l3011"></a><a href="#l3011">3011</a><td><tr><td><a id="l3012"></a><a href="#l3012">3012</a><td>  /** @param {*=} opt_value . */<tr><td><a id="l3013"></a><a href="#l3013">3013</a><td>  function callNext(opt_value) {<tr><td><a id="l3014"></a><a href="#l3014">3014</a><td>    pump(generator.next, opt_value);<tr><td><a id="l3015"></a><a href="#l3015">3015</a><td>  }<tr><td><a id="l3016"></a><a href="#l3016">3016</a><td><tr><td><a id="l3017"></a><a href="#l3017">3017</a><td>  /** @param {*=} opt_error . */<tr><td><a id="l3018"></a><a href="#l3018">3018</a><td>  function callThrow(opt_error) {<tr><td><a id="l3019"></a><a href="#l3019">3019</a><td>    // Dictionary lookup required because Closure compiler&#39;s built-in<tr><td><a id="l3020"></a><a href="#l3020">3020</a><td>    // externs does not include GeneratorFunction.prototype.throw.<tr><td><a id="l3021"></a><a href="#l3021">3021</a><td>    pump(generator[&#39;throw&#39;], opt_error);<tr><td><a id="l3022"></a><a href="#l3022">3022</a><td>  }<tr><td><a id="l3023"></a><a href="#l3023">3023</a><td><tr><td><a id="l3024"></a><a href="#l3024">3024</a><td>  function pump(fn, opt_arg) {<tr><td><a id="l3025"></a><a href="#l3025">3025</a><td>    if (!deferred.isPending()) {<tr><td><a id="l3026"></a><a href="#l3026">3026</a><td>      return;  // Defererd was cancelled; silently abort.<tr><td><a id="l3027"></a><a href="#l3027">3027</a><td>    }<tr><td><a id="l3028"></a><a href="#l3028">3028</a><td><tr><td><a id="l3029"></a><a href="#l3029">3029</a><td>    try {<tr><td><a id="l3030"></a><a href="#l3030">3030</a><td>      var result = fn.call(generator, opt_arg);<tr><td><a id="l3031"></a><a href="#l3031">3031</a><td>    } catch (ex) {<tr><td><a id="l3032"></a><a href="#l3032">3032</a><td>      deferred.reject(ex);<tr><td><a id="l3033"></a><a href="#l3033">3033</a><td>      return;<tr><td><a id="l3034"></a><a href="#l3034">3034</a><td>    }<tr><td><a id="l3035"></a><a href="#l3035">3035</a><td><tr><td><a id="l3036"></a><a href="#l3036">3036</a><td>    if (result.done) {<tr><td><a id="l3037"></a><a href="#l3037">3037</a><td>      deferred.fulfill(result.value);<tr><td><a id="l3038"></a><a href="#l3038">3038</a><td>      return;<tr><td><a id="l3039"></a><a href="#l3039">3039</a><td>    }<tr><td><a id="l3040"></a><a href="#l3040">3040</a><td><tr><td><a id="l3041"></a><a href="#l3041">3041</a><td>    promise.asap(result.value, callNext, callThrow);<tr><td><a id="l3042"></a><a href="#l3042">3042</a><td>  }<tr><td><a id="l3043"></a><a href="#l3043">3043</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/serializable.js.src.html b/docs/source/lib/webdriver/serializable.js.src.html
new file mode 100644
index 0000000..e2a092f
--- /dev/null
+++ b/docs/source/lib/webdriver/serializable.js.src.html
@@ -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>serializable.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/webdriver/serializable.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.provide(&#39;webdriver.Serializable&#39;);<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><tr><td><a id="l22"></a><a href="#l22">22</a><td>/**<tr><td><a id="l23"></a><a href="#l23">23</a><td> * Defines an object that can be asynchronously serialized to its WebDriver<tr><td><a id="l24"></a><a href="#l24">24</a><td> * wire representation.<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @constructor<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @template T<tr><td><a id="l28"></a><a href="#l28">28</a><td> */<tr><td><a id="l29"></a><a href="#l29">29</a><td>webdriver.Serializable = function() {};<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> * Returns either this instance&#39;s serialized represention, if immediately<tr><td><a id="l34"></a><a href="#l34">34</a><td> * available, or a promise for its serialized representation. This function is<tr><td><a id="l35"></a><a href="#l35">35</a><td> * conceptually equivalent to objects that have a {@code toJSON()} property,<tr><td><a id="l36"></a><a href="#l36">36</a><td> * except the serialize() result may be a promise or an object containing a<tr><td><a id="l37"></a><a href="#l37">37</a><td> * promise (which are not directly JSON friendly).<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @return {!(T|IThenable.&lt;!T&gt;)} This instance&#39;s serialized wire format.<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>webdriver.Serializable.prototype.serialize = 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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/session.js.src.html b/docs/source/lib/webdriver/session.js.src.html
index bc91970..488aeef 100644
--- a/docs/source/lib/webdriver/session.js.src.html
+++ b/docs/source/lib/webdriver/session.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>session.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/session.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.Session&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;webdriver.Capabilities&#39;);<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>/**<tr><td><a name="l22" href="#l22">22</a><td> * Contains information about a WebDriver session.<tr><td><a name="l23" href="#l23">23</a><td> * @param {string} id The session ID.<tr><td><a name="l24" href="#l24">24</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The session<tr><td><a name="l25" href="#l25">25</a><td> *     capabilities.<tr><td><a name="l26" href="#l26">26</a><td> * @constructor<tr><td><a name="l27" href="#l27">27</a><td> */<tr><td><a name="l28" href="#l28">28</a><td>webdriver.Session = function(id, capabilities) {<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td>  /** @private {string} */<tr><td><a name="l31" href="#l31">31</a><td>  this.id_ = id;<tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td>  /** @private {!webdriver.Capabilities} */<tr><td><a name="l34" href="#l34">34</a><td>  this.caps_ = new webdriver.Capabilities().merge(capabilities);<tr><td><a name="l35" href="#l35">35</a><td>};<tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td>/**<tr><td><a name="l39" href="#l39">39</a><td> * @return {string} This session&#39;s ID.<tr><td><a name="l40" href="#l40">40</a><td> */<tr><td><a name="l41" href="#l41">41</a><td>webdriver.Session.prototype.getId = function() {<tr><td><a name="l42" href="#l42">42</a><td>  return this.id_;<tr><td><a name="l43" href="#l43">43</a><td>};<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td>/**<tr><td><a name="l47" href="#l47">47</a><td> * @return {!webdriver.Capabilities} This session&#39;s capabilities.<tr><td><a name="l48" href="#l48">48</a><td> */<tr><td><a name="l49" href="#l49">49</a><td>webdriver.Session.prototype.getCapabilities = function() {<tr><td><a name="l50" href="#l50">50</a><td>  return this.caps_;<tr><td><a name="l51" href="#l51">51</a><td>};<tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td><tr><td><a name="l54" href="#l54">54</a><td>/**<tr><td><a name="l55" href="#l55">55</a><td> * Retrieves the value of a specific capability.<tr><td><a name="l56" href="#l56">56</a><td> * @param {string} key The capability to retrieve.<tr><td><a name="l57" href="#l57">57</a><td> * @return {*} The capability value.<tr><td><a name="l58" href="#l58">58</a><td> */<tr><td><a name="l59" href="#l59">59</a><td>webdriver.Session.prototype.getCapability = function(key) {<tr><td><a name="l60" href="#l60">60</a><td>  return this.caps_.get(key);<tr><td><a name="l61" href="#l61">61</a><td>};<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/**<tr><td><a name="l65" href="#l65">65</a><td> * Returns the JSON representation of this object, which is just the string<tr><td><a name="l66" href="#l66">66</a><td> * session ID.<tr><td><a name="l67" href="#l67">67</a><td> * @return {string} The JSON representation of this Session.<tr><td><a name="l68" href="#l68">68</a><td> */<tr><td><a name="l69" href="#l69">69</a><td>webdriver.Session.prototype.toJSON = function() {<tr><td><a name="l70" href="#l70">70</a><td>  return this.getId();<tr><td><a name="l71" href="#l71">71</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>session.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/webdriver/session.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.provide(&#39;webdriver.Session&#39;);<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.require(&#39;webdriver.Capabilities&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>/**<tr><td><a id="l25"></a><a href="#l25">25</a><td> * Contains information about a WebDriver session.<tr><td><a id="l26"></a><a href="#l26">26</a><td> * @param {string} id The session ID.<tr><td><a id="l27"></a><a href="#l27">27</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The session<tr><td><a id="l28"></a><a href="#l28">28</a><td> *     capabilities.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @constructor<tr><td><a id="l30"></a><a href="#l30">30</a><td> */<tr><td><a id="l31"></a><a href="#l31">31</a><td>webdriver.Session = function(id, capabilities) {<tr><td><a id="l32"></a><a href="#l32">32</a><td><tr><td><a id="l33"></a><a href="#l33">33</a><td>  /** @private {string} */<tr><td><a id="l34"></a><a href="#l34">34</a><td>  this.id_ = id;<tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>  /** @private {!webdriver.Capabilities} */<tr><td><a id="l37"></a><a href="#l37">37</a><td>  this.caps_ = new webdriver.Capabilities().merge(capabilities);<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> * @return {string} This session&#39;s ID.<tr><td><a id="l43"></a><a href="#l43">43</a><td> */<tr><td><a id="l44"></a><a href="#l44">44</a><td>webdriver.Session.prototype.getId = function() {<tr><td><a id="l45"></a><a href="#l45">45</a><td>  return this.id_;<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>/**<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @return {!webdriver.Capabilities} This session&#39;s capabilities.<tr><td><a id="l51"></a><a href="#l51">51</a><td> */<tr><td><a id="l52"></a><a href="#l52">52</a><td>webdriver.Session.prototype.getCapabilities = function() {<tr><td><a id="l53"></a><a href="#l53">53</a><td>  return this.caps_;<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>/**<tr><td><a id="l58"></a><a href="#l58">58</a><td> * Retrieves the value of a specific capability.<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @param {string} key The capability to retrieve.<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @return {*} The capability value.<tr><td><a id="l61"></a><a href="#l61">61</a><td> */<tr><td><a id="l62"></a><a href="#l62">62</a><td>webdriver.Session.prototype.getCapability = function(key) {<tr><td><a id="l63"></a><a href="#l63">63</a><td>  return this.caps_.get(key);<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> * Returns the JSON representation of this object, which is just the string<tr><td><a id="l69"></a><a href="#l69">69</a><td> * session ID.<tr><td><a id="l70"></a><a href="#l70">70</a><td> * @return {string} The JSON representation of this Session.<tr><td><a id="l71"></a><a href="#l71">71</a><td> */<tr><td><a id="l72"></a><a href="#l72">72</a><td>webdriver.Session.prototype.toJSON = function() {<tr><td><a id="l73"></a><a href="#l73">73</a><td>  return this.getId();<tr><td><a id="l74"></a><a href="#l74">74</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/stacktrace.js.src.html b/docs/source/lib/webdriver/stacktrace.js.src.html
index 332f1ce..cf9311b 100644
--- a/docs/source/lib/webdriver/stacktrace.js.src.html
+++ b/docs/source/lib/webdriver/stacktrace.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>stacktrace.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/stacktrace.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2009 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2012 Selenium comitters<tr><td><a name="l3" href="#l3">3</a><td>// Copyright 2012 Software Freedom Conservancy<tr><td><a name="l4" href="#l4">4</a><td>//<tr><td><a name="l5" href="#l5">5</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l6" href="#l6">6</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l7" href="#l7">7</a><td>// You may obtain a copy of the License at<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l10" href="#l10">10</a><td>//<tr><td><a name="l11" href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l12" href="#l12">12</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l13" href="#l13">13</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l14" href="#l14">14</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l15" href="#l15">15</a><td>// limitations under the License.<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>/**<tr><td><a name="l18" href="#l18">18</a><td> * @fileoverview Tools for parsing and pretty printing error stack traces. This<tr><td><a name="l19" href="#l19">19</a><td> * file is based on goog.testing.stacktrace.<tr><td><a name="l20" href="#l20">20</a><td> */<tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;webdriver.stacktrace&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;webdriver.stacktrace.Snapshot&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>/**<tr><td><a name="l32" href="#l32">32</a><td> * Stores a snapshot of the stack trace at the time this instance was created.<tr><td><a name="l33" href="#l33">33</a><td> * The stack trace will always be adjusted to exclude this function call.<tr><td><a name="l34" href="#l34">34</a><td> * @param {number=} opt_slice The number of frames to remove from the top of<tr><td><a name="l35" href="#l35">35</a><td> *     the generated stack trace.<tr><td><a name="l36" href="#l36">36</a><td> * @constructor<tr><td><a name="l37" href="#l37">37</a><td> */<tr><td><a name="l38" href="#l38">38</a><td>webdriver.stacktrace.Snapshot = function(opt_slice) {<tr><td><a name="l39" href="#l39">39</a><td><tr><td><a name="l40" href="#l40">40</a><td>  /** @private {number} */<tr><td><a name="l41" href="#l41">41</a><td>  this.slice_ = opt_slice || 0;<tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>  var error;<tr><td><a name="l44" href="#l44">44</a><td>  if (webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_) {<tr><td><a name="l45" href="#l45">45</a><td>    error = Error();<tr><td><a name="l46" href="#l46">46</a><td>    Error.captureStackTrace(error, webdriver.stacktrace.Snapshot);<tr><td><a name="l47" href="#l47">47</a><td>  } else {<tr><td><a name="l48" href="#l48">48</a><td>    // Remove 1 extra frame for the call to this constructor.<tr><td><a name="l49" href="#l49">49</a><td>    this.slice_ += 1;<tr><td><a name="l50" href="#l50">50</a><td>    // IE will only create a stack trace when the Error is thrown.<tr><td><a name="l51" href="#l51">51</a><td>    // We use null.x() to throw an exception instead of throw this.error_<tr><td><a name="l52" href="#l52">52</a><td>    // because the closure compiler may optimize throws to a function call<tr><td><a name="l53" href="#l53">53</a><td>    // in an attempt to minimize the binary size which in turn has the side<tr><td><a name="l54" href="#l54">54</a><td>    // effect of adding an unwanted stack frame.<tr><td><a name="l55" href="#l55">55</a><td>    try {<tr><td><a name="l56" href="#l56">56</a><td>      null.x();<tr><td><a name="l57" href="#l57">57</a><td>    } catch (e) {<tr><td><a name="l58" href="#l58">58</a><td>      error = e;<tr><td><a name="l59" href="#l59">59</a><td>    }<tr><td><a name="l60" href="#l60">60</a><td>  }<tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td>  /**<tr><td><a name="l63" href="#l63">63</a><td>   * The error&#39;s stacktrace.  This must be accessed immediately to ensure Opera<tr><td><a name="l64" href="#l64">64</a><td>   * computes the context correctly.<tr><td><a name="l65" href="#l65">65</a><td>   * @private {string}<tr><td><a name="l66" href="#l66">66</a><td>   */<tr><td><a name="l67" href="#l67">67</a><td>  this.stack_ = webdriver.stacktrace.getStack_(error);<tr><td><a name="l68" href="#l68">68</a><td>};<tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td>/**<tr><td><a name="l72" href="#l72">72</a><td> * Whether the current environment supports the Error.captureStackTrace<tr><td><a name="l73" href="#l73">73</a><td> * function (as of 10/17/2012, only V8).<tr><td><a name="l74" href="#l74">74</a><td> * @private {boolean}<tr><td><a name="l75" href="#l75">75</a><td> * @const<tr><td><a name="l76" href="#l76">76</a><td> */<tr><td><a name="l77" href="#l77">77</a><td>webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_ =<tr><td><a name="l78" href="#l78">78</a><td>    goog.isFunction(Error.captureStackTrace);<tr><td><a name="l79" href="#l79">79</a><td><tr><td><a name="l80" href="#l80">80</a><td><tr><td><a name="l81" href="#l81">81</a><td>/**<tr><td><a name="l82" href="#l82">82</a><td> * Whether the current browser supports stack traces.<tr><td><a name="l83" href="#l83">83</a><td> *<tr><td><a name="l84" href="#l84">84</a><td> * @type {boolean}<tr><td><a name="l85" href="#l85">85</a><td> * @const<tr><td><a name="l86" href="#l86">86</a><td> */<tr><td><a name="l87" href="#l87">87</a><td>webdriver.stacktrace.BROWSER_SUPPORTED =<tr><td><a name="l88" href="#l88">88</a><td>    webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_ || (function() {<tr><td><a name="l89" href="#l89">89</a><td>      try {<tr><td><a name="l90" href="#l90">90</a><td>        throw Error();<tr><td><a name="l91" href="#l91">91</a><td>      } catch (e) {<tr><td><a name="l92" href="#l92">92</a><td>        return !!e.stack;<tr><td><a name="l93" href="#l93">93</a><td>      }<tr><td><a name="l94" href="#l94">94</a><td>    })();<tr><td><a name="l95" href="#l95">95</a><td><tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>/**<tr><td><a name="l98" href="#l98">98</a><td> * The parsed stack trace. This list is lazily generated the first time it is<tr><td><a name="l99" href="#l99">99</a><td> * accessed.<tr><td><a name="l100" href="#l100">100</a><td> * @private {Array.&lt;!webdriver.stacktrace.Frame&gt;}<tr><td><a name="l101" href="#l101">101</a><td> */<tr><td><a name="l102" href="#l102">102</a><td>webdriver.stacktrace.Snapshot.prototype.parsedStack_ = null;<tr><td><a name="l103" href="#l103">103</a><td><tr><td><a name="l104" href="#l104">104</a><td><tr><td><a name="l105" href="#l105">105</a><td>/**<tr><td><a name="l106" href="#l106">106</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} The parsed stack trace.<tr><td><a name="l107" href="#l107">107</a><td> */<tr><td><a name="l108" href="#l108">108</a><td>webdriver.stacktrace.Snapshot.prototype.getStacktrace = function() {<tr><td><a name="l109" href="#l109">109</a><td>  if (goog.isNull(this.parsedStack_)) {<tr><td><a name="l110" href="#l110">110</a><td>    this.parsedStack_ = webdriver.stacktrace.parse_(this.stack_);<tr><td><a name="l111" href="#l111">111</a><td>    if (this.slice_) {<tr><td><a name="l112" href="#l112">112</a><td>      this.parsedStack_ = goog.array.slice(this.parsedStack_, this.slice_);<tr><td><a name="l113" href="#l113">113</a><td>    }<tr><td><a name="l114" href="#l114">114</a><td>    delete this.slice_;<tr><td><a name="l115" href="#l115">115</a><td>    delete this.stack_;<tr><td><a name="l116" href="#l116">116</a><td>  }<tr><td><a name="l117" href="#l117">117</a><td>  return this.parsedStack_;<tr><td><a name="l118" href="#l118">118</a><td>};<tr><td><a name="l119" href="#l119">119</a><td><tr><td><a name="l120" href="#l120">120</a><td><tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td>/**<tr><td><a name="l123" href="#l123">123</a><td> * Class representing one stack frame.<tr><td><a name="l124" href="#l124">124</a><td> * @param {(string|undefined)} context Context object, empty in case of global<tr><td><a name="l125" href="#l125">125</a><td> *     functions or if the browser doesn&#39;t provide this information.<tr><td><a name="l126" href="#l126">126</a><td> * @param {(string|undefined)} name Function name, empty in case of anonymous<tr><td><a name="l127" href="#l127">127</a><td> *     functions.<tr><td><a name="l128" href="#l128">128</a><td> * @param {(string|undefined)} alias Alias of the function if available. For<tr><td><a name="l129" href="#l129">129</a><td> *     example the function name will be &#39;c&#39; and the alias will be &#39;b&#39; if the<tr><td><a name="l130" href="#l130">130</a><td> *     function is defined as &lt;code&gt;a.b = function c() {};&lt;/code&gt;.<tr><td><a name="l131" href="#l131">131</a><td> * @param {(string|undefined)} path File path or URL including line number and<tr><td><a name="l132" href="#l132">132</a><td> *     optionally column number separated by colons.<tr><td><a name="l133" href="#l133">133</a><td> * @constructor<tr><td><a name="l134" href="#l134">134</a><td> */<tr><td><a name="l135" href="#l135">135</a><td>webdriver.stacktrace.Frame = function(context, name, alias, path) {<tr><td><a name="l136" href="#l136">136</a><td><tr><td><a name="l137" href="#l137">137</a><td>  /** @private {string} */<tr><td><a name="l138" href="#l138">138</a><td>  this.context_ = context || &#39;&#39;;<tr><td><a name="l139" href="#l139">139</a><td><tr><td><a name="l140" href="#l140">140</a><td>  /** @private {string} */<tr><td><a name="l141" href="#l141">141</a><td>  this.name_ = name || &#39;&#39;;<tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td>  /** @private {string} */<tr><td><a name="l144" href="#l144">144</a><td>  this.alias_ = alias || &#39;&#39;;<tr><td><a name="l145" href="#l145">145</a><td><tr><td><a name="l146" href="#l146">146</a><td>  /** @private {string} */<tr><td><a name="l147" href="#l147">147</a><td>  this.path_ = path || &#39;&#39;;<tr><td><a name="l148" href="#l148">148</a><td><tr><td><a name="l149" href="#l149">149</a><td>  /** @private {string} */<tr><td><a name="l150" href="#l150">150</a><td>  this.url_ = this.path_;<tr><td><a name="l151" href="#l151">151</a><td><tr><td><a name="l152" href="#l152">152</a><td>  /** @private {number} */<tr><td><a name="l153" href="#l153">153</a><td>  this.line_ = -1;<tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td>  /** @private {number} */<tr><td><a name="l156" href="#l156">156</a><td>  this.column_ = -1;<tr><td><a name="l157" href="#l157">157</a><td><tr><td><a name="l158" href="#l158">158</a><td>  if (path) {<tr><td><a name="l159" href="#l159">159</a><td>    var match = /:(\d+)(?::(\d+))?$/.exec(path);<tr><td><a name="l160" href="#l160">160</a><td>    if (match) {<tr><td><a name="l161" href="#l161">161</a><td>      this.line_ = Number(match[1]);<tr><td><a name="l162" href="#l162">162</a><td>      this.column = Number(match[2] || -1);<tr><td><a name="l163" href="#l163">163</a><td>      this.url_ = path.substr(0, match.index);<tr><td><a name="l164" href="#l164">164</a><td>    }<tr><td><a name="l165" href="#l165">165</a><td>  }<tr><td><a name="l166" href="#l166">166</a><td>};<tr><td><a name="l167" href="#l167">167</a><td><tr><td><a name="l168" href="#l168">168</a><td><tr><td><a name="l169" href="#l169">169</a><td>/**<tr><td><a name="l170" href="#l170">170</a><td> * Constant for an anonymous frame.<tr><td><a name="l171" href="#l171">171</a><td> * @private {!webdriver.stacktrace.Frame}<tr><td><a name="l172" href="#l172">172</a><td> * @const<tr><td><a name="l173" href="#l173">173</a><td> */<tr><td><a name="l174" href="#l174">174</a><td>webdriver.stacktrace.ANONYMOUS_FRAME_ =<tr><td><a name="l175" href="#l175">175</a><td>    new webdriver.stacktrace.Frame(&#39;&#39;, &#39;&#39;, &#39;&#39;, &#39;&#39;);<tr><td><a name="l176" href="#l176">176</a><td><tr><td><a name="l177" href="#l177">177</a><td><tr><td><a name="l178" href="#l178">178</a><td>/**<tr><td><a name="l179" href="#l179">179</a><td> * @return {string} The function name or empty string if the function is<tr><td><a name="l180" href="#l180">180</a><td> *     anonymous and the object field which it&#39;s assigned to is unknown.<tr><td><a name="l181" href="#l181">181</a><td> */<tr><td><a name="l182" href="#l182">182</a><td>webdriver.stacktrace.Frame.prototype.getName = function() {<tr><td><a name="l183" href="#l183">183</a><td>  return this.name_;<tr><td><a name="l184" href="#l184">184</a><td>};<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td><tr><td><a name="l187" href="#l187">187</a><td>/**<tr><td><a name="l188" href="#l188">188</a><td> * @return {string} The url or empty string if it is unknown.<tr><td><a name="l189" href="#l189">189</a><td> */<tr><td><a name="l190" href="#l190">190</a><td>webdriver.stacktrace.Frame.prototype.getUrl = function() {<tr><td><a name="l191" href="#l191">191</a><td>  return this.url_;<tr><td><a name="l192" href="#l192">192</a><td>};<tr><td><a name="l193" href="#l193">193</a><td><tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td>/**<tr><td><a name="l196" href="#l196">196</a><td> * @return {number} The line number if known or -1 if it is unknown.<tr><td><a name="l197" href="#l197">197</a><td> */<tr><td><a name="l198" href="#l198">198</a><td>webdriver.stacktrace.Frame.prototype.getLine = function() {<tr><td><a name="l199" href="#l199">199</a><td>  return this.line_;<tr><td><a name="l200" href="#l200">200</a><td>};<tr><td><a name="l201" href="#l201">201</a><td><tr><td><a name="l202" href="#l202">202</a><td><tr><td><a name="l203" href="#l203">203</a><td>/**<tr><td><a name="l204" href="#l204">204</a><td> * @return {number} The column number if known and -1 if it is unknown.<tr><td><a name="l205" href="#l205">205</a><td> */<tr><td><a name="l206" href="#l206">206</a><td>webdriver.stacktrace.Frame.prototype.getColumn = function() {<tr><td><a name="l207" href="#l207">207</a><td>  return this.column_;<tr><td><a name="l208" href="#l208">208</a><td>};<tr><td><a name="l209" href="#l209">209</a><td><tr><td><a name="l210" href="#l210">210</a><td><tr><td><a name="l211" href="#l211">211</a><td>/**<tr><td><a name="l212" href="#l212">212</a><td> * @return {boolean} Whether the stack frame contains an anonymous function.<tr><td><a name="l213" href="#l213">213</a><td> */<tr><td><a name="l214" href="#l214">214</a><td>webdriver.stacktrace.Frame.prototype.isAnonymous = function() {<tr><td><a name="l215" href="#l215">215</a><td>  return !this.name_ || this.context_ == &#39;[object Object]&#39;;<tr><td><a name="l216" href="#l216">216</a><td>};<tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td><tr><td><a name="l219" href="#l219">219</a><td>/**<tr><td><a name="l220" href="#l220">220</a><td> * Converts this frame to its string representation using V8&#39;s stack trace<tr><td><a name="l221" href="#l221">221</a><td> * format: http://code.google.com/p/v8/wiki/JavaScriptStackTraceApi<tr><td><a name="l222" href="#l222">222</a><td> * @return {string} The string representation of this frame.<tr><td><a name="l223" href="#l223">223</a><td> * @override<tr><td><a name="l224" href="#l224">224</a><td> */<tr><td><a name="l225" href="#l225">225</a><td>webdriver.stacktrace.Frame.prototype.toString = function() {<tr><td><a name="l226" href="#l226">226</a><td>  var context = this.context_;<tr><td><a name="l227" href="#l227">227</a><td>  if (context &amp;&amp; context !== &#39;new &#39;) {<tr><td><a name="l228" href="#l228">228</a><td>    context += &#39;.&#39;;<tr><td><a name="l229" href="#l229">229</a><td>  }<tr><td><a name="l230" href="#l230">230</a><td>  context += this.name_;<tr><td><a name="l231" href="#l231">231</a><td>  context += this.alias_ ? &#39; [as &#39; + this.alias_ + &#39;]&#39; : &#39;&#39;;<tr><td><a name="l232" href="#l232">232</a><td><tr><td><a name="l233" href="#l233">233</a><td>  var path = this.path_ || &#39;&lt;anonymous&gt;&#39;;<tr><td><a name="l234" href="#l234">234</a><td>  return &#39;    at &#39; + (context ? context + &#39; (&#39; + path + &#39;)&#39; : path);<tr><td><a name="l235" href="#l235">235</a><td>};<tr><td><a name="l236" href="#l236">236</a><td><tr><td><a name="l237" href="#l237">237</a><td><tr><td><a name="l238" href="#l238">238</a><td>/**<tr><td><a name="l239" href="#l239">239</a><td> * Maximum length of a string that can be matched with a RegExp on<tr><td><a name="l240" href="#l240">240</a><td> * Firefox 3x. Exceeding this approximate length will cause string.match<tr><td><a name="l241" href="#l241">241</a><td> * to exceed Firefox&#39;s stack quota. This situation can be encountered<tr><td><a name="l242" href="#l242">242</a><td> * when goog.globalEval is invoked with a long argument; such as<tr><td><a name="l243" href="#l243">243</a><td> * when loading a module.<tr><td><a name="l244" href="#l244">244</a><td> * @private {number}<tr><td><a name="l245" href="#l245">245</a><td> * @const<tr><td><a name="l246" href="#l246">246</a><td> */<tr><td><a name="l247" href="#l247">247</a><td>webdriver.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_ = 500000;<tr><td><a name="l248" href="#l248">248</a><td><tr><td><a name="l249" href="#l249">249</a><td><tr><td><a name="l250" href="#l250">250</a><td>/**<tr><td><a name="l251" href="#l251">251</a><td> * RegExp pattern for JavaScript identifiers. We don&#39;t support Unicode<tr><td><a name="l252" href="#l252">252</a><td> * identifiers defined in ECMAScript v3.<tr><td><a name="l253" href="#l253">253</a><td> * @private {string}<tr><td><a name="l254" href="#l254">254</a><td> * @const<tr><td><a name="l255" href="#l255">255</a><td> */<tr><td><a name="l256" href="#l256">256</a><td>webdriver.stacktrace.IDENTIFIER_PATTERN_ = &#39;[a-zA-Z_$][\\w$]*&#39;;<tr><td><a name="l257" href="#l257">257</a><td><tr><td><a name="l258" href="#l258">258</a><td><tr><td><a name="l259" href="#l259">259</a><td>/**<tr><td><a name="l260" href="#l260">260</a><td> * Pattern for a matching the type on a fully-qualified name. Forms an<tr><td><a name="l261" href="#l261">261</a><td> * optional sub-match on the type. For example, in &quot;foo.bar.baz&quot;, will match on<tr><td><a name="l262" href="#l262">262</a><td> * &quot;foo.bar&quot;.<tr><td><a name="l263" href="#l263">263</a><td> * @private {string}<tr><td><a name="l264" href="#l264">264</a><td> * @const<tr><td><a name="l265" href="#l265">265</a><td> */<tr><td><a name="l266" href="#l266">266</a><td>webdriver.stacktrace.CONTEXT_PATTERN_ =<tr><td><a name="l267" href="#l267">267</a><td>    &#39;(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a name="l268" href="#l268">268</a><td>    &#39;(?:\\.&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)\\.&#39;;<tr><td><a name="l269" href="#l269">269</a><td><tr><td><a name="l270" href="#l270">270</a><td><tr><td><a name="l271" href="#l271">271</a><td>/**<tr><td><a name="l272" href="#l272">272</a><td> * Pattern for matching a fully qualified name. Will create two sub-matches:<tr><td><a name="l273" href="#l273">273</a><td> * the type (optional), and the name. For example, in &quot;foo.bar.baz&quot;, will<tr><td><a name="l274" href="#l274">274</a><td> * match on [&quot;foo.bar&quot;, &quot;baz&quot;].<tr><td><a name="l275" href="#l275">275</a><td> * @private {string}<tr><td><a name="l276" href="#l276">276</a><td> * @const<tr><td><a name="l277" href="#l277">277</a><td> */<tr><td><a name="l278" href="#l278">278</a><td>webdriver.stacktrace.QUALIFIED_NAME_PATTERN_ =<tr><td><a name="l279" href="#l279">279</a><td>    &#39;(?:&#39; + webdriver.stacktrace.CONTEXT_PATTERN_ + &#39;)?&#39; +<tr><td><a name="l280" href="#l280">280</a><td>    &#39;(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)&#39;;<tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td><tr><td><a name="l283" href="#l283">283</a><td>/**<tr><td><a name="l284" href="#l284">284</a><td> * RegExp pattern for function name alias in the V8 stack trace.<tr><td><a name="l285" href="#l285">285</a><td> * @private {string}<tr><td><a name="l286" href="#l286">286</a><td> * @const<tr><td><a name="l287" href="#l287">287</a><td> */<tr><td><a name="l288" href="#l288">288</a><td>webdriver.stacktrace.V8_ALIAS_PATTERN_ =<tr><td><a name="l289" href="#l289">289</a><td>    &#39;(?: \\[as (&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)\\])?&#39;;<tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td><tr><td><a name="l292" href="#l292">292</a><td>/**<tr><td><a name="l293" href="#l293">293</a><td> * RegExp pattern for function names and constructor calls in the V8 stack<tr><td><a name="l294" href="#l294">294</a><td> * trace.<tr><td><a name="l295" href="#l295">295</a><td> * @private {string}<tr><td><a name="l296" href="#l296">296</a><td> * @const<tr><td><a name="l297" href="#l297">297</a><td> */<tr><td><a name="l298" href="#l298">298</a><td>webdriver.stacktrace.V8_FUNCTION_NAME_PATTERN_ =<tr><td><a name="l299" href="#l299">299</a><td>    &#39;(?:&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;|&lt;anonymous&gt;)&#39;;<tr><td><a name="l300" href="#l300">300</a><td><tr><td><a name="l301" href="#l301">301</a><td><tr><td><a name="l302" href="#l302">302</a><td>/**<tr><td><a name="l303" href="#l303">303</a><td> * RegExp pattern for the context of a function call in V8. Creates two<tr><td><a name="l304" href="#l304">304</a><td> * submatches, only one of which will ever match: either the namespace<tr><td><a name="l305" href="#l305">305</a><td> * identifier (with optional &quot;new&quot; keyword in the case of a constructor call),<tr><td><a name="l306" href="#l306">306</a><td> * or just the &quot;new &quot; phrase for a top level constructor call.<tr><td><a name="l307" href="#l307">307</a><td> * @private {string}<tr><td><a name="l308" href="#l308">308</a><td> * @const<tr><td><a name="l309" href="#l309">309</a><td> */<tr><td><a name="l310" href="#l310">310</a><td>webdriver.stacktrace.V8_CONTEXT_PATTERN_ =<tr><td><a name="l311" href="#l311">311</a><td>    &#39;(?:((?:new )?(?:\\[object Object\\]|&#39; +<tr><td><a name="l312" href="#l312">312</a><td>    webdriver.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a name="l313" href="#l313">313</a><td>    &#39;(?:\\.&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)&#39; +<tr><td><a name="l314" href="#l314">314</a><td>    &#39;)\\.|(new ))&#39;;<tr><td><a name="l315" href="#l315">315</a><td><tr><td><a name="l316" href="#l316">316</a><td><tr><td><a name="l317" href="#l317">317</a><td>/**<tr><td><a name="l318" href="#l318">318</a><td> * RegExp pattern for function call in the V8 stack trace.<tr><td><a name="l319" href="#l319">319</a><td> * Creates 3 submatches with context object (optional), function name and<tr><td><a name="l320" href="#l320">320</a><td> * function alias (optional).<tr><td><a name="l321" href="#l321">321</a><td> * @private {string}<tr><td><a name="l322" href="#l322">322</a><td> * @const<tr><td><a name="l323" href="#l323">323</a><td> */<tr><td><a name="l324" href="#l324">324</a><td>webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_ =<tr><td><a name="l325" href="#l325">325</a><td>    &#39; (?:&#39; + webdriver.stacktrace.V8_CONTEXT_PATTERN_ + &#39;)?&#39; +<tr><td><a name="l326" href="#l326">326</a><td>    &#39;(&#39; + webdriver.stacktrace.V8_FUNCTION_NAME_PATTERN_ + &#39;)&#39; +<tr><td><a name="l327" href="#l327">327</a><td>    webdriver.stacktrace.V8_ALIAS_PATTERN_;<tr><td><a name="l328" href="#l328">328</a><td><tr><td><a name="l329" href="#l329">329</a><td><tr><td><a name="l330" href="#l330">330</a><td>/**<tr><td><a name="l331" href="#l331">331</a><td> * RegExp pattern for an URL + position inside the file.<tr><td><a name="l332" href="#l332">332</a><td> * @private {string}<tr><td><a name="l333" href="#l333">333</a><td> * @const<tr><td><a name="l334" href="#l334">334</a><td> */<tr><td><a name="l335" href="#l335">335</a><td>webdriver.stacktrace.URL_PATTERN_ =<tr><td><a name="l336" href="#l336">336</a><td>    &#39;((?:http|https|file)://[^\\s]+|javascript:.*)&#39;;<tr><td><a name="l337" href="#l337">337</a><td><tr><td><a name="l338" href="#l338">338</a><td><tr><td><a name="l339" href="#l339">339</a><td>/**<tr><td><a name="l340" href="#l340">340</a><td> * RegExp pattern for a location string in a V8 stack frame. Creates two<tr><td><a name="l341" href="#l341">341</a><td> * submatches for the location, one for enclosed in parentheticals and on<tr><td><a name="l342" href="#l342">342</a><td> * where the location appears alone (which will only occur if the location is<tr><td><a name="l343" href="#l343">343</a><td> * the only information in the frame).<tr><td><a name="l344" href="#l344">344</a><td> * @private {string}<tr><td><a name="l345" href="#l345">345</a><td> * @const<tr><td><a name="l346" href="#l346">346</a><td> * @see http://code.google.com/p/v8/wiki/JavaScriptStackTraceApi<tr><td><a name="l347" href="#l347">347</a><td> */<tr><td><a name="l348" href="#l348">348</a><td>webdriver.stacktrace.V8_LOCATION_PATTERN_ = &#39; (?:\\((.*)\\)|(.*))&#39;;<tr><td><a name="l349" href="#l349">349</a><td><tr><td><a name="l350" href="#l350">350</a><td><tr><td><a name="l351" href="#l351">351</a><td>/**<tr><td><a name="l352" href="#l352">352</a><td> * Regular expression for parsing one stack frame in V8.<tr><td><a name="l353" href="#l353">353</a><td> * @private {!RegExp}<tr><td><a name="l354" href="#l354">354</a><td> * @const<tr><td><a name="l355" href="#l355">355</a><td> */<tr><td><a name="l356" href="#l356">356</a><td>webdriver.stacktrace.V8_STACK_FRAME_REGEXP_ = new RegExp(&#39;^    at&#39; +<tr><td><a name="l357" href="#l357">357</a><td>    &#39;(?:&#39; + webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_ + &#39;)?&#39; +<tr><td><a name="l358" href="#l358">358</a><td>    webdriver.stacktrace.V8_LOCATION_PATTERN_ + &#39;$&#39;);<tr><td><a name="l359" href="#l359">359</a><td><tr><td><a name="l360" href="#l360">360</a><td><tr><td><a name="l361" href="#l361">361</a><td>/**<tr><td><a name="l362" href="#l362">362</a><td> * RegExp pattern for function names in the Firefox stack trace.<tr><td><a name="l363" href="#l363">363</a><td> * Firefox has extended identifiers to deal with inner functions and anonymous<tr><td><a name="l364" href="#l364">364</a><td> * functions: https://bugzilla.mozilla.org/show_bug.cgi?id=433529#c9<tr><td><a name="l365" href="#l365">365</a><td> * @private {string}<tr><td><a name="l366" href="#l366">366</a><td> * @const<tr><td><a name="l367" href="#l367">367</a><td> */<tr><td><a name="l368" href="#l368">368</a><td>webdriver.stacktrace.FIREFOX_FUNCTION_NAME_PATTERN_ =<tr><td><a name="l369" href="#l369">369</a><td>    webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;[\\w./&lt;$]*&#39;;<tr><td><a name="l370" href="#l370">370</a><td><tr><td><a name="l371" href="#l371">371</a><td><tr><td><a name="l372" href="#l372">372</a><td>/**<tr><td><a name="l373" href="#l373">373</a><td> * RegExp pattern for function call in the Firefox stack trace.<tr><td><a name="l374" href="#l374">374</a><td> * Creates a submatch for the function name.<tr><td><a name="l375" href="#l375">375</a><td> * @private {string}<tr><td><a name="l376" href="#l376">376</a><td> * @const<tr><td><a name="l377" href="#l377">377</a><td> */<tr><td><a name="l378" href="#l378">378</a><td>webdriver.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ =<tr><td><a name="l379" href="#l379">379</a><td>    &#39;(&#39; + webdriver.stacktrace.FIREFOX_FUNCTION_NAME_PATTERN_ + &#39;)?&#39; +<tr><td><a name="l380" href="#l380">380</a><td>    &#39;(?:\\(.*\\))?@&#39;;<tr><td><a name="l381" href="#l381">381</a><td><tr><td><a name="l382" href="#l382">382</a><td><tr><td><a name="l383" href="#l383">383</a><td>/**<tr><td><a name="l384" href="#l384">384</a><td> * Regular expression for parsing one stack frame in Firefox.<tr><td><a name="l385" href="#l385">385</a><td> * @private {!RegExp}<tr><td><a name="l386" href="#l386">386</a><td> * @const<tr><td><a name="l387" href="#l387">387</a><td> */<tr><td><a name="l388" href="#l388">388</a><td>webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&#39; +<tr><td><a name="l389" href="#l389">389</a><td>    webdriver.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ +<tr><td><a name="l390" href="#l390">390</a><td>    &#39;(?::0|&#39; + webdriver.stacktrace.URL_PATTERN_ + &#39;)$&#39;);<tr><td><a name="l391" href="#l391">391</a><td><tr><td><a name="l392" href="#l392">392</a><td><tr><td><a name="l393" href="#l393">393</a><td>/**<tr><td><a name="l394" href="#l394">394</a><td> * RegExp pattern for an anonymous function call in an Opera stack frame.<tr><td><a name="l395" href="#l395">395</a><td> * Creates 2 (optional) submatches: the context object and function name.<tr><td><a name="l396" href="#l396">396</a><td> * @private {string}<tr><td><a name="l397" href="#l397">397</a><td> * @const<tr><td><a name="l398" href="#l398">398</a><td> */<tr><td><a name="l399" href="#l399">399</a><td>webdriver.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ =<tr><td><a name="l400" href="#l400">400</a><td>    &#39;&lt;anonymous function(?:\\: &#39; +<tr><td><a name="l401" href="#l401">401</a><td>    webdriver.stacktrace.QUALIFIED_NAME_PATTERN_ + &#39;)?&gt;&#39;;<tr><td><a name="l402" href="#l402">402</a><td><tr><td><a name="l403" href="#l403">403</a><td><tr><td><a name="l404" href="#l404">404</a><td>/**<tr><td><a name="l405" href="#l405">405</a><td> * RegExp pattern for a function call in an Opera stack frame.<tr><td><a name="l406" href="#l406">406</a><td> * Creates 3 (optional) submatches: the function name (if not anonymous),<tr><td><a name="l407" href="#l407">407</a><td> * the aliased context object and the function name (if anonymous).<tr><td><a name="l408" href="#l408">408</a><td> * @private {string}<tr><td><a name="l409" href="#l409">409</a><td> * @const<tr><td><a name="l410" href="#l410">410</a><td> */<tr><td><a name="l411" href="#l411">411</a><td>webdriver.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ =<tr><td><a name="l412" href="#l412">412</a><td>    &#39;(?:(?:(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)|&#39; +<tr><td><a name="l413" href="#l413">413</a><td>    webdriver.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ +<tr><td><a name="l414" href="#l414">414</a><td>    &#39;)(?:\\(.*\\)))?@&#39;;<tr><td><a name="l415" href="#l415">415</a><td><tr><td><a name="l416" href="#l416">416</a><td><tr><td><a name="l417" href="#l417">417</a><td>/**<tr><td><a name="l418" href="#l418">418</a><td> * Regular expression for parsing on stack frame in Opera 11.68+<tr><td><a name="l419" href="#l419">419</a><td> * @private {!RegExp}<tr><td><a name="l420" href="#l420">420</a><td> * @const<tr><td><a name="l421" href="#l421">421</a><td> */<tr><td><a name="l422" href="#l422">422</a><td>webdriver.stacktrace.OPERA_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&#39; +<tr><td><a name="l423" href="#l423">423</a><td>    webdriver.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ +<tr><td><a name="l424" href="#l424">424</a><td>    webdriver.stacktrace.URL_PATTERN_ + &#39;?$&#39;);<tr><td><a name="l425" href="#l425">425</a><td><tr><td><a name="l426" href="#l426">426</a><td><tr><td><a name="l427" href="#l427">427</a><td>/**<tr><td><a name="l428" href="#l428">428</a><td> * RegExp pattern for function call in a Chakra (IE) stack trace. This<tr><td><a name="l429" href="#l429">429</a><td> * expression allows for identifiers like &#39;Anonymous function&#39;, &#39;eval code&#39;,<tr><td><a name="l430" href="#l430">430</a><td> * and &#39;Global code&#39;.<tr><td><a name="l431" href="#l431">431</a><td> * @private {string}<tr><td><a name="l432" href="#l432">432</a><td> * @const<tr><td><a name="l433" href="#l433">433</a><td> */<tr><td><a name="l434" href="#l434">434</a><td>webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_ = &#39;(&#39; +<tr><td><a name="l435" href="#l435">435</a><td>    webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;(?:\\s+\\w+)*)&#39;;<tr><td><a name="l436" href="#l436">436</a><td><tr><td><a name="l437" href="#l437">437</a><td><tr><td><a name="l438" href="#l438">438</a><td>/**<tr><td><a name="l439" href="#l439">439</a><td> * Regular expression for parsing on stack frame in Chakra (IE).<tr><td><a name="l440" href="#l440">440</a><td> * @private {!RegExp}<tr><td><a name="l441" href="#l441">441</a><td> * @const<tr><td><a name="l442" href="#l442">442</a><td> */<tr><td><a name="l443" href="#l443">443</a><td>webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_ = new RegExp(&#39;^   at &#39; +<tr><td><a name="l444" href="#l444">444</a><td>    webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_ +<tr><td><a name="l445" href="#l445">445</a><td>    &#39;\\s*(?:\\((.*)\\))$&#39;);<tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td><tr><td><a name="l448" href="#l448">448</a><td>/**<tr><td><a name="l449" href="#l449">449</a><td> * Placeholder for an unparsable frame in a stack trace generated by<tr><td><a name="l450" href="#l450">450</a><td> * {@link goog.testing.stacktrace}.<tr><td><a name="l451" href="#l451">451</a><td> * @private {string}<tr><td><a name="l452" href="#l452">452</a><td> * @const<tr><td><a name="l453" href="#l453">453</a><td> */<tr><td><a name="l454" href="#l454">454</a><td>webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_ = &#39;&gt; (unknown)&#39;;<tr><td><a name="l455" href="#l455">455</a><td><tr><td><a name="l456" href="#l456">456</a><td><tr><td><a name="l457" href="#l457">457</a><td>/**<tr><td><a name="l458" href="#l458">458</a><td> * Representation of an anonymous frame in a stack trace generated by<tr><td><a name="l459" href="#l459">459</a><td> * {@link goog.testing.stacktrace}.<tr><td><a name="l460" href="#l460">460</a><td> * @private {string}<tr><td><a name="l461" href="#l461">461</a><td> * @const<tr><td><a name="l462" href="#l462">462</a><td> */<tr><td><a name="l463" href="#l463">463</a><td>webdriver.stacktrace.ANONYMOUS_CLOSURE_FRAME_ = &#39;&gt; anonymous&#39;;<tr><td><a name="l464" href="#l464">464</a><td><tr><td><a name="l465" href="#l465">465</a><td><tr><td><a name="l466" href="#l466">466</a><td>/**<tr><td><a name="l467" href="#l467">467</a><td> * Pattern for a function call in a Closure stack trace. Creates three optional<tr><td><a name="l468" href="#l468">468</a><td> * submatches: the context, function name, and alias.<tr><td><a name="l469" href="#l469">469</a><td> * @private {string}<tr><td><a name="l470" href="#l470">470</a><td> * @const<tr><td><a name="l471" href="#l471">471</a><td> */<tr><td><a name="l472" href="#l472">472</a><td>webdriver.stacktrace.CLOSURE_FUNCTION_CALL_PATTERN_ =<tr><td><a name="l473" href="#l473">473</a><td>    webdriver.stacktrace.QUALIFIED_NAME_PATTERN_ +<tr><td><a name="l474" href="#l474">474</a><td>    &#39;(?:\\(.*\\))?&#39; +  // Ignore arguments if present.<tr><td><a name="l475" href="#l475">475</a><td>    webdriver.stacktrace.V8_ALIAS_PATTERN_;<tr><td><a name="l476" href="#l476">476</a><td><tr><td><a name="l477" href="#l477">477</a><td><tr><td><a name="l478" href="#l478">478</a><td>/**<tr><td><a name="l479" href="#l479">479</a><td> * Regular expression for parsing a stack frame generated by Closure&#39;s<tr><td><a name="l480" href="#l480">480</a><td> * {@link goog.testing.stacktrace}.<tr><td><a name="l481" href="#l481">481</a><td> * @private {!RegExp}<tr><td><a name="l482" href="#l482">482</a><td> * @const<tr><td><a name="l483" href="#l483">483</a><td> */<tr><td><a name="l484" href="#l484">484</a><td>webdriver.stacktrace.CLOSURE_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&gt; &#39; +<tr><td><a name="l485" href="#l485">485</a><td>    &#39;(?:&#39; + webdriver.stacktrace.CLOSURE_FUNCTION_CALL_PATTERN_ +<tr><td><a name="l486" href="#l486">486</a><td>    &#39;(?: at )?)?&#39; +<tr><td><a name="l487" href="#l487">487</a><td>    &#39;(?:(.*:\\d+:\\d+)|&#39; + webdriver.stacktrace.URL_PATTERN_ + &#39;)?$&#39;);<tr><td><a name="l488" href="#l488">488</a><td><tr><td><a name="l489" href="#l489">489</a><td><tr><td><a name="l490" href="#l490">490</a><td>/**<tr><td><a name="l491" href="#l491">491</a><td> * Parses one stack frame.<tr><td><a name="l492" href="#l492">492</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a name="l493" href="#l493">493</a><td> * @return {webdriver.stacktrace.Frame} Stack frame object or null if the<tr><td><a name="l494" href="#l494">494</a><td> *     parsing failed.<tr><td><a name="l495" href="#l495">495</a><td> * @private<tr><td><a name="l496" href="#l496">496</a><td> */<tr><td><a name="l497" href="#l497">497</a><td>webdriver.stacktrace.parseStackFrame_ = function(frameStr) {<tr><td><a name="l498" href="#l498">498</a><td>  var m = frameStr.match(webdriver.stacktrace.V8_STACK_FRAME_REGEXP_);<tr><td><a name="l499" href="#l499">499</a><td>  if (m) {<tr><td><a name="l500" href="#l500">500</a><td>    return new webdriver.stacktrace.Frame(<tr><td><a name="l501" href="#l501">501</a><td>        m[1] || m[2], m[3], m[4], m[5] || m[6]);<tr><td><a name="l502" href="#l502">502</a><td>  }<tr><td><a name="l503" href="#l503">503</a><td><tr><td><a name="l504" href="#l504">504</a><td>  if (frameStr.length &gt;<tr><td><a name="l505" href="#l505">505</a><td>      webdriver.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_) {<tr><td><a name="l506" href="#l506">506</a><td>    return webdriver.stacktrace.parseLongFirefoxFrame_(frameStr);<tr><td><a name="l507" href="#l507">507</a><td>  }<tr><td><a name="l508" href="#l508">508</a><td><tr><td><a name="l509" href="#l509">509</a><td>  m = frameStr.match(webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_);<tr><td><a name="l510" href="#l510">510</a><td>  if (m) {<tr><td><a name="l511" href="#l511">511</a><td>    return new webdriver.stacktrace.Frame(&#39;&#39;, m[1], &#39;&#39;, m[2]);<tr><td><a name="l512" href="#l512">512</a><td>  }<tr><td><a name="l513" href="#l513">513</a><td><tr><td><a name="l514" href="#l514">514</a><td>  m = frameStr.match(webdriver.stacktrace.OPERA_STACK_FRAME_REGEXP_);<tr><td><a name="l515" href="#l515">515</a><td>  if (m) {<tr><td><a name="l516" href="#l516">516</a><td>    return new webdriver.stacktrace.Frame(m[2], m[1] || m[3], &#39;&#39;, m[4]);<tr><td><a name="l517" href="#l517">517</a><td>  }<tr><td><a name="l518" href="#l518">518</a><td><tr><td><a name="l519" href="#l519">519</a><td>  m = frameStr.match(webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_);<tr><td><a name="l520" href="#l520">520</a><td>  if (m) {<tr><td><a name="l521" href="#l521">521</a><td>    return new webdriver.stacktrace.Frame(&#39;&#39;, m[1], &#39;&#39;, m[2]);<tr><td><a name="l522" href="#l522">522</a><td>  }<tr><td><a name="l523" href="#l523">523</a><td><tr><td><a name="l524" href="#l524">524</a><td>  if (frameStr == webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_ ||<tr><td><a name="l525" href="#l525">525</a><td>      frameStr == webdriver.stacktrace.ANONYMOUS_CLOSURE_FRAME_) {<tr><td><a name="l526" href="#l526">526</a><td>    return webdriver.stacktrace.ANONYMOUS_FRAME_;<tr><td><a name="l527" href="#l527">527</a><td>  }<tr><td><a name="l528" href="#l528">528</a><td><tr><td><a name="l529" href="#l529">529</a><td>  m = frameStr.match(webdriver.stacktrace.CLOSURE_STACK_FRAME_REGEXP_);<tr><td><a name="l530" href="#l530">530</a><td>  if (m) {<tr><td><a name="l531" href="#l531">531</a><td>    return new webdriver.stacktrace.Frame(m[1], m[2], m[3], m[4] || m[5]);<tr><td><a name="l532" href="#l532">532</a><td>  }<tr><td><a name="l533" href="#l533">533</a><td><tr><td><a name="l534" href="#l534">534</a><td>  return null;<tr><td><a name="l535" href="#l535">535</a><td>};<tr><td><a name="l536" href="#l536">536</a><td><tr><td><a name="l537" href="#l537">537</a><td><tr><td><a name="l538" href="#l538">538</a><td>/**<tr><td><a name="l539" href="#l539">539</a><td> * Parses a long firefox stack frame.<tr><td><a name="l540" href="#l540">540</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a name="l541" href="#l541">541</a><td> * @return {!webdriver.stacktrace.Frame} Stack frame object.<tr><td><a name="l542" href="#l542">542</a><td> * @private<tr><td><a name="l543" href="#l543">543</a><td> */<tr><td><a name="l544" href="#l544">544</a><td>webdriver.stacktrace.parseLongFirefoxFrame_ = function(frameStr) {<tr><td><a name="l545" href="#l545">545</a><td>  var firstParen = frameStr.indexOf(&#39;(&#39;);<tr><td><a name="l546" href="#l546">546</a><td>  var lastAmpersand = frameStr.lastIndexOf(&#39;@&#39;);<tr><td><a name="l547" href="#l547">547</a><td>  var lastColon = frameStr.lastIndexOf(&#39;:&#39;);<tr><td><a name="l548" href="#l548">548</a><td>  var functionName = &#39;&#39;;<tr><td><a name="l549" href="#l549">549</a><td>  if ((firstParen &gt;= 0) &amp;&amp; (firstParen &lt; lastAmpersand)) {<tr><td><a name="l550" href="#l550">550</a><td>    functionName = frameStr.substring(0, firstParen);<tr><td><a name="l551" href="#l551">551</a><td>  }<tr><td><a name="l552" href="#l552">552</a><td>  var loc = &#39;&#39;;<tr><td><a name="l553" href="#l553">553</a><td>  if ((lastAmpersand &gt;= 0) &amp;&amp; (lastAmpersand + 1 &lt; lastColon)) {<tr><td><a name="l554" href="#l554">554</a><td>    loc = frameStr.substring(lastAmpersand + 1);<tr><td><a name="l555" href="#l555">555</a><td>  }<tr><td><a name="l556" href="#l556">556</a><td>  return new webdriver.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, loc);<tr><td><a name="l557" href="#l557">557</a><td>};<tr><td><a name="l558" href="#l558">558</a><td><tr><td><a name="l559" href="#l559">559</a><td><tr><td><a name="l560" href="#l560">560</a><td>/**<tr><td><a name="l561" href="#l561">561</a><td> * Get an error&#39;s stack trace with the error string trimmed.<tr><td><a name="l562" href="#l562">562</a><td> * V8 prepends the string representation of an error to its stack trace.<tr><td><a name="l563" href="#l563">563</a><td> * This function trims the string so that the stack trace can be parsed<tr><td><a name="l564" href="#l564">564</a><td> * consistently with the other JS engines.<tr><td><a name="l565" href="#l565">565</a><td> * @param {!(Error|goog.testing.JsUnitException)} error The error.<tr><td><a name="l566" href="#l566">566</a><td> * @return {string} The stack trace string.<tr><td><a name="l567" href="#l567">567</a><td> * @private<tr><td><a name="l568" href="#l568">568</a><td> */<tr><td><a name="l569" href="#l569">569</a><td>webdriver.stacktrace.getStack_ = function(error) {<tr><td><a name="l570" href="#l570">570</a><td>  var stack = error.stack || error.stackTrace || &#39;&#39;;<tr><td><a name="l571" href="#l571">571</a><td>  var errorStr = error + &#39;\n&#39;;<tr><td><a name="l572" href="#l572">572</a><td>  if (goog.string.startsWith(stack, errorStr)) {<tr><td><a name="l573" href="#l573">573</a><td>    stack = stack.substring(errorStr.length);<tr><td><a name="l574" href="#l574">574</a><td>  }<tr><td><a name="l575" href="#l575">575</a><td>  return stack;<tr><td><a name="l576" href="#l576">576</a><td>};<tr><td><a name="l577" href="#l577">577</a><td><tr><td><a name="l578" href="#l578">578</a><td><tr><td><a name="l579" href="#l579">579</a><td>/**<tr><td><a name="l580" href="#l580">580</a><td> * Formats an error&#39;s stack trace.<tr><td><a name="l581" href="#l581">581</a><td> * @param {!(Error|goog.testing.JsUnitException)} error The error to format.<tr><td><a name="l582" href="#l582">582</a><td> * @return {!(Error|goog.testing.JsUnitException)} The formatted error.<tr><td><a name="l583" href="#l583">583</a><td> */<tr><td><a name="l584" href="#l584">584</a><td>webdriver.stacktrace.format = function(error) {<tr><td><a name="l585" href="#l585">585</a><td>  var stack = webdriver.stacktrace.getStack_(error);<tr><td><a name="l586" href="#l586">586</a><td>  var frames = webdriver.stacktrace.parse_(stack);<tr><td><a name="l587" href="#l587">587</a><td><tr><td><a name="l588" href="#l588">588</a><td>  // Older versions of IE simply return [object Error] for toString(), so<tr><td><a name="l589" href="#l589">589</a><td>  // only use that as a last resort.<tr><td><a name="l590" href="#l590">590</a><td>  var errorStr = &#39;&#39;;<tr><td><a name="l591" href="#l591">591</a><td>  if (error.message) {<tr><td><a name="l592" href="#l592">592</a><td>    errorStr = (error.name ? error.name + &#39;: &#39; : &#39;&#39;) + error.message;<tr><td><a name="l593" href="#l593">593</a><td>  } else {<tr><td><a name="l594" href="#l594">594</a><td>    errorStr = error.toString();<tr><td><a name="l595" href="#l595">595</a><td>  }<tr><td><a name="l596" href="#l596">596</a><td><tr><td><a name="l597" href="#l597">597</a><td>  // Ensure the error is in the V8 style with the error&#39;s string representation<tr><td><a name="l598" href="#l598">598</a><td>  // prepended to the stack.<tr><td><a name="l599" href="#l599">599</a><td>  error.stack = errorStr + &#39;\n&#39; + frames.join(&#39;\n&#39;);<tr><td><a name="l600" href="#l600">600</a><td>  return error;<tr><td><a name="l601" href="#l601">601</a><td>};<tr><td><a name="l602" href="#l602">602</a><td><tr><td><a name="l603" href="#l603">603</a><td><tr><td><a name="l604" href="#l604">604</a><td>/**<tr><td><a name="l605" href="#l605">605</a><td> * Parses an Error object&#39;s stack trace.<tr><td><a name="l606" href="#l606">606</a><td> * @param {string} stack The stack trace.<tr><td><a name="l607" href="#l607">607</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} Stack frames. The<tr><td><a name="l608" href="#l608">608</a><td> *     unrecognized frames will be nulled out.<tr><td><a name="l609" href="#l609">609</a><td> * @private<tr><td><a name="l610" href="#l610">610</a><td> */<tr><td><a name="l611" href="#l611">611</a><td>webdriver.stacktrace.parse_ = function(stack) {<tr><td><a name="l612" href="#l612">612</a><td>  if (!stack) {<tr><td><a name="l613" href="#l613">613</a><td>    return [];<tr><td><a name="l614" href="#l614">614</a><td>  }<tr><td><a name="l615" href="#l615">615</a><td><tr><td><a name="l616" href="#l616">616</a><td>  var lines = stack.<tr><td><a name="l617" href="#l617">617</a><td>      replace(/\s*$/, &#39;&#39;).<tr><td><a name="l618" href="#l618">618</a><td>      split(&#39;\n&#39;);<tr><td><a name="l619" href="#l619">619</a><td>  var frames = [];<tr><td><a name="l620" href="#l620">620</a><td>  for (var i = 0; i &lt; lines.length; i++) {<tr><td><a name="l621" href="#l621">621</a><td>    var frame = webdriver.stacktrace.parseStackFrame_(lines[i]);<tr><td><a name="l622" href="#l622">622</a><td>    // The first two frames will be:<tr><td><a name="l623" href="#l623">623</a><td>    //   webdriver.stacktrace.Snapshot()<tr><td><a name="l624" href="#l624">624</a><td>    //   webdriver.stacktrace.get()<tr><td><a name="l625" href="#l625">625</a><td>    // In the case of Opera, sometimes an extra frame is injected in the next<tr><td><a name="l626" href="#l626">626</a><td>    // frame with a reported line number of zero. The next line detects that<tr><td><a name="l627" href="#l627">627</a><td>    // case and skips that frame.<tr><td><a name="l628" href="#l628">628</a><td>    if (!(goog.userAgent.OPERA &amp;&amp; i == 2 &amp;&amp; frame.getLine() == 0)) {<tr><td><a name="l629" href="#l629">629</a><td>      frames.push(frame || webdriver.stacktrace.ANONYMOUS_FRAME_);<tr><td><a name="l630" href="#l630">630</a><td>    }<tr><td><a name="l631" href="#l631">631</a><td>  }<tr><td><a name="l632" href="#l632">632</a><td>  return frames;<tr><td><a name="l633" href="#l633">633</a><td>};<tr><td><a name="l634" href="#l634">634</a><td><tr><td><a name="l635" href="#l635">635</a><td><tr><td><a name="l636" href="#l636">636</a><td>/**<tr><td><a name="l637" href="#l637">637</a><td> * Gets the native stack trace if available otherwise follows the call chain.<tr><td><a name="l638" href="#l638">638</a><td> * The generated trace will exclude all frames up to and including the call to<tr><td><a name="l639" href="#l639">639</a><td> * this function.<tr><td><a name="l640" href="#l640">640</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} The frames of the stack trace.<tr><td><a name="l641" href="#l641">641</a><td> */<tr><td><a name="l642" href="#l642">642</a><td>webdriver.stacktrace.get = function() {<tr><td><a name="l643" href="#l643">643</a><td>  return new webdriver.stacktrace.Snapshot(1).getStacktrace();<tr><td><a name="l644" href="#l644">644</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>stacktrace.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/webdriver/stacktrace.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Tools for parsing and pretty printing error stack traces. This<tr><td><a id="l20"></a><a href="#l20">20</a><td> * file is based on goog.testing.stacktrace.<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>goog.provide(&#39;webdriver.stacktrace&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.stacktrace.Snapshot&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td><tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.require(&#39;goog.userAgent&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>/**<tr><td><a id="l33"></a><a href="#l33">33</a><td> * Stores a snapshot of the stack trace at the time this instance was created.<tr><td><a id="l34"></a><a href="#l34">34</a><td> * The stack trace will always be adjusted to exclude this function call.<tr><td><a id="l35"></a><a href="#l35">35</a><td> * @param {number=} opt_slice The number of frames to remove from the top of<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     the generated stack trace.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @constructor<tr><td><a id="l38"></a><a href="#l38">38</a><td> */<tr><td><a id="l39"></a><a href="#l39">39</a><td>webdriver.stacktrace.Snapshot = function(opt_slice) {<tr><td><a id="l40"></a><a href="#l40">40</a><td><tr><td><a id="l41"></a><a href="#l41">41</a><td>  /** @private {number} */<tr><td><a id="l42"></a><a href="#l42">42</a><td>  this.slice_ = opt_slice || 0;<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>  var error;<tr><td><a id="l45"></a><a href="#l45">45</a><td>  if (webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_) {<tr><td><a id="l46"></a><a href="#l46">46</a><td>    error = Error();<tr><td><a id="l47"></a><a href="#l47">47</a><td>    Error.captureStackTrace(error, webdriver.stacktrace.Snapshot);<tr><td><a id="l48"></a><a href="#l48">48</a><td>  } else {<tr><td><a id="l49"></a><a href="#l49">49</a><td>    // Remove 1 extra frame for the call to this constructor.<tr><td><a id="l50"></a><a href="#l50">50</a><td>    this.slice_ += 1;<tr><td><a id="l51"></a><a href="#l51">51</a><td>    // IE will only create a stack trace when the Error is thrown.<tr><td><a id="l52"></a><a href="#l52">52</a><td>    // We use null.x() to throw an exception instead of throw this.error_<tr><td><a id="l53"></a><a href="#l53">53</a><td>    // because the closure compiler may optimize throws to a function call<tr><td><a id="l54"></a><a href="#l54">54</a><td>    // in an attempt to minimize the binary size which in turn has the side<tr><td><a id="l55"></a><a href="#l55">55</a><td>    // effect of adding an unwanted stack frame.<tr><td><a id="l56"></a><a href="#l56">56</a><td>    try {<tr><td><a id="l57"></a><a href="#l57">57</a><td>      null.x();<tr><td><a id="l58"></a><a href="#l58">58</a><td>    } catch (e) {<tr><td><a id="l59"></a><a href="#l59">59</a><td>      error = e;<tr><td><a id="l60"></a><a href="#l60">60</a><td>    }<tr><td><a id="l61"></a><a href="#l61">61</a><td>  }<tr><td><a id="l62"></a><a href="#l62">62</a><td><tr><td><a id="l63"></a><a href="#l63">63</a><td>  /**<tr><td><a id="l64"></a><a href="#l64">64</a><td>   * The error&#39;s stacktrace.<tr><td><a id="l65"></a><a href="#l65">65</a><td>   * @private {string}<tr><td><a id="l66"></a><a href="#l66">66</a><td>   */<tr><td><a id="l67"></a><a href="#l67">67</a><td>  this.stack_ = webdriver.stacktrace.getStack(error);<tr><td><a id="l68"></a><a href="#l68">68</a><td>};<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td>/**<tr><td><a id="l72"></a><a href="#l72">72</a><td> * Whether the current environment supports the Error.captureStackTrace<tr><td><a id="l73"></a><a href="#l73">73</a><td> * function (as of 10/17/2012, only V8).<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @private {boolean}<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @const<tr><td><a id="l76"></a><a href="#l76">76</a><td> */<tr><td><a id="l77"></a><a href="#l77">77</a><td>webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_ =<tr><td><a id="l78"></a><a href="#l78">78</a><td>    goog.isFunction(Error.captureStackTrace);<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td>/**<tr><td><a id="l82"></a><a href="#l82">82</a><td> * Whether the current browser supports stack traces.<tr><td><a id="l83"></a><a href="#l83">83</a><td> *<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @type {boolean}<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @const<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td>webdriver.stacktrace.BROWSER_SUPPORTED =<tr><td><a id="l88"></a><a href="#l88">88</a><td>    webdriver.stacktrace.CAN_CAPTURE_STACK_TRACE_ || (function() {<tr><td><a id="l89"></a><a href="#l89">89</a><td>      try {<tr><td><a id="l90"></a><a href="#l90">90</a><td>        throw Error();<tr><td><a id="l91"></a><a href="#l91">91</a><td>      } catch (e) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>        return !!e.stack;<tr><td><a id="l93"></a><a href="#l93">93</a><td>      }<tr><td><a id="l94"></a><a href="#l94">94</a><td>    })();<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * The parsed stack trace. This list is lazily generated the first time it is<tr><td><a id="l99"></a><a href="#l99">99</a><td> * accessed.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @private {Array.&lt;!webdriver.stacktrace.Frame&gt;}<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>webdriver.stacktrace.Snapshot.prototype.parsedStack_ = null;<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>/**<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} The parsed stack trace.<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td>webdriver.stacktrace.Snapshot.prototype.getStacktrace = function() {<tr><td><a id="l109"></a><a href="#l109">109</a><td>  if (goog.isNull(this.parsedStack_)) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>    this.parsedStack_ = webdriver.stacktrace.parse_(this.stack_);<tr><td><a id="l111"></a><a href="#l111">111</a><td>    if (this.slice_) {<tr><td><a id="l112"></a><a href="#l112">112</a><td>      this.parsedStack_ = goog.array.slice(this.parsedStack_, this.slice_);<tr><td><a id="l113"></a><a href="#l113">113</a><td>    }<tr><td><a id="l114"></a><a href="#l114">114</a><td>    delete this.slice_;<tr><td><a id="l115"></a><a href="#l115">115</a><td>    delete this.stack_;<tr><td><a id="l116"></a><a href="#l116">116</a><td>  }<tr><td><a id="l117"></a><a href="#l117">117</a><td>  return this.parsedStack_;<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><tr><td><a id="l122"></a><a href="#l122">122</a><td>/**<tr><td><a id="l123"></a><a href="#l123">123</a><td> * Class representing one stack frame.<tr><td><a id="l124"></a><a href="#l124">124</a><td> * @param {(string|undefined)} context Context object, empty in case of global<tr><td><a id="l125"></a><a href="#l125">125</a><td> *     functions or if the browser doesn&#39;t provide this information.<tr><td><a id="l126"></a><a href="#l126">126</a><td> * @param {(string|undefined)} name Function name, empty in case of anonymous<tr><td><a id="l127"></a><a href="#l127">127</a><td> *     functions.<tr><td><a id="l128"></a><a href="#l128">128</a><td> * @param {(string|undefined)} alias Alias of the function if available. For<tr><td><a id="l129"></a><a href="#l129">129</a><td> *     example the function name will be &#39;c&#39; and the alias will be &#39;b&#39; if the<tr><td><a id="l130"></a><a href="#l130">130</a><td> *     function is defined as &lt;code&gt;a.b = function c() {};&lt;/code&gt;.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @param {(string|undefined)} path File path or URL including line number and<tr><td><a id="l132"></a><a href="#l132">132</a><td> *     optionally column number separated by colons.<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @constructor<tr><td><a id="l134"></a><a href="#l134">134</a><td> */<tr><td><a id="l135"></a><a href="#l135">135</a><td>webdriver.stacktrace.Frame = function(context, name, alias, path) {<tr><td><a id="l136"></a><a href="#l136">136</a><td><tr><td><a id="l137"></a><a href="#l137">137</a><td>  /** @private {string} */<tr><td><a id="l138"></a><a href="#l138">138</a><td>  this.context_ = context || &#39;&#39;;<tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td>  /** @private {string} */<tr><td><a id="l141"></a><a href="#l141">141</a><td>  this.name_ = name || &#39;&#39;;<tr><td><a id="l142"></a><a href="#l142">142</a><td><tr><td><a id="l143"></a><a href="#l143">143</a><td>  /** @private {string} */<tr><td><a id="l144"></a><a href="#l144">144</a><td>  this.alias_ = alias || &#39;&#39;;<tr><td><a id="l145"></a><a href="#l145">145</a><td><tr><td><a id="l146"></a><a href="#l146">146</a><td>  /** @private {string} */<tr><td><a id="l147"></a><a href="#l147">147</a><td>  this.path_ = path || &#39;&#39;;<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td>  /** @private {string} */<tr><td><a id="l150"></a><a href="#l150">150</a><td>  this.url_ = this.path_;<tr><td><a id="l151"></a><a href="#l151">151</a><td><tr><td><a id="l152"></a><a href="#l152">152</a><td>  /** @private {number} */<tr><td><a id="l153"></a><a href="#l153">153</a><td>  this.line_ = -1;<tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td>  /** @private {number} */<tr><td><a id="l156"></a><a href="#l156">156</a><td>  this.column_ = -1;<tr><td><a id="l157"></a><a href="#l157">157</a><td><tr><td><a id="l158"></a><a href="#l158">158</a><td>  if (path) {<tr><td><a id="l159"></a><a href="#l159">159</a><td>    var match = /:(\d+)(?::(\d+))?$/.exec(path);<tr><td><a id="l160"></a><a href="#l160">160</a><td>    if (match) {<tr><td><a id="l161"></a><a href="#l161">161</a><td>      this.line_ = Number(match[1]);<tr><td><a id="l162"></a><a href="#l162">162</a><td>      this.column = Number(match[2] || -1);<tr><td><a id="l163"></a><a href="#l163">163</a><td>      this.url_ = path.substr(0, match.index);<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><tr><td><a id="l169"></a><a href="#l169">169</a><td>/**<tr><td><a id="l170"></a><a href="#l170">170</a><td> * Constant for an anonymous frame.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * @private {!webdriver.stacktrace.Frame}<tr><td><a id="l172"></a><a href="#l172">172</a><td> * @const<tr><td><a id="l173"></a><a href="#l173">173</a><td> */<tr><td><a id="l174"></a><a href="#l174">174</a><td>webdriver.stacktrace.ANONYMOUS_FRAME_ =<tr><td><a id="l175"></a><a href="#l175">175</a><td>    new webdriver.stacktrace.Frame(&#39;&#39;, &#39;&#39;, &#39;&#39;, &#39;&#39;);<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> * @return {string} The function name or empty string if the function is<tr><td><a id="l180"></a><a href="#l180">180</a><td> *     anonymous and the object field which it&#39;s assigned to is unknown.<tr><td><a id="l181"></a><a href="#l181">181</a><td> */<tr><td><a id="l182"></a><a href="#l182">182</a><td>webdriver.stacktrace.Frame.prototype.getName = function() {<tr><td><a id="l183"></a><a href="#l183">183</a><td>  return this.name_;<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> * @return {string} The url or empty string if it is unknown.<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>webdriver.stacktrace.Frame.prototype.getUrl = function() {<tr><td><a id="l191"></a><a href="#l191">191</a><td>  return this.url_;<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>/**<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @return {number} The line number if known or -1 if it is unknown.<tr><td><a id="l197"></a><a href="#l197">197</a><td> */<tr><td><a id="l198"></a><a href="#l198">198</a><td>webdriver.stacktrace.Frame.prototype.getLine = function() {<tr><td><a id="l199"></a><a href="#l199">199</a><td>  return this.line_;<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>/**<tr><td><a id="l204"></a><a href="#l204">204</a><td> * @return {number} The column number if known and -1 if it is unknown.<tr><td><a id="l205"></a><a href="#l205">205</a><td> */<tr><td><a id="l206"></a><a href="#l206">206</a><td>webdriver.stacktrace.Frame.prototype.getColumn = function() {<tr><td><a id="l207"></a><a href="#l207">207</a><td>  return this.column_;<tr><td><a id="l208"></a><a href="#l208">208</a><td>};<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @return {boolean} Whether the stack frame contains an anonymous function.<tr><td><a id="l213"></a><a href="#l213">213</a><td> */<tr><td><a id="l214"></a><a href="#l214">214</a><td>webdriver.stacktrace.Frame.prototype.isAnonymous = function() {<tr><td><a id="l215"></a><a href="#l215">215</a><td>  return !this.name_ || this.context_ == &#39;[object Object]&#39;;<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> * Converts this frame to its string representation using V8&#39;s stack trace<tr><td><a id="l221"></a><a href="#l221">221</a><td> * format: http://code.google.com/p/v8/wiki/JavaScriptStackTraceApi<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @return {string} The string representation of this frame.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @override<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>webdriver.stacktrace.Frame.prototype.toString = function() {<tr><td><a id="l226"></a><a href="#l226">226</a><td>  var context = this.context_;<tr><td><a id="l227"></a><a href="#l227">227</a><td>  if (context &amp;&amp; context !== &#39;new &#39;) {<tr><td><a id="l228"></a><a href="#l228">228</a><td>    context += &#39;.&#39;;<tr><td><a id="l229"></a><a href="#l229">229</a><td>  }<tr><td><a id="l230"></a><a href="#l230">230</a><td>  context += this.name_;<tr><td><a id="l231"></a><a href="#l231">231</a><td>  context += this.alias_ ? &#39; [as &#39; + this.alias_ + &#39;]&#39; : &#39;&#39;;<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>  var path = this.path_ || &#39;&lt;anonymous&gt;&#39;;<tr><td><a id="l234"></a><a href="#l234">234</a><td>  return &#39;    at &#39; + (context ? context + &#39; (&#39; + path + &#39;)&#39; : path);<tr><td><a id="l235"></a><a href="#l235">235</a><td>};<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Maximum length of a string that can be matched with a RegExp on<tr><td><a id="l240"></a><a href="#l240">240</a><td> * Firefox 3x. Exceeding this approximate length will cause string.match<tr><td><a id="l241"></a><a href="#l241">241</a><td> * to exceed Firefox&#39;s stack quota. This situation can be encountered<tr><td><a id="l242"></a><a href="#l242">242</a><td> * when goog.globalEval is invoked with a long argument; such as<tr><td><a id="l243"></a><a href="#l243">243</a><td> * when loading a module.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @private {number}<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @const<tr><td><a id="l246"></a><a href="#l246">246</a><td> */<tr><td><a id="l247"></a><a href="#l247">247</a><td>webdriver.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_ = 500000;<tr><td><a id="l248"></a><a href="#l248">248</a><td><tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td>/**<tr><td><a id="l251"></a><a href="#l251">251</a><td> * RegExp pattern for JavaScript identifiers. We don&#39;t support Unicode<tr><td><a id="l252"></a><a href="#l252">252</a><td> * identifiers defined in ECMAScript v3.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @private {string}<tr><td><a id="l254"></a><a href="#l254">254</a><td> * @const<tr><td><a id="l255"></a><a href="#l255">255</a><td> */<tr><td><a id="l256"></a><a href="#l256">256</a><td>webdriver.stacktrace.IDENTIFIER_PATTERN_ = &#39;[a-zA-Z_$][\\w$]*&#39;;<tr><td><a id="l257"></a><a href="#l257">257</a><td><tr><td><a id="l258"></a><a href="#l258">258</a><td><tr><td><a id="l259"></a><a href="#l259">259</a><td>/**<tr><td><a id="l260"></a><a href="#l260">260</a><td> * Pattern for a matching the type on a fully-qualified name. Forms an<tr><td><a id="l261"></a><a href="#l261">261</a><td> * optional sub-match on the type. For example, in &quot;foo.bar.baz&quot;, will match on<tr><td><a id="l262"></a><a href="#l262">262</a><td> * &quot;foo.bar&quot;.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @private {string}<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @const<tr><td><a id="l265"></a><a href="#l265">265</a><td> */<tr><td><a id="l266"></a><a href="#l266">266</a><td>webdriver.stacktrace.CONTEXT_PATTERN_ =<tr><td><a id="l267"></a><a href="#l267">267</a><td>    &#39;(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l268"></a><a href="#l268">268</a><td>    &#39;(?:\\.&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)\\.&#39;;<tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>/**<tr><td><a id="l272"></a><a href="#l272">272</a><td> * Pattern for matching a fully qualified name. Will create two sub-matches:<tr><td><a id="l273"></a><a href="#l273">273</a><td> * the type (optional), and the name. For example, in &quot;foo.bar.baz&quot;, will<tr><td><a id="l274"></a><a href="#l274">274</a><td> * match on [&quot;foo.bar&quot;, &quot;baz&quot;].<tr><td><a id="l275"></a><a href="#l275">275</a><td> * @private {string}<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @const<tr><td><a id="l277"></a><a href="#l277">277</a><td> */<tr><td><a id="l278"></a><a href="#l278">278</a><td>webdriver.stacktrace.QUALIFIED_NAME_PATTERN_ =<tr><td><a id="l279"></a><a href="#l279">279</a><td>    &#39;(?:&#39; + webdriver.stacktrace.CONTEXT_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l280"></a><a href="#l280">280</a><td>    &#39;(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)&#39;;<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td><tr><td><a id="l283"></a><a href="#l283">283</a><td>/**<tr><td><a id="l284"></a><a href="#l284">284</a><td> * RegExp pattern for function name alias in the V8 stack trace.<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @private {string}<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @const<tr><td><a id="l287"></a><a href="#l287">287</a><td> */<tr><td><a id="l288"></a><a href="#l288">288</a><td>webdriver.stacktrace.V8_ALIAS_PATTERN_ =<tr><td><a id="l289"></a><a href="#l289">289</a><td>    &#39;(?: \\[as (&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)\\])?&#39;;<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> * RegExp pattern for function names and constructor calls in the V8 stack<tr><td><a id="l294"></a><a href="#l294">294</a><td> * trace.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @private {string}<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @const<tr><td><a id="l297"></a><a href="#l297">297</a><td> */<tr><td><a id="l298"></a><a href="#l298">298</a><td>webdriver.stacktrace.V8_FUNCTION_NAME_PATTERN_ =<tr><td><a id="l299"></a><a href="#l299">299</a><td>    &#39;(?:&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;|&lt;anonymous&gt;)&#39;;<tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td><tr><td><a id="l302"></a><a href="#l302">302</a><td>/**<tr><td><a id="l303"></a><a href="#l303">303</a><td> * RegExp pattern for the context of a function call in V8. Creates two<tr><td><a id="l304"></a><a href="#l304">304</a><td> * submatches, only one of which will ever match: either the namespace<tr><td><a id="l305"></a><a href="#l305">305</a><td> * identifier (with optional &quot;new&quot; keyword in the case of a constructor call),<tr><td><a id="l306"></a><a href="#l306">306</a><td> * or just the &quot;new &quot; phrase for a top level constructor call.<tr><td><a id="l307"></a><a href="#l307">307</a><td> * @private {string}<tr><td><a id="l308"></a><a href="#l308">308</a><td> * @const<tr><td><a id="l309"></a><a href="#l309">309</a><td> */<tr><td><a id="l310"></a><a href="#l310">310</a><td>webdriver.stacktrace.V8_CONTEXT_PATTERN_ =<tr><td><a id="l311"></a><a href="#l311">311</a><td>    &#39;(?:((?:new )?(?:\\[object Object\\]|&#39; +<tr><td><a id="l312"></a><a href="#l312">312</a><td>    webdriver.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l313"></a><a href="#l313">313</a><td>    &#39;(?:\\.&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)&#39; +<tr><td><a id="l314"></a><a href="#l314">314</a><td>    &#39;)\\.|(new ))&#39;;<tr><td><a id="l315"></a><a href="#l315">315</a><td><tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td>/**<tr><td><a id="l318"></a><a href="#l318">318</a><td> * RegExp pattern for function call in the V8 stack trace.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * Creates 3 submatches with context object (optional), function name and<tr><td><a id="l320"></a><a href="#l320">320</a><td> * function alias (optional).<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @private {string}<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @const<tr><td><a id="l323"></a><a href="#l323">323</a><td> */<tr><td><a id="l324"></a><a href="#l324">324</a><td>webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l325"></a><a href="#l325">325</a><td>    &#39; (?:&#39; + webdriver.stacktrace.V8_CONTEXT_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l326"></a><a href="#l326">326</a><td>    &#39;(&#39; + webdriver.stacktrace.V8_FUNCTION_NAME_PATTERN_ + &#39;)&#39; +<tr><td><a id="l327"></a><a href="#l327">327</a><td>    webdriver.stacktrace.V8_ALIAS_PATTERN_;<tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td><tr><td><a id="l330"></a><a href="#l330">330</a><td>/**<tr><td><a id="l331"></a><a href="#l331">331</a><td> * RegExp pattern for an URL + position inside the file.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @private {string}<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @const<tr><td><a id="l334"></a><a href="#l334">334</a><td> */<tr><td><a id="l335"></a><a href="#l335">335</a><td>webdriver.stacktrace.URL_PATTERN_ =<tr><td><a id="l336"></a><a href="#l336">336</a><td>    &#39;((?:http|https|file)://[^\\s]+|javascript:.*)&#39;;<tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td>/**<tr><td><a id="l340"></a><a href="#l340">340</a><td> * RegExp pattern for a location string in a V8 stack frame. Creates two<tr><td><a id="l341"></a><a href="#l341">341</a><td> * submatches for the location, one for enclosed in parentheticals and on<tr><td><a id="l342"></a><a href="#l342">342</a><td> * where the location appears alone (which will only occur if the location is<tr><td><a id="l343"></a><a href="#l343">343</a><td> * the only information in the frame).<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @private {string}<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @const<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @see http://code.google.com/p/v8/wiki/JavaScriptStackTraceApi<tr><td><a id="l347"></a><a href="#l347">347</a><td> */<tr><td><a id="l348"></a><a href="#l348">348</a><td>webdriver.stacktrace.V8_LOCATION_PATTERN_ = &#39; (?:\\((.*)\\)|(.*))&#39;;<tr><td><a id="l349"></a><a href="#l349">349</a><td><tr><td><a id="l350"></a><a href="#l350">350</a><td><tr><td><a id="l351"></a><a href="#l351">351</a><td>/**<tr><td><a id="l352"></a><a href="#l352">352</a><td> * Regular expression for parsing one stack frame in V8.<tr><td><a id="l353"></a><a href="#l353">353</a><td> * @private {!RegExp}<tr><td><a id="l354"></a><a href="#l354">354</a><td> * @const<tr><td><a id="l355"></a><a href="#l355">355</a><td> */<tr><td><a id="l356"></a><a href="#l356">356</a><td>webdriver.stacktrace.V8_STACK_FRAME_REGEXP_ = new RegExp(&#39;^\\s+at&#39; +<tr><td><a id="l357"></a><a href="#l357">357</a><td>    // Prevent intersections with IE10 stack frame regex.<tr><td><a id="l358"></a><a href="#l358">358</a><td>    &#39;(?! (?:Anonymous function|Global code|eval code) )&#39; +<tr><td><a id="l359"></a><a href="#l359">359</a><td>    &#39;(?:&#39; + webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l360"></a><a href="#l360">360</a><td>    webdriver.stacktrace.V8_LOCATION_PATTERN_ + &#39;$&#39;);<tr><td><a id="l361"></a><a href="#l361">361</a><td><tr><td><a id="l362"></a><a href="#l362">362</a><td><tr><td><a id="l363"></a><a href="#l363">363</a><td>/**<tr><td><a id="l364"></a><a href="#l364">364</a><td> * RegExp pattern for function names in the Firefox stack trace.<tr><td><a id="l365"></a><a href="#l365">365</a><td> * Firefox has extended identifiers to deal with inner functions and anonymous<tr><td><a id="l366"></a><a href="#l366">366</a><td> * functions: https://bugzilla.mozilla.org/show_bug.cgi?id=433529#c9<tr><td><a id="l367"></a><a href="#l367">367</a><td> * @private {string}<tr><td><a id="l368"></a><a href="#l368">368</a><td> * @const<tr><td><a id="l369"></a><a href="#l369">369</a><td> */<tr><td><a id="l370"></a><a href="#l370">370</a><td>webdriver.stacktrace.FIREFOX_FUNCTION_NAME_PATTERN_ =<tr><td><a id="l371"></a><a href="#l371">371</a><td>    webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;[\\w./&lt;$]*&#39;;<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> * RegExp pattern for function call in the Firefox stack trace.<tr><td><a id="l376"></a><a href="#l376">376</a><td> * Creates a submatch for the function name.<tr><td><a id="l377"></a><a href="#l377">377</a><td> * @private {string}<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @const<tr><td><a id="l379"></a><a href="#l379">379</a><td> */<tr><td><a id="l380"></a><a href="#l380">380</a><td>webdriver.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l381"></a><a href="#l381">381</a><td>    &#39;(&#39; + webdriver.stacktrace.FIREFOX_FUNCTION_NAME_PATTERN_ + &#39;)?&#39; +<tr><td><a id="l382"></a><a href="#l382">382</a><td>    &#39;(?:\\(.*\\))?@&#39;;<tr><td><a id="l383"></a><a href="#l383">383</a><td><tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td>/**<tr><td><a id="l386"></a><a href="#l386">386</a><td> * Regular expression for parsing one stack frame in Firefox.<tr><td><a id="l387"></a><a href="#l387">387</a><td> * @private {!RegExp}<tr><td><a id="l388"></a><a href="#l388">388</a><td> * @const<tr><td><a id="l389"></a><a href="#l389">389</a><td> */<tr><td><a id="l390"></a><a href="#l390">390</a><td>webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&#39; +<tr><td><a id="l391"></a><a href="#l391">391</a><td>    webdriver.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l392"></a><a href="#l392">392</a><td>    &#39;(?::0|&#39; + webdriver.stacktrace.URL_PATTERN_ + &#39;)$&#39;);<tr><td><a id="l393"></a><a href="#l393">393</a><td><tr><td><a id="l394"></a><a href="#l394">394</a><td><tr><td><a id="l395"></a><a href="#l395">395</a><td>/**<tr><td><a id="l396"></a><a href="#l396">396</a><td> * RegExp pattern for function call in a Chakra (IE) stack trace. This<tr><td><a id="l397"></a><a href="#l397">397</a><td> * expression creates 2 submatches on the (optional) context and function name,<tr><td><a id="l398"></a><a href="#l398">398</a><td> * matching identifiers like &#39;foo.Bar.prototype.baz&#39;, &#39;Anonymous function&#39;,<tr><td><a id="l399"></a><a href="#l399">399</a><td> * &#39;eval code&#39;, and &#39;Global code&#39;.<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @private {string}<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @const<tr><td><a id="l402"></a><a href="#l402">402</a><td> */<tr><td><a id="l403"></a><a href="#l403">403</a><td>webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l404"></a><a href="#l404">404</a><td>    &#39;(?:(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ +<tr><td><a id="l405"></a><a href="#l405">405</a><td>    &#39;(?:\\.&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;)*)\\.)?&#39; +<tr><td><a id="l406"></a><a href="#l406">406</a><td>    &#39;(&#39; + webdriver.stacktrace.IDENTIFIER_PATTERN_ + &#39;(?:\\s+\\w+)*)&#39;;<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> * Regular expression for parsing on stack frame in Chakra (IE).<tr><td><a id="l411"></a><a href="#l411">411</a><td> * @private {!RegExp}<tr><td><a id="l412"></a><a href="#l412">412</a><td> * @const<tr><td><a id="l413"></a><a href="#l413">413</a><td> */<tr><td><a id="l414"></a><a href="#l414">414</a><td>webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_ = new RegExp(&#39;^   at &#39; +<tr><td><a id="l415"></a><a href="#l415">415</a><td>    webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l416"></a><a href="#l416">416</a><td>    &#39;\\s*(?:\\((.*)\\))$&#39;);<tr><td><a id="l417"></a><a href="#l417">417</a><td><tr><td><a id="l418"></a><a href="#l418">418</a><td><tr><td><a id="l419"></a><a href="#l419">419</a><td>/**<tr><td><a id="l420"></a><a href="#l420">420</a><td> * Placeholder for an unparsable frame in a stack trace generated by<tr><td><a id="l421"></a><a href="#l421">421</a><td> * {@link goog.testing.stacktrace}.<tr><td><a id="l422"></a><a href="#l422">422</a><td> * @private {string}<tr><td><a id="l423"></a><a href="#l423">423</a><td> * @const<tr><td><a id="l424"></a><a href="#l424">424</a><td> */<tr><td><a id="l425"></a><a href="#l425">425</a><td>webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_ = &#39;&gt; (unknown)&#39;;<tr><td><a id="l426"></a><a href="#l426">426</a><td><tr><td><a id="l427"></a><a href="#l427">427</a><td><tr><td><a id="l428"></a><a href="#l428">428</a><td>/**<tr><td><a id="l429"></a><a href="#l429">429</a><td> * Representation of an anonymous frame in a stack trace generated by<tr><td><a id="l430"></a><a href="#l430">430</a><td> * {@link goog.testing.stacktrace}.<tr><td><a id="l431"></a><a href="#l431">431</a><td> * @private {string}<tr><td><a id="l432"></a><a href="#l432">432</a><td> * @const<tr><td><a id="l433"></a><a href="#l433">433</a><td> */<tr><td><a id="l434"></a><a href="#l434">434</a><td>webdriver.stacktrace.ANONYMOUS_CLOSURE_FRAME_ = &#39;&gt; anonymous&#39;;<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> * Pattern for a function call in a Closure stack trace. Creates three optional<tr><td><a id="l439"></a><a href="#l439">439</a><td> * submatches: the context, function name, and alias.<tr><td><a id="l440"></a><a href="#l440">440</a><td> * @private {string}<tr><td><a id="l441"></a><a href="#l441">441</a><td> * @const<tr><td><a id="l442"></a><a href="#l442">442</a><td> */<tr><td><a id="l443"></a><a href="#l443">443</a><td>webdriver.stacktrace.CLOSURE_FUNCTION_CALL_PATTERN_ =<tr><td><a id="l444"></a><a href="#l444">444</a><td>    webdriver.stacktrace.QUALIFIED_NAME_PATTERN_ +<tr><td><a id="l445"></a><a href="#l445">445</a><td>    &#39;(?:\\(.*\\))?&#39; +  // Ignore arguments if present.<tr><td><a id="l446"></a><a href="#l446">446</a><td>    webdriver.stacktrace.V8_ALIAS_PATTERN_;<tr><td><a id="l447"></a><a href="#l447">447</a><td><tr><td><a id="l448"></a><a href="#l448">448</a><td><tr><td><a id="l449"></a><a href="#l449">449</a><td>/**<tr><td><a id="l450"></a><a href="#l450">450</a><td> * Regular expression for parsing a stack frame generated by Closure&#39;s<tr><td><a id="l451"></a><a href="#l451">451</a><td> * {@link goog.testing.stacktrace}.<tr><td><a id="l452"></a><a href="#l452">452</a><td> * @private {!RegExp}<tr><td><a id="l453"></a><a href="#l453">453</a><td> * @const<tr><td><a id="l454"></a><a href="#l454">454</a><td> */<tr><td><a id="l455"></a><a href="#l455">455</a><td>webdriver.stacktrace.CLOSURE_STACK_FRAME_REGEXP_ = new RegExp(&#39;^&gt; &#39; +<tr><td><a id="l456"></a><a href="#l456">456</a><td>    &#39;(?:&#39; + webdriver.stacktrace.CLOSURE_FUNCTION_CALL_PATTERN_ +<tr><td><a id="l457"></a><a href="#l457">457</a><td>    &#39;(?: at )?)?&#39; +<tr><td><a id="l458"></a><a href="#l458">458</a><td>    &#39;(?:(.*:\\d+:\\d+)|&#39; + webdriver.stacktrace.URL_PATTERN_ + &#39;)?$&#39;);<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> * Parses one stack frame.<tr><td><a id="l463"></a><a href="#l463">463</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @return {webdriver.stacktrace.Frame} Stack frame object or null if the<tr><td><a id="l465"></a><a href="#l465">465</a><td> *     parsing failed.<tr><td><a id="l466"></a><a href="#l466">466</a><td> * @private<tr><td><a id="l467"></a><a href="#l467">467</a><td> */<tr><td><a id="l468"></a><a href="#l468">468</a><td>webdriver.stacktrace.parseStackFrame_ = function(frameStr) {<tr><td><a id="l469"></a><a href="#l469">469</a><td>  var m = frameStr.match(webdriver.stacktrace.V8_STACK_FRAME_REGEXP_);<tr><td><a id="l470"></a><a href="#l470">470</a><td>  if (m) {<tr><td><a id="l471"></a><a href="#l471">471</a><td>    return new webdriver.stacktrace.Frame(<tr><td><a id="l472"></a><a href="#l472">472</a><td>        m[1] || m[2], m[3], m[4], m[5] || m[6]);<tr><td><a id="l473"></a><a href="#l473">473</a><td>  }<tr><td><a id="l474"></a><a href="#l474">474</a><td><tr><td><a id="l475"></a><a href="#l475">475</a><td>  if (frameStr.length &gt;<tr><td><a id="l476"></a><a href="#l476">476</a><td>      webdriver.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_) {<tr><td><a id="l477"></a><a href="#l477">477</a><td>    return webdriver.stacktrace.parseLongFirefoxFrame_(frameStr);<tr><td><a id="l478"></a><a href="#l478">478</a><td>  }<tr><td><a id="l479"></a><a href="#l479">479</a><td><tr><td><a id="l480"></a><a href="#l480">480</a><td>  m = frameStr.match(webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_);<tr><td><a id="l481"></a><a href="#l481">481</a><td>  if (m) {<tr><td><a id="l482"></a><a href="#l482">482</a><td>    return new webdriver.stacktrace.Frame(&#39;&#39;, m[1], &#39;&#39;, m[2]);<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>  m = frameStr.match(webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_);<tr><td><a id="l486"></a><a href="#l486">486</a><td>  if (m) {<tr><td><a id="l487"></a><a href="#l487">487</a><td>    return new webdriver.stacktrace.Frame(m[1], m[2], &#39;&#39;, m[3]);<tr><td><a id="l488"></a><a href="#l488">488</a><td>  }<tr><td><a id="l489"></a><a href="#l489">489</a><td><tr><td><a id="l490"></a><a href="#l490">490</a><td>  if (frameStr == webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_ ||<tr><td><a id="l491"></a><a href="#l491">491</a><td>      frameStr == webdriver.stacktrace.ANONYMOUS_CLOSURE_FRAME_) {<tr><td><a id="l492"></a><a href="#l492">492</a><td>    return webdriver.stacktrace.ANONYMOUS_FRAME_;<tr><td><a id="l493"></a><a href="#l493">493</a><td>  }<tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td>  m = frameStr.match(webdriver.stacktrace.CLOSURE_STACK_FRAME_REGEXP_);<tr><td><a id="l496"></a><a href="#l496">496</a><td>  if (m) {<tr><td><a id="l497"></a><a href="#l497">497</a><td>    return new webdriver.stacktrace.Frame(m[1], m[2], m[3], m[4] || m[5]);<tr><td><a id="l498"></a><a href="#l498">498</a><td>  }<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 null;<tr><td><a id="l501"></a><a href="#l501">501</a><td>};<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> * Parses a long firefox stack frame.<tr><td><a id="l506"></a><a href="#l506">506</a><td> * @param {string} frameStr The stack frame as string.<tr><td><a id="l507"></a><a href="#l507">507</a><td> * @return {!webdriver.stacktrace.Frame} Stack frame object.<tr><td><a id="l508"></a><a href="#l508">508</a><td> * @private<tr><td><a id="l509"></a><a href="#l509">509</a><td> */<tr><td><a id="l510"></a><a href="#l510">510</a><td>webdriver.stacktrace.parseLongFirefoxFrame_ = function(frameStr) {<tr><td><a id="l511"></a><a href="#l511">511</a><td>  var firstParen = frameStr.indexOf(&#39;(&#39;);<tr><td><a id="l512"></a><a href="#l512">512</a><td>  var lastAmpersand = frameStr.lastIndexOf(&#39;@&#39;);<tr><td><a id="l513"></a><a href="#l513">513</a><td>  var lastColon = frameStr.lastIndexOf(&#39;:&#39;);<tr><td><a id="l514"></a><a href="#l514">514</a><td>  var functionName = &#39;&#39;;<tr><td><a id="l515"></a><a href="#l515">515</a><td>  if ((firstParen &gt;= 0) &amp;&amp; (firstParen &lt; lastAmpersand)) {<tr><td><a id="l516"></a><a href="#l516">516</a><td>    functionName = frameStr.substring(0, firstParen);<tr><td><a id="l517"></a><a href="#l517">517</a><td>  }<tr><td><a id="l518"></a><a href="#l518">518</a><td>  var loc = &#39;&#39;;<tr><td><a id="l519"></a><a href="#l519">519</a><td>  if ((lastAmpersand &gt;= 0) &amp;&amp; (lastAmpersand + 1 &lt; lastColon)) {<tr><td><a id="l520"></a><a href="#l520">520</a><td>    loc = frameStr.substring(lastAmpersand + 1);<tr><td><a id="l521"></a><a href="#l521">521</a><td>  }<tr><td><a id="l522"></a><a href="#l522">522</a><td>  return new webdriver.stacktrace.Frame(&#39;&#39;, functionName, &#39;&#39;, loc);<tr><td><a id="l523"></a><a href="#l523">523</a><td>};<tr><td><a id="l524"></a><a href="#l524">524</a><td><tr><td><a id="l525"></a><a href="#l525">525</a><td><tr><td><a id="l526"></a><a href="#l526">526</a><td>/**<tr><td><a id="l527"></a><a href="#l527">527</a><td> * Get an error&#39;s stack trace with the error string trimmed.<tr><td><a id="l528"></a><a href="#l528">528</a><td> * V8 prepends the string representation of an error to its stack trace.<tr><td><a id="l529"></a><a href="#l529">529</a><td> * This function trims the string so that the stack trace can be parsed<tr><td><a id="l530"></a><a href="#l530">530</a><td> * consistently with the other JS engines.<tr><td><a id="l531"></a><a href="#l531">531</a><td> * @param {(Error|goog.testing.JsUnitException)} error The error.<tr><td><a id="l532"></a><a href="#l532">532</a><td> * @return {string} The stack trace string.<tr><td><a id="l533"></a><a href="#l533">533</a><td> */<tr><td><a id="l534"></a><a href="#l534">534</a><td>webdriver.stacktrace.getStack = function(error) {<tr><td><a id="l535"></a><a href="#l535">535</a><td>  if (!error) {<tr><td><a id="l536"></a><a href="#l536">536</a><td>    return &#39;&#39;;<tr><td><a id="l537"></a><a href="#l537">537</a><td>  }<tr><td><a id="l538"></a><a href="#l538">538</a><td>  var stack = error.stack || error.stackTrace || &#39;&#39;;<tr><td><a id="l539"></a><a href="#l539">539</a><td>  var errorStr = error + &#39;\n&#39;;<tr><td><a id="l540"></a><a href="#l540">540</a><td>  if (goog.string.startsWith(stack, errorStr)) {<tr><td><a id="l541"></a><a href="#l541">541</a><td>    stack = stack.substring(errorStr.length);<tr><td><a id="l542"></a><a href="#l542">542</a><td>  }<tr><td><a id="l543"></a><a href="#l543">543</a><td>  return stack;<tr><td><a id="l544"></a><a href="#l544">544</a><td>};<tr><td><a id="l545"></a><a href="#l545">545</a><td><tr><td><a id="l546"></a><a href="#l546">546</a><td><tr><td><a id="l547"></a><a href="#l547">547</a><td>/**<tr><td><a id="l548"></a><a href="#l548">548</a><td> * Formats an error&#39;s stack trace.<tr><td><a id="l549"></a><a href="#l549">549</a><td> * @param {!(Error|goog.testing.JsUnitException)} error The error to format.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * @return {!(Error|goog.testing.JsUnitException)} The formatted error.<tr><td><a id="l551"></a><a href="#l551">551</a><td> */<tr><td><a id="l552"></a><a href="#l552">552</a><td>webdriver.stacktrace.format = function(error) {<tr><td><a id="l553"></a><a href="#l553">553</a><td>  var stack = webdriver.stacktrace.getStack(error);<tr><td><a id="l554"></a><a href="#l554">554</a><td>  var frames = webdriver.stacktrace.parse_(stack);<tr><td><a id="l555"></a><a href="#l555">555</a><td><tr><td><a id="l556"></a><a href="#l556">556</a><td>  // If the original stack is in an unexpected format, our formatted stack<tr><td><a id="l557"></a><a href="#l557">557</a><td>  // trace will be a bunch of &quot;    at &lt;anonymous&gt;&quot; lines. If this is the case,<tr><td><a id="l558"></a><a href="#l558">558</a><td>  // just return the error unmodified to avoid losing information. This is<tr><td><a id="l559"></a><a href="#l559">559</a><td>  // necessary since the user may have defined a custom stack formatter in<tr><td><a id="l560"></a><a href="#l560">560</a><td>  // V8 via Error.prepareStackTrace. See issue 7994.<tr><td><a id="l561"></a><a href="#l561">561</a><td>  var isAnonymousFrame = function(frame) {<tr><td><a id="l562"></a><a href="#l562">562</a><td>    return frame.toString() === &#39;    at &lt;anonymous&gt;&#39;;<tr><td><a id="l563"></a><a href="#l563">563</a><td>  };<tr><td><a id="l564"></a><a href="#l564">564</a><td>  if (frames.length &amp;&amp; goog.array.every(frames, isAnonymousFrame)) {<tr><td><a id="l565"></a><a href="#l565">565</a><td>    return error;<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>  // Older versions of IE simply return [object Error] for toString(), so<tr><td><a id="l569"></a><a href="#l569">569</a><td>  // only use that as a last resort.<tr><td><a id="l570"></a><a href="#l570">570</a><td>  var errorStr = &#39;&#39;;<tr><td><a id="l571"></a><a href="#l571">571</a><td>  if (error.message) {<tr><td><a id="l572"></a><a href="#l572">572</a><td>    errorStr = (error.name ? error.name + &#39;: &#39; : &#39;&#39;) + error.message;<tr><td><a id="l573"></a><a href="#l573">573</a><td>  } else {<tr><td><a id="l574"></a><a href="#l574">574</a><td>    errorStr = error.toString();<tr><td><a id="l575"></a><a href="#l575">575</a><td>  }<tr><td><a id="l576"></a><a href="#l576">576</a><td><tr><td><a id="l577"></a><a href="#l577">577</a><td>  // Ensure the error is in the V8 style with the error&#39;s string representation<tr><td><a id="l578"></a><a href="#l578">578</a><td>  // prepended to the stack.<tr><td><a id="l579"></a><a href="#l579">579</a><td>  error.stack = errorStr + &#39;\n&#39; + frames.join(&#39;\n&#39;);<tr><td><a id="l580"></a><a href="#l580">580</a><td>  return error;<tr><td><a id="l581"></a><a href="#l581">581</a><td>};<tr><td><a id="l582"></a><a href="#l582">582</a><td><tr><td><a id="l583"></a><a href="#l583">583</a><td><tr><td><a id="l584"></a><a href="#l584">584</a><td>/**<tr><td><a id="l585"></a><a href="#l585">585</a><td> * Parses an Error object&#39;s stack trace.<tr><td><a id="l586"></a><a href="#l586">586</a><td> * @param {string} stack The stack trace.<tr><td><a id="l587"></a><a href="#l587">587</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} Stack frames. The<tr><td><a id="l588"></a><a href="#l588">588</a><td> *     unrecognized frames will be nulled out.<tr><td><a id="l589"></a><a href="#l589">589</a><td> * @private<tr><td><a id="l590"></a><a href="#l590">590</a><td> */<tr><td><a id="l591"></a><a href="#l591">591</a><td>webdriver.stacktrace.parse_ = function(stack) {<tr><td><a id="l592"></a><a href="#l592">592</a><td>  if (!stack) {<tr><td><a id="l593"></a><a href="#l593">593</a><td>    return [];<tr><td><a id="l594"></a><a href="#l594">594</a><td>  }<tr><td><a id="l595"></a><a href="#l595">595</a><td><tr><td><a id="l596"></a><a href="#l596">596</a><td>  var lines = stack.<tr><td><a id="l597"></a><a href="#l597">597</a><td>      replace(/\s*$/, &#39;&#39;).<tr><td><a id="l598"></a><a href="#l598">598</a><td>      split(&#39;\n&#39;);<tr><td><a id="l599"></a><a href="#l599">599</a><td>  var frames = [];<tr><td><a id="l600"></a><a href="#l600">600</a><td>  for (var i = 0; i &lt; lines.length; i++) {<tr><td><a id="l601"></a><a href="#l601">601</a><td>    var frame = webdriver.stacktrace.parseStackFrame_(lines[i]);<tr><td><a id="l602"></a><a href="#l602">602</a><td>    // The first two frames will be:<tr><td><a id="l603"></a><a href="#l603">603</a><td>    //   webdriver.stacktrace.Snapshot()<tr><td><a id="l604"></a><a href="#l604">604</a><td>    //   webdriver.stacktrace.get()<tr><td><a id="l605"></a><a href="#l605">605</a><td>    frames.push(frame || webdriver.stacktrace.ANONYMOUS_FRAME_);<tr><td><a id="l606"></a><a href="#l606">606</a><td>  }<tr><td><a id="l607"></a><a href="#l607">607</a><td>  return frames;<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><tr><td><a id="l611"></a><a href="#l611">611</a><td>/**<tr><td><a id="l612"></a><a href="#l612">612</a><td> * Gets the native stack trace if available otherwise follows the call chain.<tr><td><a id="l613"></a><a href="#l613">613</a><td> * The generated trace will exclude all frames up to and including the call to<tr><td><a id="l614"></a><a href="#l614">614</a><td> * this function.<tr><td><a id="l615"></a><a href="#l615">615</a><td> * @return {!Array.&lt;!webdriver.stacktrace.Frame&gt;} The frames of the stack trace.<tr><td><a id="l616"></a><a href="#l616">616</a><td> */<tr><td><a id="l617"></a><a href="#l617">617</a><td>webdriver.stacktrace.get = function() {<tr><td><a id="l618"></a><a href="#l618">618</a><td>  return new webdriver.stacktrace.Snapshot(1).getStacktrace();<tr><td><a id="l619"></a><a href="#l619">619</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/testing/asserts.js.src.html b/docs/source/lib/webdriver/testing/asserts.js.src.html
index 5d37bbd..328b759 100644
--- a/docs/source/lib/webdriver/testing/asserts.js.src.html
+++ b/docs/source/lib/webdriver/testing/asserts.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>asserts.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/testing/asserts.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Assertions and expectation utilities for use in WebDriver test<tr><td><a name="l17" href="#l17">17</a><td> * cases.<tr><td><a name="l18" href="#l18">18</a><td> */<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;webdriver.testing.Assertion&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;webdriver.testing.ContainsMatcher&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;webdriver.testing.NegatedAssertion&#39;);<tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;webdriver.testing.assert&#39;);<tr><td><a name="l24" href="#l24">24</a><td>goog.provide(&#39;webdriver.testing.asserts&#39;);<tr><td><a name="l25" href="#l25">25</a><td><tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.require(&#39;goog.labs.testing.CloseToMatcher&#39;);<tr><td><a name="l28" href="#l28">28</a><td>goog.require(&#39;goog.labs.testing.EndsWithMatcher&#39;);<tr><td><a name="l29" href="#l29">29</a><td>goog.require(&#39;goog.labs.testing.EqualToMatcher&#39;);<tr><td><a name="l30" href="#l30">30</a><td>goog.require(&#39;goog.labs.testing.EqualsMatcher&#39;);<tr><td><a name="l31" href="#l31">31</a><td>goog.require(&#39;goog.labs.testing.GreaterThanEqualToMatcher&#39;);<tr><td><a name="l32" href="#l32">32</a><td>goog.require(&#39;goog.labs.testing.GreaterThanMatcher&#39;);<tr><td><a name="l33" href="#l33">33</a><td>goog.require(&#39;goog.labs.testing.LessThanEqualToMatcher&#39;);<tr><td><a name="l34" href="#l34">34</a><td>goog.require(&#39;goog.labs.testing.LessThanMatcher&#39;);<tr><td><a name="l35" href="#l35">35</a><td>goog.require(&#39;goog.labs.testing.InstanceOfMatcher&#39;);<tr><td><a name="l36" href="#l36">36</a><td>goog.require(&#39;goog.labs.testing.IsNotMatcher&#39;);<tr><td><a name="l37" href="#l37">37</a><td>goog.require(&#39;goog.labs.testing.IsNullMatcher&#39;);<tr><td><a name="l38" href="#l38">38</a><td>goog.require(&#39;goog.labs.testing.IsNullOrUndefinedMatcher&#39;);<tr><td><a name="l39" href="#l39">39</a><td>goog.require(&#39;goog.labs.testing.IsUndefinedMatcher&#39;);<tr><td><a name="l40" href="#l40">40</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a name="l41" href="#l41">41</a><td>goog.require(&#39;goog.labs.testing.ObjectEqualsMatcher&#39;);<tr><td><a name="l42" href="#l42">42</a><td>goog.require(&#39;goog.labs.testing.RegexMatcher&#39;);<tr><td><a name="l43" href="#l43">43</a><td>goog.require(&#39;goog.labs.testing.StartsWithMatcher&#39;);<tr><td><a name="l44" href="#l44">44</a><td>goog.require(&#39;goog.labs.testing.assertThat&#39;);<tr><td><a name="l45" href="#l45">45</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l46" href="#l46">46</a><td>goog.require(&#39;webdriver.promise&#39;);<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>/**<tr><td><a name="l50" href="#l50">50</a><td> * Accepts strins or array-like structures that contain {@code value}.<tr><td><a name="l51" href="#l51">51</a><td> * @param {*} value The value to check for.<tr><td><a name="l52" href="#l52">52</a><td> * @constructor<tr><td><a name="l53" href="#l53">53</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l54" href="#l54">54</a><td> */<tr><td><a name="l55" href="#l55">55</a><td>webdriver.testing.ContainsMatcher = function(value) {<tr><td><a name="l56" href="#l56">56</a><td>  /** @private {*} */<tr><td><a name="l57" href="#l57">57</a><td>  this.value_ = value;<tr><td><a name="l58" href="#l58">58</a><td>};<tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td>/** @override */<tr><td><a name="l62" href="#l62">62</a><td>webdriver.testing.ContainsMatcher.prototype.matches = function(actualValue) {<tr><td><a name="l63" href="#l63">63</a><td>  if (goog.isString(actualValue)) {<tr><td><a name="l64" href="#l64">64</a><td>    return goog.string.contains(<tr><td><a name="l65" href="#l65">65</a><td>        actualValue, /** @type {string} */(this.value_));<tr><td><a name="l66" href="#l66">66</a><td>  } else {<tr><td><a name="l67" href="#l67">67</a><td>    return goog.array.contains(<tr><td><a name="l68" href="#l68">68</a><td>        /** @type {goog.array.ArrayLike} */(actualValue), this.value_);<tr><td><a name="l69" href="#l69">69</a><td>  }<tr><td><a name="l70" href="#l70">70</a><td>};<tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>/** @override */<tr><td><a name="l74" href="#l74">74</a><td>webdriver.testing.ContainsMatcher.prototype.describe = function(actualValue) {<tr><td><a name="l75" href="#l75">75</a><td>  return actualValue + &#39; does not contain &#39; + this.value_;<tr><td><a name="l76" href="#l76">76</a><td>};<tr><td><a name="l77" href="#l77">77</a><td><tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td><tr><td><a name="l80" href="#l80">80</a><td>/**<tr><td><a name="l81" href="#l81">81</a><td> * Utility for performing assertions against a given {@code value}. If the<tr><td><a name="l82" href="#l82">82</a><td> * value is a {@link webdriver.promise.Promise}, this assertion will wait<tr><td><a name="l83" href="#l83">83</a><td> * for it to resolve before applying any matchers.<tr><td><a name="l84" href="#l84">84</a><td> * @param {*} value The value to wrap and apply matchers to.<tr><td><a name="l85" href="#l85">85</a><td> * @constructor<tr><td><a name="l86" href="#l86">86</a><td> */<tr><td><a name="l87" href="#l87">87</a><td>webdriver.testing.Assertion = function(value) {<tr><td><a name="l88" href="#l88">88</a><td><tr><td><a name="l89" href="#l89">89</a><td>  /** @private {*} */<tr><td><a name="l90" href="#l90">90</a><td>  this.value_ = value;<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td>  if (!(this instanceof webdriver.testing.NegatedAssertion)) {<tr><td><a name="l93" href="#l93">93</a><td>    /**<tr><td><a name="l94" href="#l94">94</a><td>     * A self reference provided for writing fluent assertions:<tr><td><a name="l95" href="#l95">95</a><td>     *     webdriver.testing.assert(x).is.equalTo(y);<tr><td><a name="l96" href="#l96">96</a><td>     * @type {!webdriver.testing.Assertion}<tr><td><a name="l97" href="#l97">97</a><td>     */<tr><td><a name="l98" href="#l98">98</a><td>    this.is = this;<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td>    /**<tr><td><a name="l101" href="#l101">101</a><td>     * Negates any matchers applied to this instance&#39;s value:<tr><td><a name="l102" href="#l102">102</a><td>     *     webdriver.testing.assert(x).not.equalTo(y);<tr><td><a name="l103" href="#l103">103</a><td>     * @type {!webdriver.testing.NegatedAssertion}<tr><td><a name="l104" href="#l104">104</a><td>     */<tr><td><a name="l105" href="#l105">105</a><td>    this.not = new webdriver.testing.NegatedAssertion(value);<tr><td><a name="l106" href="#l106">106</a><td>  }<tr><td><a name="l107" href="#l107">107</a><td>};<tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td><tr><td><a name="l110" href="#l110">110</a><td>/**<tr><td><a name="l111" href="#l111">111</a><td> * Wraps an object literal implementing the Matcher interface. This is used<tr><td><a name="l112" href="#l112">112</a><td> * to appease the Closure compiler, which will not treat an object literal as<tr><td><a name="l113" href="#l113">113</a><td> * implementing an interface.<tr><td><a name="l114" href="#l114">114</a><td> * @param {{matches: function(*): boolean, describe: function(): string}} obj<tr><td><a name="l115" href="#l115">115</a><td> *     The object literal to delegate to.<tr><td><a name="l116" href="#l116">116</a><td> * @constructor<tr><td><a name="l117" href="#l117">117</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a name="l118" href="#l118">118</a><td> * @private<tr><td><a name="l119" href="#l119">119</a><td> */<tr><td><a name="l120" href="#l120">120</a><td>webdriver.testing.Assertion.DelegatingMatcher_ = function(obj) {<tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td>  /** @override */<tr><td><a name="l123" href="#l123">123</a><td>  this.matches = function(value) {<tr><td><a name="l124" href="#l124">124</a><td>    return obj.matches(value);<tr><td><a name="l125" href="#l125">125</a><td>  };<tr><td><a name="l126" href="#l126">126</a><td><tr><td><a name="l127" href="#l127">127</a><td>  /** @override */<tr><td><a name="l128" href="#l128">128</a><td>  this.describe = function() {<tr><td><a name="l129" href="#l129">129</a><td>    return obj.describe();<tr><td><a name="l130" href="#l130">130</a><td>  };<tr><td><a name="l131" href="#l131">131</a><td>};<tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td>/**<tr><td><a name="l135" href="#l135">135</a><td> * Asserts that the given {@code matcher} accepts the value wrapped by this<tr><td><a name="l136" href="#l136">136</a><td> * instance. If the wrapped value is a promise, this function will defer<tr><td><a name="l137" href="#l137">137</a><td> * applying the assertion until the value has been resolved. Otherwise, it<tr><td><a name="l138" href="#l138">138</a><td> * will be applied immediately.<tr><td><a name="l139" href="#l139">139</a><td> * @param {!goog.labs.testing.Matcher} matcher The matcher to apply<tr><td><a name="l140" href="#l140">140</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l141" href="#l141">141</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l142" href="#l142">142</a><td> * @return {webdriver.promise.Promise} The deferred assertion result, or<tr><td><a name="l143" href="#l143">143</a><td> *     {@code null} if the assertion was immediately applied.<tr><td><a name="l144" href="#l144">144</a><td> * @protected<tr><td><a name="l145" href="#l145">145</a><td> */<tr><td><a name="l146" href="#l146">146</a><td>webdriver.testing.Assertion.prototype.apply = function(matcher, opt_message) {<tr><td><a name="l147" href="#l147">147</a><td>  var result = null;<tr><td><a name="l148" href="#l148">148</a><td>  if (webdriver.promise.isPromise(this.value_)) {<tr><td><a name="l149" href="#l149">149</a><td>    result = webdriver.promise.when(this.value_, function(value) {<tr><td><a name="l150" href="#l150">150</a><td>      goog.labs.testing.assertThat(value, matcher, opt_message);<tr><td><a name="l151" href="#l151">151</a><td>    });<tr><td><a name="l152" href="#l152">152</a><td>  } else {<tr><td><a name="l153" href="#l153">153</a><td>    goog.labs.testing.assertThat(this.value_, matcher, opt_message);<tr><td><a name="l154" href="#l154">154</a><td>  }<tr><td><a name="l155" href="#l155">155</a><td>  return result;<tr><td><a name="l156" href="#l156">156</a><td>};<tr><td><a name="l157" href="#l157">157</a><td><tr><td><a name="l158" href="#l158">158</a><td><tr><td><a name="l159" href="#l159">159</a><td>/**<tr><td><a name="l160" href="#l160">160</a><td> * Asserts that the value managed by this assertion is a number strictly<tr><td><a name="l161" href="#l161">161</a><td> * greater than {@code value}.<tr><td><a name="l162" href="#l162">162</a><td> * @param {number} value The minimum value.<tr><td><a name="l163" href="#l163">163</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l164" href="#l164">164</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l165" href="#l165">165</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l166" href="#l166">166</a><td> */<tr><td><a name="l167" href="#l167">167</a><td>webdriver.testing.Assertion.prototype.greaterThan = function(<tr><td><a name="l168" href="#l168">168</a><td>    value, opt_message) {<tr><td><a name="l169" href="#l169">169</a><td>  return this.apply(<tr><td><a name="l170" href="#l170">170</a><td>      new goog.labs.testing.GreaterThanMatcher(value), opt_message);<tr><td><a name="l171" href="#l171">171</a><td>};<tr><td><a name="l172" href="#l172">172</a><td><tr><td><a name="l173" href="#l173">173</a><td><tr><td><a name="l174" href="#l174">174</a><td>/**<tr><td><a name="l175" href="#l175">175</a><td> * Asserts that the value managed by this assertion is a number &gt;= the given<tr><td><a name="l176" href="#l176">176</a><td> * value.<tr><td><a name="l177" href="#l177">177</a><td> * @param {number} value The minimum value.<tr><td><a name="l178" href="#l178">178</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l179" href="#l179">179</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l180" href="#l180">180</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l181" href="#l181">181</a><td> */<tr><td><a name="l182" href="#l182">182</a><td>webdriver.testing.Assertion.prototype.greaterThanEqualTo = function(<tr><td><a name="l183" href="#l183">183</a><td>    value, opt_message) {<tr><td><a name="l184" href="#l184">184</a><td>  return this.apply(<tr><td><a name="l185" href="#l185">185</a><td>      new goog.labs.testing.GreaterThanEqualToMatcher(value), opt_message);<tr><td><a name="l186" href="#l186">186</a><td>};<tr><td><a name="l187" href="#l187">187</a><td><tr><td><a name="l188" href="#l188">188</a><td><tr><td><a name="l189" href="#l189">189</a><td>/**<tr><td><a name="l190" href="#l190">190</a><td> * Asserts that the value managed by this assertion is a number strictly less<tr><td><a name="l191" href="#l191">191</a><td> * than the given value.<tr><td><a name="l192" href="#l192">192</a><td> * @param {number} value The maximum value.<tr><td><a name="l193" href="#l193">193</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l194" href="#l194">194</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l195" href="#l195">195</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l196" href="#l196">196</a><td> */<tr><td><a name="l197" href="#l197">197</a><td>webdriver.testing.Assertion.prototype.lessThan = function(value, opt_message) {<tr><td><a name="l198" href="#l198">198</a><td>  return this.apply(<tr><td><a name="l199" href="#l199">199</a><td>      new goog.labs.testing.LessThanMatcher(value), opt_message);<tr><td><a name="l200" href="#l200">200</a><td>};<tr><td><a name="l201" href="#l201">201</a><td><tr><td><a name="l202" href="#l202">202</a><td><tr><td><a name="l203" href="#l203">203</a><td>/**<tr><td><a name="l204" href="#l204">204</a><td> * Asserts that the value managed by this assertion is a number &lt;= the given<tr><td><a name="l205" href="#l205">205</a><td> * value.<tr><td><a name="l206" href="#l206">206</a><td> * @param {number} value The maximum value.<tr><td><a name="l207" href="#l207">207</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l208" href="#l208">208</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l209" href="#l209">209</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l210" href="#l210">210</a><td> */<tr><td><a name="l211" href="#l211">211</a><td>webdriver.testing.Assertion.prototype.lessThanEqualTo = function(<tr><td><a name="l212" href="#l212">212</a><td>    value, opt_message) {<tr><td><a name="l213" href="#l213">213</a><td>  return this.apply(<tr><td><a name="l214" href="#l214">214</a><td>      new goog.labs.testing.LessThanEqualToMatcher(value), opt_message);<tr><td><a name="l215" href="#l215">215</a><td>};<tr><td><a name="l216" href="#l216">216</a><td><tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * Asserts that the wrapped value is a number within a given distance of an<tr><td><a name="l220" href="#l220">220</a><td> * expected value.<tr><td><a name="l221" href="#l221">221</a><td> * @param {number} value The expected value.<tr><td><a name="l222" href="#l222">222</a><td> * @param {number} range The maximum amount the actual value is permitted to<tr><td><a name="l223" href="#l223">223</a><td> *     differ from the expected value.<tr><td><a name="l224" href="#l224">224</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l225" href="#l225">225</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l226" href="#l226">226</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l227" href="#l227">227</a><td> */<tr><td><a name="l228" href="#l228">228</a><td>webdriver.testing.Assertion.prototype.closeTo = function(<tr><td><a name="l229" href="#l229">229</a><td>    value, range, opt_message) {<tr><td><a name="l230" href="#l230">230</a><td>  return this.apply(<tr><td><a name="l231" href="#l231">231</a><td>      new goog.labs.testing.CloseToMatcher(value, range), opt_message);<tr><td><a name="l232" href="#l232">232</a><td>};<tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td><tr><td><a name="l235" href="#l235">235</a><td>/**<tr><td><a name="l236" href="#l236">236</a><td> * Asserts that the wrapped value is an instance of the given class.<tr><td><a name="l237" href="#l237">237</a><td> * @param {!Function} ctor The expected class constructor.<tr><td><a name="l238" href="#l238">238</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l239" href="#l239">239</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l240" href="#l240">240</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l241" href="#l241">241</a><td> */<tr><td><a name="l242" href="#l242">242</a><td>webdriver.testing.Assertion.prototype.instanceOf = function(ctor, opt_message) {<tr><td><a name="l243" href="#l243">243</a><td>  return this.apply(<tr><td><a name="l244" href="#l244">244</a><td>      new goog.labs.testing.InstanceOfMatcher(ctor), opt_message);<tr><td><a name="l245" href="#l245">245</a><td>};<tr><td><a name="l246" href="#l246">246</a><td><tr><td><a name="l247" href="#l247">247</a><td><tr><td><a name="l248" href="#l248">248</a><td>/**<tr><td><a name="l249" href="#l249">249</a><td> * Asserts that the wrapped value is null.<tr><td><a name="l250" href="#l250">250</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l251" href="#l251">251</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l252" href="#l252">252</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l253" href="#l253">253</a><td> */<tr><td><a name="l254" href="#l254">254</a><td>webdriver.testing.Assertion.prototype.isNull = function(opt_message) {<tr><td><a name="l255" href="#l255">255</a><td>  return this.apply(new goog.labs.testing.IsNullMatcher(), opt_message);<tr><td><a name="l256" href="#l256">256</a><td>};<tr><td><a name="l257" href="#l257">257</a><td><tr><td><a name="l258" href="#l258">258</a><td><tr><td><a name="l259" href="#l259">259</a><td>/**<tr><td><a name="l260" href="#l260">260</a><td> * Asserts that the wrapped value is undefined.<tr><td><a name="l261" href="#l261">261</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l262" href="#l262">262</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l263" href="#l263">263</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l264" href="#l264">264</a><td> */<tr><td><a name="l265" href="#l265">265</a><td>webdriver.testing.Assertion.prototype.isUndefined = function(opt_message) {<tr><td><a name="l266" href="#l266">266</a><td>  return this.apply(new goog.labs.testing.IsUndefinedMatcher(), opt_message);<tr><td><a name="l267" href="#l267">267</a><td>};<tr><td><a name="l268" href="#l268">268</a><td><tr><td><a name="l269" href="#l269">269</a><td><tr><td><a name="l270" href="#l270">270</a><td>/**<tr><td><a name="l271" href="#l271">271</a><td> * Asserts that the wrapped value is null or undefined.<tr><td><a name="l272" href="#l272">272</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l273" href="#l273">273</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l274" href="#l274">274</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l275" href="#l275">275</a><td> */<tr><td><a name="l276" href="#l276">276</a><td>webdriver.testing.Assertion.prototype.isNullOrUndefined = function(<tr><td><a name="l277" href="#l277">277</a><td>    opt_message) {<tr><td><a name="l278" href="#l278">278</a><td>  return this.apply(<tr><td><a name="l279" href="#l279">279</a><td>      new goog.labs.testing.IsNullOrUndefinedMatcher(), opt_message);<tr><td><a name="l280" href="#l280">280</a><td>};<tr><td><a name="l281" href="#l281">281</a><td><tr><td><a name="l282" href="#l282">282</a><td><tr><td><a name="l283" href="#l283">283</a><td>/**<tr><td><a name="l284" href="#l284">284</a><td> * Asserts that the wrapped value is a string or array-like structure<tr><td><a name="l285" href="#l285">285</a><td> * containing the given value.<tr><td><a name="l286" href="#l286">286</a><td> * @param {*} value The expected value.<tr><td><a name="l287" href="#l287">287</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l288" href="#l288">288</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l289" href="#l289">289</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l290" href="#l290">290</a><td> */<tr><td><a name="l291" href="#l291">291</a><td>webdriver.testing.Assertion.prototype.contains = function(value, opt_message) {<tr><td><a name="l292" href="#l292">292</a><td>  return this.apply(<tr><td><a name="l293" href="#l293">293</a><td>      new webdriver.testing.ContainsMatcher(value), opt_message);<tr><td><a name="l294" href="#l294">294</a><td>};<tr><td><a name="l295" href="#l295">295</a><td><tr><td><a name="l296" href="#l296">296</a><td><tr><td><a name="l297" href="#l297">297</a><td>/**<tr><td><a name="l298" href="#l298">298</a><td> * Asserts that the wrapped value is a string ending with the given suffix.<tr><td><a name="l299" href="#l299">299</a><td> * @param {string} suffix The expected suffix.<tr><td><a name="l300" href="#l300">300</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l301" href="#l301">301</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l302" href="#l302">302</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l303" href="#l303">303</a><td> */<tr><td><a name="l304" href="#l304">304</a><td>webdriver.testing.Assertion.prototype.endsWith = function(<tr><td><a name="l305" href="#l305">305</a><td>    suffix, opt_message) {<tr><td><a name="l306" href="#l306">306</a><td>  return this.apply(<tr><td><a name="l307" href="#l307">307</a><td>      new goog.labs.testing.EndsWithMatcher(suffix), opt_message);<tr><td><a name="l308" href="#l308">308</a><td>};<tr><td><a name="l309" href="#l309">309</a><td><tr><td><a name="l310" href="#l310">310</a><td><tr><td><a name="l311" href="#l311">311</a><td>/**<tr><td><a name="l312" href="#l312">312</a><td> * Asserts that the wrapped value is a string starting with the given prefix.<tr><td><a name="l313" href="#l313">313</a><td> * @param {string} prefix The expected prefix.<tr><td><a name="l314" href="#l314">314</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l315" href="#l315">315</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l316" href="#l316">316</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l317" href="#l317">317</a><td> */<tr><td><a name="l318" href="#l318">318</a><td>webdriver.testing.Assertion.prototype.startsWith = function(<tr><td><a name="l319" href="#l319">319</a><td>    prefix, opt_message) {<tr><td><a name="l320" href="#l320">320</a><td>  return this.apply(<tr><td><a name="l321" href="#l321">321</a><td>      new goog.labs.testing.StartsWithMatcher(prefix), opt_message);<tr><td><a name="l322" href="#l322">322</a><td>};<tr><td><a name="l323" href="#l323">323</a><td><tr><td><a name="l324" href="#l324">324</a><td><tr><td><a name="l325" href="#l325">325</a><td>/**<tr><td><a name="l326" href="#l326">326</a><td> * Asserts that the wrapped value is a string that matches the given RegExp.<tr><td><a name="l327" href="#l327">327</a><td> * @param {!RegExp} regex The regex to test.<tr><td><a name="l328" href="#l328">328</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l329" href="#l329">329</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l330" href="#l330">330</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l331" href="#l331">331</a><td> */<tr><td><a name="l332" href="#l332">332</a><td>webdriver.testing.Assertion.prototype.matches = function(regex, opt_message) {<tr><td><a name="l333" href="#l333">333</a><td>  return this.apply(new goog.labs.testing.RegexMatcher(regex), opt_message);<tr><td><a name="l334" href="#l334">334</a><td>};<tr><td><a name="l335" href="#l335">335</a><td><tr><td><a name="l336" href="#l336">336</a><td><tr><td><a name="l337" href="#l337">337</a><td>/**<tr><td><a name="l338" href="#l338">338</a><td> * Asserts that the value managed by this assertion is strictly equal to the<tr><td><a name="l339" href="#l339">339</a><td> * given {@code value}.<tr><td><a name="l340" href="#l340">340</a><td> * @param {*} value The expected value.<tr><td><a name="l341" href="#l341">341</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a name="l342" href="#l342">342</a><td> *     accept the value wrapped by this assertion.<tr><td><a name="l343" href="#l343">343</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l344" href="#l344">344</a><td> */<tr><td><a name="l345" href="#l345">345</a><td>webdriver.testing.Assertion.prototype.equalTo = function(value, opt_message) {<tr><td><a name="l346" href="#l346">346</a><td>  return this.apply(webdriver.testing.asserts.equalTo(value), opt_message);<tr><td><a name="l347" href="#l347">347</a><td>};<tr><td><a name="l348" href="#l348">348</a><td><tr><td><a name="l349" href="#l349">349</a><td><tr><td><a name="l350" href="#l350">350</a><td>/**<tr><td><a name="l351" href="#l351">351</a><td> * Asserts that the value managed by this assertion is strictly true.<tr><td><a name="l352" href="#l352">352</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l353" href="#l353">353</a><td> */<tr><td><a name="l354" href="#l354">354</a><td>webdriver.testing.Assertion.prototype.isTrue = function() {<tr><td><a name="l355" href="#l355">355</a><td>  return this.equalTo(true);<tr><td><a name="l356" href="#l356">356</a><td>};<tr><td><a name="l357" href="#l357">357</a><td><tr><td><a name="l358" href="#l358">358</a><td><tr><td><a name="l359" href="#l359">359</a><td>/**<tr><td><a name="l360" href="#l360">360</a><td> * Asserts that the value managed by this assertion is strictly false.<tr><td><a name="l361" href="#l361">361</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a name="l362" href="#l362">362</a><td> */<tr><td><a name="l363" href="#l363">363</a><td>webdriver.testing.Assertion.prototype.isFalse = function() {<tr><td><a name="l364" href="#l364">364</a><td>  return this.equalTo(false);<tr><td><a name="l365" href="#l365">365</a><td>};<tr><td><a name="l366" href="#l366">366</a><td><tr><td><a name="l367" href="#l367">367</a><td><tr><td><a name="l368" href="#l368">368</a><td><tr><td><a name="l369" href="#l369">369</a><td>/**<tr><td><a name="l370" href="#l370">370</a><td> * An assertion that negates any applied matchers.<tr><td><a name="l371" href="#l371">371</a><td> * @param {*} value The value to perform assertions on.<tr><td><a name="l372" href="#l372">372</a><td> * @constructor<tr><td><a name="l373" href="#l373">373</a><td> * @extends {webdriver.testing.Assertion}<tr><td><a name="l374" href="#l374">374</a><td> */<tr><td><a name="l375" href="#l375">375</a><td>webdriver.testing.NegatedAssertion = function(value) {<tr><td><a name="l376" href="#l376">376</a><td>  goog.base(this, value);<tr><td><a name="l377" href="#l377">377</a><td>  this.value = value;<tr><td><a name="l378" href="#l378">378</a><td>};<tr><td><a name="l379" href="#l379">379</a><td>goog.inherits(<tr><td><a name="l380" href="#l380">380</a><td>    webdriver.testing.NegatedAssertion, webdriver.testing.Assertion);<tr><td><a name="l381" href="#l381">381</a><td><tr><td><a name="l382" href="#l382">382</a><td><tr><td><a name="l383" href="#l383">383</a><td>/** @override */<tr><td><a name="l384" href="#l384">384</a><td>webdriver.testing.NegatedAssertion.prototype.apply = function(<tr><td><a name="l385" href="#l385">385</a><td>    matcher, opt_message) {<tr><td><a name="l386" href="#l386">386</a><td>  matcher = new goog.labs.testing.IsNotMatcher(matcher);<tr><td><a name="l387" href="#l387">387</a><td>  return goog.base(this, &#39;apply&#39;, matcher, opt_message);<tr><td><a name="l388" href="#l388">388</a><td>};<tr><td><a name="l389" href="#l389">389</a><td><tr><td><a name="l390" href="#l390">390</a><td><tr><td><a name="l391" href="#l391">391</a><td><tr><td><a name="l392" href="#l392">392</a><td>/**<tr><td><a name="l393" href="#l393">393</a><td> * Creates a new assertion.<tr><td><a name="l394" href="#l394">394</a><td> * @param {*} value The value to perform an assertion on.<tr><td><a name="l395" href="#l395">395</a><td> * @return {!webdriver.testing.Assertion} The new assertion.<tr><td><a name="l396" href="#l396">396</a><td> */<tr><td><a name="l397" href="#l397">397</a><td>webdriver.testing.assert = function(value) {<tr><td><a name="l398" href="#l398">398</a><td>  return new webdriver.testing.Assertion(value);<tr><td><a name="l399" href="#l399">399</a><td>};<tr><td><a name="l400" href="#l400">400</a><td><tr><td><a name="l401" href="#l401">401</a><td><tr><td><a name="l402" href="#l402">402</a><td>/**<tr><td><a name="l403" href="#l403">403</a><td> * Registers a new assertion to expose from the<tr><td><a name="l404" href="#l404">404</a><td> * {@link webdriver.testing.Assertion} prototype.<tr><td><a name="l405" href="#l405">405</a><td> * @param {string} name The assertion name.<tr><td><a name="l406" href="#l406">406</a><td> * @param {(function(new: goog.labs.testing.Matcher, *)|<tr><td><a name="l407" href="#l407">407</a><td> *          {matches: function(*): boolean,<tr><td><a name="l408" href="#l408">408</a><td> *           describe: function(): string})} matcherTemplate Either the<tr><td><a name="l409" href="#l409">409</a><td> *     matcher constructor to use, or an object literal defining a matcher.<tr><td><a name="l410" href="#l410">410</a><td> */<tr><td><a name="l411" href="#l411">411</a><td>webdriver.testing.assert.register = function(name, matcherTemplate) {<tr><td><a name="l412" href="#l412">412</a><td>  webdriver.testing.Assertion.prototype[name] = function(value, opt_message) {<tr><td><a name="l413" href="#l413">413</a><td>    var matcher;<tr><td><a name="l414" href="#l414">414</a><td>    if (goog.isFunction(matcherTemplate)) {<tr><td><a name="l415" href="#l415">415</a><td>      var ctor = /** @type {function(new: goog.labs.testing.Matcher, *)} */ (<tr><td><a name="l416" href="#l416">416</a><td>          matcherTemplate);<tr><td><a name="l417" href="#l417">417</a><td>      matcher = new ctor(value);<tr><td><a name="l418" href="#l418">418</a><td>    } else {<tr><td><a name="l419" href="#l419">419</a><td>      matcher = new webdriver.testing.Assertion.DelegatingMatcher_(value);<tr><td><a name="l420" href="#l420">420</a><td>    }<tr><td><a name="l421" href="#l421">421</a><td>    return this.apply(matcher, opt_message);<tr><td><a name="l422" href="#l422">422</a><td>  };<tr><td><a name="l423" href="#l423">423</a><td>};<tr><td><a name="l424" href="#l424">424</a><td><tr><td><a name="l425" href="#l425">425</a><td><tr><td><a name="l426" href="#l426">426</a><td>/**<tr><td><a name="l427" href="#l427">427</a><td> * Asserts that a matcher accepts a given value.  This function has two<tr><td><a name="l428" href="#l428">428</a><td> * signatures based on the number of arguments:<tr><td><a name="l429" href="#l429">429</a><td> *<tr><td><a name="l430" href="#l430">430</a><td> * Two arguments:<tr><td><a name="l431" href="#l431">431</a><td> *   assertThat(actualValue, matcher)<tr><td><a name="l432" href="#l432">432</a><td> * Three arguments:<tr><td><a name="l433" href="#l433">433</a><td> *   assertThat(failureMessage, actualValue, matcher)<tr><td><a name="l434" href="#l434">434</a><td> *<tr><td><a name="l435" href="#l435">435</a><td> * @param {*} failureMessageOrActualValue Either a failure message or the value<tr><td><a name="l436" href="#l436">436</a><td> *     to apply to the given matcher.<tr><td><a name="l437" href="#l437">437</a><td> * @param {*} actualValueOrMatcher Either the value to apply to the given<tr><td><a name="l438" href="#l438">438</a><td> *     matcher, or the matcher itself.<tr><td><a name="l439" href="#l439">439</a><td> * @param {goog.labs.testing.Matcher=} opt_matcher The matcher to use;<tr><td><a name="l440" href="#l440">440</a><td> *     ignored unless this function is invoked with three arguments.<tr><td><a name="l441" href="#l441">441</a><td> * @return {!webdriver.promise.Promise} The assertion result.<tr><td><a name="l442" href="#l442">442</a><td> * @deprecated Use webdriver.testing.asserts.assert instead.<tr><td><a name="l443" href="#l443">443</a><td> */<tr><td><a name="l444" href="#l444">444</a><td>webdriver.testing.asserts.assertThat = function(<tr><td><a name="l445" href="#l445">445</a><td>    failureMessageOrActualValue, actualValueOrMatcher, opt_matcher) {<tr><td><a name="l446" href="#l446">446</a><td>  var args = goog.array.slice(arguments, 0);<tr><td><a name="l447" href="#l447">447</a><td><tr><td><a name="l448" href="#l448">448</a><td>  var message = args.length &gt; 2 ? args.shift() : &#39;&#39;;<tr><td><a name="l449" href="#l449">449</a><td>  if (message) message += &#39;\n&#39;;<tr><td><a name="l450" href="#l450">450</a><td><tr><td><a name="l451" href="#l451">451</a><td>  var actualValue = args.shift();<tr><td><a name="l452" href="#l452">452</a><td>  var matcher = args.shift();<tr><td><a name="l453" href="#l453">453</a><td><tr><td><a name="l454" href="#l454">454</a><td>  return webdriver.promise.when(actualValue, function(value) {<tr><td><a name="l455" href="#l455">455</a><td>    goog.labs.testing.assertThat(value, matcher, message);<tr><td><a name="l456" href="#l456">456</a><td>  });<tr><td><a name="l457" href="#l457">457</a><td>};<tr><td><a name="l458" href="#l458">458</a><td><tr><td><a name="l459" href="#l459">459</a><td><tr><td><a name="l460" href="#l460">460</a><td>/**<tr><td><a name="l461" href="#l461">461</a><td> * Creates an equality matcher.<tr><td><a name="l462" href="#l462">462</a><td> * @param {*} expected The expected value.<tr><td><a name="l463" href="#l463">463</a><td> * @return {!goog.labs.testing.Matcher} The new matcher.<tr><td><a name="l464" href="#l464">464</a><td> */<tr><td><a name="l465" href="#l465">465</a><td>webdriver.testing.asserts.equalTo = function(expected) {<tr><td><a name="l466" href="#l466">466</a><td>  if (goog.isString(expected)) {<tr><td><a name="l467" href="#l467">467</a><td>    return new goog.labs.testing.EqualsMatcher(expected);<tr><td><a name="l468" href="#l468">468</a><td>  } else if (goog.isNumber(expected)) {<tr><td><a name="l469" href="#l469">469</a><td>    return new goog.labs.testing.EqualToMatcher(expected);<tr><td><a name="l470" href="#l470">470</a><td>  } else {<tr><td><a name="l471" href="#l471">471</a><td>    return new goog.labs.testing.ObjectEqualsMatcher(<tr><td><a name="l472" href="#l472">472</a><td>        /** @type {!Object} */ (expected));<tr><td><a name="l473" href="#l473">473</a><td>  }<tr><td><a name="l474" href="#l474">474</a><td>};<tr><td><a name="l475" href="#l475">475</a><td><tr><td><a name="l476" href="#l476">476</a><td><tr><td><a name="l477" href="#l477">477</a><td>goog.exportSymbol(&#39;assertThat&#39;, webdriver.testing.asserts.assertThat);<tr><td><a name="l478" href="#l478">478</a><td>// Mappings for goog.labs.testing matcher functions to the legacy<tr><td><a name="l479" href="#l479">479</a><td>// webdriver.testing.asserts matchers.<tr><td><a name="l480" href="#l480">480</a><td>goog.exportSymbol(&#39;contains&#39;, containsString);<tr><td><a name="l481" href="#l481">481</a><td>goog.exportSymbol(&#39;equalTo&#39;, webdriver.testing.asserts.equalTo);<tr><td><a name="l482" href="#l482">482</a><td>goog.exportSymbol(&#39;equals&#39;, webdriver.testing.asserts.equalTo);<tr><td><a name="l483" href="#l483">483</a><td>goog.exportSymbol(&#39;is&#39;, webdriver.testing.asserts.equalTo);<tr><td><a name="l484" href="#l484">484</a><td>goog.exportSymbol(&#39;not&#39;, isNot);<tr><td><a name="l485" href="#l485">485</a><td>goog.exportSymbol(&#39;or&#39;, anyOf);</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
+<!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>asserts.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/webdriver/testing/asserts.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Assertions and expectation utilities for use in WebDriver test<tr><td><a id="l20"></a><a href="#l20">20</a><td> * cases.<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>goog.provide(&#39;webdriver.testing.Assertion&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.testing.ContainsMatcher&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;webdriver.testing.NegatedAssertion&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;webdriver.testing.assert&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;webdriver.testing.asserts&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;goog.labs.testing.CloseToMatcher&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;goog.labs.testing.EndsWithMatcher&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;goog.labs.testing.EqualToMatcher&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;goog.labs.testing.EqualsMatcher&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.labs.testing.GreaterThanEqualToMatcher&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;goog.labs.testing.GreaterThanMatcher&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;goog.labs.testing.LessThanEqualToMatcher&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;goog.labs.testing.LessThanMatcher&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;goog.labs.testing.InstanceOfMatcher&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;goog.labs.testing.IsNotMatcher&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;goog.labs.testing.IsNullMatcher&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;goog.labs.testing.IsNullOrUndefinedMatcher&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;goog.labs.testing.IsUndefinedMatcher&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;goog.labs.testing.Matcher&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;goog.labs.testing.ObjectEqualsMatcher&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;goog.labs.testing.RegexMatcher&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.require(&#39;goog.labs.testing.StartsWithMatcher&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.require(&#39;goog.labs.testing.assertThat&#39;);<tr><td><a id="l48"></a><a href="#l48">48</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l49"></a><a href="#l49">49</a><td>goog.require(&#39;webdriver.promise&#39;);<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>/**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * Accepts strins or array-like structures that contain {@code value}.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {*} value The value to check for.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @constructor<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>webdriver.testing.ContainsMatcher = function(value) {<tr><td><a id="l59"></a><a href="#l59">59</a><td>  /** @private {*} */<tr><td><a id="l60"></a><a href="#l60">60</a><td>  this.value_ = value;<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>/** @override */<tr><td><a id="l65"></a><a href="#l65">65</a><td>webdriver.testing.ContainsMatcher.prototype.matches = function(actualValue) {<tr><td><a id="l66"></a><a href="#l66">66</a><td>  if (goog.isString(actualValue)) {<tr><td><a id="l67"></a><a href="#l67">67</a><td>    return goog.string.contains(<tr><td><a id="l68"></a><a href="#l68">68</a><td>        actualValue, /** @type {string} */(this.value_));<tr><td><a id="l69"></a><a href="#l69">69</a><td>  } else {<tr><td><a id="l70"></a><a href="#l70">70</a><td>    return goog.array.contains(<tr><td><a id="l71"></a><a href="#l71">71</a><td>        /** @type {goog.array.ArrayLike} */(actualValue), this.value_);<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><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/** @override */<tr><td><a id="l77"></a><a href="#l77">77</a><td>webdriver.testing.ContainsMatcher.prototype.describe = function(actualValue) {<tr><td><a id="l78"></a><a href="#l78">78</a><td>  return actualValue + &#39; does not contain &#39; + this.value_;<tr><td><a id="l79"></a><a href="#l79">79</a><td>};<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>/**<tr><td><a id="l84"></a><a href="#l84">84</a><td> * Utility for performing assertions against a given {@code value}. If the<tr><td><a id="l85"></a><a href="#l85">85</a><td> * value is a {@link webdriver.promise.Promise}, this assertion will wait<tr><td><a id="l86"></a><a href="#l86">86</a><td> * for it to resolve before applying any matchers.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @param {*} value The value to wrap and apply matchers to.<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @constructor<tr><td><a id="l89"></a><a href="#l89">89</a><td> */<tr><td><a id="l90"></a><a href="#l90">90</a><td>webdriver.testing.Assertion = function(value) {<tr><td><a id="l91"></a><a href="#l91">91</a><td><tr><td><a id="l92"></a><a href="#l92">92</a><td>  /** @private {*} */<tr><td><a id="l93"></a><a href="#l93">93</a><td>  this.value_ = value;<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td>  if (!(this instanceof webdriver.testing.NegatedAssertion)) {<tr><td><a id="l96"></a><a href="#l96">96</a><td>    /**<tr><td><a id="l97"></a><a href="#l97">97</a><td>     * A self reference provided for writing fluent assertions:<tr><td><a id="l98"></a><a href="#l98">98</a><td>     *     webdriver.testing.assert(x).is.equalTo(y);<tr><td><a id="l99"></a><a href="#l99">99</a><td>     * @type {!webdriver.testing.Assertion}<tr><td><a id="l100"></a><a href="#l100">100</a><td>     */<tr><td><a id="l101"></a><a href="#l101">101</a><td>    this.is = this;<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>     * Negates any matchers applied to this instance&#39;s value:<tr><td><a id="l105"></a><a href="#l105">105</a><td>     *     webdriver.testing.assert(x).not.equalTo(y);<tr><td><a id="l106"></a><a href="#l106">106</a><td>     * @type {!webdriver.testing.NegatedAssertion}<tr><td><a id="l107"></a><a href="#l107">107</a><td>     */<tr><td><a id="l108"></a><a href="#l108">108</a><td>    this.not = new webdriver.testing.NegatedAssertion(value);<tr><td><a id="l109"></a><a href="#l109">109</a><td>  }<tr><td><a id="l110"></a><a href="#l110">110</a><td>};<tr><td><a id="l111"></a><a href="#l111">111</a><td><tr><td><a id="l112"></a><a href="#l112">112</a><td><tr><td><a id="l113"></a><a href="#l113">113</a><td>/**<tr><td><a id="l114"></a><a href="#l114">114</a><td> * Wraps an object literal implementing the Matcher interface. This is used<tr><td><a id="l115"></a><a href="#l115">115</a><td> * to appease the Closure compiler, which will not treat an object literal as<tr><td><a id="l116"></a><a href="#l116">116</a><td> * implementing an interface.<tr><td><a id="l117"></a><a href="#l117">117</a><td> * @param {{matches: function(*): boolean, describe: function(): string}} obj<tr><td><a id="l118"></a><a href="#l118">118</a><td> *     The object literal to delegate to.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @constructor<tr><td><a id="l120"></a><a href="#l120">120</a><td> * @implements {goog.labs.testing.Matcher}<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @private<tr><td><a id="l122"></a><a href="#l122">122</a><td> */<tr><td><a id="l123"></a><a href="#l123">123</a><td>webdriver.testing.Assertion.DelegatingMatcher_ = function(obj) {<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td>  /** @override */<tr><td><a id="l126"></a><a href="#l126">126</a><td>  this.matches = function(value) {<tr><td><a id="l127"></a><a href="#l127">127</a><td>    return obj.matches(value);<tr><td><a id="l128"></a><a href="#l128">128</a><td>  };<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>  /** @override */<tr><td><a id="l131"></a><a href="#l131">131</a><td>  this.describe = function() {<tr><td><a id="l132"></a><a href="#l132">132</a><td>    return obj.describe();<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><tr><td><a id="l137"></a><a href="#l137">137</a><td>/**<tr><td><a id="l138"></a><a href="#l138">138</a><td> * Asserts that the given {@code matcher} accepts the value wrapped by this<tr><td><a id="l139"></a><a href="#l139">139</a><td> * instance. If the wrapped value is a promise, this function will defer<tr><td><a id="l140"></a><a href="#l140">140</a><td> * applying the assertion until the value has been resolved. Otherwise, it<tr><td><a id="l141"></a><a href="#l141">141</a><td> * will be applied immediately.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @param {!goog.labs.testing.Matcher} matcher The matcher to apply<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l144"></a><a href="#l144">144</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @return {webdriver.promise.Promise} The deferred assertion result, or<tr><td><a id="l146"></a><a href="#l146">146</a><td> *     {@code null} if the assertion was immediately applied.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @protected<tr><td><a id="l148"></a><a href="#l148">148</a><td> */<tr><td><a id="l149"></a><a href="#l149">149</a><td>webdriver.testing.Assertion.prototype.apply = function(matcher, opt_message) {<tr><td><a id="l150"></a><a href="#l150">150</a><td>  var result = null;<tr><td><a id="l151"></a><a href="#l151">151</a><td>  if (webdriver.promise.isPromise(this.value_)) {<tr><td><a id="l152"></a><a href="#l152">152</a><td>    result = webdriver.promise.when(this.value_, function(value) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>      goog.labs.testing.assertThat(value, matcher, opt_message);<tr><td><a id="l154"></a><a href="#l154">154</a><td>    });<tr><td><a id="l155"></a><a href="#l155">155</a><td>  } else {<tr><td><a id="l156"></a><a href="#l156">156</a><td>    goog.labs.testing.assertThat(this.value_, matcher, opt_message);<tr><td><a id="l157"></a><a href="#l157">157</a><td>  }<tr><td><a id="l158"></a><a href="#l158">158</a><td>  return result;<tr><td><a id="l159"></a><a href="#l159">159</a><td>};<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * Asserts that the value managed by this assertion is a number strictly<tr><td><a id="l164"></a><a href="#l164">164</a><td> * greater than {@code value}.<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {number} value The minimum value.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l167"></a><a href="#l167">167</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>webdriver.testing.Assertion.prototype.greaterThan = function(<tr><td><a id="l171"></a><a href="#l171">171</a><td>    value, opt_message) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>  return this.apply(<tr><td><a id="l173"></a><a href="#l173">173</a><td>      new goog.labs.testing.GreaterThanMatcher(value), opt_message);<tr><td><a id="l174"></a><a href="#l174">174</a><td>};<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * Asserts that the value managed by this assertion is a number &gt;= the given<tr><td><a id="l179"></a><a href="#l179">179</a><td> * value.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @param {number} value The minimum value.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l182"></a><a href="#l182">182</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>webdriver.testing.Assertion.prototype.greaterThanEqualTo = function(<tr><td><a id="l186"></a><a href="#l186">186</a><td>    value, opt_message) {<tr><td><a id="l187"></a><a href="#l187">187</a><td>  return this.apply(<tr><td><a id="l188"></a><a href="#l188">188</a><td>      new goog.labs.testing.GreaterThanEqualToMatcher(value), opt_message);<tr><td><a id="l189"></a><a href="#l189">189</a><td>};<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td><tr><td><a id="l192"></a><a href="#l192">192</a><td>/**<tr><td><a id="l193"></a><a href="#l193">193</a><td> * Asserts that the value managed by this assertion is a number strictly less<tr><td><a id="l194"></a><a href="#l194">194</a><td> * than the given value.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @param {number} value The maximum value.<tr><td><a id="l196"></a><a href="#l196">196</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l197"></a><a href="#l197">197</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l199"></a><a href="#l199">199</a><td> */<tr><td><a id="l200"></a><a href="#l200">200</a><td>webdriver.testing.Assertion.prototype.lessThan = function(value, opt_message) {<tr><td><a id="l201"></a><a href="#l201">201</a><td>  return this.apply(<tr><td><a id="l202"></a><a href="#l202">202</a><td>      new goog.labs.testing.LessThanMatcher(value), opt_message);<tr><td><a id="l203"></a><a href="#l203">203</a><td>};<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * Asserts that the value managed by this assertion is a number &lt;= the given<tr><td><a id="l208"></a><a href="#l208">208</a><td> * value.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @param {number} value The maximum value.<tr><td><a id="l210"></a><a href="#l210">210</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l211"></a><a href="#l211">211</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l212"></a><a href="#l212">212</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l213"></a><a href="#l213">213</a><td> */<tr><td><a id="l214"></a><a href="#l214">214</a><td>webdriver.testing.Assertion.prototype.lessThanEqualTo = function(<tr><td><a id="l215"></a><a href="#l215">215</a><td>    value, opt_message) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>  return this.apply(<tr><td><a id="l217"></a><a href="#l217">217</a><td>      new goog.labs.testing.LessThanEqualToMatcher(value), opt_message);<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><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Asserts that the wrapped value is a number within a given distance of an<tr><td><a id="l223"></a><a href="#l223">223</a><td> * expected value.<tr><td><a id="l224"></a><a href="#l224">224</a><td> * @param {number} value The expected value.<tr><td><a id="l225"></a><a href="#l225">225</a><td> * @param {number} range The maximum amount the actual value is permitted to<tr><td><a id="l226"></a><a href="#l226">226</a><td> *     differ from the expected value.<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l228"></a><a href="#l228">228</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l230"></a><a href="#l230">230</a><td> */<tr><td><a id="l231"></a><a href="#l231">231</a><td>webdriver.testing.Assertion.prototype.closeTo = function(<tr><td><a id="l232"></a><a href="#l232">232</a><td>    value, range, opt_message) {<tr><td><a id="l233"></a><a href="#l233">233</a><td>  return this.apply(<tr><td><a id="l234"></a><a href="#l234">234</a><td>      new goog.labs.testing.CloseToMatcher(value, range), opt_message);<tr><td><a id="l235"></a><a href="#l235">235</a><td>};<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Asserts that the wrapped value is an instance of the given class.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {!Function} ctor The expected class constructor.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l242"></a><a href="#l242">242</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l244"></a><a href="#l244">244</a><td> */<tr><td><a id="l245"></a><a href="#l245">245</a><td>webdriver.testing.Assertion.prototype.instanceOf = function(ctor, opt_message) {<tr><td><a id="l246"></a><a href="#l246">246</a><td>  return this.apply(<tr><td><a id="l247"></a><a href="#l247">247</a><td>      new goog.labs.testing.InstanceOfMatcher(ctor), opt_message);<tr><td><a id="l248"></a><a href="#l248">248</a><td>};<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td><tr><td><a id="l251"></a><a href="#l251">251</a><td>/**<tr><td><a id="l252"></a><a href="#l252">252</a><td> * Asserts that the wrapped value is null.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l254"></a><a href="#l254">254</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l255"></a><a href="#l255">255</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l256"></a><a href="#l256">256</a><td> */<tr><td><a id="l257"></a><a href="#l257">257</a><td>webdriver.testing.Assertion.prototype.isNull = function(opt_message) {<tr><td><a id="l258"></a><a href="#l258">258</a><td>  return this.apply(new goog.labs.testing.IsNullMatcher(), opt_message);<tr><td><a id="l259"></a><a href="#l259">259</a><td>};<tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td><tr><td><a id="l262"></a><a href="#l262">262</a><td>/**<tr><td><a id="l263"></a><a href="#l263">263</a><td> * Asserts that the wrapped value is undefined.<tr><td><a id="l264"></a><a href="#l264">264</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l265"></a><a href="#l265">265</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l266"></a><a href="#l266">266</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l267"></a><a href="#l267">267</a><td> */<tr><td><a id="l268"></a><a href="#l268">268</a><td>webdriver.testing.Assertion.prototype.isUndefined = function(opt_message) {<tr><td><a id="l269"></a><a href="#l269">269</a><td>  return this.apply(new goog.labs.testing.IsUndefinedMatcher(), opt_message);<tr><td><a id="l270"></a><a href="#l270">270</a><td>};<tr><td><a id="l271"></a><a href="#l271">271</a><td><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> * Asserts that the wrapped value is null or undefined.<tr><td><a id="l275"></a><a href="#l275">275</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l276"></a><a href="#l276">276</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>webdriver.testing.Assertion.prototype.isNullOrUndefined = function(<tr><td><a id="l280"></a><a href="#l280">280</a><td>    opt_message) {<tr><td><a id="l281"></a><a href="#l281">281</a><td>  return this.apply(<tr><td><a id="l282"></a><a href="#l282">282</a><td>      new goog.labs.testing.IsNullOrUndefinedMatcher(), opt_message);<tr><td><a id="l283"></a><a href="#l283">283</a><td>};<tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td>/**<tr><td><a id="l287"></a><a href="#l287">287</a><td> * Asserts that the wrapped value is a string or array-like structure<tr><td><a id="l288"></a><a href="#l288">288</a><td> * containing the given value.<tr><td><a id="l289"></a><a href="#l289">289</a><td> * @param {*} value The expected value.<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l291"></a><a href="#l291">291</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l292"></a><a href="#l292">292</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l293"></a><a href="#l293">293</a><td> */<tr><td><a id="l294"></a><a href="#l294">294</a><td>webdriver.testing.Assertion.prototype.contains = function(value, opt_message) {<tr><td><a id="l295"></a><a href="#l295">295</a><td>  return this.apply(<tr><td><a id="l296"></a><a href="#l296">296</a><td>      new webdriver.testing.ContainsMatcher(value), opt_message);<tr><td><a id="l297"></a><a href="#l297">297</a><td>};<tr><td><a id="l298"></a><a href="#l298">298</a><td><tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>/**<tr><td><a id="l301"></a><a href="#l301">301</a><td> * Asserts that the wrapped value is a string ending with the given suffix.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @param {string} suffix The expected suffix.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l304"></a><a href="#l304">304</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l306"></a><a href="#l306">306</a><td> */<tr><td><a id="l307"></a><a href="#l307">307</a><td>webdriver.testing.Assertion.prototype.endsWith = function(<tr><td><a id="l308"></a><a href="#l308">308</a><td>    suffix, opt_message) {<tr><td><a id="l309"></a><a href="#l309">309</a><td>  return this.apply(<tr><td><a id="l310"></a><a href="#l310">310</a><td>      new goog.labs.testing.EndsWithMatcher(suffix), opt_message);<tr><td><a id="l311"></a><a href="#l311">311</a><td>};<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td><tr><td><a id="l314"></a><a href="#l314">314</a><td>/**<tr><td><a id="l315"></a><a href="#l315">315</a><td> * Asserts that the wrapped value is a string starting with the given prefix.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @param {string} prefix The expected prefix.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l318"></a><a href="#l318">318</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l319"></a><a href="#l319">319</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l320"></a><a href="#l320">320</a><td> */<tr><td><a id="l321"></a><a href="#l321">321</a><td>webdriver.testing.Assertion.prototype.startsWith = function(<tr><td><a id="l322"></a><a href="#l322">322</a><td>    prefix, opt_message) {<tr><td><a id="l323"></a><a href="#l323">323</a><td>  return this.apply(<tr><td><a id="l324"></a><a href="#l324">324</a><td>      new goog.labs.testing.StartsWithMatcher(prefix), opt_message);<tr><td><a id="l325"></a><a href="#l325">325</a><td>};<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>/**<tr><td><a id="l329"></a><a href="#l329">329</a><td> * Asserts that the wrapped value is a string that matches the given RegExp.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @param {!RegExp} regex The regex to test.<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l332"></a><a href="#l332">332</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l334"></a><a href="#l334">334</a><td> */<tr><td><a id="l335"></a><a href="#l335">335</a><td>webdriver.testing.Assertion.prototype.matches = function(regex, opt_message) {<tr><td><a id="l336"></a><a href="#l336">336</a><td>  return this.apply(new goog.labs.testing.RegexMatcher(regex), opt_message);<tr><td><a id="l337"></a><a href="#l337">337</a><td>};<tr><td><a id="l338"></a><a href="#l338">338</a><td><tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td>/**<tr><td><a id="l341"></a><a href="#l341">341</a><td> * Asserts that the value managed by this assertion is strictly equal to the<tr><td><a id="l342"></a><a href="#l342">342</a><td> * given {@code value}.<tr><td><a id="l343"></a><a href="#l343">343</a><td> * @param {*} value The expected value.<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @param {string=} opt_message A message to include if the matcher does not<tr><td><a id="l345"></a><a href="#l345">345</a><td> *     accept the value wrapped by this assertion.<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l347"></a><a href="#l347">347</a><td> */<tr><td><a id="l348"></a><a href="#l348">348</a><td>webdriver.testing.Assertion.prototype.equalTo = function(value, opt_message) {<tr><td><a id="l349"></a><a href="#l349">349</a><td>  return this.apply(webdriver.testing.asserts.equalTo(value), opt_message);<tr><td><a id="l350"></a><a href="#l350">350</a><td>};<tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td><tr><td><a id="l353"></a><a href="#l353">353</a><td>/**<tr><td><a id="l354"></a><a href="#l354">354</a><td> * Asserts that the value managed by this assertion is strictly true.<tr><td><a id="l355"></a><a href="#l355">355</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l356"></a><a href="#l356">356</a><td> */<tr><td><a id="l357"></a><a href="#l357">357</a><td>webdriver.testing.Assertion.prototype.isTrue = function() {<tr><td><a id="l358"></a><a href="#l358">358</a><td>  return this.equalTo(true);<tr><td><a id="l359"></a><a href="#l359">359</a><td>};<tr><td><a id="l360"></a><a href="#l360">360</a><td><tr><td><a id="l361"></a><a href="#l361">361</a><td><tr><td><a id="l362"></a><a href="#l362">362</a><td>/**<tr><td><a id="l363"></a><a href="#l363">363</a><td> * Asserts that the value managed by this assertion is strictly false.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @return {webdriver.promise.Promise} The assertion result.<tr><td><a id="l365"></a><a href="#l365">365</a><td> */<tr><td><a id="l366"></a><a href="#l366">366</a><td>webdriver.testing.Assertion.prototype.isFalse = function() {<tr><td><a id="l367"></a><a href="#l367">367</a><td>  return this.equalTo(false);<tr><td><a id="l368"></a><a href="#l368">368</a><td>};<tr><td><a id="l369"></a><a href="#l369">369</a><td><tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td><tr><td><a id="l372"></a><a href="#l372">372</a><td>/**<tr><td><a id="l373"></a><a href="#l373">373</a><td> * An assertion that negates any applied matchers.<tr><td><a id="l374"></a><a href="#l374">374</a><td> * @param {*} value The value to perform assertions on.<tr><td><a id="l375"></a><a href="#l375">375</a><td> * @constructor<tr><td><a id="l376"></a><a href="#l376">376</a><td> * @extends {webdriver.testing.Assertion}<tr><td><a id="l377"></a><a href="#l377">377</a><td> */<tr><td><a id="l378"></a><a href="#l378">378</a><td>webdriver.testing.NegatedAssertion = function(value) {<tr><td><a id="l379"></a><a href="#l379">379</a><td>  webdriver.testing.NegatedAssertion.base(this, &#39;constructor&#39;, value);<tr><td><a id="l380"></a><a href="#l380">380</a><td>  this.value = value;<tr><td><a id="l381"></a><a href="#l381">381</a><td>};<tr><td><a id="l382"></a><a href="#l382">382</a><td>goog.inherits(<tr><td><a id="l383"></a><a href="#l383">383</a><td>    webdriver.testing.NegatedAssertion, webdriver.testing.Assertion);<tr><td><a id="l384"></a><a href="#l384">384</a><td><tr><td><a id="l385"></a><a href="#l385">385</a><td><tr><td><a id="l386"></a><a href="#l386">386</a><td>/** @override */<tr><td><a id="l387"></a><a href="#l387">387</a><td>webdriver.testing.NegatedAssertion.prototype.apply = function(<tr><td><a id="l388"></a><a href="#l388">388</a><td>    matcher, opt_message) {<tr><td><a id="l389"></a><a href="#l389">389</a><td>  matcher = new goog.labs.testing.IsNotMatcher(matcher);<tr><td><a id="l390"></a><a href="#l390">390</a><td>  return webdriver.testing.NegatedAssertion.base(this, &#39;apply&#39;, matcher,<tr><td><a id="l391"></a><a href="#l391">391</a><td>                                                 opt_message);<tr><td><a id="l392"></a><a href="#l392">392</a><td>};<tr><td><a id="l393"></a><a href="#l393">393</a><td><tr><td><a id="l394"></a><a href="#l394">394</a><td>/**<tr><td><a id="l395"></a><a href="#l395">395</a><td> * Creates a new assertion.<tr><td><a id="l396"></a><a href="#l396">396</a><td> * @param {*} value The value to perform an assertion on.<tr><td><a id="l397"></a><a href="#l397">397</a><td> * @return {!webdriver.testing.Assertion} The new assertion.<tr><td><a id="l398"></a><a href="#l398">398</a><td> */<tr><td><a id="l399"></a><a href="#l399">399</a><td>webdriver.testing.assert = function(value) {<tr><td><a id="l400"></a><a href="#l400">400</a><td>  return new webdriver.testing.Assertion(value);<tr><td><a id="l401"></a><a href="#l401">401</a><td>};<tr><td><a id="l402"></a><a href="#l402">402</a><td><tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td>/**<tr><td><a id="l405"></a><a href="#l405">405</a><td> * Registers a new assertion to expose from the<tr><td><a id="l406"></a><a href="#l406">406</a><td> * {@link webdriver.testing.Assertion} prototype.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @param {string} name The assertion name.<tr><td><a id="l408"></a><a href="#l408">408</a><td> * @param {(function(new: goog.labs.testing.Matcher, *)|<tr><td><a id="l409"></a><a href="#l409">409</a><td> *          {matches: function(*): boolean,<tr><td><a id="l410"></a><a href="#l410">410</a><td> *           describe: function(): string})} matcherTemplate Either the<tr><td><a id="l411"></a><a href="#l411">411</a><td> *     matcher constructor to use, or an object literal defining a matcher.<tr><td><a id="l412"></a><a href="#l412">412</a><td> */<tr><td><a id="l413"></a><a href="#l413">413</a><td>webdriver.testing.assert.register = function(name, matcherTemplate) {<tr><td><a id="l414"></a><a href="#l414">414</a><td>  webdriver.testing.Assertion.prototype[name] = function(value, opt_message) {<tr><td><a id="l415"></a><a href="#l415">415</a><td>    var matcher;<tr><td><a id="l416"></a><a href="#l416">416</a><td>    if (goog.isFunction(matcherTemplate)) {<tr><td><a id="l417"></a><a href="#l417">417</a><td>      var ctor = /** @type {function(new: goog.labs.testing.Matcher, *)} */ (<tr><td><a id="l418"></a><a href="#l418">418</a><td>          matcherTemplate);<tr><td><a id="l419"></a><a href="#l419">419</a><td>      matcher = new ctor(value);<tr><td><a id="l420"></a><a href="#l420">420</a><td>    } else {<tr><td><a id="l421"></a><a href="#l421">421</a><td>      matcher = new webdriver.testing.Assertion.DelegatingMatcher_(value);<tr><td><a id="l422"></a><a href="#l422">422</a><td>    }<tr><td><a id="l423"></a><a href="#l423">423</a><td>    return this.apply(matcher, opt_message);<tr><td><a id="l424"></a><a href="#l424">424</a><td>  };<tr><td><a id="l425"></a><a href="#l425">425</a><td>};<tr><td><a id="l426"></a><a href="#l426">426</a><td><tr><td><a id="l427"></a><a href="#l427">427</a><td><tr><td><a id="l428"></a><a href="#l428">428</a><td>/**<tr><td><a id="l429"></a><a href="#l429">429</a><td> * Asserts that a matcher accepts a given value.  This function has two<tr><td><a id="l430"></a><a href="#l430">430</a><td> * signatures based on the number of arguments:<tr><td><a id="l431"></a><a href="#l431">431</a><td> *<tr><td><a id="l432"></a><a href="#l432">432</a><td> * Two arguments:<tr><td><a id="l433"></a><a href="#l433">433</a><td> *   assertThat(actualValue, matcher)<tr><td><a id="l434"></a><a href="#l434">434</a><td> * Three arguments:<tr><td><a id="l435"></a><a href="#l435">435</a><td> *   assertThat(failureMessage, actualValue, matcher)<tr><td><a id="l436"></a><a href="#l436">436</a><td> *<tr><td><a id="l437"></a><a href="#l437">437</a><td> * @param {*} failureMessageOrActualValue Either a failure message or the value<tr><td><a id="l438"></a><a href="#l438">438</a><td> *     to apply to the given matcher.<tr><td><a id="l439"></a><a href="#l439">439</a><td> * @param {*} actualValueOrMatcher Either the value to apply to the given<tr><td><a id="l440"></a><a href="#l440">440</a><td> *     matcher, or the matcher itself.<tr><td><a id="l441"></a><a href="#l441">441</a><td> * @param {goog.labs.testing.Matcher=} opt_matcher The matcher to use;<tr><td><a id="l442"></a><a href="#l442">442</a><td> *     ignored unless this function is invoked with three arguments.<tr><td><a id="l443"></a><a href="#l443">443</a><td> * @return {!webdriver.promise.Promise} The assertion result.<tr><td><a id="l444"></a><a href="#l444">444</a><td> * @deprecated Use webdriver.testing.asserts.assert instead.<tr><td><a id="l445"></a><a href="#l445">445</a><td> */<tr><td><a id="l446"></a><a href="#l446">446</a><td>webdriver.testing.asserts.assertThat = function(<tr><td><a id="l447"></a><a href="#l447">447</a><td>    failureMessageOrActualValue, actualValueOrMatcher, opt_matcher) {<tr><td><a id="l448"></a><a href="#l448">448</a><td>  var args = goog.array.slice(arguments, 0);<tr><td><a id="l449"></a><a href="#l449">449</a><td><tr><td><a id="l450"></a><a href="#l450">450</a><td>  var message = args.length &gt; 2 ? args.shift() : &#39;&#39;;<tr><td><a id="l451"></a><a href="#l451">451</a><td>  if (message) message += &#39;\n&#39;;<tr><td><a id="l452"></a><a href="#l452">452</a><td><tr><td><a id="l453"></a><a href="#l453">453</a><td>  var actualValue = args.shift();<tr><td><a id="l454"></a><a href="#l454">454</a><td>  var matcher = args.shift();<tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td>  return webdriver.promise.when(actualValue, function(value) {<tr><td><a id="l457"></a><a href="#l457">457</a><td>    goog.labs.testing.assertThat(value, matcher, message);<tr><td><a id="l458"></a><a href="#l458">458</a><td>  });<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> * Creates an equality matcher.<tr><td><a id="l464"></a><a href="#l464">464</a><td> * @param {*} expected The expected value.<tr><td><a id="l465"></a><a href="#l465">465</a><td> * @return {!goog.labs.testing.Matcher} The new matcher.<tr><td><a id="l466"></a><a href="#l466">466</a><td> */<tr><td><a id="l467"></a><a href="#l467">467</a><td>webdriver.testing.asserts.equalTo = function(expected) {<tr><td><a id="l468"></a><a href="#l468">468</a><td>  if (goog.isString(expected)) {<tr><td><a id="l469"></a><a href="#l469">469</a><td>    return new goog.labs.testing.EqualsMatcher(expected);<tr><td><a id="l470"></a><a href="#l470">470</a><td>  } else if (goog.isNumber(expected)) {<tr><td><a id="l471"></a><a href="#l471">471</a><td>    return new goog.labs.testing.EqualToMatcher(expected);<tr><td><a id="l472"></a><a href="#l472">472</a><td>  } else {<tr><td><a id="l473"></a><a href="#l473">473</a><td>    return new goog.labs.testing.ObjectEqualsMatcher(<tr><td><a id="l474"></a><a href="#l474">474</a><td>        /** @type {!Object} */ (expected));<tr><td><a id="l475"></a><a href="#l475">475</a><td>  }<tr><td><a id="l476"></a><a href="#l476">476</a><td>};<tr><td><a id="l477"></a><a href="#l477">477</a><td><tr><td><a id="l478"></a><a href="#l478">478</a><td><tr><td><a id="l479"></a><a href="#l479">479</a><td>goog.exportSymbol(&#39;assertThat&#39;, webdriver.testing.asserts.assertThat);<tr><td><a id="l480"></a><a href="#l480">480</a><td>// Mappings for goog.labs.testing matcher functions to the legacy<tr><td><a id="l481"></a><a href="#l481">481</a><td>// webdriver.testing.asserts matchers.<tr><td><a id="l482"></a><a href="#l482">482</a><td>goog.exportSymbol(&#39;contains&#39;, containsString);<tr><td><a id="l483"></a><a href="#l483">483</a><td>goog.exportSymbol(&#39;equalTo&#39;, webdriver.testing.asserts.equalTo);<tr><td><a id="l484"></a><a href="#l484">484</a><td>goog.exportSymbol(&#39;equals&#39;, webdriver.testing.asserts.equalTo);<tr><td><a id="l485"></a><a href="#l485">485</a><td>goog.exportSymbol(&#39;is&#39;, webdriver.testing.asserts.equalTo);<tr><td><a id="l486"></a><a href="#l486">486</a><td>goog.exportSymbol(&#39;not&#39;, isNot);<tr><td><a id="l487"></a><a href="#l487">487</a><td>goog.exportSymbol(&#39;or&#39;, anyOf);</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/testing/testcase.js.src.html b/docs/source/lib/webdriver/testing/testcase.js.src.html
new file mode 100644
index 0000000..334dcf7
--- /dev/null
+++ b/docs/source/lib/webdriver/testing/testcase.js.src.html
@@ -0,0 +1 @@
+<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>testcase.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/testing/testcase.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Defines a special test case that runs each test inside of a<tr><td><a name="l17" href="#l17">17</a><td> * {@code webdriver.Application}. This allows each phase to schedule<tr><td><a name="l18" href="#l18">18</a><td> * asynchronous actions that run to completion before the next phase of the<tr><td><a name="l19" href="#l19">19</a><td> * test.<tr><td><a name="l20" href="#l20">20</a><td> *<tr><td><a name="l21" href="#l21">21</a><td> * This file requires the global {@code G_testRunner} to be initialized before<tr><td><a name="l22" href="#l22">22</a><td> * use. This can be accomplished by also importing<tr><td><a name="l23" href="#l23">23</a><td> * {@link webdriver.testing.jsunit}. This namespace is not required by default<tr><td><a name="l24" href="#l24">24</a><td> * to improve interoperability with other namespaces that may initialize<tr><td><a name="l25" href="#l25">25</a><td> * G_testRunner.<tr><td><a name="l26" href="#l26">26</a><td> */<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>goog.provide(&#39;webdriver.testing.TestCase&#39;);<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td>goog.require(&#39;goog.testing.TestCase&#39;);<tr><td><a name="l31" href="#l31">31</a><td>goog.require(&#39;webdriver.promise.ControlFlow&#39;);<tr><td><a name="l32" href="#l32">32</a><td>/** @suppress {extraRequire} Imported for user convenience. */<tr><td><a name="l33" href="#l33">33</a><td>goog.require(&#39;webdriver.testing.asserts&#39;);<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td>/**<tr><td><a name="l38" href="#l38">38</a><td> * Constructs a test case that synchronizes each test case with the singleton<tr><td><a name="l39" href="#l39">39</a><td> * {@code webdriver.promise.ControlFlow}.<tr><td><a name="l40" href="#l40">40</a><td> *<tr><td><a name="l41" href="#l41">41</a><td> * @param {!webdriver.testing.Client} client The test client to use for<tr><td><a name="l42" href="#l42">42</a><td> *     reporting test results.<tr><td><a name="l43" href="#l43">43</a><td> * @param {string=} opt_name The name of the test case, defaults to<tr><td><a name="l44" href="#l44">44</a><td> *     &#39;Untitled Test Case&#39;.<tr><td><a name="l45" href="#l45">45</a><td> * @constructor<tr><td><a name="l46" href="#l46">46</a><td> * @extends {goog.testing.TestCase}<tr><td><a name="l47" href="#l47">47</a><td> */<tr><td><a name="l48" href="#l48">48</a><td>webdriver.testing.TestCase = function(client, opt_name) {<tr><td><a name="l49" href="#l49">49</a><td>  goog.base(this, opt_name);<tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td>  /** @private {!webdriver.testing.Client} */<tr><td><a name="l52" href="#l52">52</a><td>  this.client_ = client;<tr><td><a name="l53" href="#l53">53</a><td>};<tr><td><a name="l54" href="#l54">54</a><td>goog.inherits(webdriver.testing.TestCase, goog.testing.TestCase);<tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td><tr><td><a name="l57" href="#l57">57</a><td>/**<tr><td><a name="l58" href="#l58">58</a><td> * Executes the next test inside its own {@code webdriver.Application}.<tr><td><a name="l59" href="#l59">59</a><td> * @override<tr><td><a name="l60" href="#l60">60</a><td> */<tr><td><a name="l61" href="#l61">61</a><td>webdriver.testing.TestCase.prototype.cycleTests = function() {<tr><td><a name="l62" href="#l62">62</a><td>  var test = this.next();<tr><td><a name="l63" href="#l63">63</a><td>  if (!test) {<tr><td><a name="l64" href="#l64">64</a><td>    this.finalize();<tr><td><a name="l65" href="#l65">65</a><td>    return;<tr><td><a name="l66" href="#l66">66</a><td>  }<tr><td><a name="l67" href="#l67">67</a><td><tr><td><a name="l68" href="#l68">68</a><td>  goog.testing.TestCase.currentTestName = test.name;<tr><td><a name="l69" href="#l69">69</a><td>  this.result_.runCount++;<tr><td><a name="l70" href="#l70">70</a><td>  this.log(&#39;Running test: &#39; + test.name);<tr><td><a name="l71" href="#l71">71</a><td>  this.client_.sendTestStartedEvent(test.name);<tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>  var self = this;<tr><td><a name="l74" href="#l74">74</a><td>  var hadError = false;<tr><td><a name="l75" href="#l75">75</a><td>  var app = webdriver.promise.controlFlow();<tr><td><a name="l76" href="#l76">76</a><td><tr><td><a name="l77" href="#l77">77</a><td>  this.runSingleTest_(test, onError).then(function() {<tr><td><a name="l78" href="#l78">78</a><td>    hadError || self.doSuccess(test);<tr><td><a name="l79" href="#l79">79</a><td>    self.timeout(function() {<tr><td><a name="l80" href="#l80">80</a><td>      self.cycleTests();<tr><td><a name="l81" href="#l81">81</a><td>    }, 100);<tr><td><a name="l82" href="#l82">82</a><td>  });<tr><td><a name="l83" href="#l83">83</a><td><tr><td><a name="l84" href="#l84">84</a><td>  function onError(e) {<tr><td><a name="l85" href="#l85">85</a><td>    hadError = true;<tr><td><a name="l86" href="#l86">86</a><td>    self.doError(test, app.annotateError(e));<tr><td><a name="l87" href="#l87">87</a><td>    // Note: result_ is a @protected field but still uses the trailing<tr><td><a name="l88" href="#l88">88</a><td>    // underscore.<tr><td><a name="l89" href="#l89">89</a><td>    var err = self.result_.errors[self.result_.errors.length - 1];<tr><td><a name="l90" href="#l90">90</a><td>    self.client_.sendErrorEvent(err.toString());<tr><td><a name="l91" href="#l91">91</a><td>  }<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/** @override */<tr><td><a name="l96" href="#l96">96</a><td>webdriver.testing.TestCase.prototype.logError = function(name, opt_e) {<tr><td><a name="l97" href="#l97">97</a><td>  var errMsg = null;<tr><td><a name="l98" href="#l98">98</a><td>  var stack = null;<tr><td><a name="l99" href="#l99">99</a><td>  if (opt_e) {<tr><td><a name="l100" href="#l100">100</a><td>    this.log(opt_e);<tr><td><a name="l101" href="#l101">101</a><td>    if (goog.isString(opt_e)) {<tr><td><a name="l102" href="#l102">102</a><td>      errMsg = opt_e;<tr><td><a name="l103" href="#l103">103</a><td>    } else {<tr><td><a name="l104" href="#l104">104</a><td>      // In case someone calls this function directly, make sure we have a<tr><td><a name="l105" href="#l105">105</a><td>      // properly annotated error.<tr><td><a name="l106" href="#l106">106</a><td>      webdriver.promise.controlFlow().annotateError(opt_e);<tr><td><a name="l107" href="#l107">107</a><td>      errMsg = opt_e.toString();<tr><td><a name="l108" href="#l108">108</a><td>      stack = opt_e.stack.substring(errMsg.length + 1);<tr><td><a name="l109" href="#l109">109</a><td>    }<tr><td><a name="l110" href="#l110">110</a><td>  } else {<tr><td><a name="l111" href="#l111">111</a><td>    errMsg = &#39;An unknown error occurred&#39;;<tr><td><a name="l112" href="#l112">112</a><td>  }<tr><td><a name="l113" href="#l113">113</a><td>  var err = new goog.testing.TestCase.Error(name, errMsg, stack);<tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>  // Avoid double logging.<tr><td><a name="l116" href="#l116">116</a><td>  if (!opt_e || !opt_e[&#39;isJsUnitException&#39;] ||<tr><td><a name="l117" href="#l117">117</a><td>      !opt_e[&#39;loggedJsUnitException&#39;]) {<tr><td><a name="l118" href="#l118">118</a><td>    this.saveMessage(err.toString());<tr><td><a name="l119" href="#l119">119</a><td>  }<tr><td><a name="l120" href="#l120">120</a><td><tr><td><a name="l121" href="#l121">121</a><td>  if (opt_e &amp;&amp; opt_e[&#39;isJsUnitException&#39;]) {<tr><td><a name="l122" href="#l122">122</a><td>    opt_e[&#39;loggedJsUnitException&#39;] = true;<tr><td><a name="l123" href="#l123">123</a><td>  }<tr><td><a name="l124" href="#l124">124</a><td><tr><td><a name="l125" href="#l125">125</a><td>  return err;<tr><td><a name="l126" href="#l126">126</a><td>};<tr><td><a name="l127" href="#l127">127</a><td><tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td>/**<tr><td><a name="l130" href="#l130">130</a><td> * Executes a single test, scheduling each phase with the global application.<tr><td><a name="l131" href="#l131">131</a><td> * Each phase will wait for the application to go idle before moving on to the<tr><td><a name="l132" href="#l132">132</a><td> * next test phase.  This function models the follow basic test flow:<tr><td><a name="l133" href="#l133">133</a><td> *<tr><td><a name="l134" href="#l134">134</a><td> *   try {<tr><td><a name="l135" href="#l135">135</a><td> *     this.setUp.call(test.scope);<tr><td><a name="l136" href="#l136">136</a><td> *     test.ref.call(test.scope);<tr><td><a name="l137" href="#l137">137</a><td> *   } catch (ex) {<tr><td><a name="l138" href="#l138">138</a><td> *     onError(ex);<tr><td><a name="l139" href="#l139">139</a><td> *   } finally {<tr><td><a name="l140" href="#l140">140</a><td> *     try {<tr><td><a name="l141" href="#l141">141</a><td> *       this.tearDown.call(test.scope);<tr><td><a name="l142" href="#l142">142</a><td> *     } catch (e) {<tr><td><a name="l143" href="#l143">143</a><td> *       onError(e);<tr><td><a name="l144" href="#l144">144</a><td> *     }<tr><td><a name="l145" href="#l145">145</a><td> *   }<tr><td><a name="l146" href="#l146">146</a><td> *<tr><td><a name="l147" href="#l147">147</a><td> * @param {!goog.testing.TestCase.Test} test The test to run.<tr><td><a name="l148" href="#l148">148</a><td> * @param {function(*)} onError The function to call each time an error is<tr><td><a name="l149" href="#l149">149</a><td> *     detected.<tr><td><a name="l150" href="#l150">150</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l151" href="#l151">151</a><td> *     test has finished running.<tr><td><a name="l152" href="#l152">152</a><td> * @private<tr><td><a name="l153" href="#l153">153</a><td> */<tr><td><a name="l154" href="#l154">154</a><td>webdriver.testing.TestCase.prototype.runSingleTest_ = function(test, onError) {<tr><td><a name="l155" href="#l155">155</a><td>  var flow = webdriver.promise.controlFlow();<tr><td><a name="l156" href="#l156">156</a><td>  flow.clearHistory();<tr><td><a name="l157" href="#l157">157</a><td><tr><td><a name="l158" href="#l158">158</a><td>  return execute(test.name + &#39;.setUp()&#39;, this.setUp)().<tr><td><a name="l159" href="#l159">159</a><td>      then(execute(test.name + &#39;()&#39;, test.ref)).<tr><td><a name="l160" href="#l160">160</a><td>      thenCatch(onError).<tr><td><a name="l161" href="#l161">161</a><td>      then(execute(test.name + &#39;.tearDown()&#39;, this.tearDown)).<tr><td><a name="l162" href="#l162">162</a><td>      thenCatch(onError);<tr><td><a name="l163" href="#l163">163</a><td><tr><td><a name="l164" href="#l164">164</a><td>  function execute(description, fn) {<tr><td><a name="l165" href="#l165">165</a><td>    return function() {<tr><td><a name="l166" href="#l166">166</a><td>      return flow.execute(goog.bind(fn, test.scope), description);<tr><td><a name="l167" href="#l167">167</a><td>    }<tr><td><a name="l168" href="#l168">168</a><td>  }<tr><td><a name="l169" href="#l169">169</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/touchsequence.js.src.html b/docs/source/lib/webdriver/touchsequence.js.src.html
new file mode 100644
index 0000000..21fdb0f
--- /dev/null
+++ b/docs/source/lib/webdriver/touchsequence.js.src.html
@@ -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>touchsequence.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/webdriver/touchsequence.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>goog.provide(&#39;webdriver.TouchSequence&#39;);<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.require(&#39;goog.array&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td>goog.require(&#39;webdriver.Command&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.require(&#39;webdriver.CommandName&#39;);<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>/**<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Class for defining sequences of user touch interactions. Each sequence<tr><td><a id="l28"></a><a href="#l28">28</a><td> * will not be executed until {@link #perform} is called.<tr><td><a id="l29"></a><a href="#l29">29</a><td> *<tr><td><a id="l30"></a><a href="#l30">30</a><td> * Example:<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> *     new webdriver.TouchSequence(driver).<tr><td><a id="l33"></a><a href="#l33">33</a><td> *         tapAndHold({x: 0, y: 0}).<tr><td><a id="l34"></a><a href="#l34">34</a><td> *         move({x: 3, y: 4}).<tr><td><a id="l35"></a><a href="#l35">35</a><td> *         release({x: 10, y: 10}).<tr><td><a id="l36"></a><a href="#l36">36</a><td> *         perform();<tr><td><a id="l37"></a><a href="#l37">37</a><td> *<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @param {!webdriver.WebDriver} driver The driver instance to use.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @constructor<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>webdriver.TouchSequence = function(driver) {<tr><td><a id="l42"></a><a href="#l42">42</a><td><tr><td><a id="l43"></a><a href="#l43">43</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l44"></a><a href="#l44">44</a><td>  this.driver_ = driver;<tr><td><a id="l45"></a><a href="#l45">45</a><td><tr><td><a id="l46"></a><a href="#l46">46</a><td>  /** @private {!Array&lt;{description: string, command: !webdriver.Command}&gt;} */<tr><td><a id="l47"></a><a href="#l47">47</a><td>  this.touchActions_ = [];<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>/**<tr><td><a id="l52"></a><a href="#l52">52</a><td> * Schedules an action to be executed each time {@link #perform} is called on<tr><td><a id="l53"></a><a href="#l53">53</a><td> * this instance.<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @param {string} description A description of the command.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {!webdriver.Command} command The command.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @private<tr><td><a id="l57"></a><a href="#l57">57</a><td> */<tr><td><a id="l58"></a><a href="#l58">58</a><td>webdriver.TouchSequence.prototype.schedule_ = function(description, command) {<tr><td><a id="l59"></a><a href="#l59">59</a><td>  this.touchActions_.push({<tr><td><a id="l60"></a><a href="#l60">60</a><td>    description: description,<tr><td><a id="l61"></a><a href="#l61">61</a><td>    command: command<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><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> * Executes this action sequence.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved once<tr><td><a id="l69"></a><a href="#l69">69</a><td> *     this sequence has completed.<tr><td><a id="l70"></a><a href="#l70">70</a><td> */<tr><td><a id="l71"></a><a href="#l71">71</a><td>webdriver.TouchSequence.prototype.perform = function() {<tr><td><a id="l72"></a><a href="#l72">72</a><td>  // Make a protected copy of the scheduled actions. This will protect against<tr><td><a id="l73"></a><a href="#l73">73</a><td>  // users defining additional commands before this sequence is actually<tr><td><a id="l74"></a><a href="#l74">74</a><td>  // executed.<tr><td><a id="l75"></a><a href="#l75">75</a><td>  var actions = goog.array.clone(this.touchActions_);<tr><td><a id="l76"></a><a href="#l76">76</a><td>  var driver = this.driver_;<tr><td><a id="l77"></a><a href="#l77">77</a><td>  return driver.controlFlow().execute(function() {<tr><td><a id="l78"></a><a href="#l78">78</a><td>    goog.array.forEach(actions, function(action) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>      driver.schedule(action.command, action.description);<tr><td><a id="l80"></a><a href="#l80">80</a><td>    });<tr><td><a id="l81"></a><a href="#l81">81</a><td>  }, &#39;TouchSequence.perform&#39;);<tr><td><a id="l82"></a><a href="#l82">82</a><td>};<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Taps an element.<tr><td><a id="l87"></a><a href="#l87">87</a><td> *<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @param {!webdriver.WebElement} elem The element to tap.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l90"></a><a href="#l90">90</a><td> */<tr><td><a id="l91"></a><a href="#l91">91</a><td>webdriver.TouchSequence.prototype.tap = function(elem) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_SINGLE_TAP).<tr><td><a id="l93"></a><a href="#l93">93</a><td>      setParameter(&#39;element&#39;, elem.getRawId());<tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td>  this.schedule_(&#39;tap&#39;, command);<tr><td><a id="l96"></a><a href="#l96">96</a><td>  return this;<tr><td><a id="l97"></a><a href="#l97">97</a><td>};<tr><td><a id="l98"></a><a href="#l98">98</a><td><tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>/**<tr><td><a id="l101"></a><a href="#l101">101</a><td> * Double taps an element.<tr><td><a id="l102"></a><a href="#l102">102</a><td> *<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @param {!webdriver.WebElement} elem The element to double tap.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>webdriver.TouchSequence.prototype.doubleTap = function(elem) {<tr><td><a id="l107"></a><a href="#l107">107</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_DOUBLE_TAP).<tr><td><a id="l108"></a><a href="#l108">108</a><td>      setParameter(&#39;element&#39;, elem.getRawId());<tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td>  this.schedule_(&#39;doubleTap&#39;, command);<tr><td><a id="l111"></a><a href="#l111">111</a><td>  return this;<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>/**<tr><td><a id="l116"></a><a href="#l116">116</a><td> * Long press on an element.<tr><td><a id="l117"></a><a href="#l117">117</a><td> *<tr><td><a id="l118"></a><a href="#l118">118</a><td> * @param {!webdriver.WebElement} elem The element to long press.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l120"></a><a href="#l120">120</a><td> */<tr><td><a id="l121"></a><a href="#l121">121</a><td>webdriver.TouchSequence.prototype.longPress = function(elem) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_LONG_PRESS).<tr><td><a id="l123"></a><a href="#l123">123</a><td>      setParameter(&#39;element&#39;, elem.getRawId());<tr><td><a id="l124"></a><a href="#l124">124</a><td><tr><td><a id="l125"></a><a href="#l125">125</a><td>  this.schedule_(&#39;longPress&#39;, command);<tr><td><a id="l126"></a><a href="#l126">126</a><td>  return this;<tr><td><a id="l127"></a><a href="#l127">127</a><td>};<tr><td><a id="l128"></a><a href="#l128">128</a><td><tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td>/**<tr><td><a id="l131"></a><a href="#l131">131</a><td> * Touch down at the given location.<tr><td><a id="l132"></a><a href="#l132">132</a><td> *<tr><td><a id="l133"></a><a href="#l133">133</a><td> * @param {{x: number, y: number}} location The location to touch down at.<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l135"></a><a href="#l135">135</a><td> */<tr><td><a id="l136"></a><a href="#l136">136</a><td>webdriver.TouchSequence.prototype.tapAndHold = function(location) {<tr><td><a id="l137"></a><a href="#l137">137</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_DOWN).<tr><td><a id="l138"></a><a href="#l138">138</a><td>      setParameter(&#39;x&#39;, location.x).<tr><td><a id="l139"></a><a href="#l139">139</a><td>      setParameter(&#39;y&#39;, location.y);<tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td>  this.schedule_(&#39;tapAndHold&#39;, command);<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> * Move a held {@linkplain #tapAndHold touch} to the specified location.<tr><td><a id="l148"></a><a href="#l148">148</a><td> *<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @param {{x: number, y: number}} location The location to move to.<tr><td><a id="l150"></a><a href="#l150">150</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l151"></a><a href="#l151">151</a><td> */<tr><td><a id="l152"></a><a href="#l152">152</a><td>webdriver.TouchSequence.prototype.move = function(location) {<tr><td><a id="l153"></a><a href="#l153">153</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_MOVE).<tr><td><a id="l154"></a><a href="#l154">154</a><td>      setParameter(&#39;x&#39;, location.x).<tr><td><a id="l155"></a><a href="#l155">155</a><td>      setParameter(&#39;y&#39;, location.y);<tr><td><a id="l156"></a><a href="#l156">156</a><td><tr><td><a id="l157"></a><a href="#l157">157</a><td>  this.schedule_(&#39;move&#39;, command);<tr><td><a id="l158"></a><a href="#l158">158</a><td>  return this;<tr><td><a id="l159"></a><a href="#l159">159</a><td>};<tr><td><a id="l160"></a><a href="#l160">160</a><td><tr><td><a id="l161"></a><a href="#l161">161</a><td><tr><td><a id="l162"></a><a href="#l162">162</a><td>/**<tr><td><a id="l163"></a><a href="#l163">163</a><td> * Release a held {@linkplain #tapAndHold touch} at the specified location.<tr><td><a id="l164"></a><a href="#l164">164</a><td> *<tr><td><a id="l165"></a><a href="#l165">165</a><td> * @param {{x: number, y: number}} location The location to release at.<tr><td><a id="l166"></a><a href="#l166">166</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l167"></a><a href="#l167">167</a><td> */<tr><td><a id="l168"></a><a href="#l168">168</a><td>webdriver.TouchSequence.prototype.release = function(location) {<tr><td><a id="l169"></a><a href="#l169">169</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_UP).<tr><td><a id="l170"></a><a href="#l170">170</a><td>      setParameter(&#39;x&#39;, location.x).<tr><td><a id="l171"></a><a href="#l171">171</a><td>      setParameter(&#39;y&#39;, location.y);<tr><td><a id="l172"></a><a href="#l172">172</a><td><tr><td><a id="l173"></a><a href="#l173">173</a><td>  this.schedule_(&#39;release&#39;, command);<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> * Scrolls the touch screen by the given offset.<tr><td><a id="l180"></a><a href="#l180">180</a><td> *<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {{x: number, y: number}} offset The offset to scroll to.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l183"></a><a href="#l183">183</a><td> */<tr><td><a id="l184"></a><a href="#l184">184</a><td>webdriver.TouchSequence.prototype.scroll = function(offset) {<tr><td><a id="l185"></a><a href="#l185">185</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_SCROLL).<tr><td><a id="l186"></a><a href="#l186">186</a><td>      setParameter(&#39;xoffset&#39;, offset.x).<tr><td><a id="l187"></a><a href="#l187">187</a><td>      setParameter(&#39;yoffset&#39;, offset.y);<tr><td><a id="l188"></a><a href="#l188">188</a><td><tr><td><a id="l189"></a><a href="#l189">189</a><td>  this.schedule_(&#39;scroll&#39;, command);<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> * Scrolls the touch screen, starting on `elem` and moving by the specified<tr><td><a id="l196"></a><a href="#l196">196</a><td> * offset.<tr><td><a id="l197"></a><a href="#l197">197</a><td> *<tr><td><a id="l198"></a><a href="#l198">198</a><td> * @param {!webdriver.WebElement} elem The element where scroll starts.<tr><td><a id="l199"></a><a href="#l199">199</a><td> * @param {{x: number, y: number}} offset The offset to scroll to.<tr><td><a id="l200"></a><a href="#l200">200</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l201"></a><a href="#l201">201</a><td> */<tr><td><a id="l202"></a><a href="#l202">202</a><td>webdriver.TouchSequence.prototype.scrollFromElement = function(elem, offset) {<tr><td><a id="l203"></a><a href="#l203">203</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_SCROLL).<tr><td><a id="l204"></a><a href="#l204">204</a><td>      setParameter(&#39;element&#39;, elem.getRawId()).<tr><td><a id="l205"></a><a href="#l205">205</a><td>      setParameter(&#39;xoffset&#39;, offset.x).<tr><td><a id="l206"></a><a href="#l206">206</a><td>      setParameter(&#39;yoffset&#39;, offset.y);<tr><td><a id="l207"></a><a href="#l207">207</a><td><tr><td><a id="l208"></a><a href="#l208">208</a><td>  this.schedule_(&#39;scrollFromElement&#39;, command);<tr><td><a id="l209"></a><a href="#l209">209</a><td>  return this;<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> * Flick, starting anywhere on the screen, at speed xspeed and yspeed.<tr><td><a id="l215"></a><a href="#l215">215</a><td> *<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @param {{xspeed: number, yspeed: number}} speed The speed to flick in each<tr><td><a id="l217"></a><a href="#l217">217</a><td>       direction, in pixels per second.<tr><td><a id="l218"></a><a href="#l218">218</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>webdriver.TouchSequence.prototype.flick = function(speed) {<tr><td><a id="l221"></a><a href="#l221">221</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_FLICK).<tr><td><a id="l222"></a><a href="#l222">222</a><td>      setParameter(&#39;xspeed&#39;, speed.xspeed).<tr><td><a id="l223"></a><a href="#l223">223</a><td>      setParameter(&#39;yspeed&#39;, speed.yspeed);<tr><td><a id="l224"></a><a href="#l224">224</a><td><tr><td><a id="l225"></a><a href="#l225">225</a><td>  this.schedule_(&#39;flick&#39;, command);<tr><td><a id="l226"></a><a href="#l226">226</a><td>  return this;<tr><td><a id="l227"></a><a href="#l227">227</a><td>};<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>/**<tr><td><a id="l231"></a><a href="#l231">231</a><td> * Flick starting at elem and moving by x and y at specified speed.<tr><td><a id="l232"></a><a href="#l232">232</a><td> *<tr><td><a id="l233"></a><a href="#l233">233</a><td> * @param {!webdriver.WebElement} elem The element where flick starts.<tr><td><a id="l234"></a><a href="#l234">234</a><td> * @param {{x: number, y: number}} offset The offset to flick to.<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @param {number} speed The speed to flick at in pixels per second.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @return {!webdriver.TouchSequence} A self reference.<tr><td><a id="l237"></a><a href="#l237">237</a><td> */<tr><td><a id="l238"></a><a href="#l238">238</a><td>webdriver.TouchSequence.prototype.flickElement = function(elem, offset, speed) {<tr><td><a id="l239"></a><a href="#l239">239</a><td>  var command = new webdriver.Command(webdriver.CommandName.TOUCH_FLICK).<tr><td><a id="l240"></a><a href="#l240">240</a><td>      setParameter(&#39;element&#39;, elem.getRawId()).<tr><td><a id="l241"></a><a href="#l241">241</a><td>      setParameter(&#39;xoffset&#39;, offset.x).<tr><td><a id="l242"></a><a href="#l242">242</a><td>      setParameter(&#39;yoffset&#39;, offset.y).<tr><td><a id="l243"></a><a href="#l243">243</a><td>      setParameter(&#39;speed&#39;, speed);<tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td>  this.schedule_(&#39;flickElement&#39;, command);<tr><td><a id="l246"></a><a href="#l246">246</a><td>  return this;<tr><td><a id="l247"></a><a href="#l247">247</a><td>};<tr><td><a id="l248"></a><a href="#l248">248</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/until.js.src.html b/docs/source/lib/webdriver/until.js.src.html
new file mode 100644
index 0000000..bfe9ce0
--- /dev/null
+++ b/docs/source/lib/webdriver/until.js.src.html
@@ -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>until.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/webdriver/until.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines common conditions for use with<tr><td><a id="l20"></a><a href="#l20">20</a><td> * {@link webdriver.WebDriver#wait WebDriver wait}.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Sample usage:<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> *     driver.get(&#39;http://www.google.com/ncr&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> *     var query = driver.wait(until.elementLocated(By.name(&#39;q&#39;)));<tr><td><a id="l27"></a><a href="#l27">27</a><td> *     query.sendKeys(&#39;webdriver\n&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> *     driver.wait(until.titleIs(&#39;webdriver - Google Search&#39;));<tr><td><a id="l30"></a><a href="#l30">30</a><td> *<tr><td><a id="l31"></a><a href="#l31">31</a><td> * To define a custom condition, simply call WebDriver.wait with a function<tr><td><a id="l32"></a><a href="#l32">32</a><td> * that will eventually return a truthy-value (neither null, undefined, false,<tr><td><a id="l33"></a><a href="#l33">33</a><td> * 0, or the empty string):<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> *     driver.wait(function() {<tr><td><a id="l36"></a><a href="#l36">36</a><td> *       return driver.getTitle().then(function(title) {<tr><td><a id="l37"></a><a href="#l37">37</a><td> *         return title === &#39;webdriver - Google Search&#39;;<tr><td><a id="l38"></a><a href="#l38">38</a><td> *       });<tr><td><a id="l39"></a><a href="#l39">39</a><td> *     }, 1000);<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>goog.provide(&#39;webdriver.until&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;bot.ErrorCode&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.require(&#39;webdriver.Locator&#39;);<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>goog.scope(function() {<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>var until = webdriver.until;<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> * Defines a condition to<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {string} message A descriptive error message. Should complete the<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     sentence &quot;Waiting [...]&quot;<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {function(!webdriver.WebDriver): OUT} fn The condition function to<tr><td><a id="l61"></a><a href="#l61">61</a><td> *     evaluate on each iteration of the wait loop.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @constructor<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @struct<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @final<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @template OUT<tr><td><a id="l66"></a><a href="#l66">66</a><td> */<tr><td><a id="l67"></a><a href="#l67">67</a><td>until.Condition = function(message, fn) {<tr><td><a id="l68"></a><a href="#l68">68</a><td>  /** @private {string} */<tr><td><a id="l69"></a><a href="#l69">69</a><td>  this.description_ = &#39;Waiting &#39; + message;<tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td>  /** @type {function(!webdriver.WebDriver): OUT} */<tr><td><a id="l72"></a><a href="#l72">72</a><td>  this.fn = fn;<tr><td><a id="l73"></a><a href="#l73">73</a><td>};<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/** @return {string} A description of this condition. */<tr><td><a id="l77"></a><a href="#l77">77</a><td>until.Condition.prototype.description = function() {<tr><td><a id="l78"></a><a href="#l78">78</a><td>  return this.description_;<tr><td><a id="l79"></a><a href="#l79">79</a><td>};<tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Creates a condition that will wait until the input driver is able to switch<tr><td><a id="l84"></a><a href="#l84">84</a><td> * to the designated frame. The target frame may be specified as<tr><td><a id="l85"></a><a href="#l85">85</a><td> *<tr><td><a id="l86"></a><a href="#l86">86</a><td> * 1. a numeric index into<tr><td><a id="l87"></a><a href="#l87">87</a><td> *     [window.frames](https://developer.mozilla.org/en-US/docs/Web/API/Window.frames)<tr><td><a id="l88"></a><a href="#l88">88</a><td> *     for the currently selected frame.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * 2. a {@link webdriver.WebElement}, which must reference a FRAME or IFRAME<tr><td><a id="l90"></a><a href="#l90">90</a><td> *     element on the current page.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * 3. a locator which may be used to first locate a FRAME or IFRAME on the<tr><td><a id="l92"></a><a href="#l92">92</a><td> *     current page before attempting to switch to it.<tr><td><a id="l93"></a><a href="#l93">93</a><td> *<tr><td><a id="l94"></a><a href="#l94">94</a><td> * Upon successful resolution of this condition, the driver will be left<tr><td><a id="l95"></a><a href="#l95">95</a><td> * focused on the new frame.<tr><td><a id="l96"></a><a href="#l96">96</a><td> *<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @param {!(number|webdriver.WebElement|<tr><td><a id="l98"></a><a href="#l98">98</a><td> *           webdriver.Locator|webdriver.By.Hash|<tr><td><a id="l99"></a><a href="#l99">99</a><td> *           function(!webdriver.WebDriver): !webdriver.WebElement)} frame<tr><td><a id="l100"></a><a href="#l100">100</a><td> *     The frame identifier.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @return {!until.Condition.&lt;boolean&gt;} A new condition.<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td>until.ableToSwitchToFrame = function(frame) {<tr><td><a id="l104"></a><a href="#l104">104</a><td>  var condition;<tr><td><a id="l105"></a><a href="#l105">105</a><td>  if (goog.isNumber(frame) || frame instanceof webdriver.WebElement) {<tr><td><a id="l106"></a><a href="#l106">106</a><td>    condition = attemptToSwitchFrames;<tr><td><a id="l107"></a><a href="#l107">107</a><td>  } else {<tr><td><a id="l108"></a><a href="#l108">108</a><td>    condition = function(driver) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>      var locator =<tr><td><a id="l110"></a><a href="#l110">110</a><td>          /** @type {!(webdriver.Locator|webdriver.By.Hash|Function)} */(frame);<tr><td><a id="l111"></a><a href="#l111">111</a><td>      return driver.findElements(locator).then(function(els) {<tr><td><a id="l112"></a><a href="#l112">112</a><td>        if (els.length) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>          return attemptToSwitchFrames(driver, els[0]);<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>    };<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 new until.Condition(&#39;to be able to switch to frame&#39;, condition);<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td>  function attemptToSwitchFrames(driver, frame) {<tr><td><a id="l122"></a><a href="#l122">122</a><td>    return driver.switchTo().frame(frame).then(<tr><td><a id="l123"></a><a href="#l123">123</a><td>        function() { return true; },<tr><td><a id="l124"></a><a href="#l124">124</a><td>        function(e) {<tr><td><a id="l125"></a><a href="#l125">125</a><td>          if (e &amp;&amp; e.code !== bot.ErrorCode.NO_SUCH_FRAME) {<tr><td><a id="l126"></a><a href="#l126">126</a><td>            throw e;<tr><td><a id="l127"></a><a href="#l127">127</a><td>          }<tr><td><a id="l128"></a><a href="#l128">128</a><td>        });<tr><td><a id="l129"></a><a href="#l129">129</a><td>  }<tr><td><a id="l130"></a><a href="#l130">130</a><td>};<tr><td><a id="l131"></a><a href="#l131">131</a><td><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> * Creates a condition that waits for an alert to be opened. Upon success, the<tr><td><a id="l135"></a><a href="#l135">135</a><td> * returned promise will be fulfilled with the handle for the opened alert.<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @return {!until.Condition.&lt;!webdriver.Alert&gt;} The new condition.<tr><td><a id="l138"></a><a href="#l138">138</a><td> */<tr><td><a id="l139"></a><a href="#l139">139</a><td>until.alertIsPresent = function() {<tr><td><a id="l140"></a><a href="#l140">140</a><td>  return new until.Condition(&#39;for alert to be present&#39;, function(driver) {<tr><td><a id="l141"></a><a href="#l141">141</a><td>    return driver.switchTo().alert().thenCatch(function(e) {<tr><td><a id="l142"></a><a href="#l142">142</a><td>      if (e &amp;&amp; e.code !== bot.ErrorCode.NO_SUCH_ALERT) {<tr><td><a id="l143"></a><a href="#l143">143</a><td>        throw e;<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>};<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>/**<tr><td><a id="l151"></a><a href="#l151">151</a><td> * Creates a condition that will wait for the current page&#39;s title to match the<tr><td><a id="l152"></a><a href="#l152">152</a><td> * given value.<tr><td><a id="l153"></a><a href="#l153">153</a><td> *<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {string} title The expected page title.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>until.titleIs = function(title) {<tr><td><a id="l158"></a><a href="#l158">158</a><td>  return new until.Condition(<tr><td><a id="l159"></a><a href="#l159">159</a><td>      &#39;for title to be &#39; + goog.string.quote(title),<tr><td><a id="l160"></a><a href="#l160">160</a><td>      function(driver) {<tr><td><a id="l161"></a><a href="#l161">161</a><td>        return driver.getTitle().then(function(t) {<tr><td><a id="l162"></a><a href="#l162">162</a><td>          return t === title;<tr><td><a id="l163"></a><a href="#l163">163</a><td>        });<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>/**<tr><td><a id="l169"></a><a href="#l169">169</a><td> * Creates a condition that will wait for the current page&#39;s title to contain<tr><td><a id="l170"></a><a href="#l170">170</a><td> * the given substring.<tr><td><a id="l171"></a><a href="#l171">171</a><td> *<tr><td><a id="l172"></a><a href="#l172">172</a><td> * @param {string} substr The substring that should be present in the page<tr><td><a id="l173"></a><a href="#l173">173</a><td> *     title.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l175"></a><a href="#l175">175</a><td> */<tr><td><a id="l176"></a><a href="#l176">176</a><td>until.titleContains = function(substr) {<tr><td><a id="l177"></a><a href="#l177">177</a><td>  return new until.Condition(<tr><td><a id="l178"></a><a href="#l178">178</a><td>      &#39;for title to contain &#39; + goog.string.quote(substr),<tr><td><a id="l179"></a><a href="#l179">179</a><td>      function(driver) {<tr><td><a id="l180"></a><a href="#l180">180</a><td>        return driver.getTitle().then(function(title) {<tr><td><a id="l181"></a><a href="#l181">181</a><td>          return title.indexOf(substr) !== -1;<tr><td><a id="l182"></a><a href="#l182">182</a><td>        });<tr><td><a id="l183"></a><a href="#l183">183</a><td>      });<tr><td><a id="l184"></a><a href="#l184">184</a><td>};<tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td><tr><td><a id="l187"></a><a href="#l187">187</a><td>/**<tr><td><a id="l188"></a><a href="#l188">188</a><td> * Creates a condition that will wait for the current page&#39;s title to match the<tr><td><a id="l189"></a><a href="#l189">189</a><td> * given regular expression.<tr><td><a id="l190"></a><a href="#l190">190</a><td> *<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {!RegExp} regex The regular expression to test against.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>until.titleMatches = function(regex) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>  return new until.Condition(&#39;for title to match &#39; + regex, function(driver) {<tr><td><a id="l196"></a><a href="#l196">196</a><td>    return driver.getTitle().then(function(title) {<tr><td><a id="l197"></a><a href="#l197">197</a><td>      return regex.test(title);<tr><td><a id="l198"></a><a href="#l198">198</a><td>    });<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>/**<tr><td><a id="l204"></a><a href="#l204">204</a><td> * Creates a condition that will loop until an element is<tr><td><a id="l205"></a><a href="#l205">205</a><td> * {@link webdriver.WebDriver#findElement found} with the given locator.<tr><td><a id="l206"></a><a href="#l206">206</a><td> *<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The locator<tr><td><a id="l208"></a><a href="#l208">208</a><td> *     to use.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @return {!until.Condition.&lt;!webdriver.WebElement&gt;} The new condition.<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>until.elementLocated = function(locator) {<tr><td><a id="l212"></a><a href="#l212">212</a><td>  locator = webdriver.Locator.checkLocator(locator);<tr><td><a id="l213"></a><a href="#l213">213</a><td>  var locatorStr = goog.isFunction(locator) ? &#39;by function()&#39; : locator + &#39;&#39;;<tr><td><a id="l214"></a><a href="#l214">214</a><td>  return new until.Condition(&#39;for element to be located &#39; + locatorStr,<tr><td><a id="l215"></a><a href="#l215">215</a><td>      function(driver) {<tr><td><a id="l216"></a><a href="#l216">216</a><td>        return driver.findElements(locator).then(function(elements) {<tr><td><a id="l217"></a><a href="#l217">217</a><td>          return elements[0];<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>};<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td>/**<tr><td><a id="l224"></a><a href="#l224">224</a><td> * Creates a condition that will loop until at least one element is<tr><td><a id="l225"></a><a href="#l225">225</a><td> * {@link webdriver.WebDriver#findElement found} with the given locator.<tr><td><a id="l226"></a><a href="#l226">226</a><td> *<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The locator<tr><td><a id="l228"></a><a href="#l228">228</a><td> *     to use.<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @return {!until.Condition.&lt;!Array.&lt;!webdriver.WebElement&gt;&gt;} The new<tr><td><a id="l230"></a><a href="#l230">230</a><td> *     condition.<tr><td><a id="l231"></a><a href="#l231">231</a><td> */<tr><td><a id="l232"></a><a href="#l232">232</a><td>until.elementsLocated = function(locator) {<tr><td><a id="l233"></a><a href="#l233">233</a><td>  locator = webdriver.Locator.checkLocator(locator);<tr><td><a id="l234"></a><a href="#l234">234</a><td>  var locatorStr = goog.isFunction(locator) ? &#39;by function()&#39; : locator + &#39;&#39;;<tr><td><a id="l235"></a><a href="#l235">235</a><td>  return new until.Condition(<tr><td><a id="l236"></a><a href="#l236">236</a><td>      &#39;for at least one element to be located &#39; + locatorStr,<tr><td><a id="l237"></a><a href="#l237">237</a><td>      function(driver) {<tr><td><a id="l238"></a><a href="#l238">238</a><td>        return driver.findElements(locator).then(function(elements) {<tr><td><a id="l239"></a><a href="#l239">239</a><td>          return elements.length &gt; 0 ? elements : null;<tr><td><a id="l240"></a><a href="#l240">240</a><td>        });<tr><td><a id="l241"></a><a href="#l241">241</a><td>      });<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>/**<tr><td><a id="l246"></a><a href="#l246">246</a><td> * Creates a condition that will wait for the given element to become stale. An<tr><td><a id="l247"></a><a href="#l247">247</a><td> * element is considered stale once it is removed from the DOM, or a new page<tr><td><a id="l248"></a><a href="#l248">248</a><td> * has loaded.<tr><td><a id="l249"></a><a href="#l249">249</a><td> *<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @param {!webdriver.WebElement} element The element that should become stale.<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l252"></a><a href="#l252">252</a><td> */<tr><td><a id="l253"></a><a href="#l253">253</a><td>until.stalenessOf = function(element) {<tr><td><a id="l254"></a><a href="#l254">254</a><td>  return new until.Condition(&#39;element to become stale&#39;, function() {<tr><td><a id="l255"></a><a href="#l255">255</a><td>    return element.getTagName().then(<tr><td><a id="l256"></a><a href="#l256">256</a><td>        function() { return false; },<tr><td><a id="l257"></a><a href="#l257">257</a><td>        function(e) {<tr><td><a id="l258"></a><a href="#l258">258</a><td>          if (e.code === bot.ErrorCode.STALE_ELEMENT_REFERENCE) {<tr><td><a id="l259"></a><a href="#l259">259</a><td>            return true;<tr><td><a id="l260"></a><a href="#l260">260</a><td>          }<tr><td><a id="l261"></a><a href="#l261">261</a><td>          throw e;<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>};<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>/**<tr><td><a id="l268"></a><a href="#l268">268</a><td> * Creates a condition that will wait for the given element to become visible.<tr><td><a id="l269"></a><a href="#l269">269</a><td> *<tr><td><a id="l270"></a><a href="#l270">270</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @see webdriver.WebDriver#isDisplayed<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td>until.elementIsVisible = function(element) {<tr><td><a id="l275"></a><a href="#l275">275</a><td>  return new until.Condition(&#39;until element is visible&#39;, function() {<tr><td><a id="l276"></a><a href="#l276">276</a><td>    return element.isDisplayed();<tr><td><a id="l277"></a><a href="#l277">277</a><td>  });<tr><td><a id="l278"></a><a href="#l278">278</a><td>};<tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td><tr><td><a id="l281"></a><a href="#l281">281</a><td>/**<tr><td><a id="l282"></a><a href="#l282">282</a><td> * Creates a condition that will wait for the given element to be in the DOM,<tr><td><a id="l283"></a><a href="#l283">283</a><td> * yet not visible to the user.<tr><td><a id="l284"></a><a href="#l284">284</a><td> *<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @see webdriver.WebDriver#isDisplayed<tr><td><a id="l288"></a><a href="#l288">288</a><td> */<tr><td><a id="l289"></a><a href="#l289">289</a><td>until.elementIsNotVisible = function(element) {<tr><td><a id="l290"></a><a href="#l290">290</a><td>  return new until.Condition(&#39;until element is not visible&#39;, function() {<tr><td><a id="l291"></a><a href="#l291">291</a><td>    return element.isDisplayed().then(function(v) {<tr><td><a id="l292"></a><a href="#l292">292</a><td>      return !v;<tr><td><a id="l293"></a><a href="#l293">293</a><td>    });<tr><td><a id="l294"></a><a href="#l294">294</a><td>  });<tr><td><a id="l295"></a><a href="#l295">295</a><td>};<tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td><tr><td><a id="l298"></a><a href="#l298">298</a><td>/**<tr><td><a id="l299"></a><a href="#l299">299</a><td> * Creates a condition that will wait for the given element to be enabled.<tr><td><a id="l300"></a><a href="#l300">300</a><td> *<tr><td><a id="l301"></a><a href="#l301">301</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @see webdriver.WebDriver#isEnabled<tr><td><a id="l304"></a><a href="#l304">304</a><td> */<tr><td><a id="l305"></a><a href="#l305">305</a><td>until.elementIsEnabled = function(element) {<tr><td><a id="l306"></a><a href="#l306">306</a><td>  return new until.Condition(&#39;until element is enabled&#39;, function() {<tr><td><a id="l307"></a><a href="#l307">307</a><td>    return element.isEnabled();<tr><td><a id="l308"></a><a href="#l308">308</a><td>  });<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><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Creates a condition that will wait for the given element to be disabled.<tr><td><a id="l314"></a><a href="#l314">314</a><td> *<tr><td><a id="l315"></a><a href="#l315">315</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @see webdriver.WebDriver#isEnabled<tr><td><a id="l318"></a><a href="#l318">318</a><td> */<tr><td><a id="l319"></a><a href="#l319">319</a><td>until.elementIsDisabled = function(element) {<tr><td><a id="l320"></a><a href="#l320">320</a><td>  return new until.Condition(&#39;until element is disabled&#39;, function() {<tr><td><a id="l321"></a><a href="#l321">321</a><td>    return element.isEnabled().then(function(v) {<tr><td><a id="l322"></a><a href="#l322">322</a><td>      return !v;<tr><td><a id="l323"></a><a href="#l323">323</a><td>    });<tr><td><a id="l324"></a><a href="#l324">324</a><td>  });<tr><td><a id="l325"></a><a href="#l325">325</a><td>};<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>/**<tr><td><a id="l329"></a><a href="#l329">329</a><td> * Creates a condition that will wait for the given element to be selected.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @see webdriver.WebDriver#isSelected<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>until.elementIsSelected = function(element) {<tr><td><a id="l335"></a><a href="#l335">335</a><td>  return new until.Condition(&#39;until element is selected&#39;, function() {<tr><td><a id="l336"></a><a href="#l336">336</a><td>    return element.isSelected();<tr><td><a id="l337"></a><a href="#l337">337</a><td>  });<tr><td><a id="l338"></a><a href="#l338">338</a><td>};<tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td>/**<tr><td><a id="l342"></a><a href="#l342">342</a><td> * Creates a condition that will wait for the given element to be deselected.<tr><td><a id="l343"></a><a href="#l343">343</a><td> *<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @see webdriver.WebDriver#isSelected<tr><td><a id="l347"></a><a href="#l347">347</a><td> */<tr><td><a id="l348"></a><a href="#l348">348</a><td>until.elementIsNotSelected = function(element) {<tr><td><a id="l349"></a><a href="#l349">349</a><td>  return new until.Condition(&#39;until element is not selected&#39;, function() {<tr><td><a id="l350"></a><a href="#l350">350</a><td>    return element.isSelected().then(function(v) {<tr><td><a id="l351"></a><a href="#l351">351</a><td>      return !v;<tr><td><a id="l352"></a><a href="#l352">352</a><td>    });<tr><td><a id="l353"></a><a href="#l353">353</a><td>  });<tr><td><a id="l354"></a><a href="#l354">354</a><td>};<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> * Creates a condition that will wait for the given element&#39;s<tr><td><a id="l359"></a><a href="#l359">359</a><td> * {@link webdriver.WebDriver#getText visible text} to match the given<tr><td><a id="l360"></a><a href="#l360">360</a><td> * {@code text} exactly.<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 {!webdriver.WebElement} element The element to test.<tr><td><a id="l363"></a><a href="#l363">363</a><td> * @param {string} text The expected text.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l365"></a><a href="#l365">365</a><td> * @see webdriver.WebDriver#getText<tr><td><a id="l366"></a><a href="#l366">366</a><td> */<tr><td><a id="l367"></a><a href="#l367">367</a><td>until.elementTextIs = function(element, text) {<tr><td><a id="l368"></a><a href="#l368">368</a><td>  return new until.Condition(&#39;until element text is&#39;, function() {<tr><td><a id="l369"></a><a href="#l369">369</a><td>    return element.getText().then(function(t) {<tr><td><a id="l370"></a><a href="#l370">370</a><td>      return t === text;<tr><td><a id="l371"></a><a href="#l371">371</a><td>    });<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>/**<tr><td><a id="l377"></a><a href="#l377">377</a><td> * Creates a condition that will wait for the given element&#39;s<tr><td><a id="l378"></a><a href="#l378">378</a><td> * {@link webdriver.WebDriver#getText visible text} to contain the given<tr><td><a id="l379"></a><a href="#l379">379</a><td> * substring.<tr><td><a id="l380"></a><a href="#l380">380</a><td> *<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @param {string} substr The substring to search for.<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l384"></a><a href="#l384">384</a><td> * @see webdriver.WebDriver#getText<tr><td><a id="l385"></a><a href="#l385">385</a><td> */<tr><td><a id="l386"></a><a href="#l386">386</a><td>until.elementTextContains = function(element, substr) {<tr><td><a id="l387"></a><a href="#l387">387</a><td>  return new until.Condition(&#39;until element text contains&#39;, function() {<tr><td><a id="l388"></a><a href="#l388">388</a><td>    return element.getText().then(function(t) {<tr><td><a id="l389"></a><a href="#l389">389</a><td>      return t.indexOf(substr) != -1;<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><tr><td><a id="l394"></a><a href="#l394">394</a><td><tr><td><a id="l395"></a><a href="#l395">395</a><td>/**<tr><td><a id="l396"></a><a href="#l396">396</a><td> * Creates a condition that will wait for the given element&#39;s<tr><td><a id="l397"></a><a href="#l397">397</a><td> * {@link webdriver.WebDriver#getText visible text} to match a regular<tr><td><a id="l398"></a><a href="#l398">398</a><td> * expression.<tr><td><a id="l399"></a><a href="#l399">399</a><td> *<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @param {!RegExp} regex The regular expression to test against.<tr><td><a id="l402"></a><a href="#l402">402</a><td> * @return {!until.Condition.&lt;boolean&gt;} The new condition.<tr><td><a id="l403"></a><a href="#l403">403</a><td> * @see webdriver.WebDriver#getText<tr><td><a id="l404"></a><a href="#l404">404</a><td> */<tr><td><a id="l405"></a><a href="#l405">405</a><td>until.elementTextMatches = function(element, regex) {<tr><td><a id="l406"></a><a href="#l406">406</a><td>  return new until.Condition(&#39;until element text matches&#39;, function() {<tr><td><a id="l407"></a><a href="#l407">407</a><td>    return element.getText().then(function(t) {<tr><td><a id="l408"></a><a href="#l408">408</a><td>      return regex.test(t);<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>};<tr><td><a id="l412"></a><a href="#l412">412</a><td>});  // goog.scope</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>
\ No newline at end of file
diff --git a/docs/source/lib/webdriver/webdriver.js.src.html b/docs/source/lib/webdriver/webdriver.js.src.html
index f65ebea..8a5ecc8 100644
--- a/docs/source/lib/webdriver/webdriver.js.src.html
+++ b/docs/source/lib/webdriver/webdriver.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>webdriver.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/webdriver.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>//      http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview The heart of the WebDriver JavaScript API.<tr><td><a name="l17" href="#l17">17</a><td> */<tr><td><a name="l18" href="#l18">18</a><td><tr><td><a name="l19" href="#l19">19</a><td>goog.provide(&#39;webdriver.Alert&#39;);<tr><td><a name="l20" href="#l20">20</a><td>goog.provide(&#39;webdriver.UnhandledAlertError&#39;);<tr><td><a name="l21" href="#l21">21</a><td>goog.provide(&#39;webdriver.WebDriver&#39;);<tr><td><a name="l22" href="#l22">22</a><td>goog.provide(&#39;webdriver.WebElement&#39;);<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td>goog.require(&#39;bot.Error&#39;);<tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;bot.ErrorCode&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;bot.response&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a name="l28" href="#l28">28</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a name="l29" href="#l29">29</a><td>goog.require(&#39;webdriver.ActionSequence&#39;);<tr><td><a name="l30" href="#l30">30</a><td>goog.require(&#39;webdriver.Command&#39;);<tr><td><a name="l31" href="#l31">31</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a name="l32" href="#l32">32</a><td>goog.require(&#39;webdriver.Key&#39;);<tr><td><a name="l33" href="#l33">33</a><td>goog.require(&#39;webdriver.Locator&#39;);<tr><td><a name="l34" href="#l34">34</a><td>goog.require(&#39;webdriver.Session&#39;);<tr><td><a name="l35" href="#l35">35</a><td>goog.require(&#39;webdriver.logging&#39;);<tr><td><a name="l36" href="#l36">36</a><td>goog.require(&#39;webdriver.promise&#39;);<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a name="l40" href="#l40">40</a><td>//<tr><td><a name="l41" href="#l41">41</a><td>//  webdriver.WebDriver<tr><td><a name="l42" href="#l42">42</a><td>//<tr><td><a name="l43" href="#l43">43</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td>/**<tr><td><a name="l48" href="#l48">48</a><td> * Creates a new WebDriver client, which provides control over a browser.<tr><td><a name="l49" href="#l49">49</a><td> *<tr><td><a name="l50" href="#l50">50</a><td> * Every WebDriver command returns a {@code webdriver.promise.Promise} that<tr><td><a name="l51" href="#l51">51</a><td> * represents the result of that command. Callbacks may be registered on this<tr><td><a name="l52" href="#l52">52</a><td> * object to manipulate the command result or catch an expected error. Any<tr><td><a name="l53" href="#l53">53</a><td> * commands scheduled with a callback are considered sub-commands and will<tr><td><a name="l54" href="#l54">54</a><td> * execute before the next command in the current frame. For example:<tr><td><a name="l55" href="#l55">55</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l56" href="#l56">56</a><td> *   var message = [];<tr><td><a name="l57" href="#l57">57</a><td> *   driver.call(message.push, message, &#39;a&#39;).then(function() {<tr><td><a name="l58" href="#l58">58</a><td> *     driver.call(message.push, message, &#39;b&#39;);<tr><td><a name="l59" href="#l59">59</a><td> *   });<tr><td><a name="l60" href="#l60">60</a><td> *   driver.call(message.push, message, &#39;c&#39;);<tr><td><a name="l61" href="#l61">61</a><td> *   driver.call(function() {<tr><td><a name="l62" href="#l62">62</a><td> *     alert(&#39;message is abc? &#39; + (message.join(&#39;&#39;) == &#39;abc&#39;));<tr><td><a name="l63" href="#l63">63</a><td> *   });<tr><td><a name="l64" href="#l64">64</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l65" href="#l65">65</a><td> *<tr><td><a name="l66" href="#l66">66</a><td> * @param {!(webdriver.Session|webdriver.promise.Promise)} session Either a<tr><td><a name="l67" href="#l67">67</a><td> *     known session or a promise that will be resolved to a session.<tr><td><a name="l68" href="#l68">68</a><td> * @param {!webdriver.CommandExecutor} executor The executor to use when<tr><td><a name="l69" href="#l69">69</a><td> *     sending commands to the browser.<tr><td><a name="l70" href="#l70">70</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The flow to<tr><td><a name="l71" href="#l71">71</a><td> *     schedule commands through. Defaults to the active flow object.<tr><td><a name="l72" href="#l72">72</a><td> * @constructor<tr><td><a name="l73" href="#l73">73</a><td> */<tr><td><a name="l74" href="#l74">74</a><td>webdriver.WebDriver = function(session, executor, opt_flow) {<tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td>  /** @private {!(webdriver.Session|webdriver.promise.Promise)} */<tr><td><a name="l77" href="#l77">77</a><td>  this.session_ = session;<tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td>  /** @private {!webdriver.CommandExecutor} */<tr><td><a name="l80" href="#l80">80</a><td>  this.executor_ = executor;<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td>  /** @private {!webdriver.promise.ControlFlow} */<tr><td><a name="l83" href="#l83">83</a><td>  this.flow_ = opt_flow || webdriver.promise.controlFlow();<tr><td><a name="l84" href="#l84">84</a><td>};<tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td><tr><td><a name="l87" href="#l87">87</a><td>/**<tr><td><a name="l88" href="#l88">88</a><td> * Creates a new WebDriver client for an existing session.<tr><td><a name="l89" href="#l89">89</a><td> * @param {!webdriver.CommandExecutor} executor Command executor to use when<tr><td><a name="l90" href="#l90">90</a><td> *     querying for session details.<tr><td><a name="l91" href="#l91">91</a><td> * @param {string} sessionId ID of the session to attach to.<tr><td><a name="l92" href="#l92">92</a><td> * @return {!webdriver.WebDriver} A new client for the specified session.<tr><td><a name="l93" href="#l93">93</a><td> */<tr><td><a name="l94" href="#l94">94</a><td>webdriver.WebDriver.attachToSession = function(executor, sessionId) {<tr><td><a name="l95" href="#l95">95</a><td>  return webdriver.WebDriver.acquireSession_(executor,<tr><td><a name="l96" href="#l96">96</a><td>      new webdriver.Command(webdriver.CommandName.DESCRIBE_SESSION).<tr><td><a name="l97" href="#l97">97</a><td>          setParameter(&#39;sessionId&#39;, sessionId),<tr><td><a name="l98" href="#l98">98</a><td>      &#39;WebDriver.attachToSession()&#39;);<tr><td><a name="l99" href="#l99">99</a><td>};<tr><td><a name="l100" href="#l100">100</a><td><tr><td><a name="l101" href="#l101">101</a><td><tr><td><a name="l102" href="#l102">102</a><td>/**<tr><td><a name="l103" href="#l103">103</a><td> * Creates a new WebDriver session.<tr><td><a name="l104" href="#l104">104</a><td> * @param {!webdriver.CommandExecutor} executor The executor to create the new<tr><td><a name="l105" href="#l105">105</a><td> *     session with.<tr><td><a name="l106" href="#l106">106</a><td> * @param {!webdriver.Capabilities} desiredCapabilities The desired<tr><td><a name="l107" href="#l107">107</a><td> *     capabilities for the new session.<tr><td><a name="l108" href="#l108">108</a><td> * @return {!webdriver.WebDriver} The driver for the newly created session.<tr><td><a name="l109" href="#l109">109</a><td> */<tr><td><a name="l110" href="#l110">110</a><td>webdriver.WebDriver.createSession = function(executor, desiredCapabilities) {<tr><td><a name="l111" href="#l111">111</a><td>  return webdriver.WebDriver.acquireSession_(executor,<tr><td><a name="l112" href="#l112">112</a><td>      new webdriver.Command(webdriver.CommandName.NEW_SESSION).<tr><td><a name="l113" href="#l113">113</a><td>          setParameter(&#39;desiredCapabilities&#39;, desiredCapabilities),<tr><td><a name="l114" href="#l114">114</a><td>      &#39;WebDriver.createSession()&#39;);<tr><td><a name="l115" href="#l115">115</a><td>};<tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td><tr><td><a name="l118" href="#l118">118</a><td>/**<tr><td><a name="l119" href="#l119">119</a><td> * Sends a command to the server that is expected to return the details for a<tr><td><a name="l120" href="#l120">120</a><td> * {@link webdriver.Session}. This may either be an existing session, or a<tr><td><a name="l121" href="#l121">121</a><td> * newly created one.<tr><td><a name="l122" href="#l122">122</a><td> * @param {!webdriver.CommandExecutor} executor Command executor to use when<tr><td><a name="l123" href="#l123">123</a><td> *     querying for session details.<tr><td><a name="l124" href="#l124">124</a><td> * @param {!webdriver.Command} command The command to send to fetch the session<tr><td><a name="l125" href="#l125">125</a><td> *     details.<tr><td><a name="l126" href="#l126">126</a><td> * @param {string} description A descriptive debug label for this action.<tr><td><a name="l127" href="#l127">127</a><td> * @return {!webdriver.WebDriver} A new WebDriver client for the session.<tr><td><a name="l128" href="#l128">128</a><td> * @private<tr><td><a name="l129" href="#l129">129</a><td> */<tr><td><a name="l130" href="#l130">130</a><td>webdriver.WebDriver.acquireSession_ = function(executor, command, description) {<tr><td><a name="l131" href="#l131">131</a><td>  var session = webdriver.promise.controlFlow().execute(function() {<tr><td><a name="l132" href="#l132">132</a><td>    return webdriver.WebDriver.executeCommand_(executor, command).<tr><td><a name="l133" href="#l133">133</a><td>        then(function(response) {<tr><td><a name="l134" href="#l134">134</a><td>          bot.response.checkResponse(response);<tr><td><a name="l135" href="#l135">135</a><td>          return new webdriver.Session(response[&#39;sessionId&#39;],<tr><td><a name="l136" href="#l136">136</a><td>              response[&#39;value&#39;]);<tr><td><a name="l137" href="#l137">137</a><td>        });<tr><td><a name="l138" href="#l138">138</a><td>  }, description);<tr><td><a name="l139" href="#l139">139</a><td>  return new webdriver.WebDriver(session, executor);<tr><td><a name="l140" href="#l140">140</a><td>};<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td>/**<tr><td><a name="l144" href="#l144">144</a><td> * Converts an object to its JSON representation in the WebDriver wire protocol.<tr><td><a name="l145" href="#l145">145</a><td> * When converting values of type object, the following steps will be taken:<tr><td><a name="l146" href="#l146">146</a><td> * &lt;ol&gt;<tr><td><a name="l147" href="#l147">147</a><td> * &lt;li&gt;if the object provides a &quot;toWireValue&quot; function, the return value will<tr><td><a name="l148" href="#l148">148</a><td> *     be returned in its fully resolved state (e.g. this function may return<tr><td><a name="l149" href="#l149">149</a><td> *     promise values)&lt;/li&gt;<tr><td><a name="l150" href="#l150">150</a><td> * &lt;li&gt;if the object provides a &quot;toJSON&quot; function, the return value of this<tr><td><a name="l151" href="#l151">151</a><td> *     function will be returned&lt;/li&gt;<tr><td><a name="l152" href="#l152">152</a><td> * &lt;li&gt;otherwise, the value of each key will be recursively converted according<tr><td><a name="l153" href="#l153">153</a><td> *     to the rules above.&lt;/li&gt;<tr><td><a name="l154" href="#l154">154</a><td> * &lt;/ol&gt;<tr><td><a name="l155" href="#l155">155</a><td> *<tr><td><a name="l156" href="#l156">156</a><td> * @param {*} obj The object to convert.<tr><td><a name="l157" href="#l157">157</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve to the<tr><td><a name="l158" href="#l158">158</a><td> *     input value&#39;s JSON representation.<tr><td><a name="l159" href="#l159">159</a><td> * @private<tr><td><a name="l160" href="#l160">160</a><td> * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol<tr><td><a name="l161" href="#l161">161</a><td> */<tr><td><a name="l162" href="#l162">162</a><td>webdriver.WebDriver.toWireValue_ = function(obj) {<tr><td><a name="l163" href="#l163">163</a><td>  switch (goog.typeOf(obj)) {<tr><td><a name="l164" href="#l164">164</a><td>    case &#39;array&#39;:<tr><td><a name="l165" href="#l165">165</a><td>      return webdriver.promise.fullyResolved(<tr><td><a name="l166" href="#l166">166</a><td>          goog.array.map(/** @type {!Array} */ (obj),<tr><td><a name="l167" href="#l167">167</a><td>              webdriver.WebDriver.toWireValue_));<tr><td><a name="l168" href="#l168">168</a><td>    case &#39;object&#39;:<tr><td><a name="l169" href="#l169">169</a><td>      if (goog.isFunction(obj.toWireValue)) {<tr><td><a name="l170" href="#l170">170</a><td>        return webdriver.promise.fullyResolved(obj.toWireValue());<tr><td><a name="l171" href="#l171">171</a><td>      }<tr><td><a name="l172" href="#l172">172</a><td>      if (goog.isFunction(obj.toJSON)) {<tr><td><a name="l173" href="#l173">173</a><td>        return webdriver.promise.fulfilled(obj.toJSON());<tr><td><a name="l174" href="#l174">174</a><td>      }<tr><td><a name="l175" href="#l175">175</a><td>      if (goog.isNumber(obj.nodeType) &amp;&amp; goog.isString(obj.nodeName)) {<tr><td><a name="l176" href="#l176">176</a><td>        throw Error([<tr><td><a name="l177" href="#l177">177</a><td>          &#39;Invalid argument type: &#39;, obj.nodeName, &#39;(&#39;, obj.nodeType, &#39;)&#39;<tr><td><a name="l178" href="#l178">178</a><td>        ].join(&#39;&#39;));<tr><td><a name="l179" href="#l179">179</a><td>      }<tr><td><a name="l180" href="#l180">180</a><td>      return webdriver.promise.fullyResolved(<tr><td><a name="l181" href="#l181">181</a><td>          goog.object.map(/** @type {!Object} */ (obj),<tr><td><a name="l182" href="#l182">182</a><td>              webdriver.WebDriver.toWireValue_));<tr><td><a name="l183" href="#l183">183</a><td>    case &#39;function&#39;:<tr><td><a name="l184" href="#l184">184</a><td>      return webdriver.promise.fulfilled(&#39;&#39; + obj);<tr><td><a name="l185" href="#l185">185</a><td>    case &#39;undefined&#39;:<tr><td><a name="l186" href="#l186">186</a><td>      return webdriver.promise.fulfilled(null);<tr><td><a name="l187" href="#l187">187</a><td>    default:<tr><td><a name="l188" href="#l188">188</a><td>      return webdriver.promise.fulfilled(obj);<tr><td><a name="l189" href="#l189">189</a><td>  }<tr><td><a name="l190" href="#l190">190</a><td>};<tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td><tr><td><a name="l193" href="#l193">193</a><td>/**<tr><td><a name="l194" href="#l194">194</a><td> * Converts a value from its JSON representation according to the WebDriver wire<tr><td><a name="l195" href="#l195">195</a><td> * protocol. Any JSON object containing a<tr><td><a name="l196" href="#l196">196</a><td> * {@code webdriver.WebElement.ELEMENT_KEY} key will be decoded to a<tr><td><a name="l197" href="#l197">197</a><td> * {@code webdriver.WebElement} object. All other values will be passed through<tr><td><a name="l198" href="#l198">198</a><td> * as is.<tr><td><a name="l199" href="#l199">199</a><td> * @param {!webdriver.WebDriver} driver The driver instance to use as the<tr><td><a name="l200" href="#l200">200</a><td> *     parent of any unwrapped {@code webdriver.WebElement} values.<tr><td><a name="l201" href="#l201">201</a><td> * @param {*} value The value to convert.<tr><td><a name="l202" href="#l202">202</a><td> * @return {*} The converted value.<tr><td><a name="l203" href="#l203">203</a><td> * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol<tr><td><a name="l204" href="#l204">204</a><td> * @private<tr><td><a name="l205" href="#l205">205</a><td> */<tr><td><a name="l206" href="#l206">206</a><td>webdriver.WebDriver.fromWireValue_ = function(driver, value) {<tr><td><a name="l207" href="#l207">207</a><td>  if (goog.isArray(value)) {<tr><td><a name="l208" href="#l208">208</a><td>    value = goog.array.map(/**@type {goog.array.ArrayLike}*/ (value),<tr><td><a name="l209" href="#l209">209</a><td>        goog.partial(webdriver.WebDriver.fromWireValue_, driver));<tr><td><a name="l210" href="#l210">210</a><td>  } else if (value &amp;&amp; goog.isObject(value) &amp;&amp; !goog.isFunction(value)) {<tr><td><a name="l211" href="#l211">211</a><td>    if (webdriver.WebElement.ELEMENT_KEY in value) {<tr><td><a name="l212" href="#l212">212</a><td>      value = new webdriver.WebElement(driver,<tr><td><a name="l213" href="#l213">213</a><td>          value[webdriver.WebElement.ELEMENT_KEY]);<tr><td><a name="l214" href="#l214">214</a><td>    } else {<tr><td><a name="l215" href="#l215">215</a><td>      value = goog.object.map(/**@type {!Object}*/ (value),<tr><td><a name="l216" href="#l216">216</a><td>          goog.partial(webdriver.WebDriver.fromWireValue_, driver));<tr><td><a name="l217" href="#l217">217</a><td>    }<tr><td><a name="l218" href="#l218">218</a><td>  }<tr><td><a name="l219" href="#l219">219</a><td>  return value;<tr><td><a name="l220" href="#l220">220</a><td>};<tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td><tr><td><a name="l223" href="#l223">223</a><td>/**<tr><td><a name="l224" href="#l224">224</a><td> * Translates a command to its wire-protocol representation before passing it<tr><td><a name="l225" href="#l225">225</a><td> * to the given {@code executor} for execution.<tr><td><a name="l226" href="#l226">226</a><td> * @param {!webdriver.CommandExecutor} executor The executor to use.<tr><td><a name="l227" href="#l227">227</a><td> * @param {!webdriver.Command} command The command to execute.<tr><td><a name="l228" href="#l228">228</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve with the<tr><td><a name="l229" href="#l229">229</a><td> *     command response.<tr><td><a name="l230" href="#l230">230</a><td> * @private<tr><td><a name="l231" href="#l231">231</a><td> */<tr><td><a name="l232" href="#l232">232</a><td>webdriver.WebDriver.executeCommand_ = function(executor, command) {<tr><td><a name="l233" href="#l233">233</a><td>  return webdriver.promise.fullyResolved(command.getParameters()).<tr><td><a name="l234" href="#l234">234</a><td>      then(webdriver.WebDriver.toWireValue_).<tr><td><a name="l235" href="#l235">235</a><td>      then(function(parameters) {<tr><td><a name="l236" href="#l236">236</a><td>        command.setParameters(parameters);<tr><td><a name="l237" href="#l237">237</a><td>        return webdriver.promise.checkedNodeCall(<tr><td><a name="l238" href="#l238">238</a><td>            goog.bind(executor.execute, executor, command));<tr><td><a name="l239" href="#l239">239</a><td>      });<tr><td><a name="l240" href="#l240">240</a><td>};<tr><td><a name="l241" href="#l241">241</a><td><tr><td><a name="l242" href="#l242">242</a><td><tr><td><a name="l243" href="#l243">243</a><td>/**<tr><td><a name="l244" href="#l244">244</a><td> * @return {!webdriver.promise.ControlFlow} The control flow used by this<tr><td><a name="l245" href="#l245">245</a><td> *     instance.<tr><td><a name="l246" href="#l246">246</a><td> */<tr><td><a name="l247" href="#l247">247</a><td>webdriver.WebDriver.prototype.controlFlow = function() {<tr><td><a name="l248" href="#l248">248</a><td>  return this.flow_;<tr><td><a name="l249" href="#l249">249</a><td>};<tr><td><a name="l250" href="#l250">250</a><td><tr><td><a name="l251" href="#l251">251</a><td><tr><td><a name="l252" href="#l252">252</a><td>/**<tr><td><a name="l253" href="#l253">253</a><td> * Schedules a {@code webdriver.Command} to be executed by this driver&#39;s<tr><td><a name="l254" href="#l254">254</a><td> * {@code webdriver.CommandExecutor}.<tr><td><a name="l255" href="#l255">255</a><td> * @param {!webdriver.Command} command The command to schedule.<tr><td><a name="l256" href="#l256">256</a><td> * @param {string} description A description of the command for debugging.<tr><td><a name="l257" href="#l257">257</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with<tr><td><a name="l258" href="#l258">258</a><td> *     the command result.<tr><td><a name="l259" href="#l259">259</a><td> */<tr><td><a name="l260" href="#l260">260</a><td>webdriver.WebDriver.prototype.schedule = function(command, description) {<tr><td><a name="l261" href="#l261">261</a><td>  var self = this;<tr><td><a name="l262" href="#l262">262</a><td><tr><td><a name="l263" href="#l263">263</a><td>  checkHasNotQuit();<tr><td><a name="l264" href="#l264">264</a><td>  command.setParameter(&#39;sessionId&#39;, this.session_);<tr><td><a name="l265" href="#l265">265</a><td><tr><td><a name="l266" href="#l266">266</a><td>  var flow = this.flow_;<tr><td><a name="l267" href="#l267">267</a><td>  return flow.execute(function() {<tr><td><a name="l268" href="#l268">268</a><td>    // A call to WebDriver.quit() may have been scheduled in the same event<tr><td><a name="l269" href="#l269">269</a><td>    // loop as this |command|, which would prevent us from detecting that the<tr><td><a name="l270" href="#l270">270</a><td>    // driver has quit above.  Therefore, we need to make another quick check.<tr><td><a name="l271" href="#l271">271</a><td>    // We still check above so we can fail as early as possible.<tr><td><a name="l272" href="#l272">272</a><td>    checkHasNotQuit();<tr><td><a name="l273" href="#l273">273</a><td>    return webdriver.WebDriver.executeCommand_(self.executor_, command);<tr><td><a name="l274" href="#l274">274</a><td>  }, description).then(function(response) {<tr><td><a name="l275" href="#l275">275</a><td>    try {<tr><td><a name="l276" href="#l276">276</a><td>      bot.response.checkResponse(response);<tr><td><a name="l277" href="#l277">277</a><td>    } catch (ex) {<tr><td><a name="l278" href="#l278">278</a><td>      var value = response[&#39;value&#39;];<tr><td><a name="l279" href="#l279">279</a><td>      if (ex.code === bot.ErrorCode.MODAL_DIALOG_OPENED) {<tr><td><a name="l280" href="#l280">280</a><td>        var text = value &amp;&amp; value[&#39;alert&#39;] ? value[&#39;alert&#39;][&#39;text&#39;] : &#39;&#39;;<tr><td><a name="l281" href="#l281">281</a><td>        throw new webdriver.UnhandledAlertError(ex.message,<tr><td><a name="l282" href="#l282">282</a><td>            new webdriver.Alert(self, text));<tr><td><a name="l283" href="#l283">283</a><td>      }<tr><td><a name="l284" href="#l284">284</a><td>      throw ex;<tr><td><a name="l285" href="#l285">285</a><td>    }<tr><td><a name="l286" href="#l286">286</a><td>    return webdriver.WebDriver.fromWireValue_(self, response[&#39;value&#39;]);<tr><td><a name="l287" href="#l287">287</a><td>  });<tr><td><a name="l288" href="#l288">288</a><td><tr><td><a name="l289" href="#l289">289</a><td>  function checkHasNotQuit() {<tr><td><a name="l290" href="#l290">290</a><td>    if (!self.session_) {<tr><td><a name="l291" href="#l291">291</a><td>      throw new Error(&#39;This driver instance does not have a valid session ID &#39; +<tr><td><a name="l292" href="#l292">292</a><td>                      &#39;(did you call WebDriver.quit()?) and may no longer be &#39; +<tr><td><a name="l293" href="#l293">293</a><td>                      &#39;used.&#39;);<tr><td><a name="l294" href="#l294">294</a><td>    }<tr><td><a name="l295" href="#l295">295</a><td>  }<tr><td><a name="l296" href="#l296">296</a><td>};<tr><td><a name="l297" href="#l297">297</a><td><tr><td><a name="l298" href="#l298">298</a><td><tr><td><a name="l299" href="#l299">299</a><td>// ----------------------------------------------------------------------------<tr><td><a name="l300" href="#l300">300</a><td>// Client command functions:<tr><td><a name="l301" href="#l301">301</a><td>// ----------------------------------------------------------------------------<tr><td><a name="l302" href="#l302">302</a><td><tr><td><a name="l303" href="#l303">303</a><td><tr><td><a name="l304" href="#l304">304</a><td>/**<tr><td><a name="l305" href="#l305">305</a><td> * @return {!webdriver.promise.Promise} A promise for this client&#39;s session.<tr><td><a name="l306" href="#l306">306</a><td> */<tr><td><a name="l307" href="#l307">307</a><td>webdriver.WebDriver.prototype.getSession = function() {<tr><td><a name="l308" href="#l308">308</a><td>  return webdriver.promise.when(this.session_);<tr><td><a name="l309" href="#l309">309</a><td>};<tr><td><a name="l310" href="#l310">310</a><td><tr><td><a name="l311" href="#l311">311</a><td><tr><td><a name="l312" href="#l312">312</a><td>/**<tr><td><a name="l313" href="#l313">313</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve with the<tr><td><a name="l314" href="#l314">314</a><td> *     this instance&#39;s capabilities.<tr><td><a name="l315" href="#l315">315</a><td> */<tr><td><a name="l316" href="#l316">316</a><td>webdriver.WebDriver.prototype.getCapabilities = function() {<tr><td><a name="l317" href="#l317">317</a><td>  return webdriver.promise.when(this.session_, function(session) {<tr><td><a name="l318" href="#l318">318</a><td>    return session.getCapabilities();<tr><td><a name="l319" href="#l319">319</a><td>  });<tr><td><a name="l320" href="#l320">320</a><td>};<tr><td><a name="l321" href="#l321">321</a><td><tr><td><a name="l322" href="#l322">322</a><td><tr><td><a name="l323" href="#l323">323</a><td>/**<tr><td><a name="l324" href="#l324">324</a><td> * Schedules a command to quit the current session. After calling quit, this<tr><td><a name="l325" href="#l325">325</a><td> * instance will be invalidated and may no longer be used to issue commands<tr><td><a name="l326" href="#l326">326</a><td> * against the browser.<tr><td><a name="l327" href="#l327">327</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l328" href="#l328">328</a><td> *     the command has completed.<tr><td><a name="l329" href="#l329">329</a><td> */<tr><td><a name="l330" href="#l330">330</a><td>webdriver.WebDriver.prototype.quit = function() {<tr><td><a name="l331" href="#l331">331</a><td>  var result = this.schedule(<tr><td><a name="l332" href="#l332">332</a><td>      new webdriver.Command(webdriver.CommandName.QUIT),<tr><td><a name="l333" href="#l333">333</a><td>      &#39;WebDriver.quit()&#39;);<tr><td><a name="l334" href="#l334">334</a><td>  // Delete our session ID when the quit command finishes; this will allow us to<tr><td><a name="l335" href="#l335">335</a><td>  // throw an error when attemnpting to use a driver post-quit.<tr><td><a name="l336" href="#l336">336</a><td>  return result.thenFinally(goog.bind(function() {<tr><td><a name="l337" href="#l337">337</a><td>    delete this.session_;<tr><td><a name="l338" href="#l338">338</a><td>  }, this));<tr><td><a name="l339" href="#l339">339</a><td>};<tr><td><a name="l340" href="#l340">340</a><td><tr><td><a name="l341" href="#l341">341</a><td><tr><td><a name="l342" href="#l342">342</a><td>/**<tr><td><a name="l343" href="#l343">343</a><td> * Creates a new action sequence using this driver. The sequence will not be<tr><td><a name="l344" href="#l344">344</a><td> * scheduled for execution until {@link webdriver.ActionSequence#perform} is<tr><td><a name="l345" href="#l345">345</a><td> * called. Example:<tr><td><a name="l346" href="#l346">346</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l347" href="#l347">347</a><td> *   driver.actions().<tr><td><a name="l348" href="#l348">348</a><td> *       mouseDown(element1).<tr><td><a name="l349" href="#l349">349</a><td> *       mouseMove(element2).<tr><td><a name="l350" href="#l350">350</a><td> *       mouseUp().<tr><td><a name="l351" href="#l351">351</a><td> *       perform();<tr><td><a name="l352" href="#l352">352</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l353" href="#l353">353</a><td> * @return {!webdriver.ActionSequence} A new action sequence for this instance.<tr><td><a name="l354" href="#l354">354</a><td> */<tr><td><a name="l355" href="#l355">355</a><td>webdriver.WebDriver.prototype.actions = function() {<tr><td><a name="l356" href="#l356">356</a><td>  return new webdriver.ActionSequence(this);<tr><td><a name="l357" href="#l357">357</a><td>};<tr><td><a name="l358" href="#l358">358</a><td><tr><td><a name="l359" href="#l359">359</a><td><tr><td><a name="l360" href="#l360">360</a><td>/**<tr><td><a name="l361" href="#l361">361</a><td> * Schedules a command to execute JavaScript in the context of the currently<tr><td><a name="l362" href="#l362">362</a><td> * selected frame or window. The script fragment will be executed as the body<tr><td><a name="l363" href="#l363">363</a><td> * of an anonymous function. If the script is provided as a function object,<tr><td><a name="l364" href="#l364">364</a><td> * that function will be converted to a string for injection into the target<tr><td><a name="l365" href="#l365">365</a><td> * window.<tr><td><a name="l366" href="#l366">366</a><td> *<tr><td><a name="l367" href="#l367">367</a><td> * Any arguments provided in addition to the script will be included as script<tr><td><a name="l368" href="#l368">368</a><td> * arguments and may be referenced using the {@code arguments} object.<tr><td><a name="l369" href="#l369">369</a><td> * Arguments may be a boolean, number, string, or {@code webdriver.WebElement}.<tr><td><a name="l370" href="#l370">370</a><td> * Arrays and objects may also be used as script arguments as long as each item<tr><td><a name="l371" href="#l371">371</a><td> * adheres to the types previously mentioned.<tr><td><a name="l372" href="#l372">372</a><td> *<tr><td><a name="l373" href="#l373">373</a><td> * The script may refer to any variables accessible from the current window.<tr><td><a name="l374" href="#l374">374</a><td> * Furthermore, the script will execute in the window&#39;s context, thus<tr><td><a name="l375" href="#l375">375</a><td> * {@code document} may be used to refer to the current document. Any local<tr><td><a name="l376" href="#l376">376</a><td> * variables will not be available once the script has finished executing,<tr><td><a name="l377" href="#l377">377</a><td> * though global variables will persist.<tr><td><a name="l378" href="#l378">378</a><td> *<tr><td><a name="l379" href="#l379">379</a><td> * If the script has a return value (i.e. if the script contains a return<tr><td><a name="l380" href="#l380">380</a><td> * statement), then the following steps will be taken for resolving this<tr><td><a name="l381" href="#l381">381</a><td> * functions return value:<tr><td><a name="l382" href="#l382">382</a><td> * &lt;ul&gt;<tr><td><a name="l383" href="#l383">383</a><td> * &lt;li&gt;For a HTML element, the value will resolve to a<tr><td><a name="l384" href="#l384">384</a><td> *     {@code webdriver.WebElement}&lt;/li&gt;<tr><td><a name="l385" href="#l385">385</a><td> * &lt;li&gt;Null and undefined return values will resolve to null&lt;/li&gt;<tr><td><a name="l386" href="#l386">386</a><td> * &lt;li&gt;Booleans, numbers, and strings will resolve as is&lt;/li&gt;<tr><td><a name="l387" href="#l387">387</a><td> * &lt;li&gt;Functions will resolve to their string representation&lt;/li&gt;<tr><td><a name="l388" href="#l388">388</a><td> * &lt;li&gt;For arrays and objects, each member item will be converted according to<tr><td><a name="l389" href="#l389">389</a><td> *     the rules above&lt;/li&gt;<tr><td><a name="l390" href="#l390">390</a><td> * &lt;/ul&gt;<tr><td><a name="l391" href="#l391">391</a><td> *<tr><td><a name="l392" href="#l392">392</a><td> * @param {!(string|Function)} script The script to execute.<tr><td><a name="l393" href="#l393">393</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a name="l394" href="#l394">394</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve to the<tr><td><a name="l395" href="#l395">395</a><td> *    scripts return value.<tr><td><a name="l396" href="#l396">396</a><td> */<tr><td><a name="l397" href="#l397">397</a><td>webdriver.WebDriver.prototype.executeScript = function(script, var_args) {<tr><td><a name="l398" href="#l398">398</a><td>  if (goog.isFunction(script)) {<tr><td><a name="l399" href="#l399">399</a><td>    script = &#39;return (&#39; + script + &#39;).apply(null, arguments);&#39;;<tr><td><a name="l400" href="#l400">400</a><td>  }<tr><td><a name="l401" href="#l401">401</a><td>  return this.schedule(<tr><td><a name="l402" href="#l402">402</a><td>      new webdriver.Command(webdriver.CommandName.EXECUTE_SCRIPT).<tr><td><a name="l403" href="#l403">403</a><td>          setParameter(&#39;script&#39;, script).<tr><td><a name="l404" href="#l404">404</a><td>          setParameter(&#39;args&#39;, goog.array.slice(arguments, 1)),<tr><td><a name="l405" href="#l405">405</a><td>      &#39;WebDriver.executeScript()&#39;);<tr><td><a name="l406" href="#l406">406</a><td>};<tr><td><a name="l407" href="#l407">407</a><td><tr><td><a name="l408" href="#l408">408</a><td><tr><td><a name="l409" href="#l409">409</a><td>/**<tr><td><a name="l410" href="#l410">410</a><td> * Schedules a command to execute asynchronous JavaScript in the context of the<tr><td><a name="l411" href="#l411">411</a><td> * currently selected frame or window. The script fragment will be executed as<tr><td><a name="l412" href="#l412">412</a><td> * the body of an anonymous function. If the script is provided as a function<tr><td><a name="l413" href="#l413">413</a><td> * object, that function will be converted to a string for injection into the<tr><td><a name="l414" href="#l414">414</a><td> * target window.<tr><td><a name="l415" href="#l415">415</a><td> *<tr><td><a name="l416" href="#l416">416</a><td> * Any arguments provided in addition to the script will be included as script<tr><td><a name="l417" href="#l417">417</a><td> * arguments and may be referenced using the {@code arguments} object.<tr><td><a name="l418" href="#l418">418</a><td> * Arguments may be a boolean, number, string, or {@code webdriver.WebElement}.<tr><td><a name="l419" href="#l419">419</a><td> * Arrays and objects may also be used as script arguments as long as each item<tr><td><a name="l420" href="#l420">420</a><td> * adheres to the types previously mentioned.<tr><td><a name="l421" href="#l421">421</a><td> *<tr><td><a name="l422" href="#l422">422</a><td> * Unlike executing synchronous JavaScript with<tr><td><a name="l423" href="#l423">423</a><td> * {@code webdriver.WebDriver.prototype.executeScript}, scripts executed with<tr><td><a name="l424" href="#l424">424</a><td> * this function must explicitly signal they are finished by invoking the<tr><td><a name="l425" href="#l425">425</a><td> * provided callback. This callback will always be injected into the<tr><td><a name="l426" href="#l426">426</a><td> * executed function as the last argument, and thus may be referenced with<tr><td><a name="l427" href="#l427">427</a><td> * {@code arguments[arguments.length - 1]}. The following steps will be taken<tr><td><a name="l428" href="#l428">428</a><td> * for resolving this functions return value against the first argument to the<tr><td><a name="l429" href="#l429">429</a><td> * script&#39;s callback function:<tr><td><a name="l430" href="#l430">430</a><td> * &lt;ul&gt;<tr><td><a name="l431" href="#l431">431</a><td> * &lt;li&gt;For a HTML element, the value will resolve to a<tr><td><a name="l432" href="#l432">432</a><td> *     {@code webdriver.WebElement}&lt;/li&gt;<tr><td><a name="l433" href="#l433">433</a><td> * &lt;li&gt;Null and undefined return values will resolve to null&lt;/li&gt;<tr><td><a name="l434" href="#l434">434</a><td> * &lt;li&gt;Booleans, numbers, and strings will resolve as is&lt;/li&gt;<tr><td><a name="l435" href="#l435">435</a><td> * &lt;li&gt;Functions will resolve to their string representation&lt;/li&gt;<tr><td><a name="l436" href="#l436">436</a><td> * &lt;li&gt;For arrays and objects, each member item will be converted according to<tr><td><a name="l437" href="#l437">437</a><td> *     the rules above&lt;/li&gt;<tr><td><a name="l438" href="#l438">438</a><td> * &lt;/ul&gt;<tr><td><a name="l439" href="#l439">439</a><td> *<tr><td><a name="l440" href="#l440">440</a><td> * Example #1: Performing a sleep that is synchronized with the currently<tr><td><a name="l441" href="#l441">441</a><td> * selected window:<tr><td><a name="l442" href="#l442">442</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l443" href="#l443">443</a><td> * var start = new Date().getTime();<tr><td><a name="l444" href="#l444">444</a><td> * driver.executeAsyncScript(<tr><td><a name="l445" href="#l445">445</a><td> *     &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).<tr><td><a name="l446" href="#l446">446</a><td> *     then(function() {<tr><td><a name="l447" href="#l447">447</a><td> *       console.log(&#39;Elapsed time: &#39; + (new Date().getTime() - start) + &#39; ms&#39;);<tr><td><a name="l448" href="#l448">448</a><td> *     });<tr><td><a name="l449" href="#l449">449</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l450" href="#l450">450</a><td> *<tr><td><a name="l451" href="#l451">451</a><td> * Example #2: Synchronizing a test with an AJAX application:<tr><td><a name="l452" href="#l452">452</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l453" href="#l453">453</a><td> * var button = driver.findElement(By.id(&#39;compose-button&#39;));<tr><td><a name="l454" href="#l454">454</a><td> * button.click();<tr><td><a name="l455" href="#l455">455</a><td> * driver.executeAsyncScript(<tr><td><a name="l456" href="#l456">456</a><td> *     &#39;var callback = arguments[arguments.length - 1];&#39; +<tr><td><a name="l457" href="#l457">457</a><td> *     &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);<tr><td><a name="l458" href="#l458">458</a><td> * driver.switchTo().frame(&#39;composeWidget&#39;);<tr><td><a name="l459" href="#l459">459</a><td> * driver.findElement(By.id(&#39;to&#39;)).sendKEys(&#39;dog@example.com&#39;);<tr><td><a name="l460" href="#l460">460</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l461" href="#l461">461</a><td> *<tr><td><a name="l462" href="#l462">462</a><td> * Example #3: Injecting a XMLHttpRequest and waiting for the result. In this<tr><td><a name="l463" href="#l463">463</a><td> * example, the inject script is specified with a function literal. When using<tr><td><a name="l464" href="#l464">464</a><td> * this format, the function is converted to a string for injection, so it<tr><td><a name="l465" href="#l465">465</a><td> * should not reference any symbols not defined in the scope of the page under<tr><td><a name="l466" href="#l466">466</a><td> * test.<tr><td><a name="l467" href="#l467">467</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l468" href="#l468">468</a><td> * driver.executeAsyncScript(function() {<tr><td><a name="l469" href="#l469">469</a><td> *   var callback = arguments[arguments.length - 1];<tr><td><a name="l470" href="#l470">470</a><td> *   var xhr = new XMLHttpRequest();<tr><td><a name="l471" href="#l471">471</a><td> *   xhr.open(&quot;GET&quot;, &quot;/resource/data.json&quot;, true);<tr><td><a name="l472" href="#l472">472</a><td> *   xhr.onreadystatechange = function() {<tr><td><a name="l473" href="#l473">473</a><td> *     if (xhr.readyState == 4) {<tr><td><a name="l474" href="#l474">474</a><td> *       callback(xhr.resposneText);<tr><td><a name="l475" href="#l475">475</a><td> *     }<tr><td><a name="l476" href="#l476">476</a><td> *   }<tr><td><a name="l477" href="#l477">477</a><td> *   xhr.send(&#39;&#39;);<tr><td><a name="l478" href="#l478">478</a><td> * }).then(function(str) {<tr><td><a name="l479" href="#l479">479</a><td> *   console.log(JSON.parse(str)[&#39;food&#39;]);<tr><td><a name="l480" href="#l480">480</a><td> * });<tr><td><a name="l481" href="#l481">481</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l482" href="#l482">482</a><td> *<tr><td><a name="l483" href="#l483">483</a><td> * @param {!(string|Function)} script The script to execute.<tr><td><a name="l484" href="#l484">484</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a name="l485" href="#l485">485</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve to the<tr><td><a name="l486" href="#l486">486</a><td> *    scripts return value.<tr><td><a name="l487" href="#l487">487</a><td> */<tr><td><a name="l488" href="#l488">488</a><td>webdriver.WebDriver.prototype.executeAsyncScript = function(script, var_args) {<tr><td><a name="l489" href="#l489">489</a><td>  if (goog.isFunction(script)) {<tr><td><a name="l490" href="#l490">490</a><td>    script = &#39;return (&#39; + script + &#39;).apply(null, arguments);&#39;;<tr><td><a name="l491" href="#l491">491</a><td>  }<tr><td><a name="l492" href="#l492">492</a><td>  return this.schedule(<tr><td><a name="l493" href="#l493">493</a><td>      new webdriver.Command(webdriver.CommandName.EXECUTE_ASYNC_SCRIPT).<tr><td><a name="l494" href="#l494">494</a><td>          setParameter(&#39;script&#39;, script).<tr><td><a name="l495" href="#l495">495</a><td>          setParameter(&#39;args&#39;, goog.array.slice(arguments, 1)),<tr><td><a name="l496" href="#l496">496</a><td>      &#39;WebDriver.executeScript()&#39;);<tr><td><a name="l497" href="#l497">497</a><td>};<tr><td><a name="l498" href="#l498">498</a><td><tr><td><a name="l499" href="#l499">499</a><td><tr><td><a name="l500" href="#l500">500</a><td>/**<tr><td><a name="l501" href="#l501">501</a><td> * Schedules a command to execute a custom function.<tr><td><a name="l502" href="#l502">502</a><td> * @param {!Function} fn The function to execute.<tr><td><a name="l503" href="#l503">503</a><td> * @param {Object=} opt_scope The object in whose scope to execute the function.<tr><td><a name="l504" href="#l504">504</a><td> * @param {...*} var_args Any arguments to pass to the function.<tr><td><a name="l505" href="#l505">505</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l506" href="#l506">506</a><td> *     function&#39;s result.<tr><td><a name="l507" href="#l507">507</a><td> */<tr><td><a name="l508" href="#l508">508</a><td>webdriver.WebDriver.prototype.call = function(fn, opt_scope, var_args) {<tr><td><a name="l509" href="#l509">509</a><td>  var args = goog.array.slice(arguments, 2);<tr><td><a name="l510" href="#l510">510</a><td>  var flow = this.flow_;<tr><td><a name="l511" href="#l511">511</a><td>  return flow.execute(function() {<tr><td><a name="l512" href="#l512">512</a><td>    return webdriver.promise.fullyResolved(args).then(function(args) {<tr><td><a name="l513" href="#l513">513</a><td>      return fn.apply(opt_scope, args);<tr><td><a name="l514" href="#l514">514</a><td>    });<tr><td><a name="l515" href="#l515">515</a><td>  }, &#39;WebDriver.call(&#39; + (fn.name || &#39;function&#39;) + &#39;)&#39;);<tr><td><a name="l516" href="#l516">516</a><td>};<tr><td><a name="l517" href="#l517">517</a><td><tr><td><a name="l518" href="#l518">518</a><td><tr><td><a name="l519" href="#l519">519</a><td>/**<tr><td><a name="l520" href="#l520">520</a><td> * Schedules a command to wait for a condition to hold, as defined by some<tr><td><a name="l521" href="#l521">521</a><td> * user supplied function. If any errors occur while evaluating the wait, they<tr><td><a name="l522" href="#l522">522</a><td> * will be allowed to propagate.<tr><td><a name="l523" href="#l523">523</a><td> * @param {function():boolean} fn The function to evaluate as a wait condition.<tr><td><a name="l524" href="#l524">524</a><td> * @param {number} timeout How long to wait for the condition to be true.<tr><td><a name="l525" href="#l525">525</a><td> * @param {string=} opt_message An optional message to use if the wait times<tr><td><a name="l526" href="#l526">526</a><td> *     out.<tr><td><a name="l527" href="#l527">527</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l528" href="#l528">528</a><td> *     wait condition has been satisfied.<tr><td><a name="l529" href="#l529">529</a><td> */<tr><td><a name="l530" href="#l530">530</a><td>webdriver.WebDriver.prototype.wait = function(fn, timeout, opt_message) {<tr><td><a name="l531" href="#l531">531</a><td>  return this.flow_.wait(fn, timeout, opt_message);<tr><td><a name="l532" href="#l532">532</a><td>};<tr><td><a name="l533" href="#l533">533</a><td><tr><td><a name="l534" href="#l534">534</a><td><tr><td><a name="l535" href="#l535">535</a><td>/**<tr><td><a name="l536" href="#l536">536</a><td> * Schedules a command to make the driver sleep for the given amount of time.<tr><td><a name="l537" href="#l537">537</a><td> * @param {number} ms The amount of time, in milliseconds, to sleep.<tr><td><a name="l538" href="#l538">538</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l539" href="#l539">539</a><td> *     sleep has finished.<tr><td><a name="l540" href="#l540">540</a><td> */<tr><td><a name="l541" href="#l541">541</a><td>webdriver.WebDriver.prototype.sleep = function(ms) {<tr><td><a name="l542" href="#l542">542</a><td>  return this.flow_.timeout(ms, &#39;WebDriver.sleep(&#39; + ms + &#39;)&#39;);<tr><td><a name="l543" href="#l543">543</a><td>};<tr><td><a name="l544" href="#l544">544</a><td><tr><td><a name="l545" href="#l545">545</a><td><tr><td><a name="l546" href="#l546">546</a><td>/**<tr><td><a name="l547" href="#l547">547</a><td> * Schedules a command to retrieve they current window handle.<tr><td><a name="l548" href="#l548">548</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l549" href="#l549">549</a><td> *     current window handle.<tr><td><a name="l550" href="#l550">550</a><td> */<tr><td><a name="l551" href="#l551">551</a><td>webdriver.WebDriver.prototype.getWindowHandle = function() {<tr><td><a name="l552" href="#l552">552</a><td>  return this.schedule(<tr><td><a name="l553" href="#l553">553</a><td>      new webdriver.Command(webdriver.CommandName.GET_CURRENT_WINDOW_HANDLE),<tr><td><a name="l554" href="#l554">554</a><td>      &#39;WebDriver.getWindowHandle()&#39;);<tr><td><a name="l555" href="#l555">555</a><td>};<tr><td><a name="l556" href="#l556">556</a><td><tr><td><a name="l557" href="#l557">557</a><td><tr><td><a name="l558" href="#l558">558</a><td>/**<tr><td><a name="l559" href="#l559">559</a><td> * Schedules a command to retrieve the current list of available window handles.<tr><td><a name="l560" href="#l560">560</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with an<tr><td><a name="l561" href="#l561">561</a><td> *     array of window handles.<tr><td><a name="l562" href="#l562">562</a><td> */<tr><td><a name="l563" href="#l563">563</a><td>webdriver.WebDriver.prototype.getAllWindowHandles = function() {<tr><td><a name="l564" href="#l564">564</a><td>  return this.schedule(<tr><td><a name="l565" href="#l565">565</a><td>      new webdriver.Command(webdriver.CommandName.GET_WINDOW_HANDLES),<tr><td><a name="l566" href="#l566">566</a><td>      &#39;WebDriver.getAllWindowHandles()&#39;);<tr><td><a name="l567" href="#l567">567</a><td>};<tr><td><a name="l568" href="#l568">568</a><td><tr><td><a name="l569" href="#l569">569</a><td><tr><td><a name="l570" href="#l570">570</a><td>/**<tr><td><a name="l571" href="#l571">571</a><td> * Schedules a command to retrieve the current page&#39;s source. The page source<tr><td><a name="l572" href="#l572">572</a><td> * returned is a representation of the underlying DOM: do not expect it to be<tr><td><a name="l573" href="#l573">573</a><td> * formatted or escaped in the same way as the response sent from the web<tr><td><a name="l574" href="#l574">574</a><td> * server.<tr><td><a name="l575" href="#l575">575</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l576" href="#l576">576</a><td> *     current page source.<tr><td><a name="l577" href="#l577">577</a><td> */<tr><td><a name="l578" href="#l578">578</a><td>webdriver.WebDriver.prototype.getPageSource = function() {<tr><td><a name="l579" href="#l579">579</a><td>  return this.schedule(<tr><td><a name="l580" href="#l580">580</a><td>      new webdriver.Command(webdriver.CommandName.GET_PAGE_SOURCE),<tr><td><a name="l581" href="#l581">581</a><td>      &#39;WebDriver.getAllWindowHandles()&#39;);<tr><td><a name="l582" href="#l582">582</a><td>};<tr><td><a name="l583" href="#l583">583</a><td><tr><td><a name="l584" href="#l584">584</a><td><tr><td><a name="l585" href="#l585">585</a><td>/**<tr><td><a name="l586" href="#l586">586</a><td> * Schedules a command to close the current window.<tr><td><a name="l587" href="#l587">587</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l588" href="#l588">588</a><td> *     this command has completed.<tr><td><a name="l589" href="#l589">589</a><td> */<tr><td><a name="l590" href="#l590">590</a><td>webdriver.WebDriver.prototype.close = function() {<tr><td><a name="l591" href="#l591">591</a><td>  return this.schedule(new webdriver.Command(webdriver.CommandName.CLOSE),<tr><td><a name="l592" href="#l592">592</a><td>                       &#39;WebDriver.close()&#39;);<tr><td><a name="l593" href="#l593">593</a><td>};<tr><td><a name="l594" href="#l594">594</a><td><tr><td><a name="l595" href="#l595">595</a><td><tr><td><a name="l596" href="#l596">596</a><td>/**<tr><td><a name="l597" href="#l597">597</a><td> * Schedules a command to navigate to the given URL.<tr><td><a name="l598" href="#l598">598</a><td> * @param {string} url The fully qualified URL to open.<tr><td><a name="l599" href="#l599">599</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l600" href="#l600">600</a><td> *     document has finished loading.<tr><td><a name="l601" href="#l601">601</a><td> */<tr><td><a name="l602" href="#l602">602</a><td>webdriver.WebDriver.prototype.get = function(url) {<tr><td><a name="l603" href="#l603">603</a><td>  return this.navigate().to(url);<tr><td><a name="l604" href="#l604">604</a><td>};<tr><td><a name="l605" href="#l605">605</a><td><tr><td><a name="l606" href="#l606">606</a><td><tr><td><a name="l607" href="#l607">607</a><td>/**<tr><td><a name="l608" href="#l608">608</a><td> * Schedules a command to retrieve the URL of the current page.<tr><td><a name="l609" href="#l609">609</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l610" href="#l610">610</a><td> *     current URL.<tr><td><a name="l611" href="#l611">611</a><td> */<tr><td><a name="l612" href="#l612">612</a><td>webdriver.WebDriver.prototype.getCurrentUrl = function() {<tr><td><a name="l613" href="#l613">613</a><td>  return this.schedule(<tr><td><a name="l614" href="#l614">614</a><td>      new webdriver.Command(webdriver.CommandName.GET_CURRENT_URL),<tr><td><a name="l615" href="#l615">615</a><td>      &#39;WebDriver.getCurrentUrl()&#39;);<tr><td><a name="l616" href="#l616">616</a><td>};<tr><td><a name="l617" href="#l617">617</a><td><tr><td><a name="l618" href="#l618">618</a><td><tr><td><a name="l619" href="#l619">619</a><td>/**<tr><td><a name="l620" href="#l620">620</a><td> * Schedules a command to retrieve the current page&#39;s title.<tr><td><a name="l621" href="#l621">621</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l622" href="#l622">622</a><td> *     current page&#39;s title.<tr><td><a name="l623" href="#l623">623</a><td> */<tr><td><a name="l624" href="#l624">624</a><td>webdriver.WebDriver.prototype.getTitle = function() {<tr><td><a name="l625" href="#l625">625</a><td>  return this.schedule(new webdriver.Command(webdriver.CommandName.GET_TITLE),<tr><td><a name="l626" href="#l626">626</a><td>                       &#39;WebDriver.getTitle()&#39;);<tr><td><a name="l627" href="#l627">627</a><td>};<tr><td><a name="l628" href="#l628">628</a><td><tr><td><a name="l629" href="#l629">629</a><td><tr><td><a name="l630" href="#l630">630</a><td>/**<tr><td><a name="l631" href="#l631">631</a><td> * Schedule a command to find an element on the page. If the element cannot be<tr><td><a name="l632" href="#l632">632</a><td> * found, a {@link bot.ErrorCode.NO_SUCH_ELEMENT} result will be returned<tr><td><a name="l633" href="#l633">633</a><td> * by the driver. Unlike other commands, this error cannot be suppressed. In<tr><td><a name="l634" href="#l634">634</a><td> * other words, scheduling a command to find an element doubles as an assert<tr><td><a name="l635" href="#l635">635</a><td> * that the element is present on the page. To test whether an element is<tr><td><a name="l636" href="#l636">636</a><td> * present on the page, use {@link #isElementPresent} instead.<tr><td><a name="l637" href="#l637">637</a><td> *<tr><td><a name="l638" href="#l638">638</a><td> * &lt;p&gt;The search criteria for an element may be defined using one of the<tr><td><a name="l639" href="#l639">639</a><td> * factories in the {@link webdriver.By} namespace, or as a short-hand<tr><td><a name="l640" href="#l640">640</a><td> * {@link webdriver.By.Hash} object. For example, the following two statements<tr><td><a name="l641" href="#l641">641</a><td> * are equivalent:<tr><td><a name="l642" href="#l642">642</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l643" href="#l643">643</a><td> * var e1 = driver.findElement(By.id(&#39;foo&#39;));<tr><td><a name="l644" href="#l644">644</a><td> * var e2 = driver.findElement({id:&#39;foo&#39;});<tr><td><a name="l645" href="#l645">645</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l646" href="#l646">646</a><td> *<tr><td><a name="l647" href="#l647">647</a><td> * &lt;p&gt;You may also provide a custom locator function, which takes as input<tr><td><a name="l648" href="#l648">648</a><td> * this WebDriver instance and returns a {@link webdriver.WebElement}, or a<tr><td><a name="l649" href="#l649">649</a><td> * promise that will resolve to a WebElement. For example, to find the first<tr><td><a name="l650" href="#l650">650</a><td> * visible link on a page, you could write:<tr><td><a name="l651" href="#l651">651</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l652" href="#l652">652</a><td> * var link = driver.findElement(firstVisibleLink);<tr><td><a name="l653" href="#l653">653</a><td> *<tr><td><a name="l654" href="#l654">654</a><td> * function firstVisibleLink(driver) {<tr><td><a name="l655" href="#l655">655</a><td> *   var links = driver.findElements(By.tagName(&#39;a&#39;));<tr><td><a name="l656" href="#l656">656</a><td> *   return webdriver.promise.filter(links, function(link) {<tr><td><a name="l657" href="#l657">657</a><td> *     return links.isDisplayed();<tr><td><a name="l658" href="#l658">658</a><td> *   }).then(function(visibleLinks) {<tr><td><a name="l659" href="#l659">659</a><td> *     return visibleLinks[0];<tr><td><a name="l660" href="#l660">660</a><td> *   });<tr><td><a name="l661" href="#l661">661</a><td> * }<tr><td><a name="l662" href="#l662">662</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l663" href="#l663">663</a><td> *<tr><td><a name="l664" href="#l664">664</a><td> * &lt;p&gt;When running in the browser, a WebDriver cannot manipulate DOM elements<tr><td><a name="l665" href="#l665">665</a><td> * directly; it may do so only through a {@link webdriver.WebElement} reference.<tr><td><a name="l666" href="#l666">666</a><td> * This function may be used to generate a WebElement from a DOM element. A<tr><td><a name="l667" href="#l667">667</a><td> * reference to the DOM element will be stored in a known location and this<tr><td><a name="l668" href="#l668">668</a><td> * driver will attempt to retrieve it through {@link #executeScript}. If the<tr><td><a name="l669" href="#l669">669</a><td> * element cannot be found (eg, it belongs to a different document than the<tr><td><a name="l670" href="#l670">670</a><td> * one this instance is currently focused on), a<tr><td><a name="l671" href="#l671">671</a><td> * {@link bot.ErrorCode.NO_SUCH_ELEMENT} error will be returned.<tr><td><a name="l672" href="#l672">672</a><td> *<tr><td><a name="l673" href="#l673">673</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Element|Function)} locator The<tr><td><a name="l674" href="#l674">674</a><td> *     locator to use.<tr><td><a name="l675" href="#l675">675</a><td> * @return {!webdriver.WebElement} A WebElement that can be used to issue<tr><td><a name="l676" href="#l676">676</a><td> *     commands against the located element. If the element is not found, the<tr><td><a name="l677" href="#l677">677</a><td> *     element will be invalidated and all scheduled commands aborted.<tr><td><a name="l678" href="#l678">678</a><td> */<tr><td><a name="l679" href="#l679">679</a><td>webdriver.WebDriver.prototype.findElement = function(locator) {<tr><td><a name="l680" href="#l680">680</a><td>  var id;<tr><td><a name="l681" href="#l681">681</a><td>  if (&#39;nodeType&#39; in locator &amp;&amp; &#39;ownerDocument&#39; in locator) {<tr><td><a name="l682" href="#l682">682</a><td>    var element = /** @type {!Element} */ (locator);<tr><td><a name="l683" href="#l683">683</a><td>    id = this.findDomElement_(element).<tr><td><a name="l684" href="#l684">684</a><td>        then(function(elements) {<tr><td><a name="l685" href="#l685">685</a><td>          if (!elements.length) {<tr><td><a name="l686" href="#l686">686</a><td>            throw new bot.Error(bot.ErrorCode.NO_SUCH_ELEMENT,<tr><td><a name="l687" href="#l687">687</a><td>                &#39;Unable to locate element. Is WebDriver focused on its &#39; +<tr><td><a name="l688" href="#l688">688</a><td>                    &#39;ownerDocument\&#39;s frame?&#39;);<tr><td><a name="l689" href="#l689">689</a><td>          }<tr><td><a name="l690" href="#l690">690</a><td>          return elements[0];<tr><td><a name="l691" href="#l691">691</a><td>        });<tr><td><a name="l692" href="#l692">692</a><td>  } else {<tr><td><a name="l693" href="#l693">693</a><td>    locator = webdriver.Locator.checkLocator(locator);<tr><td><a name="l694" href="#l694">694</a><td>    if (goog.isFunction(locator)) {<tr><td><a name="l695" href="#l695">695</a><td>      id = this.findElementInternal_(locator, this);<tr><td><a name="l696" href="#l696">696</a><td>    } else {<tr><td><a name="l697" href="#l697">697</a><td>      var command = new webdriver.Command(webdriver.CommandName.FIND_ELEMENT).<tr><td><a name="l698" href="#l698">698</a><td>          setParameter(&#39;using&#39;, locator.using).<tr><td><a name="l699" href="#l699">699</a><td>          setParameter(&#39;value&#39;, locator.value);<tr><td><a name="l700" href="#l700">700</a><td>      id = this.schedule(command, &#39;WebDriver.findElement(&#39; + locator + &#39;)&#39;);<tr><td><a name="l701" href="#l701">701</a><td>    }<tr><td><a name="l702" href="#l702">702</a><td>  }<tr><td><a name="l703" href="#l703">703</a><td>  return new webdriver.WebElement(this, id);<tr><td><a name="l704" href="#l704">704</a><td>};<tr><td><a name="l705" href="#l705">705</a><td><tr><td><a name="l706" href="#l706">706</a><td><tr><td><a name="l707" href="#l707">707</a><td>/**<tr><td><a name="l708" href="#l708">708</a><td> * @param {!Function} locatorFn The locator function to use.<tr><td><a name="l709" href="#l709">709</a><td> * @param {!(webdriver.WebDriver|webdriver.WebElement)} context The search<tr><td><a name="l710" href="#l710">710</a><td> *     context.<tr><td><a name="l711" href="#l711">711</a><td> * @return {!webdriver.promise.Promise.&lt;!webdriver.WebElement&gt;} A<tr><td><a name="l712" href="#l712">712</a><td> *     promise that will resolve to a list of WebElements.<tr><td><a name="l713" href="#l713">713</a><td> * @private<tr><td><a name="l714" href="#l714">714</a><td> */<tr><td><a name="l715" href="#l715">715</a><td>webdriver.WebDriver.prototype.findElementInternal_ = function(<tr><td><a name="l716" href="#l716">716</a><td>    locatorFn, context) {<tr><td><a name="l717" href="#l717">717</a><td>  return this.call(goog.partial(locatorFn, context)).then(function(result) {<tr><td><a name="l718" href="#l718">718</a><td>    if (goog.isArray(result)) {<tr><td><a name="l719" href="#l719">719</a><td>      result = result[0];<tr><td><a name="l720" href="#l720">720</a><td>    }<tr><td><a name="l721" href="#l721">721</a><td>    if (!(result instanceof webdriver.WebElement)) {<tr><td><a name="l722" href="#l722">722</a><td>      throw new TypeError(&#39;Custom locator did not return a WebElement&#39;);<tr><td><a name="l723" href="#l723">723</a><td>    }<tr><td><a name="l724" href="#l724">724</a><td>    return result;<tr><td><a name="l725" href="#l725">725</a><td>  });<tr><td><a name="l726" href="#l726">726</a><td>};<tr><td><a name="l727" href="#l727">727</a><td><tr><td><a name="l728" href="#l728">728</a><td><tr><td><a name="l729" href="#l729">729</a><td>/**<tr><td><a name="l730" href="#l730">730</a><td> * Locates a DOM element so that commands may be issued against it using the<tr><td><a name="l731" href="#l731">731</a><td> * {@link webdriver.WebElement} class. This is accomplished by storing a<tr><td><a name="l732" href="#l732">732</a><td> * reference to the element in an object on the element&#39;s ownerDocument.<tr><td><a name="l733" href="#l733">733</a><td> * {@link #executeScript} will then be used to create a WebElement from this<tr><td><a name="l734" href="#l734">734</a><td> * reference. This requires this driver to currently be focused on the<tr><td><a name="l735" href="#l735">735</a><td> * ownerDocument&#39;s window+frame.<tr><td><a name="l736" href="#l736">736</a><td><tr><td><a name="l737" href="#l737">737</a><td> * @param {!Element} element The element to locate.<tr><td><a name="l738" href="#l738">738</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved<tr><td><a name="l739" href="#l739">739</a><td> *     with the located WebElement.<tr><td><a name="l740" href="#l740">740</a><td> * @private<tr><td><a name="l741" href="#l741">741</a><td> */<tr><td><a name="l742" href="#l742">742</a><td>webdriver.WebDriver.prototype.findDomElement_ = function(element) {<tr><td><a name="l743" href="#l743">743</a><td>  var doc = element.ownerDocument;<tr><td><a name="l744" href="#l744">744</a><td>  var store = doc[&#39;$webdriver$&#39;] = doc[&#39;$webdriver$&#39;] || {};<tr><td><a name="l745" href="#l745">745</a><td>  var id = Math.floor(Math.random() * goog.now()).toString(36);<tr><td><a name="l746" href="#l746">746</a><td>  store[id] = element;<tr><td><a name="l747" href="#l747">747</a><td>  element[id] = id;<tr><td><a name="l748" href="#l748">748</a><td><tr><td><a name="l749" href="#l749">749</a><td>  function cleanUp() {<tr><td><a name="l750" href="#l750">750</a><td>    delete store[id];<tr><td><a name="l751" href="#l751">751</a><td>  }<tr><td><a name="l752" href="#l752">752</a><td><tr><td><a name="l753" href="#l753">753</a><td>  function lookupElement(id) {<tr><td><a name="l754" href="#l754">754</a><td>    var store = document[&#39;$webdriver$&#39;];<tr><td><a name="l755" href="#l755">755</a><td>    if (!store) {<tr><td><a name="l756" href="#l756">756</a><td>      return null;<tr><td><a name="l757" href="#l757">757</a><td>    }<tr><td><a name="l758" href="#l758">758</a><td><tr><td><a name="l759" href="#l759">759</a><td>    var element = store[id];<tr><td><a name="l760" href="#l760">760</a><td>    if (!element || element[id] !== id) {<tr><td><a name="l761" href="#l761">761</a><td>      return [];<tr><td><a name="l762" href="#l762">762</a><td>    }<tr><td><a name="l763" href="#l763">763</a><td>    return [element];<tr><td><a name="l764" href="#l764">764</a><td>  }<tr><td><a name="l765" href="#l765">765</a><td><tr><td><a name="l766" href="#l766">766</a><td>  return this.executeScript(lookupElement, id).<tr><td><a name="l767" href="#l767">767</a><td>      then(function(value) {<tr><td><a name="l768" href="#l768">768</a><td>        cleanUp();<tr><td><a name="l769" href="#l769">769</a><td>        if (value.length &amp;&amp; !(value[0] instanceof webdriver.WebElement)) {<tr><td><a name="l770" href="#l770">770</a><td>          throw new Error(&#39;JS locator script result was not a WebElement&#39;);<tr><td><a name="l771" href="#l771">771</a><td>        }<tr><td><a name="l772" href="#l772">772</a><td>        return value;<tr><td><a name="l773" href="#l773">773</a><td>      }, cleanUp);<tr><td><a name="l774" href="#l774">774</a><td>};<tr><td><a name="l775" href="#l775">775</a><td><tr><td><a name="l776" href="#l776">776</a><td><tr><td><a name="l777" href="#l777">777</a><td>/**<tr><td><a name="l778" href="#l778">778</a><td> * Schedules a command to test if an element is present on the page.<tr><td><a name="l779" href="#l779">779</a><td> *<tr><td><a name="l780" href="#l780">780</a><td> * &lt;p&gt;If given a DOM element, this function will check if it belongs to the<tr><td><a name="l781" href="#l781">781</a><td> * document the driver is currently focused on. Otherwise, the function will<tr><td><a name="l782" href="#l782">782</a><td> * test if at least one element can be found with the given search criteria.<tr><td><a name="l783" href="#l783">783</a><td> *<tr><td><a name="l784" href="#l784">784</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Element|<tr><td><a name="l785" href="#l785">785</a><td> *           Function)} locatorOrElement The locator to use, or the actual<tr><td><a name="l786" href="#l786">786</a><td> *     DOM element to be located by the server.<tr><td><a name="l787" href="#l787">787</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will resolve<tr><td><a name="l788" href="#l788">788</a><td> *     with whether the element is present on the page.<tr><td><a name="l789" href="#l789">789</a><td> */<tr><td><a name="l790" href="#l790">790</a><td>webdriver.WebDriver.prototype.isElementPresent = function(locatorOrElement) {<tr><td><a name="l791" href="#l791">791</a><td>  var findElement =<tr><td><a name="l792" href="#l792">792</a><td>      (&#39;nodeType&#39; in locatorOrElement &amp;&amp; &#39;ownerDocument&#39; in locatorOrElement) ?<tr><td><a name="l793" href="#l793">793</a><td>          this.findDomElement_(/** @type {!Element} */ (locatorOrElement)) :<tr><td><a name="l794" href="#l794">794</a><td>          this.findElements.apply(this, arguments);<tr><td><a name="l795" href="#l795">795</a><td>  return findElement.then(function(result) {<tr><td><a name="l796" href="#l796">796</a><td>    return !!result.length;<tr><td><a name="l797" href="#l797">797</a><td>  });<tr><td><a name="l798" href="#l798">798</a><td>};<tr><td><a name="l799" href="#l799">799</a><td><tr><td><a name="l800" href="#l800">800</a><td><tr><td><a name="l801" href="#l801">801</a><td>/**<tr><td><a name="l802" href="#l802">802</a><td> * Schedule a command to search for multiple elements on the page.<tr><td><a name="l803" href="#l803">803</a><td> *<tr><td><a name="l804" href="#l804">804</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The locator<tr><td><a name="l805" href="#l805">805</a><td> *     strategy to use when searching for the element.<tr><td><a name="l806" href="#l806">806</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.WebElement&gt;&gt;} A<tr><td><a name="l807" href="#l807">807</a><td> *     promise that will resolve to an array of WebElements.<tr><td><a name="l808" href="#l808">808</a><td> */<tr><td><a name="l809" href="#l809">809</a><td>webdriver.WebDriver.prototype.findElements = function(locator) {<tr><td><a name="l810" href="#l810">810</a><td>  locator = webdriver.Locator.checkLocator(locator);<tr><td><a name="l811" href="#l811">811</a><td>  if (goog.isFunction(locator)) {<tr><td><a name="l812" href="#l812">812</a><td>    return this.findElementsInternal_(locator, this);<tr><td><a name="l813" href="#l813">813</a><td>  } else {<tr><td><a name="l814" href="#l814">814</a><td>    var command = new webdriver.Command(webdriver.CommandName.FIND_ELEMENTS).<tr><td><a name="l815" href="#l815">815</a><td>        setParameter(&#39;using&#39;, locator.using).<tr><td><a name="l816" href="#l816">816</a><td>        setParameter(&#39;value&#39;, locator.value);<tr><td><a name="l817" href="#l817">817</a><td>    return this.schedule(command, &#39;WebDriver.findElements(&#39; + locator + &#39;)&#39;);<tr><td><a name="l818" href="#l818">818</a><td>  }<tr><td><a name="l819" href="#l819">819</a><td>};<tr><td><a name="l820" href="#l820">820</a><td><tr><td><a name="l821" href="#l821">821</a><td><tr><td><a name="l822" href="#l822">822</a><td>/**<tr><td><a name="l823" href="#l823">823</a><td> * @param {!Function} locatorFn The locator function to use.<tr><td><a name="l824" href="#l824">824</a><td> * @param {!(webdriver.WebDriver|webdriver.WebElement)} context The search<tr><td><a name="l825" href="#l825">825</a><td> *     context.<tr><td><a name="l826" href="#l826">826</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.WebElement&gt;&gt;} A<tr><td><a name="l827" href="#l827">827</a><td> *     promise that will resolve to an array of WebElements.<tr><td><a name="l828" href="#l828">828</a><td> * @private<tr><td><a name="l829" href="#l829">829</a><td> */<tr><td><a name="l830" href="#l830">830</a><td>webdriver.WebDriver.prototype.findElementsInternal_ = function(<tr><td><a name="l831" href="#l831">831</a><td>    locatorFn, context) {<tr><td><a name="l832" href="#l832">832</a><td>  return this.call(goog.partial(locatorFn, context)).then(function(result) {<tr><td><a name="l833" href="#l833">833</a><td>    if (result instanceof webdriver.WebElement) {<tr><td><a name="l834" href="#l834">834</a><td>      return [result];<tr><td><a name="l835" href="#l835">835</a><td>    }<tr><td><a name="l836" href="#l836">836</a><td><tr><td><a name="l837" href="#l837">837</a><td>    if (!goog.isArray(result)) {<tr><td><a name="l838" href="#l838">838</a><td>      return [];<tr><td><a name="l839" href="#l839">839</a><td>    }<tr><td><a name="l840" href="#l840">840</a><td><tr><td><a name="l841" href="#l841">841</a><td>    return goog.array.filter(result, function(item) {<tr><td><a name="l842" href="#l842">842</a><td>      return item instanceof webdriver.WebElement;<tr><td><a name="l843" href="#l843">843</a><td>    });<tr><td><a name="l844" href="#l844">844</a><td>  });<tr><td><a name="l845" href="#l845">845</a><td>};<tr><td><a name="l846" href="#l846">846</a><td><tr><td><a name="l847" href="#l847">847</a><td><tr><td><a name="l848" href="#l848">848</a><td>/**<tr><td><a name="l849" href="#l849">849</a><td> * Schedule a command to take a screenshot. The driver makes a best effort to<tr><td><a name="l850" href="#l850">850</a><td> * return a screenshot of the following, in order of preference:<tr><td><a name="l851" href="#l851">851</a><td> * &lt;ol&gt;<tr><td><a name="l852" href="#l852">852</a><td> *   &lt;li&gt;Entire page<tr><td><a name="l853" href="#l853">853</a><td> *   &lt;li&gt;Current window<tr><td><a name="l854" href="#l854">854</a><td> *   &lt;li&gt;Visible portion of the current frame<tr><td><a name="l855" href="#l855">855</a><td> *   &lt;li&gt;The screenshot of the entire display containing the browser<tr><td><a name="l856" href="#l856">856</a><td> * &lt;/ol&gt;<tr><td><a name="l857" href="#l857">857</a><td> *<tr><td><a name="l858" href="#l858">858</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved to the<tr><td><a name="l859" href="#l859">859</a><td> *     screenshot as a base-64 encoded PNG.<tr><td><a name="l860" href="#l860">860</a><td> */<tr><td><a name="l861" href="#l861">861</a><td>webdriver.WebDriver.prototype.takeScreenshot = function() {<tr><td><a name="l862" href="#l862">862</a><td>  return this.schedule(new webdriver.Command(webdriver.CommandName.SCREENSHOT),<tr><td><a name="l863" href="#l863">863</a><td>      &#39;WebDriver.takeScreenshot()&#39;);<tr><td><a name="l864" href="#l864">864</a><td>};<tr><td><a name="l865" href="#l865">865</a><td><tr><td><a name="l866" href="#l866">866</a><td><tr><td><a name="l867" href="#l867">867</a><td>/**<tr><td><a name="l868" href="#l868">868</a><td> * @return {!webdriver.WebDriver.Options} The options interface for this<tr><td><a name="l869" href="#l869">869</a><td> *     instance.<tr><td><a name="l870" href="#l870">870</a><td> */<tr><td><a name="l871" href="#l871">871</a><td>webdriver.WebDriver.prototype.manage = function() {<tr><td><a name="l872" href="#l872">872</a><td>  return new webdriver.WebDriver.Options(this);<tr><td><a name="l873" href="#l873">873</a><td>};<tr><td><a name="l874" href="#l874">874</a><td><tr><td><a name="l875" href="#l875">875</a><td><tr><td><a name="l876" href="#l876">876</a><td>/**<tr><td><a name="l877" href="#l877">877</a><td> * @return {!webdriver.WebDriver.Navigation} The navigation interface for this<tr><td><a name="l878" href="#l878">878</a><td> *     instance.<tr><td><a name="l879" href="#l879">879</a><td> */<tr><td><a name="l880" href="#l880">880</a><td>webdriver.WebDriver.prototype.navigate = function() {<tr><td><a name="l881" href="#l881">881</a><td>  return new webdriver.WebDriver.Navigation(this);<tr><td><a name="l882" href="#l882">882</a><td>};<tr><td><a name="l883" href="#l883">883</a><td><tr><td><a name="l884" href="#l884">884</a><td><tr><td><a name="l885" href="#l885">885</a><td>/**<tr><td><a name="l886" href="#l886">886</a><td> * @return {!webdriver.WebDriver.TargetLocator} The target locator interface for<tr><td><a name="l887" href="#l887">887</a><td> *     this instance.<tr><td><a name="l888" href="#l888">888</a><td> */<tr><td><a name="l889" href="#l889">889</a><td>webdriver.WebDriver.prototype.switchTo = function() {<tr><td><a name="l890" href="#l890">890</a><td>  return new webdriver.WebDriver.TargetLocator(this);<tr><td><a name="l891" href="#l891">891</a><td>};<tr><td><a name="l892" href="#l892">892</a><td><tr><td><a name="l893" href="#l893">893</a><td><tr><td><a name="l894" href="#l894">894</a><td><tr><td><a name="l895" href="#l895">895</a><td>/**<tr><td><a name="l896" href="#l896">896</a><td> * Interface for navigating back and forth in the browser history.<tr><td><a name="l897" href="#l897">897</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a name="l898" href="#l898">898</a><td> * @constructor<tr><td><a name="l899" href="#l899">899</a><td> */<tr><td><a name="l900" href="#l900">900</a><td>webdriver.WebDriver.Navigation = function(driver) {<tr><td><a name="l901" href="#l901">901</a><td><tr><td><a name="l902" href="#l902">902</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a name="l903" href="#l903">903</a><td>  this.driver_ = driver;<tr><td><a name="l904" href="#l904">904</a><td>};<tr><td><a name="l905" href="#l905">905</a><td><tr><td><a name="l906" href="#l906">906</a><td><tr><td><a name="l907" href="#l907">907</a><td>/**<tr><td><a name="l908" href="#l908">908</a><td> * Schedules a command to navigate to a new URL.<tr><td><a name="l909" href="#l909">909</a><td> * @param {string} url The URL to navigate to.<tr><td><a name="l910" href="#l910">910</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l911" href="#l911">911</a><td> *     URL has been loaded.<tr><td><a name="l912" href="#l912">912</a><td> */<tr><td><a name="l913" href="#l913">913</a><td>webdriver.WebDriver.Navigation.prototype.to = function(url) {<tr><td><a name="l914" href="#l914">914</a><td>  return this.driver_.schedule(<tr><td><a name="l915" href="#l915">915</a><td>      new webdriver.Command(webdriver.CommandName.GET).<tr><td><a name="l916" href="#l916">916</a><td>          setParameter(&#39;url&#39;, url),<tr><td><a name="l917" href="#l917">917</a><td>      &#39;WebDriver.navigate().to(&#39; + url + &#39;)&#39;);<tr><td><a name="l918" href="#l918">918</a><td>};<tr><td><a name="l919" href="#l919">919</a><td><tr><td><a name="l920" href="#l920">920</a><td><tr><td><a name="l921" href="#l921">921</a><td>/**<tr><td><a name="l922" href="#l922">922</a><td> * Schedules a command to move backwards in the browser history.<tr><td><a name="l923" href="#l923">923</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l924" href="#l924">924</a><td> *     navigation event has completed.<tr><td><a name="l925" href="#l925">925</a><td> */<tr><td><a name="l926" href="#l926">926</a><td>webdriver.WebDriver.Navigation.prototype.back = function() {<tr><td><a name="l927" href="#l927">927</a><td>  return this.driver_.schedule(<tr><td><a name="l928" href="#l928">928</a><td>      new webdriver.Command(webdriver.CommandName.GO_BACK),<tr><td><a name="l929" href="#l929">929</a><td>      &#39;WebDriver.navigate().back()&#39;);<tr><td><a name="l930" href="#l930">930</a><td>};<tr><td><a name="l931" href="#l931">931</a><td><tr><td><a name="l932" href="#l932">932</a><td><tr><td><a name="l933" href="#l933">933</a><td>/**<tr><td><a name="l934" href="#l934">934</a><td> * Schedules a command to move forwards in the browser history.<tr><td><a name="l935" href="#l935">935</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l936" href="#l936">936</a><td> *     navigation event has completed.<tr><td><a name="l937" href="#l937">937</a><td> */<tr><td><a name="l938" href="#l938">938</a><td>webdriver.WebDriver.Navigation.prototype.forward = function() {<tr><td><a name="l939" href="#l939">939</a><td>  return this.driver_.schedule(<tr><td><a name="l940" href="#l940">940</a><td>      new webdriver.Command(webdriver.CommandName.GO_FORWARD),<tr><td><a name="l941" href="#l941">941</a><td>      &#39;WebDriver.navigate().forward()&#39;);<tr><td><a name="l942" href="#l942">942</a><td>};<tr><td><a name="l943" href="#l943">943</a><td><tr><td><a name="l944" href="#l944">944</a><td><tr><td><a name="l945" href="#l945">945</a><td>/**<tr><td><a name="l946" href="#l946">946</a><td> * Schedules a command to refresh the current page.<tr><td><a name="l947" href="#l947">947</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l948" href="#l948">948</a><td> *     navigation event has completed.<tr><td><a name="l949" href="#l949">949</a><td> */<tr><td><a name="l950" href="#l950">950</a><td>webdriver.WebDriver.Navigation.prototype.refresh = function() {<tr><td><a name="l951" href="#l951">951</a><td>  return this.driver_.schedule(<tr><td><a name="l952" href="#l952">952</a><td>      new webdriver.Command(webdriver.CommandName.REFRESH),<tr><td><a name="l953" href="#l953">953</a><td>      &#39;WebDriver.navigate().refresh()&#39;);<tr><td><a name="l954" href="#l954">954</a><td>};<tr><td><a name="l955" href="#l955">955</a><td><tr><td><a name="l956" href="#l956">956</a><td><tr><td><a name="l957" href="#l957">957</a><td><tr><td><a name="l958" href="#l958">958</a><td>/**<tr><td><a name="l959" href="#l959">959</a><td> * Provides methods for managing browser and driver state.<tr><td><a name="l960" href="#l960">960</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a name="l961" href="#l961">961</a><td> * @constructor<tr><td><a name="l962" href="#l962">962</a><td> */<tr><td><a name="l963" href="#l963">963</a><td>webdriver.WebDriver.Options = function(driver) {<tr><td><a name="l964" href="#l964">964</a><td><tr><td><a name="l965" href="#l965">965</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a name="l966" href="#l966">966</a><td>  this.driver_ = driver;<tr><td><a name="l967" href="#l967">967</a><td>};<tr><td><a name="l968" href="#l968">968</a><td><tr><td><a name="l969" href="#l969">969</a><td><tr><td><a name="l970" href="#l970">970</a><td>/**<tr><td><a name="l971" href="#l971">971</a><td> * Schedules a command to add a cookie.<tr><td><a name="l972" href="#l972">972</a><td> * @param {string} name The cookie name.<tr><td><a name="l973" href="#l973">973</a><td> * @param {string} value The cookie value.<tr><td><a name="l974" href="#l974">974</a><td> * @param {string=} opt_path The cookie path.<tr><td><a name="l975" href="#l975">975</a><td> * @param {string=} opt_domain The cookie domain.<tr><td><a name="l976" href="#l976">976</a><td> * @param {boolean=} opt_isSecure Whether the cookie is secure.<tr><td><a name="l977" href="#l977">977</a><td> * @param {(number|!Date)=} opt_expiry When the cookie expires. If specified as<tr><td><a name="l978" href="#l978">978</a><td> *     a number, should be in milliseconds since midnight, January 1, 1970 UTC.<tr><td><a name="l979" href="#l979">979</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l980" href="#l980">980</a><td> *     cookie has been added to the page.<tr><td><a name="l981" href="#l981">981</a><td> */<tr><td><a name="l982" href="#l982">982</a><td>webdriver.WebDriver.Options.prototype.addCookie = function(<tr><td><a name="l983" href="#l983">983</a><td>    name, value, opt_path, opt_domain, opt_isSecure, opt_expiry) {<tr><td><a name="l984" href="#l984">984</a><td>  // We do not allow &#39;=&#39; or &#39;;&#39; in the name.<tr><td><a name="l985" href="#l985">985</a><td>  if (/[;=]/.test(name)) {<tr><td><a name="l986" href="#l986">986</a><td>    throw Error(&#39;Invalid cookie name &quot;&#39; + name + &#39;&quot;&#39;);<tr><td><a name="l987" href="#l987">987</a><td>  }<tr><td><a name="l988" href="#l988">988</a><td><tr><td><a name="l989" href="#l989">989</a><td>  // We do not allow &#39;;&#39; in value.<tr><td><a name="l990" href="#l990">990</a><td>  if (/;/.test(value)) {<tr><td><a name="l991" href="#l991">991</a><td>    throw Error(&#39;Invalid cookie value &quot;&#39; + value + &#39;&quot;&#39;);<tr><td><a name="l992" href="#l992">992</a><td>  }<tr><td><a name="l993" href="#l993">993</a><td><tr><td><a name="l994" href="#l994">994</a><td>  var cookieString = name + &#39;=&#39; + value +<tr><td><a name="l995" href="#l995">995</a><td>      (opt_domain ? &#39;;domain=&#39; + opt_domain : &#39;&#39;) +<tr><td><a name="l996" href="#l996">996</a><td>      (opt_path ? &#39;;path=&#39; + opt_path : &#39;&#39;) +<tr><td><a name="l997" href="#l997">997</a><td>      (opt_isSecure ? &#39;;secure&#39; : &#39;&#39;);<tr><td><a name="l998" href="#l998">998</a><td><tr><td><a name="l999" href="#l999">999</a><td>  var expiry;<tr><td><a name="l1000" href="#l1000">1000</a><td>  if (goog.isDef(opt_expiry)) {<tr><td><a name="l1001" href="#l1001">1001</a><td>    var expiryDate;<tr><td><a name="l1002" href="#l1002">1002</a><td>    if (goog.isNumber(opt_expiry)) {<tr><td><a name="l1003" href="#l1003">1003</a><td>      expiryDate = new Date(opt_expiry);<tr><td><a name="l1004" href="#l1004">1004</a><td>    } else {<tr><td><a name="l1005" href="#l1005">1005</a><td>      expiryDate = /** @type {!Date} */ (opt_expiry);<tr><td><a name="l1006" href="#l1006">1006</a><td>      opt_expiry = expiryDate.getTime();<tr><td><a name="l1007" href="#l1007">1007</a><td>    }<tr><td><a name="l1008" href="#l1008">1008</a><td>    cookieString += &#39;;expires=&#39; + expiryDate.toUTCString();<tr><td><a name="l1009" href="#l1009">1009</a><td>    // Convert from milliseconds to seconds.<tr><td><a name="l1010" href="#l1010">1010</a><td>    expiry = Math.floor(/** @type {number} */ (opt_expiry) / 1000);<tr><td><a name="l1011" href="#l1011">1011</a><td>  }<tr><td><a name="l1012" href="#l1012">1012</a><td><tr><td><a name="l1013" href="#l1013">1013</a><td>  return this.driver_.schedule(<tr><td><a name="l1014" href="#l1014">1014</a><td>      new webdriver.Command(webdriver.CommandName.ADD_COOKIE).<tr><td><a name="l1015" href="#l1015">1015</a><td>          setParameter(&#39;cookie&#39;, {<tr><td><a name="l1016" href="#l1016">1016</a><td>            &#39;name&#39;: name,<tr><td><a name="l1017" href="#l1017">1017</a><td>            &#39;value&#39;: value,<tr><td><a name="l1018" href="#l1018">1018</a><td>            &#39;path&#39;: opt_path,<tr><td><a name="l1019" href="#l1019">1019</a><td>            &#39;domain&#39;: opt_domain,<tr><td><a name="l1020" href="#l1020">1020</a><td>            &#39;secure&#39;: !!opt_isSecure,<tr><td><a name="l1021" href="#l1021">1021</a><td>            &#39;expiry&#39;: expiry<tr><td><a name="l1022" href="#l1022">1022</a><td>          }),<tr><td><a name="l1023" href="#l1023">1023</a><td>      &#39;WebDriver.manage().addCookie(&#39; + cookieString + &#39;)&#39;);<tr><td><a name="l1024" href="#l1024">1024</a><td>};<tr><td><a name="l1025" href="#l1025">1025</a><td><tr><td><a name="l1026" href="#l1026">1026</a><td><tr><td><a name="l1027" href="#l1027">1027</a><td>/**<tr><td><a name="l1028" href="#l1028">1028</a><td> * Schedules a command to delete all cookies visible to the current page.<tr><td><a name="l1029" href="#l1029">1029</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when all<tr><td><a name="l1030" href="#l1030">1030</a><td> *     cookies have been deleted.<tr><td><a name="l1031" href="#l1031">1031</a><td> */<tr><td><a name="l1032" href="#l1032">1032</a><td>webdriver.WebDriver.Options.prototype.deleteAllCookies = function() {<tr><td><a name="l1033" href="#l1033">1033</a><td>  return this.driver_.schedule(<tr><td><a name="l1034" href="#l1034">1034</a><td>      new webdriver.Command(webdriver.CommandName.DELETE_ALL_COOKIES),<tr><td><a name="l1035" href="#l1035">1035</a><td>      &#39;WebDriver.manage().deleteAllCookies()&#39;);<tr><td><a name="l1036" href="#l1036">1036</a><td>};<tr><td><a name="l1037" href="#l1037">1037</a><td><tr><td><a name="l1038" href="#l1038">1038</a><td><tr><td><a name="l1039" href="#l1039">1039</a><td>/**<tr><td><a name="l1040" href="#l1040">1040</a><td> * Schedules a command to delete the cookie with the given name. This command is<tr><td><a name="l1041" href="#l1041">1041</a><td> * a no-op if there is no cookie with the given name visible to the current<tr><td><a name="l1042" href="#l1042">1042</a><td> * page.<tr><td><a name="l1043" href="#l1043">1043</a><td> * @param {string} name The name of the cookie to delete.<tr><td><a name="l1044" href="#l1044">1044</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1045" href="#l1045">1045</a><td> *     cookie has been deleted.<tr><td><a name="l1046" href="#l1046">1046</a><td> */<tr><td><a name="l1047" href="#l1047">1047</a><td>webdriver.WebDriver.Options.prototype.deleteCookie = function(name) {<tr><td><a name="l1048" href="#l1048">1048</a><td>  return this.driver_.schedule(<tr><td><a name="l1049" href="#l1049">1049</a><td>      new webdriver.Command(webdriver.CommandName.DELETE_COOKIE).<tr><td><a name="l1050" href="#l1050">1050</a><td>          setParameter(&#39;name&#39;, name),<tr><td><a name="l1051" href="#l1051">1051</a><td>      &#39;WebDriver.manage().deleteCookie(&#39; + name + &#39;)&#39;);<tr><td><a name="l1052" href="#l1052">1052</a><td>};<tr><td><a name="l1053" href="#l1053">1053</a><td><tr><td><a name="l1054" href="#l1054">1054</a><td><tr><td><a name="l1055" href="#l1055">1055</a><td>/**<tr><td><a name="l1056" href="#l1056">1056</a><td> * Schedules a command to retrieve all cookies visible to the current page.<tr><td><a name="l1057" href="#l1057">1057</a><td> * Each cookie will be returned as a JSON object as described by the WebDriver<tr><td><a name="l1058" href="#l1058">1058</a><td> * wire protocol.<tr><td><a name="l1059" href="#l1059">1059</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1060" href="#l1060">1060</a><td> *     cookies visible to the current page.<tr><td><a name="l1061" href="#l1061">1061</a><td> * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object<tr><td><a name="l1062" href="#l1062">1062</a><td> */<tr><td><a name="l1063" href="#l1063">1063</a><td>webdriver.WebDriver.Options.prototype.getCookies = function() {<tr><td><a name="l1064" href="#l1064">1064</a><td>  return this.driver_.schedule(<tr><td><a name="l1065" href="#l1065">1065</a><td>      new webdriver.Command(webdriver.CommandName.GET_ALL_COOKIES),<tr><td><a name="l1066" href="#l1066">1066</a><td>      &#39;WebDriver.manage().getCookies()&#39;);<tr><td><a name="l1067" href="#l1067">1067</a><td>};<tr><td><a name="l1068" href="#l1068">1068</a><td><tr><td><a name="l1069" href="#l1069">1069</a><td><tr><td><a name="l1070" href="#l1070">1070</a><td>/**<tr><td><a name="l1071" href="#l1071">1071</a><td> * Schedules a command to retrieve the cookie with the given name. Returns null<tr><td><a name="l1072" href="#l1072">1072</a><td> * if there is no such cookie. The cookie will be returned as a JSON object as<tr><td><a name="l1073" href="#l1073">1073</a><td> * described by the WebDriver wire protocol.<tr><td><a name="l1074" href="#l1074">1074</a><td> * @param {string} name The name of the cookie to retrieve.<tr><td><a name="l1075" href="#l1075">1075</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1076" href="#l1076">1076</a><td> *     named cookie, or {@code null} if there is no such cookie.<tr><td><a name="l1077" href="#l1077">1077</a><td> * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object<tr><td><a name="l1078" href="#l1078">1078</a><td> */<tr><td><a name="l1079" href="#l1079">1079</a><td>webdriver.WebDriver.Options.prototype.getCookie = function(name) {<tr><td><a name="l1080" href="#l1080">1080</a><td>  return this.getCookies().then(function(cookies) {<tr><td><a name="l1081" href="#l1081">1081</a><td>    return goog.array.find(cookies, function(cookie) {<tr><td><a name="l1082" href="#l1082">1082</a><td>      return cookie &amp;&amp; cookie[&#39;name&#39;] == name;<tr><td><a name="l1083" href="#l1083">1083</a><td>    });<tr><td><a name="l1084" href="#l1084">1084</a><td>  });<tr><td><a name="l1085" href="#l1085">1085</a><td>};<tr><td><a name="l1086" href="#l1086">1086</a><td><tr><td><a name="l1087" href="#l1087">1087</a><td><tr><td><a name="l1088" href="#l1088">1088</a><td>/**<tr><td><a name="l1089" href="#l1089">1089</a><td> * @return {!webdriver.WebDriver.Logs} The interface for managing driver<tr><td><a name="l1090" href="#l1090">1090</a><td> *     logs.<tr><td><a name="l1091" href="#l1091">1091</a><td> */<tr><td><a name="l1092" href="#l1092">1092</a><td>webdriver.WebDriver.Options.prototype.logs = function() {<tr><td><a name="l1093" href="#l1093">1093</a><td>  return new webdriver.WebDriver.Logs(this.driver_);<tr><td><a name="l1094" href="#l1094">1094</a><td>};<tr><td><a name="l1095" href="#l1095">1095</a><td><tr><td><a name="l1096" href="#l1096">1096</a><td><tr><td><a name="l1097" href="#l1097">1097</a><td>/**<tr><td><a name="l1098" href="#l1098">1098</a><td> * @return {!webdriver.WebDriver.Timeouts} The interface for managing driver<tr><td><a name="l1099" href="#l1099">1099</a><td> *     timeouts.<tr><td><a name="l1100" href="#l1100">1100</a><td> */<tr><td><a name="l1101" href="#l1101">1101</a><td>webdriver.WebDriver.Options.prototype.timeouts = function() {<tr><td><a name="l1102" href="#l1102">1102</a><td>  return new webdriver.WebDriver.Timeouts(this.driver_);<tr><td><a name="l1103" href="#l1103">1103</a><td>};<tr><td><a name="l1104" href="#l1104">1104</a><td><tr><td><a name="l1105" href="#l1105">1105</a><td><tr><td><a name="l1106" href="#l1106">1106</a><td>/**<tr><td><a name="l1107" href="#l1107">1107</a><td> * @return {!webdriver.WebDriver.Window} The interface for managing the<tr><td><a name="l1108" href="#l1108">1108</a><td> *     current window.<tr><td><a name="l1109" href="#l1109">1109</a><td> */<tr><td><a name="l1110" href="#l1110">1110</a><td>webdriver.WebDriver.Options.prototype.window = function() {<tr><td><a name="l1111" href="#l1111">1111</a><td>  return new webdriver.WebDriver.Window(this.driver_);<tr><td><a name="l1112" href="#l1112">1112</a><td>};<tr><td><a name="l1113" href="#l1113">1113</a><td><tr><td><a name="l1114" href="#l1114">1114</a><td><tr><td><a name="l1115" href="#l1115">1115</a><td><tr><td><a name="l1116" href="#l1116">1116</a><td>/**<tr><td><a name="l1117" href="#l1117">1117</a><td> * An interface for managing timeout behavior for WebDriver instances.<tr><td><a name="l1118" href="#l1118">1118</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a name="l1119" href="#l1119">1119</a><td> * @constructor<tr><td><a name="l1120" href="#l1120">1120</a><td> */<tr><td><a name="l1121" href="#l1121">1121</a><td>webdriver.WebDriver.Timeouts = function(driver) {<tr><td><a name="l1122" href="#l1122">1122</a><td><tr><td><a name="l1123" href="#l1123">1123</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a name="l1124" href="#l1124">1124</a><td>  this.driver_ = driver;<tr><td><a name="l1125" href="#l1125">1125</a><td>};<tr><td><a name="l1126" href="#l1126">1126</a><td><tr><td><a name="l1127" href="#l1127">1127</a><td><tr><td><a name="l1128" href="#l1128">1128</a><td>/**<tr><td><a name="l1129" href="#l1129">1129</a><td> * Specifies the amount of time the driver should wait when searching for an<tr><td><a name="l1130" href="#l1130">1130</a><td> * element if it is not immediately present.<tr><td><a name="l1131" href="#l1131">1131</a><td> * &lt;p/&gt;<tr><td><a name="l1132" href="#l1132">1132</a><td> * When searching for a single element, the driver should poll the page<tr><td><a name="l1133" href="#l1133">1133</a><td> * until the element has been found, or this timeout expires before failing<tr><td><a name="l1134" href="#l1134">1134</a><td> * with a {@code bot.ErrorCode.NO_SUCH_ELEMENT} error. When searching<tr><td><a name="l1135" href="#l1135">1135</a><td> * for multiple elements, the driver should poll the page until at least one<tr><td><a name="l1136" href="#l1136">1136</a><td> * element has been found or this timeout has expired.<tr><td><a name="l1137" href="#l1137">1137</a><td> * &lt;p/&gt;<tr><td><a name="l1138" href="#l1138">1138</a><td> * Setting the wait timeout to 0 (its default value), disables implicit<tr><td><a name="l1139" href="#l1139">1139</a><td> * waiting.<tr><td><a name="l1140" href="#l1140">1140</a><td> * &lt;p/&gt;<tr><td><a name="l1141" href="#l1141">1141</a><td> * Increasing the implicit wait timeout should be used judiciously as it<tr><td><a name="l1142" href="#l1142">1142</a><td> * will have an adverse effect on test run time, especially when used with<tr><td><a name="l1143" href="#l1143">1143</a><td> * slower location strategies like XPath.<tr><td><a name="l1144" href="#l1144">1144</a><td> *<tr><td><a name="l1145" href="#l1145">1145</a><td> * @param {number} ms The amount of time to wait, in milliseconds.<tr><td><a name="l1146" href="#l1146">1146</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1147" href="#l1147">1147</a><td> *     implicit wait timeout has been set.<tr><td><a name="l1148" href="#l1148">1148</a><td> */<tr><td><a name="l1149" href="#l1149">1149</a><td>webdriver.WebDriver.Timeouts.prototype.implicitlyWait = function(ms) {<tr><td><a name="l1150" href="#l1150">1150</a><td>  return this.driver_.schedule(<tr><td><a name="l1151" href="#l1151">1151</a><td>      new webdriver.Command(webdriver.CommandName.IMPLICITLY_WAIT).<tr><td><a name="l1152" href="#l1152">1152</a><td>          setParameter(&#39;ms&#39;, ms &lt; 0 ? 0 : ms),<tr><td><a name="l1153" href="#l1153">1153</a><td>      &#39;WebDriver.manage().timeouts().implicitlyWait(&#39; + ms + &#39;)&#39;);<tr><td><a name="l1154" href="#l1154">1154</a><td>};<tr><td><a name="l1155" href="#l1155">1155</a><td><tr><td><a name="l1156" href="#l1156">1156</a><td><tr><td><a name="l1157" href="#l1157">1157</a><td>/**<tr><td><a name="l1158" href="#l1158">1158</a><td> * Sets the amount of time to wait, in milliseconds, for an asynchronous script<tr><td><a name="l1159" href="#l1159">1159</a><td> * to finish execution before returning an error. If the timeout is less than or<tr><td><a name="l1160" href="#l1160">1160</a><td> * equal to 0, the script will be allowed to run indefinitely.<tr><td><a name="l1161" href="#l1161">1161</a><td> *<tr><td><a name="l1162" href="#l1162">1162</a><td> * @param {number} ms The amount of time to wait, in milliseconds.<tr><td><a name="l1163" href="#l1163">1163</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1164" href="#l1164">1164</a><td> *     script timeout has been set.<tr><td><a name="l1165" href="#l1165">1165</a><td> */<tr><td><a name="l1166" href="#l1166">1166</a><td>webdriver.WebDriver.Timeouts.prototype.setScriptTimeout = function(ms) {<tr><td><a name="l1167" href="#l1167">1167</a><td>  return this.driver_.schedule(<tr><td><a name="l1168" href="#l1168">1168</a><td>      new webdriver.Command(webdriver.CommandName.SET_SCRIPT_TIMEOUT).<tr><td><a name="l1169" href="#l1169">1169</a><td>          setParameter(&#39;ms&#39;, ms &lt; 0 ? 0 : ms),<tr><td><a name="l1170" href="#l1170">1170</a><td>      &#39;WebDriver.manage().timeouts().setScriptTimeout(&#39; + ms + &#39;)&#39;);<tr><td><a name="l1171" href="#l1171">1171</a><td>};<tr><td><a name="l1172" href="#l1172">1172</a><td><tr><td><a name="l1173" href="#l1173">1173</a><td><tr><td><a name="l1174" href="#l1174">1174</a><td>/**<tr><td><a name="l1175" href="#l1175">1175</a><td> * Sets the amount of time to wait for a page load to complete before returning<tr><td><a name="l1176" href="#l1176">1176</a><td> * an error.  If the timeout is negative, page loads may be indefinite.<tr><td><a name="l1177" href="#l1177">1177</a><td> * @param {number} ms The amount of time to wait, in milliseconds.<tr><td><a name="l1178" href="#l1178">1178</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l1179" href="#l1179">1179</a><td> *     the timeout has been set.<tr><td><a name="l1180" href="#l1180">1180</a><td> */<tr><td><a name="l1181" href="#l1181">1181</a><td>webdriver.WebDriver.Timeouts.prototype.pageLoadTimeout = function(ms) {<tr><td><a name="l1182" href="#l1182">1182</a><td>  return this.driver_.schedule(<tr><td><a name="l1183" href="#l1183">1183</a><td>      new webdriver.Command(webdriver.CommandName.SET_TIMEOUT).<tr><td><a name="l1184" href="#l1184">1184</a><td>          setParameter(&#39;type&#39;, &#39;page load&#39;).<tr><td><a name="l1185" href="#l1185">1185</a><td>          setParameter(&#39;ms&#39;, ms),<tr><td><a name="l1186" href="#l1186">1186</a><td>      &#39;WebDriver.manage().timeouts().pageLoadTimeout(&#39; + ms + &#39;)&#39;);<tr><td><a name="l1187" href="#l1187">1187</a><td>};<tr><td><a name="l1188" href="#l1188">1188</a><td><tr><td><a name="l1189" href="#l1189">1189</a><td><tr><td><a name="l1190" href="#l1190">1190</a><td><tr><td><a name="l1191" href="#l1191">1191</a><td>/**<tr><td><a name="l1192" href="#l1192">1192</a><td> * An interface for managing the current window.<tr><td><a name="l1193" href="#l1193">1193</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a name="l1194" href="#l1194">1194</a><td> * @constructor<tr><td><a name="l1195" href="#l1195">1195</a><td> */<tr><td><a name="l1196" href="#l1196">1196</a><td>webdriver.WebDriver.Window = function(driver) {<tr><td><a name="l1197" href="#l1197">1197</a><td><tr><td><a name="l1198" href="#l1198">1198</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a name="l1199" href="#l1199">1199</a><td>  this.driver_ = driver;<tr><td><a name="l1200" href="#l1200">1200</a><td>};<tr><td><a name="l1201" href="#l1201">1201</a><td><tr><td><a name="l1202" href="#l1202">1202</a><td><tr><td><a name="l1203" href="#l1203">1203</a><td>/**<tr><td><a name="l1204" href="#l1204">1204</a><td> * Retrieves the window&#39;s current position, relative to the top left corner of<tr><td><a name="l1205" href="#l1205">1205</a><td> * the screen.<tr><td><a name="l1206" href="#l1206">1206</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1207" href="#l1207">1207</a><td> *     window&#39;s position in the form of a {x:number, y:number} object literal.<tr><td><a name="l1208" href="#l1208">1208</a><td> */<tr><td><a name="l1209" href="#l1209">1209</a><td>webdriver.WebDriver.Window.prototype.getPosition = function() {<tr><td><a name="l1210" href="#l1210">1210</a><td>  return this.driver_.schedule(<tr><td><a name="l1211" href="#l1211">1211</a><td>      new webdriver.Command(webdriver.CommandName.GET_WINDOW_POSITION).<tr><td><a name="l1212" href="#l1212">1212</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;),<tr><td><a name="l1213" href="#l1213">1213</a><td>      &#39;WebDriver.manage().window().getPosition()&#39;);<tr><td><a name="l1214" href="#l1214">1214</a><td>};<tr><td><a name="l1215" href="#l1215">1215</a><td><tr><td><a name="l1216" href="#l1216">1216</a><td><tr><td><a name="l1217" href="#l1217">1217</a><td>/**<tr><td><a name="l1218" href="#l1218">1218</a><td> * Repositions the current window.<tr><td><a name="l1219" href="#l1219">1219</a><td> * @param {number} x The desired horizontal position, relative to the left side<tr><td><a name="l1220" href="#l1220">1220</a><td> *     of the screen.<tr><td><a name="l1221" href="#l1221">1221</a><td> * @param {number} y The desired vertical position, relative to the top of the<tr><td><a name="l1222" href="#l1222">1222</a><td> *     of the screen.<tr><td><a name="l1223" href="#l1223">1223</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1224" href="#l1224">1224</a><td> *     command has completed.<tr><td><a name="l1225" href="#l1225">1225</a><td> */<tr><td><a name="l1226" href="#l1226">1226</a><td>webdriver.WebDriver.Window.prototype.setPosition = function(x, y) {<tr><td><a name="l1227" href="#l1227">1227</a><td>  return this.driver_.schedule(<tr><td><a name="l1228" href="#l1228">1228</a><td>      new webdriver.Command(webdriver.CommandName.SET_WINDOW_POSITION).<tr><td><a name="l1229" href="#l1229">1229</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;).<tr><td><a name="l1230" href="#l1230">1230</a><td>          setParameter(&#39;x&#39;, x).<tr><td><a name="l1231" href="#l1231">1231</a><td>          setParameter(&#39;y&#39;, y),<tr><td><a name="l1232" href="#l1232">1232</a><td>      &#39;WebDriver.manage().window().setPosition(&#39; + x + &#39;, &#39; + y + &#39;)&#39;);<tr><td><a name="l1233" href="#l1233">1233</a><td>};<tr><td><a name="l1234" href="#l1234">1234</a><td><tr><td><a name="l1235" href="#l1235">1235</a><td><tr><td><a name="l1236" href="#l1236">1236</a><td>/**<tr><td><a name="l1237" href="#l1237">1237</a><td> * Retrieves the window&#39;s current size.<tr><td><a name="l1238" href="#l1238">1238</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1239" href="#l1239">1239</a><td> *     window&#39;s size in the form of a {width:number, height:number} object<tr><td><a name="l1240" href="#l1240">1240</a><td> *     literal.<tr><td><a name="l1241" href="#l1241">1241</a><td> */<tr><td><a name="l1242" href="#l1242">1242</a><td>webdriver.WebDriver.Window.prototype.getSize = function() {<tr><td><a name="l1243" href="#l1243">1243</a><td>  return this.driver_.schedule(<tr><td><a name="l1244" href="#l1244">1244</a><td>      new webdriver.Command(webdriver.CommandName.GET_WINDOW_SIZE).<tr><td><a name="l1245" href="#l1245">1245</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;),<tr><td><a name="l1246" href="#l1246">1246</a><td>      &#39;WebDriver.manage().window().getSize()&#39;);<tr><td><a name="l1247" href="#l1247">1247</a><td>};<tr><td><a name="l1248" href="#l1248">1248</a><td><tr><td><a name="l1249" href="#l1249">1249</a><td><tr><td><a name="l1250" href="#l1250">1250</a><td>/**<tr><td><a name="l1251" href="#l1251">1251</a><td> * Resizes the current window.<tr><td><a name="l1252" href="#l1252">1252</a><td> * @param {number} width The desired window width.<tr><td><a name="l1253" href="#l1253">1253</a><td> * @param {number} height The desired window height.<tr><td><a name="l1254" href="#l1254">1254</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1255" href="#l1255">1255</a><td> *     command has completed.<tr><td><a name="l1256" href="#l1256">1256</a><td> */<tr><td><a name="l1257" href="#l1257">1257</a><td>webdriver.WebDriver.Window.prototype.setSize = function(width, height) {<tr><td><a name="l1258" href="#l1258">1258</a><td>  return this.driver_.schedule(<tr><td><a name="l1259" href="#l1259">1259</a><td>      new webdriver.Command(webdriver.CommandName.SET_WINDOW_SIZE).<tr><td><a name="l1260" href="#l1260">1260</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;).<tr><td><a name="l1261" href="#l1261">1261</a><td>          setParameter(&#39;width&#39;, width).<tr><td><a name="l1262" href="#l1262">1262</a><td>          setParameter(&#39;height&#39;, height),<tr><td><a name="l1263" href="#l1263">1263</a><td>      &#39;WebDriver.manage().window().setSize(&#39; + width + &#39;, &#39; + height + &#39;)&#39;);<tr><td><a name="l1264" href="#l1264">1264</a><td>};<tr><td><a name="l1265" href="#l1265">1265</a><td><tr><td><a name="l1266" href="#l1266">1266</a><td><tr><td><a name="l1267" href="#l1267">1267</a><td>/**<tr><td><a name="l1268" href="#l1268">1268</a><td> * Maximizes the current window.<tr><td><a name="l1269" href="#l1269">1269</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1270" href="#l1270">1270</a><td> *     command has completed.<tr><td><a name="l1271" href="#l1271">1271</a><td> */<tr><td><a name="l1272" href="#l1272">1272</a><td>webdriver.WebDriver.Window.prototype.maximize = function() {<tr><td><a name="l1273" href="#l1273">1273</a><td>  return this.driver_.schedule(<tr><td><a name="l1274" href="#l1274">1274</a><td>      new webdriver.Command(webdriver.CommandName.MAXIMIZE_WINDOW).<tr><td><a name="l1275" href="#l1275">1275</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;),<tr><td><a name="l1276" href="#l1276">1276</a><td>      &#39;WebDriver.manage().window().maximize()&#39;);<tr><td><a name="l1277" href="#l1277">1277</a><td>};<tr><td><a name="l1278" href="#l1278">1278</a><td><tr><td><a name="l1279" href="#l1279">1279</a><td><tr><td><a name="l1280" href="#l1280">1280</a><td>/**<tr><td><a name="l1281" href="#l1281">1281</a><td> * Interface for managing WebDriver log records.<tr><td><a name="l1282" href="#l1282">1282</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a name="l1283" href="#l1283">1283</a><td> * @constructor<tr><td><a name="l1284" href="#l1284">1284</a><td> */<tr><td><a name="l1285" href="#l1285">1285</a><td>webdriver.WebDriver.Logs = function(driver) {<tr><td><a name="l1286" href="#l1286">1286</a><td><tr><td><a name="l1287" href="#l1287">1287</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a name="l1288" href="#l1288">1288</a><td>  this.driver_ = driver;<tr><td><a name="l1289" href="#l1289">1289</a><td>};<tr><td><a name="l1290" href="#l1290">1290</a><td><tr><td><a name="l1291" href="#l1291">1291</a><td><tr><td><a name="l1292" href="#l1292">1292</a><td>/**<tr><td><a name="l1293" href="#l1293">1293</a><td> * Fetches available log entries for the given type.<tr><td><a name="l1294" href="#l1294">1294</a><td> *<tr><td><a name="l1295" href="#l1295">1295</a><td> * &lt;p/&gt;Note that log buffers are reset after each call, meaning that<tr><td><a name="l1296" href="#l1296">1296</a><td> * available log entries correspond to those entries not yet returned for a<tr><td><a name="l1297" href="#l1297">1297</a><td> * given log type. In practice, this means that this call will return the<tr><td><a name="l1298" href="#l1298">1298</a><td> * available log entries since the last call, or from the start of the<tr><td><a name="l1299" href="#l1299">1299</a><td> * session.<tr><td><a name="l1300" href="#l1300">1300</a><td> *<tr><td><a name="l1301" href="#l1301">1301</a><td> * @param {!webdriver.logging.Type} type The desired log type.<tr><td><a name="l1302" href="#l1302">1302</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.logging.Entry&gt;&gt;} A<tr><td><a name="l1303" href="#l1303">1303</a><td> *   promise that will resolve to a list of log entries for the specified<tr><td><a name="l1304" href="#l1304">1304</a><td> *   type.<tr><td><a name="l1305" href="#l1305">1305</a><td> */<tr><td><a name="l1306" href="#l1306">1306</a><td>webdriver.WebDriver.Logs.prototype.get = function(type) {<tr><td><a name="l1307" href="#l1307">1307</a><td>  return this.driver_.schedule(<tr><td><a name="l1308" href="#l1308">1308</a><td>      new webdriver.Command(webdriver.CommandName.GET_LOG).<tr><td><a name="l1309" href="#l1309">1309</a><td>          setParameter(&#39;type&#39;, type),<tr><td><a name="l1310" href="#l1310">1310</a><td>      &#39;WebDriver.manage().logs().get(&#39; + type + &#39;)&#39;).<tr><td><a name="l1311" href="#l1311">1311</a><td>      then(function(entries) {<tr><td><a name="l1312" href="#l1312">1312</a><td>        return goog.array.map(entries, function(entry) {<tr><td><a name="l1313" href="#l1313">1313</a><td>          if (!(entry instanceof webdriver.logging.Entry)) {<tr><td><a name="l1314" href="#l1314">1314</a><td>            return new webdriver.logging.Entry(<tr><td><a name="l1315" href="#l1315">1315</a><td>                entry[&#39;level&#39;], entry[&#39;message&#39;], entry[&#39;timestamp&#39;]);<tr><td><a name="l1316" href="#l1316">1316</a><td>          }<tr><td><a name="l1317" href="#l1317">1317</a><td>          return entry;<tr><td><a name="l1318" href="#l1318">1318</a><td>        });<tr><td><a name="l1319" href="#l1319">1319</a><td>      });<tr><td><a name="l1320" href="#l1320">1320</a><td>};<tr><td><a name="l1321" href="#l1321">1321</a><td><tr><td><a name="l1322" href="#l1322">1322</a><td><tr><td><a name="l1323" href="#l1323">1323</a><td>/**<tr><td><a name="l1324" href="#l1324">1324</a><td> * Retrieves the log types available to this driver.<tr><td><a name="l1325" href="#l1325">1325</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.logging.Type&gt;&gt;} A<tr><td><a name="l1326" href="#l1326">1326</a><td> *     promise that will resolve to a list of available log types.<tr><td><a name="l1327" href="#l1327">1327</a><td> */<tr><td><a name="l1328" href="#l1328">1328</a><td>webdriver.WebDriver.Logs.prototype.getAvailableLogTypes = function() {<tr><td><a name="l1329" href="#l1329">1329</a><td>  return this.driver_.schedule(<tr><td><a name="l1330" href="#l1330">1330</a><td>      new webdriver.Command(webdriver.CommandName.GET_AVAILABLE_LOG_TYPES),<tr><td><a name="l1331" href="#l1331">1331</a><td>      &#39;WebDriver.manage().logs().getAvailableLogTypes()&#39;);<tr><td><a name="l1332" href="#l1332">1332</a><td>};<tr><td><a name="l1333" href="#l1333">1333</a><td><tr><td><a name="l1334" href="#l1334">1334</a><td><tr><td><a name="l1335" href="#l1335">1335</a><td><tr><td><a name="l1336" href="#l1336">1336</a><td>/**<tr><td><a name="l1337" href="#l1337">1337</a><td> * An interface for changing the focus of the driver to another frame or window.<tr><td><a name="l1338" href="#l1338">1338</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a name="l1339" href="#l1339">1339</a><td> * @constructor<tr><td><a name="l1340" href="#l1340">1340</a><td> */<tr><td><a name="l1341" href="#l1341">1341</a><td>webdriver.WebDriver.TargetLocator = function(driver) {<tr><td><a name="l1342" href="#l1342">1342</a><td><tr><td><a name="l1343" href="#l1343">1343</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a name="l1344" href="#l1344">1344</a><td>  this.driver_ = driver;<tr><td><a name="l1345" href="#l1345">1345</a><td>};<tr><td><a name="l1346" href="#l1346">1346</a><td><tr><td><a name="l1347" href="#l1347">1347</a><td><tr><td><a name="l1348" href="#l1348">1348</a><td>/**<tr><td><a name="l1349" href="#l1349">1349</a><td> * Schedules a command retrieve the {@code document.activeElement} element on<tr><td><a name="l1350" href="#l1350">1350</a><td> * the current document, or {@code document.body} if activeElement is not<tr><td><a name="l1351" href="#l1351">1351</a><td> * available.<tr><td><a name="l1352" href="#l1352">1352</a><td> * @return {!webdriver.WebElement} The active element.<tr><td><a name="l1353" href="#l1353">1353</a><td> */<tr><td><a name="l1354" href="#l1354">1354</a><td>webdriver.WebDriver.TargetLocator.prototype.activeElement = function() {<tr><td><a name="l1355" href="#l1355">1355</a><td>  var id = this.driver_.schedule(<tr><td><a name="l1356" href="#l1356">1356</a><td>      new webdriver.Command(webdriver.CommandName.GET_ACTIVE_ELEMENT),<tr><td><a name="l1357" href="#l1357">1357</a><td>      &#39;WebDriver.switchTo().activeElement()&#39;);<tr><td><a name="l1358" href="#l1358">1358</a><td>  return new webdriver.WebElement(this.driver_, id);<tr><td><a name="l1359" href="#l1359">1359</a><td>};<tr><td><a name="l1360" href="#l1360">1360</a><td><tr><td><a name="l1361" href="#l1361">1361</a><td><tr><td><a name="l1362" href="#l1362">1362</a><td>/**<tr><td><a name="l1363" href="#l1363">1363</a><td> * Schedules a command to switch focus of all future commands to the first frame<tr><td><a name="l1364" href="#l1364">1364</a><td> * on the page.<tr><td><a name="l1365" href="#l1365">1365</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1366" href="#l1366">1366</a><td> *     driver has changed focus to the default content.<tr><td><a name="l1367" href="#l1367">1367</a><td> */<tr><td><a name="l1368" href="#l1368">1368</a><td>webdriver.WebDriver.TargetLocator.prototype.defaultContent = function() {<tr><td><a name="l1369" href="#l1369">1369</a><td>  return this.driver_.schedule(<tr><td><a name="l1370" href="#l1370">1370</a><td>      new webdriver.Command(webdriver.CommandName.SWITCH_TO_FRAME).<tr><td><a name="l1371" href="#l1371">1371</a><td>          setParameter(&#39;id&#39;, null),<tr><td><a name="l1372" href="#l1372">1372</a><td>      &#39;WebDriver.switchTo().defaultContent()&#39;);<tr><td><a name="l1373" href="#l1373">1373</a><td>};<tr><td><a name="l1374" href="#l1374">1374</a><td><tr><td><a name="l1375" href="#l1375">1375</a><td><tr><td><a name="l1376" href="#l1376">1376</a><td>/**<tr><td><a name="l1377" href="#l1377">1377</a><td> * Schedules a command to switch the focus of all future commands to another<tr><td><a name="l1378" href="#l1378">1378</a><td> * frame on the page.<tr><td><a name="l1379" href="#l1379">1379</a><td> * &lt;p/&gt;<tr><td><a name="l1380" href="#l1380">1380</a><td> * If the frame is specified by a number, the command will switch to the frame<tr><td><a name="l1381" href="#l1381">1381</a><td> * by its (zero-based) index into the {@code window.frames} collection.<tr><td><a name="l1382" href="#l1382">1382</a><td> * &lt;p/&gt;<tr><td><a name="l1383" href="#l1383">1383</a><td> * If the frame is specified by a string, the command will select the frame by<tr><td><a name="l1384" href="#l1384">1384</a><td> * its name or ID. To select sub-frames, simply separate the frame names/IDs by<tr><td><a name="l1385" href="#l1385">1385</a><td> * dots. As an example, &quot;main.child&quot; will select the frame with the name &quot;main&quot;<tr><td><a name="l1386" href="#l1386">1386</a><td> * and then its child &quot;child&quot;.<tr><td><a name="l1387" href="#l1387">1387</a><td> * &lt;p/&gt;<tr><td><a name="l1388" href="#l1388">1388</a><td> * If the specified frame can not be found, the deferred result will errback<tr><td><a name="l1389" href="#l1389">1389</a><td> * with a {@code bot.ErrorCode.NO_SUCH_FRAME} error.<tr><td><a name="l1390" href="#l1390">1390</a><td> * @param {string|number} nameOrIndex The frame locator.<tr><td><a name="l1391" href="#l1391">1391</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1392" href="#l1392">1392</a><td> *     driver has changed focus to the specified frame.<tr><td><a name="l1393" href="#l1393">1393</a><td> */<tr><td><a name="l1394" href="#l1394">1394</a><td>webdriver.WebDriver.TargetLocator.prototype.frame = function(nameOrIndex) {<tr><td><a name="l1395" href="#l1395">1395</a><td>  return this.driver_.schedule(<tr><td><a name="l1396" href="#l1396">1396</a><td>      new webdriver.Command(webdriver.CommandName.SWITCH_TO_FRAME).<tr><td><a name="l1397" href="#l1397">1397</a><td>          setParameter(&#39;id&#39;, nameOrIndex),<tr><td><a name="l1398" href="#l1398">1398</a><td>      &#39;WebDriver.switchTo().frame(&#39; + nameOrIndex + &#39;)&#39;);<tr><td><a name="l1399" href="#l1399">1399</a><td>};<tr><td><a name="l1400" href="#l1400">1400</a><td><tr><td><a name="l1401" href="#l1401">1401</a><td><tr><td><a name="l1402" href="#l1402">1402</a><td>/**<tr><td><a name="l1403" href="#l1403">1403</a><td> * Schedules a command to switch the focus of all future commands to another<tr><td><a name="l1404" href="#l1404">1404</a><td> * window. Windows may be specified by their {@code window.name} attribute or<tr><td><a name="l1405" href="#l1405">1405</a><td> * by its handle (as returned by {@code webdriver.WebDriver#getWindowHandles}).<tr><td><a name="l1406" href="#l1406">1406</a><td> * &lt;p/&gt;<tr><td><a name="l1407" href="#l1407">1407</a><td> * If the specificed window can not be found, the deferred result will errback<tr><td><a name="l1408" href="#l1408">1408</a><td> * with a {@code bot.ErrorCode.NO_SUCH_WINDOW} error.<tr><td><a name="l1409" href="#l1409">1409</a><td> * @param {string} nameOrHandle The name or window handle of the window to<tr><td><a name="l1410" href="#l1410">1410</a><td> *     switch focus to.<tr><td><a name="l1411" href="#l1411">1411</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when the<tr><td><a name="l1412" href="#l1412">1412</a><td> *     driver has changed focus to the specified window.<tr><td><a name="l1413" href="#l1413">1413</a><td> */<tr><td><a name="l1414" href="#l1414">1414</a><td>webdriver.WebDriver.TargetLocator.prototype.window = function(nameOrHandle) {<tr><td><a name="l1415" href="#l1415">1415</a><td>  return this.driver_.schedule(<tr><td><a name="l1416" href="#l1416">1416</a><td>      new webdriver.Command(webdriver.CommandName.SWITCH_TO_WINDOW).<tr><td><a name="l1417" href="#l1417">1417</a><td>          setParameter(&#39;name&#39;, nameOrHandle),<tr><td><a name="l1418" href="#l1418">1418</a><td>      &#39;WebDriver.switchTo().window(&#39; + nameOrHandle + &#39;)&#39;);<tr><td><a name="l1419" href="#l1419">1419</a><td>};<tr><td><a name="l1420" href="#l1420">1420</a><td><tr><td><a name="l1421" href="#l1421">1421</a><td><tr><td><a name="l1422" href="#l1422">1422</a><td>/**<tr><td><a name="l1423" href="#l1423">1423</a><td> * Schedules a command to change focus to the active alert dialog. This command<tr><td><a name="l1424" href="#l1424">1424</a><td> * will return a {@link bot.ErrorCode.NO_MODAL_DIALOG_OPEN} error if a modal<tr><td><a name="l1425" href="#l1425">1425</a><td> * dialog is not currently open.<tr><td><a name="l1426" href="#l1426">1426</a><td> * @return {!webdriver.Alert} The open alert.<tr><td><a name="l1427" href="#l1427">1427</a><td> */<tr><td><a name="l1428" href="#l1428">1428</a><td>webdriver.WebDriver.TargetLocator.prototype.alert = function() {<tr><td><a name="l1429" href="#l1429">1429</a><td>  var text = this.driver_.schedule(<tr><td><a name="l1430" href="#l1430">1430</a><td>      new webdriver.Command(webdriver.CommandName.GET_ALERT_TEXT),<tr><td><a name="l1431" href="#l1431">1431</a><td>      &#39;WebDriver.switchTo().alert()&#39;);<tr><td><a name="l1432" href="#l1432">1432</a><td>  return new webdriver.Alert(this.driver_, text);<tr><td><a name="l1433" href="#l1433">1433</a><td>};<tr><td><a name="l1434" href="#l1434">1434</a><td><tr><td><a name="l1435" href="#l1435">1435</a><td><tr><td><a name="l1436" href="#l1436">1436</a><td>/**<tr><td><a name="l1437" href="#l1437">1437</a><td> * Simulate pressing many keys at once in a &quot;chord&quot;. Takes a sequence of<tr><td><a name="l1438" href="#l1438">1438</a><td> * {@link webdriver.Key}s or strings, appends each of the values to a string,<tr><td><a name="l1439" href="#l1439">1439</a><td> * and adds the chord termination key ({@link webdriver.Key.NULL}) and returns<tr><td><a name="l1440" href="#l1440">1440</a><td> * the resultant string.<tr><td><a name="l1441" href="#l1441">1441</a><td> *<tr><td><a name="l1442" href="#l1442">1442</a><td> * Note: when the low-level webdriver key handlers see Keys.NULL, active<tr><td><a name="l1443" href="#l1443">1443</a><td> * modifier keys (CTRL/ALT/SHIFT/etc) release via a keyup event.<tr><td><a name="l1444" href="#l1444">1444</a><td> *<tr><td><a name="l1445" href="#l1445">1445</a><td> * @param {...string} var_args The key sequence to concatenate.<tr><td><a name="l1446" href="#l1446">1446</a><td> * @return {string} The null-terminated key sequence.<tr><td><a name="l1447" href="#l1447">1447</a><td> * @see http://code.google.com/p/webdriver/issues/detail?id=79<tr><td><a name="l1448" href="#l1448">1448</a><td> */<tr><td><a name="l1449" href="#l1449">1449</a><td>webdriver.Key.chord = function(var_args) {<tr><td><a name="l1450" href="#l1450">1450</a><td>  var sequence = goog.array.reduce(<tr><td><a name="l1451" href="#l1451">1451</a><td>      goog.array.slice(arguments, 0),<tr><td><a name="l1452" href="#l1452">1452</a><td>      function(str, key) {<tr><td><a name="l1453" href="#l1453">1453</a><td>        return str + key;<tr><td><a name="l1454" href="#l1454">1454</a><td>      }, &#39;&#39;);<tr><td><a name="l1455" href="#l1455">1455</a><td>  sequence += webdriver.Key.NULL;<tr><td><a name="l1456" href="#l1456">1456</a><td>  return sequence;<tr><td><a name="l1457" href="#l1457">1457</a><td>};<tr><td><a name="l1458" href="#l1458">1458</a><td><tr><td><a name="l1459" href="#l1459">1459</a><td><tr><td><a name="l1460" href="#l1460">1460</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a name="l1461" href="#l1461">1461</a><td>//<tr><td><a name="l1462" href="#l1462">1462</a><td>//  webdriver.WebElement<tr><td><a name="l1463" href="#l1463">1463</a><td>//<tr><td><a name="l1464" href="#l1464">1464</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a name="l1465" href="#l1465">1465</a><td><tr><td><a name="l1466" href="#l1466">1466</a><td><tr><td><a name="l1467" href="#l1467">1467</a><td><tr><td><a name="l1468" href="#l1468">1468</a><td>/**<tr><td><a name="l1469" href="#l1469">1469</a><td> * Represents a DOM element. WebElements can be found by searching from the<tr><td><a name="l1470" href="#l1470">1470</a><td> * document root using a {@code webdriver.WebDriver} instance, or by searching<tr><td><a name="l1471" href="#l1471">1471</a><td> * under another {@code webdriver.WebElement}:<tr><td><a name="l1472" href="#l1472">1472</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l1473" href="#l1473">1473</a><td> *   driver.get(&#39;http://www.google.com&#39;);<tr><td><a name="l1474" href="#l1474">1474</a><td> *   var searchForm = driver.findElement(By.tagName(&#39;form&#39;));<tr><td><a name="l1475" href="#l1475">1475</a><td> *   var searchBox = searchForm.findElement(By.name(&#39;q&#39;));<tr><td><a name="l1476" href="#l1476">1476</a><td> *   searchBox.sendKeys(&#39;webdriver&#39;);<tr><td><a name="l1477" href="#l1477">1477</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l1478" href="#l1478">1478</a><td> *<tr><td><a name="l1479" href="#l1479">1479</a><td> * The WebElement is implemented as a promise for compatibility with the promise<tr><td><a name="l1480" href="#l1480">1480</a><td> * API. It will always resolve itself when its internal state has been fully<tr><td><a name="l1481" href="#l1481">1481</a><td> * resolved and commands may be issued against the element. This can be used to<tr><td><a name="l1482" href="#l1482">1482</a><td> * catch errors when an element cannot be located on the page:<tr><td><a name="l1483" href="#l1483">1483</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l1484" href="#l1484">1484</a><td> *   driver.findElement(By.id(&#39;not-there&#39;)).then(function(element) {<tr><td><a name="l1485" href="#l1485">1485</a><td> *     alert(&#39;Found an element that was not expected to be there!&#39;);<tr><td><a name="l1486" href="#l1486">1486</a><td> *   }, function(error) {<tr><td><a name="l1487" href="#l1487">1487</a><td> *     alert(&#39;The element was not found, as expected&#39;);<tr><td><a name="l1488" href="#l1488">1488</a><td> *   });<tr><td><a name="l1489" href="#l1489">1489</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l1490" href="#l1490">1490</a><td> *<tr><td><a name="l1491" href="#l1491">1491</a><td> * @param {!webdriver.WebDriver} driver The parent WebDriver instance for this<tr><td><a name="l1492" href="#l1492">1492</a><td> *     element.<tr><td><a name="l1493" href="#l1493">1493</a><td> * @param {!(string|webdriver.promise.Promise)} id Either the opaque ID for the<tr><td><a name="l1494" href="#l1494">1494</a><td> *     underlying DOM element assigned by the server, or a promise that will<tr><td><a name="l1495" href="#l1495">1495</a><td> *     resolve to that ID or another WebElement.<tr><td><a name="l1496" href="#l1496">1496</a><td> * @constructor<tr><td><a name="l1497" href="#l1497">1497</a><td> * @extends {webdriver.promise.Deferred}<tr><td><a name="l1498" href="#l1498">1498</a><td> */<tr><td><a name="l1499" href="#l1499">1499</a><td>webdriver.WebElement = function(driver, id) {<tr><td><a name="l1500" href="#l1500">1500</a><td>  webdriver.promise.Deferred.call(this, null, driver.controlFlow());<tr><td><a name="l1501" href="#l1501">1501</a><td><tr><td><a name="l1502" href="#l1502">1502</a><td>  /**<tr><td><a name="l1503" href="#l1503">1503</a><td>   * The parent WebDriver instance for this element.<tr><td><a name="l1504" href="#l1504">1504</a><td>   * @private {!webdriver.WebDriver}<tr><td><a name="l1505" href="#l1505">1505</a><td>   */<tr><td><a name="l1506" href="#l1506">1506</a><td>  this.driver_ = driver;<tr><td><a name="l1507" href="#l1507">1507</a><td><tr><td><a name="l1508" href="#l1508">1508</a><td>  // This class is responsible for resolving itself; delete the resolve and<tr><td><a name="l1509" href="#l1509">1509</a><td>  // reject methods so they may not be accessed by consumers of this class.<tr><td><a name="l1510" href="#l1510">1510</a><td>  var fulfill = goog.partial(this.fulfill, this);<tr><td><a name="l1511" href="#l1511">1511</a><td>  var reject = this.reject;<tr><td><a name="l1512" href="#l1512">1512</a><td>  delete this.promise;<tr><td><a name="l1513" href="#l1513">1513</a><td>  delete this.fulfill;<tr><td><a name="l1514" href="#l1514">1514</a><td>  delete this.reject;<tr><td><a name="l1515" href="#l1515">1515</a><td><tr><td><a name="l1516" href="#l1516">1516</a><td>  /**<tr><td><a name="l1517" href="#l1517">1517</a><td>   * A promise that resolves to the JSON representation of this WebElement&#39;s<tr><td><a name="l1518" href="#l1518">1518</a><td>   * ID, as defined by the WebDriver wire protocol.<tr><td><a name="l1519" href="#l1519">1519</a><td>   * @private {!webdriver.promise.Promise}<tr><td><a name="l1520" href="#l1520">1520</a><td>   * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol<tr><td><a name="l1521" href="#l1521">1521</a><td>   */<tr><td><a name="l1522" href="#l1522">1522</a><td>  this.id_ = webdriver.promise.when(id, function(id) {<tr><td><a name="l1523" href="#l1523">1523</a><td>    if (id instanceof webdriver.WebElement) {<tr><td><a name="l1524" href="#l1524">1524</a><td>      return id.id_;<tr><td><a name="l1525" href="#l1525">1525</a><td>    } else if (goog.isDef(id[webdriver.WebElement.ELEMENT_KEY])) {<tr><td><a name="l1526" href="#l1526">1526</a><td>      return id;<tr><td><a name="l1527" href="#l1527">1527</a><td>    }<tr><td><a name="l1528" href="#l1528">1528</a><td><tr><td><a name="l1529" href="#l1529">1529</a><td>    var json = {};<tr><td><a name="l1530" href="#l1530">1530</a><td>    json[webdriver.WebElement.ELEMENT_KEY] = id;<tr><td><a name="l1531" href="#l1531">1531</a><td>    return json;<tr><td><a name="l1532" href="#l1532">1532</a><td>  });<tr><td><a name="l1533" href="#l1533">1533</a><td><tr><td><a name="l1534" href="#l1534">1534</a><td>  // This WebElement should not be resolved until its ID has been<tr><td><a name="l1535" href="#l1535">1535</a><td>  // fully resolved.<tr><td><a name="l1536" href="#l1536">1536</a><td>  this.id_.then(fulfill, reject);<tr><td><a name="l1537" href="#l1537">1537</a><td>};<tr><td><a name="l1538" href="#l1538">1538</a><td>goog.inherits(webdriver.WebElement, webdriver.promise.Deferred);<tr><td><a name="l1539" href="#l1539">1539</a><td><tr><td><a name="l1540" href="#l1540">1540</a><td><tr><td><a name="l1541" href="#l1541">1541</a><td>/**<tr><td><a name="l1542" href="#l1542">1542</a><td> * The property key used in the wire protocol to indicate that a JSON object<tr><td><a name="l1543" href="#l1543">1543</a><td> * contains the ID of a WebElement.<tr><td><a name="l1544" href="#l1544">1544</a><td> * @type {string}<tr><td><a name="l1545" href="#l1545">1545</a><td> * @const<tr><td><a name="l1546" href="#l1546">1546</a><td> */<tr><td><a name="l1547" href="#l1547">1547</a><td>webdriver.WebElement.ELEMENT_KEY = &#39;ELEMENT&#39;;<tr><td><a name="l1548" href="#l1548">1548</a><td><tr><td><a name="l1549" href="#l1549">1549</a><td><tr><td><a name="l1550" href="#l1550">1550</a><td>/**<tr><td><a name="l1551" href="#l1551">1551</a><td> * Compares to WebElements for equality.<tr><td><a name="l1552" href="#l1552">1552</a><td> * @param {!webdriver.WebElement} a A WebElement.<tr><td><a name="l1553" href="#l1553">1553</a><td> * @param {!webdriver.WebElement} b A WebElement.<tr><td><a name="l1554" href="#l1554">1554</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved to<tr><td><a name="l1555" href="#l1555">1555</a><td> *     whether the two WebElements are equal.<tr><td><a name="l1556" href="#l1556">1556</a><td> */<tr><td><a name="l1557" href="#l1557">1557</a><td>webdriver.WebElement.equals = function(a, b) {<tr><td><a name="l1558" href="#l1558">1558</a><td>  if (a == b) {<tr><td><a name="l1559" href="#l1559">1559</a><td>    return webdriver.promise.fulfilled(true);<tr><td><a name="l1560" href="#l1560">1560</a><td>  }<tr><td><a name="l1561" href="#l1561">1561</a><td>  return webdriver.promise.fullyResolved([a.id_, b.id_]).then(function(ids) {<tr><td><a name="l1562" href="#l1562">1562</a><td>    // If the two element&#39;s have the same ID, they should be considered<tr><td><a name="l1563" href="#l1563">1563</a><td>    // equal. Otherwise, they may still be equivalent, but we&#39;ll need to<tr><td><a name="l1564" href="#l1564">1564</a><td>    // ask the server to check for us.<tr><td><a name="l1565" href="#l1565">1565</a><td>    if (ids[0][webdriver.WebElement.ELEMENT_KEY] ==<tr><td><a name="l1566" href="#l1566">1566</a><td>        ids[1][webdriver.WebElement.ELEMENT_KEY]) {<tr><td><a name="l1567" href="#l1567">1567</a><td>      return true;<tr><td><a name="l1568" href="#l1568">1568</a><td>    }<tr><td><a name="l1569" href="#l1569">1569</a><td><tr><td><a name="l1570" href="#l1570">1570</a><td>    var command = new webdriver.Command(<tr><td><a name="l1571" href="#l1571">1571</a><td>        webdriver.CommandName.ELEMENT_EQUALS);<tr><td><a name="l1572" href="#l1572">1572</a><td>    command.setParameter(&#39;other&#39;, b);<tr><td><a name="l1573" href="#l1573">1573</a><td>    return a.schedule_(command, &#39;webdriver.WebElement.equals()&#39;);<tr><td><a name="l1574" href="#l1574">1574</a><td>  });<tr><td><a name="l1575" href="#l1575">1575</a><td>};<tr><td><a name="l1576" href="#l1576">1576</a><td><tr><td><a name="l1577" href="#l1577">1577</a><td><tr><td><a name="l1578" href="#l1578">1578</a><td>/**<tr><td><a name="l1579" href="#l1579">1579</a><td> * @return {!webdriver.WebDriver} The parent driver for this instance.<tr><td><a name="l1580" href="#l1580">1580</a><td> */<tr><td><a name="l1581" href="#l1581">1581</a><td>webdriver.WebElement.prototype.getDriver = function() {<tr><td><a name="l1582" href="#l1582">1582</a><td>  return this.driver_;<tr><td><a name="l1583" href="#l1583">1583</a><td>};<tr><td><a name="l1584" href="#l1584">1584</a><td><tr><td><a name="l1585" href="#l1585">1585</a><td><tr><td><a name="l1586" href="#l1586">1586</a><td>/**<tr><td><a name="l1587" href="#l1587">1587</a><td> * @return {!webdriver.promise.Promise} A promise that resolves to this<tr><td><a name="l1588" href="#l1588">1588</a><td> *     element&#39;s JSON representation as defined by the WebDriver wire protocol.<tr><td><a name="l1589" href="#l1589">1589</a><td> * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol<tr><td><a name="l1590" href="#l1590">1590</a><td> */<tr><td><a name="l1591" href="#l1591">1591</a><td>webdriver.WebElement.prototype.toWireValue = function() {<tr><td><a name="l1592" href="#l1592">1592</a><td>  return this.id_;<tr><td><a name="l1593" href="#l1593">1593</a><td>};<tr><td><a name="l1594" href="#l1594">1594</a><td><tr><td><a name="l1595" href="#l1595">1595</a><td><tr><td><a name="l1596" href="#l1596">1596</a><td>/**<tr><td><a name="l1597" href="#l1597">1597</a><td> * Schedules a command that targets this element with the parent WebDriver<tr><td><a name="l1598" href="#l1598">1598</a><td> * instance. Will ensure this element&#39;s ID is included in the command parameters<tr><td><a name="l1599" href="#l1599">1599</a><td> * under the &quot;id&quot; key.<tr><td><a name="l1600" href="#l1600">1600</a><td> * @param {!webdriver.Command} command The command to schedule.<tr><td><a name="l1601" href="#l1601">1601</a><td> * @param {string} description A description of the command for debugging.<tr><td><a name="l1602" href="#l1602">1602</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with<tr><td><a name="l1603" href="#l1603">1603</a><td> *     the command result.<tr><td><a name="l1604" href="#l1604">1604</a><td> * @see webdriver.WebDriver.prototype.schedule<tr><td><a name="l1605" href="#l1605">1605</a><td> * @private<tr><td><a name="l1606" href="#l1606">1606</a><td> */<tr><td><a name="l1607" href="#l1607">1607</a><td>webdriver.WebElement.prototype.schedule_ = function(command, description) {<tr><td><a name="l1608" href="#l1608">1608</a><td>  command.setParameter(&#39;id&#39;, this.id_);<tr><td><a name="l1609" href="#l1609">1609</a><td>  return this.driver_.schedule(command, description);<tr><td><a name="l1610" href="#l1610">1610</a><td>};<tr><td><a name="l1611" href="#l1611">1611</a><td><tr><td><a name="l1612" href="#l1612">1612</a><td><tr><td><a name="l1613" href="#l1613">1613</a><td>/**<tr><td><a name="l1614" href="#l1614">1614</a><td> * Schedule a command to find a descendant of this element. If the element<tr><td><a name="l1615" href="#l1615">1615</a><td> * cannot be found, a {@code bot.ErrorCode.NO_SUCH_ELEMENT} result will<tr><td><a name="l1616" href="#l1616">1616</a><td> * be returned by the driver. Unlike other commands, this error cannot be<tr><td><a name="l1617" href="#l1617">1617</a><td> * suppressed. In other words, scheduling a command to find an element doubles<tr><td><a name="l1618" href="#l1618">1618</a><td> * as an assert that the element is present on the page. To test whether an<tr><td><a name="l1619" href="#l1619">1619</a><td> * element is present on the page, use {@code #isElementPresent} instead.<tr><td><a name="l1620" href="#l1620">1620</a><td> *<tr><td><a name="l1621" href="#l1621">1621</a><td> * &lt;p&gt;The search criteria for an element may be defined using one of the<tr><td><a name="l1622" href="#l1622">1622</a><td> * factories in the {@link webdriver.By} namespace, or as a short-hand<tr><td><a name="l1623" href="#l1623">1623</a><td> * {@link webdriver.By.Hash} object. For example, the following two statements<tr><td><a name="l1624" href="#l1624">1624</a><td> * are equivalent:<tr><td><a name="l1625" href="#l1625">1625</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l1626" href="#l1626">1626</a><td> * var e1 = element.findElement(By.id(&#39;foo&#39;));<tr><td><a name="l1627" href="#l1627">1627</a><td> * var e2 = element.findElement({id:&#39;foo&#39;});<tr><td><a name="l1628" href="#l1628">1628</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l1629" href="#l1629">1629</a><td> *<tr><td><a name="l1630" href="#l1630">1630</a><td> * &lt;p&gt;You may also provide a custom locator function, which takes as input<tr><td><a name="l1631" href="#l1631">1631</a><td> * this WebDriver instance and returns a {@link webdriver.WebElement}, or a<tr><td><a name="l1632" href="#l1632">1632</a><td> * promise that will resolve to a WebElement. For example, to find the first<tr><td><a name="l1633" href="#l1633">1633</a><td> * visible link on a page, you could write:<tr><td><a name="l1634" href="#l1634">1634</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l1635" href="#l1635">1635</a><td> * var link = element.findElement(firstVisibleLink);<tr><td><a name="l1636" href="#l1636">1636</a><td> *<tr><td><a name="l1637" href="#l1637">1637</a><td> * function firstVisibleLink(element) {<tr><td><a name="l1638" href="#l1638">1638</a><td> *   var links = element.findElements(By.tagName(&#39;a&#39;));<tr><td><a name="l1639" href="#l1639">1639</a><td> *   return webdriver.promise.filter(links, function(link) {<tr><td><a name="l1640" href="#l1640">1640</a><td> *     return links.isDisplayed();<tr><td><a name="l1641" href="#l1641">1641</a><td> *   }).then(function(visibleLinks) {<tr><td><a name="l1642" href="#l1642">1642</a><td> *     return visibleLinks[0];<tr><td><a name="l1643" href="#l1643">1643</a><td> *   });<tr><td><a name="l1644" href="#l1644">1644</a><td> * }<tr><td><a name="l1645" href="#l1645">1645</a><td> * &lt;/pre&gt;&lt;/code&gt;<tr><td><a name="l1646" href="#l1646">1646</a><td> *<tr><td><a name="l1647" href="#l1647">1647</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The<tr><td><a name="l1648" href="#l1648">1648</a><td> *     locator strategy to use when searching for the element.<tr><td><a name="l1649" href="#l1649">1649</a><td> * @return {!webdriver.WebElement} A WebElement that can be used to issue<tr><td><a name="l1650" href="#l1650">1650</a><td> *     commands against the located element. If the element is not found, the<tr><td><a name="l1651" href="#l1651">1651</a><td> *     element will be invalidated and all scheduled commands aborted.<tr><td><a name="l1652" href="#l1652">1652</a><td> */<tr><td><a name="l1653" href="#l1653">1653</a><td>webdriver.WebElement.prototype.findElement = function(locator) {<tr><td><a name="l1654" href="#l1654">1654</a><td>  locator = webdriver.Locator.checkLocator(locator);<tr><td><a name="l1655" href="#l1655">1655</a><td>  var id;<tr><td><a name="l1656" href="#l1656">1656</a><td>  if (goog.isFunction(locator)) {<tr><td><a name="l1657" href="#l1657">1657</a><td>    id = this.driver_.findElementInternal_(locator, this);<tr><td><a name="l1658" href="#l1658">1658</a><td>  } else {<tr><td><a name="l1659" href="#l1659">1659</a><td>    var command = new webdriver.Command(<tr><td><a name="l1660" href="#l1660">1660</a><td>        webdriver.CommandName.FIND_CHILD_ELEMENT).<tr><td><a name="l1661" href="#l1661">1661</a><td>        setParameter(&#39;using&#39;, locator.using).<tr><td><a name="l1662" href="#l1662">1662</a><td>        setParameter(&#39;value&#39;, locator.value);<tr><td><a name="l1663" href="#l1663">1663</a><td>    id = this.schedule_(command, &#39;WebElement.findElement(&#39; + locator + &#39;)&#39;);<tr><td><a name="l1664" href="#l1664">1664</a><td>  }<tr><td><a name="l1665" href="#l1665">1665</a><td>  return new webdriver.WebElement(this.driver_, id);<tr><td><a name="l1666" href="#l1666">1666</a><td>};<tr><td><a name="l1667" href="#l1667">1667</a><td><tr><td><a name="l1668" href="#l1668">1668</a><td><tr><td><a name="l1669" href="#l1669">1669</a><td>/**<tr><td><a name="l1670" href="#l1670">1670</a><td> * Schedules a command to test if there is at least one descendant of this<tr><td><a name="l1671" href="#l1671">1671</a><td> * element that matches the given search criteria.<tr><td><a name="l1672" href="#l1672">1672</a><td> *<tr><td><a name="l1673" href="#l1673">1673</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The<tr><td><a name="l1674" href="#l1674">1674</a><td> *     locator strategy to use when searching for the element.<tr><td><a name="l1675" href="#l1675">1675</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will be<tr><td><a name="l1676" href="#l1676">1676</a><td> *     resolved with whether an element could be located on the page.<tr><td><a name="l1677" href="#l1677">1677</a><td> */<tr><td><a name="l1678" href="#l1678">1678</a><td>webdriver.WebElement.prototype.isElementPresent = function(locator) {<tr><td><a name="l1679" href="#l1679">1679</a><td>  return this.findElements(locator).then(function(result) {<tr><td><a name="l1680" href="#l1680">1680</a><td>    return !!result.length;<tr><td><a name="l1681" href="#l1681">1681</a><td>  });<tr><td><a name="l1682" href="#l1682">1682</a><td>};<tr><td><a name="l1683" href="#l1683">1683</a><td><tr><td><a name="l1684" href="#l1684">1684</a><td><tr><td><a name="l1685" href="#l1685">1685</a><td>/**<tr><td><a name="l1686" href="#l1686">1686</a><td> * Schedules a command to find all of the descendants of this element that<tr><td><a name="l1687" href="#l1687">1687</a><td> * match the given search criteria.<tr><td><a name="l1688" href="#l1688">1688</a><td> *<tr><td><a name="l1689" href="#l1689">1689</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The<tr><td><a name="l1690" href="#l1690">1690</a><td> *     locator strategy to use when searching for the elements.<tr><td><a name="l1691" href="#l1691">1691</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.WebElement&gt;&gt;} A<tr><td><a name="l1692" href="#l1692">1692</a><td> *     promise that will resolve to an array of WebElements.<tr><td><a name="l1693" href="#l1693">1693</a><td> */<tr><td><a name="l1694" href="#l1694">1694</a><td>webdriver.WebElement.prototype.findElements = function(locator) {<tr><td><a name="l1695" href="#l1695">1695</a><td>  locator = webdriver.Locator.checkLocator(locator);<tr><td><a name="l1696" href="#l1696">1696</a><td>  if (goog.isFunction(locator)) {<tr><td><a name="l1697" href="#l1697">1697</a><td>    return this.driver_.findElementsInternal_(locator, this);<tr><td><a name="l1698" href="#l1698">1698</a><td>  } else {<tr><td><a name="l1699" href="#l1699">1699</a><td>    var command = new webdriver.Command(<tr><td><a name="l1700" href="#l1700">1700</a><td>        webdriver.CommandName.FIND_CHILD_ELEMENTS).<tr><td><a name="l1701" href="#l1701">1701</a><td>        setParameter(&#39;using&#39;, locator.using).<tr><td><a name="l1702" href="#l1702">1702</a><td>        setParameter(&#39;value&#39;, locator.value);<tr><td><a name="l1703" href="#l1703">1703</a><td>    return this.schedule_(command, &#39;WebElement.findElements(&#39; + locator + &#39;)&#39;);<tr><td><a name="l1704" href="#l1704">1704</a><td>  }<tr><td><a name="l1705" href="#l1705">1705</a><td>};<tr><td><a name="l1706" href="#l1706">1706</a><td><tr><td><a name="l1707" href="#l1707">1707</a><td><tr><td><a name="l1708" href="#l1708">1708</a><td>/**<tr><td><a name="l1709" href="#l1709">1709</a><td> * Schedules a command to click on this element.<tr><td><a name="l1710" href="#l1710">1710</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l1711" href="#l1711">1711</a><td> *     the click command has completed.<tr><td><a name="l1712" href="#l1712">1712</a><td> */<tr><td><a name="l1713" href="#l1713">1713</a><td>webdriver.WebElement.prototype.click = function() {<tr><td><a name="l1714" href="#l1714">1714</a><td>  return this.schedule_(<tr><td><a name="l1715" href="#l1715">1715</a><td>      new webdriver.Command(webdriver.CommandName.CLICK_ELEMENT),<tr><td><a name="l1716" href="#l1716">1716</a><td>      &#39;WebElement.click()&#39;);<tr><td><a name="l1717" href="#l1717">1717</a><td>};<tr><td><a name="l1718" href="#l1718">1718</a><td><tr><td><a name="l1719" href="#l1719">1719</a><td><tr><td><a name="l1720" href="#l1720">1720</a><td>/**<tr><td><a name="l1721" href="#l1721">1721</a><td> * Schedules a command to type a sequence on the DOM element represented by this<tr><td><a name="l1722" href="#l1722">1722</a><td> * instance.<tr><td><a name="l1723" href="#l1723">1723</a><td> * &lt;p/&gt;<tr><td><a name="l1724" href="#l1724">1724</a><td> * Modifier keys (SHIFT, CONTROL, ALT, META) are stateful; once a modifier is<tr><td><a name="l1725" href="#l1725">1725</a><td> * processed in the keysequence, that key state is toggled until one of the<tr><td><a name="l1726" href="#l1726">1726</a><td> * following occurs:<tr><td><a name="l1727" href="#l1727">1727</a><td> * &lt;ul&gt;<tr><td><a name="l1728" href="#l1728">1728</a><td> * &lt;li&gt;The modifier key is encountered again in the sequence. At this point the<tr><td><a name="l1729" href="#l1729">1729</a><td> * state of the key is toggled (along with the appropriate keyup/down events).<tr><td><a name="l1730" href="#l1730">1730</a><td> * &lt;/li&gt;<tr><td><a name="l1731" href="#l1731">1731</a><td> * &lt;li&gt;The {@code webdriver.Key.NULL} key is encountered in the sequence. When<tr><td><a name="l1732" href="#l1732">1732</a><td> * this key is encountered, all modifier keys current in the down state are<tr><td><a name="l1733" href="#l1733">1733</a><td> * released (with accompanying keyup events). The NULL key can be used to<tr><td><a name="l1734" href="#l1734">1734</a><td> * simulate common keyboard shortcuts:<tr><td><a name="l1735" href="#l1735">1735</a><td> * &lt;code&gt;&lt;pre&gt;<tr><td><a name="l1736" href="#l1736">1736</a><td> *     element.sendKeys(&quot;text was&quot;,<tr><td><a name="l1737" href="#l1737">1737</a><td> *                      webdriver.Key.CONTROL, &quot;a&quot;, webdriver.Key.NULL,<tr><td><a name="l1738" href="#l1738">1738</a><td> *                      &quot;now text is&quot;);<tr><td><a name="l1739" href="#l1739">1739</a><td> *     // Alternatively:<tr><td><a name="l1740" href="#l1740">1740</a><td> *     element.sendKeys(&quot;text was&quot;,<tr><td><a name="l1741" href="#l1741">1741</a><td> *                      webdriver.Key.chord(webdriver.Key.CONTROL, &quot;a&quot;),<tr><td><a name="l1742" href="#l1742">1742</a><td> *                      &quot;now text is&quot;);<tr><td><a name="l1743" href="#l1743">1743</a><td> * &lt;/pre&gt;&lt;/code&gt;&lt;/li&gt;<tr><td><a name="l1744" href="#l1744">1744</a><td> * &lt;li&gt;The end of the keysequence is encountered. When there are no more keys<tr><td><a name="l1745" href="#l1745">1745</a><td> * to type, all depressed modifier keys are released (with accompanying keyup<tr><td><a name="l1746" href="#l1746">1746</a><td> * events).<tr><td><a name="l1747" href="#l1747">1747</a><td> * &lt;/li&gt;<tr><td><a name="l1748" href="#l1748">1748</a><td> * &lt;/ul&gt;<tr><td><a name="l1749" href="#l1749">1749</a><td> * &lt;strong&gt;Note:&lt;/strong&gt; On browsers where native keyboard events are not yet<tr><td><a name="l1750" href="#l1750">1750</a><td> * supported (e.g. Firefox on OS X), key events will be synthesized. Special<tr><td><a name="l1751" href="#l1751">1751</a><td> * punctionation keys will be synthesized according to a standard QWERTY en-us<tr><td><a name="l1752" href="#l1752">1752</a><td> * keyboard layout.<tr><td><a name="l1753" href="#l1753">1753</a><td> *<tr><td><a name="l1754" href="#l1754">1754</a><td> * @param {...string} var_args The sequence of keys to<tr><td><a name="l1755" href="#l1755">1755</a><td> *     type. All arguments will be joined into a single sequence (var_args is<tr><td><a name="l1756" href="#l1756">1756</a><td> *     permitted for convenience).<tr><td><a name="l1757" href="#l1757">1757</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when all<tr><td><a name="l1758" href="#l1758">1758</a><td> *     keys have been typed.<tr><td><a name="l1759" href="#l1759">1759</a><td> */<tr><td><a name="l1760" href="#l1760">1760</a><td>webdriver.WebElement.prototype.sendKeys = function(var_args) {<tr><td><a name="l1761" href="#l1761">1761</a><td>  // Coerce every argument to a string. This protects us from users that<tr><td><a name="l1762" href="#l1762">1762</a><td>  // ignore the jsdoc and give us a number (which ends up causing problems on<tr><td><a name="l1763" href="#l1763">1763</a><td>  // the server, which requires strings).<tr><td><a name="l1764" href="#l1764">1764</a><td>  var keys = webdriver.promise.fullyResolved(goog.array.slice(arguments, 0)).<tr><td><a name="l1765" href="#l1765">1765</a><td>      then(function(args) {<tr><td><a name="l1766" href="#l1766">1766</a><td>        return goog.array.map(goog.array.slice(args, 0), function(key) {<tr><td><a name="l1767" href="#l1767">1767</a><td>          return key + &#39;&#39;;<tr><td><a name="l1768" href="#l1768">1768</a><td>        });<tr><td><a name="l1769" href="#l1769">1769</a><td>      });<tr><td><a name="l1770" href="#l1770">1770</a><td>  return this.schedule_(<tr><td><a name="l1771" href="#l1771">1771</a><td>      new webdriver.Command(webdriver.CommandName.SEND_KEYS_TO_ELEMENT).<tr><td><a name="l1772" href="#l1772">1772</a><td>          setParameter(&#39;value&#39;, keys),<tr><td><a name="l1773" href="#l1773">1773</a><td>      &#39;WebElement.sendKeys(&#39; + keys + &#39;)&#39;);<tr><td><a name="l1774" href="#l1774">1774</a><td>};<tr><td><a name="l1775" href="#l1775">1775</a><td><tr><td><a name="l1776" href="#l1776">1776</a><td><tr><td><a name="l1777" href="#l1777">1777</a><td>/**<tr><td><a name="l1778" href="#l1778">1778</a><td> * Schedules a command to query for the tag/node name of this element.<tr><td><a name="l1779" href="#l1779">1779</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1780" href="#l1780">1780</a><td> *     element&#39;s tag name.<tr><td><a name="l1781" href="#l1781">1781</a><td> */<tr><td><a name="l1782" href="#l1782">1782</a><td>webdriver.WebElement.prototype.getTagName = function() {<tr><td><a name="l1783" href="#l1783">1783</a><td>  return this.schedule_(<tr><td><a name="l1784" href="#l1784">1784</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_TAG_NAME),<tr><td><a name="l1785" href="#l1785">1785</a><td>      &#39;WebElement.getTagName()&#39;);<tr><td><a name="l1786" href="#l1786">1786</a><td>};<tr><td><a name="l1787" href="#l1787">1787</a><td><tr><td><a name="l1788" href="#l1788">1788</a><td><tr><td><a name="l1789" href="#l1789">1789</a><td>/**<tr><td><a name="l1790" href="#l1790">1790</a><td> * Schedules a command to query for the computed style of the element<tr><td><a name="l1791" href="#l1791">1791</a><td> * represented by this instance. If the element inherits the named style from<tr><td><a name="l1792" href="#l1792">1792</a><td> * its parent, the parent will be queried for its value.  Where possible, color<tr><td><a name="l1793" href="#l1793">1793</a><td> * values will be converted to their hex representation (e.g. #00ff00 instead of<tr><td><a name="l1794" href="#l1794">1794</a><td> * rgb(0, 255, 0)).<tr><td><a name="l1795" href="#l1795">1795</a><td> * &lt;p/&gt;<tr><td><a name="l1796" href="#l1796">1796</a><td> * &lt;em&gt;Warning:&lt;/em&gt; the value returned will be as the browser interprets it, so<tr><td><a name="l1797" href="#l1797">1797</a><td> * it may be tricky to form a proper assertion.<tr><td><a name="l1798" href="#l1798">1798</a><td> *<tr><td><a name="l1799" href="#l1799">1799</a><td> * @param {string} cssStyleProperty The name of the CSS style property to look<tr><td><a name="l1800" href="#l1800">1800</a><td> *     up.<tr><td><a name="l1801" href="#l1801">1801</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1802" href="#l1802">1802</a><td> *     requested CSS value.<tr><td><a name="l1803" href="#l1803">1803</a><td> */<tr><td><a name="l1804" href="#l1804">1804</a><td>webdriver.WebElement.prototype.getCssValue = function(cssStyleProperty) {<tr><td><a name="l1805" href="#l1805">1805</a><td>  var name = webdriver.CommandName.GET_ELEMENT_VALUE_OF_CSS_PROPERTY;<tr><td><a name="l1806" href="#l1806">1806</a><td>  return this.schedule_(<tr><td><a name="l1807" href="#l1807">1807</a><td>      new webdriver.Command(name).<tr><td><a name="l1808" href="#l1808">1808</a><td>          setParameter(&#39;propertyName&#39;, cssStyleProperty),<tr><td><a name="l1809" href="#l1809">1809</a><td>      &#39;WebElement.getCssValue(&#39; + cssStyleProperty + &#39;)&#39;);<tr><td><a name="l1810" href="#l1810">1810</a><td>};<tr><td><a name="l1811" href="#l1811">1811</a><td><tr><td><a name="l1812" href="#l1812">1812</a><td><tr><td><a name="l1813" href="#l1813">1813</a><td>/**<tr><td><a name="l1814" href="#l1814">1814</a><td> * Schedules a command to query for the value of the given attribute of the<tr><td><a name="l1815" href="#l1815">1815</a><td> * element. Will return the current value, even if it has been modified after<tr><td><a name="l1816" href="#l1816">1816</a><td> * the page has been loaded. More exactly, this method will return the value of<tr><td><a name="l1817" href="#l1817">1817</a><td> * the given attribute, unless that attribute is not present, in which case the<tr><td><a name="l1818" href="#l1818">1818</a><td> * value of the property with the same name is returned. If neither value is<tr><td><a name="l1819" href="#l1819">1819</a><td> * set, null is returned (for example, the &quot;value&quot; property of a textarea<tr><td><a name="l1820" href="#l1820">1820</a><td> * element). The &quot;style&quot; attribute is converted as best can be to a<tr><td><a name="l1821" href="#l1821">1821</a><td> * text representation with a trailing semi-colon. The following are deemed to<tr><td><a name="l1822" href="#l1822">1822</a><td> * be &quot;boolean&quot; attributes and will return either &quot;true&quot; or null:<tr><td><a name="l1823" href="#l1823">1823</a><td> *<tr><td><a name="l1824" href="#l1824">1824</a><td> * &lt;p&gt;async, autofocus, autoplay, checked, compact, complete, controls, declare,<tr><td><a name="l1825" href="#l1825">1825</a><td> * defaultchecked, defaultselected, defer, disabled, draggable, ended,<tr><td><a name="l1826" href="#l1826">1826</a><td> * formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope,<tr><td><a name="l1827" href="#l1827">1827</a><td> * loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open,<tr><td><a name="l1828" href="#l1828">1828</a><td> * paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,<tr><td><a name="l1829" href="#l1829">1829</a><td> * selected, spellcheck, truespeed, willvalidate<tr><td><a name="l1830" href="#l1830">1830</a><td> *<tr><td><a name="l1831" href="#l1831">1831</a><td> * &lt;p&gt;Finally, the following commonly mis-capitalized attribute/property names<tr><td><a name="l1832" href="#l1832">1832</a><td> * are evaluated as expected:<tr><td><a name="l1833" href="#l1833">1833</a><td> * &lt;ul&gt;<tr><td><a name="l1834" href="#l1834">1834</a><td> *   &lt;li&gt;&quot;class&quot;<tr><td><a name="l1835" href="#l1835">1835</a><td> *   &lt;li&gt;&quot;readonly&quot;<tr><td><a name="l1836" href="#l1836">1836</a><td> * &lt;/ul&gt;<tr><td><a name="l1837" href="#l1837">1837</a><td> * @param {string} attributeName The name of the attribute to query.<tr><td><a name="l1838" href="#l1838">1838</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1839" href="#l1839">1839</a><td> *     attribute&#39;s value. The returned value will always be either a string or<tr><td><a name="l1840" href="#l1840">1840</a><td> *     null.<tr><td><a name="l1841" href="#l1841">1841</a><td> */<tr><td><a name="l1842" href="#l1842">1842</a><td>webdriver.WebElement.prototype.getAttribute = function(attributeName) {<tr><td><a name="l1843" href="#l1843">1843</a><td>  return this.schedule_(<tr><td><a name="l1844" href="#l1844">1844</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_ATTRIBUTE).<tr><td><a name="l1845" href="#l1845">1845</a><td>          setParameter(&#39;name&#39;, attributeName),<tr><td><a name="l1846" href="#l1846">1846</a><td>      &#39;WebElement.getAttribute(&#39; + attributeName + &#39;)&#39;);<tr><td><a name="l1847" href="#l1847">1847</a><td>};<tr><td><a name="l1848" href="#l1848">1848</a><td><tr><td><a name="l1849" href="#l1849">1849</a><td><tr><td><a name="l1850" href="#l1850">1850</a><td>/**<tr><td><a name="l1851" href="#l1851">1851</a><td> * Get the visible (i.e. not hidden by CSS) innerText of this element, including<tr><td><a name="l1852" href="#l1852">1852</a><td> * sub-elements, without any leading or trailing whitespace.<tr><td><a name="l1853" href="#l1853">1853</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1854" href="#l1854">1854</a><td> *     element&#39;s visible text.<tr><td><a name="l1855" href="#l1855">1855</a><td> */<tr><td><a name="l1856" href="#l1856">1856</a><td>webdriver.WebElement.prototype.getText = function() {<tr><td><a name="l1857" href="#l1857">1857</a><td>  return this.schedule_(<tr><td><a name="l1858" href="#l1858">1858</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_TEXT),<tr><td><a name="l1859" href="#l1859">1859</a><td>      &#39;WebElement.getText()&#39;);<tr><td><a name="l1860" href="#l1860">1860</a><td>};<tr><td><a name="l1861" href="#l1861">1861</a><td><tr><td><a name="l1862" href="#l1862">1862</a><td><tr><td><a name="l1863" href="#l1863">1863</a><td>/**<tr><td><a name="l1864" href="#l1864">1864</a><td> * Schedules a command to compute the size of this element&#39;s bounding box, in<tr><td><a name="l1865" href="#l1865">1865</a><td> * pixels.<tr><td><a name="l1866" href="#l1866">1866</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1867" href="#l1867">1867</a><td> *     element&#39;s size as a {@code {width:number, height:number}} object.<tr><td><a name="l1868" href="#l1868">1868</a><td> */<tr><td><a name="l1869" href="#l1869">1869</a><td>webdriver.WebElement.prototype.getSize = function() {<tr><td><a name="l1870" href="#l1870">1870</a><td>  return this.schedule_(<tr><td><a name="l1871" href="#l1871">1871</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_SIZE),<tr><td><a name="l1872" href="#l1872">1872</a><td>      &#39;WebElement.getSize()&#39;);<tr><td><a name="l1873" href="#l1873">1873</a><td>};<tr><td><a name="l1874" href="#l1874">1874</a><td><tr><td><a name="l1875" href="#l1875">1875</a><td><tr><td><a name="l1876" href="#l1876">1876</a><td>/**<tr><td><a name="l1877" href="#l1877">1877</a><td> * Schedules a command to compute the location of this element in page space.<tr><td><a name="l1878" href="#l1878">1878</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved to the<tr><td><a name="l1879" href="#l1879">1879</a><td> *     element&#39;s location as a {@code {x:number, y:number}} object.<tr><td><a name="l1880" href="#l1880">1880</a><td> */<tr><td><a name="l1881" href="#l1881">1881</a><td>webdriver.WebElement.prototype.getLocation = function() {<tr><td><a name="l1882" href="#l1882">1882</a><td>  return this.schedule_(<tr><td><a name="l1883" href="#l1883">1883</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_LOCATION),<tr><td><a name="l1884" href="#l1884">1884</a><td>      &#39;WebElement.getLocation()&#39;);<tr><td><a name="l1885" href="#l1885">1885</a><td>};<tr><td><a name="l1886" href="#l1886">1886</a><td><tr><td><a name="l1887" href="#l1887">1887</a><td><tr><td><a name="l1888" href="#l1888">1888</a><td>/**<tr><td><a name="l1889" href="#l1889">1889</a><td> * Schedules a command to query whether the DOM element represented by this<tr><td><a name="l1890" href="#l1890">1890</a><td> * instance is enabled, as dicted by the {@code disabled} attribute.<tr><td><a name="l1891" href="#l1891">1891</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with<tr><td><a name="l1892" href="#l1892">1892</a><td> *     whether this element is currently enabled.<tr><td><a name="l1893" href="#l1893">1893</a><td> */<tr><td><a name="l1894" href="#l1894">1894</a><td>webdriver.WebElement.prototype.isEnabled = function() {<tr><td><a name="l1895" href="#l1895">1895</a><td>  return this.schedule_(<tr><td><a name="l1896" href="#l1896">1896</a><td>      new webdriver.Command(webdriver.CommandName.IS_ELEMENT_ENABLED),<tr><td><a name="l1897" href="#l1897">1897</a><td>      &#39;WebElement.isEnabled()&#39;);<tr><td><a name="l1898" href="#l1898">1898</a><td>};<tr><td><a name="l1899" href="#l1899">1899</a><td><tr><td><a name="l1900" href="#l1900">1900</a><td><tr><td><a name="l1901" href="#l1901">1901</a><td>/**<tr><td><a name="l1902" href="#l1902">1902</a><td> * Schedules a command to query whether this element is selected.<tr><td><a name="l1903" href="#l1903">1903</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with<tr><td><a name="l1904" href="#l1904">1904</a><td> *     whether this element is currently selected.<tr><td><a name="l1905" href="#l1905">1905</a><td> */<tr><td><a name="l1906" href="#l1906">1906</a><td>webdriver.WebElement.prototype.isSelected = function() {<tr><td><a name="l1907" href="#l1907">1907</a><td>  return this.schedule_(<tr><td><a name="l1908" href="#l1908">1908</a><td>      new webdriver.Command(webdriver.CommandName.IS_ELEMENT_SELECTED),<tr><td><a name="l1909" href="#l1909">1909</a><td>      &#39;WebElement.isSelected()&#39;);<tr><td><a name="l1910" href="#l1910">1910</a><td>};<tr><td><a name="l1911" href="#l1911">1911</a><td><tr><td><a name="l1912" href="#l1912">1912</a><td><tr><td><a name="l1913" href="#l1913">1913</a><td>/**<tr><td><a name="l1914" href="#l1914">1914</a><td> * Schedules a command to submit the form containing this element (or this<tr><td><a name="l1915" href="#l1915">1915</a><td> * element if it is a FORM element). This command is a no-op if the element is<tr><td><a name="l1916" href="#l1916">1916</a><td> * not contained in a form.<tr><td><a name="l1917" href="#l1917">1917</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l1918" href="#l1918">1918</a><td> *     the form has been submitted.<tr><td><a name="l1919" href="#l1919">1919</a><td> */<tr><td><a name="l1920" href="#l1920">1920</a><td>webdriver.WebElement.prototype.submit = function() {<tr><td><a name="l1921" href="#l1921">1921</a><td>  return this.schedule_(<tr><td><a name="l1922" href="#l1922">1922</a><td>      new webdriver.Command(webdriver.CommandName.SUBMIT_ELEMENT),<tr><td><a name="l1923" href="#l1923">1923</a><td>      &#39;WebElement.submit()&#39;);<tr><td><a name="l1924" href="#l1924">1924</a><td>};<tr><td><a name="l1925" href="#l1925">1925</a><td><tr><td><a name="l1926" href="#l1926">1926</a><td><tr><td><a name="l1927" href="#l1927">1927</a><td>/**<tr><td><a name="l1928" href="#l1928">1928</a><td> * Schedules a command to clear the {@code value} of this element. This command<tr><td><a name="l1929" href="#l1929">1929</a><td> * has no effect if the underlying DOM element is neither a text INPUT element<tr><td><a name="l1930" href="#l1930">1930</a><td> * nor a TEXTAREA element.<tr><td><a name="l1931" href="#l1931">1931</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l1932" href="#l1932">1932</a><td> *     the element has been cleared.<tr><td><a name="l1933" href="#l1933">1933</a><td> */<tr><td><a name="l1934" href="#l1934">1934</a><td>webdriver.WebElement.prototype.clear = function() {<tr><td><a name="l1935" href="#l1935">1935</a><td>  return this.schedule_(<tr><td><a name="l1936" href="#l1936">1936</a><td>      new webdriver.Command(webdriver.CommandName.CLEAR_ELEMENT),<tr><td><a name="l1937" href="#l1937">1937</a><td>      &#39;WebElement.clear()&#39;);<tr><td><a name="l1938" href="#l1938">1938</a><td>};<tr><td><a name="l1939" href="#l1939">1939</a><td><tr><td><a name="l1940" href="#l1940">1940</a><td><tr><td><a name="l1941" href="#l1941">1941</a><td>/**<tr><td><a name="l1942" href="#l1942">1942</a><td> * Schedules a command to test whether this element is currently displayed.<tr><td><a name="l1943" href="#l1943">1943</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with<tr><td><a name="l1944" href="#l1944">1944</a><td> *     whether this element is currently visible on the page.<tr><td><a name="l1945" href="#l1945">1945</a><td> */<tr><td><a name="l1946" href="#l1946">1946</a><td>webdriver.WebElement.prototype.isDisplayed = function() {<tr><td><a name="l1947" href="#l1947">1947</a><td>  return this.schedule_(<tr><td><a name="l1948" href="#l1948">1948</a><td>      new webdriver.Command(webdriver.CommandName.IS_ELEMENT_DISPLAYED),<tr><td><a name="l1949" href="#l1949">1949</a><td>      &#39;WebElement.isDisplayed()&#39;);<tr><td><a name="l1950" href="#l1950">1950</a><td>};<tr><td><a name="l1951" href="#l1951">1951</a><td><tr><td><a name="l1952" href="#l1952">1952</a><td><tr><td><a name="l1953" href="#l1953">1953</a><td>/**<tr><td><a name="l1954" href="#l1954">1954</a><td> * Schedules a command to retrieve the outer HTML of this element.<tr><td><a name="l1955" href="#l1955">1955</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with<tr><td><a name="l1956" href="#l1956">1956</a><td> *     the element&#39;s outer HTML.<tr><td><a name="l1957" href="#l1957">1957</a><td> */<tr><td><a name="l1958" href="#l1958">1958</a><td>webdriver.WebElement.prototype.getOuterHtml = function() {<tr><td><a name="l1959" href="#l1959">1959</a><td>  return this.driver_.executeScript(function() {<tr><td><a name="l1960" href="#l1960">1960</a><td>    var element = arguments[0];<tr><td><a name="l1961" href="#l1961">1961</a><td>    if (&#39;outerHTML&#39; in element) {<tr><td><a name="l1962" href="#l1962">1962</a><td>      return element.outerHTML;<tr><td><a name="l1963" href="#l1963">1963</a><td>    } else {<tr><td><a name="l1964" href="#l1964">1964</a><td>      var div = element.ownerDocument.createElement(&#39;div&#39;);<tr><td><a name="l1965" href="#l1965">1965</a><td>      div.appendChild(element.cloneNode(true));<tr><td><a name="l1966" href="#l1966">1966</a><td>      return div.innerHTML;<tr><td><a name="l1967" href="#l1967">1967</a><td>    }<tr><td><a name="l1968" href="#l1968">1968</a><td>  }, this);<tr><td><a name="l1969" href="#l1969">1969</a><td>};<tr><td><a name="l1970" href="#l1970">1970</a><td><tr><td><a name="l1971" href="#l1971">1971</a><td><tr><td><a name="l1972" href="#l1972">1972</a><td>/**<tr><td><a name="l1973" href="#l1973">1973</a><td> * Schedules a command to retrieve the inner HTML of this element.<tr><td><a name="l1974" href="#l1974">1974</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved with the<tr><td><a name="l1975" href="#l1975">1975</a><td> *     element&#39;s inner HTML.<tr><td><a name="l1976" href="#l1976">1976</a><td> */<tr><td><a name="l1977" href="#l1977">1977</a><td>webdriver.WebElement.prototype.getInnerHtml = function() {<tr><td><a name="l1978" href="#l1978">1978</a><td>  return this.driver_.executeScript(&#39;return arguments[0].innerHTML&#39;, this);<tr><td><a name="l1979" href="#l1979">1979</a><td>};<tr><td><a name="l1980" href="#l1980">1980</a><td><tr><td><a name="l1981" href="#l1981">1981</a><td><tr><td><a name="l1982" href="#l1982">1982</a><td><tr><td><a name="l1983" href="#l1983">1983</a><td>/**<tr><td><a name="l1984" href="#l1984">1984</a><td> * Represents a modal dialog such as {@code alert}, {@code confirm}, or<tr><td><a name="l1985" href="#l1985">1985</a><td> * {@code prompt}. Provides functions to retrieve the message displayed with<tr><td><a name="l1986" href="#l1986">1986</a><td> * the alert, accept or dismiss the alert, and set the response text (in the<tr><td><a name="l1987" href="#l1987">1987</a><td> * case of {@code prompt}).<tr><td><a name="l1988" href="#l1988">1988</a><td> * @param {!webdriver.WebDriver} driver The driver controlling the browser this<tr><td><a name="l1989" href="#l1989">1989</a><td> *     alert is attached to.<tr><td><a name="l1990" href="#l1990">1990</a><td> * @param {!(string|webdriver.promise.Promise)} text Either the message text<tr><td><a name="l1991" href="#l1991">1991</a><td> *     displayed with this alert, or a promise that will be resolved to said<tr><td><a name="l1992" href="#l1992">1992</a><td> *     text.<tr><td><a name="l1993" href="#l1993">1993</a><td> * @constructor<tr><td><a name="l1994" href="#l1994">1994</a><td> * @extends {webdriver.promise.Deferred}<tr><td><a name="l1995" href="#l1995">1995</a><td> */<tr><td><a name="l1996" href="#l1996">1996</a><td>webdriver.Alert = function(driver, text) {<tr><td><a name="l1997" href="#l1997">1997</a><td>  goog.base(this, null, driver.controlFlow());<tr><td><a name="l1998" href="#l1998">1998</a><td><tr><td><a name="l1999" href="#l1999">1999</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a name="l2000" href="#l2000">2000</a><td>  this.driver_ = driver;<tr><td><a name="l2001" href="#l2001">2001</a><td><tr><td><a name="l2002" href="#l2002">2002</a><td>  // This class is responsible for resolving itself; delete the resolve and<tr><td><a name="l2003" href="#l2003">2003</a><td>  // reject methods so they may not be accessed by consumers of this class.<tr><td><a name="l2004" href="#l2004">2004</a><td>  var fulfill = goog.partial(this.fulfill, this);<tr><td><a name="l2005" href="#l2005">2005</a><td>  var reject = this.reject;<tr><td><a name="l2006" href="#l2006">2006</a><td>  delete this.promise;<tr><td><a name="l2007" href="#l2007">2007</a><td>  delete this.fulfill;<tr><td><a name="l2008" href="#l2008">2008</a><td>  delete this.reject;<tr><td><a name="l2009" href="#l2009">2009</a><td><tr><td><a name="l2010" href="#l2010">2010</a><td>  /** @private {!webdriver.promise.Promise} */<tr><td><a name="l2011" href="#l2011">2011</a><td>  this.text_ = webdriver.promise.when(text);<tr><td><a name="l2012" href="#l2012">2012</a><td><tr><td><a name="l2013" href="#l2013">2013</a><td>  // Make sure this instance is resolved when its displayed text is.<tr><td><a name="l2014" href="#l2014">2014</a><td>  this.text_.then(fulfill, reject);<tr><td><a name="l2015" href="#l2015">2015</a><td>};<tr><td><a name="l2016" href="#l2016">2016</a><td>goog.inherits(webdriver.Alert, webdriver.promise.Deferred);<tr><td><a name="l2017" href="#l2017">2017</a><td><tr><td><a name="l2018" href="#l2018">2018</a><td><tr><td><a name="l2019" href="#l2019">2019</a><td>/**<tr><td><a name="l2020" href="#l2020">2020</a><td> * Retrieves the message text displayed with this alert. For instance, if the<tr><td><a name="l2021" href="#l2021">2021</a><td> * alert were opened with alert(&quot;hello&quot;), then this would return &quot;hello&quot;.<tr><td><a name="l2022" href="#l2022">2022</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved to the<tr><td><a name="l2023" href="#l2023">2023</a><td> *     text displayed with this alert.<tr><td><a name="l2024" href="#l2024">2024</a><td> */<tr><td><a name="l2025" href="#l2025">2025</a><td>webdriver.Alert.prototype.getText = function() {<tr><td><a name="l2026" href="#l2026">2026</a><td>  return this.text_;<tr><td><a name="l2027" href="#l2027">2027</a><td>};<tr><td><a name="l2028" href="#l2028">2028</a><td><tr><td><a name="l2029" href="#l2029">2029</a><td><tr><td><a name="l2030" href="#l2030">2030</a><td>/**<tr><td><a name="l2031" href="#l2031">2031</a><td> * Accepts this alert.<tr><td><a name="l2032" href="#l2032">2032</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l2033" href="#l2033">2033</a><td> *     this command has completed.<tr><td><a name="l2034" href="#l2034">2034</a><td> */<tr><td><a name="l2035" href="#l2035">2035</a><td>webdriver.Alert.prototype.accept = function() {<tr><td><a name="l2036" href="#l2036">2036</a><td>  return this.driver_.schedule(<tr><td><a name="l2037" href="#l2037">2037</a><td>      new webdriver.Command(webdriver.CommandName.ACCEPT_ALERT),<tr><td><a name="l2038" href="#l2038">2038</a><td>      &#39;WebDriver.switchTo().alert().accept()&#39;);<tr><td><a name="l2039" href="#l2039">2039</a><td>};<tr><td><a name="l2040" href="#l2040">2040</a><td><tr><td><a name="l2041" href="#l2041">2041</a><td><tr><td><a name="l2042" href="#l2042">2042</a><td>/**<tr><td><a name="l2043" href="#l2043">2043</a><td> * Dismisses this alert.<tr><td><a name="l2044" href="#l2044">2044</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l2045" href="#l2045">2045</a><td> *     this command has completed.<tr><td><a name="l2046" href="#l2046">2046</a><td> */<tr><td><a name="l2047" href="#l2047">2047</a><td>webdriver.Alert.prototype.dismiss = function() {<tr><td><a name="l2048" href="#l2048">2048</a><td>  return this.driver_.schedule(<tr><td><a name="l2049" href="#l2049">2049</a><td>      new webdriver.Command(webdriver.CommandName.DISMISS_ALERT),<tr><td><a name="l2050" href="#l2050">2050</a><td>      &#39;WebDriver.switchTo().alert().dismiss()&#39;);<tr><td><a name="l2051" href="#l2051">2051</a><td>};<tr><td><a name="l2052" href="#l2052">2052</a><td><tr><td><a name="l2053" href="#l2053">2053</a><td><tr><td><a name="l2054" href="#l2054">2054</a><td>/**<tr><td><a name="l2055" href="#l2055">2055</a><td> * Sets the response text on this alert. This command will return an error if<tr><td><a name="l2056" href="#l2056">2056</a><td> * the underlying alert does not support response text (e.g. window.alert and<tr><td><a name="l2057" href="#l2057">2057</a><td> * window.confirm).<tr><td><a name="l2058" href="#l2058">2058</a><td> * @param {string} text The text to set.<tr><td><a name="l2059" href="#l2059">2059</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l2060" href="#l2060">2060</a><td> *     this command has completed.<tr><td><a name="l2061" href="#l2061">2061</a><td> */<tr><td><a name="l2062" href="#l2062">2062</a><td>webdriver.Alert.prototype.sendKeys = function(text) {<tr><td><a name="l2063" href="#l2063">2063</a><td>  return this.driver_.schedule(<tr><td><a name="l2064" href="#l2064">2064</a><td>      new webdriver.Command(webdriver.CommandName.SET_ALERT_TEXT).<tr><td><a name="l2065" href="#l2065">2065</a><td>          setParameter(&#39;text&#39;, text),<tr><td><a name="l2066" href="#l2066">2066</a><td>      &#39;WebDriver.switchTo().alert().sendKeys(&#39; + text + &#39;)&#39;);<tr><td><a name="l2067" href="#l2067">2067</a><td>};<tr><td><a name="l2068" href="#l2068">2068</a><td><tr><td><a name="l2069" href="#l2069">2069</a><td><tr><td><a name="l2070" href="#l2070">2070</a><td><tr><td><a name="l2071" href="#l2071">2071</a><td>/**<tr><td><a name="l2072" href="#l2072">2072</a><td> * An error returned to indicate that there is an unhandled modal dialog on the<tr><td><a name="l2073" href="#l2073">2073</a><td> * current page.<tr><td><a name="l2074" href="#l2074">2074</a><td> * @param {string} message The error message.<tr><td><a name="l2075" href="#l2075">2075</a><td> * @param {!webdriver.Alert} alert The alert handle.<tr><td><a name="l2076" href="#l2076">2076</a><td> * @constructor<tr><td><a name="l2077" href="#l2077">2077</a><td> * @extends {bot.Error}<tr><td><a name="l2078" href="#l2078">2078</a><td> */<tr><td><a name="l2079" href="#l2079">2079</a><td>webdriver.UnhandledAlertError = function(message, alert) {<tr><td><a name="l2080" href="#l2080">2080</a><td>  goog.base(this, bot.ErrorCode.MODAL_DIALOG_OPENED, message);<tr><td><a name="l2081" href="#l2081">2081</a><td><tr><td><a name="l2082" href="#l2082">2082</a><td>  /** @private {!webdriver.Alert} */<tr><td><a name="l2083" href="#l2083">2083</a><td>  this.alert_ = alert;<tr><td><a name="l2084" href="#l2084">2084</a><td>};<tr><td><a name="l2085" href="#l2085">2085</a><td>goog.inherits(webdriver.UnhandledAlertError, bot.Error);<tr><td><a name="l2086" href="#l2086">2086</a><td><tr><td><a name="l2087" href="#l2087">2087</a><td><tr><td><a name="l2088" href="#l2088">2088</a><td>/**<tr><td><a name="l2089" href="#l2089">2089</a><td> * @return {!webdriver.Alert} The open alert.<tr><td><a name="l2090" href="#l2090">2090</a><td> */<tr><td><a name="l2091" href="#l2091">2091</a><td>webdriver.UnhandledAlertError.prototype.getAlert = function() {<tr><td><a name="l2092" href="#l2092">2092</a><td>  return this.alert_;<tr><td><a name="l2093" href="#l2093">2093</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
\ No newline at end of file
+<!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>webdriver.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/webdriver/webdriver.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview The heart of the WebDriver JavaScript API.<tr><td><a id="l20"></a><a href="#l20">20</a><td> */<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td>goog.provide(&#39;webdriver.Alert&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td>goog.provide(&#39;webdriver.AlertPromise&#39;);<tr><td><a id="l24"></a><a href="#l24">24</a><td>goog.provide(&#39;webdriver.FileDetector&#39;);<tr><td><a id="l25"></a><a href="#l25">25</a><td>goog.provide(&#39;webdriver.UnhandledAlertError&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td>goog.provide(&#39;webdriver.WebDriver&#39;);<tr><td><a id="l27"></a><a href="#l27">27</a><td>goog.provide(&#39;webdriver.WebElement&#39;);<tr><td><a id="l28"></a><a href="#l28">28</a><td>goog.provide(&#39;webdriver.WebElementPromise&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td>goog.require(&#39;bot.Error&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>goog.require(&#39;bot.ErrorCode&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>goog.require(&#39;bot.response&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>goog.require(&#39;goog.array&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>goog.require(&#39;goog.object&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>goog.require(&#39;webdriver.ActionSequence&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td>goog.require(&#39;webdriver.Command&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td>goog.require(&#39;webdriver.CommandName&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>goog.require(&#39;webdriver.Key&#39;);<tr><td><a id="l39"></a><a href="#l39">39</a><td>goog.require(&#39;webdriver.Locator&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>goog.require(&#39;webdriver.Serializable&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>goog.require(&#39;webdriver.Session&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.require(&#39;webdriver.TouchSequence&#39;);<tr><td><a id="l43"></a><a href="#l43">43</a><td>goog.require(&#39;webdriver.logging&#39;);<tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require(&#39;webdriver.promise&#39;);<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require(&#39;webdriver.until&#39;);<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>//<tr><td><a id="l50"></a><a href="#l50">50</a><td>//  webdriver.WebDriver<tr><td><a id="l51"></a><a href="#l51">51</a><td>//<tr><td><a id="l52"></a><a href="#l52">52</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a id="l53"></a><a href="#l53">53</a><td><tr><td><a id="l54"></a><a href="#l54">54</a><td><tr><td><a id="l55"></a><a href="#l55">55</a><td><tr><td><a id="l56"></a><a href="#l56">56</a><td>/**<tr><td><a id="l57"></a><a href="#l57">57</a><td> * Creates a new WebDriver client, which provides control over a browser.<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * Every WebDriver command returns a {@code webdriver.promise.Promise} that<tr><td><a id="l60"></a><a href="#l60">60</a><td> * represents the result of that command. Callbacks may be registered on this<tr><td><a id="l61"></a><a href="#l61">61</a><td> * object to manipulate the command result or catch an expected error. Any<tr><td><a id="l62"></a><a href="#l62">62</a><td> * commands scheduled with a callback are considered sub-commands and will<tr><td><a id="l63"></a><a href="#l63">63</a><td> * execute before the next command in the current frame. For example:<tr><td><a id="l64"></a><a href="#l64">64</a><td> *<tr><td><a id="l65"></a><a href="#l65">65</a><td> *     var message = [];<tr><td><a id="l66"></a><a href="#l66">66</a><td> *     driver.call(message.push, message, &#39;a&#39;).then(function() {<tr><td><a id="l67"></a><a href="#l67">67</a><td> *       driver.call(message.push, message, &#39;b&#39;);<tr><td><a id="l68"></a><a href="#l68">68</a><td> *     });<tr><td><a id="l69"></a><a href="#l69">69</a><td> *     driver.call(message.push, message, &#39;c&#39;);<tr><td><a id="l70"></a><a href="#l70">70</a><td> *     driver.call(function() {<tr><td><a id="l71"></a><a href="#l71">71</a><td> *       alert(&#39;message is abc? &#39; + (message.join(&#39;&#39;) == &#39;abc&#39;));<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> * @param {!(webdriver.Session|webdriver.promise.Promise)} session Either a<tr><td><a id="l75"></a><a href="#l75">75</a><td> *     known session or a promise that will be resolved to a session.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @param {!webdriver.CommandExecutor} executor The executor to use when<tr><td><a id="l77"></a><a href="#l77">77</a><td> *     sending commands to the browser.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The flow to<tr><td><a id="l79"></a><a href="#l79">79</a><td> *     schedule commands through. Defaults to the active flow object.<tr><td><a id="l80"></a><a href="#l80">80</a><td> * @constructor<tr><td><a id="l81"></a><a href="#l81">81</a><td> */<tr><td><a id="l82"></a><a href="#l82">82</a><td>webdriver.WebDriver = function(session, executor, opt_flow) {<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td>  /** @private {!(webdriver.Session|webdriver.promise.Promise)} */<tr><td><a id="l85"></a><a href="#l85">85</a><td>  this.session_ = session;<tr><td><a id="l86"></a><a href="#l86">86</a><td><tr><td><a id="l87"></a><a href="#l87">87</a><td>  /** @private {!webdriver.CommandExecutor} */<tr><td><a id="l88"></a><a href="#l88">88</a><td>  this.executor_ = executor;<tr><td><a id="l89"></a><a href="#l89">89</a><td><tr><td><a id="l90"></a><a href="#l90">90</a><td>  /** @private {!webdriver.promise.ControlFlow} */<tr><td><a id="l91"></a><a href="#l91">91</a><td>  this.flow_ = opt_flow || webdriver.promise.controlFlow();<tr><td><a id="l92"></a><a href="#l92">92</a><td><tr><td><a id="l93"></a><a href="#l93">93</a><td>  /** @private {webdriver.FileDetector} */<tr><td><a id="l94"></a><a href="#l94">94</a><td>  this.fileDetector_ = null;<tr><td><a id="l95"></a><a href="#l95">95</a><td>};<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td><tr><td><a id="l98"></a><a href="#l98">98</a><td>/**<tr><td><a id="l99"></a><a href="#l99">99</a><td> * Creates a new WebDriver client for an existing session.<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {!webdriver.CommandExecutor} executor Command executor to use when<tr><td><a id="l101"></a><a href="#l101">101</a><td> *     querying for session details.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @param {string} sessionId ID of the session to attach to.<tr><td><a id="l103"></a><a href="#l103">103</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow all driver<tr><td><a id="l104"></a><a href="#l104">104</a><td> *     commands should execute under. Defaults to the<tr><td><a id="l105"></a><a href="#l105">105</a><td> *     {@link webdriver.promise.controlFlow() currently active}  control flow.<tr><td><a id="l106"></a><a href="#l106">106</a><td> * @return {!webdriver.WebDriver} A new client for the specified session.<tr><td><a id="l107"></a><a href="#l107">107</a><td> */<tr><td><a id="l108"></a><a href="#l108">108</a><td>webdriver.WebDriver.attachToSession = function(executor, sessionId, opt_flow) {<tr><td><a id="l109"></a><a href="#l109">109</a><td>  return webdriver.WebDriver.acquireSession_(executor,<tr><td><a id="l110"></a><a href="#l110">110</a><td>      new webdriver.Command(webdriver.CommandName.DESCRIBE_SESSION).<tr><td><a id="l111"></a><a href="#l111">111</a><td>          setParameter(&#39;sessionId&#39;, sessionId),<tr><td><a id="l112"></a><a href="#l112">112</a><td>      &#39;WebDriver.attachToSession()&#39;,<tr><td><a id="l113"></a><a href="#l113">113</a><td>      opt_flow);<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><tr><td><a id="l117"></a><a href="#l117">117</a><td>/**<tr><td><a id="l118"></a><a href="#l118">118</a><td> * Creates a new WebDriver session.<tr><td><a id="l119"></a><a href="#l119">119</a><td> * @param {!webdriver.CommandExecutor} executor The executor to create the new<tr><td><a id="l120"></a><a href="#l120">120</a><td> *     session with.<tr><td><a id="l121"></a><a href="#l121">121</a><td> * @param {!webdriver.Capabilities} desiredCapabilities The desired<tr><td><a id="l122"></a><a href="#l122">122</a><td> *     capabilities for the new session.<tr><td><a id="l123"></a><a href="#l123">123</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow all driver<tr><td><a id="l124"></a><a href="#l124">124</a><td> *     commands should execute under, including the initial session creation.<tr><td><a id="l125"></a><a href="#l125">125</a><td> *     Defaults to the {@link webdriver.promise.controlFlow() currently active}<tr><td><a id="l126"></a><a href="#l126">126</a><td> *     control flow.<tr><td><a id="l127"></a><a href="#l127">127</a><td> * @return {!webdriver.WebDriver} The driver for the newly created session.<tr><td><a id="l128"></a><a href="#l128">128</a><td> */<tr><td><a id="l129"></a><a href="#l129">129</a><td>webdriver.WebDriver.createSession = function(<tr><td><a id="l130"></a><a href="#l130">130</a><td>    executor, desiredCapabilities, opt_flow) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>  return webdriver.WebDriver.acquireSession_(executor,<tr><td><a id="l132"></a><a href="#l132">132</a><td>      new webdriver.Command(webdriver.CommandName.NEW_SESSION).<tr><td><a id="l133"></a><a href="#l133">133</a><td>          setParameter(&#39;desiredCapabilities&#39;, desiredCapabilities),<tr><td><a id="l134"></a><a href="#l134">134</a><td>      &#39;WebDriver.createSession()&#39;,<tr><td><a id="l135"></a><a href="#l135">135</a><td>      opt_flow);<tr><td><a id="l136"></a><a href="#l136">136</a><td>};<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * Sends a command to the server that is expected to return the details for a<tr><td><a id="l141"></a><a href="#l141">141</a><td> * {@link webdriver.Session}. This may either be an existing session, or a<tr><td><a id="l142"></a><a href="#l142">142</a><td> * newly created one.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @param {!webdriver.CommandExecutor} executor Command executor to use when<tr><td><a id="l144"></a><a href="#l144">144</a><td> *     querying for session details.<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {!webdriver.Command} command The command to send to fetch the session<tr><td><a id="l146"></a><a href="#l146">146</a><td> *     details.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @param {string} description A descriptive debug label for this action.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow all driver<tr><td><a id="l149"></a><a href="#l149">149</a><td> *     commands should execute under. Defaults to the<tr><td><a id="l150"></a><a href="#l150">150</a><td> *     {@link webdriver.promise.controlFlow() currently active} control flow.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @return {!webdriver.WebDriver} A new WebDriver client for the session.<tr><td><a id="l152"></a><a href="#l152">152</a><td> * @private<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td>webdriver.WebDriver.acquireSession_ = function(<tr><td><a id="l155"></a><a href="#l155">155</a><td>    executor, command, description, opt_flow) {<tr><td><a id="l156"></a><a href="#l156">156</a><td>  var flow = opt_flow || webdriver.promise.controlFlow();<tr><td><a id="l157"></a><a href="#l157">157</a><td>  var session = flow.execute(function() {<tr><td><a id="l158"></a><a href="#l158">158</a><td>    return webdriver.WebDriver.executeCommand_(executor, command).<tr><td><a id="l159"></a><a href="#l159">159</a><td>        then(function(response) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>          bot.response.checkResponse(response);<tr><td><a id="l161"></a><a href="#l161">161</a><td>          return new webdriver.Session(response[&#39;sessionId&#39;],<tr><td><a id="l162"></a><a href="#l162">162</a><td>              response[&#39;value&#39;]);<tr><td><a id="l163"></a><a href="#l163">163</a><td>        });<tr><td><a id="l164"></a><a href="#l164">164</a><td>  }, description);<tr><td><a id="l165"></a><a href="#l165">165</a><td>  return new webdriver.WebDriver(session, executor, flow);<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><tr><td><a id="l169"></a><a href="#l169">169</a><td>/**<tr><td><a id="l170"></a><a href="#l170">170</a><td> * Converts an object to its JSON representation in the WebDriver wire protocol.<tr><td><a id="l171"></a><a href="#l171">171</a><td> * When converting values of type object, the following steps will be taken:<tr><td><a id="l172"></a><a href="#l172">172</a><td> * &lt;ol&gt;<tr><td><a id="l173"></a><a href="#l173">173</a><td> * &lt;li&gt;if the object is a WebElement, the return value will be the element&#39;s<tr><td><a id="l174"></a><a href="#l174">174</a><td> *     server ID<tr><td><a id="l175"></a><a href="#l175">175</a><td> * &lt;li&gt;if the object is a Serializable, its<tr><td><a id="l176"></a><a href="#l176">176</a><td> *     {@link webdriver.Serializable#serialize} function will be invoked and<tr><td><a id="l177"></a><a href="#l177">177</a><td> *     this algorithm will recursively be applied to the result<tr><td><a id="l178"></a><a href="#l178">178</a><td> * &lt;li&gt;if the object provides a &quot;toJSON&quot; function, this algorithm will<tr><td><a id="l179"></a><a href="#l179">179</a><td> *     recursively be applied to the result of that function<tr><td><a id="l180"></a><a href="#l180">180</a><td> * &lt;li&gt;otherwise, the value of each key will be recursively converted according<tr><td><a id="l181"></a><a href="#l181">181</a><td> *     to the rules above.<tr><td><a id="l182"></a><a href="#l182">182</a><td> * &lt;/ol&gt;<tr><td><a id="l183"></a><a href="#l183">183</a><td> *<tr><td><a id="l184"></a><a href="#l184">184</a><td> * @param {*} obj The object to convert.<tr><td><a id="l185"></a><a href="#l185">185</a><td> * @return {!webdriver.promise.Promise.&lt;?&gt;} A promise that will resolve to the<tr><td><a id="l186"></a><a href="#l186">186</a><td> *     input value&#39;s JSON representation.<tr><td><a id="l187"></a><a href="#l187">187</a><td> * @private<tr><td><a id="l188"></a><a href="#l188">188</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol<tr><td><a id="l189"></a><a href="#l189">189</a><td> */<tr><td><a id="l190"></a><a href="#l190">190</a><td>webdriver.WebDriver.toWireValue_ = function(obj) {<tr><td><a id="l191"></a><a href="#l191">191</a><td>  if (webdriver.promise.isPromise(obj)) {<tr><td><a id="l192"></a><a href="#l192">192</a><td>    return obj.then(webdriver.WebDriver.toWireValue_);<tr><td><a id="l193"></a><a href="#l193">193</a><td>  }<tr><td><a id="l194"></a><a href="#l194">194</a><td>  return webdriver.promise.fulfilled(convertValue(obj));<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td>  function convertValue(value) {<tr><td><a id="l197"></a><a href="#l197">197</a><td>    switch (goog.typeOf(value)) {<tr><td><a id="l198"></a><a href="#l198">198</a><td>      case &#39;array&#39;:<tr><td><a id="l199"></a><a href="#l199">199</a><td>        return convertKeys(value, true);<tr><td><a id="l200"></a><a href="#l200">200</a><td>      case &#39;object&#39;:<tr><td><a id="l201"></a><a href="#l201">201</a><td>        // NB: WebElement is a Serializable, but we know its serialized form<tr><td><a id="l202"></a><a href="#l202">202</a><td>        // is a promise for its wire format. This is a micro optimization to<tr><td><a id="l203"></a><a href="#l203">203</a><td>        // avoid creating extra promises by recursing on the promised id.<tr><td><a id="l204"></a><a href="#l204">204</a><td>        if (value instanceof webdriver.WebElement) {<tr><td><a id="l205"></a><a href="#l205">205</a><td>          return value.getId();<tr><td><a id="l206"></a><a href="#l206">206</a><td>        }<tr><td><a id="l207"></a><a href="#l207">207</a><td>        if (value instanceof webdriver.Serializable) {<tr><td><a id="l208"></a><a href="#l208">208</a><td>          return webdriver.WebDriver.toWireValue_(value.serialize());<tr><td><a id="l209"></a><a href="#l209">209</a><td>        }<tr><td><a id="l210"></a><a href="#l210">210</a><td>        if (goog.isFunction(value.toJSON)) {<tr><td><a id="l211"></a><a href="#l211">211</a><td>          return webdriver.WebDriver.toWireValue_(value.toJSON());<tr><td><a id="l212"></a><a href="#l212">212</a><td>        }<tr><td><a id="l213"></a><a href="#l213">213</a><td>        if (goog.isNumber(value.nodeType) &amp;&amp; goog.isString(value.nodeName)) {<tr><td><a id="l214"></a><a href="#l214">214</a><td>          throw new TypeError(<tr><td><a id="l215"></a><a href="#l215">215</a><td>              &#39;Invalid argument type: &#39; + value.nodeName +<tr><td><a id="l216"></a><a href="#l216">216</a><td>              &#39;(&#39; + value.nodeType + &#39;)&#39;);<tr><td><a id="l217"></a><a href="#l217">217</a><td>        }<tr><td><a id="l218"></a><a href="#l218">218</a><td>        return convertKeys(value, false);<tr><td><a id="l219"></a><a href="#l219">219</a><td>      case &#39;function&#39;:<tr><td><a id="l220"></a><a href="#l220">220</a><td>        return &#39;&#39; + value;<tr><td><a id="l221"></a><a href="#l221">221</a><td>      case &#39;undefined&#39;:<tr><td><a id="l222"></a><a href="#l222">222</a><td>        return null;<tr><td><a id="l223"></a><a href="#l223">223</a><td>      default:<tr><td><a id="l224"></a><a href="#l224">224</a><td>        return value;<tr><td><a id="l225"></a><a href="#l225">225</a><td>    }<tr><td><a id="l226"></a><a href="#l226">226</a><td>  }<tr><td><a id="l227"></a><a href="#l227">227</a><td><tr><td><a id="l228"></a><a href="#l228">228</a><td>  function convertKeys(obj, isArray) {<tr><td><a id="l229"></a><a href="#l229">229</a><td>    var numKeys = isArray ? obj.length : goog.object.getCount(obj);<tr><td><a id="l230"></a><a href="#l230">230</a><td>    var ret = isArray ? new Array(numKeys) : {};<tr><td><a id="l231"></a><a href="#l231">231</a><td>    if (!numKeys) {<tr><td><a id="l232"></a><a href="#l232">232</a><td>      return webdriver.promise.fulfilled(ret);<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>    var numResolved = 0;<tr><td><a id="l236"></a><a href="#l236">236</a><td>    var done = webdriver.promise.defer();<tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>    // forEach will stop iteration at undefined, where we want to convert<tr><td><a id="l239"></a><a href="#l239">239</a><td>    // these to null and keep iterating.<tr><td><a id="l240"></a><a href="#l240">240</a><td>    var forEachKey = !isArray ? goog.object.forEach : function(arr, fn) {<tr><td><a id="l241"></a><a href="#l241">241</a><td>      var n = arr.length;<tr><td><a id="l242"></a><a href="#l242">242</a><td>      for (var i = 0; i &lt; n; i++) {<tr><td><a id="l243"></a><a href="#l243">243</a><td>        fn(arr[i], i);<tr><td><a id="l244"></a><a href="#l244">244</a><td>      }<tr><td><a id="l245"></a><a href="#l245">245</a><td>    };<tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>    forEachKey(obj, function(value, key) {<tr><td><a id="l248"></a><a href="#l248">248</a><td>      if (webdriver.promise.isPromise(value)) {<tr><td><a id="l249"></a><a href="#l249">249</a><td>        value.then(webdriver.WebDriver.toWireValue_).<tr><td><a id="l250"></a><a href="#l250">250</a><td>            then(setValue, done.reject);<tr><td><a id="l251"></a><a href="#l251">251</a><td>      } else {<tr><td><a id="l252"></a><a href="#l252">252</a><td>        webdriver.promise.asap(convertValue(value), setValue, done.reject);<tr><td><a id="l253"></a><a href="#l253">253</a><td>      }<tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>      function setValue(value) {<tr><td><a id="l256"></a><a href="#l256">256</a><td>        ret[key] = value;<tr><td><a id="l257"></a><a href="#l257">257</a><td>        maybeFulfill();<tr><td><a id="l258"></a><a href="#l258">258</a><td>      }<tr><td><a id="l259"></a><a href="#l259">259</a><td>    });<tr><td><a id="l260"></a><a href="#l260">260</a><td><tr><td><a id="l261"></a><a href="#l261">261</a><td>    return done.promise;<tr><td><a id="l262"></a><a href="#l262">262</a><td><tr><td><a id="l263"></a><a href="#l263">263</a><td>    function maybeFulfill() {<tr><td><a id="l264"></a><a href="#l264">264</a><td>      if (++numResolved === numKeys) {<tr><td><a id="l265"></a><a href="#l265">265</a><td>        done.fulfill(ret);<tr><td><a id="l266"></a><a href="#l266">266</a><td>      }<tr><td><a id="l267"></a><a href="#l267">267</a><td>    }<tr><td><a id="l268"></a><a href="#l268">268</a><td>  }<tr><td><a id="l269"></a><a href="#l269">269</a><td>};<tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td><tr><td><a id="l272"></a><a href="#l272">272</a><td>/**<tr><td><a id="l273"></a><a href="#l273">273</a><td> * Converts a value from its JSON representation according to the WebDriver wire<tr><td><a id="l274"></a><a href="#l274">274</a><td> * protocol. Any JSON object containing a<tr><td><a id="l275"></a><a href="#l275">275</a><td> * {@code webdriver.WebElement.ELEMENT_KEY} key will be decoded to a<tr><td><a id="l276"></a><a href="#l276">276</a><td> * {@code webdriver.WebElement} object. All other values will be passed through<tr><td><a id="l277"></a><a href="#l277">277</a><td> * as is.<tr><td><a id="l278"></a><a href="#l278">278</a><td> * @param {!webdriver.WebDriver} driver The driver instance to use as the<tr><td><a id="l279"></a><a href="#l279">279</a><td> *     parent of any unwrapped {@code webdriver.WebElement} values.<tr><td><a id="l280"></a><a href="#l280">280</a><td> * @param {*} value The value to convert.<tr><td><a id="l281"></a><a href="#l281">281</a><td> * @return {*} The converted value.<tr><td><a id="l282"></a><a href="#l282">282</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol<tr><td><a id="l283"></a><a href="#l283">283</a><td> * @private<tr><td><a id="l284"></a><a href="#l284">284</a><td> */<tr><td><a id="l285"></a><a href="#l285">285</a><td>webdriver.WebDriver.fromWireValue_ = function(driver, value) {<tr><td><a id="l286"></a><a href="#l286">286</a><td>  if (goog.isArray(value)) {<tr><td><a id="l287"></a><a href="#l287">287</a><td>    value = goog.array.map(/**@type {goog.array.ArrayLike}*/ (value),<tr><td><a id="l288"></a><a href="#l288">288</a><td>        goog.partial(webdriver.WebDriver.fromWireValue_, driver));<tr><td><a id="l289"></a><a href="#l289">289</a><td>  } else if (value &amp;&amp; goog.isObject(value) &amp;&amp; !goog.isFunction(value)) {<tr><td><a id="l290"></a><a href="#l290">290</a><td>    if (webdriver.WebElement.ELEMENT_KEY in value) {<tr><td><a id="l291"></a><a href="#l291">291</a><td>      value = new webdriver.WebElement(driver, value);<tr><td><a id="l292"></a><a href="#l292">292</a><td>    } else {<tr><td><a id="l293"></a><a href="#l293">293</a><td>      value = goog.object.map(/**@type {!Object}*/ (value),<tr><td><a id="l294"></a><a href="#l294">294</a><td>          goog.partial(webdriver.WebDriver.fromWireValue_, driver));<tr><td><a id="l295"></a><a href="#l295">295</a><td>    }<tr><td><a id="l296"></a><a href="#l296">296</a><td>  }<tr><td><a id="l297"></a><a href="#l297">297</a><td>  return value;<tr><td><a id="l298"></a><a href="#l298">298</a><td>};<tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td><tr><td><a id="l301"></a><a href="#l301">301</a><td>/**<tr><td><a id="l302"></a><a href="#l302">302</a><td> * Translates a command to its wire-protocol representation before passing it<tr><td><a id="l303"></a><a href="#l303">303</a><td> * to the given {@code executor} for execution.<tr><td><a id="l304"></a><a href="#l304">304</a><td> * @param {!webdriver.CommandExecutor} executor The executor to use.<tr><td><a id="l305"></a><a href="#l305">305</a><td> * @param {!webdriver.Command} command The command to execute.<tr><td><a id="l306"></a><a href="#l306">306</a><td> * @return {!webdriver.promise.Promise} A promise that will resolve with the<tr><td><a id="l307"></a><a href="#l307">307</a><td> *     command response.<tr><td><a id="l308"></a><a href="#l308">308</a><td> * @private<tr><td><a id="l309"></a><a href="#l309">309</a><td> */<tr><td><a id="l310"></a><a href="#l310">310</a><td>webdriver.WebDriver.executeCommand_ = function(executor, command) {<tr><td><a id="l311"></a><a href="#l311">311</a><td>  return webdriver.WebDriver.toWireValue_(command.getParameters()).<tr><td><a id="l312"></a><a href="#l312">312</a><td>      then(function(parameters) {<tr><td><a id="l313"></a><a href="#l313">313</a><td>        command.setParameters(parameters);<tr><td><a id="l314"></a><a href="#l314">314</a><td>        return webdriver.promise.checkedNodeCall(<tr><td><a id="l315"></a><a href="#l315">315</a><td>            goog.bind(executor.execute, executor, command));<tr><td><a id="l316"></a><a href="#l316">316</a><td>      });<tr><td><a id="l317"></a><a href="#l317">317</a><td>};<tr><td><a id="l318"></a><a href="#l318">318</a><td><tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>/**<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @return {!webdriver.promise.ControlFlow} The control flow used by this<tr><td><a id="l322"></a><a href="#l322">322</a><td> *     instance.<tr><td><a id="l323"></a><a href="#l323">323</a><td> */<tr><td><a id="l324"></a><a href="#l324">324</a><td>webdriver.WebDriver.prototype.controlFlow = function() {<tr><td><a id="l325"></a><a href="#l325">325</a><td>  return this.flow_;<tr><td><a id="l326"></a><a href="#l326">326</a><td>};<tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td><tr><td><a id="l329"></a><a href="#l329">329</a><td>/**<tr><td><a id="l330"></a><a href="#l330">330</a><td> * Schedules a {@code webdriver.Command} to be executed by this driver&#39;s<tr><td><a id="l331"></a><a href="#l331">331</a><td> * {@code webdriver.CommandExecutor}.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @param {!webdriver.Command} command The command to schedule.<tr><td><a id="l333"></a><a href="#l333">333</a><td> * @param {string} description A description of the command for debugging.<tr><td><a id="l334"></a><a href="#l334">334</a><td> * @return {!webdriver.promise.Promise.&lt;T&gt;} A promise that will be resolved<tr><td><a id="l335"></a><a href="#l335">335</a><td> *     with the command result.<tr><td><a id="l336"></a><a href="#l336">336</a><td> * @template T<tr><td><a id="l337"></a><a href="#l337">337</a><td> */<tr><td><a id="l338"></a><a href="#l338">338</a><td>webdriver.WebDriver.prototype.schedule = function(command, description) {<tr><td><a id="l339"></a><a href="#l339">339</a><td>  var self = this;<tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td>  checkHasNotQuit();<tr><td><a id="l342"></a><a href="#l342">342</a><td>  command.setParameter(&#39;sessionId&#39;, this.session_);<tr><td><a id="l343"></a><a href="#l343">343</a><td><tr><td><a id="l344"></a><a href="#l344">344</a><td>  // If any of the command parameters are rejected promises, those<tr><td><a id="l345"></a><a href="#l345">345</a><td>  // rejections may be reported as unhandled before the control flow<tr><td><a id="l346"></a><a href="#l346">346</a><td>  // attempts to execute the command. To ensure parameters errors<tr><td><a id="l347"></a><a href="#l347">347</a><td>  // propagate through the command itself, we resolve all of the<tr><td><a id="l348"></a><a href="#l348">348</a><td>  // command parameters now, but suppress any errors until the ControlFlow<tr><td><a id="l349"></a><a href="#l349">349</a><td>  // actually executes the command. This addresses scenarios like catching<tr><td><a id="l350"></a><a href="#l350">350</a><td>  // an element not found error in:<tr><td><a id="l351"></a><a href="#l351">351</a><td>  //<tr><td><a id="l352"></a><a href="#l352">352</a><td>  //     driver.findElement(By.id(&#39;foo&#39;)).click().thenCatch(function(e) {<tr><td><a id="l353"></a><a href="#l353">353</a><td>  //       if (e.code === bot.ErrorCode.NO_SUCH_ELEMENT) {<tr><td><a id="l354"></a><a href="#l354">354</a><td>  //         // Do something.<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>  var prepCommand = webdriver.WebDriver.toWireValue_(command.getParameters());<tr><td><a id="l358"></a><a href="#l358">358</a><td>  prepCommand.thenCatch(goog.nullFunction);<tr><td><a id="l359"></a><a href="#l359">359</a><td><tr><td><a id="l360"></a><a href="#l360">360</a><td>  var flow = this.flow_;<tr><td><a id="l361"></a><a href="#l361">361</a><td>  var executor = this.executor_;<tr><td><a id="l362"></a><a href="#l362">362</a><td>  return flow.execute(function() {<tr><td><a id="l363"></a><a href="#l363">363</a><td>    // A call to WebDriver.quit() may have been scheduled in the same event<tr><td><a id="l364"></a><a href="#l364">364</a><td>    // loop as this |command|, which would prevent us from detecting that the<tr><td><a id="l365"></a><a href="#l365">365</a><td>    // driver has quit above.  Therefore, we need to make another quick check.<tr><td><a id="l366"></a><a href="#l366">366</a><td>    // We still check above so we can fail as early as possible.<tr><td><a id="l367"></a><a href="#l367">367</a><td>    checkHasNotQuit();<tr><td><a id="l368"></a><a href="#l368">368</a><td><tr><td><a id="l369"></a><a href="#l369">369</a><td>    // Retrieve resolved command parameters; any previously suppressed errors<tr><td><a id="l370"></a><a href="#l370">370</a><td>    // will now propagate up through the control flow as part of the command<tr><td><a id="l371"></a><a href="#l371">371</a><td>    // execution.<tr><td><a id="l372"></a><a href="#l372">372</a><td>    return prepCommand.then(function(parameters) {<tr><td><a id="l373"></a><a href="#l373">373</a><td>      command.setParameters(parameters);<tr><td><a id="l374"></a><a href="#l374">374</a><td>      return webdriver.promise.checkedNodeCall(<tr><td><a id="l375"></a><a href="#l375">375</a><td>          goog.bind(executor.execute, executor, command));<tr><td><a id="l376"></a><a href="#l376">376</a><td>    });<tr><td><a id="l377"></a><a href="#l377">377</a><td>  }, description).then(function(response) {<tr><td><a id="l378"></a><a href="#l378">378</a><td>    try {<tr><td><a id="l379"></a><a href="#l379">379</a><td>      bot.response.checkResponse(response);<tr><td><a id="l380"></a><a href="#l380">380</a><td>    } catch (ex) {<tr><td><a id="l381"></a><a href="#l381">381</a><td>      var value = response[&#39;value&#39;];<tr><td><a id="l382"></a><a href="#l382">382</a><td>      if (ex.code === bot.ErrorCode.UNEXPECTED_ALERT_OPEN) {<tr><td><a id="l383"></a><a href="#l383">383</a><td>        var text = value &amp;&amp; value[&#39;alert&#39;] ? value[&#39;alert&#39;][&#39;text&#39;] : &#39;&#39;;<tr><td><a id="l384"></a><a href="#l384">384</a><td>        throw new webdriver.UnhandledAlertError(ex.message, text,<tr><td><a id="l385"></a><a href="#l385">385</a><td>            new webdriver.Alert(self, text));<tr><td><a id="l386"></a><a href="#l386">386</a><td>      }<tr><td><a id="l387"></a><a href="#l387">387</a><td>      throw ex;<tr><td><a id="l388"></a><a href="#l388">388</a><td>    }<tr><td><a id="l389"></a><a href="#l389">389</a><td>    return webdriver.WebDriver.fromWireValue_(self, response[&#39;value&#39;]);<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>  function checkHasNotQuit() {<tr><td><a id="l393"></a><a href="#l393">393</a><td>    if (!self.session_) {<tr><td><a id="l394"></a><a href="#l394">394</a><td>      throw new Error(&#39;This driver instance does not have a valid session ID &#39; +<tr><td><a id="l395"></a><a href="#l395">395</a><td>                      &#39;(did you call WebDriver.quit()?) and may no longer be &#39; +<tr><td><a id="l396"></a><a href="#l396">396</a><td>                      &#39;used.&#39;);<tr><td><a id="l397"></a><a href="#l397">397</a><td>    }<tr><td><a id="l398"></a><a href="#l398">398</a><td>  }<tr><td><a id="l399"></a><a href="#l399">399</a><td>};<tr><td><a id="l400"></a><a href="#l400">400</a><td><tr><td><a id="l401"></a><a href="#l401">401</a><td><tr><td><a id="l402"></a><a href="#l402">402</a><td>/**<tr><td><a id="l403"></a><a href="#l403">403</a><td> * Sets the {@linkplain webdriver.FileDetector file detector} that should be<tr><td><a id="l404"></a><a href="#l404">404</a><td> * used with this instance.<tr><td><a id="l405"></a><a href="#l405">405</a><td> * @param {webdriver.FileDetector} detector The detector to use or {@code null}.<tr><td><a id="l406"></a><a href="#l406">406</a><td> */<tr><td><a id="l407"></a><a href="#l407">407</a><td>webdriver.WebDriver.prototype.setFileDetector = function(detector) {<tr><td><a id="l408"></a><a href="#l408">408</a><td>  this.fileDetector_ = detector;<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><tr><td><a id="l412"></a><a href="#l412">412</a><td>// ----------------------------------------------------------------------------<tr><td><a id="l413"></a><a href="#l413">413</a><td>// Client command functions:<tr><td><a id="l414"></a><a href="#l414">414</a><td>// ----------------------------------------------------------------------------<tr><td><a id="l415"></a><a href="#l415">415</a><td><tr><td><a id="l416"></a><a href="#l416">416</a><td><tr><td><a id="l417"></a><a href="#l417">417</a><td>/**<tr><td><a id="l418"></a><a href="#l418">418</a><td> * @return {!webdriver.promise.Promise.&lt;!webdriver.Session&gt;} A promise for this<tr><td><a id="l419"></a><a href="#l419">419</a><td> *     client&#39;s session.<tr><td><a id="l420"></a><a href="#l420">420</a><td> */<tr><td><a id="l421"></a><a href="#l421">421</a><td>webdriver.WebDriver.prototype.getSession = function() {<tr><td><a id="l422"></a><a href="#l422">422</a><td>  return webdriver.promise.when(this.session_);<tr><td><a id="l423"></a><a href="#l423">423</a><td>};<tr><td><a id="l424"></a><a href="#l424">424</a><td><tr><td><a id="l425"></a><a href="#l425">425</a><td><tr><td><a id="l426"></a><a href="#l426">426</a><td>/**<tr><td><a id="l427"></a><a href="#l427">427</a><td> * @return {!webdriver.promise.Promise.&lt;!webdriver.Capabilities&gt;} A promise<tr><td><a id="l428"></a><a href="#l428">428</a><td> *     that will resolve with the this instance&#39;s capabilities.<tr><td><a id="l429"></a><a href="#l429">429</a><td> */<tr><td><a id="l430"></a><a href="#l430">430</a><td>webdriver.WebDriver.prototype.getCapabilities = function() {<tr><td><a id="l431"></a><a href="#l431">431</a><td>  return webdriver.promise.when(this.session_, function(session) {<tr><td><a id="l432"></a><a href="#l432">432</a><td>    return session.getCapabilities();<tr><td><a id="l433"></a><a href="#l433">433</a><td>  });<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> * Schedules a command to quit the current session. After calling quit, this<tr><td><a id="l439"></a><a href="#l439">439</a><td> * instance will be invalidated and may no longer be used to issue commands<tr><td><a id="l440"></a><a href="#l440">440</a><td> * against the browser.<tr><td><a id="l441"></a><a href="#l441">441</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l442"></a><a href="#l442">442</a><td> *     when the command has completed.<tr><td><a id="l443"></a><a href="#l443">443</a><td> */<tr><td><a id="l444"></a><a href="#l444">444</a><td>webdriver.WebDriver.prototype.quit = function() {<tr><td><a id="l445"></a><a href="#l445">445</a><td>  var result = this.schedule(<tr><td><a id="l446"></a><a href="#l446">446</a><td>      new webdriver.Command(webdriver.CommandName.QUIT),<tr><td><a id="l447"></a><a href="#l447">447</a><td>      &#39;WebDriver.quit()&#39;);<tr><td><a id="l448"></a><a href="#l448">448</a><td>  // Delete our session ID when the quit command finishes; this will allow us to<tr><td><a id="l449"></a><a href="#l449">449</a><td>  // throw an error when attemnpting to use a driver post-quit.<tr><td><a id="l450"></a><a href="#l450">450</a><td>  return result.thenFinally(goog.bind(function() {<tr><td><a id="l451"></a><a href="#l451">451</a><td>    delete this.session_;<tr><td><a id="l452"></a><a href="#l452">452</a><td>  }, this));<tr><td><a id="l453"></a><a href="#l453">453</a><td>};<tr><td><a id="l454"></a><a href="#l454">454</a><td><tr><td><a id="l455"></a><a href="#l455">455</a><td><tr><td><a id="l456"></a><a href="#l456">456</a><td>/**<tr><td><a id="l457"></a><a href="#l457">457</a><td> * Creates a new action sequence using this driver. The sequence will not be<tr><td><a id="l458"></a><a href="#l458">458</a><td> * scheduled for execution until {@link webdriver.ActionSequence#perform} is<tr><td><a id="l459"></a><a href="#l459">459</a><td> * called. Example:<tr><td><a id="l460"></a><a href="#l460">460</a><td> *<tr><td><a id="l461"></a><a href="#l461">461</a><td> *     driver.actions().<tr><td><a id="l462"></a><a href="#l462">462</a><td> *         mouseDown(element1).<tr><td><a id="l463"></a><a href="#l463">463</a><td> *         mouseMove(element2).<tr><td><a id="l464"></a><a href="#l464">464</a><td> *         mouseUp().<tr><td><a id="l465"></a><a href="#l465">465</a><td> *         perform();<tr><td><a id="l466"></a><a href="#l466">466</a><td> *<tr><td><a id="l467"></a><a href="#l467">467</a><td> * @return {!webdriver.ActionSequence} A new action sequence for this instance.<tr><td><a id="l468"></a><a href="#l468">468</a><td> */<tr><td><a id="l469"></a><a href="#l469">469</a><td>webdriver.WebDriver.prototype.actions = function() {<tr><td><a id="l470"></a><a href="#l470">470</a><td>  return new webdriver.ActionSequence(this);<tr><td><a id="l471"></a><a href="#l471">471</a><td>};<tr><td><a id="l472"></a><a href="#l472">472</a><td><tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td>/**<tr><td><a id="l475"></a><a href="#l475">475</a><td> * Creates a new touch sequence using this driver. The sequence will not be<tr><td><a id="l476"></a><a href="#l476">476</a><td> * scheduled for execution until {@link webdriver.TouchSequence#perform} is<tr><td><a id="l477"></a><a href="#l477">477</a><td> * called. Example:<tr><td><a id="l478"></a><a href="#l478">478</a><td> *<tr><td><a id="l479"></a><a href="#l479">479</a><td> *     driver.touchActions().<tr><td><a id="l480"></a><a href="#l480">480</a><td> *         tap(element1).<tr><td><a id="l481"></a><a href="#l481">481</a><td> *         doubleTap(element2).<tr><td><a id="l482"></a><a href="#l482">482</a><td> *         perform();<tr><td><a id="l483"></a><a href="#l483">483</a><td> *<tr><td><a id="l484"></a><a href="#l484">484</a><td> * @return {!webdriver.TouchSequence} A new touch sequence for this instance.<tr><td><a id="l485"></a><a href="#l485">485</a><td> */<tr><td><a id="l486"></a><a href="#l486">486</a><td>webdriver.WebDriver.prototype.touchActions = function() {<tr><td><a id="l487"></a><a href="#l487">487</a><td>  return new webdriver.TouchSequence(this);<tr><td><a id="l488"></a><a href="#l488">488</a><td>};<tr><td><a id="l489"></a><a href="#l489">489</a><td><tr><td><a id="l490"></a><a href="#l490">490</a><td><tr><td><a id="l491"></a><a href="#l491">491</a><td>/**<tr><td><a id="l492"></a><a href="#l492">492</a><td> * Schedules a command to execute JavaScript in the context of the currently<tr><td><a id="l493"></a><a href="#l493">493</a><td> * selected frame or window. The script fragment will be executed as the body<tr><td><a id="l494"></a><a href="#l494">494</a><td> * of an anonymous function. If the script is provided as a function object,<tr><td><a id="l495"></a><a href="#l495">495</a><td> * that function will be converted to a string for injection into the target<tr><td><a id="l496"></a><a href="#l496">496</a><td> * window.<tr><td><a id="l497"></a><a href="#l497">497</a><td> *<tr><td><a id="l498"></a><a href="#l498">498</a><td> * Any arguments provided in addition to the script will be included as script<tr><td><a id="l499"></a><a href="#l499">499</a><td> * arguments and may be referenced using the {@code arguments} object.<tr><td><a id="l500"></a><a href="#l500">500</a><td> * Arguments may be a boolean, number, string, or {@code webdriver.WebElement}.<tr><td><a id="l501"></a><a href="#l501">501</a><td> * Arrays and objects may also be used as script arguments as long as each item<tr><td><a id="l502"></a><a href="#l502">502</a><td> * adheres to the types previously mentioned.<tr><td><a id="l503"></a><a href="#l503">503</a><td> *<tr><td><a id="l504"></a><a href="#l504">504</a><td> * The script may refer to any variables accessible from the current window.<tr><td><a id="l505"></a><a href="#l505">505</a><td> * Furthermore, the script will execute in the window&#39;s context, thus<tr><td><a id="l506"></a><a href="#l506">506</a><td> * {@code document} may be used to refer to the current document. Any local<tr><td><a id="l507"></a><a href="#l507">507</a><td> * variables will not be available once the script has finished executing,<tr><td><a id="l508"></a><a href="#l508">508</a><td> * though global variables will persist.<tr><td><a id="l509"></a><a href="#l509">509</a><td> *<tr><td><a id="l510"></a><a href="#l510">510</a><td> * If the script has a return value (i.e. if the script contains a return<tr><td><a id="l511"></a><a href="#l511">511</a><td> * statement), then the following steps will be taken for resolving this<tr><td><a id="l512"></a><a href="#l512">512</a><td> * functions return value:<tr><td><a id="l513"></a><a href="#l513">513</a><td> *<tr><td><a id="l514"></a><a href="#l514">514</a><td> * - For a HTML element, the value will resolve to a<tr><td><a id="l515"></a><a href="#l515">515</a><td> *     {@link webdriver.WebElement}<tr><td><a id="l516"></a><a href="#l516">516</a><td> * - Null and undefined return values will resolve to null&lt;/li&gt;<tr><td><a id="l517"></a><a href="#l517">517</a><td> * - Booleans, numbers, and strings will resolve as is&lt;/li&gt;<tr><td><a id="l518"></a><a href="#l518">518</a><td> * - Functions will resolve to their string representation&lt;/li&gt;<tr><td><a id="l519"></a><a href="#l519">519</a><td> * - For arrays and objects, each member item will be converted according to<tr><td><a id="l520"></a><a href="#l520">520</a><td> *     the rules above<tr><td><a id="l521"></a><a href="#l521">521</a><td> *<tr><td><a id="l522"></a><a href="#l522">522</a><td> * @param {!(string|Function)} script The script to execute.<tr><td><a id="l523"></a><a href="#l523">523</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a id="l524"></a><a href="#l524">524</a><td> * @return {!webdriver.promise.Promise.&lt;T&gt;} A promise that will resolve to the<tr><td><a id="l525"></a><a href="#l525">525</a><td> *    scripts return value.<tr><td><a id="l526"></a><a href="#l526">526</a><td> * @template T<tr><td><a id="l527"></a><a href="#l527">527</a><td> */<tr><td><a id="l528"></a><a href="#l528">528</a><td>webdriver.WebDriver.prototype.executeScript = function(script, var_args) {<tr><td><a id="l529"></a><a href="#l529">529</a><td>  if (goog.isFunction(script)) {<tr><td><a id="l530"></a><a href="#l530">530</a><td>    script = &#39;return (&#39; + script + &#39;).apply(null, arguments);&#39;;<tr><td><a id="l531"></a><a href="#l531">531</a><td>  }<tr><td><a id="l532"></a><a href="#l532">532</a><td>  var args = arguments.length &gt; 1 ? goog.array.slice(arguments, 1) : [];<tr><td><a id="l533"></a><a href="#l533">533</a><td>  return this.schedule(<tr><td><a id="l534"></a><a href="#l534">534</a><td>      new webdriver.Command(webdriver.CommandName.EXECUTE_SCRIPT).<tr><td><a id="l535"></a><a href="#l535">535</a><td>          setParameter(&#39;script&#39;, script).<tr><td><a id="l536"></a><a href="#l536">536</a><td>          setParameter(&#39;args&#39;, args),<tr><td><a id="l537"></a><a href="#l537">537</a><td>      &#39;WebDriver.executeScript()&#39;);<tr><td><a id="l538"></a><a href="#l538">538</a><td>};<tr><td><a id="l539"></a><a href="#l539">539</a><td><tr><td><a id="l540"></a><a href="#l540">540</a><td><tr><td><a id="l541"></a><a href="#l541">541</a><td>/**<tr><td><a id="l542"></a><a href="#l542">542</a><td> * Schedules a command to execute asynchronous JavaScript in the context of the<tr><td><a id="l543"></a><a href="#l543">543</a><td> * currently selected frame or window. The script fragment will be executed as<tr><td><a id="l544"></a><a href="#l544">544</a><td> * the body of an anonymous function. If the script is provided as a function<tr><td><a id="l545"></a><a href="#l545">545</a><td> * object, that function will be converted to a string for injection into the<tr><td><a id="l546"></a><a href="#l546">546</a><td> * target window.<tr><td><a id="l547"></a><a href="#l547">547</a><td> *<tr><td><a id="l548"></a><a href="#l548">548</a><td> * Any arguments provided in addition to the script will be included as script<tr><td><a id="l549"></a><a href="#l549">549</a><td> * arguments and may be referenced using the {@code arguments} object.<tr><td><a id="l550"></a><a href="#l550">550</a><td> * Arguments may be a boolean, number, string, or {@code webdriver.WebElement}.<tr><td><a id="l551"></a><a href="#l551">551</a><td> * Arrays and objects may also be used as script arguments as long as each item<tr><td><a id="l552"></a><a href="#l552">552</a><td> * adheres to the types previously mentioned.<tr><td><a id="l553"></a><a href="#l553">553</a><td> *<tr><td><a id="l554"></a><a href="#l554">554</a><td> * Unlike executing synchronous JavaScript with {@link #executeScript},<tr><td><a id="l555"></a><a href="#l555">555</a><td> * scripts executed with this function must explicitly signal they are finished<tr><td><a id="l556"></a><a href="#l556">556</a><td> * by invoking the provided callback. This callback will always be injected<tr><td><a id="l557"></a><a href="#l557">557</a><td> * into the executed function as the last argument, and thus may be referenced<tr><td><a id="l558"></a><a href="#l558">558</a><td> * with {@code arguments[arguments.length - 1]}. The following steps will be<tr><td><a id="l559"></a><a href="#l559">559</a><td> * taken for resolving this functions return value against the first argument<tr><td><a id="l560"></a><a href="#l560">560</a><td> * to the script&#39;s callback function:<tr><td><a id="l561"></a><a href="#l561">561</a><td> *<tr><td><a id="l562"></a><a href="#l562">562</a><td> * - For a HTML element, the value will resolve to a<tr><td><a id="l563"></a><a href="#l563">563</a><td> *     {@link webdriver.WebElement}<tr><td><a id="l564"></a><a href="#l564">564</a><td> * - Null and undefined return values will resolve to null<tr><td><a id="l565"></a><a href="#l565">565</a><td> * - Booleans, numbers, and strings will resolve as is<tr><td><a id="l566"></a><a href="#l566">566</a><td> * - Functions will resolve to their string representation<tr><td><a id="l567"></a><a href="#l567">567</a><td> * - For arrays and objects, each member item will be converted according to<tr><td><a id="l568"></a><a href="#l568">568</a><td> *     the rules above<tr><td><a id="l569"></a><a href="#l569">569</a><td> *<tr><td><a id="l570"></a><a href="#l570">570</a><td> * __Example #1:__ Performing a sleep that is synchronized with the currently<tr><td><a id="l571"></a><a href="#l571">571</a><td> * selected window:<tr><td><a id="l572"></a><a href="#l572">572</a><td> *<tr><td><a id="l573"></a><a href="#l573">573</a><td> *     var start = new Date().getTime();<tr><td><a id="l574"></a><a href="#l574">574</a><td> *     driver.executeAsyncScript(<tr><td><a id="l575"></a><a href="#l575">575</a><td> *         &#39;window.setTimeout(arguments[arguments.length - 1], 500);&#39;).<tr><td><a id="l576"></a><a href="#l576">576</a><td> *         then(function() {<tr><td><a id="l577"></a><a href="#l577">577</a><td> *           console.log(<tr><td><a id="l578"></a><a href="#l578">578</a><td> *               &#39;Elapsed time: &#39; + (new Date().getTime() - start) + &#39; ms&#39;);<tr><td><a id="l579"></a><a href="#l579">579</a><td> *         });<tr><td><a id="l580"></a><a href="#l580">580</a><td> *<tr><td><a id="l581"></a><a href="#l581">581</a><td> * __Example #2:__ Synchronizing a test with an AJAX application:<tr><td><a id="l582"></a><a href="#l582">582</a><td> *<tr><td><a id="l583"></a><a href="#l583">583</a><td> *     var button = driver.findElement(By.id(&#39;compose-button&#39;));<tr><td><a id="l584"></a><a href="#l584">584</a><td> *     button.click();<tr><td><a id="l585"></a><a href="#l585">585</a><td> *     driver.executeAsyncScript(<tr><td><a id="l586"></a><a href="#l586">586</a><td> *         &#39;var callback = arguments[arguments.length - 1];&#39; +<tr><td><a id="l587"></a><a href="#l587">587</a><td> *         &#39;mailClient.getComposeWindowWidget().onload(callback);&#39;);<tr><td><a id="l588"></a><a href="#l588">588</a><td> *     driver.switchTo().frame(&#39;composeWidget&#39;);<tr><td><a id="l589"></a><a href="#l589">589</a><td> *     driver.findElement(By.id(&#39;to&#39;)).sendKeys(&#39;dog@example.com&#39;);<tr><td><a id="l590"></a><a href="#l590">590</a><td> *<tr><td><a id="l591"></a><a href="#l591">591</a><td> * __Example #3:__ Injecting a XMLHttpRequest and waiting for the result. In<tr><td><a id="l592"></a><a href="#l592">592</a><td> * this example, the inject script is specified with a function literal. When<tr><td><a id="l593"></a><a href="#l593">593</a><td> * using this format, the function is converted to a string for injection, so it<tr><td><a id="l594"></a><a href="#l594">594</a><td> * should not reference any symbols not defined in the scope of the page under<tr><td><a id="l595"></a><a href="#l595">595</a><td> * test.<tr><td><a id="l596"></a><a href="#l596">596</a><td> *<tr><td><a id="l597"></a><a href="#l597">597</a><td> *     driver.executeAsyncScript(function() {<tr><td><a id="l598"></a><a href="#l598">598</a><td> *       var callback = arguments[arguments.length - 1];<tr><td><a id="l599"></a><a href="#l599">599</a><td> *       var xhr = new XMLHttpRequest();<tr><td><a id="l600"></a><a href="#l600">600</a><td> *       xhr.open(&quot;GET&quot;, &quot;/resource/data.json&quot;, true);<tr><td><a id="l601"></a><a href="#l601">601</a><td> *       xhr.onreadystatechange = function() {<tr><td><a id="l602"></a><a href="#l602">602</a><td> *         if (xhr.readyState == 4) {<tr><td><a id="l603"></a><a href="#l603">603</a><td> *           callback(xhr.responseText);<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> *       xhr.send(&#39;&#39;);<tr><td><a id="l607"></a><a href="#l607">607</a><td> *     }).then(function(str) {<tr><td><a id="l608"></a><a href="#l608">608</a><td> *       console.log(JSON.parse(str)[&#39;food&#39;]);<tr><td><a id="l609"></a><a href="#l609">609</a><td> *     });<tr><td><a id="l610"></a><a href="#l610">610</a><td> *<tr><td><a id="l611"></a><a href="#l611">611</a><td> * @param {!(string|Function)} script The script to execute.<tr><td><a id="l612"></a><a href="#l612">612</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a id="l613"></a><a href="#l613">613</a><td> * @return {!webdriver.promise.Promise.&lt;T&gt;} A promise that will resolve to the<tr><td><a id="l614"></a><a href="#l614">614</a><td> *    scripts return value.<tr><td><a id="l615"></a><a href="#l615">615</a><td> * @template T<tr><td><a id="l616"></a><a href="#l616">616</a><td> */<tr><td><a id="l617"></a><a href="#l617">617</a><td>webdriver.WebDriver.prototype.executeAsyncScript = function(script, var_args) {<tr><td><a id="l618"></a><a href="#l618">618</a><td>  if (goog.isFunction(script)) {<tr><td><a id="l619"></a><a href="#l619">619</a><td>    script = &#39;return (&#39; + script + &#39;).apply(null, arguments);&#39;;<tr><td><a id="l620"></a><a href="#l620">620</a><td>  }<tr><td><a id="l621"></a><a href="#l621">621</a><td>  return this.schedule(<tr><td><a id="l622"></a><a href="#l622">622</a><td>      new webdriver.Command(webdriver.CommandName.EXECUTE_ASYNC_SCRIPT).<tr><td><a id="l623"></a><a href="#l623">623</a><td>          setParameter(&#39;script&#39;, script).<tr><td><a id="l624"></a><a href="#l624">624</a><td>          setParameter(&#39;args&#39;, goog.array.slice(arguments, 1)),<tr><td><a id="l625"></a><a href="#l625">625</a><td>      &#39;WebDriver.executeScript()&#39;);<tr><td><a id="l626"></a><a href="#l626">626</a><td>};<tr><td><a id="l627"></a><a href="#l627">627</a><td><tr><td><a id="l628"></a><a href="#l628">628</a><td><tr><td><a id="l629"></a><a href="#l629">629</a><td>/**<tr><td><a id="l630"></a><a href="#l630">630</a><td> * Schedules a command to execute a custom function.<tr><td><a id="l631"></a><a href="#l631">631</a><td> * @param {function(...): (T|webdriver.promise.Promise.&lt;T&gt;)} fn The function to<tr><td><a id="l632"></a><a href="#l632">632</a><td> *     execute.<tr><td><a id="l633"></a><a href="#l633">633</a><td> * @param {Object=} opt_scope The object in whose scope to execute the function.<tr><td><a id="l634"></a><a href="#l634">634</a><td> * @param {...*} var_args Any arguments to pass to the function.<tr><td><a id="l635"></a><a href="#l635">635</a><td> * @return {!webdriver.promise.Promise.&lt;T&gt;} A promise that will be resolved&#39;<tr><td><a id="l636"></a><a href="#l636">636</a><td> *     with the function&#39;s result.<tr><td><a id="l637"></a><a href="#l637">637</a><td> * @template T<tr><td><a id="l638"></a><a href="#l638">638</a><td> */<tr><td><a id="l639"></a><a href="#l639">639</a><td>webdriver.WebDriver.prototype.call = function(fn, opt_scope, var_args) {<tr><td><a id="l640"></a><a href="#l640">640</a><td>  var args = goog.array.slice(arguments, 2);<tr><td><a id="l641"></a><a href="#l641">641</a><td>  var flow = this.flow_;<tr><td><a id="l642"></a><a href="#l642">642</a><td>  return flow.execute(function() {<tr><td><a id="l643"></a><a href="#l643">643</a><td>    return webdriver.promise.fullyResolved(args).then(function(args) {<tr><td><a id="l644"></a><a href="#l644">644</a><td>      if (webdriver.promise.isGenerator(fn)) {<tr><td><a id="l645"></a><a href="#l645">645</a><td>        args.unshift(fn, opt_scope);<tr><td><a id="l646"></a><a href="#l646">646</a><td>        return webdriver.promise.consume.apply(null, args);<tr><td><a id="l647"></a><a href="#l647">647</a><td>      }<tr><td><a id="l648"></a><a href="#l648">648</a><td>      return fn.apply(opt_scope, args);<tr><td><a id="l649"></a><a href="#l649">649</a><td>    });<tr><td><a id="l650"></a><a href="#l650">650</a><td>  }, &#39;WebDriver.call(&#39; + (fn.name || &#39;function&#39;) + &#39;)&#39;);<tr><td><a id="l651"></a><a href="#l651">651</a><td>};<tr><td><a id="l652"></a><a href="#l652">652</a><td><tr><td><a id="l653"></a><a href="#l653">653</a><td><tr><td><a id="l654"></a><a href="#l654">654</a><td>/**<tr><td><a id="l655"></a><a href="#l655">655</a><td> * Schedules a command to wait for a condition to hold. The condition may be<tr><td><a id="l656"></a><a href="#l656">656</a><td> * specified by a {@link webdriver.until.Condition}, as a custom function, or<tr><td><a id="l657"></a><a href="#l657">657</a><td> * as a {@link webdriver.promise.Promise}.<tr><td><a id="l658"></a><a href="#l658">658</a><td> *<tr><td><a id="l659"></a><a href="#l659">659</a><td> * For a {@link webdriver.until.Condition} or function, the wait will repeatedly<tr><td><a id="l660"></a><a href="#l660">660</a><td> * evaluate the condition until it returns a truthy value. If any errors occur<tr><td><a id="l661"></a><a href="#l661">661</a><td> * while evaluating the condition, they will be allowed to propagate. In the<tr><td><a id="l662"></a><a href="#l662">662</a><td> * event a condition returns a {@link webdriver.promise.Promise promise}, the<tr><td><a id="l663"></a><a href="#l663">663</a><td> * polling loop will wait for it to be resolved and use the resolved value for<tr><td><a id="l664"></a><a href="#l664">664</a><td> * whether the condition has been satisified. Note the resolution time for<tr><td><a id="l665"></a><a href="#l665">665</a><td> * a promise is factored into whether a wait has timed out.<tr><td><a id="l666"></a><a href="#l666">666</a><td> *<tr><td><a id="l667"></a><a href="#l667">667</a><td> * *Example:* waiting up to 10 seconds for an element to be present and visible<tr><td><a id="l668"></a><a href="#l668">668</a><td> * on the page.<tr><td><a id="l669"></a><a href="#l669">669</a><td> *<tr><td><a id="l670"></a><a href="#l670">670</a><td> *     var button = driver.wait(until.elementLocated(By.id(&#39;foo&#39;)), 10000);<tr><td><a id="l671"></a><a href="#l671">671</a><td> *     button.click();<tr><td><a id="l672"></a><a href="#l672">672</a><td> *<tr><td><a id="l673"></a><a href="#l673">673</a><td> * This function may also be used to block the command flow on the resolution<tr><td><a id="l674"></a><a href="#l674">674</a><td> * of a {@link webdriver.promise.Promise promise}. When given a promise, the<tr><td><a id="l675"></a><a href="#l675">675</a><td> * command will simply wait for its resolution before completing. A timeout may<tr><td><a id="l676"></a><a href="#l676">676</a><td> * be provided to fail the command if the promise does not resolve before the<tr><td><a id="l677"></a><a href="#l677">677</a><td> * timeout expires.<tr><td><a id="l678"></a><a href="#l678">678</a><td> *<tr><td><a id="l679"></a><a href="#l679">679</a><td> * *Example:* Suppose you have a function, `startTestServer`, that returns a<tr><td><a id="l680"></a><a href="#l680">680</a><td> * promise for when a server is ready for requests. You can block a `WebDriver`<tr><td><a id="l681"></a><a href="#l681">681</a><td> * client on this promise with:<tr><td><a id="l682"></a><a href="#l682">682</a><td> *<tr><td><a id="l683"></a><a href="#l683">683</a><td> *     var started = startTestServer();<tr><td><a id="l684"></a><a href="#l684">684</a><td> *     driver.wait(started, 5 * 1000, &#39;Server should start within 5 seconds&#39;);<tr><td><a id="l685"></a><a href="#l685">685</a><td> *     driver.get(getServerUrl());<tr><td><a id="l686"></a><a href="#l686">686</a><td> *<tr><td><a id="l687"></a><a href="#l687">687</a><td> * @param {!(webdriver.promise.Promise&lt;T&gt;|<tr><td><a id="l688"></a><a href="#l688">688</a><td> *           webdriver.until.Condition&lt;T&gt;|<tr><td><a id="l689"></a><a href="#l689">689</a><td> *           function(!webdriver.WebDriver): T)} condition The condition to<tr><td><a id="l690"></a><a href="#l690">690</a><td> *     wait on, defined as a promise, condition object, or  a function to<tr><td><a id="l691"></a><a href="#l691">691</a><td> *     evaluate as a condition.<tr><td><a id="l692"></a><a href="#l692">692</a><td> * @param {number=} opt_timeout How long to wait for the condition to be true.<tr><td><a id="l693"></a><a href="#l693">693</a><td> * @param {string=} opt_message An optional message to use if the wait times<tr><td><a id="l694"></a><a href="#l694">694</a><td> *     out.<tr><td><a id="l695"></a><a href="#l695">695</a><td> * @return {!webdriver.promise.Promise&lt;T&gt;} A promise that will be fulfilled<tr><td><a id="l696"></a><a href="#l696">696</a><td> *     with the first truthy value returned by the condition function, or<tr><td><a id="l697"></a><a href="#l697">697</a><td> *     rejected if the condition times out.<tr><td><a id="l698"></a><a href="#l698">698</a><td> * @template T<tr><td><a id="l699"></a><a href="#l699">699</a><td> */<tr><td><a id="l700"></a><a href="#l700">700</a><td>webdriver.WebDriver.prototype.wait = function(<tr><td><a id="l701"></a><a href="#l701">701</a><td>    condition, opt_timeout, opt_message) {<tr><td><a id="l702"></a><a href="#l702">702</a><td>  if (webdriver.promise.isPromise(condition)) {<tr><td><a id="l703"></a><a href="#l703">703</a><td>    return this.flow_.wait(<tr><td><a id="l704"></a><a href="#l704">704</a><td>        /** @type {!webdriver.promise.Promise} */(condition),<tr><td><a id="l705"></a><a href="#l705">705</a><td>        opt_timeout, opt_message);<tr><td><a id="l706"></a><a href="#l706">706</a><td>  }<tr><td><a id="l707"></a><a href="#l707">707</a><td><tr><td><a id="l708"></a><a href="#l708">708</a><td>  var message = opt_message;<tr><td><a id="l709"></a><a href="#l709">709</a><td>  var fn = /** @type {!Function} */(condition);<tr><td><a id="l710"></a><a href="#l710">710</a><td>  if (condition instanceof webdriver.until.Condition) {<tr><td><a id="l711"></a><a href="#l711">711</a><td>    message = message || condition.description();<tr><td><a id="l712"></a><a href="#l712">712</a><td>    fn = condition.fn;<tr><td><a id="l713"></a><a href="#l713">713</a><td>  }<tr><td><a id="l714"></a><a href="#l714">714</a><td><tr><td><a id="l715"></a><a href="#l715">715</a><td>  var driver = this;<tr><td><a id="l716"></a><a href="#l716">716</a><td>  return this.flow_.wait(function() {<tr><td><a id="l717"></a><a href="#l717">717</a><td>    if (webdriver.promise.isGenerator(fn)) {<tr><td><a id="l718"></a><a href="#l718">718</a><td>      return webdriver.promise.consume(fn, null, [driver]);<tr><td><a id="l719"></a><a href="#l719">719</a><td>    }<tr><td><a id="l720"></a><a href="#l720">720</a><td>    return fn(driver);<tr><td><a id="l721"></a><a href="#l721">721</a><td>  }, opt_timeout, message);<tr><td><a id="l722"></a><a href="#l722">722</a><td>};<tr><td><a id="l723"></a><a href="#l723">723</a><td><tr><td><a id="l724"></a><a href="#l724">724</a><td><tr><td><a id="l725"></a><a href="#l725">725</a><td>/**<tr><td><a id="l726"></a><a href="#l726">726</a><td> * Schedules a command to make the driver sleep for the given amount of time.<tr><td><a id="l727"></a><a href="#l727">727</a><td> * @param {number} ms The amount of time, in milliseconds, to sleep.<tr><td><a id="l728"></a><a href="#l728">728</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l729"></a><a href="#l729">729</a><td> *     when the sleep has finished.<tr><td><a id="l730"></a><a href="#l730">730</a><td> */<tr><td><a id="l731"></a><a href="#l731">731</a><td>webdriver.WebDriver.prototype.sleep = function(ms) {<tr><td><a id="l732"></a><a href="#l732">732</a><td>  return this.flow_.timeout(ms, &#39;WebDriver.sleep(&#39; + ms + &#39;)&#39;);<tr><td><a id="l733"></a><a href="#l733">733</a><td>};<tr><td><a id="l734"></a><a href="#l734">734</a><td><tr><td><a id="l735"></a><a href="#l735">735</a><td><tr><td><a id="l736"></a><a href="#l736">736</a><td>/**<tr><td><a id="l737"></a><a href="#l737">737</a><td> * Schedules a command to retrieve they current window handle.<tr><td><a id="l738"></a><a href="#l738">738</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l739"></a><a href="#l739">739</a><td> *     resolved with the current window handle.<tr><td><a id="l740"></a><a href="#l740">740</a><td> */<tr><td><a id="l741"></a><a href="#l741">741</a><td>webdriver.WebDriver.prototype.getWindowHandle = function() {<tr><td><a id="l742"></a><a href="#l742">742</a><td>  return this.schedule(<tr><td><a id="l743"></a><a href="#l743">743</a><td>      new webdriver.Command(webdriver.CommandName.GET_CURRENT_WINDOW_HANDLE),<tr><td><a id="l744"></a><a href="#l744">744</a><td>      &#39;WebDriver.getWindowHandle()&#39;);<tr><td><a id="l745"></a><a href="#l745">745</a><td>};<tr><td><a id="l746"></a><a href="#l746">746</a><td><tr><td><a id="l747"></a><a href="#l747">747</a><td><tr><td><a id="l748"></a><a href="#l748">748</a><td>/**<tr><td><a id="l749"></a><a href="#l749">749</a><td> * Schedules a command to retrieve the current list of available window handles.<tr><td><a id="l750"></a><a href="#l750">750</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;} A promise that will<tr><td><a id="l751"></a><a href="#l751">751</a><td> *     be resolved with an array of window handles.<tr><td><a id="l752"></a><a href="#l752">752</a><td> */<tr><td><a id="l753"></a><a href="#l753">753</a><td>webdriver.WebDriver.prototype.getAllWindowHandles = function() {<tr><td><a id="l754"></a><a href="#l754">754</a><td>  return this.schedule(<tr><td><a id="l755"></a><a href="#l755">755</a><td>      new webdriver.Command(webdriver.CommandName.GET_WINDOW_HANDLES),<tr><td><a id="l756"></a><a href="#l756">756</a><td>      &#39;WebDriver.getAllWindowHandles()&#39;);<tr><td><a id="l757"></a><a href="#l757">757</a><td>};<tr><td><a id="l758"></a><a href="#l758">758</a><td><tr><td><a id="l759"></a><a href="#l759">759</a><td><tr><td><a id="l760"></a><a href="#l760">760</a><td>/**<tr><td><a id="l761"></a><a href="#l761">761</a><td> * Schedules a command to retrieve the current page&#39;s source. The page source<tr><td><a id="l762"></a><a href="#l762">762</a><td> * returned is a representation of the underlying DOM: do not expect it to be<tr><td><a id="l763"></a><a href="#l763">763</a><td> * formatted or escaped in the same way as the response sent from the web<tr><td><a id="l764"></a><a href="#l764">764</a><td> * server.<tr><td><a id="l765"></a><a href="#l765">765</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l766"></a><a href="#l766">766</a><td> *     resolved with the current page source.<tr><td><a id="l767"></a><a href="#l767">767</a><td> */<tr><td><a id="l768"></a><a href="#l768">768</a><td>webdriver.WebDriver.prototype.getPageSource = function() {<tr><td><a id="l769"></a><a href="#l769">769</a><td>  return this.schedule(<tr><td><a id="l770"></a><a href="#l770">770</a><td>      new webdriver.Command(webdriver.CommandName.GET_PAGE_SOURCE),<tr><td><a id="l771"></a><a href="#l771">771</a><td>      &#39;WebDriver.getAllWindowHandles()&#39;);<tr><td><a id="l772"></a><a href="#l772">772</a><td>};<tr><td><a id="l773"></a><a href="#l773">773</a><td><tr><td><a id="l774"></a><a href="#l774">774</a><td><tr><td><a id="l775"></a><a href="#l775">775</a><td>/**<tr><td><a id="l776"></a><a href="#l776">776</a><td> * Schedules a command to close the current window.<tr><td><a id="l777"></a><a href="#l777">777</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l778"></a><a href="#l778">778</a><td> *     when this command has completed.<tr><td><a id="l779"></a><a href="#l779">779</a><td> */<tr><td><a id="l780"></a><a href="#l780">780</a><td>webdriver.WebDriver.prototype.close = function() {<tr><td><a id="l781"></a><a href="#l781">781</a><td>  return this.schedule(new webdriver.Command(webdriver.CommandName.CLOSE),<tr><td><a id="l782"></a><a href="#l782">782</a><td>                       &#39;WebDriver.close()&#39;);<tr><td><a id="l783"></a><a href="#l783">783</a><td>};<tr><td><a id="l784"></a><a href="#l784">784</a><td><tr><td><a id="l785"></a><a href="#l785">785</a><td><tr><td><a id="l786"></a><a href="#l786">786</a><td>/**<tr><td><a id="l787"></a><a href="#l787">787</a><td> * Schedules a command to navigate to the given URL.<tr><td><a id="l788"></a><a href="#l788">788</a><td> * @param {string} url The fully qualified URL to open.<tr><td><a id="l789"></a><a href="#l789">789</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l790"></a><a href="#l790">790</a><td> *     when the document has finished loading.<tr><td><a id="l791"></a><a href="#l791">791</a><td> */<tr><td><a id="l792"></a><a href="#l792">792</a><td>webdriver.WebDriver.prototype.get = function(url) {<tr><td><a id="l793"></a><a href="#l793">793</a><td>  return this.navigate().to(url);<tr><td><a id="l794"></a><a href="#l794">794</a><td>};<tr><td><a id="l795"></a><a href="#l795">795</a><td><tr><td><a id="l796"></a><a href="#l796">796</a><td><tr><td><a id="l797"></a><a href="#l797">797</a><td>/**<tr><td><a id="l798"></a><a href="#l798">798</a><td> * Schedules a command to retrieve the URL of the current page.<tr><td><a id="l799"></a><a href="#l799">799</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l800"></a><a href="#l800">800</a><td> *     resolved with the current URL.<tr><td><a id="l801"></a><a href="#l801">801</a><td> */<tr><td><a id="l802"></a><a href="#l802">802</a><td>webdriver.WebDriver.prototype.getCurrentUrl = function() {<tr><td><a id="l803"></a><a href="#l803">803</a><td>  return this.schedule(<tr><td><a id="l804"></a><a href="#l804">804</a><td>      new webdriver.Command(webdriver.CommandName.GET_CURRENT_URL),<tr><td><a id="l805"></a><a href="#l805">805</a><td>      &#39;WebDriver.getCurrentUrl()&#39;);<tr><td><a id="l806"></a><a href="#l806">806</a><td>};<tr><td><a id="l807"></a><a href="#l807">807</a><td><tr><td><a id="l808"></a><a href="#l808">808</a><td><tr><td><a id="l809"></a><a href="#l809">809</a><td>/**<tr><td><a id="l810"></a><a href="#l810">810</a><td> * Schedules a command to retrieve the current page&#39;s title.<tr><td><a id="l811"></a><a href="#l811">811</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l812"></a><a href="#l812">812</a><td> *     resolved with the current page&#39;s title.<tr><td><a id="l813"></a><a href="#l813">813</a><td> */<tr><td><a id="l814"></a><a href="#l814">814</a><td>webdriver.WebDriver.prototype.getTitle = function() {<tr><td><a id="l815"></a><a href="#l815">815</a><td>  return this.schedule(new webdriver.Command(webdriver.CommandName.GET_TITLE),<tr><td><a id="l816"></a><a href="#l816">816</a><td>                       &#39;WebDriver.getTitle()&#39;);<tr><td><a id="l817"></a><a href="#l817">817</a><td>};<tr><td><a id="l818"></a><a href="#l818">818</a><td><tr><td><a id="l819"></a><a href="#l819">819</a><td><tr><td><a id="l820"></a><a href="#l820">820</a><td>/**<tr><td><a id="l821"></a><a href="#l821">821</a><td> * Schedule a command to find an element on the page. If the element cannot be<tr><td><a id="l822"></a><a href="#l822">822</a><td> * found, a {@link bot.ErrorCode.NO_SUCH_ELEMENT} result will be returned<tr><td><a id="l823"></a><a href="#l823">823</a><td> * by the driver. Unlike other commands, this error cannot be suppressed. In<tr><td><a id="l824"></a><a href="#l824">824</a><td> * other words, scheduling a command to find an element doubles as an assert<tr><td><a id="l825"></a><a href="#l825">825</a><td> * that the element is present on the page. To test whether an element is<tr><td><a id="l826"></a><a href="#l826">826</a><td> * present on the page, use {@link #isElementPresent} instead.<tr><td><a id="l827"></a><a href="#l827">827</a><td> *<tr><td><a id="l828"></a><a href="#l828">828</a><td> * The search criteria for an element may be defined using one of the<tr><td><a id="l829"></a><a href="#l829">829</a><td> * factories in the {@link webdriver.By} namespace, or as a short-hand<tr><td><a id="l830"></a><a href="#l830">830</a><td> * {@link webdriver.By.Hash} object. For example, the following two statements<tr><td><a id="l831"></a><a href="#l831">831</a><td> * are equivalent:<tr><td><a id="l832"></a><a href="#l832">832</a><td> *<tr><td><a id="l833"></a><a href="#l833">833</a><td> *     var e1 = driver.findElement(By.id(&#39;foo&#39;));<tr><td><a id="l834"></a><a href="#l834">834</a><td> *     var e2 = driver.findElement({id:&#39;foo&#39;});<tr><td><a id="l835"></a><a href="#l835">835</a><td> *<tr><td><a id="l836"></a><a href="#l836">836</a><td> * You may also provide a custom locator function, which takes as input<tr><td><a id="l837"></a><a href="#l837">837</a><td> * this WebDriver instance and returns a {@link webdriver.WebElement}, or a<tr><td><a id="l838"></a><a href="#l838">838</a><td> * promise that will resolve to a WebElement. For example, to find the first<tr><td><a id="l839"></a><a href="#l839">839</a><td> * visible link on a page, you could write:<tr><td><a id="l840"></a><a href="#l840">840</a><td> *<tr><td><a id="l841"></a><a href="#l841">841</a><td> *     var link = driver.findElement(firstVisibleLink);<tr><td><a id="l842"></a><a href="#l842">842</a><td> *<tr><td><a id="l843"></a><a href="#l843">843</a><td> *     function firstVisibleLink(driver) {<tr><td><a id="l844"></a><a href="#l844">844</a><td> *       var links = driver.findElements(By.tagName(&#39;a&#39;));<tr><td><a id="l845"></a><a href="#l845">845</a><td> *       return webdriver.promise.filter(links, function(link) {<tr><td><a id="l846"></a><a href="#l846">846</a><td> *         return links.isDisplayed();<tr><td><a id="l847"></a><a href="#l847">847</a><td> *       }).then(function(visibleLinks) {<tr><td><a id="l848"></a><a href="#l848">848</a><td> *         return visibleLinks[0];<tr><td><a id="l849"></a><a href="#l849">849</a><td> *       });<tr><td><a id="l850"></a><a href="#l850">850</a><td> *     }<tr><td><a id="l851"></a><a href="#l851">851</a><td> *<tr><td><a id="l852"></a><a href="#l852">852</a><td> * When running in the browser, a WebDriver cannot manipulate DOM elements<tr><td><a id="l853"></a><a href="#l853">853</a><td> * directly; it may do so only through a {@link webdriver.WebElement} reference.<tr><td><a id="l854"></a><a href="#l854">854</a><td> * This function may be used to generate a WebElement from a DOM element. A<tr><td><a id="l855"></a><a href="#l855">855</a><td> * reference to the DOM element will be stored in a known location and this<tr><td><a id="l856"></a><a href="#l856">856</a><td> * driver will attempt to retrieve it through {@link #executeScript}. If the<tr><td><a id="l857"></a><a href="#l857">857</a><td> * element cannot be found (eg, it belongs to a different document than the<tr><td><a id="l858"></a><a href="#l858">858</a><td> * one this instance is currently focused on), a<tr><td><a id="l859"></a><a href="#l859">859</a><td> * {@link bot.ErrorCode.NO_SUCH_ELEMENT} error will be returned.<tr><td><a id="l860"></a><a href="#l860">860</a><td> *<tr><td><a id="l861"></a><a href="#l861">861</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Element|Function)} locator The<tr><td><a id="l862"></a><a href="#l862">862</a><td> *     locator to use.<tr><td><a id="l863"></a><a href="#l863">863</a><td> * @return {!webdriver.WebElement} A WebElement that can be used to issue<tr><td><a id="l864"></a><a href="#l864">864</a><td> *     commands against the located element. If the element is not found, the<tr><td><a id="l865"></a><a href="#l865">865</a><td> *     element will be invalidated and all scheduled commands aborted.<tr><td><a id="l866"></a><a href="#l866">866</a><td> */<tr><td><a id="l867"></a><a href="#l867">867</a><td>webdriver.WebDriver.prototype.findElement = function(locator) {<tr><td><a id="l868"></a><a href="#l868">868</a><td>  var id;<tr><td><a id="l869"></a><a href="#l869">869</a><td>  if (&#39;nodeType&#39; in locator &amp;&amp; &#39;ownerDocument&#39; in locator) {<tr><td><a id="l870"></a><a href="#l870">870</a><td>    var element = /** @type {!Element} */ (locator);<tr><td><a id="l871"></a><a href="#l871">871</a><td>    id = this.findDomElement_(element).then(function(element) {<tr><td><a id="l872"></a><a href="#l872">872</a><td>      if (!element) {<tr><td><a id="l873"></a><a href="#l873">873</a><td>        throw new bot.Error(bot.ErrorCode.NO_SUCH_ELEMENT,<tr><td><a id="l874"></a><a href="#l874">874</a><td>            &#39;Unable to locate element. Is WebDriver focused on its &#39; +<tr><td><a id="l875"></a><a href="#l875">875</a><td>                &#39;ownerDocument\&#39;s frame?&#39;);<tr><td><a id="l876"></a><a href="#l876">876</a><td>      }<tr><td><a id="l877"></a><a href="#l877">877</a><td>      return element;<tr><td><a id="l878"></a><a href="#l878">878</a><td>    });<tr><td><a id="l879"></a><a href="#l879">879</a><td>  } else {<tr><td><a id="l880"></a><a href="#l880">880</a><td>    locator = webdriver.Locator.checkLocator(locator);<tr><td><a id="l881"></a><a href="#l881">881</a><td>    if (goog.isFunction(locator)) {<tr><td><a id="l882"></a><a href="#l882">882</a><td>      id = this.findElementInternal_(locator, this);<tr><td><a id="l883"></a><a href="#l883">883</a><td>    } else {<tr><td><a id="l884"></a><a href="#l884">884</a><td>      var command = new webdriver.Command(webdriver.CommandName.FIND_ELEMENT).<tr><td><a id="l885"></a><a href="#l885">885</a><td>          setParameter(&#39;using&#39;, locator.using).<tr><td><a id="l886"></a><a href="#l886">886</a><td>          setParameter(&#39;value&#39;, locator.value);<tr><td><a id="l887"></a><a href="#l887">887</a><td>      id = this.schedule(command, &#39;WebDriver.findElement(&#39; + locator + &#39;)&#39;);<tr><td><a id="l888"></a><a href="#l888">888</a><td>    }<tr><td><a id="l889"></a><a href="#l889">889</a><td>  }<tr><td><a id="l890"></a><a href="#l890">890</a><td>  return new webdriver.WebElementPromise(this, id);<tr><td><a id="l891"></a><a href="#l891">891</a><td>};<tr><td><a id="l892"></a><a href="#l892">892</a><td><tr><td><a id="l893"></a><a href="#l893">893</a><td><tr><td><a id="l894"></a><a href="#l894">894</a><td>/**<tr><td><a id="l895"></a><a href="#l895">895</a><td> * @param {!Function} locatorFn The locator function to use.<tr><td><a id="l896"></a><a href="#l896">896</a><td> * @param {!(webdriver.WebDriver|webdriver.WebElement)} context The search<tr><td><a id="l897"></a><a href="#l897">897</a><td> *     context.<tr><td><a id="l898"></a><a href="#l898">898</a><td> * @return {!webdriver.promise.Promise.&lt;!webdriver.WebElement&gt;} A<tr><td><a id="l899"></a><a href="#l899">899</a><td> *     promise that will resolve to a list of WebElements.<tr><td><a id="l900"></a><a href="#l900">900</a><td> * @private<tr><td><a id="l901"></a><a href="#l901">901</a><td> */<tr><td><a id="l902"></a><a href="#l902">902</a><td>webdriver.WebDriver.prototype.findElementInternal_ = function(<tr><td><a id="l903"></a><a href="#l903">903</a><td>    locatorFn, context) {<tr><td><a id="l904"></a><a href="#l904">904</a><td>  return this.call(goog.partial(locatorFn, context)).then(function(result) {<tr><td><a id="l905"></a><a href="#l905">905</a><td>    if (goog.isArray(result)) {<tr><td><a id="l906"></a><a href="#l906">906</a><td>      result = result[0];<tr><td><a id="l907"></a><a href="#l907">907</a><td>    }<tr><td><a id="l908"></a><a href="#l908">908</a><td>    if (!(result instanceof webdriver.WebElement)) {<tr><td><a id="l909"></a><a href="#l909">909</a><td>      throw new TypeError(&#39;Custom locator did not return a WebElement&#39;);<tr><td><a id="l910"></a><a href="#l910">910</a><td>    }<tr><td><a id="l911"></a><a href="#l911">911</a><td>    return result;<tr><td><a id="l912"></a><a href="#l912">912</a><td>  });<tr><td><a id="l913"></a><a href="#l913">913</a><td>};<tr><td><a id="l914"></a><a href="#l914">914</a><td><tr><td><a id="l915"></a><a href="#l915">915</a><td><tr><td><a id="l916"></a><a href="#l916">916</a><td>/**<tr><td><a id="l917"></a><a href="#l917">917</a><td> * Locates a DOM element so that commands may be issued against it using the<tr><td><a id="l918"></a><a href="#l918">918</a><td> * {@link webdriver.WebElement} class. This is accomplished by storing a<tr><td><a id="l919"></a><a href="#l919">919</a><td> * reference to the element in an object on the element&#39;s ownerDocument.<tr><td><a id="l920"></a><a href="#l920">920</a><td> * {@link #executeScript} will then be used to create a WebElement from this<tr><td><a id="l921"></a><a href="#l921">921</a><td> * reference. This requires this driver to currently be focused on the<tr><td><a id="l922"></a><a href="#l922">922</a><td> * ownerDocument&#39;s window+frame.<tr><td><a id="l923"></a><a href="#l923">923</a><td><tr><td><a id="l924"></a><a href="#l924">924</a><td> * @param {!Element} element The element to locate.<tr><td><a id="l925"></a><a href="#l925">925</a><td> * @return {!webdriver.promise.Promise.&lt;webdriver.WebElement&gt;} A promise that<tr><td><a id="l926"></a><a href="#l926">926</a><td> *     will be fulfilled with the located element, or null if the element<tr><td><a id="l927"></a><a href="#l927">927</a><td> *     could not be found.<tr><td><a id="l928"></a><a href="#l928">928</a><td> * @private<tr><td><a id="l929"></a><a href="#l929">929</a><td> */<tr><td><a id="l930"></a><a href="#l930">930</a><td>webdriver.WebDriver.prototype.findDomElement_ = function(element) {<tr><td><a id="l931"></a><a href="#l931">931</a><td>  var doc = element.ownerDocument;<tr><td><a id="l932"></a><a href="#l932">932</a><td>  var store = doc[&#39;$webdriver$&#39;] = doc[&#39;$webdriver$&#39;] || {};<tr><td><a id="l933"></a><a href="#l933">933</a><td>  var id = Math.floor(Math.random() * goog.now()).toString(36);<tr><td><a id="l934"></a><a href="#l934">934</a><td>  store[id] = element;<tr><td><a id="l935"></a><a href="#l935">935</a><td>  element[id] = id;<tr><td><a id="l936"></a><a href="#l936">936</a><td><tr><td><a id="l937"></a><a href="#l937">937</a><td>  function cleanUp() {<tr><td><a id="l938"></a><a href="#l938">938</a><td>    delete store[id];<tr><td><a id="l939"></a><a href="#l939">939</a><td>  }<tr><td><a id="l940"></a><a href="#l940">940</a><td><tr><td><a id="l941"></a><a href="#l941">941</a><td>  function lookupElement(id) {<tr><td><a id="l942"></a><a href="#l942">942</a><td>    var store = document[&#39;$webdriver$&#39;];<tr><td><a id="l943"></a><a href="#l943">943</a><td>    if (!store) {<tr><td><a id="l944"></a><a href="#l944">944</a><td>      return null;<tr><td><a id="l945"></a><a href="#l945">945</a><td>    }<tr><td><a id="l946"></a><a href="#l946">946</a><td><tr><td><a id="l947"></a><a href="#l947">947</a><td>    var element = store[id];<tr><td><a id="l948"></a><a href="#l948">948</a><td>    if (!element || element[id] !== id) {<tr><td><a id="l949"></a><a href="#l949">949</a><td>      return null;<tr><td><a id="l950"></a><a href="#l950">950</a><td>    }<tr><td><a id="l951"></a><a href="#l951">951</a><td>    return element;<tr><td><a id="l952"></a><a href="#l952">952</a><td>  }<tr><td><a id="l953"></a><a href="#l953">953</a><td><tr><td><a id="l954"></a><a href="#l954">954</a><td>  /** @type {!webdriver.promise.Promise.&lt;webdriver.WebElement&gt;} */<tr><td><a id="l955"></a><a href="#l955">955</a><td>  var foundElement = this.executeScript(lookupElement, id);<tr><td><a id="l956"></a><a href="#l956">956</a><td>  foundElement.thenFinally(cleanUp);<tr><td><a id="l957"></a><a href="#l957">957</a><td>  return foundElement;<tr><td><a id="l958"></a><a href="#l958">958</a><td>};<tr><td><a id="l959"></a><a href="#l959">959</a><td><tr><td><a id="l960"></a><a href="#l960">960</a><td><tr><td><a id="l961"></a><a href="#l961">961</a><td>/**<tr><td><a id="l962"></a><a href="#l962">962</a><td> * Schedules a command to test if an element is present on the page.<tr><td><a id="l963"></a><a href="#l963">963</a><td> *<tr><td><a id="l964"></a><a href="#l964">964</a><td> * If given a DOM element, this function will check if it belongs to the<tr><td><a id="l965"></a><a href="#l965">965</a><td> * document the driver is currently focused on. Otherwise, the function will<tr><td><a id="l966"></a><a href="#l966">966</a><td> * test if at least one element can be found with the given search criteria.<tr><td><a id="l967"></a><a href="#l967">967</a><td> *<tr><td><a id="l968"></a><a href="#l968">968</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Element|<tr><td><a id="l969"></a><a href="#l969">969</a><td> *           Function)} locatorOrElement The locator to use, or the actual<tr><td><a id="l970"></a><a href="#l970">970</a><td> *     DOM element to be located by the server.<tr><td><a id="l971"></a><a href="#l971">971</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will resolve<tr><td><a id="l972"></a><a href="#l972">972</a><td> *     with whether the element is present on the page.<tr><td><a id="l973"></a><a href="#l973">973</a><td> */<tr><td><a id="l974"></a><a href="#l974">974</a><td>webdriver.WebDriver.prototype.isElementPresent = function(locatorOrElement) {<tr><td><a id="l975"></a><a href="#l975">975</a><td>  if (&#39;nodeType&#39; in locatorOrElement &amp;&amp; &#39;ownerDocument&#39; in locatorOrElement) {<tr><td><a id="l976"></a><a href="#l976">976</a><td>    return this.findDomElement_(/** @type {!Element} */ (locatorOrElement)).<tr><td><a id="l977"></a><a href="#l977">977</a><td>        then(function(result) { return !!result; });<tr><td><a id="l978"></a><a href="#l978">978</a><td>  } else {<tr><td><a id="l979"></a><a href="#l979">979</a><td>    return this.findElements.apply(this, arguments).then(function(result) {<tr><td><a id="l980"></a><a href="#l980">980</a><td>      return !!result.length;<tr><td><a id="l981"></a><a href="#l981">981</a><td>    });<tr><td><a id="l982"></a><a href="#l982">982</a><td>  }<tr><td><a id="l983"></a><a href="#l983">983</a><td>};<tr><td><a id="l984"></a><a href="#l984">984</a><td><tr><td><a id="l985"></a><a href="#l985">985</a><td><tr><td><a id="l986"></a><a href="#l986">986</a><td>/**<tr><td><a id="l987"></a><a href="#l987">987</a><td> * Schedule a command to search for multiple elements on the page.<tr><td><a id="l988"></a><a href="#l988">988</a><td> *<tr><td><a id="l989"></a><a href="#l989">989</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The locator<tr><td><a id="l990"></a><a href="#l990">990</a><td> *     strategy to use when searching for the element.<tr><td><a id="l991"></a><a href="#l991">991</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.WebElement&gt;&gt;} A<tr><td><a id="l992"></a><a href="#l992">992</a><td> *     promise that will resolve to an array of WebElements.<tr><td><a id="l993"></a><a href="#l993">993</a><td> */<tr><td><a id="l994"></a><a href="#l994">994</a><td>webdriver.WebDriver.prototype.findElements = function(locator) {<tr><td><a id="l995"></a><a href="#l995">995</a><td>  locator = webdriver.Locator.checkLocator(locator);<tr><td><a id="l996"></a><a href="#l996">996</a><td>  if (goog.isFunction(locator)) {<tr><td><a id="l997"></a><a href="#l997">997</a><td>    return this.findElementsInternal_(locator, this);<tr><td><a id="l998"></a><a href="#l998">998</a><td>  } else {<tr><td><a id="l999"></a><a href="#l999">999</a><td>    var command = new webdriver.Command(webdriver.CommandName.FIND_ELEMENTS).<tr><td><a id="l1000"></a><a href="#l1000">1000</a><td>        setParameter(&#39;using&#39;, locator.using).<tr><td><a id="l1001"></a><a href="#l1001">1001</a><td>        setParameter(&#39;value&#39;, locator.value);<tr><td><a id="l1002"></a><a href="#l1002">1002</a><td>    return this.schedule(command, &#39;WebDriver.findElements(&#39; + locator + &#39;)&#39;);<tr><td><a id="l1003"></a><a href="#l1003">1003</a><td>  }<tr><td><a id="l1004"></a><a href="#l1004">1004</a><td>};<tr><td><a id="l1005"></a><a href="#l1005">1005</a><td><tr><td><a id="l1006"></a><a href="#l1006">1006</a><td><tr><td><a id="l1007"></a><a href="#l1007">1007</a><td>/**<tr><td><a id="l1008"></a><a href="#l1008">1008</a><td> * @param {!Function} locatorFn The locator function to use.<tr><td><a id="l1009"></a><a href="#l1009">1009</a><td> * @param {!(webdriver.WebDriver|webdriver.WebElement)} context The search<tr><td><a id="l1010"></a><a href="#l1010">1010</a><td> *     context.<tr><td><a id="l1011"></a><a href="#l1011">1011</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.WebElement&gt;&gt;} A<tr><td><a id="l1012"></a><a href="#l1012">1012</a><td> *     promise that will resolve to an array of WebElements.<tr><td><a id="l1013"></a><a href="#l1013">1013</a><td> * @private<tr><td><a id="l1014"></a><a href="#l1014">1014</a><td> */<tr><td><a id="l1015"></a><a href="#l1015">1015</a><td>webdriver.WebDriver.prototype.findElementsInternal_ = function(<tr><td><a id="l1016"></a><a href="#l1016">1016</a><td>    locatorFn, context) {<tr><td><a id="l1017"></a><a href="#l1017">1017</a><td>  return this.call(goog.partial(locatorFn, context)).then(function(result) {<tr><td><a id="l1018"></a><a href="#l1018">1018</a><td>    if (result instanceof webdriver.WebElement) {<tr><td><a id="l1019"></a><a href="#l1019">1019</a><td>      return [result];<tr><td><a id="l1020"></a><a href="#l1020">1020</a><td>    }<tr><td><a id="l1021"></a><a href="#l1021">1021</a><td><tr><td><a id="l1022"></a><a href="#l1022">1022</a><td>    if (!goog.isArray(result)) {<tr><td><a id="l1023"></a><a href="#l1023">1023</a><td>      return [];<tr><td><a id="l1024"></a><a href="#l1024">1024</a><td>    }<tr><td><a id="l1025"></a><a href="#l1025">1025</a><td><tr><td><a id="l1026"></a><a href="#l1026">1026</a><td>    return goog.array.filter(result, function(item) {<tr><td><a id="l1027"></a><a href="#l1027">1027</a><td>      return item instanceof webdriver.WebElement;<tr><td><a id="l1028"></a><a href="#l1028">1028</a><td>    });<tr><td><a id="l1029"></a><a href="#l1029">1029</a><td>  });<tr><td><a id="l1030"></a><a href="#l1030">1030</a><td>};<tr><td><a id="l1031"></a><a href="#l1031">1031</a><td><tr><td><a id="l1032"></a><a href="#l1032">1032</a><td><tr><td><a id="l1033"></a><a href="#l1033">1033</a><td>/**<tr><td><a id="l1034"></a><a href="#l1034">1034</a><td> * Schedule a command to take a screenshot. The driver makes a best effort to<tr><td><a id="l1035"></a><a href="#l1035">1035</a><td> * return a screenshot of the following, in order of preference:<tr><td><a id="l1036"></a><a href="#l1036">1036</a><td> * &lt;ol&gt;<tr><td><a id="l1037"></a><a href="#l1037">1037</a><td> *   &lt;li&gt;Entire page<tr><td><a id="l1038"></a><a href="#l1038">1038</a><td> *   &lt;li&gt;Current window<tr><td><a id="l1039"></a><a href="#l1039">1039</a><td> *   &lt;li&gt;Visible portion of the current frame<tr><td><a id="l1040"></a><a href="#l1040">1040</a><td> *   &lt;li&gt;The screenshot of the entire display containing the browser<tr><td><a id="l1041"></a><a href="#l1041">1041</a><td> * &lt;/ol&gt;<tr><td><a id="l1042"></a><a href="#l1042">1042</a><td> *<tr><td><a id="l1043"></a><a href="#l1043">1043</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l1044"></a><a href="#l1044">1044</a><td> *     resolved to the screenshot as a base-64 encoded PNG.<tr><td><a id="l1045"></a><a href="#l1045">1045</a><td> */<tr><td><a id="l1046"></a><a href="#l1046">1046</a><td>webdriver.WebDriver.prototype.takeScreenshot = function() {<tr><td><a id="l1047"></a><a href="#l1047">1047</a><td>  return this.schedule(new webdriver.Command(webdriver.CommandName.SCREENSHOT),<tr><td><a id="l1048"></a><a href="#l1048">1048</a><td>      &#39;WebDriver.takeScreenshot()&#39;);<tr><td><a id="l1049"></a><a href="#l1049">1049</a><td>};<tr><td><a id="l1050"></a><a href="#l1050">1050</a><td><tr><td><a id="l1051"></a><a href="#l1051">1051</a><td><tr><td><a id="l1052"></a><a href="#l1052">1052</a><td>/**<tr><td><a id="l1053"></a><a href="#l1053">1053</a><td> * @return {!webdriver.WebDriver.Options} The options interface for this<tr><td><a id="l1054"></a><a href="#l1054">1054</a><td> *     instance.<tr><td><a id="l1055"></a><a href="#l1055">1055</a><td> */<tr><td><a id="l1056"></a><a href="#l1056">1056</a><td>webdriver.WebDriver.prototype.manage = function() {<tr><td><a id="l1057"></a><a href="#l1057">1057</a><td>  return new webdriver.WebDriver.Options(this);<tr><td><a id="l1058"></a><a href="#l1058">1058</a><td>};<tr><td><a id="l1059"></a><a href="#l1059">1059</a><td><tr><td><a id="l1060"></a><a href="#l1060">1060</a><td><tr><td><a id="l1061"></a><a href="#l1061">1061</a><td>/**<tr><td><a id="l1062"></a><a href="#l1062">1062</a><td> * @return {!webdriver.WebDriver.Navigation} The navigation interface for this<tr><td><a id="l1063"></a><a href="#l1063">1063</a><td> *     instance.<tr><td><a id="l1064"></a><a href="#l1064">1064</a><td> */<tr><td><a id="l1065"></a><a href="#l1065">1065</a><td>webdriver.WebDriver.prototype.navigate = function() {<tr><td><a id="l1066"></a><a href="#l1066">1066</a><td>  return new webdriver.WebDriver.Navigation(this);<tr><td><a id="l1067"></a><a href="#l1067">1067</a><td>};<tr><td><a id="l1068"></a><a href="#l1068">1068</a><td><tr><td><a id="l1069"></a><a href="#l1069">1069</a><td><tr><td><a id="l1070"></a><a href="#l1070">1070</a><td>/**<tr><td><a id="l1071"></a><a href="#l1071">1071</a><td> * @return {!webdriver.WebDriver.TargetLocator} The target locator interface for<tr><td><a id="l1072"></a><a href="#l1072">1072</a><td> *     this instance.<tr><td><a id="l1073"></a><a href="#l1073">1073</a><td> */<tr><td><a id="l1074"></a><a href="#l1074">1074</a><td>webdriver.WebDriver.prototype.switchTo = function() {<tr><td><a id="l1075"></a><a href="#l1075">1075</a><td>  return new webdriver.WebDriver.TargetLocator(this);<tr><td><a id="l1076"></a><a href="#l1076">1076</a><td>};<tr><td><a id="l1077"></a><a href="#l1077">1077</a><td><tr><td><a id="l1078"></a><a href="#l1078">1078</a><td><tr><td><a id="l1079"></a><a href="#l1079">1079</a><td><tr><td><a id="l1080"></a><a href="#l1080">1080</a><td>/**<tr><td><a id="l1081"></a><a href="#l1081">1081</a><td> * Interface for navigating back and forth in the browser history.<tr><td><a id="l1082"></a><a href="#l1082">1082</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a id="l1083"></a><a href="#l1083">1083</a><td> * @constructor<tr><td><a id="l1084"></a><a href="#l1084">1084</a><td> */<tr><td><a id="l1085"></a><a href="#l1085">1085</a><td>webdriver.WebDriver.Navigation = function(driver) {<tr><td><a id="l1086"></a><a href="#l1086">1086</a><td><tr><td><a id="l1087"></a><a href="#l1087">1087</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l1088"></a><a href="#l1088">1088</a><td>  this.driver_ = driver;<tr><td><a id="l1089"></a><a href="#l1089">1089</a><td>};<tr><td><a id="l1090"></a><a href="#l1090">1090</a><td><tr><td><a id="l1091"></a><a href="#l1091">1091</a><td><tr><td><a id="l1092"></a><a href="#l1092">1092</a><td>/**<tr><td><a id="l1093"></a><a href="#l1093">1093</a><td> * Schedules a command to navigate to a new URL.<tr><td><a id="l1094"></a><a href="#l1094">1094</a><td> * @param {string} url The URL to navigate to.<tr><td><a id="l1095"></a><a href="#l1095">1095</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1096"></a><a href="#l1096">1096</a><td> *     when the URL has been loaded.<tr><td><a id="l1097"></a><a href="#l1097">1097</a><td> */<tr><td><a id="l1098"></a><a href="#l1098">1098</a><td>webdriver.WebDriver.Navigation.prototype.to = function(url) {<tr><td><a id="l1099"></a><a href="#l1099">1099</a><td>  return this.driver_.schedule(<tr><td><a id="l1100"></a><a href="#l1100">1100</a><td>      new webdriver.Command(webdriver.CommandName.GET).<tr><td><a id="l1101"></a><a href="#l1101">1101</a><td>          setParameter(&#39;url&#39;, url),<tr><td><a id="l1102"></a><a href="#l1102">1102</a><td>      &#39;WebDriver.navigate().to(&#39; + url + &#39;)&#39;);<tr><td><a id="l1103"></a><a href="#l1103">1103</a><td>};<tr><td><a id="l1104"></a><a href="#l1104">1104</a><td><tr><td><a id="l1105"></a><a href="#l1105">1105</a><td><tr><td><a id="l1106"></a><a href="#l1106">1106</a><td>/**<tr><td><a id="l1107"></a><a href="#l1107">1107</a><td> * Schedules a command to move backwards in the browser history.<tr><td><a id="l1108"></a><a href="#l1108">1108</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1109"></a><a href="#l1109">1109</a><td> *     when the navigation event has completed.<tr><td><a id="l1110"></a><a href="#l1110">1110</a><td> */<tr><td><a id="l1111"></a><a href="#l1111">1111</a><td>webdriver.WebDriver.Navigation.prototype.back = function() {<tr><td><a id="l1112"></a><a href="#l1112">1112</a><td>  return this.driver_.schedule(<tr><td><a id="l1113"></a><a href="#l1113">1113</a><td>      new webdriver.Command(webdriver.CommandName.GO_BACK),<tr><td><a id="l1114"></a><a href="#l1114">1114</a><td>      &#39;WebDriver.navigate().back()&#39;);<tr><td><a id="l1115"></a><a href="#l1115">1115</a><td>};<tr><td><a id="l1116"></a><a href="#l1116">1116</a><td><tr><td><a id="l1117"></a><a href="#l1117">1117</a><td><tr><td><a id="l1118"></a><a href="#l1118">1118</a><td>/**<tr><td><a id="l1119"></a><a href="#l1119">1119</a><td> * Schedules a command to move forwards in the browser history.<tr><td><a id="l1120"></a><a href="#l1120">1120</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1121"></a><a href="#l1121">1121</a><td> *     when the navigation event has completed.<tr><td><a id="l1122"></a><a href="#l1122">1122</a><td> */<tr><td><a id="l1123"></a><a href="#l1123">1123</a><td>webdriver.WebDriver.Navigation.prototype.forward = function() {<tr><td><a id="l1124"></a><a href="#l1124">1124</a><td>  return this.driver_.schedule(<tr><td><a id="l1125"></a><a href="#l1125">1125</a><td>      new webdriver.Command(webdriver.CommandName.GO_FORWARD),<tr><td><a id="l1126"></a><a href="#l1126">1126</a><td>      &#39;WebDriver.navigate().forward()&#39;);<tr><td><a id="l1127"></a><a href="#l1127">1127</a><td>};<tr><td><a id="l1128"></a><a href="#l1128">1128</a><td><tr><td><a id="l1129"></a><a href="#l1129">1129</a><td><tr><td><a id="l1130"></a><a href="#l1130">1130</a><td>/**<tr><td><a id="l1131"></a><a href="#l1131">1131</a><td> * Schedules a command to refresh the current page.<tr><td><a id="l1132"></a><a href="#l1132">1132</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1133"></a><a href="#l1133">1133</a><td> *     when the navigation event has completed.<tr><td><a id="l1134"></a><a href="#l1134">1134</a><td> */<tr><td><a id="l1135"></a><a href="#l1135">1135</a><td>webdriver.WebDriver.Navigation.prototype.refresh = function() {<tr><td><a id="l1136"></a><a href="#l1136">1136</a><td>  return this.driver_.schedule(<tr><td><a id="l1137"></a><a href="#l1137">1137</a><td>      new webdriver.Command(webdriver.CommandName.REFRESH),<tr><td><a id="l1138"></a><a href="#l1138">1138</a><td>      &#39;WebDriver.navigate().refresh()&#39;);<tr><td><a id="l1139"></a><a href="#l1139">1139</a><td>};<tr><td><a id="l1140"></a><a href="#l1140">1140</a><td><tr><td><a id="l1141"></a><a href="#l1141">1141</a><td><tr><td><a id="l1142"></a><a href="#l1142">1142</a><td><tr><td><a id="l1143"></a><a href="#l1143">1143</a><td>/**<tr><td><a id="l1144"></a><a href="#l1144">1144</a><td> * Provides methods for managing browser and driver state.<tr><td><a id="l1145"></a><a href="#l1145">1145</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a id="l1146"></a><a href="#l1146">1146</a><td> * @constructor<tr><td><a id="l1147"></a><a href="#l1147">1147</a><td> */<tr><td><a id="l1148"></a><a href="#l1148">1148</a><td>webdriver.WebDriver.Options = function(driver) {<tr><td><a id="l1149"></a><a href="#l1149">1149</a><td><tr><td><a id="l1150"></a><a href="#l1150">1150</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l1151"></a><a href="#l1151">1151</a><td>  this.driver_ = driver;<tr><td><a id="l1152"></a><a href="#l1152">1152</a><td>};<tr><td><a id="l1153"></a><a href="#l1153">1153</a><td><tr><td><a id="l1154"></a><a href="#l1154">1154</a><td><tr><td><a id="l1155"></a><a href="#l1155">1155</a><td>/**<tr><td><a id="l1156"></a><a href="#l1156">1156</a><td> * A JSON description of a browser cookie.<tr><td><a id="l1157"></a><a href="#l1157">1157</a><td> * @typedef {{<tr><td><a id="l1158"></a><a href="#l1158">1158</a><td> *     name: string,<tr><td><a id="l1159"></a><a href="#l1159">1159</a><td> *     value: string,<tr><td><a id="l1160"></a><a href="#l1160">1160</a><td> *     path: (string|undefined),<tr><td><a id="l1161"></a><a href="#l1161">1161</a><td> *     domain: (string|undefined),<tr><td><a id="l1162"></a><a href="#l1162">1162</a><td> *     secure: (boolean|undefined),<tr><td><a id="l1163"></a><a href="#l1163">1163</a><td> *     expiry: (number|undefined)<tr><td><a id="l1164"></a><a href="#l1164">1164</a><td> * }}<tr><td><a id="l1165"></a><a href="#l1165">1165</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object<tr><td><a id="l1166"></a><a href="#l1166">1166</a><td> */<tr><td><a id="l1167"></a><a href="#l1167">1167</a><td>webdriver.WebDriver.Options.Cookie;<tr><td><a id="l1168"></a><a href="#l1168">1168</a><td><tr><td><a id="l1169"></a><a href="#l1169">1169</a><td><tr><td><a id="l1170"></a><a href="#l1170">1170</a><td>/**<tr><td><a id="l1171"></a><a href="#l1171">1171</a><td> * Schedules a command to add a cookie.<tr><td><a id="l1172"></a><a href="#l1172">1172</a><td> * @param {string} name The cookie name.<tr><td><a id="l1173"></a><a href="#l1173">1173</a><td> * @param {string} value The cookie value.<tr><td><a id="l1174"></a><a href="#l1174">1174</a><td> * @param {string=} opt_path The cookie path.<tr><td><a id="l1175"></a><a href="#l1175">1175</a><td> * @param {string=} opt_domain The cookie domain.<tr><td><a id="l1176"></a><a href="#l1176">1176</a><td> * @param {boolean=} opt_isSecure Whether the cookie is secure.<tr><td><a id="l1177"></a><a href="#l1177">1177</a><td> * @param {(number|!Date)=} opt_expiry When the cookie expires. If specified as<tr><td><a id="l1178"></a><a href="#l1178">1178</a><td> *     a number, should be in milliseconds since midnight, January 1, 1970 UTC.<tr><td><a id="l1179"></a><a href="#l1179">1179</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1180"></a><a href="#l1180">1180</a><td> *     when the cookie has been added to the page.<tr><td><a id="l1181"></a><a href="#l1181">1181</a><td> */<tr><td><a id="l1182"></a><a href="#l1182">1182</a><td>webdriver.WebDriver.Options.prototype.addCookie = function(<tr><td><a id="l1183"></a><a href="#l1183">1183</a><td>    name, value, opt_path, opt_domain, opt_isSecure, opt_expiry) {<tr><td><a id="l1184"></a><a href="#l1184">1184</a><td>  // We do not allow &#39;=&#39; or &#39;;&#39; in the name.<tr><td><a id="l1185"></a><a href="#l1185">1185</a><td>  if (/[;=]/.test(name)) {<tr><td><a id="l1186"></a><a href="#l1186">1186</a><td>    throw Error(&#39;Invalid cookie name &quot;&#39; + name + &#39;&quot;&#39;);<tr><td><a id="l1187"></a><a href="#l1187">1187</a><td>  }<tr><td><a id="l1188"></a><a href="#l1188">1188</a><td><tr><td><a id="l1189"></a><a href="#l1189">1189</a><td>  // We do not allow &#39;;&#39; in value.<tr><td><a id="l1190"></a><a href="#l1190">1190</a><td>  if (/;/.test(value)) {<tr><td><a id="l1191"></a><a href="#l1191">1191</a><td>    throw Error(&#39;Invalid cookie value &quot;&#39; + value + &#39;&quot;&#39;);<tr><td><a id="l1192"></a><a href="#l1192">1192</a><td>  }<tr><td><a id="l1193"></a><a href="#l1193">1193</a><td><tr><td><a id="l1194"></a><a href="#l1194">1194</a><td>  var cookieString = name + &#39;=&#39; + value +<tr><td><a id="l1195"></a><a href="#l1195">1195</a><td>      (opt_domain ? &#39;;domain=&#39; + opt_domain : &#39;&#39;) +<tr><td><a id="l1196"></a><a href="#l1196">1196</a><td>      (opt_path ? &#39;;path=&#39; + opt_path : &#39;&#39;) +<tr><td><a id="l1197"></a><a href="#l1197">1197</a><td>      (opt_isSecure ? &#39;;secure&#39; : &#39;&#39;);<tr><td><a id="l1198"></a><a href="#l1198">1198</a><td><tr><td><a id="l1199"></a><a href="#l1199">1199</a><td>  var expiry;<tr><td><a id="l1200"></a><a href="#l1200">1200</a><td>  if (goog.isDef(opt_expiry)) {<tr><td><a id="l1201"></a><a href="#l1201">1201</a><td>    var expiryDate;<tr><td><a id="l1202"></a><a href="#l1202">1202</a><td>    if (goog.isNumber(opt_expiry)) {<tr><td><a id="l1203"></a><a href="#l1203">1203</a><td>      expiryDate = new Date(opt_expiry);<tr><td><a id="l1204"></a><a href="#l1204">1204</a><td>    } else {<tr><td><a id="l1205"></a><a href="#l1205">1205</a><td>      expiryDate = /** @type {!Date} */ (opt_expiry);<tr><td><a id="l1206"></a><a href="#l1206">1206</a><td>      opt_expiry = expiryDate.getTime();<tr><td><a id="l1207"></a><a href="#l1207">1207</a><td>    }<tr><td><a id="l1208"></a><a href="#l1208">1208</a><td>    cookieString += &#39;;expires=&#39; + expiryDate.toUTCString();<tr><td><a id="l1209"></a><a href="#l1209">1209</a><td>    // Convert from milliseconds to seconds.<tr><td><a id="l1210"></a><a href="#l1210">1210</a><td>    expiry = Math.floor(/** @type {number} */ (opt_expiry) / 1000);<tr><td><a id="l1211"></a><a href="#l1211">1211</a><td>  }<tr><td><a id="l1212"></a><a href="#l1212">1212</a><td><tr><td><a id="l1213"></a><a href="#l1213">1213</a><td>  return this.driver_.schedule(<tr><td><a id="l1214"></a><a href="#l1214">1214</a><td>      new webdriver.Command(webdriver.CommandName.ADD_COOKIE).<tr><td><a id="l1215"></a><a href="#l1215">1215</a><td>          setParameter(&#39;cookie&#39;, {<tr><td><a id="l1216"></a><a href="#l1216">1216</a><td>            &#39;name&#39;: name,<tr><td><a id="l1217"></a><a href="#l1217">1217</a><td>            &#39;value&#39;: value,<tr><td><a id="l1218"></a><a href="#l1218">1218</a><td>            &#39;path&#39;: opt_path,<tr><td><a id="l1219"></a><a href="#l1219">1219</a><td>            &#39;domain&#39;: opt_domain,<tr><td><a id="l1220"></a><a href="#l1220">1220</a><td>            &#39;secure&#39;: !!opt_isSecure,<tr><td><a id="l1221"></a><a href="#l1221">1221</a><td>            &#39;expiry&#39;: expiry<tr><td><a id="l1222"></a><a href="#l1222">1222</a><td>          }),<tr><td><a id="l1223"></a><a href="#l1223">1223</a><td>      &#39;WebDriver.manage().addCookie(&#39; + cookieString + &#39;)&#39;);<tr><td><a id="l1224"></a><a href="#l1224">1224</a><td>};<tr><td><a id="l1225"></a><a href="#l1225">1225</a><td><tr><td><a id="l1226"></a><a href="#l1226">1226</a><td><tr><td><a id="l1227"></a><a href="#l1227">1227</a><td>/**<tr><td><a id="l1228"></a><a href="#l1228">1228</a><td> * Schedules a command to delete all cookies visible to the current page.<tr><td><a id="l1229"></a><a href="#l1229">1229</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1230"></a><a href="#l1230">1230</a><td> *     when all cookies have been deleted.<tr><td><a id="l1231"></a><a href="#l1231">1231</a><td> */<tr><td><a id="l1232"></a><a href="#l1232">1232</a><td>webdriver.WebDriver.Options.prototype.deleteAllCookies = function() {<tr><td><a id="l1233"></a><a href="#l1233">1233</a><td>  return this.driver_.schedule(<tr><td><a id="l1234"></a><a href="#l1234">1234</a><td>      new webdriver.Command(webdriver.CommandName.DELETE_ALL_COOKIES),<tr><td><a id="l1235"></a><a href="#l1235">1235</a><td>      &#39;WebDriver.manage().deleteAllCookies()&#39;);<tr><td><a id="l1236"></a><a href="#l1236">1236</a><td>};<tr><td><a id="l1237"></a><a href="#l1237">1237</a><td><tr><td><a id="l1238"></a><a href="#l1238">1238</a><td><tr><td><a id="l1239"></a><a href="#l1239">1239</a><td>/**<tr><td><a id="l1240"></a><a href="#l1240">1240</a><td> * Schedules a command to delete the cookie with the given name. This command is<tr><td><a id="l1241"></a><a href="#l1241">1241</a><td> * a no-op if there is no cookie with the given name visible to the current<tr><td><a id="l1242"></a><a href="#l1242">1242</a><td> * page.<tr><td><a id="l1243"></a><a href="#l1243">1243</a><td> * @param {string} name The name of the cookie to delete.<tr><td><a id="l1244"></a><a href="#l1244">1244</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1245"></a><a href="#l1245">1245</a><td> *     when the cookie has been deleted.<tr><td><a id="l1246"></a><a href="#l1246">1246</a><td> */<tr><td><a id="l1247"></a><a href="#l1247">1247</a><td>webdriver.WebDriver.Options.prototype.deleteCookie = function(name) {<tr><td><a id="l1248"></a><a href="#l1248">1248</a><td>  return this.driver_.schedule(<tr><td><a id="l1249"></a><a href="#l1249">1249</a><td>      new webdriver.Command(webdriver.CommandName.DELETE_COOKIE).<tr><td><a id="l1250"></a><a href="#l1250">1250</a><td>          setParameter(&#39;name&#39;, name),<tr><td><a id="l1251"></a><a href="#l1251">1251</a><td>      &#39;WebDriver.manage().deleteCookie(&#39; + name + &#39;)&#39;);<tr><td><a id="l1252"></a><a href="#l1252">1252</a><td>};<tr><td><a id="l1253"></a><a href="#l1253">1253</a><td><tr><td><a id="l1254"></a><a href="#l1254">1254</a><td><tr><td><a id="l1255"></a><a href="#l1255">1255</a><td>/**<tr><td><a id="l1256"></a><a href="#l1256">1256</a><td> * Schedules a command to retrieve all cookies visible to the current page.<tr><td><a id="l1257"></a><a href="#l1257">1257</a><td> * Each cookie will be returned as a JSON object as described by the WebDriver<tr><td><a id="l1258"></a><a href="#l1258">1258</a><td> * wire protocol.<tr><td><a id="l1259"></a><a href="#l1259">1259</a><td> * @return {!webdriver.promise.Promise.&lt;<tr><td><a id="l1260"></a><a href="#l1260">1260</a><td> *     !Array.&lt;webdriver.WebDriver.Options.Cookie&gt;&gt;} A promise that will be<tr><td><a id="l1261"></a><a href="#l1261">1261</a><td> *     resolved with the cookies visible to the current page.<tr><td><a id="l1262"></a><a href="#l1262">1262</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object<tr><td><a id="l1263"></a><a href="#l1263">1263</a><td> */<tr><td><a id="l1264"></a><a href="#l1264">1264</a><td>webdriver.WebDriver.Options.prototype.getCookies = function() {<tr><td><a id="l1265"></a><a href="#l1265">1265</a><td>  return this.driver_.schedule(<tr><td><a id="l1266"></a><a href="#l1266">1266</a><td>      new webdriver.Command(webdriver.CommandName.GET_ALL_COOKIES),<tr><td><a id="l1267"></a><a href="#l1267">1267</a><td>      &#39;WebDriver.manage().getCookies()&#39;);<tr><td><a id="l1268"></a><a href="#l1268">1268</a><td>};<tr><td><a id="l1269"></a><a href="#l1269">1269</a><td><tr><td><a id="l1270"></a><a href="#l1270">1270</a><td><tr><td><a id="l1271"></a><a href="#l1271">1271</a><td>/**<tr><td><a id="l1272"></a><a href="#l1272">1272</a><td> * Schedules a command to retrieve the cookie with the given name. Returns null<tr><td><a id="l1273"></a><a href="#l1273">1273</a><td> * if there is no such cookie. The cookie will be returned as a JSON object as<tr><td><a id="l1274"></a><a href="#l1274">1274</a><td> * described by the WebDriver wire protocol.<tr><td><a id="l1275"></a><a href="#l1275">1275</a><td> * @param {string} name The name of the cookie to retrieve.<tr><td><a id="l1276"></a><a href="#l1276">1276</a><td> * @return {!webdriver.promise.Promise.&lt;?webdriver.WebDriver.Options.Cookie&gt;} A<tr><td><a id="l1277"></a><a href="#l1277">1277</a><td> *     promise that will be resolved with the named cookie, or {@code null}<tr><td><a id="l1278"></a><a href="#l1278">1278</a><td> *     if there is no such cookie.<tr><td><a id="l1279"></a><a href="#l1279">1279</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object<tr><td><a id="l1280"></a><a href="#l1280">1280</a><td> */<tr><td><a id="l1281"></a><a href="#l1281">1281</a><td>webdriver.WebDriver.Options.prototype.getCookie = function(name) {<tr><td><a id="l1282"></a><a href="#l1282">1282</a><td>  return this.getCookies().then(function(cookies) {<tr><td><a id="l1283"></a><a href="#l1283">1283</a><td>    return goog.array.find(cookies, function(cookie) {<tr><td><a id="l1284"></a><a href="#l1284">1284</a><td>      return cookie &amp;&amp; cookie[&#39;name&#39;] == name;<tr><td><a id="l1285"></a><a href="#l1285">1285</a><td>    });<tr><td><a id="l1286"></a><a href="#l1286">1286</a><td>  });<tr><td><a id="l1287"></a><a href="#l1287">1287</a><td>};<tr><td><a id="l1288"></a><a href="#l1288">1288</a><td><tr><td><a id="l1289"></a><a href="#l1289">1289</a><td><tr><td><a id="l1290"></a><a href="#l1290">1290</a><td>/**<tr><td><a id="l1291"></a><a href="#l1291">1291</a><td> * @return {!webdriver.WebDriver.Logs} The interface for managing driver<tr><td><a id="l1292"></a><a href="#l1292">1292</a><td> *     logs.<tr><td><a id="l1293"></a><a href="#l1293">1293</a><td> */<tr><td><a id="l1294"></a><a href="#l1294">1294</a><td>webdriver.WebDriver.Options.prototype.logs = function() {<tr><td><a id="l1295"></a><a href="#l1295">1295</a><td>  return new webdriver.WebDriver.Logs(this.driver_);<tr><td><a id="l1296"></a><a href="#l1296">1296</a><td>};<tr><td><a id="l1297"></a><a href="#l1297">1297</a><td><tr><td><a id="l1298"></a><a href="#l1298">1298</a><td><tr><td><a id="l1299"></a><a href="#l1299">1299</a><td>/**<tr><td><a id="l1300"></a><a href="#l1300">1300</a><td> * @return {!webdriver.WebDriver.Timeouts} The interface for managing driver<tr><td><a id="l1301"></a><a href="#l1301">1301</a><td> *     timeouts.<tr><td><a id="l1302"></a><a href="#l1302">1302</a><td> */<tr><td><a id="l1303"></a><a href="#l1303">1303</a><td>webdriver.WebDriver.Options.prototype.timeouts = function() {<tr><td><a id="l1304"></a><a href="#l1304">1304</a><td>  return new webdriver.WebDriver.Timeouts(this.driver_);<tr><td><a id="l1305"></a><a href="#l1305">1305</a><td>};<tr><td><a id="l1306"></a><a href="#l1306">1306</a><td><tr><td><a id="l1307"></a><a href="#l1307">1307</a><td><tr><td><a id="l1308"></a><a href="#l1308">1308</a><td>/**<tr><td><a id="l1309"></a><a href="#l1309">1309</a><td> * @return {!webdriver.WebDriver.Window} The interface for managing the<tr><td><a id="l1310"></a><a href="#l1310">1310</a><td> *     current window.<tr><td><a id="l1311"></a><a href="#l1311">1311</a><td> */<tr><td><a id="l1312"></a><a href="#l1312">1312</a><td>webdriver.WebDriver.Options.prototype.window = function() {<tr><td><a id="l1313"></a><a href="#l1313">1313</a><td>  return new webdriver.WebDriver.Window(this.driver_);<tr><td><a id="l1314"></a><a href="#l1314">1314</a><td>};<tr><td><a id="l1315"></a><a href="#l1315">1315</a><td><tr><td><a id="l1316"></a><a href="#l1316">1316</a><td><tr><td><a id="l1317"></a><a href="#l1317">1317</a><td><tr><td><a id="l1318"></a><a href="#l1318">1318</a><td>/**<tr><td><a id="l1319"></a><a href="#l1319">1319</a><td> * An interface for managing timeout behavior for WebDriver instances.<tr><td><a id="l1320"></a><a href="#l1320">1320</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a id="l1321"></a><a href="#l1321">1321</a><td> * @constructor<tr><td><a id="l1322"></a><a href="#l1322">1322</a><td> */<tr><td><a id="l1323"></a><a href="#l1323">1323</a><td>webdriver.WebDriver.Timeouts = function(driver) {<tr><td><a id="l1324"></a><a href="#l1324">1324</a><td><tr><td><a id="l1325"></a><a href="#l1325">1325</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l1326"></a><a href="#l1326">1326</a><td>  this.driver_ = driver;<tr><td><a id="l1327"></a><a href="#l1327">1327</a><td>};<tr><td><a id="l1328"></a><a href="#l1328">1328</a><td><tr><td><a id="l1329"></a><a href="#l1329">1329</a><td><tr><td><a id="l1330"></a><a href="#l1330">1330</a><td>/**<tr><td><a id="l1331"></a><a href="#l1331">1331</a><td> * Specifies the amount of time the driver should wait when searching for an<tr><td><a id="l1332"></a><a href="#l1332">1332</a><td> * element if it is not immediately present.<tr><td><a id="l1333"></a><a href="#l1333">1333</a><td> *<tr><td><a id="l1334"></a><a href="#l1334">1334</a><td> * When searching for a single element, the driver should poll the page<tr><td><a id="l1335"></a><a href="#l1335">1335</a><td> * until the element has been found, or this timeout expires before failing<tr><td><a id="l1336"></a><a href="#l1336">1336</a><td> * with a {@link bot.ErrorCode.NO_SUCH_ELEMENT} error. When searching<tr><td><a id="l1337"></a><a href="#l1337">1337</a><td> * for multiple elements, the driver should poll the page until at least one<tr><td><a id="l1338"></a><a href="#l1338">1338</a><td> * element has been found or this timeout has expired.<tr><td><a id="l1339"></a><a href="#l1339">1339</a><td> *<tr><td><a id="l1340"></a><a href="#l1340">1340</a><td> * Setting the wait timeout to 0 (its default value), disables implicit<tr><td><a id="l1341"></a><a href="#l1341">1341</a><td> * waiting.<tr><td><a id="l1342"></a><a href="#l1342">1342</a><td> *<tr><td><a id="l1343"></a><a href="#l1343">1343</a><td> * Increasing the implicit wait timeout should be used judiciously as it<tr><td><a id="l1344"></a><a href="#l1344">1344</a><td> * will have an adverse effect on test run time, especially when used with<tr><td><a id="l1345"></a><a href="#l1345">1345</a><td> * slower location strategies like XPath.<tr><td><a id="l1346"></a><a href="#l1346">1346</a><td> *<tr><td><a id="l1347"></a><a href="#l1347">1347</a><td> * @param {number} ms The amount of time to wait, in milliseconds.<tr><td><a id="l1348"></a><a href="#l1348">1348</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1349"></a><a href="#l1349">1349</a><td> *     when the implicit wait timeout has been set.<tr><td><a id="l1350"></a><a href="#l1350">1350</a><td> */<tr><td><a id="l1351"></a><a href="#l1351">1351</a><td>webdriver.WebDriver.Timeouts.prototype.implicitlyWait = function(ms) {<tr><td><a id="l1352"></a><a href="#l1352">1352</a><td>  return this.driver_.schedule(<tr><td><a id="l1353"></a><a href="#l1353">1353</a><td>      new webdriver.Command(webdriver.CommandName.IMPLICITLY_WAIT).<tr><td><a id="l1354"></a><a href="#l1354">1354</a><td>          setParameter(&#39;ms&#39;, ms &lt; 0 ? 0 : ms),<tr><td><a id="l1355"></a><a href="#l1355">1355</a><td>      &#39;WebDriver.manage().timeouts().implicitlyWait(&#39; + ms + &#39;)&#39;);<tr><td><a id="l1356"></a><a href="#l1356">1356</a><td>};<tr><td><a id="l1357"></a><a href="#l1357">1357</a><td><tr><td><a id="l1358"></a><a href="#l1358">1358</a><td><tr><td><a id="l1359"></a><a href="#l1359">1359</a><td>/**<tr><td><a id="l1360"></a><a href="#l1360">1360</a><td> * Sets the amount of time to wait, in milliseconds, for an asynchronous script<tr><td><a id="l1361"></a><a href="#l1361">1361</a><td> * to finish execution before returning an error. If the timeout is less than or<tr><td><a id="l1362"></a><a href="#l1362">1362</a><td> * equal to 0, the script will be allowed to run indefinitely.<tr><td><a id="l1363"></a><a href="#l1363">1363</a><td> *<tr><td><a id="l1364"></a><a href="#l1364">1364</a><td> * @param {number} ms The amount of time to wait, in milliseconds.<tr><td><a id="l1365"></a><a href="#l1365">1365</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1366"></a><a href="#l1366">1366</a><td> *     when the script timeout has been set.<tr><td><a id="l1367"></a><a href="#l1367">1367</a><td> */<tr><td><a id="l1368"></a><a href="#l1368">1368</a><td>webdriver.WebDriver.Timeouts.prototype.setScriptTimeout = function(ms) {<tr><td><a id="l1369"></a><a href="#l1369">1369</a><td>  return this.driver_.schedule(<tr><td><a id="l1370"></a><a href="#l1370">1370</a><td>      new webdriver.Command(webdriver.CommandName.SET_SCRIPT_TIMEOUT).<tr><td><a id="l1371"></a><a href="#l1371">1371</a><td>          setParameter(&#39;ms&#39;, ms &lt; 0 ? 0 : ms),<tr><td><a id="l1372"></a><a href="#l1372">1372</a><td>      &#39;WebDriver.manage().timeouts().setScriptTimeout(&#39; + ms + &#39;)&#39;);<tr><td><a id="l1373"></a><a href="#l1373">1373</a><td>};<tr><td><a id="l1374"></a><a href="#l1374">1374</a><td><tr><td><a id="l1375"></a><a href="#l1375">1375</a><td><tr><td><a id="l1376"></a><a href="#l1376">1376</a><td>/**<tr><td><a id="l1377"></a><a href="#l1377">1377</a><td> * Sets the amount of time to wait for a page load to complete before returning<tr><td><a id="l1378"></a><a href="#l1378">1378</a><td> * an error.  If the timeout is negative, page loads may be indefinite.<tr><td><a id="l1379"></a><a href="#l1379">1379</a><td> * @param {number} ms The amount of time to wait, in milliseconds.<tr><td><a id="l1380"></a><a href="#l1380">1380</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1381"></a><a href="#l1381">1381</a><td> *     when the timeout has been set.<tr><td><a id="l1382"></a><a href="#l1382">1382</a><td> */<tr><td><a id="l1383"></a><a href="#l1383">1383</a><td>webdriver.WebDriver.Timeouts.prototype.pageLoadTimeout = function(ms) {<tr><td><a id="l1384"></a><a href="#l1384">1384</a><td>  return this.driver_.schedule(<tr><td><a id="l1385"></a><a href="#l1385">1385</a><td>      new webdriver.Command(webdriver.CommandName.SET_TIMEOUT).<tr><td><a id="l1386"></a><a href="#l1386">1386</a><td>          setParameter(&#39;type&#39;, &#39;page load&#39;).<tr><td><a id="l1387"></a><a href="#l1387">1387</a><td>          setParameter(&#39;ms&#39;, ms),<tr><td><a id="l1388"></a><a href="#l1388">1388</a><td>      &#39;WebDriver.manage().timeouts().pageLoadTimeout(&#39; + ms + &#39;)&#39;);<tr><td><a id="l1389"></a><a href="#l1389">1389</a><td>};<tr><td><a id="l1390"></a><a href="#l1390">1390</a><td><tr><td><a id="l1391"></a><a href="#l1391">1391</a><td><tr><td><a id="l1392"></a><a href="#l1392">1392</a><td><tr><td><a id="l1393"></a><a href="#l1393">1393</a><td>/**<tr><td><a id="l1394"></a><a href="#l1394">1394</a><td> * An interface for managing the current window.<tr><td><a id="l1395"></a><a href="#l1395">1395</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a id="l1396"></a><a href="#l1396">1396</a><td> * @constructor<tr><td><a id="l1397"></a><a href="#l1397">1397</a><td> */<tr><td><a id="l1398"></a><a href="#l1398">1398</a><td>webdriver.WebDriver.Window = function(driver) {<tr><td><a id="l1399"></a><a href="#l1399">1399</a><td><tr><td><a id="l1400"></a><a href="#l1400">1400</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l1401"></a><a href="#l1401">1401</a><td>  this.driver_ = driver;<tr><td><a id="l1402"></a><a href="#l1402">1402</a><td>};<tr><td><a id="l1403"></a><a href="#l1403">1403</a><td><tr><td><a id="l1404"></a><a href="#l1404">1404</a><td><tr><td><a id="l1405"></a><a href="#l1405">1405</a><td>/**<tr><td><a id="l1406"></a><a href="#l1406">1406</a><td> * Retrieves the window&#39;s current position, relative to the top left corner of<tr><td><a id="l1407"></a><a href="#l1407">1407</a><td> * the screen.<tr><td><a id="l1408"></a><a href="#l1408">1408</a><td> * @return {!webdriver.promise.Promise.&lt;{x: number, y: number}&gt;} A promise that<tr><td><a id="l1409"></a><a href="#l1409">1409</a><td> *     will be resolved with the window&#39;s position in the form of a<tr><td><a id="l1410"></a><a href="#l1410">1410</a><td> *     {x:number, y:number} object literal.<tr><td><a id="l1411"></a><a href="#l1411">1411</a><td> */<tr><td><a id="l1412"></a><a href="#l1412">1412</a><td>webdriver.WebDriver.Window.prototype.getPosition = function() {<tr><td><a id="l1413"></a><a href="#l1413">1413</a><td>  return this.driver_.schedule(<tr><td><a id="l1414"></a><a href="#l1414">1414</a><td>      new webdriver.Command(webdriver.CommandName.GET_WINDOW_POSITION).<tr><td><a id="l1415"></a><a href="#l1415">1415</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;),<tr><td><a id="l1416"></a><a href="#l1416">1416</a><td>      &#39;WebDriver.manage().window().getPosition()&#39;);<tr><td><a id="l1417"></a><a href="#l1417">1417</a><td>};<tr><td><a id="l1418"></a><a href="#l1418">1418</a><td><tr><td><a id="l1419"></a><a href="#l1419">1419</a><td><tr><td><a id="l1420"></a><a href="#l1420">1420</a><td>/**<tr><td><a id="l1421"></a><a href="#l1421">1421</a><td> * Repositions the current window.<tr><td><a id="l1422"></a><a href="#l1422">1422</a><td> * @param {number} x The desired horizontal position, relative to the left side<tr><td><a id="l1423"></a><a href="#l1423">1423</a><td> *     of the screen.<tr><td><a id="l1424"></a><a href="#l1424">1424</a><td> * @param {number} y The desired vertical position, relative to the top of the<tr><td><a id="l1425"></a><a href="#l1425">1425</a><td> *     of the screen.<tr><td><a id="l1426"></a><a href="#l1426">1426</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1427"></a><a href="#l1427">1427</a><td> *     when the command has completed.<tr><td><a id="l1428"></a><a href="#l1428">1428</a><td> */<tr><td><a id="l1429"></a><a href="#l1429">1429</a><td>webdriver.WebDriver.Window.prototype.setPosition = function(x, y) {<tr><td><a id="l1430"></a><a href="#l1430">1430</a><td>  return this.driver_.schedule(<tr><td><a id="l1431"></a><a href="#l1431">1431</a><td>      new webdriver.Command(webdriver.CommandName.SET_WINDOW_POSITION).<tr><td><a id="l1432"></a><a href="#l1432">1432</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;).<tr><td><a id="l1433"></a><a href="#l1433">1433</a><td>          setParameter(&#39;x&#39;, x).<tr><td><a id="l1434"></a><a href="#l1434">1434</a><td>          setParameter(&#39;y&#39;, y),<tr><td><a id="l1435"></a><a href="#l1435">1435</a><td>      &#39;WebDriver.manage().window().setPosition(&#39; + x + &#39;, &#39; + y + &#39;)&#39;);<tr><td><a id="l1436"></a><a href="#l1436">1436</a><td>};<tr><td><a id="l1437"></a><a href="#l1437">1437</a><td><tr><td><a id="l1438"></a><a href="#l1438">1438</a><td><tr><td><a id="l1439"></a><a href="#l1439">1439</a><td>/**<tr><td><a id="l1440"></a><a href="#l1440">1440</a><td> * Retrieves the window&#39;s current size.<tr><td><a id="l1441"></a><a href="#l1441">1441</a><td> * @return {!webdriver.promise.Promise.&lt;{width: number, height: number}&gt;} A<tr><td><a id="l1442"></a><a href="#l1442">1442</a><td> *     promise that will be resolved with the window&#39;s size in the form of a<tr><td><a id="l1443"></a><a href="#l1443">1443</a><td> *     {width:number, height:number} object literal.<tr><td><a id="l1444"></a><a href="#l1444">1444</a><td> */<tr><td><a id="l1445"></a><a href="#l1445">1445</a><td>webdriver.WebDriver.Window.prototype.getSize = function() {<tr><td><a id="l1446"></a><a href="#l1446">1446</a><td>  return this.driver_.schedule(<tr><td><a id="l1447"></a><a href="#l1447">1447</a><td>      new webdriver.Command(webdriver.CommandName.GET_WINDOW_SIZE).<tr><td><a id="l1448"></a><a href="#l1448">1448</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;),<tr><td><a id="l1449"></a><a href="#l1449">1449</a><td>      &#39;WebDriver.manage().window().getSize()&#39;);<tr><td><a id="l1450"></a><a href="#l1450">1450</a><td>};<tr><td><a id="l1451"></a><a href="#l1451">1451</a><td><tr><td><a id="l1452"></a><a href="#l1452">1452</a><td><tr><td><a id="l1453"></a><a href="#l1453">1453</a><td>/**<tr><td><a id="l1454"></a><a href="#l1454">1454</a><td> * Resizes the current window.<tr><td><a id="l1455"></a><a href="#l1455">1455</a><td> * @param {number} width The desired window width.<tr><td><a id="l1456"></a><a href="#l1456">1456</a><td> * @param {number} height The desired window height.<tr><td><a id="l1457"></a><a href="#l1457">1457</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1458"></a><a href="#l1458">1458</a><td> *     when the command has completed.<tr><td><a id="l1459"></a><a href="#l1459">1459</a><td> */<tr><td><a id="l1460"></a><a href="#l1460">1460</a><td>webdriver.WebDriver.Window.prototype.setSize = function(width, height) {<tr><td><a id="l1461"></a><a href="#l1461">1461</a><td>  return this.driver_.schedule(<tr><td><a id="l1462"></a><a href="#l1462">1462</a><td>      new webdriver.Command(webdriver.CommandName.SET_WINDOW_SIZE).<tr><td><a id="l1463"></a><a href="#l1463">1463</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;).<tr><td><a id="l1464"></a><a href="#l1464">1464</a><td>          setParameter(&#39;width&#39;, width).<tr><td><a id="l1465"></a><a href="#l1465">1465</a><td>          setParameter(&#39;height&#39;, height),<tr><td><a id="l1466"></a><a href="#l1466">1466</a><td>      &#39;WebDriver.manage().window().setSize(&#39; + width + &#39;, &#39; + height + &#39;)&#39;);<tr><td><a id="l1467"></a><a href="#l1467">1467</a><td>};<tr><td><a id="l1468"></a><a href="#l1468">1468</a><td><tr><td><a id="l1469"></a><a href="#l1469">1469</a><td><tr><td><a id="l1470"></a><a href="#l1470">1470</a><td>/**<tr><td><a id="l1471"></a><a href="#l1471">1471</a><td> * Maximizes the current window.<tr><td><a id="l1472"></a><a href="#l1472">1472</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1473"></a><a href="#l1473">1473</a><td> *     when the command has completed.<tr><td><a id="l1474"></a><a href="#l1474">1474</a><td> */<tr><td><a id="l1475"></a><a href="#l1475">1475</a><td>webdriver.WebDriver.Window.prototype.maximize = function() {<tr><td><a id="l1476"></a><a href="#l1476">1476</a><td>  return this.driver_.schedule(<tr><td><a id="l1477"></a><a href="#l1477">1477</a><td>      new webdriver.Command(webdriver.CommandName.MAXIMIZE_WINDOW).<tr><td><a id="l1478"></a><a href="#l1478">1478</a><td>          setParameter(&#39;windowHandle&#39;, &#39;current&#39;),<tr><td><a id="l1479"></a><a href="#l1479">1479</a><td>      &#39;WebDriver.manage().window().maximize()&#39;);<tr><td><a id="l1480"></a><a href="#l1480">1480</a><td>};<tr><td><a id="l1481"></a><a href="#l1481">1481</a><td><tr><td><a id="l1482"></a><a href="#l1482">1482</a><td><tr><td><a id="l1483"></a><a href="#l1483">1483</a><td>/**<tr><td><a id="l1484"></a><a href="#l1484">1484</a><td> * Interface for managing WebDriver log records.<tr><td><a id="l1485"></a><a href="#l1485">1485</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a id="l1486"></a><a href="#l1486">1486</a><td> * @constructor<tr><td><a id="l1487"></a><a href="#l1487">1487</a><td> */<tr><td><a id="l1488"></a><a href="#l1488">1488</a><td>webdriver.WebDriver.Logs = function(driver) {<tr><td><a id="l1489"></a><a href="#l1489">1489</a><td><tr><td><a id="l1490"></a><a href="#l1490">1490</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l1491"></a><a href="#l1491">1491</a><td>  this.driver_ = driver;<tr><td><a id="l1492"></a><a href="#l1492">1492</a><td>};<tr><td><a id="l1493"></a><a href="#l1493">1493</a><td><tr><td><a id="l1494"></a><a href="#l1494">1494</a><td><tr><td><a id="l1495"></a><a href="#l1495">1495</a><td>/**<tr><td><a id="l1496"></a><a href="#l1496">1496</a><td> * Fetches available log entries for the given type.<tr><td><a id="l1497"></a><a href="#l1497">1497</a><td> *<tr><td><a id="l1498"></a><a href="#l1498">1498</a><td> * Note that log buffers are reset after each call, meaning that available<tr><td><a id="l1499"></a><a href="#l1499">1499</a><td> * log entries correspond to those entries not yet returned for a given log<tr><td><a id="l1500"></a><a href="#l1500">1500</a><td> * type. In practice, this means that this call will return the available log<tr><td><a id="l1501"></a><a href="#l1501">1501</a><td> * entries since the last call, or from the start of the session.<tr><td><a id="l1502"></a><a href="#l1502">1502</a><td> *<tr><td><a id="l1503"></a><a href="#l1503">1503</a><td> * @param {!webdriver.logging.Type} type The desired log type.<tr><td><a id="l1504"></a><a href="#l1504">1504</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.logging.Entry&gt;&gt;} A<tr><td><a id="l1505"></a><a href="#l1505">1505</a><td> *   promise that will resolve to a list of log entries for the specified<tr><td><a id="l1506"></a><a href="#l1506">1506</a><td> *   type.<tr><td><a id="l1507"></a><a href="#l1507">1507</a><td> */<tr><td><a id="l1508"></a><a href="#l1508">1508</a><td>webdriver.WebDriver.Logs.prototype.get = function(type) {<tr><td><a id="l1509"></a><a href="#l1509">1509</a><td>  return this.driver_.schedule(<tr><td><a id="l1510"></a><a href="#l1510">1510</a><td>      new webdriver.Command(webdriver.CommandName.GET_LOG).<tr><td><a id="l1511"></a><a href="#l1511">1511</a><td>          setParameter(&#39;type&#39;, type),<tr><td><a id="l1512"></a><a href="#l1512">1512</a><td>      &#39;WebDriver.manage().logs().get(&#39; + type + &#39;)&#39;).<tr><td><a id="l1513"></a><a href="#l1513">1513</a><td>      then(function(entries) {<tr><td><a id="l1514"></a><a href="#l1514">1514</a><td>        return goog.array.map(entries, function(entry) {<tr><td><a id="l1515"></a><a href="#l1515">1515</a><td>          if (!(entry instanceof webdriver.logging.Entry)) {<tr><td><a id="l1516"></a><a href="#l1516">1516</a><td>            return new webdriver.logging.Entry(<tr><td><a id="l1517"></a><a href="#l1517">1517</a><td>                entry[&#39;level&#39;], entry[&#39;message&#39;], entry[&#39;timestamp&#39;],<tr><td><a id="l1518"></a><a href="#l1518">1518</a><td>                entry[&#39;type&#39;]);<tr><td><a id="l1519"></a><a href="#l1519">1519</a><td>          }<tr><td><a id="l1520"></a><a href="#l1520">1520</a><td>          return entry;<tr><td><a id="l1521"></a><a href="#l1521">1521</a><td>        });<tr><td><a id="l1522"></a><a href="#l1522">1522</a><td>      });<tr><td><a id="l1523"></a><a href="#l1523">1523</a><td>};<tr><td><a id="l1524"></a><a href="#l1524">1524</a><td><tr><td><a id="l1525"></a><a href="#l1525">1525</a><td><tr><td><a id="l1526"></a><a href="#l1526">1526</a><td>/**<tr><td><a id="l1527"></a><a href="#l1527">1527</a><td> * Retrieves the log types available to this driver.<tr><td><a id="l1528"></a><a href="#l1528">1528</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.logging.Type&gt;&gt;} A<tr><td><a id="l1529"></a><a href="#l1529">1529</a><td> *     promise that will resolve to a list of available log types.<tr><td><a id="l1530"></a><a href="#l1530">1530</a><td> */<tr><td><a id="l1531"></a><a href="#l1531">1531</a><td>webdriver.WebDriver.Logs.prototype.getAvailableLogTypes = function() {<tr><td><a id="l1532"></a><a href="#l1532">1532</a><td>  return this.driver_.schedule(<tr><td><a id="l1533"></a><a href="#l1533">1533</a><td>      new webdriver.Command(webdriver.CommandName.GET_AVAILABLE_LOG_TYPES),<tr><td><a id="l1534"></a><a href="#l1534">1534</a><td>      &#39;WebDriver.manage().logs().getAvailableLogTypes()&#39;);<tr><td><a id="l1535"></a><a href="#l1535">1535</a><td>};<tr><td><a id="l1536"></a><a href="#l1536">1536</a><td><tr><td><a id="l1537"></a><a href="#l1537">1537</a><td><tr><td><a id="l1538"></a><a href="#l1538">1538</a><td><tr><td><a id="l1539"></a><a href="#l1539">1539</a><td>/**<tr><td><a id="l1540"></a><a href="#l1540">1540</a><td> * An interface for changing the focus of the driver to another frame or window.<tr><td><a id="l1541"></a><a href="#l1541">1541</a><td> * @param {!webdriver.WebDriver} driver The parent driver.<tr><td><a id="l1542"></a><a href="#l1542">1542</a><td> * @constructor<tr><td><a id="l1543"></a><a href="#l1543">1543</a><td> */<tr><td><a id="l1544"></a><a href="#l1544">1544</a><td>webdriver.WebDriver.TargetLocator = function(driver) {<tr><td><a id="l1545"></a><a href="#l1545">1545</a><td><tr><td><a id="l1546"></a><a href="#l1546">1546</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l1547"></a><a href="#l1547">1547</a><td>  this.driver_ = driver;<tr><td><a id="l1548"></a><a href="#l1548">1548</a><td>};<tr><td><a id="l1549"></a><a href="#l1549">1549</a><td><tr><td><a id="l1550"></a><a href="#l1550">1550</a><td><tr><td><a id="l1551"></a><a href="#l1551">1551</a><td>/**<tr><td><a id="l1552"></a><a href="#l1552">1552</a><td> * Schedules a command retrieve the {@code document.activeElement} element on<tr><td><a id="l1553"></a><a href="#l1553">1553</a><td> * the current document, or {@code document.body} if activeElement is not<tr><td><a id="l1554"></a><a href="#l1554">1554</a><td> * available.<tr><td><a id="l1555"></a><a href="#l1555">1555</a><td> * @return {!webdriver.WebElementPromise} The active element.<tr><td><a id="l1556"></a><a href="#l1556">1556</a><td> */<tr><td><a id="l1557"></a><a href="#l1557">1557</a><td>webdriver.WebDriver.TargetLocator.prototype.activeElement = function() {<tr><td><a id="l1558"></a><a href="#l1558">1558</a><td>  var id = this.driver_.schedule(<tr><td><a id="l1559"></a><a href="#l1559">1559</a><td>      new webdriver.Command(webdriver.CommandName.GET_ACTIVE_ELEMENT),<tr><td><a id="l1560"></a><a href="#l1560">1560</a><td>      &#39;WebDriver.switchTo().activeElement()&#39;);<tr><td><a id="l1561"></a><a href="#l1561">1561</a><td>  return new webdriver.WebElementPromise(this.driver_, id);<tr><td><a id="l1562"></a><a href="#l1562">1562</a><td>};<tr><td><a id="l1563"></a><a href="#l1563">1563</a><td><tr><td><a id="l1564"></a><a href="#l1564">1564</a><td><tr><td><a id="l1565"></a><a href="#l1565">1565</a><td>/**<tr><td><a id="l1566"></a><a href="#l1566">1566</a><td> * Schedules a command to switch focus of all future commands to the first frame<tr><td><a id="l1567"></a><a href="#l1567">1567</a><td> * on the page.<tr><td><a id="l1568"></a><a href="#l1568">1568</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1569"></a><a href="#l1569">1569</a><td> *     when the driver has changed focus to the default content.<tr><td><a id="l1570"></a><a href="#l1570">1570</a><td> */<tr><td><a id="l1571"></a><a href="#l1571">1571</a><td>webdriver.WebDriver.TargetLocator.prototype.defaultContent = function() {<tr><td><a id="l1572"></a><a href="#l1572">1572</a><td>  return this.driver_.schedule(<tr><td><a id="l1573"></a><a href="#l1573">1573</a><td>      new webdriver.Command(webdriver.CommandName.SWITCH_TO_FRAME).<tr><td><a id="l1574"></a><a href="#l1574">1574</a><td>          setParameter(&#39;id&#39;, null),<tr><td><a id="l1575"></a><a href="#l1575">1575</a><td>      &#39;WebDriver.switchTo().defaultContent()&#39;);<tr><td><a id="l1576"></a><a href="#l1576">1576</a><td>};<tr><td><a id="l1577"></a><a href="#l1577">1577</a><td><tr><td><a id="l1578"></a><a href="#l1578">1578</a><td><tr><td><a id="l1579"></a><a href="#l1579">1579</a><td>/**<tr><td><a id="l1580"></a><a href="#l1580">1580</a><td> * Schedules a command to switch the focus of all future commands to another<tr><td><a id="l1581"></a><a href="#l1581">1581</a><td> * frame on the page.<tr><td><a id="l1582"></a><a href="#l1582">1582</a><td> *<tr><td><a id="l1583"></a><a href="#l1583">1583</a><td> * If the frame is specified by a number, the command will switch to the frame<tr><td><a id="l1584"></a><a href="#l1584">1584</a><td> * by its (zero-based) index into<tr><td><a id="l1585"></a><a href="#l1585">1585</a><td> * [window.frames](https://developer.mozilla.org/en-US/docs/Web/API/Window.frames).<tr><td><a id="l1586"></a><a href="#l1586">1586</a><td> *<tr><td><a id="l1587"></a><a href="#l1587">1587</a><td> * If the frame is specified by a string, the command will select the frame by<tr><td><a id="l1588"></a><a href="#l1588">1588</a><td> * its name or ID. To select sub-frames, simply separate the frame names/IDs by<tr><td><a id="l1589"></a><a href="#l1589">1589</a><td> * dots. As an example, &quot;main.child&quot; will select the frame with the name &quot;main&quot;<tr><td><a id="l1590"></a><a href="#l1590">1590</a><td> * and then its child &quot;child&quot;.<tr><td><a id="l1591"></a><a href="#l1591">1591</a><td> *<tr><td><a id="l1592"></a><a href="#l1592">1592</a><td> * If the specified frame can not be found, the deferred result will errback<tr><td><a id="l1593"></a><a href="#l1593">1593</a><td> * with a {@link bot.ErrorCode.NO_SUCH_FRAME} error.<tr><td><a id="l1594"></a><a href="#l1594">1594</a><td> *<tr><td><a id="l1595"></a><a href="#l1595">1595</a><td> * @param {string|number} nameOrIndex The frame locator.<tr><td><a id="l1596"></a><a href="#l1596">1596</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1597"></a><a href="#l1597">1597</a><td> *     when the driver has changed focus to the specified frame.<tr><td><a id="l1598"></a><a href="#l1598">1598</a><td> */<tr><td><a id="l1599"></a><a href="#l1599">1599</a><td>webdriver.WebDriver.TargetLocator.prototype.frame = function(nameOrIndex) {<tr><td><a id="l1600"></a><a href="#l1600">1600</a><td>  return this.driver_.schedule(<tr><td><a id="l1601"></a><a href="#l1601">1601</a><td>      new webdriver.Command(webdriver.CommandName.SWITCH_TO_FRAME).<tr><td><a id="l1602"></a><a href="#l1602">1602</a><td>          setParameter(&#39;id&#39;, nameOrIndex),<tr><td><a id="l1603"></a><a href="#l1603">1603</a><td>      &#39;WebDriver.switchTo().frame(&#39; + nameOrIndex + &#39;)&#39;);<tr><td><a id="l1604"></a><a href="#l1604">1604</a><td>};<tr><td><a id="l1605"></a><a href="#l1605">1605</a><td><tr><td><a id="l1606"></a><a href="#l1606">1606</a><td><tr><td><a id="l1607"></a><a href="#l1607">1607</a><td>/**<tr><td><a id="l1608"></a><a href="#l1608">1608</a><td> * Schedules a command to switch the focus of all future commands to another<tr><td><a id="l1609"></a><a href="#l1609">1609</a><td> * window. Windows may be specified by their {@code window.name} attribute or<tr><td><a id="l1610"></a><a href="#l1610">1610</a><td> * by its handle (as returned by {@link webdriver.WebDriver#getWindowHandles}).<tr><td><a id="l1611"></a><a href="#l1611">1611</a><td> *<tr><td><a id="l1612"></a><a href="#l1612">1612</a><td> * If the specificed window can not be found, the deferred result will errback<tr><td><a id="l1613"></a><a href="#l1613">1613</a><td> * with a {@link bot.ErrorCode.NO_SUCH_WINDOW} error.<tr><td><a id="l1614"></a><a href="#l1614">1614</a><td> *<tr><td><a id="l1615"></a><a href="#l1615">1615</a><td> * @param {string} nameOrHandle The name or window handle of the window to<tr><td><a id="l1616"></a><a href="#l1616">1616</a><td> *     switch focus to.<tr><td><a id="l1617"></a><a href="#l1617">1617</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1618"></a><a href="#l1618">1618</a><td> *     when the driver has changed focus to the specified window.<tr><td><a id="l1619"></a><a href="#l1619">1619</a><td> */<tr><td><a id="l1620"></a><a href="#l1620">1620</a><td>webdriver.WebDriver.TargetLocator.prototype.window = function(nameOrHandle) {<tr><td><a id="l1621"></a><a href="#l1621">1621</a><td>  return this.driver_.schedule(<tr><td><a id="l1622"></a><a href="#l1622">1622</a><td>      new webdriver.Command(webdriver.CommandName.SWITCH_TO_WINDOW).<tr><td><a id="l1623"></a><a href="#l1623">1623</a><td>          setParameter(&#39;name&#39;, nameOrHandle),<tr><td><a id="l1624"></a><a href="#l1624">1624</a><td>      &#39;WebDriver.switchTo().window(&#39; + nameOrHandle + &#39;)&#39;);<tr><td><a id="l1625"></a><a href="#l1625">1625</a><td>};<tr><td><a id="l1626"></a><a href="#l1626">1626</a><td><tr><td><a id="l1627"></a><a href="#l1627">1627</a><td><tr><td><a id="l1628"></a><a href="#l1628">1628</a><td>/**<tr><td><a id="l1629"></a><a href="#l1629">1629</a><td> * Schedules a command to change focus to the active alert dialog. This command<tr><td><a id="l1630"></a><a href="#l1630">1630</a><td> * will return a {@link bot.ErrorCode.NO_SUCH_ALERT} error if an alert dialog<tr><td><a id="l1631"></a><a href="#l1631">1631</a><td> * is not currently open.<tr><td><a id="l1632"></a><a href="#l1632">1632</a><td> * @return {!webdriver.AlertPromise} The open alert.<tr><td><a id="l1633"></a><a href="#l1633">1633</a><td> */<tr><td><a id="l1634"></a><a href="#l1634">1634</a><td>webdriver.WebDriver.TargetLocator.prototype.alert = function() {<tr><td><a id="l1635"></a><a href="#l1635">1635</a><td>  var text = this.driver_.schedule(<tr><td><a id="l1636"></a><a href="#l1636">1636</a><td>      new webdriver.Command(webdriver.CommandName.GET_ALERT_TEXT),<tr><td><a id="l1637"></a><a href="#l1637">1637</a><td>      &#39;WebDriver.switchTo().alert()&#39;);<tr><td><a id="l1638"></a><a href="#l1638">1638</a><td>  var driver = this.driver_;<tr><td><a id="l1639"></a><a href="#l1639">1639</a><td>  return new webdriver.AlertPromise(driver, text.then(function(text) {<tr><td><a id="l1640"></a><a href="#l1640">1640</a><td>    return new webdriver.Alert(driver, text);<tr><td><a id="l1641"></a><a href="#l1641">1641</a><td>  }));<tr><td><a id="l1642"></a><a href="#l1642">1642</a><td>};<tr><td><a id="l1643"></a><a href="#l1643">1643</a><td><tr><td><a id="l1644"></a><a href="#l1644">1644</a><td><tr><td><a id="l1645"></a><a href="#l1645">1645</a><td>/**<tr><td><a id="l1646"></a><a href="#l1646">1646</a><td> * Simulate pressing many keys at once in a &quot;chord&quot;. Takes a sequence of<tr><td><a id="l1647"></a><a href="#l1647">1647</a><td> * {@link webdriver.Key}s or strings, appends each of the values to a string,<tr><td><a id="l1648"></a><a href="#l1648">1648</a><td> * and adds the chord termination key ({@link webdriver.Key.NULL}) and returns<tr><td><a id="l1649"></a><a href="#l1649">1649</a><td> * the resultant string.<tr><td><a id="l1650"></a><a href="#l1650">1650</a><td> *<tr><td><a id="l1651"></a><a href="#l1651">1651</a><td> * Note: when the low-level webdriver key handlers see Keys.NULL, active<tr><td><a id="l1652"></a><a href="#l1652">1652</a><td> * modifier keys (CTRL/ALT/SHIFT/etc) release via a keyup event.<tr><td><a id="l1653"></a><a href="#l1653">1653</a><td> *<tr><td><a id="l1654"></a><a href="#l1654">1654</a><td> * @param {...string} var_args The key sequence to concatenate.<tr><td><a id="l1655"></a><a href="#l1655">1655</a><td> * @return {string} The null-terminated key sequence.<tr><td><a id="l1656"></a><a href="#l1656">1656</a><td> * @see http://code.google.com/p/webdriver/issues/detail?id=79<tr><td><a id="l1657"></a><a href="#l1657">1657</a><td> */<tr><td><a id="l1658"></a><a href="#l1658">1658</a><td>webdriver.Key.chord = function(var_args) {<tr><td><a id="l1659"></a><a href="#l1659">1659</a><td>  var sequence = goog.array.reduce(<tr><td><a id="l1660"></a><a href="#l1660">1660</a><td>      goog.array.slice(arguments, 0),<tr><td><a id="l1661"></a><a href="#l1661">1661</a><td>      function(str, key) {<tr><td><a id="l1662"></a><a href="#l1662">1662</a><td>        return str + key;<tr><td><a id="l1663"></a><a href="#l1663">1663</a><td>      }, &#39;&#39;);<tr><td><a id="l1664"></a><a href="#l1664">1664</a><td>  sequence += webdriver.Key.NULL;<tr><td><a id="l1665"></a><a href="#l1665">1665</a><td>  return sequence;<tr><td><a id="l1666"></a><a href="#l1666">1666</a><td>};<tr><td><a id="l1667"></a><a href="#l1667">1667</a><td><tr><td><a id="l1668"></a><a href="#l1668">1668</a><td><tr><td><a id="l1669"></a><a href="#l1669">1669</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a id="l1670"></a><a href="#l1670">1670</a><td>//<tr><td><a id="l1671"></a><a href="#l1671">1671</a><td>//  webdriver.WebElement<tr><td><a id="l1672"></a><a href="#l1672">1672</a><td>//<tr><td><a id="l1673"></a><a href="#l1673">1673</a><td>//////////////////////////////////////////////////////////////////////////////<tr><td><a id="l1674"></a><a href="#l1674">1674</a><td><tr><td><a id="l1675"></a><a href="#l1675">1675</a><td><tr><td><a id="l1676"></a><a href="#l1676">1676</a><td><tr><td><a id="l1677"></a><a href="#l1677">1677</a><td>/**<tr><td><a id="l1678"></a><a href="#l1678">1678</a><td> * Represents a DOM element. WebElements can be found by searching from the<tr><td><a id="l1679"></a><a href="#l1679">1679</a><td> * document root using a {@link webdriver.WebDriver} instance, or by searching<tr><td><a id="l1680"></a><a href="#l1680">1680</a><td> * under another WebElement:<tr><td><a id="l1681"></a><a href="#l1681">1681</a><td> *<tr><td><a id="l1682"></a><a href="#l1682">1682</a><td> *     driver.get(&#39;http://www.google.com&#39;);<tr><td><a id="l1683"></a><a href="#l1683">1683</a><td> *     var searchForm = driver.findElement(By.tagName(&#39;form&#39;));<tr><td><a id="l1684"></a><a href="#l1684">1684</a><td> *     var searchBox = searchForm.findElement(By.name(&#39;q&#39;));<tr><td><a id="l1685"></a><a href="#l1685">1685</a><td> *     searchBox.sendKeys(&#39;webdriver&#39;);<tr><td><a id="l1686"></a><a href="#l1686">1686</a><td> *<tr><td><a id="l1687"></a><a href="#l1687">1687</a><td> * The WebElement is implemented as a promise for compatibility with the promise<tr><td><a id="l1688"></a><a href="#l1688">1688</a><td> * API. It will always resolve itself when its internal state has been fully<tr><td><a id="l1689"></a><a href="#l1689">1689</a><td> * resolved and commands may be issued against the element. This can be used to<tr><td><a id="l1690"></a><a href="#l1690">1690</a><td> * catch errors when an element cannot be located on the page:<tr><td><a id="l1691"></a><a href="#l1691">1691</a><td> *<tr><td><a id="l1692"></a><a href="#l1692">1692</a><td> *     driver.findElement(By.id(&#39;not-there&#39;)).then(function(element) {<tr><td><a id="l1693"></a><a href="#l1693">1693</a><td> *       alert(&#39;Found an element that was not expected to be there!&#39;);<tr><td><a id="l1694"></a><a href="#l1694">1694</a><td> *     }, function(error) {<tr><td><a id="l1695"></a><a href="#l1695">1695</a><td> *       alert(&#39;The element was not found, as expected&#39;);<tr><td><a id="l1696"></a><a href="#l1696">1696</a><td> *     });<tr><td><a id="l1697"></a><a href="#l1697">1697</a><td> *<tr><td><a id="l1698"></a><a href="#l1698">1698</a><td> * @param {!webdriver.WebDriver} driver The parent WebDriver instance for this<tr><td><a id="l1699"></a><a href="#l1699">1699</a><td> *     element.<tr><td><a id="l1700"></a><a href="#l1700">1700</a><td> * @param {!(webdriver.promise.Promise.&lt;webdriver.WebElement.Id&gt;|<tr><td><a id="l1701"></a><a href="#l1701">1701</a><td> *           webdriver.WebElement.Id)} id The server-assigned opaque ID for the<tr><td><a id="l1702"></a><a href="#l1702">1702</a><td> *     underlying DOM element.<tr><td><a id="l1703"></a><a href="#l1703">1703</a><td> * @constructor<tr><td><a id="l1704"></a><a href="#l1704">1704</a><td> * @extends {webdriver.Serializable.&lt;webdriver.WebElement.Id&gt;}<tr><td><a id="l1705"></a><a href="#l1705">1705</a><td> */<tr><td><a id="l1706"></a><a href="#l1706">1706</a><td>webdriver.WebElement = function(driver, id) {<tr><td><a id="l1707"></a><a href="#l1707">1707</a><td>  webdriver.Serializable.call(this);<tr><td><a id="l1708"></a><a href="#l1708">1708</a><td><tr><td><a id="l1709"></a><a href="#l1709">1709</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l1710"></a><a href="#l1710">1710</a><td>  this.driver_ = driver;<tr><td><a id="l1711"></a><a href="#l1711">1711</a><td><tr><td><a id="l1712"></a><a href="#l1712">1712</a><td>  /** @private {!webdriver.promise.Promise.&lt;webdriver.WebElement.Id&gt;} */<tr><td><a id="l1713"></a><a href="#l1713">1713</a><td>  this.id_ = id instanceof webdriver.promise.Promise ?<tr><td><a id="l1714"></a><a href="#l1714">1714</a><td>      id : webdriver.promise.fulfilled(id);<tr><td><a id="l1715"></a><a href="#l1715">1715</a><td>};<tr><td><a id="l1716"></a><a href="#l1716">1716</a><td>goog.inherits(webdriver.WebElement, webdriver.Serializable);<tr><td><a id="l1717"></a><a href="#l1717">1717</a><td><tr><td><a id="l1718"></a><a href="#l1718">1718</a><td><tr><td><a id="l1719"></a><a href="#l1719">1719</a><td>/**<tr><td><a id="l1720"></a><a href="#l1720">1720</a><td> * Wire protocol definition of a WebElement ID.<tr><td><a id="l1721"></a><a href="#l1721">1721</a><td> * @typedef {{ELEMENT: string}}<tr><td><a id="l1722"></a><a href="#l1722">1722</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol<tr><td><a id="l1723"></a><a href="#l1723">1723</a><td> */<tr><td><a id="l1724"></a><a href="#l1724">1724</a><td>webdriver.WebElement.Id;<tr><td><a id="l1725"></a><a href="#l1725">1725</a><td><tr><td><a id="l1726"></a><a href="#l1726">1726</a><td><tr><td><a id="l1727"></a><a href="#l1727">1727</a><td>/**<tr><td><a id="l1728"></a><a href="#l1728">1728</a><td> * The property key used in the wire protocol to indicate that a JSON object<tr><td><a id="l1729"></a><a href="#l1729">1729</a><td> * contains the ID of a WebElement.<tr><td><a id="l1730"></a><a href="#l1730">1730</a><td> * @type {string}<tr><td><a id="l1731"></a><a href="#l1731">1731</a><td> * @const<tr><td><a id="l1732"></a><a href="#l1732">1732</a><td> */<tr><td><a id="l1733"></a><a href="#l1733">1733</a><td>webdriver.WebElement.ELEMENT_KEY = &#39;ELEMENT&#39;;<tr><td><a id="l1734"></a><a href="#l1734">1734</a><td><tr><td><a id="l1735"></a><a href="#l1735">1735</a><td><tr><td><a id="l1736"></a><a href="#l1736">1736</a><td>/**<tr><td><a id="l1737"></a><a href="#l1737">1737</a><td> * Compares to WebElements for equality.<tr><td><a id="l1738"></a><a href="#l1738">1738</a><td> * @param {!webdriver.WebElement} a A WebElement.<tr><td><a id="l1739"></a><a href="#l1739">1739</a><td> * @param {!webdriver.WebElement} b A WebElement.<tr><td><a id="l1740"></a><a href="#l1740">1740</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will be<tr><td><a id="l1741"></a><a href="#l1741">1741</a><td> *     resolved to whether the two WebElements are equal.<tr><td><a id="l1742"></a><a href="#l1742">1742</a><td> */<tr><td><a id="l1743"></a><a href="#l1743">1743</a><td>webdriver.WebElement.equals = function(a, b) {<tr><td><a id="l1744"></a><a href="#l1744">1744</a><td>  if (a == b) {<tr><td><a id="l1745"></a><a href="#l1745">1745</a><td>    return webdriver.promise.fulfilled(true);<tr><td><a id="l1746"></a><a href="#l1746">1746</a><td>  }<tr><td><a id="l1747"></a><a href="#l1747">1747</a><td>  var ids = [a.getId(), b.getId()];<tr><td><a id="l1748"></a><a href="#l1748">1748</a><td>  return webdriver.promise.all(ids).then(function(ids) {<tr><td><a id="l1749"></a><a href="#l1749">1749</a><td>    // If the two element&#39;s have the same ID, they should be considered<tr><td><a id="l1750"></a><a href="#l1750">1750</a><td>    // equal. Otherwise, they may still be equivalent, but we&#39;ll need to<tr><td><a id="l1751"></a><a href="#l1751">1751</a><td>    // ask the server to check for us.<tr><td><a id="l1752"></a><a href="#l1752">1752</a><td>    if (ids[0][webdriver.WebElement.ELEMENT_KEY] ==<tr><td><a id="l1753"></a><a href="#l1753">1753</a><td>        ids[1][webdriver.WebElement.ELEMENT_KEY]) {<tr><td><a id="l1754"></a><a href="#l1754">1754</a><td>      return true;<tr><td><a id="l1755"></a><a href="#l1755">1755</a><td>    }<tr><td><a id="l1756"></a><a href="#l1756">1756</a><td><tr><td><a id="l1757"></a><a href="#l1757">1757</a><td>    var command = new webdriver.Command(webdriver.CommandName.ELEMENT_EQUALS);<tr><td><a id="l1758"></a><a href="#l1758">1758</a><td>    command.setParameter(&#39;id&#39;, ids[0]);<tr><td><a id="l1759"></a><a href="#l1759">1759</a><td>    command.setParameter(&#39;other&#39;, ids[1]);<tr><td><a id="l1760"></a><a href="#l1760">1760</a><td>    return a.driver_.schedule(command, &#39;webdriver.WebElement.equals()&#39;);<tr><td><a id="l1761"></a><a href="#l1761">1761</a><td>  });<tr><td><a id="l1762"></a><a href="#l1762">1762</a><td>};<tr><td><a id="l1763"></a><a href="#l1763">1763</a><td><tr><td><a id="l1764"></a><a href="#l1764">1764</a><td><tr><td><a id="l1765"></a><a href="#l1765">1765</a><td>/**<tr><td><a id="l1766"></a><a href="#l1766">1766</a><td> * @return {!webdriver.WebDriver} The parent driver for this instance.<tr><td><a id="l1767"></a><a href="#l1767">1767</a><td> */<tr><td><a id="l1768"></a><a href="#l1768">1768</a><td>webdriver.WebElement.prototype.getDriver = function() {<tr><td><a id="l1769"></a><a href="#l1769">1769</a><td>  return this.driver_;<tr><td><a id="l1770"></a><a href="#l1770">1770</a><td>};<tr><td><a id="l1771"></a><a href="#l1771">1771</a><td><tr><td><a id="l1772"></a><a href="#l1772">1772</a><td><tr><td><a id="l1773"></a><a href="#l1773">1773</a><td>/**<tr><td><a id="l1774"></a><a href="#l1774">1774</a><td> * @return {!webdriver.promise.Promise.&lt;webdriver.WebElement.Id&gt;} A promise<tr><td><a id="l1775"></a><a href="#l1775">1775</a><td> *     that resolves to this element&#39;s JSON representation as defined by the<tr><td><a id="l1776"></a><a href="#l1776">1776</a><td> *     WebDriver wire protocol.<tr><td><a id="l1777"></a><a href="#l1777">1777</a><td> * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol<tr><td><a id="l1778"></a><a href="#l1778">1778</a><td> */<tr><td><a id="l1779"></a><a href="#l1779">1779</a><td>webdriver.WebElement.prototype.getId = function() {<tr><td><a id="l1780"></a><a href="#l1780">1780</a><td>  return this.id_;<tr><td><a id="l1781"></a><a href="#l1781">1781</a><td>};<tr><td><a id="l1782"></a><a href="#l1782">1782</a><td><tr><td><a id="l1783"></a><a href="#l1783">1783</a><td><tr><td><a id="l1784"></a><a href="#l1784">1784</a><td>/**<tr><td><a id="l1785"></a><a href="#l1785">1785</a><td> * Returns the raw ID string ID for this element.<tr><td><a id="l1786"></a><a href="#l1786">1786</a><td> * @return {!webdriver.promise.Promise&lt;string&gt;} A promise that resolves to this<tr><td><a id="l1787"></a><a href="#l1787">1787</a><td> *     element&#39;s raw ID as a string value.<tr><td><a id="l1788"></a><a href="#l1788">1788</a><td> * @package<tr><td><a id="l1789"></a><a href="#l1789">1789</a><td> */<tr><td><a id="l1790"></a><a href="#l1790">1790</a><td>webdriver.WebElement.prototype.getRawId = function() {<tr><td><a id="l1791"></a><a href="#l1791">1791</a><td>  return this.getId().then(function(value) {<tr><td><a id="l1792"></a><a href="#l1792">1792</a><td>    return value[&#39;ELEMENT&#39;];<tr><td><a id="l1793"></a><a href="#l1793">1793</a><td>  });<tr><td><a id="l1794"></a><a href="#l1794">1794</a><td>};<tr><td><a id="l1795"></a><a href="#l1795">1795</a><td><tr><td><a id="l1796"></a><a href="#l1796">1796</a><td><tr><td><a id="l1797"></a><a href="#l1797">1797</a><td>/** @override */<tr><td><a id="l1798"></a><a href="#l1798">1798</a><td>webdriver.WebElement.prototype.serialize = function() {<tr><td><a id="l1799"></a><a href="#l1799">1799</a><td>  return this.getId();<tr><td><a id="l1800"></a><a href="#l1800">1800</a><td>};<tr><td><a id="l1801"></a><a href="#l1801">1801</a><td><tr><td><a id="l1802"></a><a href="#l1802">1802</a><td><tr><td><a id="l1803"></a><a href="#l1803">1803</a><td>/**<tr><td><a id="l1804"></a><a href="#l1804">1804</a><td> * Schedules a command that targets this element with the parent WebDriver<tr><td><a id="l1805"></a><a href="#l1805">1805</a><td> * instance. Will ensure this element&#39;s ID is included in the command parameters<tr><td><a id="l1806"></a><a href="#l1806">1806</a><td> * under the &quot;id&quot; key.<tr><td><a id="l1807"></a><a href="#l1807">1807</a><td> * @param {!webdriver.Command} command The command to schedule.<tr><td><a id="l1808"></a><a href="#l1808">1808</a><td> * @param {string} description A description of the command for debugging.<tr><td><a id="l1809"></a><a href="#l1809">1809</a><td> * @return {!webdriver.promise.Promise.&lt;T&gt;} A promise that will be resolved<tr><td><a id="l1810"></a><a href="#l1810">1810</a><td> *     with the command result.<tr><td><a id="l1811"></a><a href="#l1811">1811</a><td> * @template T<tr><td><a id="l1812"></a><a href="#l1812">1812</a><td> * @see webdriver.WebDriver.prototype.schedule<tr><td><a id="l1813"></a><a href="#l1813">1813</a><td> * @private<tr><td><a id="l1814"></a><a href="#l1814">1814</a><td> */<tr><td><a id="l1815"></a><a href="#l1815">1815</a><td>webdriver.WebElement.prototype.schedule_ = function(command, description) {<tr><td><a id="l1816"></a><a href="#l1816">1816</a><td>  command.setParameter(&#39;id&#39;, this.getId());<tr><td><a id="l1817"></a><a href="#l1817">1817</a><td>  return this.driver_.schedule(command, description);<tr><td><a id="l1818"></a><a href="#l1818">1818</a><td>};<tr><td><a id="l1819"></a><a href="#l1819">1819</a><td><tr><td><a id="l1820"></a><a href="#l1820">1820</a><td><tr><td><a id="l1821"></a><a href="#l1821">1821</a><td>/**<tr><td><a id="l1822"></a><a href="#l1822">1822</a><td> * Schedule a command to find a descendant of this element. If the element<tr><td><a id="l1823"></a><a href="#l1823">1823</a><td> * cannot be found, a {@link bot.ErrorCode.NO_SUCH_ELEMENT} result will<tr><td><a id="l1824"></a><a href="#l1824">1824</a><td> * be returned by the driver. Unlike other commands, this error cannot be<tr><td><a id="l1825"></a><a href="#l1825">1825</a><td> * suppressed. In other words, scheduling a command to find an element doubles<tr><td><a id="l1826"></a><a href="#l1826">1826</a><td> * as an assert that the element is present on the page. To test whether an<tr><td><a id="l1827"></a><a href="#l1827">1827</a><td> * element is present on the page, use {@link #isElementPresent} instead.<tr><td><a id="l1828"></a><a href="#l1828">1828</a><td> *<tr><td><a id="l1829"></a><a href="#l1829">1829</a><td> * The search criteria for an element may be defined using one of the<tr><td><a id="l1830"></a><a href="#l1830">1830</a><td> * factories in the {@link webdriver.By} namespace, or as a short-hand<tr><td><a id="l1831"></a><a href="#l1831">1831</a><td> * {@link webdriver.By.Hash} object. For example, the following two statements<tr><td><a id="l1832"></a><a href="#l1832">1832</a><td> * are equivalent:<tr><td><a id="l1833"></a><a href="#l1833">1833</a><td> *<tr><td><a id="l1834"></a><a href="#l1834">1834</a><td> *     var e1 = element.findElement(By.id(&#39;foo&#39;));<tr><td><a id="l1835"></a><a href="#l1835">1835</a><td> *     var e2 = element.findElement({id:&#39;foo&#39;});<tr><td><a id="l1836"></a><a href="#l1836">1836</a><td> *<tr><td><a id="l1837"></a><a href="#l1837">1837</a><td> * You may also provide a custom locator function, which takes as input<tr><td><a id="l1838"></a><a href="#l1838">1838</a><td> * this WebDriver instance and returns a {@link webdriver.WebElement}, or a<tr><td><a id="l1839"></a><a href="#l1839">1839</a><td> * promise that will resolve to a WebElement. For example, to find the first<tr><td><a id="l1840"></a><a href="#l1840">1840</a><td> * visible link on a page, you could write:<tr><td><a id="l1841"></a><a href="#l1841">1841</a><td> *<tr><td><a id="l1842"></a><a href="#l1842">1842</a><td> *     var link = element.findElement(firstVisibleLink);<tr><td><a id="l1843"></a><a href="#l1843">1843</a><td> *<tr><td><a id="l1844"></a><a href="#l1844">1844</a><td> *     function firstVisibleLink(element) {<tr><td><a id="l1845"></a><a href="#l1845">1845</a><td> *       var links = element.findElements(By.tagName(&#39;a&#39;));<tr><td><a id="l1846"></a><a href="#l1846">1846</a><td> *       return webdriver.promise.filter(links, function(link) {<tr><td><a id="l1847"></a><a href="#l1847">1847</a><td> *         return links.isDisplayed();<tr><td><a id="l1848"></a><a href="#l1848">1848</a><td> *       }).then(function(visibleLinks) {<tr><td><a id="l1849"></a><a href="#l1849">1849</a><td> *         return visibleLinks[0];<tr><td><a id="l1850"></a><a href="#l1850">1850</a><td> *       });<tr><td><a id="l1851"></a><a href="#l1851">1851</a><td> *     }<tr><td><a id="l1852"></a><a href="#l1852">1852</a><td> *<tr><td><a id="l1853"></a><a href="#l1853">1853</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The<tr><td><a id="l1854"></a><a href="#l1854">1854</a><td> *     locator strategy to use when searching for the element.<tr><td><a id="l1855"></a><a href="#l1855">1855</a><td> * @return {!webdriver.WebElement} A WebElement that can be used to issue<tr><td><a id="l1856"></a><a href="#l1856">1856</a><td> *     commands against the located element. If the element is not found, the<tr><td><a id="l1857"></a><a href="#l1857">1857</a><td> *     element will be invalidated and all scheduled commands aborted.<tr><td><a id="l1858"></a><a href="#l1858">1858</a><td> */<tr><td><a id="l1859"></a><a href="#l1859">1859</a><td>webdriver.WebElement.prototype.findElement = function(locator) {<tr><td><a id="l1860"></a><a href="#l1860">1860</a><td>  locator = webdriver.Locator.checkLocator(locator);<tr><td><a id="l1861"></a><a href="#l1861">1861</a><td>  var id;<tr><td><a id="l1862"></a><a href="#l1862">1862</a><td>  if (goog.isFunction(locator)) {<tr><td><a id="l1863"></a><a href="#l1863">1863</a><td>    id = this.driver_.findElementInternal_(locator, this);<tr><td><a id="l1864"></a><a href="#l1864">1864</a><td>  } else {<tr><td><a id="l1865"></a><a href="#l1865">1865</a><td>    var command = new webdriver.Command(<tr><td><a id="l1866"></a><a href="#l1866">1866</a><td>        webdriver.CommandName.FIND_CHILD_ELEMENT).<tr><td><a id="l1867"></a><a href="#l1867">1867</a><td>        setParameter(&#39;using&#39;, locator.using).<tr><td><a id="l1868"></a><a href="#l1868">1868</a><td>        setParameter(&#39;value&#39;, locator.value);<tr><td><a id="l1869"></a><a href="#l1869">1869</a><td>    id = this.schedule_(command, &#39;WebElement.findElement(&#39; + locator + &#39;)&#39;);<tr><td><a id="l1870"></a><a href="#l1870">1870</a><td>  }<tr><td><a id="l1871"></a><a href="#l1871">1871</a><td>  return new webdriver.WebElementPromise(this.driver_, id);<tr><td><a id="l1872"></a><a href="#l1872">1872</a><td>};<tr><td><a id="l1873"></a><a href="#l1873">1873</a><td><tr><td><a id="l1874"></a><a href="#l1874">1874</a><td><tr><td><a id="l1875"></a><a href="#l1875">1875</a><td>/**<tr><td><a id="l1876"></a><a href="#l1876">1876</a><td> * Schedules a command to test if there is at least one descendant of this<tr><td><a id="l1877"></a><a href="#l1877">1877</a><td> * element that matches the given search criteria.<tr><td><a id="l1878"></a><a href="#l1878">1878</a><td> *<tr><td><a id="l1879"></a><a href="#l1879">1879</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The<tr><td><a id="l1880"></a><a href="#l1880">1880</a><td> *     locator strategy to use when searching for the element.<tr><td><a id="l1881"></a><a href="#l1881">1881</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will be<tr><td><a id="l1882"></a><a href="#l1882">1882</a><td> *     resolved with whether an element could be located on the page.<tr><td><a id="l1883"></a><a href="#l1883">1883</a><td> */<tr><td><a id="l1884"></a><a href="#l1884">1884</a><td>webdriver.WebElement.prototype.isElementPresent = function(locator) {<tr><td><a id="l1885"></a><a href="#l1885">1885</a><td>  return this.findElements(locator).then(function(result) {<tr><td><a id="l1886"></a><a href="#l1886">1886</a><td>    return !!result.length;<tr><td><a id="l1887"></a><a href="#l1887">1887</a><td>  });<tr><td><a id="l1888"></a><a href="#l1888">1888</a><td>};<tr><td><a id="l1889"></a><a href="#l1889">1889</a><td><tr><td><a id="l1890"></a><a href="#l1890">1890</a><td><tr><td><a id="l1891"></a><a href="#l1891">1891</a><td>/**<tr><td><a id="l1892"></a><a href="#l1892">1892</a><td> * Schedules a command to find all of the descendants of this element that<tr><td><a id="l1893"></a><a href="#l1893">1893</a><td> * match the given search criteria.<tr><td><a id="l1894"></a><a href="#l1894">1894</a><td> *<tr><td><a id="l1895"></a><a href="#l1895">1895</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The<tr><td><a id="l1896"></a><a href="#l1896">1896</a><td> *     locator strategy to use when searching for the elements.<tr><td><a id="l1897"></a><a href="#l1897">1897</a><td> * @return {!webdriver.promise.Promise.&lt;!Array.&lt;!webdriver.WebElement&gt;&gt;} A<tr><td><a id="l1898"></a><a href="#l1898">1898</a><td> *     promise that will resolve to an array of WebElements.<tr><td><a id="l1899"></a><a href="#l1899">1899</a><td> */<tr><td><a id="l1900"></a><a href="#l1900">1900</a><td>webdriver.WebElement.prototype.findElements = function(locator) {<tr><td><a id="l1901"></a><a href="#l1901">1901</a><td>  locator = webdriver.Locator.checkLocator(locator);<tr><td><a id="l1902"></a><a href="#l1902">1902</a><td>  if (goog.isFunction(locator)) {<tr><td><a id="l1903"></a><a href="#l1903">1903</a><td>    return this.driver_.findElementsInternal_(locator, this);<tr><td><a id="l1904"></a><a href="#l1904">1904</a><td>  } else {<tr><td><a id="l1905"></a><a href="#l1905">1905</a><td>    var command = new webdriver.Command(<tr><td><a id="l1906"></a><a href="#l1906">1906</a><td>        webdriver.CommandName.FIND_CHILD_ELEMENTS).<tr><td><a id="l1907"></a><a href="#l1907">1907</a><td>        setParameter(&#39;using&#39;, locator.using).<tr><td><a id="l1908"></a><a href="#l1908">1908</a><td>        setParameter(&#39;value&#39;, locator.value);<tr><td><a id="l1909"></a><a href="#l1909">1909</a><td>    return this.schedule_(command, &#39;WebElement.findElements(&#39; + locator + &#39;)&#39;);<tr><td><a id="l1910"></a><a href="#l1910">1910</a><td>  }<tr><td><a id="l1911"></a><a href="#l1911">1911</a><td>};<tr><td><a id="l1912"></a><a href="#l1912">1912</a><td><tr><td><a id="l1913"></a><a href="#l1913">1913</a><td><tr><td><a id="l1914"></a><a href="#l1914">1914</a><td>/**<tr><td><a id="l1915"></a><a href="#l1915">1915</a><td> * Schedules a command to click on this element.<tr><td><a id="l1916"></a><a href="#l1916">1916</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1917"></a><a href="#l1917">1917</a><td> *     when the click command has completed.<tr><td><a id="l1918"></a><a href="#l1918">1918</a><td> */<tr><td><a id="l1919"></a><a href="#l1919">1919</a><td>webdriver.WebElement.prototype.click = function() {<tr><td><a id="l1920"></a><a href="#l1920">1920</a><td>  return this.schedule_(<tr><td><a id="l1921"></a><a href="#l1921">1921</a><td>      new webdriver.Command(webdriver.CommandName.CLICK_ELEMENT),<tr><td><a id="l1922"></a><a href="#l1922">1922</a><td>      &#39;WebElement.click()&#39;);<tr><td><a id="l1923"></a><a href="#l1923">1923</a><td>};<tr><td><a id="l1924"></a><a href="#l1924">1924</a><td><tr><td><a id="l1925"></a><a href="#l1925">1925</a><td><tr><td><a id="l1926"></a><a href="#l1926">1926</a><td>/**<tr><td><a id="l1927"></a><a href="#l1927">1927</a><td> * Schedules a command to type a sequence on the DOM element represented by this<tr><td><a id="l1928"></a><a href="#l1928">1928</a><td> * instance.<tr><td><a id="l1929"></a><a href="#l1929">1929</a><td> *<tr><td><a id="l1930"></a><a href="#l1930">1930</a><td> * Modifier keys (SHIFT, CONTROL, ALT, META) are stateful; once a modifier is<tr><td><a id="l1931"></a><a href="#l1931">1931</a><td> * processed in the keysequence, that key state is toggled until one of the<tr><td><a id="l1932"></a><a href="#l1932">1932</a><td> * following occurs:<tr><td><a id="l1933"></a><a href="#l1933">1933</a><td> *<tr><td><a id="l1934"></a><a href="#l1934">1934</a><td> * - The modifier key is encountered again in the sequence. At this point the<tr><td><a id="l1935"></a><a href="#l1935">1935</a><td> *   state of the key is toggled (along with the appropriate keyup/down events).<tr><td><a id="l1936"></a><a href="#l1936">1936</a><td> * - The {@link webdriver.Key.NULL} key is encountered in the sequence. When<tr><td><a id="l1937"></a><a href="#l1937">1937</a><td> *   this key is encountered, all modifier keys current in the down state are<tr><td><a id="l1938"></a><a href="#l1938">1938</a><td> *   released (with accompanying keyup events). The NULL key can be used to<tr><td><a id="l1939"></a><a href="#l1939">1939</a><td> *   simulate common keyboard shortcuts:<tr><td><a id="l1940"></a><a href="#l1940">1940</a><td> *<tr><td><a id="l1941"></a><a href="#l1941">1941</a><td> *         element.sendKeys(&quot;text was&quot;,<tr><td><a id="l1942"></a><a href="#l1942">1942</a><td> *                          webdriver.Key.CONTROL, &quot;a&quot;, webdriver.Key.NULL,<tr><td><a id="l1943"></a><a href="#l1943">1943</a><td> *                          &quot;now text is&quot;);<tr><td><a id="l1944"></a><a href="#l1944">1944</a><td> *         // Alternatively:<tr><td><a id="l1945"></a><a href="#l1945">1945</a><td> *         element.sendKeys(&quot;text was&quot;,<tr><td><a id="l1946"></a><a href="#l1946">1946</a><td> *                          webdriver.Key.chord(webdriver.Key.CONTROL, &quot;a&quot;),<tr><td><a id="l1947"></a><a href="#l1947">1947</a><td> *                          &quot;now text is&quot;);<tr><td><a id="l1948"></a><a href="#l1948">1948</a><td> *<tr><td><a id="l1949"></a><a href="#l1949">1949</a><td> * - The end of the keysequence is encountered. When there are no more keys<tr><td><a id="l1950"></a><a href="#l1950">1950</a><td> *   to type, all depressed modifier keys are released (with accompanying keyup<tr><td><a id="l1951"></a><a href="#l1951">1951</a><td> *   events).<tr><td><a id="l1952"></a><a href="#l1952">1952</a><td> *<tr><td><a id="l1953"></a><a href="#l1953">1953</a><td> * If this element is a file input ({@code &lt;input type=&quot;file&quot;&gt;}), the<tr><td><a id="l1954"></a><a href="#l1954">1954</a><td> * specified key sequence should specify the path to the file to attach to<tr><td><a id="l1955"></a><a href="#l1955">1955</a><td> * the element. This is analgous to the user clicking &quot;Browse...&quot; and entering<tr><td><a id="l1956"></a><a href="#l1956">1956</a><td> * the path into the file select dialog.<tr><td><a id="l1957"></a><a href="#l1957">1957</a><td> *<tr><td><a id="l1958"></a><a href="#l1958">1958</a><td> *     var form = driver.findElement(By.css(&#39;form&#39;));<tr><td><a id="l1959"></a><a href="#l1959">1959</a><td> *     var element = form.findElement(By.css(&#39;input[type=file]&#39;));<tr><td><a id="l1960"></a><a href="#l1960">1960</a><td> *     element.sendKeys(&#39;/path/to/file.txt&#39;);<tr><td><a id="l1961"></a><a href="#l1961">1961</a><td> *     form.submit();<tr><td><a id="l1962"></a><a href="#l1962">1962</a><td> *<tr><td><a id="l1963"></a><a href="#l1963">1963</a><td> * For uploads to function correctly, the entered path must reference a file<tr><td><a id="l1964"></a><a href="#l1964">1964</a><td> * on the _browser&#39;s_ machine, not the local machine running this script. When<tr><td><a id="l1965"></a><a href="#l1965">1965</a><td> * running against a remote Selenium server, a {@link webdriver.FileDetector}<tr><td><a id="l1966"></a><a href="#l1966">1966</a><td> * may be used to transparently copy files to the remote machine before<tr><td><a id="l1967"></a><a href="#l1967">1967</a><td> * attempting to upload them in the browser.<tr><td><a id="l1968"></a><a href="#l1968">1968</a><td> *<tr><td><a id="l1969"></a><a href="#l1969">1969</a><td> * __Note:__ On browsers where native keyboard events are not supported<tr><td><a id="l1970"></a><a href="#l1970">1970</a><td> * (e.g. Firefox on OS X), key events will be synthesized. Special<tr><td><a id="l1971"></a><a href="#l1971">1971</a><td> * punctionation keys will be synthesized according to a standard QWERTY en-us<tr><td><a id="l1972"></a><a href="#l1972">1972</a><td> * keyboard layout.<tr><td><a id="l1973"></a><a href="#l1973">1973</a><td> *<tr><td><a id="l1974"></a><a href="#l1974">1974</a><td> * @param {...(string|!webdriver.promise.Promise&lt;string&gt;)} var_args The sequence<tr><td><a id="l1975"></a><a href="#l1975">1975</a><td> *     of keys to type. All arguments will be joined into a single sequence.<tr><td><a id="l1976"></a><a href="#l1976">1976</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l1977"></a><a href="#l1977">1977</a><td> *     when all keys have been typed.<tr><td><a id="l1978"></a><a href="#l1978">1978</a><td> */<tr><td><a id="l1979"></a><a href="#l1979">1979</a><td>webdriver.WebElement.prototype.sendKeys = function(var_args) {<tr><td><a id="l1980"></a><a href="#l1980">1980</a><td>  // Coerce every argument to a string. This protects us from users that<tr><td><a id="l1981"></a><a href="#l1981">1981</a><td>  // ignore the jsdoc and give us a number (which ends up causing problems on<tr><td><a id="l1982"></a><a href="#l1982">1982</a><td>  // the server, which requires strings).<tr><td><a id="l1983"></a><a href="#l1983">1983</a><td>  var keys = webdriver.promise.all(goog.array.slice(arguments, 0)).<tr><td><a id="l1984"></a><a href="#l1984">1984</a><td>      then(function(keys) {<tr><td><a id="l1985"></a><a href="#l1985">1985</a><td>        return goog.array.map(keys, String);<tr><td><a id="l1986"></a><a href="#l1986">1986</a><td>      });<tr><td><a id="l1987"></a><a href="#l1987">1987</a><td>  if (!this.driver_.fileDetector_) {<tr><td><a id="l1988"></a><a href="#l1988">1988</a><td>    return this.schedule_(<tr><td><a id="l1989"></a><a href="#l1989">1989</a><td>        new webdriver.Command(webdriver.CommandName.SEND_KEYS_TO_ELEMENT).<tr><td><a id="l1990"></a><a href="#l1990">1990</a><td>            setParameter(&#39;value&#39;, keys),<tr><td><a id="l1991"></a><a href="#l1991">1991</a><td>        &#39;WebElement.sendKeys()&#39;);<tr><td><a id="l1992"></a><a href="#l1992">1992</a><td>  }<tr><td><a id="l1993"></a><a href="#l1993">1993</a><td><tr><td><a id="l1994"></a><a href="#l1994">1994</a><td>  // Suppress unhandled rejection errors until the flow executes the command.<tr><td><a id="l1995"></a><a href="#l1995">1995</a><td>  keys.thenCatch(goog.nullFunction);<tr><td><a id="l1996"></a><a href="#l1996">1996</a><td><tr><td><a id="l1997"></a><a href="#l1997">1997</a><td>  var element = this;<tr><td><a id="l1998"></a><a href="#l1998">1998</a><td>  return this.driver_.flow_.execute(function() {<tr><td><a id="l1999"></a><a href="#l1999">1999</a><td>    return keys.then(function(keys) {<tr><td><a id="l2000"></a><a href="#l2000">2000</a><td>      return element.driver_.fileDetector_<tr><td><a id="l2001"></a><a href="#l2001">2001</a><td>          .handleFile(element.driver_, keys.join(&#39;&#39;));<tr><td><a id="l2002"></a><a href="#l2002">2002</a><td>    }).then(function(keys) {<tr><td><a id="l2003"></a><a href="#l2003">2003</a><td>      return element.schedule_(<tr><td><a id="l2004"></a><a href="#l2004">2004</a><td>          new webdriver.Command(webdriver.CommandName.SEND_KEYS_TO_ELEMENT).<tr><td><a id="l2005"></a><a href="#l2005">2005</a><td>              setParameter(&#39;value&#39;, [keys]),<tr><td><a id="l2006"></a><a href="#l2006">2006</a><td>          &#39;WebElement.sendKeys()&#39;);<tr><td><a id="l2007"></a><a href="#l2007">2007</a><td>    });<tr><td><a id="l2008"></a><a href="#l2008">2008</a><td>  }, &#39;WebElement.sendKeys()&#39;);<tr><td><a id="l2009"></a><a href="#l2009">2009</a><td>};<tr><td><a id="l2010"></a><a href="#l2010">2010</a><td><tr><td><a id="l2011"></a><a href="#l2011">2011</a><td><tr><td><a id="l2012"></a><a href="#l2012">2012</a><td>/**<tr><td><a id="l2013"></a><a href="#l2013">2013</a><td> * Schedules a command to query for the tag/node name of this element.<tr><td><a id="l2014"></a><a href="#l2014">2014</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l2015"></a><a href="#l2015">2015</a><td> *     resolved with the element&#39;s tag name.<tr><td><a id="l2016"></a><a href="#l2016">2016</a><td> */<tr><td><a id="l2017"></a><a href="#l2017">2017</a><td>webdriver.WebElement.prototype.getTagName = function() {<tr><td><a id="l2018"></a><a href="#l2018">2018</a><td>  return this.schedule_(<tr><td><a id="l2019"></a><a href="#l2019">2019</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_TAG_NAME),<tr><td><a id="l2020"></a><a href="#l2020">2020</a><td>      &#39;WebElement.getTagName()&#39;);<tr><td><a id="l2021"></a><a href="#l2021">2021</a><td>};<tr><td><a id="l2022"></a><a href="#l2022">2022</a><td><tr><td><a id="l2023"></a><a href="#l2023">2023</a><td><tr><td><a id="l2024"></a><a href="#l2024">2024</a><td>/**<tr><td><a id="l2025"></a><a href="#l2025">2025</a><td> * Schedules a command to query for the computed style of the element<tr><td><a id="l2026"></a><a href="#l2026">2026</a><td> * represented by this instance. If the element inherits the named style from<tr><td><a id="l2027"></a><a href="#l2027">2027</a><td> * its parent, the parent will be queried for its value.  Where possible, color<tr><td><a id="l2028"></a><a href="#l2028">2028</a><td> * values will be converted to their hex representation (e.g. #00ff00 instead of<tr><td><a id="l2029"></a><a href="#l2029">2029</a><td> * rgb(0, 255, 0)).<tr><td><a id="l2030"></a><a href="#l2030">2030</a><td> *<tr><td><a id="l2031"></a><a href="#l2031">2031</a><td> * _Warning:_ the value returned will be as the browser interprets it, so<tr><td><a id="l2032"></a><a href="#l2032">2032</a><td> * it may be tricky to form a proper assertion.<tr><td><a id="l2033"></a><a href="#l2033">2033</a><td> *<tr><td><a id="l2034"></a><a href="#l2034">2034</a><td> * @param {string} cssStyleProperty The name of the CSS style property to look<tr><td><a id="l2035"></a><a href="#l2035">2035</a><td> *     up.<tr><td><a id="l2036"></a><a href="#l2036">2036</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l2037"></a><a href="#l2037">2037</a><td> *     resolved with the requested CSS value.<tr><td><a id="l2038"></a><a href="#l2038">2038</a><td> */<tr><td><a id="l2039"></a><a href="#l2039">2039</a><td>webdriver.WebElement.prototype.getCssValue = function(cssStyleProperty) {<tr><td><a id="l2040"></a><a href="#l2040">2040</a><td>  var name = webdriver.CommandName.GET_ELEMENT_VALUE_OF_CSS_PROPERTY;<tr><td><a id="l2041"></a><a href="#l2041">2041</a><td>  return this.schedule_(<tr><td><a id="l2042"></a><a href="#l2042">2042</a><td>      new webdriver.Command(name).<tr><td><a id="l2043"></a><a href="#l2043">2043</a><td>          setParameter(&#39;propertyName&#39;, cssStyleProperty),<tr><td><a id="l2044"></a><a href="#l2044">2044</a><td>      &#39;WebElement.getCssValue(&#39; + cssStyleProperty + &#39;)&#39;);<tr><td><a id="l2045"></a><a href="#l2045">2045</a><td>};<tr><td><a id="l2046"></a><a href="#l2046">2046</a><td><tr><td><a id="l2047"></a><a href="#l2047">2047</a><td><tr><td><a id="l2048"></a><a href="#l2048">2048</a><td>/**<tr><td><a id="l2049"></a><a href="#l2049">2049</a><td> * Schedules a command to query for the value of the given attribute of the<tr><td><a id="l2050"></a><a href="#l2050">2050</a><td> * element. Will return the current value, even if it has been modified after<tr><td><a id="l2051"></a><a href="#l2051">2051</a><td> * the page has been loaded. More exactly, this method will return the value of<tr><td><a id="l2052"></a><a href="#l2052">2052</a><td> * the given attribute, unless that attribute is not present, in which case the<tr><td><a id="l2053"></a><a href="#l2053">2053</a><td> * value of the property with the same name is returned. If neither value is<tr><td><a id="l2054"></a><a href="#l2054">2054</a><td> * set, null is returned (for example, the &quot;value&quot; property of a textarea<tr><td><a id="l2055"></a><a href="#l2055">2055</a><td> * element). The &quot;style&quot; attribute is converted as best can be to a<tr><td><a id="l2056"></a><a href="#l2056">2056</a><td> * text representation with a trailing semi-colon. The following are deemed to<tr><td><a id="l2057"></a><a href="#l2057">2057</a><td> * be &quot;boolean&quot; attributes and will return either &quot;true&quot; or null:<tr><td><a id="l2058"></a><a href="#l2058">2058</a><td> *<tr><td><a id="l2059"></a><a href="#l2059">2059</a><td> * async, autofocus, autoplay, checked, compact, complete, controls, declare,<tr><td><a id="l2060"></a><a href="#l2060">2060</a><td> * defaultchecked, defaultselected, defer, disabled, draggable, ended,<tr><td><a id="l2061"></a><a href="#l2061">2061</a><td> * formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope,<tr><td><a id="l2062"></a><a href="#l2062">2062</a><td> * loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open,<tr><td><a id="l2063"></a><a href="#l2063">2063</a><td> * paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,<tr><td><a id="l2064"></a><a href="#l2064">2064</a><td> * selected, spellcheck, truespeed, willvalidate<tr><td><a id="l2065"></a><a href="#l2065">2065</a><td> *<tr><td><a id="l2066"></a><a href="#l2066">2066</a><td> * Finally, the following commonly mis-capitalized attribute/property names<tr><td><a id="l2067"></a><a href="#l2067">2067</a><td> * are evaluated as expected:<tr><td><a id="l2068"></a><a href="#l2068">2068</a><td> *<tr><td><a id="l2069"></a><a href="#l2069">2069</a><td> * - &quot;class&quot;<tr><td><a id="l2070"></a><a href="#l2070">2070</a><td> * - &quot;readonly&quot;<tr><td><a id="l2071"></a><a href="#l2071">2071</a><td> *<tr><td><a id="l2072"></a><a href="#l2072">2072</a><td> * @param {string} attributeName The name of the attribute to query.<tr><td><a id="l2073"></a><a href="#l2073">2073</a><td> * @return {!webdriver.promise.Promise.&lt;?string&gt;} A promise that will be<tr><td><a id="l2074"></a><a href="#l2074">2074</a><td> *     resolved with the attribute&#39;s value. The returned value will always be<tr><td><a id="l2075"></a><a href="#l2075">2075</a><td> *     either a string or null.<tr><td><a id="l2076"></a><a href="#l2076">2076</a><td> */<tr><td><a id="l2077"></a><a href="#l2077">2077</a><td>webdriver.WebElement.prototype.getAttribute = function(attributeName) {<tr><td><a id="l2078"></a><a href="#l2078">2078</a><td>  return this.schedule_(<tr><td><a id="l2079"></a><a href="#l2079">2079</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_ATTRIBUTE).<tr><td><a id="l2080"></a><a href="#l2080">2080</a><td>          setParameter(&#39;name&#39;, attributeName),<tr><td><a id="l2081"></a><a href="#l2081">2081</a><td>      &#39;WebElement.getAttribute(&#39; + attributeName + &#39;)&#39;);<tr><td><a id="l2082"></a><a href="#l2082">2082</a><td>};<tr><td><a id="l2083"></a><a href="#l2083">2083</a><td><tr><td><a id="l2084"></a><a href="#l2084">2084</a><td><tr><td><a id="l2085"></a><a href="#l2085">2085</a><td>/**<tr><td><a id="l2086"></a><a href="#l2086">2086</a><td> * Get the visible (i.e. not hidden by CSS) innerText of this element, including<tr><td><a id="l2087"></a><a href="#l2087">2087</a><td> * sub-elements, without any leading or trailing whitespace.<tr><td><a id="l2088"></a><a href="#l2088">2088</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l2089"></a><a href="#l2089">2089</a><td> *     resolved with the element&#39;s visible text.<tr><td><a id="l2090"></a><a href="#l2090">2090</a><td> */<tr><td><a id="l2091"></a><a href="#l2091">2091</a><td>webdriver.WebElement.prototype.getText = function() {<tr><td><a id="l2092"></a><a href="#l2092">2092</a><td>  return this.schedule_(<tr><td><a id="l2093"></a><a href="#l2093">2093</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_TEXT),<tr><td><a id="l2094"></a><a href="#l2094">2094</a><td>      &#39;WebElement.getText()&#39;);<tr><td><a id="l2095"></a><a href="#l2095">2095</a><td>};<tr><td><a id="l2096"></a><a href="#l2096">2096</a><td><tr><td><a id="l2097"></a><a href="#l2097">2097</a><td><tr><td><a id="l2098"></a><a href="#l2098">2098</a><td>/**<tr><td><a id="l2099"></a><a href="#l2099">2099</a><td> * Schedules a command to compute the size of this element&#39;s bounding box, in<tr><td><a id="l2100"></a><a href="#l2100">2100</a><td> * pixels.<tr><td><a id="l2101"></a><a href="#l2101">2101</a><td> * @return {!webdriver.promise.Promise.&lt;{width: number, height: number}&gt;} A<tr><td><a id="l2102"></a><a href="#l2102">2102</a><td> *     promise that will be resolved with the element&#39;s size as a<tr><td><a id="l2103"></a><a href="#l2103">2103</a><td> *     {@code {width:number, height:number}} object.<tr><td><a id="l2104"></a><a href="#l2104">2104</a><td> */<tr><td><a id="l2105"></a><a href="#l2105">2105</a><td>webdriver.WebElement.prototype.getSize = function() {<tr><td><a id="l2106"></a><a href="#l2106">2106</a><td>  return this.schedule_(<tr><td><a id="l2107"></a><a href="#l2107">2107</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_SIZE),<tr><td><a id="l2108"></a><a href="#l2108">2108</a><td>      &#39;WebElement.getSize()&#39;);<tr><td><a id="l2109"></a><a href="#l2109">2109</a><td>};<tr><td><a id="l2110"></a><a href="#l2110">2110</a><td><tr><td><a id="l2111"></a><a href="#l2111">2111</a><td><tr><td><a id="l2112"></a><a href="#l2112">2112</a><td>/**<tr><td><a id="l2113"></a><a href="#l2113">2113</a><td> * Schedules a command to compute the location of this element in page space.<tr><td><a id="l2114"></a><a href="#l2114">2114</a><td> * @return {!webdriver.promise.Promise.&lt;{x: number, y: number}&gt;} A promise that<tr><td><a id="l2115"></a><a href="#l2115">2115</a><td> *     will be resolved to the element&#39;s location as a<tr><td><a id="l2116"></a><a href="#l2116">2116</a><td> *     {@code {x:number, y:number}} object.<tr><td><a id="l2117"></a><a href="#l2117">2117</a><td> */<tr><td><a id="l2118"></a><a href="#l2118">2118</a><td>webdriver.WebElement.prototype.getLocation = function() {<tr><td><a id="l2119"></a><a href="#l2119">2119</a><td>  return this.schedule_(<tr><td><a id="l2120"></a><a href="#l2120">2120</a><td>      new webdriver.Command(webdriver.CommandName.GET_ELEMENT_LOCATION),<tr><td><a id="l2121"></a><a href="#l2121">2121</a><td>      &#39;WebElement.getLocation()&#39;);<tr><td><a id="l2122"></a><a href="#l2122">2122</a><td>};<tr><td><a id="l2123"></a><a href="#l2123">2123</a><td><tr><td><a id="l2124"></a><a href="#l2124">2124</a><td><tr><td><a id="l2125"></a><a href="#l2125">2125</a><td>/**<tr><td><a id="l2126"></a><a href="#l2126">2126</a><td> * Schedules a command to query whether the DOM element represented by this<tr><td><a id="l2127"></a><a href="#l2127">2127</a><td> * instance is enabled, as dicted by the {@code disabled} attribute.<tr><td><a id="l2128"></a><a href="#l2128">2128</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will be<tr><td><a id="l2129"></a><a href="#l2129">2129</a><td> *     resolved with whether this element is currently enabled.<tr><td><a id="l2130"></a><a href="#l2130">2130</a><td> */<tr><td><a id="l2131"></a><a href="#l2131">2131</a><td>webdriver.WebElement.prototype.isEnabled = function() {<tr><td><a id="l2132"></a><a href="#l2132">2132</a><td>  return this.schedule_(<tr><td><a id="l2133"></a><a href="#l2133">2133</a><td>      new webdriver.Command(webdriver.CommandName.IS_ELEMENT_ENABLED),<tr><td><a id="l2134"></a><a href="#l2134">2134</a><td>      &#39;WebElement.isEnabled()&#39;);<tr><td><a id="l2135"></a><a href="#l2135">2135</a><td>};<tr><td><a id="l2136"></a><a href="#l2136">2136</a><td><tr><td><a id="l2137"></a><a href="#l2137">2137</a><td><tr><td><a id="l2138"></a><a href="#l2138">2138</a><td>/**<tr><td><a id="l2139"></a><a href="#l2139">2139</a><td> * Schedules a command to query whether this element is selected.<tr><td><a id="l2140"></a><a href="#l2140">2140</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will be<tr><td><a id="l2141"></a><a href="#l2141">2141</a><td> *     resolved with whether this element is currently selected.<tr><td><a id="l2142"></a><a href="#l2142">2142</a><td> */<tr><td><a id="l2143"></a><a href="#l2143">2143</a><td>webdriver.WebElement.prototype.isSelected = function() {<tr><td><a id="l2144"></a><a href="#l2144">2144</a><td>  return this.schedule_(<tr><td><a id="l2145"></a><a href="#l2145">2145</a><td>      new webdriver.Command(webdriver.CommandName.IS_ELEMENT_SELECTED),<tr><td><a id="l2146"></a><a href="#l2146">2146</a><td>      &#39;WebElement.isSelected()&#39;);<tr><td><a id="l2147"></a><a href="#l2147">2147</a><td>};<tr><td><a id="l2148"></a><a href="#l2148">2148</a><td><tr><td><a id="l2149"></a><a href="#l2149">2149</a><td><tr><td><a id="l2150"></a><a href="#l2150">2150</a><td>/**<tr><td><a id="l2151"></a><a href="#l2151">2151</a><td> * Schedules a command to submit the form containing this element (or this<tr><td><a id="l2152"></a><a href="#l2152">2152</a><td> * element if it is a FORM element). This command is a no-op if the element is<tr><td><a id="l2153"></a><a href="#l2153">2153</a><td> * not contained in a form.<tr><td><a id="l2154"></a><a href="#l2154">2154</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l2155"></a><a href="#l2155">2155</a><td> *     when the form has been submitted.<tr><td><a id="l2156"></a><a href="#l2156">2156</a><td> */<tr><td><a id="l2157"></a><a href="#l2157">2157</a><td>webdriver.WebElement.prototype.submit = function() {<tr><td><a id="l2158"></a><a href="#l2158">2158</a><td>  return this.schedule_(<tr><td><a id="l2159"></a><a href="#l2159">2159</a><td>      new webdriver.Command(webdriver.CommandName.SUBMIT_ELEMENT),<tr><td><a id="l2160"></a><a href="#l2160">2160</a><td>      &#39;WebElement.submit()&#39;);<tr><td><a id="l2161"></a><a href="#l2161">2161</a><td>};<tr><td><a id="l2162"></a><a href="#l2162">2162</a><td><tr><td><a id="l2163"></a><a href="#l2163">2163</a><td><tr><td><a id="l2164"></a><a href="#l2164">2164</a><td>/**<tr><td><a id="l2165"></a><a href="#l2165">2165</a><td> * Schedules a command to clear the {@code value} of this element. This command<tr><td><a id="l2166"></a><a href="#l2166">2166</a><td> * has no effect if the underlying DOM element is neither a text INPUT element<tr><td><a id="l2167"></a><a href="#l2167">2167</a><td> * nor a TEXTAREA element.<tr><td><a id="l2168"></a><a href="#l2168">2168</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l2169"></a><a href="#l2169">2169</a><td> *     when the element has been cleared.<tr><td><a id="l2170"></a><a href="#l2170">2170</a><td> */<tr><td><a id="l2171"></a><a href="#l2171">2171</a><td>webdriver.WebElement.prototype.clear = function() {<tr><td><a id="l2172"></a><a href="#l2172">2172</a><td>  return this.schedule_(<tr><td><a id="l2173"></a><a href="#l2173">2173</a><td>      new webdriver.Command(webdriver.CommandName.CLEAR_ELEMENT),<tr><td><a id="l2174"></a><a href="#l2174">2174</a><td>      &#39;WebElement.clear()&#39;);<tr><td><a id="l2175"></a><a href="#l2175">2175</a><td>};<tr><td><a id="l2176"></a><a href="#l2176">2176</a><td><tr><td><a id="l2177"></a><a href="#l2177">2177</a><td><tr><td><a id="l2178"></a><a href="#l2178">2178</a><td>/**<tr><td><a id="l2179"></a><a href="#l2179">2179</a><td> * Schedules a command to test whether this element is currently displayed.<tr><td><a id="l2180"></a><a href="#l2180">2180</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will be<tr><td><a id="l2181"></a><a href="#l2181">2181</a><td> *     resolved with whether this element is currently visible on the page.<tr><td><a id="l2182"></a><a href="#l2182">2182</a><td> */<tr><td><a id="l2183"></a><a href="#l2183">2183</a><td>webdriver.WebElement.prototype.isDisplayed = function() {<tr><td><a id="l2184"></a><a href="#l2184">2184</a><td>  return this.schedule_(<tr><td><a id="l2185"></a><a href="#l2185">2185</a><td>      new webdriver.Command(webdriver.CommandName.IS_ELEMENT_DISPLAYED),<tr><td><a id="l2186"></a><a href="#l2186">2186</a><td>      &#39;WebElement.isDisplayed()&#39;);<tr><td><a id="l2187"></a><a href="#l2187">2187</a><td>};<tr><td><a id="l2188"></a><a href="#l2188">2188</a><td><tr><td><a id="l2189"></a><a href="#l2189">2189</a><td><tr><td><a id="l2190"></a><a href="#l2190">2190</a><td>/**<tr><td><a id="l2191"></a><a href="#l2191">2191</a><td> * Schedules a command to retrieve the outer HTML of this element.<tr><td><a id="l2192"></a><a href="#l2192">2192</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l2193"></a><a href="#l2193">2193</a><td> *     resolved with the element&#39;s outer HTML.<tr><td><a id="l2194"></a><a href="#l2194">2194</a><td> */<tr><td><a id="l2195"></a><a href="#l2195">2195</a><td>webdriver.WebElement.prototype.getOuterHtml = function() {<tr><td><a id="l2196"></a><a href="#l2196">2196</a><td>  return this.driver_.executeScript(function() {<tr><td><a id="l2197"></a><a href="#l2197">2197</a><td>    var element = arguments[0];<tr><td><a id="l2198"></a><a href="#l2198">2198</a><td>    if (&#39;outerHTML&#39; in element) {<tr><td><a id="l2199"></a><a href="#l2199">2199</a><td>      return element.outerHTML;<tr><td><a id="l2200"></a><a href="#l2200">2200</a><td>    } else {<tr><td><a id="l2201"></a><a href="#l2201">2201</a><td>      var div = element.ownerDocument.createElement(&#39;div&#39;);<tr><td><a id="l2202"></a><a href="#l2202">2202</a><td>      div.appendChild(element.cloneNode(true));<tr><td><a id="l2203"></a><a href="#l2203">2203</a><td>      return div.innerHTML;<tr><td><a id="l2204"></a><a href="#l2204">2204</a><td>    }<tr><td><a id="l2205"></a><a href="#l2205">2205</a><td>  }, this);<tr><td><a id="l2206"></a><a href="#l2206">2206</a><td>};<tr><td><a id="l2207"></a><a href="#l2207">2207</a><td><tr><td><a id="l2208"></a><a href="#l2208">2208</a><td><tr><td><a id="l2209"></a><a href="#l2209">2209</a><td>/**<tr><td><a id="l2210"></a><a href="#l2210">2210</a><td> * Schedules a command to retrieve the inner HTML of this element.<tr><td><a id="l2211"></a><a href="#l2211">2211</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l2212"></a><a href="#l2212">2212</a><td> *     resolved with the element&#39;s inner HTML.<tr><td><a id="l2213"></a><a href="#l2213">2213</a><td> */<tr><td><a id="l2214"></a><a href="#l2214">2214</a><td>webdriver.WebElement.prototype.getInnerHtml = function() {<tr><td><a id="l2215"></a><a href="#l2215">2215</a><td>  return this.driver_.executeScript(&#39;return arguments[0].innerHTML&#39;, this);<tr><td><a id="l2216"></a><a href="#l2216">2216</a><td>};<tr><td><a id="l2217"></a><a href="#l2217">2217</a><td><tr><td><a id="l2218"></a><a href="#l2218">2218</a><td><tr><td><a id="l2219"></a><a href="#l2219">2219</a><td><tr><td><a id="l2220"></a><a href="#l2220">2220</a><td>/**<tr><td><a id="l2221"></a><a href="#l2221">2221</a><td> * WebElementPromise is a promise that will be fulfilled with a WebElement.<tr><td><a id="l2222"></a><a href="#l2222">2222</a><td> * This serves as a forward proxy on WebElement, allowing calls to be<tr><td><a id="l2223"></a><a href="#l2223">2223</a><td> * scheduled without directly on this instance before the underlying<tr><td><a id="l2224"></a><a href="#l2224">2224</a><td> * WebElement has been fulfilled. In other words, the following two statements<tr><td><a id="l2225"></a><a href="#l2225">2225</a><td> * are equivalent:<tr><td><a id="l2226"></a><a href="#l2226">2226</a><td> *<tr><td><a id="l2227"></a><a href="#l2227">2227</a><td> *     driver.findElement({id: &#39;my-button&#39;}).click();<tr><td><a id="l2228"></a><a href="#l2228">2228</a><td> *     driver.findElement({id: &#39;my-button&#39;}).then(function(el) {<tr><td><a id="l2229"></a><a href="#l2229">2229</a><td> *       return el.click();<tr><td><a id="l2230"></a><a href="#l2230">2230</a><td> *     });<tr><td><a id="l2231"></a><a href="#l2231">2231</a><td> *<tr><td><a id="l2232"></a><a href="#l2232">2232</a><td> * @param {!webdriver.WebDriver} driver The parent WebDriver instance for this<tr><td><a id="l2233"></a><a href="#l2233">2233</a><td> *     element.<tr><td><a id="l2234"></a><a href="#l2234">2234</a><td> * @param {!webdriver.promise.Promise.&lt;!webdriver.WebElement&gt;} el A promise<tr><td><a id="l2235"></a><a href="#l2235">2235</a><td> *     that will resolve to the promised element.<tr><td><a id="l2236"></a><a href="#l2236">2236</a><td> * @constructor<tr><td><a id="l2237"></a><a href="#l2237">2237</a><td> * @extends {webdriver.WebElement}<tr><td><a id="l2238"></a><a href="#l2238">2238</a><td> * @implements {webdriver.promise.Thenable.&lt;!webdriver.WebElement&gt;}<tr><td><a id="l2239"></a><a href="#l2239">2239</a><td> * @final<tr><td><a id="l2240"></a><a href="#l2240">2240</a><td> */<tr><td><a id="l2241"></a><a href="#l2241">2241</a><td>webdriver.WebElementPromise = function(driver, el) {<tr><td><a id="l2242"></a><a href="#l2242">2242</a><td>  webdriver.WebElement.call(this, driver, {&#39;ELEMENT&#39;: &#39;unused&#39;});<tr><td><a id="l2243"></a><a href="#l2243">2243</a><td><tr><td><a id="l2244"></a><a href="#l2244">2244</a><td>  /** @override */<tr><td><a id="l2245"></a><a href="#l2245">2245</a><td>  this.cancel = goog.bind(el.cancel, el);<tr><td><a id="l2246"></a><a href="#l2246">2246</a><td><tr><td><a id="l2247"></a><a href="#l2247">2247</a><td>  /** @override */<tr><td><a id="l2248"></a><a href="#l2248">2248</a><td>  this.isPending = goog.bind(el.isPending, el);<tr><td><a id="l2249"></a><a href="#l2249">2249</a><td><tr><td><a id="l2250"></a><a href="#l2250">2250</a><td>  /** @override */<tr><td><a id="l2251"></a><a href="#l2251">2251</a><td>  this.then = goog.bind(el.then, el);<tr><td><a id="l2252"></a><a href="#l2252">2252</a><td><tr><td><a id="l2253"></a><a href="#l2253">2253</a><td>  /** @override */<tr><td><a id="l2254"></a><a href="#l2254">2254</a><td>  this.thenCatch = goog.bind(el.thenCatch, el);<tr><td><a id="l2255"></a><a href="#l2255">2255</a><td><tr><td><a id="l2256"></a><a href="#l2256">2256</a><td>  /** @override */<tr><td><a id="l2257"></a><a href="#l2257">2257</a><td>  this.thenFinally = goog.bind(el.thenFinally, el);<tr><td><a id="l2258"></a><a href="#l2258">2258</a><td><tr><td><a id="l2259"></a><a href="#l2259">2259</a><td>  /**<tr><td><a id="l2260"></a><a href="#l2260">2260</a><td>   * Defers returning the element ID until the wrapped WebElement has been<tr><td><a id="l2261"></a><a href="#l2261">2261</a><td>   * resolved.<tr><td><a id="l2262"></a><a href="#l2262">2262</a><td>   * @override<tr><td><a id="l2263"></a><a href="#l2263">2263</a><td>   */<tr><td><a id="l2264"></a><a href="#l2264">2264</a><td>  this.getId = function() {<tr><td><a id="l2265"></a><a href="#l2265">2265</a><td>    return el.then(function(el) {<tr><td><a id="l2266"></a><a href="#l2266">2266</a><td>      return el.getId();<tr><td><a id="l2267"></a><a href="#l2267">2267</a><td>    });<tr><td><a id="l2268"></a><a href="#l2268">2268</a><td>  };<tr><td><a id="l2269"></a><a href="#l2269">2269</a><td>};<tr><td><a id="l2270"></a><a href="#l2270">2270</a><td>goog.inherits(webdriver.WebElementPromise, webdriver.WebElement);<tr><td><a id="l2271"></a><a href="#l2271">2271</a><td><tr><td><a id="l2272"></a><a href="#l2272">2272</a><td><tr><td><a id="l2273"></a><a href="#l2273">2273</a><td>/**<tr><td><a id="l2274"></a><a href="#l2274">2274</a><td> * Represents a modal dialog such as {@code alert}, {@code confirm}, or<tr><td><a id="l2275"></a><a href="#l2275">2275</a><td> * {@code prompt}. Provides functions to retrieve the message displayed with<tr><td><a id="l2276"></a><a href="#l2276">2276</a><td> * the alert, accept or dismiss the alert, and set the response text (in the<tr><td><a id="l2277"></a><a href="#l2277">2277</a><td> * case of {@code prompt}).<tr><td><a id="l2278"></a><a href="#l2278">2278</a><td> * @param {!webdriver.WebDriver} driver The driver controlling the browser this<tr><td><a id="l2279"></a><a href="#l2279">2279</a><td> *     alert is attached to.<tr><td><a id="l2280"></a><a href="#l2280">2280</a><td> * @param {string} text The message text displayed with this alert.<tr><td><a id="l2281"></a><a href="#l2281">2281</a><td> * @constructor<tr><td><a id="l2282"></a><a href="#l2282">2282</a><td> */<tr><td><a id="l2283"></a><a href="#l2283">2283</a><td>webdriver.Alert = function(driver, text) {<tr><td><a id="l2284"></a><a href="#l2284">2284</a><td>  /** @private {!webdriver.WebDriver} */<tr><td><a id="l2285"></a><a href="#l2285">2285</a><td>  this.driver_ = driver;<tr><td><a id="l2286"></a><a href="#l2286">2286</a><td><tr><td><a id="l2287"></a><a href="#l2287">2287</a><td>  /** @private {!webdriver.promise.Promise.&lt;string&gt;} */<tr><td><a id="l2288"></a><a href="#l2288">2288</a><td>  this.text_ = webdriver.promise.when(text);<tr><td><a id="l2289"></a><a href="#l2289">2289</a><td>};<tr><td><a id="l2290"></a><a href="#l2290">2290</a><td><tr><td><a id="l2291"></a><a href="#l2291">2291</a><td><tr><td><a id="l2292"></a><a href="#l2292">2292</a><td>/**<tr><td><a id="l2293"></a><a href="#l2293">2293</a><td> * Retrieves the message text displayed with this alert. For instance, if the<tr><td><a id="l2294"></a><a href="#l2294">2294</a><td> * alert were opened with alert(&quot;hello&quot;), then this would return &quot;hello&quot;.<tr><td><a id="l2295"></a><a href="#l2295">2295</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will be<tr><td><a id="l2296"></a><a href="#l2296">2296</a><td> *     resolved to the text displayed with this alert.<tr><td><a id="l2297"></a><a href="#l2297">2297</a><td> */<tr><td><a id="l2298"></a><a href="#l2298">2298</a><td>webdriver.Alert.prototype.getText = function() {<tr><td><a id="l2299"></a><a href="#l2299">2299</a><td>  return this.text_;<tr><td><a id="l2300"></a><a href="#l2300">2300</a><td>};<tr><td><a id="l2301"></a><a href="#l2301">2301</a><td><tr><td><a id="l2302"></a><a href="#l2302">2302</a><td><tr><td><a id="l2303"></a><a href="#l2303">2303</a><td>/**<tr><td><a id="l2304"></a><a href="#l2304">2304</a><td> * Accepts this alert.<tr><td><a id="l2305"></a><a href="#l2305">2305</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l2306"></a><a href="#l2306">2306</a><td> *     when this command has completed.<tr><td><a id="l2307"></a><a href="#l2307">2307</a><td> */<tr><td><a id="l2308"></a><a href="#l2308">2308</a><td>webdriver.Alert.prototype.accept = function() {<tr><td><a id="l2309"></a><a href="#l2309">2309</a><td>  return this.driver_.schedule(<tr><td><a id="l2310"></a><a href="#l2310">2310</a><td>      new webdriver.Command(webdriver.CommandName.ACCEPT_ALERT),<tr><td><a id="l2311"></a><a href="#l2311">2311</a><td>      &#39;WebDriver.switchTo().alert().accept()&#39;);<tr><td><a id="l2312"></a><a href="#l2312">2312</a><td>};<tr><td><a id="l2313"></a><a href="#l2313">2313</a><td><tr><td><a id="l2314"></a><a href="#l2314">2314</a><td><tr><td><a id="l2315"></a><a href="#l2315">2315</a><td>/**<tr><td><a id="l2316"></a><a href="#l2316">2316</a><td> * Dismisses this alert.<tr><td><a id="l2317"></a><a href="#l2317">2317</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l2318"></a><a href="#l2318">2318</a><td> *     when this command has completed.<tr><td><a id="l2319"></a><a href="#l2319">2319</a><td> */<tr><td><a id="l2320"></a><a href="#l2320">2320</a><td>webdriver.Alert.prototype.dismiss = function() {<tr><td><a id="l2321"></a><a href="#l2321">2321</a><td>  return this.driver_.schedule(<tr><td><a id="l2322"></a><a href="#l2322">2322</a><td>      new webdriver.Command(webdriver.CommandName.DISMISS_ALERT),<tr><td><a id="l2323"></a><a href="#l2323">2323</a><td>      &#39;WebDriver.switchTo().alert().dismiss()&#39;);<tr><td><a id="l2324"></a><a href="#l2324">2324</a><td>};<tr><td><a id="l2325"></a><a href="#l2325">2325</a><td><tr><td><a id="l2326"></a><a href="#l2326">2326</a><td><tr><td><a id="l2327"></a><a href="#l2327">2327</a><td>/**<tr><td><a id="l2328"></a><a href="#l2328">2328</a><td> * Sets the response text on this alert. This command will return an error if<tr><td><a id="l2329"></a><a href="#l2329">2329</a><td> * the underlying alert does not support response text (e.g. window.alert and<tr><td><a id="l2330"></a><a href="#l2330">2330</a><td> * window.confirm).<tr><td><a id="l2331"></a><a href="#l2331">2331</a><td> * @param {string} text The text to set.<tr><td><a id="l2332"></a><a href="#l2332">2332</a><td> * @return {!webdriver.promise.Promise.&lt;void&gt;} A promise that will be resolved<tr><td><a id="l2333"></a><a href="#l2333">2333</a><td> *     when this command has completed.<tr><td><a id="l2334"></a><a href="#l2334">2334</a><td> */<tr><td><a id="l2335"></a><a href="#l2335">2335</a><td>webdriver.Alert.prototype.sendKeys = function(text) {<tr><td><a id="l2336"></a><a href="#l2336">2336</a><td>  return this.driver_.schedule(<tr><td><a id="l2337"></a><a href="#l2337">2337</a><td>      new webdriver.Command(webdriver.CommandName.SET_ALERT_TEXT).<tr><td><a id="l2338"></a><a href="#l2338">2338</a><td>          setParameter(&#39;text&#39;, text),<tr><td><a id="l2339"></a><a href="#l2339">2339</a><td>      &#39;WebDriver.switchTo().alert().sendKeys(&#39; + text + &#39;)&#39;);<tr><td><a id="l2340"></a><a href="#l2340">2340</a><td>};<tr><td><a id="l2341"></a><a href="#l2341">2341</a><td><tr><td><a id="l2342"></a><a href="#l2342">2342</a><td><tr><td><a id="l2343"></a><a href="#l2343">2343</a><td><tr><td><a id="l2344"></a><a href="#l2344">2344</a><td>/**<tr><td><a id="l2345"></a><a href="#l2345">2345</a><td> * AlertPromise is a promise that will be fulfilled with an Alert. This promise<tr><td><a id="l2346"></a><a href="#l2346">2346</a><td> * serves as a forward proxy on an Alert, allowing calls to be scheduled<tr><td><a id="l2347"></a><a href="#l2347">2347</a><td> * directly on this instance before the underlying Alert has been fulfilled. In<tr><td><a id="l2348"></a><a href="#l2348">2348</a><td> * other words, the following two statements are equivalent:<tr><td><a id="l2349"></a><a href="#l2349">2349</a><td> *<tr><td><a id="l2350"></a><a href="#l2350">2350</a><td> *     driver.switchTo().alert().dismiss();<tr><td><a id="l2351"></a><a href="#l2351">2351</a><td> *     driver.switchTo().alert().then(function(alert) {<tr><td><a id="l2352"></a><a href="#l2352">2352</a><td> *       return alert.dismiss();<tr><td><a id="l2353"></a><a href="#l2353">2353</a><td> *     });<tr><td><a id="l2354"></a><a href="#l2354">2354</a><td> *<tr><td><a id="l2355"></a><a href="#l2355">2355</a><td> * @param {!webdriver.WebDriver} driver The driver controlling the browser this<tr><td><a id="l2356"></a><a href="#l2356">2356</a><td> *     alert is attached to.<tr><td><a id="l2357"></a><a href="#l2357">2357</a><td> * @param {!webdriver.promise.Thenable.&lt;!webdriver.Alert&gt;} alert A thenable<tr><td><a id="l2358"></a><a href="#l2358">2358</a><td> *     that will be fulfilled with the promised alert.<tr><td><a id="l2359"></a><a href="#l2359">2359</a><td> * @constructor<tr><td><a id="l2360"></a><a href="#l2360">2360</a><td> * @extends {webdriver.Alert}<tr><td><a id="l2361"></a><a href="#l2361">2361</a><td> * @implements {webdriver.promise.Thenable.&lt;!webdriver.Alert&gt;}<tr><td><a id="l2362"></a><a href="#l2362">2362</a><td> * @final<tr><td><a id="l2363"></a><a href="#l2363">2363</a><td> */<tr><td><a id="l2364"></a><a href="#l2364">2364</a><td>webdriver.AlertPromise = function(driver, alert) {<tr><td><a id="l2365"></a><a href="#l2365">2365</a><td>  webdriver.Alert.call(this, driver, &#39;unused&#39;);<tr><td><a id="l2366"></a><a href="#l2366">2366</a><td><tr><td><a id="l2367"></a><a href="#l2367">2367</a><td>  /** @override */<tr><td><a id="l2368"></a><a href="#l2368">2368</a><td>  this.cancel = goog.bind(alert.cancel, alert);<tr><td><a id="l2369"></a><a href="#l2369">2369</a><td><tr><td><a id="l2370"></a><a href="#l2370">2370</a><td>  /** @override */<tr><td><a id="l2371"></a><a href="#l2371">2371</a><td>  this.isPending = goog.bind(alert.isPending, alert);<tr><td><a id="l2372"></a><a href="#l2372">2372</a><td><tr><td><a id="l2373"></a><a href="#l2373">2373</a><td>  /** @override */<tr><td><a id="l2374"></a><a href="#l2374">2374</a><td>  this.then = goog.bind(alert.then, alert);<tr><td><a id="l2375"></a><a href="#l2375">2375</a><td><tr><td><a id="l2376"></a><a href="#l2376">2376</a><td>  /** @override */<tr><td><a id="l2377"></a><a href="#l2377">2377</a><td>  this.thenCatch = goog.bind(alert.thenCatch, alert);<tr><td><a id="l2378"></a><a href="#l2378">2378</a><td><tr><td><a id="l2379"></a><a href="#l2379">2379</a><td>  /** @override */<tr><td><a id="l2380"></a><a href="#l2380">2380</a><td>  this.thenFinally = goog.bind(alert.thenFinally, alert);<tr><td><a id="l2381"></a><a href="#l2381">2381</a><td><tr><td><a id="l2382"></a><a href="#l2382">2382</a><td>  /**<tr><td><a id="l2383"></a><a href="#l2383">2383</a><td>   * Defer returning text until the promised alert has been resolved.<tr><td><a id="l2384"></a><a href="#l2384">2384</a><td>   * @override<tr><td><a id="l2385"></a><a href="#l2385">2385</a><td>   */<tr><td><a id="l2386"></a><a href="#l2386">2386</a><td>  this.getText = function() {<tr><td><a id="l2387"></a><a href="#l2387">2387</a><td>    return alert.then(function(alert) {<tr><td><a id="l2388"></a><a href="#l2388">2388</a><td>      return alert.getText();<tr><td><a id="l2389"></a><a href="#l2389">2389</a><td>    });<tr><td><a id="l2390"></a><a href="#l2390">2390</a><td>  };<tr><td><a id="l2391"></a><a href="#l2391">2391</a><td><tr><td><a id="l2392"></a><a href="#l2392">2392</a><td>  /**<tr><td><a id="l2393"></a><a href="#l2393">2393</a><td>   * Defers action until the alert has been located.<tr><td><a id="l2394"></a><a href="#l2394">2394</a><td>   * @override<tr><td><a id="l2395"></a><a href="#l2395">2395</a><td>   */<tr><td><a id="l2396"></a><a href="#l2396">2396</a><td>  this.accept = function() {<tr><td><a id="l2397"></a><a href="#l2397">2397</a><td>    return alert.then(function(alert) {<tr><td><a id="l2398"></a><a href="#l2398">2398</a><td>      return alert.accept();<tr><td><a id="l2399"></a><a href="#l2399">2399</a><td>    });<tr><td><a id="l2400"></a><a href="#l2400">2400</a><td>  };<tr><td><a id="l2401"></a><a href="#l2401">2401</a><td><tr><td><a id="l2402"></a><a href="#l2402">2402</a><td>  /**<tr><td><a id="l2403"></a><a href="#l2403">2403</a><td>   * Defers action until the alert has been located.<tr><td><a id="l2404"></a><a href="#l2404">2404</a><td>   * @override<tr><td><a id="l2405"></a><a href="#l2405">2405</a><td>   */<tr><td><a id="l2406"></a><a href="#l2406">2406</a><td>  this.dismiss = function() {<tr><td><a id="l2407"></a><a href="#l2407">2407</a><td>    return alert.then(function(alert) {<tr><td><a id="l2408"></a><a href="#l2408">2408</a><td>      return alert.dismiss();<tr><td><a id="l2409"></a><a href="#l2409">2409</a><td>    });<tr><td><a id="l2410"></a><a href="#l2410">2410</a><td>  };<tr><td><a id="l2411"></a><a href="#l2411">2411</a><td><tr><td><a id="l2412"></a><a href="#l2412">2412</a><td>  /**<tr><td><a id="l2413"></a><a href="#l2413">2413</a><td>   * Defers action until the alert has been located.<tr><td><a id="l2414"></a><a href="#l2414">2414</a><td>   * @override<tr><td><a id="l2415"></a><a href="#l2415">2415</a><td>   */<tr><td><a id="l2416"></a><a href="#l2416">2416</a><td>  this.sendKeys = function(text) {<tr><td><a id="l2417"></a><a href="#l2417">2417</a><td>    return alert.then(function(alert) {<tr><td><a id="l2418"></a><a href="#l2418">2418</a><td>      return alert.sendKeys(text);<tr><td><a id="l2419"></a><a href="#l2419">2419</a><td>    });<tr><td><a id="l2420"></a><a href="#l2420">2420</a><td>  };<tr><td><a id="l2421"></a><a href="#l2421">2421</a><td>};<tr><td><a id="l2422"></a><a href="#l2422">2422</a><td>goog.inherits(webdriver.AlertPromise, webdriver.Alert);<tr><td><a id="l2423"></a><a href="#l2423">2423</a><td><tr><td><a id="l2424"></a><a href="#l2424">2424</a><td><tr><td><a id="l2425"></a><a href="#l2425">2425</a><td><tr><td><a id="l2426"></a><a href="#l2426">2426</a><td>/**<tr><td><a id="l2427"></a><a href="#l2427">2427</a><td> * An error returned to indicate that there is an unhandled modal dialog on the<tr><td><a id="l2428"></a><a href="#l2428">2428</a><td> * current page.<tr><td><a id="l2429"></a><a href="#l2429">2429</a><td> * @param {string} message The error message.<tr><td><a id="l2430"></a><a href="#l2430">2430</a><td> * @param {string} text The text displayed with the unhandled alert.<tr><td><a id="l2431"></a><a href="#l2431">2431</a><td> * @param {!webdriver.Alert} alert The alert handle.<tr><td><a id="l2432"></a><a href="#l2432">2432</a><td> * @constructor<tr><td><a id="l2433"></a><a href="#l2433">2433</a><td> * @extends {bot.Error}<tr><td><a id="l2434"></a><a href="#l2434">2434</a><td> */<tr><td><a id="l2435"></a><a href="#l2435">2435</a><td>webdriver.UnhandledAlertError = function(message, text, alert) {<tr><td><a id="l2436"></a><a href="#l2436">2436</a><td>  webdriver.UnhandledAlertError.base(<tr><td><a id="l2437"></a><a href="#l2437">2437</a><td>      this, &#39;constructor&#39;, bot.ErrorCode.UNEXPECTED_ALERT_OPEN, message);<tr><td><a id="l2438"></a><a href="#l2438">2438</a><td><tr><td><a id="l2439"></a><a href="#l2439">2439</a><td>  /** @private {string} */<tr><td><a id="l2440"></a><a href="#l2440">2440</a><td>  this.text_ = text;<tr><td><a id="l2441"></a><a href="#l2441">2441</a><td><tr><td><a id="l2442"></a><a href="#l2442">2442</a><td>  /** @private {!webdriver.Alert} */<tr><td><a id="l2443"></a><a href="#l2443">2443</a><td>  this.alert_ = alert;<tr><td><a id="l2444"></a><a href="#l2444">2444</a><td>};<tr><td><a id="l2445"></a><a href="#l2445">2445</a><td>goog.inherits(webdriver.UnhandledAlertError, bot.Error);<tr><td><a id="l2446"></a><a href="#l2446">2446</a><td><tr><td><a id="l2447"></a><a href="#l2447">2447</a><td><tr><td><a id="l2448"></a><a href="#l2448">2448</a><td>/**<tr><td><a id="l2449"></a><a href="#l2449">2449</a><td> * @return {string} The text displayed with the unhandled alert.<tr><td><a id="l2450"></a><a href="#l2450">2450</a><td> */<tr><td><a id="l2451"></a><a href="#l2451">2451</a><td>webdriver.UnhandledAlertError.prototype.getAlertText = function() {<tr><td><a id="l2452"></a><a href="#l2452">2452</a><td>  return this.text_;<tr><td><a id="l2453"></a><a href="#l2453">2453</a><td>};<tr><td><a id="l2454"></a><a href="#l2454">2454</a><td><tr><td><a id="l2455"></a><a href="#l2455">2455</a><td><tr><td><a id="l2456"></a><a href="#l2456">2456</a><td><tr><td><a id="l2457"></a><a href="#l2457">2457</a><td>/**<tr><td><a id="l2458"></a><a href="#l2458">2458</a><td> * Used with {@link webdriver.WebElement#sendKeys WebElement#sendKeys} on file<tr><td><a id="l2459"></a><a href="#l2459">2459</a><td> * input elements ({@code &lt;input type=&quot;file&quot;&gt;}) to detect when the entered key<tr><td><a id="l2460"></a><a href="#l2460">2460</a><td> * sequence defines the path to a file.<tr><td><a id="l2461"></a><a href="#l2461">2461</a><td> *<tr><td><a id="l2462"></a><a href="#l2462">2462</a><td> * By default, {@linkplain webdriver.WebElement WebElement&#39;s} will enter all<tr><td><a id="l2463"></a><a href="#l2463">2463</a><td> * key sequences exactly as entered. You may set a<tr><td><a id="l2464"></a><a href="#l2464">2464</a><td> * {@linkplain webdriver.WebDriver#setFileDetector file detector} on the parent<tr><td><a id="l2465"></a><a href="#l2465">2465</a><td> * WebDriver instance to define custom behavior for handling file elements. Of<tr><td><a id="l2466"></a><a href="#l2466">2466</a><td> * particular note is the {@link selenium-webdriver/remote.FileDetector}, which<tr><td><a id="l2467"></a><a href="#l2467">2467</a><td> * should be used when running against a remote<tr><td><a id="l2468"></a><a href="#l2468">2468</a><td> * [Selenium Server](http://docs.seleniumhq.org/download/).<tr><td><a id="l2469"></a><a href="#l2469">2469</a><td> */<tr><td><a id="l2470"></a><a href="#l2470">2470</a><td>webdriver.FileDetector = goog.defineClass(null, {<tr><td><a id="l2471"></a><a href="#l2471">2471</a><td>  /** @constructor */<tr><td><a id="l2472"></a><a href="#l2472">2472</a><td>  constructor: function() {},<tr><td><a id="l2473"></a><a href="#l2473">2473</a><td><tr><td><a id="l2474"></a><a href="#l2474">2474</a><td>  /**<tr><td><a id="l2475"></a><a href="#l2475">2475</a><td>   * Handles the file specified by the given path, preparing it for use with<tr><td><a id="l2476"></a><a href="#l2476">2476</a><td>   * the current browser. If the path does not refer to a valid file, it will<tr><td><a id="l2477"></a><a href="#l2477">2477</a><td>   * be returned unchanged, otherwisee a path suitable for use with the current<tr><td><a id="l2478"></a><a href="#l2478">2478</a><td>   * browser will be returned.<tr><td><a id="l2479"></a><a href="#l2479">2479</a><td>   *<tr><td><a id="l2480"></a><a href="#l2480">2480</a><td>   * This default implementation is a no-op. Subtypes may override this<tr><td><a id="l2481"></a><a href="#l2481">2481</a><td>   * function for custom tailored file handling.<tr><td><a id="l2482"></a><a href="#l2482">2482</a><td>   *<tr><td><a id="l2483"></a><a href="#l2483">2483</a><td>   * @param {!webdriver.WebDriver} driver The driver for the current browser.<tr><td><a id="l2484"></a><a href="#l2484">2484</a><td>   * @param {string} path The path to process.<tr><td><a id="l2485"></a><a href="#l2485">2485</a><td>   * @return {!webdriver.promise.Promise&lt;string&gt;} A promise for the processed<tr><td><a id="l2486"></a><a href="#l2486">2486</a><td>   *     file path.<tr><td><a id="l2487"></a><a href="#l2487">2487</a><td>   * @package<tr><td><a id="l2488"></a><a href="#l2488">2488</a><td>   */<tr><td><a id="l2489"></a><a href="#l2489">2489</a><td>  handleFile: function(driver, path) {<tr><td><a id="l2490"></a><a href="#l2490">2490</a><td>    return webdriver.promise.fulfilled(path);<tr><td><a id="l2491"></a><a href="#l2491">2491</a><td>  }<tr><td><a id="l2492"></a><a href="#l2492">2492</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>
\ No newline at end of file
diff --git a/docs/source/net/index.js.src.html b/docs/source/net/index.js.src.html
index dbcd644..0cacfaa 100644
--- a/docs/source/net/index.js.src.html
+++ b/docs/source/net/index.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>index.js</title><link href="../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>net/index.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>&#39;use strict&#39;;<tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td>var os = require(&#39;os&#39;);<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>function getLoInterface() {<tr><td><a name="l22" href="#l22">22</a><td>  var name;<tr><td><a name="l23" href="#l23">23</a><td>  if (process.platform === &#39;darwin&#39;) {<tr><td><a name="l24" href="#l24">24</a><td>    name = &#39;lo0&#39;;<tr><td><a name="l25" href="#l25">25</a><td>  } else if (process.platform === &#39;linux&#39;) {<tr><td><a name="l26" href="#l26">26</a><td>    name = &#39;lo&#39;;<tr><td><a name="l27" href="#l27">27</a><td>  }<tr><td><a name="l28" href="#l28">28</a><td>  return name ? os.networkInterfaces()[name] : null;<tr><td><a name="l29" href="#l29">29</a><td>}<tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td>/**<tr><td><a name="l33" href="#l33">33</a><td> * Queries the system network interfaces for an IP address.<tr><td><a name="l34" href="#l34">34</a><td> * @param {boolean} loopback Whether to find a loopback address.<tr><td><a name="l35" href="#l35">35</a><td> * @param {string=} opt_family The IP family (IPv4 or IPv6). Defaults to IPv4.<tr><td><a name="l36" href="#l36">36</a><td> * @return {string} The located IP address or undefined.<tr><td><a name="l37" href="#l37">37</a><td> */<tr><td><a name="l38" href="#l38">38</a><td>function getAddress(loopback, opt_family) {<tr><td><a name="l39" href="#l39">39</a><td>  var family = opt_family || &#39;IPv4&#39;;<tr><td><a name="l40" href="#l40">40</a><td>  var addresses = [];<tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td>  var interfaces;<tr><td><a name="l43" href="#l43">43</a><td>  if (loopback) {<tr><td><a name="l44" href="#l44">44</a><td>    interfaces = [getLoInterface()];<tr><td><a name="l45" href="#l45">45</a><td>  }<tr><td><a name="l46" href="#l46">46</a><td>  interfaces = interfaces || os.networkInterfaces();<tr><td><a name="l47" href="#l47">47</a><td>  for (var key in interfaces) {<tr><td><a name="l48" href="#l48">48</a><td>    interfaces[key].forEach(function(ipAddress) {<tr><td><a name="l49" href="#l49">49</a><td>      if (ipAddress.family === family &amp;&amp;<tr><td><a name="l50" href="#l50">50</a><td>          ipAddress.internal === loopback) {<tr><td><a name="l51" href="#l51">51</a><td>        addresses.push(ipAddress.address);<tr><td><a name="l52" href="#l52">52</a><td>      }<tr><td><a name="l53" href="#l53">53</a><td>    });<tr><td><a name="l54" href="#l54">54</a><td>  }<tr><td><a name="l55" href="#l55">55</a><td>  return addresses[0];<tr><td><a name="l56" href="#l56">56</a><td>}<tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td>// PUBLIC API<tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td>/**<tr><td><a name="l63" href="#l63">63</a><td> * Retrieves the external IP address for this host.<tr><td><a name="l64" href="#l64">64</a><td> * @param {string=} opt_family The IP family to retrieve. Defaults to &quot;IPv4&quot;.<tr><td><a name="l65" href="#l65">65</a><td> * @return {string} The IP address or undefined if not available.<tr><td><a name="l66" href="#l66">66</a><td> */<tr><td><a name="l67" href="#l67">67</a><td>exports.getAddress = function(opt_family) {<tr><td><a name="l68" href="#l68">68</a><td>  return getAddress(false, opt_family);<tr><td><a name="l69" href="#l69">69</a><td>};<tr><td><a name="l70" href="#l70">70</a><td><tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td>/**<tr><td><a name="l73" href="#l73">73</a><td> * Retrieves a loopback address for this machine.<tr><td><a name="l74" href="#l74">74</a><td> * @param {string=} opt_family The IP family to retrieve. Defaults to &quot;IPv4&quot;.<tr><td><a name="l75" href="#l75">75</a><td> * @return {string} The IP address or undefined if not available.<tr><td><a name="l76" href="#l76">76</a><td> */<tr><td><a name="l77" href="#l77">77</a><td>exports.getLoopbackAddress = function(opt_family) {<tr><td><a name="l78" href="#l78">78</a><td>  return getAddress(true, opt_family);<tr><td><a name="l79" href="#l79">79</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../types.js"></script><script src="../../dossier.js"></script>
\ No newline at end of file
+<!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>index.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>net/index.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var os = require(&#39;os&#39;);<tr><td><a id="l21"></a><a href="#l21">21</a><td><tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>function getLoInterface() {<tr><td><a id="l24"></a><a href="#l24">24</a><td>  var name;<tr><td><a id="l25"></a><a href="#l25">25</a><td>  if (process.platform === &#39;darwin&#39;) {<tr><td><a id="l26"></a><a href="#l26">26</a><td>    name = &#39;lo0&#39;;<tr><td><a id="l27"></a><a href="#l27">27</a><td>  } else if (process.platform === &#39;linux&#39;) {<tr><td><a id="l28"></a><a href="#l28">28</a><td>    name = &#39;lo&#39;;<tr><td><a id="l29"></a><a href="#l29">29</a><td>  }<tr><td><a id="l30"></a><a href="#l30">30</a><td>  return name ? os.networkInterfaces()[name] : null;<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><tr><td><a id="l34"></a><a href="#l34">34</a><td>/**<tr><td><a id="l35"></a><a href="#l35">35</a><td> * Queries the system network interfaces for an IP address.<tr><td><a id="l36"></a><a href="#l36">36</a><td> * @param {boolean} loopback Whether to find a loopback address.<tr><td><a id="l37"></a><a href="#l37">37</a><td> * @param {string=} opt_family The IP family (IPv4 or IPv6). Defaults to IPv4.<tr><td><a id="l38"></a><a href="#l38">38</a><td> * @return {string} The located IP address or undefined.<tr><td><a id="l39"></a><a href="#l39">39</a><td> */<tr><td><a id="l40"></a><a href="#l40">40</a><td>function getAddress(loopback, opt_family) {<tr><td><a id="l41"></a><a href="#l41">41</a><td>  var family = opt_family || &#39;IPv4&#39;;<tr><td><a id="l42"></a><a href="#l42">42</a><td>  var addresses = [];<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>  var interfaces;<tr><td><a id="l45"></a><a href="#l45">45</a><td>  if (loopback) {<tr><td><a id="l46"></a><a href="#l46">46</a><td>    var lo = getLoInterface();<tr><td><a id="l47"></a><a href="#l47">47</a><td>    interfaces = lo ? [lo] : null;<tr><td><a id="l48"></a><a href="#l48">48</a><td>  }<tr><td><a id="l49"></a><a href="#l49">49</a><td>  interfaces = interfaces || os.networkInterfaces();<tr><td><a id="l50"></a><a href="#l50">50</a><td>  for (var key in interfaces) {<tr><td><a id="l51"></a><a href="#l51">51</a><td>    interfaces[key].forEach(function(ipAddress) {<tr><td><a id="l52"></a><a href="#l52">52</a><td>      if (ipAddress.family === family &amp;&amp;<tr><td><a id="l53"></a><a href="#l53">53</a><td>          ipAddress.internal === loopback) {<tr><td><a id="l54"></a><a href="#l54">54</a><td>        addresses.push(ipAddress.address);<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>  }<tr><td><a id="l58"></a><a href="#l58">58</a><td>  return addresses[0];<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><tr><td><a id="l62"></a><a href="#l62">62</a><td>// PUBLIC API<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> * Retrieves the external IP address for this host.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @param {string=} opt_family The IP family to retrieve. Defaults to &quot;IPv4&quot;.<tr><td><a id="l68"></a><a href="#l68">68</a><td> * @return {string} The IP address or undefined if not available.<tr><td><a id="l69"></a><a href="#l69">69</a><td> */<tr><td><a id="l70"></a><a href="#l70">70</a><td>exports.getAddress = function(opt_family) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>  return getAddress(false, opt_family);<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><tr><td><a id="l75"></a><a href="#l75">75</a><td>/**<tr><td><a id="l76"></a><a href="#l76">76</a><td> * Retrieves a loopback address for this machine.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @param {string=} opt_family The IP family to retrieve. Defaults to &quot;IPv4&quot;.<tr><td><a id="l78"></a><a href="#l78">78</a><td> * @return {string} The IP address or undefined if not available.<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td>exports.getLoopbackAddress = function(opt_family) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>  return getAddress(true, opt_family);<tr><td><a id="l82"></a><a href="#l82">82</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>
\ No newline at end of file
diff --git a/docs/source/net/portprober.js.src.html b/docs/source/net/portprober.js.src.html
index 115b0c9..591c440 100644
--- a/docs/source/net/portprober.js.src.html
+++ b/docs/source/net/portprober.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>portprober.js</title><link href="../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>net/portprober.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>&#39;use strict&#39;;<tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td>var exec = require(&#39;child_process&#39;).exec,<tr><td><a name="l19" href="#l19">19</a><td>    fs = require(&#39;fs&#39;),<tr><td><a name="l20" href="#l20">20</a><td>    net = require(&#39;net&#39;);<tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>var promise = require(&#39;../index&#39;).promise;<tr><td><a name="l23" href="#l23">23</a><td><tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>/**<tr><td><a name="l26" href="#l26">26</a><td> * The IANA suggested ephemeral port range.<tr><td><a name="l27" href="#l27">27</a><td> * @type {{min: number, max: number}}<tr><td><a name="l28" href="#l28">28</a><td> * @const<tr><td><a name="l29" href="#l29">29</a><td> * @see http://en.wikipedia.org/wiki/Ephemeral_ports<tr><td><a name="l30" href="#l30">30</a><td> */<tr><td><a name="l31" href="#l31">31</a><td>var DEFAULT_IANA_RANGE = {min: 49152, max: 65535};<tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td><tr><td><a name="l34" href="#l34">34</a><td>/**<tr><td><a name="l35" href="#l35">35</a><td> * The epheremal port range for the current system. Lazily computed on first<tr><td><a name="l36" href="#l36">36</a><td> * access.<tr><td><a name="l37" href="#l37">37</a><td> * @type {webdriver.promise.Promise.&lt;{min: number, max: number}&gt;}<tr><td><a name="l38" href="#l38">38</a><td> */<tr><td><a name="l39" href="#l39">39</a><td>var systemRange = null;<tr><td><a name="l40" href="#l40">40</a><td><tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td>/**<tr><td><a name="l43" href="#l43">43</a><td> * Computes the ephemeral port range for the current system. This is based on<tr><td><a name="l44" href="#l44">44</a><td> * http://stackoverflow.com/a/924337.<tr><td><a name="l45" href="#l45">45</a><td> * @return {webdriver.promise.Promise.&lt;{min: number, max: number}&gt;} A promise<tr><td><a name="l46" href="#l46">46</a><td> *     that will resolve to the ephemeral port range of the current system.<tr><td><a name="l47" href="#l47">47</a><td> */<tr><td><a name="l48" href="#l48">48</a><td>function findSystemPortRange() {<tr><td><a name="l49" href="#l49">49</a><td>  if (systemRange) {<tr><td><a name="l50" href="#l50">50</a><td>    return systemRange;<tr><td><a name="l51" href="#l51">51</a><td>  }<tr><td><a name="l52" href="#l52">52</a><td>  var range = process.platform === &#39;win32&#39; ?<tr><td><a name="l53" href="#l53">53</a><td>      findWindowsPortRange() : findUnixPortRange();<tr><td><a name="l54" href="#l54">54</a><td>  return systemRange = range.thenCatch(function() {<tr><td><a name="l55" href="#l55">55</a><td>    return DEFAULT_IANA_RANGE;<tr><td><a name="l56" href="#l56">56</a><td>  });<tr><td><a name="l57" href="#l57">57</a><td>}<tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td>/**<tr><td><a name="l61" href="#l61">61</a><td> * Executes a command and returns its output if it succeeds.<tr><td><a name="l62" href="#l62">62</a><td> * @param {string} cmd The command to execute.<tr><td><a name="l63" href="#l63">63</a><td> * @return {!webdriver.promise.Promise&lt;string&gt;} A promise that will resolve<tr><td><a name="l64" href="#l64">64</a><td> *     with the command&#39;s stdout data.<tr><td><a name="l65" href="#l65">65</a><td> */<tr><td><a name="l66" href="#l66">66</a><td>function execute(cmd) {<tr><td><a name="l67" href="#l67">67</a><td>  var result = promise.defer();<tr><td><a name="l68" href="#l68">68</a><td>  exec(cmd, function(err, stdout) {<tr><td><a name="l69" href="#l69">69</a><td>    if (err) {<tr><td><a name="l70" href="#l70">70</a><td>      result.reject(err);<tr><td><a name="l71" href="#l71">71</a><td>    } else {<tr><td><a name="l72" href="#l72">72</a><td>      result.fulfill(stdout);<tr><td><a name="l73" href="#l73">73</a><td>    }<tr><td><a name="l74" href="#l74">74</a><td>  });<tr><td><a name="l75" href="#l75">75</a><td>  return result.promise;<tr><td><a name="l76" href="#l76">76</a><td>}<tr><td><a name="l77" href="#l77">77</a><td><tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td>/**<tr><td><a name="l80" href="#l80">80</a><td> * Computes the ephemeral port range for a Unix-like system.<tr><td><a name="l81" href="#l81">81</a><td> * @return {!webdriver.promise.Promise&lt;{min: number, max: number}&gt;} A promise<tr><td><a name="l82" href="#l82">82</a><td> *     that will resolve with the ephemeral port range on the current system.<tr><td><a name="l83" href="#l83">83</a><td> */<tr><td><a name="l84" href="#l84">84</a><td>function findUnixPortRange() {<tr><td><a name="l85" href="#l85">85</a><td>  var cmd;<tr><td><a name="l86" href="#l86">86</a><td>  if (process.platform === &#39;sunos&#39;) {<tr><td><a name="l87" href="#l87">87</a><td>    cmd =<tr><td><a name="l88" href="#l88">88</a><td>        &#39;/usr/sbin/ndd /dev/tcp tcp_smallest_anon_port tcp_largest_anon_port&#39;;<tr><td><a name="l89" href="#l89">89</a><td>  } else if (fs.existsSync(&#39;/proc/sys/net/ipv4/ip_local_port_range&#39;)) {<tr><td><a name="l90" href="#l90">90</a><td>    // Linux<tr><td><a name="l91" href="#l91">91</a><td>    cmd = &#39;cat /proc/sys/net/ipv4/ip_local_port_range&#39;;<tr><td><a name="l92" href="#l92">92</a><td>  } else {<tr><td><a name="l93" href="#l93">93</a><td>    cmd = &#39;sysctl net.inet.ip.portrange.first net.inet.ip.portrange.last&#39; +<tr><td><a name="l94" href="#l94">94</a><td>        &#39; | sed -e &quot;s/.*:\\s*//&quot;&#39;;<tr><td><a name="l95" href="#l95">95</a><td>  }<tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>  return execute(cmd).then(function(stdout) {<tr><td><a name="l98" href="#l98">98</a><td>    if (!stdout || !stdout.length) return DEFAULT_IANA_RANGE;<tr><td><a name="l99" href="#l99">99</a><td>    var range = stdout.trim().split(/\s+/).map(Number);<tr><td><a name="l100" href="#l100">100</a><td>    if (range.some(isNaN)) return DEFAULT_IANA_RANGE;<tr><td><a name="l101" href="#l101">101</a><td>    return {min: range[0], max: range[1]};<tr><td><a name="l102" href="#l102">102</a><td>  });<tr><td><a name="l103" href="#l103">103</a><td>}<tr><td><a name="l104" href="#l104">104</a><td><tr><td><a name="l105" href="#l105">105</a><td><tr><td><a name="l106" href="#l106">106</a><td>/**<tr><td><a name="l107" href="#l107">107</a><td> * Computes the ephemeral port range for a Windows system.<tr><td><a name="l108" href="#l108">108</a><td> * @return {!webdriver.promise.Promise&lt;{min: number, max: number}&gt;} A promise<tr><td><a name="l109" href="#l109">109</a><td> *     that will resolve with the ephemeral port range on the current system.<tr><td><a name="l110" href="#l110">110</a><td> */<tr><td><a name="l111" href="#l111">111</a><td>function findWindowsPortRange() {<tr><td><a name="l112" href="#l112">112</a><td>  var deferredRange = promise.defer();<tr><td><a name="l113" href="#l113">113</a><td>  // First, check if we&#39;re running on XP.  If this initial command fails,<tr><td><a name="l114" href="#l114">114</a><td>  // we just fallback on the default IANA range.<tr><td><a name="l115" href="#l115">115</a><td>  return execute(&#39;cmd.exe /c ver&#39;).then(function(stdout) {<tr><td><a name="l116" href="#l116">116</a><td>    if (/Windows XP/.test(stdout)) {<tr><td><a name="l117" href="#l117">117</a><td>      // TODO: Try to read these values from the registry.<tr><td><a name="l118" href="#l118">118</a><td>      return {min: 1025, max: 5000};<tr><td><a name="l119" href="#l119">119</a><td>    } else {<tr><td><a name="l120" href="#l120">120</a><td>      return execute(&#39;netsh int ipv4 show dynamicport tcp&#39;).<tr><td><a name="l121" href="#l121">121</a><td>          then(function(stdout) {<tr><td><a name="l122" href="#l122">122</a><td>            /* &gt; netsh int ipv4 show dynamicport tcp<tr><td><a name="l123" href="#l123">123</a><td>              Protocol tcp Dynamic Port Range<tr><td><a name="l124" href="#l124">124</a><td>              ---------------------------------<tr><td><a name="l125" href="#l125">125</a><td>              Start Port : 49152<tr><td><a name="l126" href="#l126">126</a><td>              Number of Ports : 16384<tr><td><a name="l127" href="#l127">127</a><td>             */<tr><td><a name="l128" href="#l128">128</a><td>            var range = stdout.split(/\n/).filter(function(line) {<tr><td><a name="l129" href="#l129">129</a><td>              return /.*:\s*\d+/.test(line);<tr><td><a name="l130" href="#l130">130</a><td>            }).map(function(line) {<tr><td><a name="l131" href="#l131">131</a><td>              return Number(line.split(/:\s*/)[1]);<tr><td><a name="l132" href="#l132">132</a><td>            });<tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td>            return {<tr><td><a name="l135" href="#l135">135</a><td>              min: range[0],<tr><td><a name="l136" href="#l136">136</a><td>              max: range[0] + range[1]<tr><td><a name="l137" href="#l137">137</a><td>            };<tr><td><a name="l138" href="#l138">138</a><td>          });<tr><td><a name="l139" href="#l139">139</a><td>    }<tr><td><a name="l140" href="#l140">140</a><td>  });<tr><td><a name="l141" href="#l141">141</a><td>}<tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td>/**<tr><td><a name="l145" href="#l145">145</a><td> * Tests if a port is free.<tr><td><a name="l146" href="#l146">146</a><td> * @param {number} port The port to test.<tr><td><a name="l147" href="#l147">147</a><td> * @param {string=} opt_host The bound host to test the {@code port} against.<tr><td><a name="l148" href="#l148">148</a><td> *     Defaults to {@code INADDR_ANY}.<tr><td><a name="l149" href="#l149">149</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will resolve<tr><td><a name="l150" href="#l150">150</a><td> *     with whether the port is free.<tr><td><a name="l151" href="#l151">151</a><td> */<tr><td><a name="l152" href="#l152">152</a><td>function isFree(port, opt_host) {<tr><td><a name="l153" href="#l153">153</a><td>  var result = promise.defer(function() {<tr><td><a name="l154" href="#l154">154</a><td>    server.cancel();<tr><td><a name="l155" href="#l155">155</a><td>  });<tr><td><a name="l156" href="#l156">156</a><td><tr><td><a name="l157" href="#l157">157</a><td>  var server = net.createServer().on(&#39;error&#39;, function(e) {<tr><td><a name="l158" href="#l158">158</a><td>    if (e.code === &#39;EADDRINUSE&#39;) {<tr><td><a name="l159" href="#l159">159</a><td>      result.fulfill(false);<tr><td><a name="l160" href="#l160">160</a><td>    } else {<tr><td><a name="l161" href="#l161">161</a><td>      result.reject(e);<tr><td><a name="l162" href="#l162">162</a><td>    }<tr><td><a name="l163" href="#l163">163</a><td>  });<tr><td><a name="l164" href="#l164">164</a><td><tr><td><a name="l165" href="#l165">165</a><td>  server.listen(port, opt_host, function() {<tr><td><a name="l166" href="#l166">166</a><td>    server.close(function() {<tr><td><a name="l167" href="#l167">167</a><td>      result.fulfill(true);<tr><td><a name="l168" href="#l168">168</a><td>    });<tr><td><a name="l169" href="#l169">169</a><td>  });<tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>  return result.promise;<tr><td><a name="l172" href="#l172">172</a><td>}<tr><td><a name="l173" href="#l173">173</a><td><tr><td><a name="l174" href="#l174">174</a><td><tr><td><a name="l175" href="#l175">175</a><td>/**<tr><td><a name="l176" href="#l176">176</a><td> * @param {string=} opt_host The bound host to test the {@code port} against.<tr><td><a name="l177" href="#l177">177</a><td> *     Defaults to {@code INADDR_ANY}.<tr><td><a name="l178" href="#l178">178</a><td> * @return {!webdriver.promise.Promise.&lt;number&gt;} A promise that will resolve<tr><td><a name="l179" href="#l179">179</a><td> *     to a free port. If a port cannot be found, the promise will be<tr><td><a name="l180" href="#l180">180</a><td> *     rejected.<tr><td><a name="l181" href="#l181">181</a><td> */<tr><td><a name="l182" href="#l182">182</a><td>function findFreePort(opt_host) {<tr><td><a name="l183" href="#l183">183</a><td>  return findSystemPortRange().then(function(range) {<tr><td><a name="l184" href="#l184">184</a><td>    var attempts = 0;<tr><td><a name="l185" href="#l185">185</a><td>    var deferredPort = promise.defer();<tr><td><a name="l186" href="#l186">186</a><td>    findPort();<tr><td><a name="l187" href="#l187">187</a><td>    return deferredPort.promise;<tr><td><a name="l188" href="#l188">188</a><td><tr><td><a name="l189" href="#l189">189</a><td>    function findPort() {<tr><td><a name="l190" href="#l190">190</a><td>      attempts += 1;<tr><td><a name="l191" href="#l191">191</a><td>      if (attempts &gt; 10) {<tr><td><a name="l192" href="#l192">192</a><td>        deferredPort.reject(Error(&#39;Unable to find a free port&#39;));<tr><td><a name="l193" href="#l193">193</a><td>      }<tr><td><a name="l194" href="#l194">194</a><td><tr><td><a name="l195" href="#l195">195</a><td>      var port = Math.floor(<tr><td><a name="l196" href="#l196">196</a><td>          Math.random() * (range.max - range.min) + range.min);<tr><td><a name="l197" href="#l197">197</a><td>      isFree(port, opt_host).then(function(isFree) {<tr><td><a name="l198" href="#l198">198</a><td>        if (isFree) {<tr><td><a name="l199" href="#l199">199</a><td>          deferredPort.fulfill(port);<tr><td><a name="l200" href="#l200">200</a><td>        } else {<tr><td><a name="l201" href="#l201">201</a><td>          findPort();<tr><td><a name="l202" href="#l202">202</a><td>        }<tr><td><a name="l203" href="#l203">203</a><td>      });<tr><td><a name="l204" href="#l204">204</a><td>    }<tr><td><a name="l205" href="#l205">205</a><td>  });<tr><td><a name="l206" href="#l206">206</a><td>}<tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td><tr><td><a name="l209" href="#l209">209</a><td>// PUBLIC API<tr><td><a name="l210" href="#l210">210</a><td><tr><td><a name="l211" href="#l211">211</a><td><tr><td><a name="l212" href="#l212">212</a><td>exports.findFreePort = findFreePort;<tr><td><a name="l213" href="#l213">213</a><td>exports.isFree = isFree;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../types.js"></script><script src="../../dossier.js"></script>
\ No newline at end of file
+<!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>portprober.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>net/portprober.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var exec = require(&#39;child_process&#39;).exec,<tr><td><a id="l21"></a><a href="#l21">21</a><td>    fs = require(&#39;fs&#39;),<tr><td><a id="l22"></a><a href="#l22">22</a><td>    net = require(&#39;net&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td><tr><td><a id="l24"></a><a href="#l24">24</a><td>var promise = require(&#39;../index&#39;).promise;<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> * The IANA suggested ephemeral port range.<tr><td><a id="l29"></a><a href="#l29">29</a><td> * @type {{min: number, max: number}}<tr><td><a id="l30"></a><a href="#l30">30</a><td> * @const<tr><td><a id="l31"></a><a href="#l31">31</a><td> * @see http://en.wikipedia.org/wiki/Ephemeral_ports<tr><td><a id="l32"></a><a href="#l32">32</a><td> */<tr><td><a id="l33"></a><a href="#l33">33</a><td>var DEFAULT_IANA_RANGE = {min: 49152, max: 65535};<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> * The epheremal port range for the current system. Lazily computed on first<tr><td><a id="l38"></a><a href="#l38">38</a><td> * access.<tr><td><a id="l39"></a><a href="#l39">39</a><td> * @type {webdriver.promise.Promise.&lt;{min: number, max: number}&gt;}<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td>var systemRange = 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> * Computes the ephemeral port range for the current system. This is based on<tr><td><a id="l46"></a><a href="#l46">46</a><td> * http://stackoverflow.com/a/924337.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * @return {webdriver.promise.Promise.&lt;{min: number, max: number}&gt;} A promise<tr><td><a id="l48"></a><a href="#l48">48</a><td> *     that will resolve to the ephemeral port range of the current system.<tr><td><a id="l49"></a><a href="#l49">49</a><td> */<tr><td><a id="l50"></a><a href="#l50">50</a><td>function findSystemPortRange() {<tr><td><a id="l51"></a><a href="#l51">51</a><td>  if (systemRange) {<tr><td><a id="l52"></a><a href="#l52">52</a><td>    return systemRange;<tr><td><a id="l53"></a><a href="#l53">53</a><td>  }<tr><td><a id="l54"></a><a href="#l54">54</a><td>  var range = process.platform === &#39;win32&#39; ?<tr><td><a id="l55"></a><a href="#l55">55</a><td>      findWindowsPortRange() : findUnixPortRange();<tr><td><a id="l56"></a><a href="#l56">56</a><td>  return systemRange = range.thenCatch(function() {<tr><td><a id="l57"></a><a href="#l57">57</a><td>    return DEFAULT_IANA_RANGE;<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><tr><td><a id="l62"></a><a href="#l62">62</a><td>/**<tr><td><a id="l63"></a><a href="#l63">63</a><td> * Executes a command and returns its output if it succeeds.<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @param {string} cmd The command to execute.<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will resolve<tr><td><a id="l66"></a><a href="#l66">66</a><td> *     with the command&#39;s stdout data.<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td>function execute(cmd) {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  var result = promise.defer();<tr><td><a id="l70"></a><a href="#l70">70</a><td>  exec(cmd, function(err, stdout) {<tr><td><a id="l71"></a><a href="#l71">71</a><td>    if (err) {<tr><td><a id="l72"></a><a href="#l72">72</a><td>      result.reject(err);<tr><td><a id="l73"></a><a href="#l73">73</a><td>    } else {<tr><td><a id="l74"></a><a href="#l74">74</a><td>      result.fulfill(stdout);<tr><td><a id="l75"></a><a href="#l75">75</a><td>    }<tr><td><a id="l76"></a><a href="#l76">76</a><td>  });<tr><td><a id="l77"></a><a href="#l77">77</a><td>  return result.promise;<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><tr><td><a id="l81"></a><a href="#l81">81</a><td>/**<tr><td><a id="l82"></a><a href="#l82">82</a><td> * Computes the ephemeral port range for a Unix-like system.<tr><td><a id="l83"></a><a href="#l83">83</a><td> * @return {!webdriver.promise.Promise.&lt;{min: number, max: number}&gt;} A promise<tr><td><a id="l84"></a><a href="#l84">84</a><td> *     that will resolve with the ephemeral port range on the current system.<tr><td><a id="l85"></a><a href="#l85">85</a><td> */<tr><td><a id="l86"></a><a href="#l86">86</a><td>function findUnixPortRange() {<tr><td><a id="l87"></a><a href="#l87">87</a><td>  var cmd;<tr><td><a id="l88"></a><a href="#l88">88</a><td>  if (process.platform === &#39;sunos&#39;) {<tr><td><a id="l89"></a><a href="#l89">89</a><td>    cmd =<tr><td><a id="l90"></a><a href="#l90">90</a><td>        &#39;/usr/sbin/ndd /dev/tcp tcp_smallest_anon_port tcp_largest_anon_port&#39;;<tr><td><a id="l91"></a><a href="#l91">91</a><td>  } else if (fs.existsSync(&#39;/proc/sys/net/ipv4/ip_local_port_range&#39;)) {<tr><td><a id="l92"></a><a href="#l92">92</a><td>    // Linux<tr><td><a id="l93"></a><a href="#l93">93</a><td>    cmd = &#39;cat /proc/sys/net/ipv4/ip_local_port_range&#39;;<tr><td><a id="l94"></a><a href="#l94">94</a><td>  } else {<tr><td><a id="l95"></a><a href="#l95">95</a><td>    cmd = &#39;sysctl net.inet.ip.portrange.first net.inet.ip.portrange.last&#39; +<tr><td><a id="l96"></a><a href="#l96">96</a><td>        &#39; | sed -e &quot;s/.*:\\s*//&quot;&#39;;<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>  return execute(cmd).then(function(stdout) {<tr><td><a id="l100"></a><a href="#l100">100</a><td>    if (!stdout || !stdout.length) return DEFAULT_IANA_RANGE;<tr><td><a id="l101"></a><a href="#l101">101</a><td>    var range = stdout.trim().split(/\s+/).map(Number);<tr><td><a id="l102"></a><a href="#l102">102</a><td>    if (range.some(isNaN)) return DEFAULT_IANA_RANGE;<tr><td><a id="l103"></a><a href="#l103">103</a><td>    return {min: range[0], max: range[1]};<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><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> * Computes the ephemeral port range for a Windows system.<tr><td><a id="l110"></a><a href="#l110">110</a><td> * @return {!webdriver.promise.Promise.&lt;{min: number, max: number}&gt;} A promise<tr><td><a id="l111"></a><a href="#l111">111</a><td> *     that will resolve with the ephemeral port range on the current system.<tr><td><a id="l112"></a><a href="#l112">112</a><td> */<tr><td><a id="l113"></a><a href="#l113">113</a><td>function findWindowsPortRange() {<tr><td><a id="l114"></a><a href="#l114">114</a><td>  var deferredRange = promise.defer();<tr><td><a id="l115"></a><a href="#l115">115</a><td>  // First, check if we&#39;re running on XP.  If this initial command fails,<tr><td><a id="l116"></a><a href="#l116">116</a><td>  // we just fallback on the default IANA range.<tr><td><a id="l117"></a><a href="#l117">117</a><td>  return execute(&#39;cmd.exe /c ver&#39;).then(function(stdout) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    if (/Windows XP/.test(stdout)) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>      // TODO: Try to read these values from the registry.<tr><td><a id="l120"></a><a href="#l120">120</a><td>      return {min: 1025, max: 5000};<tr><td><a id="l121"></a><a href="#l121">121</a><td>    } else {<tr><td><a id="l122"></a><a href="#l122">122</a><td>      return execute(&#39;netsh int ipv4 show dynamicport tcp&#39;).<tr><td><a id="l123"></a><a href="#l123">123</a><td>          then(function(stdout) {<tr><td><a id="l124"></a><a href="#l124">124</a><td>            /* &gt; netsh int ipv4 show dynamicport tcp<tr><td><a id="l125"></a><a href="#l125">125</a><td>              Protocol tcp Dynamic Port Range<tr><td><a id="l126"></a><a href="#l126">126</a><td>              ---------------------------------<tr><td><a id="l127"></a><a href="#l127">127</a><td>              Start Port : 49152<tr><td><a id="l128"></a><a href="#l128">128</a><td>              Number of Ports : 16384<tr><td><a id="l129"></a><a href="#l129">129</a><td>             */<tr><td><a id="l130"></a><a href="#l130">130</a><td>            var range = stdout.split(/\n/).filter(function(line) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>              return /.*:\s*\d+/.test(line);<tr><td><a id="l132"></a><a href="#l132">132</a><td>            }).map(function(line) {<tr><td><a id="l133"></a><a href="#l133">133</a><td>              return Number(line.split(/:\s*/)[1]);<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>            return {<tr><td><a id="l137"></a><a href="#l137">137</a><td>              min: range[0],<tr><td><a id="l138"></a><a href="#l138">138</a><td>              max: range[0] + range[1]<tr><td><a id="l139"></a><a href="#l139">139</a><td>            };<tr><td><a id="l140"></a><a href="#l140">140</a><td>          });<tr><td><a id="l141"></a><a href="#l141">141</a><td>    }<tr><td><a id="l142"></a><a href="#l142">142</a><td>  });<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> * Tests if a port is free.<tr><td><a id="l148"></a><a href="#l148">148</a><td> * @param {number} port The port to test.<tr><td><a id="l149"></a><a href="#l149">149</a><td> * @param {string=} opt_host The bound host to test the {@code port} against.<tr><td><a id="l150"></a><a href="#l150">150</a><td> *     Defaults to {@code INADDR_ANY}.<tr><td><a id="l151"></a><a href="#l151">151</a><td> * @return {!webdriver.promise.Promise.&lt;boolean&gt;} A promise that will resolve<tr><td><a id="l152"></a><a href="#l152">152</a><td> *     with whether the port is free.<tr><td><a id="l153"></a><a href="#l153">153</a><td> */<tr><td><a id="l154"></a><a href="#l154">154</a><td>function isFree(port, opt_host) {<tr><td><a id="l155"></a><a href="#l155">155</a><td>  var result = promise.defer(function() {<tr><td><a id="l156"></a><a href="#l156">156</a><td>    server.cancel();<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>  var server = net.createServer().on(&#39;error&#39;, function(e) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>    if (e.code === &#39;EADDRINUSE&#39;) {<tr><td><a id="l161"></a><a href="#l161">161</a><td>      result.fulfill(false);<tr><td><a id="l162"></a><a href="#l162">162</a><td>    } else {<tr><td><a id="l163"></a><a href="#l163">163</a><td>      result.reject(e);<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>  server.listen(port, opt_host, function() {<tr><td><a id="l168"></a><a href="#l168">168</a><td>    server.close(function() {<tr><td><a id="l169"></a><a href="#l169">169</a><td>      result.fulfill(true);<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>  return result.promise;<tr><td><a id="l174"></a><a href="#l174">174</a><td>}<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @param {string=} opt_host The bound host to test the {@code port} against.<tr><td><a id="l179"></a><a href="#l179">179</a><td> *     Defaults to {@code INADDR_ANY}.<tr><td><a id="l180"></a><a href="#l180">180</a><td> * @return {!webdriver.promise.Promise.&lt;number&gt;} A promise that will resolve<tr><td><a id="l181"></a><a href="#l181">181</a><td> *     to a free port. If a port cannot be found, the promise will be<tr><td><a id="l182"></a><a href="#l182">182</a><td> *     rejected.<tr><td><a id="l183"></a><a href="#l183">183</a><td> */<tr><td><a id="l184"></a><a href="#l184">184</a><td>function findFreePort(opt_host) {<tr><td><a id="l185"></a><a href="#l185">185</a><td>  return findSystemPortRange().then(function(range) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>    var attempts = 0;<tr><td><a id="l187"></a><a href="#l187">187</a><td>    var deferredPort = promise.defer();<tr><td><a id="l188"></a><a href="#l188">188</a><td>    findPort();<tr><td><a id="l189"></a><a href="#l189">189</a><td>    return deferredPort.promise;<tr><td><a id="l190"></a><a href="#l190">190</a><td><tr><td><a id="l191"></a><a href="#l191">191</a><td>    function findPort() {<tr><td><a id="l192"></a><a href="#l192">192</a><td>      attempts += 1;<tr><td><a id="l193"></a><a href="#l193">193</a><td>      if (attempts &gt; 10) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>        deferredPort.reject(Error(&#39;Unable to find a free port&#39;));<tr><td><a id="l195"></a><a href="#l195">195</a><td>      }<tr><td><a id="l196"></a><a href="#l196">196</a><td><tr><td><a id="l197"></a><a href="#l197">197</a><td>      var port = Math.floor(<tr><td><a id="l198"></a><a href="#l198">198</a><td>          Math.random() * (range.max - range.min) + range.min);<tr><td><a id="l199"></a><a href="#l199">199</a><td>      isFree(port, opt_host).then(function(isFree) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>        if (isFree) {<tr><td><a id="l201"></a><a href="#l201">201</a><td>          deferredPort.fulfill(port);<tr><td><a id="l202"></a><a href="#l202">202</a><td>        } else {<tr><td><a id="l203"></a><a href="#l203">203</a><td>          findPort();<tr><td><a id="l204"></a><a href="#l204">204</a><td>        }<tr><td><a id="l205"></a><a href="#l205">205</a><td>      });<tr><td><a id="l206"></a><a href="#l206">206</a><td>    }<tr><td><a id="l207"></a><a href="#l207">207</a><td>  });<tr><td><a id="l208"></a><a href="#l208">208</a><td>}<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>// PUBLIC API<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>exports.findFreePort = findFreePort;<tr><td><a id="l215"></a><a href="#l215">215</a><td>exports.isFree = isFree;</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>
\ No newline at end of file
diff --git a/docs/source/opera.js.src.html b/docs/source/opera.js.src.html
new file mode 100644
index 0000000..9d18944
--- /dev/null
+++ b/docs/source/opera.js.src.html
@@ -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>opera.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>opera.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines a {@linkplain Driver WebDriver} client for the<tr><td><a id="l20"></a><a href="#l20">20</a><td> * Opera web browser (v26+). Before using this module, you must download the<tr><td><a id="l21"></a><a href="#l21">21</a><td> * latest OperaDriver<tr><td><a id="l22"></a><a href="#l22">22</a><td> * [release](https://github.com/operasoftware/operachromiumdriver/releases) and<tr><td><a id="l23"></a><a href="#l23">23</a><td> * ensure it can be found on your system <tr><td><a id="l24"></a><a href="#l24">24</a><td> * [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29).<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * There are three primary classes exported by this module:<tr><td><a id="l27"></a><a href="#l27">27</a><td> *<tr><td><a id="l28"></a><a href="#l28">28</a><td> * 1. {@linkplain ServiceBuilder}: configures the<tr><td><a id="l29"></a><a href="#l29">29</a><td> *     {@link selenium-webdriver/remote.DriverService remote.DriverService}<tr><td><a id="l30"></a><a href="#l30">30</a><td> *     that manages the<tr><td><a id="l31"></a><a href="#l31">31</a><td> *     [OperaDriver](https://github.com/operasoftware/operachromiumdriver)<tr><td><a id="l32"></a><a href="#l32">32</a><td> *     child process.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * 2. {@linkplain Options}: defines configuration options for each new Opera<tr><td><a id="l35"></a><a href="#l35">35</a><td> *     session, such as which {@linkplain Options#setProxy proxy} to use,<tr><td><a id="l36"></a><a href="#l36">36</a><td> *     what {@linkplain Options#addExtensions extensions} to install, or<tr><td><a id="l37"></a><a href="#l37">37</a><td> *     what {@linkplain Options#addArguments command-line switches} to use when<tr><td><a id="l38"></a><a href="#l38">38</a><td> *     starting the browser.<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * 3. {@linkplain Driver}: the WebDriver client; each new instance will control<tr><td><a id="l41"></a><a href="#l41">41</a><td> *     a unique browser session with a clean user profile (unless otherwise<tr><td><a id="l42"></a><a href="#l42">42</a><td> *     configured through the {@link Options} class).<tr><td><a id="l43"></a><a href="#l43">43</a><td> *<tr><td><a id="l44"></a><a href="#l44">44</a><td> * By default, every Opera session will use a single driver service, which is<tr><td><a id="l45"></a><a href="#l45">45</a><td> * started the first time a {@link Driver} instance is created and terminated<tr><td><a id="l46"></a><a href="#l46">46</a><td> * when this process exits. The default service will inherit its environment<tr><td><a id="l47"></a><a href="#l47">47</a><td> * from the current process and direct all output to /dev/null. You may obtain<tr><td><a id="l48"></a><a href="#l48">48</a><td> * a handle to this default service using<tr><td><a id="l49"></a><a href="#l49">49</a><td> * {@link #getDefaultService getDefaultService()} and change its configuration<tr><td><a id="l50"></a><a href="#l50">50</a><td> * with {@link #setDefaultService setDefaultService()}.<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * You may also create a {@link Driver} with its own driver service. This is<tr><td><a id="l53"></a><a href="#l53">53</a><td> * useful if you need to capture the server&#39;s log output for a specific session:<tr><td><a id="l54"></a><a href="#l54">54</a><td> *<tr><td><a id="l55"></a><a href="#l55">55</a><td> *     var opera = require(&#39;selenium-webdriver/opera&#39;);<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> *     var service = new opera.ServiceBuilder()<tr><td><a id="l58"></a><a href="#l58">58</a><td> *         .loggingTo(&#39;/my/log/file.txt&#39;)<tr><td><a id="l59"></a><a href="#l59">59</a><td> *         .enableVerboseLogging()<tr><td><a id="l60"></a><a href="#l60">60</a><td> *         .build();<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> *     var options = new opera.Options();<tr><td><a id="l63"></a><a href="#l63">63</a><td> *     // configure browser options ...<tr><td><a id="l64"></a><a href="#l64">64</a><td> *<tr><td><a id="l65"></a><a href="#l65">65</a><td> *     var driver = new opera.Driver(options, service);<tr><td><a id="l66"></a><a href="#l66">66</a><td> *<tr><td><a id="l67"></a><a href="#l67">67</a><td> * Users should only instantiate the {@link Driver} class directly when they<tr><td><a id="l68"></a><a href="#l68">68</a><td> * need a custom driver service configuration (as shown above). For normal<tr><td><a id="l69"></a><a href="#l69">69</a><td> * operation, users should start Opera using the<tr><td><a id="l70"></a><a href="#l70">70</a><td> * {@link selenium-webdriver.Builder}.<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>&#39;use strict&#39;;<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l76"></a><a href="#l76">76</a><td>    util = require(&#39;util&#39;);<tr><td><a id="l77"></a><a href="#l77">77</a><td><tr><td><a id="l78"></a><a href="#l78">78</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a id="l79"></a><a href="#l79">79</a><td>    executors = require(&#39;./executors&#39;),<tr><td><a id="l80"></a><a href="#l80">80</a><td>    io = require(&#39;./io&#39;),<tr><td><a id="l81"></a><a href="#l81">81</a><td>    portprober = require(&#39;./net/portprober&#39;),<tr><td><a id="l82"></a><a href="#l82">82</a><td>    remote = require(&#39;./remote&#39;);<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> * Name of the OperaDriver executable.<tr><td><a id="l87"></a><a href="#l87">87</a><td> * @type {string}<tr><td><a id="l88"></a><a href="#l88">88</a><td> * @const<tr><td><a id="l89"></a><a href="#l89">89</a><td> */<tr><td><a id="l90"></a><a href="#l90">90</a><td>var OPERADRIVER_EXE =<tr><td><a id="l91"></a><a href="#l91">91</a><td>    process.platform === &#39;win32&#39; ? &#39;operadriver.exe&#39; : &#39;operadriver&#39;;<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> * Creates {@link remote.DriverService} instances that manages an<tr><td><a id="l96"></a><a href="#l96">96</a><td> * [OperaDriver](https://github.com/operasoftware/operachromiumdriver)<tr><td><a id="l97"></a><a href="#l97">97</a><td> * server in a child process.<tr><td><a id="l98"></a><a href="#l98">98</a><td> *<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @param {string=} opt_exe Path to the server executable to use. If omitted,<tr><td><a id="l100"></a><a href="#l100">100</a><td> *     the builder will attempt to locate the operadriver on the current<tr><td><a id="l101"></a><a href="#l101">101</a><td> *     PATH.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @throws {Error} If provided executable does not exist, or the operadriver<tr><td><a id="l103"></a><a href="#l103">103</a><td> *     cannot be found on the PATH.<tr><td><a id="l104"></a><a href="#l104">104</a><td> * @constructor<tr><td><a id="l105"></a><a href="#l105">105</a><td> */<tr><td><a id="l106"></a><a href="#l106">106</a><td>var ServiceBuilder = function(opt_exe) {<tr><td><a id="l107"></a><a href="#l107">107</a><td>  /** @private {string} */<tr><td><a id="l108"></a><a href="#l108">108</a><td>  this.exe_ = opt_exe || io.findInPath(OPERADRIVER_EXE, true);<tr><td><a id="l109"></a><a href="#l109">109</a><td>  if (!this.exe_) {<tr><td><a id="l110"></a><a href="#l110">110</a><td>    throw Error(<tr><td><a id="l111"></a><a href="#l111">111</a><td>        &#39;The OperaDriver could not be found on the current PATH. Please &#39; +<tr><td><a id="l112"></a><a href="#l112">112</a><td>        &#39;download the latest version of the OperaDriver from &#39; +<tr><td><a id="l113"></a><a href="#l113">113</a><td>        &#39;https://github.com/operasoftware/operachromiumdriver/releases and &#39; +<tr><td><a id="l114"></a><a href="#l114">114</a><td>        &#39;ensure it can be found on your PATH.&#39;);<tr><td><a id="l115"></a><a href="#l115">115</a><td>  }<tr><td><a id="l116"></a><a href="#l116">116</a><td><tr><td><a id="l117"></a><a href="#l117">117</a><td>  if (!fs.existsSync(this.exe_)) {<tr><td><a id="l118"></a><a href="#l118">118</a><td>    throw Error(&#39;File does not exist: &#39; + this.exe_);<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>  /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l122"></a><a href="#l122">122</a><td>  this.args_ = [];<tr><td><a id="l123"></a><a href="#l123">123</a><td>  this.stdio_ = &#39;ignore&#39;;<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>/** @private {number} */<tr><td><a id="l128"></a><a href="#l128">128</a><td>ServiceBuilder.prototype.port_ = 0;<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>/** @private {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} */<tr><td><a id="l132"></a><a href="#l132">132</a><td>ServiceBuilder.prototype.stdio_ = &#39;ignore&#39;;<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>/** @private {Object.&lt;string, string&gt;} */<tr><td><a id="l136"></a><a href="#l136">136</a><td>ServiceBuilder.prototype.env_ = null;<tr><td><a id="l137"></a><a href="#l137">137</a><td><tr><td><a id="l138"></a><a href="#l138">138</a><td><tr><td><a id="l139"></a><a href="#l139">139</a><td>/**<tr><td><a id="l140"></a><a href="#l140">140</a><td> * Sets the port to start the OperaDriver on.<tr><td><a id="l141"></a><a href="#l141">141</a><td> * @param {number} port The port to use, or 0 for any free port.<tr><td><a id="l142"></a><a href="#l142">142</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l143"></a><a href="#l143">143</a><td> * @throws {Error} If the port is invalid.<tr><td><a id="l144"></a><a href="#l144">144</a><td> */<tr><td><a id="l145"></a><a href="#l145">145</a><td>ServiceBuilder.prototype.usingPort = function(port) {<tr><td><a id="l146"></a><a href="#l146">146</a><td>  if (port &lt; 0) {<tr><td><a id="l147"></a><a href="#l147">147</a><td>    throw Error(&#39;port must be &gt;= 0: &#39; + port);<tr><td><a id="l148"></a><a href="#l148">148</a><td>  }<tr><td><a id="l149"></a><a href="#l149">149</a><td>  this.port_ = port;<tr><td><a id="l150"></a><a href="#l150">150</a><td>  return this;<tr><td><a id="l151"></a><a href="#l151">151</a><td>};<tr><td><a id="l152"></a><a href="#l152">152</a><td><tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td>/**<tr><td><a id="l155"></a><a href="#l155">155</a><td> * Sets the path of the log file the driver should log to. If a log file is<tr><td><a id="l156"></a><a href="#l156">156</a><td> * not specified, the driver will log to stderr.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @param {string} path Path of the log file to use.<tr><td><a id="l158"></a><a href="#l158">158</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l159"></a><a href="#l159">159</a><td> */<tr><td><a id="l160"></a><a href="#l160">160</a><td>ServiceBuilder.prototype.loggingTo = function(path) {<tr><td><a id="l161"></a><a href="#l161">161</a><td>  this.args_.push(&#39;--log-path=&#39; + path);<tr><td><a id="l162"></a><a href="#l162">162</a><td>  return this;<tr><td><a id="l163"></a><a href="#l163">163</a><td>};<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> * Enables verbose logging.<tr><td><a id="l168"></a><a href="#l168">168</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l169"></a><a href="#l169">169</a><td> */<tr><td><a id="l170"></a><a href="#l170">170</a><td>ServiceBuilder.prototype.enableVerboseLogging = function() {<tr><td><a id="l171"></a><a href="#l171">171</a><td>  this.args_.push(&#39;--verbose&#39;);<tr><td><a id="l172"></a><a href="#l172">172</a><td>  return this;<tr><td><a id="l173"></a><a href="#l173">173</a><td>};<tr><td><a id="l174"></a><a href="#l174">174</a><td><tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td>/**<tr><td><a id="l177"></a><a href="#l177">177</a><td> * Silence sthe drivers output.<tr><td><a id="l178"></a><a href="#l178">178</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l179"></a><a href="#l179">179</a><td> */<tr><td><a id="l180"></a><a href="#l180">180</a><td>ServiceBuilder.prototype.silent = function() {<tr><td><a id="l181"></a><a href="#l181">181</a><td>  this.args_.push(&#39;--silent&#39;);<tr><td><a id="l182"></a><a href="#l182">182</a><td>  return this;<tr><td><a id="l183"></a><a href="#l183">183</a><td>};<tr><td><a id="l184"></a><a href="#l184">184</a><td><tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td>/**<tr><td><a id="l187"></a><a href="#l187">187</a><td> * Defines the stdio configuration for the driver service. See<tr><td><a id="l188"></a><a href="#l188">188</a><td> * {@code child_process.spawn} for more information.<tr><td><a id="l189"></a><a href="#l189">189</a><td> * @param {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} config The<tr><td><a id="l190"></a><a href="#l190">190</a><td> *     configuration to use.<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l192"></a><a href="#l192">192</a><td> */<tr><td><a id="l193"></a><a href="#l193">193</a><td>ServiceBuilder.prototype.setStdio = function(config) {<tr><td><a id="l194"></a><a href="#l194">194</a><td>  this.stdio_ = config;<tr><td><a id="l195"></a><a href="#l195">195</a><td>  return this;<tr><td><a id="l196"></a><a href="#l196">196</a><td>};<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td><tr><td><a id="l199"></a><a href="#l199">199</a><td>/**<tr><td><a id="l200"></a><a href="#l200">200</a><td> * Defines the environment to start the server under. This settings will be<tr><td><a id="l201"></a><a href="#l201">201</a><td> * inherited by every browser session started by the server.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @param {!Object.&lt;string, string&gt;} env The environment to use.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @return {!ServiceBuilder} A self reference.<tr><td><a id="l204"></a><a href="#l204">204</a><td> */<tr><td><a id="l205"></a><a href="#l205">205</a><td>ServiceBuilder.prototype.withEnvironment = function(env) {<tr><td><a id="l206"></a><a href="#l206">206</a><td>  this.env_ = env;<tr><td><a id="l207"></a><a href="#l207">207</a><td>  return this;<tr><td><a id="l208"></a><a href="#l208">208</a><td>};<tr><td><a id="l209"></a><a href="#l209">209</a><td><tr><td><a id="l210"></a><a href="#l210">210</a><td><tr><td><a id="l211"></a><a href="#l211">211</a><td>/**<tr><td><a id="l212"></a><a href="#l212">212</a><td> * Creates a new DriverService using this instance&#39;s current configuration.<tr><td><a id="l213"></a><a href="#l213">213</a><td> * @return {remote.DriverService} A new driver service using this instance&#39;s<tr><td><a id="l214"></a><a href="#l214">214</a><td> *     current configuration.<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @throws {Error} If the driver exectuable was not specified and a default<tr><td><a id="l216"></a><a href="#l216">216</a><td> *     could not be found on the current PATH.<tr><td><a id="l217"></a><a href="#l217">217</a><td> */<tr><td><a id="l218"></a><a href="#l218">218</a><td>ServiceBuilder.prototype.build = function() {<tr><td><a id="l219"></a><a href="#l219">219</a><td>  var port = this.port_ || portprober.findFreePort();<tr><td><a id="l220"></a><a href="#l220">220</a><td>  var args = this.args_.concat();  // Defensive copy.<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td>  return new remote.DriverService(this.exe_, {<tr><td><a id="l223"></a><a href="#l223">223</a><td>    loopback: true,<tr><td><a id="l224"></a><a href="#l224">224</a><td>    port: port,<tr><td><a id="l225"></a><a href="#l225">225</a><td>    args: webdriver.promise.when(port, function(port) {<tr><td><a id="l226"></a><a href="#l226">226</a><td>      return args.concat(&#39;--port=&#39; + port);<tr><td><a id="l227"></a><a href="#l227">227</a><td>    }),<tr><td><a id="l228"></a><a href="#l228">228</a><td>    env: this.env_,<tr><td><a id="l229"></a><a href="#l229">229</a><td>    stdio: this.stdio_<tr><td><a id="l230"></a><a href="#l230">230</a><td>  });<tr><td><a id="l231"></a><a href="#l231">231</a><td>};<tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td>/** @type {remote.DriverService} */<tr><td><a id="l235"></a><a href="#l235">235</a><td>var defaultService = null;<tr><td><a id="l236"></a><a href="#l236">236</a><td><tr><td><a id="l237"></a><a href="#l237">237</a><td><tr><td><a id="l238"></a><a href="#l238">238</a><td>/**<tr><td><a id="l239"></a><a href="#l239">239</a><td> * Sets the default service to use for new OperaDriver instances.<tr><td><a id="l240"></a><a href="#l240">240</a><td> * @param {!remote.DriverService} service The service to use.<tr><td><a id="l241"></a><a href="#l241">241</a><td> * @throws {Error} If the default service is currently running.<tr><td><a id="l242"></a><a href="#l242">242</a><td> */<tr><td><a id="l243"></a><a href="#l243">243</a><td>function setDefaultService(service) {<tr><td><a id="l244"></a><a href="#l244">244</a><td>  if (defaultService &amp;&amp; defaultService.isRunning()) {<tr><td><a id="l245"></a><a href="#l245">245</a><td>    throw Error(<tr><td><a id="l246"></a><a href="#l246">246</a><td>        &#39;The previously configured OperaDriver service is still running. &#39; +<tr><td><a id="l247"></a><a href="#l247">247</a><td>        &#39;You must shut it down before you may adjust its configuration.&#39;);<tr><td><a id="l248"></a><a href="#l248">248</a><td>  }<tr><td><a id="l249"></a><a href="#l249">249</a><td>  defaultService = service;<tr><td><a id="l250"></a><a href="#l250">250</a><td>}<tr><td><a id="l251"></a><a href="#l251">251</a><td><tr><td><a id="l252"></a><a href="#l252">252</a><td><tr><td><a id="l253"></a><a href="#l253">253</a><td>/**<tr><td><a id="l254"></a><a href="#l254">254</a><td> * Returns the default OperaDriver service. If such a service has not been<tr><td><a id="l255"></a><a href="#l255">255</a><td> * configured, one will be constructed using the default configuration for<tr><td><a id="l256"></a><a href="#l256">256</a><td> * a OperaDriver executable found on the system PATH.<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @return {!remote.DriverService} The default OperaDriver service.<tr><td><a id="l258"></a><a href="#l258">258</a><td> */<tr><td><a id="l259"></a><a href="#l259">259</a><td>function getDefaultService() {<tr><td><a id="l260"></a><a href="#l260">260</a><td>  if (!defaultService) {<tr><td><a id="l261"></a><a href="#l261">261</a><td>    defaultService = new ServiceBuilder().build();<tr><td><a id="l262"></a><a href="#l262">262</a><td>  }<tr><td><a id="l263"></a><a href="#l263">263</a><td>  return defaultService;<tr><td><a id="l264"></a><a href="#l264">264</a><td>}<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>/**<tr><td><a id="l268"></a><a href="#l268">268</a><td> * @type {string}<tr><td><a id="l269"></a><a href="#l269">269</a><td> * @const<tr><td><a id="l270"></a><a href="#l270">270</a><td> */<tr><td><a id="l271"></a><a href="#l271">271</a><td>var OPTIONS_CAPABILITY_KEY = &#39;chromeOptions&#39;;<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> * Class for managing {@link Driver OperaDriver} specific options.<tr><td><a id="l276"></a><a href="#l276">276</a><td> * @constructor<tr><td><a id="l277"></a><a href="#l277">277</a><td> * @extends {webdriver.Serializable}<tr><td><a id="l278"></a><a href="#l278">278</a><td> */<tr><td><a id="l279"></a><a href="#l279">279</a><td>var Options = function() {<tr><td><a id="l280"></a><a href="#l280">280</a><td>  webdriver.Serializable.call(this);<tr><td><a id="l281"></a><a href="#l281">281</a><td><tr><td><a id="l282"></a><a href="#l282">282</a><td>  /** @private {!Array.&lt;string&gt;} */<tr><td><a id="l283"></a><a href="#l283">283</a><td>  this.args_ = [];<tr><td><a id="l284"></a><a href="#l284">284</a><td><tr><td><a id="l285"></a><a href="#l285">285</a><td>  /** @private {!Array.&lt;(string|!Buffer)&gt;} */<tr><td><a id="l286"></a><a href="#l286">286</a><td>  this.extensions_ = [];<tr><td><a id="l287"></a><a href="#l287">287</a><td>};<tr><td><a id="l288"></a><a href="#l288">288</a><td>util.inherits(Options, webdriver.Serializable);<tr><td><a id="l289"></a><a href="#l289">289</a><td><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> * Extracts the OperaDriver specific options from the given capabilities<tr><td><a id="l293"></a><a href="#l293">293</a><td> * object.<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {!webdriver.Capabilities} capabilities The capabilities object.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @return {!Options} The OperaDriver options.<tr><td><a id="l296"></a><a href="#l296">296</a><td> */<tr><td><a id="l297"></a><a href="#l297">297</a><td>Options.fromCapabilities = function(capabilities) {<tr><td><a id="l298"></a><a href="#l298">298</a><td>  var options;<tr><td><a id="l299"></a><a href="#l299">299</a><td>  var o = capabilities.get(OPTIONS_CAPABILITY_KEY);<tr><td><a id="l300"></a><a href="#l300">300</a><td>  if (o instanceof Options) {<tr><td><a id="l301"></a><a href="#l301">301</a><td>    options = o;<tr><td><a id="l302"></a><a href="#l302">302</a><td>  } else if (o) {<tr><td><a id="l303"></a><a href="#l303">303</a><td>    options.<tr><td><a id="l304"></a><a href="#l304">304</a><td>        addArguments(o.args || []).<tr><td><a id="l305"></a><a href="#l305">305</a><td>        addExtensions(o.extensions || []).<tr><td><a id="l306"></a><a href="#l306">306</a><td>        setOperaBinaryPath(o.binary);<tr><td><a id="l307"></a><a href="#l307">307</a><td>  } else {<tr><td><a id="l308"></a><a href="#l308">308</a><td>    options = new Options;<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>  if (capabilities.has(webdriver.Capability.PROXY)) {<tr><td><a id="l312"></a><a href="#l312">312</a><td>    options.setProxy(capabilities.get(webdriver.Capability.PROXY));<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>  if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {<tr><td><a id="l316"></a><a href="#l316">316</a><td>    options.setLoggingPrefs(<tr><td><a id="l317"></a><a href="#l317">317</a><td>        capabilities.get(webdriver.Capability.LOGGING_PREFS));<tr><td><a id="l318"></a><a href="#l318">318</a><td>  }<tr><td><a id="l319"></a><a href="#l319">319</a><td><tr><td><a id="l320"></a><a href="#l320">320</a><td>  return options;<tr><td><a id="l321"></a><a href="#l321">321</a><td>};<tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td>/**<tr><td><a id="l325"></a><a href="#l325">325</a><td> * Add additional command line arguments to use when launching the Opera<tr><td><a id="l326"></a><a href="#l326">326</a><td> * browser.  Each argument may be specified with or without the &quot;--&quot; prefix<tr><td><a id="l327"></a><a href="#l327">327</a><td> * (e.g. &quot;--foo&quot; and &quot;foo&quot;). Arguments with an associated value should be<tr><td><a id="l328"></a><a href="#l328">328</a><td> * delimited by an &quot;=&quot;: &quot;foo=bar&quot;.<tr><td><a id="l329"></a><a href="#l329">329</a><td> * @param {...(string|!Array.&lt;string&gt;)} var_args The arguments to add.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @return {!Options} A self reference.<tr><td><a id="l331"></a><a href="#l331">331</a><td> */<tr><td><a id="l332"></a><a href="#l332">332</a><td>Options.prototype.addArguments = function(var_args) {<tr><td><a id="l333"></a><a href="#l333">333</a><td>  this.args_ = this.args_.concat.apply(this.args_, arguments);<tr><td><a id="l334"></a><a href="#l334">334</a><td>  return this;<tr><td><a id="l335"></a><a href="#l335">335</a><td>};<tr><td><a id="l336"></a><a href="#l336">336</a><td><tr><td><a id="l337"></a><a href="#l337">337</a><td><tr><td><a id="l338"></a><a href="#l338">338</a><td>/**<tr><td><a id="l339"></a><a href="#l339">339</a><td> * Add additional extensions to install when launching Opera. Each extension<tr><td><a id="l340"></a><a href="#l340">340</a><td> * should be specified as the path to the packed CRX file, or a Buffer for an<tr><td><a id="l341"></a><a href="#l341">341</a><td> * extension.<tr><td><a id="l342"></a><a href="#l342">342</a><td> * @param {...(string|!Buffer|!Array.&lt;(string|!Buffer)&gt;)} var_args The<tr><td><a id="l343"></a><a href="#l343">343</a><td> *     extensions to add.<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @return {!Options} A self reference.<tr><td><a id="l345"></a><a href="#l345">345</a><td> */<tr><td><a id="l346"></a><a href="#l346">346</a><td>Options.prototype.addExtensions = function(var_args) {<tr><td><a id="l347"></a><a href="#l347">347</a><td>  this.extensions_ = this.extensions_.concat.apply(<tr><td><a id="l348"></a><a href="#l348">348</a><td>      this.extensions_, arguments);<tr><td><a id="l349"></a><a href="#l349">349</a><td>  return this;<tr><td><a id="l350"></a><a href="#l350">350</a><td>};<tr><td><a id="l351"></a><a href="#l351">351</a><td><tr><td><a id="l352"></a><a href="#l352">352</a><td><tr><td><a id="l353"></a><a href="#l353">353</a><td>/**<tr><td><a id="l354"></a><a href="#l354">354</a><td> * Sets the path to the Opera binary to use. On Mac OS X, this path should<tr><td><a id="l355"></a><a href="#l355">355</a><td> * reference the actual Opera executable, not just the application binary. The<tr><td><a id="l356"></a><a href="#l356">356</a><td> * binary path be absolute or relative to the operadriver server executable, but<tr><td><a id="l357"></a><a href="#l357">357</a><td> * it must exist on the machine that will launch Opera.<tr><td><a id="l358"></a><a href="#l358">358</a><td> *<tr><td><a id="l359"></a><a href="#l359">359</a><td> * @param {string} path The path to the Opera binary to use.<tr><td><a id="l360"></a><a href="#l360">360</a><td> * @return {!Options} A self reference.<tr><td><a id="l361"></a><a href="#l361">361</a><td> */<tr><td><a id="l362"></a><a href="#l362">362</a><td>Options.prototype.setOperaBinaryPath = function(path) {<tr><td><a id="l363"></a><a href="#l363">363</a><td>  this.binary_ = path;<tr><td><a id="l364"></a><a href="#l364">364</a><td>  return this;<tr><td><a id="l365"></a><a href="#l365">365</a><td>};<tr><td><a id="l366"></a><a href="#l366">366</a><td><tr><td><a id="l367"></a><a href="#l367">367</a><td><tr><td><a id="l368"></a><a href="#l368">368</a><td>/**<tr><td><a id="l369"></a><a href="#l369">369</a><td> * Sets the logging preferences for the new session.<tr><td><a id="l370"></a><a href="#l370">370</a><td> * @param {!webdriver.logging.Preferences} prefs The logging preferences.<tr><td><a id="l371"></a><a href="#l371">371</a><td> * @return {!Options} A self reference.<tr><td><a id="l372"></a><a href="#l372">372</a><td> */<tr><td><a id="l373"></a><a href="#l373">373</a><td>Options.prototype.setLoggingPrefs = function(prefs) {<tr><td><a id="l374"></a><a href="#l374">374</a><td>  this.logPrefs_ = prefs;<tr><td><a id="l375"></a><a href="#l375">375</a><td>  return this;<tr><td><a id="l376"></a><a href="#l376">376</a><td>};<tr><td><a id="l377"></a><a href="#l377">377</a><td><tr><td><a id="l378"></a><a href="#l378">378</a><td><tr><td><a id="l379"></a><a href="#l379">379</a><td>/**<tr><td><a id="l380"></a><a href="#l380">380</a><td> * Sets the proxy settings for the new session.<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @return {!Options} A self reference.<tr><td><a id="l383"></a><a href="#l383">383</a><td> */<tr><td><a id="l384"></a><a href="#l384">384</a><td>Options.prototype.setProxy = function(proxy) {<tr><td><a id="l385"></a><a href="#l385">385</a><td>  this.proxy_ = proxy;<tr><td><a id="l386"></a><a href="#l386">386</a><td>  return this;<tr><td><a id="l387"></a><a href="#l387">387</a><td>};<tr><td><a id="l388"></a><a href="#l388">388</a><td><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> * Converts this options instance to a {@link webdriver.Capabilities} object.<tr><td><a id="l392"></a><a href="#l392">392</a><td> * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge<tr><td><a id="l393"></a><a href="#l393">393</a><td> *     these options into, if any.<tr><td><a id="l394"></a><a href="#l394">394</a><td> * @return {!webdriver.Capabilities} The capabilities.<tr><td><a id="l395"></a><a href="#l395">395</a><td> */<tr><td><a id="l396"></a><a href="#l396">396</a><td>Options.prototype.toCapabilities = function(opt_capabilities) {<tr><td><a id="l397"></a><a href="#l397">397</a><td>  var capabilities = opt_capabilities || webdriver.Capabilities.opera();<tr><td><a id="l398"></a><a href="#l398">398</a><td>  capabilities.<tr><td><a id="l399"></a><a href="#l399">399</a><td>      set(webdriver.Capability.PROXY, this.proxy_).<tr><td><a id="l400"></a><a href="#l400">400</a><td>      set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_).<tr><td><a id="l401"></a><a href="#l401">401</a><td>      set(OPTIONS_CAPABILITY_KEY, this);<tr><td><a id="l402"></a><a href="#l402">402</a><td>  return capabilities;<tr><td><a id="l403"></a><a href="#l403">403</a><td>};<tr><td><a id="l404"></a><a href="#l404">404</a><td><tr><td><a id="l405"></a><a href="#l405">405</a><td><tr><td><a id="l406"></a><a href="#l406">406</a><td>/**<tr><td><a id="l407"></a><a href="#l407">407</a><td> * Converts this instance to its JSON wire protocol representation. Note this<tr><td><a id="l408"></a><a href="#l408">408</a><td> * function is an implementation not intended for general use.<tr><td><a id="l409"></a><a href="#l409">409</a><td> * @return {{args: !Array.&lt;string&gt;,<tr><td><a id="l410"></a><a href="#l410">410</a><td> *           binary: (string|undefined),<tr><td><a id="l411"></a><a href="#l411">411</a><td> *           detach: boolean,<tr><td><a id="l412"></a><a href="#l412">412</a><td> *           extensions: !Array.&lt;(string|!webdriver.promise.Promise.&lt;string&gt;))&gt;,<tr><td><a id="l413"></a><a href="#l413">413</a><td> *           localState: (Object|undefined),<tr><td><a id="l414"></a><a href="#l414">414</a><td> *           logPath: (string|undefined),<tr><td><a id="l415"></a><a href="#l415">415</a><td> *           prefs: (Object|undefined)}} The JSON wire protocol representation<tr><td><a id="l416"></a><a href="#l416">416</a><td> *     of this instance.<tr><td><a id="l417"></a><a href="#l417">417</a><td> * @override<tr><td><a id="l418"></a><a href="#l418">418</a><td> */<tr><td><a id="l419"></a><a href="#l419">419</a><td>Options.prototype.serialize = function() {<tr><td><a id="l420"></a><a href="#l420">420</a><td>  var json = {<tr><td><a id="l421"></a><a href="#l421">421</a><td>    args: this.args_,<tr><td><a id="l422"></a><a href="#l422">422</a><td>    extensions: this.extensions_.map(function(extension) {<tr><td><a id="l423"></a><a href="#l423">423</a><td>      if (Buffer.isBuffer(extension)) {<tr><td><a id="l424"></a><a href="#l424">424</a><td>        return extension.toString(&#39;base64&#39;);<tr><td><a id="l425"></a><a href="#l425">425</a><td>      }<tr><td><a id="l426"></a><a href="#l426">426</a><td>      return webdriver.promise.checkedNodeCall(<tr><td><a id="l427"></a><a href="#l427">427</a><td>          fs.readFile, extension, &#39;base64&#39;);<tr><td><a id="l428"></a><a href="#l428">428</a><td>    })<tr><td><a id="l429"></a><a href="#l429">429</a><td>  };<tr><td><a id="l430"></a><a href="#l430">430</a><td>  if (this.binary_) {<tr><td><a id="l431"></a><a href="#l431">431</a><td>    json.binary = this.binary_;<tr><td><a id="l432"></a><a href="#l432">432</a><td>  }<tr><td><a id="l433"></a><a href="#l433">433</a><td>  if (this.logFile_) {<tr><td><a id="l434"></a><a href="#l434">434</a><td>    json.logPath = this.logFile_;<tr><td><a id="l435"></a><a href="#l435">435</a><td>  }<tr><td><a id="l436"></a><a href="#l436">436</a><td>  if (this.prefs_) {<tr><td><a id="l437"></a><a href="#l437">437</a><td>    json.prefs = this.prefs_;<tr><td><a id="l438"></a><a href="#l438">438</a><td>  }<tr><td><a id="l439"></a><a href="#l439">439</a><td><tr><td><a id="l440"></a><a href="#l440">440</a><td>  return json;<tr><td><a id="l441"></a><a href="#l441">441</a><td>};<tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td><tr><td><a id="l444"></a><a href="#l444">444</a><td>/**<tr><td><a id="l445"></a><a href="#l445">445</a><td> * Creates a new WebDriver client for Opera.<tr><td><a id="l446"></a><a href="#l446">446</a><td> *<tr><td><a id="l447"></a><a href="#l447">447</a><td> * @param {(webdriver.Capabilities|Options)=} opt_config The configuration<tr><td><a id="l448"></a><a href="#l448">448</a><td> *     options.<tr><td><a id="l449"></a><a href="#l449">449</a><td> * @param {remote.DriverService=} opt_service The session to use; will use<tr><td><a id="l450"></a><a href="#l450">450</a><td> *     the {@link getDefaultService default service} by default.<tr><td><a id="l451"></a><a href="#l451">451</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or<tr><td><a id="l452"></a><a href="#l452">452</a><td> *     {@code null} to use the currently active flow.<tr><td><a id="l453"></a><a href="#l453">453</a><td> * @constructor<tr><td><a id="l454"></a><a href="#l454">454</a><td> * @extends {webdriver.WebDriver}<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 Driver = function(opt_config, opt_service, opt_flow) {<tr><td><a id="l457"></a><a href="#l457">457</a><td>  var service = opt_service || getDefaultService();<tr><td><a id="l458"></a><a href="#l458">458</a><td>  var executor = executors.createExecutor(service.start());<tr><td><a id="l459"></a><a href="#l459">459</a><td><tr><td><a id="l460"></a><a href="#l460">460</a><td>  var capabilities =<tr><td><a id="l461"></a><a href="#l461">461</a><td>      opt_config instanceof Options ? opt_config.toCapabilities() :<tr><td><a id="l462"></a><a href="#l462">462</a><td>      (opt_config || webdriver.Capabilities.opera());<tr><td><a id="l463"></a><a href="#l463">463</a><td><tr><td><a id="l464"></a><a href="#l464">464</a><td>  // On Linux, the OperaDriver does not look for Opera on the PATH, so we<tr><td><a id="l465"></a><a href="#l465">465</a><td>  // must explicitly find it. See: operachromiumdriver #9.<tr><td><a id="l466"></a><a href="#l466">466</a><td>  if (process.platform === &#39;linux&#39;) {<tr><td><a id="l467"></a><a href="#l467">467</a><td>    var options = Options.fromCapabilities(capabilities);<tr><td><a id="l468"></a><a href="#l468">468</a><td>    if (!options.binary_) {<tr><td><a id="l469"></a><a href="#l469">469</a><td>      options.setOperaBinaryPath(io.findInPath(&#39;opera&#39;, true));<tr><td><a id="l470"></a><a href="#l470">470</a><td>    }<tr><td><a id="l471"></a><a href="#l471">471</a><td>    capabilities = options.toCapabilities(capabilities);<tr><td><a id="l472"></a><a href="#l472">472</a><td>  }<tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td>  var driver = webdriver.WebDriver.createSession(<tr><td><a id="l475"></a><a href="#l475">475</a><td>      executor, capabilities, opt_flow);<tr><td><a id="l476"></a><a href="#l476">476</a><td><tr><td><a id="l477"></a><a href="#l477">477</a><td>  webdriver.WebDriver.call(<tr><td><a id="l478"></a><a href="#l478">478</a><td>      this, driver.getSession(), executor, driver.controlFlow());<tr><td><a id="l479"></a><a href="#l479">479</a><td>};<tr><td><a id="l480"></a><a href="#l480">480</a><td>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l481"></a><a href="#l481">481</a><td><tr><td><a id="l482"></a><a href="#l482">482</a><td><tr><td><a id="l483"></a><a href="#l483">483</a><td>/**<tr><td><a id="l484"></a><a href="#l484">484</a><td> * This function is a no-op as file detectors are not supported by this<tr><td><a id="l485"></a><a href="#l485">485</a><td> * implementation.<tr><td><a id="l486"></a><a href="#l486">486</a><td> * @override<tr><td><a id="l487"></a><a href="#l487">487</a><td> */<tr><td><a id="l488"></a><a href="#l488">488</a><td>Driver.prototype.setFileDetector = function() {<tr><td><a id="l489"></a><a href="#l489">489</a><td>};<tr><td><a id="l490"></a><a href="#l490">490</a><td><tr><td><a id="l491"></a><a href="#l491">491</a><td><tr><td><a id="l492"></a><a href="#l492">492</a><td>// PUBLIC API<tr><td><a id="l493"></a><a href="#l493">493</a><td><tr><td><a id="l494"></a><a href="#l494">494</a><td><tr><td><a id="l495"></a><a href="#l495">495</a><td>exports.Driver = Driver;<tr><td><a id="l496"></a><a href="#l496">496</a><td>exports.Options = Options;<tr><td><a id="l497"></a><a href="#l497">497</a><td>exports.ServiceBuilder = ServiceBuilder;<tr><td><a id="l498"></a><a href="#l498">498</a><td>exports.getDefaultService = getDefaultService;<tr><td><a id="l499"></a><a href="#l499">499</a><td>exports.setDefaultService = setDefaultService;</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>
\ No newline at end of file
diff --git a/docs/source/phantomjs.js.src.html b/docs/source/phantomjs.js.src.html
index 8988c7d..cc68bef 100644
--- a/docs/source/phantomjs.js.src.html
+++ b/docs/source/phantomjs.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>phantomjs.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>phantomjs.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>&#39;use strict&#39;;<tr><td><a name="l17" href="#l17">17</a><td><tr><td><a name="l18" href="#l18">18</a><td>var fs = require(&#39;fs&#39;),<tr><td><a name="l19" href="#l19">19</a><td>    util = require(&#39;util&#39;);<tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a name="l22" href="#l22">22</a><td>    LogLevel = webdriver.logging.LevelName,<tr><td><a name="l23" href="#l23">23</a><td>    executors = require(&#39;./executors&#39;),<tr><td><a name="l24" href="#l24">24</a><td>    io = require(&#39;./io&#39;),<tr><td><a name="l25" href="#l25">25</a><td>    portprober = require(&#39;./net/portprober&#39;),<tr><td><a name="l26" href="#l26">26</a><td>    remote = require(&#39;./remote&#39;);<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td>/**<tr><td><a name="l30" href="#l30">30</a><td> * Name of the PhantomJS executable.<tr><td><a name="l31" href="#l31">31</a><td> * @type {string}<tr><td><a name="l32" href="#l32">32</a><td> * @const<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td>var PHANTOMJS_EXE =<tr><td><a name="l35" href="#l35">35</a><td>    process.platform === &#39;win32&#39; ? &#39;phantomjs.exe&#39; : &#39;phantomjs&#39;;<tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td>/**<tr><td><a name="l39" href="#l39">39</a><td> * Capability that designates the location of the PhantomJS executable to use.<tr><td><a name="l40" href="#l40">40</a><td> * @type {string}<tr><td><a name="l41" href="#l41">41</a><td> * @const<tr><td><a name="l42" href="#l42">42</a><td> */<tr><td><a name="l43" href="#l43">43</a><td>var BINARY_PATH_CAPABILITY = &#39;phantomjs.binary.path&#39;;<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td><tr><td><a name="l46" href="#l46">46</a><td>/**<tr><td><a name="l47" href="#l47">47</a><td> * Capability that designates the CLI arguments to pass to PhantomJS.<tr><td><a name="l48" href="#l48">48</a><td> * @type {string}<tr><td><a name="l49" href="#l49">49</a><td> * @const<tr><td><a name="l50" href="#l50">50</a><td> */<tr><td><a name="l51" href="#l51">51</a><td>var CLI_ARGS_CAPABILITY = &#39;phantomjs.cli.args&#39;;<tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td><tr><td><a name="l54" href="#l54">54</a><td>/**<tr><td><a name="l55" href="#l55">55</a><td> * Default log file to use if one is not specified through CLI args.<tr><td><a name="l56" href="#l56">56</a><td> * @type {string}<tr><td><a name="l57" href="#l57">57</a><td> * @const<tr><td><a name="l58" href="#l58">58</a><td> */<tr><td><a name="l59" href="#l59">59</a><td>var DEFAULT_LOG_FILE = &#39;phantomjsdriver.log&#39;;<tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td>/**<tr><td><a name="l63" href="#l63">63</a><td> * Finds the PhantomJS executable.<tr><td><a name="l64" href="#l64">64</a><td> * @param {string=} opt_exe Path to the executable to use.<tr><td><a name="l65" href="#l65">65</a><td> * @return {string} The located executable.<tr><td><a name="l66" href="#l66">66</a><td> * @throws {Error} If the executable cannot be found on the PATH, or if the<tr><td><a name="l67" href="#l67">67</a><td> *     provided executable path does not exist.<tr><td><a name="l68" href="#l68">68</a><td> */<tr><td><a name="l69" href="#l69">69</a><td>function findExecutable(opt_exe) {<tr><td><a name="l70" href="#l70">70</a><td>  var exe = opt_exe || io.findInPath(PHANTOMJS_EXE, true);<tr><td><a name="l71" href="#l71">71</a><td>  if (!exe) {<tr><td><a name="l72" href="#l72">72</a><td>    throw Error(<tr><td><a name="l73" href="#l73">73</a><td>        &#39;The PhantomJS executable could not be found on the current PATH. &#39; +<tr><td><a name="l74" href="#l74">74</a><td>        &#39;Please download the latest version from &#39; +<tr><td><a name="l75" href="#l75">75</a><td>        &#39;http://phantomjs.org/download.html and ensure it can be found on &#39; +<tr><td><a name="l76" href="#l76">76</a><td>        &#39;your PATH. For more information, see &#39; +<tr><td><a name="l77" href="#l77">77</a><td>        &#39;https://github.com/ariya/phantomjs/wiki&#39;);<tr><td><a name="l78" href="#l78">78</a><td>  }<tr><td><a name="l79" href="#l79">79</a><td>  if (!fs.existsSync(exe)) {<tr><td><a name="l80" href="#l80">80</a><td>    throw Error(&#39;File does not exist: &#39; + exe);<tr><td><a name="l81" href="#l81">81</a><td>  }<tr><td><a name="l82" href="#l82">82</a><td>  return exe;<tr><td><a name="l83" href="#l83">83</a><td>}<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td>/**<tr><td><a name="l87" href="#l87">87</a><td> * Maps WebDriver logging level name to those recognised by PhantomJS.<tr><td><a name="l88" href="#l88">88</a><td> * @type {!Object.&lt;webdriver.logging.LevelName, string&gt;}<tr><td><a name="l89" href="#l89">89</a><td> * @const<tr><td><a name="l90" href="#l90">90</a><td> */<tr><td><a name="l91" href="#l91">91</a><td>var WEBDRIVER_TO_PHANTOMJS_LEVEL = (function() {<tr><td><a name="l92" href="#l92">92</a><td>  var map = {};<tr><td><a name="l93" href="#l93">93</a><td>  map[LogLevel.ALL] = map[LogLevel.DEBUG] = &#39;DEBUG&#39;;<tr><td><a name="l94" href="#l94">94</a><td>  map[LogLevel.INFO] = &#39;INFO&#39;;<tr><td><a name="l95" href="#l95">95</a><td>  map[LogLevel.WARNING] = &#39;WARN&#39;;<tr><td><a name="l96" href="#l96">96</a><td>  map[LogLevel.SEVERE] = map[LogLevel.OFF] = &#39;ERROR&#39;;<tr><td><a name="l97" href="#l97">97</a><td>  return map;<tr><td><a name="l98" href="#l98">98</a><td>})();<tr><td><a name="l99" href="#l99">99</a><td><tr><td><a name="l100" href="#l100">100</a><td><tr><td><a name="l101" href="#l101">101</a><td>/**<tr><td><a name="l102" href="#l102">102</a><td> * Creates a new PhantomJS WebDriver client.<tr><td><a name="l103" href="#l103">103</a><td> * @param {webdriver.Capabilities=} opt_capabilities The desired capabilities.<tr><td><a name="l104" href="#l104">104</a><td> * @return {!webdriver.WebDriver} A new WebDriver instance.<tr><td><a name="l105" href="#l105">105</a><td> */<tr><td><a name="l106" href="#l106">106</a><td>function createDriver(opt_capabilities) {<tr><td><a name="l107" href="#l107">107</a><td>  var capabilities = opt_capabilities || webdriver.Capabilities.phantomjs();<tr><td><a name="l108" href="#l108">108</a><td>  var exe = findExecutable(capabilities.get(BINARY_PATH_CAPABILITY));<tr><td><a name="l109" href="#l109">109</a><td>  var args = [&#39;--webdriver-logfile=&#39; + DEFAULT_LOG_FILE];<tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td>  var logPrefs = capabilities.get(webdriver.Capability.LOGGING_PREFS);<tr><td><a name="l112" href="#l112">112</a><td>  if (logPrefs &amp;&amp; logPrefs[webdriver.logging.Type.DRIVER]) {<tr><td><a name="l113" href="#l113">113</a><td>    var level = WEBDRIVER_TO_PHANTOMJS_LEVEL[<tr><td><a name="l114" href="#l114">114</a><td>        logPrefs[webdriver.logging.Type.DRIVER]];<tr><td><a name="l115" href="#l115">115</a><td>    if (level) {<tr><td><a name="l116" href="#l116">116</a><td>      args.push(&#39;--webdriver-loglevel=&#39; + level);<tr><td><a name="l117" href="#l117">117</a><td>    }<tr><td><a name="l118" href="#l118">118</a><td>  }<tr><td><a name="l119" href="#l119">119</a><td><tr><td><a name="l120" href="#l120">120</a><td>  var proxy = capabilities.get(webdriver.Capability.PROXY);<tr><td><a name="l121" href="#l121">121</a><td>  if (proxy) {<tr><td><a name="l122" href="#l122">122</a><td>    switch (proxy.proxyType) {<tr><td><a name="l123" href="#l123">123</a><td>      case &#39;manual&#39;:<tr><td><a name="l124" href="#l124">124</a><td>        if (proxy.httpProxy) {<tr><td><a name="l125" href="#l125">125</a><td>          args.push(<tr><td><a name="l126" href="#l126">126</a><td>              &#39;--proxy-type=http&#39;,<tr><td><a name="l127" href="#l127">127</a><td>              &#39;--proxy=http://&#39; + proxy.httpProxy);<tr><td><a name="l128" href="#l128">128</a><td>        }<tr><td><a name="l129" href="#l129">129</a><td>        break;<tr><td><a name="l130" href="#l130">130</a><td>      case &#39;pac&#39;:<tr><td><a name="l131" href="#l131">131</a><td>        throw Error(&#39;PhantomJS does not support Proxy PAC files&#39;);<tr><td><a name="l132" href="#l132">132</a><td>      case &#39;system&#39;:<tr><td><a name="l133" href="#l133">133</a><td>        args.push(&#39;--proxy-type=system&#39;);<tr><td><a name="l134" href="#l134">134</a><td>        break;<tr><td><a name="l135" href="#l135">135</a><td>      case &#39;direct&#39;:<tr><td><a name="l136" href="#l136">136</a><td>        args.push(&#39;--proxy-type=none&#39;);<tr><td><a name="l137" href="#l137">137</a><td>        break;<tr><td><a name="l138" href="#l138">138</a><td>    }<tr><td><a name="l139" href="#l139">139</a><td>  }<tr><td><a name="l140" href="#l140">140</a><td>  args = args.concat(capabilities.get(CLI_ARGS_CAPABILITY) || []);<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td>  var port = portprober.findFreePort();<tr><td><a name="l143" href="#l143">143</a><td>  var service = new remote.DriverService(exe, {<tr><td><a name="l144" href="#l144">144</a><td>    port: port,<tr><td><a name="l145" href="#l145">145</a><td>    args: webdriver.promise.when(port, function(port) {<tr><td><a name="l146" href="#l146">146</a><td>      args.push(&#39;--webdriver=&#39; + port);<tr><td><a name="l147" href="#l147">147</a><td>      return args;<tr><td><a name="l148" href="#l148">148</a><td>    })<tr><td><a name="l149" href="#l149">149</a><td>  });<tr><td><a name="l150" href="#l150">150</a><td><tr><td><a name="l151" href="#l151">151</a><td>  var executor = executors.createExecutor(service.start());<tr><td><a name="l152" href="#l152">152</a><td>  var driver = webdriver.WebDriver.createSession(executor, capabilities);<tr><td><a name="l153" href="#l153">153</a><td>  var boundQuit = driver.quit.bind(driver);<tr><td><a name="l154" href="#l154">154</a><td>  driver.quit = function() {<tr><td><a name="l155" href="#l155">155</a><td>    return boundQuit().thenFinally(service.kill.bind(service));<tr><td><a name="l156" href="#l156">156</a><td>  };<tr><td><a name="l157" href="#l157">157</a><td>  return driver;<tr><td><a name="l158" href="#l158">158</a><td>}<tr><td><a name="l159" href="#l159">159</a><td><tr><td><a name="l160" href="#l160">160</a><td><tr><td><a name="l161" href="#l161">161</a><td>// PUBLIC API<tr><td><a name="l162" href="#l162">162</a><td><tr><td><a name="l163" href="#l163">163</a><td><tr><td><a name="l164" href="#l164">164</a><td>exports.createDriver = createDriver;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
+<!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>phantomjs.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>phantomjs.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var fs = require(&#39;fs&#39;),<tr><td><a id="l21"></a><a href="#l21">21</a><td>    util = require(&#39;util&#39;);<tr><td><a id="l22"></a><a href="#l22">22</a><td><tr><td><a id="l23"></a><a href="#l23">23</a><td>var webdriver = require(&#39;./index&#39;),<tr><td><a id="l24"></a><a href="#l24">24</a><td>    executors = require(&#39;./executors&#39;),<tr><td><a id="l25"></a><a href="#l25">25</a><td>    http = require(&#39;./http&#39;),<tr><td><a id="l26"></a><a href="#l26">26</a><td>    io = require(&#39;./io&#39;),<tr><td><a id="l27"></a><a href="#l27">27</a><td>    portprober = require(&#39;./net/portprober&#39;),<tr><td><a id="l28"></a><a href="#l28">28</a><td>    remote = require(&#39;./remote&#39;);<tr><td><a id="l29"></a><a href="#l29">29</a><td><tr><td><a id="l30"></a><a href="#l30">30</a><td><tr><td><a id="l31"></a><a href="#l31">31</a><td>/**<tr><td><a id="l32"></a><a href="#l32">32</a><td> * Name of the PhantomJS executable.<tr><td><a id="l33"></a><a href="#l33">33</a><td> * @type {string}<tr><td><a id="l34"></a><a href="#l34">34</a><td> * @const<tr><td><a id="l35"></a><a href="#l35">35</a><td> */<tr><td><a id="l36"></a><a href="#l36">36</a><td>var PHANTOMJS_EXE =<tr><td><a id="l37"></a><a href="#l37">37</a><td>    process.platform === &#39;win32&#39; ? &#39;phantomjs.exe&#39; : &#39;phantomjs&#39;;<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> * Capability that designates the location of the PhantomJS executable to use.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * @type {string}<tr><td><a id="l43"></a><a href="#l43">43</a><td> * @const<tr><td><a id="l44"></a><a href="#l44">44</a><td> */<tr><td><a id="l45"></a><a href="#l45">45</a><td>var BINARY_PATH_CAPABILITY = &#39;phantomjs.binary.path&#39;;<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> * Capability that designates the CLI arguments to pass to PhantomJS.<tr><td><a id="l50"></a><a href="#l50">50</a><td> * @type {string}<tr><td><a id="l51"></a><a href="#l51">51</a><td> * @const<tr><td><a id="l52"></a><a href="#l52">52</a><td> */<tr><td><a id="l53"></a><a href="#l53">53</a><td>var CLI_ARGS_CAPABILITY = &#39;phantomjs.cli.args&#39;;<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> * Default log file to use if one is not specified through CLI args.<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @type {string}<tr><td><a id="l59"></a><a href="#l59">59</a><td> * @const<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>var DEFAULT_LOG_FILE = &#39;phantomjsdriver.log&#39;;<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>/**<tr><td><a id="l65"></a><a href="#l65">65</a><td> * Custom command names supported by PhantomJS.<tr><td><a id="l66"></a><a href="#l66">66</a><td> * @enum {string}<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td>var Command = {<tr><td><a id="l69"></a><a href="#l69">69</a><td>  EXECUTE_PHANTOM_SCRIPT: &#39;executePhantomScript&#39;<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> * Finds the PhantomJS executable.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {string=} opt_exe Path to the executable to use.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {string} The located executable.<tr><td><a id="l77"></a><a href="#l77">77</a><td> * @throws {Error} If the executable cannot be found on the PATH, or if the<tr><td><a id="l78"></a><a href="#l78">78</a><td> *     provided executable path does not exist.<tr><td><a id="l79"></a><a href="#l79">79</a><td> */<tr><td><a id="l80"></a><a href="#l80">80</a><td>function findExecutable(opt_exe) {<tr><td><a id="l81"></a><a href="#l81">81</a><td>  var exe = opt_exe || io.findInPath(PHANTOMJS_EXE, true);<tr><td><a id="l82"></a><a href="#l82">82</a><td>  if (!exe) {<tr><td><a id="l83"></a><a href="#l83">83</a><td>    throw Error(<tr><td><a id="l84"></a><a href="#l84">84</a><td>        &#39;The PhantomJS executable could not be found on the current PATH. &#39; +<tr><td><a id="l85"></a><a href="#l85">85</a><td>        &#39;Please download the latest version from &#39; +<tr><td><a id="l86"></a><a href="#l86">86</a><td>        &#39;http://phantomjs.org/download.html and ensure it can be found on &#39; +<tr><td><a id="l87"></a><a href="#l87">87</a><td>        &#39;your PATH. For more information, see &#39; +<tr><td><a id="l88"></a><a href="#l88">88</a><td>        &#39;https://github.com/ariya/phantomjs/wiki&#39;);<tr><td><a id="l89"></a><a href="#l89">89</a><td>  }<tr><td><a id="l90"></a><a href="#l90">90</a><td>  if (!fs.existsSync(exe)) {<tr><td><a id="l91"></a><a href="#l91">91</a><td>    throw Error(&#39;File does not exist: &#39; + exe);<tr><td><a id="l92"></a><a href="#l92">92</a><td>  }<tr><td><a id="l93"></a><a href="#l93">93</a><td>  return exe;<tr><td><a id="l94"></a><a href="#l94">94</a><td>}<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Maps WebDriver logging level name to those recognised by PhantomJS.<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @type {!Object.&lt;string, string&gt;}<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @const<tr><td><a id="l101"></a><a href="#l101">101</a><td> */<tr><td><a id="l102"></a><a href="#l102">102</a><td>var WEBDRIVER_TO_PHANTOMJS_LEVEL = (function() {<tr><td><a id="l103"></a><a href="#l103">103</a><td>  var map = {};<tr><td><a id="l104"></a><a href="#l104">104</a><td>  map[webdriver.logging.Level.ALL.name] = &#39;DEBUG&#39;;<tr><td><a id="l105"></a><a href="#l105">105</a><td>  map[webdriver.logging.Level.DEBUG.name] = &#39;DEBUG&#39;;<tr><td><a id="l106"></a><a href="#l106">106</a><td>  map[webdriver.logging.Level.INFO.name] = &#39;INFO&#39;;<tr><td><a id="l107"></a><a href="#l107">107</a><td>  map[webdriver.logging.Level.WARNING.name] = &#39;WARN&#39;;<tr><td><a id="l108"></a><a href="#l108">108</a><td>  map[webdriver.logging.Level.SEVERE.name] = &#39;ERROR&#39;;<tr><td><a id="l109"></a><a href="#l109">109</a><td>  return map;<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>/**<tr><td><a id="l114"></a><a href="#l114">114</a><td> * Creates a command executor with support for PhantomJS&#39; custom commands.<tr><td><a id="l115"></a><a href="#l115">115</a><td> * @param {!webdriver.promise.Promise&lt;string&gt;} url The server&#39;s URL.<tr><td><a id="l116"></a><a href="#l116">116</a><td> * @return {!webdriver.CommandExecutor} The new command executor.<tr><td><a id="l117"></a><a href="#l117">117</a><td> */<tr><td><a id="l118"></a><a href="#l118">118</a><td>function createExecutor(url) {<tr><td><a id="l119"></a><a href="#l119">119</a><td>  return new executors.DeferredExecutor(url.then(function(url) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>    var client = new http.HttpClient(url);<tr><td><a id="l121"></a><a href="#l121">121</a><td>    var executor = new http.Executor(client);<tr><td><a id="l122"></a><a href="#l122">122</a><td><tr><td><a id="l123"></a><a href="#l123">123</a><td>    executor.defineCommand(<tr><td><a id="l124"></a><a href="#l124">124</a><td>        Command.EXECUTE_PHANTOM_SCRIPT,<tr><td><a id="l125"></a><a href="#l125">125</a><td>        &#39;POST&#39;, &#39;/session/:sessionId/phantom/execute&#39;);<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 executor;<tr><td><a id="l128"></a><a href="#l128">128</a><td>  }));<tr><td><a id="l129"></a><a href="#l129">129</a><td>}<tr><td><a id="l130"></a><a href="#l130">130</a><td><tr><td><a id="l131"></a><a href="#l131">131</a><td>/**<tr><td><a id="l132"></a><a href="#l132">132</a><td> * Creates a new WebDriver client for PhantomJS.<tr><td><a id="l133"></a><a href="#l133">133</a><td> *<tr><td><a id="l134"></a><a href="#l134">134</a><td> * @param {webdriver.Capabilities=} opt_capabilities The desired capabilities.<tr><td><a id="l135"></a><a href="#l135">135</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or<tr><td><a id="l136"></a><a href="#l136">136</a><td> *     {@code null} to use the currently active flow.<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @constructor<tr><td><a id="l138"></a><a href="#l138">138</a><td> * @extends {webdriver.WebDriver}<tr><td><a id="l139"></a><a href="#l139">139</a><td> */<tr><td><a id="l140"></a><a href="#l140">140</a><td>var Driver = function(opt_capabilities, opt_flow) {<tr><td><a id="l141"></a><a href="#l141">141</a><td>  var capabilities = opt_capabilities || webdriver.Capabilities.phantomjs();<tr><td><a id="l142"></a><a href="#l142">142</a><td>  var exe = findExecutable(capabilities.get(BINARY_PATH_CAPABILITY));<tr><td><a id="l143"></a><a href="#l143">143</a><td>  var args = [&#39;--webdriver-logfile=&#39; + DEFAULT_LOG_FILE];<tr><td><a id="l144"></a><a href="#l144">144</a><td><tr><td><a id="l145"></a><a href="#l145">145</a><td>  var logPrefs = capabilities.get(webdriver.Capability.LOGGING_PREFS);<tr><td><a id="l146"></a><a href="#l146">146</a><td>  if (logPrefs instanceof webdriver.logging.Preferences) {<tr><td><a id="l147"></a><a href="#l147">147</a><td>    logPrefs = logPrefs.toJSON();<tr><td><a id="l148"></a><a href="#l148">148</a><td>  }<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>  if (logPrefs &amp;&amp; logPrefs[webdriver.logging.Type.DRIVER]) {<tr><td><a id="l151"></a><a href="#l151">151</a><td>    var level = WEBDRIVER_TO_PHANTOMJS_LEVEL[<tr><td><a id="l152"></a><a href="#l152">152</a><td>        logPrefs[webdriver.logging.Type.DRIVER]];<tr><td><a id="l153"></a><a href="#l153">153</a><td>    if (level) {<tr><td><a id="l154"></a><a href="#l154">154</a><td>      args.push(&#39;--webdriver-loglevel=&#39; + level);<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>  var proxy = capabilities.get(webdriver.Capability.PROXY);<tr><td><a id="l159"></a><a href="#l159">159</a><td>  if (proxy) {<tr><td><a id="l160"></a><a href="#l160">160</a><td>    switch (proxy.proxyType) {<tr><td><a id="l161"></a><a href="#l161">161</a><td>      case &#39;manual&#39;:<tr><td><a id="l162"></a><a href="#l162">162</a><td>        if (proxy.httpProxy) {<tr><td><a id="l163"></a><a href="#l163">163</a><td>          args.push(<tr><td><a id="l164"></a><a href="#l164">164</a><td>              &#39;--proxy-type=http&#39;,<tr><td><a id="l165"></a><a href="#l165">165</a><td>              &#39;--proxy=http://&#39; + proxy.httpProxy);<tr><td><a id="l166"></a><a href="#l166">166</a><td>        }<tr><td><a id="l167"></a><a href="#l167">167</a><td>        break;<tr><td><a id="l168"></a><a href="#l168">168</a><td>      case &#39;pac&#39;:<tr><td><a id="l169"></a><a href="#l169">169</a><td>        throw Error(&#39;PhantomJS does not support Proxy PAC files&#39;);<tr><td><a id="l170"></a><a href="#l170">170</a><td>      case &#39;system&#39;:<tr><td><a id="l171"></a><a href="#l171">171</a><td>        args.push(&#39;--proxy-type=system&#39;);<tr><td><a id="l172"></a><a href="#l172">172</a><td>        break;<tr><td><a id="l173"></a><a href="#l173">173</a><td>      case &#39;direct&#39;:<tr><td><a id="l174"></a><a href="#l174">174</a><td>        args.push(&#39;--proxy-type=none&#39;);<tr><td><a id="l175"></a><a href="#l175">175</a><td>        break;<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>  args = args.concat(capabilities.get(CLI_ARGS_CAPABILITY) || []);<tr><td><a id="l179"></a><a href="#l179">179</a><td><tr><td><a id="l180"></a><a href="#l180">180</a><td>  var port = portprober.findFreePort();<tr><td><a id="l181"></a><a href="#l181">181</a><td>  var service = new remote.DriverService(exe, {<tr><td><a id="l182"></a><a href="#l182">182</a><td>    port: port,<tr><td><a id="l183"></a><a href="#l183">183</a><td>    args: webdriver.promise.when(port, function(port) {<tr><td><a id="l184"></a><a href="#l184">184</a><td>      args.push(&#39;--webdriver=&#39; + port);<tr><td><a id="l185"></a><a href="#l185">185</a><td>      return args;<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>  var executor = createExecutor(service.start());<tr><td><a id="l190"></a><a href="#l190">190</a><td>  var driver = webdriver.WebDriver.createSession(<tr><td><a id="l191"></a><a href="#l191">191</a><td>      executor, capabilities, opt_flow);<tr><td><a id="l192"></a><a href="#l192">192</a><td><tr><td><a id="l193"></a><a href="#l193">193</a><td>  webdriver.WebDriver.call(<tr><td><a id="l194"></a><a href="#l194">194</a><td>      this, driver.getSession(), executor, driver.controlFlow());<tr><td><a id="l195"></a><a href="#l195">195</a><td><tr><td><a id="l196"></a><a href="#l196">196</a><td>  var boundQuit = this.quit.bind(this);<tr><td><a id="l197"></a><a href="#l197">197</a><td><tr><td><a id="l198"></a><a href="#l198">198</a><td>  /** @override */<tr><td><a id="l199"></a><a href="#l199">199</a><td>  this.quit = function() {<tr><td><a id="l200"></a><a href="#l200">200</a><td>    return boundQuit().thenFinally(service.kill.bind(service));<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>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l204"></a><a href="#l204">204</a><td><tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>/**<tr><td><a id="l207"></a><a href="#l207">207</a><td> * This function is a no-op as file detectors are not supported by this<tr><td><a id="l208"></a><a href="#l208">208</a><td> * implementation.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @override<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>Driver.prototype.setFileDetector = function() {<tr><td><a id="l212"></a><a href="#l212">212</a><td>};<tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * Executes a PhantomJS fragment. This method is similar to<tr><td><a id="l217"></a><a href="#l217">217</a><td> * {@link #executeScript}, except it exposes the<tr><td><a id="l218"></a><a href="#l218">218</a><td> * &lt;a href=&quot;http://phantomjs.org/api/&quot;&gt;PhantomJS API&lt;/a&gt; to the injected<tr><td><a id="l219"></a><a href="#l219">219</a><td> * script.<tr><td><a id="l220"></a><a href="#l220">220</a><td> *<tr><td><a id="l221"></a><a href="#l221">221</a><td> * &lt;p&gt;The injected script will execute in the context of PhantomJS&#39;s<tr><td><a id="l222"></a><a href="#l222">222</a><td> * {@code page} variable. If a page has not been loaded before calling this<tr><td><a id="l223"></a><a href="#l223">223</a><td> * method, one will be created.&lt;/p&gt;<tr><td><a id="l224"></a><a href="#l224">224</a><td> *<tr><td><a id="l225"></a><a href="#l225">225</a><td> * &lt;p&gt;Be sure to wrap callback definitions in a try/catch block, as failures<tr><td><a id="l226"></a><a href="#l226">226</a><td> * may cause future WebDriver calls to fail.&lt;/p&gt;<tr><td><a id="l227"></a><a href="#l227">227</a><td> *<tr><td><a id="l228"></a><a href="#l228">228</a><td> * &lt;p&gt;Certain callbacks are used by GhostDriver (the PhantomJS WebDriver<tr><td><a id="l229"></a><a href="#l229">229</a><td> * implementation) and overriding these may cause the script to fail. It is<tr><td><a id="l230"></a><a href="#l230">230</a><td> * recommended that you check for existing callbacks before defining your own.<tr><td><a id="l231"></a><a href="#l231">231</a><td> * &lt;/p&gt;<tr><td><a id="l232"></a><a href="#l232">232</a><td> *<tr><td><a id="l233"></a><a href="#l233">233</a><td> * As with {@link #executeScript}, the injected script may be defined as<tr><td><a id="l234"></a><a href="#l234">234</a><td> * a string for an anonymous function body (e.g. &quot;return 123;&quot;), or as a<tr><td><a id="l235"></a><a href="#l235">235</a><td> * function. If a function is provided, it will be decompiled to its original<tr><td><a id="l236"></a><a href="#l236">236</a><td> * source. Note that injecting functions is provided as a convenience to<tr><td><a id="l237"></a><a href="#l237">237</a><td> * simplify defining complex scripts. Care must be taken that the function<tr><td><a id="l238"></a><a href="#l238">238</a><td> * only references variables that will be defined in the page&#39;s scope and<tr><td><a id="l239"></a><a href="#l239">239</a><td> * that the function does not override {@code Function.prototype.toString}<tr><td><a id="l240"></a><a href="#l240">240</a><td> * (overriding toString() will interfere with how the function is<tr><td><a id="l241"></a><a href="#l241">241</a><td> * decompiled.<tr><td><a id="l242"></a><a href="#l242">242</a><td> *<tr><td><a id="l243"></a><a href="#l243">243</a><td> * @param {(string|!Function)} script The script to execute.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {...*} var_args The arguments to pass to the script.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @return {!webdriver.promise.Promise&lt;T&gt;} A promise that resolve to the<tr><td><a id="l246"></a><a href="#l246">246</a><td> *     script&#39;s return value.<tr><td><a id="l247"></a><a href="#l247">247</a><td> * @template T<tr><td><a id="l248"></a><a href="#l248">248</a><td> */<tr><td><a id="l249"></a><a href="#l249">249</a><td>Driver.prototype.executePhantomJS = function(script, args) {<tr><td><a id="l250"></a><a href="#l250">250</a><td>  if (typeof script === &#39;function&#39;) {<tr><td><a id="l251"></a><a href="#l251">251</a><td>    script = &#39;return (&#39; + script + &#39;).apply(this, arguments);&#39;;<tr><td><a id="l252"></a><a href="#l252">252</a><td>  }<tr><td><a id="l253"></a><a href="#l253">253</a><td>  var args = arguments.length &gt; 1<tr><td><a id="l254"></a><a href="#l254">254</a><td>      ? Array.prototype.slice.call(arguments, 1) : [];<tr><td><a id="l255"></a><a href="#l255">255</a><td>  return this.schedule(<tr><td><a id="l256"></a><a href="#l256">256</a><td>      new webdriver.Command(Command.EXECUTE_PHANTOM_SCRIPT)<tr><td><a id="l257"></a><a href="#l257">257</a><td>          .setParameter(&#39;script&#39;, script)<tr><td><a id="l258"></a><a href="#l258">258</a><td>          .setParameter(&#39;args&#39;, args),<tr><td><a id="l259"></a><a href="#l259">259</a><td>      &#39;Driver.executePhantomJS()&#39;);<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>// PUBLIC API<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td>exports.Driver = Driver;</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>
\ No newline at end of file
diff --git a/docs/source/proxy.js.src.html b/docs/source/proxy.js.src.html
index 70d3c1d..3424f55 100644
--- a/docs/source/proxy.js.src.html
+++ b/docs/source/proxy.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>proxy.js</title><link href="../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>proxy.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>//     You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Defines functions for configuring a webdriver proxy:<tr><td><a name="l17" href="#l17">17</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l18" href="#l18">18</a><td> * var webdriver = require(&#39;selenium-webdriver&#39;),<tr><td><a name="l19" href="#l19">19</a><td> *     proxy = require(&#39;selenium-webdriver/proxy&#39;);<tr><td><a name="l20" href="#l20">20</a><td> *<tr><td><a name="l21" href="#l21">21</a><td> * var driver = new webdriver.Builder()<tr><td><a name="l22" href="#l22">22</a><td> *     .withCapabilities(webdriver.Capabilities.chrome())<tr><td><a name="l23" href="#l23">23</a><td> *     .setProxy(proxy.manual({http: &#39;host:1234&#39;}))<tr><td><a name="l24" href="#l24">24</a><td> *     .build();<tr><td><a name="l25" href="#l25">25</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l26" href="#l26">26</a><td> */<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td>&#39;use strict&#39;;<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td>var util = require(&#39;util&#39;);<tr><td><a name="l31" href="#l31">31</a><td><tr><td><a name="l32" href="#l32">32</a><td><tr><td><a name="l33" href="#l33">33</a><td>/**<tr><td><a name="l34" href="#l34">34</a><td> * Proxy configuration object, as defined by the WebDriver wire protocol.<tr><td><a name="l35" href="#l35">35</a><td> * @typedef {(<tr><td><a name="l36" href="#l36">36</a><td> *     {proxyType: string}|<tr><td><a name="l37" href="#l37">37</a><td> *     {proxyType: string,<tr><td><a name="l38" href="#l38">38</a><td> *      proxyAutoconfigUrl: string}|<tr><td><a name="l39" href="#l39">39</a><td> *     {proxyType: string,<tr><td><a name="l40" href="#l40">40</a><td> *      ftpProxy: string,<tr><td><a name="l41" href="#l41">41</a><td> *      httpProxy: string,<tr><td><a name="l42" href="#l42">42</a><td> *      sslProxy: string,<tr><td><a name="l43" href="#l43">43</a><td> *      noProxy: string})}<tr><td><a name="l44" href="#l44">44</a><td> */<tr><td><a name="l45" href="#l45">45</a><td>var ProxyConfig;<tr><td><a name="l46" href="#l46">46</a><td><tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>// PUBLIC API<tr><td><a name="l50" href="#l50">50</a><td><tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td>/**<tr><td><a name="l53" href="#l53">53</a><td> * Configures WebDriver to bypass all browser proxies.<tr><td><a name="l54" href="#l54">54</a><td> * @return {!ProxyConfig} A new proxy configuration object.<tr><td><a name="l55" href="#l55">55</a><td> */<tr><td><a name="l56" href="#l56">56</a><td>exports.direct = function() {<tr><td><a name="l57" href="#l57">57</a><td>  return {proxyType: &#39;direct&#39;};<tr><td><a name="l58" href="#l58">58</a><td>};<tr><td><a name="l59" href="#l59">59</a><td><tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td>/**<tr><td><a name="l62" href="#l62">62</a><td> * Manually configures the browser proxy.  The following options are<tr><td><a name="l63" href="#l63">63</a><td> * supported:<tr><td><a name="l64" href="#l64">64</a><td> * &lt;ul&gt;<tr><td><a name="l65" href="#l65">65</a><td> * &lt;li&gt;{@code ftp}: Proxy host to use for FTP requests<tr><td><a name="l66" href="#l66">66</a><td> * &lt;li&gt;{@code http}: Proxy host to use for HTTP requests<tr><td><a name="l67" href="#l67">67</a><td> * &lt;li&gt;{@code https}: Proxy host to use for HTTPS requests<tr><td><a name="l68" href="#l68">68</a><td> * &lt;li&gt;{@code bypass}: A list of hosts requests should directly connect to,<tr><td><a name="l69" href="#l69">69</a><td> *     bypassing any other proxies for that request. May be specified as a<tr><td><a name="l70" href="#l70">70</a><td> *     comma separated string, or a list of strings.<tr><td><a name="l71" href="#l71">71</a><td> * &lt;/ul&gt;<tr><td><a name="l72" href="#l72">72</a><td> *<tr><td><a name="l73" href="#l73">73</a><td> * Behavior is undefined for FTP, HTTP, and HTTPS requests if the<tr><td><a name="l74" href="#l74">74</a><td> * corresponding key is omitted from the configuration options.<tr><td><a name="l75" href="#l75">75</a><td> *<tr><td><a name="l76" href="#l76">76</a><td> * @param {{ftp: (string|undefined),<tr><td><a name="l77" href="#l77">77</a><td> *          http: (string|undefined),<tr><td><a name="l78" href="#l78">78</a><td> *          https: (string|undefined),<tr><td><a name="l79" href="#l79">79</a><td> *          bypass: (string|!Array.&lt;string&gt;|undefined)}} options Proxy<tr><td><a name="l80" href="#l80">80</a><td> *     configuration options.<tr><td><a name="l81" href="#l81">81</a><td> * @return {!ProxyConfig} A new proxy configuration object.<tr><td><a name="l82" href="#l82">82</a><td> */<tr><td><a name="l83" href="#l83">83</a><td>exports.manual = function(options) {<tr><td><a name="l84" href="#l84">84</a><td>  return {<tr><td><a name="l85" href="#l85">85</a><td>    proxyType: &#39;manual&#39;,<tr><td><a name="l86" href="#l86">86</a><td>    ftpProxy: options.ftp,<tr><td><a name="l87" href="#l87">87</a><td>    httpProxy: options.http,<tr><td><a name="l88" href="#l88">88</a><td>    sslProxy: options.https,<tr><td><a name="l89" href="#l89">89</a><td>    noProxy: util.isArray(options.bypass) ?<tr><td><a name="l90" href="#l90">90</a><td>        options.bypass.join(&#39;,&#39;) : options.bypass<tr><td><a name="l91" href="#l91">91</a><td>  };<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/**<tr><td><a name="l96" href="#l96">96</a><td> * Configures WebDriver to configure the browser proxy using the PAC file at<tr><td><a name="l97" href="#l97">97</a><td> * the given URL.<tr><td><a name="l98" href="#l98">98</a><td> * @param {string} url URL for the PAC proxy to use.<tr><td><a name="l99" href="#l99">99</a><td> * @return {!ProxyConfig} A new proxy configuration object.<tr><td><a name="l100" href="#l100">100</a><td> */<tr><td><a name="l101" href="#l101">101</a><td>exports.pac = function(url) {<tr><td><a name="l102" href="#l102">102</a><td>  return {<tr><td><a name="l103" href="#l103">103</a><td>    proxyType: &#39;pac&#39;,<tr><td><a name="l104" href="#l104">104</a><td>    proxyAutoconfigUrl: url<tr><td><a name="l105" href="#l105">105</a><td>  };<tr><td><a name="l106" href="#l106">106</a><td>};<tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td><tr><td><a name="l109" href="#l109">109</a><td>/**<tr><td><a name="l110" href="#l110">110</a><td> * Configures WebDriver to use the current system&#39;s proxy.<tr><td><a name="l111" href="#l111">111</a><td> * @return {!ProxyConfig} A new proxy configuration object.<tr><td><a name="l112" href="#l112">112</a><td> */<tr><td><a name="l113" href="#l113">113</a><td>exports.system = function() {<tr><td><a name="l114" href="#l114">114</a><td>  return {proxyType: &#39;system&#39;};<tr><td><a name="l115" href="#l115">115</a><td>};</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../types.js"></script><script src="../dossier.js"></script>
\ No newline at end of file
+<!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>proxy.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>proxy.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines functions for configuring a webdriver proxy:<tr><td><a id="l20"></a><a href="#l20">20</a><td> *<tr><td><a id="l21"></a><a href="#l21">21</a><td> *     var webdriver = require(&#39;selenium-webdriver&#39;),<tr><td><a id="l22"></a><a href="#l22">22</a><td> *         proxy = require(&#39;selenium-webdriver/proxy&#39;);<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> *     var driver = new webdriver.Builder()<tr><td><a id="l25"></a><a href="#l25">25</a><td> *         .withCapabilities(webdriver.Capabilities.chrome())<tr><td><a id="l26"></a><a href="#l26">26</a><td> *         .setProxy(proxy.manual({http: &#39;host:1234&#39;}))<tr><td><a id="l27"></a><a href="#l27">27</a><td> *         .build();<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>&#39;use strict&#39;;<tr><td><a id="l31"></a><a href="#l31">31</a><td><tr><td><a id="l32"></a><a href="#l32">32</a><td>var util = require(&#39;util&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td><tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td><tr><td><a id="l36"></a><a href="#l36">36</a><td>// PUBLIC API<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> * Configures WebDriver to bypass all browser proxies.<tr><td><a id="l41"></a><a href="#l41">41</a><td> * @return {!webdriver.ProxyConfig} A new proxy configuration object.<tr><td><a id="l42"></a><a href="#l42">42</a><td> */<tr><td><a id="l43"></a><a href="#l43">43</a><td>exports.direct = function() {<tr><td><a id="l44"></a><a href="#l44">44</a><td>  return {proxyType: &#39;direct&#39;};<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> * Manually configures the browser proxy.  The following options are<tr><td><a id="l50"></a><a href="#l50">50</a><td> * supported:<tr><td><a id="l51"></a><a href="#l51">51</a><td> *<tr><td><a id="l52"></a><a href="#l52">52</a><td> * - `ftp`: Proxy host to use for FTP requests<tr><td><a id="l53"></a><a href="#l53">53</a><td> * - `http`: Proxy host to use for HTTP requests<tr><td><a id="l54"></a><a href="#l54">54</a><td> * - `https`: Proxy host to use for HTTPS requests<tr><td><a id="l55"></a><a href="#l55">55</a><td> * - `bypass`: A list of hosts requests should directly connect to,<tr><td><a id="l56"></a><a href="#l56">56</a><td> *     bypassing any other proxies for that request. May be specified as a<tr><td><a id="l57"></a><a href="#l57">57</a><td> *     comma separated string, or a list of strings.<tr><td><a id="l58"></a><a href="#l58">58</a><td> *<tr><td><a id="l59"></a><a href="#l59">59</a><td> * Behavior is undefined for FTP, HTTP, and HTTPS requests if the<tr><td><a id="l60"></a><a href="#l60">60</a><td> * corresponding key is omitted from the configuration options.<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @param {{ftp: (string|undefined),<tr><td><a id="l63"></a><a href="#l63">63</a><td> *          http: (string|undefined),<tr><td><a id="l64"></a><a href="#l64">64</a><td> *          https: (string|undefined),<tr><td><a id="l65"></a><a href="#l65">65</a><td> *          bypass: (string|!Array.&lt;string&gt;|undefined)}} options Proxy<tr><td><a id="l66"></a><a href="#l66">66</a><td> *     configuration options.<tr><td><a id="l67"></a><a href="#l67">67</a><td> * @return {!webdriver.ProxyConfig} A new proxy configuration object.<tr><td><a id="l68"></a><a href="#l68">68</a><td> */<tr><td><a id="l69"></a><a href="#l69">69</a><td>exports.manual = function(options) {<tr><td><a id="l70"></a><a href="#l70">70</a><td>  return {<tr><td><a id="l71"></a><a href="#l71">71</a><td>    proxyType: &#39;manual&#39;,<tr><td><a id="l72"></a><a href="#l72">72</a><td>    ftpProxy: options.ftp,<tr><td><a id="l73"></a><a href="#l73">73</a><td>    httpProxy: options.http,<tr><td><a id="l74"></a><a href="#l74">74</a><td>    sslProxy: options.https,<tr><td><a id="l75"></a><a href="#l75">75</a><td>    noProxy: util.isArray(options.bypass) ?<tr><td><a id="l76"></a><a href="#l76">76</a><td>        options.bypass.join(&#39;,&#39;) : options.bypass<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><tr><td><a id="l81"></a><a href="#l81">81</a><td>/**<tr><td><a id="l82"></a><a href="#l82">82</a><td> * Configures WebDriver to configure the browser proxy using the PAC file at<tr><td><a id="l83"></a><a href="#l83">83</a><td> * the given URL.<tr><td><a id="l84"></a><a href="#l84">84</a><td> * @param {string} url URL for the PAC proxy to use.<tr><td><a id="l85"></a><a href="#l85">85</a><td> * @return {!webdriver.ProxyConfig} A new proxy configuration object.<tr><td><a id="l86"></a><a href="#l86">86</a><td> */<tr><td><a id="l87"></a><a href="#l87">87</a><td>exports.pac = function(url) {<tr><td><a id="l88"></a><a href="#l88">88</a><td>  return {<tr><td><a id="l89"></a><a href="#l89">89</a><td>    proxyType: &#39;pac&#39;,<tr><td><a id="l90"></a><a href="#l90">90</a><td>    proxyAutoconfigUrl: url<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>/**<tr><td><a id="l96"></a><a href="#l96">96</a><td> * Configures WebDriver to use the current system&#39;s proxy.<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @return {!webdriver.ProxyConfig} A new proxy configuration object.<tr><td><a id="l98"></a><a href="#l98">98</a><td> */<tr><td><a id="l99"></a><a href="#l99">99</a><td>exports.system = function() {<tr><td><a id="l100"></a><a href="#l100">100</a><td>  return {proxyType: &#39;system&#39;};<tr><td><a id="l101"></a><a href="#l101">101</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>
\ No newline at end of file
diff --git a/docs/source/remote/index.js.src.html b/docs/source/remote/index.js.src.html
index a6a3b48..4951c23 100644
--- a/docs/source/remote/index.js.src.html
+++ b/docs/source/remote/index.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>index.js</title><link href="../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>remote/index.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>//     You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>&#39;use strict&#39;;<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>var spawn = require(&#39;child_process&#39;).spawn,<tr><td><a name="l18" href="#l18">18</a><td>    os = require(&#39;os&#39;),<tr><td><a name="l19" href="#l19">19</a><td>    path = require(&#39;path&#39;),<tr><td><a name="l20" href="#l20">20</a><td>    url = require(&#39;url&#39;),<tr><td><a name="l21" href="#l21">21</a><td>    util = require(&#39;util&#39;);<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>var promise = require(&#39;../&#39;).promise,<tr><td><a name="l24" href="#l24">24</a><td>    httpUtil = require(&#39;../http/util&#39;),<tr><td><a name="l25" href="#l25">25</a><td>    net = require(&#39;../net&#39;),<tr><td><a name="l26" href="#l26">26</a><td>    portprober = require(&#39;../net/portprober&#39;);<tr><td><a name="l27" href="#l27">27</a><td><tr><td><a name="l28" href="#l28">28</a><td><tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td>/**<tr><td><a name="l31" href="#l31">31</a><td> * Configuration options for a DriverService instance.<tr><td><a name="l32" href="#l32">32</a><td> * &lt;ul&gt;<tr><td><a name="l33" href="#l33">33</a><td> * &lt;li&gt;{@code port} - The port to start the server on (must be &gt; 0). If the<tr><td><a name="l34" href="#l34">34</a><td> *     port is provided as a promise, the service will wait for the promise to<tr><td><a name="l35" href="#l35">35</a><td> *     resolve before starting.<tr><td><a name="l36" href="#l36">36</a><td> * &lt;li&gt;{@code args} - The arguments to pass to the service. If a promise is<tr><td><a name="l37" href="#l37">37</a><td> *     provided, the service will wait for it to resolve before starting.<tr><td><a name="l38" href="#l38">38</a><td> * &lt;li&gt;{@code path} - The base path on the server for the WebDriver wire<tr><td><a name="l39" href="#l39">39</a><td> *     protocol (e.g. &#39;/wd/hub&#39;). Defaults to &#39;/&#39;.<tr><td><a name="l40" href="#l40">40</a><td> * &lt;li&gt;{@code env} - The environment variables that should be visible to the<tr><td><a name="l41" href="#l41">41</a><td> *     server process. Defaults to inheriting the current process&#39;s<tr><td><a name="l42" href="#l42">42</a><td> *     environment.<tr><td><a name="l43" href="#l43">43</a><td> * &lt;li&gt;{@code stdio} - IO configuration for the spawned server process. For<tr><td><a name="l44" href="#l44">44</a><td> *     more information, refer to the documentation of<tr><td><a name="l45" href="#l45">45</a><td> *     {@code child_process.spawn}.<tr><td><a name="l46" href="#l46">46</a><td> * &lt;/ul&gt;<tr><td><a name="l47" href="#l47">47</a><td> *<tr><td><a name="l48" href="#l48">48</a><td> * @typedef {{<tr><td><a name="l49" href="#l49">49</a><td> *   port: (number|!webdriver.promise.Promise.&lt;number&gt;),<tr><td><a name="l50" href="#l50">50</a><td> *   args: !(Array.&lt;string&gt;|webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;),<tr><td><a name="l51" href="#l51">51</a><td> *   path: (string|undefined),<tr><td><a name="l52" href="#l52">52</a><td> *   env: (!Object.&lt;string, string&gt;|undefined),<tr><td><a name="l53" href="#l53">53</a><td> *   stdio: (string|!Array.&lt;string|number|!Stream|null|undefined&gt;|undefined)<tr><td><a name="l54" href="#l54">54</a><td> * }}<tr><td><a name="l55" href="#l55">55</a><td> */<tr><td><a name="l56" href="#l56">56</a><td>var ServiceOptions;<tr><td><a name="l57" href="#l57">57</a><td><tr><td><a name="l58" href="#l58">58</a><td><tr><td><a name="l59" href="#l59">59</a><td>/**<tr><td><a name="l60" href="#l60">60</a><td> * Manages the life and death of a native executable WebDriver server.<tr><td><a name="l61" href="#l61">61</a><td> *<tr><td><a name="l62" href="#l62">62</a><td> * &lt;p&gt;It is expected that the driver server implements the<tr><td><a name="l63" href="#l63">63</a><td> * &lt;a href=&quot;http://code.google.com/p/selenium/wiki/JsonWireProtocol&quot;&gt;WebDriver<tr><td><a name="l64" href="#l64">64</a><td> * Wire Protocol&lt;/a&gt;. Furthermore, the managed server should support multiple<tr><td><a name="l65" href="#l65">65</a><td> * concurrent sessions, so that this class may be reused for multiple clients.<tr><td><a name="l66" href="#l66">66</a><td> *<tr><td><a name="l67" href="#l67">67</a><td> * @param {string} executable Path to the executable to run.<tr><td><a name="l68" href="#l68">68</a><td> * @param {!ServiceOptions} options Configuration options for the service.<tr><td><a name="l69" href="#l69">69</a><td> * @constructor<tr><td><a name="l70" href="#l70">70</a><td> */<tr><td><a name="l71" href="#l71">71</a><td>function DriverService(executable, options) {<tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>  /** @private {string} */<tr><td><a name="l74" href="#l74">74</a><td>  this.executable_ = executable;<tr><td><a name="l75" href="#l75">75</a><td><tr><td><a name="l76" href="#l76">76</a><td>  /** @private {(number|!webdriver.promise.Promise.&lt;number&gt;)} */<tr><td><a name="l77" href="#l77">77</a><td>  this.port_ = options.port;<tr><td><a name="l78" href="#l78">78</a><td><tr><td><a name="l79" href="#l79">79</a><td>  /**<tr><td><a name="l80" href="#l80">80</a><td>   * @private {!(Array.&lt;string&gt;|webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;)}<tr><td><a name="l81" href="#l81">81</a><td>   */<tr><td><a name="l82" href="#l82">82</a><td>  this.args_ = options.args;<tr><td><a name="l83" href="#l83">83</a><td><tr><td><a name="l84" href="#l84">84</a><td>  /** @private {string} */<tr><td><a name="l85" href="#l85">85</a><td>  this.path_ = options.path || &#39;/&#39;;<tr><td><a name="l86" href="#l86">86</a><td><tr><td><a name="l87" href="#l87">87</a><td>  /** @private {!Object.&lt;string, string&gt;} */<tr><td><a name="l88" href="#l88">88</a><td>  this.env_ = options.env || process.env;<tr><td><a name="l89" href="#l89">89</a><td><tr><td><a name="l90" href="#l90">90</a><td>  /** @private {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} */<tr><td><a name="l91" href="#l91">91</a><td>  this.stdio_ = options.stdio || &#39;ignore&#39;;<tr><td><a name="l92" href="#l92">92</a><td>}<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/**<tr><td><a name="l96" href="#l96">96</a><td> * The default amount of time, in milliseconds, to wait for the server to<tr><td><a name="l97" href="#l97">97</a><td> * start.<tr><td><a name="l98" href="#l98">98</a><td> * @type {number}<tr><td><a name="l99" href="#l99">99</a><td> */<tr><td><a name="l100" href="#l100">100</a><td>DriverService.DEFAULT_START_TIMEOUT_MS = 30 * 1000;<tr><td><a name="l101" href="#l101">101</a><td><tr><td><a name="l102" href="#l102">102</a><td><tr><td><a name="l103" href="#l103">103</a><td>/** @private {child_process.ChildProcess} */<tr><td><a name="l104" href="#l104">104</a><td>DriverService.prototype.process_ = null;<tr><td><a name="l105" href="#l105">105</a><td><tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td>/**<tr><td><a name="l108" href="#l108">108</a><td> * Promise that resolves to the server&#39;s address or null if the server has not<tr><td><a name="l109" href="#l109">109</a><td> * been started.<tr><td><a name="l110" href="#l110">110</a><td> * @private {webdriver.promise.Promise.&lt;string&gt;}<tr><td><a name="l111" href="#l111">111</a><td> */<tr><td><a name="l112" href="#l112">112</a><td>DriverService.prototype.address_ = null;<tr><td><a name="l113" href="#l113">113</a><td><tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>/**<tr><td><a name="l116" href="#l116">116</a><td> * Promise that tracks the status of shutting down the server, or null if the<tr><td><a name="l117" href="#l117">117</a><td> * server is not currently shutting down.<tr><td><a name="l118" href="#l118">118</a><td> * @private {webdriver.promise.Promise}<tr><td><a name="l119" href="#l119">119</a><td> */<tr><td><a name="l120" href="#l120">120</a><td>DriverService.prototype.shutdownHook_ = null;<tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td>/**<tr><td><a name="l124" href="#l124">124</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that resolves to<tr><td><a name="l125" href="#l125">125</a><td> *    the server&#39;s address.<tr><td><a name="l126" href="#l126">126</a><td> * @throws {Error} If the server has not been started.<tr><td><a name="l127" href="#l127">127</a><td> */<tr><td><a name="l128" href="#l128">128</a><td>DriverService.prototype.address = function() {<tr><td><a name="l129" href="#l129">129</a><td>  if (this.address_) {<tr><td><a name="l130" href="#l130">130</a><td>    return this.address_;<tr><td><a name="l131" href="#l131">131</a><td>  }<tr><td><a name="l132" href="#l132">132</a><td>  throw Error(&#39;Server has not been started.&#39;);<tr><td><a name="l133" href="#l133">133</a><td>};<tr><td><a name="l134" href="#l134">134</a><td><tr><td><a name="l135" href="#l135">135</a><td><tr><td><a name="l136" href="#l136">136</a><td>/**<tr><td><a name="l137" href="#l137">137</a><td> * @return {boolean} Whether the underlying service process is running.<tr><td><a name="l138" href="#l138">138</a><td> */<tr><td><a name="l139" href="#l139">139</a><td>DriverService.prototype.isRunning = function() {<tr><td><a name="l140" href="#l140">140</a><td>  return !!this.address_;<tr><td><a name="l141" href="#l141">141</a><td>};<tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td><tr><td><a name="l144" href="#l144">144</a><td>/**<tr><td><a name="l145" href="#l145">145</a><td> * Starts the server if it is not already running.<tr><td><a name="l146" href="#l146">146</a><td> * @param {number=} opt_timeoutMs How long to wait, in milliseconds, for the<tr><td><a name="l147" href="#l147">147</a><td> *     server to start accepting requests. Defaults to 30 seconds.<tr><td><a name="l148" href="#l148">148</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that will resolve<tr><td><a name="l149" href="#l149">149</a><td> *     to the server&#39;s base URL when it has started accepting requests. If the<tr><td><a name="l150" href="#l150">150</a><td> *     timeout expires before the server has started, the promise will be<tr><td><a name="l151" href="#l151">151</a><td> *     rejected.<tr><td><a name="l152" href="#l152">152</a><td> */<tr><td><a name="l153" href="#l153">153</a><td>DriverService.prototype.start = function(opt_timeoutMs) {<tr><td><a name="l154" href="#l154">154</a><td>  if (this.address_) {<tr><td><a name="l155" href="#l155">155</a><td>    return this.address_;<tr><td><a name="l156" href="#l156">156</a><td>  }<tr><td><a name="l157" href="#l157">157</a><td><tr><td><a name="l158" href="#l158">158</a><td>  var timeout = opt_timeoutMs || DriverService.DEFAULT_START_TIMEOUT_MS;<tr><td><a name="l159" href="#l159">159</a><td><tr><td><a name="l160" href="#l160">160</a><td>  var self = this;<tr><td><a name="l161" href="#l161">161</a><td>  this.address_ = promise.defer();<tr><td><a name="l162" href="#l162">162</a><td>  this.address_.fulfill(promise.when(this.port_, function(port) {<tr><td><a name="l163" href="#l163">163</a><td>    if (port &lt;= 0) {<tr><td><a name="l164" href="#l164">164</a><td>      throw Error(&#39;Port must be &gt; 0: &#39; + port);<tr><td><a name="l165" href="#l165">165</a><td>    }<tr><td><a name="l166" href="#l166">166</a><td>    return promise.when(self.args_, function(args) {<tr><td><a name="l167" href="#l167">167</a><td>      self.process_ = spawn(self.executable_, args, {<tr><td><a name="l168" href="#l168">168</a><td>        env: self.env_,<tr><td><a name="l169" href="#l169">169</a><td>        stdio: self.stdio_<tr><td><a name="l170" href="#l170">170</a><td>      }).once(&#39;exit&#39;, onServerExit);<tr><td><a name="l171" href="#l171">171</a><td><tr><td><a name="l172" href="#l172">172</a><td>      // This process should not wait on the spawned child, however, we do<tr><td><a name="l173" href="#l173">173</a><td>      // want to ensure the child is killed when this process exits.<tr><td><a name="l174" href="#l174">174</a><td>      self.process_.unref();<tr><td><a name="l175" href="#l175">175</a><td>      process.once(&#39;exit&#39;, killServer);<tr><td><a name="l176" href="#l176">176</a><td><tr><td><a name="l177" href="#l177">177</a><td>      var serverUrl = url.format({<tr><td><a name="l178" href="#l178">178</a><td>        protocol: &#39;http&#39;,<tr><td><a name="l179" href="#l179">179</a><td>        hostname: net.getAddress() || net.getLoopbackAddress(),<tr><td><a name="l180" href="#l180">180</a><td>        port: port,<tr><td><a name="l181" href="#l181">181</a><td>        pathname: self.path_<tr><td><a name="l182" href="#l182">182</a><td>      });<tr><td><a name="l183" href="#l183">183</a><td><tr><td><a name="l184" href="#l184">184</a><td>      return httpUtil.waitForServer(serverUrl, timeout).then(function() {<tr><td><a name="l185" href="#l185">185</a><td>        return serverUrl;<tr><td><a name="l186" href="#l186">186</a><td>      });<tr><td><a name="l187" href="#l187">187</a><td>    });<tr><td><a name="l188" href="#l188">188</a><td>  }));<tr><td><a name="l189" href="#l189">189</a><td><tr><td><a name="l190" href="#l190">190</a><td>  return this.address_;<tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td>  function onServerExit(code, signal) {<tr><td><a name="l193" href="#l193">193</a><td>    self.address_.reject(code == null ?<tr><td><a name="l194" href="#l194">194</a><td>        Error(&#39;Server was killed with &#39; + signal) :<tr><td><a name="l195" href="#l195">195</a><td>        Error(&#39;Server exited with &#39; + code));<tr><td><a name="l196" href="#l196">196</a><td><tr><td><a name="l197" href="#l197">197</a><td>    if (self.shutdownHook_) {<tr><td><a name="l198" href="#l198">198</a><td>      self.shutdownHook_.fulfill();<tr><td><a name="l199" href="#l199">199</a><td>    }<tr><td><a name="l200" href="#l200">200</a><td><tr><td><a name="l201" href="#l201">201</a><td>    self.shutdownHook_ = null;<tr><td><a name="l202" href="#l202">202</a><td>    self.address_ = null;<tr><td><a name="l203" href="#l203">203</a><td>    self.process_ = null;<tr><td><a name="l204" href="#l204">204</a><td>    process.removeListener(&#39;exit&#39;, killServer);<tr><td><a name="l205" href="#l205">205</a><td>  }<tr><td><a name="l206" href="#l206">206</a><td><tr><td><a name="l207" href="#l207">207</a><td>  function killServer() {<tr><td><a name="l208" href="#l208">208</a><td>    process.removeListener(&#39;exit&#39;, killServer);<tr><td><a name="l209" href="#l209">209</a><td>    self.process_ &amp;&amp; self.process_.kill(&#39;SIGTERM&#39;);<tr><td><a name="l210" href="#l210">210</a><td>  }<tr><td><a name="l211" href="#l211">211</a><td>};<tr><td><a name="l212" href="#l212">212</a><td><tr><td><a name="l213" href="#l213">213</a><td><tr><td><a name="l214" href="#l214">214</a><td>/**<tr><td><a name="l215" href="#l215">215</a><td> * Stops the service if it is not currently running. This function will kill<tr><td><a name="l216" href="#l216">216</a><td> * the server immediately. To synchronize with the active control flow, use<tr><td><a name="l217" href="#l217">217</a><td> * {@link #stop()}.<tr><td><a name="l218" href="#l218">218</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l219" href="#l219">219</a><td> *     the server has been stopped.<tr><td><a name="l220" href="#l220">220</a><td> */<tr><td><a name="l221" href="#l221">221</a><td>DriverService.prototype.kill = function() {<tr><td><a name="l222" href="#l222">222</a><td>  if (!this.address_) {<tr><td><a name="l223" href="#l223">223</a><td>    return promise.fulfilled();  // Not currently running.<tr><td><a name="l224" href="#l224">224</a><td>  }<tr><td><a name="l225" href="#l225">225</a><td><tr><td><a name="l226" href="#l226">226</a><td>  if (!this.shutdownHook_) {<tr><td><a name="l227" href="#l227">227</a><td>    // No process: still starting; wait on address.<tr><td><a name="l228" href="#l228">228</a><td>    // Otherwise, kill the process now. Exit handler will resolve the<tr><td><a name="l229" href="#l229">229</a><td>    // shutdown hook.<tr><td><a name="l230" href="#l230">230</a><td>    if (this.process_) {<tr><td><a name="l231" href="#l231">231</a><td>      this.shutdownHook_ = promise.defer();<tr><td><a name="l232" href="#l232">232</a><td>      this.process_.kill(&#39;SIGTERM&#39;);<tr><td><a name="l233" href="#l233">233</a><td>    } else {<tr><td><a name="l234" href="#l234">234</a><td>      var self = this;<tr><td><a name="l235" href="#l235">235</a><td>      this.shutdownHook_ = this.address_.thenFinally(function() {<tr><td><a name="l236" href="#l236">236</a><td>        self.process_ &amp;&amp; self.process_.kill(&#39;SIGTERM&#39;);<tr><td><a name="l237" href="#l237">237</a><td>      });<tr><td><a name="l238" href="#l238">238</a><td>    }<tr><td><a name="l239" href="#l239">239</a><td>  }<tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td>  return this.shutdownHook_;<tr><td><a name="l242" href="#l242">242</a><td>};<tr><td><a name="l243" href="#l243">243</a><td><tr><td><a name="l244" href="#l244">244</a><td><tr><td><a name="l245" href="#l245">245</a><td>/**<tr><td><a name="l246" href="#l246">246</a><td> * Schedules a task in the current control flow to stop the server if it is<tr><td><a name="l247" href="#l247">247</a><td> * currently running.<tr><td><a name="l248" href="#l248">248</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a name="l249" href="#l249">249</a><td> *     the server has been stopped.<tr><td><a name="l250" href="#l250">250</a><td> */<tr><td><a name="l251" href="#l251">251</a><td>DriverService.prototype.stop = function() {<tr><td><a name="l252" href="#l252">252</a><td>  return promise.controlFlow().execute(this.kill.bind(this));<tr><td><a name="l253" href="#l253">253</a><td>};<tr><td><a name="l254" href="#l254">254</a><td><tr><td><a name="l255" href="#l255">255</a><td><tr><td><a name="l256" href="#l256">256</a><td><tr><td><a name="l257" href="#l257">257</a><td>/**<tr><td><a name="l258" href="#l258">258</a><td> * Manages the life and death of the Selenium standalone server. The server<tr><td><a name="l259" href="#l259">259</a><td> * may be obtained from http://selenium-release.storage.googleapis.com/index.html.<tr><td><a name="l260" href="#l260">260</a><td> * @param {string} jar Path to the Selenium server jar.<tr><td><a name="l261" href="#l261">261</a><td> * @param {!SeleniumServer.Options} options Configuration options for the<tr><td><a name="l262" href="#l262">262</a><td> *     server.<tr><td><a name="l263" href="#l263">263</a><td> * @throws {Error} If an invalid port is specified.<tr><td><a name="l264" href="#l264">264</a><td> * @constructor<tr><td><a name="l265" href="#l265">265</a><td> * @extends {DriverService}<tr><td><a name="l266" href="#l266">266</a><td> */<tr><td><a name="l267" href="#l267">267</a><td>function SeleniumServer(jar, options) {<tr><td><a name="l268" href="#l268">268</a><td>  if (options.port &lt; 0)<tr><td><a name="l269" href="#l269">269</a><td>    throw Error(&#39;Port must be &gt;= 0: &#39; + options.port);<tr><td><a name="l270" href="#l270">270</a><td><tr><td><a name="l271" href="#l271">271</a><td>  var port = options.port || portprober.findFreePort();<tr><td><a name="l272" href="#l272">272</a><td>  var args = promise.when(options.jvmArgs || [], function(jvmArgs) {<tr><td><a name="l273" href="#l273">273</a><td>    return promise.when(options.args || [], function(args) {<tr><td><a name="l274" href="#l274">274</a><td>      return promise.when(port, function(port) {<tr><td><a name="l275" href="#l275">275</a><td>        return jvmArgs.concat([&#39;-jar&#39;, jar, &#39;-port&#39;, port]).concat(args);<tr><td><a name="l276" href="#l276">276</a><td>      });<tr><td><a name="l277" href="#l277">277</a><td>    });<tr><td><a name="l278" href="#l278">278</a><td>  });<tr><td><a name="l279" href="#l279">279</a><td><tr><td><a name="l280" href="#l280">280</a><td>  DriverService.call(this, &#39;java&#39;, {<tr><td><a name="l281" href="#l281">281</a><td>    port: port,<tr><td><a name="l282" href="#l282">282</a><td>    args: args,<tr><td><a name="l283" href="#l283">283</a><td>    path: &#39;/wd/hub&#39;,<tr><td><a name="l284" href="#l284">284</a><td>    env: options.env,<tr><td><a name="l285" href="#l285">285</a><td>    stdio: options.stdio<tr><td><a name="l286" href="#l286">286</a><td>  });<tr><td><a name="l287" href="#l287">287</a><td>}<tr><td><a name="l288" href="#l288">288</a><td>util.inherits(SeleniumServer, DriverService);<tr><td><a name="l289" href="#l289">289</a><td><tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td>/**<tr><td><a name="l292" href="#l292">292</a><td> * Options for the Selenium server:<tr><td><a name="l293" href="#l293">293</a><td> * &lt;ul&gt;<tr><td><a name="l294" href="#l294">294</a><td> * &lt;li&gt;{@code port} - The port to start the server on (must be &gt; 0). If the<tr><td><a name="l295" href="#l295">295</a><td> *     port is provided as a promise, the service will wait for the promise to<tr><td><a name="l296" href="#l296">296</a><td> *     resolve before starting.<tr><td><a name="l297" href="#l297">297</a><td> * &lt;li&gt;{@code args} - The arguments to pass to the service. If a promise is<tr><td><a name="l298" href="#l298">298</a><td> *     provided, the service will wait for it to resolve before starting.<tr><td><a name="l299" href="#l299">299</a><td> * &lt;li&gt;{@code jvmArgs} - The arguments to pass to the JVM. If a promise is<tr><td><a name="l300" href="#l300">300</a><td> *     provided, the service will wait for it to resolve before starting.<tr><td><a name="l301" href="#l301">301</a><td> * &lt;li&gt;{@code env} - The environment variables that should be visible to the<tr><td><a name="l302" href="#l302">302</a><td> *     server process. Defaults to inheriting the current process&#39;s<tr><td><a name="l303" href="#l303">303</a><td> *     environment.<tr><td><a name="l304" href="#l304">304</a><td> * &lt;li&gt;{@code stdio} - IO configuration for the spawned server process. For<tr><td><a name="l305" href="#l305">305</a><td> *     more information, refer to the documentation of<tr><td><a name="l306" href="#l306">306</a><td> *     {@code child_process.spawn}.<tr><td><a name="l307" href="#l307">307</a><td> * &lt;/ul&gt;<tr><td><a name="l308" href="#l308">308</a><td> *<tr><td><a name="l309" href="#l309">309</a><td> * @typedef {{<tr><td><a name="l310" href="#l310">310</a><td> *   port: (number|!webdriver.promise.Promise.&lt;number&gt;),<tr><td><a name="l311" href="#l311">311</a><td> *   args: !(Array.&lt;string&gt;|webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;),<tr><td><a name="l312" href="#l312">312</a><td> *   jvmArgs: (!Array.&lt;string&gt;|<tr><td><a name="l313" href="#l313">313</a><td> *             !webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;|<tr><td><a name="l314" href="#l314">314</a><td> *             undefined),<tr><td><a name="l315" href="#l315">315</a><td> *   env: (!Object.&lt;string, string&gt;|undefined),<tr><td><a name="l316" href="#l316">316</a><td> *   stdio: (string|!Array.&lt;string|number|!Stream|null|undefined&gt;|undefined)<tr><td><a name="l317" href="#l317">317</a><td> * }}<tr><td><a name="l318" href="#l318">318</a><td> */<tr><td><a name="l319" href="#l319">319</a><td>SeleniumServer.Options;<tr><td><a name="l320" href="#l320">320</a><td><tr><td><a name="l321" href="#l321">321</a><td><tr><td><a name="l322" href="#l322">322</a><td>// PUBLIC API<tr><td><a name="l323" href="#l323">323</a><td><tr><td><a name="l324" href="#l324">324</a><td>exports.DriverService = DriverService;<tr><td><a name="l325" href="#l325">325</a><td>exports.SeleniumServer = SeleniumServer;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../types.js"></script><script src="../../dossier.js"></script>
\ No newline at end of file
+<!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>index.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>remote/index.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>&#39;use strict&#39;;<tr><td><a id="l19"></a><a href="#l19">19</a><td><tr><td><a id="l20"></a><a href="#l20">20</a><td>var AdmZip = require(&#39;adm-zip&#39;),<tr><td><a id="l21"></a><a href="#l21">21</a><td>    AdmConstants = require(&#39;adm-zip/util/constants&#39;),<tr><td><a id="l22"></a><a href="#l22">22</a><td>    fs = require(&#39;fs&#39;),<tr><td><a id="l23"></a><a href="#l23">23</a><td>    path = require(&#39;path&#39;),<tr><td><a id="l24"></a><a href="#l24">24</a><td>    url = require(&#39;url&#39;),<tr><td><a id="l25"></a><a href="#l25">25</a><td>    util = require(&#39;util&#39;);<tr><td><a id="l26"></a><a href="#l26">26</a><td><tr><td><a id="l27"></a><a href="#l27">27</a><td>var _base = require(&#39;../_base&#39;),<tr><td><a id="l28"></a><a href="#l28">28</a><td>    webdriver = require(&#39;../&#39;),<tr><td><a id="l29"></a><a href="#l29">29</a><td>    promise = require(&#39;../&#39;).promise,<tr><td><a id="l30"></a><a href="#l30">30</a><td>    httpUtil = require(&#39;../http/util&#39;),<tr><td><a id="l31"></a><a href="#l31">31</a><td>    exec = require(&#39;../io/exec&#39;),<tr><td><a id="l32"></a><a href="#l32">32</a><td>    net = require(&#39;../net&#39;),<tr><td><a id="l33"></a><a href="#l33">33</a><td>    portprober = require(&#39;../net/portprober&#39;);<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>/**<tr><td><a id="l38"></a><a href="#l38">38</a><td> * Configuration options for a DriverService instance.<tr><td><a id="l39"></a><a href="#l39">39</a><td> *<tr><td><a id="l40"></a><a href="#l40">40</a><td> * - `loopback` - Whether the service should only be accessed on this host&#39;s<tr><td><a id="l41"></a><a href="#l41">41</a><td> *     loopback address.<tr><td><a id="l42"></a><a href="#l42">42</a><td> * - `port` - The port to start the server on (must be &gt; 0). If the port is<tr><td><a id="l43"></a><a href="#l43">43</a><td> *     provided as a promise, the service will wait for the promise to resolve<tr><td><a id="l44"></a><a href="#l44">44</a><td> *     before starting.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * - `args` - The arguments to pass to the service. If a promise is provided,<tr><td><a id="l46"></a><a href="#l46">46</a><td> *     the service will wait for it to resolve before starting.<tr><td><a id="l47"></a><a href="#l47">47</a><td> * - `path` - The base path on the server for the WebDriver wire protocol<tr><td><a id="l48"></a><a href="#l48">48</a><td> *     (e.g. &#39;/wd/hub&#39;). Defaults to &#39;/&#39;.<tr><td><a id="l49"></a><a href="#l49">49</a><td> * - `env` - The environment variables that should be visible to the server<tr><td><a id="l50"></a><a href="#l50">50</a><td> *     process. Defaults to inheriting the current process&#39;s environment.<tr><td><a id="l51"></a><a href="#l51">51</a><td> * - `stdio` - IO configuration for the spawned server process. For more<tr><td><a id="l52"></a><a href="#l52">52</a><td> *     information, refer to the documentation of `child_process.spawn`.<tr><td><a id="l53"></a><a href="#l53">53</a><td> *<tr><td><a id="l54"></a><a href="#l54">54</a><td> * @typedef {{<tr><td><a id="l55"></a><a href="#l55">55</a><td> *   loopback: (boolean|undefined),<tr><td><a id="l56"></a><a href="#l56">56</a><td> *   port: (number|!webdriver.promise.Promise.&lt;number&gt;),<tr><td><a id="l57"></a><a href="#l57">57</a><td> *   args: !(Array.&lt;string&gt;|webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;),<tr><td><a id="l58"></a><a href="#l58">58</a><td> *   path: (string|undefined),<tr><td><a id="l59"></a><a href="#l59">59</a><td> *   env: (!Object.&lt;string, string&gt;|undefined),<tr><td><a id="l60"></a><a href="#l60">60</a><td> *   stdio: (string|!Array.&lt;string|number|!Stream|null|undefined&gt;|undefined)<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>var ServiceOptions;<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> * Manages the life and death of a native executable WebDriver server.<tr><td><a id="l68"></a><a href="#l68">68</a><td> *<tr><td><a id="l69"></a><a href="#l69">69</a><td> * It is expected that the driver server implements the<tr><td><a id="l70"></a><a href="#l70">70</a><td> * https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol.<tr><td><a id="l71"></a><a href="#l71">71</a><td> * Furthermore, the managed server should support multiple concurrent sessions,<tr><td><a id="l72"></a><a href="#l72">72</a><td> * so that this class may be reused for multiple clients.<tr><td><a id="l73"></a><a href="#l73">73</a><td> *<tr><td><a id="l74"></a><a href="#l74">74</a><td> * @param {string} executable Path to the executable to run.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {!ServiceOptions} options Configuration options for the service.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @constructor<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>function DriverService(executable, options) {<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td>  /** @private {string} */<tr><td><a id="l81"></a><a href="#l81">81</a><td>  this.executable_ = executable;<tr><td><a id="l82"></a><a href="#l82">82</a><td><tr><td><a id="l83"></a><a href="#l83">83</a><td>  /** @private {boolean} */<tr><td><a id="l84"></a><a href="#l84">84</a><td>  this.loopbackOnly_ = !!options.loopback;<tr><td><a id="l85"></a><a href="#l85">85</a><td><tr><td><a id="l86"></a><a href="#l86">86</a><td>  /** @private {(number|!webdriver.promise.Promise.&lt;number&gt;)} */<tr><td><a id="l87"></a><a href="#l87">87</a><td>  this.port_ = options.port;<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>   * @private {!(Array.&lt;string&gt;|webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;)}<tr><td><a id="l91"></a><a href="#l91">91</a><td>   */<tr><td><a id="l92"></a><a href="#l92">92</a><td>  this.args_ = options.args;<tr><td><a id="l93"></a><a href="#l93">93</a><td><tr><td><a id="l94"></a><a href="#l94">94</a><td>  /** @private {string} */<tr><td><a id="l95"></a><a href="#l95">95</a><td>  this.path_ = options.path || &#39;/&#39;;<tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>  /** @private {!Object.&lt;string, string&gt;} */<tr><td><a id="l98"></a><a href="#l98">98</a><td>  this.env_ = options.env || process.env;<tr><td><a id="l99"></a><a href="#l99">99</a><td><tr><td><a id="l100"></a><a href="#l100">100</a><td>  /** @private {(string|!Array.&lt;string|number|!Stream|null|undefined&gt;)} */<tr><td><a id="l101"></a><a href="#l101">101</a><td>  this.stdio_ = options.stdio || &#39;ignore&#39;;<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>   * A promise for the managed subprocess, or null if the server has not been<tr><td><a id="l105"></a><a href="#l105">105</a><td>   * started yet. This promise will never be rejected.<tr><td><a id="l106"></a><a href="#l106">106</a><td>   * @private {promise.Promise.&lt;!exec.Command&gt;}<tr><td><a id="l107"></a><a href="#l107">107</a><td>   */<tr><td><a id="l108"></a><a href="#l108">108</a><td>  this.command_ = null;<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>   * Promise that resolves to the server&#39;s address or null if the server has<tr><td><a id="l112"></a><a href="#l112">112</a><td>   * not been started. This promise will be rejected if the server terminates<tr><td><a id="l113"></a><a href="#l113">113</a><td>   * before it starts accepting WebDriver requests.<tr><td><a id="l114"></a><a href="#l114">114</a><td>   * @private {promise.Promise.&lt;string&gt;}<tr><td><a id="l115"></a><a href="#l115">115</a><td>   */<tr><td><a id="l116"></a><a href="#l116">116</a><td>  this.address_ = null;<tr><td><a id="l117"></a><a href="#l117">117</a><td>}<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td><tr><td><a id="l120"></a><a href="#l120">120</a><td>/**<tr><td><a id="l121"></a><a href="#l121">121</a><td> * The default amount of time, in milliseconds, to wait for the server to<tr><td><a id="l122"></a><a href="#l122">122</a><td> * start.<tr><td><a id="l123"></a><a href="#l123">123</a><td> * @type {number}<tr><td><a id="l124"></a><a href="#l124">124</a><td> */<tr><td><a id="l125"></a><a href="#l125">125</a><td>DriverService.DEFAULT_START_TIMEOUT_MS = 30 * 1000;<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>/**<tr><td><a id="l129"></a><a href="#l129">129</a><td> * @return {!webdriver.promise.Promise.&lt;string&gt;} A promise that resolves to<tr><td><a id="l130"></a><a href="#l130">130</a><td> *    the server&#39;s address.<tr><td><a id="l131"></a><a href="#l131">131</a><td> * @throws {Error} If the server has not been started.<tr><td><a id="l132"></a><a href="#l132">132</a><td> */<tr><td><a id="l133"></a><a href="#l133">133</a><td>DriverService.prototype.address = function() {<tr><td><a id="l134"></a><a href="#l134">134</a><td>  if (this.address_) {<tr><td><a id="l135"></a><a href="#l135">135</a><td>    return this.address_;<tr><td><a id="l136"></a><a href="#l136">136</a><td>  }<tr><td><a id="l137"></a><a href="#l137">137</a><td>  throw Error(&#39;Server has not been started.&#39;);<tr><td><a id="l138"></a><a href="#l138">138</a><td>};<tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td>/**<tr><td><a id="l142"></a><a href="#l142">142</a><td> * Returns whether the underlying process is still running. This does not take<tr><td><a id="l143"></a><a href="#l143">143</a><td> * into account whether the process is in the process of shutting down.<tr><td><a id="l144"></a><a href="#l144">144</a><td> * @return {boolean} Whether the underlying service process is running.<tr><td><a id="l145"></a><a href="#l145">145</a><td> */<tr><td><a id="l146"></a><a href="#l146">146</a><td>DriverService.prototype.isRunning = function() {<tr><td><a id="l147"></a><a href="#l147">147</a><td>  return !!this.address_;<tr><td><a id="l148"></a><a href="#l148">148</a><td>};<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td><tr><td><a id="l151"></a><a href="#l151">151</a><td>/**<tr><td><a id="l152"></a><a href="#l152">152</a><td> * Starts the server if it is not already running.<tr><td><a id="l153"></a><a href="#l153">153</a><td> * @param {number=} opt_timeoutMs How long to wait, in milliseconds, for the<tr><td><a id="l154"></a><a href="#l154">154</a><td> *     server to start accepting requests. Defaults to 30 seconds.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @return {!promise.Promise.&lt;string&gt;} A promise that will resolve<tr><td><a id="l156"></a><a href="#l156">156</a><td> *     to the server&#39;s base URL when it has started accepting requests. If the<tr><td><a id="l157"></a><a href="#l157">157</a><td> *     timeout expires before the server has started, the promise will be<tr><td><a id="l158"></a><a href="#l158">158</a><td> *     rejected.<tr><td><a id="l159"></a><a href="#l159">159</a><td> */<tr><td><a id="l160"></a><a href="#l160">160</a><td>DriverService.prototype.start = function(opt_timeoutMs) {<tr><td><a id="l161"></a><a href="#l161">161</a><td>  if (this.address_) {<tr><td><a id="l162"></a><a href="#l162">162</a><td>    return this.address_;<tr><td><a id="l163"></a><a href="#l163">163</a><td>  }<tr><td><a id="l164"></a><a href="#l164">164</a><td><tr><td><a id="l165"></a><a href="#l165">165</a><td>  var timeout = opt_timeoutMs || DriverService.DEFAULT_START_TIMEOUT_MS;<tr><td><a id="l166"></a><a href="#l166">166</a><td><tr><td><a id="l167"></a><a href="#l167">167</a><td>  var self = this;<tr><td><a id="l168"></a><a href="#l168">168</a><td>  this.command_ = promise.defer();<tr><td><a id="l169"></a><a href="#l169">169</a><td>  this.address_ = promise.defer();<tr><td><a id="l170"></a><a href="#l170">170</a><td>  this.address_.fulfill(promise.when(this.port_, function(port) {<tr><td><a id="l171"></a><a href="#l171">171</a><td>    if (port &lt;= 0) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>      throw Error(&#39;Port must be &gt; 0: &#39; + port);<tr><td><a id="l173"></a><a href="#l173">173</a><td>    }<tr><td><a id="l174"></a><a href="#l174">174</a><td>    return promise.when(self.args_, function(args) {<tr><td><a id="l175"></a><a href="#l175">175</a><td>      var command = exec(self.executable_, {<tr><td><a id="l176"></a><a href="#l176">176</a><td>        args: args,<tr><td><a id="l177"></a><a href="#l177">177</a><td>        env: self.env_,<tr><td><a id="l178"></a><a href="#l178">178</a><td>        stdio: self.stdio_<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>      self.command_.fulfill(command);<tr><td><a id="l182"></a><a href="#l182">182</a><td><tr><td><a id="l183"></a><a href="#l183">183</a><td>      var earlyTermination = command.result().then(function(result) {<tr><td><a id="l184"></a><a href="#l184">184</a><td>        var error = result.code == null ?<tr><td><a id="l185"></a><a href="#l185">185</a><td>            Error(&#39;Server was killed with &#39; + result.signal) :<tr><td><a id="l186"></a><a href="#l186">186</a><td>            Error(&#39;Server terminated early with status &#39; + result.code);<tr><td><a id="l187"></a><a href="#l187">187</a><td>        self.address_.reject(error);<tr><td><a id="l188"></a><a href="#l188">188</a><td>        self.address_ = null;<tr><td><a id="l189"></a><a href="#l189">189</a><td>        self.command_ = null;<tr><td><a id="l190"></a><a href="#l190">190</a><td>        throw error;<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>      var serverUrl = url.format({<tr><td><a id="l194"></a><a href="#l194">194</a><td>        protocol: &#39;http&#39;,<tr><td><a id="l195"></a><a href="#l195">195</a><td>        hostname: !self.loopbackOnly_ &amp;&amp; net.getAddress() ||<tr><td><a id="l196"></a><a href="#l196">196</a><td>            net.getLoopbackAddress(),<tr><td><a id="l197"></a><a href="#l197">197</a><td>        port: port,<tr><td><a id="l198"></a><a href="#l198">198</a><td>        pathname: self.path_<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>      return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l202"></a><a href="#l202">202</a><td>        var ready = httpUtil.waitForServer(serverUrl, timeout)<tr><td><a id="l203"></a><a href="#l203">203</a><td>            .then(fulfill, reject);<tr><td><a id="l204"></a><a href="#l204">204</a><td>        earlyTermination.thenCatch(function(e) {<tr><td><a id="l205"></a><a href="#l205">205</a><td>          ready.cancel(e);<tr><td><a id="l206"></a><a href="#l206">206</a><td>          reject(Error(e.message));<tr><td><a id="l207"></a><a href="#l207">207</a><td>        });<tr><td><a id="l208"></a><a href="#l208">208</a><td>      }).then(function() {<tr><td><a id="l209"></a><a href="#l209">209</a><td>        return serverUrl;<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>  return this.address_;<tr><td><a id="l215"></a><a href="#l215">215</a><td>};<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> * Stops the service if it is not currently running. This function will kill<tr><td><a id="l220"></a><a href="#l220">220</a><td> * the server immediately. To synchronize with the active control flow, use<tr><td><a id="l221"></a><a href="#l221">221</a><td> * {@link #stop()}.<tr><td><a id="l222"></a><a href="#l222">222</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a id="l223"></a><a href="#l223">223</a><td> *     the server has been stopped.<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>DriverService.prototype.kill = function() {<tr><td><a id="l226"></a><a href="#l226">226</a><td>  if (!this.address_ || !this.command_) {<tr><td><a id="l227"></a><a href="#l227">227</a><td>    return promise.fulfilled();  // Not currently running.<tr><td><a id="l228"></a><a href="#l228">228</a><td>  }<tr><td><a id="l229"></a><a href="#l229">229</a><td>  return this.command_.then(function(command) {<tr><td><a id="l230"></a><a href="#l230">230</a><td>    command.kill(&#39;SIGTERM&#39;);<tr><td><a id="l231"></a><a href="#l231">231</a><td>  });<tr><td><a id="l232"></a><a href="#l232">232</a><td>};<tr><td><a id="l233"></a><a href="#l233">233</a><td><tr><td><a id="l234"></a><a href="#l234">234</a><td><tr><td><a id="l235"></a><a href="#l235">235</a><td>/**<tr><td><a id="l236"></a><a href="#l236">236</a><td> * Schedules a task in the current control flow to stop the server if it is<tr><td><a id="l237"></a><a href="#l237">237</a><td> * currently running.<tr><td><a id="l238"></a><a href="#l238">238</a><td> * @return {!webdriver.promise.Promise} A promise that will be resolved when<tr><td><a id="l239"></a><a href="#l239">239</a><td> *     the server has been stopped.<tr><td><a id="l240"></a><a href="#l240">240</a><td> */<tr><td><a id="l241"></a><a href="#l241">241</a><td>DriverService.prototype.stop = function() {<tr><td><a id="l242"></a><a href="#l242">242</a><td>  return promise.controlFlow().execute(this.kill.bind(this));<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><tr><td><a id="l246"></a><a href="#l246">246</a><td><tr><td><a id="l247"></a><a href="#l247">247</a><td>/**<tr><td><a id="l248"></a><a href="#l248">248</a><td> * Manages the life and death of the<tr><td><a id="l249"></a><a href="#l249">249</a><td> * &lt;a href=&quot;http://selenium-release.storage.googleapis.com/index.html&quot;&gt;<tr><td><a id="l250"></a><a href="#l250">250</a><td> * standalone Selenium server&lt;/a&gt;.<tr><td><a id="l251"></a><a href="#l251">251</a><td> *<tr><td><a id="l252"></a><a href="#l252">252</a><td> * @param {string} jar Path to the Selenium server jar.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @param {SeleniumServer.Options=} opt_options Configuration options for the<tr><td><a id="l254"></a><a href="#l254">254</a><td> *     server.<tr><td><a id="l255"></a><a href="#l255">255</a><td> * @throws {Error} If the path to the Selenium jar is not specified or if an<tr><td><a id="l256"></a><a href="#l256">256</a><td> *     invalid port is specified.<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @constructor<tr><td><a id="l258"></a><a href="#l258">258</a><td> * @extends {DriverService}<tr><td><a id="l259"></a><a href="#l259">259</a><td> */<tr><td><a id="l260"></a><a href="#l260">260</a><td>function SeleniumServer(jar, opt_options) {<tr><td><a id="l261"></a><a href="#l261">261</a><td>  if (!jar) {<tr><td><a id="l262"></a><a href="#l262">262</a><td>    throw Error(&#39;Path to the Selenium jar not specified&#39;);<tr><td><a id="l263"></a><a href="#l263">263</a><td>  }<tr><td><a id="l264"></a><a href="#l264">264</a><td><tr><td><a id="l265"></a><a href="#l265">265</a><td>  var options = opt_options || {};<tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>  if (options.port &lt; 0) {<tr><td><a id="l268"></a><a href="#l268">268</a><td>    throw Error(&#39;Port must be &gt;= 0: &#39; + options.port);<tr><td><a id="l269"></a><a href="#l269">269</a><td>  }<tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>  var port = options.port || portprober.findFreePort();<tr><td><a id="l272"></a><a href="#l272">272</a><td>  var args = promise.when(options.jvmArgs || [], function(jvmArgs) {<tr><td><a id="l273"></a><a href="#l273">273</a><td>    return promise.when(options.args || [], function(args) {<tr><td><a id="l274"></a><a href="#l274">274</a><td>      return promise.when(port, function(port) {<tr><td><a id="l275"></a><a href="#l275">275</a><td>        return jvmArgs.concat([&#39;-jar&#39;, jar, &#39;-port&#39;, port]).concat(args);<tr><td><a id="l276"></a><a href="#l276">276</a><td>      });<tr><td><a id="l277"></a><a href="#l277">277</a><td>    });<tr><td><a id="l278"></a><a href="#l278">278</a><td>  });<tr><td><a id="l279"></a><a href="#l279">279</a><td><tr><td><a id="l280"></a><a href="#l280">280</a><td>  DriverService.call(this, &#39;java&#39;, {<tr><td><a id="l281"></a><a href="#l281">281</a><td>    loopback: options.loopback,<tr><td><a id="l282"></a><a href="#l282">282</a><td>    port: port,<tr><td><a id="l283"></a><a href="#l283">283</a><td>    args: args,<tr><td><a id="l284"></a><a href="#l284">284</a><td>    path: &#39;/wd/hub&#39;,<tr><td><a id="l285"></a><a href="#l285">285</a><td>    env: options.env,<tr><td><a id="l286"></a><a href="#l286">286</a><td>    stdio: options.stdio<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>util.inherits(SeleniumServer, DriverService);<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> * Options for the Selenium server:<tr><td><a id="l294"></a><a href="#l294">294</a><td> *<tr><td><a id="l295"></a><a href="#l295">295</a><td> * - `loopback` - Whether the server should only be accessed on this host&#39;s<tr><td><a id="l296"></a><a href="#l296">296</a><td> *     loopback address.<tr><td><a id="l297"></a><a href="#l297">297</a><td> * - `port` - The port to start the server on (must be &gt; 0). If the port is<tr><td><a id="l298"></a><a href="#l298">298</a><td> *     provided as a promise, the service will wait for the promise to resolve<tr><td><a id="l299"></a><a href="#l299">299</a><td> *     before starting.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * - `args` - The arguments to pass to the service. If a promise is provided,<tr><td><a id="l301"></a><a href="#l301">301</a><td> *     the service will wait for it to resolve before starting.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * - `jvmArgs` - The arguments to pass to the JVM. If a promise is provided,<tr><td><a id="l303"></a><a href="#l303">303</a><td> *     the service will wait for it to resolve before starting.<tr><td><a id="l304"></a><a href="#l304">304</a><td> * - `env` - The environment variables that should be visible to the server<tr><td><a id="l305"></a><a href="#l305">305</a><td> *     process. Defaults to inheriting the current process&#39;s environment.<tr><td><a id="l306"></a><a href="#l306">306</a><td> * - `stdio` - IO configuration for the spawned server process. For more<tr><td><a id="l307"></a><a href="#l307">307</a><td> *     information, refer to the documentation of `child_process.spawn`.<tr><td><a id="l308"></a><a href="#l308">308</a><td> *<tr><td><a id="l309"></a><a href="#l309">309</a><td> * @typedef {{<tr><td><a id="l310"></a><a href="#l310">310</a><td> *   loopback: (boolean|undefined),<tr><td><a id="l311"></a><a href="#l311">311</a><td> *   port: (number|!webdriver.promise.Promise.&lt;number&gt;),<tr><td><a id="l312"></a><a href="#l312">312</a><td> *   args: !(Array.&lt;string&gt;|webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;),<tr><td><a id="l313"></a><a href="#l313">313</a><td> *   jvmArgs: (!Array.&lt;string&gt;|<tr><td><a id="l314"></a><a href="#l314">314</a><td> *             !webdriver.promise.Promise.&lt;!Array.&lt;string&gt;&gt;|<tr><td><a id="l315"></a><a href="#l315">315</a><td> *             undefined),<tr><td><a id="l316"></a><a href="#l316">316</a><td> *   env: (!Object.&lt;string, string&gt;|undefined),<tr><td><a id="l317"></a><a href="#l317">317</a><td> *   stdio: (string|!Array.&lt;string|number|!Stream|null|undefined&gt;|undefined)<tr><td><a id="l318"></a><a href="#l318">318</a><td> * }}<tr><td><a id="l319"></a><a href="#l319">319</a><td> */<tr><td><a id="l320"></a><a href="#l320">320</a><td>SeleniumServer.Options;<tr><td><a id="l321"></a><a href="#l321">321</a><td><tr><td><a id="l322"></a><a href="#l322">322</a><td><tr><td><a id="l323"></a><a href="#l323">323</a><td><tr><td><a id="l324"></a><a href="#l324">324</a><td>/**<tr><td><a id="l325"></a><a href="#l325">325</a><td> * A {@link webdriver.FileDetector} that may be used when running<tr><td><a id="l326"></a><a href="#l326">326</a><td> * against a remote<tr><td><a id="l327"></a><a href="#l327">327</a><td> * [Selenium server](http://selenium-release.storage.googleapis.com/index.html).<tr><td><a id="l328"></a><a href="#l328">328</a><td> *<tr><td><a id="l329"></a><a href="#l329">329</a><td> * When a file path on the local machine running this script is entered with<tr><td><a id="l330"></a><a href="#l330">330</a><td> * {@link webdriver.WebElement#sendKeys WebElement#sendKeys}, this file detector<tr><td><a id="l331"></a><a href="#l331">331</a><td> * will transfer the specified file to the Selenium server&#39;s host; the sendKeys<tr><td><a id="l332"></a><a href="#l332">332</a><td> * command will be updated to use the transfered file&#39;s path.<tr><td><a id="l333"></a><a href="#l333">333</a><td> *<tr><td><a id="l334"></a><a href="#l334">334</a><td> * __Note:__ This class depends on a non-standard command supported on the<tr><td><a id="l335"></a><a href="#l335">335</a><td> * Java Selenium server. The file detector will fail if used with a server that<tr><td><a id="l336"></a><a href="#l336">336</a><td> * only supports standard WebDriver commands (such as the ChromeDriver).<tr><td><a id="l337"></a><a href="#l337">337</a><td> *<tr><td><a id="l338"></a><a href="#l338">338</a><td> * @constructor<tr><td><a id="l339"></a><a href="#l339">339</a><td> * @extends {webdriver.FileDetector}<tr><td><a id="l340"></a><a href="#l340">340</a><td> * @final<tr><td><a id="l341"></a><a href="#l341">341</a><td> */<tr><td><a id="l342"></a><a href="#l342">342</a><td>var FileDetector = function() {};<tr><td><a id="l343"></a><a href="#l343">343</a><td>util.inherits(webdriver.FileDetector, FileDetector);<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>/** @override */<tr><td><a id="l347"></a><a href="#l347">347</a><td>FileDetector.prototype.handleFile = function(driver, filePath) {<tr><td><a id="l348"></a><a href="#l348">348</a><td>  return promise.checkedNodeCall(fs.stat, filePath).then(function(stats) {<tr><td><a id="l349"></a><a href="#l349">349</a><td>    if (stats.isDirectory()) {<tr><td><a id="l350"></a><a href="#l350">350</a><td>      throw TypeError(&#39;Uploading directories is not supported: &#39; + filePath);<tr><td><a id="l351"></a><a href="#l351">351</a><td>    }<tr><td><a id="l352"></a><a href="#l352">352</a><td><tr><td><a id="l353"></a><a href="#l353">353</a><td>    var zip = new AdmZip();<tr><td><a id="l354"></a><a href="#l354">354</a><td>    zip.addLocalFile(filePath);<tr><td><a id="l355"></a><a href="#l355">355</a><td>    zip.getEntries()[0].header.method = AdmConstants.STORED;<tr><td><a id="l356"></a><a href="#l356">356</a><td><tr><td><a id="l357"></a><a href="#l357">357</a><td>    var command = new webdriver.Command(webdriver.CommandName.UPLOAD_FILE)<tr><td><a id="l358"></a><a href="#l358">358</a><td>        .setParameter(&#39;file&#39;, zip.toBuffer().toString(&#39;base64&#39;));<tr><td><a id="l359"></a><a href="#l359">359</a><td>    return driver.schedule(command,<tr><td><a id="l360"></a><a href="#l360">360</a><td>        &#39;remote.FileDetector.handleFile(&#39; + filePath + &#39;)&#39;);<tr><td><a id="l361"></a><a href="#l361">361</a><td>  }, function(err) {<tr><td><a id="l362"></a><a href="#l362">362</a><td>    if (err.code === &#39;ENOENT&#39;) {<tr><td><a id="l363"></a><a href="#l363">363</a><td>      return filePath;  // Not a file; return original input.<tr><td><a id="l364"></a><a href="#l364">364</a><td>    }<tr><td><a id="l365"></a><a href="#l365">365</a><td>    throw err;<tr><td><a id="l366"></a><a href="#l366">366</a><td>  });<tr><td><a id="l367"></a><a href="#l367">367</a><td>};<tr><td><a id="l368"></a><a href="#l368">368</a><td><tr><td><a id="l369"></a><a href="#l369">369</a><td>// PUBLIC API<tr><td><a id="l370"></a><a href="#l370">370</a><td><tr><td><a id="l371"></a><a href="#l371">371</a><td>exports.DriverService = DriverService;<tr><td><a id="l372"></a><a href="#l372">372</a><td>exports.FileDetector = FileDetector;<tr><td><a id="l373"></a><a href="#l373">373</a><td>exports.SeleniumServer = SeleniumServer;</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>
\ No newline at end of file
diff --git a/docs/source/safari.js.src.html b/docs/source/safari.js.src.html
new file mode 100644
index 0000000..60698f3
--- /dev/null
+++ b/docs/source/safari.js.src.html
@@ -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>safari.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>safari.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines a WebDriver client for Safari. Before using this<tr><td><a id="l20"></a><a href="#l20">20</a><td> * module, you must install the<tr><td><a id="l21"></a><a href="#l21">21</a><td> * [latest version](http://selenium-release.storage.googleapis.com/index.html)<tr><td><a id="l22"></a><a href="#l22">22</a><td> * of the SafariDriver browser extension; using Safari for normal browsing is<tr><td><a id="l23"></a><a href="#l23">23</a><td> * not recommended once the extension has been installed. You can, and should,<tr><td><a id="l24"></a><a href="#l24">24</a><td> * disable the extension when the browser is not being used with WebDriver.<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>&#39;use strict&#39;;<tr><td><a id="l28"></a><a href="#l28">28</a><td><tr><td><a id="l29"></a><a href="#l29">29</a><td>var events = require(&#39;events&#39;);<tr><td><a id="l30"></a><a href="#l30">30</a><td>var fs = require(&#39;fs&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td>var http = require(&#39;http&#39;);<tr><td><a id="l32"></a><a href="#l32">32</a><td>var path = require(&#39;path&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td>var url = require(&#39;url&#39;);<tr><td><a id="l34"></a><a href="#l34">34</a><td>var util = require(&#39;util&#39;);<tr><td><a id="l35"></a><a href="#l35">35</a><td>var ws = require(&#39;ws&#39;);<tr><td><a id="l36"></a><a href="#l36">36</a><td><tr><td><a id="l37"></a><a href="#l37">37</a><td>var webdriver = require(&#39;./&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td>var promise = webdriver.promise;<tr><td><a id="l39"></a><a href="#l39">39</a><td>var _base = require(&#39;./_base&#39;);<tr><td><a id="l40"></a><a href="#l40">40</a><td>var io = require(&#39;./io&#39;);<tr><td><a id="l41"></a><a href="#l41">41</a><td>var exec = require(&#39;./io/exec&#39;);<tr><td><a id="l42"></a><a href="#l42">42</a><td>var portprober = require(&#39;./net/portprober&#39;);<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>/** @const */<tr><td><a id="l46"></a><a href="#l46">46</a><td>var CLIENT_PATH = _base.isDevMode()<tr><td><a id="l47"></a><a href="#l47">47</a><td>    ? path.join(__dirname,<tr><td><a id="l48"></a><a href="#l48">48</a><td>        &#39;../../../build/javascript/safari-driver/client.js&#39;)<tr><td><a id="l49"></a><a href="#l49">49</a><td>    : path.join(__dirname, &#39;lib/safari/client.js&#39;);<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>var LIBRARY_DIR = process.platform === &#39;darwin&#39;<tr><td><a id="l54"></a><a href="#l54">54</a><td>    ? path.join(&#39;/Users&#39;, process.env[&#39;USER&#39;], &#39;Library/Safari&#39;)<tr><td><a id="l55"></a><a href="#l55">55</a><td>    : path.join(process.env[&#39;APPDATA&#39;], &#39;Apple Computer&#39;, &#39;Safari&#39;);<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>/** @const */<tr><td><a id="l59"></a><a href="#l59">59</a><td>var SESSION_DATA_FILES = (function() {<tr><td><a id="l60"></a><a href="#l60">60</a><td>  if (process.platform === &#39;darwin&#39;) {<tr><td><a id="l61"></a><a href="#l61">61</a><td>    var libraryDir = path.join(&#39;/Users&#39;, process.env[&#39;USER&#39;], &#39;Library&#39;);<tr><td><a id="l62"></a><a href="#l62">62</a><td>    return [<tr><td><a id="l63"></a><a href="#l63">63</a><td>      path.join(libraryDir, &#39;Caches/com.apple.Safari/Cache.db&#39;),<tr><td><a id="l64"></a><a href="#l64">64</a><td>      path.join(libraryDir, &#39;Cookies/Cookies.binarycookies&#39;),<tr><td><a id="l65"></a><a href="#l65">65</a><td>      path.join(libraryDir, &#39;Cookies/Cookies.plist&#39;),<tr><td><a id="l66"></a><a href="#l66">66</a><td>      path.join(libraryDir, &#39;Safari/History.plist&#39;),<tr><td><a id="l67"></a><a href="#l67">67</a><td>      path.join(libraryDir, &#39;Safari/LastSession.plist&#39;),<tr><td><a id="l68"></a><a href="#l68">68</a><td>      path.join(libraryDir, &#39;Safari/LocalStorage&#39;),<tr><td><a id="l69"></a><a href="#l69">69</a><td>      path.join(libraryDir, &#39;Safari/Databases&#39;)<tr><td><a id="l70"></a><a href="#l70">70</a><td>    ];<tr><td><a id="l71"></a><a href="#l71">71</a><td>  } else if (process.platform === &#39;win32&#39;) {<tr><td><a id="l72"></a><a href="#l72">72</a><td>    var appDataDir = path.join(process.env[&#39;APPDATA&#39;],<tr><td><a id="l73"></a><a href="#l73">73</a><td>        &#39;Apple Computer&#39;, &#39;Safari&#39;);<tr><td><a id="l74"></a><a href="#l74">74</a><td>    var localDataDir = path.join(process.env[&#39;LOCALAPPDATA&#39;],<tr><td><a id="l75"></a><a href="#l75">75</a><td>        &#39;Apple Computer&#39;, &#39;Safari&#39;);<tr><td><a id="l76"></a><a href="#l76">76</a><td>    return [<tr><td><a id="l77"></a><a href="#l77">77</a><td>      path.join(appDataDir, &#39;History.plist&#39;),<tr><td><a id="l78"></a><a href="#l78">78</a><td>      path.join(appDataDir, &#39;LastSession.plist&#39;),<tr><td><a id="l79"></a><a href="#l79">79</a><td>      path.join(appDataDir, &#39;Cookies/Cookies.plist&#39;),<tr><td><a id="l80"></a><a href="#l80">80</a><td>      path.join(appDataDir, &#39;Cookies/Cookies.binarycookies&#39;),<tr><td><a id="l81"></a><a href="#l81">81</a><td>      path.join(localDataDir, &#39;Cache.db&#39;),<tr><td><a id="l82"></a><a href="#l82">82</a><td>      path.join(localDataDir, &#39;Databases&#39;),<tr><td><a id="l83"></a><a href="#l83">83</a><td>      path.join(localDataDir, &#39;LocalStorage&#39;)<tr><td><a id="l84"></a><a href="#l84">84</a><td>    ];<tr><td><a id="l85"></a><a href="#l85">85</a><td>  } else {<tr><td><a id="l86"></a><a href="#l86">86</a><td>    return [];<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>/** @typedef {{port: number, address: string, family: string}} */<tr><td><a id="l92"></a><a href="#l92">92</a><td>var Host;<tr><td><a id="l93"></a><a href="#l93">93</a><td><tr><td><a id="l94"></a><a href="#l94">94</a><td><tr><td><a id="l95"></a><a href="#l95">95</a><td>/**<tr><td><a id="l96"></a><a href="#l96">96</a><td> * A basic HTTP/WebSocket server used to communicate with the SafariDriver<tr><td><a id="l97"></a><a href="#l97">97</a><td> * browser extension.<tr><td><a id="l98"></a><a href="#l98">98</a><td> * @constructor<tr><td><a id="l99"></a><a href="#l99">99</a><td> * @extends {events.EventEmitter}<tr><td><a id="l100"></a><a href="#l100">100</a><td> */<tr><td><a id="l101"></a><a href="#l101">101</a><td>var Server = function() {<tr><td><a id="l102"></a><a href="#l102">102</a><td>  events.EventEmitter.call(this);<tr><td><a id="l103"></a><a href="#l103">103</a><td><tr><td><a id="l104"></a><a href="#l104">104</a><td>  var server = http.createServer(function(req, res) {<tr><td><a id="l105"></a><a href="#l105">105</a><td>    if (req.url === &#39;/favicon.ico&#39;) {<tr><td><a id="l106"></a><a href="#l106">106</a><td>      res.writeHead(204);<tr><td><a id="l107"></a><a href="#l107">107</a><td>      res.end();<tr><td><a id="l108"></a><a href="#l108">108</a><td>      return;<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>    var query = url.parse(req.url).query || &#39;&#39;;<tr><td><a id="l112"></a><a href="#l112">112</a><td>    if (query.indexOf(&#39;url=&#39;) == -1) {<tr><td><a id="l113"></a><a href="#l113">113</a><td>      var address = server.address()<tr><td><a id="l114"></a><a href="#l114">114</a><td>      var host = address.address + &#39;:&#39; + address.port;<tr><td><a id="l115"></a><a href="#l115">115</a><td>      res.writeHead(302, {&#39;Location&#39;: &#39;http://&#39; + host + &#39;?url=ws://&#39; + host});<tr><td><a id="l116"></a><a href="#l116">116</a><td>      res.end();<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>    fs.readFile(CLIENT_PATH, &#39;utf8&#39;, function(err, data) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>      if (err) {<tr><td><a id="l121"></a><a href="#l121">121</a><td>        res.writeHead(500, {&#39;Content-Type&#39;: &#39;text/plain&#39;});<tr><td><a id="l122"></a><a href="#l122">122</a><td>        res.end(err.stack);<tr><td><a id="l123"></a><a href="#l123">123</a><td>        return;<tr><td><a id="l124"></a><a href="#l124">124</a><td>      }<tr><td><a id="l125"></a><a href="#l125">125</a><td>      var content = &#39;&lt;!DOCTYPE html&gt;&lt;body&gt;&lt;script&gt;&#39; + data + &#39;&lt;/script&gt;&#39;;<tr><td><a id="l126"></a><a href="#l126">126</a><td>      res.writeHead(200, {<tr><td><a id="l127"></a><a href="#l127">127</a><td>        &#39;Content-Type&#39;: &#39;text/html; charset=utf-8&#39;,<tr><td><a id="l128"></a><a href="#l128">128</a><td>        &#39;Content-Length&#39;: Buffer.byteLength(content, &#39;utf8&#39;),<tr><td><a id="l129"></a><a href="#l129">129</a><td>      });<tr><td><a id="l130"></a><a href="#l130">130</a><td>      res.end(content);<tr><td><a id="l131"></a><a href="#l131">131</a><td>    });<tr><td><a id="l132"></a><a href="#l132">132</a><td>  });<tr><td><a id="l133"></a><a href="#l133">133</a><td><tr><td><a id="l134"></a><a href="#l134">134</a><td>  var wss = new ws.Server({server: server});<tr><td><a id="l135"></a><a href="#l135">135</a><td>  wss.on(&#39;connection&#39;, this.emit.bind(this, &#39;connection&#39;));<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>   * Starts the server on a random port.<tr><td><a id="l139"></a><a href="#l139">139</a><td>   * @return {!webdriver.promise.Promise&lt;Host&gt;} A promise that will resolve<tr><td><a id="l140"></a><a href="#l140">140</a><td>   *     with the server host when it has fully started.<tr><td><a id="l141"></a><a href="#l141">141</a><td>   */<tr><td><a id="l142"></a><a href="#l142">142</a><td>  this.start = function() {<tr><td><a id="l143"></a><a href="#l143">143</a><td>    if (server.address()) {<tr><td><a id="l144"></a><a href="#l144">144</a><td>      return promise.fulfilled(server.address());<tr><td><a id="l145"></a><a href="#l145">145</a><td>    }<tr><td><a id="l146"></a><a href="#l146">146</a><td>    return portprober.findFreePort(&#39;localhost&#39;).then(function(port) {<tr><td><a id="l147"></a><a href="#l147">147</a><td>      return promise.checkedNodeCall(<tr><td><a id="l148"></a><a href="#l148">148</a><td>          server.listen.bind(server, port, &#39;localhost&#39;));<tr><td><a id="l149"></a><a href="#l149">149</a><td>    }).then(function() {<tr><td><a id="l150"></a><a href="#l150">150</a><td>      return server.address();<tr><td><a id="l151"></a><a href="#l151">151</a><td>    });<tr><td><a id="l152"></a><a href="#l152">152</a><td>  };<tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td>  /**<tr><td><a id="l155"></a><a href="#l155">155</a><td>   * Stops the server.<tr><td><a id="l156"></a><a href="#l156">156</a><td>   * @return {!webdriver.promise.Promise} A promise that will resolve when the<tr><td><a id="l157"></a><a href="#l157">157</a><td>   *     server has closed all connections.<tr><td><a id="l158"></a><a href="#l158">158</a><td>   */<tr><td><a id="l159"></a><a href="#l159">159</a><td>  this.stop = function() {<tr><td><a id="l160"></a><a href="#l160">160</a><td>    return new promise.Promise(function(fulfill) {<tr><td><a id="l161"></a><a href="#l161">161</a><td>      server.close(fulfill);<tr><td><a id="l162"></a><a href="#l162">162</a><td>    });<tr><td><a id="l163"></a><a href="#l163">163</a><td>  };<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>   * @return {Host} This server&#39;s host info.<tr><td><a id="l167"></a><a href="#l167">167</a><td>   * @throws {Error} If the server is not running.<tr><td><a id="l168"></a><a href="#l168">168</a><td>   */<tr><td><a id="l169"></a><a href="#l169">169</a><td>  this.address = function() {<tr><td><a id="l170"></a><a href="#l170">170</a><td>    var addr = server.address();<tr><td><a id="l171"></a><a href="#l171">171</a><td>    if (!addr) {<tr><td><a id="l172"></a><a href="#l172">172</a><td>      throw Error(&#39;There server is not running!&#39;);<tr><td><a id="l173"></a><a href="#l173">173</a><td>    }<tr><td><a id="l174"></a><a href="#l174">174</a><td>    return addr;<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>util.inherits(Server, events.EventEmitter);<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> * @return {!promise.Promise&lt;string&gt;} A promise that will resolve with the path<tr><td><a id="l182"></a><a href="#l182">182</a><td> *     to Safari on the current system.<tr><td><a id="l183"></a><a href="#l183">183</a><td> */<tr><td><a id="l184"></a><a href="#l184">184</a><td>function findSafariExecutable() {<tr><td><a id="l185"></a><a href="#l185">185</a><td>  switch (process.platform) {<tr><td><a id="l186"></a><a href="#l186">186</a><td>    case &#39;darwin&#39;:<tr><td><a id="l187"></a><a href="#l187">187</a><td>      return promise.fulfilled(<tr><td><a id="l188"></a><a href="#l188">188</a><td>          &#39;/Applications/Safari.app/Contents/MacOS/Safari&#39;);<tr><td><a id="l189"></a><a href="#l189">189</a><td><tr><td><a id="l190"></a><a href="#l190">190</a><td>    case &#39;win32&#39;:<tr><td><a id="l191"></a><a href="#l191">191</a><td>      var files = [<tr><td><a id="l192"></a><a href="#l192">192</a><td>        process.env[&#39;PROGRAMFILES&#39;] || &#39;\\Program Files&#39;,<tr><td><a id="l193"></a><a href="#l193">193</a><td>        process.env[&#39;PROGRAMFILES(X86)&#39;] || &#39;\\Program Files (x86)&#39;<tr><td><a id="l194"></a><a href="#l194">194</a><td>      ].map(function(prefix) {<tr><td><a id="l195"></a><a href="#l195">195</a><td>        return path.join(prefix, &#39;Safari\\Safari.exe&#39;);<tr><td><a id="l196"></a><a href="#l196">196</a><td>      });<tr><td><a id="l197"></a><a href="#l197">197</a><td>      return io.exists(files[0]).then(function(exists) {<tr><td><a id="l198"></a><a href="#l198">198</a><td>        return exists ? files[0] : io.exists(files[1]).then(function(exists) {<tr><td><a id="l199"></a><a href="#l199">199</a><td>          if (exists) {<tr><td><a id="l200"></a><a href="#l200">200</a><td>            return files[1];<tr><td><a id="l201"></a><a href="#l201">201</a><td>          }<tr><td><a id="l202"></a><a href="#l202">202</a><td>          throw Error(&#39;Unable to find Safari on the current system&#39;);<tr><td><a id="l203"></a><a href="#l203">203</a><td>        });<tr><td><a id="l204"></a><a href="#l204">204</a><td>      });<tr><td><a id="l205"></a><a href="#l205">205</a><td><tr><td><a id="l206"></a><a href="#l206">206</a><td>    default:<tr><td><a id="l207"></a><a href="#l207">207</a><td>      return promise.rejected(<tr><td><a id="l208"></a><a href="#l208">208</a><td>          Error(&#39;Safari is not supported on the current platform: &#39; +<tr><td><a id="l209"></a><a href="#l209">209</a><td>              process.platform));<tr><td><a id="l210"></a><a href="#l210">210</a><td>  }<tr><td><a id="l211"></a><a href="#l211">211</a><td>}<tr><td><a id="l212"></a><a href="#l212">212</a><td><tr><td><a id="l213"></a><a href="#l213">213</a><td><tr><td><a id="l214"></a><a href="#l214">214</a><td>/**<tr><td><a id="l215"></a><a href="#l215">215</a><td> * @param {string} url The URL to connect to.<tr><td><a id="l216"></a><a href="#l216">216</a><td> * @return {!promise.Promise&lt;string&gt;} A promise for the path to a file that<tr><td><a id="l217"></a><a href="#l217">217</a><td> *     Safari can open on start-up to trigger a new connection to the WebSocket<tr><td><a id="l218"></a><a href="#l218">218</a><td> *     server.<tr><td><a id="l219"></a><a href="#l219">219</a><td> */<tr><td><a id="l220"></a><a href="#l220">220</a><td>function createConnectFile(url) {<tr><td><a id="l221"></a><a href="#l221">221</a><td>  return io.tmpFile({postfix: &#39;.html&#39;}).then(function(f) {<tr><td><a id="l222"></a><a href="#l222">222</a><td>    var writeFile =  promise.checkedNodeCall(fs.writeFile,<tr><td><a id="l223"></a><a href="#l223">223</a><td>        f,<tr><td><a id="l224"></a><a href="#l224">224</a><td>        &#39;&lt;!DOCTYPE html&gt;&lt;script&gt;window.location = &quot;&#39; + url + &#39;&quot;;&lt;/script&gt;&#39;,<tr><td><a id="l225"></a><a href="#l225">225</a><td>        {encoding: &#39;utf8&#39;});<tr><td><a id="l226"></a><a href="#l226">226</a><td>    return writeFile.then(function() {<tr><td><a id="l227"></a><a href="#l227">227</a><td>      return f;<tr><td><a id="l228"></a><a href="#l228">228</a><td>    });<tr><td><a id="l229"></a><a href="#l229">229</a><td>  });<tr><td><a id="l230"></a><a href="#l230">230</a><td>}<tr><td><a id="l231"></a><a href="#l231">231</a><td><tr><td><a id="l232"></a><a href="#l232">232</a><td><tr><td><a id="l233"></a><a href="#l233">233</a><td>/**<tr><td><a id="l234"></a><a href="#l234">234</a><td> * Deletes all session data files if so desired.<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @param {!Object} desiredCapabilities .<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @return {!Array&lt;promise.Promise&gt;} A list of promises for the deleted files.<tr><td><a id="l237"></a><a href="#l237">237</a><td> */<tr><td><a id="l238"></a><a href="#l238">238</a><td>function cleanSession(desiredCapabilities) {<tr><td><a id="l239"></a><a href="#l239">239</a><td>  if (!desiredCapabilities) {<tr><td><a id="l240"></a><a href="#l240">240</a><td>    return [];<tr><td><a id="l241"></a><a href="#l241">241</a><td>  }<tr><td><a id="l242"></a><a href="#l242">242</a><td>  var options = desiredCapabilities[OPTIONS_CAPABILITY_KEY];<tr><td><a id="l243"></a><a href="#l243">243</a><td>  if (!options) {<tr><td><a id="l244"></a><a href="#l244">244</a><td>    return [];<tr><td><a id="l245"></a><a href="#l245">245</a><td>  }<tr><td><a id="l246"></a><a href="#l246">246</a><td>  if (!options[&#39;cleanSession&#39;]) {<tr><td><a id="l247"></a><a href="#l247">247</a><td>    return [];<tr><td><a id="l248"></a><a href="#l248">248</a><td>  }<tr><td><a id="l249"></a><a href="#l249">249</a><td>  return SESSION_DATA_FILES.map(function(file) {<tr><td><a id="l250"></a><a href="#l250">250</a><td>    return io.unlink(file);<tr><td><a id="l251"></a><a href="#l251">251</a><td>  });<tr><td><a id="l252"></a><a href="#l252">252</a><td>}<tr><td><a id="l253"></a><a href="#l253">253</a><td><tr><td><a id="l254"></a><a href="#l254">254</a><td><tr><td><a id="l255"></a><a href="#l255">255</a><td>/**<tr><td><a id="l256"></a><a href="#l256">256</a><td> * @constructor<tr><td><a id="l257"></a><a href="#l257">257</a><td> * @implements {webdriver.CommandExecutor}<tr><td><a id="l258"></a><a href="#l258">258</a><td> */<tr><td><a id="l259"></a><a href="#l259">259</a><td>var CommandExecutor = function() {<tr><td><a id="l260"></a><a href="#l260">260</a><td>  /** @private {Server} */<tr><td><a id="l261"></a><a href="#l261">261</a><td>  this.server_ = null;<tr><td><a id="l262"></a><a href="#l262">262</a><td><tr><td><a id="l263"></a><a href="#l263">263</a><td>  /** @private {ws.WebSocket} */<tr><td><a id="l264"></a><a href="#l264">264</a><td>  this.socket_ = null;<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td>  /** @private {promise.Promise.&lt;!exec.Command&gt;} */<tr><td><a id="l267"></a><a href="#l267">267</a><td>  this.safari_ = null;<tr><td><a id="l268"></a><a href="#l268">268</a><td>};<tr><td><a id="l269"></a><a href="#l269">269</a><td><tr><td><a id="l270"></a><a href="#l270">270</a><td><tr><td><a id="l271"></a><a href="#l271">271</a><td>/** @override */<tr><td><a id="l272"></a><a href="#l272">272</a><td>CommandExecutor.prototype.execute = function(command, callback) {<tr><td><a id="l273"></a><a href="#l273">273</a><td>  var safariCommand = JSON.stringify({<tr><td><a id="l274"></a><a href="#l274">274</a><td>    &#39;origin&#39;: &#39;webdriver&#39;,<tr><td><a id="l275"></a><a href="#l275">275</a><td>    &#39;type&#39;: &#39;command&#39;,<tr><td><a id="l276"></a><a href="#l276">276</a><td>    &#39;command&#39;: {<tr><td><a id="l277"></a><a href="#l277">277</a><td>      &#39;id&#39;: _base.require(&#39;goog.string&#39;).getRandomString(),<tr><td><a id="l278"></a><a href="#l278">278</a><td>      &#39;name&#39;: command.getName(),<tr><td><a id="l279"></a><a href="#l279">279</a><td>      &#39;parameters&#39;: command.getParameters()<tr><td><a id="l280"></a><a href="#l280">280</a><td>    }<tr><td><a id="l281"></a><a href="#l281">281</a><td>  });<tr><td><a id="l282"></a><a href="#l282">282</a><td>  var self = this;<tr><td><a id="l283"></a><a href="#l283">283</a><td><tr><td><a id="l284"></a><a href="#l284">284</a><td>  switch (command.getName()) {<tr><td><a id="l285"></a><a href="#l285">285</a><td>    case webdriver.CommandName.NEW_SESSION:<tr><td><a id="l286"></a><a href="#l286">286</a><td>      this.startSafari_(command).then(sendCommand, callback);<tr><td><a id="l287"></a><a href="#l287">287</a><td>      break;<tr><td><a id="l288"></a><a href="#l288">288</a><td><tr><td><a id="l289"></a><a href="#l289">289</a><td>    case webdriver.CommandName.QUIT:<tr><td><a id="l290"></a><a href="#l290">290</a><td>      this.destroySession_().then(function() {<tr><td><a id="l291"></a><a href="#l291">291</a><td>        callback(null, _base.require(&#39;bot.response&#39;).createResponse(null));<tr><td><a id="l292"></a><a href="#l292">292</a><td>      }, callback);<tr><td><a id="l293"></a><a href="#l293">293</a><td>      break;<tr><td><a id="l294"></a><a href="#l294">294</a><td><tr><td><a id="l295"></a><a href="#l295">295</a><td>    default:<tr><td><a id="l296"></a><a href="#l296">296</a><td>      sendCommand();<tr><td><a id="l297"></a><a href="#l297">297</a><td>      break;<tr><td><a id="l298"></a><a href="#l298">298</a><td>  }<tr><td><a id="l299"></a><a href="#l299">299</a><td><tr><td><a id="l300"></a><a href="#l300">300</a><td>  function sendCommand() {<tr><td><a id="l301"></a><a href="#l301">301</a><td>    new promise.Promise(function(fulfill, reject) {<tr><td><a id="l302"></a><a href="#l302">302</a><td>      // TODO: support reconnecting with the extension.<tr><td><a id="l303"></a><a href="#l303">303</a><td>      if (!self.socket_) {<tr><td><a id="l304"></a><a href="#l304">304</a><td>        self.destroySession_().thenFinally(function() {<tr><td><a id="l305"></a><a href="#l305">305</a><td>          reject(Error(&#39;The connection to the SafariDriver was closed&#39;));<tr><td><a id="l306"></a><a href="#l306">306</a><td>        });<tr><td><a id="l307"></a><a href="#l307">307</a><td>        return;<tr><td><a id="l308"></a><a href="#l308">308</a><td>      }<tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td>      self.socket_.send(safariCommand, function(err) {<tr><td><a id="l311"></a><a href="#l311">311</a><td>        if (err) {<tr><td><a id="l312"></a><a href="#l312">312</a><td>          reject(err);<tr><td><a id="l313"></a><a href="#l313">313</a><td>          return;<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><tr><td><a id="l317"></a><a href="#l317">317</a><td>      self.socket_.once(&#39;message&#39;, function(data) {<tr><td><a id="l318"></a><a href="#l318">318</a><td>        try {<tr><td><a id="l319"></a><a href="#l319">319</a><td>          data = JSON.parse(data);<tr><td><a id="l320"></a><a href="#l320">320</a><td>        } catch (ex) {<tr><td><a id="l321"></a><a href="#l321">321</a><td>          reject(Error(&#39;Failed to parse driver message: &#39; + data));<tr><td><a id="l322"></a><a href="#l322">322</a><td>          return;<tr><td><a id="l323"></a><a href="#l323">323</a><td>        }<tr><td><a id="l324"></a><a href="#l324">324</a><td>        fulfill(data[&#39;response&#39;]);<tr><td><a id="l325"></a><a href="#l325">325</a><td>      });<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td>    }).then(function(value) {<tr><td><a id="l328"></a><a href="#l328">328</a><td>      callback(null, value);<tr><td><a id="l329"></a><a href="#l329">329</a><td>    }, callback);<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>/**<tr><td><a id="l335"></a><a href="#l335">335</a><td> * @param {!webdriver.Command} command .<tr><td><a id="l336"></a><a href="#l336">336</a><td> * @private<tr><td><a id="l337"></a><a href="#l337">337</a><td> */<tr><td><a id="l338"></a><a href="#l338">338</a><td>CommandExecutor.prototype.startSafari_ = function(command) {<tr><td><a id="l339"></a><a href="#l339">339</a><td>  this.server_ = new Server();<tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td>  this.safari_ = this.server_.start().then(function(address) {<tr><td><a id="l342"></a><a href="#l342">342</a><td>    var tasks = cleanSession(command.getParameters()[&#39;desiredCapabilities&#39;]);<tr><td><a id="l343"></a><a href="#l343">343</a><td>    tasks.push(<tr><td><a id="l344"></a><a href="#l344">344</a><td>      findSafariExecutable(),<tr><td><a id="l345"></a><a href="#l345">345</a><td>      createConnectFile(<tr><td><a id="l346"></a><a href="#l346">346</a><td>          &#39;http://&#39; + address.address + &#39;:&#39; + address.port));<tr><td><a id="l347"></a><a href="#l347">347</a><td>    return promise.all(tasks).then(function(tasks) {<tr><td><a id="l348"></a><a href="#l348">348</a><td>      var exe = tasks[tasks.length - 2];<tr><td><a id="l349"></a><a href="#l349">349</a><td>      var html = tasks[tasks.length - 1];<tr><td><a id="l350"></a><a href="#l350">350</a><td>      return exec(exe, {args: [html]});<tr><td><a id="l351"></a><a href="#l351">351</a><td>    });<tr><td><a id="l352"></a><a href="#l352">352</a><td>  });<tr><td><a id="l353"></a><a href="#l353">353</a><td><tr><td><a id="l354"></a><a href="#l354">354</a><td>  var connected = promise.defer();<tr><td><a id="l355"></a><a href="#l355">355</a><td>  var self = this;<tr><td><a id="l356"></a><a href="#l356">356</a><td>  var start = Date.now();<tr><td><a id="l357"></a><a href="#l357">357</a><td>  var timer = setTimeout(function() {<tr><td><a id="l358"></a><a href="#l358">358</a><td>    connected.reject(Error(<tr><td><a id="l359"></a><a href="#l359">359</a><td>      &#39;Failed to connect to the SafariDriver after &#39; + (Date.now() - start) +<tr><td><a id="l360"></a><a href="#l360">360</a><td>      &#39; ms; Have you installed the latest extension from &#39; +<tr><td><a id="l361"></a><a href="#l361">361</a><td>      &#39;http://selenium-release.storage.googleapis.com/index.html?&#39;));<tr><td><a id="l362"></a><a href="#l362">362</a><td>  }, 10 * 1000);<tr><td><a id="l363"></a><a href="#l363">363</a><td>  this.server_.once(&#39;connection&#39;, function(socket) {<tr><td><a id="l364"></a><a href="#l364">364</a><td>    clearTimeout(timer);<tr><td><a id="l365"></a><a href="#l365">365</a><td>    self.socket_ = socket;<tr><td><a id="l366"></a><a href="#l366">366</a><td>    socket.once(&#39;close&#39;, function() {<tr><td><a id="l367"></a><a href="#l367">367</a><td>      self.socket_ = null;<tr><td><a id="l368"></a><a href="#l368">368</a><td>    });<tr><td><a id="l369"></a><a href="#l369">369</a><td>    connected.fulfill();<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 connected.promise;<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> * Destroys the active session by stopping the WebSocket server and killing the<tr><td><a id="l377"></a><a href="#l377">377</a><td> * Safari subprocess.<tr><td><a id="l378"></a><a href="#l378">378</a><td> * @private<tr><td><a id="l379"></a><a href="#l379">379</a><td> */<tr><td><a id="l380"></a><a href="#l380">380</a><td>CommandExecutor.prototype.destroySession_ = function() {<tr><td><a id="l381"></a><a href="#l381">381</a><td>  var tasks = [];<tr><td><a id="l382"></a><a href="#l382">382</a><td>  if (this.server_) {<tr><td><a id="l383"></a><a href="#l383">383</a><td>    tasks.push(this.server_.stop());<tr><td><a id="l384"></a><a href="#l384">384</a><td>  }<tr><td><a id="l385"></a><a href="#l385">385</a><td>  if (this.safari_) {<tr><td><a id="l386"></a><a href="#l386">386</a><td>    tasks.push(this.safari_.then(function(safari) {<tr><td><a id="l387"></a><a href="#l387">387</a><td>      safari.kill();<tr><td><a id="l388"></a><a href="#l388">388</a><td>      return safari.result();<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>  var self = this;<tr><td><a id="l392"></a><a href="#l392">392</a><td>  return promise.all(tasks).thenFinally(function() {<tr><td><a id="l393"></a><a href="#l393">393</a><td>    self.server_ = null;<tr><td><a id="l394"></a><a href="#l394">394</a><td>    self.socket_ = null;<tr><td><a id="l395"></a><a href="#l395">395</a><td>    self.safari_ = null;<tr><td><a id="l396"></a><a href="#l396">396</a><td>  });<tr><td><a id="l397"></a><a href="#l397">397</a><td>};<tr><td><a id="l398"></a><a href="#l398">398</a><td><tr><td><a id="l399"></a><a href="#l399">399</a><td><tr><td><a id="l400"></a><a href="#l400">400</a><td>/** @const */<tr><td><a id="l401"></a><a href="#l401">401</a><td>var OPTIONS_CAPABILITY_KEY = &#39;safari.options&#39;;<tr><td><a id="l402"></a><a href="#l402">402</a><td><tr><td><a id="l403"></a><a href="#l403">403</a><td><tr><td><a id="l404"></a><a href="#l404">404</a><td><tr><td><a id="l405"></a><a href="#l405">405</a><td>/**<tr><td><a id="l406"></a><a href="#l406">406</a><td> * Configuration options specific to the {@link Driver SafariDriver}.<tr><td><a id="l407"></a><a href="#l407">407</a><td> * @constructor<tr><td><a id="l408"></a><a href="#l408">408</a><td> * @extends {webdriver.Serializable}<tr><td><a id="l409"></a><a href="#l409">409</a><td> */<tr><td><a id="l410"></a><a href="#l410">410</a><td>var Options = function() {<tr><td><a id="l411"></a><a href="#l411">411</a><td>  webdriver.Serializable.call(this);<tr><td><a id="l412"></a><a href="#l412">412</a><td><tr><td><a id="l413"></a><a href="#l413">413</a><td>  /** @private {Object&lt;string, *&gt;} */<tr><td><a id="l414"></a><a href="#l414">414</a><td>  this.options_ = null;<tr><td><a id="l415"></a><a href="#l415">415</a><td><tr><td><a id="l416"></a><a href="#l416">416</a><td>  /** @private {webdriver.logging.Preferences} */<tr><td><a id="l417"></a><a href="#l417">417</a><td>  this.logPrefs_ = null;<tr><td><a id="l418"></a><a href="#l418">418</a><td>};<tr><td><a id="l419"></a><a href="#l419">419</a><td>util.inherits(Options, webdriver.Serializable);<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> * Extracts the SafariDriver specific options from the given capabilities<tr><td><a id="l424"></a><a href="#l424">424</a><td> * object.<tr><td><a id="l425"></a><a href="#l425">425</a><td> * @param {!webdriver.Capabilities} capabilities The capabilities object.<tr><td><a id="l426"></a><a href="#l426">426</a><td> * @return {!Options} The ChromeDriver options.<tr><td><a id="l427"></a><a href="#l427">427</a><td> */<tr><td><a id="l428"></a><a href="#l428">428</a><td>Options.fromCapabilities = function(capabilities) {<tr><td><a id="l429"></a><a href="#l429">429</a><td>  var options = new Options();<tr><td><a id="l430"></a><a href="#l430">430</a><td><tr><td><a id="l431"></a><a href="#l431">431</a><td>  var o = capabilities.get(OPTIONS_CAPABILITY_KEY);<tr><td><a id="l432"></a><a href="#l432">432</a><td>  if (o instanceof Options) {<tr><td><a id="l433"></a><a href="#l433">433</a><td>    options = o;<tr><td><a id="l434"></a><a href="#l434">434</a><td>  } else if (o) {<tr><td><a id="l435"></a><a href="#l435">435</a><td>    options.setCleanSession(o.cleanSession);<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>  if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {<tr><td><a id="l439"></a><a href="#l439">439</a><td>    options.setLoggingPrefs(<tr><td><a id="l440"></a><a href="#l440">440</a><td>        capabilities.get(webdriver.Capability.LOGGING_PREFS));<tr><td><a id="l441"></a><a href="#l441">441</a><td>  }<tr><td><a id="l442"></a><a href="#l442">442</a><td><tr><td><a id="l443"></a><a href="#l443">443</a><td>  return options;<tr><td><a id="l444"></a><a href="#l444">444</a><td>};<tr><td><a id="l445"></a><a href="#l445">445</a><td><tr><td><a id="l446"></a><a href="#l446">446</a><td><tr><td><a id="l447"></a><a href="#l447">447</a><td>/**<tr><td><a id="l448"></a><a href="#l448">448</a><td> * Sets whether to force Safari to start with a clean session. Enabling this<tr><td><a id="l449"></a><a href="#l449">449</a><td> * option will cause all global browser data to be deleted.<tr><td><a id="l450"></a><a href="#l450">450</a><td> * @param {boolean} clean Whether to make sure the session has no cookies,<tr><td><a id="l451"></a><a href="#l451">451</a><td> *     cache entries, local storage, or databases.<tr><td><a id="l452"></a><a href="#l452">452</a><td> * @return {!Options} A self reference.<tr><td><a id="l453"></a><a href="#l453">453</a><td> */<tr><td><a id="l454"></a><a href="#l454">454</a><td>Options.prototype.setCleanSession = function(clean) {<tr><td><a id="l455"></a><a href="#l455">455</a><td>  if (!this.options_) {<tr><td><a id="l456"></a><a href="#l456">456</a><td>    this.options_ = {};<tr><td><a id="l457"></a><a href="#l457">457</a><td>  }<tr><td><a id="l458"></a><a href="#l458">458</a><td>  this.options_[&#39;cleanSession&#39;] = clean;<tr><td><a id="l459"></a><a href="#l459">459</a><td>  return this;<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>/**<tr><td><a id="l464"></a><a href="#l464">464</a><td> * Sets the logging preferences for the new session.<tr><td><a id="l465"></a><a href="#l465">465</a><td> * @param {!webdriver.logging.Preferences} prefs The logging preferences.<tr><td><a id="l466"></a><a href="#l466">466</a><td> * @return {!Options} A self reference.<tr><td><a id="l467"></a><a href="#l467">467</a><td> */<tr><td><a id="l468"></a><a href="#l468">468</a><td>Options.prototype.setLoggingPrefs = function(prefs) {<tr><td><a id="l469"></a><a href="#l469">469</a><td>  this.logPrefs_ = prefs;<tr><td><a id="l470"></a><a href="#l470">470</a><td>  return this;<tr><td><a id="l471"></a><a href="#l471">471</a><td>};<tr><td><a id="l472"></a><a href="#l472">472</a><td><tr><td><a id="l473"></a><a href="#l473">473</a><td><tr><td><a id="l474"></a><a href="#l474">474</a><td>/**<tr><td><a id="l475"></a><a href="#l475">475</a><td> * Converts this options instance to a {@link webdriver.Capabilities} object.<tr><td><a id="l476"></a><a href="#l476">476</a><td> * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge<tr><td><a id="l477"></a><a href="#l477">477</a><td> *     these options into, if any.<tr><td><a id="l478"></a><a href="#l478">478</a><td> * @return {!webdriver.Capabilities} The capabilities.<tr><td><a id="l479"></a><a href="#l479">479</a><td> */<tr><td><a id="l480"></a><a href="#l480">480</a><td>Options.prototype.toCapabilities = function(opt_capabilities) {<tr><td><a id="l481"></a><a href="#l481">481</a><td>  var capabilities = opt_capabilities || webdriver.Capabilities.safari();<tr><td><a id="l482"></a><a href="#l482">482</a><td>  if (this.logPrefs_) {<tr><td><a id="l483"></a><a href="#l483">483</a><td>    capabilities.set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_);<tr><td><a id="l484"></a><a href="#l484">484</a><td>  }<tr><td><a id="l485"></a><a href="#l485">485</a><td>  if (this.options_) {<tr><td><a id="l486"></a><a href="#l486">486</a><td>    capabilities.set(OPTIONS_CAPABILITY_KEY, this);<tr><td><a id="l487"></a><a href="#l487">487</a><td>  }<tr><td><a id="l488"></a><a href="#l488">488</a><td>  return capabilities;<tr><td><a id="l489"></a><a href="#l489">489</a><td>};<tr><td><a id="l490"></a><a href="#l490">490</a><td><tr><td><a id="l491"></a><a href="#l491">491</a><td><tr><td><a id="l492"></a><a href="#l492">492</a><td>/**<tr><td><a id="l493"></a><a href="#l493">493</a><td> * Converts this instance to its JSON wire protocol representation. Note this<tr><td><a id="l494"></a><a href="#l494">494</a><td> * function is an implementation detail not intended for general use.<tr><td><a id="l495"></a><a href="#l495">495</a><td> * @return {!Object&lt;string, *&gt;} The JSON wire protocol representation of this<tr><td><a id="l496"></a><a href="#l496">496</a><td> *     instance.<tr><td><a id="l497"></a><a href="#l497">497</a><td> * @override<tr><td><a id="l498"></a><a href="#l498">498</a><td> */<tr><td><a id="l499"></a><a href="#l499">499</a><td>Options.prototype.serialize = function() {<tr><td><a id="l500"></a><a href="#l500">500</a><td>  return this.options_ || {};<tr><td><a id="l501"></a><a href="#l501">501</a><td>};<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> * A WebDriver client for Safari. This class should never be instantiated<tr><td><a id="l507"></a><a href="#l507">507</a><td> * directly; instead, use the {@link selenium-webdriver.Builder}:<tr><td><a id="l508"></a><a href="#l508">508</a><td> *<tr><td><a id="l509"></a><a href="#l509">509</a><td> *     var driver = new Builder()<tr><td><a id="l510"></a><a href="#l510">510</a><td> *         .forBrowser(&#39;safari&#39;)<tr><td><a id="l511"></a><a href="#l511">511</a><td> *         .build();<tr><td><a id="l512"></a><a href="#l512">512</a><td> *<tr><td><a id="l513"></a><a href="#l513">513</a><td> * @param {(Options|webdriver.Capabilities)=} opt_config The configuration<tr><td><a id="l514"></a><a href="#l514">514</a><td> *     options for the new session.<tr><td><a id="l515"></a><a href="#l515">515</a><td> * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to create<tr><td><a id="l516"></a><a href="#l516">516</a><td> *     the driver under.<tr><td><a id="l517"></a><a href="#l517">517</a><td> * @constructor<tr><td><a id="l518"></a><a href="#l518">518</a><td> * @extends {webdriver.WebDriver}<tr><td><a id="l519"></a><a href="#l519">519</a><td> */<tr><td><a id="l520"></a><a href="#l520">520</a><td>var Driver = function(opt_config, opt_flow) {<tr><td><a id="l521"></a><a href="#l521">521</a><td>  var executor = new CommandExecutor();<tr><td><a id="l522"></a><a href="#l522">522</a><td>  var capabilities =<tr><td><a id="l523"></a><a href="#l523">523</a><td>      opt_config instanceof Options ? opt_config.toCapabilities() :<tr><td><a id="l524"></a><a href="#l524">524</a><td>      (opt_config || webdriver.Capabilities.safari());<tr><td><a id="l525"></a><a href="#l525">525</a><td><tr><td><a id="l526"></a><a href="#l526">526</a><td>  var driver = webdriver.WebDriver.createSession(<tr><td><a id="l527"></a><a href="#l527">527</a><td>      executor, capabilities, opt_flow);<tr><td><a id="l528"></a><a href="#l528">528</a><td>  webdriver.WebDriver.call(<tr><td><a id="l529"></a><a href="#l529">529</a><td>      this, driver.getSession(), executor, driver.controlFlow());<tr><td><a id="l530"></a><a href="#l530">530</a><td>};<tr><td><a id="l531"></a><a href="#l531">531</a><td>util.inherits(Driver, webdriver.WebDriver);<tr><td><a id="l532"></a><a href="#l532">532</a><td><tr><td><a id="l533"></a><a href="#l533">533</a><td><tr><td><a id="l534"></a><a href="#l534">534</a><td>// Public API<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>exports.Driver = Driver;<tr><td><a id="l538"></a><a href="#l538">538</a><td>exports.Options = Options;</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>
\ No newline at end of file
diff --git a/docs/source/testing/assert.js.src.html b/docs/source/testing/assert.js.src.html
index 125141d..48bfc89 100644
--- a/docs/source/testing/assert.js.src.html
+++ b/docs/source/testing/assert.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>assert.js</title><link href="../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>testing/assert.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>//     You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Defines a library that simplifies writing assertions against<tr><td><a name="l17" href="#l17">17</a><td> * promised values.<tr><td><a name="l18" href="#l18">18</a><td> *<tr><td><a name="l19" href="#l19">19</a><td> * &lt;blockquote&gt;<tr><td><a name="l20" href="#l20">20</a><td> * &lt;hr&gt;<tr><td><a name="l21" href="#l21">21</a><td> * &lt;b&gt;NOTE:&lt;/b&gt; This module is considered experimental and is subject to<tr><td><a name="l22" href="#l22">22</a><td> * change, or removal, at any time!<tr><td><a name="l23" href="#l23">23</a><td> * &lt;hr&gt;<tr><td><a name="l24" href="#l24">24</a><td> * &lt;/blockquote&gt;<tr><td><a name="l25" href="#l25">25</a><td> *<tr><td><a name="l26" href="#l26">26</a><td> * Sample usage:<tr><td><a name="l27" href="#l27">27</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l28" href="#l28">28</a><td> * var driver = new webdriver.Builder().build();<tr><td><a name="l29" href="#l29">29</a><td> * driver.get(&#39;http://www.google.com&#39;);<tr><td><a name="l30" href="#l30">30</a><td> *<tr><td><a name="l31" href="#l31">31</a><td> * assert(driver.getTitle()).equalTo(&#39;Google&#39;);<tr><td><a name="l32" href="#l32">32</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td>var base = require(&#39;../_base&#39;),<tr><td><a name="l36" href="#l36">36</a><td>    assert = base.require(&#39;webdriver.testing.assert&#39;);<tr><td><a name="l37" href="#l37">37</a><td><tr><td><a name="l38" href="#l38">38</a><td><tr><td><a name="l39" href="#l39">39</a><td>// PUBLIC API<tr><td><a name="l40" href="#l40">40</a><td><tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td>/** @type {webdriver.testing.assert.} */<tr><td><a name="l43" href="#l43">43</a><td>module.exports = assert;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../types.js"></script><script src="../../dossier.js"></script>
\ No newline at end of file
+<!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>assert.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>testing/assert.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Defines a library that simplifies writing assertions against<tr><td><a id="l20"></a><a href="#l20">20</a><td> * promised values.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * &gt; &lt;hr&gt;<tr><td><a id="l23"></a><a href="#l23">23</a><td> * &gt; __NOTE:__ This module is considered experimental and is subject to<tr><td><a id="l24"></a><a href="#l24">24</a><td> * &gt; change, or removal, at any time!<tr><td><a id="l25"></a><a href="#l25">25</a><td> * &gt; &lt;hr&gt;<tr><td><a id="l26"></a><a href="#l26">26</a><td> *<tr><td><a id="l27"></a><a href="#l27">27</a><td> * Sample usage:<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> *     var driver = new webdriver.Builder().build();<tr><td><a id="l30"></a><a href="#l30">30</a><td> *     driver.get(&#39;http://www.google.com&#39;);<tr><td><a id="l31"></a><a href="#l31">31</a><td> *<tr><td><a id="l32"></a><a href="#l32">32</a><td> *     assert(driver.getTitle()).equalTo(&#39;Google&#39;);<tr><td><a id="l33"></a><a href="#l33">33</a><td> */<tr><td><a id="l34"></a><a href="#l34">34</a><td><tr><td><a id="l35"></a><a href="#l35">35</a><td>var base = require(&#39;../_base&#39;),<tr><td><a id="l36"></a><a href="#l36">36</a><td>    assert = base.require(&#39;webdriver.testing.assert&#39;);<tr><td><a id="l37"></a><a href="#l37">37</a><td><tr><td><a id="l38"></a><a href="#l38">38</a><td><tr><td><a id="l39"></a><a href="#l39">39</a><td>// PUBLIC API<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>/**<tr><td><a id="l43"></a><a href="#l43">43</a><td> * Creates a new assertion.<tr><td><a id="l44"></a><a href="#l44">44</a><td> * @param {*} value The value to perform an assertion on.<tr><td><a id="l45"></a><a href="#l45">45</a><td> * @return {!webdriver.testing.Assertion} The new assertion.<tr><td><a id="l46"></a><a href="#l46">46</a><td> */<tr><td><a id="l47"></a><a href="#l47">47</a><td>module.exports = function(value) {<tr><td><a id="l48"></a><a href="#l48">48</a><td>  return assert(value);<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>/**<tr><td><a id="l53"></a><a href="#l53">53</a><td> * Registers a new assertion to expose from the<tr><td><a id="l54"></a><a href="#l54">54</a><td> * {@link webdriver.testing.Assertion} prototype.<tr><td><a id="l55"></a><a href="#l55">55</a><td> * @param {string} name The assertion name.<tr><td><a id="l56"></a><a href="#l56">56</a><td> * @param {(function(new: goog.labs.testing.Matcher, *)|<tr><td><a id="l57"></a><a href="#l57">57</a><td> *          {matches: function(*): boolean,<tr><td><a id="l58"></a><a href="#l58">58</a><td> *           describe: function(): string})} matcherTemplate Either the<tr><td><a id="l59"></a><a href="#l59">59</a><td> *     matcher constructor to use, or an object literal defining a matcher.<tr><td><a id="l60"></a><a href="#l60">60</a><td> */<tr><td><a id="l61"></a><a href="#l61">61</a><td>module.exports.register = assert.register;</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>
\ No newline at end of file
diff --git a/docs/source/testing/index.js.src.html b/docs/source/testing/index.js.src.html
index 5049609..81d7f5a 100644
--- a/docs/source/testing/index.js.src.html
+++ b/docs/source/testing/index.js.src.html
@@ -1 +1 @@
-<!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>index.js</title><link href="../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>testing/index.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2013 Selenium committers<tr><td><a name="l2" href="#l2">2</a><td>// Copyright 2013 Software Freedom Conservancy<tr><td><a name="l3" href="#l3">3</a><td>//<tr><td><a name="l4" href="#l4">4</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l5" href="#l5">5</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l6" href="#l6">6</a><td>//     You may obtain a copy of the License at<tr><td><a name="l7" href="#l7">7</a><td>//<tr><td><a name="l8" href="#l8">8</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l9" href="#l9">9</a><td>//<tr><td><a name="l10" href="#l10">10</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l11" href="#l11">11</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l12" href="#l12">12</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l13" href="#l13">13</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l14" href="#l14">14</a><td>// limitations under the License.<tr><td><a name="l15" href="#l15">15</a><td><tr><td><a name="l16" href="#l16">16</a><td>/**<tr><td><a name="l17" href="#l17">17</a><td> * @fileoverview Provides wrappers around the following global functions from<tr><td><a name="l18" href="#l18">18</a><td> * &lt;a href=&quot;http://visionmedia.github.io/mocha/&quot;&gt;Mocha&#39;s BDD interface&lt;/a&gt;:<tr><td><a name="l19" href="#l19">19</a><td> * &lt;ul&gt;<tr><td><a name="l20" href="#l20">20</a><td> *   &lt;li&gt;after<tr><td><a name="l21" href="#l21">21</a><td> *   &lt;li&gt;afterEach<tr><td><a name="l22" href="#l22">22</a><td> *   &lt;li&gt;before<tr><td><a name="l23" href="#l23">23</a><td> *   &lt;li&gt;beforeEach<tr><td><a name="l24" href="#l24">24</a><td> *   &lt;li&gt;it<tr><td><a name="l25" href="#l25">25</a><td> *   &lt;li&gt;it.only<tr><td><a name="l26" href="#l26">26</a><td> *   &lt;li&gt;it.skip<tr><td><a name="l27" href="#l27">27</a><td> *   &lt;li&gt;xit<tr><td><a name="l28" href="#l28">28</a><td> * &lt;/ul&gt;<tr><td><a name="l29" href="#l29">29</a><td> *<tr><td><a name="l30" href="#l30">30</a><td> * &lt;p&gt;The provided wrappers leverage the webdriver.promise.ControlFlow to<tr><td><a name="l31" href="#l31">31</a><td> * simplify writing asynchronous tests:<tr><td><a name="l32" href="#l32">32</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l33" href="#l33">33</a><td> * var webdriver = require(&#39;selenium-webdriver&#39;),<tr><td><a name="l34" href="#l34">34</a><td> *     remote = require(&#39;selenium-webdriver/remote&#39;),<tr><td><a name="l35" href="#l35">35</a><td> *     test = require(&#39;selenium-webdriver/testing&#39;);<tr><td><a name="l36" href="#l36">36</a><td> *<tr><td><a name="l37" href="#l37">37</a><td> * test.describe(&#39;Google Search&#39;, function() {<tr><td><a name="l38" href="#l38">38</a><td> *   var driver, server;<tr><td><a name="l39" href="#l39">39</a><td> *<tr><td><a name="l40" href="#l40">40</a><td> *   test.before(function() {<tr><td><a name="l41" href="#l41">41</a><td> *     server = new remote.SeleniumServer({<tr><td><a name="l42" href="#l42">42</a><td> *       jar: &#39;path/to/selenium-server-standalone.jar&#39;<tr><td><a name="l43" href="#l43">43</a><td> *     });<tr><td><a name="l44" href="#l44">44</a><td> *     server.start();<tr><td><a name="l45" href="#l45">45</a><td> *<tr><td><a name="l46" href="#l46">46</a><td> *     driver = new webdriver.Builder().<tr><td><a name="l47" href="#l47">47</a><td> *         withCapabilities({&#39;browserName&#39;: &#39;firefox&#39;}).<tr><td><a name="l48" href="#l48">48</a><td> *         usingServer(server.address()).<tr><td><a name="l49" href="#l49">49</a><td> *         build();<tr><td><a name="l50" href="#l50">50</a><td> *   });<tr><td><a name="l51" href="#l51">51</a><td> *<tr><td><a name="l52" href="#l52">52</a><td> *   test.after(function() {<tr><td><a name="l53" href="#l53">53</a><td> *     driver.quit();<tr><td><a name="l54" href="#l54">54</a><td> *     server.stop();<tr><td><a name="l55" href="#l55">55</a><td> *   });<tr><td><a name="l56" href="#l56">56</a><td> *<tr><td><a name="l57" href="#l57">57</a><td> *   test.it(&#39;should append query to title&#39;, function() {<tr><td><a name="l58" href="#l58">58</a><td> *     driver.get(&#39;http://www.google.com&#39;);<tr><td><a name="l59" href="#l59">59</a><td> *     driver.findElement(webdriver.By.name(&#39;q&#39;)).sendKeys(&#39;webdriver&#39;);<tr><td><a name="l60" href="#l60">60</a><td> *     driver.findElement(webdriver.By.name(&#39;btnG&#39;)).click();<tr><td><a name="l61" href="#l61">61</a><td> *     driver.wait(function() {<tr><td><a name="l62" href="#l62">62</a><td> *       return driver.getTitle().then(function(title) {<tr><td><a name="l63" href="#l63">63</a><td> *         return &#39;webdriver - Google Search&#39; === title;<tr><td><a name="l64" href="#l64">64</a><td> *       });<tr><td><a name="l65" href="#l65">65</a><td> *     }, 1000, &#39;Waiting for title to update&#39;);<tr><td><a name="l66" href="#l66">66</a><td> *   });<tr><td><a name="l67" href="#l67">67</a><td> * });<tr><td><a name="l68" href="#l68">68</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l69" href="#l69">69</a><td> *<tr><td><a name="l70" href="#l70">70</a><td> * &lt;p&gt;You may conditionally suppress a test function using the exported<tr><td><a name="l71" href="#l71">71</a><td> * &quot;ignore&quot; function. If the provided predicate returns true, the attached<tr><td><a name="l72" href="#l72">72</a><td> * test case will be skipped:<tr><td><a name="l73" href="#l73">73</a><td> * &lt;pre&gt;&lt;code&gt;<tr><td><a name="l74" href="#l74">74</a><td> *   test.ignore(maybe()).it(&#39;is flaky&#39;, function() {<tr><td><a name="l75" href="#l75">75</a><td> *     if (Math.random() &lt; 0.5) throw Error();<tr><td><a name="l76" href="#l76">76</a><td> *   });<tr><td><a name="l77" href="#l77">77</a><td> *<tr><td><a name="l78" href="#l78">78</a><td> *   function maybe() { return Math.random() &lt; 0.5; }<tr><td><a name="l79" href="#l79">79</a><td> * &lt;/code&gt;&lt;/pre&gt;<tr><td><a name="l80" href="#l80">80</a><td> */<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td>var flow = require(&#39;..&#39;).promise.controlFlow();<tr><td><a name="l83" href="#l83">83</a><td><tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td>/**<tr><td><a name="l86" href="#l86">86</a><td> * Wraps a function so that all passed arguments are ignored.<tr><td><a name="l87" href="#l87">87</a><td> * @param {!Function} fn The function to wrap.<tr><td><a name="l88" href="#l88">88</a><td> * @return {!Function} The wrapped function.<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>function seal(fn) {<tr><td><a name="l91" href="#l91">91</a><td>  return function() {<tr><td><a name="l92" href="#l92">92</a><td>    fn();<tr><td><a name="l93" href="#l93">93</a><td>  };<tr><td><a name="l94" href="#l94">94</a><td>}<tr><td><a name="l95" href="#l95">95</a><td><tr><td><a name="l96" href="#l96">96</a><td><tr><td><a name="l97" href="#l97">97</a><td>/**<tr><td><a name="l98" href="#l98">98</a><td> * Wraps a function on Mocha&#39;s BDD interface so it runs inside a<tr><td><a name="l99" href="#l99">99</a><td> * webdriver.promise.ControlFlow and waits for the flow to complete before<tr><td><a name="l100" href="#l100">100</a><td> * continuing.<tr><td><a name="l101" href="#l101">101</a><td> * @param {!Function} globalFn The function to wrap.<tr><td><a name="l102" href="#l102">102</a><td> * @return {!Function} The new function.<tr><td><a name="l103" href="#l103">103</a><td> */<tr><td><a name="l104" href="#l104">104</a><td>function wrapped(globalFn) {<tr><td><a name="l105" href="#l105">105</a><td>  return function() {<tr><td><a name="l106" href="#l106">106</a><td>    switch (arguments.length) {<tr><td><a name="l107" href="#l107">107</a><td>      case 1:<tr><td><a name="l108" href="#l108">108</a><td>        globalFn(asyncTestFn(arguments[0]));<tr><td><a name="l109" href="#l109">109</a><td>        break;<tr><td><a name="l110" href="#l110">110</a><td><tr><td><a name="l111" href="#l111">111</a><td>      case 2:<tr><td><a name="l112" href="#l112">112</a><td>        globalFn(arguments[0], asyncTestFn(arguments[1]));<tr><td><a name="l113" href="#l113">113</a><td>        break;<tr><td><a name="l114" href="#l114">114</a><td><tr><td><a name="l115" href="#l115">115</a><td>      default:<tr><td><a name="l116" href="#l116">116</a><td>        throw Error(&#39;Invalid # arguments: &#39; + arguments.length);<tr><td><a name="l117" href="#l117">117</a><td>    }<tr><td><a name="l118" href="#l118">118</a><td>  };<tr><td><a name="l119" href="#l119">119</a><td><tr><td><a name="l120" href="#l120">120</a><td>  function asyncTestFn(fn) {<tr><td><a name="l121" href="#l121">121</a><td>    return function(done) {<tr><td><a name="l122" href="#l122">122</a><td>      this.timeout(0);<tr><td><a name="l123" href="#l123">123</a><td>      var timeout = this.timeout;<tr><td><a name="l124" href="#l124">124</a><td>      this.timeout = undefined;  // Do not let tests change the timeout.<tr><td><a name="l125" href="#l125">125</a><td>      try {<tr><td><a name="l126" href="#l126">126</a><td>        flow.execute(fn.bind(this)).then(seal(done), done);<tr><td><a name="l127" href="#l127">127</a><td>      } finally {<tr><td><a name="l128" href="#l128">128</a><td>        this.timeout = timeout;<tr><td><a name="l129" href="#l129">129</a><td>      }<tr><td><a name="l130" href="#l130">130</a><td>    };<tr><td><a name="l131" href="#l131">131</a><td>  }<tr><td><a name="l132" href="#l132">132</a><td>}<tr><td><a name="l133" href="#l133">133</a><td><tr><td><a name="l134" href="#l134">134</a><td><tr><td><a name="l135" href="#l135">135</a><td>/**<tr><td><a name="l136" href="#l136">136</a><td> * Ignores the test chained to this function if the provided predicate returns<tr><td><a name="l137" href="#l137">137</a><td> * true.<tr><td><a name="l138" href="#l138">138</a><td> * @param {function(): boolean} predicateFn A predicate to call to determine<tr><td><a name="l139" href="#l139">139</a><td> *     if the test should be suppressed. This function MUST be synchronous.<tr><td><a name="l140" href="#l140">140</a><td> * @return {!Object} An object with wrapped versions of {@link #it()} and<tr><td><a name="l141" href="#l141">141</a><td> *     {@link #describe()} that ignore tests as indicated by the predicate.<tr><td><a name="l142" href="#l142">142</a><td> */<tr><td><a name="l143" href="#l143">143</a><td>function ignore(predicateFn) {<tr><td><a name="l144" href="#l144">144</a><td>  var describe = wrap(exports.xdescribe, exports.describe);<tr><td><a name="l145" href="#l145">145</a><td>  describe.only = wrap(exports.xdescribe, exports.describe.only);<tr><td><a name="l146" href="#l146">146</a><td><tr><td><a name="l147" href="#l147">147</a><td>  var it = wrap(exports.xit, exports.it);<tr><td><a name="l148" href="#l148">148</a><td>  it.only = wrap(exports.xit, exports.it.only);<tr><td><a name="l149" href="#l149">149</a><td><tr><td><a name="l150" href="#l150">150</a><td>  return {<tr><td><a name="l151" href="#l151">151</a><td>    describe: describe,<tr><td><a name="l152" href="#l152">152</a><td>    it: it<tr><td><a name="l153" href="#l153">153</a><td>  };<tr><td><a name="l154" href="#l154">154</a><td><tr><td><a name="l155" href="#l155">155</a><td>  function wrap(onSkip, onRun) {<tr><td><a name="l156" href="#l156">156</a><td>    return function(title, fn) {<tr><td><a name="l157" href="#l157">157</a><td>      if (predicateFn()) {<tr><td><a name="l158" href="#l158">158</a><td>        onSkip(title, fn);<tr><td><a name="l159" href="#l159">159</a><td>      } else {<tr><td><a name="l160" href="#l160">160</a><td>        onRun(title, fn);<tr><td><a name="l161" href="#l161">161</a><td>      }<tr><td><a name="l162" href="#l162">162</a><td>    };<tr><td><a name="l163" href="#l163">163</a><td>  }<tr><td><a name="l164" href="#l164">164</a><td>}<tr><td><a name="l165" href="#l165">165</a><td><tr><td><a name="l166" href="#l166">166</a><td><tr><td><a name="l167" href="#l167">167</a><td>// PUBLIC API<tr><td><a name="l168" href="#l168">168</a><td><tr><td><a name="l169" href="#l169">169</a><td>/**<tr><td><a name="l170" href="#l170">170</a><td> * Registers a new test suite.<tr><td><a name="l171" href="#l171">171</a><td> * @param {string} name The suite name.<tr><td><a name="l172" href="#l172">172</a><td> * @param {function()=} fn The suite function, or {@code undefined} to define<tr><td><a name="l173" href="#l173">173</a><td> *     a pending test suite.<tr><td><a name="l174" href="#l174">174</a><td> */<tr><td><a name="l175" href="#l175">175</a><td>exports.describe = global.describe;<tr><td><a name="l176" href="#l176">176</a><td><tr><td><a name="l177" href="#l177">177</a><td>/**<tr><td><a name="l178" href="#l178">178</a><td> * Defines a suppressed test suite.<tr><td><a name="l179" href="#l179">179</a><td> * @param {string} name The suite name.<tr><td><a name="l180" href="#l180">180</a><td> * @param {function()=} fn The suite function, or {@code undefined} to define<tr><td><a name="l181" href="#l181">181</a><td> *     a pending test suite.<tr><td><a name="l182" href="#l182">182</a><td> */<tr><td><a name="l183" href="#l183">183</a><td>exports.xdescribe = global.xdescribe;<tr><td><a name="l184" href="#l184">184</a><td>exports.describe.skip = global.describe.skip;<tr><td><a name="l185" href="#l185">185</a><td><tr><td><a name="l186" href="#l186">186</a><td>/**<tr><td><a name="l187" href="#l187">187</a><td> * Register a function to call after the current suite finishes.<tr><td><a name="l188" href="#l188">188</a><td> * @param {function()} fn .<tr><td><a name="l189" href="#l189">189</a><td> */<tr><td><a name="l190" href="#l190">190</a><td>exports.after = wrapped(global.after);<tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td>/**<tr><td><a name="l193" href="#l193">193</a><td> * Register a function to call after each test in a suite.<tr><td><a name="l194" href="#l194">194</a><td> * @param {function()} fn .<tr><td><a name="l195" href="#l195">195</a><td> */<tr><td><a name="l196" href="#l196">196</a><td>exports.afterEach = wrapped(global.afterEach);<tr><td><a name="l197" href="#l197">197</a><td><tr><td><a name="l198" href="#l198">198</a><td>/**<tr><td><a name="l199" href="#l199">199</a><td> * Register a function to call before the current suite starts.<tr><td><a name="l200" href="#l200">200</a><td> * @param {function()} fn .<tr><td><a name="l201" href="#l201">201</a><td> */<tr><td><a name="l202" href="#l202">202</a><td>exports.before = wrapped(global.before);<tr><td><a name="l203" href="#l203">203</a><td><tr><td><a name="l204" href="#l204">204</a><td>/**<tr><td><a name="l205" href="#l205">205</a><td> * Register a function to call before each test in a suite.<tr><td><a name="l206" href="#l206">206</a><td> * @param {function()} fn .<tr><td><a name="l207" href="#l207">207</a><td> */<tr><td><a name="l208" href="#l208">208</a><td>exports.beforeEach = wrapped(global.beforeEach);<tr><td><a name="l209" href="#l209">209</a><td><tr><td><a name="l210" href="#l210">210</a><td>/**<tr><td><a name="l211" href="#l211">211</a><td> * Add a test to the current suite.<tr><td><a name="l212" href="#l212">212</a><td> * @param {string} name The test name.<tr><td><a name="l213" href="#l213">213</a><td> * @param {function()=} fn The test function, or {@code undefined} to define<tr><td><a name="l214" href="#l214">214</a><td> *     a pending test case.<tr><td><a name="l215" href="#l215">215</a><td> */<tr><td><a name="l216" href="#l216">216</a><td>exports.it = wrapped(global.it);<tr><td><a name="l217" href="#l217">217</a><td><tr><td><a name="l218" href="#l218">218</a><td>/**<tr><td><a name="l219" href="#l219">219</a><td> * An alias for {@link #it()} that flags the test as the only one that should<tr><td><a name="l220" href="#l220">220</a><td> * be run within the current suite.<tr><td><a name="l221" href="#l221">221</a><td> * @param {string} name The test name.<tr><td><a name="l222" href="#l222">222</a><td> * @param {function()=} fn The test function, or {@code undefined} to define<tr><td><a name="l223" href="#l223">223</a><td> *     a pending test case.<tr><td><a name="l224" href="#l224">224</a><td> */<tr><td><a name="l225" href="#l225">225</a><td>exports.iit = exports.it.only = wrapped(global.it.only);<tr><td><a name="l226" href="#l226">226</a><td><tr><td><a name="l227" href="#l227">227</a><td>/**<tr><td><a name="l228" href="#l228">228</a><td> * Adds a test to the current suite while suppressing it so it is not run.<tr><td><a name="l229" href="#l229">229</a><td> * @param {string} name The test name.<tr><td><a name="l230" href="#l230">230</a><td> * @param {function()=} fn The test function, or {@code undefined} to define<tr><td><a name="l231" href="#l231">231</a><td> *     a pending test case.<tr><td><a name="l232" href="#l232">232</a><td> */<tr><td><a name="l233" href="#l233">233</a><td>exports.xit = exports.it.skip = wrapped(global.xit);<tr><td><a name="l234" href="#l234">234</a><td><tr><td><a name="l235" href="#l235">235</a><td>exports.ignore = ignore;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>No data</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>No data</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>No data</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../types.js"></script><script src="../../dossier.js"></script>
\ No newline at end of file
+<!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>index.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>testing/index.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements.  See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership.  The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License.  You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>//   http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied.  See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<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> * @fileoverview Provides wrappers around the following global functions from<tr><td><a id="l20"></a><a href="#l20">20</a><td> * [Mocha&#39;s BDD interface](https://github.com/mochajs/mocha):<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * - after<tr><td><a id="l23"></a><a href="#l23">23</a><td> * - afterEach<tr><td><a id="l24"></a><a href="#l24">24</a><td> * - before<tr><td><a id="l25"></a><a href="#l25">25</a><td> * - beforeEach<tr><td><a id="l26"></a><a href="#l26">26</a><td> * - it<tr><td><a id="l27"></a><a href="#l27">27</a><td> * - it.only<tr><td><a id="l28"></a><a href="#l28">28</a><td> * - it.skip<tr><td><a id="l29"></a><a href="#l29">29</a><td> * - xit<tr><td><a id="l30"></a><a href="#l30">30</a><td> *<tr><td><a id="l31"></a><a href="#l31">31</a><td> * The provided wrappers leverage the {@link webdriver.promise.ControlFlow}<tr><td><a id="l32"></a><a href="#l32">32</a><td> * to simplify writing asynchronous tests:<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> *     var By = require(&#39;selenium-webdriver&#39;).By,<tr><td><a id="l35"></a><a href="#l35">35</a><td> *         until = require(&#39;selenium-webdriver&#39;).until,<tr><td><a id="l36"></a><a href="#l36">36</a><td> *         firefox = require(&#39;selenium-webdriver/firefox&#39;),<tr><td><a id="l37"></a><a href="#l37">37</a><td> *         test = require(&#39;selenium-webdriver/testing&#39;);<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> *     test.describe(&#39;Google Search&#39;, function() {<tr><td><a id="l40"></a><a href="#l40">40</a><td> *       var driver;<tr><td><a id="l41"></a><a href="#l41">41</a><td> *<tr><td><a id="l42"></a><a href="#l42">42</a><td> *       test.before(function() {<tr><td><a id="l43"></a><a href="#l43">43</a><td> *         driver = new firefox.Driver();<tr><td><a id="l44"></a><a href="#l44">44</a><td> *       });<tr><td><a id="l45"></a><a href="#l45">45</a><td> *<tr><td><a id="l46"></a><a href="#l46">46</a><td> *       test.after(function() {<tr><td><a id="l47"></a><a href="#l47">47</a><td> *         driver.quit();<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> *       test.it(&#39;should append query to title&#39;, function() {<tr><td><a id="l51"></a><a href="#l51">51</a><td> *         driver.get(&#39;http://www.google.com/ncr&#39;);<tr><td><a id="l52"></a><a href="#l52">52</a><td> *         driver.findElement(By.name(&#39;q&#39;)).sendKeys(&#39;webdriver&#39;);<tr><td><a id="l53"></a><a href="#l53">53</a><td> *         driver.findElement(By.name(&#39;btnG&#39;)).click();<tr><td><a id="l54"></a><a href="#l54">54</a><td> *         driver.wait(until.titleIs(&#39;webdriver - Google Search&#39;), 1000);<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> *<tr><td><a id="l58"></a><a href="#l58">58</a><td> * You may conditionally suppress a test function using the exported<tr><td><a id="l59"></a><a href="#l59">59</a><td> * &quot;ignore&quot; function. If the provided predicate returns true, the attached<tr><td><a id="l60"></a><a href="#l60">60</a><td> * test case will be skipped:<tr><td><a id="l61"></a><a href="#l61">61</a><td> *<tr><td><a id="l62"></a><a href="#l62">62</a><td> *     test.ignore(maybe()).it(&#39;is flaky&#39;, function() {<tr><td><a id="l63"></a><a href="#l63">63</a><td> *       if (Math.random() &lt; 0.5) throw Error();<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> *     function maybe() { return Math.random() &lt; 0.5; }<tr><td><a id="l67"></a><a href="#l67">67</a><td> */<tr><td><a id="l68"></a><a href="#l68">68</a><td><tr><td><a id="l69"></a><a href="#l69">69</a><td>var promise = require(&#39;..&#39;).promise;<tr><td><a id="l70"></a><a href="#l70">70</a><td>var flow = promise.controlFlow();<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> * Wraps a function so that all passed arguments are ignored.<tr><td><a id="l75"></a><a href="#l75">75</a><td> * @param {!Function} fn The function to wrap.<tr><td><a id="l76"></a><a href="#l76">76</a><td> * @return {!Function} The wrapped function.<tr><td><a id="l77"></a><a href="#l77">77</a><td> */<tr><td><a id="l78"></a><a href="#l78">78</a><td>function seal(fn) {<tr><td><a id="l79"></a><a href="#l79">79</a><td>  return function() {<tr><td><a id="l80"></a><a href="#l80">80</a><td>    fn();<tr><td><a id="l81"></a><a href="#l81">81</a><td>  };<tr><td><a id="l82"></a><a href="#l82">82</a><td>}<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/**<tr><td><a id="l86"></a><a href="#l86">86</a><td> * Wraps a function on Mocha&#39;s BDD interface so it runs inside a<tr><td><a id="l87"></a><a href="#l87">87</a><td> * webdriver.promise.ControlFlow and waits for the flow to complete before<tr><td><a id="l88"></a><a href="#l88">88</a><td> * continuing.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * @param {!Function} globalFn The function to wrap.<tr><td><a id="l90"></a><a href="#l90">90</a><td> * @return {!Function} The new function.<tr><td><a id="l91"></a><a href="#l91">91</a><td> */<tr><td><a id="l92"></a><a href="#l92">92</a><td>function wrapped(globalFn) {<tr><td><a id="l93"></a><a href="#l93">93</a><td>  return function() {<tr><td><a id="l94"></a><a href="#l94">94</a><td>    if (arguments.length === 1) {<tr><td><a id="l95"></a><a href="#l95">95</a><td>      return globalFn(makeAsyncTestFn(arguments[0]));<tr><td><a id="l96"></a><a href="#l96">96</a><td>    }<tr><td><a id="l97"></a><a href="#l97">97</a><td>    else if (arguments.length === 2) {<tr><td><a id="l98"></a><a href="#l98">98</a><td>      return globalFn(arguments[0], makeAsyncTestFn(arguments[1]));<tr><td><a id="l99"></a><a href="#l99">99</a><td>    }<tr><td><a id="l100"></a><a href="#l100">100</a><td>    else {<tr><td><a id="l101"></a><a href="#l101">101</a><td>      throw Error(&#39;Invalid # arguments: &#39; + arguments.length);<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><tr><td><a id="l106"></a><a href="#l106">106</a><td>/**<tr><td><a id="l107"></a><a href="#l107">107</a><td> * Make a wrapper to invoke caller&#39;s test function, fn.  Run the test function<tr><td><a id="l108"></a><a href="#l108">108</a><td> * within a ControlFlow.<tr><td><a id="l109"></a><a href="#l109">109</a><td> *<tr><td><a id="l110"></a><a href="#l110">110</a><td> * Should preserve the semantics of Mocha&#39;s Runnable.prototype.run (See<tr><td><a id="l111"></a><a href="#l111">111</a><td> * https://github.com/mochajs/mocha/blob/master/lib/runnable.js#L192)<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 {Function} fn<tr><td><a id="l114"></a><a href="#l114">114</a><td> * @return {Function}<tr><td><a id="l115"></a><a href="#l115">115</a><td> */<tr><td><a id="l116"></a><a href="#l116">116</a><td>function makeAsyncTestFn(fn) {<tr><td><a id="l117"></a><a href="#l117">117</a><td>  var async = fn.length &gt; 0; // if test function expects a callback, its &quot;async&quot;<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td>  var ret = function(done) {<tr><td><a id="l120"></a><a href="#l120">120</a><td>    var runnable = this.runnable();<tr><td><a id="l121"></a><a href="#l121">121</a><td>    var mochaCallback = runnable.callback;<tr><td><a id="l122"></a><a href="#l122">122</a><td>    runnable.callback = function() {<tr><td><a id="l123"></a><a href="#l123">123</a><td>      flow.reset();<tr><td><a id="l124"></a><a href="#l124">124</a><td>      return mochaCallback.apply(this, arguments);<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>    var testFn = fn.bind(this);<tr><td><a id="l128"></a><a href="#l128">128</a><td>    flow.execute(function controlFlowExecute() {<tr><td><a id="l129"></a><a href="#l129">129</a><td>      return new promise.Promise(function(fulfill, reject) {<tr><td><a id="l130"></a><a href="#l130">130</a><td>        if (async) {<tr><td><a id="l131"></a><a href="#l131">131</a><td>          // If testFn is async (it expects a done callback), resolve the promise of this<tr><td><a id="l132"></a><a href="#l132">132</a><td>          // test whenever that callback says to.  Any promises returned from testFn are<tr><td><a id="l133"></a><a href="#l133">133</a><td>          // ignored.<tr><td><a id="l134"></a><a href="#l134">134</a><td>          testFn(function testFnDoneCallback(err) {<tr><td><a id="l135"></a><a href="#l135">135</a><td>            if (err) {<tr><td><a id="l136"></a><a href="#l136">136</a><td>              reject(err);<tr><td><a id="l137"></a><a href="#l137">137</a><td>            } else {<tr><td><a id="l138"></a><a href="#l138">138</a><td>              fulfill();<tr><td><a id="l139"></a><a href="#l139">139</a><td>            }<tr><td><a id="l140"></a><a href="#l140">140</a><td>          });<tr><td><a id="l141"></a><a href="#l141">141</a><td>        } else {<tr><td><a id="l142"></a><a href="#l142">142</a><td>          // Without a callback, testFn can return a promise, or it will<tr><td><a id="l143"></a><a href="#l143">143</a><td>          // be assumed to have completed synchronously<tr><td><a id="l144"></a><a href="#l144">144</a><td>          fulfill(testFn());<tr><td><a id="l145"></a><a href="#l145">145</a><td>        }<tr><td><a id="l146"></a><a href="#l146">146</a><td>      }, flow);<tr><td><a id="l147"></a><a href="#l147">147</a><td>    }, runnable.fullTitle()).then(seal(done), done);<tr><td><a id="l148"></a><a href="#l148">148</a><td>  };<tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>  ret.toString = function() {<tr><td><a id="l151"></a><a href="#l151">151</a><td>    return fn.toString();<tr><td><a id="l152"></a><a href="#l152">152</a><td>  };<tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td>  return ret;<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> * Ignores the test chained to this function if the provided predicate returns<tr><td><a id="l160"></a><a href="#l160">160</a><td> * true.<tr><td><a id="l161"></a><a href="#l161">161</a><td> * @param {function(): boolean} predicateFn A predicate to call to determine<tr><td><a id="l162"></a><a href="#l162">162</a><td> *     if the test should be suppressed. This function MUST be synchronous.<tr><td><a id="l163"></a><a href="#l163">163</a><td> * @return {!Object} An object with wrapped versions of {@link #it()} and<tr><td><a id="l164"></a><a href="#l164">164</a><td> *     {@link #describe()} that ignore tests as indicated by the predicate.<tr><td><a id="l165"></a><a href="#l165">165</a><td> */<tr><td><a id="l166"></a><a href="#l166">166</a><td>function ignore(predicateFn) {<tr><td><a id="l167"></a><a href="#l167">167</a><td>  var describe = wrap(exports.xdescribe, exports.describe);<tr><td><a id="l168"></a><a href="#l168">168</a><td>  describe.only = wrap(exports.xdescribe, exports.describe.only);<tr><td><a id="l169"></a><a href="#l169">169</a><td><tr><td><a id="l170"></a><a href="#l170">170</a><td>  var it = wrap(exports.xit, exports.it);<tr><td><a id="l171"></a><a href="#l171">171</a><td>  it.only = wrap(exports.xit, exports.it.only);<tr><td><a id="l172"></a><a href="#l172">172</a><td><tr><td><a id="l173"></a><a href="#l173">173</a><td>  return {<tr><td><a id="l174"></a><a href="#l174">174</a><td>    describe: describe,<tr><td><a id="l175"></a><a href="#l175">175</a><td>    it: it<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>  function wrap(onSkip, onRun) {<tr><td><a id="l179"></a><a href="#l179">179</a><td>    return function(title, fn) {<tr><td><a id="l180"></a><a href="#l180">180</a><td>      if (predicateFn()) {<tr><td><a id="l181"></a><a href="#l181">181</a><td>        onSkip(title, fn);<tr><td><a id="l182"></a><a href="#l182">182</a><td>      } else {<tr><td><a id="l183"></a><a href="#l183">183</a><td>        onRun(title, fn);<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><tr><td><a id="l190"></a><a href="#l190">190</a><td>// PUBLIC API<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> * Registers a new test suite.<tr><td><a id="l194"></a><a href="#l194">194</a><td> * @param {string} name The suite name.<tr><td><a id="l195"></a><a href="#l195">195</a><td> * @param {function()=} fn The suite function, or {@code undefined} to define<tr><td><a id="l196"></a><a href="#l196">196</a><td> *     a pending test suite.<tr><td><a id="l197"></a><a href="#l197">197</a><td> */<tr><td><a id="l198"></a><a href="#l198">198</a><td>exports.describe = global.describe;<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> * Defines a suppressed test suite.<tr><td><a id="l202"></a><a href="#l202">202</a><td> * @param {string} name The suite name.<tr><td><a id="l203"></a><a href="#l203">203</a><td> * @param {function()=} fn The suite function, or {@code undefined} to define<tr><td><a id="l204"></a><a href="#l204">204</a><td> *     a pending test suite.<tr><td><a id="l205"></a><a href="#l205">205</a><td> */<tr><td><a id="l206"></a><a href="#l206">206</a><td>exports.xdescribe = global.xdescribe;<tr><td><a id="l207"></a><a href="#l207">207</a><td>exports.describe.skip = global.describe.skip;<tr><td><a id="l208"></a><a href="#l208">208</a><td><tr><td><a id="l209"></a><a href="#l209">209</a><td>/**<tr><td><a id="l210"></a><a href="#l210">210</a><td> * Register a function to call after the current suite finishes.<tr><td><a id="l211"></a><a href="#l211">211</a><td> * @param {function()} fn .<tr><td><a id="l212"></a><a href="#l212">212</a><td> */<tr><td><a id="l213"></a><a href="#l213">213</a><td>exports.after = wrapped(global.after);<tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td>/**<tr><td><a id="l216"></a><a href="#l216">216</a><td> * Register a function to call after each test in a suite.<tr><td><a id="l217"></a><a href="#l217">217</a><td> * @param {function()} fn .<tr><td><a id="l218"></a><a href="#l218">218</a><td> */<tr><td><a id="l219"></a><a href="#l219">219</a><td>exports.afterEach = wrapped(global.afterEach);<tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td>/**<tr><td><a id="l222"></a><a href="#l222">222</a><td> * Register a function to call before the current suite starts.<tr><td><a id="l223"></a><a href="#l223">223</a><td> * @param {function()} fn .<tr><td><a id="l224"></a><a href="#l224">224</a><td> */<tr><td><a id="l225"></a><a href="#l225">225</a><td>exports.before = wrapped(global.before);<tr><td><a id="l226"></a><a href="#l226">226</a><td><tr><td><a id="l227"></a><a href="#l227">227</a><td>/**<tr><td><a id="l228"></a><a href="#l228">228</a><td> * Register a function to call before each test in a suite.<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @param {function()} fn .<tr><td><a id="l230"></a><a href="#l230">230</a><td> */<tr><td><a id="l231"></a><a href="#l231">231</a><td>exports.beforeEach = wrapped(global.beforeEach);<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> * Add a test to the current suite.<tr><td><a id="l235"></a><a href="#l235">235</a><td> * @param {string} name The test name.<tr><td><a id="l236"></a><a href="#l236">236</a><td> * @param {function()=} fn The test function, or {@code undefined} to define<tr><td><a id="l237"></a><a href="#l237">237</a><td> *     a pending test case.<tr><td><a id="l238"></a><a href="#l238">238</a><td> */<tr><td><a id="l239"></a><a href="#l239">239</a><td>exports.it = wrapped(global.it);<tr><td><a id="l240"></a><a href="#l240">240</a><td><tr><td><a id="l241"></a><a href="#l241">241</a><td>/**<tr><td><a id="l242"></a><a href="#l242">242</a><td> * An alias for {@link #it()} that flags the test as the only one that should<tr><td><a id="l243"></a><a href="#l243">243</a><td> * be run within the current suite.<tr><td><a id="l244"></a><a href="#l244">244</a><td> * @param {string} name The test name.<tr><td><a id="l245"></a><a href="#l245">245</a><td> * @param {function()=} fn The test function, or {@code undefined} to define<tr><td><a id="l246"></a><a href="#l246">246</a><td> *     a pending test case.<tr><td><a id="l247"></a><a href="#l247">247</a><td> */<tr><td><a id="l248"></a><a href="#l248">248</a><td>exports.iit = exports.it.only = wrapped(global.it.only);<tr><td><a id="l249"></a><a href="#l249">249</a><td><tr><td><a id="l250"></a><a href="#l250">250</a><td>/**<tr><td><a id="l251"></a><a href="#l251">251</a><td> * Adds a test to the current suite while suppressing it so it is not run.<tr><td><a id="l252"></a><a href="#l252">252</a><td> * @param {string} name The test name.<tr><td><a id="l253"></a><a href="#l253">253</a><td> * @param {function()=} fn The test function, or {@code undefined} to define<tr><td><a id="l254"></a><a href="#l254">254</a><td> *     a pending test case.<tr><td><a id="l255"></a><a href="#l255">255</a><td> */<tr><td><a id="l256"></a><a href="#l256">256</a><td>exports.xit = exports.it.skip = wrapped(global.xit);<tr><td><a id="l257"></a><a href="#l257">257</a><td><tr><td><a id="l258"></a><a href="#l258">258</a><td>exports.ignore = ignore;</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>
\ No newline at end of file
diff --git a/docs/types.js b/docs/types.js
index 88ff729..9eab2ee 100644
--- a/docs/types.js
+++ b/docs/types.js
@@ -1 +1 @@
-var TYPES = {"files":[{"name":"_base.js","href":"source/_base.js.src.html"},{"name":"builder.js","href":"source/builder.js.src.html"},{"name":"chrome.js","href":"source/chrome.js.src.html"},{"name":"error.js","href":"source/error.js.src.html"},{"name":"executors.js","href":"source/executors.js.src.html"},{"name":"http/index.js","href":"source/http/index.js.src.html"},{"name":"http/util.js","href":"source/http/util.js.src.html"},{"name":"index.js","href":"source/index.js.src.html"},{"name":"io/index.js","href":"source/io/index.js.src.html"},{"name":"lib/atoms/error.js","href":"source/lib/atoms/error.js.src.html"},{"name":"lib/atoms/json.js","href":"source/lib/atoms/json.js.src.html"},{"name":"lib/atoms/response.js","href":"source/lib/atoms/response.js.src.html"},{"name":"lib/atoms/userAgent.js","href":"source/lib/atoms/userAgent.js.src.html"},{"name":"lib/goog/array/array.js","href":"source/lib/goog/array/array.js.src.html"},{"name":"lib/goog/asserts/asserts.js","href":"source/lib/goog/asserts/asserts.js.src.html"},{"name":"lib/goog/base.js","href":"source/lib/goog/base.js.src.html"},{"name":"lib/goog/debug/error.js","href":"source/lib/goog/debug/error.js.src.html"},{"name":"lib/goog/deps.js","href":"source/lib/goog/deps.js.src.html"},{"name":"lib/goog/iter/iter.js","href":"source/lib/goog/iter/iter.js.src.html"},{"name":"lib/goog/json/json.js","href":"source/lib/goog/json/json.js.src.html"},{"name":"lib/goog/labs/testing/assertthat.js","href":"source/lib/goog/labs/testing/assertthat.js.src.html"},{"name":"lib/goog/labs/testing/logicmatcher.js","href":"source/lib/goog/labs/testing/logicmatcher.js.src.html"},{"name":"lib/goog/labs/testing/matcher.js","href":"source/lib/goog/labs/testing/matcher.js.src.html"},{"name":"lib/goog/labs/testing/numbermatcher.js","href":"source/lib/goog/labs/testing/numbermatcher.js.src.html"},{"name":"lib/goog/labs/testing/objectmatcher.js","href":"source/lib/goog/labs/testing/objectmatcher.js.src.html"},{"name":"lib/goog/labs/testing/stringmatcher.js","href":"source/lib/goog/labs/testing/stringmatcher.js.src.html"},{"name":"lib/goog/net/wrapperxmlhttpfactory.js","href":"source/lib/goog/net/wrapperxmlhttpfactory.js.src.html"},{"name":"lib/goog/net/xmlhttp.js","href":"source/lib/goog/net/xmlhttp.js.src.html"},{"name":"lib/goog/net/xmlhttpfactory.js","href":"source/lib/goog/net/xmlhttpfactory.js.src.html"},{"name":"lib/goog/object/object.js","href":"source/lib/goog/object/object.js.src.html"},{"name":"lib/goog/string/string.js","href":"source/lib/goog/string/string.js.src.html"},{"name":"lib/goog/structs/map.js","href":"source/lib/goog/structs/map.js.src.html"},{"name":"lib/goog/structs/structs.js","href":"source/lib/goog/structs/structs.js.src.html"},{"name":"lib/goog/uri/uri.js","href":"source/lib/goog/uri/uri.js.src.html"},{"name":"lib/goog/uri/utils.js","href":"source/lib/goog/uri/utils.js.src.html"},{"name":"lib/goog/useragent/product.js","href":"source/lib/goog/useragent/product.js.src.html"},{"name":"lib/goog/useragent/product_isversion.js","href":"source/lib/goog/useragent/product_isversion.js.src.html"},{"name":"lib/goog/useragent/useragent.js","href":"source/lib/goog/useragent/useragent.js.src.html"},{"name":"lib/webdriver/abstractbuilder.js","href":"source/lib/webdriver/abstractbuilder.js.src.html"},{"name":"lib/webdriver/actionsequence.js","href":"source/lib/webdriver/actionsequence.js.src.html"},{"name":"lib/webdriver/builder.js","href":"source/lib/webdriver/builder.js.src.html"},{"name":"lib/webdriver/button.js","href":"source/lib/webdriver/button.js.src.html"},{"name":"lib/webdriver/capabilities.js","href":"source/lib/webdriver/capabilities.js.src.html"},{"name":"lib/webdriver/command.js","href":"source/lib/webdriver/command.js.src.html"},{"name":"lib/webdriver/events.js","href":"source/lib/webdriver/events.js.src.html"},{"name":"lib/webdriver/firefoxdomexecutor.js","href":"source/lib/webdriver/firefoxdomexecutor.js.src.html"},{"name":"lib/webdriver/http/corsclient.js","href":"source/lib/webdriver/http/corsclient.js.src.html"},{"name":"lib/webdriver/http/http.js","href":"source/lib/webdriver/http/http.js.src.html"},{"name":"lib/webdriver/http/xhrclient.js","href":"source/lib/webdriver/http/xhrclient.js.src.html"},{"name":"lib/webdriver/key.js","href":"source/lib/webdriver/key.js.src.html"},{"name":"lib/webdriver/locators.js","href":"source/lib/webdriver/locators.js.src.html"},{"name":"lib/webdriver/logging.js","href":"source/lib/webdriver/logging.js.src.html"},{"name":"lib/webdriver/process.js","href":"source/lib/webdriver/process.js.src.html"},{"name":"lib/webdriver/promise.js","href":"source/lib/webdriver/promise.js.src.html"},{"name":"lib/webdriver/session.js","href":"source/lib/webdriver/session.js.src.html"},{"name":"lib/webdriver/stacktrace.js","href":"source/lib/webdriver/stacktrace.js.src.html"},{"name":"lib/webdriver/testing/asserts.js","href":"source/lib/webdriver/testing/asserts.js.src.html"},{"name":"lib/webdriver/webdriver.js","href":"source/lib/webdriver/webdriver.js.src.html"},{"name":"net/index.js","href":"source/net/index.js.src.html"},{"name":"net/portprober.js","href":"source/net/portprober.js.src.html"},{"name":"phantomjs.js","href":"source/phantomjs.js.src.html"},{"name":"proxy.js","href":"source/proxy.js.src.html"},{"name":"remote/index.js","href":"source/remote/index.js.src.html"},{"name":"testing/assert.js","href":"source/testing/assert.js.src.html"},{"name":"testing/index.js","href":"source/testing/index.js.src.html"}],"types":[{"isInterface":false,"name":"bot","isTypedef":false,"href":"namespace_bot.html"},{"isInterface":false,"name":"bot.Error","isTypedef":false,"href":"class_bot_Error.html"},{"isInterface":false,"name":"bot.Error.State","isTypedef":false,"href":"enum_bot_Error_State.html"},{"isInterface":false,"name":"bot.ErrorCode","isTypedef":false,"href":"enum_bot_ErrorCode.html"},{"isInterface":false,"name":"bot.json","isTypedef":false,"href":"namespace_bot_json.html"},{"isInterface":false,"name":"bot.response","isTypedef":false,"href":"namespace_bot_response.html"},{"name":"bot.response.ResponseObject","isTypedef":true,"href":"namespace_bot_response.html#bot.response.ResponseObject"},{"isInterface":false,"name":"bot.userAgent","isTypedef":false,"href":"namespace_bot_userAgent.html"},{"isInterface":false,"name":"goog","isTypedef":false,"href":"namespace_goog.html"},{"isInterface":false,"name":"goog.Uri","isTypedef":false,"href":"class_goog_Uri.html"},{"isInterface":false,"name":"goog.Uri.QueryData","isTypedef":false,"href":"class_goog_Uri_QueryData.html"},{"isInterface":false,"name":"goog.array","isTypedef":false,"href":"namespace_goog_array.html"},{"name":"goog.array.ArrayLike","isTypedef":true,"href":"namespace_goog_array.html#goog.array.ArrayLike"},{"isInterface":false,"name":"goog.asserts","isTypedef":false,"href":"namespace_goog_asserts.html"},{"isInterface":false,"name":"goog.asserts.AssertionError","isTypedef":false,"href":"class_goog_asserts_AssertionError.html"},{"isInterface":false,"name":"goog.debug","isTypedef":false,"href":"namespace_goog_debug.html"},{"isInterface":false,"name":"goog.debug.Error","isTypedef":false,"href":"class_goog_debug_Error.html"},{"isInterface":false,"name":"goog.iter","isTypedef":false,"href":"namespace_goog_iter.html"},{"name":"goog.iter.Iterable","isTypedef":true,"href":"namespace_goog_iter.html#goog.iter.Iterable"},{"isInterface":false,"name":"goog.iter.Iterator","isTypedef":false,"href":"class_goog_iter_Iterator.html"},{"isInterface":false,"name":"goog.json","isTypedef":false,"href":"namespace_goog_json.html"},{"name":"goog.json.Replacer","isTypedef":true,"href":"namespace_goog_json.html#goog.json.Replacer"},{"name":"goog.json.Reviver","isTypedef":true,"href":"namespace_goog_json.html#goog.json.Reviver"},{"isInterface":false,"name":"goog.json.Serializer","isTypedef":false,"href":"class_goog_json_Serializer.html"},{"isInterface":false,"name":"goog.labs","isTypedef":false,"href":"namespace_goog_labs.html"},{"isInterface":false,"name":"goog.labs.testing","isTypedef":false,"href":"namespace_goog_labs_testing.html"},{"isInterface":false,"name":"goog.labs.testing.AllOfMatcher","isTypedef":false,"href":"class_goog_labs_testing_AllOfMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.AnyOfMatcher","isTypedef":false,"href":"class_goog_labs_testing_AnyOfMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.CloseToMatcher","isTypedef":false,"href":"class_goog_labs_testing_CloseToMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.ContainsStringMatcher","isTypedef":false,"href":"class_goog_labs_testing_ContainsStringMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.EndsWithMatcher","isTypedef":false,"href":"class_goog_labs_testing_EndsWithMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.EqualToIgnoringWhitespaceMatcher","isTypedef":false,"href":"class_goog_labs_testing_EqualToIgnoringWhitespaceMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.EqualToMatcher","isTypedef":false,"href":"class_goog_labs_testing_EqualToMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.EqualsMatcher","isTypedef":false,"href":"class_goog_labs_testing_EqualsMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.GreaterThanEqualToMatcher","isTypedef":false,"href":"class_goog_labs_testing_GreaterThanEqualToMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.GreaterThanMatcher","isTypedef":false,"href":"class_goog_labs_testing_GreaterThanMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.HasPropertyMatcher","isTypedef":false,"href":"class_goog_labs_testing_HasPropertyMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.InstanceOfMatcher","isTypedef":false,"href":"class_goog_labs_testing_InstanceOfMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.IsNotMatcher","isTypedef":false,"href":"class_goog_labs_testing_IsNotMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.IsNullMatcher","isTypedef":false,"href":"class_goog_labs_testing_IsNullMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.IsNullOrUndefinedMatcher","isTypedef":false,"href":"class_goog_labs_testing_IsNullOrUndefinedMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.IsUndefinedMatcher","isTypedef":false,"href":"class_goog_labs_testing_IsUndefinedMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.LessThanEqualToMatcher","isTypedef":false,"href":"class_goog_labs_testing_LessThanEqualToMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.LessThanMatcher","isTypedef":false,"href":"class_goog_labs_testing_LessThanMatcher.html"},{"isInterface":true,"name":"goog.labs.testing.Matcher","isTypedef":false,"href":"interface_goog_labs_testing_Matcher.html"},{"isInterface":false,"name":"goog.labs.testing.MatcherError","isTypedef":false,"href":"class_goog_labs_testing_MatcherError.html"},{"isInterface":false,"name":"goog.labs.testing.ObjectEqualsMatcher","isTypedef":false,"href":"class_goog_labs_testing_ObjectEqualsMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.RegexMatcher","isTypedef":false,"href":"class_goog_labs_testing_RegexMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.StartsWithMatcher","isTypedef":false,"href":"class_goog_labs_testing_StartsWithMatcher.html"},{"isInterface":false,"name":"goog.labs.testing.StringContainsInOrderMatcher","isTypedef":false,"href":"class_goog_labs_testing_StringContainsInOrderMatcher.html"},{"isInterface":false,"name":"goog.net","isTypedef":false,"href":"namespace_goog_net.html"},{"isInterface":false,"name":"goog.net.DefaultXmlHttpFactory","isTypedef":false,"href":"class_goog_net_DefaultXmlHttpFactory.html"},{"isInterface":false,"name":"goog.net.WrapperXmlHttpFactory","isTypedef":false,"href":"class_goog_net_WrapperXmlHttpFactory.html"},{"isInterface":false,"name":"goog.net.XmlHttp","isTypedef":false,"href":"namespace_goog_net_XmlHttp.html"},{"isInterface":false,"name":"goog.net.XmlHttp.OptionType","isTypedef":false,"href":"enum_goog_net_XmlHttp_OptionType.html"},{"isInterface":false,"name":"goog.net.XmlHttp.ReadyState","isTypedef":false,"href":"enum_goog_net_XmlHttp_ReadyState.html"},{"isInterface":false,"name":"goog.net.XmlHttpFactory","isTypedef":false,"href":"class_goog_net_XmlHttpFactory.html"},{"isInterface":false,"name":"goog.object","isTypedef":false,"href":"namespace_goog_object.html"},{"isInterface":false,"name":"goog.string","isTypedef":false,"href":"namespace_goog_string.html"},{"isInterface":false,"name":"goog.string.Unicode","isTypedef":false,"href":"enum_goog_string_Unicode.html"},{"isInterface":false,"name":"goog.structs","isTypedef":false,"href":"namespace_goog_structs.html"},{"isInterface":false,"name":"goog.structs.Map","isTypedef":false,"href":"class_goog_structs_Map.html"},{"isInterface":false,"name":"goog.uri","isTypedef":false,"href":"namespace_goog_uri.html"},{"isInterface":false,"name":"goog.uri.utils","isTypedef":false,"href":"namespace_goog_uri_utils.html"},{"name":"goog.uri.utils.QueryArray","isTypedef":true,"href":"namespace_goog_uri_utils.html#goog.uri.utils.QueryArray"},{"name":"goog.uri.utils.QueryValue","isTypedef":true,"href":"namespace_goog_uri_utils.html#goog.uri.utils.QueryValue"},{"isInterface":false,"name":"goog.uri.utils.CharCode_","isTypedef":false,"href":"enum_goog_uri_utils_CharCode_.html"},{"isInterface":false,"name":"goog.uri.utils.ComponentIndex","isTypedef":false,"href":"enum_goog_uri_utils_ComponentIndex.html"},{"isInterface":false,"name":"goog.uri.utils.StandardQueryParam","isTypedef":false,"href":"enum_goog_uri_utils_StandardQueryParam.html"},{"isInterface":false,"name":"goog.userAgent","isTypedef":false,"href":"namespace_goog_userAgent.html"},{"isInterface":false,"name":"goog.userAgent.product","isTypedef":false,"href":"namespace_goog_userAgent_product.html"},{"isInterface":false,"name":"webdriver","isTypedef":false,"href":"namespace_webdriver.html"},{"isInterface":false,"name":"webdriver.AbstractBuilder","isTypedef":false,"href":"class_webdriver_AbstractBuilder.html"},{"isInterface":false,"name":"webdriver.ActionSequence","isTypedef":false,"href":"class_webdriver_ActionSequence.html"},{"isInterface":false,"name":"webdriver.Alert","isTypedef":false,"href":"class_webdriver_Alert.html"},{"isInterface":false,"name":"webdriver.Browser","isTypedef":false,"href":"enum_webdriver_Browser.html"},{"isInterface":false,"name":"webdriver.Builder","isTypedef":false,"href":"class_webdriver_Builder.html"},{"isInterface":false,"name":"webdriver.Button","isTypedef":false,"href":"enum_webdriver_Button.html"},{"isInterface":false,"name":"webdriver.By","isTypedef":false,"href":"namespace_webdriver_By.html"},{"name":"webdriver.By.Hash","isTypedef":true,"href":"namespace_webdriver_By.html#webdriver.By.Hash"},{"isInterface":false,"name":"webdriver.Capabilities","isTypedef":false,"href":"class_webdriver_Capabilities.html"},{"isInterface":false,"name":"webdriver.Capability","isTypedef":false,"href":"enum_webdriver_Capability.html"},{"isInterface":false,"name":"webdriver.Command","isTypedef":false,"href":"class_webdriver_Command.html"},{"isInterface":true,"name":"webdriver.CommandExecutor","isTypedef":false,"href":"interface_webdriver_CommandExecutor.html"},{"isInterface":false,"name":"webdriver.CommandName","isTypedef":false,"href":"enum_webdriver_CommandName.html"},{"isInterface":false,"name":"webdriver.EventEmitter","isTypedef":false,"href":"class_webdriver_EventEmitter.html"},{"isInterface":false,"name":"webdriver.FirefoxDomExecutor","isTypedef":false,"href":"class_webdriver_FirefoxDomExecutor.html"},{"isInterface":false,"name":"webdriver.FirefoxDomExecutor.Attribute_","isTypedef":false,"href":"enum_webdriver_FirefoxDomExecutor_Attribute_.html"},{"isInterface":false,"name":"webdriver.FirefoxDomExecutor.EventType_","isTypedef":false,"href":"enum_webdriver_FirefoxDomExecutor_EventType_.html"},{"isInterface":false,"name":"webdriver.Key","isTypedef":false,"href":"enum_webdriver_Key.html"},{"isInterface":false,"name":"webdriver.Locator","isTypedef":false,"href":"class_webdriver_Locator.html"},{"isInterface":false,"name":"webdriver.Session","isTypedef":false,"href":"class_webdriver_Session.html"},{"isInterface":false,"name":"webdriver.UnhandledAlertError","isTypedef":false,"href":"class_webdriver_UnhandledAlertError.html"},{"isInterface":false,"name":"webdriver.WebDriver","isTypedef":false,"href":"class_webdriver_WebDriver.html"},{"isInterface":false,"name":"webdriver.WebDriver.Logs","isTypedef":false,"href":"class_webdriver_WebDriver_Logs.html"},{"isInterface":false,"name":"webdriver.WebDriver.Navigation","isTypedef":false,"href":"class_webdriver_WebDriver_Navigation.html"},{"isInterface":false,"name":"webdriver.WebDriver.Options","isTypedef":false,"href":"class_webdriver_WebDriver_Options.html"},{"isInterface":false,"name":"webdriver.WebDriver.TargetLocator","isTypedef":false,"href":"class_webdriver_WebDriver_TargetLocator.html"},{"isInterface":false,"name":"webdriver.WebDriver.Timeouts","isTypedef":false,"href":"class_webdriver_WebDriver_Timeouts.html"},{"isInterface":false,"name":"webdriver.WebDriver.Window","isTypedef":false,"href":"class_webdriver_WebDriver_Window.html"},{"isInterface":false,"name":"webdriver.WebElement","isTypedef":false,"href":"class_webdriver_WebElement.html"},{"isInterface":false,"name":"webdriver.http","isTypedef":false,"href":"namespace_webdriver_http.html"},{"isInterface":true,"name":"webdriver.http.Client","isTypedef":false,"href":"interface_webdriver_http_Client.html"},{"isInterface":false,"name":"webdriver.http.CorsClient","isTypedef":false,"href":"class_webdriver_http_CorsClient.html"},{"isInterface":false,"name":"webdriver.http.Executor","isTypedef":false,"href":"class_webdriver_http_Executor.html"},{"isInterface":false,"name":"webdriver.http.Request","isTypedef":false,"href":"class_webdriver_http_Request.html"},{"isInterface":false,"name":"webdriver.http.Response","isTypedef":false,"href":"class_webdriver_http_Response.html"},{"isInterface":false,"name":"webdriver.http.XhrClient","isTypedef":false,"href":"class_webdriver_http_XhrClient.html"},{"isInterface":false,"name":"webdriver.logging","isTypedef":false,"href":"namespace_webdriver_logging.html"},{"name":"webdriver.logging.Preferences","isTypedef":true,"href":"namespace_webdriver_logging.html#webdriver.logging.Preferences"},{"isInterface":false,"name":"webdriver.logging.Entry","isTypedef":false,"href":"class_webdriver_logging_Entry.html"},{"isInterface":false,"name":"webdriver.logging.Level","isTypedef":false,"href":"enum_webdriver_logging_Level.html"},{"isInterface":false,"name":"webdriver.logging.LevelName","isTypedef":false,"href":"enum_webdriver_logging_LevelName.html"},{"isInterface":false,"name":"webdriver.logging.Type","isTypedef":false,"href":"enum_webdriver_logging_Type.html"},{"isInterface":false,"name":"webdriver.process","isTypedef":false,"href":"namespace_webdriver_process.html"},{"isInterface":false,"name":"webdriver.promise","isTypedef":false,"href":"namespace_webdriver_promise.html"},{"isInterface":false,"name":"webdriver.promise.CanceledTaskError_","isTypedef":false,"href":"class_webdriver_promise_CanceledTaskError_.html"},{"isInterface":false,"name":"webdriver.promise.ControlFlow","isTypedef":false,"href":"class_webdriver_promise_ControlFlow.html"},{"name":"webdriver.promise.ControlFlow.Timer","isTypedef":true,"href":"class_webdriver_promise_ControlFlow.html#webdriver.promise.ControlFlow.Timer"},{"isInterface":false,"name":"webdriver.promise.ControlFlow.EventType","isTypedef":false,"href":"enum_webdriver_promise_ControlFlow_EventType.html"},{"isInterface":false,"name":"webdriver.promise.Deferred","isTypedef":false,"href":"class_webdriver_promise_Deferred.html"},{"name":"webdriver.promise.Deferred.Listener_","isTypedef":true,"href":"class_webdriver_promise_Deferred.html#webdriver.promise.Deferred.Listener_"},{"isInterface":false,"name":"webdriver.promise.Deferred.State_","isTypedef":false,"href":"enum_webdriver_promise_Deferred_State_.html"},{"isInterface":false,"name":"webdriver.promise.Frame_","isTypedef":false,"href":"class_webdriver_promise_Frame_.html"},{"isInterface":false,"name":"webdriver.promise.Node_","isTypedef":false,"href":"class_webdriver_promise_Node_.html"},{"isInterface":false,"name":"webdriver.promise.Promise","isTypedef":false,"href":"class_webdriver_promise_Promise.html"},{"isInterface":false,"name":"webdriver.promise.Task_","isTypedef":false,"href":"class_webdriver_promise_Task_.html"},{"isInterface":false,"name":"webdriver.stacktrace","isTypedef":false,"href":"namespace_webdriver_stacktrace.html"},{"isInterface":false,"name":"webdriver.stacktrace.Frame","isTypedef":false,"href":"class_webdriver_stacktrace_Frame.html"},{"isInterface":false,"name":"webdriver.stacktrace.Snapshot","isTypedef":false,"href":"class_webdriver_stacktrace_Snapshot.html"},{"isInterface":false,"name":"webdriver.testing","isTypedef":false,"href":"namespace_webdriver_testing.html"},{"isInterface":false,"name":"webdriver.testing.Assertion","isTypedef":false,"href":"class_webdriver_testing_Assertion.html"},{"isInterface":false,"name":"webdriver.testing.Assertion.DelegatingMatcher_","isTypedef":false,"href":"class_webdriver_testing_Assertion_DelegatingMatcher_.html"},{"isInterface":false,"name":"webdriver.testing.ContainsMatcher","isTypedef":false,"href":"class_webdriver_testing_ContainsMatcher.html"},{"isInterface":false,"name":"webdriver.testing.NegatedAssertion","isTypedef":false,"href":"class_webdriver_testing_NegatedAssertion.html"},{"isInterface":false,"name":"webdriver.testing.assert","isTypedef":false,"href":"module_selenium-webdriver_testing_assert_namespace_dossier$$module__$usr$local$google$home$jleyba$dev$selenium$build$javascript$node$selenium_webdriver$testing$assert_exports.html"},{"isInterface":false,"name":"webdriver.testing.asserts","isTypedef":false,"href":"namespace_webdriver_testing_asserts.html"}],"modules":[{"name":"selenium-webdriver","types":[{"isInterface":false,"name":"Command","isTypedef":false,"href":"class_webdriver_Command.html"},{"isInterface":false,"name":"Key","isTypedef":false,"href":"enum_webdriver_Key.html"},{"isInterface":false,"name":"EventEmitter","isTypedef":false,"href":"class_webdriver_EventEmitter.html"},{"isInterface":false,"name":"Browser","isTypedef":false,"href":"enum_webdriver_Browser.html"},{"isInterface":false,"name":"ActionSequence","isTypedef":false,"href":"class_webdriver_ActionSequence.html"},{"isInterface":false,"name":"Button","isTypedef":false,"href":"enum_webdriver_Button.html"},{"isInterface":false,"name":"CommandName","isTypedef":false,"href":"enum_webdriver_CommandName.html"},{"isInterface":false,"name":"WebElement","isTypedef":false,"href":"class_webdriver_WebElement.html"},{"isInterface":false,"name":"Capability","isTypedef":false,"href":"enum_webdriver_Capability.html"},{"isInterface":false,"name":"Session","isTypedef":false,"href":"class_webdriver_Session.html"},{"isInterface":false,"name":"Builder","isTypedef":false,"href":"module_selenium-webdriver_class_Builder.html"},{"isInterface":false,"name":"Capabilities","isTypedef":false,"href":"class_webdriver_Capabilities.html"},{"isInterface":false,"name":"WebDriver","isTypedef":false,"href":"class_webdriver_WebDriver.html"}],"href":"module_selenium-webdriver.html"},{"name":"selenium-webdriver/_base","types":[],"href":"module_selenium-webdriver__base.html"},{"name":"selenium-webdriver/builder","types":[{"isInterface":false,"name":"Builder","isTypedef":false,"href":"module_selenium-webdriver_builder_class_Builder.html"}],"href":"module_selenium-webdriver_builder.html"},{"name":"selenium-webdriver/chrome","types":[{"isInterface":false,"name":"ServiceBuilder","isTypedef":false,"href":"module_selenium-webdriver_chrome_class_ServiceBuilder.html"},{"isInterface":false,"name":"Options","isTypedef":false,"href":"module_selenium-webdriver_chrome_class_Options.html"}],"href":"module_selenium-webdriver_chrome.html"},{"name":"selenium-webdriver/error","types":[{"isInterface":false,"name":"ErrorCode","isTypedef":false,"href":"enum_bot_ErrorCode.html"},{"isInterface":false,"name":"Error","isTypedef":false,"href":"class_bot_Error.html"}],"href":"module_selenium-webdriver_error.html"},{"name":"selenium-webdriver/executors","types":[],"href":"module_selenium-webdriver_executors.html"},{"name":"selenium-webdriver/http","types":[{"isInterface":false,"name":"HttpClient","isTypedef":false,"href":"module_selenium-webdriver_http_class_HttpClient.html"},{"isInterface":false,"name":"Response","isTypedef":false,"href":"class_webdriver_http_Response.html"},{"isInterface":false,"name":"Request","isTypedef":false,"href":"class_webdriver_http_Request.html"},{"isInterface":false,"name":"Executor","isTypedef":false,"href":"class_webdriver_http_Executor.html"}],"href":"module_selenium-webdriver_http.html"},{"name":"selenium-webdriver/http/util","types":[],"href":"module_selenium-webdriver_http_util.html"},{"name":"selenium-webdriver/io","types":[],"href":"module_selenium-webdriver_io.html"},{"name":"selenium-webdriver/net","types":[],"href":"module_selenium-webdriver_net.html"},{"name":"selenium-webdriver/net/portprober","types":[],"href":"module_selenium-webdriver_net_portprober.html"},{"name":"selenium-webdriver/phantomjs","types":[],"href":"module_selenium-webdriver_phantomjs.html"},{"name":"selenium-webdriver/proxy","types":[{"isInterface":false,"name":"ProxyConfig","isTypedef":true,"href":"module_selenium-webdriver_proxy_namespace_ProxyConfig.html"}],"href":"module_selenium-webdriver_proxy.html"},{"name":"selenium-webdriver/remote","types":[{"isInterface":false,"name":"DriverService","isTypedef":false,"href":"module_selenium-webdriver_remote_class_DriverService.html"},{"isInterface":false,"name":"SeleniumServer","isTypedef":false,"href":"module_selenium-webdriver_remote_class_SeleniumServer.html"},{"name":"SeleniumServer.Options","isTypedef":true,"href":""},{"isInterface":false,"name":"ServiceOptions","isTypedef":true,"href":"module_selenium-webdriver_remote_namespace_ServiceOptions.html"}],"href":"module_selenium-webdriver_remote.html"},{"name":"selenium-webdriver/testing","types":[],"href":"module_selenium-webdriver_testing.html"},{"name":"selenium-webdriver/testing/assert","types":[],"href":"module_selenium-webdriver_testing_assert.html"}]};
\ No newline at end of file
+var TYPES = {"types":[{"name":"bot","href":"namespace_bot.html","namespace":true,"interface":false},{"name":"bot.Error","href":"class_bot_Error.html","namespace":false,"interface":false,"members":["code","isAutomationError","state","toString"]},{"name":"bot.Error.State","href":"enum_bot_Error_State.html","namespace":false,"interface":false},{"name":"bot.ErrorCode","href":"enum_bot_ErrorCode.html","namespace":false,"interface":false},{"name":"bot.json","href":"namespace_bot_json.html","namespace":true,"interface":false,"statics":["NATIVE_JSON","parse","stringify"]},{"name":"bot.response","href":"namespace_bot_response.html","namespace":true,"interface":false,"statics":["checkResponse","createErrorResponse","createResponse","isResponseObject"]},{"name":"bot.response.ResponseObject","href":"namespace_bot_response.html#response.ResponseObject"},{"name":"bot.userAgent","href":"namespace_bot_userAgent.html","namespace":true,"interface":false,"statics":["ANDROID_PRE_GINGERBREAD","ANDROID_PRE_ICECREAMSANDWICH","FIREFOX_EXTENSION","IE_DOC_10","IE_DOC_9","IE_DOC_PRE10","IE_DOC_PRE8","IE_DOC_PRE9","IOS","MOBILE","SAFARI_6","WINDOWS_PHONE","isEngineVersion","isProductVersion"]},{"name":"webdriver","href":"namespace_webdriver.html","namespace":true,"interface":false},{"name":"webdriver.ProxyConfig","href":"namespace_webdriver.html#webdriver.ProxyConfig"},{"name":"webdriver.ActionSequence","href":"class_webdriver_ActionSequence.html","namespace":false,"interface":false,"members":["click","doubleClick","dragAndDrop","keyDown","keyUp","mouseDown","mouseMove","mouseUp","perform","sendKeys"]},{"name":"webdriver.Alert","href":"class_webdriver_Alert.html","namespace":false,"interface":false,"members":["accept","dismiss","getText","sendKeys"]},{"name":"webdriver.AlertPromise","href":"class_webdriver_AlertPromise.html","namespace":false,"interface":false,"members":["accept","cancel","dismiss","getText","isPending","sendKeys","then","thenCatch","thenFinally"]},{"name":"webdriver.Browser","href":"enum_webdriver_Browser.html","namespace":false,"interface":false},{"name":"webdriver.Button","href":"enum_webdriver_Button.html","namespace":false,"interface":false},{"name":"webdriver.By","href":"namespace_webdriver_By.html","namespace":true,"interface":false,"statics":["className","css","id","js","linkText","name","partialLinkText","tagName","xpath"]},{"name":"webdriver.By.Hash","href":"namespace_webdriver_By.html#By.Hash"},{"name":"webdriver.Capabilities","href":"class_webdriver_Capabilities.html","namespace":false,"interface":false,"statics":["Capabilities.android","Capabilities.chrome","Capabilities.firefox","Capabilities.htmlunit","Capabilities.htmlunitwithjs","Capabilities.ie","Capabilities.ipad","Capabilities.iphone","Capabilities.opera","Capabilities.phantomjs","Capabilities.safari"],"members":["get","has","merge","serialize","set","setAlertBehavior","setEnableNativeEvents","setLoggingPrefs","setProxy","setScrollBehavior"]},{"name":"webdriver.Capability","href":"enum_webdriver_Capability.html","namespace":false,"interface":false},{"name":"webdriver.Command","href":"class_webdriver_Command.html","namespace":false,"interface":false,"members":["getName","getParameter","getParameters","setParameter","setParameters"]},{"name":"webdriver.CommandExecutor","href":"interface_webdriver_CommandExecutor.html","namespace":true,"interface":true,"members":["execute"]},{"name":"webdriver.CommandName","href":"enum_webdriver_CommandName.html","namespace":false,"interface":false},{"name":"webdriver.EventEmitter","href":"class_webdriver_EventEmitter.html","namespace":false,"interface":false,"members":["addListener","emit","listeners","on","once","removeAllListeners","removeListener"]},{"name":"webdriver.FileDetector","href":"class_webdriver_FileDetector.html","namespace":false,"interface":false,"members":["handleFile"]},{"name":"webdriver.Key","href":"enum_webdriver_Key.html","namespace":false,"interface":false,"statics":["Key.chord"]},{"name":"webdriver.Locator","href":"class_webdriver_Locator.html","namespace":false,"interface":false,"statics":["Locator.Strategy","Locator.checkLocator"],"members":["using","value","toString"]},{"name":"webdriver.Serializable","href":"class_webdriver_Serializable.html","namespace":false,"interface":false,"members":["serialize"]},{"name":"webdriver.Session","href":"class_webdriver_Session.html","namespace":false,"interface":false,"members":["getCapabilities","getCapability","getId","toJSON"]},{"name":"webdriver.TouchSequence","href":"class_webdriver_TouchSequence.html","namespace":false,"interface":false,"members":["doubleTap","flick","flickElement","longPress","move","perform","release","scroll","scrollFromElement","tap","tapAndHold"]},{"name":"webdriver.UnhandledAlertError","href":"class_webdriver_UnhandledAlertError.html","namespace":false,"interface":false,"members":["getAlertText"]},{"name":"webdriver.WebDriver","href":"class_webdriver_WebDriver.html","namespace":false,"interface":false,"statics":["WebDriver.attachToSession","WebDriver.createSession"],"members":["actions","call","close","controlFlow","executeAsyncScript","executeScript","findElement","findElements","get","getAllWindowHandles","getCapabilities","getCurrentUrl","getPageSource","getSession","getTitle","getWindowHandle","isElementPresent","manage","navigate","quit","schedule","setFileDetector","sleep","switchTo","takeScreenshot","touchActions","wait"]},{"name":"webdriver.WebDriver.Logs","href":"class_webdriver_WebDriver_Logs.html","namespace":false,"interface":false,"members":["get","getAvailableLogTypes"]},{"name":"webdriver.WebDriver.Navigation","href":"class_webdriver_WebDriver_Navigation.html","namespace":false,"interface":false,"members":["back","forward","refresh","to"]},{"name":"webdriver.WebDriver.Options","href":"class_webdriver_WebDriver_Options.html","namespace":false,"interface":false,"members":["addCookie","deleteAllCookies","deleteCookie","getCookie","getCookies","logs","timeouts","window"]},{"name":"webdriver.WebDriver.Options.Cookie","href":"class_webdriver_WebDriver_Options.html#Options.Cookie"},{"name":"webdriver.WebDriver.TargetLocator","href":"class_webdriver_WebDriver_TargetLocator.html","namespace":false,"interface":false,"members":["activeElement","alert","defaultContent","frame","window"]},{"name":"webdriver.WebDriver.Timeouts","href":"class_webdriver_WebDriver_Timeouts.html","namespace":false,"interface":false,"members":["implicitlyWait","pageLoadTimeout","setScriptTimeout"]},{"name":"webdriver.WebDriver.Window","href":"class_webdriver_WebDriver_Window.html","namespace":false,"interface":false,"members":["getPosition","getSize","maximize","setPosition","setSize"]},{"name":"webdriver.WebElement","href":"class_webdriver_WebElement.html","namespace":false,"interface":false,"statics":["WebElement.ELEMENT_KEY","WebElement.equals"],"members":["clear","click","findElement","findElements","getAttribute","getCssValue","getDriver","getId","getInnerHtml","getLocation","getOuterHtml","getRawId","getSize","getTagName","getText","isDisplayed","isElementPresent","isEnabled","isSelected","sendKeys","serialize","submit"]},{"name":"webdriver.WebElement.Id","href":"class_webdriver_WebElement.html#WebElement.Id"},{"name":"webdriver.WebElementPromise","href":"class_webdriver_WebElementPromise.html","namespace":false,"interface":false,"members":["cancel","getId","isPending","then","thenCatch","thenFinally"]},{"name":"webdriver.http","href":"namespace_webdriver_http.html","namespace":true,"interface":false},{"name":"webdriver.http.Client","href":"interface_webdriver_http_Client.html","namespace":true,"interface":true,"members":["send"]},{"name":"webdriver.http.Executor","href":"class_webdriver_http_Executor.html","namespace":false,"interface":false,"members":["defineCommand","execute"]},{"name":"webdriver.http.Request","href":"class_webdriver_http_Request.html","namespace":false,"interface":false,"members":["data","headers","method","path","toString"]},{"name":"webdriver.http.Response","href":"class_webdriver_http_Response.html","namespace":false,"interface":false,"statics":["Response.fromXmlHttpRequest"],"members":["body","headers","status","toString"]},{"name":"webdriver.logging","href":"namespace_webdriver_logging.html","namespace":true,"interface":false,"statics":["addConsoleHandler","getLevel","getLogger","installConsoleHandler","removeConsoleHandler"]},{"name":"webdriver.logging.Entry","href":"class_webdriver_logging_Entry.html","namespace":false,"interface":false,"statics":["Entry.fromClosureLogRecord"],"members":["level","message","timestamp","type","toJSON"]},{"name":"webdriver.logging.Level","href":"class_webdriver_logging_Level.html","namespace":false,"interface":false,"statics":["Level.ALL","Level.CONFIG","Level.DEBUG","Level.FINE","Level.FINER","Level.FINEST","Level.INFO","Level.OFF","Level.PREDEFINED_LEVELS","Level.SEVERE","Level.SHOUT","Level.WARNING","Level.getPredefinedLevel","Level.getPredefinedLevelByValue"],"members":["name","value","toString"]},{"name":"webdriver.logging.LogRecord","href":"class_webdriver_logging_LogRecord.html","namespace":false,"interface":false,"statics":["LogRecord.ENABLE_SEQUENCE_NUMBERS"],"members":["getException","getLevel","getLoggerName","getMessage","getMillis","getSequenceNumber","reset","setException","setLevel","setLoggerName","setMessage","setMillis"]},{"name":"webdriver.logging.Logger","href":"class_webdriver_logging_Logger.html","namespace":false,"interface":false,"statics":["Logger.ENABLE_HIERARCHY","Logger.ROOT_LOGGER_NAME","Logger.getLogger","Logger.logToProfilers"],"members":["addHandler","config","fine","finer","finest","getChildren","getEffectiveLevel","getLevel","getLogRecord","getName","getParent","info","isLoggable","log","logRecord","removeHandler","setLevel","severe","shout","warning"]},{"name":"webdriver.logging.Preferences","href":"class_webdriver_logging_Preferences.html","namespace":false,"interface":false,"members":["setLevel","toJSON"]},{"name":"webdriver.logging.Type","href":"enum_webdriver_logging_Type.html","namespace":false,"interface":false},{"name":"webdriver.promise","href":"namespace_webdriver_promise.html","namespace":true,"interface":false,"statics":["LONG_STACK_TRACES","all","asap","captureStackTrace","checkedNodeCall","consume","controlFlow","createFlow","defer","delayed","filter","fulfilled","fullyResolved","isGenerator","isPromise","map","rejected","setDefaultFlow","when"]},{"name":"webdriver.promise.CancellationError","href":"class_webdriver_promise_CancellationError.html","namespace":false,"interface":false,"statics":["CancellationError.wrap"]},{"name":"webdriver.promise.ControlFlow","href":"class_webdriver_promise_ControlFlow.html","namespace":false,"interface":false,"members":["async","execute","getSchedule","isIdle","reset","setPropagateUnhandledRejections","timeout","toString","wait"]},{"name":"webdriver.promise.ControlFlow.EventType","href":"enum_webdriver_promise_ControlFlow_EventType.html","namespace":false,"interface":false},{"name":"webdriver.promise.Deferred","href":"class_webdriver_promise_Deferred.html","namespace":false,"interface":false,"members":["promise","cancel","fulfill","isPending","reject","then","thenCatch","thenFinally"]},{"name":"webdriver.promise.MultipleUnhandledRejectionError","href":"class_webdriver_promise_MultipleUnhandledRejectionError.html","namespace":false,"interface":false,"members":["errors"]},{"name":"webdriver.promise.Promise","href":"class_webdriver_promise_Promise.html","namespace":false,"interface":false,"members":["cancel","isPending","then","thenCatch","thenFinally","toString"]},{"name":"webdriver.promise.Thenable","href":"interface_webdriver_promise_Thenable.html","namespace":true,"interface":true,"statics":["Thenable.addImplementation","Thenable.isImplementation"],"members":["cancel","isPending","then","thenCatch","thenFinally"]},{"name":"webdriver.stacktrace","href":"namespace_webdriver_stacktrace.html","namespace":true,"interface":false,"statics":["BROWSER_SUPPORTED","format","get","getStack"]},{"name":"webdriver.stacktrace.Frame","href":"class_webdriver_stacktrace_Frame.html","namespace":false,"interface":false,"members":["column","getColumn","getLine","getName","getUrl","isAnonymous","toString"]},{"name":"webdriver.stacktrace.Snapshot","href":"class_webdriver_stacktrace_Snapshot.html","namespace":false,"interface":false,"members":["getStacktrace"]},{"name":"webdriver.testing","href":"namespace_webdriver_testing.html","namespace":true,"interface":false},{"name":"webdriver.testing.Assertion","href":"class_webdriver_testing_Assertion.html","namespace":false,"interface":false,"members":["is","not","apply","closeTo","contains","endsWith","equalTo","greaterThan","greaterThanEqualTo","instanceOf","isFalse","isNull","isNullOrUndefined","isTrue","isUndefined","lessThan","lessThanEqualTo","matches","startsWith"]},{"name":"webdriver.testing.Assertion.DelegatingMatcher_","href":"class_webdriver_testing_Assertion_DelegatingMatcher_.html","namespace":false,"interface":false,"members":["describe","matches"]},{"name":"webdriver.testing.ContainsMatcher","href":"class_webdriver_testing_ContainsMatcher.html","namespace":false,"interface":false,"members":["describe","matches"]},{"name":"webdriver.testing.NegatedAssertion","href":"class_webdriver_testing_NegatedAssertion.html","namespace":false,"interface":false,"members":["value","apply"]},{"name":"webdriver.testing.assert","href":"namespace_webdriver_testing_assert.html","namespace":true,"interface":false,"statics":["register"]},{"name":"webdriver.testing.asserts","href":"namespace_webdriver_testing_asserts.html","namespace":true,"interface":false,"statics":["assertThat","equalTo"]},{"name":"webdriver.until","href":"namespace_webdriver_until.html","namespace":true,"interface":false,"statics":["ableToSwitchToFrame","alertIsPresent","elementIsDisabled","elementIsEnabled","elementIsNotSelected","elementIsNotVisible","elementIsSelected","elementIsVisible","elementLocated","elementTextContains","elementTextIs","elementTextMatches","elementsLocated","stalenessOf","titleContains","titleIs","titleMatches"]},{"name":"webdriver.until.Condition","href":"class_webdriver_until_Condition.html","namespace":false,"interface":false,"members":["description","fn"]}],"modules":[{"name":"selenium-webdriver","href":"module_selenium-webdriver.html","types":[{"name":"WebDriver","href":"module_selenium-webdriver_class_WebDriver.html","namespace":false,"interface":false},{"name":"Serializable","href":"module_selenium-webdriver_class_Serializable.html","namespace":false,"interface":false},{"name":"Capability","href":"module_selenium-webdriver_enum_Capability.html","namespace":false,"interface":false},{"name":"ActionSequence","href":"module_selenium-webdriver_class_ActionSequence.html","namespace":false,"interface":false},{"name":"Builder","href":"module_selenium-webdriver_class_Builder.html","namespace":false,"interface":false},{"name":"promise","href":"module_selenium-webdriver_namespace_promise.html","namespace":true,"interface":false},{"name":"WebElement","href":"module_selenium-webdriver_class_WebElement.html","namespace":false,"interface":false},{"name":"error","href":"module_selenium-webdriver_namespace_error.html","namespace":true,"interface":false},{"name":"WebElementPromise","href":"module_selenium-webdriver_class_WebElementPromise.html","namespace":false,"interface":false},{"name":"FileDetector","href":"module_selenium-webdriver_class_FileDetector.html","namespace":false,"interface":false},{"name":"stacktrace","href":"module_selenium-webdriver_namespace_stacktrace.html","namespace":true,"interface":false},{"name":"Button","href":"module_selenium-webdriver_enum_Button.html","namespace":false,"interface":false},{"name":"Command","href":"module_selenium-webdriver_class_Command.html","namespace":false,"interface":false},{"name":"EventEmitter","href":"module_selenium-webdriver_class_EventEmitter.html","namespace":false,"interface":false},{"name":"Capabilities","href":"module_selenium-webdriver_class_Capabilities.html","namespace":false,"interface":false},{"name":"By","href":"module_selenium-webdriver_namespace_By.html","namespace":true,"interface":false},{"name":"logging","href":"module_selenium-webdriver_namespace_logging.html","namespace":true,"interface":false},{"name":"until","href":"module_selenium-webdriver_namespace_until.html","namespace":true,"interface":false},{"name":"CommandName","href":"module_selenium-webdriver_enum_CommandName.html","namespace":false,"interface":false},{"name":"Key","href":"module_selenium-webdriver_enum_Key.html","namespace":false,"interface":false},{"name":"Browser","href":"module_selenium-webdriver_enum_Browser.html","namespace":false,"interface":false},{"name":"Session","href":"module_selenium-webdriver_class_Session.html","namespace":false,"interface":false}]},{"name":"selenium-webdriver/_base","href":"module_selenium-webdriver__base.html","statics":["closure","exportPublicApi","isDevMode","require"],"types":[{"name":"Context","href":"module_selenium-webdriver__base_class_Context.html","namespace":false,"interface":false,"members":["closure"]}]},{"name":"selenium-webdriver/builder","href":"module_selenium-webdriver_builder.html","types":[{"name":"Builder","href":"module_selenium-webdriver_builder_class_Builder.html","namespace":false,"interface":false,"members":["build","disableEnvironmentOverrides","forBrowser","getCapabilities","getServerUrl","getWebDriverProxy","setAlertBehavior","setChromeOptions","setControlFlow","setEnableNativeEvents","setFirefoxOptions","setIeOptions","setLoggingPrefs","setOperaOptions","setProxy","setSafariOptions","setScrollBehavior","usingServer","usingWebDriverProxy","withCapabilities"]}]},{"name":"selenium-webdriver/chrome","href":"module_selenium-webdriver_chrome.html","statics":["getDefaultService","setDefaultService"],"types":[{"name":"Options","href":"module_selenium-webdriver_chrome_class_Options.html","namespace":false,"interface":false,"statics":["Options.fromCapabilities"],"members":["addArguments","addExtensions","androidActivity","androidChrome","androidDeviceSerial","androidPackage","androidProcess","androidUseRunningApp","detachDriver","excludeSwitches","serialize","setChromeBinaryPath","setChromeLogFile","setChromeMinidumpPath","setLocalState","setLoggingPrefs","setMobileEmulation","setPerfLoggingPrefs","setProxy","setUserPreferences","toCapabilities"]},{"name":"Driver","href":"module_selenium-webdriver_chrome_class_Driver.html","namespace":false,"interface":false,"members":["launchApp","setFileDetector"]},{"name":"ServiceBuilder","href":"module_selenium-webdriver_chrome_class_ServiceBuilder.html","namespace":false,"interface":false,"members":["build","enableVerboseLogging","loggingTo","setAdbPort","setNumHttpThreads","setStdio","setUrlBasePath","usingPort","withEnvironment"]}]},{"name":"selenium-webdriver/error","href":"module_selenium-webdriver_error.html","types":[{"name":"Error","href":"module_selenium-webdriver_error_class_Error.html","namespace":false,"interface":false},{"name":"ErrorCode","href":"module_selenium-webdriver_error_enum_ErrorCode.html","namespace":false,"interface":false}]},{"name":"selenium-webdriver/executors","href":"module_selenium-webdriver_executors.html","statics":["createExecutor"],"types":[{"name":"DeferredExecutor","href":"module_selenium-webdriver_executors_class_DeferredExecutor.html","namespace":false,"interface":false,"members":["execute"]}]},{"name":"selenium-webdriver/firefox","href":"module_selenium-webdriver_firefox.html","types":[{"name":"Options","href":"module_selenium-webdriver_firefox_class_Options.html","namespace":false,"interface":false,"members":["setBinary","setLoggingPreferences","setProfile","setProxy","toCapabilities"]},{"name":"Driver","href":"module_selenium-webdriver_firefox_class_Driver.html","namespace":false,"interface":false,"members":["quit","setFileDetector"]},{"name":"Binary","href":"module_selenium-webdriver_firefox_class_Binary.html","namespace":false,"interface":false},{"name":"Profile","href":"module_selenium-webdriver_firefox_class_Profile.html","namespace":false,"interface":false}]},{"name":"selenium-webdriver/firefox/binary","href":"module_selenium-webdriver_firefox_binary.html","types":[{"name":"Binary","href":"module_selenium-webdriver_firefox_binary_class_Binary.html","namespace":false,"interface":false,"members":["addArguments","launch","serialize"]}]},{"name":"selenium-webdriver/firefox/extension","href":"module_selenium-webdriver_firefox_extension.html","statics":["install"]},{"name":"selenium-webdriver/firefox/profile","href":"module_selenium-webdriver_firefox_profile.html","statics":["decode","loadUserPrefs"],"types":[{"name":"Profile","href":"module_selenium-webdriver_firefox_profile_class_Profile.html","namespace":false,"interface":false,"members":["acceptUntrustedCerts","addExtension","assumeUntrustedCertIssuer","encode","getPort","getPreference","nativeEventsEnabled","serialize","setAcceptUntrustedCerts","setAssumeUntrustedCertIssuer","setNativeEventsEnabled","setPort","setPreference","writeToDisk"]}]},{"name":"selenium-webdriver/http","href":"module_selenium-webdriver_http.html","types":[{"name":"Response","href":"module_selenium-webdriver_http_class_Response.html","namespace":false,"interface":false},{"name":"Executor","href":"module_selenium-webdriver_http_class_Executor.html","namespace":false,"interface":false},{"name":"HttpClient","href":"module_selenium-webdriver_http_class_HttpClient.html","namespace":false,"interface":false,"members":["send"]},{"name":"Request","href":"module_selenium-webdriver_http_class_Request.html","namespace":false,"interface":false}]},{"name":"selenium-webdriver/http/util","href":"module_selenium-webdriver_http_util.html","statics":["getStatus","waitForServer","waitForUrl"]},{"name":"selenium-webdriver/ie","href":"module_selenium-webdriver_ie.html","types":[{"name":"Options","href":"module_selenium-webdriver_ie_class_Options.html","namespace":false,"interface":false,"statics":["Options.fromCapabilities"],"members":["addArguments","browserAttachTimeout","enableElementCacheCleanup","enablePersistentHover","ensureCleanSession","forceCreateProcessApi","ignoreZoomSetting","initialBrowserUrl","introduceFlakinessByIgnoringProtectedModeSettings","requireWindowFocus","setExtractPath","setHost","setLogFile","setLogLevel","setProxy","silent","toCapabilities","usePerProcessProxy"]},{"name":"Driver","href":"module_selenium-webdriver_ie_class_Driver.html","namespace":false,"interface":false,"members":["setFileDetector"]},{"name":"Level","href":"module_selenium-webdriver_ie_enum_Level.html","namespace":false,"interface":false}]},{"name":"selenium-webdriver/io","href":"module_selenium-webdriver_io.html","statics":["copy","copyDir","exists","findInPath","rmDir","tmpDir","tmpFile","unlink"]},{"name":"selenium-webdriver/io/exec","href":"module_selenium-webdriver_io_exec.html"},{"name":"selenium-webdriver/net","href":"module_selenium-webdriver_net.html","statics":["getAddress","getLoopbackAddress"]},{"name":"selenium-webdriver/net/portprober","href":"module_selenium-webdriver_net_portprober.html","statics":["findFreePort","isFree"]},{"name":"selenium-webdriver/opera","href":"module_selenium-webdriver_opera.html","statics":["getDefaultService","setDefaultService"],"types":[{"name":"Options","href":"module_selenium-webdriver_opera_class_Options.html","namespace":false,"interface":false,"statics":["Options.fromCapabilities"],"members":["addArguments","addExtensions","serialize","setLoggingPrefs","setOperaBinaryPath","setProxy","toCapabilities"]},{"name":"Driver","href":"module_selenium-webdriver_opera_class_Driver.html","namespace":false,"interface":false,"members":["setFileDetector"]},{"name":"ServiceBuilder","href":"module_selenium-webdriver_opera_class_ServiceBuilder.html","namespace":false,"interface":false,"members":["build","enableVerboseLogging","loggingTo","setStdio","silent","usingPort","withEnvironment"]}]},{"name":"selenium-webdriver/phantomjs","href":"module_selenium-webdriver_phantomjs.html","types":[{"name":"Driver","href":"module_selenium-webdriver_phantomjs_class_Driver.html","namespace":false,"interface":false,"members":["executePhantomJS","setFileDetector"]}]},{"name":"selenium-webdriver/proxy","href":"module_selenium-webdriver_proxy.html","statics":["direct","manual","pac","system"]},{"name":"selenium-webdriver/remote","href":"module_selenium-webdriver_remote.html","types":[{"name":"FileDetector","href":"module_selenium-webdriver_remote_class_FileDetector.html","namespace":false,"interface":false,"members":["handleFile"]},{"name":"DriverService","href":"module_selenium-webdriver_remote_class_DriverService.html","namespace":false,"interface":false,"statics":["DriverService.DEFAULT_START_TIMEOUT_MS"],"members":["address","isRunning","kill","start","stop"]},{"name":"SeleniumServer","href":"module_selenium-webdriver_remote_class_SeleniumServer.html","namespace":false,"interface":false},{"name":"SeleniumServer.Options","href":"module_selenium-webdriver_remote_class_SeleniumServer.html#SeleniumServer.Options"}]},{"name":"selenium-webdriver/safari","href":"module_selenium-webdriver_safari.html","types":[{"name":"Options","href":"module_selenium-webdriver_safari_class_Options.html","namespace":false,"interface":false,"statics":["Options.fromCapabilities"],"members":["serialize","setCleanSession","setLoggingPrefs","toCapabilities"]},{"name":"Driver","href":"module_selenium-webdriver_safari_class_Driver.html","namespace":false,"interface":false}]},{"name":"selenium-webdriver/testing","href":"module_selenium-webdriver_testing.html","statics":["after","afterEach","before","beforeEach","describe","ignore","iit","it","xdescribe","xit"]},{"name":"selenium-webdriver/testing/assert","href":"module_selenium-webdriver_testing_assert.html","statics":["register"]}]};
\ No newline at end of file
diff --git a/error.js b/error.js
index 368bbc2..6e1fdd7 100644
--- a/error.js
+++ b/error.js
@@ -1,17 +1,19 @@
-// Copyright 2014 Selenium committers
-// Copyright 2014 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
diff --git a/example/chrome_android.js b/example/chrome_android.js
new file mode 100644
index 0000000..990a4c4
--- /dev/null
+++ b/example/chrome_android.js
@@ -0,0 +1,38 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview A basic example of working with Chrome on Android. Before
+ * running this example, you must start adb and connect a device (or start an
+ * AVD).
+ */
+
+var webdriver = require('..'),
+    By = webdriver.By,
+    until = webdriver.until,
+    chrome = require('../chrome');
+
+var driver = new webdriver.Builder()
+    .forBrowser('chrome')
+    .setChromeOptions(new chrome.Options().androidChrome())
+    .build();
+
+driver.get('http://www.google.com/ncr');
+driver.findElement(By.name('q')).sendKeys('webdriver');
+driver.findElement(By.name('btnG')).click();
+driver.wait(until.titleIs('webdriver - Google Search'), 1000);
+driver.quit();
diff --git a/example/chrome_mobile_emulation.js b/example/chrome_mobile_emulation.js
new file mode 100644
index 0000000..d308112
--- /dev/null
+++ b/example/chrome_mobile_emulation.js
@@ -0,0 +1,39 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview This is an example of emulating a mobile device using the
+ * ChromeDriver.
+ */
+
+var webdriver = require('..'),
+    By = webdriver.By,
+    until = webdriver.until,
+    chrome = require('../chrome');
+
+
+var driver = new webdriver.Builder()
+    .forBrowser('chrome')
+    .setChromeOptions(new chrome.Options()
+        .setMobileEmulation({deviceName: 'Google Nexus 5'}))
+    .build();
+
+driver.get('http://www.google.com/ncr');
+driver.findElement(By.name('q')).sendKeys('webdriver');
+driver.findElement(By.name('btnG')).click();
+driver.wait(until.titleIs('webdriver - Google Search'), 1000);
+driver.quit();
diff --git a/example/google_search.js b/example/google_search.js
index d09e41d..c624fa2 100644
--- a/example/google_search.js
+++ b/example/google_search.js
@@ -1,40 +1,50 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview An example WebDriver script. This requires the chromedriver
  * to be present on the system PATH.
- * Usage: node selenium-webdriver/example/google_search.js
+ *
+ * Usage:
+ *   // Default behavior
+ *   node selenium-webdriver/example/google_search.js
+ *
+ *   // Target Chrome locally; the chromedriver must be on your PATH
+ *   SELENIUM_BROWSER=chrome node selenium-webdriver/example/google_search.js
+ *
+ *   // Use a local copy of the standalone Selenium server
+ *   SELENIUM_SERVER_JAR=/path/to/selenium-server-standalone.jar \
+ *     node selenium-webdriver/example/google_search.js
+ *
+ *   // Target a remove Selenium server
+ *   SELENIUM_REMOTE_URL=http://www.example.com:4444/wd/hub \
+ *     node selenium-webdriver/example/google_search.js
  */
 
-var fs = require('fs');
-
 var webdriver = require('..'),
-    remote = require('../remote');
-
-var driver = new webdriver.Builder().
-    withCapabilities(webdriver.Capabilities.chrome()).
-    build();
+    By = webdriver.By,
+    until = webdriver.until;
 
-driver.get('http://www.google.com');
-driver.findElement(webdriver.By.name('q')).sendKeys('webdriver');
-driver.findElement(webdriver.By.name('btnG')).click();
-driver.wait(function() {
-  return driver.getTitle().then(function(title) {
-    return 'webdriver - Google Search' === title;
-  });
-}, 1000);
+var driver = new webdriver.Builder()
+    .forBrowser('firefox')
+    .build();
 
-driver.quit();
+driver.get('http://www.google.com/ncr');
+driver.findElement(By.name('q')).sendKeys('webdriver');
+driver.findElement(By.name('btnG')).click();
+driver.wait(until.titleIs('webdriver - Google Search'), 1000);
+driver.quit();
\ No newline at end of file
diff --git a/example/google_search_generator.js b/example/google_search_generator.js
new file mode 100644
index 0000000..90173bc
--- /dev/null
+++ b/example/google_search_generator.js
@@ -0,0 +1,47 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview An example WebDriver script using Harmony generator functions.
+ * This requires node v0.11 or newer.
+ *
+ * Usage: node --harmony-generators \
+ *     selenium-webdriver/example/google_search_generator.js
+ */
+
+var webdriver = require('..'),
+    By = webdriver.By;
+
+var driver = new webdriver.Builder()
+    .forBrowser('firefox')
+    .build();
+
+driver.get('http://www.google.com/ncr');
+driver.call(function* () {
+  var query = yield driver.findElement(By.name('q'));
+  query.sendKeys('webdriver');
+
+  var submit = yield driver.findElement(By.name('btnG'));
+  submit.click();
+});
+
+driver.wait(function* () {
+  var title = yield driver.getTitle();
+  return 'webdriver - Google Search' === title;
+}, 1000);
+
+driver.quit();
diff --git a/example/google_search_test.js b/example/google_search_test.js
index 8ed6a7d..823e2c5 100644
--- a/example/google_search_test.js
+++ b/example/google_search_test.js
@@ -1,50 +1,47 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
- * @fileoverview An example test that may be run using Mocha. To run, you must
- * have the chromedriver installed on the system PATH.
+ * @fileoverview An example test that may be run using Mocha.
+ * Usage: mocha -t 10000 selenium-webdriver/example/google_search_test.js
  */
 
-var assert = require('assert'),
-    fs = require('fs');
-
 var webdriver = require('..'),
-    test = require('../testing'),
-    remote = require('../remote');
-
+    By = webdriver.By,
+    until = webdriver.until,
+    test = require('../testing');
 
 test.describe('Google Search', function() {
   var driver;
 
   test.before(function() {
-    driver = new webdriver.Builder().
-        withCapabilities(webdriver.Capabilities.chrome()).
-        build();
+    driver = new webdriver.Builder()
+        .forBrowser('firefox')
+        .build();
   });
 
   test.it('should append query to title', function() {
     driver.get('http://www.google.com');
-    driver.findElement(webdriver.By.name('q')).sendKeys('webdriver');
-    driver.findElement(webdriver.By.name('btnG')).click();
-    driver.wait(function() {
-      return driver.getTitle().then(function(title) {
-        return 'webdriver - Google Search' === title;
-      });
-    }, 1000);
+    driver.findElement(By.name('q')).sendKeys('webdriver');
+    driver.findElement(By.name('btnG')).click();
+    driver.wait(until.titleIs('webdriver - Google Search'), 1000);
   });
 
-  test.after(function() { driver.quit(); });
+  test.after(function() {
+    driver.quit();
+  });
 });
diff --git a/example/logging.js b/example/logging.js
new file mode 100644
index 0000000..ad198f1
--- /dev/null
+++ b/example/logging.js
@@ -0,0 +1,39 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Demonstrates how to use WebDriver's logging sysem.
+ */
+
+'use strict';
+
+var webdriver = require('..'),
+    By = webdriver.By,
+    until = webdriver.until;
+
+webdriver.logging.installConsoleHandler();
+webdriver.logging.getLogger().setLevel(webdriver.logging.Level.ALL);
+
+var driver = new webdriver.Builder()
+    .forBrowser('firefox')
+    .build();
+
+driver.get('http://www.google.com/ncr');
+driver.findElement(By.name('q')).sendKeys('webdriver');
+driver.findElement(By.name('btnG')).click();
+driver.wait(until.titleIs('webdriver - Google Search'), 1000);
+driver.quit();
diff --git a/example/parallel_flows.js b/example/parallel_flows.js
new file mode 100644
index 0000000..f416922
--- /dev/null
+++ b/example/parallel_flows.js
@@ -0,0 +1,51 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview An example of starting multiple WebDriver clients that run
+ * in parallel in separate control flows.
+ */
+
+var webdriver = require('..'),
+    By = webdriver.By,
+    until = webdriver.until;
+
+for (var i = 0; i < 3; i++) {
+  (function(n) {
+    var flow = new webdriver.promise.ControlFlow()
+        .on('uncaughtException', function(e) {
+          console.log('uncaughtException in flow %d: %s', n, e);
+        });
+
+    var driver = new webdriver.Builder().
+        forBrowser('firefox').
+        setControlFlow(flow).  // Comment out this line to see the difference.
+        build();
+
+    // Position and resize window so it's easy to see them running together.
+    driver.manage().window().setSize(600, 400);
+    driver.manage().window().setPosition(300 * i, 400 * i);
+
+    driver.get('http://www.google.com');
+    driver.findElement(By.name('q')).sendKeys('webdriver');
+    driver.findElement(By.name('btnG')).click();
+    driver.wait(until.titleIs('webdriver - Google Search'), 1000);
+
+    driver.quit();
+  })(i);
+}
+
diff --git a/executors.js b/executors.js
index 79cf8c1..481040d 100644
--- a/executors.js
+++ b/executors.js
@@ -1,16 +1,19 @@
-// Copyright 2013 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Various utilities for working with
@@ -45,15 +48,19 @@ var DeferredExecutor = function(delegate) {
 // PUBLIC API
 
 
+exports.DeferredExecutor = DeferredExecutor;
+
 /**
  * Creates a command executor that uses WebDriver's JSON wire protocol.
  * @param {(string|!webdriver.promise.Promise.<string>)} url The server's URL,
  *     or a promise that will resolve to that URL.
+ * @param {string=} opt_proxy (optional) The URL of the HTTP proxy for the
+ *     client to use.
  * @returns {!webdriver.CommandExecutor} The new command executor.
  */
-exports.createExecutor = function(url) {
+exports.createExecutor = function(url, opt_proxy) {
   return new DeferredExecutor(promise.when(url, function(url) {
-    var client = new HttpClient(url);
+    var client = new HttpClient(url, null, opt_proxy);
     return new HttpExecutor(client);
   }));
 };
diff --git a/firefox/binary.js b/firefox/binary.js
new file mode 100644
index 0000000..259805c
--- /dev/null
+++ b/firefox/binary.js
@@ -0,0 +1,229 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Manages Firefox binaries. This module is considered internal;
+ * users should use {@link selenium-webdriver/firefox}.
+ */
+
+'use strict';
+
+var child = require('child_process'),
+    fs = require('fs'),
+    path = require('path'),
+    util = require('util');
+
+var Serializable = require('..').Serializable,
+    promise = require('..').promise,
+    _base = require('../_base'),
+    io = require('../io'),
+    exec = require('../io/exec');
+
+
+
+/** @const */
+var NO_FOCUS_LIB_X86 = _base.isDevMode() ?
+    path.join(__dirname, '../../../../cpp/prebuilt/i386/libnoblur.so') :
+    path.join(__dirname, '../lib/firefox/i386/libnoblur.so') ;
+
+/** @const */
+var NO_FOCUS_LIB_AMD64 = _base.isDevMode() ?
+    path.join(__dirname, '../../../../cpp/prebuilt/amd64/libnoblur64.so') :
+    path.join(__dirname, '../lib/firefox/amd64/libnoblur64.so') ;
+
+var X_IGNORE_NO_FOCUS_LIB = 'x_ignore_nofocus.so';
+
+var foundBinary = null;
+
+
+/**
+ * Checks the default Windows Firefox locations in Program Files.
+ * @return {!promise.Promise.<?string>} A promise for the located executable.
+ *     The promise will resolve to {@code null} if Fireox was not found.
+ */
+function defaultWindowsLocation() {
+  var files = [
+    process.env['PROGRAMFILES'] || 'C:\\Program Files',
+    process.env['PROGRAMFILES(X86)'] || 'C:\\Program Files (x86)'
+  ].map(function(prefix) {
+    return path.join(prefix, 'Mozilla Firefox\\firefox.exe');
+  });
+  return io.exists(files[0]).then(function(exists) {
+    return exists ? files[0] : io.exists(files[1]).then(function(exists) {
+      return exists ? files[1] : null;
+    });
+  });
+}
+
+
+/**
+ * Locates the Firefox binary for the current system.
+ * @return {!promise.Promise.<string>} A promise for the located binary. The
+ *     promise will be rejected if Firefox cannot be located.
+ */
+function findFirefox() {
+  if (foundBinary) {
+    return foundBinary;
+  }
+
+  if (process.platform === 'darwin') {
+    var osxExe =  '/Applications/Firefox.app/Contents/MacOS/firefox-bin';
+    foundBinary = io.exists(osxExe).then(function(exists) {
+      return exists ? osxExe : null;
+    });
+  } else if (process.platform === 'win32') {
+    foundBinary = defaultWindowsLocation();
+  } else {
+    foundBinary = promise.fulfilled(io.findInPath('firefox'));
+  }
+
+  return foundBinary = foundBinary.then(function(found) {
+    if (found) {
+      return found;
+    }
+    throw Error('Could not locate Firefox on the current system');
+  });
+}
+
+
+/**
+ * Copies the no focus libs into the given profile directory.
+ * @param {string} profileDir Path to the profile directory to install into.
+ * @return {!promise.Promise.<string>} The LD_LIBRARY_PATH prefix string to use
+ *     for the installed libs.
+ */
+function installNoFocusLibs(profileDir) {
+  var x86 = path.join(profileDir, 'x86');
+  var amd64 = path.join(profileDir, 'amd64');
+
+  return mkdir(x86)
+      .then(copyLib.bind(null, NO_FOCUS_LIB_X86, x86))
+      .then(mkdir.bind(null, amd64))
+      .then(copyLib.bind(null, NO_FOCUS_LIB_AMD64, amd64))
+      .then(function() {
+        return x86 + ':' + amd64;
+      });
+
+  function mkdir(dir) {
+    return io.exists(dir).then(function(exists) {
+      if (!exists) {
+        return promise.checkedNodeCall(fs.mkdir, dir);
+      }
+    });
+  }
+
+  function copyLib(src, dir) {
+    return io.copy(src, path.join(dir, X_IGNORE_NO_FOCUS_LIB));
+  }
+}
+
+
+/**
+ * Provides a mechanism to configure and launch Firefox in a subprocess for
+ * use with WebDriver.
+ *
+ * @param {string=} opt_exe Path to the Firefox binary to use. If not
+ *     specified, will attempt to locate Firefox on the current system.
+ * @constructor
+ * @extends {Serializable.<string>}
+ */
+var Binary = function(opt_exe) {
+  Serializable.call(this);
+
+  /** @private {(string|undefined)} */
+  this.exe_ = opt_exe;
+
+  /** @private {!Array.<string>} */
+  this.args_ = [];
+
+  /** @private {!Object.<string, string>} */
+  this.env_ = {};
+  Object.keys(process.env).forEach(function(key) {
+    this.env_[key] = process.env[key];
+  }.bind(this));
+  this.env_['MOZ_CRASHREPORTER_DISABLE'] = '1';
+  this.env_['MOZ_NO_REMOTE'] = '1';
+  this.env_['NO_EM_RESTART'] = '1';
+};
+util.inherits(Binary, Serializable);
+
+
+/**
+ * Add arguments to the command line used to start Firefox.
+ * @param {...(string|!Array.<string>)} var_args Either the arguments to add as
+ *     varargs, or the arguments as an array.
+ */
+Binary.prototype.addArguments = function(var_args) {
+  for (var i = 0; i < arguments.length; i++) {
+    if (util.isArray(arguments[i])) {
+      this.args_ = this.args_.concat(arguments[i]);
+    } else {
+      this.args_.push(arguments[i]);
+    }
+  }
+};
+
+
+/**
+ * Launches Firefox and returns a promise that will be fulfilled when the
+ * process terminates.
+ * @param {string} profile Path to the profile directory to use.
+ * @return {!promise.Promise.<!exec.Command>} A promise for the handle to the
+ *     started subprocess.
+ */
+Binary.prototype.launch = function(profile) {
+  var env = {};
+  Object.keys(this.env_).forEach(function(key) {
+    env[key] = this.env_[key];
+  }.bind(this));
+  env['XRE_PROFILE_PATH'] = profile;
+
+  var args = ['-foreground'].concat(this.args_);
+
+  return promise.when(this.exe_ || findFirefox(), function(firefox) {
+    if (process.platform === 'win32' || process.platform === 'darwin') {
+      return exec(firefox, {args: args, env: env});
+    }
+    return installNoFocusLibs(profile).then(function(ldLibraryPath) {
+      env['LD_LIBRARY_PATH'] = ldLibraryPath + ':' + env['LD_LIBRARY_PATH'];
+      env['LD_PRELOAD'] = X_IGNORE_NO_FOCUS_LIB;
+      return exec(firefox, {args: args, env: env});
+    });
+  });
+};
+
+
+/**
+ * Returns a promise for the wire representation of this binary. Note: the
+ * FirefoxDriver only supports passing the path to the binary executable over
+ * the wire; all command line arguments and environment variables will be
+ * discarded.
+ *
+ * @return {!promise.Promise.<string>} A promise for this binary's wire
+ *     representation.
+ * @override
+ */
+Binary.prototype.serialize = function() {
+  return promise.when(this.exe_ || findFirefox());
+};
+
+
+// PUBLIC API
+
+
+exports.Binary = Binary;
+
diff --git a/firefox/extension.js b/firefox/extension.js
new file mode 100644
index 0000000..1ba6966
--- /dev/null
+++ b/firefox/extension.js
@@ -0,0 +1,185 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/** @fileoverview Utilities for working with Firefox extensions. */
+
+'use strict';
+
+var AdmZip = require('adm-zip'),
+    fs = require('fs'),
+    path = require('path'),
+    util = require('util'),
+    xml = require('xml2js');
+
+var promise = require('..').promise,
+    checkedCall = promise.checkedNodeCall,
+    io = require('../io');
+
+
+/**
+ * Thrown when there an add-on is malformed.
+ * @param {string} msg The error message.
+ * @constructor
+ * @extends {Error}
+ */
+function AddonFormatError(msg) {
+  Error.call(this);
+
+  Error.captureStackTrace(this, AddonFormatError);
+
+  /** @override */
+  this.name = AddonFormatError.name;
+
+  /** @override */
+  this.message = msg;
+}
+util.inherits(AddonFormatError, Error);
+
+
+
+/**
+ * Installs an extension to the given directory.
+ * @param {string} extension Path to the extension to install, as either a xpi
+ *     file or a directory.
+ * @param {string} dir Path to the directory to install the extension in.
+ * @return {!promise.Promise.<string>} A promise for the add-on ID once
+ *     installed.
+ */
+function install(extension, dir) {
+  return getDetails(extension).then(function(details) {
+    function returnId() { return details.id; }
+
+    var dst = path.join(dir, details.id);
+    if (extension.slice(-4) === '.xpi') {
+      if (!details.unpack) {
+        return io.copy(extension, dst + '.xpi').then(returnId);
+      } else {
+        return checkedCall(fs.readFile, extension).then(function(buff) {
+          // TODO: find an async library for inflating a zip archive.
+          new AdmZip(buff).extractAllTo(dst, true);
+        }).then(returnId);
+      }
+    } else {
+      return io.copyDir(extension, dst).then(returnId);
+    }
+  });
+}
+
+
+/**
+ * Describes a Firefox add-on.
+ * @typedef {{id: string, name: string, version: string, unpack: boolean}}
+ */
+var AddonDetails;
+
+
+/**
+ * Extracts the details needed to install an add-on.
+ * @param {string} addonPath Path to the extension directory.
+ * @return {!promise.Promise.<!AddonDetails>} A promise for the add-on details.
+ */
+function getDetails(addonPath) {
+  return readManifest(addonPath).then(function(doc) {
+    var em = getNamespaceId(doc, 'http://www.mozilla.org/2004/em-rdf#');
+    var rdf = getNamespaceId(
+        doc, 'http://www.w3.org/1999/02/22-rdf-syntax-ns#');
+
+    var description = doc[rdf + 'RDF'][rdf + 'Description'][0];
+    var details = {
+      id: getNodeText(description, em + 'id'),
+      name: getNodeText(description, em + 'name'),
+      version: getNodeText(description, em + 'version'),
+      unpack: getNodeText(description, em + 'unpack') || false
+    };
+
+    if (typeof details.unpack === 'string') {
+      details.unpack = details.unpack.toLowerCase() === 'true';
+    }
+
+    if (!details.id) {
+      throw new AddonFormatError('Could not find add-on ID for ' + addonPath);
+    }
+
+    return details;
+  });
+
+  function getNodeText(node, name) {
+    return node[name] && node[name][0] || '';
+  }
+
+  function getNamespaceId(doc, url) {
+    var keys = Object.keys(doc);
+    if (keys.length !== 1) {
+      throw new AddonFormatError('Malformed manifest for add-on ' + addonPath);
+    }
+
+    var namespaces = doc[keys[0]].$;
+    var id = '';
+    Object.keys(namespaces).some(function(ns) {
+      if (namespaces[ns] !== url) {
+        return false;
+      }
+
+      if (ns.indexOf(':') != -1) {
+        id = ns.split(':')[1] + ':';
+      }
+      return true;
+    });
+    return id;
+  }
+}
+
+
+/**
+ * Reads the manifest for a Firefox add-on.
+ * @param {string} addonPath Path to a Firefox add-on as a xpi or an extension.
+ * @return {!promise.Promise.<!Object>} A promise for the parsed manifest.
+ */
+function readManifest(addonPath) {
+  var manifest;
+
+  if (addonPath.slice(-4) === '.xpi') {
+    manifest = checkedCall(fs.readFile, addonPath).then(function(buff) {
+      var zip = new AdmZip(buff);
+      if (!zip.getEntry('install.rdf')) {
+        throw new AddonFormatError(
+            'Could not find install.rdf in ' + addonPath);
+      }
+      var done = promise.defer();
+      zip.readAsTextAsync('install.rdf', done.fulfill);
+      return done.promise;
+    });
+  } else {
+    manifest = checkedCall(fs.stat, addonPath).then(function(stats) {
+      if (!stats.isDirectory()) {
+        throw Error(
+            'Add-on path is niether a xpi nor a directory: ' + addonPath);
+      }
+      return checkedCall(fs.readFile, path.join(addonPath, 'install.rdf'));
+    });
+  }
+
+  return manifest.then(function(content) {
+    return checkedCall(xml.parseString, content);
+  });
+}
+
+
+// PUBLIC API
+
+
+exports.install = install;
diff --git a/firefox/index.js b/firefox/index.js
new file mode 100644
index 0000000..c0eef2d
--- /dev/null
+++ b/firefox/index.js
@@ -0,0 +1,320 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Defines the {@linkplain Driver WebDriver} client for Firefox.
+ * Each FirefoxDriver instance will be created with an anonymous profile,
+ * ensuring browser historys do not share session data (cookies, history, cache,
+ * offline storage, etc.)
+ *
+ * __Customizing the Firefox Profile__
+ *
+ * The {@link Profile} class may be used to configure the browser profile used
+ * with WebDriver, with functions to install additional
+ * {@linkplain Profile#addExtension extensions}, configure browser
+ * {@linkplain Profile#setPreference preferences}, and more. For example, you
+ * may wish to include Firebug:
+ *
+ *     var firefox = require('selenium-webdriver/firefox');
+ *
+ *     var profile = new firefox.Profile();
+ *     profile.addExtension('/path/to/firebug.xpi');
+ *     profile.setPreference('extensions.firebug.showChromeErrors', true);
+ *
+ *     var options = new firefox.Options().setProfile(profile);
+ *     var driver = new firefox.Driver(options);
+ *
+ * The {@link Profile} class may also be used to configure WebDriver based on a
+ * pre-existing browser profile:
+ *
+ *     var profile = new firefox.Profile(
+ *         '/usr/local/home/bob/.mozilla/firefox/3fgog75h.testing');
+ *     var options = new firefox.Options().setProfile(profile);
+ *     var driver = new firefox.Driver(options);
+ *
+ * The FirefoxDriver will _never_ modify a pre-existing profile; instead it will
+ * create a copy for it to modify. By extension, there are certain browser
+ * preferences that are required for WebDriver to function properly and they
+ * will always be overwritten.
+ *
+ * __Using a Custom Firefox Binary__
+ *
+ * On Windows and OSX, the FirefoxDriver will search for Firefox in its
+ * default installation location:
+ *
+ * * Windows: C:\Program Files and C:\Program Files (x86).
+ * * Mac OS X: /Applications/Firefox.app
+ *
+ * For Linux, Firefox will be located on the PATH: `$(where firefox)`.
+ *
+ * You can configure WebDriver to start use a custom Firefox installation with
+ * the {@link Binary} class:
+ *
+ *     var firefox = require('selenium-webdriver/firefox');
+ *     var binary = new firefox.Binary('/my/firefox/install/dir/firefox-bin');
+ *     var options = new firefox.Options().setBinary(binary);
+ *     var driver = new firefox.Driver(options);
+ *
+ * __Remote Testing__
+ *
+ * You may customize the Firefox binary and profile when running against a
+ * remote Selenium server. Your custom profile will be packaged as a zip and
+ * transfered to the remote host for use. The profile will be transferred
+ * _once for each new session_. The performance impact should be minimal if
+ * you've only configured a few extra browser preferences. If you have a large
+ * profile with several extensions, you should consider installing it on the
+ * remote host and defining its path via the {@link Options} class. Custom
+ * binaries are never copied to remote machines and must be referenced by
+ * installation path.
+ *
+ *     var options = new firefox.Options()
+ *         .setProfile('/profile/path/on/remote/host')
+ *         .setBinary('/install/dir/on/remote/host/firefox-bin');
+ *
+ *     var driver = new (require('selenium-webdriver')).Builder()
+ *         .forBrowser('firefox')
+ *         .usingServer('http://127.0.0.1:4444/wd/hub')
+ *         .setFirefoxOptions(options)
+ *         .build();
+ */
+
+'use strict';
+
+var url = require('url'),
+    util = require('util');
+
+var Binary = require('./binary').Binary,
+    Profile = require('./profile').Profile,
+    decodeProfile = require('./profile').decode,
+    webdriver = require('..'),
+    executors = require('../executors'),
+    httpUtil = require('../http/util'),
+    io = require('../io'),
+    net = require('../net'),
+    portprober = require('../net/portprober');
+
+
+/**
+ * Configuration options for the FirefoxDriver.
+ * @constructor
+ */
+var Options = function() {
+  /** @private {Profile} */
+  this.profile_ = null;
+
+  /** @private {Binary} */
+  this.binary_ = null;
+
+  /** @private {webdriver.logging.Preferences} */
+  this.logPrefs_ = null;
+
+  /** @private {webdriver.ProxyConfig} */
+  this.proxy_ = null;
+};
+
+
+/**
+ * Sets the profile to use. The profile may be specified as a
+ * {@link Profile} object or as the path to an existing Firefox profile to use
+ * as a template.
+ *
+ * @param {(string|!Profile)} profile The profile to use.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setProfile = function(profile) {
+  if (typeof profile === 'string') {
+    profile = new Profile(profile);
+  }
+  this.profile_ = profile;
+  return this;
+};
+
+
+/**
+ * Sets the binary to use. The binary may be specified as the path to a Firefox
+ * executable, or as a {@link Binary} object.
+ *
+ * @param {(string|!Binary)} binary The binary to use.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setBinary = function(binary) {
+  if (typeof binary === 'string') {
+    binary = new Binary(binary);
+  }
+  this.binary_ = binary;
+  return this;
+};
+
+
+/**
+ * Sets the logging preferences for the new session.
+ * @param {webdriver.logging.Preferences} prefs The logging preferences.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setLoggingPreferences = function(prefs) {
+  this.logPrefs_ = prefs;
+  return this;
+};
+
+
+/**
+ * Sets the proxy to use.
+ *
+ * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setProxy = function(proxy) {
+  this.proxy_ = proxy;
+  return this;
+};
+
+
+/**
+ * Converts these options to a {@link webdriver.Capabilities} instance.
+ *
+ * @return {!webdriver.Capabilities} A new capabilities object.
+ */
+Options.prototype.toCapabilities = function(opt_remote) {
+  var caps = webdriver.Capabilities.firefox();
+  if (this.logPrefs_) {
+    caps.set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_);
+  }
+  if (this.proxy_) {
+    caps.set(webdriver.Capability.PROXY, this.proxy_);
+  }
+  if (this.binary_) {
+    caps.set('firefox_binary', this.binary_);
+  }
+  if (this.profile_) {
+    caps.set('firefox_profile', this.profile_);
+  }
+  return caps;
+};
+
+
+/**
+ * A WebDriver client for Firefox.
+ *
+ * @param {(Options|webdriver.Capabilities|Object)=} opt_config The
+ *    configuration options for this driver, specified as either an
+ *    {@link Options} or {@link webdriver.Capabilities}, or as a raw hash
+ *    object.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The flow to
+ *     schedule commands through. Defaults to the active flow object.
+ * @constructor
+ * @extends {webdriver.WebDriver}
+ */
+var Driver = function(opt_config, opt_flow) {
+  var caps;
+  if (opt_config instanceof Options) {
+    caps = opt_config.toCapabilities();
+  } else {
+    caps = new webdriver.Capabilities(opt_config);
+  }
+
+  var binary = caps.get('firefox_binary') || new Binary();
+  if (typeof binary === 'string') {
+    binary = new Binary(binary);
+  }
+
+  var profile = caps.get('firefox_profile') || new Profile();
+
+  caps.set('firefox_binary', null);
+  caps.set('firefox_profile', null);
+
+  /** @private {?string} */
+  this.profilePath_ = null;
+
+  var self = this;
+  var freePort = portprober.findFreePort();
+
+  /** @private */
+  this.command_ = freePort.then(function(port) {
+    if (typeof profile === 'string') {
+      return decodeProfile(profile).then(function(dir) {
+        var profile = new Profile(dir);
+        profile.setPreference('webdriver_firefox_port', port);
+        return profile.writeToDisk();
+      });
+    } else {
+      profile.setPreference('webdriver_firefox_port', port);
+      return profile.writeToDisk();
+    }
+  }).then(function(profileDir) {
+    self.profilePath_ = profileDir;
+    return binary.launch(profileDir);
+  });
+
+  var serverUrl = this.command_
+      .then(function() { return freePort; })
+      .then(function(port) {
+        var serverUrl = url.format({
+          protocol: 'http',
+          hostname: net.getLoopbackAddress(),
+          port: port,
+          pathname: '/hub'
+        });
+
+        return httpUtil.waitForServer(serverUrl, 45 * 1000).then(function() {
+          return serverUrl;
+        });
+      });
+
+  var executor = executors.createExecutor(serverUrl);
+  var driver = webdriver.WebDriver.createSession(executor, caps, opt_flow);
+
+  webdriver.WebDriver.call(this, driver.getSession(), executor, opt_flow);
+};
+util.inherits(Driver, webdriver.WebDriver);
+
+
+/**
+ * This function is a no-op as file detectors are not supported by this
+ * implementation.
+ * @override
+ */
+Driver.prototype.setFileDetector = function() {
+};
+
+
+/** @override */
+Driver.prototype.quit = function() {
+  return this.call(function() {
+    var self = this;
+    return Driver.super_.prototype.quit.call(this)
+        .thenFinally(function() {
+          return self.command_.then(function(command) {
+            command.kill();
+            return command.result();
+          });
+        })
+        .thenFinally(function() {
+          if (self.profilePath_) {
+            return io.rmDir(self.profilePath_);
+          }
+        });
+  }, this);
+};
+
+
+// PUBLIC API
+
+
+exports.Binary = Binary;
+exports.Driver = Driver;
+exports.Options = Options;
+exports.Profile = Profile;
diff --git a/firefox/profile.js b/firefox/profile.js
new file mode 100644
index 0000000..e198f93
--- /dev/null
+++ b/firefox/profile.js
@@ -0,0 +1,433 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Profile management module. This module is considered internal;
+ * users should use {@link selenium-webdriver/firefox}.
+ */
+
+'use strict';
+
+var AdmZip = require('adm-zip'),
+    AdmConstants = require('adm-zip/util/constants'),
+    fs = require('fs'),
+    path = require('path'),
+    util = require('util'),
+    vm = require('vm');
+
+var Serializable = require('..').Serializable,
+    promise = require('..').promise,
+    _base = require('../_base'),
+    io = require('../io'),
+    extension = require('./extension');
+
+
+/** @const */
+var WEBDRIVER_PREFERENCES_PATH = _base.isDevMode()
+    ? path.join(__dirname, '../../../firefox-driver/webdriver.json')
+    : path.join(__dirname, '../lib/firefox/webdriver.json');
+
+/** @const */
+var WEBDRIVER_EXTENSION_PATH = _base.isDevMode()
+    ? path.join(__dirname,
+        '../../../../build/javascript/firefox-driver/webdriver.xpi')
+    : path.join(__dirname, '../lib/firefox/webdriver.xpi');
+
+/** @const */
+var WEBDRIVER_EXTENSION_NAME = 'fxdriver@googlecode.com';
+
+
+
+/** @type {Object} */
+var defaultPreferences = null;
+
+/**
+ * Synchronously loads the default preferences used for the FirefoxDriver.
+ * @return {!Object} The default preferences JSON object.
+ */
+function getDefaultPreferences() {
+  if (!defaultPreferences) {
+    var contents = fs.readFileSync(WEBDRIVER_PREFERENCES_PATH, 'utf8');
+    defaultPreferences = JSON.parse(contents);
+  }
+  return defaultPreferences;
+}
+
+
+/**
+ * Parses a user.js file in a Firefox profile directory.
+ * @param {string} f Path to the file to parse.
+ * @return {!promise.Promise.<!Object>} A promise for the parsed preferences as
+ *     a JSON object. If the file does not exist, an empty object will be
+ *     returned.
+ */
+function loadUserPrefs(f) {
+  var done = promise.defer();
+  fs.readFile(f, function(err, contents) {
+    if (err && err.code === 'ENOENT') {
+      done.fulfill({});
+      return;
+    }
+
+    if (err) {
+      done.reject(err);
+      return;
+    }
+
+    var prefs = {};
+    var context = vm.createContext({
+      'user_pref': function(key, value) {
+        prefs[key] = value;
+      }
+    });
+
+    vm.runInContext(contents, context, f);
+    done.fulfill(prefs);
+  });
+  return done.promise;
+}
+
+
+/**
+ * Copies the properties of one object into another.
+ * @param {!Object} a The destination object.
+ * @param {!Object} b The source object to apply as a mixin.
+ */
+function mixin(a, b) {
+  Object.keys(b).forEach(function(key) {
+    a[key] = b[key];
+  });
+}
+
+
+/**
+ * @param {!Object} defaults The default preferences to write. Will be
+ *     overridden by user.js preferences in the template directory and the
+ *     frozen preferences required by WebDriver.
+ * @param {string} dir Path to the directory write the file to.
+ * @return {!promise.Promise.<string>} A promise for the profile directory,
+ *     to be fulfilled when user preferences have been written.
+ */
+function writeUserPrefs(prefs, dir) {
+  var userPrefs = path.join(dir, 'user.js');
+  return loadUserPrefs(userPrefs).then(function(overrides) {
+    mixin(prefs, overrides);
+    mixin(prefs, getDefaultPreferences()['frozen']);
+
+    var contents = Object.keys(prefs).map(function(key) {
+      return 'user_pref(' + JSON.stringify(key) + ', ' +
+          JSON.stringify(prefs[key]) + ');';
+    }).join('\n');
+
+    var done = promise.defer();
+    fs.writeFile(userPrefs, contents, function(err) {
+      err && done.reject(err) || done.fulfill(dir);
+    });
+    return done.promise;
+  });
+};
+
+
+/**
+ * Installs a group of extensions in the given profile directory. If the
+ * WebDriver extension is not included in this set, the default version
+ * bundled with this package will be installed.
+ * @param {!Array.<string>} extensions The extensions to install, as a
+ *     path to an unpacked extension directory or a path to a xpi file.
+ * @param {string} dir The profile directory to install to.
+ * @param {boolean=} opt_excludeWebDriverExt Whether to skip installation of
+ *     the default WebDriver extension.
+ * @return {!promise.Promise.<string>} A promise for the main profile directory
+ *     once all extensions have been installed.
+ */
+function installExtensions(extensions, dir, opt_excludeWebDriverExt) {
+  var hasWebDriver = !!opt_excludeWebDriverExt;
+  var next = 0;
+  var extensionDir = path.join(dir, 'extensions');
+  var done = promise.defer();
+
+  return io.exists(extensionDir).then(function(exists) {
+    if (!exists) {
+      return promise.checkedNodeCall(fs.mkdir, extensionDir);
+    }
+  }).then(function() {
+    installNext();
+    return done.promise;
+  });
+
+  function installNext() {
+    if (!done.isPending()) {
+      return;
+    }
+
+    if (next >= extensions.length) {
+      if (hasWebDriver) {
+        done.fulfill(dir);
+      } else {
+        install(WEBDRIVER_EXTENSION_PATH);
+      }
+    } else {
+      install(extensions[next++]);
+    }
+  }
+
+  function install(ext) {
+    extension.install(ext, extensionDir).then(function(id) {
+      hasWebDriver = hasWebDriver || (id === WEBDRIVER_EXTENSION_NAME);
+      installNext();
+    }, done.reject);
+ }
+}
+
+
+/**
+ * Decodes a base64 encoded profile.
+ * @param {string} data The base64 encoded string.
+ * @return {!promise.Promise.<string>} A promise for the path to the decoded
+ *     profile directory.
+ */
+function decode(data) {
+  return io.tmpFile().then(function(file) {
+    var buf = new Buffer(data, 'base64');
+    return promise.checkedNodeCall(fs.writeFile, file, buf).then(function() {
+      return io.tmpDir();
+    }).then(function(dir) {
+      var zip = new AdmZip(file);
+      zip.extractAllTo(dir);  // Sync only? Why?? :-(
+      return dir;
+    });
+  });
+}
+
+
+
+/**
+ * Models a Firefox proifle directory for use with the FirefoxDriver. The
+ * {@code Proifle} directory uses an in-memory model until {@link #writeToDisk}
+ * is called.
+ * @param {string=} opt_dir Path to an existing Firefox profile directory to
+ *     use a template for this profile. If not specified, a blank profile will
+ *     be used.
+ * @constructor
+ * @extends {Serializable.<string>}
+ */
+var Profile = function(opt_dir) {
+  Serializable.call(this);
+
+  /** @private {!Object} */
+  this.preferences_ = {};
+
+  mixin(this.preferences_, getDefaultPreferences()['mutable']);
+  mixin(this.preferences_, getDefaultPreferences()['frozen']);
+
+  /** @private {boolean} */
+  this.nativeEventsEnabled_ = true;
+
+  /** @private {(string|undefined)} */
+  this.template_ = opt_dir;
+
+  /** @private {number} */
+  this.port_ = 0;
+
+  /** @private {!Array.<string>} */
+  this.extensions_ = [];
+};
+util.inherits(Profile, Serializable);
+
+
+/**
+ * Registers an extension to be included with this profile.
+ * @param {string} extension Path to the extension to include, as either an
+ *     unpacked extension directory or the path to a xpi file.
+ */
+Profile.prototype.addExtension = function(extension) {
+  this.extensions_.push(extension);
+};
+
+
+/**
+ * Sets a desired preference for this profile.
+ * @param {string} key The preference key.
+ * @param {(string|number|boolean)} value The preference value.
+ * @throws {Error} If attempting to set a frozen preference.
+ */
+Profile.prototype.setPreference = function(key, value) {
+  var frozen = getDefaultPreferences()['frozen'];
+  if (frozen.hasOwnProperty(key) && frozen[key] !== value) {
+    throw Error('You may not set ' + key + '=' + JSON.stringify(value)
+        + '; value is frozen for proper WebDriver functionality ('
+        + key + '=' + JSON.stringify(frozen[key]) + ')');
+  }
+  this.preferences_[key] = value;
+};
+
+
+/**
+ * Returns the currently configured value of a profile preference. This does
+ * not include any defaults defined in the profile's template directory user.js
+ * file (if a template were specified on construction).
+ * @param {string} key The desired preference.
+ * @return {(string|number|boolean|undefined)} The current value of the
+ *     requested preference.
+ */
+Profile.prototype.getPreference = function(key) {
+  return this.preferences_[key];
+};
+
+
+/**
+ * @return {number} The port this profile is currently configured to use, or
+ *     0 if the port will be selected at random when the profile is written
+ *     to disk.
+ */
+Profile.prototype.getPort = function() {
+  return this.port_;
+};
+
+
+/**
+ * Sets the port to use for the WebDriver extension loaded by this profile.
+ * @param {number} port The desired port, or 0 to use any free port.
+ */
+Profile.prototype.setPort = function(port) {
+  this.port_ = port;
+};
+
+
+/**
+ * @return {boolean} Whether the FirefoxDriver is configured to automatically
+ *     accept untrusted SSL certificates.
+ */
+Profile.prototype.acceptUntrustedCerts = function() {
+  return !!this.preferences_['webdriver_accept_untrusted_certs'];
+};
+
+
+/**
+ * Sets whether the FirefoxDriver should automatically accept untrusted SSL
+ * certificates.
+ * @param {boolean} value .
+ */
+Profile.prototype.setAcceptUntrustedCerts = function(value) {
+  this.preferences_['webdriver_accept_untrusted_certs'] = !!value;
+};
+
+
+/**
+ * Sets whether to assume untrusted certificates come from untrusted issuers.
+ * @param {boolean} value .
+ */
+Profile.prototype.setAssumeUntrustedCertIssuer = function(value) {
+  this.preferences_['webdriver_assume_untrusted_issuer'] = !!value;
+};
+
+
+/**
+ * @return {boolean} Whether to assume untrusted certs come from untrusted
+ *     issuers.
+ */
+Profile.prototype.assumeUntrustedCertIssuer = function() {
+  return !!this.preferences_['webdriver_assume_untrusted_issuer'];
+};
+
+
+/**
+ * Sets whether to use native events with this profile.
+ * @param {boolean} enabled .
+ */
+Profile.prototype.setNativeEventsEnabled = function(enabled) {
+  this.nativeEventsEnabled_ = enabled;
+};
+
+
+/**
+ * Returns whether native events are enabled in this profile.
+ * @return {boolean} .
+ */
+Profile.prototype.nativeEventsEnabled = function() {
+  return this.nativeEventsEnabled_;
+};
+
+
+/**
+ * Writes this profile to disk.
+ * @param {boolean=} opt_excludeWebDriverExt Whether to exclude the WebDriver
+ *     extension from the generated profile. Used to reduce the size of an
+ *     {@link #encode() encoded profile} since the server will always install
+ *     the extension itself.
+ * @return {!promise.Promise.<string>} A promise for the path to the new
+ *     profile directory.
+ */
+Profile.prototype.writeToDisk = function(opt_excludeWebDriverExt) {
+  var profileDir = io.tmpDir();
+  if (this.template_) {
+    profileDir = profileDir.then(function(dir) {
+      return io.copyDir(
+          this.template_, dir, /(parent\.lock|lock|\.parentlock)/);
+    }.bind(this));
+  }
+
+  // Freeze preferences for async operations.
+  var prefs = {};
+  mixin(prefs, this.preferences_);
+
+  // Freeze extensions for async operations.
+  var extensions = this.extensions_.concat();
+
+  return profileDir.then(function(dir) {
+    return writeUserPrefs(prefs, dir);
+  }).then(function(dir) {
+    return installExtensions(extensions, dir, !!opt_excludeWebDriverExt);
+  });
+};
+
+
+/**
+ * Encodes this profile as a zipped, base64 encoded directory.
+ * @return {!promise.Promise.<string>} A promise for the encoded profile.
+ */
+Profile.prototype.encode = function() {
+  return this.writeToDisk(true).then(function(dir) {
+    var zip = new AdmZip();
+    zip.addLocalFolder(dir, '');
+    zip.getEntries()[0].header.method = AdmConstants.STORED;
+    return io.tmpFile().then(function(file) {
+      zip.writeZip(file);  // Sync! Why oh why :-(
+      return promise.checkedNodeCall(fs.readFile, file);
+    });
+  }).then(function(data) {
+    return new Buffer(data).toString('base64');
+  });
+};
+
+
+/**
+ * Encodes this profile as a zipped, base64 encoded directory.
+ * @return {!promise.Promise.<string>} A promise for the encoded profile.
+ * @override
+ */
+Profile.prototype.serialize = function() {
+  return this.encode();
+};
+
+
+// PUBLIC API
+
+
+exports.Profile = Profile;
+exports.decode = decode;
+exports.loadUserPrefs = loadUserPrefs;
diff --git a/http/index.js b/http/index.js
index cb4f7a1..8f06a8c 100644
--- a/http/index.js
+++ b/http/index.js
@@ -1,19 +1,22 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
- * @fileoverview Defines a the {@code webdriver.http.Client} for use with
+ * @fileoverview Defines the {@code webdriver.http.Client} for use with
  * NodeJS.
  */
 
@@ -26,25 +29,35 @@ var base = require('../_base'),
 var KeepAliveAgent = require('keep-alive-agent'),
     agent = new KeepAliveAgent();
 
-
 /**
  * A {@link webdriver.http.Client} implementation using Node's built-in http
  * module.
  * @param {string} serverUrl URL for the WebDriver server to send commands to.
+ * @param {http.Agent=} opt_agent The agent to use for each request.
+ *     Defaults to {@code http.globalAgent}.
+ * @param {string=} opt_proxy The proxy to use for the connection to the server.
+ *     Default is to use no proxy.
  * @constructor
  * @implements {webdriver.http.Client}
  */
-var HttpClient = function(serverUrl) {
+var HttpClient = function(serverUrl, opt_agent, opt_proxy) {
   var parsedUrl = url.parse(serverUrl);
   if (!parsedUrl.hostname) {
     throw new Error('Invalid server URL: ' + serverUrl);
   }
 
+  /** @private {http.Agent} */
+  this.agent_ = opt_agent || agent;
+
+  /** @private {string} */
+  this.proxy_ = opt_proxy;
+
   /**
    * Base options for each request.
    * @private {!Object}
    */
   this.options_ = {
+    auth: parsedUrl.auth,
     host: parsedUrl.hostname,
     path: parsedUrl.pathname,
     port: parsedUrl.port
@@ -69,14 +82,20 @@ HttpClient.prototype.send = function(httpRequest, callback) {
     path += httpRequest.path;
   }
 
-  sendRequest({
+  var options = {
     method: httpRequest.method,
+    auth: this.options_.auth,
     host: this.options_.host,
     port: this.options_.port,
     path: path,
-    headers: httpRequest.headers,
-    agent: agent
-  }, callback, data);
+    headers: httpRequest.headers
+  };
+
+  if (this.agent_) {
+    options.agent = this.agent_;
+  }
+
+  sendRequest(options, callback, data, this.proxy_);
 };
 
 
@@ -86,15 +105,40 @@ HttpClient.prototype.send = function(httpRequest, callback) {
  * @param {function(Error, !webdriver.http.Response=)} callback The function to
  *     invoke with the server's response.
  * @param {string=} opt_data The data to send with the request.
+ * @param {string=} opt_proxy The proxy server to use for the request.
  */
-var sendRequest = function(options, callback, opt_data) {
+var sendRequest = function(options, callback, opt_data, opt_proxy) {
+  var host = options.host;
+  var port = options.port;
+
+  if (opt_proxy) {
+    var proxy = url.parse(opt_proxy);
+
+    options.headers['Host'] = options.host;
+    options.host = proxy.hostname;
+    options.port = proxy.port;
+
+    if (proxy.auth) {
+      options.headers['Proxy-Authorization'] =
+          'Basic ' + new Buffer(proxy.auth).toString('base64');
+    }
+  }
+
   var request = http.request(options, function(response) {
     if (response.statusCode == 302 || response.statusCode == 303) {
-      var location = url.parse(response.headers['location']);
+      try {
+        var location = url.parse(response.headers['location']);
+      } catch (ex) {
+        callback(Error(
+            'Failed to parse "Location" header for server redirect: ' +
+            ex.message + '\nResponse was: \n' +
+            new HttpResponse(response.statusCode, response.headers, '')));
+        return;
+      }
 
       if (!location.hostname) {
-        location.hostname = options.host;
-        location.port = options.port;
+        location.hostname = host;
+        location.port = port;
       }
 
       request.abort();
@@ -106,7 +150,7 @@ var sendRequest = function(options, callback, opt_data) {
         headers: {
           'Accept': 'application/json; charset=utf-8'
         }
-      }, callback);
+      }, callback, undefined, opt_proxy);
       return;
     }
 
@@ -122,7 +166,7 @@ var sendRequest = function(options, callback, opt_data) {
   request.on('error', function(e) {
     if (e.code === 'ECONNRESET') {
       setTimeout(function() {
-        sendRequest(options, callback, opt_data);
+        sendRequest(options, callback, opt_data, opt_proxy);
       }, 15);
     } else {
       var message = e.message;
diff --git a/http/util.js b/http/util.js
index fcb2219..fa35714 100644
--- a/http/util.js
+++ b/http/util.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Various HTTP utilities.
diff --git a/ie.js b/ie.js
new file mode 100644
index 0000000..8aca222
--- /dev/null
+++ b/ie.js
@@ -0,0 +1,465 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Defines a {@linkplain Driver WebDriver} client for Microsoft's
+ * Internet Explorer. Before using the IEDriver, you must download the latest
+ * [IEDriverServer](http://selenium-release.storage.googleapis.com/index.html)
+ * and place it on your
+ * [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29). You must also apply
+ * the system configuration outlined on the Selenium project
+ * [wiki](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver)
+ */
+
+'use strict';
+
+var fs = require('fs'),
+    util = require('util');
+
+var webdriver = require('./index'),
+    executors = require('./executors'),
+    io = require('./io'),
+    portprober = require('./net/portprober'),
+    remote = require('./remote');
+
+
+/**
+ * @const
+ * @final
+ */
+var IEDRIVER_EXE = 'IEDriverServer.exe';
+
+
+
+/**
+ * IEDriverServer logging levels.
+ * @enum {string}
+ */
+var Level = {
+  FATAL: 'FATAL',
+  ERROR: 'ERROR',
+  WARN: 'WARN',
+  INFO: 'INFO',
+  DEBUG: 'DEBUG',
+  TRACE: 'TRACE'
+};
+
+
+
+/**
+ * Option keys:
+ * https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities#ie-specific
+ * @enum {string}
+ */
+var Key = {
+  IGNORE_PROTECTED_MODE_SETTINGS: 'ignoreProtectedModeSettings',
+  IGNORE_ZOOM_SETTING: 'ignoreZoomSetting',
+  INITIAL_BROWSER_URL: 'initialBrowserUrl',
+  ENABLE_PERSISTENT_HOVER: 'enablePersistentHover',
+  ENABLE_ELEMENT_CACHE_CLEANUP: 'enableElementCacheCleanup',
+  REQUIRE_WINDOW_FOCUS: 'requireWindowFocus',
+  BROWSER_ATTACH_TIMEOUT: 'browserAttachTimeout',
+  FORCE_CREATE_PROCESS: 'ie.forceCreateProcessApi',
+  BROWSER_COMMAND_LINE_SWITCHES: 'ie.browserCommandLineSwitches',
+  USE_PER_PROCESS_PROXY: 'ie.usePerProcessProxy',
+  ENSURE_CLEAN_SESSION: 'ie.ensureCleanSession',
+  LOG_FILE: 'logFile',
+  LOG_LEVEL: 'logLevel',
+  HOST: 'host',
+  EXTRACT_PATH: 'extractPath',
+  SILENT: 'silent'
+};
+
+
+/**
+ * Class for managing IEDriver specific options.
+ * @constructor
+ */
+var Options = function() {
+  /** @private {!Object<(boolean|number|string)>} */
+  this.options_ = {};
+
+  /** @private {(webdriver.ProxyConfig|null)} */
+  this.proxy_ = null;
+};
+
+
+
+/**
+ * Extracts the IEDriver specific options from the given capabilities
+ * object.
+ * @param {!webdriver.Capabilities} capabilities The capabilities object.
+ * @return {!Options} The IEDriver options.
+ */
+Options.fromCapabilities = function(capabilities) {
+  var options = new Options();
+  var map = options.options_;
+
+  Object.keys(Key).forEach(function(key) {
+    key = Key[key];
+    if (capabilities.has(key)) {
+      map[key] = capabilities.get(key);
+    }
+  });
+
+  if (capabilities.has(webdriver.Capability.PROXY)) {
+    options.setProxy(capabilities.get(webdriver.Capability.PROXY));
+  }
+
+  return options;
+};
+
+
+/**
+ * Whether to disable the protected mode settings check when the session is
+ * created. Disbling this setting may lead to significant instability as the
+ * browser may become unresponsive/hang. Only "best effort" support is provided
+ * when using this capability.
+ *
+ * For more information, refer to the IEDriver's
+ * [required system configuration](http://goo.gl/eH0Yi3).
+ *
+ * @param {boolean} ignoreSettings Whether to ignore protected mode settings.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.introduceFlakinessByIgnoringProtectedModeSettings =
+    function(ignoreSettings) {
+      this.options_[Key.IGNORE_PROTECTED_MODE_SETTINGS] = !!ignoreSettings;
+      return this;
+    };
+
+
+/**
+ * Indicates whether to skip the check that the browser's zoom level is set to
+ * 100%.
+ *
+ * @parm {boolean} ignore Whether to ignore the browser's zoom level settings.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.ignoreZoomSetting = function(ignore) {
+  this.options_[Key.IGNORE_ZOOM_SETTING] = !!ignore;
+  return this;
+};
+
+
+/**
+ * Sets the initial URL loaded when IE starts. This is intended to be used with
+ * {@link #ignoreProtectedModeSettings} to allow the user to initialize IE in
+ * the proper Protected Mode zone. Setting this option may cause browser
+ * instability or flaky and unresponsive code. Only "best effort" support is
+ * provided when using this option.
+ *
+ * @param {string} url The initial browser URL.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.initialBrowserUrl = function(url) {
+  this.options_[Key.INITIAL_BROWSER_URL] = url;
+  return this;
+};
+
+
+/**
+ * Configures whether to enable persistent mouse hovering (true by default).
+ * Persistent hovering is achieved by continuously firing mouse over events at
+ * the last location the mouse cursor has been moved to.
+ *
+ * @param {boolean} enable Whether to enable persistent hovering.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.enablePersistentHover = function(enable) {
+  this.options_[Key.ENABLE_PERSISTENT_HOVER] = !!enable;
+  return this;
+};
+
+
+/**
+ * Configures whether the driver should attempt to remove obsolete
+ * {@linkplain webdriver.WebElement WebElements} from its internal cache on
+ * page navigation (true by default). Disabling this option will cause the
+ * driver to run with a larger memory footprint.
+ *
+ * @param {boolean} enable Whether to enable element reference cleanup.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.enableElementCacheCleanup = function(enable) {
+  this.options_[Key.ENABLE_ELEMENT_CACHE_CLEANUP] = !!enable;
+  return this;
+};
+
+
+/**
+ * Configures whether to require the IE window to have input focus before
+ * performing any user interactions (i.e. mouse or keyboard events). This
+ * option is disabled by default, but delivers much more accurate interaction
+ * events when enabled.
+ *
+ * @param {boolean} require Whether to require window focus.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.requireWindowFocus = function(require) {
+  this.options_[Key.REQUIRE_WINDOW_FOCUS] = !!require;
+  return this;
+};
+
+
+/**
+ * Configures the timeout, in milliseconds, that the driver will attempt to
+ * located and attach to a newly opened instance of Internet Explorer. The
+ * default is zero, which indicates waiting indefinitely.
+ *
+ * @param {number} timeout How long to wait for IE.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.browserAttachTimeout = function(timeout) {
+  this.options_[Key.BROWSER_ATTACH_TIMEOUT] = Math.max(timeout, 0);
+  return this;
+};
+
+
+/**
+ * Configures whether to launch Internet Explorer using the CreateProcess API.
+ * If this option is not specified, IE is launched using IELaunchURL, if
+ * available. For IE 8 and above, this option requires the TabProcGrowth
+ * registry value to be set to 0.
+ *
+ * @param {boolean} force Whether to use the CreateProcess API.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.forceCreateProcessApi = function(force) {
+  this.options_[Key.FORCE_CREATE_PROCESS] = !!force;
+  return this;
+};
+
+
+/**
+ * Specifies command-line switches to use when launching Internet Explorer.
+ * This is only valid when used with {@link #forceCreateProcessApi}.
+ *
+ * @param {...(string|!Array.<string>)} var_args The arguments to add.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.addArguments = function(var_args) {
+  var args = this.options_[Key.BROWSER_COMMAND_LINE_SWITCHES] || [];
+  args = args.concat.apply(args, arguments);
+  this.options_[Key.BROWSER_COMMAND_LINE_SWITCHES] = args;
+  return this;
+};
+
+
+/**
+ * Configures whether proxies should be configured on a per-process basis. If
+ * not set, setting a {@linkplain #setProxy proxy} will configure the system
+ * proxy. The default behavior is to use the system proxy.
+ *
+ * @param {boolean} enable Whether to enable per-process proxy settings.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.usePerProcessProxy = function(enable) {
+  this.options_[Key.USE_PER_PROCESS_PROXY] = !!enable;
+  return this;
+};
+
+
+/**
+ * Configures whether to clear the cache, cookies, history, and saved form data
+ * before starting the browser. _Using this capability will clear session data
+ * for all running instances of Internet Explorer, including those started
+ * manually._
+ *
+ * @param {boolean} cleanSession Whether to clear all session data on startup.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.ensureCleanSession = function(cleanSession) {
+  this.options_[Key.ENSURE_CLEAN_SESSION] = !!cleanSession;
+  return this;
+};
+
+
+/**
+ * Sets the path to the log file the driver should log to.
+ * @param {string} path The log file path.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setLogFile = function(file) {
+  this.options_[Key.LOG_FILE] = file;
+  return this;
+};
+
+
+/**
+ * Sets the IEDriverServer's logging {@linkplain Level level}.
+ * @param {Level} level The logging level.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setLogLevel = function(level) {
+  this.options_[Key.LOG_LEVEL] = level;
+  return this;
+};
+
+
+/**
+ * Sets the IP address of the driver's host adapter.
+ * @param {string} host The IP address to use.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setHost = function(host) {
+  this.options_[Key.HOST] = host;
+  return this;
+};
+
+
+/**
+ * Sets the path of the temporary data directory to use.
+ * @param {string} path The log file path.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setExtractPath = function(path) {
+  this.options_[Key.EXTRACT_PATH] = path;
+  return this;
+};
+
+
+/**
+ * Sets whether the driver should start in silent mode.
+ * @param {boolean} silent Whether to run in silent mode.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.silent = function(silent) {
+  this.options_[Key.SILENT] = silent;
+  return this;
+};
+
+
+/**
+ * Sets the proxy settings for the new session.
+ * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setProxy = function(proxy) {
+  this.proxy_ = proxy;
+  return this;
+};
+
+
+/**
+ * Converts this options instance to a {@link webdriver.Capabilities} object.
+ * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge
+ *     these options into, if any.
+ * @return {!webdriver.Capabilities} The capabilities.
+ */
+Options.prototype.toCapabilities = function(opt_capabilities) {
+  var capabilities = opt_capabilities || webdriver.Capabilities.ie();
+  if (this.proxy_) {
+    capabilities.set(webdriver.Capability.PROXY, this.proxy_);
+  }
+  Object.keys(this.options_).forEach(function(key) {
+    capabilities.set(key, this.options_[key]);
+  }, this);
+  return capabilities;
+};
+
+
+function createServiceFromCapabilities(capabilities) {
+  if (process.platform !== 'win32') {
+    throw Error(
+        'The IEDriver may only be used on Windows, but you appear to be on ' +
+        process.platform + '. Did you mean to run against a remote ' +
+        'WebDriver server?');
+  }
+
+  var exe = io.findInPath(IEDRIVER_EXE, true);
+  if (!fs.existsSync(exe)) {
+    throw Error('File does not exist: ' + exe);
+  }
+ 
+  var args = [];
+  if (capabilities.has(Key.HOST)) {
+    args.push('--host=' + capabilities.get(Key.HOST));
+  }
+  if (capabilities.has(Key.LOG_FILE)) {
+    args.push('--log-file=' + capabilities.get(Key.LOG_FILE));
+  }
+  if (capabilities.has(Key.LOG_LEVEL)) {
+    args.push('--log-level=' + capabilities.get(Key.LOG_LEVEL));
+  }
+  if (capabilities.has(Key.EXTRACT_PATH)) {
+    args.push('--extract-path=' + capabilities.get(Key.EXTRACT_PATH));
+  }
+  if (capabilities.get(Key.SILENT)) {
+    args.push('--silent');
+  }
+
+  var port = portprober.findFreePort();
+  return new remote.DriverService(exe, {
+    loopback: true,
+    port: port,
+    args: port.then(function(port) {
+      return args.concat('--port=' + port);
+    }),
+    stdio: 'ignore'
+  });
+}
+
+
+/**
+ * A WebDriver client for Microsoft's Internet Explorer.
+ *
+ * @param {(webdriver.Capabilities|Options)=} opt_config The configuration
+ *     options.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or
+ *     {@code null} to use the currently active flow.
+ * @constructor
+ * @extends {webdriver.WebDriver}
+ */
+var Driver = function(opt_config, opt_flow) {
+  var capabilities = opt_config instanceof Options ? 
+      opt_config.toCapabilities() :
+      (opt_config || webdriver.Capabilities.ie());
+
+  var service = createServiceFromCapabilities(capabilities);
+  var executor = executors.createExecutor(service.start());
+  var driver = webdriver.WebDriver.createSession(
+      executor, capabilities, opt_flow);
+
+  webdriver.WebDriver.call(
+      this, driver.getSession(), executor, driver.controlFlow());
+
+  var boundQuit = this.quit.bind(this);
+
+  /** @override */
+  this.quit = function() {
+    return boundQuit().thenFinally(service.kill.bind(service));
+  };
+};
+util.inherits(Driver, webdriver.WebDriver);
+
+
+/**
+ * This function is a no-op as file detectors are not supported by this
+ * implementation.
+ * @override
+ */
+Driver.prototype.setFileDetector = function() {
+};
+
+
+// PUBLIC API
+
+
+exports.Driver = Driver;
+exports.Options = Options;
+exports.Level = Level;
diff --git a/index.js b/index.js
index 7391fdb..b45b560 100644
--- a/index.js
+++ b/index.js
@@ -1,17 +1,19 @@
-// Copyright 2012 Selenium committers
-// Copyright 2012 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview The main user facing module. Exports WebDriver's primary
@@ -52,6 +54,14 @@ exports.Command = base.require('webdriver.Command');
 exports.EventEmitter = base.require('webdriver.EventEmitter');
 
 
+/** @type {function(new: webdriver.FileDetector)} */
+exports.FileDetector = base.require('webdriver.FileDetector');
+
+
+/** @type {function(new: webdriver.Serializable)} */
+exports.Serializable = base.require('webdriver.Serializable');
+
+
 /** @type {function(new: webdriver.Session)} */
 exports.Session = base.require('webdriver.Session');
 
@@ -64,6 +74,10 @@ exports.WebDriver = base.require('webdriver.WebDriver');
 exports.WebElement = base.require('webdriver.WebElement');
 
 
+/** @type {function(new: webdriver.WebElementPromise)} */
+exports.WebElementPromise = base.require('webdriver.WebElementPromise');
+
+
 // Export the remainder of our API through getters to keep things cleaner
 // when this module is used in a REPL environment.
 
@@ -126,3 +140,9 @@ exports.WebElement = base.require('webdriver.WebElement');
 (exports.__defineGetter__('stacktrace', function() {
   return base.exportPublicApi('webdriver.stacktrace');
 }));
+
+
+/** @type {webdriver.until.} */
+(exports.__defineGetter__('until', function() {
+  return base.exportPublicApi('webdriver.until');
+}));
diff --git a/io/exec.js b/io/exec.js
new file mode 100644
index 0000000..187ea78
--- /dev/null
+++ b/io/exec.js
@@ -0,0 +1,140 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var childProcess = require('child_process');
+
+var promise = require('..').promise;
+
+
+/**
+ * A hash with configuration options for an executed command.
+ *
+ * - `args` - Command line arguments.
+ * - `env` - Command environment; will inherit from the current process if
+ *     missing.
+ * - `stdio` - IO configuration for the spawned server process. For more
+ *     information, refer to the documentation of `child_process.spawn`.
+ *
+ * @typedef {{
+ *   args: (!Array.<string>|undefined),
+ *   env: (!Object.<string, string>|undefined),
+ *   stdio: (string|!Array.<string|number|!Stream|null|undefined>|undefined)
+ * }}
+ */
+var Options;
+
+
+/**
+ * Describes a command's termination conditions.
+ * @param {?number} code The exit code, or {@code null} if the command did not
+ *     exit normally.
+ * @param {?string} signal The signal used to kill the command, or
+ *     {@code null}.
+ * @constructor
+ */
+var Result = function(code, signal) {
+  /** @type {?number} */
+  this.code = code;
+
+  /** @type {?string} */
+  this.signal = signal;
+};
+
+
+/** @override */
+Result.prototype.toString = function() {
+  return 'Result(code=' + this.code + ', signal=' + this.signal + ')';
+};
+
+
+
+/**
+ * Represents a command running in a sub-process.
+ * @param {!promise.Promise.<!Result>} result The command result.
+ * @constructor
+ */
+var Command = function(result, onKill) {
+  /** @return {boolean} Whether this command is still running. */
+  this.isRunning = function() {
+    return result.isPending();
+  };
+
+  /**
+   * @return {!promise.Promise.<!Result>} A promise for the result of this
+   *     command.
+   */
+  this.result = function() {
+    return result;
+  };
+
+  /**
+   * Sends a signal to the underlying process.
+   * @param {string=} opt_signal The signal to send; defaults to
+   *     {@code SIGTERM}.
+   */
+  this.kill = function(opt_signal) {
+    onKill(opt_signal || 'SIGTERM');
+  };
+};
+
+
+// PUBLIC API
+
+
+/**
+ * Spawns a child process. The returned {@link Command} may be used to wait
+ * for the process result or to send signals to the process.
+ *
+ * @param {string} command The executable to spawn.
+ * @param {Options=} opt_options The command options.
+ * @return {!Command} The launched command.
+ */
+module.exports = function(command, opt_options) {
+  var options = opt_options || {};
+
+  var proc = childProcess.spawn(command, options.args || [], {
+    env: options.env || process.env,
+    stdio: options.stdio || 'ignore'
+  }).once('exit', onExit);
+
+  // This process should not wait on the spawned child, however, we do
+  // want to ensure the child is killed when this process exits.
+  proc.unref();
+  process.once('exit', killCommand);
+
+  var result = promise.defer();
+  var cmd = new Command(result.promise, function(signal) {
+    if (!result.isPending() || !proc) {
+      return;  // No longer running.
+    }
+    proc.kill(signal);
+  });
+  return cmd;
+
+  function onExit(code, signal) {
+    proc = null;
+    process.removeListener('exit', killCommand);
+    result.fulfill(new Result(code, signal));
+  }
+
+  function killCommand() {
+    process.removeListener('exit', killCommand);
+    proc && proc.kill('SIGTERM');
+  }
+};
diff --git a/io/index.js b/io/index.js
index 5d5a3de..3077c46 100644
--- a/io/index.js
+++ b/io/index.js
@@ -1,28 +1,197 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 var fs = require('fs'),
-    path = require('path');
+    path = require('path'),
+    rimraf = require('rimraf'),
+    tmp = require('tmp');
 
+var promise = require('..').promise;
 
-var PATH_SEPARATOR = process.platform === 'win32' ? ';' : ':';
 
 
 // PUBLIC API
 
 
+
+/**
+ * Recursively removes a directory and all of its contents. This is equivalent
+ * to {@code rm -rf} on a POSIX system.
+ * @param {string} path Path to the directory to remove.
+ * @return {!promise.Promise} A promise to be resolved when the operation has
+ *     completed.
+ */
+exports.rmDir = function(path) {
+  return new promise.Promise(function(fulfill, reject) {
+    var numAttempts = 0;
+    attemptRm();
+    function attemptRm() {
+      numAttempts += 1;
+      rimraf(path, function(err) {
+        if (err) {
+          if (err.code === 'ENOTEMPTY' && numAttempts < 2) {
+            attemptRm();
+            return;
+          }
+          reject(err);
+        } else {
+          fulfill();
+        }
+      });
+    }
+  });
+};
+
+
+/**
+ * Copies one file to another.
+ * @param {string} src The source file.
+ * @param {string} dst The destination file.
+ * @return {!promise.Promise.<string>} A promise for the copied file's path.
+ */
+exports.copy = function(src, dst) {
+  var copied = promise.defer();
+
+  var rs = fs.createReadStream(src);
+  rs.on('error', copied.reject);
+  rs.on('end', function() {
+    copied.fulfill(dst);
+  });
+
+  var ws = fs.createWriteStream(dst);
+  ws.on('error', copied.reject);
+
+  rs.pipe(ws);
+
+  return copied.promise;
+};
+
+
+/**
+ * Recursively copies the contents of one directory to another.
+ * @param {string} src The source directory to copy.
+ * @param {string} dst The directory to copy into.
+ * @param {(RegEx|function(string): boolean)=} opt_exclude An exclusion filter
+ *     as either a regex or predicate function. All files matching this filter
+ *     will not be copied.
+ * @return {!promise.Promise.<string>} A promise for the destination
+ *     directory's path once all files have been copied.
+ */
+exports.copyDir = function(src, dst, opt_exclude) {
+  var predicate = opt_exclude;
+  if (opt_exclude && typeof opt_exclude !== 'function') {
+    predicate = function(p) {
+      return !opt_exclude.test(p);
+    };
+  }
+
+  // TODO(jleyba): Make this function completely async.
+  if (!fs.existsSync(dst)) {
+    fs.mkdirSync(dst);
+  }
+
+  var files = fs.readdirSync(src);
+  files = files.map(function(file) {
+    return path.join(src, file);
+  });
+
+  if (predicate) {
+    files = files.filter(predicate);
+  }
+
+  var results = [];
+  files.forEach(function(file) {
+    var stats = fs.statSync(file);
+    var target = path.join(dst, path.basename(file));
+
+    if (stats.isDirectory()) {
+      if (!fs.existsSync(target)) {
+        fs.mkdirSync(target, stats.mode);
+      }
+      results.push(exports.copyDir(file, target, predicate));
+    } else {
+      results.push(exports.copy(file, target));
+    }
+  });
+
+  return promise.all(results).then(function() {
+    return dst;
+  });
+};
+
+
+/**
+ * Tests if a file path exists.
+ * @param {string} path The path to test.
+ * @return {!promise.Promise.<boolean>} A promise for whether the file exists.
+ */
+exports.exists = function(path) {
+  var result = promise.defer();
+  fs.exists(path, result.fulfill);
+  return result.promise;
+};
+
+
+/**
+ * Deletes a name from the filesystem and possibly the file it refers to. Has
+ * no effect if the file does not exist.
+ * @param {string} path The path to remove.
+ * @return {!promise.Promise} A promise for when the file has been removed.
+ */
+exports.unlink = function(path) {
+  return new promise.Promise(function(fulfill, reject) {
+    fs.exists(path, function(exists) {
+      if (exists) {
+        fs.unlink(path, function(err) {
+          err && reject(err) || fulfill();
+        });
+      } else {
+        fulfill();
+      }
+    });
+  });
+};
+
+
+/**
+ * @return {!promise.Promise.<string>} A promise for the path to a temporary
+ *     directory.
+ * @see https://www.npmjs.org/package/tmp
+ */
+exports.tmpDir = function() {
+  return promise.checkedNodeCall(tmp.dir);
+};
+
+
+/**
+ * @param {{postfix: string}=} opt_options Temporary file options.
+ * @return {!promise.Promise.<string>} A promise for the path to a temporary
+ *     file.
+ * @see https://www.npmjs.org/package/tmp
+ */
+exports.tmpFile = function(opt_options) {
+  // |tmp.file| checks arguments length to detect options rather than doing a
+  // truthy check, so we must only pass options if there are some to pass.
+  return opt_options ?
+      promise.checkedNodeCall(tmp.file, opt_options) :
+      promise.checkedNodeCall(tmp.file);
+};
+
+
 /**
  * Searches the {@code PATH} environment variable for the given file.
  * @param {string} file The file to locate on the PATH.
@@ -40,7 +209,7 @@ exports.findInPath = function(file, opt_checkCwd) {
     }
   }
 
-  var dirs = process.env['PATH'].split(PATH_SEPARATOR);
+  var dirs = process.env['PATH'].split(path.delimiter);
   var found = null;
   dirs.forEach(function(dir) {
     var tmp = path.join(dir, file);
diff --git a/lib/atoms/error.js b/lib/atoms/error.js
index 5b23ff9..6fb2e1f 100644
--- a/lib/atoms/error.js
+++ b/lib/atoms/error.js
@@ -1,21 +1,23 @@
-// Copyright 2010 WebDriver committers
-// Copyright 2010 Google Inc.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Utilities for working with errors as defined by WebDriver's
- * wire protocol: http://code.google.com/p/selenium/wiki/JsonWireProtocol.
+ * wire protocol: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol
  */
 
 goog.provide('bot.Error');
@@ -23,8 +25,8 @@ goog.provide('bot.ErrorCode');
 
 
 /**
- * Error codes from the WebDriver wire protocol:
- * http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes
+ * Error codes from the Selenium WebDriver protocol:
+ * https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#response-status-codes
  *
  * @enum {number}
  */
@@ -46,8 +48,8 @@ bot.ErrorCode = {
   NO_SUCH_WINDOW: 23,
   INVALID_COOKIE_DOMAIN: 24,
   UNABLE_TO_SET_COOKIE: 25,
-  MODAL_DIALOG_OPENED: 26,
-  NO_MODAL_DIALOG_OPEN: 27,
+  UNEXPECTED_ALERT_OPEN: 26,
+  NO_SUCH_ALERT: 27,
   SCRIPT_TIMEOUT: 28,
   INVALID_ELEMENT_COORDINATES: 29,
   IME_NOT_AVAILABLE: 30,
@@ -63,11 +65,8 @@ bot.ErrorCode = {
 };
 
 
-
 /**
- * Error extension that includes error status codes from the WebDriver wire
- * protocol:
- * http://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes
+ * Represents an error returned from a WebDriver command request.
  *
  * @param {!bot.ErrorCode} code The error's status code.
  * @param {string=} opt_message Optional error message.
@@ -116,35 +115,34 @@ goog.inherits(bot.Error, Error);
 
 
 /**
- * Status strings enumerated in the W3C WebDriver working draft.
+ * Status strings enumerated in the W3C WebDriver protocol.
  * @enum {string}
- * @see http://www.w3.org/TR/webdriver/#status-codes
+ * @see https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors
  */
 bot.Error.State = {
   ELEMENT_NOT_SELECTABLE: 'element not selectable',
   ELEMENT_NOT_VISIBLE: 'element not visible',
-  IME_ENGINE_ACTIVATION_FAILED: 'ime engine activation failed',
-  IME_NOT_AVAILABLE: 'ime not available',
+  INVALID_ARGUMENT: 'invalid argument',
   INVALID_COOKIE_DOMAIN: 'invalid cookie domain',
   INVALID_ELEMENT_COORDINATES: 'invalid element coordinates',
   INVALID_ELEMENT_STATE: 'invalid element state',
   INVALID_SELECTOR: 'invalid selector',
+  INVALID_SESSION_ID: 'invalid session id',
   JAVASCRIPT_ERROR: 'javascript error',
   MOVE_TARGET_OUT_OF_BOUNDS: 'move target out of bounds',
   NO_SUCH_ALERT: 'no such alert',
-  NO_SUCH_DOM: 'no such dom',
   NO_SUCH_ELEMENT: 'no such element',
   NO_SUCH_FRAME: 'no such frame',
   NO_SUCH_WINDOW: 'no such window',
   SCRIPT_TIMEOUT: 'script timeout',
   SESSION_NOT_CREATED: 'session not created',
   STALE_ELEMENT_REFERENCE: 'stale element reference',
-  SUCCESS: 'success',
   TIMEOUT: 'timeout',
   UNABLE_TO_SET_COOKIE: 'unable to set cookie',
   UNEXPECTED_ALERT_OPEN: 'unexpected alert open',
   UNKNOWN_COMMAND: 'unknown command',
   UNKNOWN_ERROR: 'unknown error',
+  UNKNOWN_METHOD: 'unknown method',
   UNSUPPORTED_OPERATION: 'unsupported operation'
 };
 
@@ -161,8 +159,8 @@ goog.scope(function() {
 
   map[code.ELEMENT_NOT_SELECTABLE] = state.ELEMENT_NOT_SELECTABLE;
   map[code.ELEMENT_NOT_VISIBLE] = state.ELEMENT_NOT_VISIBLE;
-  map[code.IME_ENGINE_ACTIVATION_FAILED] = state.IME_ENGINE_ACTIVATION_FAILED;
-  map[code.IME_NOT_AVAILABLE] = state.IME_NOT_AVAILABLE;
+  map[code.IME_ENGINE_ACTIVATION_FAILED] = state.UNKNOWN_ERROR;
+  map[code.IME_NOT_AVAILABLE] = state.UNKNOWN_ERROR;
   map[code.INVALID_COOKIE_DOMAIN] = state.INVALID_COOKIE_DOMAIN;
   map[code.INVALID_ELEMENT_COORDINATES] = state.INVALID_ELEMENT_COORDINATES;
   map[code.INVALID_ELEMENT_STATE] = state.INVALID_ELEMENT_STATE;
@@ -172,17 +170,16 @@ goog.scope(function() {
   map[code.JAVASCRIPT_ERROR] = state.JAVASCRIPT_ERROR;
   map[code.METHOD_NOT_ALLOWED] = state.UNSUPPORTED_OPERATION;
   map[code.MOVE_TARGET_OUT_OF_BOUNDS] = state.MOVE_TARGET_OUT_OF_BOUNDS;
-  map[code.NO_MODAL_DIALOG_OPEN] = state.NO_SUCH_ALERT;
+  map[code.NO_SUCH_ALERT] = state.NO_SUCH_ALERT;
   map[code.NO_SUCH_ELEMENT] = state.NO_SUCH_ELEMENT;
   map[code.NO_SUCH_FRAME] = state.NO_SUCH_FRAME;
   map[code.NO_SUCH_WINDOW] = state.NO_SUCH_WINDOW;
   map[code.SCRIPT_TIMEOUT] = state.SCRIPT_TIMEOUT;
   map[code.SESSION_NOT_CREATED] = state.SESSION_NOT_CREATED;
   map[code.STALE_ELEMENT_REFERENCE] = state.STALE_ELEMENT_REFERENCE;
-  map[code.SUCCESS] = state.SUCCESS;
   map[code.TIMEOUT] = state.TIMEOUT;
   map[code.UNABLE_TO_SET_COOKIE] = state.UNABLE_TO_SET_COOKIE;
-  map[code.MODAL_DIALOG_OPENED] = state.UNEXPECTED_ALERT_OPEN;
+  map[code.UNEXPECTED_ALERT_OPEN] = state.UNEXPECTED_ALERT_OPEN
   map[code.UNKNOWN_ERROR] = state.UNKNOWN_ERROR;
   map[code.UNSUPPORTED_OPERATION] = state.UNKNOWN_COMMAND;
 });  // goog.scope
diff --git a/lib/atoms/json.js b/lib/atoms/json.js
index b3e863c..24e1c77 100644
--- a/lib/atoms/json.js
+++ b/lib/atoms/json.js
@@ -1,17 +1,19 @@
-// Copyright 2012 WebDriver committers
-// Copyright 2012 Google Inc.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Provides JSON utilities that uses native JSON parsing where
@@ -47,10 +49,10 @@ bot.json.NATIVE_JSON = true;
  * @private {boolean}
  */
 bot.json.SUPPORTS_NATIVE_JSON_ =
-    // List WebKit and Opera first since every supported version of these
-    // browsers supports native JSON (and we can compile away large chunks of
-    // code for individual fragments by setting the appropriate compiler flags).
-    goog.userAgent.WEBKIT || goog.userAgent.OPERA ||
+    // List WebKit first since every supported version supports
+    // native JSON (and we can compile away large chunks of code for
+    // individual fragments by setting the appropriate compiler flags).
+    goog.userAgent.WEBKIT ||
         (goog.userAgent.GECKO && bot.userAgent.isEngineVersion(3.5)) ||
         (goog.userAgent.IE && bot.userAgent.isEngineVersion(8));
 
diff --git a/lib/atoms/response.js b/lib/atoms/response.js
index d929a66..b14aeeb 100644
--- a/lib/atoms/response.js
+++ b/lib/atoms/response.js
@@ -1,20 +1,23 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Utilities for working with WebDriver response objects.
- * @see: http://code.google.com/p/selenium/wiki/JsonWireProtocol#Responses
+ * @see: hhttps://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#responses
  */
 
 goog.provide('bot.response');
@@ -27,7 +30,7 @@ goog.require('bot.ErrorCode');
 /**
  * Type definition for a response object, as defined by the JSON wire protocol.
  * @typedef {{status: bot.ErrorCode, value: (*|{message: string})}}
- * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Responses
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#responses
  */
 bot.response.ResponseObject;
 
@@ -87,7 +90,7 @@ bot.response.createErrorResponse = function(error) {
  *     check.
  * @return {!bot.response.ResponseObject} The checked response object.
  * @throws {bot.Error} If the response describes an error.
- * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Failed_Commands
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#failed-commands
  */
 bot.response.checkResponse = function(responseObj) {
   var status = responseObj['status'];
diff --git a/lib/atoms/userAgent.js b/lib/atoms/userAgent.js
index 60964d0..f4a75c2 100644
--- a/lib/atoms/userAgent.js
+++ b/lib/atoms/userAgent.js
@@ -1,17 +1,19 @@
-// Copyright 2011 WebDriver committers
-// Copyright 2011 Google Inc.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Similar to goog.userAgent.isVersion, but with support for
diff --git a/lib/firefox/amd64/libnoblur64.so b/lib/firefox/amd64/libnoblur64.so
new file mode 100644
index 0000000..916e530
Binary files /dev/null and b/lib/firefox/amd64/libnoblur64.so differ
diff --git a/lib/firefox/i386/libnoblur.so b/lib/firefox/i386/libnoblur.so
new file mode 100644
index 0000000..8e7db8d
Binary files /dev/null and b/lib/firefox/i386/libnoblur.so differ
diff --git a/lib/firefox/webdriver.json b/lib/firefox/webdriver.json
new file mode 100644
index 0000000..14ba421
--- /dev/null
+++ b/lib/firefox/webdriver.json
@@ -0,0 +1,73 @@
+{
+  "frozen": {
+    "app.update.auto": false,
+    "app.update.enabled": false,
+    "browser.displayedE10SNotice": 4,
+    "browser.download.manager.showWhenStarting": false,
+    "browser.EULA.override": true,
+    "browser.EULA.3.accepted": true,
+    "browser.link.open_external": 2,
+    "browser.link.open_newwindow": 2,
+    "browser.offline": false,
+    "browser.reader.detectedFirstArticle": true,
+    "browser.safebrowsing.enabled": false,
+    "browser.safebrowsing.malware.enabled": false,
+    "browser.search.update": false,
+    "browser.selfsupport.url" : "",
+    "browser.sessionstore.resume_from_crash": false,
+    "browser.shell.checkDefaultBrowser": false,
+    "browser.tabs.warnOnClose": false,
+    "browser.tabs.warnOnOpen": false,
+    "datareporting.healthreport.service.enabled": false,
+    "datareporting.healthreport.uploadEnabled": false,
+    "datareporting.healthreport.service.firstRun": false,
+    "datareporting.healthreport.logging.consoleEnabled": false,
+    "datareporting.policy.dataSubmissionEnabled": false,
+    "datareporting.policy.dataSubmissionPolicyAccepted": false,
+    "devtools.errorconsole.enabled": true,
+    "dom.disable_open_during_load": false,
+    "extensions.autoDisableScopes": 10,
+    "extensions.blocklist.enabled": false,
+    "extensions.logging.enabled": true,
+    "extensions.update.enabled": false,
+    "extensions.update.notifyUser": false,
+    "javascript.enabled": true,
+    "network.manage-offline-status": false,
+    "network.http.phishy-userpass-length": 255,
+    "offline-apps.allow_by_default": true,
+    "prompts.tab_modal.enabled": false,
+    "security.csp.enable": false,
+    "security.fileuri.origin_policy": 3,
+    "security.fileuri.strict_origin_policy": false,
+    "security.warn_entering_secure": false,
+    "security.warn_entering_secure.show_once": false,
+    "security.warn_entering_weak": false,
+    "security.warn_entering_weak.show_once": false,
+    "security.warn_leaving_secure": false,
+    "security.warn_leaving_secure.show_once": false,
+    "security.warn_submit_insecure": false,
+    "security.warn_viewing_mixed": false,
+    "security.warn_viewing_mixed.show_once": false,
+    "signon.rememberSignons": false,
+    "toolkit.networkmanager.disable": true,
+    "toolkit.telemetry.prompted": 2,
+    "toolkit.telemetry.enabled": false,
+    "toolkit.telemetry.rejected": true,
+    "xpinstall.signatures.required": false
+  },
+  "mutable": {
+    "browser.dom.window.dump.enabled": true,
+    "browser.newtab.url": "about:blank",
+    "browser.newtabpage.enabled": false,
+    "browser.startup.page": 0,
+    "browser.startup.homepage": "about:blank",
+    "dom.max_chrome_script_run_time": 30,
+    "dom.max_script_run_time": 30,
+    "dom.report_all_js_exceptions": true,
+    "javascript.options.showInConsole": true,
+    "network.http.max-connections-per-server": 10,
+    "startup.homepage_welcome_url": "about:blank",
+    "webdriver_accept_untrusted_certs": true,
+    "webdriver_assume_untrusted_issuer": true
+  }
+}
diff --git a/lib/firefox/webdriver.xpi b/lib/firefox/webdriver.xpi
new file mode 100644
index 0000000..198bc83
Binary files /dev/null and b/lib/firefox/webdriver.xpi differ
diff --git a/lib/goog/array/array.js b/lib/goog/array/array.js
index 5eea925..990a6d5 100644
--- a/lib/goog/array/array.js
+++ b/lib/goog/array/array.js
@@ -15,6 +15,7 @@
 /**
  * @fileoverview Utilities for manipulating arrays.
  *
+ * @author arv@google.com (Erik Arvidsson)
  */
 
 
@@ -42,6 +43,14 @@ goog.require('goog.asserts');
 goog.define('goog.NATIVE_ARRAY_PROTOTYPES', goog.TRUSTED_SITE);
 
 
+/**
+ * @define {boolean} If true, JSCompiler will use the native implementation of
+ * array functions where appropriate (e.g., {@code Array#filter}) and remove the
+ * unused pure JS implementation.
+ */
+goog.define('goog.array.ASSUME_NATIVE_FUNCTIONS', false);
+
+
 /**
  * @typedef {Array|NodeList|Arguments|{length: number}}
  */
@@ -50,17 +59,29 @@ goog.array.ArrayLike;
 
 /**
  * Returns the last element in an array without removing it.
- * @param {goog.array.ArrayLike} array The array.
- * @return {*} Last item in array.
+ * Same as goog.array.last.
+ * @param {Array<T>|goog.array.ArrayLike} array The array.
+ * @return {T} Last item in array.
+ * @template T
  */
 goog.array.peek = function(array) {
   return array[array.length - 1];
 };
 
 
+/**
+ * Returns the last element in an array without removing it.
+ * Same as goog.array.peek.
+ * @param {Array<T>|goog.array.ArrayLike} array The array.
+ * @return {T} Last item in array.
+ * @template T
+ */
+goog.array.last = goog.array.peek;
+
+
 /**
  * Reference to the original {@code Array.prototype}.
- * @private
+ * @private {!Object}
  */
 goog.array.ARRAY_PROTOTYPE_ = Array.prototype;
 
@@ -73,19 +94,21 @@ goog.array.ARRAY_PROTOTYPE_ = Array.prototype;
 
 
 /**
- * Returns the index of the first element of an array with a specified
- * value, or -1 if the element is not present in the array.
+ * Returns the index of the first element of an array with a specified value, or
+ * -1 if the element is not present in the array.
  *
  * See {@link http://tinyurl.com/developer-mozilla-org-array-indexof}
  *
- * @param {goog.array.ArrayLike} arr The array to be searched.
- * @param {*} obj The object for which we are searching.
+ * @param {Array<T>|goog.array.ArrayLike} arr The array to be searched.
+ * @param {T} obj The object for which we are searching.
  * @param {number=} opt_fromIndex The index at which to start the search. If
  *     omitted the search starts at index 0.
  * @return {number} The index of the first matching array element.
+ * @template T
  */
 goog.array.indexOf = goog.NATIVE_ARRAY_PROTOTYPES &&
-                     goog.array.ARRAY_PROTOTYPE_.indexOf ?
+                     (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                      goog.array.ARRAY_PROTOTYPE_.indexOf) ?
     function(arr, obj, opt_fromIndex) {
       goog.asserts.assert(arr.length != null);
 
@@ -118,14 +141,16 @@ goog.array.indexOf = goog.NATIVE_ARRAY_PROTOTYPES &&
  *
  * See {@link http://tinyurl.com/developer-mozilla-org-array-lastindexof}
  *
- * @param {goog.array.ArrayLike} arr The array to be searched.
- * @param {*} obj The object for which we are searching.
+ * @param {!Array<T>|!goog.array.ArrayLike} arr The array to be searched.
+ * @param {T} obj The object for which we are searching.
  * @param {?number=} opt_fromIndex The index at which to start the search. If
  *     omitted the search starts at the end of the array.
  * @return {number} The index of the last matching array element.
+ * @template T
  */
 goog.array.lastIndexOf = goog.NATIVE_ARRAY_PROTOTYPES &&
-                         goog.array.ARRAY_PROTOTYPE_.lastIndexOf ?
+                         (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                          goog.array.ARRAY_PROTOTYPE_.lastIndexOf) ?
     function(arr, obj, opt_fromIndex) {
       goog.asserts.assert(arr.length != null);
 
@@ -161,7 +186,7 @@ goog.array.lastIndexOf = goog.NATIVE_ARRAY_PROTOTYPES &&
  * Calls a function for each element in an array. Skips holes in the array.
  * See {@link http://tinyurl.com/developer-mozilla-org-array-foreach}
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array like object over
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array like object over
  *     which to iterate.
  * @param {?function(this: S, T, number, ?): ?} f The function to call for every
  *     element. This function takes 3 arguments (the element, the index and the
@@ -170,7 +195,8 @@ goog.array.lastIndexOf = goog.NATIVE_ARRAY_PROTOTYPES &&
  * @template T,S
  */
 goog.array.forEach = goog.NATIVE_ARRAY_PROTOTYPES &&
-                     goog.array.ARRAY_PROTOTYPE_.forEach ?
+                     (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                      goog.array.ARRAY_PROTOTYPE_.forEach) ?
     function(arr, f, opt_obj) {
       goog.asserts.assert(arr.length != null);
 
@@ -191,7 +217,7 @@ goog.array.forEach = goog.NATIVE_ARRAY_PROTOTYPES &&
  * Calls a function for each element in an array, starting from the last
  * element rather than the first.
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this: S, T, number, ?): ?} f The function to call for every
  *     element. This function
@@ -218,7 +244,7 @@ goog.array.forEachRight = function(arr, f, opt_obj) {
  *
  * See {@link http://tinyurl.com/developer-mozilla-org-array-filter}
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, T, number, ?):boolean} f The function to call for
  *     every element. This function
@@ -227,12 +253,13 @@ goog.array.forEachRight = function(arr, f, opt_obj) {
  *     result array. If it is false the element is not included.
  * @param {S=} opt_obj The object to be used as the value of 'this'
  *     within f.
- * @return {!Array} a new array in which only elements that passed the test are
- *     present.
+ * @return {!Array<T>} a new array in which only elements that passed the test
+ *     are present.
  * @template T,S
  */
 goog.array.filter = goog.NATIVE_ARRAY_PROTOTYPES &&
-                    goog.array.ARRAY_PROTOTYPE_.filter ?
+                    (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                     goog.array.ARRAY_PROTOTYPE_.filter) ?
     function(arr, f, opt_obj) {
       goog.asserts.assert(arr.length != null);
 
@@ -261,19 +288,19 @@ goog.array.filter = goog.NATIVE_ARRAY_PROTOTYPES &&
  *
  * See {@link http://tinyurl.com/developer-mozilla-org-array-map}
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
- *     like object over which to iterate.
- * @param {?function(this:S, T, number, ?):?} f The function to call for every
- *     element. This function
- *     takes 3 arguments (the element, the index and the array) and should
- *     return something. The result will be inserted into a new array.
- * @param {S=} opt_obj The object to be used as the value of 'this'
- *     within f.
- * @return {!Array} a new array with the results from f.
- * @template T,S
+ * @param {Array<VALUE>|goog.array.ArrayLike} arr Array or array like object
+ *     over which to iterate.
+ * @param {function(this:THIS, VALUE, number, ?): RESULT} f The function to call
+ *     for every element. This function takes 3 arguments (the element,
+ *     the index and the array) and should return something. The result will be
+ *     inserted into a new array.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this' within f.
+ * @return {!Array<RESULT>} a new array with the results from f.
+ * @template THIS, VALUE, RESULT
  */
 goog.array.map = goog.NATIVE_ARRAY_PROTOTYPES &&
-                 goog.array.ARRAY_PROTOTYPE_.map ?
+                 (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                  goog.array.ARRAY_PROTOTYPE_.map) ?
     function(arr, f, opt_obj) {
       goog.asserts.assert(arr.length != null);
 
@@ -302,9 +329,9 @@ goog.array.map = goog.NATIVE_ARRAY_PROTOTYPES &&
  * goog.array.reduce(a, function(r, v, i, arr) {return r + v;}, 0);
  * returns 10
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
- * @param {?function(this:S, R, T, number, ?) : R} f The function to call for
+ * @param {function(this:S, R, T, number, ?) : R} f The function to call for
  *     every element. This function
  *     takes 4 arguments (the function's previous result or the initial value,
  *     the value of the current array element, the current array index, and the
@@ -316,20 +343,23 @@ goog.array.map = goog.NATIVE_ARRAY_PROTOTYPES &&
  * @return {R} Result of evaluating f repeatedly across the values of the array.
  * @template T,S,R
  */
-goog.array.reduce = function(arr, f, val, opt_obj) {
-  if (arr.reduce) {
-    if (opt_obj) {
-      return arr.reduce(goog.bind(f, opt_obj), val);
-    } else {
-      return arr.reduce(f, val);
-    }
-  }
-  var rval = val;
-  goog.array.forEach(arr, function(val, index) {
-    rval = f.call(opt_obj, rval, val, index, arr);
-  });
-  return rval;
-};
+goog.array.reduce = goog.NATIVE_ARRAY_PROTOTYPES &&
+                    (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                     goog.array.ARRAY_PROTOTYPE_.reduce) ?
+    function(arr, f, val, opt_obj) {
+      goog.asserts.assert(arr.length != null);
+      if (opt_obj) {
+        f = goog.bind(f, opt_obj);
+      }
+      return goog.array.ARRAY_PROTOTYPE_.reduce.call(arr, f, val);
+    } :
+    function(arr, f, val, opt_obj) {
+      var rval = val;
+      goog.array.forEach(arr, function(val, index) {
+        rval = f.call(opt_obj, rval, val, index, arr);
+      });
+      return rval;
+    };
 
 
 /**
@@ -343,7 +373,7 @@ goog.array.reduce = function(arr, f, val, opt_obj) {
  * goog.array.reduceRight(a, function(r, v, i, arr) {return r + v;}, '');
  * returns 'cba'
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, R, T, number, ?) : R} f The function to call for
  *     every element. This function
@@ -358,20 +388,23 @@ goog.array.reduce = function(arr, f, val, opt_obj) {
  *     values of the array.
  * @template T,S,R
  */
-goog.array.reduceRight = function(arr, f, val, opt_obj) {
-  if (arr.reduceRight) {
-    if (opt_obj) {
-      return arr.reduceRight(goog.bind(f, opt_obj), val);
-    } else {
-      return arr.reduceRight(f, val);
-    }
-  }
-  var rval = val;
-  goog.array.forEachRight(arr, function(val, index) {
-    rval = f.call(opt_obj, rval, val, index, arr);
-  });
-  return rval;
-};
+goog.array.reduceRight = goog.NATIVE_ARRAY_PROTOTYPES &&
+                         (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                          goog.array.ARRAY_PROTOTYPE_.reduceRight) ?
+    function(arr, f, val, opt_obj) {
+      goog.asserts.assert(arr.length != null);
+      if (opt_obj) {
+        f = goog.bind(f, opt_obj);
+      }
+      return goog.array.ARRAY_PROTOTYPE_.reduceRight.call(arr, f, val);
+    } :
+    function(arr, f, val, opt_obj) {
+      var rval = val;
+      goog.array.forEachRight(arr, function(val, index) {
+        rval = f.call(opt_obj, rval, val, index, arr);
+      });
+      return rval;
+    };
 
 
 /**
@@ -381,7 +414,7 @@ goog.array.reduceRight = function(arr, f, val, opt_obj) {
  *
  * See {@link http://tinyurl.com/developer-mozilla-org-array-some}
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, T, number, ?) : boolean} f The function to call for
  *     for every element. This function takes 3 arguments (the element, the
@@ -392,7 +425,8 @@ goog.array.reduceRight = function(arr, f, val, opt_obj) {
  * @template T,S
  */
 goog.array.some = goog.NATIVE_ARRAY_PROTOTYPES &&
-                  goog.array.ARRAY_PROTOTYPE_.some ?
+                  (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                   goog.array.ARRAY_PROTOTYPE_.some) ?
     function(arr, f, opt_obj) {
       goog.asserts.assert(arr.length != null);
 
@@ -417,7 +451,7 @@ goog.array.some = goog.NATIVE_ARRAY_PROTOTYPES &&
  *
  * See {@link http://tinyurl.com/developer-mozilla-org-array-every}
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, T, number, ?) : boolean} f The function to call for
  *     for every element. This function takes 3 arguments (the element, the
@@ -428,7 +462,8 @@ goog.array.some = goog.NATIVE_ARRAY_PROTOTYPES &&
  * @template T,S
  */
 goog.array.every = goog.NATIVE_ARRAY_PROTOTYPES &&
-                   goog.array.ARRAY_PROTOTYPE_.every ?
+                   (goog.array.ASSUME_NATIVE_FUNCTIONS ||
+                    goog.array.ARRAY_PROTOTYPE_.every) ?
     function(arr, f, opt_obj) {
       goog.asserts.assert(arr.length != null);
 
@@ -450,7 +485,7 @@ goog.array.every = goog.NATIVE_ARRAY_PROTOTYPES &&
  * Counts the array elements that fulfill the predicate, i.e. for which the
  * callback function returns true. Skips holes in the array.
  *
- * @param {!(Array.<T>|goog.array.ArrayLike)} arr Array or array like object
+ * @param {!(Array<T>|goog.array.ArrayLike)} arr Array or array like object
  *     over which to iterate.
  * @param {function(this: S, T, number, ?): boolean} f The function to call for
  *     every element. Takes 3 arguments (the element, the index and the array).
@@ -472,13 +507,13 @@ goog.array.count = function(arr, f, opt_obj) {
 /**
  * Search an array for the first element that satisfies a given condition and
  * return that element.
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, T, number, ?) : boolean} f The function to call
  *     for every element. This function takes 3 arguments (the element, the
  *     index and the array) and should return a boolean.
  * @param {S=} opt_obj An optional "this" context for the function.
- * @return {T} The first array element that passes the test, or null if no
+ * @return {T|null} The first array element that passes the test, or null if no
  *     element is found.
  * @template T,S
  */
@@ -491,7 +526,7 @@ goog.array.find = function(arr, f, opt_obj) {
 /**
  * Search an array for the first element that satisfies a given condition and
  * return its index.
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, T, number, ?) : boolean} f The function to call for
  *     every element. This function
@@ -517,14 +552,14 @@ goog.array.findIndex = function(arr, f, opt_obj) {
 /**
  * Search an array (in reverse order) for the last element that satisfies a
  * given condition and return that element.
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, T, number, ?) : boolean} f The function to call
  *     for every element. This function
  *     takes 3 arguments (the element, the index and the array) and should
  *     return a boolean.
  * @param {S=} opt_obj An optional "this" context for the function.
- * @return {T} The last array element that passes the test, or null if no
+ * @return {T|null} The last array element that passes the test, or null if no
  *     element is found.
  * @template T,S
  */
@@ -537,13 +572,13 @@ goog.array.findRight = function(arr, f, opt_obj) {
 /**
  * Search an array (in reverse order) for the last element that satisfies a
  * given condition and return its index.
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, T, number, ?) : boolean} f The function to call
  *     for every element. This function
  *     takes 3 arguments (the element, the index and the array) and should
  *     return a boolean.
- * @param {Object=} opt_obj An optional "this" context for the function.
+ * @param {S=} opt_obj An optional "this" context for the function.
  * @return {number} The index of the last array element that passes the test,
  *     or -1 if no element is found.
  * @template T,S
@@ -600,7 +635,7 @@ goog.array.clear = function(arr) {
 
 /**
  * Pushes an item into an array, if it's not already in the array.
- * @param {Array.<T>} arr Array into which to insert the item.
+ * @param {Array<T>} arr Array into which to insert the item.
  * @param {T} obj Value to add.
  * @template T
  */
@@ -637,7 +672,7 @@ goog.array.insertArrayAt = function(arr, elementsToAdd, opt_i) {
 
 /**
  * Inserts an object into an array before a specified object.
- * @param {Array.<T>} arr The array to modify.
+ * @param {Array<T>} arr The array to modify.
  * @param {T} obj The object to insert.
  * @param {T=} opt_obj2 The object before which obj should be inserted. If obj2
  *     is omitted or not found, obj is inserted at the end of the array.
@@ -655,9 +690,11 @@ goog.array.insertBefore = function(arr, obj, opt_obj2) {
 
 /**
  * Removes the first occurrence of a particular value from an array.
- * @param {goog.array.ArrayLike} arr Array from which to remove value.
- * @param {*} obj Object to remove.
+ * @param {Array<T>|goog.array.ArrayLike} arr Array from which to remove
+ *     value.
+ * @param {T} obj Object to remove.
  * @return {boolean} True if an element was removed.
+ * @template T
  */
 goog.array.remove = function(arr, obj) {
   var i = goog.array.indexOf(arr, obj);
@@ -688,7 +725,7 @@ goog.array.removeAt = function(arr, i) {
 
 /**
  * Removes the first value that satisfies the given condition.
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
  *     like object over which to iterate.
  * @param {?function(this:S, T, number, ?) : boolean} f The function to call
  *     for every element. This function
@@ -708,6 +745,31 @@ goog.array.removeIf = function(arr, f, opt_obj) {
 };
 
 
+/**
+ * Removes all values that satisfy the given condition.
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array
+ *     like object over which to iterate.
+ * @param {?function(this:S, T, number, ?) : boolean} f The function to call
+ *     for every element. This function
+ *     takes 3 arguments (the element, the index and the array) and should
+ *     return a boolean.
+ * @param {S=} opt_obj An optional "this" context for the function.
+ * @return {number} The number of items removed
+ * @template T,S
+ */
+goog.array.removeAllIf = function(arr, f, opt_obj) {
+  var removedCount = 0;
+  goog.array.forEachRight(arr, function(val, index) {
+    if (f.call(opt_obj, val, index, arr)) {
+      if (goog.array.removeAt(arr, index)) {
+        removedCount++;
+      }
+    }
+  });
+  return removedCount;
+};
+
+
 /**
  * Returns a new array that is the result of joining the arguments.  If arrays
  * are passed then their items are added, however, if non-arrays are passed they
@@ -733,7 +795,7 @@ goog.array.removeIf = function(arr, f, opt_obj) {
  *
  * @param {...*} var_args Items to concatenate.  Arrays will have each item
  *     added, while primitives and objects will be added as is.
- * @return {!Array} The new resultant array.
+ * @return {!Array<?>} The new resultant array.
  */
 goog.array.concat = function(var_args) {
   return goog.array.ARRAY_PROTOTYPE_.concat.apply(
@@ -741,13 +803,27 @@ goog.array.concat = function(var_args) {
 };
 
 
+/**
+ * Returns a new array that contains the contents of all the arrays passed.
+ * @param {...!Array<T>} var_args
+ * @return {!Array<T>}
+ * @template T
+ */
+goog.array.join = function(var_args) {
+  return goog.array.ARRAY_PROTOTYPE_.concat.apply(
+      goog.array.ARRAY_PROTOTYPE_, arguments);
+};
+
+
 /**
  * Converts an object to an array.
- * @param {goog.array.ArrayLike} object  The object to convert to an array.
- * @return {!Array} The object converted into an array. If object has a
+ * @param {Array<T>|goog.array.ArrayLike} object  The object to convert to an
+ *     array.
+ * @return {!Array<T>} The object converted into an array. If object has a
  *     length property, every property indexed with a non-negative number
  *     less than length will be included in the result. If object does not
  *     have a length property, an empty array will be returned.
+ * @template T
  */
 goog.array.toArray = function(object) {
   var length = object.length;
@@ -768,8 +844,10 @@ goog.array.toArray = function(object) {
 
 /**
  * Does a shallow copy of an array.
- * @param {goog.array.ArrayLike} arr  Array or array-like object to clone.
- * @return {!Array} Clone of the input array.
+ * @param {Array<T>|goog.array.ArrayLike} arr  Array or array-like object to
+ *     clone.
+ * @return {!Array<T>} Clone of the input array.
+ * @template T
  */
 goog.array.clone = goog.array.toArray;
 
@@ -785,28 +863,18 @@ goog.array.clone = goog.array.toArray;
  * goog.array.extend(a, 2);
  * a; // [0, 1, 2]
  *
- * @param {Array} arr1  The array to modify.
- * @param {...*} var_args The elements or arrays of elements to add to arr1.
+ * @param {Array<VALUE>} arr1  The array to modify.
+ * @param {...(Array<VALUE>|VALUE)} var_args The elements or arrays of elements
+ *     to add to arr1.
+ * @template VALUE
  */
 goog.array.extend = function(arr1, var_args) {
   for (var i = 1; i < arguments.length; i++) {
     var arr2 = arguments[i];
-    // If we have an Array or an Arguments object we can just call push
-    // directly.
-    var isArrayLike;
-    if (goog.isArray(arr2) ||
-        // Detect Arguments. ES5 says that the [[Class]] of an Arguments object
-        // is "Arguments" but only V8 and JSC/Safari gets this right. We instead
-        // detect Arguments by checking for array like and presence of "callee".
-        (isArrayLike = goog.isArrayLike(arr2)) &&
-            // The getter for callee throws an exception in strict mode
-            // according to section 10.6 in ES5 so check for presence instead.
-            Object.prototype.hasOwnProperty.call(arr2, 'callee')) {
-      arr1.push.apply(arr1, arr2);
-    } else if (isArrayLike) {
-      // Otherwise loop over arr2 to prevent copying the object.
-      var len1 = arr1.length;
-      var len2 = arr2.length;
+    if (goog.isArrayLike(arr2)) {
+      var len1 = arr1.length || 0;
+      var len2 = arr2.length || 0;
+      arr1.length = len1 + len2;
       for (var j = 0; j < len2; j++) {
         arr1[len1 + j] = arr2[j];
       }
@@ -822,15 +890,16 @@ goog.array.extend = function(arr1, var_args) {
  * splice. This means that it might work on other objects similar to arrays,
  * such as the arguments object.
  *
- * @param {goog.array.ArrayLike} arr The array to modify.
+ * @param {Array<T>|goog.array.ArrayLike} arr The array to modify.
  * @param {number|undefined} index The index at which to start changing the
  *     array. If not defined, treated as 0.
  * @param {number} howMany How many elements to remove (0 means no removal. A
  *     value below 0 is treated as zero and so is any other non number. Numbers
  *     are floored).
- * @param {...*} var_args Optional, additional elements to insert into the
+ * @param {...T} var_args Optional, additional elements to insert into the
  *     array.
- * @return {!Array} the removed elements.
+ * @return {!Array<T>} the removed elements.
+ * @template T
  */
 goog.array.splice = function(arr, index, howMany, var_args) {
   goog.asserts.assert(arr.length != null);
@@ -845,11 +914,11 @@ goog.array.splice = function(arr, index, howMany, var_args) {
  * Array slice. This means that it might work on other objects similar to
  * arrays, such as the arguments object.
  *
- * @param {Array.<T>|goog.array.ArrayLike} arr The array from
+ * @param {Array<T>|goog.array.ArrayLike} arr The array from
  * which to copy a segment.
  * @param {number} start The index of the first element to copy.
  * @param {number=} opt_end The index after the last element to copy.
- * @return {!Array.<T>} A new array containing the specified segment of the
+ * @return {!Array<T>} A new array containing the specified segment of the
  *     original array.
  * @template T
  */
@@ -876,27 +945,36 @@ goog.array.slice = function(arr, start, opt_end) {
  * For objects, duplicates are identified as having the same unique ID as
  * defined by {@link goog.getUid}.
  *
+ * Alternatively you can specify a custom hash function that returns a unique
+ * value for each item in the array it should consider unique.
+ *
  * Runtime: N,
  * Worstcase space: 2N (no dupes)
  *
- * @param {goog.array.ArrayLike} arr The array from which to remove duplicates.
+ * @param {Array<T>|goog.array.ArrayLike} arr The array from which to remove
+ *     duplicates.
  * @param {Array=} opt_rv An optional array in which to return the results,
  *     instead of performing the removal inplace.  If specified, the original
  *     array will remain unchanged.
+ * @param {function(T):string=} opt_hashFn An optional function to use to
+ *     apply to every item in the array. This function should return a unique
+ *     value for each item in the array it should consider unique.
+ * @template T
  */
-goog.array.removeDuplicates = function(arr, opt_rv) {
+goog.array.removeDuplicates = function(arr, opt_rv, opt_hashFn) {
   var returnArray = opt_rv || arr;
+  var defaultHashFn = function(item) {
+    // Prefix each type with a single character representing the type to
+    // prevent conflicting keys (e.g. true and 'true').
+    return goog.isObject(item) ? 'o' + goog.getUid(item) :
+        (typeof item).charAt(0) + item;
+  };
+  var hashFn = opt_hashFn || defaultHashFn;
 
   var seen = {}, cursorInsert = 0, cursorRead = 0;
   while (cursorRead < arr.length) {
     var current = arr[cursorRead++];
-
-    // Prefix each type with a single character representing the type to
-    // prevent conflicting keys (e.g. true and 'true').
-    var key = goog.isObject(current) ?
-        'o' + goog.getUid(current) :
-        (typeof current).charAt(0) + current;
-
+    var key = hashFn(current);
     if (!Object.prototype.hasOwnProperty.call(seen, key)) {
       seen[key] = true;
       returnArray[cursorInsert++] = current;
@@ -919,16 +997,18 @@ goog.array.removeDuplicates = function(arr, opt_rv) {
  *
  * Runtime: O(log n)
  *
- * @param {goog.array.ArrayLike} arr The array to be searched.
- * @param {*} target The sought value.
- * @param {Function=} opt_compareFn Optional comparison function by which the
- *     array is ordered. Should take 2 arguments to compare, and return a
- *     negative number, zero, or a positive number depending on whether the
- *     first argument is less than, equal to, or greater than the second.
+ * @param {Array<VALUE>|goog.array.ArrayLike} arr The array to be searched.
+ * @param {TARGET} target The sought value.
+ * @param {function(TARGET, VALUE): number=} opt_compareFn Optional comparison
+ *     function by which the array is ordered. Should take 2 arguments to
+ *     compare, and return a negative number, zero, or a positive number
+ *     depending on whether the first argument is less than, equal to, or
+ *     greater than the second.
  * @return {number} Lowest index of the target value if found, otherwise
  *     (-(insertion point) - 1). The insertion point is where the value should
  *     be inserted into arr to preserve the sorted property.  Return value >= 0
  *     iff target is found.
+ * @template TARGET, VALUE
  */
 goog.array.binarySearch = function(arr, target, opt_compareFn) {
   return goog.array.binarySearch_(arr,
@@ -946,18 +1026,20 @@ goog.array.binarySearch = function(arr, target, opt_compareFn) {
  *
  * Runtime: O(log n)
  *
- * @param {goog.array.ArrayLike} arr The array to be searched.
- * @param {Function} evaluator Evaluator function that receives 3 arguments
- *     (the element, the index and the array). Should return a negative number,
- *     zero, or a positive number depending on whether the desired index is
- *     before, at, or after the element passed to it.
- * @param {Object=} opt_obj The object to be used as the value of 'this'
+ * @param {Array<VALUE>|goog.array.ArrayLike} arr The array to be searched.
+ * @param {function(this:THIS, VALUE, number, ?): number} evaluator
+ *     Evaluator function that receives 3 arguments (the element, the index and
+ *     the array). Should return a negative number, zero, or a positive number
+ *     depending on whether the desired index is before, at, or after the
+ *     element passed to it.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this'
  *     within evaluator.
  * @return {number} Index of the leftmost element matched by the evaluator, if
  *     such exists; otherwise (-(insertion point) - 1). The insertion point is
  *     the index of the first element for which the evaluator returns negative,
  *     or arr.length if no such element exists. The return value is non-negative
  *     iff a match is found.
+ * @template THIS, VALUE
  */
 goog.array.binarySelect = function(arr, evaluator, opt_obj) {
   return goog.array.binarySearch_(arr, evaluator, true /* isEvaluator */,
@@ -977,15 +1059,16 @@ goog.array.binarySelect = function(arr, evaluator, opt_obj) {
  *
  * Runtime: O(log n)
  *
- * @param {goog.array.ArrayLike} arr The array to be searched.
- * @param {Function} compareFn Either an evaluator or a comparison function,
- *     as defined by binarySearch and binarySelect above.
+ * @param {Array<?>|goog.array.ArrayLike} arr The array to be searched.
+ * @param {function(?, ?, ?): number | function(?, ?): number} compareFn
+ *     Either an evaluator or a comparison function, as defined by binarySearch
+ *     and binarySelect above.
  * @param {boolean} isEvaluator Whether the function is an evaluator or a
  *     comparison function.
- * @param {*=} opt_target If the function is a comparison function, then this is
- *     the target to binary search for.
+ * @param {?=} opt_target If the function is a comparison function, then
+ *     this is the target to binary search for.
  * @param {Object=} opt_selfObj If the function is an evaluator, this is an
-  *    optional this object for the evaluator.
+ *     optional this object for the evaluator.
  * @return {number} Lowest index of the target value if found, otherwise
  *     (-(insertion point) - 1). The insertion point is where the value should
  *     be inserted into arr to preserve the sorted property.  Return value >= 0
@@ -1032,7 +1115,7 @@ goog.array.binarySearch_ = function(arr, compareFn, isEvaluator, opt_target,
  *
  * Runtime: Same as <code>Array.prototype.sort</code>
  *
- * @param {Array.<T>} arr The array to be sorted.
+ * @param {Array<T>} arr The array to be sorted.
  * @param {?function(T,T):number=} opt_compareFn Optional comparison
  *     function by which the
  *     array is to be ordered. Should take 2 arguments to compare, and return a
@@ -1042,10 +1125,7 @@ goog.array.binarySearch_ = function(arr, compareFn, isEvaluator, opt_target,
  */
 goog.array.sort = function(arr, opt_compareFn) {
   // TODO(arv): Update type annotation since null is not accepted.
-  goog.asserts.assert(arr.length != null);
-
-  goog.array.ARRAY_PROTOTYPE_.sort.call(
-      arr, opt_compareFn || goog.array.defaultCompare);
+  arr.sort(opt_compareFn || goog.array.defaultCompare);
 };
 
 
@@ -1059,7 +1139,7 @@ goog.array.sort = function(arr, opt_compareFn) {
  * Runtime: Same as <code>Array.prototype.sort</code>, plus an additional
  * O(n) overhead of copying the array twice.
  *
- * @param {Array.<T>} arr The array to be sorted.
+ * @param {Array<T>} arr The array to be sorted.
  * @param {?function(T, T): number=} opt_compareFn Optional comparison function
  *     by which the array is to be ordered. Should take 2 arguments to compare,
  *     and return a negative number, zero, or a positive number depending on
@@ -1082,28 +1162,54 @@ goog.array.stableSort = function(arr, opt_compareFn) {
 };
 
 
+/**
+ * Sort the specified array into ascending order based on item keys
+ * returned by the specified key function.
+ * If no opt_compareFn is specified, the keys are compared in ascending order
+ * using <code>goog.array.defaultCompare</code>.
+ *
+ * Runtime: O(S(f(n)), where S is runtime of <code>goog.array.sort</code>
+ * and f(n) is runtime of the key function.
+ *
+ * @param {Array<T>} arr The array to be sorted.
+ * @param {function(T): K} keyFn Function taking array element and returning
+ *     a key used for sorting this element.
+ * @param {?function(K, K): number=} opt_compareFn Optional comparison function
+ *     by which the keys are to be ordered. Should take 2 arguments to compare,
+ *     and return a negative number, zero, or a positive number depending on
+ *     whether the first argument is less than, equal to, or greater than the
+ *     second.
+ * @template T,K
+ */
+goog.array.sortByKey = function(arr, keyFn, opt_compareFn) {
+  var keyCompareFn = opt_compareFn || goog.array.defaultCompare;
+  goog.array.sort(arr, function(a, b) {
+    return keyCompareFn(keyFn(a), keyFn(b));
+  });
+};
+
+
 /**
  * Sorts an array of objects by the specified object key and compare
  * function. If no compare function is provided, the key values are
  * compared in ascending order using <code>goog.array.defaultCompare</code>.
  * This won't work for keys that get renamed by the compiler. So use
  * {'foo': 1, 'bar': 2} rather than {foo: 1, bar: 2}.
- * @param {Array.<Object>} arr An array of objects to sort.
+ * @param {Array<Object>} arr An array of objects to sort.
  * @param {string} key The object key to sort by.
  * @param {Function=} opt_compareFn The function to use to compare key
  *     values.
  */
 goog.array.sortObjectsByKey = function(arr, key, opt_compareFn) {
-  var compare = opt_compareFn || goog.array.defaultCompare;
-  goog.array.sort(arr, function(a, b) {
-    return compare(a[key], b[key]);
-  });
+  goog.array.sortByKey(arr,
+      function(obj) { return obj[key]; },
+      opt_compareFn);
 };
 
 
 /**
  * Tells if the array is sorted.
- * @param {!Array.<T>} arr The array.
+ * @param {!Array<T>} arr The array.
  * @param {?function(T,T):number=} opt_compareFn Function to compare the
  *     array elements.
  *     Should take 2 arguments to compare, and return a negative number, zero,
@@ -1154,30 +1260,21 @@ goog.array.equals = function(arr1, arr2, opt_equalsFn) {
 };
 
 
-/**
- * @deprecated Use {@link goog.array.equals}.
- * @param {goog.array.ArrayLike} arr1 See {@link goog.array.equals}.
- * @param {goog.array.ArrayLike} arr2 See {@link goog.array.equals}.
- * @param {Function=} opt_equalsFn See {@link goog.array.equals}.
- * @return {boolean} See {@link goog.array.equals}.
- */
-goog.array.compare = function(arr1, arr2, opt_equalsFn) {
-  return goog.array.equals(arr1, arr2, opt_equalsFn);
-};
-
-
 /**
  * 3-way array compare function.
- * @param {!goog.array.ArrayLike} arr1 The first array to compare.
- * @param {!goog.array.ArrayLike} arr2 The second array to compare.
- * @param {?function(?, ?): number=} opt_compareFn Optional comparison function
- *     by which the array is to be ordered. Should take 2 arguments to compare,
- *     and return a negative number, zero, or a positive number depending on
- *     whether the first argument is less than, equal to, or greater than the
- *     second.
+ * @param {!Array<VALUE>|!goog.array.ArrayLike} arr1 The first array to
+ *     compare.
+ * @param {!Array<VALUE>|!goog.array.ArrayLike} arr2 The second array to
+ *     compare.
+ * @param {function(VALUE, VALUE): number=} opt_compareFn Optional comparison
+ *     function by which the array is to be ordered. Should take 2 arguments to
+ *     compare, and return a negative number, zero, or a positive number
+ *     depending on whether the first argument is less than, equal to, or
+ *     greater than the second.
  * @return {number} Negative number, zero, or a positive number depending on
  *     whether the first argument is less than, equal to, or greater than the
  *     second.
+ * @template VALUE
  */
 goog.array.compare3 = function(arr1, arr2, opt_compareFn) {
   var compare = opt_compareFn || goog.array.defaultCompare;
@@ -1195,16 +1292,33 @@ goog.array.compare3 = function(arr1, arr2, opt_compareFn) {
 /**
  * Compares its two arguments for order, using the built in < and >
  * operators.
- * @param {*} a The first object to be compared.
- * @param {*} b The second object to be compared.
+ * @param {VALUE} a The first object to be compared.
+ * @param {VALUE} b The second object to be compared.
  * @return {number} A negative number, zero, or a positive number as the first
- *     argument is less than, equal to, or greater than the second.
+ *     argument is less than, equal to, or greater than the second,
+ *     respectively.
+ * @template VALUE
  */
 goog.array.defaultCompare = function(a, b) {
   return a > b ? 1 : a < b ? -1 : 0;
 };
 
 
+/**
+ * Compares its two arguments for inverse order, using the built in < and >
+ * operators.
+ * @param {VALUE} a The first object to be compared.
+ * @param {VALUE} b The second object to be compared.
+ * @return {number} A negative number, zero, or a positive number as the first
+ *     argument is greater than, equal to, or less than the second,
+ *     respectively.
+ * @template VALUE
+ */
+goog.array.inverseDefaultCompare = function(a, b) {
+  return -goog.array.defaultCompare(a, b);
+};
+
+
 /**
  * Compares its two arguments for equality, using the built in === operator.
  * @param {*} a The first object to compare.
@@ -1219,15 +1333,15 @@ goog.array.defaultCompareEquality = function(a, b) {
 /**
  * Inserts a value into a sorted array. The array is not modified if the
  * value is already present.
- * @param {Array.<T>} array The array to modify.
- * @param {T} value The object to insert.
- * @param {?function(T,T):number=} opt_compareFn Optional comparison function by
- *     which the
- *     array is ordered. Should take 2 arguments to compare, and return a
- *     negative number, zero, or a positive number depending on whether the
- *     first argument is less than, equal to, or greater than the second.
+ * @param {Array<VALUE>|goog.array.ArrayLike} array The array to modify.
+ * @param {VALUE} value The object to insert.
+ * @param {function(VALUE, VALUE): number=} opt_compareFn Optional comparison
+ *     function by which the array is ordered. Should take 2 arguments to
+ *     compare, and return a negative number, zero, or a positive number
+ *     depending on whether the first argument is less than, equal to, or
+ *     greater than the second.
  * @return {boolean} True if an element was inserted.
- * @template T
+ * @template VALUE
  */
 goog.array.binaryInsert = function(array, value, opt_compareFn) {
   var index = goog.array.binarySearch(array, value, opt_compareFn);
@@ -1241,13 +1355,15 @@ goog.array.binaryInsert = function(array, value, opt_compareFn) {
 
 /**
  * Removes a value from a sorted array.
- * @param {Array} array The array to modify.
- * @param {*} value The object to remove.
- * @param {Function=} opt_compareFn Optional comparison function by which the
- *     array is ordered. Should take 2 arguments to compare, and return a
- *     negative number, zero, or a positive number depending on whether the
- *     first argument is less than, equal to, or greater than the second.
+ * @param {!Array<VALUE>|!goog.array.ArrayLike} array The array to modify.
+ * @param {VALUE} value The object to remove.
+ * @param {function(VALUE, VALUE): number=} opt_compareFn Optional comparison
+ *     function by which the array is ordered. Should take 2 arguments to
+ *     compare, and return a negative number, zero, or a positive number
+ *     depending on whether the first argument is less than, equal to, or
+ *     greater than the second.
  * @return {boolean} True if an element was removed.
+ * @template VALUE
  */
 goog.array.binaryRemove = function(array, value, opt_compareFn) {
   var index = goog.array.binarySearch(array, value, opt_compareFn);
@@ -1257,8 +1373,8 @@ goog.array.binaryRemove = function(array, value, opt_compareFn) {
 
 /**
  * Splits an array into disjoint buckets according to a splitting function.
- * @param {Array.<T>} array The array.
- * @param {function(this:S, T,number,Array.<T>):?} sorter Function to call for
+ * @param {Array<T>} array The array.
+ * @param {function(this:S, T,number,Array<T>):?} sorter Function to call for
  *     every element.  This takes 3 arguments (the element, the index and the
  *     array) and must return a valid object key (a string, number, etc), or
  *     undefined, if that object should not be placed in a bucket.
@@ -1289,7 +1405,7 @@ goog.array.bucket = function(array, sorter, opt_obj) {
 /**
  * Creates a new object built from the provided array and the key-generation
  * function.
- * @param {Array.<T>|goog.array.ArrayLike} arr Array or array like object over
+ * @param {Array<T>|goog.array.ArrayLike} arr Array or array like object over
  *     which to iterate whose elements will be the values in the new object.
  * @param {?function(this:S, T, number, ?) : string} keyFunc The function to
  *     call for every element. This function takes 3 arguments (the element, the
@@ -1299,7 +1415,7 @@ goog.array.bucket = function(array, sorter, opt_obj) {
  *     implementation-defined.
  * @param {S=} opt_obj The object to be used as the value of 'this'
  *     within keyFunc.
- * @return {!Object.<T>} The new object.
+ * @return {!Object<T>} The new object.
  * @template T,S
  */
 goog.array.toObject = function(arr, keyFunc, opt_obj) {
@@ -1327,7 +1443,7 @@ goog.array.toObject = function(arr, keyFunc, opt_obj) {
  * @param {number=} opt_end The optional end value of the range.
  * @param {number=} opt_step The step size between range values. Defaults to 1
  *     if opt_step is undefined or 0.
- * @return {!Array.<number>} An array of numbers for the requested range. May be
+ * @return {!Array<number>} An array of numbers for the requested range. May be
  *     an empty array if adding the step would not converge toward the end
  *     value.
  */
@@ -1362,9 +1478,10 @@ goog.array.range = function(startOrEnd, opt_end, opt_step) {
 /**
  * Returns an array consisting of the given value repeated N times.
  *
- * @param {*} value The value to repeat.
+ * @param {VALUE} value The value to repeat.
  * @param {number} n The repeat count.
- * @return {!Array} An array with the repeated value.
+ * @return {!Array<VALUE>} An array with the repeated value.
+ * @template VALUE
  */
 goog.array.repeat = function(value, n) {
   var array = [];
@@ -1380,14 +1497,22 @@ goog.array.repeat = function(value, n) {
  * expanded in-place recursively.
  *
  * @param {...*} var_args The values to flatten.
- * @return {!Array} An array containing the flattened values.
+ * @return {!Array<?>} An array containing the flattened values.
  */
 goog.array.flatten = function(var_args) {
+  var CHUNK_SIZE = 8192;
+
   var result = [];
   for (var i = 0; i < arguments.length; i++) {
     var element = arguments[i];
     if (goog.isArray(element)) {
-      result.push.apply(result, goog.array.flatten.apply(null, element));
+      for (var c = 0; c < element.length; c += CHUNK_SIZE) {
+        var chunk = goog.array.slice(element, c, c + CHUNK_SIZE);
+        var recurseResult = goog.array.flatten.apply(null, chunk);
+        for (var r = 0; r < recurseResult.length; r++) {
+          result.push(recurseResult[r]);
+        }
+      }
     } else {
       result.push(element);
     }
@@ -1405,9 +1530,9 @@ goog.array.flatten = function(var_args) {
  * For example, suppose list comprises [t, a, n, k, s]. After invoking
  * rotate(array, 1) (or rotate(array, -4)), array will comprise [s, t, a, n, k].
  *
- * @param {!Array.<T>} array The array to rotate.
+ * @param {!Array<T>} array The array to rotate.
  * @param {number} n The amount to rotate.
- * @return {!Array.<T>} The array.
+ * @return {!Array<T>} The array.
  * @template T
  */
 goog.array.rotate = function(array, n) {
@@ -1425,6 +1550,28 @@ goog.array.rotate = function(array, n) {
 };
 
 
+/**
+ * Moves one item of an array to a new position keeping the order of the rest
+ * of the items. Example use case: keeping a list of JavaScript objects
+ * synchronized with the corresponding list of DOM elements after one of the
+ * elements has been dragged to a new position.
+ * @param {!(Array|Arguments|{length:number})} arr The array to modify.
+ * @param {number} fromIndex Index of the item to move between 0 and
+ *     {@code arr.length - 1}.
+ * @param {number} toIndex Target index between 0 and {@code arr.length - 1}.
+ */
+goog.array.moveItem = function(arr, fromIndex, toIndex) {
+  goog.asserts.assert(fromIndex >= 0 && fromIndex < arr.length);
+  goog.asserts.assert(toIndex >= 0 && toIndex < arr.length);
+  // Remove 1 item at fromIndex.
+  var removedItems = goog.array.ARRAY_PROTOTYPE_.splice.call(arr, fromIndex, 1);
+  // Insert the removed item at toIndex.
+  goog.array.ARRAY_PROTOTYPE_.splice.call(arr, toIndex, 0, removedItems[0]);
+  // We don't use goog.array.insertAt and goog.array.removeAt, because they're
+  // significantly slower than splice.
+};
+
+
 /**
  * Creates a new array for which the element at position i is an array of the
  * ith element of the provided arrays.  The returned array will only be as long
@@ -1435,25 +1582,28 @@ goog.array.rotate = function(array, n) {
  * http://docs.python.org/library/functions.html#zip}
  *
  * @param {...!goog.array.ArrayLike} var_args Arrays to be combined.
- * @return {!Array.<!Array>} A new array of arrays created from provided arrays.
+ * @return {!Array<!Array<?>>} A new array of arrays created from
+ *     provided arrays.
  */
 goog.array.zip = function(var_args) {
   if (!arguments.length) {
     return [];
   }
   var result = [];
-  for (var i = 0; true; i++) {
+  var minLen = arguments[0].length;
+  for (var i = 1; i < arguments.length; i++) {
+    if (arguments[i].length < minLen) {
+      minLen = arguments[i].length;
+    }
+  }
+  for (var i = 0; i < minLen; i++) {
     var value = [];
     for (var j = 0; j < arguments.length; j++) {
-      var arr = arguments[j];
-      // If i is larger than the array length, this is the shortest array.
-      if (i >= arr.length) {
-        return result;
-      }
-      value.push(arr[i]);
+      value.push(arguments[j][i]);
     }
     result.push(value);
   }
+  return result;
 };
 
 
@@ -1465,7 +1615,7 @@ goog.array.zip = function(var_args) {
  *
  * Runtime: O(n)
  *
- * @param {!Array} arr The array to be shuffled.
+ * @param {!Array<?>} arr The array to be shuffled.
  * @param {function():number=} opt_randFn Optional random function to use for
  *     shuffling.
  *     Takes no arguments, and returns a random number on the interval [0, 1).
@@ -1483,3 +1633,22 @@ goog.array.shuffle = function(arr, opt_randFn) {
     arr[j] = tmp;
   }
 };
+
+
+/**
+ * Returns a new array of elements from arr, based on the indexes of elements
+ * provided by index_arr. For example, the result of index copying
+ * ['a', 'b', 'c'] with index_arr [1,0,0,2] is ['b', 'a', 'a', 'c'].
+ *
+ * @param {!Array<T>} arr The array to get a indexed copy from.
+ * @param {!Array<number>} index_arr An array of indexes to get from arr.
+ * @return {!Array<T>} A new array of elements from arr in index_arr order.
+ * @template T
+ */
+goog.array.copyByIndex = function(arr, index_arr) {
+  var result = [];
+  goog.array.forEach(index_arr, function(index) {
+    result.push(arr[index]);
+  });
+  return result;
+};
diff --git a/lib/goog/asserts/asserts.js b/lib/goog/asserts/asserts.js
index 905cd58..8522e7c 100644
--- a/lib/goog/asserts/asserts.js
+++ b/lib/goog/asserts/asserts.js
@@ -31,12 +31,14 @@
  * The compiler will leave in foo() (because its return value is used),
  * but it will remove bar() because it assumes it does not have side-effects.
  *
+ * @author agrieve@google.com (Andrew Grieve)
  */
 
 goog.provide('goog.asserts');
 goog.provide('goog.asserts.AssertionError');
 
 goog.require('goog.debug.Error');
+goog.require('goog.dom.NodeType');
 goog.require('goog.string');
 
 
@@ -50,14 +52,15 @@ goog.define('goog.asserts.ENABLE_ASSERTS', goog.DEBUG);
 /**
  * Error object for failed assertions.
  * @param {string} messagePattern The pattern that was used to form message.
- * @param {!Array.<*>} messageArgs The items to substitute into the pattern.
+ * @param {!Array<*>} messageArgs The items to substitute into the pattern.
  * @constructor
  * @extends {goog.debug.Error}
+ * @final
  */
 goog.asserts.AssertionError = function(messagePattern, messageArgs) {
   messageArgs.unshift(messagePattern);
   goog.debug.Error.call(this, goog.string.subs.apply(null, messageArgs));
-  // Remove the messagePattern afterwards to avoid permenantly modifying the
+  // Remove the messagePattern afterwards to avoid permanently modifying the
   // passed in array.
   messageArgs.shift();
 
@@ -75,13 +78,27 @@ goog.inherits(goog.asserts.AssertionError, goog.debug.Error);
 goog.asserts.AssertionError.prototype.name = 'AssertionError';
 
 
+/**
+ * The default error handler.
+ * @param {!goog.asserts.AssertionError} e The exception to be handled.
+ */
+goog.asserts.DEFAULT_ERROR_HANDLER = function(e) { throw e; };
+
+
+/**
+ * The handler responsible for throwing or logging assertion errors.
+ * @private {function(!goog.asserts.AssertionError)}
+ */
+goog.asserts.errorHandler_ = goog.asserts.DEFAULT_ERROR_HANDLER;
+
+
 /**
  * Throws an exception with the given message and "Assertion failed" prefixed
  * onto it.
  * @param {string} defaultMessage The message to use if givenMessage is empty.
- * @param {Array.<*>} defaultArgs The substitution arguments for defaultMessage.
+ * @param {Array<*>} defaultArgs The substitution arguments for defaultMessage.
  * @param {string|undefined} givenMessage Message supplied by the caller.
- * @param {Array.<*>} givenArgs The substitution arguments for givenMessage.
+ * @param {Array<*>} givenArgs The substitution arguments for givenMessage.
  * @throws {goog.asserts.AssertionError} When the value is not a number.
  * @private
  */
@@ -99,17 +116,32 @@ goog.asserts.doAssertFailure_ =
   // a stack trace is added to var message above. With this, a stack trace is
   // not added until this line (it causes the extra garbage to be added after
   // the assertion message instead of in the middle of it).
-  throw new goog.asserts.AssertionError('' + message, args || []);
+  var e = new goog.asserts.AssertionError('' + message, args || []);
+  goog.asserts.errorHandler_(e);
+};
+
+
+/**
+ * Sets a custom error handler that can be used to customize the behavior of
+ * assertion failures, for example by turning all assertion failures into log
+ * messages.
+ * @param {function(!goog.asserts.AssertionError)} errorHandler
+ */
+goog.asserts.setErrorHandler = function(errorHandler) {
+  if (goog.asserts.ENABLE_ASSERTS) {
+    goog.asserts.errorHandler_ = errorHandler;
+  }
 };
 
 
 /**
  * Checks if the condition evaluates to true if goog.asserts.ENABLE_ASSERTS is
  * true.
- * @param {*} condition The condition to check.
+ * @template T
+ * @param {T} condition The condition to check.
  * @param {string=} opt_message Error message in case of failure.
  * @param {...*} var_args The items to substitute into the failure message.
- * @return {*} The value of the condition.
+ * @return {T} The value of the condition.
  * @throws {goog.asserts.AssertionError} When the condition evaluates to false.
  */
 goog.asserts.assert = function(condition, opt_message, var_args) {
@@ -141,9 +173,9 @@ goog.asserts.assert = function(condition, opt_message, var_args) {
  */
 goog.asserts.fail = function(opt_message, var_args) {
   if (goog.asserts.ENABLE_ASSERTS) {
-    throw new goog.asserts.AssertionError(
+    goog.asserts.errorHandler_(new goog.asserts.AssertionError(
         'Failure' + (opt_message ? ': ' + opt_message : ''),
-        Array.prototype.slice.call(arguments, 1));
+        Array.prototype.slice.call(arguments, 1)));
   }
 };
 
@@ -226,7 +258,7 @@ goog.asserts.assertObject = function(value, opt_message, var_args) {
  * @param {*} value The value to check.
  * @param {string=} opt_message Error message in case of failure.
  * @param {...*} var_args The items to substitute into the failure message.
- * @return {!Array} The value, guaranteed to be a non-null array.
+ * @return {!Array<?>} The value, guaranteed to be a non-null array.
  * @throws {goog.asserts.AssertionError} When the value is not an array.
  */
 goog.asserts.assertArray = function(value, opt_message, var_args) {
@@ -235,7 +267,7 @@ goog.asserts.assertArray = function(value, opt_message, var_args) {
         [goog.typeOf(value), value], opt_message,
         Array.prototype.slice.call(arguments, 2));
   }
-  return /** @type {!Array} */ (value);
+  return /** @type {!Array<?>} */ (value);
 };
 
 
@@ -258,26 +290,76 @@ goog.asserts.assertBoolean = function(value, opt_message, var_args) {
 };
 
 
+/**
+ * Checks if the value is a DOM Element if goog.asserts.ENABLE_ASSERTS is true.
+ * @param {*} value The value to check.
+ * @param {string=} opt_message Error message in case of failure.
+ * @param {...*} var_args The items to substitute into the failure message.
+ * @return {!Element} The value, likely to be a DOM Element when asserts are
+ *     enabled.
+ * @throws {goog.asserts.AssertionError} When the value is not an Element.
+ */
+goog.asserts.assertElement = function(value, opt_message, var_args) {
+  if (goog.asserts.ENABLE_ASSERTS && (!goog.isObject(value) ||
+      value.nodeType != goog.dom.NodeType.ELEMENT)) {
+    goog.asserts.doAssertFailure_('Expected Element but got %s: %s.',
+        [goog.typeOf(value), value], opt_message,
+        Array.prototype.slice.call(arguments, 2));
+  }
+  return /** @type {!Element} */ (value);
+};
+
+
 /**
  * Checks if the value is an instance of the user-defined type if
  * goog.asserts.ENABLE_ASSERTS is true.
  *
  * The compiler may tighten the type returned by this function.
  *
- * @param {*} value The value to check.
+ * @param {?} value The value to check.
  * @param {function(new: T, ...)} type A user-defined constructor.
  * @param {string=} opt_message Error message in case of failure.
  * @param {...*} var_args The items to substitute into the failure message.
  * @throws {goog.asserts.AssertionError} When the value is not an instance of
  *     type.
- * @return {!T}
+ * @return {T}
  * @template T
  */
 goog.asserts.assertInstanceof = function(value, type, opt_message, var_args) {
   if (goog.asserts.ENABLE_ASSERTS && !(value instanceof type)) {
-    goog.asserts.doAssertFailure_('instanceof check failed.', null,
+    goog.asserts.doAssertFailure_('Expected instanceof %s but got %s.',
+        [goog.asserts.getType_(type), goog.asserts.getType_(value)],
         opt_message, Array.prototype.slice.call(arguments, 3));
   }
   return value;
 };
 
+
+/**
+ * Checks that no enumerable keys are present in Object.prototype. Such keys
+ * would break most code that use {@code for (var ... in ...)} loops.
+ */
+goog.asserts.assertObjectPrototypeIsIntact = function() {
+  for (var key in Object.prototype) {
+    goog.asserts.fail(key + ' should not be enumerable in Object.prototype.');
+  }
+};
+
+
+/**
+ * Returns the type of a value. If a constructor is passed, and a suitable
+ * string cannot be found, 'unknown type name' will be returned.
+ * @param {*} value A constructor, object, or primitive.
+ * @return {string} The best display name for the value, or 'unknown type name'.
+ * @private
+ */
+goog.asserts.getType_ = function(value) {
+  if (value instanceof Function) {
+    return value.displayName || value.name || 'unknown type name';
+  } else if (value instanceof Object) {
+    return value.constructor.displayName || value.constructor.name ||
+        Object.prototype.toString.call(value);
+  } else {
+    return value === null ? 'null' : typeof value;
+  }
+};
diff --git a/lib/goog/async/freelist.js b/lib/goog/async/freelist.js
new file mode 100644
index 0000000..d0331f2
--- /dev/null
+++ b/lib/goog/async/freelist.js
@@ -0,0 +1,88 @@
+// Copyright 2015 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Simple freelist.
+ *
+ * An anterative to goog.structs.SimplePool, it imposes the requirement that the
+ * objects in the list contain a "next" property that can be used to maintain
+ * the pool.
+ */
+
+goog.provide('goog.async.FreeList');
+
+
+/**
+ * @template ITEM
+ */
+goog.async.FreeList = goog.defineClass(null, {
+  /**
+   * @param {function():ITEM} create
+   * @param {function(ITEM):void} reset
+   * @param {number} limit
+   */
+  constructor: function(create, reset, limit) {
+    /** @const {number} */
+    this.limit_ = limit;
+    /** @const {function()} */
+    this.create_ = create;
+    /** @const {function(ITEM):void} */
+    this.reset_ = reset;
+
+    /** @type {number} */
+    this.occupants_ = 0;
+    /** @type {ITEM} */
+    this.head_ = null;
+  },
+
+  /**
+   * @return {ITEM}
+   */
+  get: function() {
+    var item;
+    if (this.occupants_ > 0) {
+      this.occupants_--;
+      item = this.head_;
+      this.head_ = item.next;
+      item.next = null;
+    } else {
+      item = this.create_();
+    }
+    return item;
+  },
+
+  /**
+   * @param {ITEM} item An item available for possible future reuse.
+   */
+  put: function(item) {
+    this.reset_(item);
+    if (this.occupants_ < this.limit_) {
+      this.occupants_++;
+      item.next = this.head_;
+      this.head_ = item;
+    }
+  },
+
+  /**
+   * Visible for testing.
+   * @package
+   * @return {number}
+   */
+  occupants: function() {
+    return this.occupants_;
+  }
+});
+
+
+
diff --git a/lib/goog/async/nexttick.js b/lib/goog/async/nexttick.js
new file mode 100644
index 0000000..bdbad6b
--- /dev/null
+++ b/lib/goog/async/nexttick.js
@@ -0,0 +1,241 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Provides a function to schedule running a function as soon
+ * as possible after the current JS execution stops and yields to the event
+ * loop.
+ *
+ */
+
+goog.provide('goog.async.nextTick');
+goog.provide('goog.async.throwException');
+
+goog.require('goog.debug.entryPointRegistry');
+goog.require('goog.dom.TagName');
+goog.require('goog.functions');
+goog.require('goog.labs.userAgent.browser');
+goog.require('goog.labs.userAgent.engine');
+
+
+/**
+ * Throw an item without interrupting the current execution context.  For
+ * example, if processing a group of items in a loop, sometimes it is useful
+ * to report an error while still allowing the rest of the batch to be
+ * processed.
+ * @param {*} exception
+ */
+goog.async.throwException = function(exception) {
+  // Each throw needs to be in its own context.
+  goog.global.setTimeout(function() { throw exception; }, 0);
+};
+
+
+/**
+ * Fires the provided callbacks as soon as possible after the current JS
+ * execution context. setTimeout(…, 0) takes at least 4ms when called from
+ * within another setTimeout(…, 0) for legacy reasons.
+ *
+ * This will not schedule the callback as a microtask (i.e. a task that can
+ * preempt user input or networking callbacks). It is meant to emulate what
+ * setTimeout(_, 0) would do if it were not throttled. If you desire microtask
+ * behavior, use {@see goog.Promise} instead.
+ *
+ * @param {function(this:SCOPE)} callback Callback function to fire as soon as
+ *     possible.
+ * @param {SCOPE=} opt_context Object in whose scope to call the listener.
+ * @param {boolean=} opt_useSetImmediate Avoid the IE workaround that
+ *     ensures correctness at the cost of speed. See comments for details.
+ * @template SCOPE
+ */
+goog.async.nextTick = function(callback, opt_context, opt_useSetImmediate) {
+  var cb = callback;
+  if (opt_context) {
+    cb = goog.bind(callback, opt_context);
+  }
+  cb = goog.async.nextTick.wrapCallback_(cb);
+  // window.setImmediate was introduced and currently only supported by IE10+,
+  // but due to a bug in the implementation it is not guaranteed that
+  // setImmediate is faster than setTimeout nor that setImmediate N is before
+  // setImmediate N+1. That is why we do not use the native version if
+  // available. We do, however, call setImmediate if it is a normal function
+  // because that indicates that it has been replaced by goog.testing.MockClock
+  // which we do want to support.
+  // See
+  // http://connect.microsoft.com/IE/feedback/details/801823/setimmediate-and-messagechannel-are-broken-in-ie10
+  //
+  // Note we do allow callers to also request setImmediate if they are willing
+  // to accept the possible tradeoffs of incorrectness in exchange for speed.
+  // The IE fallback of readystate change is much slower.
+  if (goog.isFunction(goog.global.setImmediate) &&
+      // Opt in.
+      (opt_useSetImmediate ||
+      // or it isn't a browser or the environment is weird
+      !goog.global.Window || !goog.global.Window.prototype ||
+      // or something redefined setImmediate in which case we (YOLO) decide
+      // to use it (This is so that we use the mockClock setImmediate. sigh).
+      goog.global.Window.prototype.setImmediate != goog.global.setImmediate)) {
+    goog.global.setImmediate(cb);
+    return;
+  }
+
+  // Look for and cache the custom fallback version of setImmediate.
+  if (!goog.async.nextTick.setImmediate_) {
+    goog.async.nextTick.setImmediate_ =
+        goog.async.nextTick.getSetImmediateEmulator_();
+  }
+  goog.async.nextTick.setImmediate_(cb);
+};
+
+
+/**
+ * Cache for the setImmediate implementation.
+ * @type {function(function())}
+ * @private
+ */
+goog.async.nextTick.setImmediate_;
+
+
+/**
+ * Determines the best possible implementation to run a function as soon as
+ * the JS event loop is idle.
+ * @return {function(function())} The "setImmediate" implementation.
+ * @private
+ */
+goog.async.nextTick.getSetImmediateEmulator_ = function() {
+  // Create a private message channel and use it to postMessage empty messages
+  // to ourselves.
+  var Channel = goog.global['MessageChannel'];
+  // If MessageChannel is not available and we are in a browser, implement
+  // an iframe based polyfill in browsers that have postMessage and
+  // document.addEventListener. The latter excludes IE8 because it has a
+  // synchronous postMessage implementation.
+  if (typeof Channel === 'undefined' && typeof window !== 'undefined' &&
+      window.postMessage && window.addEventListener &&
+      // Presto (The old pre-blink Opera engine) has problems with iframes
+      // and contentWindow.
+      !goog.labs.userAgent.engine.isPresto()) {
+    /** @constructor */
+    Channel = function() {
+      // Make an empty, invisible iframe.
+      var iframe = document.createElement(goog.dom.TagName.IFRAME);
+      iframe.style.display = 'none';
+      iframe.src = '';
+      document.documentElement.appendChild(iframe);
+      var win = iframe.contentWindow;
+      var doc = win.document;
+      doc.open();
+      doc.write('');
+      doc.close();
+      // Do not post anything sensitive over this channel, as the workaround for
+      // pages with file: origin could allow that information to be modified or
+      // intercepted.
+      var message = 'callImmediate' + Math.random();
+      // The same origin policy rejects attempts to postMessage from file: urls
+      // unless the origin is '*'.
+      // TODO(b/16335441): Use '*' origin for data: and other similar protocols.
+      var origin = win.location.protocol == 'file:' ?
+          '*' : win.location.protocol + '//' + win.location.host;
+      var onmessage = goog.bind(function(e) {
+        // Validate origin and message to make sure that this message was
+        // intended for us. If the origin is set to '*' (see above) only the
+        // message needs to match since, for example, '*' != 'file://'. Allowing
+        // the wildcard is ok, as we are not concerned with security here.
+        if ((origin != '*' && e.origin != origin) || e.data != message) {
+          return;
+        }
+        this['port1'].onmessage();
+      }, this);
+      win.addEventListener('message', onmessage, false);
+      this['port1'] = {};
+      this['port2'] = {
+        postMessage: function() {
+          win.postMessage(message, origin);
+        }
+      };
+    };
+  }
+  if (typeof Channel !== 'undefined' &&
+      (!goog.labs.userAgent.browser.isIE())) {
+    // Exclude all of IE due to
+    // http://codeforhire.com/2013/09/21/setimmediate-and-messagechannel-broken-on-internet-explorer-10/
+    // which allows starving postMessage with a busy setTimeout loop.
+    // This currently affects IE10 and IE11 which would otherwise be able
+    // to use the postMessage based fallbacks.
+    var channel = new Channel();
+    // Use a fifo linked list to call callbacks in the right order.
+    var head = {};
+    var tail = head;
+    channel['port1'].onmessage = function() {
+      if (goog.isDef(head.next)) {
+        head = head.next;
+        var cb = head.cb;
+        head.cb = null;
+        cb();
+      }
+    };
+    return function(cb) {
+      tail.next = {
+        cb: cb
+      };
+      tail = tail.next;
+      channel['port2'].postMessage(0);
+    };
+  }
+  // Implementation for IE6+: Script elements fire an asynchronous
+  // onreadystatechange event when inserted into the DOM.
+  if (typeof document !== 'undefined' && 'onreadystatechange' in
+      document.createElement(goog.dom.TagName.SCRIPT)) {
+    return function(cb) {
+      var script = document.createElement(goog.dom.TagName.SCRIPT);
+      script.onreadystatechange = function() {
+        // Clean up and call the callback.
+        script.onreadystatechange = null;
+        script.parentNode.removeChild(script);
+        script = null;
+        cb();
+        cb = null;
+      };
+      document.documentElement.appendChild(script);
+    };
+  }
+  // Fall back to setTimeout with 0. In browsers this creates a delay of 5ms
+  // or more.
+  return function(cb) {
+    goog.global.setTimeout(cb, 0);
+  };
+};
+
+
+/**
+ * Helper function that is overrided to protect callbacks with entry point
+ * monitor if the application monitors entry points.
+ * @param {function()} callback Callback function to fire as soon as possible.
+ * @return {function()} The wrapped callback.
+ * @private
+ */
+goog.async.nextTick.wrapCallback_ = goog.functions.identity;
+
+
+// Register the callback function as an entry point, so that it can be
+// monitored for exception handling, etc. This has to be done in this file
+// since it requires special code to handle all browsers.
+goog.debug.entryPointRegistry.register(
+    /**
+     * @param {function(!Function): !Function} transformer The transforming
+     *     function.
+     */
+    function(transformer) {
+      goog.async.nextTick.wrapCallback_ = transformer;
+    });
diff --git a/lib/goog/async/run.js b/lib/goog/async/run.js
new file mode 100644
index 0000000..749c9b9
--- /dev/null
+++ b/lib/goog/async/run.js
@@ -0,0 +1,133 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.async.run');
+
+goog.require('goog.async.WorkQueue');
+goog.require('goog.async.nextTick');
+goog.require('goog.async.throwException');
+
+
+/**
+ * Fires the provided callback just before the current callstack unwinds, or as
+ * soon as possible after the current JS execution context.
+ * @param {function(this:THIS)} callback
+ * @param {THIS=} opt_context Object to use as the "this value" when calling
+ *     the provided function.
+ * @template THIS
+ */
+goog.async.run = function(callback, opt_context) {
+  if (!goog.async.run.schedule_) {
+    goog.async.run.initializeRunner_();
+  }
+  if (!goog.async.run.workQueueScheduled_) {
+    // Nothing is currently scheduled, schedule it now.
+    goog.async.run.schedule_();
+    goog.async.run.workQueueScheduled_ = true;
+  }
+
+  goog.async.run.workQueue_.add(callback, opt_context);
+};
+
+
+/**
+ * Initializes the function to use to process the work queue.
+ * @private
+ */
+goog.async.run.initializeRunner_ = function() {
+  // If native Promises are available in the browser, just schedule the callback
+  // on a fulfilled promise, which is specified to be async, but as fast as
+  // possible.
+  if (goog.global.Promise && goog.global.Promise.resolve) {
+    var promise = goog.global.Promise.resolve(undefined);
+    goog.async.run.schedule_ = function() {
+      promise.then(goog.async.run.processWorkQueue);
+    };
+  } else {
+    goog.async.run.schedule_ = function() {
+      goog.async.nextTick(goog.async.run.processWorkQueue);
+    };
+  }
+};
+
+
+/**
+ * Forces goog.async.run to use nextTick instead of Promise.
+ *
+ * This should only be done in unit tests. It's useful because MockClock
+ * replaces nextTick, but not the browser Promise implementation, so it allows
+ * Promise-based code to be tested with MockClock.
+ *
+ * However, we also want to run promises if the MockClock is no longer in
+ * control so we schedule a backup "setTimeout" to the unmocked timeout if
+ * provided.
+ *
+ * @param {function(function())=} opt_realSetTimeout
+ */
+goog.async.run.forceNextTick = function(opt_realSetTimeout) {
+  goog.async.run.schedule_ = function() {
+    goog.async.nextTick(goog.async.run.processWorkQueue);
+    if (opt_realSetTimeout) {
+      opt_realSetTimeout(goog.async.run.processWorkQueue);
+    }
+  };
+};
+
+
+/**
+ * The function used to schedule work asynchronousely.
+ * @private {function()}
+ */
+goog.async.run.schedule_;
+
+
+/** @private {boolean} */
+goog.async.run.workQueueScheduled_ = false;
+
+
+/** @private {!goog.async.WorkQueue} */
+goog.async.run.workQueue_ = new goog.async.WorkQueue();
+
+
+if (goog.DEBUG) {
+  /**
+   * Reset the work queue. Only available for tests in debug mode.
+   */
+  goog.async.run.resetQueue = function() {
+    goog.async.run.workQueueScheduled_ = false;
+    goog.async.run.workQueue_ = new goog.async.WorkQueue();
+  };
+}
+
+
+/**
+ * Run any pending goog.async.run work items. This function is not intended
+ * for general use, but for use by entry point handlers to run items ahead of
+ * goog.async.nextTick.
+ */
+goog.async.run.processWorkQueue = function() {
+  // NOTE: additional work queue items may be added while processing.
+  var item = null;
+  while (item = goog.async.run.workQueue_.remove()) {
+    try {
+      item.fn.call(item.scope);
+    } catch (e) {
+      goog.async.throwException(e);
+    }
+    goog.async.run.workQueue_.returnUnused(item);
+  }
+
+  // There are no more work items, allow processing to be scheduled again.
+  goog.async.run.workQueueScheduled_ = false;
+};
diff --git a/lib/goog/async/workqueue.js b/lib/goog/async/workqueue.js
new file mode 100644
index 0000000..2d86c89
--- /dev/null
+++ b/lib/goog/async/workqueue.js
@@ -0,0 +1,139 @@
+// Copyright 2015 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.async.WorkItem');
+goog.provide('goog.async.WorkQueue');
+
+goog.require('goog.asserts');
+goog.require('goog.async.FreeList');
+
+
+// TODO(johnlenz): generalize the WorkQueue if this is used by more
+// than goog.async.run.
+
+
+
+/**
+ * A low GC workqueue. The key elements of this design:
+ *   - avoids the need for goog.bind or equivalent by carrying scope
+ *   - avoids the need for array reallocation by using a linked list
+ *   - minimizes work entry objects allocation by recycling objects
+ * @constructor
+ * @final
+ * @struct
+ */
+goog.async.WorkQueue = function() {
+  this.workHead_ = null;
+  this.workTail_ = null;
+};
+
+
+/** @define {number} The maximum number of entries to keep for recycling. */
+goog.define('goog.async.WorkQueue.DEFAULT_MAX_UNUSED', 100);
+
+
+/** @const @private {goog.async.FreeList<goog.async.WorkItem>} */
+goog.async.WorkQueue.freelist_ = new goog.async.FreeList(
+    function() {return new goog.async.WorkItem(); },
+    function(item) {item.reset()},
+    goog.async.WorkQueue.DEFAULT_MAX_UNUSED);
+
+
+/**
+ * @param {function()} fn
+ * @param {Object|null|undefined} scope
+ */
+goog.async.WorkQueue.prototype.add = function(fn, scope) {
+  var item = this.getUnusedItem_();
+  item.set(fn, scope);
+
+  if (this.workTail_) {
+    this.workTail_.next = item;
+    this.workTail_ = item;
+  } else {
+    goog.asserts.assert(!this.workHead_);
+    this.workHead_ = item;
+    this.workTail_ = item;
+  }
+};
+
+
+/**
+ * @return {goog.async.WorkItem}
+ */
+goog.async.WorkQueue.prototype.remove = function() {
+  var item = null;
+
+  if (this.workHead_) {
+    item = this.workHead_;
+    this.workHead_ = this.workHead_.next;
+    if (!this.workHead_) {
+      this.workTail_ = null;
+    }
+    item.next = null;
+  }
+  return item;
+};
+
+
+/**
+ * @param {goog.async.WorkItem} item
+ */
+goog.async.WorkQueue.prototype.returnUnused = function(item) {
+  goog.async.WorkQueue.freelist_.put(item);
+};
+
+
+/**
+ * @return {goog.async.WorkItem}
+ * @private
+ */
+goog.async.WorkQueue.prototype.getUnusedItem_ = function() {
+  return goog.async.WorkQueue.freelist_.get();
+};
+
+
+
+/**
+ * @constructor
+ * @final
+ * @struct
+ */
+goog.async.WorkItem = function() {
+  /** @type {?function()} */
+  this.fn = null;
+  /** @type {Object|null|undefined} */
+  this.scope = null;
+  /** @type {?goog.async.WorkItem} */
+  this.next = null;
+};
+
+
+/**
+ * @param {function()} fn
+ * @param {Object|null|undefined} scope
+ */
+goog.async.WorkItem.prototype.set = function(fn, scope) {
+  this.fn = fn;
+  this.scope = scope;
+  this.next = null;
+};
+
+
+/** Reset the work item so they don't prevent GC before reuse */
+goog.async.WorkItem.prototype.reset = function() {
+  this.fn = null;
+  this.scope = null;
+  this.next = null;
+};
diff --git a/lib/goog/base.js b/lib/goog/base.js
index 39bd73a..39db84d 100644
--- a/lib/goog/base.js
+++ b/lib/goog/base.js
@@ -19,22 +19,23 @@
  * global <code>CLOSURE_NO_DEPS</code> is set to true.  This allows projects to
  * include their own deps file(s) from different locations.
  *
+ * @author arv@google.com (Erik Arvidsson)
  *
  * @provideGoog
  */
 
 
 /**
- * @define {boolean} Overridden to true by the compiler when --closure_pass
- *     or --mark_as_compiled is specified.
+ * @define {boolean} Overridden to true by the compiler when
+ *     --process_closure_primitives is specified.
  */
 var COMPILED = false;
 
 
 /**
- * Base namespace for the Closure library.  Checks to see goog is
- * already defined in the current scope before assigning to prevent
- * clobbering if base.js is loaded more than once.
+ * Base namespace for the Closure library.  Checks to see goog is already
+ * defined in the current scope before assigning to prevent clobbering if
+ * base.js is loaded more than once.
  *
  * @const
  */
@@ -50,26 +51,61 @@ goog.global = this;
 /**
  * A hook for overriding the define values in uncompiled mode.
  *
- * In uncompiled mode, {@code CLOSURE_DEFINES} may be defined before loading
- * base.js.  If a key is defined in {@code CLOSURE_DEFINES}, {@code goog.define}
- * will use the value instead of the default value.  This allows flags to be
- * overwritten without compilation (this is normally accomplished with the
- * compiler's "define" flag).
+ * In uncompiled mode, {@code CLOSURE_UNCOMPILED_DEFINES} may be defined before
+ * loading base.js.  If a key is defined in {@code CLOSURE_UNCOMPILED_DEFINES},
+ * {@code goog.define} will use the value instead of the default value.  This
+ * allows flags to be overwritten without compilation (this is normally
+ * accomplished with the compiler's "define" flag).
  *
  * Example:
  * <pre>
- *   var CLOSURE_DEFINES = {'goog.DEBUG', false};
+ *   var CLOSURE_UNCOMPILED_DEFINES = {'goog.DEBUG': false};
  * </pre>
  *
- * @type {Object.<string, (string|number|boolean)>|undefined}
+ * @type {Object<string, (string|number|boolean)>|undefined}
+ */
+goog.global.CLOSURE_UNCOMPILED_DEFINES;
+
+
+/**
+ * A hook for overriding the define values in uncompiled or compiled mode,
+ * like CLOSURE_UNCOMPILED_DEFINES but effective in compiled code.  In
+ * uncompiled code CLOSURE_UNCOMPILED_DEFINES takes precedence.
+ *
+ * Also unlike CLOSURE_UNCOMPILED_DEFINES the values must be number, boolean or
+ * string literals or the compiler will emit an error.
+ *
+ * While any @define value may be set, only those set with goog.define will be
+ * effective for uncompiled code.
+ *
+ * Example:
+ * <pre>
+ *   var CLOSURE_DEFINES = {'goog.DEBUG': false} ;
+ * </pre>
+ *
+ * @type {Object<string, (string|number|boolean)>|undefined}
  */
 goog.global.CLOSURE_DEFINES;
 
 
 /**
- * Builds an object structure for the provided namespace path,
- * ensuring that names that already exist are not overwritten. For
- * example:
+ * Returns true if the specified value is not undefined.
+ * WARNING: Do not use this to test if an object has a property. Use the in
+ * operator instead.
+ *
+ * @param {?} val Variable to test.
+ * @return {boolean} Whether variable is defined.
+ */
+goog.isDef = function(val) {
+  // void 0 always evaluates to undefined and hence we do not need to depend on
+  // the definition of the global variable named 'undefined'.
+  return val !== void 0;
+};
+
+
+/**
+ * Builds an object structure for the provided namespace path, ensuring that
+ * names that already exist are not overwritten. For example:
  * "a.b.c" -> a = {};a.b={};a.b.c={};
  * Used by goog.provide and goog.exportSymbol.
  * @param {string} name name of the object that this file defines.
@@ -96,7 +132,7 @@ goog.exportPath_ = function(name, opt_object, opt_objectToExportTo) {
 
   // Parentheses added to eliminate strict JS warning in Firefox.
   for (var part; parts.length && (part = parts.shift());) {
-    if (!parts.length && opt_object !== undefined) {
+    if (!parts.length && goog.isDef(opt_object)) {
       // last part and we have an object; use it
       cur[part] = opt_object;
     } else if (cur[part]) {
@@ -109,10 +145,11 @@ goog.exportPath_ = function(name, opt_object, opt_objectToExportTo) {
 
 
 /**
- * Defines a named value. In uncompiled mode, the value is retreived from
- * CLOSURE_DEFINES if the object is defined and has the property specified,
- * and otherwise used the defined defaultValue. When compiled, the default
- * can be overridden using compiler command-line options.
+ * Defines a named value. In uncompiled mode, the value is retrieved from
+ * CLOSURE_DEFINES or CLOSURE_UNCOMPILED_DEFINES if the object is defined and
+ * has the property specified, and otherwise used the defined defaultValue.
+ * When compiled the default can be overridden using the compiler
+ * options or the value set in the CLOSURE_DEFINES object.
  *
  * @param {string} name The distinguished name to provide.
  * @param {string|number|boolean} defaultValue
@@ -120,8 +157,13 @@ goog.exportPath_ = function(name, opt_object, opt_objectToExportTo) {
 goog.define = function(name, defaultValue) {
   var value = defaultValue;
   if (!COMPILED) {
-    if (goog.global.CLOSURE_DEFINES && Object.prototype.hasOwnProperty.call(
-        goog.global.CLOSURE_DEFINES, name)) {
+    if (goog.global.CLOSURE_UNCOMPILED_DEFINES &&
+        Object.prototype.hasOwnProperty.call(
+            goog.global.CLOSURE_UNCOMPILED_DEFINES, name)) {
+      value = goog.global.CLOSURE_UNCOMPILED_DEFINES[name];
+    } else if (goog.global.CLOSURE_DEFINES &&
+        Object.prototype.hasOwnProperty.call(
+            goog.global.CLOSURE_DEFINES, name)) {
       value = goog.global.CLOSURE_DEFINES[name];
     }
   }
@@ -137,7 +179,7 @@ goog.define = function(name, defaultValue) {
  * because they are generally used for debugging purposes and it is difficult
  * for the JSCompiler to statically determine whether they are used.
  */
-goog.DEBUG = true;
+goog.define('goog.DEBUG', true);
 
 
 /**
@@ -169,7 +211,7 @@ goog.define('goog.LOCALE', 'en');  // default to en
  * external libraries like Prototype, Datejs, and JQuery and setting this flag
  * to false forces closure to use its own implementations when possible.
  *
- * If your javascript can be loaded by a third party site and you are wary about
+ * If your JavaScript can be loaded by a third party site and you are wary about
  * relying on non-standard implementations, specify
  * "--define goog.TRUSTED_SITE=false" to the JSCompiler.
  */
@@ -177,24 +219,73 @@ goog.define('goog.TRUSTED_SITE', true);
 
 
 /**
- * Creates object stubs for a namespace.  The presence of one or more
- * goog.provide() calls indicate that the file defines the given
- * objects/namespaces.  Build tools also scan for provide/require statements
+ * @define {boolean} Whether a project is expected to be running in strict mode.
+ *
+ * This define can be used to trigger alternate implementations compatible with
+ * running in EcmaScript Strict mode or warn about unavailable functionality.
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions_and_function_scope/Strict_mode
+ *
+ */
+goog.define('goog.STRICT_MODE_COMPATIBLE', false);
+
+
+/**
+ * @define {boolean} Whether code that calls {@link goog.setTestOnly} should
+ *     be disallowed in the compilation unit.
+ */
+goog.define('goog.DISALLOW_TEST_ONLY_CODE', COMPILED && !goog.DEBUG);
+
+
+/**
+ * @define {boolean} Whether to use a Chrome app CSP-compliant method for
+ *     loading scripts via goog.require. @see appendScriptSrcNode_.
+ */
+goog.define('goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING', false);
+
+
+/**
+ * Defines a namespace in Closure.
+ *
+ * A namespace may only be defined once in a codebase. It may be defined using
+ * goog.provide() or goog.module().
+ *
+ * The presence of one or more goog.provide() calls in a file indicates
+ * that the file defines the given objects/namespaces.
+ * Provided symbols must not be null or undefined.
+ *
+ * In addition, goog.provide() creates the object stubs for a namespace
+ * (for example, goog.provide("goog.foo.bar") will create the object
+ * goog.foo.bar if it does not already exist).
+ *
+ * Build tools also scan for provide/require/module statements
  * to discern dependencies, build dependency files (see deps.js), etc.
+ *
  * @see goog.require
+ * @see goog.module
  * @param {string} name Namespace provided by this file in the form
  *     "goog.package.part".
  */
 goog.provide = function(name) {
   if (!COMPILED) {
-    // Ensure that the same namespace isn't provided twice. This is intended
-    // to teach new developers that 'goog.provide' is effectively a variable
-    // declaration. And when JSCompiler transforms goog.provide into a real
-    // variable declaration, the compiled JS should work the same as the raw
-    // JS--even when the raw JS uses goog.provide incorrectly.
+    // Ensure that the same namespace isn't provided twice.
+    // A goog.module/goog.provide maps a goog.require to a specific file
     if (goog.isProvided_(name)) {
       throw Error('Namespace "' + name + '" already declared.');
     }
+  }
+
+  goog.constructNamespace_(name);
+};
+
+
+/**
+ * @param {string} name Namespace provided by this file in the form
+ *     "goog.package.part".
+ * @param {Object=} opt_obj The object to embed in the namespace.
+ * @private
+ */
+goog.constructNamespace_ = function(name, opt_obj) {
+  if (!COMPILED) {
     delete goog.implicitNamespaces_[name];
 
     var namespace = name;
@@ -206,7 +297,142 @@ goog.provide = function(name) {
     }
   }
 
-  goog.exportPath_(name);
+  goog.exportPath_(name, opt_obj);
+};
+
+
+/**
+ * Module identifier validation regexp.
+ * Note: This is a conservative check, it is very possible to be more lenient,
+ *   the primary exclusion here is "/" and "\" and a leading ".", these
+ *   restrictions are intended to leave the door open for using goog.require
+ *   with relative file paths rather than module identifiers.
+ * @private
+ */
+goog.VALID_MODULE_RE_ = /^[a-zA-Z_$][a-zA-Z0-9._$]*$/;
+
+
+/**
+ * Defines a module in Closure.
+ *
+ * Marks that this file must be loaded as a module and claims the namespace.
+ *
+ * A namespace may only be defined once in a codebase. It may be defined using
+ * goog.provide() or goog.module().
+ *
+ * goog.module() has three requirements:
+ * - goog.module may not be used in the same file as goog.provide.
+ * - goog.module must be the first statement in the file.
+ * - only one goog.module is allowed per file.
+ *
+ * When a goog.module annotated file is loaded, it is enclosed in
+ * a strict function closure. This means that:
+ * - any variables declared in a goog.module file are private to the file
+ * (not global), though the compiler is expected to inline the module.
+ * - The code must obey all the rules of "strict" JavaScript.
+ * - the file will be marked as "use strict"
+ *
+ * NOTE: unlike goog.provide, goog.module does not declare any symbols by
+ * itself. If declared symbols are desired, use
+ * goog.module.declareLegacyNamespace().
+ *
+ *
+ * See the public goog.module proposal: http://goo.gl/Va1hin
+ *
+ * @param {string} name Namespace provided by this file in the form
+ *     "goog.package.part", is expected but not required.
+ */
+goog.module = function(name) {
+  if (!goog.isString(name) ||
+      !name ||
+      name.search(goog.VALID_MODULE_RE_) == -1) {
+    throw Error('Invalid module identifier');
+  }
+  if (!goog.isInModuleLoader_()) {
+    throw Error('Module ' + name + ' has been loaded incorrectly.');
+  }
+  if (goog.moduleLoaderState_.moduleName) {
+    throw Error('goog.module may only be called once per module.');
+  }
+
+  // Store the module name for the loader.
+  goog.moduleLoaderState_.moduleName = name;
+  if (!COMPILED) {
+    // Ensure that the same namespace isn't provided twice.
+    // A goog.module/goog.provide maps a goog.require to a specific file
+    if (goog.isProvided_(name)) {
+      throw Error('Namespace "' + name + '" already declared.');
+    }
+    delete goog.implicitNamespaces_[name];
+  }
+};
+
+
+/**
+ * @param {string} name The module identifier.
+ * @return {?} The module exports for an already loaded module or null.
+ *
+ * Note: This is not an alternative to goog.require, it does not
+ * indicate a hard dependency, instead it is used to indicate
+ * an optional dependency or to access the exports of a module
+ * that has already been loaded.
+ * @suppress {missingProvide}
+ */
+goog.module.get = function(name) {
+  return goog.module.getInternal_(name);
+};
+
+
+/**
+ * @param {string} name The module identifier.
+ * @return {?} The module exports for an already loaded module or null.
+ * @private
+ */
+goog.module.getInternal_ = function(name) {
+  if (!COMPILED) {
+    if (goog.isProvided_(name)) {
+      // goog.require only return a value with-in goog.module files.
+      return name in goog.loadedModules_ ?
+          goog.loadedModules_[name] :
+          goog.getObjectByName(name);
+    } else {
+      return null;
+    }
+  }
+};
+
+
+/**
+ * @private {?{moduleName: (string|undefined), declareLegacyNamespace:boolean}}
+ */
+goog.moduleLoaderState_ = null;
+
+
+/**
+ * @private
+ * @return {boolean} Whether a goog.module is currently being initialized.
+ */
+goog.isInModuleLoader_ = function() {
+  return goog.moduleLoaderState_ != null;
+};
+
+
+/**
+ * Provide the module's exports as a globally accessible object under the
+ * module's declared name.  This is intended to ease migration to goog.module
+ * for files that have existing usages.
+ * @suppress {missingProvide}
+ */
+goog.module.declareLegacyNamespace = function() {
+  if (!COMPILED && !goog.isInModuleLoader_()) {
+    throw new Error('goog.module.declareLegacyNamespace must be called from ' +
+        'within a goog.module');
+  }
+  if (!COMPILED && !goog.moduleLoaderState_.moduleName) {
+    throw Error('goog.module must be called prior to ' +
+        'goog.module.declareLegacyNamespace.');
+  }
+  goog.moduleLoaderState_.declareLegacyNamespace = true;
 };
 
 
@@ -214,22 +440,51 @@ goog.provide = function(name) {
  * Marks that the current file should only be used for testing, and never for
  * live code in production.
  *
- * In the case of unit tests, the message may optionally be an exact
- * namespace for the test (e.g. 'goog.stringTest'). The linter will then
- * ignore the extra provide (if not explicitly defined in the code).
+ * In the case of unit tests, the message may optionally be an exact namespace
+ * for the test (e.g. 'goog.stringTest'). The linter will then ignore the extra
+ * provide (if not explicitly defined in the code).
  *
  * @param {string=} opt_message Optional message to add to the error that's
  *     raised when used in production code.
  */
 goog.setTestOnly = function(opt_message) {
-  if (COMPILED && !goog.DEBUG) {
+  if (goog.DISALLOW_TEST_ONLY_CODE) {
     opt_message = opt_message || '';
     throw Error('Importing test-only code into non-debug environment' +
-                opt_message ? ': ' + opt_message : '.');
+                (opt_message ? ': ' + opt_message : '.'));
   }
 };
 
 
+/**
+ * Forward declares a symbol. This is an indication to the compiler that the
+ * symbol may be used in the source yet is not required and may not be provided
+ * in compilation.
+ *
+ * The most common usage of forward declaration is code that takes a type as a
+ * function parameter but does not need to require it. By forward declaring
+ * instead of requiring, no hard dependency is made, and (if not required
+ * elsewhere) the namespace may never be required and thus, not be pulled
+ * into the JavaScript binary. If it is required elsewhere, it will be type
+ * checked as normal.
+ *
+ *
+ * @param {string} name The namespace to forward declare in the form of
+ *     "goog.package.part".
+ */
+goog.forwardDeclare = function(name) {};
+
+
+/**
+ * Forward declare type information. Used to assign types to goog.global
+ * referenced object that would otherwise result in unknown type references
+ * and thus block property disambiguation.
+ */
+goog.forwardDeclare('Document');
+goog.forwardDeclare('HTMLScriptElement');
+goog.forwardDeclare('XMLHttpRequest');
+
+
 if (!COMPILED) {
 
   /**
@@ -240,25 +495,33 @@ if (!COMPILED) {
    * @private
    */
   goog.isProvided_ = function(name) {
-    return !goog.implicitNamespaces_[name] && !!goog.getObjectByName(name);
+    return (name in goog.loadedModules_) ||
+        (!goog.implicitNamespaces_[name] &&
+            goog.isDefAndNotNull(goog.getObjectByName(name)));
   };
 
   /**
    * Namespaces implicitly defined by goog.provide. For example,
-   * goog.provide('goog.events.Event') implicitly declares
-   * that 'goog' and 'goog.events' must be namespaces.
+   * goog.provide('goog.events.Event') implicitly declares that 'goog' and
+   * 'goog.events' must be namespaces.
    *
-   * @type {Object}
+   * @type {!Object<string, (boolean|undefined)>}
    * @private
    */
-  goog.implicitNamespaces_ = {};
+  goog.implicitNamespaces_ = {'goog.module': true};
+
+  // NOTE: We add goog.module as an implicit namespace as goog.module is defined
+  // here and because the existing module package has not been moved yet out of
+  // the goog.module namespace. This satisifies both the debug loader and
+  // ahead-of-time dependency management.
 }
 
 
 /**
- * Returns an object based on its fully qualified external name.  If you are
- * using a compilation pass that renames property names beware that using this
- * function will not find renamed properties.
+ * Returns an object based on its fully qualified external name.  The object
+ * is not found if null or undefined.  If you are using a compilation pass that
+ * renames property names beware that using this function will not find renamed
+ * properties.
  *
  * @param {string} name The fully qualified name.
  * @param {Object=} opt_obj The object within which to look; default is
@@ -282,7 +545,7 @@ goog.getObjectByName = function(name, opt_obj) {
 /**
  * Globalizes a whole namespace, such as goog or goog.lang.
  *
- * @param {Object} obj The namespace to globalize.
+ * @param {!Object} obj The namespace to globalize.
  * @param {Object=} opt_global The object to add the properties to.
  * @deprecated Properties may be explicitly exported to the global scope, but
  *     this should no longer be done in bulk.
@@ -298,22 +561,21 @@ goog.globalize = function(obj, opt_global) {
 /**
  * Adds a dependency from a file to the files it requires.
  * @param {string} relPath The path to the js file.
- * @param {Array} provides An array of strings with the names of the objects
- *                         this file provides.
- * @param {Array} requires An array of strings with the names of the objects
- *                         this file requires.
- */
-goog.addDependency = function(relPath, provides, requires) {
+ * @param {!Array<string>} provides An array of strings with
+ *     the names of the objects this file provides.
+ * @param {!Array<string>} requires An array of strings with
+ *     the names of the objects this file requires.
+ * @param {boolean=} opt_isModule Whether this dependency must be loaded as
+ *     a module as declared by goog.module.
+ */
+goog.addDependency = function(relPath, provides, requires, opt_isModule) {
   if (goog.DEPENDENCIES_ENABLED) {
     var provide, require;
     var path = relPath.replace(/\\/g, '/');
     var deps = goog.dependencies_;
     for (var i = 0; provide = provides[i]; i++) {
       deps.nameToPath[provide] = path;
-      if (!(path in deps.pathToNames)) {
-        deps.pathToNames[path] = {};
-      }
-      deps.pathToNames[path][provide] = true;
+      deps.pathIsModule[path] = !!opt_isModule;
     }
     for (var j = 0; require = requires[j]; j++) {
       if (!(path in deps.requires)) {
@@ -327,17 +589,17 @@ goog.addDependency = function(relPath, provides, requires) {
 
 
 
-// NOTE(nnaze): The debug DOM loader was included in base.js as an orignal
-// way to do "debug-mode" development.  The dependency system can sometimes
-// be confusing, as can the debug DOM loader's asyncronous nature.
+// NOTE(nnaze): The debug DOM loader was included in base.js as an original way
+// to do "debug-mode" development.  The dependency system can sometimes be
+// confusing, as can the debug DOM loader's asynchronous nature.
 //
-// With the DOM loader, a call to goog.require() is not blocking -- the
-// script will not load until some point after the current script.  If a
-// namespace is needed at runtime, it needs to be defined in a previous
-// script, or loaded via require() with its registered dependencies.
+// With the DOM loader, a call to goog.require() is not blocking -- the script
+// will not load until some point after the current script.  If a namespace is
+// needed at runtime, it needs to be defined in a previous script, or loaded via
+// require() with its registered dependencies.
 // User-defined namespaces may need their own deps file.  See http://go/js_deps,
 // http://go/genjsdeps, or, externally, DepsWriter.
-// http://code.google.com/closure/library/docs/depswriter.html
+// https://developers.google.com/closure/library/docs/depswriter
 //
 // Because of legacy clients, the DOM loader can't be easily removed from
 // base.js.  Work is being done to make it disableable or replaceable for
@@ -359,50 +621,60 @@ goog.define('goog.ENABLE_DEBUG_LOADER', true);
 
 
 /**
- * Implements a system for the dynamic resolution of dependencies
- * that works in parallel with the BUILD system. Note that all calls
- * to goog.require will be stripped by the JSCompiler when the
- * --closure_pass option is used.
+ * @param {string} msg
+ * @private
+ */
+goog.logToConsole_ = function(msg) {
+  if (goog.global.console) {
+    goog.global.console['error'](msg);
+  }
+};
+
+
+/**
+ * Implements a system for the dynamic resolution of dependencies that works in
+ * parallel with the BUILD system. Note that all calls to goog.require will be
+ * stripped by the JSCompiler when the --process_closure_primitives option is
+ * used.
  * @see goog.provide
- * @param {string} name Namespace to include (as was given in goog.provide())
- *     in the form "goog.package.part".
+ * @param {string} name Namespace to include (as was given in goog.provide()) in
+ *     the form "goog.package.part".
+ * @return {?} If called within a goog.module file, the associated namespace or
+ *     module otherwise null.
  */
 goog.require = function(name) {
-
-  // if the object already exists we do not need do do anything
-  // TODO(arv): If we start to support require based on file name this has
-  //            to change
-  // TODO(arv): If we allow goog.foo.* this has to change
-  // TODO(arv): If we implement dynamic load after page load we should probably
-  //            not remove this code for the compiled output
+  // If the object already exists we do not need do do anything.
   if (!COMPILED) {
+    if (goog.ENABLE_DEBUG_LOADER && goog.IS_OLD_IE_) {
+      goog.maybeProcessDeferredDep_(name);
+    }
+
     if (goog.isProvided_(name)) {
-      return;
+      if (goog.isInModuleLoader_()) {
+        return goog.module.getInternal_(name);
+      } else {
+        return null;
+      }
     }
 
     if (goog.ENABLE_DEBUG_LOADER) {
       var path = goog.getPathFromDeps_(name);
       if (path) {
-        goog.included_[path] = true;
-        goog.writeScripts_();
-        return;
+        goog.writeScripts_(path);
+        return null;
       }
     }
 
     var errorMessage = 'goog.require could not find: ' + name;
-    if (goog.global.console) {
-      goog.global.console['error'](errorMessage);
-    }
-
-
-      throw Error(errorMessage);
+    goog.logToConsole_(errorMessage);
 
+    throw Error(errorMessage);
   }
 };
 
 
 /**
- * Path for included scripts
+ * Path for included scripts.
  * @type {string}
  */
 goog.basePath = '';
@@ -416,8 +688,7 @@ goog.global.CLOSURE_BASE_PATH;
 
 
 /**
- * Whether to write out Closure's deps file. By default,
- * the deps are written.
+ * Whether to write out Closure's deps file. By default, the deps are written.
  * @type {boolean|undefined}
  */
 goog.global.CLOSURE_NO_DEPS;
@@ -431,6 +702,7 @@ goog.global.CLOSURE_NO_DEPS;
  *
  * The function is passed the script source, which is a relative URI. It should
  * return true if the script was imported, false otherwise.
+ * @type {(function(string): boolean)|undefined}
  */
 goog.global.CLOSURE_IMPORT_SCRIPT;
 
@@ -442,35 +714,18 @@ goog.global.CLOSURE_IMPORT_SCRIPT;
 goog.nullFunction = function() {};
 
 
-/**
- * The identity function. Returns its first argument.
- *
- * @param {*=} opt_returnValue The single value that will be returned.
- * @param {...*} var_args Optional trailing arguments. These are ignored.
- * @return {?} The first argument. We can't know the type -- just pass it along
- *      without type.
- * @deprecated Use goog.functions.identity instead.
- */
-goog.identityFunction = function(opt_returnValue, var_args) {
-  return opt_returnValue;
-};
-
-
 /**
  * When defining a class Foo with an abstract method bar(), you can do:
- *
  * Foo.prototype.bar = goog.abstractMethod
  *
- * Now if a subclass of Foo fails to override bar(), an error
- * will be thrown when bar() is invoked.
+ * Now if a subclass of Foo fails to override bar(), an error will be thrown
+ * when bar() is invoked.
  *
- * Note: This does not take the name of the function to override as
- * an argument because that would make it more difficult to obfuscate
- * our JavaScript code.
+ * Note: This does not take the name of the function to override as an argument
+ * because that would make it more difficult to obfuscate our JavaScript code.
  *
  * @type {!Function}
- * @throws {Error} when invoked to indicate the method should be
- *   overridden.
+ * @throws {Error} when invoked to indicate the method should be overridden.
  */
 goog.abstractMethod = function() {
   throw Error('unimplemented abstract method');
@@ -478,8 +733,8 @@ goog.abstractMethod = function() {
 
 
 /**
- * Adds a {@code getInstance} static method that always return the same instance
- * object.
+ * Adds a {@code getInstance} static method that always returns the same
+ * instance object.
  * @param {!Function} ctor The constructor for the class to add the static
  *     method to.
  */
@@ -501,12 +756,37 @@ goog.addSingletonGetter = function(ctor) {
  * All singleton classes that have been instantiated, for testing. Don't read
  * it directly, use the {@code goog.testing.singleton} module. The compiler
  * removes this variable if unused.
- * @type {!Array.<!Function>}
+ * @type {!Array<!Function>}
  * @private
  */
 goog.instantiatedSingletons_ = [];
 
 
+/**
+ * @define {boolean} Whether to load goog.modules using {@code eval} when using
+ * the debug loader.  This provides a better debugging experience as the
+ * source is unmodified and can be edited using Chrome Workspaces or similar.
+ * However in some environments the use of {@code eval} is banned
+ * so we provide an alternative.
+ */
+goog.define('goog.LOAD_MODULE_USING_EVAL', true);
+
+
+/**
+ * @define {boolean} Whether the exports of goog.modules should be sealed when
+ * possible.
+ */
+goog.define('goog.SEAL_MODULE_EXPORTS', goog.DEBUG);
+
+
+/**
+ * The registry of initialized modules:
+ * the module identifier to module exports map.
+ * @private @const {!Object<string, ?>}
+ */
+goog.loadedModules_ = {};
+
+
 /**
  * True if goog.dependencies_ is available.
  * @const {boolean}
@@ -515,29 +795,33 @@ goog.DEPENDENCIES_ENABLED = !COMPILED && goog.ENABLE_DEBUG_LOADER;
 
 
 if (goog.DEPENDENCIES_ENABLED) {
-  /**
-   * Object used to keep track of urls that have already been added. This
-   * record allows the prevention of circular dependencies.
-   * @type {Object}
-   * @private
-   */
-  goog.included_ = {};
-
 
   /**
    * This object is used to keep track of dependencies and other data that is
-   * used for loading scripts
+   * used for loading scripts.
    * @private
-   * @type {Object}
+   * @type {{
+   *   pathIsModule: !Object<string, boolean>,
+   *   nameToPath: !Object<string, string>,
+   *   requires: !Object<string, !Object<string, boolean>>,
+   *   visited: !Object<string, boolean>,
+   *   written: !Object<string, boolean>,
+   *   deferred: !Object<string, string>
+   * }}
    */
   goog.dependencies_ = {
-    pathToNames: {}, // 1 to many
+    pathIsModule: {}, // 1 to 1
+
     nameToPath: {}, // 1 to 1
+
     requires: {}, // 1 to many
-    // used when resolving dependencies to prevent us from
-    // visiting the file twice
+
+    // Used when resolving dependencies to prevent us from visiting file twice.
     visited: {},
-    written: {} // used to keep track of script files we have written
+
+    written: {}, // Used to keep track of script files we have written.
+
+    deferred: {} // Used to track deferred module evaluations in old IEs
   };
 
 
@@ -547,29 +831,31 @@ if (goog.DEPENDENCIES_ENABLED) {
    * @private
    */
   goog.inHtmlDocument_ = function() {
+    /** @type {Document} */
     var doc = goog.global.document;
-    return typeof doc != 'undefined' &&
-           'write' in doc;  // XULDocument misses write.
+    return doc != null && 'write' in doc;  // XULDocument misses write.
   };
 
 
   /**
-   * Tries to detect the base path of the base.js script that bootstraps Closure
+   * Tries to detect the base path of base.js script that bootstraps Closure.
    * @private
    */
   goog.findBasePath_ = function() {
-    if (goog.global.CLOSURE_BASE_PATH) {
+    if (goog.isDef(goog.global.CLOSURE_BASE_PATH)) {
       goog.basePath = goog.global.CLOSURE_BASE_PATH;
       return;
     } else if (!goog.inHtmlDocument_()) {
       return;
     }
+    /** @type {Document} */
     var doc = goog.global.document;
-    var scripts = doc.getElementsByTagName('script');
+    var scripts = doc.getElementsByTagName('SCRIPT');
     // Search backwards since the current script is in almost all cases the one
     // that has base.js.
     for (var i = scripts.length - 1; i >= 0; --i) {
-      var src = scripts[i].src;
+      var script = /** @type {!HTMLScriptElement} */ (scripts[i]);
+      var src = script.src;
       var qmark = src.lastIndexOf('?');
       var l = qmark == -1 ? src.length : qmark;
       if (src.substr(l - 7, 7) == 'base.js') {
@@ -584,33 +870,327 @@ if (goog.DEPENDENCIES_ENABLED) {
    * Imports a script if, and only if, that script hasn't already been imported.
    * (Must be called at execution time)
    * @param {string} src Script source.
+   * @param {string=} opt_sourceText The optionally source text to evaluate
    * @private
    */
-  goog.importScript_ = function(src) {
+  goog.importScript_ = function(src, opt_sourceText) {
     var importScript = goog.global.CLOSURE_IMPORT_SCRIPT ||
         goog.writeScriptTag_;
-    if (!goog.dependencies_.written[src] && importScript(src)) {
+    if (importScript(src, opt_sourceText)) {
+      goog.dependencies_.written[src] = true;
+    }
+  };
+
+
+  /** @const @private {boolean} */
+  goog.IS_OLD_IE_ = !!(!goog.global.atob && goog.global.document &&
+      goog.global.document.all);
+
+
+  /**
+   * Given a URL initiate retrieval and execution of the module.
+   * @param {string} src Script source URL.
+   * @private
+   */
+  goog.importModule_ = function(src) {
+    // In an attempt to keep browsers from timing out loading scripts using
+    // synchronous XHRs, put each load in its own script block.
+    var bootstrap = 'goog.retrieveAndExecModule_("' + src + '");';
+
+    if (goog.importScript_('', bootstrap)) {
       goog.dependencies_.written[src] = true;
     }
   };
 
 
+  /** @private {!Array<string>} */
+  goog.queuedModules_ = [];
+
+
+  /**
+   * Return an appropriate module text. Suitable to insert into
+   * a script tag (that is unescaped).
+   * @param {string} srcUrl
+   * @param {string} scriptText
+   * @return {string}
+   * @private
+   */
+  goog.wrapModule_ = function(srcUrl, scriptText) {
+    if (!goog.LOAD_MODULE_USING_EVAL || !goog.isDef(goog.global.JSON)) {
+      return '' +
+          'goog.loadModule(function(exports) {' +
+          '"use strict";' +
+          scriptText +
+          '\n' + // terminate any trailing single line comment.
+          ';return exports' +
+          '});' +
+          '\n//# sourceURL=' + srcUrl + '\n';
+    } else {
+      return '' +
+          'goog.loadModule(' +
+          goog.global.JSON.stringify(
+              scriptText + '\n//# sourceURL=' + srcUrl + '\n') +
+          ');';
+    }
+  };
+
+  // On IE9 and earlier, it is necessary to handle
+  // deferred module loads. In later browsers, the
+  // code to be evaluated is simply inserted as a script
+  // block in the correct order. To eval deferred
+  // code at the right time, we piggy back on goog.require to call
+  // goog.maybeProcessDeferredDep_.
+  //
+  // The goog.requires are used both to bootstrap
+  // the loading process (when no deps are available) and
+  // declare that they should be available.
+  //
+  // Here we eval the sources, if all the deps are available
+  // either already eval'd or goog.require'd.  This will
+  // be the case when all the dependencies have already
+  // been loaded, and the dependent module is loaded.
+  //
+  // But this alone isn't sufficient because it is also
+  // necessary to handle the case where there is no root
+  // that is not deferred.  For that there we register for an event
+  // and trigger goog.loadQueuedModules_ handle any remaining deferred
+  // evaluations.
+
+  /**
+   * Handle any remaining deferred goog.module evals.
+   * @private
+   */
+  goog.loadQueuedModules_ = function() {
+    var count = goog.queuedModules_.length;
+    if (count > 0) {
+      var queue = goog.queuedModules_;
+      goog.queuedModules_ = [];
+      for (var i = 0; i < count; i++) {
+        var path = queue[i];
+        goog.maybeProcessDeferredPath_(path);
+      }
+    }
+  };
+
+
+  /**
+   * Eval the named module if its dependencies are
+   * available.
+   * @param {string} name The module to load.
+   * @private
+   */
+  goog.maybeProcessDeferredDep_ = function(name) {
+    if (goog.isDeferredModule_(name) &&
+        goog.allDepsAreAvailable_(name)) {
+      var path = goog.getPathFromDeps_(name);
+      goog.maybeProcessDeferredPath_(goog.basePath + path);
+    }
+  };
+
+  /**
+   * @param {string} name The module to check.
+   * @return {boolean} Whether the name represents a
+   *     module whose evaluation has been deferred.
+   * @private
+   */
+  goog.isDeferredModule_ = function(name) {
+    var path = goog.getPathFromDeps_(name);
+    if (path && goog.dependencies_.pathIsModule[path]) {
+      var abspath = goog.basePath + path;
+      return (abspath) in goog.dependencies_.deferred;
+    }
+    return false;
+  };
+
+  /**
+   * @param {string} name The module to check.
+   * @return {boolean} Whether the name represents a
+   *     module whose declared dependencies have all been loaded
+   *     (eval'd or a deferred module load)
+   * @private
+   */
+  goog.allDepsAreAvailable_ = function(name) {
+    var path = goog.getPathFromDeps_(name);
+    if (path && (path in goog.dependencies_.requires)) {
+      for (var requireName in goog.dependencies_.requires[path]) {
+        if (!goog.isProvided_(requireName) &&
+            !goog.isDeferredModule_(requireName)) {
+          return false;
+        }
+      }
+    }
+    return true;
+  };
+
+
+  /**
+   * @param {string} abspath
+   * @private
+   */
+  goog.maybeProcessDeferredPath_ = function(abspath) {
+    if (abspath in goog.dependencies_.deferred) {
+      var src = goog.dependencies_.deferred[abspath];
+      delete goog.dependencies_.deferred[abspath];
+      goog.globalEval(src);
+    }
+  };
+
+
+  /**
+   * Load a goog.module from the provided URL.  This is not a general purpose
+   * code loader and does not support late loading code, that is it should only
+   * be used during page load. This method exists to support unit tests and
+   * "debug" loaders that would otherwise have inserted script tags. Under the
+   * hood this needs to use a synchronous XHR and is not recommeneded for
+   * production code.
+   *
+   * The module's goog.requires must have already been satisified; an exception
+   * will be thrown if this is not the case. This assumption is that no
+   * "deps.js" file exists, so there is no way to discover and locate the
+   * module-to-be-loaded's dependencies and no attempt is made to do so.
+   *
+   * There should only be one attempt to load a module.  If
+   * "goog.loadModuleFromUrl" is called for an already loaded module, an
+   * exception will be throw.
+   *
+   * @param {string} url The URL from which to attempt to load the goog.module.
+   */
+  goog.loadModuleFromUrl = function(url) {
+    // Because this executes synchronously, we don't need to do any additional
+    // bookkeeping. When "goog.loadModule" the namespace will be marked as
+    // having been provided which is sufficient.
+    goog.retrieveAndExecModule_(url);
+  };
+
+
+  /**
+   * @param {function(?):?|string} moduleDef The module definition.
+   */
+  goog.loadModule = function(moduleDef) {
+    // NOTE: we allow function definitions to be either in the from
+    // of a string to eval (which keeps the original source intact) or
+    // in a eval forbidden environment (CSP) we allow a function definition
+    // which in its body must call {@code goog.module}, and return the exports
+    // of the module.
+    var previousState = goog.moduleLoaderState_;
+    try {
+      goog.moduleLoaderState_ = {
+        moduleName: undefined,
+        declareLegacyNamespace: false
+      };
+      var exports;
+      if (goog.isFunction(moduleDef)) {
+        exports = moduleDef.call(goog.global, {});
+      } else if (goog.isString(moduleDef)) {
+        exports = goog.loadModuleFromSource_.call(goog.global, moduleDef);
+      } else {
+        throw Error('Invalid module definition');
+      }
+
+      var moduleName = goog.moduleLoaderState_.moduleName;
+      if (!goog.isString(moduleName) || !moduleName) {
+        throw Error('Invalid module name \"' + moduleName + '\"');
+      }
+
+      // Don't seal legacy namespaces as they may be uses as a parent of
+      // another namespace
+      if (goog.moduleLoaderState_.declareLegacyNamespace) {
+        goog.constructNamespace_(moduleName, exports);
+      } else if (goog.SEAL_MODULE_EXPORTS && Object.seal) {
+        Object.seal(exports);
+      }
+
+      goog.loadedModules_[moduleName] = exports;
+    } finally {
+      goog.moduleLoaderState_ = previousState;
+    }
+  };
+
+
+  /**
+   * @private @const {function(string):?}
+   *
+   * The new type inference warns because this function has no formal
+   * parameters, but its jsdoc says that it takes one argument.
+   * (The argument is used via arguments[0], but NTI does not detect this.)
+   * @suppress {newCheckTypes}
+   */
+  goog.loadModuleFromSource_ = function() {
+    // NOTE: we avoid declaring parameters or local variables here to avoid
+    // masking globals or leaking values into the module definition.
+    'use strict';
+    var exports = {};
+    eval(arguments[0]);
+    return exports;
+  };
+
+
+  /**
+   * Writes a new script pointing to {@code src} directly into the DOM.
+   *
+   * NOTE: This method is not CSP-compliant. @see goog.appendScriptSrcNode_ for
+   * the fallback mechanism.
+   *
+   * @param {string} src The script URL.
+   * @private
+   */
+  goog.writeScriptSrcNode_ = function(src) {
+    goog.global.document.write(
+        '<script type="text/javascript" src="' + src + '"></' + 'script>');
+  };
+
+
+  /**
+   * Appends a new script node to the DOM using a CSP-compliant mechanism. This
+   * method exists as a fallback for document.write (which is not allowed in a
+   * strict CSP context, e.g., Chrome apps).
+   *
+   * NOTE: This method is not analogous to using document.write to insert a
+   * <script> tag; specifically, the user agent will execute a script added by
+   * document.write immediately after the current script block finishes
+   * executing, whereas the DOM-appended script node will not be executed until
+   * the entire document is parsed and executed. That is to say, this script is
+   * added to the end of the script execution queue.
+   *
+   * The page must not attempt to call goog.required entities until after the
+   * document has loaded, e.g., in or after the window.onload callback.
+   *
+   * @param {string} src The script URL.
+   * @private
+   */
+  goog.appendScriptSrcNode_ = function(src) {
+    /** @type {Document} */
+    var doc = goog.global.document;
+    var scriptEl = /** @type {HTMLScriptElement} */ (
+        doc.createElement('script'));
+    scriptEl.type = 'text/javascript';
+    scriptEl.src = src;
+    scriptEl.defer = false;
+    scriptEl.async = false;
+    doc.head.appendChild(scriptEl);
+  };
+
+
   /**
    * The default implementation of the import function. Writes a script tag to
    * import the script.
    *
-   * @param {string} src The script source.
+   * @param {string} src The script url.
+   * @param {string=} opt_sourceText The optionally source text to evaluate
    * @return {boolean} True if the script was imported, false otherwise.
    * @private
    */
-  goog.writeScriptTag_ = function(src) {
+  goog.writeScriptTag_ = function(src, opt_sourceText) {
     if (goog.inHtmlDocument_()) {
+      /** @type {Document} */
       var doc = goog.global.document;
 
       // If the user tries to require a new symbol after document load,
       // something has gone terribly wrong. Doing a document.write would
-      // wipe out the page.
-      if (doc.readyState == 'complete') {
+      // wipe out the page. This does not apply to the CSP-compliant method
+      // of writing script tags.
+      if (!goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING &&
+          doc.readyState == 'complete') {
         // Certain test frameworks load base.js multiple times, which tries
         // to write deps.js each time. If that happens, just fail silently.
         // These frameworks wipe the page between each load of base.js, so this
@@ -623,8 +1203,28 @@ if (goog.DEPENDENCIES_ENABLED) {
         }
       }
 
-      doc.write(
-          '<script type="text/javascript" src="' + src + '"></' + 'script>');
+      var isOldIE = goog.IS_OLD_IE_;
+
+      if (opt_sourceText === undefined) {
+        if (!isOldIE) {
+          if (goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING) {
+            goog.appendScriptSrcNode_(src);
+          } else {
+            goog.writeScriptSrcNode_(src);
+          }
+        } else {
+          var state = " onreadystatechange='goog.onScriptLoad_(this, " +
+              ++goog.lastNonModuleScriptIndex_ + ")' ";
+          doc.write(
+              '<script type="text/javascript" src="' +
+                  src + '"' + state + '></' + 'script>');
+        }
+      } else {
+        doc.write(
+            '<script type="text/javascript">' +
+            opt_sourceText +
+            '</' + 'script>');
+      }
       return true;
     } else {
       return false;
@@ -632,29 +1232,49 @@ if (goog.DEPENDENCIES_ENABLED) {
   };
 
 
+  /** @private {number} */
+  goog.lastNonModuleScriptIndex_ = 0;
+
+
+  /**
+   * A readystatechange handler for legacy IE
+   * @param {!HTMLScriptElement} script
+   * @param {number} scriptIndex
+   * @return {boolean}
+   * @private
+   */
+  goog.onScriptLoad_ = function(script, scriptIndex) {
+    // for now load the modules when we reach the last script,
+    // later allow more inter-mingling.
+    if (script.readyState == 'complete' &&
+        goog.lastNonModuleScriptIndex_ == scriptIndex) {
+      goog.loadQueuedModules_();
+    }
+    return true;
+  };
+
   /**
    * Resolves dependencies based on the dependencies added using addDependency
    * and calls importScript_ in the correct order.
+   * @param {string} pathToLoad The path from which to start discovering
+   *     dependencies.
    * @private
    */
-  goog.writeScripts_ = function() {
-    // the scripts we need to write this time
+  goog.writeScripts_ = function(pathToLoad) {
+    /** @type {!Array<string>} The scripts we need to write this time. */
     var scripts = [];
     var seenScript = {};
     var deps = goog.dependencies_;
 
+    /** @param {string} path */
     function visitNode(path) {
       if (path in deps.written) {
         return;
       }
 
-      // we have already visited this one. We can get here if we have cyclic
-      // dependencies
+      // We have already visited this one. We can get here if we have cyclic
+      // dependencies.
       if (path in deps.visited) {
-        if (!(path in seenScript)) {
-          seenScript[path] = true;
-          scripts.push(path);
-        }
         return;
       }
 
@@ -680,19 +1300,36 @@ if (goog.DEPENDENCIES_ENABLED) {
       }
     }
 
-    for (var path in goog.included_) {
-      if (!deps.written[path]) {
-        visitNode(path);
-      }
+    visitNode(pathToLoad);
+
+    // record that we are going to load all these scripts.
+    for (var i = 0; i < scripts.length; i++) {
+      var path = scripts[i];
+      goog.dependencies_.written[path] = true;
     }
 
+    // If a module is loaded synchronously then we need to
+    // clear the current inModuleLoader value, and restore it when we are
+    // done loading the current "requires".
+    var moduleState = goog.moduleLoaderState_;
+    goog.moduleLoaderState_ = null;
+
     for (var i = 0; i < scripts.length; i++) {
-      if (scripts[i]) {
-        goog.importScript_(goog.basePath + scripts[i]);
+      var path = scripts[i];
+      if (path) {
+        if (!deps.pathIsModule[path]) {
+          goog.importScript_(goog.basePath + path);
+        } else {
+          goog.importModule_(goog.basePath + path);
+        }
       } else {
+        goog.moduleLoaderState_ = moduleState;
         throw Error('Undefined script input');
       }
     }
+
+    // restore the current "module loading state"
+    goog.moduleLoaderState_ = moduleState;
   };
 
 
@@ -720,6 +1357,82 @@ if (goog.DEPENDENCIES_ENABLED) {
 }
 
 
+/**
+ * Normalize a file path by removing redundant ".." and extraneous "." file
+ * path components.
+ * @param {string} path
+ * @return {string}
+ * @private
+ */
+goog.normalizePath_ = function(path) {
+  var components = path.split('/');
+  var i = 0;
+  while (i < components.length) {
+    if (components[i] == '.') {
+      components.splice(i, 1);
+    } else if (i && components[i] == '..' &&
+        components[i - 1] && components[i - 1] != '..') {
+      components.splice(--i, 2);
+    } else {
+      i++;
+    }
+  }
+  return components.join('/');
+};
+
+
+/**
+ * Loads file by synchronous XHR. Should not be used in production environments.
+ * @param {string} src Source URL.
+ * @return {string} File contents.
+ * @private
+ */
+goog.loadFileSync_ = function(src) {
+  if (goog.global.CLOSURE_LOAD_FILE_SYNC) {
+    return goog.global.CLOSURE_LOAD_FILE_SYNC(src);
+  } else {
+    /** @type {XMLHttpRequest} */
+    var xhr = new goog.global['XMLHttpRequest']();
+    xhr.open('get', src, false);
+    xhr.send();
+    return xhr.responseText;
+  }
+};
+
+
+/**
+ * Retrieve and execute a module.
+ * @param {string} src Script source URL.
+ * @private
+ */
+goog.retrieveAndExecModule_ = function(src) {
+  if (!COMPILED) {
+    // The full but non-canonicalized URL for later use.
+    var originalPath = src;
+    // Canonicalize the path, removing any /./ or /../ since Chrome's debugging
+    // console doesn't auto-canonicalize XHR loads as it does <script> srcs.
+    src = goog.normalizePath_(src);
+
+    var importScript = goog.global.CLOSURE_IMPORT_SCRIPT ||
+        goog.writeScriptTag_;
+
+    var scriptText = goog.loadFileSync_(src);
+
+    if (scriptText != null) {
+      var execModuleScript = goog.wrapModule_(src, scriptText);
+      var isOldIE = goog.IS_OLD_IE_;
+      if (isOldIE) {
+        goog.dependencies_.deferred[originalPath] = execModuleScript;
+        goog.queuedModules_.push(originalPath);
+      } else {
+        importScript(src, execModuleScript);
+      }
+    } else {
+      throw new Error('load of ' + src + 'failed');
+    }
+  }
+};
+
 
 //==============================================================================
 // Language Enhancements
@@ -729,7 +1442,7 @@ if (goog.DEPENDENCIES_ENABLED) {
 /**
  * This is a "fixed" version of the typeof operator.  It differs from the typeof
  * operator in such a way that null returns 'null' and arrays return 'array'.
- * @param {*} value The value to get the type of.
+ * @param {?} value The value to get the type of.
  * @return {string} The name of the type.
  */
 goog.typeOf = function(value) {
@@ -751,7 +1464,7 @@ goog.typeOf = function(value) {
       //   value, the compiler requires the value be cast to type Object,
       //   even though the ECMA spec explicitly allows it.
       var className = Object.prototype.toString.call(
-          /** @type {Object} */ (value));
+          /** @type {!Object} */ (value));
       // In Firefox 3.6, attempting to access iframe window objects' length
       // property throws an NS_ERROR_FAILURE, so we need to special-case it
       // here.
@@ -780,7 +1493,7 @@ goog.typeOf = function(value) {
       if ((className == '[object Array]' ||
            // In IE all non value types are wrapped as objects across window
            // boundaries (not iframe though) so we have to do object detection
-           // for this edge case
+           // for this edge case.
            typeof value.length == 'number' &&
            typeof value.splice != 'undefined' &&
            typeof value.propertyIsEnumerable != 'undefined' &&
@@ -810,17 +1523,15 @@ goog.typeOf = function(value) {
         return 'function';
       }
 
-
     } else {
       return 'null';
     }
 
   } else if (s == 'function' && typeof value.call == 'undefined') {
-    // In Safari typeof nodeList returns 'function', and on Firefox
-    // typeof behaves similarly for HTML{Applet,Embed,Object}Elements
-    // and RegExps.  We would like to return object for those and we can
-    // detect an invalid function by making sure that the function
-    // object has a call method.
+    // In Safari typeof nodeList returns 'function', and on Firefox typeof
+    // behaves similarly for HTML{Applet,Embed,Object}, Elements and RegExps. We
+    // would like to return object for those and we can detect an invalid
+    // function by making sure that the function object has a call method.
     return 'object';
   }
   return s;
@@ -828,21 +1539,8 @@ goog.typeOf = function(value) {
 
 
 /**
- * Returns true if the specified value is not |undefined|.
- * WARNING: Do not use this to test if an object has a property. Use the in
- * operator instead.  Additionally, this function assumes that the global
- * undefined variable has not been redefined.
- * @param {*} val Variable to test.
- * @return {boolean} Whether variable is defined.
- */
-goog.isDef = function(val) {
-  return val !== undefined;
-};
-
-
-/**
- * Returns true if the specified value is |null|
- * @param {*} val Variable to test.
+ * Returns true if the specified value is null.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is null.
  */
 goog.isNull = function(val) {
@@ -851,8 +1549,8 @@ goog.isNull = function(val) {
 
 
 /**
- * Returns true if the specified value is defined and not null
- * @param {*} val Variable to test.
+ * Returns true if the specified value is defined and not null.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is defined and not null.
  */
 goog.isDefAndNotNull = function(val) {
@@ -862,8 +1560,8 @@ goog.isDefAndNotNull = function(val) {
 
 
 /**
- * Returns true if the specified value is an array
- * @param {*} val Variable to test.
+ * Returns true if the specified value is an array.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is an array.
  */
 goog.isArray = function(val) {
@@ -874,20 +1572,22 @@ goog.isArray = function(val) {
 /**
  * Returns true if the object looks like an array. To qualify as array like
  * the value needs to be either a NodeList or an object with a Number length
- * property.
- * @param {*} val Variable to test.
+ * property. As a special case, a function value is not array like, because its
+ * length property is fixed to correspond to the number of expected arguments.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is an array.
  */
 goog.isArrayLike = function(val) {
   var type = goog.typeOf(val);
+  // We do not use goog.isObject here in order to exclude function values.
   return type == 'array' || type == 'object' && typeof val.length == 'number';
 };
 
 
 /**
- * Returns true if the object looks like a Date. To qualify as Date-like
- * the value needs to be an object and have a getFullYear() function.
- * @param {*} val Variable to test.
+ * Returns true if the object looks like a Date. To qualify as Date-like the
+ * value needs to be an object and have a getFullYear() function.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is a like a Date.
  */
 goog.isDateLike = function(val) {
@@ -896,8 +1596,8 @@ goog.isDateLike = function(val) {
 
 
 /**
- * Returns true if the specified value is a string
- * @param {*} val Variable to test.
+ * Returns true if the specified value is a string.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is a string.
  */
 goog.isString = function(val) {
@@ -906,8 +1606,8 @@ goog.isString = function(val) {
 
 
 /**
- * Returns true if the specified value is a boolean
- * @param {*} val Variable to test.
+ * Returns true if the specified value is a boolean.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is boolean.
  */
 goog.isBoolean = function(val) {
@@ -916,8 +1616,8 @@ goog.isBoolean = function(val) {
 
 
 /**
- * Returns true if the specified value is a number
- * @param {*} val Variable to test.
+ * Returns true if the specified value is a number.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is a number.
  */
 goog.isNumber = function(val) {
@@ -926,8 +1626,8 @@ goog.isNumber = function(val) {
 
 
 /**
- * Returns true if the specified value is a function
- * @param {*} val Variable to test.
+ * Returns true if the specified value is a function.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is a function.
  */
 goog.isFunction = function(val) {
@@ -936,9 +1636,9 @@ goog.isFunction = function(val) {
 
 
 /**
- * Returns true if the specified value is an object.  This includes arrays
- * and functions.
- * @param {*} val Variable to test.
+ * Returns true if the specified value is an object.  This includes arrays and
+ * functions.
+ * @param {?} val Variable to test.
  * @return {boolean} Whether variable is an object.
  */
 goog.isObject = function(val) {
@@ -950,12 +1650,12 @@ goog.isObject = function(val) {
 
 
 /**
- * Gets a unique ID for an object. This mutates the object so that further
- * calls with the same object as a parameter returns the same value. The unique
- * ID is guaranteed to be unique across the current session amongst objects that
- * are passed into {@code getUid}. There is no guarantee that the ID is unique
- * or consistent across sessions. It is unsafe to generate unique ID for
- * function prototypes.
+ * Gets a unique ID for an object. This mutates the object so that further calls
+ * with the same object as a parameter returns the same value. The unique ID is
+ * guaranteed to be unique across the current session amongst objects that are
+ * passed into {@code getUid}. There is no guarantee that the ID is unique or
+ * consistent across sessions. It is unsafe to generate unique ID for function
+ * prototypes.
  *
  * @param {Object} obj The object to get the unique ID for.
  * @return {number} The unique ID for the object.
@@ -971,6 +1671,19 @@ goog.getUid = function(obj) {
 };
 
 
+/**
+ * Whether the given object is already assigned a unique ID.
+ *
+ * This does not modify the object.
+ *
+ * @param {!Object} obj The object to check.
+ * @return {boolean} Whether there is an assigned unique id for the object.
+ */
+goog.hasUid = function(obj) {
+  return !!obj[goog.UID_PROPERTY_];
+};
+
+
 /**
  * Removes the unique ID from an object. This is useful if the object was
  * previously mutated using {@code goog.getUid} in which case the mutation is
@@ -980,9 +1693,9 @@ goog.getUid = function(obj) {
 goog.removeUid = function(obj) {
   // TODO(arv): Make the type stricter, do not accept null.
 
-  // DOM nodes in IE are not instance of Object and throws exception
-  // for delete. Instead we try to use removeAttribute
-  if ('removeAttribute' in obj) {
+  // In IE, DOM nodes are not instances of Object and throw an exception if we
+  // try to delete.  Instead we try to use removeAttribute.
+  if ('removeAttribute' in /** @type {!Object} */ (obj)) {
     obj.removeAttribute(goog.UID_PROPERTY_);
   }
   /** @preserveTry */
@@ -995,7 +1708,7 @@ goog.removeUid = function(obj) {
 
 /**
  * Name for unique ID property. Initialized in a way to help avoid collisions
- * with other closure javascript on the same page.
+ * with other closure JavaScript on the same page.
  * @type {string}
  * @private
  */
@@ -1063,15 +1776,15 @@ goog.cloneObject = function(obj) {
 /**
  * A native implementation of goog.bind.
  * @param {Function} fn A function to partially apply.
- * @param {Object|undefined} selfObj Specifies the object which |this| should
+ * @param {Object|undefined} selfObj Specifies the object which this should
  *     point to when the function is run.
- * @param {...*} var_args Additional arguments that are partially
- *     applied to the function.
+ * @param {...*} var_args Additional arguments that are partially applied to the
+ *     function.
  * @return {!Function} A partially-applied form of the function bind() was
  *     invoked as a method of.
  * @private
- * @suppress {deprecated} The compiler thinks that Function.prototype.bind
- *     is deprecated because some people have declared a pure-JS version.
+ * @suppress {deprecated} The compiler thinks that Function.prototype.bind is
+ *     deprecated because some people have declared a pure-JS version.
  *     Only the pure-JS version is truly deprecated.
  */
 goog.bindNative_ = function(fn, selfObj, var_args) {
@@ -1082,10 +1795,10 @@ goog.bindNative_ = function(fn, selfObj, var_args) {
 /**
  * A pure-JS implementation of goog.bind.
  * @param {Function} fn A function to partially apply.
- * @param {Object|undefined} selfObj Specifies the object which |this| should
+ * @param {Object|undefined} selfObj Specifies the object which this should
  *     point to when the function is run.
- * @param {...*} var_args Additional arguments that are partially
- *     applied to the function.
+ * @param {...*} var_args Additional arguments that are partially applied to the
+ *     function.
  * @return {!Function} A partially-applied form of the function bind() was
  *     invoked as a method of.
  * @private
@@ -1115,23 +1828,23 @@ goog.bindJs_ = function(fn, selfObj, var_args) {
 /**
  * Partially applies this function to a particular 'this object' and zero or
  * more arguments. The result is a new function with some arguments of the first
- * function pre-filled and the value of |this| 'pre-specified'.<br><br>
+ * function pre-filled and the value of this 'pre-specified'.
  *
- * Remaining arguments specified at call-time are appended to the pre-
- * specified ones.<br><br>
+ * Remaining arguments specified at call-time are appended to the pre-specified
+ * ones.
  *
- * Also see: {@link #partial}.<br><br>
+ * Also see: {@link #partial}.
  *
  * Usage:
- * <pre>var barMethBound = bind(myFunction, myObj, 'arg1', 'arg2');
+ * <pre>var barMethBound = goog.bind(myFunction, myObj, 'arg1', 'arg2');
  * barMethBound('arg3', 'arg4');</pre>
  *
  * @param {?function(this:T, ...)} fn A function to partially apply.
- * @param {T} selfObj Specifies the object which |this| should
- *     point to when the function is run.
- * @param {...*} var_args Additional arguments that are partially
- *     applied to the function.
- * @return {!Function} A partially-applied form of the function bind() was
+ * @param {T} selfObj Specifies the object which this should point to when the
+ *     function is run.
+ * @param {...*} var_args Additional arguments that are partially applied to the
+ *     function.
+ * @return {!Function} A partially-applied form of the function goog.bind() was
  *     invoked as a method of.
  * @template T
  * @suppress {deprecated} See above.
@@ -1139,13 +1852,12 @@ goog.bindJs_ = function(fn, selfObj, var_args) {
 goog.bind = function(fn, selfObj, var_args) {
   // TODO(nicksantos): narrow the type signature.
   if (Function.prototype.bind &&
-      // NOTE(nicksantos): Somebody pulled base.js into the default
-      // Chrome extension environment. This means that for Chrome extensions,
-      // they get the implementation of Function.prototype.bind that
-      // calls goog.bind instead of the native one. Even worse, we don't want
-      // to introduce a circular dependency between goog.bind and
-      // Function.prototype.bind, so we have to hack this to make sure it
-      // works correctly.
+      // NOTE(nicksantos): Somebody pulled base.js into the default Chrome
+      // extension environment. This means that for Chrome extensions, they get
+      // the implementation of Function.prototype.bind that calls goog.bind
+      // instead of the native one. Even worse, we don't want to introduce a
+      // circular dependency between goog.bind and Function.prototype.bind, so
+      // we have to hack this to make sure it works correctly.
       Function.prototype.bind.toString().indexOf('native code') != -1) {
     goog.bind = goog.bindNative_;
   } else {
@@ -1156,25 +1868,25 @@ goog.bind = function(fn, selfObj, var_args) {
 
 
 /**
- * Like bind(), except that a 'this object' is not required. Useful when the
- * target function is already bound.
+ * Like goog.bind(), except that a 'this object' is not required. Useful when
+ * the target function is already bound.
  *
  * Usage:
- * var g = partial(f, arg1, arg2);
+ * var g = goog.partial(f, arg1, arg2);
  * g(arg3, arg4);
  *
  * @param {Function} fn A function to partially apply.
- * @param {...*} var_args Additional arguments that are partially
- *     applied to fn.
- * @return {!Function} A partially-applied form of the function bind() was
- *     invoked as a method of.
+ * @param {...*} var_args Additional arguments that are partially applied to fn.
+ * @return {!Function} A partially-applied form of the function goog.partial()
+ *     was invoked as a method of.
  */
 goog.partial = function(fn, var_args) {
   var args = Array.prototype.slice.call(arguments, 1);
   return function() {
-    // Prepend the bound arguments to the current arguments.
-    var newArgs = Array.prototype.slice.call(arguments);
-    newArgs.unshift.apply(newArgs, args);
+    // Clone the array (with slice()) and append additional arguments
+    // to the existing arguments.
+    var newArgs = args.slice();
+    newArgs.push.apply(newArgs, arguments);
     return fn.apply(this, newArgs);
   };
 };
@@ -1212,7 +1924,7 @@ goog.now = (goog.TRUSTED_SITE && Date.now) || (function() {
 
 
 /**
- * Evals javascript in the global scope.  In IE this uses execScript, other
+ * Evals JavaScript in the global scope.  In IE this uses execScript, other
  * browsers use goog.global.eval. If goog.global.eval does not evaluate in the
  * global scope (for example, in Safari), appends a script tag instead.
  * Throws an exception if neither execScript or eval is defined.
@@ -1224,9 +1936,13 @@ goog.globalEval = function(script) {
   } else if (goog.global.eval) {
     // Test to see if eval works
     if (goog.evalWorksForGlobals_ == null) {
-      goog.global.eval('var _et_ = 1;');
-      if (typeof goog.global['_et_'] != 'undefined') {
-        delete goog.global['_et_'];
+      goog.global.eval('var _evalTest_ = 1;');
+      if (typeof goog.global['_evalTest_'] != 'undefined') {
+        try {
+          delete goog.global['_evalTest_'];
+        } catch (ignore) {
+          // Microsoft edge fails the deletion above in strict mode.
+        }
         goog.evalWorksForGlobals_ = true;
       } else {
         goog.evalWorksForGlobals_ = false;
@@ -1236,8 +1952,10 @@ goog.globalEval = function(script) {
     if (goog.evalWorksForGlobals_) {
       goog.global.eval(script);
     } else {
+      /** @type {Document} */
       var doc = goog.global.document;
-      var scriptElt = doc.createElement('script');
+      var scriptElt = /** @type {!HTMLScriptElement} */ (
+          doc.createElement('SCRIPT'));
       scriptElt.type = 'text/javascript';
       scriptElt.defer = false;
       // Note(user): can't use .innerHTML since "t('<test>')" will fail and
@@ -1265,8 +1983,7 @@ goog.evalWorksForGlobals_ = null;
 /**
  * Optional map of CSS class names to obfuscated names used with
  * goog.getCssName().
- * @type {Object|undefined}
- * @private
+ * @private {!Object<string, string>|undefined}
  * @see goog.setCssNameMapping
  */
 goog.cssNameMapping_;
@@ -1287,27 +2004,26 @@ goog.cssNameMappingStyle_;
  *
  * This function works in tandem with @see goog.setCssNameMapping.
  *
- * Without any mapping set, the arguments are simple joined with a
- * hyphen and passed through unaltered.
+ * Without any mapping set, the arguments are simple joined with a hyphen and
+ * passed through unaltered.
  *
- * When there is a mapping, there are two possible styles in which
- * these mappings are used. In the BY_PART style, each part (i.e. in
- * between hyphens) of the passed in css name is rewritten according
- * to the map. In the BY_WHOLE style, the full css name is looked up in
- * the map directly. If a rewrite is not specified by the map, the
- * compiler will output a warning.
+ * When there is a mapping, there are two possible styles in which these
+ * mappings are used. In the BY_PART style, each part (i.e. in between hyphens)
+ * of the passed in css name is rewritten according to the map. In the BY_WHOLE
+ * style, the full css name is looked up in the map directly. If a rewrite is
+ * not specified by the map, the compiler will output a warning.
  *
- * When the mapping is passed to the compiler, it will replace calls
- * to goog.getCssName with the strings from the mapping, e.g.
+ * When the mapping is passed to the compiler, it will replace calls to
+ * goog.getCssName with the strings from the mapping, e.g.
  *     var x = goog.getCssName('foo');
  *     var y = goog.getCssName(this.baseClass, 'active');
  *  becomes:
- *     var x= 'foo';
+ *     var x = 'foo';
  *     var y = this.baseClass + '-active';
  *
- * If one argument is passed it will be processed, if two are passed
- * only the modifier will be processed, as it is assumed the first
- * argument was generated as a result of calling goog.getCssName.
+ * If one argument is passed it will be processed, if two are passed only the
+ * modifier will be processed, as it is assumed the first argument was generated
+ * as a result of calling goog.getCssName.
  *
  * @param {string} className The class name.
  * @param {string=} opt_modifier A modifier to be appended to the class name.
@@ -1361,7 +2077,7 @@ goog.getCssName = function(className, opt_modifier) {
  * </pre>
  * When declared as a map of string literals to string literals, the JSCompiler
  * will replace all calls to goog.getCssName() using the supplied map if the
- * --closure_pass flag is set.
+ * --process_closure_primitives flag is set.
  *
  * @param {!Object} mapping A map of strings to strings where keys are possible
  *     arguments to goog.getCssName() and values are the corresponding values
@@ -1386,7 +2102,7 @@ goog.setCssNameMapping = function(mapping, opt_style) {
  * are made in uncompiled mode.
  *
  * A hook for overriding the CSS name mapping.
- * @type {Object|undefined}
+ * @type {!Object<string, string>|undefined}
  */
 goog.global.CLOSURE_CSS_NAME_MAPPING;
 
@@ -1411,14 +2127,15 @@ if (!COMPILED && goog.global.CLOSURE_CSS_NAME_MAPPING) {
  * </code>
  *
  * @param {string} str Translatable string, places holders in the form {$foo}.
- * @param {Object=} opt_values Map of place holder name to value.
+ * @param {Object<string, string>=} opt_values Maps place holder name to value.
  * @return {string} message with placeholders filled.
  */
 goog.getMsg = function(str, opt_values) {
-  var values = opt_values || {};
-  for (var key in values) {
-    var value = ('' + values[key]).replace(/\$/g, '$$$$');
-    str = str.replace(new RegExp('\\{\\$' + key + '\\}', 'gi'), value);
+  if (opt_values) {
+    str = str.replace(/\{\$([^}]+)}/g, function(match, key) {
+      return (opt_values != null && key in opt_values) ?
+          opt_values[key] : match;
+    });
   }
   return str;
 };
@@ -1431,7 +2148,7 @@ goog.getMsg = function(str, opt_values) {
  * This is useful when introducing a new message that has not yet been
  * translated into all languages.
  *
- * This function is a compiler primtive. Must be used in the form:
+ * This function is a compiler primitive. Must be used in the form:
  * <code>var x = goog.getMsgWithFallback(MSG_A, MSG_B);</code>
  * where MSG_A and MSG_B were initialized with goog.getMsg.
  *
@@ -1446,17 +2163,14 @@ goog.getMsgWithFallback = function(a, b) {
 
 /**
  * Exposes an unobfuscated global namespace path for the given object.
- * Note that fields of the exported object *will* be obfuscated,
- * unless they are exported in turn via this function or
- * goog.exportProperty
+ * Note that fields of the exported object *will* be obfuscated, unless they are
+ * exported in turn via this function or goog.exportProperty.
  *
- * <p>Also handy for making public items that are defined in anonymous
- * closures.
+ * Also handy for making public items that are defined in anonymous closures.
  *
  * ex. goog.exportSymbol('public.path.Foo', Foo);
  *
- * ex. goog.exportSymbol('public.path.Foo.staticFunction',
- *                       Foo.staticFunction);
+ * ex. goog.exportSymbol('public.path.Foo.staticFunction', Foo.staticFunction);
  *     public.path.Foo.staticFunction();
  *
  * ex. goog.exportSymbol('public.path.Foo.prototype.myMethod',
@@ -1466,7 +2180,7 @@ goog.getMsgWithFallback = function(a, b) {
  * @param {string} publicPath Unobfuscated name to export.
  * @param {*} object Object the name should point to.
  * @param {Object=} opt_objectToExportTo The object to add the path to; default
- *     is |goog.global|.
+ *     is goog.global.
  */
 goog.exportSymbol = function(publicPath, object, opt_objectToExportTo) {
   goog.exportPath_(publicPath, object, opt_objectToExportTo);
@@ -1492,29 +2206,19 @@ goog.exportProperty = function(object, publicName, symbol) {
  * Usage:
  * <pre>
  * function ParentClass(a, b) { }
- * ParentClass.prototype.foo = function(a) { }
+ * ParentClass.prototype.foo = function(a) { };
  *
  * function ChildClass(a, b, c) {
- *   goog.base(this, a, b);
+ *   ChildClass.base(this, 'constructor', a, b);
  * }
  * goog.inherits(ChildClass, ParentClass);
  *
  * var child = new ChildClass('a', 'b', 'see');
- * child.foo(); // works
- * </pre>
- *
- * In addition, a superclass' implementation of a method can be invoked
- * as follows:
- *
- * <pre>
- * ChildClass.prototype.foo = function(a) {
- *   ChildClass.superClass_.foo.call(this, a);
- *   // other code
- * };
+ * child.foo(); // This works.
  * </pre>
  *
- * @param {Function} childCtor Child class.
- * @param {Function} parentCtor Parent class.
+ * @param {!Function} childCtor Child class.
+ * @param {!Function} parentCtor Parent class.
  */
 goog.inherits = function(childCtor, parentCtor) {
   /** @constructor */
@@ -1524,6 +2228,33 @@ goog.inherits = function(childCtor, parentCtor) {
   childCtor.prototype = new tempCtor();
   /** @override */
   childCtor.prototype.constructor = childCtor;
+
+  /**
+   * Calls superclass constructor/method.
+   *
+   * This function is only available if you use goog.inherits to
+   * express inheritance relationships between classes.
+   *
+   * NOTE: This is a replacement for goog.base and for superClass_
+   * property defined in childCtor.
+   *
+   * @param {!Object} me Should always be "this".
+   * @param {string} methodName The method name to call. Calling
+   *     superclass constructor can be done with the special string
+   *     'constructor'.
+   * @param {...*} var_args The arguments to pass to superclass
+   *     method/constructor.
+   * @return {*} The return value of the superclass method/constructor.
+   */
+  childCtor.base = function(me, methodName, var_args) {
+    // Copying using loop to avoid deop due to passing arguments object to
+    // function. This is faster in many JS engines as of late 2014.
+    var args = new Array(arguments.length - 2);
+    for (var i = 2; i < arguments.length; i++) {
+      args[i - 2] = arguments[i];
+    }
+    return parentCtor.prototype[methodName].apply(me, args);
+  };
 };
 
 
@@ -1531,45 +2262,53 @@ goog.inherits = function(childCtor, parentCtor) {
  * Call up to the superclass.
  *
  * If this is called from a constructor, then this calls the superclass
- * contructor with arguments 1-N.
+ * constructor with arguments 1-N.
  *
- * If this is called from a prototype method, then you must pass
- * the name of the method as the second argument to this function. If
- * you do not, you will get a runtime error. This calls the superclass'
- * method with arguments 2-N.
+ * If this is called from a prototype method, then you must pass the name of the
+ * method as the second argument to this function. If you do not, you will get a
+ * runtime error. This calls the superclass' method with arguments 2-N.
  *
- * This function only works if you use goog.inherits to express
- * inheritance relationships between your classes.
+ * This function only works if you use goog.inherits to express inheritance
+ * relationships between your classes.
  *
- * This function is a compiler primitive. At compile-time, the
- * compiler will do macro expansion to remove a lot of
- * the extra overhead that this function introduces. The compiler
- * will also enforce a lot of the assumptions that this function
- * makes, and treat it as a compiler error if you break them.
+ * This function is a compiler primitive. At compile-time, the compiler will do
+ * macro expansion to remove a lot of the extra overhead that this function
+ * introduces. The compiler will also enforce a lot of the assumptions that this
+ * function makes, and treat it as a compiler error if you break them.
  *
  * @param {!Object} me Should always be "this".
  * @param {*=} opt_methodName The method name if calling a super method.
  * @param {...*} var_args The rest of the arguments.
  * @return {*} The return value of the superclass method.
+ * @suppress {es5Strict} This method can not be used in strict mode, but
+ *     all Closure Library consumers must depend on this file.
  */
 goog.base = function(me, opt_methodName, var_args) {
   var caller = arguments.callee.caller;
 
-  if (goog.DEBUG) {
-    if (!caller) {
-      throw Error('arguments.caller not defined.  goog.base() expects not ' +
-                  'to be running in strict mode. See ' +
-                  'http://www.ecma-international.org/ecma-262/5.1/#sec-C');
-    }
+  if (goog.STRICT_MODE_COMPATIBLE || (goog.DEBUG && !caller)) {
+    throw Error('arguments.caller not defined.  goog.base() cannot be used ' +
+                'with strict mode code. See ' +
+                'http://www.ecma-international.org/ecma-262/5.1/#sec-C');
   }
 
   if (caller.superClass_) {
+    // Copying using loop to avoid deop due to passing arguments object to
+    // function. This is faster in many JS engines as of late 2014.
+    var ctorArgs = new Array(arguments.length - 1);
+    for (var i = 1; i < arguments.length; i++) {
+      ctorArgs[i - 1] = arguments[i];
+    }
     // This is a constructor. Call the superclass constructor.
-    return caller.superClass_.constructor.apply(
-        me, Array.prototype.slice.call(arguments, 1));
+    return caller.superClass_.constructor.apply(me, ctorArgs);
   }
 
-  var args = Array.prototype.slice.call(arguments, 2);
+  // Copying using loop to avoid deop due to passing arguments object to
+  // function. This is faster in many JS engines as of late 2014.
+  var args = new Array(arguments.length - 2);
+  for (var i = 2; i < arguments.length; i++) {
+    args[i - 2] = arguments[i];
+  }
   var foundCaller = false;
   for (var ctor = me.constructor;
        ctor; ctor = ctor.superClass_ && ctor.superClass_.constructor) {
@@ -1580,8 +2319,8 @@ goog.base = function(me, opt_methodName, var_args) {
     }
   }
 
-  // If we did not find the caller in the prototype chain,
-  // then one of two things happened:
+  // If we did not find the caller in the prototype chain, then one of two
+  // things happened:
   // 1) The caller is an instance method.
   // 2) This method was not called by the right caller.
   if (me[opt_methodName] === caller) {
@@ -1596,15 +2335,214 @@ goog.base = function(me, opt_methodName, var_args) {
 
 /**
  * Allow for aliasing within scope functions.  This function exists for
- * uncompiled code - in compiled code the calls will be inlined and the
- * aliases applied.  In uncompiled code the function is simply run since the
- * aliases as written are valid JavaScript.
+ * uncompiled code - in compiled code the calls will be inlined and the aliases
+ * applied.  In uncompiled code the function is simply run since the aliases as
+ * written are valid JavaScript.
+ *
+ *
  * @param {function()} fn Function to call.  This function can contain aliases
  *     to namespaces (e.g. "var dom = goog.dom") or classes
- *    (e.g. "var Timer = goog.Timer").
+ *     (e.g. "var Timer = goog.Timer").
  */
 goog.scope = function(fn) {
   fn.call(goog.global);
 };
 
 
+/*
+ * To support uncompiled, strict mode bundles that use eval to divide source
+ * like so:
+ *    eval('someSource;//# sourceUrl sourcefile.js');
+ * We need to export the globally defined symbols "goog" and "COMPILED".
+ * Exporting "goog" breaks the compiler optimizations, so we required that
+ * be defined externally.
+ * NOTE: We don't use goog.exportSymbol here because we don't want to trigger
+ * extern generation when that compiler option is enabled.
+ */
+if (!COMPILED) {
+  goog.global['COMPILED'] = COMPILED;
+}
+
+
+//==============================================================================
+// goog.defineClass implementation
+//==============================================================================
+
+
+/**
+ * Creates a restricted form of a Closure "class":
+ *   - from the compiler's perspective, the instance returned from the
+ *     constructor is sealed (no new properties may be added).  This enables
+ *     better checks.
+ *   - the compiler will rewrite this definition to a form that is optimal
+ *     for type checking and optimization (initially this will be a more
+ *     traditional form).
+ *
+ * @param {Function} superClass The superclass, Object or null.
+ * @param {goog.defineClass.ClassDescriptor} def
+ *     An object literal describing
+ *     the class.  It may have the following properties:
+ *     "constructor": the constructor function
+ *     "statics": an object literal containing methods to add to the constructor
+ *        as "static" methods or a function that will receive the constructor
+ *        function as its only parameter to which static properties can
+ *        be added.
+ *     all other properties are added to the prototype.
+ * @return {!Function} The class constructor.
+ */
+goog.defineClass = function(superClass, def) {
+  // TODO(johnlenz): consider making the superClass an optional parameter.
+  var constructor = def.constructor;
+  var statics = def.statics;
+  // Wrap the constructor prior to setting up the prototype and static methods.
+  if (!constructor || constructor == Object.prototype.constructor) {
+    constructor = function() {
+      throw Error('cannot instantiate an interface (no constructor defined).');
+    };
+  }
+
+  var cls = goog.defineClass.createSealingConstructor_(constructor, superClass);
+  if (superClass) {
+    goog.inherits(cls, superClass);
+  }
+
+  // Remove all the properties that should not be copied to the prototype.
+  delete def.constructor;
+  delete def.statics;
+
+  goog.defineClass.applyProperties_(cls.prototype, def);
+  if (statics != null) {
+    if (statics instanceof Function) {
+      statics(cls);
+    } else {
+      goog.defineClass.applyProperties_(cls, statics);
+    }
+  }
+
+  return cls;
+};
+
+
+/**
+ * @typedef {
+ *     !Object|
+ *     {constructor:!Function}|
+ *     {constructor:!Function, statics:(Object|function(Function):void)}}
+ * @suppress {missingProvide}
+ */
+goog.defineClass.ClassDescriptor;
+
+
+/**
+ * @define {boolean} Whether the instances returned by
+ * goog.defineClass should be sealed when possible.
+ */
+goog.define('goog.defineClass.SEAL_CLASS_INSTANCES', goog.DEBUG);
+
+
+/**
+ * If goog.defineClass.SEAL_CLASS_INSTANCES is enabled and Object.seal is
+ * defined, this function will wrap the constructor in a function that seals the
+ * results of the provided constructor function.
+ *
+ * @param {!Function} ctr The constructor whose results maybe be sealed.
+ * @param {Function} superClass The superclass constructor.
+ * @return {!Function} The replacement constructor.
+ * @private
+ */
+goog.defineClass.createSealingConstructor_ = function(ctr, superClass) {
+  if (goog.defineClass.SEAL_CLASS_INSTANCES &&
+      Object.seal instanceof Function) {
+    // Don't seal subclasses of unsealable-tagged legacy classes.
+    if (superClass && superClass.prototype &&
+        superClass.prototype[goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_]) {
+      return ctr;
+    }
+    /**
+     * @this {Object}
+     * @return {?}
+     */
+    var wrappedCtr = function() {
+      // Don't seal an instance of a subclass when it calls the constructor of
+      // its super class as there is most likely still setup to do.
+      var instance = ctr.apply(this, arguments) || this;
+      instance[goog.UID_PROPERTY_] = instance[goog.UID_PROPERTY_];
+      if (this.constructor === wrappedCtr) {
+        Object.seal(instance);
+      }
+      return instance;
+    };
+    return wrappedCtr;
+  }
+  return ctr;
+};
+
+
+// TODO(johnlenz): share these values with the goog.object
+/**
+ * The names of the fields that are defined on Object.prototype.
+ * @type {!Array<string>}
+ * @private
+ * @const
+ */
+goog.defineClass.OBJECT_PROTOTYPE_FIELDS_ = [
+  'constructor',
+  'hasOwnProperty',
+  'isPrototypeOf',
+  'propertyIsEnumerable',
+  'toLocaleString',
+  'toString',
+  'valueOf'
+];
+
+
+// TODO(johnlenz): share this function with the goog.object
+/**
+ * @param {!Object} target The object to add properties to.
+ * @param {!Object} source The object to copy properties from.
+ * @private
+ */
+goog.defineClass.applyProperties_ = function(target, source) {
+  // TODO(johnlenz): update this to support ES5 getters/setters
+
+  var key;
+  for (key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      target[key] = source[key];
+    }
+  }
+
+  // For IE the for-in-loop does not contain any properties that are not
+  // enumerable on the prototype object (for example isPrototypeOf from
+  // Object.prototype) and it will also not include 'replace' on objects that
+  // extend String and change 'replace' (not that it is common for anyone to
+  // extend anything except Object).
+  for (var i = 0; i < goog.defineClass.OBJECT_PROTOTYPE_FIELDS_.length; i++) {
+    key = goog.defineClass.OBJECT_PROTOTYPE_FIELDS_[i];
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      target[key] = source[key];
+    }
+  }
+};
+
+
+/**
+ * Sealing classes breaks the older idiom of assigning properties on the
+ * prototype rather than in the constructor.  As such, goog.defineClass
+ * must not seal subclasses of these old-style classes until they are fixed.
+ * Until then, this marks a class as "broken", instructing defineClass
+ * not to seal subclasses.
+ * @param {!Function} ctr The legacy constructor to tag as unsealable.
+ */
+goog.tagUnsealableClass = function(ctr) {
+  if (!COMPILED && goog.defineClass.SEAL_CLASS_INSTANCES) {
+    ctr.prototype[goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_] = true;
+  }
+};
+
+
+/**
+ * Name for unsealable tag property.
+ * @const @private {string}
+ */
+goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_ = 'goog_defineClass_legacy_unsealable';
diff --git a/lib/goog/debug/debug.js b/lib/goog/debug/debug.js
new file mode 100644
index 0000000..ff15374
--- /dev/null
+++ b/lib/goog/debug/debug.js
@@ -0,0 +1,653 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Logging and debugging utilities.
+ *
+ * @see ../demos/debug.html
+ */
+
+goog.provide('goog.debug');
+
+goog.require('goog.array');
+goog.require('goog.html.SafeHtml');
+goog.require('goog.html.SafeUrl');
+goog.require('goog.html.uncheckedconversions');
+goog.require('goog.string.Const');
+goog.require('goog.structs.Set');
+goog.require('goog.userAgent');
+
+
+/** @define {boolean} Whether logging should be enabled. */
+goog.define('goog.debug.LOGGING_ENABLED', goog.DEBUG);
+
+
+/**
+ * Catches onerror events fired by windows and similar objects.
+ * @param {function(Object)} logFunc The function to call with the error
+ *    information.
+ * @param {boolean=} opt_cancel Whether to stop the error from reaching the
+ *    browser.
+ * @param {Object=} opt_target Object that fires onerror events.
+ */
+goog.debug.catchErrors = function(logFunc, opt_cancel, opt_target) {
+  var target = opt_target || goog.global;
+  var oldErrorHandler = target.onerror;
+  var retVal = !!opt_cancel;
+
+  // Chrome interprets onerror return value backwards (http://crbug.com/92062)
+  // until it was fixed in webkit revision r94061 (Webkit 535.3). This
+  // workaround still needs to be skipped in Safari after the webkit change
+  // gets pushed out in Safari.
+  // See https://bugs.webkit.org/show_bug.cgi?id=67119
+  if (goog.userAgent.WEBKIT &&
+      !goog.userAgent.isVersionOrHigher('535.3')) {
+    retVal = !retVal;
+  }
+
+  /**
+   * New onerror handler for this target. This onerror handler follows the spec
+   * according to
+   * http://www.whatwg.org/specs/web-apps/current-work/#runtime-script-errors
+   * The spec was changed in August 2013 to support receiving column information
+   * and an error object for all scripts on the same origin or cross origin
+   * scripts with the proper headers. See
+   * https://mikewest.org/2013/08/debugging-runtime-errors-with-window-onerror
+   *
+   * @param {string} message The error message. For cross-origin errors, this
+   *     will be scrubbed to just "Script error.". For new browsers that have
+   *     updated to follow the latest spec, errors that come from origins that
+   *     have proper cross origin headers will not be scrubbed.
+   * @param {string} url The URL of the script that caused the error. The URL
+   *     will be scrubbed to "" for cross origin scripts unless the script has
+   *     proper cross origin headers and the browser has updated to the latest
+   *     spec.
+   * @param {number} line The line number in the script that the error
+   *     occurred on.
+   * @param {number=} opt_col The optional column number that the error
+   *     occurred on. Only browsers that have updated to the latest spec will
+   *     include this.
+   * @param {Error=} opt_error The optional actual error object for this
+   *     error that should include the stack. Only browsers that have updated
+   *     to the latest spec will inlude this parameter.
+   * @return {boolean} Whether to prevent the error from reaching the browser.
+   */
+  target.onerror = function(message, url, line, opt_col, opt_error) {
+    if (oldErrorHandler) {
+      oldErrorHandler(message, url, line, opt_col, opt_error);
+    }
+    logFunc({
+      message: message,
+      fileName: url,
+      line: line,
+      col: opt_col,
+      error: opt_error
+    });
+    return retVal;
+  };
+};
+
+
+/**
+ * Creates a string representing an object and all its properties.
+ * @param {Object|null|undefined} obj Object to expose.
+ * @param {boolean=} opt_showFn Show the functions as well as the properties,
+ *     default is false.
+ * @return {string} The string representation of {@code obj}.
+ */
+goog.debug.expose = function(obj, opt_showFn) {
+  if (typeof obj == 'undefined') {
+    return 'undefined';
+  }
+  if (obj == null) {
+    return 'NULL';
+  }
+  var str = [];
+
+  for (var x in obj) {
+    if (!opt_showFn && goog.isFunction(obj[x])) {
+      continue;
+    }
+    var s = x + ' = ';
+    /** @preserveTry */
+    try {
+      s += obj[x];
+    } catch (e) {
+      s += '*** ' + e + ' ***';
+    }
+    str.push(s);
+  }
+  return str.join('\n');
+};
+
+
+/**
+ * Creates a string representing a given primitive or object, and for an
+ * object, all its properties and nested objects.  WARNING: If an object is
+ * given, it and all its nested objects will be modified.  To detect reference
+ * cycles, this method identifies objects using goog.getUid() which mutates the
+ * object.
+ * @param {*} obj Object to expose.
+ * @param {boolean=} opt_showFn Also show properties that are functions (by
+ *     default, functions are omitted).
+ * @return {string} A string representation of {@code obj}.
+ */
+goog.debug.deepExpose = function(obj, opt_showFn) {
+  var str = [];
+
+  var helper = function(obj, space, parentSeen) {
+    var nestspace = space + '  ';
+    var seen = new goog.structs.Set(parentSeen);
+
+    var indentMultiline = function(str) {
+      return str.replace(/\n/g, '\n' + space);
+    };
+
+    /** @preserveTry */
+    try {
+      if (!goog.isDef(obj)) {
+        str.push('undefined');
+      } else if (goog.isNull(obj)) {
+        str.push('NULL');
+      } else if (goog.isString(obj)) {
+        str.push('"' + indentMultiline(obj) + '"');
+      } else if (goog.isFunction(obj)) {
+        str.push(indentMultiline(String(obj)));
+      } else if (goog.isObject(obj)) {
+        if (seen.contains(obj)) {
+          str.push('*** reference loop detected ***');
+        } else {
+          seen.add(obj);
+          str.push('{');
+          for (var x in obj) {
+            if (!opt_showFn && goog.isFunction(obj[x])) {
+              continue;
+            }
+            str.push('\n');
+            str.push(nestspace);
+            str.push(x + ' = ');
+            helper(obj[x], nestspace, seen);
+          }
+          str.push('\n' + space + '}');
+        }
+      } else {
+        str.push(obj);
+      }
+    } catch (e) {
+      str.push('*** ' + e + ' ***');
+    }
+  };
+
+  helper(obj, '', new goog.structs.Set());
+  return str.join('');
+};
+
+
+/**
+ * Recursively outputs a nested array as a string.
+ * @param {Array<?>} arr The array.
+ * @return {string} String representing nested array.
+ */
+goog.debug.exposeArray = function(arr) {
+  var str = [];
+  for (var i = 0; i < arr.length; i++) {
+    if (goog.isArray(arr[i])) {
+      str.push(goog.debug.exposeArray(arr[i]));
+    } else {
+      str.push(arr[i]);
+    }
+  }
+  return '[ ' + str.join(', ') + ' ]';
+};
+
+
+/**
+ * Exposes an exception that has been caught by a try...catch and outputs the
+ * error as HTML with a stack trace.
+ * @param {Object} err Error object or string.
+ * @param {Function=} opt_fn Optional function to start stack trace from.
+ * @return {string} Details of exception, as HTML.
+ */
+goog.debug.exposeException = function(err, opt_fn) {
+  var html = goog.debug.exposeExceptionAsHtml(err, opt_fn);
+  return goog.html.SafeHtml.unwrap(html);
+};
+
+
+/**
+ * Exposes an exception that has been caught by a try...catch and outputs the
+ * error with a stack trace.
+ * @param {Object} err Error object or string.
+ * @param {Function=} opt_fn Optional function to start stack trace from.
+ * @return {!goog.html.SafeHtml} Details of exception.
+ */
+goog.debug.exposeExceptionAsHtml = function(err, opt_fn) {
+  /** @preserveTry */
+  try {
+    var e = goog.debug.normalizeErrorObject(err);
+    // Create the error message
+    var viewSourceUrl = goog.debug.createViewSourceUrl_(e.fileName);
+    var error = goog.html.SafeHtml.concat(
+        goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(
+            'Message: ' + e.message + '\nUrl: '),
+        goog.html.SafeHtml.create('a',
+            {href: viewSourceUrl, target: '_new'}, e.fileName),
+        goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(
+            '\nLine: ' + e.lineNumber + '\n\nBrowser stack:\n' +
+            e.stack + '-> ' + '[end]\n\nJS stack traversal:\n' +
+            goog.debug.getStacktrace(opt_fn) + '-> '));
+    return error;
+  } catch (e2) {
+    return goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(
+        'Exception trying to expose exception! You win, we lose. ' + e2);
+  }
+};
+
+
+/**
+ * @param {?string=} opt_fileName
+ * @return {!goog.html.SafeUrl} SafeUrl with view-source scheme, pointing at
+ *     fileName.
+ * @private
+ */
+goog.debug.createViewSourceUrl_ = function(opt_fileName) {
+  if (!goog.isDefAndNotNull(opt_fileName)) {
+    opt_fileName = '';
+  }
+  if (!/^https?:\/\//i.test(opt_fileName)) {
+    return goog.html.SafeUrl.fromConstant(
+        goog.string.Const.from('sanitizedviewsrc'));
+  }
+  var sanitizedFileName = goog.html.SafeUrl.sanitize(opt_fileName);
+  return goog.html.uncheckedconversions.
+      safeUrlFromStringKnownToSatisfyTypeContract(
+          goog.string.Const.from('view-source scheme plus HTTP/HTTPS URL'),
+          'view-source:' + goog.html.SafeUrl.unwrap(sanitizedFileName));
+};
+
+
+/**
+ * Normalizes the error/exception object between browsers.
+ * @param {Object} err Raw error object.
+ * @return {!Object} Normalized error object.
+ */
+goog.debug.normalizeErrorObject = function(err) {
+  var href = goog.getObjectByName('window.location.href');
+  if (goog.isString(err)) {
+    return {
+      'message': err,
+      'name': 'Unknown error',
+      'lineNumber': 'Not available',
+      'fileName': href,
+      'stack': 'Not available'
+    };
+  }
+
+  var lineNumber, fileName;
+  var threwError = false;
+
+  try {
+    lineNumber = err.lineNumber || err.line || 'Not available';
+  } catch (e) {
+    // Firefox 2 sometimes throws an error when accessing 'lineNumber':
+    // Message: Permission denied to get property UnnamedClass.lineNumber
+    lineNumber = 'Not available';
+    threwError = true;
+  }
+
+  try {
+    fileName = err.fileName || err.filename || err.sourceURL ||
+        // $googDebugFname may be set before a call to eval to set the filename
+        // that the eval is supposed to present.
+        goog.global['$googDebugFname'] || href;
+  } catch (e) {
+    // Firefox 2 may also throw an error when accessing 'filename'.
+    fileName = 'Not available';
+    threwError = true;
+  }
+
+  // The IE Error object contains only the name and the message.
+  // The Safari Error object uses the line and sourceURL fields.
+  if (threwError || !err.lineNumber || !err.fileName || !err.stack ||
+      !err.message || !err.name) {
+    return {
+      'message': err.message || 'Not available',
+      'name': err.name || 'UnknownError',
+      'lineNumber': lineNumber,
+      'fileName': fileName,
+      'stack': err.stack || 'Not available'
+    };
+  }
+
+  // Standards error object
+  return err;
+};
+
+
+/**
+ * Converts an object to an Error if it's a String,
+ * adds a stacktrace if there isn't one,
+ * and optionally adds an extra message.
+ * @param {Error|string} err  the original thrown object or string.
+ * @param {string=} opt_message  optional additional message to add to the
+ *     error.
+ * @return {!Error} If err is a string, it is used to create a new Error,
+ *     which is enhanced and returned.  Otherwise err itself is enhanced
+ *     and returned.
+ */
+goog.debug.enhanceError = function(err, opt_message) {
+  var error;
+  if (typeof err == 'string') {
+    error = Error(err);
+    if (Error.captureStackTrace) {
+      // Trim this function off the call stack, if we can.
+      Error.captureStackTrace(error, goog.debug.enhanceError);
+    }
+  } else {
+    error = err;
+  }
+
+  if (!error.stack) {
+    error.stack = goog.debug.getStacktrace(goog.debug.enhanceError);
+  }
+  if (opt_message) {
+    // find the first unoccupied 'messageX' property
+    var x = 0;
+    while (error['message' + x]) {
+      ++x;
+    }
+    error['message' + x] = String(opt_message);
+  }
+  return error;
+};
+
+
+/**
+ * Gets the current stack trace. Simple and iterative - doesn't worry about
+ * catching circular references or getting the args.
+ * @param {number=} opt_depth Optional maximum depth to trace back to.
+ * @return {string} A string with the function names of all functions in the
+ *     stack, separated by \n.
+ * @suppress {es5Strict}
+ */
+goog.debug.getStacktraceSimple = function(opt_depth) {
+  if (goog.STRICT_MODE_COMPATIBLE) {
+    var stack = goog.debug.getNativeStackTrace_(goog.debug.getStacktraceSimple);
+    if (stack) {
+      return stack;
+    }
+    // NOTE: browsers that have strict mode support also have native "stack"
+    // properties.  Fall-through for legacy browser support.
+  }
+
+  var sb = [];
+  var fn = arguments.callee.caller;
+  var depth = 0;
+
+  while (fn && (!opt_depth || depth < opt_depth)) {
+    sb.push(goog.debug.getFunctionName(fn));
+    sb.push('()\n');
+    /** @preserveTry */
+    try {
+      fn = fn.caller;
+    } catch (e) {
+      sb.push('[exception trying to get caller]\n');
+      break;
+    }
+    depth++;
+    if (depth >= goog.debug.MAX_STACK_DEPTH) {
+      sb.push('[...long stack...]');
+      break;
+    }
+  }
+  if (opt_depth && depth >= opt_depth) {
+    sb.push('[...reached max depth limit...]');
+  } else {
+    sb.push('[end]');
+  }
+
+  return sb.join('');
+};
+
+
+/**
+ * Max length of stack to try and output
+ * @type {number}
+ */
+goog.debug.MAX_STACK_DEPTH = 50;
+
+
+/**
+ * @param {Function} fn The function to start getting the trace from.
+ * @return {?string}
+ * @private
+ */
+goog.debug.getNativeStackTrace_ = function(fn) {
+  var tempErr = new Error();
+  if (Error.captureStackTrace) {
+    Error.captureStackTrace(tempErr, fn);
+    return String(tempErr.stack);
+  } else {
+    // IE10, only adds stack traces when an exception is thrown.
+    try {
+      throw tempErr;
+    } catch (e) {
+      tempErr = e;
+    }
+    var stack = tempErr.stack;
+    if (stack) {
+      return String(stack);
+    }
+  }
+  return null;
+};
+
+
+/**
+ * Gets the current stack trace, either starting from the caller or starting
+ * from a specified function that's currently on the call stack.
+ * @param {Function=} opt_fn Optional function to start getting the trace from.
+ *     If not provided, defaults to the function that called this.
+ * @return {string} Stack trace.
+ * @suppress {es5Strict}
+ */
+goog.debug.getStacktrace = function(opt_fn) {
+  var stack;
+  if (goog.STRICT_MODE_COMPATIBLE) {
+    // Try to get the stack trace from the environment if it is available.
+    var contextFn = opt_fn || goog.debug.getStacktrace;
+    stack = goog.debug.getNativeStackTrace_(contextFn);
+  }
+  if (!stack) {
+    // NOTE: browsers that have strict mode support also have native "stack"
+    // properties. This function will throw in strict mode.
+    stack = goog.debug.getStacktraceHelper_(
+        opt_fn || arguments.callee.caller, []);
+  }
+  return stack;
+};
+
+
+/**
+ * Private helper for getStacktrace().
+ * @param {Function} fn Function to start getting the trace from.
+ * @param {Array<!Function>} visited List of functions visited so far.
+ * @return {string} Stack trace starting from function fn.
+ * @suppress {es5Strict}
+ * @private
+ */
+goog.debug.getStacktraceHelper_ = function(fn, visited) {
+  var sb = [];
+
+  // Circular reference, certain functions like bind seem to cause a recursive
+  // loop so we need to catch circular references
+  if (goog.array.contains(visited, fn)) {
+    sb.push('[...circular reference...]');
+
+  // Traverse the call stack until function not found or max depth is reached
+  } else if (fn && visited.length < goog.debug.MAX_STACK_DEPTH) {
+    sb.push(goog.debug.getFunctionName(fn) + '(');
+    var args = fn.arguments;
+    // Args may be null for some special functions such as host objects or eval.
+    for (var i = 0; args && i < args.length; i++) {
+      if (i > 0) {
+        sb.push(', ');
+      }
+      var argDesc;
+      var arg = args[i];
+      switch (typeof arg) {
+        case 'object':
+          argDesc = arg ? 'object' : 'null';
+          break;
+
+        case 'string':
+          argDesc = arg;
+          break;
+
+        case 'number':
+          argDesc = String(arg);
+          break;
+
+        case 'boolean':
+          argDesc = arg ? 'true' : 'false';
+          break;
+
+        case 'function':
+          argDesc = goog.debug.getFunctionName(arg);
+          argDesc = argDesc ? argDesc : '[fn]';
+          break;
+
+        case 'undefined':
+        default:
+          argDesc = typeof arg;
+          break;
+      }
+
+      if (argDesc.length > 40) {
+        argDesc = argDesc.substr(0, 40) + '...';
+      }
+      sb.push(argDesc);
+    }
+    visited.push(fn);
+    sb.push(')\n');
+    /** @preserveTry */
+    try {
+      sb.push(goog.debug.getStacktraceHelper_(fn.caller, visited));
+    } catch (e) {
+      sb.push('[exception trying to get caller]\n');
+    }
+
+  } else if (fn) {
+    sb.push('[...long stack...]');
+  } else {
+    sb.push('[end]');
+  }
+  return sb.join('');
+};
+
+
+/**
+ * Set a custom function name resolver.
+ * @param {function(Function): string} resolver Resolves functions to their
+ *     names.
+ */
+goog.debug.setFunctionResolver = function(resolver) {
+  goog.debug.fnNameResolver_ = resolver;
+};
+
+
+/**
+ * Gets a function name
+ * @param {Function} fn Function to get name of.
+ * @return {string} Function's name.
+ */
+goog.debug.getFunctionName = function(fn) {
+  if (goog.debug.fnNameCache_[fn]) {
+    return goog.debug.fnNameCache_[fn];
+  }
+  if (goog.debug.fnNameResolver_) {
+    var name = goog.debug.fnNameResolver_(fn);
+    if (name) {
+      goog.debug.fnNameCache_[fn] = name;
+      return name;
+    }
+  }
+
+  // Heuristically determine function name based on code.
+  var functionSource = String(fn);
+  if (!goog.debug.fnNameCache_[functionSource]) {
+    var matches = /function ([^\(]+)/.exec(functionSource);
+    if (matches) {
+      var method = matches[1];
+      goog.debug.fnNameCache_[functionSource] = method;
+    } else {
+      goog.debug.fnNameCache_[functionSource] = '[Anonymous]';
+    }
+  }
+
+  return goog.debug.fnNameCache_[functionSource];
+};
+
+
+/**
+ * Makes whitespace visible by replacing it with printable characters.
+ * This is useful in finding diffrences between the expected and the actual
+ * output strings of a testcase.
+ * @param {string} string whose whitespace needs to be made visible.
+ * @return {string} string whose whitespace is made visible.
+ */
+goog.debug.makeWhitespaceVisible = function(string) {
+  return string.replace(/ /g, '[_]')
+      .replace(/\f/g, '[f]')
+      .replace(/\n/g, '[n]\n')
+      .replace(/\r/g, '[r]')
+      .replace(/\t/g, '[t]');
+};
+
+
+/**
+ * Returns the type of a value. If a constructor is passed, and a suitable
+ * string cannot be found, 'unknown type name' will be returned.
+ *
+ * <p>Forked rather than moved from {@link goog.asserts.getType_}
+ * to avoid adding a dependency to goog.asserts.
+ * @param {*} value A constructor, object, or primitive.
+ * @return {string} The best display name for the value, or 'unknown type name'.
+ */
+goog.debug.runtimeType = function(value) {
+  if (value instanceof Function) {
+    return value.displayName || value.name || 'unknown type name';
+  } else if (value instanceof Object) {
+    return value.constructor.displayName || value.constructor.name ||
+        Object.prototype.toString.call(value);
+  } else {
+    return value === null ? 'null' : typeof value;
+  }
+};
+
+
+/**
+ * Hash map for storing function names that have already been looked up.
+ * @type {Object}
+ * @private
+ */
+goog.debug.fnNameCache_ = {};
+
+
+/**
+ * Resolves functions to their names.  Resolved function names will be cached.
+ * @type {function(Function):string}
+ * @private
+ */
+goog.debug.fnNameResolver_;
diff --git a/lib/goog/debug/entrypointregistry.js b/lib/goog/debug/entrypointregistry.js
new file mode 100644
index 0000000..3ae7549
--- /dev/null
+++ b/lib/goog/debug/entrypointregistry.js
@@ -0,0 +1,158 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A global registry for entry points into a program,
+ * so that they can be instrumented. Each module should register their
+ * entry points with this registry. Designed to be compiled out
+ * if no instrumentation is requested.
+ *
+ * Entry points may be registered before or after a call to
+ * goog.debug.entryPointRegistry.monitorAll. If an entry point is registered
+ * later, the existing monitor will instrument the new entry point.
+ *
+ * @author nicksantos@google.com (Nick Santos)
+ */
+
+goog.provide('goog.debug.EntryPointMonitor');
+goog.provide('goog.debug.entryPointRegistry');
+
+goog.require('goog.asserts');
+
+
+
+/**
+ * @interface
+ */
+goog.debug.EntryPointMonitor = function() {};
+
+
+/**
+ * Instruments a function.
+ *
+ * @param {!Function} fn A function to instrument.
+ * @return {!Function} The instrumented function.
+ */
+goog.debug.EntryPointMonitor.prototype.wrap;
+
+
+/**
+ * Try to remove an instrumentation wrapper created by this monitor.
+ * If the function passed to unwrap is not a wrapper created by this
+ * monitor, then we will do nothing.
+ *
+ * Notice that some wrappers may not be unwrappable. For example, if other
+ * monitors have applied their own wrappers, then it will be impossible to
+ * unwrap them because their wrappers will have captured our wrapper.
+ *
+ * So it is important that entry points are unwrapped in the reverse
+ * order that they were wrapped.
+ *
+ * @param {!Function} fn A function to unwrap.
+ * @return {!Function} The unwrapped function, or {@code fn} if it was not
+ *     a wrapped function created by this monitor.
+ */
+goog.debug.EntryPointMonitor.prototype.unwrap;
+
+
+/**
+ * An array of entry point callbacks.
+ * @type {!Array<function(!Function)>}
+ * @private
+ */
+goog.debug.entryPointRegistry.refList_ = [];
+
+
+/**
+ * Monitors that should wrap all the entry points.
+ * @type {!Array<!goog.debug.EntryPointMonitor>}
+ * @private
+ */
+goog.debug.entryPointRegistry.monitors_ = [];
+
+
+/**
+ * Whether goog.debug.entryPointRegistry.monitorAll has ever been called.
+ * Checking this allows the compiler to optimize out the registrations.
+ * @type {boolean}
+ * @private
+ */
+goog.debug.entryPointRegistry.monitorsMayExist_ = false;
+
+
+/**
+ * Register an entry point with this module.
+ *
+ * The entry point will be instrumented when a monitor is passed to
+ * goog.debug.entryPointRegistry.monitorAll. If this has already occurred, the
+ * entry point is instrumented immediately.
+ *
+ * @param {function(!Function)} callback A callback function which is called
+ *     with a transforming function to instrument the entry point. The callback
+ *     is responsible for wrapping the relevant entry point with the
+ *     transforming function.
+ */
+goog.debug.entryPointRegistry.register = function(callback) {
+  // Don't use push(), so that this can be compiled out.
+  goog.debug.entryPointRegistry.refList_[
+      goog.debug.entryPointRegistry.refList_.length] = callback;
+  // If no one calls monitorAll, this can be compiled out.
+  if (goog.debug.entryPointRegistry.monitorsMayExist_) {
+    var monitors = goog.debug.entryPointRegistry.monitors_;
+    for (var i = 0; i < monitors.length; i++) {
+      callback(goog.bind(monitors[i].wrap, monitors[i]));
+    }
+  }
+};
+
+
+/**
+ * Configures a monitor to wrap all entry points.
+ *
+ * Entry points that have already been registered are immediately wrapped by
+ * the monitor. When an entry point is registered in the future, it will also
+ * be wrapped by the monitor when it is registered.
+ *
+ * @param {!goog.debug.EntryPointMonitor} monitor An entry point monitor.
+ */
+goog.debug.entryPointRegistry.monitorAll = function(monitor) {
+  goog.debug.entryPointRegistry.monitorsMayExist_ = true;
+  var transformer = goog.bind(monitor.wrap, monitor);
+  for (var i = 0; i < goog.debug.entryPointRegistry.refList_.length; i++) {
+    goog.debug.entryPointRegistry.refList_[i](transformer);
+  }
+  goog.debug.entryPointRegistry.monitors_.push(monitor);
+};
+
+
+/**
+ * Try to unmonitor all the entry points that have already been registered. If
+ * an entry point is registered in the future, it will not be wrapped by the
+ * monitor when it is registered. Note that this may fail if the entry points
+ * have additional wrapping.
+ *
+ * @param {!goog.debug.EntryPointMonitor} monitor The last monitor to wrap
+ *     the entry points.
+ * @throws {Error} If the monitor is not the most recently configured monitor.
+ */
+goog.debug.entryPointRegistry.unmonitorAllIfPossible = function(monitor) {
+  var monitors = goog.debug.entryPointRegistry.monitors_;
+  goog.asserts.assert(monitor == monitors[monitors.length - 1],
+      'Only the most recent monitor can be unwrapped.');
+  var transformer = goog.bind(monitor.unwrap, monitor);
+  for (var i = 0; i < goog.debug.entryPointRegistry.refList_.length; i++) {
+    goog.debug.entryPointRegistry.refList_[i](transformer);
+  }
+  monitors.length--;
+};
diff --git a/lib/goog/debug/error.js b/lib/goog/debug/error.js
index dd32fdb..5f1bd3e 100644
--- a/lib/goog/debug/error.js
+++ b/lib/goog/debug/error.js
@@ -33,16 +33,28 @@ goog.provide('goog.debug.Error');
  */
 goog.debug.Error = function(opt_msg) {
 
-  // Ensure there is a stack trace.
+  // Attempt to ensure there is a stack trace.
   if (Error.captureStackTrace) {
     Error.captureStackTrace(this, goog.debug.Error);
   } else {
-    this.stack = new Error().stack || '';
+    var stack = new Error().stack;
+    if (stack) {
+      this.stack = stack;
+    }
   }
 
   if (opt_msg) {
     this.message = String(opt_msg);
   }
+
+  /**
+   * Whether to report this error to the server. Setting this to false will
+   * cause the error reporter to not report the error back to the server,
+   * which can be useful if the client knows that the error has already been
+   * logged on the server.
+   * @type {boolean}
+   */
+  this.reportErrorToServer = true;
 };
 goog.inherits(goog.debug.Error, Error);
 
diff --git a/lib/goog/debug/logbuffer.js b/lib/goog/debug/logbuffer.js
new file mode 100644
index 0000000..7e3de4b
--- /dev/null
+++ b/lib/goog/debug/logbuffer.js
@@ -0,0 +1,148 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A buffer for log records. The purpose of this is to improve
+ * logging performance by re-using old objects when the buffer becomes full and
+ * to eliminate the need for each app to implement their own log buffer. The
+ * disadvantage to doing this is that log handlers cannot maintain references to
+ * log records and expect that they are not overwriten at a later point.
+ *
+ * @author agrieve@google.com (Andrew Grieve)
+ */
+
+goog.provide('goog.debug.LogBuffer');
+
+goog.require('goog.asserts');
+goog.require('goog.debug.LogRecord');
+
+
+
+/**
+ * Creates the log buffer.
+ * @constructor
+ * @final
+ */
+goog.debug.LogBuffer = function() {
+  goog.asserts.assert(goog.debug.LogBuffer.isBufferingEnabled(),
+      'Cannot use goog.debug.LogBuffer without defining ' +
+      'goog.debug.LogBuffer.CAPACITY.');
+  this.clear();
+};
+
+
+/**
+ * A static method that always returns the same instance of LogBuffer.
+ * @return {!goog.debug.LogBuffer} The LogBuffer singleton instance.
+ */
+goog.debug.LogBuffer.getInstance = function() {
+  if (!goog.debug.LogBuffer.instance_) {
+    // This function is written with the return statement after the assignment
+    // to avoid the jscompiler StripCode bug described in http://b/2608064.
+    // After that bug is fixed this can be refactored.
+    goog.debug.LogBuffer.instance_ = new goog.debug.LogBuffer();
+  }
+  return goog.debug.LogBuffer.instance_;
+};
+
+
+/**
+ * @define {number} The number of log records to buffer. 0 means disable
+ * buffering.
+ */
+goog.define('goog.debug.LogBuffer.CAPACITY', 0);
+
+
+/**
+ * The array to store the records.
+ * @type {!Array<!goog.debug.LogRecord|undefined>}
+ * @private
+ */
+goog.debug.LogBuffer.prototype.buffer_;
+
+
+/**
+ * The index of the most recently added record or -1 if there are no records.
+ * @type {number}
+ * @private
+ */
+goog.debug.LogBuffer.prototype.curIndex_;
+
+
+/**
+ * Whether the buffer is at capacity.
+ * @type {boolean}
+ * @private
+ */
+goog.debug.LogBuffer.prototype.isFull_;
+
+
+/**
+ * Adds a log record to the buffer, possibly overwriting the oldest record.
+ * @param {goog.debug.Logger.Level} level One of the level identifiers.
+ * @param {string} msg The string message.
+ * @param {string} loggerName The name of the source logger.
+ * @return {!goog.debug.LogRecord} The log record.
+ */
+goog.debug.LogBuffer.prototype.addRecord = function(level, msg, loggerName) {
+  var curIndex = (this.curIndex_ + 1) % goog.debug.LogBuffer.CAPACITY;
+  this.curIndex_ = curIndex;
+  if (this.isFull_) {
+    var ret = this.buffer_[curIndex];
+    ret.reset(level, msg, loggerName);
+    return ret;
+  }
+  this.isFull_ = curIndex == goog.debug.LogBuffer.CAPACITY - 1;
+  return this.buffer_[curIndex] =
+      new goog.debug.LogRecord(level, msg, loggerName);
+};
+
+
+/**
+ * @return {boolean} Whether the log buffer is enabled.
+ */
+goog.debug.LogBuffer.isBufferingEnabled = function() {
+  return goog.debug.LogBuffer.CAPACITY > 0;
+};
+
+
+/**
+ * Removes all buffered log records.
+ */
+goog.debug.LogBuffer.prototype.clear = function() {
+  this.buffer_ = new Array(goog.debug.LogBuffer.CAPACITY);
+  this.curIndex_ = -1;
+  this.isFull_ = false;
+};
+
+
+/**
+ * Calls the given function for each buffered log record, starting with the
+ * oldest one.
+ * @param {function(!goog.debug.LogRecord)} func The function to call.
+ */
+goog.debug.LogBuffer.prototype.forEachRecord = function(func) {
+  var buffer = this.buffer_;
+  // Corner case: no records.
+  if (!buffer[0]) {
+    return;
+  }
+  var curIndex = this.curIndex_;
+  var i = this.isFull_ ? curIndex : -1;
+  do {
+    i = (i + 1) % goog.debug.LogBuffer.CAPACITY;
+    func(/** @type {!goog.debug.LogRecord} */ (buffer[i]));
+  } while (i != curIndex);
+};
+
diff --git a/lib/goog/debug/logger.js b/lib/goog/debug/logger.js
new file mode 100644
index 0000000..5ced90a
--- /dev/null
+++ b/lib/goog/debug/logger.js
@@ -0,0 +1,873 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Definition of the Logger class. Please minimize dependencies
+ * this file has on other closure classes as any dependency it takes won't be
+ * able to use the logging infrastructure.
+ *
+ * @see ../demos/debug.html
+ */
+
+goog.provide('goog.debug.LogManager');
+goog.provide('goog.debug.Loggable');
+goog.provide('goog.debug.Logger');
+goog.provide('goog.debug.Logger.Level');
+
+goog.require('goog.array');
+goog.require('goog.asserts');
+goog.require('goog.debug');
+goog.require('goog.debug.LogBuffer');
+goog.require('goog.debug.LogRecord');
+
+
+/**
+ * A message value that can be handled by a Logger.
+ *
+ * Functions are treated like callbacks, but are only called when the event's
+ * log level is enabled. This is useful for logging messages that are expensive
+ * to construct.
+ *
+ * @typedef {string|function(): string}
+ */
+goog.debug.Loggable;
+
+
+
+/**
+ * The Logger is an object used for logging debug messages. Loggers are
+ * normally named, using a hierarchical dot-separated namespace. Logger names
+ * can be arbitrary strings, but they should normally be based on the package
+ * name or class name of the logged component, such as goog.net.BrowserChannel.
+ *
+ * The Logger object is loosely based on the java class
+ * java.util.logging.Logger. It supports different levels of filtering for
+ * different loggers.
+ *
+ * The logger object should never be instantiated by application code. It
+ * should always use the goog.debug.Logger.getLogger function.
+ *
+ * @constructor
+ * @param {string} name The name of the Logger.
+ * @final
+ */
+goog.debug.Logger = function(name) {
+  /**
+   * Name of the Logger. Generally a dot-separated namespace
+   * @private {string}
+   */
+  this.name_ = name;
+
+  /**
+   * Parent Logger.
+   * @private {goog.debug.Logger}
+   */
+  this.parent_ = null;
+
+  /**
+   * Level that this logger only filters above. Null indicates it should
+   * inherit from the parent.
+   * @private {goog.debug.Logger.Level}
+   */
+  this.level_ = null;
+
+  /**
+   * Map of children loggers. The keys are the leaf names of the children and
+   * the values are the child loggers.
+   * @private {Object}
+   */
+  this.children_ = null;
+
+  /**
+   * Handlers that are listening to this logger.
+   * @private {Array<Function>}
+   */
+  this.handlers_ = null;
+};
+
+
+/** @const */
+goog.debug.Logger.ROOT_LOGGER_NAME = '';
+
+
+/**
+ * @define {boolean} Toggles whether loggers other than the root logger can have
+ *     log handlers attached to them and whether they can have their log level
+ *     set. Logging is a bit faster when this is set to false.
+ */
+goog.define('goog.debug.Logger.ENABLE_HIERARCHY', true);
+
+
+if (!goog.debug.Logger.ENABLE_HIERARCHY) {
+  /**
+   * @type {!Array<Function>}
+   * @private
+   */
+  goog.debug.Logger.rootHandlers_ = [];
+
+
+  /**
+   * @type {goog.debug.Logger.Level}
+   * @private
+   */
+  goog.debug.Logger.rootLevel_;
+}
+
+
+
+/**
+ * The Level class defines a set of standard logging levels that
+ * can be used to control logging output.  The logging Level objects
+ * are ordered and are specified by ordered integers.  Enabling logging
+ * at a given level also enables logging at all higher levels.
+ * <p>
+ * Clients should normally use the predefined Level constants such
+ * as Level.SEVERE.
+ * <p>
+ * The levels in descending order are:
+ * <ul>
+ * <li>SEVERE (highest value)
+ * <li>WARNING
+ * <li>INFO
+ * <li>CONFIG
+ * <li>FINE
+ * <li>FINER
+ * <li>FINEST  (lowest value)
+ * </ul>
+ * In addition there is a level OFF that can be used to turn
+ * off logging, and a level ALL that can be used to enable
+ * logging of all messages.
+ *
+ * @param {string} name The name of the level.
+ * @param {number} value The numeric value of the level.
+ * @constructor
+ * @final
+ */
+goog.debug.Logger.Level = function(name, value) {
+  /**
+   * The name of the level
+   * @type {string}
+   */
+  this.name = name;
+
+  /**
+   * The numeric value of the level
+   * @type {number}
+   */
+  this.value = value;
+};
+
+
+/**
+ * @return {string} String representation of the logger level.
+ * @override
+ */
+goog.debug.Logger.Level.prototype.toString = function() {
+  return this.name;
+};
+
+
+/**
+ * OFF is a special level that can be used to turn off logging.
+ * This level is initialized to <CODE>Infinity</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.OFF =
+    new goog.debug.Logger.Level('OFF', Infinity);
+
+
+/**
+ * SHOUT is a message level for extra debugging loudness.
+ * This level is initialized to <CODE>1200</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.SHOUT = new goog.debug.Logger.Level('SHOUT', 1200);
+
+
+/**
+ * SEVERE is a message level indicating a serious failure.
+ * This level is initialized to <CODE>1000</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.SEVERE = new goog.debug.Logger.Level('SEVERE', 1000);
+
+
+/**
+ * WARNING is a message level indicating a potential problem.
+ * This level is initialized to <CODE>900</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.WARNING = new goog.debug.Logger.Level('WARNING', 900);
+
+
+/**
+ * INFO is a message level for informational messages.
+ * This level is initialized to <CODE>800</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.INFO = new goog.debug.Logger.Level('INFO', 800);
+
+
+/**
+ * CONFIG is a message level for static configuration messages.
+ * This level is initialized to <CODE>700</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.CONFIG = new goog.debug.Logger.Level('CONFIG', 700);
+
+
+/**
+ * FINE is a message level providing tracing information.
+ * This level is initialized to <CODE>500</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.FINE = new goog.debug.Logger.Level('FINE', 500);
+
+
+/**
+ * FINER indicates a fairly detailed tracing message.
+ * This level is initialized to <CODE>400</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.FINER = new goog.debug.Logger.Level('FINER', 400);
+
+/**
+ * FINEST indicates a highly detailed tracing message.
+ * This level is initialized to <CODE>300</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+
+goog.debug.Logger.Level.FINEST = new goog.debug.Logger.Level('FINEST', 300);
+
+
+/**
+ * ALL indicates that all messages should be logged.
+ * This level is initialized to <CODE>0</CODE>.
+ * @type {!goog.debug.Logger.Level}
+ */
+goog.debug.Logger.Level.ALL = new goog.debug.Logger.Level('ALL', 0);
+
+
+/**
+ * The predefined levels.
+ * @type {!Array<!goog.debug.Logger.Level>}
+ * @final
+ */
+goog.debug.Logger.Level.PREDEFINED_LEVELS = [
+  goog.debug.Logger.Level.OFF,
+  goog.debug.Logger.Level.SHOUT,
+  goog.debug.Logger.Level.SEVERE,
+  goog.debug.Logger.Level.WARNING,
+  goog.debug.Logger.Level.INFO,
+  goog.debug.Logger.Level.CONFIG,
+  goog.debug.Logger.Level.FINE,
+  goog.debug.Logger.Level.FINER,
+  goog.debug.Logger.Level.FINEST,
+  goog.debug.Logger.Level.ALL];
+
+
+/**
+ * A lookup map used to find the level object based on the name or value of
+ * the level object.
+ * @type {Object}
+ * @private
+ */
+goog.debug.Logger.Level.predefinedLevelsCache_ = null;
+
+
+/**
+ * Creates the predefined levels cache and populates it.
+ * @private
+ */
+goog.debug.Logger.Level.createPredefinedLevelsCache_ = function() {
+  goog.debug.Logger.Level.predefinedLevelsCache_ = {};
+  for (var i = 0, level; level = goog.debug.Logger.Level.PREDEFINED_LEVELS[i];
+       i++) {
+    goog.debug.Logger.Level.predefinedLevelsCache_[level.value] = level;
+    goog.debug.Logger.Level.predefinedLevelsCache_[level.name] = level;
+  }
+};
+
+
+/**
+ * Gets the predefined level with the given name.
+ * @param {string} name The name of the level.
+ * @return {goog.debug.Logger.Level} The level, or null if none found.
+ */
+goog.debug.Logger.Level.getPredefinedLevel = function(name) {
+  if (!goog.debug.Logger.Level.predefinedLevelsCache_) {
+    goog.debug.Logger.Level.createPredefinedLevelsCache_();
+  }
+
+  return goog.debug.Logger.Level.predefinedLevelsCache_[name] || null;
+};
+
+
+/**
+ * Gets the highest predefined level <= #value.
+ * @param {number} value Level value.
+ * @return {goog.debug.Logger.Level} The level, or null if none found.
+ */
+goog.debug.Logger.Level.getPredefinedLevelByValue = function(value) {
+  if (!goog.debug.Logger.Level.predefinedLevelsCache_) {
+    goog.debug.Logger.Level.createPredefinedLevelsCache_();
+  }
+
+  if (value in goog.debug.Logger.Level.predefinedLevelsCache_) {
+    return goog.debug.Logger.Level.predefinedLevelsCache_[value];
+  }
+
+  for (var i = 0; i < goog.debug.Logger.Level.PREDEFINED_LEVELS.length; ++i) {
+    var level = goog.debug.Logger.Level.PREDEFINED_LEVELS[i];
+    if (level.value <= value) {
+      return level;
+    }
+  }
+  return null;
+};
+
+
+/**
+ * Finds or creates a logger for a named subsystem. If a logger has already been
+ * created with the given name it is returned. Otherwise a new logger is
+ * created. If a new logger is created its log level will be configured based
+ * on the LogManager configuration and it will configured to also send logging
+ * output to its parent's handlers. It will be registered in the LogManager
+ * global namespace.
+ *
+ * @param {string} name A name for the logger. This should be a dot-separated
+ * name and should normally be based on the package name or class name of the
+ * subsystem, such as goog.net.BrowserChannel.
+ * @return {!goog.debug.Logger} The named logger.
+ * @deprecated use goog.log instead. http://go/goog-debug-logger-deprecated
+ */
+goog.debug.Logger.getLogger = function(name) {
+  return goog.debug.LogManager.getLogger(name);
+};
+
+
+/**
+ * Logs a message to profiling tools, if available.
+ * {@see https://developers.google.com/web-toolkit/speedtracer/logging-api}
+ * {@see http://msdn.microsoft.com/en-us/library/dd433074(VS.85).aspx}
+ * @param {string} msg The message to log.
+ */
+goog.debug.Logger.logToProfilers = function(msg) {
+  // Using goog.global, as loggers might be used in window-less contexts.
+  if (goog.global['console']) {
+    if (goog.global['console']['timeStamp']) {
+      // Logs a message to Firebug, Web Inspector, SpeedTracer, etc.
+      goog.global['console']['timeStamp'](msg);
+    } else if (goog.global['console']['markTimeline']) {
+      // TODO(user): markTimeline is deprecated. Drop this else clause entirely
+      // after Chrome M14 hits stable.
+      goog.global['console']['markTimeline'](msg);
+    }
+  }
+
+  if (goog.global['msWriteProfilerMark']) {
+    // Logs a message to the Microsoft profiler
+    goog.global['msWriteProfilerMark'](msg);
+  }
+};
+
+
+/**
+ * Gets the name of this logger.
+ * @return {string} The name of this logger.
+ */
+goog.debug.Logger.prototype.getName = function() {
+  return this.name_;
+};
+
+
+/**
+ * Adds a handler to the logger. This doesn't use the event system because
+ * we want to be able to add logging to the event system.
+ * @param {Function} handler Handler function to add.
+ */
+goog.debug.Logger.prototype.addHandler = function(handler) {
+  if (goog.debug.LOGGING_ENABLED) {
+    if (goog.debug.Logger.ENABLE_HIERARCHY) {
+      if (!this.handlers_) {
+        this.handlers_ = [];
+      }
+      this.handlers_.push(handler);
+    } else {
+      goog.asserts.assert(!this.name_,
+          'Cannot call addHandler on a non-root logger when ' +
+          'goog.debug.Logger.ENABLE_HIERARCHY is false.');
+      goog.debug.Logger.rootHandlers_.push(handler);
+    }
+  }
+};
+
+
+/**
+ * Removes a handler from the logger. This doesn't use the event system because
+ * we want to be able to add logging to the event system.
+ * @param {Function} handler Handler function to remove.
+ * @return {boolean} Whether the handler was removed.
+ */
+goog.debug.Logger.prototype.removeHandler = function(handler) {
+  if (goog.debug.LOGGING_ENABLED) {
+    var handlers = goog.debug.Logger.ENABLE_HIERARCHY ? this.handlers_ :
+        goog.debug.Logger.rootHandlers_;
+    return !!handlers && goog.array.remove(handlers, handler);
+  } else {
+    return false;
+  }
+};
+
+
+/**
+ * Returns the parent of this logger.
+ * @return {goog.debug.Logger} The parent logger or null if this is the root.
+ */
+goog.debug.Logger.prototype.getParent = function() {
+  return this.parent_;
+};
+
+
+/**
+ * Returns the children of this logger as a map of the child name to the logger.
+ * @return {!Object} The map where the keys are the child leaf names and the
+ *     values are the Logger objects.
+ */
+goog.debug.Logger.prototype.getChildren = function() {
+  if (!this.children_) {
+    this.children_ = {};
+  }
+  return this.children_;
+};
+
+
+/**
+ * Set the log level specifying which message levels will be logged by this
+ * logger. Message levels lower than this value will be discarded.
+ * The level value Level.OFF can be used to turn off logging. If the new level
+ * is null, it means that this node should inherit its level from its nearest
+ * ancestor with a specific (non-null) level value.
+ *
+ * @param {goog.debug.Logger.Level} level The new level.
+ */
+goog.debug.Logger.prototype.setLevel = function(level) {
+  if (goog.debug.LOGGING_ENABLED) {
+    if (goog.debug.Logger.ENABLE_HIERARCHY) {
+      this.level_ = level;
+    } else {
+      goog.asserts.assert(!this.name_,
+          'Cannot call setLevel() on a non-root logger when ' +
+          'goog.debug.Logger.ENABLE_HIERARCHY is false.');
+      goog.debug.Logger.rootLevel_ = level;
+    }
+  }
+};
+
+
+/**
+ * Gets the log level specifying which message levels will be logged by this
+ * logger. Message levels lower than this value will be discarded.
+ * The level value Level.OFF can be used to turn off logging. If the level
+ * is null, it means that this node should inherit its level from its nearest
+ * ancestor with a specific (non-null) level value.
+ *
+ * @return {goog.debug.Logger.Level} The level.
+ */
+goog.debug.Logger.prototype.getLevel = function() {
+  return goog.debug.LOGGING_ENABLED ?
+      this.level_ : goog.debug.Logger.Level.OFF;
+};
+
+
+/**
+ * Returns the effective level of the logger based on its ancestors' levels.
+ * @return {goog.debug.Logger.Level} The level.
+ */
+goog.debug.Logger.prototype.getEffectiveLevel = function() {
+  if (!goog.debug.LOGGING_ENABLED) {
+    return goog.debug.Logger.Level.OFF;
+  }
+
+  if (!goog.debug.Logger.ENABLE_HIERARCHY) {
+    return goog.debug.Logger.rootLevel_;
+  }
+  if (this.level_) {
+    return this.level_;
+  }
+  if (this.parent_) {
+    return this.parent_.getEffectiveLevel();
+  }
+  goog.asserts.fail('Root logger has no level set.');
+  return null;
+};
+
+
+/**
+ * Checks if a message of the given level would actually be logged by this
+ * logger. This check is based on the Loggers effective level, which may be
+ * inherited from its parent.
+ * @param {goog.debug.Logger.Level} level The level to check.
+ * @return {boolean} Whether the message would be logged.
+ */
+goog.debug.Logger.prototype.isLoggable = function(level) {
+  return goog.debug.LOGGING_ENABLED &&
+      level.value >= this.getEffectiveLevel().value;
+};
+
+
+/**
+ * Logs a message. If the logger is currently enabled for the
+ * given message level then the given message is forwarded to all the
+ * registered output Handler objects.
+ * @param {goog.debug.Logger.Level} level One of the level identifiers.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error|Object=} opt_exception An exception associated with the
+ *     message.
+ */
+goog.debug.Logger.prototype.log = function(level, msg, opt_exception) {
+  // java caches the effective level, not sure it's necessary here
+  if (goog.debug.LOGGING_ENABLED && this.isLoggable(level)) {
+    // Message callbacks can be useful when a log message is expensive to build.
+    if (goog.isFunction(msg)) {
+      msg = msg();
+    }
+
+    this.doLogRecord_(this.getLogRecord(level, msg, opt_exception));
+  }
+};
+
+
+/**
+ * Creates a new log record and adds the exception (if present) to it.
+ * @param {goog.debug.Logger.Level} level One of the level identifiers.
+ * @param {string} msg The string message.
+ * @param {Error|Object=} opt_exception An exception associated with the
+ *     message.
+ * @return {!goog.debug.LogRecord} A log record.
+ * @suppress {es5Strict}
+ */
+goog.debug.Logger.prototype.getLogRecord = function(
+    level, msg, opt_exception) {
+  if (goog.debug.LogBuffer.isBufferingEnabled()) {
+    var logRecord =
+        goog.debug.LogBuffer.getInstance().addRecord(level, msg, this.name_);
+  } else {
+    logRecord = new goog.debug.LogRecord(level, String(msg), this.name_);
+  }
+  if (opt_exception) {
+    logRecord.setException(opt_exception);
+  }
+  return logRecord;
+};
+
+
+/**
+ * Logs a message at the Logger.Level.SHOUT level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.debug.Logger.prototype.shout = function(msg, opt_exception) {
+  if (goog.debug.LOGGING_ENABLED) {
+    this.log(goog.debug.Logger.Level.SHOUT, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Logger.Level.SEVERE level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.debug.Logger.prototype.severe = function(msg, opt_exception) {
+  if (goog.debug.LOGGING_ENABLED) {
+    this.log(goog.debug.Logger.Level.SEVERE, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Logger.Level.WARNING level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.debug.Logger.prototype.warning = function(msg, opt_exception) {
+  if (goog.debug.LOGGING_ENABLED) {
+    this.log(goog.debug.Logger.Level.WARNING, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Logger.Level.INFO level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.debug.Logger.prototype.info = function(msg, opt_exception) {
+  if (goog.debug.LOGGING_ENABLED) {
+    this.log(goog.debug.Logger.Level.INFO, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Logger.Level.CONFIG level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.debug.Logger.prototype.config = function(msg, opt_exception) {
+  if (goog.debug.LOGGING_ENABLED) {
+    this.log(goog.debug.Logger.Level.CONFIG, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Logger.Level.FINE level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.debug.Logger.prototype.fine = function(msg, opt_exception) {
+  if (goog.debug.LOGGING_ENABLED) {
+    this.log(goog.debug.Logger.Level.FINE, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Logger.Level.FINER level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.debug.Logger.prototype.finer = function(msg, opt_exception) {
+  if (goog.debug.LOGGING_ENABLED) {
+    this.log(goog.debug.Logger.Level.FINER, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Logger.Level.FINEST level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.debug.Logger.prototype.finest = function(msg, opt_exception) {
+  if (goog.debug.LOGGING_ENABLED) {
+    this.log(goog.debug.Logger.Level.FINEST, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a LogRecord. If the logger is currently enabled for the
+ * given message level then the given message is forwarded to all the
+ * registered output Handler objects.
+ * @param {goog.debug.LogRecord} logRecord A log record to log.
+ */
+goog.debug.Logger.prototype.logRecord = function(logRecord) {
+  if (goog.debug.LOGGING_ENABLED && this.isLoggable(logRecord.getLevel())) {
+    this.doLogRecord_(logRecord);
+  }
+};
+
+
+/**
+ * Logs a LogRecord.
+ * @param {goog.debug.LogRecord} logRecord A log record to log.
+ * @private
+ */
+goog.debug.Logger.prototype.doLogRecord_ = function(logRecord) {
+  goog.debug.Logger.logToProfilers('log:' + logRecord.getMessage());
+  if (goog.debug.Logger.ENABLE_HIERARCHY) {
+    var target = this;
+    while (target) {
+      target.callPublish_(logRecord);
+      target = target.getParent();
+    }
+  } else {
+    for (var i = 0, handler; handler = goog.debug.Logger.rootHandlers_[i++]; ) {
+      handler(logRecord);
+    }
+  }
+};
+
+
+/**
+ * Calls the handlers for publish.
+ * @param {goog.debug.LogRecord} logRecord The log record to publish.
+ * @private
+ */
+goog.debug.Logger.prototype.callPublish_ = function(logRecord) {
+  if (this.handlers_) {
+    for (var i = 0, handler; handler = this.handlers_[i]; i++) {
+      handler(logRecord);
+    }
+  }
+};
+
+
+/**
+ * Sets the parent of this logger. This is used for setting up the logger tree.
+ * @param {goog.debug.Logger} parent The parent logger.
+ * @private
+ */
+goog.debug.Logger.prototype.setParent_ = function(parent) {
+  this.parent_ = parent;
+};
+
+
+/**
+ * Adds a child to this logger. This is used for setting up the logger tree.
+ * @param {string} name The leaf name of the child.
+ * @param {goog.debug.Logger} logger The child logger.
+ * @private
+ */
+goog.debug.Logger.prototype.addChild_ = function(name, logger) {
+  this.getChildren()[name] = logger;
+};
+
+
+/**
+ * There is a single global LogManager object that is used to maintain a set of
+ * shared state about Loggers and log services. This is loosely based on the
+ * java class java.util.logging.LogManager.
+ * @const
+ */
+goog.debug.LogManager = {};
+
+
+/**
+ * Map of logger names to logger objects.
+ *
+ * @type {!Object<string, !goog.debug.Logger>}
+ * @private
+ */
+goog.debug.LogManager.loggers_ = {};
+
+
+/**
+ * The root logger which is the root of the logger tree.
+ * @type {goog.debug.Logger}
+ * @private
+ */
+goog.debug.LogManager.rootLogger_ = null;
+
+
+/**
+ * Initializes the LogManager if not already initialized.
+ */
+goog.debug.LogManager.initialize = function() {
+  if (!goog.debug.LogManager.rootLogger_) {
+    goog.debug.LogManager.rootLogger_ = new goog.debug.Logger(
+        goog.debug.Logger.ROOT_LOGGER_NAME);
+    goog.debug.LogManager.loggers_[goog.debug.Logger.ROOT_LOGGER_NAME] =
+        goog.debug.LogManager.rootLogger_;
+    goog.debug.LogManager.rootLogger_.setLevel(goog.debug.Logger.Level.CONFIG);
+  }
+};
+
+
+/**
+ * Returns all the loggers.
+ * @return {!Object<string, !goog.debug.Logger>} Map of logger names to logger
+ *     objects.
+ */
+goog.debug.LogManager.getLoggers = function() {
+  return goog.debug.LogManager.loggers_;
+};
+
+
+/**
+ * Returns the root of the logger tree namespace, the logger with the empty
+ * string as its name.
+ *
+ * @return {!goog.debug.Logger} The root logger.
+ */
+goog.debug.LogManager.getRoot = function() {
+  goog.debug.LogManager.initialize();
+  return /** @type {!goog.debug.Logger} */ (goog.debug.LogManager.rootLogger_);
+};
+
+
+/**
+ * Finds a named logger.
+ *
+ * @param {string} name A name for the logger. This should be a dot-separated
+ * name and should normally be based on the package name or class name of the
+ * subsystem, such as goog.net.BrowserChannel.
+ * @return {!goog.debug.Logger} The named logger.
+ */
+goog.debug.LogManager.getLogger = function(name) {
+  goog.debug.LogManager.initialize();
+  var ret = goog.debug.LogManager.loggers_[name];
+  return ret || goog.debug.LogManager.createLogger_(name);
+};
+
+
+/**
+ * Creates a function that can be passed to goog.debug.catchErrors. The function
+ * will log all reported errors using the given logger.
+ * @param {goog.debug.Logger=} opt_logger The logger to log the errors to.
+ *     Defaults to the root logger.
+ * @return {function(Object)} The created function.
+ */
+goog.debug.LogManager.createFunctionForCatchErrors = function(opt_logger) {
+  return function(info) {
+    var logger = opt_logger || goog.debug.LogManager.getRoot();
+    logger.severe('Error: ' + info.message + ' (' + info.fileName +
+                  ' @ Line: ' + info.line + ')');
+  };
+};
+
+
+/**
+ * Creates the named logger. Will also create the parents of the named logger
+ * if they don't yet exist.
+ * @param {string} name The name of the logger.
+ * @return {!goog.debug.Logger} The named logger.
+ * @private
+ */
+goog.debug.LogManager.createLogger_ = function(name) {
+  // find parent logger
+  var logger = new goog.debug.Logger(name);
+  if (goog.debug.Logger.ENABLE_HIERARCHY) {
+    var lastDotIndex = name.lastIndexOf('.');
+    var parentName = name.substr(0, lastDotIndex);
+    var leafName = name.substr(lastDotIndex + 1);
+    var parentLogger = goog.debug.LogManager.getLogger(parentName);
+
+    // tell the parent about the child and the child about the parent
+    parentLogger.addChild_(leafName, logger);
+    logger.setParent_(parentLogger);
+  }
+
+  goog.debug.LogManager.loggers_[name] = logger;
+  return logger;
+};
diff --git a/lib/goog/debug/logrecord.js b/lib/goog/debug/logrecord.js
new file mode 100644
index 0000000..df5f982
--- /dev/null
+++ b/lib/goog/debug/logrecord.js
@@ -0,0 +1,242 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Definition of the LogRecord class. Please minimize
+ * dependencies this file has on other closure classes as any dependency it
+ * takes won't be able to use the logging infrastructure.
+ *
+ */
+
+goog.provide('goog.debug.LogRecord');
+
+
+
+/**
+ * LogRecord objects are used to pass logging requests between
+ * the logging framework and individual log Handlers.
+ * @constructor
+ * @param {goog.debug.Logger.Level} level One of the level identifiers.
+ * @param {string} msg The string message.
+ * @param {string} loggerName The name of the source logger.
+ * @param {number=} opt_time Time this log record was created if other than now.
+ *     If 0, we use #goog.now.
+ * @param {number=} opt_sequenceNumber Sequence number of this log record. This
+ *     should only be passed in when restoring a log record from persistence.
+ */
+goog.debug.LogRecord = function(level, msg, loggerName,
+    opt_time, opt_sequenceNumber) {
+  this.reset(level, msg, loggerName, opt_time, opt_sequenceNumber);
+};
+
+
+/**
+ * Time the LogRecord was created.
+ * @type {number}
+ * @private
+ */
+goog.debug.LogRecord.prototype.time_;
+
+
+/**
+ * Level of the LogRecord
+ * @type {goog.debug.Logger.Level}
+ * @private
+ */
+goog.debug.LogRecord.prototype.level_;
+
+
+/**
+ * Message associated with the record
+ * @type {string}
+ * @private
+ */
+goog.debug.LogRecord.prototype.msg_;
+
+
+/**
+ * Name of the logger that created the record.
+ * @type {string}
+ * @private
+ */
+goog.debug.LogRecord.prototype.loggerName_;
+
+
+/**
+ * Sequence number for the LogRecord. Each record has a unique sequence number
+ * that is greater than all log records created before it.
+ * @type {number}
+ * @private
+ */
+goog.debug.LogRecord.prototype.sequenceNumber_ = 0;
+
+
+/**
+ * Exception associated with the record
+ * @type {Object}
+ * @private
+ */
+goog.debug.LogRecord.prototype.exception_ = null;
+
+
+/**
+ * @define {boolean} Whether to enable log sequence numbers.
+ */
+goog.define('goog.debug.LogRecord.ENABLE_SEQUENCE_NUMBERS', true);
+
+
+/**
+ * A sequence counter for assigning increasing sequence numbers to LogRecord
+ * objects.
+ * @type {number}
+ * @private
+ */
+goog.debug.LogRecord.nextSequenceNumber_ = 0;
+
+
+/**
+ * Sets all fields of the log record.
+ * @param {goog.debug.Logger.Level} level One of the level identifiers.
+ * @param {string} msg The string message.
+ * @param {string} loggerName The name of the source logger.
+ * @param {number=} opt_time Time this log record was created if other than now.
+ *     If 0, we use #goog.now.
+ * @param {number=} opt_sequenceNumber Sequence number of this log record. This
+ *     should only be passed in when restoring a log record from persistence.
+ */
+goog.debug.LogRecord.prototype.reset = function(level, msg, loggerName,
+    opt_time, opt_sequenceNumber) {
+  if (goog.debug.LogRecord.ENABLE_SEQUENCE_NUMBERS) {
+    this.sequenceNumber_ = typeof opt_sequenceNumber == 'number' ?
+        opt_sequenceNumber : goog.debug.LogRecord.nextSequenceNumber_++;
+  }
+
+  this.time_ = opt_time || goog.now();
+  this.level_ = level;
+  this.msg_ = msg;
+  this.loggerName_ = loggerName;
+  delete this.exception_;
+};
+
+
+/**
+ * Get the source Logger's name.
+ *
+ * @return {string} source logger name (may be null).
+ */
+goog.debug.LogRecord.prototype.getLoggerName = function() {
+  return this.loggerName_;
+};
+
+
+/**
+ * Get the exception that is part of the log record.
+ *
+ * @return {Object} the exception.
+ */
+goog.debug.LogRecord.prototype.getException = function() {
+  return this.exception_;
+};
+
+
+/**
+ * Set the exception that is part of the log record.
+ *
+ * @param {Object} exception the exception.
+ */
+goog.debug.LogRecord.prototype.setException = function(exception) {
+  this.exception_ = exception;
+};
+
+
+/**
+ * Get the source Logger's name.
+ *
+ * @param {string} loggerName source logger name (may be null).
+ */
+goog.debug.LogRecord.prototype.setLoggerName = function(loggerName) {
+  this.loggerName_ = loggerName;
+};
+
+
+/**
+ * Get the logging message level, for example Level.SEVERE.
+ * @return {goog.debug.Logger.Level} the logging message level.
+ */
+goog.debug.LogRecord.prototype.getLevel = function() {
+  return this.level_;
+};
+
+
+/**
+ * Set the logging message level, for example Level.SEVERE.
+ * @param {goog.debug.Logger.Level} level the logging message level.
+ */
+goog.debug.LogRecord.prototype.setLevel = function(level) {
+  this.level_ = level;
+};
+
+
+/**
+ * Get the "raw" log message, before localization or formatting.
+ *
+ * @return {string} the raw message string.
+ */
+goog.debug.LogRecord.prototype.getMessage = function() {
+  return this.msg_;
+};
+
+
+/**
+ * Set the "raw" log message, before localization or formatting.
+ *
+ * @param {string} msg the raw message string.
+ */
+goog.debug.LogRecord.prototype.setMessage = function(msg) {
+  this.msg_ = msg;
+};
+
+
+/**
+ * Get event time in milliseconds since 1970.
+ *
+ * @return {number} event time in millis since 1970.
+ */
+goog.debug.LogRecord.prototype.getMillis = function() {
+  return this.time_;
+};
+
+
+/**
+ * Set event time in milliseconds since 1970.
+ *
+ * @param {number} time event time in millis since 1970.
+ */
+goog.debug.LogRecord.prototype.setMillis = function(time) {
+  this.time_ = time;
+};
+
+
+/**
+ * Get the sequence number.
+ * <p>
+ * Sequence numbers are normally assigned in the LogRecord
+ * constructor, which assigns unique sequence numbers to
+ * each new LogRecord in increasing order.
+ * @return {number} the sequence number.
+ */
+goog.debug.LogRecord.prototype.getSequenceNumber = function() {
+  return this.sequenceNumber_;
+};
+
diff --git a/lib/goog/deps.js b/lib/goog/deps.js
index fbaa2a5..56f7ad3 100644
--- a/lib/goog/deps.js
+++ b/lib/goog/deps.js
@@ -1,48 +1,151 @@
 // This file has been auto-generated; do not edit by hand
-goog.addDependency("../atoms/error.js", ["bot.Error","bot.ErrorCode"], []);
-goog.addDependency("../atoms/response.js", ["bot.response","bot.response.ResponseObject"], ["bot.Error","bot.ErrorCode"]);
-goog.addDependency("../atoms/json.js", ["bot.json"], ["bot.userAgent","goog.json","goog.userAgent"]);
-goog.addDependency("../atoms/userAgent.js", ["bot.userAgent"], ["goog.string","goog.userAgent","goog.userAgent.product","goog.userAgent.product.isVersion"]);
-goog.addDependency("string/string.js", ["goog.string","goog.string.Unicode"], []);
-goog.addDependency("useragent/useragent.js", ["goog.userAgent"], ["goog.string"]);
-goog.addDependency("useragent/product.js", ["goog.userAgent.product"], ["goog.userAgent"]);
-goog.addDependency("useragent/product_isversion.js", ["goog.userAgent.product.isVersion"], ["goog.userAgent.product"]);
-goog.addDependency("json/json.js", ["goog.json","goog.json.Serializer"], []);
-goog.addDependency("../webdriver/capabilities.js", ["webdriver.Browser","webdriver.Capabilities","webdriver.Capability"], []);
-goog.addDependency("../webdriver/logging.js", ["webdriver.logging","webdriver.logging.Preferences"], ["goog.object"]);
-goog.addDependency("object/object.js", ["goog.object"], []);
-goog.addDependency("../webdriver/actionsequence.js", ["webdriver.ActionSequence"], ["goog.array","webdriver.Button","webdriver.Command","webdriver.CommandName","webdriver.Key"]);
-goog.addDependency("array/array.js", ["goog.array","goog.array.ArrayLike"], ["goog.asserts"]);
-goog.addDependency("asserts/asserts.js", ["goog.asserts","goog.asserts.AssertionError"], ["goog.debug.Error","goog.string"]);
-goog.addDependency("debug/error.js", ["goog.debug.Error"], []);
-goog.addDependency("../webdriver/button.js", ["webdriver.Button"], []);
-goog.addDependency("../webdriver/command.js", ["webdriver.Command","webdriver.CommandExecutor","webdriver.CommandName"], []);
-goog.addDependency("../webdriver/key.js", ["webdriver.Key"], []);
-goog.addDependency("../webdriver/stacktrace.js", ["webdriver.stacktrace","webdriver.stacktrace.Snapshot"], ["goog.array","goog.string","goog.userAgent"]);
-goog.addDependency("../webdriver/locators.js", ["webdriver.By","webdriver.Locator","webdriver.Locator.Strategy"], ["goog.array","goog.object","goog.string"]);
-goog.addDependency("../webdriver/promise.js", ["webdriver.promise","webdriver.promise.ControlFlow","webdriver.promise.ControlFlow.Timer","webdriver.promise.Deferred","webdriver.promise.Promise"], ["goog.array","goog.debug.Error","goog.object","webdriver.EventEmitter","webdriver.stacktrace.Snapshot"]);
-goog.addDependency("../webdriver/events.js", ["webdriver.EventEmitter"], []);
-goog.addDependency("../webdriver/process.js", ["webdriver.process"], ["goog.Uri","goog.array","goog.json"]);
-goog.addDependency("uri/uri.js", ["goog.Uri","goog.Uri.QueryData"], ["goog.array","goog.string","goog.structs","goog.structs.Map","goog.uri.utils","goog.uri.utils.ComponentIndex","goog.uri.utils.StandardQueryParam"]);
-goog.addDependency("structs/structs.js", ["goog.structs"], ["goog.array","goog.object"]);
-goog.addDependency("structs/map.js", ["goog.structs.Map"], ["goog.iter.Iterator","goog.iter.StopIteration","goog.object"]);
-goog.addDependency("iter/iter.js", ["goog.iter","goog.iter.Iterator","goog.iter.StopIteration"], ["goog.array","goog.asserts"]);
-goog.addDependency("uri/utils.js", ["goog.uri.utils","goog.uri.utils.ComponentIndex","goog.uri.utils.QueryArray","goog.uri.utils.QueryValue","goog.uri.utils.StandardQueryParam"], ["goog.asserts","goog.string","goog.userAgent"]);
-goog.addDependency("../webdriver/webdriver.js", ["webdriver.Alert","webdriver.UnhandledAlertError","webdriver.WebDriver","webdriver.WebElement"], ["bot.Error","bot.ErrorCode","bot.response","goog.array","goog.object","webdriver.ActionSequence","webdriver.Command","webdriver.CommandName","webdriver.Key","webdriver.Locator","webdriver.Session","webdriver.logging","webdriver.promise"]);
-goog.addDependency("../webdriver/session.js", ["webdriver.Session"], ["webdriver.Capabilities"]);
-goog.addDependency("../webdriver/builder.js", ["webdriver.Builder"], ["goog.userAgent","webdriver.AbstractBuilder","webdriver.FirefoxDomExecutor","webdriver.WebDriver","webdriver.http.CorsClient","webdriver.http.Executor","webdriver.http.XhrClient","webdriver.process"]);
-goog.addDependency("../webdriver/abstractbuilder.js", ["webdriver.AbstractBuilder"], ["webdriver.Capabilities","webdriver.process"]);
-goog.addDependency("../webdriver/firefoxdomexecutor.js", ["webdriver.FirefoxDomExecutor"], ["bot.response","goog.json","goog.userAgent.product","webdriver.Command","webdriver.CommandName"]);
-goog.addDependency("../webdriver/http/corsclient.js", ["webdriver.http.CorsClient"], ["goog.json","webdriver.http.Response"]);
-goog.addDependency("../webdriver/http/http.js", ["webdriver.http.Client","webdriver.http.Executor","webdriver.http.Request","webdriver.http.Response"], ["bot.ErrorCode","goog.array","goog.json","webdriver.CommandName","webdriver.promise.Deferred"]);
-goog.addDependency("../webdriver/http/xhrclient.js", ["webdriver.http.XhrClient"], ["goog.json","goog.net.XmlHttp","webdriver.http.Response"]);
-goog.addDependency("net/xmlhttp.js", ["goog.net.DefaultXmlHttpFactory","goog.net.XmlHttp","goog.net.XmlHttp.OptionType","goog.net.XmlHttp.ReadyState"], ["goog.net.WrapperXmlHttpFactory","goog.net.XmlHttpFactory"]);
-goog.addDependency("net/wrapperxmlhttpfactory.js", ["goog.net.WrapperXmlHttpFactory"], ["goog.net.XmlHttpFactory"]);
-goog.addDependency("net/xmlhttpfactory.js", ["goog.net.XmlHttpFactory"], []);
-goog.addDependency("../webdriver/testing/asserts.js", ["webdriver.testing.Assertion","webdriver.testing.ContainsMatcher","webdriver.testing.NegatedAssertion","webdriver.testing.assert","webdriver.testing.asserts"], ["goog.array","goog.labs.testing.CloseToMatcher","goog.labs.testing.EndsWithMatcher","goog.labs.testing.EqualToMatcher","goog.labs.testing.EqualsMatcher","goog.labs.testing.GreaterThanEqualToMatcher","goog.labs.testing.GreaterThanMatcher","goog.labs.testing.LessThanEqualToMatcher","goog.labs.testing.LessThanMatcher","goog.labs.testing.InstanceOfMatcher","goog.labs.testing.IsNotMatcher","goog.labs.testing.IsNullMatcher","goog.labs.testing.IsNullOrUndefinedMatcher","goog.labs.testing.IsUndefinedMatcher","goog.labs.testing.Matcher","goog.labs.testing.ObjectEqualsMatcher","goog.labs.testing.RegexMatcher","goog.labs.testing.StartsWithMatcher","goog.labs.testing.assertThat","goog.string","webdriver.promise"]);
-goog.addDependency("labs/testing/numbermatcher.js", ["goog.labs.testing.CloseToMatcher","goog.labs.testing.EqualToMatcher","goog.labs.testing.GreaterThanEqualToMatcher","goog.labs.testing.GreaterThanMatcher","goog.labs.testing.LessThanEqualToMatcher","goog.labs.testing.LessThanMatcher"], ["goog.asserts","goog.labs.testing.Matcher"]);
-goog.addDependency("labs/testing/matcher.js", ["goog.labs.testing.Matcher"], []);
-goog.addDependency("labs/testing/stringmatcher.js", ["goog.labs.testing.ContainsStringMatcher","goog.labs.testing.EndsWithMatcher","goog.labs.testing.EqualToIgnoringCaseMatcher","goog.labs.testing.EqualToIgnoringWhitespaceMatcher","goog.labs.testing.EqualsMatcher","goog.labs.testing.RegexMatcher","goog.labs.testing.StartsWithMatcher","goog.labs.testing.StringContainsInOrderMatcher"], ["goog.asserts","goog.labs.testing.Matcher","goog.string"]);
-goog.addDependency("labs/testing/objectmatcher.js", ["goog.labs.testing.HasPropertyMatcher","goog.labs.testing.InstanceOfMatcher","goog.labs.testing.IsNullMatcher","goog.labs.testing.IsNullOrUndefinedMatcher","goog.labs.testing.IsUndefinedMatcher","goog.labs.testing.ObjectEqualsMatcher"], ["goog.labs.testing.Matcher","goog.string"]);
-goog.addDependency("labs/testing/logicmatcher.js", ["goog.labs.testing.AllOfMatcher","goog.labs.testing.AnyOfMatcher","goog.labs.testing.IsNotMatcher"], ["goog.array","goog.labs.testing.Matcher"]);
-goog.addDependency("labs/testing/assertthat.js", ["goog.labs.testing.MatcherError","goog.labs.testing.assertThat"], ["goog.asserts","goog.debug.Error","goog.labs.testing.Matcher"]);
+goog.addDependency("../webdriver/test/builder_test.js", [], ["goog.testing.jsunit","webdriver.Builder"], false);
+goog.addDependency("testing/jsunit.js", ["goog.testing.jsunit"], ["goog.dom.TagName","goog.testing.TestCase","goog.testing.TestRunner"], false);
+goog.addDependency("dom/tagname.js", ["goog.dom.TagName"], [], false);
+goog.addDependency("testing/testcase.js", ["goog.testing.TestCase","goog.testing.TestCase.Error","goog.testing.TestCase.Order","goog.testing.TestCase.Result","goog.testing.TestCase.Test"], ["goog.Promise","goog.Thenable","goog.asserts","goog.dom.TagName","goog.object","goog.testing.asserts","goog.testing.stacktrace"], false);
+goog.addDependency("promise/promise.js", ["goog.Promise"], ["goog.Thenable","goog.asserts","goog.async.FreeList","goog.async.run","goog.async.throwException","goog.debug.Error","goog.promise.Resolver"], false);
+goog.addDependency("promise/thenable.js", ["goog.Thenable"], [], false);
+goog.addDependency("asserts/asserts.js", ["goog.asserts","goog.asserts.AssertionError"], ["goog.debug.Error","goog.dom.NodeType","goog.string"], false);
+goog.addDependency("debug/error.js", ["goog.debug.Error"], [], false);
+goog.addDependency("dom/nodetype.js", ["goog.dom.NodeType"], [], false);
+goog.addDependency("string/string.js", ["goog.string","goog.string.Unicode"], [], false);
+goog.addDependency("async/freelist.js", ["goog.async.FreeList"], [], false);
+goog.addDependency("async/run.js", ["goog.async.run"], ["goog.async.WorkQueue","goog.async.nextTick","goog.async.throwException"], false);
+goog.addDependency("async/workqueue.js", ["goog.async.WorkItem","goog.async.WorkQueue"], ["goog.asserts","goog.async.FreeList"], false);
+goog.addDependency("async/nexttick.js", ["goog.async.nextTick","goog.async.throwException"], ["goog.debug.entryPointRegistry","goog.dom.TagName","goog.functions","goog.labs.userAgent.browser","goog.labs.userAgent.engine"], false);
+goog.addDependency("debug/entrypointregistry.js", ["goog.debug.EntryPointMonitor","goog.debug.entryPointRegistry"], ["goog.asserts"], false);
+goog.addDependency("functions/functions.js", ["goog.functions"], [], false);
+goog.addDependency("labs/useragent/browser.js", ["goog.labs.userAgent.browser"], ["goog.array","goog.labs.userAgent.util","goog.object","goog.string"], false);
+goog.addDependency("array/array.js", ["goog.array","goog.array.ArrayLike"], ["goog.asserts"], false);
+goog.addDependency("labs/useragent/util.js", ["goog.labs.userAgent.util"], ["goog.string"], false);
+goog.addDependency("object/object.js", ["goog.object"], [], false);
+goog.addDependency("labs/useragent/engine.js", ["goog.labs.userAgent.engine"], ["goog.array","goog.labs.userAgent.util","goog.string"], false);
+goog.addDependency("promise/resolver.js", ["goog.promise.Resolver"], [], false);
+goog.addDependency("testing/asserts.js", ["goog.testing.JsUnitException","goog.testing.asserts","goog.testing.asserts.ArrayLike"], ["goog.testing.stacktrace"], false);
+goog.addDependency("testing/stacktrace.js", ["goog.testing.stacktrace","goog.testing.stacktrace.Frame"], [], false);
+goog.addDependency("testing/testrunner.js", ["goog.testing.TestRunner"], ["goog.dom.TagName","goog.testing.TestCase"], false);
+goog.addDependency("../webdriver/builder.js", ["webdriver.Builder"], ["goog.Uri","goog.userAgent","webdriver.Capabilities","webdriver.FirefoxDomExecutor","webdriver.WebDriver","webdriver.http.CorsClient","webdriver.http.Executor","webdriver.http.XhrClient"], false);
+goog.addDependency("uri/uri.js", ["goog.Uri","goog.Uri.QueryData"], ["goog.array","goog.string","goog.structs","goog.structs.Map","goog.uri.utils","goog.uri.utils.ComponentIndex","goog.uri.utils.StandardQueryParam"], false);
+goog.addDependency("structs/structs.js", ["goog.structs"], ["goog.array","goog.object"], false);
+goog.addDependency("structs/map.js", ["goog.structs.Map"], ["goog.iter.Iterator","goog.iter.StopIteration","goog.object"], false);
+goog.addDependency("iter/iter.js", ["goog.iter","goog.iter.Iterable","goog.iter.Iterator","goog.iter.StopIteration"], ["goog.array","goog.asserts","goog.functions","goog.math"], false);
+goog.addDependency("math/math.js", ["goog.math"], ["goog.array","goog.asserts"], false);
+goog.addDependency("uri/utils.js", ["goog.uri.utils","goog.uri.utils.ComponentIndex","goog.uri.utils.QueryArray","goog.uri.utils.QueryValue","goog.uri.utils.StandardQueryParam"], ["goog.asserts","goog.string"], false);
+goog.addDependency("useragent/useragent.js", ["goog.userAgent"], ["goog.labs.userAgent.browser","goog.labs.userAgent.engine","goog.labs.userAgent.platform","goog.labs.userAgent.util","goog.string"], false);
+goog.addDependency("labs/useragent/platform.js", ["goog.labs.userAgent.platform"], ["goog.labs.userAgent.util","goog.string"], false);
+goog.addDependency("../webdriver/capabilities.js", ["webdriver.Browser","webdriver.Capabilities","webdriver.Capability","webdriver.ProxyConfig"], ["webdriver.Serializable","webdriver.logging"], false);
+goog.addDependency("../webdriver/serializable.js", ["webdriver.Serializable"], [], false);
+goog.addDependency("../webdriver/logging.js", ["webdriver.logging"], ["goog.debug.LogManager","goog.debug.LogRecord","goog.debug.Logger","goog.object"], true);
+goog.addDependency("debug/logger.js", ["goog.debug.LogManager","goog.debug.Loggable","goog.debug.Logger","goog.debug.Logger.Level"], ["goog.array","goog.asserts","goog.debug","goog.debug.LogBuffer","goog.debug.LogRecord"], false);
+goog.addDependency("debug/debug.js", ["goog.debug"], ["goog.array","goog.html.SafeHtml","goog.html.SafeUrl","goog.html.uncheckedconversions","goog.string.Const","goog.structs.Set","goog.userAgent"], false);
+goog.addDependency("html/safehtml.js", ["goog.html.SafeHtml"], ["goog.array","goog.asserts","goog.dom.TagName","goog.dom.tags","goog.html.SafeStyle","goog.html.SafeStyleSheet","goog.html.SafeUrl","goog.html.TrustedResourceUrl","goog.i18n.bidi.Dir","goog.i18n.bidi.DirectionalString","goog.object","goog.string","goog.string.Const","goog.string.TypedString"], false);
+goog.addDependency("dom/tags.js", ["goog.dom.tags"], ["goog.object"], false);
+goog.addDependency("html/safestyle.js", ["goog.html.SafeStyle"], ["goog.array","goog.asserts","goog.string","goog.string.Const","goog.string.TypedString"], false);
+goog.addDependency("string/const.js", ["goog.string.Const"], ["goog.asserts","goog.string.TypedString"], false);
+goog.addDependency("string/typedstring.js", ["goog.string.TypedString"], [], false);
+goog.addDependency("html/safestylesheet.js", ["goog.html.SafeStyleSheet"], ["goog.array","goog.asserts","goog.string","goog.string.Const","goog.string.TypedString"], false);
+goog.addDependency("html/safeurl.js", ["goog.html.SafeUrl"], ["goog.asserts","goog.fs.url","goog.i18n.bidi.Dir","goog.i18n.bidi.DirectionalString","goog.string.Const","goog.string.TypedString"], false);
+goog.addDependency("fs/url.js", ["goog.fs.url"], [], false);
+goog.addDependency("i18n/bidi.js", ["goog.i18n.bidi","goog.i18n.bidi.Dir","goog.i18n.bidi.DirectionalString","goog.i18n.bidi.Format"], [], false);
+goog.addDependency("html/trustedresourceurl.js", ["goog.html.TrustedResourceUrl"], ["goog.asserts","goog.i18n.bidi.Dir","goog.i18n.bidi.DirectionalString","goog.string.Const","goog.string.TypedString"], false);
+goog.addDependency("html/uncheckedconversions.js", ["goog.html.uncheckedconversions"], ["goog.asserts","goog.html.SafeHtml","goog.html.SafeScript","goog.html.SafeStyle","goog.html.SafeStyleSheet","goog.html.SafeUrl","goog.html.TrustedResourceUrl","goog.string","goog.string.Const"], false);
+goog.addDependency("html/safescript.js", ["goog.html.SafeScript"], ["goog.asserts","goog.string.Const","goog.string.TypedString"], false);
+goog.addDependency("structs/set.js", ["goog.structs.Set"], ["goog.structs","goog.structs.Collection","goog.structs.Map"], false);
+goog.addDependency("structs/collection.js", ["goog.structs.Collection"], [], false);
+goog.addDependency("debug/logbuffer.js", ["goog.debug.LogBuffer"], ["goog.asserts","goog.debug.LogRecord"], false);
+goog.addDependency("debug/logrecord.js", ["goog.debug.LogRecord"], [], false);
+goog.addDependency("../webdriver/firefoxdomexecutor.js", ["webdriver.FirefoxDomExecutor"], ["bot.response","goog.userAgent.product","webdriver.Command","webdriver.CommandExecutor","webdriver.CommandName"], false);
+goog.addDependency("../atoms/response.js", ["bot.response","bot.response.ResponseObject"], ["bot.Error","bot.ErrorCode"], false);
+goog.addDependency("../atoms/error.js", ["bot.Error","bot.ErrorCode"], [], false);
+goog.addDependency("useragent/product.js", ["goog.userAgent.product"], ["goog.labs.userAgent.browser","goog.labs.userAgent.platform","goog.userAgent"], false);
+goog.addDependency("../webdriver/command.js", ["webdriver.Command","webdriver.CommandExecutor","webdriver.CommandName"], [], false);
+goog.addDependency("../webdriver/webdriver.js", ["webdriver.Alert","webdriver.AlertPromise","webdriver.FileDetector","webdriver.UnhandledAlertError","webdriver.WebDriver","webdriver.WebElement","webdriver.WebElementPromise"], ["bot.Error","bot.ErrorCode","bot.response","goog.array","goog.object","webdriver.ActionSequence","webdriver.Command","webdriver.CommandName","webdriver.Key","webdriver.Locator","webdriver.Serializable","webdriver.Session","webdriver.TouchSequence","webdriver.logging","webdriver.promise","webdriver.until"], false);
+goog.addDependency("../webdriver/actionsequence.js", ["webdriver.ActionSequence"], ["goog.array","webdriver.Button","webdriver.Command","webdriver.CommandName","webdriver.Key"], false);
+goog.addDependency("../webdriver/button.js", ["webdriver.Button"], [], false);
+goog.addDependency("../webdriver/key.js", ["webdriver.Key"], [], false);
+goog.addDependency("../webdriver/locators.js", ["webdriver.By","webdriver.Locator","webdriver.Locator.Strategy"], ["goog.array","goog.object","goog.string"], false);
+goog.addDependency("../webdriver/session.js", ["webdriver.Session"], ["webdriver.Capabilities"], false);
+goog.addDependency("../webdriver/touchsequence.js", ["webdriver.TouchSequence"], ["goog.array","webdriver.Command","webdriver.CommandName"], false);
+goog.addDependency("../webdriver/promise.js", ["webdriver.promise"], ["goog.array","goog.asserts","goog.async.run","goog.async.throwException","goog.debug.Error","goog.log","goog.object","webdriver.EventEmitter","webdriver.stacktrace"], true);
+goog.addDependency("log/log.js", ["goog.log","goog.log.Level","goog.log.LogRecord","goog.log.Logger"], ["goog.debug","goog.debug.LogManager","goog.debug.LogRecord","goog.debug.Logger"], false);
+goog.addDependency("../webdriver/events.js", ["webdriver.EventEmitter"], [], false);
+goog.addDependency("../webdriver/stacktrace.js", ["webdriver.stacktrace","webdriver.stacktrace.Snapshot"], ["goog.array","goog.string","goog.userAgent"], false);
+goog.addDependency("../webdriver/until.js", ["webdriver.until"], ["bot.ErrorCode","goog.array","goog.string","webdriver.Locator"], false);
+goog.addDependency("../webdriver/http/corsclient.js", ["webdriver.http.CorsClient"], ["webdriver.http.Client","webdriver.http.Response"], false);
+goog.addDependency("../webdriver/http/http.js", ["webdriver.http.Client","webdriver.http.Executor","webdriver.http.Request","webdriver.http.Response"], ["bot.ErrorCode","goog.array","webdriver.CommandExecutor","webdriver.CommandName","webdriver.logging","webdriver.promise"], false);
+goog.addDependency("../webdriver/http/xhrclient.js", ["webdriver.http.XhrClient"], ["goog.net.XmlHttp","webdriver.http.Client","webdriver.http.Response"], false);
+goog.addDependency("net/xmlhttp.js", ["goog.net.DefaultXmlHttpFactory","goog.net.XmlHttp","goog.net.XmlHttp.OptionType","goog.net.XmlHttp.ReadyState","goog.net.XmlHttpDefines"], ["goog.asserts","goog.net.WrapperXmlHttpFactory","goog.net.XmlHttpFactory"], false);
+goog.addDependency("net/wrapperxmlhttpfactory.js", ["goog.net.WrapperXmlHttpFactory"], ["goog.net.XhrLike","goog.net.XmlHttpFactory"], false);
+goog.addDependency("net/xhrlike.js", ["goog.net.XhrLike"], [], false);
+goog.addDependency("net/xmlhttpfactory.js", ["goog.net.XmlHttpFactory"], ["goog.net.XhrLike"], false);
+goog.addDependency("../webdriver/test/capabilities_test.js", [], ["goog.testing.jsunit","webdriver.Capabilities"], false);
+goog.addDependency("../webdriver/test/events_test.js", [], ["goog.testing.jsunit","webdriver.EventEmitter"], false);
+goog.addDependency("../webdriver/test/locators_test.js", [], ["goog.testing.jsunit","webdriver.By","webdriver.Locator","webdriver.Locator.Strategy","webdriver.test.testutil"], false);
+goog.addDependency("../webdriver/test/testutil.js", ["webdriver.test.testutil","webdriver.test.testutil.StubError"], ["goog.array","goog.debug.Error","goog.string","goog.testing.recordFunction","webdriver.stacktrace"], false);
+goog.addDependency("testing/recordfunction.js", ["goog.testing.FunctionCall","goog.testing.recordConstructor","goog.testing.recordFunction"], ["goog.testing.asserts"], false);
+goog.addDependency("../webdriver/test/logging_test.js", [], ["goog.debug.LogRecord","goog.debug.Logger","goog.testing.jsunit","webdriver.logging"], false);
+goog.addDependency("../webdriver/test/promise_error_test.js", [], ["goog.Promise","goog.async.run","goog.testing.jsunit","goog.userAgent","goog.userAgent.product","webdriver.promise","webdriver.test.testutil"], false);
+goog.addDependency("../webdriver/test/promise_flow_test.js", [], ["goog.array","goog.string","goog.testing.jsunit","goog.userAgent","webdriver.promise","webdriver.stacktrace.Snapshot","webdriver.stacktrace","webdriver.test.testutil"], false);
+goog.addDependency("../webdriver/test/promise_test.js", [], ["goog.testing.MockClock","goog.testing.jsunit","goog.userAgent","webdriver.promise","webdriver.stacktrace","webdriver.test.testutil"], false);
+goog.addDependency("testing/mockclock.js", ["goog.testing.MockClock"], ["goog.Disposable","goog.async.run","goog.testing.PropertyReplacer","goog.testing.events","goog.testing.events.Event"], false);
+goog.addDependency("disposable/disposable.js", ["goog.Disposable","goog.dispose","goog.disposeAll"], ["goog.disposable.IDisposable"], false);
+goog.addDependency("disposable/idisposable.js", ["goog.disposable.IDisposable"], [], false);
+goog.addDependency("testing/propertyreplacer.js", ["goog.testing.PropertyReplacer"], ["goog.testing.ObjectPropertyString","goog.userAgent"], false);
+goog.addDependency("testing/objectpropertystring.js", ["goog.testing.ObjectPropertyString"], [], false);
+goog.addDependency("testing/events/events.js", ["goog.testing.events","goog.testing.events.Event"], ["goog.Disposable","goog.asserts","goog.dom.NodeType","goog.events","goog.events.BrowserEvent","goog.events.BrowserFeature","goog.events.EventTarget","goog.events.EventType","goog.events.KeyCodes","goog.object","goog.style","goog.userAgent"], false);
+goog.addDependency("events/events.js", ["goog.events","goog.events.CaptureSimulationMode","goog.events.Key","goog.events.ListenableType"], ["goog.asserts","goog.debug.entryPointRegistry","goog.events.BrowserEvent","goog.events.BrowserFeature","goog.events.Listenable","goog.events.ListenerMap"], false);
+goog.addDependency("events/browserevent.js", ["goog.events.BrowserEvent","goog.events.BrowserEvent.MouseButton"], ["goog.events.BrowserFeature","goog.events.Event","goog.events.EventType","goog.reflect","goog.userAgent"], false);
+goog.addDependency("events/browserfeature.js", ["goog.events.BrowserFeature"], ["goog.userAgent"], false);
+goog.addDependency("events/event.js", ["goog.events.Event","goog.events.EventLike"], ["goog.Disposable","goog.events.EventId"], false);
+goog.addDependency("events/eventid.js", ["goog.events.EventId"], [], false);
+goog.addDependency("events/eventtype.js", ["goog.events.EventType"], ["goog.userAgent"], false);
+goog.addDependency("reflect/reflect.js", ["goog.reflect"], [], false);
+goog.addDependency("events/listenable.js", ["goog.events.Listenable","goog.events.ListenableKey"], ["goog.events.EventId"], false);
+goog.addDependency("events/listenermap.js", ["goog.events.ListenerMap"], ["goog.array","goog.events.Listener","goog.object"], false);
+goog.addDependency("events/listener.js", ["goog.events.Listener"], ["goog.events.ListenableKey"], false);
+goog.addDependency("events/eventtarget.js", ["goog.events.EventTarget"], ["goog.Disposable","goog.asserts","goog.events","goog.events.Event","goog.events.Listenable","goog.events.ListenerMap","goog.object"], false);
+goog.addDependency("events/keycodes.js", ["goog.events.KeyCodes"], ["goog.userAgent"], false);
+goog.addDependency("style/style.js", ["goog.style"], ["goog.array","goog.asserts","goog.dom","goog.dom.NodeType","goog.dom.TagName","goog.dom.vendor","goog.math.Box","goog.math.Coordinate","goog.math.Rect","goog.math.Size","goog.object","goog.string","goog.userAgent"], false);
+goog.addDependency("dom/dom.js", ["goog.dom","goog.dom.Appendable","goog.dom.DomHelper"], ["goog.array","goog.asserts","goog.dom.BrowserFeature","goog.dom.NodeType","goog.dom.TagName","goog.dom.safe","goog.html.SafeHtml","goog.math.Coordinate","goog.math.Size","goog.object","goog.string","goog.string.Unicode","goog.userAgent"], false);
+goog.addDependency("dom/browserfeature.js", ["goog.dom.BrowserFeature"], ["goog.userAgent"], false);
+goog.addDependency("dom/safe.js", ["goog.dom.safe","goog.dom.safe.InsertAdjacentHtmlPosition"], ["goog.asserts","goog.html.SafeHtml","goog.html.SafeUrl","goog.html.TrustedResourceUrl","goog.string","goog.string.Const"], false);
+goog.addDependency("math/coordinate.js", ["goog.math.Coordinate"], ["goog.math"], false);
+goog.addDependency("math/size.js", ["goog.math.Size"], [], false);
+goog.addDependency("dom/vendor.js", ["goog.dom.vendor"], ["goog.string","goog.userAgent"], false);
+goog.addDependency("math/box.js", ["goog.math.Box"], ["goog.math.Coordinate"], false);
+goog.addDependency("math/rect.js", ["goog.math.Rect"], ["goog.math.Box","goog.math.Coordinate","goog.math.Size"], false);
+goog.addDependency("../webdriver/test/stacktrace_test.js", [], ["bot.Error","bot.ErrorCode","goog.string","goog.testing.JsUnitException","goog.testing.PropertyReplacer","goog.testing.StrictMock","goog.testing.jsunit","goog.testing.stacktrace","webdriver.stacktrace","webdriver.test.testutil"], false);
+goog.addDependency("testing/strictmock.js", ["goog.testing.StrictMock"], ["goog.array","goog.testing.Mock"], false);
+goog.addDependency("testing/mock.js", ["goog.testing.Mock","goog.testing.MockExpectation"], ["goog.array","goog.object","goog.testing.JsUnitException","goog.testing.MockInterface","goog.testing.mockmatchers"], false);
+goog.addDependency("testing/mockinterface.js", ["goog.testing.MockInterface"], [], false);
+goog.addDependency("testing/mockmatchers.js", ["goog.testing.mockmatchers","goog.testing.mockmatchers.ArgumentMatcher","goog.testing.mockmatchers.IgnoreArgument","goog.testing.mockmatchers.InstanceOf","goog.testing.mockmatchers.ObjectEquals","goog.testing.mockmatchers.RegexpMatch","goog.testing.mockmatchers.SaveArgument","goog.testing.mockmatchers.TypeOf"], ["goog.array","goog.dom","goog.testing.asserts"], false);
+goog.addDependency("../webdriver/test/test_bootstrap.js", [], [], false);
+goog.addDependency("../webdriver/test/testutil_test.js", [], ["goog.testing.jsunit","webdriver.test.testutil"], false);
+goog.addDependency("../webdriver/test/webdriver_test.js", [], ["bot.ErrorCode","goog.Promise","goog.functions","goog.testing.PropertyReplacer","goog.testing.MockControl","goog.testing.jsunit","goog.userAgent","webdriver.Capabilities","webdriver.Command","webdriver.CommandExecutor","webdriver.CommandName","webdriver.FileDetector","webdriver.WebDriver","webdriver.Serializable","webdriver.Session","webdriver.logging","webdriver.promise","webdriver.test.testutil"], false);
+goog.addDependency("testing/mockcontrol.js", ["goog.testing.MockControl"], ["goog.array","goog.testing","goog.testing.LooseMock","goog.testing.StrictMock"], false);
+goog.addDependency("testing/functionmock.js", ["goog.testing","goog.testing.FunctionMock","goog.testing.GlobalFunctionMock","goog.testing.MethodMock"], ["goog.object","goog.testing.LooseMock","goog.testing.Mock","goog.testing.PropertyReplacer","goog.testing.StrictMock"], false);
+goog.addDependency("testing/loosemock.js", ["goog.testing.LooseExpectationCollection","goog.testing.LooseMock"], ["goog.array","goog.structs.Map","goog.testing.Mock"], false);
+goog.addDependency("../webdriver/test/http/corsclient_test.js", [], ["goog.testing.MockControl","goog.testing.PropertyReplacer","goog.testing.jsunit","goog.userAgent","webdriver.http.CorsClient","webdriver.http.Request","webdriver.test.testutil"], false);
+goog.addDependency("../webdriver/test/http/http_test.js", [], ["bot.ErrorCode","goog.Uri","goog.testing.MockControl","goog.testing.jsunit","goog.userAgent","webdriver.Command","webdriver.http.Client","webdriver.http.Executor","webdriver.promise","webdriver.test.testutil"], false);
+goog.addDependency("../webdriver/test/http/xhrclient_test.js", [], ["goog.testing.MockControl","goog.testing.PropertyReplacer","goog.testing.jsunit","goog.userAgent","webdriver.http.Request","webdriver.http.XhrClient","webdriver.promise","webdriver.test.testutil"], false);
+goog.addDependency("../webdriver/test/testing/asserts_test.js", [], ["goog.testing.jsunit","goog.userAgent","webdriver.test.testutil","webdriver.testing.assert","webdriver.testing.asserts"], false);
+goog.addDependency("../webdriver/testing/asserts.js", ["webdriver.testing.Assertion","webdriver.testing.ContainsMatcher","webdriver.testing.NegatedAssertion","webdriver.testing.assert","webdriver.testing.asserts"], ["goog.array","goog.labs.testing.CloseToMatcher","goog.labs.testing.EndsWithMatcher","goog.labs.testing.EqualToMatcher","goog.labs.testing.EqualsMatcher","goog.labs.testing.GreaterThanEqualToMatcher","goog.labs.testing.GreaterThanMatcher","goog.labs.testing.LessThanEqualToMatcher","goog.labs.testing.LessThanMatcher","goog.labs.testing.InstanceOfMatcher","goog.labs.testing.IsNotMatcher","goog.labs.testing.IsNullMatcher","goog.labs.testing.IsNullOrUndefinedMatcher","goog.labs.testing.IsUndefinedMatcher","goog.labs.testing.Matcher","goog.labs.testing.ObjectEqualsMatcher","goog.labs.testing.RegexMatcher","goog.labs.testing.StartsWithMatcher","goog.labs.testing.assertThat","goog.string","webdriver.promise"], false);
+goog.addDependency("labs/testing/numbermatcher.js", ["goog.labs.testing.CloseToMatcher","goog.labs.testing.EqualToMatcher","goog.labs.testing.GreaterThanEqualToMatcher","goog.labs.testing.GreaterThanMatcher","goog.labs.testing.LessThanEqualToMatcher","goog.labs.testing.LessThanMatcher"], ["goog.asserts","goog.labs.testing.Matcher"], false);
+goog.addDependency("labs/testing/matcher.js", ["goog.labs.testing.Matcher"], [], false);
+goog.addDependency("labs/testing/stringmatcher.js", ["goog.labs.testing.ContainsStringMatcher","goog.labs.testing.EndsWithMatcher","goog.labs.testing.EqualToIgnoringWhitespaceMatcher","goog.labs.testing.EqualsMatcher","goog.labs.testing.RegexMatcher","goog.labs.testing.StartsWithMatcher","goog.labs.testing.StringContainsInOrderMatcher"], ["goog.asserts","goog.labs.testing.Matcher","goog.string"], false);
+goog.addDependency("labs/testing/objectmatcher.js", ["goog.labs.testing.HasPropertyMatcher","goog.labs.testing.InstanceOfMatcher","goog.labs.testing.IsNullMatcher","goog.labs.testing.IsNullOrUndefinedMatcher","goog.labs.testing.IsUndefinedMatcher","goog.labs.testing.ObjectEqualsMatcher"], ["goog.labs.testing.Matcher"], false);
+goog.addDependency("labs/testing/logicmatcher.js", ["goog.labs.testing.AllOfMatcher","goog.labs.testing.AnyOfMatcher","goog.labs.testing.IsNotMatcher"], ["goog.array","goog.labs.testing.Matcher"], false);
+goog.addDependency("labs/testing/assertthat.js", ["goog.labs.testing.MatcherError","goog.labs.testing.assertThat"], ["goog.debug.Error"], false);
+goog.addDependency("../webdriver/test/testing/client_test.js", [], ["goog.testing.MockControl","goog.testing.PropertyReplacer","goog.testing.jsunit","goog.userAgent","webdriver.testing.Client"], false);
+goog.addDependency("../webdriver/testing/client.js", ["webdriver.testing.Client"], ["goog.json","goog.net.XmlHttp"], false);
+goog.addDependency("json/json.js", ["goog.json","goog.json.Replacer","goog.json.Reviver","goog.json.Serializer"], [], false);
+goog.addDependency("../webdriver/test/testing/testcase_test.js", [], ["goog.Promise","goog.testing.MockControl","goog.testing.PropertyReplacer","goog.testing.mockmatchers","goog.testing.jsunit","goog.testing.recordFunction","goog.userAgent","webdriver.test.testutil","webdriver.testing.TestCase"], false);
+goog.addDependency("../webdriver/testing/testcase.js", ["webdriver.testing.TestCase"], ["goog.testing.TestCase","webdriver.promise","webdriver.testing.asserts"], false);
+goog.addDependency("../atoms/json.js", ["bot.json"], ["bot.userAgent","goog.json","goog.userAgent"], false);
+goog.addDependency("../atoms/userAgent.js", ["bot.userAgent"], ["goog.string","goog.userAgent","goog.userAgent.product","goog.userAgent.product.isVersion"], false);
+goog.addDependency("useragent/product_isversion.js", ["goog.userAgent.product.isVersion"], ["goog.labs.userAgent.platform","goog.string","goog.userAgent","goog.userAgent.product"], false);
+goog.addDependency("../webdriver/testing/jsunit.js", ["webdriver.testing.jsunit","webdriver.testing.jsunit.TestRunner"], ["goog.testing.TestRunner","webdriver.testing.Client","webdriver.testing.TestCase"], false);
+goog.addDependency("../webdriver/testing/window.js", ["webdriver.testing.Window"], ["goog.string","webdriver.promise"], false);
+goog.addDependency("../webdriver/test/promise_generator_test.js", ["webdriver.test.promise.generator.test"], ["goog.testing.jsunit","webdriver.promise"], false);
+goog.addDependency("../webdriver/test/until_test.js", ["webdriver.test.until_test"], ["bot.Error","bot.ErrorCode","bot.response","goog.array","goog.string","goog.testing.jsunit","goog.userAgent","webdriver.By","webdriver.CommandName","webdriver.WebDriver","webdriver.WebElement","webdriver.WebElementPromise","webdriver.until"], false);
+goog.addDependency("../webdriver/test/webdriver_generator_test.js", ["webdriver.test.WebDriver.generator.test"], ["goog.testing.jsunit","webdriver.Session","webdriver.WebDriver"], false);
diff --git a/lib/goog/disposable/disposable.js b/lib/goog/disposable/disposable.js
new file mode 100644
index 0000000..d9c89d9
--- /dev/null
+++ b/lib/goog/disposable/disposable.js
@@ -0,0 +1,307 @@
+// Copyright 2005 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Implements the disposable interface. The dispose method is used
+ * to clean up references and resources.
+ * @author arv@google.com (Erik Arvidsson)
+ */
+
+
+goog.provide('goog.Disposable');
+/** @suppress {extraProvide} */
+goog.provide('goog.dispose');
+/** @suppress {extraProvide} */
+goog.provide('goog.disposeAll');
+
+goog.require('goog.disposable.IDisposable');
+
+
+
+/**
+ * Class that provides the basic implementation for disposable objects. If your
+ * class holds one or more references to COM objects, DOM nodes, or other
+ * disposable objects, it should extend this class or implement the disposable
+ * interface (defined in goog.disposable.IDisposable).
+ * @constructor
+ * @implements {goog.disposable.IDisposable}
+ */
+goog.Disposable = function() {
+  if (goog.Disposable.MONITORING_MODE != goog.Disposable.MonitoringMode.OFF) {
+    if (goog.Disposable.INCLUDE_STACK_ON_CREATION) {
+      this.creationStack = new Error().stack;
+    }
+    goog.Disposable.instances_[goog.getUid(this)] = this;
+  }
+  // Support sealing
+  this.disposed_ = this.disposed_;
+  this.onDisposeCallbacks_ = this.onDisposeCallbacks_;
+};
+
+
+/**
+ * @enum {number} Different monitoring modes for Disposable.
+ */
+goog.Disposable.MonitoringMode = {
+  /**
+   * No monitoring.
+   */
+  OFF: 0,
+  /**
+   * Creating and disposing the goog.Disposable instances is monitored. All
+   * disposable objects need to call the {@code goog.Disposable} base
+   * constructor. The PERMANENT mode must be switched on before creating any
+   * goog.Disposable instances.
+   */
+  PERMANENT: 1,
+  /**
+   * INTERACTIVE mode can be switched on and off on the fly without producing
+   * errors. It also doesn't warn if the disposable objects don't call the
+   * {@code goog.Disposable} base constructor.
+   */
+  INTERACTIVE: 2
+};
+
+
+/**
+ * @define {number} The monitoring mode of the goog.Disposable
+ *     instances. Default is OFF. Switching on the monitoring is only
+ *     recommended for debugging because it has a significant impact on
+ *     performance and memory usage. If switched off, the monitoring code
+ *     compiles down to 0 bytes.
+ */
+goog.define('goog.Disposable.MONITORING_MODE', 0);
+
+
+/**
+ * @define {boolean} Whether to attach creation stack to each created disposable
+ *     instance; This is only relevant for when MonitoringMode != OFF.
+ */
+goog.define('goog.Disposable.INCLUDE_STACK_ON_CREATION', true);
+
+
+/**
+ * Maps the unique ID of every undisposed {@code goog.Disposable} object to
+ * the object itself.
+ * @type {!Object<number, !goog.Disposable>}
+ * @private
+ */
+goog.Disposable.instances_ = {};
+
+
+/**
+ * @return {!Array<!goog.Disposable>} All {@code goog.Disposable} objects that
+ *     haven't been disposed of.
+ */
+goog.Disposable.getUndisposedObjects = function() {
+  var ret = [];
+  for (var id in goog.Disposable.instances_) {
+    if (goog.Disposable.instances_.hasOwnProperty(id)) {
+      ret.push(goog.Disposable.instances_[Number(id)]);
+    }
+  }
+  return ret;
+};
+
+
+/**
+ * Clears the registry of undisposed objects but doesn't dispose of them.
+ */
+goog.Disposable.clearUndisposedObjects = function() {
+  goog.Disposable.instances_ = {};
+};
+
+
+/**
+ * Whether the object has been disposed of.
+ * @type {boolean}
+ * @private
+ */
+goog.Disposable.prototype.disposed_ = false;
+
+
+/**
+ * Callbacks to invoke when this object is disposed.
+ * @type {Array<!Function>}
+ * @private
+ */
+goog.Disposable.prototype.onDisposeCallbacks_;
+
+
+/**
+ * If monitoring the goog.Disposable instances is enabled, stores the creation
+ * stack trace of the Disposable instance.
+ * @const {string}
+ */
+goog.Disposable.prototype.creationStack;
+
+
+/**
+ * @return {boolean} Whether the object has been disposed of.
+ * @override
+ */
+goog.Disposable.prototype.isDisposed = function() {
+  return this.disposed_;
+};
+
+
+/**
+ * @return {boolean} Whether the object has been disposed of.
+ * @deprecated Use {@link #isDisposed} instead.
+ */
+goog.Disposable.prototype.getDisposed = goog.Disposable.prototype.isDisposed;
+
+
+/**
+ * Disposes of the object. If the object hasn't already been disposed of, calls
+ * {@link #disposeInternal}. Classes that extend {@code goog.Disposable} should
+ * override {@link #disposeInternal} in order to delete references to COM
+ * objects, DOM nodes, and other disposable objects. Reentrant.
+ *
+ * @return {void} Nothing.
+ * @override
+ */
+goog.Disposable.prototype.dispose = function() {
+  if (!this.disposed_) {
+    // Set disposed_ to true first, in case during the chain of disposal this
+    // gets disposed recursively.
+    this.disposed_ = true;
+    this.disposeInternal();
+    if (goog.Disposable.MONITORING_MODE != goog.Disposable.MonitoringMode.OFF) {
+      var uid = goog.getUid(this);
+      if (goog.Disposable.MONITORING_MODE ==
+          goog.Disposable.MonitoringMode.PERMANENT &&
+          !goog.Disposable.instances_.hasOwnProperty(uid)) {
+        throw Error(this + ' did not call the goog.Disposable base ' +
+            'constructor or was disposed of after a clearUndisposedObjects ' +
+            'call');
+      }
+      delete goog.Disposable.instances_[uid];
+    }
+  }
+};
+
+
+/**
+ * Associates a disposable object with this object so that they will be disposed
+ * together.
+ * @param {goog.disposable.IDisposable} disposable that will be disposed when
+ *     this object is disposed.
+ */
+goog.Disposable.prototype.registerDisposable = function(disposable) {
+  this.addOnDisposeCallback(goog.partial(goog.dispose, disposable));
+};
+
+
+/**
+ * Invokes a callback function when this object is disposed. Callbacks are
+ * invoked in the order in which they were added. If a callback is added to
+ * an already disposed Disposable, it will be called immediately.
+ * @param {function(this:T):?} callback The callback function.
+ * @param {T=} opt_scope An optional scope to call the callback in.
+ * @template T
+ */
+goog.Disposable.prototype.addOnDisposeCallback = function(callback, opt_scope) {
+  if (this.disposed_) {
+    callback.call(opt_scope);
+    return;
+  }
+  if (!this.onDisposeCallbacks_) {
+    this.onDisposeCallbacks_ = [];
+  }
+
+  this.onDisposeCallbacks_.push(
+      goog.isDef(opt_scope) ? goog.bind(callback, opt_scope) : callback);
+};
+
+
+/**
+ * Deletes or nulls out any references to COM objects, DOM nodes, or other
+ * disposable objects. Classes that extend {@code goog.Disposable} should
+ * override this method.
+ * Not reentrant. To avoid calling it twice, it must only be called from the
+ * subclass' {@code disposeInternal} method. Everywhere else the public
+ * {@code dispose} method must be used.
+ * For example:
+ * <pre>
+ *   mypackage.MyClass = function() {
+ *     mypackage.MyClass.base(this, 'constructor');
+ *     // Constructor logic specific to MyClass.
+ *     ...
+ *   };
+ *   goog.inherits(mypackage.MyClass, goog.Disposable);
+ *
+ *   mypackage.MyClass.prototype.disposeInternal = function() {
+ *     // Dispose logic specific to MyClass.
+ *     ...
+ *     // Call superclass's disposeInternal at the end of the subclass's, like
+ *     // in C++, to avoid hard-to-catch issues.
+ *     mypackage.MyClass.base(this, 'disposeInternal');
+ *   };
+ * </pre>
+ * @protected
+ */
+goog.Disposable.prototype.disposeInternal = function() {
+  if (this.onDisposeCallbacks_) {
+    while (this.onDisposeCallbacks_.length) {
+      this.onDisposeCallbacks_.shift()();
+    }
+  }
+};
+
+
+/**
+ * Returns True if we can verify the object is disposed.
+ * Calls {@code isDisposed} on the argument if it supports it.  If obj
+ * is not an object with an isDisposed() method, return false.
+ * @param {*} obj The object to investigate.
+ * @return {boolean} True if we can verify the object is disposed.
+ */
+goog.Disposable.isDisposed = function(obj) {
+  if (obj && typeof obj.isDisposed == 'function') {
+    return obj.isDisposed();
+  }
+  return false;
+};
+
+
+/**
+ * Calls {@code dispose} on the argument if it supports it. If obj is not an
+ *     object with a dispose() method, this is a no-op.
+ * @param {*} obj The object to dispose of.
+ */
+goog.dispose = function(obj) {
+  if (obj && typeof obj.dispose == 'function') {
+    obj.dispose();
+  }
+};
+
+
+/**
+ * Calls {@code dispose} on each member of the list that supports it. (If the
+ * member is an ArrayLike, then {@code goog.disposeAll()} will be called
+ * recursively on each of its members.) If the member is not an object with a
+ * {@code dispose()} method, then it is ignored.
+ * @param {...*} var_args The list.
+ */
+goog.disposeAll = function(var_args) {
+  for (var i = 0, len = arguments.length; i < len; ++i) {
+    var disposable = arguments[i];
+    if (goog.isArrayLike(disposable)) {
+      goog.disposeAll.apply(null, disposable);
+    } else {
+      goog.dispose(disposable);
+    }
+  }
+};
diff --git a/lib/goog/disposable/idisposable.js b/lib/goog/disposable/idisposable.js
new file mode 100644
index 0000000..917d17e
--- /dev/null
+++ b/lib/goog/disposable/idisposable.js
@@ -0,0 +1,45 @@
+// Copyright 2011 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Definition of the disposable interface.  A disposable object
+ * has a dispose method to to clean up references and resources.
+ * @author nnaze@google.com (Nathan Naze)
+ */
+
+
+goog.provide('goog.disposable.IDisposable');
+
+
+
+/**
+ * Interface for a disposable object.  If a instance requires cleanup
+ * (references COM objects, DOM notes, or other disposable objects), it should
+ * implement this interface (it may subclass goog.Disposable).
+ * @interface
+ */
+goog.disposable.IDisposable = function() {};
+
+
+/**
+ * Disposes of the object and its resources.
+ * @return {void} Nothing.
+ */
+goog.disposable.IDisposable.prototype.dispose = goog.abstractMethod;
+
+
+/**
+ * @return {boolean} Whether the object has been disposed of.
+ */
+goog.disposable.IDisposable.prototype.isDisposed = goog.abstractMethod;
diff --git a/lib/goog/dom/browserfeature.js b/lib/goog/dom/browserfeature.js
new file mode 100644
index 0000000..2c70cda
--- /dev/null
+++ b/lib/goog/dom/browserfeature.js
@@ -0,0 +1,72 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Browser capability checks for the dom package.
+ *
+ */
+
+
+goog.provide('goog.dom.BrowserFeature');
+
+goog.require('goog.userAgent');
+
+
+/**
+ * Enum of browser capabilities.
+ * @enum {boolean}
+ */
+goog.dom.BrowserFeature = {
+  /**
+   * Whether attributes 'name' and 'type' can be added to an element after it's
+   * created. False in Internet Explorer prior to version 9.
+   */
+  CAN_ADD_NAME_OR_TYPE_ATTRIBUTES: !goog.userAgent.IE ||
+      goog.userAgent.isDocumentModeOrHigher(9),
+
+  /**
+   * Whether we can use element.children to access an element's Element
+   * children. Available since Gecko 1.9.1, IE 9. (IE<9 also includes comment
+   * nodes in the collection.)
+   */
+  CAN_USE_CHILDREN_ATTRIBUTE: !goog.userAgent.GECKO && !goog.userAgent.IE ||
+      goog.userAgent.IE && goog.userAgent.isDocumentModeOrHigher(9) ||
+      goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher('1.9.1'),
+
+  /**
+   * Opera, Safari 3, and Internet Explorer 9 all support innerText but they
+   * include text nodes in script and style tags. Not document-mode-dependent.
+   */
+  CAN_USE_INNER_TEXT: (
+      goog.userAgent.IE && !goog.userAgent.isVersionOrHigher('9')),
+
+  /**
+   * MSIE, Opera, and Safari>=4 support element.parentElement to access an
+   * element's parent if it is an Element.
+   */
+  CAN_USE_PARENT_ELEMENT_PROPERTY: goog.userAgent.IE || goog.userAgent.OPERA ||
+      goog.userAgent.WEBKIT,
+
+  /**
+   * Whether NoScope elements need a scoped element written before them in
+   * innerHTML.
+   * MSDN: http://msdn.microsoft.com/en-us/library/ms533897(VS.85).aspx#1
+   */
+  INNER_HTML_NEEDS_SCOPED_ELEMENT: goog.userAgent.IE,
+
+  /**
+   * Whether we use legacy IE range API.
+   */
+  LEGACY_IE_RANGES: goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9)
+};
diff --git a/lib/goog/dom/dom.js b/lib/goog/dom/dom.js
new file mode 100644
index 0000000..d39ace3
--- /dev/null
+++ b/lib/goog/dom/dom.js
@@ -0,0 +1,2991 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Utilities for manipulating the browser's Document Object Model
+ * Inspiration taken *heavily* from mochikit (http://mochikit.com/).
+ *
+ * You can use {@link goog.dom.DomHelper} to create new dom helpers that refer
+ * to a different document object.  This is useful if you are working with
+ * frames or multiple windows.
+ *
+ * @author arv@google.com (Erik Arvidsson)
+ */
+
+
+// TODO(arv): Rename/refactor getTextContent and getRawTextContent. The problem
+// is that getTextContent should mimic the DOM3 textContent. We should add a
+// getInnerText (or getText) which tries to return the visible text, innerText.
+
+
+goog.provide('goog.dom');
+goog.provide('goog.dom.Appendable');
+goog.provide('goog.dom.DomHelper');
+
+goog.require('goog.array');
+goog.require('goog.asserts');
+goog.require('goog.dom.BrowserFeature');
+goog.require('goog.dom.NodeType');
+goog.require('goog.dom.TagName');
+goog.require('goog.dom.safe');
+goog.require('goog.html.SafeHtml');
+goog.require('goog.math.Coordinate');
+goog.require('goog.math.Size');
+goog.require('goog.object');
+goog.require('goog.string');
+goog.require('goog.string.Unicode');
+goog.require('goog.userAgent');
+
+
+/**
+ * @define {boolean} Whether we know at compile time that the browser is in
+ * quirks mode.
+ */
+goog.define('goog.dom.ASSUME_QUIRKS_MODE', false);
+
+
+/**
+ * @define {boolean} Whether we know at compile time that the browser is in
+ * standards compliance mode.
+ */
+goog.define('goog.dom.ASSUME_STANDARDS_MODE', false);
+
+
+/**
+ * Whether we know the compatibility mode at compile time.
+ * @type {boolean}
+ * @private
+ */
+goog.dom.COMPAT_MODE_KNOWN_ =
+    goog.dom.ASSUME_QUIRKS_MODE || goog.dom.ASSUME_STANDARDS_MODE;
+
+
+/**
+ * Gets the DomHelper object for the document where the element resides.
+ * @param {(Node|Window)=} opt_element If present, gets the DomHelper for this
+ *     element.
+ * @return {!goog.dom.DomHelper} The DomHelper.
+ */
+goog.dom.getDomHelper = function(opt_element) {
+  return opt_element ?
+      new goog.dom.DomHelper(goog.dom.getOwnerDocument(opt_element)) :
+      (goog.dom.defaultDomHelper_ ||
+          (goog.dom.defaultDomHelper_ = new goog.dom.DomHelper()));
+};
+
+
+/**
+ * Cached default DOM helper.
+ * @type {goog.dom.DomHelper}
+ * @private
+ */
+goog.dom.defaultDomHelper_;
+
+
+/**
+ * Gets the document object being used by the dom library.
+ * @return {!Document} Document object.
+ */
+goog.dom.getDocument = function() {
+  return document;
+};
+
+
+/**
+ * Gets an element from the current document by element id.
+ *
+ * If an Element is passed in, it is returned.
+ *
+ * @param {string|Element} element Element ID or a DOM node.
+ * @return {Element} The element with the given ID, or the node passed in.
+ */
+goog.dom.getElement = function(element) {
+  return goog.dom.getElementHelper_(document, element);
+};
+
+
+/**
+ * Gets an element by id from the given document (if present).
+ * If an element is given, it is returned.
+ * @param {!Document} doc
+ * @param {string|Element} element Element ID or a DOM node.
+ * @return {Element} The resulting element.
+ * @private
+ */
+goog.dom.getElementHelper_ = function(doc, element) {
+  return goog.isString(element) ?
+      doc.getElementById(element) :
+      element;
+};
+
+
+/**
+ * Gets an element by id, asserting that the element is found.
+ *
+ * This is used when an element is expected to exist, and should fail with
+ * an assertion error if it does not (if assertions are enabled).
+ *
+ * @param {string} id Element ID.
+ * @return {!Element} The element with the given ID, if it exists.
+ */
+goog.dom.getRequiredElement = function(id) {
+  return goog.dom.getRequiredElementHelper_(document, id);
+};
+
+
+/**
+ * Helper function for getRequiredElementHelper functions, both static and
+ * on DomHelper.  Asserts the element with the given id exists.
+ * @param {!Document} doc
+ * @param {string} id
+ * @return {!Element} The element with the given ID, if it exists.
+ * @private
+ */
+goog.dom.getRequiredElementHelper_ = function(doc, id) {
+  // To prevent users passing in Elements as is permitted in getElement().
+  goog.asserts.assertString(id);
+  var element = goog.dom.getElementHelper_(doc, id);
+  element = goog.asserts.assertElement(element,
+      'No element found with id: ' + id);
+  return element;
+};
+
+
+/**
+ * Alias for getElement.
+ * @param {string|Element} element Element ID or a DOM node.
+ * @return {Element} The element with the given ID, or the node passed in.
+ * @deprecated Use {@link goog.dom.getElement} instead.
+ */
+goog.dom.$ = goog.dom.getElement;
+
+
+/**
+ * Looks up elements by both tag and class name, using browser native functions
+ * ({@code querySelectorAll}, {@code getElementsByTagName} or
+ * {@code getElementsByClassName}) where possible. This function
+ * is a useful, if limited, way of collecting a list of DOM elements
+ * with certain characteristics.  {@code goog.dom.query} offers a
+ * more powerful and general solution which allows matching on CSS3
+ * selector expressions, but at increased cost in code size. If all you
+ * need is particular tags belonging to a single class, this function
+ * is fast and sleek.
+ *
+ * Note that tag names are case sensitive in the SVG namespace, and this
+ * function converts opt_tag to uppercase for comparisons. For queries in the
+ * SVG namespace you should use querySelector or querySelectorAll instead.
+ * https://bugzilla.mozilla.org/show_bug.cgi?id=963870
+ * https://bugs.webkit.org/show_bug.cgi?id=83438
+ *
+ * @see {goog.dom.query}
+ *
+ * @param {?string=} opt_tag Element tag name.
+ * @param {?string=} opt_class Optional class name.
+ * @param {(Document|Element)=} opt_el Optional element to look in.
+ * @return { {length: number} } Array-like list of elements (only a length
+ *     property and numerical indices are guaranteed to exist).
+ */
+goog.dom.getElementsByTagNameAndClass = function(opt_tag, opt_class, opt_el) {
+  return goog.dom.getElementsByTagNameAndClass_(document, opt_tag, opt_class,
+                                                opt_el);
+};
+
+
+/**
+ * Returns a static, array-like list of the elements with the provided
+ * className.
+ * @see {goog.dom.query}
+ * @param {string} className the name of the class to look for.
+ * @param {(Document|Element)=} opt_el Optional element to look in.
+ * @return { {length: number} } The items found with the class name provided.
+ */
+goog.dom.getElementsByClass = function(className, opt_el) {
+  var parent = opt_el || document;
+  if (goog.dom.canUseQuerySelector_(parent)) {
+    return parent.querySelectorAll('.' + className);
+  }
+  return goog.dom.getElementsByTagNameAndClass_(
+      document, '*', className, opt_el);
+};
+
+
+/**
+ * Returns the first element with the provided className.
+ * @see {goog.dom.query}
+ * @param {string} className the name of the class to look for.
+ * @param {Element|Document=} opt_el Optional element to look in.
+ * @return {Element} The first item with the class name provided.
+ */
+goog.dom.getElementByClass = function(className, opt_el) {
+  var parent = opt_el || document;
+  var retVal = null;
+  if (parent.getElementsByClassName) {
+    retVal = parent.getElementsByClassName(className)[0];
+  } else if (goog.dom.canUseQuerySelector_(parent)) {
+    retVal = parent.querySelector('.' + className);
+  } else {
+    retVal = goog.dom.getElementsByTagNameAndClass_(
+        document, '*', className, opt_el)[0];
+  }
+  return retVal || null;
+};
+
+
+/**
+ * Ensures an element with the given className exists, and then returns the
+ * first element with the provided className.
+ * @see {goog.dom.query}
+ * @param {string} className the name of the class to look for.
+ * @param {!Element|!Document=} opt_root Optional element or document to look
+ *     in.
+ * @return {!Element} The first item with the class name provided.
+ * @throws {goog.asserts.AssertionError} Thrown if no element is found.
+ */
+goog.dom.getRequiredElementByClass = function(className, opt_root) {
+  var retValue = goog.dom.getElementByClass(className, opt_root);
+  return goog.asserts.assert(retValue,
+      'No element found with className: ' + className);
+};
+
+
+/**
+ * Prefer the standardized (http://www.w3.org/TR/selectors-api/), native and
+ * fast W3C Selectors API.
+ * @param {!(Element|Document)} parent The parent document object.
+ * @return {boolean} whether or not we can use parent.querySelector* APIs.
+ * @private
+ */
+goog.dom.canUseQuerySelector_ = function(parent) {
+  return !!(parent.querySelectorAll && parent.querySelector);
+};
+
+
+/**
+ * Helper for {@code getElementsByTagNameAndClass}.
+ * @param {!Document} doc The document to get the elements in.
+ * @param {?string=} opt_tag Element tag name.
+ * @param {?string=} opt_class Optional class name.
+ * @param {(Document|Element)=} opt_el Optional element to look in.
+ * @return { {length: number} } Array-like list of elements (only a length
+ *     property and numerical indices are guaranteed to exist).
+ * @private
+ */
+goog.dom.getElementsByTagNameAndClass_ = function(doc, opt_tag, opt_class,
+                                                  opt_el) {
+  var parent = opt_el || doc;
+  var tagName = (opt_tag && opt_tag != '*') ? opt_tag.toUpperCase() : '';
+
+  if (goog.dom.canUseQuerySelector_(parent) &&
+      (tagName || opt_class)) {
+    var query = tagName + (opt_class ? '.' + opt_class : '');
+    return parent.querySelectorAll(query);
+  }
+
+  // Use the native getElementsByClassName if available, under the assumption
+  // that even when the tag name is specified, there will be fewer elements to
+  // filter through when going by class than by tag name
+  if (opt_class && parent.getElementsByClassName) {
+    var els = parent.getElementsByClassName(opt_class);
+
+    if (tagName) {
+      var arrayLike = {};
+      var len = 0;
+
+      // Filter for specific tags if requested.
+      for (var i = 0, el; el = els[i]; i++) {
+        if (tagName == el.nodeName) {
+          arrayLike[len++] = el;
+        }
+      }
+      arrayLike.length = len;
+
+      return arrayLike;
+    } else {
+      return els;
+    }
+  }
+
+  var els = parent.getElementsByTagName(tagName || '*');
+
+  if (opt_class) {
+    var arrayLike = {};
+    var len = 0;
+    for (var i = 0, el; el = els[i]; i++) {
+      var className = el.className;
+      // Check if className has a split function since SVG className does not.
+      if (typeof className.split == 'function' &&
+          goog.array.contains(className.split(/\s+/), opt_class)) {
+        arrayLike[len++] = el;
+      }
+    }
+    arrayLike.length = len;
+    return arrayLike;
+  } else {
+    return els;
+  }
+};
+
+
+/**
+ * Alias for {@code getElementsByTagNameAndClass}.
+ * @param {?string=} opt_tag Element tag name.
+ * @param {?string=} opt_class Optional class name.
+ * @param {Element=} opt_el Optional element to look in.
+ * @return { {length: number} } Array-like list of elements (only a length
+ *     property and numerical indices are guaranteed to exist).
+ * @deprecated Use {@link goog.dom.getElementsByTagNameAndClass} instead.
+ */
+goog.dom.$$ = goog.dom.getElementsByTagNameAndClass;
+
+
+/**
+ * Sets multiple properties on a node.
+ * @param {Element} element DOM node to set properties on.
+ * @param {Object} properties Hash of property:value pairs.
+ */
+goog.dom.setProperties = function(element, properties) {
+  goog.object.forEach(properties, function(val, key) {
+    if (key == 'style') {
+      element.style.cssText = val;
+    } else if (key == 'class') {
+      element.className = val;
+    } else if (key == 'for') {
+      element.htmlFor = val;
+    } else if (goog.dom.DIRECT_ATTRIBUTE_MAP_.hasOwnProperty(key)) {
+      element.setAttribute(goog.dom.DIRECT_ATTRIBUTE_MAP_[key], val);
+    } else if (goog.string.startsWith(key, 'aria-') ||
+        goog.string.startsWith(key, 'data-')) {
+      element.setAttribute(key, val);
+    } else {
+      element[key] = val;
+    }
+  });
+};
+
+
+/**
+ * Map of attributes that should be set using
+ * element.setAttribute(key, val) instead of element[key] = val.  Used
+ * by goog.dom.setProperties.
+ *
+ * @private {!Object<string, string>}
+ * @const
+ */
+goog.dom.DIRECT_ATTRIBUTE_MAP_ = {
+  'cellpadding': 'cellPadding',
+  'cellspacing': 'cellSpacing',
+  'colspan': 'colSpan',
+  'frameborder': 'frameBorder',
+  'height': 'height',
+  'maxlength': 'maxLength',
+  'role': 'role',
+  'rowspan': 'rowSpan',
+  'type': 'type',
+  'usemap': 'useMap',
+  'valign': 'vAlign',
+  'width': 'width'
+};
+
+
+/**
+ * Gets the dimensions of the viewport.
+ *
+ * Gecko Standards mode:
+ * docEl.clientWidth  Width of viewport excluding scrollbar.
+ * win.innerWidth     Width of viewport including scrollbar.
+ * body.clientWidth   Width of body element.
+ *
+ * docEl.clientHeight Height of viewport excluding scrollbar.
+ * win.innerHeight    Height of viewport including scrollbar.
+ * body.clientHeight  Height of document.
+ *
+ * Gecko Backwards compatible mode:
+ * docEl.clientWidth  Width of viewport excluding scrollbar.
+ * win.innerWidth     Width of viewport including scrollbar.
+ * body.clientWidth   Width of viewport excluding scrollbar.
+ *
+ * docEl.clientHeight Height of document.
+ * win.innerHeight    Height of viewport including scrollbar.
+ * body.clientHeight  Height of viewport excluding scrollbar.
+ *
+ * IE6/7 Standards mode:
+ * docEl.clientWidth  Width of viewport excluding scrollbar.
+ * win.innerWidth     Undefined.
+ * body.clientWidth   Width of body element.
+ *
+ * docEl.clientHeight Height of viewport excluding scrollbar.
+ * win.innerHeight    Undefined.
+ * body.clientHeight  Height of document element.
+ *
+ * IE5 + IE6/7 Backwards compatible mode:
+ * docEl.clientWidth  0.
+ * win.innerWidth     Undefined.
+ * body.clientWidth   Width of viewport excluding scrollbar.
+ *
+ * docEl.clientHeight 0.
+ * win.innerHeight    Undefined.
+ * body.clientHeight  Height of viewport excluding scrollbar.
+ *
+ * Opera 9 Standards and backwards compatible mode:
+ * docEl.clientWidth  Width of viewport excluding scrollbar.
+ * win.innerWidth     Width of viewport including scrollbar.
+ * body.clientWidth   Width of viewport excluding scrollbar.
+ *
+ * docEl.clientHeight Height of document.
+ * win.innerHeight    Height of viewport including scrollbar.
+ * body.clientHeight  Height of viewport excluding scrollbar.
+ *
+ * WebKit:
+ * Safari 2
+ * docEl.clientHeight Same as scrollHeight.
+ * docEl.clientWidth  Same as innerWidth.
+ * win.innerWidth     Width of viewport excluding scrollbar.
+ * win.innerHeight    Height of the viewport including scrollbar.
+ * frame.innerHeight  Height of the viewport exluding scrollbar.
+ *
+ * Safari 3 (tested in 522)
+ *
+ * docEl.clientWidth  Width of viewport excluding scrollbar.
+ * docEl.clientHeight Height of viewport excluding scrollbar in strict mode.
+ * body.clientHeight  Height of viewport excluding scrollbar in quirks mode.
+ *
+ * @param {Window=} opt_window Optional window element to test.
+ * @return {!goog.math.Size} Object with values 'width' and 'height'.
+ */
+goog.dom.getViewportSize = function(opt_window) {
+  // TODO(arv): This should not take an argument
+  return goog.dom.getViewportSize_(opt_window || window);
+};
+
+
+/**
+ * Helper for {@code getViewportSize}.
+ * @param {Window} win The window to get the view port size for.
+ * @return {!goog.math.Size} Object with values 'width' and 'height'.
+ * @private
+ */
+goog.dom.getViewportSize_ = function(win) {
+  var doc = win.document;
+  var el = goog.dom.isCss1CompatMode_(doc) ? doc.documentElement : doc.body;
+  return new goog.math.Size(el.clientWidth, el.clientHeight);
+};
+
+
+/**
+ * Calculates the height of the document.
+ *
+ * @return {number} The height of the current document.
+ */
+goog.dom.getDocumentHeight = function() {
+  return goog.dom.getDocumentHeight_(window);
+};
+
+
+/**
+ * Calculates the height of the document of the given window.
+ *
+ * Function code copied from the opensocial gadget api:
+ *   gadgets.window.adjustHeight(opt_height)
+ *
+ * @private
+ * @param {!Window} win The window whose document height to retrieve.
+ * @return {number} The height of the document of the given window.
+ */
+goog.dom.getDocumentHeight_ = function(win) {
+  // NOTE(eae): This method will return the window size rather than the document
+  // size in webkit quirks mode.
+  var doc = win.document;
+  var height = 0;
+
+  if (doc) {
+    // Calculating inner content height is hard and different between
+    // browsers rendering in Strict vs. Quirks mode.  We use a combination of
+    // three properties within document.body and document.documentElement:
+    // - scrollHeight
+    // - offsetHeight
+    // - clientHeight
+    // These values differ significantly between browsers and rendering modes.
+    // But there are patterns.  It just takes a lot of time and persistence
+    // to figure out.
+
+    var body = doc.body;
+    var docEl = /** @type {!HTMLElement} */ (doc.documentElement);
+    if (!(docEl && body)) {
+      return 0;
+    }
+
+    // Get the height of the viewport
+    var vh = goog.dom.getViewportSize_(win).height;
+    if (goog.dom.isCss1CompatMode_(doc) && docEl.scrollHeight) {
+      // In Strict mode:
+      // The inner content height is contained in either:
+      //    document.documentElement.scrollHeight
+      //    document.documentElement.offsetHeight
+      // Based on studying the values output by different browsers,
+      // use the value that's NOT equal to the viewport height found above.
+      height = docEl.scrollHeight != vh ?
+          docEl.scrollHeight : docEl.offsetHeight;
+    } else {
+      // In Quirks mode:
+      // documentElement.clientHeight is equal to documentElement.offsetHeight
+      // except in IE.  In most browsers, document.documentElement can be used
+      // to calculate the inner content height.
+      // However, in other browsers (e.g. IE), document.body must be used
+      // instead.  How do we know which one to use?
+      // If document.documentElement.clientHeight does NOT equal
+      // document.documentElement.offsetHeight, then use document.body.
+      var sh = docEl.scrollHeight;
+      var oh = docEl.offsetHeight;
+      if (docEl.clientHeight != oh) {
+        sh = body.scrollHeight;
+        oh = body.offsetHeight;
+      }
+
+      // Detect whether the inner content height is bigger or smaller
+      // than the bounding box (viewport).  If bigger, take the larger
+      // value.  If smaller, take the smaller value.
+      if (sh > vh) {
+        // Content is larger
+        height = sh > oh ? sh : oh;
+      } else {
+        // Content is smaller
+        height = sh < oh ? sh : oh;
+      }
+    }
+  }
+
+  return height;
+};
+
+
+/**
+ * Gets the page scroll distance as a coordinate object.
+ *
+ * @param {Window=} opt_window Optional window element to test.
+ * @return {!goog.math.Coordinate} Object with values 'x' and 'y'.
+ * @deprecated Use {@link goog.dom.getDocumentScroll} instead.
+ */
+goog.dom.getPageScroll = function(opt_window) {
+  var win = opt_window || goog.global || window;
+  return goog.dom.getDomHelper(win.document).getDocumentScroll();
+};
+
+
+/**
+ * Gets the document scroll distance as a coordinate object.
+ *
+ * @return {!goog.math.Coordinate} Object with values 'x' and 'y'.
+ */
+goog.dom.getDocumentScroll = function() {
+  return goog.dom.getDocumentScroll_(document);
+};
+
+
+/**
+ * Helper for {@code getDocumentScroll}.
+ *
+ * @param {!Document} doc The document to get the scroll for.
+ * @return {!goog.math.Coordinate} Object with values 'x' and 'y'.
+ * @private
+ */
+goog.dom.getDocumentScroll_ = function(doc) {
+  var el = goog.dom.getDocumentScrollElement_(doc);
+  var win = goog.dom.getWindow_(doc);
+  if (goog.userAgent.IE && goog.userAgent.isVersionOrHigher('10') &&
+      win.pageYOffset != el.scrollTop) {
+    // The keyboard on IE10 touch devices shifts the page using the pageYOffset
+    // without modifying scrollTop. For this case, we want the body scroll
+    // offsets.
+    return new goog.math.Coordinate(el.scrollLeft, el.scrollTop);
+  }
+  return new goog.math.Coordinate(win.pageXOffset || el.scrollLeft,
+      win.pageYOffset || el.scrollTop);
+};
+
+
+/**
+ * Gets the document scroll element.
+ * @return {!Element} Scrolling element.
+ */
+goog.dom.getDocumentScrollElement = function() {
+  return goog.dom.getDocumentScrollElement_(document);
+};
+
+
+/**
+ * Helper for {@code getDocumentScrollElement}.
+ * @param {!Document} doc The document to get the scroll element for.
+ * @return {!Element} Scrolling element.
+ * @private
+ */
+goog.dom.getDocumentScrollElement_ = function(doc) {
+  // Old WebKit needs body.scrollLeft in both quirks mode and strict mode. We
+  // also default to the documentElement if the document does not have a body
+  // (e.g. a SVG document).
+  // Uses http://dev.w3.org/csswg/cssom-view/#dom-document-scrollingelement to
+  // avoid trying to guess about browser behavior from the UA string.
+  if (doc.scrollingElement) {
+    return doc.scrollingElement;
+  }
+  if (!goog.userAgent.WEBKIT && goog.dom.isCss1CompatMode_(doc)) {
+    return doc.documentElement;
+  }
+  return doc.body || doc.documentElement;
+};
+
+
+/**
+ * Gets the window object associated with the given document.
+ *
+ * @param {Document=} opt_doc  Document object to get window for.
+ * @return {!Window} The window associated with the given document.
+ */
+goog.dom.getWindow = function(opt_doc) {
+  // TODO(arv): This should not take an argument.
+  return opt_doc ? goog.dom.getWindow_(opt_doc) : window;
+};
+
+
+/**
+ * Helper for {@code getWindow}.
+ *
+ * @param {!Document} doc  Document object to get window for.
+ * @return {!Window} The window associated with the given document.
+ * @private
+ */
+goog.dom.getWindow_ = function(doc) {
+  return doc.parentWindow || doc.defaultView;
+};
+
+
+/**
+ * Returns a dom node with a set of attributes.  This function accepts varargs
+ * for subsequent nodes to be added.  Subsequent nodes will be added to the
+ * first node as childNodes.
+ *
+ * So:
+ * <code>createDom('div', null, createDom('p'), createDom('p'));</code>
+ * would return a div with two child paragraphs
+ *
+ * @param {string} tagName Tag to create.
+ * @param {(Object|Array<string>|string)=} opt_attributes If object, then a map
+ *     of name-value pairs for attributes. If a string, then this is the
+ *     className of the new element. If an array, the elements will be joined
+ *     together as the className of the new element.
+ * @param {...(Object|string|Array|NodeList)} var_args Further DOM nodes or
+ *     strings for text nodes. If one of the var_args is an array or NodeList,
+ *     its elements will be added as childNodes instead.
+ * @return {!Element} Reference to a DOM node.
+ */
+goog.dom.createDom = function(tagName, opt_attributes, var_args) {
+  return goog.dom.createDom_(document, arguments);
+};
+
+
+/**
+ * Helper for {@code createDom}.
+ * @param {!Document} doc The document to create the DOM in.
+ * @param {!Arguments} args Argument object passed from the callers. See
+ *     {@code goog.dom.createDom} for details.
+ * @return {!Element} Reference to a DOM node.
+ * @private
+ */
+goog.dom.createDom_ = function(doc, args) {
+  var tagName = args[0];
+  var attributes = args[1];
+
+  // Internet Explorer is dumb:
+  // name: https://msdn.microsoft.com/en-us/library/ms534184(v=vs.85).aspx
+  // type: https://msdn.microsoft.com/en-us/library/ms534700(v=vs.85).aspx
+  // Also does not allow setting of 'type' attribute on 'input' or 'button'.
+  if (!goog.dom.BrowserFeature.CAN_ADD_NAME_OR_TYPE_ATTRIBUTES && attributes &&
+      (attributes.name || attributes.type)) {
+    var tagNameArr = ['<', tagName];
+    if (attributes.name) {
+      tagNameArr.push(' name="', goog.string.htmlEscape(attributes.name), '"');
+    }
+    if (attributes.type) {
+      tagNameArr.push(' type="', goog.string.htmlEscape(attributes.type), '"');
+
+      // Clone attributes map to remove 'type' without mutating the input.
+      var clone = {};
+      goog.object.extend(clone, attributes);
+
+      // JSCompiler can't see how goog.object.extend added this property,
+      // because it was essentially added by reflection.
+      // So it needs to be quoted.
+      delete clone['type'];
+
+      attributes = clone;
+    }
+    tagNameArr.push('>');
+    tagName = tagNameArr.join('');
+  }
+
+  var element = doc.createElement(tagName);
+
+  if (attributes) {
+    if (goog.isString(attributes)) {
+      element.className = attributes;
+    } else if (goog.isArray(attributes)) {
+      element.className = attributes.join(' ');
+    } else {
+      goog.dom.setProperties(element, attributes);
+    }
+  }
+
+  if (args.length > 2) {
+    goog.dom.append_(doc, element, args, 2);
+  }
+
+  return element;
+};
+
+
+/**
+ * Appends a node with text or other nodes.
+ * @param {!Document} doc The document to create new nodes in.
+ * @param {!Node} parent The node to append nodes to.
+ * @param {!Arguments} args The values to add. See {@code goog.dom.append}.
+ * @param {number} startIndex The index of the array to start from.
+ * @private
+ */
+goog.dom.append_ = function(doc, parent, args, startIndex) {
+  function childHandler(child) {
+    // TODO(user): More coercion, ala MochiKit?
+    if (child) {
+      parent.appendChild(goog.isString(child) ?
+          doc.createTextNode(child) : child);
+    }
+  }
+
+  for (var i = startIndex; i < args.length; i++) {
+    var arg = args[i];
+    // TODO(attila): Fix isArrayLike to return false for a text node.
+    if (goog.isArrayLike(arg) && !goog.dom.isNodeLike(arg)) {
+      // If the argument is a node list, not a real array, use a clone,
+      // because forEach can't be used to mutate a NodeList.
+      goog.array.forEach(goog.dom.isNodeList(arg) ?
+          goog.array.toArray(arg) : arg,
+          childHandler);
+    } else {
+      childHandler(arg);
+    }
+  }
+};
+
+
+/**
+ * Alias for {@code createDom}.
+ * @param {string} tagName Tag to create.
+ * @param {(string|Object)=} opt_attributes If object, then a map of name-value
+ *     pairs for attributes. If a string, then this is the className of the new
+ *     element.
+ * @param {...(Object|string|Array|NodeList)} var_args Further DOM nodes or
+ *     strings for text nodes. If one of the var_args is an array, its
+ *     children will be added as childNodes instead.
+ * @return {!Element} Reference to a DOM node.
+ * @deprecated Use {@link goog.dom.createDom} instead.
+ */
+goog.dom.$dom = goog.dom.createDom;
+
+
+/**
+ * Creates a new element.
+ * @param {string} name Tag name.
+ * @return {!Element} The new element.
+ */
+goog.dom.createElement = function(name) {
+  return document.createElement(name);
+};
+
+
+/**
+ * Creates a new text node.
+ * @param {number|string} content Content.
+ * @return {!Text} The new text node.
+ */
+goog.dom.createTextNode = function(content) {
+  return document.createTextNode(String(content));
+};
+
+
+/**
+ * Create a table.
+ * @param {number} rows The number of rows in the table.  Must be >= 1.
+ * @param {number} columns The number of columns in the table.  Must be >= 1.
+ * @param {boolean=} opt_fillWithNbsp If true, fills table entries with
+ *     {@code goog.string.Unicode.NBSP} characters.
+ * @return {!Element} The created table.
+ */
+goog.dom.createTable = function(rows, columns, opt_fillWithNbsp) {
+  // TODO(user): Return HTMLTableElement, also in prototype function.
+  // Callers need to be updated to e.g. not assign numbers to table.cellSpacing.
+  return goog.dom.createTable_(document, rows, columns, !!opt_fillWithNbsp);
+};
+
+
+/**
+ * Create a table.
+ * @param {!Document} doc Document object to use to create the table.
+ * @param {number} rows The number of rows in the table.  Must be >= 1.
+ * @param {number} columns The number of columns in the table.  Must be >= 1.
+ * @param {boolean} fillWithNbsp If true, fills table entries with
+ *     {@code goog.string.Unicode.NBSP} characters.
+ * @return {!HTMLTableElement} The created table.
+ * @private
+ */
+goog.dom.createTable_ = function(doc, rows, columns, fillWithNbsp) {
+  var table = /** @type {!HTMLTableElement} */
+      (doc.createElement(goog.dom.TagName.TABLE));
+  var tbody = table.appendChild(doc.createElement(goog.dom.TagName.TBODY));
+  for (var i = 0; i < rows; i++) {
+    var tr = doc.createElement(goog.dom.TagName.TR);
+    for (var j = 0; j < columns; j++) {
+      var td = doc.createElement(goog.dom.TagName.TD);
+      // IE <= 9 will create a text node if we set text content to the empty
+      // string, so we avoid doing it unless necessary. This ensures that the
+      // same DOM tree is returned on all browsers.
+      if (fillWithNbsp) {
+        goog.dom.setTextContent(td, goog.string.Unicode.NBSP);
+      }
+      tr.appendChild(td);
+    }
+    tbody.appendChild(tr);
+  }
+  return table;
+};
+
+
+/**
+ * Converts HTML markup into a node.
+ * @param {!goog.html.SafeHtml} html The HTML markup to convert.
+ * @return {!Node} The resulting node.
+ */
+goog.dom.safeHtmlToNode = function(html) {
+  return goog.dom.safeHtmlToNode_(document, html);
+};
+
+
+/**
+ * Helper for {@code safeHtmlToNode}.
+ * @param {!Document} doc The document.
+ * @param {!goog.html.SafeHtml} html The HTML markup to convert.
+ * @return {!Node} The resulting node.
+ * @private
+ */
+goog.dom.safeHtmlToNode_ = function(doc, html) {
+  var tempDiv = doc.createElement(goog.dom.TagName.DIV);
+  if (goog.dom.BrowserFeature.INNER_HTML_NEEDS_SCOPED_ELEMENT) {
+    goog.dom.safe.setInnerHtml(tempDiv,
+        goog.html.SafeHtml.concat(goog.html.SafeHtml.create('br'), html));
+    tempDiv.removeChild(tempDiv.firstChild);
+  } else {
+    goog.dom.safe.setInnerHtml(tempDiv, html);
+  }
+  return goog.dom.childrenToNode_(doc, tempDiv);
+};
+
+
+/**
+ * Converts an HTML string into a document fragment. The string must be
+ * sanitized in order to avoid cross-site scripting. For example
+ * {@code goog.dom.htmlToDocumentFragment('&lt;img src=x onerror=alert(0)&gt;')}
+ * triggers an alert in all browsers, even if the returned document fragment
+ * is thrown away immediately.
+ *
+ * NOTE: This method doesn't work if your htmlString contains elements that
+ * can't be contained in a <div>. For example, <tr>.
+ *
+ * @param {string} htmlString The HTML string to convert.
+ * @return {!Node} The resulting document fragment.
+ */
+goog.dom.htmlToDocumentFragment = function(htmlString) {
+  return goog.dom.htmlToDocumentFragment_(document, htmlString);
+};
+
+
+// TODO(jakubvrana): Merge with {@code safeHtmlToNode_}.
+/**
+ * Helper for {@code htmlToDocumentFragment}.
+ *
+ * @param {!Document} doc The document.
+ * @param {string} htmlString The HTML string to convert.
+ * @return {!Node} The resulting document fragment.
+ * @private
+ */
+goog.dom.htmlToDocumentFragment_ = function(doc, htmlString) {
+  var tempDiv = doc.createElement(goog.dom.TagName.DIV);
+  if (goog.dom.BrowserFeature.INNER_HTML_NEEDS_SCOPED_ELEMENT) {
+    tempDiv.innerHTML = '<br>' + htmlString;
+    tempDiv.removeChild(tempDiv.firstChild);
+  } else {
+    tempDiv.innerHTML = htmlString;
+  }
+  return goog.dom.childrenToNode_(doc, tempDiv);
+};
+
+
+/**
+ * Helper for {@code htmlToDocumentFragment_}.
+ * @param {!Document} doc The document.
+ * @param {!Node} tempDiv The input node.
+ * @return {!Node} The resulting node.
+ * @private
+ */
+goog.dom.childrenToNode_ = function(doc, tempDiv) {
+  if (tempDiv.childNodes.length == 1) {
+    return tempDiv.removeChild(tempDiv.firstChild);
+  } else {
+    var fragment = doc.createDocumentFragment();
+    while (tempDiv.firstChild) {
+      fragment.appendChild(tempDiv.firstChild);
+    }
+    return fragment;
+  }
+};
+
+
+/**
+ * Returns true if the browser is in "CSS1-compatible" (standards-compliant)
+ * mode, false otherwise.
+ * @return {boolean} True if in CSS1-compatible mode.
+ */
+goog.dom.isCss1CompatMode = function() {
+  return goog.dom.isCss1CompatMode_(document);
+};
+
+
+/**
+ * Returns true if the browser is in "CSS1-compatible" (standards-compliant)
+ * mode, false otherwise.
+ * @param {!Document} doc The document to check.
+ * @return {boolean} True if in CSS1-compatible mode.
+ * @private
+ */
+goog.dom.isCss1CompatMode_ = function(doc) {
+  if (goog.dom.COMPAT_MODE_KNOWN_) {
+    return goog.dom.ASSUME_STANDARDS_MODE;
+  }
+
+  return doc.compatMode == 'CSS1Compat';
+};
+
+
+/**
+ * Determines if the given node can contain children, intended to be used for
+ * HTML generation.
+ *
+ * IE natively supports node.canHaveChildren but has inconsistent behavior.
+ * Prior to IE8 the base tag allows children and in IE9 all nodes return true
+ * for canHaveChildren.
+ *
+ * In practice all non-IE browsers allow you to add children to any node, but
+ * the behavior is inconsistent:
+ *
+ * <pre>
+ *   var a = document.createElement(goog.dom.TagName.BR);
+ *   a.appendChild(document.createTextNode('foo'));
+ *   a.appendChild(document.createTextNode('bar'));
+ *   console.log(a.childNodes.length);  // 2
+ *   console.log(a.innerHTML);  // Chrome: "", IE9: "foobar", FF3.5: "foobar"
+ * </pre>
+ *
+ * For more information, see:
+ * http://dev.w3.org/html5/markup/syntax.html#syntax-elements
+ *
+ * TODO(user): Rename shouldAllowChildren() ?
+ *
+ * @param {Node} node The node to check.
+ * @return {boolean} Whether the node can contain children.
+ */
+goog.dom.canHaveChildren = function(node) {
+  if (node.nodeType != goog.dom.NodeType.ELEMENT) {
+    return false;
+  }
+  switch (/** @type {!Element} */ (node).tagName) {
+    case goog.dom.TagName.APPLET:
+    case goog.dom.TagName.AREA:
+    case goog.dom.TagName.BASE:
+    case goog.dom.TagName.BR:
+    case goog.dom.TagName.COL:
+    case goog.dom.TagName.COMMAND:
+    case goog.dom.TagName.EMBED:
+    case goog.dom.TagName.FRAME:
+    case goog.dom.TagName.HR:
+    case goog.dom.TagName.IMG:
+    case goog.dom.TagName.INPUT:
+    case goog.dom.TagName.IFRAME:
+    case goog.dom.TagName.ISINDEX:
+    case goog.dom.TagName.KEYGEN:
+    case goog.dom.TagName.LINK:
+    case goog.dom.TagName.NOFRAMES:
+    case goog.dom.TagName.NOSCRIPT:
+    case goog.dom.TagName.META:
+    case goog.dom.TagName.OBJECT:
+    case goog.dom.TagName.PARAM:
+    case goog.dom.TagName.SCRIPT:
+    case goog.dom.TagName.SOURCE:
+    case goog.dom.TagName.STYLE:
+    case goog.dom.TagName.TRACK:
+    case goog.dom.TagName.WBR:
+      return false;
+  }
+  return true;
+};
+
+
+/**
+ * Appends a child to a node.
+ * @param {Node} parent Parent.
+ * @param {Node} child Child.
+ */
+goog.dom.appendChild = function(parent, child) {
+  parent.appendChild(child);
+};
+
+
+/**
+ * Appends a node with text or other nodes.
+ * @param {!Node} parent The node to append nodes to.
+ * @param {...goog.dom.Appendable} var_args The things to append to the node.
+ *     If this is a Node it is appended as is.
+ *     If this is a string then a text node is appended.
+ *     If this is an array like object then fields 0 to length - 1 are appended.
+ */
+goog.dom.append = function(parent, var_args) {
+  goog.dom.append_(goog.dom.getOwnerDocument(parent), parent, arguments, 1);
+};
+
+
+/**
+ * Removes all the child nodes on a DOM node.
+ * @param {Node} node Node to remove children from.
+ */
+goog.dom.removeChildren = function(node) {
+  // Note: Iterations over live collections can be slow, this is the fastest
+  // we could find. The double parenthesis are used to prevent JsCompiler and
+  // strict warnings.
+  var child;
+  while ((child = node.firstChild)) {
+    node.removeChild(child);
+  }
+};
+
+
+/**
+ * Inserts a new node before an existing reference node (i.e. as the previous
+ * sibling). If the reference node has no parent, then does nothing.
+ * @param {Node} newNode Node to insert.
+ * @param {Node} refNode Reference node to insert before.
+ */
+goog.dom.insertSiblingBefore = function(newNode, refNode) {
+  if (refNode.parentNode) {
+    refNode.parentNode.insertBefore(newNode, refNode);
+  }
+};
+
+
+/**
+ * Inserts a new node after an existing reference node (i.e. as the next
+ * sibling). If the reference node has no parent, then does nothing.
+ * @param {Node} newNode Node to insert.
+ * @param {Node} refNode Reference node to insert after.
+ */
+goog.dom.insertSiblingAfter = function(newNode, refNode) {
+  if (refNode.parentNode) {
+    refNode.parentNode.insertBefore(newNode, refNode.nextSibling);
+  }
+};
+
+
+/**
+ * Insert a child at a given index. If index is larger than the number of child
+ * nodes that the parent currently has, the node is inserted as the last child
+ * node.
+ * @param {Element} parent The element into which to insert the child.
+ * @param {Node} child The element to insert.
+ * @param {number} index The index at which to insert the new child node. Must
+ *     not be negative.
+ */
+goog.dom.insertChildAt = function(parent, child, index) {
+  // Note that if the second argument is null, insertBefore
+  // will append the child at the end of the list of children.
+  parent.insertBefore(child, parent.childNodes[index] || null);
+};
+
+
+/**
+ * Removes a node from its parent.
+ * @param {Node} node The node to remove.
+ * @return {Node} The node removed if removed; else, null.
+ */
+goog.dom.removeNode = function(node) {
+  return node && node.parentNode ? node.parentNode.removeChild(node) : null;
+};
+
+
+/**
+ * Replaces a node in the DOM tree. Will do nothing if {@code oldNode} has no
+ * parent.
+ * @param {Node} newNode Node to insert.
+ * @param {Node} oldNode Node to replace.
+ */
+goog.dom.replaceNode = function(newNode, oldNode) {
+  var parent = oldNode.parentNode;
+  if (parent) {
+    parent.replaceChild(newNode, oldNode);
+  }
+};
+
+
+/**
+ * Flattens an element. That is, removes it and replace it with its children.
+ * Does nothing if the element is not in the document.
+ * @param {Element} element The element to flatten.
+ * @return {Element|undefined} The original element, detached from the document
+ *     tree, sans children; or undefined, if the element was not in the document
+ *     to begin with.
+ */
+goog.dom.flattenElement = function(element) {
+  var child, parent = element.parentNode;
+  if (parent && parent.nodeType != goog.dom.NodeType.DOCUMENT_FRAGMENT) {
+    // Use IE DOM method (supported by Opera too) if available
+    if (element.removeNode) {
+      return /** @type {Element} */ (element.removeNode(false));
+    } else {
+      // Move all children of the original node up one level.
+      while ((child = element.firstChild)) {
+        parent.insertBefore(child, element);
+      }
+
+      // Detach the original element.
+      return /** @type {Element} */ (goog.dom.removeNode(element));
+    }
+  }
+};
+
+
+/**
+ * Returns an array containing just the element children of the given element.
+ * @param {Element} element The element whose element children we want.
+ * @return {!(Array|NodeList)} An array or array-like list of just the element
+ *     children of the given element.
+ */
+goog.dom.getChildren = function(element) {
+  // We check if the children attribute is supported for child elements
+  // since IE8 misuses the attribute by also including comments.
+  if (goog.dom.BrowserFeature.CAN_USE_CHILDREN_ATTRIBUTE &&
+      element.children != undefined) {
+    return element.children;
+  }
+  // Fall back to manually filtering the element's child nodes.
+  return goog.array.filter(element.childNodes, function(node) {
+    return node.nodeType == goog.dom.NodeType.ELEMENT;
+  });
+};
+
+
+/**
+ * Returns the first child node that is an element.
+ * @param {Node} node The node to get the first child element of.
+ * @return {Element} The first child node of {@code node} that is an element.
+ */
+goog.dom.getFirstElementChild = function(node) {
+  if (goog.isDef(node.firstElementChild)) {
+    return /** @type {!Element} */(node).firstElementChild;
+  }
+  return goog.dom.getNextElementNode_(node.firstChild, true);
+};
+
+
+/**
+ * Returns the last child node that is an element.
+ * @param {Node} node The node to get the last child element of.
+ * @return {Element} The last child node of {@code node} that is an element.
+ */
+goog.dom.getLastElementChild = function(node) {
+  if (goog.isDef(node.lastElementChild)) {
+    return /** @type {!Element} */(node).lastElementChild;
+  }
+  return goog.dom.getNextElementNode_(node.lastChild, false);
+};
+
+
+/**
+ * Returns the first next sibling that is an element.
+ * @param {Node} node The node to get the next sibling element of.
+ * @return {Element} The next sibling of {@code node} that is an element.
+ */
+goog.dom.getNextElementSibling = function(node) {
+  if (goog.isDef(node.nextElementSibling)) {
+    return /** @type {!Element} */(node).nextElementSibling;
+  }
+  return goog.dom.getNextElementNode_(node.nextSibling, true);
+};
+
+
+/**
+ * Returns the first previous sibling that is an element.
+ * @param {Node} node The node to get the previous sibling element of.
+ * @return {Element} The first previous sibling of {@code node} that is
+ *     an element.
+ */
+goog.dom.getPreviousElementSibling = function(node) {
+  if (goog.isDef(node.previousElementSibling)) {
+    return /** @type {!Element} */(node).previousElementSibling;
+  }
+  return goog.dom.getNextElementNode_(node.previousSibling, false);
+};
+
+
+/**
+ * Returns the first node that is an element in the specified direction,
+ * starting with {@code node}.
+ * @param {Node} node The node to get the next element from.
+ * @param {boolean} forward Whether to look forwards or backwards.
+ * @return {Element} The first element.
+ * @private
+ */
+goog.dom.getNextElementNode_ = function(node, forward) {
+  while (node && node.nodeType != goog.dom.NodeType.ELEMENT) {
+    node = forward ? node.nextSibling : node.previousSibling;
+  }
+
+  return /** @type {Element} */ (node);
+};
+
+
+/**
+ * Returns the next node in source order from the given node.
+ * @param {Node} node The node.
+ * @return {Node} The next node in the DOM tree, or null if this was the last
+ *     node.
+ */
+goog.dom.getNextNode = function(node) {
+  if (!node) {
+    return null;
+  }
+
+  if (node.firstChild) {
+    return node.firstChild;
+  }
+
+  while (node && !node.nextSibling) {
+    node = node.parentNode;
+  }
+
+  return node ? node.nextSibling : null;
+};
+
+
+/**
+ * Returns the previous node in source order from the given node.
+ * @param {Node} node The node.
+ * @return {Node} The previous node in the DOM tree, or null if this was the
+ *     first node.
+ */
+goog.dom.getPreviousNode = function(node) {
+  if (!node) {
+    return null;
+  }
+
+  if (!node.previousSibling) {
+    return node.parentNode;
+  }
+
+  node = node.previousSibling;
+  while (node && node.lastChild) {
+    node = node.lastChild;
+  }
+
+  return node;
+};
+
+
+/**
+ * Whether the object looks like a DOM node.
+ * @param {?} obj The object being tested for node likeness.
+ * @return {boolean} Whether the object looks like a DOM node.
+ */
+goog.dom.isNodeLike = function(obj) {
+  return goog.isObject(obj) && obj.nodeType > 0;
+};
+
+
+/**
+ * Whether the object looks like an Element.
+ * @param {?} obj The object being tested for Element likeness.
+ * @return {boolean} Whether the object looks like an Element.
+ */
+goog.dom.isElement = function(obj) {
+  return goog.isObject(obj) && obj.nodeType == goog.dom.NodeType.ELEMENT;
+};
+
+
+/**
+ * Returns true if the specified value is a Window object. This includes the
+ * global window for HTML pages, and iframe windows.
+ * @param {?} obj Variable to test.
+ * @return {boolean} Whether the variable is a window.
+ */
+goog.dom.isWindow = function(obj) {
+  return goog.isObject(obj) && obj['window'] == obj;
+};
+
+
+/**
+ * Returns an element's parent, if it's an Element.
+ * @param {Element} element The DOM element.
+ * @return {Element} The parent, or null if not an Element.
+ */
+goog.dom.getParentElement = function(element) {
+  var parent;
+  if (goog.dom.BrowserFeature.CAN_USE_PARENT_ELEMENT_PROPERTY) {
+    var isIe9 = goog.userAgent.IE &&
+        goog.userAgent.isVersionOrHigher('9') &&
+        !goog.userAgent.isVersionOrHigher('10');
+    // SVG elements in IE9 can't use the parentElement property.
+    // goog.global['SVGElement'] is not defined in IE9 quirks mode.
+    if (!(isIe9 && goog.global['SVGElement'] &&
+        element instanceof goog.global['SVGElement'])) {
+      parent = element.parentElement;
+      if (parent) {
+        return parent;
+      }
+    }
+  }
+  parent = element.parentNode;
+  return goog.dom.isElement(parent) ? /** @type {!Element} */ (parent) : null;
+};
+
+
+/**
+ * Whether a node contains another node.
+ * @param {Node} parent The node that should contain the other node.
+ * @param {Node} descendant The node to test presence of.
+ * @return {boolean} Whether the parent node contains the descendent node.
+ */
+goog.dom.contains = function(parent, descendant) {
+  // We use browser specific methods for this if available since it is faster
+  // that way.
+
+  // IE DOM
+  if (parent.contains && descendant.nodeType == goog.dom.NodeType.ELEMENT) {
+    return parent == descendant || parent.contains(descendant);
+  }
+
+  // W3C DOM Level 3
+  if (typeof parent.compareDocumentPosition != 'undefined') {
+    return parent == descendant ||
+        Boolean(parent.compareDocumentPosition(descendant) & 16);
+  }
+
+  // W3C DOM Level 1
+  while (descendant && parent != descendant) {
+    descendant = descendant.parentNode;
+  }
+  return descendant == parent;
+};
+
+
+/**
+ * Compares the document order of two nodes, returning 0 if they are the same
+ * node, a negative number if node1 is before node2, and a positive number if
+ * node2 is before node1.  Note that we compare the order the tags appear in the
+ * document so in the tree <b><i>text</i></b> the B node is considered to be
+ * before the I node.
+ *
+ * @param {Node} node1 The first node to compare.
+ * @param {Node} node2 The second node to compare.
+ * @return {number} 0 if the nodes are the same node, a negative number if node1
+ *     is before node2, and a positive number if node2 is before node1.
+ */
+goog.dom.compareNodeOrder = function(node1, node2) {
+  // Fall out quickly for equality.
+  if (node1 == node2) {
+    return 0;
+  }
+
+  // Use compareDocumentPosition where available
+  if (node1.compareDocumentPosition) {
+    // 4 is the bitmask for FOLLOWS.
+    return node1.compareDocumentPosition(node2) & 2 ? 1 : -1;
+  }
+
+  // Special case for document nodes on IE 7 and 8.
+  if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9)) {
+    if (node1.nodeType == goog.dom.NodeType.DOCUMENT) {
+      return -1;
+    }
+    if (node2.nodeType == goog.dom.NodeType.DOCUMENT) {
+      return 1;
+    }
+  }
+
+  // Process in IE using sourceIndex - we check to see if the first node has
+  // a source index or if its parent has one.
+  if ('sourceIndex' in node1 ||
+      (node1.parentNode && 'sourceIndex' in node1.parentNode)) {
+    var isElement1 = node1.nodeType == goog.dom.NodeType.ELEMENT;
+    var isElement2 = node2.nodeType == goog.dom.NodeType.ELEMENT;
+
+    if (isElement1 && isElement2) {
+      return node1.sourceIndex - node2.sourceIndex;
+    } else {
+      var parent1 = node1.parentNode;
+      var parent2 = node2.parentNode;
+
+      if (parent1 == parent2) {
+        return goog.dom.compareSiblingOrder_(node1, node2);
+      }
+
+      if (!isElement1 && goog.dom.contains(parent1, node2)) {
+        return -1 * goog.dom.compareParentsDescendantNodeIe_(node1, node2);
+      }
+
+
+      if (!isElement2 && goog.dom.contains(parent2, node1)) {
+        return goog.dom.compareParentsDescendantNodeIe_(node2, node1);
+      }
+
+      return (isElement1 ? node1.sourceIndex : parent1.sourceIndex) -
+             (isElement2 ? node2.sourceIndex : parent2.sourceIndex);
+    }
+  }
+
+  // For Safari, we compare ranges.
+  var doc = goog.dom.getOwnerDocument(node1);
+
+  var range1, range2;
+  range1 = doc.createRange();
+  range1.selectNode(node1);
+  range1.collapse(true);
+
+  range2 = doc.createRange();
+  range2.selectNode(node2);
+  range2.collapse(true);
+
+  return range1.compareBoundaryPoints(goog.global['Range'].START_TO_END,
+      range2);
+};
+
+
+/**
+ * Utility function to compare the position of two nodes, when
+ * {@code textNode}'s parent is an ancestor of {@code node}.  If this entry
+ * condition is not met, this function will attempt to reference a null object.
+ * @param {!Node} textNode The textNode to compare.
+ * @param {Node} node The node to compare.
+ * @return {number} -1 if node is before textNode, +1 otherwise.
+ * @private
+ */
+goog.dom.compareParentsDescendantNodeIe_ = function(textNode, node) {
+  var parent = textNode.parentNode;
+  if (parent == node) {
+    // If textNode is a child of node, then node comes first.
+    return -1;
+  }
+  var sibling = node;
+  while (sibling.parentNode != parent) {
+    sibling = sibling.parentNode;
+  }
+  return goog.dom.compareSiblingOrder_(sibling, textNode);
+};
+
+
+/**
+ * Utility function to compare the position of two nodes known to be non-equal
+ * siblings.
+ * @param {Node} node1 The first node to compare.
+ * @param {!Node} node2 The second node to compare.
+ * @return {number} -1 if node1 is before node2, +1 otherwise.
+ * @private
+ */
+goog.dom.compareSiblingOrder_ = function(node1, node2) {
+  var s = node2;
+  while ((s = s.previousSibling)) {
+    if (s == node1) {
+      // We just found node1 before node2.
+      return -1;
+    }
+  }
+
+  // Since we didn't find it, node1 must be after node2.
+  return 1;
+};
+
+
+/**
+ * Find the deepest common ancestor of the given nodes.
+ * @param {...Node} var_args The nodes to find a common ancestor of.
+ * @return {Node} The common ancestor of the nodes, or null if there is none.
+ *     null will only be returned if two or more of the nodes are from different
+ *     documents.
+ */
+goog.dom.findCommonAncestor = function(var_args) {
+  var i, count = arguments.length;
+  if (!count) {
+    return null;
+  } else if (count == 1) {
+    return arguments[0];
+  }
+
+  var paths = [];
+  var minLength = Infinity;
+  for (i = 0; i < count; i++) {
+    // Compute the list of ancestors.
+    var ancestors = [];
+    var node = arguments[i];
+    while (node) {
+      ancestors.unshift(node);
+      node = node.parentNode;
+    }
+
+    // Save the list for comparison.
+    paths.push(ancestors);
+    minLength = Math.min(minLength, ancestors.length);
+  }
+  var output = null;
+  for (i = 0; i < minLength; i++) {
+    var first = paths[0][i];
+    for (var j = 1; j < count; j++) {
+      if (first != paths[j][i]) {
+        return output;
+      }
+    }
+    output = first;
+  }
+  return output;
+};
+
+
+/**
+ * Returns the owner document for a node.
+ * @param {Node|Window} node The node to get the document for.
+ * @return {!Document} The document owning the node.
+ */
+goog.dom.getOwnerDocument = function(node) {
+  // TODO(nnaze): Update param signature to be non-nullable.
+  goog.asserts.assert(node, 'Node cannot be null or undefined.');
+  return /** @type {!Document} */ (
+      node.nodeType == goog.dom.NodeType.DOCUMENT ? node :
+      node.ownerDocument || node.document);
+};
+
+
+/**
+ * Cross-browser function for getting the document element of a frame or iframe.
+ * @param {Element} frame Frame element.
+ * @return {!Document} The frame content document.
+ */
+goog.dom.getFrameContentDocument = function(frame) {
+  var doc = frame.contentDocument || frame.contentWindow.document;
+  return doc;
+};
+
+
+/**
+ * Cross-browser function for getting the window of a frame or iframe.
+ * @param {Element} frame Frame element.
+ * @return {Window} The window associated with the given frame.
+ */
+goog.dom.getFrameContentWindow = function(frame) {
+  return frame.contentWindow ||
+      goog.dom.getWindow(goog.dom.getFrameContentDocument(frame));
+};
+
+
+/**
+ * Sets the text content of a node, with cross-browser support.
+ * @param {Node} node The node to change the text content of.
+ * @param {string|number} text The value that should replace the node's content.
+ */
+goog.dom.setTextContent = function(node, text) {
+  goog.asserts.assert(node != null,
+      'goog.dom.setTextContent expects a non-null value for node');
+
+  if ('textContent' in node) {
+    node.textContent = text;
+  } else if (node.nodeType == goog.dom.NodeType.TEXT) {
+    node.data = text;
+  } else if (node.firstChild &&
+             node.firstChild.nodeType == goog.dom.NodeType.TEXT) {
+    // If the first child is a text node we just change its data and remove the
+    // rest of the children.
+    while (node.lastChild != node.firstChild) {
+      node.removeChild(node.lastChild);
+    }
+    node.firstChild.data = text;
+  } else {
+    goog.dom.removeChildren(node);
+    var doc = goog.dom.getOwnerDocument(node);
+    node.appendChild(doc.createTextNode(String(text)));
+  }
+};
+
+
+/**
+ * Gets the outerHTML of a node, which islike innerHTML, except that it
+ * actually contains the HTML of the node itself.
+ * @param {Element} element The element to get the HTML of.
+ * @return {string} The outerHTML of the given element.
+ */
+goog.dom.getOuterHtml = function(element) {
+  // IE, Opera and WebKit all have outerHTML.
+  if ('outerHTML' in element) {
+    return element.outerHTML;
+  } else {
+    var doc = goog.dom.getOwnerDocument(element);
+    var div = doc.createElement(goog.dom.TagName.DIV);
+    div.appendChild(element.cloneNode(true));
+    return div.innerHTML;
+  }
+};
+
+
+/**
+ * Finds the first descendant node that matches the filter function, using
+ * a depth first search. This function offers the most general purpose way
+ * of finding a matching element. You may also wish to consider
+ * {@code goog.dom.query} which can express many matching criteria using
+ * CSS selector expressions. These expressions often result in a more
+ * compact representation of the desired result.
+ * @see goog.dom.query
+ *
+ * @param {Node} root The root of the tree to search.
+ * @param {function(Node) : boolean} p The filter function.
+ * @return {Node|undefined} The found node or undefined if none is found.
+ */
+goog.dom.findNode = function(root, p) {
+  var rv = [];
+  var found = goog.dom.findNodes_(root, p, rv, true);
+  return found ? rv[0] : undefined;
+};
+
+
+/**
+ * Finds all the descendant nodes that match the filter function, using a
+ * a depth first search. This function offers the most general-purpose way
+ * of finding a set of matching elements. You may also wish to consider
+ * {@code goog.dom.query} which can express many matching criteria using
+ * CSS selector expressions. These expressions often result in a more
+ * compact representation of the desired result.
+
+ * @param {Node} root The root of the tree to search.
+ * @param {function(Node) : boolean} p The filter function.
+ * @return {!Array<!Node>} The found nodes or an empty array if none are found.
+ */
+goog.dom.findNodes = function(root, p) {
+  var rv = [];
+  goog.dom.findNodes_(root, p, rv, false);
+  return rv;
+};
+
+
+/**
+ * Finds the first or all the descendant nodes that match the filter function,
+ * using a depth first search.
+ * @param {Node} root The root of the tree to search.
+ * @param {function(Node) : boolean} p The filter function.
+ * @param {!Array<!Node>} rv The found nodes are added to this array.
+ * @param {boolean} findOne If true we exit after the first found node.
+ * @return {boolean} Whether the search is complete or not. True in case findOne
+ *     is true and the node is found. False otherwise.
+ * @private
+ */
+goog.dom.findNodes_ = function(root, p, rv, findOne) {
+  if (root != null) {
+    var child = root.firstChild;
+    while (child) {
+      if (p(child)) {
+        rv.push(child);
+        if (findOne) {
+          return true;
+        }
+      }
+      if (goog.dom.findNodes_(child, p, rv, findOne)) {
+        return true;
+      }
+      child = child.nextSibling;
+    }
+  }
+  return false;
+};
+
+
+/**
+ * Map of tags whose content to ignore when calculating text length.
+ * @private {!Object<string, number>}
+ * @const
+ */
+goog.dom.TAGS_TO_IGNORE_ = {
+  'SCRIPT': 1,
+  'STYLE': 1,
+  'HEAD': 1,
+  'IFRAME': 1,
+  'OBJECT': 1
+};
+
+
+/**
+ * Map of tags which have predefined values with regard to whitespace.
+ * @private {!Object<string, string>}
+ * @const
+ */
+goog.dom.PREDEFINED_TAG_VALUES_ = {'IMG': ' ', 'BR': '\n'};
+
+
+/**
+ * Returns true if the element has a tab index that allows it to receive
+ * keyboard focus (tabIndex >= 0), false otherwise.  Note that some elements
+ * natively support keyboard focus, even if they have no tab index.
+ * @param {!Element} element Element to check.
+ * @return {boolean} Whether the element has a tab index that allows keyboard
+ *     focus.
+ * @see http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/
+ */
+goog.dom.isFocusableTabIndex = function(element) {
+  return goog.dom.hasSpecifiedTabIndex_(element) &&
+         goog.dom.isTabIndexFocusable_(element);
+};
+
+
+/**
+ * Enables or disables keyboard focus support on the element via its tab index.
+ * Only elements for which {@link goog.dom.isFocusableTabIndex} returns true
+ * (or elements that natively support keyboard focus, like form elements) can
+ * receive keyboard focus.  See http://go/tabindex for more info.
+ * @param {Element} element Element whose tab index is to be changed.
+ * @param {boolean} enable Whether to set or remove a tab index on the element
+ *     that supports keyboard focus.
+ */
+goog.dom.setFocusableTabIndex = function(element, enable) {
+  if (enable) {
+    element.tabIndex = 0;
+  } else {
+    // Set tabIndex to -1 first, then remove it. This is a workaround for
+    // Safari (confirmed in version 4 on Windows). When removing the attribute
+    // without setting it to -1 first, the element remains keyboard focusable
+    // despite not having a tabIndex attribute anymore.
+    element.tabIndex = -1;
+    element.removeAttribute('tabIndex'); // Must be camelCase!
+  }
+};
+
+
+/**
+ * Returns true if the element can be focused, i.e. it has a tab index that
+ * allows it to receive keyboard focus (tabIndex >= 0), or it is an element
+ * that natively supports keyboard focus.
+ * @param {!Element} element Element to check.
+ * @return {boolean} Whether the element allows keyboard focus.
+ */
+goog.dom.isFocusable = function(element) {
+  var focusable;
+  // Some elements can have unspecified tab index and still receive focus.
+  if (goog.dom.nativelySupportsFocus_(element)) {
+    // Make sure the element is not disabled ...
+    focusable = !element.disabled &&
+        // ... and if a tab index is specified, it allows focus.
+        (!goog.dom.hasSpecifiedTabIndex_(element) ||
+         goog.dom.isTabIndexFocusable_(element));
+  } else {
+    focusable = goog.dom.isFocusableTabIndex(element);
+  }
+
+  // IE requires elements to be visible in order to focus them.
+  return focusable && goog.userAgent.IE ?
+             goog.dom.hasNonZeroBoundingRect_(element) : focusable;
+};
+
+
+/**
+ * Returns true if the element has a specified tab index.
+ * @param {!Element} element Element to check.
+ * @return {boolean} Whether the element has a specified tab index.
+ * @private
+ */
+goog.dom.hasSpecifiedTabIndex_ = function(element) {
+  // IE returns 0 for an unset tabIndex, so we must use getAttributeNode(),
+  // which returns an object with a 'specified' property if tabIndex is
+  // specified.  This works on other browsers, too.
+  var attrNode = element.getAttributeNode('tabindex'); // Must be lowercase!
+  return goog.isDefAndNotNull(attrNode) && attrNode.specified;
+};
+
+
+/**
+ * Returns true if the element's tab index allows the element to be focused.
+ * @param {!Element} element Element to check.
+ * @return {boolean} Whether the element's tab index allows focus.
+ * @private
+ */
+goog.dom.isTabIndexFocusable_ = function(element) {
+  var index = element.tabIndex;
+  // NOTE: IE9 puts tabIndex in 16-bit int, e.g. -2 is 65534.
+  return goog.isNumber(index) && index >= 0 && index < 32768;
+};
+
+
+/**
+ * Returns true if the element is focusable even when tabIndex is not set.
+ * @param {!Element} element Element to check.
+ * @return {boolean} Whether the element natively supports focus.
+ * @private
+ */
+goog.dom.nativelySupportsFocus_ = function(element) {
+  return element.tagName == goog.dom.TagName.A ||
+         element.tagName == goog.dom.TagName.INPUT ||
+         element.tagName == goog.dom.TagName.TEXTAREA ||
+         element.tagName == goog.dom.TagName.SELECT ||
+         element.tagName == goog.dom.TagName.BUTTON;
+};
+
+
+/**
+ * Returns true if the element has a bounding rectangle that would be visible
+ * (i.e. its width and height are greater than zero).
+ * @param {!Element} element Element to check.
+ * @return {boolean} Whether the element has a non-zero bounding rectangle.
+ * @private
+ */
+goog.dom.hasNonZeroBoundingRect_ = function(element) {
+  var rect = goog.isFunction(element['getBoundingClientRect']) ?
+      element.getBoundingClientRect() :
+      {'height': element.offsetHeight, 'width': element.offsetWidth};
+  return goog.isDefAndNotNull(rect) && rect.height > 0 && rect.width > 0;
+};
+
+
+/**
+ * Returns the text content of the current node, without markup and invisible
+ * symbols. New lines are stripped and whitespace is collapsed,
+ * such that each character would be visible.
+ *
+ * In browsers that support it, innerText is used.  Other browsers attempt to
+ * simulate it via node traversal.  Line breaks are canonicalized in IE.
+ *
+ * @param {Node} node The node from which we are getting content.
+ * @return {string} The text content.
+ */
+goog.dom.getTextContent = function(node) {
+  var textContent;
+  // Note(arv): IE9, Opera, and Safari 3 support innerText but they include
+  // text nodes in script tags. So we revert to use a user agent test here.
+  if (goog.dom.BrowserFeature.CAN_USE_INNER_TEXT && ('innerText' in node)) {
+    textContent = goog.string.canonicalizeNewlines(node.innerText);
+    // Unfortunately .innerText() returns text with &shy; symbols
+    // We need to filter it out and then remove duplicate whitespaces
+  } else {
+    var buf = [];
+    goog.dom.getTextContent_(node, buf, true);
+    textContent = buf.join('');
+  }
+
+  // Strip &shy; entities. goog.format.insertWordBreaks inserts them in Opera.
+  textContent = textContent.replace(/ \xAD /g, ' ').replace(/\xAD/g, '');
+  // Strip &#8203; entities. goog.format.insertWordBreaks inserts them in IE8.
+  textContent = textContent.replace(/\u200B/g, '');
+
+  // Skip this replacement on old browsers with working innerText, which
+  // automatically turns &nbsp; into ' ' and / +/ into ' ' when reading
+  // innerText.
+  if (!goog.dom.BrowserFeature.CAN_USE_INNER_TEXT) {
+    textContent = textContent.replace(/ +/g, ' ');
+  }
+  if (textContent != ' ') {
+    textContent = textContent.replace(/^\s*/, '');
+  }
+
+  return textContent;
+};
+
+
+/**
+ * Returns the text content of the current node, without markup.
+ *
+ * Unlike {@code getTextContent} this method does not collapse whitespaces
+ * or normalize lines breaks.
+ *
+ * @param {Node} node The node from which we are getting content.
+ * @return {string} The raw text content.
+ */
+goog.dom.getRawTextContent = function(node) {
+  var buf = [];
+  goog.dom.getTextContent_(node, buf, false);
+
+  return buf.join('');
+};
+
+
+/**
+ * Recursive support function for text content retrieval.
+ *
+ * @param {Node} node The node from which we are getting content.
+ * @param {Array<string>} buf string buffer.
+ * @param {boolean} normalizeWhitespace Whether to normalize whitespace.
+ * @private
+ */
+goog.dom.getTextContent_ = function(node, buf, normalizeWhitespace) {
+  if (node.nodeName in goog.dom.TAGS_TO_IGNORE_) {
+    // ignore certain tags
+  } else if (node.nodeType == goog.dom.NodeType.TEXT) {
+    if (normalizeWhitespace) {
+      buf.push(String(node.nodeValue).replace(/(\r\n|\r|\n)/g, ''));
+    } else {
+      buf.push(node.nodeValue);
+    }
+  } else if (node.nodeName in goog.dom.PREDEFINED_TAG_VALUES_) {
+    buf.push(goog.dom.PREDEFINED_TAG_VALUES_[node.nodeName]);
+  } else {
+    var child = node.firstChild;
+    while (child) {
+      goog.dom.getTextContent_(child, buf, normalizeWhitespace);
+      child = child.nextSibling;
+    }
+  }
+};
+
+
+/**
+ * Returns the text length of the text contained in a node, without markup. This
+ * is equivalent to the selection length if the node was selected, or the number
+ * of cursor movements to traverse the node. Images & BRs take one space.  New
+ * lines are ignored.
+ *
+ * @param {Node} node The node whose text content length is being calculated.
+ * @return {number} The length of {@code node}'s text content.
+ */
+goog.dom.getNodeTextLength = function(node) {
+  return goog.dom.getTextContent(node).length;
+};
+
+
+/**
+ * Returns the text offset of a node relative to one of its ancestors. The text
+ * length is the same as the length calculated by goog.dom.getNodeTextLength.
+ *
+ * @param {Node} node The node whose offset is being calculated.
+ * @param {Node=} opt_offsetParent The node relative to which the offset will
+ *     be calculated. Defaults to the node's owner document's body.
+ * @return {number} The text offset.
+ */
+goog.dom.getNodeTextOffset = function(node, opt_offsetParent) {
+  var root = opt_offsetParent || goog.dom.getOwnerDocument(node).body;
+  var buf = [];
+  while (node && node != root) {
+    var cur = node;
+    while ((cur = cur.previousSibling)) {
+      buf.unshift(goog.dom.getTextContent(cur));
+    }
+    node = node.parentNode;
+  }
+  // Trim left to deal with FF cases when there might be line breaks and empty
+  // nodes at the front of the text
+  return goog.string.trimLeft(buf.join('')).replace(/ +/g, ' ').length;
+};
+
+
+/**
+ * Returns the node at a given offset in a parent node.  If an object is
+ * provided for the optional third parameter, the node and the remainder of the
+ * offset will stored as properties of this object.
+ * @param {Node} parent The parent node.
+ * @param {number} offset The offset into the parent node.
+ * @param {Object=} opt_result Object to be used to store the return value. The
+ *     return value will be stored in the form {node: Node, remainder: number}
+ *     if this object is provided.
+ * @return {Node} The node at the given offset.
+ */
+goog.dom.getNodeAtOffset = function(parent, offset, opt_result) {
+  var stack = [parent], pos = 0, cur = null;
+  while (stack.length > 0 && pos < offset) {
+    cur = stack.pop();
+    if (cur.nodeName in goog.dom.TAGS_TO_IGNORE_) {
+      // ignore certain tags
+    } else if (cur.nodeType == goog.dom.NodeType.TEXT) {
+      var text = cur.nodeValue.replace(/(\r\n|\r|\n)/g, '').replace(/ +/g, ' ');
+      pos += text.length;
+    } else if (cur.nodeName in goog.dom.PREDEFINED_TAG_VALUES_) {
+      pos += goog.dom.PREDEFINED_TAG_VALUES_[cur.nodeName].length;
+    } else {
+      for (var i = cur.childNodes.length - 1; i >= 0; i--) {
+        stack.push(cur.childNodes[i]);
+      }
+    }
+  }
+  if (goog.isObject(opt_result)) {
+    opt_result.remainder = cur ? cur.nodeValue.length + offset - pos - 1 : 0;
+    opt_result.node = cur;
+  }
+
+  return cur;
+};
+
+
+/**
+ * Returns true if the object is a {@code NodeList}.  To qualify as a NodeList,
+ * the object must have a numeric length property and an item function (which
+ * has type 'string' on IE for some reason).
+ * @param {Object} val Object to test.
+ * @return {boolean} Whether the object is a NodeList.
+ */
+goog.dom.isNodeList = function(val) {
+  // TODO(attila): Now the isNodeList is part of goog.dom we can use
+  // goog.userAgent to make this simpler.
+  // A NodeList must have a length property of type 'number' on all platforms.
+  if (val && typeof val.length == 'number') {
+    // A NodeList is an object everywhere except Safari, where it's a function.
+    if (goog.isObject(val)) {
+      // A NodeList must have an item function (on non-IE platforms) or an item
+      // property of type 'string' (on IE).
+      return typeof val.item == 'function' || typeof val.item == 'string';
+    } else if (goog.isFunction(val)) {
+      // On Safari, a NodeList is a function with an item property that is also
+      // a function.
+      return typeof val.item == 'function';
+    }
+  }
+
+  // Not a NodeList.
+  return false;
+};
+
+
+/**
+ * Walks up the DOM hierarchy returning the first ancestor that has the passed
+ * tag name and/or class name. If the passed element matches the specified
+ * criteria, the element itself is returned.
+ * @param {Node} element The DOM node to start with.
+ * @param {?(goog.dom.TagName|string)=} opt_tag The tag name to match (or
+ *     null/undefined to match only based on class name).
+ * @param {?string=} opt_class The class name to match (or null/undefined to
+ *     match only based on tag name).
+ * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the
+ *     dom.
+ * @return {Element} The first ancestor that matches the passed criteria, or
+ *     null if no match is found.
+ */
+goog.dom.getAncestorByTagNameAndClass = function(element, opt_tag, opt_class,
+    opt_maxSearchSteps) {
+  if (!opt_tag && !opt_class) {
+    return null;
+  }
+  var tagName = opt_tag ? opt_tag.toUpperCase() : null;
+  return /** @type {Element} */ (goog.dom.getAncestor(element,
+      function(node) {
+        return (!tagName || node.nodeName == tagName) &&
+               (!opt_class || goog.isString(node.className) &&
+                   goog.array.contains(node.className.split(/\s+/), opt_class));
+      }, true, opt_maxSearchSteps));
+};
+
+
+/**
+ * Walks up the DOM hierarchy returning the first ancestor that has the passed
+ * class name. If the passed element matches the specified criteria, the
+ * element itself is returned.
+ * @param {Node} element The DOM node to start with.
+ * @param {string} className The class name to match.
+ * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the
+ *     dom.
+ * @return {Element} The first ancestor that matches the passed criteria, or
+ *     null if none match.
+ */
+goog.dom.getAncestorByClass = function(element, className, opt_maxSearchSteps) {
+  return goog.dom.getAncestorByTagNameAndClass(element, null, className,
+      opt_maxSearchSteps);
+};
+
+
+/**
+ * Walks up the DOM hierarchy returning the first ancestor that passes the
+ * matcher function.
+ * @param {Node} element The DOM node to start with.
+ * @param {function(Node) : boolean} matcher A function that returns true if the
+ *     passed node matches the desired criteria.
+ * @param {boolean=} opt_includeNode If true, the node itself is included in
+ *     the search (the first call to the matcher will pass startElement as
+ *     the node to test).
+ * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the
+ *     dom.
+ * @return {Node} DOM node that matched the matcher, or null if there was
+ *     no match.
+ */
+goog.dom.getAncestor = function(
+    element, matcher, opt_includeNode, opt_maxSearchSteps) {
+  if (!opt_includeNode) {
+    element = element.parentNode;
+  }
+  var ignoreSearchSteps = opt_maxSearchSteps == null;
+  var steps = 0;
+  while (element && (ignoreSearchSteps || steps <= opt_maxSearchSteps)) {
+    goog.asserts.assert(element.name != 'parentNode');
+    if (matcher(element)) {
+      return element;
+    }
+    element = element.parentNode;
+    steps++;
+  }
+  // Reached the root of the DOM without a match
+  return null;
+};
+
+
+/**
+ * Determines the active element in the given document.
+ * @param {Document} doc The document to look in.
+ * @return {Element} The active element.
+ */
+goog.dom.getActiveElement = function(doc) {
+  try {
+    return doc && doc.activeElement;
+  } catch (e) {
+    // NOTE(nicksantos): Sometimes, evaluating document.activeElement in IE
+    // throws an exception. I'm not 100% sure why, but I suspect it chokes
+    // on document.activeElement if the activeElement has been recently
+    // removed from the DOM by a JS operation.
+    //
+    // We assume that an exception here simply means
+    // "there is no active element."
+  }
+
+  return null;
+};
+
+
+/**
+ * Gives the current devicePixelRatio.
+ *
+ * By default, this is the value of window.devicePixelRatio (which should be
+ * preferred if present).
+ *
+ * If window.devicePixelRatio is not present, the ratio is calculated with
+ * window.matchMedia, if present. Otherwise, gives 1.0.
+ *
+ * Some browsers (including Chrome) consider the browser zoom level in the pixel
+ * ratio, so the value may change across multiple calls.
+ *
+ * @return {number} The number of actual pixels per virtual pixel.
+ */
+goog.dom.getPixelRatio = function() {
+  var win = goog.dom.getWindow();
+  if (goog.isDef(win.devicePixelRatio)) {
+    return win.devicePixelRatio;
+  } else if (win.matchMedia) {
+    return goog.dom.matchesPixelRatio_(.75) ||
+           goog.dom.matchesPixelRatio_(1.5) ||
+           goog.dom.matchesPixelRatio_(2) ||
+           goog.dom.matchesPixelRatio_(3) || 1;
+  }
+  return 1;
+};
+
+
+/**
+ * Calculates a mediaQuery to check if the current device supports the
+ * given actual to virtual pixel ratio.
+ * @param {number} pixelRatio The ratio of actual pixels to virtual pixels.
+ * @return {number} pixelRatio if applicable, otherwise 0.
+ * @private
+ */
+goog.dom.matchesPixelRatio_ = function(pixelRatio) {
+  var win = goog.dom.getWindow();
+  var query = ('(-webkit-min-device-pixel-ratio: ' + pixelRatio + '),' +
+               '(min--moz-device-pixel-ratio: ' + pixelRatio + '),' +
+               '(min-resolution: ' + pixelRatio + 'dppx)');
+  return win.matchMedia(query).matches ? pixelRatio : 0;
+};
+
+
+
+/**
+ * Create an instance of a DOM helper with a new document object.
+ * @param {Document=} opt_document Document object to associate with this
+ *     DOM helper.
+ * @constructor
+ */
+goog.dom.DomHelper = function(opt_document) {
+  /**
+   * Reference to the document object to use
+   * @type {!Document}
+   * @private
+   */
+  this.document_ = opt_document || goog.global.document || document;
+};
+
+
+/**
+ * Gets the dom helper object for the document where the element resides.
+ * @param {Node=} opt_node If present, gets the DomHelper for this node.
+ * @return {!goog.dom.DomHelper} The DomHelper.
+ */
+goog.dom.DomHelper.prototype.getDomHelper = goog.dom.getDomHelper;
+
+
+/**
+ * Sets the document object.
+ * @param {!Document} document Document object.
+ */
+goog.dom.DomHelper.prototype.setDocument = function(document) {
+  this.document_ = document;
+};
+
+
+/**
+ * Gets the document object being used by the dom library.
+ * @return {!Document} Document object.
+ */
+goog.dom.DomHelper.prototype.getDocument = function() {
+  return this.document_;
+};
+
+
+/**
+ * Alias for {@code getElementById}. If a DOM node is passed in then we just
+ * return that.
+ * @param {string|Element} element Element ID or a DOM node.
+ * @return {Element} The element with the given ID, or the node passed in.
+ */
+goog.dom.DomHelper.prototype.getElement = function(element) {
+  return goog.dom.getElementHelper_(this.document_, element);
+};
+
+
+/**
+ * Gets an element by id, asserting that the element is found.
+ *
+ * This is used when an element is expected to exist, and should fail with
+ * an assertion error if it does not (if assertions are enabled).
+ *
+ * @param {string} id Element ID.
+ * @return {!Element} The element with the given ID, if it exists.
+ */
+goog.dom.DomHelper.prototype.getRequiredElement = function(id) {
+  return goog.dom.getRequiredElementHelper_(this.document_, id);
+};
+
+
+/**
+ * Alias for {@code getElement}.
+ * @param {string|Element} element Element ID or a DOM node.
+ * @return {Element} The element with the given ID, or the node passed in.
+ * @deprecated Use {@link goog.dom.DomHelper.prototype.getElement} instead.
+ */
+goog.dom.DomHelper.prototype.$ = goog.dom.DomHelper.prototype.getElement;
+
+
+/**
+ * Looks up elements by both tag and class name, using browser native functions
+ * ({@code querySelectorAll}, {@code getElementsByTagName} or
+ * {@code getElementsByClassName}) where possible. The returned array is a live
+ * NodeList or a static list depending on the code path taken.
+ *
+ * @see goog.dom.query
+ *
+ * @param {?string=} opt_tag Element tag name or * for all tags.
+ * @param {?string=} opt_class Optional class name.
+ * @param {(Document|Element)=} opt_el Optional element to look in.
+ * @return { {length: number} } Array-like list of elements (only a length
+ *     property and numerical indices are guaranteed to exist).
+ */
+goog.dom.DomHelper.prototype.getElementsByTagNameAndClass = function(opt_tag,
+                                                                     opt_class,
+                                                                     opt_el) {
+  return goog.dom.getElementsByTagNameAndClass_(this.document_, opt_tag,
+                                                opt_class, opt_el);
+};
+
+
+/**
+ * Returns an array of all the elements with the provided className.
+ * @see {goog.dom.query}
+ * @param {string} className the name of the class to look for.
+ * @param {Element|Document=} opt_el Optional element to look in.
+ * @return { {length: number} } The items found with the class name provided.
+ */
+goog.dom.DomHelper.prototype.getElementsByClass = function(className, opt_el) {
+  var doc = opt_el || this.document_;
+  return goog.dom.getElementsByClass(className, doc);
+};
+
+
+/**
+ * Returns the first element we find matching the provided class name.
+ * @see {goog.dom.query}
+ * @param {string} className the name of the class to look for.
+ * @param {(Element|Document)=} opt_el Optional element to look in.
+ * @return {Element} The first item found with the class name provided.
+ */
+goog.dom.DomHelper.prototype.getElementByClass = function(className, opt_el) {
+  var doc = opt_el || this.document_;
+  return goog.dom.getElementByClass(className, doc);
+};
+
+
+/**
+ * Ensures an element with the given className exists, and then returns the
+ * first element with the provided className.
+ * @see {goog.dom.query}
+ * @param {string} className the name of the class to look for.
+ * @param {(!Element|!Document)=} opt_root Optional element or document to look
+ *     in.
+ * @return {!Element} The first item found with the class name provided.
+ * @throws {goog.asserts.AssertionError} Thrown if no element is found.
+ */
+goog.dom.DomHelper.prototype.getRequiredElementByClass = function(className,
+                                                                  opt_root) {
+  var root = opt_root || this.document_;
+  return goog.dom.getRequiredElementByClass(className, root);
+};
+
+
+/**
+ * Alias for {@code getElementsByTagNameAndClass}.
+ * @deprecated Use DomHelper getElementsByTagNameAndClass.
+ * @see goog.dom.query
+ *
+ * @param {?string=} opt_tag Element tag name.
+ * @param {?string=} opt_class Optional class name.
+ * @param {Element=} opt_el Optional element to look in.
+ * @return { {length: number} } Array-like list of elements (only a length
+ *     property and numerical indices are guaranteed to exist).
+ */
+goog.dom.DomHelper.prototype.$$ =
+    goog.dom.DomHelper.prototype.getElementsByTagNameAndClass;
+
+
+/**
+ * Sets a number of properties on a node.
+ * @param {Element} element DOM node to set properties on.
+ * @param {Object} properties Hash of property:value pairs.
+ */
+goog.dom.DomHelper.prototype.setProperties = goog.dom.setProperties;
+
+
+/**
+ * Gets the dimensions of the viewport.
+ * @param {Window=} opt_window Optional window element to test. Defaults to
+ *     the window of the Dom Helper.
+ * @return {!goog.math.Size} Object with values 'width' and 'height'.
+ */
+goog.dom.DomHelper.prototype.getViewportSize = function(opt_window) {
+  // TODO(arv): This should not take an argument. That breaks the rule of a
+  // a DomHelper representing a single frame/window/document.
+  return goog.dom.getViewportSize(opt_window || this.getWindow());
+};
+
+
+/**
+ * Calculates the height of the document.
+ *
+ * @return {number} The height of the document.
+ */
+goog.dom.DomHelper.prototype.getDocumentHeight = function() {
+  return goog.dom.getDocumentHeight_(this.getWindow());
+};
+
+
+/**
+ * Typedef for use with goog.dom.createDom and goog.dom.append.
+ * @typedef {Object|string|Array|NodeList}
+ */
+goog.dom.Appendable;
+
+
+/**
+ * Returns a dom node with a set of attributes.  This function accepts varargs
+ * for subsequent nodes to be added.  Subsequent nodes will be added to the
+ * first node as childNodes.
+ *
+ * So:
+ * <code>createDom('div', null, createDom('p'), createDom('p'));</code>
+ * would return a div with two child paragraphs
+ *
+ * An easy way to move all child nodes of an existing element to a new parent
+ * element is:
+ * <code>createDom('div', null, oldElement.childNodes);</code>
+ * which will remove all child nodes from the old element and add them as
+ * child nodes of the new DIV.
+ *
+ * @param {string} tagName Tag to create.
+ * @param {Object|string=} opt_attributes If object, then a map of name-value
+ *     pairs for attributes. If a string, then this is the className of the new
+ *     element.
+ * @param {...goog.dom.Appendable} var_args Further DOM nodes or
+ *     strings for text nodes. If one of the var_args is an array or
+ *     NodeList, its elements will be added as childNodes instead.
+ * @return {!Element} Reference to a DOM node.
+ */
+goog.dom.DomHelper.prototype.createDom = function(tagName,
+                                                  opt_attributes,
+                                                  var_args) {
+  return goog.dom.createDom_(this.document_, arguments);
+};
+
+
+/**
+ * Alias for {@code createDom}.
+ * @param {string} tagName Tag to create.
+ * @param {(Object|string)=} opt_attributes If object, then a map of name-value
+ *     pairs for attributes. If a string, then this is the className of the new
+ *     element.
+ * @param {...goog.dom.Appendable} var_args Further DOM nodes or strings for
+ *     text nodes.  If one of the var_args is an array, its children will be
+ *     added as childNodes instead.
+ * @return {!Element} Reference to a DOM node.
+ * @deprecated Use {@link goog.dom.DomHelper.prototype.createDom} instead.
+ */
+goog.dom.DomHelper.prototype.$dom = goog.dom.DomHelper.prototype.createDom;
+
+
+/**
+ * Creates a new element.
+ * @param {string} name Tag name.
+ * @return {!Element} The new element.
+ */
+goog.dom.DomHelper.prototype.createElement = function(name) {
+  return this.document_.createElement(name);
+};
+
+
+/**
+ * Creates a new text node.
+ * @param {number|string} content Content.
+ * @return {!Text} The new text node.
+ */
+goog.dom.DomHelper.prototype.createTextNode = function(content) {
+  return this.document_.createTextNode(String(content));
+};
+
+
+/**
+ * Create a table.
+ * @param {number} rows The number of rows in the table.  Must be >= 1.
+ * @param {number} columns The number of columns in the table.  Must be >= 1.
+ * @param {boolean=} opt_fillWithNbsp If true, fills table entries with
+ *     {@code goog.string.Unicode.NBSP} characters.
+ * @return {!HTMLElement} The created table.
+ */
+goog.dom.DomHelper.prototype.createTable = function(rows, columns,
+    opt_fillWithNbsp) {
+  return goog.dom.createTable_(this.document_, rows, columns,
+      !!opt_fillWithNbsp);
+};
+
+
+/**
+ * Converts an HTML into a node or a document fragment. A single Node is used if
+ * {@code html} only generates a single node. If {@code html} generates multiple
+ * nodes then these are put inside a {@code DocumentFragment}.
+ * @param {!goog.html.SafeHtml} html The HTML markup to convert.
+ * @return {!Node} The resulting node.
+ */
+goog.dom.DomHelper.prototype.safeHtmlToNode = function(html) {
+  return goog.dom.safeHtmlToNode_(this.document_, html);
+};
+
+
+/**
+ * Converts an HTML string into a node or a document fragment.  A single Node
+ * is used if the {@code htmlString} only generates a single node.  If the
+ * {@code htmlString} generates multiple nodes then these are put inside a
+ * {@code DocumentFragment}.
+ *
+ * @param {string} htmlString The HTML string to convert.
+ * @return {!Node} The resulting node.
+ */
+goog.dom.DomHelper.prototype.htmlToDocumentFragment = function(htmlString) {
+  return goog.dom.htmlToDocumentFragment_(this.document_, htmlString);
+};
+
+
+/**
+ * Returns true if the browser is in "CSS1-compatible" (standards-compliant)
+ * mode, false otherwise.
+ * @return {boolean} True if in CSS1-compatible mode.
+ */
+goog.dom.DomHelper.prototype.isCss1CompatMode = function() {
+  return goog.dom.isCss1CompatMode_(this.document_);
+};
+
+
+/**
+ * Gets the window object associated with the document.
+ * @return {!Window} The window associated with the given document.
+ */
+goog.dom.DomHelper.prototype.getWindow = function() {
+  return goog.dom.getWindow_(this.document_);
+};
+
+
+/**
+ * Gets the document scroll element.
+ * @return {!Element} Scrolling element.
+ */
+goog.dom.DomHelper.prototype.getDocumentScrollElement = function() {
+  return goog.dom.getDocumentScrollElement_(this.document_);
+};
+
+
+/**
+ * Gets the document scroll distance as a coordinate object.
+ * @return {!goog.math.Coordinate} Object with properties 'x' and 'y'.
+ */
+goog.dom.DomHelper.prototype.getDocumentScroll = function() {
+  return goog.dom.getDocumentScroll_(this.document_);
+};
+
+
+/**
+ * Determines the active element in the given document.
+ * @param {Document=} opt_doc The document to look in.
+ * @return {Element} The active element.
+ */
+goog.dom.DomHelper.prototype.getActiveElement = function(opt_doc) {
+  return goog.dom.getActiveElement(opt_doc || this.document_);
+};
+
+
+/**
+ * Appends a child to a node.
+ * @param {Node} parent Parent.
+ * @param {Node} child Child.
+ */
+goog.dom.DomHelper.prototype.appendChild = goog.dom.appendChild;
+
+
+/**
+ * Appends a node with text or other nodes.
+ * @param {!Node} parent The node to append nodes to.
+ * @param {...goog.dom.Appendable} var_args The things to append to the node.
+ *     If this is a Node it is appended as is.
+ *     If this is a string then a text node is appended.
+ *     If this is an array like object then fields 0 to length - 1 are appended.
+ */
+goog.dom.DomHelper.prototype.append = goog.dom.append;
+
+
+/**
+ * Determines if the given node can contain children, intended to be used for
+ * HTML generation.
+ *
+ * @param {Node} node The node to check.
+ * @return {boolean} Whether the node can contain children.
+ */
+goog.dom.DomHelper.prototype.canHaveChildren = goog.dom.canHaveChildren;
+
+
+/**
+ * Removes all the child nodes on a DOM node.
+ * @param {Node} node Node to remove children from.
+ */
+goog.dom.DomHelper.prototype.removeChildren = goog.dom.removeChildren;
+
+
+/**
+ * Inserts a new node before an existing reference node (i.e., as the previous
+ * sibling). If the reference node has no parent, then does nothing.
+ * @param {Node} newNode Node to insert.
+ * @param {Node} refNode Reference node to insert before.
+ */
+goog.dom.DomHelper.prototype.insertSiblingBefore = goog.dom.insertSiblingBefore;
+
+
+/**
+ * Inserts a new node after an existing reference node (i.e., as the next
+ * sibling). If the reference node has no parent, then does nothing.
+ * @param {Node} newNode Node to insert.
+ * @param {Node} refNode Reference node to insert after.
+ */
+goog.dom.DomHelper.prototype.insertSiblingAfter = goog.dom.insertSiblingAfter;
+
+
+/**
+ * Insert a child at a given index. If index is larger than the number of child
+ * nodes that the parent currently has, the node is inserted as the last child
+ * node.
+ * @param {Element} parent The element into which to insert the child.
+ * @param {Node} child The element to insert.
+ * @param {number} index The index at which to insert the new child node. Must
+ *     not be negative.
+ */
+goog.dom.DomHelper.prototype.insertChildAt = goog.dom.insertChildAt;
+
+
+/**
+ * Removes a node from its parent.
+ * @param {Node} node The node to remove.
+ * @return {Node} The node removed if removed; else, null.
+ */
+goog.dom.DomHelper.prototype.removeNode = goog.dom.removeNode;
+
+
+/**
+ * Replaces a node in the DOM tree. Will do nothing if {@code oldNode} has no
+ * parent.
+ * @param {Node} newNode Node to insert.
+ * @param {Node} oldNode Node to replace.
+ */
+goog.dom.DomHelper.prototype.replaceNode = goog.dom.replaceNode;
+
+
+/**
+ * Flattens an element. That is, removes it and replace it with its children.
+ * @param {Element} element The element to flatten.
+ * @return {Element|undefined} The original element, detached from the document
+ *     tree, sans children, or undefined if the element was already not in the
+ *     document.
+ */
+goog.dom.DomHelper.prototype.flattenElement = goog.dom.flattenElement;
+
+
+/**
+ * Returns an array containing just the element children of the given element.
+ * @param {Element} element The element whose element children we want.
+ * @return {!(Array|NodeList)} An array or array-like list of just the element
+ *     children of the given element.
+ */
+goog.dom.DomHelper.prototype.getChildren = goog.dom.getChildren;
+
+
+/**
+ * Returns the first child node that is an element.
+ * @param {Node} node The node to get the first child element of.
+ * @return {Element} The first child node of {@code node} that is an element.
+ */
+goog.dom.DomHelper.prototype.getFirstElementChild =
+    goog.dom.getFirstElementChild;
+
+
+/**
+ * Returns the last child node that is an element.
+ * @param {Node} node The node to get the last child element of.
+ * @return {Element} The last child node of {@code node} that is an element.
+ */
+goog.dom.DomHelper.prototype.getLastElementChild = goog.dom.getLastElementChild;
+
+
+/**
+ * Returns the first next sibling that is an element.
+ * @param {Node} node The node to get the next sibling element of.
+ * @return {Element} The next sibling of {@code node} that is an element.
+ */
+goog.dom.DomHelper.prototype.getNextElementSibling =
+    goog.dom.getNextElementSibling;
+
+
+/**
+ * Returns the first previous sibling that is an element.
+ * @param {Node} node The node to get the previous sibling element of.
+ * @return {Element} The first previous sibling of {@code node} that is
+ *     an element.
+ */
+goog.dom.DomHelper.prototype.getPreviousElementSibling =
+    goog.dom.getPreviousElementSibling;
+
+
+/**
+ * Returns the next node in source order from the given node.
+ * @param {Node} node The node.
+ * @return {Node} The next node in the DOM tree, or null if this was the last
+ *     node.
+ */
+goog.dom.DomHelper.prototype.getNextNode = goog.dom.getNextNode;
+
+
+/**
+ * Returns the previous node in source order from the given node.
+ * @param {Node} node The node.
+ * @return {Node} The previous node in the DOM tree, or null if this was the
+ *     first node.
+ */
+goog.dom.DomHelper.prototype.getPreviousNode = goog.dom.getPreviousNode;
+
+
+/**
+ * Whether the object looks like a DOM node.
+ * @param {?} obj The object being tested for node likeness.
+ * @return {boolean} Whether the object looks like a DOM node.
+ */
+goog.dom.DomHelper.prototype.isNodeLike = goog.dom.isNodeLike;
+
+
+/**
+ * Whether the object looks like an Element.
+ * @param {?} obj The object being tested for Element likeness.
+ * @return {boolean} Whether the object looks like an Element.
+ */
+goog.dom.DomHelper.prototype.isElement = goog.dom.isElement;
+
+
+/**
+ * Returns true if the specified value is a Window object. This includes the
+ * global window for HTML pages, and iframe windows.
+ * @param {?} obj Variable to test.
+ * @return {boolean} Whether the variable is a window.
+ */
+goog.dom.DomHelper.prototype.isWindow = goog.dom.isWindow;
+
+
+/**
+ * Returns an element's parent, if it's an Element.
+ * @param {Element} element The DOM element.
+ * @return {Element} The parent, or null if not an Element.
+ */
+goog.dom.DomHelper.prototype.getParentElement = goog.dom.getParentElement;
+
+
+/**
+ * Whether a node contains another node.
+ * @param {Node} parent The node that should contain the other node.
+ * @param {Node} descendant The node to test presence of.
+ * @return {boolean} Whether the parent node contains the descendent node.
+ */
+goog.dom.DomHelper.prototype.contains = goog.dom.contains;
+
+
+/**
+ * Compares the document order of two nodes, returning 0 if they are the same
+ * node, a negative number if node1 is before node2, and a positive number if
+ * node2 is before node1.  Note that we compare the order the tags appear in the
+ * document so in the tree <b><i>text</i></b> the B node is considered to be
+ * before the I node.
+ *
+ * @param {Node} node1 The first node to compare.
+ * @param {Node} node2 The second node to compare.
+ * @return {number} 0 if the nodes are the same node, a negative number if node1
+ *     is before node2, and a positive number if node2 is before node1.
+ */
+goog.dom.DomHelper.prototype.compareNodeOrder = goog.dom.compareNodeOrder;
+
+
+/**
+ * Find the deepest common ancestor of the given nodes.
+ * @param {...Node} var_args The nodes to find a common ancestor of.
+ * @return {Node} The common ancestor of the nodes, or null if there is none.
+ *     null will only be returned if two or more of the nodes are from different
+ *     documents.
+ */
+goog.dom.DomHelper.prototype.findCommonAncestor = goog.dom.findCommonAncestor;
+
+
+/**
+ * Returns the owner document for a node.
+ * @param {Node} node The node to get the document for.
+ * @return {!Document} The document owning the node.
+ */
+goog.dom.DomHelper.prototype.getOwnerDocument = goog.dom.getOwnerDocument;
+
+
+/**
+ * Cross browser function for getting the document element of an iframe.
+ * @param {Element} iframe Iframe element.
+ * @return {!Document} The frame content document.
+ */
+goog.dom.DomHelper.prototype.getFrameContentDocument =
+    goog.dom.getFrameContentDocument;
+
+
+/**
+ * Cross browser function for getting the window of a frame or iframe.
+ * @param {Element} frame Frame element.
+ * @return {Window} The window associated with the given frame.
+ */
+goog.dom.DomHelper.prototype.getFrameContentWindow =
+    goog.dom.getFrameContentWindow;
+
+
+/**
+ * Sets the text content of a node, with cross-browser support.
+ * @param {Node} node The node to change the text content of.
+ * @param {string|number} text The value that should replace the node's content.
+ */
+goog.dom.DomHelper.prototype.setTextContent = goog.dom.setTextContent;
+
+
+/**
+ * Gets the outerHTML of a node, which islike innerHTML, except that it
+ * actually contains the HTML of the node itself.
+ * @param {Element} element The element to get the HTML of.
+ * @return {string} The outerHTML of the given element.
+ */
+goog.dom.DomHelper.prototype.getOuterHtml = goog.dom.getOuterHtml;
+
+
+/**
+ * Finds the first descendant node that matches the filter function. This does
+ * a depth first search.
+ * @param {Node} root The root of the tree to search.
+ * @param {function(Node) : boolean} p The filter function.
+ * @return {Node|undefined} The found node or undefined if none is found.
+ */
+goog.dom.DomHelper.prototype.findNode = goog.dom.findNode;
+
+
+/**
+ * Finds all the descendant nodes that matches the filter function. This does a
+ * depth first search.
+ * @param {Node} root The root of the tree to search.
+ * @param {function(Node) : boolean} p The filter function.
+ * @return {Array<Node>} The found nodes or an empty array if none are found.
+ */
+goog.dom.DomHelper.prototype.findNodes = goog.dom.findNodes;
+
+
+/**
+ * Returns true if the element has a tab index that allows it to receive
+ * keyboard focus (tabIndex >= 0), false otherwise.  Note that some elements
+ * natively support keyboard focus, even if they have no tab index.
+ * @param {!Element} element Element to check.
+ * @return {boolean} Whether the element has a tab index that allows keyboard
+ *     focus.
+ */
+goog.dom.DomHelper.prototype.isFocusableTabIndex = goog.dom.isFocusableTabIndex;
+
+
+/**
+ * Enables or disables keyboard focus support on the element via its tab index.
+ * Only elements for which {@link goog.dom.isFocusableTabIndex} returns true
+ * (or elements that natively support keyboard focus, like form elements) can
+ * receive keyboard focus.  See http://go/tabindex for more info.
+ * @param {Element} element Element whose tab index is to be changed.
+ * @param {boolean} enable Whether to set or remove a tab index on the element
+ *     that supports keyboard focus.
+ */
+goog.dom.DomHelper.prototype.setFocusableTabIndex =
+    goog.dom.setFocusableTabIndex;
+
+
+/**
+ * Returns true if the element can be focused, i.e. it has a tab index that
+ * allows it to receive keyboard focus (tabIndex >= 0), or it is an element
+ * that natively supports keyboard focus.
+ * @param {!Element} element Element to check.
+ * @return {boolean} Whether the element allows keyboard focus.
+ */
+goog.dom.DomHelper.prototype.isFocusable = goog.dom.isFocusable;
+
+
+/**
+ * Returns the text contents of the current node, without markup. New lines are
+ * stripped and whitespace is collapsed, such that each character would be
+ * visible.
+ *
+ * In browsers that support it, innerText is used.  Other browsers attempt to
+ * simulate it via node traversal.  Line breaks are canonicalized in IE.
+ *
+ * @param {Node} node The node from which we are getting content.
+ * @return {string} The text content.
+ */
+goog.dom.DomHelper.prototype.getTextContent = goog.dom.getTextContent;
+
+
+/**
+ * Returns the text length of the text contained in a node, without markup. This
+ * is equivalent to the selection length if the node was selected, or the number
+ * of cursor movements to traverse the node. Images & BRs take one space.  New
+ * lines are ignored.
+ *
+ * @param {Node} node The node whose text content length is being calculated.
+ * @return {number} The length of {@code node}'s text content.
+ */
+goog.dom.DomHelper.prototype.getNodeTextLength = goog.dom.getNodeTextLength;
+
+
+/**
+ * Returns the text offset of a node relative to one of its ancestors. The text
+ * length is the same as the length calculated by
+ * {@code goog.dom.getNodeTextLength}.
+ *
+ * @param {Node} node The node whose offset is being calculated.
+ * @param {Node=} opt_offsetParent Defaults to the node's owner document's body.
+ * @return {number} The text offset.
+ */
+goog.dom.DomHelper.prototype.getNodeTextOffset = goog.dom.getNodeTextOffset;
+
+
+/**
+ * Returns the node at a given offset in a parent node.  If an object is
+ * provided for the optional third parameter, the node and the remainder of the
+ * offset will stored as properties of this object.
+ * @param {Node} parent The parent node.
+ * @param {number} offset The offset into the parent node.
+ * @param {Object=} opt_result Object to be used to store the return value. The
+ *     return value will be stored in the form {node: Node, remainder: number}
+ *     if this object is provided.
+ * @return {Node} The node at the given offset.
+ */
+goog.dom.DomHelper.prototype.getNodeAtOffset = goog.dom.getNodeAtOffset;
+
+
+/**
+ * Returns true if the object is a {@code NodeList}.  To qualify as a NodeList,
+ * the object must have a numeric length property and an item function (which
+ * has type 'string' on IE for some reason).
+ * @param {Object} val Object to test.
+ * @return {boolean} Whether the object is a NodeList.
+ */
+goog.dom.DomHelper.prototype.isNodeList = goog.dom.isNodeList;
+
+
+/**
+ * Walks up the DOM hierarchy returning the first ancestor that has the passed
+ * tag name and/or class name. If the passed element matches the specified
+ * criteria, the element itself is returned.
+ * @param {Node} element The DOM node to start with.
+ * @param {?(goog.dom.TagName|string)=} opt_tag The tag name to match (or
+ *     null/undefined to match only based on class name).
+ * @param {?string=} opt_class The class name to match (or null/undefined to
+ *     match only based on tag name).
+ * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the
+ *     dom.
+ * @return {Element} The first ancestor that matches the passed criteria, or
+ *     null if no match is found.
+ */
+goog.dom.DomHelper.prototype.getAncestorByTagNameAndClass =
+    goog.dom.getAncestorByTagNameAndClass;
+
+
+/**
+ * Walks up the DOM hierarchy returning the first ancestor that has the passed
+ * class name. If the passed element matches the specified criteria, the
+ * element itself is returned.
+ * @param {Node} element The DOM node to start with.
+ * @param {string} class The class name to match.
+ * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the
+ *     dom.
+ * @return {Element} The first ancestor that matches the passed criteria, or
+ *     null if none match.
+ */
+goog.dom.DomHelper.prototype.getAncestorByClass =
+    goog.dom.getAncestorByClass;
+
+
+/**
+ * Walks up the DOM hierarchy returning the first ancestor that passes the
+ * matcher function.
+ * @param {Node} element The DOM node to start with.
+ * @param {function(Node) : boolean} matcher A function that returns true if the
+ *     passed node matches the desired criteria.
+ * @param {boolean=} opt_includeNode If true, the node itself is included in
+ *     the search (the first call to the matcher will pass startElement as
+ *     the node to test).
+ * @param {number=} opt_maxSearchSteps Maximum number of levels to search up the
+ *     dom.
+ * @return {Node} DOM node that matched the matcher, or null if there was
+ *     no match.
+ */
+goog.dom.DomHelper.prototype.getAncestor = goog.dom.getAncestor;
diff --git a/lib/goog/dom/nodetype.js b/lib/goog/dom/nodetype.js
new file mode 100644
index 0000000..cccb470
--- /dev/null
+++ b/lib/goog/dom/nodetype.js
@@ -0,0 +1,48 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Definition of goog.dom.NodeType.
+ */
+
+goog.provide('goog.dom.NodeType');
+
+
+/**
+ * Constants for the nodeType attribute in the Node interface.
+ *
+ * These constants match those specified in the Node interface. These are
+ * usually present on the Node object in recent browsers, but not in older
+ * browsers (specifically, early IEs) and thus are given here.
+ *
+ * In some browsers (early IEs), these are not defined on the Node object,
+ * so they are provided here.
+ *
+ * See http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1950641247
+ * @enum {number}
+ */
+goog.dom.NodeType = {
+  ELEMENT: 1,
+  ATTRIBUTE: 2,
+  TEXT: 3,
+  CDATA_SECTION: 4,
+  ENTITY_REFERENCE: 5,
+  ENTITY: 6,
+  PROCESSING_INSTRUCTION: 7,
+  COMMENT: 8,
+  DOCUMENT: 9,
+  DOCUMENT_TYPE: 10,
+  DOCUMENT_FRAGMENT: 11,
+  NOTATION: 12
+};
diff --git a/lib/goog/dom/safe.js b/lib/goog/dom/safe.js
new file mode 100644
index 0000000..e38d999
--- /dev/null
+++ b/lib/goog/dom/safe.js
@@ -0,0 +1,347 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Type-safe wrappers for unsafe DOM APIs.
+ *
+ * This file provides type-safe wrappers for DOM APIs that can result in
+ * cross-site scripting (XSS) vulnerabilities, if the API is supplied with
+ * untrusted (attacker-controlled) input.  Instead of plain strings, the type
+ * safe wrappers consume values of types from the goog.html package whose
+ * contract promises that values are safe to use in the corresponding context.
+ *
+ * Hence, a program that exclusively uses the wrappers in this file (i.e., whose
+ * only reference to security-sensitive raw DOM APIs are in this file) is
+ * guaranteed to be free of XSS due to incorrect use of such DOM APIs (modulo
+ * correctness of code that produces values of the respective goog.html types,
+ * and absent code that violates type safety).
+ *
+ * For example, assigning to an element's .innerHTML property a string that is
+ * derived (even partially) from untrusted input typically results in an XSS
+ * vulnerability. The type-safe wrapper goog.html.setInnerHtml consumes a value
+ * of type goog.html.SafeHtml, whose contract states that using its values in a
+ * HTML context will not result in XSS. Hence a program that is free of direct
+ * assignments to any element's innerHTML property (with the exception of the
+ * assignment to .innerHTML in this file) is guaranteed to be free of XSS due to
+ * assignment of untrusted strings to the innerHTML property.
+ */
+
+goog.provide('goog.dom.safe');
+goog.provide('goog.dom.safe.InsertAdjacentHtmlPosition');
+
+goog.require('goog.asserts');
+goog.require('goog.html.SafeHtml');
+goog.require('goog.html.SafeUrl');
+goog.require('goog.html.TrustedResourceUrl');
+goog.require('goog.string');
+goog.require('goog.string.Const');
+
+
+/** @enum {string} */
+goog.dom.safe.InsertAdjacentHtmlPosition = {
+  AFTERBEGIN: 'afterbegin',
+  AFTEREND: 'afterend',
+  BEFOREBEGIN: 'beforebegin',
+  BEFOREEND: 'beforeend'
+};
+
+
+/**
+ * Inserts known-safe HTML into a Node, at the specified position.
+ * @param {!Node} node The node on which to call insertAdjacentHTML.
+ * @param {!goog.dom.safe.InsertAdjacentHtmlPosition} position Position where
+ *     to insert the HTML.
+ * @param {!goog.html.SafeHtml} html The known-safe HTML to insert.
+ */
+goog.dom.safe.insertAdjacentHtml = function(node, position, html) {
+  node.insertAdjacentHTML(position, goog.html.SafeHtml.unwrap(html));
+};
+
+
+/**
+ * Assigns known-safe HTML to an element's innerHTML property.
+ * @param {!Element} elem The element whose innerHTML is to be assigned to.
+ * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.
+ */
+goog.dom.safe.setInnerHtml = function(elem, html) {
+  elem.innerHTML = goog.html.SafeHtml.unwrap(html);
+};
+
+
+/**
+ * Assigns known-safe HTML to an element's outerHTML property.
+ * @param {!Element} elem The element whose outerHTML is to be assigned to.
+ * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.
+ */
+goog.dom.safe.setOuterHtml = function(elem, html) {
+  elem.outerHTML = goog.html.SafeHtml.unwrap(html);
+};
+
+
+/**
+ * Writes known-safe HTML to a document.
+ * @param {!Document} doc The document to be written to.
+ * @param {!goog.html.SafeHtml} html The known-safe HTML to assign.
+ */
+goog.dom.safe.documentWrite = function(doc, html) {
+  doc.write(goog.html.SafeHtml.unwrap(html));
+};
+
+
+/**
+ * Safely assigns a URL to an anchor element's href property.
+ *
+ * If url is of type goog.html.SafeUrl, its value is unwrapped and assigned to
+ * anchor's href property.  If url is of type string however, it is first
+ * sanitized using goog.html.SafeUrl.sanitize.
+ *
+ * Example usage:
+ *   goog.dom.safe.setAnchorHref(anchorEl, url);
+ * which is a safe alternative to
+ *   anchorEl.href = url;
+ * The latter can result in XSS vulnerabilities if url is a
+ * user-/attacker-controlled value.
+ *
+ * @param {!HTMLAnchorElement} anchor The anchor element whose href property
+ *     is to be assigned to.
+ * @param {string|!goog.html.SafeUrl} url The URL to assign.
+ * @see goog.html.SafeUrl#sanitize
+ */
+goog.dom.safe.setAnchorHref = function(anchor, url) {
+  /** @type {!goog.html.SafeUrl} */
+  var safeUrl;
+  if (url instanceof goog.html.SafeUrl) {
+    safeUrl = url;
+  } else {
+    safeUrl = goog.html.SafeUrl.sanitize(url);
+  }
+  anchor.href = goog.html.SafeUrl.unwrap(safeUrl);
+};
+
+
+/**
+ * Safely assigns a URL to an embed element's src property.
+ *
+ * Example usage:
+ *   goog.dom.safe.setEmbedSrc(embedEl, url);
+ * which is a safe alternative to
+ *   embedEl.src = url;
+ * The latter can result in loading untrusted code unless it is ensured that
+ * the URL refers to a trustworthy resource.
+ *
+ * @param {!HTMLEmbedElement} embed The embed element whose src property
+ *     is to be assigned to.
+ * @param {!goog.html.TrustedResourceUrl} url The URL to assign.
+ */
+goog.dom.safe.setEmbedSrc = function(embed, url) {
+  embed.src = goog.html.TrustedResourceUrl.unwrap(url);
+};
+
+
+/**
+ * Safely assigns a URL to a frame element's src property.
+ *
+ * Example usage:
+ *   goog.dom.safe.setFrameSrc(frameEl, url);
+ * which is a safe alternative to
+ *   frameEl.src = url;
+ * The latter can result in loading untrusted code unless it is ensured that
+ * the URL refers to a trustworthy resource.
+ *
+ * @param {!HTMLFrameElement} frame The frame element whose src property
+ *     is to be assigned to.
+ * @param {!goog.html.TrustedResourceUrl} url The URL to assign.
+ */
+goog.dom.safe.setFrameSrc = function(frame, url) {
+  frame.src = goog.html.TrustedResourceUrl.unwrap(url);
+};
+
+
+/**
+ * Safely assigns a URL to an iframe element's src property.
+ *
+ * Example usage:
+ *   goog.dom.safe.setIframeSrc(iframeEl, url);
+ * which is a safe alternative to
+ *   iframeEl.src = url;
+ * The latter can result in loading untrusted code unless it is ensured that
+ * the URL refers to a trustworthy resource.
+ *
+ * @param {!HTMLIFrameElement} iframe The iframe element whose src property
+ *     is to be assigned to.
+ * @param {!goog.html.TrustedResourceUrl} url The URL to assign.
+ */
+goog.dom.safe.setIframeSrc = function(iframe, url) {
+  iframe.src = goog.html.TrustedResourceUrl.unwrap(url);
+};
+
+
+/**
+ * Safely sets a link element's href and rel properties. Whether or not
+ * the URL assigned to href has to be a goog.html.TrustedResourceUrl
+ * depends on the value of the rel property. If rel contains "stylesheet"
+ * then a TrustedResourceUrl is required.
+ *
+ * Example usage:
+ *   goog.dom.safe.setLinkHrefAndRel(linkEl, url, 'stylesheet');
+ * which is a safe alternative to
+ *   linkEl.rel = 'stylesheet';
+ *   linkEl.href = url;
+ * The latter can result in loading untrusted code unless it is ensured that
+ * the URL refers to a trustworthy resource.
+ *
+ * @param {!HTMLLinkElement} link The link element whose href property
+ *     is to be assigned to.
+ * @param {string|!goog.html.SafeUrl|!goog.html.TrustedResourceUrl} url The URL
+ *     to assign to the href property. Must be a TrustedResourceUrl if the
+ *     value assigned to rel contains "stylesheet". A string value is
+ *     sanitized with goog.html.SafeUrl.sanitize.
+ * @param {string} rel The value to assign to the rel property.
+ * @throws {Error} if rel contains "stylesheet" and url is not a
+ *     TrustedResourceUrl
+ * @see goog.html.SafeUrl#sanitize
+ */
+goog.dom.safe.setLinkHrefAndRel = function(link, url, rel) {
+  link.rel = rel;
+  if (goog.string.caseInsensitiveContains(rel, 'stylesheet')) {
+    goog.asserts.assert(
+        url instanceof goog.html.TrustedResourceUrl,
+        'URL must be TrustedResourceUrl because "rel" contains "stylesheet"');
+    link.href = goog.html.TrustedResourceUrl.unwrap(url);
+  } else if (url instanceof goog.html.TrustedResourceUrl) {
+    link.href = goog.html.TrustedResourceUrl.unwrap(url);
+  } else if (url instanceof goog.html.SafeUrl) {
+    link.href = goog.html.SafeUrl.unwrap(url);
+  } else {  // string
+    // SafeUrl.sanitize must return legitimate SafeUrl when passed a string.
+    link.href = goog.html.SafeUrl.sanitize(url).getTypedStringValue();
+  }
+};
+
+
+/**
+ * Safely assigns a URL to an object element's data property.
+ *
+ * Example usage:
+ *   goog.dom.safe.setObjectData(objectEl, url);
+ * which is a safe alternative to
+ *   objectEl.data = url;
+ * The latter can result in loading untrusted code unless setit is ensured that
+ * the URL refers to a trustworthy resource.
+ *
+ * @param {!HTMLObjectElement} object The object element whose data property
+ *     is to be assigned to.
+ * @param {!goog.html.TrustedResourceUrl} url The URL to assign.
+ */
+goog.dom.safe.setObjectData = function(object, url) {
+  object.data = goog.html.TrustedResourceUrl.unwrap(url);
+};
+
+
+/**
+ * Safely assigns a URL to an iframe element's src property.
+ *
+ * Example usage:
+ *   goog.dom.safe.setScriptSrc(scriptEl, url);
+ * which is a safe alternative to
+ *   scriptEl.src = url;
+ * The latter can result in loading untrusted code unless it is ensured that
+ * the URL refers to a trustworthy resource.
+ *
+ * @param {!HTMLScriptElement} script The script element whose src property
+ *     is to be assigned to.
+ * @param {!goog.html.TrustedResourceUrl} url The URL to assign.
+ */
+goog.dom.safe.setScriptSrc = function(script, url) {
+  script.src = goog.html.TrustedResourceUrl.unwrap(url);
+};
+
+
+/**
+ * Safely assigns a URL to a Location object's href property.
+ *
+ * If url is of type goog.html.SafeUrl, its value is unwrapped and assigned to
+ * loc's href property.  If url is of type string however, it is first sanitized
+ * using goog.html.SafeUrl.sanitize.
+ *
+ * Example usage:
+ *   goog.dom.safe.setLocationHref(document.location, redirectUrl);
+ * which is a safe alternative to
+ *   document.location.href = redirectUrl;
+ * The latter can result in XSS vulnerabilities if redirectUrl is a
+ * user-/attacker-controlled value.
+ *
+ * @param {!Location} loc The Location object whose href property is to be
+ *     assigned to.
+ * @param {string|!goog.html.SafeUrl} url The URL to assign.
+ * @see goog.html.SafeUrl#sanitize
+ */
+goog.dom.safe.setLocationHref = function(loc, url) {
+  /** @type {!goog.html.SafeUrl} */
+  var safeUrl;
+  if (url instanceof goog.html.SafeUrl) {
+    safeUrl = url;
+  } else {
+    safeUrl = goog.html.SafeUrl.sanitize(url);
+  }
+  loc.href = goog.html.SafeUrl.unwrap(safeUrl);
+};
+
+
+/**
+ * Safely opens a URL in a new window (via window.open).
+ *
+ * If url is of type goog.html.SafeUrl, its value is unwrapped and passed in to
+ * window.open.  If url is of type string however, it is first sanitized
+ * using goog.html.SafeUrl.sanitize.
+ *
+ * Note that this function does not prevent leakages via the referer that is
+ * sent by window.open. It is advised to only use this to open 1st party URLs.
+ *
+ * Example usage:
+ *   goog.dom.safe.openInWindow(url);
+ * which is a safe alternative to
+ *   window.open(url);
+ * The latter can result in XSS vulnerabilities if redirectUrl is a
+ * user-/attacker-controlled value.
+ *
+ * @param {string|!goog.html.SafeUrl} url The URL to open.
+ * @param {Window=} opt_openerWin Window of which to call the .open() method.
+ *     Defaults to the global window.
+ * @param {!goog.string.Const=} opt_name Name of the window to open in. Can be
+ *     _top, etc as allowed by window.open().
+ * @param {string=} opt_specs Comma-separated list of specifications, same as
+ *     in window.open().
+ * @param {boolean=} opt_replace Whether to replace the current entry in browser
+ *     history, same as in window.open().
+ * @return {Window} Window the url was opened in.
+ */
+goog.dom.safe.openInWindow = function(
+    url, opt_openerWin, opt_name, opt_specs, opt_replace) {
+  /** @type {!goog.html.SafeUrl} */
+  var safeUrl;
+  if (url instanceof goog.html.SafeUrl) {
+    safeUrl = url;
+  } else {
+    safeUrl = goog.html.SafeUrl.sanitize(url);
+  }
+  var win = opt_openerWin || window;
+  return win.open(goog.html.SafeUrl.unwrap(safeUrl),
+      // If opt_name is undefined, simply passing that in to open() causes IE to
+      // reuse the current window instead of opening a new one. Thus we pass ''
+      // in instead, which according to spec opens a new window. See
+      // https://html.spec.whatwg.org/multipage/browsers.html#dom-open .
+      opt_name ? goog.string.Const.unwrap(opt_name) : '',
+      opt_specs, opt_replace);
+};
diff --git a/lib/goog/dom/tagname.js b/lib/goog/dom/tagname.js
new file mode 100644
index 0000000..ad44d85
--- /dev/null
+++ b/lib/goog/dom/tagname.js
@@ -0,0 +1,160 @@
+// Copyright 2007 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Defines the goog.dom.TagName enum.  This enumerates
+ * all HTML tag names specified in either the the W3C HTML 4.01 index of
+ * elements or the HTML5 draft specification.
+ *
+ * References:
+ * http://www.w3.org/TR/html401/index/elements.html
+ * http://dev.w3.org/html5/spec/section-index.html
+ *
+ */
+goog.provide('goog.dom.TagName');
+
+
+/**
+ * Enum of all html tag names specified by the W3C HTML4.01 and HTML5
+ * specifications.
+ * @enum {string}
+ */
+goog.dom.TagName = {
+  A: 'A',
+  ABBR: 'ABBR',
+  ACRONYM: 'ACRONYM',
+  ADDRESS: 'ADDRESS',
+  APPLET: 'APPLET',
+  AREA: 'AREA',
+  ARTICLE: 'ARTICLE',
+  ASIDE: 'ASIDE',
+  AUDIO: 'AUDIO',
+  B: 'B',
+  BASE: 'BASE',
+  BASEFONT: 'BASEFONT',
+  BDI: 'BDI',
+  BDO: 'BDO',
+  BIG: 'BIG',
+  BLOCKQUOTE: 'BLOCKQUOTE',
+  BODY: 'BODY',
+  BR: 'BR',
+  BUTTON: 'BUTTON',
+  CANVAS: 'CANVAS',
+  CAPTION: 'CAPTION',
+  CENTER: 'CENTER',
+  CITE: 'CITE',
+  CODE: 'CODE',
+  COL: 'COL',
+  COLGROUP: 'COLGROUP',
+  COMMAND: 'COMMAND',
+  DATA: 'DATA',
+  DATALIST: 'DATALIST',
+  DD: 'DD',
+  DEL: 'DEL',
+  DETAILS: 'DETAILS',
+  DFN: 'DFN',
+  DIALOG: 'DIALOG',
+  DIR: 'DIR',
+  DIV: 'DIV',
+  DL: 'DL',
+  DT: 'DT',
+  EM: 'EM',
+  EMBED: 'EMBED',
+  FIELDSET: 'FIELDSET',
+  FIGCAPTION: 'FIGCAPTION',
+  FIGURE: 'FIGURE',
+  FONT: 'FONT',
+  FOOTER: 'FOOTER',
+  FORM: 'FORM',
+  FRAME: 'FRAME',
+  FRAMESET: 'FRAMESET',
+  H1: 'H1',
+  H2: 'H2',
+  H3: 'H3',
+  H4: 'H4',
+  H5: 'H5',
+  H6: 'H6',
+  HEAD: 'HEAD',
+  HEADER: 'HEADER',
+  HGROUP: 'HGROUP',
+  HR: 'HR',
+  HTML: 'HTML',
+  I: 'I',
+  IFRAME: 'IFRAME',
+  IMG: 'IMG',
+  INPUT: 'INPUT',
+  INS: 'INS',
+  ISINDEX: 'ISINDEX',
+  KBD: 'KBD',
+  KEYGEN: 'KEYGEN',
+  LABEL: 'LABEL',
+  LEGEND: 'LEGEND',
+  LI: 'LI',
+  LINK: 'LINK',
+  MAP: 'MAP',
+  MARK: 'MARK',
+  MATH: 'MATH',
+  MENU: 'MENU',
+  META: 'META',
+  METER: 'METER',
+  NAV: 'NAV',
+  NOFRAMES: 'NOFRAMES',
+  NOSCRIPT: 'NOSCRIPT',
+  OBJECT: 'OBJECT',
+  OL: 'OL',
+  OPTGROUP: 'OPTGROUP',
+  OPTION: 'OPTION',
+  OUTPUT: 'OUTPUT',
+  P: 'P',
+  PARAM: 'PARAM',
+  PRE: 'PRE',
+  PROGRESS: 'PROGRESS',
+  Q: 'Q',
+  RP: 'RP',
+  RT: 'RT',
+  RUBY: 'RUBY',
+  S: 'S',
+  SAMP: 'SAMP',
+  SCRIPT: 'SCRIPT',
+  SECTION: 'SECTION',
+  SELECT: 'SELECT',
+  SMALL: 'SMALL',
+  SOURCE: 'SOURCE',
+  SPAN: 'SPAN',
+  STRIKE: 'STRIKE',
+  STRONG: 'STRONG',
+  STYLE: 'STYLE',
+  SUB: 'SUB',
+  SUMMARY: 'SUMMARY',
+  SUP: 'SUP',
+  SVG: 'SVG',
+  TABLE: 'TABLE',
+  TBODY: 'TBODY',
+  TD: 'TD',
+  TEMPLATE: 'TEMPLATE',
+  TEXTAREA: 'TEXTAREA',
+  TFOOT: 'TFOOT',
+  TH: 'TH',
+  THEAD: 'THEAD',
+  TIME: 'TIME',
+  TITLE: 'TITLE',
+  TR: 'TR',
+  TRACK: 'TRACK',
+  TT: 'TT',
+  U: 'U',
+  UL: 'UL',
+  VAR: 'VAR',
+  VIDEO: 'VIDEO',
+  WBR: 'WBR'
+};
diff --git a/lib/goog/dom/tags.js b/lib/goog/dom/tags.js
new file mode 100644
index 0000000..7c12938
--- /dev/null
+++ b/lib/goog/dom/tags.js
@@ -0,0 +1,41 @@
+// Copyright 2014 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Utilities for HTML element tag names.
+ */
+goog.provide('goog.dom.tags');
+
+goog.require('goog.object');
+
+
+/**
+ * The void elements specified by
+ * http://www.w3.org/TR/html-markup/syntax.html#void-elements.
+ * @const @private {!Object<string, boolean>}
+ */
+goog.dom.tags.VOID_TAGS_ = goog.object.createSet(
+    'area', 'base', 'br', 'col', 'command', 'embed', 'hr', 'img', 'input',
+    'keygen', 'link', 'meta', 'param', 'source', 'track', 'wbr');
+
+
+/**
+ * Checks whether the tag is void (with no contents allowed and no legal end
+ * tag), for example 'br'.
+ * @param {string} tagName The tag name in lower case.
+ * @return {boolean}
+ */
+goog.dom.tags.isVoidTag = function(tagName) {
+  return goog.dom.tags.VOID_TAGS_[tagName] === true;
+};
diff --git a/lib/goog/dom/vendor.js b/lib/goog/dom/vendor.js
new file mode 100644
index 0000000..7c1123e
--- /dev/null
+++ b/lib/goog/dom/vendor.js
@@ -0,0 +1,96 @@
+// Copyright 2012 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Vendor prefix getters.
+ */
+
+goog.provide('goog.dom.vendor');
+
+goog.require('goog.string');
+goog.require('goog.userAgent');
+
+
+/**
+ * Returns the JS vendor prefix used in CSS properties. Different vendors
+ * use different methods of changing the case of the property names.
+ *
+ * @return {?string} The JS vendor prefix or null if there is none.
+ */
+goog.dom.vendor.getVendorJsPrefix = function() {
+  if (goog.userAgent.WEBKIT) {
+    return 'Webkit';
+  } else if (goog.userAgent.GECKO) {
+    return 'Moz';
+  } else if (goog.userAgent.IE) {
+    return 'ms';
+  } else if (goog.userAgent.OPERA) {
+    return 'O';
+  }
+
+  return null;
+};
+
+
+/**
+ * Returns the vendor prefix used in CSS properties.
+ *
+ * @return {?string} The vendor prefix or null if there is none.
+ */
+goog.dom.vendor.getVendorPrefix = function() {
+  if (goog.userAgent.WEBKIT) {
+    return '-webkit';
+  } else if (goog.userAgent.GECKO) {
+    return '-moz';
+  } else if (goog.userAgent.IE) {
+    return '-ms';
+  } else if (goog.userAgent.OPERA) {
+    return '-o';
+  }
+
+  return null;
+};
+
+
+/**
+ * @param {string} propertyName A property name.
+ * @param {!Object=} opt_object If provided, we verify if the property exists in
+ *     the object.
+ * @return {?string} A vendor prefixed property name, or null if it does not
+ *     exist.
+ */
+goog.dom.vendor.getPrefixedPropertyName = function(propertyName, opt_object) {
+  // We first check for a non-prefixed property, if available.
+  if (opt_object && propertyName in opt_object) {
+    return propertyName;
+  }
+  var prefix = goog.dom.vendor.getVendorJsPrefix();
+  if (prefix) {
+    prefix = prefix.toLowerCase();
+    var prefixedPropertyName = prefix + goog.string.toTitleCase(propertyName);
+    return (!goog.isDef(opt_object) || prefixedPropertyName in opt_object) ?
+        prefixedPropertyName : null;
+  }
+  return null;
+};
+
+
+/**
+ * @param {string} eventType An event type.
+ * @return {string} A lower-cased vendor prefixed event type.
+ */
+goog.dom.vendor.getPrefixedEventType = function(eventType) {
+  var prefix = goog.dom.vendor.getVendorJsPrefix() || '';
+  return (prefix + eventType).toLowerCase();
+};
diff --git a/lib/goog/events/browserevent.js b/lib/goog/events/browserevent.js
new file mode 100644
index 0000000..853bb52
--- /dev/null
+++ b/lib/goog/events/browserevent.js
@@ -0,0 +1,400 @@
+// Copyright 2005 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A patched, standardized event object for browser events.
+ *
+ * <pre>
+ * The patched event object contains the following members:
+ * - type           {string}    Event type, e.g. 'click'
+ * - target         {Object}    The element that actually triggered the event
+ * - currentTarget  {Object}    The element the listener is attached to
+ * - relatedTarget  {Object}    For mouseover and mouseout, the previous object
+ * - offsetX        {number}    X-coordinate relative to target
+ * - offsetY        {number}    Y-coordinate relative to target
+ * - clientX        {number}    X-coordinate relative to viewport
+ * - clientY        {number}    Y-coordinate relative to viewport
+ * - screenX        {number}    X-coordinate relative to the edge of the screen
+ * - screenY        {number}    Y-coordinate relative to the edge of the screen
+ * - button         {number}    Mouse button. Use isButton() to test.
+ * - keyCode        {number}    Key-code
+ * - ctrlKey        {boolean}   Was ctrl key depressed
+ * - altKey         {boolean}   Was alt key depressed
+ * - shiftKey       {boolean}   Was shift key depressed
+ * - metaKey        {boolean}   Was meta key depressed
+ * - defaultPrevented {boolean} Whether the default action has been prevented
+ * - state          {Object}    History state object
+ *
+ * NOTE: The keyCode member contains the raw browser keyCode. For normalized
+ * key and character code use {@link goog.events.KeyHandler}.
+ * </pre>
+ *
+ * @author arv@google.com (Erik Arvidsson)
+ */
+
+goog.provide('goog.events.BrowserEvent');
+goog.provide('goog.events.BrowserEvent.MouseButton');
+
+goog.require('goog.events.BrowserFeature');
+goog.require('goog.events.Event');
+goog.require('goog.events.EventType');
+goog.require('goog.reflect');
+goog.require('goog.userAgent');
+
+
+
+/**
+ * Accepts a browser event object and creates a patched, cross browser event
+ * object.
+ * The content of this object will not be initialized if no event object is
+ * provided. If this is the case, init() needs to be invoked separately.
+ * @param {Event=} opt_e Browser event object.
+ * @param {EventTarget=} opt_currentTarget Current target for event.
+ * @constructor
+ * @extends {goog.events.Event}
+ */
+goog.events.BrowserEvent = function(opt_e, opt_currentTarget) {
+  goog.events.BrowserEvent.base(this, 'constructor', opt_e ? opt_e.type : '');
+
+  /**
+   * Target that fired the event.
+   * @override
+   * @type {Node}
+   */
+  this.target = null;
+
+  /**
+   * Node that had the listener attached.
+   * @override
+   * @type {Node|undefined}
+   */
+  this.currentTarget = null;
+
+  /**
+   * For mouseover and mouseout events, the related object for the event.
+   * @type {Node}
+   */
+  this.relatedTarget = null;
+
+  /**
+   * X-coordinate relative to target.
+   * @type {number}
+   */
+  this.offsetX = 0;
+
+  /**
+   * Y-coordinate relative to target.
+   * @type {number}
+   */
+  this.offsetY = 0;
+
+  /**
+   * X-coordinate relative to the window.
+   * @type {number}
+   */
+  this.clientX = 0;
+
+  /**
+   * Y-coordinate relative to the window.
+   * @type {number}
+   */
+  this.clientY = 0;
+
+  /**
+   * X-coordinate relative to the monitor.
+   * @type {number}
+   */
+  this.screenX = 0;
+
+  /**
+   * Y-coordinate relative to the monitor.
+   * @type {number}
+   */
+  this.screenY = 0;
+
+  /**
+   * Which mouse button was pressed.
+   * @type {number}
+   */
+  this.button = 0;
+
+  /**
+   * Keycode of key press.
+   * @type {number}
+   */
+  this.keyCode = 0;
+
+  /**
+   * Keycode of key press.
+   * @type {number}
+   */
+  this.charCode = 0;
+
+  /**
+   * Whether control was pressed at time of event.
+   * @type {boolean}
+   */
+  this.ctrlKey = false;
+
+  /**
+   * Whether alt was pressed at time of event.
+   * @type {boolean}
+   */
+  this.altKey = false;
+
+  /**
+   * Whether shift was pressed at time of event.
+   * @type {boolean}
+   */
+  this.shiftKey = false;
+
+  /**
+   * Whether the meta key was pressed at time of event.
+   * @type {boolean}
+   */
+  this.metaKey = false;
+
+  /**
+   * History state object, only set for PopState events where it's a copy of the
+   * state object provided to pushState or replaceState.
+   * @type {Object}
+   */
+  this.state = null;
+
+  /**
+   * Whether the default platform modifier key was pressed at time of event.
+   * (This is control for all platforms except Mac, where it's Meta.)
+   * @type {boolean}
+   */
+  this.platformModifierKey = false;
+
+  /**
+   * The browser event object.
+   * @private {Event}
+   */
+  this.event_ = null;
+
+  if (opt_e) {
+    this.init(opt_e, opt_currentTarget);
+  }
+};
+goog.inherits(goog.events.BrowserEvent, goog.events.Event);
+
+
+/**
+ * Normalized button constants for the mouse.
+ * @enum {number}
+ */
+goog.events.BrowserEvent.MouseButton = {
+  LEFT: 0,
+  MIDDLE: 1,
+  RIGHT: 2
+};
+
+
+/**
+ * Static data for mapping mouse buttons.
+ * @type {!Array<number>}
+ */
+goog.events.BrowserEvent.IEButtonMap = [
+  1, // LEFT
+  4, // MIDDLE
+  2  // RIGHT
+];
+
+
+/**
+ * Accepts a browser event object and creates a patched, cross browser event
+ * object.
+ * @param {Event} e Browser event object.
+ * @param {EventTarget=} opt_currentTarget Current target for event.
+ */
+goog.events.BrowserEvent.prototype.init = function(e, opt_currentTarget) {
+  var type = this.type = e.type;
+
+  /**
+   * On touch devices use the first "changed touch" as the relevant touch.
+   * @type {Touch}
+   */
+  var relevantTouch = e.changedTouches ? e.changedTouches[0] : null;
+
+  // TODO(nicksantos): Change this.target to type EventTarget.
+  this.target = /** @type {Node} */ (e.target) || e.srcElement;
+
+  // TODO(nicksantos): Change this.currentTarget to type EventTarget.
+  this.currentTarget = /** @type {Node} */ (opt_currentTarget);
+
+  var relatedTarget = /** @type {Node} */ (e.relatedTarget);
+  if (relatedTarget) {
+    // There's a bug in FireFox where sometimes, relatedTarget will be a
+    // chrome element, and accessing any property of it will get a permission
+    // denied exception. See:
+    // https://bugzilla.mozilla.org/show_bug.cgi?id=497780
+    if (goog.userAgent.GECKO) {
+      if (!goog.reflect.canAccessProperty(relatedTarget, 'nodeName')) {
+        relatedTarget = null;
+      }
+    }
+    // TODO(arv): Use goog.events.EventType when it has been refactored into its
+    // own file.
+  } else if (type == goog.events.EventType.MOUSEOVER) {
+    relatedTarget = e.fromElement;
+  } else if (type == goog.events.EventType.MOUSEOUT) {
+    relatedTarget = e.toElement;
+  }
+
+  this.relatedTarget = relatedTarget;
+
+  if (!goog.isNull(relevantTouch)) {
+    this.clientX = relevantTouch.clientX !== undefined ?
+        relevantTouch.clientX : relevantTouch.pageX;
+    this.clientY = relevantTouch.clientY !== undefined ?
+        relevantTouch.clientY : relevantTouch.pageY;
+    this.screenX = relevantTouch.screenX || 0;
+    this.screenY = relevantTouch.screenY || 0;
+  } else {
+    // Webkit emits a lame warning whenever layerX/layerY is accessed.
+    // http://code.google.com/p/chromium/issues/detail?id=101733
+    this.offsetX = (goog.userAgent.WEBKIT || e.offsetX !== undefined) ?
+        e.offsetX : e.layerX;
+    this.offsetY = (goog.userAgent.WEBKIT || e.offsetY !== undefined) ?
+        e.offsetY : e.layerY;
+    this.clientX = e.clientX !== undefined ? e.clientX : e.pageX;
+    this.clientY = e.clientY !== undefined ? e.clientY : e.pageY;
+    this.screenX = e.screenX || 0;
+    this.screenY = e.screenY || 0;
+  }
+
+  this.button = e.button;
+
+  this.keyCode = e.keyCode || 0;
+  this.charCode = e.charCode || (type == 'keypress' ? e.keyCode : 0);
+  this.ctrlKey = e.ctrlKey;
+  this.altKey = e.altKey;
+  this.shiftKey = e.shiftKey;
+  this.metaKey = e.metaKey;
+  this.platformModifierKey = goog.userAgent.MAC ? e.metaKey : e.ctrlKey;
+  this.state = e.state;
+  this.event_ = e;
+  if (e.defaultPrevented) {
+    this.preventDefault();
+  }
+};
+
+
+/**
+ * Tests to see which button was pressed during the event. This is really only
+ * useful in IE and Gecko browsers. And in IE, it's only useful for
+ * mousedown/mouseup events, because click only fires for the left mouse button.
+ *
+ * Safari 2 only reports the left button being clicked, and uses the value '1'
+ * instead of 0. Opera only reports a mousedown event for the middle button, and
+ * no mouse events for the right button. Opera has default behavior for left and
+ * middle click that can only be overridden via a configuration setting.
+ *
+ * There's a nice table of this mess at http://www.unixpapa.com/js/mouse.html.
+ *
+ * @param {goog.events.BrowserEvent.MouseButton} button The button
+ *     to test for.
+ * @return {boolean} True if button was pressed.
+ */
+goog.events.BrowserEvent.prototype.isButton = function(button) {
+  if (!goog.events.BrowserFeature.HAS_W3C_BUTTON) {
+    if (this.type == 'click') {
+      return button == goog.events.BrowserEvent.MouseButton.LEFT;
+    } else {
+      return !!(this.event_.button &
+          goog.events.BrowserEvent.IEButtonMap[button]);
+    }
+  } else {
+    return this.event_.button == button;
+  }
+};
+
+
+/**
+ * Whether this has an "action"-producing mouse button.
+ *
+ * By definition, this includes left-click on windows/linux, and left-click
+ * without the ctrl key on Macs.
+ *
+ * @return {boolean} The result.
+ */
+goog.events.BrowserEvent.prototype.isMouseActionButton = function() {
+  // Webkit does not ctrl+click to be a right-click, so we
+  // normalize it to behave like Gecko and Opera.
+  return this.isButton(goog.events.BrowserEvent.MouseButton.LEFT) &&
+      !(goog.userAgent.WEBKIT && goog.userAgent.MAC && this.ctrlKey);
+};
+
+
+/**
+ * @override
+ */
+goog.events.BrowserEvent.prototype.stopPropagation = function() {
+  goog.events.BrowserEvent.superClass_.stopPropagation.call(this);
+  if (this.event_.stopPropagation) {
+    this.event_.stopPropagation();
+  } else {
+    this.event_.cancelBubble = true;
+  }
+};
+
+
+/**
+ * @override
+ */
+goog.events.BrowserEvent.prototype.preventDefault = function() {
+  goog.events.BrowserEvent.superClass_.preventDefault.call(this);
+  var be = this.event_;
+  if (!be.preventDefault) {
+    be.returnValue = false;
+    if (goog.events.BrowserFeature.SET_KEY_CODE_TO_PREVENT_DEFAULT) {
+      /** @preserveTry */
+      try {
+        // Most keys can be prevented using returnValue. Some special keys
+        // require setting the keyCode to -1 as well:
+        //
+        // In IE7:
+        // F3, F5, F10, F11, Ctrl+P, Crtl+O, Ctrl+F (these are taken from IE6)
+        //
+        // In IE8:
+        // Ctrl+P, Crtl+O, Ctrl+F (F1-F12 cannot be stopped through the event)
+        //
+        // We therefore do this for all function keys as well as when Ctrl key
+        // is pressed.
+        var VK_F1 = 112;
+        var VK_F12 = 123;
+        if (be.ctrlKey || be.keyCode >= VK_F1 && be.keyCode <= VK_F12) {
+          be.keyCode = -1;
+        }
+      } catch (ex) {
+        // IE throws an 'access denied' exception when trying to change
+        // keyCode in some situations (e.g. srcElement is input[type=file],
+        // or srcElement is an anchor tag rewritten by parent's innerHTML).
+        // Do nothing in this case.
+      }
+    }
+  } else {
+    be.preventDefault();
+  }
+};
+
+
+/**
+ * @return {Event} The underlying browser event object.
+ */
+goog.events.BrowserEvent.prototype.getBrowserEvent = function() {
+  return this.event_;
+};
diff --git a/lib/goog/events/browserfeature.js b/lib/goog/events/browserfeature.js
new file mode 100644
index 0000000..61b9d60
--- /dev/null
+++ b/lib/goog/events/browserfeature.js
@@ -0,0 +1,85 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Browser capability checks for the events package.
+ *
+ */
+
+
+goog.provide('goog.events.BrowserFeature');
+
+goog.require('goog.userAgent');
+
+
+/**
+ * Enum of browser capabilities.
+ * @enum {boolean}
+ */
+goog.events.BrowserFeature = {
+  /**
+   * Whether the button attribute of the event is W3C compliant.  False in
+   * Internet Explorer prior to version 9; document-version dependent.
+   */
+  HAS_W3C_BUTTON: !goog.userAgent.IE ||
+      goog.userAgent.isDocumentModeOrHigher(9),
+
+  /**
+   * Whether the browser supports full W3C event model.
+   */
+  HAS_W3C_EVENT_SUPPORT: !goog.userAgent.IE ||
+      goog.userAgent.isDocumentModeOrHigher(9),
+
+  /**
+   * To prevent default in IE7-8 for certain keydown events we need set the
+   * keyCode to -1.
+   */
+  SET_KEY_CODE_TO_PREVENT_DEFAULT: goog.userAgent.IE &&
+      !goog.userAgent.isVersionOrHigher('9'),
+
+  /**
+   * Whether the {@code navigator.onLine} property is supported.
+   */
+  HAS_NAVIGATOR_ONLINE_PROPERTY: !goog.userAgent.WEBKIT ||
+      goog.userAgent.isVersionOrHigher('528'),
+
+  /**
+   * Whether HTML5 network online/offline events are supported.
+   */
+  HAS_HTML5_NETWORK_EVENT_SUPPORT:
+      goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher('1.9b') ||
+      goog.userAgent.IE && goog.userAgent.isVersionOrHigher('8') ||
+      goog.userAgent.OPERA && goog.userAgent.isVersionOrHigher('9.5') ||
+      goog.userAgent.WEBKIT && goog.userAgent.isVersionOrHigher('528'),
+
+  /**
+   * Whether HTML5 network events fire on document.body, or otherwise the
+   * window.
+   */
+  HTML5_NETWORK_EVENTS_FIRE_ON_BODY:
+      goog.userAgent.GECKO && !goog.userAgent.isVersionOrHigher('8') ||
+      goog.userAgent.IE && !goog.userAgent.isVersionOrHigher('9'),
+
+  /**
+   * Whether touch is enabled in the browser.
+   */
+  TOUCH_ENABLED:
+      ('ontouchstart' in goog.global ||
+          !!(goog.global['document'] &&
+             document.documentElement &&
+             'ontouchstart' in document.documentElement) ||
+          // IE10 uses non-standard touch events, so it has a different check.
+          !!(goog.global['navigator'] &&
+              goog.global['navigator']['msMaxTouchPoints']))
+};
diff --git a/lib/goog/events/event.js b/lib/goog/events/event.js
new file mode 100644
index 0000000..b671289
--- /dev/null
+++ b/lib/goog/events/event.js
@@ -0,0 +1,143 @@
+// Copyright 2005 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A base class for event objects.
+ *
+ */
+
+
+goog.provide('goog.events.Event');
+goog.provide('goog.events.EventLike');
+
+/**
+ * goog.events.Event no longer depends on goog.Disposable. Keep requiring
+ * goog.Disposable here to not break projects which assume this dependency.
+ * @suppress {extraRequire}
+ */
+goog.require('goog.Disposable');
+goog.require('goog.events.EventId');
+
+
+/**
+ * A typedef for event like objects that are dispatchable via the
+ * goog.events.dispatchEvent function. strings are treated as the type for a
+ * goog.events.Event. Objects are treated as an extension of a new
+ * goog.events.Event with the type property of the object being used as the type
+ * of the Event.
+ * @typedef {string|Object|goog.events.Event|goog.events.EventId}
+ */
+goog.events.EventLike;
+
+
+
+/**
+ * A base class for event objects, so that they can support preventDefault and
+ * stopPropagation.
+ *
+ * @param {string|!goog.events.EventId} type Event Type.
+ * @param {Object=} opt_target Reference to the object that is the target of
+ *     this event. It has to implement the {@code EventTarget} interface
+ *     declared at {@link http://developer.mozilla.org/en/DOM/EventTarget}.
+ * @constructor
+ */
+goog.events.Event = function(type, opt_target) {
+  /**
+   * Event type.
+   * @type {string}
+   */
+  this.type = type instanceof goog.events.EventId ? String(type) : type;
+
+  /**
+   * TODO(tbreisacher): The type should probably be
+   * EventTarget|goog.events.EventTarget.
+   *
+   * Target of the event.
+   * @type {Object|undefined}
+   */
+  this.target = opt_target;
+
+  /**
+   * Object that had the listener attached.
+   * @type {Object|undefined}
+   */
+  this.currentTarget = this.target;
+
+  /**
+   * Whether to cancel the event in internal capture/bubble processing for IE.
+   * @type {boolean}
+   * @public
+   * @suppress {underscore|visibility} Technically public, but referencing this
+   *     outside this package is strongly discouraged.
+   */
+  this.propagationStopped_ = false;
+
+  /**
+   * Whether the default action has been prevented.
+   * This is a property to match the W3C specification at
+   * {@link http://www.w3.org/TR/DOM-Level-3-Events/
+   * #events-event-type-defaultPrevented}.
+   * Must be treated as read-only outside the class.
+   * @type {boolean}
+   */
+  this.defaultPrevented = false;
+
+  /**
+   * Return value for in internal capture/bubble processing for IE.
+   * @type {boolean}
+   * @public
+   * @suppress {underscore|visibility} Technically public, but referencing this
+   *     outside this package is strongly discouraged.
+   */
+  this.returnValue_ = true;
+};
+
+
+/**
+ * Stops event propagation.
+ */
+goog.events.Event.prototype.stopPropagation = function() {
+  this.propagationStopped_ = true;
+};
+
+
+/**
+ * Prevents the default action, for example a link redirecting to a url.
+ */
+goog.events.Event.prototype.preventDefault = function() {
+  this.defaultPrevented = true;
+  this.returnValue_ = false;
+};
+
+
+/**
+ * Stops the propagation of the event. It is equivalent to
+ * {@code e.stopPropagation()}, but can be used as the callback argument of
+ * {@link goog.events.listen} without declaring another function.
+ * @param {!goog.events.Event} e An event.
+ */
+goog.events.Event.stopPropagation = function(e) {
+  e.stopPropagation();
+};
+
+
+/**
+ * Prevents the default action. It is equivalent to
+ * {@code e.preventDefault()}, but can be used as the callback argument of
+ * {@link goog.events.listen} without declaring another function.
+ * @param {!goog.events.Event} e An event.
+ */
+goog.events.Event.preventDefault = function(e) {
+  e.preventDefault();
+};
diff --git a/lib/goog/events/eventid.js b/lib/goog/events/eventid.js
new file mode 100644
index 0000000..9a4822e
--- /dev/null
+++ b/lib/goog/events/eventid.js
@@ -0,0 +1,47 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.events.EventId');
+
+
+
+/**
+ * A templated class that is used when registering for events. Typical usage:
+ * <code>
+ *   /** @type {goog.events.EventId<MyEventObj>}
+ *   var myEventId = new goog.events.EventId(
+ *       goog.events.getUniqueId(('someEvent'));
+ *
+ *   // No need to cast or declare here since the compiler knows the correct
+ *   // type of 'evt' (MyEventObj).
+ *   something.listen(myEventId, function(evt) {});
+ * </code>
+ *
+ * @param {string} eventId
+ * @template T
+ * @constructor
+ * @struct
+ * @final
+ */
+goog.events.EventId = function(eventId) {
+  /** @const */ this.id = eventId;
+};
+
+
+/**
+ * @override
+ */
+goog.events.EventId.prototype.toString = function() {
+  return this.id;
+};
diff --git a/lib/goog/events/events.js b/lib/goog/events/events.js
new file mode 100644
index 0000000..faf4b9a
--- /dev/null
+++ b/lib/goog/events/events.js
@@ -0,0 +1,984 @@
+// Copyright 2005 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview An event manager for both native browser event
+ * targets and custom JavaScript event targets
+ * ({@code goog.events.Listenable}). This provides an abstraction
+ * over browsers' event systems.
+ *
+ * It also provides a simulation of W3C event model's capture phase in
+ * Internet Explorer (IE 8 and below). Caveat: the simulation does not
+ * interact well with listeners registered directly on the elements
+ * (bypassing goog.events) or even with listeners registered via
+ * goog.events in a separate JS binary. In these cases, we provide
+ * no ordering guarantees.
+ *
+ * The listeners will receive a "patched" event object. Such event object
+ * contains normalized values for certain event properties that differs in
+ * different browsers.
+ *
+ * Example usage:
+ * <pre>
+ * goog.events.listen(myNode, 'click', function(e) { alert('woo') });
+ * goog.events.listen(myNode, 'mouseover', mouseHandler, true);
+ * goog.events.unlisten(myNode, 'mouseover', mouseHandler, true);
+ * goog.events.removeAll(myNode);
+ * </pre>
+ *
+ *                                            in IE and event object patching]
+ * @author arv@google.com (Erik Arvidsson)
+ *
+ * @see ../demos/events.html
+ * @see ../demos/event-propagation.html
+ * @see ../demos/stopevent.html
+ */
+
+// IMPLEMENTATION NOTES:
+// goog.events stores an auxiliary data structure on each EventTarget
+// source being listened on. This allows us to take advantage of GC,
+// having the data structure GC'd when the EventTarget is GC'd. This
+// GC behavior is equivalent to using W3C DOM Events directly.
+
+goog.provide('goog.events');
+goog.provide('goog.events.CaptureSimulationMode');
+goog.provide('goog.events.Key');
+goog.provide('goog.events.ListenableType');
+
+goog.require('goog.asserts');
+goog.require('goog.debug.entryPointRegistry');
+goog.require('goog.events.BrowserEvent');
+goog.require('goog.events.BrowserFeature');
+goog.require('goog.events.Listenable');
+goog.require('goog.events.ListenerMap');
+
+goog.forwardDeclare('goog.debug.ErrorHandler');
+goog.forwardDeclare('goog.events.EventWrapper');
+
+
+/**
+ * @typedef {number|goog.events.ListenableKey}
+ */
+goog.events.Key;
+
+
+/**
+ * @typedef {EventTarget|goog.events.Listenable}
+ */
+goog.events.ListenableType;
+
+
+/**
+ * Property name on a native event target for the listener map
+ * associated with the event target.
+ * @private @const {string}
+ */
+goog.events.LISTENER_MAP_PROP_ = 'closure_lm_' + ((Math.random() * 1e6) | 0);
+
+
+/**
+ * String used to prepend to IE event types.
+ * @const
+ * @private
+ */
+goog.events.onString_ = 'on';
+
+
+/**
+ * Map of computed "on<eventname>" strings for IE event types. Caching
+ * this removes an extra object allocation in goog.events.listen which
+ * improves IE6 performance.
+ * @const
+ * @dict
+ * @private
+ */
+goog.events.onStringMap_ = {};
+
+
+/**
+ * @enum {number} Different capture simulation mode for IE8-.
+ */
+goog.events.CaptureSimulationMode = {
+  /**
+   * Does not perform capture simulation. Will asserts in IE8- when you
+   * add capture listeners.
+   */
+  OFF_AND_FAIL: 0,
+
+  /**
+   * Does not perform capture simulation, silently ignore capture
+   * listeners.
+   */
+  OFF_AND_SILENT: 1,
+
+  /**
+   * Performs capture simulation.
+   */
+  ON: 2
+};
+
+
+/**
+ * @define {number} The capture simulation mode for IE8-. By default,
+ *     this is ON.
+ */
+goog.define('goog.events.CAPTURE_SIMULATION_MODE', 2);
+
+
+/**
+ * Estimated count of total native listeners.
+ * @private {number}
+ */
+goog.events.listenerCountEstimate_ = 0;
+
+
+/**
+ * Adds an event listener for a specific event on a native event
+ * target (such as a DOM element) or an object that has implemented
+ * {@link goog.events.Listenable}. A listener can only be added once
+ * to an object and if it is added again the key for the listener is
+ * returned. Note that if the existing listener is a one-off listener
+ * (registered via listenOnce), it will no longer be a one-off
+ * listener after a call to listen().
+ *
+ * @param {EventTarget|goog.events.Listenable} src The node to listen
+ *     to events on.
+ * @param {string|Array<string>|
+ *     !goog.events.EventId<EVENTOBJ>|!Array<!goog.events.EventId<EVENTOBJ>>}
+ *     type Event type or array of event types.
+ * @param {function(this:T, EVENTOBJ):?|{handleEvent:function(?):?}|null}
+ *     listener Callback method, or an object with a handleEvent function.
+ *     WARNING: passing an Object is now softly deprecated.
+ * @param {boolean=} opt_capt Whether to fire in capture phase (defaults to
+ *     false).
+ * @param {T=} opt_handler Element in whose scope to call the listener.
+ * @return {goog.events.Key} Unique key for the listener.
+ * @template T,EVENTOBJ
+ */
+goog.events.listen = function(src, type, listener, opt_capt, opt_handler) {
+  if (goog.isArray(type)) {
+    for (var i = 0; i < type.length; i++) {
+      goog.events.listen(src, type[i], listener, opt_capt, opt_handler);
+    }
+    return null;
+  }
+
+  listener = goog.events.wrapListener(listener);
+  if (goog.events.Listenable.isImplementedBy(src)) {
+    return src.listen(
+        /** @type {string|!goog.events.EventId} */ (type),
+        listener, opt_capt, opt_handler);
+  } else {
+    return goog.events.listen_(
+        /** @type {!EventTarget} */ (src),
+        /** @type {string|!goog.events.EventId} */ (type),
+        listener, /* callOnce */ false, opt_capt, opt_handler);
+  }
+};
+
+
+/**
+ * Adds an event listener for a specific event on a native event
+ * target. A listener can only be added once to an object and if it
+ * is added again the key for the listener is returned.
+ *
+ * Note that a one-off listener will not change an existing listener,
+ * if any. On the other hand a normal listener will change existing
+ * one-off listener to become a normal listener.
+ *
+ * @param {EventTarget} src The node to listen to events on.
+ * @param {string|!goog.events.EventId} type Event type.
+ * @param {!Function} listener Callback function.
+ * @param {boolean} callOnce Whether the listener is a one-off
+ *     listener or otherwise.
+ * @param {boolean=} opt_capt Whether to fire in capture phase (defaults to
+ *     false).
+ * @param {Object=} opt_handler Element in whose scope to call the listener.
+ * @return {goog.events.ListenableKey} Unique key for the listener.
+ * @private
+ */
+goog.events.listen_ = function(
+    src, type, listener, callOnce, opt_capt, opt_handler) {
+  if (!type) {
+    throw Error('Invalid event type');
+  }
+
+  var capture = !!opt_capt;
+  if (capture && !goog.events.BrowserFeature.HAS_W3C_EVENT_SUPPORT) {
+    if (goog.events.CAPTURE_SIMULATION_MODE ==
+        goog.events.CaptureSimulationMode.OFF_AND_FAIL) {
+      goog.asserts.fail('Can not register capture listener in IE8-.');
+      return null;
+    } else if (goog.events.CAPTURE_SIMULATION_MODE ==
+        goog.events.CaptureSimulationMode.OFF_AND_SILENT) {
+      return null;
+    }
+  }
+
+  var listenerMap = goog.events.getListenerMap_(src);
+  if (!listenerMap) {
+    src[goog.events.LISTENER_MAP_PROP_] = listenerMap =
+        new goog.events.ListenerMap(src);
+  }
+
+  var listenerObj = listenerMap.add(
+      type, listener, callOnce, opt_capt, opt_handler);
+
+  // If the listenerObj already has a proxy, it has been set up
+  // previously. We simply return.
+  if (listenerObj.proxy) {
+    return listenerObj;
+  }
+
+  var proxy = goog.events.getProxy();
+  listenerObj.proxy = proxy;
+
+  proxy.src = src;
+  proxy.listener = listenerObj;
+
+  // Attach the proxy through the browser's API
+  if (src.addEventListener) {
+    src.addEventListener(type.toString(), proxy, capture);
+  } else if (src.attachEvent) {
+    // The else if above used to be an unconditional else. It would call
+    // exception on IE11, spoiling the day of some callers. The previous
+    // incarnation of this code, from 2007, indicates that it replaced an
+    // earlier still version that caused excess allocations on IE6.
+    src.attachEvent(goog.events.getOnString_(type.toString()), proxy);
+  } else {
+    throw Error('addEventListener and attachEvent are unavailable.');
+  }
+
+  goog.events.listenerCountEstimate_++;
+  return listenerObj;
+};
+
+
+/**
+ * Helper function for returning a proxy function.
+ * @return {!Function} A new or reused function object.
+ */
+goog.events.getProxy = function() {
+  var proxyCallbackFunction = goog.events.handleBrowserEvent_;
+  // Use a local var f to prevent one allocation.
+  var f = goog.events.BrowserFeature.HAS_W3C_EVENT_SUPPORT ?
+      function(eventObject) {
+        return proxyCallbackFunction.call(f.src, f.listener, eventObject);
+      } :
+      function(eventObject) {
+        var v = proxyCallbackFunction.call(f.src, f.listener, eventObject);
+        // NOTE(chrishenry): In IE, we hack in a capture phase. However, if
+        // there is inline event handler which tries to prevent default (for
+        // example <a href="..." onclick="return false">...</a>) in a
+        // descendant element, the prevent default will be overridden
+        // by this listener if this listener were to return true. Hence, we
+        // return undefined.
+        if (!v) return v;
+      };
+  return f;
+};
+
+
+/**
+ * Adds an event listener for a specific event on a native event
+ * target (such as a DOM element) or an object that has implemented
+ * {@link goog.events.Listenable}. After the event has fired the event
+ * listener is removed from the target.
+ *
+ * If an existing listener already exists, listenOnce will do
+ * nothing. In particular, if the listener was previously registered
+ * via listen(), listenOnce() will not turn the listener into a
+ * one-off listener. Similarly, if there is already an existing
+ * one-off listener, listenOnce does not modify the listeners (it is
+ * still a once listener).
+ *
+ * @param {EventTarget|goog.events.Listenable} src The node to listen
+ *     to events on.
+ * @param {string|Array<string>|
+ *     !goog.events.EventId<EVENTOBJ>|!Array<!goog.events.EventId<EVENTOBJ>>}
+ *     type Event type or array of event types.
+ * @param {function(this:T, EVENTOBJ):?|{handleEvent:function(?):?}|null}
+ *     listener Callback method.
+ * @param {boolean=} opt_capt Fire in capture phase?.
+ * @param {T=} opt_handler Element in whose scope to call the listener.
+ * @return {goog.events.Key} Unique key for the listener.
+ * @template T,EVENTOBJ
+ */
+goog.events.listenOnce = function(src, type, listener, opt_capt, opt_handler) {
+  if (goog.isArray(type)) {
+    for (var i = 0; i < type.length; i++) {
+      goog.events.listenOnce(src, type[i], listener, opt_capt, opt_handler);
+    }
+    return null;
+  }
+
+  listener = goog.events.wrapListener(listener);
+  if (goog.events.Listenable.isImplementedBy(src)) {
+    return src.listenOnce(
+        /** @type {string|!goog.events.EventId} */ (type),
+        listener, opt_capt, opt_handler);
+  } else {
+    return goog.events.listen_(
+        /** @type {!EventTarget} */ (src),
+        /** @type {string|!goog.events.EventId} */ (type),
+        listener, /* callOnce */ true, opt_capt, opt_handler);
+  }
+};
+
+
+/**
+ * Adds an event listener with a specific event wrapper on a DOM Node or an
+ * object that has implemented {@link goog.events.Listenable}. A listener can
+ * only be added once to an object.
+ *
+ * @param {EventTarget|goog.events.Listenable} src The target to
+ *     listen to events on.
+ * @param {goog.events.EventWrapper} wrapper Event wrapper to use.
+ * @param {function(this:T, ?):?|{handleEvent:function(?):?}|null} listener
+ *     Callback method, or an object with a handleEvent function.
+ * @param {boolean=} opt_capt Whether to fire in capture phase (defaults to
+ *     false).
+ * @param {T=} opt_handler Element in whose scope to call the listener.
+ * @template T
+ */
+goog.events.listenWithWrapper = function(src, wrapper, listener, opt_capt,
+    opt_handler) {
+  wrapper.listen(src, listener, opt_capt, opt_handler);
+};
+
+
+/**
+ * Removes an event listener which was added with listen().
+ *
+ * @param {EventTarget|goog.events.Listenable} src The target to stop
+ *     listening to events on.
+ * @param {string|Array<string>|
+ *     !goog.events.EventId<EVENTOBJ>|!Array<!goog.events.EventId<EVENTOBJ>>}
+ *     type Event type or array of event types to unlisten to.
+ * @param {function(?):?|{handleEvent:function(?):?}|null} listener The
+ *     listener function to remove.
+ * @param {boolean=} opt_capt In DOM-compliant browsers, this determines
+ *     whether the listener is fired during the capture or bubble phase of the
+ *     event.
+ * @param {Object=} opt_handler Element in whose scope to call the listener.
+ * @return {?boolean} indicating whether the listener was there to remove.
+ * @template EVENTOBJ
+ */
+goog.events.unlisten = function(src, type, listener, opt_capt, opt_handler) {
+  if (goog.isArray(type)) {
+    for (var i = 0; i < type.length; i++) {
+      goog.events.unlisten(src, type[i], listener, opt_capt, opt_handler);
+    }
+    return null;
+  }
+
+  listener = goog.events.wrapListener(listener);
+  if (goog.events.Listenable.isImplementedBy(src)) {
+    return src.unlisten(
+        /** @type {string|!goog.events.EventId} */ (type),
+        listener, opt_capt, opt_handler);
+  }
+
+  if (!src) {
+    // TODO(chrishenry): We should tighten the API to only accept
+    // non-null objects, or add an assertion here.
+    return false;
+  }
+
+  var capture = !!opt_capt;
+  var listenerMap = goog.events.getListenerMap_(
+      /** @type {!EventTarget} */ (src));
+  if (listenerMap) {
+    var listenerObj = listenerMap.getListener(
+        /** @type {string|!goog.events.EventId} */ (type),
+        listener, capture, opt_handler);
+    if (listenerObj) {
+      return goog.events.unlistenByKey(listenerObj);
+    }
+  }
+
+  return false;
+};
+
+
+/**
+ * Removes an event listener which was added with listen() by the key
+ * returned by listen().
+ *
+ * @param {goog.events.Key} key The key returned by listen() for this
+ *     event listener.
+ * @return {boolean} indicating whether the listener was there to remove.
+ */
+goog.events.unlistenByKey = function(key) {
+  // TODO(chrishenry): Remove this check when tests that rely on this
+  // are fixed.
+  if (goog.isNumber(key)) {
+    return false;
+  }
+
+  var listener = key;
+  if (!listener || listener.removed) {
+    return false;
+  }
+
+  var src = listener.src;
+  if (goog.events.Listenable.isImplementedBy(src)) {
+    return src.unlistenByKey(listener);
+  }
+
+  var type = listener.type;
+  var proxy = listener.proxy;
+  if (src.removeEventListener) {
+    src.removeEventListener(type, proxy, listener.capture);
+  } else if (src.detachEvent) {
+    src.detachEvent(goog.events.getOnString_(type), proxy);
+  }
+  goog.events.listenerCountEstimate_--;
+
+  var listenerMap = goog.events.getListenerMap_(
+      /** @type {!EventTarget} */ (src));
+  // TODO(chrishenry): Try to remove this conditional and execute the
+  // first branch always. This should be safe.
+  if (listenerMap) {
+    listenerMap.removeByKey(listener);
+    if (listenerMap.getTypeCount() == 0) {
+      // Null the src, just because this is simple to do (and useful
+      // for IE <= 7).
+      listenerMap.src = null;
+      // We don't use delete here because IE does not allow delete
+      // on a window object.
+      src[goog.events.LISTENER_MAP_PROP_] = null;
+    }
+  } else {
+    listener.markAsRemoved();
+  }
+
+  return true;
+};
+
+
+/**
+ * Removes an event listener which was added with listenWithWrapper().
+ *
+ * @param {EventTarget|goog.events.Listenable} src The target to stop
+ *     listening to events on.
+ * @param {goog.events.EventWrapper} wrapper Event wrapper to use.
+ * @param {function(?):?|{handleEvent:function(?):?}|null} listener The
+ *     listener function to remove.
+ * @param {boolean=} opt_capt In DOM-compliant browsers, this determines
+ *     whether the listener is fired during the capture or bubble phase of the
+ *     event.
+ * @param {Object=} opt_handler Element in whose scope to call the listener.
+ */
+goog.events.unlistenWithWrapper = function(src, wrapper, listener, opt_capt,
+    opt_handler) {
+  wrapper.unlisten(src, listener, opt_capt, opt_handler);
+};
+
+
+/**
+ * Removes all listeners from an object. You can also optionally
+ * remove listeners of a particular type.
+ *
+ * @param {Object|undefined} obj Object to remove listeners from. Must be an
+ *     EventTarget or a goog.events.Listenable.
+ * @param {string|!goog.events.EventId=} opt_type Type of event to remove.
+ *     Default is all types.
+ * @return {number} Number of listeners removed.
+ */
+goog.events.removeAll = function(obj, opt_type) {
+  // TODO(chrishenry): Change the type of obj to
+  // (!EventTarget|!goog.events.Listenable).
+
+  if (!obj) {
+    return 0;
+  }
+
+  if (goog.events.Listenable.isImplementedBy(obj)) {
+    return obj.removeAllListeners(opt_type);
+  }
+
+  var listenerMap = goog.events.getListenerMap_(
+      /** @type {!EventTarget} */ (obj));
+  if (!listenerMap) {
+    return 0;
+  }
+
+  var count = 0;
+  var typeStr = opt_type && opt_type.toString();
+  for (var type in listenerMap.listeners) {
+    if (!typeStr || type == typeStr) {
+      // Clone so that we don't need to worry about unlistenByKey
+      // changing the content of the ListenerMap.
+      var listeners = listenerMap.listeners[type].concat();
+      for (var i = 0; i < listeners.length; ++i) {
+        if (goog.events.unlistenByKey(listeners[i])) {
+          ++count;
+        }
+      }
+    }
+  }
+  return count;
+};
+
+
+/**
+ * Gets the listeners for a given object, type and capture phase.
+ *
+ * @param {Object} obj Object to get listeners for.
+ * @param {string|!goog.events.EventId} type Event type.
+ * @param {boolean} capture Capture phase?.
+ * @return {Array<goog.events.Listener>} Array of listener objects.
+ */
+goog.events.getListeners = function(obj, type, capture) {
+  if (goog.events.Listenable.isImplementedBy(obj)) {
+    return obj.getListeners(type, capture);
+  } else {
+    if (!obj) {
+      // TODO(chrishenry): We should tighten the API to accept
+      // !EventTarget|goog.events.Listenable, and add an assertion here.
+      return [];
+    }
+
+    var listenerMap = goog.events.getListenerMap_(
+        /** @type {!EventTarget} */ (obj));
+    return listenerMap ? listenerMap.getListeners(type, capture) : [];
+  }
+};
+
+
+/**
+ * Gets the goog.events.Listener for the event or null if no such listener is
+ * in use.
+ *
+ * @param {EventTarget|goog.events.Listenable} src The target from
+ *     which to get listeners.
+ * @param {?string|!goog.events.EventId<EVENTOBJ>} type The type of the event.
+ * @param {function(EVENTOBJ):?|{handleEvent:function(?):?}|null} listener The
+ *     listener function to get.
+ * @param {boolean=} opt_capt In DOM-compliant browsers, this determines
+ *                            whether the listener is fired during the
+ *                            capture or bubble phase of the event.
+ * @param {Object=} opt_handler Element in whose scope to call the listener.
+ * @return {goog.events.ListenableKey} the found listener or null if not found.
+ * @template EVENTOBJ
+ */
+goog.events.getListener = function(src, type, listener, opt_capt, opt_handler) {
+  // TODO(chrishenry): Change type from ?string to string, or add assertion.
+  type = /** @type {string} */ (type);
+  listener = goog.events.wrapListener(listener);
+  var capture = !!opt_capt;
+  if (goog.events.Listenable.isImplementedBy(src)) {
+    return src.getListener(type, listener, capture, opt_handler);
+  }
+
+  if (!src) {
+    // TODO(chrishenry): We should tighten the API to only accept
+    // non-null objects, or add an assertion here.
+    return null;
+  }
+
+  var listenerMap = goog.events.getListenerMap_(
+      /** @type {!EventTarget} */ (src));
+  if (listenerMap) {
+    return listenerMap.getListener(type, listener, capture, opt_handler);
+  }
+  return null;
+};
+
+
+/**
+ * Returns whether an event target has any active listeners matching the
+ * specified signature. If either the type or capture parameters are
+ * unspecified, the function will match on the remaining criteria.
+ *
+ * @param {EventTarget|goog.events.Listenable} obj Target to get
+ *     listeners for.
+ * @param {string|!goog.events.EventId=} opt_type Event type.
+ * @param {boolean=} opt_capture Whether to check for capture or bubble-phase
+ *     listeners.
+ * @return {boolean} Whether an event target has one or more listeners matching
+ *     the requested type and/or capture phase.
+ */
+goog.events.hasListener = function(obj, opt_type, opt_capture) {
+  if (goog.events.Listenable.isImplementedBy(obj)) {
+    return obj.hasListener(opt_type, opt_capture);
+  }
+
+  var listenerMap = goog.events.getListenerMap_(
+      /** @type {!EventTarget} */ (obj));
+  return !!listenerMap && listenerMap.hasListener(opt_type, opt_capture);
+};
+
+
+/**
+ * Provides a nice string showing the normalized event objects public members
+ * @param {Object} e Event Object.
+ * @return {string} String of the public members of the normalized event object.
+ */
+goog.events.expose = function(e) {
+  var str = [];
+  for (var key in e) {
+    if (e[key] && e[key].id) {
+      str.push(key + ' = ' + e[key] + ' (' + e[key].id + ')');
+    } else {
+      str.push(key + ' = ' + e[key]);
+    }
+  }
+  return str.join('\n');
+};
+
+
+/**
+ * Returns a string with on prepended to the specified type. This is used for IE
+ * which expects "on" to be prepended. This function caches the string in order
+ * to avoid extra allocations in steady state.
+ * @param {string} type Event type.
+ * @return {string} The type string with 'on' prepended.
+ * @private
+ */
+goog.events.getOnString_ = function(type) {
+  if (type in goog.events.onStringMap_) {
+    return goog.events.onStringMap_[type];
+  }
+  return goog.events.onStringMap_[type] = goog.events.onString_ + type;
+};
+
+
+/**
+ * Fires an object's listeners of a particular type and phase
+ *
+ * @param {Object} obj Object whose listeners to call.
+ * @param {string|!goog.events.EventId} type Event type.
+ * @param {boolean} capture Which event phase.
+ * @param {Object} eventObject Event object to be passed to listener.
+ * @return {boolean} True if all listeners returned true else false.
+ */
+goog.events.fireListeners = function(obj, type, capture, eventObject) {
+  if (goog.events.Listenable.isImplementedBy(obj)) {
+    return obj.fireListeners(type, capture, eventObject);
+  }
+
+  return goog.events.fireListeners_(obj, type, capture, eventObject);
+};
+
+
+/**
+ * Fires an object's listeners of a particular type and phase.
+ * @param {Object} obj Object whose listeners to call.
+ * @param {string|!goog.events.EventId} type Event type.
+ * @param {boolean} capture Which event phase.
+ * @param {Object} eventObject Event object to be passed to listener.
+ * @return {boolean} True if all listeners returned true else false.
+ * @private
+ */
+goog.events.fireListeners_ = function(obj, type, capture, eventObject) {
+  /** @type {boolean} */
+  var retval = true;
+
+  var listenerMap = goog.events.getListenerMap_(
+      /** @type {EventTarget} */ (obj));
+  if (listenerMap) {
+    // TODO(chrishenry): Original code avoids array creation when there
+    // is no listener, so we do the same. If this optimization turns
+    // out to be not required, we can replace this with
+    // listenerMap.getListeners(type, capture) instead, which is simpler.
+    var listenerArray = listenerMap.listeners[type.toString()];
+    if (listenerArray) {
+      listenerArray = listenerArray.concat();
+      for (var i = 0; i < listenerArray.length; i++) {
+        var listener = listenerArray[i];
+        // We might not have a listener if the listener was removed.
+        if (listener && listener.capture == capture && !listener.removed) {
+          var result = goog.events.fireListener(listener, eventObject);
+          retval = retval && (result !== false);
+        }
+      }
+    }
+  }
+  return retval;
+};
+
+
+/**
+ * Fires a listener with a set of arguments
+ *
+ * @param {goog.events.Listener} listener The listener object to call.
+ * @param {Object} eventObject The event object to pass to the listener.
+ * @return {boolean} Result of listener.
+ */
+goog.events.fireListener = function(listener, eventObject) {
+  var listenerFn = listener.listener;
+  var listenerHandler = listener.handler || listener.src;
+
+  if (listener.callOnce) {
+    goog.events.unlistenByKey(listener);
+  }
+  return listenerFn.call(listenerHandler, eventObject);
+};
+
+
+/**
+ * Gets the total number of listeners currently in the system.
+ * @return {number} Number of listeners.
+ * @deprecated This returns estimated count, now that Closure no longer
+ * stores a central listener registry. We still return an estimation
+ * to keep existing listener-related tests passing. In the near future,
+ * this function will be removed.
+ */
+goog.events.getTotalListenerCount = function() {
+  return goog.events.listenerCountEstimate_;
+};
+
+
+/**
+ * Dispatches an event (or event like object) and calls all listeners
+ * listening for events of this type. The type of the event is decided by the
+ * type property on the event object.
+ *
+ * If any of the listeners returns false OR calls preventDefault then this
+ * function will return false.  If one of the capture listeners calls
+ * stopPropagation, then the bubble listeners won't fire.
+ *
+ * @param {goog.events.Listenable} src The event target.
+ * @param {goog.events.EventLike} e Event object.
+ * @return {boolean} If anyone called preventDefault on the event object (or
+ *     if any of the handlers returns false) this will also return false.
+ *     If there are no handlers, or if all handlers return true, this returns
+ *     true.
+ */
+goog.events.dispatchEvent = function(src, e) {
+  goog.asserts.assert(
+      goog.events.Listenable.isImplementedBy(src),
+      'Can not use goog.events.dispatchEvent with ' +
+      'non-goog.events.Listenable instance.');
+  return src.dispatchEvent(e);
+};
+
+
+/**
+ * Installs exception protection for the browser event entry point using the
+ * given error handler.
+ *
+ * @param {goog.debug.ErrorHandler} errorHandler Error handler with which to
+ *     protect the entry point.
+ */
+goog.events.protectBrowserEventEntryPoint = function(errorHandler) {
+  goog.events.handleBrowserEvent_ = errorHandler.protectEntryPoint(
+      goog.events.handleBrowserEvent_);
+};
+
+
+/**
+ * Handles an event and dispatches it to the correct listeners. This
+ * function is a proxy for the real listener the user specified.
+ *
+ * @param {goog.events.Listener} listener The listener object.
+ * @param {Event=} opt_evt Optional event object that gets passed in via the
+ *     native event handlers.
+ * @return {boolean} Result of the event handler.
+ * @this {EventTarget} The object or Element that fired the event.
+ * @private
+ */
+goog.events.handleBrowserEvent_ = function(listener, opt_evt) {
+  if (listener.removed) {
+    return true;
+  }
+
+  // Synthesize event propagation if the browser does not support W3C
+  // event model.
+  if (!goog.events.BrowserFeature.HAS_W3C_EVENT_SUPPORT) {
+    var ieEvent = opt_evt ||
+        /** @type {Event} */ (goog.getObjectByName('window.event'));
+    var evt = new goog.events.BrowserEvent(ieEvent, this);
+    /** @type {boolean} */
+    var retval = true;
+
+    if (goog.events.CAPTURE_SIMULATION_MODE ==
+            goog.events.CaptureSimulationMode.ON) {
+      // If we have not marked this event yet, we should perform capture
+      // simulation.
+      if (!goog.events.isMarkedIeEvent_(ieEvent)) {
+        goog.events.markIeEvent_(ieEvent);
+
+        var ancestors = [];
+        for (var parent = evt.currentTarget; parent;
+             parent = parent.parentNode) {
+          ancestors.push(parent);
+        }
+
+        // Fire capture listeners.
+        var type = listener.type;
+        for (var i = ancestors.length - 1; !evt.propagationStopped_ && i >= 0;
+             i--) {
+          evt.currentTarget = ancestors[i];
+          var result = goog.events.fireListeners_(ancestors[i], type, true, evt);
+          retval = retval && result;
+        }
+
+        // Fire bubble listeners.
+        //
+        // We can technically rely on IE to perform bubble event
+        // propagation. However, it turns out that IE fires events in
+        // opposite order of attachEvent registration, which broke
+        // some code and tests that rely on the order. (While W3C DOM
+        // Level 2 Events TR leaves the event ordering unspecified,
+        // modern browsers and W3C DOM Level 3 Events Working Draft
+        // actually specify the order as the registration order.)
+        for (var i = 0; !evt.propagationStopped_ && i < ancestors.length; i++) {
+          evt.currentTarget = ancestors[i];
+          var result = goog.events.fireListeners_(ancestors[i], type, false, evt);
+          retval = retval && result;
+        }
+      }
+    } else {
+      retval = goog.events.fireListener(listener, evt);
+    }
+    return retval;
+  }
+
+  // Otherwise, simply fire the listener.
+  return goog.events.fireListener(
+      listener, new goog.events.BrowserEvent(opt_evt, this));
+};
+
+
+/**
+ * This is used to mark the IE event object so we do not do the Closure pass
+ * twice for a bubbling event.
+ * @param {Event} e The IE browser event.
+ * @private
+ */
+goog.events.markIeEvent_ = function(e) {
+  // Only the keyCode and the returnValue can be changed. We use keyCode for
+  // non keyboard events.
+  // event.returnValue is a bit more tricky. It is undefined by default. A
+  // boolean false prevents the default action. In a window.onbeforeunload and
+  // the returnValue is non undefined it will be alerted. However, we will only
+  // modify the returnValue for keyboard events. We can get a problem if non
+  // closure events sets the keyCode or the returnValue
+
+  var useReturnValue = false;
+
+  if (e.keyCode == 0) {
+    // We cannot change the keyCode in case that srcElement is input[type=file].
+    // We could test that that is the case but that would allocate 3 objects.
+    // If we use try/catch we will only allocate extra objects in the case of a
+    // failure.
+    /** @preserveTry */
+    try {
+      e.keyCode = -1;
+      return;
+    } catch (ex) {
+      useReturnValue = true;
+    }
+  }
+
+  if (useReturnValue ||
+      /** @type {boolean|undefined} */ (e.returnValue) == undefined) {
+    e.returnValue = true;
+  }
+};
+
+
+/**
+ * This is used to check if an IE event has already been handled by the Closure
+ * system so we do not do the Closure pass twice for a bubbling event.
+ * @param {Event} e  The IE browser event.
+ * @return {boolean} True if the event object has been marked.
+ * @private
+ */
+goog.events.isMarkedIeEvent_ = function(e) {
+  return e.keyCode < 0 || e.returnValue != undefined;
+};
+
+
+/**
+ * Counter to create unique event ids.
+ * @private {number}
+ */
+goog.events.uniqueIdCounter_ = 0;
+
+
+/**
+ * Creates a unique event id.
+ *
+ * @param {string} identifier The identifier.
+ * @return {string} A unique identifier.
+ * @idGenerator
+ */
+goog.events.getUniqueId = function(identifier) {
+  return identifier + '_' + goog.events.uniqueIdCounter_++;
+};
+
+
+/**
+ * @param {EventTarget} src The source object.
+ * @return {goog.events.ListenerMap} A listener map for the given
+ *     source object, or null if none exists.
+ * @private
+ */
+goog.events.getListenerMap_ = function(src) {
+  var listenerMap = src[goog.events.LISTENER_MAP_PROP_];
+  // IE serializes the property as well (e.g. when serializing outer
+  // HTML). So we must check that the value is of the correct type.
+  return listenerMap instanceof goog.events.ListenerMap ? listenerMap : null;
+};
+
+
+/**
+ * Expando property for listener function wrapper for Object with
+ * handleEvent.
+ * @private @const {string}
+ */
+goog.events.LISTENER_WRAPPER_PROP_ = '__closure_events_fn_' +
+    ((Math.random() * 1e9) >>> 0);
+
+
+/**
+ * @param {Object|Function} listener The listener function or an
+ *     object that contains handleEvent method.
+ * @return {!Function} Either the original function or a function that
+ *     calls obj.handleEvent. If the same listener is passed to this
+ *     function more than once, the same function is guaranteed to be
+ *     returned.
+ */
+goog.events.wrapListener = function(listener) {
+  goog.asserts.assert(listener, 'Listener can not be null.');
+
+  if (goog.isFunction(listener)) {
+    return listener;
+  }
+
+  goog.asserts.assert(
+      listener.handleEvent, 'An object listener must have handleEvent method.');
+  if (!listener[goog.events.LISTENER_WRAPPER_PROP_]) {
+    listener[goog.events.LISTENER_WRAPPER_PROP_] =
+        function(e) { return listener.handleEvent(e); };
+  }
+  return listener[goog.events.LISTENER_WRAPPER_PROP_];
+};
+
+
+// Register the browser event handler as an entry point, so that
+// it can be monitored for exception handling, etc.
+goog.debug.entryPointRegistry.register(
+    /**
+     * @param {function(!Function): !Function} transformer The transforming
+     *     function.
+     */
+    function(transformer) {
+      goog.events.handleBrowserEvent_ = transformer(
+          goog.events.handleBrowserEvent_);
+    });
diff --git a/lib/goog/events/eventtarget.js b/lib/goog/events/eventtarget.js
new file mode 100644
index 0000000..7408c7e
--- /dev/null
+++ b/lib/goog/events/eventtarget.js
@@ -0,0 +1,394 @@
+// Copyright 2005 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A disposable implementation of a custom
+ * listenable/event target. See also: documentation for
+ * {@code goog.events.Listenable}.
+ *
+ * @author arv@google.com (Erik Arvidsson) [Original implementation]
+ * @see ../demos/eventtarget.html
+ * @see goog.events.Listenable
+ */
+
+goog.provide('goog.events.EventTarget');
+
+goog.require('goog.Disposable');
+goog.require('goog.asserts');
+goog.require('goog.events');
+goog.require('goog.events.Event');
+goog.require('goog.events.Listenable');
+goog.require('goog.events.ListenerMap');
+goog.require('goog.object');
+
+
+
+/**
+ * An implementation of {@code goog.events.Listenable} with full W3C
+ * EventTarget-like support (capture/bubble mechanism, stopping event
+ * propagation, preventing default actions).
+ *
+ * You may subclass this class to turn your class into a Listenable.
+ *
+ * Unless propagation is stopped, an event dispatched by an
+ * EventTarget will bubble to the parent returned by
+ * {@code getParentEventTarget}. To set the parent, call
+ * {@code setParentEventTarget}. Subclasses that don't support
+ * changing the parent can override the setter to throw an error.
+ *
+ * Example usage:
+ * <pre>
+ *   var source = new goog.events.EventTarget();
+ *   function handleEvent(e) {
+ *     alert('Type: ' + e.type + '; Target: ' + e.target);
+ *   }
+ *   source.listen('foo', handleEvent);
+ *   // Or: goog.events.listen(source, 'foo', handleEvent);
+ *   ...
+ *   source.dispatchEvent('foo');  // will call handleEvent
+ *   ...
+ *   source.unlisten('foo', handleEvent);
+ *   // Or: goog.events.unlisten(source, 'foo', handleEvent);
+ * </pre>
+ *
+ * @constructor
+ * @extends {goog.Disposable}
+ * @implements {goog.events.Listenable}
+ */
+goog.events.EventTarget = function() {
+  goog.Disposable.call(this);
+
+  /**
+   * Maps of event type to an array of listeners.
+   * @private {!goog.events.ListenerMap}
+   */
+  this.eventTargetListeners_ = new goog.events.ListenerMap(this);
+
+  /**
+   * The object to use for event.target. Useful when mixing in an
+   * EventTarget to another object.
+   * @private {!Object}
+   */
+  this.actualEventTarget_ = this;
+
+  /**
+   * Parent event target, used during event bubbling.
+   *
+   * TODO(chrishenry): Change this to goog.events.Listenable. This
+   * currently breaks people who expect getParentEventTarget to return
+   * goog.events.EventTarget.
+   *
+   * @private {goog.events.EventTarget}
+   */
+  this.parentEventTarget_ = null;
+};
+goog.inherits(goog.events.EventTarget, goog.Disposable);
+goog.events.Listenable.addImplementation(goog.events.EventTarget);
+
+
+/**
+ * An artificial cap on the number of ancestors you can have. This is mainly
+ * for loop detection.
+ * @const {number}
+ * @private
+ */
+goog.events.EventTarget.MAX_ANCESTORS_ = 1000;
+
+
+/**
+ * Returns the parent of this event target to use for bubbling.
+ *
+ * @return {goog.events.EventTarget} The parent EventTarget or null if
+ *     there is no parent.
+ * @override
+ */
+goog.events.EventTarget.prototype.getParentEventTarget = function() {
+  return this.parentEventTarget_;
+};
+
+
+/**
+ * Sets the parent of this event target to use for capture/bubble
+ * mechanism.
+ * @param {goog.events.EventTarget} parent Parent listenable (null if none).
+ */
+goog.events.EventTarget.prototype.setParentEventTarget = function(parent) {
+  this.parentEventTarget_ = parent;
+};
+
+
+/**
+ * Adds an event listener to the event target. The same handler can only be
+ * added once per the type. Even if you add the same handler multiple times
+ * using the same type then it will only be called once when the event is
+ * dispatched.
+ *
+ * @param {string} type The type of the event to listen for.
+ * @param {function(?):?|{handleEvent:function(?):?}|null} handler The function
+ *     to handle the event. The handler can also be an object that implements
+ *     the handleEvent method which takes the event object as argument.
+ * @param {boolean=} opt_capture In DOM-compliant browsers, this determines
+ *     whether the listener is fired during the capture or bubble phase
+ *     of the event.
+ * @param {Object=} opt_handlerScope Object in whose scope to call
+ *     the listener.
+ * @deprecated Use {@code #listen} instead, when possible. Otherwise, use
+ *     {@code goog.events.listen} if you are passing Object
+ *     (instead of Function) as handler.
+ */
+goog.events.EventTarget.prototype.addEventListener = function(
+    type, handler, opt_capture, opt_handlerScope) {
+  goog.events.listen(this, type, handler, opt_capture, opt_handlerScope);
+};
+
+
+/**
+ * Removes an event listener from the event target. The handler must be the
+ * same object as the one added. If the handler has not been added then
+ * nothing is done.
+ *
+ * @param {string} type The type of the event to listen for.
+ * @param {function(?):?|{handleEvent:function(?):?}|null} handler The function
+ *     to handle the event. The handler can also be an object that implements
+ *     the handleEvent method which takes the event object as argument.
+ * @param {boolean=} opt_capture In DOM-compliant browsers, this determines
+ *     whether the listener is fired during the capture or bubble phase
+ *     of the event.
+ * @param {Object=} opt_handlerScope Object in whose scope to call
+ *     the listener.
+ * @deprecated Use {@code #unlisten} instead, when possible. Otherwise, use
+ *     {@code goog.events.unlisten} if you are passing Object
+ *     (instead of Function) as handler.
+ */
+goog.events.EventTarget.prototype.removeEventListener = function(
+    type, handler, opt_capture, opt_handlerScope) {
+  goog.events.unlisten(this, type, handler, opt_capture, opt_handlerScope);
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.dispatchEvent = function(e) {
+  this.assertInitialized_();
+
+  var ancestorsTree, ancestor = this.getParentEventTarget();
+  if (ancestor) {
+    ancestorsTree = [];
+    var ancestorCount = 1;
+    for (; ancestor; ancestor = ancestor.getParentEventTarget()) {
+      ancestorsTree.push(ancestor);
+      goog.asserts.assert(
+          (++ancestorCount < goog.events.EventTarget.MAX_ANCESTORS_),
+          'infinite loop');
+    }
+  }
+
+  return goog.events.EventTarget.dispatchEventInternal_(
+      this.actualEventTarget_, e, ancestorsTree);
+};
+
+
+/**
+ * Removes listeners from this object.  Classes that extend EventTarget may
+ * need to override this method in order to remove references to DOM Elements
+ * and additional listeners.
+ * @override
+ */
+goog.events.EventTarget.prototype.disposeInternal = function() {
+  goog.events.EventTarget.superClass_.disposeInternal.call(this);
+
+  this.removeAllListeners();
+  this.parentEventTarget_ = null;
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.listen = function(
+    type, listener, opt_useCapture, opt_listenerScope) {
+  this.assertInitialized_();
+  return this.eventTargetListeners_.add(
+      String(type), listener, false /* callOnce */, opt_useCapture,
+      opt_listenerScope);
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.listenOnce = function(
+    type, listener, opt_useCapture, opt_listenerScope) {
+  return this.eventTargetListeners_.add(
+      String(type), listener, true /* callOnce */, opt_useCapture,
+      opt_listenerScope);
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.unlisten = function(
+    type, listener, opt_useCapture, opt_listenerScope) {
+  return this.eventTargetListeners_.remove(
+      String(type), listener, opt_useCapture, opt_listenerScope);
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.unlistenByKey = function(key) {
+  return this.eventTargetListeners_.removeByKey(key);
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.removeAllListeners = function(opt_type) {
+  // TODO(chrishenry): Previously, removeAllListeners can be called on
+  // uninitialized EventTarget, so we preserve that behavior. We
+  // should remove this when usages that rely on that fact are purged.
+  if (!this.eventTargetListeners_) {
+    return 0;
+  }
+  return this.eventTargetListeners_.removeAll(opt_type);
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.fireListeners = function(
+    type, capture, eventObject) {
+  // TODO(chrishenry): Original code avoids array creation when there
+  // is no listener, so we do the same. If this optimization turns
+  // out to be not required, we can replace this with
+  // getListeners(type, capture) instead, which is simpler.
+  var listenerArray = this.eventTargetListeners_.listeners[String(type)];
+  if (!listenerArray) {
+    return true;
+  }
+  listenerArray = listenerArray.concat();
+
+  var rv = true;
+  for (var i = 0; i < listenerArray.length; ++i) {
+    var listener = listenerArray[i];
+    // We might not have a listener if the listener was removed.
+    if (listener && !listener.removed && listener.capture == capture) {
+      var listenerFn = listener.listener;
+      var listenerHandler = listener.handler || listener.src;
+
+      if (listener.callOnce) {
+        this.unlistenByKey(listener);
+      }
+      rv = listenerFn.call(listenerHandler, eventObject) !== false && rv;
+    }
+  }
+
+  return rv && eventObject.returnValue_ != false;
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.getListeners = function(type, capture) {
+  return this.eventTargetListeners_.getListeners(String(type), capture);
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.getListener = function(
+    type, listener, capture, opt_listenerScope) {
+  return this.eventTargetListeners_.getListener(
+      String(type), listener, capture, opt_listenerScope);
+};
+
+
+/** @override */
+goog.events.EventTarget.prototype.hasListener = function(
+    opt_type, opt_capture) {
+  var id = goog.isDef(opt_type) ? String(opt_type) : undefined;
+  return this.eventTargetListeners_.hasListener(id, opt_capture);
+};
+
+
+/**
+ * Sets the target to be used for {@code event.target} when firing
+ * event. Mainly used for testing. For example, see
+ * {@code goog.testing.events.mixinListenable}.
+ * @param {!Object} target The target.
+ */
+goog.events.EventTarget.prototype.setTargetForTesting = function(target) {
+  this.actualEventTarget_ = target;
+};
+
+
+/**
+ * Asserts that the event target instance is initialized properly.
+ * @private
+ */
+goog.events.EventTarget.prototype.assertInitialized_ = function() {
+  goog.asserts.assert(
+      this.eventTargetListeners_,
+      'Event target is not initialized. Did you call the superclass ' +
+      '(goog.events.EventTarget) constructor?');
+};
+
+
+/**
+ * Dispatches the given event on the ancestorsTree.
+ *
+ * @param {!Object} target The target to dispatch on.
+ * @param {goog.events.Event|Object|string} e The event object.
+ * @param {Array<goog.events.Listenable>=} opt_ancestorsTree The ancestors
+ *     tree of the target, in reverse order from the closest ancestor
+ *     to the root event target. May be null if the target has no ancestor.
+ * @return {boolean} If anyone called preventDefault on the event object (or
+ *     if any of the listeners returns false) this will also return false.
+ * @private
+ */
+goog.events.EventTarget.dispatchEventInternal_ = function(
+    target, e, opt_ancestorsTree) {
+  var type = e.type || /** @type {string} */ (e);
+
+  // If accepting a string or object, create a custom event object so that
+  // preventDefault and stopPropagation work with the event.
+  if (goog.isString(e)) {
+    e = new goog.events.Event(e, target);
+  } else if (!(e instanceof goog.events.Event)) {
+    var oldEvent = e;
+    e = new goog.events.Event(type, target);
+    goog.object.extend(e, oldEvent);
+  } else {
+    e.target = e.target || target;
+  }
+
+  var rv = true, currentTarget;
+
+  // Executes all capture listeners on the ancestors, if any.
+  if (opt_ancestorsTree) {
+    for (var i = opt_ancestorsTree.length - 1; !e.propagationStopped_ && i >= 0;
+         i--) {
+      currentTarget = e.currentTarget = opt_ancestorsTree[i];
+      rv = currentTarget.fireListeners(type, true, e) && rv;
+    }
+  }
+
+  // Executes capture and bubble listeners on the target.
+  if (!e.propagationStopped_) {
+    currentTarget = e.currentTarget = target;
+    rv = currentTarget.fireListeners(type, true, e) && rv;
+    if (!e.propagationStopped_) {
+      rv = currentTarget.fireListeners(type, false, e) && rv;
+    }
+  }
+
+  // Executes all bubble listeners on the ancestors, if any.
+  if (opt_ancestorsTree) {
+    for (i = 0; !e.propagationStopped_ && i < opt_ancestorsTree.length; i++) {
+      currentTarget = e.currentTarget = opt_ancestorsTree[i];
+      rv = currentTarget.fireListeners(type, false, e) && rv;
+    }
+  }
+
+  return rv;
+};
diff --git a/lib/goog/events/eventtype.js b/lib/goog/events/eventtype.js
new file mode 100644
index 0000000..50748bd
--- /dev/null
+++ b/lib/goog/events/eventtype.js
@@ -0,0 +1,237 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Event Types.
+ *
+ * @author arv@google.com (Erik Arvidsson)
+ */
+
+
+goog.provide('goog.events.EventType');
+
+goog.require('goog.userAgent');
+
+
+/**
+ * Returns a prefixed event name for the current browser.
+ * @param {string} eventName The name of the event.
+ * @return {string} The prefixed event name.
+ * @suppress {missingRequire|missingProvide}
+ * @private
+ */
+goog.events.getVendorPrefixedName_ = function(eventName) {
+  return goog.userAgent.WEBKIT ? 'webkit' + eventName :
+      (goog.userAgent.OPERA ? 'o' + eventName.toLowerCase() :
+          eventName.toLowerCase());
+};
+
+
+/**
+ * Constants for event names.
+ * @enum {string}
+ */
+goog.events.EventType = {
+  // Mouse events
+  CLICK: 'click',
+  RIGHTCLICK: 'rightclick',
+  DBLCLICK: 'dblclick',
+  MOUSEDOWN: 'mousedown',
+  MOUSEUP: 'mouseup',
+  MOUSEOVER: 'mouseover',
+  MOUSEOUT: 'mouseout',
+  MOUSEMOVE: 'mousemove',
+  MOUSEENTER: 'mouseenter',
+  MOUSELEAVE: 'mouseleave',
+  // Select start is non-standard.
+  // See http://msdn.microsoft.com/en-us/library/ie/ms536969(v=vs.85).aspx.
+  SELECTSTART: 'selectstart', // IE, Safari, Chrome
+
+  // Wheel events
+  // http://www.w3.org/TR/DOM-Level-3-Events/#events-wheelevents
+  WHEEL: 'wheel',
+
+  // Key events
+  KEYPRESS: 'keypress',
+  KEYDOWN: 'keydown',
+  KEYUP: 'keyup',
+
+  // Focus
+  BLUR: 'blur',
+  FOCUS: 'focus',
+  DEACTIVATE: 'deactivate', // IE only
+  // NOTE: The following two events are not stable in cross-browser usage.
+  //     WebKit and Opera implement DOMFocusIn/Out.
+  //     IE implements focusin/out.
+  //     Gecko implements neither see bug at
+  //     https://bugzilla.mozilla.org/show_bug.cgi?id=396927.
+  // The DOM Events Level 3 Draft deprecates DOMFocusIn in favor of focusin:
+  //     http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html
+  // You can use FOCUS in Capture phase until implementations converge.
+  FOCUSIN: goog.userAgent.IE ? 'focusin' : 'DOMFocusIn',
+  FOCUSOUT: goog.userAgent.IE ? 'focusout' : 'DOMFocusOut',
+
+  // Forms
+  CHANGE: 'change',
+  RESET: 'reset',
+  SELECT: 'select',
+  SUBMIT: 'submit',
+  INPUT: 'input',
+  PROPERTYCHANGE: 'propertychange', // IE only
+
+  // Drag and drop
+  DRAGSTART: 'dragstart',
+  DRAG: 'drag',
+  DRAGENTER: 'dragenter',
+  DRAGOVER: 'dragover',
+  DRAGLEAVE: 'dragleave',
+  DROP: 'drop',
+  DRAGEND: 'dragend',
+
+  // Touch events
+  // Note that other touch events exist, but we should follow the W3C list here.
+  // http://www.w3.org/TR/touch-events/#list-of-touchevent-types
+  TOUCHSTART: 'touchstart',
+  TOUCHMOVE: 'touchmove',
+  TOUCHEND: 'touchend',
+  TOUCHCANCEL: 'touchcancel',
+
+  // Misc
+  BEFOREUNLOAD: 'beforeunload',
+  CONSOLEMESSAGE: 'consolemessage',
+  CONTEXTMENU: 'contextmenu',
+  DOMCONTENTLOADED: 'DOMContentLoaded',
+  ERROR: 'error',
+  HELP: 'help',
+  LOAD: 'load',
+  LOSECAPTURE: 'losecapture',
+  ORIENTATIONCHANGE: 'orientationchange',
+  READYSTATECHANGE: 'readystatechange',
+  RESIZE: 'resize',
+  SCROLL: 'scroll',
+  UNLOAD: 'unload',
+
+  // HTML 5 History events
+  // See http://www.w3.org/TR/html5/browsers.html#event-definitions-0
+  HASHCHANGE: 'hashchange',
+  PAGEHIDE: 'pagehide',
+  PAGESHOW: 'pageshow',
+  POPSTATE: 'popstate',
+
+  // Copy and Paste
+  // Support is limited. Make sure it works on your favorite browser
+  // before using.
+  // http://www.quirksmode.org/dom/events/cutcopypaste.html
+  COPY: 'copy',
+  PASTE: 'paste',
+  CUT: 'cut',
+  BEFORECOPY: 'beforecopy',
+  BEFORECUT: 'beforecut',
+  BEFOREPASTE: 'beforepaste',
+
+  // HTML5 online/offline events.
+  // http://www.w3.org/TR/offline-webapps/#related
+  ONLINE: 'online',
+  OFFLINE: 'offline',
+
+  // HTML 5 worker events
+  MESSAGE: 'message',
+  CONNECT: 'connect',
+
+  // CSS animation events.
+  /** @suppress {missingRequire} */
+  ANIMATIONSTART: goog.events.getVendorPrefixedName_('AnimationStart'),
+  /** @suppress {missingRequire} */
+  ANIMATIONEND: goog.events.getVendorPrefixedName_('AnimationEnd'),
+  /** @suppress {missingRequire} */
+  ANIMATIONITERATION: goog.events.getVendorPrefixedName_('AnimationIteration'),
+
+  // CSS transition events. Based on the browser support described at:
+  // https://developer.mozilla.org/en/css/css_transitions#Browser_compatibility
+  /** @suppress {missingRequire} */
+  TRANSITIONEND: goog.events.getVendorPrefixedName_('TransitionEnd'),
+
+  // W3C Pointer Events
+  // http://www.w3.org/TR/pointerevents/
+  POINTERDOWN: 'pointerdown',
+  POINTERUP: 'pointerup',
+  POINTERCANCEL: 'pointercancel',
+  POINTERMOVE: 'pointermove',
+  POINTEROVER: 'pointerover',
+  POINTEROUT: 'pointerout',
+  POINTERENTER: 'pointerenter',
+  POINTERLEAVE: 'pointerleave',
+  GOTPOINTERCAPTURE: 'gotpointercapture',
+  LOSTPOINTERCAPTURE: 'lostpointercapture',
+
+  // IE specific events.
+  // See http://msdn.microsoft.com/en-us/library/ie/hh772103(v=vs.85).aspx
+  // Note: these events will be supplanted in IE11.
+  MSGESTURECHANGE: 'MSGestureChange',
+  MSGESTUREEND: 'MSGestureEnd',
+  MSGESTUREHOLD: 'MSGestureHold',
+  MSGESTURESTART: 'MSGestureStart',
+  MSGESTURETAP: 'MSGestureTap',
+  MSGOTPOINTERCAPTURE: 'MSGotPointerCapture',
+  MSINERTIASTART: 'MSInertiaStart',
+  MSLOSTPOINTERCAPTURE: 'MSLostPointerCapture',
+  MSPOINTERCANCEL: 'MSPointerCancel',
+  MSPOINTERDOWN: 'MSPointerDown',
+  MSPOINTERENTER: 'MSPointerEnter',
+  MSPOINTERHOVER: 'MSPointerHover',
+  MSPOINTERLEAVE: 'MSPointerLeave',
+  MSPOINTERMOVE: 'MSPointerMove',
+  MSPOINTEROUT: 'MSPointerOut',
+  MSPOINTEROVER: 'MSPointerOver',
+  MSPOINTERUP: 'MSPointerUp',
+
+  // Native IMEs/input tools events.
+  TEXT: 'text',
+  TEXTINPUT: 'textInput',
+  COMPOSITIONSTART: 'compositionstart',
+  COMPOSITIONUPDATE: 'compositionupdate',
+  COMPOSITIONEND: 'compositionend',
+
+  // Webview tag events
+  // See http://developer.chrome.com/dev/apps/webview_tag.html
+  EXIT: 'exit',
+  LOADABORT: 'loadabort',
+  LOADCOMMIT: 'loadcommit',
+  LOADREDIRECT: 'loadredirect',
+  LOADSTART: 'loadstart',
+  LOADSTOP: 'loadstop',
+  RESPONSIVE: 'responsive',
+  SIZECHANGED: 'sizechanged',
+  UNRESPONSIVE: 'unresponsive',
+
+  // HTML5 Page Visibility API.  See details at
+  // {@code goog.labs.dom.PageVisibilityMonitor}.
+  VISIBILITYCHANGE: 'visibilitychange',
+
+  // LocalStorage event.
+  STORAGE: 'storage',
+
+  // DOM Level 2 mutation events (deprecated).
+  DOMSUBTREEMODIFIED: 'DOMSubtreeModified',
+  DOMNODEINSERTED: 'DOMNodeInserted',
+  DOMNODEREMOVED: 'DOMNodeRemoved',
+  DOMNODEREMOVEDFROMDOCUMENT: 'DOMNodeRemovedFromDocument',
+  DOMNODEINSERTEDINTODOCUMENT: 'DOMNodeInsertedIntoDocument',
+  DOMATTRMODIFIED: 'DOMAttrModified',
+  DOMCHARACTERDATAMODIFIED: 'DOMCharacterDataModified',
+
+  // Print events.
+  BEFOREPRINT: 'beforeprint',
+  AFTERPRINT: 'afterprint'
+};
diff --git a/lib/goog/events/keycodes.js b/lib/goog/events/keycodes.js
new file mode 100644
index 0000000..14ac86a
--- /dev/null
+++ b/lib/goog/events/keycodes.js
@@ -0,0 +1,427 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Constant declarations for common key codes.
+ *
+ * @author eae@google.com (Emil A Eklund)
+ * @see ../demos/keyhandler.html
+ */
+
+goog.provide('goog.events.KeyCodes');
+
+goog.require('goog.userAgent');
+
+goog.forwardDeclare('goog.events.BrowserEvent');
+
+
+/**
+ * Key codes for common characters.
+ *
+ * This list is not localized and therefore some of the key codes are not
+ * correct for non US keyboard layouts. See comments below.
+ *
+ * @enum {number}
+ */
+goog.events.KeyCodes = {
+  WIN_KEY_FF_LINUX: 0,
+  MAC_ENTER: 3,
+  BACKSPACE: 8,
+  TAB: 9,
+  NUM_CENTER: 12,  // NUMLOCK on FF/Safari Mac
+  ENTER: 13,
+  SHIFT: 16,
+  CTRL: 17,
+  ALT: 18,
+  PAUSE: 19,
+  CAPS_LOCK: 20,
+  ESC: 27,
+  SPACE: 32,
+  PAGE_UP: 33,     // also NUM_NORTH_EAST
+  PAGE_DOWN: 34,   // also NUM_SOUTH_EAST
+  END: 35,         // also NUM_SOUTH_WEST
+  HOME: 36,        // also NUM_NORTH_WEST
+  LEFT: 37,        // also NUM_WEST
+  UP: 38,          // also NUM_NORTH
+  RIGHT: 39,       // also NUM_EAST
+  DOWN: 40,        // also NUM_SOUTH
+  PLUS_SIGN: 43,   // NOT numpad plus
+  PRINT_SCREEN: 44,
+  INSERT: 45,      // also NUM_INSERT
+  DELETE: 46,      // also NUM_DELETE
+  ZERO: 48,
+  ONE: 49,
+  TWO: 50,
+  THREE: 51,
+  FOUR: 52,
+  FIVE: 53,
+  SIX: 54,
+  SEVEN: 55,
+  EIGHT: 56,
+  NINE: 57,
+  FF_SEMICOLON: 59, // Firefox (Gecko) fires this for semicolon instead of 186
+  FF_EQUALS: 61, // Firefox (Gecko) fires this for equals instead of 187
+  FF_DASH: 173, // Firefox (Gecko) fires this for dash instead of 189
+  QUESTION_MARK: 63, // needs localization
+  AT_SIGN: 64,
+  A: 65,
+  B: 66,
+  C: 67,
+  D: 68,
+  E: 69,
+  F: 70,
+  G: 71,
+  H: 72,
+  I: 73,
+  J: 74,
+  K: 75,
+  L: 76,
+  M: 77,
+  N: 78,
+  O: 79,
+  P: 80,
+  Q: 81,
+  R: 82,
+  S: 83,
+  T: 84,
+  U: 85,
+  V: 86,
+  W: 87,
+  X: 88,
+  Y: 89,
+  Z: 90,
+  META: 91, // WIN_KEY_LEFT
+  WIN_KEY_RIGHT: 92,
+  CONTEXT_MENU: 93,
+  NUM_ZERO: 96,
+  NUM_ONE: 97,
+  NUM_TWO: 98,
+  NUM_THREE: 99,
+  NUM_FOUR: 100,
+  NUM_FIVE: 101,
+  NUM_SIX: 102,
+  NUM_SEVEN: 103,
+  NUM_EIGHT: 104,
+  NUM_NINE: 105,
+  NUM_MULTIPLY: 106,
+  NUM_PLUS: 107,
+  NUM_MINUS: 109,
+  NUM_PERIOD: 110,
+  NUM_DIVISION: 111,
+  F1: 112,
+  F2: 113,
+  F3: 114,
+  F4: 115,
+  F5: 116,
+  F6: 117,
+  F7: 118,
+  F8: 119,
+  F9: 120,
+  F10: 121,
+  F11: 122,
+  F12: 123,
+  NUMLOCK: 144,
+  SCROLL_LOCK: 145,
+
+  // OS-specific media keys like volume controls and browser controls.
+  FIRST_MEDIA_KEY: 166,
+  LAST_MEDIA_KEY: 183,
+
+  SEMICOLON: 186,            // needs localization
+  DASH: 189,                 // needs localization
+  EQUALS: 187,               // needs localization
+  COMMA: 188,                // needs localization
+  PERIOD: 190,               // needs localization
+  SLASH: 191,                // needs localization
+  APOSTROPHE: 192,           // needs localization
+  TILDE: 192,                // needs localization
+  SINGLE_QUOTE: 222,         // needs localization
+  OPEN_SQUARE_BRACKET: 219,  // needs localization
+  BACKSLASH: 220,            // needs localization
+  CLOSE_SQUARE_BRACKET: 221, // needs localization
+  WIN_KEY: 224,
+  MAC_FF_META: 224, // Firefox (Gecko) fires this for the meta key instead of 91
+  MAC_WK_CMD_LEFT: 91,  // WebKit Left Command key fired, same as META
+  MAC_WK_CMD_RIGHT: 93, // WebKit Right Command key fired, different from META
+  WIN_IME: 229,
+
+  // "Reserved for future use". Some programs (e.g. the SlingPlayer 2.4 ActiveX
+  // control) fire this as a hacky way to disable screensavers.
+  VK_NONAME: 252,
+
+  // We've seen users whose machines fire this keycode at regular one
+  // second intervals. The common thread among these users is that
+  // they're all using Dell Inspiron laptops, so we suspect that this
+  // indicates a hardware/bios problem.
+  // http://en.community.dell.com/support-forums/laptop/f/3518/p/19285957/19523128.aspx
+  PHANTOM: 255
+};
+
+
+/**
+ * Returns true if the event contains a text modifying key.
+ * @param {goog.events.BrowserEvent} e A key event.
+ * @return {boolean} Whether it's a text modifying key.
+ */
+goog.events.KeyCodes.isTextModifyingKeyEvent = function(e) {
+  if (e.altKey && !e.ctrlKey ||
+      e.metaKey ||
+      // Function keys don't generate text
+      e.keyCode >= goog.events.KeyCodes.F1 &&
+      e.keyCode <= goog.events.KeyCodes.F12) {
+    return false;
+  }
+
+  // The following keys are quite harmless, even in combination with
+  // CTRL, ALT or SHIFT.
+  switch (e.keyCode) {
+    case goog.events.KeyCodes.ALT:
+    case goog.events.KeyCodes.CAPS_LOCK:
+    case goog.events.KeyCodes.CONTEXT_MENU:
+    case goog.events.KeyCodes.CTRL:
+    case goog.events.KeyCodes.DOWN:
+    case goog.events.KeyCodes.END:
+    case goog.events.KeyCodes.ESC:
+    case goog.events.KeyCodes.HOME:
+    case goog.events.KeyCodes.INSERT:
+    case goog.events.KeyCodes.LEFT:
+    case goog.events.KeyCodes.MAC_FF_META:
+    case goog.events.KeyCodes.META:
+    case goog.events.KeyCodes.NUMLOCK:
+    case goog.events.KeyCodes.NUM_CENTER:
+    case goog.events.KeyCodes.PAGE_DOWN:
+    case goog.events.KeyCodes.PAGE_UP:
+    case goog.events.KeyCodes.PAUSE:
+    case goog.events.KeyCodes.PHANTOM:
+    case goog.events.KeyCodes.PRINT_SCREEN:
+    case goog.events.KeyCodes.RIGHT:
+    case goog.events.KeyCodes.SCROLL_LOCK:
+    case goog.events.KeyCodes.SHIFT:
+    case goog.events.KeyCodes.UP:
+    case goog.events.KeyCodes.VK_NONAME:
+    case goog.events.KeyCodes.WIN_KEY:
+    case goog.events.KeyCodes.WIN_KEY_RIGHT:
+      return false;
+    case goog.events.KeyCodes.WIN_KEY_FF_LINUX:
+      return !goog.userAgent.GECKO;
+    default:
+      return e.keyCode < goog.events.KeyCodes.FIRST_MEDIA_KEY ||
+          e.keyCode > goog.events.KeyCodes.LAST_MEDIA_KEY;
+  }
+};
+
+
+/**
+ * Returns true if the key fires a keypress event in the current browser.
+ *
+ * Accoridng to MSDN [1] IE only fires keypress events for the following keys:
+ * - Letters: A - Z (uppercase and lowercase)
+ * - Numerals: 0 - 9
+ * - Symbols: ! @ # $ % ^ & * ( ) _ - + = < [ ] { } , . / ? \ | ' ` " ~
+ * - System: ESC, SPACEBAR, ENTER
+ *
+ * That's not entirely correct though, for instance there's no distinction
+ * between upper and lower case letters.
+ *
+ * [1] http://msdn2.microsoft.com/en-us/library/ms536939(VS.85).aspx)
+ *
+ * Safari is similar to IE, but does not fire keypress for ESC.
+ *
+ * Additionally, IE6 does not fire keydown or keypress events for letters when
+ * the control or alt keys are held down and the shift key is not. IE7 does
+ * fire keydown in these cases, though, but not keypress.
+ *
+ * @param {number} keyCode A key code.
+ * @param {number=} opt_heldKeyCode Key code of a currently-held key.
+ * @param {boolean=} opt_shiftKey Whether the shift key is held down.
+ * @param {boolean=} opt_ctrlKey Whether the control key is held down.
+ * @param {boolean=} opt_altKey Whether the alt key is held down.
+ * @return {boolean} Whether it's a key that fires a keypress event.
+ */
+goog.events.KeyCodes.firesKeyPressEvent = function(keyCode, opt_heldKeyCode,
+    opt_shiftKey, opt_ctrlKey, opt_altKey) {
+  if (!goog.userAgent.IE && !goog.userAgent.EDGE &&
+      !(goog.userAgent.WEBKIT && goog.userAgent.isVersionOrHigher('525'))) {
+    return true;
+  }
+
+  if (goog.userAgent.MAC && opt_altKey) {
+    return goog.events.KeyCodes.isCharacterKey(keyCode);
+  }
+
+  // Alt but not AltGr which is represented as Alt+Ctrl.
+  if (opt_altKey && !opt_ctrlKey) {
+    return false;
+  }
+
+  // Saves Ctrl or Alt + key for IE and WebKit 525+, which won't fire keypress.
+  // Non-IE browsers and WebKit prior to 525 won't get this far so no need to
+  // check the user agent.
+  if (goog.isNumber(opt_heldKeyCode)) {
+    opt_heldKeyCode = goog.events.KeyCodes.normalizeKeyCode(opt_heldKeyCode);
+  }
+  if (!opt_shiftKey &&
+      (opt_heldKeyCode == goog.events.KeyCodes.CTRL ||
+       opt_heldKeyCode == goog.events.KeyCodes.ALT ||
+       goog.userAgent.MAC &&
+       opt_heldKeyCode == goog.events.KeyCodes.META)) {
+    return false;
+  }
+
+  // Some keys with Ctrl/Shift do not issue keypress in WEBKIT.
+  if ((goog.userAgent.WEBKIT || goog.userAgent.EDGE) &&
+      opt_ctrlKey && opt_shiftKey) {
+    switch (keyCode) {
+      case goog.events.KeyCodes.BACKSLASH:
+      case goog.events.KeyCodes.OPEN_SQUARE_BRACKET:
+      case goog.events.KeyCodes.CLOSE_SQUARE_BRACKET:
+      case goog.events.KeyCodes.TILDE:
+      case goog.events.KeyCodes.SEMICOLON:
+      case goog.events.KeyCodes.DASH:
+      case goog.events.KeyCodes.EQUALS:
+      case goog.events.KeyCodes.COMMA:
+      case goog.events.KeyCodes.PERIOD:
+      case goog.events.KeyCodes.SLASH:
+      case goog.events.KeyCodes.APOSTROPHE:
+      case goog.events.KeyCodes.SINGLE_QUOTE:
+        return false;
+    }
+  }
+
+  // When Ctrl+<somekey> is held in IE, it only fires a keypress once, but it
+  // continues to fire keydown events as the event repeats.
+  if (goog.userAgent.IE && opt_ctrlKey && opt_heldKeyCode == keyCode) {
+    return false;
+  }
+
+  switch (keyCode) {
+    case goog.events.KeyCodes.ENTER:
+      return true;
+    case goog.events.KeyCodes.ESC:
+      return !(goog.userAgent.WEBKIT || goog.userAgent.EDGE);
+  }
+
+  return goog.events.KeyCodes.isCharacterKey(keyCode);
+};
+
+
+/**
+ * Returns true if the key produces a character.
+ * This does not cover characters on non-US keyboards (Russian, Hebrew, etc.).
+ *
+ * @param {number} keyCode A key code.
+ * @return {boolean} Whether it's a character key.
+ */
+goog.events.KeyCodes.isCharacterKey = function(keyCode) {
+  if (keyCode >= goog.events.KeyCodes.ZERO &&
+      keyCode <= goog.events.KeyCodes.NINE) {
+    return true;
+  }
+
+  if (keyCode >= goog.events.KeyCodes.NUM_ZERO &&
+      keyCode <= goog.events.KeyCodes.NUM_MULTIPLY) {
+    return true;
+  }
+
+  if (keyCode >= goog.events.KeyCodes.A &&
+      keyCode <= goog.events.KeyCodes.Z) {
+    return true;
+  }
+
+  // Safari sends zero key code for non-latin characters.
+  if ((goog.userAgent.WEBKIT || goog.userAgent.EDGE) && keyCode == 0) {
+    return true;
+  }
+
+  switch (keyCode) {
+    case goog.events.KeyCodes.SPACE:
+    case goog.events.KeyCodes.PLUS_SIGN:
+    case goog.events.KeyCodes.QUESTION_MARK:
+    case goog.events.KeyCodes.AT_SIGN:
+    case goog.events.KeyCodes.NUM_PLUS:
+    case goog.events.KeyCodes.NUM_MINUS:
+    case goog.events.KeyCodes.NUM_PERIOD:
+    case goog.events.KeyCodes.NUM_DIVISION:
+    case goog.events.KeyCodes.SEMICOLON:
+    case goog.events.KeyCodes.FF_SEMICOLON:
+    case goog.events.KeyCodes.DASH:
+    case goog.events.KeyCodes.EQUALS:
+    case goog.events.KeyCodes.FF_EQUALS:
+    case goog.events.KeyCodes.COMMA:
+    case goog.events.KeyCodes.PERIOD:
+    case goog.events.KeyCodes.SLASH:
+    case goog.events.KeyCodes.APOSTROPHE:
+    case goog.events.KeyCodes.SINGLE_QUOTE:
+    case goog.events.KeyCodes.OPEN_SQUARE_BRACKET:
+    case goog.events.KeyCodes.BACKSLASH:
+    case goog.events.KeyCodes.CLOSE_SQUARE_BRACKET:
+      return true;
+    default:
+      return false;
+  }
+};
+
+
+/**
+ * Normalizes key codes from OS/Browser-specific value to the general one.
+ * @param {number} keyCode The native key code.
+ * @return {number} The normalized key code.
+ */
+goog.events.KeyCodes.normalizeKeyCode = function(keyCode) {
+  if (goog.userAgent.GECKO) {
+    return goog.events.KeyCodes.normalizeGeckoKeyCode(keyCode);
+  } else if (goog.userAgent.MAC && goog.userAgent.WEBKIT) {
+    return goog.events.KeyCodes.normalizeMacWebKitKeyCode(keyCode);
+  } else {
+    return keyCode;
+  }
+};
+
+
+/**
+ * Normalizes key codes from their Gecko-specific value to the general one.
+ * @param {number} keyCode The native key code.
+ * @return {number} The normalized key code.
+ */
+goog.events.KeyCodes.normalizeGeckoKeyCode = function(keyCode) {
+  switch (keyCode) {
+    case goog.events.KeyCodes.FF_EQUALS:
+      return goog.events.KeyCodes.EQUALS;
+    case goog.events.KeyCodes.FF_SEMICOLON:
+      return goog.events.KeyCodes.SEMICOLON;
+    case goog.events.KeyCodes.FF_DASH:
+      return goog.events.KeyCodes.DASH;
+    case goog.events.KeyCodes.MAC_FF_META:
+      return goog.events.KeyCodes.META;
+    case goog.events.KeyCodes.WIN_KEY_FF_LINUX:
+      return goog.events.KeyCodes.WIN_KEY;
+    default:
+      return keyCode;
+  }
+};
+
+
+/**
+ * Normalizes key codes from their Mac WebKit-specific value to the general one.
+ * @param {number} keyCode The native key code.
+ * @return {number} The normalized key code.
+ */
+goog.events.KeyCodes.normalizeMacWebKitKeyCode = function(keyCode) {
+  switch (keyCode) {
+    case goog.events.KeyCodes.MAC_WK_CMD_RIGHT:  // 93
+      return goog.events.KeyCodes.META;          // 91
+    default:
+      return keyCode;
+  }
+};
diff --git a/lib/goog/events/listenable.js b/lib/goog/events/listenable.js
new file mode 100644
index 0000000..9522062
--- /dev/null
+++ b/lib/goog/events/listenable.js
@@ -0,0 +1,335 @@
+// Copyright 2012 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview An interface for a listenable JavaScript object.
+ * @author chrishenry@google.com (Chris Henry)
+ */
+
+goog.provide('goog.events.Listenable');
+goog.provide('goog.events.ListenableKey');
+
+/** @suppress {extraRequire} */
+goog.require('goog.events.EventId');
+
+
+
+/**
+ * A listenable interface. A listenable is an object with the ability
+ * to dispatch/broadcast events to "event listeners" registered via
+ * listen/listenOnce.
+ *
+ * The interface allows for an event propagation mechanism similar
+ * to one offered by native browser event targets, such as
+ * capture/bubble mechanism, stopping propagation, and preventing
+ * default actions. Capture/bubble mechanism depends on the ancestor
+ * tree constructed via {@code #getParentEventTarget}; this tree
+ * must be directed acyclic graph. The meaning of default action(s)
+ * in preventDefault is specific to a particular use case.
+ *
+ * Implementations that do not support capture/bubble or can not have
+ * a parent listenable can simply not implement any ability to set the
+ * parent listenable (and have {@code #getParentEventTarget} return
+ * null).
+ *
+ * Implementation of this class can be used with or independently from
+ * goog.events.
+ *
+ * Implementation must call {@code #addImplementation(implClass)}.
+ *
+ * @interface
+ * @see goog.events
+ * @see http://www.w3.org/TR/DOM-Level-2-Events/events.html
+ */
+goog.events.Listenable = function() {};
+
+
+/**
+ * An expando property to indicate that an object implements
+ * goog.events.Listenable.
+ *
+ * See addImplementation/isImplementedBy.
+ *
+ * @type {string}
+ * @const
+ */
+goog.events.Listenable.IMPLEMENTED_BY_PROP =
+    'closure_listenable_' + ((Math.random() * 1e6) | 0);
+
+
+/**
+ * Marks a given class (constructor) as an implementation of
+ * Listenable, do that we can query that fact at runtime. The class
+ * must have already implemented the interface.
+ * @param {!Function} cls The class constructor. The corresponding
+ *     class must have already implemented the interface.
+ */
+goog.events.Listenable.addImplementation = function(cls) {
+  cls.prototype[goog.events.Listenable.IMPLEMENTED_BY_PROP] = true;
+};
+
+
+/**
+ * @param {Object} obj The object to check.
+ * @return {boolean} Whether a given instance implements Listenable. The
+ *     class/superclass of the instance must call addImplementation.
+ */
+goog.events.Listenable.isImplementedBy = function(obj) {
+  return !!(obj && obj[goog.events.Listenable.IMPLEMENTED_BY_PROP]);
+};
+
+
+/**
+ * Adds an event listener. A listener can only be added once to an
+ * object and if it is added again the key for the listener is
+ * returned. Note that if the existing listener is a one-off listener
+ * (registered via listenOnce), it will no longer be a one-off
+ * listener after a call to listen().
+ *
+ * @param {string|!goog.events.EventId<EVENTOBJ>} type The event type id.
+ * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback
+ *     method.
+ * @param {boolean=} opt_useCapture Whether to fire in capture phase
+ *     (defaults to false).
+ * @param {SCOPE=} opt_listenerScope Object in whose scope to call the
+ *     listener.
+ * @return {goog.events.ListenableKey} Unique key for the listener.
+ * @template SCOPE,EVENTOBJ
+ */
+goog.events.Listenable.prototype.listen;
+
+
+/**
+ * Adds an event listener that is removed automatically after the
+ * listener fired once.
+ *
+ * If an existing listener already exists, listenOnce will do
+ * nothing. In particular, if the listener was previously registered
+ * via listen(), listenOnce() will not turn the listener into a
+ * one-off listener. Similarly, if there is already an existing
+ * one-off listener, listenOnce does not modify the listeners (it is
+ * still a once listener).
+ *
+ * @param {string|!goog.events.EventId<EVENTOBJ>} type The event type id.
+ * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback
+ *     method.
+ * @param {boolean=} opt_useCapture Whether to fire in capture phase
+ *     (defaults to false).
+ * @param {SCOPE=} opt_listenerScope Object in whose scope to call the
+ *     listener.
+ * @return {goog.events.ListenableKey} Unique key for the listener.
+ * @template SCOPE,EVENTOBJ
+ */
+goog.events.Listenable.prototype.listenOnce;
+
+
+/**
+ * Removes an event listener which was added with listen() or listenOnce().
+ *
+ * @param {string|!goog.events.EventId<EVENTOBJ>} type The event type id.
+ * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener Callback
+ *     method.
+ * @param {boolean=} opt_useCapture Whether to fire in capture phase
+ *     (defaults to false).
+ * @param {SCOPE=} opt_listenerScope Object in whose scope to call
+ *     the listener.
+ * @return {boolean} Whether any listener was removed.
+ * @template SCOPE,EVENTOBJ
+ */
+goog.events.Listenable.prototype.unlisten;
+
+
+/**
+ * Removes an event listener which was added with listen() by the key
+ * returned by listen().
+ *
+ * @param {goog.events.ListenableKey} key The key returned by
+ *     listen() or listenOnce().
+ * @return {boolean} Whether any listener was removed.
+ */
+goog.events.Listenable.prototype.unlistenByKey;
+
+
+/**
+ * Dispatches an event (or event like object) and calls all listeners
+ * listening for events of this type. The type of the event is decided by the
+ * type property on the event object.
+ *
+ * If any of the listeners returns false OR calls preventDefault then this
+ * function will return false.  If one of the capture listeners calls
+ * stopPropagation, then the bubble listeners won't fire.
+ *
+ * @param {goog.events.EventLike} e Event object.
+ * @return {boolean} If anyone called preventDefault on the event object (or
+ *     if any of the listeners returns false) this will also return false.
+ */
+goog.events.Listenable.prototype.dispatchEvent;
+
+
+/**
+ * Removes all listeners from this listenable. If type is specified,
+ * it will only remove listeners of the particular type. otherwise all
+ * registered listeners will be removed.
+ *
+ * @param {string=} opt_type Type of event to remove, default is to
+ *     remove all types.
+ * @return {number} Number of listeners removed.
+ */
+goog.events.Listenable.prototype.removeAllListeners;
+
+
+/**
+ * Returns the parent of this event target to use for capture/bubble
+ * mechanism.
+ *
+ * NOTE(chrishenry): The name reflects the original implementation of
+ * custom event target ({@code goog.events.EventTarget}). We decided
+ * that changing the name is not worth it.
+ *
+ * @return {goog.events.Listenable} The parent EventTarget or null if
+ *     there is no parent.
+ */
+goog.events.Listenable.prototype.getParentEventTarget;
+
+
+/**
+ * Fires all registered listeners in this listenable for the given
+ * type and capture mode, passing them the given eventObject. This
+ * does not perform actual capture/bubble. Only implementors of the
+ * interface should be using this.
+ *
+ * @param {string|!goog.events.EventId<EVENTOBJ>} type The type of the
+ *     listeners to fire.
+ * @param {boolean} capture The capture mode of the listeners to fire.
+ * @param {EVENTOBJ} eventObject The event object to fire.
+ * @return {boolean} Whether all listeners succeeded without
+ *     attempting to prevent default behavior. If any listener returns
+ *     false or called goog.events.Event#preventDefault, this returns
+ *     false.
+ * @template EVENTOBJ
+ */
+goog.events.Listenable.prototype.fireListeners;
+
+
+/**
+ * Gets all listeners in this listenable for the given type and
+ * capture mode.
+ *
+ * @param {string|!goog.events.EventId} type The type of the listeners to fire.
+ * @param {boolean} capture The capture mode of the listeners to fire.
+ * @return {!Array<goog.events.ListenableKey>} An array of registered
+ *     listeners.
+ * @template EVENTOBJ
+ */
+goog.events.Listenable.prototype.getListeners;
+
+
+/**
+ * Gets the goog.events.ListenableKey for the event or null if no such
+ * listener is in use.
+ *
+ * @param {string|!goog.events.EventId<EVENTOBJ>} type The name of the event
+ *     without the 'on' prefix.
+ * @param {function(this:SCOPE, EVENTOBJ):(boolean|undefined)} listener The
+ *     listener function to get.
+ * @param {boolean} capture Whether the listener is a capturing listener.
+ * @param {SCOPE=} opt_listenerScope Object in whose scope to call the
+ *     listener.
+ * @return {goog.events.ListenableKey} the found listener or null if not found.
+ * @template SCOPE,EVENTOBJ
+ */
+goog.events.Listenable.prototype.getListener;
+
+
+/**
+ * Whether there is any active listeners matching the specified
+ * signature. If either the type or capture parameters are
+ * unspecified, the function will match on the remaining criteria.
+ *
+ * @param {string|!goog.events.EventId<EVENTOBJ>=} opt_type Event type.
+ * @param {boolean=} opt_capture Whether to check for capture or bubble
+ *     listeners.
+ * @return {boolean} Whether there is any active listeners matching
+ *     the requested type and/or capture phase.
+ * @template EVENTOBJ
+ */
+goog.events.Listenable.prototype.hasListener;
+
+
+
+/**
+ * An interface that describes a single registered listener.
+ * @interface
+ */
+goog.events.ListenableKey = function() {};
+
+
+/**
+ * Counter used to create a unique key
+ * @type {number}
+ * @private
+ */
+goog.events.ListenableKey.counter_ = 0;
+
+
+/**
+ * Reserves a key to be used for ListenableKey#key field.
+ * @return {number} A number to be used to fill ListenableKey#key
+ *     field.
+ */
+goog.events.ListenableKey.reserveKey = function() {
+  return ++goog.events.ListenableKey.counter_;
+};
+
+
+/**
+ * The source event target.
+ * @type {Object|goog.events.Listenable|goog.events.EventTarget}
+ */
+goog.events.ListenableKey.prototype.src;
+
+
+/**
+ * The event type the listener is listening to.
+ * @type {string}
+ */
+goog.events.ListenableKey.prototype.type;
+
+
+/**
+ * The listener function.
+ * @type {function(?):?|{handleEvent:function(?):?}|null}
+ */
+goog.events.ListenableKey.prototype.listener;
+
+
+/**
+ * Whether the listener works on capture phase.
+ * @type {boolean}
+ */
+goog.events.ListenableKey.prototype.capture;
+
+
+/**
+ * The 'this' object for the listener function's scope.
+ * @type {Object|undefined}
+ */
+goog.events.ListenableKey.prototype.handler;
+
+
+/**
+ * A globally unique number to identify the key.
+ * @type {number}
+ */
+goog.events.ListenableKey.prototype.key;
diff --git a/lib/goog/events/listener.js b/lib/goog/events/listener.js
new file mode 100644
index 0000000..60c7370
--- /dev/null
+++ b/lib/goog/events/listener.js
@@ -0,0 +1,131 @@
+// Copyright 2005 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Listener object.
+ * @see ../demos/events.html
+ */
+
+goog.provide('goog.events.Listener');
+
+goog.require('goog.events.ListenableKey');
+
+
+
+/**
+ * Simple class that stores information about a listener
+ * @param {!Function} listener Callback function.
+ * @param {Function} proxy Wrapper for the listener that patches the event.
+ * @param {EventTarget|goog.events.Listenable} src Source object for
+ *     the event.
+ * @param {string} type Event type.
+ * @param {boolean} capture Whether in capture or bubble phase.
+ * @param {Object=} opt_handler Object in whose context to execute the callback.
+ * @implements {goog.events.ListenableKey}
+ * @constructor
+ */
+goog.events.Listener = function(
+    listener, proxy, src, type, capture, opt_handler) {
+  if (goog.events.Listener.ENABLE_MONITORING) {
+    this.creationStack = new Error().stack;
+  }
+
+  /**
+   * Callback function.
+   * @type {Function}
+   */
+  this.listener = listener;
+
+  /**
+   * A wrapper over the original listener. This is used solely to
+   * handle native browser events (it is used to simulate the capture
+   * phase and to patch the event object).
+   * @type {Function}
+   */
+  this.proxy = proxy;
+
+  /**
+   * Object or node that callback is listening to
+   * @type {EventTarget|goog.events.Listenable}
+   */
+  this.src = src;
+
+  /**
+   * The event type.
+   * @const {string}
+   */
+  this.type = type;
+
+  /**
+   * Whether the listener is being called in the capture or bubble phase
+   * @const {boolean}
+   */
+  this.capture = !!capture;
+
+  /**
+   * Optional object whose context to execute the listener in
+   * @type {Object|undefined}
+   */
+  this.handler = opt_handler;
+
+  /**
+   * The key of the listener.
+   * @const {number}
+   * @override
+   */
+  this.key = goog.events.ListenableKey.reserveKey();
+
+  /**
+   * Whether to remove the listener after it has been called.
+   * @type {boolean}
+   */
+  this.callOnce = false;
+
+  /**
+   * Whether the listener has been removed.
+   * @type {boolean}
+   */
+  this.removed = false;
+};
+
+
+/**
+ * @define {boolean} Whether to enable the monitoring of the
+ *     goog.events.Listener instances. Switching on the monitoring is only
+ *     recommended for debugging because it has a significant impact on
+ *     performance and memory usage. If switched off, the monitoring code
+ *     compiles down to 0 bytes.
+ */
+goog.define('goog.events.Listener.ENABLE_MONITORING', false);
+
+
+/**
+ * If monitoring the goog.events.Listener instances is enabled, stores the
+ * creation stack trace of the Disposable instance.
+ * @type {string}
+ */
+goog.events.Listener.prototype.creationStack;
+
+
+/**
+ * Marks this listener as removed. This also remove references held by
+ * this listener object (such as listener and event source).
+ */
+goog.events.Listener.prototype.markAsRemoved = function() {
+  this.removed = true;
+  this.listener = null;
+  this.proxy = null;
+  this.src = null;
+  this.handler = null;
+};
diff --git a/lib/goog/events/listenermap.js b/lib/goog/events/listenermap.js
new file mode 100644
index 0000000..c20cdb9
--- /dev/null
+++ b/lib/goog/events/listenermap.js
@@ -0,0 +1,308 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A map of listeners that provides utility functions to
+ * deal with listeners on an event target. Used by
+ * {@code goog.events.EventTarget}.
+ *
+ * WARNING: Do not use this class from outside goog.events package.
+ *
+ * @visibility {//closure/goog/bin/sizetests:__pkg__}
+ * @visibility {//closure/goog/events:__pkg__}
+ * @visibility {//closure/goog/labs/events:__pkg__}
+ */
+
+goog.provide('goog.events.ListenerMap');
+
+goog.require('goog.array');
+goog.require('goog.events.Listener');
+goog.require('goog.object');
+
+
+
+/**
+ * Creates a new listener map.
+ * @param {EventTarget|goog.events.Listenable} src The src object.
+ * @constructor
+ * @final
+ */
+goog.events.ListenerMap = function(src) {
+  /** @type {EventTarget|goog.events.Listenable} */
+  this.src = src;
+
+  /**
+   * Maps of event type to an array of listeners.
+   * @type {Object<string, !Array<!goog.events.Listener>>}
+   */
+  this.listeners = {};
+
+  /**
+   * The count of types in this map that have registered listeners.
+   * @private {number}
+   */
+  this.typeCount_ = 0;
+};
+
+
+/**
+ * @return {number} The count of event types in this map that actually
+ *     have registered listeners.
+ */
+goog.events.ListenerMap.prototype.getTypeCount = function() {
+  return this.typeCount_;
+};
+
+
+/**
+ * @return {number} Total number of registered listeners.
+ */
+goog.events.ListenerMap.prototype.getListenerCount = function() {
+  var count = 0;
+  for (var type in this.listeners) {
+    count += this.listeners[type].length;
+  }
+  return count;
+};
+
+
+/**
+ * Adds an event listener. A listener can only be added once to an
+ * object and if it is added again the key for the listener is
+ * returned.
+ *
+ * Note that a one-off listener will not change an existing listener,
+ * if any. On the other hand a normal listener will change existing
+ * one-off listener to become a normal listener.
+ *
+ * @param {string|!goog.events.EventId} type The listener event type.
+ * @param {!Function} listener This listener callback method.
+ * @param {boolean} callOnce Whether the listener is a one-off
+ *     listener.
+ * @param {boolean=} opt_useCapture The capture mode of the listener.
+ * @param {Object=} opt_listenerScope Object in whose scope to call the
+ *     listener.
+ * @return {goog.events.ListenableKey} Unique key for the listener.
+ */
+goog.events.ListenerMap.prototype.add = function(
+    type, listener, callOnce, opt_useCapture, opt_listenerScope) {
+  var typeStr = type.toString();
+  var listenerArray = this.listeners[typeStr];
+  if (!listenerArray) {
+    listenerArray = this.listeners[typeStr] = [];
+    this.typeCount_++;
+  }
+
+  var listenerObj;
+  var index = goog.events.ListenerMap.findListenerIndex_(
+      listenerArray, listener, opt_useCapture, opt_listenerScope);
+  if (index > -1) {
+    listenerObj = listenerArray[index];
+    if (!callOnce) {
+      // Ensure that, if there is an existing callOnce listener, it is no
+      // longer a callOnce listener.
+      listenerObj.callOnce = false;
+    }
+  } else {
+    listenerObj = new goog.events.Listener(
+        listener, null, this.src, typeStr, !!opt_useCapture, opt_listenerScope);
+    listenerObj.callOnce = callOnce;
+    listenerArray.push(listenerObj);
+  }
+  return listenerObj;
+};
+
+
+/**
+ * Removes a matching listener.
+ * @param {string|!goog.events.EventId} type The listener event type.
+ * @param {!Function} listener This listener callback method.
+ * @param {boolean=} opt_useCapture The capture mode of the listener.
+ * @param {Object=} opt_listenerScope Object in whose scope to call the
+ *     listener.
+ * @return {boolean} Whether any listener was removed.
+ */
+goog.events.ListenerMap.prototype.remove = function(
+    type, listener, opt_useCapture, opt_listenerScope) {
+  var typeStr = type.toString();
+  if (!(typeStr in this.listeners)) {
+    return false;
+  }
+
+  var listenerArray = this.listeners[typeStr];
+  var index = goog.events.ListenerMap.findListenerIndex_(
+      listenerArray, listener, opt_useCapture, opt_listenerScope);
+  if (index > -1) {
+    var listenerObj = listenerArray[index];
+    listenerObj.markAsRemoved();
+    goog.array.removeAt(listenerArray, index);
+    if (listenerArray.length == 0) {
+      delete this.listeners[typeStr];
+      this.typeCount_--;
+    }
+    return true;
+  }
+  return false;
+};
+
+
+/**
+ * Removes the given listener object.
+ * @param {goog.events.ListenableKey} listener The listener to remove.
+ * @return {boolean} Whether the listener is removed.
+ */
+goog.events.ListenerMap.prototype.removeByKey = function(listener) {
+  var type = listener.type;
+  if (!(type in this.listeners)) {
+    return false;
+  }
+
+  var removed = goog.array.remove(this.listeners[type], listener);
+  if (removed) {
+    listener.markAsRemoved();
+    if (this.listeners[type].length == 0) {
+      delete this.listeners[type];
+      this.typeCount_--;
+    }
+  }
+  return removed;
+};
+
+
+/**
+ * Removes all listeners from this map. If opt_type is provided, only
+ * listeners that match the given type are removed.
+ * @param {string|!goog.events.EventId=} opt_type Type of event to remove.
+ * @return {number} Number of listeners removed.
+ */
+goog.events.ListenerMap.prototype.removeAll = function(opt_type) {
+  var typeStr = opt_type && opt_type.toString();
+  var count = 0;
+  for (var type in this.listeners) {
+    if (!typeStr || type == typeStr) {
+      var listenerArray = this.listeners[type];
+      for (var i = 0; i < listenerArray.length; i++) {
+        ++count;
+        listenerArray[i].markAsRemoved();
+      }
+      delete this.listeners[type];
+      this.typeCount_--;
+    }
+  }
+  return count;
+};
+
+
+/**
+ * Gets all listeners that match the given type and capture mode. The
+ * returned array is a copy (but the listener objects are not).
+ * @param {string|!goog.events.EventId} type The type of the listeners
+ *     to retrieve.
+ * @param {boolean} capture The capture mode of the listeners to retrieve.
+ * @return {!Array<goog.events.ListenableKey>} An array of matching
+ *     listeners.
+ */
+goog.events.ListenerMap.prototype.getListeners = function(type, capture) {
+  var listenerArray = this.listeners[type.toString()];
+  var rv = [];
+  if (listenerArray) {
+    for (var i = 0; i < listenerArray.length; ++i) {
+      var listenerObj = listenerArray[i];
+      if (listenerObj.capture == capture) {
+        rv.push(listenerObj);
+      }
+    }
+  }
+  return rv;
+};
+
+
+/**
+ * Gets the goog.events.ListenableKey for the event or null if no such
+ * listener is in use.
+ *
+ * @param {string|!goog.events.EventId} type The type of the listener
+ *     to retrieve.
+ * @param {!Function} listener The listener function to get.
+ * @param {boolean} capture Whether the listener is a capturing listener.
+ * @param {Object=} opt_listenerScope Object in whose scope to call the
+ *     listener.
+ * @return {goog.events.ListenableKey} the found listener or null if not found.
+ */
+goog.events.ListenerMap.prototype.getListener = function(
+    type, listener, capture, opt_listenerScope) {
+  var listenerArray = this.listeners[type.toString()];
+  var i = -1;
+  if (listenerArray) {
+    i = goog.events.ListenerMap.findListenerIndex_(
+        listenerArray, listener, capture, opt_listenerScope);
+  }
+  return i > -1 ? listenerArray[i] : null;
+};
+
+
+/**
+ * Whether there is a matching listener. If either the type or capture
+ * parameters are unspecified, the function will match on the
+ * remaining criteria.
+ *
+ * @param {string|!goog.events.EventId=} opt_type The type of the listener.
+ * @param {boolean=} opt_capture The capture mode of the listener.
+ * @return {boolean} Whether there is an active listener matching
+ *     the requested type and/or capture phase.
+ */
+goog.events.ListenerMap.prototype.hasListener = function(
+    opt_type, opt_capture) {
+  var hasType = goog.isDef(opt_type);
+  var typeStr = hasType ? opt_type.toString() : '';
+  var hasCapture = goog.isDef(opt_capture);
+
+  return goog.object.some(
+      this.listeners, function(listenerArray, type) {
+        for (var i = 0; i < listenerArray.length; ++i) {
+          if ((!hasType || listenerArray[i].type == typeStr) &&
+              (!hasCapture || listenerArray[i].capture == opt_capture)) {
+            return true;
+          }
+        }
+
+        return false;
+      });
+};
+
+
+/**
+ * Finds the index of a matching goog.events.Listener in the given
+ * listenerArray.
+ * @param {!Array<!goog.events.Listener>} listenerArray Array of listener.
+ * @param {!Function} listener The listener function.
+ * @param {boolean=} opt_useCapture The capture flag for the listener.
+ * @param {Object=} opt_listenerScope The listener scope.
+ * @return {number} The index of the matching listener within the
+ *     listenerArray.
+ * @private
+ */
+goog.events.ListenerMap.findListenerIndex_ = function(
+    listenerArray, listener, opt_useCapture, opt_listenerScope) {
+  for (var i = 0; i < listenerArray.length; ++i) {
+    var listenerObj = listenerArray[i];
+    if (!listenerObj.removed &&
+        listenerObj.listener == listener &&
+        listenerObj.capture == !!opt_useCapture &&
+        listenerObj.handler == opt_listenerScope) {
+      return i;
+    }
+  }
+  return -1;
+};
diff --git a/lib/goog/fs/url.js b/lib/goog/fs/url.js
new file mode 100644
index 0000000..7cc3ee2
--- /dev/null
+++ b/lib/goog/fs/url.js
@@ -0,0 +1,109 @@
+// Copyright 2015 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Wrapper for URL and its createObjectUrl and revokeObjectUrl
+ * methods that are part of the HTML5 File API.
+ */
+
+goog.provide('goog.fs.url');
+
+
+/**
+ * Creates a blob URL for a blob object.
+ * Throws an error if the browser does not support Object Urls.
+ *
+ * @param {!Blob} blob The object for which to create the URL.
+ * @return {string} The URL for the object.
+ */
+goog.fs.url.createObjectUrl = function(blob) {
+  return goog.fs.url.getUrlObject_().createObjectURL(blob);
+};
+
+
+/**
+ * Revokes a URL created by {@link goog.fs.url.createObjectUrl}.
+ * Throws an error if the browser does not support Object Urls.
+ *
+ * @param {string} url The URL to revoke.
+ */
+goog.fs.url.revokeObjectUrl = function(url) {
+  goog.fs.url.getUrlObject_().revokeObjectURL(url);
+};
+
+
+/**
+ * @typedef {{createObjectURL: (function(!Blob): string),
+ *            revokeObjectURL: function(string): void}}
+ */
+goog.fs.url.UrlObject_;
+
+
+/**
+ * Get the object that has the createObjectURL and revokeObjectURL functions for
+ * this browser.
+ *
+ * @return {goog.fs.url.UrlObject_} The object for this browser.
+ * @private
+ */
+goog.fs.url.getUrlObject_ = function() {
+  var urlObject = goog.fs.url.findUrlObject_();
+  if (urlObject != null) {
+    return urlObject;
+  } else {
+    throw Error('This browser doesn\'t seem to support blob URLs');
+  }
+};
+
+
+/**
+ * Finds the object that has the createObjectURL and revokeObjectURL functions
+ * for this browser.
+ *
+ * @return {?goog.fs.url.UrlObject_} The object for this browser or null if the
+ *     browser does not support Object Urls.
+ * @suppress {unnecessaryCasts} Depending on how the code is compiled, casting
+ *     goog.global to UrlObject_ may result in unnecessary cast warning.
+ *     However, the cast cannot be removed because with different set of
+ *     compiler flags, the cast is indeed necessary.  As such, silencing it.
+ * @private
+ */
+goog.fs.url.findUrlObject_ = function() {
+  // This is what the spec says to do
+  // http://dev.w3.org/2006/webapi/FileAPI/#dfn-createObjectURL
+  if (goog.isDef(goog.global.URL) &&
+      goog.isDef(goog.global.URL.createObjectURL)) {
+    return /** @type {goog.fs.url.UrlObject_} */ (goog.global.URL);
+  // This is what Chrome does (as of 10.0.648.6 dev)
+  } else if (goog.isDef(goog.global.webkitURL) &&
+             goog.isDef(goog.global.webkitURL.createObjectURL)) {
+    return /** @type {goog.fs.url.UrlObject_} */ (goog.global.webkitURL);
+  // This is what the spec used to say to do
+  } else if (goog.isDef(goog.global.createObjectURL)) {
+    return /** @type {goog.fs.url.UrlObject_} */ (goog.global);
+  } else {
+    return null;
+  }
+};
+
+
+/**
+ * Checks whether this browser supports Object Urls. If not, calls to
+ * createObjectUrl and revokeObjectUrl will result in an error.
+ *
+ * @return {boolean} True if this browser supports Object Urls.
+ */
+goog.fs.url.browserSupportsObjectUrls = function() {
+  return goog.fs.url.findUrlObject_() != null;
+};
diff --git a/lib/goog/functions/functions.js b/lib/goog/functions/functions.js
new file mode 100644
index 0000000..f4ee8ec
--- /dev/null
+++ b/lib/goog/functions/functions.js
@@ -0,0 +1,442 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Utilities for creating functions. Loosely inspired by the
+ * java classes: http://goo.gl/GM0Hmu and http://goo.gl/6k7nI8.
+ *
+ * @author nicksantos@google.com (Nick Santos)
+ */
+
+
+goog.provide('goog.functions');
+
+
+/**
+ * Creates a function that always returns the same value.
+ * @param {T} retValue The value to return.
+ * @return {function():T} The new function.
+ * @template T
+ */
+goog.functions.constant = function(retValue) {
+  return function() {
+    return retValue;
+  };
+};
+
+
+/**
+ * Always returns false.
+ * @type {function(...): boolean}
+ */
+goog.functions.FALSE = goog.functions.constant(false);
+
+
+/**
+ * Always returns true.
+ * @type {function(...): boolean}
+ */
+goog.functions.TRUE = goog.functions.constant(true);
+
+
+/**
+ * Always returns NULL.
+ * @type {function(...): null}
+ */
+goog.functions.NULL = goog.functions.constant(null);
+
+
+/**
+ * A simple function that returns the first argument of whatever is passed
+ * into it.
+ * @param {T=} opt_returnValue The single value that will be returned.
+ * @param {...*} var_args Optional trailing arguments. These are ignored.
+ * @return {T} The first argument passed in, or undefined if nothing was passed.
+ * @template T
+ */
+goog.functions.identity = function(opt_returnValue, var_args) {
+  return opt_returnValue;
+};
+
+
+/**
+ * Creates a function that always throws an error with the given message.
+ * @param {string} message The error message.
+ * @return {!Function} The error-throwing function.
+ */
+goog.functions.error = function(message) {
+  return function() {
+    throw Error(message);
+  };
+};
+
+
+/**
+ * Creates a function that throws the given object.
+ * @param {*} err An object to be thrown.
+ * @return {!Function} The error-throwing function.
+ */
+goog.functions.fail = function(err) {
+  return function() {
+    throw err;
+  }
+};
+
+
+/**
+ * Given a function, create a function that keeps opt_numArgs arguments and
+ * silently discards all additional arguments.
+ * @param {Function} f The original function.
+ * @param {number=} opt_numArgs The number of arguments to keep. Defaults to 0.
+ * @return {!Function} A version of f that only keeps the first opt_numArgs
+ *     arguments.
+ */
+goog.functions.lock = function(f, opt_numArgs) {
+  opt_numArgs = opt_numArgs || 0;
+  return function() {
+    return f.apply(this, Array.prototype.slice.call(arguments, 0, opt_numArgs));
+  };
+};
+
+
+/**
+ * Creates a function that returns its nth argument.
+ * @param {number} n The position of the return argument.
+ * @return {!Function} A new function.
+ */
+goog.functions.nth = function(n) {
+  return function() {
+    return arguments[n];
+  };
+};
+
+
+/**
+ * Given a function, create a new function that swallows its return value
+ * and replaces it with a new one.
+ * @param {Function} f A function.
+ * @param {T} retValue A new return value.
+ * @return {function(...?):T} A new function.
+ * @template T
+ */
+goog.functions.withReturnValue = function(f, retValue) {
+  return goog.functions.sequence(f, goog.functions.constant(retValue));
+};
+
+
+/**
+ * Creates a function that returns whether its arguement equals the given value.
+ *
+ * Example:
+ * var key = goog.object.findKey(obj, goog.functions.equalTo('needle'));
+ *
+ * @param {*} value The value to compare to.
+ * @param {boolean=} opt_useLooseComparison Whether to use a loose (==)
+ *     comparison rather than a strict (===) one. Defaults to false.
+ * @return {function(*):boolean} The new function.
+ */
+goog.functions.equalTo = function(value, opt_useLooseComparison) {
+  return function(other) {
+    return opt_useLooseComparison ? (value == other) : (value === other);
+  };
+};
+
+
+/**
+ * Creates the composition of the functions passed in.
+ * For example, (goog.functions.compose(f, g))(a) is equivalent to f(g(a)).
+ * @param {function(...?):T} fn The final function.
+ * @param {...Function} var_args A list of functions.
+ * @return {function(...?):T} The composition of all inputs.
+ * @template T
+ */
+goog.functions.compose = function(fn, var_args) {
+  var functions = arguments;
+  var length = functions.length;
+  return function() {
+    var result;
+    if (length) {
+      result = functions[length - 1].apply(this, arguments);
+    }
+
+    for (var i = length - 2; i >= 0; i--) {
+      result = functions[i].call(this, result);
+    }
+    return result;
+  };
+};
+
+
+/**
+ * Creates a function that calls the functions passed in in sequence, and
+ * returns the value of the last function. For example,
+ * (goog.functions.sequence(f, g))(x) is equivalent to f(x),g(x).
+ * @param {...Function} var_args A list of functions.
+ * @return {!Function} A function that calls all inputs in sequence.
+ */
+goog.functions.sequence = function(var_args) {
+  var functions = arguments;
+  var length = functions.length;
+  return function() {
+    var result;
+    for (var i = 0; i < length; i++) {
+      result = functions[i].apply(this, arguments);
+    }
+    return result;
+  };
+};
+
+
+/**
+ * Creates a function that returns true if each of its components evaluates
+ * to true. The components are evaluated in order, and the evaluation will be
+ * short-circuited as soon as a function returns false.
+ * For example, (goog.functions.and(f, g))(x) is equivalent to f(x) && g(x).
+ * @param {...Function} var_args A list of functions.
+ * @return {function(...?):boolean} A function that ANDs its component
+ *      functions.
+ */
+goog.functions.and = function(var_args) {
+  var functions = arguments;
+  var length = functions.length;
+  return function() {
+    for (var i = 0; i < length; i++) {
+      if (!functions[i].apply(this, arguments)) {
+        return false;
+      }
+    }
+    return true;
+  };
+};
+
+
+/**
+ * Creates a function that returns true if any of its components evaluates
+ * to true. The components are evaluated in order, and the evaluation will be
+ * short-circuited as soon as a function returns true.
+ * For example, (goog.functions.or(f, g))(x) is equivalent to f(x) || g(x).
+ * @param {...Function} var_args A list of functions.
+ * @return {function(...?):boolean} A function that ORs its component
+ *    functions.
+ */
+goog.functions.or = function(var_args) {
+  var functions = arguments;
+  var length = functions.length;
+  return function() {
+    for (var i = 0; i < length; i++) {
+      if (functions[i].apply(this, arguments)) {
+        return true;
+      }
+    }
+    return false;
+  };
+};
+
+
+/**
+ * Creates a function that returns the Boolean opposite of a provided function.
+ * For example, (goog.functions.not(f))(x) is equivalent to !f(x).
+ * @param {!Function} f The original function.
+ * @return {function(...?):boolean} A function that delegates to f and returns
+ * opposite.
+ */
+goog.functions.not = function(f) {
+  return function() {
+    return !f.apply(this, arguments);
+  };
+};
+
+
+/**
+ * Generic factory function to construct an object given the constructor
+ * and the arguments. Intended to be bound to create object factories.
+ *
+ * Example:
+ *
+ * var factory = goog.partial(goog.functions.create, Class);
+ *
+ * @param {function(new:T, ...)} constructor The constructor for the Object.
+ * @param {...*} var_args The arguments to be passed to the constructor.
+ * @return {T} A new instance of the class given in {@code constructor}.
+ * @template T
+ */
+goog.functions.create = function(constructor, var_args) {
+  /**
+   * @constructor
+   * @final
+   */
+  var temp = function() {};
+  temp.prototype = constructor.prototype;
+
+  // obj will have constructor's prototype in its chain and
+  // 'obj instanceof constructor' will be true.
+  var obj = new temp();
+
+  // obj is initialized by constructor.
+  // arguments is only array-like so lacks shift(), but can be used with
+  // the Array prototype function.
+  constructor.apply(obj, Array.prototype.slice.call(arguments, 1));
+  return obj;
+};
+
+
+/**
+ * @define {boolean} Whether the return value cache should be used.
+ *    This should only be used to disable caches when testing.
+ */
+goog.define('goog.functions.CACHE_RETURN_VALUE', true);
+
+
+/**
+ * Gives a wrapper function that caches the return value of a parameterless
+ * function when first called.
+ *
+ * When called for the first time, the given function is called and its
+ * return value is cached (thus this is only appropriate for idempotent
+ * functions).  Subsequent calls will return the cached return value. This
+ * allows the evaluation of expensive functions to be delayed until first used.
+ *
+ * To cache the return values of functions with parameters, see goog.memoize.
+ *
+ * @param {!function():T} fn A function to lazily evaluate.
+ * @return {!function():T} A wrapped version the function.
+ * @template T
+ */
+goog.functions.cacheReturnValue = function(fn) {
+  var called = false;
+  var value;
+
+  return function() {
+    if (!goog.functions.CACHE_RETURN_VALUE) {
+      return fn();
+    }
+
+    if (!called) {
+      value = fn();
+      called = true;
+    }
+
+    return value;
+  }
+};
+
+
+/**
+ * Wraps a function to allow it to be called, at most, once. All
+ * additional calls are no-ops.
+ *
+ * This is particularly useful for initialization functions
+ * that should be called, at most, once.
+ *
+ * @param {function():*} f Function to call.
+ * @return {function():undefined} Wrapped function.
+ */
+goog.functions.once = function(f) {
+  // Keep a reference to the function that we null out when we're done with
+  // it -- that way, the function can be GC'd when we're done with it.
+  var inner = f;
+  return function() {
+    if (inner) {
+      var tmp = inner;
+      inner = null;
+      tmp();
+    }
+  };
+};
+
+
+/**
+ * Wraps a function to allow it to be called, at most, once for each sequence of
+ * calls fired repeatedly so long as they are fired less than a specified
+ * interval apart (in milliseconds). Whether it receives one signal or multiple,
+ * it will always wait until a full interval has elapsed since the last signal
+ * before performing the action, passing the arguments from the last call of the
+ * debouncing decorator into the decorated function.
+ *
+ * This is particularly useful for bulking up repeated user actions (e.g. only
+ * refreshing a view once a user finishes typing rather than updating with every
+ * keystroke). For more stateful debouncing with support for pausing, resuming,
+ * and canceling debounced actions, use {@code goog.async.Debouncer}.
+ *
+ * @param {function(this:SCOPE, ...?)} f Function to call.
+ * @param {number} interval Interval over which to debounce. The function will
+ *     only be called after the full interval has elapsed since the last call.
+ * @param {SCOPE=} opt_scope Object in whose scope to call the function.
+ * @return {function(...?): undefined} Wrapped function.
+ * @template SCOPE
+ */
+goog.functions.debounce = function(f, interval, opt_scope) {
+  if (opt_scope) {
+    f = goog.bind(f, opt_scope);
+  }
+  var timeout = null;
+  return /** @type {function(...?)} */ (function(var_args) {
+    goog.global.clearTimeout(timeout);
+    var args = arguments;
+    timeout = goog.global.setTimeout(function() {
+      f.apply(null, args);
+    }, interval);
+  });
+};
+
+
+/**
+ * Wraps a function to allow it to be called, at most, once per interval
+ * (specified in milliseconds). If it is called multiple times while it is
+ * waiting, it will only perform the action once at the end of the interval,
+ * passing the arguments from the last call of the throttling decorator into the
+ * decorated function.
+ *
+ * This is particularly useful for limiting repeated user requests (e.g.
+ * preventing a user from spamming a server with frequent view refreshes). For
+ * more stateful throttling with support for pausing, resuming, and canceling
+ * throttled actions, use {@code goog.async.Throttle}.
+ *
+ * @param {function(this:SCOPE, ...?)} f Function to call.
+ * @param {number} interval Interval over which to throttle. The function can
+ *     only be called once per interval.
+ * @param {SCOPE=} opt_scope Object in whose scope to call the function.
+ * @return {function(...?): undefined} Wrapped function.
+ * @template SCOPE
+ */
+goog.functions.throttle = function(f, interval, opt_scope) {
+  if (opt_scope) {
+    f = goog.bind(f, opt_scope);
+  }
+  var timeout = null;
+  var shouldFire = false;
+  var args = [];
+
+  var handleTimeout = function() {
+    timeout = null;
+    if (shouldFire) {
+      shouldFire = false;
+      fire();
+    }
+  };
+
+  var fire = function() {
+    timeout = goog.global.setTimeout(handleTimeout, interval);
+    f.apply(null, args);
+  };
+
+  return /** @type {function(...?)} */ (function(var_args) {
+    args = arguments;
+    if (!timeout) {
+      fire();
+    } else {
+      shouldFire = true;
+    }
+  });
+};
diff --git a/lib/goog/html/safehtml.js b/lib/goog/html/safehtml.js
new file mode 100644
index 0000000..a0620e7
--- /dev/null
+++ b/lib/goog/html/safehtml.js
@@ -0,0 +1,757 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+
+/**
+ * @fileoverview The SafeHtml type and its builders.
+ *
+ * TODO(xtof): Link to document stating type contract.
+ */
+
+goog.provide('goog.html.SafeHtml');
+
+goog.require('goog.array');
+goog.require('goog.asserts');
+goog.require('goog.dom.TagName');
+goog.require('goog.dom.tags');
+goog.require('goog.html.SafeStyle');
+goog.require('goog.html.SafeStyleSheet');
+goog.require('goog.html.SafeUrl');
+goog.require('goog.html.TrustedResourceUrl');
+goog.require('goog.i18n.bidi.Dir');
+goog.require('goog.i18n.bidi.DirectionalString');
+goog.require('goog.object');
+goog.require('goog.string');
+goog.require('goog.string.Const');
+goog.require('goog.string.TypedString');
+
+
+
+/**
+ * A string that is safe to use in HTML context in DOM APIs and HTML documents.
+ *
+ * A SafeHtml is a string-like object that carries the security type contract
+ * that its value as a string will not cause untrusted script execution when
+ * evaluated as HTML in a browser.
+ *
+ * Values of this type are guaranteed to be safe to use in HTML contexts,
+ * such as, assignment to the innerHTML DOM property, or interpolation into
+ * a HTML template in HTML PC_DATA context, in the sense that the use will not
+ * result in a Cross-Site-Scripting vulnerability.
+ *
+ * Instances of this type must be created via the factory methods
+ * ({@code goog.html.SafeHtml.create}, {@code goog.html.SafeHtml.htmlEscape}),
+ * etc and not by invoking its constructor.  The constructor intentionally
+ * takes no parameters and the type is immutable; hence only a default instance
+ * corresponding to the empty string can be obtained via constructor invocation.
+ *
+ * @see goog.html.SafeHtml#create
+ * @see goog.html.SafeHtml#htmlEscape
+ * @constructor
+ * @final
+ * @struct
+ * @implements {goog.i18n.bidi.DirectionalString}
+ * @implements {goog.string.TypedString}
+ */
+goog.html.SafeHtml = function() {
+  /**
+   * The contained value of this SafeHtml.  The field has a purposely ugly
+   * name to make (non-compiled) code that attempts to directly access this
+   * field stand out.
+   * @private {string}
+   */
+  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = '';
+
+  /**
+   * A type marker used to implement additional run-time type checking.
+   * @see goog.html.SafeHtml#unwrap
+   * @const
+   * @private
+   */
+  this.SAFE_HTML_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =
+      goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+
+  /**
+   * This SafeHtml's directionality, or null if unknown.
+   * @private {?goog.i18n.bidi.Dir}
+   */
+  this.dir_ = null;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.SafeHtml.prototype.implementsGoogI18nBidiDirectionalString = true;
+
+
+/** @override */
+goog.html.SafeHtml.prototype.getDirection = function() {
+  return this.dir_;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.SafeHtml.prototype.implementsGoogStringTypedString = true;
+
+
+/**
+ * Returns this SafeHtml's value a string.
+ *
+ * IMPORTANT: In code where it is security relevant that an object's type is
+ * indeed {@code SafeHtml}, use {@code goog.html.SafeHtml.unwrap} instead of
+ * this method. If in doubt, assume that it's security relevant. In particular,
+ * note that goog.html functions which return a goog.html type do not guarantee
+ * that the returned instance is of the right type. For example:
+ *
+ * <pre>
+ * var fakeSafeHtml = new String('fake');
+ * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;
+ * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);
+ * // newSafeHtml is just an alias for fakeSafeHtml, it's passed through by
+ * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml
+ * // instanceof goog.html.SafeHtml.
+ * </pre>
+ *
+ * @see goog.html.SafeHtml#unwrap
+ * @override
+ */
+goog.html.SafeHtml.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeHtmlWrappedValue_;
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a debug string-representation of this value.
+   *
+   * To obtain the actual string value wrapped in a SafeHtml, use
+   * {@code goog.html.SafeHtml.unwrap}.
+   *
+   * @see goog.html.SafeHtml#unwrap
+   * @override
+   */
+  goog.html.SafeHtml.prototype.toString = function() {
+    return 'SafeHtml{' + this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ +
+        '}';
+  };
+}
+
+
+/**
+ * Performs a runtime check that the provided object is indeed a SafeHtml
+ * object, and returns its value.
+ * @param {!goog.html.SafeHtml} safeHtml The object to extract from.
+ * @return {string} The SafeHtml object's contained string, unless the run-time
+ *     type check fails. In that case, {@code unwrap} returns an innocuous
+ *     string, or, if assertions are enabled, throws
+ *     {@code goog.asserts.AssertionError}.
+ */
+goog.html.SafeHtml.unwrap = function(safeHtml) {
+  // Perform additional run-time type-checking to ensure that safeHtml is indeed
+  // an instance of the expected type.  This provides some additional protection
+  // against security bugs due to application code that disables type checks.
+  // Specifically, the following checks are performed:
+  // 1. The object is an instance of the expected type.
+  // 2. The object is not an instance of a subclass.
+  // 3. The object carries a type marker for the expected type. "Faking" an
+  // object requires a reference to the type marker, which has names intended
+  // to stand out in code reviews.
+  if (safeHtml instanceof goog.html.SafeHtml &&
+      safeHtml.constructor === goog.html.SafeHtml &&
+      safeHtml.SAFE_HTML_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===
+          goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return safeHtml.privateDoNotAccessOrElseSafeHtmlWrappedValue_;
+  } else {
+    goog.asserts.fail('expected object of type SafeHtml, got \'' +
+                      safeHtml + '\'');
+    return 'type_error:SafeHtml';
+  }
+};
+
+
+/**
+ * Shorthand for union of types that can sensibly be converted to strings
+ * or might already be SafeHtml (as SafeHtml is a goog.string.TypedString).
+ * @private
+ * @typedef {string|number|boolean|!goog.string.TypedString|
+ *           !goog.i18n.bidi.DirectionalString}
+ */
+goog.html.SafeHtml.TextOrHtml_;
+
+
+/**
+ * Returns HTML-escaped text as a SafeHtml object.
+ *
+ * If text is of a type that implements
+ * {@code goog.i18n.bidi.DirectionalString}, the directionality of the new
+ * {@code SafeHtml} object is set to {@code text}'s directionality, if known.
+ * Otherwise, the directionality of the resulting SafeHtml is unknown (i.e.,
+ * {@code null}).
+ *
+ * @param {!goog.html.SafeHtml.TextOrHtml_} textOrHtml The text to escape. If
+ *     the parameter is of type SafeHtml it is returned directly (no escaping
+ *     is done).
+ * @return {!goog.html.SafeHtml} The escaped text, wrapped as a SafeHtml.
+ */
+goog.html.SafeHtml.htmlEscape = function(textOrHtml) {
+  if (textOrHtml instanceof goog.html.SafeHtml) {
+    return textOrHtml;
+  }
+  var dir = null;
+  if (textOrHtml.implementsGoogI18nBidiDirectionalString) {
+    dir = textOrHtml.getDirection();
+  }
+  var textAsString;
+  if (textOrHtml.implementsGoogStringTypedString) {
+    textAsString = textOrHtml.getTypedStringValue();
+  } else {
+    textAsString = String(textOrHtml);
+  }
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+      goog.string.htmlEscape(textAsString), dir);
+};
+
+
+/**
+ * Returns HTML-escaped text as a SafeHtml object, with newlines changed to
+ * &lt;br&gt;.
+ * @param {!goog.html.SafeHtml.TextOrHtml_} textOrHtml The text to escape. If
+ *     the parameter is of type SafeHtml it is returned directly (no escaping
+ *     is done).
+ * @return {!goog.html.SafeHtml} The escaped text, wrapped as a SafeHtml.
+ */
+goog.html.SafeHtml.htmlEscapePreservingNewlines = function(textOrHtml) {
+  if (textOrHtml instanceof goog.html.SafeHtml) {
+    return textOrHtml;
+  }
+  var html = goog.html.SafeHtml.htmlEscape(textOrHtml);
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+      goog.string.newLineToBr(goog.html.SafeHtml.unwrap(html)),
+      html.getDirection());
+};
+
+
+/**
+ * Returns HTML-escaped text as a SafeHtml object, with newlines changed to
+ * &lt;br&gt; and escaping whitespace to preserve spatial formatting. Character
+ * entity #160 is used to make it safer for XML.
+ * @param {!goog.html.SafeHtml.TextOrHtml_} textOrHtml The text to escape. If
+ *     the parameter is of type SafeHtml it is returned directly (no escaping
+ *     is done).
+ * @return {!goog.html.SafeHtml} The escaped text, wrapped as a SafeHtml.
+ */
+goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces = function(
+    textOrHtml) {
+  if (textOrHtml instanceof goog.html.SafeHtml) {
+    return textOrHtml;
+  }
+  var html = goog.html.SafeHtml.htmlEscape(textOrHtml);
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+      goog.string.whitespaceEscape(goog.html.SafeHtml.unwrap(html)),
+      html.getDirection());
+};
+
+
+/**
+ * Coerces an arbitrary object into a SafeHtml object.
+ *
+ * If {@code textOrHtml} is already of type {@code goog.html.SafeHtml}, the same
+ * object is returned. Otherwise, {@code textOrHtml} is coerced to string, and
+ * HTML-escaped. If {@code textOrHtml} is of a type that implements
+ * {@code goog.i18n.bidi.DirectionalString}, its directionality, if known, is
+ * preserved.
+ *
+ * @param {!goog.html.SafeHtml.TextOrHtml_} textOrHtml The text or SafeHtml to
+ *     coerce.
+ * @return {!goog.html.SafeHtml} The resulting SafeHtml object.
+ * @deprecated Use goog.html.SafeHtml.htmlEscape.
+ */
+goog.html.SafeHtml.from = goog.html.SafeHtml.htmlEscape;
+
+
+/**
+ * @const
+ * @private
+ */
+goog.html.SafeHtml.VALID_NAMES_IN_TAG_ = /^[a-zA-Z0-9-]+$/;
+
+
+/**
+ * Set of attributes containing URL as defined at
+ * http://www.w3.org/TR/html5/index.html#attributes-1.
+ * @private @const {!Object<string,boolean>}
+ */
+goog.html.SafeHtml.URL_ATTRIBUTES_ = goog.object.createSet('action', 'cite',
+    'data', 'formaction', 'href', 'manifest', 'poster', 'src');
+
+
+/**
+ * Tags which are unsupported via create(). They might be supported via a
+ * tag-specific create method. These are tags which might require a
+ * TrustedResourceUrl in one of their attributes or a restricted type for
+ * their content.
+ * @private @const {!Object<string,boolean>}
+ */
+goog.html.SafeHtml.NOT_ALLOWED_TAG_NAMES_ = goog.object.createSet(
+    goog.dom.TagName.EMBED, goog.dom.TagName.IFRAME, goog.dom.TagName.LINK,
+    goog.dom.TagName.OBJECT, goog.dom.TagName.SCRIPT, goog.dom.TagName.STYLE,
+    goog.dom.TagName.TEMPLATE);
+
+
+/**
+ * @typedef {string|number|goog.string.TypedString|
+ *     goog.html.SafeStyle.PropertyMap}
+ * @private
+ */
+goog.html.SafeHtml.AttributeValue_;
+
+
+/**
+ * Creates a SafeHtml content consisting of a tag with optional attributes and
+ * optional content.
+ *
+ * For convenience tag names and attribute names are accepted as regular
+ * strings, instead of goog.string.Const. Nevertheless, you should not pass
+ * user-controlled values to these parameters. Note that these parameters are
+ * syntactically validated at runtime, and invalid values will result in
+ * an exception.
+ *
+ * Example usage:
+ *
+ * goog.html.SafeHtml.create('br');
+ * goog.html.SafeHtml.create('div', {'class': 'a'});
+ * goog.html.SafeHtml.create('p', {}, 'a');
+ * goog.html.SafeHtml.create('p', {}, goog.html.SafeHtml.create('br'));
+ *
+ * goog.html.SafeHtml.create('span', {
+ *   'style': {'margin': '0'}
+ * });
+ *
+ * To guarantee SafeHtml's type contract is upheld there are restrictions on
+ * attribute values and tag names.
+ *
+ * - For attributes which contain script code (on*), a goog.string.Const is
+ *   required.
+ * - For attributes which contain style (style), a goog.html.SafeStyle or a
+ *   goog.html.SafeStyle.PropertyMap is required.
+ * - For attributes which are interpreted as URLs (e.g. src, href) a
+ *   goog.html.SafeUrl, goog.string.Const or string is required. If a string
+ *   is passed, it will be sanitized with SafeUrl.sanitize().
+ * - For tags which can load code, more specific goog.html.SafeHtml.create*()
+ *   functions must be used. Tags which can load code and are not supported by
+ *   this function are embed, iframe, link, object, script, style, and template.
+ *
+ * @param {string} tagName The name of the tag. Only tag names consisting of
+ *     [a-zA-Z0-9-] are allowed. Tag names documented above are disallowed.
+ * @param {!Object<string, goog.html.SafeHtml.AttributeValue_>=}
+ *     opt_attributes Mapping from attribute names to their values. Only
+ *     attribute names consisting of [a-zA-Z0-9-] are allowed. Value of null or
+ *     undefined causes the attribute to be omitted.
+ * @param {!goog.html.SafeHtml.TextOrHtml_|
+ *     !Array<!goog.html.SafeHtml.TextOrHtml_>=} opt_content Content to
+ *     HTML-escape and put inside the tag. This must be empty for void tags
+ *     like <br>. Array elements are concatenated.
+ * @return {!goog.html.SafeHtml} The SafeHtml content with the tag.
+ * @throws {Error} If invalid tag name, attribute name, or attribute value is
+ *     provided.
+ * @throws {goog.asserts.AssertionError} If content for void tag is provided.
+ */
+goog.html.SafeHtml.create = function(tagName, opt_attributes, opt_content) {
+  if (!goog.html.SafeHtml.VALID_NAMES_IN_TAG_.test(tagName)) {
+    throw Error('Invalid tag name <' + tagName + '>.');
+  }
+  if (tagName.toUpperCase() in goog.html.SafeHtml.NOT_ALLOWED_TAG_NAMES_) {
+    throw Error('Tag name <' + tagName + '> is not allowed for SafeHtml.');
+  }
+  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse(
+      tagName, opt_attributes, opt_content);
+};
+
+
+/**
+ * Creates a SafeHtml representing an iframe tag.
+ *
+ * By default the sandbox attribute is set to an empty value, which is the most
+ * secure option, as it confers the iframe the least privileges. If this
+ * is too restrictive then granting individual privileges is the preferable
+ * option. Unsetting the attribute entirely is the least secure option and
+ * should never be done unless it's stricly necessary.
+ *
+ * @param {goog.html.TrustedResourceUrl=} opt_src The value of the src
+ *     attribute. If null or undefined src will not be set.
+ * @param {goog.html.SafeHtml=} opt_srcdoc The value of the srcdoc attribute.
+ *     If null or undefined srcdoc will not be set.
+ * @param {!Object<string, goog.html.SafeHtml.AttributeValue_>=}
+ *     opt_attributes Mapping from attribute names to their values. Only
+ *     attribute names consisting of [a-zA-Z0-9-] are allowed. Value of null or
+ *     undefined causes the attribute to be omitted.
+ * @param {!goog.html.SafeHtml.TextOrHtml_|
+ *     !Array<!goog.html.SafeHtml.TextOrHtml_>=} opt_content Content to
+ *     HTML-escape and put inside the tag. Array elements are concatenated.
+ * @return {!goog.html.SafeHtml} The SafeHtml content with the tag.
+ * @throws {Error} If invalid tag name, attribute name, or attribute value is
+ *     provided. If opt_attributes contains the src or srcdoc attributes.
+ */
+goog.html.SafeHtml.createIframe = function(
+    opt_src, opt_srcdoc, opt_attributes, opt_content) {
+  var fixedAttributes = {};
+  fixedAttributes['src'] = opt_src || null;
+  fixedAttributes['srcdoc'] = opt_srcdoc || null;
+  var defaultAttributes = {'sandbox': ''};
+  var attributes = goog.html.SafeHtml.combineAttributes(
+      fixedAttributes, defaultAttributes, opt_attributes);
+  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse(
+      'iframe', attributes, opt_content);
+};
+
+
+/**
+ * Creates a SafeHtml representing a style tag. The type attribute is set
+ * to "text/css".
+ * @param {!goog.html.SafeStyleSheet|!Array<!goog.html.SafeStyleSheet>}
+ *     styleSheet Content to put inside the tag. Array elements are
+ *     concatenated.
+ * @param {!Object<string, goog.html.SafeHtml.AttributeValue_>=}
+ *     opt_attributes Mapping from attribute names to their values. Only
+ *     attribute names consisting of [a-zA-Z0-9-] are allowed. Value of null or
+ *     undefined causes the attribute to be omitted.
+ * @return {!goog.html.SafeHtml} The SafeHtml content with the tag.
+ * @throws {Error} If invalid attribute name or attribute value is provided. If
+ *     opt_attributes contains the type attribute.
+ */
+goog.html.SafeHtml.createStyle = function(styleSheet, opt_attributes) {
+  var fixedAttributes = {'type': 'text/css'};
+  var defaultAttributes = {};
+  var attributes = goog.html.SafeHtml.combineAttributes(
+      fixedAttributes, defaultAttributes, opt_attributes);
+
+  var content = '';
+  styleSheet = goog.array.concat(styleSheet);
+  for (var i = 0; i < styleSheet.length; i++) {
+    content += goog.html.SafeStyleSheet.unwrap(styleSheet[i]);
+  }
+  // Convert to SafeHtml so that it's not HTML-escaped.
+  var htmlContent = goog.html.SafeHtml
+      .createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+          content, goog.i18n.bidi.Dir.NEUTRAL);
+  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse(
+      'style', attributes, htmlContent);
+};
+
+
+/**
+ * @param {string} tagName The tag name.
+ * @param {string} name The attribute name.
+ * @param {!goog.html.SafeHtml.AttributeValue_} value The attribute value.
+ * @return {string} A "name=value" string.
+ * @throws {Error} If attribute value is unsafe for the given tag and attribute.
+ * @private
+ */
+goog.html.SafeHtml.getAttrNameAndValue_ = function(tagName, name, value) {
+  // If it's goog.string.Const, allow any valid attribute name.
+  if (value instanceof goog.string.Const) {
+    value = goog.string.Const.unwrap(value);
+  } else if (name.toLowerCase() == 'style') {
+    value = goog.html.SafeHtml.getStyleValue_(value);
+  } else if (/^on/i.test(name)) {
+    // TODO(jakubvrana): Disallow more attributes with a special meaning.
+    throw Error('Attribute "' + name +
+        '" requires goog.string.Const value, "' + value + '" given.');
+  // URL attributes handled differently accroding to tag.
+  } else if (name.toLowerCase() in goog.html.SafeHtml.URL_ATTRIBUTES_) {
+    if (value instanceof goog.html.TrustedResourceUrl) {
+      value = goog.html.TrustedResourceUrl.unwrap(value);
+    } else if (value instanceof goog.html.SafeUrl) {
+      value = goog.html.SafeUrl.unwrap(value);
+    } else if (goog.isString(value)) {
+      value = goog.html.SafeUrl.sanitize(value).getTypedStringValue();
+    } else {
+      throw Error('Attribute "' + name + '" on tag "' + tagName +
+          '" requires goog.html.SafeUrl, goog.string.Const, or string,' +
+          ' value "' + value + '" given.');
+    }
+  }
+
+  // Accept SafeUrl, TrustedResourceUrl, etc. for attributes which only require
+  // HTML-escaping.
+  if (value.implementsGoogStringTypedString) {
+    // Ok to call getTypedStringValue() since there's no reliance on the type
+    // contract for security here.
+    value = value.getTypedStringValue();
+  }
+
+  goog.asserts.assert(goog.isString(value) || goog.isNumber(value),
+      'String or number value expected, got ' +
+      (typeof value) + ' with value: ' + value);
+  return name + '="' + goog.string.htmlEscape(String(value)) + '"';
+};
+
+
+/**
+ * Gets value allowed in "style" attribute.
+ * @param {goog.html.SafeHtml.AttributeValue_} value It could be SafeStyle or a
+ *     map which will be passed to goog.html.SafeStyle.create.
+ * @return {string} Unwrapped value.
+ * @throws {Error} If string value is given.
+ * @private
+ */
+goog.html.SafeHtml.getStyleValue_ = function(value) {
+  if (!goog.isObject(value)) {
+    throw Error('The "style" attribute requires goog.html.SafeStyle or map ' +
+        'of style properties, ' + (typeof value) + ' given: ' + value);
+  }
+  if (!(value instanceof goog.html.SafeStyle)) {
+    // Process the property bag into a style object.
+    value = goog.html.SafeStyle.create(value);
+  }
+  return goog.html.SafeStyle.unwrap(value);
+};
+
+
+/**
+ * Creates a SafeHtml content with known directionality consisting of a tag with
+ * optional attributes and optional content.
+ * @param {!goog.i18n.bidi.Dir} dir Directionality.
+ * @param {string} tagName
+ * @param {!Object<string, goog.html.SafeHtml.AttributeValue_>=} opt_attributes
+ * @param {!goog.html.SafeHtml.TextOrHtml_|
+ *     !Array<!goog.html.SafeHtml.TextOrHtml_>=} opt_content
+ * @return {!goog.html.SafeHtml} The SafeHtml content with the tag.
+ */
+goog.html.SafeHtml.createWithDir = function(dir, tagName, opt_attributes,
+    opt_content) {
+  var html = goog.html.SafeHtml.create(tagName, opt_attributes, opt_content);
+  html.dir_ = dir;
+  return html;
+};
+
+
+/**
+ * Creates a new SafeHtml object by concatenating values.
+ * @param {...(!goog.html.SafeHtml.TextOrHtml_|
+ *     !Array<!goog.html.SafeHtml.TextOrHtml_>)} var_args Values to concatenate.
+ * @return {!goog.html.SafeHtml}
+ */
+goog.html.SafeHtml.concat = function(var_args) {
+  var dir = goog.i18n.bidi.Dir.NEUTRAL;
+  var content = '';
+
+  /**
+   * @param {!goog.html.SafeHtml.TextOrHtml_|
+   *     !Array<!goog.html.SafeHtml.TextOrHtml_>} argument
+   */
+  var addArgument = function(argument) {
+    if (goog.isArray(argument)) {
+      goog.array.forEach(argument, addArgument);
+    } else {
+      var html = goog.html.SafeHtml.htmlEscape(argument);
+      content += goog.html.SafeHtml.unwrap(html);
+      var htmlDir = html.getDirection();
+      if (dir == goog.i18n.bidi.Dir.NEUTRAL) {
+        dir = htmlDir;
+      } else if (htmlDir != goog.i18n.bidi.Dir.NEUTRAL && dir != htmlDir) {
+        dir = null;
+      }
+    }
+  };
+
+  goog.array.forEach(arguments, addArgument);
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+      content, dir);
+};
+
+
+/**
+ * Creates a new SafeHtml object with known directionality by concatenating the
+ * values.
+ * @param {!goog.i18n.bidi.Dir} dir Directionality.
+ * @param {...(!goog.html.SafeHtml.TextOrHtml_|
+ *     !Array<!goog.html.SafeHtml.TextOrHtml_>)} var_args Elements of array
+ *     arguments would be processed recursively.
+ * @return {!goog.html.SafeHtml}
+ */
+goog.html.SafeHtml.concatWithDir = function(dir, var_args) {
+  var html = goog.html.SafeHtml.concat(goog.array.slice(arguments, 1));
+  html.dir_ = dir;
+  return html;
+};
+
+
+/**
+ * Type marker for the SafeHtml type, used to implement additional run-time
+ * type checking.
+ * @const {!Object}
+ * @private
+ */
+goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+
+
+/**
+ * Package-internal utility method to create SafeHtml instances.
+ *
+ * @param {string} html The string to initialize the SafeHtml object with.
+ * @param {?goog.i18n.bidi.Dir} dir The directionality of the SafeHtml to be
+ *     constructed, or null if unknown.
+ * @return {!goog.html.SafeHtml} The initialized SafeHtml object.
+ * @package
+ */
+goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse = function(
+    html, dir) {
+  return new goog.html.SafeHtml().initSecurityPrivateDoNotAccessOrElse_(
+      html, dir);
+};
+
+
+/**
+ * Called from createSafeHtmlSecurityPrivateDoNotAccessOrElse(). This
+ * method exists only so that the compiler can dead code eliminate static
+ * fields (like EMPTY) when they're not accessed.
+ * @param {string} html
+ * @param {?goog.i18n.bidi.Dir} dir
+ * @return {!goog.html.SafeHtml}
+ * @private
+ */
+goog.html.SafeHtml.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(
+    html, dir) {
+  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = html;
+  this.dir_ = dir;
+  return this;
+};
+
+
+/**
+ * Like create() but does not restrict which tags can be constructed.
+ *
+ * @param {string} tagName Tag name. Set or validated by caller.
+ * @param {!Object<string, goog.html.SafeHtml.AttributeValue_>=} opt_attributes
+ * @param {(!goog.html.SafeHtml.TextOrHtml_|
+ *     !Array<!goog.html.SafeHtml.TextOrHtml_>)=} opt_content
+ * @return {!goog.html.SafeHtml}
+ * @throws {Error} If invalid or unsafe attribute name or value is provided.
+ * @throws {goog.asserts.AssertionError} If content for void tag is provided.
+ * @package
+ */
+goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse =
+    function(tagName, opt_attributes, opt_content) {
+  var dir = null;
+  var result = '<' + tagName;
+
+  if (opt_attributes) {
+    for (var name in opt_attributes) {
+      if (!goog.html.SafeHtml.VALID_NAMES_IN_TAG_.test(name)) {
+        throw Error('Invalid attribute name "' + name + '".');
+      }
+      var value = opt_attributes[name];
+      if (!goog.isDefAndNotNull(value)) {
+        continue;
+      }
+      result += ' ' +
+          goog.html.SafeHtml.getAttrNameAndValue_(tagName, name, value);
+    }
+  }
+
+  var content = opt_content;
+  if (!goog.isDefAndNotNull(content)) {
+    content = [];
+  } else if (!goog.isArray(content)) {
+    content = [content];
+  }
+
+  if (goog.dom.tags.isVoidTag(tagName.toLowerCase())) {
+    goog.asserts.assert(!content.length,
+        'Void tag <' + tagName + '> does not allow content.');
+    result += '>';
+  } else {
+    var html = goog.html.SafeHtml.concat(content);
+    result += '>' + goog.html.SafeHtml.unwrap(html) + '</' + tagName + '>';
+    dir = html.getDirection();
+  }
+
+  var dirAttribute = opt_attributes && opt_attributes['dir'];
+  if (dirAttribute) {
+    if (/^(ltr|rtl|auto)$/i.test(dirAttribute)) {
+      // If the tag has the "dir" attribute specified then its direction is
+      // neutral because it can be safely used in any context.
+      dir = goog.i18n.bidi.Dir.NEUTRAL;
+    } else {
+      dir = null;
+    }
+  }
+
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+      result, dir);
+};
+
+
+/**
+ * @param {!Object<string, string>} fixedAttributes
+ * @param {!Object<string, string>} defaultAttributes
+ * @param {!Object<string, goog.html.SafeHtml.AttributeValue_>=}
+ *     opt_attributes Optional attributes passed to create*().
+ * @return {!Object<string, goog.html.SafeHtml.AttributeValue_>}
+ * @throws {Error} If opt_attributes contains an attribute with the same name
+ *     as an attribute in fixedAttributes.
+ * @package
+ */
+goog.html.SafeHtml.combineAttributes = function(
+    fixedAttributes, defaultAttributes, opt_attributes) {
+  var combinedAttributes = {};
+  var name;
+
+  for (name in fixedAttributes) {
+    goog.asserts.assert(name.toLowerCase() == name, 'Must be lower case');
+    combinedAttributes[name] = fixedAttributes[name];
+  }
+  for (name in defaultAttributes) {
+    goog.asserts.assert(name.toLowerCase() == name, 'Must be lower case');
+    combinedAttributes[name] = defaultAttributes[name];
+  }
+
+  for (name in opt_attributes) {
+    var nameLower = name.toLowerCase();
+    if (nameLower in fixedAttributes) {
+      throw Error('Cannot override "' + nameLower + '" attribute, got "' +
+          name + '" with value "' + opt_attributes[name] + '"');
+    }
+    if (nameLower in defaultAttributes) {
+      delete combinedAttributes[nameLower];
+    }
+    combinedAttributes[name] = opt_attributes[name];
+  }
+
+  return combinedAttributes;
+};
+
+
+/**
+ * A SafeHtml instance corresponding to the HTML doctype: "<!DOCTYPE html>".
+ * @const {!goog.html.SafeHtml}
+ */
+goog.html.SafeHtml.DOCTYPE_HTML =
+    goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+        '<!DOCTYPE html>', goog.i18n.bidi.Dir.NEUTRAL);
+
+
+/**
+ * A SafeHtml instance corresponding to the empty string.
+ * @const {!goog.html.SafeHtml}
+ */
+goog.html.SafeHtml.EMPTY =
+    goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+        '', goog.i18n.bidi.Dir.NEUTRAL);
diff --git a/lib/goog/html/safescript.js b/lib/goog/html/safescript.js
new file mode 100644
index 0000000..0560cc6
--- /dev/null
+++ b/lib/goog/html/safescript.js
@@ -0,0 +1,234 @@
+// Copyright 2014 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview The SafeScript type and its builders.
+ *
+ * TODO(xtof): Link to document stating type contract.
+ */
+
+goog.provide('goog.html.SafeScript');
+
+goog.require('goog.asserts');
+goog.require('goog.string.Const');
+goog.require('goog.string.TypedString');
+
+
+
+/**
+ * A string-like object which represents JavaScript code and that carries the
+ * security type contract that its value, as a string, will not cause execution
+ * of unconstrained attacker controlled code (XSS) when evaluated as JavaScript
+ * in a browser.
+ *
+ * Instances of this type must be created via the factory method
+ * {@code goog.html.SafeScript.fromConstant} and not by invoking its
+ * constructor. The constructor intentionally takes no parameters and the type
+ * is immutable; hence only a default instance corresponding to the empty string
+ * can be obtained via constructor invocation.
+ *
+ * A SafeScript's string representation can safely be interpolated as the
+ * content of a script element within HTML. The SafeScript string should not be
+ * escaped before interpolation.
+ *
+ * Note that the SafeScript might contain text that is attacker-controlled but
+ * that text should have been interpolated with appropriate escaping,
+ * sanitization and/or validation into the right location in the script, such
+ * that it is highly constrained in its effect (for example, it had to match a
+ * set of whitelisted words).
+ *
+ * A SafeScript can be constructed via security-reviewed unchecked
+ * conversions. In this case producers of SafeScript must ensure themselves that
+ * the SafeScript does not contain unsafe script. Note in particular that
+ * {@code &lt;} is dangerous, even when inside JavaScript strings, and so should
+ * always be forbidden or JavaScript escaped in user controlled input. For
+ * example, if {@code &lt;/script&gt;&lt;script&gt;evil&lt;/script&gt;"} were
+ * interpolated inside a JavaScript string, it would break out of the context
+ * of the original script element and {@code evil} would execute. Also note
+ * that within an HTML script (raw text) element, HTML character references,
+ * such as "&lt;" are not allowed. See
+ * http://www.w3.org/TR/html5/scripting-1.html#restrictions-for-contents-of-script-elements.
+ *
+ * @see goog.html.SafeScript#fromConstant
+ * @constructor
+ * @final
+ * @struct
+ * @implements {goog.string.TypedString}
+ */
+goog.html.SafeScript = function() {
+  /**
+   * The contained value of this SafeScript.  The field has a purposely
+   * ugly name to make (non-compiled) code that attempts to directly access this
+   * field stand out.
+   * @private {string}
+   */
+  this.privateDoNotAccessOrElseSafeScriptWrappedValue_ = '';
+
+  /**
+   * A type marker used to implement additional run-time type checking.
+   * @see goog.html.SafeScript#unwrap
+   * @const
+   * @private
+   */
+  this.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =
+      goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.SafeScript.prototype.implementsGoogStringTypedString = true;
+
+
+/**
+ * Type marker for the SafeScript type, used to implement additional
+ * run-time type checking.
+ * @const {!Object}
+ * @private
+ */
+goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+
+
+/**
+ * Creates a SafeScript object from a compile-time constant string.
+ *
+ * @param {!goog.string.Const} script A compile-time-constant string from which
+ *     to create a SafeScript.
+ * @return {!goog.html.SafeScript} A SafeScript object initialized to
+ *     {@code script}.
+ */
+goog.html.SafeScript.fromConstant = function(script) {
+  var scriptString = goog.string.Const.unwrap(script);
+  if (scriptString.length === 0) {
+    return goog.html.SafeScript.EMPTY;
+  }
+  return goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(
+      scriptString);
+};
+
+
+/**
+ * Returns this SafeScript's value as a string.
+ *
+ * IMPORTANT: In code where it is security relevant that an object's type is
+ * indeed {@code SafeScript}, use {@code goog.html.SafeScript.unwrap} instead of
+ * this method. If in doubt, assume that it's security relevant. In particular,
+ * note that goog.html functions which return a goog.html type do not guarantee
+ * the returned instance is of the right type. For example:
+ *
+ * <pre>
+ * var fakeSafeHtml = new String('fake');
+ * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;
+ * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);
+ * // newSafeHtml is just an alias for fakeSafeHtml, it's passed through by
+ * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml
+ * // instanceof goog.html.SafeHtml.
+ * </pre>
+ *
+ * @see goog.html.SafeScript#unwrap
+ * @override
+ */
+goog.html.SafeScript.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeScriptWrappedValue_;
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a debug string-representation of this value.
+   *
+   * To obtain the actual string value wrapped in a SafeScript, use
+   * {@code goog.html.SafeScript.unwrap}.
+   *
+   * @see goog.html.SafeScript#unwrap
+   * @override
+   */
+  goog.html.SafeScript.prototype.toString = function() {
+    return 'SafeScript{' +
+        this.privateDoNotAccessOrElseSafeScriptWrappedValue_ + '}';
+  };
+}
+
+
+/**
+ * Performs a runtime check that the provided object is indeed a
+ * SafeScript object, and returns its value.
+ *
+ * @param {!goog.html.SafeScript} safeScript The object to extract from.
+ * @return {string} The safeScript object's contained string, unless
+ *     the run-time type check fails. In that case, {@code unwrap} returns an
+ *     innocuous string, or, if assertions are enabled, throws
+ *     {@code goog.asserts.AssertionError}.
+ */
+goog.html.SafeScript.unwrap = function(safeScript) {
+  // Perform additional Run-time type-checking to ensure that
+  // safeScript is indeed an instance of the expected type.  This
+  // provides some additional protection against security bugs due to
+  // application code that disables type checks.
+  // Specifically, the following checks are performed:
+  // 1. The object is an instance of the expected type.
+  // 2. The object is not an instance of a subclass.
+  // 3. The object carries a type marker for the expected type. "Faking" an
+  // object requires a reference to the type marker, which has names intended
+  // to stand out in code reviews.
+  if (safeScript instanceof goog.html.SafeScript &&
+      safeScript.constructor === goog.html.SafeScript &&
+      safeScript.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===
+          goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return safeScript.privateDoNotAccessOrElseSafeScriptWrappedValue_;
+  } else {
+    goog.asserts.fail(
+        'expected object of type SafeScript, got \'' + safeScript + '\'');
+    return 'type_error:SafeScript';
+  }
+};
+
+
+/**
+ * Package-internal utility method to create SafeScript instances.
+ *
+ * @param {string} script The string to initialize the SafeScript object with.
+ * @return {!goog.html.SafeScript} The initialized SafeScript object.
+ * @package
+ */
+goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse =
+    function(script) {
+  return new goog.html.SafeScript().initSecurityPrivateDoNotAccessOrElse_(
+      script);
+};
+
+
+/**
+ * Called from createSafeScriptSecurityPrivateDoNotAccessOrElse(). This
+ * method exists only so that the compiler can dead code eliminate static
+ * fields (like EMPTY) when they're not accessed.
+ * @param {string} script
+ * @return {!goog.html.SafeScript}
+ * @private
+ */
+goog.html.SafeScript.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(
+    script) {
+  this.privateDoNotAccessOrElseSafeScriptWrappedValue_ = script;
+  return this;
+};
+
+
+/**
+ * A SafeScript instance corresponding to the empty string.
+ * @const {!goog.html.SafeScript}
+ */
+goog.html.SafeScript.EMPTY =
+    goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse('');
diff --git a/lib/goog/html/safestyle.js b/lib/goog/html/safestyle.js
new file mode 100644
index 0000000..96e6dbb
--- /dev/null
+++ b/lib/goog/html/safestyle.js
@@ -0,0 +1,442 @@
+// Copyright 2014 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview The SafeStyle type and its builders.
+ *
+ * TODO(xtof): Link to document stating type contract.
+ */
+
+goog.provide('goog.html.SafeStyle');
+
+goog.require('goog.array');
+goog.require('goog.asserts');
+goog.require('goog.string');
+goog.require('goog.string.Const');
+goog.require('goog.string.TypedString');
+
+
+
+/**
+ * A string-like object which represents a sequence of CSS declarations
+ * ({@code propertyName1: propertyvalue1; propertyName2: propertyValue2; ...})
+ * and that carries the security type contract that its value, as a string,
+ * will not cause untrusted script execution (XSS) when evaluated as CSS in a
+ * browser.
+ *
+ * Instances of this type must be created via the factory methods
+ * ({@code goog.html.SafeStyle.create} or
+ * {@code goog.html.SafeStyle.fromConstant}) and not by invoking its
+ * constructor. The constructor intentionally takes no parameters and the type
+ * is immutable; hence only a default instance corresponding to the empty string
+ * can be obtained via constructor invocation.
+ *
+ * A SafeStyle's string representation ({@link #getTypedStringValue()}) can
+ * safely:
+ * <ul>
+ *   <li>Be interpolated as the entire content of a *quoted* HTML style
+ *       attribute, or before already existing properties. The SafeStyle string
+ *       *must be HTML-attribute-escaped* (where " and ' are escaped) before
+ *       interpolation.
+ *   <li>Be interpolated as the entire content of a {}-wrapped block within a
+ *       stylesheet, or before already existing properties. The SafeStyle string
+ *       should not be escaped before interpolation. SafeStyle's contract also
+ *       guarantees that the string will not be able to introduce new properties
+ *       or elide existing ones.
+ *   <li>Be assigned to the style property of a DOM node. The SafeStyle string
+ *       should not be escaped before being assigned to the property.
+ * </ul>
+ *
+ * A SafeStyle may never contain literal angle brackets. Otherwise, it could
+ * be unsafe to place a SafeStyle into a &lt;style&gt; tag (where it can't
+ * be HTML escaped). For example, if the SafeStyle containing
+ * "{@code font: 'foo &lt;style/&gt;&lt;script&gt;evil&lt;/script&gt;'}" were
+ * interpolated within a &lt;style&gt; tag, this would then break out of the
+ * style context into HTML.
+ *
+ * A SafeStyle may contain literal single or double quotes, and as such the
+ * entire style string must be escaped when used in a style attribute (if
+ * this were not the case, the string could contain a matching quote that
+ * would escape from the style attribute).
+ *
+ * Values of this type must be composable, i.e. for any two values
+ * {@code style1} and {@code style2} of this type,
+ * {@code goog.html.SafeStyle.unwrap(style1) +
+ * goog.html.SafeStyle.unwrap(style2)} must itself be a value that satisfies
+ * the SafeStyle type constraint. This requirement implies that for any value
+ * {@code style} of this type, {@code goog.html.SafeStyle.unwrap(style)} must
+ * not end in a "property value" or "property name" context. For example,
+ * a value of {@code background:url("} or {@code font-} would not satisfy the
+ * SafeStyle contract. This is because concatenating such strings with a
+ * second value that itself does not contain unsafe CSS can result in an
+ * overall string that does. For example, if {@code javascript:evil())"} is
+ * appended to {@code background:url("}, the resulting string may result in
+ * the execution of a malicious script.
+ *
+ * TODO(user): Consider whether we should implement UTF-8 interchange
+ * validity checks and blacklisting of newlines (including Unicode ones) and
+ * other whitespace characters (\t, \f). Document here if so and also update
+ * SafeStyle.fromConstant().
+ *
+ * The following example values comply with this type's contract:
+ * <ul>
+ *   <li><pre>width: 1em;</pre>
+ *   <li><pre>height:1em;</pre>
+ *   <li><pre>width: 1em;height: 1em;</pre>
+ *   <li><pre>background:url('http://url');</pre>
+ * </ul>
+ * In addition, the empty string is safe for use in a CSS attribute.
+ *
+ * The following example values do NOT comply with this type's contract:
+ * <ul>
+ *   <li><pre>background: red</pre> (missing a trailing semi-colon)
+ *   <li><pre>background:</pre> (missing a value and a trailing semi-colon)
+ *   <li><pre>1em</pre> (missing an attribute name, which provides context for
+ *       the value)
+ * </ul>
+ *
+ * @see goog.html.SafeStyle#create
+ * @see goog.html.SafeStyle#fromConstant
+ * @see http://www.w3.org/TR/css3-syntax/
+ * @constructor
+ * @final
+ * @struct
+ * @implements {goog.string.TypedString}
+ */
+goog.html.SafeStyle = function() {
+  /**
+   * The contained value of this SafeStyle.  The field has a purposely
+   * ugly name to make (non-compiled) code that attempts to directly access this
+   * field stand out.
+   * @private {string}
+   */
+  this.privateDoNotAccessOrElseSafeStyleWrappedValue_ = '';
+
+  /**
+   * A type marker used to implement additional run-time type checking.
+   * @see goog.html.SafeStyle#unwrap
+   * @const
+   * @private
+   */
+  this.SAFE_STYLE_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =
+      goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.SafeStyle.prototype.implementsGoogStringTypedString = true;
+
+
+/**
+ * Type marker for the SafeStyle type, used to implement additional
+ * run-time type checking.
+ * @const {!Object}
+ * @private
+ */
+goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+
+
+/**
+ * Creates a SafeStyle object from a compile-time constant string.
+ *
+ * {@code style} should be in the format
+ * {@code name: value; [name: value; ...]} and must not have any < or >
+ * characters in it. This is so that SafeStyle's contract is preserved,
+ * allowing the SafeStyle to correctly be interpreted as a sequence of CSS
+ * declarations and without affecting the syntactic structure of any
+ * surrounding CSS and HTML.
+ *
+ * This method performs basic sanity checks on the format of {@code style}
+ * but does not constrain the format of {@code name} and {@code value}, except
+ * for disallowing tag characters.
+ *
+ * @param {!goog.string.Const} style A compile-time-constant string from which
+ *     to create a SafeStyle.
+ * @return {!goog.html.SafeStyle} A SafeStyle object initialized to
+ *     {@code style}.
+ */
+goog.html.SafeStyle.fromConstant = function(style) {
+  var styleString = goog.string.Const.unwrap(style);
+  if (styleString.length === 0) {
+    return goog.html.SafeStyle.EMPTY;
+  }
+  goog.html.SafeStyle.checkStyle_(styleString);
+  goog.asserts.assert(goog.string.endsWith(styleString, ';'),
+      'Last character of style string is not \';\': ' + styleString);
+  goog.asserts.assert(goog.string.contains(styleString, ':'),
+      'Style string must contain at least one \':\', to ' +
+      'specify a "name: value" pair: ' + styleString);
+  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(
+      styleString);
+};
+
+
+/**
+ * Checks if the style definition is valid.
+ * @param {string} style
+ * @private
+ */
+goog.html.SafeStyle.checkStyle_ = function(style) {
+  goog.asserts.assert(!/[<>]/.test(style),
+      'Forbidden characters in style string: ' + style);
+};
+
+
+/**
+ * Returns this SafeStyle's value as a string.
+ *
+ * IMPORTANT: In code where it is security relevant that an object's type is
+ * indeed {@code SafeStyle}, use {@code goog.html.SafeStyle.unwrap} instead of
+ * this method. If in doubt, assume that it's security relevant. In particular,
+ * note that goog.html functions which return a goog.html type do not guarantee
+ * the returned instance is of the right type. For example:
+ *
+ * <pre>
+ * var fakeSafeHtml = new String('fake');
+ * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;
+ * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);
+ * // newSafeHtml is just an alias for fakeSafeHtml, it's passed through by
+ * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml
+ * // instanceof goog.html.SafeHtml.
+ * </pre>
+ *
+ * @see goog.html.SafeStyle#unwrap
+ * @override
+ */
+goog.html.SafeStyle.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeStyleWrappedValue_;
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a debug string-representation of this value.
+   *
+   * To obtain the actual string value wrapped in a SafeStyle, use
+   * {@code goog.html.SafeStyle.unwrap}.
+   *
+   * @see goog.html.SafeStyle#unwrap
+   * @override
+   */
+  goog.html.SafeStyle.prototype.toString = function() {
+    return 'SafeStyle{' +
+        this.privateDoNotAccessOrElseSafeStyleWrappedValue_ + '}';
+  };
+}
+
+
+/**
+ * Performs a runtime check that the provided object is indeed a
+ * SafeStyle object, and returns its value.
+ *
+ * @param {!goog.html.SafeStyle} safeStyle The object to extract from.
+ * @return {string} The safeStyle object's contained string, unless
+ *     the run-time type check fails. In that case, {@code unwrap} returns an
+ *     innocuous string, or, if assertions are enabled, throws
+ *     {@code goog.asserts.AssertionError}.
+ */
+goog.html.SafeStyle.unwrap = function(safeStyle) {
+  // Perform additional Run-time type-checking to ensure that
+  // safeStyle is indeed an instance of the expected type.  This
+  // provides some additional protection against security bugs due to
+  // application code that disables type checks.
+  // Specifically, the following checks are performed:
+  // 1. The object is an instance of the expected type.
+  // 2. The object is not an instance of a subclass.
+  // 3. The object carries a type marker for the expected type. "Faking" an
+  // object requires a reference to the type marker, which has names intended
+  // to stand out in code reviews.
+  if (safeStyle instanceof goog.html.SafeStyle &&
+      safeStyle.constructor === goog.html.SafeStyle &&
+      safeStyle.SAFE_STYLE_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===
+          goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return safeStyle.privateDoNotAccessOrElseSafeStyleWrappedValue_;
+  } else {
+    goog.asserts.fail(
+        'expected object of type SafeStyle, got \'' + safeStyle + '\'');
+    return 'type_error:SafeStyle';
+  }
+};
+
+
+/**
+ * Package-internal utility method to create SafeStyle instances.
+ *
+ * @param {string} style The string to initialize the SafeStyle object with.
+ * @return {!goog.html.SafeStyle} The initialized SafeStyle object.
+ * @package
+ */
+goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse =
+    function(style) {
+  return new goog.html.SafeStyle().initSecurityPrivateDoNotAccessOrElse_(style);
+};
+
+
+/**
+ * Called from createSafeStyleSecurityPrivateDoNotAccessOrElse(). This
+ * method exists only so that the compiler can dead code eliminate static
+ * fields (like EMPTY) when they're not accessed.
+ * @param {string} style
+ * @return {!goog.html.SafeStyle}
+ * @private
+ */
+goog.html.SafeStyle.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(
+    style) {
+  this.privateDoNotAccessOrElseSafeStyleWrappedValue_ = style;
+  return this;
+};
+
+
+/**
+ * A SafeStyle instance corresponding to the empty string.
+ * @const {!goog.html.SafeStyle}
+ */
+goog.html.SafeStyle.EMPTY =
+    goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse('');
+
+
+/**
+ * The innocuous string generated by goog.html.SafeUrl.create when passed
+ * an unsafe value.
+ * @const {string}
+ */
+goog.html.SafeStyle.INNOCUOUS_STRING = 'zClosurez';
+
+
+/**
+ * Mapping of property names to their values.
+ * @typedef {!Object<string, goog.string.Const|string>}
+ */
+goog.html.SafeStyle.PropertyMap;
+
+
+/**
+ * Creates a new SafeStyle object from the properties specified in the map.
+ * @param {goog.html.SafeStyle.PropertyMap} map Mapping of property names to
+ *     their values, for example {'margin': '1px'}. Names must consist of
+ *     [-_a-zA-Z0-9]. Values might be strings consisting of
+ *     [-,.'"%_!# a-zA-Z0-9], where " and ' must be properly balanced.
+ *     Other values must be wrapped in goog.string.Const. Null value causes
+ *     skipping the property.
+ * @return {!goog.html.SafeStyle}
+ * @throws {Error} If invalid name is provided.
+ * @throws {goog.asserts.AssertionError} If invalid value is provided. With
+ *     disabled assertions, invalid value is replaced by
+ *     goog.html.SafeStyle.INNOCUOUS_STRING.
+ */
+goog.html.SafeStyle.create = function(map) {
+  var style = '';
+  for (var name in map) {
+    if (!/^[-_a-zA-Z0-9]+$/.test(name)) {
+      throw Error('Name allows only [-_a-zA-Z0-9], got: ' + name);
+    }
+    var value = map[name];
+    if (value == null) {
+      continue;
+    }
+    if (value instanceof goog.string.Const) {
+      value = goog.string.Const.unwrap(value);
+      // These characters can be used to change context and we don't want that
+      // even with const values.
+      goog.asserts.assert(!/[{;}]/.test(value), 'Value does not allow [{;}].');
+    } else if (!goog.html.SafeStyle.VALUE_RE_.test(value)) {
+      goog.asserts.fail(
+          'String value allows only [-,."\'%_!# a-zA-Z0-9], got: ' + value);
+      value = goog.html.SafeStyle.INNOCUOUS_STRING;
+    } else if (!goog.html.SafeStyle.hasBalancedQuotes_(value)) {
+      goog.asserts.fail('String value requires balanced quotes, got: ' + value);
+      value = goog.html.SafeStyle.INNOCUOUS_STRING;
+    }
+    style += name + ':' + value + ';';
+  }
+  if (!style) {
+    return goog.html.SafeStyle.EMPTY;
+  }
+  goog.html.SafeStyle.checkStyle_(style);
+  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(
+      style);
+};
+
+
+/**
+ * Checks that quotes (" and ') are properly balanced inside a string. Assumes
+ * that neither escape (\) nor any other character that could result in
+ * breaking out of a string parsing context are allowed;
+ * see http://www.w3.org/TR/css3-syntax/#string-token-diagram.
+ * @param {string} value Untrusted CSS property value.
+ * @return {boolean} True if property value is safe with respect to quote
+ *     balancedness.
+ * @private
+ */
+goog.html.SafeStyle.hasBalancedQuotes_ = function(value) {
+  var outsideSingle = true;
+  var outsideDouble = true;
+  for (var i = 0; i < value.length; i++) {
+    var c = value.charAt(i);
+    if (c == "'" && outsideDouble) {
+      outsideSingle = !outsideSingle;
+    } else if (c == '"' && outsideSingle) {
+      outsideDouble = !outsideDouble;
+    }
+  }
+  return outsideSingle && outsideDouble;
+};
+
+
+// Keep in sync with the error string in create().
+/**
+ * Regular expression for safe values.
+ *
+ * Quotes (" and ') are allowed, but a check must be done elsewhere to ensure
+ * they're balanced.
+ *
+ * ',' allows multiple values to be assigned to the same property
+ * (e.g. background-attachment or font-family) and hence could allow
+ * multiple values to get injected, but that should pose no risk of XSS.
+ * @const {!RegExp}
+ * @private
+ */
+goog.html.SafeStyle.VALUE_RE_ = /^[-,."'%_!# a-zA-Z0-9]+$/;
+
+
+/**
+ * Creates a new SafeStyle object by concatenating the values.
+ * @param {...(!goog.html.SafeStyle|!Array<!goog.html.SafeStyle>)} var_args
+ *     SafeStyles to concatenate.
+ * @return {!goog.html.SafeStyle}
+ */
+goog.html.SafeStyle.concat = function(var_args) {
+  var style = '';
+
+  /**
+   * @param {!goog.html.SafeStyle|!Array<!goog.html.SafeStyle>} argument
+   */
+  var addArgument = function(argument) {
+    if (goog.isArray(argument)) {
+      goog.array.forEach(argument, addArgument);
+    } else {
+      style += goog.html.SafeStyle.unwrap(argument);
+    }
+  };
+
+  goog.array.forEach(arguments, addArgument);
+  if (!style) {
+    return goog.html.SafeStyle.EMPTY;
+  }
+  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(
+      style);
+};
diff --git a/lib/goog/html/safestylesheet.js b/lib/goog/html/safestylesheet.js
new file mode 100644
index 0000000..a50eb81
--- /dev/null
+++ b/lib/goog/html/safestylesheet.js
@@ -0,0 +1,276 @@
+// Copyright 2014 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview The SafeStyleSheet type and its builders.
+ *
+ * TODO(xtof): Link to document stating type contract.
+ */
+
+goog.provide('goog.html.SafeStyleSheet');
+
+goog.require('goog.array');
+goog.require('goog.asserts');
+goog.require('goog.string');
+goog.require('goog.string.Const');
+goog.require('goog.string.TypedString');
+
+
+
+/**
+ * A string-like object which represents a CSS style sheet and that carries the
+ * security type contract that its value, as a string, will not cause untrusted
+ * script execution (XSS) when evaluated as CSS in a browser.
+ *
+ * Instances of this type must be created via the factory method
+ * {@code goog.html.SafeStyleSheet.fromConstant} and not by invoking its
+ * constructor. The constructor intentionally takes no parameters and the type
+ * is immutable; hence only a default instance corresponding to the empty string
+ * can be obtained via constructor invocation.
+ *
+ * A SafeStyleSheet's string representation can safely be interpolated as the
+ * content of a style element within HTML. The SafeStyleSheet string should
+ * not be escaped before interpolation.
+ *
+ * Values of this type must be composable, i.e. for any two values
+ * {@code styleSheet1} and {@code styleSheet2} of this type,
+ * {@code goog.html.SafeStyleSheet.unwrap(styleSheet1) +
+ * goog.html.SafeStyleSheet.unwrap(styleSheet2)} must itself be a value that
+ * satisfies the SafeStyleSheet type constraint. This requirement implies that
+ * for any value {@code styleSheet} of this type,
+ * {@code goog.html.SafeStyleSheet.unwrap(styleSheet1)} must end in
+ * "beginning of rule" context.
+
+ * A SafeStyleSheet can be constructed via security-reviewed unchecked
+ * conversions. In this case producers of SafeStyleSheet must ensure themselves
+ * that the SafeStyleSheet does not contain unsafe script. Note in particular
+ * that {@code &lt;} is dangerous, even when inside CSS strings, and so should
+ * always be forbidden or CSS-escaped in user controlled input. For example, if
+ * {@code &lt;/style&gt;&lt;script&gt;evil&lt;/script&gt;"} were interpolated
+ * inside a CSS string, it would break out of the context of the original
+ * style element and {@code evil} would execute. Also note that within an HTML
+ * style (raw text) element, HTML character references, such as
+ * {@code &amp;lt;}, are not allowed. See
+ * http://www.w3.org/TR/html5/scripting-1.html#restrictions-for-contents-of-script-elements
+ * (similar considerations apply to the style element).
+ *
+ * @see goog.html.SafeStyleSheet#fromConstant
+ * @constructor
+ * @final
+ * @struct
+ * @implements {goog.string.TypedString}
+ */
+goog.html.SafeStyleSheet = function() {
+  /**
+   * The contained value of this SafeStyleSheet.  The field has a purposely
+   * ugly name to make (non-compiled) code that attempts to directly access this
+   * field stand out.
+   * @private {string}
+   */
+  this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ = '';
+
+  /**
+   * A type marker used to implement additional run-time type checking.
+   * @see goog.html.SafeStyleSheet#unwrap
+   * @const
+   * @private
+   */
+  this.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =
+      goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.SafeStyleSheet.prototype.implementsGoogStringTypedString = true;
+
+
+/**
+ * Type marker for the SafeStyleSheet type, used to implement additional
+ * run-time type checking.
+ * @const {!Object}
+ * @private
+ */
+goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+
+
+/**
+ * Creates a new SafeStyleSheet object by concatenating values.
+ * @param {...(!goog.html.SafeStyleSheet|!Array<!goog.html.SafeStyleSheet>)}
+ *     var_args Values to concatenate.
+ * @return {!goog.html.SafeStyleSheet}
+ */
+goog.html.SafeStyleSheet.concat = function(var_args) {
+  var result = '';
+
+  /**
+   * @param {!goog.html.SafeStyleSheet|!Array<!goog.html.SafeStyleSheet>}
+   *     argument
+   */
+  var addArgument = function(argument) {
+    if (goog.isArray(argument)) {
+      goog.array.forEach(argument, addArgument);
+    } else {
+      result += goog.html.SafeStyleSheet.unwrap(argument);
+    }
+  };
+
+  goog.array.forEach(arguments, addArgument);
+  return goog.html.SafeStyleSheet
+      .createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(result);
+};
+
+
+/**
+ * Creates a SafeStyleSheet object from a compile-time constant string.
+ *
+ * {@code styleSheet} must not have any &lt; characters in it, so that
+ * the syntactic structure of the surrounding HTML is not affected.
+ *
+ * @param {!goog.string.Const} styleSheet A compile-time-constant string from
+ *     which to create a SafeStyleSheet.
+ * @return {!goog.html.SafeStyleSheet} A SafeStyleSheet object initialized to
+ *     {@code styleSheet}.
+ */
+goog.html.SafeStyleSheet.fromConstant = function(styleSheet) {
+  var styleSheetString = goog.string.Const.unwrap(styleSheet);
+  if (styleSheetString.length === 0) {
+    return goog.html.SafeStyleSheet.EMPTY;
+  }
+  // > is a valid character in CSS selectors and there's no strict need to
+  // block it if we already block <.
+  goog.asserts.assert(!goog.string.contains(styleSheetString, '<'),
+      "Forbidden '<' character in style sheet string: " + styleSheetString);
+  return goog.html.SafeStyleSheet.
+      createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(styleSheetString);
+};
+
+
+/**
+ * Returns this SafeStyleSheet's value as a string.
+ *
+ * IMPORTANT: In code where it is security relevant that an object's type is
+ * indeed {@code SafeStyleSheet}, use {@code goog.html.SafeStyleSheet.unwrap}
+ * instead of this method. If in doubt, assume that it's security relevant. In
+ * particular, note that goog.html functions which return a goog.html type do
+ * not guarantee the returned instance is of the right type. For example:
+ *
+ * <pre>
+ * var fakeSafeHtml = new String('fake');
+ * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;
+ * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);
+ * // newSafeHtml is just an alias for fakeSafeHtml, it's passed through by
+ * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml
+ * // instanceof goog.html.SafeHtml.
+ * </pre>
+ *
+ * @see goog.html.SafeStyleSheet#unwrap
+ * @override
+ */
+goog.html.SafeStyleSheet.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_;
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a debug string-representation of this value.
+   *
+   * To obtain the actual string value wrapped in a SafeStyleSheet, use
+   * {@code goog.html.SafeStyleSheet.unwrap}.
+   *
+   * @see goog.html.SafeStyleSheet#unwrap
+   * @override
+   */
+  goog.html.SafeStyleSheet.prototype.toString = function() {
+    return 'SafeStyleSheet{' +
+        this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ + '}';
+  };
+}
+
+
+/**
+ * Performs a runtime check that the provided object is indeed a
+ * SafeStyleSheet object, and returns its value.
+ *
+ * @param {!goog.html.SafeStyleSheet} safeStyleSheet The object to extract from.
+ * @return {string} The safeStyleSheet object's contained string, unless
+ *     the run-time type check fails. In that case, {@code unwrap} returns an
+ *     innocuous string, or, if assertions are enabled, throws
+ *     {@code goog.asserts.AssertionError}.
+ */
+goog.html.SafeStyleSheet.unwrap = function(safeStyleSheet) {
+  // Perform additional Run-time type-checking to ensure that
+  // safeStyleSheet is indeed an instance of the expected type.  This
+  // provides some additional protection against security bugs due to
+  // application code that disables type checks.
+  // Specifically, the following checks are performed:
+  // 1. The object is an instance of the expected type.
+  // 2. The object is not an instance of a subclass.
+  // 3. The object carries a type marker for the expected type. "Faking" an
+  // object requires a reference to the type marker, which has names intended
+  // to stand out in code reviews.
+  if (safeStyleSheet instanceof goog.html.SafeStyleSheet &&
+      safeStyleSheet.constructor === goog.html.SafeStyleSheet &&
+      safeStyleSheet.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===
+          goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return safeStyleSheet.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_;
+  } else {
+    goog.asserts.fail(
+        "expected object of type SafeStyleSheet, got '" + safeStyleSheet +
+        "'");
+    return 'type_error:SafeStyleSheet';
+  }
+};
+
+
+/**
+ * Package-internal utility method to create SafeStyleSheet instances.
+ *
+ * @param {string} styleSheet The string to initialize the SafeStyleSheet
+ *     object with.
+ * @return {!goog.html.SafeStyleSheet} The initialized SafeStyleSheet object.
+ * @package
+ */
+goog.html.SafeStyleSheet.createSafeStyleSheetSecurityPrivateDoNotAccessOrElse =
+    function(styleSheet) {
+  return new goog.html.SafeStyleSheet().initSecurityPrivateDoNotAccessOrElse_(
+      styleSheet);
+};
+
+
+/**
+ * Called from createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(). This
+ * method exists only so that the compiler can dead code eliminate static
+ * fields (like EMPTY) when they're not accessed.
+ * @param {string} styleSheet
+ * @return {!goog.html.SafeStyleSheet}
+ * @private
+ */
+goog.html.SafeStyleSheet.prototype.initSecurityPrivateDoNotAccessOrElse_ =
+    function(styleSheet) {
+  this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ = styleSheet;
+  return this;
+};
+
+
+/**
+ * A SafeStyleSheet instance corresponding to the empty string.
+ * @const {!goog.html.SafeStyleSheet}
+ */
+goog.html.SafeStyleSheet.EMPTY =
+    goog.html.SafeStyleSheet.
+        createSafeStyleSheetSecurityPrivateDoNotAccessOrElse('');
diff --git a/lib/goog/html/safeurl.js b/lib/goog/html/safeurl.js
new file mode 100644
index 0000000..0a520ec
--- /dev/null
+++ b/lib/goog/html/safeurl.js
@@ -0,0 +1,398 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview The SafeUrl type and its builders.
+ *
+ * TODO(xtof): Link to document stating type contract.
+ */
+
+goog.provide('goog.html.SafeUrl');
+
+goog.require('goog.asserts');
+goog.require('goog.fs.url');
+goog.require('goog.i18n.bidi.Dir');
+goog.require('goog.i18n.bidi.DirectionalString');
+goog.require('goog.string.Const');
+goog.require('goog.string.TypedString');
+
+
+
+/**
+ * A string that is safe to use in URL context in DOM APIs and HTML documents.
+ *
+ * A SafeUrl is a string-like object that carries the security type contract
+ * that its value as a string will not cause untrusted script execution
+ * when evaluated as a hyperlink URL in a browser.
+ *
+ * Values of this type are guaranteed to be safe to use in URL/hyperlink
+ * contexts, such as, assignment to URL-valued DOM properties, or
+ * interpolation into a HTML template in URL context (e.g., inside a href
+ * attribute), in the sense that the use will not result in a
+ * Cross-Site-Scripting vulnerability.
+ *
+ * Note that, as documented in {@code goog.html.SafeUrl.unwrap}, this type's
+ * contract does not guarantee that instances are safe to interpolate into HTML
+ * without appropriate escaping.
+ *
+ * Note also that this type's contract does not imply any guarantees regarding
+ * the resource the URL refers to.  In particular, SafeUrls are <b>not</b>
+ * safe to use in a context where the referred-to resource is interpreted as
+ * trusted code, e.g., as the src of a script tag.
+ *
+ * Instances of this type must be created via the factory methods
+ * ({@code goog.html.SafeUrl.fromConstant}, {@code goog.html.SafeUrl.sanitize}),
+ * etc and not by invoking its constructor.  The constructor intentionally
+ * takes no parameters and the type is immutable; hence only a default instance
+ * corresponding to the empty string can be obtained via constructor invocation.
+ *
+ * @see goog.html.SafeUrl#fromConstant
+ * @see goog.html.SafeUrl#from
+ * @see goog.html.SafeUrl#sanitize
+ * @constructor
+ * @final
+ * @struct
+ * @implements {goog.i18n.bidi.DirectionalString}
+ * @implements {goog.string.TypedString}
+ */
+goog.html.SafeUrl = function() {
+  /**
+   * The contained value of this SafeUrl.  The field has a purposely ugly
+   * name to make (non-compiled) code that attempts to directly access this
+   * field stand out.
+   * @private {string}
+   */
+  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = '';
+
+  /**
+   * A type marker used to implement additional run-time type checking.
+   * @see goog.html.SafeUrl#unwrap
+   * @const
+   * @private
+   */
+  this.SAFE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =
+      goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+
+
+/**
+ * The innocuous string generated by goog.html.SafeUrl.sanitize when passed
+ * an unsafe URL.
+ *
+ * about:invalid is registered in
+ * http://www.w3.org/TR/css3-values/#about-invalid.
+ * http://tools.ietf.org/html/rfc6694#section-2.2.1 permits about URLs to
+ * contain a fragment, which is not to be considered when determining if an
+ * about URL is well-known.
+ *
+ * Using about:invalid seems preferable to using a fixed data URL, since
+ * browsers might choose to not report CSP violations on it, as legitimate
+ * CSS function calls to attr() can result in this URL being produced. It is
+ * also a standard URL which matches exactly the semantics we need:
+ * "The about:invalid URI references a non-existent document with a generic
+ * error condition. It can be used when a URI is necessary, but the default
+ * value shouldn't be resolveable as any type of document".
+ *
+ * @const {string}
+ */
+goog.html.SafeUrl.INNOCUOUS_STRING = 'about:invalid#zClosurez';
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.SafeUrl.prototype.implementsGoogStringTypedString = true;
+
+
+/**
+ * Returns this SafeUrl's value a string.
+ *
+ * IMPORTANT: In code where it is security relevant that an object's type is
+ * indeed {@code SafeUrl}, use {@code goog.html.SafeUrl.unwrap} instead of this
+ * method. If in doubt, assume that it's security relevant. In particular, note
+ * that goog.html functions which return a goog.html type do not guarantee that
+ * the returned instance is of the right type. For example:
+ *
+ * <pre>
+ * var fakeSafeHtml = new String('fake');
+ * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;
+ * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);
+ * // newSafeHtml is just an alias for fakeSafeHtml, it's passed through by
+ * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml instanceof
+ * // goog.html.SafeHtml.
+ * </pre>
+ *
+ * IMPORTANT: The guarantees of the SafeUrl type contract only extend to the
+ * behavior of browsers when interpreting URLs. Values of SafeUrl objects MUST
+ * be appropriately escaped before embedding in a HTML document. Note that the
+ * required escaping is context-sensitive (e.g. a different escaping is
+ * required for embedding a URL in a style property within a style
+ * attribute, as opposed to embedding in a href attribute).
+ *
+ * @see goog.html.SafeUrl#unwrap
+ * @override
+ */
+goog.html.SafeUrl.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeHtmlWrappedValue_;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.SafeUrl.prototype.implementsGoogI18nBidiDirectionalString = true;
+
+
+/**
+ * Returns this URLs directionality, which is always {@code LTR}.
+ * @override
+ */
+goog.html.SafeUrl.prototype.getDirection = function() {
+  return goog.i18n.bidi.Dir.LTR;
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a debug string-representation of this value.
+   *
+   * To obtain the actual string value wrapped in a SafeUrl, use
+   * {@code goog.html.SafeUrl.unwrap}.
+   *
+   * @see goog.html.SafeUrl#unwrap
+   * @override
+   */
+  goog.html.SafeUrl.prototype.toString = function() {
+    return 'SafeUrl{' + this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ +
+        '}';
+  };
+}
+
+
+/**
+ * Performs a runtime check that the provided object is indeed a SafeUrl
+ * object, and returns its value.
+ *
+ * IMPORTANT: The guarantees of the SafeUrl type contract only extend to the
+ * behavior of  browsers when interpreting URLs. Values of SafeUrl objects MUST
+ * be appropriately escaped before embedding in a HTML document. Note that the
+ * required escaping is context-sensitive (e.g. a different escaping is
+ * required for embedding a URL in a style property within a style
+ * attribute, as opposed to embedding in a href attribute).
+ *
+ * @param {!goog.html.SafeUrl} safeUrl The object to extract from.
+ * @return {string} The SafeUrl object's contained string, unless the run-time
+ *     type check fails. In that case, {@code unwrap} returns an innocuous
+ *     string, or, if assertions are enabled, throws
+ *     {@code goog.asserts.AssertionError}.
+ */
+goog.html.SafeUrl.unwrap = function(safeUrl) {
+  // Perform additional Run-time type-checking to ensure that safeUrl is indeed
+  // an instance of the expected type.  This provides some additional protection
+  // against security bugs due to application code that disables type checks.
+  // Specifically, the following checks are performed:
+  // 1. The object is an instance of the expected type.
+  // 2. The object is not an instance of a subclass.
+  // 3. The object carries a type marker for the expected type. "Faking" an
+  // object requires a reference to the type marker, which has names intended
+  // to stand out in code reviews.
+  if (safeUrl instanceof goog.html.SafeUrl &&
+      safeUrl.constructor === goog.html.SafeUrl &&
+      safeUrl.SAFE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===
+          goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return safeUrl.privateDoNotAccessOrElseSafeHtmlWrappedValue_;
+  } else {
+    goog.asserts.fail('expected object of type SafeUrl, got \'' +
+                      safeUrl + '\'');
+    return 'type_error:SafeUrl';
+
+  }
+};
+
+
+/**
+ * Creates a SafeUrl object from a compile-time constant string.
+ *
+ * Compile-time constant strings are inherently program-controlled and hence
+ * trusted.
+ *
+ * @param {!goog.string.Const} url A compile-time-constant string from which to
+ *         create a SafeUrl.
+ * @return {!goog.html.SafeUrl} A SafeUrl object initialized to {@code url}.
+ */
+goog.html.SafeUrl.fromConstant = function(url) {
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(
+      goog.string.Const.unwrap(url));
+};
+
+
+/**
+ * A pattern that matches Blob or data types that can have SafeUrls created
+ * from URL.createObjectURL(blob) or via a data: URI.  Only matches image and
+ * video types, currently.
+ * @const
+ * @private
+ */
+goog.html.SAFE_MIME_TYPE_PATTERN_ =
+    /^(?:image\/(?:bmp|gif|jpeg|jpg|png|tiff|webp)|video\/(?:mpeg|mp4|ogg|webm))$/i;
+
+
+/**
+ * Creates a SafeUrl wrapping a blob URL for the given {@code blob}.
+ *
+ * The blob URL is created with {@code URL.createObjectURL}. If the MIME type
+ * for {@code blob} is not of a known safe image or video MIME type, then the
+ * SafeUrl will wrap {@link #INNOCUOUS_STRING}.
+ *
+ * @see http://www.w3.org/TR/FileAPI/#url
+ * @param {!Blob} blob
+ * @return {!goog.html.SafeUrl} The blob URL, or an innocuous string wrapped
+ *   as a SafeUrl.
+ */
+goog.html.SafeUrl.fromBlob = function(blob) {
+  var url = goog.html.SAFE_MIME_TYPE_PATTERN_.test(blob.type) ?
+      goog.fs.url.createObjectUrl(blob) : goog.html.SafeUrl.INNOCUOUS_STRING;
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(url);
+};
+
+
+/**
+ * Matches a base-64 data URL, with the first match group being the MIME type.
+ * @const
+ * @private
+ */
+goog.html.DATA_URL_PATTERN_ = /^data:([^;,]*);base64,[a-z0-9+\/]+=*$/i;
+
+
+/**
+ * Creates a SafeUrl wrapping a data: URL, after validating it matches a
+ * known-safe image or video MIME type.
+ *
+ * @param {string} dataUrl A valid base64 data URL with one of the whitelisted
+ *     image or video MIME types.
+ * @return {!goog.html.SafeUrl} A matching safe URL, or {@link INNOCUOUS_STRING}
+ *     wrapped as a SafeUrl if it does not pass.
+ */
+goog.html.SafeUrl.fromDataUrl = function(dataUrl) {
+  // There's a slight risk here that a browser sniffs the content type if it
+  // doesn't know the MIME type and executes HTML within the data: URL. For this
+  // to cause XSS it would also have to execute the HTML in the same origin
+  // of the page with the link. It seems unlikely that both of these will
+  // happen, particularly in not really old IEs.
+  var match = dataUrl.match(goog.html.DATA_URL_PATTERN_);
+  var valid = match && goog.html.SAFE_MIME_TYPE_PATTERN_.test(match[1]);
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(
+      valid ? dataUrl : goog.html.SafeUrl.INNOCUOUS_STRING);
+};
+
+
+/**
+ * A pattern that recognizes a commonly useful subset of URLs that satisfy
+ * the SafeUrl contract.
+ *
+ * This regular expression matches a subset of URLs that will not cause script
+ * execution if used in URL context within a HTML document. Specifically, this
+ * regular expression matches if (comment from here on and regex copied from
+ * Soy's EscapingConventions):
+ * (1) Either a protocol in a whitelist (http, https, mailto or ftp).
+ * (2) or no protocol.  A protocol must be followed by a colon. The below
+ *     allows that by allowing colons only after one of the characters [/?#].
+ *     A colon after a hash (#) must be in the fragment.
+ *     Otherwise, a colon after a (?) must be in a query.
+ *     Otherwise, a colon after a single solidus (/) must be in a path.
+ *     Otherwise, a colon after a double solidus (//) must be in the authority
+ *     (before port).
+ *
+ * The pattern disallows &, used in HTML entity declarations before
+ * one of the characters in [/?#]. This disallows HTML entities used in the
+ * protocol name, which should never happen, e.g. "h&#116;tp" for "http".
+ * It also disallows HTML entities in the first path part of a relative path,
+ * e.g. "foo&lt;bar/baz".  Our existing escaping functions should not produce
+ * that. More importantly, it disallows masking of a colon,
+ * e.g. "javascript&#58;...".
+ *
+ * @private
+ * @const {!RegExp}
+ */
+goog.html.SAFE_URL_PATTERN_ =
+    /^(?:(?:https?|mailto|ftp):|[^&:/?#]*(?:[/?#]|$))/i;
+
+
+/**
+ * Creates a SafeUrl object from {@code url}. If {@code url} is a
+ * goog.html.SafeUrl then it is simply returned. Otherwise the input string is
+ * validated to match a pattern of commonly used safe URLs. The string is
+ * converted to UTF-8 and non-whitelisted characters are percent-encoded. The
+ * string wrapped by the created SafeUrl will thus contain only ASCII printable
+ * characters.
+ *
+ * {@code url} may be a URL with the http, https, mailto or ftp scheme,
+ * or a relative URL (i.e., a URL without a scheme; specifically, a
+ * scheme-relative, absolute-path-relative, or path-relative URL).
+ *
+ * {@code url} is converted to UTF-8 and non-whitelisted characters are
+ * percent-encoded. Whitelisted characters are '%' and, from RFC 3986,
+ * unreserved characters and reserved characters, with the exception of '\'',
+ * '(' and ')'. This ensures the the SafeUrl contains only ASCII-printable
+ * characters and reduces the chance of security bugs were it to be
+ * interpolated into a specific context without the necessary escaping.
+ *
+ * If {@code url} fails validation or does not UTF-16 decode correctly
+ * (JavaScript strings are UTF-16 encoded), this function returns a SafeUrl
+ * object containing an innocuous string, goog.html.SafeUrl.INNOCUOUS_STRING.
+ *
+ * @see http://url.spec.whatwg.org/#concept-relative-url
+ * @param {string|!goog.string.TypedString} url The URL to validate.
+ * @return {!goog.html.SafeUrl} The validated URL, wrapped as a SafeUrl.
+ */
+goog.html.SafeUrl.sanitize = function(url) {
+  if (url instanceof goog.html.SafeUrl) {
+    return url;
+  }
+  else if (url.implementsGoogStringTypedString) {
+    url = url.getTypedStringValue();
+  } else {
+    url = String(url);
+  }
+  if (!goog.html.SAFE_URL_PATTERN_.test(url)) {
+    url = goog.html.SafeUrl.INNOCUOUS_STRING;
+  }
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(url);
+};
+
+
+/**
+ * Type marker for the SafeUrl type, used to implement additional run-time
+ * type checking.
+ * @const {!Object}
+ * @private
+ */
+goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+
+
+/**
+ * Package-internal utility method to create SafeUrl instances.
+ *
+ * @param {string} url The string to initialize the SafeUrl object with.
+ * @return {!goog.html.SafeUrl} The initialized SafeUrl object.
+ * @package
+ */
+goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse = function(
+    url) {
+  var safeUrl = new goog.html.SafeUrl();
+  safeUrl.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = url;
+  return safeUrl;
+};
diff --git a/lib/goog/html/trustedresourceurl.js b/lib/goog/html/trustedresourceurl.js
new file mode 100644
index 0000000..a695356
--- /dev/null
+++ b/lib/goog/html/trustedresourceurl.js
@@ -0,0 +1,224 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview The TrustedResourceUrl type and its builders.
+ *
+ * TODO(xtof): Link to document stating type contract.
+ */
+
+goog.provide('goog.html.TrustedResourceUrl');
+
+goog.require('goog.asserts');
+goog.require('goog.i18n.bidi.Dir');
+goog.require('goog.i18n.bidi.DirectionalString');
+goog.require('goog.string.Const');
+goog.require('goog.string.TypedString');
+
+
+
+/**
+ * A URL which is under application control and from which script, CSS, and
+ * other resources that represent executable code, can be fetched.
+ *
+ * Given that the URL can only be constructed from strings under application
+ * control and is used to load resources, bugs resulting in a malformed URL
+ * should not have a security impact and are likely to be easily detectable
+ * during testing. Given the wide number of non-RFC compliant URLs in use,
+ * stricter validation could prevent some applications from being able to use
+ * this type.
+ *
+ * Instances of this type must be created via the factory method,
+ * ({@code goog.html.TrustedResourceUrl.fromConstant}), and not by invoking its
+ * constructor. The constructor intentionally takes no parameters and the type
+ * is immutable; hence only a default instance corresponding to the empty
+ * string can be obtained via constructor invocation.
+ *
+ * @see goog.html.TrustedResourceUrl#fromConstant
+ * @constructor
+ * @final
+ * @struct
+ * @implements {goog.i18n.bidi.DirectionalString}
+ * @implements {goog.string.TypedString}
+ */
+goog.html.TrustedResourceUrl = function() {
+  /**
+   * The contained value of this TrustedResourceUrl.  The field has a purposely
+   * ugly name to make (non-compiled) code that attempts to directly access this
+   * field stand out.
+   * @private {string}
+   */
+  this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ = '';
+
+  /**
+   * A type marker used to implement additional run-time type checking.
+   * @see goog.html.TrustedResourceUrl#unwrap
+   * @const
+   * @private
+   */
+  this.TRUSTED_RESOURCE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ =
+      goog.html.TrustedResourceUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.TrustedResourceUrl.prototype.implementsGoogStringTypedString = true;
+
+
+/**
+ * Returns this TrustedResourceUrl's value as a string.
+ *
+ * IMPORTANT: In code where it is security relevant that an object's type is
+ * indeed {@code TrustedResourceUrl}, use
+ * {@code goog.html.TrustedResourceUrl.unwrap} instead of this method. If in
+ * doubt, assume that it's security relevant. In particular, note that
+ * goog.html functions which return a goog.html type do not guarantee that
+ * the returned instance is of the right type. For example:
+ *
+ * <pre>
+ * var fakeSafeHtml = new String('fake');
+ * fakeSafeHtml.__proto__ = goog.html.SafeHtml.prototype;
+ * var newSafeHtml = goog.html.SafeHtml.htmlEscape(fakeSafeHtml);
+ * // newSafeHtml is just an alias for fakeSafeHtml, it's passed through by
+ * // goog.html.SafeHtml.htmlEscape() as fakeSafeHtml instanceof
+ * // goog.html.SafeHtml.
+ * </pre>
+ *
+ * @see goog.html.TrustedResourceUrl#unwrap
+ * @override
+ */
+goog.html.TrustedResourceUrl.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.html.TrustedResourceUrl.prototype.implementsGoogI18nBidiDirectionalString =
+    true;
+
+
+/**
+ * Returns this URLs directionality, which is always {@code LTR}.
+ * @override
+ */
+goog.html.TrustedResourceUrl.prototype.getDirection = function() {
+  return goog.i18n.bidi.Dir.LTR;
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a debug string-representation of this value.
+   *
+   * To obtain the actual string value wrapped in a TrustedResourceUrl, use
+   * {@code goog.html.TrustedResourceUrl.unwrap}.
+   *
+   * @see goog.html.TrustedResourceUrl#unwrap
+   * @override
+   */
+  goog.html.TrustedResourceUrl.prototype.toString = function() {
+    return 'TrustedResourceUrl{' +
+        this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ + '}';
+  };
+}
+
+
+/**
+ * Performs a runtime check that the provided object is indeed a
+ * TrustedResourceUrl object, and returns its value.
+ *
+ * @param {!goog.html.TrustedResourceUrl} trustedResourceUrl The object to
+ *     extract from.
+ * @return {string} The trustedResourceUrl object's contained string, unless
+ *     the run-time type check fails. In that case, {@code unwrap} returns an
+ *     innocuous string, or, if assertions are enabled, throws
+ *     {@code goog.asserts.AssertionError}.
+ */
+goog.html.TrustedResourceUrl.unwrap = function(trustedResourceUrl) {
+  // Perform additional Run-time type-checking to ensure that
+  // trustedResourceUrl is indeed an instance of the expected type.  This
+  // provides some additional protection against security bugs due to
+  // application code that disables type checks.
+  // Specifically, the following checks are performed:
+  // 1. The object is an instance of the expected type.
+  // 2. The object is not an instance of a subclass.
+  // 3. The object carries a type marker for the expected type. "Faking" an
+  // object requires a reference to the type marker, which has names intended
+  // to stand out in code reviews.
+  if (trustedResourceUrl instanceof goog.html.TrustedResourceUrl &&
+      trustedResourceUrl.constructor === goog.html.TrustedResourceUrl &&
+      trustedResourceUrl
+          .TRUSTED_RESOURCE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ ===
+              goog.html.TrustedResourceUrl
+                  .TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return trustedResourceUrl
+        .privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_;
+  } else {
+    goog.asserts.fail('expected object of type TrustedResourceUrl, got \'' +
+                      trustedResourceUrl + '\'');
+    return 'type_error:TrustedResourceUrl';
+
+  }
+};
+
+
+/**
+ * Creates a TrustedResourceUrl object from a compile-time constant string.
+ *
+ * Compile-time constant strings are inherently program-controlled and hence
+ * trusted.
+ *
+ * @param {!goog.string.Const} url A compile-time-constant string from which to
+ *     create a TrustedResourceUrl.
+ * @return {!goog.html.TrustedResourceUrl} A TrustedResourceUrl object
+ *     initialized to {@code url}.
+ */
+goog.html.TrustedResourceUrl.fromConstant = function(url) {
+  return goog.html.TrustedResourceUrl
+      .createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse(
+          goog.string.Const.unwrap(url));
+};
+
+
+/**
+ * Type marker for the TrustedResourceUrl type, used to implement additional
+ * run-time type checking.
+ * @const {!Object}
+ * @private
+ */
+goog.html.TrustedResourceUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+
+
+/**
+ * Package-internal utility method to create TrustedResourceUrl instances.
+ *
+ * @param {string} url The string to initialize the TrustedResourceUrl object
+ *     with.
+ * @return {!goog.html.TrustedResourceUrl} The initialized TrustedResourceUrl
+ *     object.
+ * @package
+ */
+goog.html.TrustedResourceUrl.
+    createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse = function(url) {
+  var trustedResourceUrl = new goog.html.TrustedResourceUrl();
+  trustedResourceUrl.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ =
+      url;
+  return trustedResourceUrl;
+};
diff --git a/lib/goog/html/uncheckedconversions.js b/lib/goog/html/uncheckedconversions.js
new file mode 100644
index 0000000..edb083f
--- /dev/null
+++ b/lib/goog/html/uncheckedconversions.js
@@ -0,0 +1,232 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Unchecked conversions to create values of goog.html types from
+ * plain strings.  Use of these functions could potentially result in instances
+ * of goog.html types that violate their type contracts, and hence result in
+ * security vulnerabilties.
+ *
+ * Therefore, all uses of the methods herein must be carefully security
+ * reviewed.  Avoid use of the methods in this file whenever possible; instead
+ * prefer to create instances of goog.html types using inherently safe builders
+ * or template systems.
+ *
+ *
+ *
+ * @visibility {//closure/goog/html:approved_for_unchecked_conversion}
+ * @visibility {//closure/goog/bin/sizetests:__pkg__}
+ */
+
+
+goog.provide('goog.html.uncheckedconversions');
+
+goog.require('goog.asserts');
+goog.require('goog.html.SafeHtml');
+goog.require('goog.html.SafeScript');
+goog.require('goog.html.SafeStyle');
+goog.require('goog.html.SafeStyleSheet');
+goog.require('goog.html.SafeUrl');
+goog.require('goog.html.TrustedResourceUrl');
+goog.require('goog.string');
+goog.require('goog.string.Const');
+
+
+/**
+ * Performs an "unchecked conversion" to SafeHtml from a plain string that is
+ * known to satisfy the SafeHtml type contract.
+ *
+ * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure
+ * that the value of {@code html} satisfies the SafeHtml type contract in all
+ * possible program states.
+ *
+ *
+ * @param {!goog.string.Const} justification A constant string explaining why
+ *     this use of this method is safe. May include a security review ticket
+ *     number.
+ * @param {string} html A string that is claimed to adhere to the SafeHtml
+ *     contract.
+ * @param {?goog.i18n.bidi.Dir=} opt_dir The optional directionality of the
+ *     SafeHtml to be constructed. A null or undefined value signifies an
+ *     unknown directionality.
+ * @return {!goog.html.SafeHtml} The value of html, wrapped in a SafeHtml
+ *     object.
+ * @suppress {visibility} For access to SafeHtml.create...  Note that this
+ *     use is appropriate since this method is intended to be "package private"
+ *     withing goog.html.  DO NOT call SafeHtml.create... from outside this
+ *     package; use appropriate wrappers instead.
+ */
+goog.html.uncheckedconversions.safeHtmlFromStringKnownToSatisfyTypeContract =
+    function(justification, html, opt_dir) {
+  // unwrap() called inside an assert so that justification can be optimized
+  // away in production code.
+  goog.asserts.assertString(goog.string.Const.unwrap(justification),
+                            'must provide justification');
+  goog.asserts.assert(
+      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),
+      'must provide non-empty justification');
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+      html, opt_dir || null);
+};
+
+
+/**
+ * Performs an "unchecked conversion" to SafeScript from a plain string that is
+ * known to satisfy the SafeScript type contract.
+ *
+ * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure
+ * that the value of {@code script} satisfies the SafeScript type contract in
+ * all possible program states.
+ *
+ *
+ * @param {!goog.string.Const} justification A constant string explaining why
+ *     this use of this method is safe. May include a security review ticket
+ *     number.
+ * @param {string} script The string to wrap as a SafeScript.
+ * @return {!goog.html.SafeScript} The value of {@code script}, wrapped in a
+ *     SafeScript object.
+ */
+goog.html.uncheckedconversions.safeScriptFromStringKnownToSatisfyTypeContract =
+    function(justification, script) {
+  // unwrap() called inside an assert so that justification can be optimized
+  // away in production code.
+  goog.asserts.assertString(goog.string.Const.unwrap(justification),
+                            'must provide justification');
+  goog.asserts.assert(
+      !goog.string.isEmpty(goog.string.Const.unwrap(justification)),
+      'must provide non-empty justification');
+  return goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(
+      script);
+};
+
+
+/**
+ * Performs an "unchecked conversion" to SafeStyle from a plain string that is
+ * known to satisfy the SafeStyle type contract.
+ *
+ * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure
+ * that the value of {@code style} satisfies the SafeUrl type contract in all
+ * possible program states.
+ *
+ *
+ * @param {!goog.string.Const} justification A constant string explaining why
+ *     this use of this method is safe. May include a security review ticket
+ *     number.
+ * @param {string} style The string to wrap as a SafeStyle.
+ * @return {!goog.html.SafeStyle} The value of {@code style}, wrapped in a
+ *     SafeStyle object.
+ */
+goog.html.uncheckedconversions.safeStyleFromStringKnownToSatisfyTypeContract =
+    function(justification, style) {
+  // unwrap() called inside an assert so that justification can be optimized
+  // away in production code.
+  goog.asserts.assertString(goog.string.Const.unwrap(justification),
+                            'must provide justification');
+  goog.asserts.assert(
+      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),
+      'must provide non-empty justification');
+  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(
+      style);
+};
+
+
+/**
+ * Performs an "unchecked conversion" to SafeStyleSheet from a plain string
+ * that is known to satisfy the SafeStyleSheet type contract.
+ *
+ * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure
+ * that the value of {@code styleSheet} satisfies the SafeUrl type contract in
+ * all possible program states.
+ *
+ *
+ * @param {!goog.string.Const} justification A constant string explaining why
+ *     this use of this method is safe. May include a security review ticket
+ *     number.
+ * @param {string} styleSheet The string to wrap as a SafeStyleSheet.
+ * @return {!goog.html.SafeStyleSheet} The value of {@code styleSheet}, wrapped
+ *     in a SafeStyleSheet object.
+ */
+goog.html.uncheckedconversions.
+    safeStyleSheetFromStringKnownToSatisfyTypeContract =
+    function(justification, styleSheet) {
+  // unwrap() called inside an assert so that justification can be optimized
+  // away in production code.
+  goog.asserts.assertString(goog.string.Const.unwrap(justification),
+                            'must provide justification');
+  goog.asserts.assert(
+      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),
+      'must provide non-empty justification');
+  return goog.html.SafeStyleSheet.
+      createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(styleSheet);
+};
+
+
+/**
+ * Performs an "unchecked conversion" to SafeUrl from a plain string that is
+ * known to satisfy the SafeUrl type contract.
+ *
+ * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure
+ * that the value of {@code url} satisfies the SafeUrl type contract in all
+ * possible program states.
+ *
+ *
+ * @param {!goog.string.Const} justification A constant string explaining why
+ *     this use of this method is safe. May include a security review ticket
+ *     number.
+ * @param {string} url The string to wrap as a SafeUrl.
+ * @return {!goog.html.SafeUrl} The value of {@code url}, wrapped in a SafeUrl
+ *     object.
+ */
+goog.html.uncheckedconversions.safeUrlFromStringKnownToSatisfyTypeContract =
+    function(justification, url) {
+  // unwrap() called inside an assert so that justification can be optimized
+  // away in production code.
+  goog.asserts.assertString(goog.string.Const.unwrap(justification),
+                            'must provide justification');
+  goog.asserts.assert(
+      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),
+      'must provide non-empty justification');
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(url);
+};
+
+
+/**
+ * Performs an "unchecked conversion" to TrustedResourceUrl from a plain string
+ * that is known to satisfy the TrustedResourceUrl type contract.
+ *
+ * IMPORTANT: Uses of this method must be carefully security-reviewed to ensure
+ * that the value of {@code url} satisfies the TrustedResourceUrl type contract
+ * in all possible program states.
+ *
+ *
+ * @param {!goog.string.Const} justification A constant string explaining why
+ *     this use of this method is safe. May include a security review ticket
+ *     number.
+ * @param {string} url The string to wrap as a TrustedResourceUrl.
+ * @return {!goog.html.TrustedResourceUrl} The value of {@code url}, wrapped in
+ *     a TrustedResourceUrl object.
+ */
+goog.html.uncheckedconversions.
+    trustedResourceUrlFromStringKnownToSatisfyTypeContract =
+    function(justification, url) {
+  // unwrap() called inside an assert so that justification can be optimized
+  // away in production code.
+  goog.asserts.assertString(goog.string.Const.unwrap(justification),
+                            'must provide justification');
+  goog.asserts.assert(
+      !goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(justification)),
+      'must provide non-empty justification');
+  return goog.html.TrustedResourceUrl.
+      createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse(url);
+};
diff --git a/lib/goog/i18n/bidi.js b/lib/goog/i18n/bidi.js
new file mode 100644
index 0000000..37b5b9f
--- /dev/null
+++ b/lib/goog/i18n/bidi.js
@@ -0,0 +1,908 @@
+// Copyright 2007 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Utility functions for supporting Bidi issues.
+ */
+
+
+/**
+ * Namespace for bidi supporting functions.
+ */
+goog.provide('goog.i18n.bidi');
+goog.provide('goog.i18n.bidi.Dir');
+goog.provide('goog.i18n.bidi.DirectionalString');
+goog.provide('goog.i18n.bidi.Format');
+
+
+/**
+ * @define {boolean} FORCE_RTL forces the {@link goog.i18n.bidi.IS_RTL} constant
+ * to say that the current locale is a RTL locale.  This should only be used
+ * if you want to override the default behavior for deciding whether the
+ * current locale is RTL or not.
+ *
+ * {@see goog.i18n.bidi.IS_RTL}
+ */
+goog.define('goog.i18n.bidi.FORCE_RTL', false);
+
+
+/**
+ * Constant that defines whether or not the current locale is a RTL locale.
+ * If {@link goog.i18n.bidi.FORCE_RTL} is not true, this constant will default
+ * to check that {@link goog.LOCALE} is one of a few major RTL locales.
+ *
+ * <p>This is designed to be a maximally efficient compile-time constant. For
+ * example, for the default goog.LOCALE, compiling
+ * "if (goog.i18n.bidi.IS_RTL) alert('rtl') else {}" should produce no code. It
+ * is this design consideration that limits the implementation to only
+ * supporting a few major RTL locales, as opposed to the broader repertoire of
+ * something like goog.i18n.bidi.isRtlLanguage.
+ *
+ * <p>Since this constant refers to the directionality of the locale, it is up
+ * to the caller to determine if this constant should also be used for the
+ * direction of the UI.
+ *
+ * {@see goog.LOCALE}
+ *
+ * @type {boolean}
+ *
+ * TODO(user): write a test that checks that this is a compile-time constant.
+ */
+goog.i18n.bidi.IS_RTL = goog.i18n.bidi.FORCE_RTL ||
+    (
+        (goog.LOCALE.substring(0, 2).toLowerCase() == 'ar' ||
+         goog.LOCALE.substring(0, 2).toLowerCase() == 'fa' ||
+         goog.LOCALE.substring(0, 2).toLowerCase() == 'he' ||
+         goog.LOCALE.substring(0, 2).toLowerCase() == 'iw' ||
+         goog.LOCALE.substring(0, 2).toLowerCase() == 'ps' ||
+         goog.LOCALE.substring(0, 2).toLowerCase() == 'sd' ||
+         goog.LOCALE.substring(0, 2).toLowerCase() == 'ug' ||
+         goog.LOCALE.substring(0, 2).toLowerCase() == 'ur' ||
+         goog.LOCALE.substring(0, 2).toLowerCase() == 'yi') &&
+        (goog.LOCALE.length == 2 ||
+         goog.LOCALE.substring(2, 3) == '-' ||
+         goog.LOCALE.substring(2, 3) == '_')
+    ) || (
+        goog.LOCALE.length >= 3 &&
+        goog.LOCALE.substring(0, 3).toLowerCase() == 'ckb' &&
+        (goog.LOCALE.length == 3 ||
+         goog.LOCALE.substring(3, 4) == '-' ||
+         goog.LOCALE.substring(3, 4) == '_')
+    );
+
+
+/**
+ * Unicode formatting characters and directionality string constants.
+ * @enum {string}
+ */
+goog.i18n.bidi.Format = {
+  /** Unicode "Left-To-Right Embedding" (LRE) character. */
+  LRE: '\u202A',
+  /** Unicode "Right-To-Left Embedding" (RLE) character. */
+  RLE: '\u202B',
+  /** Unicode "Pop Directional Formatting" (PDF) character. */
+  PDF: '\u202C',
+  /** Unicode "Left-To-Right Mark" (LRM) character. */
+  LRM: '\u200E',
+  /** Unicode "Right-To-Left Mark" (RLM) character. */
+  RLM: '\u200F'
+};
+
+
+/**
+ * Directionality enum.
+ * @enum {number}
+ */
+goog.i18n.bidi.Dir = {
+  /**
+   * Left-to-right.
+   */
+  LTR: 1,
+
+  /**
+   * Right-to-left.
+   */
+  RTL: -1,
+
+  /**
+   * Neither left-to-right nor right-to-left.
+   */
+  NEUTRAL: 0
+};
+
+
+/**
+ * 'right' string constant.
+ * @type {string}
+ */
+goog.i18n.bidi.RIGHT = 'right';
+
+
+/**
+ * 'left' string constant.
+ * @type {string}
+ */
+goog.i18n.bidi.LEFT = 'left';
+
+
+/**
+ * 'left' if locale is RTL, 'right' if not.
+ * @type {string}
+ */
+goog.i18n.bidi.I18N_RIGHT = goog.i18n.bidi.IS_RTL ? goog.i18n.bidi.LEFT :
+    goog.i18n.bidi.RIGHT;
+
+
+/**
+ * 'right' if locale is RTL, 'left' if not.
+ * @type {string}
+ */
+goog.i18n.bidi.I18N_LEFT = goog.i18n.bidi.IS_RTL ? goog.i18n.bidi.RIGHT :
+    goog.i18n.bidi.LEFT;
+
+
+/**
+ * Convert a directionality given in various formats to a goog.i18n.bidi.Dir
+ * constant. Useful for interaction with different standards of directionality
+ * representation.
+ *
+ * @param {goog.i18n.bidi.Dir|number|boolean|null} givenDir Directionality given
+ *     in one of the following formats:
+ *     1. A goog.i18n.bidi.Dir constant.
+ *     2. A number (positive = LTR, negative = RTL, 0 = neutral).
+ *     3. A boolean (true = RTL, false = LTR).
+ *     4. A null for unknown directionality.
+ * @param {boolean=} opt_noNeutral Whether a givenDir of zero or
+ *     goog.i18n.bidi.Dir.NEUTRAL should be treated as null, i.e. unknown, in
+ *     order to preserve legacy behavior.
+ * @return {?goog.i18n.bidi.Dir} A goog.i18n.bidi.Dir constant matching the
+ *     given directionality. If given null, returns null (i.e. unknown).
+ */
+goog.i18n.bidi.toDir = function(givenDir, opt_noNeutral) {
+  if (typeof givenDir == 'number') {
+    // This includes the non-null goog.i18n.bidi.Dir case.
+    return givenDir > 0 ? goog.i18n.bidi.Dir.LTR :
+        givenDir < 0 ? goog.i18n.bidi.Dir.RTL :
+        opt_noNeutral ? null : goog.i18n.bidi.Dir.NEUTRAL;
+  } else if (givenDir == null) {
+    return null;
+  } else {
+    // Must be typeof givenDir == 'boolean'.
+    return givenDir ? goog.i18n.bidi.Dir.RTL : goog.i18n.bidi.Dir.LTR;
+  }
+};
+
+
+/**
+ * A practical pattern to identify strong LTR characters. This pattern is not
+ * theoretically correct according to the Unicode standard. It is simplified for
+ * performance and small code size.
+ * @type {string}
+ * @private
+ */
+goog.i18n.bidi.ltrChars_ =
+    'A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02B8\u0300-\u0590\u0800-\u1FFF' +
+    '\u200E\u2C00-\uFB1C\uFE00-\uFE6F\uFEFD-\uFFFF';
+
+
+/**
+ * A practical pattern to identify strong RTL character. This pattern is not
+ * theoretically correct according to the Unicode standard. It is simplified
+ * for performance and small code size.
+ * @type {string}
+ * @private
+ */
+goog.i18n.bidi.rtlChars_ =
+    '\u0591-\u06EF\u06FA-\u07FF\u200F\uFB1D-\uFDFF\uFE70-\uFEFC';
+
+
+/**
+ * Simplified regular expression for an HTML tag (opening or closing) or an HTML
+ * escape. We might want to skip over such expressions when estimating the text
+ * directionality.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.htmlSkipReg_ = /<[^>]*>|&[^;]+;/g;
+
+
+/**
+ * Returns the input text with spaces instead of HTML tags or HTML escapes, if
+ * opt_isStripNeeded is true. Else returns the input as is.
+ * Useful for text directionality estimation.
+ * Note: the function should not be used in other contexts; it is not 100%
+ * correct, but rather a good-enough implementation for directionality
+ * estimation purposes.
+ * @param {string} str The given string.
+ * @param {boolean=} opt_isStripNeeded Whether to perform the stripping.
+ *     Default: false (to retain consistency with calling functions).
+ * @return {string} The given string cleaned of HTML tags / escapes.
+ * @private
+ */
+goog.i18n.bidi.stripHtmlIfNeeded_ = function(str, opt_isStripNeeded) {
+  return opt_isStripNeeded ? str.replace(goog.i18n.bidi.htmlSkipReg_, '') :
+      str;
+};
+
+
+/**
+ * Regular expression to check for RTL characters.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.rtlCharReg_ = new RegExp('[' + goog.i18n.bidi.rtlChars_ + ']');
+
+
+/**
+ * Regular expression to check for LTR characters.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.ltrCharReg_ = new RegExp('[' + goog.i18n.bidi.ltrChars_ + ']');
+
+
+/**
+ * Test whether the given string has any RTL characters in it.
+ * @param {string} str The given string that need to be tested.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether the string contains RTL characters.
+ */
+goog.i18n.bidi.hasAnyRtl = function(str, opt_isHtml) {
+  return goog.i18n.bidi.rtlCharReg_.test(goog.i18n.bidi.stripHtmlIfNeeded_(
+      str, opt_isHtml));
+};
+
+
+/**
+ * Test whether the given string has any RTL characters in it.
+ * @param {string} str The given string that need to be tested.
+ * @return {boolean} Whether the string contains RTL characters.
+ * @deprecated Use hasAnyRtl.
+ */
+goog.i18n.bidi.hasRtlChar = goog.i18n.bidi.hasAnyRtl;
+
+
+/**
+ * Test whether the given string has any LTR characters in it.
+ * @param {string} str The given string that need to be tested.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether the string contains LTR characters.
+ */
+goog.i18n.bidi.hasAnyLtr = function(str, opt_isHtml) {
+  return goog.i18n.bidi.ltrCharReg_.test(goog.i18n.bidi.stripHtmlIfNeeded_(
+      str, opt_isHtml));
+};
+
+
+/**
+ * Regular expression pattern to check if the first character in the string
+ * is LTR.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.ltrRe_ = new RegExp('^[' + goog.i18n.bidi.ltrChars_ + ']');
+
+
+/**
+ * Regular expression pattern to check if the first character in the string
+ * is RTL.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.rtlRe_ = new RegExp('^[' + goog.i18n.bidi.rtlChars_ + ']');
+
+
+/**
+ * Check if the first character in the string is RTL or not.
+ * @param {string} str The given string that need to be tested.
+ * @return {boolean} Whether the first character in str is an RTL char.
+ */
+goog.i18n.bidi.isRtlChar = function(str) {
+  return goog.i18n.bidi.rtlRe_.test(str);
+};
+
+
+/**
+ * Check if the first character in the string is LTR or not.
+ * @param {string} str The given string that need to be tested.
+ * @return {boolean} Whether the first character in str is an LTR char.
+ */
+goog.i18n.bidi.isLtrChar = function(str) {
+  return goog.i18n.bidi.ltrRe_.test(str);
+};
+
+
+/**
+ * Check if the first character in the string is neutral or not.
+ * @param {string} str The given string that need to be tested.
+ * @return {boolean} Whether the first character in str is a neutral char.
+ */
+goog.i18n.bidi.isNeutralChar = function(str) {
+  return !goog.i18n.bidi.isLtrChar(str) && !goog.i18n.bidi.isRtlChar(str);
+};
+
+
+/**
+ * Regular expressions to check if a piece of text is of LTR directionality
+ * on first character with strong directionality.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.ltrDirCheckRe_ = new RegExp(
+    '^[^' + goog.i18n.bidi.rtlChars_ + ']*[' + goog.i18n.bidi.ltrChars_ + ']');
+
+
+/**
+ * Regular expressions to check if a piece of text is of RTL directionality
+ * on first character with strong directionality.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.rtlDirCheckRe_ = new RegExp(
+    '^[^' + goog.i18n.bidi.ltrChars_ + ']*[' + goog.i18n.bidi.rtlChars_ + ']');
+
+
+/**
+ * Check whether the first strongly directional character (if any) is RTL.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether RTL directionality is detected using the first
+ *     strongly-directional character method.
+ */
+goog.i18n.bidi.startsWithRtl = function(str, opt_isHtml) {
+  return goog.i18n.bidi.rtlDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(
+      str, opt_isHtml));
+};
+
+
+/**
+ * Check whether the first strongly directional character (if any) is RTL.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether RTL directionality is detected using the first
+ *     strongly-directional character method.
+ * @deprecated Use startsWithRtl.
+ */
+goog.i18n.bidi.isRtlText = goog.i18n.bidi.startsWithRtl;
+
+
+/**
+ * Check whether the first strongly directional character (if any) is LTR.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether LTR directionality is detected using the first
+ *     strongly-directional character method.
+ */
+goog.i18n.bidi.startsWithLtr = function(str, opt_isHtml) {
+  return goog.i18n.bidi.ltrDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(
+      str, opt_isHtml));
+};
+
+
+/**
+ * Check whether the first strongly directional character (if any) is LTR.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether LTR directionality is detected using the first
+ *     strongly-directional character method.
+ * @deprecated Use startsWithLtr.
+ */
+goog.i18n.bidi.isLtrText = goog.i18n.bidi.startsWithLtr;
+
+
+/**
+ * Regular expression to check if a string looks like something that must
+ * always be LTR even in RTL text, e.g. a URL. When estimating the
+ * directionality of text containing these, we treat these as weakly LTR,
+ * like numbers.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.isRequiredLtrRe_ = /^http:\/\/.*/;
+
+
+/**
+ * Check whether the input string either contains no strongly directional
+ * characters or looks like a url.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether neutral directionality is detected.
+ */
+goog.i18n.bidi.isNeutralText = function(str, opt_isHtml) {
+  str = goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml);
+  return goog.i18n.bidi.isRequiredLtrRe_.test(str) ||
+      !goog.i18n.bidi.hasAnyLtr(str) && !goog.i18n.bidi.hasAnyRtl(str);
+};
+
+
+/**
+ * Regular expressions to check if the last strongly-directional character in a
+ * piece of text is LTR.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.ltrExitDirCheckRe_ = new RegExp(
+    '[' + goog.i18n.bidi.ltrChars_ + '][^' + goog.i18n.bidi.rtlChars_ + ']*$');
+
+
+/**
+ * Regular expressions to check if the last strongly-directional character in a
+ * piece of text is RTL.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.rtlExitDirCheckRe_ = new RegExp(
+    '[' + goog.i18n.bidi.rtlChars_ + '][^' + goog.i18n.bidi.ltrChars_ + ']*$');
+
+
+/**
+ * Check if the exit directionality a piece of text is LTR, i.e. if the last
+ * strongly-directional character in the string is LTR.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether LTR exit directionality was detected.
+ */
+goog.i18n.bidi.endsWithLtr = function(str, opt_isHtml) {
+  return goog.i18n.bidi.ltrExitDirCheckRe_.test(
+      goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml));
+};
+
+
+/**
+ * Check if the exit directionality a piece of text is LTR, i.e. if the last
+ * strongly-directional character in the string is LTR.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether LTR exit directionality was detected.
+ * @deprecated Use endsWithLtr.
+ */
+goog.i18n.bidi.isLtrExitText = goog.i18n.bidi.endsWithLtr;
+
+
+/**
+ * Check if the exit directionality a piece of text is RTL, i.e. if the last
+ * strongly-directional character in the string is RTL.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether RTL exit directionality was detected.
+ */
+goog.i18n.bidi.endsWithRtl = function(str, opt_isHtml) {
+  return goog.i18n.bidi.rtlExitDirCheckRe_.test(
+      goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml));
+};
+
+
+/**
+ * Check if the exit directionality a piece of text is RTL, i.e. if the last
+ * strongly-directional character in the string is RTL.
+ * @param {string} str String being checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether RTL exit directionality was detected.
+ * @deprecated Use endsWithRtl.
+ */
+goog.i18n.bidi.isRtlExitText = goog.i18n.bidi.endsWithRtl;
+
+
+/**
+ * A regular expression for matching right-to-left language codes.
+ * See {@link #isRtlLanguage} for the design.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.rtlLocalesRe_ = new RegExp(
+    '^(ar|ckb|dv|he|iw|fa|nqo|ps|sd|ug|ur|yi|' +
+    '.*[-_](Arab|Hebr|Thaa|Nkoo|Tfng))' +
+    '(?!.*[-_](Latn|Cyrl)($|-|_))($|-|_)',
+    'i');
+
+
+/**
+ * Check if a BCP 47 / III language code indicates an RTL language, i.e. either:
+ * - a language code explicitly specifying one of the right-to-left scripts,
+ *   e.g. "az-Arab", or<p>
+ * - a language code specifying one of the languages normally written in a
+ *   right-to-left script, e.g. "fa" (Farsi), except ones explicitly specifying
+ *   Latin or Cyrillic script (which are the usual LTR alternatives).<p>
+ * The list of right-to-left scripts appears in the 100-199 range in
+ * http://www.unicode.org/iso15924/iso15924-num.html, of which Arabic and
+ * Hebrew are by far the most widely used. We also recognize Thaana, N'Ko, and
+ * Tifinagh, which also have significant modern usage. The rest (Syriac,
+ * Samaritan, Mandaic, etc.) seem to have extremely limited or no modern usage
+ * and are not recognized to save on code size.
+ * The languages usually written in a right-to-left script are taken as those
+ * with Suppress-Script: Hebr|Arab|Thaa|Nkoo|Tfng  in
+ * http://www.iana.org/assignments/language-subtag-registry,
+ * as well as Central (or Sorani) Kurdish (ckb), Sindhi (sd) and Uyghur (ug).
+ * Other subtags of the language code, e.g. regions like EG (Egypt), are
+ * ignored.
+ * @param {string} lang BCP 47 (a.k.a III) language code.
+ * @return {boolean} Whether the language code is an RTL language.
+ */
+goog.i18n.bidi.isRtlLanguage = function(lang) {
+  return goog.i18n.bidi.rtlLocalesRe_.test(lang);
+};
+
+
+/**
+ * Regular expression for bracket guard replacement in html.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.bracketGuardHtmlRe_ =
+    /(\(.*?\)+)|(\[.*?\]+)|(\{.*?\}+)|(&lt;.*?(&gt;)+)/g;
+
+
+/**
+ * Regular expression for bracket guard replacement in text.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.bracketGuardTextRe_ =
+    /(\(.*?\)+)|(\[.*?\]+)|(\{.*?\}+)|(<.*?>+)/g;
+
+
+/**
+ * Apply bracket guard using html span tag. This is to address the problem of
+ * messy bracket display frequently happens in RTL layout.
+ * @param {string} s The string that need to be processed.
+ * @param {boolean=} opt_isRtlContext specifies default direction (usually
+ *     direction of the UI).
+ * @return {string} The processed string, with all bracket guarded.
+ */
+goog.i18n.bidi.guardBracketInHtml = function(s, opt_isRtlContext) {
+  var useRtl = opt_isRtlContext === undefined ?
+      goog.i18n.bidi.hasAnyRtl(s) : opt_isRtlContext;
+  if (useRtl) {
+    return s.replace(goog.i18n.bidi.bracketGuardHtmlRe_,
+        '<span dir=rtl>$&</span>');
+  }
+  return s.replace(goog.i18n.bidi.bracketGuardHtmlRe_,
+      '<span dir=ltr>$&</span>');
+};
+
+
+/**
+ * Apply bracket guard using LRM and RLM. This is to address the problem of
+ * messy bracket display frequently happens in RTL layout.
+ * This version works for both plain text and html. But it does not work as
+ * good as guardBracketInHtml in some cases.
+ * @param {string} s The string that need to be processed.
+ * @param {boolean=} opt_isRtlContext specifies default direction (usually
+ *     direction of the UI).
+ * @return {string} The processed string, with all bracket guarded.
+ */
+goog.i18n.bidi.guardBracketInText = function(s, opt_isRtlContext) {
+  var useRtl = opt_isRtlContext === undefined ?
+      goog.i18n.bidi.hasAnyRtl(s) : opt_isRtlContext;
+  var mark = useRtl ? goog.i18n.bidi.Format.RLM : goog.i18n.bidi.Format.LRM;
+  return s.replace(goog.i18n.bidi.bracketGuardTextRe_, mark + '$&' + mark);
+};
+
+
+/**
+ * Enforce the html snippet in RTL directionality regardless overall context.
+ * If the html piece was enclosed by tag, dir will be applied to existing
+ * tag, otherwise a span tag will be added as wrapper. For this reason, if
+ * html snippet start with with tag, this tag must enclose the whole piece. If
+ * the tag already has a dir specified, this new one will override existing
+ * one in behavior (tested on FF and IE).
+ * @param {string} html The string that need to be processed.
+ * @return {string} The processed string, with directionality enforced to RTL.
+ */
+goog.i18n.bidi.enforceRtlInHtml = function(html) {
+  if (html.charAt(0) == '<') {
+    return html.replace(/<\w+/, '$& dir=rtl');
+  }
+  // '\n' is important for FF so that it won't incorrectly merge span groups
+  return '\n<span dir=rtl>' + html + '</span>';
+};
+
+
+/**
+ * Enforce RTL on both end of the given text piece using unicode BiDi formatting
+ * characters RLE and PDF.
+ * @param {string} text The piece of text that need to be wrapped.
+ * @return {string} The wrapped string after process.
+ */
+goog.i18n.bidi.enforceRtlInText = function(text) {
+  return goog.i18n.bidi.Format.RLE + text + goog.i18n.bidi.Format.PDF;
+};
+
+
+/**
+ * Enforce the html snippet in RTL directionality regardless overall context.
+ * If the html piece was enclosed by tag, dir will be applied to existing
+ * tag, otherwise a span tag will be added as wrapper. For this reason, if
+ * html snippet start with with tag, this tag must enclose the whole piece. If
+ * the tag already has a dir specified, this new one will override existing
+ * one in behavior (tested on FF and IE).
+ * @param {string} html The string that need to be processed.
+ * @return {string} The processed string, with directionality enforced to RTL.
+ */
+goog.i18n.bidi.enforceLtrInHtml = function(html) {
+  if (html.charAt(0) == '<') {
+    return html.replace(/<\w+/, '$& dir=ltr');
+  }
+  // '\n' is important for FF so that it won't incorrectly merge span groups
+  return '\n<span dir=ltr>' + html + '</span>';
+};
+
+
+/**
+ * Enforce LTR on both end of the given text piece using unicode BiDi formatting
+ * characters LRE and PDF.
+ * @param {string} text The piece of text that need to be wrapped.
+ * @return {string} The wrapped string after process.
+ */
+goog.i18n.bidi.enforceLtrInText = function(text) {
+  return goog.i18n.bidi.Format.LRE + text + goog.i18n.bidi.Format.PDF;
+};
+
+
+/**
+ * Regular expression to find dimensions such as "padding: .3 0.4ex 5px 6;"
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.dimensionsRe_ =
+    /:\s*([.\d][.\w]*)\s+([.\d][.\w]*)\s+([.\d][.\w]*)\s+([.\d][.\w]*)/g;
+
+
+/**
+ * Regular expression for left.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.leftRe_ = /left/gi;
+
+
+/**
+ * Regular expression for right.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.rightRe_ = /right/gi;
+
+
+/**
+ * Placeholder regular expression for swapping.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.tempRe_ = /%%%%/g;
+
+
+/**
+ * Swap location parameters and 'left'/'right' in CSS specification. The
+ * processed string will be suited for RTL layout. Though this function can
+ * cover most cases, there are always exceptions. It is suggested to put
+ * those exceptions in separate group of CSS string.
+ * @param {string} cssStr CSS spefication string.
+ * @return {string} Processed CSS specification string.
+ */
+goog.i18n.bidi.mirrorCSS = function(cssStr) {
+  return cssStr.
+      // reverse dimensions
+      replace(goog.i18n.bidi.dimensionsRe_, ':$1 $4 $3 $2').
+      replace(goog.i18n.bidi.leftRe_, '%%%%').          // swap left and right
+      replace(goog.i18n.bidi.rightRe_, goog.i18n.bidi.LEFT).
+      replace(goog.i18n.bidi.tempRe_, goog.i18n.bidi.RIGHT);
+};
+
+
+/**
+ * Regular expression for hebrew double quote substitution, finding quote
+ * directly after hebrew characters.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.doubleQuoteSubstituteRe_ = /([\u0591-\u05f2])"/g;
+
+
+/**
+ * Regular expression for hebrew single quote substitution, finding quote
+ * directly after hebrew characters.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.singleQuoteSubstituteRe_ = /([\u0591-\u05f2])'/g;
+
+
+/**
+ * Replace the double and single quote directly after a Hebrew character with
+ * GERESH and GERSHAYIM. In such case, most likely that's user intention.
+ * @param {string} str String that need to be processed.
+ * @return {string} Processed string with double/single quote replaced.
+ */
+goog.i18n.bidi.normalizeHebrewQuote = function(str) {
+  return str.
+      replace(goog.i18n.bidi.doubleQuoteSubstituteRe_, '$1\u05f4').
+      replace(goog.i18n.bidi.singleQuoteSubstituteRe_, '$1\u05f3');
+};
+
+
+/**
+ * Regular expression to split a string into "words" for directionality
+ * estimation based on relative word counts.
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.wordSeparatorRe_ = /\s+/;
+
+
+/**
+ * Regular expression to check if a string contains any numerals. Used to
+ * differentiate between completely neutral strings and those containing
+ * numbers, which are weakly LTR.
+ *
+ * Native Arabic digits (\u0660 - \u0669) are not included because although they
+ * do flow left-to-right inside a number, this is the case even if the  overall
+ * directionality is RTL, and a mathematical expression using these digits is
+ * supposed to flow right-to-left overall, including unary plus and minus
+ * appearing to the right of a number, and this does depend on the overall
+ * directionality being RTL. The digits used in Farsi (\u06F0 - \u06F9), on the
+ * other hand, are included, since Farsi math (including unary plus and minus)
+ * does flow left-to-right.
+ *
+ * @type {RegExp}
+ * @private
+ */
+goog.i18n.bidi.hasNumeralsRe_ = /[\d\u06f0-\u06f9]/;
+
+
+/**
+ * This constant controls threshold of RTL directionality.
+ * @type {number}
+ * @private
+ */
+goog.i18n.bidi.rtlDetectionThreshold_ = 0.40;
+
+
+/**
+ * Estimates the directionality of a string based on relative word counts.
+ * If the number of RTL words is above a certain percentage of the total number
+ * of strongly directional words, returns RTL.
+ * Otherwise, if any words are strongly or weakly LTR, returns LTR.
+ * Otherwise, returns UNKNOWN, which is used to mean "neutral".
+ * Numbers are counted as weakly LTR.
+ * @param {string} str The string to be checked.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {goog.i18n.bidi.Dir} Estimated overall directionality of {@code str}.
+ */
+goog.i18n.bidi.estimateDirection = function(str, opt_isHtml) {
+  var rtlCount = 0;
+  var totalCount = 0;
+  var hasWeaklyLtr = false;
+  var tokens = goog.i18n.bidi.stripHtmlIfNeeded_(str, opt_isHtml).
+      split(goog.i18n.bidi.wordSeparatorRe_);
+  for (var i = 0; i < tokens.length; i++) {
+    var token = tokens[i];
+    if (goog.i18n.bidi.startsWithRtl(token)) {
+      rtlCount++;
+      totalCount++;
+    } else if (goog.i18n.bidi.isRequiredLtrRe_.test(token)) {
+      hasWeaklyLtr = true;
+    } else if (goog.i18n.bidi.hasAnyLtr(token)) {
+      totalCount++;
+    } else if (goog.i18n.bidi.hasNumeralsRe_.test(token)) {
+      hasWeaklyLtr = true;
+    }
+  }
+
+  return totalCount == 0 ?
+      (hasWeaklyLtr ? goog.i18n.bidi.Dir.LTR : goog.i18n.bidi.Dir.NEUTRAL) :
+      (rtlCount / totalCount > goog.i18n.bidi.rtlDetectionThreshold_ ?
+          goog.i18n.bidi.Dir.RTL : goog.i18n.bidi.Dir.LTR);
+};
+
+
+/**
+ * Check the directionality of a piece of text, return true if the piece of
+ * text should be laid out in RTL direction.
+ * @param {string} str The piece of text that need to be detected.
+ * @param {boolean=} opt_isHtml Whether str is HTML / HTML-escaped.
+ *     Default: false.
+ * @return {boolean} Whether this piece of text should be laid out in RTL.
+ */
+goog.i18n.bidi.detectRtlDirectionality = function(str, opt_isHtml) {
+  return goog.i18n.bidi.estimateDirection(str, opt_isHtml) ==
+      goog.i18n.bidi.Dir.RTL;
+};
+
+
+/**
+ * Sets text input element's directionality and text alignment based on a
+ * given directionality. Does nothing if the given directionality is unknown or
+ * neutral.
+ * @param {Element} element Input field element to set directionality to.
+ * @param {goog.i18n.bidi.Dir|number|boolean|null} dir Desired directionality,
+ *     given in one of the following formats:
+ *     1. A goog.i18n.bidi.Dir constant.
+ *     2. A number (positive = LRT, negative = RTL, 0 = neutral).
+ *     3. A boolean (true = RTL, false = LTR).
+ *     4. A null for unknown directionality.
+ */
+goog.i18n.bidi.setElementDirAndAlign = function(element, dir) {
+  if (element) {
+    dir = goog.i18n.bidi.toDir(dir);
+    if (dir) {
+      element.style.textAlign =
+          dir == goog.i18n.bidi.Dir.RTL ?
+          goog.i18n.bidi.RIGHT : goog.i18n.bidi.LEFT;
+      element.dir = dir == goog.i18n.bidi.Dir.RTL ? 'rtl' : 'ltr';
+    }
+  }
+};
+
+
+/**
+ * Sets element dir based on estimated directionality of the given text.
+ * @param {!Element} element
+ * @param {string} text
+ */
+goog.i18n.bidi.setElementDirByTextDirectionality = function(element, text) {
+  switch (goog.i18n.bidi.estimateDirection(text)) {
+    case (goog.i18n.bidi.Dir.LTR):
+      element.dir = 'ltr';
+      break;
+    case (goog.i18n.bidi.Dir.RTL):
+      element.dir = 'rtl';
+      break;
+    default:
+      // Default for no direction, inherit from document.
+      element.removeAttribute('dir');
+  }
+};
+
+
+
+/**
+ * Strings that have an (optional) known direction.
+ *
+ * Implementations of this interface are string-like objects that carry an
+ * attached direction, if known.
+ * @interface
+ */
+goog.i18n.bidi.DirectionalString = function() {};
+
+
+/**
+ * Interface marker of the DirectionalString interface.
+ *
+ * This property can be used to determine at runtime whether or not an object
+ * implements this interface.  All implementations of this interface set this
+ * property to {@code true}.
+ * @type {boolean}
+ */
+goog.i18n.bidi.DirectionalString.prototype.
+    implementsGoogI18nBidiDirectionalString;
+
+
+/**
+ * Retrieves this object's known direction (if any).
+ * @return {?goog.i18n.bidi.Dir} The known direction. Null if unknown.
+ */
+goog.i18n.bidi.DirectionalString.prototype.getDirection;
diff --git a/lib/goog/iter/iter.js b/lib/goog/iter/iter.js
index f9a0dcc..5d91327 100644
--- a/lib/goog/iter/iter.js
+++ b/lib/goog/iter/iter.js
@@ -19,15 +19,14 @@
 
 
 goog.provide('goog.iter');
+goog.provide('goog.iter.Iterable');
 goog.provide('goog.iter.Iterator');
 goog.provide('goog.iter.StopIteration');
 
 goog.require('goog.array');
 goog.require('goog.asserts');
-
-
-// TODO(nnaze): Add more functions from Python's itertools.
-// http://docs.python.org/library/itertools.html
+goog.require('goog.functions');
+goog.require('goog.math');
 
 
 /**
@@ -36,21 +35,14 @@ goog.require('goog.asserts');
 goog.iter.Iterable;
 
 
-// For script engines that already support iterators.
-if ('StopIteration' in goog.global) {
-  /**
-   * Singleton Error object that is used to terminate iterations.
-   * @type {Error}
-   */
-  goog.iter.StopIteration = goog.global['StopIteration'];
-} else {
-  /**
-   * Singleton Error object that is used to terminate iterations.
-   * @type {Error}
-   * @suppress {duplicate}
-   */
-  goog.iter.StopIteration = Error('StopIteration');
-}
+/**
+ * Singleton Error object that is used to terminate iterations.
+ * @const {!Error}
+ */
+goog.iter.StopIteration = ('StopIteration' in goog.global) ?
+    // For script engines that support legacy iterators.
+    goog.global['StopIteration'] :
+    { message: 'StopIteration', stack: ''};
 
 
 
@@ -61,6 +53,7 @@ if ('StopIteration' in goog.global) {
  * It is recommended to always use the helper functions to iterate over the
  * iterator or in case you are only targeting JavaScript 1.7 for in loops.
  * @constructor
+ * @template VALUE
  */
 goog.iter.Iterator = function() {};
 
@@ -68,7 +61,7 @@ goog.iter.Iterator = function() {};
 /**
  * Returns the next value of the iteration.  This will throw the object
  * {@see goog.iter#StopIteration} when the iteration passes the end.
- * @return {*} Any object or value.
+ * @return {VALUE} Any object or value.
  */
 goog.iter.Iterator.prototype.next = function() {
   throw goog.iter.StopIteration;
@@ -83,7 +76,7 @@ goog.iter.Iterator.prototype.next = function() {
  *     and the for-each-in loop (false).  Even though the param gives a hint
  *     about what the iterator will return there is no guarantee that it will
  *     return the keys when true is passed.
- * @return {!goog.iter.Iterator} The object itself.
+ * @return {!goog.iter.Iterator<VALUE>} The object itself.
  */
 goog.iter.Iterator.prototype.__iterator__ = function(opt_keys) {
   return this;
@@ -92,12 +85,14 @@ goog.iter.Iterator.prototype.__iterator__ = function(opt_keys) {
 
 /**
  * Returns an iterator that knows how to iterate over the values in the object.
- * @param {goog.iter.Iterable} iterable  If the object is an iterator it
- *     will be returned as is.  If the object has a {@code __iterator__} method
- *     that will be called to get the value iterator.  If the object is an
- *     array-like object we create an iterator for that.
- * @return {!goog.iter.Iterator} An iterator that knows how to iterate over the
- *     values in {@code iterable}.
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable  If the
+ *     object is an iterator it will be returned as is.  If the object has an
+ *     {@code __iterator__} method that will be called to get the value
+ *     iterator.  If the object is an array-like object we create an iterator
+ *     for that.
+ * @return {!goog.iter.Iterator<VALUE>} An iterator that knows how to iterate
+ *     over the values in {@code iterable}.
+ * @template VALUE
  */
 goog.iter.toIterator = function(iterable) {
   if (iterable instanceof goog.iter.Iterator) {
@@ -135,18 +130,19 @@ goog.iter.toIterator = function(iterable) {
  * Calls a function for each element in the iterator with the element of the
  * iterator passed as argument.
  *
- * @param {goog.iter.Iterable} iterable  The iterator to iterate
- *     over.  If the iterable is an object {@code toIterator} will be called on
- *     it.
-* @param {function(this:T,?,?,?):?} f  The function to call for every
- *     element.  This function
- *     takes 3 arguments (the element, undefined, and the iterator) and the
- *     return value is irrelevant.  The reason for passing undefined as the
- *     second argument is so that the same function can be used in
- *     {@see goog.array#forEach} as well as others.
- * @param {T=} opt_obj  The object to be used as the value of 'this' within
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable  The iterator
+ *     to iterate over. If the iterable is an object {@code toIterator} will be
+ *     called on it.
+ * @param {function(this:THIS,VALUE,?,!goog.iter.Iterator<VALUE>)} f
+ *     The function to call for every element.  This function takes 3 arguments
+ *     (the element, undefined, and the iterator) and the return value is
+ *     irrelevant.  The reason for passing undefined as the second argument is
+ *     so that the same function can be used in {@see goog.array#forEach} as
+ *     well as others.  The third parameter is of type "number" for
+ *     arraylike objects, undefined, otherwise.
+ * @param {THIS=} opt_obj  The object to be used as the value of 'this' within
  *     {@code f}.
- * @template T
+ * @template THIS, VALUE
  */
 goog.iter.forEach = function(iterable, f, opt_obj) {
   if (goog.isArrayLike(iterable)) {
@@ -181,18 +177,19 @@ goog.iter.forEach = function(iterable, f, opt_obj) {
  * Calls a function for every element in the iterator, and if the function
  * returns true adds the element to a new iterator.
  *
- * @param {goog.iter.Iterable} iterable The iterator to iterate over.
- * @param {function(this:T,?,undefined,?):boolean} f The function to call for
- *     every element. This function
- *     takes 3 arguments (the element, undefined, and the iterator) and should
- *     return a boolean.  If the return value is true the element will be
- *     included  in the returned iteror.  If it is false the element is not
- *     included.
- * @param {T=} opt_obj The object to be used as the value of 'this' within
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     to iterate over.
+ * @param {
+ *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator<VALUE>):boolean} f
+ *     The function to call for every element. This function takes 3 arguments
+ *     (the element, undefined, and the iterator) and should return a boolean.
+ *     If the return value is true the element will be included in the returned
+ *     iterator.  If it is false the element is not included.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this' within
  *     {@code f}.
- * @return {!goog.iter.Iterator} A new iterator in which only elements that
- *     passed the test are present.
- * @template T
+ * @return {!goog.iter.Iterator<VALUE>} A new iterator in which only elements
+ *     that passed the test are present.
+ * @template THIS, VALUE
  */
 goog.iter.filter = function(iterable, f, opt_obj) {
   var iterator = goog.iter.toIterator(iterable);
@@ -209,6 +206,29 @@ goog.iter.filter = function(iterable, f, opt_obj) {
 };
 
 
+/**
+ * Calls a function for every element in the iterator, and if the function
+ * returns false adds the element to a new iterator.
+ *
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     to iterate over.
+ * @param {
+ *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator<VALUE>):boolean} f
+ *     The function to call for every element. This function takes 3 arguments
+ *     (the element, undefined, and the iterator) and should return a boolean.
+ *     If the return value is false the element will be included in the returned
+ *     iterator.  If it is true the element is not included.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this' within
+ *     {@code f}.
+ * @return {!goog.iter.Iterator<VALUE>} A new iterator in which only elements
+ *     that did not pass the test are present.
+ * @template THIS, VALUE
+ */
+goog.iter.filterFalse = function(iterable, f, opt_obj) {
+  return goog.iter.filter(iterable, goog.functions.not(f), opt_obj);
+};
+
+
 /**
  * Creates a new iterator that returns the values in a range.  This function
  * can take 1, 2 or 3 arguments:
@@ -224,8 +244,8 @@ goog.iter.filter = function(iterable, f, opt_obj) {
  *     argument is used as the stop value.
  * @param {number=} opt_step  The number to increment with between each call to
  *     next.  This can be negative.
- * @return {!goog.iter.Iterator} A new iterator that returns the values in the
- *     range.
+ * @return {!goog.iter.Iterator<number>} A new iterator that returns the values
+ *     in the range.
  */
 goog.iter.range = function(startOrStop, opt_stop, opt_step) {
   var start = 0;
@@ -254,9 +274,11 @@ goog.iter.range = function(startOrStop, opt_stop, opt_step) {
 
 /**
  * Joins the values in a iterator with a delimiter.
- * @param {goog.iter.Iterable} iterable  The iterator to get the values from.
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     to get the values from.
  * @param {string} deliminator  The text to put between the values.
  * @return {string} The joined value string.
+ * @template VALUE
  */
 goog.iter.join = function(iterable, deliminator) {
   return goog.iter.toArray(iterable).join(deliminator);
@@ -267,25 +289,25 @@ goog.iter.join = function(iterable, deliminator) {
  * For every element in the iterator call a function and return a new iterator
  * with that value.
  *
- * @param {goog.iter.Iterable} iterable The iterator to iterate over.
- * @param {function(this:T,?,undefined,?):?} f The function to call for every
- *     element.  This function
- *     takes 3 arguments (the element, undefined, and the iterator) and should
- *     return a new value.
- * @param {T=} opt_obj The object to be used as the value of 'this' within
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterator to iterate over.
+ * @param {
+ *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator<VALUE>):RESULT} f
+ *     The function to call for every element.  This function takes 3 arguments
+ *     (the element, undefined, and the iterator) and should return a new value.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this' within
  *     {@code f}.
- * @return {!goog.iter.Iterator} A new iterator that returns the results of
- *     applying the function to each element in the original iterator.
- * @template T
+ * @return {!goog.iter.Iterator<RESULT>} A new iterator that returns the
+ *     results of applying the function to each element in the original
+ *     iterator.
+ * @template THIS, VALUE, RESULT
  */
 goog.iter.map = function(iterable, f, opt_obj) {
   var iterator = goog.iter.toIterator(iterable);
   var newIter = new goog.iter.Iterator;
   newIter.next = function() {
-    while (true) {
-      var val = iterator.next();
-      return f.call(opt_obj, val, undefined, iterator);
-    }
+    var val = iterator.next();
+    return f.call(opt_obj, val, undefined, iterator);
   };
   return newIter;
 };
@@ -295,17 +317,19 @@ goog.iter.map = function(iterable, f, opt_obj) {
  * Passes every element of an iterator into a function and accumulates the
  * result.
  *
- * @param {goog.iter.Iterable} iterable The iterator to iterate over.
- * @param {function(this:T,V,?):V} f The function to call for every
- *     element. This function takes 2 arguments (the function's previous result
- *     or the initial value, and the value of the current element).
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     to iterate over.
+ * @param {function(this:THIS,VALUE,VALUE):VALUE} f The function to call for
+ *     every element. This function takes 2 arguments (the function's previous
+ *     result or the initial value, and the value of the current element).
  *     function(previousValue, currentElement) : newValue.
- * @param {V} val The initial value to pass into the function on the first call.
- * @param {T=} opt_obj  The object to be used as the value of 'this'
- *     within f.
- * @return {V} Result of evaluating f repeatedly across the values of
+ * @param {VALUE} val The initial value to pass into the function on the first
+ *     call.
+ * @param {THIS=} opt_obj  The object to be used as the value of 'this' within
+ *     f.
+ * @return {VALUE} Result of evaluating f repeatedly across the values of
  *     the iterator.
- * @template T,V
+ * @template THIS, VALUE
  */
 goog.iter.reduce = function(iterable, f, val, opt_obj) {
   var rval = val;
@@ -317,19 +341,20 @@ goog.iter.reduce = function(iterable, f, val, opt_obj) {
 
 
 /**
- * Goes through the values in the iterator. Calls f for each these and if any of
- * them returns true, this returns true (without checking the rest). If all
- * return false this will return false.
+ * Goes through the values in the iterator. Calls f for each of these, and if
+ * any of them returns true, this returns true (without checking the rest). If
+ * all return false this will return false.
  *
- * @param {goog.iter.Iterable} iterable  The iterator object.
- * @param {function(this:T,?,undefined,?):boolean} f  The function to call for
- *     every value. This function
- *     takes 3 arguments (the value, undefined, and the iterator) and should
- *     return a boolean.
- * @param {T=} opt_obj The object to be used as the value of 'this' within
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     object.
+ * @param {
+ *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator<VALUE>):boolean} f
+ *     The function to call for every value. This function takes 3 arguments
+ *     (the value, undefined, and the iterator) and should return a boolean.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this' within
  *     {@code f}.
  * @return {boolean} true if any value passes the test.
- * @template T
+ * @template THIS, VALUE
  */
 goog.iter.some = function(iterable, f, opt_obj) {
   iterable = goog.iter.toIterator(iterable);
@@ -350,19 +375,20 @@ goog.iter.some = function(iterable, f, opt_obj) {
 
 
 /**
- * Goes through the values in the iterator. Calls f for each these and if any of
- * them returns false this returns false (without checking the rest). If all
+ * Goes through the values in the iterator. Calls f for each of these and if any
+ * of them returns false this returns false (without checking the rest). If all
  * return true this will return true.
  *
- * @param {goog.iter.Iterable} iterable  The iterator object.
- * @param {function(this:T,?,undefined,?):boolean} f  The function to call for
- *     every value. This function
- *     takes 3 arguments (the value, undefined, and the iterator) and should
- *     return a boolean.
- * @param {T=} opt_obj The object to be used as the value of 'this' within
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     object.
+ * @param {
+ *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator<VALUE>):boolean} f
+ *     The function to call for every value. This function takes 3 arguments
+ *     (the value, undefined, and the iterator) and should return a boolean.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this' within
  *     {@code f}.
  * @return {boolean} true if every value passes the test.
- * @template T
+ * @template THIS, VALUE
  */
 goog.iter.every = function(iterable, f, opt_obj) {
   iterable = goog.iter.toIterator(iterable);
@@ -383,58 +409,69 @@ goog.iter.every = function(iterable, f, opt_obj) {
 
 
 /**
- * Takes zero or more iterators and returns one iterator that will iterate over
+ * Takes zero or more iterables and returns one iterator that will iterate over
  * them in the order chained.
- * @param {...goog.iter.Iterator} var_args  Any number of iterator objects.
- * @return {!goog.iter.Iterator} Returns a new iterator that will iterate over
- *     all the given iterators' contents.
+ * @param {...!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} var_args Any
+ *     number of iterable objects.
+ * @return {!goog.iter.Iterator<VALUE>} Returns a new iterator that will
+ *     iterate over all the given iterables' contents.
+ * @template VALUE
  */
 goog.iter.chain = function(var_args) {
-  var args = arguments;
-  var length = args.length;
-  var i = 0;
-  var newIter = new goog.iter.Iterator;
+  return goog.iter.chainFromIterable(arguments);
+};
 
-  /**
-   * @return {*} The next item in the iteration.
-   * @this {goog.iter.Iterator}
-   */
-  newIter.next = function() {
-    /** @preserveTry */
-    try {
-      if (i >= length) {
-        throw goog.iter.StopIteration;
+
+/**
+ * Takes a single iterable containing zero or more iterables and returns one
+ * iterator that will iterate over each one in the order given.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.chain.from_iterable
+ * @param {goog.iter.Iterable} iterable The iterable of iterables to chain.
+ * @return {!goog.iter.Iterator<VALUE>} Returns a new iterator that will
+ *     iterate over all the contents of the iterables contained within
+ *     {@code iterable}.
+ * @template VALUE
+ */
+goog.iter.chainFromIterable = function(iterable) {
+  var iterator = goog.iter.toIterator(iterable);
+  var iter = new goog.iter.Iterator();
+  var current = null;
+
+  iter.next = function() {
+    while (true) {
+      if (current == null) {
+        var it = iterator.next();
+        current = goog.iter.toIterator(it);
       }
-      var current = goog.iter.toIterator(args[i]);
-      return current.next();
-    } catch (ex) {
-      if (ex !== goog.iter.StopIteration || i >= length) {
-        throw ex;
-      } else {
-        // In case we got a StopIteration increment counter and try again.
-        i++;
-        return this.next();
+      try {
+        return current.next();
+      } catch (ex) {
+        if (ex !== goog.iter.StopIteration) {
+          throw ex;
+        }
+        current = null;
       }
     }
   };
 
-  return newIter;
+  return iter;
 };
 
 
 /**
  * Builds a new iterator that iterates over the original, but skips elements as
  * long as a supplied function returns true.
- * @param {goog.iter.Iterable} iterable  The iterator object.
- * @param {function(this:T,?,undefined,?):boolean} f  The function to call for
- *     every value. This function
- *     takes 3 arguments (the value, undefined, and the iterator) and should
- *     return a boolean.
- * @param {T=} opt_obj The object to be used as the value of 'this' within
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     object.
+ * @param {
+ *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator<VALUE>):boolean} f
+ *     The function to call for every value. This function takes 3 arguments
+ *     (the value, undefined, and the iterator) and should return a boolean.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this' within
  *     {@code f}.
- * @return {!goog.iter.Iterator} A new iterator that drops elements from the
- *     original iterator as long as {@code f} is true.
- * @template T
+ * @return {!goog.iter.Iterator<VALUE>} A new iterator that drops elements from
+ *     the original iterator as long as {@code f} is true.
+ * @template THIS, VALUE
  */
 goog.iter.dropWhile = function(iterable, f, opt_obj) {
   var iterator = goog.iter.toIterator(iterable);
@@ -458,42 +495,37 @@ goog.iter.dropWhile = function(iterable, f, opt_obj) {
 /**
  * Builds a new iterator that iterates over the original, but only as long as a
  * supplied function returns true.
- * @param {goog.iter.Iterable} iterable  The iterator object.
- * @param {function(this:T,?,undefined,?):boolean} f  The function to call for
- *     every value. This function
- *     takes 3 arguments (the value, undefined, and the iterator) and should
- *     return a boolean.
- * @param {T=} opt_obj This is used as the 'this' object in f when called.
- * @return {!goog.iter.Iterator} A new iterator that keeps elements in the
- *     original iterator as long as the function is true.
- * @template T
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     object.
+ * @param {
+ *     function(this:THIS,VALUE,undefined,!goog.iter.Iterator<VALUE>):boolean} f
+ *     The function to call for every value. This function takes 3 arguments
+ *     (the value, undefined, and the iterator) and should return a boolean.
+ * @param {THIS=} opt_obj This is used as the 'this' object in f when called.
+ * @return {!goog.iter.Iterator<VALUE>} A new iterator that keeps elements in
+ *     the original iterator as long as the function is true.
+ * @template THIS, VALUE
  */
 goog.iter.takeWhile = function(iterable, f, opt_obj) {
   var iterator = goog.iter.toIterator(iterable);
-  var newIter = new goog.iter.Iterator;
-  var taking = true;
-  newIter.next = function() {
-    while (true) {
-      if (taking) {
-        var val = iterator.next();
-        if (f.call(opt_obj, val, undefined, iterator)) {
-          return val;
-        } else {
-          taking = false;
-        }
-      } else {
-        throw goog.iter.StopIteration;
-      }
+  var iter = new goog.iter.Iterator();
+  iter.next = function() {
+    var val = iterator.next();
+    if (f.call(opt_obj, val, undefined, iterator)) {
+      return val;
     }
+    throw goog.iter.StopIteration;
   };
-  return newIter;
+  return iter;
 };
 
 
 /**
  * Converts the iterator to an array
- * @param {goog.iter.Iterable} iterable  The iterator to convert to an array.
- * @return {!Array} An array of the elements the iterator iterates over.
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterator
+ *     to convert to an array.
+ * @return {!Array<VALUE>} An array of the elements the iterator iterates over.
+ * @template VALUE
  */
 goog.iter.toArray = function(iterable) {
   // Fast path for array-like.
@@ -510,65 +542,40 @@ goog.iter.toArray = function(iterable) {
 
 
 /**
- * Iterates over 2 iterators and returns true if they contain the same sequence
- * of elements and have the same length.
- * @param {goog.iter.Iterable} iterable1  The first iterable object.
- * @param {goog.iter.Iterable} iterable2  The second iterable object.
- * @return {boolean} true if the iterators contain the same sequence of
- *     elements and have the same length.
+ * Iterates over two iterables and returns true if they contain the same
+ * sequence of elements and have the same length.
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable1 The first
+ *     iterable object.
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable2 The second
+ *     iterable object.
+ * @param {function(VALUE,VALUE):boolean=} opt_equalsFn Optional comparison
+ *     function.
+ *     Should take two arguments to compare, and return true if the arguments
+ *     are equal. Defaults to {@link goog.array.defaultCompareEquality} which
+ *     compares the elements using the built-in '===' operator.
+ * @return {boolean} true if the iterables contain the same sequence of elements
+ *     and have the same length.
+ * @template VALUE
  */
-goog.iter.equals = function(iterable1, iterable2) {
-  iterable1 = goog.iter.toIterator(iterable1);
-  iterable2 = goog.iter.toIterator(iterable2);
-  var b1, b2;
-  /** @preserveTry */
-  try {
-    while (true) {
-      b1 = b2 = false;
-      var val1 = iterable1.next();
-      b1 = true;
-      var val2 = iterable2.next();
-      b2 = true;
-      if (val1 != val2) {
-        return false;
-      }
-    }
-  } catch (ex) {
-    if (ex !== goog.iter.StopIteration) {
-      throw ex;
-    } else {
-      if (b1 && !b2) {
-        // iterable1 done but iterable2 is not done.
-        return false;
-      }
-      if (!b2) {
-        /** @preserveTry */
-        try {
-          // iterable2 not done?
-          val2 = iterable2.next();
-          // iterable2 not done but iterable1 is done
-          return false;
-        } catch (ex1) {
-          if (ex1 !== goog.iter.StopIteration) {
-            throw ex1;
-          }
-          // iterable2 done as well... They are equal
-          return true;
-        }
-      }
-    }
-  }
-  return false;
+goog.iter.equals = function(iterable1, iterable2, opt_equalsFn) {
+  var fillValue = {};
+  var pairs = goog.iter.zipLongest(fillValue, iterable1, iterable2);
+  var equalsFn = opt_equalsFn || goog.array.defaultCompareEquality;
+  return goog.iter.every(pairs, function(pair) {
+    return equalsFn(pair[0], pair[1]);
+  });
 };
 
 
 /**
  * Advances the iterator to the next position, returning the given default value
  * instead of throwing an exception if the iterator has no more entries.
- * @param {goog.iter.Iterable} iterable The iterable object.
- * @param {*} defaultValue The value to return if the iterator is empty.
- * @return {*} The next item in the iteration, or defaultValue if the iterator
- *     was empty.
+ * @param {goog.iter.Iterator<VALUE>|goog.iter.Iterable} iterable The iterable
+ *     object.
+ * @param {VALUE} defaultValue The value to return if the iterator is empty.
+ * @return {VALUE} The next item in the iteration, or defaultValue if the
+ *     iterator was empty.
+ * @template VALUE
  */
 goog.iter.nextOrValue = function(iterable, defaultValue) {
   try {
@@ -587,9 +594,11 @@ goog.iter.nextOrValue = function(iterable, defaultValue) {
  * combination of one element chosen from each set.  For example,
  * ([1, 2], [3, 4]) gives ([1, 3], [1, 4], [2, 3], [2, 4]).
  * @see http://docs.python.org/library/itertools.html#itertools.product
- * @param {...!goog.array.ArrayLike.<*>} var_args Zero or more sets, as arrays.
- * @return {!goog.iter.Iterator} An iterator that gives each n-tuple (as an
- *     array).
+ * @param {...!goog.array.ArrayLike<VALUE>} var_args Zero or more sets, as
+ *     arrays.
+ * @return {!goog.iter.Iterator<!Array<VALUE>>} An iterator that gives each
+ *     n-tuple (as an array).
+ * @template VALUE
  */
 goog.iter.product = function(var_args) {
   var someArrayEmpty = goog.array.some(arguments, function(arr) {
@@ -604,7 +613,7 @@ goog.iter.product = function(var_args) {
   var iter = new goog.iter.Iterator();
   var arrays = arguments;
 
-  // The first indicies are [0, 0, ...]
+  // The first indices are [0, 0, ...]
   var indicies = goog.array.repeat(0, arrays.length);
 
   iter.next = function() {
@@ -614,7 +623,7 @@ goog.iter.product = function(var_args) {
         return arrays[arrayIndex][valueIndex];
       });
 
-      // Generate the next-largest indicies for the next call.
+      // Generate the next-largest indices for the next call.
       // Increase the rightmost index. If it goes over, increase the next
       // rightmost (like carry-over addition).
       for (var i = indicies.length - 1; i >= 0; i--) {
@@ -625,7 +634,7 @@ goog.iter.product = function(var_args) {
           break;
         }
 
-        // We're at the last indicies (the last element of every array), so
+        // We're at the last indices (the last element of every array), so
         // the iteration is over on the next call.
         if (i == 0) {
           indicies = null;
@@ -649,12 +658,13 @@ goog.iter.product = function(var_args) {
  * Create an iterator to cycle over the iterable's elements indefinitely.
  * For example, ([1, 2, 3]) would return : 1, 2, 3, 1, 2, 3, ...
  * @see: http://docs.python.org/library/itertools.html#itertools.cycle.
- * @param {!goog.iter.Iterable} iterable The iterable object.
- * @return {!goog.iter.Iterator} An iterator that iterates indefinitely over
- * the values in {@code iterable}.
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable object.
+ * @return {!goog.iter.Iterator<VALUE>} An iterator that iterates indefinitely
+ *     over the values in {@code iterable}.
+ * @template VALUE
  */
 goog.iter.cycle = function(iterable) {
-
   var baseIterator = goog.iter.toIterator(iterable);
 
   // We maintain a cache to store the iterable elements as we iterate
@@ -700,3 +710,593 @@ goog.iter.cycle = function(iterable) {
 
   return iter;
 };
+
+
+/**
+ * Creates an iterator that counts indefinitely from a starting value.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.count
+ * @param {number=} opt_start The starting value. Default is 0.
+ * @param {number=} opt_step The number to increment with between each call to
+ *     next. Negative and floating point numbers are allowed. Default is 1.
+ * @return {!goog.iter.Iterator<number>} A new iterator that returns the values
+ *     in the series.
+ */
+goog.iter.count = function(opt_start, opt_step) {
+  var counter = opt_start || 0;
+  var step = goog.isDef(opt_step) ? opt_step : 1;
+  var iter = new goog.iter.Iterator();
+
+  iter.next = function() {
+    var returnValue = counter;
+    counter += step;
+    return returnValue;
+  };
+
+  return iter;
+};
+
+
+/**
+ * Creates an iterator that returns the same object or value repeatedly.
+ * @param {VALUE} value Any object or value to repeat.
+ * @return {!goog.iter.Iterator<VALUE>} A new iterator that returns the
+ *     repeated value.
+ * @template VALUE
+ */
+goog.iter.repeat = function(value) {
+  var iter = new goog.iter.Iterator();
+
+  iter.next = goog.functions.constant(value);
+
+  return iter;
+};
+
+
+/**
+ * Creates an iterator that returns running totals from the numbers in
+ * {@code iterable}. For example, the array {@code [1, 2, 3, 4, 5]} yields
+ * {@code 1 -> 3 -> 6 -> 10 -> 15}.
+ * @see http://docs.python.org/3.2/library/itertools.html#itertools.accumulate
+ * @param {!goog.iter.Iterable<number>} iterable The iterable of numbers to
+ *     accumulate.
+ * @return {!goog.iter.Iterator<number>} A new iterator that returns the
+ *     numbers in the series.
+ */
+goog.iter.accumulate = function(iterable) {
+  var iterator = goog.iter.toIterator(iterable);
+  var total = 0;
+  var iter = new goog.iter.Iterator();
+
+  iter.next = function() {
+    total += iterator.next();
+    return total;
+  };
+
+  return iter;
+};
+
+
+/**
+ * Creates an iterator that returns arrays containing the ith elements from the
+ * provided iterables. The returned arrays will be the same size as the number
+ * of iterables given in {@code var_args}. Once the shortest iterable is
+ * exhausted, subsequent calls to {@code next()} will throw
+ * {@code goog.iter.StopIteration}.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.izip
+ * @param {...!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} var_args Any
+ *     number of iterable objects.
+ * @return {!goog.iter.Iterator<!Array<VALUE>>} A new iterator that returns
+ *     arrays of elements from the provided iterables.
+ * @template VALUE
+ */
+goog.iter.zip = function(var_args) {
+  var args = arguments;
+  var iter = new goog.iter.Iterator();
+
+  if (args.length > 0) {
+    var iterators = goog.array.map(args, goog.iter.toIterator);
+    iter.next = function() {
+      var arr = goog.array.map(iterators, function(it) {
+        return it.next();
+      });
+      return arr;
+    };
+  }
+
+  return iter;
+};
+
+
+/**
+ * Creates an iterator that returns arrays containing the ith elements from the
+ * provided iterables. The returned arrays will be the same size as the number
+ * of iterables given in {@code var_args}. Shorter iterables will be extended
+ * with {@code fillValue}. Once the longest iterable is exhausted, subsequent
+ * calls to {@code next()} will throw {@code goog.iter.StopIteration}.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.izip_longest
+ * @param {VALUE} fillValue The object or value used to fill shorter iterables.
+ * @param {...!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} var_args Any
+ *     number of iterable objects.
+ * @return {!goog.iter.Iterator<!Array<VALUE>>} A new iterator that returns
+ *     arrays of elements from the provided iterables.
+ * @template VALUE
+ */
+goog.iter.zipLongest = function(fillValue, var_args) {
+  var args = goog.array.slice(arguments, 1);
+  var iter = new goog.iter.Iterator();
+
+  if (args.length > 0) {
+    var iterators = goog.array.map(args, goog.iter.toIterator);
+
+    iter.next = function() {
+      var iteratorsHaveValues = false;  // false when all iterators are empty.
+      var arr = goog.array.map(iterators, function(it) {
+        var returnValue;
+        try {
+          returnValue = it.next();
+          // Iterator had a value, so we've not exhausted the iterators.
+          // Set flag accordingly.
+          iteratorsHaveValues = true;
+        } catch (ex) {
+          if (ex !== goog.iter.StopIteration) {
+            throw ex;
+          }
+          returnValue = fillValue;
+        }
+        return returnValue;
+      });
+
+      if (!iteratorsHaveValues) {
+        throw goog.iter.StopIteration;
+      }
+      return arr;
+    };
+  }
+
+  return iter;
+};
+
+
+/**
+ * Creates an iterator that filters {@code iterable} based on a series of
+ * {@code selectors}. On each call to {@code next()}, one item is taken from
+ * both the {@code iterable} and {@code selectors} iterators. If the item from
+ * {@code selectors} evaluates to true, the item from {@code iterable} is given.
+ * Otherwise, it is skipped. Once either {@code iterable} or {@code selectors}
+ * is exhausted, subsequent calls to {@code next()} will throw
+ * {@code goog.iter.StopIteration}.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.compress
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to filter.
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} selectors An
+ *     iterable of items to be evaluated in a boolean context to determine if
+ *     the corresponding element in {@code iterable} should be included in the
+ *     result.
+ * @return {!goog.iter.Iterator<VALUE>} A new iterator that returns the
+ *     filtered values.
+ * @template VALUE
+ */
+goog.iter.compress = function(iterable, selectors) {
+  var selectorIterator = goog.iter.toIterator(selectors);
+
+  return goog.iter.filter(iterable, function() {
+    return !!selectorIterator.next();
+  });
+};
+
+
+
+/**
+ * Implements the {@code goog.iter.groupBy} iterator.
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to group.
+ * @param {function(...VALUE): KEY=} opt_keyFunc  Optional function for
+ *     determining the key value for each group in the {@code iterable}. Default
+ *     is the identity function.
+ * @constructor
+ * @extends {goog.iter.Iterator<!Array<?>>}
+ * @template KEY, VALUE
+ * @private
+ */
+goog.iter.GroupByIterator_ = function(iterable, opt_keyFunc) {
+
+  /**
+   * The iterable to group, coerced to an iterator.
+   * @type {!goog.iter.Iterator}
+   */
+  this.iterator = goog.iter.toIterator(iterable);
+
+  /**
+   * A function for determining the key value for each element in the iterable.
+   * If no function is provided, the identity function is used and returns the
+   * element unchanged.
+   * @type {function(...VALUE): KEY}
+   */
+  this.keyFunc = opt_keyFunc || goog.functions.identity;
+
+  /**
+   * The target key for determining the start of a group.
+   * @type {KEY}
+   */
+  this.targetKey;
+
+  /**
+   * The current key visited during iteration.
+   * @type {KEY}
+   */
+  this.currentKey;
+
+  /**
+   * The current value being added to the group.
+   * @type {VALUE}
+   */
+  this.currentValue;
+};
+goog.inherits(goog.iter.GroupByIterator_, goog.iter.Iterator);
+
+
+/** @override */
+goog.iter.GroupByIterator_.prototype.next = function() {
+  while (this.currentKey == this.targetKey) {
+    this.currentValue = this.iterator.next();  // Exits on StopIteration
+    this.currentKey = this.keyFunc(this.currentValue);
+  }
+  this.targetKey = this.currentKey;
+  return [this.currentKey, this.groupItems_(this.targetKey)];
+};
+
+
+/**
+ * Performs the grouping of objects using the given key.
+ * @param {KEY} targetKey  The target key object for the group.
+ * @return {!Array<VALUE>} An array of grouped objects.
+ * @private
+ */
+goog.iter.GroupByIterator_.prototype.groupItems_ = function(targetKey) {
+  var arr = [];
+  while (this.currentKey == targetKey) {
+    arr.push(this.currentValue);
+    try {
+      this.currentValue = this.iterator.next();
+    } catch (ex) {
+      if (ex !== goog.iter.StopIteration) {
+        throw ex;
+      }
+      break;
+    }
+    this.currentKey = this.keyFunc(this.currentValue);
+  }
+  return arr;
+};
+
+
+/**
+ * Creates an iterator that returns arrays containing elements from the
+ * {@code iterable} grouped by a key value. For iterables with repeated
+ * elements (i.e. sorted according to a particular key function), this function
+ * has a {@code uniq}-like effect. For example, grouping the array:
+ * {@code [A, B, B, C, C, A]} produces
+ * {@code [A, [A]], [B, [B, B]], [C, [C, C]], [A, [A]]}.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.groupby
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to group.
+ * @param {function(...VALUE): KEY=} opt_keyFunc  Optional function for
+ *     determining the key value for each group in the {@code iterable}. Default
+ *     is the identity function.
+ * @return {!goog.iter.Iterator<!Array<?>>} A new iterator that returns
+ *     arrays of consecutive key and groups.
+ * @template KEY, VALUE
+ */
+goog.iter.groupBy = function(iterable, opt_keyFunc) {
+  return new goog.iter.GroupByIterator_(iterable, opt_keyFunc);
+};
+
+
+/**
+ * Gives an iterator that gives the result of calling the given function
+ * <code>f</code> with the arguments taken from the next element from
+ * <code>iterable</code> (the elements are expected to also be iterables).
+ *
+ * Similar to {@see goog.iter#map} but allows the function to accept multiple
+ * arguments from the iterable.
+ *
+ * @param {!goog.iter.Iterable<!goog.iter.Iterable>} iterable The iterable of
+ *     iterables to iterate over.
+ * @param {function(this:THIS,...*):RESULT} f The function to call for every
+ *     element.  This function takes N+2 arguments, where N represents the
+ *     number of items from the next element of the iterable. The two
+ *     additional arguments passed to the function are undefined and the
+ *     iterator itself. The function should return a new value.
+ * @param {THIS=} opt_obj The object to be used as the value of 'this' within
+ *     {@code f}.
+ * @return {!goog.iter.Iterator<RESULT>} A new iterator that returns the
+ *     results of applying the function to each element in the original
+ *     iterator.
+ * @template THIS, RESULT
+ */
+goog.iter.starMap = function(iterable, f, opt_obj) {
+  var iterator = goog.iter.toIterator(iterable);
+  var iter = new goog.iter.Iterator();
+
+  iter.next = function() {
+    var args = goog.iter.toArray(iterator.next());
+    return f.apply(opt_obj, goog.array.concat(args, undefined, iterator));
+  };
+
+  return iter;
+};
+
+
+/**
+ * Returns an array of iterators each of which can iterate over the values in
+ * {@code iterable} without advancing the others.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.tee
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to tee.
+ * @param {number=} opt_num  The number of iterators to create. Default is 2.
+ * @return {!Array<goog.iter.Iterator<VALUE>>} An array of iterators.
+ * @template VALUE
+ */
+goog.iter.tee = function(iterable, opt_num) {
+  var iterator = goog.iter.toIterator(iterable);
+  var num = goog.isNumber(opt_num) ? opt_num : 2;
+  var buffers = goog.array.map(goog.array.range(num), function() {
+    return [];
+  });
+
+  var addNextIteratorValueToBuffers = function() {
+    var val = iterator.next();
+    goog.array.forEach(buffers, function(buffer) {
+      buffer.push(val);
+    });
+  };
+
+  var createIterator = function(buffer) {
+    // Each tee'd iterator has an associated buffer (initially empty). When a
+    // tee'd iterator's buffer is empty, it calls
+    // addNextIteratorValueToBuffers(), adding the next value to all tee'd
+    // iterators' buffers, and then returns that value. This allows each
+    // iterator to be advanced independently.
+    var iter = new goog.iter.Iterator();
+
+    iter.next = function() {
+      if (goog.array.isEmpty(buffer)) {
+        addNextIteratorValueToBuffers();
+      }
+      goog.asserts.assert(!goog.array.isEmpty(buffer));
+      return buffer.shift();
+    };
+
+    return iter;
+  };
+
+  return goog.array.map(buffers, createIterator);
+};
+
+
+/**
+ * Creates an iterator that returns arrays containing a count and an element
+ * obtained from the given {@code iterable}.
+ * @see http://docs.python.org/2/library/functions.html#enumerate
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to enumerate.
+ * @param {number=} opt_start  Optional starting value. Default is 0.
+ * @return {!goog.iter.Iterator<!Array<?>>} A new iterator containing
+ *     count/item pairs.
+ * @template VALUE
+ */
+goog.iter.enumerate = function(iterable, opt_start) {
+  return goog.iter.zip(goog.iter.count(opt_start), iterable);
+};
+
+
+/**
+ * Creates an iterator that returns the first {@code limitSize} elements from an
+ * iterable. If this number is greater than the number of elements in the
+ * iterable, all the elements are returned.
+ * @see http://goo.gl/V0sihp Inspired by the limit iterator in Guava.
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to limit.
+ * @param {number} limitSize  The maximum number of elements to return.
+ * @return {!goog.iter.Iterator<VALUE>} A new iterator containing
+ *     {@code limitSize} elements.
+ * @template VALUE
+ */
+goog.iter.limit = function(iterable, limitSize) {
+  goog.asserts.assert(goog.math.isInt(limitSize) && limitSize >= 0);
+
+  var iterator = goog.iter.toIterator(iterable);
+
+  var iter = new goog.iter.Iterator();
+  var remaining = limitSize;
+
+  iter.next = function() {
+    if (remaining-- > 0) {
+      return iterator.next();
+    }
+    throw goog.iter.StopIteration;
+  };
+
+  return iter;
+};
+
+
+/**
+ * Creates an iterator that is advanced {@code count} steps ahead. Consumed
+ * values are silently discarded. If {@code count} is greater than the number
+ * of elements in {@code iterable}, an empty iterator is returned. Subsequent
+ * calls to {@code next()} will throw {@code goog.iter.StopIteration}.
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to consume.
+ * @param {number} count  The number of elements to consume from the iterator.
+ * @return {!goog.iter.Iterator<VALUE>} An iterator advanced zero or more steps
+ *     ahead.
+ * @template VALUE
+ */
+goog.iter.consume = function(iterable, count) {
+  goog.asserts.assert(goog.math.isInt(count) && count >= 0);
+
+  var iterator = goog.iter.toIterator(iterable);
+
+  while (count-- > 0) {
+    goog.iter.nextOrValue(iterator, null);
+  }
+
+  return iterator;
+};
+
+
+/**
+ * Creates an iterator that returns a range of elements from an iterable.
+ * Similar to {@see goog.array#slice} but does not support negative indexes.
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to slice.
+ * @param {number} start  The index of the first element to return.
+ * @param {number=} opt_end  The index after the last element to return. If
+ *     defined, must be greater than or equal to {@code start}.
+ * @return {!goog.iter.Iterator<VALUE>} A new iterator containing a slice of
+ *     the original.
+ * @template VALUE
+ */
+goog.iter.slice = function(iterable, start, opt_end) {
+  goog.asserts.assert(goog.math.isInt(start) && start >= 0);
+
+  var iterator = goog.iter.consume(iterable, start);
+
+  if (goog.isNumber(opt_end)) {
+    goog.asserts.assert(goog.math.isInt(opt_end) && opt_end >= start);
+    iterator = goog.iter.limit(iterator, opt_end - start /* limitSize */);
+  }
+
+  return iterator;
+};
+
+
+/**
+ * Checks an array for duplicate elements.
+ * @param {Array<VALUE>|goog.array.ArrayLike} arr The array to check for
+ *     duplicates.
+ * @return {boolean} True, if the array contains duplicates, false otherwise.
+ * @private
+ * @template VALUE
+ */
+// TODO(user): Consider moving this into goog.array as a public function.
+goog.iter.hasDuplicates_ = function(arr) {
+  var deduped = [];
+  goog.array.removeDuplicates(arr, deduped);
+  return arr.length != deduped.length;
+};
+
+
+/**
+ * Creates an iterator that returns permutations of elements in
+ * {@code iterable}.
+ *
+ * Permutations are obtained by taking the Cartesian product of
+ * {@code opt_length} iterables and filtering out those with repeated
+ * elements. For example, the permutations of {@code [1,2,3]} are
+ * {@code [[1,2,3], [1,3,2], [2,1,3], [2,3,1], [3,1,2], [3,2,1]]}.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.permutations
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable from which to generate permutations.
+ * @param {number=} opt_length Length of each permutation. If omitted, defaults
+ *     to the length of {@code iterable}.
+ * @return {!goog.iter.Iterator<!Array<VALUE>>} A new iterator containing the
+ *     permutations of {@code iterable}.
+ * @template VALUE
+ */
+goog.iter.permutations = function(iterable, opt_length) {
+  var elements = goog.iter.toArray(iterable);
+  var length = goog.isNumber(opt_length) ? opt_length : elements.length;
+
+  var sets = goog.array.repeat(elements, length);
+  var product = goog.iter.product.apply(undefined, sets);
+
+  return goog.iter.filter(product, function(arr) {
+    return !goog.iter.hasDuplicates_(arr);
+  });
+};
+
+
+/**
+ * Creates an iterator that returns combinations of elements from
+ * {@code iterable}.
+ *
+ * Combinations are obtained by taking the {@see goog.iter#permutations} of
+ * {@code iterable} and filtering those whose elements appear in the order they
+ * are encountered in {@code iterable}. For example, the 3-length combinations
+ * of {@code [0,1,2,3]} are {@code [[0,1,2], [0,1,3], [0,2,3], [1,2,3]]}.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.combinations
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable from which to generate combinations.
+ * @param {number} length The length of each combination.
+ * @return {!goog.iter.Iterator<!Array<VALUE>>} A new iterator containing
+ *     combinations from the {@code iterable}.
+ * @template VALUE
+ */
+goog.iter.combinations = function(iterable, length) {
+  var elements = goog.iter.toArray(iterable);
+  var indexes = goog.iter.range(elements.length);
+  var indexIterator = goog.iter.permutations(indexes, length);
+  // sortedIndexIterator will now give arrays of with the given length that
+  // indicate what indexes into "elements" should be returned on each iteration.
+  var sortedIndexIterator = goog.iter.filter(indexIterator, function(arr) {
+    return goog.array.isSorted(arr);
+  });
+
+  var iter = new goog.iter.Iterator();
+
+  function getIndexFromElements(index) {
+    return elements[index];
+  }
+
+  iter.next = function() {
+    return goog.array.map(sortedIndexIterator.next(), getIndexFromElements);
+  };
+
+  return iter;
+};
+
+
+/**
+ * Creates an iterator that returns combinations of elements from
+ * {@code iterable}, with repeated elements possible.
+ *
+ * Combinations are obtained by taking the Cartesian product of {@code length}
+ * iterables and filtering those whose elements appear in the order they are
+ * encountered in {@code iterable}. For example, the 2-length combinations of
+ * {@code [1,2,3]} are {@code [[1,1], [1,2], [1,3], [2,2], [2,3], [3,3]]}.
+ * @see http://docs.python.org/2/library/itertools.html#itertools.combinations_with_replacement
+ * @see http://en.wikipedia.org/wiki/Combination#Number_of_combinations_with_repetition
+ * @param {!goog.iter.Iterator<VALUE>|!goog.iter.Iterable} iterable The
+ *     iterable to combine.
+ * @param {number} length The length of each combination.
+ * @return {!goog.iter.Iterator<!Array<VALUE>>} A new iterator containing
+ *     combinations from the {@code iterable}.
+ * @template VALUE
+ */
+goog.iter.combinationsWithReplacement = function(iterable, length) {
+  var elements = goog.iter.toArray(iterable);
+  var indexes = goog.array.range(elements.length);
+  var sets = goog.array.repeat(indexes, length);
+  var indexIterator = goog.iter.product.apply(undefined, sets);
+  // sortedIndexIterator will now give arrays of with the given length that
+  // indicate what indexes into "elements" should be returned on each iteration.
+  var sortedIndexIterator = goog.iter.filter(indexIterator, function(arr) {
+    return goog.array.isSorted(arr);
+  });
+
+  var iter = new goog.iter.Iterator();
+
+  function getIndexFromElements(index) {
+    return elements[index];
+  }
+
+  iter.next = function() {
+    return goog.array.map(
+        /** @type {!Array<number>} */
+        (sortedIndexIterator.next()), getIndexFromElements);
+  };
+
+  return iter;
+};
diff --git a/lib/goog/json/json.js b/lib/goog/json/json.js
index f9f296d..308bae2 100644
--- a/lib/goog/json/json.js
+++ b/lib/goog/json/json.js
@@ -19,17 +19,27 @@
 
 
 goog.provide('goog.json');
+goog.provide('goog.json.Replacer');
+goog.provide('goog.json.Reviver');
 goog.provide('goog.json.Serializer');
 
 
+/**
+ * @define {boolean} If true, use the native JSON parsing API.
+ * NOTE(ruilopes): EXPERIMENTAL, handle with care.  Setting this to true might
+ * break your code.  The default {@code goog.json.parse} implementation is able
+ * to handle invalid JSON, such as JSPB.
+ */
+goog.define('goog.json.USE_NATIVE_JSON', false);
+
+
 /**
  * Tests if a string is an invalid JSON string. This only ensures that we are
  * not using any invalid characters
  * @param {string} s The string to test.
  * @return {boolean} True if the input is a valid JSON string.
- * @private
  */
-goog.json.isValid_ = function(s) {
+goog.json.isValid = function(s) {
   // All empty whitespace is not valid.
   if (/^\s*$/.test(s)) {
     return false;
@@ -79,19 +89,22 @@ goog.json.isValid_ = function(s) {
  * the string then you should use unsafeParse instead.
  *
  * @param {*} s The JSON string to parse.
- * @return {Object} The object generated from the JSON string.
+ * @throws Error if s is invalid JSON.
+ * @return {Object} The object generated from the JSON string, or null.
  */
-goog.json.parse = function(s) {
-  var o = String(s);
-  if (goog.json.isValid_(o)) {
-    /** @preserveTry */
-    try {
-      return /** @type {Object} */ (eval('(' + o + ')'));
-    } catch (ex) {
-    }
-  }
-  throw Error('Invalid JSON string: ' + o);
-};
+goog.json.parse = goog.json.USE_NATIVE_JSON ?
+    /** @type {function(*):Object} */ (goog.global['JSON']['parse']) :
+    function(s) {
+      var o = String(s);
+      if (goog.json.isValid(o)) {
+        /** @preserveTry */
+        try {
+          return /** @type {Object} */ (eval('(' + o + ')'));
+        } catch (ex) {
+        }
+      }
+      throw Error('Invalid JSON string: ' + o);
+    };
 
 
 /**
@@ -101,13 +114,16 @@ goog.json.parse = function(s) {
  * @param {string} s The JSON string to parse.
  * @return {Object} The object generated from the JSON string.
  */
-goog.json.unsafeParse = function(s) {
-  return /** @type {Object} */ (eval('(' + s + ')'));
-};
+goog.json.unsafeParse = goog.json.USE_NATIVE_JSON ?
+    /** @type {function(string):Object} */ (goog.global['JSON']['parse']) :
+    function(s) {
+      return /** @type {Object} */ (eval('(' + s + ')'));
+    };
 
 
 /**
  * JSON replacer, as defined in Section 15.12.3 of the ES5 spec.
+ * @see http://ecma-international.org/ecma-262/5.1/#sec-15.12.3
  *
  * TODO(nicksantos): Array should also be a valid replacer.
  *
@@ -118,6 +134,7 @@ goog.json.Replacer;
 
 /**
  * JSON reviver, as defined in Section 15.12.2 of the ES5 spec.
+ * @see http://ecma-international.org/ecma-262/5.1/#sec-15.12.3
  *
  * @typedef {function(this:Object, string, *): *}
  */
@@ -135,18 +152,21 @@ goog.json.Reviver;
  * @throws Error if there are loops in the object graph.
  * @return {string} A JSON string representation of the input.
  */
-goog.json.serialize = function(object, opt_replacer) {
-  // NOTE(nicksantos): Currently, we never use JSON.stringify.
-  //
-  // The last time I evaluated this, JSON.stringify had subtle bugs and behavior
-  // differences on all browsers, and the performance win was not large enough
-  // to justify all the issues. This may change in the future as browser
-  // implementations get better.
-  //
-  // assertSerialize in json_test contains if branches for the cases
-  // that fail.
-  return new goog.json.Serializer(opt_replacer).serialize(object);
-};
+goog.json.serialize = goog.json.USE_NATIVE_JSON ?
+    /** @type {function(*, ?goog.json.Replacer=):string} */
+    (goog.global['JSON']['stringify']) :
+    function(object, opt_replacer) {
+      // NOTE(nicksantos): Currently, we never use JSON.stringify.
+      //
+      // The last time I evaluated this, JSON.stringify had subtle bugs and
+      // behavior differences on all browsers, and the performance win was not
+      // large enough to justify all the issues. This may change in the future
+      // as browser implementations get better.
+      //
+      // assertSerialize in json_test contains if branches for the cases
+      // that fail.
+      return new goog.json.Serializer(opt_replacer).serialize(object);
+    };
 
 
 
@@ -173,49 +193,52 @@ goog.json.Serializer = function(opt_replacer) {
  */
 goog.json.Serializer.prototype.serialize = function(object) {
   var sb = [];
-  this.serialize_(object, sb);
+  this.serializeInternal(object, sb);
   return sb.join('');
 };
 
 
 /**
  * Serializes a generic value to a JSON string
- * @private
+ * @protected
  * @param {*} object The object to serialize.
- * @param {Array} sb Array used as a string builder.
+ * @param {Array<string>} sb Array used as a string builder.
  * @throws Error if there are loops in the object graph.
  */
-goog.json.Serializer.prototype.serialize_ = function(object, sb) {
+goog.json.Serializer.prototype.serializeInternal = function(object, sb) {
+  if (object == null) {
+    // undefined == null so this branch covers undefined as well as null
+    sb.push('null');
+    return;
+  }
+
+  if (typeof object == 'object') {
+    if (goog.isArray(object)) {
+      this.serializeArray(object, sb);
+      return;
+    } else if (object instanceof String ||
+               object instanceof Number ||
+               object instanceof Boolean) {
+      object = object.valueOf();
+      // Fall through to switch below.
+    } else {
+      this.serializeObject_(/** @type {Object} */ (object), sb);
+      return;
+    }
+  }
+
   switch (typeof object) {
     case 'string':
-      this.serializeString_(/** @type {string} */ (object), sb);
+      this.serializeString_(object, sb);
       break;
     case 'number':
-      this.serializeNumber_(/** @type {number} */ (object), sb);
+      this.serializeNumber_(object, sb);
       break;
     case 'boolean':
-      sb.push(object);
-      break;
-    case 'undefined':
-      sb.push('null');
-      break;
-    case 'object':
-      if (object == null) {
-        sb.push('null');
-        break;
-      }
-      if (goog.isArray(object)) {
-        this.serializeArray(/** @type {!Array} */ (object), sb);
-        break;
-      }
-      // should we allow new String, new Number and new Boolean to be treated
-      // as string, number and boolean? Most implementations do not and the
-      // need is not very big
-      this.serializeObject_(/** @type {Object} */ (object), sb);
+      sb.push(String(object));
       break;
     case 'function':
-      // Skip functions.
-      // TODO(user) Should we return something here?
+      sb.push('null');
       break;
     default:
       throw Error('Unknown type: ' + typeof object);
@@ -226,7 +249,7 @@ goog.json.Serializer.prototype.serialize_ = function(object, sb) {
 /**
  * Character mappings used internally for goog.string.quote
  * @private
- * @type {Object}
+ * @type {!Object}
  */
 goog.json.Serializer.charToJsonCharCache_ = {
   '\"': '\\"',
@@ -248,7 +271,7 @@ goog.json.Serializer.charToJsonCharCache_ = {
  * regular expressions. The condition below detects such behaviour and
  * adjusts the regular expression accordingly.
  * @private
- * @type {RegExp}
+ * @type {!RegExp}
  */
 goog.json.Serializer.charsToReplace_ = /\uffff/.test('\uffff') ?
     /[\\\"\x00-\x1f\x7f-\uffff]/g : /[\\\"\x00-\x1f\x7f-\xff]/g;
@@ -258,27 +281,19 @@ goog.json.Serializer.charsToReplace_ = /\uffff/.test('\uffff') ?
  * Serializes a string to a JSON string
  * @private
  * @param {string} s The string to serialize.
- * @param {Array} sb Array used as a string builder.
+ * @param {Array<string>} sb Array used as a string builder.
  */
 goog.json.Serializer.prototype.serializeString_ = function(s, sb) {
   // The official JSON implementation does not work with international
   // characters.
   sb.push('"', s.replace(goog.json.Serializer.charsToReplace_, function(c) {
     // caching the result improves performance by a factor 2-3
-    if (c in goog.json.Serializer.charToJsonCharCache_) {
-      return goog.json.Serializer.charToJsonCharCache_[c];
-    }
-
-    var cc = c.charCodeAt(0);
-    var rv = '\\u';
-    if (cc < 16) {
-      rv += '000';
-    } else if (cc < 256) {
-      rv += '00';
-    } else if (cc < 4096) { // \u1000
-      rv += '0';
+    var rv = goog.json.Serializer.charToJsonCharCache_[c];
+    if (!rv) {
+      rv = '\\u' + (c.charCodeAt(0) | 0x10000).toString(16).substr(1);
+      goog.json.Serializer.charToJsonCharCache_[c] = rv;
     }
-    return goog.json.Serializer.charToJsonCharCache_[c] = rv + cc.toString(16);
+    return rv;
   }), '"');
 };
 
@@ -287,17 +302,17 @@ goog.json.Serializer.prototype.serializeString_ = function(s, sb) {
  * Serializes a number to a JSON string
  * @private
  * @param {number} n The number to serialize.
- * @param {Array} sb Array used as a string builder.
+ * @param {Array<string>} sb Array used as a string builder.
  */
 goog.json.Serializer.prototype.serializeNumber_ = function(n, sb) {
-  sb.push(isFinite(n) && !isNaN(n) ? n : 'null');
+  sb.push(isFinite(n) && !isNaN(n) ? String(n) : 'null');
 };
 
 
 /**
  * Serializes an array to a JSON string
- * @param {Array} arr The array to serialize.
- * @param {Array} sb Array used as a string builder.
+ * @param {Array<string>} arr The array to serialize.
+ * @param {Array<string>} sb Array used as a string builder.
  * @protected
  */
 goog.json.Serializer.prototype.serializeArray = function(arr, sb) {
@@ -308,7 +323,7 @@ goog.json.Serializer.prototype.serializeArray = function(arr, sb) {
     sb.push(sep);
 
     var value = arr[i];
-    this.serialize_(
+    this.serializeInternal(
         this.replacer_ ? this.replacer_.call(arr, String(i), value) : value,
         sb);
 
@@ -322,7 +337,7 @@ goog.json.Serializer.prototype.serializeArray = function(arr, sb) {
  * Serializes an object to a JSON string
  * @private
  * @param {Object} obj The object to serialize.
- * @param {Array} sb Array used as a string builder.
+ * @param {Array<string>} sb Array used as a string builder.
  */
 goog.json.Serializer.prototype.serializeObject_ = function(obj, sb) {
   sb.push('{');
@@ -331,13 +346,12 @@ goog.json.Serializer.prototype.serializeObject_ = function(obj, sb) {
     if (Object.prototype.hasOwnProperty.call(obj, key)) {
       var value = obj[key];
       // Skip functions.
-      // TODO(ptucker) Should we return something for function properties?
       if (typeof value != 'function') {
         sb.push(sep);
         this.serializeString_(key, sb);
         sb.push(':');
 
-        this.serialize_(
+        this.serializeInternal(
             this.replacer_ ? this.replacer_.call(obj, key, value) : value,
             sb);
 
diff --git a/lib/goog/labs/testing/assertthat.js b/lib/goog/labs/testing/assertthat.js
index b6e8215..d0843eb 100644
--- a/lib/goog/labs/testing/assertthat.js
+++ b/lib/goog/labs/testing/assertthat.js
@@ -21,9 +21,7 @@
 goog.provide('goog.labs.testing.MatcherError');
 goog.provide('goog.labs.testing.assertThat');
 
-goog.require('goog.asserts');
 goog.require('goog.debug.Error');
-goog.require('goog.labs.testing.Matcher');
 
 
 /**
@@ -52,8 +50,9 @@ goog.labs.testing.assertThat = function(actual, matcher, opt_reason) {
  * @param {string=} opt_message The error message.
  * @constructor
  * @extends {goog.debug.Error}
+ * @final
  */
 goog.labs.testing.MatcherError = function(opt_message) {
-  goog.base(this, opt_message);
+  goog.labs.testing.MatcherError.base(this, 'constructor', opt_message);
 };
 goog.inherits(goog.labs.testing.MatcherError, goog.debug.Error);
diff --git a/lib/goog/labs/testing/logicmatcher.js b/lib/goog/labs/testing/logicmatcher.js
index 3004210..09148e3 100644
--- a/lib/goog/labs/testing/logicmatcher.js
+++ b/lib/goog/labs/testing/logicmatcher.js
@@ -31,14 +31,16 @@ goog.require('goog.labs.testing.Matcher');
 /**
  * The AllOf matcher.
  *
- * @param {!Array.<!goog.labs.testing.Matcher>} matchers Input matchers.
+ * @param {!Array<!goog.labs.testing.Matcher>} matchers Input matchers.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.AllOfMatcher = function(matchers) {
   /**
-   * @type {!Array.<!goog.labs.testing.Matcher>}
+   * @type {!Array<!goog.labs.testing.Matcher>}
    * @private
    */
   this.matchers_ = matchers;
@@ -80,14 +82,16 @@ goog.labs.testing.AllOfMatcher.prototype.describe =
 /**
  * The AnyOf matcher.
  *
- * @param {!Array.<!goog.labs.testing.Matcher>} matchers Input matchers.
+ * @param {!Array<!goog.labs.testing.Matcher>} matchers Input matchers.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.AnyOfMatcher = function(matchers) {
   /**
-   * @type {!Array.<!goog.labs.testing.Matcher>}
+   * @type {!Array<!goog.labs.testing.Matcher>}
    * @private
    */
   this.matchers_ = matchers;
@@ -131,7 +135,9 @@ goog.labs.testing.AnyOfMatcher.prototype.describe =
  * @param {!goog.labs.testing.Matcher} matcher The matcher to negate.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.IsNotMatcher = function(matcher) {
   /**
diff --git a/lib/goog/labs/testing/matcher.js b/lib/goog/labs/testing/matcher.js
index b0f5fd4..f8dd211 100644
--- a/lib/goog/labs/testing/matcher.js
+++ b/lib/goog/labs/testing/matcher.js
@@ -49,3 +49,32 @@ goog.labs.testing.Matcher.prototype.matches = function(value) {};
  */
 goog.labs.testing.Matcher.prototype.describe =
     function(value, opt_description) {};
+
+
+/**
+ * Generates a Matcher from the ‘matches’ and ‘describe’ functions passed in.
+ *
+ * @param {!Function} matchesFunction The ‘matches’ function.
+ * @param {Function=} opt_describeFunction The ‘describe’ function.
+ * @return {!Function} The custom matcher.
+ */
+goog.labs.testing.Matcher.makeMatcher =
+    function(matchesFunction, opt_describeFunction) {
+
+  /**
+   * @constructor
+   * @implements {goog.labs.testing.Matcher}
+   * @final
+   */
+  var matcherConstructor = function() {};
+
+  /** @override */
+  matcherConstructor.prototype.matches = matchesFunction;
+
+  if (opt_describeFunction) {
+    /** @override */
+    matcherConstructor.prototype.describe = opt_describeFunction;
+  }
+
+  return matcherConstructor;
+};
diff --git a/lib/goog/labs/testing/numbermatcher.js b/lib/goog/labs/testing/numbermatcher.js
index a78e5be..d9c67b3 100644
--- a/lib/goog/labs/testing/numbermatcher.js
+++ b/lib/goog/labs/testing/numbermatcher.js
@@ -37,7 +37,9 @@ goog.require('goog.labs.testing.Matcher');
  * @param {number} value The value to compare.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.GreaterThanMatcher = function(value) {
   /**
@@ -76,7 +78,9 @@ goog.labs.testing.GreaterThanMatcher.prototype.describe =
  * @param {number} value The value to compare.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.LessThanMatcher = function(value) {
   /**
@@ -115,7 +119,9 @@ goog.labs.testing.LessThanMatcher.prototype.describe =
  * @param {number} value The value to compare.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.GreaterThanEqualToMatcher = function(value) {
   /**
@@ -155,7 +161,9 @@ goog.labs.testing.GreaterThanEqualToMatcher.prototype.describe =
  * @param {number} value The value to compare.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.LessThanEqualToMatcher = function(value) {
   /**
@@ -195,7 +203,9 @@ goog.labs.testing.LessThanEqualToMatcher.prototype.describe =
  * @param {number} value The value to compare.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.EqualToMatcher = function(value) {
   /**
@@ -235,7 +245,9 @@ goog.labs.testing.EqualToMatcher.prototype.describe =
  * @param {number} range The range to check within.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.CloseToMatcher = function(value, range) {
   /**
diff --git a/lib/goog/labs/testing/objectmatcher.js b/lib/goog/labs/testing/objectmatcher.js
index 974d024..a9474fe 100644
--- a/lib/goog/labs/testing/objectmatcher.js
+++ b/lib/goog/labs/testing/objectmatcher.js
@@ -28,7 +28,6 @@ goog.provide('goog.labs.testing.ObjectEqualsMatcher');
 
 
 goog.require('goog.labs.testing.Matcher');
-goog.require('goog.string');
 
 
 
@@ -38,7 +37,9 @@ goog.require('goog.string');
  * @param {!Object} expectedObject The expected object.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.ObjectEqualsMatcher = function(expectedObject) {
   /**
@@ -76,7 +77,9 @@ goog.labs.testing.ObjectEqualsMatcher.prototype.describe =
  * @param {string} property Name of the property to test.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.HasPropertyMatcher = function(property) {
   /**
@@ -114,7 +117,9 @@ goog.labs.testing.HasPropertyMatcher.prototype.describe =
  * @param {!Object} object The expected class object.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.InstanceOfMatcher = function(object) {
   /**
@@ -150,7 +155,9 @@ goog.labs.testing.InstanceOfMatcher.prototype.describe =
  * The IsNullOrUndefined matcher.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.IsNullOrUndefinedMatcher = function() {};
 
@@ -180,7 +187,9 @@ goog.labs.testing.IsNullOrUndefinedMatcher.prototype.describe =
  * The IsNull matcher.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.IsNullMatcher = function() {};
 
@@ -210,7 +219,9 @@ goog.labs.testing.IsNullMatcher.prototype.describe =
  * The IsUndefined matcher.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.IsUndefinedMatcher = function() {};
 
diff --git a/lib/goog/labs/testing/stringmatcher.js b/lib/goog/labs/testing/stringmatcher.js
index 376f5b6..2cc5b67 100644
--- a/lib/goog/labs/testing/stringmatcher.js
+++ b/lib/goog/labs/testing/stringmatcher.js
@@ -20,7 +20,6 @@
 
 goog.provide('goog.labs.testing.ContainsStringMatcher');
 goog.provide('goog.labs.testing.EndsWithMatcher');
-goog.provide('goog.labs.testing.EqualToIgnoringCaseMatcher');
 goog.provide('goog.labs.testing.EqualToIgnoringWhitespaceMatcher');
 goog.provide('goog.labs.testing.EqualsMatcher');
 goog.provide('goog.labs.testing.RegexMatcher');
@@ -40,7 +39,9 @@ goog.require('goog.string');
  * @param {string} value The expected string.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.ContainsStringMatcher = function(value) {
   /**
@@ -79,7 +80,9 @@ goog.labs.testing.ContainsStringMatcher.prototype.describe =
  * @param {string} value The expected string.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.EndsWithMatcher = function(value) {
   /**
@@ -117,7 +120,9 @@ goog.labs.testing.EndsWithMatcher.prototype.describe =
  * @param {string} value The expected string.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.EqualToIgnoringWhitespaceMatcher = function(value) {
   /**
@@ -158,7 +163,9 @@ goog.labs.testing.EqualToIgnoringWhitespaceMatcher.prototype.describe =
  * @param {string} value The expected string.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.EqualsMatcher = function(value) {
   /**
@@ -196,7 +203,9 @@ goog.labs.testing.EqualsMatcher.prototype.describe =
  * @param {!RegExp} regex The expected regex.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.RegexMatcher = function(regex) {
   /**
@@ -235,7 +244,9 @@ goog.labs.testing.RegexMatcher.prototype.describe =
  * @param {string} value The expected string.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.StartsWithMatcher = function(value) {
   /**
@@ -270,14 +281,16 @@ goog.labs.testing.StartsWithMatcher.prototype.describe =
 /**
  * The StringContainsInOrdermatcher.
  *
- * @param {Array.<string>} values The expected string values.
+ * @param {Array<string>} values The expected string values.
  *
  * @constructor
+ * @struct
  * @implements {goog.labs.testing.Matcher}
+ * @final
  */
 goog.labs.testing.StringContainsInOrderMatcher = function(values) {
   /**
-   * @type {Array.<string>}
+   * @type {Array<string>}
    * @private
    */
   this.values_ = values;
@@ -392,7 +405,7 @@ function startsWith(value) {
 /**
  * Matches a string that contains the given strings in order.
  *
- * @param {Array.<string>} values The expected value.
+ * @param {Array<string>} values The expected value.
  *
  * @return {!goog.labs.testing.StringContainsInOrderMatcher} A
  *     StringContainsInOrderMatcher.
diff --git a/lib/goog/labs/useragent/browser.js b/lib/goog/labs/useragent/browser.js
new file mode 100644
index 0000000..75e3191
--- /dev/null
+++ b/lib/goog/labs/useragent/browser.js
@@ -0,0 +1,341 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Closure user agent detection (Browser).
+ * @see <a href="http://www.useragentstring.com/">User agent strings</a>
+ * For more information on rendering engine, platform, or device see the other
+ * sub-namespaces in goog.labs.userAgent, goog.labs.userAgent.platform,
+ * goog.labs.userAgent.device respectively.)
+ *
+ * @author martone@google.com (Andy Martone)
+ */
+
+goog.provide('goog.labs.userAgent.browser');
+
+goog.require('goog.array');
+goog.require('goog.labs.userAgent.util');
+goog.require('goog.object');
+goog.require('goog.string');
+
+
+// TODO(nnaze): Refactor to remove excessive exclusion logic in matching
+// functions.
+
+
+/**
+ * @return {boolean} Whether the user's browser is Opera.
+ * @private
+ */
+goog.labs.userAgent.browser.matchOpera_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Opera') ||
+      goog.labs.userAgent.util.matchUserAgent('OPR');
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is IE.
+ * @private
+ */
+goog.labs.userAgent.browser.matchIE_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Trident') ||
+      goog.labs.userAgent.util.matchUserAgent('MSIE');
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is Edge.
+ * @private
+ */
+goog.labs.userAgent.browser.matchEdge_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Edge');
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is Firefox.
+ * @private
+ */
+goog.labs.userAgent.browser.matchFirefox_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Firefox');
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is Safari.
+ * @private
+ */
+goog.labs.userAgent.browser.matchSafari_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Safari') &&
+      !(goog.labs.userAgent.browser.matchChrome_() ||
+        goog.labs.userAgent.browser.matchCoast_() ||
+        goog.labs.userAgent.browser.matchOpera_() ||
+        goog.labs.userAgent.browser.matchEdge_() ||
+        goog.labs.userAgent.browser.isSilk() ||
+        goog.labs.userAgent.util.matchUserAgent('Android'));
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is Coast (Opera's Webkit-based
+ *     iOS browser).
+ * @private
+ */
+goog.labs.userAgent.browser.matchCoast_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Coast');
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is iOS Webview.
+ * @private
+ */
+goog.labs.userAgent.browser.matchIosWebview_ = function() {
+  // iOS Webview does not show up as Chrome or Safari. Also check for Opera's
+  // WebKit-based iOS browser, Coast.
+  return (goog.labs.userAgent.util.matchUserAgent('iPad') ||
+          goog.labs.userAgent.util.matchUserAgent('iPhone')) &&
+      !goog.labs.userAgent.browser.matchSafari_() &&
+      !goog.labs.userAgent.browser.matchChrome_() &&
+      !goog.labs.userAgent.browser.matchCoast_() &&
+      goog.labs.userAgent.util.matchUserAgent('AppleWebKit');
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is Chrome.
+ * @private
+ */
+goog.labs.userAgent.browser.matchChrome_ = function() {
+  return (goog.labs.userAgent.util.matchUserAgent('Chrome') ||
+      goog.labs.userAgent.util.matchUserAgent('CriOS')) &&
+      !goog.labs.userAgent.browser.matchOpera_() &&
+      !goog.labs.userAgent.browser.matchEdge_();
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is the Android browser.
+ * @private
+ */
+goog.labs.userAgent.browser.matchAndroidBrowser_ = function() {
+  // Android can appear in the user agent string for Chrome on Android.
+  // This is not the Android standalone browser if it does.
+  return goog.labs.userAgent.util.matchUserAgent('Android') &&
+      !(goog.labs.userAgent.browser.isChrome() ||
+        goog.labs.userAgent.browser.isFirefox() ||
+        goog.labs.userAgent.browser.isOpera() ||
+        goog.labs.userAgent.browser.isSilk());
+};
+
+
+/**
+ * @return {boolean} Whether the user's browser is Opera.
+ */
+goog.labs.userAgent.browser.isOpera = goog.labs.userAgent.browser.matchOpera_;
+
+
+/**
+ * @return {boolean} Whether the user's browser is IE.
+ */
+goog.labs.userAgent.browser.isIE = goog.labs.userAgent.browser.matchIE_;
+
+
+/**
+ * @return {boolean} Whether the user's browser is Edge.
+ */
+goog.labs.userAgent.browser.isEdge = goog.labs.userAgent.browser.matchEdge_;
+
+
+/**
+ * @return {boolean} Whether the user's browser is Firefox.
+ */
+goog.labs.userAgent.browser.isFirefox =
+    goog.labs.userAgent.browser.matchFirefox_;
+
+
+/**
+ * @return {boolean} Whether the user's browser is Safari.
+ */
+goog.labs.userAgent.browser.isSafari =
+    goog.labs.userAgent.browser.matchSafari_;
+
+
+/**
+ * @return {boolean} Whether the user's browser is Coast (Opera's Webkit-based
+ *     iOS browser).
+ */
+goog.labs.userAgent.browser.isCoast =
+    goog.labs.userAgent.browser.matchCoast_;
+
+
+/**
+ * @return {boolean} Whether the user's browser is iOS Webview.
+ */
+goog.labs.userAgent.browser.isIosWebview =
+    goog.labs.userAgent.browser.matchIosWebview_;
+
+
+/**
+ * @return {boolean} Whether the user's browser is Chrome.
+ */
+goog.labs.userAgent.browser.isChrome =
+    goog.labs.userAgent.browser.matchChrome_;
+
+
+/**
+ * @return {boolean} Whether the user's browser is the Android browser.
+ */
+goog.labs.userAgent.browser.isAndroidBrowser =
+    goog.labs.userAgent.browser.matchAndroidBrowser_;
+
+
+/**
+ * For more information, see:
+ * http://docs.aws.amazon.com/silk/latest/developerguide/user-agent.html
+ * @return {boolean} Whether the user's browser is Silk.
+ */
+goog.labs.userAgent.browser.isSilk = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Silk');
+};
+
+
+/**
+ * @return {string} The browser version or empty string if version cannot be
+ *     determined. Note that for Internet Explorer, this returns the version of
+ *     the browser, not the version of the rendering engine. (IE 8 in
+ *     compatibility mode will return 8.0 rather than 7.0. To determine the
+ *     rendering engine version, look at document.documentMode instead. See
+ *     http://msdn.microsoft.com/en-us/library/cc196988(v=vs.85).aspx for more
+ *     details.)
+ */
+goog.labs.userAgent.browser.getVersion = function() {
+  var userAgentString = goog.labs.userAgent.util.getUserAgent();
+  // Special case IE since IE's version is inside the parenthesis and
+  // without the '/'.
+  if (goog.labs.userAgent.browser.isIE()) {
+    return goog.labs.userAgent.browser.getIEVersion_(userAgentString);
+  }
+
+  var versionTuples = goog.labs.userAgent.util.extractVersionTuples(
+      userAgentString);
+
+  // Construct a map for easy lookup.
+  var versionMap = {};
+  goog.array.forEach(versionTuples, function(tuple) {
+    // Note that the tuple is of length three, but we only care about the
+    // first two.
+    var key = tuple[0];
+    var value = tuple[1];
+    versionMap[key] = value;
+  });
+
+  var versionMapHasKey = goog.partial(goog.object.containsKey, versionMap);
+
+  // Gives the value with the first key it finds, otherwise empty string.
+  function lookUpValueWithKeys(keys) {
+    var key = goog.array.find(keys, versionMapHasKey);
+    return versionMap[key] || '';
+  }
+
+  // Check Opera before Chrome since Opera 15+ has "Chrome" in the string.
+  // See
+  // http://my.opera.com/ODIN/blog/2013/07/15/opera-user-agent-strings-opera-15-and-beyond
+  if (goog.labs.userAgent.browser.isOpera()) {
+    // Opera 10 has Version/10.0 but Opera/9.8, so look for "Version" first.
+    // Opera uses 'OPR' for more recent UAs.
+    return lookUpValueWithKeys(['Version', 'Opera', 'OPR']);
+  }
+
+  // Check Edge before Chrome since it has Chrome in the string.
+  if (goog.labs.userAgent.browser.isEdge()) {
+    return lookUpValueWithKeys(['Edge']);
+  }
+
+  if (goog.labs.userAgent.browser.isChrome()) {
+    return lookUpValueWithKeys(['Chrome', 'CriOS']);
+  }
+
+  // Usually products browser versions are in the third tuple after "Mozilla"
+  // and the engine.
+  var tuple = versionTuples[2];
+  return tuple && tuple[1] || '';
+};
+
+
+/**
+ * @param {string|number} version The version to check.
+ * @return {boolean} Whether the browser version is higher or the same as the
+ *     given version.
+ */
+goog.labs.userAgent.browser.isVersionOrHigher = function(version) {
+  return goog.string.compareVersions(goog.labs.userAgent.browser.getVersion(),
+                                     version) >= 0;
+};
+
+
+/**
+ * Determines IE version. More information:
+ * http://msdn.microsoft.com/en-us/library/ie/bg182625(v=vs.85).aspx#uaString
+ * http://msdn.microsoft.com/en-us/library/hh869301(v=vs.85).aspx
+ * http://blogs.msdn.com/b/ie/archive/2010/03/23/introducing-ie9-s-user-agent-string.aspx
+ * http://blogs.msdn.com/b/ie/archive/2009/01/09/the-internet-explorer-8-user-agent-string-updated-edition.aspx
+ *
+ * @param {string} userAgent the User-Agent.
+ * @return {string}
+ * @private
+ */
+goog.labs.userAgent.browser.getIEVersion_ = function(userAgent) {
+  // IE11 may identify itself as MSIE 9.0 or MSIE 10.0 due to an IE 11 upgrade
+  // bug. Example UA:
+  // Mozilla/5.0 (MSIE 9.0; Windows NT 6.1; WOW64; Trident/7.0; rv:11.0)
+  // like Gecko.
+  // See http://www.whatismybrowser.com/developers/unknown-user-agent-fragments.
+  var rv = /rv: *([\d\.]*)/.exec(userAgent);
+  if (rv && rv[1]) {
+    return rv[1];
+  }
+
+  var version = '';
+  var msie = /MSIE +([\d\.]+)/.exec(userAgent);
+  if (msie && msie[1]) {
+    // IE in compatibility mode usually identifies itself as MSIE 7.0; in this
+    // case, use the Trident version to determine the version of IE. For more
+    // details, see the links above.
+    var tridentVersion = /Trident\/(\d.\d)/.exec(userAgent);
+    if (msie[1] == '7.0') {
+      if (tridentVersion && tridentVersion[1]) {
+        switch (tridentVersion[1]) {
+          case '4.0':
+            version = '8.0';
+            break;
+          case '5.0':
+            version = '9.0';
+            break;
+          case '6.0':
+            version = '10.0';
+            break;
+          case '7.0':
+            version = '11.0';
+            break;
+        }
+      } else {
+        version = '7.0';
+      }
+    } else {
+      version = msie[1];
+    }
+  }
+  return version;
+};
diff --git a/lib/goog/labs/useragent/engine.js b/lib/goog/labs/useragent/engine.js
new file mode 100644
index 0000000..63025e7
--- /dev/null
+++ b/lib/goog/labs/useragent/engine.js
@@ -0,0 +1,160 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Closure user agent detection.
+ * @see http://en.wikipedia.org/wiki/User_agent
+ * For more information on browser brand, platform, or device see the other
+ * sub-namespaces in goog.labs.userAgent (browser, platform, and device).
+ *
+ */
+
+goog.provide('goog.labs.userAgent.engine');
+
+goog.require('goog.array');
+goog.require('goog.labs.userAgent.util');
+goog.require('goog.string');
+
+
+/**
+ * @return {boolean} Whether the rendering engine is Presto.
+ */
+goog.labs.userAgent.engine.isPresto = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Presto');
+};
+
+
+/**
+ * @return {boolean} Whether the rendering engine is Trident.
+ */
+goog.labs.userAgent.engine.isTrident = function() {
+  // IE only started including the Trident token in IE8.
+  return goog.labs.userAgent.util.matchUserAgent('Trident') ||
+      goog.labs.userAgent.util.matchUserAgent('MSIE');
+};
+
+
+/**
+ * @return {boolean} Whether the rendering engine is Edge.
+ */
+goog.labs.userAgent.engine.isEdge = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Edge');
+};
+
+
+/**
+ * @return {boolean} Whether the rendering engine is WebKit.
+ */
+goog.labs.userAgent.engine.isWebKit = function() {
+  return goog.labs.userAgent.util.matchUserAgentIgnoreCase('WebKit') &&
+      !goog.labs.userAgent.engine.isEdge();
+};
+
+
+/**
+ * @return {boolean} Whether the rendering engine is Gecko.
+ */
+goog.labs.userAgent.engine.isGecko = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Gecko') &&
+      !goog.labs.userAgent.engine.isWebKit() &&
+      !goog.labs.userAgent.engine.isTrident() &&
+      !goog.labs.userAgent.engine.isEdge();
+};
+
+
+/**
+ * @return {string} The rendering engine's version or empty string if version
+ *     can't be determined.
+ */
+goog.labs.userAgent.engine.getVersion = function() {
+  var userAgentString = goog.labs.userAgent.util.getUserAgent();
+  if (userAgentString) {
+    var tuples = goog.labs.userAgent.util.extractVersionTuples(
+        userAgentString);
+
+    var engineTuple = goog.labs.userAgent.engine.getEngineTuple_(tuples);
+    if (engineTuple) {
+      // In Gecko, the version string is either in the browser info or the
+      // Firefox version.  See Gecko user agent string reference:
+      // http://goo.gl/mULqa
+      if (engineTuple[0] == 'Gecko') {
+        return goog.labs.userAgent.engine.getVersionForKey_(
+            tuples, 'Firefox');
+      }
+
+      return engineTuple[1];
+    }
+
+    // MSIE has only one version identifier, and the Trident version is
+    // specified in the parenthetical. IE Edge is covered in the engine tuple
+    // detection.
+    var browserTuple = tuples[0];
+    var info;
+    if (browserTuple && (info = browserTuple[2])) {
+      var match = /Trident\/([^\s;]+)/.exec(info);
+      if (match) {
+        return match[1];
+      }
+    }
+  }
+  return '';
+};
+
+
+/**
+ * @param {!Array<!Array<string>>} tuples Extracted version tuples.
+ * @return {!Array<string>|undefined} The engine tuple or undefined if not
+ *     found.
+ * @private
+ */
+goog.labs.userAgent.engine.getEngineTuple_ = function(tuples) {
+  if (!goog.labs.userAgent.engine.isEdge()) {
+    return tuples[1];
+  }
+  for (var i = 0; i < tuples.length; i++) {
+    var tuple = tuples[i];
+    if (tuple[0] == 'Edge') {
+      return tuple;
+    }
+  }
+};
+
+
+/**
+ * @param {string|number} version The version to check.
+ * @return {boolean} Whether the rendering engine version is higher or the same
+ *     as the given version.
+ */
+goog.labs.userAgent.engine.isVersionOrHigher = function(version) {
+  return goog.string.compareVersions(goog.labs.userAgent.engine.getVersion(),
+                                     version) >= 0;
+};
+
+
+/**
+ * @param {!Array<!Array<string>>} tuples Version tuples.
+ * @param {string} key The key to look for.
+ * @return {string} The version string of the given key, if present.
+ *     Otherwise, the empty string.
+ * @private
+ */
+goog.labs.userAgent.engine.getVersionForKey_ = function(tuples, key) {
+  // TODO(nnaze): Move to util if useful elsewhere.
+
+  var pair = goog.array.find(tuples, function(pair) {
+    return key == pair[0];
+  });
+
+  return pair && pair[1] || '';
+};
diff --git a/lib/goog/labs/useragent/platform.js b/lib/goog/labs/useragent/platform.js
new file mode 100644
index 0000000..ece7c07
--- /dev/null
+++ b/lib/goog/labs/useragent/platform.js
@@ -0,0 +1,160 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Closure user agent platform detection.
+ * @see <a href="http://www.useragentstring.com/">User agent strings</a>
+ * For more information on browser brand, rendering engine, or device see the
+ * other sub-namespaces in goog.labs.userAgent (browser, engine, and device
+ * respectively).
+ *
+ */
+
+goog.provide('goog.labs.userAgent.platform');
+
+goog.require('goog.labs.userAgent.util');
+goog.require('goog.string');
+
+
+/**
+ * @return {boolean} Whether the platform is Android.
+ */
+goog.labs.userAgent.platform.isAndroid = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Android');
+};
+
+
+/**
+ * @return {boolean} Whether the platform is iPod.
+ */
+goog.labs.userAgent.platform.isIpod = function() {
+  return goog.labs.userAgent.util.matchUserAgent('iPod');
+};
+
+
+/**
+ * @return {boolean} Whether the platform is iPhone.
+ */
+goog.labs.userAgent.platform.isIphone = function() {
+  return goog.labs.userAgent.util.matchUserAgent('iPhone') &&
+      !goog.labs.userAgent.util.matchUserAgent('iPod') &&
+      !goog.labs.userAgent.util.matchUserAgent('iPad');
+};
+
+
+/**
+ * @return {boolean} Whether the platform is iPad.
+ */
+goog.labs.userAgent.platform.isIpad = function() {
+  return goog.labs.userAgent.util.matchUserAgent('iPad');
+};
+
+
+/**
+ * @return {boolean} Whether the platform is iOS.
+ */
+goog.labs.userAgent.platform.isIos = function() {
+  return goog.labs.userAgent.platform.isIphone() ||
+      goog.labs.userAgent.platform.isIpad() ||
+      goog.labs.userAgent.platform.isIpod();
+};
+
+
+/**
+ * @return {boolean} Whether the platform is Mac.
+ */
+goog.labs.userAgent.platform.isMacintosh = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Macintosh');
+};
+
+
+/**
+ * Note: ChromeOS is not considered to be Linux as it does not report itself
+ * as Linux in the user agent string.
+ * @return {boolean} Whether the platform is Linux.
+ */
+goog.labs.userAgent.platform.isLinux = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Linux');
+};
+
+
+/**
+ * @return {boolean} Whether the platform is Windows.
+ */
+goog.labs.userAgent.platform.isWindows = function() {
+  return goog.labs.userAgent.util.matchUserAgent('Windows');
+};
+
+
+/**
+ * @return {boolean} Whether the platform is ChromeOS.
+ */
+goog.labs.userAgent.platform.isChromeOS = function() {
+  return goog.labs.userAgent.util.matchUserAgent('CrOS');
+};
+
+
+/**
+ * The version of the platform. We only determine the version for Windows,
+ * Mac, and Chrome OS. It doesn't make much sense on Linux. For Windows, we only
+ * look at the NT version. Non-NT-based versions (e.g. 95, 98, etc.) are given
+ * version 0.0.
+ *
+ * @return {string} The platform version or empty string if version cannot be
+ *     determined.
+ */
+goog.labs.userAgent.platform.getVersion = function() {
+  var userAgentString = goog.labs.userAgent.util.getUserAgent();
+  var version = '', re;
+  if (goog.labs.userAgent.platform.isWindows()) {
+    re = /Windows (?:NT|Phone) ([0-9.]+)/;
+    var match = re.exec(userAgentString);
+    if (match) {
+      version = match[1];
+    } else {
+      version = '0.0';
+    }
+  } else if (goog.labs.userAgent.platform.isIos()) {
+    re = /(?:iPhone|iPod|iPad|CPU)\s+OS\s+(\S+)/;
+    var match = re.exec(userAgentString);
+    // Report the version as x.y.z and not x_y_z
+    version = match && match[1].replace(/_/g, '.');
+  } else if (goog.labs.userAgent.platform.isMacintosh()) {
+    re = /Mac OS X ([0-9_.]+)/;
+    var match = re.exec(userAgentString);
+    // Note: some old versions of Camino do not report an OSX version.
+    // Default to 10.
+    version = match ? match[1].replace(/_/g, '.') : '10';
+  } else if (goog.labs.userAgent.platform.isAndroid()) {
+    re = /Android\s+([^\);]+)(\)|;)/;
+    var match = re.exec(userAgentString);
+    version = match && match[1];
+  } else if (goog.labs.userAgent.platform.isChromeOS()) {
+    re = /(?:CrOS\s+(?:i686|x86_64)\s+([0-9.]+))/;
+    var match = re.exec(userAgentString);
+    version = match && match[1];
+  }
+  return version || '';
+};
+
+
+/**
+ * @param {string|number} version The version to check.
+ * @return {boolean} Whether the browser version is higher or the same as the
+ *     given version.
+ */
+goog.labs.userAgent.platform.isVersionOrHigher = function(version) {
+  return goog.string.compareVersions(goog.labs.userAgent.platform.getVersion(),
+                                     version) >= 0;
+};
diff --git a/lib/goog/labs/useragent/util.js b/lib/goog/labs/useragent/util.js
new file mode 100644
index 0000000..ebba9b5
--- /dev/null
+++ b/lib/goog/labs/useragent/util.js
@@ -0,0 +1,148 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Utilities used by goog.labs.userAgent tools. These functions
+ * should not be used outside of goog.labs.userAgent.*.
+ *
+ *
+ * @author nnaze@google.com (Nathan Naze)
+ */
+
+goog.provide('goog.labs.userAgent.util');
+
+goog.require('goog.string');
+
+
+/**
+ * Gets the native userAgent string from navigator if it exists.
+ * If navigator or navigator.userAgent string is missing, returns an empty
+ * string.
+ * @return {string}
+ * @private
+ */
+goog.labs.userAgent.util.getNativeUserAgentString_ = function() {
+  var navigator = goog.labs.userAgent.util.getNavigator_();
+  if (navigator) {
+    var userAgent = navigator.userAgent;
+    if (userAgent) {
+      return userAgent;
+    }
+  }
+  return '';
+};
+
+
+/**
+ * Getter for the native navigator.
+ * This is a separate function so it can be stubbed out in testing.
+ * @return {Navigator}
+ * @private
+ */
+goog.labs.userAgent.util.getNavigator_ = function() {
+  return goog.global.navigator;
+};
+
+
+/**
+ * A possible override for applications which wish to not check
+ * navigator.userAgent but use a specified value for detection instead.
+ * @private {string}
+ */
+goog.labs.userAgent.util.userAgent_ =
+    goog.labs.userAgent.util.getNativeUserAgentString_();
+
+
+/**
+ * Applications may override browser detection on the built in
+ * navigator.userAgent object by setting this string. Set to null to use the
+ * browser object instead.
+ * @param {?string=} opt_userAgent The User-Agent override.
+ */
+goog.labs.userAgent.util.setUserAgent = function(opt_userAgent) {
+  goog.labs.userAgent.util.userAgent_ = opt_userAgent ||
+      goog.labs.userAgent.util.getNativeUserAgentString_();
+};
+
+
+/**
+ * @return {string} The user agent string.
+ */
+goog.labs.userAgent.util.getUserAgent = function() {
+  return goog.labs.userAgent.util.userAgent_;
+};
+
+
+/**
+ * @param {string} str
+ * @return {boolean} Whether the user agent contains the given string, ignoring
+ *     case.
+ */
+goog.labs.userAgent.util.matchUserAgent = function(str) {
+  var userAgent = goog.labs.userAgent.util.getUserAgent();
+  return goog.string.contains(userAgent, str);
+};
+
+
+/**
+ * @param {string} str
+ * @return {boolean} Whether the user agent contains the given string.
+ */
+goog.labs.userAgent.util.matchUserAgentIgnoreCase = function(str) {
+  var userAgent = goog.labs.userAgent.util.getUserAgent();
+  return goog.string.caseInsensitiveContains(userAgent, str);
+};
+
+
+/**
+ * Parses the user agent into tuples for each section.
+ * @param {string} userAgent
+ * @return {!Array<!Array<string>>} Tuples of key, version, and the contents
+ *     of the parenthetical.
+ */
+goog.labs.userAgent.util.extractVersionTuples = function(userAgent) {
+  // Matches each section of a user agent string.
+  // Example UA:
+  // Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us)
+  // AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405
+  // This has three version tuples: Mozilla, AppleWebKit, and Mobile.
+
+  var versionRegExp = new RegExp(
+      // Key. Note that a key may have a space.
+      // (i.e. 'Mobile Safari' in 'Mobile Safari/5.0')
+      '(\\w[\\w ]+)' +
+
+      '/' +                // slash
+      '([^\\s]+)' +        // version (i.e. '5.0b')
+      '\\s*' +             // whitespace
+      '(?:\\((.*?)\\))?',  // parenthetical info. parentheses not matched.
+      'g');
+
+  var data = [];
+  var match;
+
+  // Iterate and collect the version tuples.  Each iteration will be the
+  // next regex match.
+  while (match = versionRegExp.exec(userAgent)) {
+    data.push([
+      match[1],  // key
+      match[2],  // value
+      // || undefined as this is not undefined in IE7 and IE8
+      match[3] || undefined  // info
+    ]);
+  }
+
+  return data;
+};
+
diff --git a/lib/goog/log/log.js b/lib/goog/log/log.js
new file mode 100644
index 0000000..b93d835
--- /dev/null
+++ b/lib/goog/log/log.js
@@ -0,0 +1,197 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Basic strippable logging definitions.
+ * @see http://go/closurelogging
+ *
+ * @author johnlenz@google.com (John Lenz)
+ */
+
+goog.provide('goog.log');
+goog.provide('goog.log.Level');
+goog.provide('goog.log.LogRecord');
+goog.provide('goog.log.Logger');
+
+goog.require('goog.debug');
+goog.require('goog.debug.LogManager');
+goog.require('goog.debug.LogRecord');
+goog.require('goog.debug.Logger');
+
+
+/** @define {boolean} Whether logging is enabled. */
+goog.define('goog.log.ENABLED', goog.debug.LOGGING_ENABLED);
+
+
+/** @const */
+goog.log.ROOT_LOGGER_NAME = goog.debug.Logger.ROOT_LOGGER_NAME;
+
+
+
+/**
+ * @constructor
+ * @final
+ */
+goog.log.Logger = goog.debug.Logger;
+
+
+
+/**
+ * @constructor
+ * @final
+ */
+goog.log.Level = goog.debug.Logger.Level;
+
+
+
+/**
+ * @constructor
+ * @final
+ */
+goog.log.LogRecord = goog.debug.LogRecord;
+
+
+/**
+ * Finds or creates a logger for a named subsystem. If a logger has already been
+ * created with the given name it is returned. Otherwise a new logger is
+ * created. If a new logger is created its log level will be configured based
+ * on the goog.debug.LogManager configuration and it will configured to also
+ * send logging output to its parent's handlers.
+ * @see goog.debug.LogManager
+ *
+ * @param {string} name A name for the logger. This should be a dot-separated
+ *     name and should normally be based on the package name or class name of
+ *     the subsystem, such as goog.net.BrowserChannel.
+ * @param {goog.log.Level=} opt_level If provided, override the
+ *     default logging level with the provided level.
+ * @return {goog.log.Logger} The named logger or null if logging is disabled.
+ */
+goog.log.getLogger = function(name, opt_level) {
+  if (goog.log.ENABLED) {
+    var logger = goog.debug.LogManager.getLogger(name);
+    if (opt_level && logger) {
+      logger.setLevel(opt_level);
+    }
+    return logger;
+  } else {
+    return null;
+  }
+};
+
+
+// TODO(johnlenz): try to tighten the types to these functions.
+/**
+ * Adds a handler to the logger. This doesn't use the event system because
+ * we want to be able to add logging to the event system.
+ * @param {goog.log.Logger} logger
+ * @param {Function} handler Handler function to add.
+ */
+goog.log.addHandler = function(logger, handler) {
+  if (goog.log.ENABLED && logger) {
+    logger.addHandler(handler);
+  }
+};
+
+
+/**
+ * Removes a handler from the logger. This doesn't use the event system because
+ * we want to be able to add logging to the event system.
+ * @param {goog.log.Logger} logger
+ * @param {Function} handler Handler function to remove.
+ * @return {boolean} Whether the handler was removed.
+ */
+goog.log.removeHandler = function(logger, handler) {
+  if (goog.log.ENABLED && logger) {
+    return logger.removeHandler(handler);
+  } else {
+    return false;
+  }
+};
+
+
+/**
+ * Logs a message. If the logger is currently enabled for the
+ * given message level then the given message is forwarded to all the
+ * registered output Handler objects.
+ * @param {goog.log.Logger} logger
+ * @param {goog.log.Level} level One of the level identifiers.
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error|Object=} opt_exception An exception associated with the
+ *     message.
+ */
+goog.log.log = function(logger, level, msg, opt_exception) {
+  if (goog.log.ENABLED && logger) {
+    logger.log(level, msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Level.SEVERE level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.log.Logger} logger
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.log.error = function(logger, msg, opt_exception) {
+  if (goog.log.ENABLED && logger) {
+    logger.severe(msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Level.WARNING level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.log.Logger} logger
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.log.warning = function(logger, msg, opt_exception) {
+  if (goog.log.ENABLED && logger) {
+    logger.warning(msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Level.INFO level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.log.Logger} logger
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.log.info = function(logger, msg, opt_exception) {
+  if (goog.log.ENABLED && logger) {
+    logger.info(msg, opt_exception);
+  }
+};
+
+
+/**
+ * Logs a message at the Level.Fine level.
+ * If the logger is currently enabled for the given message level then the
+ * given message is forwarded to all the registered output Handler objects.
+ * @param {goog.log.Logger} logger
+ * @param {goog.debug.Loggable} msg The message to log.
+ * @param {Error=} opt_exception An exception associated with the message.
+ */
+goog.log.fine = function(logger, msg, opt_exception) {
+  if (goog.log.ENABLED && logger) {
+    logger.fine(msg, opt_exception);
+  }
+};
diff --git a/lib/goog/math/box.js b/lib/goog/math/box.js
new file mode 100644
index 0000000..04ac50d
--- /dev/null
+++ b/lib/goog/math/box.js
@@ -0,0 +1,398 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A utility class for representing a numeric box.
+ */
+
+
+goog.provide('goog.math.Box');
+
+goog.require('goog.math.Coordinate');
+
+
+
+/**
+ * Class for representing a box. A box is specified as a top, right, bottom,
+ * and left. A box is useful for representing margins and padding.
+ *
+ * This class assumes 'screen coordinates': larger Y coordinates are further
+ * from the top of the screen.
+ *
+ * @param {number} top Top.
+ * @param {number} right Right.
+ * @param {number} bottom Bottom.
+ * @param {number} left Left.
+ * @struct
+ * @constructor
+ */
+goog.math.Box = function(top, right, bottom, left) {
+  /**
+   * Top
+   * @type {number}
+   */
+  this.top = top;
+
+  /**
+   * Right
+   * @type {number}
+   */
+  this.right = right;
+
+  /**
+   * Bottom
+   * @type {number}
+   */
+  this.bottom = bottom;
+
+  /**
+   * Left
+   * @type {number}
+   */
+  this.left = left;
+};
+
+
+/**
+ * Creates a Box by bounding a collection of goog.math.Coordinate objects
+ * @param {...goog.math.Coordinate} var_args Coordinates to be included inside
+ *     the box.
+ * @return {!goog.math.Box} A Box containing all the specified Coordinates.
+ */
+goog.math.Box.boundingBox = function(var_args) {
+  var box = new goog.math.Box(arguments[0].y, arguments[0].x,
+                              arguments[0].y, arguments[0].x);
+  for (var i = 1; i < arguments.length; i++) {
+    box.expandToIncludeCoordinate(arguments[i]);
+  }
+  return box;
+};
+
+
+/**
+ * @return {number} width The width of this Box.
+ */
+goog.math.Box.prototype.getWidth = function() {
+  return this.right - this.left;
+};
+
+
+/**
+ * @return {number} height The height of this Box.
+ */
+goog.math.Box.prototype.getHeight = function() {
+  return this.bottom - this.top;
+};
+
+
+/**
+ * Creates a copy of the box with the same dimensions.
+ * @return {!goog.math.Box} A clone of this Box.
+ */
+goog.math.Box.prototype.clone = function() {
+  return new goog.math.Box(this.top, this.right, this.bottom, this.left);
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a nice string representing the box.
+   * @return {string} In the form (50t, 73r, 24b, 13l).
+   * @override
+   */
+  goog.math.Box.prototype.toString = function() {
+    return '(' + this.top + 't, ' + this.right + 'r, ' + this.bottom + 'b, ' +
+           this.left + 'l)';
+  };
+}
+
+
+/**
+ * Returns whether the box contains a coordinate or another box.
+ *
+ * @param {goog.math.Coordinate|goog.math.Box} other A Coordinate or a Box.
+ * @return {boolean} Whether the box contains the coordinate or other box.
+ */
+goog.math.Box.prototype.contains = function(other) {
+  return goog.math.Box.contains(this, other);
+};
+
+
+/**
+ * Expands box with the given margins.
+ *
+ * @param {number|goog.math.Box} top Top margin or box with all margins.
+ * @param {number=} opt_right Right margin.
+ * @param {number=} opt_bottom Bottom margin.
+ * @param {number=} opt_left Left margin.
+ * @return {!goog.math.Box} A reference to this Box.
+ */
+goog.math.Box.prototype.expand = function(top, opt_right, opt_bottom,
+    opt_left) {
+  if (goog.isObject(top)) {
+    this.top -= top.top;
+    this.right += top.right;
+    this.bottom += top.bottom;
+    this.left -= top.left;
+  } else {
+    this.top -= top;
+    this.right += opt_right;
+    this.bottom += opt_bottom;
+    this.left -= opt_left;
+  }
+
+  return this;
+};
+
+
+/**
+ * Expand this box to include another box.
+ * NOTE(user): This is used in code that needs to be very fast, please don't
+ * add functionality to this function at the expense of speed (variable
+ * arguments, accepting multiple argument types, etc).
+ * @param {goog.math.Box} box The box to include in this one.
+ */
+goog.math.Box.prototype.expandToInclude = function(box) {
+  this.left = Math.min(this.left, box.left);
+  this.top = Math.min(this.top, box.top);
+  this.right = Math.max(this.right, box.right);
+  this.bottom = Math.max(this.bottom, box.bottom);
+};
+
+
+/**
+ * Expand this box to include the coordinate.
+ * @param {!goog.math.Coordinate} coord The coordinate to be included
+ *     inside the box.
+ */
+goog.math.Box.prototype.expandToIncludeCoordinate = function(coord) {
+  this.top = Math.min(this.top, coord.y);
+  this.right = Math.max(this.right, coord.x);
+  this.bottom = Math.max(this.bottom, coord.y);
+  this.left = Math.min(this.left, coord.x);
+};
+
+
+/**
+ * Compares boxes for equality.
+ * @param {goog.math.Box} a A Box.
+ * @param {goog.math.Box} b A Box.
+ * @return {boolean} True iff the boxes are equal, or if both are null.
+ */
+goog.math.Box.equals = function(a, b) {
+  if (a == b) {
+    return true;
+  }
+  if (!a || !b) {
+    return false;
+  }
+  return a.top == b.top && a.right == b.right &&
+         a.bottom == b.bottom && a.left == b.left;
+};
+
+
+/**
+ * Returns whether a box contains a coordinate or another box.
+ *
+ * @param {goog.math.Box} box A Box.
+ * @param {goog.math.Coordinate|goog.math.Box} other A Coordinate or a Box.
+ * @return {boolean} Whether the box contains the coordinate or other box.
+ */
+goog.math.Box.contains = function(box, other) {
+  if (!box || !other) {
+    return false;
+  }
+
+  if (other instanceof goog.math.Box) {
+    return other.left >= box.left && other.right <= box.right &&
+        other.top >= box.top && other.bottom <= box.bottom;
+  }
+
+  // other is a Coordinate.
+  return other.x >= box.left && other.x <= box.right &&
+         other.y >= box.top && other.y <= box.bottom;
+};
+
+
+/**
+ * Returns the relative x position of a coordinate compared to a box.  Returns
+ * zero if the coordinate is inside the box.
+ *
+ * @param {goog.math.Box} box A Box.
+ * @param {goog.math.Coordinate} coord A Coordinate.
+ * @return {number} The x position of {@code coord} relative to the nearest
+ *     side of {@code box}, or zero if {@code coord} is inside {@code box}.
+ */
+goog.math.Box.relativePositionX = function(box, coord) {
+  if (coord.x < box.left) {
+    return coord.x - box.left;
+  } else if (coord.x > box.right) {
+    return coord.x - box.right;
+  }
+  return 0;
+};
+
+
+/**
+ * Returns the relative y position of a coordinate compared to a box.  Returns
+ * zero if the coordinate is inside the box.
+ *
+ * @param {goog.math.Box} box A Box.
+ * @param {goog.math.Coordinate} coord A Coordinate.
+ * @return {number} The y position of {@code coord} relative to the nearest
+ *     side of {@code box}, or zero if {@code coord} is inside {@code box}.
+ */
+goog.math.Box.relativePositionY = function(box, coord) {
+  if (coord.y < box.top) {
+    return coord.y - box.top;
+  } else if (coord.y > box.bottom) {
+    return coord.y - box.bottom;
+  }
+  return 0;
+};
+
+
+/**
+ * Returns the distance between a coordinate and the nearest corner/side of a
+ * box. Returns zero if the coordinate is inside the box.
+ *
+ * @param {goog.math.Box} box A Box.
+ * @param {goog.math.Coordinate} coord A Coordinate.
+ * @return {number} The distance between {@code coord} and the nearest
+ *     corner/side of {@code box}, or zero if {@code coord} is inside
+ *     {@code box}.
+ */
+goog.math.Box.distance = function(box, coord) {
+  var x = goog.math.Box.relativePositionX(box, coord);
+  var y = goog.math.Box.relativePositionY(box, coord);
+  return Math.sqrt(x * x + y * y);
+};
+
+
+/**
+ * Returns whether two boxes intersect.
+ *
+ * @param {goog.math.Box} a A Box.
+ * @param {goog.math.Box} b A second Box.
+ * @return {boolean} Whether the boxes intersect.
+ */
+goog.math.Box.intersects = function(a, b) {
+  return (a.left <= b.right && b.left <= a.right &&
+          a.top <= b.bottom && b.top <= a.bottom);
+};
+
+
+/**
+ * Returns whether two boxes would intersect with additional padding.
+ *
+ * @param {goog.math.Box} a A Box.
+ * @param {goog.math.Box} b A second Box.
+ * @param {number} padding The additional padding.
+ * @return {boolean} Whether the boxes intersect.
+ */
+goog.math.Box.intersectsWithPadding = function(a, b, padding) {
+  return (a.left <= b.right + padding && b.left <= a.right + padding &&
+          a.top <= b.bottom + padding && b.top <= a.bottom + padding);
+};
+
+
+/**
+ * Rounds the fields to the next larger integer values.
+ *
+ * @return {!goog.math.Box} This box with ceil'd fields.
+ */
+goog.math.Box.prototype.ceil = function() {
+  this.top = Math.ceil(this.top);
+  this.right = Math.ceil(this.right);
+  this.bottom = Math.ceil(this.bottom);
+  this.left = Math.ceil(this.left);
+  return this;
+};
+
+
+/**
+ * Rounds the fields to the next smaller integer values.
+ *
+ * @return {!goog.math.Box} This box with floored fields.
+ */
+goog.math.Box.prototype.floor = function() {
+  this.top = Math.floor(this.top);
+  this.right = Math.floor(this.right);
+  this.bottom = Math.floor(this.bottom);
+  this.left = Math.floor(this.left);
+  return this;
+};
+
+
+/**
+ * Rounds the fields to nearest integer values.
+ *
+ * @return {!goog.math.Box} This box with rounded fields.
+ */
+goog.math.Box.prototype.round = function() {
+  this.top = Math.round(this.top);
+  this.right = Math.round(this.right);
+  this.bottom = Math.round(this.bottom);
+  this.left = Math.round(this.left);
+  return this;
+};
+
+
+/**
+ * Translates this box by the given offsets. If a {@code goog.math.Coordinate}
+ * is given, then the left and right values are translated by the coordinate's
+ * x value and the top and bottom values are translated by the coordinate's y
+ * value.  Otherwise, {@code tx} and {@code opt_ty} are used to translate the x
+ * and y dimension values.
+ *
+ * @param {number|goog.math.Coordinate} tx The value to translate the x
+ *     dimension values by or the the coordinate to translate this box by.
+ * @param {number=} opt_ty The value to translate y dimension values by.
+ * @return {!goog.math.Box} This box after translating.
+ */
+goog.math.Box.prototype.translate = function(tx, opt_ty) {
+  if (tx instanceof goog.math.Coordinate) {
+    this.left += tx.x;
+    this.right += tx.x;
+    this.top += tx.y;
+    this.bottom += tx.y;
+  } else {
+    this.left += tx;
+    this.right += tx;
+    if (goog.isNumber(opt_ty)) {
+      this.top += opt_ty;
+      this.bottom += opt_ty;
+    }
+  }
+  return this;
+};
+
+
+/**
+ * Scales this coordinate by the given scale factors. The x and y dimension
+ * values are scaled by {@code sx} and {@code opt_sy} respectively.
+ * If {@code opt_sy} is not given, then {@code sx} is used for both x and y.
+ *
+ * @param {number} sx The scale factor to use for the x dimension.
+ * @param {number=} opt_sy The scale factor to use for the y dimension.
+ * @return {!goog.math.Box} This box after scaling.
+ */
+goog.math.Box.prototype.scale = function(sx, opt_sy) {
+  var sy = goog.isNumber(opt_sy) ? opt_sy : sx;
+  this.left *= sx;
+  this.right *= sx;
+  this.top *= sy;
+  this.bottom *= sy;
+  return this;
+};
diff --git a/lib/goog/math/coordinate.js b/lib/goog/math/coordinate.js
new file mode 100644
index 0000000..798d385
--- /dev/null
+++ b/lib/goog/math/coordinate.js
@@ -0,0 +1,268 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A utility class for representing two-dimensional positions.
+ */
+
+
+goog.provide('goog.math.Coordinate');
+
+goog.require('goog.math');
+
+
+
+/**
+ * Class for representing coordinates and positions.
+ * @param {number=} opt_x Left, defaults to 0.
+ * @param {number=} opt_y Top, defaults to 0.
+ * @struct
+ * @constructor
+ */
+goog.math.Coordinate = function(opt_x, opt_y) {
+  /**
+   * X-value
+   * @type {number}
+   */
+  this.x = goog.isDef(opt_x) ? opt_x : 0;
+
+  /**
+   * Y-value
+   * @type {number}
+   */
+  this.y = goog.isDef(opt_y) ? opt_y : 0;
+};
+
+
+/**
+ * Returns a new copy of the coordinate.
+ * @return {!goog.math.Coordinate} A clone of this coordinate.
+ */
+goog.math.Coordinate.prototype.clone = function() {
+  return new goog.math.Coordinate(this.x, this.y);
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a nice string representing the coordinate.
+   * @return {string} In the form (50, 73).
+   * @override
+   */
+  goog.math.Coordinate.prototype.toString = function() {
+    return '(' + this.x + ', ' + this.y + ')';
+  };
+}
+
+
+/**
+ * Compares coordinates for equality.
+ * @param {goog.math.Coordinate} a A Coordinate.
+ * @param {goog.math.Coordinate} b A Coordinate.
+ * @return {boolean} True iff the coordinates are equal, or if both are null.
+ */
+goog.math.Coordinate.equals = function(a, b) {
+  if (a == b) {
+    return true;
+  }
+  if (!a || !b) {
+    return false;
+  }
+  return a.x == b.x && a.y == b.y;
+};
+
+
+/**
+ * Returns the distance between two coordinates.
+ * @param {!goog.math.Coordinate} a A Coordinate.
+ * @param {!goog.math.Coordinate} b A Coordinate.
+ * @return {number} The distance between {@code a} and {@code b}.
+ */
+goog.math.Coordinate.distance = function(a, b) {
+  var dx = a.x - b.x;
+  var dy = a.y - b.y;
+  return Math.sqrt(dx * dx + dy * dy);
+};
+
+
+/**
+ * Returns the magnitude of a coordinate.
+ * @param {!goog.math.Coordinate} a A Coordinate.
+ * @return {number} The distance between the origin and {@code a}.
+ */
+goog.math.Coordinate.magnitude = function(a) {
+  return Math.sqrt(a.x * a.x + a.y * a.y);
+};
+
+
+/**
+ * Returns the angle from the origin to a coordinate.
+ * @param {!goog.math.Coordinate} a A Coordinate.
+ * @return {number} The angle, in degrees, clockwise from the positive X
+ *     axis to {@code a}.
+ */
+goog.math.Coordinate.azimuth = function(a) {
+  return goog.math.angle(0, 0, a.x, a.y);
+};
+
+
+/**
+ * Returns the squared distance between two coordinates. Squared distances can
+ * be used for comparisons when the actual value is not required.
+ *
+ * Performance note: eliminating the square root is an optimization often used
+ * in lower-level languages, but the speed difference is not nearly as
+ * pronounced in JavaScript (only a few percent.)
+ *
+ * @param {!goog.math.Coordinate} a A Coordinate.
+ * @param {!goog.math.Coordinate} b A Coordinate.
+ * @return {number} The squared distance between {@code a} and {@code b}.
+ */
+goog.math.Coordinate.squaredDistance = function(a, b) {
+  var dx = a.x - b.x;
+  var dy = a.y - b.y;
+  return dx * dx + dy * dy;
+};
+
+
+/**
+ * Returns the difference between two coordinates as a new
+ * goog.math.Coordinate.
+ * @param {!goog.math.Coordinate} a A Coordinate.
+ * @param {!goog.math.Coordinate} b A Coordinate.
+ * @return {!goog.math.Coordinate} A Coordinate representing the difference
+ *     between {@code a} and {@code b}.
+ */
+goog.math.Coordinate.difference = function(a, b) {
+  return new goog.math.Coordinate(a.x - b.x, a.y - b.y);
+};
+
+
+/**
+ * Returns the sum of two coordinates as a new goog.math.Coordinate.
+ * @param {!goog.math.Coordinate} a A Coordinate.
+ * @param {!goog.math.Coordinate} b A Coordinate.
+ * @return {!goog.math.Coordinate} A Coordinate representing the sum of the two
+ *     coordinates.
+ */
+goog.math.Coordinate.sum = function(a, b) {
+  return new goog.math.Coordinate(a.x + b.x, a.y + b.y);
+};
+
+
+/**
+ * Rounds the x and y fields to the next larger integer values.
+ * @return {!goog.math.Coordinate} This coordinate with ceil'd fields.
+ */
+goog.math.Coordinate.prototype.ceil = function() {
+  this.x = Math.ceil(this.x);
+  this.y = Math.ceil(this.y);
+  return this;
+};
+
+
+/**
+ * Rounds the x and y fields to the next smaller integer values.
+ * @return {!goog.math.Coordinate} This coordinate with floored fields.
+ */
+goog.math.Coordinate.prototype.floor = function() {
+  this.x = Math.floor(this.x);
+  this.y = Math.floor(this.y);
+  return this;
+};
+
+
+/**
+ * Rounds the x and y fields to the nearest integer values.
+ * @return {!goog.math.Coordinate} This coordinate with rounded fields.
+ */
+goog.math.Coordinate.prototype.round = function() {
+  this.x = Math.round(this.x);
+  this.y = Math.round(this.y);
+  return this;
+};
+
+
+/**
+ * Translates this box by the given offsets. If a {@code goog.math.Coordinate}
+ * is given, then the x and y values are translated by the coordinate's x and y.
+ * Otherwise, x and y are translated by {@code tx} and {@code opt_ty}
+ * respectively.
+ * @param {number|goog.math.Coordinate} tx The value to translate x by or the
+ *     the coordinate to translate this coordinate by.
+ * @param {number=} opt_ty The value to translate y by.
+ * @return {!goog.math.Coordinate} This coordinate after translating.
+ */
+goog.math.Coordinate.prototype.translate = function(tx, opt_ty) {
+  if (tx instanceof goog.math.Coordinate) {
+    this.x += tx.x;
+    this.y += tx.y;
+  } else {
+    this.x += tx;
+    if (goog.isNumber(opt_ty)) {
+      this.y += opt_ty;
+    }
+  }
+  return this;
+};
+
+
+/**
+ * Scales this coordinate by the given scale factors. The x and y values are
+ * scaled by {@code sx} and {@code opt_sy} respectively.  If {@code opt_sy}
+ * is not given, then {@code sx} is used for both x and y.
+ * @param {number} sx The scale factor to use for the x dimension.
+ * @param {number=} opt_sy The scale factor to use for the y dimension.
+ * @return {!goog.math.Coordinate} This coordinate after scaling.
+ */
+goog.math.Coordinate.prototype.scale = function(sx, opt_sy) {
+  var sy = goog.isNumber(opt_sy) ? opt_sy : sx;
+  this.x *= sx;
+  this.y *= sy;
+  return this;
+};
+
+
+/**
+ * Rotates this coordinate clockwise about the origin (or, optionally, the given
+ * center) by the given angle, in radians.
+ * @param {number} radians The angle by which to rotate this coordinate
+ *     clockwise about the given center, in radians.
+ * @param {!goog.math.Coordinate=} opt_center The center of rotation. Defaults
+ *     to (0, 0) if not given.
+ */
+goog.math.Coordinate.prototype.rotateRadians = function(radians, opt_center) {
+  var center = opt_center || new goog.math.Coordinate(0, 0);
+
+  var x = this.x;
+  var y = this.y;
+  var cos = Math.cos(radians);
+  var sin = Math.sin(radians);
+
+  this.x = (x - center.x) * cos - (y - center.y) * sin + center.x;
+  this.y = (x - center.x) * sin + (y - center.y) * cos + center.y;
+};
+
+
+/**
+ * Rotates this coordinate clockwise about the origin (or, optionally, the given
+ * center) by the given angle, in degrees.
+ * @param {number} degrees The angle by which to rotate this coordinate
+ *     clockwise about the given center, in degrees.
+ * @param {!goog.math.Coordinate=} opt_center The center of rotation. Defaults
+ *     to (0, 0) if not given.
+ */
+goog.math.Coordinate.prototype.rotateDegrees = function(degrees, opt_center) {
+  this.rotateRadians(goog.math.toRadians(degrees), opt_center);
+};
diff --git a/lib/goog/math/math.js b/lib/goog/math/math.js
new file mode 100644
index 0000000..f2082a3
--- /dev/null
+++ b/lib/goog/math/math.js
@@ -0,0 +1,451 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Additional mathematical functions.
+ */
+
+goog.provide('goog.math');
+
+goog.require('goog.array');
+goog.require('goog.asserts');
+
+
+/**
+ * Returns a random integer greater than or equal to 0 and less than {@code a}.
+ * @param {number} a  The upper bound for the random integer (exclusive).
+ * @return {number} A random integer N such that 0 <= N < a.
+ */
+goog.math.randomInt = function(a) {
+  return Math.floor(Math.random() * a);
+};
+
+
+/**
+ * Returns a random number greater than or equal to {@code a} and less than
+ * {@code b}.
+ * @param {number} a  The lower bound for the random number (inclusive).
+ * @param {number} b  The upper bound for the random number (exclusive).
+ * @return {number} A random number N such that a <= N < b.
+ */
+goog.math.uniformRandom = function(a, b) {
+  return a + Math.random() * (b - a);
+};
+
+
+/**
+ * Takes a number and clamps it to within the provided bounds.
+ * @param {number} value The input number.
+ * @param {number} min The minimum value to return.
+ * @param {number} max The maximum value to return.
+ * @return {number} The input number if it is within bounds, or the nearest
+ *     number within the bounds.
+ */
+goog.math.clamp = function(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+};
+
+
+/**
+ * The % operator in JavaScript returns the remainder of a / b, but differs from
+ * some other languages in that the result will have the same sign as the
+ * dividend. For example, -1 % 8 == -1, whereas in some other languages
+ * (such as Python) the result would be 7. This function emulates the more
+ * correct modulo behavior, which is useful for certain applications such as
+ * calculating an offset index in a circular list.
+ *
+ * @param {number} a The dividend.
+ * @param {number} b The divisor.
+ * @return {number} a % b where the result is between 0 and b (either 0 <= x < b
+ *     or b < x <= 0, depending on the sign of b).
+ */
+goog.math.modulo = function(a, b) {
+  var r = a % b;
+  // If r and b differ in sign, add b to wrap the result to the correct sign.
+  return (r * b < 0) ? r + b : r;
+};
+
+
+/**
+ * Performs linear interpolation between values a and b. Returns the value
+ * between a and b proportional to x (when x is between 0 and 1. When x is
+ * outside this range, the return value is a linear extrapolation).
+ * @param {number} a A number.
+ * @param {number} b A number.
+ * @param {number} x The proportion between a and b.
+ * @return {number} The interpolated value between a and b.
+ */
+goog.math.lerp = function(a, b, x) {
+  return a + x * (b - a);
+};
+
+
+/**
+ * Tests whether the two values are equal to each other, within a certain
+ * tolerance to adjust for floating point errors.
+ * @param {number} a A number.
+ * @param {number} b A number.
+ * @param {number=} opt_tolerance Optional tolerance range. Defaults
+ *     to 0.000001. If specified, should be greater than 0.
+ * @return {boolean} Whether {@code a} and {@code b} are nearly equal.
+ */
+goog.math.nearlyEquals = function(a, b, opt_tolerance) {
+  return Math.abs(a - b) <= (opt_tolerance || 0.000001);
+};
+
+
+// TODO(user): Rename to normalizeAngle, retaining old name as deprecated
+// alias.
+/**
+ * Normalizes an angle to be in range [0-360). Angles outside this range will
+ * be normalized to be the equivalent angle with that range.
+ * @param {number} angle Angle in degrees.
+ * @return {number} Standardized angle.
+ */
+goog.math.standardAngle = function(angle) {
+  return goog.math.modulo(angle, 360);
+};
+
+
+/**
+ * Normalizes an angle to be in range [0-2*PI). Angles outside this range will
+ * be normalized to be the equivalent angle with that range.
+ * @param {number} angle Angle in radians.
+ * @return {number} Standardized angle.
+ */
+goog.math.standardAngleInRadians = function(angle) {
+  return goog.math.modulo(angle, 2 * Math.PI);
+};
+
+
+/**
+ * Converts degrees to radians.
+ * @param {number} angleDegrees Angle in degrees.
+ * @return {number} Angle in radians.
+ */
+goog.math.toRadians = function(angleDegrees) {
+  return angleDegrees * Math.PI / 180;
+};
+
+
+/**
+ * Converts radians to degrees.
+ * @param {number} angleRadians Angle in radians.
+ * @return {number} Angle in degrees.
+ */
+goog.math.toDegrees = function(angleRadians) {
+  return angleRadians * 180 / Math.PI;
+};
+
+
+/**
+ * For a given angle and radius, finds the X portion of the offset.
+ * @param {number} degrees Angle in degrees (zero points in +X direction).
+ * @param {number} radius Radius.
+ * @return {number} The x-distance for the angle and radius.
+ */
+goog.math.angleDx = function(degrees, radius) {
+  return radius * Math.cos(goog.math.toRadians(degrees));
+};
+
+
+/**
+ * For a given angle and radius, finds the Y portion of the offset.
+ * @param {number} degrees Angle in degrees (zero points in +X direction).
+ * @param {number} radius Radius.
+ * @return {number} The y-distance for the angle and radius.
+ */
+goog.math.angleDy = function(degrees, radius) {
+  return radius * Math.sin(goog.math.toRadians(degrees));
+};
+
+
+/**
+ * Computes the angle between two points (x1,y1) and (x2,y2).
+ * Angle zero points in the +X direction, 90 degrees points in the +Y
+ * direction (down) and from there we grow clockwise towards 360 degrees.
+ * @param {number} x1 x of first point.
+ * @param {number} y1 y of first point.
+ * @param {number} x2 x of second point.
+ * @param {number} y2 y of second point.
+ * @return {number} Standardized angle in degrees of the vector from
+ *     x1,y1 to x2,y2.
+ */
+goog.math.angle = function(x1, y1, x2, y2) {
+  return goog.math.standardAngle(goog.math.toDegrees(Math.atan2(y2 - y1,
+                                                                x2 - x1)));
+};
+
+
+/**
+ * Computes the difference between startAngle and endAngle (angles in degrees).
+ * @param {number} startAngle  Start angle in degrees.
+ * @param {number} endAngle  End angle in degrees.
+ * @return {number} The number of degrees that when added to
+ *     startAngle will result in endAngle. Positive numbers mean that the
+ *     direction is clockwise. Negative numbers indicate a counter-clockwise
+ *     direction.
+ *     The shortest route (clockwise vs counter-clockwise) between the angles
+ *     is used.
+ *     When the difference is 180 degrees, the function returns 180 (not -180)
+ *     angleDifference(30, 40) is 10, and angleDifference(40, 30) is -10.
+ *     angleDifference(350, 10) is 20, and angleDifference(10, 350) is -20.
+ */
+goog.math.angleDifference = function(startAngle, endAngle) {
+  var d = goog.math.standardAngle(endAngle) -
+          goog.math.standardAngle(startAngle);
+  if (d > 180) {
+    d = d - 360;
+  } else if (d <= -180) {
+    d = 360 + d;
+  }
+  return d;
+};
+
+
+/**
+ * Returns the sign of a number as per the "sign" or "signum" function.
+ * @param {number} x The number to take the sign of.
+ * @return {number} -1 when negative, 1 when positive, 0 when 0. Preserves
+ *     signed zeros and NaN.
+ */
+goog.math.sign = Math.sign || function(x) {
+  if (x > 0) {
+    return 1;
+  }
+  if (x < 0) {
+    return -1;
+  }
+  return x;  // Preserves signed zeros and NaN.
+};
+
+
+/**
+ * JavaScript implementation of Longest Common Subsequence problem.
+ * http://en.wikipedia.org/wiki/Longest_common_subsequence
+ *
+ * Returns the longest possible array that is subarray of both of given arrays.
+ *
+ * @param {Array<Object>} array1 First array of objects.
+ * @param {Array<Object>} array2 Second array of objects.
+ * @param {Function=} opt_compareFn Function that acts as a custom comparator
+ *     for the array ojects. Function should return true if objects are equal,
+ *     otherwise false.
+ * @param {Function=} opt_collectorFn Function used to decide what to return
+ *     as a result subsequence. It accepts 2 arguments: index of common element
+ *     in the first array and index in the second. The default function returns
+ *     element from the first array.
+ * @return {!Array<Object>} A list of objects that are common to both arrays
+ *     such that there is no common subsequence with size greater than the
+ *     length of the list.
+ */
+goog.math.longestCommonSubsequence = function(
+    array1, array2, opt_compareFn, opt_collectorFn) {
+
+  var compare = opt_compareFn || function(a, b) {
+    return a == b;
+  };
+
+  var collect = opt_collectorFn || function(i1, i2) {
+    return array1[i1];
+  };
+
+  var length1 = array1.length;
+  var length2 = array2.length;
+
+  var arr = [];
+  for (var i = 0; i < length1 + 1; i++) {
+    arr[i] = [];
+    arr[i][0] = 0;
+  }
+
+  for (var j = 0; j < length2 + 1; j++) {
+    arr[0][j] = 0;
+  }
+
+  for (i = 1; i <= length1; i++) {
+    for (j = 1; j <= length2; j++) {
+      if (compare(array1[i - 1], array2[j - 1])) {
+        arr[i][j] = arr[i - 1][j - 1] + 1;
+      } else {
+        arr[i][j] = Math.max(arr[i - 1][j], arr[i][j - 1]);
+      }
+    }
+  }
+
+  // Backtracking
+  var result = [];
+  var i = length1, j = length2;
+  while (i > 0 && j > 0) {
+    if (compare(array1[i - 1], array2[j - 1])) {
+      result.unshift(collect(i - 1, j - 1));
+      i--;
+      j--;
+    } else {
+      if (arr[i - 1][j] > arr[i][j - 1]) {
+        i--;
+      } else {
+        j--;
+      }
+    }
+  }
+
+  return result;
+};
+
+
+/**
+ * Returns the sum of the arguments.
+ * @param {...number} var_args Numbers to add.
+ * @return {number} The sum of the arguments (0 if no arguments were provided,
+ *     {@code NaN} if any of the arguments is not a valid number).
+ */
+goog.math.sum = function(var_args) {
+  return /** @type {number} */ (goog.array.reduce(arguments,
+      function(sum, value) {
+        return sum + value;
+      }, 0));
+};
+
+
+/**
+ * Returns the arithmetic mean of the arguments.
+ * @param {...number} var_args Numbers to average.
+ * @return {number} The average of the arguments ({@code NaN} if no arguments
+ *     were provided or any of the arguments is not a valid number).
+ */
+goog.math.average = function(var_args) {
+  return goog.math.sum.apply(null, arguments) / arguments.length;
+};
+
+
+/**
+ * Returns the unbiased sample variance of the arguments. For a definition,
+ * see e.g. http://en.wikipedia.org/wiki/Variance
+ * @param {...number} var_args Number samples to analyze.
+ * @return {number} The unbiased sample variance of the arguments (0 if fewer
+ *     than two samples were provided, or {@code NaN} if any of the samples is
+ *     not a valid number).
+ */
+goog.math.sampleVariance = function(var_args) {
+  var sampleSize = arguments.length;
+  if (sampleSize < 2) {
+    return 0;
+  }
+
+  var mean = goog.math.average.apply(null, arguments);
+  var variance = goog.math.sum.apply(null, goog.array.map(arguments,
+      function(val) {
+        return Math.pow(val - mean, 2);
+      })) / (sampleSize - 1);
+
+  return variance;
+};
+
+
+/**
+ * Returns the sample standard deviation of the arguments.  For a definition of
+ * sample standard deviation, see e.g.
+ * http://en.wikipedia.org/wiki/Standard_deviation
+ * @param {...number} var_args Number samples to analyze.
+ * @return {number} The sample standard deviation of the arguments (0 if fewer
+ *     than two samples were provided, or {@code NaN} if any of the samples is
+ *     not a valid number).
+ */
+goog.math.standardDeviation = function(var_args) {
+  return Math.sqrt(goog.math.sampleVariance.apply(null, arguments));
+};
+
+
+/**
+ * Returns whether the supplied number represents an integer, i.e. that is has
+ * no fractional component.  No range-checking is performed on the number.
+ * @param {number} num The number to test.
+ * @return {boolean} Whether {@code num} is an integer.
+ */
+goog.math.isInt = function(num) {
+  return isFinite(num) && num % 1 == 0;
+};
+
+
+/**
+ * Returns whether the supplied number is finite and not NaN.
+ * @param {number} num The number to test.
+ * @return {boolean} Whether {@code num} is a finite number.
+ */
+goog.math.isFiniteNumber = function(num) {
+  return isFinite(num) && !isNaN(num);
+};
+
+
+/**
+ * @param {number} num The number to test.
+ * @return {boolean} Whether it is negative zero.
+ */
+goog.math.isNegativeZero = function(num) {
+  return num == 0 && 1 / num < 0;
+};
+
+
+/**
+ * Returns the precise value of floor(log10(num)).
+ * Simpler implementations didn't work because of floating point rounding
+ * errors. For example
+ * <ul>
+ * <li>Math.floor(Math.log(num) / Math.LN10) is off by one for num == 1e+3.
+ * <li>Math.floor(Math.log(num) * Math.LOG10E) is off by one for num == 1e+15.
+ * <li>Math.floor(Math.log10(num)) is off by one for num == 1e+15 - 1.
+ * </ul>
+ * @param {number} num A floating point number.
+ * @return {number} Its logarithm to base 10 rounded down to the nearest
+ *     integer if num > 0. -Infinity if num == 0. NaN if num < 0.
+ */
+goog.math.log10Floor = function(num) {
+  if (num > 0) {
+    var x = Math.round(Math.log(num) * Math.LOG10E);
+    return x - (parseFloat('1e' + x) > num ? 1 : 0);
+  }
+  return num == 0 ? -Infinity : NaN;
+};
+
+
+/**
+ * A tweaked variant of {@code Math.floor} which tolerates if the passed number
+ * is infinitesimally smaller than the closest integer. It often happens with
+ * the results of floating point calculations because of the finite precision
+ * of the intermediate results. For example {@code Math.floor(Math.log(1000) /
+ * Math.LN10) == 2}, not 3 as one would expect.
+ * @param {number} num A number.
+ * @param {number=} opt_epsilon An infinitesimally small positive number, the
+ *     rounding error to tolerate.
+ * @return {number} The largest integer less than or equal to {@code num}.
+ */
+goog.math.safeFloor = function(num, opt_epsilon) {
+  goog.asserts.assert(!goog.isDef(opt_epsilon) || opt_epsilon > 0);
+  return Math.floor(num + (opt_epsilon || 2e-15));
+};
+
+
+/**
+ * A tweaked variant of {@code Math.ceil}. See {@code goog.math.safeFloor} for
+ * details.
+ * @param {number} num A number.
+ * @param {number=} opt_epsilon An infinitesimally small positive number, the
+ *     rounding error to tolerate.
+ * @return {number} The smallest integer greater than or equal to {@code num}.
+ */
+goog.math.safeCeil = function(num, opt_epsilon) {
+  goog.asserts.assert(!goog.isDef(opt_epsilon) || opt_epsilon > 0);
+  return Math.ceil(num - (opt_epsilon || 2e-15));
+};
diff --git a/lib/goog/math/rect.js b/lib/goog/math/rect.js
new file mode 100644
index 0000000..0a92b2e
--- /dev/null
+++ b/lib/goog/math/rect.js
@@ -0,0 +1,476 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A utility class for representing rectangles.
+ */
+
+goog.provide('goog.math.Rect');
+
+goog.require('goog.math.Box');
+goog.require('goog.math.Coordinate');
+goog.require('goog.math.Size');
+
+
+
+/**
+ * Class for representing rectangular regions.
+ * @param {number} x Left.
+ * @param {number} y Top.
+ * @param {number} w Width.
+ * @param {number} h Height.
+ * @struct
+ * @constructor
+ */
+goog.math.Rect = function(x, y, w, h) {
+  /** @type {number} */
+  this.left = x;
+
+  /** @type {number} */
+  this.top = y;
+
+  /** @type {number} */
+  this.width = w;
+
+  /** @type {number} */
+  this.height = h;
+};
+
+
+/**
+ * @return {!goog.math.Rect} A new copy of this Rectangle.
+ */
+goog.math.Rect.prototype.clone = function() {
+  return new goog.math.Rect(this.left, this.top, this.width, this.height);
+};
+
+
+/**
+ * Returns a new Box object with the same position and dimensions as this
+ * rectangle.
+ * @return {!goog.math.Box} A new Box representation of this Rectangle.
+ */
+goog.math.Rect.prototype.toBox = function() {
+  var right = this.left + this.width;
+  var bottom = this.top + this.height;
+  return new goog.math.Box(this.top,
+                           right,
+                           bottom,
+                           this.left);
+};
+
+
+/**
+ * Creates a new Rect object with the position and size given.
+ * @param {!goog.math.Coordinate} position The top-left coordinate of the Rect
+ * @param {!goog.math.Size} size The size of the Rect
+ * @return {!goog.math.Rect} A new Rect initialized with the given position and
+ *     size.
+ */
+goog.math.Rect.createFromPositionAndSize = function(position, size) {
+  return new goog.math.Rect(position.x, position.y, size.width, size.height);
+};
+
+
+/**
+ * Creates a new Rect object with the same position and dimensions as a given
+ * Box.  Note that this is only the inverse of toBox if left/top are defined.
+ * @param {goog.math.Box} box A box.
+ * @return {!goog.math.Rect} A new Rect initialized with the box's position
+ *     and size.
+ */
+goog.math.Rect.createFromBox = function(box) {
+  return new goog.math.Rect(box.left, box.top,
+      box.right - box.left, box.bottom - box.top);
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a nice string representing size and dimensions of rectangle.
+   * @return {string} In the form (50, 73 - 75w x 25h).
+   * @override
+   */
+  goog.math.Rect.prototype.toString = function() {
+    return '(' + this.left + ', ' + this.top + ' - ' + this.width + 'w x ' +
+           this.height + 'h)';
+  };
+}
+
+
+/**
+ * Compares rectangles for equality.
+ * @param {goog.math.Rect} a A Rectangle.
+ * @param {goog.math.Rect} b A Rectangle.
+ * @return {boolean} True iff the rectangles have the same left, top, width,
+ *     and height, or if both are null.
+ */
+goog.math.Rect.equals = function(a, b) {
+  if (a == b) {
+    return true;
+  }
+  if (!a || !b) {
+    return false;
+  }
+  return a.left == b.left && a.width == b.width &&
+         a.top == b.top && a.height == b.height;
+};
+
+
+/**
+ * Computes the intersection of this rectangle and the rectangle parameter.  If
+ * there is no intersection, returns false and leaves this rectangle as is.
+ * @param {goog.math.Rect} rect A Rectangle.
+ * @return {boolean} True iff this rectangle intersects with the parameter.
+ */
+goog.math.Rect.prototype.intersection = function(rect) {
+  var x0 = Math.max(this.left, rect.left);
+  var x1 = Math.min(this.left + this.width, rect.left + rect.width);
+
+  if (x0 <= x1) {
+    var y0 = Math.max(this.top, rect.top);
+    var y1 = Math.min(this.top + this.height, rect.top + rect.height);
+
+    if (y0 <= y1) {
+      this.left = x0;
+      this.top = y0;
+      this.width = x1 - x0;
+      this.height = y1 - y0;
+
+      return true;
+    }
+  }
+  return false;
+};
+
+
+/**
+ * Returns the intersection of two rectangles. Two rectangles intersect if they
+ * touch at all, for example, two zero width and height rectangles would
+ * intersect if they had the same top and left.
+ * @param {goog.math.Rect} a A Rectangle.
+ * @param {goog.math.Rect} b A Rectangle.
+ * @return {goog.math.Rect} A new intersection rect (even if width and height
+ *     are 0), or null if there is no intersection.
+ */
+goog.math.Rect.intersection = function(a, b) {
+  // There is no nice way to do intersection via a clone, because any such
+  // clone might be unnecessary if this function returns null.  So, we duplicate
+  // code from above.
+
+  var x0 = Math.max(a.left, b.left);
+  var x1 = Math.min(a.left + a.width, b.left + b.width);
+
+  if (x0 <= x1) {
+    var y0 = Math.max(a.top, b.top);
+    var y1 = Math.min(a.top + a.height, b.top + b.height);
+
+    if (y0 <= y1) {
+      return new goog.math.Rect(x0, y0, x1 - x0, y1 - y0);
+    }
+  }
+  return null;
+};
+
+
+/**
+ * Returns whether two rectangles intersect. Two rectangles intersect if they
+ * touch at all, for example, two zero width and height rectangles would
+ * intersect if they had the same top and left.
+ * @param {goog.math.Rect} a A Rectangle.
+ * @param {goog.math.Rect} b A Rectangle.
+ * @return {boolean} Whether a and b intersect.
+ */
+goog.math.Rect.intersects = function(a, b) {
+  return (a.left <= b.left + b.width && b.left <= a.left + a.width &&
+      a.top <= b.top + b.height && b.top <= a.top + a.height);
+};
+
+
+/**
+ * Returns whether a rectangle intersects this rectangle.
+ * @param {goog.math.Rect} rect A rectangle.
+ * @return {boolean} Whether rect intersects this rectangle.
+ */
+goog.math.Rect.prototype.intersects = function(rect) {
+  return goog.math.Rect.intersects(this, rect);
+};
+
+
+/**
+ * Computes the difference regions between two rectangles. The return value is
+ * an array of 0 to 4 rectangles defining the remaining regions of the first
+ * rectangle after the second has been subtracted.
+ * @param {goog.math.Rect} a A Rectangle.
+ * @param {goog.math.Rect} b A Rectangle.
+ * @return {!Array<!goog.math.Rect>} An array with 0 to 4 rectangles which
+ *     together define the difference area of rectangle a minus rectangle b.
+ */
+goog.math.Rect.difference = function(a, b) {
+  var intersection = goog.math.Rect.intersection(a, b);
+  if (!intersection || !intersection.height || !intersection.width) {
+    return [a.clone()];
+  }
+
+  var result = [];
+
+  var top = a.top;
+  var height = a.height;
+
+  var ar = a.left + a.width;
+  var ab = a.top + a.height;
+
+  var br = b.left + b.width;
+  var bb = b.top + b.height;
+
+  // Subtract off any area on top where A extends past B
+  if (b.top > a.top) {
+    result.push(new goog.math.Rect(a.left, a.top, a.width, b.top - a.top));
+    top = b.top;
+    // If we're moving the top down, we also need to subtract the height diff.
+    height -= b.top - a.top;
+  }
+  // Subtract off any area on bottom where A extends past B
+  if (bb < ab) {
+    result.push(new goog.math.Rect(a.left, bb, a.width, ab - bb));
+    height = bb - top;
+  }
+  // Subtract any area on left where A extends past B
+  if (b.left > a.left) {
+    result.push(new goog.math.Rect(a.left, top, b.left - a.left, height));
+  }
+  // Subtract any area on right where A extends past B
+  if (br < ar) {
+    result.push(new goog.math.Rect(br, top, ar - br, height));
+  }
+
+  return result;
+};
+
+
+/**
+ * Computes the difference regions between this rectangle and {@code rect}. The
+ * return value is an array of 0 to 4 rectangles defining the remaining regions
+ * of this rectangle after the other has been subtracted.
+ * @param {goog.math.Rect} rect A Rectangle.
+ * @return {!Array<!goog.math.Rect>} An array with 0 to 4 rectangles which
+ *     together define the difference area of rectangle a minus rectangle b.
+ */
+goog.math.Rect.prototype.difference = function(rect) {
+  return goog.math.Rect.difference(this, rect);
+};
+
+
+/**
+ * Expand this rectangle to also include the area of the given rectangle.
+ * @param {goog.math.Rect} rect The other rectangle.
+ */
+goog.math.Rect.prototype.boundingRect = function(rect) {
+  // We compute right and bottom before we change left and top below.
+  var right = Math.max(this.left + this.width, rect.left + rect.width);
+  var bottom = Math.max(this.top + this.height, rect.top + rect.height);
+
+  this.left = Math.min(this.left, rect.left);
+  this.top = Math.min(this.top, rect.top);
+
+  this.width = right - this.left;
+  this.height = bottom - this.top;
+};
+
+
+/**
+ * Returns a new rectangle which completely contains both input rectangles.
+ * @param {goog.math.Rect} a A rectangle.
+ * @param {goog.math.Rect} b A rectangle.
+ * @return {goog.math.Rect} A new bounding rect, or null if either rect is
+ *     null.
+ */
+goog.math.Rect.boundingRect = function(a, b) {
+  if (!a || !b) {
+    return null;
+  }
+
+  var clone = a.clone();
+  clone.boundingRect(b);
+
+  return clone;
+};
+
+
+/**
+ * Tests whether this rectangle entirely contains another rectangle or
+ * coordinate.
+ *
+ * @param {goog.math.Rect|goog.math.Coordinate} another The rectangle or
+ *     coordinate to test for containment.
+ * @return {boolean} Whether this rectangle contains given rectangle or
+ *     coordinate.
+ */
+goog.math.Rect.prototype.contains = function(another) {
+  if (another instanceof goog.math.Rect) {
+    return this.left <= another.left &&
+           this.left + this.width >= another.left + another.width &&
+           this.top <= another.top &&
+           this.top + this.height >= another.top + another.height;
+  } else { // (another instanceof goog.math.Coordinate)
+    return another.x >= this.left &&
+           another.x <= this.left + this.width &&
+           another.y >= this.top &&
+           another.y <= this.top + this.height;
+  }
+};
+
+
+/**
+ * @param {!goog.math.Coordinate} point A coordinate.
+ * @return {number} The squared distance between the point and the closest
+ *     point inside the rectangle. Returns 0 if the point is inside the
+ *     rectangle.
+ */
+goog.math.Rect.prototype.squaredDistance = function(point) {
+  var dx = point.x < this.left ?
+      this.left - point.x : Math.max(point.x - (this.left + this.width), 0);
+  var dy = point.y < this.top ?
+      this.top - point.y : Math.max(point.y - (this.top + this.height), 0);
+  return dx * dx + dy * dy;
+};
+
+
+/**
+ * @param {!goog.math.Coordinate} point A coordinate.
+ * @return {number} The distance between the point and the closest point
+ *     inside the rectangle. Returns 0 if the point is inside the rectangle.
+ */
+goog.math.Rect.prototype.distance = function(point) {
+  return Math.sqrt(this.squaredDistance(point));
+};
+
+
+/**
+ * @return {!goog.math.Size} The size of this rectangle.
+ */
+goog.math.Rect.prototype.getSize = function() {
+  return new goog.math.Size(this.width, this.height);
+};
+
+
+/**
+ * @return {!goog.math.Coordinate} A new coordinate for the top-left corner of
+ *     the rectangle.
+ */
+goog.math.Rect.prototype.getTopLeft = function() {
+  return new goog.math.Coordinate(this.left, this.top);
+};
+
+
+/**
+ * @return {!goog.math.Coordinate} A new coordinate for the center of the
+ *     rectangle.
+ */
+goog.math.Rect.prototype.getCenter = function() {
+  return new goog.math.Coordinate(
+      this.left + this.width / 2, this.top + this.height / 2);
+};
+
+
+/**
+ * @return {!goog.math.Coordinate} A new coordinate for the bottom-right corner
+ *     of the rectangle.
+ */
+goog.math.Rect.prototype.getBottomRight = function() {
+  return new goog.math.Coordinate(
+      this.left + this.width, this.top + this.height);
+};
+
+
+/**
+ * Rounds the fields to the next larger integer values.
+ * @return {!goog.math.Rect} This rectangle with ceil'd fields.
+ */
+goog.math.Rect.prototype.ceil = function() {
+  this.left = Math.ceil(this.left);
+  this.top = Math.ceil(this.top);
+  this.width = Math.ceil(this.width);
+  this.height = Math.ceil(this.height);
+  return this;
+};
+
+
+/**
+ * Rounds the fields to the next smaller integer values.
+ * @return {!goog.math.Rect} This rectangle with floored fields.
+ */
+goog.math.Rect.prototype.floor = function() {
+  this.left = Math.floor(this.left);
+  this.top = Math.floor(this.top);
+  this.width = Math.floor(this.width);
+  this.height = Math.floor(this.height);
+  return this;
+};
+
+
+/**
+ * Rounds the fields to nearest integer values.
+ * @return {!goog.math.Rect} This rectangle with rounded fields.
+ */
+goog.math.Rect.prototype.round = function() {
+  this.left = Math.round(this.left);
+  this.top = Math.round(this.top);
+  this.width = Math.round(this.width);
+  this.height = Math.round(this.height);
+  return this;
+};
+
+
+/**
+ * Translates this rectangle by the given offsets. If a
+ * {@code goog.math.Coordinate} is given, then the left and top values are
+ * translated by the coordinate's x and y values. Otherwise, top and left are
+ * translated by {@code tx} and {@code opt_ty} respectively.
+ * @param {number|goog.math.Coordinate} tx The value to translate left by or the
+ *     the coordinate to translate this rect by.
+ * @param {number=} opt_ty The value to translate top by.
+ * @return {!goog.math.Rect} This rectangle after translating.
+ */
+goog.math.Rect.prototype.translate = function(tx, opt_ty) {
+  if (tx instanceof goog.math.Coordinate) {
+    this.left += tx.x;
+    this.top += tx.y;
+  } else {
+    this.left += tx;
+    if (goog.isNumber(opt_ty)) {
+      this.top += opt_ty;
+    }
+  }
+  return this;
+};
+
+
+/**
+ * Scales this rectangle by the given scale factors. The left and width values
+ * are scaled by {@code sx} and the top and height values are scaled by
+ * {@code opt_sy}.  If {@code opt_sy} is not given, then all fields are scaled
+ * by {@code sx}.
+ * @param {number} sx The scale factor to use for the x dimension.
+ * @param {number=} opt_sy The scale factor to use for the y dimension.
+ * @return {!goog.math.Rect} This rectangle after scaling.
+ */
+goog.math.Rect.prototype.scale = function(sx, opt_sy) {
+  var sy = goog.isNumber(opt_sy) ? opt_sy : sx;
+  this.left *= sx;
+  this.width *= sx;
+  this.top *= sy;
+  this.height *= sy;
+  return this;
+};
diff --git a/lib/goog/math/size.js b/lib/goog/math/size.js
new file mode 100644
index 0000000..f5c379b
--- /dev/null
+++ b/lib/goog/math/size.js
@@ -0,0 +1,227 @@
+// Copyright 2007 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A utility class for representing two-dimensional sizes.
+ * @author brenneman@google.com (Shawn Brenneman)
+ */
+
+
+goog.provide('goog.math.Size');
+
+
+
+/**
+ * Class for representing sizes consisting of a width and height. Undefined
+ * width and height support is deprecated and results in compiler warning.
+ * @param {number} width Width.
+ * @param {number} height Height.
+ * @struct
+ * @constructor
+ */
+goog.math.Size = function(width, height) {
+  /**
+   * Width
+   * @type {number}
+   */
+  this.width = width;
+
+  /**
+   * Height
+   * @type {number}
+   */
+  this.height = height;
+};
+
+
+/**
+ * Compares sizes for equality.
+ * @param {goog.math.Size} a A Size.
+ * @param {goog.math.Size} b A Size.
+ * @return {boolean} True iff the sizes have equal widths and equal
+ *     heights, or if both are null.
+ */
+goog.math.Size.equals = function(a, b) {
+  if (a == b) {
+    return true;
+  }
+  if (!a || !b) {
+    return false;
+  }
+  return a.width == b.width && a.height == b.height;
+};
+
+
+/**
+ * @return {!goog.math.Size} A new copy of the Size.
+ */
+goog.math.Size.prototype.clone = function() {
+  return new goog.math.Size(this.width, this.height);
+};
+
+
+if (goog.DEBUG) {
+  /**
+   * Returns a nice string representing size.
+   * @return {string} In the form (50 x 73).
+   * @override
+   */
+  goog.math.Size.prototype.toString = function() {
+    return '(' + this.width + ' x ' + this.height + ')';
+  };
+}
+
+
+/**
+ * @return {number} The longer of the two dimensions in the size.
+ */
+goog.math.Size.prototype.getLongest = function() {
+  return Math.max(this.width, this.height);
+};
+
+
+/**
+ * @return {number} The shorter of the two dimensions in the size.
+ */
+goog.math.Size.prototype.getShortest = function() {
+  return Math.min(this.width, this.height);
+};
+
+
+/**
+ * @return {number} The area of the size (width * height).
+ */
+goog.math.Size.prototype.area = function() {
+  return this.width * this.height;
+};
+
+
+/**
+ * @return {number} The perimeter of the size (width + height) * 2.
+ */
+goog.math.Size.prototype.perimeter = function() {
+  return (this.width + this.height) * 2;
+};
+
+
+/**
+ * @return {number} The ratio of the size's width to its height.
+ */
+goog.math.Size.prototype.aspectRatio = function() {
+  return this.width / this.height;
+};
+
+
+/**
+ * @return {boolean} True if the size has zero area, false if both dimensions
+ *     are non-zero numbers.
+ */
+goog.math.Size.prototype.isEmpty = function() {
+  return !this.area();
+};
+
+
+/**
+ * Clamps the width and height parameters upward to integer values.
+ * @return {!goog.math.Size} This size with ceil'd components.
+ */
+goog.math.Size.prototype.ceil = function() {
+  this.width = Math.ceil(this.width);
+  this.height = Math.ceil(this.height);
+  return this;
+};
+
+
+/**
+ * @param {!goog.math.Size} target The target size.
+ * @return {boolean} True if this Size is the same size or smaller than the
+ *     target size in both dimensions.
+ */
+goog.math.Size.prototype.fitsInside = function(target) {
+  return this.width <= target.width && this.height <= target.height;
+};
+
+
+/**
+ * Clamps the width and height parameters downward to integer values.
+ * @return {!goog.math.Size} This size with floored components.
+ */
+goog.math.Size.prototype.floor = function() {
+  this.width = Math.floor(this.width);
+  this.height = Math.floor(this.height);
+  return this;
+};
+
+
+/**
+ * Rounds the width and height parameters to integer values.
+ * @return {!goog.math.Size} This size with rounded components.
+ */
+goog.math.Size.prototype.round = function() {
+  this.width = Math.round(this.width);
+  this.height = Math.round(this.height);
+  return this;
+};
+
+
+/**
+ * Scales this size by the given scale factors. The width and height are scaled
+ * by {@code sx} and {@code opt_sy} respectively.  If {@code opt_sy} is not
+ * given, then {@code sx} is used for both the width and height.
+ * @param {number} sx The scale factor to use for the width.
+ * @param {number=} opt_sy The scale factor to use for the height.
+ * @return {!goog.math.Size} This Size object after scaling.
+ */
+goog.math.Size.prototype.scale = function(sx, opt_sy) {
+  var sy = goog.isNumber(opt_sy) ? opt_sy : sx;
+  this.width *= sx;
+  this.height *= sy;
+  return this;
+};
+
+
+/**
+ * Uniformly scales the size to perfectly cover the dimensions of a given size.
+ * If the size is already larger than the target, it will be scaled down to the
+ * minimum size at which it still covers the entire target. The original aspect
+ * ratio will be preserved.
+ *
+ * This function assumes that both Sizes contain strictly positive dimensions.
+ * @param {!goog.math.Size} target The target size.
+ * @return {!goog.math.Size} This Size object, after optional scaling.
+ */
+goog.math.Size.prototype.scaleToCover = function(target) {
+  var s = this.aspectRatio() <= target.aspectRatio() ?
+      target.width / this.width :
+      target.height / this.height;
+
+  return this.scale(s);
+};
+
+
+/**
+ * Uniformly scales the size to fit inside the dimensions of a given size. The
+ * original aspect ratio will be preserved.
+ *
+ * This function assumes that both Sizes contain strictly positive dimensions.
+ * @param {!goog.math.Size} target The target size.
+ * @return {!goog.math.Size} This Size object, after optional scaling.
+ */
+goog.math.Size.prototype.scaleToFit = function(target) {
+  var s = this.aspectRatio() > target.aspectRatio() ?
+      target.width / this.width :
+      target.height / this.height;
+
+  return this.scale(s);
+};
diff --git a/lib/goog/net/wrapperxmlhttpfactory.js b/lib/goog/net/wrapperxmlhttpfactory.js
index 2a0a159..7615693 100644
--- a/lib/goog/net/wrapperxmlhttpfactory.js
+++ b/lib/goog/net/wrapperxmlhttpfactory.js
@@ -20,6 +20,8 @@
 
 goog.provide('goog.net.WrapperXmlHttpFactory');
 
+/** @suppress {extraRequire} Typedef. */
+goog.require('goog.net.XhrLike');
 goog.require('goog.net.XmlHttpFactory');
 
 
@@ -28,19 +30,20 @@ goog.require('goog.net.XmlHttpFactory');
  * An xhr factory subclass which can be constructed using two factory methods.
  * This exists partly to allow the preservation of goog.net.XmlHttp.setFactory()
  * with an unchanged signature.
- * @param {function() : !(XMLHttpRequest|GearsHttpRequest)} xhrFactory A
- *     function which returns a new XHR object.
- * @param {function() : !Object} optionsFactory A function which returns the
+ * @param {function():!goog.net.XhrLike.OrNative} xhrFactory
+ *     A function which returns a new XHR object.
+ * @param {function():!Object} optionsFactory A function which returns the
  *     options associated with xhr objects from this factory.
  * @extends {goog.net.XmlHttpFactory}
  * @constructor
+ * @final
  */
 goog.net.WrapperXmlHttpFactory = function(xhrFactory, optionsFactory) {
   goog.net.XmlHttpFactory.call(this);
 
   /**
    * XHR factory method.
-   * @type {function() : !(XMLHttpRequest|GearsHttpRequest)}
+   * @type {function() : !goog.net.XhrLike.OrNative}
    * @private
    */
   this.xhrFactory_ = xhrFactory;
diff --git a/lib/goog/net/xhrlike.js b/lib/goog/net/xhrlike.js
new file mode 100644
index 0000000..4cb26f2
--- /dev/null
+++ b/lib/goog/net/xhrlike.js
@@ -0,0 +1,124 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.net.XhrLike');
+
+
+
+/**
+ * Interface for the common parts of XMLHttpRequest.
+ *
+ * Mostly copied from externs/w3c_xml.js.
+ *
+ * @interface
+ * @see http://www.w3.org/TR/XMLHttpRequest/
+ */
+goog.net.XhrLike = function() {};
+
+
+/**
+ * Typedef that refers to either native or custom-implemented XHR objects.
+ * @typedef {!goog.net.XhrLike|!XMLHttpRequest}
+ */
+goog.net.XhrLike.OrNative;
+
+
+/**
+ * @type {function()|null|undefined}
+ * @see http://www.w3.org/TR/XMLHttpRequest/#handler-xhr-onreadystatechange
+ */
+goog.net.XhrLike.prototype.onreadystatechange;
+
+
+/**
+ * @type {string}
+ * @see http://www.w3.org/TR/XMLHttpRequest/#the-responsetext-attribute
+ */
+goog.net.XhrLike.prototype.responseText;
+
+
+/**
+ * @type {Document}
+ * @see http://www.w3.org/TR/XMLHttpRequest/#the-responsexml-attribute
+ */
+goog.net.XhrLike.prototype.responseXML;
+
+
+/**
+ * @type {number}
+ * @see http://www.w3.org/TR/XMLHttpRequest/#readystate
+ */
+goog.net.XhrLike.prototype.readyState;
+
+
+/**
+ * @type {number}
+ * @see http://www.w3.org/TR/XMLHttpRequest/#status
+ */
+goog.net.XhrLike.prototype.status;
+
+
+/**
+ * @type {string}
+ * @see http://www.w3.org/TR/XMLHttpRequest/#statustext
+ */
+goog.net.XhrLike.prototype.statusText;
+
+
+/**
+ * @param {string} method
+ * @param {string} url
+ * @param {?boolean=} opt_async
+ * @param {?string=} opt_user
+ * @param {?string=} opt_password
+ * @see http://www.w3.org/TR/XMLHttpRequest/#the-open()-method
+ */
+goog.net.XhrLike.prototype.open = function(method, url, opt_async, opt_user,
+    opt_password) {};
+
+
+/**
+ * @param {ArrayBuffer|ArrayBufferView|Blob|Document|FormData|string=} opt_data
+ * @see http://www.w3.org/TR/XMLHttpRequest/#the-send()-method
+ */
+goog.net.XhrLike.prototype.send = function(opt_data) {};
+
+
+/**
+ * @see http://www.w3.org/TR/XMLHttpRequest/#the-abort()-method
+ */
+goog.net.XhrLike.prototype.abort = function() {};
+
+
+/**
+ * @param {string} header
+ * @param {string} value
+ * @see http://www.w3.org/TR/XMLHttpRequest/#the-setrequestheader()-method
+ */
+goog.net.XhrLike.prototype.setRequestHeader = function(header, value) {};
+
+
+/**
+ * @param {string} header
+ * @return {string}
+ * @see http://www.w3.org/TR/XMLHttpRequest/#the-getresponseheader()-method
+ */
+goog.net.XhrLike.prototype.getResponseHeader = function(header) {};
+
+
+/**
+ * @return {string}
+ * @see http://www.w3.org/TR/XMLHttpRequest/#the-getallresponseheaders()-method
+ */
+goog.net.XhrLike.prototype.getAllResponseHeaders = function() {};
diff --git a/lib/goog/net/xmlhttp.js b/lib/goog/net/xmlhttp.js
index 9d743aa..8d59f00 100644
--- a/lib/goog/net/xmlhttp.js
+++ b/lib/goog/net/xmlhttp.js
@@ -22,14 +22,16 @@ goog.provide('goog.net.DefaultXmlHttpFactory');
 goog.provide('goog.net.XmlHttp');
 goog.provide('goog.net.XmlHttp.OptionType');
 goog.provide('goog.net.XmlHttp.ReadyState');
+goog.provide('goog.net.XmlHttpDefines');
 
+goog.require('goog.asserts');
 goog.require('goog.net.WrapperXmlHttpFactory');
 goog.require('goog.net.XmlHttpFactory');
 
 
 /**
  * Static class for creating XMLHttpRequest objects.
- * @return {!(XMLHttpRequest|GearsHttpRequest)} A new XMLHttpRequest object.
+ * @return {!goog.net.XhrLike.OrNative} A new XMLHttpRequest object.
  */
 goog.net.XmlHttp = function() {
   return goog.net.XmlHttp.factory_.createInstance();
@@ -38,11 +40,26 @@ goog.net.XmlHttp = function() {
 
 /**
  * @define {boolean} Whether to assume XMLHttpRequest exists. Setting this to
- *     true strips the ActiveX probing code.
+ *     true bypasses the ActiveX probing code.
+ * NOTE(ruilopes): Due to the way JSCompiler works, this define *will not* strip
+ * out the ActiveX probing code from binaries.  To achieve this, use
+ * {@code goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR} instead.
+ * TODO(ruilopes): Collapse both defines.
  */
 goog.define('goog.net.XmlHttp.ASSUME_NATIVE_XHR', false);
 
 
+/** @const */
+goog.net.XmlHttpDefines = {};
+
+
+/**
+ * @define {boolean} Whether to assume XMLHttpRequest exists. Setting this to
+ *     true eliminates the ActiveX probing code.
+ */
+goog.define('goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR', false);
+
+
 /**
  * Gets the options to use with the XMLHttpRequest objects obtained using
  * the static methods.
@@ -123,8 +140,8 @@ goog.net.XmlHttp.factory_;
  */
 goog.net.XmlHttp.setFactory = function(factory, optionsFactory) {
   goog.net.XmlHttp.setGlobalFactory(new goog.net.WrapperXmlHttpFactory(
-      /** @type {function() : !(XMLHttpRequest|GearsHttpRequest)} */ (factory),
-      /** @type {function() : !Object}*/ (optionsFactory)));
+      goog.asserts.assert(factory),
+      goog.asserts.assert(optionsFactory)));
 };
 
 
@@ -187,7 +204,8 @@ goog.net.DefaultXmlHttpFactory.prototype.ieProgId_;
  * @private
  */
 goog.net.DefaultXmlHttpFactory.prototype.getProgId_ = function() {
-  if (goog.net.XmlHttp.ASSUME_NATIVE_XHR) {
+  if (goog.net.XmlHttp.ASSUME_NATIVE_XHR ||
+      goog.net.XmlHttpDefines.ASSUME_NATIVE_XHR) {
     return '';
   }
 
diff --git a/lib/goog/net/xmlhttpfactory.js b/lib/goog/net/xmlhttpfactory.js
index ef2c719..8187edb 100644
--- a/lib/goog/net/xmlhttpfactory.js
+++ b/lib/goog/net/xmlhttpfactory.js
@@ -20,6 +20,9 @@
 
 goog.provide('goog.net.XmlHttpFactory');
 
+/** @suppress {extraRequire} Typedef. */
+goog.require('goog.net.XhrLike');
+
 
 
 /**
@@ -39,7 +42,7 @@ goog.net.XmlHttpFactory.prototype.cachedOptions_ = null;
 
 
 /**
- * @return {!(XMLHttpRequest|GearsHttpRequest)} A new XMLHttpRequest instance.
+ * @return {!goog.net.XhrLike.OrNative} A new XhrLike instance.
  */
 goog.net.XmlHttpFactory.prototype.createInstance = goog.abstractMethod;
 
diff --git a/lib/goog/object/object.js b/lib/goog/object/object.js
index fa5c08a..5832d9c 100644
--- a/lib/goog/object/object.js
+++ b/lib/goog/object/object.js
@@ -14,6 +14,7 @@
 
 /**
  * @fileoverview Utilities for manipulating objects/maps/hashes.
+ * @author arv@google.com (Erik Arvidsson)
  */
 
 goog.provide('goog.object');
@@ -22,10 +23,10 @@ goog.provide('goog.object');
 /**
  * Calls a function for each element in an object/map/hash.
  *
- * @param {Object.<K,V>} obj The object over which to iterate.
- * @param {function(this:T,V,?,Object.<K,V>):?} f The function to call
- *     for every element. This function takes 3 arguments (the element, the
- *     index and the object) and the return value is ignored.
+ * @param {Object<K,V>} obj The object over which to iterate.
+ * @param {function(this:T,V,?,Object<K,V>):?} f The function to call
+ *     for every element. This function takes 3 arguments (the value, the
+ *     key and the object) and the return value is ignored.
  * @param {T=} opt_obj This is used as the 'this' object within f.
  * @template T,K,V
  */
@@ -40,15 +41,15 @@ goog.object.forEach = function(obj, f, opt_obj) {
  * Calls a function for each element in an object/map/hash. If that call returns
  * true, adds the element to a new object.
  *
- * @param {Object.<K,V>} obj The object over which to iterate.
- * @param {function(this:T,V,?,Object.<K,V>):boolean} f The function to call
+ * @param {Object<K,V>} obj The object over which to iterate.
+ * @param {function(this:T,V,?,Object<K,V>):boolean} f The function to call
  *     for every element. This
- *     function takes 3 arguments (the element, the index and the object)
+ *     function takes 3 arguments (the value, the key and the object)
  *     and should return a boolean. If the return value is true the
  *     element is added to the result object. If it is false the
  *     element is not included.
  * @param {T=} opt_obj This is used as the 'this' object within f.
- * @return {!Object.<K,V>} a new object in which only elements that passed the
+ * @return {!Object<K,V>} a new object in which only elements that passed the
  *     test are present.
  * @template T,K,V
  */
@@ -67,14 +68,14 @@ goog.object.filter = function(obj, f, opt_obj) {
  * For every element in an object/map/hash calls a function and inserts the
  * result into a new object.
  *
- * @param {Object.<K,V>} obj The object over which to iterate.
- * @param {function(this:T,V,?,Object.<K,V>):R} f The function to call
+ * @param {Object<K,V>} obj The object over which to iterate.
+ * @param {function(this:T,V,?,Object<K,V>):R} f The function to call
  *     for every element. This function
- *     takes 3 arguments (the element, the index and the object)
+ *     takes 3 arguments (the value, the key and the object)
  *     and should return something. The result will be inserted
  *     into a new object.
  * @param {T=} opt_obj This is used as the 'this' object within f.
- * @return {!Object.<K,R>} a new object with the results from f.
+ * @return {!Object<K,R>} a new object with the results from f.
  * @template T,K,V,R
  */
 goog.object.map = function(obj, f, opt_obj) {
@@ -91,10 +92,10 @@ goog.object.map = function(obj, f, opt_obj) {
  * call returns true, returns true (without checking the rest). If
  * all calls return false, returns false.
  *
- * @param {Object.<K,V>} obj The object to check.
- * @param {function(this:T,V,?,Object.<K,V>):boolean} f The function to
+ * @param {Object<K,V>} obj The object to check.
+ * @param {function(this:T,V,?,Object<K,V>):boolean} f The function to
  *     call for every element. This function
- *     takes 3 arguments (the element, the index and the object) and should
+ *     takes 3 arguments (the value, the key and the object) and should
  *     return a boolean.
  * @param {T=} opt_obj This is used as the 'this' object within f.
  * @return {boolean} true if any element passes the test.
@@ -115,10 +116,10 @@ goog.object.some = function(obj, f, opt_obj) {
  * all calls return true, returns true. If any call returns false, returns
  * false at this point and does not continue to check the remaining elements.
  *
- * @param {Object.<K,V>} obj The object to check.
- * @param {?function(this:T,V,?,Object.<K,V>):boolean} f The function to
+ * @param {Object<K,V>} obj The object to check.
+ * @param {?function(this:T,V,?,Object<K,V>):boolean} f The function to
  *     call for every element. This function
- *     takes 3 arguments (the element, the index and the object) and should
+ *     takes 3 arguments (the value, the key and the object) and should
  *     return a boolean.
  * @param {T=} opt_obj This is used as the 'this' object within f.
  * @return {boolean} false if any element fails the test.
@@ -173,7 +174,7 @@ goog.object.getAnyKey = function(obj) {
  * For map literals the returned value will be the first one in most of the
  * browsers (a know exception is Konqueror).
  *
- * @param {Object.<K,V>} obj The object to pick a value from.
+ * @param {Object<K,V>} obj The object to pick a value from.
  * @return {V|undefined} The value or undefined if the object is empty.
  * @template K,V
  */
@@ -188,7 +189,7 @@ goog.object.getAnyValue = function(obj) {
  * Whether the object/hash/map contains the given object as a value.
  * An alias for goog.object.containsValue(obj, val).
  *
- * @param {Object.<K,V>} obj The object in which to look for val.
+ * @param {Object<K,V>} obj The object in which to look for val.
  * @param {V} val The object for which to check.
  * @return {boolean} true if val is present.
  * @template K,V
@@ -201,8 +202,8 @@ goog.object.contains = function(obj, val) {
 /**
  * Returns the values of the object/map/hash.
  *
- * @param {Object.<K,V>} obj The object from which to get the values.
- * @return {!Array.<V>} The values in the object/map/hash.
+ * @param {Object<K,V>} obj The object from which to get the values.
+ * @return {!Array<V>} The values in the object/map/hash.
  * @template K,V
  */
 goog.object.getValues = function(obj) {
@@ -219,7 +220,7 @@ goog.object.getValues = function(obj) {
  * Returns the keys of the object/map/hash.
  *
  * @param {Object} obj The object from which to get the keys.
- * @return {!Array.<string>} Array of property keys.
+ * @return {!Array<string>} Array of property keys.
  */
 goog.object.getKeys = function(obj) {
   var res = [];
@@ -237,7 +238,7 @@ goog.object.getKeys = function(obj) {
  * Example usage: getValueByKeys(jsonObj, 'foo', 'entries', 3)
  *
  * @param {!Object} obj An object to get the value from.  Can be array-like.
- * @param {...(string|number|!Array.<number|string>)} var_args A number of keys
+ * @param {...(string|number|!Array<number|string>)} var_args A number of keys
  *     (as strings, or numbers, for array-like objects).  Can also be
  *     specified as a single array of keys.
  * @return {*} The resulting value.  If, at any point, the value for a key
@@ -263,18 +264,18 @@ goog.object.getValueByKeys = function(obj, var_args) {
  * Whether the object/map/hash contains the given key.
  *
  * @param {Object} obj The object in which to look for key.
- * @param {*} key The key for which to check.
+ * @param {?} key The key for which to check.
  * @return {boolean} true If the map contains the key.
  */
 goog.object.containsKey = function(obj, key) {
-  return key in obj;
+  return obj !== null && key in obj;
 };
 
 
 /**
  * Whether the object/map/hash contains the given value. This is O(n).
  *
- * @param {Object.<K,V>} obj The object in which to look for val.
+ * @param {Object<K,V>} obj The object in which to look for val.
  * @param {V} val The value for which to check.
  * @return {boolean} true If the map contains the value.
  * @template K,V
@@ -292,8 +293,8 @@ goog.object.containsValue = function(obj, val) {
 /**
  * Searches an object for an element that satisfies the given condition and
  * returns its key.
- * @param {Object.<K,V>} obj The object to search in.
- * @param {function(this:T,V,string,Object.<K,V>):boolean} f The
+ * @param {Object<K,V>} obj The object to search in.
+ * @param {function(this:T,V,string,Object<K,V>):boolean} f The
  *      function to call for every element. Takes 3 arguments (the value,
  *     the key and the object) and should return a boolean.
  * @param {T=} opt_this An optional "this" context for the function.
@@ -314,8 +315,8 @@ goog.object.findKey = function(obj, f, opt_this) {
 /**
  * Searches an object for an element that satisfies the given condition and
  * returns its value.
- * @param {Object.<K,V>} obj The object to search in.
- * @param {function(this:T,V,string,Object.<K,V>):boolean} f The function
+ * @param {Object<K,V>} obj The object to search in.
+ * @param {function(this:T,V,string,Object<K,V>):boolean} f The function
  *     to call for every element. Takes 3 arguments (the value, the key
  *     and the object) and should return a boolean.
  * @param {T=} opt_this An optional "this" context for the function.
@@ -364,7 +365,7 @@ goog.object.clear = function(obj) {
  */
 goog.object.remove = function(obj, key) {
   var rv;
-  if ((rv = key in obj)) {
+  if (rv = key in /** @type {!Object} */ (obj)) {
     delete obj[key];
   }
   return rv;
@@ -375,13 +376,13 @@ goog.object.remove = function(obj, key) {
  * Adds a key-value pair to the object. Throws an exception if the key is
  * already in use. Use set if you want to change an existing pair.
  *
- * @param {Object.<K,V>} obj The object to which to add the key-value pair.
+ * @param {Object<K,V>} obj The object to which to add the key-value pair.
  * @param {string} key The key to add.
  * @param {V} val The value to add.
  * @template K,V
  */
 goog.object.add = function(obj, key, val) {
-  if (key in obj) {
+  if (obj !== null && key in obj) {
     throw Error('The object already contains the key "' + key + '"');
   }
   goog.object.set(obj, key, val);
@@ -391,7 +392,7 @@ goog.object.add = function(obj, key, val) {
 /**
  * Returns the value for the given key.
  *
- * @param {Object.<K,V>} obj The object from which to get the value.
+ * @param {Object<K,V>} obj The object from which to get the value.
  * @param {string} key The key for which to get the value.
  * @param {R=} opt_val The value to return if no item is found for the given
  *     key (default is undefined).
@@ -399,7 +400,7 @@ goog.object.add = function(obj, key, val) {
  * @template K,V,R
  */
 goog.object.get = function(obj, key, opt_val) {
-  if (key in obj) {
+  if (obj !== null && key in obj) {
     return obj[key];
   }
   return opt_val;
@@ -409,7 +410,7 @@ goog.object.get = function(obj, key, opt_val) {
 /**
  * Adds a key-value pair to the object/map/hash.
  *
- * @param {Object.<K,V>} obj The object to which to add the key-value pair.
+ * @param {Object<K,V>} obj The object to which to add the key-value pair.
  * @param {string} key The key to add.
  * @param {V} value The value to add.
  * @template K,V
@@ -422,22 +423,70 @@ goog.object.set = function(obj, key, value) {
 /**
  * Adds a key-value pair to the object/map/hash if it doesn't exist yet.
  *
- * @param {Object.<K,V>} obj The object to which to add the key-value pair.
+ * @param {Object<K,V>} obj The object to which to add the key-value pair.
  * @param {string} key The key to add.
  * @param {V} value The value to add if the key wasn't present.
  * @return {V} The value of the entry at the end of the function.
  * @template K,V
  */
 goog.object.setIfUndefined = function(obj, key, value) {
-  return key in obj ? obj[key] : (obj[key] = value);
+  return key in /** @type {!Object} */ (obj) ? obj[key] : (obj[key] = value);
+};
+
+
+/**
+ * Sets a key and value to an object if the key is not set. The value will be
+ * the return value of the given function. If the key already exists, the
+ * object will not be changed and the function will not be called (the function
+ * will be lazily evaluated -- only called if necessary).
+ *
+ * This function is particularly useful for use with a map used a as a cache.
+ *
+ * @param {!Object<K,V>} obj The object to which to add the key-value pair.
+ * @param {string} key The key to add.
+ * @param {function():V} f The value to add if the key wasn't present.
+ * @return {V} The value of the entry at the end of the function.
+ * @template K,V
+ */
+goog.object.setWithReturnValueIfNotSet = function(obj, key, f) {
+  if (key in obj) {
+    return obj[key];
+  }
+
+  var val = f();
+  obj[key] = val;
+  return val;
+};
+
+
+/**
+ * Compares two objects for equality using === on the values.
+ *
+ * @param {!Object<K,V>} a
+ * @param {!Object<K,V>} b
+ * @return {boolean}
+ * @template K,V
+ */
+goog.object.equals = function(a, b) {
+  for (var k in a) {
+    if (!(k in b) || a[k] !== b[k]) {
+      return false;
+    }
+  }
+  for (var k in b) {
+    if (!(k in a)) {
+      return false;
+    }
+  }
+  return true;
 };
 
 
 /**
  * Does a flat clone of the object.
  *
- * @param {Object.<K,V>} obj Object to clone.
- * @return {!Object.<K,V>} Clone of the input object.
+ * @param {Object<K,V>} obj Object to clone.
+ * @return {!Object<K,V>} Clone of the input object.
  * @template K,V
  */
 goog.object.clone = function(obj) {
@@ -470,7 +519,7 @@ goog.object.clone = function(obj) {
 goog.object.unsafeClone = function(obj) {
   var type = goog.typeOf(obj);
   if (type == 'object' || type == 'array') {
-    if (obj.clone) {
+    if (goog.isFunction(obj.clone)) {
       return obj.clone();
     }
     var clone = type == 'array' ? [] : {};
@@ -503,7 +552,7 @@ goog.object.transpose = function(obj) {
 
 /**
  * The names of the fields that are defined on Object.prototype.
- * @type {Array.<string>}
+ * @type {Array<string>}
  * @private
  */
 goog.object.PROTOTYPE_FIELDS_ = [
@@ -525,10 +574,12 @@ goog.object.PROTOTYPE_FIELDS_ = [
  * var o = {};
  * goog.object.extend(o, {a: 0, b: 1});
  * o; // {a: 0, b: 1}
- * goog.object.extend(o, {c: 2});
- * o; // {a: 0, b: 1, c: 2}
+ * goog.object.extend(o, {b: 2, c: 3});
+ * o; // {a: 0, b: 2, c: 3}
  *
- * @param {Object} target  The object to modify.
+ * @param {Object} target The object to modify. Existing properties will be
+ *     overwritten if they are also present in one of the objects in
+ *     {@code var_args}.
  * @param {...Object} var_args The objects from which values will be copied.
  */
 goog.object.extend = function(target, var_args) {
@@ -611,8 +662,8 @@ goog.object.createSet = function(var_args) {
  * In default mode, writes to this view will fail silently. In strict mode,
  * they will throw an error.
  *
- * @param {!Object.<K,V>} obj An object.
- * @return {!Object.<K,V>} An immutable view of that object, or the
+ * @param {!Object<K,V>} obj An object.
+ * @return {!Object<K,V>} An immutable view of that object, or the
  *     original object if this browser does not support immutables.
  * @template K,V
  */
diff --git a/lib/goog/promise/promise.js b/lib/goog/promise/promise.js
new file mode 100644
index 0000000..49d8233
--- /dev/null
+++ b/lib/goog/promise/promise.js
@@ -0,0 +1,1350 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.Promise');
+
+goog.require('goog.Thenable');
+goog.require('goog.asserts');
+goog.require('goog.async.FreeList');
+goog.require('goog.async.run');
+goog.require('goog.async.throwException');
+goog.require('goog.debug.Error');
+goog.require('goog.promise.Resolver');
+
+
+
+/**
+ * Promises provide a result that may be resolved asynchronously. A Promise may
+ * be resolved by being fulfilled with a fulfillment value, rejected with a
+ * rejection reason, or blocked by another Promise. A Promise is said to be
+ * settled if it is either fulfilled or rejected. Once settled, the Promise
+ * result is immutable.
+ *
+ * Promises may represent results of any type, including undefined. Rejection
+ * reasons are typically Errors, but may also be of any type. Closure Promises
+ * allow for optional type annotations that enforce that fulfillment values are
+ * of the appropriate types at compile time.
+ *
+ * The result of a Promise is accessible by calling {@code then} and registering
+ * {@code onFulfilled} and {@code onRejected} callbacks. Once the Promise
+ * is settled, the relevant callbacks are invoked with the fulfillment value or
+ * rejection reason as argument. Callbacks are always invoked in the order they
+ * were registered, even when additional {@code then} calls are made from inside
+ * another callback. A callback is always run asynchronously sometime after the
+ * scope containing the registering {@code then} invocation has returned.
+ *
+ * If a Promise is resolved with another Promise, the first Promise will block
+ * until the second is settled, and then assumes the same result as the second
+ * Promise. This allows Promises to depend on the results of other Promises,
+ * linking together multiple asynchronous operations.
+ *
+ * This implementation is compatible with the Promises/A+ specification and
+ * passes that specification's conformance test suite. A Closure Promise may be
+ * resolved with a Promise instance (or sufficiently compatible Promise-like
+ * object) created by other Promise implementations. From the specification,
+ * Promise-like objects are known as "Thenables".
+ *
+ * @see http://promisesaplus.com/
+ *
+ * @param {function(
+ *             this:RESOLVER_CONTEXT,
+ *             function((TYPE|IThenable<TYPE>|Thenable)=),
+ *             function(*=)): void} resolver
+ *     Initialization function that is invoked immediately with {@code resolve}
+ *     and {@code reject} functions as arguments. The Promise is resolved or
+ *     rejected with the first argument passed to either function.
+ * @param {RESOLVER_CONTEXT=} opt_context An optional context for executing the
+ *     resolver function. If unspecified, the resolver function will be executed
+ *     in the default scope.
+ * @constructor
+ * @struct
+ * @final
+ * @implements {goog.Thenable<TYPE>}
+ * @template TYPE,RESOLVER_CONTEXT
+ */
+goog.Promise = function(resolver, opt_context) {
+  /**
+   * The internal state of this Promise. Either PENDING, FULFILLED, REJECTED, or
+   * BLOCKED.
+   * @private {goog.Promise.State_}
+   */
+  this.state_ = goog.Promise.State_.PENDING;
+
+  /**
+   * The settled result of the Promise. Immutable once set with either a
+   * fulfillment value or rejection reason.
+   * @private {*}
+   */
+  this.result_ = undefined;
+
+  /**
+   * For Promises created by calling {@code then()}, the originating parent.
+   * @private {goog.Promise}
+   */
+  this.parent_ = null;
+
+  /**
+   * The linked list of {@code onFulfilled} and {@code onRejected} callbacks
+   * added to this Promise by calls to {@code then()}.
+   * @private {?goog.Promise.CallbackEntry_}
+   */
+  this.callbackEntries_ = null;
+
+  /**
+   * The tail of the linked list of {@code onFulfilled} and {@code onRejected}
+   * callbacks added to this Promise by calls to {@code then()}.
+   * @private {?goog.Promise.CallbackEntry_}
+   */
+  this.callbackEntriesTail_ = null;
+
+  /**
+   * Whether the Promise is in the queue of Promises to execute.
+   * @private {boolean}
+   */
+  this.executing_ = false;
+
+  if (goog.Promise.UNHANDLED_REJECTION_DELAY > 0) {
+    /**
+     * A timeout ID used when the {@code UNHANDLED_REJECTION_DELAY} is greater
+     * than 0 milliseconds. The ID is set when the Promise is rejected, and
+     * cleared only if an {@code onRejected} callback is invoked for the
+     * Promise (or one of its descendants) before the delay is exceeded.
+     *
+     * If the rejection is not handled before the timeout completes, the
+     * rejection reason is passed to the unhandled rejection handler.
+     * @private {number}
+     */
+    this.unhandledRejectionId_ = 0;
+  } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {
+    /**
+     * When the {@code UNHANDLED_REJECTION_DELAY} is set to 0 milliseconds, a
+     * boolean that is set if the Promise is rejected, and reset to false if an
+     * {@code onRejected} callback is invoked for the Promise (or one of its
+     * descendants). If the rejection is not handled before the next timestep,
+     * the rejection reason is passed to the unhandled rejection handler.
+     * @private {boolean}
+     */
+    this.hadUnhandledRejection_ = false;
+  }
+
+  if (goog.Promise.LONG_STACK_TRACES) {
+    /**
+     * A list of stack trace frames pointing to the locations where this Promise
+     * was created or had callbacks added to it. Saved to add additional context
+     * to stack traces when an exception is thrown.
+     * @private {!Array<string>}
+     */
+    this.stack_ = [];
+    this.addStackTrace_(new Error('created'));
+
+    /**
+     * Index of the most recently executed stack frame entry.
+     * @private {number}
+     */
+    this.currentStep_ = 0;
+  }
+
+  // As an optimization, we can skip this if resolver is goog.nullFunction.
+  // This value is passed internally when creating a promise which will be
+  // resolved through a more optimized path.
+  if (resolver != goog.nullFunction) {
+    try {
+      var self = this;
+      resolver.call(
+          opt_context,
+          function(value) {
+            self.resolve_(goog.Promise.State_.FULFILLED, value);
+          },
+          function(reason) {
+            if (goog.DEBUG &&
+                !(reason instanceof goog.Promise.CancellationError)) {
+              try {
+                // Promise was rejected. Step up one call frame to see why.
+                if (reason instanceof Error) {
+                  throw reason;
+                } else {
+                  throw new Error('Promise rejected.');
+                }
+              } catch (e) {
+                // Only thrown so browser dev tools can catch rejections of
+                // promises when the option to break on caught exceptions is
+                // activated.
+              }
+            }
+            self.resolve_(goog.Promise.State_.REJECTED, reason);
+          });
+    } catch (e) {
+      this.resolve_(goog.Promise.State_.REJECTED, e);
+    }
+  }
+};
+
+
+/**
+ * @define {boolean} Whether traces of {@code then} calls should be included in
+ * exceptions thrown
+ */
+goog.define('goog.Promise.LONG_STACK_TRACES', false);
+
+
+/**
+ * @define {number} The delay in milliseconds before a rejected Promise's reason
+ * is passed to the rejection handler. By default, the rejection handler
+ * rethrows the rejection reason so that it appears in the developer console or
+ * {@code window.onerror} handler.
+ *
+ * Rejections are rethrown as quickly as possible by default. A negative value
+ * disables rejection handling entirely.
+ */
+goog.define('goog.Promise.UNHANDLED_REJECTION_DELAY', 0);
+
+
+/**
+ * The possible internal states for a Promise. These states are not directly
+ * observable to external callers.
+ * @enum {number}
+ * @private
+ */
+goog.Promise.State_ = {
+  /** The Promise is waiting for resolution. */
+  PENDING: 0,
+
+  /** The Promise is blocked waiting for the result of another Thenable. */
+  BLOCKED: 1,
+
+  /** The Promise has been resolved with a fulfillment value. */
+  FULFILLED: 2,
+
+  /** The Promise has been resolved with a rejection reason. */
+  REJECTED: 3
+};
+
+
+
+/**
+ * Entries in the callback chain. Each call to {@code then},
+ * {@code thenCatch}, or {@code thenAlways} creates an entry containing the
+ * functions that may be invoked once the Promise is settled.
+ *
+ * @private @final @struct @constructor
+ */
+goog.Promise.CallbackEntry_ = function() {
+  /** @type {?goog.Promise} */
+  this.child = null;
+  /** @type {Function} */
+  this.onFulfilled = null;
+  /** @type {Function} */
+  this.onRejected = null;
+  /** @type {?} */
+  this.context = null;
+  /** @type {?goog.Promise.CallbackEntry_} */
+  this.next = null;
+
+  /**
+   * A boolean value to indicate this is a "thenAlways" callback entry.
+   * Unlike a normal "then/thenVoid" a "thenAlways doesn't participate
+   * in "cancel" considerations but is simply an observer and requires
+   * special handling.
+   * @type {boolean}
+   */
+  this.always = false;
+};
+
+
+/** clear the object prior to reuse */
+goog.Promise.CallbackEntry_.prototype.reset = function() {
+  this.child = null;
+  this.onFulfilled = null;
+  this.onRejected = null;
+  this.context = null;
+  this.always = false;
+};
+
+
+/**
+ * @define {number} The number of currently unused objects to keep around for
+ *    reuse.
+ */
+goog.define('goog.Promise.DEFAULT_MAX_UNUSED', 100);
+
+
+/** @const @private {goog.async.FreeList<!goog.Promise.CallbackEntry_>} */
+goog.Promise.freelist_ = new goog.async.FreeList(
+    function() {
+      return new goog.Promise.CallbackEntry_();
+    },
+    function(item) {
+      item.reset();
+    },
+    goog.Promise.DEFAULT_MAX_UNUSED);
+
+
+/**
+ * @param {Function} onFulfilled
+ * @param {Function} onRejected
+ * @param {?} context
+ * @return {!goog.Promise.CallbackEntry_}
+ * @private
+ */
+goog.Promise.getCallbackEntry_ = function(onFulfilled, onRejected, context) {
+  var entry = goog.Promise.freelist_.get();
+  entry.onFulfilled = onFulfilled;
+  entry.onRejected = onRejected;
+  entry.context = context;
+  return entry;
+};
+
+
+/**
+ * @param {!goog.Promise.CallbackEntry_} entry
+ * @private
+ */
+goog.Promise.returnEntry_ = function(entry) {
+  goog.Promise.freelist_.put(entry);
+};
+
+
+// NOTE: this is the same template expression as is used for
+// goog.IThenable.prototype.then
+
+
+/**
+ * @param {VALUE=} opt_value
+ * @return {RESULT} A new Promise that is immediately resolved
+ *     with the given value. If the input value is already a goog.Promise, it
+ *     will be returned immediately without creating a new instance.
+ * @template VALUE
+ * @template RESULT := type('goog.Promise',
+ *     cond(isUnknown(VALUE), unknown(),
+ *       mapunion(VALUE, (V) =>
+ *         cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
+ *           templateTypeOf(V, 0),
+ *           cond(sub(V, 'Thenable'),
+ *              unknown(),
+ *              V)))))
+ * =:
+ */
+goog.Promise.resolve = function(opt_value) {
+  if (opt_value instanceof goog.Promise) {
+    // Avoid creating a new object if we already have a promise object
+    // of the correct type.
+    return opt_value;
+  }
+
+  // Passing goog.nullFunction will cause the constructor to take an optimized
+  // path that skips calling the resolver function.
+  var promise = new goog.Promise(goog.nullFunction);
+  promise.resolve_(goog.Promise.State_.FULFILLED, opt_value);
+  return promise;
+};
+
+
+/**
+ * @param {*=} opt_reason
+ * @return {!goog.Promise} A new Promise that is immediately rejected with the
+ *     given reason.
+ */
+goog.Promise.reject = function(opt_reason) {
+  return new goog.Promise(function(resolve, reject) {
+    reject(opt_reason);
+  });
+};
+
+
+/**
+ * This is identical to
+ * {@code goog.Promise.resolve(value).then(onFulfilled, onRejected)}, but it
+ * avoids creating an unnecessary wrapper Promise when {@code value} is already
+ * thenable.
+ *
+ * @param {?(goog.Thenable<TYPE>|Thenable|TYPE)} value
+ * @param {function(TYPE): ?} onFulfilled
+ * @param {function(*): *} onRejected
+ * @template TYPE
+ * @private
+ */
+goog.Promise.resolveThen_ = function(value, onFulfilled, onRejected) {
+  var isThenable = goog.Promise.maybeThen_(
+      value, onFulfilled, onRejected, null);
+  if (!isThenable) {
+    goog.async.run(goog.partial(onFulfilled, value));
+  }
+};
+
+
+/**
+ * @param {!Array<?(goog.Promise<TYPE>|goog.Thenable<TYPE>|Thenable|*)>}
+ *     promises
+ * @return {!goog.Promise<TYPE>} A Promise that receives the result of the
+ *     first Promise (or Promise-like) input to settle immediately after it
+ *     settles.
+ * @template TYPE
+ */
+goog.Promise.race = function(promises) {
+  return new goog.Promise(function(resolve, reject) {
+    if (!promises.length) {
+      resolve(undefined);
+    }
+    for (var i = 0, promise; i < promises.length; i++) {
+      promise = promises[i];
+      goog.Promise.resolveThen_(promise, resolve, reject);
+    }
+  });
+};
+
+
+/**
+ * @param {!Array<?(goog.Promise<TYPE>|goog.Thenable<TYPE>|Thenable|*)>}
+ *     promises
+ * @return {!goog.Promise<!Array<TYPE>>} A Promise that receives a list of
+ *     every fulfilled value once every input Promise (or Promise-like) is
+ *     successfully fulfilled, or is rejected with the first rejection reason
+ *     immediately after it is rejected.
+ * @template TYPE
+ */
+goog.Promise.all = function(promises) {
+  return new goog.Promise(function(resolve, reject) {
+    var toFulfill = promises.length;
+    var values = [];
+
+    if (!toFulfill) {
+      resolve(values);
+      return;
+    }
+
+    var onFulfill = function(index, value) {
+      toFulfill--;
+      values[index] = value;
+      if (toFulfill == 0) {
+        resolve(values);
+      }
+    };
+
+    var onReject = function(reason) {
+      reject(reason);
+    };
+
+    for (var i = 0, promise; i < promises.length; i++) {
+      promise = promises[i];
+      goog.Promise.resolveThen_(
+          promise, goog.partial(onFulfill, i), onReject);
+    }
+  });
+};
+
+
+/**
+ * @param {!Array<?(goog.Promise<TYPE>|goog.Thenable<TYPE>|Thenable|*)>}
+ *     promises
+ * @return {!goog.Promise<!Array<{
+ *     fulfilled: boolean,
+ *     value: (TYPE|undefined),
+ *     reason: (*|undefined)}>>} A Promise that resolves with a list of
+ *         result objects once all input Promises (or Promise-like) have
+ *         settled. Each result object contains a 'fulfilled' boolean indicating
+ *         whether an input Promise was fulfilled or rejected. For fulfilled
+ *         Promises, the resulting value is stored in the 'value' field. For
+ *         rejected Promises, the rejection reason is stored in the 'reason'
+ *         field.
+ * @template TYPE
+ */
+goog.Promise.allSettled = function(promises) {
+  return new goog.Promise(function(resolve, reject) {
+    var toSettle = promises.length;
+    var results = [];
+
+    if (!toSettle) {
+      resolve(results);
+      return;
+    }
+
+    var onSettled = function(index, fulfilled, result) {
+      toSettle--;
+      results[index] = fulfilled ?
+          {fulfilled: true, value: result} :
+          {fulfilled: false, reason: result};
+      if (toSettle == 0) {
+        resolve(results);
+      }
+    };
+
+    for (var i = 0, promise; i < promises.length; i++) {
+      promise = promises[i];
+      goog.Promise.resolveThen_(promise,
+          goog.partial(onSettled, i, true /* fulfilled */),
+          goog.partial(onSettled, i, false /* fulfilled */));
+    }
+  });
+};
+
+
+/**
+ * @param {!Array<?(goog.Promise<TYPE>|goog.Thenable<TYPE>|Thenable|*)>}
+ *     promises
+ * @return {!goog.Promise<TYPE>} A Promise that receives the value of the first
+ *     input to be fulfilled, or is rejected with a list of every rejection
+ *     reason if all inputs are rejected.
+ * @template TYPE
+ */
+goog.Promise.firstFulfilled = function(promises) {
+  return new goog.Promise(function(resolve, reject) {
+    var toReject = promises.length;
+    var reasons = [];
+
+    if (!toReject) {
+      resolve(undefined);
+      return;
+    }
+
+    var onFulfill = function(value) {
+      resolve(value);
+    };
+
+    var onReject = function(index, reason) {
+      toReject--;
+      reasons[index] = reason;
+      if (toReject == 0) {
+        reject(reasons);
+      }
+    };
+
+    for (var i = 0, promise; i < promises.length; i++) {
+      promise = promises[i];
+      goog.Promise.resolveThen_(
+          promise, onFulfill, goog.partial(onReject, i));
+    }
+  });
+};
+
+
+/**
+ * @return {!goog.promise.Resolver<TYPE>} Resolver wrapping the promise and its
+ *     resolve / reject functions. Resolving or rejecting the resolver
+ *     resolves or rejects the promise.
+ * @template TYPE
+ */
+goog.Promise.withResolver = function() {
+  var resolve, reject;
+  var promise = new goog.Promise(function(rs, rj) {
+    resolve = rs;
+    reject = rj;
+  });
+  return new goog.Promise.Resolver_(promise, resolve, reject);
+};
+
+
+/**
+ * Adds callbacks that will operate on the result of the Promise, returning a
+ * new child Promise.
+ *
+ * If the Promise is fulfilled, the {@code onFulfilled} callback will be invoked
+ * with the fulfillment value as argument, and the child Promise will be
+ * fulfilled with the return value of the callback. If the callback throws an
+ * exception, the child Promise will be rejected with the thrown value instead.
+ *
+ * If the Promise is rejected, the {@code onRejected} callback will be invoked
+ * with the rejection reason as argument, and the child Promise will be resolved
+ * with the return value or rejected with the thrown value of the callback.
+ *
+ * @override
+ */
+goog.Promise.prototype.then = function(
+    opt_onFulfilled, opt_onRejected, opt_context) {
+
+  if (opt_onFulfilled != null) {
+    goog.asserts.assertFunction(opt_onFulfilled,
+        'opt_onFulfilled should be a function.');
+  }
+  if (opt_onRejected != null) {
+    goog.asserts.assertFunction(opt_onRejected,
+        'opt_onRejected should be a function. Did you pass opt_context ' +
+        'as the second argument instead of the third?');
+  }
+
+  if (goog.Promise.LONG_STACK_TRACES) {
+    this.addStackTrace_(new Error('then'));
+  }
+
+  return this.addChildPromise_(
+      goog.isFunction(opt_onFulfilled) ? opt_onFulfilled : null,
+      goog.isFunction(opt_onRejected) ? opt_onRejected : null,
+      opt_context);
+};
+goog.Thenable.addImplementation(goog.Promise);
+
+
+/**
+ * Adds callbacks that will operate on the result of the Promise without
+ * returning a child Promise (unlike "then").
+ *
+ * If the Promise is fulfilled, the {@code onFulfilled} callback will be invoked
+ * with the fulfillment value as argument.
+ *
+ * If the Promise is rejected, the {@code onRejected} callback will be invoked
+ * with the rejection reason as argument.
+ *
+ * @param {?(function(this:THIS, TYPE):?)=} opt_onFulfilled A
+ *     function that will be invoked with the fulfillment value if the Promise
+ *     is fulfilled.
+ * @param {?(function(this:THIS, *): *)=} opt_onRejected A function that will
+ *     be invoked with the rejection reason if the Promise is rejected.
+ * @param {THIS=} opt_context An optional context object that will be the
+ *     execution context for the callbacks. By default, functions are executed
+ *     with the default this.
+ * @package
+ * @template THIS
+ */
+goog.Promise.prototype.thenVoid = function(
+    opt_onFulfilled, opt_onRejected, opt_context) {
+
+  if (opt_onFulfilled != null) {
+    goog.asserts.assertFunction(opt_onFulfilled,
+        'opt_onFulfilled should be a function.');
+  }
+  if (opt_onRejected != null) {
+    goog.asserts.assertFunction(opt_onRejected,
+        'opt_onRejected should be a function. Did you pass opt_context ' +
+        'as the second argument instead of the third?');
+  }
+
+  if (goog.Promise.LONG_STACK_TRACES) {
+    this.addStackTrace_(new Error('then'));
+  }
+
+  // Note: no default rejection handler is provided here as we need to
+  // distinguish unhandled rejections.
+  this.addCallbackEntry_(goog.Promise.getCallbackEntry_(
+      opt_onFulfilled || goog.nullFunction,
+      opt_onRejected || null,
+      opt_context));
+};
+
+
+/**
+ * Adds a callback that will be invoked when the Promise is settled (fulfilled
+ * or rejected). The callback receives no argument, and no new child Promise is
+ * created. This is useful for ensuring that cleanup takes place after certain
+ * asynchronous operations. Callbacks added with {@code thenAlways} will be
+ * executed in the same order with other calls to {@code then},
+ * {@code thenAlways}, or {@code thenCatch}.
+ *
+ * Since it does not produce a new child Promise, cancellation propagation is
+ * not prevented by adding callbacks with {@code thenAlways}. A Promise that has
+ * a cleanup handler added with {@code thenAlways} will be canceled if all of
+ * its children created by {@code then} (or {@code thenCatch}) are canceled.
+ * Additionally, since any rejections are not passed to the callback, it does
+ * not stop the unhandled rejection handler from running.
+ *
+ * @param {function(this:THIS): void} onSettled A function that will be invoked
+ *     when the Promise is settled (fulfilled or rejected).
+ * @param {THIS=} opt_context An optional context object that will be the
+ *     execution context for the callbacks. By default, functions are executed
+ *     in the global scope.
+ * @return {!goog.Promise<TYPE>} This Promise, for chaining additional calls.
+ * @template THIS
+ */
+goog.Promise.prototype.thenAlways = function(onSettled, opt_context) {
+  if (goog.Promise.LONG_STACK_TRACES) {
+    this.addStackTrace_(new Error('thenAlways'));
+  }
+
+  var entry = goog.Promise.getCallbackEntry_(onSettled, onSettled, opt_context);
+  entry.always = true;
+  this.addCallbackEntry_(entry);
+  return this;
+};
+
+
+/**
+ * Adds a callback that will be invoked only if the Promise is rejected. This
+ * is equivalent to {@code then(null, onRejected)}.
+ *
+ * @param {!function(this:THIS, *): *} onRejected A function that will be
+ *     invoked with the rejection reason if the Promise is rejected.
+ * @param {THIS=} opt_context An optional context object that will be the
+ *     execution context for the callbacks. By default, functions are executed
+ *     in the global scope.
+ * @return {!goog.Promise} A new Promise that will receive the result of the
+ *     callback.
+ * @template THIS
+ */
+goog.Promise.prototype.thenCatch = function(onRejected, opt_context) {
+  if (goog.Promise.LONG_STACK_TRACES) {
+    this.addStackTrace_(new Error('thenCatch'));
+  }
+  return this.addChildPromise_(null, onRejected, opt_context);
+};
+
+
+/**
+ * Cancels the Promise if it is still pending by rejecting it with a cancel
+ * Error. No action is performed if the Promise is already resolved.
+ *
+ * All child Promises of the canceled Promise will be rejected with the same
+ * cancel error, as with normal Promise rejection. If the Promise to be canceled
+ * is the only child of a pending Promise, the parent Promise will also be
+ * canceled. Cancellation may propagate upward through multiple generations.
+ *
+ * @param {string=} opt_message An optional debugging message for describing the
+ *     cancellation reason.
+ */
+goog.Promise.prototype.cancel = function(opt_message) {
+  if (this.state_ == goog.Promise.State_.PENDING) {
+    goog.async.run(function() {
+      var err = new goog.Promise.CancellationError(opt_message);
+      this.cancelInternal_(err);
+    }, this);
+  }
+};
+
+
+/**
+ * Cancels this Promise with the given error.
+ *
+ * @param {!Error} err The cancellation error.
+ * @private
+ */
+goog.Promise.prototype.cancelInternal_ = function(err) {
+  if (this.state_ == goog.Promise.State_.PENDING) {
+    if (this.parent_) {
+      // Cancel the Promise and remove it from the parent's child list.
+      this.parent_.cancelChild_(this, err);
+      this.parent_ = null;
+    } else {
+      this.resolve_(goog.Promise.State_.REJECTED, err);
+    }
+  }
+};
+
+
+/**
+ * Cancels a child Promise from the list of callback entries. If the Promise has
+ * not already been resolved, reject it with a cancel error. If there are no
+ * other children in the list of callback entries, propagate the cancellation
+ * by canceling this Promise as well.
+ *
+ * @param {!goog.Promise} childPromise The Promise to cancel.
+ * @param {!Error} err The cancel error to use for rejecting the Promise.
+ * @private
+ */
+goog.Promise.prototype.cancelChild_ = function(childPromise, err) {
+  if (!this.callbackEntries_) {
+    return;
+  }
+  var childCount = 0;
+  var childEntry = null;
+  var beforeChildEntry = null;
+
+  // Find the callback entry for the childPromise, and count whether there are
+  // additional child Promises.
+  for (var entry = this.callbackEntries_; entry; entry = entry.next) {
+    if (!entry.always) {
+      childCount++;
+      if (entry.child == childPromise) {
+        childEntry = entry;
+      }
+      if (childEntry && childCount > 1) {
+        break;
+      }
+    }
+    if (!childEntry) {
+      beforeChildEntry = entry;
+    }
+  }
+
+  // Can a child entry be missing?
+
+  // If the child Promise was the only child, cancel this Promise as well.
+  // Otherwise, reject only the child Promise with the cancel error.
+  if (childEntry) {
+    if (this.state_ == goog.Promise.State_.PENDING && childCount == 1) {
+      this.cancelInternal_(err);
+    } else {
+      if (beforeChildEntry) {
+        this.removeEntryAfter_(beforeChildEntry);
+      } else {
+        this.popEntry_();
+      }
+
+      this.executeCallback_(
+          childEntry, goog.Promise.State_.REJECTED, err);
+    }
+  }
+};
+
+
+/**
+ * Adds a callback entry to the current Promise, and schedules callback
+ * execution if the Promise has already been settled.
+ *
+ * @param {goog.Promise.CallbackEntry_} callbackEntry Record containing
+ *     {@code onFulfilled} and {@code onRejected} callbacks to execute after
+ *     the Promise is settled.
+ * @private
+ */
+goog.Promise.prototype.addCallbackEntry_ = function(callbackEntry) {
+  if (!this.hasEntry_() &&
+      (this.state_ == goog.Promise.State_.FULFILLED ||
+       this.state_ == goog.Promise.State_.REJECTED)) {
+    this.scheduleCallbacks_();
+  }
+  this.queueEntry_(callbackEntry);
+};
+
+
+/**
+ * Creates a child Promise and adds it to the callback entry list. The result of
+ * the child Promise is determined by the state of the parent Promise and the
+ * result of the {@code onFulfilled} or {@code onRejected} callbacks as
+ * specified in the Promise resolution procedure.
+ *
+ * @see http://promisesaplus.com/#the__method
+ *
+ * @param {?function(this:THIS, TYPE):
+ *          (RESULT|goog.Promise<RESULT>|Thenable)} onFulfilled A callback that
+ *     will be invoked if the Promise is fullfilled, or null.
+ * @param {?function(this:THIS, *): *} onRejected A callback that will be
+ *     invoked if the Promise is rejected, or null.
+ * @param {THIS=} opt_context An optional execution context for the callbacks.
+ *     in the default calling context.
+ * @return {!goog.Promise} The child Promise.
+ * @template RESULT,THIS
+ * @private
+ */
+goog.Promise.prototype.addChildPromise_ = function(
+    onFulfilled, onRejected, opt_context) {
+
+  /** @type {goog.Promise.CallbackEntry_} */
+  var callbackEntry = goog.Promise.getCallbackEntry_(null, null, null);
+
+  callbackEntry.child = new goog.Promise(function(resolve, reject) {
+    // Invoke onFulfilled, or resolve with the parent's value if absent.
+    callbackEntry.onFulfilled = onFulfilled ? function(value) {
+      try {
+        var result = onFulfilled.call(opt_context, value);
+        resolve(result);
+      } catch (err) {
+        reject(err);
+      }
+    } : resolve;
+
+    // Invoke onRejected, or reject with the parent's reason if absent.
+    callbackEntry.onRejected = onRejected ? function(reason) {
+      try {
+        var result = onRejected.call(opt_context, reason);
+        if (!goog.isDef(result) &&
+            reason instanceof goog.Promise.CancellationError) {
+          // Propagate cancellation to children if no other result is returned.
+          reject(reason);
+        } else {
+          resolve(result);
+        }
+      } catch (err) {
+        reject(err);
+      }
+    } : reject;
+  });
+
+  callbackEntry.child.parent_ = this;
+  this.addCallbackEntry_(callbackEntry);
+  return callbackEntry.child;
+};
+
+
+/**
+ * Unblocks the Promise and fulfills it with the given value.
+ *
+ * @param {TYPE} value
+ * @private
+ */
+goog.Promise.prototype.unblockAndFulfill_ = function(value) {
+  goog.asserts.assert(this.state_ == goog.Promise.State_.BLOCKED);
+  this.state_ = goog.Promise.State_.PENDING;
+  this.resolve_(goog.Promise.State_.FULFILLED, value);
+};
+
+
+/**
+ * Unblocks the Promise and rejects it with the given rejection reason.
+ *
+ * @param {*} reason
+ * @private
+ */
+goog.Promise.prototype.unblockAndReject_ = function(reason) {
+  goog.asserts.assert(this.state_ == goog.Promise.State_.BLOCKED);
+  this.state_ = goog.Promise.State_.PENDING;
+  this.resolve_(goog.Promise.State_.REJECTED, reason);
+};
+
+
+/**
+ * Attempts to resolve a Promise with a given resolution state and value. This
+ * is a no-op if the given Promise has already been resolved.
+ *
+ * If the given result is a Thenable (such as another Promise), the Promise will
+ * be settled with the same state and result as the Thenable once it is itself
+ * settled.
+ *
+ * If the given result is not a Thenable, the Promise will be settled (fulfilled
+ * or rejected) with that result based on the given state.
+ *
+ * @see http://promisesaplus.com/#the_promise_resolution_procedure
+ *
+ * @param {goog.Promise.State_} state
+ * @param {*} x The result to apply to the Promise.
+ * @private
+ */
+goog.Promise.prototype.resolve_ = function(state, x) {
+  if (this.state_ != goog.Promise.State_.PENDING) {
+    return;
+  }
+
+  if (this == x) {
+    state = goog.Promise.State_.REJECTED;
+    x = new TypeError('Promise cannot resolve to itself');
+  }
+
+  this.state_ = goog.Promise.State_.BLOCKED;
+  var isThenable = goog.Promise.maybeThen_(
+      x, this.unblockAndFulfill_, this.unblockAndReject_, this);
+  if (isThenable) {
+    return;
+  }
+
+  this.result_ = x;
+  this.state_ = state;
+  // Since we can no longer be canceled, remove link to parent, so that the
+  // child promise does not keep the parent promise alive.
+  this.parent_ = null;
+  this.scheduleCallbacks_();
+
+  if (state == goog.Promise.State_.REJECTED &&
+      !(x instanceof goog.Promise.CancellationError)) {
+    goog.Promise.addUnhandledRejection_(this, x);
+  }
+};
+
+
+/**
+ * Invokes the "then" method of an input value if that value is a Thenable. This
+ * is a no-op if the value is not thenable.
+ *
+ * @param {?} value A potentially thenable value.
+ * @param {!Function} onFulfilled
+ * @param {!Function} onRejected
+ * @param {?} context
+ * @return {boolean} Whether the input value was thenable.
+ * @private
+ */
+goog.Promise.maybeThen_ = function(value, onFulfilled, onRejected, context) {
+  if (value instanceof goog.Promise) {
+    value.thenVoid(onFulfilled, onRejected, context);
+    return true;
+  } else if (goog.Thenable.isImplementedBy(value)) {
+    value = /** @type {!goog.Thenable} */ (value);
+    value.then(onFulfilled, onRejected, context);
+    return true;
+  } else if (goog.isObject(value)) {
+    try {
+      var then = value['then'];
+      if (goog.isFunction(then)) {
+        goog.Promise.tryThen_(
+            value, then, onFulfilled, onRejected, context);
+        return true;
+      }
+    } catch (e) {
+      onRejected.call(context, e);
+      return true;
+    }
+  }
+
+  return false;
+};
+
+
+/**
+ * Attempts to call the {@code then} method on an object in the hopes that it is
+ * a Promise-compatible instance. This allows interoperation between different
+ * Promise implementations, however a non-compliant object may cause a Promise
+ * to hang indefinitely. If the {@code then} method throws an exception, the
+ * dependent Promise will be rejected with the thrown value.
+ *
+ * @see http://promisesaplus.com/#point-70
+ *
+ * @param {Thenable} thenable An object with a {@code then} method that may be
+ *     compatible with the Promise/A+ specification.
+ * @param {!Function} then The {@code then} method of the Thenable object.
+ * @param {!Function} onFulfilled
+ * @param {!Function} onRejected
+ * @param {*} context
+ * @private
+ */
+goog.Promise.tryThen_ = function(
+    thenable, then, onFulfilled, onRejected, context) {
+
+  var called = false;
+  var resolve = function(value) {
+    if (!called) {
+      called = true;
+      onFulfilled.call(context, value);
+    }
+  };
+
+  var reject = function(reason) {
+    if (!called) {
+      called = true;
+      onRejected.call(context, reason);
+    }
+  };
+
+  try {
+    then.call(thenable, resolve, reject);
+  } catch (e) {
+    reject(e);
+  }
+};
+
+
+/**
+ * Executes the pending callbacks of a settled Promise after a timeout.
+ *
+ * Section 2.2.4 of the Promises/A+ specification requires that Promise
+ * callbacks must only be invoked from a call stack that only contains Promise
+ * implementation code, which we accomplish by invoking callback execution after
+ * a timeout. If {@code startExecution_} is called multiple times for the same
+ * Promise, the callback chain will be evaluated only once. Additional callbacks
+ * may be added during the evaluation phase, and will be executed in the same
+ * event loop.
+ *
+ * All Promises added to the waiting list during the same browser event loop
+ * will be executed in one batch to avoid using a separate timeout per Promise.
+ *
+ * @private
+ */
+goog.Promise.prototype.scheduleCallbacks_ = function() {
+  if (!this.executing_) {
+    this.executing_ = true;
+    goog.async.run(this.executeCallbacks_, this);
+  }
+};
+
+
+/**
+ * @return {boolean} Whether there are any pending callbacks queued.
+ * @private
+ */
+goog.Promise.prototype.hasEntry_ = function() {
+  return !!this.callbackEntries_;
+};
+
+
+/**
+ * @param {goog.Promise.CallbackEntry_} entry
+ * @private
+ */
+goog.Promise.prototype.queueEntry_ = function(entry) {
+  goog.asserts.assert(entry.onFulfilled != null);
+
+  if (this.callbackEntriesTail_) {
+    this.callbackEntriesTail_.next = entry;
+    this.callbackEntriesTail_ = entry;
+  } else {
+    // It the work queue was empty set the head too.
+    this.callbackEntries_ = entry;
+    this.callbackEntriesTail_ = entry;
+  }
+};
+
+
+/**
+ * @return {goog.Promise.CallbackEntry_} entry
+ * @private
+ */
+goog.Promise.prototype.popEntry_ = function() {
+  var entry = null;
+  if (this.callbackEntries_) {
+    entry = this.callbackEntries_;
+    this.callbackEntries_ = entry.next;
+    entry.next = null;
+  }
+  // It the work queue is empty clear the tail too.
+  if (!this.callbackEntries_) {
+    this.callbackEntriesTail_ = null;
+  }
+
+  if (entry != null) {
+    goog.asserts.assert(entry.onFulfilled != null);
+  }
+  return entry;
+};
+
+
+/**
+ * @param {goog.Promise.CallbackEntry_} previous
+ * @private
+ */
+goog.Promise.prototype.removeEntryAfter_ = function(previous) {
+  goog.asserts.assert(this.callbackEntries_);
+  goog.asserts.assert(previous != null);
+  // If the last entry is being removed, update the tail
+  if (previous.next == this.callbackEntriesTail_) {
+    this.callbackEntriesTail_ = previous;
+  }
+
+  previous.next = previous.next.next;
+};
+
+
+/**
+ * Executes all pending callbacks for this Promise.
+ *
+ * @private
+ */
+goog.Promise.prototype.executeCallbacks_ = function() {
+  var entry = null;
+  while (entry = this.popEntry_()) {
+    if (goog.Promise.LONG_STACK_TRACES) {
+      this.currentStep_++;
+    }
+    this.executeCallback_(entry, this.state_, this.result_);
+  }
+  this.executing_ = false;
+};
+
+
+/**
+ * Executes a pending callback for this Promise. Invokes an {@code onFulfilled}
+ * or {@code onRejected} callback based on the settled state of the Promise.
+ *
+ * @param {!goog.Promise.CallbackEntry_} callbackEntry An entry containing the
+ *     onFulfilled and/or onRejected callbacks for this step.
+ * @param {goog.Promise.State_} state The resolution status of the Promise,
+ *     either FULFILLED or REJECTED.
+ * @param {*} result The settled result of the Promise.
+ * @private
+ */
+goog.Promise.prototype.executeCallback_ = function(
+    callbackEntry, state, result) {
+  // Cancel an unhandled rejection if the then/thenVoid call had an onRejected.
+  if (state == goog.Promise.State_.REJECTED &&
+      callbackEntry.onRejected && !callbackEntry.always) {
+    this.removeUnhandledRejection_();
+  }
+
+  if (callbackEntry.child) {
+    // When the parent is settled, the child no longer needs to hold on to it,
+    // as the parent can no longer be canceled.
+    callbackEntry.child.parent_ = null;
+    goog.Promise.invokeCallback_(callbackEntry, state, result);
+  } else {
+    // Callbacks created with thenAlways or thenVoid do not have the rejection
+    // handling code normally set up in the child Promise.
+    try {
+      callbackEntry.always ?
+          callbackEntry.onFulfilled.call(callbackEntry.context) :
+          goog.Promise.invokeCallback_(callbackEntry, state, result);
+    } catch (err) {
+      goog.Promise.handleRejection_.call(null, err);
+    }
+  }
+  goog.Promise.returnEntry_(callbackEntry);
+};
+
+
+/**
+ * Executes the onFulfilled or onRejected callback for a callbackEntry.
+ *
+ * @param {!goog.Promise.CallbackEntry_} callbackEntry
+ * @param {goog.Promise.State_} state
+ * @param {*} result
+ * @private
+ */
+goog.Promise.invokeCallback_ = function(callbackEntry, state, result) {
+  if (state == goog.Promise.State_.FULFILLED) {
+    callbackEntry.onFulfilled.call(callbackEntry.context, result);
+  } else if (callbackEntry.onRejected) {
+    callbackEntry.onRejected.call(callbackEntry.context, result);
+  }
+};
+
+
+/**
+ * Records a stack trace entry for functions that call {@code then} or the
+ * Promise constructor. May be disabled by unsetting {@code LONG_STACK_TRACES}.
+ *
+ * @param {!Error} err An Error object created by the calling function for
+ *     providing a stack trace.
+ * @private
+ */
+goog.Promise.prototype.addStackTrace_ = function(err) {
+  if (goog.Promise.LONG_STACK_TRACES && goog.isString(err.stack)) {
+    // Extract the third line of the stack trace, which is the entry for the
+    // user function that called into Promise code.
+    var trace = err.stack.split('\n', 4)[3];
+    var message = err.message;
+
+    // Pad the message to align the traces.
+    message += Array(11 - message.length).join(' ');
+    this.stack_.push(message + trace);
+  }
+};
+
+
+/**
+ * Adds extra stack trace information to an exception for the list of
+ * asynchronous {@code then} calls that have been run for this Promise. Stack
+ * trace information is recorded in {@see #addStackTrace_}, and appended to
+ * rethrown errors when {@code LONG_STACK_TRACES} is enabled.
+ *
+ * @param {*} err An unhandled exception captured during callback execution.
+ * @private
+ */
+goog.Promise.prototype.appendLongStack_ = function(err) {
+  if (goog.Promise.LONG_STACK_TRACES &&
+      err && goog.isString(err.stack) && this.stack_.length) {
+    var longTrace = ['Promise trace:'];
+
+    for (var promise = this; promise; promise = promise.parent_) {
+      for (var i = this.currentStep_; i >= 0; i--) {
+        longTrace.push(promise.stack_[i]);
+      }
+      longTrace.push('Value: ' +
+          '[' + (promise.state_ == goog.Promise.State_.REJECTED ?
+              'REJECTED' : 'FULFILLED') + '] ' +
+          '<' + String(promise.result_) + '>');
+    }
+    err.stack += '\n\n' + longTrace.join('\n');
+  }
+};
+
+
+/**
+ * Marks this rejected Promise as having being handled. Also marks any parent
+ * Promises in the rejected state as handled. The rejection handler will no
+ * longer be invoked for this Promise (if it has not been called already).
+ *
+ * @private
+ */
+goog.Promise.prototype.removeUnhandledRejection_ = function() {
+  if (goog.Promise.UNHANDLED_REJECTION_DELAY > 0) {
+    for (var p = this; p && p.unhandledRejectionId_; p = p.parent_) {
+      goog.global.clearTimeout(p.unhandledRejectionId_);
+      p.unhandledRejectionId_ = 0;
+    }
+  } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {
+    for (var p = this; p && p.hadUnhandledRejection_; p = p.parent_) {
+      p.hadUnhandledRejection_ = false;
+    }
+  }
+};
+
+
+/**
+ * Marks this rejected Promise as unhandled. If no {@code onRejected} callback
+ * is called for this Promise before the {@code UNHANDLED_REJECTION_DELAY}
+ * expires, the reason will be passed to the unhandled rejection handler. The
+ * handler typically rethrows the rejection reason so that it becomes visible in
+ * the developer console.
+ *
+ * @param {!goog.Promise} promise The rejected Promise.
+ * @param {*} reason The Promise rejection reason.
+ * @private
+ */
+goog.Promise.addUnhandledRejection_ = function(promise, reason) {
+  if (goog.Promise.UNHANDLED_REJECTION_DELAY > 0) {
+    promise.unhandledRejectionId_ = goog.global.setTimeout(function() {
+      promise.appendLongStack_(reason);
+      goog.Promise.handleRejection_.call(null, reason);
+    }, goog.Promise.UNHANDLED_REJECTION_DELAY);
+
+  } else if (goog.Promise.UNHANDLED_REJECTION_DELAY == 0) {
+    promise.hadUnhandledRejection_ = true;
+    goog.async.run(function() {
+      if (promise.hadUnhandledRejection_) {
+        promise.appendLongStack_(reason);
+        goog.Promise.handleRejection_.call(null, reason);
+      }
+    });
+  }
+};
+
+
+/**
+ * A method that is invoked with the rejection reasons for Promises that are
+ * rejected but have no {@code onRejected} callbacks registered yet.
+ * @type {function(*)}
+ * @private
+ */
+goog.Promise.handleRejection_ = goog.async.throwException;
+
+
+/**
+ * Sets a handler that will be called with reasons from unhandled rejected
+ * Promises. If the rejected Promise (or one of its descendants) has an
+ * {@code onRejected} callback registered, the rejection will be considered
+ * handled, and the rejection handler will not be called.
+ *
+ * By default, unhandled rejections are rethrown so that the error may be
+ * captured by the developer console or a {@code window.onerror} handler.
+ *
+ * @param {function(*)} handler A function that will be called with reasons from
+ *     rejected Promises. Defaults to {@code goog.async.throwException}.
+ */
+goog.Promise.setUnhandledRejectionHandler = function(handler) {
+  goog.Promise.handleRejection_ = handler;
+};
+
+
+
+/**
+ * Error used as a rejection reason for canceled Promises.
+ *
+ * @param {string=} opt_message
+ * @constructor
+ * @extends {goog.debug.Error}
+ * @final
+ */
+goog.Promise.CancellationError = function(opt_message) {
+  goog.Promise.CancellationError.base(this, 'constructor', opt_message);
+};
+goog.inherits(goog.Promise.CancellationError, goog.debug.Error);
+
+
+/** @override */
+goog.Promise.CancellationError.prototype.name = 'cancel';
+
+
+
+/**
+ * Internal implementation of the resolver interface.
+ *
+ * @param {!goog.Promise<TYPE>} promise
+ * @param {function((TYPE|goog.Promise<TYPE>|Thenable)=)} resolve
+ * @param {function(*=): void} reject
+ * @implements {goog.promise.Resolver<TYPE>}
+ * @final @struct
+ * @constructor
+ * @private
+ * @template TYPE
+ */
+goog.Promise.Resolver_ = function(promise, resolve, reject) {
+  /** @const */
+  this.promise = promise;
+
+  /** @const */
+  this.resolve = resolve;
+
+  /** @const */
+  this.reject = reject;
+};
diff --git a/lib/goog/promise/resolver.js b/lib/goog/promise/resolver.js
new file mode 100644
index 0000000..54c2d91
--- /dev/null
+++ b/lib/goog/promise/resolver.js
@@ -0,0 +1,48 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.promise.Resolver');
+
+
+
+/**
+ * Resolver interface for promises. The resolver is a convenience interface that
+ * bundles the promise and its associated resolve and reject functions together,
+ * for cases where the resolver needs to be persisted internally.
+ *
+ * @interface
+ * @template TYPE
+ */
+goog.promise.Resolver = function() {};
+
+
+/**
+ * The promise that created this resolver.
+ * @type {!goog.Promise<TYPE>}
+ */
+goog.promise.Resolver.prototype.promise;
+
+
+/**
+ * Resolves this resolver with the specified value.
+ * @type {function((TYPE|goog.Promise<TYPE>|Thenable)=)}
+ */
+goog.promise.Resolver.prototype.resolve;
+
+
+/**
+ * Rejects this resolver with the specified reason.
+ * @type {function(*=): void}
+ */
+goog.promise.Resolver.prototype.reject;
diff --git a/lib/goog/promise/thenable.js b/lib/goog/promise/thenable.js
new file mode 100644
index 0000000..3999d6e
--- /dev/null
+++ b/lib/goog/promise/thenable.js
@@ -0,0 +1,126 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.Thenable');
+
+
+
+/**
+ * Provides a more strict interface for Thenables in terms of
+ * http://promisesaplus.com for interop with {@see goog.Promise}.
+ *
+ * @interface
+ * @extends {IThenable<TYPE>}
+ * @template TYPE
+ */
+goog.Thenable = function() {};
+
+
+/**
+ * Adds callbacks that will operate on the result of the Thenable, returning a
+ * new child Promise.
+ *
+ * If the Thenable is fulfilled, the {@code onFulfilled} callback will be
+ * invoked with the fulfillment value as argument, and the child Promise will
+ * be fulfilled with the return value of the callback. If the callback throws
+ * an exception, the child Promise will be rejected with the thrown value
+ * instead.
+ *
+ * If the Thenable is rejected, the {@code onRejected} callback will be invoked
+ * with the rejection reason as argument, and the child Promise will be rejected
+ * with the return value of the callback or thrown value.
+ *
+ * @param {?(function(this:THIS, TYPE): VALUE)=} opt_onFulfilled A
+ *     function that will be invoked with the fulfillment value if the Promise
+ *     is fullfilled.
+ * @param {?(function(this:THIS, *): *)=} opt_onRejected A function that will
+ *     be invoked with the rejection reason if the Promise is rejected.
+ * @param {THIS=} opt_context An optional context object that will be the
+ *     execution context for the callbacks. By default, functions are executed
+ *     with the default this.
+ *
+ * @return {RESULT} A new Promise that will receive the result
+ *     of the fulfillment or rejection callback.
+ * @template VALUE
+ * @template THIS
+ *
+ * When a Promise (or thenable) is returned from the fulfilled callback,
+ * the result is the payload of that promise, not the promise itself.
+ *
+ * @template RESULT := type('goog.Promise',
+ *     cond(isUnknown(VALUE), unknown(),
+ *       mapunion(VALUE, (V) =>
+ *         cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
+ *           templateTypeOf(V, 0),
+ *           cond(sub(V, 'Thenable'),
+ *              unknown(),
+ *              V)))))
+ *  =:
+ *
+ */
+goog.Thenable.prototype.then = function(opt_onFulfilled, opt_onRejected,
+    opt_context) {};
+
+
+/**
+ * An expando property to indicate that an object implements
+ * {@code goog.Thenable}.
+ *
+ * {@see addImplementation}.
+ *
+ * @const
+ */
+goog.Thenable.IMPLEMENTED_BY_PROP = '$goog_Thenable';
+
+
+/**
+ * Marks a given class (constructor) as an implementation of Thenable, so
+ * that we can query that fact at runtime. The class must have already
+ * implemented the interface.
+ * Exports a 'then' method on the constructor prototype, so that the objects
+ * also implement the extern {@see goog.Thenable} interface for interop with
+ * other Promise implementations.
+ * @param {function(new:goog.Thenable,...?)} ctor The class constructor. The
+ *     corresponding class must have already implemented the interface.
+ */
+goog.Thenable.addImplementation = function(ctor) {
+  goog.exportProperty(ctor.prototype, 'then', ctor.prototype.then);
+  if (COMPILED) {
+    ctor.prototype[goog.Thenable.IMPLEMENTED_BY_PROP] = true;
+  } else {
+    // Avoids dictionary access in uncompiled mode.
+    ctor.prototype.$goog_Thenable = true;
+  }
+};
+
+
+/**
+ * @param {*} object
+ * @return {boolean} Whether a given instance implements {@code goog.Thenable}.
+ *     The class/superclass of the instance must call {@code addImplementation}.
+ */
+goog.Thenable.isImplementedBy = function(object) {
+  if (!object) {
+    return false;
+  }
+  try {
+    if (COMPILED) {
+      return !!object[goog.Thenable.IMPLEMENTED_BY_PROP];
+    }
+    return !!object.$goog_Thenable;
+  } catch (e) {
+    // Property access seems to be forbidden.
+    return false;
+  }
+};
diff --git a/lib/goog/reflect/reflect.js b/lib/goog/reflect/reflect.js
new file mode 100644
index 0000000..64e0afc
--- /dev/null
+++ b/lib/goog/reflect/reflect.js
@@ -0,0 +1,77 @@
+// Copyright 2009 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Useful compiler idioms.
+ *
+ * @author johnlenz@google.com (John Lenz)
+ */
+
+goog.provide('goog.reflect');
+
+
+/**
+ * Syntax for object literal casts.
+ * @see http://go/jscompiler-renaming
+ * @see https://github.com/google/closure-compiler/wiki/Type-Based-Property-Renaming
+ *
+ * Use this if you have an object literal whose keys need to have the same names
+ * as the properties of some class even after they are renamed by the compiler.
+ *
+ * @param {!Function} type Type to cast to.
+ * @param {Object} object Object literal to cast.
+ * @return {Object} The object literal.
+ */
+goog.reflect.object = function(type, object) {
+  return object;
+};
+
+
+/**
+ * To assert to the compiler that an operation is needed when it would
+ * otherwise be stripped. For example:
+ * <code>
+ *     // Force a layout
+ *     goog.reflect.sinkValue(dialog.offsetHeight);
+ * </code>
+ * @type {!Function}
+ */
+goog.reflect.sinkValue = function(x) {
+  goog.reflect.sinkValue[' '](x);
+  return x;
+};
+
+
+/**
+ * The compiler should optimize this function away iff no one ever uses
+ * goog.reflect.sinkValue.
+ */
+goog.reflect.sinkValue[' '] = goog.nullFunction;
+
+
+/**
+ * Check if a property can be accessed without throwing an exception.
+ * @param {Object} obj The owner of the property.
+ * @param {string} prop The property name.
+ * @return {boolean} Whether the property is accessible. Will also return true
+ *     if obj is null.
+ */
+goog.reflect.canAccessProperty = function(obj, prop) {
+  /** @preserveTry */
+  try {
+    goog.reflect.sinkValue(obj[prop]);
+    return true;
+  } catch (e) {}
+  return false;
+};
diff --git a/lib/goog/string/const.js b/lib/goog/string/const.js
new file mode 100644
index 0000000..2e47509
--- /dev/null
+++ b/lib/goog/string/const.js
@@ -0,0 +1,182 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.string.Const');
+
+goog.require('goog.asserts');
+goog.require('goog.string.TypedString');
+
+
+
+/**
+ * Wrapper for compile-time-constant strings.
+ *
+ * Const is a wrapper for strings that can only be created from program
+ * constants (i.e., string literals).  This property relies on a custom Closure
+ * compiler check that {@code goog.string.Const.from} is only invoked on
+ * compile-time-constant expressions.
+ *
+ * Const is useful in APIs whose correct and secure use requires that certain
+ * arguments are not attacker controlled: Compile-time constants are inherently
+ * under the control of the application and not under control of external
+ * attackers, and hence are safe to use in such contexts.
+ *
+ * Instances of this type must be created via its factory method
+ * {@code goog.string.Const.from} and not by invoking its constructor.  The
+ * constructor intentionally takes no parameters and the type is immutable;
+ * hence only a default instance corresponding to the empty string can be
+ * obtained via constructor invocation.
+ *
+ * @see goog.string.Const#from
+ * @constructor
+ * @final
+ * @struct
+ * @implements {goog.string.TypedString}
+ */
+goog.string.Const = function() {
+  /**
+   * The wrapped value of this Const object.  The field has a purposely ugly
+   * name to make (non-compiled) code that attempts to directly access this
+   * field stand out.
+   * @private {string}
+   */
+  this.stringConstValueWithSecurityContract__googStringSecurityPrivate_ = '';
+
+  /**
+   * A type marker used to implement additional run-time type checking.
+   * @see goog.string.Const#unwrap
+   * @const
+   * @private
+   */
+  this.STRING_CONST_TYPE_MARKER__GOOG_STRING_SECURITY_PRIVATE_ =
+      goog.string.Const.TYPE_MARKER_;
+};
+
+
+/**
+ * @override
+ * @const
+ */
+goog.string.Const.prototype.implementsGoogStringTypedString = true;
+
+
+/**
+ * Returns this Const's value a string.
+ *
+ * IMPORTANT: In code where it is security-relevant that an object's type is
+ * indeed {@code goog.string.Const}, use {@code goog.string.Const.unwrap}
+ * instead of this method.
+ *
+ * @see goog.string.Const#unwrap
+ * @override
+ */
+goog.string.Const.prototype.getTypedStringValue = function() {
+  return this.stringConstValueWithSecurityContract__googStringSecurityPrivate_;
+};
+
+
+/**
+ * Returns a debug-string representation of this value.
+ *
+ * To obtain the actual string value wrapped inside an object of this type,
+ * use {@code goog.string.Const.unwrap}.
+ *
+ * @see goog.string.Const#unwrap
+ * @override
+ */
+goog.string.Const.prototype.toString = function() {
+  return 'Const{' +
+         this.stringConstValueWithSecurityContract__googStringSecurityPrivate_ +
+         '}';
+};
+
+
+/**
+ * Performs a runtime check that the provided object is indeed an instance
+ * of {@code goog.string.Const}, and returns its value.
+ * @param {!goog.string.Const} stringConst The object to extract from.
+ * @return {string} The Const object's contained string, unless the run-time
+ *     type check fails. In that case, {@code unwrap} returns an innocuous
+ *     string, or, if assertions are enabled, throws
+ *     {@code goog.asserts.AssertionError}.
+ */
+goog.string.Const.unwrap = function(stringConst) {
+  // Perform additional run-time type-checking to ensure that stringConst is
+  // indeed an instance of the expected type.  This provides some additional
+  // protection against security bugs due to application code that disables type
+  // checks.
+  if (stringConst instanceof goog.string.Const &&
+      stringConst.constructor === goog.string.Const &&
+      stringConst.STRING_CONST_TYPE_MARKER__GOOG_STRING_SECURITY_PRIVATE_ ===
+          goog.string.Const.TYPE_MARKER_) {
+    return stringConst.
+        stringConstValueWithSecurityContract__googStringSecurityPrivate_;
+  } else {
+    goog.asserts.fail('expected object of type Const, got \'' +
+                      stringConst + '\'');
+    return 'type_error:Const';
+  }
+};
+
+
+/**
+ * Creates a Const object from a compile-time constant string.
+ *
+ * It is illegal to invoke this function on an expression whose
+ * compile-time-contant value cannot be determined by the Closure compiler.
+ *
+ * Correct invocations include,
+ * <pre>
+ *   var s = goog.string.Const.from('hello');
+ *   var t = goog.string.Const.from('hello' + 'world');
+ * </pre>
+ *
+ * In contrast, the following are illegal:
+ * <pre>
+ *   var s = goog.string.Const.from(getHello());
+ *   var t = goog.string.Const.from('hello' + world);
+ * </pre>
+ *
+ * TODO(xtof): Compile-time checks that this function is only called
+ * with compile-time constant expressions.
+ *
+ * @param {string} s A constant string from which to create a Const.
+ * @return {!goog.string.Const} A Const object initialized to stringConst.
+ */
+goog.string.Const.from = function(s) {
+  return goog.string.Const.create__googStringSecurityPrivate_(s);
+};
+
+
+/**
+ * Type marker for the Const type, used to implement additional run-time
+ * type checking.
+ * @const {!Object}
+ * @private
+ */
+goog.string.Const.TYPE_MARKER_ = {};
+
+
+/**
+ * Utility method to create Const instances.
+ * @param {string} s The string to initialize the Const object with.
+ * @return {!goog.string.Const} The initialized Const object.
+ * @private
+ */
+goog.string.Const.create__googStringSecurityPrivate_ = function(s) {
+  var stringConst = new goog.string.Const();
+  stringConst.stringConstValueWithSecurityContract__googStringSecurityPrivate_ =
+      s;
+  return stringConst;
+};
diff --git a/lib/goog/string/string.js b/lib/goog/string/string.js
index dcfdffb..c327c9d 100644
--- a/lib/goog/string/string.js
+++ b/lib/goog/string/string.js
@@ -14,6 +14,7 @@
 
 /**
  * @fileoverview Utilities for string manipulation.
+ * @author arv@google.com (Erik Arvidsson)
  */
 
 
@@ -24,6 +25,19 @@ goog.provide('goog.string');
 goog.provide('goog.string.Unicode');
 
 
+/**
+ * @define {boolean} Enables HTML escaping of lowercase letter "e" which helps
+ * with detection of double-escaping as this letter is frequently used.
+ */
+goog.define('goog.string.DETECT_DOUBLE_ESCAPING', false);
+
+
+/**
+ * @define {boolean} Whether to force non-dom html unescaping.
+ */
+goog.define('goog.string.FORCE_NON_DOM_HTML_UNESCAPING', false);
+
+
 /**
  * Common Unicode string characters.
  * @enum {string}
@@ -135,9 +149,9 @@ goog.string.collapseWhitespace = function(str) {
 /**
  * Checks if a string is empty or contains only whitespaces.
  * @param {string} str The string to check.
- * @return {boolean} True if {@code str} is empty or whitespace only.
+ * @return {boolean} Whether {@code str} is empty or whitespace only.
  */
-goog.string.isEmpty = function(str) {
+goog.string.isEmptyOrWhitespace = function(str) {
   // testing length == 0 first is actually slower in all browsers (about the
   // same in Opera).
   // Since IE doesn't include non-breaking-space (0xa0) in their \s character
@@ -147,17 +161,54 @@ goog.string.isEmpty = function(str) {
 };
 
 
+/**
+ * Checks if a string is empty.
+ * @param {string} str The string to check.
+ * @return {boolean} Whether {@code str} is empty.
+ */
+goog.string.isEmptyString = function(str) {
+  return str.length == 0;
+};
+
+
+/**
+ * Checks if a string is empty or contains only whitespaces.
+ *
+ * TODO(user): Deprecate this when clients have been switched over to
+ * goog.string.isEmptyOrWhitespace.
+ *
+ * @param {string} str The string to check.
+ * @return {boolean} Whether {@code str} is empty or whitespace only.
+ */
+goog.string.isEmpty = goog.string.isEmptyOrWhitespace;
+
+
 /**
  * Checks if a string is null, undefined, empty or contains only whitespaces.
  * @param {*} str The string to check.
- * @return {boolean} True if{@code str} is null, undefined, empty, or
+ * @return {boolean} Whether {@code str} is null, undefined, empty, or
  *     whitespace only.
+ * @deprecated Use goog.string.isEmptyOrWhitespace(goog.string.makeSafe(str))
+ *     instead.
  */
-goog.string.isEmptySafe = function(str) {
-  return goog.string.isEmpty(goog.string.makeSafe(str));
+goog.string.isEmptyOrWhitespaceSafe = function(str) {
+  return goog.string.isEmptyOrWhitespace(goog.string.makeSafe(str));
 };
 
 
+/**
+ * Checks if a string is null, undefined, empty or contains only whitespaces.
+ *
+ * TODO(user): Deprecate this when clients have been switched over to
+ * goog.string.isEmptyOrWhitespaceSafe.
+ *
+ * @param {*} str The string to check.
+ * @return {boolean} Whether {@code str} is null, undefined, empty, or
+ *     whitespace only.
+ */
+goog.string.isEmptySafe = goog.string.isEmptyOrWhitespaceSafe;
+
+
 /**
  * Checks if a string is all breaking whitespace.
  * @param {string} str The string to check.
@@ -202,7 +253,7 @@ goog.string.isAlphaNumeric = function(str) {
 /**
  * Checks if a character is a space character.
  * @param {string} ch Character to check.
- * @return {boolean} True if {code ch} is a space.
+ * @return {boolean} True if {@code ch} is a space.
  */
 goog.string.isSpace = function(ch) {
   return ch == ' ';
@@ -212,7 +263,7 @@ goog.string.isSpace = function(ch) {
 /**
  * Checks if a character is a valid unicode character.
  * @param {string} ch Character to check.
- * @return {boolean} True if {code ch} is a valid unicode character.
+ * @return {boolean} True if {@code ch} is a valid unicode character.
  */
 goog.string.isUnicodeChar = function(ch) {
   return ch.length == 1 && ch >= ' ' && ch <= '~' ||
@@ -282,12 +333,17 @@ goog.string.collapseBreakingSpaces = function(str) {
  * @param {string} str The string to trim.
  * @return {string} A trimmed copy of {@code str}.
  */
-goog.string.trim = function(str) {
-  // Since IE doesn't include non-breaking-space (0xa0) in their \s character
-  // class (as required by section 7.2 of the ECMAScript spec), we explicitly
-  // include it in the regexp to enforce consistent cross-browser behavior.
-  return str.replace(/^[\s\xa0]+|[\s\xa0]+$/g, '');
-};
+goog.string.trim = (goog.TRUSTED_SITE && String.prototype.trim) ?
+    function(str) {
+      return str.trim();
+    } :
+    function(str) {
+      // Since IE doesn't include non-breaking-space (0xa0) in their \s
+      // character class (as required by section 7.2 of the ECMAScript spec),
+      // we explicitly include it in the regexp to enforce consistent
+      // cross-browser behavior.
+      return str.replace(/^[\s\xa0]+|[\s\xa0]+$/g, '');
+    };
 
 
 /**
@@ -341,31 +397,18 @@ goog.string.caseInsensitiveCompare = function(str1, str2) {
 
 
 /**
- * Regular expression used for splitting a string into substrings of fractional
- * numbers, integers, and non-numeric characters.
- * @type {RegExp}
- * @private
- */
-goog.string.numerateCompareRegExp_ = /(\.\d+)|(\d+)|(\D+)/g;
-
-
-/**
- * String comparison function that handles numbers in a way humans might expect.
- * Using this function, the string "File 2.jpg" sorts before "File 10.jpg". The
- * comparison is mostly case-insensitive, though strings that are identical
- * except for case are sorted with the upper-case strings before lower-case.
- *
- * This comparison function is significantly slower (about 500x) than either
- * the default or the case-insensitive compare. It should not be used in
- * time-critical code, but should be fast enough to sort several hundred short
- * strings (like filenames) with a reasonable delay.
+ * Compares two strings interpreting their numeric substrings as numbers.
  *
- * @param {string} str1 The string to compare in a numerically sensitive way.
- * @param {string} str2 The string to compare {@code str1} to.
- * @return {number} less than 0 if str1 < str2, 0 if str1 == str2, greater than
- *     0 if str1 > str2.
+ * @param {string} str1 First string.
+ * @param {string} str2 Second string.
+ * @param {!RegExp} tokenizerRegExp Splits a string into substrings of
+ *     non-negative integers, non-numeric characters and optionally fractional
+ *     numbers starting with a decimal point.
+ * @return {number} Negative if str1 < str2, 0 is str1 == str2, positive if
+ *     str1 > str2.
+ * @private
  */
-goog.string.numerateCompare = function(str1, str2) {
+goog.string.numberAwareCompare_ = function(str1, str2, tokenizerRegExp) {
   if (str1 == str2) {
     return 0;
   }
@@ -378,8 +421,8 @@ goog.string.numerateCompare = function(str1, str2) {
 
   // Using match to split the entire string ahead of time turns out to be faster
   // for most inputs than using RegExp.exec or iterating over each character.
-  var tokens1 = str1.toLowerCase().match(goog.string.numerateCompareRegExp_);
-  var tokens2 = str2.toLowerCase().match(goog.string.numerateCompareRegExp_);
+  var tokens1 = str1.toLowerCase().match(tokenizerRegExp);
+  var tokens2 = str2.toLowerCase().match(tokenizerRegExp);
 
   var count = Math.min(tokens1.length, tokens2.length);
 
@@ -389,7 +432,6 @@ goog.string.numerateCompare = function(str1, str2) {
 
     // Compare pairs of tokens, returning if one token sorts before the other.
     if (a != b) {
-
       // Only if both tokens are integers is a special comparison required.
       // Decimal numbers are sorted as strings (e.g., '.09' < '.1').
       var num1 = parseInt(a, 10);
@@ -409,12 +451,61 @@ goog.string.numerateCompare = function(str1, str2) {
   }
 
   // The two strings must be equivalent except for case (perfect equality is
-  // tested at the head of the function.) Revert to default ASCII-betical string
-  // comparison to stablize the sort.
+  // tested at the head of the function.) Revert to default ASCII string
+  // comparison to stabilize the sort.
   return str1 < str2 ? -1 : 1;
 };
 
 
+/**
+ * String comparison function that handles non-negative integer numbers in a
+ * way humans might expect. Using this function, the string 'File 2.jpg' sorts
+ * before 'File 10.jpg', and 'Version 1.9' before 'Version 1.10'. The comparison
+ * is mostly case-insensitive, though strings that are identical except for case
+ * are sorted with the upper-case strings before lower-case.
+ *
+ * This comparison function is up to 50x slower than either the default or the
+ * case-insensitive compare. It should not be used in time-critical code, but
+ * should be fast enough to sort several hundred short strings (like filenames)
+ * with a reasonable delay.
+ *
+ * @param {string} str1 The string to compare in a numerically sensitive way.
+ * @param {string} str2 The string to compare {@code str1} to.
+ * @return {number} less than 0 if str1 < str2, 0 if str1 == str2, greater than
+ *     0 if str1 > str2.
+ */
+goog.string.intAwareCompare = function(str1, str2) {
+  return goog.string.numberAwareCompare_(str1, str2, /\d+|\D+/g);
+};
+
+
+/**
+ * String comparison function that handles non-negative integer and fractional
+ * numbers in a way humans might expect. Using this function, the string
+ * 'File 2.jpg' sorts before 'File 10.jpg', and '3.14' before '3.2'. Equivalent
+ * to {@link goog.string.intAwareCompare} apart from the way how it interprets
+ * dots.
+ *
+ * @param {string} str1 The string to compare in a numerically sensitive way.
+ * @param {string} str2 The string to compare {@code str1} to.
+ * @return {number} less than 0 if str1 < str2, 0 if str1 == str2, greater than
+ *     0 if str1 > str2.
+ */
+goog.string.floatAwareCompare = function(str1, str2) {
+  return goog.string.numberAwareCompare_(str1, str2, /\d+|\.\d+|\D+/g);
+};
+
+
+/**
+ * Alias for {@link goog.string.floatAwareCompare}.
+ *
+ * @param {string} str1
+ * @param {string} str2
+ * @return {number}
+ */
+goog.string.numerateCompare = goog.string.floatAwareCompare;
+
+
 /**
  * URL-encodes a string
  * @param {*} str The string to url-encode.
@@ -450,13 +541,17 @@ goog.string.newLineToBr = function(str, opt_xml) {
 
 
 /**
- * Escape double quote '"' characters in addition to '&', '<', and '>' so that a
- * string can be included in an HTML tag attribute value within double quotes.
+ * Escapes double quote '"' and single quote '\'' characters in addition to
+ * '&', '<', and '>' so that a string can be included in an HTML tag attribute
+ * value within double or single quotes.
  *
  * It should be noted that > doesn't need to be escaped for the HTML or XML to
  * be valid, but it has been decided to escape it for consistency with other
  * implementations.
  *
+ * With goog.string.DETECT_DOUBLE_ESCAPING, this function escapes also the
+ * lowercase letter "e".
+ *
  * NOTE(user):
  * HtmlEscape is often called during the generation of large blocks of HTML.
  * Using statics for the regular expressions and strings is an optimization
@@ -492,28 +587,43 @@ goog.string.newLineToBr = function(str, opt_xml) {
 goog.string.htmlEscape = function(str, opt_isLikelyToContainHtmlChars) {
 
   if (opt_isLikelyToContainHtmlChars) {
-    return str.replace(goog.string.amperRe_, '&amp;')
-          .replace(goog.string.ltRe_, '&lt;')
-          .replace(goog.string.gtRe_, '&gt;')
-          .replace(goog.string.quotRe_, '&quot;');
+    str = str.replace(goog.string.AMP_RE_, '&amp;')
+          .replace(goog.string.LT_RE_, '&lt;')
+          .replace(goog.string.GT_RE_, '&gt;')
+          .replace(goog.string.QUOT_RE_, '&quot;')
+          .replace(goog.string.SINGLE_QUOTE_RE_, '&#39;')
+          .replace(goog.string.NULL_RE_, '&#0;');
+    if (goog.string.DETECT_DOUBLE_ESCAPING) {
+      str = str.replace(goog.string.E_RE_, '&#101;');
+    }
+    return str;
 
   } else {
     // quick test helps in the case when there are no chars to replace, in
     // worst case this makes barely a difference to the time taken
-    if (!goog.string.allRe_.test(str)) return str;
+    if (!goog.string.ALL_RE_.test(str)) return str;
 
     // str.indexOf is faster than regex.test in this case
     if (str.indexOf('&') != -1) {
-      str = str.replace(goog.string.amperRe_, '&amp;');
+      str = str.replace(goog.string.AMP_RE_, '&amp;');
     }
     if (str.indexOf('<') != -1) {
-      str = str.replace(goog.string.ltRe_, '&lt;');
+      str = str.replace(goog.string.LT_RE_, '&lt;');
     }
     if (str.indexOf('>') != -1) {
-      str = str.replace(goog.string.gtRe_, '&gt;');
+      str = str.replace(goog.string.GT_RE_, '&gt;');
     }
     if (str.indexOf('"') != -1) {
-      str = str.replace(goog.string.quotRe_, '&quot;');
+      str = str.replace(goog.string.QUOT_RE_, '&quot;');
+    }
+    if (str.indexOf('\'') != -1) {
+      str = str.replace(goog.string.SINGLE_QUOTE_RE_, '&#39;');
+    }
+    if (str.indexOf('\x00') != -1) {
+      str = str.replace(goog.string.NULL_RE_, '&#0;');
+    }
+    if (goog.string.DETECT_DOUBLE_ESCAPING && str.indexOf('e') != -1) {
+      str = str.replace(goog.string.E_RE_, '&#101;');
     }
     return str;
   }
@@ -522,42 +632,68 @@ goog.string.htmlEscape = function(str, opt_isLikelyToContainHtmlChars) {
 
 /**
  * Regular expression that matches an ampersand, for use in escaping.
- * @type {RegExp}
+ * @const {!RegExp}
  * @private
  */
-goog.string.amperRe_ = /&/g;
+goog.string.AMP_RE_ = /&/g;
 
 
 /**
  * Regular expression that matches a less than sign, for use in escaping.
- * @type {RegExp}
+ * @const {!RegExp}
  * @private
  */
-goog.string.ltRe_ = /</g;
+goog.string.LT_RE_ = /</g;
 
 
 /**
  * Regular expression that matches a greater than sign, for use in escaping.
- * @type {RegExp}
+ * @const {!RegExp}
  * @private
  */
-goog.string.gtRe_ = />/g;
+goog.string.GT_RE_ = />/g;
 
 
 /**
  * Regular expression that matches a double quote, for use in escaping.
- * @type {RegExp}
+ * @const {!RegExp}
+ * @private
+ */
+goog.string.QUOT_RE_ = /"/g;
+
+
+/**
+ * Regular expression that matches a single quote, for use in escaping.
+ * @const {!RegExp}
  * @private
  */
-goog.string.quotRe_ = /\"/g;
+goog.string.SINGLE_QUOTE_RE_ = /'/g;
+
+
+/**
+ * Regular expression that matches null character, for use in escaping.
+ * @const {!RegExp}
+ * @private
+ */
+goog.string.NULL_RE_ = /\x00/g;
+
+
+/**
+ * Regular expression that matches a lowercase letter "e", for use in escaping.
+ * @const {!RegExp}
+ * @private
+ */
+goog.string.E_RE_ = /e/g;
 
 
 /**
  * Regular expression that matches any character that needs to be escaped.
- * @type {RegExp}
+ * @const {!RegExp}
  * @private
  */
-goog.string.allRe_ = /[&<>\"]/;
+goog.string.ALL_RE_ = (goog.string.DETECT_DOUBLE_ESCAPING ?
+    /[\x00&<>"'e]/ :
+    /[\x00&<>"']/);
 
 
 /**
@@ -568,10 +704,10 @@ goog.string.allRe_ = /[&<>\"]/;
  */
 goog.string.unescapeEntities = function(str) {
   if (goog.string.contains(str, '&')) {
-    // We are careful not to use a DOM if we do not have one. We use the []
-    // notation so that the JSCompiler will not complain about these objects and
-    // fields in the case where we have no DOM.
-    if ('document' in goog.global) {
+    // We are careful not to use a DOM if we do not have one or we explicitly
+    // requested non-DOM html unescaping.
+    if (!goog.string.FORCE_NON_DOM_HTML_UNESCAPING &&
+        'document' in goog.global) {
       return goog.string.unescapeEntitiesUsingDom_(str);
     } else {
       // Fall back on pure XML entities
@@ -582,16 +718,40 @@ goog.string.unescapeEntities = function(str) {
 };
 
 
+/**
+ * Unescapes a HTML string using the provided document.
+ *
+ * @param {string} str The string to unescape.
+ * @param {!Document} document A document to use in escaping the string.
+ * @return {string} An unescaped copy of {@code str}.
+ */
+goog.string.unescapeEntitiesWithDocument = function(str, document) {
+  if (goog.string.contains(str, '&')) {
+    return goog.string.unescapeEntitiesUsingDom_(str, document);
+  }
+  return str;
+};
+
+
 /**
  * Unescapes an HTML string using a DOM to resolve non-XML, non-numeric
  * entities. This function is XSS-safe and whitespace-preserving.
  * @private
  * @param {string} str The string to unescape.
+ * @param {Document=} opt_document An optional document to use for creating
+ *     elements. If this is not specified then the default window.document
+ *     will be used.
  * @return {string} The unescaped {@code str} string.
  */
-goog.string.unescapeEntitiesUsingDom_ = function(str) {
+goog.string.unescapeEntitiesUsingDom_ = function(str, opt_document) {
+  /** @type {!Object<string, string>} */
   var seen = {'&amp;': '&', '&lt;': '<', '&gt;': '>', '&quot;': '"'};
-  var div = document.createElement('div');
+  var div;
+  if (opt_document) {
+    div = opt_document.createElement('div');
+  } else {
+    div = goog.global.document.createElement('div');
+  }
   // Match as many valid entity characters as possible. If the actual entity
   // happens to be shorter, it will still work as innerHTML will return the
   // trailing characters unchanged. Since the entity characters do not include
@@ -674,10 +834,22 @@ goog.string.HTML_ENTITY_PATTERN_ = /&([^;\s<&]+);?/g;
  * @return {string} An escaped copy of {@code str}.
  */
 goog.string.whitespaceEscape = function(str, opt_xml) {
+  // This doesn't use goog.string.preserveSpaces for backwards compatibility.
   return goog.string.newLineToBr(str.replace(/  /g, ' &#160;'), opt_xml);
 };
 
 
+/**
+ * Preserve spaces that would be otherwise collapsed in HTML by replacing them
+ * with non-breaking space Unicode characters.
+ * @param {string} str The string in which to preserve whitespace.
+ * @return {string} A copy of {@code str} with preserved whitespace.
+ */
+goog.string.preserveSpaces = function(str) {
+  return str.replace(/(^|[\n ]) /g, '$1' + goog.string.Unicode.NBSP);
+};
+
+
 /**
  * Strip quote characters around a string.  The second argument is a string of
  * characters to treat as quotes.  This can be a single character or a string of
@@ -775,8 +947,7 @@ goog.string.truncateMiddle = function(str, chars,
 
 /**
  * Special chars that need to be escaped for goog.string.quote.
- * @private
- * @type {Object}
+ * @private {!Object<string, string>}
  */
 goog.string.specialEscapeChars_ = {
   '\0': '\\0',
@@ -787,14 +958,19 @@ goog.string.specialEscapeChars_ = {
   '\t': '\\t',
   '\x0B': '\\x0B', // '\v' is not supported in JScript
   '"': '\\"',
-  '\\': '\\\\'
+  '\\': '\\\\',
+  // To support the use case of embedding quoted strings inside of <script>
+  // tags, we have to make sure "<!--", "<script", and "</script" does not
+  // appear in the resulting string. The specific strings that must be escaped
+  // are documented at:
+  // http://www.w3.org/TR/html51/semantics.html#restrictions-for-contents-of-script-elements
+  '<': '\x3c'
 };
 
 
 /**
  * Character mappings used internally for goog.string.escapeChar.
- * @private
- * @type {Object}
+ * @private {!Object<string, string>}
  */
 goog.string.jsEscapeCache_ = {
   '\'': '\\\''
@@ -803,25 +979,22 @@ goog.string.jsEscapeCache_ = {
 
 /**
  * Encloses a string in double quotes and escapes characters so that the
- * string is a valid JS string.
+ * string is a valid JS string. The resulting string is safe to embed in
+ * <script> tags as "<" is escaped.
  * @param {string} s The string to quote.
  * @return {string} A copy of {@code s} surrounded by double quotes.
  */
 goog.string.quote = function(s) {
   s = String(s);
-  if (s.quote) {
-    return s.quote();
-  } else {
-    var sb = ['"'];
-    for (var i = 0; i < s.length; i++) {
-      var ch = s.charAt(i);
-      var cc = ch.charCodeAt(0);
-      sb[i + 1] = goog.string.specialEscapeChars_[ch] ||
-          ((cc > 31 && cc < 127) ? ch : goog.string.escapeChar(ch));
-    }
-    sb.push('"');
-    return sb.join('');
+  var sb = ['"'];
+  for (var i = 0; i < s.length; i++) {
+    var ch = s.charAt(i);
+    var cc = ch.charCodeAt(0);
+    sb[i + 1] = goog.string.specialEscapeChars_[ch] ||
+                ((cc > 31 && cc < 127) ? ch : goog.string.escapeChar(ch));
   }
+  sb.push('"');
+  return sb.join('');
 };
 
 
@@ -879,31 +1052,24 @@ goog.string.escapeChar = function(c) {
 
 
 /**
- * Takes a string and creates a map (Object) in which the keys are the
- * characters in the string. The value for the key is set to true. You can
- * then use goog.object.map or goog.array.map to change the values.
- * @param {string} s The string to build the map from.
- * @return {Object} The map of characters used.
+ * Determines whether a string contains a substring.
+ * @param {string} str The string to search.
+ * @param {string} subString The substring to search for.
+ * @return {boolean} Whether {@code str} contains {@code subString}.
  */
-// TODO(arv): It seems like we should have a generic goog.array.toMap. But do
-//            we want a dependency on goog.array in goog.string?
-goog.string.toMap = function(s) {
-  var rv = {};
-  for (var i = 0; i < s.length; i++) {
-    rv[s.charAt(i)] = true;
-  }
-  return rv;
+goog.string.contains = function(str, subString) {
+  return str.indexOf(subString) != -1;
 };
 
 
 /**
- * Checks whether a string contains a given substring.
- * @param {string} s The string to test.
- * @param {string} ss The substring to test for.
- * @return {boolean} True if {@code s} contains {@code ss}.
+ * Determines whether a string contains a substring, ignoring case.
+ * @param {string} str The string to search.
+ * @param {string} subString The substring to search for.
+ * @return {boolean} Whether {@code str} contains {@code subString}.
  */
-goog.string.contains = function(s, ss) {
-  return s.indexOf(ss) != -1;
+goog.string.caseInsensitiveContains = function(str, subString) {
+  return goog.string.contains(str.toLowerCase(), subString.toLowerCase());
 };
 
 
@@ -984,9 +1150,14 @@ goog.string.regExpEscape = function(s) {
  * @return {string} A string containing {@code length} repetitions of
  *     {@code string}.
  */
-goog.string.repeat = function(string, length) {
-  return new Array(length + 1).join(string);
-};
+goog.string.repeat = (String.prototype.repeat) ?
+    function(string, length) {
+      // The native method is over 100 times faster than the alternative.
+      return string.repeat(length);
+    } :
+    function(string, length) {
+      return new Array(length + 1).join(string);
+    };
 
 
 /**
@@ -1137,14 +1308,6 @@ goog.string.compareElements_ = function(left, right) {
 };
 
 
-/**
- * Maximum value of #goog.string.hashCode, exclusive. 2^32.
- * @type {number}
- * @private
- */
-goog.string.HASHCODE_MAX_ = 0x100000000;
-
-
 /**
  * String hash function similar to java.lang.String.hashCode().
  * The hash code for a string is computed as
@@ -1159,9 +1322,8 @@ goog.string.HASHCODE_MAX_ = 0x100000000;
 goog.string.hashCode = function(str) {
   var result = 0;
   for (var i = 0; i < str.length; ++i) {
-    result = 31 * result + str.charCodeAt(i);
     // Normalize to 4 byte range, 0 ... 2^32.
-    result %= goog.string.HASHCODE_MAX_;
+    result = (31 * result + str.charCodeAt(i)) >>> 0;
   }
   return result;
 };
@@ -1186,7 +1348,7 @@ goog.string.createUniqueString = function() {
 
 
 /**
- * Converts the supplied string to a number, which may be Ininity or NaN.
+ * Converts the supplied string to a number, which may be Infinity or NaN.
  * This function strips whitespace: (toNumber(' 123') === 123)
  * This function accepts scientific notation: (toNumber('1e1') === 10)
  *
@@ -1198,7 +1360,7 @@ goog.string.createUniqueString = function() {
  */
 goog.string.toNumber = function(str) {
   var num = Number(str);
-  if (num == 0 && goog.string.isEmpty(str)) {
+  if (num == 0 && goog.string.isEmptyOrWhitespace(str)) {
     return NaN;
   }
   return num;
@@ -1305,6 +1467,25 @@ goog.string.toTitleCase = function(str, opt_delimiters) {
 };
 
 
+/**
+ * Capitalizes a string, i.e. converts the first letter to uppercase
+ * and all other letters to lowercase, e.g.:
+ *
+ * goog.string.capitalize('one')     => 'One'
+ * goog.string.capitalize('ONE')     => 'One'
+ * goog.string.capitalize('one two') => 'One two'
+ *
+ * Note that this function does not trim initial whitespace.
+ *
+ * @param {string} str String value to capitalize.
+ * @return {string} String value with first letter in uppercase.
+ */
+goog.string.capitalize = function(str) {
+  return String(str.charAt(0)).toUpperCase() +
+      String(str.substr(1)).toLowerCase();
+};
+
+
 /**
  * Parse a string in decimal or hexidecimal ('0xFFFF') form.
  *
@@ -1354,7 +1535,7 @@ goog.string.parseInt = function(value) {
  * @param {number} limit The limit to the number of splits. The resulting array
  *     will have a maximum length of limit+1.  Negative numbers are the same
  *     as zero.
- * @return {!Array.<string>} The string, split.
+ * @return {!Array<string>} The string, split.
  */
 
 goog.string.splitLimit = function(str, separator, limit) {
@@ -1376,3 +1557,43 @@ goog.string.splitLimit = function(str, separator, limit) {
   return returnVal;
 };
 
+
+/**
+ * Computes the Levenshtein edit distance between two strings.
+ * @param {string} a
+ * @param {string} b
+ * @return {number} The edit distance between the two strings.
+ */
+goog.string.editDistance = function(a, b) {
+  var v0 = [];
+  var v1 = [];
+
+  if (a == b) {
+    return 0;
+  }
+
+  if (!a.length || !b.length) {
+    return Math.max(a.length, b.length);
+  }
+
+  for (var i = 0; i < b.length + 1; i++) {
+    v0[i] = i;
+  }
+
+  for (var i = 0; i < a.length; i++) {
+    v1[0] = i + 1;
+
+    for (var j = 0; j < b.length; j++) {
+      var cost = a[i] != b[j];
+      // Cost for the substring is the minimum of adding one character, removing
+      // one character, or a swap.
+      v1[j + 1] = Math.min(v1[j] + 1, v0[j + 1] + 1, v0[j] + cost);
+    }
+
+    for (var j = 0; j < v0.length; j++) {
+      v0[j] = v1[j];
+    }
+  }
+
+  return v1[b.length];
+};
diff --git a/lib/goog/string/typedstring.js b/lib/goog/string/typedstring.js
new file mode 100644
index 0000000..075115f
--- /dev/null
+++ b/lib/goog/string/typedstring.js
@@ -0,0 +1,48 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('goog.string.TypedString');
+
+
+
+/**
+ * Wrapper for strings that conform to a data type or language.
+ *
+ * Implementations of this interface are wrappers for strings, and typically
+ * associate a type contract with the wrapped string.  Concrete implementations
+ * of this interface may choose to implement additional run-time type checking,
+ * see for example {@code goog.html.SafeHtml}. If available, client code that
+ * needs to ensure type membership of an object should use the type's function
+ * to assert type membership, such as {@code goog.html.SafeHtml.unwrap}.
+ * @interface
+ */
+goog.string.TypedString = function() {};
+
+
+/**
+ * Interface marker of the TypedString interface.
+ *
+ * This property can be used to determine at runtime whether or not an object
+ * implements this interface.  All implementations of this interface set this
+ * property to {@code true}.
+ * @type {boolean}
+ */
+goog.string.TypedString.prototype.implementsGoogStringTypedString;
+
+
+/**
+ * Retrieves this wrapped string's value.
+ * @return {!string} The wrapped string's value.
+ */
+goog.string.TypedString.prototype.getTypedStringValue;
diff --git a/lib/goog/structs/collection.js b/lib/goog/structs/collection.js
new file mode 100644
index 0000000..86d008d
--- /dev/null
+++ b/lib/goog/structs/collection.js
@@ -0,0 +1,56 @@
+// Copyright 2011 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Defines the collection interface.
+ *
+ * @author nnaze@google.com (Nathan Naze)
+ */
+
+goog.provide('goog.structs.Collection');
+
+
+
+/**
+ * An interface for a collection of values.
+ * @interface
+ * @template T
+ */
+goog.structs.Collection = function() {};
+
+
+/**
+ * @param {T} value Value to add to the collection.
+ */
+goog.structs.Collection.prototype.add;
+
+
+/**
+ * @param {T} value Value to remove from the collection.
+ */
+goog.structs.Collection.prototype.remove;
+
+
+/**
+ * @param {T} value Value to find in the collection.
+ * @return {boolean} Whether the collection contains the specified value.
+ */
+goog.structs.Collection.prototype.contains;
+
+
+/**
+ * @return {number} The number of values stored in the collection.
+ */
+goog.structs.Collection.prototype.getCount;
+
diff --git a/lib/goog/structs/map.js b/lib/goog/structs/map.js
index cd70f6c..697dda0 100644
--- a/lib/goog/structs/map.js
+++ b/lib/goog/structs/map.js
@@ -16,13 +16,11 @@
  * @fileoverview Datastructure: Hash Map.
  *
  * @author arv@google.com (Erik Arvidsson)
- * @author jonp@google.com (Jon Perlow) Optimized for IE6
  *
  * This file contains an implementation of a Map structure. It implements a lot
  * of the methods used in goog.structs so those functions work on hashes. This
  * is best suited for complex key types. For simple keys such as numbers and
- * strings, and where special names like __proto__ are not a concern, consider
- * using the lighter-weight utilities in goog.object.
+ * strings consider using the lighter-weight utilities in goog.object.
  */
 
 
@@ -40,13 +38,13 @@ goog.require('goog.object');
  * @param {...*} var_args If 2 or more arguments are present then they
  *     will be used as key-value pairs.
  * @constructor
+ * @template K, V
  */
 goog.structs.Map = function(opt_map, var_args) {
 
   /**
    * Underlying JS object used to implement the map.
-   * @type {!Object}
-   * @private
+   * @private {!Object}
    */
   this.map_ = {};
 
@@ -61,11 +59,22 @@ goog.structs.Map = function(opt_map, var_args) {
    * This array can contain deleted keys so it's necessary to check the map
    * as well to see if the key is still in the map (this doesn't require a
    * memory allocation in IE).
-   * @type {!Array.<string>}
-   * @private
+   * @private {!Array<string>}
    */
   this.keys_ = [];
 
+  /**
+   * The number of key value pairs in the map.
+   * @private {number}
+   */
+  this.count_ = 0;
+
+  /**
+   * Version used to detect changes while iterating.
+   * @private {number}
+   */
+  this.version_ = 0;
+
   var argLength = arguments.length;
 
   if (argLength > 1) {
@@ -81,22 +90,6 @@ goog.structs.Map = function(opt_map, var_args) {
 };
 
 
-/**
- * The number of key value pairs in the map.
- * @private
- * @type {number}
- */
-goog.structs.Map.prototype.count_ = 0;
-
-
-/**
- * Version used to detect changes while iterating.
- * @private
- * @type {number}
- */
-goog.structs.Map.prototype.version_ = 0;
-
-
 /**
  * @return {number} The number of key-value pairs in the map.
  */
@@ -107,7 +100,7 @@ goog.structs.Map.prototype.getCount = function() {
 
 /**
  * Returns the values of the map.
- * @return {!Array} The values in the map.
+ * @return {!Array<V>} The values in the map.
  */
 goog.structs.Map.prototype.getValues = function() {
   this.cleanupKeysArray_();
@@ -123,11 +116,11 @@ goog.structs.Map.prototype.getValues = function() {
 
 /**
  * Returns the keys of the map.
- * @return {!Array.<string>} Array of string values.
+ * @return {!Array<string>} Array of string values.
  */
 goog.structs.Map.prototype.getKeys = function() {
   this.cleanupKeysArray_();
-  return /** @type {!Array.<string>} */ (this.keys_.concat());
+  return /** @type {!Array<string>} */ (this.keys_.concat());
 };
 
 
@@ -143,7 +136,7 @@ goog.structs.Map.prototype.containsKey = function(key) {
 
 /**
  * Whether the map contains the given value. This is O(n).
- * @param {*} val The value to check for.
+ * @param {V} val The value to check for.
  * @return {boolean} Whether the map contains the value.
  */
 goog.structs.Map.prototype.containsValue = function(val) {
@@ -160,7 +153,7 @@ goog.structs.Map.prototype.containsValue = function(val) {
 /**
  * Whether this map is equal to the argument map.
  * @param {goog.structs.Map} otherMap The map against which to test equality.
- * @param {function(?, ?) : boolean=} opt_equalityFn Optional equality function
+ * @param {function(V, V): boolean=} opt_equalityFn Optional equality function
  *     to test equality of values. If not specified, this will test whether
  *     the values contained in each map are identical objects.
  * @return {boolean} Whether the maps are equal.
@@ -287,9 +280,10 @@ goog.structs.Map.prototype.cleanupKeysArray_ = function() {
  * Returns the value for the given key.  If the key is not found and the default
  * value is not given this will return {@code undefined}.
  * @param {*} key The key to get the value for.
- * @param {*=} opt_val The value to return if no item is found for the given
- *     key, defaults to undefined.
- * @return {*} The value for the given key.
+ * @param {DEFAULT=} opt_val The value to return if no item is found for the
+ *     given key, defaults to undefined.
+ * @return {V|DEFAULT} The value for the given key.
+ * @template DEFAULT
  */
 goog.structs.Map.prototype.get = function(key, opt_val) {
   if (goog.structs.Map.hasKey_(this.map_, key)) {
@@ -302,13 +296,15 @@ goog.structs.Map.prototype.get = function(key, opt_val) {
 /**
  * Adds a key-value pair to the map.
  * @param {*} key The key.
- * @param {*} value The value to add.
+ * @param {V} value The value to add.
  * @return {*} Some subclasses return a value.
  */
 goog.structs.Map.prototype.set = function(key, value) {
   if (!(goog.structs.Map.hasKey_(this.map_, key))) {
     this.count_++;
-    this.keys_.push(key);
+    // TODO(johnlenz): This class lies, it claims to return an array of string
+    // keys, but instead returns the original object used.
+    this.keys_.push(/** @type {?} */ (key));
     // Only change the version if we add a new key.
     this.version_++;
   }
@@ -337,6 +333,22 @@ goog.structs.Map.prototype.addAll = function(map) {
 };
 
 
+/**
+ * Calls the given function on each entry in the map.
+ * @param {function(this:T, V, K, goog.structs.Map<K,V>)} f
+ * @param {T=} opt_obj The value of "this" inside f.
+ * @template T
+ */
+goog.structs.Map.prototype.forEach = function(f, opt_obj) {
+  var keys = this.getKeys();
+  for (var i = 0; i < keys.length; i++) {
+    var key = keys[i];
+    var value = this.get(key);
+    f.call(opt_obj, value, key, this);
+  }
+};
+
+
 /**
  * Clones a map and returns a new map.
  * @return {!goog.structs.Map} A new map with the same key-value pairs.
@@ -414,23 +426,19 @@ goog.structs.Map.prototype.__iterator__ = function(opt_keys) {
   this.cleanupKeysArray_();
 
   var i = 0;
-  var keys = this.keys_;
-  var map = this.map_;
   var version = this.version_;
   var selfObj = this;
 
   var newIter = new goog.iter.Iterator;
   newIter.next = function() {
-    while (true) {
-      if (version != selfObj.version_) {
-        throw Error('The map has changed since the iterator was created');
-      }
-      if (i >= keys.length) {
-        throw goog.iter.StopIteration;
-      }
-      var key = keys[i++];
-      return opt_keys ? key : map[key];
+    if (version != selfObj.version_) {
+      throw Error('The map has changed since the iterator was created');
+    }
+    if (i >= selfObj.keys_.length) {
+      throw goog.iter.StopIteration;
     }
+    var key = selfObj.keys_[i++];
+    return opt_keys ? key : selfObj.map_[key];
   };
   return newIter;
 };
diff --git a/lib/goog/structs/set.js b/lib/goog/structs/set.js
new file mode 100644
index 0000000..334ecae
--- /dev/null
+++ b/lib/goog/structs/set.js
@@ -0,0 +1,279 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Datastructure: Set.
+ *
+ * @author arv@google.com (Erik Arvidsson)
+ *
+ * This class implements a set data structure. Adding and removing is O(1). It
+ * supports both object and primitive values. Be careful because you can add
+ * both 1 and new Number(1), because these are not the same. You can even add
+ * multiple new Number(1) because these are not equal.
+ */
+
+
+goog.provide('goog.structs.Set');
+
+goog.require('goog.structs');
+goog.require('goog.structs.Collection');
+goog.require('goog.structs.Map');
+
+
+
+/**
+ * A set that can contain both primitives and objects.  Adding and removing
+ * elements is O(1).  Primitives are treated as identical if they have the same
+ * type and convert to the same string.  Objects are treated as identical only
+ * if they are references to the same object.  WARNING: A goog.structs.Set can
+ * contain both 1 and (new Number(1)), because they are not the same.  WARNING:
+ * Adding (new Number(1)) twice will yield two distinct elements, because they
+ * are two different objects.  WARNING: Any object that is added to a
+ * goog.structs.Set will be modified!  Because goog.getUid() is used to
+ * identify objects, every object in the set will be mutated.
+ * @param {Array<T>|Object<?,T>=} opt_values Initial values to start with.
+ * @constructor
+ * @implements {goog.structs.Collection<T>}
+ * @final
+ * @template T
+ */
+goog.structs.Set = function(opt_values) {
+  this.map_ = new goog.structs.Map;
+  if (opt_values) {
+    this.addAll(opt_values);
+  }
+};
+
+
+/**
+ * Obtains a unique key for an element of the set.  Primitives will yield the
+ * same key if they have the same type and convert to the same string.  Object
+ * references will yield the same key only if they refer to the same object.
+ * @param {*} val Object or primitive value to get a key for.
+ * @return {string} A unique key for this value/object.
+ * @private
+ */
+goog.structs.Set.getKey_ = function(val) {
+  var type = typeof val;
+  if (type == 'object' && val || type == 'function') {
+    return 'o' + goog.getUid(/** @type {Object} */ (val));
+  } else {
+    return type.substr(0, 1) + val;
+  }
+};
+
+
+/**
+ * @return {number} The number of elements in the set.
+ * @override
+ */
+goog.structs.Set.prototype.getCount = function() {
+  return this.map_.getCount();
+};
+
+
+/**
+ * Add a primitive or an object to the set.
+ * @param {T} element The primitive or object to add.
+ * @override
+ */
+goog.structs.Set.prototype.add = function(element) {
+  this.map_.set(goog.structs.Set.getKey_(element), element);
+};
+
+
+/**
+ * Adds all the values in the given collection to this set.
+ * @param {Array<T>|goog.structs.Collection<T>|Object<?,T>} col A collection
+ *     containing the elements to add.
+ */
+goog.structs.Set.prototype.addAll = function(col) {
+  var values = goog.structs.getValues(col);
+  var l = values.length;
+  for (var i = 0; i < l; i++) {
+    this.add(values[i]);
+  }
+};
+
+
+/**
+ * Removes all values in the given collection from this set.
+ * @param {Array<T>|goog.structs.Collection<T>|Object<?,T>} col A collection
+ *     containing the elements to remove.
+ */
+goog.structs.Set.prototype.removeAll = function(col) {
+  var values = goog.structs.getValues(col);
+  var l = values.length;
+  for (var i = 0; i < l; i++) {
+    this.remove(values[i]);
+  }
+};
+
+
+/**
+ * Removes the given element from this set.
+ * @param {T} element The primitive or object to remove.
+ * @return {boolean} Whether the element was found and removed.
+ * @override
+ */
+goog.structs.Set.prototype.remove = function(element) {
+  return this.map_.remove(goog.structs.Set.getKey_(element));
+};
+
+
+/**
+ * Removes all elements from this set.
+ */
+goog.structs.Set.prototype.clear = function() {
+  this.map_.clear();
+};
+
+
+/**
+ * Tests whether this set is empty.
+ * @return {boolean} True if there are no elements in this set.
+ */
+goog.structs.Set.prototype.isEmpty = function() {
+  return this.map_.isEmpty();
+};
+
+
+/**
+ * Tests whether this set contains the given element.
+ * @param {T} element The primitive or object to test for.
+ * @return {boolean} True if this set contains the given element.
+ * @override
+ */
+goog.structs.Set.prototype.contains = function(element) {
+  return this.map_.containsKey(goog.structs.Set.getKey_(element));
+};
+
+
+/**
+ * Tests whether this set contains all the values in a given collection.
+ * Repeated elements in the collection are ignored, e.g.  (new
+ * goog.structs.Set([1, 2])).containsAll([1, 1]) is True.
+ * @param {goog.structs.Collection<T>|Object} col A collection-like object.
+ * @return {boolean} True if the set contains all elements.
+ */
+goog.structs.Set.prototype.containsAll = function(col) {
+  return goog.structs.every(col, this.contains, this);
+};
+
+
+/**
+ * Finds all values that are present in both this set and the given collection.
+ * @param {Array<S>|Object<?,S>} col A collection.
+ * @return {!goog.structs.Set<T|S>} A new set containing all the values
+ *     (primitives or objects) present in both this set and the given
+ *     collection.
+ * @template S
+ */
+goog.structs.Set.prototype.intersection = function(col) {
+  var result = new goog.structs.Set();
+
+  var values = goog.structs.getValues(col);
+  for (var i = 0; i < values.length; i++) {
+    var value = values[i];
+    if (this.contains(value)) {
+      result.add(value);
+    }
+  }
+
+  return result;
+};
+
+
+/**
+ * Finds all values that are present in this set and not in the given
+ * collection.
+ * @param {Array<T>|goog.structs.Collection<T>|Object<?,T>} col A collection.
+ * @return {!goog.structs.Set} A new set containing all the values
+ *     (primitives or objects) present in this set but not in the given
+ *     collection.
+ */
+goog.structs.Set.prototype.difference = function(col) {
+  var result = this.clone();
+  result.removeAll(col);
+  return result;
+};
+
+
+/**
+ * Returns an array containing all the elements in this set.
+ * @return {!Array<T>} An array containing all the elements in this set.
+ */
+goog.structs.Set.prototype.getValues = function() {
+  return this.map_.getValues();
+};
+
+
+/**
+ * Creates a shallow clone of this set.
+ * @return {!goog.structs.Set<T>} A new set containing all the same elements as
+ *     this set.
+ */
+goog.structs.Set.prototype.clone = function() {
+  return new goog.structs.Set(this);
+};
+
+
+/**
+ * Tests whether the given collection consists of the same elements as this set,
+ * regardless of order, without repetition.  Primitives are treated as equal if
+ * they have the same type and convert to the same string; objects are treated
+ * as equal if they are references to the same object.  This operation is O(n).
+ * @param {goog.structs.Collection<T>|Object} col A collection.
+ * @return {boolean} True if the given collection consists of the same elements
+ *     as this set, regardless of order, without repetition.
+ */
+goog.structs.Set.prototype.equals = function(col) {
+  return this.getCount() == goog.structs.getCount(col) && this.isSubsetOf(col);
+};
+
+
+/**
+ * Tests whether the given collection contains all the elements in this set.
+ * Primitives are treated as equal if they have the same type and convert to the
+ * same string; objects are treated as equal if they are references to the same
+ * object.  This operation is O(n).
+ * @param {goog.structs.Collection<T>|Object} col A collection.
+ * @return {boolean} True if this set is a subset of the given collection.
+ */
+goog.structs.Set.prototype.isSubsetOf = function(col) {
+  var colCount = goog.structs.getCount(col);
+  if (this.getCount() > colCount) {
+    return false;
+  }
+  // TODO(user) Find the minimal collection size where the conversion makes
+  // the contains() method faster.
+  if (!(col instanceof goog.structs.Set) && colCount > 5) {
+    // Convert to a goog.structs.Set so that goog.structs.contains runs in
+    // O(1) time instead of O(n) time.
+    col = new goog.structs.Set(col);
+  }
+  return goog.structs.every(this, function(value) {
+    return goog.structs.contains(col, value);
+  });
+};
+
+
+/**
+ * Returns an iterator that iterates over the elements in this set.
+ * @param {boolean=} opt_keys This argument is ignored.
+ * @return {!goog.iter.Iterator} An iterator over the elements in this set.
+ */
+goog.structs.Set.prototype.__iterator__ = function(opt_keys) {
+  return this.map_.__iterator__(false);
+};
diff --git a/lib/goog/structs/structs.js b/lib/goog/structs/structs.js
index 99611bf..1ee7d29 100644
--- a/lib/goog/structs/structs.js
+++ b/lib/goog/structs/structs.js
@@ -39,7 +39,7 @@ goog.require('goog.object');
  * @return {number} The number of values in the collection-like object.
  */
 goog.structs.getCount = function(col) {
-  if (typeof col.getCount == 'function') {
+  if (col.getCount && typeof col.getCount == 'function') {
     return col.getCount();
   }
   if (goog.isArrayLike(col) || goog.isString(col)) {
@@ -52,10 +52,10 @@ goog.structs.getCount = function(col) {
 /**
  * Returns the values of the collection-like object.
  * @param {Object} col The collection-like object.
- * @return {!Array} The values in the collection-like object.
+ * @return {!Array<?>} The values in the collection-like object.
  */
 goog.structs.getValues = function(col) {
-  if (typeof col.getValues == 'function') {
+  if (col.getValues && typeof col.getValues == 'function') {
     return col.getValues();
   }
   if (goog.isString(col)) {
@@ -80,11 +80,11 @@ goog.structs.getValues = function(col) {
  * @return {!Array|undefined} The keys in the collection.
  */
 goog.structs.getKeys = function(col) {
-  if (typeof col.getKeys == 'function') {
+  if (col.getKeys && typeof col.getKeys == 'function') {
     return col.getKeys();
   }
   // if we have getValues but no getKeys we know this is a key-less collection
-  if (typeof col.getValues == 'function') {
+  if (col.getValues && typeof col.getValues == 'function') {
     return undefined;
   }
   if (goog.isArrayLike(col) || goog.isString(col)) {
@@ -108,14 +108,14 @@ goog.structs.getKeys = function(col) {
  * @return {boolean} True if the map contains the value.
  */
 goog.structs.contains = function(col, val) {
-  if (typeof col.contains == 'function') {
+  if (col.contains && typeof col.contains == 'function') {
     return col.contains(val);
   }
-  if (typeof col.containsValue == 'function') {
+  if (col.containsValue && typeof col.containsValue == 'function') {
     return col.containsValue(val);
   }
   if (goog.isArrayLike(col) || goog.isString(col)) {
-    return goog.array.contains(/** @type {Array} */ (col), val);
+    return goog.array.contains(/** @type {!Array<?>} */ (col), val);
   }
   return goog.object.containsValue(col, val);
 };
@@ -127,15 +127,15 @@ goog.structs.contains = function(col, val) {
  * @return {boolean} True if empty.
  */
 goog.structs.isEmpty = function(col) {
-  if (typeof col.isEmpty == 'function') {
+  if (col.isEmpty && typeof col.isEmpty == 'function') {
     return col.isEmpty();
   }
 
-  // We do not use goog.string.isEmpty because here we treat the string as
+  // We do not use goog.string.isEmptyOrWhitespace because here we treat the string as
   // collection and as such even whitespace matters
 
   if (goog.isArrayLike(col) || goog.isString(col)) {
-    return goog.array.isEmpty(/** @type {Array} */ (col));
+    return goog.array.isEmpty(/** @type {!Array<?>} */ (col));
   }
   return goog.object.isEmpty(col);
 };
@@ -147,7 +147,7 @@ goog.structs.isEmpty = function(col) {
  */
 goog.structs.clear = function(col) {
   // NOTE(arv): This should not contain strings because strings are immutable
-  if (typeof col.clear == 'function') {
+  if (col.clear && typeof col.clear == 'function') {
     col.clear();
   } else if (goog.isArrayLike(col)) {
     goog.array.clear(/** @type {goog.array.ArrayLike} */ (col));
@@ -161,6 +161,9 @@ goog.structs.clear = function(col) {
  * Calls a function for each value in a collection. The function takes
  * three arguments; the value, the key and the collection.
  *
+ * NOTE: This will be deprecated soon! Please use a more specific method if
+ * possible, e.g. goog.array.forEach, goog.object.forEach, etc.
+ *
  * @param {S} col The collection-like object.
  * @param {function(this:T,?,?,S):?} f The function to call for every value.
  *     This function takes
@@ -171,10 +174,10 @@ goog.structs.clear = function(col) {
  * @template T,S
  */
 goog.structs.forEach = function(col, f, opt_obj) {
-  if (typeof col.forEach == 'function') {
+  if (col.forEach && typeof col.forEach == 'function') {
     col.forEach(f, opt_obj);
   } else if (goog.isArrayLike(col) || goog.isString(col)) {
-    goog.array.forEach(/** @type {Array} */ (col), f, opt_obj);
+    goog.array.forEach(/** @type {!Array<?>} */ (col), f, opt_obj);
   } else {
     var keys = goog.structs.getKeys(col);
     var values = goog.structs.getValues(col);
@@ -199,7 +202,7 @@ goog.structs.forEach = function(col, f, opt_obj) {
  *     is false the value is not included.
  * @param {T=} opt_obj The object to be used as the value of 'this'
  *     within {@code f}.
- * @return {!Object|!Array} A new collection where the passed values are
+ * @return {!Object|!Array<?>} A new collection where the passed values are
  *     present. If col is a key-less collection an array is returned.  If col
  *     has keys and values a plain old JS object is returned.
  * @template T,S
@@ -209,7 +212,7 @@ goog.structs.filter = function(col, f, opt_obj) {
     return col.filter(f, opt_obj);
   }
   if (goog.isArrayLike(col) || goog.isString(col)) {
-    return goog.array.filter(/** @type {!Array} */ (col), f, opt_obj);
+    return goog.array.filter(/** @type {!Array<?>} */ (col), f, opt_obj);
   }
 
   var rv;
@@ -249,7 +252,7 @@ goog.structs.filter = function(col, f, opt_obj) {
  *     something. The result will be used as the value in the new collection.
  * @param {T=} opt_obj  The object to be used as the value of 'this'
  *     within {@code f}.
- * @return {!Object.<V>|!Array.<V>} A new collection with the new values.  If
+ * @return {!Object<V>|!Array<V>} A new collection with the new values.  If
  *     col is a key-less collection an array is returned.  If col has keys and
  *     values a plain old JS object is returned.
  * @template T,S,V
@@ -259,7 +262,7 @@ goog.structs.map = function(col, f, opt_obj) {
     return col.map(f, opt_obj);
   }
   if (goog.isArrayLike(col) || goog.isString(col)) {
-    return goog.array.map(/** @type {!Array} */ (col), f, opt_obj);
+    return goog.array.map(/** @type {!Array<?>} */ (col), f, opt_obj);
   }
 
   var rv;
@@ -303,7 +306,7 @@ goog.structs.some = function(col, f, opt_obj) {
     return col.some(f, opt_obj);
   }
   if (goog.isArrayLike(col) || goog.isString(col)) {
-    return goog.array.some(/** @type {!Array} */ (col), f, opt_obj);
+    return goog.array.some(/** @type {!Array<?>} */ (col), f, opt_obj);
   }
   var keys = goog.structs.getKeys(col);
   var values = goog.structs.getValues(col);
@@ -337,7 +340,7 @@ goog.structs.every = function(col, f, opt_obj) {
     return col.every(f, opt_obj);
   }
   if (goog.isArrayLike(col) || goog.isString(col)) {
-    return goog.array.every(/** @type {!Array} */ (col), f, opt_obj);
+    return goog.array.every(/** @type {!Array<?>} */ (col), f, opt_obj);
   }
   var keys = goog.structs.getKeys(col);
   var values = goog.structs.getValues(col);
diff --git a/lib/goog/style/style.js b/lib/goog/style/style.js
new file mode 100644
index 0000000..1a7805b
--- /dev/null
+++ b/lib/goog/style/style.js
@@ -0,0 +1,2037 @@
+// Copyright 2006 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Utilities for element styles.
+ *
+ * @author arv@google.com (Erik Arvidsson)
+ * @author eae@google.com (Emil A Eklund)
+ * @see ../demos/inline_block_quirks.html
+ * @see ../demos/inline_block_standards.html
+ * @see ../demos/style_viewport.html
+ */
+
+goog.provide('goog.style');
+
+
+goog.require('goog.array');
+goog.require('goog.asserts');
+goog.require('goog.dom');
+goog.require('goog.dom.NodeType');
+goog.require('goog.dom.TagName');
+goog.require('goog.dom.vendor');
+goog.require('goog.math.Box');
+goog.require('goog.math.Coordinate');
+goog.require('goog.math.Rect');
+goog.require('goog.math.Size');
+goog.require('goog.object');
+goog.require('goog.string');
+goog.require('goog.userAgent');
+
+goog.forwardDeclare('goog.events.BrowserEvent');
+goog.forwardDeclare('goog.events.Event');
+
+
+/**
+ * Sets a style value on an element.
+ *
+ * This function is not indended to patch issues in the browser's style
+ * handling, but to allow easy programmatic access to setting dash-separated
+ * style properties.  An example is setting a batch of properties from a data
+ * object without overwriting old styles.  When possible, use native APIs:
+ * elem.style.propertyKey = 'value' or (if obliterating old styles is fine)
+ * elem.style.cssText = 'property1: value1; property2: value2'.
+ *
+ * @param {Element} element The element to change.
+ * @param {string|Object} style If a string, a style name. If an object, a hash
+ *     of style names to style values.
+ * @param {string|number|boolean=} opt_value If style was a string, then this
+ *     should be the value.
+ */
+goog.style.setStyle = function(element, style, opt_value) {
+  if (goog.isString(style)) {
+    goog.style.setStyle_(element, opt_value, style);
+  } else {
+    for (var key in style) {
+      goog.style.setStyle_(element, style[key], key);
+    }
+  }
+};
+
+
+/**
+ * Sets a style value on an element, with parameters swapped to work with
+ * {@code goog.object.forEach()}. Prepends a vendor-specific prefix when
+ * necessary.
+ * @param {Element} element The element to change.
+ * @param {string|number|boolean|undefined} value Style value.
+ * @param {string} style Style name.
+ * @private
+ */
+goog.style.setStyle_ = function(element, value, style) {
+  var propertyName = goog.style.getVendorJsStyleName_(element, style);
+
+  if (propertyName) {
+    element.style[propertyName] = value;
+  }
+};
+
+
+/**
+ * Style name cache that stores previous property name lookups.
+ *
+ * This is used by setStyle to speed up property lookups, entries look like:
+ *   { StyleName: ActualPropertyName }
+ *
+ * @private {!Object<string, string>}
+ */
+goog.style.styleNameCache_ = {};
+
+
+/**
+ * Returns the style property name in camel-case. If it does not exist and a
+ * vendor-specific version of the property does exist, then return the vendor-
+ * specific property name instead.
+ * @param {Element} element The element to change.
+ * @param {string} style Style name.
+ * @return {string} Vendor-specific style.
+ * @private
+ */
+goog.style.getVendorJsStyleName_ = function(element, style) {
+  var propertyName = goog.style.styleNameCache_[style];
+  if (!propertyName) {
+    var camelStyle = goog.string.toCamelCase(style);
+    propertyName = camelStyle;
+
+    if (element.style[camelStyle] === undefined) {
+      var prefixedStyle = goog.dom.vendor.getVendorJsPrefix() +
+          goog.string.toTitleCase(camelStyle);
+
+      if (element.style[prefixedStyle] !== undefined) {
+        propertyName = prefixedStyle;
+      }
+    }
+    goog.style.styleNameCache_[style] = propertyName;
+  }
+
+  return propertyName;
+};
+
+
+/**
+ * Returns the style property name in CSS notation. If it does not exist and a
+ * vendor-specific version of the property does exist, then return the vendor-
+ * specific property name instead.
+ * @param {Element} element The element to change.
+ * @param {string} style Style name.
+ * @return {string} Vendor-specific style.
+ * @private
+ */
+goog.style.getVendorStyleName_ = function(element, style) {
+  var camelStyle = goog.string.toCamelCase(style);
+
+  if (element.style[camelStyle] === undefined) {
+    var prefixedStyle = goog.dom.vendor.getVendorJsPrefix() +
+        goog.string.toTitleCase(camelStyle);
+
+    if (element.style[prefixedStyle] !== undefined) {
+      return goog.dom.vendor.getVendorPrefix() + '-' + style;
+    }
+  }
+
+  return style;
+};
+
+
+/**
+ * Retrieves an explicitly-set style value of a node. This returns '' if there
+ * isn't a style attribute on the element or if this style property has not been
+ * explicitly set in script.
+ *
+ * @param {Element} element Element to get style of.
+ * @param {string} property Property to get, css-style (if you have a camel-case
+ * property, use element.style[style]).
+ * @return {string} Style value.
+ */
+goog.style.getStyle = function(element, property) {
+  // element.style is '' for well-known properties which are unset.
+  // For for browser specific styles as 'filter' is undefined
+  // so we need to return '' explicitly to make it consistent across
+  // browsers.
+  var styleValue = element.style[goog.string.toCamelCase(property)];
+
+  // Using typeof here because of a bug in Safari 5.1, where this value
+  // was undefined, but === undefined returned false.
+  if (typeof(styleValue) !== 'undefined') {
+    return styleValue;
+  }
+
+  return element.style[goog.style.getVendorJsStyleName_(element, property)] ||
+      '';
+};
+
+
+/**
+ * Retrieves a computed style value of a node. It returns empty string if the
+ * value cannot be computed (which will be the case in Internet Explorer) or
+ * "none" if the property requested is an SVG one and it has not been
+ * explicitly set (firefox and webkit).
+ *
+ * @param {Element} element Element to get style of.
+ * @param {string} property Property to get (camel-case).
+ * @return {string} Style value.
+ */
+goog.style.getComputedStyle = function(element, property) {
+  var doc = goog.dom.getOwnerDocument(element);
+  if (doc.defaultView && doc.defaultView.getComputedStyle) {
+    var styles = doc.defaultView.getComputedStyle(element, null);
+    if (styles) {
+      // element.style[..] is undefined for browser specific styles
+      // as 'filter'.
+      return styles[property] || styles.getPropertyValue(property) || '';
+    }
+  }
+
+  return '';
+};
+
+
+/**
+ * Gets the cascaded style value of a node, or null if the value cannot be
+ * computed (only Internet Explorer can do this).
+ *
+ * @param {Element} element Element to get style of.
+ * @param {string} style Property to get (camel-case).
+ * @return {string} Style value.
+ */
+goog.style.getCascadedStyle = function(element, style) {
+  // TODO(nicksantos): This should be documented to return null. #fixTypes
+  return element.currentStyle ? element.currentStyle[style] : null;
+};
+
+
+/**
+ * Cross-browser pseudo get computed style. It returns the computed style where
+ * available. If not available it tries the cascaded style value (IE
+ * currentStyle) and in worst case the inline style value.  It shouldn't be
+ * called directly, see http://wiki/Main/ComputedStyleVsCascadedStyle for
+ * discussion.
+ *
+ * @param {Element} element Element to get style of.
+ * @param {string} style Property to get (must be camelCase, not css-style.).
+ * @return {string} Style value.
+ * @private
+ */
+goog.style.getStyle_ = function(element, style) {
+  return goog.style.getComputedStyle(element, style) ||
+         goog.style.getCascadedStyle(element, style) ||
+         (element.style && element.style[style]);
+};
+
+
+/**
+ * Retrieves the computed value of the box-sizing CSS attribute.
+ * Browser support: http://caniuse.com/css3-boxsizing.
+ * @param {!Element} element The element whose box-sizing to get.
+ * @return {?string} 'content-box', 'border-box' or 'padding-box'. null if
+ *     box-sizing is not supported (IE7 and below).
+ */
+goog.style.getComputedBoxSizing = function(element) {
+  return goog.style.getStyle_(element, 'boxSizing') ||
+      goog.style.getStyle_(element, 'MozBoxSizing') ||
+      goog.style.getStyle_(element, 'WebkitBoxSizing') || null;
+};
+
+
+/**
+ * Retrieves the computed value of the position CSS attribute.
+ * @param {Element} element The element to get the position of.
+ * @return {string} Position value.
+ */
+goog.style.getComputedPosition = function(element) {
+  return goog.style.getStyle_(element, 'position');
+};
+
+
+/**
+ * Retrieves the computed background color string for a given element. The
+ * string returned is suitable for assigning to another element's
+ * background-color, but is not guaranteed to be in any particular string
+ * format. Accessing the color in a numeric form may not be possible in all
+ * browsers or with all input.
+ *
+ * If the background color for the element is defined as a hexadecimal value,
+ * the resulting string can be parsed by goog.color.parse in all supported
+ * browsers.
+ *
+ * Whether named colors like "red" or "lightblue" get translated into a
+ * format which can be parsed is browser dependent. Calling this function on
+ * transparent elements will return "transparent" in most browsers or
+ * "rgba(0, 0, 0, 0)" in WebKit.
+ * @param {Element} element The element to get the background color of.
+ * @return {string} The computed string value of the background color.
+ */
+goog.style.getBackgroundColor = function(element) {
+  return goog.style.getStyle_(element, 'backgroundColor');
+};
+
+
+/**
+ * Retrieves the computed value of the overflow-x CSS attribute.
+ * @param {Element} element The element to get the overflow-x of.
+ * @return {string} The computed string value of the overflow-x attribute.
+ */
+goog.style.getComputedOverflowX = function(element) {
+  return goog.style.getStyle_(element, 'overflowX');
+};
+
+
+/**
+ * Retrieves the computed value of the overflow-y CSS attribute.
+ * @param {Element} element The element to get the overflow-y of.
+ * @return {string} The computed string value of the overflow-y attribute.
+ */
+goog.style.getComputedOverflowY = function(element) {
+  return goog.style.getStyle_(element, 'overflowY');
+};
+
+
+/**
+ * Retrieves the computed value of the z-index CSS attribute.
+ * @param {Element} element The element to get the z-index of.
+ * @return {string|number} The computed value of the z-index attribute.
+ */
+goog.style.getComputedZIndex = function(element) {
+  return goog.style.getStyle_(element, 'zIndex');
+};
+
+
+/**
+ * Retrieves the computed value of the text-align CSS attribute.
+ * @param {Element} element The element to get the text-align of.
+ * @return {string} The computed string value of the text-align attribute.
+ */
+goog.style.getComputedTextAlign = function(element) {
+  return goog.style.getStyle_(element, 'textAlign');
+};
+
+
+/**
+ * Retrieves the computed value of the cursor CSS attribute.
+ * @param {Element} element The element to get the cursor of.
+ * @return {string} The computed string value of the cursor attribute.
+ */
+goog.style.getComputedCursor = function(element) {
+  return goog.style.getStyle_(element, 'cursor');
+};
+
+
+/**
+ * Retrieves the computed value of the CSS transform attribute.
+ * @param {Element} element The element to get the transform of.
+ * @return {string} The computed string representation of the transform matrix.
+ */
+goog.style.getComputedTransform = function(element) {
+  var property = goog.style.getVendorStyleName_(element, 'transform');
+  return goog.style.getStyle_(element, property) ||
+      goog.style.getStyle_(element, 'transform');
+};
+
+
+/**
+ * Sets the top/left values of an element.  If no unit is specified in the
+ * argument then it will add px. The second argument is required if the first
+ * argument is a string or number and is ignored if the first argument
+ * is a coordinate.
+ * @param {Element} el Element to move.
+ * @param {string|number|goog.math.Coordinate} arg1 Left position or coordinate.
+ * @param {string|number=} opt_arg2 Top position.
+ */
+goog.style.setPosition = function(el, arg1, opt_arg2) {
+  var x, y;
+
+  if (arg1 instanceof goog.math.Coordinate) {
+    x = arg1.x;
+    y = arg1.y;
+  } else {
+    x = arg1;
+    y = opt_arg2;
+  }
+
+  el.style.left = goog.style.getPixelStyleValue_(
+      /** @type {number|string} */ (x), false);
+  el.style.top = goog.style.getPixelStyleValue_(
+      /** @type {number|string} */ (y), false);
+};
+
+
+/**
+ * Gets the offsetLeft and offsetTop properties of an element and returns them
+ * in a Coordinate object
+ * @param {Element} element Element.
+ * @return {!goog.math.Coordinate} The position.
+ */
+goog.style.getPosition = function(element) {
+  return new goog.math.Coordinate(
+      /** @type {!HTMLElement} */ (element).offsetLeft,
+      /** @type {!HTMLElement} */ (element).offsetTop);
+};
+
+
+/**
+ * Returns the viewport element for a particular document
+ * @param {Node=} opt_node DOM node (Document is OK) to get the viewport element
+ *     of.
+ * @return {Element} document.documentElement or document.body.
+ */
+goog.style.getClientViewportElement = function(opt_node) {
+  var doc;
+  if (opt_node) {
+    doc = goog.dom.getOwnerDocument(opt_node);
+  } else {
+    doc = goog.dom.getDocument();
+  }
+
+  // In old IE versions the document.body represented the viewport
+  if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9) &&
+      !goog.dom.getDomHelper(doc).isCss1CompatMode()) {
+    return doc.body;
+  }
+  return doc.documentElement;
+};
+
+
+/**
+ * Calculates the viewport coordinates relative to the page/document
+ * containing the node. The viewport may be the browser viewport for
+ * non-iframe document, or the iframe container for iframe'd document.
+ * @param {!Document} doc The document to use as the reference point.
+ * @return {!goog.math.Coordinate} The page offset of the viewport.
+ */
+goog.style.getViewportPageOffset = function(doc) {
+  var body = doc.body;
+  var documentElement = doc.documentElement;
+  var scrollLeft = body.scrollLeft || documentElement.scrollLeft;
+  var scrollTop = body.scrollTop || documentElement.scrollTop;
+  return new goog.math.Coordinate(scrollLeft, scrollTop);
+};
+
+
+/**
+ * Gets the client rectangle of the DOM element.
+ *
+ * getBoundingClientRect is part of a new CSS object model draft (with a
+ * long-time presence in IE), replacing the error-prone parent offset
+ * computation and the now-deprecated Gecko getBoxObjectFor.
+ *
+ * This utility patches common browser bugs in getBoundingClientRect. It
+ * will fail if getBoundingClientRect is unsupported.
+ *
+ * If the element is not in the DOM, the result is undefined, and an error may
+ * be thrown depending on user agent.
+ *
+ * @param {!Element} el The element whose bounding rectangle is being queried.
+ * @return {Object} A native bounding rectangle with numerical left, top,
+ *     right, and bottom.  Reported by Firefox to be of object type ClientRect.
+ * @private
+ */
+goog.style.getBoundingClientRect_ = function(el) {
+  var rect;
+  try {
+    rect = el.getBoundingClientRect();
+  } catch (e) {
+    // In IE < 9, calling getBoundingClientRect on an orphan element raises an
+    // "Unspecified Error". All other browsers return zeros.
+    return {'left': 0, 'top': 0, 'right': 0, 'bottom': 0};
+  }
+
+  // Patch the result in IE only, so that this function can be inlined if
+  // compiled for non-IE.
+  if (goog.userAgent.IE && el.ownerDocument.body) {
+
+    // In IE, most of the time, 2 extra pixels are added to the top and left
+    // due to the implicit 2-pixel inset border.  In IE6/7 quirks mode and
+    // IE6 standards mode, this border can be overridden by setting the
+    // document element's border to zero -- thus, we cannot rely on the
+    // offset always being 2 pixels.
+
+    // In quirks mode, the offset can be determined by querying the body's
+    // clientLeft/clientTop, but in standards mode, it is found by querying
+    // the document element's clientLeft/clientTop.  Since we already called
+    // getBoundingClientRect we have already forced a reflow, so it is not
+    // too expensive just to query them all.
+
+    // See: http://msdn.microsoft.com/en-us/library/ms536433(VS.85).aspx
+    var doc = el.ownerDocument;
+    rect.left -= doc.documentElement.clientLeft + doc.body.clientLeft;
+    rect.top -= doc.documentElement.clientTop + doc.body.clientTop;
+  }
+  return rect;
+};
+
+
+/**
+ * Returns the first parent that could affect the position of a given element.
+ * @param {Element} element The element to get the offset parent for.
+ * @return {Element} The first offset parent or null if one cannot be found.
+ */
+goog.style.getOffsetParent = function(element) {
+  // element.offsetParent does the right thing in IE7 and below.  In other
+  // browsers it only includes elements with position absolute, relative or
+  // fixed, not elements with overflow set to auto or scroll.
+  if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(8)) {
+    return element.offsetParent;
+  }
+
+  var doc = goog.dom.getOwnerDocument(element);
+  var positionStyle = goog.style.getStyle_(element, 'position');
+  var skipStatic = positionStyle == 'fixed' || positionStyle == 'absolute';
+  for (var parent = element.parentNode; parent && parent != doc;
+       parent = parent.parentNode) {
+    // Skip shadowDOM roots.
+    if (parent.nodeType == goog.dom.NodeType.DOCUMENT_FRAGMENT &&
+        parent.host) {
+      parent = parent.host;
+    }
+    positionStyle =
+        goog.style.getStyle_(/** @type {!Element} */ (parent), 'position');
+    skipStatic = skipStatic && positionStyle == 'static' &&
+                 parent != doc.documentElement && parent != doc.body;
+    if (!skipStatic && (parent.scrollWidth > parent.clientWidth ||
+                        parent.scrollHeight > parent.clientHeight ||
+                        positionStyle == 'fixed' ||
+                        positionStyle == 'absolute' ||
+                        positionStyle == 'relative')) {
+      return /** @type {!Element} */ (parent);
+    }
+  }
+  return null;
+};
+
+
+/**
+ * Calculates and returns the visible rectangle for a given element. Returns a
+ * box describing the visible portion of the nearest scrollable offset ancestor.
+ * Coordinates are given relative to the document.
+ *
+ * @param {Element} element Element to get the visible rect for.
+ * @return {goog.math.Box} Bounding elementBox describing the visible rect or
+ *     null if scrollable ancestor isn't inside the visible viewport.
+ */
+goog.style.getVisibleRectForElement = function(element) {
+  var visibleRect = new goog.math.Box(0, Infinity, Infinity, 0);
+  var dom = goog.dom.getDomHelper(element);
+  var body = dom.getDocument().body;
+  var documentElement = dom.getDocument().documentElement;
+  var scrollEl = dom.getDocumentScrollElement();
+
+  // Determine the size of the visible rect by climbing the dom accounting for
+  // all scrollable containers.
+  for (var el = element; el = goog.style.getOffsetParent(el); ) {
+    // clientWidth is zero for inline block elements in IE.
+    // on WEBKIT, body element can have clientHeight = 0 and scrollHeight > 0
+    if ((!goog.userAgent.IE || el.clientWidth != 0) &&
+        (!goog.userAgent.WEBKIT || el.clientHeight != 0 || el != body) &&
+        // body may have overflow set on it, yet we still get the entire
+        // viewport. In some browsers, el.offsetParent may be
+        // document.documentElement, so check for that too.
+        (el != body && el != documentElement &&
+            goog.style.getStyle_(el, 'overflow') != 'visible')) {
+      var pos = goog.style.getPageOffset(el);
+      var client = goog.style.getClientLeftTop(el);
+      pos.x += client.x;
+      pos.y += client.y;
+
+      visibleRect.top = Math.max(visibleRect.top, pos.y);
+      visibleRect.right = Math.min(visibleRect.right,
+                                   pos.x + el.clientWidth);
+      visibleRect.bottom = Math.min(visibleRect.bottom,
+                                    pos.y + el.clientHeight);
+      visibleRect.left = Math.max(visibleRect.left, pos.x);
+    }
+  }
+
+  // Clip by window's viewport.
+  var scrollX = scrollEl.scrollLeft, scrollY = scrollEl.scrollTop;
+  visibleRect.left = Math.max(visibleRect.left, scrollX);
+  visibleRect.top = Math.max(visibleRect.top, scrollY);
+  var winSize = dom.getViewportSize();
+  visibleRect.right = Math.min(visibleRect.right, scrollX + winSize.width);
+  visibleRect.bottom = Math.min(visibleRect.bottom, scrollY + winSize.height);
+  return visibleRect.top >= 0 && visibleRect.left >= 0 &&
+         visibleRect.bottom > visibleRect.top &&
+         visibleRect.right > visibleRect.left ?
+         visibleRect : null;
+};
+
+
+/**
+ * Calculate the scroll position of {@code container} with the minimum amount so
+ * that the content and the borders of the given {@code element} become visible.
+ * If the element is bigger than the container, its top left corner will be
+ * aligned as close to the container's top left corner as possible.
+ *
+ * @param {Element} element The element to make visible.
+ * @param {Element=} opt_container The container to scroll. If not set, then the
+ *     document scroll element will be used.
+ * @param {boolean=} opt_center Whether to center the element in the container.
+ *     Defaults to false.
+ * @return {!goog.math.Coordinate} The new scroll position of the container,
+ *     in form of goog.math.Coordinate(scrollLeft, scrollTop).
+ */
+goog.style.getContainerOffsetToScrollInto =
+    function(element, opt_container, opt_center) {
+  var container = opt_container || goog.dom.getDocumentScrollElement();
+  // Absolute position of the element's border's top left corner.
+  var elementPos = goog.style.getPageOffset(element);
+  // Absolute position of the container's border's top left corner.
+  var containerPos = goog.style.getPageOffset(container);
+  var containerBorder = goog.style.getBorderBox(container);
+  if (container == goog.dom.getDocumentScrollElement()) {
+    // The element position is calculated based on the page offset, and the
+    // document scroll element holds the scroll position within the page. We can
+    // use the scroll position to calculate the relative position from the
+    // element.
+    var relX = elementPos.x - container.scrollLeft;
+    var relY = elementPos.y - container.scrollTop;
+    if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(10)) {
+      // In older versions of IE getPageOffset(element) does not include the
+      // container border so it has to be added to accomodate.
+      relX += containerBorder.left;
+      relY += containerBorder.top;
+    }
+  } else {
+    // Relative pos. of the element's border box to the container's content box.
+    var relX = elementPos.x - containerPos.x - containerBorder.left;
+    var relY = elementPos.y - containerPos.y - containerBorder.top;
+  }
+  // How much the element can move in the container, i.e. the difference between
+  // the element's bottom-right-most and top-left-most position where it's
+  // fully visible.
+  var spaceX = container.clientWidth -
+      /** @type {HTMLElement} */ (element).offsetWidth;
+  var spaceY = container.clientHeight -
+      /** @type {HTMLElement} */ (element).offsetHeight;
+
+  var scrollLeft = container.scrollLeft;
+  var scrollTop = container.scrollTop;
+  if (opt_center) {
+    // All browsers round non-integer scroll positions down.
+    scrollLeft += relX - spaceX / 2;
+    scrollTop += relY - spaceY / 2;
+  } else {
+    // This formula was designed to give the correct scroll values in the
+    // following cases:
+    // - element is higher than container (spaceY < 0) => scroll down by relY
+    // - element is not higher that container (spaceY >= 0):
+    //   - it is above container (relY < 0) => scroll up by abs(relY)
+    //   - it is below container (relY > spaceY) => scroll down by relY - spaceY
+    //   - it is in the container => don't scroll
+    scrollLeft += Math.min(relX, Math.max(relX - spaceX, 0));
+    scrollTop += Math.min(relY, Math.max(relY - spaceY, 0));
+  }
+  return new goog.math.Coordinate(scrollLeft, scrollTop);
+};
+
+
+/**
+ * Changes the scroll position of {@code container} with the minimum amount so
+ * that the content and the borders of the given {@code element} become visible.
+ * If the element is bigger than the container, its top left corner will be
+ * aligned as close to the container's top left corner as possible.
+ *
+ * @param {Element} element The element to make visible.
+ * @param {Element=} opt_container The container to scroll. If not set, then the
+ *     document scroll element will be used.
+ * @param {boolean=} opt_center Whether to center the element in the container.
+ *     Defaults to false.
+ */
+goog.style.scrollIntoContainerView =
+    function(element, opt_container, opt_center) {
+  var container = opt_container || goog.dom.getDocumentScrollElement();
+  var offset =
+      goog.style.getContainerOffsetToScrollInto(element, container, opt_center);
+  container.scrollLeft = offset.x;
+  container.scrollTop = offset.y;
+};
+
+
+/**
+ * Returns clientLeft (width of the left border and, if the directionality is
+ * right to left, the vertical scrollbar) and clientTop as a coordinate object.
+ *
+ * @param {Element} el Element to get clientLeft for.
+ * @return {!goog.math.Coordinate} Client left and top.
+ */
+goog.style.getClientLeftTop = function(el) {
+  return new goog.math.Coordinate(el.clientLeft, el.clientTop);
+};
+
+
+/**
+ * Returns a Coordinate object relative to the top-left of the HTML document.
+ * Implemented as a single function to save having to do two recursive loops in
+ * opera and safari just to get both coordinates.  If you just want one value do
+ * use goog.style.getPageOffsetLeft() and goog.style.getPageOffsetTop(), but
+ * note if you call both those methods the tree will be analysed twice.
+ *
+ * @param {Element} el Element to get the page offset for.
+ * @return {!goog.math.Coordinate} The page offset.
+ */
+goog.style.getPageOffset = function(el) {
+  var doc = goog.dom.getOwnerDocument(el);
+  // TODO(gboyer): Update the jsdoc in a way that doesn't break the universe.
+  goog.asserts.assertObject(el, 'Parameter is required');
+
+  // NOTE(arv): If element is hidden (display none or disconnected or any the
+  // ancestors are hidden) we get (0,0) by default but we still do the
+  // accumulation of scroll position.
+
+  // TODO(arv): Should we check if the node is disconnected and in that case
+  //            return (0,0)?
+
+  var pos = new goog.math.Coordinate(0, 0);
+  var viewportElement = goog.style.getClientViewportElement(doc);
+  if (el == viewportElement) {
+    // viewport is always at 0,0 as that defined the coordinate system for this
+    // function - this avoids special case checks in the code below
+    return pos;
+  }
+
+  var box = goog.style.getBoundingClientRect_(el);
+  // Must add the scroll coordinates in to get the absolute page offset
+  // of element since getBoundingClientRect returns relative coordinates to
+  // the viewport.
+  var scrollCoord = goog.dom.getDomHelper(doc).getDocumentScroll();
+  pos.x = box.left + scrollCoord.x;
+  pos.y = box.top + scrollCoord.y;
+
+  return pos;
+};
+
+
+/**
+ * Returns the left coordinate of an element relative to the HTML document
+ * @param {Element} el Elements.
+ * @return {number} The left coordinate.
+ */
+goog.style.getPageOffsetLeft = function(el) {
+  return goog.style.getPageOffset(el).x;
+};
+
+
+/**
+ * Returns the top coordinate of an element relative to the HTML document
+ * @param {Element} el Elements.
+ * @return {number} The top coordinate.
+ */
+goog.style.getPageOffsetTop = function(el) {
+  return goog.style.getPageOffset(el).y;
+};
+
+
+/**
+ * Returns a Coordinate object relative to the top-left of an HTML document
+ * in an ancestor frame of this element. Used for measuring the position of
+ * an element inside a frame relative to a containing frame.
+ *
+ * @param {Element} el Element to get the page offset for.
+ * @param {Window} relativeWin The window to measure relative to. If relativeWin
+ *     is not in the ancestor frame chain of the element, we measure relative to
+ *     the top-most window.
+ * @return {!goog.math.Coordinate} The page offset.
+ */
+goog.style.getFramedPageOffset = function(el, relativeWin) {
+  var position = new goog.math.Coordinate(0, 0);
+
+  // Iterate up the ancestor frame chain, keeping track of the current window
+  // and the current element in that window.
+  var currentWin = goog.dom.getWindow(goog.dom.getOwnerDocument(el));
+  var currentEl = el;
+  do {
+    // if we're at the top window, we want to get the page offset.
+    // if we're at an inner frame, we only want to get the window position
+    // so that we can determine the actual page offset in the context of
+    // the outer window.
+    var offset = currentWin == relativeWin ?
+        goog.style.getPageOffset(currentEl) :
+        goog.style.getClientPositionForElement_(
+            goog.asserts.assert(currentEl));
+
+    position.x += offset.x;
+    position.y += offset.y;
+  } while (currentWin && currentWin != relativeWin &&
+      currentWin != currentWin.parent &&
+      (currentEl = currentWin.frameElement) &&
+      (currentWin = currentWin.parent));
+
+  return position;
+};
+
+
+/**
+ * Translates the specified rect relative to origBase page, for newBase page.
+ * If origBase and newBase are the same, this function does nothing.
+ *
+ * @param {goog.math.Rect} rect The source rectangle relative to origBase page,
+ *     and it will have the translated result.
+ * @param {goog.dom.DomHelper} origBase The DomHelper for the input rectangle.
+ * @param {goog.dom.DomHelper} newBase The DomHelper for the resultant
+ *     coordinate.  This must be a DOM for an ancestor frame of origBase
+ *     or the same as origBase.
+ */
+goog.style.translateRectForAnotherFrame = function(rect, origBase, newBase) {
+  if (origBase.getDocument() != newBase.getDocument()) {
+    var body = origBase.getDocument().body;
+    var pos = goog.style.getFramedPageOffset(body, newBase.getWindow());
+
+    // Adjust Body's margin.
+    pos = goog.math.Coordinate.difference(pos, goog.style.getPageOffset(body));
+
+    if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9) &&
+        !origBase.isCss1CompatMode()) {
+      pos = goog.math.Coordinate.difference(pos, origBase.getDocumentScroll());
+    }
+
+    rect.left += pos.x;
+    rect.top += pos.y;
+  }
+};
+
+
+/**
+ * Returns the position of an element relative to another element in the
+ * document.  A relative to B
+ * @param {Element|Event|goog.events.Event} a Element or mouse event whose
+ *     position we're calculating.
+ * @param {Element|Event|goog.events.Event} b Element or mouse event position
+ *     is relative to.
+ * @return {!goog.math.Coordinate} The relative position.
+ */
+goog.style.getRelativePosition = function(a, b) {
+  var ap = goog.style.getClientPosition(a);
+  var bp = goog.style.getClientPosition(b);
+  return new goog.math.Coordinate(ap.x - bp.x, ap.y - bp.y);
+};
+
+
+/**
+ * Returns the position of the event or the element's border box relative to
+ * the client viewport.
+ * @param {!Element} el Element whose position to get.
+ * @return {!goog.math.Coordinate} The position.
+ * @private
+ */
+goog.style.getClientPositionForElement_ = function(el) {
+  var box = goog.style.getBoundingClientRect_(el);
+  return new goog.math.Coordinate(box.left, box.top);
+};
+
+
+/**
+ * Returns the position of the event or the element's border box relative to
+ * the client viewport. If an event is passed, and if this event is a "touch"
+ * event, then the position of the first changedTouches will be returned.
+ * @param {Element|Event|goog.events.Event} el Element or a mouse / touch event.
+ * @return {!goog.math.Coordinate} The position.
+ */
+goog.style.getClientPosition = function(el) {
+  goog.asserts.assert(el);
+  if (el.nodeType == goog.dom.NodeType.ELEMENT) {
+    return goog.style.getClientPositionForElement_(
+        /** @type {!Element} */ (el));
+  } else {
+    var targetEvent = el.changedTouches ? el.changedTouches[0] : el;
+    return new goog.math.Coordinate(
+        targetEvent.clientX,
+        targetEvent.clientY);
+  }
+};
+
+
+/**
+ * Moves an element to the given coordinates relative to the client viewport.
+ * @param {Element} el Absolutely positioned element to set page offset for.
+ *     It must be in the document.
+ * @param {number|goog.math.Coordinate} x Left position of the element's margin
+ *     box or a coordinate object.
+ * @param {number=} opt_y Top position of the element's margin box.
+ */
+goog.style.setPageOffset = function(el, x, opt_y) {
+  // Get current pageoffset
+  var cur = goog.style.getPageOffset(el);
+
+  if (x instanceof goog.math.Coordinate) {
+    opt_y = x.y;
+    x = x.x;
+  }
+
+  // NOTE(arv): We cannot allow strings for x and y. We could but that would
+  // require us to manually transform between different units
+
+  // Work out deltas
+  var dx = x - cur.x;
+  var dy = opt_y - cur.y;
+
+  // Set position to current left/top + delta
+  goog.style.setPosition(el, /** @type {!HTMLElement} */ (el).offsetLeft + dx,
+                         /** @type {!HTMLElement} */ (el).offsetTop + dy);
+};
+
+
+/**
+ * Sets the width/height values of an element.  If an argument is numeric,
+ * or a goog.math.Size is passed, it is assumed to be pixels and will add
+ * 'px' after converting it to an integer in string form. (This just sets the
+ * CSS width and height properties so it might set content-box or border-box
+ * size depending on the box model the browser is using.)
+ *
+ * @param {Element} element Element to set the size of.
+ * @param {string|number|goog.math.Size} w Width of the element, or a
+ *     size object.
+ * @param {string|number=} opt_h Height of the element. Required if w is not a
+ *     size object.
+ */
+goog.style.setSize = function(element, w, opt_h) {
+  var h;
+  if (w instanceof goog.math.Size) {
+    h = w.height;
+    w = w.width;
+  } else {
+    if (opt_h == undefined) {
+      throw Error('missing height argument');
+    }
+    h = opt_h;
+  }
+
+  goog.style.setWidth(element, /** @type {string|number} */ (w));
+  goog.style.setHeight(element, h);
+};
+
+
+/**
+ * Helper function to create a string to be set into a pixel-value style
+ * property of an element. Can round to the nearest integer value.
+ *
+ * @param {string|number} value The style value to be used. If a number,
+ *     'px' will be appended, otherwise the value will be applied directly.
+ * @param {boolean} round Whether to round the nearest integer (if property
+ *     is a number).
+ * @return {string} The string value for the property.
+ * @private
+ */
+goog.style.getPixelStyleValue_ = function(value, round) {
+  if (typeof value == 'number') {
+    value = (round ? Math.round(value) : value) + 'px';
+  }
+
+  return value;
+};
+
+
+/**
+ * Set the height of an element.  Sets the element's style property.
+ * @param {Element} element Element to set the height of.
+ * @param {string|number} height The height value to set.  If a number, 'px'
+ *     will be appended, otherwise the value will be applied directly.
+ */
+goog.style.setHeight = function(element, height) {
+  element.style.height = goog.style.getPixelStyleValue_(height, true);
+};
+
+
+/**
+ * Set the width of an element.  Sets the element's style property.
+ * @param {Element} element Element to set the width of.
+ * @param {string|number} width The width value to set.  If a number, 'px'
+ *     will be appended, otherwise the value will be applied directly.
+ */
+goog.style.setWidth = function(element, width) {
+  element.style.width = goog.style.getPixelStyleValue_(width, true);
+};
+
+
+/**
+ * Gets the height and width of an element, even if its display is none.
+ *
+ * Specifically, this returns the height and width of the border box,
+ * irrespective of the box model in effect.
+ *
+ * Note that this function does not take CSS transforms into account. Please see
+ * {@code goog.style.getTransformedSize}.
+ * @param {Element} element Element to get size of.
+ * @return {!goog.math.Size} Object with width/height properties.
+ */
+goog.style.getSize = function(element) {
+  return goog.style.evaluateWithTemporaryDisplay_(
+      goog.style.getSizeWithDisplay_, /** @type {!Element} */ (element));
+};
+
+
+/**
+ * Call {@code fn} on {@code element} such that {@code element}'s dimensions are
+ * accurate when it's passed to {@code fn}.
+ * @param {function(!Element): T} fn Function to call with {@code element} as
+ *     an argument after temporarily changing {@code element}'s display such
+ *     that its dimensions are accurate.
+ * @param {!Element} element Element (which may have display none) to use as
+ *     argument to {@code fn}.
+ * @return {T} Value returned by calling {@code fn} with {@code element}.
+ * @template T
+ * @private
+ */
+goog.style.evaluateWithTemporaryDisplay_ = function(fn, element) {
+  if (goog.style.getStyle_(element, 'display') != 'none') {
+    return fn(element);
+  }
+
+  var style = element.style;
+  var originalDisplay = style.display;
+  var originalVisibility = style.visibility;
+  var originalPosition = style.position;
+
+  style.visibility = 'hidden';
+  style.position = 'absolute';
+  style.display = 'inline';
+
+  var retVal = fn(element);
+
+  style.display = originalDisplay;
+  style.position = originalPosition;
+  style.visibility = originalVisibility;
+
+  return retVal;
+};
+
+
+/**
+ * Gets the height and width of an element when the display is not none.
+ * @param {Element} element Element to get size of.
+ * @return {!goog.math.Size} Object with width/height properties.
+ * @private
+ */
+goog.style.getSizeWithDisplay_ = function(element) {
+  var offsetWidth = /** @type {!HTMLElement} */ (element).offsetWidth;
+  var offsetHeight = /** @type {!HTMLElement} */ (element).offsetHeight;
+  var webkitOffsetsZero =
+      goog.userAgent.WEBKIT && !offsetWidth && !offsetHeight;
+  if ((!goog.isDef(offsetWidth) || webkitOffsetsZero) &&
+      element.getBoundingClientRect) {
+    // Fall back to calling getBoundingClientRect when offsetWidth or
+    // offsetHeight are not defined, or when they are zero in WebKit browsers.
+    // This makes sure that we return for the correct size for SVG elements, but
+    // will still return 0 on Webkit prior to 534.8, see
+    // http://trac.webkit.org/changeset/67252.
+    var clientRect = goog.style.getBoundingClientRect_(element);
+    return new goog.math.Size(clientRect.right - clientRect.left,
+        clientRect.bottom - clientRect.top);
+  }
+  return new goog.math.Size(offsetWidth, offsetHeight);
+};
+
+
+/**
+ * Gets the height and width of an element, post transform, even if its display
+ * is none.
+ *
+ * This is like {@code goog.style.getSize}, except:
+ * <ol>
+ * <li>Takes webkitTransforms such as rotate and scale into account.
+ * <li>Will return null if {@code element} doesn't respond to
+ *     {@code getBoundingClientRect}.
+ * <li>Currently doesn't make sense on non-WebKit browsers which don't support
+ *    webkitTransforms.
+ * </ol>
+ * @param {!Element} element Element to get size of.
+ * @return {goog.math.Size} Object with width/height properties.
+ */
+goog.style.getTransformedSize = function(element) {
+  if (!element.getBoundingClientRect) {
+    return null;
+  }
+
+  var clientRect = goog.style.evaluateWithTemporaryDisplay_(
+      goog.style.getBoundingClientRect_, element);
+  return new goog.math.Size(clientRect.right - clientRect.left,
+      clientRect.bottom - clientRect.top);
+};
+
+
+/**
+ * Returns a bounding rectangle for a given element in page space.
+ * @param {Element} element Element to get bounds of. Must not be display none.
+ * @return {!goog.math.Rect} Bounding rectangle for the element.
+ */
+goog.style.getBounds = function(element) {
+  var o = goog.style.getPageOffset(element);
+  var s = goog.style.getSize(element);
+  return new goog.math.Rect(o.x, o.y, s.width, s.height);
+};
+
+
+/**
+ * Converts a CSS selector in the form style-property to styleProperty.
+ * @param {*} selector CSS Selector.
+ * @return {string} Camel case selector.
+ * @deprecated Use goog.string.toCamelCase instead.
+ */
+goog.style.toCamelCase = function(selector) {
+  return goog.string.toCamelCase(String(selector));
+};
+
+
+/**
+ * Converts a CSS selector in the form styleProperty to style-property.
+ * @param {string} selector Camel case selector.
+ * @return {string} Selector cased.
+ * @deprecated Use goog.string.toSelectorCase instead.
+ */
+goog.style.toSelectorCase = function(selector) {
+  return goog.string.toSelectorCase(selector);
+};
+
+
+/**
+ * Gets the opacity of a node (x-browser). This gets the inline style opacity
+ * of the node, and does not take into account the cascaded or the computed
+ * style for this node.
+ * @param {Element} el Element whose opacity has to be found.
+ * @return {number|string} Opacity between 0 and 1 or an empty string {@code ''}
+ *     if the opacity is not set.
+ */
+goog.style.getOpacity = function(el) {
+  var style = el.style;
+  var result = '';
+  if ('opacity' in style) {
+    result = style.opacity;
+  } else if ('MozOpacity' in style) {
+    result = style.MozOpacity;
+  } else if ('filter' in style) {
+    var match = style.filter.match(/alpha\(opacity=([\d.]+)\)/);
+    if (match) {
+      result = String(match[1] / 100);
+    }
+  }
+  return result == '' ? result : Number(result);
+};
+
+
+/**
+ * Sets the opacity of a node (x-browser).
+ * @param {Element} el Elements whose opacity has to be set.
+ * @param {number|string} alpha Opacity between 0 and 1 or an empty string
+ *     {@code ''} to clear the opacity.
+ */
+goog.style.setOpacity = function(el, alpha) {
+  var style = el.style;
+  if ('opacity' in style) {
+    style.opacity = alpha;
+  } else if ('MozOpacity' in style) {
+    style.MozOpacity = alpha;
+  } else if ('filter' in style) {
+    // TODO(arv): Overwriting the filter might have undesired side effects.
+    if (alpha === '') {
+      style.filter = '';
+    } else {
+      style.filter = 'alpha(opacity=' + alpha * 100 + ')';
+    }
+  }
+};
+
+
+/**
+ * Sets the background of an element to a transparent image in a browser-
+ * independent manner.
+ *
+ * This function does not support repeating backgrounds or alternate background
+ * positions to match the behavior of Internet Explorer. It also does not
+ * support sizingMethods other than crop since they cannot be replicated in
+ * browsers other than Internet Explorer.
+ *
+ * @param {Element} el The element to set background on.
+ * @param {string} src The image source URL.
+ */
+goog.style.setTransparentBackgroundImage = function(el, src) {
+  var style = el.style;
+  // It is safe to use the style.filter in IE only. In Safari 'filter' is in
+  // style object but access to style.filter causes it to throw an exception.
+  // Note: IE8 supports images with an alpha channel.
+  if (goog.userAgent.IE && !goog.userAgent.isVersionOrHigher('8')) {
+    // See TODO in setOpacity.
+    style.filter = 'progid:DXImageTransform.Microsoft.AlphaImageLoader(' +
+        'src="' + src + '", sizingMethod="crop")';
+  } else {
+    // Set style properties individually instead of using background shorthand
+    // to prevent overwriting a pre-existing background color.
+    style.backgroundImage = 'url(' + src + ')';
+    style.backgroundPosition = 'top left';
+    style.backgroundRepeat = 'no-repeat';
+  }
+};
+
+
+/**
+ * Clears the background image of an element in a browser independent manner.
+ * @param {Element} el The element to clear background image for.
+ */
+goog.style.clearTransparentBackgroundImage = function(el) {
+  var style = el.style;
+  if ('filter' in style) {
+    // See TODO in setOpacity.
+    style.filter = '';
+  } else {
+    // Set style properties individually instead of using background shorthand
+    // to prevent overwriting a pre-existing background color.
+    style.backgroundImage = 'none';
+  }
+};
+
+
+/**
+ * Shows or hides an element from the page. Hiding the element is done by
+ * setting the display property to "none", removing the element from the
+ * rendering hierarchy so it takes up no space. To show the element, the default
+ * inherited display property is restored (defined either in stylesheets or by
+ * the browser's default style rules.)
+ *
+ * Caveat 1: if the inherited display property for the element is set to "none"
+ * by the stylesheets, that is the property that will be restored by a call to
+ * showElement(), effectively toggling the display between "none" and "none".
+ *
+ * Caveat 2: if the element display style is set inline (by setting either
+ * element.style.display or a style attribute in the HTML), a call to
+ * showElement will clear that setting and defer to the inherited style in the
+ * stylesheet.
+ * @param {Element} el Element to show or hide.
+ * @param {*} display True to render the element in its default style,
+ *     false to disable rendering the element.
+ * @deprecated Use goog.style.setElementShown instead.
+ */
+goog.style.showElement = function(el, display) {
+  goog.style.setElementShown(el, display);
+};
+
+
+/**
+ * Shows or hides an element from the page. Hiding the element is done by
+ * setting the display property to "none", removing the element from the
+ * rendering hierarchy so it takes up no space. To show the element, the default
+ * inherited display property is restored (defined either in stylesheets or by
+ * the browser's default style rules).
+ *
+ * Caveat 1: if the inherited display property for the element is set to "none"
+ * by the stylesheets, that is the property that will be restored by a call to
+ * setElementShown(), effectively toggling the display between "none" and
+ * "none".
+ *
+ * Caveat 2: if the element display style is set inline (by setting either
+ * element.style.display or a style attribute in the HTML), a call to
+ * setElementShown will clear that setting and defer to the inherited style in
+ * the stylesheet.
+ * @param {Element} el Element to show or hide.
+ * @param {*} isShown True to render the element in its default style,
+ *     false to disable rendering the element.
+ */
+goog.style.setElementShown = function(el, isShown) {
+  el.style.display = isShown ? '' : 'none';
+};
+
+
+/**
+ * Test whether the given element has been shown or hidden via a call to
+ * {@link #setElementShown}.
+ *
+ * Note this is strictly a companion method for a call
+ * to {@link #setElementShown} and the same caveats apply; in particular, this
+ * method does not guarantee that the return value will be consistent with
+ * whether or not the element is actually visible.
+ *
+ * @param {Element} el The element to test.
+ * @return {boolean} Whether the element has been shown.
+ * @see #setElementShown
+ */
+goog.style.isElementShown = function(el) {
+  return el.style.display != 'none';
+};
+
+
+/**
+ * Installs the styles string into the window that contains opt_element.  If
+ * opt_element is null, the main window is used.
+ * @param {string} stylesString The style string to install.
+ * @param {Node=} opt_node Node whose parent document should have the
+ *     styles installed.
+ * @return {Element|StyleSheet} The style element created.
+ */
+goog.style.installStyles = function(stylesString, opt_node) {
+  var dh = goog.dom.getDomHelper(opt_node);
+  var styleSheet = null;
+
+  // IE < 11 requires createStyleSheet. Note that doc.createStyleSheet will be
+  // undefined as of IE 11.
+  var doc = dh.getDocument();
+  if (goog.userAgent.IE && doc.createStyleSheet) {
+    styleSheet = doc.createStyleSheet();
+    goog.style.setStyles(styleSheet, stylesString);
+  } else {
+    var head = dh.getElementsByTagNameAndClass(goog.dom.TagName.HEAD)[0];
+
+    // In opera documents are not guaranteed to have a head element, thus we
+    // have to make sure one exists before using it.
+    if (!head) {
+      var body = dh.getElementsByTagNameAndClass(goog.dom.TagName.BODY)[0];
+      head = dh.createDom(goog.dom.TagName.HEAD);
+      body.parentNode.insertBefore(head, body);
+    }
+    styleSheet = dh.createDom(goog.dom.TagName.STYLE);
+    // NOTE(user): Setting styles after the style element has been appended
+    // to the head results in a nasty Webkit bug in certain scenarios. Please
+    // refer to https://bugs.webkit.org/show_bug.cgi?id=26307 for additional
+    // details.
+    goog.style.setStyles(styleSheet, stylesString);
+    dh.appendChild(head, styleSheet);
+  }
+  return styleSheet;
+};
+
+
+/**
+ * Removes the styles added by {@link #installStyles}.
+ * @param {Element|StyleSheet} styleSheet The value returned by
+ *     {@link #installStyles}.
+ */
+goog.style.uninstallStyles = function(styleSheet) {
+  var node = styleSheet.ownerNode || styleSheet.owningElement ||
+      /** @type {Element} */ (styleSheet);
+  goog.dom.removeNode(node);
+};
+
+
+/**
+ * Sets the content of a style element.  The style element can be any valid
+ * style element.  This element will have its content completely replaced by
+ * the new stylesString.
+ * @param {Element|StyleSheet} element A stylesheet element as returned by
+ *     installStyles.
+ * @param {string} stylesString The new content of the stylesheet.
+ */
+goog.style.setStyles = function(element, stylesString) {
+  if (goog.userAgent.IE && goog.isDef(element.cssText)) {
+    // Adding the selectors individually caused the browser to hang if the
+    // selector was invalid or there were CSS comments.  Setting the cssText of
+    // the style node works fine and ignores CSS that IE doesn't understand.
+    // However IE >= 11 doesn't support cssText any more, so we make sure that
+    // cssText is a defined property and otherwise fall back to innerHTML.
+    element.cssText = stylesString;
+  } else {
+    element.innerHTML = stylesString;
+  }
+};
+
+
+/**
+ * Sets 'white-space: pre-wrap' for a node (x-browser).
+ *
+ * There are as many ways of specifying pre-wrap as there are browsers.
+ *
+ * CSS3/IE8: white-space: pre-wrap;
+ * Mozilla:  white-space: -moz-pre-wrap;
+ * Opera:    white-space: -o-pre-wrap;
+ * IE6/7:    white-space: pre; word-wrap: break-word;
+ *
+ * @param {Element} el Element to enable pre-wrap for.
+ */
+goog.style.setPreWrap = function(el) {
+  var style = el.style;
+  if (goog.userAgent.IE && !goog.userAgent.isVersionOrHigher('8')) {
+    style.whiteSpace = 'pre';
+    style.wordWrap = 'break-word';
+  } else if (goog.userAgent.GECKO) {
+    style.whiteSpace = '-moz-pre-wrap';
+  } else {
+    style.whiteSpace = 'pre-wrap';
+  }
+};
+
+
+/**
+ * Sets 'display: inline-block' for an element (cross-browser).
+ * @param {Element} el Element to which the inline-block display style is to be
+ *    applied.
+ * @see ../demos/inline_block_quirks.html
+ * @see ../demos/inline_block_standards.html
+ */
+goog.style.setInlineBlock = function(el) {
+  var style = el.style;
+  // Without position:relative, weirdness ensues.  Just accept it and move on.
+  style.position = 'relative';
+
+  if (goog.userAgent.IE && !goog.userAgent.isVersionOrHigher('8')) {
+    // IE8 supports inline-block so fall through to the else
+    // Zoom:1 forces hasLayout, display:inline gives inline behavior.
+    style.zoom = '1';
+    style.display = 'inline';
+  } else {
+    // Opera, Webkit, and Safari seem to do OK with the standard inline-block
+    // style.
+    style.display = 'inline-block';
+  }
+};
+
+
+/**
+ * Returns true if the element is using right to left (rtl) direction.
+ * @param {Element} el  The element to test.
+ * @return {boolean} True for right to left, false for left to right.
+ */
+goog.style.isRightToLeft = function(el) {
+  return 'rtl' == goog.style.getStyle_(el, 'direction');
+};
+
+
+/**
+ * The CSS style property corresponding to an element being
+ * unselectable on the current browser platform (null if none).
+ * Opera and IE instead use a DOM attribute 'unselectable'.
+ * @type {?string}
+ * @private
+ */
+goog.style.unselectableStyle_ =
+    goog.userAgent.GECKO ? 'MozUserSelect' :
+    goog.userAgent.WEBKIT ? 'WebkitUserSelect' :
+    null;
+
+
+/**
+ * Returns true if the element is set to be unselectable, false otherwise.
+ * Note that on some platforms (e.g. Mozilla), even if an element isn't set
+ * to be unselectable, it will behave as such if any of its ancestors is
+ * unselectable.
+ * @param {Element} el  Element to check.
+ * @return {boolean}  Whether the element is set to be unselectable.
+ */
+goog.style.isUnselectable = function(el) {
+  if (goog.style.unselectableStyle_) {
+    return el.style[goog.style.unselectableStyle_].toLowerCase() == 'none';
+  } else if (goog.userAgent.IE || goog.userAgent.OPERA) {
+    return el.getAttribute('unselectable') == 'on';
+  }
+  return false;
+};
+
+
+/**
+ * Makes the element and its descendants selectable or unselectable.  Note
+ * that on some platforms (e.g. Mozilla), even if an element isn't set to
+ * be unselectable, it will behave as such if any of its ancestors is
+ * unselectable.
+ * @param {Element} el  The element to alter.
+ * @param {boolean} unselectable  Whether the element and its descendants
+ *     should be made unselectable.
+ * @param {boolean=} opt_noRecurse  Whether to only alter the element's own
+ *     selectable state, and leave its descendants alone; defaults to false.
+ */
+goog.style.setUnselectable = function(el, unselectable, opt_noRecurse) {
+  // TODO(attila): Do we need all of TR_DomUtil.makeUnselectable() in Closure?
+  var descendants = !opt_noRecurse ? el.getElementsByTagName('*') : null;
+  var name = goog.style.unselectableStyle_;
+  if (name) {
+    // Add/remove the appropriate CSS style to/from the element and its
+    // descendants.
+    var value = unselectable ? 'none' : '';
+    // MathML elements do not have a style property. Verify before setting.
+    if (el.style) {
+      el.style[name] = value;
+    }
+    if (descendants) {
+      for (var i = 0, descendant; descendant = descendants[i]; i++) {
+        if (descendant.style) {
+          descendant.style[name] = value;
+        }
+      }
+    }
+  } else if (goog.userAgent.IE || goog.userAgent.OPERA) {
+    // Toggle the 'unselectable' attribute on the element and its descendants.
+    var value = unselectable ? 'on' : '';
+    el.setAttribute('unselectable', value);
+    if (descendants) {
+      for (var i = 0, descendant; descendant = descendants[i]; i++) {
+        descendant.setAttribute('unselectable', value);
+      }
+    }
+  }
+};
+
+
+/**
+ * Gets the border box size for an element.
+ * @param {Element} element  The element to get the size for.
+ * @return {!goog.math.Size} The border box size.
+ */
+goog.style.getBorderBoxSize = function(element) {
+  return new goog.math.Size(
+      /** @type {!HTMLElement} */ (element).offsetWidth,
+      /** @type {!HTMLElement} */ (element).offsetHeight);
+};
+
+
+/**
+ * Sets the border box size of an element. This is potentially expensive in IE
+ * if the document is CSS1Compat mode
+ * @param {Element} element  The element to set the size on.
+ * @param {goog.math.Size} size  The new size.
+ */
+goog.style.setBorderBoxSize = function(element, size) {
+  var doc = goog.dom.getOwnerDocument(element);
+  var isCss1CompatMode = goog.dom.getDomHelper(doc).isCss1CompatMode();
+
+  if (goog.userAgent.IE &&
+      !goog.userAgent.isVersionOrHigher('10') &&
+      (!isCss1CompatMode || !goog.userAgent.isVersionOrHigher('8'))) {
+    var style = element.style;
+    if (isCss1CompatMode) {
+      var paddingBox = goog.style.getPaddingBox(element);
+      var borderBox = goog.style.getBorderBox(element);
+      style.pixelWidth = size.width - borderBox.left - paddingBox.left -
+                         paddingBox.right - borderBox.right;
+      style.pixelHeight = size.height - borderBox.top - paddingBox.top -
+                          paddingBox.bottom - borderBox.bottom;
+    } else {
+      style.pixelWidth = size.width;
+      style.pixelHeight = size.height;
+    }
+  } else {
+    goog.style.setBoxSizingSize_(element, size, 'border-box');
+  }
+};
+
+
+/**
+ * Gets the content box size for an element.  This is potentially expensive in
+ * all browsers.
+ * @param {Element} element  The element to get the size for.
+ * @return {!goog.math.Size} The content box size.
+ */
+goog.style.getContentBoxSize = function(element) {
+  var doc = goog.dom.getOwnerDocument(element);
+  var ieCurrentStyle = goog.userAgent.IE && element.currentStyle;
+  if (ieCurrentStyle &&
+      goog.dom.getDomHelper(doc).isCss1CompatMode() &&
+      ieCurrentStyle.width != 'auto' && ieCurrentStyle.height != 'auto' &&
+      !ieCurrentStyle.boxSizing) {
+    // If IE in CSS1Compat mode than just use the width and height.
+    // If we have a boxSizing then fall back on measuring the borders etc.
+    var width = goog.style.getIePixelValue_(element, ieCurrentStyle.width,
+                                            'width', 'pixelWidth');
+    var height = goog.style.getIePixelValue_(element, ieCurrentStyle.height,
+                                             'height', 'pixelHeight');
+    return new goog.math.Size(width, height);
+  } else {
+    var borderBoxSize = goog.style.getBorderBoxSize(element);
+    var paddingBox = goog.style.getPaddingBox(element);
+    var borderBox = goog.style.getBorderBox(element);
+    return new goog.math.Size(borderBoxSize.width -
+                              borderBox.left - paddingBox.left -
+                              paddingBox.right - borderBox.right,
+                              borderBoxSize.height -
+                              borderBox.top - paddingBox.top -
+                              paddingBox.bottom - borderBox.bottom);
+  }
+};
+
+
+/**
+ * Sets the content box size of an element. This is potentially expensive in IE
+ * if the document is BackCompat mode.
+ * @param {Element} element  The element to set the size on.
+ * @param {goog.math.Size} size  The new size.
+ */
+goog.style.setContentBoxSize = function(element, size) {
+  var doc = goog.dom.getOwnerDocument(element);
+  var isCss1CompatMode = goog.dom.getDomHelper(doc).isCss1CompatMode();
+  if (goog.userAgent.IE &&
+      !goog.userAgent.isVersionOrHigher('10') &&
+      (!isCss1CompatMode || !goog.userAgent.isVersionOrHigher('8'))) {
+    var style = element.style;
+    if (isCss1CompatMode) {
+      style.pixelWidth = size.width;
+      style.pixelHeight = size.height;
+    } else {
+      var paddingBox = goog.style.getPaddingBox(element);
+      var borderBox = goog.style.getBorderBox(element);
+      style.pixelWidth = size.width + borderBox.left + paddingBox.left +
+                         paddingBox.right + borderBox.right;
+      style.pixelHeight = size.height + borderBox.top + paddingBox.top +
+                          paddingBox.bottom + borderBox.bottom;
+    }
+  } else {
+    goog.style.setBoxSizingSize_(element, size, 'content-box');
+  }
+};
+
+
+/**
+ * Helper function that sets the box sizing as well as the width and height
+ * @param {Element} element  The element to set the size on.
+ * @param {goog.math.Size} size  The new size to set.
+ * @param {string} boxSizing  The box-sizing value.
+ * @private
+ */
+goog.style.setBoxSizingSize_ = function(element, size, boxSizing) {
+  var style = element.style;
+  if (goog.userAgent.GECKO) {
+    style.MozBoxSizing = boxSizing;
+  } else if (goog.userAgent.WEBKIT) {
+    style.WebkitBoxSizing = boxSizing;
+  } else {
+    // Includes IE8 and Opera 9.50+
+    style.boxSizing = boxSizing;
+  }
+
+  // Setting this to a negative value will throw an exception on IE
+  // (and doesn't do anything different than setting it to 0).
+  style.width = Math.max(size.width, 0) + 'px';
+  style.height = Math.max(size.height, 0) + 'px';
+};
+
+
+/**
+ * IE specific function that converts a non pixel unit to pixels.
+ * @param {Element} element  The element to convert the value for.
+ * @param {string} value  The current value as a string. The value must not be
+ *     ''.
+ * @param {string} name  The CSS property name to use for the converstion. This
+ *     should be 'left', 'top', 'width' or 'height'.
+ * @param {string} pixelName  The CSS pixel property name to use to get the
+ *     value in pixels.
+ * @return {number} The value in pixels.
+ * @private
+ */
+goog.style.getIePixelValue_ = function(element, value, name, pixelName) {
+  // Try if we already have a pixel value. IE does not do half pixels so we
+  // only check if it matches a number followed by 'px'.
+  if (/^\d+px?$/.test(value)) {
+    return parseInt(value, 10);
+  } else {
+    var oldStyleValue = element.style[name];
+    var oldRuntimeValue = element.runtimeStyle[name];
+    // set runtime style to prevent changes
+    element.runtimeStyle[name] = element.currentStyle[name];
+    element.style[name] = value;
+    var pixelValue = element.style[pixelName];
+    // restore
+    element.style[name] = oldStyleValue;
+    element.runtimeStyle[name] = oldRuntimeValue;
+    return pixelValue;
+  }
+};
+
+
+/**
+ * Helper function for getting the pixel padding or margin for IE.
+ * @param {Element} element  The element to get the padding for.
+ * @param {string} propName  The property name.
+ * @return {number} The pixel padding.
+ * @private
+ */
+goog.style.getIePixelDistance_ = function(element, propName) {
+  var value = goog.style.getCascadedStyle(element, propName);
+  return value ?
+      goog.style.getIePixelValue_(element, value, 'left', 'pixelLeft') : 0;
+};
+
+
+/**
+ * Gets the computed paddings or margins (on all sides) in pixels.
+ * @param {Element} element  The element to get the padding for.
+ * @param {string} stylePrefix  Pass 'padding' to retrieve the padding box,
+ *     or 'margin' to retrieve the margin box.
+ * @return {!goog.math.Box} The computed paddings or margins.
+ * @private
+ */
+goog.style.getBox_ = function(element, stylePrefix) {
+  if (goog.userAgent.IE) {
+    var left = goog.style.getIePixelDistance_(element, stylePrefix + 'Left');
+    var right = goog.style.getIePixelDistance_(element, stylePrefix + 'Right');
+    var top = goog.style.getIePixelDistance_(element, stylePrefix + 'Top');
+    var bottom = goog.style.getIePixelDistance_(
+        element, stylePrefix + 'Bottom');
+    return new goog.math.Box(top, right, bottom, left);
+  } else {
+    // On non-IE browsers, getComputedStyle is always non-null.
+    var left = goog.style.getComputedStyle(element, stylePrefix + 'Left');
+    var right = goog.style.getComputedStyle(element, stylePrefix + 'Right');
+    var top = goog.style.getComputedStyle(element, stylePrefix + 'Top');
+    var bottom = goog.style.getComputedStyle(element, stylePrefix + 'Bottom');
+
+    // NOTE(arv): Gecko can return floating point numbers for the computed
+    // style values.
+    return new goog.math.Box(parseFloat(top),
+                             parseFloat(right),
+                             parseFloat(bottom),
+                             parseFloat(left));
+  }
+};
+
+
+/**
+ * Gets the computed paddings (on all sides) in pixels.
+ * @param {Element} element  The element to get the padding for.
+ * @return {!goog.math.Box} The computed paddings.
+ */
+goog.style.getPaddingBox = function(element) {
+  return goog.style.getBox_(element, 'padding');
+};
+
+
+/**
+ * Gets the computed margins (on all sides) in pixels.
+ * @param {Element} element  The element to get the margins for.
+ * @return {!goog.math.Box} The computed margins.
+ */
+goog.style.getMarginBox = function(element) {
+  return goog.style.getBox_(element, 'margin');
+};
+
+
+/**
+ * A map used to map the border width keywords to a pixel width.
+ * @type {Object}
+ * @private
+ */
+goog.style.ieBorderWidthKeywords_ = {
+  'thin': 2,
+  'medium': 4,
+  'thick': 6
+};
+
+
+/**
+ * Helper function for IE to get the pixel border.
+ * @param {Element} element  The element to get the pixel border for.
+ * @param {string} prop  The part of the property name.
+ * @return {number} The value in pixels.
+ * @private
+ */
+goog.style.getIePixelBorder_ = function(element, prop) {
+  if (goog.style.getCascadedStyle(element, prop + 'Style') == 'none') {
+    return 0;
+  }
+  var width = goog.style.getCascadedStyle(element, prop + 'Width');
+  if (width in goog.style.ieBorderWidthKeywords_) {
+    return goog.style.ieBorderWidthKeywords_[width];
+  }
+  return goog.style.getIePixelValue_(element, width, 'left', 'pixelLeft');
+};
+
+
+/**
+ * Gets the computed border widths (on all sides) in pixels
+ * @param {Element} element  The element to get the border widths for.
+ * @return {!goog.math.Box} The computed border widths.
+ */
+goog.style.getBorderBox = function(element) {
+  if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9)) {
+    var left = goog.style.getIePixelBorder_(element, 'borderLeft');
+    var right = goog.style.getIePixelBorder_(element, 'borderRight');
+    var top = goog.style.getIePixelBorder_(element, 'borderTop');
+    var bottom = goog.style.getIePixelBorder_(element, 'borderBottom');
+    return new goog.math.Box(top, right, bottom, left);
+  } else {
+    // On non-IE browsers, getComputedStyle is always non-null.
+    var left = goog.style.getComputedStyle(element, 'borderLeftWidth');
+    var right = goog.style.getComputedStyle(element, 'borderRightWidth');
+    var top = goog.style.getComputedStyle(element, 'borderTopWidth');
+    var bottom = goog.style.getComputedStyle(element, 'borderBottomWidth');
+
+    return new goog.math.Box(parseFloat(top),
+                             parseFloat(right),
+                             parseFloat(bottom),
+                             parseFloat(left));
+  }
+};
+
+
+/**
+ * Returns the font face applied to a given node. Opera and IE should return
+ * the font actually displayed. Firefox returns the author's most-preferred
+ * font (whether the browser is capable of displaying it or not.)
+ * @param {Element} el  The element whose font family is returned.
+ * @return {string} The font family applied to el.
+ */
+goog.style.getFontFamily = function(el) {
+  var doc = goog.dom.getOwnerDocument(el);
+  var font = '';
+  // The moveToElementText method from the TextRange only works if the element
+  // is attached to the owner document.
+  if (doc.body.createTextRange && goog.dom.contains(doc, el)) {
+    var range = doc.body.createTextRange();
+    range.moveToElementText(el);
+    /** @preserveTry */
+    try {
+      font = range.queryCommandValue('FontName');
+    } catch (e) {
+      // This is a workaround for a awkward exception.
+      // On some IE, there is an exception coming from it.
+      // The error description from this exception is:
+      // This window has already been registered as a drop target
+      // This is bogus description, likely due to a bug in ie.
+      font = '';
+    }
+  }
+  if (!font) {
+    // Note if for some reason IE can't derive FontName with a TextRange, we
+    // fallback to using currentStyle
+    font = goog.style.getStyle_(el, 'fontFamily');
+  }
+
+  // Firefox returns the applied font-family string (author's list of
+  // preferred fonts.) We want to return the most-preferred font, in lieu of
+  // the *actually* applied font.
+  var fontsArray = font.split(',');
+  if (fontsArray.length > 1) font = fontsArray[0];
+
+  // Sanitize for x-browser consistency:
+  // Strip quotes because browsers aren't consistent with how they're
+  // applied; Opera always encloses, Firefox sometimes, and IE never.
+  return goog.string.stripQuotes(font, '"\'');
+};
+
+
+/**
+ * Regular expression used for getLengthUnits.
+ * @type {RegExp}
+ * @private
+ */
+goog.style.lengthUnitRegex_ = /[^\d]+$/;
+
+
+/**
+ * Returns the units used for a CSS length measurement.
+ * @param {string} value  A CSS length quantity.
+ * @return {?string} The units of measurement.
+ */
+goog.style.getLengthUnits = function(value) {
+  var units = value.match(goog.style.lengthUnitRegex_);
+  return units && units[0] || null;
+};
+
+
+/**
+ * Map of absolute CSS length units
+ * @type {Object}
+ * @private
+ */
+goog.style.ABSOLUTE_CSS_LENGTH_UNITS_ = {
+  'cm' : 1,
+  'in' : 1,
+  'mm' : 1,
+  'pc' : 1,
+  'pt' : 1
+};
+
+
+/**
+ * Map of relative CSS length units that can be accurately converted to px
+ * font-size values using getIePixelValue_. Only units that are defined in
+ * relation to a font size are convertible (%, small, etc. are not).
+ * @type {Object}
+ * @private
+ */
+goog.style.CONVERTIBLE_RELATIVE_CSS_UNITS_ = {
+  'em' : 1,
+  'ex' : 1
+};
+
+
+/**
+ * Returns the font size, in pixels, of text in an element.
+ * @param {Element} el  The element whose font size is returned.
+ * @return {number} The font size (in pixels).
+ */
+goog.style.getFontSize = function(el) {
+  var fontSize = goog.style.getStyle_(el, 'fontSize');
+  var sizeUnits = goog.style.getLengthUnits(fontSize);
+  if (fontSize && 'px' == sizeUnits) {
+    // NOTE(user): This could be parseFloat instead, but IE doesn't return
+    // decimal fractions in getStyle_ and Firefox reports the fractions, but
+    // ignores them when rendering. Interestingly enough, when we force the
+    // issue and size something to e.g., 50% of 25px, the browsers round in
+    // opposite directions with Firefox reporting 12px and IE 13px. I punt.
+    return parseInt(fontSize, 10);
+  }
+
+  // In IE, we can convert absolute length units to a px value using
+  // goog.style.getIePixelValue_. Units defined in relation to a font size
+  // (em, ex) are applied relative to the element's parentNode and can also
+  // be converted.
+  if (goog.userAgent.IE) {
+    if (sizeUnits in goog.style.ABSOLUTE_CSS_LENGTH_UNITS_) {
+      return goog.style.getIePixelValue_(el,
+                                         fontSize,
+                                         'left',
+                                         'pixelLeft');
+    } else if (el.parentNode &&
+               el.parentNode.nodeType == goog.dom.NodeType.ELEMENT &&
+               sizeUnits in goog.style.CONVERTIBLE_RELATIVE_CSS_UNITS_) {
+      // Check the parent size - if it is the same it means the relative size
+      // value is inherited and we therefore don't want to count it twice.  If
+      // it is different, this element either has explicit style or has a CSS
+      // rule applying to it.
+      var parentElement = /** @type {!Element} */ (el.parentNode);
+      var parentSize = goog.style.getStyle_(parentElement, 'fontSize');
+      return goog.style.getIePixelValue_(parentElement,
+                                         fontSize == parentSize ?
+                                             '1em' : fontSize,
+                                         'left',
+                                         'pixelLeft');
+    }
+  }
+
+  // Sometimes we can't cleanly find the font size (some units relative to a
+  // node's parent's font size are difficult: %, smaller et al), so we create
+  // an invisible, absolutely-positioned span sized to be the height of an 'M'
+  // rendered in its parent's (i.e., our target element's) font size. This is
+  // the definition of CSS's font size attribute.
+  var sizeElement = goog.dom.createDom(
+      goog.dom.TagName.SPAN,
+      {'style': 'visibility:hidden;position:absolute;' +
+            'line-height:0;padding:0;margin:0;border:0;height:1em;'});
+  goog.dom.appendChild(el, sizeElement);
+  fontSize = sizeElement.offsetHeight;
+  goog.dom.removeNode(sizeElement);
+
+  return fontSize;
+};
+
+
+/**
+ * Parses a style attribute value.  Converts CSS property names to camel case.
+ * @param {string} value The style attribute value.
+ * @return {!Object} Map of CSS properties to string values.
+ */
+goog.style.parseStyleAttribute = function(value) {
+  var result = {};
+  goog.array.forEach(value.split(/\s*;\s*/), function(pair) {
+    var keyValue = pair.match(/\s*([\w-]+)\s*\:(.+)/);
+    if (keyValue) {
+      var styleName = keyValue[1];
+      var styleValue = goog.string.trim(keyValue[2]);
+      result[goog.string.toCamelCase(styleName.toLowerCase())] = styleValue;
+    }
+  });
+  return result;
+};
+
+
+/**
+ * Reverse of parseStyleAttribute; that is, takes a style object and returns the
+ * corresponding attribute value.  Converts camel case property names to proper
+ * CSS selector names.
+ * @param {Object} obj Map of CSS properties to values.
+ * @return {string} The style attribute value.
+ */
+goog.style.toStyleAttribute = function(obj) {
+  var buffer = [];
+  goog.object.forEach(obj, function(value, key) {
+    buffer.push(goog.string.toSelectorCase(key), ':', value, ';');
+  });
+  return buffer.join('');
+};
+
+
+/**
+ * Sets CSS float property on an element.
+ * @param {Element} el The element to set float property on.
+ * @param {string} value The value of float CSS property to set on this element.
+ */
+goog.style.setFloat = function(el, value) {
+  el.style[goog.userAgent.IE ? 'styleFloat' : 'cssFloat'] = value;
+};
+
+
+/**
+ * Gets value of explicitly-set float CSS property on an element.
+ * @param {Element} el The element to get float property of.
+ * @return {string} The value of explicitly-set float CSS property on this
+ *     element.
+ */
+goog.style.getFloat = function(el) {
+  return el.style[goog.userAgent.IE ? 'styleFloat' : 'cssFloat'] || '';
+};
+
+
+/**
+ * Returns the scroll bar width (represents the width of both horizontal
+ * and vertical scroll).
+ *
+ * @param {string=} opt_className An optional class name (or names) to apply
+ *     to the invisible div created to measure the scrollbar. This is necessary
+ *     if some scrollbars are styled differently than others.
+ * @return {number} The scroll bar width in px.
+ */
+goog.style.getScrollbarWidth = function(opt_className) {
+  // Add two hidden divs.  The child div is larger than the parent and
+  // forces scrollbars to appear on it.
+  // Using overflow:scroll does not work consistently with scrollbars that
+  // are styled with ::-webkit-scrollbar.
+  var outerDiv = goog.dom.createElement(goog.dom.TagName.DIV);
+  if (opt_className) {
+    outerDiv.className = opt_className;
+  }
+  outerDiv.style.cssText = 'overflow:auto;' +
+      'position:absolute;top:0;width:100px;height:100px';
+  var innerDiv = goog.dom.createElement(goog.dom.TagName.DIV);
+  goog.style.setSize(innerDiv, '200px', '200px');
+  outerDiv.appendChild(innerDiv);
+  goog.dom.appendChild(goog.dom.getDocument().body, outerDiv);
+  var width = outerDiv.offsetWidth - outerDiv.clientWidth;
+  goog.dom.removeNode(outerDiv);
+  return width;
+};
+
+
+/**
+ * Regular expression to extract x and y translation components from a CSS
+ * transform Matrix representation.
+ *
+ * @type {!RegExp}
+ * @const
+ * @private
+ */
+goog.style.MATRIX_TRANSLATION_REGEX_ =
+    new RegExp('matrix\\([0-9\\.\\-]+, [0-9\\.\\-]+, ' +
+               '[0-9\\.\\-]+, [0-9\\.\\-]+, ' +
+               '([0-9\\.\\-]+)p?x?, ([0-9\\.\\-]+)p?x?\\)');
+
+
+/**
+ * Returns the x,y translation component of any CSS transforms applied to the
+ * element, in pixels.
+ *
+ * @param {!Element} element The element to get the translation of.
+ * @return {!goog.math.Coordinate} The CSS translation of the element in px.
+ */
+goog.style.getCssTranslation = function(element) {
+  var transform = goog.style.getComputedTransform(element);
+  if (!transform) {
+    return new goog.math.Coordinate(0, 0);
+  }
+  var matches = transform.match(goog.style.MATRIX_TRANSLATION_REGEX_);
+  if (!matches) {
+    return new goog.math.Coordinate(0, 0);
+  }
+  return new goog.math.Coordinate(parseFloat(matches[1]),
+                                  parseFloat(matches[2]));
+};
diff --git a/lib/goog/testing/asserts.js b/lib/goog/testing/asserts.js
new file mode 100644
index 0000000..f1e8323
--- /dev/null
+++ b/lib/goog/testing/asserts.js
@@ -0,0 +1,1278 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+goog.provide('goog.testing.JsUnitException');
+goog.provide('goog.testing.asserts');
+goog.provide('goog.testing.asserts.ArrayLike');
+
+goog.require('goog.testing.stacktrace');
+
+// TODO(user): Copied from JsUnit with some small modifications, we should
+// reimplement the asserters.
+
+
+/**
+ * @typedef {Array|NodeList|Arguments|{length: number}}
+ */
+goog.testing.asserts.ArrayLike;
+
+var DOUBLE_EQUALITY_PREDICATE = function(var1, var2) {
+  return var1 == var2;
+};
+var JSUNIT_UNDEFINED_VALUE = void 0;
+var TO_STRING_EQUALITY_PREDICATE = function(var1, var2) {
+  return var1.toString() === var2.toString();
+};
+
+/** @typedef {function(?, ?):boolean} */
+var PredicateFunctionType;
+
+/**
+ * @const {{
+ *   String : PredicateFunctionType,
+ *   Number : PredicateFunctionType,
+ *   Boolean : PredicateFunctionType,
+ *   Date : PredicateFunctionType,
+ *   RegExp : PredicateFunctionType,
+ *   Function : PredicateFunctionType
+ * }}
+ */
+var PRIMITIVE_EQUALITY_PREDICATES = {
+  'String': DOUBLE_EQUALITY_PREDICATE,
+  'Number': DOUBLE_EQUALITY_PREDICATE,
+  'Boolean': DOUBLE_EQUALITY_PREDICATE,
+  'Date': function(date1, date2) {
+    return date1.getTime() == date2.getTime();
+  },
+  'RegExp': TO_STRING_EQUALITY_PREDICATE,
+  'Function': TO_STRING_EQUALITY_PREDICATE
+};
+
+
+/**
+ * Compares equality of two numbers, allowing them to differ up to a given
+ * tolerance.
+ * @param {number} var1 A number.
+ * @param {number} var2 A number.
+ * @param {number} tolerance the maximum allowed difference.
+ * @return {boolean} Whether the two variables are sufficiently close.
+ * @private
+ */
+goog.testing.asserts.numberRoughEqualityPredicate_ = function(
+    var1, var2, tolerance) {
+  return Math.abs(var1 - var2) <= tolerance;
+};
+
+
+/**
+ * @type {Object<string, function(*, *, number): boolean>}
+ * @private
+ */
+goog.testing.asserts.primitiveRoughEqualityPredicates_ = {
+  'Number': goog.testing.asserts.numberRoughEqualityPredicate_
+};
+
+
+var _trueTypeOf = function(something) {
+  var result = typeof something;
+  try {
+    switch (result) {
+      case 'string':
+        break;
+      case 'boolean':
+        break;
+      case 'number':
+        break;
+      case 'object':
+        if (something == null) {
+          result = 'null';
+          break;
+        }
+      case 'function':
+        switch (something.constructor) {
+          case new String('').constructor:
+            result = 'String';
+            break;
+          case new Boolean(true).constructor:
+            result = 'Boolean';
+            break;
+          case new Number(0).constructor:
+            result = 'Number';
+            break;
+          case new Array().constructor:
+            result = 'Array';
+            break;
+          case new RegExp().constructor:
+            result = 'RegExp';
+            break;
+          case new Date().constructor:
+            result = 'Date';
+            break;
+          case Function:
+            result = 'Function';
+            break;
+          default:
+            var m = something.constructor.toString().match(
+                /function\s*([^( ]+)\(/);
+            if (m) {
+              result = m[1];
+            } else {
+              break;
+            }
+        }
+        break;
+    }
+  } catch (e) {
+
+  } finally {
+    result = result.substr(0, 1).toUpperCase() + result.substr(1);
+  }
+  return result;
+};
+
+var _displayStringForValue = function(aVar) {
+  var result;
+  try {
+    result = '<' + String(aVar) + '>';
+  } catch (ex) {
+    result = '<toString failed: ' + ex.message + '>';
+    // toString does not work on this object :-(
+  }
+  if (!(aVar === null || aVar === JSUNIT_UNDEFINED_VALUE)) {
+    result += ' (' + _trueTypeOf(aVar) + ')';
+  }
+  return result;
+};
+
+var fail = function(failureMessage) {
+  goog.testing.asserts.raiseException('Call to fail()', failureMessage);
+};
+
+var argumentsIncludeComments = function(expectedNumberOfNonCommentArgs, args) {
+  return args.length == expectedNumberOfNonCommentArgs + 1;
+};
+
+var commentArg = function(expectedNumberOfNonCommentArgs, args) {
+  if (argumentsIncludeComments(expectedNumberOfNonCommentArgs, args)) {
+    return args[0];
+  }
+
+  return null;
+};
+
+var nonCommentArg = function(desiredNonCommentArgIndex,
+    expectedNumberOfNonCommentArgs, args) {
+  return argumentsIncludeComments(expectedNumberOfNonCommentArgs, args) ?
+      args[desiredNonCommentArgIndex] :
+      args[desiredNonCommentArgIndex - 1];
+};
+
+var _validateArguments = function(expectedNumberOfNonCommentArgs, args) {
+  var valid = args.length == expectedNumberOfNonCommentArgs ||
+      args.length == expectedNumberOfNonCommentArgs + 1 &&
+      goog.isString(args[0]);
+  _assert(null, valid, 'Incorrect arguments passed to assert function');
+};
+
+var _assert = function(comment, booleanValue, failureMessage) {
+  if (!booleanValue) {
+    goog.testing.asserts.raiseException(comment, failureMessage);
+  }
+};
+
+
+/**
+ * @param {*} expected The expected value.
+ * @param {*} actual The actual value.
+ * @return {string} A failure message of the values don't match.
+ * @private
+ */
+goog.testing.asserts.getDefaultErrorMsg_ = function(expected, actual) {
+  var msg = 'Expected ' + _displayStringForValue(expected) + ' but was ' +
+      _displayStringForValue(actual);
+  if ((typeof expected == 'string') && (typeof actual == 'string')) {
+    // Try to find a human-readable difference.
+    var limit = Math.min(expected.length, actual.length);
+    var commonPrefix = 0;
+    while (commonPrefix < limit &&
+        expected.charAt(commonPrefix) == actual.charAt(commonPrefix)) {
+      commonPrefix++;
+    }
+
+    var commonSuffix = 0;
+    while (commonSuffix < limit &&
+        expected.charAt(expected.length - commonSuffix - 1) ==
+            actual.charAt(actual.length - commonSuffix - 1)) {
+      commonSuffix++;
+    }
+
+    if (commonPrefix + commonSuffix > limit) {
+      commonSuffix = 0;
+    }
+
+    if (commonPrefix > 2 || commonSuffix > 2) {
+      var printString = function(str) {
+        var startIndex = Math.max(0, commonPrefix - 2);
+        var endIndex = Math.min(str.length, str.length - (commonSuffix - 2));
+        return (startIndex > 0 ? '...' : '') +
+            str.substring(startIndex, endIndex) +
+            (endIndex < str.length ? '...' : '');
+      };
+
+      msg += '\nDifference was at position ' + commonPrefix +
+          '. Expected [' + printString(expected) +
+          '] vs. actual [' + printString(actual) + ']';
+    }
+  }
+  return msg;
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assert = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var comment = commentArg(1, arguments);
+  var booleanValue = nonCommentArg(1, 1, arguments);
+
+  _assert(comment, goog.isBoolean(booleanValue),
+      'Bad argument to assert(boolean)');
+  _assert(comment, booleanValue, 'Call to assert(boolean) with false');
+};
+
+
+/**
+ * Asserts that the function throws an error.
+ *
+ * @param {!(string|Function)} a The assertion comment or the function to call.
+ * @param {!Function=} opt_b The function to call (if the first argument of
+ *     {@code assertThrows} was the comment).
+ * @return {*} The error thrown by the function.
+ * @throws {goog.testing.JsUnitException} If the assertion failed.
+ */
+var assertThrows = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var func = nonCommentArg(1, 1, arguments);
+  var comment = commentArg(1, arguments);
+  _assert(comment, typeof func == 'function',
+      'Argument passed to assertThrows is not a function');
+
+  try {
+    func();
+  } catch (e) {
+    if (e && goog.isString(e['stacktrace']) && goog.isString(e['message'])) {
+      // Remove the stack trace appended to the error message by Opera 10.0
+      var startIndex = e['message'].length - e['stacktrace'].length;
+      if (e['message'].indexOf(e['stacktrace'], startIndex) == startIndex) {
+        e['message'] = e['message'].substr(0, startIndex - 14);
+      }
+    }
+    return e;
+  }
+  goog.testing.asserts.raiseException(comment,
+      'No exception thrown from function passed to assertThrows');
+};
+
+
+/**
+ * Asserts that the function does not throw an error.
+ *
+ * @param {!(string|Function)} a The assertion comment or the function to call.
+ * @param {!Function=} opt_b The function to call (if the first argument of
+ *     {@code assertNotThrows} was the comment).
+ * @return {*} The return value of the function.
+ * @throws {goog.testing.JsUnitException} If the assertion failed.
+ */
+var assertNotThrows = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var comment = commentArg(1, arguments);
+  var func = nonCommentArg(1, 1, arguments);
+  _assert(comment, typeof func == 'function',
+      'Argument passed to assertNotThrows is not a function');
+
+  try {
+    return func();
+  } catch (e) {
+    comment = comment ? (comment + '\n') : '';
+    comment += 'A non expected exception was thrown from function passed to ' +
+               'assertNotThrows';
+    // Some browsers don't have a stack trace so at least have the error
+    // description.
+    var stackTrace = e['stack'] || e['stacktrace'] || e.toString();
+    goog.testing.asserts.raiseException(comment, stackTrace);
+  }
+};
+
+
+/**
+ * Asserts that the given callback function results in a JsUnitException when
+ * called, and that the resulting failure message matches the given expected
+ * message.
+ * @param {function() : void} callback Function to be run expected to result
+ *     in a JsUnitException (usually contains a call to an assert).
+ * @param {string=} opt_expectedMessage Failure message expected to be given
+ *     with the exception.
+ */
+var assertThrowsJsUnitException = function(callback, opt_expectedMessage) {
+  var failed = false;
+  try {
+    goog.testing.asserts.callWithoutLogging(callback);
+  } catch (ex) {
+    if (!ex.isJsUnitException) {
+      fail('Expected a JsUnitException');
+    }
+    if (typeof opt_expectedMessage != 'undefined' &&
+        ex.message != opt_expectedMessage) {
+      fail('Expected message [' + opt_expectedMessage + '] but got [' +
+          ex.message + ']');
+    }
+    failed = true;
+  }
+  if (!failed) {
+    fail('Expected a failure: ' + opt_expectedMessage);
+  }
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertTrue = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var comment = commentArg(1, arguments);
+  var booleanValue = nonCommentArg(1, 1, arguments);
+
+  _assert(comment, goog.isBoolean(booleanValue),
+      'Bad argument to assertTrue(boolean)');
+  _assert(comment, booleanValue, 'Call to assertTrue(boolean) with false');
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertFalse = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var comment = commentArg(1, arguments);
+  var booleanValue = nonCommentArg(1, 1, arguments);
+
+  _assert(comment, goog.isBoolean(booleanValue),
+      'Bad argument to assertFalse(boolean)');
+  _assert(comment, !booleanValue, 'Call to assertFalse(boolean) with true');
+};
+
+
+/**
+ * @param {*} a The expected value (2 args) or the debug message (3 args).
+ * @param {*} b The actual value (2 args) or the expected value (3 args).
+ * @param {*=} opt_c The actual value (3 args only).
+ */
+var assertEquals = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var var1 = nonCommentArg(1, 2, arguments);
+  var var2 = nonCommentArg(2, 2, arguments);
+  _assert(commentArg(2, arguments), var1 === var2,
+          goog.testing.asserts.getDefaultErrorMsg_(var1, var2));
+};
+
+
+/**
+ * @param {*} a The expected value (2 args) or the debug message (3 args).
+ * @param {*} b The actual value (2 args) or the expected value (3 args).
+ * @param {*=} opt_c The actual value (3 args only).
+ */
+var assertNotEquals = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var var1 = nonCommentArg(1, 2, arguments);
+  var var2 = nonCommentArg(2, 2, arguments);
+  _assert(commentArg(2, arguments), var1 !== var2,
+      'Expected not to be ' + _displayStringForValue(var2));
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertNull = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var aVar = nonCommentArg(1, 1, arguments);
+  _assert(commentArg(1, arguments), aVar === null,
+      goog.testing.asserts.getDefaultErrorMsg_(null, aVar));
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertNotNull = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var aVar = nonCommentArg(1, 1, arguments);
+  _assert(commentArg(1, arguments), aVar !== null,
+      'Expected not to be ' + _displayStringForValue(null));
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertUndefined = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var aVar = nonCommentArg(1, 1, arguments);
+  _assert(commentArg(1, arguments), aVar === JSUNIT_UNDEFINED_VALUE,
+      goog.testing.asserts.getDefaultErrorMsg_(JSUNIT_UNDEFINED_VALUE, aVar));
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertNotUndefined = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var aVar = nonCommentArg(1, 1, arguments);
+  _assert(commentArg(1, arguments), aVar !== JSUNIT_UNDEFINED_VALUE,
+      'Expected not to be ' + _displayStringForValue(JSUNIT_UNDEFINED_VALUE));
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertNotNullNorUndefined = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  assertNotNull.apply(null, arguments);
+  assertNotUndefined.apply(null, arguments);
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertNonEmptyString = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var aVar = nonCommentArg(1, 1, arguments);
+  _assert(commentArg(1, arguments),
+      aVar !== JSUNIT_UNDEFINED_VALUE && aVar !== null &&
+      typeof aVar == 'string' && aVar !== '',
+      'Expected non-empty string but was ' + _displayStringForValue(aVar));
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertNaN = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var aVar = nonCommentArg(1, 1, arguments);
+  _assert(commentArg(1, arguments), isNaN(aVar), 'Expected NaN');
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertNotNaN = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var aVar = nonCommentArg(1, 1, arguments);
+  _assert(commentArg(1, arguments), !isNaN(aVar), 'Expected not NaN');
+};
+
+
+/**
+ * Runs a function in an environment where test failures are not logged. This is
+ * useful for testing test code, where failures can be a normal part of a test.
+ * @param {function() : void} fn Function to run without logging failures.
+ */
+goog.testing.asserts.callWithoutLogging = function(fn) {
+  var testRunner = goog.global['G_testRunner'];
+  var oldLogTestFailure = testRunner['logTestFailure'];
+  try {
+    // Any failures in the callback shouldn't be recorded.
+    testRunner['logTestFailure'] = undefined;
+    fn();
+  } finally {
+    testRunner['logTestFailure'] = oldLogTestFailure;
+  }
+};
+
+
+/**
+ * The return value of the equality predicate passed to findDifferences below,
+ * in cases where the predicate can't test the input variables for equality.
+ * @type {?string}
+ */
+goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS = null;
+
+
+/**
+ * The return value of the equality predicate passed to findDifferences below,
+ * in cases where the input vriables are equal.
+ * @type {?string}
+ */
+goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL = '';
+
+
+/**
+ * Determines if two items of any type match, and formulates an error message
+ * if not.
+ * @param {*} expected Expected argument to match.
+ * @param {*} actual Argument as a result of performing the test.
+ * @param {(function(string, *, *): ?string)=} opt_equalityPredicate An optional
+ *     function that can be used to check equality of variables. It accepts 3
+ *     arguments: type-of-variables, var1, var2 (in that order) and returns an
+ *     error message if the variables are not equal,
+ *     goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL if the variables
+ *     are equal, or
+ *     goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS if the predicate
+ *     couldn't check the input variables. The function will be called only if
+ *     the types of var1 and var2 are identical.
+ * @return {?string} Null on success, error message on failure.
+ */
+goog.testing.asserts.findDifferences = function(expected, actual,
+    opt_equalityPredicate) {
+  var failures = [];
+  var seen1 = [];
+  var seen2 = [];
+
+  // To avoid infinite recursion when the two parameters are self-referential
+  // along the same path of properties, keep track of the object pairs already
+  // seen in this call subtree, and abort when a cycle is detected.
+  function innerAssertWithCycleCheck(var1, var2, path) {
+    // This is used for testing, so we can afford to be slow (but more
+    // accurate). So we just check whether var1 is in seen1. If we
+    // found var1 in index i, we simply need to check whether var2 is
+    // in seen2[i]. If it is, we do not recurse to check var1/var2. If
+    // it isn't, we know that the structures of the two objects must be
+    // different.
+    //
+    // This is based on the fact that values at index i in seen1 and
+    // seen2 will be checked for equality eventually (when
+    // innerAssertImplementation(seen1[i], seen2[i], path) finishes).
+    for (var i = 0; i < seen1.length; ++i) {
+      var match1 = seen1[i] === var1;
+      var match2 = seen2[i] === var2;
+      if (match1 || match2) {
+        if (!match1 || !match2) {
+          // Asymmetric cycles, so the objects have different structure.
+          failures.push('Asymmetric cycle detected at ' + path);
+        }
+        return;
+      }
+    }
+
+    seen1.push(var1);
+    seen2.push(var2);
+    innerAssertImplementation(var1, var2, path);
+    seen1.pop();
+    seen2.pop();
+  }
+
+  var equalityPredicate = opt_equalityPredicate || function(type, var1, var2) {
+    var typedPredicate = PRIMITIVE_EQUALITY_PREDICATES[type];
+    if (!typedPredicate) {
+      return goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS;
+    }
+    var equal = typedPredicate(var1, var2);
+    return equal ? goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL :
+        goog.testing.asserts.getDefaultErrorMsg_(var1, var2);
+  };
+
+  /**
+   * @param {*} var1 An item in the expected object.
+   * @param {*} var2 The corresponding item in the actual object.
+   * @param {string} path Their path in the objects.
+   * @suppress {missingProperties} The map_ property is unknown to the compiler
+   *     unless goog.structs.Map is loaded.
+   */
+  function innerAssertImplementation(var1, var2, path) {
+    if (var1 === var2) {
+      return;
+    }
+
+    var typeOfVar1 = _trueTypeOf(var1);
+    var typeOfVar2 = _trueTypeOf(var2);
+
+    if (typeOfVar1 == typeOfVar2) {
+      var isArray = typeOfVar1 == 'Array';
+      var errorMessage = equalityPredicate(typeOfVar1, var1, var2);
+      if (errorMessage !=
+          goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS) {
+        if (errorMessage !=
+            goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL) {
+          failures.push(path + ': ' + errorMessage);
+        }
+      } else if (isArray && var1.length != var2.length) {
+        failures.push(path + ': Expected ' + var1.length + '-element array ' +
+                      'but got a ' + var2.length + '-element array');
+      } else {
+        var childPath = path + (isArray ? '[%s]' : (path ? '.%s' : '%s'));
+
+        // if an object has an __iterator__ property, we have no way of
+        // actually inspecting its raw properties, and JS 1.7 doesn't
+        // overload [] to make it possible for someone to generically
+        // use what the iterator returns to compare the object-managed
+        // properties. This gets us into deep poo with things like
+        // goog.structs.Map, at least on systems that support iteration.
+        if (!var1['__iterator__']) {
+          for (var prop in var1) {
+            if (isArray && goog.testing.asserts.isArrayIndexProp_(prop)) {
+              // Skip array indices for now. We'll handle them later.
+              continue;
+            }
+
+            if (prop in var2) {
+              innerAssertWithCycleCheck(var1[prop], var2[prop],
+                  childPath.replace('%s', prop));
+            } else {
+              failures.push('property ' + prop +
+                            ' not present in actual ' + (path || typeOfVar2));
+            }
+          }
+          // make sure there aren't properties in var2 that are missing
+          // from var1. if there are, then by definition they don't
+          // match.
+          for (var prop in var2) {
+            if (isArray && goog.testing.asserts.isArrayIndexProp_(prop)) {
+              // Skip array indices for now. We'll handle them later.
+              continue;
+            }
+
+            if (!(prop in var1)) {
+              failures.push('property ' + prop +
+                            ' not present in expected ' +
+                            (path || typeOfVar1));
+            }
+          }
+
+          // Handle array indices by iterating from 0 to arr.length.
+          //
+          // Although all browsers allow holes in arrays, browsers
+          // are inconsistent in what they consider a hole. For example,
+          // "[0,undefined,2]" has a hole on IE but not on Firefox.
+          //
+          // Because our style guide bans for...in iteration over arrays,
+          // we assume that most users don't care about holes in arrays,
+          // and that it is ok to say that a hole is equivalent to a slot
+          // populated with 'undefined'.
+          if (isArray) {
+            for (prop = 0; prop < var1.length; prop++) {
+              innerAssertWithCycleCheck(var1[prop], var2[prop],
+                  childPath.replace('%s', String(prop)));
+            }
+          }
+        } else {
+          // special-case for closure objects that have iterators
+          if (goog.isFunction(var1.equals)) {
+            // use the object's own equals function, assuming it accepts an
+            // object and returns a boolean
+            if (!var1.equals(var2)) {
+              failures.push('equals() returned false for ' +
+                            (path || typeOfVar1));
+            }
+          } else if (var1.map_) {
+            // assume goog.structs.Map or goog.structs.Set, where comparing
+            // their private map_ field is sufficient
+            innerAssertWithCycleCheck(var1.map_, var2.map_,
+                childPath.replace('%s', 'map_'));
+          } else {
+            // else die, so user knows we can't do anything
+            failures.push('unable to check ' + (path || typeOfVar1) +
+                          ' for equality: it has an iterator we do not ' +
+                          'know how to handle. please add an equals method');
+          }
+        }
+      }
+    } else {
+      failures.push(path + ' ' +
+          goog.testing.asserts.getDefaultErrorMsg_(var1, var2));
+    }
+  }
+
+  innerAssertWithCycleCheck(expected, actual, '');
+  return failures.length == 0 ? null :
+      goog.testing.asserts.getDefaultErrorMsg_(expected, actual) +
+          '\n   ' + failures.join('\n   ');
+};
+
+
+/**
+ * Notes:
+ * Object equality has some nasty browser quirks, and this implementation is
+ * not 100% correct. For example,
+ *
+ * <code>
+ * var a = [0, 1, 2];
+ * var b = [0, 1, 2];
+ * delete a[1];
+ * b[1] = undefined;
+ * assertObjectEquals(a, b); // should fail, but currently passes
+ * </code>
+ *
+ * See asserts_test.html for more interesting edge cases.
+ *
+ * The first comparison object provided is the expected value, the second is
+ * the actual.
+ *
+ * @param {*} a Assertion message or comparison object.
+ * @param {*} b Comparison object.
+ * @param {*=} opt_c Comparison object, if an assertion message was provided.
+ */
+var assertObjectEquals = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var v1 = nonCommentArg(1, 2, arguments);
+  var v2 = nonCommentArg(2, 2, arguments);
+  var failureMessage = commentArg(2, arguments) ? commentArg(2, arguments) : '';
+  var differences = goog.testing.asserts.findDifferences(v1, v2);
+
+  _assert(failureMessage, !differences, differences);
+};
+
+
+/**
+ * Similar to assertObjectEquals above, but accepts a tolerance margin.
+ *
+ * @param {*} a Assertion message or comparison object.
+ * @param {*} b Comparison object.
+ * @param {*} c Comparison object or tolerance.
+ * @param {*=} opt_d Tolerance, if an assertion message was provided.
+ */
+var assertObjectRoughlyEquals = function(a, b, c, opt_d) {
+  _validateArguments(3, arguments);
+  var v1 = nonCommentArg(1, 3, arguments);
+  var v2 = nonCommentArg(2, 3, arguments);
+  var tolerance = nonCommentArg(3, 3, arguments);
+  var failureMessage = commentArg(3, arguments) ? commentArg(3, arguments) : '';
+  var equalityPredicate = function(type, var1, var2) {
+    var typedPredicate =
+        goog.testing.asserts.primitiveRoughEqualityPredicates_[type];
+    if (!typedPredicate) {
+      return goog.testing.asserts.EQUALITY_PREDICATE_CANT_PROCESS;
+    }
+    var equal = typedPredicate(var1, var2, tolerance);
+    return equal ? goog.testing.asserts.EQUALITY_PREDICATE_VARS_ARE_EQUAL :
+        goog.testing.asserts.getDefaultErrorMsg_(var1, var2) +
+        ' which was more than ' + tolerance + ' away';
+  };
+  var differences = goog.testing.asserts.findDifferences(
+      v1, v2, equalityPredicate);
+
+  _assert(failureMessage, !differences, differences);
+};
+
+
+/**
+ * Compares two arbitrary objects for non-equalness.
+ *
+ * All the same caveats as for assertObjectEquals apply here:
+ * Undefined values may be confused for missing values, or vice versa.
+ *
+ * @param {*} a Assertion message or comparison object.
+ * @param {*} b Comparison object.
+ * @param {*=} opt_c Comparison object, if an assertion message was provided.
+ */
+var assertObjectNotEquals = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var v1 = nonCommentArg(1, 2, arguments);
+  var v2 = nonCommentArg(2, 2, arguments);
+  var failureMessage = commentArg(2, arguments) ? commentArg(2, arguments) : '';
+  var differences = goog.testing.asserts.findDifferences(v1, v2);
+
+  _assert(failureMessage, differences, 'Objects should not be equal');
+};
+
+
+/**
+ * Compares two arrays ignoring negative indexes and extra properties on the
+ * array objects. Use case: Internet Explorer adds the index, lastIndex and
+ * input enumerable fields to the result of string.match(/regexp/g), which makes
+ * assertObjectEquals fail.
+ * @param {*} a The expected array (2 args) or the debug message (3 args).
+ * @param {*} b The actual array (2 args) or the expected array (3 args).
+ * @param {*=} opt_c The actual array (3 args only).
+ */
+var assertArrayEquals = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var v1 = nonCommentArg(1, 2, arguments);
+  var v2 = nonCommentArg(2, 2, arguments);
+  var failureMessage = commentArg(2, arguments) ? commentArg(2, arguments) : '';
+
+  var typeOfVar1 = _trueTypeOf(v1);
+  _assert(failureMessage,
+          typeOfVar1 == 'Array',
+          'Expected an array for assertArrayEquals but found a ' + typeOfVar1);
+
+  var typeOfVar2 = _trueTypeOf(v2);
+  _assert(failureMessage,
+          typeOfVar2 == 'Array',
+          'Expected an array for assertArrayEquals but found a ' + typeOfVar2);
+
+  assertObjectEquals(failureMessage,
+      Array.prototype.concat.call(v1), Array.prototype.concat.call(v2));
+};
+
+
+/**
+ * Compares two objects that can be accessed like an array and assert that
+ * each element is equal.
+ * @param {string|Object} a Failure message (3 arguments)
+ *     or object #1 (2 arguments).
+ * @param {Object} b Object #1 (2 arguments) or object #2 (3 arguments).
+ * @param {Object=} opt_c Object #2 (3 arguments).
+ */
+var assertElementsEquals = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+
+  var v1 = nonCommentArg(1, 2, arguments);
+  var v2 = nonCommentArg(2, 2, arguments);
+  var failureMessage = commentArg(2, arguments) ? commentArg(2, arguments) : '';
+
+  if (!v1) {
+    assert(failureMessage, !v2);
+  } else {
+    assertEquals('length mismatch: ' + failureMessage, v1.length, v2.length);
+    for (var i = 0; i < v1.length; ++i) {
+      assertEquals(
+          'mismatch at index ' + i + ': ' + failureMessage, v1[i], v2[i]);
+    }
+  }
+};
+
+
+/**
+ * Compares two objects that can be accessed like an array and assert that
+ * each element is roughly equal.
+ * @param {string|Object} a Failure message (4 arguments)
+ *     or object #1 (3 arguments).
+ * @param {Object} b Object #1 (4 arguments) or object #2 (3 arguments).
+ * @param {Object|number} c Object #2 (4 arguments) or tolerance (3 arguments).
+ * @param {number=} opt_d tolerance (4 arguments).
+ */
+var assertElementsRoughlyEqual = function(a, b, c, opt_d) {
+  _validateArguments(3, arguments);
+
+  var v1 = nonCommentArg(1, 3, arguments);
+  var v2 = nonCommentArg(2, 3, arguments);
+  var tolerance = nonCommentArg(3, 3, arguments);
+  var failureMessage = commentArg(3, arguments) ? commentArg(3, arguments) : '';
+
+  if (!v1) {
+    assert(failureMessage, !v2);
+  } else {
+    assertEquals('length mismatch: ' + failureMessage, v1.length, v2.length);
+    for (var i = 0; i < v1.length; ++i) {
+      assertRoughlyEquals(failureMessage, v1[i], v2[i], tolerance);
+    }
+  }
+};
+
+
+/**
+ * Compares two array-like objects without taking their order into account.
+ * @param {string|goog.testing.asserts.ArrayLike} a Assertion message or the
+ *     expected elements.
+ * @param {goog.testing.asserts.ArrayLike} b Expected elements or the actual
+ *     elements.
+ * @param {goog.testing.asserts.ArrayLike=} opt_c Actual elements.
+ */
+var assertSameElements = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var expected = nonCommentArg(1, 2, arguments);
+  var actual = nonCommentArg(2, 2, arguments);
+  var message = commentArg(2, arguments);
+
+  assertTrue('Bad arguments to assertSameElements(opt_message, expected: ' +
+      'ArrayLike, actual: ArrayLike)',
+      goog.isArrayLike(expected) && goog.isArrayLike(actual));
+
+  // Clones expected and actual and converts them to real arrays.
+  expected = goog.testing.asserts.toArray_(expected);
+  actual = goog.testing.asserts.toArray_(actual);
+  // TODO(user): It would be great to show only the difference
+  // between the expected and actual elements.
+  _assert(message, expected.length == actual.length,
+      'Expected ' + expected.length + ' elements: [' + expected + '], ' +
+      'got ' + actual.length + ' elements: [' + actual + ']');
+
+  var toFind = goog.testing.asserts.toArray_(expected);
+  for (var i = 0; i < actual.length; i++) {
+    var index = goog.testing.asserts.indexOf_(toFind, actual[i]);
+    _assert(message, index != -1, 'Expected [' + expected + '], got [' +
+        actual + ']');
+    toFind.splice(index, 1);
+  }
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertEvaluatesToTrue = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var value = nonCommentArg(1, 1, arguments);
+  if (!value) {
+    _assert(commentArg(1, arguments), false, 'Expected to evaluate to true');
+  }
+};
+
+
+/**
+ * @param {*} a The value to assert (1 arg) or debug message (2 args).
+ * @param {*=} opt_b The value to assert (2 args only).
+ */
+var assertEvaluatesToFalse = function(a, opt_b) {
+  _validateArguments(1, arguments);
+  var value = nonCommentArg(1, 1, arguments);
+  if (value) {
+    _assert(commentArg(1, arguments), false, 'Expected to evaluate to false');
+  }
+};
+
+
+/**
+ * Compares two HTML snippets.
+ *
+ * Take extra care if attributes are involved. {@code assertHTMLEquals}'s
+ * implementation isn't prepared for complex cases. For example, the following
+ * comparisons erroneously fail:
+ * <pre>
+ * assertHTMLEquals('<a href="x" target="y">', '<a target="y" href="x">');
+ * assertHTMLEquals('<div class="a b">', '<div class="b a">');
+ * assertHTMLEquals('<input disabled>', '<input disabled="disabled">');
+ * </pre>
+ *
+ * When in doubt, use {@code goog.testing.dom.assertHtmlMatches}.
+ *
+ * @param {*} a The expected value (2 args) or the debug message (3 args).
+ * @param {*} b The actual value (2 args) or the expected value (3 args).
+ * @param {*=} opt_c The actual value (3 args only).
+ */
+var assertHTMLEquals = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var var1 = nonCommentArg(1, 2, arguments);
+  var var2 = nonCommentArg(2, 2, arguments);
+  var var1Standardized = standardizeHTML(var1);
+  var var2Standardized = standardizeHTML(var2);
+
+  _assert(commentArg(2, arguments), var1Standardized === var2Standardized,
+          goog.testing.asserts.getDefaultErrorMsg_(
+              var1Standardized, var2Standardized));
+};
+
+
+/**
+ * Compares two CSS property values to make sure that they represent the same
+ * things. This will normalize values in the browser. For example, in Firefox,
+ * this assertion will consider "rgb(0, 0, 255)" and "#0000ff" to be identical
+ * values for the "color" property. This function won't normalize everything --
+ * for example, in most browsers, "blue" will not match "#0000ff". It is
+ * intended only to compensate for unexpected normalizations performed by
+ * the browser that should also affect your expected value.
+ * @param {string} a Assertion message, or the CSS property name.
+ * @param {string} b CSS property name, or the expected value.
+ * @param {string} c The expected value, or the actual value.
+ * @param {string=} opt_d The actual value.
+ */
+var assertCSSValueEquals = function(a, b, c, opt_d) {
+  _validateArguments(3, arguments);
+  var propertyName = nonCommentArg(1, 3, arguments);
+  var expectedValue = nonCommentArg(2, 3, arguments);
+  var actualValue = nonCommentArg(3, 3, arguments);
+  var expectedValueStandardized =
+      standardizeCSSValue(propertyName, expectedValue);
+  var actualValueStandardized =
+      standardizeCSSValue(propertyName, actualValue);
+
+  _assert(commentArg(3, arguments),
+          expectedValueStandardized == actualValueStandardized,
+          goog.testing.asserts.getDefaultErrorMsg_(
+              expectedValueStandardized, actualValueStandardized));
+};
+
+
+/**
+ * @param {*} a The expected value (2 args) or the debug message (3 args).
+ * @param {*} b The actual value (2 args) or the expected value (3 args).
+ * @param {*=} opt_c The actual value (3 args only).
+ */
+var assertHashEquals = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var var1 = nonCommentArg(1, 2, arguments);
+  var var2 = nonCommentArg(2, 2, arguments);
+  var message = commentArg(2, arguments);
+  for (var key in var1) {
+    _assert(message,
+        key in var2, 'Expected hash had key ' + key + ' that was not found');
+    _assert(message, var1[key] == var2[key], 'Value for key ' + key +
+        ' mismatch - expected = ' + var1[key] + ', actual = ' + var2[key]);
+  }
+
+  for (var key in var2) {
+    _assert(message, key in var1, 'Actual hash had key ' + key +
+        ' that was not expected');
+  }
+};
+
+
+/**
+ * @param {*} a The expected value (3 args) or the debug message (4 args).
+ * @param {*} b The actual value (3 args) or the expected value (4 args).
+ * @param {*} c The tolerance (3 args) or the actual value (4 args).
+ * @param {*=} opt_d The tolerance (4 args only).
+ */
+var assertRoughlyEquals = function(a, b, c, opt_d) {
+  _validateArguments(3, arguments);
+  var expected = nonCommentArg(1, 3, arguments);
+  var actual = nonCommentArg(2, 3, arguments);
+  var tolerance = nonCommentArg(3, 3, arguments);
+  _assert(commentArg(3, arguments),
+      goog.testing.asserts.numberRoughEqualityPredicate_(
+          expected, actual, tolerance),
+      'Expected ' + expected + ', but got ' + actual +
+      ' which was more than ' + tolerance + ' away');
+};
+
+
+/**
+ * Checks if the test value is a member of the given container.  Uses
+ * container.indexOf as the underlying function, so this works for strings
+ * and arrays.
+ * @param {*} a Failure message (3 arguments) or the test value
+ *     (2 arguments).
+ * @param {*} b The test value (3 arguments) or the container
+ *     (2 arguments).
+ * @param {*=} opt_c The container.
+ */
+var assertContains = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var contained = nonCommentArg(1, 2, arguments);
+  var container = nonCommentArg(2, 2, arguments);
+  _assert(commentArg(2, arguments),
+      goog.testing.asserts.contains_(container, contained),
+      'Expected \'' + container + '\' to contain \'' + contained + '\'');
+};
+
+
+/**
+ * Checks if the given element is not the member of the given container.
+ * @param {*} a Failure message (3 arguments) or the contained element
+ *     (2 arguments).
+ * @param {*} b The contained element (3 arguments) or the container
+ *     (2 arguments).
+ * @param {*=} opt_c The container.
+ */
+var assertNotContains = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var contained = nonCommentArg(1, 2, arguments);
+  var container = nonCommentArg(2, 2, arguments);
+  _assert(commentArg(2, arguments),
+      !goog.testing.asserts.contains_(container, contained),
+      'Expected \'' + container + '\' not to contain \'' + contained + '\'');
+};
+
+
+/**
+ * Checks if the given string matches the given regular expression.
+ * @param {*} a Failure message (3 arguments) or the expected regular
+ *     expression as a string or RegExp (2 arguments).
+ * @param {*} b The regular expression (3 arguments) or the string to test
+ *     (2 arguments).
+ * @param {*=} opt_c The string to test.
+ */
+var assertRegExp = function(a, b, opt_c) {
+  _validateArguments(2, arguments);
+  var regexp = nonCommentArg(1, 2, arguments);
+  var string = nonCommentArg(2, 2, arguments);
+  if (typeof(regexp) == 'string') {
+    regexp = new RegExp(regexp);
+  }
+  _assert(commentArg(2, arguments),
+      regexp.test(string),
+      'Expected \'' + string + '\' to match RegExp ' + regexp.toString());
+};
+
+
+/**
+ * Converts an array like object to array or clones it if it's already array.
+ * @param {goog.testing.asserts.ArrayLike} arrayLike The collection.
+ * @return {!Array<?>} Copy of the collection as array.
+ * @private
+ */
+goog.testing.asserts.toArray_ = function(arrayLike) {
+  var ret = [];
+  for (var i = 0; i < arrayLike.length; i++) {
+    ret[i] = arrayLike[i];
+  }
+  return ret;
+};
+
+
+/**
+ * Finds the position of the first occurrence of an element in a container.
+ * @param {goog.testing.asserts.ArrayLike} container
+ *     The array to find the element in.
+ * @param {*} contained Element to find.
+ * @return {number} Index of the first occurrence or -1 if not found.
+ * @private
+ */
+goog.testing.asserts.indexOf_ = function(container, contained) {
+  if (container.indexOf) {
+    return container.indexOf(contained);
+  } else {
+    // IE6/7 do not have indexOf so do a search.
+    for (var i = 0; i < container.length; i++) {
+      if (container[i] === contained) {
+        return i;
+      }
+    }
+    return -1;
+  }
+};
+
+
+/**
+ * Tells whether the array contains the given element.
+ * @param {goog.testing.asserts.ArrayLike} container The array to
+ *     find the element in.
+ * @param {*} contained Element to find.
+ * @return {boolean} Whether the element is in the array.
+ * @private
+ */
+goog.testing.asserts.contains_ = function(container, contained) {
+  // TODO(user): Can we check for container.contains as well?
+  // That would give us support for most goog.structs (though weird results
+  // with anything else with a contains method, like goog.math.Range). Falling
+  // back with container.some would catch all iterables, too.
+  return goog.testing.asserts.indexOf_(container, contained) != -1;
+};
+
+var standardizeHTML = function(html) {
+  var translator = document.createElement('DIV');
+  translator.innerHTML = html;
+
+  // Trim whitespace from result (without relying on goog.string)
+  return translator.innerHTML.replace(/^\s+|\s+$/g, '');
+};
+
+
+/**
+ * Standardizes a CSS value for a given property by applying it to an element
+ * and then reading it back.
+ * @param {string} propertyName CSS property name.
+ * @param {string} value CSS value.
+ * @return {string} Normalized CSS value.
+ */
+var standardizeCSSValue = function(propertyName, value) {
+  var styleDeclaration = document.createElement('DIV').style;
+  styleDeclaration[propertyName] = value;
+  return styleDeclaration[propertyName];
+};
+
+
+/**
+ * Raises a JsUnit exception with the given comment.
+ * @param {string} comment A summary for the exception.
+ * @param {string=} opt_message A description of the exception.
+ */
+goog.testing.asserts.raiseException = function(comment, opt_message) {
+  throw new goog.testing.JsUnitException(comment, opt_message);
+};
+
+
+/**
+ * Helper function for assertObjectEquals.
+ * @param {string} prop A property name.
+ * @return {boolean} If the property name is an array index.
+ * @private
+ */
+goog.testing.asserts.isArrayIndexProp_ = function(prop) {
+  return (prop | 0) == prop;
+};
+
+
+
+/**
+ * @param {string} comment A summary for the exception.
+ * @param {?string=} opt_message A description of the exception.
+ * @constructor
+ * @extends {Error}
+ * @final
+ */
+goog.testing.JsUnitException = function(comment, opt_message) {
+  this.isJsUnitException = true;
+  this.message = (comment ? comment : '') +
+                 (comment && opt_message ? '\n' : '') +
+                 (opt_message ? opt_message : '');
+  this.stackTrace = goog.testing.stacktrace.get();
+  // These fields are for compatibility with jsUnitTestManager.
+  this.comment = comment || null;
+  this.jsUnitMessage = opt_message || '';
+
+  // Ensure there is a stack trace.
+  if (Error.captureStackTrace) {
+    Error.captureStackTrace(this, goog.testing.JsUnitException);
+  } else {
+    this.stack = new Error().stack || '';
+  }
+};
+goog.inherits(goog.testing.JsUnitException, Error);
+
+
+/** @override */
+goog.testing.JsUnitException.prototype.toString = function() {
+  return this.message;
+};
+
+
+goog.exportSymbol('fail', fail);
+goog.exportSymbol('assert', assert);
+goog.exportSymbol('assertThrows', assertThrows);
+goog.exportSymbol('assertNotThrows', assertNotThrows);
+goog.exportSymbol('assertTrue', assertTrue);
+goog.exportSymbol('assertFalse', assertFalse);
+goog.exportSymbol('assertEquals', assertEquals);
+goog.exportSymbol('assertNotEquals', assertNotEquals);
+goog.exportSymbol('assertNull', assertNull);
+goog.exportSymbol('assertNotNull', assertNotNull);
+goog.exportSymbol('assertUndefined', assertUndefined);
+goog.exportSymbol('assertNotUndefined', assertNotUndefined);
+goog.exportSymbol('assertNotNullNorUndefined', assertNotNullNorUndefined);
+goog.exportSymbol('assertNonEmptyString', assertNonEmptyString);
+goog.exportSymbol('assertNaN', assertNaN);
+goog.exportSymbol('assertNotNaN', assertNotNaN);
+goog.exportSymbol('assertObjectEquals', assertObjectEquals);
+goog.exportSymbol('assertObjectRoughlyEquals', assertObjectRoughlyEquals);
+goog.exportSymbol('assertObjectNotEquals', assertObjectNotEquals);
+goog.exportSymbol('assertArrayEquals', assertArrayEquals);
+goog.exportSymbol('assertElementsEquals', assertElementsEquals);
+goog.exportSymbol('assertElementsRoughlyEqual', assertElementsRoughlyEqual);
+goog.exportSymbol('assertSameElements', assertSameElements);
+goog.exportSymbol('assertEvaluatesToTrue', assertEvaluatesToTrue);
+goog.exportSymbol('assertEvaluatesToFalse', assertEvaluatesToFalse);
+goog.exportSymbol('assertHTMLEquals', assertHTMLEquals);
+goog.exportSymbol('assertHashEquals', assertHashEquals);
+goog.exportSymbol('assertRoughlyEquals', assertRoughlyEquals);
+goog.exportSymbol('assertContains', assertContains);
+goog.exportSymbol('assertNotContains', assertNotContains);
+goog.exportSymbol('assertRegExp', assertRegExp);
diff --git a/lib/goog/testing/asynctestcase.js b/lib/goog/testing/asynctestcase.js
new file mode 100644
index 0000000..b0ea117
--- /dev/null
+++ b/lib/goog/testing/asynctestcase.js
@@ -0,0 +1,896 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// All Rights Reserved.
+
+/**
+ * @fileoverview A class representing a set of test functions that use
+ * asynchronous functions that cannot be meaningfully mocked.
+ *
+ * To create a Google-compatable JsUnit test using this test case, put the
+ * following snippet in your test:
+ *
+ *   var asyncTestCase = goog.testing.AsyncTestCase.createAndInstall();
+ *
+ * To make the test runner wait for your asynchronous behaviour, use:
+ *
+ *   asyncTestCase.waitForAsync('Waiting for xhr to respond');
+ *
+ * The next test will not start until the following call is made, or a
+ * timeout occurs:
+ *
+ *   asyncTestCase.continueTesting();
+ *
+ * There does NOT need to be a 1:1 mapping of waitForAsync calls and
+ * continueTesting calls. The next test will be run after a single call to
+ * continueTesting is made, as long as there is no subsequent call to
+ * waitForAsync in the same thread.
+ *
+ * Example:
+ *   // Returning here would cause the next test to be run.
+ *   asyncTestCase.waitForAsync('description 1');
+ *   // Returning here would *not* cause the next test to be run.
+ *   // Only effect of additional waitForAsync() calls is an updated
+ *   // description in the case of a timeout.
+ *   asyncTestCase.waitForAsync('updated description');
+ *   asyncTestCase.continueTesting();
+ *   // Returning here would cause the next test to be run.
+ *   asyncTestCase.waitForAsync('just kidding, still running.');
+ *   // Returning here would *not* cause the next test to be run.
+ *
+ * The test runner can also be made to wait for more than one asynchronous
+ * event with:
+ *
+ *   asyncTestCase.waitForSignals(n);
+ *
+ * The next test will not start until asyncTestCase.signal() is called n times,
+ * or the test step timeout is exceeded.
+ *
+ * This class supports asynchronous behaviour in all test functions except for
+ * tearDownPage. If such support is needed, it can be added.
+ *
+ * Example Usage:
+ *
+ *   var asyncTestCase = goog.testing.AsyncTestCase.createAndInstall();
+ *   // Optionally, set a longer-than-normal step timeout.
+ *   asyncTestCase.stepTimeout = 30 * 1000;
+ *
+ *   function testSetTimeout() {
+ *     var step = 0;
+ *     function stepCallback() {
+ *       step++;
+ *       switch (step) {
+ *         case 1:
+ *           var startTime = goog.now();
+ *           asyncTestCase.waitForAsync('step 1');
+ *           window.setTimeout(stepCallback, 100);
+ *           break;
+ *         case 2:
+ *           assertTrue('Timeout fired too soon',
+ *               goog.now() - startTime >= 100);
+ *           asyncTestCase.waitForAsync('step 2');
+ *           window.setTimeout(stepCallback, 100);
+ *           break;
+ *         case 3:
+ *           assertTrue('Timeout fired too soon',
+ *               goog.now() - startTime >= 200);
+ *           asyncTestCase.continueTesting();
+ *           break;
+ *         default:
+ *           fail('Unexpected call to stepCallback');
+ *       }
+ *     }
+ *     stepCallback();
+ *   }
+ *
+ * Known Issues:
+ *   IE7 Exceptions:
+ *     As the failingtest.html will show, it appears as though ie7 does not
+ *     propagate an exception past a function called using the func.call()
+ *     syntax. This causes case 3 of the failing tests (exceptions) to show up
+ *     as timeouts in IE.
+ *   window.onerror:
+ *     This seems to catch errors only in ff2/ff3. It does not work in Safari or
+ *     IE7. The consequence of this is that exceptions that would have been
+ *     caught by window.onerror show up as timeouts.
+ *
+ * @author agrieve@google.com (Andrew Grieve)
+ */
+
+goog.provide('goog.testing.AsyncTestCase');
+goog.provide('goog.testing.AsyncTestCase.ControlBreakingException');
+
+goog.require('goog.testing.TestCase');
+goog.require('goog.testing.TestCase.Test');
+goog.require('goog.testing.asserts');
+
+
+
+/**
+ * A test case that is capable of running tests the contain asynchronous logic.
+ * @param {string=} opt_name A descriptive name for the test case.
+ * @extends {goog.testing.TestCase}
+ * @constructor
+ */
+goog.testing.AsyncTestCase = function(opt_name) {
+  goog.testing.TestCase.call(this, opt_name);
+};
+goog.inherits(goog.testing.AsyncTestCase, goog.testing.TestCase);
+
+
+/**
+ * Represents result of top stack function call.
+ * @typedef {{controlBreakingExceptionThrown: boolean, message: string}}
+ * @private
+ */
+goog.testing.AsyncTestCase.TopStackFuncResult_;
+
+
+
+/**
+ * An exception class used solely for control flow.
+ * @param {string=} opt_message Error message.
+ * @constructor
+ * @final
+ */
+goog.testing.AsyncTestCase.ControlBreakingException = function(opt_message) {
+  /**
+   * The exception message.
+   * @type {string}
+   */
+  this.message = opt_message || '';
+};
+
+
+/**
+ * Return value for .toString().
+ * @type {string}
+ */
+goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING =
+    '[AsyncTestCase.ControlBreakingException]';
+
+
+/**
+ * Marks this object as a ControlBreakingException
+ * @type {boolean}
+ */
+goog.testing.AsyncTestCase.ControlBreakingException.prototype.
+    isControlBreakingException = true;
+
+
+/** @override */
+goog.testing.AsyncTestCase.ControlBreakingException.prototype.toString =
+    function() {
+  // This shows up in the console when the exception is not caught.
+  return goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING;
+};
+
+
+/**
+ * How long to wait for a single step of a test to complete in milliseconds.
+ * A step starts when a call to waitForAsync() is made.
+ * @type {number}
+ */
+goog.testing.AsyncTestCase.prototype.stepTimeout = 1000;
+
+
+/**
+ * How long to wait after a failed test before moving onto the next one.
+ * The purpose of this is to allow any pending async callbacks from the failing
+ * test to finish up and not cause the next test to fail.
+ * @type {number}
+ */
+goog.testing.AsyncTestCase.prototype.timeToSleepAfterFailure = 500;
+
+
+/**
+ * Turn on extra logging to help debug failing async. tests.
+ * @type {boolean}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.enableDebugLogs_ = false;
+
+
+/**
+ * A reference to the original asserts.js assert_() function.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.origAssert_;
+
+
+/**
+ * A reference to the original asserts.js fail() function.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.origFail_;
+
+
+/**
+ * A reference to the original window.onerror function.
+ * @type {Function|undefined}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.origOnError_;
+
+
+/**
+ * The stage of the test we are currently on.
+ * @type {Function|undefined}}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.curStepFunc_;
+
+
+/**
+ * The name of the stage of the test we are currently on.
+ * @type {string}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.curStepName_ = '';
+
+
+/**
+ * The stage of the test we should run next.
+ * @type {Function|undefined}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.nextStepFunc;
+
+
+/**
+ * The name of the stage of the test we should run next.
+ * @type {string}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.nextStepName_ = '';
+
+
+/**
+ * The handle to the current setTimeout timer.
+ * @type {number}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.timeoutHandle_ = 0;
+
+
+/**
+ * Marks if the cleanUp() function has been called for the currently running
+ * test.
+ * @type {boolean}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.cleanedUp_ = false;
+
+
+/**
+ * The currently active test.
+ * @type {goog.testing.TestCase.Test|undefined}
+ * @protected
+ */
+goog.testing.AsyncTestCase.prototype.activeTest;
+
+
+/**
+ * A flag to prevent recursive exception handling.
+ * @type {boolean}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.inException_ = false;
+
+
+/**
+ * Flag used to determine if we can move to the next step in the testing loop.
+ * @type {boolean}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.isReady_ = true;
+
+
+/**
+ * Number of signals to wait for before continuing testing when waitForSignals
+ * is used.
+ * @type {number}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.expectedSignalCount_ = 0;
+
+
+/**
+ * Number of signals received.
+ * @type {number}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.receivedSignalCount_ = 0;
+
+
+/**
+ * Flag that tells us if there is a function in the call stack that will make
+ * a call to pump_().
+ * @type {boolean}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.returnWillPump_ = false;
+
+
+/**
+ * The number of times we have thrown a ControlBreakingException so that we
+ * know not to complain in our window.onerror handler. In Webkit, window.onerror
+ * is not supported, and so this counter will keep going up but we won't care
+ * about it.
+ * @type {number}
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.numControlExceptionsExpected_ = 0;
+
+
+/**
+ * The current step name.
+ * @return {!string} Step name.
+ * @protected
+ */
+goog.testing.AsyncTestCase.prototype.getCurrentStepName = function() {
+  return this.curStepName_;
+};
+
+
+/**
+ * Preferred way of creating an AsyncTestCase. Creates one and initializes it
+ * with the G_testRunner.
+ * @param {string=} opt_name A descriptive name for the test case.
+ * @return {!goog.testing.AsyncTestCase} The created AsyncTestCase.
+ */
+goog.testing.AsyncTestCase.createAndInstall = function(opt_name) {
+  var asyncTestCase = new goog.testing.AsyncTestCase(opt_name);
+  goog.testing.TestCase.initializeTestRunner(asyncTestCase);
+  return asyncTestCase;
+};
+
+
+/**
+ * Informs the testcase not to continue to the next step in the test cycle
+ * until continueTesting is called.
+ * @param {string=} opt_name A description of what we are waiting for.
+ */
+goog.testing.AsyncTestCase.prototype.waitForAsync = function(opt_name) {
+  this.isReady_ = false;
+  this.curStepName_ = opt_name || this.curStepName_;
+
+  // Reset the timer that tracks if the async test takes too long.
+  this.stopTimeoutTimer_();
+  this.startTimeoutTimer_();
+};
+
+
+/**
+ * Continue with the next step in the test cycle.
+ */
+goog.testing.AsyncTestCase.prototype.continueTesting = function() {
+  if (this.receivedSignalCount_ < this.expectedSignalCount_) {
+    var remaining = this.expectedSignalCount_ - this.receivedSignalCount_;
+    throw Error('Still waiting for ' + remaining + ' signals.');
+  }
+  this.endCurrentStep_();
+};
+
+
+/**
+ * Ends the current test step and queues the next test step to run.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.endCurrentStep_ = function() {
+  if (!this.isReady_) {
+    // We are a potential entry point, so we pump.
+    this.isReady_ = true;
+    this.stopTimeoutTimer_();
+    // Run this in a setTimeout so that the caller has a chance to call
+    // waitForAsync() again before we continue.
+    this.timeout(goog.bind(this.pump_, this, null), 0);
+  }
+};
+
+
+/**
+ * Informs the testcase not to continue to the next step in the test cycle
+ * until signal is called the specified number of times. Within a test, this
+ * function behaves additively if called multiple times; the number of signals
+ * to wait for will be the sum of all expected number of signals this function
+ * was called with.
+ * @param {number} times The number of signals to receive before
+ *    continuing testing.
+ * @param {string=} opt_name A description of what we are waiting for.
+ */
+goog.testing.AsyncTestCase.prototype.waitForSignals =
+    function(times, opt_name) {
+  this.expectedSignalCount_ += times;
+  if (this.receivedSignalCount_ < this.expectedSignalCount_) {
+    this.waitForAsync(opt_name);
+  }
+};
+
+
+/**
+ * Signals once to continue with the test. If this is the last signal that the
+ * test was waiting on, call continueTesting.
+ */
+goog.testing.AsyncTestCase.prototype.signal = function() {
+  if (++this.receivedSignalCount_ === this.expectedSignalCount_ &&
+      this.expectedSignalCount_ > 0) {
+    this.endCurrentStep_();
+  }
+};
+
+
+/**
+ * Handles an exception thrown by a test.
+ * @param {*=} opt_e The exception object associated with the failure
+ *     or a string.
+ * @throws Always throws a ControlBreakingException.
+ */
+goog.testing.AsyncTestCase.prototype.doAsyncError = function(opt_e) {
+  // If we've caught an exception that we threw, then just pass it along. This
+  // can happen if doAsyncError() was called from a call to assert and then
+  // again by pump_().
+  if (opt_e && opt_e.isControlBreakingException) {
+    throw opt_e;
+  }
+
+  // Prevent another timeout error from triggering for this test step.
+  this.stopTimeoutTimer_();
+
+  // doError() uses test.name. Here, we create a dummy test and give it a more
+  // helpful name based on the step we're currently on.
+  var fakeTestObj = new goog.testing.TestCase.Test(this.curStepName_,
+                                                   goog.nullFunction);
+  if (this.activeTest) {
+    fakeTestObj.name = this.activeTest.name + ' [' + fakeTestObj.name + ']';
+  }
+
+  if (this.activeTest) {
+    // Note: if the test has an error, and then tearDown has an error, they will
+    // both be reported.
+    this.doError(fakeTestObj, opt_e);
+  } else {
+    this.exceptionBeforeTest = opt_e;
+  }
+
+  // This is a potential entry point, so we pump. We also add in a bit of a
+  // delay to try and prevent any async behavior from the failed test from
+  // causing the next test to fail.
+  this.timeout(goog.bind(this.pump_, this, this.doAsyncErrorTearDown_),
+      this.timeToSleepAfterFailure);
+
+  // We just caught an exception, so we do not want the code above us on the
+  // stack to continue executing. If pump_ is in our call-stack, then it will
+  // batch together multiple errors, so we only increment the count if pump_ is
+  // not in the stack and let pump_ increment the count when it batches them.
+  if (!this.returnWillPump_) {
+    this.numControlExceptionsExpected_ += 1;
+    this.dbgLog_('doAsynError: numControlExceptionsExpected_ = ' +
+        this.numControlExceptionsExpected_ + ' and throwing exception.');
+  }
+
+  // Copy the error message to ControlBreakingException.
+  var message = '';
+  if (typeof opt_e == 'string') {
+    message = opt_e;
+  } else if (opt_e && opt_e.message) {
+    message = opt_e.message;
+  }
+  throw new goog.testing.AsyncTestCase.ControlBreakingException(message);
+};
+
+
+/**
+ * Sets up the test page and then waits until the test case has been marked
+ * as ready before executing the tests.
+ * @override
+ */
+goog.testing.AsyncTestCase.prototype.runTests = function() {
+  this.hookAssert_();
+  this.hookOnError_();
+
+  this.setNextStep_(this.doSetUpPage_, 'setUpPage');
+  // We are an entry point, so we pump.
+  this.pump_();
+};
+
+
+/**
+ * Starts the tests.
+ * @override
+ */
+goog.testing.AsyncTestCase.prototype.cycleTests = function() {
+  // We are an entry point, so we pump.
+  this.saveMessage('Start');
+  this.setNextStep_(this.doIteration_, 'doIteration');
+  this.pump_();
+};
+
+
+/**
+ * Finalizes the test case, called when the tests have finished executing.
+ * @override
+ */
+goog.testing.AsyncTestCase.prototype.finalize = function() {
+  this.unhookAll_();
+  this.setNextStep_(null, 'finalized');
+  goog.testing.AsyncTestCase.superClass_.finalize.call(this);
+};
+
+
+/**
+ * Enables verbose logging of what is happening inside of the AsyncTestCase.
+ */
+goog.testing.AsyncTestCase.prototype.enableDebugLogging = function() {
+  this.enableDebugLogs_ = true;
+};
+
+
+/**
+ * Logs the given debug message to the console (when enabled).
+ * @param {string} message The message to log.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.dbgLog_ = function(message) {
+  if (this.enableDebugLogs_) {
+    this.log('AsyncTestCase - ' + message);
+  }
+};
+
+
+/**
+ * Wraps doAsyncError() for when we are sure that the test runner has no user
+ * code above it in the stack.
+ * @param {string|Error=} opt_e The exception object associated with the
+ *     failure or a string.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.doTopOfStackAsyncError_ =
+    function(opt_e) {
+  /** @preserveTry */
+  try {
+    this.doAsyncError(opt_e);
+  } catch (e) {
+    // We know that we are on the top of the stack, so there is no need to
+    // throw this exception in this case.
+    if (e.isControlBreakingException) {
+      this.numControlExceptionsExpected_ -= 1;
+      this.dbgLog_('doTopOfStackAsyncError_: numControlExceptionsExpected_ = ' +
+          this.numControlExceptionsExpected_ + ' and catching exception.');
+    } else {
+      throw e;
+    }
+  }
+};
+
+
+/**
+ * Calls the tearDown function, catching any errors, and then moves on to
+ * the next step in the testing cycle.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.doAsyncErrorTearDown_ = function() {
+  if (this.inException_) {
+    // We get here if tearDown is throwing the error.
+    // Upon calling continueTesting, the inline function 'doAsyncError' (set
+    // below) is run.
+    this.endCurrentStep_();
+  } else {
+    this.inException_ = true;
+    this.isReady_ = true;
+
+    // The continue point is different depending on if the error happened in
+    // setUpPage() or in setUp()/test*()/tearDown().
+    var stepFuncAfterError = this.nextStepFunc_;
+    var stepNameAfterError = 'TestCase.execute (after error)';
+    if (this.activeTest) {
+      stepFuncAfterError = this.doIteration_;
+      stepNameAfterError = 'doIteration (after error)';
+    }
+
+    // We must set the next step before calling tearDown.
+    this.setNextStep_(function() {
+      this.inException_ = false;
+      // This is null when an error happens in setUpPage.
+      this.setNextStep_(stepFuncAfterError, stepNameAfterError);
+    }, 'doAsyncError');
+
+    // Call the test's tearDown().
+    if (!this.cleanedUp_) {
+      this.cleanedUp_ = true;
+      this.tearDown();
+    }
+  }
+};
+
+
+/**
+ * Replaces the asserts.js assert_() and fail() functions with a wrappers to
+ * catch the exceptions.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.hookAssert_ = function() {
+  if (!this.origAssert_) {
+    this.origAssert_ = _assert;
+    this.origFail_ = fail;
+    var self = this;
+    _assert = function() {
+      /** @preserveTry */
+      try {
+        self.origAssert_.apply(this, arguments);
+      } catch (e) {
+        self.dbgLog_('Wrapping failed assert()');
+        self.doAsyncError(e);
+      }
+    };
+    fail = function() {
+      /** @preserveTry */
+      try {
+        self.origFail_.apply(this, arguments);
+      } catch (e) {
+        self.dbgLog_('Wrapping fail()');
+        self.doAsyncError(e);
+      }
+    };
+  }
+};
+
+
+/**
+ * Sets a window.onerror handler for catching exceptions that happen in async
+ * callbacks. Note that as of Safari 3.1, Safari does not support this.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.hookOnError_ = function() {
+  if (!this.origOnError_) {
+    this.origOnError_ = window.onerror;
+    var self = this;
+    window.onerror = function(error, url, line) {
+      // Ignore exceptions that we threw on purpose.
+      var cbe =
+          goog.testing.AsyncTestCase.ControlBreakingException.TO_STRING;
+      if (String(error).indexOf(cbe) != -1 &&
+          self.numControlExceptionsExpected_) {
+        self.numControlExceptionsExpected_ -= 1;
+        self.dbgLog_('window.onerror: numControlExceptionsExpected_ = ' +
+            self.numControlExceptionsExpected_ + ' and ignoring exception. ' +
+            error);
+        // Tell the browser not to compain about the error.
+        return true;
+      } else {
+        self.dbgLog_('window.onerror caught exception.');
+        var message = error + '\nURL: ' + url + '\nLine: ' + line;
+        self.doTopOfStackAsyncError_(message);
+        // Tell the browser to complain about the error.
+        return false;
+      }
+    };
+  }
+};
+
+
+/**
+ * Unhooks window.onerror and _assert.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.unhookAll_ = function() {
+  if (this.origOnError_) {
+    window.onerror = this.origOnError_;
+    this.origOnError_ = null;
+    _assert = this.origAssert_;
+    this.origAssert_ = null;
+    fail = this.origFail_;
+    this.origFail_ = null;
+  }
+};
+
+
+/**
+ * Enables the timeout timer. This timer fires unless continueTesting is
+ * called.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.startTimeoutTimer_ = function() {
+  if (!this.timeoutHandle_ && this.stepTimeout > 0) {
+    this.timeoutHandle_ = this.timeout(goog.bind(function() {
+      this.dbgLog_('Timeout timer fired with id ' + this.timeoutHandle_);
+      this.timeoutHandle_ = 0;
+
+      this.doTopOfStackAsyncError_('Timed out while waiting for ' +
+          'continueTesting() to be called.');
+    }, this, null), this.stepTimeout);
+    this.dbgLog_('Started timeout timer with id ' + this.timeoutHandle_);
+  }
+};
+
+
+/**
+ * Disables the timeout timer.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.stopTimeoutTimer_ = function() {
+  if (this.timeoutHandle_) {
+    this.dbgLog_('Clearing timeout timer with id ' + this.timeoutHandle_);
+    this.clearTimeout(this.timeoutHandle_);
+    this.timeoutHandle_ = 0;
+  }
+};
+
+
+/**
+ * Sets the next function to call in our sequence of async callbacks.
+ * @param {Function} func The function that executes the next step.
+ * @param {string} name A description of the next step.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.setNextStep_ = function(func, name) {
+  this.nextStepFunc_ = func && goog.bind(func, this);
+  this.nextStepName_ = name;
+};
+
+
+/**
+ * Calls the given function, redirecting any exceptions to doAsyncError.
+ * @param {Function} func The function to call.
+ * @return {!goog.testing.AsyncTestCase.TopStackFuncResult_} Returns a
+ * TopStackFuncResult_.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.callTopOfStackFunc_ = function(func) {
+  /** @preserveTry */
+  try {
+    func.call(this);
+    return {controlBreakingExceptionThrown: false, message: ''};
+  } catch (e) {
+    this.dbgLog_('Caught exception in callTopOfStackFunc_');
+    /** @preserveTry */
+    try {
+      this.doAsyncError(e);
+      return {controlBreakingExceptionThrown: false, message: ''};
+    } catch (e2) {
+      if (!e2.isControlBreakingException) {
+        throw e2;
+      }
+      return {controlBreakingExceptionThrown: true, message: e2.message};
+    }
+  }
+};
+
+
+/**
+ * Calls the next callback when the isReady_ flag is true.
+ * @param {Function=} opt_doFirst A function to call before pumping.
+ * @private
+ * @throws Throws a ControlBreakingException if there were any failing steps.
+ */
+goog.testing.AsyncTestCase.prototype.pump_ = function(opt_doFirst) {
+  // If this function is already above us in the call-stack, then we should
+  // return rather than pumping in order to minimize call-stack depth.
+  if (!this.returnWillPump_) {
+    this.setBatchTime(this.now());
+    this.returnWillPump_ = true;
+    var topFuncResult = {};
+
+    if (opt_doFirst) {
+      topFuncResult = this.callTopOfStackFunc_(opt_doFirst);
+    }
+    // Note: we don't check for this.running here because it is not set to true
+    // while executing setUpPage and tearDownPage.
+    // Also, if isReady_ is false, then one of two things will happen:
+    // 1. Our timeout callback will be called.
+    // 2. The tests will call continueTesting(), which will call pump_() again.
+    while (this.isReady_ && this.nextStepFunc_ &&
+        !topFuncResult.controlBreakingExceptionThrown) {
+      this.curStepFunc_ = this.nextStepFunc_;
+      this.curStepName_ = this.nextStepName_;
+      this.nextStepFunc_ = null;
+      this.nextStepName_ = '';
+
+      this.dbgLog_('Performing step: ' + this.curStepName_);
+      topFuncResult =
+          this.callTopOfStackFunc_(/** @type {Function} */(this.curStepFunc_));
+
+      // If the max run time is exceeded call this function again async so as
+      // not to block the browser.
+      var delta = this.now() - this.getBatchTime();
+      if (delta > goog.testing.TestCase.maxRunTime &&
+          !topFuncResult.controlBreakingExceptionThrown) {
+        this.saveMessage('Breaking async');
+        var self = this;
+        this.timeout(function() { self.pump_(); }, 100);
+        break;
+      }
+    }
+    this.returnWillPump_ = false;
+  } else if (opt_doFirst) {
+    opt_doFirst.call(this);
+  }
+};
+
+
+/**
+ * Sets up the test page and then waits untill the test case has been marked
+ * as ready before executing the tests.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.doSetUpPage_ = function() {
+  this.setNextStep_(this.execute, 'TestCase.execute');
+  this.setUpPage();
+};
+
+
+/**
+ * Step 1: Move to the next test.
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.doIteration_ = function() {
+  this.expectedSignalCount_ = 0;
+  this.receivedSignalCount_ = 0;
+  this.activeTest = this.next();
+  if (this.activeTest && this.running) {
+    this.result_.runCount++;
+    // If this test should be marked as having failed, doIteration will go
+    // straight to the next test.
+    if (this.maybeFailTestEarly(this.activeTest)) {
+      this.setNextStep_(this.doIteration_, 'doIteration');
+    } else {
+      this.setNextStep_(this.doSetUp_, 'setUp');
+    }
+  } else {
+    // All tests done.
+    this.finalize();
+  }
+};
+
+
+/**
+ * Step 2: Call setUp().
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.doSetUp_ = function() {
+  this.log('Running test: ' + this.activeTest.name);
+  this.cleanedUp_ = false;
+  this.setNextStep_(this.doExecute_, this.activeTest.name);
+  this.setUp();
+};
+
+
+/**
+ * Step 3: Call test.execute().
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.doExecute_ = function() {
+  this.setNextStep_(this.doTearDown_, 'tearDown');
+  this.activeTest.execute();
+};
+
+
+/**
+ * Step 4: Call tearDown().
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.doTearDown_ = function() {
+  this.cleanedUp_ = true;
+  this.setNextStep_(this.doNext_, 'doNext');
+  this.tearDown();
+};
+
+
+/**
+ * Step 5: Call doSuccess()
+ * @private
+ */
+goog.testing.AsyncTestCase.prototype.doNext_ = function() {
+  this.setNextStep_(this.doIteration_, 'doIteration');
+  this.doSuccess(/** @type {goog.testing.TestCase.Test} */(this.activeTest));
+};
diff --git a/lib/goog/testing/events/events.js b/lib/goog/testing/events/events.js
new file mode 100644
index 0000000..9ed5fa8
--- /dev/null
+++ b/lib/goog/testing/events/events.js
@@ -0,0 +1,767 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Event Simulation.
+ *
+ * Utility functions for simulating events at the Closure level. All functions
+ * in this package generate events by calling goog.events.fireListeners,
+ * rather than interfacing with the browser directly. This is intended for
+ * testing purposes, and should not be used in production code.
+ *
+ * The decision to use Closure events and dispatchers instead of the browser's
+ * native events and dispatchers was conscious and deliberate. Native event
+ * dispatchers have their own set of quirks and edge cases. Pure JS dispatchers
+ * are more robust and transparent.
+ *
+ * If you think you need a testing mechanism that uses native Event objects,
+ * please, please email closure-tech first to explain your use case before you
+ * sink time into this.
+ *
+ * @author nicksantos@google.com (Nick Santos)
+ */
+
+goog.provide('goog.testing.events');
+goog.provide('goog.testing.events.Event');
+
+goog.require('goog.Disposable');
+goog.require('goog.asserts');
+goog.require('goog.dom.NodeType');
+goog.require('goog.events');
+goog.require('goog.events.BrowserEvent');
+goog.require('goog.events.BrowserFeature');
+goog.require('goog.events.EventTarget');
+goog.require('goog.events.EventType');
+goog.require('goog.events.KeyCodes');
+goog.require('goog.object');
+goog.require('goog.style');
+goog.require('goog.userAgent');
+
+
+
+/**
+ * goog.events.BrowserEvent expects an Event so we provide one for JSCompiler.
+ *
+ * This clones a lot of the functionality of goog.events.Event. This used to
+ * use a mixin, but the mixin results in confusing the two types when compiled.
+ *
+ * @param {string} type Event Type.
+ * @param {Object=} opt_target Reference to the object that is the target of
+ *     this event.
+ * @constructor
+ * @extends {Event}
+ */
+goog.testing.events.Event = function(type, opt_target) {
+  this.type = type;
+
+  this.target = /** @type {EventTarget} */ (opt_target || null);
+
+  this.currentTarget = this.target;
+};
+
+
+/**
+ * Whether to cancel the event in internal capture/bubble processing for IE.
+ * @type {boolean}
+ * @public
+ * @suppress {underscore|visibility} Technically public, but referencing this
+ *     outside this package is strongly discouraged.
+ */
+goog.testing.events.Event.prototype.propagationStopped_ = false;
+
+
+/** @override */
+goog.testing.events.Event.prototype.defaultPrevented = false;
+
+
+/**
+ * Return value for in internal capture/bubble processing for IE.
+ * @type {boolean}
+ * @public
+ * @suppress {underscore|visibility} Technically public, but referencing this
+ *     outside this package is strongly discouraged.
+ */
+goog.testing.events.Event.prototype.returnValue_ = true;
+
+
+/** @override */
+goog.testing.events.Event.prototype.stopPropagation = function() {
+  this.propagationStopped_ = true;
+};
+
+
+/** @override */
+goog.testing.events.Event.prototype.preventDefault = function() {
+  this.defaultPrevented = true;
+  this.returnValue_ = false;
+};
+
+
+/**
+ * Asserts an event target exists.  This will fail if target is not defined.
+ *
+ * TODO(nnaze): Gradually add this to the methods in this file, and eventually
+ *     update the method signatures to not take nullables.  See http://b/8961907
+ *
+ * @param {EventTarget} target A target to assert.
+ * @return {!EventTarget} The target, guaranteed to exist.
+ * @private
+ */
+goog.testing.events.assertEventTarget_ = function(target) {
+  return goog.asserts.assert(target, 'EventTarget should be defined.');
+};
+
+
+/**
+ * A static helper function that sets the mouse position to the event.
+ * @param {Event} event A simulated native event.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @private
+ */
+goog.testing.events.setEventClientXY_ = function(event, opt_coords) {
+  if (!opt_coords && event.target &&
+      event.target.nodeType == goog.dom.NodeType.ELEMENT) {
+    try {
+      opt_coords =
+          goog.style.getClientPosition(/** @type {!Element} **/ (event.target));
+    } catch (ex) {
+      // IE sometimes throws if it can't get the position.
+    }
+  }
+  event.clientX = opt_coords ? opt_coords.x : 0;
+  event.clientY = opt_coords ? opt_coords.y : 0;
+
+  // Pretend the browser window is at (0, 0).
+  event.screenX = event.clientX;
+  event.screenY = event.clientY;
+};
+
+
+/**
+ * Simulates a mousedown, mouseup, and then click on the given event target,
+ * with the left mouse button.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;
+ *     defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the sequence: false if preventDefault()
+ *     was called on any of the events, true otherwise.
+ */
+goog.testing.events.fireClickSequence =
+    function(target, opt_button, opt_coords, opt_eventProperties) {
+  // Fire mousedown, mouseup, and click. Then return the bitwise AND of the 3.
+  return !!(goog.testing.events.fireMouseDownEvent(
+      target, opt_button, opt_coords, opt_eventProperties) &
+            goog.testing.events.fireMouseUpEvent(
+                target, opt_button, opt_coords, opt_eventProperties) &
+            goog.testing.events.fireClickEvent(
+                target, opt_button, opt_coords, opt_eventProperties));
+};
+
+
+/**
+ * Simulates the sequence of events fired by the browser when the user double-
+ * clicks the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the sequence: false if preventDefault()
+ *     was called on any of the events, true otherwise.
+ */
+goog.testing.events.fireDoubleClickSequence = function(
+    target, opt_coords, opt_eventProperties) {
+  // Fire mousedown, mouseup, click, mousedown, mouseup, click, dblclick.
+  // Then return the bitwise AND of the 7.
+  var btn = goog.events.BrowserEvent.MouseButton.LEFT;
+  return !!(goog.testing.events.fireMouseDownEvent(
+      target, btn, opt_coords, opt_eventProperties) &
+            goog.testing.events.fireMouseUpEvent(
+                target, btn, opt_coords, opt_eventProperties) &
+            goog.testing.events.fireClickEvent(
+                target, btn, opt_coords, opt_eventProperties) &
+            // IE fires a selectstart instead of the second mousedown in a
+            // dblclick, but we don't care about selectstart.
+            (goog.userAgent.IE ||
+            goog.testing.events.fireMouseDownEvent(
+                target, btn, opt_coords, opt_eventProperties)) &
+            goog.testing.events.fireMouseUpEvent(
+                target, btn, opt_coords, opt_eventProperties) &
+            // IE doesn't fire the second click in a dblclick.
+            (goog.userAgent.IE ||
+            goog.testing.events.fireClickEvent(
+                target, btn, opt_coords, opt_eventProperties)) &
+            goog.testing.events.fireDoubleClickEvent(
+                target, opt_coords, opt_eventProperties));
+};
+
+
+/**
+ * Simulates a complete keystroke (keydown, keypress, and keyup). Note that
+ * if preventDefault is called on the keydown, the keypress will not fire.
+ *
+ * @param {EventTarget} target The target for the event.
+ * @param {number} keyCode The keycode of the key pressed.
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the sequence: false if preventDefault()
+ *     was called on any of the events, true otherwise.
+ */
+goog.testing.events.fireKeySequence = function(
+    target, keyCode, opt_eventProperties) {
+  return goog.testing.events.fireNonAsciiKeySequence(target, keyCode, keyCode,
+                                                     opt_eventProperties);
+};
+
+
+/**
+ * Simulates a complete keystroke (keydown, keypress, and keyup) when typing
+ * a non-ASCII character. Same as fireKeySequence, the keypress will not fire
+ * if preventDefault is called on the keydown.
+ *
+ * @param {EventTarget} target The target for the event.
+ * @param {number} keyCode The keycode of the keydown and keyup events.
+ * @param {number} keyPressKeyCode The keycode of the keypress event.
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the sequence: false if preventDefault()
+ *     was called on any of the events, true otherwise.
+ */
+goog.testing.events.fireNonAsciiKeySequence = function(
+    target, keyCode, keyPressKeyCode, opt_eventProperties) {
+  var keydown =
+      new goog.testing.events.Event(goog.events.EventType.KEYDOWN, target);
+  var keyup =
+      new goog.testing.events.Event(goog.events.EventType.KEYUP, target);
+  var keypress =
+      new goog.testing.events.Event(goog.events.EventType.KEYPRESS, target);
+  keydown.keyCode = keyup.keyCode = keyCode;
+  keypress.keyCode = keyPressKeyCode;
+
+  if (opt_eventProperties) {
+    goog.object.extend(keydown, opt_eventProperties);
+    goog.object.extend(keyup, opt_eventProperties);
+    goog.object.extend(keypress, opt_eventProperties);
+  }
+
+  // Fire keydown, keypress, and keyup. Note that if the keydown is
+  // prevent-defaulted, then the keypress will not fire.
+  var result = true;
+  if (!goog.testing.events.isBrokenGeckoMacActionKey_(keydown)) {
+    result = goog.testing.events.fireBrowserEvent(keydown);
+  }
+  if (goog.events.KeyCodes.firesKeyPressEvent(
+      keyCode, undefined, keydown.shiftKey, keydown.ctrlKey,
+      keydown.altKey) && result) {
+    result &= goog.testing.events.fireBrowserEvent(keypress);
+  }
+  return !!(result & goog.testing.events.fireBrowserEvent(keyup));
+};
+
+
+/**
+ * @param {goog.testing.events.Event} e The event.
+ * @return {boolean} Whether this is the Gecko/Mac's Meta-C/V/X, which
+ *     is broken and requires special handling.
+ * @private
+ */
+goog.testing.events.isBrokenGeckoMacActionKey_ = function(e) {
+  return goog.userAgent.MAC && goog.userAgent.GECKO &&
+      (e.keyCode == goog.events.KeyCodes.C ||
+       e.keyCode == goog.events.KeyCodes.X ||
+       e.keyCode == goog.events.KeyCodes.V) && e.metaKey;
+};
+
+
+/**
+ * Simulates a mouseenter event on the given target.
+ * @param {!EventTarget} target The target for the event.
+ * @param {?EventTarget} relatedTarget The related target for the event (e.g.,
+ *     the node that the mouse is being moved out of).
+ * @param {!goog.math.Coordinate=} opt_coords Mouse position. Defaults to
+ *     event's target's position (if available), otherwise (0, 0).
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireMouseEnterEvent = function(target, relatedTarget,
+    opt_coords) {
+  var mouseenter =
+      new goog.testing.events.Event(goog.events.EventType.MOUSEENTER, target);
+  mouseenter.relatedTarget = relatedTarget;
+  goog.testing.events.setEventClientXY_(mouseenter, opt_coords);
+  return goog.testing.events.fireBrowserEvent(mouseenter);
+};
+
+
+/**
+ * Simulates a mouseleave event on the given target.
+ * @param {!EventTarget} target The target for the event.
+ * @param {?EventTarget} relatedTarget The related target for the event (e.g.,
+ *     the node that the mouse is being moved into).
+ * @param {!goog.math.Coordinate=} opt_coords Mouse position. Defaults to
+ *     event's target's position (if available), otherwise (0, 0).
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireMouseLeaveEvent = function(target, relatedTarget,
+    opt_coords) {
+  var mouseleave =
+      new goog.testing.events.Event(goog.events.EventType.MOUSELEAVE, target);
+  mouseleave.relatedTarget = relatedTarget;
+  goog.testing.events.setEventClientXY_(mouseleave, opt_coords);
+  return goog.testing.events.fireBrowserEvent(mouseleave);
+};
+
+
+/**
+ * Simulates a mouseover event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {EventTarget} relatedTarget The related target for the event (e.g.,
+ *     the node that the mouse is being moved out of).
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireMouseOverEvent = function(target, relatedTarget,
+    opt_coords) {
+  var mouseover =
+      new goog.testing.events.Event(goog.events.EventType.MOUSEOVER, target);
+  mouseover.relatedTarget = relatedTarget;
+  goog.testing.events.setEventClientXY_(mouseover, opt_coords);
+  return goog.testing.events.fireBrowserEvent(mouseover);
+};
+
+
+/**
+ * Simulates a mousemove event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireMouseMoveEvent = function(target, opt_coords) {
+  var mousemove =
+      new goog.testing.events.Event(goog.events.EventType.MOUSEMOVE, target);
+
+  goog.testing.events.setEventClientXY_(mousemove, opt_coords);
+  return goog.testing.events.fireBrowserEvent(mousemove);
+};
+
+
+/**
+ * Simulates a mouseout event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {EventTarget} relatedTarget The related target for the event (e.g.,
+ *     the node that the mouse is being moved into).
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireMouseOutEvent = function(target, relatedTarget,
+    opt_coords) {
+  var mouseout =
+      new goog.testing.events.Event(goog.events.EventType.MOUSEOUT, target);
+  mouseout.relatedTarget = relatedTarget;
+  goog.testing.events.setEventClientXY_(mouseout, opt_coords);
+  return goog.testing.events.fireBrowserEvent(mouseout);
+};
+
+
+/**
+ * Simulates a mousedown event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;
+ *     defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireMouseDownEvent =
+    function(target, opt_button, opt_coords, opt_eventProperties) {
+
+  var button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;
+  button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?
+      goog.events.BrowserEvent.IEButtonMap[button] : button;
+  return goog.testing.events.fireMouseButtonEvent_(
+      goog.events.EventType.MOUSEDOWN, target, button, opt_coords,
+      opt_eventProperties);
+};
+
+
+/**
+ * Simulates a mouseup event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;
+ *     defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireMouseUpEvent =
+    function(target, opt_button, opt_coords, opt_eventProperties) {
+  var button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;
+  button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?
+      goog.events.BrowserEvent.IEButtonMap[button] : button;
+  return goog.testing.events.fireMouseButtonEvent_(
+      goog.events.EventType.MOUSEUP, target, button, opt_coords,
+      opt_eventProperties);
+};
+
+
+/**
+ * Simulates a click event on the given target. IE only supports click with
+ * the left mouse button.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.events.BrowserEvent.MouseButton=} opt_button Mouse button;
+ *     defaults to {@code goog.events.BrowserEvent.MouseButton.LEFT}.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireClickEvent =
+    function(target, opt_button, opt_coords, opt_eventProperties) {
+  return goog.testing.events.fireMouseButtonEvent_(goog.events.EventType.CLICK,
+      target, opt_button, opt_coords, opt_eventProperties);
+};
+
+
+/**
+ * Simulates a double-click event on the given target. Always double-clicks
+ * with the left mouse button since no browser supports double-clicking with
+ * any other buttons.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireDoubleClickEvent =
+    function(target, opt_coords, opt_eventProperties) {
+  return goog.testing.events.fireMouseButtonEvent_(
+      goog.events.EventType.DBLCLICK, target,
+      goog.events.BrowserEvent.MouseButton.LEFT, opt_coords,
+      opt_eventProperties);
+};
+
+
+/**
+ * Helper function to fire a mouse event.
+ * with the left mouse button since no browser supports double-clicking with
+ * any other buttons.
+ * @param {string} type The event type.
+ * @param {EventTarget} target The target for the event.
+ * @param {number=} opt_button Mouse button; defaults to
+ *     {@code goog.events.BrowserEvent.MouseButton.LEFT}.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ * @private
+ */
+goog.testing.events.fireMouseButtonEvent_ =
+    function(type, target, opt_button, opt_coords, opt_eventProperties) {
+  var e =
+      new goog.testing.events.Event(type, target);
+  e.button = opt_button || goog.events.BrowserEvent.MouseButton.LEFT;
+  goog.testing.events.setEventClientXY_(e, opt_coords);
+  if (opt_eventProperties) {
+    goog.object.extend(e, opt_eventProperties);
+  }
+  return goog.testing.events.fireBrowserEvent(e);
+};
+
+
+/**
+ * Simulates a contextmenu event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireContextMenuEvent = function(target, opt_coords) {
+  var button = (goog.userAgent.MAC && goog.userAgent.WEBKIT) ?
+      goog.events.BrowserEvent.MouseButton.LEFT :
+      goog.events.BrowserEvent.MouseButton.RIGHT;
+  var contextmenu =
+      new goog.testing.events.Event(goog.events.EventType.CONTEXTMENU, target);
+  contextmenu.button = !goog.events.BrowserFeature.HAS_W3C_BUTTON ?
+      goog.events.BrowserEvent.IEButtonMap[button] : button;
+  contextmenu.ctrlKey = goog.userAgent.MAC;
+  goog.testing.events.setEventClientXY_(contextmenu, opt_coords);
+  return goog.testing.events.fireBrowserEvent(contextmenu);
+};
+
+
+/**
+ * Simulates a mousedown, contextmenu, and the mouseup on the given event
+ * target, with the right mouse button.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Mouse position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @return {boolean} The returnValue of the sequence: false if preventDefault()
+ *     was called on any of the events, true otherwise.
+ */
+goog.testing.events.fireContextMenuSequence = function(target, opt_coords) {
+  var props = goog.userAgent.MAC ? {ctrlKey: true} : {};
+  var button = (goog.userAgent.MAC && goog.userAgent.WEBKIT) ?
+      goog.events.BrowserEvent.MouseButton.LEFT :
+      goog.events.BrowserEvent.MouseButton.RIGHT;
+
+  var result = goog.testing.events.fireMouseDownEvent(target,
+      button, opt_coords, props);
+  if (goog.userAgent.WINDOWS) {
+    // All browsers are consistent on Windows.
+    result &= goog.testing.events.fireMouseUpEvent(target,
+        button, opt_coords) &
+              goog.testing.events.fireContextMenuEvent(target, opt_coords);
+  } else {
+    result &= goog.testing.events.fireContextMenuEvent(target, opt_coords);
+
+    // GECKO on Mac and Linux always fires the mouseup after the contextmenu.
+
+    // WEBKIT is really weird.
+    //
+    // On Linux, it sometimes fires mouseup, but most of the time doesn't.
+    // It's really hard to reproduce consistently. I think there's some
+    // internal race condition. If contextmenu is preventDefaulted, then
+    // mouseup always fires.
+    //
+    // On Mac, it always fires mouseup and then fires a click.
+    result &= goog.testing.events.fireMouseUpEvent(target,
+        button, opt_coords, props);
+
+    if (goog.userAgent.WEBKIT && goog.userAgent.MAC) {
+      result &= goog.testing.events.fireClickEvent(
+          target, button, opt_coords, props);
+    }
+  }
+  return !!result;
+};
+
+
+/**
+ * Simulates a popstate event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {Object} state History state object.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.firePopStateEvent = function(target, state) {
+  var e = new goog.testing.events.Event(goog.events.EventType.POPSTATE, target);
+  e.state = state;
+  return goog.testing.events.fireBrowserEvent(e);
+};
+
+
+/**
+ * Simulate a blur event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @return {boolean} The value returned by firing the blur browser event,
+ *      which returns false iff 'preventDefault' was invoked.
+ */
+goog.testing.events.fireBlurEvent = function(target) {
+  var e = new goog.testing.events.Event(
+      goog.events.EventType.BLUR, target);
+  return goog.testing.events.fireBrowserEvent(e);
+};
+
+
+/**
+ * Simulate a focus event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @return {boolean} The value returned by firing the focus browser event,
+ *     which returns false iff 'preventDefault' was invoked.
+ */
+goog.testing.events.fireFocusEvent = function(target) {
+  var e = new goog.testing.events.Event(
+      goog.events.EventType.FOCUS, target);
+  return goog.testing.events.fireBrowserEvent(e);
+};
+
+
+/**
+ * Simulates an event's capturing and bubbling phases.
+ * @param {Event} event A simulated native event. It will be wrapped in a
+ *     normalized BrowserEvent and dispatched to Closure listeners on all
+ *     ancestors of its target (inclusive).
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireBrowserEvent = function(event) {
+  event.returnValue_ = true;
+
+  // generate a list of ancestors
+  var ancestors = [];
+  for (var current = event.target; current; current = current.parentNode) {
+    ancestors.push(current);
+  }
+
+  // dispatch capturing listeners
+  for (var j = ancestors.length - 1;
+       j >= 0 && !event.propagationStopped_;
+       j--) {
+    goog.events.fireListeners(ancestors[j], event.type, true,
+        new goog.events.BrowserEvent(event, ancestors[j]));
+  }
+
+  // dispatch bubbling listeners
+  for (var j = 0;
+       j < ancestors.length && !event.propagationStopped_;
+       j++) {
+    goog.events.fireListeners(ancestors[j], event.type, false,
+        new goog.events.BrowserEvent(event, ancestors[j]));
+  }
+
+  return event.returnValue_;
+};
+
+
+/**
+ * Simulates a touchstart event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireTouchStartEvent = function(
+    target, opt_coords, opt_eventProperties) {
+  // TODO: Support multi-touch events with array of coordinates.
+  var touchstart =
+      new goog.testing.events.Event(goog.events.EventType.TOUCHSTART, target);
+  goog.testing.events.setEventClientXY_(touchstart, opt_coords);
+  if (opt_eventProperties) {
+    goog.object.extend(touchstart, opt_eventProperties);
+  }
+  return goog.testing.events.fireBrowserEvent(touchstart);
+};
+
+
+/**
+ * Simulates a touchmove event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireTouchMoveEvent = function(
+    target, opt_coords, opt_eventProperties) {
+  // TODO: Support multi-touch events with array of coordinates.
+  var touchmove =
+      new goog.testing.events.Event(goog.events.EventType.TOUCHMOVE, target);
+  goog.testing.events.setEventClientXY_(touchmove, opt_coords);
+  if (opt_eventProperties) {
+    goog.object.extend(touchmove, opt_eventProperties);
+  }
+  return goog.testing.events.fireBrowserEvent(touchmove);
+};
+
+
+/**
+ * Simulates a touchend event on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event's
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the event: false if preventDefault() was
+ *     called on it, true otherwise.
+ */
+goog.testing.events.fireTouchEndEvent = function(
+    target, opt_coords, opt_eventProperties) {
+  // TODO: Support multi-touch events with array of coordinates.
+  var touchend =
+      new goog.testing.events.Event(goog.events.EventType.TOUCHEND, target);
+  goog.testing.events.setEventClientXY_(touchend, opt_coords);
+  if (opt_eventProperties) {
+    goog.object.extend(touchend, opt_eventProperties);
+  }
+  return goog.testing.events.fireBrowserEvent(touchend);
+};
+
+
+/**
+ * Simulates a simple touch sequence on the given target.
+ * @param {EventTarget} target The target for the event.
+ * @param {goog.math.Coordinate=} opt_coords Touch position. Defaults to event
+ *     target's position (if available), otherwise (0, 0).
+ * @param {Object=} opt_eventProperties Event properties to be mixed into the
+ *     BrowserEvent.
+ * @return {boolean} The returnValue of the sequence: false if preventDefault()
+ *     was called on any of the events, true otherwise.
+ */
+goog.testing.events.fireTouchSequence = function(
+    target, opt_coords, opt_eventProperties) {
+  // TODO: Support multi-touch events with array of coordinates.
+  // Fire touchstart, touchmove, touchend then return the bitwise AND of the 3.
+  return !!(goog.testing.events.fireTouchStartEvent(
+      target, opt_coords, opt_eventProperties) &
+            goog.testing.events.fireTouchEndEvent(
+                target, opt_coords, opt_eventProperties));
+};
+
+
+/**
+ * Mixins a listenable into the given object. This turns the object
+ * into a goog.events.Listenable. This is useful, for example, when
+ * you need to mock a implementation of listenable and still want it
+ * to work with goog.events.
+ * @param {!Object} obj The object to mixin into.
+ */
+goog.testing.events.mixinListenable = function(obj) {
+  var listenable = new goog.events.EventTarget();
+
+  listenable.setTargetForTesting(obj);
+
+  var listenablePrototype = goog.events.EventTarget.prototype;
+  var disposablePrototype = goog.Disposable.prototype;
+  for (var key in listenablePrototype) {
+    if (listenablePrototype.hasOwnProperty(key) ||
+        disposablePrototype.hasOwnProperty(key)) {
+      var member = listenablePrototype[key];
+      if (goog.isFunction(member)) {
+        obj[key] = goog.bind(member, listenable);
+      } else {
+        obj[key] = member;
+      }
+    }
+  }
+};
diff --git a/lib/goog/testing/functionmock.js b/lib/goog/testing/functionmock.js
new file mode 100644
index 0000000..a14f6eb
--- /dev/null
+++ b/lib/goog/testing/functionmock.js
@@ -0,0 +1,175 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Enable mocking of functions not attached to objects
+ * whether they be global / top-level or anonymous methods / closures.
+ *
+ * See the unit tests for usage.
+ *
+ */
+
+goog.provide('goog.testing');
+goog.provide('goog.testing.FunctionMock');
+goog.provide('goog.testing.GlobalFunctionMock');
+goog.provide('goog.testing.MethodMock');
+
+goog.require('goog.object');
+goog.require('goog.testing.LooseMock');
+goog.require('goog.testing.Mock');
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.StrictMock');
+
+
+/**
+ * Class used to mock a function. Useful for mocking closures and anonymous
+ * callbacks etc. Creates a function object that extends goog.testing.Mock.
+ * @param {string=} opt_functionName The optional name of the function to mock.
+ *     Set to '[anonymous mocked function]' if not passed in.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked function.
+ * @suppress {missingProperties} Mocks do not fit in the type system well.
+ */
+goog.testing.FunctionMock = function(opt_functionName, opt_strictness) {
+  var fn = function() {
+    var args = Array.prototype.slice.call(arguments);
+    args.splice(0, 0, opt_functionName || '[anonymous mocked function]');
+    return fn.$mockMethod.apply(fn, args);
+  };
+  var base = opt_strictness === goog.testing.Mock.LOOSE ?
+      goog.testing.LooseMock : goog.testing.StrictMock;
+  goog.object.extend(fn, new base({}));
+
+  return /** @type {!goog.testing.MockInterface} */ (fn);
+};
+
+
+/**
+ * Mocks an existing function. Creates a goog.testing.FunctionMock
+ * and registers it in the given scope with the name specified by functionName.
+ * @param {Object} scope The scope of the method to be mocked out.
+ * @param {string} functionName The name of the function we're going to mock.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked method.
+ */
+goog.testing.MethodMock = function(scope, functionName, opt_strictness) {
+  if (!(functionName in scope)) {
+    throw Error(functionName + ' is not a property of the given scope.');
+  }
+
+  var fn = goog.testing.FunctionMock(functionName, opt_strictness);
+
+  fn.$propertyReplacer_ = new goog.testing.PropertyReplacer();
+  fn.$propertyReplacer_.set(scope, functionName, fn);
+  fn.$tearDown = goog.testing.MethodMock.$tearDown;
+
+  return fn;
+};
+
+
+/**
+ * Resets the global function that we mocked back to its original state.
+ * @this {goog.testing.MockInterface}
+ */
+goog.testing.MethodMock.$tearDown = function() {
+  this.$propertyReplacer_.reset();
+};
+
+
+/**
+ * Mocks a global / top-level function. Creates a goog.testing.MethodMock
+ * in the global scope with the name specified by functionName.
+ * @param {string} functionName The name of the function we're going to mock.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked global function.
+ */
+goog.testing.GlobalFunctionMock = function(functionName, opt_strictness) {
+  return goog.testing.MethodMock(goog.global, functionName, opt_strictness);
+};
+
+
+/**
+ * Convenience method for creating a mock for a function.
+ * @param {string=} opt_functionName The optional name of the function to mock
+ *     set to '[anonymous mocked function]' if not passed in.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked function.
+ */
+goog.testing.createFunctionMock = function(opt_functionName, opt_strictness) {
+  return goog.testing.FunctionMock(opt_functionName, opt_strictness);
+};
+
+
+/**
+ * Convenience method for creating a mock for a method.
+ * @param {Object} scope The scope of the method to be mocked out.
+ * @param {string} functionName The name of the function we're going to mock.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked global function.
+ */
+goog.testing.createMethodMock = function(scope, functionName, opt_strictness) {
+  return goog.testing.MethodMock(scope, functionName, opt_strictness);
+};
+
+
+/**
+ * Convenience method for creating a mock for a constructor. Copies class
+ * members to the mock.
+ *
+ * <p>When mocking a constructor to return a mocked instance, remember to create
+ * the instance mock before mocking the constructor. If you mock the constructor
+ * first, then the mock framework will be unable to examine the prototype chain
+ * when creating the mock instance.
+ * @param {Object} scope The scope of the constructor to be mocked out.
+ * @param {string} constructorName The name of the constructor we're going to
+ *     mock.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked constructor.
+ */
+goog.testing.createConstructorMock = function(scope, constructorName,
+                                              opt_strictness) {
+  var realConstructor = scope[constructorName];
+  var constructorMock = goog.testing.MethodMock(scope, constructorName,
+                                                opt_strictness);
+
+  // Copy class members from the real constructor to the mock. Do not copy
+  // the closure superClass_ property (see goog.inherits), the built-in
+  // prototype property, or properties added to Function.prototype
+  for (var property in realConstructor) {
+    if (property != 'superClass_' &&
+        property != 'prototype' &&
+        realConstructor.hasOwnProperty(property)) {
+      constructorMock[property] = realConstructor[property];
+    }
+  }
+  return constructorMock;
+};
+
+
+/**
+ * Convenience method for creating a mocks for a global / top-level function.
+ * @param {string} functionName The name of the function we're going to mock.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked global function.
+ */
+goog.testing.createGlobalFunctionMock = function(functionName, opt_strictness) {
+  return goog.testing.GlobalFunctionMock(functionName, opt_strictness);
+};
diff --git a/lib/goog/testing/jsunit.js b/lib/goog/testing/jsunit.js
new file mode 100644
index 0000000..7d9cde0
--- /dev/null
+++ b/lib/goog/testing/jsunit.js
@@ -0,0 +1,162 @@
+// Copyright 2007 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Utilities for working with JsUnit.  Writes out the JsUnit file
+ * that needs to be included in every unit test.
+ *
+ * Testing code should not have dependencies outside of goog.testing so as to
+ * reduce the chance of masking missing dependencies.
+ *
+ */
+
+goog.provide('goog.testing.jsunit');
+
+goog.require('goog.dom.TagName');
+goog.require('goog.testing.TestCase');
+goog.require('goog.testing.TestRunner');
+
+
+/**
+ * Base path for JsUnit app files, relative to Closure's base path.
+ * @type {string}
+ */
+goog.testing.jsunit.BASE_PATH =
+    '../../third_party/java/jsunit/core/app/';
+
+
+/**
+ * Filename for the core JS Unit script.
+ * @type {string}
+ */
+goog.testing.jsunit.CORE_SCRIPT =
+    goog.testing.jsunit.BASE_PATH + 'jsUnitCore.js';
+
+
+/**
+ * @define {boolean} If this code is being parsed by JsTestC, we let it disable
+ * the onload handler to avoid running the test in JsTestC.
+ */
+goog.define('goog.testing.jsunit.AUTO_RUN_ONLOAD', true);
+
+
+/**
+ * @define {number} Sets a delay in milliseconds after the window onload event
+ * and running the tests. Used to prevent interference with Selenium and give
+ * tests with asynchronous operations time to finish loading.
+ */
+goog.define('goog.testing.jsunit.AUTO_RUN_DELAY_IN_MS', 500);
+
+
+(function() {
+  // Only allow one global test runner to be created on a page.
+  if (goog.global['G_testRunner'] instanceof goog.testing.TestRunner) {
+    return;
+  }
+
+  // Increases the maximum number of stack frames in Google Chrome from the
+  // default 10 to 50 to get more useful stack traces.
+  Error.stackTraceLimit = 50;
+
+  // Store a reference to the window's timeout so that it can't be overridden
+  // by tests.
+  /** @type {!Function} */
+  var realTimeout = window.setTimeout;
+
+  // Check for JsUnit's test runner (need to check for >2.2 and <=2.2)
+  if (top['JsUnitTestManager'] || top['jsUnitTestManager']) {
+    // Running inside JsUnit so add support code.
+    var path = goog.basePath + goog.testing.jsunit.CORE_SCRIPT;
+    document.write('<script type="text/javascript" src="' +
+                   path + '"></' + 'script>');
+
+  } else {
+
+    // Create a test runner.
+    var tr = new goog.testing.TestRunner();
+
+    // Export it so that it can be queried by Selenium and tests that use a
+    // compiled test runner.
+    goog.exportSymbol('G_testRunner', tr);
+    goog.exportSymbol('G_testRunner.initialize', tr.initialize);
+    goog.exportSymbol('G_testRunner.isInitialized', tr.isInitialized);
+    goog.exportSymbol('G_testRunner.isFinished', tr.isFinished);
+    goog.exportSymbol('G_testRunner.isSuccess', tr.isSuccess);
+    goog.exportSymbol('G_testRunner.getReport', tr.getReport);
+    goog.exportSymbol('G_testRunner.getRunTime', tr.getRunTime);
+    goog.exportSymbol('G_testRunner.getNumFilesLoaded', tr.getNumFilesLoaded);
+    goog.exportSymbol('G_testRunner.setStrict', tr.setStrict);
+    goog.exportSymbol('G_testRunner.logTestFailure', tr.logTestFailure);
+    goog.exportSymbol('G_testRunner.getTestResults', tr.getTestResults);
+
+    // Export debug as a global function for JSUnit compatibility.  This just
+    // calls log on the current test case.
+    if (!goog.global['debug']) {
+      goog.exportSymbol('debug', goog.bind(tr.log, tr));
+    }
+
+    // If the application has defined a global error filter, set it now.  This
+    // allows users who use a base test include to set the error filter before
+    // the testing code is loaded.
+    if (goog.global['G_errorFilter']) {
+      tr.setErrorFilter(goog.global['G_errorFilter']);
+    }
+
+    // Add an error handler to report errors that may occur during
+    // initialization of the page.
+    var onerror = window.onerror;
+    window.onerror = function(error, url, line) {
+      // Call any existing onerror handlers.
+      if (onerror) {
+        onerror(error, url, line);
+      }
+      if (typeof error == 'object') {
+        // Webkit started passing an event object as the only argument to
+        // window.onerror.  It doesn't contain an error message, url or line
+        // number.  We therefore log as much info as we can.
+        if (error.target && error.target.tagName == goog.dom.TagName.SCRIPT) {
+          tr.logError('UNKNOWN ERROR: Script ' + error.target.src);
+        } else {
+          tr.logError('UNKNOWN ERROR: No error information available.');
+        }
+      } else {
+        tr.logError('JS ERROR: ' + error + '\nURL: ' + url + '\nLine: ' + line);
+      }
+    };
+
+    // Create an onload handler, if the test runner hasn't been initialized then
+    // no test has been registered with the test runner by the test file.  We
+    // then create a new test case and auto discover any tests in the global
+    // scope. If this code is being parsed by JsTestC, we let it disable the
+    // onload handler to avoid running the test in JsTestC.
+    if (goog.testing.jsunit.AUTO_RUN_ONLOAD) {
+      var onload = window.onload;
+      window.onload = function(e) {
+        // Call any existing onload handlers.
+        if (onload) {
+          onload(e);
+        }
+        // Wait so that we don't interfere with WebDriver.
+        realTimeout(function() {
+          if (!tr.initialized) {
+            var testCase = new goog.testing.TestCase(document.title);
+            goog.testing.TestCase.initializeTestRunner(testCase);
+          }
+          tr.execute();
+        }, goog.testing.jsunit.AUTO_RUN_DELAY_IN_MS);
+        window.onload = null;
+      };
+    }
+  }
+})();
diff --git a/lib/goog/testing/loosemock.js b/lib/goog/testing/loosemock.js
new file mode 100644
index 0000000..cef72d7
--- /dev/null
+++ b/lib/goog/testing/loosemock.js
@@ -0,0 +1,242 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview This file defines a loose mock implementation.
+ */
+
+goog.provide('goog.testing.LooseExpectationCollection');
+goog.provide('goog.testing.LooseMock');
+
+goog.require('goog.array');
+goog.require('goog.structs.Map');
+goog.require('goog.testing.Mock');
+
+
+
+/**
+ * This class is an ordered collection of expectations for one method. Since
+ * the loose mock does most of its verification at the time of $verify, this
+ * class is necessary to manage the return/throw behavior when the mock is
+ * being called.
+ * @constructor
+ * @final
+ */
+goog.testing.LooseExpectationCollection = function() {
+  /**
+   * The list of expectations. All of these should have the same name.
+   * @type {Array<goog.testing.MockExpectation>}
+   * @private
+   */
+  this.expectations_ = [];
+};
+
+
+/**
+ * Adds an expectation to this collection.
+ * @param {goog.testing.MockExpectation} expectation The expectation to add.
+ */
+goog.testing.LooseExpectationCollection.prototype.addExpectation =
+    function(expectation) {
+  this.expectations_.push(expectation);
+};
+
+
+/**
+ * Gets the list of expectations in this collection.
+ * @return {Array<goog.testing.MockExpectation>} The array of expectations.
+ */
+goog.testing.LooseExpectationCollection.prototype.getExpectations = function() {
+  return this.expectations_;
+};
+
+
+
+/**
+ * This is a mock that does not care about the order of method calls. As a
+ * result, it won't throw exceptions until verify() is called. The only
+ * exception is that if a method is called that has no expectations, then an
+ * exception will be thrown.
+ * @param {Object|Function} objectToMock The object that should be mocked, or
+ *    the constructor of an object to mock.
+ * @param {boolean=} opt_ignoreUnexpectedCalls Whether to ignore unexpected
+ *     calls.
+ * @param {boolean=} opt_mockStaticMethods An optional argument denoting that
+ *     a mock should be constructed from the static functions of a class.
+ * @param {boolean=} opt_createProxy An optional argument denoting that
+ *     a proxy for the target mock should be created.
+ * @constructor
+ * @extends {goog.testing.Mock}
+ */
+goog.testing.LooseMock = function(objectToMock, opt_ignoreUnexpectedCalls,
+    opt_mockStaticMethods, opt_createProxy) {
+  goog.testing.Mock.call(this, objectToMock, opt_mockStaticMethods,
+      opt_createProxy);
+
+  /**
+   * A map of method names to a LooseExpectationCollection for that method.
+   * @type {goog.structs.Map}
+   * @private
+   */
+  this.$expectations_ = new goog.structs.Map();
+
+  /**
+   * The calls that have been made; we cache them to verify at the end. Each
+   * element is an array where the first element is the name, and the second
+   * element is the arguments.
+   * @type {Array<Array<*>>}
+   * @private
+   */
+  this.$calls_ = [];
+
+  /**
+   * Whether to ignore unexpected calls.
+   * @type {boolean}
+   * @private
+   */
+  this.$ignoreUnexpectedCalls_ = !!opt_ignoreUnexpectedCalls;
+};
+goog.inherits(goog.testing.LooseMock, goog.testing.Mock);
+
+
+/**
+ * A setter for the ignoreUnexpectedCalls field.
+ * @param {boolean} ignoreUnexpectedCalls Whether to ignore unexpected calls.
+ * @return {!goog.testing.LooseMock} This mock object.
+ */
+goog.testing.LooseMock.prototype.$setIgnoreUnexpectedCalls = function(
+    ignoreUnexpectedCalls) {
+  this.$ignoreUnexpectedCalls_ = ignoreUnexpectedCalls;
+  return this;
+};
+
+
+/** @override */
+goog.testing.LooseMock.prototype.$recordExpectation = function() {
+  if (!this.$expectations_.containsKey(this.$pendingExpectation.name)) {
+    this.$expectations_.set(this.$pendingExpectation.name,
+        new goog.testing.LooseExpectationCollection());
+  }
+
+  var collection = this.$expectations_.get(this.$pendingExpectation.name);
+  collection.addExpectation(this.$pendingExpectation);
+};
+
+
+/** @override */
+goog.testing.LooseMock.prototype.$recordCall = function(name, args) {
+  if (!this.$expectations_.containsKey(name)) {
+    if (this.$ignoreUnexpectedCalls_) {
+      return;
+    }
+    this.$throwCallException(name, args);
+  }
+
+  // Start from the beginning of the expectations for this name,
+  // and iterate over them until we find an expectation that matches
+  // and also has calls remaining.
+  var collection = this.$expectations_.get(name);
+  var matchingExpectation = null;
+  var expectations = collection.getExpectations();
+  for (var i = 0; i < expectations.length; i++) {
+    var expectation = expectations[i];
+    if (this.$verifyCall(expectation, name, args)) {
+      matchingExpectation = expectation;
+      if (expectation.actualCalls < expectation.maxCalls) {
+        break;
+      } // else continue and see if we can find something that does match
+    }
+  }
+  if (matchingExpectation == null) {
+    this.$throwCallException(name, args, expectation);
+  }
+
+  matchingExpectation.actualCalls++;
+  if (matchingExpectation.actualCalls > matchingExpectation.maxCalls) {
+    this.$throwException('Too many calls to ' + matchingExpectation.name +
+            '\nExpected: ' + matchingExpectation.maxCalls + ' but was: ' +
+            matchingExpectation.actualCalls);
+  }
+
+  this.$calls_.push([name, args]);
+  return this.$do(matchingExpectation, args);
+};
+
+
+/** @override */
+goog.testing.LooseMock.prototype.$reset = function() {
+  goog.testing.LooseMock.superClass_.$reset.call(this);
+
+  this.$expectations_ = new goog.structs.Map();
+  this.$calls_ = [];
+};
+
+
+/** @override */
+goog.testing.LooseMock.prototype.$replay = function() {
+  goog.testing.LooseMock.superClass_.$replay.call(this);
+
+  // Verify that there are no expectations that can never be reached.
+  // This can't catch every situation, but it is a decent sanity check
+  // and it's similar to the behavior of EasyMock in java.
+  var collections = this.$expectations_.getValues();
+  for (var i = 0; i < collections.length; i++) {
+    var expectations = collections[i].getExpectations();
+    for (var j = 0; j < expectations.length; j++) {
+      var expectation = expectations[j];
+      // If this expectation can be called infinite times, then
+      // check if any subsequent expectation has the exact same
+      // argument list.
+      if (!isFinite(expectation.maxCalls)) {
+        for (var k = j + 1; k < expectations.length; k++) {
+          var laterExpectation = expectations[k];
+          if (laterExpectation.minCalls > 0 &&
+              goog.array.equals(expectation.argumentList,
+                  laterExpectation.argumentList)) {
+            var name = expectation.name;
+            var argsString = this.$argumentsAsString(expectation.argumentList);
+            this.$throwException([
+              'Expected call to ', name, ' with arguments ', argsString,
+              ' has an infinite max number of calls; can\'t expect an',
+              ' identical call later with a positive min number of calls'
+            ].join(''));
+          }
+        }
+      }
+    }
+  }
+};
+
+
+/** @override */
+goog.testing.LooseMock.prototype.$verify = function() {
+  goog.testing.LooseMock.superClass_.$verify.call(this);
+  var collections = this.$expectations_.getValues();
+
+  for (var i = 0; i < collections.length; i++) {
+    var expectations = collections[i].getExpectations();
+    for (var j = 0; j < expectations.length; j++) {
+      var expectation = expectations[j];
+      if (expectation.actualCalls > expectation.maxCalls) {
+        this.$throwException('Too many calls to ' + expectation.name +
+            '\nExpected: ' + expectation.maxCalls + ' but was: ' +
+            expectation.actualCalls);
+      } else if (expectation.actualCalls < expectation.minCalls) {
+        this.$throwException('Not enough calls to ' + expectation.name +
+            '\nExpected: ' + expectation.minCalls + ' but was: ' +
+            expectation.actualCalls);
+      }
+    }
+  }
+};
diff --git a/lib/goog/testing/mock.js b/lib/goog/testing/mock.js
new file mode 100644
index 0000000..96b5b29
--- /dev/null
+++ b/lib/goog/testing/mock.js
@@ -0,0 +1,645 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview This file defines base classes used for creating mocks in
+ * JavaScript. The API was inspired by EasyMock.
+ *
+ * The basic API is:
+ * <ul>
+ *   <li>Create an object to be mocked
+ *   <li>Create a mock object, passing in the above object to the constructor
+ *   <li>Set expectations by calling methods on the mock object
+ *   <li>Call $replay() on the mock object
+ *   <li>Pass the mock to code that will make real calls on it
+ *   <li>Call $verify() to make sure that expectations were met
+ * </ul>
+ *
+ * For examples, please see the unit tests for LooseMock and StrictMock.
+ *
+ * Still TODO
+ *   implement better (and pluggable) argument matching
+ *   Have the exceptions for LooseMock show the number of expected/actual calls
+ *   loose and strict mocks share a lot of code - move it to the base class
+ *
+ */
+
+goog.provide('goog.testing.Mock');
+goog.provide('goog.testing.MockExpectation');
+
+goog.require('goog.array');
+goog.require('goog.object');
+goog.require('goog.testing.JsUnitException');
+goog.require('goog.testing.MockInterface');
+goog.require('goog.testing.mockmatchers');
+
+
+
+/**
+ * This is a class that represents an expectation.
+ * @param {string} name The name of the method for this expectation.
+ * @constructor
+ * @final
+ */
+goog.testing.MockExpectation = function(name) {
+  /**
+   * The name of the method that is expected to be called.
+   * @type {string}
+   */
+  this.name = name;
+
+  /**
+   * An array of error messages for expectations not met.
+   * @type {Array<string>}
+   */
+  this.errorMessages = [];
+};
+
+
+/**
+ * The minimum number of times this method should be called.
+ * @type {number}
+ */
+goog.testing.MockExpectation.prototype.minCalls = 1;
+
+
+/**
+  * The maximum number of times this method should be called.
+  * @type {number}
+  */
+goog.testing.MockExpectation.prototype.maxCalls = 1;
+
+
+/**
+ * The value that this method should return.
+ * @type {*}
+ */
+goog.testing.MockExpectation.prototype.returnValue;
+
+
+/**
+ * The value that will be thrown when the method is called
+ * @type {*}
+ */
+goog.testing.MockExpectation.prototype.exceptionToThrow;
+
+
+/**
+ * The arguments that are expected to be passed to this function
+ * @type {Array<*>}
+ */
+goog.testing.MockExpectation.prototype.argumentList;
+
+
+/**
+ * The number of times this method is called by real code.
+ * @type {number}
+ */
+goog.testing.MockExpectation.prototype.actualCalls = 0;
+
+
+/**
+ * The number of times this method is called during the verification phase.
+ * @type {number}
+ */
+goog.testing.MockExpectation.prototype.verificationCalls = 0;
+
+
+/**
+ * The function which will be executed when this method is called.
+ * Method arguments will be passed to this function, and return value
+ * of this function will be returned by the method.
+ * @type {Function}
+ */
+goog.testing.MockExpectation.prototype.toDo;
+
+
+/**
+ * Allow expectation failures to include messages.
+ * @param {string} message The failure message.
+ */
+goog.testing.MockExpectation.prototype.addErrorMessage = function(message) {
+  this.errorMessages.push(message);
+};
+
+
+/**
+ * Get the error messages seen so far.
+ * @return {string} Error messages separated by \n.
+ */
+goog.testing.MockExpectation.prototype.getErrorMessage = function() {
+  return this.errorMessages.join('\n');
+};
+
+
+/**
+ * Get how many error messages have been seen so far.
+ * @return {number} Count of error messages.
+ */
+goog.testing.MockExpectation.prototype.getErrorMessageCount = function() {
+  return this.errorMessages.length;
+};
+
+
+
+/**
+ * The base class for a mock object.
+ * @param {Object|Function} objectToMock The object that should be mocked, or
+ *    the constructor of an object to mock.
+ * @param {boolean=} opt_mockStaticMethods An optional argument denoting that
+ *     a mock should be constructed from the static functions of a class.
+ * @param {boolean=} opt_createProxy An optional argument denoting that
+ *     a proxy for the target mock should be created.
+ * @constructor
+ * @implements {goog.testing.MockInterface}
+ */
+goog.testing.Mock = function(objectToMock, opt_mockStaticMethods,
+    opt_createProxy) {
+  if (!goog.isObject(objectToMock) && !goog.isFunction(objectToMock)) {
+    throw new Error('objectToMock must be an object or constructor.');
+  }
+  if (opt_createProxy && !opt_mockStaticMethods &&
+      goog.isFunction(objectToMock)) {
+    /**
+ * @constructor
+ * @final
+ */
+    var tempCtor = function() {};
+    goog.inherits(tempCtor, objectToMock);
+    this.$proxy = new tempCtor();
+  } else if (opt_createProxy && opt_mockStaticMethods &&
+      goog.isFunction(objectToMock)) {
+    throw Error('Cannot create a proxy when opt_mockStaticMethods is true');
+  } else if (opt_createProxy && !goog.isFunction(objectToMock)) {
+    throw Error('Must have a constructor to create a proxy');
+  }
+
+  if (goog.isFunction(objectToMock) && !opt_mockStaticMethods) {
+    this.$initializeFunctions_(objectToMock.prototype);
+  } else {
+    this.$initializeFunctions_(objectToMock);
+  }
+  this.$argumentListVerifiers_ = {};
+};
+
+
+/**
+ * Option that may be passed when constructing function, method, and
+ * constructor mocks. Indicates that the expected calls should be accepted in
+ * any order.
+ * @const
+ * @type {number}
+ */
+goog.testing.Mock.LOOSE = 1;
+
+
+/**
+ * Option that may be passed when constructing function, method, and
+ * constructor mocks. Indicates that the expected calls should be accepted in
+ * the recorded order only.
+ * @const
+ * @type {number}
+ */
+goog.testing.Mock.STRICT = 0;
+
+
+/**
+ * This array contains the name of the functions that are part of the base
+ * Object prototype.
+ * Basically a copy of goog.object.PROTOTYPE_FIELDS_.
+ * @const
+ * @type {!Array<string>}
+ * @private
+ */
+goog.testing.Mock.PROTOTYPE_FIELDS_ = [
+  'constructor',
+  'hasOwnProperty',
+  'isPrototypeOf',
+  'propertyIsEnumerable',
+  'toLocaleString',
+  'toString',
+  'valueOf'
+];
+
+
+/**
+ * A proxy for the mock.  This can be used for dependency injection in lieu of
+ * the mock if the test requires a strict instanceof check.
+ * @type {Object}
+ */
+goog.testing.Mock.prototype.$proxy = null;
+
+
+/**
+ * Map of argument name to optional argument list verifier function.
+ * @type {Object}
+ */
+goog.testing.Mock.prototype.$argumentListVerifiers_;
+
+
+/**
+ * Whether or not we are in recording mode.
+ * @type {boolean}
+ * @private
+ */
+goog.testing.Mock.prototype.$recording_ = true;
+
+
+/**
+ * The expectation currently being created. All methods that modify the
+ * current expectation return the Mock object for easy chaining, so this is
+ * where we keep track of the expectation that's currently being modified.
+ * @type {goog.testing.MockExpectation}
+ * @protected
+ */
+goog.testing.Mock.prototype.$pendingExpectation;
+
+
+/**
+ * First exception thrown by this mock; used in $verify.
+ * @type {Object}
+ * @private
+ */
+goog.testing.Mock.prototype.$threwException_ = null;
+
+
+/**
+ * Initializes the functions on the mock object.
+ * @param {Object} objectToMock The object being mocked.
+ * @private
+ */
+goog.testing.Mock.prototype.$initializeFunctions_ = function(objectToMock) {
+  // Gets the object properties.
+  var enumerableProperties = goog.object.getKeys(objectToMock);
+
+  // The non enumerable properties are added if they override the ones in the
+  // Object prototype. This is due to the fact that IE8 does not enumerate any
+  // of the prototype Object functions even when overriden and mocking these is
+  // sometimes needed.
+  for (var i = 0; i < goog.testing.Mock.PROTOTYPE_FIELDS_.length; i++) {
+    var prop = goog.testing.Mock.PROTOTYPE_FIELDS_[i];
+    // Look at b/6758711 if you're considering adding ALL properties to ALL
+    // mocks.
+    if (objectToMock[prop] !== Object.prototype[prop]) {
+      enumerableProperties.push(prop);
+    }
+  }
+
+  // Adds the properties to the mock.
+  for (var i = 0; i < enumerableProperties.length; i++) {
+    var prop = enumerableProperties[i];
+    if (typeof objectToMock[prop] == 'function') {
+      this[prop] = goog.bind(this.$mockMethod, this, prop);
+      if (this.$proxy) {
+        this.$proxy[prop] = goog.bind(this.$mockMethod, this, prop);
+      }
+    }
+  }
+};
+
+
+/**
+ * Registers a verifier function to use when verifying method argument lists.
+ * @param {string} methodName The name of the method for which the verifierFn
+ *     should be used.
+ * @param {Function} fn Argument list verifier function.  Should take 2 argument
+ *     arrays as arguments, and return true if they are considered equivalent.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$registerArgumentListVerifier = function(methodName,
+                                                                     fn) {
+  this.$argumentListVerifiers_[methodName] = fn;
+  return this;
+};
+
+
+/**
+ * The function that replaces all methods on the mock object.
+ * @param {string} name The name of the method being mocked.
+ * @return {*} In record mode, returns the mock object. In replay mode, returns
+ *    whatever the creator of the mock set as the return value.
+ */
+goog.testing.Mock.prototype.$mockMethod = function(name) {
+  try {
+    // Shift off the name argument so that args contains the arguments to
+    // the mocked method.
+    var args = goog.array.slice(arguments, 1);
+    if (this.$recording_) {
+      this.$pendingExpectation = new goog.testing.MockExpectation(name);
+      this.$pendingExpectation.argumentList = args;
+      this.$recordExpectation();
+      return this;
+    } else {
+      return this.$recordCall(name, args);
+    }
+  } catch (ex) {
+    this.$recordAndThrow(ex);
+  }
+};
+
+
+/**
+ * Records the currently pending expectation, intended to be overridden by a
+ * subclass.
+ * @protected
+ */
+goog.testing.Mock.prototype.$recordExpectation = function() {};
+
+
+/**
+ * Records an actual method call, intended to be overridden by a
+ * subclass. The subclass must find the pending expectation and return the
+ * correct value.
+ * @param {string} name The name of the method being called.
+ * @param {Array<?>} args The arguments to the method.
+ * @return {*} The return expected by the mock.
+ * @protected
+ */
+goog.testing.Mock.prototype.$recordCall = function(name, args) {
+  return undefined;
+};
+
+
+/**
+ * If the expectation expects to throw, this method will throw.
+ * @param {goog.testing.MockExpectation} expectation The expectation.
+ */
+goog.testing.Mock.prototype.$maybeThrow = function(expectation) {
+  if (typeof expectation.exceptionToThrow != 'undefined') {
+    throw expectation.exceptionToThrow;
+  }
+};
+
+
+/**
+ * If this expectation defines a function to be called,
+ * it will be called and its result will be returned.
+ * Otherwise, if the expectation expects to throw, it will throw.
+ * Otherwise, this method will return defined value.
+ * @param {goog.testing.MockExpectation} expectation The expectation.
+ * @param {Array<?>} args The arguments to the method.
+ * @return {*} The return value expected by the mock.
+ */
+goog.testing.Mock.prototype.$do = function(expectation, args) {
+  if (typeof expectation.toDo == 'undefined') {
+    this.$maybeThrow(expectation);
+    return expectation.returnValue;
+  } else {
+    return expectation.toDo.apply(this, args);
+  }
+};
+
+
+/**
+ * Specifies a return value for the currently pending expectation.
+ * @param {*} val The return value.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$returns = function(val) {
+  this.$pendingExpectation.returnValue = val;
+  return this;
+};
+
+
+/**
+ * Specifies a value for the currently pending expectation to throw.
+ * @param {*} val The value to throw.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$throws = function(val) {
+  this.$pendingExpectation.exceptionToThrow = val;
+  return this;
+};
+
+
+/**
+ * Specifies a function to call for currently pending expectation.
+ * Note, that using this method overrides declarations made
+ * using $returns() and $throws() methods.
+ * @param {Function} func The function to call.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$does = function(func) {
+  this.$pendingExpectation.toDo = func;
+  return this;
+};
+
+
+/**
+ * Allows the expectation to be called 0 or 1 times.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$atMostOnce = function() {
+  this.$pendingExpectation.minCalls = 0;
+  this.$pendingExpectation.maxCalls = 1;
+  return this;
+};
+
+
+/**
+ * Allows the expectation to be called any number of times, as long as it's
+ * called once.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$atLeastOnce = function() {
+  this.$pendingExpectation.maxCalls = Infinity;
+  return this;
+};
+
+
+/**
+ * Allows the expectation to be called exactly once.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$once = function() {
+  this.$pendingExpectation.minCalls = 1;
+  this.$pendingExpectation.maxCalls = 1;
+  return this;
+};
+
+
+/**
+ * Disallows the expectation from being called.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$never = function() {
+  this.$pendingExpectation.minCalls = 0;
+  this.$pendingExpectation.maxCalls = 0;
+  return this;
+};
+
+
+/**
+ * Allows the expectation to be called any number of times.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$anyTimes = function() {
+  this.$pendingExpectation.minCalls = 0;
+  this.$pendingExpectation.maxCalls = Infinity;
+  return this;
+};
+
+
+/**
+ * Specifies the number of times the expectation should be called.
+ * @param {number} times The number of times this method will be called.
+ * @return {!goog.testing.Mock} This mock object.
+ */
+goog.testing.Mock.prototype.$times = function(times) {
+  this.$pendingExpectation.minCalls = times;
+  this.$pendingExpectation.maxCalls = times;
+  return this;
+};
+
+
+/**
+ * Switches from recording to replay mode.
+ * @override
+ */
+goog.testing.Mock.prototype.$replay = function() {
+  this.$recording_ = false;
+};
+
+
+/**
+ * Resets the state of this mock object. This clears all pending expectations
+ * without verifying, and puts the mock in recording mode.
+ * @override
+ */
+goog.testing.Mock.prototype.$reset = function() {
+  this.$recording_ = true;
+  this.$threwException_ = null;
+  delete this.$pendingExpectation;
+};
+
+
+/**
+ * Throws an exception and records that an exception was thrown.
+ * @param {string} comment A short comment about the exception.
+ * @param {?string=} opt_message A longer message about the exception.
+ * @throws {Object} JsUnitException object.
+ * @protected
+ */
+goog.testing.Mock.prototype.$throwException = function(comment, opt_message) {
+  this.$recordAndThrow(new goog.testing.JsUnitException(comment, opt_message));
+};
+
+
+/**
+ * Throws an exception and records that an exception was thrown.
+ * @param {Object} ex Exception.
+ * @throws {Object} #ex.
+ * @protected
+ */
+goog.testing.Mock.prototype.$recordAndThrow = function(ex) {
+  // If it's an assert exception, record it.
+  if (ex['isJsUnitException']) {
+    var testRunner = goog.global['G_testRunner'];
+    if (testRunner) {
+      var logTestFailureFunction = testRunner['logTestFailure'];
+      if (logTestFailureFunction) {
+        logTestFailureFunction.call(testRunner, ex);
+      }
+    }
+
+    if (!this.$threwException_) {
+      // Only remember first exception thrown.
+      this.$threwException_ = ex;
+    }
+  }
+  throw ex;
+};
+
+
+/**
+ * Verify that all of the expectations were met. Should be overridden by
+ * subclasses.
+ * @override
+ */
+goog.testing.Mock.prototype.$verify = function() {
+  if (this.$threwException_) {
+    throw this.$threwException_;
+  }
+};
+
+
+/**
+ * Verifies that a method call matches an expectation.
+ * @param {goog.testing.MockExpectation} expectation The expectation to check.
+ * @param {string} name The name of the called method.
+ * @param {Array<*>?} args The arguments passed to the mock.
+ * @return {boolean} Whether the call matches the expectation.
+ */
+goog.testing.Mock.prototype.$verifyCall = function(expectation, name, args) {
+  if (expectation.name != name) {
+    return false;
+  }
+  var verifierFn =
+      this.$argumentListVerifiers_.hasOwnProperty(expectation.name) ?
+      this.$argumentListVerifiers_[expectation.name] :
+      goog.testing.mockmatchers.flexibleArrayMatcher;
+
+  return verifierFn(expectation.argumentList, args, expectation);
+};
+
+
+/**
+ * Render the provided argument array to a string to help
+ * clients with debugging tests.
+ * @param {Array<*>?} args The arguments passed to the mock.
+ * @return {string} Human-readable string.
+ */
+goog.testing.Mock.prototype.$argumentsAsString = function(args) {
+  var retVal = [];
+  for (var i = 0; i < args.length; i++) {
+    try {
+      retVal.push(goog.typeOf(args[i]));
+    } catch (e) {
+      retVal.push('[unknown]');
+    }
+  }
+  return '(' + retVal.join(', ') + ')';
+};
+
+
+/**
+ * Throw an exception based on an incorrect method call.
+ * @param {string} name Name of method called.
+ * @param {Array<*>?} args Arguments passed to the mock.
+ * @param {goog.testing.MockExpectation=} opt_expectation Expected next call,
+ *     if any.
+ */
+goog.testing.Mock.prototype.$throwCallException = function(name, args,
+                                                           opt_expectation) {
+  var errorStringBuffer = [];
+  var actualArgsString = this.$argumentsAsString(args);
+  var expectedArgsString = opt_expectation ?
+      this.$argumentsAsString(opt_expectation.argumentList) : '';
+
+  if (opt_expectation && opt_expectation.name == name) {
+    errorStringBuffer.push('Bad arguments to ', name, '().\n',
+                           'Actual: ', actualArgsString, '\n',
+                           'Expected: ', expectedArgsString, '\n',
+                           opt_expectation.getErrorMessage());
+  } else {
+    errorStringBuffer.push('Unexpected call to ', name,
+                           actualArgsString, '.');
+    if (opt_expectation) {
+      errorStringBuffer.push('\nNext expected call was to ',
+                             opt_expectation.name,
+                             expectedArgsString);
+    }
+  }
+  this.$throwException(errorStringBuffer.join(''));
+};
diff --git a/lib/goog/testing/mockclock.js b/lib/goog/testing/mockclock.js
new file mode 100644
index 0000000..d9cbc7b
--- /dev/null
+++ b/lib/goog/testing/mockclock.js
@@ -0,0 +1,606 @@
+// Copyright 2007 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Mock Clock implementation for working with setTimeout,
+ * setInterval, clearTimeout and clearInterval within unit tests.
+ *
+ * Derived from jsUnitMockTimeout.js, contributed to JsUnit by
+ * Pivotal Computer Systems, www.pivotalsf.com
+ *
+ */
+
+goog.provide('goog.testing.MockClock');
+
+goog.require('goog.Disposable');
+goog.require('goog.async.run');
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.events');
+goog.require('goog.testing.events.Event');
+
+
+
+/**
+ * Class for unit testing code that uses setTimeout and clearTimeout.
+ *
+ * NOTE: If you are using MockClock to test code that makes use of
+ *       goog.fx.Animation, then you must either:
+ *
+ * 1. Install and dispose of the MockClock in setUpPage() and tearDownPage()
+ *    respectively (rather than setUp()/tearDown()).
+ *
+ * or
+ *
+ * 2. Ensure that every test clears the animation queue by calling
+ *    mockClock.tick(x) at the end of each test function (where `x` is large
+ *    enough to complete all animations).
+ *
+ * Otherwise, if any animation is left pending at the time that
+ * MockClock.dispose() is called, that will permanently prevent any future
+ * animations from playing on the page.
+ *
+ * @param {boolean=} opt_autoInstall Install the MockClock at construction time.
+ * @constructor
+ * @extends {goog.Disposable}
+ * @final
+ */
+goog.testing.MockClock = function(opt_autoInstall) {
+  goog.Disposable.call(this);
+
+  /**
+   * Reverse-order queue of timers to fire.
+   *
+   * The last item of the queue is popped off.  Insertion happens from the
+   * right.  For example, the expiration times for each element of the queue
+   * might be in the order 300, 200, 200.
+   *
+   * @type {Array<Object>}
+   * @private
+   */
+  this.queue_ = [];
+
+  /**
+   * Set of timeouts that should be treated as cancelled.
+   *
+   * Rather than removing cancelled timers directly from the queue, this set
+   * simply marks them as deleted so that they can be ignored when their
+   * turn comes up.  The keys are the timeout keys that are cancelled, each
+   * mapping to true.
+   *
+   * @private {Object<number, boolean>}
+   */
+  this.deletedKeys_ = {};
+
+  if (opt_autoInstall) {
+    this.install();
+  }
+};
+goog.inherits(goog.testing.MockClock, goog.Disposable);
+
+
+/**
+ * Default wait timeout for mocking requestAnimationFrame (in milliseconds).
+ *
+ * @type {number}
+ * @const
+ */
+goog.testing.MockClock.REQUEST_ANIMATION_FRAME_TIMEOUT = 20;
+
+
+/**
+ * ID to use for next timeout.  Timeout IDs must never be reused, even across
+ * MockClock instances.
+ * @public {number}
+ */
+goog.testing.MockClock.nextId = Math.round(Math.random() * 10000);
+
+
+/**
+ * Count of the number of timeouts made by this instance.
+ * @type {number}
+ * @private
+ */
+goog.testing.MockClock.prototype.timeoutsMade_ = 0;
+
+
+/**
+ * PropertyReplacer instance which overwrites and resets setTimeout,
+ * setInterval, etc. or null if the MockClock is not installed.
+ * @type {goog.testing.PropertyReplacer}
+ * @private
+ */
+goog.testing.MockClock.prototype.replacer_ = null;
+
+
+/**
+ * The current simulated time in milliseconds.
+ * @type {number}
+ * @private
+ */
+goog.testing.MockClock.prototype.nowMillis_ = 0;
+
+
+/**
+ * Additional delay between the time a timeout was set to fire, and the time
+ * it actually fires.  Useful for testing workarounds for this Firefox 2 bug:
+ * https://bugzilla.mozilla.org/show_bug.cgi?id=291386
+ * May be negative.
+ * @type {number}
+ * @private
+ */
+goog.testing.MockClock.prototype.timeoutDelay_ = 0;
+
+
+/**
+ * The real set timeout for reference.
+ * @const @private {!Function}
+ */
+goog.testing.MockClock.REAL_SETTIMEOUT_ = goog.global.setTimeout;
+
+
+/**
+ * Installs the MockClock by overriding the global object's implementation of
+ * setTimeout, setInterval, clearTimeout and clearInterval.
+ */
+goog.testing.MockClock.prototype.install = function() {
+  if (!this.replacer_) {
+    if (goog.testing.MockClock.REAL_SETTIMEOUT_ !== goog.global.setTimeout) {
+      if (typeof console !== 'undefined' && console.warn) {
+        console.warn('Non default setTimeout detected. ' +
+            'Use of multiple MockClock instances or other clock mocking ' +
+            'should be avoided due to unspecified behavior and ' +
+            'the resulting fragility.');
+      }
+    }
+
+    var r = this.replacer_ = new goog.testing.PropertyReplacer();
+    r.set(goog.global, 'setTimeout', goog.bind(this.setTimeout_, this));
+    r.set(goog.global, 'setInterval', goog.bind(this.setInterval_, this));
+    r.set(goog.global, 'setImmediate', goog.bind(this.setImmediate_, this));
+    r.set(goog.global, 'clearTimeout', goog.bind(this.clearTimeout_, this));
+    r.set(goog.global, 'clearInterval', goog.bind(this.clearInterval_, this));
+    // goog.Promise uses goog.async.run. In order to be able to test
+    // Promise-based code, we need to make sure that goog.async.run uses
+    // nextTick instead of native browser Promises. This means that it will
+    // default to setImmediate, which is replaced above. Note that we test for
+    // the presence of goog.async.run.forceNextTick to be resilient to the case
+    // where tests replace goog.async.run directly.
+    goog.async.run.forceNextTick && goog.async.run.forceNextTick(
+        goog.testing.MockClock.REAL_SETTIMEOUT_);
+
+    // Replace the requestAnimationFrame functions.
+    this.replaceRequestAnimationFrame_();
+
+    // PropertyReplacer#set can't be called with renameable functions.
+    this.oldGoogNow_ = goog.now;
+    goog.now = goog.bind(this.getCurrentTime, this);
+  }
+};
+
+
+/**
+ * Installs the mocks for requestAnimationFrame and cancelRequestAnimationFrame.
+ * @private
+ */
+goog.testing.MockClock.prototype.replaceRequestAnimationFrame_ = function() {
+  var r = this.replacer_;
+  var requestFuncs = ['requestAnimationFrame',
+                      'webkitRequestAnimationFrame',
+                      'mozRequestAnimationFrame',
+                      'oRequestAnimationFrame',
+                      'msRequestAnimationFrame'];
+
+  var cancelFuncs = ['cancelAnimationFrame',
+                     'cancelRequestAnimationFrame',
+                     'webkitCancelRequestAnimationFrame',
+                     'mozCancelRequestAnimationFrame',
+                     'oCancelRequestAnimationFrame',
+                     'msCancelRequestAnimationFrame'];
+
+  for (var i = 0; i < requestFuncs.length; ++i) {
+    if (goog.global && goog.global[requestFuncs[i]]) {
+      r.set(goog.global, requestFuncs[i],
+          goog.bind(this.requestAnimationFrame_, this));
+    }
+  }
+
+  for (var i = 0; i < cancelFuncs.length; ++i) {
+    if (goog.global && goog.global[cancelFuncs[i]]) {
+      r.set(goog.global, cancelFuncs[i],
+          goog.bind(this.cancelRequestAnimationFrame_, this));
+    }
+  }
+};
+
+
+/**
+ * Removes the MockClock's hooks into the global object's functions and revert
+ * to their original values.
+ */
+goog.testing.MockClock.prototype.uninstall = function() {
+  if (this.replacer_) {
+    this.replacer_.reset();
+    this.replacer_ = null;
+    goog.now = this.oldGoogNow_;
+  }
+
+  this.resetAsyncQueue_();
+};
+
+
+/** @override */
+goog.testing.MockClock.prototype.disposeInternal = function() {
+  this.uninstall();
+  this.queue_ = null;
+  this.deletedKeys_ = null;
+  goog.testing.MockClock.superClass_.disposeInternal.call(this);
+};
+
+
+/**
+ * Resets the MockClock, removing all timeouts that are scheduled and resets
+ * the fake timer count.
+ */
+goog.testing.MockClock.prototype.reset = function() {
+  this.queue_ = [];
+  this.deletedKeys_ = {};
+  this.nowMillis_ = 0;
+  this.timeoutsMade_ = 0;
+  this.timeoutDelay_ = 0;
+
+  this.resetAsyncQueue_();
+};
+
+
+/**
+ * Resets the async queue when this clock resets.
+ * @private
+ */
+goog.testing.MockClock.prototype.resetAsyncQueue_ = function() {
+  goog.async.run.resetQueue();
+};
+
+
+/**
+ * Sets the amount of time between when a timeout is scheduled to fire and when
+ * it actually fires.
+ * @param {number} delay The delay in milliseconds.  May be negative.
+ */
+goog.testing.MockClock.prototype.setTimeoutDelay = function(delay) {
+  this.timeoutDelay_ = delay;
+};
+
+
+/**
+ * @return {number} delay The amount of time between when a timeout is
+ *     scheduled to fire and when it actually fires, in milliseconds.  May
+ *     be negative.
+ */
+goog.testing.MockClock.prototype.getTimeoutDelay = function() {
+  return this.timeoutDelay_;
+};
+
+
+/**
+ * Increments the MockClock's time by a given number of milliseconds, running
+ * any functions that are now overdue.
+ * @param {number=} opt_millis Number of milliseconds to increment the counter.
+ *     If not specified, clock ticks 1 millisecond.
+ * @return {number} Current mock time in milliseconds.
+ */
+goog.testing.MockClock.prototype.tick = function(opt_millis) {
+  if (typeof opt_millis != 'number') {
+    opt_millis = 1;
+  }
+  var endTime = this.nowMillis_ + opt_millis;
+  this.runFunctionsWithinRange_(endTime);
+  this.nowMillis_ = endTime;
+  return endTime;
+};
+
+
+/**
+ * Takes a promise and then ticks the mock clock. If the promise successfully
+ * resolves, returns the value produced by the promise. If the promise is
+ * rejected, it throws the rejection as an exception. If the promise is not
+ * resolved at all, throws an exception.
+ * Also ticks the general clock by the specified amount.
+ *
+ * @param {!goog.Thenable<T>} promise A promise that should be resolved after
+ *     the mockClock is ticked for the given opt_millis.
+ * @param {number=} opt_millis Number of milliseconds to increment the counter.
+ *     If not specified, clock ticks 1 millisecond.
+ * @return {T}
+ * @template T
+ */
+goog.testing.MockClock.prototype.tickPromise = function(promise, opt_millis) {
+  var value;
+  var error;
+  var resolved = false;
+  promise.then(function(v) {
+    value = v;
+    resolved = true;
+  }, function(e) {
+    error = e;
+    resolved = true;
+  });
+  this.tick(opt_millis);
+  if (!resolved) {
+    throw new Error(
+        'Promise was expected to be resolved after mock clock tick.');
+  }
+  if (error) {
+    throw error;
+  }
+  return value;
+};
+
+
+/**
+ * @return {number} The number of timeouts that have been scheduled.
+ */
+goog.testing.MockClock.prototype.getTimeoutsMade = function() {
+  return this.timeoutsMade_;
+};
+
+
+/**
+ * @return {number} The MockClock's current time in milliseconds.
+ */
+goog.testing.MockClock.prototype.getCurrentTime = function() {
+  return this.nowMillis_;
+};
+
+
+/**
+ * @param {number} timeoutKey The timeout key.
+ * @return {boolean} Whether the timer has been set and not cleared,
+ *     independent of the timeout's expiration.  In other words, the timeout
+ *     could have passed or could be scheduled for the future.  Either way,
+ *     this function returns true or false depending only on whether the
+ *     provided timeoutKey represents a timeout that has been set and not
+ *     cleared.
+ */
+goog.testing.MockClock.prototype.isTimeoutSet = function(timeoutKey) {
+  return timeoutKey < goog.testing.MockClock.nextId &&
+      timeoutKey >= goog.testing.MockClock.nextId - this.timeoutsMade_ &&
+      !this.deletedKeys_[timeoutKey];
+};
+
+
+/**
+ * Runs any function that is scheduled before a certain time.  Timeouts can
+ * be made to fire early or late if timeoutDelay_ is non-0.
+ * @param {number} endTime The latest time in the range, in milliseconds.
+ * @private
+ */
+goog.testing.MockClock.prototype.runFunctionsWithinRange_ = function(
+    endTime) {
+  var adjustedEndTime = endTime - this.timeoutDelay_;
+
+  // Repeatedly pop off the last item since the queue is always sorted.
+  while (this.queue_ && this.queue_.length &&
+      this.queue_[this.queue_.length - 1].runAtMillis <= adjustedEndTime) {
+    var timeout = this.queue_.pop();
+
+    if (!(timeout.timeoutKey in this.deletedKeys_)) {
+      // Only move time forwards.
+      this.nowMillis_ = Math.max(this.nowMillis_,
+          timeout.runAtMillis + this.timeoutDelay_);
+      // Call timeout in global scope and pass the timeout key as the argument.
+      timeout.funcToCall.call(goog.global, timeout.timeoutKey);
+      // In case the interval was cleared in the funcToCall
+      if (timeout.recurring) {
+        this.scheduleFunction_(
+            timeout.timeoutKey, timeout.funcToCall, timeout.millis, true);
+      }
+    }
+  }
+};
+
+
+/**
+ * Schedules a function to be run at a certain time.
+ * @param {number} timeoutKey The timeout key.
+ * @param {Function} funcToCall The function to call.
+ * @param {number} millis The number of milliseconds to call it in.
+ * @param {boolean} recurring Whether to function call should recur.
+ * @private
+ */
+goog.testing.MockClock.prototype.scheduleFunction_ = function(
+    timeoutKey, funcToCall, millis, recurring) {
+  if (!goog.isFunction(funcToCall)) {
+    // Early error for debuggability rather than dying in the next .tick()
+    throw new TypeError('The provided callback must be a function, not a ' +
+        typeof funcToCall);
+  }
+
+  var timeout = {
+    runAtMillis: this.nowMillis_ + millis,
+    funcToCall: funcToCall,
+    recurring: recurring,
+    timeoutKey: timeoutKey,
+    millis: millis
+  };
+
+  goog.testing.MockClock.insert_(timeout, this.queue_);
+};
+
+
+/**
+ * Inserts a timer descriptor into a descending-order queue.
+ *
+ * Later-inserted duplicates appear at lower indices.  For example, the
+ * asterisk in (5,4,*,3,2,1) would be the insertion point for 3.
+ *
+ * @param {Object} timeout The timeout to insert, with numerical runAtMillis
+ *     property.
+ * @param {Array<Object>} queue The queue to insert into, with each element
+ *     having a numerical runAtMillis property.
+ * @private
+ */
+goog.testing.MockClock.insert_ = function(timeout, queue) {
+  // Although insertion of N items is quadratic, requiring goog.structs.Heap
+  // from a unit test will make tests more prone to breakage.  Since unit
+  // tests are normally small, scalability is not a primary issue.
+
+  // Find an insertion point.  Since the queue is in reverse order (so we
+  // can pop rather than unshift), and later timers with the same time stamp
+  // should be executed later, we look for the element strictly greater than
+  // the one we are inserting.
+
+  for (var i = queue.length; i != 0; i--) {
+    if (queue[i - 1].runAtMillis > timeout.runAtMillis) {
+      break;
+    }
+    queue[i] = queue[i - 1];
+  }
+
+  queue[i] = timeout;
+};
+
+
+/**
+ * Maximum 32-bit signed integer.
+ *
+ * Timeouts over this time return immediately in many browsers, due to integer
+ * overflow.  Such known browsers include Firefox, Chrome, and Safari, but not
+ * IE.
+ *
+ * @type {number}
+ * @private
+ */
+goog.testing.MockClock.MAX_INT_ = 2147483647;
+
+
+/**
+ * Schedules a function to be called after {@code millis} milliseconds.
+ * Mock implementation for setTimeout.
+ * @param {Function} funcToCall The function to call.
+ * @param {number=} opt_millis The number of milliseconds to call it after.
+ * @return {number} The number of timeouts created.
+ * @private
+ */
+goog.testing.MockClock.prototype.setTimeout_ = function(
+    funcToCall, opt_millis) {
+  var millis = opt_millis || 0;
+  if (millis > goog.testing.MockClock.MAX_INT_) {
+    throw Error(
+        'Bad timeout value: ' + millis + '.  Timeouts over MAX_INT ' +
+        '(24.8 days) cause timeouts to be fired ' +
+        'immediately in most browsers, except for IE.');
+  }
+  this.timeoutsMade_++;
+  this.scheduleFunction_(goog.testing.MockClock.nextId, funcToCall, millis,
+      false);
+  return goog.testing.MockClock.nextId++;
+};
+
+
+/**
+ * Schedules a function to be called every {@code millis} milliseconds.
+ * Mock implementation for setInterval.
+ * @param {Function} funcToCall The function to call.
+ * @param {number=} opt_millis The number of milliseconds between calls.
+ * @return {number} The number of timeouts created.
+ * @private
+ */
+goog.testing.MockClock.prototype.setInterval_ =
+    function(funcToCall, opt_millis) {
+  var millis = opt_millis || 0;
+  this.timeoutsMade_++;
+  this.scheduleFunction_(goog.testing.MockClock.nextId, funcToCall, millis,
+      true);
+  return goog.testing.MockClock.nextId++;
+};
+
+
+/**
+ * Schedules a function to be called when an animation frame is triggered.
+ * Mock implementation for requestAnimationFrame.
+ * @param {Function} funcToCall The function to call.
+ * @return {number} The number of timeouts created.
+ * @private
+ */
+goog.testing.MockClock.prototype.requestAnimationFrame_ = function(funcToCall) {
+  return this.setTimeout_(goog.bind(function() {
+    if (funcToCall) {
+      funcToCall(this.getCurrentTime());
+    } else if (goog.global.mozRequestAnimationFrame) {
+      var event = new goog.testing.events.Event('MozBeforePaint', goog.global);
+      event['timeStamp'] = this.getCurrentTime();
+      goog.testing.events.fireBrowserEvent(event);
+    }
+  }, this), goog.testing.MockClock.REQUEST_ANIMATION_FRAME_TIMEOUT);
+};
+
+
+/**
+ * Schedules a function to be called immediately after the current JS
+ * execution.
+ * Mock implementation for setImmediate.
+ * @param {Function} funcToCall The function to call.
+ * @return {number} The number of timeouts created.
+ * @private
+ */
+goog.testing.MockClock.prototype.setImmediate_ = function(funcToCall) {
+  return this.setTimeout_(funcToCall, 0);
+};
+
+
+/**
+ * Clears a timeout.
+ * Mock implementation for clearTimeout.
+ * @param {number} timeoutKey The timeout key to clear.
+ * @private
+ */
+goog.testing.MockClock.prototype.clearTimeout_ = function(timeoutKey) {
+  // Some common libraries register static state with timers.
+  // This is bad. It leads to all sorts of crazy test problems where
+  // 1) Test A sets up a new mock clock and a static timer.
+  // 2) Test B sets up a new mock clock, but re-uses the static timer
+  //    from Test A.
+  // 3) A timeout key from test A gets cleared, breaking a timeout in
+  //    Test B.
+  //
+  // For now, we just hackily fail silently if someone tries to clear a timeout
+  // key before we've allocated it.
+  // Ideally, we should throw an exception if we see this happening.
+  if (this.isTimeoutSet(timeoutKey)) {
+    this.deletedKeys_[timeoutKey] = true;
+  }
+};
+
+
+/**
+ * Clears an interval.
+ * Mock implementation for clearInterval.
+ * @param {number} timeoutKey The interval key to clear.
+ * @private
+ */
+goog.testing.MockClock.prototype.clearInterval_ = function(timeoutKey) {
+  this.clearTimeout_(timeoutKey);
+};
+
+
+/**
+ * Clears a requestAnimationFrame.
+ * Mock implementation for cancelRequestAnimationFrame.
+ * @param {number} timeoutKey The requestAnimationFrame key to clear.
+ * @private
+ */
+goog.testing.MockClock.prototype.cancelRequestAnimationFrame_ =
+    function(timeoutKey) {
+  this.clearTimeout_(timeoutKey);
+};
diff --git a/lib/goog/testing/mockcontrol.js b/lib/goog/testing/mockcontrol.js
new file mode 100644
index 0000000..305cd11
--- /dev/null
+++ b/lib/goog/testing/mockcontrol.js
@@ -0,0 +1,220 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A MockControl holds a set of mocks for a particular test.
+ * It consolidates calls to $replay, $verify, and $tearDown, which simplifies
+ * the test and helps avoid omissions.
+ *
+ * You can create and control a mock:
+ *   var mockFoo = mockControl.addMock(new MyMock(Foo));
+ *
+ * MockControl also exposes some convenience functions that create
+ * controlled mocks for common mocks: StrictMock, LooseMock,
+ * FunctionMock, MethodMock, and GlobalFunctionMock.
+ *
+ */
+
+
+goog.provide('goog.testing.MockControl');
+
+goog.require('goog.array');
+goog.require('goog.testing');
+goog.require('goog.testing.LooseMock');
+goog.require('goog.testing.StrictMock');
+
+
+
+/**
+ * Controls a set of mocks.  Controlled mocks are replayed, verified, and
+ * cleaned-up at the same time.
+ * @constructor
+ */
+goog.testing.MockControl = function() {
+  /**
+   * The list of mocks being controlled.
+   * @type {Array<goog.testing.MockInterface>}
+   * @private
+   */
+  this.mocks_ = [];
+};
+
+
+/**
+ * Takes control of this mock.
+ * @param {goog.testing.MockInterface} mock Mock to be controlled.
+ * @return {goog.testing.MockInterface} The same mock passed in,
+ *     for convenience.
+ */
+goog.testing.MockControl.prototype.addMock = function(mock) {
+  this.mocks_.push(mock);
+  return mock;
+};
+
+
+/**
+ * Calls replay on each controlled mock.
+ */
+goog.testing.MockControl.prototype.$replayAll = function() {
+  goog.array.forEach(this.mocks_, function(m) {
+    m.$replay();
+  });
+};
+
+
+/**
+ * Calls reset on each controlled mock.
+ */
+goog.testing.MockControl.prototype.$resetAll = function() {
+  goog.array.forEach(this.mocks_, function(m) {
+    m.$reset();
+  });
+};
+
+
+/**
+ * Calls verify on each controlled mock.
+ */
+goog.testing.MockControl.prototype.$verifyAll = function() {
+  goog.array.forEach(this.mocks_, function(m) {
+    m.$verify();
+  });
+};
+
+
+/**
+ * Calls tearDown on each controlled mock, if necesssary.
+ */
+goog.testing.MockControl.prototype.$tearDown = function() {
+  goog.array.forEach(this.mocks_, function(m) {
+    // $tearDown if defined.
+    if (m.$tearDown) {
+      m.$tearDown();
+    }
+    // TODO(user): Somehow determine if verifyAll should have been called
+    // but was not.
+  });
+};
+
+
+/**
+ * Creates a controlled StrictMock.  Passes its arguments through to the
+ * StrictMock constructor.
+ * @param {Object|Function} objectToMock The object that should be mocked, or
+ *    the constructor of an object to mock.
+ * @param {boolean=} opt_mockStaticMethods An optional argument denoting that
+ *     a mock should be constructed from the static functions of a class.
+ * @param {boolean=} opt_createProxy An optional argument denoting that
+ *     a proxy for the target mock should be created.
+ * @return {!goog.testing.StrictMock} The mock object.
+ */
+goog.testing.MockControl.prototype.createStrictMock = function(
+    objectToMock, opt_mockStaticMethods, opt_createProxy) {
+  var m = new goog.testing.StrictMock(objectToMock, opt_mockStaticMethods,
+                                      opt_createProxy);
+  this.addMock(m);
+  return m;
+};
+
+
+/**
+ * Creates a controlled LooseMock.  Passes its arguments through to the
+ * LooseMock constructor.
+ * @param {Object|Function} objectToMock The object that should be mocked, or
+ *    the constructor of an object to mock.
+ * @param {boolean=} opt_ignoreUnexpectedCalls Whether to ignore unexpected
+ *     calls.
+ * @param {boolean=} opt_mockStaticMethods An optional argument denoting that
+ *     a mock should be constructed from the static functions of a class.
+ * @param {boolean=} opt_createProxy An optional argument denoting that
+ *     a proxy for the target mock should be created.
+ * @return {!goog.testing.LooseMock} The mock object.
+ */
+goog.testing.MockControl.prototype.createLooseMock = function(
+    objectToMock, opt_ignoreUnexpectedCalls,
+    opt_mockStaticMethods, opt_createProxy) {
+  var m = new goog.testing.LooseMock(objectToMock, opt_ignoreUnexpectedCalls,
+                                     opt_mockStaticMethods, opt_createProxy);
+  this.addMock(m);
+  return m;
+};
+
+
+/**
+ * Creates a controlled FunctionMock.  Passes its arguments through to the
+ * FunctionMock constructor.
+ * @param {string=} opt_functionName The optional name of the function to mock
+ *     set to '[anonymous mocked function]' if not passed in.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {goog.testing.MockInterface} The mocked function.
+ */
+goog.testing.MockControl.prototype.createFunctionMock = function(
+    opt_functionName, opt_strictness) {
+  var m = goog.testing.createFunctionMock(opt_functionName, opt_strictness);
+  this.addMock(m);
+  return m;
+};
+
+
+/**
+ * Creates a controlled MethodMock.  Passes its arguments through to the
+ * MethodMock constructor.
+ * @param {Object} scope The scope of the method to be mocked out.
+ * @param {string} functionName The name of the function we're going to mock.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked method.
+ */
+goog.testing.MockControl.prototype.createMethodMock = function(
+    scope, functionName, opt_strictness) {
+  var m = goog.testing.createMethodMock(scope, functionName, opt_strictness);
+  this.addMock(m);
+  return m;
+};
+
+
+/**
+ * Creates a controlled MethodMock for a constructor.  Passes its arguments
+ * through to the MethodMock constructor. See
+ * {@link goog.testing.createConstructorMock} for details.
+ * @param {Object} scope The scope of the constructor to be mocked out.
+ * @param {string} constructorName The name of the function we're going to mock.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked method.
+ */
+goog.testing.MockControl.prototype.createConstructorMock = function(
+    scope, constructorName, opt_strictness) {
+  var m = goog.testing.createConstructorMock(scope, constructorName,
+                                             opt_strictness);
+  this.addMock(m);
+  return m;
+};
+
+
+/**
+ * Creates a controlled GlobalFunctionMock.  Passes its arguments through to the
+ * GlobalFunctionMock constructor.
+ * @param {string} functionName The name of the function we're going to mock.
+ * @param {number=} opt_strictness One of goog.testing.Mock.LOOSE or
+ *     goog.testing.Mock.STRICT. The default is STRICT.
+ * @return {!goog.testing.MockInterface} The mocked function.
+ */
+goog.testing.MockControl.prototype.createGlobalFunctionMock = function(
+    functionName, opt_strictness) {
+  var m = goog.testing.createGlobalFunctionMock(functionName, opt_strictness);
+  this.addMock(m);
+  return m;
+};
diff --git a/lib/goog/testing/mockinterface.js b/lib/goog/testing/mockinterface.js
new file mode 100644
index 0000000..1a53470
--- /dev/null
+++ b/lib/goog/testing/mockinterface.js
@@ -0,0 +1,45 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview An interface that all mocks should share.
+ * @author nicksantos@google.com (Nick Santos)
+ */
+
+goog.provide('goog.testing.MockInterface');
+
+
+
+/** @interface */
+goog.testing.MockInterface = function() {};
+
+
+/**
+ * Write down all the expected functions that have been called on the
+ * mock so far. From here on out, future function calls will be
+ * compared against this list.
+ */
+goog.testing.MockInterface.prototype.$replay = function() {};
+
+
+/**
+ * Reset the mock.
+ */
+goog.testing.MockInterface.prototype.$reset = function() {};
+
+
+/**
+ * Assert that the expected function calls match the actual calls.
+ */
+goog.testing.MockInterface.prototype.$verify = function() {};
diff --git a/lib/goog/testing/mockmatchers.js b/lib/goog/testing/mockmatchers.js
new file mode 100644
index 0000000..a0545f7
--- /dev/null
+++ b/lib/goog/testing/mockmatchers.js
@@ -0,0 +1,400 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Matchers to be used with the mock utilities.  They allow for
+ * flexible matching by type.  Custom matchers can be created by passing a
+ * matcher function into an ArgumentMatcher instance.
+ *
+ * For examples, please see the unit test.
+ *
+ */
+
+
+goog.provide('goog.testing.mockmatchers');
+goog.provide('goog.testing.mockmatchers.ArgumentMatcher');
+goog.provide('goog.testing.mockmatchers.IgnoreArgument');
+goog.provide('goog.testing.mockmatchers.InstanceOf');
+goog.provide('goog.testing.mockmatchers.ObjectEquals');
+goog.provide('goog.testing.mockmatchers.RegexpMatch');
+goog.provide('goog.testing.mockmatchers.SaveArgument');
+goog.provide('goog.testing.mockmatchers.TypeOf');
+
+goog.require('goog.array');
+goog.require('goog.dom');
+goog.require('goog.testing.asserts');
+
+
+
+/**
+ * A simple interface for executing argument matching.  A match in this case is
+ * testing to see if a supplied object fits a given criteria.  True is returned
+ * if the given criteria is met.
+ * @param {Function=} opt_matchFn A function that evaluates a given argument
+ *     and returns true if it meets a given criteria.
+ * @param {?string=} opt_matchName The name expressing intent as part of
+ *      an error message for when a match fails.
+ * @constructor
+ */
+goog.testing.mockmatchers.ArgumentMatcher =
+    function(opt_matchFn, opt_matchName) {
+  /**
+   * A function that evaluates a given argument and returns true if it meets a
+   * given criteria.
+   * @type {Function}
+   * @private
+   */
+  this.matchFn_ = opt_matchFn || null;
+
+  /**
+   * A string indicating the match intent (e.g. isBoolean or isString).
+   * @type {?string}
+   * @private
+   */
+  this.matchName_ = opt_matchName || null;
+};
+
+
+/**
+ * A function that takes a match argument and an optional MockExpectation
+ * which (if provided) will get error information and returns whether or
+ * not it matches.
+ * @param {*} toVerify The argument that should be verified.
+ * @param {goog.testing.MockExpectation?=} opt_expectation The expectation
+ *     for this match.
+ * @return {boolean} Whether or not a given argument passes verification.
+ */
+goog.testing.mockmatchers.ArgumentMatcher.prototype.matches =
+    function(toVerify, opt_expectation) {
+  if (this.matchFn_) {
+    var isamatch = this.matchFn_(toVerify);
+    if (!isamatch && opt_expectation) {
+      if (this.matchName_) {
+        opt_expectation.addErrorMessage('Expected: ' +
+            this.matchName_ + ' but was: ' + _displayStringForValue(toVerify));
+      } else {
+        opt_expectation.addErrorMessage('Expected: missing mockmatcher' +
+            ' description but was: ' +
+            _displayStringForValue(toVerify));
+      }
+    }
+    return isamatch;
+  } else {
+    throw Error('No match function defined for this mock matcher');
+  }
+};
+
+
+
+/**
+ * A matcher that verifies that an argument is an instance of a given class.
+ * @param {Function} ctor The class that will be used for verification.
+ * @constructor
+ * @extends {goog.testing.mockmatchers.ArgumentMatcher}
+ * @final
+ */
+goog.testing.mockmatchers.InstanceOf = function(ctor) {
+  goog.testing.mockmatchers.ArgumentMatcher.call(this,
+      function(obj) {
+        return obj instanceof ctor;
+        // NOTE: Browser differences on ctor.toString() output
+        // make using that here problematic. So for now, just let
+        // people know the instanceOf() failed without providing
+        // browser specific details...
+      }, 'instanceOf()');
+};
+goog.inherits(goog.testing.mockmatchers.InstanceOf,
+    goog.testing.mockmatchers.ArgumentMatcher);
+
+
+
+/**
+ * A matcher that verifies that an argument is of a given type (e.g. "object").
+ * @param {string} type The type that a given argument must have.
+ * @constructor
+ * @extends {goog.testing.mockmatchers.ArgumentMatcher}
+ * @final
+ */
+goog.testing.mockmatchers.TypeOf = function(type) {
+  goog.testing.mockmatchers.ArgumentMatcher.call(this,
+      function(obj) {
+        return goog.typeOf(obj) == type;
+      }, 'typeOf(' + type + ')');
+};
+goog.inherits(goog.testing.mockmatchers.TypeOf,
+    goog.testing.mockmatchers.ArgumentMatcher);
+
+
+
+/**
+ * A matcher that verifies that an argument matches a given RegExp.
+ * @param {RegExp} regexp The regular expression that the argument must match.
+ * @constructor
+ * @extends {goog.testing.mockmatchers.ArgumentMatcher}
+ * @final
+ */
+goog.testing.mockmatchers.RegexpMatch = function(regexp) {
+  goog.testing.mockmatchers.ArgumentMatcher.call(this,
+      function(str) {
+        return regexp.test(str);
+      }, 'match(' + regexp + ')');
+};
+goog.inherits(goog.testing.mockmatchers.RegexpMatch,
+    goog.testing.mockmatchers.ArgumentMatcher);
+
+
+
+/**
+ * A matcher that always returns true. It is useful when the user does not care
+ * for some arguments.
+ * For example: mockFunction('username', 'password', IgnoreArgument);
+ * @constructor
+ * @extends {goog.testing.mockmatchers.ArgumentMatcher}
+ * @final
+ */
+goog.testing.mockmatchers.IgnoreArgument = function() {
+  goog.testing.mockmatchers.ArgumentMatcher.call(this,
+      function() {
+        return true;
+      }, 'true');
+};
+goog.inherits(goog.testing.mockmatchers.IgnoreArgument,
+    goog.testing.mockmatchers.ArgumentMatcher);
+
+
+
+/**
+ * A matcher that verifies that the argument is an object that equals the given
+ * expected object, using a deep comparison.
+ * @param {Object} expectedObject An object to match against when
+ *     verifying the argument.
+ * @constructor
+ * @extends {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.ObjectEquals = function(expectedObject) {
+  goog.testing.mockmatchers.ArgumentMatcher.call(this,
+      function(matchObject) {
+        assertObjectEquals('Expected equal objects', expectedObject,
+            matchObject);
+        return true;
+      }, 'objectEquals(' + expectedObject + ')');
+};
+goog.inherits(goog.testing.mockmatchers.ObjectEquals,
+    goog.testing.mockmatchers.ArgumentMatcher);
+
+
+/** @override */
+goog.testing.mockmatchers.ObjectEquals.prototype.matches =
+    function(toVerify, opt_expectation) {
+  // Override the default matches implementation to capture the exception thrown
+  // by assertObjectEquals (if any) and add that message to the expectation.
+  try {
+    return goog.testing.mockmatchers.ObjectEquals.superClass_.matches.call(
+        this, toVerify, opt_expectation);
+  } catch (e) {
+    if (opt_expectation) {
+      opt_expectation.addErrorMessage(e.message);
+    }
+    return false;
+  }
+};
+
+
+
+/**
+ * A matcher that saves the argument that it is verifying so that your unit test
+ * can perform extra tests with this argument later.  For example, if the
+ * argument is a callback method, the unit test can then later call this
+ * callback to test the asynchronous portion of the call.
+ * @param {goog.testing.mockmatchers.ArgumentMatcher|Function=} opt_matcher
+ *     Argument matcher or matching function that will be used to validate the
+ *     argument.  By default, argument will always be valid.
+ * @param {?string=} opt_matchName The name expressing intent as part of
+ *      an error message for when a match fails.
+ * @constructor
+ * @extends {goog.testing.mockmatchers.ArgumentMatcher}
+ * @final
+ */
+goog.testing.mockmatchers.SaveArgument = function(opt_matcher, opt_matchName) {
+  goog.testing.mockmatchers.ArgumentMatcher.call(
+      this, /** @type {Function} */ (opt_matcher), opt_matchName);
+
+  if (opt_matcher instanceof goog.testing.mockmatchers.ArgumentMatcher) {
+    /**
+     * Delegate match requests to this matcher.
+     * @type {goog.testing.mockmatchers.ArgumentMatcher}
+     * @private
+     */
+    this.delegateMatcher_ = opt_matcher;
+  } else if (!opt_matcher) {
+    this.delegateMatcher_ = goog.testing.mockmatchers.ignoreArgument;
+  }
+};
+goog.inherits(goog.testing.mockmatchers.SaveArgument,
+    goog.testing.mockmatchers.ArgumentMatcher);
+
+
+/** @override */
+goog.testing.mockmatchers.SaveArgument.prototype.matches = function(
+    toVerify, opt_expectation) {
+  this.arg = toVerify;
+  if (this.delegateMatcher_) {
+    return this.delegateMatcher_.matches(toVerify, opt_expectation);
+  }
+  return goog.testing.mockmatchers.SaveArgument.superClass_.matches.call(
+      this, toVerify, opt_expectation);
+};
+
+
+/**
+ * Saved argument that was verified.
+ * @type {*}
+ */
+goog.testing.mockmatchers.SaveArgument.prototype.arg;
+
+
+/**
+ * An instance of the IgnoreArgument matcher. Returns true for all matches.
+ * @type {goog.testing.mockmatchers.IgnoreArgument}
+ */
+goog.testing.mockmatchers.ignoreArgument =
+    new goog.testing.mockmatchers.IgnoreArgument();
+
+
+/**
+ * A matcher that verifies that an argument is an array.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isArray =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.isArray,
+        'isArray');
+
+
+/**
+ * A matcher that verifies that an argument is a array-like.  A NodeList is an
+ * example of a collection that is very close to an array.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isArrayLike =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.isArrayLike,
+        'isArrayLike');
+
+
+/**
+ * A matcher that verifies that an argument is a date-like.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isDateLike =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.isDateLike,
+        'isDateLike');
+
+
+/**
+ * A matcher that verifies that an argument is a string.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isString =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.isString,
+        'isString');
+
+
+/**
+ * A matcher that verifies that an argument is a boolean.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isBoolean =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.isBoolean,
+        'isBoolean');
+
+
+/**
+ * A matcher that verifies that an argument is a number.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isNumber =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.isNumber,
+        'isNumber');
+
+
+/**
+ * A matcher that verifies that an argument is a function.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isFunction =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.isFunction,
+        'isFunction');
+
+
+/**
+ * A matcher that verifies that an argument is an object.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isObject =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.isObject,
+        'isObject');
+
+
+/**
+ * A matcher that verifies that an argument is like a DOM node.
+ * @type {goog.testing.mockmatchers.ArgumentMatcher}
+ */
+goog.testing.mockmatchers.isNodeLike =
+    new goog.testing.mockmatchers.ArgumentMatcher(goog.dom.isNodeLike,
+        'isNodeLike');
+
+
+/**
+ * A function that checks to see if an array matches a given set of
+ * expectations.  The expectations array can be a mix of ArgumentMatcher
+ * implementations and values.  True will be returned if values are identical or
+ * if a matcher returns a positive result.
+ * @param {Array<?>} expectedArr An array of expectations which can be either
+ *     values to check for equality or ArgumentMatchers.
+ * @param {Array<?>} arr The array to match.
+ * @param {goog.testing.MockExpectation?=} opt_expectation The expectation
+ *     for this match.
+ * @return {boolean} Whether or not the given array matches the expectations.
+ */
+goog.testing.mockmatchers.flexibleArrayMatcher =
+    function(expectedArr, arr, opt_expectation) {
+  return goog.array.equals(expectedArr, arr, function(a, b) {
+    var errCount = 0;
+    if (opt_expectation) {
+      errCount = opt_expectation.getErrorMessageCount();
+    }
+    var isamatch = a === b ||
+        a instanceof goog.testing.mockmatchers.ArgumentMatcher &&
+        a.matches(b, opt_expectation);
+    var failureMessage = null;
+    if (!isamatch) {
+      failureMessage = goog.testing.asserts.findDifferences(a, b);
+      isamatch = !failureMessage;
+    }
+    if (!isamatch && opt_expectation) {
+      // If the error count changed, the match sent out an error
+      // message. If the error count has not changed, then
+      // we need to send out an error message...
+      if (errCount == opt_expectation.getErrorMessageCount()) {
+        // Use the _displayStringForValue() from assert.js
+        // for consistency...
+        if (!failureMessage) {
+          failureMessage = 'Expected: ' + _displayStringForValue(a) +
+              ' but was: ' + _displayStringForValue(b);
+        }
+        opt_expectation.addErrorMessage(failureMessage);
+      }
+    }
+    return isamatch;
+  });
+};
diff --git a/lib/goog/testing/objectpropertystring.js b/lib/goog/testing/objectpropertystring.js
new file mode 100644
index 0000000..18c93d9
--- /dev/null
+++ b/lib/goog/testing/objectpropertystring.js
@@ -0,0 +1,68 @@
+// Copyright 2009 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Helper for passing property names as string literals in
+ * compiled test code.
+ *
+ */
+
+goog.provide('goog.testing.ObjectPropertyString');
+
+
+
+/**
+ * Object to pass a property name as a string literal and its containing object
+ * when the JSCompiler is rewriting these names. This should only be used in
+ * test code.
+ *
+ * @param {Object} object The containing object.
+ * @param {Object|string} propertyString Property name as a string literal.
+ * @constructor
+ * @final
+ */
+goog.testing.ObjectPropertyString = function(object, propertyString) {
+  this.object_ = object;
+  this.propertyString_ = /** @type {string} */ (propertyString);
+};
+
+
+/**
+ * @type {Object}
+ * @private
+ */
+goog.testing.ObjectPropertyString.prototype.object_;
+
+
+/**
+ * @type {string}
+ * @private
+ */
+goog.testing.ObjectPropertyString.prototype.propertyString_;
+
+
+/**
+ * @return {Object} The object.
+ */
+goog.testing.ObjectPropertyString.prototype.getObject = function() {
+  return this.object_;
+};
+
+
+/**
+ * @return {string} The property string.
+ */
+goog.testing.ObjectPropertyString.prototype.getPropertyString = function() {
+  return this.propertyString_;
+};
diff --git a/lib/goog/testing/propertyreplacer.js b/lib/goog/testing/propertyreplacer.js
new file mode 100644
index 0000000..f25da97
--- /dev/null
+++ b/lib/goog/testing/propertyreplacer.js
@@ -0,0 +1,262 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Helper class for creating stubs for testing.
+ *
+ */
+
+goog.provide('goog.testing.PropertyReplacer');
+
+/** @suppress {extraRequire} Needed for some tests to compile. */
+goog.require('goog.testing.ObjectPropertyString');
+goog.require('goog.userAgent');
+
+
+
+/**
+ * Helper class for stubbing out variables and object properties for unit tests.
+ * This class can change the value of some variables before running the test
+ * cases, and to reset them in the tearDown phase.
+ * See googletest.StubOutForTesting as an analogy in Python:
+ * http://protobuf.googlecode.com/svn/trunk/python/stubout.py
+ *
+ * Example usage:
+ *
+ *     var stubs = new goog.testing.PropertyReplacer();
+ *
+ *     function setUp() {
+ *       // Mock functions used in all test cases.
+ *       stubs.set(Math, 'random', function() {
+ *         return 4;  // Chosen by fair dice roll. Guaranteed to be random.
+ *       });
+ *     }
+ *
+ *     function tearDown() {
+ *       stubs.reset();
+ *     }
+ *
+ *     function testThreeDice() {
+ *       // Mock a constant used only in this test case.
+ *       stubs.set(goog.global, 'DICE_COUNT', 3);
+ *       assertEquals(12, rollAllDice());
+ *     }
+ *
+ * Constraints on altered objects:
+ * <ul>
+ *   <li>DOM subclasses aren't supported.
+ *   <li>The value of the objects' constructor property must either be equal to
+ *       the real constructor or kept untouched.
+ * </ul>
+ *
+ * @constructor
+ * @final
+ */
+goog.testing.PropertyReplacer = function() {
+  /**
+   * Stores the values changed by the set() method in chronological order.
+   * Its items are objects with 3 fields: 'object', 'key', 'value'. The
+   * original value for the given key in the given object is stored under the
+   * 'value' key.
+   * @type {Array<{ object: ?, key: string, value: ? }>}
+   * @private
+   */
+  this.original_ = [];
+};
+
+
+/**
+ * Indicates that a key didn't exist before having been set by the set() method.
+ * @private @const
+ */
+goog.testing.PropertyReplacer.NO_SUCH_KEY_ = {};
+
+
+/**
+ * Tells if the given key exists in the object. Ignores inherited fields.
+ * @param {Object|Function} obj The JavaScript or native object or function
+ *     whose key is to be checked.
+ * @param {string} key The key to check.
+ * @return {boolean} Whether the object has the key as own key.
+ * @private
+ */
+goog.testing.PropertyReplacer.hasKey_ = function(obj, key) {
+  if (!(key in obj)) {
+    return false;
+  }
+  // hasOwnProperty is only reliable with JavaScript objects. It returns false
+  // for built-in DOM attributes.
+  if (Object.prototype.hasOwnProperty.call(obj, key)) {
+    return true;
+  }
+  // In all browsers except Opera obj.constructor never equals to Object if
+  // obj is an instance of a native class. In Opera we have to fall back on
+  // examining obj.toString().
+  if (obj.constructor == Object &&
+      (!goog.userAgent.OPERA ||
+          Object.prototype.toString.call(obj) == '[object Object]')) {
+    return false;
+  }
+  try {
+    // Firefox hack to consider "className" part of the HTML elements or
+    // "body" part of document. Although they are defined in the prototype of
+    // HTMLElement or Document, accessing them this way throws an exception.
+    // <pre>
+    //   var dummy = document.body.constructor.prototype.className
+    //   [Exception... "Cannot modify properties of a WrappedNative"]
+    // </pre>
+    var dummy = obj.constructor.prototype[key];
+  } catch (e) {
+    return true;
+  }
+  return !(key in obj.constructor.prototype);
+};
+
+
+/**
+ * Deletes a key from an object. Sets it to undefined or empty string if the
+ * delete failed.
+ * @param {Object|Function} obj The object or function to delete a key from.
+ * @param {string} key The key to delete.
+ * @throws {Error} In case of trying to set a read-only property
+ * @private
+ */
+goog.testing.PropertyReplacer.deleteKey_ = function(obj, key) {
+  try {
+    delete obj[key];
+    // Delete has no effect for built-in properties of DOM nodes in FF.
+    if (!goog.testing.PropertyReplacer.hasKey_(obj, key)) {
+      return;
+    }
+  } catch (e) {
+    // IE throws TypeError when trying to delete properties of native objects
+    // (e.g. DOM nodes or window), even if they have been added by JavaScript.
+  }
+
+  obj[key] = undefined;
+  if (obj[key] == 'undefined') {
+    // Some properties such as className in IE are always evaluated as string
+    // so undefined will become 'undefined'.
+    obj[key] = '';
+  }
+
+  if (obj[key]) {
+    throw Error('Cannot delete non configurable property "' + key + '" in ' +
+                obj);
+  }
+};
+
+
+/**
+ * Adds or changes a value in an object while saving its original state.
+ * @param {Object|Function} obj The JavaScript or native object or function to
+ *     alter. See the constraints in the class description.
+ * @param {string} key The key to change the value for.
+ * @param {*} value The new value to set.
+ * @throws {Error} In case of trying to set a read-only property.
+ */
+goog.testing.PropertyReplacer.prototype.set = function(obj, key, value) {
+  var origValue = goog.testing.PropertyReplacer.hasKey_(obj, key) ? obj[key] :
+                  goog.testing.PropertyReplacer.NO_SUCH_KEY_;
+  this.original_.push({object: obj, key: key, value: origValue});
+  obj[key] = value;
+
+  // Check whether obj[key] was a read-only value and the assignment failed.
+  // Also, check that we're not comparing returned pixel values when "value"
+  // is 0. In other words, account for this case:
+  // document.body.style.margin = 0;
+  // document.body.style.margin; // returns "0px"
+  if (obj[key] != value && (value + 'px') != obj[key]) {
+    throw Error('Cannot overwrite read-only property "' + key + '" in ' + obj);
+  }
+};
+
+
+/**
+ * Changes an existing value in an object to another one of the same type while
+ * saving its original state. The advantage of {@code replace} over {@link #set}
+ * is that {@code replace} protects against typos and erroneously passing tests
+ * after some members have been renamed during a refactoring.
+ * @param {Object|Function} obj The JavaScript or native object or function to
+ *     alter. See the constraints in the class description.
+ * @param {string} key The key to change the value for. It has to be present
+ *     either in {@code obj} or in its prototype chain.
+ * @param {*} value The new value to set. It has to have the same type as the
+ *     original value. The types are compared with {@link goog.typeOf}.
+ * @throws {Error} In case of missing key or type mismatch.
+ */
+goog.testing.PropertyReplacer.prototype.replace = function(obj, key, value) {
+  if (!(key in obj)) {
+    throw Error('Cannot replace missing property "' + key + '" in ' + obj);
+  }
+  if (goog.typeOf(obj[key]) != goog.typeOf(value)) {
+    throw Error('Cannot replace property "' + key + '" in ' + obj +
+        ' with a value of different type');
+  }
+  this.set(obj, key, value);
+};
+
+
+/**
+ * Builds an object structure for the provided namespace path.  Doesn't
+ * overwrite those prefixes of the path that are already objects or functions.
+ * @param {string} path The path to create or alter, e.g. 'goog.ui.Menu'.
+ * @param {*} value The value to set.
+ */
+goog.testing.PropertyReplacer.prototype.setPath = function(path, value) {
+  var parts = path.split('.');
+  var obj = goog.global;
+  for (var i = 0; i < parts.length - 1; i++) {
+    var part = parts[i];
+    if (part == 'prototype' && !obj[part]) {
+      throw Error('Cannot set the prototype of ' + parts.slice(0, i).join('.'));
+    }
+    if (!goog.isObject(obj[part]) && !goog.isFunction(obj[part])) {
+      this.set(obj, part, {});
+    }
+    obj = obj[part];
+  }
+  this.set(obj, parts[parts.length - 1], value);
+};
+
+
+/**
+ * Deletes the key from the object while saving its original value.
+ * @param {Object|Function} obj The JavaScript or native object or function to
+ *     alter. See the constraints in the class description.
+ * @param {string} key The key to delete.
+ */
+goog.testing.PropertyReplacer.prototype.remove = function(obj, key) {
+  if (goog.testing.PropertyReplacer.hasKey_(obj, key)) {
+    this.original_.push({object: obj, key: key, value: obj[key]});
+    goog.testing.PropertyReplacer.deleteKey_(obj, key);
+  }
+};
+
+
+/**
+ * Resets all changes made by goog.testing.PropertyReplacer.prototype.set.
+ */
+goog.testing.PropertyReplacer.prototype.reset = function() {
+  for (var i = this.original_.length - 1; i >= 0; i--) {
+    var original = this.original_[i];
+    if (original.value == goog.testing.PropertyReplacer.NO_SUCH_KEY_) {
+      goog.testing.PropertyReplacer.deleteKey_(original.object, original.key);
+    } else {
+      original.object[original.key] = original.value;
+    }
+    delete this.original_[i];
+  }
+  this.original_.length = 0;
+};
diff --git a/lib/goog/testing/recordfunction.js b/lib/goog/testing/recordfunction.js
new file mode 100644
index 0000000..fc81c1d
--- /dev/null
+++ b/lib/goog/testing/recordfunction.js
@@ -0,0 +1,215 @@
+// Copyright 2010 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Helper class for recording the calls of a function.
+ *
+ * Example:
+ * <pre>
+ * var stubs = new goog.testing.PropertyReplacer();
+ *
+ * function tearDown() {
+ *   stubs.reset();
+ * }
+ *
+ * function testShuffle() {
+ *   stubs.set(Math, 'random', goog.testing.recordFunction(Math.random));
+ *   var arr = shuffle([1, 2, 3, 4, 5]);
+ *   assertSameElements([1, 2, 3, 4, 5], arr);
+ *   assertEquals(4, Math.random.getCallCount());
+ * }
+ *
+ * function testOpenDialog() {
+ *   stubs.set(goog.ui, 'Dialog',
+ *       goog.testing.recordConstructor(goog.ui.Dialog));
+ *   openConfirmDialog();
+ *   var lastDialogInstance = goog.ui.Dialog.getLastCall().getThis();
+ *   assertEquals('confirm', lastDialogInstance.getTitle());
+ * }
+ * </pre>
+ *
+ */
+
+goog.provide('goog.testing.FunctionCall');
+goog.provide('goog.testing.recordConstructor');
+goog.provide('goog.testing.recordFunction');
+
+goog.require('goog.testing.asserts');
+
+
+/**
+ * Wraps the function into another one which calls the inner function and
+ * records its calls. The recorded function will have 3 static methods:
+ * {@code getCallCount}, {@code getCalls} and {@code getLastCall} but won't
+ * inherit the original function's prototype and static fields.
+ *
+ * @param {!Function=} opt_f The function to wrap and record. Defaults to
+ *     {@link goog.nullFunction}.
+ * @return {!Function} The wrapped function.
+ */
+goog.testing.recordFunction = function(opt_f) {
+  var f = opt_f || goog.nullFunction;
+  var calls = [];
+
+  function recordedFunction() {
+    try {
+      var ret = f.apply(this, arguments);
+      calls.push(new goog.testing.FunctionCall(f, this, arguments, ret, null));
+      return ret;
+    } catch (err) {
+      calls.push(new goog.testing.FunctionCall(f, this, arguments, undefined,
+          err));
+      throw err;
+    }
+  }
+
+  /**
+   * @return {number} Total number of calls.
+   */
+  recordedFunction.getCallCount = function() {
+    return calls.length;
+  };
+
+  /**
+   * Asserts that the function was called {@code expected} times.
+   * @param {number} expected The expected number of calls.
+   */
+  recordedFunction.assertCallCount = function(expected) {
+    var actual = calls.length;
+    assertEquals(
+        'Expected ' + expected + ' call(s), but was ' + actual + '.',
+        expected, actual);
+  };
+
+  /**
+   * @return {!Array<!goog.testing.FunctionCall>} All calls of the recorded
+   *     function.
+   */
+  recordedFunction.getCalls = function() {
+    return calls;
+  };
+
+
+  /**
+   * @return {goog.testing.FunctionCall} Last call of the recorded function or
+   *     null if it hasn't been called.
+   */
+  recordedFunction.getLastCall = function() {
+    return calls[calls.length - 1] || null;
+  };
+
+  /**
+   * Returns and removes the last call of the recorded function.
+   * @return {goog.testing.FunctionCall} Last call of the recorded function or
+   *     null if it hasn't been called.
+   */
+  recordedFunction.popLastCall = function() {
+    return calls.pop() || null;
+  };
+
+  /**
+   * Resets the recorded function and removes all calls.
+   */
+  recordedFunction.reset = function() {
+    calls.length = 0;
+  };
+
+  return recordedFunction;
+};
+
+
+/**
+ * Same as {@link goog.testing.recordFunction} but the recorded function will
+ * have the same prototype and static fields as the original one. It can be
+ * used with constructors.
+ *
+ * @param {!Function} ctor The function to wrap and record.
+ * @return {!Function} The wrapped function.
+ */
+goog.testing.recordConstructor = function(ctor) {
+  var recordedConstructor = goog.testing.recordFunction(ctor);
+  recordedConstructor.prototype = ctor.prototype;
+  goog.mixin(recordedConstructor, ctor);
+  return recordedConstructor;
+};
+
+
+
+/**
+ * Struct for a single function call.
+ * @param {!Function} func The called function.
+ * @param {!Object} thisContext {@code this} context of called function.
+ * @param {!Arguments} args Arguments of the called function.
+ * @param {*} ret Return value of the function or undefined in case of error.
+ * @param {*} error The error thrown by the function or null if none.
+ * @constructor
+ */
+goog.testing.FunctionCall = function(func, thisContext, args, ret, error) {
+  this.function_ = func;
+  this.thisContext_ = thisContext;
+  this.arguments_ = Array.prototype.slice.call(args);
+  this.returnValue_ = ret;
+  this.error_ = error;
+};
+
+
+/**
+ * @return {!Function} The called function.
+ */
+goog.testing.FunctionCall.prototype.getFunction = function() {
+  return this.function_;
+};
+
+
+/**
+ * @return {!Object} {@code this} context of called function. It is the same as
+ *     the created object if the function is a constructor.
+ */
+goog.testing.FunctionCall.prototype.getThis = function() {
+  return this.thisContext_;
+};
+
+
+/**
+ * @return {!Array<?>} Arguments of the called function.
+ */
+goog.testing.FunctionCall.prototype.getArguments = function() {
+  return this.arguments_;
+};
+
+
+/**
+ * Returns the nth argument of the called function.
+ * @param {number} index 0-based index of the argument.
+ * @return {*} The argument value or undefined if there is no such argument.
+ */
+goog.testing.FunctionCall.prototype.getArgument = function(index) {
+  return this.arguments_[index];
+};
+
+
+/**
+ * @return {*} Return value of the function or undefined in case of error.
+ */
+goog.testing.FunctionCall.prototype.getReturnValue = function() {
+  return this.returnValue_;
+};
+
+
+/**
+ * @return {*} The error thrown by the function or null if none.
+ */
+goog.testing.FunctionCall.prototype.getError = function() {
+  return this.error_;
+};
diff --git a/lib/goog/testing/stacktrace.js b/lib/goog/testing/stacktrace.js
new file mode 100644
index 0000000..9ece019
--- /dev/null
+++ b/lib/goog/testing/stacktrace.js
@@ -0,0 +1,594 @@
+// Copyright 2009 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Tools for parsing and pretty printing error stack traces.
+ *
+ */
+
+goog.provide('goog.testing.stacktrace');
+goog.provide('goog.testing.stacktrace.Frame');
+
+
+
+/**
+ * Class representing one stack frame.
+ * @param {string} context Context object, empty in case of global functions or
+ *     if the browser doesn't provide this information.
+ * @param {string} name Function name, empty in case of anonymous functions.
+ * @param {string} alias Alias of the function if available. For example the
+ *     function name will be 'c' and the alias will be 'b' if the function is
+ *     defined as <code>a.b = function c() {};</code>.
+ * @param {string} args Arguments of the function in parentheses if available.
+ * @param {string} path File path or URL including line number and optionally
+ *     column number separated by colons.
+ * @constructor
+ * @final
+ */
+goog.testing.stacktrace.Frame = function(context, name, alias, args, path) {
+  this.context_ = context;
+  this.name_ = name;
+  this.alias_ = alias;
+  this.args_ = args;
+  this.path_ = path;
+};
+
+
+/**
+ * @return {string} The function name or empty string if the function is
+ *     anonymous and the object field which it's assigned to is unknown.
+ */
+goog.testing.stacktrace.Frame.prototype.getName = function() {
+  return this.name_;
+};
+
+
+/**
+ * @return {boolean} Whether the stack frame contains an anonymous function.
+ */
+goog.testing.stacktrace.Frame.prototype.isAnonymous = function() {
+  return !this.name_ || this.context_ == '[object Object]';
+};
+
+
+/**
+ * Brings one frame of the stack trace into a common format across browsers.
+ * @return {string} Pretty printed stack frame.
+ */
+goog.testing.stacktrace.Frame.prototype.toCanonicalString = function() {
+  var htmlEscape = goog.testing.stacktrace.htmlEscape_;
+  var deobfuscate = goog.testing.stacktrace.maybeDeobfuscateFunctionName_;
+
+  var canonical = [
+    this.context_ ? htmlEscape(this.context_) + '.' : '',
+    this.name_ ? htmlEscape(deobfuscate(this.name_)) : 'anonymous',
+    htmlEscape(this.args_),
+    this.alias_ ? ' [as ' + htmlEscape(deobfuscate(this.alias_)) + ']' : ''
+  ];
+
+  if (this.path_) {
+    canonical.push(' at ');
+    canonical.push(htmlEscape(this.path_));
+  }
+  return canonical.join('');
+};
+
+
+/**
+ * Maximum number of steps while the call chain is followed.
+ * @private {number}
+ * @const
+ */
+goog.testing.stacktrace.MAX_DEPTH_ = 20;
+
+
+/**
+ * Maximum length of a string that can be matched with a RegExp on
+ * Firefox 3x. Exceeding this approximate length will cause string.match
+ * to exceed Firefox's stack quota. This situation can be encountered
+ * when goog.globalEval is invoked with a long argument; such as
+ * when loading a module.
+ * @private {number}
+ * @const
+ */
+goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_ = 500000;
+
+
+/**
+ * RegExp pattern for JavaScript identifiers. We don't support Unicode
+ * identifiers defined in ECMAScript v3.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.IDENTIFIER_PATTERN_ = '[a-zA-Z_$][\\w$]*';
+
+
+/**
+ * RegExp pattern for function name alias in the V8 stack trace.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.V8_ALIAS_PATTERN_ =
+    '(?: \\[as (' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')\\])?';
+
+
+/**
+ * RegExp pattern for the context of a function call in a V8 stack trace.
+ * Creates an optional submatch for the namespace identifier including the
+ * "new" keyword for constructor calls (e.g. "new foo.Bar").
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.V8_CONTEXT_PATTERN_ =
+    '(?:((?:new )?(?:\\[object Object\\]|' +
+    goog.testing.stacktrace.IDENTIFIER_PATTERN_ +
+    '(?:\\.' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')*))\\.)?';
+
+
+/**
+ * RegExp pattern for function names and constructor calls in the V8 stack
+ * trace.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.V8_FUNCTION_NAME_PATTERN_ =
+    '(?:new )?(?:' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ +
+    '|<anonymous>)';
+
+
+/**
+ * RegExp pattern for function call in the V8 stack trace. Creates 3 submatches
+ * with context object (optional), function name and function alias (optional).
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.V8_FUNCTION_CALL_PATTERN_ =
+    ' ' + goog.testing.stacktrace.V8_CONTEXT_PATTERN_ +
+    '(' + goog.testing.stacktrace.V8_FUNCTION_NAME_PATTERN_ + ')' +
+    goog.testing.stacktrace.V8_ALIAS_PATTERN_;
+
+
+/**
+ * RegExp pattern for an URL + position inside the file.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.URL_PATTERN_ =
+    '((?:http|https|file)://[^\\s)]+|javascript:.*)';
+
+
+/**
+ * RegExp pattern for an URL + line number + column number in V8.
+ * The URL is either in submatch 1 or submatch 2.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.CHROME_URL_PATTERN_ = ' (?:' +
+    '\\(unknown source\\)' + '|' +
+    '\\(native\\)' + '|' +
+    '\\((.+)\\)|(.+))';
+
+
+/**
+ * Regular expression for parsing one stack frame in V8. For more information
+ * on V8 stack frame formats, see
+ * https://code.google.com/p/v8/wiki/JavaScriptStackTraceApi.
+ * @private {!RegExp}
+ * @const
+ */
+goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_ = new RegExp('^    at' +
+    '(?:' + goog.testing.stacktrace.V8_FUNCTION_CALL_PATTERN_ + ')?' +
+    goog.testing.stacktrace.CHROME_URL_PATTERN_ + '$');
+
+
+/**
+ * RegExp pattern for function call in the Firefox stack trace.
+ * Creates 2 submatches with function name (optional) and arguments.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ =
+    '(' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')?' +
+    '(\\(.*\\))?@';
+
+
+/**
+ * Regular expression for parsing one stack frame in Firefox.
+ * @private {!RegExp}
+ * @const
+ */
+goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_ = new RegExp('^' +
+    goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ +
+    '(?::0|' + goog.testing.stacktrace.URL_PATTERN_ + ')$');
+
+
+/**
+ * RegExp pattern for an anonymous function call in an Opera stack frame.
+ * Creates 2 (optional) submatches: the context object and function name.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ =
+    '<anonymous function(?:\\: ' +
+    '(?:(' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ +
+    '(?:\\.' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')*)\\.)?' +
+    '(' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + '))?>';
+
+
+/**
+ * RegExp pattern for a function call in an Opera stack frame.
+ * Creates 4 (optional) submatches: the function name (if not anonymous),
+ * the aliased context object and function name (if anonymous), and the
+ * function call arguments.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ =
+    '(?:(?:(' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')|' +
+    goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ +
+    ')(\\(.*\\)))?@';
+
+
+/**
+ * Regular expression for parsing on stack frame in Opera 11.68 - 12.17.
+ * Newer versions of Opera use V8 and stack frames should match against
+ * goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_.
+ * @private {!RegExp}
+ * @const
+ */
+goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_ = new RegExp('^' +
+    goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ +
+    goog.testing.stacktrace.URL_PATTERN_ + '?$');
+
+
+/**
+ * Regular expression for finding the function name in its source.
+ * @private {!RegExp}
+ * @const
+ */
+goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_ = new RegExp(
+    '^function (' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')');
+
+
+/**
+ * RegExp pattern for function call in a IE stack trace. This expression allows
+ * for identifiers like 'Anonymous function', 'eval code', and 'Global code'.
+ * @private {string}
+ * @const
+ */
+goog.testing.stacktrace.IE_FUNCTION_CALL_PATTERN_ = '(' +
+    goog.testing.stacktrace.IDENTIFIER_PATTERN_ + '(?:\\s+\\w+)*)';
+
+
+/**
+ * Regular expression for parsing a stack frame in IE.
+ * @private {!RegExp}
+ * @const
+ */
+goog.testing.stacktrace.IE_STACK_FRAME_REGEXP_ = new RegExp('^   at ' +
+    goog.testing.stacktrace.IE_FUNCTION_CALL_PATTERN_ +
+    '\\s*\\((eval code:[^)]*|' + goog.testing.stacktrace.URL_PATTERN_ +
+    ')\\)?$');
+
+
+/**
+ * Creates a stack trace by following the call chain. Based on
+ * {@link goog.debug.getStacktrace}.
+ * @return {!Array<!goog.testing.stacktrace.Frame>} Stack frames.
+ * @private
+ * @suppress {es5Strict}
+ */
+goog.testing.stacktrace.followCallChain_ = function() {
+  var frames = [];
+  var fn = arguments.callee.caller;
+  var depth = 0;
+
+  while (fn && depth < goog.testing.stacktrace.MAX_DEPTH_) {
+    var fnString = Function.prototype.toString.call(fn);
+    var match = fnString.match(goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_);
+    var functionName = match ? match[1] : '';
+
+    var argsBuilder = ['('];
+    if (fn.arguments) {
+      for (var i = 0; i < fn.arguments.length; i++) {
+        var arg = fn.arguments[i];
+        if (i > 0) {
+          argsBuilder.push(', ');
+        }
+        if (goog.isString(arg)) {
+          argsBuilder.push('"', arg, '"');
+        } else {
+          // Some args are mocks, and we don't want to fail from them not having
+          // expected a call to toString, so instead insert a static string.
+          if (arg && arg['$replay']) {
+            argsBuilder.push('goog.testing.Mock');
+          } else {
+            argsBuilder.push(String(arg));
+          }
+        }
+      }
+    } else {
+      // Opera 10 doesn't know the arguments of native functions.
+      argsBuilder.push('unknown');
+    }
+    argsBuilder.push(')');
+    var args = argsBuilder.join('');
+
+    frames.push(new goog.testing.stacktrace.Frame('', functionName, '', args,
+        ''));
+
+    /** @preserveTry */
+    try {
+      fn = fn.caller;
+    } catch (e) {
+      break;
+    }
+    depth++;
+  }
+
+  return frames;
+};
+
+
+/**
+ * Parses one stack frame.
+ * @param {string} frameStr The stack frame as string.
+ * @return {goog.testing.stacktrace.Frame} Stack frame object or null if the
+ *     parsing failed.
+ * @private
+ */
+goog.testing.stacktrace.parseStackFrame_ = function(frameStr) {
+  // This match includes newer versions of Opera (15+).
+  var m = frameStr.match(goog.testing.stacktrace.V8_STACK_FRAME_REGEXP_);
+  if (m) {
+    return new goog.testing.stacktrace.Frame(m[1] || '', m[2] || '', m[3] || '',
+        '', m[4] || m[5] || m[6] || '');
+  }
+
+  if (frameStr.length >
+      goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_) {
+    return goog.testing.stacktrace.parseLongFirefoxFrame_(frameStr);
+  }
+
+  m = frameStr.match(goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_);
+  if (m) {
+    return new goog.testing.stacktrace.Frame('', m[1] || '', '', m[2] || '',
+        m[3] || '');
+  }
+
+  // Match against Presto Opera 11.68 - 12.17.
+  m = frameStr.match(goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_);
+  if (m) {
+    return new goog.testing.stacktrace.Frame(m[2] || '', m[1] || m[3] || '',
+        '', m[4] || '', m[5] || '');
+  }
+
+  m = frameStr.match(goog.testing.stacktrace.IE_STACK_FRAME_REGEXP_);
+  if (m) {
+    return new goog.testing.stacktrace.Frame('', m[1] || '', '', '',
+        m[2] || '');
+  }
+
+  return null;
+};
+
+
+/**
+ * Parses a long firefox stack frame.
+ * @param {string} frameStr The stack frame as string.
+ * @return {!goog.testing.stacktrace.Frame} Stack frame object.
+ * @private
+ */
+goog.testing.stacktrace.parseLongFirefoxFrame_ = function(frameStr) {
+  var firstParen = frameStr.indexOf('(');
+  var lastAmpersand = frameStr.lastIndexOf('@');
+  var lastColon = frameStr.lastIndexOf(':');
+  var functionName = '';
+  if ((firstParen >= 0) && (firstParen < lastAmpersand)) {
+    functionName = frameStr.substring(0, firstParen);
+  }
+  var loc = '';
+  if ((lastAmpersand >= 0) && (lastAmpersand + 1 < lastColon)) {
+    loc = frameStr.substring(lastAmpersand + 1);
+  }
+  var args = '';
+  if ((firstParen >= 0 && lastAmpersand > 0) &&
+      (firstParen < lastAmpersand)) {
+    args = frameStr.substring(firstParen, lastAmpersand);
+  }
+  return new goog.testing.stacktrace.Frame('', functionName, '', args, loc);
+};
+
+
+/**
+ * Function to deobfuscate function names.
+ * @type {function(string): string}
+ * @private
+ */
+goog.testing.stacktrace.deobfuscateFunctionName_;
+
+
+/**
+ * Sets function to deobfuscate function names.
+ * @param {function(string): string} fn function to deobfuscate function names.
+ */
+goog.testing.stacktrace.setDeobfuscateFunctionName = function(fn) {
+  goog.testing.stacktrace.deobfuscateFunctionName_ = fn;
+};
+
+
+/**
+ * Deobfuscates a compiled function name with the function passed to
+ * {@link #setDeobfuscateFunctionName}. Returns the original function name if
+ * the deobfuscator hasn't been set.
+ * @param {string} name The function name to deobfuscate.
+ * @return {string} The deobfuscated function name.
+ * @private
+ */
+goog.testing.stacktrace.maybeDeobfuscateFunctionName_ = function(name) {
+  return goog.testing.stacktrace.deobfuscateFunctionName_ ?
+      goog.testing.stacktrace.deobfuscateFunctionName_(name) : name;
+};
+
+
+/**
+ * Escapes the special character in HTML.
+ * @param {string} text Plain text.
+ * @return {string} Escaped text.
+ * @private
+ */
+goog.testing.stacktrace.htmlEscape_ = function(text) {
+  return text.replace(/&/g, '&amp;').
+             replace(/</g, '&lt;').
+             replace(/>/g, '&gt;').
+             replace(/"/g, '&quot;');
+};
+
+
+/**
+ * Converts the stack frames into canonical format. Chops the beginning and the
+ * end of it which come from the testing environment, not from the test itself.
+ * @param {!Array<goog.testing.stacktrace.Frame>} frames The frames.
+ * @return {string} Canonical, pretty printed stack trace.
+ * @private
+ */
+goog.testing.stacktrace.framesToString_ = function(frames) {
+  // Removes the anonymous calls from the end of the stack trace (they come
+  // from testrunner.js, testcase.js and asserts.js), so the stack trace will
+  // end with the test... method.
+  var lastIndex = frames.length - 1;
+  while (frames[lastIndex] && frames[lastIndex].isAnonymous()) {
+    lastIndex--;
+  }
+
+  // Removes the beginning of the stack trace until the call of the private
+  // _assert function (inclusive), so the stack trace will begin with a public
+  // asserter. Does nothing if _assert is not present in the stack trace.
+  var privateAssertIndex = -1;
+  for (var i = 0; i < frames.length; i++) {
+    if (frames[i] && frames[i].getName() == '_assert') {
+      privateAssertIndex = i;
+      break;
+    }
+  }
+
+  var canonical = [];
+  for (var i = privateAssertIndex + 1; i <= lastIndex; i++) {
+    canonical.push('> ');
+    if (frames[i]) {
+      canonical.push(frames[i].toCanonicalString());
+    } else {
+      canonical.push('(unknown)');
+    }
+    canonical.push('\n');
+  }
+  return canonical.join('');
+};
+
+
+/**
+ * Parses the browser's native stack trace.
+ * @param {string} stack Stack trace.
+ * @return {!Array<goog.testing.stacktrace.Frame>} Stack frames. The
+ *     unrecognized frames will be nulled out.
+ * @private
+ */
+goog.testing.stacktrace.parse_ = function(stack) {
+  var lines = stack.replace(/\s*$/, '').split('\n');
+  var frames = [];
+  for (var i = 0; i < lines.length; i++) {
+    frames.push(goog.testing.stacktrace.parseStackFrame_(lines[i]));
+  }
+  return frames;
+};
+
+
+/**
+ * Brings the stack trace into a common format across browsers.
+ * @param {string} stack Browser-specific stack trace.
+ * @return {string} Same stack trace in common format.
+ */
+goog.testing.stacktrace.canonicalize = function(stack) {
+  var frames = goog.testing.stacktrace.parse_(stack);
+  return goog.testing.stacktrace.framesToString_(frames);
+};
+
+
+/**
+ * Returns the native stack trace.
+ * @return {string|!Array<!CallSite>}
+ * @private
+ */
+goog.testing.stacktrace.getNativeStack_ = function() {
+  var tmpError = new Error();
+  if (tmpError.stack) {
+    return tmpError.stack;
+  }
+
+  // IE10 will only create a stack trace when the Error is thrown.
+  // We use null.x() to throw an exception because the closure compiler may
+  // replace "throw" with a function call in an attempt to minimize the binary
+  // size, which in turn has the side effect of adding an unwanted stack frame.
+  try {
+    null.x();
+  } catch (e) {
+    return e.stack;
+  }
+  return '';
+};
+
+
+/**
+ * Gets the native stack trace if available otherwise follows the call chain.
+ * @return {string} The stack trace in canonical format.
+ */
+goog.testing.stacktrace.get = function() {
+  var stack = goog.testing.stacktrace.getNativeStack_();
+  var frames;
+  if (!stack) {
+    frames = goog.testing.stacktrace.followCallChain_();
+  } else if (goog.isArray(stack)) {
+    frames = goog.testing.stacktrace.callSitesToFrames_(stack);
+  } else {
+    frames = goog.testing.stacktrace.parse_(stack);
+  }
+  return goog.testing.stacktrace.framesToString_(frames);
+};
+
+
+/**
+ * Converts an array of CallSite (elements of a stack trace in V8) to an array
+ * of Frames.
+ * @param {!Array<!CallSite>} stack The stack as an array of CallSites.
+ * @return {!Array<!goog.testing.stacktrace.Frame>} The stack as an array of
+ *     Frames.
+ * @private
+ */
+goog.testing.stacktrace.callSitesToFrames_ = function(stack) {
+  var frames = [];
+  for (var i = 0; i < stack.length; i++) {
+    var callSite = stack[i];
+    var functionName = callSite.getFunctionName() || 'unknown';
+    var fileName = callSite.getFileName();
+    var path = fileName ? fileName + ':' + callSite.getLineNumber() + ':' +
+        callSite.getColumnNumber() : 'unknown';
+    frames.push(
+        new goog.testing.stacktrace.Frame('', functionName, '', '', path));
+  }
+  return frames;
+};
+
+
+goog.exportSymbol('setDeobfuscateFunctionName',
+    goog.testing.stacktrace.setDeobfuscateFunctionName);
diff --git a/lib/goog/testing/strictmock.js b/lib/goog/testing/strictmock.js
new file mode 100644
index 0000000..c3303d6
--- /dev/null
+++ b/lib/goog/testing/strictmock.js
@@ -0,0 +1,130 @@
+// Copyright 2008 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview This file defines a strict mock implementation.
+ */
+
+goog.provide('goog.testing.StrictMock');
+
+goog.require('goog.array');
+goog.require('goog.testing.Mock');
+
+
+
+/**
+ * This is a mock that verifies that methods are called in the order that they
+ * are specified during the recording phase. Since it verifies order, it
+ * follows 'fail fast' semantics. If it detects a deviation from the
+ * expectations, it will throw an exception and not wait for verify to be
+ * called.
+ * @param {Object|Function} objectToMock The object that should be mocked, or
+ *    the constructor of an object to mock.
+ * @param {boolean=} opt_mockStaticMethods An optional argument denoting that
+ *     a mock should be constructed from the static functions of a class.
+ * @param {boolean=} opt_createProxy An optional argument denoting that
+ *     a proxy for the target mock should be created.
+ * @constructor
+ * @extends {goog.testing.Mock}
+ * @final
+ */
+goog.testing.StrictMock = function(objectToMock, opt_mockStaticMethods,
+    opt_createProxy) {
+  goog.testing.Mock.call(this, objectToMock, opt_mockStaticMethods,
+      opt_createProxy);
+
+  /**
+   * An array of MockExpectations.
+   * @type {Array<goog.testing.MockExpectation>}
+   * @private
+   */
+  this.$expectations_ = [];
+};
+goog.inherits(goog.testing.StrictMock, goog.testing.Mock);
+
+
+/** @override */
+goog.testing.StrictMock.prototype.$recordExpectation = function() {
+  this.$expectations_.push(this.$pendingExpectation);
+};
+
+
+/** @override */
+goog.testing.StrictMock.prototype.$recordCall = function(name, args) {
+  if (this.$expectations_.length == 0) {
+    this.$throwCallException(name, args);
+  }
+
+  // If the current expectation has a different name, make sure it was called
+  // enough and then discard it. We're through with it.
+  var currentExpectation = this.$expectations_[0];
+  while (!this.$verifyCall(currentExpectation, name, args)) {
+
+    // This might be an item which has passed its min, and we can now
+    // look past it, or it might be below its min and generate an error.
+    if (currentExpectation.actualCalls < currentExpectation.minCalls) {
+      this.$throwCallException(name, args, currentExpectation);
+    }
+
+    this.$expectations_.shift();
+    if (this.$expectations_.length < 1) {
+      // Nothing left, but this may be a failed attempt to call the previous
+      // item on the list, which may have been between its min and max.
+      this.$throwCallException(name, args, currentExpectation);
+    }
+    currentExpectation = this.$expectations_[0];
+  }
+
+  if (currentExpectation.maxCalls == 0) {
+    this.$throwCallException(name, args);
+  }
+
+  currentExpectation.actualCalls++;
+  // If we hit the max number of calls for this expectation, we're finished
+  // with it.
+  if (currentExpectation.actualCalls == currentExpectation.maxCalls) {
+    this.$expectations_.shift();
+  }
+
+  return this.$do(currentExpectation, args);
+};
+
+
+/** @override */
+goog.testing.StrictMock.prototype.$reset = function() {
+  goog.testing.StrictMock.superClass_.$reset.call(this);
+
+  goog.array.clear(this.$expectations_);
+};
+
+
+/** @override */
+goog.testing.StrictMock.prototype.$verify = function() {
+  goog.testing.StrictMock.superClass_.$verify.call(this);
+
+  while (this.$expectations_.length > 0) {
+    var expectation = this.$expectations_[0];
+    if (expectation.actualCalls < expectation.minCalls) {
+      this.$throwException('Missing a call to ' + expectation.name +
+          '\nExpected: ' + expectation.minCalls + ' but was: ' +
+          expectation.actualCalls);
+
+    } else {
+      // Don't need to check max, that's handled when the call is made
+      this.$expectations_.shift();
+    }
+  }
+};
+
+
diff --git a/lib/goog/testing/testcase.js b/lib/goog/testing/testcase.js
new file mode 100644
index 0000000..c74f664
--- /dev/null
+++ b/lib/goog/testing/testcase.js
@@ -0,0 +1,1629 @@
+// Copyright 2007 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview A class representing a set of test functions to be run.
+ *
+ * Testing code should not have dependencies outside of goog.testing so as to
+ * reduce the chance of masking missing dependencies.
+ *
+ * This file does not compile correctly with --collapse_properties. Use
+ * --property_renaming=ALL_UNQUOTED instead.
+ *
+ */
+
+goog.provide('goog.testing.TestCase');
+goog.provide('goog.testing.TestCase.Error');
+goog.provide('goog.testing.TestCase.Order');
+goog.provide('goog.testing.TestCase.Result');
+goog.provide('goog.testing.TestCase.Test');
+
+
+goog.require('goog.Promise');
+goog.require('goog.Thenable');
+goog.require('goog.asserts');
+goog.require('goog.dom.TagName');
+goog.require('goog.object');
+goog.require('goog.testing.asserts');
+goog.require('goog.testing.stacktrace');
+
+
+
+/**
+ * A class representing a JsUnit test case.  A TestCase is made up of a number
+ * of test functions which can be run.  Individual test cases can override the
+ * following functions to set up their test environment:
+ *   - runTests - completely override the test's runner
+ *   - setUpPage - called before any of the test functions are run
+ *   - tearDownPage - called after all tests are finished
+ *   - setUp - called before each of the test functions
+ *   - tearDown - called after each of the test functions
+ *   - shouldRunTests - called before a test run, all tests are skipped if it
+ *                      returns false.  Can be used to disable tests on browsers
+ *                      where they aren't expected to pass.
+ *
+ * Use {@link #autoDiscoverLifecycle} and {@link #autoDiscoverTests}
+ *
+ * @param {string=} opt_name The name of the test case, defaults to
+ *     'Untitled Test Case'.
+ * @constructor
+ */
+goog.testing.TestCase = function(opt_name) {
+  /**
+   * A name for the test case.
+   * @type {string}
+   * @private
+   */
+  this.name_ = opt_name || 'Untitled Test Case';
+
+  /**
+   * Array of test functions that can be executed.
+   * @type {!Array<!goog.testing.TestCase.Test>}
+   * @private
+   */
+  this.tests_ = [];
+
+  /**
+   * Set of test names and/or indices to execute, or null if all tests should
+   * be executed.
+   *
+   * Indices are included to allow automation tools to run a subset of the
+   * tests without knowing the exact contents of the test file.
+   *
+   * Indices should only be used with SORTED ordering.
+   *
+   * Example valid values:
+   * <ul>
+   * <li>[testName]
+   * <li>[testName1, testName2]
+   * <li>[2] - will run the 3rd test in the order specified
+   * <li>[1,3,5]
+   * <li>[testName1, testName2, 3, 5] - will work
+   * <ul>
+   * @type {Object}
+   * @private
+   */
+  this.testsToRun_ = null;
+
+  /**
+   * The order to run the auto-discovered tests in.
+   * @type {string}
+   */
+  this.order = goog.testing.TestCase.Order.SORTED;
+
+  /** @private {function(!goog.testing.TestCase.Result)} */
+  this.runNextTestCallback_ = goog.nullFunction;
+
+  /**
+   * The number of {@link runNextTest_} frames currently on the stack.
+   * When this exceeds {@link MAX_STACK_DEPTH_}, test execution is rescheduled
+   * for a later tick of the event loop.
+   * @see {finishTestInvocation_}
+   * @private {number}
+   */
+  this.depth_ = 0;
+
+  /** @private {goog.testing.TestCase.Test} */
+  this.curTest_ = null;
+
+  /**
+   * Object used to encapsulate the test results.
+   * @type {!goog.testing.TestCase.Result}
+   * @protected
+   * @suppress {underscore|visibility}
+   */
+  this.result_ = new goog.testing.TestCase.Result(this);
+
+  /**
+   * The maximum time in milliseconds a promise returned from a test function
+   * may remain pending before the test fails due to timeout.
+   * @type {number}
+   */
+  this.promiseTimeout = 1000; // 1s
+};
+
+
+/**
+ * The order to run the auto-discovered tests.
+ * @enum {string}
+ */
+goog.testing.TestCase.Order = {
+  /**
+   * This is browser dependent and known to be different in FF and Safari
+   * compared to others.
+   */
+  NATURAL: 'natural',
+
+  /** Random order. */
+  RANDOM: 'random',
+
+  /** Sorted based on the name. */
+  SORTED: 'sorted'
+};
+
+
+/**
+ * @return {string} The name of the test.
+ */
+goog.testing.TestCase.prototype.getName = function() {
+  return this.name_;
+};
+
+
+/**
+ * The maximum amount of time in milliseconds that the test case can take
+ * before it is forced to yield and reschedule. This prevents the test runner
+ * from blocking the browser and potentially hurting the test harness.
+ * @type {number}
+ */
+goog.testing.TestCase.maxRunTime = 200;
+
+
+/**
+ * The maximum number of {@link runNextTest_} frames that can be on the stack
+ * before the test case is forced to yield and reschedule. Although modern
+ * browsers can handle thousands of stack frames, this is set conservatively
+ * because maximum stack depth has never been standardized, and engine-specific
+ * techniques like tail cail optimization can affect the exact depth.
+ * @private @const
+ */
+goog.testing.TestCase.MAX_STACK_DEPTH_ = 50;
+
+
+/**
+ * Save a reference to {@code window.setTimeout}, so any code that overrides the
+ * default behavior (the MockClock, for example) doesn't affect our runner.
+ * @type {function((Function|string), number=, *=): number}
+ * @private
+ */
+goog.testing.TestCase.protectedSetTimeout_ = goog.global.setTimeout;
+
+
+/**
+ * Save a reference to {@code window.clearTimeout}, so any code that overrides
+ * the default behavior (e.g. MockClock) doesn't affect our runner.
+ * @type {function((null|number|undefined)): void}
+ * @private
+ */
+goog.testing.TestCase.protectedClearTimeout_ = goog.global.clearTimeout;
+
+
+/**
+ * Save a reference to {@code window.Date}, so any code that overrides
+ * the default behavior doesn't affect our runner.
+ * @type {function(new: Date)}
+ * @private
+ */
+goog.testing.TestCase.protectedDate_ = Date;
+
+
+/**
+ * Saved string referencing goog.global.setTimeout's string serialization.  IE
+ * sometimes fails to uphold equality for setTimeout, but the string version
+ * stays the same.
+ * @type {string}
+ * @private
+ */
+goog.testing.TestCase.setTimeoutAsString_ = String(goog.global.setTimeout);
+
+
+/**
+ * TODO(user) replace this with prototype.currentTest.
+ * Name of the current test that is running, or null if none is running.
+ * @type {?string}
+ */
+goog.testing.TestCase.currentTestName = null;
+
+
+/**
+ * Avoid a dependency on goog.userAgent and keep our own reference of whether
+ * the browser is IE.
+ * @type {boolean}
+ */
+goog.testing.TestCase.IS_IE = typeof opera == 'undefined' &&
+    !!goog.global.navigator &&
+    goog.global.navigator.userAgent.indexOf('MSIE') != -1;
+
+
+/**
+ * Exception object that was detected before a test runs.
+ * @type {*}
+ * @protected
+ */
+goog.testing.TestCase.prototype.exceptionBeforeTest;
+
+
+/**
+ * Whether the test case has ever tried to execute.
+ * @type {boolean}
+ */
+goog.testing.TestCase.prototype.started = false;
+
+
+/**
+ * Whether the test case is running.
+ * @type {boolean}
+ */
+goog.testing.TestCase.prototype.running = false;
+
+
+/**
+ * Timestamp for when the test was started.
+ * @type {number}
+ * @private
+ */
+goog.testing.TestCase.prototype.startTime_ = 0;
+
+
+/**
+ * Time since the last batch of tests was started, if batchTime exceeds
+ * {@link #maxRunTime} a timeout will be used to stop the tests blocking the
+ * browser and a new batch will be started.
+ * @type {number}
+ * @private
+ */
+goog.testing.TestCase.prototype.batchTime_ = 0;
+
+
+/**
+ * Pointer to the current test.
+ * @type {number}
+ * @private
+ */
+goog.testing.TestCase.prototype.currentTestPointer_ = 0;
+
+
+/**
+ * Optional callback that will be executed when the test has finalized.
+ * @type {Function}
+ * @private
+ */
+goog.testing.TestCase.prototype.onCompleteCallback_ = null;
+
+
+/**
+ * Adds a new test to the test case.
+ * @param {!goog.testing.TestCase.Test} test The test to add.
+ */
+goog.testing.TestCase.prototype.add = function(test) {
+  goog.asserts.assert(test);
+  if (this.started) {
+    throw Error('Tests cannot be added after execute() has been called. ' +
+                'Test: ' + test.name);
+  }
+
+  this.tests_.push(test);
+};
+
+
+/**
+ * Creates and adds a new test.
+ *
+ * Convenience function to make syntax less awkward when not using automatic
+ * test discovery.
+ *
+ * @param {string} name The test name.
+ * @param {!Function} ref Reference to the test function.
+ * @param {!Object=} opt_scope Optional scope that the test function should be
+ *     called in.
+ */
+goog.testing.TestCase.prototype.addNewTest = function(name, ref, opt_scope) {
+  var test = new goog.testing.TestCase.Test(name, ref, opt_scope || this);
+  this.add(test);
+};
+
+
+/**
+ * Sets the tests.
+ * @param {!Array<goog.testing.TestCase.Test>} tests A new test array.
+ * @protected
+ */
+goog.testing.TestCase.prototype.setTests = function(tests) {
+  this.tests_ = tests;
+};
+
+
+/**
+ * Gets the tests.
+ * @return {!Array<goog.testing.TestCase.Test>} The test array.
+ */
+goog.testing.TestCase.prototype.getTests = function() {
+  return this.tests_;
+};
+
+
+/**
+ * Returns the number of tests contained in the test case.
+ * @return {number} The number of tests.
+ */
+goog.testing.TestCase.prototype.getCount = function() {
+  return this.tests_.length;
+};
+
+
+/**
+ * Returns the number of tests actually run in the test case, i.e. subtracting
+ * any which are skipped.
+ * @return {number} The number of un-ignored tests.
+ */
+goog.testing.TestCase.prototype.getActuallyRunCount = function() {
+  return this.testsToRun_ ? goog.object.getCount(this.testsToRun_) : 0;
+};
+
+
+/**
+ * Returns the current test and increments the pointer.
+ * @return {goog.testing.TestCase.Test} The current test case.
+ */
+goog.testing.TestCase.prototype.next = function() {
+  var test;
+  while ((test = this.tests_[this.currentTestPointer_++])) {
+    if (!this.testsToRun_ || this.testsToRun_[test.name] ||
+        this.testsToRun_[this.currentTestPointer_ - 1]) {
+      return test;
+    }
+  }
+  return null;
+};
+
+
+/**
+ * Resets the test case pointer, so that next returns the first test.
+ */
+goog.testing.TestCase.prototype.reset = function() {
+  this.currentTestPointer_ = 0;
+  this.result_ = new goog.testing.TestCase.Result(this);
+};
+
+
+/**
+ * Sets the callback function that should be executed when the tests have
+ * completed.
+ * @param {Function} fn The callback function.
+ */
+goog.testing.TestCase.prototype.setCompletedCallback = function(fn) {
+  this.onCompleteCallback_ = fn;
+};
+
+
+/**
+ * @param {goog.testing.TestCase.Order} order The sort order for running tests.
+ */
+goog.testing.TestCase.prototype.setOrder = function(order) {
+  this.order = order;
+};
+
+
+/**
+ * @param {Object<string, boolean>} testsToRun Set of tests to run. Entries in
+ *     the set may be test names, like "testFoo", or numeric indicies. Only
+ *     tests identified by name or by index will be executed.
+ */
+goog.testing.TestCase.prototype.setTestsToRun = function(testsToRun) {
+  this.testsToRun_ = testsToRun;
+};
+
+
+/**
+ * Can be overridden in test classes to indicate whether the tests in a case
+ * should be run in that particular situation.  For example, this could be used
+ * to stop tests running in a particular browser, where browser support for
+ * the class under test was absent.
+ * @return {boolean} Whether any of the tests in the case should be run.
+ */
+goog.testing.TestCase.prototype.shouldRunTests = function() {
+  return true;
+};
+
+
+/**
+ * Executes the tests, yielding asynchronously if execution time exceeds
+ * {@link maxRunTime}. There is no guarantee that the test case has finished
+ * once this method has returned. To be notified when the test case
+ * has finished, use {@link #setCompletedCallback} or
+ * {@link #runTestsReturningPromise}.
+ */
+goog.testing.TestCase.prototype.execute = function() {
+  if (!this.prepareForRun_()) {
+    return;
+  }
+  this.log('Starting tests: ' + this.name_);
+  this.cycleTests();
+};
+
+
+/**
+ * Sets up the internal state of the test case for a run.
+ * @return {boolean} If false, preparation failed because the test case
+ *     is not supposed to run in the present environment.
+ * @private
+ */
+goog.testing.TestCase.prototype.prepareForRun_ = function() {
+  this.started = true;
+  this.reset();
+  this.startTime_ = this.now();
+  this.running = true;
+  this.result_.totalCount = this.getCount();
+  if (!this.shouldRunTests()) {
+    this.log('shouldRunTests() returned false, skipping these tests.');
+    this.result_.testSuppressed = true;
+    this.finalize();
+    return false;
+  }
+  return true;
+};
+
+
+/**
+ * Finalizes the test case, called when the tests have finished executing.
+ */
+goog.testing.TestCase.prototype.finalize = function() {
+  this.saveMessage('Done');
+
+  this.tearDownPage();
+
+  var restoredSetTimeout =
+      goog.testing.TestCase.protectedSetTimeout_ == goog.global.setTimeout &&
+      goog.testing.TestCase.protectedClearTimeout_ == goog.global.clearTimeout;
+  if (!restoredSetTimeout && goog.testing.TestCase.IS_IE &&
+      String(goog.global.setTimeout) ==
+          goog.testing.TestCase.setTimeoutAsString_) {
+    // In strange cases, IE's value of setTimeout *appears* to change, but
+    // the string representation stays stable.
+    restoredSetTimeout = true;
+  }
+
+  if (!restoredSetTimeout) {
+    var message = 'ERROR: Test did not restore setTimeout and clearTimeout';
+    this.saveMessage(message);
+    var err = new goog.testing.TestCase.Error(this.name_, message);
+    this.result_.errors.push(err);
+  }
+  goog.global.clearTimeout = goog.testing.TestCase.protectedClearTimeout_;
+  goog.global.setTimeout = goog.testing.TestCase.protectedSetTimeout_;
+  this.endTime_ = this.now();
+  this.running = false;
+  this.result_.runTime = this.endTime_ - this.startTime_;
+  this.result_.numFilesLoaded = this.countNumFilesLoaded_();
+  this.result_.complete = true;
+
+  this.log(this.result_.getSummary());
+  if (this.result_.isSuccess()) {
+    this.log('Tests complete');
+  } else {
+    this.log('Tests Failed');
+  }
+  if (this.onCompleteCallback_) {
+    var fn = this.onCompleteCallback_;
+    // Execute's the completed callback in the context of the global object.
+    fn();
+    this.onCompleteCallback_ = null;
+  }
+};
+
+
+/**
+ * Saves a message to the result set.
+ * @param {string} message The message to save.
+ */
+goog.testing.TestCase.prototype.saveMessage = function(message) {
+  this.result_.messages.push(this.getTimeStamp_() + '  ' + message);
+};
+
+
+/**
+ * @return {boolean} Whether the test case is running inside the multi test
+ *     runner.
+ */
+goog.testing.TestCase.prototype.isInsideMultiTestRunner = function() {
+  var top = goog.global['top'];
+  return top && typeof top['_allTests'] != 'undefined';
+};
+
+
+/**
+ * Logs an object to the console, if available.
+ * @param {*} val The value to log. Will be ToString'd.
+ */
+goog.testing.TestCase.prototype.log = function(val) {
+  if (!this.isInsideMultiTestRunner() && goog.global.console) {
+    if (typeof val == 'string') {
+      val = this.getTimeStamp_() + ' : ' + val;
+    }
+    if (val instanceof Error && val.stack) {
+      // Chrome does console.log asynchronously in a different process
+      // (http://code.google.com/p/chromium/issues/detail?id=50316).
+      // This is an acute problem for Errors, which almost never survive.
+      // Grab references to the immutable strings so they survive.
+      goog.global.console.log(val, val.message, val.stack);
+      // TODO(gboyer): Consider for Chrome cloning any object if we can ensure
+      // there are no circular references.
+    } else {
+      goog.global.console.log(val);
+    }
+  }
+};
+
+
+/**
+ * @return {boolean} Whether the test was a success.
+ */
+goog.testing.TestCase.prototype.isSuccess = function() {
+  return !!this.result_ && this.result_.isSuccess();
+};
+
+
+/**
+ * Returns a string detailing the results from the test.
+ * @param {boolean=} opt_verbose If true results will include data about all
+ *     tests, not just what failed.
+ * @return {string} The results from the test.
+ */
+goog.testing.TestCase.prototype.getReport = function(opt_verbose) {
+  var rv = [];
+
+  if (this.running) {
+    rv.push(this.name_ + ' [RUNNING]');
+  } else {
+    var label = this.result_.isSuccess() ? 'PASSED' : 'FAILED';
+    rv.push(this.name_ + ' [' + label + ']');
+  }
+
+  if (goog.global.location) {
+    rv.push(this.trimPath_(goog.global.location.href));
+  }
+
+  rv.push(this.result_.getSummary());
+
+  if (opt_verbose) {
+    rv.push('.', this.result_.messages.join('\n'));
+  } else if (!this.result_.isSuccess()) {
+    rv.push(this.result_.errors.join('\n'));
+  }
+
+  rv.push(' ');
+
+  return rv.join('\n');
+};
+
+
+/**
+ * Returns the test results.
+ * @return {!goog.testing.TestCase.Result}
+ * @package
+ */
+goog.testing.TestCase.prototype.getResult = function() {
+  return this.result_;
+};
+
+
+/**
+ * Returns the amount of time it took for the test to run.
+ * @return {number} The run time, in milliseconds.
+ */
+goog.testing.TestCase.prototype.getRunTime = function() {
+  return this.result_.runTime;
+};
+
+
+/**
+ * Returns the number of script files that were loaded in order to run the test.
+ * @return {number} The number of script files.
+ */
+goog.testing.TestCase.prototype.getNumFilesLoaded = function() {
+  return this.result_.numFilesLoaded;
+};
+
+
+/**
+ * Returns the test results object: a map from test names to a list of test
+ * failures (if any exist).
+ * @return {!Object<string, !Array<string>>} Tests results object.
+ */
+goog.testing.TestCase.prototype.getTestResults = function() {
+  return this.result_.resultsByName;
+};
+
+
+/**
+ * Executes each of the tests, yielding asynchronously if execution time
+ * exceeds {@link #maxRunTime}. There is no guarantee that the test case
+ * has finished execution once this method has returned.
+ * To be notified when the test case has finished execution, use
+ * {@link #setCompletedCallback} or {@link #runTestsReturningPromise}.
+ *
+ * Overridable by the individual test case.  This allows test cases to defer
+ * when the test is actually started.  If overridden, finalize must be called
+ * by the test to indicate it has finished.
+ */
+goog.testing.TestCase.prototype.runTests = function() {
+  try {
+    this.setUpPage();
+  } catch (e) {
+    this.exceptionBeforeTest = e;
+  }
+  this.execute();
+};
+
+
+/**
+ * Executes each of the tests, returning a promise that resolves with the
+ * test results once they are done running.
+ * @return {!IThenable<!goog.testing.TestCase.Result>}
+ * @final
+ * @package
+ */
+goog.testing.TestCase.prototype.runTestsReturningPromise = function() {
+  try {
+    this.setUpPage();
+  } catch (e) {
+    this.exceptionBeforeTest = e;
+  }
+  if (!this.prepareForRun_()) {
+    return goog.Promise.resolve(this.result_);
+  }
+  this.log('Starting tests: ' + this.name_);
+  this.saveMessage('Start');
+  this.batchTime_ = this.now();
+  return new goog.Promise(function(resolve) {
+    this.runNextTestCallback_ = resolve;
+    this.runNextTest_();
+  }, this);
+};
+
+
+/**
+ * Executes the next test method synchronously or with promises, depending on
+ * the test method's return value.
+ *
+ * If the test method returns a promise, the next test method will run once
+ * the promise is resolved or rejected. If the test method does not
+ * return a promise, it is assumed to be synchronous, and execution proceeds
+ * immediately to the next test method. This means that test cases can run
+ * partially synchronously and partially asynchronously, depending on
+ * the return values of their test methods. In particular, a test case
+ * executes synchronously until the first promise is returned from a
+ * test method (or until a resource limit is reached; see
+ * {@link finishTestInvocation_}).
+ * @private
+ */
+goog.testing.TestCase.prototype.runNextTest_ = function() {
+  this.curTest_ = this.next();
+  if (!this.curTest_ || !this.running) {
+    this.finalize();
+    this.runNextTestCallback_(this.result_);
+    return;
+  }
+  this.result_.runCount++;
+  this.log('Running test: ' + this.curTest_.name);
+  if (this.maybeFailTestEarly(this.curTest_)) {
+    this.finishTestInvocation_();
+    return;
+  }
+  goog.testing.TestCase.currentTestName = this.curTest_.name;
+  this.invokeTestFunction_(
+      this.setUp, this.safeRunTest_, this.safeTearDown_,
+      'setUp');
+};
+
+
+/**
+ * Calls the given test function, handling errors appropriately.
+ * @private
+ */
+goog.testing.TestCase.prototype.safeRunTest_ = function() {
+  this.invokeTestFunction_(
+      goog.bind(this.curTest_.ref, this.curTest_.scope),
+      this.safeTearDown_,
+      this.safeTearDown_,
+      this.curTest_.name);
+};
+
+
+/**
+ * Calls {@link tearDown}, handling errors appropriately.
+ * @param {*=} opt_error Error associated with the test, if any.
+ * @private
+ */
+goog.testing.TestCase.prototype.safeTearDown_ = function(opt_error) {
+  if (arguments.length == 1) {
+    this.doError(this.curTest_, opt_error);
+  }
+  this.invokeTestFunction_(
+      this.tearDown, this.finishTestInvocation_, this.finishTestInvocation_,
+      'tearDown');
+};
+
+
+/**
+ * Calls the given {@code fn}, then calls either {@code onSuccess} or
+ * {@code onFailure}, either synchronously or using promises, depending on
+ * {@code fn}'s return value.
+ *
+ * If {@code fn} throws an exception, {@code onFailure} is called immediately
+ * with the exception.
+ *
+ * If {@code fn} returns a promise, and the promise is eventually resolved,
+ * {@code onSuccess} is called with no arguments. If the promise is eventually
+ * rejected, {@code onFailure} is called with the rejection reason.
+ *
+ * Otherwise, if {@code fn} neither returns a promise nor throws an exception,
+ * {@code onSuccess} is called immediately with no arguments.
+ *
+ * {@code fn}, {@code onSuccess}, and {@code onFailure} are all called with
+ * the TestCase instance as the method receiver.
+ *
+ * @param {function()} fn The function to call.
+ * @param {function()} onSuccess Success callback.
+ * @param {function(*)} onFailure Failure callback.
+ * @param {string} fnName Name of the function being invoked e.g. 'setUp'.
+ * @private
+ */
+goog.testing.TestCase.prototype.invokeTestFunction_ = function(
+    fn, onSuccess, onFailure, fnName) {
+  try {
+    var retval = fn.call(this);
+    if (goog.Thenable.isImplementedBy(retval) ||
+        goog.isFunction(retval && retval['then'])) {
+      var self = this;
+      retval = this.rejectIfPromiseTimesOut_(
+          retval, self.promiseTimeout,
+          'Timed out while waiting for a promise returned from ' + fnName +
+          ' to resolve. Set goog.testing.TestCase.getActiveTestCase()' +
+          '.promiseTimeout to adjust the timeout.');
+      retval.then(
+          function() {
+            self.resetBatchTimeAfterPromise_();
+            onSuccess.call(self);
+          },
+          function(e) {
+            self.resetBatchTimeAfterPromise_();
+            onFailure.call(self, e);
+          });
+    } else {
+      onSuccess.call(this);
+    }
+  } catch (e) {
+    onFailure.call(this, e);
+  }
+};
+
+
+/**
+ * Resets the batch run timer. This should only be called after resolving a
+ * promise since Promise.then() has an implicit yield.
+ * @private
+ */
+goog.testing.TestCase.prototype.resetBatchTimeAfterPromise_ = function() {
+  this.batchTime_ = this.now();
+};
+
+
+/**
+ * Finishes up bookkeeping for the current test function, and schedules
+ * the next test function to run, either immediately or asychronously.
+ * @param {*=} opt_error Optional error resulting from the test invocation.
+ * @private
+ */
+goog.testing.TestCase.prototype.finishTestInvocation_ = function(opt_error) {
+  if (arguments.length == 1) {
+    this.doError(this.curTest_, opt_error);
+  }
+
+  // If no errors have been recorded for the test, it is a success.
+  if (!(this.curTest_.name in this.result_.resultsByName) ||
+      !this.result_.resultsByName[this.curTest_.name].length) {
+    this.doSuccess(this.curTest_);
+  }
+
+  goog.testing.TestCase.currentTestName = null;
+
+  // If the test case has consumed too much time or stack space,
+  // yield to avoid blocking the browser. Otherwise, proceed to the next test.
+  if (this.depth_ > goog.testing.TestCase.MAX_STACK_DEPTH_ ||
+      this.now() - this.batchTime_ > goog.testing.TestCase.maxRunTime) {
+    this.saveMessage('Breaking async');
+    this.timeout(goog.bind(this.startNextBatch_, this), 0);
+  } else {
+    ++this.depth_;
+    this.runNextTest_();
+  }
+};
+
+
+/**
+ * Start a new batch to tests after yielding, resetting batchTime and depth.
+ * @private
+ */
+goog.testing.TestCase.prototype.startNextBatch_ = function() {
+  this.batchTime_ = this.now();
+  this.depth_ = 0;
+  this.runNextTest_();
+};
+
+
+/**
+ * Reorders the tests depending on the {@code order} field.
+ * @private
+ */
+goog.testing.TestCase.prototype.orderTests_ = function() {
+  switch (this.order) {
+    case goog.testing.TestCase.Order.RANDOM:
+      // Fisher-Yates shuffle
+      var i = this.tests_.length;
+      while (i > 1) {
+        // goog.math.randomInt is inlined to reduce dependencies.
+        var j = Math.floor(Math.random() * i); // exclusive
+        i--;
+        var tmp = this.tests_[i];
+        this.tests_[i] = this.tests_[j];
+        this.tests_[j] = tmp;
+      }
+      break;
+
+    case goog.testing.TestCase.Order.SORTED:
+      this.tests_.sort(function(t1, t2) {
+        if (t1.name == t2.name) {
+          return 0;
+        }
+        return t1.name < t2.name ? -1 : 1;
+      });
+      break;
+
+      // Do nothing for NATURAL.
+  }
+};
+
+
+/**
+ * Gets list of objects that potentially contain test cases. For IE 8 and below,
+ * this is the global "this" (for properties set directly on the global this or
+ * window) and the RuntimeObject (for global variables and functions). For all
+ * other browsers, the array simply contains the global this.
+ *
+ * @param {string=} opt_prefix An optional prefix. If specified, only get things
+ *     under this prefix. Note that the prefix is only honored in IE, since it
+ *     supports the RuntimeObject:
+ *     http://msdn.microsoft.com/en-us/library/ff521039%28VS.85%29.aspx
+ *     TODO: Remove this option.
+ * @return {!Array<!Object>} A list of objects that should be inspected.
+ */
+goog.testing.TestCase.prototype.getGlobals = function(opt_prefix) {
+  return goog.testing.TestCase.getGlobals(opt_prefix);
+};
+
+
+/**
+ * Gets list of objects that potentially contain test cases. For IE 8 and below,
+ * this is the global "this" (for properties set directly on the global this or
+ * window) and the RuntimeObject (for global variables and functions). For all
+ * other browsers, the array simply contains the global this.
+ *
+ * @param {string=} opt_prefix An optional prefix. If specified, only get things
+ *     under this prefix. Note that the prefix is only honored in IE, since it
+ *     supports the RuntimeObject:
+ *     http://msdn.microsoft.com/en-us/library/ff521039%28VS.85%29.aspx
+ *     TODO: Remove this option.
+ * @return {!Array<!Object>} A list of objects that should be inspected.
+ */
+goog.testing.TestCase.getGlobals = function(opt_prefix) {
+  // Look in the global scope for most browsers, on IE we use the little known
+  // RuntimeObject which holds references to all globals. We reference this
+  // via goog.global so that there isn't an aliasing that throws an exception
+  // in Firefox.
+  return typeof goog.global['RuntimeObject'] != 'undefined' ?
+      [goog.global['RuntimeObject']((opt_prefix || '') + '*'), goog.global] :
+      [goog.global];
+};
+
+
+/**
+ * @return {?goog.testing.TestCase} currently active test case or null if not
+ *     test is currently running.
+ */
+goog.testing.TestCase.getActiveTestCase = function() {
+  var gTestRunner = goog.global['G_testRunner'];
+  if (gTestRunner && gTestRunner.testCase) {
+    return gTestRunner.testCase;
+  } else {
+    return null;
+  }
+};
+
+
+/**
+ * Gets called before any tests are executed.  Can be overridden to set up the
+ * environment for the whole test case.
+ */
+goog.testing.TestCase.prototype.setUpPage = function() {};
+
+
+/**
+ * Gets called after all tests have been executed.  Can be overridden to tear
+ * down the entire test case.
+ */
+goog.testing.TestCase.prototype.tearDownPage = function() {};
+
+
+/**
+ * Gets called before every goog.testing.TestCase.Test is been executed. Can be
+ * overridden to add set up functionality to each test.
+ */
+goog.testing.TestCase.prototype.setUp = function() {};
+
+
+/**
+ * Gets called after every goog.testing.TestCase.Test has been executed. Can be
+ * overriden to add tear down functionality to each test.
+ */
+goog.testing.TestCase.prototype.tearDown = function() {};
+
+
+/**
+ * @return {string} The function name prefix used to auto-discover tests.
+ */
+goog.testing.TestCase.prototype.getAutoDiscoveryPrefix = function() {
+  return 'test';
+};
+
+
+/**
+ * @return {number} Time since the last batch of tests was started.
+ * @protected
+ */
+goog.testing.TestCase.prototype.getBatchTime = function() {
+  return this.batchTime_;
+};
+
+
+/**
+ * @param {number} batchTime Time since the last batch of tests was started.
+ * @protected
+ */
+goog.testing.TestCase.prototype.setBatchTime = function(batchTime) {
+  this.batchTime_ = batchTime;
+};
+
+
+/**
+ * Creates a {@code goog.testing.TestCase.Test} from an auto-discovered
+ *     function.
+ * @param {string} name The name of the function.
+ * @param {function() : void} ref The auto-discovered function.
+ * @return {!goog.testing.TestCase.Test} The newly created test.
+ * @protected
+ */
+goog.testing.TestCase.prototype.createTestFromAutoDiscoveredFunction =
+    function(name, ref) {
+  return new goog.testing.TestCase.Test(name, ref, goog.global);
+};
+
+
+/**
+ * Adds any functions defined on 'obj' (the global object, by default)
+ * that correspond to lifecycle events for the test case. Overrides
+ * setUp, tearDown, setUpPage, tearDownPage, runTests, and shouldRunTests
+ * if they are defined on 'obj'.
+ * @param {!Object=} opt_obj Defaults to goog.global.
+ */
+goog.testing.TestCase.prototype.autoDiscoverLifecycle = function(opt_obj) {
+  var obj = opt_obj || goog.global;
+  if (obj['setUp']) {
+    this.setUp = goog.bind(obj['setUp'], obj);
+  }
+  if (obj['tearDown']) {
+    this.tearDown = goog.bind(obj['tearDown'], obj);
+  }
+  if (obj['setUpPage']) {
+    this.setUpPage = goog.bind(obj['setUpPage'], obj);
+  }
+  if (obj['tearDownPage']) {
+    this.tearDownPage = goog.bind(obj['tearDownPage'], obj);
+  }
+  if (obj['runTests']) {
+    this.runTests = goog.bind(obj['runTests'], obj);
+  }
+  if (obj['shouldRunTests']) {
+    this.shouldRunTests = goog.bind(obj['shouldRunTests'], obj);
+  }
+};
+
+
+// TODO(johnlenz): make this package private
+/**
+ * @param {!Object} obj  An object from which to extract test and lifecycle
+ * methods.
+ */
+goog.testing.TestCase.prototype.setTestObj = function(obj) {
+  // Drop any previously added (likely auto-discovered) tests, only one source
+  // of discovered test and life-cycle methods is allowed.
+  goog.asserts.assert(this.tests_.length == 0,
+      'Test methods have already been configured.');
+
+  var regex = new RegExp('^' + this.getAutoDiscoveryPrefix());
+  for (var name in obj) {
+    if (regex.test(name)) {
+      var testMethod = obj[name];
+      if (goog.isFunction(testMethod)) {
+        this.addNewTest(name, testMethod, obj);
+      }
+    }
+  }
+
+  this.autoDiscoverLifecycle(obj);
+};
+
+
+/**
+ * Adds any functions defined in the global scope that are prefixed with "test"
+ * to the test case.
+ */
+goog.testing.TestCase.prototype.autoDiscoverTests = function() {
+  var prefix = this.getAutoDiscoveryPrefix();
+  var testSources = this.getGlobals(prefix);
+
+  var foundTests = [];
+
+  for (var i = 0; i < testSources.length; i++) {
+    var testSource = testSources[i];
+    for (var name in testSource) {
+      if ((new RegExp('^' + prefix)).test(name)) {
+        var ref;
+        try {
+          ref = testSource[name];
+        } catch (ex) {
+          // NOTE(brenneman): When running tests from a file:// URL on Firefox
+          // 3.5 for Windows, any reference to goog.global.sessionStorage raises
+          // an "Operation is not supported" exception. Ignore any exceptions
+          // raised by simply accessing global properties.
+          ref = undefined;
+        }
+
+        if (goog.isFunction(ref)) {
+          foundTests.push(this.createTestFromAutoDiscoveredFunction(name, ref));
+        }
+      }
+    }
+  }
+
+  for (var i = 0; i < foundTests.length; i++) {
+    this.add(foundTests[i]);
+  }
+  this.orderTests_();
+
+  this.log(this.getCount() + ' tests auto-discovered');
+
+  // TODO(user): Do this as a separate call. Unfortunately, a lot of projects
+  // currently override autoDiscoverTests and expect lifecycle events to be
+  // registered as a part of this call.
+  this.autoDiscoverLifecycle();
+};
+
+
+/**
+ * Checks to see if the test should be marked as failed before it is run.
+ *
+ * If there was an error in setUpPage, we treat that as a failure for all tests
+ * and mark them all as having failed.
+ *
+ * @param {goog.testing.TestCase.Test} testCase The current test case.
+ * @return {boolean} Whether the test was marked as failed.
+ * @protected
+ */
+goog.testing.TestCase.prototype.maybeFailTestEarly = function(testCase) {
+  if (this.exceptionBeforeTest) {
+    // We just use the first error to report an error on a failed test.
+    testCase.name = 'setUpPage for ' + testCase.name;
+    this.doError(testCase, this.exceptionBeforeTest);
+    return true;
+  }
+  return false;
+};
+
+
+/**
+ * Cycles through the tests, yielding asynchronously if the execution time
+ * execeeds {@link #maxRunTime}. In particular, there is no guarantee that
+ * the test case has finished execution once this method has returned.
+ * To be notified when the test case has finished execution, use
+ * {@link #setCompletedCallback} or {@link #runTestsReturningPromise}.
+ */
+goog.testing.TestCase.prototype.cycleTests = function() {
+  this.saveMessage('Start');
+  this.batchTime_ = this.now();
+  if (this.running) {
+    this.runNextTestCallback_ = goog.nullFunction;
+    // Kick off the tests. runNextTest_ will schedule all of the tests,
+    // using a mixture of synchronous and asynchronous strategies.
+    this.runNextTest_();
+  }
+};
+
+
+/**
+ * Counts the number of files that were loaded for dependencies that are
+ * required to run the test.
+ * @return {number} The number of files loaded.
+ * @private
+ */
+goog.testing.TestCase.prototype.countNumFilesLoaded_ = function() {
+  var scripts = document.getElementsByTagName(goog.dom.TagName.SCRIPT);
+  var count = 0;
+  for (var i = 0, n = scripts.length; i < n; i++) {
+    if (scripts[i].src) {
+      count++;
+    }
+  }
+  return count;
+};
+
+
+/**
+ * Calls a function after a delay, using the protected timeout.
+ * @param {Function} fn The function to call.
+ * @param {number} time Delay in milliseconds.
+ * @return {number} The timeout id.
+ * @protected
+ */
+goog.testing.TestCase.prototype.timeout = function(fn, time) {
+  // NOTE: invoking protectedSetTimeout_ as a member of goog.testing.TestCase
+  // would result in an Illegal Invocation error. The method must be executed
+  // with the global context.
+  var protectedSetTimeout = goog.testing.TestCase.protectedSetTimeout_;
+  return protectedSetTimeout(fn, time);
+};
+
+
+/**
+ * Clears a timeout created by {@code this.timeout()}.
+ * @param {number} id A timeout id.
+ * @protected
+ */
+goog.testing.TestCase.prototype.clearTimeout = function(id) {
+  // NOTE: see execution note for protectedSetTimeout above.
+  var protectedClearTimeout = goog.testing.TestCase.protectedClearTimeout_;
+  protectedClearTimeout(id);
+};
+
+
+/**
+ * @return {number} The current time in milliseconds, don't use goog.now as some
+ *     tests override it.
+ * @protected
+ */
+goog.testing.TestCase.prototype.now = function() {
+  // Cannot use "new goog.testing.TestCase.protectedDate_()" due to b/8323223.
+  var protectedDate = goog.testing.TestCase.protectedDate_;
+  return new protectedDate().getTime();
+};
+
+
+/**
+ * Returns the current time.
+ * @return {string} HH:MM:SS.
+ * @private
+ */
+goog.testing.TestCase.prototype.getTimeStamp_ = function() {
+  // Cannot use "new goog.testing.TestCase.protectedDate_()" due to b/8323223.
+  var protectedDate = goog.testing.TestCase.protectedDate_;
+  var d = new protectedDate();
+
+  // Ensure millis are always 3-digits
+  var millis = '00' + d.getMilliseconds();
+  millis = millis.substr(millis.length - 3);
+
+  return this.pad_(d.getHours()) + ':' + this.pad_(d.getMinutes()) + ':' +
+         this.pad_(d.getSeconds()) + '.' + millis;
+};
+
+
+/**
+ * Pads a number to make it have a leading zero if it's less than 10.
+ * @param {number} number The number to pad.
+ * @return {string} The resulting string.
+ * @private
+ */
+goog.testing.TestCase.prototype.pad_ = function(number) {
+  return number < 10 ? '0' + number : String(number);
+};
+
+
+/**
+ * Trims a path to be only that after google3.
+ * @param {string} path The path to trim.
+ * @return {string} The resulting string.
+ * @private
+ */
+goog.testing.TestCase.prototype.trimPath_ = function(path) {
+  return path.substring(path.indexOf('google3') + 8);
+};
+
+
+/**
+ * Handles a test that passed.
+ * @param {goog.testing.TestCase.Test} test The test that passed.
+ * @protected
+ */
+goog.testing.TestCase.prototype.doSuccess = function(test) {
+  this.result_.successCount++;
+  // An empty list of error messages indicates that the test passed.
+  // If we already have a failure for this test, do not set to empty list.
+  if (!(test.name in this.result_.resultsByName)) {
+    this.result_.resultsByName[test.name] = [];
+  }
+  var message = test.name + ' : PASSED';
+  this.saveMessage(message);
+  this.log(message);
+};
+
+
+/**
+ * Handles a test that failed.
+ * @param {goog.testing.TestCase.Test} test The test that failed.
+ * @param {*=} opt_e The exception object associated with the
+ *     failure or a string.
+ * @protected
+ */
+goog.testing.TestCase.prototype.doError = function(test, opt_e) {
+  var message = test.name + ' : FAILED';
+  this.log(message);
+  this.saveMessage(message);
+  var err = this.logError(test.name, opt_e);
+  this.result_.errors.push(err);
+  if (test.name in this.result_.resultsByName) {
+    this.result_.resultsByName[test.name].push(err.toString());
+  } else {
+    this.result_.resultsByName[test.name] = [err.toString()];
+  }
+};
+
+
+/**
+ * @param {string} name Failed test name.
+ * @param {*=} opt_e The exception object associated with the
+ *     failure or a string.
+ * @return {!goog.testing.TestCase.Error} Error object.
+ */
+goog.testing.TestCase.prototype.logError = function(name, opt_e) {
+  var errMsg = null;
+  var stack = null;
+  if (opt_e) {
+    this.log(opt_e);
+    if (goog.isString(opt_e)) {
+      errMsg = opt_e;
+    } else {
+      errMsg = opt_e.message || opt_e.description || opt_e.toString();
+      stack = opt_e.stack ? goog.testing.stacktrace.canonicalize(opt_e.stack) :
+          opt_e['stackTrace'];
+    }
+  } else {
+    errMsg = 'An unknown error occurred';
+  }
+  var err = new goog.testing.TestCase.Error(name, errMsg, stack);
+
+  // Avoid double logging.
+  if (!opt_e || !opt_e['isJsUnitException'] ||
+      !opt_e['loggedJsUnitException']) {
+    this.saveMessage(err.toString());
+  }
+  if (opt_e && opt_e['isJsUnitException']) {
+    opt_e['loggedJsUnitException'] = true;
+  }
+
+  return err;
+};
+
+
+
+/**
+ * A class representing a single test function.
+ * @param {string} name The test name.
+ * @param {Function} ref Reference to the test function.
+ * @param {Object=} opt_scope Optional scope that the test function should be
+ *     called in.
+ * @constructor
+ */
+goog.testing.TestCase.Test = function(name, ref, opt_scope) {
+  /**
+   * The name of the test.
+   * @type {string}
+   */
+  this.name = name;
+
+  /**
+   * Reference to the test function.
+   * @type {Function}
+   */
+  this.ref = ref;
+
+  /**
+   * Scope that the test function should be called in.
+   * @type {Object}
+   */
+  this.scope = opt_scope || null;
+};
+
+
+/**
+ * Executes the test function.
+ * @package
+ */
+goog.testing.TestCase.Test.prototype.execute = function() {
+  this.ref.call(this.scope);
+};
+
+
+
+/**
+ * A class for representing test results.  A bag of public properties.
+ * @param {goog.testing.TestCase} testCase The test case that owns this result.
+ * @constructor
+ * @final
+ */
+goog.testing.TestCase.Result = function(testCase) {
+  /**
+   * The test case that owns this result.
+   * @type {goog.testing.TestCase}
+   * @private
+   */
+  this.testCase_ = testCase;
+
+  /**
+   * Total number of tests that should have been run.
+   * @type {number}
+   */
+  this.totalCount = 0;
+
+  /**
+   * Total number of tests that were actually run.
+   * @type {number}
+   */
+  this.runCount = 0;
+
+  /**
+   * Number of successful tests.
+   * @type {number}
+   */
+  this.successCount = 0;
+
+  /**
+   * The amount of time the tests took to run.
+   * @type {number}
+   */
+  this.runTime = 0;
+
+  /**
+   * The number of files loaded to run this test.
+   * @type {number}
+   */
+  this.numFilesLoaded = 0;
+
+  /**
+   * Whether this test case was suppressed by shouldRunTests() returning false.
+   * @type {boolean}
+   */
+  this.testSuppressed = false;
+
+  /**
+   * Test results for each test that was run. The test name is always added
+   * as the key in the map, and the array of strings is an optional list
+   * of failure messages. If the array is empty, the test passed. Otherwise,
+   * the test failed.
+   * @type {!Object<string, !Array<string>>}
+   */
+  this.resultsByName = {};
+
+  /**
+   * Errors encountered while running the test.
+   * @type {!Array<goog.testing.TestCase.Error>}
+   */
+  this.errors = [];
+
+  /**
+   * Messages to show the user after running the test.
+   * @type {!Array<string>}
+   */
+  this.messages = [];
+
+  /**
+   * Whether the tests have completed.
+   * @type {boolean}
+   */
+  this.complete = false;
+};
+
+
+/**
+ * @return {boolean} Whether the test was successful.
+ */
+goog.testing.TestCase.Result.prototype.isSuccess = function() {
+  return this.complete && this.errors.length == 0;
+};
+
+
+/**
+ * @return {string} A summary of the tests, including total number of tests that
+ *     passed, failed, and the time taken.
+ */
+goog.testing.TestCase.Result.prototype.getSummary = function() {
+  var summary = this.runCount + ' of ' + this.totalCount + ' tests run in ' +
+      this.runTime + 'ms.\n';
+  if (this.testSuppressed) {
+    summary += 'Tests not run because shouldRunTests() returned false.';
+  } else {
+    var failures = this.totalCount - this.successCount;
+    var suppressionMessage = '';
+
+    var countOfRunTests = this.testCase_.getActuallyRunCount();
+    if (countOfRunTests) {
+      failures = countOfRunTests - this.successCount;
+      suppressionMessage = ', ' +
+          (this.totalCount - countOfRunTests) + ' suppressed by querystring';
+    }
+    summary += this.successCount + ' passed, ' +
+        failures + ' failed' + suppressionMessage + '.\n' +
+        Math.round(this.runTime / this.runCount) + ' ms/test. ' +
+        this.numFilesLoaded + ' files loaded.';
+  }
+
+  return summary;
+};
+
+
+/**
+ * Initializes the given test case with the global test runner 'G_testRunner'.
+ * @param {goog.testing.TestCase} testCase The test case to install.
+ */
+goog.testing.TestCase.initializeTestRunner = function(testCase) {
+  testCase.autoDiscoverTests();
+
+  if (goog.global.location) {
+    var search = goog.global.location.search;
+    testCase.setOrder(goog.testing.TestCase.parseOrder_(search) ||
+        goog.testing.TestCase.Order.SORTED);
+    testCase.setTestsToRun(goog.testing.TestCase.parseRunTests_(search));
+  }
+
+  var gTestRunner = goog.global['G_testRunner'];
+  if (gTestRunner) {
+    gTestRunner['initialize'](testCase);
+  } else {
+    throw Error('G_testRunner is undefined. Please ensure goog.testing.jsunit' +
+        ' is included.');
+  }
+};
+
+
+/**
+ * Parses URL query parameters for the 'order' parameter.
+ * @param {string} search The URL query string.
+ * @return {?goog.testing.TestCase.Order} The sort order for running tests.
+ * @private
+ */
+goog.testing.TestCase.parseOrder_ = function(search) {
+  var order = null;
+  var orderMatch = search.match(
+      /(?:\?|&)order=(natural|random|sorted)/i);
+  if (orderMatch) {
+    order = /** @type {goog.testing.TestCase.Order} */ (
+        orderMatch[1].toLowerCase());
+  }
+  return order;
+};
+
+
+/**
+ * Parses URL query parameters for the 'runTests' parameter.
+ * @param {string} search The URL query string.
+ * @return {Object<string, boolean>} A set of test names or test indices to be
+ *     run by the test runner.
+ * @private
+ */
+goog.testing.TestCase.parseRunTests_ = function(search) {
+  var testsToRun = null;
+  var runTestsMatch = search.match(/(?:\?|&)runTests=([^?&]+)/i);
+  if (runTestsMatch) {
+    testsToRun = {};
+    var arr = runTestsMatch[1].split(',');
+    for (var i = 0, len = arr.length; i < len; i++) {
+      testsToRun[arr[i]] = true;
+    }
+  }
+  return testsToRun;
+};
+
+
+/**
+ * Wraps provided promise and returns a new promise which will be rejected
+ * if the original promise does not settle within the given timeout.
+ * @param {!IThenable<T>} promise
+ * @param {number} timeoutInMs Number of milliseconds to wait for the promise to
+ *     settle before failing it with a timeout error.
+ * @param {string} errorMsg Error message to use if the promise times out.
+ * @return {!goog.Promise<T>} A promise that will settle with the original
+       promise unless the timeout is exceeded.
+ *     errror.
+ * @template T
+ * @private
+ */
+goog.testing.TestCase.prototype.rejectIfPromiseTimesOut_ =
+    function(promise, timeoutInMs, errorMsg) {
+  var self = this;
+  var start = this.now();
+  return new goog.Promise(function(resolve, reject) {
+    var timeoutId = self.timeout(function() {
+      var elapsed = self.now() - start;
+      reject(new Error(errorMsg + '\nElapsed time: ' + elapsed + 'ms.'));
+    }, timeoutInMs);
+    promise.then(resolve, reject);
+    var clearTimeout = goog.bind(self.clearTimeout, self, timeoutId);
+    promise.then(clearTimeout, clearTimeout);
+  });
+};
+
+
+
+/**
+ * A class representing an error thrown by the test
+ * @param {string} source The name of the test which threw the error.
+ * @param {string} message The error message.
+ * @param {string=} opt_stack A string showing the execution stack.
+ * @constructor
+ * @final
+ */
+goog.testing.TestCase.Error = function(source, message, opt_stack) {
+  /**
+   * The name of the test which threw the error.
+   * @type {string}
+   */
+  this.source = source;
+
+  /**
+   * Reference to the test function.
+   * @type {string}
+   */
+  this.message = message;
+
+  /**
+   * The stack.
+   * @type {?string}
+   */
+  this.stack = null;
+
+  if (opt_stack) {
+    this.stack = opt_stack;
+  } else {
+    // Attempt to capture a stack trace.
+    if (Error.captureStackTrace) {
+      // See https://code.google.com/p/v8-wiki/wiki/JavaScriptStackTraceApi
+      Error.captureStackTrace(this, goog.testing.TestCase.Error);
+    } else {
+      var stack = new Error().stack;
+      if (stack) {
+        this.stack = stack;
+      }
+    }
+  }
+};
+
+
+/**
+ * Returns a string representing the error object.
+ * @return {string} A string representation of the error.
+ * @override
+ */
+goog.testing.TestCase.Error.prototype.toString = function() {
+  return 'ERROR in ' + this.source + '\n' +
+      this.message + (this.stack ? '\n' + this.stack : '');
+};
diff --git a/lib/goog/testing/testrunner.js b/lib/goog/testing/testrunner.js
new file mode 100644
index 0000000..ad9c5fd
--- /dev/null
+++ b/lib/goog/testing/testrunner.js
@@ -0,0 +1,440 @@
+// Copyright 2007 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview The test runner is a singleton object that is used to execute
+ * a goog.testing.TestCases, display the results, and expose the results to
+ * Selenium for automation.  If a TestCase hasn't been registered with the
+ * runner by the time window.onload occurs, the testRunner will try to auto-
+ * discover JsUnit style test pages.
+ *
+ * The hooks for selenium are (see http://go/selenium-hook-setup):-
+ *  - Boolean G_testRunner.isFinished()
+ *  - Boolean G_testRunner.isSuccess()
+ *  - String G_testRunner.getReport()
+ *  - number G_testRunner.getRunTime()
+ *  - Object<string, Array<string>> G_testRunner.getTestResults()
+ *
+ * Testing code should not have dependencies outside of goog.testing so as to
+ * reduce the chance of masking missing dependencies.
+ *
+ */
+
+goog.provide('goog.testing.TestRunner');
+
+goog.require('goog.dom.TagName');
+goog.require('goog.testing.TestCase');
+
+
+
+/**
+ * Construct a test runner.
+ *
+ * NOTE(user): This is currently pretty weird, I'm essentially trying to
+ * create a wrapper that the Selenium test can hook into to query the state of
+ * the running test case, while making goog.testing.TestCase general.
+ *
+ * @constructor
+ */
+goog.testing.TestRunner = function() {
+  /**
+   * Errors that occurred in the window.
+   * @type {Array<string>}
+   */
+  this.errors = [];
+};
+
+
+/**
+ * Reference to the active test case.
+ * @type {goog.testing.TestCase?}
+ */
+goog.testing.TestRunner.prototype.testCase = null;
+
+
+/**
+ * Whether the test runner has been initialized yet.
+ * @type {boolean}
+ */
+goog.testing.TestRunner.prototype.initialized = false;
+
+
+/**
+ * Element created in the document to add test results to.
+ * @type {Element}
+ * @private
+ */
+goog.testing.TestRunner.prototype.logEl_ = null;
+
+
+/**
+ * Function to use when filtering errors.
+ * @type {(function(string))?}
+ * @private
+ */
+goog.testing.TestRunner.prototype.errorFilter_ = null;
+
+
+/**
+ * Whether an empty test case counts as an error.
+ * @type {boolean}
+ * @private
+ */
+goog.testing.TestRunner.prototype.strict_ = true;
+
+
+/**
+ * Initializes the test runner.
+ * @param {goog.testing.TestCase} testCase The test case to initialize with.
+ */
+goog.testing.TestRunner.prototype.initialize = function(testCase) {
+  if (this.testCase && this.testCase.running) {
+    throw Error('The test runner is already waiting for a test to complete');
+  }
+  this.testCase = testCase;
+  this.initialized = true;
+};
+
+
+/**
+ * By default, the test runner is strict, and fails if it runs an empty
+ * test case.
+ * @param {boolean} strict Whether the test runner should fail on an empty
+ *     test case.
+ */
+goog.testing.TestRunner.prototype.setStrict = function(strict) {
+  this.strict_ = strict;
+};
+
+
+/**
+ * @return {boolean} Whether the test runner should fail on an empty
+ *     test case.
+ */
+goog.testing.TestRunner.prototype.isStrict = function() {
+  return this.strict_;
+};
+
+
+/**
+ * Returns true if the test runner is initialized.
+ * Used by Selenium Hooks.
+ * @return {boolean} Whether the test runner is active.
+ */
+goog.testing.TestRunner.prototype.isInitialized = function() {
+  return this.initialized;
+};
+
+
+/**
+ * Returns true if the test runner is finished.
+ * Used by Selenium Hooks.
+ * @return {boolean} Whether the test runner is active.
+ */
+goog.testing.TestRunner.prototype.isFinished = function() {
+  return this.errors.length > 0 ||
+      this.initialized && !!this.testCase && this.testCase.started &&
+      !this.testCase.running;
+};
+
+
+/**
+ * Returns true if the test case didn't fail.
+ * Used by Selenium Hooks.
+ * @return {boolean} Whether the current test returned successfully.
+ */
+goog.testing.TestRunner.prototype.isSuccess = function() {
+  return !this.hasErrors() && !!this.testCase && this.testCase.isSuccess();
+};
+
+
+/**
+ * Returns true if the test case runner has errors that were caught outside of
+ * the test case.
+ * @return {boolean} Whether there were JS errors.
+ */
+goog.testing.TestRunner.prototype.hasErrors = function() {
+  return this.errors.length > 0;
+};
+
+
+/**
+ * Logs an error that occurred.  Used in the case of environment setting up
+ * an onerror handler.
+ * @param {string} msg Error message.
+ */
+goog.testing.TestRunner.prototype.logError = function(msg) {
+  if (!this.errorFilter_ || this.errorFilter_.call(null, msg)) {
+    this.errors.push(msg);
+  }
+};
+
+
+/**
+ * Log failure in current running test.
+ * @param {Error} ex Exception.
+ */
+goog.testing.TestRunner.prototype.logTestFailure = function(ex) {
+  var testName = /** @type {string} */ (goog.testing.TestCase.currentTestName);
+  if (this.testCase) {
+    this.testCase.logError(testName, ex);
+  } else {
+    // NOTE: Do not forget to log the original exception raised.
+    throw new Error('Test runner not initialized with a test case. Original ' +
+                    'exception: ' + ex.message);
+  }
+};
+
+
+/**
+ * Sets a function to use as a filter for errors.
+ * @param {function(string)} fn Filter function.
+ */
+goog.testing.TestRunner.prototype.setErrorFilter = function(fn) {
+  this.errorFilter_ = fn;
+};
+
+
+/**
+ * Returns a report of the test case that ran.
+ * Used by Selenium Hooks.
+ * @param {boolean=} opt_verbose If true results will include data about all
+ *     tests, not just what failed.
+ * @return {string} A report summary of the test.
+ */
+goog.testing.TestRunner.prototype.getReport = function(opt_verbose) {
+  var report = [];
+  if (this.testCase) {
+    report.push(this.testCase.getReport(opt_verbose));
+  }
+  if (this.errors.length > 0) {
+    report.push('JavaScript errors detected by test runner:');
+    report.push.apply(report, this.errors);
+    report.push('\n');
+  }
+  return report.join('\n');
+};
+
+
+/**
+ * Returns the amount of time it took for the test to run.
+ * Used by Selenium Hooks.
+ * @return {number} The run time, in milliseconds.
+ */
+goog.testing.TestRunner.prototype.getRunTime = function() {
+  return this.testCase ? this.testCase.getRunTime() : 0;
+};
+
+
+/**
+ * Returns the number of script files that were loaded in order to run the test.
+ * @return {number} The number of script files.
+ */
+goog.testing.TestRunner.prototype.getNumFilesLoaded = function() {
+  return this.testCase ? this.testCase.getNumFilesLoaded() : 0;
+};
+
+
+/**
+ * Executes a test case and prints the results to the window.
+ */
+goog.testing.TestRunner.prototype.execute = function() {
+  if (!this.testCase) {
+    throw Error('The test runner must be initialized with a test case ' +
+                'before execute can be called.');
+  }
+
+  if (this.strict_ && this.testCase.getCount() == 0) {
+    throw Error(
+        'No tests found in given test case: ' +
+        this.testCase.getName() + ' ' +
+        'By default, the test runner fails if a test case has no tests. ' +
+        'To modify this behavior, see goog.testing.TestRunner\'s ' +
+        'setStrict() method, or G_testRunner.setStrict()');
+  }
+
+  this.testCase.setCompletedCallback(goog.bind(this.onComplete_, this));
+  if (goog.testing.TestRunner.shouldUsePromises_(this.testCase)) {
+    this.testCase.runTestsReturningPromise();
+  } else {
+    this.testCase.runTests();
+  }
+};
+
+
+/**
+ * @param {!goog.testing.TestCase} testCase
+ * @return {boolean}
+ * @private
+ */
+goog.testing.TestRunner.shouldUsePromises_ = function(testCase) {
+  return testCase.constructor === goog.testing.TestCase;
+};
+
+
+/**
+ * Writes the results to the document when the test case completes.
+ * @private
+ */
+goog.testing.TestRunner.prototype.onComplete_ = function() {
+  var log = this.testCase.getReport(true);
+  if (this.errors.length > 0) {
+    log += '\n' + this.errors.join('\n');
+  }
+
+  if (!this.logEl_) {
+    var el = document.getElementById('closureTestRunnerLog');
+    if (el == null) {
+      el = document.createElement(goog.dom.TagName.DIV);
+      document.body.appendChild(el);
+    }
+    this.logEl_ = el;
+  }
+
+  // Highlight the page to indicate the overall outcome.
+  this.writeLog(log);
+
+  // TODO(chrishenry): Make this work with multiple test cases (b/8603638).
+  var runAgainLink = document.createElement(goog.dom.TagName.A);
+  runAgainLink.style.display = 'inline-block';
+  runAgainLink.style.fontSize = 'small';
+  runAgainLink.style.marginBottom = '16px';
+  runAgainLink.href = '';
+  runAgainLink.onclick = goog.bind(function() {
+    this.execute();
+    return false;
+  }, this);
+  runAgainLink.innerHTML = 'Run again without reloading';
+  this.logEl_.appendChild(runAgainLink);
+};
+
+
+/**
+ * Writes a nicely formatted log out to the document.
+ * @param {string} log The string to write.
+ */
+goog.testing.TestRunner.prototype.writeLog = function(log) {
+  var lines = log.split('\n');
+  for (var i = 0; i < lines.length; i++) {
+    var line = lines[i];
+    var color;
+    var isFailOrError = /FAILED/.test(line) || /ERROR/.test(line);
+    if (/PASSED/.test(line)) {
+      color = 'darkgreen';
+    } else if (isFailOrError) {
+      color = 'darkred';
+    } else {
+      color = '#333';
+    }
+    var div = document.createElement(goog.dom.TagName.DIV);
+    if (line.substr(0, 2) == '> ') {
+      // The stack trace may contain links so it has to be interpreted as HTML.
+      div.innerHTML = line;
+    } else {
+      div.appendChild(document.createTextNode(line));
+    }
+
+    var testNameMatch =
+        /(\S+) (\[[^\]]*] )?: (FAILED|ERROR|PASSED)/.exec(line);
+    if (testNameMatch) {
+      // Build a URL to run the test individually.  If this test was already
+      // part of another subset test, we need to overwrite the old runTests
+      // query parameter.  We also need to do this without bringing in any
+      // extra dependencies, otherwise we could mask missing dependency bugs.
+      var newSearch = 'runTests=' + testNameMatch[1];
+      var search = window.location.search;
+      if (search) {
+        var oldTests = /runTests=([^&]*)/.exec(search);
+        if (oldTests) {
+          newSearch = search.substr(0, oldTests.index) +
+                      newSearch +
+                      search.substr(oldTests.index + oldTests[0].length);
+        } else {
+          newSearch = search + '&' + newSearch;
+        }
+      } else {
+        newSearch = '?' + newSearch;
+      }
+      var href = window.location.href;
+      var hash = window.location.hash;
+      if (hash && hash.charAt(0) != '#') {
+        hash = '#' + hash;
+      }
+      href = href.split('#')[0].split('?')[0] + newSearch + hash;
+
+      // Add the link.
+      var a = document.createElement(goog.dom.TagName.A);
+      a.innerHTML = '(run individually)';
+      a.style.fontSize = '0.8em';
+      a.style.color = '#888';
+      a.href = href;
+      div.appendChild(document.createTextNode(' '));
+      div.appendChild(a);
+    }
+
+    div.style.color = color;
+    div.style.font = 'normal 100% monospace';
+    div.style.wordWrap = 'break-word';
+    if (i == 0) {
+      // Highlight the first line as a header that indicates the test outcome.
+      div.style.padding = '20px';
+      div.style.marginBottom = '10px';
+      if (isFailOrError) {
+        div.style.border = '5px solid ' + color;
+        div.style.backgroundColor = '#ffeeee';
+      } else {
+        div.style.border = '1px solid black';
+        div.style.backgroundColor = '#eeffee';
+      }
+    }
+
+    try {
+      div.style.whiteSpace = 'pre-wrap';
+    } catch (e) {
+      // NOTE(brenneman): IE raises an exception when assigning to pre-wrap.
+      // Thankfully, it doesn't collapse whitespace when using monospace fonts,
+      // so it will display correctly if we ignore the exception.
+    }
+
+    if (i < 2) {
+      div.style.fontWeight = 'bold';
+    }
+    this.logEl_.appendChild(div);
+  }
+};
+
+
+/**
+ * Logs a message to the current test case.
+ * @param {string} s The text to output to the log.
+ */
+goog.testing.TestRunner.prototype.log = function(s) {
+  if (this.testCase) {
+    this.testCase.log(s);
+  }
+};
+
+
+// TODO(nnaze): Properly handle serving test results when multiple test cases
+// are run.
+/**
+ * @return {Object<string, !Array<string>>} A map of test names to a list of
+ * test failures (if any) to provide formatted data for the test runner.
+ */
+goog.testing.TestRunner.prototype.getTestResults = function() {
+  if (this.testCase) {
+    return this.testCase.getTestResults();
+  }
+  return null;
+};
diff --git a/lib/goog/testing/watchers.js b/lib/goog/testing/watchers.js
new file mode 100644
index 0000000..a69dc3e
--- /dev/null
+++ b/lib/goog/testing/watchers.js
@@ -0,0 +1,46 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Simple notifiers for the Closure testing framework.
+ *
+ * @author johnlenz@google.com (John Lenz)
+ */
+
+goog.provide('goog.testing.watchers');
+
+
+/** @private {!Array.<function()>} */
+goog.testing.watchers.resetWatchers_ = [];
+
+
+/**
+ * Fires clock reset watching functions.
+ */
+goog.testing.watchers.signalClockReset = function() {
+  var watchers = goog.testing.watchers.resetWatchers_;
+  for (var i = 0; i < watchers.length; i++) {
+    goog.testing.watchers.resetWatchers_[i]();
+  }
+};
+
+
+/**
+ * Enqueues a function to be called when the clock used for setTimeout is reset.
+ * @param {function()} fn
+ */
+goog.testing.watchers.watchClockReset = function(fn) {
+  goog.testing.watchers.resetWatchers_.push(fn);
+};
+
diff --git a/lib/goog/uri/uri.js b/lib/goog/uri/uri.js
index 7eac018..96dd743 100644
--- a/lib/goog/uri/uri.js
+++ b/lib/goog/uri/uri.js
@@ -48,6 +48,12 @@ goog.require('goog.uri.utils.StandardQueryParam');
  * -- so<code>goog.Uri.parse('/foo%20bar').getPath()</code> will return the
  * decoded path, <code>/foo bar</code>.
  *
+ * Reserved characters (see RFC 3986 section 2.2) can be present in
+ * their percent-encoded form in scheme, domain, and path URI components and
+ * will not be auto-decoded. For example:
+ * <code>goog.Uri.parse('rel%61tive/path%2fto/resource').getPath()</code> will
+ * return <code>relative/path%2fto/resource</code>.
+ *
  * The constructor accepts an optional unparsed, raw URI string.  The parser
  * is relaxed, so special characters that aren't escaped but don't cause
  * ambiguities will not cause parse failures.
@@ -61,9 +67,66 @@ goog.require('goog.uri.utils.StandardQueryParam');
  * @param {boolean=} opt_ignoreCase If true, #getParameterValue will ignore
  * the case of the parameter name.
  *
+ * @throws URIError If opt_uri is provided and URI is malformed (that is,
+ *     if decodeURIComponent fails on any of the URI components).
  * @constructor
+ * @struct
  */
 goog.Uri = function(opt_uri, opt_ignoreCase) {
+  /**
+   * Scheme such as "http".
+   * @private {string}
+   */
+  this.scheme_ = '';
+
+  /**
+   * User credentials in the form "username:password".
+   * @private {string}
+   */
+  this.userInfo_ = '';
+
+  /**
+   * Domain part, e.g. "www.google.com".
+   * @private {string}
+   */
+  this.domain_ = '';
+
+  /**
+   * Port, e.g. 8080.
+   * @private {?number}
+   */
+  this.port_ = null;
+
+  /**
+   * Path, e.g. "/tests/img.png".
+   * @private {string}
+   */
+  this.path_ = '';
+
+  /**
+   * The fragment without the #.
+   * @private {string}
+   */
+  this.fragment_ = '';
+
+  /**
+   * Whether or not this Uri should be treated as Read Only.
+   * @private {boolean}
+   */
+  this.isReadOnly_ = false;
+
+  /**
+   * Whether or not to ignore case when comparing query params.
+   * @private {boolean}
+   */
+  this.ignoreCase_ = false;
+
+  /**
+   * Object representing query data.
+   * @private {!goog.Uri.QueryData}
+   */
+  this.queryData_;
+
   // Parse in the uri string
   var m;
   if (opt_uri instanceof goog.Uri) {
@@ -120,78 +183,6 @@ goog.Uri.preserveParameterTypesCompatibilityFlag = false;
 goog.Uri.RANDOM_PARAM = goog.uri.utils.StandardQueryParam.RANDOM;
 
 
-/**
- * Scheme such as "http".
- * @type {string}
- * @private
- */
-goog.Uri.prototype.scheme_ = '';
-
-
-/**
- * User credentials in the form "username:password".
- * @type {string}
- * @private
- */
-goog.Uri.prototype.userInfo_ = '';
-
-
-/**
- * Domain part, e.g. "www.google.com".
- * @type {string}
- * @private
- */
-goog.Uri.prototype.domain_ = '';
-
-
-/**
- * Port, e.g. 8080.
- * @type {?number}
- * @private
- */
-goog.Uri.prototype.port_ = null;
-
-
-/**
- * Path, e.g. "/tests/img.png".
- * @type {string}
- * @private
- */
-goog.Uri.prototype.path_ = '';
-
-
-/**
- * Object representing query data.
- * @type {!goog.Uri.QueryData}
- * @private
- */
-goog.Uri.prototype.queryData_;
-
-
-/**
- * The fragment without the #.
- * @type {string}
- * @private
- */
-goog.Uri.prototype.fragment_ = '';
-
-
-/**
- * Whether or not this Uri should be treated as Read Only.
- * @type {boolean}
- * @private
- */
-goog.Uri.prototype.isReadOnly_ = false;
-
-
-/**
- * Whether or not to ignore case when comparing query params.
- * @type {boolean}
- * @private
- */
-goog.Uri.prototype.ignoreCase_ = false;
-
-
 /**
  * @return {string} The string form of the url.
  * @override
@@ -202,20 +193,20 @@ goog.Uri.prototype.toString = function() {
   var scheme = this.getScheme();
   if (scheme) {
     out.push(goog.Uri.encodeSpecialChars_(
-        scheme, goog.Uri.reDisallowedInSchemeOrUserInfo_), ':');
+        scheme, goog.Uri.reDisallowedInSchemeOrUserInfo_, true), ':');
   }
 
   var domain = this.getDomain();
-  if (domain) {
+  if (domain || scheme == 'file') {
     out.push('//');
 
     var userInfo = this.getUserInfo();
     if (userInfo) {
       out.push(goog.Uri.encodeSpecialChars_(
-          userInfo, goog.Uri.reDisallowedInSchemeOrUserInfo_), '@');
+          userInfo, goog.Uri.reDisallowedInSchemeOrUserInfo_, true), '@');
     }
 
-    out.push(goog.string.urlEncode(domain));
+    out.push(goog.Uri.removeDoubleEncoding_(goog.string.urlEncode(domain)));
 
     var port = this.getPort();
     if (port != null) {
@@ -232,7 +223,8 @@ goog.Uri.prototype.toString = function() {
         path,
         path.charAt(0) == '/' ?
             goog.Uri.reDisallowedInAbsolutePath_ :
-            goog.Uri.reDisallowedInRelativePath_));
+            goog.Uri.reDisallowedInRelativePath_,
+        true));
   }
 
   var query = this.getEncodedQuery();
@@ -263,7 +255,7 @@ goog.Uri.prototype.toString = function() {
  * Additionally, if relative URI has a non-empty path, all ".." and "."
  * segments will be resolved, as described in RFC 3986.
  *
- * @param {goog.Uri} relativeUri The relative URI to resolve.
+ * @param {!goog.Uri} relativeUri The relative URI to resolve.
  * @return {!goog.Uri} The resolved URI.
  */
 goog.Uri.prototype.resolve = function(relativeUri) {
@@ -339,7 +331,7 @@ goog.Uri.prototype.resolve = function(relativeUri) {
 
 /**
  * Clones the URI instance.
- * @return {!goog.Uri} New instance of the URI objcet.
+ * @return {!goog.Uri} New instance of the URI object.
  */
 goog.Uri.prototype.clone = function() {
   return new goog.Uri(this);
@@ -356,13 +348,16 @@ goog.Uri.prototype.getScheme = function() {
 
 /**
  * Sets the scheme/protocol.
+ * @throws URIError If opt_decode is true and newScheme is malformed (that is,
+ *     if decodeURIComponent fails).
  * @param {string} newScheme New scheme value.
  * @param {boolean=} opt_decode Optional param for whether to decode new value.
  * @return {!goog.Uri} Reference to this URI object.
  */
 goog.Uri.prototype.setScheme = function(newScheme, opt_decode) {
   this.enforceReadOnly();
-  this.scheme_ = opt_decode ? goog.Uri.decodeOrEmpty_(newScheme) : newScheme;
+  this.scheme_ = opt_decode ? goog.Uri.decodeOrEmpty_(newScheme, true) :
+      newScheme;
 
   // remove an : at the end of the scheme so somebody can pass in
   // window.location.protocol
@@ -391,6 +386,8 @@ goog.Uri.prototype.getUserInfo = function() {
 
 /**
  * Sets the userInfo.
+ * @throws URIError If opt_decode is true and newUserInfo is malformed (that is,
+ *     if decodeURIComponent fails).
  * @param {string} newUserInfo New userInfo value.
  * @param {boolean=} opt_decode Optional param for whether to decode new value.
  * @return {!goog.Uri} Reference to this URI object.
@@ -421,13 +418,16 @@ goog.Uri.prototype.getDomain = function() {
 
 /**
  * Sets the domain.
+ * @throws URIError If opt_decode is true and newDomain is malformed (that is,
+ *     if decodeURIComponent fails).
  * @param {string} newDomain New domain value.
  * @param {boolean=} opt_decode Optional param for whether to decode new value.
  * @return {!goog.Uri} Reference to this URI object.
  */
 goog.Uri.prototype.setDomain = function(newDomain, opt_decode) {
   this.enforceReadOnly();
-  this.domain_ = opt_decode ? goog.Uri.decodeOrEmpty_(newDomain) : newDomain;
+  this.domain_ = opt_decode ? goog.Uri.decodeOrEmpty_(newDomain, true) :
+      newDomain;
   return this;
 };
 
@@ -488,13 +488,15 @@ goog.Uri.prototype.getPath = function() {
 
 /**
  * Sets the path.
+ * @throws URIError If opt_decode is true and newPath is malformed (that is,
+ *     if decodeURIComponent fails).
  * @param {string} newPath New path value.
  * @param {boolean=} opt_decode Optional param for whether to decode new value.
  * @return {!goog.Uri} Reference to this URI object.
  */
 goog.Uri.prototype.setPath = function(newPath, opt_decode) {
   this.enforceReadOnly();
-  this.path_ = opt_decode ? goog.Uri.decodeOrEmpty_(newPath) : newPath;
+  this.path_ = opt_decode ? goog.Uri.decodeOrEmpty_(newPath, true) : newPath;
   return this;
 };
 
@@ -571,7 +573,7 @@ goog.Uri.prototype.getDecodedQuery = function() {
 
 /**
  * Returns the query data.
- * @return {goog.Uri.QueryData} QueryData object.
+ * @return {!goog.Uri.QueryData} QueryData object.
  */
 goog.Uri.prototype.getQueryData = function() {
   return this.queryData_;
@@ -624,8 +626,7 @@ goog.Uri.prototype.setParameterValues = function(key, values) {
     values = [String(values)];
   }
 
-  // TODO(nicksantos): This cast shouldn't be necessary.
-  this.queryData_.setValues(key, /** @type {Array} */ (values));
+  this.queryData_.setValues(key, values);
 
   return this;
 };
@@ -635,7 +636,7 @@ goog.Uri.prototype.setParameterValues = function(key, values) {
  * Returns the value<b>s</b> for a given cgi parameter as a list of decoded
  * query parameter values.
  * @param {string} name The parameter to get values for.
- * @return {Array} The values for a given cgi parameter as a list of
+ * @return {!Array<?>} The values for a given cgi parameter as a list of
  *     decoded query parameter values.
  */
 goog.Uri.prototype.getParameterValues = function(name) {
@@ -669,6 +670,8 @@ goog.Uri.prototype.getFragment = function() {
 
 /**
  * Sets the URI fragment.
+ * @throws URIError If opt_decode is true and newFragment is malformed (that is,
+ *     if decodeURIComponent fails).
  * @param {string} newFragment New fragment value.
  * @param {boolean=} opt_decode Optional param for whether to decode new value.
  * @return {!goog.Uri} Reference to this URI object.
@@ -691,7 +694,7 @@ goog.Uri.prototype.hasFragment = function() {
 
 /**
  * Returns true if this has the same domain as that of uri2.
- * @param {goog.Uri} uri2 The URI object to compare to.
+ * @param {!goog.Uri} uri2 The URI object to compare to.
  * @return {boolean} true if same domain; false otherwise.
  */
 goog.Uri.prototype.hasSameDomainAs = function(uri2) {
@@ -792,6 +795,8 @@ goog.Uri.prototype.getIgnoreCase = function() {
  * Creates a uri from the string form.  Basically an alias of new goog.Uri().
  * If a Uri object is passed to parse then it will return a clone of the object.
  *
+ * @throws URIError If parsing the URI is malformed. The passed URI components
+ *     should all be parseable by decodeURIComponent.
  * @param {*} uri Raw URI string or instance of Uri
  *     object.
  * @param {boolean=} opt_ignoreCase Whether to ignore the case of parameter
@@ -907,13 +912,24 @@ goog.Uri.removeDotSegments = function(path) {
 
 /**
  * Decodes a value or returns the empty string if it isn't defined or empty.
+ * @throws URIError If decodeURIComponent fails to decode val.
  * @param {string|undefined} val Value to decode.
+ * @param {boolean=} opt_preserveReserved If true, restricted characters will
+ *     not be decoded.
  * @return {string} Decoded value.
  * @private
  */
-goog.Uri.decodeOrEmpty_ = function(val) {
+goog.Uri.decodeOrEmpty_ = function(val, opt_preserveReserved) {
   // Don't use UrlDecode() here because val is not a query parameter.
-  return val ? decodeURIComponent(val) : '';
+  if (!val) {
+    return '';
+  }
+
+  // decodeURI has the same output for '%2f' and '%252f'. We double encode %25
+  // so that we can distinguish between the 2 inputs. This is later undone by
+  // removeDoubleEncoding_.
+  return opt_preserveReserved ?
+      decodeURI(val.replace(/%25/g, '%2525')) : decodeURIComponent(val);
 };
 
 
@@ -924,12 +940,22 @@ goog.Uri.decodeOrEmpty_ = function(val) {
  *
  * @param {*} unescapedPart The string to encode.
  * @param {RegExp} extra A character set of characters in [\01-\177].
+ * @param {boolean=} opt_removeDoubleEncoding If true, remove double percent
+ *     encoding.
  * @return {?string} null iff unescapedPart == null.
  * @private
  */
-goog.Uri.encodeSpecialChars_ = function(unescapedPart, extra) {
+goog.Uri.encodeSpecialChars_ = function(unescapedPart, extra,
+    opt_removeDoubleEncoding) {
   if (goog.isString(unescapedPart)) {
-    return encodeURI(unescapedPart).replace(extra, goog.Uri.encodeChar_);
+    var encoded = encodeURI(unescapedPart).
+        replace(extra, goog.Uri.encodeChar_);
+    if (opt_removeDoubleEncoding) {
+      // encodeURI double-escapes %XX sequences used to represent restricted
+      // characters in some URI components, remove the double escaping here.
+      encoded = goog.Uri.removeDoubleEncoding_(encoded);
+    }
+    return encoded;
   }
   return null;
 };
@@ -947,6 +973,17 @@ goog.Uri.encodeChar_ = function(ch) {
 };
 
 
+/**
+ * Removes double percent-encoding from a string.
+ * @param  {string} doubleEncodedString String
+ * @return {string} String with double encoding removed.
+ * @private
+ */
+goog.Uri.removeDoubleEncoding_ = function(doubleEncodedString) {
+  return doubleEncodedString.replace(/%25([0-9a-fA-F]{2})/g, '%$1');
+};
+
+
 /**
  * Regular expression for characters that are disallowed in the scheme or
  * userInfo part of the URI.
@@ -958,6 +995,7 @@ goog.Uri.reDisallowedInSchemeOrUserInfo_ = /[#\/\?@]/g;
 
 /**
  * Regular expression for characters that are disallowed in a relative path.
+ * Colon is included due to RFC 3986 3.3.
  * @type {RegExp}
  * @private
  */
@@ -1021,19 +1059,36 @@ goog.Uri.haveSameDomain = function(uri1String, uri2String) {
  * @param {boolean=} opt_ignoreCase If true, ignore the case of the parameter
  *     name in #get.
  * @constructor
+ * @struct
+ * @final
  */
 goog.Uri.QueryData = function(opt_query, opt_uri, opt_ignoreCase) {
+  /**
+   * The map containing name/value or name/array-of-values pairs.
+   * May be null if it requires parsing from the query string.
+   *
+   * We need to use a Map because we cannot guarantee that the key names will
+   * not be problematic for IE.
+   *
+   * @private {goog.structs.Map<string, !Array<*>>}
+   */
+  this.keyMap_ = null;
+
+  /**
+   * The number of params, or null if it requires computing.
+   * @private {?number}
+   */
+  this.count_ = null;
+
   /**
    * Encoded query string, or null if it requires computing from the key map.
-   * @type {?string}
-   * @private
+   * @private {?string}
    */
   this.encodedQuery_ = opt_query || null;
 
   /**
    * If true, ignore the case of the parameter name in #get.
-   * @type {boolean}
-   * @private
+   * @private {boolean}
    */
   this.ignoreCase_ = !!opt_ignoreCase;
 };
@@ -1048,23 +1103,11 @@ goog.Uri.QueryData.prototype.ensureKeyMapInitialized_ = function() {
   if (!this.keyMap_) {
     this.keyMap_ = new goog.structs.Map();
     this.count_ = 0;
-
     if (this.encodedQuery_) {
-      var pairs = this.encodedQuery_.split('&');
-      for (var i = 0; i < pairs.length; i++) {
-        var indexOfEquals = pairs[i].indexOf('=');
-        var name = null;
-        var value = null;
-        if (indexOfEquals >= 0) {
-          name = pairs[i].substring(0, indexOfEquals);
-          value = pairs[i].substring(indexOfEquals + 1);
-        } else {
-          name = pairs[i];
-        }
-        name = goog.string.urlDecode(name);
-        name = this.getKeyName_(name);
-        this.add(name, value ? goog.string.urlDecode(value) : '');
-      }
+      var self = this;
+      goog.uri.utils.parseQueryData(this.encodedQuery_, function(name, value) {
+        self.add(goog.string.urlDecode(name), value);
+      });
     }
   }
 };
@@ -1073,7 +1116,7 @@ goog.Uri.QueryData.prototype.ensureKeyMapInitialized_ = function() {
 /**
  * Creates a new query data instance from a map of names and values.
  *
- * @param {!goog.structs.Map|!Object} map Map of string parameter
+ * @param {!goog.structs.Map<string, ?>|!Object} map Map of string parameter
  *     names to parameter value. If parameter value is an array, it is
  *     treated as if the key maps to each individual value in the
  *     array.
@@ -1109,8 +1152,8 @@ goog.Uri.QueryData.createFromMap = function(map, opt_uri, opt_ignoreCase) {
  * and values. Allows for duplicate parameter names. Throws an error if the
  * lengths of the arrays differ.
  *
- * @param {Array.<string>} keys Parameter names.
- * @param {Array} values Parameter values.
+ * @param {!Array<string>} keys Parameter names.
+ * @param {!Array<?>} values Parameter values.
  * @param {goog.Uri=} opt_uri URI object that should have its cache
  *     invalidated when this object updates.
  * @param {boolean=} opt_ignoreCase If true, ignore the case of the parameter
@@ -1130,27 +1173,6 @@ goog.Uri.QueryData.createFromKeysValues = function(
 };
 
 
-/**
- * The map containing name/value or name/array-of-values pairs.
- * May be null if it requires parsing from the query string.
- *
- * We need to use a Map because we cannot guarantee that the key names will
- * not be problematic for IE.
- *
- * @type {goog.structs.Map}
- * @private
- */
-goog.Uri.QueryData.prototype.keyMap_ = null;
-
-
-/**
- * The number of params, or null if it requires computing.
- * @type {?number}
- * @private
- */
-goog.Uri.QueryData.prototype.count_ = null;
-
-
 /**
  * @return {?number} The number of parameters.
  */
@@ -1249,12 +1271,12 @@ goog.Uri.QueryData.prototype.containsValue = function(value) {
 /**
  * Returns all the keys of the parameters. If a key is used multiple times
  * it will be included multiple times in the returned array
- * @return {!Array.<string>} All the keys of the parameters.
+ * @return {!Array<string>} All the keys of the parameters.
  */
 goog.Uri.QueryData.prototype.getKeys = function() {
   this.ensureKeyMapInitialized_();
   // We need to get the values to know how many keys to add.
-  var vals = /** @type {Array.<Array|*>} */ (this.keyMap_.getValues());
+  var vals = /** @type {!Array<*>} */ (this.keyMap_.getValues());
   var keys = this.keyMap_.getKeys();
   var rv = [];
   for (var i = 0; i < keys.length; i++) {
@@ -1272,18 +1294,18 @@ goog.Uri.QueryData.prototype.getKeys = function() {
  * data has no such key this will return an empty array. If no key is given
  * all values wil be returned.
  * @param {string=} opt_key The name of the parameter to get the values for.
- * @return {!Array} All the values of the parameters with the given name.
+ * @return {!Array<?>} All the values of the parameters with the given name.
  */
 goog.Uri.QueryData.prototype.getValues = function(opt_key) {
   this.ensureKeyMapInitialized_();
   var rv = [];
-  if (opt_key) {
+  if (goog.isString(opt_key)) {
     if (this.containsKey(opt_key)) {
       rv = goog.array.concat(rv, this.keyMap_.get(this.getKeyName_(opt_key)));
     }
   } else {
     // Return all values.
-    var values = /** @type {Array.<Array|*>} */ (this.keyMap_.getValues());
+    var values = this.keyMap_.getValues();
     for (var i = 0; i < values.length; i++) {
       rv = goog.array.concat(rv, values[i]);
     }
@@ -1303,7 +1325,7 @@ goog.Uri.QueryData.prototype.set = function(key, value) {
   this.ensureKeyMapInitialized_();
   this.invalidateCache_();
 
-  // TODO(user): This could be better written as
+  // TODO(chrishenry): This could be better written as
   // this.remove(key), this.add(key, value), but that would reorder
   // the key (since the key is first removed and then added at the
   // end) and we would have to fix unit tests that depend on key
@@ -1341,7 +1363,7 @@ goog.Uri.QueryData.prototype.get = function(key, opt_default) {
  * Sets the values for a key. If the key already exists, this will
  * override all of the existing values that correspond to the key.
  * @param {string} key The key to set values for.
- * @param {Array} values The values to set.
+ * @param {!Array<?>} values The values to set.
  */
 goog.Uri.QueryData.prototype.setValues = function(key, values) {
   this.remove(key);
@@ -1393,6 +1415,8 @@ goog.Uri.QueryData.prototype.toString = function() {
 
 
 /**
+ * @throws URIError If URI is malformed (that is, if decodeURIComponent fails on
+ *     any of the URI components).
  * @return {string} Decoded query string.
  */
 goog.Uri.QueryData.prototype.toDecodedString = function() {
@@ -1411,14 +1435,13 @@ goog.Uri.QueryData.prototype.invalidateCache_ = function() {
 
 /**
  * Removes all keys that are not in the provided list. (Modifies this object.)
- * @param {Array.<string>} keys The desired keys.
+ * @param {Array<string>} keys The desired keys.
  * @return {!goog.Uri.QueryData} a reference to this object.
  */
 goog.Uri.QueryData.prototype.filterKeys = function(keys) {
   this.ensureKeyMapInitialized_();
-  goog.structs.forEach(this.keyMap_,
-      /** @this {goog.Uri.QueryData} */
-      function(value, key, map) {
+  this.keyMap_.forEach(
+      function(value, key) {
         if (!goog.array.contains(keys, key)) {
           this.remove(key);
         }
@@ -1469,8 +1492,7 @@ goog.Uri.QueryData.prototype.setIgnoreCase = function(ignoreCase) {
   if (resetKeys) {
     this.ensureKeyMapInitialized_();
     this.invalidateCache_();
-    goog.structs.forEach(this.keyMap_,
-        /** @this {goog.Uri.QueryData} */
+    this.keyMap_.forEach(
         function(value, key) {
           var lowerCase = key.toLowerCase();
           if (key != lowerCase) {
@@ -1487,8 +1509,8 @@ goog.Uri.QueryData.prototype.setIgnoreCase = function(ignoreCase) {
  * Extends a query data object with another query data or map like object. This
  * operates 'in-place', it does not create a new QueryData object.
  *
- * @param {...(goog.Uri.QueryData|goog.structs.Map|Object)} var_args The object
- *     from which key value pairs will be copied.
+ * @param {...(goog.Uri.QueryData|goog.structs.Map<?, ?>|Object)} var_args
+ *     The object from which key value pairs will be copied.
  */
 goog.Uri.QueryData.prototype.extend = function(var_args) {
   for (var i = 0; i < arguments.length; i++) {
diff --git a/lib/goog/uri/utils.js b/lib/goog/uri/utils.js
index bd75911..05bc07f 100644
--- a/lib/goog/uri/utils.js
+++ b/lib/goog/uri/utils.js
@@ -35,14 +35,13 @@
  *
  * One advantage of the limited functionality here is that this approach is
  * less sensitive to differences in URI encodings than goog.Uri, since these
- * functions modify the strings in place, rather than decoding and
- * re-encoding.
+ * functions operate on strings directly, rather than decoding them and
+ * then re-encoding.
  *
  * Uses features of RFC 3986 for parsing/formatting URIs:
  *   http://www.ietf.org/rfc/rfc3986.txt
  *
  * @author gboyer@google.com (Garrett Boyer) - The "lightened" design.
- * @author msamuel@google.com (Mike Samuel) - Domain knowledge and regexes.
  */
 
 goog.provide('goog.uri.utils');
@@ -53,7 +52,6 @@ goog.provide('goog.uri.utils.StandardQueryParam');
 
 goog.require('goog.asserts');
 goog.require('goog.string');
-goog.require('goog.userAgent');
 
 
 /**
@@ -189,19 +187,19 @@ goog.uri.utils.buildFromEncodedParts = function(opt_scheme, opt_userInfo,
 goog.uri.utils.splitRe_ = new RegExp(
     '^' +
     '(?:' +
-      '([^:/?#.]+)' +                     // scheme - ignore special characters
-                                          // used by other URL parts such as :,
-                                          // ?, /, #, and .
+        '([^:/?#.]+)' +                  // scheme - ignore special characters
+                                         // used by other URL parts such as :,
+                                         // ?, /, #, and .
     ':)?' +
     '(?://' +
-      '(?:([^/?#]*)@)?' +                 // userInfo
-      '([^/#?]*?)' +                      // domain
-      '(?::([0-9]+))?' +                  // port
-      '(?=[/#?]|$)' +                     // authority-terminating character
+        '(?:([^/?#]*)@)?' +              // userInfo
+        '([^/#?]*?)' +                   // domain
+        '(?::([0-9]+))?' +               // port
+        '(?=[/#?]|$)' +                  // authority-terminating character
     ')?' +
-    '([^?#]+)?' +                         // path
-    '(?:\\?([^#]*))?' +                   // query
-    '(?:#(.*))?' +                        // fragment
+    '([^?#]+)?' +                        // path
+    '(?:\\?([^#]*))?' +                  // query
+    '(?:#(.*))?' +                       // fragment
     '$');
 
 
@@ -229,80 +227,32 @@ goog.uri.utils.ComponentIndex = {
  * </pre>
  *
  * @param {string} uri The URI string to examine.
- * @return {!Array.<string|undefined>} Each component still URI-encoded.
+ * @return {!Array<string|undefined>} Each component still URI-encoded.
  *     Each component that is present will contain the encoded value, whereas
  *     components that are not present will be undefined or empty, depending
  *     on the browser's regular expression implementation.  Never null, since
  *     arbitrary strings may still look like path names.
  */
 goog.uri.utils.split = function(uri) {
-  goog.uri.utils.phishingProtection_();
-
   // See @return comment -- never null.
-  return /** @type {!Array.<string|undefined>} */ (
+  return /** @type {!Array<string|undefined>} */ (
       uri.match(goog.uri.utils.splitRe_));
 };
 
 
-/**
- * Safari has a nasty bug where if you have an http URL with a username, e.g.,
- * http://evil.com%2F@google.com/
- * Safari will report that window.location.href is
- * http://evil.com/google.com/
- * so that anyone who tries to parse the domain of that URL will get
- * the wrong domain. We've seen exploits where people use this to trick
- * Safari into loading resources from evil domains.
- *
- * To work around this, we run a little "Safari phishing check", and throw
- * an exception if we see this happening.
- *
- * There is no convenient place to put this check. We apply it to
- * anyone doing URI parsing on Webkit. We're not happy about this, but
- * it fixes the problem.
- *
- * This should be removed once Safari fixes their bug.
- *
- * Exploit reported by Masato Kinugawa.
- *
- * @type {boolean}
- * @private
- */
-goog.uri.utils.needsPhishingProtection_ = goog.userAgent.WEBKIT;
-
-
-/**
- * Check to see if the user is being phished.
- * @private
- */
-goog.uri.utils.phishingProtection_ = function() {
-  if (goog.uri.utils.needsPhishingProtection_) {
-    // Turn protection off, so that we don't recurse.
-    goog.uri.utils.needsPhishingProtection_ = false;
-
-    // Use quoted access, just in case the user isn't using location externs.
-    var location = goog.global['location'];
-    if (location) {
-      var href = location['href'];
-      if (href) {
-        var domain = goog.uri.utils.getDomain(href);
-        if (domain && domain != location['hostname']) {
-          // Phishing attack
-          goog.uri.utils.needsPhishingProtection_ = true;
-          throw Error();
-        }
-      }
-    }
-  }
-};
-
-
 /**
  * @param {?string} uri A possibly null string.
+ * @param {boolean=} opt_preserveReserved If true, percent-encoding of RFC-3986
+ *     reserved characters will not be removed.
  * @return {?string} The string URI-decoded, or null if uri is null.
  * @private
  */
-goog.uri.utils.decodeIfPossible_ = function(uri) {
-  return uri && decodeURIComponent(uri);
+goog.uri.utils.decodeIfPossible_ = function(uri, opt_preserveReserved) {
+  if (!uri) {
+    return uri;
+  }
+
+  return opt_preserveReserved ? decodeURI(uri) : decodeURIComponent(uri);
 };
 
 
@@ -343,8 +293,8 @@ goog.uri.utils.getScheme = function(uri) {
  */
 goog.uri.utils.getEffectiveScheme = function(uri) {
   var scheme = goog.uri.utils.getScheme(uri);
-  if (!scheme && self.location) {
-    var protocol = self.location.protocol;
+  if (!scheme && goog.global.self && goog.global.self.location) {
+    var protocol = goog.global.self.location.protocol;
     scheme = protocol.substr(0, protocol.length - 1);
   }
   // NOTE: When called from a web worker in Firefox 3.5, location maybe null.
@@ -388,7 +338,8 @@ goog.uri.utils.getDomainEncoded = function(uri) {
  * @return {?string} The decoded domain, or null if none.
  */
 goog.uri.utils.getDomain = function(uri) {
-  return goog.uri.utils.decodeIfPossible_(goog.uri.utils.getDomainEncoded(uri));
+  return goog.uri.utils.decodeIfPossible_(
+      goog.uri.utils.getDomainEncoded(uri), true /* opt_preserveReserved */);
 };
 
 
@@ -423,7 +374,8 @@ goog.uri.utils.getPathEncoded = function(uri) {
  *     slash, if any.
  */
 goog.uri.utils.getPath = function(uri) {
-  return goog.uri.utils.decodeIfPossible_(goog.uri.utils.getPathEncoded(uri));
+  return goog.uri.utils.decodeIfPossible_(
+      goog.uri.utils.getPathEncoded(uri), true /* opt_preserveReserved */);
 };
 
 
@@ -522,7 +474,7 @@ goog.uri.utils.removeFragment = function(uri) {
  *
  * @param {string} uri1 The first URI.
  * @param {string} uri2 The second URI.
- * @return {boolean} Whether they have the same domain and port.
+ * @return {boolean} Whether they have the same scheme, domain and port.
  */
 goog.uri.utils.haveSameDomain = function(uri1, uri2) {
   var pieces1 = goog.uri.utils.split(uri1);
@@ -584,17 +536,53 @@ goog.uri.utils.QueryValue;
  * ];
  * </pre>
  *
- * @typedef {!Array.<string|goog.uri.utils.QueryValue>}
+ * @typedef {!Array<string|goog.uri.utils.QueryValue>}
  */
 goog.uri.utils.QueryArray;
 
 
+/**
+ * Parses encoded query parameters and calls callback function for every
+ * parameter found in the string.
+ *
+ * Missing value of parameter (e.g. “…&key&…”) is treated as if the value was an
+ * empty string.  Keys may be empty strings (e.g. “…&=value&…”) which also means
+ * that “…&=&…” and “…&&…” will result in an empty key and value.
+ *
+ * @param {string} encodedQuery Encoded query string excluding question mark at
+ *     the beginning.
+ * @param {function(string, string)} callback Function called for every
+ *     parameter found in query string.  The first argument (name) will not be
+ *     urldecoded (so the function is consistent with buildQueryData), but the
+ *     second will.  If the parameter has no value (i.e. “=” was not present)
+ *     the second argument (value) will be an empty string.
+ */
+goog.uri.utils.parseQueryData = function(encodedQuery, callback) {
+  if (!encodedQuery) {
+    return;
+  }
+  var pairs = encodedQuery.split('&');
+  for (var i = 0; i < pairs.length; i++) {
+    var indexOfEquals = pairs[i].indexOf('=');
+    var name = null;
+    var value = null;
+    if (indexOfEquals >= 0) {
+      name = pairs[i].substring(0, indexOfEquals);
+      value = pairs[i].substring(indexOfEquals + 1);
+    } else {
+      name = pairs[i];
+    }
+    callback(name, value ? goog.string.urlDecode(value) : '');
+  }
+};
+
+
 /**
  * Appends a URI and query data in a string buffer with special preconditions.
  *
  * Internal implementation utility, performing very few object allocations.
  *
- * @param {!Array.<string|undefined>} buffer A string buffer.  The first element
+ * @param {!Array<string|undefined>} buffer A string buffer.  The first element
  *     must be the base URI, and may have a fragment identifier.  If the array
  *     contains more than one element, the second element must be an ampersand,
  *     and may be overwritten, depending on the base URI.  Undefined elements
@@ -633,7 +621,7 @@ goog.uri.utils.appendQueryData_ = function(buffer) {
  * Appends key=value pairs to an array, supporting multi-valued objects.
  * @param {string} key The key prefix.
  * @param {goog.uri.utils.QueryValue} value The value to serialize.
- * @param {!Array.<string>} pairs The array to which the 'key=value' strings
+ * @param {!Array<string>} pairs The array to which the 'key=value' strings
  *     should be appended.
  * @private
  */
@@ -663,12 +651,12 @@ goog.uri.utils.appendKeyValuePairs_ = function(key, value, pairs) {
 /**
  * Builds a buffer of query data from a sequence of alternating keys and values.
  *
- * @param {!Array.<string|undefined>} buffer A string buffer to append to.  The
+ * @param {!Array<string|undefined>} buffer A string buffer to append to.  The
  *     first element appended will be an '&', and may be replaced by the caller.
- * @param {goog.uri.utils.QueryArray|Arguments} keysAndValues An array with
+ * @param {!goog.uri.utils.QueryArray|!Arguments} keysAndValues An array with
  *     alternating keys and values -- see the typedef.
  * @param {number=} opt_startIndex A start offset into the arary, defaults to 0.
- * @return {!Array.<string|undefined>} The buffer argument.
+ * @return {!Array<string|undefined>} The buffer argument.
  * @private
  */
 goog.uri.utils.buildQueryDataBuffer_ = function(
@@ -692,7 +680,7 @@ goog.uri.utils.buildQueryDataBuffer_ = function(
  * @param {goog.uri.utils.QueryArray} keysAndValues Alternating keys and
  *     values.  See the typedef.
  * @param {number=} opt_startIndex A start offset into the arary, defaults to 0.
- * @return {string} The encoded query string, in the for 'a=1&b=2'.
+ * @return {string} The encoded query string, in the form 'a=1&b=2'.
  */
 goog.uri.utils.buildQueryData = function(keysAndValues, opt_startIndex) {
   var buffer = goog.uri.utils.buildQueryDataBuffer_(
@@ -705,12 +693,12 @@ goog.uri.utils.buildQueryData = function(keysAndValues, opt_startIndex) {
 /**
  * Builds a buffer of query data from a map.
  *
- * @param {!Array.<string|undefined>} buffer A string buffer to append to.  The
+ * @param {!Array<string|undefined>} buffer A string buffer to append to.  The
  *     first element appended will be an '&', and may be replaced by the caller.
- * @param {Object.<goog.uri.utils.QueryValue>} map An object where keys are
- *     URI-encoded parameter keys, and the values conform to the contract
+ * @param {!Object<string, goog.uri.utils.QueryValue>} map An object where keys
+ *     are URI-encoded parameter keys, and the values conform to the contract
  *     specified in the goog.uri.utils.QueryValue typedef.
- * @return {!Array.<string|undefined>} The buffer argument.
+ * @return {!Array<string|undefined>} The buffer argument.
  * @private
  */
 goog.uri.utils.buildQueryDataBufferFromMap_ = function(buffer, map) {
@@ -726,10 +714,10 @@ goog.uri.utils.buildQueryDataBufferFromMap_ = function(buffer, map) {
  * Builds a query data string from a map.
  * Currently generates "&key&" for empty args.
  *
- * @param {Object} map An object where keys are URI-encoded parameter keys,
- *     and the values are arbitrary types or arrays.  Keys with a null value
- *     are dropped.
- * @return {string} The encoded query string, in the for 'a=1&b=2'.
+ * @param {!Object<string, goog.uri.utils.QueryValue>} map An object where keys
+ *     are URI-encoded parameter keys, and the values are arbitrary types
+ *     or arrays. Keys with a null value are dropped.
+ * @return {string} The encoded query string, in the form 'a=1&b=2'.
  */
 goog.uri.utils.buildQueryDataFromMap = function(map) {
   var buffer = goog.uri.utils.buildQueryDataBufferFromMap_([], map);
@@ -777,9 +765,9 @@ goog.uri.utils.appendParams = function(uri, var_args) {
  * Appends query parameters from a map.
  *
  * @param {string} uri The original URI, which may already have query data.
- * @param {Object} map An object where keys are URI-encoded parameter keys,
- *     and the values are arbitrary types or arrays.  Keys with a null value
- *     are dropped.
+ * @param {!Object<goog.uri.utils.QueryValue>} map An object where keys are
+ *     URI-encoded parameter keys, and the values are arbitrary types or arrays.
+ *     Keys with a null value are dropped.
  * @return {string} The new parameters.
  */
 goog.uri.utils.appendParamsFromMap = function(uri, map) {
@@ -912,9 +900,9 @@ goog.uri.utils.getParamValue = function(uri, keyEncoded) {
 
 /**
  * Gets all values of a query parameter.
- * @param {string} uri The URI to process.  May contain a framgnet.
- * @param {string} keyEncoded The URI-encoded key.  Case-snsitive.
- * @return {!Array.<string>} All URI-decoded values with the given key.
+ * @param {string} uri The URI to process.  May contain a fragment.
+ * @param {string} keyEncoded The URI-encoded key.  Case-sensitive.
+ * @return {!Array<string>} All URI-decoded values with the given key.
  *     If the key is not found, this will have length 0, but never be null.
  */
 goog.uri.utils.getParamValues = function(uri, keyEncoded) {
@@ -1030,6 +1018,29 @@ goog.uri.utils.appendPath = function(baseUri, path) {
 };
 
 
+/**
+ * Replaces the path.
+ * @param {string} uri URI to use as the base.
+ * @param {string} path New path.
+ * @return {string} Updated URI.
+ */
+goog.uri.utils.setPath = function(uri, path) {
+  // Add any missing '/'.
+  if (!goog.string.startsWith(path, '/')) {
+    path = '/' + path;
+  }
+  var parts = goog.uri.utils.split(uri);
+  return goog.uri.utils.buildFromEncodedParts(
+      parts[goog.uri.utils.ComponentIndex.SCHEME],
+      parts[goog.uri.utils.ComponentIndex.USER_INFO],
+      parts[goog.uri.utils.ComponentIndex.DOMAIN],
+      parts[goog.uri.utils.ComponentIndex.PORT],
+      path,
+      parts[goog.uri.utils.ComponentIndex.QUERY_DATA],
+      parts[goog.uri.utils.ComponentIndex.FRAGMENT]);
+};
+
+
 /**
  * Standard supported query parameters.
  * @enum {string}
diff --git a/lib/goog/useragent/product.js b/lib/goog/useragent/product.js
index 255c988..381883f 100644
--- a/lib/goog/useragent/product.js
+++ b/lib/goog/useragent/product.js
@@ -19,6 +19,8 @@
 
 goog.provide('goog.userAgent.product');
 
+goog.require('goog.labs.userAgent.browser');
+goog.require('goog.labs.userAgent.platform');
 goog.require('goog.userAgent');
 
 
@@ -28,12 +30,6 @@ goog.require('goog.userAgent');
 goog.define('goog.userAgent.product.ASSUME_FIREFOX', false);
 
 
-/**
- * @define {boolean} Whether the code is running on the Camino web browser.
- */
-goog.define('goog.userAgent.product.ASSUME_CAMINO', false);
-
-
 /**
  * @define {boolean} Whether we know at compile-time that the product is an
  *     iPhone.
@@ -50,13 +46,14 @@ goog.define('goog.userAgent.product.ASSUME_IPAD', false);
 
 /**
  * @define {boolean} Whether we know at compile-time that the product is an
- *     Android phone.
+ *     AOSP browser or WebView inside a pre KitKat Android phone or tablet.
  */
 goog.define('goog.userAgent.product.ASSUME_ANDROID', false);
 
 
 /**
- * @define {boolean} Whether the code is running on the Chrome web browser.
+ * @define {boolean} Whether the code is running on the Chrome web browser on
+ * any platform or AOSP browser or WebView in a KitKat+ Android phone or tablet.
  */
 goog.define('goog.userAgent.product.ASSUME_CHROME', false);
 
@@ -74,9 +71,9 @@ goog.define('goog.userAgent.product.ASSUME_SAFARI', false);
  */
 goog.userAgent.product.PRODUCT_KNOWN_ =
     goog.userAgent.ASSUME_IE ||
+    goog.userAgent.ASSUME_EDGE ||
     goog.userAgent.ASSUME_OPERA ||
     goog.userAgent.product.ASSUME_FIREFOX ||
-    goog.userAgent.product.ASSUME_CAMINO ||
     goog.userAgent.product.ASSUME_IPHONE ||
     goog.userAgent.product.ASSUME_IPAD ||
     goog.userAgent.product.ASSUME_ANDROID ||
@@ -84,98 +81,6 @@ goog.userAgent.product.PRODUCT_KNOWN_ =
     goog.userAgent.product.ASSUME_SAFARI;
 
 
-/**
- * Right now we just focus on Tier 1-3 browsers at:
- * http://wiki/Nonconf/ProductPlatformGuidelines
- * As well as the YUI grade A browsers at:
- * http://developer.yahoo.com/yui/articles/gbs/
- *
- * @private
- */
-goog.userAgent.product.init_ = function() {
-
-  /**
-   * Whether the code is running on the Firefox web browser.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.product.detectedFirefox_ = false;
-
-  /**
-   * Whether the code is running on the Camino web browser.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.product.detectedCamino_ = false;
-
-  /**
-   * Whether the code is running on an iPhone or iPod touch.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.product.detectedIphone_ = false;
-
-  /**
-   * Whether the code is running on an iPad
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.product.detectedIpad_ = false;
-
-  /**
-   * Whether the code is running on the default browser on an Android phone.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.product.detectedAndroid_ = false;
-
-  /**
-   * Whether the code is running on the Chrome web browser.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.product.detectedChrome_ = false;
-
-  /**
-   * Whether the code is running on the Safari web browser.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.product.detectedSafari_ = false;
-
-  var ua = goog.userAgent.getUserAgentString();
-  if (!ua) {
-    return;
-  }
-
-  // The order of the if-statements in the following code is important.
-  // For example, in the WebKit section, we put Chrome in front of Safari
-  // because the string 'Safari' is present on both of those browsers'
-  // userAgent strings as well as the string we are looking for.
-  // The idea is to prevent accidental detection of more than one client.
-
-  if (ua.indexOf('Firefox') != -1) {
-    goog.userAgent.product.detectedFirefox_ = true;
-  } else if (ua.indexOf('Camino') != -1) {
-    goog.userAgent.product.detectedCamino_ = true;
-  } else if (ua.indexOf('iPhone') != -1 || ua.indexOf('iPod') != -1) {
-    goog.userAgent.product.detectedIphone_ = true;
-  } else if (ua.indexOf('iPad') != -1) {
-    goog.userAgent.product.detectedIpad_ = true;
-  } else if (ua.indexOf('Android') != -1) {
-    goog.userAgent.product.detectedAndroid_ = true;
-  } else if (ua.indexOf('Chrome') != -1) {
-    goog.userAgent.product.detectedChrome_ = true;
-  } else if (ua.indexOf('Safari') != -1) {
-    goog.userAgent.product.detectedSafari_ = true;
-  }
-};
-
-if (!goog.userAgent.product.PRODUCT_KNOWN_) {
-  goog.userAgent.product.init_();
-}
-
-
 /**
  * Whether the code is running on the Opera web browser.
  * @type {boolean}
@@ -190,31 +95,42 @@ goog.userAgent.product.OPERA = goog.userAgent.OPERA;
 goog.userAgent.product.IE = goog.userAgent.IE;
 
 
+/**
+ * Whether the code is running on an Edge web browser.
+ * @type {boolean}
+ */
+goog.userAgent.product.EDGE = goog.userAgent.EDGE;
+
+
 /**
  * Whether the code is running on the Firefox web browser.
  * @type {boolean}
  */
 goog.userAgent.product.FIREFOX = goog.userAgent.product.PRODUCT_KNOWN_ ?
     goog.userAgent.product.ASSUME_FIREFOX :
-    goog.userAgent.product.detectedFirefox_;
+    goog.labs.userAgent.browser.isFirefox();
 
 
 /**
- * Whether the code is running on the Camino web browser.
- * @type {boolean}
+ * Whether the user agent is an iPhone or iPod (as in iPod touch).
+ * @return {boolean}
+ * @private
  */
-goog.userAgent.product.CAMINO = goog.userAgent.product.PRODUCT_KNOWN_ ?
-    goog.userAgent.product.ASSUME_CAMINO :
-    goog.userAgent.product.detectedCamino_;
+goog.userAgent.product.isIphoneOrIpod_ = function() {
+  return goog.labs.userAgent.platform.isIphone() ||
+      goog.labs.userAgent.platform.isIpod();
+};
 
 
 /**
  * Whether the code is running on an iPhone or iPod touch.
+ *
+ * iPod touch is considered an iPhone for legacy reasons.
  * @type {boolean}
  */
 goog.userAgent.product.IPHONE = goog.userAgent.product.PRODUCT_KNOWN_ ?
     goog.userAgent.product.ASSUME_IPHONE :
-    goog.userAgent.product.detectedIphone_;
+    goog.userAgent.product.isIphoneOrIpod_();
 
 
 /**
@@ -223,31 +139,45 @@ goog.userAgent.product.IPHONE = goog.userAgent.product.PRODUCT_KNOWN_ ?
  */
 goog.userAgent.product.IPAD = goog.userAgent.product.PRODUCT_KNOWN_ ?
     goog.userAgent.product.ASSUME_IPAD :
-    goog.userAgent.product.detectedIpad_;
+    goog.labs.userAgent.platform.isIpad();
 
 
 /**
- * Whether the code is running on the default browser on an Android phone.
+ * Whether the code is running on AOSP browser or WebView inside
+ * a pre KitKat Android phone or tablet.
  * @type {boolean}
  */
 goog.userAgent.product.ANDROID = goog.userAgent.product.PRODUCT_KNOWN_ ?
     goog.userAgent.product.ASSUME_ANDROID :
-    goog.userAgent.product.detectedAndroid_;
+    goog.labs.userAgent.browser.isAndroidBrowser();
 
 
 /**
- * Whether the code is running on the Chrome web browser.
+ * Whether the code is running on the Chrome web browser on any platform
+ * or AOSP browser or WebView in a KitKat+ Android phone or tablet.
  * @type {boolean}
  */
 goog.userAgent.product.CHROME = goog.userAgent.product.PRODUCT_KNOWN_ ?
     goog.userAgent.product.ASSUME_CHROME :
-    goog.userAgent.product.detectedChrome_;
+    goog.labs.userAgent.browser.isChrome();
+
+
+/**
+ * @return {boolean} Whether the browser is Safari on desktop.
+ * @private
+ */
+goog.userAgent.product.isSafariDesktop_ = function() {
+  return goog.labs.userAgent.browser.isSafari() &&
+      !goog.labs.userAgent.platform.isIos();
+};
 
 
 /**
- * Whether the code is running on the Safari web browser.
+ * Whether the code is running on the desktop Safari web browser.
+ * Note: the legacy behavior here is only true for Safari not running
+ * on iOS.
  * @type {boolean}
  */
 goog.userAgent.product.SAFARI = goog.userAgent.product.PRODUCT_KNOWN_ ?
     goog.userAgent.product.ASSUME_SAFARI :
-    goog.userAgent.product.detectedSafari_;
+    goog.userAgent.product.isSafariDesktop_();
diff --git a/lib/goog/useragent/product_isversion.js b/lib/goog/useragent/product_isversion.js
index 18ae74b..336c549 100644
--- a/lib/goog/useragent/product_isversion.js
+++ b/lib/goog/useragent/product_isversion.js
@@ -26,6 +26,9 @@
 goog.provide('goog.userAgent.product.isVersion');
 
 
+goog.require('goog.labs.userAgent.platform');
+goog.require('goog.string');
+goog.require('goog.userAgent');
 goog.require('goog.userAgent.product');
 
 
@@ -44,7 +47,8 @@ goog.userAgent.product.determineVersion_ = function() {
     return goog.userAgent.product.getFirstRegExpGroup_(/Firefox\/([0-9.]+)/);
   }
 
-  if (goog.userAgent.product.IE || goog.userAgent.product.OPERA) {
+  if (goog.userAgent.product.IE || goog.userAgent.product.EDGE ||
+      goog.userAgent.product.OPERA) {
     return goog.userAgent.VERSION;
   }
 
@@ -53,7 +57,9 @@ goog.userAgent.product.determineVersion_ = function() {
     return goog.userAgent.product.getFirstRegExpGroup_(/Chrome\/([0-9.]+)/);
   }
 
-  if (goog.userAgent.product.SAFARI) {
+  // This replicates legacy logic, which considered Safari and iOS to be
+  // different products.
+  if (goog.userAgent.product.SAFARI && !goog.labs.userAgent.platform.isIos()) {
     // Version/5.0.3
     //
     // NOTE: Before version 3, Safari did not report a product version number.
@@ -87,8 +93,6 @@ goog.userAgent.product.determineVersion_ = function() {
     }
 
     return goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);
-  } else if (goog.userAgent.product.CAMINO) {
-    return goog.userAgent.product.getFirstRegExpGroup_(/Camino\/([0-9.]+)/);
   }
 
   return '';
@@ -110,7 +114,7 @@ goog.userAgent.product.getFirstRegExpGroup_ = function(re) {
 /**
  * Run regexp's exec() on the userAgent string.
  * @param {!RegExp} re Regular expression.
- * @return {Array} A result array, or null for no match.
+ * @return {Array<?>} A result array, or null for no match.
  * @private
  */
 goog.userAgent.product.execRegExp_ = function(re) {
diff --git a/lib/goog/useragent/useragent.js b/lib/goog/useragent/useragent.js
index 8bd39e3..372742c 100644
--- a/lib/goog/useragent/useragent.js
+++ b/lib/goog/useragent/useragent.js
@@ -17,11 +17,16 @@
  * @see <a href="http://www.useragentstring.com/">User agent strings</a>
  * For information on the browser brand (such as Safari versus Chrome), see
  * goog.userAgent.product.
+ * @author arv@google.com (Erik Arvidsson)
  * @see ../demos/useragent.html
  */
 
 goog.provide('goog.userAgent');
 
+goog.require('goog.labs.userAgent.browser');
+goog.require('goog.labs.userAgent.engine');
+goog.require('goog.labs.userAgent.platform');
+goog.require('goog.labs.userAgent.util');
 goog.require('goog.string');
 
 
@@ -31,6 +36,12 @@ goog.require('goog.string');
 goog.define('goog.userAgent.ASSUME_IE', false);
 
 
+/**
+ * @define {boolean} Whether we know at compile-time that the browser is EDGE.
+ */
+goog.define('goog.userAgent.ASSUME_EDGE', false);
+
+
 /**
  * @define {boolean} Whether we know at compile-time that the browser is GECKO.
  */
@@ -71,6 +82,7 @@ goog.define('goog.userAgent.ASSUME_ANY_VERSION', false);
  */
 goog.userAgent.BROWSER_KNOWN_ =
     goog.userAgent.ASSUME_IE ||
+    goog.userAgent.ASSUME_EDGE ||
     goog.userAgent.ASSUME_GECKO ||
     goog.userAgent.ASSUME_MOBILE_WEBKIT ||
     goog.userAgent.ASSUME_WEBKIT ||
@@ -79,122 +91,68 @@ goog.userAgent.BROWSER_KNOWN_ =
 
 /**
  * Returns the userAgent string for the current browser.
- * Some user agents (I'm thinking of you, Gears WorkerPool) do not expose a
- * navigator object off the global scope.  In that case we return null.
  *
- * @return {?string} The userAgent string or null if there is none.
+ * @return {string} The userAgent string.
  */
 goog.userAgent.getUserAgentString = function() {
-  return goog.global['navigator'] ? goog.global['navigator'].userAgent : null;
+  return goog.labs.userAgent.util.getUserAgent();
 };
 
 
 /**
+ * TODO(nnaze): Change type to "Navigator" and update compilation targets.
  * @return {Object} The native navigator object.
  */
 goog.userAgent.getNavigator = function() {
   // Need a local navigator reference instead of using the global one,
   // to avoid the rare case where they reference different objects.
   // (in a WorkerPool, for example).
-  return goog.global['navigator'];
+  return goog.global['navigator'] || null;
 };
 
 
 /**
- * Initializer for goog.userAgent.
- *
- * This is a named function so that it can be stripped via the jscompiler
- * option for stripping types.
- * @private
+ * Whether the user agent is Opera.
+ * @type {boolean}
  */
-goog.userAgent.init_ = function() {
-  /**
-   * Whether the user agent string denotes Opera.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedOpera_ = false;
-
-  /**
-   * Whether the user agent string denotes Internet Explorer. This includes
-   * other browsers using Trident as its rendering engine. For example AOL
-   * and Netscape 8
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedIe_ = false;
-
-  /**
-   * Whether the user agent string denotes WebKit. WebKit is the rendering
-   * engine that Safari, Android and others use.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedWebkit_ = false;
-
-  /**
-   * Whether the user agent string denotes a mobile device.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedMobile_ = false;
-
-  /**
-   * Whether the user agent string denotes Gecko. Gecko is the rendering
-   * engine used by Mozilla, Mozilla Firefox, Camino and many more.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedGecko_ = false;
-
-  var ua;
-  if (!goog.userAgent.BROWSER_KNOWN_ &&
-      (ua = goog.userAgent.getUserAgentString())) {
-    var navigator = goog.userAgent.getNavigator();
-    goog.userAgent.detectedOpera_ = ua.indexOf('Opera') == 0;
-    goog.userAgent.detectedIe_ = !goog.userAgent.detectedOpera_ &&
-        ua.indexOf('MSIE') != -1;
-    goog.userAgent.detectedWebkit_ = !goog.userAgent.detectedOpera_ &&
-        ua.indexOf('WebKit') != -1;
-    // WebKit also gives navigator.product string equal to 'Gecko'.
-    goog.userAgent.detectedMobile_ = goog.userAgent.detectedWebkit_ &&
-        ua.indexOf('Mobile') != -1;
-    goog.userAgent.detectedGecko_ = !goog.userAgent.detectedOpera_ &&
-        !goog.userAgent.detectedWebkit_ && navigator.product == 'Gecko';
-  }
-};
+goog.userAgent.OPERA = goog.userAgent.BROWSER_KNOWN_ ?
+    goog.userAgent.ASSUME_OPERA :
+    goog.labs.userAgent.browser.isOpera();
 
 
-if (!goog.userAgent.BROWSER_KNOWN_) {
-  goog.userAgent.init_();
-}
+/**
+ * Whether the user agent is Internet Explorer.
+ * @type {boolean}
+ */
+goog.userAgent.IE = goog.userAgent.BROWSER_KNOWN_ ?
+    goog.userAgent.ASSUME_IE :
+    goog.labs.userAgent.browser.isIE();
 
 
 /**
- * Whether the user agent is Opera.
+ * Whether the user agent is Microsoft Edge.
  * @type {boolean}
  */
-goog.userAgent.OPERA = goog.userAgent.BROWSER_KNOWN_ ?
-    goog.userAgent.ASSUME_OPERA : goog.userAgent.detectedOpera_;
+goog.userAgent.EDGE = goog.userAgent.BROWSER_KNOWN_ ?
+    goog.userAgent.ASSUME_EDGE :
+    goog.labs.userAgent.engine.isEdge();
 
 
 /**
- * Whether the user agent is Internet Explorer. This includes other browsers
- * using Trident as its rendering engine. For example AOL and Netscape 8
+ * Whether the user agent is MS Internet Explorer or MS Edge.
  * @type {boolean}
  */
-goog.userAgent.IE = goog.userAgent.BROWSER_KNOWN_ ?
-    goog.userAgent.ASSUME_IE : goog.userAgent.detectedIe_;
+goog.userAgent.EDGE_OR_IE = goog.userAgent.EDGE || goog.userAgent.IE;
 
 
 /**
  * Whether the user agent is Gecko. Gecko is the rendering engine used by
- * Mozilla, Mozilla Firefox, Camino and many more.
+ * Mozilla, Firefox, and others.
  * @type {boolean}
  */
 goog.userAgent.GECKO = goog.userAgent.BROWSER_KNOWN_ ?
     goog.userAgent.ASSUME_GECKO :
-    goog.userAgent.detectedGecko_;
+    goog.labs.userAgent.engine.isGecko();
 
 
 /**
@@ -204,15 +162,35 @@ goog.userAgent.GECKO = goog.userAgent.BROWSER_KNOWN_ ?
  */
 goog.userAgent.WEBKIT = goog.userAgent.BROWSER_KNOWN_ ?
     goog.userAgent.ASSUME_WEBKIT || goog.userAgent.ASSUME_MOBILE_WEBKIT :
-    goog.userAgent.detectedWebkit_;
+    goog.labs.userAgent.engine.isWebKit();
+
+
+/**
+ * Whether the user agent is running on a mobile device.
+ *
+ * This is a separate function so that the logic can be tested.
+ *
+ * TODO(nnaze): Investigate swapping in goog.labs.userAgent.device.isMobile().
+ *
+ * @return {boolean} Whether the user agent is running on a mobile device.
+ * @private
+ */
+goog.userAgent.isMobile_ = function() {
+  return goog.userAgent.WEBKIT &&
+         goog.labs.userAgent.util.matchUserAgent('Mobile');
+};
 
 
 /**
  * Whether the user agent is running on a mobile device.
+ *
+ * TODO(nnaze): Consider deprecating MOBILE when labs.userAgent
+ *   is promoted as the gecko/webkit logic is likely inaccurate.
+ *
  * @type {boolean}
  */
 goog.userAgent.MOBILE = goog.userAgent.ASSUME_MOBILE_WEBKIT ||
-                        goog.userAgent.detectedMobile_;
+                        goog.userAgent.isMobile_();
 
 
 /**
@@ -305,82 +283,12 @@ goog.userAgent.PLATFORM_KNOWN_ =
     goog.userAgent.ASSUME_IPAD;
 
 
-/**
- * Initialize the goog.userAgent constants that define which platform the user
- * agent is running on.
- * @private
- */
-goog.userAgent.initPlatform_ = function() {
-  /**
-   * Whether the user agent is running on a Macintosh operating system.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedMac_ = goog.string.contains(goog.userAgent.PLATFORM,
-      'Mac');
-
-  /**
-   * Whether the user agent is running on a Windows operating system.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedWindows_ = goog.string.contains(
-      goog.userAgent.PLATFORM, 'Win');
-
-  /**
-   * Whether the user agent is running on a Linux operating system.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedLinux_ = goog.string.contains(goog.userAgent.PLATFORM,
-      'Linux');
-
-  /**
-   * Whether the user agent is running on a X11 windowing system.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedX11_ = !!goog.userAgent.getNavigator() &&
-      goog.string.contains(goog.userAgent.getNavigator()['appVersion'] || '',
-          'X11');
-
-  // Need user agent string for Android/IOS detection
-  var ua = goog.userAgent.getUserAgentString();
-
-  /**
-   * Whether the user agent is running on Android.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedAndroid_ = !!ua && ua.indexOf('Android') >= 0;
-
-  /**
-   * Whether the user agent is running on an iPhone.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedIPhone_ = !!ua && ua.indexOf('iPhone') >= 0;
-
-  /**
-   * Whether the user agent is running on an iPad.
-   * @type {boolean}
-   * @private
-   */
-  goog.userAgent.detectedIPad_ = !!ua && ua.indexOf('iPad') >= 0;
-};
-
-
-if (!goog.userAgent.PLATFORM_KNOWN_) {
-  goog.userAgent.initPlatform_();
-}
-
-
 /**
  * Whether the user agent is running on a Macintosh operating system.
  * @type {boolean}
  */
 goog.userAgent.MAC = goog.userAgent.PLATFORM_KNOWN_ ?
-    goog.userAgent.ASSUME_MAC : goog.userAgent.detectedMac_;
+    goog.userAgent.ASSUME_MAC : goog.labs.userAgent.platform.isMacintosh();
 
 
 /**
@@ -388,15 +296,46 @@ goog.userAgent.MAC = goog.userAgent.PLATFORM_KNOWN_ ?
  * @type {boolean}
  */
 goog.userAgent.WINDOWS = goog.userAgent.PLATFORM_KNOWN_ ?
-    goog.userAgent.ASSUME_WINDOWS : goog.userAgent.detectedWindows_;
+    goog.userAgent.ASSUME_WINDOWS :
+    goog.labs.userAgent.platform.isWindows();
+
+
+/**
+ * Whether the user agent is Linux per the legacy behavior of
+ * goog.userAgent.LINUX, which considered ChromeOS to also be
+ * Linux.
+ * @return {boolean}
+ * @private
+ */
+goog.userAgent.isLegacyLinux_ = function() {
+  return goog.labs.userAgent.platform.isLinux() ||
+      goog.labs.userAgent.platform.isChromeOS();
+};
 
 
 /**
  * Whether the user agent is running on a Linux operating system.
+ *
+ * Note that goog.userAgent.LINUX considers ChromeOS to be Linux,
+ * while goog.labs.userAgent.platform considers ChromeOS and
+ * Linux to be different OSes.
+ *
  * @type {boolean}
  */
 goog.userAgent.LINUX = goog.userAgent.PLATFORM_KNOWN_ ?
-    goog.userAgent.ASSUME_LINUX : goog.userAgent.detectedLinux_;
+    goog.userAgent.ASSUME_LINUX :
+    goog.userAgent.isLegacyLinux_();
+
+
+/**
+ * @return {boolean} Whether the user agent is an X11 windowing system.
+ * @private
+ */
+goog.userAgent.isX11_ = function() {
+  var navigator = goog.userAgent.getNavigator();
+  return !!navigator &&
+      goog.string.contains(navigator['appVersion'] || '', 'X11');
+};
 
 
 /**
@@ -404,7 +343,8 @@ goog.userAgent.LINUX = goog.userAgent.PLATFORM_KNOWN_ ?
  * @type {boolean}
  */
 goog.userAgent.X11 = goog.userAgent.PLATFORM_KNOWN_ ?
-    goog.userAgent.ASSUME_X11 : goog.userAgent.detectedX11_;
+    goog.userAgent.ASSUME_X11 :
+    goog.userAgent.isX11_();
 
 
 /**
@@ -412,7 +352,8 @@ goog.userAgent.X11 = goog.userAgent.PLATFORM_KNOWN_ ?
  * @type {boolean}
  */
 goog.userAgent.ANDROID = goog.userAgent.PLATFORM_KNOWN_ ?
-    goog.userAgent.ASSUME_ANDROID : goog.userAgent.detectedAndroid_;
+    goog.userAgent.ASSUME_ANDROID :
+    goog.labs.userAgent.platform.isAndroid();
 
 
 /**
@@ -420,7 +361,8 @@ goog.userAgent.ANDROID = goog.userAgent.PLATFORM_KNOWN_ ?
  * @type {boolean}
  */
 goog.userAgent.IPHONE = goog.userAgent.PLATFORM_KNOWN_ ?
-    goog.userAgent.ASSUME_IPHONE : goog.userAgent.detectedIPhone_;
+    goog.userAgent.ASSUME_IPHONE :
+    goog.labs.userAgent.platform.isIphone();
 
 
 /**
@@ -428,7 +370,24 @@ goog.userAgent.IPHONE = goog.userAgent.PLATFORM_KNOWN_ ?
  * @type {boolean}
  */
 goog.userAgent.IPAD = goog.userAgent.PLATFORM_KNOWN_ ?
-    goog.userAgent.ASSUME_IPAD : goog.userAgent.detectedIPad_;
+    goog.userAgent.ASSUME_IPAD :
+    goog.labs.userAgent.platform.isIpad();
+
+
+/**
+ * @return {string} The string that describes the version number of the user
+ *     agent.
+ * Assumes user agent is opera.
+ * @private
+ */
+goog.userAgent.operaVersion_ = function() {
+  var version = goog.global.opera.version;
+  try {
+    return version();
+  } catch (e) {
+    return version;
+  }
+};
 
 
 /**
@@ -440,27 +399,18 @@ goog.userAgent.determineVersion_ = function() {
   // All browsers have different ways to detect the version and they all have
   // different naming schemes.
 
+  if (goog.userAgent.OPERA && goog.global['opera']) {
+    return goog.userAgent.operaVersion_();
+  }
+
   // version is a string rather than a number because it may contain 'b', 'a',
   // and so on.
-  var version = '', re;
-
-  if (goog.userAgent.OPERA && goog.global['opera']) {
-    var operaVersion = goog.global['opera'].version;
-    version = typeof operaVersion == 'function' ? operaVersion() : operaVersion;
-  } else {
-    if (goog.userAgent.GECKO) {
-      re = /rv\:([^\);]+)(\)|;)/;
-    } else if (goog.userAgent.IE) {
-      re = /MSIE\s+([^\);]+)(\)|;)/;
-    } else if (goog.userAgent.WEBKIT) {
-      // WebKit/125.4
-      re = /WebKit\/(\S+)/;
-    }
-    if (re) {
-      var arr = re.exec(goog.userAgent.getUserAgentString());
-      version = arr ? arr[1] : '';
-    }
+  var version = '';
+  var arr = goog.userAgent.getVersionRegexResult_();
+  if (arr) {
+    version = arr ? arr[1] : '';
   }
+
   if (goog.userAgent.IE) {
     // IE9 can be in document mode 9 but be reporting an inconsistent user agent
     // version.  If it is identifying as a version lower than 9 we take the
@@ -472,10 +422,36 @@ goog.userAgent.determineVersion_ = function() {
       return String(docMode);
     }
   }
+
   return version;
 };
 
 
+/**
+ * @return {Array|undefined} The version regex matches from parsing the user
+ *     agent string. These regex statements must be executed inline so they can
+ *     be compiled out by the closure compiler with the rest of the useragent
+ *     detection logic when ASSUME_* is specified.
+ * @private
+ */
+goog.userAgent.getVersionRegexResult_ = function() {
+  var userAgent = goog.userAgent.getUserAgentString();
+  if (goog.userAgent.GECKO) {
+    return /rv\:([^\);]+)(\)|;)/.exec(userAgent);
+  }
+  if (goog.userAgent.EDGE) {
+    return /Edge\/([\d\.]+)/.exec(userAgent);
+  }
+  if (goog.userAgent.IE) {
+    return /\b(?:MSIE|rv)[: ]([^\);]+)(\)|;)/.exec(userAgent);
+  }
+  if (goog.userAgent.WEBKIT) {
+    // WebKit/125.4
+    return /WebKit\/(\S+)/.exec(userAgent);
+  }
+};
+
+
 /**
  * @return {number|undefined} Returns the document mode (for testing).
  * @private
@@ -563,7 +539,7 @@ goog.userAgent.isVersion = goog.userAgent.isVersionOrHigher;
  *     same as the given version.
  */
 goog.userAgent.isDocumentModeOrHigher = function(documentMode) {
-  return goog.userAgent.IE && goog.userAgent.DOCUMENT_MODE >= documentMode;
+  return goog.userAgent.DOCUMENT_MODE >= documentMode;
 };
 
 
@@ -572,6 +548,7 @@ goog.userAgent.isDocumentModeOrHigher = function(documentMode) {
  * @param {number} version The version to check.
  * @return {boolean} Whether the IE effective document mode is higher or the
  *      same as the given version.
+ * @deprecated Use goog.userAgent.isDocumentModeOrHigher().
  */
 goog.userAgent.isDocumentMode = goog.userAgent.isDocumentModeOrHigher;
 
@@ -586,10 +563,10 @@ goog.userAgent.isDocumentMode = goog.userAgent.isDocumentModeOrHigher;
  */
 goog.userAgent.DOCUMENT_MODE = (function() {
   var doc = goog.global['document'];
+  var mode = goog.userAgent.getDocumentMode_();
   if (!doc || !goog.userAgent.IE) {
     return undefined;
   }
-  var mode = goog.userAgent.getDocumentMode_();
   return mode || (doc['compatMode'] == 'CSS1Compat' ?
       parseInt(goog.userAgent.VERSION, 10) : 5);
 })();
diff --git a/lib/safari/client.js b/lib/safari/client.js
new file mode 100644
index 0000000..c00b998
--- /dev/null
+++ b/lib/safari/client.js
@@ -0,0 +1,7203 @@
+'use strict';var COMPILED = !0, goog = goog || {};
+goog.global = this;
+goog.isDef = function(a) {
+  return void 0 !== a;
+};
+goog.exportPath_ = function(a, b, c) {
+  a = a.split(".");
+  c = c || goog.global;
+  a[0] in c || !c.execScript || c.execScript("var " + a[0]);
+  for (var d;a.length && (d = a.shift());) {
+    !a.length && goog.isDef(b) ? c[d] = b : c = c[d] ? c[d] : c[d] = {};
+  }
+};
+goog.define = function(a, b) {
+  var c = b;
+  COMPILED || (goog.global.CLOSURE_UNCOMPILED_DEFINES && Object.prototype.hasOwnProperty.call(goog.global.CLOSURE_UNCOMPILED_DEFINES, a) ? c = goog.global.CLOSURE_UNCOMPILED_DEFINES[a] : goog.global.CLOSURE_DEFINES && Object.prototype.hasOwnProperty.call(goog.global.CLOSURE_DEFINES, a) && (c = goog.global.CLOSURE_DEFINES[a]));
+  goog.exportPath_(a, c);
+};
+goog.DEBUG = !0;
+goog.LOCALE = "en";
+goog.TRUSTED_SITE = !0;
+goog.STRICT_MODE_COMPATIBLE = !1;
+goog.DISALLOW_TEST_ONLY_CODE = COMPILED && !goog.DEBUG;
+goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING = !1;
+goog.provide = function(a) {
+  if (!COMPILED && goog.isProvided_(a)) {
+    throw Error('Namespace "' + a + '" already declared.');
+  }
+  goog.constructNamespace_(a);
+};
+goog.constructNamespace_ = function(a, b) {
+  if (!COMPILED) {
+    delete goog.implicitNamespaces_[a];
+    for (var c = a;(c = c.substring(0, c.lastIndexOf("."))) && !goog.getObjectByName(c);) {
+      goog.implicitNamespaces_[c] = !0;
+    }
+  }
+  goog.exportPath_(a, b);
+};
+goog.VALID_MODULE_RE_ = /^[a-zA-Z_$][a-zA-Z0-9._$]*$/;
+goog.module = function(a) {
+  if (!goog.isString(a) || !a || -1 == a.search(goog.VALID_MODULE_RE_)) {
+    throw Error("Invalid module identifier");
+  }
+  if (!goog.isInModuleLoader_()) {
+    throw Error("Module " + a + " has been loaded incorrectly.");
+  }
+  if (goog.moduleLoaderState_.moduleName) {
+    throw Error("goog.module may only be called once per module.");
+  }
+  goog.moduleLoaderState_.moduleName = a;
+  if (!COMPILED) {
+    if (goog.isProvided_(a)) {
+      throw Error('Namespace "' + a + '" already declared.');
+    }
+    delete goog.implicitNamespaces_[a];
+  }
+};
+goog.module.get = function(a) {
+  return goog.module.getInternal_(a);
+};
+goog.module.getInternal_ = function(a) {
+  if (!COMPILED) {
+    return goog.isProvided_(a) ? a in goog.loadedModules_ ? goog.loadedModules_[a] : goog.getObjectByName(a) : null;
+  }
+};
+goog.moduleLoaderState_ = null;
+goog.isInModuleLoader_ = function() {
+  return null != goog.moduleLoaderState_;
+};
+goog.module.declareLegacyNamespace = function() {
+  if (!COMPILED && !goog.isInModuleLoader_()) {
+    throw Error("goog.module.declareLegacyNamespace must be called from within a goog.module");
+  }
+  if (!COMPILED && !goog.moduleLoaderState_.moduleName) {
+    throw Error("goog.module must be called prior to goog.module.declareLegacyNamespace.");
+  }
+  goog.moduleLoaderState_.declareLegacyNamespace = !0;
+};
+goog.setTestOnly = function(a) {
+  if (goog.DISALLOW_TEST_ONLY_CODE) {
+    throw a = a || "", Error("Importing test-only code into non-debug environment" + (a ? ": " + a : "."));
+  }
+};
+goog.forwardDeclare = function(a) {
+};
+COMPILED || (goog.isProvided_ = function(a) {
+  return a in goog.loadedModules_ || !goog.implicitNamespaces_[a] && goog.isDefAndNotNull(goog.getObjectByName(a));
+}, goog.implicitNamespaces_ = {"goog.module":!0});
+goog.getObjectByName = function(a, b) {
+  for (var c = a.split("."), d = b || goog.global, e;e = c.shift();) {
+    if (goog.isDefAndNotNull(d[e])) {
+      d = d[e];
+    } else {
+      return null;
+    }
+  }
+  return d;
+};
+goog.globalize = function(a, b) {
+  var c = b || goog.global, d;
+  for (d in a) {
+    c[d] = a[d];
+  }
+};
+goog.addDependency = function(a, b, c, d) {
+  if (goog.DEPENDENCIES_ENABLED) {
+    var e;
+    a = a.replace(/\\/g, "/");
+    for (var f = goog.dependencies_, g = 0;e = b[g];g++) {
+      f.nameToPath[e] = a, f.pathIsModule[a] = !!d;
+    }
+    for (d = 0;b = c[d];d++) {
+      a in f.requires || (f.requires[a] = {}), f.requires[a][b] = !0;
+    }
+  }
+};
+goog.ENABLE_DEBUG_LOADER = !0;
+goog.logToConsole_ = function(a) {
+  goog.global.console && goog.global.console.error(a);
+};
+goog.require = function(a) {
+  if (!COMPILED) {
+    goog.ENABLE_DEBUG_LOADER && goog.IS_OLD_IE_ && goog.maybeProcessDeferredDep_(a);
+    if (goog.isProvided_(a)) {
+      return goog.isInModuleLoader_() ? goog.module.getInternal_(a) : null;
+    }
+    if (goog.ENABLE_DEBUG_LOADER) {
+      var b = goog.getPathFromDeps_(a);
+      if (b) {
+        return goog.writeScripts_(b), null;
+      }
+    }
+    a = "goog.require could not find: " + a;
+    goog.logToConsole_(a);
+    throw Error(a);
+  }
+};
+goog.basePath = "";
+goog.nullFunction = function() {
+};
+goog.abstractMethod = function() {
+  throw Error("unimplemented abstract method");
+};
+goog.addSingletonGetter = function(a) {
+  a.getInstance = function() {
+    if (a.instance_) {
+      return a.instance_;
+    }
+    goog.DEBUG && (goog.instantiatedSingletons_[goog.instantiatedSingletons_.length] = a);
+    return a.instance_ = new a;
+  };
+};
+goog.instantiatedSingletons_ = [];
+goog.LOAD_MODULE_USING_EVAL = !0;
+goog.SEAL_MODULE_EXPORTS = goog.DEBUG;
+goog.loadedModules_ = {};
+goog.DEPENDENCIES_ENABLED = !COMPILED && goog.ENABLE_DEBUG_LOADER;
+goog.DEPENDENCIES_ENABLED && (goog.dependencies_ = {pathIsModule:{}, nameToPath:{}, requires:{}, visited:{}, written:{}, deferred:{}}, goog.inHtmlDocument_ = function() {
+  var a = goog.global.document;
+  return null != a && "write" in a;
+}, goog.findBasePath_ = function() {
+  if (goog.isDef(goog.global.CLOSURE_BASE_PATH)) {
+    goog.basePath = goog.global.CLOSURE_BASE_PATH;
+  } else {
+    if (goog.inHtmlDocument_()) {
+      for (var a = goog.global.document.getElementsByTagName("SCRIPT"), b = a.length - 1;0 <= b;--b) {
+        var c = a[b].src, d = c.lastIndexOf("?"), d = -1 == d ? c.length : d;
+        if ("base.js" == c.substr(d - 7, 7)) {
+          goog.basePath = c.substr(0, d - 7);
+          break;
+        }
+      }
+    }
+  }
+}, goog.importScript_ = function(a, b) {
+  (goog.global.CLOSURE_IMPORT_SCRIPT || goog.writeScriptTag_)(a, b) && (goog.dependencies_.written[a] = !0);
+}, goog.IS_OLD_IE_ = !(goog.global.atob || !goog.global.document || !goog.global.document.all), goog.importModule_ = function(a) {
+  goog.importScript_("", 'goog.retrieveAndExecModule_("' + a + '");') && (goog.dependencies_.written[a] = !0);
+}, goog.queuedModules_ = [], goog.wrapModule_ = function(a, b) {
+  return goog.LOAD_MODULE_USING_EVAL && goog.isDef(goog.global.JSON) ? "goog.loadModule(" + goog.global.JSON.stringify(b + "\n//# sourceURL=" + a + "\n") + ");" : 'goog.loadModule(function(exports) {"use strict";' + b + "\n;return exports});\n//# sourceURL=" + a + "\n";
+}, goog.loadQueuedModules_ = function() {
+  var a = goog.queuedModules_.length;
+  if (0 < a) {
+    var b = goog.queuedModules_;
+    goog.queuedModules_ = [];
+    for (var c = 0;c < a;c++) {
+      goog.maybeProcessDeferredPath_(b[c]);
+    }
+  }
+}, goog.maybeProcessDeferredDep_ = function(a) {
+  goog.isDeferredModule_(a) && goog.allDepsAreAvailable_(a) && (a = goog.getPathFromDeps_(a), goog.maybeProcessDeferredPath_(goog.basePath + a));
+}, goog.isDeferredModule_ = function(a) {
+  return (a = goog.getPathFromDeps_(a)) && goog.dependencies_.pathIsModule[a] ? goog.basePath + a in goog.dependencies_.deferred : !1;
+}, goog.allDepsAreAvailable_ = function(a) {
+  if ((a = goog.getPathFromDeps_(a)) && a in goog.dependencies_.requires) {
+    for (var b in goog.dependencies_.requires[a]) {
+      if (!goog.isProvided_(b) && !goog.isDeferredModule_(b)) {
+        return !1;
+      }
+    }
+  }
+  return !0;
+}, goog.maybeProcessDeferredPath_ = function(a) {
+  if (a in goog.dependencies_.deferred) {
+    var b = goog.dependencies_.deferred[a];
+    delete goog.dependencies_.deferred[a];
+    goog.globalEval(b);
+  }
+}, goog.loadModuleFromUrl = function(a) {
+  goog.retrieveAndExecModule_(a);
+}, goog.loadModule = function(a) {
+  var b = goog.moduleLoaderState_;
+  try {
+    goog.moduleLoaderState_ = {moduleName:void 0, declareLegacyNamespace:!1};
+    var c;
+    if (goog.isFunction(a)) {
+      c = a.call(goog.global, {});
+    } else {
+      if (goog.isString(a)) {
+        c = goog.loadModuleFromSource_.call(goog.global, a);
+      } else {
+        throw Error("Invalid module definition");
+      }
+    }
+    var d = goog.moduleLoaderState_.moduleName;
+    if (!goog.isString(d) || !d) {
+      throw Error('Invalid module name "' + d + '"');
+    }
+    goog.moduleLoaderState_.declareLegacyNamespace ? goog.constructNamespace_(d, c) : goog.SEAL_MODULE_EXPORTS && Object.seal && Object.seal(c);
+    goog.loadedModules_[d] = c;
+  } finally {
+    goog.moduleLoaderState_ = b;
+  }
+}, goog.loadModuleFromSource_ = function(a) {
+  eval(a);
+  return {};
+}, goog.writeScriptSrcNode_ = function(a) {
+  goog.global.document.write('<script type="text/javascript" src="' + a + '">\x3c/script>');
+}, goog.appendScriptSrcNode_ = function(a) {
+  var b = goog.global.document, c = b.createElement("script");
+  c.type = "text/javascript";
+  c.src = a;
+  c.defer = !1;
+  c.async = !1;
+  b.head.appendChild(c);
+}, goog.writeScriptTag_ = function(a, b) {
+  if (goog.inHtmlDocument_()) {
+    var c = goog.global.document;
+    if (!goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING && "complete" == c.readyState) {
+      if (/\bdeps.js$/.test(a)) {
+        return !1;
+      }
+      throw Error('Cannot write "' + a + '" after document load');
+    }
+    var d = goog.IS_OLD_IE_;
+    void 0 === b ? d ? (d = " onreadystatechange='goog.onScriptLoad_(this, " + ++goog.lastNonModuleScriptIndex_ + ")' ", c.write('<script type="text/javascript" src="' + a + '"' + d + ">\x3c/script>")) : goog.ENABLE_CHROME_APP_SAFE_SCRIPT_LOADING ? goog.appendScriptSrcNode_(a) : goog.writeScriptSrcNode_(a) : c.write('<script type="text/javascript">' + b + "\x3c/script>");
+    return !0;
+  }
+  return !1;
+}, goog.lastNonModuleScriptIndex_ = 0, goog.onScriptLoad_ = function(a, b) {
+  "complete" == a.readyState && goog.lastNonModuleScriptIndex_ == b && goog.loadQueuedModules_();
+  return !0;
+}, goog.writeScripts_ = function(a) {
+  function b(a) {
+    if (!(a in e.written || a in e.visited)) {
+      e.visited[a] = !0;
+      if (a in e.requires) {
+        for (var f in e.requires[a]) {
+          if (!goog.isProvided_(f)) {
+            if (f in e.nameToPath) {
+              b(e.nameToPath[f]);
+            } else {
+              throw Error("Undefined nameToPath for " + f);
+            }
+          }
+        }
+      }
+      a in d || (d[a] = !0, c.push(a));
+    }
+  }
+  var c = [], d = {}, e = goog.dependencies_;
+  b(a);
+  for (a = 0;a < c.length;a++) {
+    var f = c[a];
+    goog.dependencies_.written[f] = !0;
+  }
+  var g = goog.moduleLoaderState_;
+  goog.moduleLoaderState_ = null;
+  for (a = 0;a < c.length;a++) {
+    if (f = c[a]) {
+      e.pathIsModule[f] ? goog.importModule_(goog.basePath + f) : goog.importScript_(goog.basePath + f);
+    } else {
+      throw goog.moduleLoaderState_ = g, Error("Undefined script input");
+    }
+  }
+  goog.moduleLoaderState_ = g;
+}, goog.getPathFromDeps_ = function(a) {
+  return a in goog.dependencies_.nameToPath ? goog.dependencies_.nameToPath[a] : null;
+}, goog.findBasePath_(), goog.global.CLOSURE_NO_DEPS || goog.importScript_(goog.basePath + "deps.js"));
+goog.normalizePath_ = function(a) {
+  a = a.split("/");
+  for (var b = 0;b < a.length;) {
+    "." == a[b] ? a.splice(b, 1) : b && ".." == a[b] && a[b - 1] && ".." != a[b - 1] ? a.splice(--b, 2) : b++;
+  }
+  return a.join("/");
+};
+goog.loadFileSync_ = function(a) {
+  if (goog.global.CLOSURE_LOAD_FILE_SYNC) {
+    return goog.global.CLOSURE_LOAD_FILE_SYNC(a);
+  }
+  var b = new goog.global.XMLHttpRequest;
+  b.open("get", a, !1);
+  b.send();
+  return b.responseText;
+};
+goog.retrieveAndExecModule_ = function(a) {
+  if (!COMPILED) {
+    var b = a;
+    a = goog.normalizePath_(a);
+    var c = goog.global.CLOSURE_IMPORT_SCRIPT || goog.writeScriptTag_, d = goog.loadFileSync_(a);
+    if (null != d) {
+      d = goog.wrapModule_(a, d), goog.IS_OLD_IE_ ? (goog.dependencies_.deferred[b] = d, goog.queuedModules_.push(b)) : c(a, d);
+    } else {
+      throw Error("load of " + a + "failed");
+    }
+  }
+};
+goog.typeOf = function(a) {
+  var b = typeof a;
+  if ("object" == b) {
+    if (a) {
+      if (a instanceof Array) {
+        return "array";
+      }
+      if (a instanceof Object) {
+        return b;
+      }
+      var c = Object.prototype.toString.call(a);
+      if ("[object Window]" == c) {
+        return "object";
+      }
+      if ("[object Array]" == c || "number" == typeof a.length && "undefined" != typeof a.splice && "undefined" != typeof a.propertyIsEnumerable && !a.propertyIsEnumerable("splice")) {
+        return "array";
+      }
+      if ("[object Function]" == c || "undefined" != typeof a.call && "undefined" != typeof a.propertyIsEnumerable && !a.propertyIsEnumerable("call")) {
+        return "function";
+      }
+    } else {
+      return "null";
+    }
+  } else {
+    if ("function" == b && "undefined" == typeof a.call) {
+      return "object";
+    }
+  }
+  return b;
+};
+goog.isNull = function(a) {
+  return null === a;
+};
+goog.isDefAndNotNull = function(a) {
+  return null != a;
+};
+goog.isArray = function(a) {
+  return "array" == goog.typeOf(a);
+};
+goog.isArrayLike = function(a) {
+  var b = goog.typeOf(a);
+  return "array" == b || "object" == b && "number" == typeof a.length;
+};
+goog.isDateLike = function(a) {
+  return goog.isObject(a) && "function" == typeof a.getFullYear;
+};
+goog.isString = function(a) {
+  return "string" == typeof a;
+};
+goog.isBoolean = function(a) {
+  return "boolean" == typeof a;
+};
+goog.isNumber = function(a) {
+  return "number" == typeof a;
+};
+goog.isFunction = function(a) {
+  return "function" == goog.typeOf(a);
+};
+goog.isObject = function(a) {
+  var b = typeof a;
+  return "object" == b && null != a || "function" == b;
+};
+goog.getUid = function(a) {
+  return a[goog.UID_PROPERTY_] || (a[goog.UID_PROPERTY_] = ++goog.uidCounter_);
+};
+goog.hasUid = function(a) {
+  return !!a[goog.UID_PROPERTY_];
+};
+goog.removeUid = function(a) {
+  "removeAttribute" in a && a.removeAttribute(goog.UID_PROPERTY_);
+  try {
+    delete a[goog.UID_PROPERTY_];
+  } catch (b) {
+  }
+};
+goog.UID_PROPERTY_ = "closure_uid_" + (1E9 * Math.random() >>> 0);
+goog.uidCounter_ = 0;
+goog.getHashCode = goog.getUid;
+goog.removeHashCode = goog.removeUid;
+goog.cloneObject = function(a) {
+  var b = goog.typeOf(a);
+  if ("object" == b || "array" == b) {
+    if (a.clone) {
+      return a.clone();
+    }
+    var b = "array" == b ? [] : {}, c;
+    for (c in a) {
+      b[c] = goog.cloneObject(a[c]);
+    }
+    return b;
+  }
+  return a;
+};
+goog.bindNative_ = function(a, b, c) {
+  return a.call.apply(a.bind, arguments);
+};
+goog.bindJs_ = function(a, b, c) {
+  if (!a) {
+    throw Error();
+  }
+  if (2 < arguments.length) {
+    var d = Array.prototype.slice.call(arguments, 2);
+    return function() {
+      var c = Array.prototype.slice.call(arguments);
+      Array.prototype.unshift.apply(c, d);
+      return a.apply(b, c);
+    };
+  }
+  return function() {
+    return a.apply(b, arguments);
+  };
+};
+goog.bind = function(a, b, c) {
+  Function.prototype.bind && -1 != Function.prototype.bind.toString().indexOf("native code") ? goog.bind = goog.bindNative_ : goog.bind = goog.bindJs_;
+  return goog.bind.apply(null, arguments);
+};
+goog.partial = function(a, b) {
+  var c = Array.prototype.slice.call(arguments, 1);
+  return function() {
+    var b = c.slice();
+    b.push.apply(b, arguments);
+    return a.apply(this, b);
+  };
+};
+goog.mixin = function(a, b) {
+  for (var c in b) {
+    a[c] = b[c];
+  }
+};
+goog.now = goog.TRUSTED_SITE && Date.now || function() {
+  return +new Date;
+};
+goog.globalEval = function(a) {
+  if (goog.global.execScript) {
+    goog.global.execScript(a, "JavaScript");
+  } else {
+    if (goog.global.eval) {
+      if (null == goog.evalWorksForGlobals_) {
+        if (goog.global.eval("var _evalTest_ = 1;"), "undefined" != typeof goog.global._evalTest_) {
+          try {
+            delete goog.global._evalTest_;
+          } catch (d) {
+          }
+          goog.evalWorksForGlobals_ = !0;
+        } else {
+          goog.evalWorksForGlobals_ = !1;
+        }
+      }
+      if (goog.evalWorksForGlobals_) {
+        goog.global.eval(a);
+      } else {
+        var b = goog.global.document, c = b.createElement("SCRIPT");
+        c.type = "text/javascript";
+        c.defer = !1;
+        c.appendChild(b.createTextNode(a));
+        b.body.appendChild(c);
+        b.body.removeChild(c);
+      }
+    } else {
+      throw Error("goog.globalEval not available");
+    }
+  }
+};
+goog.evalWorksForGlobals_ = null;
+goog.getCssName = function(a, b) {
+  var c = function(a) {
+    return goog.cssNameMapping_[a] || a;
+  }, d = function(a) {
+    a = a.split("-");
+    for (var b = [], d = 0;d < a.length;d++) {
+      b.push(c(a[d]));
+    }
+    return b.join("-");
+  }, d = goog.cssNameMapping_ ? "BY_WHOLE" == goog.cssNameMappingStyle_ ? c : d : function(a) {
+    return a;
+  };
+  return b ? a + "-" + d(b) : d(a);
+};
+goog.setCssNameMapping = function(a, b) {
+  goog.cssNameMapping_ = a;
+  goog.cssNameMappingStyle_ = b;
+};
+!COMPILED && goog.global.CLOSURE_CSS_NAME_MAPPING && (goog.cssNameMapping_ = goog.global.CLOSURE_CSS_NAME_MAPPING);
+goog.getMsg = function(a, b) {
+  b && (a = a.replace(/\{\$([^}]+)}/g, function(a, d) {
+    return null != b && d in b ? b[d] : a;
+  }));
+  return a;
+};
+goog.getMsgWithFallback = function(a, b) {
+  return a;
+};
+goog.exportSymbol = function(a, b, c) {
+  goog.exportPath_(a, b, c);
+};
+goog.exportProperty = function(a, b, c) {
+  a[b] = c;
+};
+goog.inherits = function(a, b) {
+  function c() {
+  }
+  c.prototype = b.prototype;
+  a.superClass_ = b.prototype;
+  a.prototype = new c;
+  a.prototype.constructor = a;
+  a.base = function(a, c, f) {
+    for (var g = Array(arguments.length - 2), h = 2;h < arguments.length;h++) {
+      g[h - 2] = arguments[h];
+    }
+    return b.prototype[c].apply(a, g);
+  };
+};
+goog.base = function(a, b, c) {
+  var d = arguments.callee.caller;
+  if (goog.STRICT_MODE_COMPATIBLE || goog.DEBUG && !d) {
+    throw Error("arguments.caller not defined.  goog.base() cannot be used with strict mode code. See http://www.ecma-international.org/ecma-262/5.1/#sec-C");
+  }
+  if (d.superClass_) {
+    for (var e = Array(arguments.length - 1), f = 1;f < arguments.length;f++) {
+      e[f - 1] = arguments[f];
+    }
+    return d.superClass_.constructor.apply(a, e);
+  }
+  e = Array(arguments.length - 2);
+  for (f = 2;f < arguments.length;f++) {
+    e[f - 2] = arguments[f];
+  }
+  for (var f = !1, g = a.constructor;g;g = g.superClass_ && g.superClass_.constructor) {
+    if (g.prototype[b] === d) {
+      f = !0;
+    } else {
+      if (f) {
+        return g.prototype[b].apply(a, e);
+      }
+    }
+  }
+  if (a[b] === d) {
+    return a.constructor.prototype[b].apply(a, e);
+  }
+  throw Error("goog.base called from a method of one name to a method of a different name");
+};
+goog.scope = function(a) {
+  a.call(goog.global);
+};
+COMPILED || (goog.global.COMPILED = COMPILED);
+goog.defineClass = function(a, b) {
+  var c = b.constructor, d = b.statics;
+  c && c != Object.prototype.constructor || (c = function() {
+    throw Error("cannot instantiate an interface (no constructor defined).");
+  });
+  c = goog.defineClass.createSealingConstructor_(c, a);
+  a && goog.inherits(c, a);
+  delete b.constructor;
+  delete b.statics;
+  goog.defineClass.applyProperties_(c.prototype, b);
+  null != d && (d instanceof Function ? d(c) : goog.defineClass.applyProperties_(c, d));
+  return c;
+};
+goog.defineClass.SEAL_CLASS_INSTANCES = goog.DEBUG;
+goog.defineClass.createSealingConstructor_ = function(a, b) {
+  if (goog.defineClass.SEAL_CLASS_INSTANCES && Object.seal instanceof Function) {
+    if (b && b.prototype && b.prototype[goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_]) {
+      return a;
+    }
+    var c = function() {
+      var b = a.apply(this, arguments) || this;
+      b[goog.UID_PROPERTY_] = b[goog.UID_PROPERTY_];
+      this.constructor === c && Object.seal(b);
+      return b;
+    };
+    return c;
+  }
+  return a;
+};
+goog.defineClass.OBJECT_PROTOTYPE_FIELDS_ = "constructor hasOwnProperty isPrototypeOf propertyIsEnumerable toLocaleString toString valueOf".split(" ");
+goog.defineClass.applyProperties_ = function(a, b) {
+  for (var c in b) {
+    Object.prototype.hasOwnProperty.call(b, c) && (a[c] = b[c]);
+  }
+  for (var d = 0;d < goog.defineClass.OBJECT_PROTOTYPE_FIELDS_.length;d++) {
+    c = goog.defineClass.OBJECT_PROTOTYPE_FIELDS_[d], Object.prototype.hasOwnProperty.call(b, c) && (a[c] = b[c]);
+  }
+};
+goog.tagUnsealableClass = function(a) {
+  !COMPILED && goog.defineClass.SEAL_CLASS_INSTANCES && (a.prototype[goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_] = !0);
+};
+goog.UNSEALABLE_CONSTRUCTOR_PROPERTY_ = "goog_defineClass_legacy_unsealable";
+goog.debug = {};
+goog.debug.Error = function(a) {
+  if (Error.captureStackTrace) {
+    Error.captureStackTrace(this, goog.debug.Error);
+  } else {
+    var b = Error().stack;
+    b && (this.stack = b);
+  }
+  a && (this.message = String(a));
+  this.reportErrorToServer = !0;
+};
+goog.inherits(goog.debug.Error, Error);
+goog.debug.Error.prototype.name = "CustomError";
+goog.dom = {};
+goog.dom.NodeType = {ELEMENT:1, ATTRIBUTE:2, TEXT:3, CDATA_SECTION:4, ENTITY_REFERENCE:5, ENTITY:6, PROCESSING_INSTRUCTION:7, COMMENT:8, DOCUMENT:9, DOCUMENT_TYPE:10, DOCUMENT_FRAGMENT:11, NOTATION:12};
+goog.string = {};
+goog.string.DETECT_DOUBLE_ESCAPING = !1;
+goog.string.FORCE_NON_DOM_HTML_UNESCAPING = !1;
+goog.string.Unicode = {NBSP:"\u00a0"};
+goog.string.startsWith = function(a, b) {
+  return 0 == a.lastIndexOf(b, 0);
+};
+goog.string.endsWith = function(a, b) {
+  var c = a.length - b.length;
+  return 0 <= c && a.indexOf(b, c) == c;
+};
+goog.string.caseInsensitiveStartsWith = function(a, b) {
+  return 0 == goog.string.caseInsensitiveCompare(b, a.substr(0, b.length));
+};
+goog.string.caseInsensitiveEndsWith = function(a, b) {
+  return 0 == goog.string.caseInsensitiveCompare(b, a.substr(a.length - b.length, b.length));
+};
+goog.string.caseInsensitiveEquals = function(a, b) {
+  return a.toLowerCase() == b.toLowerCase();
+};
+goog.string.subs = function(a, b) {
+  for (var c = a.split("%s"), d = "", e = Array.prototype.slice.call(arguments, 1);e.length && 1 < c.length;) {
+    d += c.shift() + e.shift();
+  }
+  return d + c.join("%s");
+};
+goog.string.collapseWhitespace = function(a) {
+  return a.replace(/[\s\xa0]+/g, " ").replace(/^\s+|\s+$/g, "");
+};
+goog.string.isEmptyOrWhitespace = function(a) {
+  return /^[\s\xa0]*$/.test(a);
+};
+goog.string.isEmptyString = function(a) {
+  return 0 == a.length;
+};
+goog.string.isEmpty = goog.string.isEmptyOrWhitespace;
+goog.string.isEmptyOrWhitespaceSafe = function(a) {
+  return goog.string.isEmptyOrWhitespace(goog.string.makeSafe(a));
+};
+goog.string.isEmptySafe = goog.string.isEmptyOrWhitespaceSafe;
+goog.string.isBreakingWhitespace = function(a) {
+  return !/[^\t\n\r ]/.test(a);
+};
+goog.string.isAlpha = function(a) {
+  return !/[^a-zA-Z]/.test(a);
+};
+goog.string.isNumeric = function(a) {
+  return !/[^0-9]/.test(a);
+};
+goog.string.isAlphaNumeric = function(a) {
+  return !/[^a-zA-Z0-9]/.test(a);
+};
+goog.string.isSpace = function(a) {
+  return " " == a;
+};
+goog.string.isUnicodeChar = function(a) {
+  return 1 == a.length && " " <= a && "~" >= a || "\u0080" <= a && "\ufffd" >= a;
+};
+goog.string.stripNewlines = function(a) {
+  return a.replace(/(\r\n|\r|\n)+/g, " ");
+};
+goog.string.canonicalizeNewlines = function(a) {
+  return a.replace(/(\r\n|\r|\n)/g, "\n");
+};
+goog.string.normalizeWhitespace = function(a) {
+  return a.replace(/\xa0|\s/g, " ");
+};
+goog.string.normalizeSpaces = function(a) {
+  return a.replace(/\xa0|[ \t]+/g, " ");
+};
+goog.string.collapseBreakingSpaces = function(a) {
+  return a.replace(/[\t\r\n ]+/g, " ").replace(/^[\t\r\n ]+|[\t\r\n ]+$/g, "");
+};
+goog.string.trim = goog.TRUSTED_SITE && String.prototype.trim ? function(a) {
+  return a.trim();
+} : function(a) {
+  return a.replace(/^[\s\xa0]+|[\s\xa0]+$/g, "");
+};
+goog.string.trimLeft = function(a) {
+  return a.replace(/^[\s\xa0]+/, "");
+};
+goog.string.trimRight = function(a) {
+  return a.replace(/[\s\xa0]+$/, "");
+};
+goog.string.caseInsensitiveCompare = function(a, b) {
+  var c = String(a).toLowerCase(), d = String(b).toLowerCase();
+  return c < d ? -1 : c == d ? 0 : 1;
+};
+goog.string.numberAwareCompare_ = function(a, b, c) {
+  if (a == b) {
+    return 0;
+  }
+  if (!a) {
+    return -1;
+  }
+  if (!b) {
+    return 1;
+  }
+  for (var d = a.toLowerCase().match(c), e = b.toLowerCase().match(c), f = Math.min(d.length, e.length), g = 0;g < f;g++) {
+    c = d[g];
+    var h = e[g];
+    if (c != h) {
+      return a = parseInt(c, 10), !isNaN(a) && (b = parseInt(h, 10), !isNaN(b) && a - b) ? a - b : c < h ? -1 : 1;
+    }
+  }
+  return d.length != e.length ? d.length - e.length : a < b ? -1 : 1;
+};
+goog.string.intAwareCompare = function(a, b) {
+  return goog.string.numberAwareCompare_(a, b, /\d+|\D+/g);
+};
+goog.string.floatAwareCompare = function(a, b) {
+  return goog.string.numberAwareCompare_(a, b, /\d+|\.\d+|\D+/g);
+};
+goog.string.numerateCompare = goog.string.floatAwareCompare;
+goog.string.urlEncode = function(a) {
+  return encodeURIComponent(String(a));
+};
+goog.string.urlDecode = function(a) {
+  return decodeURIComponent(a.replace(/\+/g, " "));
+};
+goog.string.newLineToBr = function(a, b) {
+  return a.replace(/(\r\n|\r|\n)/g, b ? "<br />" : "<br>");
+};
+goog.string.htmlEscape = function(a, b) {
+  if (b) {
+    a = a.replace(goog.string.AMP_RE_, "&amp;").replace(goog.string.LT_RE_, "&lt;").replace(goog.string.GT_RE_, "&gt;").replace(goog.string.QUOT_RE_, "&quot;").replace(goog.string.SINGLE_QUOTE_RE_, "&#39;").replace(goog.string.NULL_RE_, "&#0;"), goog.string.DETECT_DOUBLE_ESCAPING && (a = a.replace(goog.string.E_RE_, "&#101;"));
+  } else {
+    if (!goog.string.ALL_RE_.test(a)) {
+      return a;
+    }
+    -1 != a.indexOf("&") && (a = a.replace(goog.string.AMP_RE_, "&amp;"));
+    -1 != a.indexOf("<") && (a = a.replace(goog.string.LT_RE_, "&lt;"));
+    -1 != a.indexOf(">") && (a = a.replace(goog.string.GT_RE_, "&gt;"));
+    -1 != a.indexOf('"') && (a = a.replace(goog.string.QUOT_RE_, "&quot;"));
+    -1 != a.indexOf("'") && (a = a.replace(goog.string.SINGLE_QUOTE_RE_, "&#39;"));
+    -1 != a.indexOf("\x00") && (a = a.replace(goog.string.NULL_RE_, "&#0;"));
+    goog.string.DETECT_DOUBLE_ESCAPING && -1 != a.indexOf("e") && (a = a.replace(goog.string.E_RE_, "&#101;"));
+  }
+  return a;
+};
+goog.string.AMP_RE_ = /&/g;
+goog.string.LT_RE_ = /</g;
+goog.string.GT_RE_ = />/g;
+goog.string.QUOT_RE_ = /"/g;
+goog.string.SINGLE_QUOTE_RE_ = /'/g;
+goog.string.NULL_RE_ = /\x00/g;
+goog.string.E_RE_ = /e/g;
+goog.string.ALL_RE_ = goog.string.DETECT_DOUBLE_ESCAPING ? /[\x00&<>"'e]/ : /[\x00&<>"']/;
+goog.string.unescapeEntities = function(a) {
+  return goog.string.contains(a, "&") ? !goog.string.FORCE_NON_DOM_HTML_UNESCAPING && "document" in goog.global ? goog.string.unescapeEntitiesUsingDom_(a) : goog.string.unescapePureXmlEntities_(a) : a;
+};
+goog.string.unescapeEntitiesWithDocument = function(a, b) {
+  return goog.string.contains(a, "&") ? goog.string.unescapeEntitiesUsingDom_(a, b) : a;
+};
+goog.string.unescapeEntitiesUsingDom_ = function(a, b) {
+  var c = {"&amp;":"&", "&lt;":"<", "&gt;":">", "&quot;":'"'}, d;
+  d = b ? b.createElement("div") : goog.global.document.createElement("div");
+  return a.replace(goog.string.HTML_ENTITY_PATTERN_, function(a, b) {
+    var g = c[a];
+    if (g) {
+      return g;
+    }
+    if ("#" == b.charAt(0)) {
+      var h = Number("0" + b.substr(1));
+      isNaN(h) || (g = String.fromCharCode(h));
+    }
+    g || (d.innerHTML = a + " ", g = d.firstChild.nodeValue.slice(0, -1));
+    return c[a] = g;
+  });
+};
+goog.string.unescapePureXmlEntities_ = function(a) {
+  return a.replace(/&([^;]+);/g, function(a, c) {
+    switch(c) {
+      case "amp":
+        return "&";
+      case "lt":
+        return "<";
+      case "gt":
+        return ">";
+      case "quot":
+        return '"';
+      default:
+        if ("#" == c.charAt(0)) {
+          var d = Number("0" + c.substr(1));
+          if (!isNaN(d)) {
+            return String.fromCharCode(d);
+          }
+        }
+        return a;
+    }
+  });
+};
+goog.string.HTML_ENTITY_PATTERN_ = /&([^;\s<&]+);?/g;
+goog.string.whitespaceEscape = function(a, b) {
+  return goog.string.newLineToBr(a.replace(/  /g, " &#160;"), b);
+};
+goog.string.preserveSpaces = function(a) {
+  return a.replace(/(^|[\n ]) /g, "$1" + goog.string.Unicode.NBSP);
+};
+goog.string.stripQuotes = function(a, b) {
+  for (var c = b.length, d = 0;d < c;d++) {
+    var e = 1 == c ? b : b.charAt(d);
+    if (a.charAt(0) == e && a.charAt(a.length - 1) == e) {
+      return a.substring(1, a.length - 1);
+    }
+  }
+  return a;
+};
+goog.string.truncate = function(a, b, c) {
+  c && (a = goog.string.unescapeEntities(a));
+  a.length > b && (a = a.substring(0, b - 3) + "...");
+  c && (a = goog.string.htmlEscape(a));
+  return a;
+};
+goog.string.truncateMiddle = function(a, b, c, d) {
+  c && (a = goog.string.unescapeEntities(a));
+  if (d && a.length > b) {
+    d > b && (d = b);
+    var e = a.length - d;
+    a = a.substring(0, b - d) + "..." + a.substring(e);
+  } else {
+    a.length > b && (d = Math.floor(b / 2), e = a.length - d, a = a.substring(0, d + b % 2) + "..." + a.substring(e));
+  }
+  c && (a = goog.string.htmlEscape(a));
+  return a;
+};
+goog.string.specialEscapeChars_ = {"\x00":"\\0", "\b":"\\b", "\f":"\\f", "\n":"\\n", "\r":"\\r", "\t":"\\t", "\x0B":"\\x0B", '"':'\\"', "\\":"\\\\", "<":"<"};
+goog.string.jsEscapeCache_ = {"'":"\\'"};
+goog.string.quote = function(a) {
+  a = String(a);
+  for (var b = ['"'], c = 0;c < a.length;c++) {
+    var d = a.charAt(c), e = d.charCodeAt(0);
+    b[c + 1] = goog.string.specialEscapeChars_[d] || (31 < e && 127 > e ? d : goog.string.escapeChar(d));
+  }
+  b.push('"');
+  return b.join("");
+};
+goog.string.escapeString = function(a) {
+  for (var b = [], c = 0;c < a.length;c++) {
+    b[c] = goog.string.escapeChar(a.charAt(c));
+  }
+  return b.join("");
+};
+goog.string.escapeChar = function(a) {
+  if (a in goog.string.jsEscapeCache_) {
+    return goog.string.jsEscapeCache_[a];
+  }
+  if (a in goog.string.specialEscapeChars_) {
+    return goog.string.jsEscapeCache_[a] = goog.string.specialEscapeChars_[a];
+  }
+  var b = a, c = a.charCodeAt(0);
+  if (31 < c && 127 > c) {
+    b = a;
+  } else {
+    if (256 > c) {
+      if (b = "\\x", 16 > c || 256 < c) {
+        b += "0";
+      }
+    } else {
+      b = "\\u", 4096 > c && (b += "0");
+    }
+    b += c.toString(16).toUpperCase();
+  }
+  return goog.string.jsEscapeCache_[a] = b;
+};
+goog.string.contains = function(a, b) {
+  return -1 != a.indexOf(b);
+};
+goog.string.caseInsensitiveContains = function(a, b) {
+  return goog.string.contains(a.toLowerCase(), b.toLowerCase());
+};
+goog.string.countOf = function(a, b) {
+  return a && b ? a.split(b).length - 1 : 0;
+};
+goog.string.removeAt = function(a, b, c) {
+  var d = a;
+  0 <= b && b < a.length && 0 < c && (d = a.substr(0, b) + a.substr(b + c, a.length - b - c));
+  return d;
+};
+goog.string.remove = function(a, b) {
+  var c = new RegExp(goog.string.regExpEscape(b), "");
+  return a.replace(c, "");
+};
+goog.string.removeAll = function(a, b) {
+  var c = new RegExp(goog.string.regExpEscape(b), "g");
+  return a.replace(c, "");
+};
+goog.string.regExpEscape = function(a) {
+  return String(a).replace(/([-()\[\]{}+?*.$\^|,:#<!\\])/g, "\\$1").replace(/\x08/g, "\\x08");
+};
+goog.string.repeat = String.prototype.repeat ? function(a, b) {
+  return a.repeat(b);
+} : function(a, b) {
+  return Array(b + 1).join(a);
+};
+goog.string.padNumber = function(a, b, c) {
+  a = goog.isDef(c) ? a.toFixed(c) : String(a);
+  c = a.indexOf(".");
+  -1 == c && (c = a.length);
+  return goog.string.repeat("0", Math.max(0, b - c)) + a;
+};
+goog.string.makeSafe = function(a) {
+  return null == a ? "" : String(a);
+};
+goog.string.buildString = function(a) {
+  return Array.prototype.join.call(arguments, "");
+};
+goog.string.getRandomString = function() {
+  return Math.floor(2147483648 * Math.random()).toString(36) + Math.abs(Math.floor(2147483648 * Math.random()) ^ goog.now()).toString(36);
+};
+goog.string.compareVersions = function(a, b) {
+  for (var c = 0, d = goog.string.trim(String(a)).split("."), e = goog.string.trim(String(b)).split("."), f = Math.max(d.length, e.length), g = 0;0 == c && g < f;g++) {
+    var h = d[g] || "", k = e[g] || "", l = /(\d*)(\D*)/g, p = /(\d*)(\D*)/g;
+    do {
+      var m = l.exec(h) || ["", "", ""], n = p.exec(k) || ["", "", ""];
+      if (0 == m[0].length && 0 == n[0].length) {
+        break;
+      }
+      var c = 0 == m[1].length ? 0 : parseInt(m[1], 10), q = 0 == n[1].length ? 0 : parseInt(n[1], 10), c = goog.string.compareElements_(c, q) || goog.string.compareElements_(0 == m[2].length, 0 == n[2].length) || goog.string.compareElements_(m[2], n[2]);
+    } while (0 == c);
+  }
+  return c;
+};
+goog.string.compareElements_ = function(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+};
+goog.string.hashCode = function(a) {
+  for (var b = 0, c = 0;c < a.length;++c) {
+    b = 31 * b + a.charCodeAt(c) >>> 0;
+  }
+  return b;
+};
+goog.string.uniqueStringCounter_ = 2147483648 * Math.random() | 0;
+goog.string.createUniqueString = function() {
+  return "goog_" + goog.string.uniqueStringCounter_++;
+};
+goog.string.toNumber = function(a) {
+  var b = Number(a);
+  return 0 == b && goog.string.isEmptyOrWhitespace(a) ? NaN : b;
+};
+goog.string.isLowerCamelCase = function(a) {
+  return /^[a-z]+([A-Z][a-z]*)*$/.test(a);
+};
+goog.string.isUpperCamelCase = function(a) {
+  return /^([A-Z][a-z]*)+$/.test(a);
+};
+goog.string.toCamelCase = function(a) {
+  return String(a).replace(/\-([a-z])/g, function(a, c) {
+    return c.toUpperCase();
+  });
+};
+goog.string.toSelectorCase = function(a) {
+  return String(a).replace(/([A-Z])/g, "-$1").toLowerCase();
+};
+goog.string.toTitleCase = function(a, b) {
+  var c = goog.isString(b) ? goog.string.regExpEscape(b) : "\\s";
+  return a.replace(new RegExp("(^" + (c ? "|[" + c + "]+" : "") + ")([a-z])", "g"), function(a, b, c) {
+    return b + c.toUpperCase();
+  });
+};
+goog.string.capitalize = function(a) {
+  return String(a.charAt(0)).toUpperCase() + String(a.substr(1)).toLowerCase();
+};
+goog.string.parseInt = function(a) {
+  isFinite(a) && (a = String(a));
+  return goog.isString(a) ? /^\s*-?0x/i.test(a) ? parseInt(a, 16) : parseInt(a, 10) : NaN;
+};
+goog.string.splitLimit = function(a, b, c) {
+  a = a.split(b);
+  for (var d = [];0 < c && a.length;) {
+    d.push(a.shift()), c--;
+  }
+  a.length && d.push(a.join(b));
+  return d;
+};
+goog.string.editDistance = function(a, b) {
+  var c = [], d = [];
+  if (a == b) {
+    return 0;
+  }
+  if (!a.length || !b.length) {
+    return Math.max(a.length, b.length);
+  }
+  for (var e = 0;e < b.length + 1;e++) {
+    c[e] = e;
+  }
+  for (e = 0;e < a.length;e++) {
+    d[0] = e + 1;
+    for (var f = 0;f < b.length;f++) {
+      d[f + 1] = Math.min(d[f] + 1, c[f + 1] + 1, c[f] + (a[e] != b[f]));
+    }
+    for (f = 0;f < c.length;f++) {
+      c[f] = d[f];
+    }
+  }
+  return d[b.length];
+};
+goog.asserts = {};
+goog.asserts.ENABLE_ASSERTS = goog.DEBUG;
+goog.asserts.AssertionError = function(a, b) {
+  b.unshift(a);
+  goog.debug.Error.call(this, goog.string.subs.apply(null, b));
+  b.shift();
+  this.messagePattern = a;
+};
+goog.inherits(goog.asserts.AssertionError, goog.debug.Error);
+goog.asserts.AssertionError.prototype.name = "AssertionError";
+goog.asserts.DEFAULT_ERROR_HANDLER = function(a) {
+  throw a;
+};
+goog.asserts.errorHandler_ = goog.asserts.DEFAULT_ERROR_HANDLER;
+goog.asserts.doAssertFailure_ = function(a, b, c, d) {
+  var e = "Assertion failed";
+  if (c) {
+    var e = e + (": " + c), f = d
+  } else {
+    a && (e += ": " + a, f = b);
+  }
+  a = new goog.asserts.AssertionError("" + e, f || []);
+  goog.asserts.errorHandler_(a);
+};
+goog.asserts.setErrorHandler = function(a) {
+  goog.asserts.ENABLE_ASSERTS && (goog.asserts.errorHandler_ = a);
+};
+goog.asserts.assert = function(a, b, c) {
+  goog.asserts.ENABLE_ASSERTS && !a && goog.asserts.doAssertFailure_("", null, b, Array.prototype.slice.call(arguments, 2));
+  return a;
+};
+goog.asserts.fail = function(a, b) {
+  goog.asserts.ENABLE_ASSERTS && goog.asserts.errorHandler_(new goog.asserts.AssertionError("Failure" + (a ? ": " + a : ""), Array.prototype.slice.call(arguments, 1)));
+};
+goog.asserts.assertNumber = function(a, b, c) {
+  goog.asserts.ENABLE_ASSERTS && !goog.isNumber(a) && goog.asserts.doAssertFailure_("Expected number but got %s: %s.", [goog.typeOf(a), a], b, Array.prototype.slice.call(arguments, 2));
+  return a;
+};
+goog.asserts.assertString = function(a, b, c) {
+  goog.asserts.ENABLE_ASSERTS && !goog.isString(a) && goog.asserts.doAssertFailure_("Expected string but got %s: %s.", [goog.typeOf(a), a], b, Array.prototype.slice.call(arguments, 2));
+  return a;
+};
+goog.asserts.assertFunction = function(a, b, c) {
+  goog.asserts.ENABLE_ASSERTS && !goog.isFunction(a) && goog.asserts.doAssertFailure_("Expected function but got %s: %s.", [goog.typeOf(a), a], b, Array.prototype.slice.call(arguments, 2));
+  return a;
+};
+goog.asserts.assertObject = function(a, b, c) {
+  goog.asserts.ENABLE_ASSERTS && !goog.isObject(a) && goog.asserts.doAssertFailure_("Expected object but got %s: %s.", [goog.typeOf(a), a], b, Array.prototype.slice.call(arguments, 2));
+  return a;
+};
+goog.asserts.assertArray = function(a, b, c) {
+  goog.asserts.ENABLE_ASSERTS && !goog.isArray(a) && goog.asserts.doAssertFailure_("Expected array but got %s: %s.", [goog.typeOf(a), a], b, Array.prototype.slice.call(arguments, 2));
+  return a;
+};
+goog.asserts.assertBoolean = function(a, b, c) {
+  goog.asserts.ENABLE_ASSERTS && !goog.isBoolean(a) && goog.asserts.doAssertFailure_("Expected boolean but got %s: %s.", [goog.typeOf(a), a], b, Array.prototype.slice.call(arguments, 2));
+  return a;
+};
+goog.asserts.assertElement = function(a, b, c) {
+  !goog.asserts.ENABLE_ASSERTS || goog.isObject(a) && a.nodeType == goog.dom.NodeType.ELEMENT || goog.asserts.doAssertFailure_("Expected Element but got %s: %s.", [goog.typeOf(a), a], b, Array.prototype.slice.call(arguments, 2));
+  return a;
+};
+goog.asserts.assertInstanceof = function(a, b, c, d) {
+  !goog.asserts.ENABLE_ASSERTS || a instanceof b || goog.asserts.doAssertFailure_("Expected instanceof %s but got %s.", [goog.asserts.getType_(b), goog.asserts.getType_(a)], c, Array.prototype.slice.call(arguments, 3));
+  return a;
+};
+goog.asserts.assertObjectPrototypeIsIntact = function() {
+  for (var a in Object.prototype) {
+    goog.asserts.fail(a + " should not be enumerable in Object.prototype.");
+  }
+};
+goog.asserts.getType_ = function(a) {
+  return a instanceof Function ? a.displayName || a.name || "unknown type name" : a instanceof Object ? a.constructor.displayName || a.constructor.name || Object.prototype.toString.call(a) : null === a ? "null" : typeof a;
+};
+goog.array = {};
+goog.NATIVE_ARRAY_PROTOTYPES = goog.TRUSTED_SITE;
+goog.array.ASSUME_NATIVE_FUNCTIONS = !1;
+goog.array.peek = function(a) {
+  return a[a.length - 1];
+};
+goog.array.last = goog.array.peek;
+goog.array.ARRAY_PROTOTYPE_ = Array.prototype;
+goog.array.indexOf = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.indexOf) ? function(a, b, c) {
+  goog.asserts.assert(null != a.length);
+  return goog.array.ARRAY_PROTOTYPE_.indexOf.call(a, b, c);
+} : function(a, b, c) {
+  c = null == c ? 0 : 0 > c ? Math.max(0, a.length + c) : c;
+  if (goog.isString(a)) {
+    return goog.isString(b) && 1 == b.length ? a.indexOf(b, c) : -1;
+  }
+  for (;c < a.length;c++) {
+    if (c in a && a[c] === b) {
+      return c;
+    }
+  }
+  return -1;
+};
+goog.array.lastIndexOf = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.lastIndexOf) ? function(a, b, c) {
+  goog.asserts.assert(null != a.length);
+  return goog.array.ARRAY_PROTOTYPE_.lastIndexOf.call(a, b, null == c ? a.length - 1 : c);
+} : function(a, b, c) {
+  c = null == c ? a.length - 1 : c;
+  0 > c && (c = Math.max(0, a.length + c));
+  if (goog.isString(a)) {
+    return goog.isString(b) && 1 == b.length ? a.lastIndexOf(b, c) : -1;
+  }
+  for (;0 <= c;c--) {
+    if (c in a && a[c] === b) {
+      return c;
+    }
+  }
+  return -1;
+};
+goog.array.forEach = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.forEach) ? function(a, b, c) {
+  goog.asserts.assert(null != a.length);
+  goog.array.ARRAY_PROTOTYPE_.forEach.call(a, b, c);
+} : function(a, b, c) {
+  for (var d = a.length, e = goog.isString(a) ? a.split("") : a, f = 0;f < d;f++) {
+    f in e && b.call(c, e[f], f, a);
+  }
+};
+goog.array.forEachRight = function(a, b, c) {
+  for (var d = a.length, e = goog.isString(a) ? a.split("") : a, d = d - 1;0 <= d;--d) {
+    d in e && b.call(c, e[d], d, a);
+  }
+};
+goog.array.filter = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.filter) ? function(a, b, c) {
+  goog.asserts.assert(null != a.length);
+  return goog.array.ARRAY_PROTOTYPE_.filter.call(a, b, c);
+} : function(a, b, c) {
+  for (var d = a.length, e = [], f = 0, g = goog.isString(a) ? a.split("") : a, h = 0;h < d;h++) {
+    if (h in g) {
+      var k = g[h];
+      b.call(c, k, h, a) && (e[f++] = k);
+    }
+  }
+  return e;
+};
+goog.array.map = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.map) ? function(a, b, c) {
+  goog.asserts.assert(null != a.length);
+  return goog.array.ARRAY_PROTOTYPE_.map.call(a, b, c);
+} : function(a, b, c) {
+  for (var d = a.length, e = Array(d), f = goog.isString(a) ? a.split("") : a, g = 0;g < d;g++) {
+    g in f && (e[g] = b.call(c, f[g], g, a));
+  }
+  return e;
+};
+goog.array.reduce = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.reduce) ? function(a, b, c, d) {
+  goog.asserts.assert(null != a.length);
+  d && (b = goog.bind(b, d));
+  return goog.array.ARRAY_PROTOTYPE_.reduce.call(a, b, c);
+} : function(a, b, c, d) {
+  var e = c;
+  goog.array.forEach(a, function(c, g) {
+    e = b.call(d, e, c, g, a);
+  });
+  return e;
+};
+goog.array.reduceRight = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.reduceRight) ? function(a, b, c, d) {
+  goog.asserts.assert(null != a.length);
+  d && (b = goog.bind(b, d));
+  return goog.array.ARRAY_PROTOTYPE_.reduceRight.call(a, b, c);
+} : function(a, b, c, d) {
+  var e = c;
+  goog.array.forEachRight(a, function(c, g) {
+    e = b.call(d, e, c, g, a);
+  });
+  return e;
+};
+goog.array.some = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.some) ? function(a, b, c) {
+  goog.asserts.assert(null != a.length);
+  return goog.array.ARRAY_PROTOTYPE_.some.call(a, b, c);
+} : function(a, b, c) {
+  for (var d = a.length, e = goog.isString(a) ? a.split("") : a, f = 0;f < d;f++) {
+    if (f in e && b.call(c, e[f], f, a)) {
+      return !0;
+    }
+  }
+  return !1;
+};
+goog.array.every = goog.NATIVE_ARRAY_PROTOTYPES && (goog.array.ASSUME_NATIVE_FUNCTIONS || goog.array.ARRAY_PROTOTYPE_.every) ? function(a, b, c) {
+  goog.asserts.assert(null != a.length);
+  return goog.array.ARRAY_PROTOTYPE_.every.call(a, b, c);
+} : function(a, b, c) {
+  for (var d = a.length, e = goog.isString(a) ? a.split("") : a, f = 0;f < d;f++) {
+    if (f in e && !b.call(c, e[f], f, a)) {
+      return !1;
+    }
+  }
+  return !0;
+};
+goog.array.count = function(a, b, c) {
+  var d = 0;
+  goog.array.forEach(a, function(a, f, g) {
+    b.call(c, a, f, g) && ++d;
+  }, c);
+  return d;
+};
+goog.array.find = function(a, b, c) {
+  b = goog.array.findIndex(a, b, c);
+  return 0 > b ? null : goog.isString(a) ? a.charAt(b) : a[b];
+};
+goog.array.findIndex = function(a, b, c) {
+  for (var d = a.length, e = goog.isString(a) ? a.split("") : a, f = 0;f < d;f++) {
+    if (f in e && b.call(c, e[f], f, a)) {
+      return f;
+    }
+  }
+  return -1;
+};
+goog.array.findRight = function(a, b, c) {
+  b = goog.array.findIndexRight(a, b, c);
+  return 0 > b ? null : goog.isString(a) ? a.charAt(b) : a[b];
+};
+goog.array.findIndexRight = function(a, b, c) {
+  for (var d = a.length, e = goog.isString(a) ? a.split("") : a, d = d - 1;0 <= d;d--) {
+    if (d in e && b.call(c, e[d], d, a)) {
+      return d;
+    }
+  }
+  return -1;
+};
+goog.array.contains = function(a, b) {
+  return 0 <= goog.array.indexOf(a, b);
+};
+goog.array.isEmpty = function(a) {
+  return 0 == a.length;
+};
+goog.array.clear = function(a) {
+  if (!goog.isArray(a)) {
+    for (var b = a.length - 1;0 <= b;b--) {
+      delete a[b];
+    }
+  }
+  a.length = 0;
+};
+goog.array.insert = function(a, b) {
+  goog.array.contains(a, b) || a.push(b);
+};
+goog.array.insertAt = function(a, b, c) {
+  goog.array.splice(a, c, 0, b);
+};
+goog.array.insertArrayAt = function(a, b, c) {
+  goog.partial(goog.array.splice, a, c, 0).apply(null, b);
+};
+goog.array.insertBefore = function(a, b, c) {
+  var d;
+  2 == arguments.length || 0 > (d = goog.array.indexOf(a, c)) ? a.push(b) : goog.array.insertAt(a, b, d);
+};
+goog.array.remove = function(a, b) {
+  var c = goog.array.indexOf(a, b), d;
+  (d = 0 <= c) && goog.array.removeAt(a, c);
+  return d;
+};
+goog.array.removeAt = function(a, b) {
+  goog.asserts.assert(null != a.length);
+  return 1 == goog.array.ARRAY_PROTOTYPE_.splice.call(a, b, 1).length;
+};
+goog.array.removeIf = function(a, b, c) {
+  b = goog.array.findIndex(a, b, c);
+  return 0 <= b ? (goog.array.removeAt(a, b), !0) : !1;
+};
+goog.array.removeAllIf = function(a, b, c) {
+  var d = 0;
+  goog.array.forEachRight(a, function(e, f) {
+    b.call(c, e, f, a) && goog.array.removeAt(a, f) && d++;
+  });
+  return d;
+};
+goog.array.concat = function(a) {
+  return goog.array.ARRAY_PROTOTYPE_.concat.apply(goog.array.ARRAY_PROTOTYPE_, arguments);
+};
+goog.array.join = function(a) {
+  return goog.array.ARRAY_PROTOTYPE_.concat.apply(goog.array.ARRAY_PROTOTYPE_, arguments);
+};
+goog.array.toArray = function(a) {
+  var b = a.length;
+  if (0 < b) {
+    for (var c = Array(b), d = 0;d < b;d++) {
+      c[d] = a[d];
+    }
+    return c;
+  }
+  return [];
+};
+goog.array.clone = goog.array.toArray;
+goog.array.extend = function(a, b) {
+  for (var c = 1;c < arguments.length;c++) {
+    var d = arguments[c];
+    if (goog.isArrayLike(d)) {
+      var e = a.length || 0, f = d.length || 0;
+      a.length = e + f;
+      for (var g = 0;g < f;g++) {
+        a[e + g] = d[g];
+      }
+    } else {
+      a.push(d);
+    }
+  }
+};
+goog.array.splice = function(a, b, c, d) {
+  goog.asserts.assert(null != a.length);
+  return goog.array.ARRAY_PROTOTYPE_.splice.apply(a, goog.array.slice(arguments, 1));
+};
+goog.array.slice = function(a, b, c) {
+  goog.asserts.assert(null != a.length);
+  return 2 >= arguments.length ? goog.array.ARRAY_PROTOTYPE_.slice.call(a, b) : goog.array.ARRAY_PROTOTYPE_.slice.call(a, b, c);
+};
+goog.array.removeDuplicates = function(a, b, c) {
+  b = b || a;
+  var d = function(a) {
+    return goog.isObject(a) ? "o" + goog.getUid(a) : (typeof a).charAt(0) + a;
+  };
+  c = c || d;
+  for (var d = {}, e = 0, f = 0;f < a.length;) {
+    var g = a[f++], h = c(g);
+    Object.prototype.hasOwnProperty.call(d, h) || (d[h] = !0, b[e++] = g);
+  }
+  b.length = e;
+};
+goog.array.binarySearch = function(a, b, c) {
+  return goog.array.binarySearch_(a, c || goog.array.defaultCompare, !1, b);
+};
+goog.array.binarySelect = function(a, b, c) {
+  return goog.array.binarySearch_(a, b, !0, void 0, c);
+};
+goog.array.binarySearch_ = function(a, b, c, d, e) {
+  for (var f = 0, g = a.length, h;f < g;) {
+    var k = f + g >> 1, l;
+    l = c ? b.call(e, a[k], k, a) : b(d, a[k]);
+    0 < l ? f = k + 1 : (g = k, h = !l);
+  }
+  return h ? f : ~f;
+};
+goog.array.sort = function(a, b) {
+  a.sort(b || goog.array.defaultCompare);
+};
+goog.array.stableSort = function(a, b) {
+  for (var c = 0;c < a.length;c++) {
+    a[c] = {index:c, value:a[c]};
+  }
+  var d = b || goog.array.defaultCompare;
+  goog.array.sort(a, function(a, b) {
+    return d(a.value, b.value) || a.index - b.index;
+  });
+  for (c = 0;c < a.length;c++) {
+    a[c] = a[c].value;
+  }
+};
+goog.array.sortByKey = function(a, b, c) {
+  var d = c || goog.array.defaultCompare;
+  goog.array.sort(a, function(a, c) {
+    return d(b(a), b(c));
+  });
+};
+goog.array.sortObjectsByKey = function(a, b, c) {
+  goog.array.sortByKey(a, function(a) {
+    return a[b];
+  }, c);
+};
+goog.array.isSorted = function(a, b, c) {
+  b = b || goog.array.defaultCompare;
+  for (var d = 1;d < a.length;d++) {
+    var e = b(a[d - 1], a[d]);
+    if (0 < e || 0 == e && c) {
+      return !1;
+    }
+  }
+  return !0;
+};
+goog.array.equals = function(a, b, c) {
+  if (!goog.isArrayLike(a) || !goog.isArrayLike(b) || a.length != b.length) {
+    return !1;
+  }
+  var d = a.length;
+  c = c || goog.array.defaultCompareEquality;
+  for (var e = 0;e < d;e++) {
+    if (!c(a[e], b[e])) {
+      return !1;
+    }
+  }
+  return !0;
+};
+goog.array.compare3 = function(a, b, c) {
+  c = c || goog.array.defaultCompare;
+  for (var d = Math.min(a.length, b.length), e = 0;e < d;e++) {
+    var f = c(a[e], b[e]);
+    if (0 != f) {
+      return f;
+    }
+  }
+  return goog.array.defaultCompare(a.length, b.length);
+};
+goog.array.defaultCompare = function(a, b) {
+  return a > b ? 1 : a < b ? -1 : 0;
+};
+goog.array.inverseDefaultCompare = function(a, b) {
+  return -goog.array.defaultCompare(a, b);
+};
+goog.array.defaultCompareEquality = function(a, b) {
+  return a === b;
+};
+goog.array.binaryInsert = function(a, b, c) {
+  c = goog.array.binarySearch(a, b, c);
+  return 0 > c ? (goog.array.insertAt(a, b, -(c + 1)), !0) : !1;
+};
+goog.array.binaryRemove = function(a, b, c) {
+  b = goog.array.binarySearch(a, b, c);
+  return 0 <= b ? goog.array.removeAt(a, b) : !1;
+};
+goog.array.bucket = function(a, b, c) {
+  for (var d = {}, e = 0;e < a.length;e++) {
+    var f = a[e], g = b.call(c, f, e, a);
+    goog.isDef(g) && (d[g] || (d[g] = [])).push(f);
+  }
+  return d;
+};
+goog.array.toObject = function(a, b, c) {
+  var d = {};
+  goog.array.forEach(a, function(e, f) {
+    d[b.call(c, e, f, a)] = e;
+  });
+  return d;
+};
+goog.array.range = function(a, b, c) {
+  var d = [], e = 0, f = a;
+  c = c || 1;
+  void 0 !== b && (e = a, f = b);
+  if (0 > c * (f - e)) {
+    return [];
+  }
+  if (0 < c) {
+    for (a = e;a < f;a += c) {
+      d.push(a);
+    }
+  } else {
+    for (a = e;a > f;a += c) {
+      d.push(a);
+    }
+  }
+  return d;
+};
+goog.array.repeat = function(a, b) {
+  for (var c = [], d = 0;d < b;d++) {
+    c[d] = a;
+  }
+  return c;
+};
+goog.array.flatten = function(a) {
+  for (var b = [], c = 0;c < arguments.length;c++) {
+    var d = arguments[c];
+    if (goog.isArray(d)) {
+      for (var e = 0;e < d.length;e += 8192) {
+        for (var f = goog.array.slice(d, e, e + 8192), f = goog.array.flatten.apply(null, f), g = 0;g < f.length;g++) {
+          b.push(f[g]);
+        }
+      }
+    } else {
+      b.push(d);
+    }
+  }
+  return b;
+};
+goog.array.rotate = function(a, b) {
+  goog.asserts.assert(null != a.length);
+  a.length && (b %= a.length, 0 < b ? goog.array.ARRAY_PROTOTYPE_.unshift.apply(a, a.splice(-b, b)) : 0 > b && goog.array.ARRAY_PROTOTYPE_.push.apply(a, a.splice(0, -b)));
+  return a;
+};
+goog.array.moveItem = function(a, b, c) {
+  goog.asserts.assert(0 <= b && b < a.length);
+  goog.asserts.assert(0 <= c && c < a.length);
+  b = goog.array.ARRAY_PROTOTYPE_.splice.call(a, b, 1);
+  goog.array.ARRAY_PROTOTYPE_.splice.call(a, c, 0, b[0]);
+};
+goog.array.zip = function(a) {
+  if (!arguments.length) {
+    return [];
+  }
+  for (var b = [], c = arguments[0].length, d = 1;d < arguments.length;d++) {
+    arguments[d].length < c && (c = arguments[d].length);
+  }
+  for (d = 0;d < c;d++) {
+    for (var e = [], f = 0;f < arguments.length;f++) {
+      e.push(arguments[f][d]);
+    }
+    b.push(e);
+  }
+  return b;
+};
+goog.array.shuffle = function(a, b) {
+  for (var c = b || Math.random, d = a.length - 1;0 < d;d--) {
+    var e = Math.floor(c() * (d + 1)), f = a[d];
+    a[d] = a[e];
+    a[e] = f;
+  }
+};
+goog.array.copyByIndex = function(a, b) {
+  var c = [];
+  goog.array.forEach(b, function(b) {
+    c.push(a[b]);
+  });
+  return c;
+};
+goog.object = {};
+goog.object.forEach = function(a, b, c) {
+  for (var d in a) {
+    b.call(c, a[d], d, a);
+  }
+};
+goog.object.filter = function(a, b, c) {
+  var d = {}, e;
+  for (e in a) {
+    b.call(c, a[e], e, a) && (d[e] = a[e]);
+  }
+  return d;
+};
+goog.object.map = function(a, b, c) {
+  var d = {}, e;
+  for (e in a) {
+    d[e] = b.call(c, a[e], e, a);
+  }
+  return d;
+};
+goog.object.some = function(a, b, c) {
+  for (var d in a) {
+    if (b.call(c, a[d], d, a)) {
+      return !0;
+    }
+  }
+  return !1;
+};
+goog.object.every = function(a, b, c) {
+  for (var d in a) {
+    if (!b.call(c, a[d], d, a)) {
+      return !1;
+    }
+  }
+  return !0;
+};
+goog.object.getCount = function(a) {
+  var b = 0, c;
+  for (c in a) {
+    b++;
+  }
+  return b;
+};
+goog.object.getAnyKey = function(a) {
+  for (var b in a) {
+    return b;
+  }
+};
+goog.object.getAnyValue = function(a) {
+  for (var b in a) {
+    return a[b];
+  }
+};
+goog.object.contains = function(a, b) {
+  return goog.object.containsValue(a, b);
+};
+goog.object.getValues = function(a) {
+  var b = [], c = 0, d;
+  for (d in a) {
+    b[c++] = a[d];
+  }
+  return b;
+};
+goog.object.getKeys = function(a) {
+  var b = [], c = 0, d;
+  for (d in a) {
+    b[c++] = d;
+  }
+  return b;
+};
+goog.object.getValueByKeys = function(a, b) {
+  for (var c = goog.isArrayLike(b), d = c ? b : arguments, c = c ? 0 : 1;c < d.length && (a = a[d[c]], goog.isDef(a));c++) {
+  }
+  return a;
+};
+goog.object.containsKey = function(a, b) {
+  return null !== a && b in a;
+};
+goog.object.containsValue = function(a, b) {
+  for (var c in a) {
+    if (a[c] == b) {
+      return !0;
+    }
+  }
+  return !1;
+};
+goog.object.findKey = function(a, b, c) {
+  for (var d in a) {
+    if (b.call(c, a[d], d, a)) {
+      return d;
+    }
+  }
+};
+goog.object.findValue = function(a, b, c) {
+  return (b = goog.object.findKey(a, b, c)) && a[b];
+};
+goog.object.isEmpty = function(a) {
+  for (var b in a) {
+    return !1;
+  }
+  return !0;
+};
+goog.object.clear = function(a) {
+  for (var b in a) {
+    delete a[b];
+  }
+};
+goog.object.remove = function(a, b) {
+  var c;
+  (c = b in a) && delete a[b];
+  return c;
+};
+goog.object.add = function(a, b, c) {
+  if (null !== a && b in a) {
+    throw Error('The object already contains the key "' + b + '"');
+  }
+  goog.object.set(a, b, c);
+};
+goog.object.get = function(a, b, c) {
+  return null !== a && b in a ? a[b] : c;
+};
+goog.object.set = function(a, b, c) {
+  a[b] = c;
+};
+goog.object.setIfUndefined = function(a, b, c) {
+  return b in a ? a[b] : a[b] = c;
+};
+goog.object.setWithReturnValueIfNotSet = function(a, b, c) {
+  if (b in a) {
+    return a[b];
+  }
+  c = c();
+  return a[b] = c;
+};
+goog.object.equals = function(a, b) {
+  for (var c in a) {
+    if (!(c in b) || a[c] !== b[c]) {
+      return !1;
+    }
+  }
+  for (c in b) {
+    if (!(c in a)) {
+      return !1;
+    }
+  }
+  return !0;
+};
+goog.object.clone = function(a) {
+  var b = {}, c;
+  for (c in a) {
+    b[c] = a[c];
+  }
+  return b;
+};
+goog.object.unsafeClone = function(a) {
+  var b = goog.typeOf(a);
+  if ("object" == b || "array" == b) {
+    if (goog.isFunction(a.clone)) {
+      return a.clone();
+    }
+    var b = "array" == b ? [] : {}, c;
+    for (c in a) {
+      b[c] = goog.object.unsafeClone(a[c]);
+    }
+    return b;
+  }
+  return a;
+};
+goog.object.transpose = function(a) {
+  var b = {}, c;
+  for (c in a) {
+    b[a[c]] = c;
+  }
+  return b;
+};
+goog.object.PROTOTYPE_FIELDS_ = "constructor hasOwnProperty isPrototypeOf propertyIsEnumerable toLocaleString toString valueOf".split(" ");
+goog.object.extend = function(a, b) {
+  for (var c, d, e = 1;e < arguments.length;e++) {
+    d = arguments[e];
+    for (c in d) {
+      a[c] = d[c];
+    }
+    for (var f = 0;f < goog.object.PROTOTYPE_FIELDS_.length;f++) {
+      c = goog.object.PROTOTYPE_FIELDS_[f], Object.prototype.hasOwnProperty.call(d, c) && (a[c] = d[c]);
+    }
+  }
+};
+goog.object.create = function(a) {
+  var b = arguments.length;
+  if (1 == b && goog.isArray(arguments[0])) {
+    return goog.object.create.apply(null, arguments[0]);
+  }
+  if (b % 2) {
+    throw Error("Uneven number of arguments");
+  }
+  for (var c = {}, d = 0;d < b;d += 2) {
+    c[arguments[d]] = arguments[d + 1];
+  }
+  return c;
+};
+goog.object.createSet = function(a) {
+  var b = arguments.length;
+  if (1 == b && goog.isArray(arguments[0])) {
+    return goog.object.createSet.apply(null, arguments[0]);
+  }
+  for (var c = {}, d = 0;d < b;d++) {
+    c[arguments[d]] = !0;
+  }
+  return c;
+};
+goog.object.createImmutableView = function(a) {
+  var b = a;
+  Object.isFrozen && !Object.isFrozen(a) && (b = Object.create(a), Object.freeze(b));
+  return b;
+};
+goog.object.isImmutableView = function(a) {
+  return !!Object.isFrozen && Object.isFrozen(a);
+};
+goog.structs = {};
+goog.structs.getCount = function(a) {
+  return a.getCount && "function" == typeof a.getCount ? a.getCount() : goog.isArrayLike(a) || goog.isString(a) ? a.length : goog.object.getCount(a);
+};
+goog.structs.getValues = function(a) {
+  if (a.getValues && "function" == typeof a.getValues) {
+    return a.getValues();
+  }
+  if (goog.isString(a)) {
+    return a.split("");
+  }
+  if (goog.isArrayLike(a)) {
+    for (var b = [], c = a.length, d = 0;d < c;d++) {
+      b.push(a[d]);
+    }
+    return b;
+  }
+  return goog.object.getValues(a);
+};
+goog.structs.getKeys = function(a) {
+  if (a.getKeys && "function" == typeof a.getKeys) {
+    return a.getKeys();
+  }
+  if (!a.getValues || "function" != typeof a.getValues) {
+    if (goog.isArrayLike(a) || goog.isString(a)) {
+      var b = [];
+      a = a.length;
+      for (var c = 0;c < a;c++) {
+        b.push(c);
+      }
+      return b;
+    }
+    return goog.object.getKeys(a);
+  }
+};
+goog.structs.contains = function(a, b) {
+  return a.contains && "function" == typeof a.contains ? a.contains(b) : a.containsValue && "function" == typeof a.containsValue ? a.containsValue(b) : goog.isArrayLike(a) || goog.isString(a) ? goog.array.contains(a, b) : goog.object.containsValue(a, b);
+};
+goog.structs.isEmpty = function(a) {
+  return a.isEmpty && "function" == typeof a.isEmpty ? a.isEmpty() : goog.isArrayLike(a) || goog.isString(a) ? goog.array.isEmpty(a) : goog.object.isEmpty(a);
+};
+goog.structs.clear = function(a) {
+  a.clear && "function" == typeof a.clear ? a.clear() : goog.isArrayLike(a) ? goog.array.clear(a) : goog.object.clear(a);
+};
+goog.structs.forEach = function(a, b, c) {
+  if (a.forEach && "function" == typeof a.forEach) {
+    a.forEach(b, c);
+  } else {
+    if (goog.isArrayLike(a) || goog.isString(a)) {
+      goog.array.forEach(a, b, c);
+    } else {
+      for (var d = goog.structs.getKeys(a), e = goog.structs.getValues(a), f = e.length, g = 0;g < f;g++) {
+        b.call(c, e[g], d && d[g], a);
+      }
+    }
+  }
+};
+goog.structs.filter = function(a, b, c) {
+  if ("function" == typeof a.filter) {
+    return a.filter(b, c);
+  }
+  if (goog.isArrayLike(a) || goog.isString(a)) {
+    return goog.array.filter(a, b, c);
+  }
+  var d, e = goog.structs.getKeys(a), f = goog.structs.getValues(a), g = f.length;
+  if (e) {
+    d = {};
+    for (var h = 0;h < g;h++) {
+      b.call(c, f[h], e[h], a) && (d[e[h]] = f[h]);
+    }
+  } else {
+    for (d = [], h = 0;h < g;h++) {
+      b.call(c, f[h], void 0, a) && d.push(f[h]);
+    }
+  }
+  return d;
+};
+goog.structs.map = function(a, b, c) {
+  if ("function" == typeof a.map) {
+    return a.map(b, c);
+  }
+  if (goog.isArrayLike(a) || goog.isString(a)) {
+    return goog.array.map(a, b, c);
+  }
+  var d, e = goog.structs.getKeys(a), f = goog.structs.getValues(a), g = f.length;
+  if (e) {
+    d = {};
+    for (var h = 0;h < g;h++) {
+      d[e[h]] = b.call(c, f[h], e[h], a);
+    }
+  } else {
+    for (d = [], h = 0;h < g;h++) {
+      d[h] = b.call(c, f[h], void 0, a);
+    }
+  }
+  return d;
+};
+goog.structs.some = function(a, b, c) {
+  if ("function" == typeof a.some) {
+    return a.some(b, c);
+  }
+  if (goog.isArrayLike(a) || goog.isString(a)) {
+    return goog.array.some(a, b, c);
+  }
+  for (var d = goog.structs.getKeys(a), e = goog.structs.getValues(a), f = e.length, g = 0;g < f;g++) {
+    if (b.call(c, e[g], d && d[g], a)) {
+      return !0;
+    }
+  }
+  return !1;
+};
+goog.structs.every = function(a, b, c) {
+  if ("function" == typeof a.every) {
+    return a.every(b, c);
+  }
+  if (goog.isArrayLike(a) || goog.isString(a)) {
+    return goog.array.every(a, b, c);
+  }
+  for (var d = goog.structs.getKeys(a), e = goog.structs.getValues(a), f = e.length, g = 0;g < f;g++) {
+    if (!b.call(c, e[g], d && d[g], a)) {
+      return !1;
+    }
+  }
+  return !0;
+};
+goog.functions = {};
+goog.functions.constant = function(a) {
+  return function() {
+    return a;
+  };
+};
+goog.functions.FALSE = goog.functions.constant(!1);
+goog.functions.TRUE = goog.functions.constant(!0);
+goog.functions.NULL = goog.functions.constant(null);
+goog.functions.identity = function(a, b) {
+  return a;
+};
+goog.functions.error = function(a) {
+  return function() {
+    throw Error(a);
+  };
+};
+goog.functions.fail = function(a) {
+  return function() {
+    throw a;
+  };
+};
+goog.functions.lock = function(a, b) {
+  b = b || 0;
+  return function() {
+    return a.apply(this, Array.prototype.slice.call(arguments, 0, b));
+  };
+};
+goog.functions.nth = function(a) {
+  return function() {
+    return arguments[a];
+  };
+};
+goog.functions.withReturnValue = function(a, b) {
+  return goog.functions.sequence(a, goog.functions.constant(b));
+};
+goog.functions.equalTo = function(a, b) {
+  return function(c) {
+    return b ? a == c : a === c;
+  };
+};
+goog.functions.compose = function(a, b) {
+  var c = arguments, d = c.length;
+  return function() {
+    var a;
+    d && (a = c[d - 1].apply(this, arguments));
+    for (var b = d - 2;0 <= b;b--) {
+      a = c[b].call(this, a);
+    }
+    return a;
+  };
+};
+goog.functions.sequence = function(a) {
+  var b = arguments, c = b.length;
+  return function() {
+    for (var a, e = 0;e < c;e++) {
+      a = b[e].apply(this, arguments);
+    }
+    return a;
+  };
+};
+goog.functions.and = function(a) {
+  var b = arguments, c = b.length;
+  return function() {
+    for (var a = 0;a < c;a++) {
+      if (!b[a].apply(this, arguments)) {
+        return !1;
+      }
+    }
+    return !0;
+  };
+};
+goog.functions.or = function(a) {
+  var b = arguments, c = b.length;
+  return function() {
+    for (var a = 0;a < c;a++) {
+      if (b[a].apply(this, arguments)) {
+        return !0;
+      }
+    }
+    return !1;
+  };
+};
+goog.functions.not = function(a) {
+  return function() {
+    return !a.apply(this, arguments);
+  };
+};
+goog.functions.create = function(a, b) {
+  var c = function() {
+  };
+  c.prototype = a.prototype;
+  c = new c;
+  a.apply(c, Array.prototype.slice.call(arguments, 1));
+  return c;
+};
+goog.functions.CACHE_RETURN_VALUE = !0;
+goog.functions.cacheReturnValue = function(a) {
+  var b = !1, c;
+  return function() {
+    if (!goog.functions.CACHE_RETURN_VALUE) {
+      return a();
+    }
+    b || (c = a(), b = !0);
+    return c;
+  };
+};
+goog.functions.once = function(a) {
+  var b = a;
+  return function() {
+    if (b) {
+      var a = b;
+      b = null;
+      a();
+    }
+  };
+};
+goog.functions.debounce = function(a, b, c) {
+  c && (a = goog.bind(a, c));
+  var d = null;
+  return function(c) {
+    goog.global.clearTimeout(d);
+    var f = arguments;
+    d = goog.global.setTimeout(function() {
+      a.apply(null, f);
+    }, b);
+  };
+};
+goog.functions.throttle = function(a, b, c) {
+  c && (a = goog.bind(a, c));
+  var d = null, e = !1, f = [], g = function() {
+    d = null;
+    e && (e = !1, h());
+  }, h = function() {
+    d = goog.global.setTimeout(g, b);
+    a.apply(null, f);
+  };
+  return function(a) {
+    f = arguments;
+    d ? e = !0 : h();
+  };
+};
+goog.math = {};
+goog.math.randomInt = function(a) {
+  return Math.floor(Math.random() * a);
+};
+goog.math.uniformRandom = function(a, b) {
+  return a + Math.random() * (b - a);
+};
+goog.math.clamp = function(a, b, c) {
+  return Math.min(Math.max(a, b), c);
+};
+goog.math.modulo = function(a, b) {
+  var c = a % b;
+  return 0 > c * b ? c + b : c;
+};
+goog.math.lerp = function(a, b, c) {
+  return a + c * (b - a);
+};
+goog.math.nearlyEquals = function(a, b, c) {
+  return Math.abs(a - b) <= (c || 1E-6);
+};
+goog.math.standardAngle = function(a) {
+  return goog.math.modulo(a, 360);
+};
+goog.math.standardAngleInRadians = function(a) {
+  return goog.math.modulo(a, 2 * Math.PI);
+};
+goog.math.toRadians = function(a) {
+  return a * Math.PI / 180;
+};
+goog.math.toDegrees = function(a) {
+  return 180 * a / Math.PI;
+};
+goog.math.angleDx = function(a, b) {
+  return b * Math.cos(goog.math.toRadians(a));
+};
+goog.math.angleDy = function(a, b) {
+  return b * Math.sin(goog.math.toRadians(a));
+};
+goog.math.angle = function(a, b, c, d) {
+  return goog.math.standardAngle(goog.math.toDegrees(Math.atan2(d - b, c - a)));
+};
+goog.math.angleDifference = function(a, b) {
+  var c = goog.math.standardAngle(b) - goog.math.standardAngle(a);
+  180 < c ? c -= 360 : -180 >= c && (c = 360 + c);
+  return c;
+};
+goog.math.sign = Math.sign || function(a) {
+  return 0 < a ? 1 : 0 > a ? -1 : a;
+};
+goog.math.longestCommonSubsequence = function(a, b, c, d) {
+  c = c || function(a, b) {
+    return a == b;
+  };
+  d = d || function(b, c) {
+    return a[b];
+  };
+  for (var e = a.length, f = b.length, g = [], h = 0;h < e + 1;h++) {
+    g[h] = [], g[h][0] = 0;
+  }
+  for (var k = 0;k < f + 1;k++) {
+    g[0][k] = 0;
+  }
+  for (h = 1;h <= e;h++) {
+    for (k = 1;k <= f;k++) {
+      c(a[h - 1], b[k - 1]) ? g[h][k] = g[h - 1][k - 1] + 1 : g[h][k] = Math.max(g[h - 1][k], g[h][k - 1]);
+    }
+  }
+  for (var l = [], h = e, k = f;0 < h && 0 < k;) {
+    c(a[h - 1], b[k - 1]) ? (l.unshift(d(h - 1, k - 1)), h--, k--) : g[h - 1][k] > g[h][k - 1] ? h-- : k--;
+  }
+  return l;
+};
+goog.math.sum = function(a) {
+  return goog.array.reduce(arguments, function(a, c) {
+    return a + c;
+  }, 0);
+};
+goog.math.average = function(a) {
+  return goog.math.sum.apply(null, arguments) / arguments.length;
+};
+goog.math.sampleVariance = function(a) {
+  var b = arguments.length;
+  if (2 > b) {
+    return 0;
+  }
+  var c = goog.math.average.apply(null, arguments);
+  return goog.math.sum.apply(null, goog.array.map(arguments, function(a) {
+    return Math.pow(a - c, 2);
+  })) / (b - 1);
+};
+goog.math.standardDeviation = function(a) {
+  return Math.sqrt(goog.math.sampleVariance.apply(null, arguments));
+};
+goog.math.isInt = function(a) {
+  return isFinite(a) && 0 == a % 1;
+};
+goog.math.isFiniteNumber = function(a) {
+  return isFinite(a) && !isNaN(a);
+};
+goog.math.isNegativeZero = function(a) {
+  return 0 == a && 0 > 1 / a;
+};
+goog.math.log10Floor = function(a) {
+  if (0 < a) {
+    var b = Math.round(Math.log(a) * Math.LOG10E);
+    return b - (parseFloat("1e" + b) > a ? 1 : 0);
+  }
+  return 0 == a ? -Infinity : NaN;
+};
+goog.math.safeFloor = function(a, b) {
+  goog.asserts.assert(!goog.isDef(b) || 0 < b);
+  return Math.floor(a + (b || 2E-15));
+};
+goog.math.safeCeil = function(a, b) {
+  goog.asserts.assert(!goog.isDef(b) || 0 < b);
+  return Math.ceil(a - (b || 2E-15));
+};
+goog.iter = {};
+goog.iter.StopIteration = "StopIteration" in goog.global ? goog.global.StopIteration : {message:"StopIteration", stack:""};
+goog.iter.Iterator = function() {
+};
+goog.iter.Iterator.prototype.next = function() {
+  throw goog.iter.StopIteration;
+};
+goog.iter.Iterator.prototype.__iterator__ = function(a) {
+  return this;
+};
+goog.iter.toIterator = function(a) {
+  if (a instanceof goog.iter.Iterator) {
+    return a;
+  }
+  if ("function" == typeof a.__iterator__) {
+    return a.__iterator__(!1);
+  }
+  if (goog.isArrayLike(a)) {
+    var b = 0, c = new goog.iter.Iterator;
+    c.next = function() {
+      for (;;) {
+        if (b >= a.length) {
+          throw goog.iter.StopIteration;
+        }
+        if (b in a) {
+          return a[b++];
+        }
+        b++;
+      }
+    };
+    return c;
+  }
+  throw Error("Not implemented");
+};
+goog.iter.forEach = function(a, b, c) {
+  if (goog.isArrayLike(a)) {
+    try {
+      goog.array.forEach(a, b, c);
+    } catch (d) {
+      if (d !== goog.iter.StopIteration) {
+        throw d;
+      }
+    }
+  } else {
+    a = goog.iter.toIterator(a);
+    try {
+      for (;;) {
+        b.call(c, a.next(), void 0, a);
+      }
+    } catch (d) {
+      if (d !== goog.iter.StopIteration) {
+        throw d;
+      }
+    }
+  }
+};
+goog.iter.filter = function(a, b, c) {
+  var d = goog.iter.toIterator(a);
+  a = new goog.iter.Iterator;
+  a.next = function() {
+    for (;;) {
+      var a = d.next();
+      if (b.call(c, a, void 0, d)) {
+        return a;
+      }
+    }
+  };
+  return a;
+};
+goog.iter.filterFalse = function(a, b, c) {
+  return goog.iter.filter(a, goog.functions.not(b), c);
+};
+goog.iter.range = function(a, b, c) {
+  var d = 0, e = a, f = c || 1;
+  1 < arguments.length && (d = a, e = b);
+  if (0 == f) {
+    throw Error("Range step argument must not be zero");
+  }
+  var g = new goog.iter.Iterator;
+  g.next = function() {
+    if (0 < f && d >= e || 0 > f && d <= e) {
+      throw goog.iter.StopIteration;
+    }
+    var a = d;
+    d += f;
+    return a;
+  };
+  return g;
+};
+goog.iter.join = function(a, b) {
+  return goog.iter.toArray(a).join(b);
+};
+goog.iter.map = function(a, b, c) {
+  var d = goog.iter.toIterator(a);
+  a = new goog.iter.Iterator;
+  a.next = function() {
+    var a = d.next();
+    return b.call(c, a, void 0, d);
+  };
+  return a;
+};
+goog.iter.reduce = function(a, b, c, d) {
+  var e = c;
+  goog.iter.forEach(a, function(a) {
+    e = b.call(d, e, a);
+  });
+  return e;
+};
+goog.iter.some = function(a, b, c) {
+  a = goog.iter.toIterator(a);
+  try {
+    for (;;) {
+      if (b.call(c, a.next(), void 0, a)) {
+        return !0;
+      }
+    }
+  } catch (d) {
+    if (d !== goog.iter.StopIteration) {
+      throw d;
+    }
+  }
+  return !1;
+};
+goog.iter.every = function(a, b, c) {
+  a = goog.iter.toIterator(a);
+  try {
+    for (;;) {
+      if (!b.call(c, a.next(), void 0, a)) {
+        return !1;
+      }
+    }
+  } catch (d) {
+    if (d !== goog.iter.StopIteration) {
+      throw d;
+    }
+  }
+  return !0;
+};
+goog.iter.chain = function(a) {
+  return goog.iter.chainFromIterable(arguments);
+};
+goog.iter.chainFromIterable = function(a) {
+  var b = goog.iter.toIterator(a);
+  a = new goog.iter.Iterator;
+  var c = null;
+  a.next = function() {
+    for (;;) {
+      if (null == c) {
+        var a = b.next();
+        c = goog.iter.toIterator(a);
+      }
+      try {
+        return c.next();
+      } catch (e) {
+        if (e !== goog.iter.StopIteration) {
+          throw e;
+        }
+        c = null;
+      }
+    }
+  };
+  return a;
+};
+goog.iter.dropWhile = function(a, b, c) {
+  var d = goog.iter.toIterator(a);
+  a = new goog.iter.Iterator;
+  var e = !0;
+  a.next = function() {
+    for (;;) {
+      var a = d.next();
+      if (!e || !b.call(c, a, void 0, d)) {
+        return e = !1, a;
+      }
+    }
+  };
+  return a;
+};
+goog.iter.takeWhile = function(a, b, c) {
+  var d = goog.iter.toIterator(a);
+  a = new goog.iter.Iterator;
+  a.next = function() {
+    var a = d.next();
+    if (b.call(c, a, void 0, d)) {
+      return a;
+    }
+    throw goog.iter.StopIteration;
+  };
+  return a;
+};
+goog.iter.toArray = function(a) {
+  if (goog.isArrayLike(a)) {
+    return goog.array.toArray(a);
+  }
+  a = goog.iter.toIterator(a);
+  var b = [];
+  goog.iter.forEach(a, function(a) {
+    b.push(a);
+  });
+  return b;
+};
+goog.iter.equals = function(a, b, c) {
+  a = goog.iter.zipLongest({}, a, b);
+  var d = c || goog.array.defaultCompareEquality;
+  return goog.iter.every(a, function(a) {
+    return d(a[0], a[1]);
+  });
+};
+goog.iter.nextOrValue = function(a, b) {
+  try {
+    return goog.iter.toIterator(a).next();
+  } catch (c) {
+    if (c != goog.iter.StopIteration) {
+      throw c;
+    }
+    return b;
+  }
+};
+goog.iter.product = function(a) {
+  if (goog.array.some(arguments, function(a) {
+    return !a.length;
+  }) || !arguments.length) {
+    return new goog.iter.Iterator;
+  }
+  var b = new goog.iter.Iterator, c = arguments, d = goog.array.repeat(0, c.length);
+  b.next = function() {
+    if (d) {
+      for (var a = goog.array.map(d, function(a, b) {
+        return c[b][a];
+      }), b = d.length - 1;0 <= b;b--) {
+        goog.asserts.assert(d);
+        if (d[b] < c[b].length - 1) {
+          d[b]++;
+          break;
+        }
+        if (0 == b) {
+          d = null;
+          break;
+        }
+        d[b] = 0;
+      }
+      return a;
+    }
+    throw goog.iter.StopIteration;
+  };
+  return b;
+};
+goog.iter.cycle = function(a) {
+  var b = goog.iter.toIterator(a), c = [], d = 0;
+  a = new goog.iter.Iterator;
+  var e = !1;
+  a.next = function() {
+    var a = null;
+    if (!e) {
+      try {
+        return a = b.next(), c.push(a), a;
+      } catch (g) {
+        if (g != goog.iter.StopIteration || goog.array.isEmpty(c)) {
+          throw g;
+        }
+        e = !0;
+      }
+    }
+    a = c[d];
+    d = (d + 1) % c.length;
+    return a;
+  };
+  return a;
+};
+goog.iter.count = function(a, b) {
+  var c = a || 0, d = goog.isDef(b) ? b : 1, e = new goog.iter.Iterator;
+  e.next = function() {
+    var a = c;
+    c += d;
+    return a;
+  };
+  return e;
+};
+goog.iter.repeat = function(a) {
+  var b = new goog.iter.Iterator;
+  b.next = goog.functions.constant(a);
+  return b;
+};
+goog.iter.accumulate = function(a) {
+  var b = goog.iter.toIterator(a), c = 0;
+  a = new goog.iter.Iterator;
+  a.next = function() {
+    return c += b.next();
+  };
+  return a;
+};
+goog.iter.zip = function(a) {
+  var b = arguments, c = new goog.iter.Iterator;
+  if (0 < b.length) {
+    var d = goog.array.map(b, goog.iter.toIterator);
+    c.next = function() {
+      return goog.array.map(d, function(a) {
+        return a.next();
+      });
+    };
+  }
+  return c;
+};
+goog.iter.zipLongest = function(a, b) {
+  var c = goog.array.slice(arguments, 1), d = new goog.iter.Iterator;
+  if (0 < c.length) {
+    var e = goog.array.map(c, goog.iter.toIterator);
+    d.next = function() {
+      var b = !1, c = goog.array.map(e, function(c) {
+        var d;
+        try {
+          d = c.next(), b = !0;
+        } catch (e) {
+          if (e !== goog.iter.StopIteration) {
+            throw e;
+          }
+          d = a;
+        }
+        return d;
+      });
+      if (!b) {
+        throw goog.iter.StopIteration;
+      }
+      return c;
+    };
+  }
+  return d;
+};
+goog.iter.compress = function(a, b) {
+  var c = goog.iter.toIterator(b);
+  return goog.iter.filter(a, function() {
+    return !!c.next();
+  });
+};
+goog.iter.GroupByIterator_ = function(a, b) {
+  this.iterator = goog.iter.toIterator(a);
+  this.keyFunc = b || goog.functions.identity;
+};
+goog.inherits(goog.iter.GroupByIterator_, goog.iter.Iterator);
+goog.iter.GroupByIterator_.prototype.next = function() {
+  for (;this.currentKey == this.targetKey;) {
+    this.currentValue = this.iterator.next(), this.currentKey = this.keyFunc(this.currentValue);
+  }
+  this.targetKey = this.currentKey;
+  return [this.currentKey, this.groupItems_(this.targetKey)];
+};
+goog.iter.GroupByIterator_.prototype.groupItems_ = function(a) {
+  for (var b = [];this.currentKey == a;) {
+    b.push(this.currentValue);
+    try {
+      this.currentValue = this.iterator.next();
+    } catch (c) {
+      if (c !== goog.iter.StopIteration) {
+        throw c;
+      }
+      break;
+    }
+    this.currentKey = this.keyFunc(this.currentValue);
+  }
+  return b;
+};
+goog.iter.groupBy = function(a, b) {
+  return new goog.iter.GroupByIterator_(a, b);
+};
+goog.iter.starMap = function(a, b, c) {
+  var d = goog.iter.toIterator(a);
+  a = new goog.iter.Iterator;
+  a.next = function() {
+    var a = goog.iter.toArray(d.next());
+    return b.apply(c, goog.array.concat(a, void 0, d));
+  };
+  return a;
+};
+goog.iter.tee = function(a, b) {
+  var c = goog.iter.toIterator(a), d = goog.isNumber(b) ? b : 2, e = goog.array.map(goog.array.range(d), function() {
+    return [];
+  }), f = function() {
+    var a = c.next();
+    goog.array.forEach(e, function(b) {
+      b.push(a);
+    });
+  };
+  return goog.array.map(e, function(a) {
+    var b = new goog.iter.Iterator;
+    b.next = function() {
+      goog.array.isEmpty(a) && f();
+      goog.asserts.assert(!goog.array.isEmpty(a));
+      return a.shift();
+    };
+    return b;
+  });
+};
+goog.iter.enumerate = function(a, b) {
+  return goog.iter.zip(goog.iter.count(b), a);
+};
+goog.iter.limit = function(a, b) {
+  goog.asserts.assert(goog.math.isInt(b) && 0 <= b);
+  var c = goog.iter.toIterator(a), d = new goog.iter.Iterator, e = b;
+  d.next = function() {
+    if (0 < e--) {
+      return c.next();
+    }
+    throw goog.iter.StopIteration;
+  };
+  return d;
+};
+goog.iter.consume = function(a, b) {
+  goog.asserts.assert(goog.math.isInt(b) && 0 <= b);
+  for (var c = goog.iter.toIterator(a);0 < b--;) {
+    goog.iter.nextOrValue(c, null);
+  }
+  return c;
+};
+goog.iter.slice = function(a, b, c) {
+  goog.asserts.assert(goog.math.isInt(b) && 0 <= b);
+  a = goog.iter.consume(a, b);
+  goog.isNumber(c) && (goog.asserts.assert(goog.math.isInt(c) && c >= b), a = goog.iter.limit(a, c - b));
+  return a;
+};
+goog.iter.hasDuplicates_ = function(a) {
+  var b = [];
+  goog.array.removeDuplicates(a, b);
+  return a.length != b.length;
+};
+goog.iter.permutations = function(a, b) {
+  var c = goog.iter.toArray(a), d = goog.isNumber(b) ? b : c.length, c = goog.array.repeat(c, d), c = goog.iter.product.apply(void 0, c);
+  return goog.iter.filter(c, function(a) {
+    return !goog.iter.hasDuplicates_(a);
+  });
+};
+goog.iter.combinations = function(a, b) {
+  function c(a) {
+    return d[a];
+  }
+  var d = goog.iter.toArray(a), e = goog.iter.range(d.length), e = goog.iter.permutations(e, b), f = goog.iter.filter(e, function(a) {
+    return goog.array.isSorted(a);
+  }), e = new goog.iter.Iterator;
+  e.next = function() {
+    return goog.array.map(f.next(), c);
+  };
+  return e;
+};
+goog.iter.combinationsWithReplacement = function(a, b) {
+  function c(a) {
+    return d[a];
+  }
+  var d = goog.iter.toArray(a), e = goog.array.range(d.length), e = goog.array.repeat(e, b), e = goog.iter.product.apply(void 0, e), f = goog.iter.filter(e, function(a) {
+    return goog.array.isSorted(a);
+  }), e = new goog.iter.Iterator;
+  e.next = function() {
+    return goog.array.map(f.next(), c);
+  };
+  return e;
+};
+goog.structs.Map = function(a, b) {
+  this.map_ = {};
+  this.keys_ = [];
+  this.version_ = this.count_ = 0;
+  var c = arguments.length;
+  if (1 < c) {
+    if (c % 2) {
+      throw Error("Uneven number of arguments");
+    }
+    for (var d = 0;d < c;d += 2) {
+      this.set(arguments[d], arguments[d + 1]);
+    }
+  } else {
+    a && this.addAll(a);
+  }
+};
+goog.structs.Map.prototype.getCount = function() {
+  return this.count_;
+};
+goog.structs.Map.prototype.getValues = function() {
+  this.cleanupKeysArray_();
+  for (var a = [], b = 0;b < this.keys_.length;b++) {
+    a.push(this.map_[this.keys_[b]]);
+  }
+  return a;
+};
+goog.structs.Map.prototype.getKeys = function() {
+  this.cleanupKeysArray_();
+  return this.keys_.concat();
+};
+goog.structs.Map.prototype.containsKey = function(a) {
+  return goog.structs.Map.hasKey_(this.map_, a);
+};
+goog.structs.Map.prototype.containsValue = function(a) {
+  for (var b = 0;b < this.keys_.length;b++) {
+    var c = this.keys_[b];
+    if (goog.structs.Map.hasKey_(this.map_, c) && this.map_[c] == a) {
+      return !0;
+    }
+  }
+  return !1;
+};
+goog.structs.Map.prototype.equals = function(a, b) {
+  if (this === a) {
+    return !0;
+  }
+  if (this.count_ != a.getCount()) {
+    return !1;
+  }
+  var c = b || goog.structs.Map.defaultEquals;
+  this.cleanupKeysArray_();
+  for (var d, e = 0;d = this.keys_[e];e++) {
+    if (!c(this.get(d), a.get(d))) {
+      return !1;
+    }
+  }
+  return !0;
+};
+goog.structs.Map.defaultEquals = function(a, b) {
+  return a === b;
+};
+goog.structs.Map.prototype.isEmpty = function() {
+  return 0 == this.count_;
+};
+goog.structs.Map.prototype.clear = function() {
+  this.map_ = {};
+  this.version_ = this.count_ = this.keys_.length = 0;
+};
+goog.structs.Map.prototype.remove = function(a) {
+  return goog.structs.Map.hasKey_(this.map_, a) ? (delete this.map_[a], this.count_--, this.version_++, this.keys_.length > 2 * this.count_ && this.cleanupKeysArray_(), !0) : !1;
+};
+goog.structs.Map.prototype.cleanupKeysArray_ = function() {
+  if (this.count_ != this.keys_.length) {
+    for (var a = 0, b = 0;a < this.keys_.length;) {
+      var c = this.keys_[a];
+      goog.structs.Map.hasKey_(this.map_, c) && (this.keys_[b++] = c);
+      a++;
+    }
+    this.keys_.length = b;
+  }
+  if (this.count_ != this.keys_.length) {
+    for (var d = {}, b = a = 0;a < this.keys_.length;) {
+      c = this.keys_[a], goog.structs.Map.hasKey_(d, c) || (this.keys_[b++] = c, d[c] = 1), a++;
+    }
+    this.keys_.length = b;
+  }
+};
+goog.structs.Map.prototype.get = function(a, b) {
+  return goog.structs.Map.hasKey_(this.map_, a) ? this.map_[a] : b;
+};
+goog.structs.Map.prototype.set = function(a, b) {
+  goog.structs.Map.hasKey_(this.map_, a) || (this.count_++, this.keys_.push(a), this.version_++);
+  this.map_[a] = b;
+};
+goog.structs.Map.prototype.addAll = function(a) {
+  var b;
+  a instanceof goog.structs.Map ? (b = a.getKeys(), a = a.getValues()) : (b = goog.object.getKeys(a), a = goog.object.getValues(a));
+  for (var c = 0;c < b.length;c++) {
+    this.set(b[c], a[c]);
+  }
+};
+goog.structs.Map.prototype.forEach = function(a, b) {
+  for (var c = this.getKeys(), d = 0;d < c.length;d++) {
+    var e = c[d], f = this.get(e);
+    a.call(b, f, e, this);
+  }
+};
+goog.structs.Map.prototype.clone = function() {
+  return new goog.structs.Map(this);
+};
+goog.structs.Map.prototype.transpose = function() {
+  for (var a = new goog.structs.Map, b = 0;b < this.keys_.length;b++) {
+    var c = this.keys_[b];
+    a.set(this.map_[c], c);
+  }
+  return a;
+};
+goog.structs.Map.prototype.toObject = function() {
+  this.cleanupKeysArray_();
+  for (var a = {}, b = 0;b < this.keys_.length;b++) {
+    var c = this.keys_[b];
+    a[c] = this.map_[c];
+  }
+  return a;
+};
+goog.structs.Map.prototype.getKeyIterator = function() {
+  return this.__iterator__(!0);
+};
+goog.structs.Map.prototype.getValueIterator = function() {
+  return this.__iterator__(!1);
+};
+goog.structs.Map.prototype.__iterator__ = function(a) {
+  this.cleanupKeysArray_();
+  var b = 0, c = this.version_, d = this, e = new goog.iter.Iterator;
+  e.next = function() {
+    if (c != d.version_) {
+      throw Error("The map has changed since the iterator was created");
+    }
+    if (b >= d.keys_.length) {
+      throw goog.iter.StopIteration;
+    }
+    var e = d.keys_[b++];
+    return a ? e : d.map_[e];
+  };
+  return e;
+};
+goog.structs.Map.hasKey_ = function(a, b) {
+  return Object.prototype.hasOwnProperty.call(a, b);
+};
+goog.uri = {};
+goog.uri.utils = {};
+goog.uri.utils.CharCode_ = {AMPERSAND:38, EQUAL:61, HASH:35, QUESTION:63};
+goog.uri.utils.buildFromEncodedParts = function(a, b, c, d, e, f, g) {
+  var h = "";
+  a && (h += a + ":");
+  c && (h += "//", b && (h += b + "@"), h += c, d && (h += ":" + d));
+  e && (h += e);
+  f && (h += "?" + f);
+  g && (h += "#" + g);
+  return h;
+};
+goog.uri.utils.splitRe_ = /^(?:([^:/?#.]+):)?(?:\/\/(?:([^/?#]*)@)?([^/#?]*?)(?::([0-9]+))?(?=[/#?]|$))?([^?#]+)?(?:\?([^#]*))?(?:#(.*))?$/;
+goog.uri.utils.ComponentIndex = {SCHEME:1, USER_INFO:2, DOMAIN:3, PORT:4, PATH:5, QUERY_DATA:6, FRAGMENT:7};
+goog.uri.utils.split = function(a) {
+  return a.match(goog.uri.utils.splitRe_);
+};
+goog.uri.utils.decodeIfPossible_ = function(a, b) {
+  return a ? b ? decodeURI(a) : decodeURIComponent(a) : a;
+};
+goog.uri.utils.getComponentByIndex_ = function(a, b) {
+  return goog.uri.utils.split(b)[a] || null;
+};
+goog.uri.utils.getScheme = function(a) {
+  return goog.uri.utils.getComponentByIndex_(goog.uri.utils.ComponentIndex.SCHEME, a);
+};
+goog.uri.utils.getEffectiveScheme = function(a) {
+  a = goog.uri.utils.getScheme(a);
+  !a && goog.global.self && goog.global.self.location && (a = goog.global.self.location.protocol, a = a.substr(0, a.length - 1));
+  return a ? a.toLowerCase() : "";
+};
+goog.uri.utils.getUserInfoEncoded = function(a) {
+  return goog.uri.utils.getComponentByIndex_(goog.uri.utils.ComponentIndex.USER_INFO, a);
+};
+goog.uri.utils.getUserInfo = function(a) {
+  return goog.uri.utils.decodeIfPossible_(goog.uri.utils.getUserInfoEncoded(a));
+};
+goog.uri.utils.getDomainEncoded = function(a) {
+  return goog.uri.utils.getComponentByIndex_(goog.uri.utils.ComponentIndex.DOMAIN, a);
+};
+goog.uri.utils.getDomain = function(a) {
+  return goog.uri.utils.decodeIfPossible_(goog.uri.utils.getDomainEncoded(a), !0);
+};
+goog.uri.utils.getPort = function(a) {
+  return Number(goog.uri.utils.getComponentByIndex_(goog.uri.utils.ComponentIndex.PORT, a)) || null;
+};
+goog.uri.utils.getPathEncoded = function(a) {
+  return goog.uri.utils.getComponentByIndex_(goog.uri.utils.ComponentIndex.PATH, a);
+};
+goog.uri.utils.getPath = function(a) {
+  return goog.uri.utils.decodeIfPossible_(goog.uri.utils.getPathEncoded(a), !0);
+};
+goog.uri.utils.getQueryData = function(a) {
+  return goog.uri.utils.getComponentByIndex_(goog.uri.utils.ComponentIndex.QUERY_DATA, a);
+};
+goog.uri.utils.getFragmentEncoded = function(a) {
+  var b = a.indexOf("#");
+  return 0 > b ? null : a.substr(b + 1);
+};
+goog.uri.utils.setFragmentEncoded = function(a, b) {
+  return goog.uri.utils.removeFragment(a) + (b ? "#" + b : "");
+};
+goog.uri.utils.getFragment = function(a) {
+  return goog.uri.utils.decodeIfPossible_(goog.uri.utils.getFragmentEncoded(a));
+};
+goog.uri.utils.getHost = function(a) {
+  a = goog.uri.utils.split(a);
+  return goog.uri.utils.buildFromEncodedParts(a[goog.uri.utils.ComponentIndex.SCHEME], a[goog.uri.utils.ComponentIndex.USER_INFO], a[goog.uri.utils.ComponentIndex.DOMAIN], a[goog.uri.utils.ComponentIndex.PORT]);
+};
+goog.uri.utils.getPathAndAfter = function(a) {
+  a = goog.uri.utils.split(a);
+  return goog.uri.utils.buildFromEncodedParts(null, null, null, null, a[goog.uri.utils.ComponentIndex.PATH], a[goog.uri.utils.ComponentIndex.QUERY_DATA], a[goog.uri.utils.ComponentIndex.FRAGMENT]);
+};
+goog.uri.utils.removeFragment = function(a) {
+  var b = a.indexOf("#");
+  return 0 > b ? a : a.substr(0, b);
+};
+goog.uri.utils.haveSameDomain = function(a, b) {
+  var c = goog.uri.utils.split(a), d = goog.uri.utils.split(b);
+  return c[goog.uri.utils.ComponentIndex.DOMAIN] == d[goog.uri.utils.ComponentIndex.DOMAIN] && c[goog.uri.utils.ComponentIndex.SCHEME] == d[goog.uri.utils.ComponentIndex.SCHEME] && c[goog.uri.utils.ComponentIndex.PORT] == d[goog.uri.utils.ComponentIndex.PORT];
+};
+goog.uri.utils.assertNoFragmentsOrQueries_ = function(a) {
+  if (goog.DEBUG && (0 <= a.indexOf("#") || 0 <= a.indexOf("?"))) {
+    throw Error("goog.uri.utils: Fragment or query identifiers are not supported: [" + a + "]");
+  }
+};
+goog.uri.utils.parseQueryData = function(a, b) {
+  if (a) {
+    for (var c = a.split("&"), d = 0;d < c.length;d++) {
+      var e = c[d].indexOf("="), f = null, g = null;
+      0 <= e ? (f = c[d].substring(0, e), g = c[d].substring(e + 1)) : f = c[d];
+      b(f, g ? goog.string.urlDecode(g) : "");
+    }
+  }
+};
+goog.uri.utils.appendQueryData_ = function(a) {
+  if (a[1]) {
+    var b = a[0], c = b.indexOf("#");
+    0 <= c && (a.push(b.substr(c)), a[0] = b = b.substr(0, c));
+    c = b.indexOf("?");
+    0 > c ? a[1] = "?" : c == b.length - 1 && (a[1] = void 0);
+  }
+  return a.join("");
+};
+goog.uri.utils.appendKeyValuePairs_ = function(a, b, c) {
+  if (goog.isArray(b)) {
+    goog.asserts.assertArray(b);
+    for (var d = 0;d < b.length;d++) {
+      goog.uri.utils.appendKeyValuePairs_(a, String(b[d]), c);
+    }
+  } else {
+    null != b && c.push("&", a, "" === b ? "" : "=", goog.string.urlEncode(b));
+  }
+};
+goog.uri.utils.buildQueryDataBuffer_ = function(a, b, c) {
+  goog.asserts.assert(0 == Math.max(b.length - (c || 0), 0) % 2, "goog.uri.utils: Key/value lists must be even in length.");
+  for (c = c || 0;c < b.length;c += 2) {
+    goog.uri.utils.appendKeyValuePairs_(b[c], b[c + 1], a);
+  }
+  return a;
+};
+goog.uri.utils.buildQueryData = function(a, b) {
+  var c = goog.uri.utils.buildQueryDataBuffer_([], a, b);
+  c[0] = "";
+  return c.join("");
+};
+goog.uri.utils.buildQueryDataBufferFromMap_ = function(a, b) {
+  for (var c in b) {
+    goog.uri.utils.appendKeyValuePairs_(c, b[c], a);
+  }
+  return a;
+};
+goog.uri.utils.buildQueryDataFromMap = function(a) {
+  a = goog.uri.utils.buildQueryDataBufferFromMap_([], a);
+  a[0] = "";
+  return a.join("");
+};
+goog.uri.utils.appendParams = function(a, b) {
+  return goog.uri.utils.appendQueryData_(2 == arguments.length ? goog.uri.utils.buildQueryDataBuffer_([a], arguments[1], 0) : goog.uri.utils.buildQueryDataBuffer_([a], arguments, 1));
+};
+goog.uri.utils.appendParamsFromMap = function(a, b) {
+  return goog.uri.utils.appendQueryData_(goog.uri.utils.buildQueryDataBufferFromMap_([a], b));
+};
+goog.uri.utils.appendParam = function(a, b, c) {
+  a = [a, "&", b];
+  goog.isDefAndNotNull(c) && a.push("=", goog.string.urlEncode(c));
+  return goog.uri.utils.appendQueryData_(a);
+};
+goog.uri.utils.findParam_ = function(a, b, c, d) {
+  for (var e = c.length;0 <= (b = a.indexOf(c, b)) && b < d;) {
+    var f = a.charCodeAt(b - 1);
+    if (f == goog.uri.utils.CharCode_.AMPERSAND || f == goog.uri.utils.CharCode_.QUESTION) {
+      if (f = a.charCodeAt(b + e), !f || f == goog.uri.utils.CharCode_.EQUAL || f == goog.uri.utils.CharCode_.AMPERSAND || f == goog.uri.utils.CharCode_.HASH) {
+        return b;
+      }
+    }
+    b += e + 1;
+  }
+  return -1;
+};
+goog.uri.utils.hashOrEndRe_ = /#|$/;
+goog.uri.utils.hasParam = function(a, b) {
+  return 0 <= goog.uri.utils.findParam_(a, 0, b, a.search(goog.uri.utils.hashOrEndRe_));
+};
+goog.uri.utils.getParamValue = function(a, b) {
+  var c = a.search(goog.uri.utils.hashOrEndRe_), d = goog.uri.utils.findParam_(a, 0, b, c);
+  if (0 > d) {
+    return null;
+  }
+  var e = a.indexOf("&", d);
+  if (0 > e || e > c) {
+    e = c;
+  }
+  d += b.length + 1;
+  return goog.string.urlDecode(a.substr(d, e - d));
+};
+goog.uri.utils.getParamValues = function(a, b) {
+  for (var c = a.search(goog.uri.utils.hashOrEndRe_), d = 0, e, f = [];0 <= (e = goog.uri.utils.findParam_(a, d, b, c));) {
+    d = a.indexOf("&", e);
+    if (0 > d || d > c) {
+      d = c;
+    }
+    e += b.length + 1;
+    f.push(goog.string.urlDecode(a.substr(e, d - e)));
+  }
+  return f;
+};
+goog.uri.utils.trailingQueryPunctuationRe_ = /[?&]($|#)/;
+goog.uri.utils.removeParam = function(a, b) {
+  for (var c = a.search(goog.uri.utils.hashOrEndRe_), d = 0, e, f = [];0 <= (e = goog.uri.utils.findParam_(a, d, b, c));) {
+    f.push(a.substring(d, e)), d = Math.min(a.indexOf("&", e) + 1 || c, c);
+  }
+  f.push(a.substr(d));
+  return f.join("").replace(goog.uri.utils.trailingQueryPunctuationRe_, "$1");
+};
+goog.uri.utils.setParam = function(a, b, c) {
+  return goog.uri.utils.appendParam(goog.uri.utils.removeParam(a, b), b, c);
+};
+goog.uri.utils.appendPath = function(a, b) {
+  goog.uri.utils.assertNoFragmentsOrQueries_(a);
+  goog.string.endsWith(a, "/") && (a = a.substr(0, a.length - 1));
+  goog.string.startsWith(b, "/") && (b = b.substr(1));
+  return goog.string.buildString(a, "/", b);
+};
+goog.uri.utils.setPath = function(a, b) {
+  goog.string.startsWith(b, "/") || (b = "/" + b);
+  var c = goog.uri.utils.split(a);
+  return goog.uri.utils.buildFromEncodedParts(c[goog.uri.utils.ComponentIndex.SCHEME], c[goog.uri.utils.ComponentIndex.USER_INFO], c[goog.uri.utils.ComponentIndex.DOMAIN], c[goog.uri.utils.ComponentIndex.PORT], b, c[goog.uri.utils.ComponentIndex.QUERY_DATA], c[goog.uri.utils.ComponentIndex.FRAGMENT]);
+};
+goog.uri.utils.StandardQueryParam = {RANDOM:"zx"};
+goog.uri.utils.makeUnique = function(a) {
+  return goog.uri.utils.setParam(a, goog.uri.utils.StandardQueryParam.RANDOM, goog.string.getRandomString());
+};
+goog.Uri = function(a, b) {
+  this.domain_ = this.userInfo_ = this.scheme_ = "";
+  this.port_ = null;
+  this.fragment_ = this.path_ = "";
+  this.ignoreCase_ = this.isReadOnly_ = !1;
+  var c;
+  a instanceof goog.Uri ? (this.ignoreCase_ = goog.isDef(b) ? b : a.getIgnoreCase(), this.setScheme(a.getScheme()), this.setUserInfo(a.getUserInfo()), this.setDomain(a.getDomain()), this.setPort(a.getPort()), this.setPath(a.getPath()), this.setQueryData(a.getQueryData().clone()), this.setFragment(a.getFragment())) : a && (c = goog.uri.utils.split(String(a))) ? (this.ignoreCase_ = !!b, this.setScheme(c[goog.uri.utils.ComponentIndex.SCHEME] || "", !0), this.setUserInfo(c[goog.uri.utils.ComponentIndex.USER_INFO] || 
+  "", !0), this.setDomain(c[goog.uri.utils.ComponentIndex.DOMAIN] || "", !0), this.setPort(c[goog.uri.utils.ComponentIndex.PORT]), this.setPath(c[goog.uri.utils.ComponentIndex.PATH] || "", !0), this.setQueryData(c[goog.uri.utils.ComponentIndex.QUERY_DATA] || "", !0), this.setFragment(c[goog.uri.utils.ComponentIndex.FRAGMENT] || "", !0)) : (this.ignoreCase_ = !!b, this.queryData_ = new goog.Uri.QueryData(null, null, this.ignoreCase_));
+};
+goog.Uri.preserveParameterTypesCompatibilityFlag = !1;
+goog.Uri.RANDOM_PARAM = goog.uri.utils.StandardQueryParam.RANDOM;
+goog.Uri.prototype.toString = function() {
+  var a = [], b = this.getScheme();
+  b && a.push(goog.Uri.encodeSpecialChars_(b, goog.Uri.reDisallowedInSchemeOrUserInfo_, !0), ":");
+  var c = this.getDomain();
+  if (c || "file" == b) {
+    a.push("//"), (b = this.getUserInfo()) && a.push(goog.Uri.encodeSpecialChars_(b, goog.Uri.reDisallowedInSchemeOrUserInfo_, !0), "@"), a.push(goog.Uri.removeDoubleEncoding_(goog.string.urlEncode(c))), c = this.getPort(), null != c && a.push(":", String(c));
+  }
+  if (c = this.getPath()) {
+    this.hasDomain() && "/" != c.charAt(0) && a.push("/"), a.push(goog.Uri.encodeSpecialChars_(c, "/" == c.charAt(0) ? goog.Uri.reDisallowedInAbsolutePath_ : goog.Uri.reDisallowedInRelativePath_, !0));
+  }
+  (c = this.getEncodedQuery()) && a.push("?", c);
+  (c = this.getFragment()) && a.push("#", goog.Uri.encodeSpecialChars_(c, goog.Uri.reDisallowedInFragment_));
+  return a.join("");
+};
+goog.Uri.prototype.resolve = function(a) {
+  var b = this.clone(), c = a.hasScheme();
+  c ? b.setScheme(a.getScheme()) : c = a.hasUserInfo();
+  c ? b.setUserInfo(a.getUserInfo()) : c = a.hasDomain();
+  c ? b.setDomain(a.getDomain()) : c = a.hasPort();
+  var d = a.getPath();
+  if (c) {
+    b.setPort(a.getPort());
+  } else {
+    if (c = a.hasPath()) {
+      if ("/" != d.charAt(0)) {
+        if (this.hasDomain() && !this.hasPath()) {
+          d = "/" + d;
+        } else {
+          var e = b.getPath().lastIndexOf("/");
+          -1 != e && (d = b.getPath().substr(0, e + 1) + d);
+        }
+      }
+      d = goog.Uri.removeDotSegments(d);
+    }
+  }
+  c ? b.setPath(d) : c = a.hasQuery();
+  c ? b.setQueryData(a.getDecodedQuery()) : c = a.hasFragment();
+  c && b.setFragment(a.getFragment());
+  return b;
+};
+goog.Uri.prototype.clone = function() {
+  return new goog.Uri(this);
+};
+goog.Uri.prototype.getScheme = function() {
+  return this.scheme_;
+};
+goog.Uri.prototype.setScheme = function(a, b) {
+  this.enforceReadOnly();
+  if (this.scheme_ = b ? goog.Uri.decodeOrEmpty_(a, !0) : a) {
+    this.scheme_ = this.scheme_.replace(/:$/, "");
+  }
+  return this;
+};
+goog.Uri.prototype.hasScheme = function() {
+  return !!this.scheme_;
+};
+goog.Uri.prototype.getUserInfo = function() {
+  return this.userInfo_;
+};
+goog.Uri.prototype.setUserInfo = function(a, b) {
+  this.enforceReadOnly();
+  this.userInfo_ = b ? goog.Uri.decodeOrEmpty_(a) : a;
+  return this;
+};
+goog.Uri.prototype.hasUserInfo = function() {
+  return !!this.userInfo_;
+};
+goog.Uri.prototype.getDomain = function() {
+  return this.domain_;
+};
+goog.Uri.prototype.setDomain = function(a, b) {
+  this.enforceReadOnly();
+  this.domain_ = b ? goog.Uri.decodeOrEmpty_(a, !0) : a;
+  return this;
+};
+goog.Uri.prototype.hasDomain = function() {
+  return !!this.domain_;
+};
+goog.Uri.prototype.getPort = function() {
+  return this.port_;
+};
+goog.Uri.prototype.setPort = function(a) {
+  this.enforceReadOnly();
+  if (a) {
+    a = Number(a);
+    if (isNaN(a) || 0 > a) {
+      throw Error("Bad port number " + a);
+    }
+    this.port_ = a;
+  } else {
+    this.port_ = null;
+  }
+  return this;
+};
+goog.Uri.prototype.hasPort = function() {
+  return null != this.port_;
+};
+goog.Uri.prototype.getPath = function() {
+  return this.path_;
+};
+goog.Uri.prototype.setPath = function(a, b) {
+  this.enforceReadOnly();
+  this.path_ = b ? goog.Uri.decodeOrEmpty_(a, !0) : a;
+  return this;
+};
+goog.Uri.prototype.hasPath = function() {
+  return !!this.path_;
+};
+goog.Uri.prototype.hasQuery = function() {
+  return "" !== this.queryData_.toString();
+};
+goog.Uri.prototype.setQueryData = function(a, b) {
+  this.enforceReadOnly();
+  a instanceof goog.Uri.QueryData ? (this.queryData_ = a, this.queryData_.setIgnoreCase(this.ignoreCase_)) : (b || (a = goog.Uri.encodeSpecialChars_(a, goog.Uri.reDisallowedInQuery_)), this.queryData_ = new goog.Uri.QueryData(a, null, this.ignoreCase_));
+  return this;
+};
+goog.Uri.prototype.setQuery = function(a, b) {
+  return this.setQueryData(a, b);
+};
+goog.Uri.prototype.getEncodedQuery = function() {
+  return this.queryData_.toString();
+};
+goog.Uri.prototype.getDecodedQuery = function() {
+  return this.queryData_.toDecodedString();
+};
+goog.Uri.prototype.getQueryData = function() {
+  return this.queryData_;
+};
+goog.Uri.prototype.getQuery = function() {
+  return this.getEncodedQuery();
+};
+goog.Uri.prototype.setParameterValue = function(a, b) {
+  this.enforceReadOnly();
+  this.queryData_.set(a, b);
+  return this;
+};
+goog.Uri.prototype.setParameterValues = function(a, b) {
+  this.enforceReadOnly();
+  goog.isArray(b) || (b = [String(b)]);
+  this.queryData_.setValues(a, b);
+  return this;
+};
+goog.Uri.prototype.getParameterValues = function(a) {
+  return this.queryData_.getValues(a);
+};
+goog.Uri.prototype.getParameterValue = function(a) {
+  return this.queryData_.get(a);
+};
+goog.Uri.prototype.getFragment = function() {
+  return this.fragment_;
+};
+goog.Uri.prototype.setFragment = function(a, b) {
+  this.enforceReadOnly();
+  this.fragment_ = b ? goog.Uri.decodeOrEmpty_(a) : a;
+  return this;
+};
+goog.Uri.prototype.hasFragment = function() {
+  return !!this.fragment_;
+};
+goog.Uri.prototype.hasSameDomainAs = function(a) {
+  return (!this.hasDomain() && !a.hasDomain() || this.getDomain() == a.getDomain()) && (!this.hasPort() && !a.hasPort() || this.getPort() == a.getPort());
+};
+goog.Uri.prototype.makeUnique = function() {
+  this.enforceReadOnly();
+  this.setParameterValue(goog.Uri.RANDOM_PARAM, goog.string.getRandomString());
+  return this;
+};
+goog.Uri.prototype.removeParameter = function(a) {
+  this.enforceReadOnly();
+  this.queryData_.remove(a);
+  return this;
+};
+goog.Uri.prototype.setReadOnly = function(a) {
+  this.isReadOnly_ = a;
+  return this;
+};
+goog.Uri.prototype.isReadOnly = function() {
+  return this.isReadOnly_;
+};
+goog.Uri.prototype.enforceReadOnly = function() {
+  if (this.isReadOnly_) {
+    throw Error("Tried to modify a read-only Uri");
+  }
+};
+goog.Uri.prototype.setIgnoreCase = function(a) {
+  this.ignoreCase_ = a;
+  this.queryData_ && this.queryData_.setIgnoreCase(a);
+  return this;
+};
+goog.Uri.prototype.getIgnoreCase = function() {
+  return this.ignoreCase_;
+};
+goog.Uri.parse = function(a, b) {
+  return a instanceof goog.Uri ? a.clone() : new goog.Uri(a, b);
+};
+goog.Uri.create = function(a, b, c, d, e, f, g, h) {
+  h = new goog.Uri(null, h);
+  a && h.setScheme(a);
+  b && h.setUserInfo(b);
+  c && h.setDomain(c);
+  d && h.setPort(d);
+  e && h.setPath(e);
+  f && h.setQueryData(f);
+  g && h.setFragment(g);
+  return h;
+};
+goog.Uri.resolve = function(a, b) {
+  a instanceof goog.Uri || (a = goog.Uri.parse(a));
+  b instanceof goog.Uri || (b = goog.Uri.parse(b));
+  return a.resolve(b);
+};
+goog.Uri.removeDotSegments = function(a) {
+  if (".." == a || "." == a) {
+    return "";
+  }
+  if (goog.string.contains(a, "./") || goog.string.contains(a, "/.")) {
+    var b = goog.string.startsWith(a, "/");
+    a = a.split("/");
+    for (var c = [], d = 0;d < a.length;) {
+      var e = a[d++];
+      "." == e ? b && d == a.length && c.push("") : ".." == e ? ((1 < c.length || 1 == c.length && "" != c[0]) && c.pop(), b && d == a.length && c.push("")) : (c.push(e), b = !0);
+    }
+    return c.join("/");
+  }
+  return a;
+};
+goog.Uri.decodeOrEmpty_ = function(a, b) {
+  return a ? b ? decodeURI(a.replace(/%25/g, "%2525")) : decodeURIComponent(a) : "";
+};
+goog.Uri.encodeSpecialChars_ = function(a, b, c) {
+  return goog.isString(a) ? (a = encodeURI(a).replace(b, goog.Uri.encodeChar_), c && (a = goog.Uri.removeDoubleEncoding_(a)), a) : null;
+};
+goog.Uri.encodeChar_ = function(a) {
+  a = a.charCodeAt(0);
+  return "%" + (a >> 4 & 15).toString(16) + (a & 15).toString(16);
+};
+goog.Uri.removeDoubleEncoding_ = function(a) {
+  return a.replace(/%25([0-9a-fA-F]{2})/g, "%$1");
+};
+goog.Uri.reDisallowedInSchemeOrUserInfo_ = /[#\/\?@]/g;
+goog.Uri.reDisallowedInRelativePath_ = /[\#\?:]/g;
+goog.Uri.reDisallowedInAbsolutePath_ = /[\#\?]/g;
+goog.Uri.reDisallowedInQuery_ = /[\#\?@]/g;
+goog.Uri.reDisallowedInFragment_ = /#/g;
+goog.Uri.haveSameDomain = function(a, b) {
+  var c = goog.uri.utils.split(a), d = goog.uri.utils.split(b);
+  return c[goog.uri.utils.ComponentIndex.DOMAIN] == d[goog.uri.utils.ComponentIndex.DOMAIN] && c[goog.uri.utils.ComponentIndex.PORT] == d[goog.uri.utils.ComponentIndex.PORT];
+};
+goog.Uri.QueryData = function(a, b, c) {
+  this.count_ = this.keyMap_ = null;
+  this.encodedQuery_ = a || null;
+  this.ignoreCase_ = !!c;
+};
+goog.Uri.QueryData.prototype.ensureKeyMapInitialized_ = function() {
+  if (!this.keyMap_ && (this.keyMap_ = new goog.structs.Map, this.count_ = 0, this.encodedQuery_)) {
+    var a = this;
+    goog.uri.utils.parseQueryData(this.encodedQuery_, function(b, c) {
+      a.add(goog.string.urlDecode(b), c);
+    });
+  }
+};
+goog.Uri.QueryData.createFromMap = function(a, b, c) {
+  b = goog.structs.getKeys(a);
+  if ("undefined" == typeof b) {
+    throw Error("Keys are undefined");
+  }
+  c = new goog.Uri.QueryData(null, null, c);
+  a = goog.structs.getValues(a);
+  for (var d = 0;d < b.length;d++) {
+    var e = b[d], f = a[d];
+    goog.isArray(f) ? c.setValues(e, f) : c.add(e, f);
+  }
+  return c;
+};
+goog.Uri.QueryData.createFromKeysValues = function(a, b, c, d) {
+  if (a.length != b.length) {
+    throw Error("Mismatched lengths for keys/values");
+  }
+  c = new goog.Uri.QueryData(null, null, d);
+  for (d = 0;d < a.length;d++) {
+    c.add(a[d], b[d]);
+  }
+  return c;
+};
+goog.Uri.QueryData.prototype.getCount = function() {
+  this.ensureKeyMapInitialized_();
+  return this.count_;
+};
+goog.Uri.QueryData.prototype.add = function(a, b) {
+  this.ensureKeyMapInitialized_();
+  this.invalidateCache_();
+  a = this.getKeyName_(a);
+  var c = this.keyMap_.get(a);
+  c || this.keyMap_.set(a, c = []);
+  c.push(b);
+  this.count_++;
+  return this;
+};
+goog.Uri.QueryData.prototype.remove = function(a) {
+  this.ensureKeyMapInitialized_();
+  a = this.getKeyName_(a);
+  return this.keyMap_.containsKey(a) ? (this.invalidateCache_(), this.count_ -= this.keyMap_.get(a).length, this.keyMap_.remove(a)) : !1;
+};
+goog.Uri.QueryData.prototype.clear = function() {
+  this.invalidateCache_();
+  this.keyMap_ = null;
+  this.count_ = 0;
+};
+goog.Uri.QueryData.prototype.isEmpty = function() {
+  this.ensureKeyMapInitialized_();
+  return 0 == this.count_;
+};
+goog.Uri.QueryData.prototype.containsKey = function(a) {
+  this.ensureKeyMapInitialized_();
+  a = this.getKeyName_(a);
+  return this.keyMap_.containsKey(a);
+};
+goog.Uri.QueryData.prototype.containsValue = function(a) {
+  var b = this.getValues();
+  return goog.array.contains(b, a);
+};
+goog.Uri.QueryData.prototype.getKeys = function() {
+  this.ensureKeyMapInitialized_();
+  for (var a = this.keyMap_.getValues(), b = this.keyMap_.getKeys(), c = [], d = 0;d < b.length;d++) {
+    for (var e = a[d], f = 0;f < e.length;f++) {
+      c.push(b[d]);
+    }
+  }
+  return c;
+};
+goog.Uri.QueryData.prototype.getValues = function(a) {
+  this.ensureKeyMapInitialized_();
+  var b = [];
+  if (goog.isString(a)) {
+    this.containsKey(a) && (b = goog.array.concat(b, this.keyMap_.get(this.getKeyName_(a))));
+  } else {
+    a = this.keyMap_.getValues();
+    for (var c = 0;c < a.length;c++) {
+      b = goog.array.concat(b, a[c]);
+    }
+  }
+  return b;
+};
+goog.Uri.QueryData.prototype.set = function(a, b) {
+  this.ensureKeyMapInitialized_();
+  this.invalidateCache_();
+  a = this.getKeyName_(a);
+  this.containsKey(a) && (this.count_ -= this.keyMap_.get(a).length);
+  this.keyMap_.set(a, [b]);
+  this.count_++;
+  return this;
+};
+goog.Uri.QueryData.prototype.get = function(a, b) {
+  var c = a ? this.getValues(a) : [];
+  return goog.Uri.preserveParameterTypesCompatibilityFlag ? 0 < c.length ? c[0] : b : 0 < c.length ? String(c[0]) : b;
+};
+goog.Uri.QueryData.prototype.setValues = function(a, b) {
+  this.remove(a);
+  0 < b.length && (this.invalidateCache_(), this.keyMap_.set(this.getKeyName_(a), goog.array.clone(b)), this.count_ += b.length);
+};
+goog.Uri.QueryData.prototype.toString = function() {
+  if (this.encodedQuery_) {
+    return this.encodedQuery_;
+  }
+  if (!this.keyMap_) {
+    return "";
+  }
+  for (var a = [], b = this.keyMap_.getKeys(), c = 0;c < b.length;c++) {
+    for (var d = b[c], e = goog.string.urlEncode(d), d = this.getValues(d), f = 0;f < d.length;f++) {
+      var g = e;
+      "" !== d[f] && (g += "=" + goog.string.urlEncode(d[f]));
+      a.push(g);
+    }
+  }
+  return this.encodedQuery_ = a.join("&");
+};
+goog.Uri.QueryData.prototype.toDecodedString = function() {
+  return goog.Uri.decodeOrEmpty_(this.toString());
+};
+goog.Uri.QueryData.prototype.invalidateCache_ = function() {
+  this.encodedQuery_ = null;
+};
+goog.Uri.QueryData.prototype.filterKeys = function(a) {
+  this.ensureKeyMapInitialized_();
+  this.keyMap_.forEach(function(b, c) {
+    goog.array.contains(a, c) || this.remove(c);
+  }, this);
+  return this;
+};
+goog.Uri.QueryData.prototype.clone = function() {
+  var a = new goog.Uri.QueryData;
+  a.encodedQuery_ = this.encodedQuery_;
+  this.keyMap_ && (a.keyMap_ = this.keyMap_.clone(), a.count_ = this.count_);
+  return a;
+};
+goog.Uri.QueryData.prototype.getKeyName_ = function(a) {
+  a = String(a);
+  this.ignoreCase_ && (a = a.toLowerCase());
+  return a;
+};
+goog.Uri.QueryData.prototype.setIgnoreCase = function(a) {
+  a && !this.ignoreCase_ && (this.ensureKeyMapInitialized_(), this.invalidateCache_(), this.keyMap_.forEach(function(a, c) {
+    var d = c.toLowerCase();
+    c != d && (this.remove(c), this.setValues(d, a));
+  }, this));
+  this.ignoreCase_ = a;
+};
+goog.Uri.QueryData.prototype.extend = function(a) {
+  for (var b = 0;b < arguments.length;b++) {
+    goog.structs.forEach(arguments[b], function(a, b) {
+      this.add(b, a);
+    }, this);
+  }
+};
+goog.dom.TagName = {A:"A", ABBR:"ABBR", ACRONYM:"ACRONYM", ADDRESS:"ADDRESS", APPLET:"APPLET", AREA:"AREA", ARTICLE:"ARTICLE", ASIDE:"ASIDE", AUDIO:"AUDIO", B:"B", BASE:"BASE", BASEFONT:"BASEFONT", BDI:"BDI", BDO:"BDO", BIG:"BIG", BLOCKQUOTE:"BLOCKQUOTE", BODY:"BODY", BR:"BR", BUTTON:"BUTTON", CANVAS:"CANVAS", CAPTION:"CAPTION", CENTER:"CENTER", CITE:"CITE", CODE:"CODE", COL:"COL", COLGROUP:"COLGROUP", COMMAND:"COMMAND", DATA:"DATA", DATALIST:"DATALIST", DD:"DD", DEL:"DEL", DETAILS:"DETAILS", DFN:"DFN", 
+DIALOG:"DIALOG", DIR:"DIR", DIV:"DIV", DL:"DL", DT:"DT", EM:"EM", EMBED:"EMBED", FIELDSET:"FIELDSET", FIGCAPTION:"FIGCAPTION", FIGURE:"FIGURE", FONT:"FONT", FOOTER:"FOOTER", FORM:"FORM", FRAME:"FRAME", FRAMESET:"FRAMESET", H1:"H1", H2:"H2", H3:"H3", H4:"H4", H5:"H5", H6:"H6", HEAD:"HEAD", HEADER:"HEADER", HGROUP:"HGROUP", HR:"HR", HTML:"HTML", I:"I", IFRAME:"IFRAME", IMG:"IMG", INPUT:"INPUT", INS:"INS", ISINDEX:"ISINDEX", KBD:"KBD", KEYGEN:"KEYGEN", LABEL:"LABEL", LEGEND:"LEGEND", LI:"LI", LINK:"LINK", 
+MAP:"MAP", MARK:"MARK", MATH:"MATH", MENU:"MENU", META:"META", METER:"METER", NAV:"NAV", NOFRAMES:"NOFRAMES", NOSCRIPT:"NOSCRIPT", OBJECT:"OBJECT", OL:"OL", OPTGROUP:"OPTGROUP", OPTION:"OPTION", OUTPUT:"OUTPUT", P:"P", PARAM:"PARAM", PRE:"PRE", PROGRESS:"PROGRESS", Q:"Q", RP:"RP", RT:"RT", RUBY:"RUBY", S:"S", SAMP:"SAMP", SCRIPT:"SCRIPT", SECTION:"SECTION", SELECT:"SELECT", SMALL:"SMALL", SOURCE:"SOURCE", SPAN:"SPAN", STRIKE:"STRIKE", STRONG:"STRONG", STYLE:"STYLE", SUB:"SUB", SUMMARY:"SUMMARY", 
+SUP:"SUP", SVG:"SVG", TABLE:"TABLE", TBODY:"TBODY", TD:"TD", TEMPLATE:"TEMPLATE", TEXTAREA:"TEXTAREA", TFOOT:"TFOOT", TH:"TH", THEAD:"THEAD", TIME:"TIME", TITLE:"TITLE", TR:"TR", TRACK:"TRACK", TT:"TT", U:"U", UL:"UL", VAR:"VAR", VIDEO:"VIDEO", WBR:"WBR"};
+goog.dom.tags = {};
+goog.dom.tags.VOID_TAGS_ = {area:!0, base:!0, br:!0, col:!0, command:!0, embed:!0, hr:!0, img:!0, input:!0, keygen:!0, link:!0, meta:!0, param:!0, source:!0, track:!0, wbr:!0};
+goog.dom.tags.isVoidTag = function(a) {
+  return !0 === goog.dom.tags.VOID_TAGS_[a];
+};
+goog.string.TypedString = function() {
+};
+goog.string.Const = function() {
+  this.stringConstValueWithSecurityContract__googStringSecurityPrivate_ = "";
+  this.STRING_CONST_TYPE_MARKER__GOOG_STRING_SECURITY_PRIVATE_ = goog.string.Const.TYPE_MARKER_;
+};
+goog.string.Const.prototype.implementsGoogStringTypedString = !0;
+goog.string.Const.prototype.getTypedStringValue = function() {
+  return this.stringConstValueWithSecurityContract__googStringSecurityPrivate_;
+};
+goog.string.Const.prototype.toString = function() {
+  return "Const{" + this.stringConstValueWithSecurityContract__googStringSecurityPrivate_ + "}";
+};
+goog.string.Const.unwrap = function(a) {
+  if (a instanceof goog.string.Const && a.constructor === goog.string.Const && a.STRING_CONST_TYPE_MARKER__GOOG_STRING_SECURITY_PRIVATE_ === goog.string.Const.TYPE_MARKER_) {
+    return a.stringConstValueWithSecurityContract__googStringSecurityPrivate_;
+  }
+  goog.asserts.fail("expected object of type Const, got '" + a + "'");
+  return "type_error:Const";
+};
+goog.string.Const.from = function(a) {
+  return goog.string.Const.create__googStringSecurityPrivate_(a);
+};
+goog.string.Const.TYPE_MARKER_ = {};
+goog.string.Const.create__googStringSecurityPrivate_ = function(a) {
+  var b = new goog.string.Const;
+  b.stringConstValueWithSecurityContract__googStringSecurityPrivate_ = a;
+  return b;
+};
+goog.html = {};
+goog.html.SafeStyle = function() {
+  this.privateDoNotAccessOrElseSafeStyleWrappedValue_ = "";
+  this.SAFE_STYLE_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+goog.html.SafeStyle.prototype.implementsGoogStringTypedString = !0;
+goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+goog.html.SafeStyle.fromConstant = function(a) {
+  a = goog.string.Const.unwrap(a);
+  if (0 === a.length) {
+    return goog.html.SafeStyle.EMPTY;
+  }
+  goog.html.SafeStyle.checkStyle_(a);
+  goog.asserts.assert(goog.string.endsWith(a, ";"), "Last character of style string is not ';': " + a);
+  goog.asserts.assert(goog.string.contains(a, ":"), "Style string must contain at least one ':', to specify a \"name: value\" pair: " + a);
+  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(a);
+};
+goog.html.SafeStyle.checkStyle_ = function(a) {
+  goog.asserts.assert(!/[<>]/.test(a), "Forbidden characters in style string: " + a);
+};
+goog.html.SafeStyle.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeStyleWrappedValue_;
+};
+goog.DEBUG && (goog.html.SafeStyle.prototype.toString = function() {
+  return "SafeStyle{" + this.privateDoNotAccessOrElseSafeStyleWrappedValue_ + "}";
+});
+goog.html.SafeStyle.unwrap = function(a) {
+  if (a instanceof goog.html.SafeStyle && a.constructor === goog.html.SafeStyle && a.SAFE_STYLE_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ === goog.html.SafeStyle.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return a.privateDoNotAccessOrElseSafeStyleWrappedValue_;
+  }
+  goog.asserts.fail("expected object of type SafeStyle, got '" + a + "'");
+  return "type_error:SafeStyle";
+};
+goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse = function(a) {
+  return (new goog.html.SafeStyle).initSecurityPrivateDoNotAccessOrElse_(a);
+};
+goog.html.SafeStyle.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(a) {
+  this.privateDoNotAccessOrElseSafeStyleWrappedValue_ = a;
+  return this;
+};
+goog.html.SafeStyle.EMPTY = goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse("");
+goog.html.SafeStyle.INNOCUOUS_STRING = "zClosurez";
+goog.html.SafeStyle.create = function(a) {
+  var b = "", c;
+  for (c in a) {
+    if (!/^[-_a-zA-Z0-9]+$/.test(c)) {
+      throw Error("Name allows only [-_a-zA-Z0-9], got: " + c);
+    }
+    var d = a[c];
+    null != d && (d instanceof goog.string.Const ? (d = goog.string.Const.unwrap(d), goog.asserts.assert(!/[{;}]/.test(d), "Value does not allow [{;}].")) : goog.html.SafeStyle.VALUE_RE_.test(d) ? goog.html.SafeStyle.hasBalancedQuotes_(d) || (goog.asserts.fail("String value requires balanced quotes, got: " + d), d = goog.html.SafeStyle.INNOCUOUS_STRING) : (goog.asserts.fail("String value allows only [-,.\"'%_!# a-zA-Z0-9], got: " + d), d = goog.html.SafeStyle.INNOCUOUS_STRING), b += c + ":" + d + 
+    ";");
+  }
+  if (!b) {
+    return goog.html.SafeStyle.EMPTY;
+  }
+  goog.html.SafeStyle.checkStyle_(b);
+  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(b);
+};
+goog.html.SafeStyle.hasBalancedQuotes_ = function(a) {
+  for (var b = !0, c = !0, d = 0;d < a.length;d++) {
+    var e = a.charAt(d);
+    "'" == e && c ? b = !b : '"' == e && b && (c = !c);
+  }
+  return b && c;
+};
+goog.html.SafeStyle.VALUE_RE_ = /^[-,."'%_!# a-zA-Z0-9]+$/;
+goog.html.SafeStyle.concat = function(a) {
+  var b = "", c = function(a) {
+    goog.isArray(a) ? goog.array.forEach(a, c) : b += goog.html.SafeStyle.unwrap(a);
+  };
+  goog.array.forEach(arguments, c);
+  return b ? goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(b) : goog.html.SafeStyle.EMPTY;
+};
+goog.html.SafeStyleSheet = function() {
+  this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ = "";
+  this.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+goog.html.SafeStyleSheet.prototype.implementsGoogStringTypedString = !0;
+goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+goog.html.SafeStyleSheet.concat = function(a) {
+  var b = "", c = function(a) {
+    goog.isArray(a) ? goog.array.forEach(a, c) : b += goog.html.SafeStyleSheet.unwrap(a);
+  };
+  goog.array.forEach(arguments, c);
+  return goog.html.SafeStyleSheet.createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(b);
+};
+goog.html.SafeStyleSheet.fromConstant = function(a) {
+  a = goog.string.Const.unwrap(a);
+  if (0 === a.length) {
+    return goog.html.SafeStyleSheet.EMPTY;
+  }
+  goog.asserts.assert(!goog.string.contains(a, "<"), "Forbidden '<' character in style sheet string: " + a);
+  return goog.html.SafeStyleSheet.createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(a);
+};
+goog.html.SafeStyleSheet.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_;
+};
+goog.DEBUG && (goog.html.SafeStyleSheet.prototype.toString = function() {
+  return "SafeStyleSheet{" + this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ + "}";
+});
+goog.html.SafeStyleSheet.unwrap = function(a) {
+  if (a instanceof goog.html.SafeStyleSheet && a.constructor === goog.html.SafeStyleSheet && a.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ === goog.html.SafeStyleSheet.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return a.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_;
+  }
+  goog.asserts.fail("expected object of type SafeStyleSheet, got '" + a + "'");
+  return "type_error:SafeStyleSheet";
+};
+goog.html.SafeStyleSheet.createSafeStyleSheetSecurityPrivateDoNotAccessOrElse = function(a) {
+  return (new goog.html.SafeStyleSheet).initSecurityPrivateDoNotAccessOrElse_(a);
+};
+goog.html.SafeStyleSheet.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(a) {
+  this.privateDoNotAccessOrElseSafeStyleSheetWrappedValue_ = a;
+  return this;
+};
+goog.html.SafeStyleSheet.EMPTY = goog.html.SafeStyleSheet.createSafeStyleSheetSecurityPrivateDoNotAccessOrElse("");
+goog.fs = {};
+goog.fs.url = {};
+goog.fs.url.createObjectUrl = function(a) {
+  return goog.fs.url.getUrlObject_().createObjectURL(a);
+};
+goog.fs.url.revokeObjectUrl = function(a) {
+  goog.fs.url.getUrlObject_().revokeObjectURL(a);
+};
+goog.fs.url.getUrlObject_ = function() {
+  var a = goog.fs.url.findUrlObject_();
+  if (null != a) {
+    return a;
+  }
+  throw Error("This browser doesn't seem to support blob URLs");
+};
+goog.fs.url.findUrlObject_ = function() {
+  return goog.isDef(goog.global.URL) && goog.isDef(goog.global.URL.createObjectURL) ? goog.global.URL : goog.isDef(goog.global.webkitURL) && goog.isDef(goog.global.webkitURL.createObjectURL) ? goog.global.webkitURL : goog.isDef(goog.global.createObjectURL) ? goog.global : null;
+};
+goog.fs.url.browserSupportsObjectUrls = function() {
+  return null != goog.fs.url.findUrlObject_();
+};
+goog.i18n = {};
+goog.i18n.bidi = {};
+goog.i18n.bidi.FORCE_RTL = !1;
+goog.i18n.bidi.IS_RTL = goog.i18n.bidi.FORCE_RTL || ("ar" == goog.LOCALE.substring(0, 2).toLowerCase() || "fa" == goog.LOCALE.substring(0, 2).toLowerCase() || "he" == goog.LOCALE.substring(0, 2).toLowerCase() || "iw" == goog.LOCALE.substring(0, 2).toLowerCase() || "ps" == goog.LOCALE.substring(0, 2).toLowerCase() || "sd" == goog.LOCALE.substring(0, 2).toLowerCase() || "ug" == goog.LOCALE.substring(0, 2).toLowerCase() || "ur" == goog.LOCALE.substring(0, 2).toLowerCase() || "yi" == goog.LOCALE.substring(0, 
+2).toLowerCase()) && (2 == goog.LOCALE.length || "-" == goog.LOCALE.substring(2, 3) || "_" == goog.LOCALE.substring(2, 3)) || 3 <= goog.LOCALE.length && "ckb" == goog.LOCALE.substring(0, 3).toLowerCase() && (3 == goog.LOCALE.length || "-" == goog.LOCALE.substring(3, 4) || "_" == goog.LOCALE.substring(3, 4));
+goog.i18n.bidi.Format = {LRE:"\u202a", RLE:"\u202b", PDF:"\u202c", LRM:"\u200e", RLM:"\u200f"};
+goog.i18n.bidi.Dir = {LTR:1, RTL:-1, NEUTRAL:0};
+goog.i18n.bidi.RIGHT = "right";
+goog.i18n.bidi.LEFT = "left";
+goog.i18n.bidi.I18N_RIGHT = goog.i18n.bidi.IS_RTL ? goog.i18n.bidi.LEFT : goog.i18n.bidi.RIGHT;
+goog.i18n.bidi.I18N_LEFT = goog.i18n.bidi.IS_RTL ? goog.i18n.bidi.RIGHT : goog.i18n.bidi.LEFT;
+goog.i18n.bidi.toDir = function(a, b) {
+  return "number" == typeof a ? 0 < a ? goog.i18n.bidi.Dir.LTR : 0 > a ? goog.i18n.bidi.Dir.RTL : b ? null : goog.i18n.bidi.Dir.NEUTRAL : null == a ? null : a ? goog.i18n.bidi.Dir.RTL : goog.i18n.bidi.Dir.LTR;
+};
+goog.i18n.bidi.ltrChars_ = "A-Za-z\u00c0-\u00d6\u00d8-\u00f6\u00f8-\u02b8\u0300-\u0590\u0800-\u1fff\u200e\u2c00-\ufb1c\ufe00-\ufe6f\ufefd-\uffff";
+goog.i18n.bidi.rtlChars_ = "\u0591-\u06ef\u06fa-\u07ff\u200f\ufb1d-\ufdff\ufe70-\ufefc";
+goog.i18n.bidi.htmlSkipReg_ = /<[^>]*>|&[^;]+;/g;
+goog.i18n.bidi.stripHtmlIfNeeded_ = function(a, b) {
+  return b ? a.replace(goog.i18n.bidi.htmlSkipReg_, "") : a;
+};
+goog.i18n.bidi.rtlCharReg_ = new RegExp("[" + goog.i18n.bidi.rtlChars_ + "]");
+goog.i18n.bidi.ltrCharReg_ = new RegExp("[" + goog.i18n.bidi.ltrChars_ + "]");
+goog.i18n.bidi.hasAnyRtl = function(a, b) {
+  return goog.i18n.bidi.rtlCharReg_.test(goog.i18n.bidi.stripHtmlIfNeeded_(a, b));
+};
+goog.i18n.bidi.hasRtlChar = goog.i18n.bidi.hasAnyRtl;
+goog.i18n.bidi.hasAnyLtr = function(a, b) {
+  return goog.i18n.bidi.ltrCharReg_.test(goog.i18n.bidi.stripHtmlIfNeeded_(a, b));
+};
+goog.i18n.bidi.ltrRe_ = new RegExp("^[" + goog.i18n.bidi.ltrChars_ + "]");
+goog.i18n.bidi.rtlRe_ = new RegExp("^[" + goog.i18n.bidi.rtlChars_ + "]");
+goog.i18n.bidi.isRtlChar = function(a) {
+  return goog.i18n.bidi.rtlRe_.test(a);
+};
+goog.i18n.bidi.isLtrChar = function(a) {
+  return goog.i18n.bidi.ltrRe_.test(a);
+};
+goog.i18n.bidi.isNeutralChar = function(a) {
+  return !goog.i18n.bidi.isLtrChar(a) && !goog.i18n.bidi.isRtlChar(a);
+};
+goog.i18n.bidi.ltrDirCheckRe_ = new RegExp("^[^" + goog.i18n.bidi.rtlChars_ + "]*[" + goog.i18n.bidi.ltrChars_ + "]");
+goog.i18n.bidi.rtlDirCheckRe_ = new RegExp("^[^" + goog.i18n.bidi.ltrChars_ + "]*[" + goog.i18n.bidi.rtlChars_ + "]");
+goog.i18n.bidi.startsWithRtl = function(a, b) {
+  return goog.i18n.bidi.rtlDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(a, b));
+};
+goog.i18n.bidi.isRtlText = goog.i18n.bidi.startsWithRtl;
+goog.i18n.bidi.startsWithLtr = function(a, b) {
+  return goog.i18n.bidi.ltrDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(a, b));
+};
+goog.i18n.bidi.isLtrText = goog.i18n.bidi.startsWithLtr;
+goog.i18n.bidi.isRequiredLtrRe_ = /^http:\/\/.*/;
+goog.i18n.bidi.isNeutralText = function(a, b) {
+  a = goog.i18n.bidi.stripHtmlIfNeeded_(a, b);
+  return goog.i18n.bidi.isRequiredLtrRe_.test(a) || !goog.i18n.bidi.hasAnyLtr(a) && !goog.i18n.bidi.hasAnyRtl(a);
+};
+goog.i18n.bidi.ltrExitDirCheckRe_ = new RegExp("[" + goog.i18n.bidi.ltrChars_ + "][^" + goog.i18n.bidi.rtlChars_ + "]*$");
+goog.i18n.bidi.rtlExitDirCheckRe_ = new RegExp("[" + goog.i18n.bidi.rtlChars_ + "][^" + goog.i18n.bidi.ltrChars_ + "]*$");
+goog.i18n.bidi.endsWithLtr = function(a, b) {
+  return goog.i18n.bidi.ltrExitDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(a, b));
+};
+goog.i18n.bidi.isLtrExitText = goog.i18n.bidi.endsWithLtr;
+goog.i18n.bidi.endsWithRtl = function(a, b) {
+  return goog.i18n.bidi.rtlExitDirCheckRe_.test(goog.i18n.bidi.stripHtmlIfNeeded_(a, b));
+};
+goog.i18n.bidi.isRtlExitText = goog.i18n.bidi.endsWithRtl;
+goog.i18n.bidi.rtlLocalesRe_ = /^(ar|ckb|dv|he|iw|fa|nqo|ps|sd|ug|ur|yi|.*[-_](Arab|Hebr|Thaa|Nkoo|Tfng))(?!.*[-_](Latn|Cyrl)($|-|_))($|-|_)/i;
+goog.i18n.bidi.isRtlLanguage = function(a) {
+  return goog.i18n.bidi.rtlLocalesRe_.test(a);
+};
+goog.i18n.bidi.bracketGuardHtmlRe_ = /(\(.*?\)+)|(\[.*?\]+)|(\{.*?\}+)|(&lt;.*?(&gt;)+)/g;
+goog.i18n.bidi.bracketGuardTextRe_ = /(\(.*?\)+)|(\[.*?\]+)|(\{.*?\}+)|(<.*?>+)/g;
+goog.i18n.bidi.guardBracketInHtml = function(a, b) {
+  return (void 0 === b ? goog.i18n.bidi.hasAnyRtl(a) : b) ? a.replace(goog.i18n.bidi.bracketGuardHtmlRe_, "<span dir=rtl>$&</span>") : a.replace(goog.i18n.bidi.bracketGuardHtmlRe_, "<span dir=ltr>$&</span>");
+};
+goog.i18n.bidi.guardBracketInText = function(a, b) {
+  var c = (void 0 === b ? goog.i18n.bidi.hasAnyRtl(a) : b) ? goog.i18n.bidi.Format.RLM : goog.i18n.bidi.Format.LRM;
+  return a.replace(goog.i18n.bidi.bracketGuardTextRe_, c + "$&" + c);
+};
+goog.i18n.bidi.enforceRtlInHtml = function(a) {
+  return "<" == a.charAt(0) ? a.replace(/<\w+/, "$& dir=rtl") : "\n<span dir=rtl>" + a + "</span>";
+};
+goog.i18n.bidi.enforceRtlInText = function(a) {
+  return goog.i18n.bidi.Format.RLE + a + goog.i18n.bidi.Format.PDF;
+};
+goog.i18n.bidi.enforceLtrInHtml = function(a) {
+  return "<" == a.charAt(0) ? a.replace(/<\w+/, "$& dir=ltr") : "\n<span dir=ltr>" + a + "</span>";
+};
+goog.i18n.bidi.enforceLtrInText = function(a) {
+  return goog.i18n.bidi.Format.LRE + a + goog.i18n.bidi.Format.PDF;
+};
+goog.i18n.bidi.dimensionsRe_ = /:\s*([.\d][.\w]*)\s+([.\d][.\w]*)\s+([.\d][.\w]*)\s+([.\d][.\w]*)/g;
+goog.i18n.bidi.leftRe_ = /left/gi;
+goog.i18n.bidi.rightRe_ = /right/gi;
+goog.i18n.bidi.tempRe_ = /%%%%/g;
+goog.i18n.bidi.mirrorCSS = function(a) {
+  return a.replace(goog.i18n.bidi.dimensionsRe_, ":$1 $4 $3 $2").replace(goog.i18n.bidi.leftRe_, "%%%%").replace(goog.i18n.bidi.rightRe_, goog.i18n.bidi.LEFT).replace(goog.i18n.bidi.tempRe_, goog.i18n.bidi.RIGHT);
+};
+goog.i18n.bidi.doubleQuoteSubstituteRe_ = /([\u0591-\u05f2])"/g;
+goog.i18n.bidi.singleQuoteSubstituteRe_ = /([\u0591-\u05f2])'/g;
+goog.i18n.bidi.normalizeHebrewQuote = function(a) {
+  return a.replace(goog.i18n.bidi.doubleQuoteSubstituteRe_, "$1\u05f4").replace(goog.i18n.bidi.singleQuoteSubstituteRe_, "$1\u05f3");
+};
+goog.i18n.bidi.wordSeparatorRe_ = /\s+/;
+goog.i18n.bidi.hasNumeralsRe_ = /[\d\u06f0-\u06f9]/;
+goog.i18n.bidi.rtlDetectionThreshold_ = .4;
+goog.i18n.bidi.estimateDirection = function(a, b) {
+  for (var c = 0, d = 0, e = !1, f = goog.i18n.bidi.stripHtmlIfNeeded_(a, b).split(goog.i18n.bidi.wordSeparatorRe_), g = 0;g < f.length;g++) {
+    var h = f[g];
+    goog.i18n.bidi.startsWithRtl(h) ? (c++, d++) : goog.i18n.bidi.isRequiredLtrRe_.test(h) ? e = !0 : goog.i18n.bidi.hasAnyLtr(h) ? d++ : goog.i18n.bidi.hasNumeralsRe_.test(h) && (e = !0);
+  }
+  return 0 == d ? e ? goog.i18n.bidi.Dir.LTR : goog.i18n.bidi.Dir.NEUTRAL : c / d > goog.i18n.bidi.rtlDetectionThreshold_ ? goog.i18n.bidi.Dir.RTL : goog.i18n.bidi.Dir.LTR;
+};
+goog.i18n.bidi.detectRtlDirectionality = function(a, b) {
+  return goog.i18n.bidi.estimateDirection(a, b) == goog.i18n.bidi.Dir.RTL;
+};
+goog.i18n.bidi.setElementDirAndAlign = function(a, b) {
+  a && (b = goog.i18n.bidi.toDir(b)) && (a.style.textAlign = b == goog.i18n.bidi.Dir.RTL ? goog.i18n.bidi.RIGHT : goog.i18n.bidi.LEFT, a.dir = b == goog.i18n.bidi.Dir.RTL ? "rtl" : "ltr");
+};
+goog.i18n.bidi.setElementDirByTextDirectionality = function(a, b) {
+  switch(goog.i18n.bidi.estimateDirection(b)) {
+    case goog.i18n.bidi.Dir.LTR:
+      a.dir = "ltr";
+      break;
+    case goog.i18n.bidi.Dir.RTL:
+      a.dir = "rtl";
+      break;
+    default:
+      a.removeAttribute("dir");
+  }
+};
+goog.i18n.bidi.DirectionalString = function() {
+};
+goog.html.SafeUrl = function() {
+  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = "";
+  this.SAFE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+goog.html.SafeUrl.INNOCUOUS_STRING = "about:invalid#zClosurez";
+goog.html.SafeUrl.prototype.implementsGoogStringTypedString = !0;
+goog.html.SafeUrl.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeHtmlWrappedValue_;
+};
+goog.html.SafeUrl.prototype.implementsGoogI18nBidiDirectionalString = !0;
+goog.html.SafeUrl.prototype.getDirection = function() {
+  return goog.i18n.bidi.Dir.LTR;
+};
+goog.DEBUG && (goog.html.SafeUrl.prototype.toString = function() {
+  return "SafeUrl{" + this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ + "}";
+});
+goog.html.SafeUrl.unwrap = function(a) {
+  if (a instanceof goog.html.SafeUrl && a.constructor === goog.html.SafeUrl && a.SAFE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ === goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return a.privateDoNotAccessOrElseSafeHtmlWrappedValue_;
+  }
+  goog.asserts.fail("expected object of type SafeUrl, got '" + a + "'");
+  return "type_error:SafeUrl";
+};
+goog.html.SafeUrl.fromConstant = function(a) {
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(goog.string.Const.unwrap(a));
+};
+goog.html.SAFE_MIME_TYPE_PATTERN_ = /^(?:image\/(?:bmp|gif|jpeg|jpg|png|tiff|webp)|video\/(?:mpeg|mp4|ogg|webm))$/i;
+goog.html.SafeUrl.fromBlob = function(a) {
+  a = goog.html.SAFE_MIME_TYPE_PATTERN_.test(a.type) ? goog.fs.url.createObjectUrl(a) : goog.html.SafeUrl.INNOCUOUS_STRING;
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(a);
+};
+goog.html.DATA_URL_PATTERN_ = /^data:([^;,]*);base64,[a-z0-9+\/]+=*$/i;
+goog.html.SafeUrl.fromDataUrl = function(a) {
+  var b = a.match(goog.html.DATA_URL_PATTERN_), b = b && goog.html.SAFE_MIME_TYPE_PATTERN_.test(b[1]);
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(b ? a : goog.html.SafeUrl.INNOCUOUS_STRING);
+};
+goog.html.SAFE_URL_PATTERN_ = /^(?:(?:https?|mailto|ftp):|[^&:/?#]*(?:[/?#]|$))/i;
+goog.html.SafeUrl.sanitize = function(a) {
+  if (a instanceof goog.html.SafeUrl) {
+    return a;
+  }
+  a = a.implementsGoogStringTypedString ? a.getTypedStringValue() : String(a);
+  goog.html.SAFE_URL_PATTERN_.test(a) || (a = goog.html.SafeUrl.INNOCUOUS_STRING);
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(a);
+};
+goog.html.SafeUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse = function(a) {
+  var b = new goog.html.SafeUrl;
+  b.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = a;
+  return b;
+};
+goog.html.TrustedResourceUrl = function() {
+  this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ = "";
+  this.TRUSTED_RESOURCE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = goog.html.TrustedResourceUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+goog.html.TrustedResourceUrl.prototype.implementsGoogStringTypedString = !0;
+goog.html.TrustedResourceUrl.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_;
+};
+goog.html.TrustedResourceUrl.prototype.implementsGoogI18nBidiDirectionalString = !0;
+goog.html.TrustedResourceUrl.prototype.getDirection = function() {
+  return goog.i18n.bidi.Dir.LTR;
+};
+goog.DEBUG && (goog.html.TrustedResourceUrl.prototype.toString = function() {
+  return "TrustedResourceUrl{" + this.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ + "}";
+});
+goog.html.TrustedResourceUrl.unwrap = function(a) {
+  if (a instanceof goog.html.TrustedResourceUrl && a.constructor === goog.html.TrustedResourceUrl && a.TRUSTED_RESOURCE_URL_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ === goog.html.TrustedResourceUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return a.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_;
+  }
+  goog.asserts.fail("expected object of type TrustedResourceUrl, got '" + a + "'");
+  return "type_error:TrustedResourceUrl";
+};
+goog.html.TrustedResourceUrl.fromConstant = function(a) {
+  return goog.html.TrustedResourceUrl.createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse(goog.string.Const.unwrap(a));
+};
+goog.html.TrustedResourceUrl.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+goog.html.TrustedResourceUrl.createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse = function(a) {
+  var b = new goog.html.TrustedResourceUrl;
+  b.privateDoNotAccessOrElseTrustedResourceUrlWrappedValue_ = a;
+  return b;
+};
+goog.html.SafeHtml = function() {
+  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = "";
+  this.SAFE_HTML_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+  this.dir_ = null;
+};
+goog.html.SafeHtml.prototype.implementsGoogI18nBidiDirectionalString = !0;
+goog.html.SafeHtml.prototype.getDirection = function() {
+  return this.dir_;
+};
+goog.html.SafeHtml.prototype.implementsGoogStringTypedString = !0;
+goog.html.SafeHtml.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeHtmlWrappedValue_;
+};
+goog.DEBUG && (goog.html.SafeHtml.prototype.toString = function() {
+  return "SafeHtml{" + this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ + "}";
+});
+goog.html.SafeHtml.unwrap = function(a) {
+  if (a instanceof goog.html.SafeHtml && a.constructor === goog.html.SafeHtml && a.SAFE_HTML_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ === goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return a.privateDoNotAccessOrElseSafeHtmlWrappedValue_;
+  }
+  goog.asserts.fail("expected object of type SafeHtml, got '" + a + "'");
+  return "type_error:SafeHtml";
+};
+goog.html.SafeHtml.htmlEscape = function(a) {
+  if (a instanceof goog.html.SafeHtml) {
+    return a;
+  }
+  var b = null;
+  a.implementsGoogI18nBidiDirectionalString && (b = a.getDirection());
+  a = a.implementsGoogStringTypedString ? a.getTypedStringValue() : String(a);
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(goog.string.htmlEscape(a), b);
+};
+goog.html.SafeHtml.htmlEscapePreservingNewlines = function(a) {
+  if (a instanceof goog.html.SafeHtml) {
+    return a;
+  }
+  a = goog.html.SafeHtml.htmlEscape(a);
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(goog.string.newLineToBr(goog.html.SafeHtml.unwrap(a)), a.getDirection());
+};
+goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces = function(a) {
+  if (a instanceof goog.html.SafeHtml) {
+    return a;
+  }
+  a = goog.html.SafeHtml.htmlEscape(a);
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(goog.string.whitespaceEscape(goog.html.SafeHtml.unwrap(a)), a.getDirection());
+};
+goog.html.SafeHtml.from = goog.html.SafeHtml.htmlEscape;
+goog.html.SafeHtml.VALID_NAMES_IN_TAG_ = /^[a-zA-Z0-9-]+$/;
+goog.html.SafeHtml.URL_ATTRIBUTES_ = {action:!0, cite:!0, data:!0, formaction:!0, href:!0, manifest:!0, poster:!0, src:!0};
+goog.html.SafeHtml.NOT_ALLOWED_TAG_NAMES_ = goog.object.createSet(goog.dom.TagName.EMBED, goog.dom.TagName.IFRAME, goog.dom.TagName.LINK, goog.dom.TagName.OBJECT, goog.dom.TagName.SCRIPT, goog.dom.TagName.STYLE, goog.dom.TagName.TEMPLATE);
+goog.html.SafeHtml.create = function(a, b, c) {
+  if (!goog.html.SafeHtml.VALID_NAMES_IN_TAG_.test(a)) {
+    throw Error("Invalid tag name <" + a + ">.");
+  }
+  if (a.toUpperCase() in goog.html.SafeHtml.NOT_ALLOWED_TAG_NAMES_) {
+    throw Error("Tag name <" + a + "> is not allowed for SafeHtml.");
+  }
+  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse(a, b, c);
+};
+goog.html.SafeHtml.createIframe = function(a, b, c, d) {
+  var e = {};
+  e.src = a || null;
+  e.srcdoc = b || null;
+  a = goog.html.SafeHtml.combineAttributes(e, {sandbox:""}, c);
+  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse("iframe", a, d);
+};
+goog.html.SafeHtml.createStyle = function(a, b) {
+  var c = goog.html.SafeHtml.combineAttributes({type:"text/css"}, {}, b), d = "";
+  a = goog.array.concat(a);
+  for (var e = 0;e < a.length;e++) {
+    d += goog.html.SafeStyleSheet.unwrap(a[e]);
+  }
+  d = goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(d, goog.i18n.bidi.Dir.NEUTRAL);
+  return goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse("style", c, d);
+};
+goog.html.SafeHtml.getAttrNameAndValue_ = function(a, b, c) {
+  if (c instanceof goog.string.Const) {
+    c = goog.string.Const.unwrap(c);
+  } else {
+    if ("style" == b.toLowerCase()) {
+      c = goog.html.SafeHtml.getStyleValue_(c);
+    } else {
+      if (/^on/i.test(b)) {
+        throw Error('Attribute "' + b + '" requires goog.string.Const value, "' + c + '" given.');
+      }
+      if (b.toLowerCase() in goog.html.SafeHtml.URL_ATTRIBUTES_) {
+        if (c instanceof goog.html.TrustedResourceUrl) {
+          c = goog.html.TrustedResourceUrl.unwrap(c);
+        } else {
+          if (c instanceof goog.html.SafeUrl) {
+            c = goog.html.SafeUrl.unwrap(c);
+          } else {
+            if (goog.isString(c)) {
+              c = goog.html.SafeUrl.sanitize(c).getTypedStringValue();
+            } else {
+              throw Error('Attribute "' + b + '" on tag "' + a + '" requires goog.html.SafeUrl, goog.string.Const, or string, value "' + c + '" given.');
+            }
+          }
+        }
+      }
+    }
+  }
+  c.implementsGoogStringTypedString && (c = c.getTypedStringValue());
+  goog.asserts.assert(goog.isString(c) || goog.isNumber(c), "String or number value expected, got " + typeof c + " with value: " + c);
+  return b + '="' + goog.string.htmlEscape(String(c)) + '"';
+};
+goog.html.SafeHtml.getStyleValue_ = function(a) {
+  if (!goog.isObject(a)) {
+    throw Error('The "style" attribute requires goog.html.SafeStyle or map of style properties, ' + typeof a + " given: " + a);
+  }
+  a instanceof goog.html.SafeStyle || (a = goog.html.SafeStyle.create(a));
+  return goog.html.SafeStyle.unwrap(a);
+};
+goog.html.SafeHtml.createWithDir = function(a, b, c, d) {
+  b = goog.html.SafeHtml.create(b, c, d);
+  b.dir_ = a;
+  return b;
+};
+goog.html.SafeHtml.concat = function(a) {
+  var b = goog.i18n.bidi.Dir.NEUTRAL, c = "", d = function(a) {
+    goog.isArray(a) ? goog.array.forEach(a, d) : (a = goog.html.SafeHtml.htmlEscape(a), c += goog.html.SafeHtml.unwrap(a), a = a.getDirection(), b == goog.i18n.bidi.Dir.NEUTRAL ? b = a : a != goog.i18n.bidi.Dir.NEUTRAL && b != a && (b = null));
+  };
+  goog.array.forEach(arguments, d);
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(c, b);
+};
+goog.html.SafeHtml.concatWithDir = function(a, b) {
+  var c = goog.html.SafeHtml.concat(goog.array.slice(arguments, 1));
+  c.dir_ = a;
+  return c;
+};
+goog.html.SafeHtml.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse = function(a, b) {
+  return (new goog.html.SafeHtml).initSecurityPrivateDoNotAccessOrElse_(a, b);
+};
+goog.html.SafeHtml.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(a, b) {
+  this.privateDoNotAccessOrElseSafeHtmlWrappedValue_ = a;
+  this.dir_ = b;
+  return this;
+};
+goog.html.SafeHtml.createSafeHtmlTagSecurityPrivateDoNotAccessOrElse = function(a, b, c) {
+  var d = null, e = "<" + a;
+  if (b) {
+    for (var f in b) {
+      if (!goog.html.SafeHtml.VALID_NAMES_IN_TAG_.test(f)) {
+        throw Error('Invalid attribute name "' + f + '".');
+      }
+      var g = b[f];
+      goog.isDefAndNotNull(g) && (e += " " + goog.html.SafeHtml.getAttrNameAndValue_(a, f, g));
+    }
+  }
+  goog.isDefAndNotNull(c) ? goog.isArray(c) || (c = [c]) : c = [];
+  goog.dom.tags.isVoidTag(a.toLowerCase()) ? (goog.asserts.assert(!c.length, "Void tag <" + a + "> does not allow content."), e += ">") : (d = goog.html.SafeHtml.concat(c), e += ">" + goog.html.SafeHtml.unwrap(d) + "</" + a + ">", d = d.getDirection());
+  (a = b && b.dir) && (d = /^(ltr|rtl|auto)$/i.test(a) ? goog.i18n.bidi.Dir.NEUTRAL : null);
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(e, d);
+};
+goog.html.SafeHtml.combineAttributes = function(a, b, c) {
+  var d = {}, e;
+  for (e in a) {
+    goog.asserts.assert(e.toLowerCase() == e, "Must be lower case"), d[e] = a[e];
+  }
+  for (e in b) {
+    goog.asserts.assert(e.toLowerCase() == e, "Must be lower case"), d[e] = b[e];
+  }
+  for (e in c) {
+    var f = e.toLowerCase();
+    if (f in a) {
+      throw Error('Cannot override "' + f + '" attribute, got "' + e + '" with value "' + c[e] + '"');
+    }
+    f in b && delete d[f];
+    d[e] = c[e];
+  }
+  return d;
+};
+goog.html.SafeHtml.DOCTYPE_HTML = goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse("<!DOCTYPE html>", goog.i18n.bidi.Dir.NEUTRAL);
+goog.html.SafeHtml.EMPTY = goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse("", goog.i18n.bidi.Dir.NEUTRAL);
+goog.html.SafeScript = function() {
+  this.privateDoNotAccessOrElseSafeScriptWrappedValue_ = "";
+  this.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_;
+};
+goog.html.SafeScript.prototype.implementsGoogStringTypedString = !0;
+goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ = {};
+goog.html.SafeScript.fromConstant = function(a) {
+  a = goog.string.Const.unwrap(a);
+  return 0 === a.length ? goog.html.SafeScript.EMPTY : goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(a);
+};
+goog.html.SafeScript.prototype.getTypedStringValue = function() {
+  return this.privateDoNotAccessOrElseSafeScriptWrappedValue_;
+};
+goog.DEBUG && (goog.html.SafeScript.prototype.toString = function() {
+  return "SafeScript{" + this.privateDoNotAccessOrElseSafeScriptWrappedValue_ + "}";
+});
+goog.html.SafeScript.unwrap = function(a) {
+  if (a instanceof goog.html.SafeScript && a.constructor === goog.html.SafeScript && a.SAFE_SCRIPT_TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_ === goog.html.SafeScript.TYPE_MARKER_GOOG_HTML_SECURITY_PRIVATE_) {
+    return a.privateDoNotAccessOrElseSafeScriptWrappedValue_;
+  }
+  goog.asserts.fail("expected object of type SafeScript, got '" + a + "'");
+  return "type_error:SafeScript";
+};
+goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse = function(a) {
+  return (new goog.html.SafeScript).initSecurityPrivateDoNotAccessOrElse_(a);
+};
+goog.html.SafeScript.prototype.initSecurityPrivateDoNotAccessOrElse_ = function(a) {
+  this.privateDoNotAccessOrElseSafeScriptWrappedValue_ = a;
+  return this;
+};
+goog.html.SafeScript.EMPTY = goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse("");
+goog.html.uncheckedconversions = {};
+goog.html.uncheckedconversions.safeHtmlFromStringKnownToSatisfyTypeContract = function(a, b, c) {
+  goog.asserts.assertString(goog.string.Const.unwrap(a), "must provide justification");
+  goog.asserts.assert(!goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(a)), "must provide non-empty justification");
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(b, c || null);
+};
+goog.html.uncheckedconversions.safeScriptFromStringKnownToSatisfyTypeContract = function(a, b) {
+  goog.asserts.assertString(goog.string.Const.unwrap(a), "must provide justification");
+  goog.asserts.assert(!goog.string.isEmpty(goog.string.Const.unwrap(a)), "must provide non-empty justification");
+  return goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(b);
+};
+goog.html.uncheckedconversions.safeStyleFromStringKnownToSatisfyTypeContract = function(a, b) {
+  goog.asserts.assertString(goog.string.Const.unwrap(a), "must provide justification");
+  goog.asserts.assert(!goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(a)), "must provide non-empty justification");
+  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(b);
+};
+goog.html.uncheckedconversions.safeStyleSheetFromStringKnownToSatisfyTypeContract = function(a, b) {
+  goog.asserts.assertString(goog.string.Const.unwrap(a), "must provide justification");
+  goog.asserts.assert(!goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(a)), "must provide non-empty justification");
+  return goog.html.SafeStyleSheet.createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(b);
+};
+goog.html.uncheckedconversions.safeUrlFromStringKnownToSatisfyTypeContract = function(a, b) {
+  goog.asserts.assertString(goog.string.Const.unwrap(a), "must provide justification");
+  goog.asserts.assert(!goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(a)), "must provide non-empty justification");
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(b);
+};
+goog.html.uncheckedconversions.trustedResourceUrlFromStringKnownToSatisfyTypeContract = function(a, b) {
+  goog.asserts.assertString(goog.string.Const.unwrap(a), "must provide justification");
+  goog.asserts.assert(!goog.string.isEmptyOrWhitespace(goog.string.Const.unwrap(a)), "must provide non-empty justification");
+  return goog.html.TrustedResourceUrl.createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse(b);
+};
+goog.structs.Collection = function() {
+};
+goog.structs.Set = function(a) {
+  this.map_ = new goog.structs.Map;
+  a && this.addAll(a);
+};
+goog.structs.Set.getKey_ = function(a) {
+  var b = typeof a;
+  return "object" == b && a || "function" == b ? "o" + goog.getUid(a) : b.substr(0, 1) + a;
+};
+goog.structs.Set.prototype.getCount = function() {
+  return this.map_.getCount();
+};
+goog.structs.Set.prototype.add = function(a) {
+  this.map_.set(goog.structs.Set.getKey_(a), a);
+};
+goog.structs.Set.prototype.addAll = function(a) {
+  a = goog.structs.getValues(a);
+  for (var b = a.length, c = 0;c < b;c++) {
+    this.add(a[c]);
+  }
+};
+goog.structs.Set.prototype.removeAll = function(a) {
+  a = goog.structs.getValues(a);
+  for (var b = a.length, c = 0;c < b;c++) {
+    this.remove(a[c]);
+  }
+};
+goog.structs.Set.prototype.remove = function(a) {
+  return this.map_.remove(goog.structs.Set.getKey_(a));
+};
+goog.structs.Set.prototype.clear = function() {
+  this.map_.clear();
+};
+goog.structs.Set.prototype.isEmpty = function() {
+  return this.map_.isEmpty();
+};
+goog.structs.Set.prototype.contains = function(a) {
+  return this.map_.containsKey(goog.structs.Set.getKey_(a));
+};
+goog.structs.Set.prototype.containsAll = function(a) {
+  return goog.structs.every(a, this.contains, this);
+};
+goog.structs.Set.prototype.intersection = function(a) {
+  var b = new goog.structs.Set;
+  a = goog.structs.getValues(a);
+  for (var c = 0;c < a.length;c++) {
+    var d = a[c];
+    this.contains(d) && b.add(d);
+  }
+  return b;
+};
+goog.structs.Set.prototype.difference = function(a) {
+  var b = this.clone();
+  b.removeAll(a);
+  return b;
+};
+goog.structs.Set.prototype.getValues = function() {
+  return this.map_.getValues();
+};
+goog.structs.Set.prototype.clone = function() {
+  return new goog.structs.Set(this);
+};
+goog.structs.Set.prototype.equals = function(a) {
+  return this.getCount() == goog.structs.getCount(a) && this.isSubsetOf(a);
+};
+goog.structs.Set.prototype.isSubsetOf = function(a) {
+  var b = goog.structs.getCount(a);
+  if (this.getCount() > b) {
+    return !1;
+  }
+  !(a instanceof goog.structs.Set) && 5 < b && (a = new goog.structs.Set(a));
+  return goog.structs.every(this, function(b) {
+    return goog.structs.contains(a, b);
+  });
+};
+goog.structs.Set.prototype.__iterator__ = function(a) {
+  return this.map_.__iterator__(!1);
+};
+goog.labs = {};
+goog.labs.userAgent = {};
+goog.labs.userAgent.util = {};
+goog.labs.userAgent.util.getNativeUserAgentString_ = function() {
+  var a = goog.labs.userAgent.util.getNavigator_();
+  return a && (a = a.userAgent) ? a : "";
+};
+goog.labs.userAgent.util.getNavigator_ = function() {
+  return goog.global.navigator;
+};
+goog.labs.userAgent.util.userAgent_ = goog.labs.userAgent.util.getNativeUserAgentString_();
+goog.labs.userAgent.util.setUserAgent = function(a) {
+  goog.labs.userAgent.util.userAgent_ = a || goog.labs.userAgent.util.getNativeUserAgentString_();
+};
+goog.labs.userAgent.util.getUserAgent = function() {
+  return goog.labs.userAgent.util.userAgent_;
+};
+goog.labs.userAgent.util.matchUserAgent = function(a) {
+  var b = goog.labs.userAgent.util.getUserAgent();
+  return goog.string.contains(b, a);
+};
+goog.labs.userAgent.util.matchUserAgentIgnoreCase = function(a) {
+  var b = goog.labs.userAgent.util.getUserAgent();
+  return goog.string.caseInsensitiveContains(b, a);
+};
+goog.labs.userAgent.util.extractVersionTuples = function(a) {
+  for (var b = /(\w[\w ]+)\/([^\s]+)\s*(?:\((.*?)\))?/g, c = [], d;d = b.exec(a);) {
+    c.push([d[1], d[2], d[3] || void 0]);
+  }
+  return c;
+};
+goog.labs.userAgent.browser = {};
+goog.labs.userAgent.browser.matchOpera_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Opera") || goog.labs.userAgent.util.matchUserAgent("OPR");
+};
+goog.labs.userAgent.browser.matchIE_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Trident") || goog.labs.userAgent.util.matchUserAgent("MSIE");
+};
+goog.labs.userAgent.browser.matchEdge_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Edge");
+};
+goog.labs.userAgent.browser.matchFirefox_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Firefox");
+};
+goog.labs.userAgent.browser.matchSafari_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Safari") && !(goog.labs.userAgent.browser.matchChrome_() || goog.labs.userAgent.browser.matchCoast_() || goog.labs.userAgent.browser.matchOpera_() || goog.labs.userAgent.browser.matchEdge_() || goog.labs.userAgent.browser.isSilk() || goog.labs.userAgent.util.matchUserAgent("Android"));
+};
+goog.labs.userAgent.browser.matchCoast_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Coast");
+};
+goog.labs.userAgent.browser.matchIosWebview_ = function() {
+  return (goog.labs.userAgent.util.matchUserAgent("iPad") || goog.labs.userAgent.util.matchUserAgent("iPhone")) && !goog.labs.userAgent.browser.matchSafari_() && !goog.labs.userAgent.browser.matchChrome_() && !goog.labs.userAgent.browser.matchCoast_() && goog.labs.userAgent.util.matchUserAgent("AppleWebKit");
+};
+goog.labs.userAgent.browser.matchChrome_ = function() {
+  return (goog.labs.userAgent.util.matchUserAgent("Chrome") || goog.labs.userAgent.util.matchUserAgent("CriOS")) && !goog.labs.userAgent.browser.matchOpera_() && !goog.labs.userAgent.browser.matchEdge_();
+};
+goog.labs.userAgent.browser.matchAndroidBrowser_ = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Android") && !(goog.labs.userAgent.browser.isChrome() || goog.labs.userAgent.browser.isFirefox() || goog.labs.userAgent.browser.isOpera() || goog.labs.userAgent.browser.isSilk());
+};
+goog.labs.userAgent.browser.isOpera = goog.labs.userAgent.browser.matchOpera_;
+goog.labs.userAgent.browser.isIE = goog.labs.userAgent.browser.matchIE_;
+goog.labs.userAgent.browser.isEdge = goog.labs.userAgent.browser.matchEdge_;
+goog.labs.userAgent.browser.isFirefox = goog.labs.userAgent.browser.matchFirefox_;
+goog.labs.userAgent.browser.isSafari = goog.labs.userAgent.browser.matchSafari_;
+goog.labs.userAgent.browser.isCoast = goog.labs.userAgent.browser.matchCoast_;
+goog.labs.userAgent.browser.isIosWebview = goog.labs.userAgent.browser.matchIosWebview_;
+goog.labs.userAgent.browser.isChrome = goog.labs.userAgent.browser.matchChrome_;
+goog.labs.userAgent.browser.isAndroidBrowser = goog.labs.userAgent.browser.matchAndroidBrowser_;
+goog.labs.userAgent.browser.isSilk = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Silk");
+};
+goog.labs.userAgent.browser.getVersion = function() {
+  function a(a) {
+    a = goog.array.find(a, d);
+    return c[a] || "";
+  }
+  var b = goog.labs.userAgent.util.getUserAgent();
+  if (goog.labs.userAgent.browser.isIE()) {
+    return goog.labs.userAgent.browser.getIEVersion_(b);
+  }
+  var b = goog.labs.userAgent.util.extractVersionTuples(b), c = {};
+  goog.array.forEach(b, function(a) {
+    c[a[0]] = a[1];
+  });
+  var d = goog.partial(goog.object.containsKey, c);
+  return goog.labs.userAgent.browser.isOpera() ? a(["Version", "Opera", "OPR"]) : goog.labs.userAgent.browser.isEdge() ? a(["Edge"]) : goog.labs.userAgent.browser.isChrome() ? a(["Chrome", "CriOS"]) : (b = b[2]) && b[1] || "";
+};
+goog.labs.userAgent.browser.isVersionOrHigher = function(a) {
+  return 0 <= goog.string.compareVersions(goog.labs.userAgent.browser.getVersion(), a);
+};
+goog.labs.userAgent.browser.getIEVersion_ = function(a) {
+  var b = /rv: *([\d\.]*)/.exec(a);
+  if (b && b[1]) {
+    return b[1];
+  }
+  var b = "", c = /MSIE +([\d\.]+)/.exec(a);
+  if (c && c[1]) {
+    if (a = /Trident\/(\d.\d)/.exec(a), "7.0" == c[1]) {
+      if (a && a[1]) {
+        switch(a[1]) {
+          case "4.0":
+            b = "8.0";
+            break;
+          case "5.0":
+            b = "9.0";
+            break;
+          case "6.0":
+            b = "10.0";
+            break;
+          case "7.0":
+            b = "11.0";
+        }
+      } else {
+        b = "7.0";
+      }
+    } else {
+      b = c[1];
+    }
+  }
+  return b;
+};
+goog.labs.userAgent.engine = {};
+goog.labs.userAgent.engine.isPresto = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Presto");
+};
+goog.labs.userAgent.engine.isTrident = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Trident") || goog.labs.userAgent.util.matchUserAgent("MSIE");
+};
+goog.labs.userAgent.engine.isEdge = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Edge");
+};
+goog.labs.userAgent.engine.isWebKit = function() {
+  return goog.labs.userAgent.util.matchUserAgentIgnoreCase("WebKit") && !goog.labs.userAgent.engine.isEdge();
+};
+goog.labs.userAgent.engine.isGecko = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Gecko") && !goog.labs.userAgent.engine.isWebKit() && !goog.labs.userAgent.engine.isTrident() && !goog.labs.userAgent.engine.isEdge();
+};
+goog.labs.userAgent.engine.getVersion = function() {
+  var a = goog.labs.userAgent.util.getUserAgent();
+  if (a) {
+    var a = goog.labs.userAgent.util.extractVersionTuples(a), b = goog.labs.userAgent.engine.getEngineTuple_(a);
+    if (b) {
+      return "Gecko" == b[0] ? goog.labs.userAgent.engine.getVersionForKey_(a, "Firefox") : b[1];
+    }
+    var a = a[0], c;
+    if (a && (c = a[2]) && (c = /Trident\/([^\s;]+)/.exec(c))) {
+      return c[1];
+    }
+  }
+  return "";
+};
+goog.labs.userAgent.engine.getEngineTuple_ = function(a) {
+  if (!goog.labs.userAgent.engine.isEdge()) {
+    return a[1];
+  }
+  for (var b = 0;b < a.length;b++) {
+    var c = a[b];
+    if ("Edge" == c[0]) {
+      return c;
+    }
+  }
+};
+goog.labs.userAgent.engine.isVersionOrHigher = function(a) {
+  return 0 <= goog.string.compareVersions(goog.labs.userAgent.engine.getVersion(), a);
+};
+goog.labs.userAgent.engine.getVersionForKey_ = function(a, b) {
+  var c = goog.array.find(a, function(a) {
+    return b == a[0];
+  });
+  return c && c[1] || "";
+};
+goog.labs.userAgent.platform = {};
+goog.labs.userAgent.platform.isAndroid = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Android");
+};
+goog.labs.userAgent.platform.isIpod = function() {
+  return goog.labs.userAgent.util.matchUserAgent("iPod");
+};
+goog.labs.userAgent.platform.isIphone = function() {
+  return goog.labs.userAgent.util.matchUserAgent("iPhone") && !goog.labs.userAgent.util.matchUserAgent("iPod") && !goog.labs.userAgent.util.matchUserAgent("iPad");
+};
+goog.labs.userAgent.platform.isIpad = function() {
+  return goog.labs.userAgent.util.matchUserAgent("iPad");
+};
+goog.labs.userAgent.platform.isIos = function() {
+  return goog.labs.userAgent.platform.isIphone() || goog.labs.userAgent.platform.isIpad() || goog.labs.userAgent.platform.isIpod();
+};
+goog.labs.userAgent.platform.isMacintosh = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Macintosh");
+};
+goog.labs.userAgent.platform.isLinux = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Linux");
+};
+goog.labs.userAgent.platform.isWindows = function() {
+  return goog.labs.userAgent.util.matchUserAgent("Windows");
+};
+goog.labs.userAgent.platform.isChromeOS = function() {
+  return goog.labs.userAgent.util.matchUserAgent("CrOS");
+};
+goog.labs.userAgent.platform.getVersion = function() {
+  var a = goog.labs.userAgent.util.getUserAgent(), b = "";
+  goog.labs.userAgent.platform.isWindows() ? (b = /Windows (?:NT|Phone) ([0-9.]+)/, b = (a = b.exec(a)) ? a[1] : "0.0") : goog.labs.userAgent.platform.isIos() ? (b = /(?:iPhone|iPod|iPad|CPU)\s+OS\s+(\S+)/, b = (a = b.exec(a)) && a[1].replace(/_/g, ".")) : goog.labs.userAgent.platform.isMacintosh() ? (b = /Mac OS X ([0-9_.]+)/, b = (a = b.exec(a)) ? a[1].replace(/_/g, ".") : "10") : goog.labs.userAgent.platform.isAndroid() ? (b = /Android\s+([^\);]+)(\)|;)/, b = (a = b.exec(a)) && a[1]) : goog.labs.userAgent.platform.isChromeOS() && 
+  (b = /(?:CrOS\s+(?:i686|x86_64)\s+([0-9.]+))/, b = (a = b.exec(a)) && a[1]);
+  return b || "";
+};
+goog.labs.userAgent.platform.isVersionOrHigher = function(a) {
+  return 0 <= goog.string.compareVersions(goog.labs.userAgent.platform.getVersion(), a);
+};
+goog.userAgent = {};
+goog.userAgent.ASSUME_IE = !1;
+goog.userAgent.ASSUME_EDGE = !1;
+goog.userAgent.ASSUME_GECKO = !1;
+goog.userAgent.ASSUME_WEBKIT = !0;
+goog.userAgent.ASSUME_MOBILE_WEBKIT = !1;
+goog.userAgent.ASSUME_OPERA = !1;
+goog.userAgent.ASSUME_ANY_VERSION = !1;
+goog.userAgent.BROWSER_KNOWN_ = goog.userAgent.ASSUME_IE || goog.userAgent.ASSUME_EDGE || goog.userAgent.ASSUME_GECKO || goog.userAgent.ASSUME_MOBILE_WEBKIT || goog.userAgent.ASSUME_WEBKIT || goog.userAgent.ASSUME_OPERA;
+goog.userAgent.getUserAgentString = function() {
+  return goog.labs.userAgent.util.getUserAgent();
+};
+goog.userAgent.getNavigator = function() {
+  return goog.global.navigator || null;
+};
+goog.userAgent.OPERA = goog.userAgent.BROWSER_KNOWN_ ? goog.userAgent.ASSUME_OPERA : goog.labs.userAgent.browser.isOpera();
+goog.userAgent.IE = goog.userAgent.BROWSER_KNOWN_ ? goog.userAgent.ASSUME_IE : goog.labs.userAgent.browser.isIE();
+goog.userAgent.EDGE = goog.userAgent.BROWSER_KNOWN_ ? goog.userAgent.ASSUME_EDGE : goog.labs.userAgent.engine.isEdge();
+goog.userAgent.EDGE_OR_IE = goog.userAgent.EDGE || goog.userAgent.IE;
+goog.userAgent.GECKO = goog.userAgent.BROWSER_KNOWN_ ? goog.userAgent.ASSUME_GECKO : goog.labs.userAgent.engine.isGecko();
+goog.userAgent.WEBKIT = goog.userAgent.BROWSER_KNOWN_ ? goog.userAgent.ASSUME_WEBKIT || goog.userAgent.ASSUME_MOBILE_WEBKIT : goog.labs.userAgent.engine.isWebKit();
+goog.userAgent.isMobile_ = function() {
+  return goog.userAgent.WEBKIT && goog.labs.userAgent.util.matchUserAgent("Mobile");
+};
+goog.userAgent.MOBILE = goog.userAgent.ASSUME_MOBILE_WEBKIT || goog.userAgent.isMobile_();
+goog.userAgent.SAFARI = goog.userAgent.WEBKIT;
+goog.userAgent.determinePlatform_ = function() {
+  var a = goog.userAgent.getNavigator();
+  return a && a.platform || "";
+};
+goog.userAgent.PLATFORM = goog.userAgent.determinePlatform_();
+goog.userAgent.ASSUME_MAC = !1;
+goog.userAgent.ASSUME_WINDOWS = !1;
+goog.userAgent.ASSUME_LINUX = !1;
+goog.userAgent.ASSUME_X11 = !1;
+goog.userAgent.ASSUME_ANDROID = !1;
+goog.userAgent.ASSUME_IPHONE = !1;
+goog.userAgent.ASSUME_IPAD = !1;
+goog.userAgent.PLATFORM_KNOWN_ = goog.userAgent.ASSUME_MAC || goog.userAgent.ASSUME_WINDOWS || goog.userAgent.ASSUME_LINUX || goog.userAgent.ASSUME_X11 || goog.userAgent.ASSUME_ANDROID || goog.userAgent.ASSUME_IPHONE || goog.userAgent.ASSUME_IPAD;
+goog.userAgent.MAC = goog.userAgent.PLATFORM_KNOWN_ ? goog.userAgent.ASSUME_MAC : goog.labs.userAgent.platform.isMacintosh();
+goog.userAgent.WINDOWS = goog.userAgent.PLATFORM_KNOWN_ ? goog.userAgent.ASSUME_WINDOWS : goog.labs.userAgent.platform.isWindows();
+goog.userAgent.isLegacyLinux_ = function() {
+  return goog.labs.userAgent.platform.isLinux() || goog.labs.userAgent.platform.isChromeOS();
+};
+goog.userAgent.LINUX = goog.userAgent.PLATFORM_KNOWN_ ? goog.userAgent.ASSUME_LINUX : goog.userAgent.isLegacyLinux_();
+goog.userAgent.isX11_ = function() {
+  var a = goog.userAgent.getNavigator();
+  return !!a && goog.string.contains(a.appVersion || "", "X11");
+};
+goog.userAgent.X11 = goog.userAgent.PLATFORM_KNOWN_ ? goog.userAgent.ASSUME_X11 : goog.userAgent.isX11_();
+goog.userAgent.ANDROID = goog.userAgent.PLATFORM_KNOWN_ ? goog.userAgent.ASSUME_ANDROID : goog.labs.userAgent.platform.isAndroid();
+goog.userAgent.IPHONE = goog.userAgent.PLATFORM_KNOWN_ ? goog.userAgent.ASSUME_IPHONE : goog.labs.userAgent.platform.isIphone();
+goog.userAgent.IPAD = goog.userAgent.PLATFORM_KNOWN_ ? goog.userAgent.ASSUME_IPAD : goog.labs.userAgent.platform.isIpad();
+goog.userAgent.operaVersion_ = function() {
+  var a = goog.global.opera.version;
+  try {
+    return a();
+  } catch (b) {
+    return a;
+  }
+};
+goog.userAgent.determineVersion_ = function() {
+  if (goog.userAgent.OPERA && goog.global.opera) {
+    return goog.userAgent.operaVersion_();
+  }
+  var a = "", b = goog.userAgent.getVersionRegexResult_();
+  b && (a = b ? b[1] : "");
+  return goog.userAgent.IE && (b = goog.userAgent.getDocumentMode_(), b > parseFloat(a)) ? String(b) : a;
+};
+goog.userAgent.getVersionRegexResult_ = function() {
+  var a = goog.userAgent.getUserAgentString();
+  if (goog.userAgent.GECKO) {
+    return /rv\:([^\);]+)(\)|;)/.exec(a);
+  }
+  if (goog.userAgent.EDGE) {
+    return /Edge\/([\d\.]+)/.exec(a);
+  }
+  if (goog.userAgent.IE) {
+    return /\b(?:MSIE|rv)[: ]([^\);]+)(\)|;)/.exec(a);
+  }
+  if (goog.userAgent.WEBKIT) {
+    return /WebKit\/(\S+)/.exec(a);
+  }
+};
+goog.userAgent.getDocumentMode_ = function() {
+  var a = goog.global.document;
+  return a ? a.documentMode : void 0;
+};
+goog.userAgent.VERSION = goog.userAgent.determineVersion_();
+goog.userAgent.compare = function(a, b) {
+  return goog.string.compareVersions(a, b);
+};
+goog.userAgent.isVersionOrHigherCache_ = {};
+goog.userAgent.isVersionOrHigher = function(a) {
+  return goog.userAgent.ASSUME_ANY_VERSION || goog.userAgent.isVersionOrHigherCache_[a] || (goog.userAgent.isVersionOrHigherCache_[a] = 0 <= goog.string.compareVersions(goog.userAgent.VERSION, a));
+};
+goog.userAgent.isVersion = goog.userAgent.isVersionOrHigher;
+goog.userAgent.isDocumentModeOrHigher = function(a) {
+  return goog.userAgent.DOCUMENT_MODE >= a;
+};
+goog.userAgent.isDocumentMode = goog.userAgent.isDocumentModeOrHigher;
+goog.userAgent.DOCUMENT_MODE = function() {
+  var a = goog.global.document, b = goog.userAgent.getDocumentMode_();
+  return a && goog.userAgent.IE ? b || ("CSS1Compat" == a.compatMode ? parseInt(goog.userAgent.VERSION, 10) : 5) : void 0;
+}();
+goog.debug.LOGGING_ENABLED = goog.DEBUG;
+goog.debug.catchErrors = function(a, b, c) {
+  c = c || goog.global;
+  var d = c.onerror, e = !!b;
+  goog.userAgent.WEBKIT && !goog.userAgent.isVersionOrHigher("535.3") && (e = !e);
+  c.onerror = function(b, c, h, k, l) {
+    d && d(b, c, h, k, l);
+    a({message:b, fileName:c, line:h, col:k, error:l});
+    return e;
+  };
+};
+goog.debug.expose = function(a, b) {
+  if ("undefined" == typeof a) {
+    return "undefined";
+  }
+  if (null == a) {
+    return "NULL";
+  }
+  var c = [], d;
+  for (d in a) {
+    if (b || !goog.isFunction(a[d])) {
+      var e = d + " = ";
+      try {
+        e += a[d];
+      } catch (f) {
+        e += "*** " + f + " ***";
+      }
+      c.push(e);
+    }
+  }
+  return c.join("\n");
+};
+goog.debug.deepExpose = function(a, b) {
+  var c = [], d = function(a, f, g) {
+    var h = f + "  ";
+    g = new goog.structs.Set(g);
+    try {
+      if (goog.isDef(a)) {
+        if (goog.isNull(a)) {
+          c.push("NULL");
+        } else {
+          if (goog.isString(a)) {
+            c.push('"' + a.replace(/\n/g, "\n" + f) + '"');
+          } else {
+            if (goog.isFunction(a)) {
+              c.push(String(a).replace(/\n/g, "\n" + f));
+            } else {
+              if (goog.isObject(a)) {
+                if (g.contains(a)) {
+                  c.push("*** reference loop detected ***");
+                } else {
+                  g.add(a);
+                  c.push("{");
+                  for (var k in a) {
+                    if (b || !goog.isFunction(a[k])) {
+                      c.push("\n"), c.push(h), c.push(k + " = "), d(a[k], h, g);
+                    }
+                  }
+                  c.push("\n" + f + "}");
+                }
+              } else {
+                c.push(a);
+              }
+            }
+          }
+        }
+      } else {
+        c.push("undefined");
+      }
+    } catch (l) {
+      c.push("*** " + l + " ***");
+    }
+  };
+  d(a, "", new goog.structs.Set);
+  return c.join("");
+};
+goog.debug.exposeArray = function(a) {
+  for (var b = [], c = 0;c < a.length;c++) {
+    goog.isArray(a[c]) ? b.push(goog.debug.exposeArray(a[c])) : b.push(a[c]);
+  }
+  return "[ " + b.join(", ") + " ]";
+};
+goog.debug.exposeException = function(a, b) {
+  var c = goog.debug.exposeExceptionAsHtml(a, b);
+  return goog.html.SafeHtml.unwrap(c);
+};
+goog.debug.exposeExceptionAsHtml = function(a, b) {
+  try {
+    var c = goog.debug.normalizeErrorObject(a), d = goog.debug.createViewSourceUrl_(c.fileName);
+    return goog.html.SafeHtml.concat(goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces("Message: " + c.message + "\nUrl: "), goog.html.SafeHtml.create("a", {href:d, target:"_new"}, c.fileName), goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces("\nLine: " + c.lineNumber + "\n\nBrowser stack:\n" + c.stack + "-> [end]\n\nJS stack traversal:\n" + goog.debug.getStacktrace(b) + "-> "));
+  } catch (e) {
+    return goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces("Exception trying to expose exception! You win, we lose. " + e);
+  }
+};
+goog.debug.createViewSourceUrl_ = function(a) {
+  goog.isDefAndNotNull(a) || (a = "");
+  if (!/^https?:\/\//i.test(a)) {
+    return goog.html.SafeUrl.fromConstant(goog.string.Const.from("sanitizedviewsrc"));
+  }
+  a = goog.html.SafeUrl.sanitize(a);
+  return goog.html.uncheckedconversions.safeUrlFromStringKnownToSatisfyTypeContract(goog.string.Const.from("view-source scheme plus HTTP/HTTPS URL"), "view-source:" + goog.html.SafeUrl.unwrap(a));
+};
+goog.debug.normalizeErrorObject = function(a) {
+  var b = goog.getObjectByName("window.location.href");
+  if (goog.isString(a)) {
+    return {message:a, name:"Unknown error", lineNumber:"Not available", fileName:b, stack:"Not available"};
+  }
+  var c, d, e = !1;
+  try {
+    c = a.lineNumber || a.line || "Not available";
+  } catch (f) {
+    c = "Not available", e = !0;
+  }
+  try {
+    d = a.fileName || a.filename || a.sourceURL || goog.global.$googDebugFname || b;
+  } catch (f) {
+    d = "Not available", e = !0;
+  }
+  return !e && a.lineNumber && a.fileName && a.stack && a.message && a.name ? a : {message:a.message || "Not available", name:a.name || "UnknownError", lineNumber:c, fileName:d, stack:a.stack || "Not available"};
+};
+goog.debug.enhanceError = function(a, b) {
+  var c;
+  "string" == typeof a ? (c = Error(a), Error.captureStackTrace && Error.captureStackTrace(c, goog.debug.enhanceError)) : c = a;
+  c.stack || (c.stack = goog.debug.getStacktrace(goog.debug.enhanceError));
+  if (b) {
+    for (var d = 0;c["message" + d];) {
+      ++d;
+    }
+    c["message" + d] = String(b);
+  }
+  return c;
+};
+goog.debug.getStacktraceSimple = function(a) {
+  if (goog.STRICT_MODE_COMPATIBLE) {
+    var b = goog.debug.getNativeStackTrace_(goog.debug.getStacktraceSimple);
+    if (b) {
+      return b;
+    }
+  }
+  for (var b = [], c = arguments.callee.caller, d = 0;c && (!a || d < a);) {
+    b.push(goog.debug.getFunctionName(c));
+    b.push("()\n");
+    try {
+      c = c.caller;
+    } catch (e) {
+      b.push("[exception trying to get caller]\n");
+      break;
+    }
+    d++;
+    if (d >= goog.debug.MAX_STACK_DEPTH) {
+      b.push("[...long stack...]");
+      break;
+    }
+  }
+  a && d >= a ? b.push("[...reached max depth limit...]") : b.push("[end]");
+  return b.join("");
+};
+goog.debug.MAX_STACK_DEPTH = 50;
+goog.debug.getNativeStackTrace_ = function(a) {
+  var b = Error();
+  if (Error.captureStackTrace) {
+    return Error.captureStackTrace(b, a), String(b.stack);
+  }
+  try {
+    throw b;
+  } catch (c) {
+    b = c;
+  }
+  return (a = b.stack) ? String(a) : null;
+};
+goog.debug.getStacktrace = function(a) {
+  var b;
+  goog.STRICT_MODE_COMPATIBLE && (b = goog.debug.getNativeStackTrace_(a || goog.debug.getStacktrace));
+  b || (b = goog.debug.getStacktraceHelper_(a || arguments.callee.caller, []));
+  return b;
+};
+goog.debug.getStacktraceHelper_ = function(a, b) {
+  var c = [];
+  if (goog.array.contains(b, a)) {
+    c.push("[...circular reference...]");
+  } else {
+    if (a && b.length < goog.debug.MAX_STACK_DEPTH) {
+      c.push(goog.debug.getFunctionName(a) + "(");
+      for (var d = a.arguments, e = 0;d && e < d.length;e++) {
+        0 < e && c.push(", ");
+        var f;
+        f = d[e];
+        switch(typeof f) {
+          case "object":
+            f = f ? "object" : "null";
+            break;
+          case "string":
+            break;
+          case "number":
+            f = String(f);
+            break;
+          case "boolean":
+            f = f ? "true" : "false";
+            break;
+          case "function":
+            f = (f = goog.debug.getFunctionName(f)) ? f : "[fn]";
+            break;
+          default:
+            f = typeof f;
+        }
+        40 < f.length && (f = f.substr(0, 40) + "...");
+        c.push(f);
+      }
+      b.push(a);
+      c.push(")\n");
+      try {
+        c.push(goog.debug.getStacktraceHelper_(a.caller, b));
+      } catch (g) {
+        c.push("[exception trying to get caller]\n");
+      }
+    } else {
+      a ? c.push("[...long stack...]") : c.push("[end]");
+    }
+  }
+  return c.join("");
+};
+goog.debug.setFunctionResolver = function(a) {
+  goog.debug.fnNameResolver_ = a;
+};
+goog.debug.getFunctionName = function(a) {
+  if (goog.debug.fnNameCache_[a]) {
+    return goog.debug.fnNameCache_[a];
+  }
+  if (goog.debug.fnNameResolver_) {
+    var b = goog.debug.fnNameResolver_(a);
+    if (b) {
+      return goog.debug.fnNameCache_[a] = b;
+    }
+  }
+  a = String(a);
+  goog.debug.fnNameCache_[a] || (b = /function ([^\(]+)/.exec(a), goog.debug.fnNameCache_[a] = b ? b[1] : "[Anonymous]");
+  return goog.debug.fnNameCache_[a];
+};
+goog.debug.makeWhitespaceVisible = function(a) {
+  return a.replace(/ /g, "[_]").replace(/\f/g, "[f]").replace(/\n/g, "[n]\n").replace(/\r/g, "[r]").replace(/\t/g, "[t]");
+};
+goog.debug.runtimeType = function(a) {
+  return a instanceof Function ? a.displayName || a.name || "unknown type name" : a instanceof Object ? a.constructor.displayName || a.constructor.name || Object.prototype.toString.call(a) : null === a ? "null" : typeof a;
+};
+goog.debug.fnNameCache_ = {};
+goog.debug.LogRecord = function(a, b, c, d, e) {
+  this.reset(a, b, c, d, e);
+};
+goog.debug.LogRecord.prototype.sequenceNumber_ = 0;
+goog.debug.LogRecord.prototype.exception_ = null;
+goog.debug.LogRecord.ENABLE_SEQUENCE_NUMBERS = !0;
+goog.debug.LogRecord.nextSequenceNumber_ = 0;
+goog.debug.LogRecord.prototype.reset = function(a, b, c, d, e) {
+  goog.debug.LogRecord.ENABLE_SEQUENCE_NUMBERS && (this.sequenceNumber_ = "number" == typeof e ? e : goog.debug.LogRecord.nextSequenceNumber_++);
+  this.time_ = d || goog.now();
+  this.level_ = a;
+  this.msg_ = b;
+  this.loggerName_ = c;
+  delete this.exception_;
+};
+goog.debug.LogRecord.prototype.getLoggerName = function() {
+  return this.loggerName_;
+};
+goog.debug.LogRecord.prototype.getException = function() {
+  return this.exception_;
+};
+goog.debug.LogRecord.prototype.setException = function(a) {
+  this.exception_ = a;
+};
+goog.debug.LogRecord.prototype.setLoggerName = function(a) {
+  this.loggerName_ = a;
+};
+goog.debug.LogRecord.prototype.getLevel = function() {
+  return this.level_;
+};
+goog.debug.LogRecord.prototype.setLevel = function(a) {
+  this.level_ = a;
+};
+goog.debug.LogRecord.prototype.getMessage = function() {
+  return this.msg_;
+};
+goog.debug.LogRecord.prototype.setMessage = function(a) {
+  this.msg_ = a;
+};
+goog.debug.LogRecord.prototype.getMillis = function() {
+  return this.time_;
+};
+goog.debug.LogRecord.prototype.setMillis = function(a) {
+  this.time_ = a;
+};
+goog.debug.LogRecord.prototype.getSequenceNumber = function() {
+  return this.sequenceNumber_;
+};
+goog.debug.LogBuffer = function() {
+  goog.asserts.assert(goog.debug.LogBuffer.isBufferingEnabled(), "Cannot use goog.debug.LogBuffer without defining goog.debug.LogBuffer.CAPACITY.");
+  this.clear();
+};
+goog.debug.LogBuffer.getInstance = function() {
+  goog.debug.LogBuffer.instance_ || (goog.debug.LogBuffer.instance_ = new goog.debug.LogBuffer);
+  return goog.debug.LogBuffer.instance_;
+};
+goog.debug.LogBuffer.CAPACITY = 0;
+goog.debug.LogBuffer.prototype.addRecord = function(a, b, c) {
+  var d = (this.curIndex_ + 1) % goog.debug.LogBuffer.CAPACITY;
+  this.curIndex_ = d;
+  if (this.isFull_) {
+    return d = this.buffer_[d], d.reset(a, b, c), d;
+  }
+  this.isFull_ = d == goog.debug.LogBuffer.CAPACITY - 1;
+  return this.buffer_[d] = new goog.debug.LogRecord(a, b, c);
+};
+goog.debug.LogBuffer.isBufferingEnabled = function() {
+  return 0 < goog.debug.LogBuffer.CAPACITY;
+};
+goog.debug.LogBuffer.prototype.clear = function() {
+  this.buffer_ = Array(goog.debug.LogBuffer.CAPACITY);
+  this.curIndex_ = -1;
+  this.isFull_ = !1;
+};
+goog.debug.LogBuffer.prototype.forEachRecord = function(a) {
+  var b = this.buffer_;
+  if (b[0]) {
+    var c = this.curIndex_, d = this.isFull_ ? c : -1;
+    do {
+      d = (d + 1) % goog.debug.LogBuffer.CAPACITY, a(b[d]);
+    } while (d != c);
+  }
+};
+goog.debug.Logger = function(a) {
+  this.name_ = a;
+  this.handlers_ = this.children_ = this.level_ = this.parent_ = null;
+};
+goog.debug.Logger.ROOT_LOGGER_NAME = "";
+goog.debug.Logger.ENABLE_HIERARCHY = !0;
+goog.debug.Logger.ENABLE_HIERARCHY || (goog.debug.Logger.rootHandlers_ = []);
+goog.debug.Logger.Level = function(a, b) {
+  this.name = a;
+  this.value = b;
+};
+goog.debug.Logger.Level.prototype.toString = function() {
+  return this.name;
+};
+goog.debug.Logger.Level.OFF = new goog.debug.Logger.Level("OFF", Infinity);
+goog.debug.Logger.Level.SHOUT = new goog.debug.Logger.Level("SHOUT", 1200);
+goog.debug.Logger.Level.SEVERE = new goog.debug.Logger.Level("SEVERE", 1E3);
+goog.debug.Logger.Level.WARNING = new goog.debug.Logger.Level("WARNING", 900);
+goog.debug.Logger.Level.INFO = new goog.debug.Logger.Level("INFO", 800);
+goog.debug.Logger.Level.CONFIG = new goog.debug.Logger.Level("CONFIG", 700);
+goog.debug.Logger.Level.FINE = new goog.debug.Logger.Level("FINE", 500);
+goog.debug.Logger.Level.FINER = new goog.debug.Logger.Level("FINER", 400);
+goog.debug.Logger.Level.FINEST = new goog.debug.Logger.Level("FINEST", 300);
+goog.debug.Logger.Level.ALL = new goog.debug.Logger.Level("ALL", 0);
+goog.debug.Logger.Level.PREDEFINED_LEVELS = [goog.debug.Logger.Level.OFF, goog.debug.Logger.Level.SHOUT, goog.debug.Logger.Level.SEVERE, goog.debug.Logger.Level.WARNING, goog.debug.Logger.Level.INFO, goog.debug.Logger.Level.CONFIG, goog.debug.Logger.Level.FINE, goog.debug.Logger.Level.FINER, goog.debug.Logger.Level.FINEST, goog.debug.Logger.Level.ALL];
+goog.debug.Logger.Level.predefinedLevelsCache_ = null;
+goog.debug.Logger.Level.createPredefinedLevelsCache_ = function() {
+  goog.debug.Logger.Level.predefinedLevelsCache_ = {};
+  for (var a = 0, b;b = goog.debug.Logger.Level.PREDEFINED_LEVELS[a];a++) {
+    goog.debug.Logger.Level.predefinedLevelsCache_[b.value] = b, goog.debug.Logger.Level.predefinedLevelsCache_[b.name] = b;
+  }
+};
+goog.debug.Logger.Level.getPredefinedLevel = function(a) {
+  goog.debug.Logger.Level.predefinedLevelsCache_ || goog.debug.Logger.Level.createPredefinedLevelsCache_();
+  return goog.debug.Logger.Level.predefinedLevelsCache_[a] || null;
+};
+goog.debug.Logger.Level.getPredefinedLevelByValue = function(a) {
+  goog.debug.Logger.Level.predefinedLevelsCache_ || goog.debug.Logger.Level.createPredefinedLevelsCache_();
+  if (a in goog.debug.Logger.Level.predefinedLevelsCache_) {
+    return goog.debug.Logger.Level.predefinedLevelsCache_[a];
+  }
+  for (var b = 0;b < goog.debug.Logger.Level.PREDEFINED_LEVELS.length;++b) {
+    var c = goog.debug.Logger.Level.PREDEFINED_LEVELS[b];
+    if (c.value <= a) {
+      return c;
+    }
+  }
+  return null;
+};
+goog.debug.Logger.getLogger = function(a) {
+  return goog.debug.LogManager.getLogger(a);
+};
+goog.debug.Logger.logToProfilers = function(a) {
+  goog.global.console && (goog.global.console.timeStamp ? goog.global.console.timeStamp(a) : goog.global.console.markTimeline && goog.global.console.markTimeline(a));
+  goog.global.msWriteProfilerMark && goog.global.msWriteProfilerMark(a);
+};
+goog.debug.Logger.prototype.getName = function() {
+  return this.name_;
+};
+goog.debug.Logger.prototype.addHandler = function(a) {
+  goog.debug.LOGGING_ENABLED && (goog.debug.Logger.ENABLE_HIERARCHY ? (this.handlers_ || (this.handlers_ = []), this.handlers_.push(a)) : (goog.asserts.assert(!this.name_, "Cannot call addHandler on a non-root logger when goog.debug.Logger.ENABLE_HIERARCHY is false."), goog.debug.Logger.rootHandlers_.push(a)));
+};
+goog.debug.Logger.prototype.removeHandler = function(a) {
+  if (goog.debug.LOGGING_ENABLED) {
+    var b = goog.debug.Logger.ENABLE_HIERARCHY ? this.handlers_ : goog.debug.Logger.rootHandlers_;
+    return !!b && goog.array.remove(b, a);
+  }
+  return !1;
+};
+goog.debug.Logger.prototype.getParent = function() {
+  return this.parent_;
+};
+goog.debug.Logger.prototype.getChildren = function() {
+  this.children_ || (this.children_ = {});
+  return this.children_;
+};
+goog.debug.Logger.prototype.setLevel = function(a) {
+  goog.debug.LOGGING_ENABLED && (goog.debug.Logger.ENABLE_HIERARCHY ? this.level_ = a : (goog.asserts.assert(!this.name_, "Cannot call setLevel() on a non-root logger when goog.debug.Logger.ENABLE_HIERARCHY is false."), goog.debug.Logger.rootLevel_ = a));
+};
+goog.debug.Logger.prototype.getLevel = function() {
+  return goog.debug.LOGGING_ENABLED ? this.level_ : goog.debug.Logger.Level.OFF;
+};
+goog.debug.Logger.prototype.getEffectiveLevel = function() {
+  if (!goog.debug.LOGGING_ENABLED) {
+    return goog.debug.Logger.Level.OFF;
+  }
+  if (!goog.debug.Logger.ENABLE_HIERARCHY) {
+    return goog.debug.Logger.rootLevel_;
+  }
+  if (this.level_) {
+    return this.level_;
+  }
+  if (this.parent_) {
+    return this.parent_.getEffectiveLevel();
+  }
+  goog.asserts.fail("Root logger has no level set.");
+  return null;
+};
+goog.debug.Logger.prototype.isLoggable = function(a) {
+  return goog.debug.LOGGING_ENABLED && a.value >= this.getEffectiveLevel().value;
+};
+goog.debug.Logger.prototype.log = function(a, b, c) {
+  goog.debug.LOGGING_ENABLED && this.isLoggable(a) && (goog.isFunction(b) && (b = b()), this.doLogRecord_(this.getLogRecord(a, b, c)));
+};
+goog.debug.Logger.prototype.getLogRecord = function(a, b, c) {
+  a = goog.debug.LogBuffer.isBufferingEnabled() ? goog.debug.LogBuffer.getInstance().addRecord(a, b, this.name_) : new goog.debug.LogRecord(a, String(b), this.name_);
+  c && a.setException(c);
+  return a;
+};
+goog.debug.Logger.prototype.shout = function(a, b) {
+  goog.debug.LOGGING_ENABLED && this.log(goog.debug.Logger.Level.SHOUT, a, b);
+};
+goog.debug.Logger.prototype.severe = function(a, b) {
+  goog.debug.LOGGING_ENABLED && this.log(goog.debug.Logger.Level.SEVERE, a, b);
+};
+goog.debug.Logger.prototype.warning = function(a, b) {
+  goog.debug.LOGGING_ENABLED && this.log(goog.debug.Logger.Level.WARNING, a, b);
+};
+goog.debug.Logger.prototype.info = function(a, b) {
+  goog.debug.LOGGING_ENABLED && this.log(goog.debug.Logger.Level.INFO, a, b);
+};
+goog.debug.Logger.prototype.config = function(a, b) {
+  goog.debug.LOGGING_ENABLED && this.log(goog.debug.Logger.Level.CONFIG, a, b);
+};
+goog.debug.Logger.prototype.fine = function(a, b) {
+  goog.debug.LOGGING_ENABLED && this.log(goog.debug.Logger.Level.FINE, a, b);
+};
+goog.debug.Logger.prototype.finer = function(a, b) {
+  goog.debug.LOGGING_ENABLED && this.log(goog.debug.Logger.Level.FINER, a, b);
+};
+goog.debug.Logger.prototype.finest = function(a, b) {
+  goog.debug.LOGGING_ENABLED && this.log(goog.debug.Logger.Level.FINEST, a, b);
+};
+goog.debug.Logger.prototype.logRecord = function(a) {
+  goog.debug.LOGGING_ENABLED && this.isLoggable(a.getLevel()) && this.doLogRecord_(a);
+};
+goog.debug.Logger.prototype.doLogRecord_ = function(a) {
+  goog.debug.Logger.logToProfilers("log:" + a.getMessage());
+  if (goog.debug.Logger.ENABLE_HIERARCHY) {
+    for (var b = this;b;) {
+      b.callPublish_(a), b = b.getParent();
+    }
+  } else {
+    for (var b = 0, c;c = goog.debug.Logger.rootHandlers_[b++];) {
+      c(a);
+    }
+  }
+};
+goog.debug.Logger.prototype.callPublish_ = function(a) {
+  if (this.handlers_) {
+    for (var b = 0, c;c = this.handlers_[b];b++) {
+      c(a);
+    }
+  }
+};
+goog.debug.Logger.prototype.setParent_ = function(a) {
+  this.parent_ = a;
+};
+goog.debug.Logger.prototype.addChild_ = function(a, b) {
+  this.getChildren()[a] = b;
+};
+goog.debug.LogManager = {};
+goog.debug.LogManager.loggers_ = {};
+goog.debug.LogManager.rootLogger_ = null;
+goog.debug.LogManager.initialize = function() {
+  goog.debug.LogManager.rootLogger_ || (goog.debug.LogManager.rootLogger_ = new goog.debug.Logger(goog.debug.Logger.ROOT_LOGGER_NAME), goog.debug.LogManager.loggers_[goog.debug.Logger.ROOT_LOGGER_NAME] = goog.debug.LogManager.rootLogger_, goog.debug.LogManager.rootLogger_.setLevel(goog.debug.Logger.Level.CONFIG));
+};
+goog.debug.LogManager.getLoggers = function() {
+  return goog.debug.LogManager.loggers_;
+};
+goog.debug.LogManager.getRoot = function() {
+  goog.debug.LogManager.initialize();
+  return goog.debug.LogManager.rootLogger_;
+};
+goog.debug.LogManager.getLogger = function(a) {
+  goog.debug.LogManager.initialize();
+  return goog.debug.LogManager.loggers_[a] || goog.debug.LogManager.createLogger_(a);
+};
+goog.debug.LogManager.createFunctionForCatchErrors = function(a) {
+  return function(b) {
+    (a || goog.debug.LogManager.getRoot()).severe("Error: " + b.message + " (" + b.fileName + " @ Line: " + b.line + ")");
+  };
+};
+goog.debug.LogManager.createLogger_ = function(a) {
+  var b = new goog.debug.Logger(a);
+  if (goog.debug.Logger.ENABLE_HIERARCHY) {
+    var c = a.lastIndexOf("."), d = a.substr(0, c), c = a.substr(c + 1), d = goog.debug.LogManager.getLogger(d);
+    d.addChild_(c, b);
+    b.setParent_(d);
+  }
+  return goog.debug.LogManager.loggers_[a] = b;
+};
+goog.debug.RelativeTimeProvider = function() {
+  this.relativeTimeStart_ = goog.now();
+};
+goog.debug.RelativeTimeProvider.defaultInstance_ = new goog.debug.RelativeTimeProvider;
+goog.debug.RelativeTimeProvider.prototype.set = function(a) {
+  this.relativeTimeStart_ = a;
+};
+goog.debug.RelativeTimeProvider.prototype.reset = function() {
+  this.set(goog.now());
+};
+goog.debug.RelativeTimeProvider.prototype.get = function() {
+  return this.relativeTimeStart_;
+};
+goog.debug.RelativeTimeProvider.getDefaultInstance = function() {
+  return goog.debug.RelativeTimeProvider.defaultInstance_;
+};
+goog.debug.Formatter = function(a) {
+  this.prefix_ = a || "";
+  this.startTimeProvider_ = goog.debug.RelativeTimeProvider.getDefaultInstance();
+};
+goog.debug.Formatter.prototype.appendNewline = !0;
+goog.debug.Formatter.prototype.showAbsoluteTime = !0;
+goog.debug.Formatter.prototype.showRelativeTime = !0;
+goog.debug.Formatter.prototype.showLoggerName = !0;
+goog.debug.Formatter.prototype.showExceptionText = !1;
+goog.debug.Formatter.prototype.showSeverityLevel = !1;
+goog.debug.Formatter.prototype.setStartTimeProvider = function(a) {
+  this.startTimeProvider_ = a;
+};
+goog.debug.Formatter.prototype.getStartTimeProvider = function() {
+  return this.startTimeProvider_;
+};
+goog.debug.Formatter.prototype.resetRelativeTimeStart = function() {
+  this.startTimeProvider_.reset();
+};
+goog.debug.Formatter.getDateTimeStamp_ = function(a) {
+  a = new Date(a.getMillis());
+  return goog.debug.Formatter.getTwoDigitString_(a.getFullYear() - 2E3) + goog.debug.Formatter.getTwoDigitString_(a.getMonth() + 1) + goog.debug.Formatter.getTwoDigitString_(a.getDate()) + " " + goog.debug.Formatter.getTwoDigitString_(a.getHours()) + ":" + goog.debug.Formatter.getTwoDigitString_(a.getMinutes()) + ":" + goog.debug.Formatter.getTwoDigitString_(a.getSeconds()) + "." + goog.debug.Formatter.getTwoDigitString_(Math.floor(a.getMilliseconds() / 10));
+};
+goog.debug.Formatter.getTwoDigitString_ = function(a) {
+  return 10 > a ? "0" + a : String(a);
+};
+goog.debug.Formatter.getRelativeTime_ = function(a, b) {
+  var c = (a.getMillis() - b) / 1E3, d = c.toFixed(3), e = 0;
+  if (1 > c) {
+    e = 2;
+  } else {
+    for (;100 > c;) {
+      e++, c *= 10;
+    }
+  }
+  for (;0 < e--;) {
+    d = " " + d;
+  }
+  return d;
+};
+goog.debug.HtmlFormatter = function(a) {
+  goog.debug.Formatter.call(this, a);
+};
+goog.inherits(goog.debug.HtmlFormatter, goog.debug.Formatter);
+goog.debug.HtmlFormatter.prototype.showExceptionText = !0;
+goog.debug.HtmlFormatter.prototype.formatRecord = function(a) {
+  return a ? this.formatRecordAsHtml(a).getTypedStringValue() : "";
+};
+goog.debug.HtmlFormatter.prototype.formatRecordAsHtml = function(a) {
+  if (!a) {
+    return goog.html.SafeHtml.EMPTY;
+  }
+  var b;
+  switch(a.getLevel().value) {
+    case goog.debug.Logger.Level.SHOUT.value:
+      b = "dbg-sh";
+      break;
+    case goog.debug.Logger.Level.SEVERE.value:
+      b = "dbg-sev";
+      break;
+    case goog.debug.Logger.Level.WARNING.value:
+      b = "dbg-w";
+      break;
+    case goog.debug.Logger.Level.INFO.value:
+      b = "dbg-i";
+      break;
+    default:
+      b = "dbg-f";
+  }
+  var c = [];
+  c.push(this.prefix_, " ");
+  this.showAbsoluteTime && c.push("[", goog.debug.Formatter.getDateTimeStamp_(a), "] ");
+  this.showRelativeTime && c.push("[", goog.debug.Formatter.getRelativeTime_(a, this.startTimeProvider_.get()), "s] ");
+  this.showLoggerName && c.push("[", a.getLoggerName(), "] ");
+  this.showSeverityLevel && c.push("[", a.getLevel().name, "] ");
+  var c = goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(c.join("")), d = goog.html.SafeHtml.EMPTY;
+  this.showExceptionText && a.getException() && (d = goog.html.SafeHtml.concat(goog.html.SafeHtml.create("br"), goog.debug.exposeExceptionAsHtml(a.getException())));
+  a = goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(a.getMessage());
+  b = goog.html.SafeHtml.create("span", {"class":b}, goog.html.SafeHtml.concat(a, d));
+  return this.appendNewline ? goog.html.SafeHtml.concat(c, b, goog.html.SafeHtml.create("br")) : goog.html.SafeHtml.concat(c, b);
+};
+goog.debug.TextFormatter = function(a) {
+  goog.debug.Formatter.call(this, a);
+};
+goog.inherits(goog.debug.TextFormatter, goog.debug.Formatter);
+goog.debug.TextFormatter.prototype.formatRecord = function(a) {
+  var b = [];
+  b.push(this.prefix_, " ");
+  this.showAbsoluteTime && b.push("[", goog.debug.Formatter.getDateTimeStamp_(a), "] ");
+  this.showRelativeTime && b.push("[", goog.debug.Formatter.getRelativeTime_(a, this.startTimeProvider_.get()), "s] ");
+  this.showLoggerName && b.push("[", a.getLoggerName(), "] ");
+  this.showSeverityLevel && b.push("[", a.getLevel().name, "] ");
+  b.push(a.getMessage());
+  this.showExceptionText && (a = a.getException()) && b.push("\n", a instanceof Error ? a.message : a.toString());
+  this.appendNewline && b.push("\n");
+  return b.join("");
+};
+goog.debug.TextFormatter.prototype.formatRecordAsHtml = function(a) {
+  return goog.html.SafeHtml.htmlEscapePreservingNewlinesAndSpaces(goog.debug.TextFormatter.prototype.formatRecord(a));
+};
+goog.dom.safe = {};
+goog.dom.safe.InsertAdjacentHtmlPosition = {AFTERBEGIN:"afterbegin", AFTEREND:"afterend", BEFOREBEGIN:"beforebegin", BEFOREEND:"beforeend"};
+goog.dom.safe.insertAdjacentHtml = function(a, b, c) {
+  a.insertAdjacentHTML(b, goog.html.SafeHtml.unwrap(c));
+};
+goog.dom.safe.setInnerHtml = function(a, b) {
+  a.innerHTML = goog.html.SafeHtml.unwrap(b);
+};
+goog.dom.safe.setOuterHtml = function(a, b) {
+  a.outerHTML = goog.html.SafeHtml.unwrap(b);
+};
+goog.dom.safe.documentWrite = function(a, b) {
+  a.write(goog.html.SafeHtml.unwrap(b));
+};
+goog.dom.safe.setAnchorHref = function(a, b) {
+  var c;
+  c = b instanceof goog.html.SafeUrl ? b : goog.html.SafeUrl.sanitize(b);
+  a.href = goog.html.SafeUrl.unwrap(c);
+};
+goog.dom.safe.setEmbedSrc = function(a, b) {
+  a.src = goog.html.TrustedResourceUrl.unwrap(b);
+};
+goog.dom.safe.setFrameSrc = function(a, b) {
+  a.src = goog.html.TrustedResourceUrl.unwrap(b);
+};
+goog.dom.safe.setIframeSrc = function(a, b) {
+  a.src = goog.html.TrustedResourceUrl.unwrap(b);
+};
+goog.dom.safe.setLinkHrefAndRel = function(a, b, c) {
+  a.rel = c;
+  goog.string.caseInsensitiveContains(c, "stylesheet") ? (goog.asserts.assert(b instanceof goog.html.TrustedResourceUrl, 'URL must be TrustedResourceUrl because "rel" contains "stylesheet"'), a.href = goog.html.TrustedResourceUrl.unwrap(b)) : a.href = b instanceof goog.html.TrustedResourceUrl ? goog.html.TrustedResourceUrl.unwrap(b) : b instanceof goog.html.SafeUrl ? goog.html.SafeUrl.unwrap(b) : goog.html.SafeUrl.sanitize(b).getTypedStringValue();
+};
+goog.dom.safe.setObjectData = function(a, b) {
+  a.data = goog.html.TrustedResourceUrl.unwrap(b);
+};
+goog.dom.safe.setScriptSrc = function(a, b) {
+  a.src = goog.html.TrustedResourceUrl.unwrap(b);
+};
+goog.dom.safe.setLocationHref = function(a, b) {
+  var c;
+  c = b instanceof goog.html.SafeUrl ? b : goog.html.SafeUrl.sanitize(b);
+  a.href = goog.html.SafeUrl.unwrap(c);
+};
+goog.dom.safe.openInWindow = function(a, b, c, d, e) {
+  a = a instanceof goog.html.SafeUrl ? a : goog.html.SafeUrl.sanitize(a);
+  return (b || window).open(goog.html.SafeUrl.unwrap(a), c ? goog.string.Const.unwrap(c) : "", d, e);
+};
+goog.dom.BrowserFeature = {CAN_ADD_NAME_OR_TYPE_ATTRIBUTES:!goog.userAgent.IE || goog.userAgent.isDocumentModeOrHigher(9), CAN_USE_CHILDREN_ATTRIBUTE:!goog.userAgent.GECKO && !goog.userAgent.IE || goog.userAgent.IE && goog.userAgent.isDocumentModeOrHigher(9) || goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher("1.9.1"), CAN_USE_INNER_TEXT:goog.userAgent.IE && !goog.userAgent.isVersionOrHigher("9"), CAN_USE_PARENT_ELEMENT_PROPERTY:goog.userAgent.IE || goog.userAgent.OPERA || goog.userAgent.WEBKIT, 
+INNER_HTML_NEEDS_SCOPED_ELEMENT:goog.userAgent.IE, LEGACY_IE_RANGES:goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9)};
+goog.math.Coordinate = function(a, b) {
+  this.x = goog.isDef(a) ? a : 0;
+  this.y = goog.isDef(b) ? b : 0;
+};
+goog.math.Coordinate.prototype.clone = function() {
+  return new goog.math.Coordinate(this.x, this.y);
+};
+goog.DEBUG && (goog.math.Coordinate.prototype.toString = function() {
+  return "(" + this.x + ", " + this.y + ")";
+});
+goog.math.Coordinate.equals = function(a, b) {
+  return a == b ? !0 : a && b ? a.x == b.x && a.y == b.y : !1;
+};
+goog.math.Coordinate.distance = function(a, b) {
+  var c = a.x - b.x, d = a.y - b.y;
+  return Math.sqrt(c * c + d * d);
+};
+goog.math.Coordinate.magnitude = function(a) {
+  return Math.sqrt(a.x * a.x + a.y * a.y);
+};
+goog.math.Coordinate.azimuth = function(a) {
+  return goog.math.angle(0, 0, a.x, a.y);
+};
+goog.math.Coordinate.squaredDistance = function(a, b) {
+  var c = a.x - b.x, d = a.y - b.y;
+  return c * c + d * d;
+};
+goog.math.Coordinate.difference = function(a, b) {
+  return new goog.math.Coordinate(a.x - b.x, a.y - b.y);
+};
+goog.math.Coordinate.sum = function(a, b) {
+  return new goog.math.Coordinate(a.x + b.x, a.y + b.y);
+};
+goog.math.Coordinate.prototype.ceil = function() {
+  this.x = Math.ceil(this.x);
+  this.y = Math.ceil(this.y);
+  return this;
+};
+goog.math.Coordinate.prototype.floor = function() {
+  this.x = Math.floor(this.x);
+  this.y = Math.floor(this.y);
+  return this;
+};
+goog.math.Coordinate.prototype.round = function() {
+  this.x = Math.round(this.x);
+  this.y = Math.round(this.y);
+  return this;
+};
+goog.math.Coordinate.prototype.translate = function(a, b) {
+  a instanceof goog.math.Coordinate ? (this.x += a.x, this.y += a.y) : (this.x += a, goog.isNumber(b) && (this.y += b));
+  return this;
+};
+goog.math.Coordinate.prototype.scale = function(a, b) {
+  var c = goog.isNumber(b) ? b : a;
+  this.x *= a;
+  this.y *= c;
+  return this;
+};
+goog.math.Coordinate.prototype.rotateRadians = function(a, b) {
+  var c = b || new goog.math.Coordinate(0, 0), d = this.x, e = this.y, f = Math.cos(a), g = Math.sin(a);
+  this.x = (d - c.x) * f - (e - c.y) * g + c.x;
+  this.y = (d - c.x) * g + (e - c.y) * f + c.y;
+};
+goog.math.Coordinate.prototype.rotateDegrees = function(a, b) {
+  this.rotateRadians(goog.math.toRadians(a), b);
+};
+goog.math.Size = function(a, b) {
+  this.width = a;
+  this.height = b;
+};
+goog.math.Size.equals = function(a, b) {
+  return a == b ? !0 : a && b ? a.width == b.width && a.height == b.height : !1;
+};
+goog.math.Size.prototype.clone = function() {
+  return new goog.math.Size(this.width, this.height);
+};
+goog.DEBUG && (goog.math.Size.prototype.toString = function() {
+  return "(" + this.width + " x " + this.height + ")";
+});
+goog.math.Size.prototype.getLongest = function() {
+  return Math.max(this.width, this.height);
+};
+goog.math.Size.prototype.getShortest = function() {
+  return Math.min(this.width, this.height);
+};
+goog.math.Size.prototype.area = function() {
+  return this.width * this.height;
+};
+goog.math.Size.prototype.perimeter = function() {
+  return 2 * (this.width + this.height);
+};
+goog.math.Size.prototype.aspectRatio = function() {
+  return this.width / this.height;
+};
+goog.math.Size.prototype.isEmpty = function() {
+  return !this.area();
+};
+goog.math.Size.prototype.ceil = function() {
+  this.width = Math.ceil(this.width);
+  this.height = Math.ceil(this.height);
+  return this;
+};
+goog.math.Size.prototype.fitsInside = function(a) {
+  return this.width <= a.width && this.height <= a.height;
+};
+goog.math.Size.prototype.floor = function() {
+  this.width = Math.floor(this.width);
+  this.height = Math.floor(this.height);
+  return this;
+};
+goog.math.Size.prototype.round = function() {
+  this.width = Math.round(this.width);
+  this.height = Math.round(this.height);
+  return this;
+};
+goog.math.Size.prototype.scale = function(a, b) {
+  var c = goog.isNumber(b) ? b : a;
+  this.width *= a;
+  this.height *= c;
+  return this;
+};
+goog.math.Size.prototype.scaleToCover = function(a) {
+  a = this.aspectRatio() <= a.aspectRatio() ? a.width / this.width : a.height / this.height;
+  return this.scale(a);
+};
+goog.math.Size.prototype.scaleToFit = function(a) {
+  a = this.aspectRatio() > a.aspectRatio() ? a.width / this.width : a.height / this.height;
+  return this.scale(a);
+};
+goog.dom.ASSUME_QUIRKS_MODE = !1;
+goog.dom.ASSUME_STANDARDS_MODE = !1;
+goog.dom.COMPAT_MODE_KNOWN_ = goog.dom.ASSUME_QUIRKS_MODE || goog.dom.ASSUME_STANDARDS_MODE;
+goog.dom.getDomHelper = function(a) {
+  return a ? new goog.dom.DomHelper(goog.dom.getOwnerDocument(a)) : goog.dom.defaultDomHelper_ || (goog.dom.defaultDomHelper_ = new goog.dom.DomHelper);
+};
+goog.dom.getDocument = function() {
+  return document;
+};
+goog.dom.getElement = function(a) {
+  return goog.dom.getElementHelper_(document, a);
+};
+goog.dom.getElementHelper_ = function(a, b) {
+  return goog.isString(b) ? a.getElementById(b) : b;
+};
+goog.dom.getRequiredElement = function(a) {
+  return goog.dom.getRequiredElementHelper_(document, a);
+};
+goog.dom.getRequiredElementHelper_ = function(a, b) {
+  goog.asserts.assertString(b);
+  var c = goog.dom.getElementHelper_(a, b);
+  return c = goog.asserts.assertElement(c, "No element found with id: " + b);
+};
+goog.dom.$ = goog.dom.getElement;
+goog.dom.getElementsByTagNameAndClass = function(a, b, c) {
+  return goog.dom.getElementsByTagNameAndClass_(document, a, b, c);
+};
+goog.dom.getElementsByClass = function(a, b) {
+  var c = b || document;
+  return goog.dom.canUseQuerySelector_(c) ? c.querySelectorAll("." + a) : goog.dom.getElementsByTagNameAndClass_(document, "*", a, b);
+};
+goog.dom.getElementByClass = function(a, b) {
+  var c = b || document, d = null;
+  return (d = c.getElementsByClassName ? c.getElementsByClassName(a)[0] : goog.dom.canUseQuerySelector_(c) ? c.querySelector("." + a) : goog.dom.getElementsByTagNameAndClass_(document, "*", a, b)[0]) || null;
+};
+goog.dom.getRequiredElementByClass = function(a, b) {
+  var c = goog.dom.getElementByClass(a, b);
+  return goog.asserts.assert(c, "No element found with className: " + a);
+};
+goog.dom.canUseQuerySelector_ = function(a) {
+  return !(!a.querySelectorAll || !a.querySelector);
+};
+goog.dom.getElementsByTagNameAndClass_ = function(a, b, c, d) {
+  a = d || a;
+  b = b && "*" != b ? b.toUpperCase() : "";
+  if (goog.dom.canUseQuerySelector_(a) && (b || c)) {
+    return a.querySelectorAll(b + (c ? "." + c : ""));
+  }
+  if (c && a.getElementsByClassName) {
+    a = a.getElementsByClassName(c);
+    if (b) {
+      d = {};
+      for (var e = 0, f = 0, g;g = a[f];f++) {
+        b == g.nodeName && (d[e++] = g);
+      }
+      d.length = e;
+      return d;
+    }
+    return a;
+  }
+  a = a.getElementsByTagName(b || "*");
+  if (c) {
+    d = {};
+    for (f = e = 0;g = a[f];f++) {
+      b = g.className, "function" == typeof b.split && goog.array.contains(b.split(/\s+/), c) && (d[e++] = g);
+    }
+    d.length = e;
+    return d;
+  }
+  return a;
+};
+goog.dom.$$ = goog.dom.getElementsByTagNameAndClass;
+goog.dom.setProperties = function(a, b) {
+  goog.object.forEach(b, function(b, d) {
+    "style" == d ? a.style.cssText = b : "class" == d ? a.className = b : "for" == d ? a.htmlFor = b : goog.dom.DIRECT_ATTRIBUTE_MAP_.hasOwnProperty(d) ? a.setAttribute(goog.dom.DIRECT_ATTRIBUTE_MAP_[d], b) : goog.string.startsWith(d, "aria-") || goog.string.startsWith(d, "data-") ? a.setAttribute(d, b) : a[d] = b;
+  });
+};
+goog.dom.DIRECT_ATTRIBUTE_MAP_ = {cellpadding:"cellPadding", cellspacing:"cellSpacing", colspan:"colSpan", frameborder:"frameBorder", height:"height", maxlength:"maxLength", role:"role", rowspan:"rowSpan", type:"type", usemap:"useMap", valign:"vAlign", width:"width"};
+goog.dom.getViewportSize = function(a) {
+  return goog.dom.getViewportSize_(a || window);
+};
+goog.dom.getViewportSize_ = function(a) {
+  a = a.document;
+  a = goog.dom.isCss1CompatMode_(a) ? a.documentElement : a.body;
+  return new goog.math.Size(a.clientWidth, a.clientHeight);
+};
+goog.dom.getDocumentHeight = function() {
+  return goog.dom.getDocumentHeight_(window);
+};
+goog.dom.getDocumentHeight_ = function(a) {
+  var b = a.document, c = 0;
+  if (b) {
+    var c = b.body, d = b.documentElement;
+    if (!d || !c) {
+      return 0;
+    }
+    a = goog.dom.getViewportSize_(a).height;
+    if (goog.dom.isCss1CompatMode_(b) && d.scrollHeight) {
+      c = d.scrollHeight != a ? d.scrollHeight : d.offsetHeight;
+    } else {
+      var b = d.scrollHeight, e = d.offsetHeight;
+      d.clientHeight != e && (b = c.scrollHeight, e = c.offsetHeight);
+      c = b > a ? b > e ? b : e : b < e ? b : e;
+    }
+  }
+  return c;
+};
+goog.dom.getPageScroll = function(a) {
+  return goog.dom.getDomHelper((a || goog.global || window).document).getDocumentScroll();
+};
+goog.dom.getDocumentScroll = function() {
+  return goog.dom.getDocumentScroll_(document);
+};
+goog.dom.getDocumentScroll_ = function(a) {
+  var b = goog.dom.getDocumentScrollElement_(a);
+  a = goog.dom.getWindow_(a);
+  return goog.userAgent.IE && goog.userAgent.isVersionOrHigher("10") && a.pageYOffset != b.scrollTop ? new goog.math.Coordinate(b.scrollLeft, b.scrollTop) : new goog.math.Coordinate(a.pageXOffset || b.scrollLeft, a.pageYOffset || b.scrollTop);
+};
+goog.dom.getDocumentScrollElement = function() {
+  return goog.dom.getDocumentScrollElement_(document);
+};
+goog.dom.getDocumentScrollElement_ = function(a) {
+  return a.scrollingElement ? a.scrollingElement : !goog.userAgent.WEBKIT && goog.dom.isCss1CompatMode_(a) ? a.documentElement : a.body || a.documentElement;
+};
+goog.dom.getWindow = function(a) {
+  return a ? goog.dom.getWindow_(a) : window;
+};
+goog.dom.getWindow_ = function(a) {
+  return a.parentWindow || a.defaultView;
+};
+goog.dom.createDom = function(a, b, c) {
+  return goog.dom.createDom_(document, arguments);
+};
+goog.dom.createDom_ = function(a, b) {
+  var c = b[0], d = b[1];
+  if (!goog.dom.BrowserFeature.CAN_ADD_NAME_OR_TYPE_ATTRIBUTES && d && (d.name || d.type)) {
+    c = ["<", c];
+    d.name && c.push(' name="', goog.string.htmlEscape(d.name), '"');
+    if (d.type) {
+      c.push(' type="', goog.string.htmlEscape(d.type), '"');
+      var e = {};
+      goog.object.extend(e, d);
+      delete e.type;
+      d = e;
+    }
+    c.push(">");
+    c = c.join("");
+  }
+  c = a.createElement(c);
+  d && (goog.isString(d) ? c.className = d : goog.isArray(d) ? c.className = d.join(" ") : goog.dom.setProperties(c, d));
+  2 < b.length && goog.dom.append_(a, c, b, 2);
+  return c;
+};
+goog.dom.append_ = function(a, b, c, d) {
+  function e(c) {
+    c && b.appendChild(goog.isString(c) ? a.createTextNode(c) : c);
+  }
+  for (;d < c.length;d++) {
+    var f = c[d];
+    goog.isArrayLike(f) && !goog.dom.isNodeLike(f) ? goog.array.forEach(goog.dom.isNodeList(f) ? goog.array.toArray(f) : f, e) : e(f);
+  }
+};
+goog.dom.$dom = goog.dom.createDom;
+goog.dom.createElement = function(a) {
+  return document.createElement(a);
+};
+goog.dom.createTextNode = function(a) {
+  return document.createTextNode(String(a));
+};
+goog.dom.createTable = function(a, b, c) {
+  return goog.dom.createTable_(document, a, b, !!c);
+};
+goog.dom.createTable_ = function(a, b, c, d) {
+  for (var e = a.createElement(goog.dom.TagName.TABLE), f = e.appendChild(a.createElement(goog.dom.TagName.TBODY)), g = 0;g < b;g++) {
+    for (var h = a.createElement(goog.dom.TagName.TR), k = 0;k < c;k++) {
+      var l = a.createElement(goog.dom.TagName.TD);
+      d && goog.dom.setTextContent(l, goog.string.Unicode.NBSP);
+      h.appendChild(l);
+    }
+    f.appendChild(h);
+  }
+  return e;
+};
+goog.dom.safeHtmlToNode = function(a) {
+  return goog.dom.safeHtmlToNode_(document, a);
+};
+goog.dom.safeHtmlToNode_ = function(a, b) {
+  var c = a.createElement(goog.dom.TagName.DIV);
+  goog.dom.BrowserFeature.INNER_HTML_NEEDS_SCOPED_ELEMENT ? (goog.dom.safe.setInnerHtml(c, goog.html.SafeHtml.concat(goog.html.SafeHtml.create("br"), b)), c.removeChild(c.firstChild)) : goog.dom.safe.setInnerHtml(c, b);
+  return goog.dom.childrenToNode_(a, c);
+};
+goog.dom.htmlToDocumentFragment = function(a) {
+  return goog.dom.htmlToDocumentFragment_(document, a);
+};
+goog.dom.htmlToDocumentFragment_ = function(a, b) {
+  var c = a.createElement(goog.dom.TagName.DIV);
+  goog.dom.BrowserFeature.INNER_HTML_NEEDS_SCOPED_ELEMENT ? (c.innerHTML = "<br>" + b, c.removeChild(c.firstChild)) : c.innerHTML = b;
+  return goog.dom.childrenToNode_(a, c);
+};
+goog.dom.childrenToNode_ = function(a, b) {
+  if (1 == b.childNodes.length) {
+    return b.removeChild(b.firstChild);
+  }
+  for (var c = a.createDocumentFragment();b.firstChild;) {
+    c.appendChild(b.firstChild);
+  }
+  return c;
+};
+goog.dom.isCss1CompatMode = function() {
+  return goog.dom.isCss1CompatMode_(document);
+};
+goog.dom.isCss1CompatMode_ = function(a) {
+  return goog.dom.COMPAT_MODE_KNOWN_ ? goog.dom.ASSUME_STANDARDS_MODE : "CSS1Compat" == a.compatMode;
+};
+goog.dom.canHaveChildren = function(a) {
+  if (a.nodeType != goog.dom.NodeType.ELEMENT) {
+    return !1;
+  }
+  switch(a.tagName) {
+    case goog.dom.TagName.APPLET:
+    ;
+    case goog.dom.TagName.AREA:
+    ;
+    case goog.dom.TagName.BASE:
+    ;
+    case goog.dom.TagName.BR:
+    ;
+    case goog.dom.TagName.COL:
+    ;
+    case goog.dom.TagName.COMMAND:
+    ;
+    case goog.dom.TagName.EMBED:
+    ;
+    case goog.dom.TagName.FRAME:
+    ;
+    case goog.dom.TagName.HR:
+    ;
+    case goog.dom.TagName.IMG:
+    ;
+    case goog.dom.TagName.INPUT:
+    ;
+    case goog.dom.TagName.IFRAME:
+    ;
+    case goog.dom.TagName.ISINDEX:
+    ;
+    case goog.dom.TagName.KEYGEN:
+    ;
+    case goog.dom.TagName.LINK:
+    ;
+    case goog.dom.TagName.NOFRAMES:
+    ;
+    case goog.dom.TagName.NOSCRIPT:
+    ;
+    case goog.dom.TagName.META:
+    ;
+    case goog.dom.TagName.OBJECT:
+    ;
+    case goog.dom.TagName.PARAM:
+    ;
+    case goog.dom.TagName.SCRIPT:
+    ;
+    case goog.dom.TagName.SOURCE:
+    ;
+    case goog.dom.TagName.STYLE:
+    ;
+    case goog.dom.TagName.TRACK:
+    ;
+    case goog.dom.TagName.WBR:
+      return !1;
+  }
+  return !0;
+};
+goog.dom.appendChild = function(a, b) {
+  a.appendChild(b);
+};
+goog.dom.append = function(a, b) {
+  goog.dom.append_(goog.dom.getOwnerDocument(a), a, arguments, 1);
+};
+goog.dom.removeChildren = function(a) {
+  for (var b;b = a.firstChild;) {
+    a.removeChild(b);
+  }
+};
+goog.dom.insertSiblingBefore = function(a, b) {
+  b.parentNode && b.parentNode.insertBefore(a, b);
+};
+goog.dom.insertSiblingAfter = function(a, b) {
+  b.parentNode && b.parentNode.insertBefore(a, b.nextSibling);
+};
+goog.dom.insertChildAt = function(a, b, c) {
+  a.insertBefore(b, a.childNodes[c] || null);
+};
+goog.dom.removeNode = function(a) {
+  return a && a.parentNode ? a.parentNode.removeChild(a) : null;
+};
+goog.dom.replaceNode = function(a, b) {
+  var c = b.parentNode;
+  c && c.replaceChild(a, b);
+};
+goog.dom.flattenElement = function(a) {
+  var b, c = a.parentNode;
+  if (c && c.nodeType != goog.dom.NodeType.DOCUMENT_FRAGMENT) {
+    if (a.removeNode) {
+      return a.removeNode(!1);
+    }
+    for (;b = a.firstChild;) {
+      c.insertBefore(b, a);
+    }
+    return goog.dom.removeNode(a);
+  }
+};
+goog.dom.getChildren = function(a) {
+  return goog.dom.BrowserFeature.CAN_USE_CHILDREN_ATTRIBUTE && void 0 != a.children ? a.children : goog.array.filter(a.childNodes, function(a) {
+    return a.nodeType == goog.dom.NodeType.ELEMENT;
+  });
+};
+goog.dom.getFirstElementChild = function(a) {
+  return goog.isDef(a.firstElementChild) ? a.firstElementChild : goog.dom.getNextElementNode_(a.firstChild, !0);
+};
+goog.dom.getLastElementChild = function(a) {
+  return goog.isDef(a.lastElementChild) ? a.lastElementChild : goog.dom.getNextElementNode_(a.lastChild, !1);
+};
+goog.dom.getNextElementSibling = function(a) {
+  return goog.isDef(a.nextElementSibling) ? a.nextElementSibling : goog.dom.getNextElementNode_(a.nextSibling, !0);
+};
+goog.dom.getPreviousElementSibling = function(a) {
+  return goog.isDef(a.previousElementSibling) ? a.previousElementSibling : goog.dom.getNextElementNode_(a.previousSibling, !1);
+};
+goog.dom.getNextElementNode_ = function(a, b) {
+  for (;a && a.nodeType != goog.dom.NodeType.ELEMENT;) {
+    a = b ? a.nextSibling : a.previousSibling;
+  }
+  return a;
+};
+goog.dom.getNextNode = function(a) {
+  if (!a) {
+    return null;
+  }
+  if (a.firstChild) {
+    return a.firstChild;
+  }
+  for (;a && !a.nextSibling;) {
+    a = a.parentNode;
+  }
+  return a ? a.nextSibling : null;
+};
+goog.dom.getPreviousNode = function(a) {
+  if (!a) {
+    return null;
+  }
+  if (!a.previousSibling) {
+    return a.parentNode;
+  }
+  for (a = a.previousSibling;a && a.lastChild;) {
+    a = a.lastChild;
+  }
+  return a;
+};
+goog.dom.isNodeLike = function(a) {
+  return goog.isObject(a) && 0 < a.nodeType;
+};
+goog.dom.isElement = function(a) {
+  return goog.isObject(a) && a.nodeType == goog.dom.NodeType.ELEMENT;
+};
+goog.dom.isWindow = function(a) {
+  return goog.isObject(a) && a.window == a;
+};
+goog.dom.getParentElement = function(a) {
+  var b;
+  if (goog.dom.BrowserFeature.CAN_USE_PARENT_ELEMENT_PROPERTY && !(goog.userAgent.IE && goog.userAgent.isVersionOrHigher("9") && !goog.userAgent.isVersionOrHigher("10") && goog.global.SVGElement && a instanceof goog.global.SVGElement) && (b = a.parentElement)) {
+    return b;
+  }
+  b = a.parentNode;
+  return goog.dom.isElement(b) ? b : null;
+};
+goog.dom.contains = function(a, b) {
+  if (a.contains && b.nodeType == goog.dom.NodeType.ELEMENT) {
+    return a == b || a.contains(b);
+  }
+  if ("undefined" != typeof a.compareDocumentPosition) {
+    return a == b || Boolean(a.compareDocumentPosition(b) & 16);
+  }
+  for (;b && a != b;) {
+    b = b.parentNode;
+  }
+  return b == a;
+};
+goog.dom.compareNodeOrder = function(a, b) {
+  if (a == b) {
+    return 0;
+  }
+  if (a.compareDocumentPosition) {
+    return a.compareDocumentPosition(b) & 2 ? 1 : -1;
+  }
+  if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9)) {
+    if (a.nodeType == goog.dom.NodeType.DOCUMENT) {
+      return -1;
+    }
+    if (b.nodeType == goog.dom.NodeType.DOCUMENT) {
+      return 1;
+    }
+  }
+  if ("sourceIndex" in a || a.parentNode && "sourceIndex" in a.parentNode) {
+    var c = a.nodeType == goog.dom.NodeType.ELEMENT, d = b.nodeType == goog.dom.NodeType.ELEMENT;
+    if (c && d) {
+      return a.sourceIndex - b.sourceIndex;
+    }
+    var e = a.parentNode, f = b.parentNode;
+    return e == f ? goog.dom.compareSiblingOrder_(a, b) : !c && goog.dom.contains(e, b) ? -1 * goog.dom.compareParentsDescendantNodeIe_(a, b) : !d && goog.dom.contains(f, a) ? goog.dom.compareParentsDescendantNodeIe_(b, a) : (c ? a.sourceIndex : e.sourceIndex) - (d ? b.sourceIndex : f.sourceIndex);
+  }
+  d = goog.dom.getOwnerDocument(a);
+  c = d.createRange();
+  c.selectNode(a);
+  c.collapse(!0);
+  d = d.createRange();
+  d.selectNode(b);
+  d.collapse(!0);
+  return c.compareBoundaryPoints(goog.global.Range.START_TO_END, d);
+};
+goog.dom.compareParentsDescendantNodeIe_ = function(a, b) {
+  var c = a.parentNode;
+  if (c == b) {
+    return -1;
+  }
+  for (var d = b;d.parentNode != c;) {
+    d = d.parentNode;
+  }
+  return goog.dom.compareSiblingOrder_(d, a);
+};
+goog.dom.compareSiblingOrder_ = function(a, b) {
+  for (var c = b;c = c.previousSibling;) {
+    if (c == a) {
+      return -1;
+    }
+  }
+  return 1;
+};
+goog.dom.findCommonAncestor = function(a) {
+  var b, c = arguments.length;
+  if (!c) {
+    return null;
+  }
+  if (1 == c) {
+    return arguments[0];
+  }
+  var d = [], e = Infinity;
+  for (b = 0;b < c;b++) {
+    for (var f = [], g = arguments[b];g;) {
+      f.unshift(g), g = g.parentNode;
+    }
+    d.push(f);
+    e = Math.min(e, f.length);
+  }
+  f = null;
+  for (b = 0;b < e;b++) {
+    for (var g = d[0][b], h = 1;h < c;h++) {
+      if (g != d[h][b]) {
+        return f;
+      }
+    }
+    f = g;
+  }
+  return f;
+};
+goog.dom.getOwnerDocument = function(a) {
+  goog.asserts.assert(a, "Node cannot be null or undefined.");
+  return a.nodeType == goog.dom.NodeType.DOCUMENT ? a : a.ownerDocument || a.document;
+};
+goog.dom.getFrameContentDocument = function(a) {
+  return a.contentDocument || a.contentWindow.document;
+};
+goog.dom.getFrameContentWindow = function(a) {
+  return a.contentWindow || goog.dom.getWindow(goog.dom.getFrameContentDocument(a));
+};
+goog.dom.setTextContent = function(a, b) {
+  goog.asserts.assert(null != a, "goog.dom.setTextContent expects a non-null value for node");
+  if ("textContent" in a) {
+    a.textContent = b;
+  } else {
+    if (a.nodeType == goog.dom.NodeType.TEXT) {
+      a.data = b;
+    } else {
+      if (a.firstChild && a.firstChild.nodeType == goog.dom.NodeType.TEXT) {
+        for (;a.lastChild != a.firstChild;) {
+          a.removeChild(a.lastChild);
+        }
+        a.firstChild.data = b;
+      } else {
+        goog.dom.removeChildren(a);
+        var c = goog.dom.getOwnerDocument(a);
+        a.appendChild(c.createTextNode(String(b)));
+      }
+    }
+  }
+};
+goog.dom.getOuterHtml = function(a) {
+  if ("outerHTML" in a) {
+    return a.outerHTML;
+  }
+  var b = goog.dom.getOwnerDocument(a).createElement(goog.dom.TagName.DIV);
+  b.appendChild(a.cloneNode(!0));
+  return b.innerHTML;
+};
+goog.dom.findNode = function(a, b) {
+  var c = [];
+  return goog.dom.findNodes_(a, b, c, !0) ? c[0] : void 0;
+};
+goog.dom.findNodes = function(a, b) {
+  var c = [];
+  goog.dom.findNodes_(a, b, c, !1);
+  return c;
+};
+goog.dom.findNodes_ = function(a, b, c, d) {
+  if (null != a) {
+    for (a = a.firstChild;a;) {
+      if (b(a) && (c.push(a), d) || goog.dom.findNodes_(a, b, c, d)) {
+        return !0;
+      }
+      a = a.nextSibling;
+    }
+  }
+  return !1;
+};
+goog.dom.TAGS_TO_IGNORE_ = {SCRIPT:1, STYLE:1, HEAD:1, IFRAME:1, OBJECT:1};
+goog.dom.PREDEFINED_TAG_VALUES_ = {IMG:" ", BR:"\n"};
+goog.dom.isFocusableTabIndex = function(a) {
+  return goog.dom.hasSpecifiedTabIndex_(a) && goog.dom.isTabIndexFocusable_(a);
+};
+goog.dom.setFocusableTabIndex = function(a, b) {
+  b ? a.tabIndex = 0 : (a.tabIndex = -1, a.removeAttribute("tabIndex"));
+};
+goog.dom.isFocusable = function(a) {
+  var b;
+  return (b = goog.dom.nativelySupportsFocus_(a) ? !a.disabled && (!goog.dom.hasSpecifiedTabIndex_(a) || goog.dom.isTabIndexFocusable_(a)) : goog.dom.isFocusableTabIndex(a)) && goog.userAgent.IE ? goog.dom.hasNonZeroBoundingRect_(a) : b;
+};
+goog.dom.hasSpecifiedTabIndex_ = function(a) {
+  a = a.getAttributeNode("tabindex");
+  return goog.isDefAndNotNull(a) && a.specified;
+};
+goog.dom.isTabIndexFocusable_ = function(a) {
+  a = a.tabIndex;
+  return goog.isNumber(a) && 0 <= a && 32768 > a;
+};
+goog.dom.nativelySupportsFocus_ = function(a) {
+  return a.tagName == goog.dom.TagName.A || a.tagName == goog.dom.TagName.INPUT || a.tagName == goog.dom.TagName.TEXTAREA || a.tagName == goog.dom.TagName.SELECT || a.tagName == goog.dom.TagName.BUTTON;
+};
+goog.dom.hasNonZeroBoundingRect_ = function(a) {
+  a = goog.isFunction(a.getBoundingClientRect) ? a.getBoundingClientRect() : {height:a.offsetHeight, width:a.offsetWidth};
+  return goog.isDefAndNotNull(a) && 0 < a.height && 0 < a.width;
+};
+goog.dom.getTextContent = function(a) {
+  if (goog.dom.BrowserFeature.CAN_USE_INNER_TEXT && "innerText" in a) {
+    a = goog.string.canonicalizeNewlines(a.innerText);
+  } else {
+    var b = [];
+    goog.dom.getTextContent_(a, b, !0);
+    a = b.join("");
+  }
+  a = a.replace(/ \xAD /g, " ").replace(/\xAD/g, "");
+  a = a.replace(/\u200B/g, "");
+  goog.dom.BrowserFeature.CAN_USE_INNER_TEXT || (a = a.replace(/ +/g, " "));
+  " " != a && (a = a.replace(/^\s*/, ""));
+  return a;
+};
+goog.dom.getRawTextContent = function(a) {
+  var b = [];
+  goog.dom.getTextContent_(a, b, !1);
+  return b.join("");
+};
+goog.dom.getTextContent_ = function(a, b, c) {
+  if (!(a.nodeName in goog.dom.TAGS_TO_IGNORE_)) {
+    if (a.nodeType == goog.dom.NodeType.TEXT) {
+      c ? b.push(String(a.nodeValue).replace(/(\r\n|\r|\n)/g, "")) : b.push(a.nodeValue);
+    } else {
+      if (a.nodeName in goog.dom.PREDEFINED_TAG_VALUES_) {
+        b.push(goog.dom.PREDEFINED_TAG_VALUES_[a.nodeName]);
+      } else {
+        for (a = a.firstChild;a;) {
+          goog.dom.getTextContent_(a, b, c), a = a.nextSibling;
+        }
+      }
+    }
+  }
+};
+goog.dom.getNodeTextLength = function(a) {
+  return goog.dom.getTextContent(a).length;
+};
+goog.dom.getNodeTextOffset = function(a, b) {
+  for (var c = b || goog.dom.getOwnerDocument(a).body, d = [];a && a != c;) {
+    for (var e = a;e = e.previousSibling;) {
+      d.unshift(goog.dom.getTextContent(e));
+    }
+    a = a.parentNode;
+  }
+  return goog.string.trimLeft(d.join("")).replace(/ +/g, " ").length;
+};
+goog.dom.getNodeAtOffset = function(a, b, c) {
+  a = [a];
+  for (var d = 0, e = null;0 < a.length && d < b;) {
+    if (e = a.pop(), !(e.nodeName in goog.dom.TAGS_TO_IGNORE_)) {
+      if (e.nodeType == goog.dom.NodeType.TEXT) {
+        var f = e.nodeValue.replace(/(\r\n|\r|\n)/g, "").replace(/ +/g, " "), d = d + f.length
+      } else {
+        if (e.nodeName in goog.dom.PREDEFINED_TAG_VALUES_) {
+          d += goog.dom.PREDEFINED_TAG_VALUES_[e.nodeName].length;
+        } else {
+          for (f = e.childNodes.length - 1;0 <= f;f--) {
+            a.push(e.childNodes[f]);
+          }
+        }
+      }
+    }
+  }
+  goog.isObject(c) && (c.remainder = e ? e.nodeValue.length + b - d - 1 : 0, c.node = e);
+  return e;
+};
+goog.dom.isNodeList = function(a) {
+  if (a && "number" == typeof a.length) {
+    if (goog.isObject(a)) {
+      return "function" == typeof a.item || "string" == typeof a.item;
+    }
+    if (goog.isFunction(a)) {
+      return "function" == typeof a.item;
+    }
+  }
+  return !1;
+};
+goog.dom.getAncestorByTagNameAndClass = function(a, b, c, d) {
+  if (!b && !c) {
+    return null;
+  }
+  var e = b ? b.toUpperCase() : null;
+  return goog.dom.getAncestor(a, function(a) {
+    return (!e || a.nodeName == e) && (!c || goog.isString(a.className) && goog.array.contains(a.className.split(/\s+/), c));
+  }, !0, d);
+};
+goog.dom.getAncestorByClass = function(a, b, c) {
+  return goog.dom.getAncestorByTagNameAndClass(a, null, b, c);
+};
+goog.dom.getAncestor = function(a, b, c, d) {
+  c || (a = a.parentNode);
+  c = null == d;
+  for (var e = 0;a && (c || e <= d);) {
+    goog.asserts.assert("parentNode" != a.name);
+    if (b(a)) {
+      return a;
+    }
+    a = a.parentNode;
+    e++;
+  }
+  return null;
+};
+goog.dom.getActiveElement = function(a) {
+  try {
+    return a && a.activeElement;
+  } catch (b) {
+  }
+  return null;
+};
+goog.dom.getPixelRatio = function() {
+  var a = goog.dom.getWindow();
+  return goog.isDef(a.devicePixelRatio) ? a.devicePixelRatio : a.matchMedia ? goog.dom.matchesPixelRatio_(.75) || goog.dom.matchesPixelRatio_(1.5) || goog.dom.matchesPixelRatio_(2) || goog.dom.matchesPixelRatio_(3) || 1 : 1;
+};
+goog.dom.matchesPixelRatio_ = function(a) {
+  return goog.dom.getWindow().matchMedia("(-webkit-min-device-pixel-ratio: " + a + "),(min--moz-device-pixel-ratio: " + a + "),(min-resolution: " + a + "dppx)").matches ? a : 0;
+};
+goog.dom.DomHelper = function(a) {
+  this.document_ = a || goog.global.document || document;
+};
+goog.dom.DomHelper.prototype.getDomHelper = goog.dom.getDomHelper;
+goog.dom.DomHelper.prototype.setDocument = function(a) {
+  this.document_ = a;
+};
+goog.dom.DomHelper.prototype.getDocument = function() {
+  return this.document_;
+};
+goog.dom.DomHelper.prototype.getElement = function(a) {
+  return goog.dom.getElementHelper_(this.document_, a);
+};
+goog.dom.DomHelper.prototype.getRequiredElement = function(a) {
+  return goog.dom.getRequiredElementHelper_(this.document_, a);
+};
+goog.dom.DomHelper.prototype.$ = goog.dom.DomHelper.prototype.getElement;
+goog.dom.DomHelper.prototype.getElementsByTagNameAndClass = function(a, b, c) {
+  return goog.dom.getElementsByTagNameAndClass_(this.document_, a, b, c);
+};
+goog.dom.DomHelper.prototype.getElementsByClass = function(a, b) {
+  return goog.dom.getElementsByClass(a, b || this.document_);
+};
+goog.dom.DomHelper.prototype.getElementByClass = function(a, b) {
+  return goog.dom.getElementByClass(a, b || this.document_);
+};
+goog.dom.DomHelper.prototype.getRequiredElementByClass = function(a, b) {
+  return goog.dom.getRequiredElementByClass(a, b || this.document_);
+};
+goog.dom.DomHelper.prototype.$$ = goog.dom.DomHelper.prototype.getElementsByTagNameAndClass;
+goog.dom.DomHelper.prototype.setProperties = goog.dom.setProperties;
+goog.dom.DomHelper.prototype.getViewportSize = function(a) {
+  return goog.dom.getViewportSize(a || this.getWindow());
+};
+goog.dom.DomHelper.prototype.getDocumentHeight = function() {
+  return goog.dom.getDocumentHeight_(this.getWindow());
+};
+goog.dom.DomHelper.prototype.createDom = function(a, b, c) {
+  return goog.dom.createDom_(this.document_, arguments);
+};
+goog.dom.DomHelper.prototype.$dom = goog.dom.DomHelper.prototype.createDom;
+goog.dom.DomHelper.prototype.createElement = function(a) {
+  return this.document_.createElement(a);
+};
+goog.dom.DomHelper.prototype.createTextNode = function(a) {
+  return this.document_.createTextNode(String(a));
+};
+goog.dom.DomHelper.prototype.createTable = function(a, b, c) {
+  return goog.dom.createTable_(this.document_, a, b, !!c);
+};
+goog.dom.DomHelper.prototype.safeHtmlToNode = function(a) {
+  return goog.dom.safeHtmlToNode_(this.document_, a);
+};
+goog.dom.DomHelper.prototype.htmlToDocumentFragment = function(a) {
+  return goog.dom.htmlToDocumentFragment_(this.document_, a);
+};
+goog.dom.DomHelper.prototype.isCss1CompatMode = function() {
+  return goog.dom.isCss1CompatMode_(this.document_);
+};
+goog.dom.DomHelper.prototype.getWindow = function() {
+  return goog.dom.getWindow_(this.document_);
+};
+goog.dom.DomHelper.prototype.getDocumentScrollElement = function() {
+  return goog.dom.getDocumentScrollElement_(this.document_);
+};
+goog.dom.DomHelper.prototype.getDocumentScroll = function() {
+  return goog.dom.getDocumentScroll_(this.document_);
+};
+goog.dom.DomHelper.prototype.getActiveElement = function(a) {
+  return goog.dom.getActiveElement(a || this.document_);
+};
+goog.dom.DomHelper.prototype.appendChild = goog.dom.appendChild;
+goog.dom.DomHelper.prototype.append = goog.dom.append;
+goog.dom.DomHelper.prototype.canHaveChildren = goog.dom.canHaveChildren;
+goog.dom.DomHelper.prototype.removeChildren = goog.dom.removeChildren;
+goog.dom.DomHelper.prototype.insertSiblingBefore = goog.dom.insertSiblingBefore;
+goog.dom.DomHelper.prototype.insertSiblingAfter = goog.dom.insertSiblingAfter;
+goog.dom.DomHelper.prototype.insertChildAt = goog.dom.insertChildAt;
+goog.dom.DomHelper.prototype.removeNode = goog.dom.removeNode;
+goog.dom.DomHelper.prototype.replaceNode = goog.dom.replaceNode;
+goog.dom.DomHelper.prototype.flattenElement = goog.dom.flattenElement;
+goog.dom.DomHelper.prototype.getChildren = goog.dom.getChildren;
+goog.dom.DomHelper.prototype.getFirstElementChild = goog.dom.getFirstElementChild;
+goog.dom.DomHelper.prototype.getLastElementChild = goog.dom.getLastElementChild;
+goog.dom.DomHelper.prototype.getNextElementSibling = goog.dom.getNextElementSibling;
+goog.dom.DomHelper.prototype.getPreviousElementSibling = goog.dom.getPreviousElementSibling;
+goog.dom.DomHelper.prototype.getNextNode = goog.dom.getNextNode;
+goog.dom.DomHelper.prototype.getPreviousNode = goog.dom.getPreviousNode;
+goog.dom.DomHelper.prototype.isNodeLike = goog.dom.isNodeLike;
+goog.dom.DomHelper.prototype.isElement = goog.dom.isElement;
+goog.dom.DomHelper.prototype.isWindow = goog.dom.isWindow;
+goog.dom.DomHelper.prototype.getParentElement = goog.dom.getParentElement;
+goog.dom.DomHelper.prototype.contains = goog.dom.contains;
+goog.dom.DomHelper.prototype.compareNodeOrder = goog.dom.compareNodeOrder;
+goog.dom.DomHelper.prototype.findCommonAncestor = goog.dom.findCommonAncestor;
+goog.dom.DomHelper.prototype.getOwnerDocument = goog.dom.getOwnerDocument;
+goog.dom.DomHelper.prototype.getFrameContentDocument = goog.dom.getFrameContentDocument;
+goog.dom.DomHelper.prototype.getFrameContentWindow = goog.dom.getFrameContentWindow;
+goog.dom.DomHelper.prototype.setTextContent = goog.dom.setTextContent;
+goog.dom.DomHelper.prototype.getOuterHtml = goog.dom.getOuterHtml;
+goog.dom.DomHelper.prototype.findNode = goog.dom.findNode;
+goog.dom.DomHelper.prototype.findNodes = goog.dom.findNodes;
+goog.dom.DomHelper.prototype.isFocusableTabIndex = goog.dom.isFocusableTabIndex;
+goog.dom.DomHelper.prototype.setFocusableTabIndex = goog.dom.setFocusableTabIndex;
+goog.dom.DomHelper.prototype.isFocusable = goog.dom.isFocusable;
+goog.dom.DomHelper.prototype.getTextContent = goog.dom.getTextContent;
+goog.dom.DomHelper.prototype.getNodeTextLength = goog.dom.getNodeTextLength;
+goog.dom.DomHelper.prototype.getNodeTextOffset = goog.dom.getNodeTextOffset;
+goog.dom.DomHelper.prototype.getNodeAtOffset = goog.dom.getNodeAtOffset;
+goog.dom.DomHelper.prototype.isNodeList = goog.dom.isNodeList;
+goog.dom.DomHelper.prototype.getAncestorByTagNameAndClass = goog.dom.getAncestorByTagNameAndClass;
+goog.dom.DomHelper.prototype.getAncestorByClass = goog.dom.getAncestorByClass;
+goog.dom.DomHelper.prototype.getAncestor = goog.dom.getAncestor;
+goog.dom.vendor = {};
+goog.dom.vendor.getVendorJsPrefix = function() {
+  return goog.userAgent.WEBKIT ? "Webkit" : goog.userAgent.GECKO ? "Moz" : goog.userAgent.IE ? "ms" : goog.userAgent.OPERA ? "O" : null;
+};
+goog.dom.vendor.getVendorPrefix = function() {
+  return goog.userAgent.WEBKIT ? "-webkit" : goog.userAgent.GECKO ? "-moz" : goog.userAgent.IE ? "-ms" : goog.userAgent.OPERA ? "-o" : null;
+};
+goog.dom.vendor.getPrefixedPropertyName = function(a, b) {
+  if (b && a in b) {
+    return a;
+  }
+  var c = goog.dom.vendor.getVendorJsPrefix();
+  return c ? (c = c.toLowerCase(), c += goog.string.toTitleCase(a), !goog.isDef(b) || c in b ? c : null) : null;
+};
+goog.dom.vendor.getPrefixedEventType = function(a) {
+  return ((goog.dom.vendor.getVendorJsPrefix() || "") + a).toLowerCase();
+};
+goog.math.Box = function(a, b, c, d) {
+  this.top = a;
+  this.right = b;
+  this.bottom = c;
+  this.left = d;
+};
+goog.math.Box.boundingBox = function(a) {
+  for (var b = new goog.math.Box(arguments[0].y, arguments[0].x, arguments[0].y, arguments[0].x), c = 1;c < arguments.length;c++) {
+    b.expandToIncludeCoordinate(arguments[c]);
+  }
+  return b;
+};
+goog.math.Box.prototype.getWidth = function() {
+  return this.right - this.left;
+};
+goog.math.Box.prototype.getHeight = function() {
+  return this.bottom - this.top;
+};
+goog.math.Box.prototype.clone = function() {
+  return new goog.math.Box(this.top, this.right, this.bottom, this.left);
+};
+goog.DEBUG && (goog.math.Box.prototype.toString = function() {
+  return "(" + this.top + "t, " + this.right + "r, " + this.bottom + "b, " + this.left + "l)";
+});
+goog.math.Box.prototype.contains = function(a) {
+  return goog.math.Box.contains(this, a);
+};
+goog.math.Box.prototype.expand = function(a, b, c, d) {
+  goog.isObject(a) ? (this.top -= a.top, this.right += a.right, this.bottom += a.bottom, this.left -= a.left) : (this.top -= a, this.right += b, this.bottom += c, this.left -= d);
+  return this;
+};
+goog.math.Box.prototype.expandToInclude = function(a) {
+  this.left = Math.min(this.left, a.left);
+  this.top = Math.min(this.top, a.top);
+  this.right = Math.max(this.right, a.right);
+  this.bottom = Math.max(this.bottom, a.bottom);
+};
+goog.math.Box.prototype.expandToIncludeCoordinate = function(a) {
+  this.top = Math.min(this.top, a.y);
+  this.right = Math.max(this.right, a.x);
+  this.bottom = Math.max(this.bottom, a.y);
+  this.left = Math.min(this.left, a.x);
+};
+goog.math.Box.equals = function(a, b) {
+  return a == b ? !0 : a && b ? a.top == b.top && a.right == b.right && a.bottom == b.bottom && a.left == b.left : !1;
+};
+goog.math.Box.contains = function(a, b) {
+  return a && b ? b instanceof goog.math.Box ? b.left >= a.left && b.right <= a.right && b.top >= a.top && b.bottom <= a.bottom : b.x >= a.left && b.x <= a.right && b.y >= a.top && b.y <= a.bottom : !1;
+};
+goog.math.Box.relativePositionX = function(a, b) {
+  return b.x < a.left ? b.x - a.left : b.x > a.right ? b.x - a.right : 0;
+};
+goog.math.Box.relativePositionY = function(a, b) {
+  return b.y < a.top ? b.y - a.top : b.y > a.bottom ? b.y - a.bottom : 0;
+};
+goog.math.Box.distance = function(a, b) {
+  var c = goog.math.Box.relativePositionX(a, b), d = goog.math.Box.relativePositionY(a, b);
+  return Math.sqrt(c * c + d * d);
+};
+goog.math.Box.intersects = function(a, b) {
+  return a.left <= b.right && b.left <= a.right && a.top <= b.bottom && b.top <= a.bottom;
+};
+goog.math.Box.intersectsWithPadding = function(a, b, c) {
+  return a.left <= b.right + c && b.left <= a.right + c && a.top <= b.bottom + c && b.top <= a.bottom + c;
+};
+goog.math.Box.prototype.ceil = function() {
+  this.top = Math.ceil(this.top);
+  this.right = Math.ceil(this.right);
+  this.bottom = Math.ceil(this.bottom);
+  this.left = Math.ceil(this.left);
+  return this;
+};
+goog.math.Box.prototype.floor = function() {
+  this.top = Math.floor(this.top);
+  this.right = Math.floor(this.right);
+  this.bottom = Math.floor(this.bottom);
+  this.left = Math.floor(this.left);
+  return this;
+};
+goog.math.Box.prototype.round = function() {
+  this.top = Math.round(this.top);
+  this.right = Math.round(this.right);
+  this.bottom = Math.round(this.bottom);
+  this.left = Math.round(this.left);
+  return this;
+};
+goog.math.Box.prototype.translate = function(a, b) {
+  a instanceof goog.math.Coordinate ? (this.left += a.x, this.right += a.x, this.top += a.y, this.bottom += a.y) : (this.left += a, this.right += a, goog.isNumber(b) && (this.top += b, this.bottom += b));
+  return this;
+};
+goog.math.Box.prototype.scale = function(a, b) {
+  var c = goog.isNumber(b) ? b : a;
+  this.left *= a;
+  this.right *= a;
+  this.top *= c;
+  this.bottom *= c;
+  return this;
+};
+goog.math.Rect = function(a, b, c, d) {
+  this.left = a;
+  this.top = b;
+  this.width = c;
+  this.height = d;
+};
+goog.math.Rect.prototype.clone = function() {
+  return new goog.math.Rect(this.left, this.top, this.width, this.height);
+};
+goog.math.Rect.prototype.toBox = function() {
+  return new goog.math.Box(this.top, this.left + this.width, this.top + this.height, this.left);
+};
+goog.math.Rect.createFromPositionAndSize = function(a, b) {
+  return new goog.math.Rect(a.x, a.y, b.width, b.height);
+};
+goog.math.Rect.createFromBox = function(a) {
+  return new goog.math.Rect(a.left, a.top, a.right - a.left, a.bottom - a.top);
+};
+goog.DEBUG && (goog.math.Rect.prototype.toString = function() {
+  return "(" + this.left + ", " + this.top + " - " + this.width + "w x " + this.height + "h)";
+});
+goog.math.Rect.equals = function(a, b) {
+  return a == b ? !0 : a && b ? a.left == b.left && a.width == b.width && a.top == b.top && a.height == b.height : !1;
+};
+goog.math.Rect.prototype.intersection = function(a) {
+  var b = Math.max(this.left, a.left), c = Math.min(this.left + this.width, a.left + a.width);
+  if (b <= c) {
+    var d = Math.max(this.top, a.top);
+    a = Math.min(this.top + this.height, a.top + a.height);
+    if (d <= a) {
+      return this.left = b, this.top = d, this.width = c - b, this.height = a - d, !0;
+    }
+  }
+  return !1;
+};
+goog.math.Rect.intersection = function(a, b) {
+  var c = Math.max(a.left, b.left), d = Math.min(a.left + a.width, b.left + b.width);
+  if (c <= d) {
+    var e = Math.max(a.top, b.top), f = Math.min(a.top + a.height, b.top + b.height);
+    if (e <= f) {
+      return new goog.math.Rect(c, e, d - c, f - e);
+    }
+  }
+  return null;
+};
+goog.math.Rect.intersects = function(a, b) {
+  return a.left <= b.left + b.width && b.left <= a.left + a.width && a.top <= b.top + b.height && b.top <= a.top + a.height;
+};
+goog.math.Rect.prototype.intersects = function(a) {
+  return goog.math.Rect.intersects(this, a);
+};
+goog.math.Rect.difference = function(a, b) {
+  var c = goog.math.Rect.intersection(a, b);
+  if (!c || !c.height || !c.width) {
+    return [a.clone()];
+  }
+  var c = [], d = a.top, e = a.height, f = a.left + a.width, g = a.top + a.height, h = b.left + b.width, k = b.top + b.height;
+  b.top > a.top && (c.push(new goog.math.Rect(a.left, a.top, a.width, b.top - a.top)), d = b.top, e -= b.top - a.top);
+  k < g && (c.push(new goog.math.Rect(a.left, k, a.width, g - k)), e = k - d);
+  b.left > a.left && c.push(new goog.math.Rect(a.left, d, b.left - a.left, e));
+  h < f && c.push(new goog.math.Rect(h, d, f - h, e));
+  return c;
+};
+goog.math.Rect.prototype.difference = function(a) {
+  return goog.math.Rect.difference(this, a);
+};
+goog.math.Rect.prototype.boundingRect = function(a) {
+  var b = Math.max(this.left + this.width, a.left + a.width), c = Math.max(this.top + this.height, a.top + a.height);
+  this.left = Math.min(this.left, a.left);
+  this.top = Math.min(this.top, a.top);
+  this.width = b - this.left;
+  this.height = c - this.top;
+};
+goog.math.Rect.boundingRect = function(a, b) {
+  if (!a || !b) {
+    return null;
+  }
+  var c = a.clone();
+  c.boundingRect(b);
+  return c;
+};
+goog.math.Rect.prototype.contains = function(a) {
+  return a instanceof goog.math.Rect ? this.left <= a.left && this.left + this.width >= a.left + a.width && this.top <= a.top && this.top + this.height >= a.top + a.height : a.x >= this.left && a.x <= this.left + this.width && a.y >= this.top && a.y <= this.top + this.height;
+};
+goog.math.Rect.prototype.squaredDistance = function(a) {
+  var b = a.x < this.left ? this.left - a.x : Math.max(a.x - (this.left + this.width), 0);
+  a = a.y < this.top ? this.top - a.y : Math.max(a.y - (this.top + this.height), 0);
+  return b * b + a * a;
+};
+goog.math.Rect.prototype.distance = function(a) {
+  return Math.sqrt(this.squaredDistance(a));
+};
+goog.math.Rect.prototype.getSize = function() {
+  return new goog.math.Size(this.width, this.height);
+};
+goog.math.Rect.prototype.getTopLeft = function() {
+  return new goog.math.Coordinate(this.left, this.top);
+};
+goog.math.Rect.prototype.getCenter = function() {
+  return new goog.math.Coordinate(this.left + this.width / 2, this.top + this.height / 2);
+};
+goog.math.Rect.prototype.getBottomRight = function() {
+  return new goog.math.Coordinate(this.left + this.width, this.top + this.height);
+};
+goog.math.Rect.prototype.ceil = function() {
+  this.left = Math.ceil(this.left);
+  this.top = Math.ceil(this.top);
+  this.width = Math.ceil(this.width);
+  this.height = Math.ceil(this.height);
+  return this;
+};
+goog.math.Rect.prototype.floor = function() {
+  this.left = Math.floor(this.left);
+  this.top = Math.floor(this.top);
+  this.width = Math.floor(this.width);
+  this.height = Math.floor(this.height);
+  return this;
+};
+goog.math.Rect.prototype.round = function() {
+  this.left = Math.round(this.left);
+  this.top = Math.round(this.top);
+  this.width = Math.round(this.width);
+  this.height = Math.round(this.height);
+  return this;
+};
+goog.math.Rect.prototype.translate = function(a, b) {
+  a instanceof goog.math.Coordinate ? (this.left += a.x, this.top += a.y) : (this.left += a, goog.isNumber(b) && (this.top += b));
+  return this;
+};
+goog.math.Rect.prototype.scale = function(a, b) {
+  var c = goog.isNumber(b) ? b : a;
+  this.left *= a;
+  this.width *= a;
+  this.top *= c;
+  this.height *= c;
+  return this;
+};
+goog.style = {};
+goog.style.setStyle = function(a, b, c) {
+  if (goog.isString(b)) {
+    goog.style.setStyle_(a, c, b);
+  } else {
+    for (var d in b) {
+      goog.style.setStyle_(a, b[d], d);
+    }
+  }
+};
+goog.style.setStyle_ = function(a, b, c) {
+  (c = goog.style.getVendorJsStyleName_(a, c)) && (a.style[c] = b);
+};
+goog.style.styleNameCache_ = {};
+goog.style.getVendorJsStyleName_ = function(a, b) {
+  var c = goog.style.styleNameCache_[b];
+  if (!c) {
+    var d = goog.string.toCamelCase(b), c = d;
+    void 0 === a.style[d] && (d = goog.dom.vendor.getVendorJsPrefix() + goog.string.toTitleCase(d), void 0 !== a.style[d] && (c = d));
+    goog.style.styleNameCache_[b] = c;
+  }
+  return c;
+};
+goog.style.getVendorStyleName_ = function(a, b) {
+  var c = goog.string.toCamelCase(b);
+  return void 0 === a.style[c] && (c = goog.dom.vendor.getVendorJsPrefix() + goog.string.toTitleCase(c), void 0 !== a.style[c]) ? goog.dom.vendor.getVendorPrefix() + "-" + b : b;
+};
+goog.style.getStyle = function(a, b) {
+  var c = a.style[goog.string.toCamelCase(b)];
+  return "undefined" !== typeof c ? c : a.style[goog.style.getVendorJsStyleName_(a, b)] || "";
+};
+goog.style.getComputedStyle = function(a, b) {
+  var c = goog.dom.getOwnerDocument(a);
+  return c.defaultView && c.defaultView.getComputedStyle && (c = c.defaultView.getComputedStyle(a, null)) ? c[b] || c.getPropertyValue(b) || "" : "";
+};
+goog.style.getCascadedStyle = function(a, b) {
+  return a.currentStyle ? a.currentStyle[b] : null;
+};
+goog.style.getStyle_ = function(a, b) {
+  return goog.style.getComputedStyle(a, b) || goog.style.getCascadedStyle(a, b) || a.style && a.style[b];
+};
+goog.style.getComputedBoxSizing = function(a) {
+  return goog.style.getStyle_(a, "boxSizing") || goog.style.getStyle_(a, "MozBoxSizing") || goog.style.getStyle_(a, "WebkitBoxSizing") || null;
+};
+goog.style.getComputedPosition = function(a) {
+  return goog.style.getStyle_(a, "position");
+};
+goog.style.getBackgroundColor = function(a) {
+  return goog.style.getStyle_(a, "backgroundColor");
+};
+goog.style.getComputedOverflowX = function(a) {
+  return goog.style.getStyle_(a, "overflowX");
+};
+goog.style.getComputedOverflowY = function(a) {
+  return goog.style.getStyle_(a, "overflowY");
+};
+goog.style.getComputedZIndex = function(a) {
+  return goog.style.getStyle_(a, "zIndex");
+};
+goog.style.getComputedTextAlign = function(a) {
+  return goog.style.getStyle_(a, "textAlign");
+};
+goog.style.getComputedCursor = function(a) {
+  return goog.style.getStyle_(a, "cursor");
+};
+goog.style.getComputedTransform = function(a) {
+  var b = goog.style.getVendorStyleName_(a, "transform");
+  return goog.style.getStyle_(a, b) || goog.style.getStyle_(a, "transform");
+};
+goog.style.setPosition = function(a, b, c) {
+  var d;
+  b instanceof goog.math.Coordinate ? (d = b.x, b = b.y) : (d = b, b = c);
+  a.style.left = goog.style.getPixelStyleValue_(d, !1);
+  a.style.top = goog.style.getPixelStyleValue_(b, !1);
+};
+goog.style.getPosition = function(a) {
+  return new goog.math.Coordinate(a.offsetLeft, a.offsetTop);
+};
+goog.style.getClientViewportElement = function(a) {
+  a = a ? goog.dom.getOwnerDocument(a) : goog.dom.getDocument();
+  return !goog.userAgent.IE || goog.userAgent.isDocumentModeOrHigher(9) || goog.dom.getDomHelper(a).isCss1CompatMode() ? a.documentElement : a.body;
+};
+goog.style.getViewportPageOffset = function(a) {
+  var b = a.body;
+  a = a.documentElement;
+  return new goog.math.Coordinate(b.scrollLeft || a.scrollLeft, b.scrollTop || a.scrollTop);
+};
+goog.style.getBoundingClientRect_ = function(a) {
+  var b;
+  try {
+    b = a.getBoundingClientRect();
+  } catch (c) {
+    return {left:0, top:0, right:0, bottom:0};
+  }
+  goog.userAgent.IE && a.ownerDocument.body && (a = a.ownerDocument, b.left -= a.documentElement.clientLeft + a.body.clientLeft, b.top -= a.documentElement.clientTop + a.body.clientTop);
+  return b;
+};
+goog.style.getOffsetParent = function(a) {
+  if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(8)) {
+    return a.offsetParent;
+  }
+  var b = goog.dom.getOwnerDocument(a), c = goog.style.getStyle_(a, "position"), d = "fixed" == c || "absolute" == c;
+  for (a = a.parentNode;a && a != b;a = a.parentNode) {
+    if (a.nodeType == goog.dom.NodeType.DOCUMENT_FRAGMENT && a.host && (a = a.host), c = goog.style.getStyle_(a, "position"), d = d && "static" == c && a != b.documentElement && a != b.body, !d && (a.scrollWidth > a.clientWidth || a.scrollHeight > a.clientHeight || "fixed" == c || "absolute" == c || "relative" == c)) {
+      return a;
+    }
+  }
+  return null;
+};
+goog.style.getVisibleRectForElement = function(a) {
+  for (var b = new goog.math.Box(0, Infinity, Infinity, 0), c = goog.dom.getDomHelper(a), d = c.getDocument().body, e = c.getDocument().documentElement, f = c.getDocumentScrollElement();a = goog.style.getOffsetParent(a);) {
+    if (!(goog.userAgent.IE && 0 == a.clientWidth || goog.userAgent.WEBKIT && 0 == a.clientHeight && a == d) && a != d && a != e && "visible" != goog.style.getStyle_(a, "overflow")) {
+      var g = goog.style.getPageOffset(a), h = goog.style.getClientLeftTop(a);
+      g.x += h.x;
+      g.y += h.y;
+      b.top = Math.max(b.top, g.y);
+      b.right = Math.min(b.right, g.x + a.clientWidth);
+      b.bottom = Math.min(b.bottom, g.y + a.clientHeight);
+      b.left = Math.max(b.left, g.x);
+    }
+  }
+  d = f.scrollLeft;
+  f = f.scrollTop;
+  b.left = Math.max(b.left, d);
+  b.top = Math.max(b.top, f);
+  c = c.getViewportSize();
+  b.right = Math.min(b.right, d + c.width);
+  b.bottom = Math.min(b.bottom, f + c.height);
+  return 0 <= b.top && 0 <= b.left && b.bottom > b.top && b.right > b.left ? b : null;
+};
+goog.style.getContainerOffsetToScrollInto = function(a, b, c) {
+  var d = b || goog.dom.getDocumentScrollElement(), e = goog.style.getPageOffset(a), f = goog.style.getPageOffset(d), g = goog.style.getBorderBox(d);
+  d == goog.dom.getDocumentScrollElement() ? (b = e.x - d.scrollLeft, e = e.y - d.scrollTop, goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(10) && (b += g.left, e += g.top)) : (b = e.x - f.x - g.left, e = e.y - f.y - g.top);
+  g = d.clientWidth - a.offsetWidth;
+  a = d.clientHeight - a.offsetHeight;
+  f = d.scrollLeft;
+  d = d.scrollTop;
+  c ? (f += b - g / 2, d += e - a / 2) : (f += Math.min(b, Math.max(b - g, 0)), d += Math.min(e, Math.max(e - a, 0)));
+  return new goog.math.Coordinate(f, d);
+};
+goog.style.scrollIntoContainerView = function(a, b, c) {
+  b = b || goog.dom.getDocumentScrollElement();
+  a = goog.style.getContainerOffsetToScrollInto(a, b, c);
+  b.scrollLeft = a.x;
+  b.scrollTop = a.y;
+};
+goog.style.getClientLeftTop = function(a) {
+  return new goog.math.Coordinate(a.clientLeft, a.clientTop);
+};
+goog.style.getPageOffset = function(a) {
+  var b = goog.dom.getOwnerDocument(a);
+  goog.asserts.assertObject(a, "Parameter is required");
+  var c = new goog.math.Coordinate(0, 0), d = goog.style.getClientViewportElement(b);
+  if (a == d) {
+    return c;
+  }
+  a = goog.style.getBoundingClientRect_(a);
+  b = goog.dom.getDomHelper(b).getDocumentScroll();
+  c.x = a.left + b.x;
+  c.y = a.top + b.y;
+  return c;
+};
+goog.style.getPageOffsetLeft = function(a) {
+  return goog.style.getPageOffset(a).x;
+};
+goog.style.getPageOffsetTop = function(a) {
+  return goog.style.getPageOffset(a).y;
+};
+goog.style.getFramedPageOffset = function(a, b) {
+  var c = new goog.math.Coordinate(0, 0), d = goog.dom.getWindow(goog.dom.getOwnerDocument(a)), e = a;
+  do {
+    var f = d == b ? goog.style.getPageOffset(e) : goog.style.getClientPositionForElement_(goog.asserts.assert(e));
+    c.x += f.x;
+    c.y += f.y;
+  } while (d && d != b && d != d.parent && (e = d.frameElement) && (d = d.parent));
+  return c;
+};
+goog.style.translateRectForAnotherFrame = function(a, b, c) {
+  if (b.getDocument() != c.getDocument()) {
+    var d = b.getDocument().body;
+    c = goog.style.getFramedPageOffset(d, c.getWindow());
+    c = goog.math.Coordinate.difference(c, goog.style.getPageOffset(d));
+    !goog.userAgent.IE || goog.userAgent.isDocumentModeOrHigher(9) || b.isCss1CompatMode() || (c = goog.math.Coordinate.difference(c, b.getDocumentScroll()));
+    a.left += c.x;
+    a.top += c.y;
+  }
+};
+goog.style.getRelativePosition = function(a, b) {
+  var c = goog.style.getClientPosition(a), d = goog.style.getClientPosition(b);
+  return new goog.math.Coordinate(c.x - d.x, c.y - d.y);
+};
+goog.style.getClientPositionForElement_ = function(a) {
+  a = goog.style.getBoundingClientRect_(a);
+  return new goog.math.Coordinate(a.left, a.top);
+};
+goog.style.getClientPosition = function(a) {
+  goog.asserts.assert(a);
+  if (a.nodeType == goog.dom.NodeType.ELEMENT) {
+    return goog.style.getClientPositionForElement_(a);
+  }
+  a = a.changedTouches ? a.changedTouches[0] : a;
+  return new goog.math.Coordinate(a.clientX, a.clientY);
+};
+goog.style.setPageOffset = function(a, b, c) {
+  var d = goog.style.getPageOffset(a);
+  b instanceof goog.math.Coordinate && (c = b.y, b = b.x);
+  goog.style.setPosition(a, a.offsetLeft + (b - d.x), a.offsetTop + (c - d.y));
+};
+goog.style.setSize = function(a, b, c) {
+  if (b instanceof goog.math.Size) {
+    c = b.height, b = b.width;
+  } else {
+    if (void 0 == c) {
+      throw Error("missing height argument");
+    }
+  }
+  goog.style.setWidth(a, b);
+  goog.style.setHeight(a, c);
+};
+goog.style.getPixelStyleValue_ = function(a, b) {
+  "number" == typeof a && (a = (b ? Math.round(a) : a) + "px");
+  return a;
+};
+goog.style.setHeight = function(a, b) {
+  a.style.height = goog.style.getPixelStyleValue_(b, !0);
+};
+goog.style.setWidth = function(a, b) {
+  a.style.width = goog.style.getPixelStyleValue_(b, !0);
+};
+goog.style.getSize = function(a) {
+  return goog.style.evaluateWithTemporaryDisplay_(goog.style.getSizeWithDisplay_, a);
+};
+goog.style.evaluateWithTemporaryDisplay_ = function(a, b) {
+  if ("none" != goog.style.getStyle_(b, "display")) {
+    return a(b);
+  }
+  var c = b.style, d = c.display, e = c.visibility, f = c.position;
+  c.visibility = "hidden";
+  c.position = "absolute";
+  c.display = "inline";
+  var g = a(b);
+  c.display = d;
+  c.position = f;
+  c.visibility = e;
+  return g;
+};
+goog.style.getSizeWithDisplay_ = function(a) {
+  var b = a.offsetWidth, c = a.offsetHeight, d = goog.userAgent.WEBKIT && !b && !c;
+  return goog.isDef(b) && !d || !a.getBoundingClientRect ? new goog.math.Size(b, c) : (a = goog.style.getBoundingClientRect_(a), new goog.math.Size(a.right - a.left, a.bottom - a.top));
+};
+goog.style.getTransformedSize = function(a) {
+  if (!a.getBoundingClientRect) {
+    return null;
+  }
+  a = goog.style.evaluateWithTemporaryDisplay_(goog.style.getBoundingClientRect_, a);
+  return new goog.math.Size(a.right - a.left, a.bottom - a.top);
+};
+goog.style.getBounds = function(a) {
+  var b = goog.style.getPageOffset(a);
+  a = goog.style.getSize(a);
+  return new goog.math.Rect(b.x, b.y, a.width, a.height);
+};
+goog.style.toCamelCase = function(a) {
+  return goog.string.toCamelCase(String(a));
+};
+goog.style.toSelectorCase = function(a) {
+  return goog.string.toSelectorCase(a);
+};
+goog.style.getOpacity = function(a) {
+  var b = a.style;
+  a = "";
+  "opacity" in b ? a = b.opacity : "MozOpacity" in b ? a = b.MozOpacity : "filter" in b && (b = b.filter.match(/alpha\(opacity=([\d.]+)\)/)) && (a = String(b[1] / 100));
+  return "" == a ? a : Number(a);
+};
+goog.style.setOpacity = function(a, b) {
+  var c = a.style;
+  "opacity" in c ? c.opacity = b : "MozOpacity" in c ? c.MozOpacity = b : "filter" in c && (c.filter = "" === b ? "" : "alpha(opacity=" + 100 * b + ")");
+};
+goog.style.setTransparentBackgroundImage = function(a, b) {
+  var c = a.style;
+  goog.userAgent.IE && !goog.userAgent.isVersionOrHigher("8") ? c.filter = 'progid:DXImageTransform.Microsoft.AlphaImageLoader(src="' + b + '", sizingMethod="crop")' : (c.backgroundImage = "url(" + b + ")", c.backgroundPosition = "top left", c.backgroundRepeat = "no-repeat");
+};
+goog.style.clearTransparentBackgroundImage = function(a) {
+  a = a.style;
+  "filter" in a ? a.filter = "" : a.backgroundImage = "none";
+};
+goog.style.showElement = function(a, b) {
+  goog.style.setElementShown(a, b);
+};
+goog.style.setElementShown = function(a, b) {
+  a.style.display = b ? "" : "none";
+};
+goog.style.isElementShown = function(a) {
+  return "none" != a.style.display;
+};
+goog.style.installStyles = function(a, b) {
+  var c = goog.dom.getDomHelper(b), d = null, e = c.getDocument();
+  goog.userAgent.IE && e.createStyleSheet ? (d = e.createStyleSheet(), goog.style.setStyles(d, a)) : (e = c.getElementsByTagNameAndClass(goog.dom.TagName.HEAD)[0], e || (d = c.getElementsByTagNameAndClass(goog.dom.TagName.BODY)[0], e = c.createDom(goog.dom.TagName.HEAD), d.parentNode.insertBefore(e, d)), d = c.createDom(goog.dom.TagName.STYLE), goog.style.setStyles(d, a), c.appendChild(e, d));
+  return d;
+};
+goog.style.uninstallStyles = function(a) {
+  goog.dom.removeNode(a.ownerNode || a.owningElement || a);
+};
+goog.style.setStyles = function(a, b) {
+  goog.userAgent.IE && goog.isDef(a.cssText) ? a.cssText = b : a.innerHTML = b;
+};
+goog.style.setPreWrap = function(a) {
+  a = a.style;
+  goog.userAgent.IE && !goog.userAgent.isVersionOrHigher("8") ? (a.whiteSpace = "pre", a.wordWrap = "break-word") : a.whiteSpace = goog.userAgent.GECKO ? "-moz-pre-wrap" : "pre-wrap";
+};
+goog.style.setInlineBlock = function(a) {
+  a = a.style;
+  a.position = "relative";
+  goog.userAgent.IE && !goog.userAgent.isVersionOrHigher("8") ? (a.zoom = "1", a.display = "inline") : a.display = "inline-block";
+};
+goog.style.isRightToLeft = function(a) {
+  return "rtl" == goog.style.getStyle_(a, "direction");
+};
+goog.style.unselectableStyle_ = goog.userAgent.GECKO ? "MozUserSelect" : goog.userAgent.WEBKIT ? "WebkitUserSelect" : null;
+goog.style.isUnselectable = function(a) {
+  return goog.style.unselectableStyle_ ? "none" == a.style[goog.style.unselectableStyle_].toLowerCase() : goog.userAgent.IE || goog.userAgent.OPERA ? "on" == a.getAttribute("unselectable") : !1;
+};
+goog.style.setUnselectable = function(a, b, c) {
+  c = c ? null : a.getElementsByTagName("*");
+  var d = goog.style.unselectableStyle_;
+  if (d) {
+    if (b = b ? "none" : "", a.style && (a.style[d] = b), c) {
+      a = 0;
+      for (var e;e = c[a];a++) {
+        e.style && (e.style[d] = b);
+      }
+    }
+  } else {
+    if (goog.userAgent.IE || goog.userAgent.OPERA) {
+      if (b = b ? "on" : "", a.setAttribute("unselectable", b), c) {
+        for (a = 0;e = c[a];a++) {
+          e.setAttribute("unselectable", b);
+        }
+      }
+    }
+  }
+};
+goog.style.getBorderBoxSize = function(a) {
+  return new goog.math.Size(a.offsetWidth, a.offsetHeight);
+};
+goog.style.setBorderBoxSize = function(a, b) {
+  var c = goog.dom.getOwnerDocument(a), d = goog.dom.getDomHelper(c).isCss1CompatMode();
+  if (!goog.userAgent.IE || goog.userAgent.isVersionOrHigher("10") || d && goog.userAgent.isVersionOrHigher("8")) {
+    goog.style.setBoxSizingSize_(a, b, "border-box");
+  } else {
+    if (c = a.style, d) {
+      var d = goog.style.getPaddingBox(a), e = goog.style.getBorderBox(a);
+      c.pixelWidth = b.width - e.left - d.left - d.right - e.right;
+      c.pixelHeight = b.height - e.top - d.top - d.bottom - e.bottom;
+    } else {
+      c.pixelWidth = b.width, c.pixelHeight = b.height;
+    }
+  }
+};
+goog.style.getContentBoxSize = function(a) {
+  var b = goog.dom.getOwnerDocument(a), c = goog.userAgent.IE && a.currentStyle;
+  if (c && goog.dom.getDomHelper(b).isCss1CompatMode() && "auto" != c.width && "auto" != c.height && !c.boxSizing) {
+    return b = goog.style.getIePixelValue_(a, c.width, "width", "pixelWidth"), a = goog.style.getIePixelValue_(a, c.height, "height", "pixelHeight"), new goog.math.Size(b, a);
+  }
+  c = goog.style.getBorderBoxSize(a);
+  b = goog.style.getPaddingBox(a);
+  a = goog.style.getBorderBox(a);
+  return new goog.math.Size(c.width - a.left - b.left - b.right - a.right, c.height - a.top - b.top - b.bottom - a.bottom);
+};
+goog.style.setContentBoxSize = function(a, b) {
+  var c = goog.dom.getOwnerDocument(a), d = goog.dom.getDomHelper(c).isCss1CompatMode();
+  if (!goog.userAgent.IE || goog.userAgent.isVersionOrHigher("10") || d && goog.userAgent.isVersionOrHigher("8")) {
+    goog.style.setBoxSizingSize_(a, b, "content-box");
+  } else {
+    if (c = a.style, d) {
+      c.pixelWidth = b.width, c.pixelHeight = b.height;
+    } else {
+      var d = goog.style.getPaddingBox(a), e = goog.style.getBorderBox(a);
+      c.pixelWidth = b.width + e.left + d.left + d.right + e.right;
+      c.pixelHeight = b.height + e.top + d.top + d.bottom + e.bottom;
+    }
+  }
+};
+goog.style.setBoxSizingSize_ = function(a, b, c) {
+  a = a.style;
+  goog.userAgent.GECKO ? a.MozBoxSizing = c : goog.userAgent.WEBKIT ? a.WebkitBoxSizing = c : a.boxSizing = c;
+  a.width = Math.max(b.width, 0) + "px";
+  a.height = Math.max(b.height, 0) + "px";
+};
+goog.style.getIePixelValue_ = function(a, b, c, d) {
+  if (/^\d+px?$/.test(b)) {
+    return parseInt(b, 10);
+  }
+  var e = a.style[c], f = a.runtimeStyle[c];
+  a.runtimeStyle[c] = a.currentStyle[c];
+  a.style[c] = b;
+  b = a.style[d];
+  a.style[c] = e;
+  a.runtimeStyle[c] = f;
+  return b;
+};
+goog.style.getIePixelDistance_ = function(a, b) {
+  var c = goog.style.getCascadedStyle(a, b);
+  return c ? goog.style.getIePixelValue_(a, c, "left", "pixelLeft") : 0;
+};
+goog.style.getBox_ = function(a, b) {
+  if (goog.userAgent.IE) {
+    var c = goog.style.getIePixelDistance_(a, b + "Left"), d = goog.style.getIePixelDistance_(a, b + "Right"), e = goog.style.getIePixelDistance_(a, b + "Top"), f = goog.style.getIePixelDistance_(a, b + "Bottom");
+    return new goog.math.Box(e, d, f, c);
+  }
+  c = goog.style.getComputedStyle(a, b + "Left");
+  d = goog.style.getComputedStyle(a, b + "Right");
+  e = goog.style.getComputedStyle(a, b + "Top");
+  f = goog.style.getComputedStyle(a, b + "Bottom");
+  return new goog.math.Box(parseFloat(e), parseFloat(d), parseFloat(f), parseFloat(c));
+};
+goog.style.getPaddingBox = function(a) {
+  return goog.style.getBox_(a, "padding");
+};
+goog.style.getMarginBox = function(a) {
+  return goog.style.getBox_(a, "margin");
+};
+goog.style.ieBorderWidthKeywords_ = {thin:2, medium:4, thick:6};
+goog.style.getIePixelBorder_ = function(a, b) {
+  if ("none" == goog.style.getCascadedStyle(a, b + "Style")) {
+    return 0;
+  }
+  var c = goog.style.getCascadedStyle(a, b + "Width");
+  return c in goog.style.ieBorderWidthKeywords_ ? goog.style.ieBorderWidthKeywords_[c] : goog.style.getIePixelValue_(a, c, "left", "pixelLeft");
+};
+goog.style.getBorderBox = function(a) {
+  if (goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9)) {
+    var b = goog.style.getIePixelBorder_(a, "borderLeft"), c = goog.style.getIePixelBorder_(a, "borderRight"), d = goog.style.getIePixelBorder_(a, "borderTop");
+    a = goog.style.getIePixelBorder_(a, "borderBottom");
+    return new goog.math.Box(d, c, a, b);
+  }
+  b = goog.style.getComputedStyle(a, "borderLeftWidth");
+  c = goog.style.getComputedStyle(a, "borderRightWidth");
+  d = goog.style.getComputedStyle(a, "borderTopWidth");
+  a = goog.style.getComputedStyle(a, "borderBottomWidth");
+  return new goog.math.Box(parseFloat(d), parseFloat(c), parseFloat(a), parseFloat(b));
+};
+goog.style.getFontFamily = function(a) {
+  var b = goog.dom.getOwnerDocument(a), c = "";
+  if (b.body.createTextRange && goog.dom.contains(b, a)) {
+    b = b.body.createTextRange();
+    b.moveToElementText(a);
+    try {
+      c = b.queryCommandValue("FontName");
+    } catch (d) {
+      c = "";
+    }
+  }
+  c || (c = goog.style.getStyle_(a, "fontFamily"));
+  a = c.split(",");
+  1 < a.length && (c = a[0]);
+  return goog.string.stripQuotes(c, "\"'");
+};
+goog.style.lengthUnitRegex_ = /[^\d]+$/;
+goog.style.getLengthUnits = function(a) {
+  return (a = a.match(goog.style.lengthUnitRegex_)) && a[0] || null;
+};
+goog.style.ABSOLUTE_CSS_LENGTH_UNITS_ = {cm:1, "in":1, mm:1, pc:1, pt:1};
+goog.style.CONVERTIBLE_RELATIVE_CSS_UNITS_ = {em:1, ex:1};
+goog.style.getFontSize = function(a) {
+  var b = goog.style.getStyle_(a, "fontSize"), c = goog.style.getLengthUnits(b);
+  if (b && "px" == c) {
+    return parseInt(b, 10);
+  }
+  if (goog.userAgent.IE) {
+    if (c in goog.style.ABSOLUTE_CSS_LENGTH_UNITS_) {
+      return goog.style.getIePixelValue_(a, b, "left", "pixelLeft");
+    }
+    if (a.parentNode && a.parentNode.nodeType == goog.dom.NodeType.ELEMENT && c in goog.style.CONVERTIBLE_RELATIVE_CSS_UNITS_) {
+      return a = a.parentNode, c = goog.style.getStyle_(a, "fontSize"), goog.style.getIePixelValue_(a, b == c ? "1em" : b, "left", "pixelLeft");
+    }
+  }
+  c = goog.dom.createDom(goog.dom.TagName.SPAN, {style:"visibility:hidden;position:absolute;line-height:0;padding:0;margin:0;border:0;height:1em;"});
+  goog.dom.appendChild(a, c);
+  b = c.offsetHeight;
+  goog.dom.removeNode(c);
+  return b;
+};
+goog.style.parseStyleAttribute = function(a) {
+  var b = {};
+  goog.array.forEach(a.split(/\s*;\s*/), function(a) {
+    var d = a.match(/\s*([\w-]+)\s*\:(.+)/);
+    d && (a = d[1], d = goog.string.trim(d[2]), b[goog.string.toCamelCase(a.toLowerCase())] = d);
+  });
+  return b;
+};
+goog.style.toStyleAttribute = function(a) {
+  var b = [];
+  goog.object.forEach(a, function(a, d) {
+    b.push(goog.string.toSelectorCase(d), ":", a, ";");
+  });
+  return b.join("");
+};
+goog.style.setFloat = function(a, b) {
+  a.style[goog.userAgent.IE ? "styleFloat" : "cssFloat"] = b;
+};
+goog.style.getFloat = function(a) {
+  return a.style[goog.userAgent.IE ? "styleFloat" : "cssFloat"] || "";
+};
+goog.style.getScrollbarWidth = function(a) {
+  var b = goog.dom.createElement(goog.dom.TagName.DIV);
+  a && (b.className = a);
+  b.style.cssText = "overflow:auto;position:absolute;top:0;width:100px;height:100px";
+  a = goog.dom.createElement(goog.dom.TagName.DIV);
+  goog.style.setSize(a, "200px", "200px");
+  b.appendChild(a);
+  goog.dom.appendChild(goog.dom.getDocument().body, b);
+  a = b.offsetWidth - b.clientWidth;
+  goog.dom.removeNode(b);
+  return a;
+};
+goog.style.MATRIX_TRANSLATION_REGEX_ = /matrix\([0-9\.\-]+, [0-9\.\-]+, [0-9\.\-]+, [0-9\.\-]+, ([0-9\.\-]+)p?x?, ([0-9\.\-]+)p?x?\)/;
+goog.style.getCssTranslation = function(a) {
+  a = goog.style.getComputedTransform(a);
+  return a ? (a = a.match(goog.style.MATRIX_TRANSLATION_REGEX_)) ? new goog.math.Coordinate(parseFloat(a[1]), parseFloat(a[2])) : new goog.math.Coordinate(0, 0) : new goog.math.Coordinate(0, 0);
+};
+goog.debug.DivConsole = function(a) {
+  this.publishHandler_ = goog.bind(this.addLogRecord, this);
+  this.formatter_ = new goog.debug.HtmlFormatter;
+  this.isCapturing_ = this.formatter_.showAbsoluteTime = !1;
+  this.element_ = a;
+  this.elementOwnerDocument_ = this.element_.ownerDocument || this.element_.document;
+  this.installStyles();
+};
+goog.debug.DivConsole.prototype.installStyles = function() {
+  goog.style.installStyles(".dbg-sev{color:#F00}.dbg-w{color:#C40}.dbg-sh{font-weight:bold;color:#000}.dbg-i{color:#444}.dbg-f{color:#999}.dbg-ev{color:#0A0}.dbg-m{color:#990}.logmsg{border-bottom:1px solid #CCC;padding:2px}.logsep{background-color: #8C8;}.logdiv{border:1px solid #CCC;background-color:#FCFCFC;font:medium monospace}", this.element_);
+  this.element_.className += " logdiv";
+};
+goog.debug.DivConsole.prototype.setCapturing = function(a) {
+  if (a != this.isCapturing_) {
+    var b = goog.debug.LogManager.getRoot();
+    a ? b.addHandler(this.publishHandler_) : (b.removeHandler(this.publishHandler_), this.logBuffer = "");
+    this.isCapturing_ = a;
+  }
+};
+goog.debug.DivConsole.prototype.addLogRecord = function(a) {
+  if (a) {
+    var b = 100 >= this.element_.scrollHeight - this.element_.scrollTop - this.element_.clientHeight, c = this.elementOwnerDocument_.createElement(goog.dom.TagName.DIV);
+    c.className = "logmsg";
+    goog.dom.safe.setInnerHtml(c, this.formatter_.formatRecordAsHtml(a));
+    this.element_.appendChild(c);
+    b && (this.element_.scrollTop = this.element_.scrollHeight);
+  }
+};
+goog.debug.DivConsole.prototype.getFormatter = function() {
+  return this.formatter_;
+};
+goog.debug.DivConsole.prototype.setFormatter = function(a) {
+  this.formatter_ = a;
+};
+goog.debug.DivConsole.prototype.addSeparator = function() {
+  var a = this.elementOwnerDocument_.createElement(goog.dom.TagName.DIV);
+  a.className = "logmsg logsep";
+  this.element_.appendChild(a);
+};
+goog.debug.DivConsole.prototype.clear = function() {
+  this.element_ && goog.dom.safe.setInnerHtml(this.element_, goog.html.SafeHtml.EMPTY);
+};
+goog.log = {};
+goog.log.ENABLED = goog.debug.LOGGING_ENABLED;
+goog.log.ROOT_LOGGER_NAME = goog.debug.Logger.ROOT_LOGGER_NAME;
+goog.log.Logger = goog.debug.Logger;
+goog.log.Level = goog.debug.Logger.Level;
+goog.log.LogRecord = goog.debug.LogRecord;
+goog.log.getLogger = function(a, b) {
+  if (goog.log.ENABLED) {
+    var c = goog.debug.LogManager.getLogger(a);
+    b && c && c.setLevel(b);
+    return c;
+  }
+  return null;
+};
+goog.log.addHandler = function(a, b) {
+  goog.log.ENABLED && a && a.addHandler(b);
+};
+goog.log.removeHandler = function(a, b) {
+  return goog.log.ENABLED && a ? a.removeHandler(b) : !1;
+};
+goog.log.log = function(a, b, c, d) {
+  goog.log.ENABLED && a && a.log(b, c, d);
+};
+goog.log.error = function(a, b, c) {
+  goog.log.ENABLED && a && a.severe(b, c);
+};
+goog.log.warning = function(a, b, c) {
+  goog.log.ENABLED && a && a.warning(b, c);
+};
+goog.log.info = function(a, b, c) {
+  goog.log.ENABLED && a && a.info(b, c);
+};
+goog.log.fine = function(a, b, c) {
+  goog.log.ENABLED && a && a.fine(b, c);
+};
+goog.userAgent.product = {};
+goog.userAgent.product.ASSUME_FIREFOX = !1;
+goog.userAgent.product.ASSUME_IPHONE = !1;
+goog.userAgent.product.ASSUME_IPAD = !1;
+goog.userAgent.product.ASSUME_ANDROID = !1;
+goog.userAgent.product.ASSUME_CHROME = !1;
+goog.userAgent.product.ASSUME_SAFARI = !0;
+goog.userAgent.product.PRODUCT_KNOWN_ = goog.userAgent.ASSUME_IE || goog.userAgent.ASSUME_EDGE || goog.userAgent.ASSUME_OPERA || goog.userAgent.product.ASSUME_FIREFOX || goog.userAgent.product.ASSUME_IPHONE || goog.userAgent.product.ASSUME_IPAD || goog.userAgent.product.ASSUME_ANDROID || goog.userAgent.product.ASSUME_CHROME || goog.userAgent.product.ASSUME_SAFARI;
+goog.userAgent.product.OPERA = goog.userAgent.OPERA;
+goog.userAgent.product.IE = goog.userAgent.IE;
+goog.userAgent.product.EDGE = goog.userAgent.EDGE;
+goog.userAgent.product.FIREFOX = goog.userAgent.product.PRODUCT_KNOWN_ ? goog.userAgent.product.ASSUME_FIREFOX : goog.labs.userAgent.browser.isFirefox();
+goog.userAgent.product.isIphoneOrIpod_ = function() {
+  return goog.labs.userAgent.platform.isIphone() || goog.labs.userAgent.platform.isIpod();
+};
+goog.userAgent.product.IPHONE = goog.userAgent.product.PRODUCT_KNOWN_ ? goog.userAgent.product.ASSUME_IPHONE : goog.userAgent.product.isIphoneOrIpod_();
+goog.userAgent.product.IPAD = goog.userAgent.product.PRODUCT_KNOWN_ ? goog.userAgent.product.ASSUME_IPAD : goog.labs.userAgent.platform.isIpad();
+goog.userAgent.product.ANDROID = goog.userAgent.product.PRODUCT_KNOWN_ ? goog.userAgent.product.ASSUME_ANDROID : goog.labs.userAgent.browser.isAndroidBrowser();
+goog.userAgent.product.CHROME = goog.userAgent.product.PRODUCT_KNOWN_ ? goog.userAgent.product.ASSUME_CHROME : goog.labs.userAgent.browser.isChrome();
+goog.userAgent.product.isSafariDesktop_ = function() {
+  return goog.labs.userAgent.browser.isSafari() && !goog.labs.userAgent.platform.isIos();
+};
+goog.userAgent.product.SAFARI = goog.userAgent.product.PRODUCT_KNOWN_ ? goog.userAgent.product.ASSUME_SAFARI : goog.userAgent.product.isSafariDesktop_();
+goog.userAgent.product.determineVersion_ = function() {
+  if (goog.userAgent.product.FIREFOX) {
+    return goog.userAgent.product.getFirstRegExpGroup_(/Firefox\/([0-9.]+)/);
+  }
+  if (goog.userAgent.product.IE || goog.userAgent.product.EDGE || goog.userAgent.product.OPERA) {
+    return goog.userAgent.VERSION;
+  }
+  if (goog.userAgent.product.CHROME) {
+    return goog.userAgent.product.getFirstRegExpGroup_(/Chrome\/([0-9.]+)/);
+  }
+  if (goog.userAgent.product.SAFARI && !goog.labs.userAgent.platform.isIos()) {
+    return goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);
+  }
+  if (goog.userAgent.product.IPHONE || goog.userAgent.product.IPAD) {
+    var a = goog.userAgent.product.execRegExp_(/Version\/(\S+).*Mobile\/(\S+)/);
+    if (a) {
+      return a[1] + "." + a[2];
+    }
+  } else {
+    if (goog.userAgent.product.ANDROID) {
+      return (a = goog.userAgent.product.getFirstRegExpGroup_(/Android\s+([0-9.]+)/)) ? a : goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);
+    }
+  }
+  return "";
+};
+goog.userAgent.product.getFirstRegExpGroup_ = function(a) {
+  return (a = goog.userAgent.product.execRegExp_(a)) ? a[1] : "";
+};
+goog.userAgent.product.execRegExp_ = function(a) {
+  return a.exec(goog.userAgent.getUserAgentString());
+};
+goog.userAgent.product.VERSION = goog.userAgent.product.determineVersion_();
+goog.userAgent.product.isVersion = function(a) {
+  return 0 <= goog.string.compareVersions(goog.userAgent.product.VERSION, a);
+};
+var bot = {userAgent:{}};
+bot.userAgent.isEngineVersion = function(a) {
+  return bot.userAgent.FIREFOX_EXTENSION ? bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_(a) : goog.userAgent.IE ? 0 <= goog.string.compareVersions(goog.userAgent.DOCUMENT_MODE, a) : goog.userAgent.isVersionOrHigher(a);
+};
+bot.userAgent.isProductVersion = function(a) {
+  return bot.userAgent.FIREFOX_EXTENSION ? bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_(a) : goog.userAgent.product.ANDROID ? 0 <= goog.string.compareVersions(bot.userAgent.ANDROID_VERSION_, a) : goog.userAgent.product.isVersion(a);
+};
+bot.userAgent.FIREFOX_EXTENSION = function() {
+  if (!goog.userAgent.GECKO) {
+    return !1;
+  }
+  var a = goog.global.Components;
+  if (!a) {
+    return !1;
+  }
+  try {
+    if (!a.classes) {
+      return !1;
+    }
+  } catch (f) {
+    return !1;
+  }
+  var b = a.classes, a = a.interfaces, c = b["@mozilla.org/xpcom/version-comparator;1"].getService(a.nsIVersionComparator), b = b["@mozilla.org/xre/app-info;1"].getService(a.nsIXULAppInfo), d = b.platformVersion, e = b.version;
+  bot.userAgent.FIREFOX_EXTENSION_IS_ENGINE_VERSION_ = function(a) {
+    return 0 <= c.compare(d, "" + a);
+  };
+  bot.userAgent.FIREFOX_EXTENSION_IS_PRODUCT_VERSION_ = function(a) {
+    return 0 <= c.compare(e, "" + a);
+  };
+  return !0;
+}();
+bot.userAgent.IOS = goog.userAgent.product.IPAD || goog.userAgent.product.IPHONE;
+bot.userAgent.MOBILE = bot.userAgent.IOS || goog.userAgent.product.ANDROID;
+bot.userAgent.ANDROID_VERSION_ = function() {
+  if (goog.userAgent.product.ANDROID) {
+    var a = goog.userAgent.getUserAgentString();
+    return (a = /Android\s+([0-9\.]+)/.exec(a)) ? a[1] : "0";
+  }
+  return "0";
+}();
+bot.userAgent.IE_DOC_PRE8 = goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(8);
+bot.userAgent.IE_DOC_9 = goog.userAgent.isDocumentModeOrHigher(9);
+bot.userAgent.IE_DOC_PRE9 = goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9);
+bot.userAgent.IE_DOC_10 = goog.userAgent.isDocumentModeOrHigher(10);
+bot.userAgent.IE_DOC_PRE10 = goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(10);
+bot.userAgent.ANDROID_PRE_GINGERBREAD = goog.userAgent.product.ANDROID && !bot.userAgent.isProductVersion(2.3);
+bot.userAgent.ANDROID_PRE_ICECREAMSANDWICH = goog.userAgent.product.ANDROID && !bot.userAgent.isProductVersion(4);
+bot.userAgent.SAFARI_6 = goog.userAgent.product.SAFARI && bot.userAgent.isProductVersion(6);
+bot.userAgent.WINDOWS_PHONE = goog.userAgent.IE && -1 != goog.userAgent.getUserAgentString().indexOf("IEMobile");
+goog.json = {};
+goog.json.USE_NATIVE_JSON = !1;
+goog.json.isValid = function(a) {
+  return /^\s*$/.test(a) ? !1 : /^[\],:{}\s\u2028\u2029]*$/.test(a.replace(/\\["\\\/bfnrtu]/g, "@").replace(/"[^"\\\n\r\u2028\u2029\x00-\x08\x0a-\x1f]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, "]").replace(/(?:^|:|,)(?:[\s\u2028\u2029]*\[)+/g, ""));
+};
+goog.json.parse = goog.json.USE_NATIVE_JSON ? goog.global.JSON.parse : function(a) {
+  a = String(a);
+  if (goog.json.isValid(a)) {
+    try {
+      return eval("(" + a + ")");
+    } catch (b) {
+    }
+  }
+  throw Error("Invalid JSON string: " + a);
+};
+goog.json.unsafeParse = goog.json.USE_NATIVE_JSON ? goog.global.JSON.parse : function(a) {
+  return eval("(" + a + ")");
+};
+goog.json.serialize = goog.json.USE_NATIVE_JSON ? goog.global.JSON.stringify : function(a, b) {
+  return (new goog.json.Serializer(b)).serialize(a);
+};
+goog.json.Serializer = function(a) {
+  this.replacer_ = a;
+};
+goog.json.Serializer.prototype.serialize = function(a) {
+  var b = [];
+  this.serializeInternal(a, b);
+  return b.join("");
+};
+goog.json.Serializer.prototype.serializeInternal = function(a, b) {
+  if (null == a) {
+    b.push("null");
+  } else {
+    if ("object" == typeof a) {
+      if (goog.isArray(a)) {
+        this.serializeArray(a, b);
+        return;
+      }
+      if (a instanceof String || a instanceof Number || a instanceof Boolean) {
+        a = a.valueOf();
+      } else {
+        this.serializeObject_(a, b);
+        return;
+      }
+    }
+    switch(typeof a) {
+      case "string":
+        this.serializeString_(a, b);
+        break;
+      case "number":
+        this.serializeNumber_(a, b);
+        break;
+      case "boolean":
+        b.push(String(a));
+        break;
+      case "function":
+        b.push("null");
+        break;
+      default:
+        throw Error("Unknown type: " + typeof a);;
+    }
+  }
+};
+goog.json.Serializer.charToJsonCharCache_ = {'"':'\\"', "\\":"\\\\", "/":"\\/", "\b":"\\b", "\f":"\\f", "\n":"\\n", "\r":"\\r", "\t":"\\t", "\x0B":"\\u000b"};
+goog.json.Serializer.charsToReplace_ = /\uffff/.test("\uffff") ? /[\\\"\x00-\x1f\x7f-\uffff]/g : /[\\\"\x00-\x1f\x7f-\xff]/g;
+goog.json.Serializer.prototype.serializeString_ = function(a, b) {
+  b.push('"', a.replace(goog.json.Serializer.charsToReplace_, function(a) {
+    var b = goog.json.Serializer.charToJsonCharCache_[a];
+    b || (b = "\\u" + (a.charCodeAt(0) | 65536).toString(16).substr(1), goog.json.Serializer.charToJsonCharCache_[a] = b);
+    return b;
+  }), '"');
+};
+goog.json.Serializer.prototype.serializeNumber_ = function(a, b) {
+  b.push(isFinite(a) && !isNaN(a) ? String(a) : "null");
+};
+goog.json.Serializer.prototype.serializeArray = function(a, b) {
+  var c = a.length;
+  b.push("[");
+  for (var d = "", e = 0;e < c;e++) {
+    b.push(d), d = a[e], this.serializeInternal(this.replacer_ ? this.replacer_.call(a, String(e), d) : d, b), d = ",";
+  }
+  b.push("]");
+};
+goog.json.Serializer.prototype.serializeObject_ = function(a, b) {
+  b.push("{");
+  var c = "", d;
+  for (d in a) {
+    if (Object.prototype.hasOwnProperty.call(a, d)) {
+      var e = a[d];
+      "function" != typeof e && (b.push(c), this.serializeString_(d, b), b.push(":"), this.serializeInternal(this.replacer_ ? this.replacer_.call(a, d, e) : e, b), c = ",");
+    }
+  }
+  b.push("}");
+};
+bot.json = {};
+bot.json.NATIVE_JSON = !0;
+bot.json.SUPPORTS_NATIVE_JSON_ = goog.userAgent.WEBKIT || goog.userAgent.GECKO && bot.userAgent.isEngineVersion(3.5) || goog.userAgent.IE && bot.userAgent.isEngineVersion(8);
+bot.json.stringify = bot.json.NATIVE_JSON && bot.json.SUPPORTS_NATIVE_JSON_ ? JSON.stringify : goog.json.serialize;
+bot.json.parse = bot.json.NATIVE_JSON && bot.json.SUPPORTS_NATIVE_JSON_ ? JSON.parse : goog.json.parse;
+var safaridriver = {dom:{}};
+safaridriver.dom.call = function(a, b, c) {
+  var d = a.constructor;
+  if (a.window === a) {
+    try {
+      var e = a.constructor;
+      delete a.constructor;
+      d = a.constructor;
+      a.constructor = e;
+    } catch (f) {
+    }
+  }
+  return d.prototype[b].apply(a, goog.array.slice(arguments, 2));
+};
+safaridriver.message = {};
+safaridriver.message.ASSUME_DOM_WINDOW = !1;
+safaridriver.message.ORIGIN = "webdriver";
+safaridriver.message.LOG_ = goog.log.getLogger("safaridriver.message");
+safaridriver.message.FORCE_SYNCHRONOUS_PROXY_SEND = !0;
+safaridriver.message.factoryRegistry_ = {};
+safaridriver.message.registerMessageType = function(a, b) {
+  goog.asserts.assert(!(a in safaridriver.message.factoryRegistry_), "Message type has already been registered: " + a);
+  safaridriver.message.factoryRegistry_[a] = b;
+};
+safaridriver.message.throwInvalidMessageError = function(a) {
+  throw Error("Invalid message: " + bot.json.stringify(a));
+};
+safaridriver.message.fromEvent = function(a) {
+  a = a.message || a.data;
+  goog.isString(a) && (a = bot.json.parse(a));
+  if (!goog.isObject(a) || !goog.isString(a[safaridriver.message.Message.Field.ORIGIN]) && !goog.isNumber(a[safaridriver.message.Message.Field.ORIGIN]) || !goog.isString(a[safaridriver.message.Message.Field.TYPE])) {
+    throw safaridriver.message.throwInvalidMessageError(a);
+  }
+  var b = safaridriver.message.factoryRegistry_[a[safaridriver.message.Message.Field.TYPE]];
+  b || (goog.log.fine(safaridriver.message.LOG_, "Unknown message type; falling back to the default factory: " + bot.json.stringify(a)), b = safaridriver.message.Message.fromData_);
+  b = b(a);
+  b.setOrigin(a[safaridriver.message.Message.Field.ORIGIN]);
+  return b;
+};
+safaridriver.message.Message = function(a) {
+  this.data_ = {};
+  this.data_[safaridriver.message.Message.Field.ORIGIN] = safaridriver.message.ORIGIN;
+  this.data_[safaridriver.message.Message.Field.TYPE] = a;
+};
+safaridriver.message.Message.Field = {ORIGIN:"origin", TYPE:"type"};
+safaridriver.message.Message.fromData_ = function(a) {
+  return new safaridriver.message.Message(a[safaridriver.message.Message.Field.TYPE]);
+};
+safaridriver.message.Message.prototype.setField = function(a, b) {
+  goog.asserts.assert(a !== safaridriver.message.Message.Field.TYPE, "The specified field may not be overridden: " + a);
+  this.data_[a] = b;
+};
+safaridriver.message.Message.prototype.getField = function(a) {
+  return this.data_[a];
+};
+safaridriver.message.Message.prototype.setOrigin = function(a) {
+  this.setField(safaridriver.message.Message.Field.ORIGIN, a);
+};
+safaridriver.message.Message.prototype.getOrigin = function() {
+  return this.getField(safaridriver.message.Message.Field.ORIGIN);
+};
+safaridriver.message.Message.prototype.isSameOrigin = function() {
+  return this.getOrigin() === safaridriver.message.ORIGIN;
+};
+safaridriver.message.Message.prototype.getType = function() {
+  return this.getField(safaridriver.message.Message.Field.TYPE);
+};
+safaridriver.message.Message.prototype.isType = function(a) {
+  return this.getField(safaridriver.message.Message.Field.TYPE) === a;
+};
+safaridriver.message.Message.prototype.send = function(a) {
+  this.setOrigin(safaridriver.message.ORIGIN);
+  if (safaridriver.message.ASSUME_DOM_WINDOW || a.postMessage) {
+    if (a === window) {
+      this.sendSync(a);
+    } else {
+      if (!goog.isFunction(a.postMessage)) {
+        throw Error("Unable to send message; postMessage function not available on target window");
+      }
+      a.postMessage(this.data_, "*");
+    }
+  } else {
+    if (safaridriver.message.FORCE_SYNCHRONOUS_PROXY_SEND && a.canLoad) {
+      return this.sendSync(a);
+    }
+    a.dispatchMessage(this.getType(), this.data_);
+  }
+};
+safaridriver.message.Message.SYNCHRONOUS_DOM_MESSAGE_EVENT_TYPE = "safaridriver.message";
+safaridriver.message.Message.SYNCHRONOUS_MESSAGE_RESPONSE_EVENT_TYPE = "safaridriver.message.response";
+safaridriver.message.Message.prototype.sendSync = function(a) {
+  this.setOrigin(safaridriver.message.ORIGIN);
+  if (safaridriver.message.ASSUME_DOM_WINDOW || a.postMessage) {
+    goog.asserts.assert(a === window, "Synchronous messages may only be sent to a window when that window is the same as the current context");
+    var b;
+    a = function(a) {
+      b = a.data;
+    };
+    safaridriver.dom.call(window, "addEventListener", safaridriver.message.Message.SYNCHRONOUS_MESSAGE_RESPONSE_EVENT_TYPE, a, !1);
+    safaridriver.message.Message.sendMessageEvent_(safaridriver.message.Message.SYNCHRONOUS_DOM_MESSAGE_EVENT_TYPE, this.data_);
+    safaridriver.dom.call(window, "removeEventListener", safaridriver.message.Message.SYNCHRONOUS_MESSAGE_RESPONSE_EVENT_TYPE, a, !1);
+    return b;
+  }
+  var c = safaridriver.dom.call(document, "createEvent", "Events");
+  c.initEvent("beforeload", !1, !1);
+  return a.canLoad(c, this.data_);
+};
+safaridriver.message.Message.sendSyncResponse = function(a) {
+  safaridriver.message.Message.sendMessageEvent_(safaridriver.message.Message.SYNCHRONOUS_MESSAGE_RESPONSE_EVENT_TYPE, a);
+};
+safaridriver.message.Message.sendMessageEvent_ = function(a, b) {
+  var c = safaridriver.dom.call(document, "createEvent", "MessageEvent");
+  c.initMessageEvent(a, !1, !1, b, window.location.origin, "0", window, null);
+  safaridriver.dom.call(window, "dispatchEvent", c);
+};
+safaridriver.message.Message.prototype.toJSON = function() {
+  return this.data_;
+};
+safaridriver.message.Message.prototype.toString = function() {
+  return bot.json.stringify(this.toJSON());
+};
+safaridriver.message.Connect = function(a) {
+  safaridriver.message.Message.call(this, safaridriver.message.Connect.TYPE);
+  this.setField(safaridriver.message.Connect.URL_FIELD_, a);
+};
+goog.inherits(safaridriver.message.Connect, safaridriver.message.Message);
+safaridriver.message.Connect.TYPE = "connect";
+safaridriver.message.Connect.URL_FIELD_ = "url";
+safaridriver.message.Connect.fromData_ = function(a) {
+  var b = a[safaridriver.message.Connect.URL_FIELD_];
+  if (!goog.isString(b)) {
+    throw safaridriver.message.throwInvalidMessageError(a);
+  }
+  return new safaridriver.message.Connect(b);
+};
+safaridriver.message.Connect.prototype.getUrl = function() {
+  return this.getField(safaridriver.message.Connect.URL_FIELD_);
+};
+safaridriver.message.registerMessageType(safaridriver.message.Connect.TYPE, safaridriver.message.Connect.fromData_);
+safaridriver.client = {};
+safaridriver.client.init = function() {
+  function a() {
+    e += 1;
+    f.sendSync(window) ? (goog.log.info(c, "Connected to extension"), goog.log.info(c, "Requesting extension connect to client at " + d)) : 5 > e ? setTimeout(a, 250 * e) : goog.log.error(c, "Unable to establish a connection with the SafariDriver extension");
+  }
+  var b = document.createElement("h2");
+  b.innerHTML = "SafariDriver Launcher";
+  document.body.appendChild(b);
+  b = document.createElement("div");
+  document.body.appendChild(b);
+  (new goog.debug.DivConsole(b)).setCapturing(!0);
+  var c = goog.log.getLogger("safaridriver.client"), d = (new goog.Uri(window.location)).getQueryData().get("url");
+  if (d) {
+    d = new goog.Uri(d);
+    goog.log.info(c, "Connecting to SafariDriver browser extension...");
+    goog.log.info(c, "This will fail if you have not installed the latest SafariDriver extension from\nhttp://selenium-release.storage.googleapis.com/index.html");
+    goog.log.info(c, "Extension logs may be viewed by clicking the Selenium [\u2713] button on the Safari toolbar");
+    var e = 0, f = new safaridriver.message.Connect(d.toString());
+    a();
+  } else {
+    goog.log.error(c, "No url specified. Please reload this page with the url parameter set");
+  }
+};
+goog.exportSymbol("init", safaridriver.client.init);
+;window.onload = init;
diff --git a/lib/test/build.js b/lib/test/build.js
index 432ebb9..bd8fc1c 100644
--- a/lib/test/build.js
+++ b/lib/test/build.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
diff --git a/lib/test/data/click_tests/click_iframe.html b/lib/test/data/click_tests/click_iframe.html
new file mode 100644
index 0000000..7b749bc
--- /dev/null
+++ b/lib/test/data/click_tests/click_iframe.html
@@ -0,0 +1,6 @@
+<html>
+<head>
+    <title>click iframe</title>
+</head>
+<body><a id="link" href="submitted_page.html" target="_top">Click me</a></body>
+</html>
\ No newline at end of file
diff --git a/lib/test/data/click_tests/click_in_iframe.html b/lib/test/data/click_tests/click_in_iframe.html
new file mode 100644
index 0000000..60b1cca
--- /dev/null
+++ b/lib/test/data/click_tests/click_in_iframe.html
@@ -0,0 +1,8 @@
+<html>
+<head>
+    <title>click in iframe</title>
+</head>
+<body>
+<iframe id="ifr" src="click_iframe.html" style="margin: 200px; width: 100px; height: 50px;" />
+</body>
+</html>
\ No newline at end of file
diff --git a/lib/test/data/click_tests/disappearing_element.html b/lib/test/data/click_tests/disappearing_element.html
new file mode 100644
index 0000000..4386d5d
--- /dev/null
+++ b/lib/test/data/click_tests/disappearing_element.html
@@ -0,0 +1,62 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <title>An element that disappears on click</title>
+  <style>
+#under {
+  position: absolute;
+  top: 20;
+  left: 20;
+  width: 100px;
+  height: 100px;
+  background-color: white;
+}
+
+#over {
+  position: absolute;
+  top: 20;
+  left: 20;
+  width: 100px;
+  height: 100px;
+  background-color: red;
+  opacity: 0.5;
+}
+
+#log {
+  position: absolute;
+  top: 120px;
+}
+  </style>
+</head>
+<body id="body">
+  <div id="under"><p id="contents">Hello</p></div>
+  <div id="over"></div>
+  <div id="log">
+    <p>Log:<p>
+  </div>
+<script>
+var byId = document.getElementById.bind(document);
+
+var log = byId("log");
+
+function handler(ev) {
+  log.innerHTML += "<p></p>";
+  log.lastElementChild.textContent = ev.type + " in " + ev.target.id + " (handled by " + ev.currentTarget.id + ")\n";
+}
+
+var under = byId("under");
+var over = byId("over");
+var body = document.body;
+
+var types = ["click", "mousedown", "mouseup"];
+for (var i = 0, type; (type = types[i]); ++i) {
+  under.addEventListener(type, handler);
+  over.addEventListener(type, handler);
+  body.addEventListener(type, handler);
+}
+over.addEventListener("mousedown", function () {
+  over.style.display = "none";
+})
+</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/lib/test/data/click_tests/overlapping_elements.html b/lib/test/data/click_tests/overlapping_elements.html
new file mode 100644
index 0000000..16c4bd9
--- /dev/null
+++ b/lib/test/data/click_tests/overlapping_elements.html
@@ -0,0 +1,59 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <title>An element that disappears on click</title>
+  <style>
+#under {
+  position: absolute;
+  top: 20;
+  left: 20;
+  width: 100px;
+  height: 100px;
+  background-color: white;
+}
+
+#over {
+  position: absolute;
+  top: 20;
+  left: 20;
+  width: 100px;
+  height: 100px;
+  background-color: red;
+  opacity: 0.5;
+}
+
+#log {
+  position: absolute;
+  top: 120px;
+}
+  </style>
+</head>
+<body id="body">
+  <div id="under"><p id="contents">Hello</p></div>
+  <div id="over"></div>
+  <div id="log">
+    <p>Log:<p>
+  </div>
+<script>
+var byId = document.getElementById.bind(document);
+
+var log = byId("log");
+
+function handler(ev) {
+  log.innerHTML += "<p></p>";
+  log.lastElementChild.textContent = ev.type + " in " + ev.target.id + " (handled by " + ev.currentTarget.id + ")\n";
+}
+
+var under = byId("under");
+var over = byId("over");
+var body = document.body;
+
+var types = ["click", "mousedown", "mouseup"];
+for (var i = 0, type; (type = types[i]); ++i) {
+  under.addEventListener(type, handler);
+  over.addEventListener(type, handler);
+  body.addEventListener(type, handler);
+}
+</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/lib/test/data/coordinates_tests/page_with_fixed_element.html b/lib/test/data/coordinates_tests/page_with_fixed_element.html
index b815891..6cbb273 100644
--- a/lib/test/data/coordinates_tests/page_with_fixed_element.html
+++ b/lib/test/data/coordinates_tests/page_with_fixed_element.html
@@ -5,7 +5,7 @@
 </head>
 <body>
   <div id="fixed" style="position:fixed; top:0px; left:100px; background-color:red">fixed red box</div>
-  <div id="placeholder" style="height: 1000px; background-color:green">Placeholder</div>
+  <div id="placeholder" style="height: 5000px; background-color:green">Placeholder</div>
   <div id="bottom">Element at the bottom</div>
   <div>Tex after box</div>
 </body>
diff --git a/lib/test/data/firefox/jetpack-sample.xpi b/lib/test/data/firefox/jetpack-sample.xpi
new file mode 100644
index 0000000..84d6493
Binary files /dev/null and b/lib/test/data/firefox/jetpack-sample.xpi differ
diff --git a/lib/test/data/firefox/sample.xpi b/lib/test/data/firefox/sample.xpi
new file mode 100644
index 0000000..062f9a1
Binary files /dev/null and b/lib/test/data/firefox/sample.xpi differ
diff --git a/lib/test/data/formPage.html b/lib/test/data/formPage.html
index e1197db..7bcfea0 100644
--- a/lib/test/data/formPage.html
+++ b/lib/test/data/formPage.html
@@ -14,6 +14,7 @@
 
 <form method="get" action="resultPage.html" name="login">
     <input type="email" id="email"/>
+    <input type="number" id="age"/>
     <input type="submit" id="submitButton" value="Hello there"/>
 </form>
 
diff --git a/lib/test/data/frameWithAnimals.html b/lib/test/data/frameWithAnimals.html
new file mode 100644
index 0000000..1e0dc87
--- /dev/null
+++ b/lib/test/data/frameWithAnimals.html
@@ -0,0 +1,11 @@
+<html>
+<head>
+    <title>This page has iframes</title>
+</head>
+<body>
+<h1 id="iframe_page_heading">This is the heading</h1>
+
+<iframe src="animals" marginheight="0" marginwidth="0" topmargin="0" leftmargin="0" allowtransparency="true"
+        frameborder="0" height="600" scrolling="no" width="120" id="iframe1" name="iframe1-name" />
+</body>
+</html>
diff --git a/lib/test/data/html5/offline.html b/lib/test/data/html5/offline.html
deleted file mode 100644
index c24178b..0000000
--- a/lib/test/data/html5/offline.html
+++ /dev/null
@@ -1 +0,0 @@
-<html><head><title>Offline</title></head><body></body></html>
diff --git a/lib/test/data/js/skins/lightgray/content.inline.min.css b/lib/test/data/js/skins/lightgray/content.inline.min.css
new file mode 100644
index 0000000..9f194f6
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/content.inline.min.css
@@ -0,0 +1 @@
+.mce-object{border:1px dotted #3A3A3A;background:#d5d5d5 url(img/object.gif) no-repeat center}.mce-pagebreak{cursor:default;display:block;border:0;width:100%;height:5px;border:1px dashed #666;margin-top:15px;page-break-before:always}@media print{.mce-pagebreak{border:0px}}.mce-item-anchor{cursor:default;display:inline-block;-webkit-user-select:all;-webkit-user-modify:read-only;-moz-user-select:all;-moz-user-modify:read-only;user-select:all;user-modify:read-only;width:9px !important;height:9px !important;border:1px dotted #3A3A3A;background:#d5d5d5 url(img/anchor.gif) no-repeat center}.mce-nbsp{background:#AAA}hr{cursor:default}.mce-match-marker{background:#AAA;color:#fff}.mce-match-marker-selected{background:#3399ff;color:#fff}.mce-spellchecker-word{border-bottom:2px solid #F00;cursor:default}.mce-spellchecker-grammar{border-bottom:2px solid #008000;cursor:default}.mce-item-table,.mce-item-table td,.mce-item-table th,.mce-item-table caption{border:1px dashed #BBB}td.mce-item-selected,th.mce-item-selected{background-color:#3399ff !important}.mce-edit-focus{outline:1px dotted #333}
\ No newline at end of file
diff --git a/lib/test/data/js/skins/lightgray/content.min.css b/lib/test/data/js/skins/lightgray/content.min.css
new file mode 100644
index 0000000..ea08c68
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/content.min.css
@@ -0,0 +1 @@
+body{background-color:#FFFFFF;color:#000000;font-family:Verdana,Arial,Helvetica,sans-serif;font-size:11px;scrollbar-3dlight-color:#F0F0EE;scrollbar-arrow-color:#676662;scrollbar-base-color:#F0F0EE;scrollbar-darkshadow-color:#DDDDDD;scrollbar-face-color:#E0E0DD;scrollbar-highlight-color:#F0F0EE;scrollbar-shadow-color:#F0F0EE;scrollbar-track-color:#F5F5F5}td,th{font-family:Verdana,Arial,Helvetica,sans-serif;font-size:11px}.mce-object{border:1px dotted #3A3A3A;background:#d5d5d5 url(img/object.gif) no-repeat center}.mce-pagebreak{cursor:default;display:block;border:0;width:100%;height:5px;border:1px dashed #666;margin-top:15px;page-break-before:always}@media print{.mce-pagebreak{border:0px}}.mce-item-anchor{cursor:default;display:inline-block;-webkit-user-select:all;-webkit-user-modify:read-only;-moz-user-select:all;-moz-user-modify:read-only;user-select:all;user-modify:read-only;width:9px !important;height:9px !important;border:1px dotted #3A3A3A;background:#d5d5d5 url(img/anchor.gif) no-repeat center}.mce-nbsp{background:#AAA}hr{cursor:default}.mce-match-marker{background:#AAA;color:#fff}.mce-match-marker-selected{background:#3399ff;color:#fff}.mce-spellchecker-word{border-bottom:2px solid #F00;cursor:default}.mce-spellchecker-grammar{border-bottom:2px solid #008000;cursor:default}.mce-item-table,.mce-item-table td,.mce-item-table th,.mce-item-table caption{border:1px dashed #BBB}td.mce-item-selected,th.mce-item-selected{background-color:#3399ff !important}.mce-edit-focus{outline:1px dotted #333}
\ No newline at end of file
diff --git a/lib/test/data/js/skins/lightgray/fonts/readme.md b/lib/test/data/js/skins/lightgray/fonts/readme.md
new file mode 100644
index 0000000..fa5d639
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/fonts/readme.md
@@ -0,0 +1 @@
+Icons are generated and provided by the http://icomoon.io service.
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce-small.dev.svg b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.dev.svg
new file mode 100644
index 0000000..578b869
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.dev.svg
@@ -0,0 +1,175 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>
+This is a custom SVG font generated by IcoMoon.
+<iconset grid="16"></iconset>
+</metadata>
+<defs>
+<font id="tinymce-small" horiz-adv-x="512" >
+<font-face units-per-em="512" ascent="480" descent="-32" />
+<missing-glyph horiz-adv-x="512" />
+<glyph class="hidden" unicode="&#xf000;" d="M0,480L 512 -32L0 -32 z" horiz-adv-x="0" />
+<glyph unicode="&#xe020;" d="M 352,64l0,18.502 c 75.674,30.814, 128,96.91, 128,173.498c0,106.039-100.288,192-224,192S 32,362.039, 32,256
+	c0-76.588, 52.327-142.684, 128-173.498L 160,64 L 64,64 l-32,48l0-112 l 160,0 L 192,111.406 c-50.45,25.681-85.333,80.77-85.333,144.594
+	c0,88.366, 66.859,160, 149.333,160c 82.474,0, 149.333-71.634, 149.333-160c0-63.824-34.883-118.913-85.333-144.594L 320,0 l 160,0 L 480,112 l-32-48
+	L 352,64 z" />
+<glyph unicode="&#xe013;" d="M 128,448l0-448 l 128,128l 128-128L 384,448 L 128,448 z M 352,85.255l-96,96l-96-96L 160,416 l 192,0 L 352,85.255 z" />
+<glyph unicode="&#xe012;" d="M 463.637,364.892l-66.745,66.744C 386.34,442.188, 372.276,448, 357.293,448s-29.047-5.812-39.598-16.363l-82.746-82.745
+		c-21.834-21.834-21.834-57.362,0-79.196l 1.373-1.373l 33.941,33.941l-1.373,1.373c-3.066,3.066-3.066,8.247,0,11.313l 82.746,82.746
+		C 353.641,399.7, 356.040,400, 357.292,400s 3.651-0.299, 5.656-2.305l 66.745-66.744c 3.066-3.067, 3.066-8.249, 0.001-11.314l-82.747-82.747
+		c-2.004-2.004-4.403-2.304-5.655-2.304s-3.651,0.3-5.656,2.306l-1.373,1.373l-33.94-33.942l 1.371-1.371
+		c 10.553-10.554, 24.615-16.364, 39.6-16.364s 29.047,5.812, 39.598,16.363l 82.747,82.746C 485.47,307.53, 485.47,343.057, 463.637,364.892
+		zM 275.678,179.678l-33.941-33.941l 1.373-1.373c 2.004-2.004, 2.305-4.403, 2.305-5.655c0-1.253-0.299-3.651-2.303-5.657
+		l-82.747-82.745c-2.005-2.005-4.405-2.305-5.657-2.305s-3.652,0.3-5.657,2.305L 82.305,117.050C 80.3,119.055, 80,121.455, 80,122.707
+		s 0.299,3.65, 2.305,5.656l 82.745,82.744c 2.005,2.006, 4.405,2.306, 5.657,2.306s 3.652-0.3, 5.657-2.306l 1.373-1.371l 33.941,33.94
+		l-1.373,1.373c-10.552,10.552-24.615,16.363-39.598,16.363s-29.046-5.812-39.598-16.363l-82.744-82.743
+		C 37.812,151.754, 32,137.689, 32,122.707s 5.812-29.047, 16.363-39.599l 66.745-66.745C 125.661,5.812, 139.724,0, 154.707,0
+		s 29.046,5.812, 39.598,16.363l 82.747,82.746c 10.552,10.552, 16.361,24.615, 16.361,39.598s-5.812,29.047-16.363,39.598
+		L 275.678,179.678zM 400,61c-4.862,0-9.725,1.854-13.435,5.565l-64,63.999c-7.422,7.42-7.422,19.449,0,26.869
+			c 7.42,7.422, 19.448,7.422, 26.868,0l 64-64c 7.422-7.42, 7.422-19.448,0-26.868C 409.725,62.854, 404.862,61, 400,61zM 304,0c-8.837,0-16,7.163-16,16l0,64 c0,8.837, 7.163,16, 16,16s 16-7.163, 16-16l0-64 C 320,7.163, 312.837,0, 304,0zM 464,160l-64,0 c-8.837,0-16,7.163-16,16s 7.163,16, 16,16l 64,0 c 8.837,0, 16-7.163, 16-16S 472.837,160, 464,160zM 112,387c 4.862,0, 9.725-1.854, 13.435-5.565l 64-64c 7.421-7.42, 7.421-19.449,0-26.869c-7.42-7.422-19.449-7.422-26.869,0
+			l-64,64c-7.421,7.42-7.421,19.449,0,26.869C 102.275,385.146, 107.138,387, 112,387zM 208,448c 8.837,0, 16-7.163, 16-16l0-64 c0-8.837-7.163-16-16-16s-16,7.163-16,16L 192,432 C 192,440.837, 199.163,448, 208,448zM 48,288l 64,0 c 8.837,0, 16-7.163, 16-16s-7.163-16-16-16L 48,256 c-8.837,0-16,7.163-16,16S 39.163,288, 48,288z" />
+<glyph unicode="&#xe011;" d="M 463.637,364.892l-66.745,66.744C 386.34,442.188, 372.276,448, 357.293,448s-29.047-5.812-39.598-16.363l-82.746-82.745
+		c-21.834-21.834-21.834-57.362,0-79.196l 1.373-1.373l 33.941,33.941l-1.373,1.373c-3.066,3.066-3.066,8.247,0,11.313l 82.746,82.746
+		C 353.641,399.7, 356.040,400, 357.292,400s 3.651-0.299, 5.656-2.305l 66.745-66.744c 3.066-3.067, 3.066-8.249, 0.001-11.314l-82.747-82.747
+		c-2.004-2.004-4.403-2.304-5.655-2.304s-3.651,0.3-5.656,2.306l-1.373,1.373l-33.94-33.942l 1.371-1.371
+		c 10.553-10.554, 24.615-16.364, 39.6-16.364s 29.047,5.812, 39.598,16.363l 82.747,82.746C 485.47,307.53, 485.47,343.057, 463.637,364.892
+		zM 275.678,179.678l-33.941-33.941l 1.373-1.373c 2.004-2.004, 2.305-4.403, 2.305-5.655c0-1.253-0.299-3.651-2.303-5.657
+		l-82.747-82.745c-2.005-2.005-4.405-2.305-5.657-2.305s-3.652,0.3-5.657,2.305L 82.305,117.050C 80.3,119.055, 80,121.455, 80,122.707
+		s 0.299,3.65, 2.305,5.656l 82.745,82.744c 2.005,2.006, 4.405,2.306, 5.657,2.306s 3.652-0.3, 5.657-2.306l 1.373-1.371l 33.941,33.94
+		l-1.373,1.373c-10.552,10.552-24.615,16.363-39.598,16.363s-29.046-5.812-39.598-16.363l-82.744-82.743
+		C 37.812,151.754, 32,137.689, 32,122.707s 5.812-29.047, 16.363-39.599l 66.745-66.745C 125.661,5.812, 139.724,0, 154.707,0
+		s 29.046,5.812, 39.598,16.363l 82.747,82.746c 10.552,10.552, 16.361,24.615, 16.361,39.598s-5.812,29.047-16.363,39.598
+		L 275.678,179.678zM 176,125c-4.862,0-9.725,1.855-13.435,5.564c-7.42,7.42-7.42,19.449,0,26.869l 160,160c 7.42,7.42, 19.448,7.42, 26.868,0
+		c 7.422-7.42, 7.422-19.45,0-26.87l-160-160C 185.725,126.855, 180.862,125, 176,125z" />
+<glyph unicode="&#xe010;" d="M 288,339.337L 288,448 l 168.001-168L 288,112L 288,223.048 C 92.547,227.633, 130.5,99.5, 160,0C 16,160, 53.954,345.437, 288,339.337z" />
+<glyph unicode="&#xe00f;" d="M 352,0c 29.5,99.5, 67.453,227.633-128,223.048L 224,112 L 55.999,280L 224,448l0-108.663 C 458.046,345.437, 496,160, 352,0z" />
+<glyph unicode="&#xe00e;" d="M 128.214,267.637c 52.9,0, 95.786-45.585, 95.786-101.819C 224,109.586, 181.114,64, 128.214,64
+	c-52.901,0-95.786,45.585-95.786,101.818L 32,180.364C 32,292.829, 117.77,384, 223.572,384l0-58.182 c-36.55,0-70.913-15.13-96.758-42.602
+	c-4.977-5.289-9.517-10.917-13.612-16.828C 118.094,267.208, 123.105,267.637, 128.214,267.637zM 384.214,267.637c 52.9,0, 95.786-45.585, 95.786-101.819C 480,109.586, 437.114,64, 384.214,64
+	c-52.901,0-95.786,45.585-95.786,101.818L 288,180.364C 288,292.829, 373.77,384, 479.572,384l0-58.182 c-36.55,0-70.913-15.13-96.758-42.602
+	c-4.978-5.289-9.518-10.917-13.612-16.828C 374.094,267.208, 379.105,267.637, 384.214,267.637z" />
+<glyph unicode="&#xe00c;" d="M 32,384L 480,384L 480,320L 32,320zM 192,192L 480,192L 480,128L 192,128zM 192,288L 480,288L 480,224L 192,224zM 32,96L 480,96L 480,32L 32,32zM 32,288L 144,208L 32,128 z" />
+<glyph unicode="&#xe00d;" d="M 32,384L 480,384L 480,320L 32,320zM 32,192L 320,192L 320,128L 32,128zM 32,288L 320,288L 320,224L 32,224zM 32,96L 480,96L 480,32L 32,32zM 480,288L 368,208L 480,128 z" />
+<glyph unicode="&#xe00b;" d="M 192,416L 480,416L 480,352L 192,352zM 192,256L 480,256L 480,192L 192,192zM 192,96L 480,96L 480,32L 192,32zM 160,215L 160,288L 128,288L 128,448L 64,448L 64,416L 96,416L 96,288L 64,288L 64,256L 128,256L 128,231L 64,201L 64,128L 128,128L 128,96L 64,96L 64,64L 128,64L 128,32L 64,32L 64,0L 160,0L 160,160L 96,160L 96,185 	z" />
+<glyph unicode="&#xe00a;" d="M 192,416L 480,416L 480,352L 192,352zM 192,256L 480,256L 480,192L 192,192zM 192,96L 480,96L 480,32L 192,32zM 64,384A32,32 2700 1 1 128,384A32,32 2700 1 1 64,384zM 64,224A32,32 2700 1 1 128,224A32,32 2700 1 1 64,224zM 64,64A32,32 2700 1 1 128,64A32,32 2700 1 1 64,64z" />
+<glyph unicode="&#xe009;" d="M 444,288l-28,0 L 416,416 l 32,0 L 448,448 L 288,448 l0-32 l 32,0 l0-128 L 192,288 L 192,416 l 32,0 L 224,448 L 64,448 l0-32 l 32,0 l0-128 L 68,288 c-19.8,0-36-16.2-36-36l0-216 c0-19.8, 16.2-36, 36-36l 120,0 
+	c 19.8,0, 36,16.2, 36,36L 224,192 l 64,0 l0-156 c0-19.8, 16.2-36, 36-36l 120,0 c 19.8,0, 36,16.2, 36,36L 480,252 C 480,271.8, 463.8,288, 444,288z M 174,32L 82,32 
+	c-9.9,0-18,7.2-18,16s 8.1,16, 18,16l 92,0 c 9.9,0, 18-7.2, 18-16S 183.9,32, 174,32z M 272,224l-32,0 c-8.8,0-16,7.2-16,16s 7.2,16, 16,16l 32,0 
+	c 8.8,0, 16-7.2, 16-16S 280.8,224, 272,224z M 430,32l-92,0 c-9.9,0-18,7.2-18,16s 8.1,16, 18,16l 92,0 c 9.9,0, 18-7.2, 18-16S 439.9,32, 430,32z" />
+<glyph unicode="&#xe008;" d="M 352,288l0,80 c0,8.8-7.2,16-16,16l-80,0 L 256,416 c0,17.6-14.4,32-32,32l-64,0 c-17.602,0-32-14.4-32-32l0-32 L 48,384 c-8.801,0-16-7.2-16-16l0-256 
+	c0-8.8, 7.199-16, 16-16l 112,0 l0-96 l 192,0 l 96,96L 448,288 L 352,288 z M 160,415.943c 0.017,0.019, 0.036,0.039, 0.057,0.057l 63.884,0 
+	c 0.021-0.018, 0.041-0.038, 0.059-0.057L 224,384 l-64,0 L 160,415.943 L 160,415.943z M 96,320l0,32 l 192,0 l0-32 L 96,320 z M 352,45.255L 352,96 l 50.745,0 L 352,45.255z
+	 M 416,128l-96,0 l0-96 L 192,32 L 192,256 l 224,0 L 416,128 z" />
+<glyph unicode="&#xe031;" d="M 416,320l-96,0 l0,32 l-96,96L 32,448 l0-352 l 192,0 l0-96 l 288,0 L 512,224 L 416,320z M 416,274.745L 466.745,224L 416,224 L 416,274.745 z M 224,402.745L 274.745,352
+	L 224,352 L 224,402.745 z M 64,416l 128,0 l0-96 l 96,0 l0-192 L 64,128 L 64,416 z M 480,32L 256,32 l0,64 l 64,0 L 320,288 l 64,0 l0-96 l 96,0 L 480,32 z" />
+<glyph unicode="&#xe007;" d="M 432.204,144.934c-23.235,23.235-53.469,34.002-80.541,31.403L 320,208l 96,96c0,0, 64,64,0,128L 256,272L 96,432
+		c-64-64,0-128,0-128l 96-96l-31.663-31.663c-27.072,2.599-57.305-8.169-80.54-31.403c-37.49-37.49-42.556-93.209-11.313-124.45
+		c 31.241-31.241, 86.96-26.177, 124.45,11.313c 23.235,23.234, 34.001,53.469, 31.403,80.54L 256,144l 31.664-31.664
+		c-2.598-27.072, 8.168-57.305, 31.403-80.539c 37.489-37.49, 93.209-42.556, 124.449-11.313
+		C 474.76,51.725, 469.694,107.443, 432.204,144.934z M 176.562,100.711c-1.106-12.166-7.51-24.913-17.57-34.973
+		C 147.886,54.631, 133.452,48, 120.383,48c-5.262,0-12.649,1.114-17.958,6.424c-10.703,10.702-8.688,36.566, 11.313,56.568
+		c 11.106,11.107, 25.54,17.738, 38.609,17.738c 5.262,0, 12.649-1.114, 17.958-6.424C 176.861,115.751, 177.040,105.962, 176.562,100.711z
+		 M 256,176c-17.673,0-32,14.327-32,32s 14.327,32, 32,32s 32-14.327, 32-32S 273.673,176, 256,176z M 409.576,54.424
+		c-5.31-5.31-12.696-6.424-17.958-6.424c-13.069,0-27.503,6.631-38.609,17.738c-10.061,10.060-16.464,22.807-17.569,34.973
+		c-0.479,5.251-0.3,15.040, 6.257,21.596c 5.309,5.311, 12.695,6.424, 17.958,6.424c 13.068,0, 27.503-6.631, 38.608-17.737
+		C 418.265,90.99, 420.279,65.126, 409.576,54.424z" />
+<glyph unicode="&#xe006;" d="M 32,384L 480,384L 480,320L 32,320zM 32,192L 480,192L 480,128L 32,128zM 32,288L 480,288L 480,224L 32,224zM 32,96L 480,96L 480,32L 32,32z" />
+<glyph unicode="&#xe004;" d="M 32,384L 480,384L 480,320L 32,320zM 32,192L 480,192L 480,128L 32,128zM 128,288L 384,288L 384,224L 128,224zM 128,96L 384,96L 384,32L 128,32z" />
+<glyph unicode="&#xe005;" d="M 32,384L 480,384L 480,320L 32,320zM 32,192L 480,192L 480,128L 32,128zM 192,288L 480,288L 480,224L 192,224zM 192,96L 480,96L 480,32L 192,32z" />
+<glyph unicode="&#xe003;" d="M 32,384L 480,384L 480,320L 32,320zM 32,192L 480,192L 480,128L 32,128zM 32,288L 320,288L 320,224L 32,224zM 32,96L 320,96L 320,32L 32,32z" />
+<glyph unicode="&#xe02d;" d="M 480,224l-4.571,0 L 347.062,224 c-25.039,17.71-57.215,27.43-91.062,27.43c-44.603,0-82.286,25.121-82.286,54.856
+	c0,29.735, 37.683,54.857, 82.286,54.857c 37.529,0, 70.154-17.788, 79.56-41.143l 56.508,0 c-3.965,25.322-18.79,48.984-42.029,66.413
+	C 324.599,405.493, 291.201,416, 256,416c-35.202,0-68.598-10.507-94.037-29.587c-27.394-20.545-43.106-49.751-43.106-80.127
+	s 15.712-59.582, 43.106-80.127c 0.978-0.733, 1.971-1.449, 2.973-2.158L 36.571,224.001 L 32,224.001 l0-32 l 256.266,0 c 29.104-8.553, 50.021-28.135, 50.021-50.286
+	c0-29.734-37.684-54.855-82.286-54.855c-37.53,0-70.154,17.787-79.559,41.143l-56.508,0 c 3.965-25.32, 18.791-48.984, 42.030-66.413
+	C 187.402,42.508, 220.798,32, 256,32c 35.201,0, 68.599,10.508, 94.037,29.587c 27.395,20.545, 43.104,49.751, 43.104,80.127
+	c0,17.649-5.327,34.896-15.147,50.286L 480,192 L 480,224 z" />
+<glyph unicode="&#xe02c;" d="M 96,64l 288,0 l0-32 L 96,32 L 96,64 zM 320,416l0-192 c0-15.656-7.35-30.812-20.695-42.676C 283.834,167.573, 262.771,160, 240,160c-22.772,0-43.834,7.573-59.304,21.324
+	C 167.35,193.188, 160,208.344, 160,224L 160,416 L 96,416 l0-192 c0-70.691, 64.471-128, 144-128c 79.529,0, 144,57.309, 144,128L 384,416 L 320,416 z" />
+<glyph unicode="&#xe02b;" d="M 416,416l0-32 l-72,0 L 216,64l 72,0 l0-32 L 64,32 l0,32 l 72,0 L 264,384l-72,0 L 192,416 L 416,416 z" />
+<glyph unicode="&#xe02a;" d="M 312.721,232.909C 336.758,251.984, 352,280.337, 352,312c0,57.438-50.145,104-112,104L 128,416 l0-384 l 144,0 
+	c 61.856,0, 112,46.562, 112,104C 384,180.098, 354.441,217.781, 312.721,232.909z M 192,328c0,13.255, 10.745,24, 24,24l 33.602,0 
+	C 270.809,352, 288,330.51, 288,304s-17.191-48-38.398-48L 192,256 L 192,328 z M 273.6,96L 216,96 c-13.255,0-24,10.745-24,24l0,72 l 81.6,0 
+	c 21.209,0, 38.4-21.49, 38.4-48S 294.809,96, 273.6,96z" />
+<glyph unicode="&#xe001;" d="M 425.373,358.627l-66.746,66.745C 346.183,437.818, 321.6,448, 304,448L 96,448 c-17.6,0-32-14.4-32-32l0-384 c0-17.6, 14.4-32, 32-32l 320,0 
+	c 17.6,0, 32,14.4, 32,32L 448,304 C 448,321.6, 437.817,346.182, 425.373,358.627z M 402.745,336.001c 3.396-3.398, 6.896-9.581, 9.447-16.001L 320,320 
+	L 320,412.193 c 6.42-2.55, 12.602-6.050, 16-9.448L 402.745,336.001z M 415.942,32L 96.057,32 c-0.020,0.017-0.041,0.038-0.057,0.058L 96,415.943 
+	c 0.017,0.020, 0.038,0.041, 0.057,0.057L 288,416 l0-128 l 128,0 l0-255.942 C 415.983,32.038, 415.962,32.017, 415.942,32z" />
+<glyph unicode="&#xe000;" d="M 480,40L 480,335.969 L 368.031,448L 72,448 c-22.091,0-40-17.908-40-40l0-368 c0-22.092, 17.909-40, 40-40l 368,0 
+	C 462.092,0, 480,17.908, 480,40z M 288,384l 32,0 l0-96 l-32,0 L 288,384 z M 352,64L 160,64 L 160,191.941 c 0.017,0.021, 0.038,0.041, 0.058,0.059l 191.885,0 
+	c 0.020-0.018, 0.041-0.038, 0.058-0.059L 352,64L 352,64z M 416,64l-32,0 L 384,192 c0,17.6-14.4,32-32,32L 160,224 c-17.6,0-32-14.4-32-32l0-128 L 96,64 L 96,384 
+	l 32,0 l0-96 c0-17.6, 14.4-32, 32-32l 160,0 c 17.6,0, 32,14.4, 32,32l0,85.505 l 64-64.036L 416,64 z" />
+<glyph unicode="&#xe01b;" d="M 32,384l0-352 l 448,0 L 480,384 L 32,384 z M 192,160l0,64 l 128,0 l0-64 L 192,160 z M 320,128l0-64 L 192,64 l0,64 L 320,128 z M 320,320l0-64 L 192,256 l0,64 L 320,320 z M 160,320l0-64 L 64,256 l0,64 L 160,320 
+	z M 64,224l 96,0 l0-64 L 64,160 L 64,224 z M 352,224l 96,0 l0-64 l-96,0 L 352,224 z M 352,256l0,64 l 96,0 l0-64 L 352,256 z M 64,128l 96,0 l0-64 L 64,64 L 64,128 z M 352,64l0,64 l 96,0 l0-64 L 352,64 z" />
+<glyph unicode="&#xe021;" d="M 256,410c 49.683,0, 96.391-19.347, 131.521-54.478S 442,273.683, 442,224s-19.348-96.391-54.479-131.521S 305.683,38, 256,38
+	s-96.391,19.348-131.522,54.479S 70,174.317, 70,224s 19.347,96.391, 54.478,131.522S 206.317,410, 256,410 M 256,448
+	C 132.288,448, 32,347.712, 32,224s 100.288-224, 224-224s 224,100.288, 224,224S 379.712,448, 256,448L 256,448zM 160,288A32,32 2700 1 1 224,288A32,32 2700 1 1 160,288zM 288,288A32,32 2700 1 1 352,288A32,32 2700 1 1 288,288zM 256,152c-50.92,0-96.28,18.437-125.583,47.164C 141.98,140.36, 193.806,96, 256,96c 62.194,0, 114.020,44.36, 125.584,103.164
+	C 352.28,170.437, 306.92,152, 256,152z" />
+<glyph unicode="&#xe023;" d="M 240,288L 144,384L 208,448L 32,448L 32,272L 96,336L 192,240 zM 320,240L 416,336L 480,272L 480,448L 304,448L 368,384L 272,288 zM 272,160L 368,64L 304,0L 480,0L 480,176L 416,112L 320,208 zM 192,208L 96,112L 32,176L 32,0L 208,0L 144,64L 240,160 z" />
+<glyph unicode="&#xe01c;" d="M 32,256L 480,256L 480,192L 32,192z" />
+<glyph unicode="&#xe01d;" d="M 32,96l 256,0 l0-64 L 32,32 L 32,96 z M 384,384L 273.721,384 l-91.883-256l-66.144,0 l 91.881,256L 96,384 L 96,448 l 288,0 L 384,384 z M 464.887,32L 400,96.887
+	L 335.113,32L 304,63.113L 368.887,128L 304,192.887L 335.113,224L 400,159.113L 464.887,224L 496,192.887L 431.113,128L 496,63.113
+	L 464.887,32z" />
+<glyph unicode="&#xe022;" d="M 128,416l 256,0 l0-64 L 128,352 L 128,416 z M 448,320L 64,320 c-17.6,0-32-14.4-32-32l0-128 c0-17.6, 14.398-32, 32-32l 64,0 l0-96 l 256,0 l0,96 l 64,0 
+	c 17.6,0, 32,14.4, 32,32L 480,288 C 480,305.6, 465.6,320, 448,320z M 352,64L 160,64 L 160,192 l 192,0 L 352,64 z M 455.2,272c0-12.813-10.387-23.2-23.199-23.2
+	S 408.8,259.187, 408.8,272s 10.389,23.2, 23.201,23.2C 444.814,295.2, 455.2,284.813, 455.2,272z" />
+<glyph unicode="&#xe02e;" d="M 192,416c-61.856,0-112-50.144-112-112s 50.144-112, 112-112l0-160 l 64,0 L 256,352 l 32,0 l0-320 l 64,0 L 352,352 l 64,0 L 416,416 L 192,416 z" />
+<glyph unicode="&#xe02f;" d="M 224,416c-61.856,0-112-50.144-112-112s 50.144-112, 112-112l0-160 l 64,0 L 288,352 l 32,0 l0-320 l 64,0 L 384,352 l 64,0 L 448,416 L 224,416 zM 32,32L 144,128L 32,224 z" />
+<glyph unicode="&#xe030;" d="M 160,416C 98.144,416, 48,365.856, 48,304s 50.144-112, 112-112l0-160 l 64,0 L 224,352 l 32,0 l0-320 l 64,0 L 320,352 l 64,0 L 384,416 L 160,416 zM 480,224L 368,128L 480,32 z" />
+<glyph unicode="&#xe026;" d="M 256,288L 320,288L 320,256L 256,256zM 256,96L 320,96L 320,64L 256,64zM 288,192L 352,192L 352,160L 288,160zM 384,192L 384,96L 352,96L 352,64L 416,64L 416,192 	zM 192,192L 256,192L 256,160L 192,160zM 160,96L 224,96L 224,64L 160,64zM 160,288L 224,288L 224,256L 160,256zM 96,384L 96,256L 128,256L 128,352L 160,352L 160,384 	zM 352,256L 416,256L 416,384L 384,384L 384,288L 352,288 	zM 32,448l0-448 l 448,0 L 480,448 L 32,448 z M 448,32L 64,32 L 64,416 l 384,0 L 448,32 zM 96,192L 96,64L 128,64L 128,160L 160,160L 160,192 	zM 288,384L 352,384L 352,352L 288,352zM 192,384L 256,384L 256,352L 192,352z" />
+<glyph unicode="&#xe027;" d="M 408,448l 8-192L 96,256 l 8,192l 16,0 l 8-160l 256,0 l 8,160L 408,448 z M 104,0l-8,160l 320,0 l-8-160l-16,0 l-8,128L 128,128 l-8-128L 104,0 zM 32,224L 96,224L 96,192L 32,192zM 128,224L 192,224L 192,192L 128,192zM 224,224L 288,224L 288,192L 224,192zM 320,224L 384,224L 384,192L 320,192zM 416,224L 480,224L 480,192L 416,192z" />
+<glyph unicode="&#xe024;" d="M 480,416L 480,448 l-96,0 c-17.601,0-32-14.4-32-32l0-160 c0-7.928, 2.929-15.201, 7.748-20.807L 208,105l-71,74l-41-35l 112-144l 208,224l 64,0 
+		l0,32 l-96,0 L 384,416 L 480,416 zM 128,224l 32,0 L 160,416 c0,17.6-14.4,32-32,32L 64,448 c-17.6,0-32-14.4-32-32l0-192 l 32,0 l0,96 l 64,0 L 128,224 z M 64,352L 64,416 l 64,0 l0-64 L 64,352 zM 320,256l0,48 c0,17.6-4.4,32-22,32c 17.6,0, 22,14.4, 22,32L 320,416 c0,17.6-14.4,32-32,32l-96,0 l0-224 l 96,0 C 305.6,224, 320,238.4, 320,256z
+		 M 224,416l 64,0 l0-64 l-64,0 L 224,416 z M 224,320l 64,0 l0-64 l-64,0 L 224,320 z" />
+<glyph unicode="&#xe025;" d="M 224,224l-64,0 l0,64 l 64,0 l0,64 l 64,0 l0-64 l 64,0 l0-64 l-64,0 l0-64 l-64,0 L 224,224 z M 480,192l0-160 L 32,32 L 32,192 l 64,0 l0-96 l 320,0 l0,96 L 480,192 z" />
+<glyph unicode="&#xe017;" d="M 208,128L 112,224L 208,320L 176,352L 48,224L 176,96 zM 336,352L 304,320L 400,224L 304,128L 336,96L 464,224 z" />
+<glyph unicode="&#xe016;" d="M 224,128l 64,0 l0-64 l-64,0 L 224,128 z M 352,352c 17.673,0, 32-14.327, 32-32l0-83 l-114-77l-46,0 l0,32 l 96,64l0,32 L 160,288 l0,64 L 352,352 z M 256,448
+	c-59.833,0-116.083-23.3-158.392-65.608C 55.301,340.083, 32,283.833, 32,224c0-59.832, 23.301-116.084, 65.608-158.392
+	C 139.917,23.3, 196.167,0, 256,0c 59.832,0, 116.084,23.3, 158.392,65.608C 456.7,107.916, 480,164.168, 480,224
+	c0,59.833-23.3,116.083-65.608,158.392C 372.084,424.7, 315.832,448, 256,448z" />
+<glyph unicode="&#xe014;" d="M 448,416L 64,416 c-17.6,0-32-14.4-32-32l0-320 c0-17.6, 14.4-32, 32-32l 384,0 c 17.6,0, 32,14.4, 32,32L 480,384 C 480,401.6, 465.6,416, 448,416z
+		 M 448,64.058c-0.006-0.007-0.015-0.014-0.021-0.021L 352,224l-80-64L 160,304L 64.016,64.042c-0.005,0.005-0.011,0.011-0.016,0.016
+		L 64,383.943 c 0.017,0.020, 0.038,0.041, 0.057,0.057l 383.885,0 c 0.020-0.017, 0.041-0.038, 0.058-0.058L 448,64.058 zM 320,304A48,48 2700 1 1 416,304A48,48 2700 1 1 320,304z" />
+<glyph unicode="&#xe015;" d="M 448,416L 64,416 c-17.6,0-32-14.4-32-32l0-320 c0-17.6, 14.4-32, 32-32l 384,0 c 17.6,0, 32,14.4, 32,32L 480,384 C 480,401.6, 465.6,416, 448,416z
+	 M 128,64L 64,64 l0,64 l 64,0 L 128,64 z M 128,192L 64,192 l0,64 l 64,0 L 128,192 z M 128,320L 64,320 L 64,384 l 64,0 L 128,320 z M 352,64L 160,64 L 160,384 l 192,0 L 352,64 z M 448,64l-64,0 l0,64 l 64,0 L 448,64 z
+	 M 448,192l-64,0 l0,64 l 64,0 L 448,192 z M 448,320l-64,0 L 384,384 l 64,0 L 448,320 zM 192,320L 192,128L 336,224 z" />
+<glyph unicode="&#xe018;" d="M 38.899,327.688l 40.707-25.441C 105.007,342.804, 144,373.974, 190.21,389.37l-15.183,45.547
+		C 118.153,415.968, 70.163,377.604, 38.899,327.688zM 336.973,434.917L 321.79,389.37c 46.211-15.396, 85.202-46.566, 110.604-87.124l 40.706,25.441
+		C 441.837,377.604, 393.847,415.968, 336.973,434.917zM 303.987,127.996c-2.404,0-4.846,0.545-7.143,1.693L 224,166.111L 224,272 c0,8.836, 7.164,16, 16,16s 16-7.164, 16-16l0-86.111 
+		l 55.155-27.578c 7.903-3.951, 11.107-13.562, 7.155-21.466C 315.508,131.238, 309.856,127.997, 303.987,127.996zM 256,384C 149.961,384, 64,298.039, 64,192c0-106.039, 85.961-192, 192-192c 106.039,0, 192,85.961, 192,192
+	C 448,298.039, 362.039,384, 256,384z M 256,48c-79.529,0-144,64.471-144,144c0,79.529, 64.471,144, 144,144c 79.529,0, 144-64.471, 144-144
+	C 400,112.471, 335.529,48, 256,48z" />
+<glyph unicode="&#xe019;" d="M 32,252.127c 22.659,24.96, 48.581,46.18, 76.636,62.562C 153.802,341.061, 204.759,355, 256,355
+		c 51.24,0, 102.198-13.939, 147.363-40.312c 28.056-16.382, 53.978-37.602, 76.637-62.562l0,58.716 
+		c-16.505,14.059-34.062,26.57-52.434,37.297C 375.063,378.796, 315.737,395, 256,395s-119.064-16.204-171.567-46.86
+		C 66.062,337.413, 48.505,324.901, 32,310.842L 32,252.127 zM 256,320c-91.598,0-172.919-50.278-224-128c 51.081-77.724, 132.402-128, 224-128c 91.598,0, 172.919,50.276, 224,128
+	C 428.919,269.722, 347.598,320, 256,320z M 256,224c0-17.673-14.327-32-32-32s-32,14.327-32,32c0,17.674, 14.327,32, 32,32
+	S 256,241.674, 256,224z M 364.033,131.669C 330.316,111.982, 293.969,102, 256,102s-74.316,9.982-108.033,29.669
+	C 122.19,146.721, 98.659,167.324, 78.91,192c 19.749,24.675, 43.28,45.279, 69.058,60.33c 6.638,3.876, 13.379,7.37, 20.213,10.491
+	C 162.925,250.95, 160,237.817, 160,224c0-53.020, 42.981-96, 96-96c 53.020,0, 96,42.98, 96,96c0,13.817-2.925,26.95-8.18,38.821
+	c 6.834-3.122, 13.575-6.615, 20.213-10.491c 25.777-15.051, 49.308-35.655, 69.058-60.33
+	C 413.342,167.324, 389.811,146.721, 364.033,131.669z" />
+<glyph unicode="&#xe01a;" d="M 325.584,338.083C 313.278,379.064, 311.146,384, 272,384l-32,0 c-39.809,0-41.332-5.076-54.209-48c0-0.001,0-0.001-0.001-0.002
+	L 113.791,96l 56.818,0 l 28.8,96l 113.183,0 l 28.8-96l 56.815,0 L 325.584,338.083z M 218.609,256l 19.2,68c 5.043,16.809, 18.19,15, 18.19,15
+	s 13.147,1.809, 18.19-15l 0.002,0 l 19.2-68L 218.609,256 z" />
+<glyph unicode="&#xe028;" d="M 288,448 C 411.712,448 512,347.712 512,224 C 512,100.288 411.712,0 288,0 L 288,48 C 335.012,48 379.209,66.307 412.451,99.549 C 445.693,132.791 464,176.988 464,224 C 464,271.011 445.693,315.209 412.451,348.451 C 379.209,381.693 335.012,400 288,400 C 240.989,400 196.791,381.693 163.549,348.451 C 137.979,322.882 121.258,290.828 114.896,256 L 208,256 L 96,128 L -16,256 L 66.285,256 C 81.815,364.551 175.154,448 288,448 ZM 384,256 L 384,192 L 256,192 L 256,352 L 320,352 L 320,256 Z" />
+<glyph unicode="&#xe002;" d="M 512,183.771l0,80.458 l-79.572,7.957c-4.093,15.021-10.044,29.274-17.605,42.49l 52.298,63.919L 410.595,435.12l-63.918-52.298
+	c-13.217,7.562-27.471,13.513-42.491,17.604L 296.229,480l-80.458,0 l-7.957-79.573c-15.021-4.093-29.274-10.043-42.49-17.604
+	L 101.405,435.12L 44.88,378.595l 52.298-63.918c-7.562-13.216-13.513-27.47-17.605-42.49L0,264.229l0-80.458 l 79.573-7.957
+	c 4.093-15.021, 10.043-29.274, 17.605-42.491L 44.88,69.405l 56.524-56.524l 63.919,52.298c 13.216-7.562, 27.47-13.514, 42.49-17.605
+	L 215.771-32l 80.458,0 l 7.957,79.572c 15.021,4.093, 29.274,10.044, 42.491,17.605l 63.918-52.298l 56.524,56.524l-52.298,63.918
+	c 7.562,13.217, 13.514,27.471, 17.605,42.49L 512,183.771z M 352,192l-64-64l-64,0 l-64,64l0,64 l 64,64l 64,0 l 64-64L 352,192 z" />
+<glyph unicode="&#xe01f;" d="M 384,377 L 384,352 L 448,352 L 448,320 L 352,320 L 352,393 L 416,423 L 416,448 L 352,448 L 352,480 L 448,480 L 448,407 ZM 338,352L 270,352L 176,258L 82,352L 14,352L 142,224L 14,96L 82,96L 176,190L 270,96L 338,96L 210,224 z" />
+<glyph unicode="&#xe01e;" d="M 384,25 L 384,0 L 448,0 L 448-32 L 352-32 L 352,41 L 416,71 L 416,96 L 352,96 L 352,128 L 448,128 L 448,55 ZM 338,352L 270,352L 176,258L 82,352L 14,352L 142,224L 14,96L 82,96L 176,190L 270,96L 338,96L 210,224 z" />
+<glyph unicode="&#xe035;" d="M 352,288l0,80 c0,8.8-7.2,16-16,16l-80,0 L 256,416 c0,17.6-14.4,32-32,32l-64,0 c-17.602,0-32-14.4-32-32l0-32 L 48,384 c-8.801,0-16-7.2-16-16
+		l0-256 c0-8.8, 7.199-16, 16-16l 112,0 l0-96 l 288,0 L 448,288 L 352,288 z M 160,415.943c 0.017,0.019, 0.036,0.039, 0.057,0.057l 63.884,0 
+		c 0.021-0.018, 0.041-0.038, 0.059-0.057L 224,384 l-64,0 L 160,415.943 z M 96,320l0,32 l 192,0 l0-32 L 96,320 z M 416,32L 192,32 L 192,256 l 224,0 L 416,32 zM 224,224L 224,160L 240,160L 256,192L 288,192L 288,96L 264,96L 264,64L 344,64L 344,96L 320,96L 320,192L 352,192L 368,160L 384,160L 384,224 	z" data-tags="pastetext" />
+<glyph unicode="&#xe032;" d="M 384,352L 416,352L 416,320L 384,320zM 320,288L 352,288L 352,256L 320,256zM 320,224L 352,224L 352,192L 320,192zM 320,160L 352,160L 352,128L 320,128zM 256,224L 288,224L 288,192L 256,192zM 256,160L 288,160L 288,128L 256,128zM 192,160L 224,160L 224,128L 192,128zM 384,288L 416,288L 416,256L 384,256zM 384,224L 416,224L 416,192L 384,192zM 384,160L 416,160L 416,128L 384,128zM 384,96L 416,96L 416,64L 384,64zM 320,96L 352,96L 352,64L 320,64zM 256,96L 288,96L 288,64L 256,64zM 192,96L 224,96L 224,64L 192,64zM 128,96L 160,96L 160,64L 128,64z" data-tags="resize, dots" />
+<glyph unicode="&#xe034;" d="M 464,416L 256,416L 240,448L 64,448L 32,384L 480,384 zM 420.17,128L 464,128 l 16,224L 32,352 l 32-320l 178.040,0 C 189.599,50.888, 152,101.133, 152,160c0,74.991, 61.009,136, 136,136
+	c 74.99,0, 136-61.009, 136-136C 424,149.161, 422.689,138.425, 420.17,128zM 437.498,55.125l-67.248,55.346C 378.977,124.932, 384,141.878, 384,160c0,53.020-42.98,96-96,96s-96-42.98-96-96
+	s 42.98-96, 96-96c 18.122,0, 35.069,5.023, 49.529,13.75l 55.346-67.248c 11.481-13.339, 31.059-14.070, 43.503-1.626l 2.746,2.746
+	C 451.568,24.066, 450.837,43.644, 437.498,55.125z M 288,98c-34.242,0-62,27.758-62,62s 27.758,62, 62,62s 62-27.758, 62-62
+	S 322.242,98, 288,98z" data-tags="browse" />
+<glyph unicode="&#x20;" horiz-adv-x="256" />
+</font></defs></svg>
\ No newline at end of file
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce-small.eot b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.eot
new file mode 100644
index 0000000..60e2d2e
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.eot differ
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce-small.svg b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.svg
new file mode 100644
index 0000000..930c48d
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.svg
@@ -0,0 +1,62 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>Generated by IcoMoon</metadata>
+<defs>
+<font id="tinymce-small" horiz-adv-x="512">
+<font-face units-per-em="512" ascent="480" descent="-32" />
+<missing-glyph horiz-adv-x="512" />
+<glyph unicode="&#x20;" d="" horiz-adv-x="256" />
+<glyph unicode="&#xe000;" d="M480 40v295.969l-111.969 112.031h-296.031c-22.091 0-40-17.908-40-40v-368c0-22.092 17.909-40 40-40h368c22.092 0 40 17.908 40 40zM288 384h32v-96h-32v96zM352 64h-192v127.941c0.017 0.021 0.038 0.041 0.058 0.059h191.885c0.020-0.018 0.041-0.038 0.058-0.059l-0.001-127.941zM416 64h-32v128c0 17.6-14.4 32-32 32h-192c-17.6 0-32-14.4-32-32v-128h-32v320h32v-96c0-17.6 14.4-32 32-32h160c17.6 0 32 14.4 32 32v85.505l64-64.036v-245.469z" />
+<glyph unicode="&#xe001;" d="M425.373 358.627l-66.746 66.745c-12.444 12.446-37.027 22.628-54.627 22.628h-208c-17.6 0-32-14.4-32-32v-384c0-17.6 14.4-32 32-32h320c17.6 0 32 14.4 32 32v272c0 17.6-10.183 42.182-22.627 54.627zM402.745 336.001c3.396-3.398 6.896-9.581 9.447-16.001h-92.192v92.193c6.42-2.55 12.602-6.050 16-9.448l66.745-66.744zM415.942 32h-319.885c-0.020 0.017-0.041 0.038-0.057 0.058v383.885c0.017 0.020 0.038 0.041 0.057 0.057h191.943v-128h128v-255.942c-0.017-0.020-0.038-0.041-0.058-0.058z" />
+<glyph unicode="&#xe002;" d="M512 183.771v80.458l-79.572 7.957c-4.093 15.021-10.044 29.274-17.605 42.49l52.298 63.919-56.526 56.525-63.918-52.298c-13.217 7.562-27.471 13.513-42.491 17.604l-7.957 79.574h-80.458l-7.957-79.573c-15.021-4.093-29.274-10.043-42.49-17.604l-63.919 52.297-56.525-56.525 52.298-63.918c-7.562-13.216-13.513-27.47-17.605-42.49l-79.573-7.958v-80.458l79.573-7.957c4.093-15.021 10.043-29.274 17.605-42.491l-52.298-63.918 56.524-56.524 63.919 52.298c13.216-7.562 27.47-13.514 42.49-17.605l7.958-79.574h80.458l7.957 79.572c15.021 4.093 29.274 10.044 42.491 17.605l63.918-52.298 56.524 56.524-52.298 63.918c7.562 13.217 13.514 27.471 17.605 42.49l79.574 7.96zM352 192l-64-64h-64l-64 64v64l64 64h64l64-64v-64z" />
+<glyph unicode="&#xe003;" d="M32 384h448v-64h-448zM32 192h448v-64h-448zM32 288h288v-64h-288zM32 96h288v-64h-288z" />
+<glyph unicode="&#xe004;" d="M32 384h448v-64h-448zM32 192h448v-64h-448zM128 288h256v-64h-256zM128 96h256v-64h-256z" />
+<glyph unicode="&#xe005;" d="M32 384h448v-64h-448zM32 192h448v-64h-448zM192 288h288v-64h-288zM192 96h288v-64h-288z" />
+<glyph unicode="&#xe006;" d="M32 384h448v-64h-448zM32 192h448v-64h-448zM32 288h448v-64h-448zM32 96h448v-64h-448z" />
+<glyph unicode="&#xe007;" d="M432.204 144.934c-23.235 23.235-53.469 34.002-80.541 31.403l-31.663 31.663 96 96c0 0 64 64 0 128l-160-160-160 160c-64-64 0-128 0-128l96-96-31.663-31.663c-27.072 2.599-57.305-8.169-80.54-31.403-37.49-37.49-42.556-93.209-11.313-124.45 31.241-31.241 86.96-26.177 124.45 11.313 23.235 23.234 34.001 53.469 31.403 80.54l31.663 31.663 31.664-31.664c-2.598-27.072 8.168-57.305 31.403-80.539 37.489-37.49 93.209-42.556 124.449-11.313 31.244 31.241 26.178 86.959-11.312 124.45zM176.562 100.711c-1.106-12.166-7.51-24.913-17.57-34.973-11.106-11.107-25.54-17.738-38.609-17.738-5.262 0-12.649 1.114-17.958 6.424-10.703 10.702-8.688 36.566 11.313 56.568 11.106 11.107 25.54 17.738 38.609 17.738 5.262 0 12.649-1.114 17.958-6.424 6.556-6.555 6.735-16.344 6.257-21.595zM256 176c-17.673 0-32 14.327-32 32s14.327 32 32 32 32-14.327 32-32-14.327-32-32-32zM409.576 54.424c-5.31-5.31-12.696-6.424-17.958-6.424-13.069 0-27.503 6.631-38.609 17.738-10.061 10.060-16.464 22.807-17.569 34.973-0.479 5.251-0.3 15.040 6.257 21.596 5.309 5.311 12.695 6.424 17.958 6.424 13.068 0 27.503-6.631 38.608-17.737 20.002-20.004 22.016-45.868 11.313-56.57z" />
+<glyph unicode="&#xe008;" d="M352 288v80c0 8.8-7.2 16-16 16h-80v32c0 17.6-14.4 32-32 32h-64c-17.602 0-32-14.4-32-32v-32h-80c-8.801 0-16-7.2-16-16v-256c0-8.8 7.199-16 16-16h112v-96h192l96 96v192h-96zM160 415.943c0.017 0.019 0.036 0.039 0.057 0.057h63.884c0.021-0.018 0.041-0.038 0.059-0.057v-31.943h-64v31.943zM96 320v32h192v-32h-192zM352 45.255v50.745h50.745l-50.745-50.745zM416 128h-96v-96h-128v224h224v-128z" />
+<glyph unicode="&#xe009;" d="M444 288h-28v128h32v32h-160v-32h32v-128h-128v128h32v32h-160v-32h32v-128h-28c-19.8 0-36-16.2-36-36v-216c0-19.8 16.2-36 36-36h120c19.8 0 36 16.2 36 36v156h64v-156c0-19.8 16.2-36 36-36h120c19.8 0 36 16.2 36 36v216c0 19.8-16.2 36-36 36zM174 32h-92c-9.9 0-18 7.2-18 16s8.1 16 18 16h92c9.9 0 18-7.2 18-16s-8.1-16-18-16zM272 224h-32c-8.8 0-16 7.2-16 16s7.2 16 16 16h32c8.8 0 16-7.2 16-16s-7.2-16-16-16zM430 32h-92c-9.9 0-18 7.2-18 16s8.1 16 18 16h92c9.9 0 18-7.2 18-16s-8.1-16-18-16z" />
+<glyph unicode="&#xe00a;" d="M192 416h288v-64h-288zM192 256h288v-64h-288zM192 96h288v-64h-288zM64 384c0-17.673 14.327-32 32-32s32 14.327 32 32c0 17.673-14.327 32-32 32-17.673 0-32-14.327-32-32zM64 224c0-17.673 14.327-32 32-32s32 14.327 32 32c0 17.673-14.327 32-32 32-17.673 0-32-14.327-32-32zM64 64c0-17.673 14.327-32 32-32s32 14.327 32 32c0 17.673-14.327 32-32 32-17.673 0-32-14.327-32-32z" />
+<glyph unicode="&#xe00b;" d="M192 416h288v-64h-288zM192 256h288v-64h-288zM192 96h288v-64h-288zM160 215v73h-32v160h-64v-32h32v-128h-32v-32h64v-25l-64-30v-73h64v-32h-64v-32h64v-32h-64v-32h96v160h-64v25z" />
+<glyph unicode="&#xe00c;" d="M32 384h448v-64h-448zM192 192h288v-64h-288zM192 288h288v-64h-288zM32 96h448v-64h-448zM32 288l112-80-112-80z" />
+<glyph unicode="&#xe00d;" d="M32 384h448v-64h-448zM32 192h288v-64h-288zM32 288h288v-64h-288zM32 96h448v-64h-448zM480 288l-112-80 112-80z" />
+<glyph unicode="&#xe00e;" d="M128.214 267.637c52.9 0 95.786-45.585 95.786-101.819 0-56.232-42.886-101.818-95.786-101.818-52.901 0-95.786 45.585-95.786 101.818l-0.428 14.546c0 112.465 85.77 203.636 191.572 203.636v-58.182c-36.55 0-70.913-15.13-96.758-42.602-4.977-5.289-9.517-10.917-13.612-16.828 4.892 0.82 9.903 1.249 15.012 1.249zM384.214 267.637c52.9 0 95.786-45.585 95.786-101.819 0-56.232-42.886-101.818-95.786-101.818-52.901 0-95.786 45.585-95.786 101.818l-0.428 14.546c0 112.465 85.77 203.636 191.572 203.636v-58.182c-36.55 0-70.913-15.13-96.758-42.602-4.978-5.289-9.518-10.917-13.612-16.828 4.892 0.82 9.903 1.249 15.012 1.249z" />
+<glyph unicode="&#xe00f;" d="M352 0c29.5 99.5 67.453 227.633-128 223.048v-111.048l-168.001 168 168.001 168v-108.663c234.046 6.1 272-179.337 128-339.337z" />
+<glyph unicode="&#xe010;" d="M288 339.337v108.663l168.001-168-168.001-168v111.048c-195.453 4.585-157.5-123.548-128-223.048-144 160-106.046 345.437 128 339.337z" />
+<glyph unicode="&#xe011;" d="M463.637 364.892l-66.745 66.744c-10.552 10.552-24.616 16.364-39.599 16.364s-29.047-5.812-39.598-16.363l-82.746-82.745c-21.834-21.834-21.834-57.362 0-79.196l1.373-1.373 33.941 33.941-1.373 1.373c-3.066 3.066-3.066 8.247 0 11.313l82.746 82.746c2.005 2.004 4.404 2.304 5.656 2.304s3.651-0.299 5.656-2.305l66.745-66.744c3.066-3.067 3.066-8.249 0.001-11.314l-82.747-82.747c-2.004-2.004-4.403-2.304-5.655-2.304s-3.651 0.3-5.656 2.306l-1.373 1.373-33.94-33.942 1.371-1.371c10.553-10.554 24.615-16.364 39.6-16.364s29.047 5.812 39.598 16.363l82.747 82.746c21.831 21.833 21.831 57.36-0.002 79.195zM275.678 179.678l-33.941-33.941 1.373-1.373c2.004-2.004 2.305-4.403 2.305-5.655 0-1.253-0.299-3.651-2.303-5.657l-82.747-82.745c-2.005-2.005-4.405-2.305-5.657-2.305s-3.652 0.3-5.657 2.305l-66.746 66.743c-2.005 2.005-2.305 4.405-2.305 5.657s0.299 3.65 2.305 5.656l82.745 82.744c2.005 2.006 4.405 2.306 5.657 2.306s3.652-0.3 5.657-2.306l1.373-1.371 33.941 33.94-1.373 1.373c-10.552 10.552-24.615 16.363-39.598 16.363s-29.046-5.812-39.598-16.363l-82.744-82.743c-10.553-10.552-16.365-24.617-16.365-39.599s5.812-29.047 16.363-39.599l66.745-66.745c10.553-10.551 24.616-16.363 39.599-16.363s29.046 5.812 39.598 16.363l82.747 82.746c10.552 10.552 16.361 24.615 16.361 39.598s-5.812 29.047-16.363 39.598l-1.372 1.373zM176 125c-4.862 0-9.725 1.855-13.435 5.564-7.42 7.42-7.42 19.449 0 26.869l160 160c7.42 7.42 19.448 7.42 26.868 0 7.422-7.42 7.422-19.45 0-26.87l-160-160c-3.708-3.708-8.571-5.563-13.433-5.563z" />
+<glyph unicode="&#xe012;" d="M463.637 364.892l-66.745 66.744c-10.552 10.552-24.616 16.364-39.599 16.364s-29.047-5.812-39.598-16.363l-82.746-82.745c-21.834-21.834-21.834-57.362 0-79.196l1.373-1.373 33.941 33.941-1.373 1.373c-3.066 3.066-3.066 8.247 0 11.313l82.746 82.746c2.005 2.004 4.404 2.304 5.656 2.304s3.651-0.299 5.656-2.305l66.745-66.744c3.066-3.067 3.066-8.249 0.001-11.314l-82.747-82.747c-2.004-2.004-4.403-2.304-5.655-2.304s-3.651 0.3-5.656 2.306l-1.373 1.373-33.94-33.942 1.371-1.371c10.553-10.554 24.615-16.364 39.6-16.364s29.047 5.812 39.598 16.363l82.747 82.746c21.831 21.833 21.831 57.36-0.002 79.195zM275.678 179.678l-33.941-33.941 1.373-1.373c2.004-2.004 2.305-4.403 2.305-5.655 0-1.253-0.299-3.651-2.303-5.657l-82.747-82.745c-2.005-2.005-4.405-2.305-5.657-2.305s-3.652 0.3-5.657 2.305l-66.746 66.743c-2.005 2.005-2.305 4.405-2.305 5.657s0.299 3.65 2.305 5.656l82.745 82.744c2.005 2.006 4.405 2.306 5.657 2.306s3.652-0.3 5.657-2.306l1.373-1.371 33.941 33.94-1.373 1.373c-10.552 10.552-24.615 16.363-39.598 16.363s-29.046-5.812-39.598-16.363l-82.744-82.743c-10.553-10.552-16.365-24.617-16.365-39.599s5.812-29.047 16.363-39.599l66.745-66.745c10.553-10.551 24.616-16.363 39.599-16.363s29.046 5.812 39.598 16.363l82.747 82.746c10.552 10.552 16.361 24.615 16.361 39.598s-5.812 29.047-16.363 39.598l-1.372 1.373zM400 61c-4.862 0-9.725 1.854-13.435 5.565l-64 63.999c-7.422 7.42-7.422 19.449 0 26.869 7.42 7.422 19.448 7.422 26.868 0l64-64c7.422-7.42 7.422-19.448 0-26.868-3.708-3.711-8.571-5.565-13.433-5.565zM304 0c-8.837 0-16 7.163-16 16v64c0 8.837 7.163 16 16 16s16-7.163 16-16v-64c0-8.837-7.163-16-16-16zM464 160h-64c-8.837 0-16 7.163-16 16s7.163 16 16 16h64c8.837 0 16-7.163 16-16s-7.163-16-16-16zM112 387c4.862 0 9.725-1.854 13.435-5.565l64-64c7.421-7.42 7.421-19.449 0-26.869-7.42-7.422-19.449-7.422-26.869 0l-64 64c-7.421 7.42-7.421 19.449 0 26.869 3.709 3.711 8.572 5.565 13.434 5.565zM208 448c8.837 0 16-7.163 16-16v-64c0-8.837-7.163-16-16-16s-16 7.163-16 16v64c0 8.837 7.163 16 16 16zM48 288h64c8.837 0 16-7.163 16-16s-7.163-16-16-16h-64c-8.837 0-16 7.163-16 16s7.163 16 16 16z" />
+<glyph unicode="&#xe013;" d="M128 448v-448l128 128 128-128v448h-256zM352 85.255l-96 96-96-96v330.745h192v-330.745z" />
+<glyph unicode="&#xe014;" d="M448 416h-384c-17.6 0-32-14.4-32-32v-320c0-17.6 14.4-32 32-32h384c17.6 0 32 14.4 32 32v320c0 17.6-14.4 32-32 32zM448 64.058c-0.006-0.007-0.015-0.014-0.021-0.021l-95.979 159.963-80-64-112 144-95.984-239.958c-0.005 0.005-0.011 0.011-0.016 0.016v319.885c0.017 0.020 0.038 0.041 0.057 0.057h383.885c0.020-0.017 0.041-0.038 0.058-0.058v-319.884zM320 304c0-26.51 21.49-48 48-48s48 21.49 48 48c0 26.51-21.49 48-48 48-26.51 0-48-21.49-48-48z" />
+<glyph unicode="&#xe015;" d="M448 416h-384c-17.6 0-32-14.4-32-32v-320c0-17.6 14.4-32 32-32h384c17.6 0 32 14.4 32 32v320c0 17.6-14.4 32-32 32zM128 64h-64v64h64v-64zM128 192h-64v64h64v-64zM128 320h-64v64h64v-64zM352 64h-192v320h192v-320zM448 64h-64v64h64v-64zM448 192h-64v64h64v-64zM448 320h-64v64h64v-64zM192 320v-192l144 96z" />
+<glyph unicode="&#xe016;" d="M224 128h64v-64h-64v64zM352 352c17.673 0 32-14.327 32-32v-83l-114-77h-46v32l96 64v32h-160v64h192zM256 448c-59.833 0-116.083-23.3-158.392-65.608-42.307-42.309-65.608-98.559-65.608-158.392 0-59.832 23.301-116.084 65.608-158.392 42.309-42.308 98.559-65.608 158.392-65.608 59.832 0 116.084 23.3 158.392 65.608 42.308 42.308 65.608 98.56 65.608 158.392 0 59.833-23.3 116.083-65.608 158.392-42.308 42.308-98.56 65.608-158.392 65.608z" />
+<glyph unicode="&#xe017;" d="M208 128l-96 96 96 96-32 32-128-128 128-128zM336 352l-32-32 96-96-96-96 32-32 128 128z" />
+<glyph unicode="&#xe018;" d="M38.899 327.688l40.707-25.441c25.401 40.557 64.394 71.727 110.604 87.123l-15.183 45.547c-56.874-18.949-104.864-57.313-136.128-107.229zM336.973 434.917l-15.183-45.547c46.211-15.396 85.202-46.566 110.604-87.124l40.706 25.441c-31.263 49.917-79.253 88.281-136.127 107.23zM303.987 127.996c-2.404 0-4.846 0.545-7.143 1.693l-72.844 36.422v105.889c0 8.836 7.164 16 16 16s16-7.164 16-16v-86.111l55.155-27.578c7.903-3.951 11.107-13.562 7.155-21.466-2.802-5.607-8.454-8.848-14.323-8.849zM256 384c-106.039 0-192-85.961-192-192s85.961-192 192-192c106.039 0 192 85.961 192 192 0 106.039-85.961 192-192 192zM256 48c-79.529 0-144 64.471-144 144s64.471 144 144 144c79.529 0 144-64.471 144-144 0-79.529-64.471-144-144-144z" />
+<glyph unicode="&#xe019;" d="M32 252.127c22.659 24.96 48.581 46.18 76.636 62.562 45.166 26.372 96.123 40.311 147.364 40.311 51.24 0 102.198-13.939 147.363-40.312 28.056-16.382 53.978-37.602 76.637-62.562v58.716c-16.505 14.059-34.062 26.57-52.434 37.297-52.503 30.657-111.829 46.861-171.566 46.861s-119.064-16.204-171.567-46.86c-18.371-10.727-35.928-23.239-52.433-37.298v-58.715zM256 320c-91.598 0-172.919-50.278-224-128 51.081-77.724 132.402-128 224-128 91.598 0 172.919 50.276 224 128-51.081 77.722-132.402 128-224 128zM256 224c0-17.673-14.327-32-32-32s-32 14.327-32 32c0 17.674 14.327 32 32 32s32-14.326 32-32zM364.033 131.669c-33.717-19.687-70.064-29.669-108.033-29.669s-74.316 9.982-108.033 29.669c-25.777 15.052-49.308 35.655-69.057 60.331 19.749 24.675 43.28 45.279 69.058 60.33 6.638 3.876 13.379 7.37 20.213 10.491-5.256-11.871-8.181-25.004-8.181-38.821 0-53.020 42.981-96 96-96 53.020 0 96 42.98 96 96 0 13.817-2.925 26.95-8.18 38.821 6.834-3.122 13.575-6.615 20.213-10.491 25.777-15.051 49.308-35.655 69.058-60.33-19.749-24.676-43.28-45.279-69.058-60.331z" />
+<glyph unicode="&#xe01a;" d="M325.584 338.083c-12.306 40.981-14.438 45.917-53.584 45.917h-32c-39.809 0-41.332-5.076-54.209-48 0-0.001 0-0.001-0.001-0.002l-71.999-239.998h56.818l28.8 96h113.183l28.8-96h56.815l-72.623 242.083zM218.609 256l19.2 68c5.043 16.809 18.19 15 18.19 15s13.147 1.809 18.19-15h0.002l19.2-68h-74.782z" />
+<glyph unicode="&#xe01b;" d="M32 384v-352h448v352h-448zM192 160v64h128v-64h-128zM320 128v-64h-128v64h128zM320 320v-64h-128v64h128zM160 320v-64h-96v64h96zM64 224h96v-64h-96v64zM352 224h96v-64h-96v64zM352 256v64h96v-64h-96zM64 128h96v-64h-96v64zM352 64v64h96v-64h-96z" />
+<glyph unicode="&#xe01c;" d="M32 256h448v-64h-448z" />
+<glyph unicode="&#xe01d;" d="M32 96h256v-64h-256v64zM384 384h-110.279l-91.883-256h-66.144l91.881 256h-111.575v64h288v-64zM464.887 32l-64.887 64.887-64.887-64.887-31.113 31.113 64.887 64.887-64.887 64.887 31.113 31.113 64.887-64.887 64.887 64.887 31.113-31.113-64.887-64.887 64.887-64.887-31.113-31.113z" />
+<glyph unicode="&#xe01e;" d="M384 25v-25h64v-32h-96v73l64 30v25h-64v32h96v-73zM338 352h-68l-94-94-94 94h-68l128-128-128-128h68l94 94 94-94h68l-128 128z" />
+<glyph unicode="&#xe01f;" d="M384 377v-25h64v-32h-96v73l64 30v25h-64v32h96v-73zM338 352h-68l-94-94-94 94h-68l128-128-128-128h68l94 94 94-94h68l-128 128z" />
+<glyph unicode="&#xe020;" d="M352 64v18.502c75.674 30.814 128 96.91 128 173.498 0 106.039-100.288 192-224 192s-224-85.961-224-192c0-76.588 52.327-142.684 128-173.498v-18.502h-96l-32 48v-112h160v111.406c-50.45 25.681-85.333 80.77-85.333 144.594 0 88.366 66.859 160 149.333 160 82.474 0 149.333-71.634 149.333-160 0-63.824-34.883-118.913-85.333-144.594v-111.406h160v112l-32-48h-96z" />
+<glyph unicode="&#xe021;" d="M256 410c49.683 0 96.391-19.347 131.521-54.478s54.479-81.839 54.479-131.522-19.348-96.391-54.479-131.521-81.838-54.479-131.521-54.479-96.391 19.348-131.522 54.479-54.478 81.838-54.478 131.521 19.347 96.391 54.478 131.522 81.839 54.478 131.522 54.478zM256 448c-123.712 0-224-100.288-224-224s100.288-224 224-224 224 100.288 224 224-100.288 224-224 224v0zM160 288c0-17.673 14.327-32 32-32s32 14.327 32 32c0 17.673-14.327 32-32 32-17.673 0-32-14.327-32-32zM288 288c0-17.673 14.327-32 32-32s32 14.327 32 32c0 17.673-14.327 32-32 32-17.673 0-32-14.327-32-32zM256 152c-50.92 0-96.28 18.437-125.583 47.164 11.563-58.804 63.389-103.164 125.583-103.164 62.194 0 114.020 44.36 125.584 103.164-29.304-28.727-74.664-47.164-125.584-47.164z" />
+<glyph unicode="&#xe022;" d="M128 416h256v-64h-256v64zM448 320h-384c-17.6 0-32-14.4-32-32v-128c0-17.6 14.398-32 32-32h64v-96h256v96h64c17.6 0 32 14.4 32 32v128c0 17.6-14.4 32-32 32zM352 64h-192v128h192v-128zM455.2 272c0-12.813-10.387-23.2-23.199-23.2s-23.201 10.387-23.201 23.2 10.389 23.2 23.201 23.2c12.813 0 23.199-10.387 23.199-23.2z" />
+<glyph unicode="&#xe023;" d="M240 288l-96 96 64 64h-176v-176l64 64 96-96zM320 240l96 96 64-64v176h-176l64-64-96-96zM272 160l96-96-64-64h176v176l-64-64-96 96zM192 208l-96-96-64 64v-176h176l-64 64 96 96z" />
+<glyph unicode="&#xe024;" d="M480 416v32h-96c-17.601 0-32-14.4-32-32v-160c0-7.928 2.929-15.201 7.748-20.807l-151.748-130.193-71 74-41-35 112-144 208 224h64v32h-96v160h96zM128 224h32v192c0 17.6-14.4 32-32 32h-64c-17.6 0-32-14.4-32-32v-192h32v96h64v-96zM64 352v64h64v-64h-64zM320 256v48c0 17.6-4.4 32-22 32 17.6 0 22 14.4 22 32v48c0 17.6-14.4 32-32 32h-96v-224h96c17.6 0 32 14.4 32 32zM224 416h64v-64h-64v64zM224 320h64v-64h-64v64z" />
+<glyph unicode="&#xe025;" d="M224 224h-64v64h64v64h64v-64h64v-64h-64v-64h-64v64zM480 192v-160h-448v160h64v-96h320v96h64z" />
+<glyph unicode="&#xe026;" d="M256 288h64v-32h-64zM256 96h64v-32h-64zM288 192h64v-32h-64zM384 192v-96h-32v-32h64v128zM192 192h64v-32h-64zM160 96h64v-32h-64zM160 288h64v-32h-64zM96 384v-128h32v96h32v32zM352 256h64v128h-32v-96h-32zM32 448v-448h448v448h-448zM448 32h-384v384h384v-384zM96 192v-128h32v96h32v32zM288 384h64v-32h-64zM192 384h64v-32h-64z" />
+<glyph unicode="&#xe027;" d="M408 448l8-192h-320l8 192h16l8-160h256l8 160h16zM104 0l-8 160h320l-8-160h-16l-8 128h-256l-8-128h-16zM32 224h64v-32h-64zM128 224h64v-32h-64zM224 224h64v-32h-64zM320 224h64v-32h-64zM416 224h64v-32h-64z" />
+<glyph unicode="&#xe028;" d="M288 448c123.712 0 224-100.288 224-224s-100.288-224-224-224v48c47.012 0 91.209 18.307 124.451 51.549 33.242 33.242 51.549 77.439 51.549 124.451 0 47.011-18.307 91.209-51.549 124.451-33.242 33.242-77.439 51.549-124.451 51.549-47.011 0-91.209-18.307-124.451-51.549-25.57-25.569-42.291-57.623-48.653-92.451h93.104l-112-128-112 128h82.285c15.53 108.551 108.869 192 221.715 192zM384 256v-64h-128v160h64v-96z" />
+<glyph unicode="&#xe02a;" d="M312.721 232.909c24.037 19.075 39.279 47.428 39.279 79.091 0 57.438-50.145 104-112 104h-112v-384h144c61.856 0 112 46.562 112 104 0 44.098-29.559 81.781-71.279 96.909zM192 328c0 13.255 10.745 24 24 24h33.602c21.207 0 38.398-21.49 38.398-48s-17.191-48-38.398-48h-57.602v72zM273.6 96h-57.6c-13.255 0-24 10.745-24 24v72h81.6c21.209 0 38.4-21.49 38.4-48s-17.191-48-38.4-48z" />
+<glyph unicode="&#xe02b;" d="M416 416v-32h-72l-128-320h72v-32h-224v32h72l128 320h-72v32h224z" />
+<glyph unicode="&#xe02c;" d="M96 64h288v-32h-288v32zM320 416v-192c0-15.656-7.35-30.812-20.695-42.676-15.471-13.751-36.534-21.324-59.305-21.324-22.772 0-43.834 7.573-59.304 21.324-13.346 11.864-20.696 27.020-20.696 42.676v192h-64v-192c0-70.691 64.471-128 144-128s144 57.309 144 128v192h-64z" />
+<glyph unicode="&#xe02d;" d="M480 224h-132.938c-25.039 17.71-57.215 27.43-91.062 27.43-44.603 0-82.286 25.121-82.286 54.856 0 29.735 37.683 54.857 82.286 54.857 37.529 0 70.154-17.788 79.56-41.143h56.508c-3.965 25.322-18.79 48.984-42.029 66.413-25.44 19.080-58.838 29.587-94.039 29.587-35.202 0-68.598-10.507-94.037-29.587-27.394-20.545-43.106-49.751-43.106-80.127s15.712-59.582 43.106-80.127c0.978-0.733 1.971-1.449 2.973-2.158h-132.936v-32h256.266c29.104-8.553 50.021-28.135 50.021-50.286 0-29.734-37.684-54.855-82.286-54.855-37.53 0-70.154 17.787-79.559 41.143h-56.508c3.965-25.32 18.791-48.984 42.030-66.413 25.438-19.082 58.834-29.59 94.036-29.59 35.201 0 68.599 10.508 94.037 29.587 27.395 20.545 43.104 49.751 43.104 80.127 0 17.649-5.327 34.896-15.147 50.286h102.006v32z" />
+<glyph unicode="&#xe02e;" d="M192 416c-61.856 0-112-50.144-112-112s50.144-112 112-112v-160h64v320h32v-320h64v320h64v64h-224z" />
+<glyph unicode="&#xe02f;" d="M224 416c-61.856 0-112-50.144-112-112s50.144-112 112-112v-160h64v320h32v-320h64v320h64v64h-224zM32 32l112 96-112 96z" />
+<glyph unicode="&#xe030;" d="M160 416c-61.856 0-112-50.144-112-112s50.144-112 112-112v-160h64v320h32v-320h64v320h64v64h-224zM480 224l-112-96 112-96z" />
+<glyph unicode="&#xe031;" d="M416 320h-96v32l-96 96h-192v-352h192v-96h288v224l-96 96zM416 274.745l50.745-50.745h-50.745v50.745zM224 402.745l50.745-50.745h-50.745v50.745zM64 416h128v-96h96v-192h-224v288zM480 32h-224v64h64v192h64v-96h96v-160z" />
+<glyph unicode="&#xe032;" d="M384 352h32v-32h-32zM320 288h32v-32h-32zM320 224h32v-32h-32zM320 160h32v-32h-32zM256 224h32v-32h-32zM256 160h32v-32h-32zM192 160h32v-32h-32zM384 288h32v-32h-32zM384 224h32v-32h-32zM384 160h32v-32h-32zM384 96h32v-32h-32zM320 96h32v-32h-32zM256 96h32v-32h-32zM192 96h32v-32h-32zM128 96h32v-32h-32z" />
+<glyph unicode="&#xe034;" d="M464 416h-208l-16 32h-176l-32-64h448zM420.17 128h43.83l16 224h-448l32-320h178.040c-52.441 18.888-90.040 69.133-90.040 128 0 74.991 61.009 136 136 136 74.99 0 136-61.009 136-136 0-10.839-1.311-21.575-3.83-32zM437.498 55.125l-67.248 55.346c8.727 14.461 13.75 31.407 13.75 49.529 0 53.020-42.98 96-96 96s-96-42.98-96-96 42.98-96 96-96c18.122 0 35.069 5.023 49.529 13.75l55.346-67.248c11.481-13.339 31.059-14.070 43.503-1.626l2.746 2.746c12.444 12.444 11.713 32.022-1.626 43.503zM288 98c-34.242 0-62 27.758-62 62s27.758 62 62 62 62-27.758 62-62-27.758-62-62-62z" />
+<glyph unicode="&#xe035;" d="M352 288v80c0 8.8-7.2 16-16 16h-80v32c0 17.6-14.4 32-32 32h-64c-17.602 0-32-14.4-32-32v-32h-80c-8.801 0-16-7.2-16-16v-256c0-8.8 7.199-16 16-16h112v-96h288v288h-96zM160 415.943c0.017 0.019 0.036 0.039 0.057 0.057h63.884c0.021-0.018 0.041-0.038 0.059-0.057v-31.943h-64v31.943zM96 320v32h192v-32h-192zM416 32h-224v224h224v-224zM224 224v-64h16l16 32h32v-96h-24v-32h80v32h-24v96h32l16-32h16v64z" />
+</font></defs></svg>
\ No newline at end of file
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce-small.ttf b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.ttf
new file mode 100644
index 0000000..afc6ec4
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.ttf differ
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce-small.woff b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.woff
new file mode 100644
index 0000000..fa72c74
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/fonts/tinymce-small.woff differ
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce.dev.svg b/lib/test/data/js/skins/lightgray/fonts/tinymce.dev.svg
new file mode 100644
index 0000000..c87b8cd
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/fonts/tinymce.dev.svg
@@ -0,0 +1,153 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>
+This is a custom SVG font generated by IcoMoon.
+<iconset grid="16"></iconset>
+</metadata>
+<defs>
+<font id="tinymce" horiz-adv-x="512" >
+<font-face units-per-em="512" ascent="480" descent="-32" />
+<missing-glyph horiz-adv-x="512" />
+<glyph class="hidden" unicode="&#xf000;" d="M0,480L 512 -32L0 -32 z" horiz-adv-x="0" />
+<glyph unicode="&#xe034;" d="M 464,416L 256,416L 240,448L 64,448L 32,384L 480,384 zM 452.17,128l 37.43,0 L 512,352L0,352 l 32-320l 242.040,0 C 221.599,50.888, 184,101.133, 184,160c0,74.991, 61.009,136, 136,136
+	c 74.99,0, 136-61.009, 136-136C 456,149.161, 454.689,138.425, 452.17,128zM 501.498,23.125l-99.248,87.346C 410.977,124.931, 416,141.878, 416,160c0,53.020-42.98,96-96,96s-96-42.98-96-96
+	s 42.98-96, 96-96c 18.122,0, 35.069,5.023, 49.529,13.75l 87.346-99.248c 11.481-13.339, 31.059-14.070, 43.503-1.626l 2.746,2.746
+	C 515.568-7.934, 514.837,11.644, 501.498,23.125z M 320,98c-34.242,0-62,27.758-62,62s 27.758,62, 62,62s 62-27.758, 62-62
+	S 354.242,98, 320,98z" />
+<glyph unicode="&#xe032;" d="M 384,352L 416,352L 416,320L 384,320zM 320,288L 352,288L 352,256L 320,256zM 320,224L 352,224L 352,192L 320,192zM 320,160L 352,160L 352,128L 320,128zM 256,224L 288,224L 288,192L 256,192zM 256,160L 288,160L 288,128L 256,128zM 192,160L 224,160L 224,128L 192,128zM 384,288L 416,288L 416,256L 384,256zM 384,224L 416,224L 416,192L 384,192zM 384,160L 416,160L 416,128L 384,128zM 384,96L 416,96L 416,64L 384,64zM 320,96L 352,96L 352,64L 320,64zM 256,96L 288,96L 288,64L 256,64zM 192,96L 224,96L 224,64L 192,64zM 128,96L 160,96L 160,64L 128,64z" data-tags="resize, dots" />
+<glyph unicode="&#xe031;" d="M 416,352l-96,0 L 320,384 L 224,480L0,480 l0-384 l 192,0 l0-128 l 320,0 L 512,256 L 416,352z M 416,306.745L 466.745,256L 416,256 L 416,306.745 z M 224,434.745L 274.745,384L 224,384 
+	L 224,434.745 z M 32,448l 160,0 l0-96 l 96,0 l0-224 L 32,128 L 32,448 z M 480,0L 224,0 l0,96 l 96,0 L 320,320 l 64,0 l0-96 l 96,0 L 480,0 z" data-tags="copy" />
+<glyph unicode="&#xe030;" d="M 128,448 L 384,448 L 384,384 L 320,384 L 320,0 L 256,0 L 256,384 L 192,384 L 192,0 L 128,0 L 128,224 C 66.144,224 16,274.144 16,336 C 16,397.856 66.144,448 128,448 ZM 480,32L 352,144L 480,256 z" data-tags="rtl" />
+<glyph unicode="&#xe02f;" d="M 224,448 L 480,448 L 480,384 L 416,384 L 416,0 L 352,0 L 352,384 L 288,384 L 288,0 L 224,0 L 224,224 C 162.144,224 112,274.144 112,336 C 112,397.856 162.144,448 224,448 ZM 32,256L 160,144L 32,32 z" data-tags="ltr" />
+<glyph unicode="&#xe02e;" d="M 192,448 L 448,448 L 448,384 L 384,384 L 384,0 L 320,0 L 320,384 L 256,384 L 256,0 L 192,0 L 192,224 C 130.144,224 80,274.144 80,336 C 80,397.856 130.144,448 192,448 Z" data-tags="visualchars" />
+<glyph unicode="&#xe02d;" d="M 365.71,221.482 C 397.67,197.513 416,163.439 416,128 C 416,92.561 397.67,58.487 365.71,34.518 C 336.031,12.259 297.068,0 256,0 C 214.931,0 175.969,12.259 146.29,34.518 C 114.33,58.487 96,92.561 96,128 L 160,128 C 160,93.309 203.963,64 256,64 C 308.037,64 352,93.309 352,128 C 352,162.691 308.037,192 256,192 C 214.931,192 175.969,204.259 146.29,226.518 C 114.33,250.488 96,284.561 96,320 C 96,355.439 114.33,389.512 146.29,413.482 C 175.969,435.741 214.931,448 256,448 C 297.068,448 336.031,435.741 365.71,413.482 C 397.67,389.512 416,355.439 416,320 L 352,320 C 352,354.691 308.037,384 256,384 C 203.963,384 160,354.691 160,320 C 160,285.309 203.963,256 256,256 C 297.068,256 336.031,243.741 365.71,221.482 ZM0,224L 512,224L 512,192L0,192z" data-tags="strikethrough" />
+<glyph unicode="&#xe02c;" d="M 352,448 L 416,448 L 416,240 C 416,160.471 344.366,96 256,96 C 167.635,96 96,160.471 96,240 L 96,448 L 160,448 L 160,240 C 160,219.917 169.119,200.648 185.677,185.747 C 204.125,169.145 229.1,160 256,160 C 282.9,160 307.875,169.145 326.323,185.747 C 342.881,200.648 352,219.917 352,240 L 352,448 ZM 96,64L 416,64L 416,0L 96,0z" data-tags="underline" />
+<glyph unicode="&#xe02b;" d="M 448,448 L 448,416 L 384,416 L 224,32 L 288,32 L 288,0 L 64,0 L 64,32 L 128,32 L 288,416 L 224,416 L 224,448 Z" data-tags="italic" />
+<glyph unicode="&#xe02a;" d="M 353.94,237.674C 372.689,259.945, 384,288.678, 384,320c0,70.58-57.421,128-128,128l-64,0 l-64,0 L 96,448 l0-448 l 32,0 l 64,0 l 96,0 
+	c 70.579,0, 128,57.421, 128,128C 416,174.478, 391.101,215.248, 353.94,237.674z M 192,384l 50.75,0 c 27.984,0, 50.75-28.71, 50.75-64
+	s-22.766-64-50.75-64L 192,256 L 192,384 z M 271.5,64L 192,64 L 192,192 l 79.5,0 c 29.225,0, 53-28.71, 53-64S 300.725,64, 271.5,64z" data-tags="bold0" />
+<glyph unicode="&#xe029;" d="M 192,64L 288,64L 288-32L 192-32zM 400,448 C 426.51,448 448,426.51 448,400 L 448,256 L 288,160 L 288,96 L 192,96 L 192,192 L 352,288 L 352,352 L 96,352 L 96,448 L 400,448 Z" />
+<glyph unicode="&#xe028;" d="M 288,448 C 411.712,448 512,347.712 512,224 C 512,100.288 411.712,0 288,0 L 288,48 C 335.012,48 379.209,66.307 412.451,99.549 C 445.693,132.791 464,176.988 464,224 C 464,271.011 445.693,315.209 412.451,348.451 C 379.209,381.693 335.012,400 288,400 C 240.989,400 196.791,381.693 163.549,348.451 C 137.979,322.882 121.258,290.828 114.896,256 L 208,256 L 96,128 L -16,256 L 66.285,256 C 81.815,364.551 175.154,448 288,448 ZM 384,256 L 384,192 L 256,192 L 256,352 L 320,352 L 320,256 Z" data-tags="restoredraft" />
+<glyph unicode="&#xe027;" d="M0,224L 64,224L 64,192L0,192zM 96,224L 192,224L 192,192L 96,192zM 224,224L 288,224L 288,192L 224,192zM 320,224L 416,224L 416,192L 320,192zM 448,224L 512,224L 512,192L 448,192zM 440,480 L 448,256 L 64,256 L 72,480 L 88,480 L 96,288 L 416,288 L 424,480 ZM 72-32 L 64,160 L 448,160 L 440-32 L 424-32 L 416,128 L 96,128 L 88-32 Z" data-tags="pagebreak" />
+<glyph unicode="&#xe026;" d="M 192,384L 256,384L 256,352L 192,352zM 288,384L 352,384L 352,352L 288,352zM 448,384 L 448,256 L 352,256 L 352,288 L 416,288 L 416,352 L 384,352 L 384,384 ZM 160,288L 224,288L 224,256L 160,256zM 256,288L 320,288L 320,256L 256,256zM 96,352 L 96,288 L 128,288 L 128,256 L 64,256 L 64,384 L 160,384 L 160,352 ZM 192,192L 256,192L 256,160L 192,160zM 288,192L 352,192L 352,160L 288,160zM 448,192 L 448,64 L 352,64 L 352,96 L 416,96 L 416,160 L 384,160 L 384,192 ZM 160,96L 224,96L 224,64L 160,64zM 256,96L 320,96L 320,64L 256,64zM 96,160 L 96,96 L 128,96 L 128,64 L 64,64 L 64,192 L 160,192 L 160,160 ZM 480,448 L 32,448 L 32,0 L 480,0 L 480,448 Z M 512,480 L 512,480 L 512-32 L 0-32 L 0,480 L 512,480 Z" data-tags="template" />
+<glyph unicode="&#xe025;" d="M 224,192 L 128,192 L 128,256 L 224,256 L 224,352 L 288,352 L 288,256 L 384,256 L 384,192 L 288,192 L 288,96 L 224,96 ZM 512,160 L 512-32 L 0-32 L 0,160 L 64,160 L 64,32 L 448,32 L 448,160 Z" data-tags="nonbreaking" />
+<glyph unicode="&#xe024;" d="M 64,352l 64,0 l0-96 l 32,0 L 160,448 c0,17.6-14.4,32-32,32L 64,480 C 46.4,480, 32,465.6, 32,448l0-192 l 32,0 L 64,352 z M 64,448l 64,0 l0-64 L 64,384 L 64,448 z M 480,448L 480,480 l-96,0 
+	c-17.601,0-32-14.4-32-32l0-160 c0-17.6, 14.399-32, 32-32l 96,0 l0,32 l-96,0 L 384,448 L 480,448 z M 320,400L 320,448 c0,17.6-14.4,32-32,32l-96,0 l0-224 l 96,0 
+	c 17.6,0, 32,14.4, 32,32l0,48 c0,17.6-4.4,32-22,32C 315.6,368, 320,382.4, 320,400z M 288,288l-64,0 l0,64 l 64,0 L 288,288 z M 288,384l-64,0 L 224,448 l 64,0 L 288,384 zM 416,192 L 208-32 L 96,112 L 137,147 L 208,73 L 384,224 Z" data-tags="spellchecker" />
+<glyph unicode="&#xe023;" d="M 512,480 L 512,288 L 442.87,357.13 L 336.87,251.13 L 283.13,304.87 L 389.13,410.87 L 320,480 ZM 122.87,410.87 L 228.87,304.87 L 175.13,251.13 L 69.13,357.13 L 0,288 L 0,480 L 192,480 ZM 442.87,90.87 L 512,160 L 512-32 L 320-32 L 389.13,37.13 L 283.13,143.13 L 336.87,196.87 ZM 228.87,143.13 L 122.87,37.13 L 192-32 L 0-32 L 0,160 L 69.13,90.87 L 175.13,196.87 Z" data-tags="fullscreen" />
+<glyph unicode="&#xe022;" d="M 128,448L 384,448L 384,384L 128,384zM 480,352L 32,352 C 14.4,352,0,337.6,0,320l0-160 c0-17.6, 14.398-32, 32-32l 96,0 l0-128 l 256,0 L 384,128 l 96,0 c 17.6,0, 32,14.4, 32,32L 512,320 
+		C 512,337.6, 497.6,352, 480,352z M 352,32L 160,32 L 160,192 l 192,0 L 352,32 z M 487.2,304c0-12.813-10.387-23.2-23.199-23.2
+		c-12.813,0-23.201,10.387-23.201,23.2s 10.388,23.2, 23.201,23.2C 476.814,327.2, 487.2,316.813, 487.2,304z" data-tags="print" />
+<glyph unicode="&#xe021;" d="M 256,480C 114.615,480,0,365.386,0,224c0-141.385, 114.614-256, 256-256c 141.385,0, 256,114.615, 256,256
+	C 512,365.386, 397.385,480, 256,480z M 256,8c-119.293,0-216,96.706-216,216c0,119.293, 96.707,216, 216,216c 119.295,0, 216-96.707, 216-216
+	C 472,104.706, 375.295,8, 256,8z M 192,320c0-17.673-14.327-32-32-32s-32,14.327-32,32s 14.327,32, 32,32S 192,337.673, 192,320z
+	 M 384,320c0-17.673-14.326-32-32-32s-32,14.327-32,32s 14.326,32, 32,32S 384,337.673, 384,320zM 256,154 C 326.537,154 387.344,182.766 415.231,215.596 C 404.795,129.986 337.087,64 256,64 C 174.941,64 107.251,130.013 96.778,215.584 C 124.671,182.761 185.471,154 256,154 Z" data-tags="emoticons" />
+<glyph unicode="&#xe020;" d="M 352,32 L 480,32 L 512,96 L 512-32 L 320-32 L 320,75.107 C 385.556,103.349 432,173.688 432,256 C 432,363.216 353.201,447.133 256,447.133 C 158.797,447.133 80,363.217 80,256 C 80,173.688 126.443,103.349 192,75.107 L 192-32 L 0-32 L 0,96 L 32,32 L 160,32 L 160,48.295 C 66.185,81.525 0,161.996 0,256 C 0,379.712 114.615,480 256,480 C 397.385,480 512,379.712 512,256 C 512,161.996 445.815,81.525 352,48.295 L 352,32 Z" data-tags="charmap" />
+<glyph unicode="&#xe01f;" d="M 384,377 L 384,352 L 448,352 L 448,320 L 352,320 L 352,393 L 416,423 L 416,448 L 352,448 L 352,480 L 448,480 L 448,407 ZM 338,352L 270,352L 176,258L 82,352L 14,352L 142,224L 14,96L 82,96L 176,190L 270,96L 338,96L 210,224 z" data-tags="sup" />
+<glyph unicode="&#xe01e;" d="M 384,25 L 384,0 L 448,0 L 448-32 L 352-32 L 352,41 L 416,71 L 416,96 L 352,96 L 352,128 L 448,128 L 448,55 ZM 338,352L 270,352L 176,258L 82,352L 14,352L 142,224L 14,96L 82,96L 176,190L 270,96L 338,96L 210,224 z" data-tags="sub" />
+<glyph unicode="&#xe01d;" d="M0,32L 288,32L 288-32L0-32zM 96,480L 448,480L 448,416L 96,416zM 138.694,64 L 241.038,456.082 L 302.963,439.918 L 204.838,64 ZM 464.887-32 L 400,32.887 L 335.113-32 L 304-0.887 L 368.887,64 L 304,128.887 L 335.113,160 L 400,95.113 L 464.887,160 L 496,128.887 L 431.113,64 L 496-0.887 Z" data-tags="removeformat" />
+<glyph unicode="&#xe01c;" d="M0,256L 512,256L 512,192L0,192z" data-tags="hr" />
+<glyph unicode="&#xe01b;" d="M0,448l0-448 l 512,0 L 512,448 L0,448 z M 192,160l0,96 l 128,0 l0-96 L 192,160 z M 320,128l0-96 L 192,32 l0,96 L 320,128 z M 320,384l0-96 L 192,288 L 192,384 L 320,384 z M 160,384l0-96 L 32,288 L 32,384 L 160,384 z
+	 M 32,256l 128,0 l0-96 L 32,160 L 32,256 z M 352,256l 128,0 l0-96 L 352,160 L 352,256 z M 352,288L 352,384 l 128,0 l0-96 L 352,288 z M 32,128l 128,0 l0-96 L 32,32 L 32,128 z M 352,32l0,96 l 128,0 l0-96 L 352,32 z" data-tags="table" />
+<glyph unicode="&#xe01a;" d="M 161.009,64l 28.8,96l 132.382,0 l 28.8-96l 56.816,0 L 311.809,384L 200.191,384 l-96-320L 161.009,64 z M 237.809,320l 36.382,0 l 28.8-96l-93.982,0 
+	L 237.809,320z" data-tags="forecolor" />
+<glyph unicode="&#xe019;" d="M 256,320C 151.316,320, 58.378,269.722,0,192c 58.378-77.723, 151.316-128, 256-128c 104.684,0, 197.622,50.277, 256,128
+	C 453.622,269.722, 360.684,320, 256,320z M 224,256c 17.673,0, 32-14.327, 32-32s-14.327-32-32-32s-32,14.327-32,32S 206.327,256, 224,256z
+	 M 386.808,127.352c-19.824-10.129-40.826-17.931-62.423-23.188C 302.141,98.746, 279.134,96, 256,96
+	c-23.133,0-46.141,2.746-68.384,8.162c-21.597,5.259-42.599,13.061-62.423,23.188c-31.51,16.101-60.111,38.205-83.82,64.649
+	c 23.709,26.444, 52.31,48.55, 83.82,64.649c 16.168,8.261, 33.121,14.973, 50.541,20.020C 165.79,261.547, 160,243.451, 160,224
+	c0-53.020, 42.981-96, 96-96c 53.019,0, 96,42.98, 96,96c0,19.451-5.791,37.547-15.733,52.67c 17.419-5.048, 34.372-11.76, 50.541-20.021
+	c 31.511-16.099, 60.109-38.204, 83.819-64.649C 446.917,165.557, 418.318,143.45, 386.808,127.352z M 430.459,358.139
+	C 376.099,385.916, 317.403,400, 256,400c-61.403,0-120.099-14.084-174.459-41.861C 52.155,343.123, 24.675,324.187,0,302.101l0-54.603 
+	c 27.669,29.283, 60.347,53.877, 96.097,72.145C 145.907,345.095, 199.706,358, 256,358s 110.093-12.905, 159.902-38.358
+	c 35.751-18.268, 68.429-42.862, 96.098-72.145L 512,302.1 C 487.325,324.187, 459.846,343.123, 430.459,358.139z" data-tags="preview" />
+<glyph unicode="&#xe018;" d="M 256,384C 149.962,384, 64,298.039, 64,192s 85.961-192, 192-192c 106.037,0, 192,85.961, 192,192S 362.037,384, 256,384z
+		 M 357.822,90.177C 330.626,62.979, 294.464,48, 256,48s-74.625,14.979-101.823,42.177C 126.979,117.374, 112,153.536, 112,192
+		s 14.979,74.625, 42.177,101.823C 181.375,321.021, 217.536,336, 256,336s 74.626-14.979, 101.821-42.177
+		C 385.022,266.625, 400,230.464, 400,192S 385.021,117.374, 357.822,90.177zM 162.965,378.069l-21.47,42.939C 92.058,396.24, 51.76,355.942, 26.992,306.504l 42.938-21.47
+		C 90.054,325.202, 122.796,357.945, 162.965,378.069zM 442.067,285.035l 42.939,21.469C 460.24,355.942, 419.943,396.24, 370.504,421.008l-21.472-42.939
+		C 389.201,357.945, 421.944,325.203, 442.067,285.035zM 256,288l-32,0 l0-96 c0-5.055, 2.35-9.555, 6.011-12.486l-0.006-0.008l 80-64l 19.988,24.988L 256,199.689L 256,288 z" data-tags="inserttime" />
+<glyph unicode="&#xe017;" d="M 160,352L 32,224L 160,96L 224,96L 96,224L 224,352 	zM 352,352L 288,352L 416,224L 288,96L 352,96L 480,224 	z" data-tags="code" />
+<glyph unicode="&#xe016;" d="M 224,128L 288,128L 288,64L 224,64zM 352,352 C 369.673,352 384,337.673 384,320 L 384,224 L 288,160 L 224,160 L 224,192 L 320,256 L 320,288 L 160,288 L 160,352 L 352,352 ZM 256,432 C 200.441,432 148.208,410.364 108.922,371.078 C 69.636,331.792 48,279.559 48,224 C 48,168.441 69.636,116.208 108.922,76.922 C 148.208,37.636 200.441,16 256,16 C 311.559,16 363.792,37.636 403.078,76.922 C 442.364,116.208 464,168.441 464,224 C 464,279.559 442.364,331.792 403.078,371.078 C 363.792,410.364 311.559,432 256,432 Z M 256,480 L 256,480 C 397.385,480 512,365.385 512,224 C 512,82.615 397.385-32 256-32 C 114.615-32 0,82.615 0,224 C 0,365.385 114.615,480 256,480 Z" data-tags="help" />
+<glyph unicode="&#xe015;" d="M0,416l0-384 l 512,0 L 512,416 L0,416 z M 96,64L 32,64 l0,64 l 64,0 L 96,64 z M 96,192L 32,192 l0,64 l 64,0 L 96,192 z M 96,320L 32,320 L 32,384 l 64,0 L 96,320 z M 384,64L 128,64 L 128,384 l 256,0 L 384,64 z
+		 M 480,64l-64,0 l0,64 l 64,0 L 480,64 z M 480,192l-64,0 l0,64 l 64,0 L 480,192 z M 480,320l-64,0 L 416,384 l 64,0 L 480,320 zM 192,320L 192,128L 320,224 	z" data-tags="media" />
+<glyph unicode="&#xe014;" d="M0,416l0-416 l 512,0 L 512,416 L0,416 z M 480,32L 32,32 L 32,384 l 448,0 L 480,32 zM 352,304A48,48 3060 1 0 448,304A48,48 3060 1 0 352,304zM 448,64 L 64,64 L 160,320 L 288,160 L 352,208 Z" data-tags="image" />
+<glyph unicode="&#xe013;" d="M 96,480l0-512 l 160,160l 160-160L 416,480 L 96,480 z M 384,45.255l-128,128l-128-128L 128,448 l 256,0 L 384,45.255 z" data-tags="anchor" />
+<glyph unicode="&#xe012;" d="M 238.444,142.443c 2.28-4.524, 3.495-9.579, 3.495-14.848c0-8.808-3.372-17.029-9.496-23.154l-81.69-81.69
+		c-6.124-6.124-14.348-9.496-23.154-9.496s-17.030,3.372-23.154,9.496l-49.69,49.69c-6.124,6.125-9.496,14.348-9.496,23.154
+		s 3.372,17.030, 9.496,23.154l 81.69,81.691c 6.124,6.123, 14.348,9.496, 23.154,9.496c 5.269,0, 10.322-1.215, 14.848-3.494l 32.669,32.668
+		c-13.935,10.705-30.72,16.080-47.517,16.080c-19.993,0-39.986-7.583-55.154-22.751l-81.69-81.691
+		c-30.335-30.335-30.335-79.975,0-110.309l 49.69-49.691c 15.167-15.166, 35.16-22.75, 55.153-22.75
+		c 19.994,0, 39.987,7.584, 55.154,22.751l 81.69,81.69c 27.91,27.91, 30.119,72.149, 6.672,102.673L 238.444,142.443zM 489.248,407.558l-49.69,49.691C 424.391,472.417, 404.398,480, 384.404,480c-19.993,0-39.985-7.583-55.153-22.751l-81.691-81.691
+		c-27.91-27.91-30.119-72.149-6.671-102.671l 32.669,32.67c-2.279,4.525-3.494,9.58-3.494,14.847c0,8.808, 3.372,17.030, 9.496,23.154
+		l 81.691,81.691c 6.123,6.124, 14.347,9.497, 23.153,9.497c 8.808,0, 17.030-3.373, 23.154-9.497l 49.69-49.691
+		c 6.124-6.124, 9.496-14.347, 9.496-23.154c0-8.807-3.372-17.030-9.496-23.154l-81.69-81.691c-6.124-6.124-14.347-9.496-23.154-9.496
+		c-5.268,0-10.322,1.215-14.848,3.495l-32.669-32.669c 13.936-10.705, 30.72-16.080, 47.517-16.080c 19.994,0, 39.987,7.584, 55.154,22.752
+		l 81.69,81.69C 519.584,327.584, 519.584,377.223, 489.248,407.558zM 116.684,340.688L 20.687,436.685L 43.315,459.313L 139.312,363.316zM 192,480L 224,480L 224,384L 192,384zM0,288L 96,288L 96,256L0,256zM 395.316,107.312L 491.314,11.314L 468.686-11.314L 372.688,84.684zM 288,64L 320,64L 320-32L 288-32zM 416,192L 512,192L 512,160L 416,160z" data-tags="unlink" />
+<glyph unicode="&#xe011;" d="M 160,128c 8.8-8.8, 23.637-8.363, 32.971,0.971L 351.030,287.029C 360.364,296.363, 360.8,311.2, 352,320
+		s-23.637,8.363-32.971-0.971L 160.971,160.971C 151.637,151.637, 151.2,136.8, 160,128zM 238.444,142.444c 2.28-4.525, 3.495-9.58, 3.495-14.848c0-8.808-3.372-17.030-9.496-23.154l-81.691-81.691
+		c-6.124-6.124-14.347-9.496-23.154-9.496s-17.030,3.372-23.154,9.496l-49.691,49.691c-6.124,6.124-9.496,14.347-9.496,23.154
+		s 3.372,17.030, 9.496,23.154l 81.691,81.691c 6.124,6.124, 14.347,9.497, 23.154,9.497c 5.268,0, 10.322-1.215, 14.848-3.495l 32.669,32.669
+		c-13.935,10.705-30.72,16.080-47.517,16.080c-19.993,0-39.986-7.583-55.154-22.751l-81.691-81.691
+		c-30.335-30.335-30.335-79.974,0-110.309l 49.691-49.691C 87.611-24.416, 107.604-32, 127.597-32
+		c 19.994,0, 39.987,7.584, 55.154,22.751l 81.691,81.691c 27.91,27.91, 30.119,72.149, 6.672,102.672L 238.444,142.444zM 489.249,407.558l-49.691,49.691C 424.391,472.417, 404.398,480, 384.404,480c-19.993,0-39.986-7.583-55.154-22.751l-81.691-81.691
+		c-27.91-27.91-30.119-72.149-6.671-102.671l 32.669,32.67c-2.279,4.525-3.494,9.58-3.494,14.847c0,8.808, 3.372,17.030, 9.496,23.154
+		l 81.691,81.691c 6.124,6.124, 14.347,9.497, 23.154,9.497s 17.030-3.373, 23.154-9.497l 49.691-49.691
+		c 6.124-6.124, 9.496-14.347, 9.496-23.154s-3.372-17.030-9.496-23.154l-81.691-81.691c-6.124-6.124-14.347-9.496-23.154-9.496
+		c-5.268,0-10.322,1.215-14.848,3.495l-32.669-32.669c 13.936-10.705, 30.72-16.080, 47.517-16.080c 19.994,0, 39.987,7.584, 55.154,22.751
+		l 81.691,81.691C 519.584,327.584, 519.584,377.223, 489.249,407.558z" data-tags="link" />
+<glyph unicode="&#xe010;" d="M 288,355.814L 288,480 l 192-192L 288,96L 288,222.912 C 64.625,228.153, 74.206,71.016, 131.070-32
+	C-9.286,119.707, 20.52,362.785, 288,355.814z" data-tags="redo" />
+<glyph unicode="&#xe00f;" d="M 380.931-32C 437.794,71.016, 447.375,228.153, 224,222.912L 224,96 L 32,288L 224,480l0-124.186 
+	C 491.481,362.785, 521.285,119.707, 380.931-32z" data-tags="undo" />
+<glyph unicode="&#xe00e;" d="M 112.5,256 C 174.356,256 224.5,205.855 224.5,144 C 224.5,82.144 174.356,32 112.5,32 C 50.644,32 0.5,82.144 0.5,144 L 0,160 C 0,283.712 100.288,384 224,384 L 224,320 C 181.263,320 141.083,303.357 110.863,273.137 C 105.046,267.319 99.737,261.129 94.948,254.627 C 100.667,255.527 106.528,256 112.5,256 ZM 400.5,256 C 462.355,256 512.5,205.855 512.5,144 C 512.5,82.144 462.355,32 400.5,32 C 338.645,32 288.5,82.144 288.5,144 L 288,160 C 288,283.712 388.288,384 512,384 L 512,320 C 469.263,320 429.083,303.357 398.863,273.137 C 393.045,267.319 387.736,261.129 382.947,254.627 C 388.667,255.527 394.527,256 400.5,256 Z" data-tags="blockquote" />
+<glyph unicode="&#xe00d;" d="M0,448L 512,448L 512,384L0,384zM 192,352L 512,352L 512,288L 192,288zM 192,256L 512,256L 512,192L 192,192zM 192,160L 512,160L 512,96L 192,96zM0,64L 512,64L 512,0L0,0zM 128,320 L 128,128 L 0,224 Z" data-tags="outdent" />
+<glyph unicode="&#xe00c;" d="M0,448L 512,448L 512,384L0,384zM 192,352L 512,352L 512,288L 192,288zM 192,256L 512,256L 512,192L 192,192zM 192,160L 512,160L 512,96L 192,96zM0,64L 512,64L 512,0L0,0zM 0,128 L 0,320 L 128,224 Z" data-tags="indent" />
+<glyph unicode="&#xe00b;" d="M 192,64L 512,64L 512,0L 192,0zM 192,256L 512,256L 512,192L 192,192zM 192,448L 512,448L 512,384L 192,384zM 96,480 L 96,352 L 64,352 L 64,448 L 32,448 L 32,480 ZM 64,217 L 64,192 L 128,192 L 128,160 L 32,160 L 32,233 L 96,263 L 96,288 L 32,288 L 32,320 L 128,320 L 128,247 ZM 128,128 L 128-32 L 32-32 L 32,0 L 96,0 L 96,32 L 32,32 L 32,64 L 96,64 L 96,96 L 32,96 L 32,128 Z" data-tags="numlist" />
+<glyph unicode="&#xe00a;" d="M 192,448l 320,0 l0-64 L 192,384 L 192,448 z M 192,256l 320,0 l0-64 L 192,192 L 192,256 z M 192,64l 320,0 l0-64 L 192,0 L 192,64 zM0,416A64,64 3060 1 0 128,416A64,64 3060 1 0 0,416zM0,224A64,64 3060 1 0 128,224A64,64 3060 1 0 0,224zM0,32A64,64 3060 1 0 128,32A64,64 3060 1 0 0,32z" data-tags="bullist" />
+<glyph unicode="&#xe009;" d="M 32,480L 224,480L 224,448L 32,448zM 288,480L 480,480L 480,448L 288,448zM 476,320l-28,0 L 448,448 L 320,448 l0-128 L 192,320 L 192,448 L 64,448 l0-128 L 36,320 c-19.8,0-36-16.2-36-36l0-280 c0-19.8, 16.2-36, 36-36l 152,0 c 19.8,0, 36,16.2, 36,36L 224,192 l 64,0 
+	l0-188 c0-19.8, 16.2-36, 36-36l 152,0 c 19.8,0, 36,16.2, 36,36L 512,284 C 512,303.8, 495.8,320, 476,320z M 174,0L 50,0 c-9.9,0-18,7.2-18,16
+	s 8.1,16, 18,16l 124,0 c 9.9,0, 18-7.2, 18-16S 183.9,0, 174,0z M 272,224l-32,0 c-8.8,0-16,7.2-16,16s 7.2,16, 16,16l 32,0 c 8.8,0, 16-7.2, 16-16
+	S 280.8,224, 272,224z M 462,0L 338,0 c-9.9,0-18,7.2-18,16s 8.1,16, 18,16l 124,0 c 9.9,0, 18-7.2, 18-16S 471.9,0, 462,0z" data-tags="searchreplace" />
+<glyph unicode="&#xe008;" d="M 416,320L 416,400 c0,8.8-7.2,16-16,16L 288,416 L 288,448 c0,17.6-14.4,32-32,32l-64,0 c-17.602,0-32-14.4-32-32l0-32 L 48,416 c-8.801,0-16-7.2-16-16l0-320 
+	c0-8.8, 7.199-16, 16-16l 144,0 l0-96 l 224,0 l 96,96L 512,320 L 416,320 z M 192,447.943c 0.017,0.019, 0.036,0.039, 0.057,0.057l 63.884,0 
+	c 0.021-0.018, 0.041-0.038, 0.059-0.057L 256,416 l-64,0 L 192,447.943 z M 96,352L 96,384 l 256,0 l0-32 L 96,352 z M 416,13.255L 416,64 l 50.745,0 L 416,13.255z M 480,96l-96,0 l0-96 
+	L 224,0 L 224,288 l 256,0 L 480,96 z" data-tags="paste" />
+<glyph unicode="&#xe007;" d="M 445.387,125.423c-22.827,22.778-51.864,34.536-78.973,34.536l-14.556,0 l-31.952,32.004l 127.81,128.019
+	c 31.952,32.005, 31.952,96.014,0,128.019L 256.001,255.973L 64.285,448c-31.952-32.004-31.952-96.014,0-128.019l 127.811-128.017
+	l-31.953-32.004l-14.557,0 c-27.11,0-56.146-11.759-78.974-34.538c-40.811-40.721-46.325-101.242-12.315-135.175
+	C 69.282-24.704, 89.441-32, 110.795-32c 27.108,0, 56.145,11.757, 78.973,34.536c 26.792,26.732, 38.371,62, 33.542,92.674l 32.692,32.744
+	l 32.688-32.744c-4.828-30.674, 6.753-65.941, 33.542-92.674C 345.063-20.243, 374.098-32, 401.206-32
+	c 21.354,0, 41.512,7.296, 56.497,22.248C 491.713,24.181, 486.197,84.702, 445.387,125.423z M 176.512,57.231
+	c-3.849-8.941-9.505-17.173-16.813-24.463c-7.318-7.302-15.586-12.959-24.574-16.812c-8.066-3.458-16.48-5.284-24.331-5.284
+	c-7.573,0-18.306,1.701-26.431,9.806c-8.068,8.052-9.76,18.659-9.76,26.144c0,7.771, 1.821,16.105, 5.263,24.106
+	c 3.85,8.942, 9.507,17.173, 16.813,24.463c 7.317,7.303, 15.586,12.957, 24.575,16.812c 8.067,3.457, 16.48,5.284, 24.332,5.284
+	c 7.573,0, 18.306-1.7, 26.429-9.807c 8.067-8.049, 9.761-18.658, 9.761-26.142C 181.777,73.567, 179.957,65.23, 176.512,57.231z
+	 M 256.002,146.702c-24.957,0-45.188,20.266-45.188,45.263c0,24.996, 20.231,45.26, 45.188,45.26s 45.186-20.264, 45.186-45.26
+	C 301.188,166.966, 280.958,146.702, 256.002,146.702z M 427.636,20.479c-8.124-8.104-18.856-9.806-26.43-9.806
+	c-7.852,0-16.265,1.826-24.333,5.284c-8.986,3.853-17.254,9.51-24.571,16.812c-7.307,7.29-12.963,15.521-16.813,24.463
+	c-3.443,7.999-5.263,16.336-5.263,24.106c0,7.483, 1.692,18.094, 9.76,26.143c 8.123,8.104, 18.856,9.807, 26.43,9.807
+	c 7.85,0, 16.265-1.827, 24.33-5.284c 8.989-3.854, 17.258-9.509, 24.575-16.812c 7.305-7.29, 12.962-15.521, 16.813-24.463
+	c 3.442-7.999, 5.263-16.335, 5.263-24.106C 437.396,39.138, 435.702,28.53, 427.636,20.479z" data-tags="cut" />
+<glyph unicode="&#xe006;" d="M0,448L 512,448L 512,384L0,384zM0,352L 512,352L 512,288L0,288zM0,256L 512,256L 512,192L0,192zM0,160L 512,160L 512,96L0,96zM0,64L 512,64L 512,0L0,0z" data-tags="alignjustify" />
+<glyph unicode="&#xe005;" d="M0,448L 512,448L 512,384L0,384zM 192,352L 512,352L 512,288L 192,288zM 192,160L 512,160L 512,96L 192,96zM0,256L 512,256L 512,192L0,192zM0,64L 512,64L 512,0L0,0z" data-tags="alignright" />
+<glyph unicode="&#xe004;" d="M0,448L 512,448L 512,384L0,384zM 96,352L 416,352L 416,288L 96,288zM 96,160L 416,160L 416,96L 96,96zM0,256L 512,256L 512,192L0,192zM0,64L 512,64L 512,0L0,0z" data-tags="aligncenter" />
+<glyph unicode="&#xe003;" d="M0,448L 512,448L 512,384L0,384zM0,352L 320,352L 320,288L0,288zM0,160L 320,160L 320,96L0,96zM0,256L 512,256L 512,192L0,192zM0,64L 512,64L 512,0L0,0z" data-tags="alignleft" />
+<glyph unicode="&#xe002;" d="M 512,183.771l0,80.458 l-79.572,7.957c-4.093,15.021-10.044,29.274-17.605,42.49l 52.298,63.919L 410.595,435.12l-63.918-52.298
+	c-13.217,7.562-27.471,13.513-42.491,17.604L 296.229,480l-80.458,0 l-7.957-79.573c-15.021-4.093-29.274-10.043-42.49-17.604
+	L 101.405,435.12L 44.88,378.595l 52.298-63.918c-7.562-13.216-13.513-27.47-17.605-42.49L0,264.229l0-80.458 l 79.573-7.957
+	c 4.093-15.021, 10.043-29.274, 17.605-42.491L 44.88,69.405l 56.524-56.524l 63.919,52.298c 13.216-7.562, 27.47-13.514, 42.49-17.605
+	L 215.771-32l 80.458,0 l 7.957,79.572c 15.021,4.093, 29.274,10.044, 42.491,17.605l 63.918-52.298l 56.524,56.524l-52.298,63.918
+	c 7.562,13.217, 13.514,27.471, 17.605,42.49L 512,183.771z M 352,192l-64-64l-64,0 l-64,64l0,64 l 64,64l 64,0 l 64-64L 352,192 z" data-tags="fullpage" />
+<glyph unicode="&#xe001;" d="M 451.716,380.285l-71.432,71.431C 364.728,467.272, 334,480, 312,480L 72,480 C 50,480, 32,462, 32,440l0-432 c0-22, 18-40, 40-40l 368,0 c 22,0, 40,18, 40,40
+	L 480,312 C 480,334, 467.272,364.729, 451.716,380.285z M 429.089,357.657c 1.565-1.565, 3.125-3.487, 4.64-5.657L 352,352 L 352,433.728 
+	c 2.17-1.515, 4.092-3.075, 5.657-4.64L 429.089,357.657z M 448,8c0-4.336-3.664-8-8-8L 72,0 c-4.336,0-8,3.664-8,8L 64,440 c0,4.336, 3.664,8, 8,8
+	l 240,0 c 2.416,0, 5.127-0.305, 8-0.852L 320,320 l 127.148,0 c 0.547-2.873, 0.852-5.583, 0.852-8L 448,8 z" data-tags="newdocument" />
+<glyph unicode="&#xe000;" d="M 448,480L0,480 l0-512 l 512,0 L 512,416 L 448,480z M 256,416l 64,0 l0-128 l-64,0 L 256,416 z M 448,32L 64,32 L 64,416 l 32,0 l0-160 l 288,0 L 384,416 l 37.489,0 L 448,389.491L 448,32 z" data-tags="save" />
+<glyph unicode="&#xe033;" d="M 64,208L 208,64L 448,304L 384,368L 208,192L 128,272 z" />
+<glyph unicode="&#xe035;" d="M 256,224L 256,160L 272,160L 288,192L 320,192L 320,64L 296,64L 296,32L 408,32L 408,64L 384,64L 384,192L 416,192L 432,160L 448,160L 448,224 	zM 416,320L 416,400 c0,8.8-7.2,16-16,16L 288,416 L 288,448 c0,17.6-14.4,32-32,32l-64,0 c-17.602,0-32-14.4-32-32l0-32 L 48,416 c-8.801,0-16-7.2-16-16l0-320 
+		c0-8.8, 7.199-16, 16-16l 144,0 l0-96 l 320,0 L 512,320 L 416,320 z M 192,447.943c 0.017,0.019, 0.036,0.039, 0.057,0.057l 63.884,0 
+		c 0.021-0.018, 0.041-0.038, 0.059-0.057L 256,416 l-64,0 L 192,447.943 z M 96,352L 96,384 l 256,0 l0-32 L 96,352 z M 480,0L 224,0 L 224,288 l 256,0 L 480,0 z" data-tags="pastetext" />
+<glyph unicode="&#x20;" horiz-adv-x="256" />
+</font></defs></svg>
\ No newline at end of file
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce.eot b/lib/test/data/js/skins/lightgray/fonts/tinymce.eot
new file mode 100644
index 0000000..c1085bf
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/fonts/tinymce.eot differ
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce.svg b/lib/test/data/js/skins/lightgray/fonts/tinymce.svg
new file mode 100644
index 0000000..feb9ba3
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/fonts/tinymce.svg
@@ -0,0 +1,63 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>Generated by IcoMoon</metadata>
+<defs>
+<font id="tinymce" horiz-adv-x="512">
+<font-face units-per-em="512" ascent="480" descent="-32" />
+<missing-glyph horiz-adv-x="512" />
+<glyph unicode="&#x20;" d="" horiz-adv-x="256" />
+<glyph unicode="&#xe000;" d="M448 480h-448v-512h512v448l-64 64zM256 416h64v-128h-64v128zM448 32h-384v384h32v-160h288v160h37.489l26.511-26.509v-357.491z" />
+<glyph unicode="&#xe001;" d="M451.716 380.285l-71.432 71.431c-15.556 15.556-46.284 28.284-68.284 28.284h-240c-22 0-40-18-40-40v-432c0-22 18-40 40-40h368c22 0 40 18 40 40v304c0 22-12.728 52.729-28.284 68.285zM429.089 357.657c1.565-1.565 3.125-3.487 4.64-5.657h-81.729v81.728c2.17-1.515 4.092-3.075 5.657-4.64l71.432-71.431zM448 8c0-4.336-3.664-8-8-8h-368c-4.336 0-8 3.664-8 8v432c0 4.336 3.664 8 8 8h240c2.416 0 5.127-0.305 8-0.852v-127.148h127.148c0.547-2.873 0.852-5.583 0.852-8v-304z" />
+<glyph unicode="&#xe002;" d="M512 183.771v80.458l-79.572 7.957c-4.093 15.021-10.044 29.274-17.605 42.49l52.298 63.919-56.526 56.525-63.918-52.298c-13.217 7.562-27.471 13.513-42.491 17.604l-7.957 79.574h-80.458l-7.957-79.573c-15.021-4.093-29.274-10.043-42.49-17.604l-63.919 52.297-56.525-56.525 52.298-63.918c-7.562-13.216-13.513-27.47-17.605-42.49l-79.573-7.958v-80.458l79.573-7.957c4.093-15.021 10.043-29.274 17.605-42.491l-52.298-63.918 56.524-56.524 63.919 52.298c13.216-7.562 27.47-13.514 42.49-17.605l7.958-79.574h80.458l7.957 79.572c15.021 4.093 29.274 10.044 42.491 17.605l63.918-52.298 56.524 56.524-52.298 63.918c7.562 13.217 13.514 27.471 17.605 42.49l79.574 7.96zM352 192l-64-64h-64l-64 64v64l64 64h64l64-64v-64z" />
+<glyph unicode="&#xe003;" d="M0 448h512v-64h-512zM0 352h320v-64h-320zM0 160h320v-64h-320zM0 256h512v-64h-512zM0 64h512v-64h-512z" />
+<glyph unicode="&#xe004;" d="M0 448h512v-64h-512zM96 352h320v-64h-320zM96 160h320v-64h-320zM0 256h512v-64h-512zM0 64h512v-64h-512z" />
+<glyph unicode="&#xe005;" d="M0 448h512v-64h-512zM192 352h320v-64h-320zM192 160h320v-64h-320zM0 256h512v-64h-512zM0 64h512v-64h-512z" />
+<glyph unicode="&#xe006;" d="M0 448h512v-64h-512zM0 352h512v-64h-512zM0 256h512v-64h-512zM0 160h512v-64h-512zM0 64h512v-64h-512z" />
+<glyph unicode="&#xe007;" d="M445.387 125.423c-22.827 22.778-51.864 34.536-78.973 34.536h-14.556l-31.952 32.004 127.81 128.019c31.952 32.005 31.952 96.014 0 128.019l-191.715-192.028-191.716 192.027c-31.952-32.004-31.952-96.014 0-128.019l127.811-128.017-31.953-32.004h-14.557c-27.11 0-56.146-11.759-78.974-34.538-40.811-40.721-46.325-101.242-12.315-135.175 14.985-14.951 35.144-22.247 56.498-22.247 27.108 0 56.145 11.757 78.973 34.536 26.792 26.732 38.371 62 33.542 92.674l32.692 32.744 32.688-32.744c-4.828-30.674 6.753-65.941 33.542-92.674 22.831-22.779 51.866-34.536 78.974-34.536 21.354 0 41.512 7.296 56.497 22.248 34.010 33.933 28.494 94.454-12.316 135.175zM176.512 57.231c-3.849-8.941-9.505-17.173-16.813-24.463-7.318-7.302-15.586-12.959-24.574-16.812-8.066-3.458-16.48-5.284-24.331-5.284-7.573 0-18.306 1.701-26.431 9.806-8.068 8.052-9.76 18.659-9.76 26.144 0 7.771 1.821 16.105 5.263 24.106 3.85 8.942 9.507 17.173 16.813 24.463 7.317 7.303 15.586 12.957 24.575 16.812 8.067 3.457 16.48 5.284 24.332 5.284 7.573 0 18.306-1.7 26.429-9.807 8.067-8.049 9.761-18.658 9.761-26.142 0.001-7.771-1.819-16.108-5.264-24.107zM256.002 146.702c-24.957 0-45.188 20.266-45.188 45.263 0 24.996 20.231 45.26 45.188 45.26s45.186-20.264 45.186-45.26c0-24.999-20.23-45.263-45.186-45.263zM427.636 20.479c-8.124-8.104-18.856-9.806-26.43-9.806-7.852 0-16.265 1.826-24.333 5.284-8.986 3.853-17.254 9.51-24.571 16.812-7.307 7.29-12.963 15.521-16.813 24.463-3.443 7.999-5.263 16.336-5.263 24.106 0 7.483 1.692 18.094 9.76 26.143 8.123 8.104 18.856 9.807 26.43 9.807 7.85 0 16.265-1.827 24.33-5.284 8.989-3.854 17.258-9.509 24.575-16.812 7.305-7.29 12.962-15.521 16.813-24.463 3.442-7.999 5.263-16.335 5.263-24.106-0.001-7.485-1.695-18.093-9.761-26.144z" />
+<glyph unicode="&#xe008;" d="M416 320v80c0 8.8-7.2 16-16 16h-112v32c0 17.6-14.4 32-32 32h-64c-17.602 0-32-14.4-32-32v-32h-112c-8.801 0-16-7.2-16-16v-320c0-8.8 7.199-16 16-16h144v-96h224l96 96v256h-96zM192 447.943c0.017 0.019 0.036 0.039 0.057 0.057h63.884c0.021-0.018 0.041-0.038 0.059-0.057v-31.943h-64v31.943zM96 352v32h256v-32h-256zM416 13.255v50.745h50.745l-50.745-50.745zM480 96h-96v-96h-160v288h256v-192z" />
+<glyph unicode="&#xe009;" d="M32 480h192v-32h-192zM288 480h192v-32h-192zM476 320h-28v128h-128v-128h-128v128h-128v-128h-28c-19.8 0-36-16.2-36-36v-280c0-19.8 16.2-36 36-36h152c19.8 0 36 16.2 36 36v188h64v-188c0-19.8 16.2-36 36-36h152c19.8 0 36 16.2 36 36v280c0 19.8-16.2 36-36 36zM174 0h-124c-9.9 0-18 7.2-18 16s8.1 16 18 16h124c9.9 0 18-7.2 18-16s-8.1-16-18-16zM272 224h-32c-8.8 0-16 7.2-16 16s7.2 16 16 16h32c8.8 0 16-7.2 16-16s-7.2-16-16-16zM462 0h-124c-9.9 0-18 7.2-18 16s8.1 16 18 16h124c9.9 0 18-7.2 18-16s-8.1-16-18-16z" />
+<glyph unicode="&#xe00a;" d="M192 448h320v-64h-320v64zM192 256h320v-64h-320v64zM192 64h320v-64h-320v64zM0 416c0 35.346 28.654 64 64 64s64-28.654 64-64c0-35.346-28.654-64-64-64-35.346 0-64 28.654-64 64zM0 224c0 35.346 28.654 64 64 64s64-28.654 64-64c0-35.346-28.654-64-64-64-35.346 0-64 28.654-64 64zM0 32c0 35.346 28.654 64 64 64s64-28.654 64-64c0-35.346-28.654-64-64-64-35.346 0-64 28.654-64 64z" />
+<glyph unicode="&#xe00b;" d="M192 64h320v-64h-320zM192 256h320v-64h-320zM192 448h320v-64h-320zM96 480v-128h-32v96h-32v32zM64 217v-25h64v-32h-96v73l64 30v25h-64v32h96v-73zM128 128v-160h-96v32h64v32h-64v32h64v32h-64v32z" />
+<glyph unicode="&#xe00c;" d="M0 448h512v-64h-512zM192 352h320v-64h-320zM192 256h320v-64h-320zM192 160h320v-64h-320zM0 64h512v-64h-512zM0 128v192l128-96z" />
+<glyph unicode="&#xe00d;" d="M0 448h512v-64h-512zM192 352h320v-64h-320zM192 256h320v-64h-320zM192 160h320v-64h-320zM0 64h512v-64h-512zM128 320v-192l-128 96z" />
+<glyph unicode="&#xe00e;" d="M112.5 256c61.856 0 112-50.145 112-112 0-61.856-50.144-112-112-112-61.856 0-112 50.144-112 112l-0.5 16c0 123.712 100.288 224 224 224v-64c-42.737 0-82.917-16.643-113.137-46.863-5.817-5.818-11.126-12.008-15.915-18.51 5.719 0.9 11.58 1.373 17.552 1.373zM400.5 256c61.855 0 112-50.145 112-112 0-61.856-50.145-112-112-112-61.855 0-112 50.144-112 112l-0.5 16c0 123.712 100.288 224 224 224v-64c-42.737 0-82.917-16.643-113.137-46.863-5.818-5.818-11.127-12.008-15.916-18.51 5.72 0.9 11.58 1.373 17.553 1.373z" />
+<glyph unicode="&#xe00f;" d="M380.931-32c56.863 103.016 66.444 260.153-156.931 254.912v-126.912l-192 192 192 192v-124.186c267.481 6.971 297.285-236.107 156.931-387.814z" />
+<glyph unicode="&#xe010;" d="M288 355.814v124.186l192-192-192-192v126.912c-223.375 5.241-213.794-151.896-156.93-254.912-140.356 151.707-110.55 394.785 156.93 387.814z" />
+<glyph unicode="&#xe011;" d="M160 128c8.8-8.8 23.637-8.363 32.971 0.971l158.059 158.058c9.334 9.334 9.77 24.171 0.97 32.971s-23.637 8.363-32.971-0.971l-158.058-158.058c-9.334-9.334-9.771-24.171-0.971-32.971zM238.444 142.444c2.28-4.525 3.495-9.58 3.495-14.848 0-8.808-3.372-17.030-9.496-23.154l-81.691-81.691c-6.124-6.124-14.347-9.496-23.154-9.496s-17.030 3.372-23.154 9.496l-49.691 49.691c-6.124 6.124-9.496 14.347-9.496 23.154s3.372 17.030 9.496 23.154l81.691 81.691c6.124 6.124 14.347 9.497 23.154 9.497 5.268 0 10.322-1.215 14.848-3.495l32.669 32.669c-13.935 10.705-30.72 16.080-47.517 16.080-19.993 0-39.986-7.583-55.154-22.751l-81.691-81.691c-30.335-30.335-30.335-79.974 0-110.309l49.691-49.691c15.167-15.166 35.16-22.75 55.153-22.75 19.994 0 39.987 7.584 55.154 22.751l81.691 81.691c27.91 27.91 30.119 72.149 6.672 102.672l-32.67-32.67zM489.249 407.558l-49.691 49.691c-15.167 15.168-35.16 22.751-55.154 22.751-19.993 0-39.986-7.583-55.154-22.751l-81.691-81.691c-27.91-27.91-30.119-72.149-6.671-102.671l32.669 32.67c-2.279 4.525-3.494 9.58-3.494 14.847 0 8.808 3.372 17.030 9.496 23.154l81.691 81.691c6.124 6.124 14.347 9.497 23.154 9.497s17.030-3.373 23.154-9.497l49.691-49.691c6.124-6.124 9.496-14.347 9.496-23.154s-3.372-17.030-9.496-23.154l-81.691-81.691c-6.124-6.124-14.347-9.496-23.154-9.496-5.268 0-10.322 1.215-14.848 3.495l-32.669-32.669c13.936-10.705 30.72-16.080 47.517-16.080 19.994 0 39.987 7.584 55.154 22.751l81.691 81.691c30.335 30.333 30.335 79.972 0 110.307z" />
+<glyph unicode="&#xe012;" d="M238.444 142.443c2.28-4.524 3.495-9.579 3.495-14.848 0-8.808-3.372-17.029-9.496-23.154l-81.69-81.69c-6.124-6.124-14.348-9.496-23.154-9.496s-17.030 3.372-23.154 9.496l-49.69 49.69c-6.124 6.125-9.496 14.348-9.496 23.154s3.372 17.030 9.496 23.154l81.69 81.691c6.124 6.123 14.348 9.496 23.154 9.496 5.269 0 10.322-1.215 14.848-3.494l32.669 32.668c-13.935 10.705-30.72 16.080-47.517 16.080-19.993 0-39.986-7.583-55.154-22.751l-81.69-81.691c-30.335-30.335-30.335-79.975 0-110.309l49.69-49.691c15.167-15.166 35.16-22.75 55.153-22.75 19.994 0 39.987 7.584 55.154 22.751l81.69 81.69c27.91 27.91 30.119 72.149 6.672 102.673l-32.67-32.669zM489.248 407.558l-49.69 49.691c-15.167 15.168-35.16 22.751-55.154 22.751-19.993 0-39.985-7.583-55.153-22.751l-81.691-81.691c-27.91-27.91-30.119-72.149-6.671-102.671l32.669 32.67c-2.279 4.525-3.494 9.58-3.494 14.847 0 8.808 3.372 17.030 9.496 23.154l81.691 81.691c6.123 6.124 14.347 9.497 23.153 9.497 8.808 0 17.030-3.373 23.154-9.497l49.69-49.691c6.124-6.124 9.496-14.347 9.496-23.154s-3.372-17.030-9.496-23.154l-81.69-81.691c-6.124-6.124-14.347-9.496-23.154-9.496-5.268 0-10.322 1.215-14.848 3.495l-32.669-32.669c13.936-10.705 30.72-16.080 47.517-16.080 19.994 0 39.987 7.584 55.154 22.752l81.69 81.69c30.336 30.333 30.336 79.972 0 110.307zM116.684 340.688l-95.997 95.997 22.628 22.628 95.997-95.997zM192 480h32v-96h-32zM0 288h96v-32h-96zM395.316 107.312l95.998-95.998-22.628-22.628-95.998 95.998zM288 64h32v-96h-32zM416 192h96v-32h-96z" />
+<glyph unicode="&#xe013;" d="M96 480v-512l160 160 160-160v512h-320zM384 45.255l-128 128-128-128v402.745h256v-402.745z" />
+<glyph unicode="&#xe014;" d="M0 416v-416h512v416h-512zM480 32h-448v352h448v-352zM352 304c0 26.51 21.49 48 48 48s48-21.49 48-48c0-26.51-21.49-48-48-48-26.51 0-48 21.49-48 48zM448 64h-384l96 256 128-160 64 48z" />
+<glyph unicode="&#xe015;" d="M0 416v-384h512v384h-512zM96 64h-64v64h64v-64zM96 192h-64v64h64v-64zM96 320h-64v64h64v-64zM384 64h-256v320h256v-320zM480 64h-64v64h64v-64zM480 192h-64v64h64v-64zM480 320h-64v64h64v-64zM192 320v-192l128 96z" />
+<glyph unicode="&#xe016;" d="M224 128h64v-64h-64zM352 352c17.673 0 32-14.327 32-32v-96l-96-64h-64v32l96 64v32h-160v64h192zM256 432c-55.559 0-107.792-21.636-147.078-60.922s-60.922-91.519-60.922-147.078c0-55.559 21.636-107.792 60.922-147.078 39.286-39.286 91.519-60.922 147.078-60.922 55.559 0 107.792 21.636 147.078 60.922 39.286 39.286 60.922 91.519 60.922 147.078 0 55.559-21.636 107.792-60.922 147.078-39.286 39.286-91.519 60.922-147.078 60.922zM256 480v0c141.385 0 256-114.615 256-256s-114.615-256-256-256c-141.385 0-256 114.615-256 256 0 141.385 114.615 256 256 256z" />
+<glyph unicode="&#xe017;" d="M160 352l-128-128 128-128h64l-128 128 128 128zM352 352h-64l128-128-128-128h64l128 128z" />
+<glyph unicode="&#xe018;" d="M256 384c-106.038 0-192-85.961-192-192s85.961-192 192-192c106.037 0 192 85.961 192 192s-85.963 192-192 192zM357.822 90.177c-27.196-27.198-63.358-42.177-101.822-42.177s-74.625 14.979-101.823 42.177c-27.198 27.197-42.177 63.359-42.177 101.823s14.979 74.625 42.177 101.823c27.198 27.198 63.359 42.177 101.823 42.177s74.626-14.979 101.821-42.177c27.201-27.198 42.179-63.359 42.179-101.823s-14.979-74.626-42.178-101.823zM162.965 378.069l-21.47 42.939c-49.437-24.768-89.735-65.066-114.503-114.504l42.938-21.47c20.124 40.168 52.866 72.911 93.035 93.035zM442.067 285.035l42.939 21.469c-24.766 49.438-65.063 89.736-114.502 114.504l-21.472-42.939c40.169-20.124 72.912-52.866 93.035-93.034zM256 288h-32v-96c0-5.055 2.35-9.555 6.011-12.486l-0.006-0.008 80-64 19.988 24.988-73.993 59.195v88.311z" />
+<glyph unicode="&#xe019;" d="M256 320c-104.684 0-197.622-50.278-256-128 58.378-77.723 151.316-128 256-128 104.684 0 197.622 50.277 256 128-58.378 77.722-151.316 128-256 128zM224 256c17.673 0 32-14.327 32-32s-14.327-32-32-32-32 14.327-32 32 14.327 32 32 32zM386.808 127.352c-19.824-10.129-40.826-17.931-62.423-23.188-22.244-5.418-45.251-8.164-68.385-8.164-23.133 0-46.141 2.746-68.384 8.162-21.597 5.259-42.599 13.061-62.423 23.188-31.51 16.101-60.111 38.205-83.82 64.649 23.709 26.444 52.31 48.55 83.82 64.649 16.168 8.261 33.121 14.973 50.541 20.020-9.944-15.121-15.734-33.217-15.734-52.668 0-53.020 42.981-96 96-96 53.019 0 96 42.98 96 96 0 19.451-5.791 37.547-15.733 52.67 17.419-5.048 34.372-11.76 50.541-20.021 31.511-16.099 60.109-38.204 83.819-64.649-23.71-26.443-52.309-48.55-83.819-64.648zM430.459 358.139c-54.36 27.777-113.056 41.861-174.459 41.861-61.403 0-120.099-14.084-174.459-41.861-29.386-15.016-56.866-33.952-81.541-56.038v-54.603c27.669 29.283 60.347 53.877 96.097 72.145 49.81 25.452 103.609 38.357 159.903 38.357s110.093-12.905 159.902-38.358c35.751-18.268 68.429-42.862 96.098-72.145v54.603c-24.675 22.087-52.154 41.023-81.541 56.039z" />
+<glyph unicode="&#xe01a;" d="M161.009 64l28.8 96h132.382l28.8-96h56.816l-95.998 320h-111.618l-96-320h56.818zM237.809 320h36.382l28.8-96h-93.982l28.8 96z" />
+<glyph unicode="&#xe01b;" d="M0 448v-448h512v448h-512zM192 160v96h128v-96h-128zM320 128v-96h-128v96h128zM320 384v-96h-128v96h128zM160 384v-96h-128v96h128zM32 256h128v-96h-128v96zM352 256h128v-96h-128v96zM352 288v96h128v-96h-128zM32 128h128v-96h-128v96zM352 32v96h128v-96h-128z" />
+<glyph unicode="&#xe01c;" d="M0 256h512v-64h-512z" />
+<glyph unicode="&#xe01d;" d="M0 32h288v-64h-288zM96 480h352v-64h-352zM138.694 64l102.344 392.082 61.925-16.164-98.125-375.918zM464.887-32l-64.887 64.887-64.887-64.887-31.113 31.113 64.887 64.887-64.887 64.887 31.113 31.113 64.887-64.887 64.887 64.887 31.113-31.113-64.887-64.887 64.887-64.887z" />
+<glyph unicode="&#xe01e;" d="M384 25v-25h64v-32h-96v73l64 30v25h-64v32h96v-73zM338 352h-68l-94-94-94 94h-68l128-128-128-128h68l94 94 94-94h68l-128 128z" />
+<glyph unicode="&#xe01f;" d="M384 377v-25h64v-32h-96v73l64 30v25h-64v32h96v-73zM338 352h-68l-94-94-94 94h-68l128-128-128-128h68l94 94 94-94h68l-128 128z" />
+<glyph unicode="&#xe020;" d="M352 32h128l32 64v-128h-192v107.107c65.556 28.242 112 98.581 112 180.893 0 107.216-78.799 191.133-176 191.133-97.203 0-176-83.916-176-191.133 0-82.312 46.443-152.651 112-180.893v-107.107h-192v128l32-64h128v16.295c-93.815 33.23-160 113.701-160 207.705 0 123.712 114.615 224 256 224 141.385 0 256-100.288 256-224 0-94.004-66.185-174.475-160-207.705v-16.295z" />
+<glyph unicode="&#xe021;" d="M256 480c-141.385 0-256-114.614-256-256 0-141.385 114.614-256 256-256 141.385 0 256 114.615 256 256 0 141.386-114.615 256-256 256zM256 8c-119.293 0-216 96.706-216 216 0 119.293 96.707 216 216 216 119.295 0 216-96.707 216-216 0-119.294-96.705-216-216-216zM192 320c0-17.673-14.327-32-32-32s-32 14.327-32 32 14.327 32 32 32 32-14.327 32-32zM384 320c0-17.673-14.326-32-32-32s-32 14.327-32 32 14.326 32 32 32 32-14.327 32-32zM256 154c70.537 0 131.344 28.766 159.231 61.596-10.436-85.61-78.144-151.596-159.231-151.596-81.059 0-148.749 66.013-159.222 151.584 27.893-32.823 88.693-61.584 159.222-61.584z" />
+<glyph unicode="&#xe022;" d="M128 448h256v-64h-256zM480 352h-448c-17.6 0-32-14.4-32-32v-160c0-17.6 14.398-32 32-32h96v-128h256v128h96c17.6 0 32 14.4 32 32v160c0 17.6-14.4 32-32 32zM352 32h-192v160h192v-160zM487.2 304c0-12.813-10.387-23.2-23.199-23.2-12.813 0-23.201 10.387-23.201 23.2s10.388 23.2 23.201 23.2c12.813 0 23.199-10.387 23.199-23.2z" />
+<glyph unicode="&#xe023;" d="M512 480v-192l-69.13 69.13-106-106-53.74 53.74 106 106-69.13 69.13zM122.87 410.87l106-106-53.74-53.74-106 106-69.13-69.13v192h192zM442.87 90.87l69.13 69.13v-192h-192l69.13 69.13-106 106 53.74 53.74zM228.87 143.13l-106-106 69.13-69.13h-192v192l69.13-69.13 106 106z" />
+<glyph unicode="&#xe024;" d="M64 352h64v-96h32v192c0 17.6-14.4 32-32 32h-64c-17.6 0-32-14.4-32-32v-192h32v96zM64 448h64v-64h-64v64zM480 448v32h-96c-17.601 0-32-14.4-32-32v-160c0-17.6 14.399-32 32-32h96v32h-96v160h96zM320 400v48c0 17.6-14.4 32-32 32h-96v-224h96c17.6 0 32 14.4 32 32v48c0 17.6-4.4 32-22 32 17.6 0 22 14.4 22 32zM288 288h-64v64h64v-64zM288 384h-64v64h64v-64zM416 192l-208-224-112 144 41 35 71-74 176 151z" />
+<glyph unicode="&#xe025;" d="M224 192h-96v64h96v96h64v-96h96v-64h-96v-96h-64zM512 160v-192h-512v192h64v-128h384v128z" />
+<glyph unicode="&#xe026;" d="M192 384h64v-32h-64zM288 384h64v-32h-64zM448 384v-128h-96v32h64v64h-32v32zM160 288h64v-32h-64zM256 288h64v-32h-64zM96 352v-64h32v-32h-64v128h96v-32zM192 192h64v-32h-64zM288 192h64v-32h-64zM448 192v-128h-96v32h64v64h-32v32zM160 96h64v-32h-64zM256 96h64v-32h-64zM96 160v-64h32v-32h-64v128h96v-32zM480 448h-448v-448h448v448zM512 480v0-512h-512v512h512z" />
+<glyph unicode="&#xe027;" d="M0 224h64v-32h-64zM96 224h96v-32h-96zM224 224h64v-32h-64zM320 224h96v-32h-96zM448 224h64v-32h-64zM440 480l8-224h-384l8 224h16l8-192h320l8 192zM72-32l-8 192h384l-8-192h-16l-8 160h-320l-8-160z" />
+<glyph unicode="&#xe028;" d="M288 448c123.712 0 224-100.288 224-224s-100.288-224-224-224v48c47.012 0 91.209 18.307 124.451 51.549 33.242 33.242 51.549 77.439 51.549 124.451 0 47.011-18.307 91.209-51.549 124.451-33.242 33.242-77.439 51.549-124.451 51.549-47.011 0-91.209-18.307-124.451-51.549-25.57-25.569-42.291-57.623-48.653-92.451h93.104l-112-128-112 128h82.285c15.53 108.551 108.869 192 221.715 192zM384 256v-64h-128v160h64v-96z" />
+<glyph unicode="&#xe02a;" d="M353.94 237.674c18.749 22.271 30.060 51.004 30.060 82.326 0 70.58-57.421 128-128 128h-160v-448h192c70.579 0 128 57.421 128 128 0 46.478-24.899 87.248-62.060 109.674zM192 384h50.75c27.984 0 50.75-28.71 50.75-64s-22.766-64-50.75-64h-50.75v128zM271.5 64h-79.5v128h79.5c29.225 0 53-28.71 53-64s-23.775-64-53-64z" />
+<glyph unicode="&#xe02b;" d="M448 448v-32h-64l-160-384h64v-32h-224v32h64l160 384h-64v32z" />
+<glyph unicode="&#xe02c;" d="M352 448h64v-208c0-79.529-71.634-144-160-144-88.365 0-160 64.471-160 144v208h64v-208c0-20.083 9.119-39.352 25.677-54.253 18.448-16.602 43.423-25.747 70.323-25.747 26.9 0 51.875 9.145 70.323 25.747 16.558 14.901 25.677 34.17 25.677 54.253v208zM96 64h320v-64h-320z" />
+<glyph unicode="&#xe02d;" d="M365.71 221.482c31.96-23.969 50.29-58.043 50.29-93.482s-18.33-69.513-50.29-93.482c-29.679-22.259-68.642-34.518-109.71-34.518-41.069 0-80.031 12.259-109.71 34.518-31.96 23.969-50.29 58.043-50.29 93.482h64c0-34.691 43.963-64 96-64s96 29.309 96 64c0 34.691-43.963 64-96 64-41.069 0-80.031 12.259-109.71 34.518-31.96 23.97-50.29 58.043-50.29 93.482 0 35.439 18.33 69.512 50.29 93.482 29.679 22.259 68.641 34.518 109.71 34.518 41.068 0 80.031-12.259 109.71-34.518 31.96-23.97 50.29-58.043 50.29-93.482h-64c0 34.691-43.963 64-96 64-52.037 0-96-29.309-96-64 0-34.691 43.963-64 96-64 41.068 0 80.031-12.259 109.71-34.518zM0 224h512v-32h-512z" />
+<glyph unicode="&#xe02e;" d="M192 448h256v-64h-64v-384h-64v384h-64v-384h-64v224c-61.856 0-112 50.144-112 112s50.144 112 112 112z" />
+<glyph unicode="&#xe02f;" d="M224 448h256v-64h-64v-384h-64v384h-64v-384h-64v224c-61.856 0-112 50.144-112 112s50.144 112 112 112zM32 256l128-112-128-112z" />
+<glyph unicode="&#xe030;" d="M128 448h256v-64h-64v-384h-64v384h-64v-384h-64v224c-61.856 0-112 50.144-112 112s50.144 112 112 112zM480 32l-128 112 128 112z" />
+<glyph unicode="&#xe031;" d="M416 352h-96v32l-96 96h-224v-384h192v-128h320v288l-96 96zM416 306.745l50.745-50.745h-50.745v50.745zM224 434.745l50.745-50.745h-50.745v50.745zM32 448h160v-96h96v-224h-256v320zM480 0h-256v96h96v224h64v-96h96v-224z" />
+<glyph unicode="&#xe032;" d="M384 352h32v-32h-32zM320 288h32v-32h-32zM320 224h32v-32h-32zM320 160h32v-32h-32zM256 224h32v-32h-32zM256 160h32v-32h-32zM192 160h32v-32h-32zM384 288h32v-32h-32zM384 224h32v-32h-32zM384 160h32v-32h-32zM384 96h32v-32h-32zM320 96h32v-32h-32zM256 96h32v-32h-32zM192 96h32v-32h-32zM128 96h32v-32h-32z" />
+<glyph unicode="&#xe033;" d="M64 208l144-144 240 240-64 64-176-176-80 80z" />
+<glyph unicode="&#xe034;" d="M464 416h-208l-16 32h-176l-32-64h448zM452.17 128h37.43l22.4 224h-512l32-320h242.040c-52.441 18.888-90.040 69.133-90.040 128 0 74.991 61.009 136 136 136 74.99 0 136-61.009 136-136 0-10.839-1.311-21.575-3.83-32zM501.498 23.125l-99.248 87.346c8.727 14.46 13.75 31.407 13.75 49.529 0 53.020-42.98 96-96 96s-96-42.98-96-96 42.98-96 96-96c18.122 0 35.069 5.023 49.529 13.75l87.346-99.248c11.481-13.339 31.059-14.070 43.503-1.626l2.746 2.746c12.444 12.444 11.713 32.022-1.626 43.503zM320 98c-34.242 0-62 27.758-62 62s27.758 62 62 62 62-27.758 62-62-27.758-62-62-62z" />
+<glyph unicode="&#xe035;" d="M256 224v-64h16l16 32h32v-128h-24v-32h112v32h-24v128h32l16-32h16v64zM416 320v80c0 8.8-7.2 16-16 16h-112v32c0 17.6-14.4 32-32 32h-64c-17.602 0-32-14.4-32-32v-32h-112c-8.801 0-16-7.2-16-16v-320c0-8.8 7.199-16 16-16h144v-96h320v352h-96zM192 447.943c0.017 0.019 0.036 0.039 0.057 0.057h63.884c0.021-0.018 0.041-0.038 0.059-0.057v-31.943h-64v31.943zM96 352v32h256v-32h-256zM480 0h-256v288h256v-288z" />
+</font></defs></svg>
\ No newline at end of file
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce.ttf b/lib/test/data/js/skins/lightgray/fonts/tinymce.ttf
new file mode 100644
index 0000000..58103c2
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/fonts/tinymce.ttf differ
diff --git a/lib/test/data/js/skins/lightgray/fonts/tinymce.woff b/lib/test/data/js/skins/lightgray/fonts/tinymce.woff
new file mode 100644
index 0000000..ad1ae39
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/fonts/tinymce.woff differ
diff --git a/lib/test/data/js/skins/lightgray/img/anchor.gif b/lib/test/data/js/skins/lightgray/img/anchor.gif
new file mode 100644
index 0000000..606348c
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/img/anchor.gif differ
diff --git a/lib/test/data/js/skins/lightgray/img/loader.gif b/lib/test/data/js/skins/lightgray/img/loader.gif
new file mode 100644
index 0000000..c69e937
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/img/loader.gif differ
diff --git a/lib/test/data/js/skins/lightgray/img/object.gif b/lib/test/data/js/skins/lightgray/img/object.gif
new file mode 100644
index 0000000..cccd7f0
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/img/object.gif differ
diff --git a/lib/test/data/js/skins/lightgray/img/trans.gif b/lib/test/data/js/skins/lightgray/img/trans.gif
new file mode 100644
index 0000000..3884865
Binary files /dev/null and b/lib/test/data/js/skins/lightgray/img/trans.gif differ
diff --git a/lib/test/data/js/skins/lightgray/skin.ie7.min.css b/lib/test/data/js/skins/lightgray/skin.ie7.min.css
new file mode 100644
index 0000000..cd2bbdf
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/skin.ie7.min.css
@@ -0,0 +1 @@
+.mce-container,.mce-container *,.mce-widget,.mce-widget *,.mce-reset{margin:0;padding:0;border:0;outline:0;vertical-align:top;background:transparent;text-decoration:none;color:#333;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:14px;text-shadow:none;float:none;position:static;width:auto;height:auto;white-space:nowrap;cursor:inherit;-webkit-tap-highlight-color:transparent;line-height:normal;font-weight:normal;text-align:left;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box;direction:ltr}.mce-widget button{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}.mce-container *[unselectable]{-moz-user-select:none;-webkit-user-select:none;-o-user-select:none;user-select:none}.mce-fade{opacity:0;-webkit-transition:opacity .15s linear;transition:opacity .15s linear}.mce-fade.mce-in{opacity:1}.mce-tinymce{visibility:visible !important;position:relative}.mce-fullscreen{border:0;padding:0;margin:0;overflow:hidden;height:100%;z-index:100}div.mce-fullscreen{position:fixed;top:0;left:0;width:100%;height:auto}.mce-tinymce{display:block;-webkit-border-radius:2px;-moz-border-radius:2px;border-radius:2px}.mce-wordcount{position:absolute;top:0;right:0;padding:8px}div.mce-edit-area{background:#FFF;filter:none}.mce-statusbar{position:relative}.mce-statusbar .mce-container-body{position:relative}.mce-fullscreen .mce-resizehandle{display:none}.mce-charmap{border-collapse:collapse}.mce-charmap td{cursor:default;border:1px solid #9e9e9e;width:20px;height:20px;line-height:20px;text-align:center;vertical-align:middle;padding:2px}.mce-charmap td div{text-align:center}.mce-charmap td:hover{background:#d9d9d9}.mce-grid td div{border:1px solid #d6d6d6;width:12px;height:12px;margin:2px;cursor:pointer}.mce-grid td div:focus{border-color:#a1a1a1}.mce-grid{border-spacing:2px;border-collapse:separate}.mce-grid a{display:block;border:1px solid transparent}.mce-grid a:hover,.mce-grid a:focus{border-color:#a1a1a1}.mce-grid-border{margin:0 4px 0 4px}.mce-grid-border a{border-color:#d6d6d6;width:13px;height:13px}.mce-grid-border a:hover,.mce-grid-border a.mce-active{border-color:#a1a1a1;background:#c8def4}.mce-text-center{text-align:center}div.mce-tinymce-inline{width:100%;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}.mce-toolbar-grp{padding-bottom:2px}.mce-toolbar-grp .mce-flow-layout-item{margin-bottom:0}.mce-rtl .mce-wordcount{left:0;right:auto}.mce-container,.mce-container-body{display:block}.mce-autoscroll{overflow:hidden}.mce-scrollbar{position:absolute;width:7px;height:100%;top:2px;right:2px;opacity:.4;filter:alpha(opacity=40);zoom:1}.mce-scrollbar-h{top:auto;right:auto;left:2px;bottom:2px;width:100%;height:7px}.mce-scrollbar-thumb{position:absolute;background-color:#000;border:1px solid #888;border-color:rgba(85,85,85,0.6);width:5px;height:100%;-webkit-border-radius:7px;-moz-border-radius:7px;border-radius:7px}.mce-scrollbar-h .mce-scrollbar-thumb{width:100%;height:5px}.mce-scrollbar:hover,.mce-scrollbar.mce-active{background-color:#AAA;opacity:.6;filter:alpha(opacity=60);zoom:1;-webkit-border-radius:7px;-moz-border-radius:7px;border-radius:7px}.mce-scroll{position:relative}.mce-panel{border:0 solid #9e9e9e;background-color:#f0f0f0;background-image:-moz-linear-gradient(top, #fdfdfd, #ddd);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#fdfdfd), to(#ddd));background-image:-webkit-linear-gradient(top, #fdfdfd, #ddd);background-image:-o-linear-gradient(top, #fdfdfd, #ddd);background-image:linear-gradient(to bottom, #fdfdfd, #ddd);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fffdfdfd', endColorstr='#ffdddddd', GradientType=0);zoom:1}.mce-floatpanel{position:absolute;-webkit-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);-moz-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);box-shadow:0 5px 10px rgba(0, 0, 0, 0.2)}.mce-floatpanel.mce-fixed{position:fixed}.mce-floatpanel .mce-arrow,.mce-floatpanel .mce-arrow:after{position:absolute;display:block;width:0;height:0;border-color:transparent;border-style:solid}.mce-floatpanel .mce-arrow{border-width:11px}.mce-floatpanel .mce-arrow:after{border-width:10px;content:""}.mce-floatpanel.mce-popover{filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);background:transparent;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);-moz-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);top:0;left:0;background:#fff;border:1px solid #9e9e9e;border:1px solid rgba(0,0,0,0.25)}.mce-floatpanel.mce-popover.mce-bottom{margin-top:10px;*margin-top:0}.mce-floatpanel.mce-popover.mce-bottom>.mce-arrow{left:50%;margin-left:-11px;border-top-width:0;border-bottom-color:#9e9e9e;border-bottom-color:rgba(0,0,0,0.25);top:-11px}.mce-floatpanel.mce-popover.mce-bottom>.mce-arrow:after{top:1px;margin-left:-10px;border-top-width:0;border-bottom-color:#fff}.mce-floatpanel.mce-popover.mce-bottom.mce-start{margin-left:-22px}.mce-floatpanel.mce-popover.mce-bottom.mce-start>.mce-arrow{left:20px}.mce-floatpanel.mce-popover.mce-bottom.mce-end{margin-left:22px}.mce-floatpanel.mce-popover.mce-bottom.mce-end>.mce-arrow{right:10px;left:auto}.mce-fullscreen{border:0;padding:0;margin:0;overflow:hidden;background:#fff;height:100%}div.mce-fullscreen{position:fixed;top:0;left:0}#mce-modal-block{opacity:0;filter:alpha(opacity=0);zoom:1;position:fixed;left:0;top:0;width:100%;height:100%;background:#000}#mce-modal-block.mce-in{opacity:.3;filter:alpha(opacity=30);zoom:1}.mce-window-move{cursor:move}.mce-window{-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);-moz-box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);background:transparent;background:#fff;position:fixed;top:0;left:0;opacity:0;-webkit-transition:opacity 150ms ease-in;transition:opacity 150ms ease-in}.mce-window.mce-in{opacity:1}.mce-window-head{padding:9px 15px;border-bottom:1px solid #c5c5c5;position:relative}.mce-window-head .mce-close{position:absolute;right:15px;top:9px;font-size:20px;font-weight:bold;line-height:20px;color:#858585;cursor:pointer;height:20px;overflow:hidden}.mce-close:hover{color:#adadad}.mce-window-head .mce-title{line-height:20px;font-size:20px;font-weight:bold;text-rendering:optimizelegibility;padding-right:10px}.mce-window .mce-container-body{display:block}.mce-foot{display:block;background-color:#fff;border-top:1px solid #c5c5c5;-webkit-border-radius:0 0 6px 6px;-moz-border-radius:0 0 6px 6px;border-radius:0 0 6px 6px}.mce-window-head .mce-dragh{position:absolute;top:0;left:0;cursor:move;width:90%;height:100%}.mce-window iframe{width:100%;height:100%}.mce-window.mce-fullscreen,.mce-window.mce-fullscreen .mce-foot{-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.mce-rtl .mce-window-head .mce-close{position:absolute;right:auto;left:15px}.mce-rtl .mce-window-head .mce-dragh{left:auto;right:0}.mce-rtl .mce-window-head .mce-title{direction:rtl;text-align:right}.mce-abs-layout{position:relative}body .mce-abs-layout-item,.mce-abs-end{position:absolute}.mce-abs-end{width:1px;height:1px}.mce-container-body.mce-abs-layout{overflow:hidden}.mce-tooltip{position:absolute;padding:5px;opacity:.8;filter:alpha(opacity=80);zoom:1}.mce-tooltip-inner{font-size:11px;background-color:#000;color:#fff;max-width:200px;padding:5px 8px 4px 8px;text-align:center;white-space:normal}.mce-tooltip-inner{-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.mce-tooltip-inner{-webkit-box-shadow:0 0 5px #000000;-moz-box-shadow:0 0 5px #000000;box-shadow:0 0 5px #000000}.mce-tooltip-arrow{position:absolute;width:0;height:0;line-height:0;border:5px dashed #000}.mce-tooltip-arrow-n{border-bottom-color:#000}.mce-tooltip-arrow-s{border-top-color:#000}.mce-tooltip-arrow-e{border-left-color:#000}.mce-tooltip-arrow-w{border-right-color:#000}.mce-tooltip-nw,.mce-tooltip-sw{margin-left:-14px}.mce-tooltip-n .mce-tooltip-arrow{top:0px;left:50%;margin-left:-5px;border-bottom-style:solid;border-top:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-nw .mce-tooltip-arrow{top:0;left:10px;border-bottom-style:solid;border-top:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-ne .mce-tooltip-arrow{top:0;right:10px;border-bottom-style:solid;border-top:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-s .mce-tooltip-arrow{bottom:0;left:50%;margin-left:-5px;border-top-style:solid;border-bottom:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-sw .mce-tooltip-arrow{bottom:0;left:10px;border-top-style:solid;border-bottom:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-se .mce-tooltip-arrow{bottom:0;right:10px;border-top-style:solid;border-bottom:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-e .mce-tooltip-arrow{right:0;top:50%;margin-top:-5px;border-left-style:solid;border-right:none;border-top-color:transparent;border-bottom-color:transparent}.mce-tooltip-w .mce-tooltip-arrow{left:0;top:50%;margin-top:-5px;border-right-style:solid;border-left:none;border-top-color:transparent;border-bottom-color:transparent}.mce-btn{border:1px solid #b1b1b1;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25) rgba(0,0,0,0.25);position:relative;text-shadow:0 1px 1px rgba(255,255,255,0.75);display:inline-block;*display:inline;*zoom:1;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);background-color:#f0f0f0;background-image:-moz-linear-gradient(top, #fff, #d9d9d9);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#fff), to(#d9d9d9));background-image:-webkit-linear-gradient(top, #fff, #d9d9d9);background-image:-o-linear-gradient(top, #fff, #d9d9d9);background-image:linear-gradient(to bottom, #fff, #d9d9d9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff', endColorstr='#ffd9d9d9', GradientType=0);zoom:1}.mce-btn:hover,.mce-btn:focus{color:#333;background-color:#e3e3e3;background-image:-moz-linear-gradient(top, #f2f2f2, #ccc);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#f2f2f2), to(#ccc));background-image:-webkit-linear-gradient(top, #f2f2f2, #ccc);background-image:-o-linear-gradient(top, #f2f2f2, #ccc);background-image:linear-gradient(to bottom, #f2f2f2, #ccc);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fff2f2f2', endColorstr='#ffcccccc', GradientType=0);zoom:1}.mce-btn.mce-disabled button,.mce-btn.mce-disabled:hover button{cursor:default;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;opacity:.4;filter:alpha(opacity=40);zoom:1}.mce-btn.mce-active,.mce-btn.mce-active:hover{background-color:#d6d6d6;background-image:-moz-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#e6e6e6), to(#c0c0c0));background-image:-webkit-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:-o-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:linear-gradient(to bottom, #e6e6e6, #c0c0c0);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffe6e6e6', endColorstr='#ffc0c0c0', GradientType=0);zoom:1;-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05)}.mce-btn:not(.mce-disabled):active{background-color:#d6d6d6;background-image:-moz-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#e6e6e6), to(#c0c0c0));background-image:-webkit-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:-o-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:linear-gradient(to bottom, #e6e6e6, #c0c0c0);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffe6e6e6', endColorstr='#ffc0c0c0', GradientType=0);zoom:1;-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05)}.mce-btn button{padding:4px 10px;font-size:14px;line-height:20px;*line-height:16px;cursor:pointer;color:#333;text-align:center;overflow:visible;-webkit-appearance:none}.mce-btn button::-moz-focus-inner{border:0;padding:0}.mce-btn i{text-shadow:1px 1px #fff}.mce-primary{min-width:50px;color:#fff;border:1px solid #b1b1b1;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25) rgba(0,0,0,0.25);background-color:#006dcc;background-image:-moz-linear-gradient(top, #08c, #04c);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#08c), to(#04c));background-image:-webkit-linear-gradient(top, #08c, #04c);background-image:-o-linear-gradient(top, #08c, #04c);background-image:linear-gradient(to bottom, #08c, #04c);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc', endColorstr='#ff0044cc', GradientType=0);zoom:1}.mce-primary:hover,.mce-primary:focus{background-color:#005fb3;background-image:-moz-linear-gradient(top, #0077b3, #003cb3);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#0077b3), to(#003cb3));background-image:-webkit-linear-gradient(top, #0077b3, #003cb3);background-image:-o-linear-gradient(top, #0077b3, #003cb3);background-image:linear-gradient(to bottom, #0077b3, #003cb3);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0077b3', endColorstr='#ff003cb3', GradientType=0);zoom:1}.mce-primary.mce-disabled button,.mce-primary.mce-disabled:hover button{cursor:default;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;opacity:.4;filter:alpha(opacity=40);zoom:1}.mce-primary.mce-active,.mce-primary.mce-active:hover,.mce-primary:not(.mce-disabled):active{background-color:#005299;background-image:-moz-linear-gradient(top, #069, #039);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#069), to(#039));background-image:-webkit-linear-gradient(top, #069, #039);background-image:-o-linear-gradient(top, #069, #039);background-image:linear-gradient(to bottom, #069, #039);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff006699', endColorstr='#ff003399', GradientType=0);zoom:1;-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05)}.mce-primary button,.mce-primary button i{color:#fff;text-shadow:1px 1px #333}.mce-btn-large button{padding:9px 14px;font-size:16px;line-height:normal;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px}.mce-btn-large i{margin-top:2px}.mce-btn-small button{padding:1px 5px;font-size:12px;*padding-bottom:2px}.mce-btn-small i{line-height:20px;vertical-align:top;*line-height:18px}.mce-btn .mce-caret{margin-top:8px;margin-left:0}.mce-btn-small .mce-caret{margin-top:8px;margin-left:0}.mce-caret{display:inline-block;*display:inline;*zoom:1;width:0;height:0;vertical-align:top;border-top:4px solid #333;border-right:4px solid transparent;border-left:4px solid transparent;content:""}.mce-disabled .mce-caret{border-top-color:#aaa}.mce-caret.mce-up{border-bottom:4px solid #333;border-top:0}.mce-rtl .mce-btn button{direction:rtl}.mce-btn-group .mce-btn{border-width:1px 0 1px 0;margin:0;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.mce-btn-group .mce-first{border-left:1px solid #b1b1b1;border-left:1px solid rgba(0,0,0,0.25);-webkit-border-radius:3px 0 0 3px;-moz-border-radius:3px 0 0 3px;border-radius:3px 0 0 3px}.mce-btn-group .mce-last{border-right:1px solid #b1b1b1;border-right:1px solid rgba(0,0,0,0.1);-webkit-border-radius:0 3px 3px 0;-moz-border-radius:0 3px 3px 0;border-radius:0 3px 3px 0}.mce-btn-group .mce-first.mce-last{-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.mce-btn-group .mce-btn.mce-flow-layout-item{margin:0}.mce-checkbox{cursor:pointer}i.mce-i-checkbox{margin:0 3px 0 0;border:1px solid #c5c5c5;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);background-color:#f0f0f0;background-image:-moz-linear-gradient(top, #fff, #d9d9d9);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#fff), to(#d9d9d9));background-image:-webkit-linear-gradient(top, #fff, #d9d9d9);background-image:-o-linear-gradient(top, #fff, #d9d9d9);background-image:linear-gradient(to bottom, #fff, #d9d9d9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff', endColorstr='#ffd9d9d9', GradientType=0);zoom:1;text-indent:-10em;*font-size:0;*line-height:0;*text-indent:0;overflow:hidden}.mce-checked i.mce-i-checkbox{color:#333;font-size:16px;line-height:16px;text-indent:0}.mce-checkbox:focus i.mce-i-checkbox,.mce-checkbox.mce-focus i.mce-i-checkbox{border:1px solid rgba(82,168,236,0.8);-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65)}.mce-checkbox.mce-disabled .mce-label,.mce-checkbox.mce-disabled i.mce-i-checkbox{color:#acacac}.mce-rtl .mce-checkbox{direction:rtl;text-align:right}.mce-rtl i.mce-i-checkbox{margin:0 0 0 3px}.mce-colorbutton .mce-ico{position:relative}.mce-colorbutton-grid{margin:4px}.mce-colorbutton button{padding-right:4px}.mce-colorbutton .mce-preview{padding-right:3px;display:block;position:absolute;left:50%;top:50%;margin-left:-14px;margin-top:7px;background:gray;width:13px;height:2px;overflow:hidden}.mce-colorbutton.mce-btn-small .mce-preview{margin-left:-16px;padding-right:0;width:16px}.mce-colorbutton .mce-open{padding-left:4px;border-left:1px solid transparent;border-right:1px solid transparent}.mce-colorbutton:hover .mce-open{border-left-color:#bdbdbd;border-right-color:#bdbdbd}.mce-colorbutton.mce-btn-small .mce-open{padding:0 3px 0 3px}.mce-rtl .mce-colorbutton{direction:rtl}.mce-rtl .mce-colorbutton .mce-preview{margin-left:0;padding-right:0;padding-left:4px;margin-right:-14px}.mce-rtl .mce-colorbutton.mce-btn-small .mce-preview{margin-left:0;padding-right:0;margin-right:-17px;padding-left:0}.mce-rtl .mce-colorbutton button{padding-right:10px;padding-left:10px}.mce-rtl .mce-colorbutton .mce-open{padding-left:4px;padding-right:4px}.mce-combobox{display:inline-block;*display:inline;*zoom:1;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);*height:32px}.mce-combobox input{border:1px solid #c5c5c5;border-right-color:#c5c5c5;height:28px}.mce-combobox.mce-disabled input{color:#adadad}.mce-combobox.mce-has-open input{-webkit-border-radius:4px 0 0 4px;-moz-border-radius:4px 0 0 4px;border-radius:4px 0 0 4px}.mce-combobox .mce-btn{border-left:0;-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.mce-combobox button{padding-right:8px;padding-left:8px}.mce-combobox.mce-disabled .mce-btn button{cursor:default;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;opacity:.4;filter:alpha(opacity=40);zoom:1}.mce-path{display:inline-block;*display:inline;*zoom:1;padding:8px;white-space:normal}.mce-path .mce-txt{display:inline-block;padding-right:3px}.mce-path .mce-path-body{display:inline-block}.mce-path-item{display:inline-block;*display:inline;*zoom:1;cursor:pointer;color:#333}.mce-path-item:hover{text-decoration:underline}.mce-path-item:focus{background:#666;color:#fff}.mce-path .mce-divider{display:inline}.mce-disabled .mce-path-item{color:#aaa}.mce-rtl .mce-path{direction:rtl}.mce-fieldset{border:0 solid #9E9E9E;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.mce-fieldset>.mce-container-body{margin-top:-15px}.mce-fieldset-title{margin-left:5px;padding:0 5px 0 5px}.mce-fit-layout{display:inline-block;*display:inline;*zoom:1}.mce-fit-layout-item{position:absolute}.mce-flow-layout-item{display:inline-block;*display:inline;*zoom:1}.mce-flow-layout-item{margin:2px 0 2px 2px}.mce-flow-layout-item.mce-last{margin-right:2px}.mce-flow-layout{white-space:normal}.mce-tinymce-inline .mce-flow-layout{white-space:nowrap}.mce-rtl .mce-flow-layout{text-align:right;direction:rtl}.mce-rtl .mce-flow-layout-item{margin:2px 2px 2px 0}.mce-rtl .mce-flow-layout-item.mce-last{margin-left:2px}.mce-iframe{border:0 solid #9e9e9e;width:100%;height:100%}.mce-label{display:inline-block;*display:inline;*zoom:1;text-shadow:0 1px 1px rgba(255,255,255,0.75);overflow:hidden}.mce-label.mce-autoscroll{overflow:auto}.mce-label.mce-disabled{color:#aaa}.mce-label.mce-multiline{white-space:pre-wrap}.mce-label.mce-error{color:#a00}.mce-rtl .mce-label{text-align:right;direction:rtl}.mce-menubar .mce-menubtn{border-color:transparent;background:transparent;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;filter:none}.mce-menubar{border:1px solid #c4c4c4}.mce-menubar .mce-menubtn button span{color:#333}.mce-menubar .mce-caret{border-top-color:#333}.mce-menubar .mce-menubtn:hover,.mce-menubar .mce-menubtn.mce-active,.mce-menubar .mce-menubtn:focus{border-color:transparent;background:#e6e6e6;filter:none;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}.mce-menubtn span{color:#333;margin-right:2px;line-height:20px;*line-height:16px}.mce-menubtn.mce-btn-small span{font-size:12px}.mce-menubtn.mce-fixed-width span{display:inline-block;overflow-x:hidden;text-overflow:ellipsis;width:90px}.mce-menubtn.mce-fixed-width.mce-btn-small span{width:70px}.mce-menubtn .mce-caret{*margin-top:6px}.mce-rtl .mce-menubtn button{direction:rtl;text-align:right}.mce-listbox button{text-align:left;padding-right:20px;position:relative}.mce-listbox .mce-caret{position:absolute;margin-top:-2px;right:8px;top:50%}.mce-rtl .mce-listbox .mce-caret{right:auto;left:8px}.mce-rtl .mce-listbox button{padding-right:10px;padding-left:20px}.mce-menu-item{display:block;padding:6px 15px 6px 12px;clear:both;font-weight:normal;line-height:20px;color:#333;white-space:nowrap;cursor:pointer;line-height:normal;border-left:4px solid transparent;margin-bottom:1px}.mce-menu-item .mce-ico,.mce-menu-item .mce-text{color:#333}.mce-menu-item.mce-disabled .mce-text,.mce-menu-item.mce-disabled .mce-ico{color:#adadad}.mce-menu-item:hover .mce-text,.mce-menu-item.mce-selected .mce-text,.mce-menu-item:focus .mce-text{color:#fff}.mce-menu-item:hover .mce-ico,.mce-menu-item.mce-selected .mce-ico,.mce-menu-item:focus .mce-ico{color:#fff}.mce-menu-item.mce-disabled:hover{background:#ccc}.mce-menu-shortcut{display:inline-block;color:#adadad}.mce-menu-shortcut{display:inline-block;*display:inline;*zoom:1;padding:0 15px 0 20px}.mce-menu-item:hover .mce-menu-shortcut,.mce-menu-item.mce-selected .mce-menu-shortcut,.mce-menu-item:focus .mce-menu-shortcut{color:#fff}.mce-menu-item .mce-caret{margin-top:4px;*margin-top:3px;margin-right:6px;border-top:4px solid transparent;border-bottom:4px solid transparent;border-left:4px solid #333}.mce-menu-item.mce-selected .mce-caret,.mce-menu-item:focus .mce-caret,.mce-menu-item:hover .mce-caret{border-left-color:#fff}.mce-menu-align .mce-menu-shortcut{*margin-top:-2px}.mce-menu-align .mce-menu-shortcut,.mce-menu-align .mce-caret{position:absolute;right:0}.mce-menu-item.mce-active i{visibility:visible}.mce-menu-item-normal.mce-active{background-color:#c8def4}.mce-menu-item-preview.mce-active{border-left:5px solid #aaa}.mce-menu-item-normal.mce-active .mce-text{color:#333}.mce-menu-item-normal.mce-active:hover .mce-text,.mce-menu-item-normal.mce-active:hover .mce-ico{color:#fff}.mce-menu-item-normal.mce-active:focus .mce-text,.mce-menu-item-normal.mce-active:focus .mce-ico{color:#fff}.mce-menu-item:hover,.mce-menu-item.mce-selected,.mce-menu-item:focus{text-decoration:none;color:#fff;background-color:#0081c2;background-image:-moz-linear-gradient(top, #08c, #0077b3);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#08c), to(#0077b3));background-image:-webkit-linear-gradient(top, #08c, #0077b3);background-image:-o-linear-gradient(top, #08c, #0077b3);background-image:linear-gradient(to bottom, #08c, #0077b3);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc', endColorstr='#ff0077b3', GradientType=0);zoom:1}div.mce-menu .mce-menu-item-sep,.mce-menu-item-sep:hover{border:0;padding:0;height:1px;margin:9px 1px;overflow:hidden;background:#cbcbcb;border-bottom:1px solid #fff;cursor:default;filter:none}.mce-menu.mce-rtl{direction:rtl}.mce-rtl .mce-menu-item{text-align:right;direction:rtl;padding:6px 12px 6px 15px}.mce-menu-align.mce-rtl .mce-menu-shortcut,.mce-menu-align.mce-rtl .mce-caret{right:auto;left:0}.mce-rtl .mce-menu-item .mce-caret{margin-left:6px;margin-right:0;border-right:4px solid #333;border-left:0}.mce-rtl .mce-menu-item.mce-selected .mce-caret,.mce-rtl .mce-menu-item:focus .mce-caret,.mce-rtl .mce-menu-item:hover .mce-caret{border-left-color:transparent;border-right-color:#fff}.mce-menu{position:absolute;left:0;top:0;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);background:transparent;z-index:1000;padding:5px 0 5px 0;margin:2px 0 0;min-width:160px;background:#fff;border:1px solid #989898;border:1px solid rgba(0,0,0,0.2);z-index:1002;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);-moz-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);max-height:400px;overflow:auto;overflow-x:hidden}.mce-menu i{display:none}.mce-menu-has-icons i{display:inline-block;*display:inline}.mce-menu-sub-tr-tl{margin:-6px 0 0 -1px}.mce-menu-sub-br-bl{margin:6px 0 0 -1px}.mce-menu-sub-tl-tr{margin:-6px 0 0 1px}.mce-menu-sub-bl-br{margin:6px 0 0 1px}.mce-container-body .mce-resizehandle{position:absolute;right:0;bottom:0;width:16px;height:16px;visibility:visible;cursor:s-resize;margin:0}.mce-container-body .mce-resizehandle-both{cursor:se-resize}i.mce-i-resize{color:#333}.mce-spacer{visibility:hidden}.mce-splitbtn .mce-open{border-left:1px solid transparent;border-right:1px solid transparent}.mce-splitbtn:hover .mce-open{border-left-color:#bdbdbd;border-right-color:#bdbdbd}.mce-splitbtn button{padding-right:4px}.mce-splitbtn .mce-open{padding-left:4px}.mce-splitbtn .mce-open.mce-active{-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05)}.mce-splitbtn.mce-btn-small .mce-open{padding:0 3px 0 3px}.mce-rtl .mce-splitbtn{direction:rtl;text-align:right}.mce-rtl .mce-splitbtn button{padding-right:10px;padding-left:10px}.mce-rtl .mce-splitbtn .mce-open{padding-left:4px;padding-right:4px}.mce-stack-layout-item{display:block}.mce-tabs{display:block;border-bottom:1px solid #c5c5c5}.mce-tab{display:inline-block;*display:inline;*zoom:1;border:1px solid #c5c5c5;border-width:0 1px 0 0;background:#e3e3e3;padding:8px;text-shadow:0 1px 1px rgba(255,255,255,0.75);height:13px;cursor:pointer}.mce-tab:hover{background:#fdfdfd}.mce-tab.mce-active{background:#fdfdfd;border-bottom-color:transparent;margin-bottom:-1px;height:14px}.mce-rtl .mce-tabs{text-align:right;direction:rtl}.mce-rtl .mce-tab{border-width:0 0 0 1px}.mce-textbox{background:#fff;border:1px solid #c5c5c5;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);display:inline-block;-webkit-transition:border linear .2s, box-shadow linear .2s;transition:border linear .2s, box-shadow linear .2s;height:28px;resize:none;padding:0 4px 0 4px;white-space:pre-wrap;*white-space:pre;color:#333}.mce-textbox:focus,.mce-textbox.mce-focus{border-color:rgba(82,168,236,0.8);-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65)}.mce-placeholder .mce-textbox{color:#aaa}.mce-textbox.mce-multiline{padding:4px}.mce-textbox.mce-disabled{color:#adadad}.mce-rtl .mce-textbox{text-align:right;direction:rtl}.mce-throbber{position:absolute;top:0;left:0;width:100%;height:100%;opacity:.6;filter:alpha(opacity=60);zoom:1;background:#fff url('img/loader.gif') no-repeat center center}.mce-throbber-inline{position:static;height:50px}@font-face{font-family:'tinymce';src:url('fonts/tinymce.eot');src:url('fonts/tinymce.eot?#iefix') format('embedded-opentype'),url('fonts/tinymce.woff') format('woff'),url('fonts/tinymce.ttf') format('truetype'),url('fonts/tinymce.svg#tinymce') format('svg');font-weight:normal;font-style:normal}@font-face{font-family:'tinymce-small';src:url('fonts/tinymce-small.eot');src:url('fonts/tinymce-small.eot?#iefix') format('embedded-opentype'),url('fonts/tinymce-small.woff') format('woff'),url('fonts/tinymce-small.ttf') format('truetype'),url('fonts/tinymce-small.svg#tinymce') format('svg');font-weight:normal;font-style:normal}.mce-ico{font-family:'tinymce';font-style:normal;font-weight:normal;font-size:16px;line-height:16px;vertical-align:text-top;-webkit-font-smoothing:antialiased;display:inline-block;background:transparent center center;width:16px;height:16px;color:#333;-ie7-icon:' '}.mce-btn-small .mce-ico{font-family:'tinymce-small'}.mce-ico,i.mce-i-checkbox{zoom:expression(this.runtimeStyle['zoom'] = '1', this.innerHTML = this.currentStyle['-ie7-icon'].substr(1, 1) + '&nbsp;')}.mce-i-save{-ie7-icon:"\e000"}.mce-i-newdocument{-ie7-icon:"\e001"}.mce-i-fullpage{-ie7-icon:"\e002"}.mce-i-alignleft{-ie7-icon:"\e003"}.mce-i-aligncenter{-ie7-icon:"\e004"}.mce-i-alignright{-ie7-icon:"\e005"}.mce-i-alignjustify{-ie7-icon:"\e006"}.mce-i-cut{-ie7-icon:"\e007"}.mce-i-paste{-ie7-icon:"\e008"}.mce-i-searchreplace{-ie7-icon:"\e009"}.mce-i-bullist{-ie7-icon:"\e00a"}.mce-i-numlist{-ie7-icon:"\e00b"}.mce-i-indent{-ie7-icon:"\e00c"}.mce-i-outdent{-ie7-icon:"\e00d"}.mce-i-blockquote{-ie7-icon:"\e00e"}.mce-i-undo{-ie7-icon:"\e00f"}.mce-i-redo{-ie7-icon:"\e010"}.mce-i-link{-ie7-icon:"\e011"}.mce-i-unlink{-ie7-icon:"\e012"}.mce-i-anchor{-ie7-icon:"\e013"}.mce-i-image{-ie7-icon:"\e014"}.mce-i-media{-ie7-icon:"\e015"}.mce-i-help{-ie7-icon:"\e016"}.mce-i-code{-ie7-icon:"\e017"}.mce-i-insertdatetime{-ie7-icon:"\e018"}.mce-i-preview{-ie7-icon:"\e019"}.mce-i-forecolor{-ie7-icon:"\e01a"}.mce-i-backcolor{-ie7-icon:"\e01a"}.mce-i-table{-ie7-icon:"\e01b"}.mce-i-hr{-ie7-icon:"\e01c"}.mce-i-removeformat{-ie7-icon:"\e01d"}.mce-i-subscript{-ie7-icon:"\e01e"}.mce-i-superscript{-ie7-icon:"\e01f"}.mce-i-charmap{-ie7-icon:"\e020"}.mce-i-emoticons{-ie7-icon:"\e021"}.mce-i-print{-ie7-icon:"\e022"}.mce-i-fullscreen{-ie7-icon:"\e023"}.mce-i-spellchecker{-ie7-icon:"\e024"}.mce-i-nonbreaking{-ie7-icon:"\e025"}.mce-i-template{-ie7-icon:"\e026"}.mce-i-pagebreak{-ie7-icon:"\e027"}.mce-i-restoredraft{-ie7-icon:"\e028"}.mce-i-untitled{-ie7-icon:"\e029"}.mce-i-bold{-ie7-icon:"\e02a"}.mce-i-italic{-ie7-icon:"\e02b"}.mce-i-underline{-ie7-icon:"\e02c"}.mce-i-strikethrough{-ie7-icon:"\e02d"}.mce-i-visualchars{-ie7-icon:"\e02e"}.mce-i-ltr{-ie7-icon:"\e02f"}.mce-i-rtl{-ie7-icon:"\e030"}.mce-i-copy{-ie7-icon:"\e031"}.mce-i-resize{-ie7-icon:"\e032"}.mce-i-browse{-ie7-icon:"\e034"}.mce-i-pastetext{-ie7-icon:"\e035"}.mce-i-checkbox,.mce-i-selected{-ie7-icon:"\e033"}.mce-i-selected{visibility:hidden}.mce-i-backcolor{background:#BBB}
\ No newline at end of file
diff --git a/lib/test/data/js/skins/lightgray/skin.min.css b/lib/test/data/js/skins/lightgray/skin.min.css
new file mode 100644
index 0000000..284ac1d
--- /dev/null
+++ b/lib/test/data/js/skins/lightgray/skin.min.css
@@ -0,0 +1 @@
+.mce-container,.mce-container *,.mce-widget,.mce-widget *,.mce-reset{margin:0;padding:0;border:0;outline:0;vertical-align:top;background:transparent;text-decoration:none;color:#333;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:14px;text-shadow:none;float:none;position:static;width:auto;height:auto;white-space:nowrap;cursor:inherit;-webkit-tap-highlight-color:transparent;line-height:normal;font-weight:normal;text-align:left;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box;direction:ltr}.mce-widget button{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}.mce-container *[unselectable]{-moz-user-select:none;-webkit-user-select:none;-o-user-select:none;user-select:none}.mce-fade{opacity:0;-webkit-transition:opacity .15s linear;transition:opacity .15s linear}.mce-fade.mce-in{opacity:1}.mce-tinymce{visibility:visible !important;position:relative}.mce-fullscreen{border:0;padding:0;margin:0;overflow:hidden;height:100%;z-index:100}div.mce-fullscreen{position:fixed;top:0;left:0;width:100%;height:auto}.mce-tinymce{display:block;-webkit-border-radius:2px;-moz-border-radius:2px;border-radius:2px}.mce-wordcount{position:absolute;top:0;right:0;padding:8px}div.mce-edit-area{background:#FFF;filter:none}.mce-statusbar{position:relative}.mce-statusbar .mce-container-body{position:relative}.mce-fullscreen .mce-resizehandle{display:none}.mce-charmap{border-collapse:collapse}.mce-charmap td{cursor:default;border:1px solid #9e9e9e;width:20px;height:20px;line-height:20px;text-align:center;vertical-align:middle;padding:2px}.mce-charmap td div{text-align:center}.mce-charmap td:hover{background:#d9d9d9}.mce-grid td div{border:1px solid #d6d6d6;width:12px;height:12px;margin:2px;cursor:pointer}.mce-grid td div:focus{border-color:#a1a1a1}.mce-grid{border-spacing:2px;border-collapse:separate}.mce-grid a{display:block;border:1px solid transparent}.mce-grid a:hover,.mce-grid a:focus{border-color:#a1a1a1}.mce-grid-border{margin:0 4px 0 4px}.mce-grid-border a{border-color:#d6d6d6;width:13px;height:13px}.mce-grid-border a:hover,.mce-grid-border a.mce-active{border-color:#a1a1a1;background:#c8def4}.mce-text-center{text-align:center}div.mce-tinymce-inline{width:100%;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}.mce-toolbar-grp{padding-bottom:2px}.mce-toolbar-grp .mce-flow-layout-item{margin-bottom:0}.mce-rtl .mce-wordcount{left:0;right:auto}.mce-container,.mce-container-body{display:block}.mce-autoscroll{overflow:hidden}.mce-scrollbar{position:absolute;width:7px;height:100%;top:2px;right:2px;opacity:.4;filter:alpha(opacity=40);zoom:1}.mce-scrollbar-h{top:auto;right:auto;left:2px;bottom:2px;width:100%;height:7px}.mce-scrollbar-thumb{position:absolute;background-color:#000;border:1px solid #888;border-color:rgba(85,85,85,0.6);width:5px;height:100%;-webkit-border-radius:7px;-moz-border-radius:7px;border-radius:7px}.mce-scrollbar-h .mce-scrollbar-thumb{width:100%;height:5px}.mce-scrollbar:hover,.mce-scrollbar.mce-active{background-color:#AAA;opacity:.6;filter:alpha(opacity=60);zoom:1;-webkit-border-radius:7px;-moz-border-radius:7px;border-radius:7px}.mce-scroll{position:relative}.mce-panel{border:0 solid #9e9e9e;background-color:#f0f0f0;background-image:-moz-linear-gradient(top, #fdfdfd, #ddd);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#fdfdfd), to(#ddd));background-image:-webkit-linear-gradient(top, #fdfdfd, #ddd);background-image:-o-linear-gradient(top, #fdfdfd, #ddd);background-image:linear-gradient(to bottom, #fdfdfd, #ddd);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fffdfdfd', endColorstr='#ffdddddd', GradientType=0);zoom:1}.mce-floatpanel{position:absolute;-webkit-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);-moz-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);box-shadow:0 5px 10px rgba(0, 0, 0, 0.2)}.mce-floatpanel.mce-fixed{position:fixed}.mce-floatpanel .mce-arrow,.mce-floatpanel .mce-arrow:after{position:absolute;display:block;width:0;height:0;border-color:transparent;border-style:solid}.mce-floatpanel .mce-arrow{border-width:11px}.mce-floatpanel .mce-arrow:after{border-width:10px;content:""}.mce-floatpanel.mce-popover{filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);background:transparent;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);-moz-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);top:0;left:0;background:#fff;border:1px solid #9e9e9e;border:1px solid rgba(0,0,0,0.25)}.mce-floatpanel.mce-popover.mce-bottom{margin-top:10px;*margin-top:0}.mce-floatpanel.mce-popover.mce-bottom>.mce-arrow{left:50%;margin-left:-11px;border-top-width:0;border-bottom-color:#9e9e9e;border-bottom-color:rgba(0,0,0,0.25);top:-11px}.mce-floatpanel.mce-popover.mce-bottom>.mce-arrow:after{top:1px;margin-left:-10px;border-top-width:0;border-bottom-color:#fff}.mce-floatpanel.mce-popover.mce-bottom.mce-start{margin-left:-22px}.mce-floatpanel.mce-popover.mce-bottom.mce-start>.mce-arrow{left:20px}.mce-floatpanel.mce-popover.mce-bottom.mce-end{margin-left:22px}.mce-floatpanel.mce-popover.mce-bottom.mce-end>.mce-arrow{right:10px;left:auto}.mce-fullscreen{border:0;padding:0;margin:0;overflow:hidden;background:#fff;height:100%}div.mce-fullscreen{position:fixed;top:0;left:0}#mce-modal-block{opacity:0;filter:alpha(opacity=0);zoom:1;position:fixed;left:0;top:0;width:100%;height:100%;background:#000}#mce-modal-block.mce-in{opacity:.3;filter:alpha(opacity=30);zoom:1}.mce-window-move{cursor:move}.mce-window{-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);-moz-box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);background:transparent;background:#fff;position:fixed;top:0;left:0;opacity:0;-webkit-transition:opacity 150ms ease-in;transition:opacity 150ms ease-in}.mce-window.mce-in{opacity:1}.mce-window-head{padding:9px 15px;border-bottom:1px solid #c5c5c5;position:relative}.mce-window-head .mce-close{position:absolute;right:15px;top:9px;font-size:20px;font-weight:bold;line-height:20px;color:#858585;cursor:pointer;height:20px;overflow:hidden}.mce-close:hover{color:#adadad}.mce-window-head .mce-title{line-height:20px;font-size:20px;font-weight:bold;text-rendering:optimizelegibility;padding-right:10px}.mce-window .mce-container-body{display:block}.mce-foot{display:block;background-color:#fff;border-top:1px solid #c5c5c5;-webkit-border-radius:0 0 6px 6px;-moz-border-radius:0 0 6px 6px;border-radius:0 0 6px 6px}.mce-window-head .mce-dragh{position:absolute;top:0;left:0;cursor:move;width:90%;height:100%}.mce-window iframe{width:100%;height:100%}.mce-window.mce-fullscreen,.mce-window.mce-fullscreen .mce-foot{-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.mce-rtl .mce-window-head .mce-close{position:absolute;right:auto;left:15px}.mce-rtl .mce-window-head .mce-dragh{left:auto;right:0}.mce-rtl .mce-window-head .mce-title{direction:rtl;text-align:right}.mce-abs-layout{position:relative}body .mce-abs-layout-item,.mce-abs-end{position:absolute}.mce-abs-end{width:1px;height:1px}.mce-container-body.mce-abs-layout{overflow:hidden}.mce-tooltip{position:absolute;padding:5px;opacity:.8;filter:alpha(opacity=80);zoom:1}.mce-tooltip-inner{font-size:11px;background-color:#000;color:#fff;max-width:200px;padding:5px 8px 4px 8px;text-align:center;white-space:normal}.mce-tooltip-inner{-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.mce-tooltip-inner{-webkit-box-shadow:0 0 5px #000000;-moz-box-shadow:0 0 5px #000000;box-shadow:0 0 5px #000000}.mce-tooltip-arrow{position:absolute;width:0;height:0;line-height:0;border:5px dashed #000}.mce-tooltip-arrow-n{border-bottom-color:#000}.mce-tooltip-arrow-s{border-top-color:#000}.mce-tooltip-arrow-e{border-left-color:#000}.mce-tooltip-arrow-w{border-right-color:#000}.mce-tooltip-nw,.mce-tooltip-sw{margin-left:-14px}.mce-tooltip-n .mce-tooltip-arrow{top:0px;left:50%;margin-left:-5px;border-bottom-style:solid;border-top:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-nw .mce-tooltip-arrow{top:0;left:10px;border-bottom-style:solid;border-top:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-ne .mce-tooltip-arrow{top:0;right:10px;border-bottom-style:solid;border-top:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-s .mce-tooltip-arrow{bottom:0;left:50%;margin-left:-5px;border-top-style:solid;border-bottom:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-sw .mce-tooltip-arrow{bottom:0;left:10px;border-top-style:solid;border-bottom:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-se .mce-tooltip-arrow{bottom:0;right:10px;border-top-style:solid;border-bottom:none;border-left-color:transparent;border-right-color:transparent}.mce-tooltip-e .mce-tooltip-arrow{right:0;top:50%;margin-top:-5px;border-left-style:solid;border-right:none;border-top-color:transparent;border-bottom-color:transparent}.mce-tooltip-w .mce-tooltip-arrow{left:0;top:50%;margin-top:-5px;border-right-style:solid;border-left:none;border-top-color:transparent;border-bottom-color:transparent}.mce-btn{border:1px solid #b1b1b1;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25) rgba(0,0,0,0.25);position:relative;text-shadow:0 1px 1px rgba(255,255,255,0.75);display:inline-block;*display:inline;*zoom:1;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);background-color:#f0f0f0;background-image:-moz-linear-gradient(top, #fff, #d9d9d9);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#fff), to(#d9d9d9));background-image:-webkit-linear-gradient(top, #fff, #d9d9d9);background-image:-o-linear-gradient(top, #fff, #d9d9d9);background-image:linear-gradient(to bottom, #fff, #d9d9d9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff', endColorstr='#ffd9d9d9', GradientType=0);zoom:1}.mce-btn:hover,.mce-btn:focus{color:#333;background-color:#e3e3e3;background-image:-moz-linear-gradient(top, #f2f2f2, #ccc);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#f2f2f2), to(#ccc));background-image:-webkit-linear-gradient(top, #f2f2f2, #ccc);background-image:-o-linear-gradient(top, #f2f2f2, #ccc);background-image:linear-gradient(to bottom, #f2f2f2, #ccc);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fff2f2f2', endColorstr='#ffcccccc', GradientType=0);zoom:1}.mce-btn.mce-disabled button,.mce-btn.mce-disabled:hover button{cursor:default;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;opacity:.4;filter:alpha(opacity=40);zoom:1}.mce-btn.mce-active,.mce-btn.mce-active:hover{background-color:#d6d6d6;background-image:-moz-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#e6e6e6), to(#c0c0c0));background-image:-webkit-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:-o-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:linear-gradient(to bottom, #e6e6e6, #c0c0c0);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffe6e6e6', endColorstr='#ffc0c0c0', GradientType=0);zoom:1;-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05)}.mce-btn:not(.mce-disabled):active{background-color:#d6d6d6;background-image:-moz-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#e6e6e6), to(#c0c0c0));background-image:-webkit-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:-o-linear-gradient(top, #e6e6e6, #c0c0c0);background-image:linear-gradient(to bottom, #e6e6e6, #c0c0c0);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffe6e6e6', endColorstr='#ffc0c0c0', GradientType=0);zoom:1;-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05)}.mce-btn button{padding:4px 10px;font-size:14px;line-height:20px;*line-height:16px;cursor:pointer;color:#333;text-align:center;overflow:visible;-webkit-appearance:none}.mce-btn button::-moz-focus-inner{border:0;padding:0}.mce-btn i{text-shadow:1px 1px #fff}.mce-primary{min-width:50px;color:#fff;border:1px solid #b1b1b1;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25) rgba(0,0,0,0.25);background-color:#006dcc;background-image:-moz-linear-gradient(top, #08c, #04c);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#08c), to(#04c));background-image:-webkit-linear-gradient(top, #08c, #04c);background-image:-o-linear-gradient(top, #08c, #04c);background-image:linear-gradient(to bottom, #08c, #04c);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc', endColorstr='#ff0044cc', GradientType=0);zoom:1}.mce-primary:hover,.mce-primary:focus{background-color:#005fb3;background-image:-moz-linear-gradient(top, #0077b3, #003cb3);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#0077b3), to(#003cb3));background-image:-webkit-linear-gradient(top, #0077b3, #003cb3);background-image:-o-linear-gradient(top, #0077b3, #003cb3);background-image:linear-gradient(to bottom, #0077b3, #003cb3);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0077b3', endColorstr='#ff003cb3', GradientType=0);zoom:1}.mce-primary.mce-disabled button,.mce-primary.mce-disabled:hover button{cursor:default;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;opacity:.4;filter:alpha(opacity=40);zoom:1}.mce-primary.mce-active,.mce-primary.mce-active:hover,.mce-primary:not(.mce-disabled):active{background-color:#005299;background-image:-moz-linear-gradient(top, #069, #039);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#069), to(#039));background-image:-webkit-linear-gradient(top, #069, #039);background-image:-o-linear-gradient(top, #069, #039);background-image:linear-gradient(to bottom, #069, #039);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff006699', endColorstr='#ff003399', GradientType=0);zoom:1;-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05)}.mce-primary button,.mce-primary button i{color:#fff;text-shadow:1px 1px #333}.mce-btn-large button{padding:9px 14px;font-size:16px;line-height:normal;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px}.mce-btn-large i{margin-top:2px}.mce-btn-small button{padding:1px 5px;font-size:12px;*padding-bottom:2px}.mce-btn-small i{line-height:20px;vertical-align:top;*line-height:18px}.mce-btn .mce-caret{margin-top:8px;margin-left:0}.mce-btn-small .mce-caret{margin-top:8px;margin-left:0}.mce-caret{display:inline-block;*display:inline;*zoom:1;width:0;height:0;vertical-align:top;border-top:4px solid #333;border-right:4px solid transparent;border-left:4px solid transparent;content:""}.mce-disabled .mce-caret{border-top-color:#aaa}.mce-caret.mce-up{border-bottom:4px solid #333;border-top:0}.mce-rtl .mce-btn button{direction:rtl}.mce-btn-group .mce-btn{border-width:1px 0 1px 0;margin:0;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.mce-btn-group .mce-first{border-left:1px solid #b1b1b1;border-left:1px solid rgba(0,0,0,0.25);-webkit-border-radius:3px 0 0 3px;-moz-border-radius:3px 0 0 3px;border-radius:3px 0 0 3px}.mce-btn-group .mce-last{border-right:1px solid #b1b1b1;border-right:1px solid rgba(0,0,0,0.1);-webkit-border-radius:0 3px 3px 0;-moz-border-radius:0 3px 3px 0;border-radius:0 3px 3px 0}.mce-btn-group .mce-first.mce-last{-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.mce-btn-group .mce-btn.mce-flow-layout-item{margin:0}.mce-checkbox{cursor:pointer}i.mce-i-checkbox{margin:0 3px 0 0;border:1px solid #c5c5c5;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2), 0 1px 2px rgba(0, 0, 0, 0.05);background-color:#f0f0f0;background-image:-moz-linear-gradient(top, #fff, #d9d9d9);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#fff), to(#d9d9d9));background-image:-webkit-linear-gradient(top, #fff, #d9d9d9);background-image:-o-linear-gradient(top, #fff, #d9d9d9);background-image:linear-gradient(to bottom, #fff, #d9d9d9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff', endColorstr='#ffd9d9d9', GradientType=0);zoom:1;text-indent:-10em;*font-size:0;*line-height:0;*text-indent:0;overflow:hidden}.mce-checked i.mce-i-checkbox{color:#333;font-size:16px;line-height:16px;text-indent:0}.mce-checkbox:focus i.mce-i-checkbox,.mce-checkbox.mce-focus i.mce-i-checkbox{border:1px solid rgba(82,168,236,0.8);-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65)}.mce-checkbox.mce-disabled .mce-label,.mce-checkbox.mce-disabled i.mce-i-checkbox{color:#acacac}.mce-rtl .mce-checkbox{direction:rtl;text-align:right}.mce-rtl i.mce-i-checkbox{margin:0 0 0 3px}.mce-colorbutton .mce-ico{position:relative}.mce-colorbutton-grid{margin:4px}.mce-colorbutton button{padding-right:4px}.mce-colorbutton .mce-preview{padding-right:3px;display:block;position:absolute;left:50%;top:50%;margin-left:-14px;margin-top:7px;background:gray;width:13px;height:2px;overflow:hidden}.mce-colorbutton.mce-btn-small .mce-preview{margin-left:-16px;padding-right:0;width:16px}.mce-colorbutton .mce-open{padding-left:4px;border-left:1px solid transparent;border-right:1px solid transparent}.mce-colorbutton:hover .mce-open{border-left-color:#bdbdbd;border-right-color:#bdbdbd}.mce-colorbutton.mce-btn-small .mce-open{padding:0 3px 0 3px}.mce-rtl .mce-colorbutton{direction:rtl}.mce-rtl .mce-colorbutton .mce-preview{margin-left:0;padding-right:0;padding-left:4px;margin-right:-14px}.mce-rtl .mce-colorbutton.mce-btn-small .mce-preview{margin-left:0;padding-right:0;margin-right:-17px;padding-left:0}.mce-rtl .mce-colorbutton button{padding-right:10px;padding-left:10px}.mce-rtl .mce-colorbutton .mce-open{padding-left:4px;padding-right:4px}.mce-combobox{display:inline-block;*display:inline;*zoom:1;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);*height:32px}.mce-combobox input{border:1px solid #c5c5c5;border-right-color:#c5c5c5;height:28px}.mce-combobox.mce-disabled input{color:#adadad}.mce-combobox.mce-has-open input{-webkit-border-radius:4px 0 0 4px;-moz-border-radius:4px 0 0 4px;border-radius:4px 0 0 4px}.mce-combobox .mce-btn{border-left:0;-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.mce-combobox button{padding-right:8px;padding-left:8px}.mce-combobox.mce-disabled .mce-btn button{cursor:default;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;opacity:.4;filter:alpha(opacity=40);zoom:1}.mce-path{display:inline-block;*display:inline;*zoom:1;padding:8px;white-space:normal}.mce-path .mce-txt{display:inline-block;padding-right:3px}.mce-path .mce-path-body{display:inline-block}.mce-path-item{display:inline-block;*display:inline;*zoom:1;cursor:pointer;color:#333}.mce-path-item:hover{text-decoration:underline}.mce-path-item:focus{background:#666;color:#fff}.mce-path .mce-divider{display:inline}.mce-disabled .mce-path-item{color:#aaa}.mce-rtl .mce-path{direction:rtl}.mce-fieldset{border:0 solid #9E9E9E;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.mce-fieldset>.mce-container-body{margin-top:-15px}.mce-fieldset-title{margin-left:5px;padding:0 5px 0 5px}.mce-fit-layout{display:inline-block;*display:inline;*zoom:1}.mce-fit-layout-item{position:absolute}.mce-flow-layout-item{display:inline-block;*display:inline;*zoom:1}.mce-flow-layout-item{margin:2px 0 2px 2px}.mce-flow-layout-item.mce-last{margin-right:2px}.mce-flow-layout{white-space:normal}.mce-tinymce-inline .mce-flow-layout{white-space:nowrap}.mce-rtl .mce-flow-layout{text-align:right;direction:rtl}.mce-rtl .mce-flow-layout-item{margin:2px 2px 2px 0}.mce-rtl .mce-flow-layout-item.mce-last{margin-left:2px}.mce-iframe{border:0 solid #9e9e9e;width:100%;height:100%}.mce-label{display:inline-block;*display:inline;*zoom:1;text-shadow:0 1px 1px rgba(255,255,255,0.75);overflow:hidden}.mce-label.mce-autoscroll{overflow:auto}.mce-label.mce-disabled{color:#aaa}.mce-label.mce-multiline{white-space:pre-wrap}.mce-label.mce-error{color:#a00}.mce-rtl .mce-label{text-align:right;direction:rtl}.mce-menubar .mce-menubtn{border-color:transparent;background:transparent;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;filter:none}.mce-menubar{border:1px solid #c4c4c4}.mce-menubar .mce-menubtn button span{color:#333}.mce-menubar .mce-caret{border-top-color:#333}.mce-menubar .mce-menubtn:hover,.mce-menubar .mce-menubtn.mce-active,.mce-menubar .mce-menubtn:focus{border-color:transparent;background:#e6e6e6;filter:none;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}.mce-menubtn span{color:#333;margin-right:2px;line-height:20px;*line-height:16px}.mce-menubtn.mce-btn-small span{font-size:12px}.mce-menubtn.mce-fixed-width span{display:inline-block;overflow-x:hidden;text-overflow:ellipsis;width:90px}.mce-menubtn.mce-fixed-width.mce-btn-small span{width:70px}.mce-menubtn .mce-caret{*margin-top:6px}.mce-rtl .mce-menubtn button{direction:rtl;text-align:right}.mce-listbox button{text-align:left;padding-right:20px;position:relative}.mce-listbox .mce-caret{position:absolute;margin-top:-2px;right:8px;top:50%}.mce-rtl .mce-listbox .mce-caret{right:auto;left:8px}.mce-rtl .mce-listbox button{padding-right:10px;padding-left:20px}.mce-menu-item{display:block;padding:6px 15px 6px 12px;clear:both;font-weight:normal;line-height:20px;color:#333;white-space:nowrap;cursor:pointer;line-height:normal;border-left:4px solid transparent;margin-bottom:1px}.mce-menu-item .mce-ico,.mce-menu-item .mce-text{color:#333}.mce-menu-item.mce-disabled .mce-text,.mce-menu-item.mce-disabled .mce-ico{color:#adadad}.mce-menu-item:hover .mce-text,.mce-menu-item.mce-selected .mce-text,.mce-menu-item:focus .mce-text{color:#fff}.mce-menu-item:hover .mce-ico,.mce-menu-item.mce-selected .mce-ico,.mce-menu-item:focus .mce-ico{color:#fff}.mce-menu-item.mce-disabled:hover{background:#ccc}.mce-menu-shortcut{display:inline-block;color:#adadad}.mce-menu-shortcut{display:inline-block;*display:inline;*zoom:1;padding:0 15px 0 20px}.mce-menu-item:hover .mce-menu-shortcut,.mce-menu-item.mce-selected .mce-menu-shortcut,.mce-menu-item:focus .mce-menu-shortcut{color:#fff}.mce-menu-item .mce-caret{margin-top:4px;*margin-top:3px;margin-right:6px;border-top:4px solid transparent;border-bottom:4px solid transparent;border-left:4px solid #333}.mce-menu-item.mce-selected .mce-caret,.mce-menu-item:focus .mce-caret,.mce-menu-item:hover .mce-caret{border-left-color:#fff}.mce-menu-align .mce-menu-shortcut{*margin-top:-2px}.mce-menu-align .mce-menu-shortcut,.mce-menu-align .mce-caret{position:absolute;right:0}.mce-menu-item.mce-active i{visibility:visible}.mce-menu-item-normal.mce-active{background-color:#c8def4}.mce-menu-item-preview.mce-active{border-left:5px solid #aaa}.mce-menu-item-normal.mce-active .mce-text{color:#333}.mce-menu-item-normal.mce-active:hover .mce-text,.mce-menu-item-normal.mce-active:hover .mce-ico{color:#fff}.mce-menu-item-normal.mce-active:focus .mce-text,.mce-menu-item-normal.mce-active:focus .mce-ico{color:#fff}.mce-menu-item:hover,.mce-menu-item.mce-selected,.mce-menu-item:focus{text-decoration:none;color:#fff;background-color:#0081c2;background-image:-moz-linear-gradient(top, #08c, #0077b3);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#08c), to(#0077b3));background-image:-webkit-linear-gradient(top, #08c, #0077b3);background-image:-o-linear-gradient(top, #08c, #0077b3);background-image:linear-gradient(to bottom, #08c, #0077b3);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff0088cc', endColorstr='#ff0077b3', GradientType=0);zoom:1}div.mce-menu .mce-menu-item-sep,.mce-menu-item-sep:hover{border:0;padding:0;height:1px;margin:9px 1px;overflow:hidden;background:#cbcbcb;border-bottom:1px solid #fff;cursor:default;filter:none}.mce-menu.mce-rtl{direction:rtl}.mce-rtl .mce-menu-item{text-align:right;direction:rtl;padding:6px 12px 6px 15px}.mce-menu-align.mce-rtl .mce-menu-shortcut,.mce-menu-align.mce-rtl .mce-caret{right:auto;left:0}.mce-rtl .mce-menu-item .mce-caret{margin-left:6px;margin-right:0;border-right:4px solid #333;border-left:0}.mce-rtl .mce-menu-item.mce-selected .mce-caret,.mce-rtl .mce-menu-item:focus .mce-caret,.mce-rtl .mce-menu-item:hover .mce-caret{border-left-color:transparent;border-right-color:#fff}.mce-menu{position:absolute;left:0;top:0;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);background:transparent;z-index:1000;padding:5px 0 5px 0;margin:2px 0 0;min-width:160px;background:#fff;border:1px solid #989898;border:1px solid rgba(0,0,0,0.2);z-index:1002;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);-moz-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);max-height:400px;overflow:auto;overflow-x:hidden}.mce-menu i{display:none}.mce-menu-has-icons i{display:inline-block;*display:inline}.mce-menu-sub-tr-tl{margin:-6px 0 0 -1px}.mce-menu-sub-br-bl{margin:6px 0 0 -1px}.mce-menu-sub-tl-tr{margin:-6px 0 0 1px}.mce-menu-sub-bl-br{margin:6px 0 0 1px}.mce-container-body .mce-resizehandle{position:absolute;right:0;bottom:0;width:16px;height:16px;visibility:visible;cursor:s-resize;margin:0}.mce-container-body .mce-resizehandle-both{cursor:se-resize}i.mce-i-resize{color:#333}.mce-spacer{visibility:hidden}.mce-splitbtn .mce-open{border-left:1px solid transparent;border-right:1px solid transparent}.mce-splitbtn:hover .mce-open{border-left-color:#bdbdbd;border-right-color:#bdbdbd}.mce-splitbtn button{padding-right:4px}.mce-splitbtn .mce-open{padding-left:4px}.mce-splitbtn .mce-open.mce-active{-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15), 0 1px 2px rgba(0, 0, 0, 0.05)}.mce-splitbtn.mce-btn-small .mce-open{padding:0 3px 0 3px}.mce-rtl .mce-splitbtn{direction:rtl;text-align:right}.mce-rtl .mce-splitbtn button{padding-right:10px;padding-left:10px}.mce-rtl .mce-splitbtn .mce-open{padding-left:4px;padding-right:4px}.mce-stack-layout-item{display:block}.mce-tabs{display:block;border-bottom:1px solid #c5c5c5}.mce-tab{display:inline-block;*display:inline;*zoom:1;border:1px solid #c5c5c5;border-width:0 1px 0 0;background:#e3e3e3;padding:8px;text-shadow:0 1px 1px rgba(255,255,255,0.75);height:13px;cursor:pointer}.mce-tab:hover{background:#fdfdfd}.mce-tab.mce-active{background:#fdfdfd;border-bottom-color:transparent;margin-bottom:-1px;height:14px}.mce-rtl .mce-tabs{text-align:right;direction:rtl}.mce-rtl .mce-tab{border-width:0 0 0 1px}.mce-textbox{background:#fff;border:1px solid #c5c5c5;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);display:inline-block;-webkit-transition:border linear .2s, box-shadow linear .2s;transition:border linear .2s, box-shadow linear .2s;height:28px;resize:none;padding:0 4px 0 4px;white-space:pre-wrap;*white-space:pre;color:#333}.mce-textbox:focus,.mce-textbox.mce-focus{border-color:rgba(82,168,236,0.8);-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 8px rgba(82, 168, 236, 0.65)}.mce-placeholder .mce-textbox{color:#aaa}.mce-textbox.mce-multiline{padding:4px}.mce-textbox.mce-disabled{color:#adadad}.mce-rtl .mce-textbox{text-align:right;direction:rtl}.mce-throbber{position:absolute;top:0;left:0;width:100%;height:100%;opacity:.6;filter:alpha(opacity=60);zoom:1;background:#fff url('img/loader.gif') no-repeat center center}.mce-throbber-inline{position:static;height:50px}@font-face{font-family:'tinymce';src:url('fonts/tinymce.eot');src:url('fonts/tinymce.eot?#iefix') format('embedded-opentype'),url('fonts/tinymce.woff') format('woff'),url('fonts/tinymce.ttf') format('truetype'),url('fonts/tinymce.svg#tinymce') format('svg');font-weight:normal;font-style:normal}@font-face{font-family:'tinymce-small';src:url('fonts/tinymce-small.eot');src:url('fonts/tinymce-small.eot?#iefix') format('embedded-opentype'),url('fonts/tinymce-small.woff') format('woff'),url('fonts/tinymce-small.ttf') format('truetype'),url('fonts/tinymce-small.svg#tinymce') format('svg');font-weight:normal;font-style:normal}.mce-ico{font-family:'tinymce',Arial;font-style:normal;font-weight:normal;font-variant:normal;font-size:16px;line-height:16px;speak:none;vertical-align:text-top;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;display:inline-block;background:transparent center center;background-size:cover;width:16px;height:16px;color:#333}.mce-btn-small .mce-ico{font-family:'tinymce-small',Arial}.mce-i-save:before{content:"\e000"}.mce-i-newdocument:before{content:"\e001"}.mce-i-fullpage:before{content:"\e002"}.mce-i-alignleft:before{content:"\e003"}.mce-i-aligncenter:before{content:"\e004"}.mce-i-alignright:before{content:"\e005"}.mce-i-alignjustify:before{content:"\e006"}.mce-i-cut:before{content:"\e007"}.mce-i-paste:before{content:"\e008"}.mce-i-searchreplace:before{content:"\e009"}.mce-i-bullist:before{content:"\e00a"}.mce-i-numlist:before{content:"\e00b"}.mce-i-indent:before{content:"\e00c"}.mce-i-outdent:before{content:"\e00d"}.mce-i-blockquote:before{content:"\e00e"}.mce-i-undo:before{content:"\e00f"}.mce-i-redo:before{content:"\e010"}.mce-i-link:before{content:"\e011"}.mce-i-unlink:before{content:"\e012"}.mce-i-anchor:before{content:"\e013"}.mce-i-image:before{content:"\e014"}.mce-i-media:before{content:"\e015"}.mce-i-help:before{content:"\e016"}.mce-i-code:before{content:"\e017"}.mce-i-insertdatetime:before{content:"\e018"}.mce-i-preview:before{content:"\e019"}.mce-i-forecolor:before{content:"\e01a"}.mce-i-backcolor:before{content:"\e01a"}.mce-i-table:before{content:"\e01b"}.mce-i-hr:before{content:"\e01c"}.mce-i-removeformat:before{content:"\e01d"}.mce-i-subscript:before{content:"\e01e"}.mce-i-superscript:before{content:"\e01f"}.mce-i-charmap:before{content:"\e020"}.mce-i-emoticons:before{content:"\e021"}.mce-i-print:before{content:"\e022"}.mce-i-fullscreen:before{content:"\e023"}.mce-i-spellchecker:before{content:"\e024"}.mce-i-nonbreaking:before{content:"\e025"}.mce-i-template:before{content:"\e026"}.mce-i-pagebreak:before{content:"\e027"}.mce-i-restoredraft:before{content:"\e028"}.mce-i-untitled:before{content:"\e029"}.mce-i-bold:before{content:"\e02a"}.mce-i-italic:before{content:"\e02b"}.mce-i-underline:before{content:"\e02c"}.mce-i-strikethrough:before{content:"\e02d"}.mce-i-visualchars:before{content:"\e02e"}.mce-i-visualblocks:before{content:"\e02e"}.mce-i-ltr:before{content:"\e02f"}.mce-i-rtl:before{content:"\e030"}.mce-i-copy:before{content:"\e031"}.mce-i-resize:before{content:"\e032"}.mce-i-browse:before{content:"\e034"}.mce-i-pastetext:before{content:"\e035"}.mce-i-checkbox:before,.mce-i-selected:before{content:"\e033"}.mce-i-selected{visibility:hidden}i.mce-i-backcolor{text-shadow:none;background:#bbb}
\ No newline at end of file
diff --git a/lib/test/data/js/themes/modern/theme.min.js b/lib/test/data/js/themes/modern/theme.min.js
new file mode 100644
index 0000000..e25849d
--- /dev/null
+++ b/lib/test/data/js/themes/modern/theme.min.js
@@ -0,0 +1 @@
+tinymce.ThemeManager.add("modern",function(e){function t(){function t(t){var n,o=[];if(t)return d(t.split(/[ ,]/),function(t){function i(){var i=e.selection;"bullist"==r&&i.selectorChanged("ul > li",function(e,i){for(var n,o=i.parents.length;o--&&(n=i.parents[o].nodeName,"OL"!=n&&"UL"!=n););t.active(e&&"UL"==n)}),"numlist"==r&&i.selectorChanged("ol > li",function(e,i){for(var n,o=i.parents.length;o--&&(n=i.parents[o].nodeName,"OL"!=n&&"UL"!=n););t.active(e&&"OL"==n)}),t.settings.stateSelector&&i.selectorChanged(t.settings.stateSelector,function(e){t.active(e)},!0),t.settings.disabledStateSelector&&i.selectorChanged(t.settings.disabledStateSelector,function(e){t.disabled(e)})}var r;"|"==t?n=null:c.has(t)?(t={type:t},u.toolbar_items_size&&(t.size=u.toolbar_items_size),o.push(t),n=null):(n||(n={type:"buttongroup",items:[]},o.push(n)),e.buttons[t]&&(r=t,t=e.buttons[r],"function"==typeof t&&(t=t()),t.type=t.type||"button",u.toolbar_items_size&&(t.size=u.toolbar_items_size),t=c.create(t),n.items.push(t),e.initialized?i():e.on("init",i)))}),i.push({type:"toolbar",layout:"flow",items:o}),!0}var i=[];if(tinymce.isArray(u.toolbar)){if(0===u.toolbar.length)return;tinymce.each(u.toolbar,function(e,t){u["toolbar"+(t+1)]=e}),delete u.toolbar}for(var n=1;10>n&&t(u["toolbar"+n]);n++);return i.length||u.toolbar===!1||t(u.toolbar||f),i.length?{type:"panel",layout:"stack",classes:"toolbar-grp",ariaRoot:!0,ariaRemember:!0,items:i}:void 0}function i(){function t(t){var i;return"|"==t?{text:"|"}:i=e.menuItems[t]}function i(i){var n,o,r,a,s;if(s=tinymce.makeMap((u.removed_menuitems||"").split(/[ ,]/)),u.menu?(o=u.menu[i],a=!0):o=h[i],o){n={text:o.title},r=[],d((o.items||"").split(/[ ,]/),function(e){var i=t(e);i&&!s[e]&&r.push(t(e))}),a||d(e.menuItems,function(e){e.context==i&&("before"==e.separator&&r.push({text:"|"}),e.prependToContext?r.unshift(e):r.push(e),"after"==e.separator&&r.push({text:"|"}))});for(var l=0;l<r.length;l++)"|"==r[l].text&&(0===l||l==r.length-1)&&r.splice(l,1);if(n.menu=r,!n.menu.length)return null}return n}var n,o=[],r=[];if(u.menu)for(n in u.menu)r.push(n);else for(n in h)r.push(n);for(var a="string"==typeof u.menubar?u.menubar.split(/[ ,]/):r,s=0;s<a.length;s++){var l=a[s];l=i(l),l&&o.push(l)}return o}function n(t){function i(e){var i=t.find(e)[0];i&&i.focus(!0)}e.shortcuts.add("Alt+F9","",function(){i("menubar")}),e.shortcuts.add("Alt+F10","",function(){i("toolbar")}),e.shortcuts.add("Alt+F11","",function(){i("elementpath")}),t.on("cancel",function(){e.focus()})}function o(t,i){function n(e){return{width:e.clientWidth,height:e.clientHeight}}var o,r,a,s;o=e.getContainer(),r=e.getContentAreaContainer().firstChild,a=n(o),s=n(r),null!==t&&(t=Math.max(u.min_width||100,t),t=Math.min(u.max_width||65535,t),m.css(o,"width",t+(a.width-s.width)),m.css(r,"width",t)),i=Math.max(u.min_height||100,i),i=Math.min(u.max_height||65535,i),m.css(r,"height",i),e.fire("ResizeEditor")}function r(t,i){var n=e.getContentAreaContainer();l.resizeTo(n.clientWidth+t,n.clientHeight+i)}function a(o){function r(){if(h&&h.moveRel&&h.visible()&&!h._fixed){var t=e.selection.getScrollContainer(),i=e.getBody(),n=0,o=0;if(t){var r=m.getPos(i),a=m.getPos(t);n=Math.max(0,a.x-r.x),o=Math.max(0,a.y-r.y)}h.fixed(!1).moveRel(i,e.rtl?["tr-br","br-tr"]:["tl-bl","bl-tl"]).moveBy(n,o)}}function a(){h&&(h.show(),r(),m.addClass(e.getBody(),"mce-edit-focus"))}function s(){h&&(h.hide(),m.removeClass(e.getBody(),"mce-edit-focus"))}function d(){return h?void(h.visible()||a()):(h=l.panel=c.create({type:f?"panel":"floatpanel",role:"application",classes:"tinymce tinymce-inline",layout:"flex",direction:"column",align:"stretch",autohide:!1,autofix:!0,fixed:!!f,border:1,items:[u.menubar===!1?null:{type:"menubar",border:"0 0 1 0",items:i()},t()]}),e.fire("BeforeRenderUI"),h.renderTo(f||document.body).reflow(),n(h),a(),e.on("nodeChange",r),e.on("activate",a),e.on("deactivate",s),void e.nodeChanged())}var h,f;return u.fixed_toolbar_container&&(f=m.select(u.fixed_toolbar_container)[0]),u.content_editable=!0,e.on("focus",function(){o.skinUiCss?tinymce.DOM.styleSheetLoader.load(o.skinUiCss,d,d):d()}),e.on("blur hide",s),e.on("remove",function(){h&&(h.remove(),h=null)}),o.skinUiCss&&tinymce.DOM.styleSheetLoader.load(o.skinUiCss),{}}function s(r){var a,s,d;return r.skinUiCss&&tinymce.DOM.loadCSS(r.skinUiCss),a=l.panel=c.create({type:"panel",role:"application",classes:"tinymce",style:"visibility: hidden",layout:"stack",border:1,items:[u.menubar===!1?null:{type:"menubar",border:"0 0 1 0",items:i()},t(),{type:"panel",name:"iframe",layout:"stack",classes:"edit-area",html:"",border:"1 0 0 0"}]}),u.resize!==!1&&(s={type:"resizehandle",direction:u.resize,onResizeStart:function(){var t=e.getContentAreaContainer().firstChild;d={width:t.clientWidth,height:t.clientHeight}},onResize:function(e){"both"==u.resize?o(d.width+e.deltaX,d.height+e.deltaY):o(null,d.height+e.deltaY)}}),u.statusbar!==!1&&a.add({type:"panel",name:"statusbar",classes:"statusbar",layout:"flow",border:"1 0 0 0",ariaRoot:!0,items:[{type:"elementpath"},s]}),u.readonly&&a.find("*").disabled(!0),e.fire("BeforeRenderUI"),a.renderBefore(r.targetNode).reflow(),u.width&&tinymce.DOM.setStyle(a.getEl(),"width",u.width),e.on("remove",function(){a.remove(),a=null}),n(a),{iframeContainer:a.find("#iframe")[0].getEl(),editorContainer:a.getEl()}}var l=this,u=e.settings,c=tinymce.ui.Factory,d=tinymce.each,m=tinymce.DOM,h={file:{title:"File",items:"newdocument"},edit:{title:"Edit",items:"undo redo | cut copy paste pastetext | selectall"},insert:{title:"Insert",items:"|"},view:{title:"View",items:"visualaid |"},format:{title:"Format",items:"bold italic underline strikethrough superscript subscript | formats | removeformat"},table:{title:"Table"},tools:{title:"Tools"}},f="undo redo | styleselect | bold italic | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link image";l.renderUI=function(t){var i=u.skin!==!1?u.skin||"lightgray":!1;if(i){var n=u.skin_url;n=n?e.documentBaseURI.toAbsolute(n):tinymce.baseURL+"/skins/"+i,t.skinUiCss=tinymce.Env.documentMode<=7?n+"/skin.ie7.min.css":n+"/skin.min.css",e.contentCSS.push(n+"/content"+(e.inline?".inline":"")+".min.css")}return e.on("ProgressState",function(e){l.throbber=l.throbber||new tinymce.ui.Throbber(l.panel.getEl("body")),e.state?l.throbber.show(e.time):l.throbber.hide()}),u.inline?a(t):s(t)},l.resizeTo=o,l.resizeBy=r});
\ No newline at end of file
diff --git a/lib/test/data/js/tinymce.min.js b/lib/test/data/js/tinymce.min.js
new file mode 100644
index 0000000..3ab7df7
--- /dev/null
+++ b/lib/test/data/js/tinymce.min.js
@@ -0,0 +1,10 @@
+// 4.0.26 (2014-05-06)
+!function(e,t){"use strict";function n(e,t){for(var n,r=[],i=0;i<e.length;++i){if(n=s[e[i]]||o(e[i]),!n)throw"module definition dependecy not found: "+e[i];r.push(n)}t.apply(null,r)}function r(e,r,i){if("string"!=typeof e)throw"invalid module definition, module id must be defined and be a string";if(r===t)throw"invalid module definition, dependencies must be specified";if(i===t)throw"invalid module definition, definition function must be specified";n(r,function(){s[e]=i.apply(null,arguments)})}function i(e){return!!s[e]}function o(t){for(var n=e,r=t.split(/[.\/]/),i=0;i<r.length;++i){if(!n[r[i]])return;n=n[r[i]]}return n}function a(n){for(var r=0;r<n.length;r++){for(var i=e,o=n[r],a=o.split(/[.\/]/),l=0;l<a.length-1;++l)i[a[l]]===t&&(i[a[l]]={}),i=i[a[l]];i[a[a.length-1]]=s[o]}}var s={},l="tinymce/dom/EventUtils",c="tinymce/dom/Sizzle",u="tinymce/dom/DomQuery",d="tinymce/html/Styles",f="tinymce/dom/TreeWalker",p="tinymce/util/Tools",h="tinymce/dom/Range",m="tinymce/html/Entities",g="tinymce/Env",v="tinymce/dom/StyleSheetLoader",y="tinymce/dom/DOMUtils",b="tinymce/dom/ScriptLoader",C="tinymce/AddOnManager",x="tinymce/html/Node",w="tinymce/html/Schema",_="tinymce/html/SaxParser",N="tinymce/html/DomParser",E="tinymce/html/Writer",S="tinymce/html/Serializer",k="tinymce/dom/Serializer",T="tinymce/dom/TridentSelection",R="tinymce/util/VK",A="tinymce/dom/ControlSelection",B="tinymce/dom/RangeUtils",D="tinymce/dom/Selection",L="tinymce/fmt/Preview",M="tinymce/Formatter",H="tinymce/UndoManager",P="tinymce/EnterKey",O="tinymce/ForceBlocks",I="tinymce/EditorCommands",F="tinymce/util/URI",z="tinymce/util/Class",W="tinymce/util/EventDispatcher",V="tinymce/ui/Selector",U="tinymce/ui/Collection",q="tinymce/ui/DomUtils",$="tinymce/ui/Control",j="tinymce/ui/Factory",K="tinymce/ui/KeyboardNavigation",G="tinymce/ui/Container",Y="tinymce/ui/DragHelper",X="tinymce/ui/Scrollable",J="tinymce/ui/Panel",Q="tinymce/ui/Movable",Z="tinymce/ui/Resizable",et="tinymce/ui/FloatPanel",tt="tinymce/ui/Window",nt="tinymce/ui/MessageBox",rt="tinymce/WindowManager",it="tinymce/util/Quirks",ot="tinymce/util/Observable",at="tinymce/EditorObservable",st="tinymce/Shortcuts",lt="tinymce/Editor",ct="tinymce/util/I18n",ut="tinymce/FocusManager",dt="tinymce/EditorManager",ft="tinymce/LegacyInput",pt="tinymce/util/XHR",ht="tinymce/util/JSON",mt="tinymce/util/JSONRequest",gt="tinymce/util/JSONP",vt="tinymce/util/LocalStorage",yt="tinymce/Compat",bt="tinymce/ui/Layout",Ct="tinymce/ui/AbsoluteLayout",xt="tinymce/ui/Tooltip",wt="tinymce/ui/Widget",_t="tinymce/ui/Button",Nt="tinymce/ui/ButtonGroup",Et="tinymce/ui/Checkbox",St="tinymce/ui/PanelButton",kt="tinymce/ui/ColorButton",Tt="tinymce/ui/ComboBox",Rt="tinymce/ui/Path",At="tinymce/ui/ElementPath",Bt="tinymce/ui/FormItem",Dt="tinymce/ui/Form",Lt="tinymce/ui/FieldSet",Mt="tinymce/ui/FilePicker",Ht="tinymce/ui/FitLayout",Pt="tinymce/ui/FlexLayout",Ot="tinymce/ui/FlowLayout",It="tinymce/ui/FormatControls",Ft="tinymce/ui/GridLayout",zt="tinymce/ui/Iframe",Wt="tinymce/ui/Label",Vt="tinymce/ui/Toolbar",Ut="tinymce/ui/MenuBar",qt="tinymce/ui/MenuButton",$t="tinymce/ui/ListBox",jt="tinymce/ui/MenuItem",Kt="tinymce/ui/Menu",Gt="tinymce/ui/Radio",Yt="tinymce/ui/ResizeHandle",Xt="tinymce/ui/Spacer",Jt="tinymce/ui/SplitButton",Qt="tinymce/ui/StackLayout",Zt="tinymce/ui/TabPanel",en="tinymce/ui/TextBox",tn="tinymce/ui/Throbber";r(l,[],function(){function e(e,t,n,r){e.addEventListener?e.addEventListener(t,n,r||!1):e.attachEvent&&e.attachEvent("on"+t,n)}function t(e,t,n,r){e.removeEventListener?e.removeEventListener(t,n,r||!1):e.detachEvent&&e.detachEvent("on"+t,n)}function n(e,t){function n(){return!1}function r(){return!0}var i,o=t||{},l;for(i in e)s[i]||(o[i]=e[i]);if(o.target||(o.target=o.srcElement||document),e&&a.test(e.type)&&e.pageX===l&&e.clientX!==l){var c=o.target.ownerDocument||document,u=c.documentElement,d=c.body;o.pageX=e.clientX+(u&&u.scrollLeft||d&&d.scrollLeft||0)-(u&&u.clientLeft||d&&d.clientLeft||0),o.pageY=e.clientY+(u&&u.scrollTop||d&&d.scrollTop||0)-(u&&u.clientTop||d&&d.clientTop||0)}return o.preventDefault=function(){o.isDefaultPrevented=r,e&&(e.preventDefault?e.preventDefault():e.returnValue=!1)},o.stopPropagation=function(){o.isPropagationStopped=r,e&&(e.stopPropagation?e.stopPropagation():e.cancelBubble=!0)},o.stopImmediatePropagation=function(){o.isImmediatePropagationStopped=r,o.stopPropagation()},o.isDefaultPrevented||(o.isDefaultPrevented=n,o.isPropagationStopped=n,o.isImmediatePropagationStopped=n),o}function r(n,r,i){function o(){i.domLoaded||(i.domLoaded=!0,r(c))}function a(){("complete"===l.readyState||"interactive"===l.readyState&&l.body)&&(t(l,"readystatechange",a),o())}function s(){try{l.documentElement.doScroll("left")}catch(e){return void setTimeout(s,0)}o()}var l=n.document,c={type:"ready"};return i.domLoaded?void r(c):(l.addEventListener?"complete"===l.readyState?o():e(n,"DOMContentLoaded",o):(e(l,"readystatechange",a),l.documentElement.doScroll&&n.self===n.top&&s()),void e(n,"load",o))}function i(){function i(e,t){var n,r,i,o,a=s[t];if(n=a&&a[e.type])for(r=0,i=n.length;i>r;r++)if(o=n[r],o&&o.func.call(o.scope,e)===!1&&e.preventDefault(),e.isImmediatePropagationStopped())return}var a=this,s={},l,c,u,d,f;c=o+(+new Date).toString(32),d="onmouseenter"in document.documentElement,u="onfocusin"in document.documentElement,f={mouseenter:"mouseover",mouseleave:"mouseout"},l=1,a.domLoaded=!1,a.events=s,a.bind=function(t,o,p,h){function m(e){i(n(e||_.event),g)}var g,v,y,b,C,x,w,_=window;if(t&&3!==t.nodeType&&8!==t.nodeType){for(t[c]?g=t[c]:(g=l++,t[c]=g,s[g]={}),h=h||t,o=o.split(" "),y=o.length;y--;)b=o[y],x=m,C=w=!1,"DOMContentLoaded"===b&&(b="ready"),a.domLoaded&&"ready"===b&&"complete"==t.readyState?p.call(h,n({type:b})):(d||(C=f[b],C&&(x=function(e){var t,r;if(t=e.currentTarget,r=e.relatedTarget,r&&t.contains)r=t.contains(r);else for(;r&&r!==t;)r=r.parentNode;r||(e=n(e||_.event),e.type="mouseout"===e.type?"mouseleave":"mouseenter",e.target=t,i(e,g))})),u||"focusin"!==b&&"focusout"!==b||(w=!0,C="focusin"===b?"focus":"blur",x=function(e){e=n(e||_.event),e.type="focus"===e.type?"focusin":"focusout",i(e,g)}),v=s[g][b],v?"ready"===b&&a.domLoaded?p({type:b}):v.push({func:p,scope:h}):(s[g][b]=v=[{func:p,scope:h}],v.fakeName=C,v.capture=w,v.nativeHandler=x,"ready"===b?r(t,x,a):e(t,C||b,x,w)));return t=v=0,p}},a.unbind=function(e,n,r){var i,o,l,u,d,f;if(!e||3===e.nodeType||8===e.nodeType)return a;if(i=e[c]){if(f=s[i],n){for(n=n.split(" "),l=n.length;l--;)if(d=n[l],o=f[d]){if(r)for(u=o.length;u--;)if(o[u].func===r){var p=o.nativeHandler,h=o.fakeName,m=o.capture;o=o.slice(0,u).concat(o.slice(u+1)),o.nativeHandler=p,o.fakeName=h,o.capture=m,f[d]=o}r&&0!==o.length||(delete f[d],t(e,o.fakeName||d,o.nativeHandler,o.capture))}}else{for(d in f)o=f[d],t(e,o.fakeName||d,o.nativeHandler,o.capture);f={}}for(d in f)return a;delete s[i];try{delete e[c]}catch(g){e[c]=null}}return a},a.fire=function(e,t,r){var o;if(!e||3===e.nodeType||8===e.nodeType)return a;r=n(null,r),r.type=t,r.target=e;do o=e[c],o&&i(r,o),e=e.parentNode||e.ownerDocument||e.defaultView||e.parentWindow;while(e&&!r.isPropagationStopped());return a},a.clean=function(e){var t,n,r=a.unbind;if(!e||3===e.nodeType||8===e.nodeType)return a;if(e[c]&&r(e),e.getElementsByTagName||(e=e.document),e&&e.getElementsByTagName)for(r(e),n=e.getElementsByTagName("*"),t=n.length;t--;)e=n[t],e[c]&&r(e);return a},a.destroy=function(){s={}},a.cancel=function(e){return e&&(e.preventDefault(),e.stopImmediatePropagation()),!1}}var o="mce-data-",a=/^(?:mouse|contextmenu)|click/,s={keyLocation:1,layerX:1,layerY:1,returnValue:1};return i.Event=new i,i.Event.bind(window,"ready",function(){}),i}),r(c,[],function(){function e(e){return mt.test(e+"")}function n(){var e,t=[];return e=function(n,r){return t.push(n+=" ")>_.cacheLength&&delete e[t.shift()],e[n]=r,r}}function r(e){return e[I]=!0,e}function i(e){var t=B.createElement("div");try{return!!e(t)}catch(n){return!1}finally{t=null}}function o(e,t,n,r){var i,o,a,s,l,c,f,p,h,m;if((t?t.ownerDocument||t:F)!==B&&A(t),t=t||B,n=n||[],!e||"string"!=typeof e)return n;if(1!==(s=t.nodeType)&&9!==s)return[];if(L&&!r){if(i=gt.exec(e))if(a=i[1]){if(9===s){if(o=t.getElementById(a),!o||!o.parentNode)return n;if(o.id===a)return n.push(o),n}else if(t.ownerDocument&&(o=t.ownerDocument.getElementById(a))&&O(t,o)&&o.id===a)return n.push(o),n}else{if(i[2])return Z.apply(n,t.getElementsByTagName(e)),n;if((a=i[3])&&z.getElementsByClassName&&t.getElementsByClassName)return Z.apply(n,t.getElementsByClassName(a)),n}if(z.qsa&&!M.test(e)){if(f=!0,p=I,h=t,m=9===s&&e,1===s&&"object"!==t.nodeName.toLowerCase()){for(c=u(e),(f=t.getAttribute("id"))?p=f.replace(bt,"\\$&"):t.setAttribute("id",p),p="[id='"+p+"'] ",l=c.length;l--;)c[l]=p+d(c[l]);h=ht.test(e)&&t.parentNode||t,m=c.join(",")}if(m)try{return Z.apply(n,h.querySelectorAll(m)),n}catch(g){}finally{f||t.removeAttribute("id")}}}return b(e.replace(lt,"$1"),t,n,r)}function a(e,t){var n=t&&e,r=n&&(~t.sourceIndex||Y)-(~e.sourceIndex||Y);if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function s(e){return function(t){var n=t.nodeName.toLowerCase();return"input"===n&&t.type===e}}function l(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function c(e){return r(function(t){return t=+t,r(function(n,r){for(var i,o=e([],n.length,t),a=o.length;a--;)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}function u(e,t){var n,r,i,a,s,l,c,u=q[e+" "];if(u)return t?0:u.slice(0);for(s=e,l=[],c=_.preFilter;s;){(!n||(r=ct.exec(s)))&&(r&&(s=s.slice(r[0].length)||s),l.push(i=[])),n=!1,(r=ut.exec(s))&&(n=r.shift(),i.push({value:n,type:r[0].replace(lt," ")}),s=s.slice(n.length));for(a in _.filter)!(r=pt[a].exec(s))||c[a]&&!(r=c[a](r))||(n=r.shift(),i.push({value:n,type:a,matches:r}),s=s.slice(n.length));if(!n)break}return t?s.length:s?o.error(e):q(e,l).slice(0)}function d(e){for(var t=0,n=e.length,r="";n>t;t++)r+=e[t].value;return r}function f(e,t,n){var r=t.dir,i=n&&"parentNode"===r,o=V++;return t.first?function(t,n,o){for(;t=t[r];)if(1===t.nodeType||i)return e(t,n,o)}:function(t,n,a){var s,l,c,u=W+" "+o;if(a){for(;t=t[r];)if((1===t.nodeType||i)&&e(t,n,a))return!0}else for(;t=t[r];)if(1===t.nodeType||i)if(c=t[I]||(t[I]={}),(l=c[r])&&l[0]===u){if((s=l[1])===!0||s===w)return s===!0}else if(l=c[r]=[u],l[1]=e(t,n,a)||w,l[1]===!0)return!0}}function p(e){return e.length>1?function(t,n,r){for(var i=e.length;i--;)if(!e[i](t,n,r))return!1;return!0}:e[0]}function h(e,t,n,r,i){for(var o,a=[],s=0,l=e.length,c=null!=t;l>s;s++)(o=e[s])&&(!n||n(o,r,i))&&(a.push(o),c&&t.push(s));return a}function m(e,t,n,i,o,a){return i&&!i[I]&&(i=m(i)),o&&!o[I]&&(o=m(o,a)),r(function(r,a,s,l){var c,u,d,f=[],p=[],m=a.length,g=r||y(t||"*",s.nodeType?[s]:s,[]),v=!e||!r&&t?g:h(g,f,e,s,l),b=n?o||(r?e:m||i)?[]:a:v;if(n&&n(v,b,s,l),i)for(c=h(b,p),i(c,[],s,l),u=c.length;u--;)(d=c[u])&&(b[p[u]]=!(v[p[u]]=d));if(r){if(o||e){if(o){for(c=[],u=b.length;u--;)(d=b[u])&&c.push(v[u]=d);o(null,b=[],c,l)}for(u=b.length;u--;)(d=b[u])&&(c=o?tt.call(r,d):f[u])>-1&&(r[c]=!(a[c]=d))}}else b=h(b===a?b.splice(m,b.length):b),o?o(null,a,b,l):Z.apply(a,b)})}function g(e){for(var t,n,r,i=e.length,o=_.relative[e[0].type],a=o||_.relative[" "],s=o?1:0,l=f(function(e){return e===t},a,!0),c=f(function(e){return tt.call(t,e)>-1},a,!0),u=[function(e,n,r){return!o&&(r||n!==k)||((t=n).nodeType?l(e,n,r):c(e,n,r))}];i>s;s++)if(n=_.relative[e[s].type])u=[f(p(u),n)];else{if(n=_.filter[e[s].type].apply(null,e[s].matches),n[I]){for(r=++s;i>r&&!_.relative[e[r].type];r++);return m(s>1&&p(u),s>1&&d(e.slice(0,s-1)).replace(lt,"$1"),n,r>s&&g(e.slice(s,r)),i>r&&g(e=e.slice(r)),i>r&&d(e))}u.push(n)}return p(u)}function v(e,t){var n=0,i=t.length>0,a=e.length>0,s=function(r,s,l,c,u){var d,f,p,m=[],g=0,v="0",y=r&&[],b=null!=u,C=k,x=r||a&&_.find.TAG("*",u&&s.parentNode||s),N=W+=null==C?1:Math.random()||.1;for(b&&(k=s!==B&&s,w=n);null!=(d=x[v]);v++){if(a&&d){for(f=0;p=e[f++];)if(p(d,s,l)){c.push(d);break}b&&(W=N,w=++n)}i&&((d=!p&&d)&&g--,r&&y.push(d))}if(g+=v,i&&v!==g){for(f=0;p=t[f++];)p(y,m,s,l);if(r){if(g>0)for(;v--;)y[v]||m[v]||(m[v]=J.call(c));m=h(m)}Z.apply(c,m),b&&!r&&m.length>0&&g+t.length>1&&o.uniqueSort(c)}return b&&(W=N,k=C),y};return i?r(s):s}function y(e,t,n){for(var r=0,i=t.length;i>r;r++)o(e,t[r],n);return n}function b(e,t,n,r){var i,o,a,s,l,c=u(e);if(!r&&1===c.length){if(o=c[0]=c[0].slice(0),o.length>2&&"ID"===(a=o[0]).type&&9===t.nodeType&&L&&_.relative[o[1].type]){if(t=(_.find.ID(a.matches[0].replace(xt,wt),t)||[])[0],!t)return n;e=e.slice(o.shift().value.length)}for(i=pt.needsContext.test(e)?0:o.length;i--&&(a=o[i],!_.relative[s=a.type]);)if((l=_.find[s])&&(r=l(a.matches[0].replace(xt,wt),ht.test(o[0].type)&&t.parentNode||t))){if(o.splice(i,1),e=r.length&&d(o),!e)return Z.apply(n,r),n;break}}return S(e,c)(r,t,!L,n,ht.test(e)),n}function C(){}var x,w,_,N,E,S,k,T,R,A,B,D,L,M,H,P,O,I="sizzle"+-new Date,F=window.document,z={},W=0,V=0,U=n(),q=n(),$=n(),j=!1,K=function(){return 0},G=typeof t,Y=1<<31,X=[],J=X.pop,Q=X.push,Z=X.push,et=X.slice,tt=X.indexOf||function(e){for(var t=0,n=this.length;n>t;t++)if(this[t]===e)return t;return-1},nt="[\\x20\\t\\r\\n\\f]",rt="(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",it=rt.replace("w","w#"),ot="([*^$|!~]?=)",at="\\["+nt+"*("+rt+")"+nt+"*(?:"+ot+nt+"*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|("+it+")|)|)"+nt+"*\\]",st=":("+rt+")(?:\\(((['\"])((?:\\\\.|[^\\\\])*?)\\3|((?:\\\\.|[^\\\\()[\\]]|"+at.replace(3,8)+")*)|.*)\\)|)",lt=new RegExp("^"+nt+"+|((?:^|[^\\\\])(?:\\\\.)*)"+nt+"+$","g"),ct=new RegExp("^"+nt+"*,"+nt+"*"),ut=new RegExp("^"+nt+"*([\\x20\\t\\r\\n\\f>+~])"+nt+"*"),dt=new RegExp(st),ft=new RegExp("^"+it+"$"),pt={ID:new RegExp("^#("+rt+")"),CLASS:new RegExp("^\\.("+rt+")"),NAME:new RegExp("^\\[name=['\"]?("+rt+")['\"]?\\]"),TAG:new RegExp("^("+rt.replace("w","w*")+")"),ATTR:new RegExp("^"+at),PSEUDO:new RegExp("^"+st),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+nt+"*(even|odd|(([+-]|)(\\d*)n|)"+nt+"*(?:([+-]|)"+nt+"*(\\d+)|))"+nt+"*\\)|)","i"),needsContext:new RegExp("^"+nt+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+nt+"*((?:-\\d)?\\d*)"+nt+"*\\)|)(?=[^-]|$)","i")},ht=/[\x20\t\r\n\f]*[+~]/,mt=/^[^{]+\{\s*\[native code/,gt=/^(?:#([\w\-]+)|(\w+)|\.([\w\-]+))$/,vt=/^(?:input|select|textarea|button)$/i,yt=/^h\d$/i,bt=/'|\\/g,Ct=/\=[\x20\t\r\n\f]*([^'"\]]*)[\x20\t\r\n\f]*\]/g,xt=/\\([\da-fA-F]{1,6}[\x20\t\r\n\f]?|.)/g,wt=function(e,t){var n="0x"+t-65536;return n!==n?t:0>n?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320)};try{Z.apply(X=et.call(F.childNodes),F.childNodes),X[F.childNodes.length].nodeType}catch(_t){Z={apply:X.length?function(e,t){Q.apply(e,et.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}E=o.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return t?"HTML"!==t.nodeName:!1},A=o.setDocument=function(n){var r=n?n.ownerDocument||n:F;return r!==B&&9===r.nodeType&&r.documentElement?(B=r,D=r.documentElement,L=!E(r),z.getElementsByTagName=i(function(e){return e.appendChild(r.createComment("")),!e.getElementsByTagName("*").length}),z.attributes=i(function(e){e.innerHTML="<select></select>";var t=typeof e.lastChild.getAttribute("multiple");return"boolean"!==t&&"string"!==t}),z.getElementsByClassName=i(function(e){return e.innerHTML="<div class='hidden e'></div><div class='hidden'></div>",e.getElementsByClassName&&e.getElementsByClassName("e").length?(e.lastChild.className="e",2===e.getElementsByClassName("e").length):!1}),z.getByName=i(function(e){e.id=I+0,e.appendChild(B.createElement("a")).setAttribute("name",I),e.appendChild(B.createElement("i")).setAttribute("name",I),D.appendChild(e);var t=r.getElementsByName&&r.getElementsByName(I).length===2+r.getElementsByName(I+0).length;return D.removeChild(e),t}),z.sortDetached=i(function(e){return e.compareDocumentPosition&&1&e.compareDocumentPosition(B.createElement("div"))}),_.attrHandle=i(function(e){return e.innerHTML="<a href='#'></a>",e.firstChild&&typeof e.firstChild.getAttribute!==G&&"#"===e.firstChild.getAttribute("href")})?{}:{href:function(e){return e.getAttribute("href",2)},type:function(e){return e.getAttribute("type")}},z.getByName?(_.find.ID=function(e,t){if(typeof t.getElementById!==G&&L){var n=t.getElementById(e);return n&&n.parentNode?[n]:[]}},_.filter.ID=function(e){var t=e.replace(xt,wt);return function(e){return e.getAttribute("id")===t}}):(_.find.ID=function(e,n){if(typeof n.getElementById!==G&&L){var r=n.getElementById(e);return r?r.id===e||typeof r.getAttributeNode!==G&&r.getAttributeNode("id").value===e?[r]:t:[]}},_.filter.ID=function(e){var t=e.replace(xt,wt);return function(e){var n=typeof e.getAttributeNode!==G&&e.getAttributeNode("id");return n&&n.value===t}}),_.find.TAG=z.getElementsByTagName?function(e,t){return typeof t.getElementsByTagName!==G?t.getElementsByTagName(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){for(;n=o[i++];)1===n.nodeType&&r.push(n);return r}return o},_.find.NAME=z.getByName&&function(e,t){return typeof t.getElementsByName!==G?t.getElementsByName(name):void 0},_.find.CLASS=z.getElementsByClassName&&function(e,t){return typeof t.getElementsByClassName!==G&&L?t.getElementsByClassName(e):void 0},H=[],M=[":focus"],(z.qsa=e(r.querySelectorAll))&&(i(function(e){e.innerHTML="<select><option selected=''></option></select>",e.querySelectorAll("[selected]").length||M.push("\\["+nt+"*(?:checked|disabled|ismap|multiple|readonly|selected|value)"),e.querySelectorAll(":checked").length||M.push(":checked")}),i(function(e){e.innerHTML="<input type='hidden' i=''/>",e.querySelectorAll("[i^='']").length&&M.push("[*^$]="+nt+"*(?:\"\"|'')"),e.querySelectorAll(":enabled").length||M.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),M.push(",.*:")})),(z.matchesSelector=e(P=D.matchesSelector||D.mozMatchesSelector||D.webkitMatchesSelector||D.oMatchesSelector||D.msMatchesSelector))&&i(function(e){z.disconnectedMatch=P.call(e,"div"),P.call(e,"[s!='']:x"),H.push("!=",st)}),M=new RegExp(M.join("|")),H=H.length&&new RegExp(H.join("|")),O=e(D.contains)||D.compareDocumentPosition?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},K=D.compareDocumentPosition?function(e,t){if(e===t)return j=!0,0;var n=t.compareDocumentPosition&&e.compareDocumentPosition&&e.compareDocumentPosition(t);return n?1&n||T&&t.compareDocumentPosition(e)===n?e===r||O(F,e)?-1:t===r||O(F,t)?1:R?tt.call(R,e)-tt.call(R,t):0:4&n?-1:1:e.compareDocumentPosition?-1:1}:function(e,t){var n,i=0,o=e.parentNode,s=t.parentNode,l=[e],c=[t];if(e===t)return j=!0,0;if(!o||!s)return e===r?-1:t===r?1:o?-1:s?1:0;if(o===s)return a(e,t);for(n=e;n=n.parentNode;)l.unshift(n);for(n=t;n=n.parentNode;)c.unshift(n);for(;l[i]===c[i];)i++;return i?a(l[i],c[i]):l[i]===F?-1:c[i]===F?1:0},B):B},o.matches=function(e,t){return o(e,null,null,t)},o.matchesSelector=function(e,t){if((e.ownerDocument||e)!==B&&A(e),t=t.replace(Ct,"='$1']"),z.matchesSelector&&L&&(!H||!H.test(t))&&!M.test(t))try{var n=P.call(e,t);if(n||z.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(r){}return o(t,B,null,[e]).length>0},o.contains=function(e,t){return(e.ownerDocument||e)!==B&&A(e),O(e,t)},o.attr=function(e,t){var n;return(e.ownerDocument||e)!==B&&A(e),L&&(t=t.toLowerCase()),(n=_.attrHandle[t])?n(e):!L||z.attributes?e.getAttribute(t):((n=e.getAttributeNode(t))||e.getAttribute(t))&&e[t]===!0?t:n&&n.specified?n.value:null},o.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},o.uniqueSort=function(e){var t,n=[],r=0,i=0;if(j=!z.detectDuplicates,T=!z.sortDetached,R=!z.sortStable&&e.slice(0),e.sort(K),j){for(;t=e[i++];)t===e[i]&&(r=n.push(i));for(;r--;)e.splice(n[r],1)}return e},N=o.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=N(e)}else if(3===i||4===i)return e.nodeValue}else for(;t=e[r];r++)n+=N(t);return n},_=o.selectors={cacheLength:50,createPseudo:r,match:pt,find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(xt,wt),e[3]=(e[4]||e[5]||"").replace(xt,wt),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||o.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&o.error(e[0]),e},PSEUDO:function(e){var t,n=!e[5]&&e[2];return pt.CHILD.test(e[0])?null:(e[4]?e[2]=e[4]:n&&dt.test(n)&&(t=u(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){return"*"===e?function(){return!0}:(e=e.replace(xt,wt).toLowerCase(),function(t){return t.nodeName&&t.nodeName.toLowerCase()===e})},CLASS:function(e){var t=U[e+" "];return t||(t=new RegExp("(^|"+nt+")"+e+"("+nt+"|$)"))&&U(e,function(e){return t.test(e.className||typeof e.getAttribute!==G&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=o.attr(r,e);return null==i?"!="===t:t?(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i+" ").indexOf(n)>-1:"|="===t?i===n||i.slice(0,n.length+1)===n+"-":!1):!0}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,l){var c,u,d,f,p,h,m=o!==a?"nextSibling":"previousSibling",g=t.parentNode,v=s&&t.nodeName.toLowerCase(),y=!l&&!s;if(g){if(o){for(;m;){for(d=t;d=d[m];)if(s?d.nodeName.toLowerCase()===v:1===d.nodeType)return!1;h=m="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?g.firstChild:g.lastChild],a&&y){for(u=g[I]||(g[I]={}),c=u[e]||[],p=c[0]===W&&c[1],f=c[0]===W&&c[2],d=p&&g.childNodes[p];d=++p&&d&&d[m]||(f=p=0)||h.pop();)if(1===d.nodeType&&++f&&d===t){u[e]=[W,p,f];break}}else if(y&&(c=(t[I]||(t[I]={}))[e])&&c[0]===W)f=c[1];else for(;(d=++p&&d&&d[m]||(f=p=0)||h.pop())&&((s?d.nodeName.toLowerCase()!==v:1!==d.nodeType)||!++f||(y&&((d[I]||(d[I]={}))[e]=[W,f]),d!==t)););return f-=i,f===r||f%r===0&&f/r>=0}}},PSEUDO:function(e,t){var n,i=_.pseudos[e]||_.setFilters[e.toLowerCase()]||o.error("unsupported pseudo: "+e);return i[I]?i(t):i.length>1?(n=[e,e,"",t],_.setFilters.hasOwnProperty(e.toLowerCase())?r(function(e,n){for(var r,o=i(e,t),a=o.length;a--;)r=tt.call(e,o[a]),e[r]=!(n[r]=o[a])}):function(e){return i(e,0,n)}):i}},pseudos:{not:r(function(e){var t=[],n=[],i=S(e.replace(lt,"$1"));return i[I]?r(function(e,t,n,r){for(var o,a=i(e,null,r,[]),s=e.length;s--;)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,r,o){return t[0]=e,i(t,null,o,n),!n.pop()}}),has:r(function(e){return function(t){return o(e,t).length>0}}),contains:r(function(e){return function(t){return(t.textContent||t.innerText||N(t)).indexOf(e)>-1}}),lang:r(function(e){return ft.test(e||"")||o.error("unsupported lang: "+e),e=e.replace(xt,wt).toLowerCase(),function(t){var n;do if(n=L?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(e){var t=window.location&&window.location.hash;return t&&t.slice(1)===e.id},root:function(e){return e===D},focus:function(e){return e===B.activeElement&&(!B.hasFocus||B.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:function(e){return e.disabled===!1},disabled:function(e){return e.disabled===!0},checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeName>"@"||3===e.nodeType||4===e.nodeType)return!1;return!0},parent:function(e){return!_.pseudos.empty(e)},header:function(e){return yt.test(e.nodeName)},input:function(e){return vt.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||t.toLowerCase()===e.type)},first:c(function(){return[0]}),last:c(function(e,t){return[t-1]}),eq:c(function(e,t,n){return[0>n?n+t:n]}),even:c(function(e,t){for(var n=0;t>n;n+=2)e.push(n);return e}),odd:c(function(e,t){for(var n=1;t>n;n+=2)e.push(n);return e}),lt:c(function(e,t,n){for(var r=0>n?n+t:n;--r>=0;)e.push(r);return e}),gt:c(function(e,t,n){for(var r=0>n?n+t:n;++r<t;)e.push(r);return e})}};for(x in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})_.pseudos[x]=s(x);for(x in{submit:!0,reset:!0})_.pseudos[x]=l(x);return S=o.compile=function(e,t){var n,r=[],i=[],o=$[e+" "];if(!o){for(t||(t=u(e)),n=t.length;n--;)o=g(t[n]),o[I]?r.push(o):i.push(o);o=$(e,v(i,r))}return o},_.pseudos.nth=_.pseudos.eq,C.prototype=_.filters=_.pseudos,_.setFilters=new C,z.sortStable=I.split("").sort(K).join("")===I,A(),[0,0].sort(K),z.detectDuplicates=j,o}),r(u,[l,c],function(e,n){function r(e){return"undefined"!=typeof e}function i(e){return"string"==typeof e}function o(e){var t,n,r;for(r=v.createElement("div"),t=v.createDocumentFragment(),r.innerHTML=e;n=r.firstChild;)t.appendChild(n);return t}function a(e,t,n){var r;if("string"==typeof t)t=o(t);else if(t.length){for(r=0;r<t.length;r++)a(e,t[r],n);return e}for(r=e.length;r--;)n.call(e[r],t.parentNode?t:t);return e}function s(e,t){return e&&t&&-1!==(" "+e.className+" ").indexOf(" "+t+" ")}function l(e,t){var n;for(e=e||[],"string"==typeof e&&(e=e.split(" ")),t=t||{},n=e.length;n--;)t[e[n]]={};return t}function c(e,t){return new c.fn.init(e,t)}function u(e){var t=arguments,n,r,i;for(r=1;r<t.length;r++){n=t[r];for(i in n)e[i]=n[i]}return e}function d(e){var t=[],n,r;for(n=0,r=e.length;r>n;n++)t[n]=e[n];return t}function f(e,t){var n;if(t.indexOf)return t.indexOf(e);for(n=t.length;n--;)if(t[n]===e)return n;return-1}function p(e){return null===e||e===t?"":(""+e).replace(N,"")}function h(e,t){var n,r,i,o,a;if(e)if(n=e.length,n===o){for(r in e)if(e.hasOwnProperty(r)&&(a=e[r],t.call(a,a,r)===!1))break}else for(i=0;n>i&&(a=e[i],t.call(a,a,r)!==!1);i++);return e}function m(e,n,r){for(var i=[],o=e[n];o&&9!==o.nodeType&&(r===t||1!==o.nodeType||!c(o).is(r));)1===o.nodeType&&i.push(o),o=o[n];return i}function g(e,t,n,r){for(var i=[];e;e=e[n])r&&e.nodeType!==r||e===t||i.push(e);return i}var v=document,y=Array.prototype.push,b=Array.prototype.slice,C=/^(?:[^#<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/,x=e.Event,w=l("fillOpacity fontWeight lineHeight opacity orphans widows zIndex zoom"),_=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)},N=/^\s*|\s*$/g;return c.fn=c.prototype={constructor:c,selector:"",length:0,init:function(e,t){var n=this,r,a;if(!e)return n;if(e.nodeType)return n.context=n[0]=e,n.length=1,n;if(i(e)){if(r="<"===e.charAt(0)&&">"===e.charAt(e.length-1)&&e.length>=3?[null,e,null]:C.exec(e),!r)return c(t||document).find(e);if(r[1])for(a=o(e).firstChild;a;)this.add(a),a=a.nextSibling;else{if(a=v.getElementById(r[2]),a.id!==r[2])return n.find(e);n.length=1,n[0]=a}}else this.add(e);return n},toArray:function(){return d(this)},add:function(e){var t=this;return _(e)?y.apply(t,e):e instanceof c?t.add(e.toArray()):y.call(t,e),t},attr:function(e,n){var i=this;if("object"==typeof e)h(e,function(e,t){i.attr(t,e)});else{if(!r(n))return i[0]&&1===i[0].nodeType?i[0].getAttribute(e):t;this.each(function(){1===this.nodeType&&this.setAttribute(e,n)})}return i},css:function(e,n){var i=this;if("object"==typeof e)h(e,function(e,t){i.css(t,e)});else{if(e=e.replace(/-(\D)/g,function(e,t){return t.toUpperCase()}),!r(n))return i[0]?i[0].style[e]:t;"number"!=typeof n||w[e]||(n+="px"),i.each(function(){var t=this.style;"opacity"===e&&this.runtimeStyle&&"undefined"==typeof this.runtimeStyle.opacity&&(t.filter=""===n?"":"alpha(opacity="+100*n+")");try{t[e]=n}catch(r){}})}return i},remove:function(){for(var e=this,t,n=this.length;n--;)t=e[n],x.clean(t),t.parentNode&&t.parentNode.removeChild(t);return this},empty:function(){for(var e=this,t,n=this.length;n--;)for(t=e[n];t.firstChild;)t.removeChild(t.firstChild);return this},html:function(e){var t=this,n;if(r(e)){for(n=t.length;n--;)t[n].innerHTML=e;return t}return t[0]?t[0].innerHTML:""},text:function(e){var t=this,n;if(r(e)){for(n=t.length;n--;)t[n].innerText=t[0].textContent=e;return t}return t[0]?t[0].innerText||t[0].textContent:""},append:function(){return a(this,arguments,function(e){1===this.nodeType&&this.appendChild(e)})},prepend:function(){return a(this,arguments,function(e){1===this.nodeType&&this.insertBefore(e,this.firstChild)})},before:function(){var e=this;return e[0]&&e[0].parentNode?a(e,arguments,function(e){this.parentNode.insertBefore(e,this.nextSibling)}):e},after:function(){var e=this;return e[0]&&e[0].parentNode?a(e,arguments,function(e){this.parentNode.insertBefore(e,this)}):e},appendTo:function(e){return c(e).append(this),this},addClass:function(e){return this.toggleClass(e,!0)},removeClass:function(e){return this.toggleClass(e,!1)},toggleClass:function(e,t){var n=this;return-1!==e.indexOf(" ")?h(e.split(" "),function(){n.toggleClass(this,t)}):n.each(function(n){var r;s(n,e)!==t&&(r=n.className,t?n.className+=r?" "+e:e:n.className=p((" "+r+" ").replace(" "+e+" "," ")))}),n},hasClass:function(e){return s(this[0],e)},each:function(e){return h(this,e)},on:function(e,t){return this.each(function(){x.bind(this,e,t)})},off:function(e,t){return this.each(function(){x.unbind(this,e,t)})},show:function(){return this.css("display","")},hide:function(){return this.css("display","none")},slice:function(){return new c(b.apply(this,arguments))},eq:function(e){return-1===e?this.slice(e):this.slice(e,+e+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},replaceWith:function(e){var t=this;return t[0]&&t[0].parentNode.replaceChild(c(e)[0],t[0]),t},wrap:function(e){return e=c(e)[0],this.each(function(){var t=this,n=e.cloneNode(!1);t.parentNode.insertBefore(n,t),n.appendChild(t)})},unwrap:function(){return this.each(function(){for(var e=this,t=e.firstChild,n;t;)n=t,t=t.nextSibling,e.parentNode.insertBefore(n,e)})},clone:function(){var e=[];return this.each(function(){e.push(this.cloneNode(!0))}),c(e)},find:function(e){var t,n,r=[];for(t=0,n=this.length;n>t;t++)c.find(e,this[t],r);return c(r)},push:y,sort:[].sort,splice:[].splice},u(c,{extend:u,toArray:d,inArray:f,isArray:_,each:h,trim:p,makeMap:l,find:n,expr:n.selectors,unique:n.uniqueSort,text:n.getText,isXMLDoc:n.isXML,contains:n.contains,filter:function(e,t,n){return n&&(e=":not("+e+")"),t=1===t.length?c.find.matchesSelector(t[0],e)?[t[0]]:[]:c.find.matches(e,t)}}),h({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return m(e,"parentNode")},parentsUntil:function(e,t){return m(e,"parentNode",t)},next:function(e){return g(e,"nextSibling",1)},prev:function(e){return g(e,"previousSibling",1)},nextNodes:function(e){return g(e,"nextSibling")},prevNodes:function(e){return g(e,"previousSibling")},children:function(e){return g(e.firstChild,"nextSibling",1)},contents:function(e){return d(("iframe"===e.nodeName?e.contentDocument||e.contentWindow.document:e).childNodes)}},function(e,t){c.fn[e]=function(n){var r=this,i;if(r.length>1)throw new Error("DomQuery only supports traverse functions on a single node.");return r[0]&&(i=t(r[0],n)),i=c(i),n&&"parentsUntil"!==e?i.filter(n):i}}),c.fn.filter=function(e){return c.filter(e)},c.fn.is=function(e){return!!e&&this.filter(e).length>0},c.fn.init.prototype=c.fn,c}),r(d,[],function(){return function(e,t){function n(e,t,n,r){function i(e){return e=parseInt(e,10).toString(16),e.length>1?e:"0"+e
+}return"#"+i(t)+i(n)+i(r)}var r=/rgb\s*\(\s*([0-9]+)\s*,\s*([0-9]+)\s*,\s*([0-9]+)\s*\)/gi,i=/(?:url(?:(?:\(\s*\"([^\"]+)\"\s*\))|(?:\(\s*\'([^\']+)\'\s*\))|(?:\(\s*([^)\s]+)\s*\))))|(?:\'([^\']+)\')|(?:\"([^\"]+)\")/gi,o=/\s*([^:]+):\s*([^;]+);?/g,a=/\s+$/,s,l,c={},u,d="\ufeff";for(e=e||{},u=("\\\" \\' \\; \\: ; : "+d).split(" "),l=0;l<u.length;l++)c[u[l]]=d+l,c[d+l]=u[l];return{toHex:function(e){return e.replace(r,n)},parse:function(t){function s(e,t,n){var r,i,o,a;if(r=m[e+"-top"+t],r&&(i=m[e+"-right"+t],i&&(o=m[e+"-bottom"+t],o&&(a=m[e+"-left"+t])))){var s=[r,i,o,a];for(l=s.length-1;l--&&s[l]===s[l+1];);l>-1&&n||(m[e+t]=-1==l?s[0]:s.join(" "),delete m[e+"-top"+t],delete m[e+"-right"+t],delete m[e+"-bottom"+t],delete m[e+"-left"+t])}}function u(e){var t=m[e],n;if(t){for(t=t.split(" "),n=t.length;n--;)if(t[n]!==t[0])return!1;return m[e]=t[0],!0}}function d(e,t,n,r){u(t)&&u(n)&&u(r)&&(m[e]=m[t]+" "+m[n]+" "+m[r],delete m[t],delete m[n],delete m[r])}function f(e){return b=!0,c[e]}function p(e,t){return b&&(e=e.replace(/\uFEFF[0-9]/g,function(e){return c[e]})),t||(e=e.replace(/\\([\'\";:])/g,"$1")),e}function h(t,n,r,i,o,a){if(o=o||a)return o=p(o),"'"+o.replace(/\'/g,"\\'")+"'";if(n=p(n||r||i),!e.allow_script_urls){var s=n.replace(/[\s\r\n]+/,"");if(/(java|vb)script:/i.test(s))return"";if(!e.allow_svg_data_urls&&/^data:image\/svg/i.test(s))return""}return C&&(n=C.call(x,n,"style")),"url('"+n.replace(/\'/g,"\\'")+"')"}var m={},g,v,y,b,C=e.url_converter,x=e.url_converter_scope||this;if(t){for(t=t.replace(/[\u0000-\u001F]/g,""),t=t.replace(/\\[\"\';:\uFEFF]/g,f).replace(/\"[^\"]+\"|\'[^\']+\'/g,function(e){return e.replace(/[;:]/g,f)});g=o.exec(t);){if(v=g[1].replace(a,"").toLowerCase(),y=g[2].replace(a,""),y=y.replace(/\\[0-9a-f]+/g,function(e){return String.fromCharCode(parseInt(e.substr(1),16))}),v&&y.length>0){if(!e.allow_script_urls&&("behavior"==v||/expression\s*\(|\/\*|\*\//.test(y)))continue;"font-weight"===v&&"700"===y?y="bold":("color"===v||"background-color"===v)&&(y=y.toLowerCase()),y=y.replace(r,n),y=y.replace(i,h),m[v]=b?p(y,!0):y}o.lastIndex=g.index+g[0].length}s("border","",!0),s("border","-width"),s("border","-color"),s("border","-style"),s("padding",""),s("margin",""),d("border","border-width","border-style","border-color"),"medium none"===m.border&&delete m.border,"none"===m["border-image"]&&delete m["border-image"]}return m},serialize:function(e,n){function r(n){var r,o,a,l;if(r=t.styles[n])for(o=0,a=r.length;a>o;o++)n=r[o],l=e[n],l!==s&&l.length>0&&(i+=(i.length>0?" ":"")+n+": "+l+";")}var i="",o,a;if(n&&t&&t.styles)r("*"),r(n);else for(o in e)a=e[o],a!==s&&a.length>0&&(i+=(i.length>0?" ":"")+o+": "+a+";");return i}}}}),r(f,[],function(){return function(e,t){function n(e,n,r,i){var o,a;if(e){if(!i&&e[n])return e[n];if(e!=t){if(o=e[r])return o;for(a=e.parentNode;a&&a!=t;a=a.parentNode)if(o=a[r])return o}}}var r=e;this.current=function(){return r},this.next=function(e){return r=n(r,"firstChild","nextSibling",e)},this.prev=function(e){return r=n(r,"lastChild","previousSibling",e)}}}),r(p,[],function(){function e(e){return null===e||e===t?"":(""+e).replace(m,"")}function n(e,n){return n?"array"==n&&g(e)?!0:typeof e==n:e!==t}function r(e){var t=[],n,r;for(n=0,r=e.length;r>n;n++)t[n]=e[n];return t}function i(e,t,n){var r;for(e=e||[],t=t||",","string"==typeof e&&(e=e.split(t)),n=n||{},r=e.length;r--;)n[e[r]]={};return n}function o(e,n,r){var i,o;if(!e)return 0;if(r=r||e,e.length!==t){for(i=0,o=e.length;o>i;i++)if(n.call(r,e[i],i,e)===!1)return 0}else for(i in e)if(e.hasOwnProperty(i)&&n.call(r,e[i],i,e)===!1)return 0;return 1}function a(e,t){var n=[];return o(e,function(e){n.push(t(e))}),n}function s(e,t){var n=[];return o(e,function(e){(!t||t(e))&&n.push(e)}),n}function l(e,t,n){var r=this,i,o,a,s,l,c=0;if(e=/^((static) )?([\w.]+)(:([\w.]+))?/.exec(e),a=e[3].match(/(^|\.)(\w+)$/i)[2],o=r.createNS(e[3].replace(/\.\w+$/,""),n),!o[a]){if("static"==e[2])return o[a]=t,void(this.onCreate&&this.onCreate(e[2],e[3],o[a]));t[a]||(t[a]=function(){},c=1),o[a]=t[a],r.extend(o[a].prototype,t),e[5]&&(i=r.resolve(e[5]).prototype,s=e[5].match(/\.(\w+)$/i)[1],l=o[a],o[a]=c?function(){return i[s].apply(this,arguments)}:function(){return this.parent=i[s],l.apply(this,arguments)},o[a].prototype[a]=o[a],r.each(i,function(e,t){o[a].prototype[t]=i[t]}),r.each(t,function(e,t){i[t]?o[a].prototype[t]=function(){return this.parent=i[t],e.apply(this,arguments)}:t!=a&&(o[a].prototype[t]=e)})),r.each(t["static"],function(e,t){o[a][t]=e})}}function c(e,t){var n,r;if(e)for(n=0,r=e.length;r>n;n++)if(e[n]===t)return n;return-1}function u(e,n){var r,i,o,a=arguments,s;for(r=1,i=a.length;i>r;r++){n=a[r];for(o in n)n.hasOwnProperty(o)&&(s=n[o],s!==t&&(e[o]=s))}return e}function d(e,t,n,r){r=r||this,e&&(n&&(e=e[n]),o(e,function(e,i){return t.call(r,e,i,n)===!1?!1:void d(e,t,n,r)}))}function f(e,t){var n,r;for(t=t||window,e=e.split("."),n=0;n<e.length;n++)r=e[n],t[r]||(t[r]={}),t=t[r];return t}function p(e,t){var n,r;for(t=t||window,e=e.split("."),n=0,r=e.length;r>n&&(t=t[e[n]],t);n++);return t}function h(t,r){return!t||n(t,"array")?t:a(t.split(r||","),e)}var m=/^\s*|\s*$/g,g=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)};return{trim:e,isArray:g,is:n,toArray:r,makeMap:i,each:o,map:a,grep:s,inArray:c,extend:u,create:l,walk:d,createNS:f,resolve:p,explode:h}}),r(h,[p],function(e){function t(n){function r(){return H.createDocumentFragment()}function i(e,t){_(F,e,t)}function o(e,t){_(z,e,t)}function a(e){i(e.parentNode,j(e))}function s(e){i(e.parentNode,j(e)+1)}function l(e){o(e.parentNode,j(e))}function c(e){o(e.parentNode,j(e)+1)}function u(e){e?(M[U]=M[V],M[q]=M[W]):(M[V]=M[U],M[W]=M[q]),M.collapsed=F}function d(e){a(e),c(e)}function f(e){i(e,0),o(e,1===e.nodeType?e.childNodes.length:e.nodeValue.length)}function p(e,t){var n=M[V],r=M[W],i=M[U],o=M[q],a=t.startContainer,s=t.startOffset,l=t.endContainer,c=t.endOffset;return 0===e?w(n,r,a,s):1===e?w(i,o,a,s):2===e?w(i,o,l,c):3===e?w(n,r,l,c):void 0}function h(){N(I)}function m(){return N(P)}function g(){return N(O)}function v(e){var t=this[V],r=this[W],i,o;3!==t.nodeType&&4!==t.nodeType||!t.nodeValue?(t.childNodes.length>0&&(o=t.childNodes[r]),o?t.insertBefore(e,o):3==t.nodeType?n.insertAfter(e,t):t.appendChild(e)):r?r>=t.nodeValue.length?n.insertAfter(e,t):(i=t.splitText(r),t.parentNode.insertBefore(e,i)):t.parentNode.insertBefore(e,t)}function y(e){var t=M.extractContents();M.insertNode(e),e.appendChild(t),M.selectNode(e)}function b(){return $(new t(n),{startContainer:M[V],startOffset:M[W],endContainer:M[U],endOffset:M[q],collapsed:M.collapsed,commonAncestorContainer:M.commonAncestorContainer})}function C(e,t){var n;if(3==e.nodeType)return e;if(0>t)return e;for(n=e.firstChild;n&&t>0;)--t,n=n.nextSibling;return n?n:e}function x(){return M[V]==M[U]&&M[W]==M[q]}function w(e,t,r,i){var o,a,s,l,c,u;if(e==r)return t==i?0:i>t?-1:1;for(o=r;o&&o.parentNode!=e;)o=o.parentNode;if(o){for(a=0,s=e.firstChild;s!=o&&t>a;)a++,s=s.nextSibling;return a>=t?-1:1}for(o=e;o&&o.parentNode!=r;)o=o.parentNode;if(o){for(a=0,s=r.firstChild;s!=o&&i>a;)a++,s=s.nextSibling;return i>a?-1:1}for(l=n.findCommonAncestor(e,r),c=e;c&&c.parentNode!=l;)c=c.parentNode;for(c||(c=l),u=r;u&&u.parentNode!=l;)u=u.parentNode;if(u||(u=l),c==u)return 0;for(s=l.firstChild;s;){if(s==c)return-1;if(s==u)return 1;s=s.nextSibling}}function _(e,t,r){var i,o;for(e?(M[V]=t,M[W]=r):(M[U]=t,M[q]=r),i=M[U];i.parentNode;)i=i.parentNode;for(o=M[V];o.parentNode;)o=o.parentNode;o==i?w(M[V],M[W],M[U],M[q])>0&&M.collapse(e):M.collapse(e),M.collapsed=x(),M.commonAncestorContainer=n.findCommonAncestor(M[V],M[U])}function N(e){var t,n=0,r=0,i,o,a,s,l,c;if(M[V]==M[U])return E(e);for(t=M[U],i=t.parentNode;i;t=i,i=i.parentNode){if(i==M[V])return S(t,e);++n}for(t=M[V],i=t.parentNode;i;t=i,i=i.parentNode){if(i==M[U])return k(t,e);++r}for(o=r-n,a=M[V];o>0;)a=a.parentNode,o--;for(s=M[U];0>o;)s=s.parentNode,o++;for(l=a.parentNode,c=s.parentNode;l!=c;l=l.parentNode,c=c.parentNode)a=l,s=c;return T(a,s,e)}function E(e){var t,n,i,o,a,s,l,c,u;if(e!=I&&(t=r()),M[W]==M[q])return t;if(3==M[V].nodeType){if(n=M[V].nodeValue,i=n.substring(M[W],M[q]),e!=O&&(o=M[V],c=M[W],u=M[q]-M[W],0===c&&u>=o.nodeValue.length-1?o.parentNode.removeChild(o):o.deleteData(c,u),M.collapse(F)),e==I)return;return i.length>0&&t.appendChild(H.createTextNode(i)),t}for(o=C(M[V],M[W]),a=M[q]-M[W];o&&a>0;)s=o.nextSibling,l=D(o,e),t&&t.appendChild(l),--a,o=s;return e!=O&&M.collapse(F),t}function S(e,t){var n,i,o,a,s,l;if(t!=I&&(n=r()),i=R(e,t),n&&n.appendChild(i),o=j(e),a=o-M[W],0>=a)return t!=O&&(M.setEndBefore(e),M.collapse(z)),n;for(i=e.previousSibling;a>0;)s=i.previousSibling,l=D(i,t),n&&n.insertBefore(l,n.firstChild),--a,i=s;return t!=O&&(M.setEndBefore(e),M.collapse(z)),n}function k(e,t){var n,i,o,a,s,l;for(t!=I&&(n=r()),o=A(e,t),n&&n.appendChild(o),i=j(e),++i,a=M[q]-i,o=e.nextSibling;o&&a>0;)s=o.nextSibling,l=D(o,t),n&&n.appendChild(l),--a,o=s;return t!=O&&(M.setStartAfter(e),M.collapse(F)),n}function T(e,t,n){var i,o,a,s,l,c,u;for(n!=I&&(o=r()),i=A(e,n),o&&o.appendChild(i),a=j(e),s=j(t),++a,l=s-a,c=e.nextSibling;l>0;)u=c.nextSibling,i=D(c,n),o&&o.appendChild(i),c=u,--l;return i=R(t,n),o&&o.appendChild(i),n!=O&&(M.setStartAfter(e),M.collapse(F)),o}function R(e,t){var n=C(M[U],M[q]-1),r,i,o,a,s,l=n!=M[U];if(n==e)return B(n,l,z,t);for(r=n.parentNode,i=B(r,z,z,t);r;){for(;n;)o=n.previousSibling,a=B(n,l,z,t),t!=I&&i.insertBefore(a,i.firstChild),l=F,n=o;if(r==e)return i;n=r.previousSibling,r=r.parentNode,s=B(r,z,z,t),t!=I&&s.appendChild(i),i=s}}function A(e,t){var n=C(M[V],M[W]),r=n!=M[V],i,o,a,s,l;if(n==e)return B(n,r,F,t);for(i=n.parentNode,o=B(i,z,F,t);i;){for(;n;)a=n.nextSibling,s=B(n,r,F,t),t!=I&&o.appendChild(s),r=F,n=a;if(i==e)return o;n=i.nextSibling,i=i.parentNode,l=B(i,z,F,t),t!=I&&l.appendChild(o),o=l}}function B(e,t,r,i){var o,a,s,l,c;if(t)return D(e,i);if(3==e.nodeType){if(o=e.nodeValue,r?(l=M[W],a=o.substring(l),s=o.substring(0,l)):(l=M[q],a=o.substring(0,l),s=o.substring(l)),i!=O&&(e.nodeValue=s),i==I)return;return c=n.clone(e,z),c.nodeValue=a,c}if(i!=I)return n.clone(e,z)}function D(e,t){return t!=I?t==O?n.clone(e,F):e:void e.parentNode.removeChild(e)}function L(){return n.create("body",null,g()).outerText}var M=this,H=n.doc,P=0,O=1,I=2,F=!0,z=!1,W="startOffset",V="startContainer",U="endContainer",q="endOffset",$=e.extend,j=n.nodeIndex;return $(M,{startContainer:H,startOffset:0,endContainer:H,endOffset:0,collapsed:F,commonAncestorContainer:H,START_TO_START:0,START_TO_END:1,END_TO_END:2,END_TO_START:3,setStart:i,setEnd:o,setStartBefore:a,setStartAfter:s,setEndBefore:l,setEndAfter:c,collapse:u,selectNode:d,selectNodeContents:f,compareBoundaryPoints:p,deleteContents:h,extractContents:m,cloneContents:g,insertNode:v,surroundContents:y,cloneRange:b,toStringIE:L}),M}return t.prototype.toString=function(){return this.toStringIE()},t}),r(m,[p],function(e){function t(e){var t;return t=document.createElement("div"),t.innerHTML=e,t.textContent||t.innerText||e}function n(e,t){var n,r,i,a={};if(e){for(e=e.split(","),t=t||10,n=0;n<e.length;n+=2)r=String.fromCharCode(parseInt(e[n],t)),o[r]||(i="&"+e[n+1]+";",a[r]=i,a[i]=r);return a}}var r=e.makeMap,i,o,a,s=/[&<>\"\u0060\u007E-\uD7FF\uE000-\uFFEF]|[\uD800-\uDBFF][\uDC00-\uDFFF]/g,l=/[<>&\u007E-\uD7FF\uE000-\uFFEF]|[\uD800-\uDBFF][\uDC00-\uDFFF]/g,c=/[<>&\"\']/g,u=/&(#x|#)?([\w]+);/g,d={128:"\u20ac",130:"\u201a",131:"\u0192",132:"\u201e",133:"\u2026",134:"\u2020",135:"\u2021",136:"\u02c6",137:"\u2030",138:"\u0160",139:"\u2039",140:"\u0152",142:"\u017d",145:"\u2018",146:"\u2019",147:"\u201c",148:"\u201d",149:"\u2022",150:"\u2013",151:"\u2014",152:"\u02dc",153:"\u2122",154:"\u0161",155:"\u203a",156:"\u0153",158:"\u017e",159:"\u0178"};o={'"':"&quot;","'":"&#39;","<":"&lt;",">":"&gt;","&":"&amp;","`":"&#96;"},a={"&lt;":"<","&gt;":">","&amp;":"&","&quot;":'"',"&apos;":"'"},i=n("50,nbsp,51,iexcl,52,cent,53,pound,54,curren,55,yen,56,brvbar,57,sect,58,uml,59,copy,5a,ordf,5b,laquo,5c,not,5d,shy,5e,reg,5f,macr,5g,deg,5h,plusmn,5i,sup2,5j,sup3,5k,acute,5l,micro,5m,para,5n,middot,5o,cedil,5p,sup1,5q,ordm,5r,raquo,5s,frac14,5t,frac12,5u,frac34,5v,iquest,60,Agrave,61,Aacute,62,Acirc,63,Atilde,64,Auml,65,Aring,66,AElig,67,Ccedil,68,Egrave,69,Eacute,6a,Ecirc,6b,Euml,6c,Igrave,6d,Iacute,6e,Icirc,6f,Iuml,6g,ETH,6h,Ntilde,6i,Ograve,6j,Oacute,6k,Ocirc,6l,Otilde,6m,Ouml,6n,times,6o,Oslash,6p,Ugrave,6q,Uacute,6r,Ucirc,6s,Uuml,6t,Yacute,6u,THORN,6v,szlig,70,agrave,71,aacute,72,acirc,73,atilde,74,auml,75,aring,76,aelig,77,ccedil,78,egrave,79,eacute,7a,ecirc,7b,euml,7c,igrave,7d,iacute,7e,icirc,7f,iuml,7g,eth,7h,ntilde,7i,ograve,7j,oacute,7k,ocirc,7l,otilde,7m,ouml,7n,divide,7o,oslash,7p,ugrave,7q,uacute,7r,ucirc,7s,uuml,7t,yacute,7u,thorn,7v,yuml,ci,fnof,sh,Alpha,si,Beta,sj,Gamma,sk,Delta,sl,Epsilon,sm,Zeta,sn,Eta,so,Theta,sp,Iota,sq,Kappa,sr,Lambda,ss,Mu,st,Nu,su,Xi,sv,Omicron,t0,Pi,t1,Rho,t3,Sigma,t4,Tau,t5,Upsilon,t6,Phi,t7,Chi,t8,Psi,t9,Omega,th,alpha,ti,beta,tj,gamma,tk,delta,tl,epsilon,tm,zeta,tn,eta,to,theta,tp,iota,tq,kappa,tr,lambda,ts,mu,tt,nu,tu,xi,tv,omicron,u0,pi,u1,rho,u2,sigmaf,u3,sigma,u4,tau,u5,upsilon,u6,phi,u7,chi,u8,psi,u9,omega,uh,thetasym,ui,upsih,um,piv,812,bull,816,hellip,81i,prime,81j,Prime,81u,oline,824,frasl,88o,weierp,88h,image,88s,real,892,trade,89l,alefsym,8cg,larr,8ch,uarr,8ci,rarr,8cj,darr,8ck,harr,8dl,crarr,8eg,lArr,8eh,uArr,8ei,rArr,8ej,dArr,8ek,hArr,8g0,forall,8g2,part,8g3,exist,8g5,empty,8g7,nabla,8g8,isin,8g9,notin,8gb,ni,8gf,prod,8gh,sum,8gi,minus,8gn,lowast,8gq,radic,8gt,prop,8gu,infin,8h0,ang,8h7,and,8h8,or,8h9,cap,8ha,cup,8hb,int,8hk,there4,8hs,sim,8i5,cong,8i8,asymp,8j0,ne,8j1,equiv,8j4,le,8j5,ge,8k2,sub,8k3,sup,8k4,nsub,8k6,sube,8k7,supe,8kl,oplus,8kn,otimes,8l5,perp,8m5,sdot,8o8,lceil,8o9,rceil,8oa,lfloor,8ob,rfloor,8p9,lang,8pa,rang,9ea,loz,9j0,spades,9j3,clubs,9j5,hearts,9j6,diams,ai,OElig,aj,oelig,b0,Scaron,b1,scaron,bo,Yuml,m6,circ,ms,tilde,802,ensp,803,emsp,809,thinsp,80c,zwnj,80d,zwj,80e,lrm,80f,rlm,80j,ndash,80k,mdash,80o,lsquo,80p,rsquo,80q,sbquo,80s,ldquo,80t,rdquo,80u,bdquo,810,dagger,811,Dagger,81g,permil,81p,lsaquo,81q,rsaquo,85c,euro",32);var f={encodeRaw:function(e,t){return e.replace(t?s:l,function(e){return o[e]||e})},encodeAllRaw:function(e){return(""+e).replace(c,function(e){return o[e]||e})},encodeNumeric:function(e,t){return e.replace(t?s:l,function(e){return e.length>1?"&#"+(1024*(e.charCodeAt(0)-55296)+(e.charCodeAt(1)-56320)+65536)+";":o[e]||"&#"+e.charCodeAt(0)+";"})},encodeNamed:function(e,t,n){return n=n||i,e.replace(t?s:l,function(e){return o[e]||n[e]||e})},getEncodeFunc:function(e,t){function a(e,n){return e.replace(n?s:l,function(e){return o[e]||t[e]||"&#"+e.charCodeAt(0)+";"||e})}function c(e,n){return f.encodeNamed(e,n,t)}return t=n(t)||i,e=r(e.replace(/\+/g,",")),e.named&&e.numeric?a:e.named?t?c:f.encodeNamed:e.numeric?f.encodeNumeric:f.encodeRaw},decode:function(e){return e.replace(u,function(e,n,r){return n?(r=parseInt(r,2===n.length?16:10),r>65535?(r-=65536,String.fromCharCode(55296+(r>>10),56320+(1023&r))):d[r]||String.fromCharCode(r)):a[e]||i[e]||t(e)})}};return f}),r(g,[],function(){var e=navigator,t=e.userAgent,n,r,i,o,a,s,l;n=window.opera&&window.opera.buildNumber,r=/WebKit/.test(t),i=!r&&!n&&/MSIE/gi.test(t)&&/Explorer/gi.test(e.appName),i=i&&/MSIE (\w+)\./.exec(t)[1],o=-1==t.indexOf("Trident/")||-1==t.indexOf("rv:")&&-1==e.appName.indexOf("Netscape")?!1:11,i=i||o,a=!r&&!o&&/Gecko/.test(t),s=-1!=t.indexOf("Mac"),l=/(iPad|iPhone)/.test(t);var c=!l||t.match(/AppleWebKit\/(\d*)/)[1]>=534;return{opera:n,webkit:r,ie:i,gecko:a,mac:s,iOS:l,contentEditable:c,transparentSrc:"data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7",caretAfter:8!=i,range:window.getSelection&&"Range"in window,documentMode:i?document.documentMode||7:10}}),r(v,[],function(){return function(e,t){function n(t){e.getElementsByTagName("head")[0].appendChild(t)}function r(t,r,s){function l(){for(var e=v.passed,t=e.length;t--;)e[t]();v.status=2,v.passed=[],v.failed=[]}function c(){for(var e=v.failed,t=e.length;t--;)e[t]();v.status=3,v.passed=[],v.failed=[]}function u(){var e=navigator.userAgent.match(/WebKit\/(\d*)/);return!!(e&&e[1]<536)}function d(e,t){e()||((new Date).getTime()-g<a?window.setTimeout(t,0):c())}function f(){d(function(){for(var t=e.styleSheets,n,r=t.length,i;r--;)if(n=t[r],i=n.ownerNode?n.ownerNode:n.owningElement,i&&i.id===h.id)return l(),!0},f)}function p(){d(function(){try{var e=m.sheet.cssRules;return l(),!!e}catch(t){}},p)}var h,m,g,v;if(o[t]?v=o[t]:(v={passed:[],failed:[]},o[t]=v),r&&v.passed.push(r),s&&v.failed.push(s),1!=v.status){if(2==v.status)return void l();if(3==v.status)return void c();if(v.status=1,h=e.createElement("link"),h.rel="stylesheet",h.type="text/css",h.id="u"+i++,h.async=!1,h.defer=!1,g=(new Date).getTime(),"onload"in h&&!u())h.onload=f,h.onerror=c;else{if(navigator.userAgent.indexOf("Firefox")>0)return m=e.createElement("style"),m.textContent='@import "'+t+'"',p(),void n(m);f()}n(h),h.href=t}}var i=0,o={},a;t=t||{},a=t.maxLoadTime||5e3,this.load=r}}),r(y,[c,d,l,f,h,m,g,p,v],function(e,n,r,i,o,a,s,l,c){function u(e,t){var i=this,o;i.doc=e,i.win=window,i.files={},i.counter=0,i.stdMode=!v||e.documentMode>=8,i.boxModel=!v||"CSS1Compat"==e.compatMode||i.stdMode,i.hasOuterHTML="outerHTML"in e.createElement("a"),i.styleSheetLoader=new c(e),this.boundEvents=[],i.settings=t=m({keep_values:!1,hex_colors:1},t),i.schema=t.schema,i.styles=new n({url_converter:t.url_converter,url_converter_scope:t.url_converter_scope},t.schema),i.fixDoc(e),i.events=t.ownEvents?new r(t.proxy):r.Event,o=t.schema?t.schema.getBlockElements():{},i.isBlock=function(e){if(!e)return!1;var t=e.nodeType;return t?!(1!==t||!o[e.nodeName]):!!o[e]}}var d=l.each,f=l.is,p=l.grep,h=l.trim,m=l.extend,g=s.webkit,v=s.ie,y=/^([a-z0-9],?)+$/i,b=/^[ \t\r\n]*$/,C=l.makeMap("fillOpacity fontWeight lineHeight opacity orphans widows zIndex zoom"," ");return u.prototype={root:null,props:{"for":"htmlFor","class":"className",className:"className",checked:"checked",disabled:"disabled",maxlength:"maxLength",readonly:"readOnly",selected:"selected",value:"value",id:"id",name:"name",type:"type"},fixDoc:function(e){var t=this.settings,n;if(v&&t.schema){"abbr article aside audio canvas details figcaption figure footer header hgroup mark menu meter nav output progress section summary time video".replace(/\w+/g,function(t){e.createElement(t)});for(n in t.schema.getCustomElements())e.createElement(n)}},clone:function(e,t){var n=this,r,i;return!v||1!==e.nodeType||t?e.cloneNode(t):(i=n.doc,t?r.firstChild:(r=i.createElement(e.nodeName),d(n.getAttribs(e),function(t){n.setAttrib(r,t.nodeName,n.getAttrib(e,t.nodeName))}),r))},getRoot:function(){var e=this;return e.get(e.settings.root_element)||e.doc.body},getViewPort:function(e){var t,n;return e=e?e:this.win,t=e.document,n=this.boxModel?t.documentElement:t.body,{x:e.pageXOffset||n.scrollLeft,y:e.pageYOffset||n.scrollTop,w:e.innerWidth||n.clientWidth,h:e.innerHeight||n.clientHeight}},getRect:function(e){var t=this,n,r;return e=t.get(e),n=t.getPos(e),r=t.getSize(e),{x:n.x,y:n.y,w:r.w,h:r.h}},getSize:function(e){var t=this,n,r;return e=t.get(e),n=t.getStyle(e,"width"),r=t.getStyle(e,"height"),-1===n.indexOf("px")&&(n=0),-1===r.indexOf("px")&&(r=0),{w:parseInt(n,10)||e.offsetWidth||e.clientWidth,h:parseInt(r,10)||e.offsetHeight||e.clientHeight}},getParent:function(e,t,n){return this.getParents(e,t,n,!1)},getParents:function(e,n,r,i){var o=this,a,s=[];for(e=o.get(e),i=i===t,r=r||("BODY"!=o.getRoot().nodeName?o.getRoot().parentNode:null),f(n,"string")&&(a=n,n="*"===n?function(e){return 1==e.nodeType}:function(e){return o.is(e,a)});e&&e!=r&&e.nodeType&&9!==e.nodeType;){if(!n||n(e)){if(!i)return e;s.push(e)}e=e.parentNode}return i?s:null},get:function(e){var t;return e&&this.doc&&"string"==typeof e&&(t=e,e=this.doc.getElementById(e),e&&e.id!==t)?this.doc.getElementsByName(t)[1]:e},getNext:function(e,t){return this._findSib(e,t,"nextSibling")},getPrev:function(e,t){return this._findSib(e,t,"previousSibling")},select:function(t,n){var r=this;return e(t,r.get(n)||r.get(r.settings.root_element)||r.doc,[])},is:function(n,r){var i;if(n.length===t){if("*"===r)return 1==n.nodeType;if(y.test(r)){for(r=r.toLowerCase().split(/,/),n=n.nodeName.toLowerCase(),i=r.length-1;i>=0;i--)if(r[i]==n)return!0;return!1}}if(n.nodeType&&1!=n.nodeType)return!1;var o=n.nodeType?[n]:n;return e(r,o[0].ownerDocument||o[0],null,o).length>0},add:function(e,t,n,r,i){var o=this;return this.run(e,function(e){var a;return a=f(t,"string")?o.doc.createElement(t):t,o.setAttribs(a,n),r&&(r.nodeType?a.appendChild(r):o.setHTML(a,r)),i?a:e.appendChild(a)})},create:function(e,t,n){return this.add(this.doc.createElement(e),e,t,n,1)},createHTML:function(e,t,n){var r="",i;r+="<"+e;for(i in t)t.hasOwnProperty(i)&&null!==t[i]&&(r+=" "+i+'="'+this.encode(t[i])+'"');return"undefined"!=typeof n?r+">"+n+"</"+e+">":r+" />"},createFragment:function(e){var t,n,r=this.doc,i;for(i=r.createElement("div"),t=r.createDocumentFragment(),e&&(i.innerHTML=e);n=i.firstChild;)t.appendChild(n);return t},remove:function(e,t){return this.run(e,function(e){var n,r=e.parentNode;if(!r)return null;if(t)for(;n=e.firstChild;)!v||3!==n.nodeType||n.nodeValue?r.insertBefore(n,e):e.removeChild(n);return r.removeChild(e)})},setStyle:function(e,t,n){return this.run(e,function(e){var r=this,i,o;if(t)if("string"==typeof t){i=e.style,t=t.replace(/-(\D)/g,function(e,t){return t.toUpperCase()}),"number"!=typeof n||C[t]||(n+="px"),"opacity"===t&&e.runtimeStyle&&"undefined"==typeof e.runtimeStyle.opacity&&(i.filter=""===n?"":"alpha(opacity="+100*n+")"),"float"==t&&(t="cssFloat"in e.style?"cssFloat":"styleFloat");try{i[t]=n}catch(a){}r.settings.update_styles&&e.removeAttribute("data-mce-style")}else for(o in t)r.setStyle(e,o,t[o])})},getStyle:function(e,n,r){if(e=this.get(e)){if(this.doc.defaultView&&r){n=n.replace(/[A-Z]/g,function(e){return"-"+e});try{return this.doc.defaultView.getComputedStyle(e,null).getPropertyValue(n)}catch(i){return null}}return n=n.replace(/-(\D)/g,function(e,t){return t.toUpperCase()}),"float"==n&&(n=v?"styleFloat":"cssFloat"),e.currentStyle&&r?e.currentStyle[n]:e.style?e.style[n]:t}},setStyles:function(e,t){this.setStyle(e,t)},css:function(e,t,n){this.setStyle(e,t,n)},removeAllAttribs:function(e){return this.run(e,function(e){var t,n=e.attributes;for(t=n.length-1;t>=0;t--)e.removeAttributeNode(n.item(t))})},setAttrib:function(e,t,n){var r=this;if(e&&t)return this.run(e,function(e){var i=r.settings,o=e.getAttribute(t);if(null!==n)switch(t){case"style":if(!f(n,"string"))return void d(n,function(t,n){r.setStyle(e,n,t)});i.keep_values&&(n?e.setAttribute("data-mce-style",n,2):e.removeAttribute("data-mce-style",2)),e.style.cssText=n;break;case"class":e.className=n||"";break;case"src":case"href":i.keep_values&&(i.url_converter&&(n=i.url_converter.call(i.url_converter_scope||r,n,t,e)),r.setAttrib(e,"data-mce-"+t,n,2));break;case"shape":e.setAttribute("data-mce-style",n)}f(n)&&null!==n&&0!==n.length?e.setAttribute(t,""+n,2):e.removeAttribute(t,2),o!=n&&i.onSetAttrib&&i.onSetAttrib({attrElm:e,attrName:t,attrValue:n})})},setAttribs:function(e,t){var n=this;return this.run(e,function(e){d(t,function(t,r){n.setAttrib(e,r,t)})})},getAttrib:function(e,t,n){var r,i=this,o;if(e=i.get(e),!e||1!==e.nodeType)return n===o?!1:n;if(f(n)||(n=""),/^(src|href|style|coords|shape)$/.test(t)&&(r=e.getAttribute("data-mce-"+t)))return r;if(v&&i.props[t]&&(r=e[i.props[t]],r=r&&r.nodeValue?r.nodeValue:r),r||(r=e.getAttribute(t,2)),/^(checked|compact|declare|defer|disabled|ismap|multiple|nohref|noshade|nowrap|readonly|selected)$/.test(t))return e[i.props[t]]===!0&&""===r?t:r?t:"";if("FORM"===e.nodeName&&e.getAttributeNode(t))return e.getAttributeNode(t).nodeValue;if("style"===t&&(r=r||e.style.cssText,r&&(r=i.serializeStyle(i.parseStyle(r),e.nodeName),i.settings.keep_values&&e.setAttribute("data-mce-style",r))),g&&"class"===t&&r&&(r=r.replace(/(apple|webkit)\-[a-z\-]+/gi,"")),v)switch(t){case"rowspan":case"colspan":1===r&&(r="");break;case"size":("+0"===r||20===r||0===r)&&(r="");break;case"width":case"height":case"vspace":case"checked":case"disabled":case"readonly":0===r&&(r="");break;case"hspace":-1===r&&(r="");break;case"maxlength":case"tabindex":(32768===r||2147483647===r||"32768"===r)&&(r="");break;case"multiple":case"compact":case"noshade":case"nowrap":return 65535===r?t:n;case"shape":r=r.toLowerCase();break;default:0===t.indexOf("on")&&r&&(r=(""+r).replace(/^function\s+\w+\(\)\s+\{\s+(.*)\s+\}$/,"$1"))}return r!==o&&null!==r&&""!==r?""+r:n},getPos:function(e,t){var n=this,r=0,i=0,o,a=n.doc,s;if(e=n.get(e),t=t||a.body,e){if(t===a.body&&e.getBoundingClientRect)return s=e.getBoundingClientRect(),t=n.boxModel?a.documentElement:a.body,r=s.left+(a.documentElement.scrollLeft||a.body.scrollLeft)-t.clientLeft,i=s.top+(a.documentElement.scrollTop||a.body.scrollTop)-t.clientTop,{x:r,y:i};for(o=e;o&&o!=t&&o.nodeType;)r+=o.offsetLeft||0,i+=o.offsetTop||0,o=o.offsetParent;for(o=e.parentNode;o&&o!=t&&o.nodeType;)r-=o.scrollLeft||0,i-=o.scrollTop||0,o=o.parentNode}return{x:r,y:i}},parseStyle:function(e){return this.styles.parse(e)},serializeStyle:function(e,t){return this.styles.serialize(e,t)},addStyle:function(e){var t=this,n=t.doc,r,i;if(t!==u.DOM&&n===document){var o=u.DOM.addedStyles;if(o=o||[],o[e])return;o[e]=!0,u.DOM.addedStyles=o}i=n.getElementById("mceDefaultStyles"),i||(i=n.createElement("style"),i.id="mceDefaultStyles",i.type="text/css",r=n.getElementsByTagName("head")[0],r.firstChild?r.insertBefore(i,r.firstChild):r.appendChild(i)),i.styleSheet?i.styleSheet.cssText+=e:i.appendChild(n.createTextNode(e))},loadCSS:function(e){var t=this,n=t.doc,r;return t!==u.DOM&&n===document?void u.DOM.loadCSS(e):(e||(e=""),r=n.getElementsByTagName("head")[0],void d(e.split(","),function(e){var i;t.files[e]||(t.files[e]=!0,i=t.create("link",{rel:"stylesheet",href:e}),v&&n.documentMode&&n.recalc&&(i.onload=function(){n.recalc&&n.recalc(),i.onload=null}),r.appendChild(i))}))},addClass:function(e,t){return this.run(e,function(e){var n;return t?this.hasClass(e,t)?e.className:(n=this.removeClass(e,t),e.className=n=(""!==n?n+" ":"")+t,n):0})},removeClass:function(e,t){var n=this,r;return n.run(e,function(e){var i;return n.hasClass(e,t)?(r||(r=new RegExp("(^|\\s+)"+t+"(\\s+|$)","g")),i=e.className.replace(r," "),i=h(" "!=i?i:""),e.className=i,i||(e.removeAttribute("class"),e.removeAttribute("className")),i):e.className})},hasClass:function(e,t){return e=this.get(e),e&&t?-1!==(" "+e.className+" ").indexOf(" "+t+" "):!1},toggleClass:function(e,n,r){r=r===t?!this.hasClass(e,n):r,this.hasClass(e,n)!==r&&(r?this.addClass(e,n):this.removeClass(e,n))},show:function(e){return this.setStyle(e,"display","block")},hide:function(e){return this.setStyle(e,"display","none")},isHidden:function(e){return e=this.get(e),!e||"none"==e.style.display||"none"==this.getStyle(e,"display")},uniqueId:function(e){return(e?e:"mce_")+this.counter++},setHTML:function(e,t){var n=this;return n.run(e,function(e){if(v){for(;e.firstChild;)e.removeChild(e.firstChild);try{e.innerHTML="<br />"+t,e.removeChild(e.firstChild)}catch(r){var i=n.create("div");i.innerHTML="<br />"+t,d(p(i.childNodes),function(t,n){n&&e.canHaveHTML&&e.appendChild(t)})}}else e.innerHTML=t;return t})},getOuterHTML:function(e){var t,n=this;return(e=n.get(e))?1===e.nodeType&&n.hasOuterHTML?e.outerHTML:(t=(e.ownerDocument||n.doc).createElement("body"),t.appendChild(e.cloneNode(!0)),t.innerHTML):null},setOuterHTML:function(e,t,n){var r=this;return r.run(e,function(e){function i(){var i,o;for(o=n.createElement("body"),o.innerHTML=t,i=o.lastChild;i;)r.insertAfter(i.cloneNode(!0),e),i=i.previousSibling;r.remove(e)}if(1==e.nodeType)if(n=n||e.ownerDocument||r.doc,v)try{1==e.nodeType&&r.hasOuterHTML?e.outerHTML=t:i()}catch(o){i()}else i()})},decode:a.decode,encode:a.encodeAllRaw,insertAfter:function(e,t){return t=this.get(t),this.run(e,function(e){var n,r;return n=t.parentNode,r=t.nextSibling,r?n.insertBefore(e,r):n.appendChild(e),e})},replace:function(e,t,n){var r=this;return r.run(t,function(t){return f(t,"array")&&(e=e.cloneNode(!0)),n&&d(p(t.childNodes),function(t){e.appendChild(t)}),t.parentNode.replaceChild(e,t)})},rename:function(e,t){var n=this,r;return e.nodeName!=t.toUpperCase()&&(r=n.create(t),d(n.getAttribs(e),function(t){n.setAttrib(r,t.nodeName,n.getAttrib(e,t.nodeName))}),n.replace(r,e,1)),r||e},findCommonAncestor:function(e,t){for(var n=e,r;n;){for(r=t;r&&n!=r;)r=r.parentNode;if(n==r)break;n=n.parentNode}return!n&&e.ownerDocument?e.ownerDocument.documentElement:n},toHex:function(e){return this.styles.toHex(l.trim(e))},run:function(e,t,n){var r=this,i;return"string"==typeof e&&(e=r.get(e)),e?(n=n||this,e.nodeType||!e.length&&0!==e.length?t.call(n,e):(i=[],d(e,function(e,o){e&&("string"==typeof e&&(e=r.get(e)),i.push(t.call(n,e,o)))}),i)):!1},getAttribs:function(e){var t;if(e=this.get(e),!e)return[];if(v){if(t=[],"OBJECT"==e.nodeName)return e.attributes;"OPTION"===e.nodeName&&this.getAttrib(e,"selected")&&t.push({specified:1,nodeName:"selected"});var n=/<\/?[\w:\-]+ ?|=[\"][^\"]+\"|=\'[^\']+\'|=[\w\-]+|>/gi;return e.cloneNode(!1).outerHTML.replace(n,"").replace(/[\w:\-]+/gi,function(e){t.push({specified:1,nodeName:e})}),t}return e.attributes},isEmpty:function(e,t){var n=this,r,o,a,s,l,c=0;if(e=e.firstChild){s=new i(e,e.parentNode),t=t||n.schema?n.schema.getNonEmptyElements():null;do{if(a=e.nodeType,1===a){if(e.getAttribute("data-mce-bogus"))continue;if(l=e.nodeName.toLowerCase(),t&&t[l]){if("br"===l){c++;continue}return!1}for(o=n.getAttribs(e),r=o.length;r--;)if(l=o[r].nodeName,"name"===l||"data-mce-bookmark"===l)return!1}if(8==a)return!1;if(3===a&&!b.test(e.nodeValue))return!1}while(e=s.next())}return 1>=c},createRng:function(){var e=this.doc;return e.createRange?e.createRange():new o(this)},nodeIndex:function(e,t){var n=0,r,i;if(e)for(r=e.nodeType,e=e.previousSibling;e;e=e.previousSibling)i=e.nodeType,(!t||3!=i||i!=r&&e.nodeValue.length)&&(n++,r=i);return n},split:function(e,t,n){function r(e){function t(e){var t=e.previousSibling&&"SPAN"==e.previousSibling.nodeName,n=e.nextSibling&&"SPAN"==e.nextSibling.nodeName;return t&&n}var n,o=e.childNodes,a=e.nodeType;if(1!=a||"bookmark"!=e.getAttribute("data-mce-type")){for(n=o.length-1;n>=0;n--)r(o[n]);if(9!=a){if(3==a&&e.nodeValue.length>0){var s=h(e.nodeValue).length;if(!i.isBlock(e.parentNode)||s>0||0===s&&t(e))return}else if(1==a&&(o=e.childNodes,1==o.length&&o[0]&&1==o[0].nodeType&&"bookmark"==o[0].getAttribute("data-mce-type")&&e.parentNode.insertBefore(o[0],e),o.length||/^(br|hr|input|img)$/i.test(e.nodeName)))return;i.remove(e)}return e}}var i=this,o=i.createRng(),a,s,l;return e&&t?(o.setStart(e.parentNode,i.nodeIndex(e)),o.setEnd(t.parentNode,i.nodeIndex(t)),a=o.extractContents(),o=i.createRng(),o.setStart(t.parentNode,i.nodeIndex(t)+1),o.setEnd(e.parentNode,i.nodeIndex(e)+1),s=o.extractContents(),l=e.parentNode,l.insertBefore(r(a),e),n?l.replaceChild(n,t):l.insertBefore(t,e),l.insertBefore(r(s),e),i.remove(e),n||t):void 0},bind:function(e,t,n,r){var i=this;if(l.isArray(e)){for(var o=e.length;o--;)e[o]=i.bind(e[o],t,n,r);return e}return!i.settings.collect||e!==i.doc&&e!==i.win||i.boundEvents.push([e,t,n,r]),i.events.bind(e,t,n,r||i)},unbind:function(e,t,n){var r=this,i;if(l.isArray(e)){for(i=e.length;i--;)e[i]=r.unbind(e[i],t,n);return e}if(r.boundEvents&&(e===r.doc||e===r.win))for(i=r.boundEvents.length;i--;){var o=r.boundEvents[i];e!=o[0]||t&&t!=o[1]||n&&n!=o[2]||this.events.unbind(o[0],o[1],o[2])}return this.events.unbind(e,t,n)},fire:function(e,t,n){return this.events.fire(e,t,n)},getContentEditable:function(e){var t;return e&&1==e.nodeType?(t=e.getAttribute("data-mce-contenteditable"),t&&"inherit"!==t?t:"inherit"!==e.contentEditable?e.contentEditable:null):null},getContentEditableParent:function(e){for(var t=this.getRoot(),n=null;e&&e!==t&&(n=this.getContentEditable(e),null===n);e=e.parentNode);return n},destroy:function(){var t=this;if(t.boundEvents){for(var n=t.boundEvents.length;n--;){var r=t.boundEvents[n];
+this.events.unbind(r[0],r[1],r[2])}t.boundEvents=null}e.setDocument&&e.setDocument(),t.win=t.doc=t.root=t.events=t.frag=null},isChildOf:function(e,t){for(;e;){if(t===e)return!0;e=e.parentNode}return!1},dumpRng:function(e){return"startContainer: "+e.startContainer.nodeName+", startOffset: "+e.startOffset+", endContainer: "+e.endContainer.nodeName+", endOffset: "+e.endOffset},_findSib:function(e,t,n){var r=this,i=t;if(e)for("string"==typeof i&&(i=function(e){return r.is(e,t)}),e=e[n];e;e=e[n])if(i(e))return e;return null}},u.DOM=new u(document),u}),r(b,[y,p],function(e,t){function n(){function e(e,t){function n(){o.remove(s),a&&(a.onreadystatechange=a.onload=a=null),t()}function i(){"undefined"!=typeof console&&console.log&&console.log("Failed to load: "+e)}var o=r,a,s;s=o.uniqueId(),a=document.createElement("script"),a.id=s,a.type="text/javascript",a.src=e,"onreadystatechange"in a?a.onreadystatechange=function(){/loaded|complete/.test(a.readyState)&&n()}:a.onload=n,a.onerror=i,(document.getElementsByTagName("head")[0]||document.body).appendChild(a)}var t=0,n=1,a=2,s={},l=[],c={},u=[],d=0,f;this.isDone=function(e){return s[e]==a},this.markDone=function(e){s[e]=a},this.add=this.load=function(e,n,r){var i=s[e];i==f&&(l.push(e),s[e]=t),n&&(c[e]||(c[e]=[]),c[e].push({func:n,scope:r||this}))},this.loadQueue=function(e,t){this.loadScripts(l,e,t)},this.loadScripts=function(t,r,l){function p(e){i(c[e],function(e){e.func.call(e.scope)}),c[e]=f}var h;u.push({func:r,scope:l||this}),(h=function(){var r=o(t);t.length=0,i(r,function(t){return s[t]==a?void p(t):void(s[t]!=n&&(s[t]=n,d++,e(t,function(){s[t]=a,d--,p(t),h()})))}),d||(i(u,function(e){e.func.call(e.scope)}),u.length=0)})()}}var r=e.DOM,i=t.each,o=t.grep;return n.ScriptLoader=new n,n}),r(C,[b,p],function(e,n){function r(){var e=this;e.items=[],e.urls={},e.lookup={}}var i=n.each;return r.prototype={get:function(e){return this.lookup[e]?this.lookup[e].instance:t},dependencies:function(e){var t;return this.lookup[e]&&(t=this.lookup[e].dependencies),t||[]},requireLangPack:function(t,n){var i=r.language;if(i&&r.languageLoad!==!1){if(n)if(n=","+n+",",-1!=n.indexOf(","+i.substr(0,2)+","))i=i.substr(0,2);else if(-1==n.indexOf(","+i+","))return;e.ScriptLoader.add(this.urls[t]+"/langs/"+i+".js")}},add:function(e,t,n){return this.items.push(t),this.lookup[e]={instance:t,dependencies:n},t},createUrl:function(e,t){return"object"==typeof t?t:{prefix:e.prefix,resource:t,suffix:e.suffix}},addComponents:function(t,n){var r=this.urls[t];i(n,function(t){e.ScriptLoader.add(r+"/"+t)})},load:function(n,o,a,s){function l(){var r=c.dependencies(n);i(r,function(e){var n=c.createUrl(o,e);c.load(n.resource,n,t,t)}),a&&a.call(s?s:e)}var c=this,u=o;c.urls[n]||("object"==typeof o&&(u=o.prefix+o.resource+o.suffix),0!==u.indexOf("/")&&-1==u.indexOf("://")&&(u=r.baseURL+"/"+u),c.urls[n]=u.substring(0,u.lastIndexOf("/")),c.lookup[n]?l():e.ScriptLoader.add(u,l,s))}},r.PluginManager=new r,r.ThemeManager=new r,r}),r(x,[],function(){function e(e,t,n){var r,i,o=n?"lastChild":"firstChild",a=n?"prev":"next";if(e[o])return e[o];if(e!==t){if(r=e[a])return r;for(i=e.parent;i&&i!==t;i=i.parent)if(r=i[a])return r}}function t(e,t){this.name=e,this.type=t,1===t&&(this.attributes=[],this.attributes.map={})}var n=/^[ \t\r\n]*$/,r={"#text":3,"#comment":8,"#cdata":4,"#pi":7,"#doctype":10,"#document-fragment":11};return t.prototype={replace:function(e){var t=this;return e.parent&&e.remove(),t.insert(e,t),t.remove(),t},attr:function(e,t){var n=this,r,i,o;if("string"!=typeof e){for(i in e)n.attr(i,e[i]);return n}if(r=n.attributes){if(t!==o){if(null===t){if(e in r.map)for(delete r.map[e],i=r.length;i--;)if(r[i].name===e)return r=r.splice(i,1),n;return n}if(e in r.map){for(i=r.length;i--;)if(r[i].name===e){r[i].value=t;break}}else r.push({name:e,value:t});return r.map[e]=t,n}return r.map[e]}},clone:function(){var e=this,n=new t(e.name,e.type),r,i,o,a,s;if(o=e.attributes){for(s=[],s.map={},r=0,i=o.length;i>r;r++)a=o[r],"id"!==a.name&&(s[s.length]={name:a.name,value:a.value},s.map[a.name]=a.value);n.attributes=s}return n.value=e.value,n.shortEnded=e.shortEnded,n},wrap:function(e){var t=this;return t.parent.insert(e,t),e.append(t),t},unwrap:function(){var e=this,t,n;for(t=e.firstChild;t;)n=t.next,e.insert(t,e,!0),t=n;e.remove()},remove:function(){var e=this,t=e.parent,n=e.next,r=e.prev;return t&&(t.firstChild===e?(t.firstChild=n,n&&(n.prev=null)):r.next=n,t.lastChild===e?(t.lastChild=r,r&&(r.next=null)):n.prev=r,e.parent=e.next=e.prev=null),e},append:function(e){var t=this,n;return e.parent&&e.remove(),n=t.lastChild,n?(n.next=e,e.prev=n,t.lastChild=e):t.lastChild=t.firstChild=e,e.parent=t,e},insert:function(e,t,n){var r;return e.parent&&e.remove(),r=t.parent||this,n?(t===r.firstChild?r.firstChild=e:t.prev.next=e,e.prev=t.prev,e.next=t,t.prev=e):(t===r.lastChild?r.lastChild=e:t.next.prev=e,e.next=t.next,e.prev=t,t.next=e),e.parent=r,e},getAll:function(t){var n=this,r,i=[];for(r=n.firstChild;r;r=e(r,n))r.name===t&&i.push(r);return i},empty:function(){var t=this,n,r,i;if(t.firstChild){for(n=[],i=t.firstChild;i;i=e(i,t))n.push(i);for(r=n.length;r--;)i=n[r],i.parent=i.firstChild=i.lastChild=i.next=i.prev=null}return t.firstChild=t.lastChild=null,t},isEmpty:function(t){var r=this,i=r.firstChild,o,a;if(i)do{if(1===i.type){if(i.attributes.map["data-mce-bogus"])continue;if(t[i.name])return!1;for(o=i.attributes.length;o--;)if(a=i.attributes[o].name,"name"===a||0===a.indexOf("data-mce-"))return!1}if(8===i.type)return!1;if(3===i.type&&!n.test(i.value))return!1}while(i=e(i,r));return!0},walk:function(t){return e(this,null,t)}},t.create=function(e,n){var i,o;if(i=new t(e,r[e]||1),n)for(o in n)i.attr(o,n[o]);return i},t}),r(w,[p],function(e){function t(e,t){return e?e.split(t||" "):[]}function n(e){function n(e,n,r){function i(e){var t={},n,r;for(n=0,r=e.length;r>n;n++)t[e[n]]={};return t}var o,l,c,u=arguments;for(r=r||[],n=n||"","string"==typeof r&&(r=t(r)),l=3;l<u.length;l++)"string"==typeof u[l]&&(u[l]=t(u[l])),r.push.apply(r,u[l]);for(e=t(e),o=e.length;o--;)c=[].concat(s,t(n)),a[e[o]]={attributes:i(c),attributesOrder:c,children:i(r)}}function i(e,n){var r,i,o,s;for(e=t(e),r=e.length,n=t(n);r--;)for(i=a[e[r]],o=0,s=n.length;s>o;o++)i.attributes[n[o]]={},i.attributesOrder.push(n[o])}var a={},s,l,c,u,d,f;return r[e]?r[e]:(s=t("id accesskey class dir lang style tabindex title"),l=t("address blockquote div dl fieldset form h1 h2 h3 h4 h5 h6 hr menu ol p pre table ul"),c=t("a abbr b bdo br button cite code del dfn em embed i iframe img input ins kbd label map noscript object q s samp script select small span strong sub sup textarea u var #text #comment"),"html4"!=e&&(s.push.apply(s,t("contenteditable contextmenu draggable dropzone hidden spellcheck translate")),l.push.apply(l,t("article aside details dialog figure header footer hgroup section nav")),c.push.apply(c,t("audio canvas command datalist mark meter output progress time wbr video ruby bdi keygen"))),"html5-strict"!=e&&(s.push("xml:lang"),f=t("acronym applet basefont big font strike tt"),c.push.apply(c,f),o(f,function(e){n(e,"",c)}),d=t("center dir isindex noframes"),l.push.apply(l,d),u=[].concat(l,c),o(d,function(e){n(e,"",u)})),u=u||[].concat(l,c),n("html","manifest","head body"),n("head","","base command link meta noscript script style title"),n("title hr noscript br"),n("base","href target"),n("link","href rel media hreflang type sizes hreflang"),n("meta","name http-equiv content charset"),n("style","media type scoped"),n("script","src async defer type charset"),n("body","onafterprint onbeforeprint onbeforeunload onblur onerror onfocus onhashchange onload onmessage onoffline ononline onpagehide onpageshow onpopstate onresize onscroll onstorage onunload",u),n("address dt dd div caption","",u),n("h1 h2 h3 h4 h5 h6 pre p abbr code var samp kbd sub sup i b u bdo span legend em strong small s cite dfn","",c),n("blockquote","cite",u),n("ol","reversed start type","li"),n("ul","","li"),n("li","value",u),n("dl","","dt dd"),n("a","href target rel media hreflang type",c),n("q","cite",c),n("ins del","cite datetime",u),n("img","src alt usemap ismap width height"),n("iframe","src name width height",u),n("embed","src type width height"),n("object","data type typemustmatch name usemap form width height",u,"param"),n("param","name value"),n("map","name",u,"area"),n("area","alt coords shape href target rel media hreflang type"),n("table","border","caption colgroup thead tfoot tbody tr"+("html4"==e?" col":"")),n("colgroup","span","col"),n("col","span"),n("tbody thead tfoot","","tr"),n("tr","","td th"),n("td","colspan rowspan headers",u),n("th","colspan rowspan headers scope abbr",u),n("form","accept-charset action autocomplete enctype method name novalidate target",u),n("fieldset","disabled form name",u,"legend"),n("label","form for",c),n("input","accept alt autocomplete checked dirname disabled form formaction formenctype formmethod formnovalidate formtarget height list max maxlength min multiple name pattern readonly required size src step type value width"),n("button","disabled form formaction formenctype formmethod formnovalidate formtarget name type value","html4"==e?u:c),n("select","disabled form multiple name required size","option optgroup"),n("optgroup","disabled label","option"),n("option","disabled label selected value"),n("textarea","cols dirname disabled form maxlength name readonly required rows wrap"),n("menu","type label",u,"li"),n("noscript","",u),"html4"!=e&&(n("wbr"),n("ruby","",c,"rt rp"),n("figcaption","",u),n("mark rt rp summary bdi","",c),n("canvas","width height",u),n("video","src crossorigin poster preload autoplay mediagroup loop muted controls width height buffered",u,"track source"),n("audio","src crossorigin preload autoplay mediagroup loop muted controls buffered volume",u,"track source"),n("source","src type media"),n("track","kind src srclang label default"),n("datalist","",c,"option"),n("article section nav aside header footer","",u),n("hgroup","","h1 h2 h3 h4 h5 h6"),n("figure","",u,"figcaption"),n("time","datetime",c),n("dialog","open",u),n("command","type label icon disabled checked radiogroup command"),n("output","for form name",c),n("progress","value max",c),n("meter","value min max low high optimum",c),n("details","open",u,"summary"),n("keygen","autofocus challenge disabled form keytype name")),"html5-strict"!=e&&(i("script","language xml:space"),i("style","xml:space"),i("object","declare classid codebase codetype archive standby align border hspace vspace"),i("param","valuetype type"),i("a","charset name rev shape coords"),i("br","clear"),i("applet","codebase archive code object alt name width height align hspace vspace"),i("img","name longdesc align border hspace vspace"),i("iframe","longdesc frameborder marginwidth marginheight scrolling align"),i("font basefont","size color face"),i("input","usemap align"),i("select","onchange"),i("textarea"),i("h1 h2 h3 h4 h5 h6 div p legend caption","align"),i("ul","type compact"),i("li","type"),i("ol dl menu dir","compact"),i("pre","width xml:space"),i("hr","align noshade size width"),i("isindex","prompt"),i("table","summary width frame rules cellspacing cellpadding align bgcolor"),i("col","width align char charoff valign"),i("colgroup","width align char charoff valign"),i("thead","align char charoff valign"),i("tr","align char charoff valign bgcolor"),i("th","axis align char charoff valign nowrap bgcolor width height"),i("form","accept"),i("td","abbr axis scope align char charoff valign nowrap bgcolor width height"),i("tfoot","align char charoff valign"),i("tbody","align char charoff valign"),i("area","nohref"),i("body","background bgcolor text link vlink alink")),"html4"!=e&&(i("input button select textarea","autofocus"),i("input textarea","placeholder"),i("a","download"),i("link script img","crossorigin"),i("iframe","sandbox seamless allowfullscreen")),o(t("a form meter progress dfn"),function(e){a[e]&&delete a[e].children[e]}),delete a.caption.children.table,r[e]=a,a)}var r={},i=e.makeMap,o=e.each,a=e.extend,s=e.explode,l=e.inArray;return function(e){function c(t,n,o){var s=e[t];return s?s=i(s,/[, ]/,i(s.toUpperCase(),/[, ]/)):(s=r[t],s||(s=i(n," ",i(n.toUpperCase()," ")),s=a(s,o),r[t]=s)),s}function u(e){return new RegExp("^"+e.replace(/([?+*])/g,".$1")+"$")}function d(e){var n,r,o,a,s,c,d,f,p,h,m,g,y,C,x,w,_,N,E,S=/^([#+\-])?([^\[!\/]+)(?:\/([^\[!]+))?(?:(!?)\[([^\]]+)\])?$/,k=/^([!\-])?(\w+::\w+|[^=:<]+)?(?:([=:<])(.*))?$/,T=/[*?+]/;if(e)for(e=t(e,","),v["@"]&&(w=v["@"].attributes,_=v["@"].attributesOrder),n=0,r=e.length;r>n;n++)if(s=S.exec(e[n])){if(C=s[1],p=s[2],x=s[3],f=s[5],g={},y=[],c={attributes:g,attributesOrder:y},"#"===C&&(c.paddEmpty=!0),"-"===C&&(c.removeEmpty=!0),"!"===s[4]&&(c.removeEmptyAttrs=!0),w){for(N in w)g[N]=w[N];y.push.apply(y,_)}if(f)for(f=t(f,"|"),o=0,a=f.length;a>o;o++)if(s=k.exec(f[o])){if(d={},m=s[1],h=s[2].replace(/::/g,":"),C=s[3],E=s[4],"!"===m&&(c.attributesRequired=c.attributesRequired||[],c.attributesRequired.push(h),d.required=!0),"-"===m){delete g[h],y.splice(l(y,h),1);continue}C&&("="===C&&(c.attributesDefault=c.attributesDefault||[],c.attributesDefault.push({name:h,value:E}),d.defaultValue=E),":"===C&&(c.attributesForced=c.attributesForced||[],c.attributesForced.push({name:h,value:E}),d.forcedValue=E),"<"===C&&(d.validValues=i(E,"?"))),T.test(h)?(c.attributePatterns=c.attributePatterns||[],d.pattern=u(h),c.attributePatterns.push(d)):(g[h]||y.push(h),g[h]=d)}w||"@"!=p||(w=g,_=y),x&&(c.outputName=p,v[x]=c),T.test(p)?(c.pattern=u(p),b.push(c)):v[p]=c}}function f(e){v={},b=[],d(e),o(x,function(e,t){y[t]=e.children})}function p(e){var n=/^(~)?(.+)$/;e&&(r.text_block_elements=r.block_elements=null,o(t(e,","),function(e){var t=n.exec(e),r="~"===t[1],i=r?"span":"div",s=t[2];if(y[s]=y[i],R[s]=i,r||(S[s.toUpperCase()]={},S[s]={}),!v[s]){var l=v[i];l=a({},l),delete l.removeEmptyAttrs,delete l.removeEmpty,v[s]=l}o(y,function(e,t){e[i]&&(y[t]=e=a({},y[t]),e[s]=e[i])})}))}function h(e){var n=/^([+\-]?)(\w+)\[([^\]]+)\]$/;e&&o(t(e,","),function(e){var r=n.exec(e),i,s;r&&(s=r[1],i=s?y[r[2]]:y[r[2]]={"#comment":{}},i=y[r[2]],o(t(r[3],"|"),function(e){"-"===s?(y[r[2]]=i=a({},y[r[2]]),delete i[e]):i[e]={}}))})}function m(e){var t=v[e],n;if(t)return t;for(n=b.length;n--;)if(t=b[n],t.pattern.test(e))return t}var g=this,v={},y={},b=[],C,x,w,_,N,E,S,k,T,R={},A={};e=e||{},x=n(e.schema),e.verify_html===!1&&(e.valid_elements="*[*]"),e.valid_styles&&(C={},o(e.valid_styles,function(e,t){C[t]=s(e)})),w=c("whitespace_elements","pre script noscript style textarea video audio iframe object"),_=c("self_closing_elements","colgroup dd dt li option p td tfoot th thead tr"),N=c("short_ended_elements","area base basefont br col frame hr img input isindex link meta param embed source wbr track"),E=c("boolean_attributes","checked compact declare defer disabled ismap multiple nohref noresize noshade nowrap readonly selected autoplay loop controls"),k=c("non_empty_elements","td th iframe video audio object script",N),T=c("text_block_elements","h1 h2 h3 h4 h5 h6 p div address pre form blockquote center dir fieldset header footer article section hgroup aside nav figure"),S=c("block_elements","hr table tbody thead tfoot th tr td li ol ul caption dl dt dd noscript menu isindex option datalist select optgroup",T),o((e.special||"script noscript style textarea").split(" "),function(e){A[e]=new RegExp("</"+e+"[^>]*>","gi")}),e.valid_elements?f(e.valid_elements):(o(x,function(e,t){v[t]={attributes:e.attributes,attributesOrder:e.attributesOrder},y[t]=e.children}),"html5"!=e.schema&&o(t("strong/b em/i"),function(e){e=t(e,"/"),v[e[1]].outputName=e[0]}),v.img.attributesDefault=[{name:"alt",value:""}],o(t("ol ul sub sup blockquote span font a table tbody tr strong em b i"),function(e){v[e]&&(v[e].removeEmpty=!0)}),o(t("p h1 h2 h3 h4 h5 h6 th td pre div address caption"),function(e){v[e].paddEmpty=!0}),o(t("span"),function(e){v[e].removeEmptyAttrs=!0})),p(e.custom_elements),h(e.valid_children),d(e.extended_valid_elements),h("+ol[ul|ol],+ul[ul|ol]"),e.invalid_elements&&o(s(e.invalid_elements),function(e){v[e]&&delete v[e]}),m("span")||d("span[!data-mce-type|*]"),g.children=y,g.styles=C,g.getBoolAttrs=function(){return E},g.getBlockElements=function(){return S},g.getTextBlockElements=function(){return T},g.getShortEndedElements=function(){return N},g.getSelfClosingElements=function(){return _},g.getNonEmptyElements=function(){return k},g.getWhiteSpaceElements=function(){return w},g.getSpecialElements=function(){return A},g.isValidChild=function(e,t){var n=y[e];return!(!n||!n[t])},g.isValid=function(e,t){var n,r,i=m(e);if(i){if(!t)return!0;if(i.attributes[t])return!0;if(n=i.attributePatterns)for(r=n.length;r--;)if(n[r].pattern.test(e))return!0}return!1},g.getElementRule=m,g.getCustomElements=function(){return R},g.addValidElements=d,g.setValidElements=f,g.addCustomElements=p,g.addValidChildren=h,g.elements=v}}),r(_,[w,m,p],function(e,t,n){var r=n.each;return function(i,o){function a(){}var s=this;i=i||{},s.schema=o=o||new e,i.fix_self_closing!==!1&&(i.fix_self_closing=!0),r("comment cdata text start end pi doctype".split(" "),function(e){e&&(s[e]=i[e]||a)}),s.parse=function(e){function r(e){var t,n;for(t=f.length;t--&&f[t].name!==e;);if(t>=0){for(n=f.length-1;n>=t;n--)e=f[n],e.valid&&s.end(e.name);f.length=t}}function a(e,t,n,r,o){var a,s,l=/[\s\u0000-\u001F]+/g;if(t=t.toLowerCase(),n=t in C?t:F(n||r||o||""),w&&!v&&0!==t.indexOf("data-")){if(a=k[t],!a&&T){for(s=T.length;s--&&(a=T[s],!a.pattern.test(t)););-1===s&&(a=null)}if(!a)return;if(a.validValues&&!(n in a.validValues))return}if(W[t]&&!i.allow_script_urls){var c=n.replace(l,"");try{c=decodeURIComponent(c)}catch(u){c=unescape(c)}if(V.test(c))return;if(!i.allow_html_data_urls&&U.test(c)&&!/^data:image\//i.test(c))return}p.map[t]=n,p.push({name:t,value:n})}var s=this,l,c=0,u,d,f=[],p,h,m,g,v,y,b,C,x,w,_,N,E,S,k,T,R,A,B,D,L,M,H,P,O,I=0,F=t.decode,z,W=n.makeMap("src,href,data,background,formaction,poster"),V=/((java|vb)script|mhtml):/i,U=/^data:/i;for(M=new RegExp("<(?:(?:!--([\\w\\W]*?)-->)|(?:!\\[CDATA\\[([\\w\\W]*?)\\]\\]>)|(?:!DOCTYPE([\\w\\W]*?)>)|(?:\\?([^\\s\\/<>]+) ?([\\w\\W]*?)[?/]>)|(?:\\/([^>]+)>)|(?:([A-Za-z0-9\\-\\:\\.]+)((?:\\s+[^\"'>]+(?:(?:\"[^\"]*\")|(?:'[^']*')|[^>]*))*|\\/|\\s+)>))","g"),H=/([\w:\-]+)(?:\s*=\s*(?:(?:\"((?:[^\"])*)\")|(?:\'((?:[^\'])*)\')|([^>\s]+)))?/g,b=o.getShortEndedElements(),L=i.self_closing_elements||o.getSelfClosingElements(),C=o.getBoolAttrs(),w=i.validate,y=i.remove_internals,z=i.fix_self_closing,P=o.getSpecialElements();l=M.exec(e);){if(c<l.index&&s.text(F(e.substr(c,l.index-c))),u=l[6])u=u.toLowerCase(),":"===u.charAt(0)&&(u=u.substr(1)),r(u);else if(u=l[7]){if(u=u.toLowerCase(),":"===u.charAt(0)&&(u=u.substr(1)),x=u in b,z&&L[u]&&f.length>0&&f[f.length-1].name===u&&r(u),!w||(_=o.getElementRule(u))){if(N=!0,w&&(k=_.attributes,T=_.attributePatterns),(S=l[8])?(v=-1!==S.indexOf("data-mce-type"),v&&y&&(N=!1),p=[],p.map={},S.replace(H,a)):(p=[],p.map={}),w&&!v){if(R=_.attributesRequired,A=_.attributesDefault,B=_.attributesForced,D=_.removeEmptyAttrs,D&&!p.length&&(N=!1),B)for(h=B.length;h--;)E=B[h],g=E.name,O=E.value,"{$uid}"===O&&(O="mce_"+I++),p.map[g]=O,p.push({name:g,value:O});if(A)for(h=A.length;h--;)E=A[h],g=E.name,g in p.map||(O=E.value,"{$uid}"===O&&(O="mce_"+I++),p.map[g]=O,p.push({name:g,value:O}));if(R){for(h=R.length;h--&&!(R[h]in p.map););-1===h&&(N=!1)}p.map["data-mce-bogus"]&&(N=!1)}N&&s.start(u,p,x)}else N=!1;if(d=P[u]){d.lastIndex=c=l.index+l[0].length,(l=d.exec(e))?(N&&(m=e.substr(c,l.index-c)),c=l.index+l[0].length):(m=e.substr(c),c=e.length),N&&(m.length>0&&s.text(m,!0),s.end(u)),M.lastIndex=c;continue}x||(S&&S.indexOf("/")==S.length-1?N&&s.end(u):f.push({name:u,valid:N}))}else(u=l[1])?(">"===u.charAt(0)&&(u=" "+u),i.allow_conditional_comments||"[if"!==u.substr(0,3)||(u=" "+u),s.comment(u)):(u=l[2])?s.cdata(u):(u=l[3])?s.doctype(u):(u=l[4])&&s.pi(u,l[5]);c=l.index+l[0].length}for(c<e.length&&s.text(F(e.substr(c))),h=f.length-1;h>=0;h--)u=f[h],u.valid&&s.end(u.name)}}}),r(N,[x,w,_,p],function(e,t,n,r){var i=r.makeMap,o=r.each,a=r.explode,s=r.extend;return function(r,l){function c(t){var n,r,o,a,s,c,d,f,p,h,m,g,v,y;for(m=i("tr,td,th,tbody,thead,tfoot,table"),h=l.getNonEmptyElements(),g=l.getTextBlockElements(),n=0;n<t.length;n++)if(r=t[n],r.parent&&!r.fixed)if(g[r.name]&&"li"==r.parent.name){for(v=r.next;v&&g[v.name];)v.name="li",v.fixed=!0,r.parent.insert(v,r.parent),v=v.next;r.unwrap(r)}else{for(a=[r],o=r.parent;o&&!l.isValidChild(o.name,r.name)&&!m[o.name];o=o.parent)a.push(o);if(o&&a.length>1){for(a.reverse(),s=c=u.filterNode(a[0].clone()),p=0;p<a.length-1;p++){for(l.isValidChild(c.name,a[p].name)?(d=u.filterNode(a[p].clone()),c.append(d)):d=c,f=a[p].firstChild;f&&f!=a[p+1];)y=f.next,d.append(f),f=y;c=d}s.isEmpty(h)?o.insert(r,a[0],!0):(o.insert(s,a[0],!0),o.insert(r,s)),o=a[0],(o.isEmpty(h)||o.firstChild===o.lastChild&&"br"===o.firstChild.name)&&o.empty().remove()}else if(r.parent){if("li"===r.name){if(v=r.prev,v&&("ul"===v.name||"ul"===v.name)){v.append(r);continue}if(v=r.next,v&&("ul"===v.name||"ul"===v.name)){v.insert(r,v.firstChild,!0);continue}r.wrap(u.filterNode(new e("ul",1)));continue}l.isValidChild(r.parent.name,"div")&&l.isValidChild("div",r.name)?r.wrap(u.filterNode(new e("div",1))):"style"===r.name||"script"===r.name?r.empty().remove():r.unwrap()}}}var u=this,d={},f=[],p={},h={};r=r||{},r.validate="validate"in r?r.validate:!0,r.root_name=r.root_name||"body",u.schema=l=l||new t,u.filterNode=function(e){var t,n,r;n in d&&(r=p[n],r?r.push(e):p[n]=[e]),t=f.length;for(;t--;)n=f[t].name,n in e.attributes.map&&(r=h[n],r?r.push(e):h[n]=[e]);return e},u.addNodeFilter=function(e,t){o(a(e),function(e){var n=d[e];n||(d[e]=n=[]),n.push(t)})},u.addAttributeFilter=function(e,t){o(a(e),function(e){var n;for(n=0;n<f.length;n++)if(f[n].name===e)return void f[n].callbacks.push(t);f.push({name:e,callbacks:[t]})})},u.parse=function(t,o){function a(){function e(e){e&&(t=e.firstChild,t&&3==t.type&&(t.value=t.value.replace(R,"")),t=e.lastChild,t&&3==t.type&&(t.value=t.value.replace(D,"")))}var t=y.firstChild,n,i;if(l.isValidChild(y.name,I.toLowerCase())){for(;t;)n=t.next,3==t.type||1==t.type&&"p"!==t.name&&!T[t.name]&&!t.attr("data-mce-type")?i?i.append(t):(i=u(I,1),i.attr(r.forced_root_block_attrs),y.insert(i,t),i.append(t)):(e(i),i=null),t=n;e(i)}}function u(t,n){var r=new e(t,n),i;return t in d&&(i=p[t],i?i.push(r):p[t]=[r]),r}function m(e){var t,n,r;for(t=e.prev;t&&3===t.type;)n=t.value.replace(D,""),n.length>0?(t.value=n,t=t.prev):(r=t.prev,t.remove(),t=r)}function g(e){var t,n={};for(t in e)"li"!==t&&"p"!=t&&(n[t]=e[t]);return n}var v,y,b,C,x,w,_,N,E,S,k,T,R,A=[],B,D,L,M,H,P,O,I;if(o=o||{},p={},h={},T=s(i("script,style,head,html,body,title,meta,param"),l.getBlockElements()),O=l.getNonEmptyElements(),P=l.children,k=r.validate,I="forced_root_block"in o?o.forced_root_block:r.forced_root_block,H=l.getWhiteSpaceElements(),R=/^[ \t\r\n]+/,D=/[ \t\r\n]+$/,L=/[ \t\r\n]+/g,M=/^[ \t\r\n]+$/,v=new n({validate:k,allow_script_urls:r.allow_script_urls,allow_conditional_comments:r.allow_conditional_comments,self_closing_elements:g(l.getSelfClosingElements()),cdata:function(e){b.append(u("#cdata",4)).value=e},text:function(e,t){var n;B||(e=e.replace(L," "),b.lastChild&&T[b.lastChild.name]&&(e=e.replace(R,""))),0!==e.length&&(n=u("#text",3),n.raw=!!t,b.append(n).value=e)},comment:function(e){b.append(u("#comment",8)).value=e},pi:function(e,t){b.append(u(e,7)).value=t,m(b)},doctype:function(e){var t;t=b.append(u("#doctype",10)),t.value=e,m(b)},start:function(e,t,n){var r,i,o,a,s;if(o=k?l.getElementRule(e):{}){for(r=u(o.outputName||e,1),r.attributes=t,r.shortEnded=n,b.append(r),s=P[b.name],s&&P[r.name]&&!s[r.name]&&A.push(r),i=f.length;i--;)a=f[i].name,a in t.map&&(E=h[a],E?E.push(r):h[a]=[r]);T[e]&&m(r),n||(b=r),!B&&H[e]&&(B=!0)}},end:function(t){var n,r,i,o,a;if(r=k?l.getElementRule(t):{}){if(T[t]&&!B){if(n=b.firstChild,n&&3===n.type)if(i=n.value.replace(R,""),i.length>0)n.value=i,n=n.next;else for(o=n.next,n.remove(),n=o;n&&3===n.type;)i=n.value,o=n.next,(0===i.length||M.test(i))&&(n.remove(),n=o),n=o;if(n=b.lastChild,n&&3===n.type)if(i=n.value.replace(D,""),i.length>0)n.value=i,n=n.prev;else for(o=n.prev,n.remove(),n=o;n&&3===n.type;)i=n.value,o=n.prev,(0===i.length||M.test(i))&&(n.remove(),n=o),n=o}if(B&&H[t]&&(B=!1),(r.removeEmpty||r.paddEmpty)&&b.isEmpty(O))if(r.paddEmpty)b.empty().append(new e("#text","3")).value="\xa0";else if(!b.attributes.map.name&&!b.attributes.map.id)return a=b.parent,b.empty().remove(),void(b=a);b=b.parent}}},l),y=b=new e(o.context||r.root_name,11),v.parse(t),k&&A.length&&(o.context?o.invalid=!0:c(A)),I&&("body"==y.name||o.isRootContent)&&a(),!o.invalid){for(S in p){for(E=d[S],C=p[S],_=C.length;_--;)C[_].parent||C.splice(_,1);for(x=0,w=E.length;w>x;x++)E[x](C,S,o)}for(x=0,w=f.length;w>x;x++)if(E=f[x],E.name in h){for(C=h[E.name],_=C.length;_--;)C[_].parent||C.splice(_,1);for(_=0,N=E.callbacks.length;N>_;_++)E.callbacks[_](C,E.name,o)}}return y},r.remove_trailing_brs&&u.addNodeFilter("br",function(t){var n,r=t.length,i,o=s({},l.getBlockElements()),a=l.getNonEmptyElements(),c,u,d,f,p,h;for(o.body=1,n=0;r>n;n++)if(i=t[n],c=i.parent,o[i.parent.name]&&i===c.lastChild){for(d=i.prev;d;){if(f=d.name,"span"!==f||"bookmark"!==d.attr("data-mce-type")){if("br"!==f)break;if("br"===f){i=null;break}}d=d.prev}i&&(i.remove(),c.isEmpty(a)&&(p=l.getElementRule(c.name),p&&(p.removeEmpty?c.remove():p.paddEmpty&&(c.empty().append(new e("#text",3)).value="\xa0"))))}else{for(u=i;c&&c.firstChild===u&&c.lastChild===u&&(u=c,!o[c.name]);)c=c.parent;u===c&&(h=new e("#text",3),h.value="\xa0",i.replace(h))}}),r.allow_html_in_named_anchor||u.addAttributeFilter("id,name",function(e){for(var t=e.length,n,r,i,o;t--;)if(o=e[t],"a"===o.name&&o.firstChild&&!o.attr("href")){i=o.parent,n=o.lastChild;do r=n.prev,i.insert(n,o),n=r;while(n)}})}}),r(E,[m,p],function(e,t){var n=t.makeMap;return function(t){var r=[],i,o,a,s,l;return t=t||{},i=t.indent,o=n(t.indent_before||""),a=n(t.indent_after||""),s=e.getEncodeFunc(t.entity_encoding||"raw",t.entities),l="html"==t.element_format,{start:function(e,t,n){var c,u,d,f;if(i&&o[e]&&r.length>0&&(f=r[r.length-1],f.length>0&&"\n"!==f&&r.push("\n")),r.push("<",e),t)for(c=0,u=t.length;u>c;c++)d=t[c],r.push(" ",d.name,'="',s(d.value,!0),'"');r[r.length]=!n||l?">":" />",n&&i&&a[e]&&r.length>0&&(f=r[r.length-1],f.length>0&&"\n"!==f&&r.push("\n"))},end:function(e){var t;r.push("</",e,">"),i&&a[e]&&r.length>0&&(t=r[r.length-1],t.length>0&&"\n"!==t&&r.push("\n"))},text:function(e,t){e.length>0&&(r[r.length]=t?e:s(e))},cdata:function(e){r.push("<![CDATA[",e,"]]>")},comment:function(e){r.push("<!--",e,"-->")},pi:function(e,t){t?r.push("<?",e," ",t,"?>"):r.push("<?",e,"?>"),i&&r.push("\n")},doctype:function(e){r.push("<!DOCTYPE",e,">",i?"\n":"")},reset:function(){r.length=0},getContent:function(){return r.join("").replace(/\n$/,"")}}}}),r(S,[E,w],function(e,t){return function(n,r){var i=this,o=new e(n);n=n||{},n.validate="validate"in n?n.validate:!0,i.schema=r=r||new t,i.writer=o,i.serialize=function(e){function t(e){var n=i[e.type],s,l,c,u,d,f,p,h,m;if(n)n(e);else{if(s=e.name,l=e.shortEnded,c=e.attributes,a&&c&&c.length>1){for(f=[],f.map={},m=r.getElementRule(e.name),p=0,h=m.attributesOrder.length;h>p;p++)u=m.attributesOrder[p],u in c.map&&(d=c.map[u],f.map[u]=d,f.push({name:u,value:d}));for(p=0,h=c.length;h>p;p++)u=c[p].name,u in f.map||(d=c.map[u],f.map[u]=d,f.push({name:u,value:d}));c=f}if(o.start(e.name,c,l),!l){if(e=e.firstChild)do t(e);while(e=e.next);o.end(s)}}}var i,a;return a=n.validate,i={3:function(e){o.text(e.value,e.raw)},8:function(e){o.comment(e.value)},7:function(e){o.pi(e.name,e.value)},10:function(e){o.doctype(e.value)},4:function(e){o.cdata(e.value)},11:function(e){if(e=e.firstChild)do t(e);while(e=e.next)}},o.reset(),1!=e.type||n.inner?i[11](e):t(e),o.getContent()}}}),r(k,[y,N,m,S,x,w,g,p],function(e,t,n,r,i,o,a,s){var l=s.each,c=s.trim,u=e.DOM;return function(e,i){var s,d,f;return i&&(s=i.dom,d=i.schema),s=s||u,d=d||new o(e),e.entity_encoding=e.entity_encoding||"named",e.remove_trailing_brs="remove_trailing_brs"in e?e.remove_trailing_brs:!0,f=new t(e,d),f.addAttributeFilter("data-mce-tabindex",function(e,t){for(var n=e.length,r;n--;)r=e[n],r.attr("tabindex",r.attributes.map["data-mce-tabindex"]),r.attr(t,null)}),f.addAttributeFilter("src,href,style",function(t,n){for(var r=t.length,i,o,a="data-mce-"+n,l=e.url_converter,c=e.url_converter_scope,u;r--;)i=t[r],o=i.attributes.map[a],o!==u?(i.attr(n,o.length>0?o:null),i.attr(a,null)):(o=i.attributes.map[n],"style"===n?o=s.serializeStyle(s.parseStyle(o),i.name):l&&(o=l.call(c,o,n,i.name)),i.attr(n,o.length>0?o:null))}),f.addAttributeFilter("class",function(e){for(var t=e.length,n,r;t--;)n=e[t],r=n.attr("class").replace(/(?:^|\s)mce-item-\w+(?!\S)/g,""),n.attr("class",r.length>0?r:null)}),f.addAttributeFilter("data-mce-type",function(e,t,n){for(var r=e.length,i;r--;)i=e[r],"bookmark"!==i.attributes.map["data-mce-type"]||n.cleanup||i.remove()}),f.addAttributeFilter("data-mce-expando",function(e,t){for(var n=e.length;n--;)e[n].attr(t,null)}),f.addNodeFilter("noscript",function(e){for(var t=e.length,r;t--;)r=e[t].firstChild,r&&(r.value=n.decode(r.value))}),f.addNodeFilter("script,style",function(e,t){function n(e){return e.replace(/(<!--\[CDATA\[|\]\]-->)/g,"\n").replace(/^[\r\n]*|[\r\n]*$/g,"").replace(/^\s*((<!--)?(\s*\/\/)?\s*<!\[CDATA\[|(<!--\s*)?\/\*\s*<!\[CDATA\[\s*\*\/|(\/\/)?\s*<!--|\/\*\s*<!--\s*\*\/)\s*[\r\n]*/gi,"").replace(/\s*(\/\*\s*\]\]>\s*\*\/(-->)?|\s*\/\/\s*\]\]>(-->)?|\/\/\s*(-->)?|\]\]>|\/\*\s*-->\s*\*\/|\s*-->\s*)\s*$/g,"")}for(var r=e.length,i,o;r--;)if(i=e[r],o=i.firstChild?i.firstChild.value:"","script"===t){var a=(i.attr("type")||"text/javascript").replace(/^mce\-/,"");i.attr("type","text/javascript"===a?null:a),o.length>0&&(i.firstChild.value="// <![CDATA[\n"+n(o)+"\n// ]]>")}else o.length>0&&(i.firstChild.value="<!--\n"+n(o)+"\n-->")}),f.addNodeFilter("#comment",function(e){for(var t=e.length,n;t--;)n=e[t],0===n.value.indexOf("[CDATA[")?(n.name="#cdata",n.type=4,n.value=n.value.replace(/^\[CDATA\[|\]\]$/g,"")):0===n.value.indexOf("mce:protected ")&&(n.name="#text",n.type=3,n.raw=!0,n.value=unescape(n.value).substr(14))}),f.addNodeFilter("xml:namespace,input",function(e,t){for(var n=e.length,r;n--;)r=e[n],7===r.type?r.remove():1===r.type&&("input"!==t||"type"in r.attributes.map||r.attr("type","text"))}),e.fix_list_elements&&f.addNodeFilter("ul,ol",function(e){for(var t=e.length,n,r;t--;)n=e[t],r=n.parent,("ul"===r.name||"ol"===r.name)&&n.prev&&"li"===n.prev.name&&n.prev.append(n)}),f.addAttributeFilter("data-mce-src,data-mce-href,data-mce-style,data-mce-selected",function(e,t){for(var n=e.length;n--;)e[n].attr(t,null)}),{schema:d,addNodeFilter:f.addNodeFilter,addAttributeFilter:f.addAttributeFilter,serialize:function(t,n){var i=this,o,u,p,h,m;return a.ie&&s.select("script,style,select,map").length>0?(m=t.innerHTML,t=t.cloneNode(!1),s.setHTML(t,m)):t=t.cloneNode(!0),o=t.ownerDocument.implementation,o.createHTMLDocument&&(u=o.createHTMLDocument(""),l("BODY"==t.nodeName?t.childNodes:[t],function(e){u.body.appendChild(u.importNode(e,!0))}),t="BODY"!=t.nodeName?u.body.firstChild:u.body,p=s.doc,s.doc=u),n=n||{},n.format=n.format||"html",n.selection&&(n.forced_root_block=""),n.no_events||(n.node=t,i.onPreProcess(n)),h=new r(e,d),n.content=h.serialize(f.parse(c(n.getInner?t.innerHTML:s.getOuterHTML(t)),n)),n.cleanup||(n.content=n.content.replace(/\uFEFF/g,"")),n.no_events||i.onPostProcess(n),p&&(s.doc=p),n.node=null,n.content},addRules:function(e){d.addValidElements(e)},setRules:function(e){d.setValidElements(e)},onPreProcess:function(e){i&&i.fire("PreProcess",e)},onPostProcess:function(e){i&&i.fire("PostProcess",e)}}}}),r(T,[],function(){function e(e){function t(t,n){var r,i=0,o,a,s,l,c,u,d=-1,f;if(r=t.duplicate(),r.collapse(n),f=r.parentElement(),f.ownerDocument===e.dom.doc){for(;"false"===f.contentEditable;)f=f.parentNode;
+if(!f.hasChildNodes())return{node:f,inside:1};for(s=f.children,o=s.length-1;o>=i;)if(u=Math.floor((i+o)/2),l=s[u],r.moveToElementText(l),d=r.compareEndPoints(n?"StartToStart":"EndToEnd",t),d>0)o=u-1;else{if(!(0>d))return{node:l};i=u+1}if(0>d)for(l?r.collapse(!1):(r.moveToElementText(f),r.collapse(!0),l=f,a=!0),c=0;0!==r.compareEndPoints(n?"StartToStart":"StartToEnd",t)&&0!==r.move("character",1)&&f==r.parentElement();)c++;else for(r.collapse(!0),c=0;0!==r.compareEndPoints(n?"StartToStart":"StartToEnd",t)&&0!==r.move("character",-1)&&f==r.parentElement();)c++;return{node:l,position:d,offset:c,inside:a}}}function n(){function n(e){var n=t(o,e),r,i,s=0,l,c,u;if(r=n.node,i=n.offset,n.inside&&!r.hasChildNodes())return void a[e?"setStart":"setEnd"](r,0);if(i===c)return void a[e?"setStartBefore":"setEndAfter"](r);if(n.position<0){if(l=n.inside?r.firstChild:r.nextSibling,!l)return void a[e?"setStartAfter":"setEndAfter"](r);if(!i)return void(3==l.nodeType?a[e?"setStart":"setEnd"](l,0):a[e?"setStartBefore":"setEndBefore"](l));for(;l;){if(u=l.nodeValue,s+=u.length,s>=i){r=l,s-=i,s=u.length-s;break}l=l.nextSibling}}else{if(l=r.previousSibling,!l)return a[e?"setStartBefore":"setEndBefore"](r);if(!i)return void(3==r.nodeType?a[e?"setStart":"setEnd"](l,r.nodeValue.length):a[e?"setStartAfter":"setEndAfter"](l));for(;l;){if(s+=l.nodeValue.length,s>=i){r=l,s-=i;break}l=l.previousSibling}}a[e?"setStart":"setEnd"](r,s)}var o=e.getRng(),a=i.createRng(),s,l,c,u,d;if(s=o.item?o.item(0):o.parentElement(),s.ownerDocument!=i.doc)return a;if(l=e.isCollapsed(),o.item)return a.setStart(s.parentNode,i.nodeIndex(s)),a.setEnd(a.startContainer,a.startOffset+1),a;try{n(!0),l||n()}catch(f){if(-2147024809!=f.number)throw f;d=r.getBookmark(2),c=o.duplicate(),c.collapse(!0),s=c.parentElement(),l||(c=o.duplicate(),c.collapse(!1),u=c.parentElement(),u.innerHTML=u.innerHTML),s.innerHTML=s.innerHTML,r.moveToBookmark(d),o=e.getRng(),n(!0),l||n()}return a}var r=this,i=e.dom,o=!1;this.getBookmark=function(n){function r(e){var t,n,r,o,a=[];for(t=e.parentNode,n=i.getRoot().parentNode;t!=n&&9!==t.nodeType;){for(r=t.children,o=r.length;o--;)if(e===r[o]){a.push(o);break}e=t,t=t.parentNode}return a}function o(e){var n;return n=t(a,e),n?{position:n.position,offset:n.offset,indexes:r(n.node),inside:n.inside}:void 0}var a=e.getRng(),s={};return 2===n&&(a.item?s.start={ctrl:!0,indexes:r(a.item(0))}:(s.start=o(!0),e.isCollapsed()||(s.end=o()))),s},this.moveToBookmark=function(e){function t(e){var t,n,r,o;for(t=i.getRoot(),n=e.length-1;n>=0;n--)o=t.children,r=e[n],r<=o.length-1&&(t=o[r]);return t}function n(n){var i=e[n?"start":"end"],a,s,l,c;i&&(a=i.position>0,s=o.createTextRange(),s.moveToElementText(t(i.indexes)),c=i.offset,c!==l?(s.collapse(i.inside||a),s.moveStart("character",a?-c:c)):s.collapse(n),r.setEndPoint(n?"StartToStart":"EndToStart",s),n&&r.collapse(!0))}var r,o=i.doc.body;e.start&&(e.start.ctrl?(r=o.createControlRange(),r.addElement(t(e.start.indexes)),r.select()):(r=o.createTextRange(),n(!0),n(),r.select()))},this.addRange=function(t){function n(e){var t,n,a,d,h;a=i.create("a"),t=e?s:c,n=e?l:u,d=r.duplicate(),(t==f||t==f.documentElement)&&(t=p,n=0),3==t.nodeType?(t.parentNode.insertBefore(a,t),d.moveToElementText(a),d.moveStart("character",n),i.remove(a),r.setEndPoint(e?"StartToStart":"EndToEnd",d)):(h=t.childNodes,h.length?(n>=h.length?i.insertAfter(a,h[h.length-1]):t.insertBefore(a,h[n]),d.moveToElementText(a)):t.canHaveHTML&&(t.innerHTML="<span>&#xFEFF;</span>",a=t.firstChild,d.moveToElementText(a),d.collapse(o)),r.setEndPoint(e?"StartToStart":"EndToEnd",d),i.remove(a))}var r,a,s,l,c,u,d,f=e.dom.doc,p=f.body,h,m;if(s=t.startContainer,l=t.startOffset,c=t.endContainer,u=t.endOffset,r=p.createTextRange(),s==c&&1==s.nodeType){if(l==u&&!s.hasChildNodes()){if(s.canHaveHTML)return d=s.previousSibling,d&&!d.hasChildNodes()&&i.isBlock(d)?d.innerHTML="&#xFEFF;":d=null,s.innerHTML="<span>&#xFEFF;</span><span>&#xFEFF;</span>",r.moveToElementText(s.lastChild),r.select(),i.doc.selection.clear(),s.innerHTML="",void(d&&(d.innerHTML=""));l=i.nodeIndex(s),s=s.parentNode}if(l==u-1)try{if(m=s.childNodes[l],a=p.createControlRange(),a.addElement(m),a.select(),h=e.getRng(),h.item&&m===h.item(0))return}catch(g){}}n(!0),n(),r.select()},this.getRangeAt=n}return e}),r(R,[g],function(e){return{BACKSPACE:8,DELETE:46,DOWN:40,ENTER:13,LEFT:37,RIGHT:39,SPACEBAR:32,TAB:9,UP:38,modifierPressed:function(e){return e.shiftKey||e.ctrlKey||e.altKey},metaKeyPressed:function(t){return(e.mac?t.metaKey:t.ctrlKey)&&!t.altKey}}}),r(A,[R,p,g],function(e,t,n){return function(r,i){function o(e){var t=i.settings.object_resizing;return t===!1||n.iOS?!1:("string"!=typeof t&&(t="table,img,div"),"false"===e.getAttribute("data-mce-resize")?!1:i.dom.is(e,t))}function a(t){var n,r;n=t.screenX-k,r=t.screenY-T,H=n*E[2]+B,P=r*E[3]+D,H=5>H?5:H,P=5>P?5:P,(e.modifierPressed(t)||"IMG"==w.nodeName&&E[2]*E[3]!==0)&&(H=Math.round(P/L),P=Math.round(H*L)),C.setStyles(_,{width:H,height:P}),E[2]<0&&_.clientWidth<=H&&C.setStyle(_,"left",R+(B-H)),E[3]<0&&_.clientHeight<=P&&C.setStyle(_,"top",A+(D-P)),M||(i.fire("ObjectResizeStart",{target:w,width:B,height:D}),M=!0)}function s(){function e(e,t){t&&(w.style[e]||!i.schema.isValid(w.nodeName.toLowerCase(),e)?C.setStyle(w,e,t):C.setAttrib(w,e,t))}M=!1,e("width",H),e("height",P),C.unbind(O,"mousemove",a),C.unbind(O,"mouseup",s),I!=O&&(C.unbind(I,"mousemove",a),C.unbind(I,"mouseup",s)),C.remove(_),F&&"TABLE"!=w.nodeName||l(w),i.fire("ObjectResized",{target:w,width:H,height:P}),i.nodeChanged()}function l(e,t,r){var l,u,d,f,p,h=i.getBody();g(),l=C.getPos(e,h),R=l.x,A=l.y,p=e.getBoundingClientRect(),u=p.width||p.right-p.left,d=p.height||p.bottom-p.top,w!=e&&(m(),w=e,H=P=0),f=i.fire("ObjectSelected",{target:e}),o(e)&&!f.isDefaultPrevented()?x(N,function(e,o){function l(t){k=t.screenX,T=t.screenY,B=w.clientWidth,D=w.clientHeight,L=D/B,E=e,_=w.cloneNode(!0),C.addClass(_,"mce-clonedresizable"),_.contentEditable=!1,_.unSelectabe=!0,C.setStyles(_,{left:R,top:A,margin:0}),_.removeAttribute("data-mce-selected"),i.getBody().appendChild(_),C.bind(O,"mousemove",a),C.bind(O,"mouseup",s),I!=O&&(C.bind(I,"mousemove",a),C.bind(I,"mouseup",s))}var c,f;return t?void(o==t&&l(r)):(c=C.get("mceResizeHandle"+o),c?C.show(c):(f=i.getBody(),c=C.add(f,"div",{id:"mceResizeHandle"+o,"data-mce-bogus":!0,"class":"mce-resizehandle",unselectable:!0,style:"cursor:"+o+"-resize; margin:0; padding:0"}),n.ie&&(c.contentEditable=!1)),e.elm||(C.bind(c,"mousedown",function(e){e.stopImmediatePropagation(),e.preventDefault(),l(e)}),e.elm=c),void C.setStyles(c,{left:u*e[0]+R-c.offsetWidth/2,top:d*e[1]+A-c.offsetHeight/2}))}):c(),w.setAttribute("data-mce-selected","1")}function c(){var e,t;g(),w&&w.removeAttribute("data-mce-selected");for(e in N)t=C.get("mceResizeHandle"+e),t&&(C.unbind(t),C.remove(t))}function u(e){function t(e,t){if(e)do if(e===t)return!0;while(e=e.parentNode)}var n;return x(C.select("img[data-mce-selected],hr[data-mce-selected]"),function(e){e.removeAttribute("data-mce-selected")}),n="mousedown"==e.type?e.target:r.getNode(),n=C.getParent(n,F?"table":"table,img,hr"),t(n,i.getBody())&&(v(),t(r.getStart(),n)&&t(r.getEnd(),n)&&(!F||n!=r.getStart()&&"IMG"!==r.getStart().nodeName))?void l(n):void c()}function d(e,t,n){e&&e.attachEvent&&e.attachEvent("on"+t,n)}function f(e,t,n){e&&e.detachEvent&&e.detachEvent("on"+t,n)}function p(e){var t=e.srcElement,n,r,o,a,s,c,u;n=t.getBoundingClientRect(),c=S.clientX-n.left,u=S.clientY-n.top;for(r in N)if(o=N[r],a=t.offsetWidth*o[0],s=t.offsetHeight*o[1],Math.abs(a-c)<8&&Math.abs(s-u)<8){E=o;break}M=!0,i.getDoc().selection.empty(),l(t,r,S)}function h(e){var t=e.srcElement;if(t!=w){if(m(),0===t.id.indexOf("mceResizeHandle"))return void(e.returnValue=!1);("IMG"==t.nodeName||"TABLE"==t.nodeName)&&(c(),w=t,d(t,"resizestart",p))}}function m(){f(w,"resizestart",p)}function g(){for(var e in N){var t=N[e];t.elm&&(C.unbind(t.elm),delete t.elm)}}function v(){try{i.getDoc().execCommand("enableObjectResizing",!1,!1)}catch(e){}}function y(e){var t;if(F){t=O.body.createControlRange();try{return t.addElement(e),t.select(),!0}catch(n){}}}function b(){w=_=null,F&&(m(),f(i.getBody(),"controlselect",h))}var C=i.dom,x=t.each,w,_,N,E,S,k,T,R,A,B,D,L,M,H,P,O=i.getDoc(),I=document,F=n.ie&&n.ie<11;N={n:[.5,0,0,-1],e:[1,.5,1,0],s:[.5,1,0,1],w:[0,.5,-1,0],nw:[0,0,-1,-1],ne:[1,0,1,-1],se:[1,1,1,1],sw:[0,1,-1,1]};var z=".mce-content-body";return i.contentStyles.push(z+" div.mce-resizehandle {position: absolute;border: 1px solid black;background: #FFF;width: 5px;height: 5px;z-index: 10000}"+z+" .mce-resizehandle:hover {background: #000}"+z+" img[data-mce-selected], hr[data-mce-selected] {outline: 1px solid black;resize: none}"+z+" .mce-clonedresizable {position: absolute;"+(n.gecko?"":"outline: 1px dashed black;")+"opacity: .5;filter: alpha(opacity=50);z-index: 10000}"),i.on("init",function(){F?(i.on("ObjectResized",function(e){"TABLE"!=e.target.nodeName&&(c(),y(e.target))}),d(i.getBody(),"controlselect",h),i.on("mousedown",function(e){S=e})):(v(),n.ie>=11&&(i.on("mouseup",function(e){var t=e.target.nodeName;/^(TABLE|IMG|HR)$/.test(t)&&(i.selection.select(e.target,"TABLE"==t),i.nodeChanged())}),i.dom.bind(i.getBody(),"mscontrolselect",function(e){/^(TABLE|IMG|HR)$/.test(e.target.nodeName)&&(e.preventDefault(),"IMG"==e.target.tagName&&window.setTimeout(function(){i.selection.select(e.target)},0))}))),i.on("nodechange mousedown mouseup ResizeEditor",u),i.on("keydown keyup",function(e){w&&"TABLE"==w.nodeName&&u(e)}),i.on("hide",c)}),i.on("remove",g),{isResizable:o,showResizeRect:l,hideResizeRect:c,updateResizeRect:u,controlSelect:y,destroy:b}}}),r(B,[p,f],function(e,t){function n(e){this.walk=function(t,n){function i(e){var t;return t=e[0],3===t.nodeType&&t===l&&c>=t.nodeValue.length&&e.splice(0,1),t=e[e.length-1],0===d&&e.length>0&&t===u&&3===t.nodeType&&e.splice(e.length-1,1),e}function o(e,t,n){for(var r=[];e&&e!=n;e=e[t])r.push(e);return r}function a(e,t){do{if(e.parentNode==t)return e;e=e.parentNode}while(e)}function s(e,t,r){var a=r?"nextSibling":"previousSibling";for(m=e,g=m.parentNode;m&&m!=t;m=g)g=m.parentNode,v=o(m==e?m:m[a],a),v.length&&(r||v.reverse(),n(i(v)))}var l=t.startContainer,c=t.startOffset,u=t.endContainer,d=t.endOffset,f,p,h,m,g,v,y;if(y=e.select("td.mce-item-selected,th.mce-item-selected"),y.length>0)return void r(y,function(e){n([e])});if(1==l.nodeType&&l.hasChildNodes()&&(l=l.childNodes[c]),1==u.nodeType&&u.hasChildNodes()&&(u=u.childNodes[Math.min(d-1,u.childNodes.length-1)]),l==u)return n(i([l]));for(f=e.findCommonAncestor(l,u),m=l;m;m=m.parentNode){if(m===u)return s(l,f,!0);if(m===f)break}for(m=u;m;m=m.parentNode){if(m===l)return s(u,f);if(m===f)break}p=a(l,f)||l,h=a(u,f)||u,s(l,p,!0),v=o(p==l?p:p.nextSibling,"nextSibling",h==u?h.nextSibling:h),v.length&&n(i(v)),s(u,h)},this.split=function(e){function t(e,t){return e.splitText(t)}var n=e.startContainer,r=e.startOffset,i=e.endContainer,o=e.endOffset;return n==i&&3==n.nodeType?r>0&&r<n.nodeValue.length&&(i=t(n,r),n=i.previousSibling,o>r?(o-=r,n=i=t(i,o).previousSibling,o=i.nodeValue.length,r=0):o=0):(3==n.nodeType&&r>0&&r<n.nodeValue.length&&(n=t(n,r),r=0),3==i.nodeType&&o>0&&o<i.nodeValue.length&&(i=t(i,o).previousSibling,o=i.nodeValue.length)),{startContainer:n,startOffset:r,endContainer:i,endOffset:o}},this.normalize=function(n){function r(r){function a(n,r){for(var i=new t(n,e.getParent(n.parentNode,e.isBlock)||f);n=i[r?"prev":"next"]();)if("BR"===n.nodeName)return!0}function s(e,t){return e.previousSibling&&e.previousSibling.nodeName==t}function l(n,r){var a,s,l;if(r=r||c,l=e.getParent(r.parentNode,e.isBlock)||f,n&&"BR"==r.nodeName&&g&&e.isEmpty(l))return c=r.parentNode,u=e.nodeIndex(r),void(i=!0);for(a=new t(r,l);p=a[n?"prev":"next"]();){if("false"===e.getContentEditableParent(p))return;if(3===p.nodeType&&p.nodeValue.length>0)return c=p,u=n?p.nodeValue.length:0,void(i=!0);if(e.isBlock(p)||h[p.nodeName.toLowerCase()])return;s=p}o&&s&&(c=s,i=!0,u=0)}var c,u,d,f=e.getRoot(),p,h,m,g;if(c=n[(r?"start":"end")+"Container"],u=n[(r?"start":"end")+"Offset"],g=1==c.nodeType&&u===c.childNodes.length,h=e.schema.getNonEmptyElements(),m=r,1==c.nodeType&&u>c.childNodes.length-1&&(m=!1),9===c.nodeType&&(c=e.getRoot(),u=0),c===f){if(m&&(p=c.childNodes[u>0?u-1:0],p&&(h[p.nodeName]||"TABLE"==p.nodeName)))return;if(c.hasChildNodes()&&(u=Math.min(!m&&u>0?u-1:u,c.childNodes.length-1),c=c.childNodes[u],u=0,c.hasChildNodes()&&!/TABLE/.test(c.nodeName))){p=c,d=new t(c,f);do{if(3===p.nodeType&&p.nodeValue.length>0){u=m?0:p.nodeValue.length,c=p,i=!0;break}if(h[p.nodeName.toLowerCase()]){u=e.nodeIndex(p),c=p.parentNode,"IMG"!=p.nodeName||m||u++,i=!0;break}}while(p=m?d.next():d.prev())}}o&&(3===c.nodeType&&0===u&&l(!0),1===c.nodeType&&(p=c.childNodes[u],p||(p=c.childNodes[u-1]),!p||"BR"!==p.nodeName||s(p,"A")||a(p)||a(p,!0)||l(!0,p))),m&&!o&&3===c.nodeType&&u===c.nodeValue.length&&l(!1),i&&n["set"+(r?"Start":"End")](c,u)}var i,o;return o=n.collapsed,r(!0),o||r(),i&&o&&n.collapse(!0),i}}var r=e.each;return n.compareRanges=function(e,t){if(e&&t){if(!e.item&&!e.duplicate)return e.startContainer==t.startContainer&&e.startOffset==t.startOffset;if(e.item&&t.item&&e.item(0)===t.item(0))return!0;if(e.isEqual&&t.isEqual&&t.isEqual(e))return!0}return!1},n}),r(D,[f,T,A,B,g,p],function(e,n,r,i,o,a){function s(e,t,i,o){var a=this;a.dom=e,a.win=t,a.serializer=i,a.editor=o,a.controlSelection=new r(a,o),a.win.getSelection||(a.tridentSel=new n(a))}var l=a.each,c=a.grep,u=a.trim,d=o.ie,f=o.opera;return s.prototype={setCursorLocation:function(e,t){var n=this,r=n.dom.createRng();e?(r.setStart(e,t),r.setEnd(e,t),n.setRng(r),n.collapse(!1)):(n._moveEndPoint(r,n.editor.getBody(),!0),n.setRng(r))},getContent:function(e){var n=this,r=n.getRng(),i=n.dom.create("body"),o=n.getSel(),a,s,l;return e=e||{},a=s="",e.get=!0,e.format=e.format||"html",e.selection=!0,n.editor.fire("BeforeGetContent",e),"text"==e.format?n.isCollapsed()?"":r.text||(o.toString?o.toString():""):(r.cloneContents?(l=r.cloneContents(),l&&i.appendChild(l)):r.item!==t||r.htmlText!==t?(i.innerHTML="<br>"+(r.item?r.item(0).outerHTML:r.htmlText),i.removeChild(i.firstChild)):i.innerHTML=r.toString(),/^\s/.test(i.innerHTML)&&(a=" "),/\s+$/.test(i.innerHTML)&&(s=" "),e.getInner=!0,e.content=n.isCollapsed()?"":a+n.serializer.serialize(i,e)+s,n.editor.fire("GetContent",e),e.content)},setContent:function(e,t){var n=this,r=n.getRng(),i,o=n.win.document,a,s;if(t=t||{format:"html"},t.set=!0,t.selection=!0,e=t.content=e,t.no_events||n.editor.fire("BeforeSetContent",t),e=t.content,r.insertNode){e+='<span id="__caret">_</span>',r.startContainer==o&&r.endContainer==o?o.body.innerHTML=e:(r.deleteContents(),0===o.body.childNodes.length?o.body.innerHTML=e:r.createContextualFragment?r.insertNode(r.createContextualFragment(e)):(a=o.createDocumentFragment(),s=o.createElement("div"),a.appendChild(s),s.outerHTML=e,r.insertNode(a))),i=n.dom.get("__caret"),r=o.createRange(),r.setStartBefore(i),r.setEndBefore(i),n.setRng(r),n.dom.remove("__caret");try{n.setRng(r)}catch(l){}}else r.item&&(o.execCommand("Delete",!1,null),r=n.getRng()),/^\s+/.test(e)?(r.pasteHTML('<span id="__mce_tmp">_</span>'+e),n.dom.remove("__mce_tmp")):r.pasteHTML(e);t.no_events||n.editor.fire("SetContent",t)},getStart:function(){var e=this,t=e.getRng(),n,r,i,o;if(t.duplicate||t.item){if(t.item)return t.item(0);for(i=t.duplicate(),i.collapse(1),n=i.parentElement(),n.ownerDocument!==e.dom.doc&&(n=e.dom.getRoot()),r=o=t.parentElement();o=o.parentNode;)if(o==n){n=r;break}return n}return n=t.startContainer,1==n.nodeType&&n.hasChildNodes()&&(n=n.childNodes[Math.min(n.childNodes.length-1,t.startOffset)]),n&&3==n.nodeType?n.parentNode:n},getEnd:function(){var e=this,t=e.getRng(),n,r;return t.duplicate||t.item?t.item?t.item(0):(t=t.duplicate(),t.collapse(0),n=t.parentElement(),n.ownerDocument!==e.dom.doc&&(n=e.dom.getRoot()),n&&"BODY"==n.nodeName?n.lastChild||n:n):(n=t.endContainer,r=t.endOffset,1==n.nodeType&&n.hasChildNodes()&&(n=n.childNodes[r>0?r-1:r]),n&&3==n.nodeType?n.parentNode:n)},getBookmark:function(e,t){function n(e,t){var n=0;return l(a.select(e),function(e,r){e==t&&(n=r)}),n}function r(e){function t(t){var n,r,i,o=t?"start":"end";n=e[o+"Container"],r=e[o+"Offset"],1==n.nodeType&&"TR"==n.nodeName&&(i=n.childNodes,n=i[Math.min(t?r:r-1,i.length-1)],n&&(r=t?0:n.childNodes.length,e["set"+(t?"Start":"End")](n,r)))}return t(!0),t(),e}function i(){function e(e,n){var i=e[n?"startContainer":"endContainer"],a=e[n?"startOffset":"endOffset"],s=[],l,c,u=0;if(3==i.nodeType){if(t)for(l=i.previousSibling;l&&3==l.nodeType;l=l.previousSibling)a+=l.nodeValue.length;s.push(a)}else c=i.childNodes,a>=c.length&&c.length&&(u=1,a=Math.max(0,c.length-1)),s.push(o.dom.nodeIndex(c[a],t)+u);for(;i&&i!=r;i=i.parentNode)s.push(o.dom.nodeIndex(i,t));return s}var n=o.getRng(!0),r=a.getRoot(),i={};return i.start=e(n,!0),o.isCollapsed()||(i.end=e(n)),i}var o=this,a=o.dom,s,c,u,d,f,p,h="&#xFEFF;",m;if(2==e)return p=o.getNode(),f=p?p.nodeName:null,"IMG"==f?{name:f,index:n(f,p)}:o.tridentSel?o.tridentSel.getBookmark(e):i();if(e)return{rng:o.getRng()};if(s=o.getRng(),u=a.uniqueId(),d=o.isCollapsed(),m="overflow:hidden;line-height:0px",s.duplicate||s.item){if(s.item)return p=s.item(0),f=p.nodeName,{name:f,index:n(f,p)};c=s.duplicate();try{s.collapse(),s.pasteHTML('<span data-mce-type="bookmark" id="'+u+'_start" style="'+m+'">'+h+"</span>"),d||(c.collapse(!1),s.moveToElementText(c.parentElement()),0===s.compareEndPoints("StartToEnd",c)&&c.move("character",-1),c.pasteHTML('<span data-mce-type="bookmark" id="'+u+'_end" style="'+m+'">'+h+"</span>"))}catch(g){return null}}else{if(p=o.getNode(),f=p.nodeName,"IMG"==f)return{name:f,index:n(f,p)};c=r(s.cloneRange()),d||(c.collapse(!1),c.insertNode(a.create("span",{"data-mce-type":"bookmark",id:u+"_end",style:m},h))),s=r(s),s.collapse(!0),s.insertNode(a.create("span",{"data-mce-type":"bookmark",id:u+"_start",style:m},h))}return o.moveToBookmark({id:u,keep:1}),{id:u}},moveToBookmark:function(e){function t(t){var n=e[t?"start":"end"],r,i,o,l;if(n){for(o=n[0],i=s,r=n.length-1;r>=1;r--){if(l=i.childNodes,n[r]>l.length-1)return;i=l[n[r]]}3===i.nodeType&&(o=Math.min(n[0],i.nodeValue.length)),1===i.nodeType&&(o=Math.min(n[0],i.childNodes.length)),t?a.setStart(i,o):a.setEnd(i,o)}return!0}function n(t){var n=o.get(e.id+"_"+t),r,i,a,s,d=e.keep;if(n&&(r=n.parentNode,"start"==t?(d?(r=n.firstChild,i=1):i=o.nodeIndex(n),u=p=r,h=m=i):(d?(r=n.firstChild,i=1):i=o.nodeIndex(n),p=r,m=i),!d)){for(s=n.previousSibling,a=n.nextSibling,l(c(n.childNodes),function(e){3==e.nodeType&&(e.nodeValue=e.nodeValue.replace(/\uFEFF/g,""))});n=o.get(e.id+"_"+t);)o.remove(n,1);s&&a&&s.nodeType==a.nodeType&&3==s.nodeType&&!f&&(i=s.nodeValue.length,s.appendData(a.nodeValue),o.remove(a),"start"==t?(u=p=s,h=m=i):(p=s,m=i))}}function r(e){return!o.isBlock(e)||e.innerHTML||d||(e.innerHTML='<br data-mce-bogus="1" />'),e}var i=this,o=i.dom,a,s,u,p,h,m;if(e)if(e.start){if(a=o.createRng(),s=o.getRoot(),i.tridentSel)return i.tridentSel.moveToBookmark(e);t(!0)&&t()&&i.setRng(a)}else e.id?(n("start"),n("end"),u&&(a=o.createRng(),a.setStart(r(u),h),a.setEnd(r(p),m),i.setRng(a))):e.name?i.select(o.select(e.name)[e.index]):e.rng&&i.setRng(e.rng)},select:function(e,t){var n=this,r=n.dom,i=r.createRng(),o;if(n.lastFocusBookmark=null,e){if(!t&&n.controlSelection.controlSelect(e))return;o=r.nodeIndex(e),i.setStart(e.parentNode,o),i.setEnd(e.parentNode,o+1),t&&(n._moveEndPoint(i,e,!0),n._moveEndPoint(i,e)),n.setRng(i)}return e},isCollapsed:function(){var e=this,t=e.getRng(),n=e.getSel();return!t||t.item?!1:t.compareEndPoints?0===t.compareEndPoints("StartToEnd",t):!n||t.collapsed},collapse:function(e){var t=this,n=t.getRng(),r;n.item&&(r=n.item(0),n=t.win.document.body.createTextRange(),n.moveToElementText(r)),n.collapse(!!e),t.setRng(n)},getSel:function(){var e=this.win;return e.getSelection?e.getSelection():e.document.selection},getRng:function(e){function t(e,t,n){try{return t.compareBoundaryPoints(e,n)}catch(r){return-1}}var n=this,r,i,o,a=n.win.document,s;if(!e&&n.lastFocusBookmark){var l=n.lastFocusBookmark;return l.startContainer?(i=a.createRange(),i.setStart(l.startContainer,l.startOffset),i.setEnd(l.endContainer,l.endOffset)):i=l,i}if(e&&n.tridentSel)return n.tridentSel.getRangeAt(0);try{(r=n.getSel())&&(i=r.rangeCount>0?r.getRangeAt(0):r.createRange?r.createRange():a.createRange())}catch(c){}if(d&&i&&i.setStart&&a.selection){try{s=a.selection.createRange()}catch(c){}s&&s.item&&(o=s.item(0),i=a.createRange(),i.setStartBefore(o),i.setEndAfter(o))}return i||(i=a.createRange?a.createRange():a.body.createTextRange()),i.setStart&&9===i.startContainer.nodeType&&i.collapsed&&(o=n.dom.getRoot(),i.setStart(o,0),i.setEnd(o,0)),n.selectedRange&&n.explicitRange&&(0===t(i.START_TO_START,i,n.selectedRange)&&0===t(i.END_TO_END,i,n.selectedRange)?i=n.explicitRange:(n.selectedRange=null,n.explicitRange=null)),i},setRng:function(e,t){var n=this,r;if(e.select)try{e.select()}catch(i){}else if(n.tridentSel){if(e.cloneRange)try{return void n.tridentSel.addRange(e)}catch(i){}}else if(r=n.getSel()){n.explicitRange=e;try{r.removeAllRanges(),r.addRange(e)}catch(i){}t===!1&&r.extend&&(r.collapse(e.endContainer,e.endOffset),r.extend(e.startContainer,e.startOffset)),n.selectedRange=r.rangeCount>0?r.getRangeAt(0):null}},setNode:function(e){var t=this;return t.setContent(t.dom.getOuterHTML(e)),e},getNode:function(){function e(e,t){for(var n=e;e&&3===e.nodeType&&0===e.length;)e=t?e.nextSibling:e.previousSibling;return e||n}var t=this,n=t.getRng(),r,i=n.startContainer,o=n.endContainer,a=n.startOffset,s=n.endOffset,l=t.dom.getRoot();return n?n.setStart?(r=n.commonAncestorContainer,!n.collapsed&&(i==o&&2>s-a&&i.hasChildNodes()&&(r=i.childNodes[a]),3===i.nodeType&&3===o.nodeType&&(i=i.length===a?e(i.nextSibling,!0):i.parentNode,o=0===s?e(o.previousSibling,!1):o.parentNode,i&&i===o))?i:r&&3==r.nodeType?r.parentNode:r):(r=n.item?n.item(0):n.parentElement(),r.ownerDocument!==t.win.document&&(r=l),r):l},getSelectedBlocks:function(t,n){var r=this,i=r.dom,o,a,s=[];if(a=i.getRoot(),t=i.getParent(t||r.getStart(),i.isBlock),n=i.getParent(n||r.getEnd(),i.isBlock),t&&t!=a&&s.push(t),t&&n&&t!=n){o=t;for(var l=new e(t,a);(o=l.next())&&o!=n;)i.isBlock(o)&&s.push(o)}return n&&t!=n&&n!=a&&s.push(n),s},isForward:function(){var e=this.dom,t=this.getSel(),n,r;return t&&t.anchorNode&&t.focusNode?(n=e.createRng(),n.setStart(t.anchorNode,t.anchorOffset),n.collapse(!0),r=e.createRng(),r.setStart(t.focusNode,t.focusOffset),r.collapse(!0),n.compareBoundaryPoints(n.START_TO_START,r)<=0):!0},normalize:function(){var e=this,t=e.getRng();return!d&&new i(e.dom).normalize(t)&&e.setRng(t,e.isForward()),t},selectorChanged:function(e,t){var n=this,r;return n.selectorChangedData||(n.selectorChangedData={},r={},n.editor.on("NodeChange",function(e){var t=e.element,i=n.dom,o=i.getParents(t,null,i.getRoot()),a={};l(n.selectorChangedData,function(e,t){l(o,function(n){return i.is(n,t)?(r[t]||(l(e,function(e){e(!0,{node:n,selector:t,parents:o})}),r[t]=e),a[t]=e,!1):void 0})}),l(r,function(e,n){a[n]||(delete r[n],l(e,function(e){e(!1,{node:t,selector:n,parents:o})}))})})),n.selectorChangedData[e]||(n.selectorChangedData[e]=[]),n.selectorChangedData[e].push(t),n},getScrollContainer:function(){for(var e,t=this.dom.getRoot();t&&"BODY"!=t.nodeName;){if(t.scrollHeight>t.clientHeight){e=t;break}t=t.parentNode}return e},scrollIntoView:function(e){function t(e){for(var t=0,n=0,r=e;r&&r.nodeType;)t+=r.offsetLeft||0,n+=r.offsetTop||0,r=r.offsetParent;return{x:t,y:n}}var n,r,i=this,o=i.dom,a=o.getRoot(),s,l;if("BODY"!=a.nodeName){var c=i.getScrollContainer();if(c)return n=t(e).y-t(c).y,l=c.clientHeight,s=c.scrollTop,void((s>n||n+25>s+l)&&(c.scrollTop=s>n?n:n-l+25))}r=o.getViewPort(i.editor.getWin()),n=o.getPos(e).y,s=r.y,l=r.h,(n<r.y||n+25>s+l)&&i.editor.getWin().scrollTo(0,s>n?n:n-l+25)},_moveEndPoint:function(t,n,r){var i=n,a=new e(n,i),s=this.dom.schema.getNonEmptyElements();do{if(3==n.nodeType&&0!==u(n.nodeValue).length)return void(r?t.setStart(n,0):t.setEnd(n,n.nodeValue.length));if(s[n.nodeName])return void(r?t.setStartBefore(n):"BR"==n.nodeName?t.setEndBefore(n):t.setEndAfter(n));if(o.ie&&o.ie<11&&this.dom.isBlock(n)&&this.dom.isEmpty(n))return void(r?t.setStart(n,0):t.setEnd(n,0))}while(n=r?a.next():a.prev());"BODY"==i.nodeName&&(r?t.setStart(i,0):t.setEnd(i,i.childNodes.length))},destroy:function(){this.win=null,this.controlSelection.destroy()}},s}),r(L,[p],function(e){function t(e,t){function r(e){return e.replace(/%(\w+)/g,"")}var i,o,a=e.dom,s="",l,c;if(c=e.settings.preview_styles,c===!1)return"";if(c||(c="font-family font-size font-weight font-style text-decoration text-transform color background-color border border-radius outline text-shadow"),"string"==typeof t){if(t=e.formatter.get(t),!t)return;t=t[0]}return i=t.block||t.inline||"span",o=a.create(i),n(t.styles,function(e,t){e=r(e),e&&a.setStyle(o,t,e)}),n(t.attributes,function(e,t){e=r(e),e&&a.setAttrib(o,t,e)}),n(t.classes,function(e){e=r(e),a.hasClass(o,e)||a.addClass(o,e)}),e.fire("PreviewFormats"),a.setStyles(o,{position:"absolute",left:-65535}),e.getBody().appendChild(o),l=a.getStyle(e.getBody(),"fontSize",!0),l=/px$/.test(l)?parseInt(l,10):0,n(c.split(" "),function(t){var n=a.getStyle(o,t,!0);if(!("background-color"==t&&/transparent|rgba\s*\([^)]+,\s*0\)/.test(n)&&(n=a.getStyle(e.getBody(),t,!0),"#ffffff"==a.toHex(n).toLowerCase())||"color"==t&&"#000000"==a.toHex(n).toLowerCase())){if("font-size"==t&&/em|%$/.test(n)){if(0===l)return;n=parseFloat(n,10)/(/%$/.test(n)?100:1),n=n*l+"px"}"border"==t&&n&&(s+="padding:0 2px;"),s+=t+":"+n+";"}}),e.fire("AfterPreviewFormats"),a.remove(o),s}var n=e.each;return{getCssText:t}}),r(M,[f,B,p,L],function(e,t,n,r){return function(i){function o(e){return e.nodeType&&(e=e.nodeName),!!i.schema.getTextBlockElements()[e.toLowerCase()]}function a(e,t){return z.getParents(e,t,z.getRoot())}function s(e){return 1===e.nodeType&&"_mce_caret"===e.id}function l(){d({valigntop:[{selector:"td,th",styles:{verticalAlign:"top"}}],valignmiddle:[{selector:"td,th",styles:{verticalAlign:"middle"}}],valignbottom:[{selector:"td,th",styles:{verticalAlign:"bottom"}}],alignleft:[{selector:"figure,p,h1,h2,h3,h4,h5,h6,td,th,tr,div,ul,ol,li",styles:{textAlign:"left"},defaultBlock:"div"},{selector:"img,table",collapsed:!1,styles:{"float":"left"}}],aligncenter:[{selector:"figure,p,h1,h2,h3,h4,h5,h6,td,th,tr,div,ul,ol,li",styles:{textAlign:"center"},defaultBlock:"div"},{selector:"img",collapsed:!1,styles:{display:"block",marginLeft:"auto",marginRight:"auto"}},{selector:"table",collapsed:!1,styles:{marginLeft:"auto",marginRight:"auto"}}],alignright:[{selector:"figure,p,h1,h2,h3,h4,h5,h6,td,th,tr,div,ul,ol,li",styles:{textAlign:"right"},defaultBlock:"div"},{selector:"img,table",collapsed:!1,styles:{"float":"right"}}],alignjustify:[{selector:"figure,p,h1,h2,h3,h4,h5,h6,td,th,tr,div,ul,ol,li",styles:{textAlign:"justify"},defaultBlock:"div"}],bold:[{inline:"strong",remove:"all"},{inline:"span",styles:{fontWeight:"bold"}},{inline:"b",remove:"all"}],italic:[{inline:"em",remove:"all"},{inline:"span",styles:{fontStyle:"italic"}},{inline:"i",remove:"all"}],underline:[{inline:"span",styles:{textDecoration:"underline"},exact:!0},{inline:"u",remove:"all"}],strikethrough:[{inline:"span",styles:{textDecoration:"line-through"},exact:!0},{inline:"strike",remove:"all"}],forecolor:{inline:"span",styles:{color:"%value"},wrap_links:!1},hilitecolor:{inline:"span",styles:{backgroundColor:"%value"},wrap_links:!1},fontname:{inline:"span",styles:{fontFamily:"%value"}},fontsize:{inline:"span",styles:{fontSize:"%value"}},fontsize_class:{inline:"span",attributes:{"class":"%value"}},blockquote:{block:"blockquote",wrapper:1,remove:"all"},subscript:{inline:"sub"},superscript:{inline:"sup"},code:{inline:"code"},link:{inline:"a",selector:"a",remove:"all",split:!0,deep:!0,onmatch:function(){return!0},onformat:function(e,t,n){nt(n,function(t,n){z.setAttrib(e,n,t)})}},removeformat:[{selector:"b,strong,em,i,font,u,strike,sub,sup,dfn,code,samp,kbd,var,cite,mark,q",remove:"all",split:!0,expand:!1,block_expand:!0,deep:!0},{selector:"span",attributes:["style","class"],remove:"empty",split:!0,expand:!1,deep:!0},{selector:"*",attributes:["style","class"],split:!1,expand:!1,deep:!0}]}),nt("p h1 h2 h3 h4 h5 h6 div address pre div dt dd samp".split(/\s/),function(e){d(e,{block:e,remove:"all"})}),d(i.settings.formats)}function c(){i.addShortcut("ctrl+b","bold_desc","Bold"),i.addShortcut("ctrl+i","italic_desc","Italic"),i.addShortcut("ctrl+u","underline_desc","Underline");for(var e=1;6>=e;e++)i.addShortcut("ctrl+"+e,"",["FormatBlock",!1,"h"+e]);i.addShortcut("ctrl+7","",["FormatBlock",!1,"p"]),i.addShortcut("ctrl+8","",["FormatBlock",!1,"div"]),i.addShortcut("ctrl+9","",["FormatBlock",!1,"address"])}function u(e){return e?F[e]:F}function d(e,t){e&&("string"!=typeof e?nt(e,function(e,t){d(t,e)}):(t=t.length?t:[t],nt(t,function(e){e.deep===Q&&(e.deep=!e.selector),e.split===Q&&(e.split=!e.selector||e.inline),e.remove===Q&&e.selector&&!e.inline&&(e.remove="none"),e.selector&&e.inline&&(e.mixed=!0,e.block_expand=!0),"string"==typeof e.classes&&(e.classes=e.classes.split(/\s+/))}),F[e]=t))}function f(e){var t;return i.dom.getParent(e,function(e){return t=i.dom.getStyle(e,"text-decoration"),t&&"none"!==t}),t}function p(e){var t;1===e.nodeType&&e.parentNode&&1===e.parentNode.nodeType&&(t=f(e.parentNode),i.dom.getStyle(e,"color")&&t?i.dom.setStyle(e,"text-decoration",t):i.dom.getStyle(e,"textdecoration")===t&&i.dom.setStyle(e,"text-decoration",null))}function h(t,n,r){function a(e,t){if(t=t||m,e){if(t.onformat&&t.onformat(e,t,n,r),nt(t.styles,function(t,r){z.setStyle(e,r,k(t,n))}),t.styles){var i=z.getAttrib(e,"style");i&&e.setAttribute("data-mce-style",i)}nt(t.attributes,function(t,r){z.setAttrib(e,r,k(t,n))}),nt(t.classes,function(t){t=k(t,n),z.hasClass(e,t)||z.addClass(e,t)})}}function l(){function t(t,n){var i=new e(n);for(r=i.current();r;r=i.prev())if(r.childNodes.length>1||r==t||"BR"==r.tagName)return r}var n=i.selection.getRng(),o=n.startContainer,a=n.endContainer;if(o!=a&&0===n.endOffset){var s=t(o,a),l=3==s.nodeType?s.length:s.childNodes.length;n.setEnd(s,l)}return n}function c(e,t,n,r,i){var o=[],a=-1,s,l=-1,c=-1,u;return nt(e.childNodes,function(e,t){return"UL"===e.nodeName||"OL"===e.nodeName?(a=t,s=e,!1):void 0}),nt(e.childNodes,function(e,n){"SPAN"===e.nodeName&&"bookmark"==z.getAttrib(e,"data-mce-type")&&(e.id==t.id+"_start"?l=n:e.id==t.id+"_end"&&(c=n))}),0>=a||a>l&&c>a?(nt(rt(e.childNodes),i),0):(u=z.clone(n,Y),nt(rt(e.childNodes),function(e,t){(a>l&&a>t||l>a&&t>a)&&(o.push(e),e.parentNode.removeChild(e))}),a>l?e.insertBefore(u,s):l>a&&e.insertBefore(u,s.nextSibling),r.push(u),nt(o,function(e){u.appendChild(e)}),u)}function d(e,r,i){var l=[],u,d,p=!0;u=m.inline||m.block,d=z.create(u),a(d),V.walk(e,function(e){function h(e){var y,C,x,w,_;return _=p,y=e.nodeName.toLowerCase(),C=e.parentNode.nodeName.toLowerCase(),1===e.nodeType&&Z(e)&&(_=p,p="true"===Z(e),w=!0),N(y,"br")?(g=0,void(m.block&&z.remove(e))):m.wrapper&&v(e,t,n)?void(g=0):p&&!w&&m.block&&!m.wrapper&&o(y)&&U(C,u)?(e=z.rename(e,u),a(e),l.push(e),void(g=0)):m.selector&&(nt(f,function(t){"collapsed"in t&&t.collapsed!==b||z.is(e,t.selector)&&!s(e)&&(a(e,t),x=!0)}),!m.inline||x)?void(g=0):void(!p||w||!U(u,y)||!U(C,u)||!i&&3===e.nodeType&&1===e.nodeValue.length&&65279===e.nodeValue.charCodeAt(0)||s(e)||m.inline&&q(e)?"li"==y&&r?g=c(e,r,d,l,h):(g=0,nt(rt(e.childNodes),h),w&&(p=_),g=0):(g||(g=z.clone(d,Y),e.parentNode.insertBefore(g,e),l.push(g)),g.appendChild(e)))}var g;nt(e,h)}),m.wrap_links===!1&&nt(l,function(e){function t(e){var n,r,i;if("A"===e.nodeName){for(r=z.clone(d,Y),l.push(r),i=rt(e.childNodes),n=0;n<i.length;n++)r.appendChild(i[n]);e.appendChild(r)}nt(rt(e.childNodes),t)}t(e)}),nt(l,function(e){function r(e){var t=0;return nt(e.childNodes,function(e){T(e)||M(e)||t++}),t}function i(e){var t,n;return nt(e.childNodes,function(e){return 1!=e.nodeType||M(e)||s(e)?void 0:(t=e,Y)
+}),t&&!M(t)&&_(t,m)&&(n=z.clone(t,Y),a(n),z.replace(n,e,X),z.remove(t,1)),n||e}var o;if(o=r(e),(l.length>1||!q(e))&&0===o)return void z.remove(e,1);if(m.inline||m.wrapper){if(m.exact||1!==o||(e=i(e)),nt(f,function(t){nt(z.select(t.inline,e),function(e){var r;if(!M(e)){if(t.wrap_links===!1){r=e.parentNode;do if("A"===r.nodeName)return;while(r=r.parentNode)}B(t,n,e,t.exact?e:null)}})}),v(e.parentNode,t,n))return z.remove(e,1),e=0,X;m.merge_with_parents&&z.getParent(e.parentNode,function(r){return v(r,t,n)?(z.remove(e,1),e=0,X):void 0}),e&&m.merge_siblings!==!1&&(e=H(L(e),e),e=H(e,L(e,X)))}})}var f=u(t),m=f[0],g,y,b=!r&&W.isCollapsed();if(m)if(r)r.nodeType?(y=z.createRng(),y.setStartBefore(r),y.setEndAfter(r),d(A(y,f),null,!0)):d(r,null,!0);else if(b&&m.inline&&!z.select("td.mce-item-selected,th.mce-item-selected").length)O("apply",t,n);else{var C=i.selection.getNode();$||!f[0].defaultBlock||z.getParent(C,z.isBlock)||h(f[0].defaultBlock),i.selection.setRng(l()),g=W.getBookmark(),d(A(W.getRng(X),f),g),m.styles&&(m.styles.color||m.styles.textDecoration)&&(it(C,p,"childNodes"),p(C)),W.moveToBookmark(g),I(W.getRng(X)),i.nodeChanged()}}function m(e,t,n){function r(e){var n,i,o,a,s;if(1===e.nodeType&&Z(e)&&(a=b,b="true"===Z(e),s=!0),n=rt(e.childNodes),b&&!s)for(i=0,o=p.length;o>i&&!B(p[i],t,e,e);i++);if(h.deep&&n.length){for(i=0,o=n.length;o>i;i++)r(n[i]);s&&(b=a)}}function o(n){var r;return nt(a(n.parentNode).reverse(),function(n){var i;r||"_start"==n.id||"_end"==n.id||(i=v(n,e,t),i&&i.split!==!1&&(r=n))}),r}function s(e,n,r,i){var o,a,s,l,c,u;if(e){for(u=e.parentNode,o=n.parentNode;o&&o!=u;o=o.parentNode){for(a=z.clone(o,Y),c=0;c<p.length;c++)if(B(p[c],t,a,a)){a=0;break}a&&(s&&a.appendChild(s),l||(l=a),s=a)}!i||h.mixed&&q(e)||(n=z.split(e,n)),s&&(r.parentNode.insertBefore(s,r),l.appendChild(r))}return n}function l(e){return s(o(e),e,e,!0)}function c(e){var t=z.get(e?"_start":"_end"),n=t[e?"firstChild":"lastChild"];return M(n)&&(n=n[e?"firstChild":"lastChild"]),z.remove(t,!0),n}function d(e){var t,n,o=e.commonAncestorContainer;e=A(e,p,X),h.split&&(t=P(e,X),n=P(e),t!=n?(/^(TR|TH|TD)$/.test(t.nodeName)&&t.firstChild&&(t="TR"==t.nodeName?t.firstChild.firstChild||t:t.firstChild||t),o&&/^T(HEAD|BODY|FOOT|R)$/.test(o.nodeName)&&/^(TH|TD)$/.test(n.nodeName)&&n.firstChild&&(n=n.firstChild||n),t=R(t,"span",{id:"_start","data-mce-type":"bookmark"}),n=R(n,"span",{id:"_end","data-mce-type":"bookmark"}),l(t),l(n),t=c(X),n=c()):t=n=l(t),e.startContainer=t.parentNode,e.startOffset=j(t),e.endContainer=n.parentNode,e.endOffset=j(n)+1),V.walk(e,function(e){nt(e,function(e){r(e),1===e.nodeType&&"underline"===i.dom.getStyle(e,"text-decoration")&&e.parentNode&&"underline"===f(e.parentNode)&&B({deep:!1,exact:!0,inline:"span",styles:{textDecoration:"underline"}},null,e)})})}var p=u(e),h=p[0],m,g,b=!0;return n?void(n.nodeType?(g=z.createRng(),g.setStartBefore(n),g.setEndAfter(n),d(g)):d(n)):void(W.isCollapsed()&&h.inline&&!z.select("td.mce-item-selected,th.mce-item-selected").length?O("remove",e,t):(m=W.getBookmark(),d(W.getRng(X)),W.moveToBookmark(m),h.inline&&y(e,t,W.getStart())&&I(W.getRng(!0)),i.nodeChanged()))}function g(e,t,n){var r=u(e);!y(e,t,n)||"toggle"in r[0]&&!r[0].toggle?h(e,t,n):m(e,t,n)}function v(e,t,n,r){function i(e,t,i){var o,a,s=t[i],l;if(t.onmatch)return t.onmatch(e,t,i);if(s)if(s.length===Q){for(o in s)if(s.hasOwnProperty(o)){if(a="attributes"===i?z.getAttrib(e,o):E(e,o),r&&!a&&!t.exact)return;if((!r||t.exact)&&!N(a,S(k(s[o],n),o)))return}}else for(l=0;l<s.length;l++)if("attributes"===i?z.getAttrib(e,s[l]):E(e,s[l]))return t;return t}var o=u(t),a,s,l;if(o&&e)for(s=0;s<o.length;s++)if(a=o[s],_(e,a)&&i(e,a,"attributes")&&i(e,a,"styles")){if(l=a.classes)for(s=0;s<l.length;s++)if(!z.hasClass(e,l[s]))return;return a}}function y(e,t,n){function r(n){var r=z.getRoot();return n===r?!1:(n=z.getParent(n,function(n){return n.parentNode===r||!!v(n,e,t,!0)}),v(n,e,t))}var i;return n?r(n):(n=W.getNode(),r(n)?X:(i=W.getStart(),i!=n&&r(i)?X:Y))}function b(e,t){var n,r=[],i={};return n=W.getStart(),z.getParent(n,function(n){var o,a;for(o=0;o<e.length;o++)a=e[o],!i[a]&&v(n,a,t)&&(i[a]=!0,r.push(a))},z.getRoot()),r}function C(e){var t=u(e),n,r,i,o,s;if(t)for(n=W.getStart(),r=a(n),o=t.length-1;o>=0;o--){if(s=t[o].selector,!s||t[o].defaultBlock)return X;for(i=r.length-1;i>=0;i--)if(z.is(r[i],s))return X}return Y}function x(e,t,n){var r;return J||(J={},r={},i.on("NodeChange",function(e){var t=a(e.element),n={};nt(J,function(e,i){nt(t,function(o){return v(o,i,{},e.similar)?(r[i]||(nt(e,function(e){e(!0,{node:o,format:i,parents:t})}),r[i]=e),n[i]=e,!1):void 0})}),nt(r,function(i,o){n[o]||(delete r[o],nt(i,function(n){n(!1,{node:e.element,format:o,parents:t})}))})})),nt(e.split(","),function(e){J[e]||(J[e]=[],J[e].similar=n),J[e].push(t)}),this}function w(e){return r.getCssText(i,e)}function _(e,t){return N(e,t.inline)?X:N(e,t.block)?X:t.selector?1==e.nodeType&&z.is(e,t.selector):void 0}function N(e,t){return e=e||"",t=t||"",e=""+(e.nodeName||e),t=""+(t.nodeName||t),e.toLowerCase()==t.toLowerCase()}function E(e,t){return S(z.getStyle(e,t),t)}function S(e,t){return("color"==t||"backgroundColor"==t)&&(e=z.toHex(e)),"fontWeight"==t&&700==e&&(e="bold"),"fontFamily"==t&&(e=e.replace(/[\'\"]/g,"").replace(/,\s+/g,",")),""+e}function k(e,t){return"string"!=typeof e?e=e(t):t&&(e=e.replace(/%(\w+)/g,function(e,n){return t[n]||e})),e}function T(e){return e&&3===e.nodeType&&/^([\t \r\n]+|)$/.test(e.nodeValue)}function R(e,t,n){var r=z.create(t,n);return e.parentNode.insertBefore(r,e),r.appendChild(e),r}function A(t,n,r){function s(e){function t(e){return"BR"==e.nodeName&&e.getAttribute("data-mce-bogus")&&!e.nextSibling}var r,i,o,a,s;if(r=i=e?g:y,a=e?"previousSibling":"nextSibling",s=z.getRoot(),3==r.nodeType&&!T(r)&&(e?v>0:b<r.nodeValue.length))return r;for(;;){if(!n[0].block_expand&&q(i))return i;for(o=i[a];o;o=o[a])if(!M(o)&&!T(o)&&!t(o))return i;if(i.parentNode==s){r=i;break}i=i.parentNode}return r}function l(e,t){for(t===Q&&(t=3===e.nodeType?e.length:e.childNodes.length);e&&e.hasChildNodes();)e=e.childNodes[t],e&&(t=3===e.nodeType?e.length:e.childNodes.length);return{node:e,offset:t}}function c(e){for(var t=e;t;){if(1===t.nodeType&&Z(t))return"false"===Z(t)?t:e;t=t.parentNode}return e}function u(t,n,o){function a(e,t){var n,i,a=e.nodeValue;return"undefined"==typeof t&&(t=o?a.length:0),o?(n=a.lastIndexOf(" ",t),i=a.lastIndexOf("\xa0",t),n=n>i?n:i,-1===n||r||n++):(n=a.indexOf(" ",t),i=a.indexOf("\xa0",t),n=-1!==n&&(-1===i||i>n)?n:i),n}var s,l,c,u;if(3===t.nodeType){if(c=a(t,n),-1!==c)return{container:t,offset:c};u=t}for(s=new e(t,z.getParent(t,q)||i.getBody());l=s[o?"prev":"next"]();)if(3===l.nodeType){if(u=l,c=a(l),-1!==c)return{container:l,offset:c}}else if(q(l))break;return u?(n=o?0:u.length,{container:u,offset:n}):void 0}function d(e,r){var i,o,s,l;for(3==e.nodeType&&0===e.nodeValue.length&&e[r]&&(e=e[r]),i=a(e),o=0;o<i.length;o++)for(s=0;s<n.length;s++)if(l=n[s],!("collapsed"in l&&l.collapsed!==t.collapsed)&&z.is(i[o],l.selector))return i[o];return e}function f(e,t){var r,i=z.getRoot();if(n[0].wrapper||(r=z.getParent(e,n[0].block,i)),r||(r=z.getParent(3==e.nodeType?e.parentNode:e,function(e){return e!=i&&o(e)})),r&&n[0].wrapper&&(r=a(r,"ul,ol").reverse()[0]||r),!r)for(r=e;r[t]&&!q(r[t])&&(r=r[t],!N(r,"br")););return r||e}var p,h,m,g=t.startContainer,v=t.startOffset,y=t.endContainer,b=t.endOffset;if(1==g.nodeType&&g.hasChildNodes()&&(p=g.childNodes.length-1,g=g.childNodes[v>p?p:v],3==g.nodeType&&(v=0)),1==y.nodeType&&y.hasChildNodes()&&(p=y.childNodes.length-1,y=y.childNodes[b>p?p:b-1],3==y.nodeType&&(b=y.nodeValue.length)),g=c(g),y=c(y),(M(g.parentNode)||M(g))&&(g=M(g)?g:g.parentNode,g=g.nextSibling||g,3==g.nodeType&&(v=0)),(M(y.parentNode)||M(y))&&(y=M(y)?y:y.parentNode,y=y.previousSibling||y,3==y.nodeType&&(b=y.length)),n[0].inline&&(t.collapsed&&(m=u(g,v,!0),m&&(g=m.container,v=m.offset),m=u(y,b),m&&(y=m.container,b=m.offset)),h=l(y,b),h.node)){for(;h.node&&0===h.offset&&h.node.previousSibling;)h=l(h.node.previousSibling);h.node&&h.offset>0&&3===h.node.nodeType&&" "===h.node.nodeValue.charAt(h.offset-1)&&h.offset>1&&(y=h.node,y.splitText(h.offset-1))}return(n[0].inline||n[0].block_expand)&&(n[0].inline&&3==g.nodeType&&0!==v||(g=s(!0)),n[0].inline&&3==y.nodeType&&b!==y.nodeValue.length||(y=s())),n[0].selector&&n[0].expand!==Y&&!n[0].inline&&(g=d(g,"previousSibling"),y=d(y,"nextSibling")),(n[0].block||n[0].selector)&&(g=f(g,"previousSibling"),y=f(y,"nextSibling"),n[0].block&&(q(g)||(g=s(!0)),q(y)||(y=s()))),1==g.nodeType&&(v=j(g),g=g.parentNode),1==y.nodeType&&(b=j(y)+1,y=y.parentNode),{startContainer:g,startOffset:v,endContainer:y,endOffset:b}}function B(e,t,n,r){var i,o,a;if(!_(n,e))return Y;if("all"!=e.remove)for(nt(e.styles,function(e,i){e=S(k(e,t),i),"number"==typeof i&&(i=e,r=0),(!r||N(E(r,i),e))&&z.setStyle(n,i,""),a=1}),a&&""===z.getAttrib(n,"style")&&(n.removeAttribute("style"),n.removeAttribute("data-mce-style")),nt(e.attributes,function(e,i){var o;if(e=k(e,t),"number"==typeof i&&(i=e,r=0),!r||N(z.getAttrib(r,i),e)){if("class"==i&&(e=z.getAttrib(n,i),e&&(o="",nt(e.split(/\s+/),function(e){/mce\w+/.test(e)&&(o+=(o?" ":"")+e)}),o)))return void z.setAttrib(n,i,o);"class"==i&&n.removeAttribute("className"),G.test(i)&&n.removeAttribute("data-mce-"+i),n.removeAttribute(i)}}),nt(e.classes,function(e){e=k(e,t),(!r||z.hasClass(r,e))&&z.removeClass(n,e)}),o=z.getAttribs(n),i=0;i<o.length;i++)if(0!==o[i].nodeName.indexOf("_"))return Y;return"none"!=e.remove?(D(n,e),X):void 0}function D(e,t){function n(e,t,n){return e=L(e,t,n),!e||"BR"==e.nodeName||q(e)}var r=e.parentNode,o;t.block&&($?r==z.getRoot()&&(t.list_block&&N(e,t.list_block)||nt(rt(e.childNodes),function(e){U($,e.nodeName.toLowerCase())?o?o.appendChild(e):(o=R(e,$),z.setAttribs(o,i.settings.forced_root_block_attrs)):o=0})):q(e)&&!q(r)&&(n(e,Y)||n(e.firstChild,X,1)||e.insertBefore(z.create("br"),e.firstChild),n(e,X)||n(e.lastChild,Y,1)||e.appendChild(z.create("br")))),t.selector&&t.inline&&!N(t.inline,e)||z.remove(e,1)}function L(e,t,n){if(e)for(t=t?"nextSibling":"previousSibling",e=n?e:e[t];e;e=e[t])if(1==e.nodeType||!T(e))return e}function M(e){return e&&1==e.nodeType&&"bookmark"==e.getAttribute("data-mce-type")}function H(e,t){function n(e,t){function n(e){var t={};return nt(z.getAttribs(e),function(n){var r=n.nodeName.toLowerCase();0!==r.indexOf("_")&&"style"!==r&&"data-mce-style"!==r&&(t[r]=z.getAttrib(e,r))}),t}function r(e,t){var n,r;for(r in e)if(e.hasOwnProperty(r)){if(n=t[r],n===Q)return Y;if(e[r]!=n)return Y;delete t[r]}for(r in t)if(t.hasOwnProperty(r))return Y;return X}return e.nodeName!=t.nodeName?Y:r(n(e),n(t))&&r(z.parseStyle(z.getAttrib(e,"style")),z.parseStyle(z.getAttrib(t,"style")))?!M(e)&&!M(t):Y}function r(e,t){for(i=e;i;i=i[t]){if(3==i.nodeType&&0!==i.nodeValue.length)return e;if(1==i.nodeType&&!M(i))return i}return e}var i,o;if(e&&t&&(e=r(e,"previousSibling"),t=r(t,"nextSibling"),n(e,t))){for(i=e.nextSibling;i&&i!=t;)o=i,i=i.nextSibling,e.appendChild(o);return z.remove(t),nt(rt(t.childNodes),function(t){e.appendChild(t)}),e}return t}function P(t,n){var r,o,a;return r=t[n?"startContainer":"endContainer"],o=t[n?"startOffset":"endOffset"],1==r.nodeType&&(a=r.childNodes.length-1,!n&&o&&o--,r=r.childNodes[o>a?a:o]),3===r.nodeType&&n&&o>=r.nodeValue.length&&(r=new e(r,i.getBody()).next()||r),3!==r.nodeType||n||0!==o||(r=new e(r,i.getBody()).prev()||r),r}function O(t,n,r){function a(e){var t=z.create("span",{id:y,"data-mce-bogus":!0,style:b?"color:red":""});return e&&t.appendChild(i.getDoc().createTextNode(K)),t}function s(e,t){for(;e;){if(3===e.nodeType&&e.nodeValue!==K||e.childNodes.length>1)return!1;t&&1===e.nodeType&&t.push(e),e=e.firstChild}return!0}function l(e){for(;e;){if(e.id===y)return e;e=e.parentNode}}function c(t){var n;if(t)for(n=new e(t,t),t=n.current();t;t=n.next())if(3===t.nodeType)return t}function d(e,t){var n,r;if(e)r=W.getRng(!0),s(e)?(t!==!1&&(r.setStartBefore(e),r.setEndBefore(e)),z.remove(e)):(n=c(e),n.nodeValue.charAt(0)===K&&(n=n.deleteData(0,1)),z.remove(e,1)),W.setRng(r);else if(e=l(W.getStart()),!e)for(;e=z.get(y);)d(e,!1)}function f(){var e,t,i,o,s,d,f;e=W.getRng(!0),o=e.startOffset,d=e.startContainer,f=d.nodeValue,t=l(W.getStart()),t&&(i=c(t)),f&&o>0&&o<f.length&&/\w/.test(f.charAt(o))&&/\w/.test(f.charAt(o-1))?(s=W.getBookmark(),e.collapse(!0),e=A(e,u(n)),e=V.split(e),h(n,r,e),W.moveToBookmark(s)):(t&&i.nodeValue===K?h(n,r,t):(t=a(!0),i=t.firstChild,e.insertNode(t),o=1,h(n,r,t)),W.setCursorLocation(i,o))}function p(){var e=W.getRng(!0),t,i,s,l,c,d,f=[],p,h;for(t=e.startContainer,i=e.startOffset,c=t,3==t.nodeType&&((i!=t.nodeValue.length||t.nodeValue===K)&&(l=!0),c=c.parentNode);c;){if(v(c,n,r)){d=c;break}c.nextSibling&&(l=!0),f.push(c),c=c.parentNode}if(d)if(l)s=W.getBookmark(),e.collapse(!0),e=A(e,u(n),!0),e=V.split(e),m(n,r,e),W.moveToBookmark(s);else{for(h=a(),c=h,p=f.length-1;p>=0;p--)c.appendChild(z.clone(f[p],!1)),c=c.firstChild;c.appendChild(z.doc.createTextNode(K)),c=c.firstChild;var g=z.getParent(d,o);g&&z.isEmpty(g)?d.parentNode.replaceChild(h,d):z.insertAfter(h,d),W.setCursorLocation(c,1),z.isEmpty(d)&&z.remove(d)}}function g(){var e;e=l(W.getStart()),e&&!z.isEmpty(e)&&it(e,function(e){1!=e.nodeType||e.id===y||z.isEmpty(e)||z.setAttrib(e,"data-mce-bogus",null)},"childNodes")}var y="_mce_caret",b=i.settings.caret_debug;i._hasCaretEvents||(tt=function(){var e=[],t;if(s(l(W.getStart()),e))for(t=e.length;t--;)z.setAttrib(e[t],"data-mce-bogus","1")},et=function(e){var t=e.keyCode;d(),(8==t||37==t||39==t)&&d(l(W.getStart())),g()},i.on("SetContent",function(e){e.selection&&g()}),i._hasCaretEvents=!0),"apply"==t?f():p()}function I(t){var n=t.startContainer,r=t.startOffset,i,o,a,s,l;if(3==n.nodeType&&r>=n.nodeValue.length&&(r=j(n),n=n.parentNode,i=!0),1==n.nodeType)for(s=n.childNodes,n=s[Math.min(r,s.length-1)],o=new e(n,z.getParent(n,z.isBlock)),(r>s.length-1||i)&&o.next(),a=o.current();a;a=o.next())if(3==a.nodeType&&!T(a))return l=z.create("a",null,K),a.parentNode.insertBefore(l,a),t.setStart(a,0),W.setRng(t),void z.remove(l)}var F={},z=i.dom,W=i.selection,V=new t(z),U=i.schema.isValidChild,q=z.isBlock,$=i.settings.forced_root_block,j=z.nodeIndex,K="\ufeff",G=/^(src|href|style)$/,Y=!1,X=!0,J,Q,Z=z.getContentEditable,et,tt,nt=n.each,rt=n.grep,it=n.walk,ot=n.extend;ot(this,{get:u,register:d,apply:h,remove:m,toggle:g,match:y,matchAll:b,matchNode:v,canApply:C,formatChanged:x,getCssText:w}),l(),c(),i.on("BeforeGetContent",function(){tt&&tt()}),i.on("mouseup keydown",function(e){et&&et(e)})}}),r(H,[g,p],function(e,t){var n=t.trim,r;return r=new RegExp(["<span[^>]+data-mce-bogus[^>]+>[\u200b\ufeff]+<\\/span>","<div[^>]+data-mce-bogus[^>]+><\\/div>",'\\s?data-mce-selected="[^"]+"'].join("|"),"gi"),function(t){function i(){return n(t.getContent({format:"raw",no_events:1}).replace(r,""))}function o(e){a.typing=!1,a.add({},e)}var a=this,s=0,l=[],c,u,d=0;return t.on("init",function(){a.add()}),t.on("BeforeExecCommand",function(e){var t=e.command;"Undo"!=t&&"Redo"!=t&&"mceRepaint"!=t&&a.beforeChange()}),t.on("ExecCommand",function(e){var t=e.command;"Undo"!=t&&"Redo"!=t&&"mceRepaint"!=t&&o(e)}),t.on("ObjectResizeStart",function(){a.beforeChange()}),t.on("SaveContent ObjectResized blur",o),t.on("DragEnd",o),t.on("KeyUp",function(n){var r=n.keyCode;(r>=33&&36>=r||r>=37&&40>=r||45==r||13==r||n.ctrlKey)&&(o(),t.nodeChanged()),(46==r||8==r||e.mac&&(91==r||93==r))&&t.nodeChanged(),u&&a.typing&&(t.isDirty()||(t.isNotDirty=!l[0]||i()==l[0].content,t.isNotDirty||t.fire("change",{level:l[0],lastLevel:null})),t.fire("TypingUndo"),u=!1,t.nodeChanged())}),t.on("KeyDown",function(e){var t=e.keyCode;return t>=33&&36>=t||t>=37&&40>=t||45==t?void(a.typing&&o(e)):void((16>t||t>20)&&224!=t&&91!=t&&!a.typing&&(a.beforeChange(),a.typing=!0,a.add({},e),u=!0))}),t.on("MouseDown",function(e){a.typing&&o(e)}),t.addShortcut("ctrl+z","","Undo"),t.addShortcut("ctrl+y,ctrl+shift+z","","Redo"),t.on("AddUndo Undo Redo ClearUndos MouseUp",function(e){e.isDefaultPrevented()||t.nodeChanged()}),a={data:l,typing:!1,beforeChange:function(){d||(c=t.selection.getBookmark(2,!0))},add:function(e,n){var r,o=t.settings,a;if(e=e||{},e.content=i(),d||t.removed)return null;if(a=l[s],t.fire("BeforeAddUndo",{level:e,lastLevel:a,originalEvent:n}).isDefaultPrevented())return null;if(a&&a.content==e.content)return null;if(l[s]&&(l[s].beforeBookmark=c),o.custom_undo_redo_levels&&l.length>o.custom_undo_redo_levels){for(r=0;r<l.length-1;r++)l[r]=l[r+1];l.length--,s=l.length}e.bookmark=t.selection.getBookmark(2,!0),s<l.length-1&&(l.length=s+1),l.push(e),s=l.length-1;var u={level:e,lastLevel:a,originalEvent:n};return t.fire("AddUndo",u),s>0&&(t.isNotDirty=!1,t.fire("change",u)),e},undo:function(){var e;return a.typing&&(a.add(),a.typing=!1),s>0&&(e=l[--s],0===s&&(t.isNotDirty=!0),t.setContent(e.content,{format:"raw"}),t.selection.moveToBookmark(e.beforeBookmark),t.fire("undo",{level:e})),e},redo:function(){var e;return s<l.length-1&&(e=l[++s],t.setContent(e.content,{format:"raw"}),t.selection.moveToBookmark(e.bookmark),t.fire("redo",{level:e})),e},clear:function(){l=[],s=0,a.typing=!1,t.fire("ClearUndos")},hasUndo:function(){return s>0||a.typing&&l[0]&&i()!=l[0].content},hasRedo:function(){return s<l.length-1&&!this.typing},transact:function(e){a.beforeChange();try{d++,e()}finally{d--}a.add()}}}}),r(P,[f,B,g],function(e,t,n){var r=n.ie&&n.ie<11;return function(i){function o(o){function f(e){return e&&a.isBlock(e)&&!/^(TD|TH|CAPTION|FORM)$/.test(e.nodeName)&&!/^(fixed|absolute)/i.test(e.style.position)&&"true"!==a.getContentEditable(e)}function p(e){var t;a.isBlock(e)&&(t=s.getRng(),e.appendChild(a.create("span",null,"\xa0")),s.select(e),e.lastChild.outerHTML="",s.setRng(t))}function h(e){for(var t=e,n=[],r;t=t.firstChild;){if(a.isBlock(t))return;1!=t.nodeType||d[t.nodeName.toLowerCase()]||n.push(t)}for(r=n.length;r--;)t=n[r],!t.hasChildNodes()||t.firstChild==t.lastChild&&""===t.firstChild.nodeValue?a.remove(t):"A"==t.nodeName&&" "===(t.innerText||t.textContent)&&a.remove(t)}function m(t){function r(e){for(;e;){if(1==e.nodeType||3==e.nodeType&&e.data&&/[\r\n\s]/.test(e.data))return e;e=e.nextSibling}}var i,o,l,c=t,u;if(n.ie&&n.ie<9&&B&&B.firstChild&&B.firstChild==B.lastChild&&"BR"==B.firstChild.tagName&&a.remove(B.firstChild),"LI"==t.nodeName){var f=r(t.firstChild);f&&/^(UL|OL)$/.test(f.nodeName)&&t.insertBefore(a.doc.createTextNode("\xa0"),t.firstChild)}if(l=a.createRng(),t.hasChildNodes()){for(i=new e(t,t);o=i.current();){if(3==o.nodeType){l.setStart(o,0),l.setEnd(o,0);break}if(d[o.nodeName.toLowerCase()]){l.setStartBefore(o),l.setEndBefore(o);break}c=o,o=i.next()}o||(l.setStart(c,0),l.setEnd(c,0))}else"BR"==t.nodeName?t.nextSibling&&a.isBlock(t.nextSibling)?((!D||9>D)&&(u=a.create("br"),t.parentNode.insertBefore(u,t)),l.setStartBefore(t),l.setEndBefore(t)):(l.setStartAfter(t),l.setEndAfter(t)):(l.setStart(t,0),l.setEnd(t,0));s.setRng(l),a.remove(u),s.scrollIntoView(t)}function g(e){var t=l.forced_root_block;t&&t.toLowerCase()===e.tagName.toLowerCase()&&a.setAttribs(e,l.forced_root_block_attrs)}function v(e){var t=R,n,i,o;if(e||"TABLE"==O?(n=a.create(e||F),g(n)):n=B.cloneNode(!1),o=n,l.keep_styles!==!1)do if(/^(SPAN|STRONG|B|EM|I|FONT|STRIKE|U|VAR|CITE|DFN|CODE|MARK|Q|SUP|SUB|SAMP)$/.test(t.nodeName)){if("_mce_caret"==t.id)continue;i=t.cloneNode(!1),a.setAttrib(i,"id",""),n.hasChildNodes()?(i.appendChild(n.firstChild),n.appendChild(i)):(o=i,n.appendChild(i))}while(t=t.parentNode);return r||(o.innerHTML='<br data-mce-bogus="1">'),n}function y(t){var n,r,i;if(3==R.nodeType&&(t?A>0:A<R.nodeValue.length))return!1;if(R.parentNode==B&&z&&!t)return!0;if(t&&1==R.nodeType&&R==B.firstChild)return!0;if("TABLE"===R.nodeName||R.previousSibling&&"TABLE"==R.previousSibling.nodeName)return z&&!t||!z&&t;for(n=new e(R,B),3==R.nodeType&&(t&&0===A?n.prev():t||A!=R.nodeValue.length||n.next());r=n.current();){if(1===r.nodeType){if(!r.getAttribute("data-mce-bogus")&&(i=r.nodeName.toLowerCase(),d[i]&&"br"!==i))return!1}else if(3===r.nodeType&&!/^[ \t\r\n]*$/.test(r.nodeValue))return!1;t?n.prev():n.next()}return!0}function b(e,t){var n,r,o,s,l,c,d=F||"P";if(r=a.getParent(e,a.isBlock),c=i.getBody().nodeName.toLowerCase(),!r||!f(r)){if(r=r||T,!r.hasChildNodes())return n=a.create(d),g(n),r.appendChild(n),S.setStart(n,0),S.setEnd(n,0),n;for(s=e;s.parentNode!=r;)s=s.parentNode;for(;s&&!a.isBlock(s);)o=s,s=s.previousSibling;if(o&&u.isValidChild(c,d.toLowerCase())){for(n=a.create(d),g(n),o.parentNode.insertBefore(n,o),s=o;s&&!a.isBlock(s);)l=s.nextSibling,n.appendChild(s),s=l;S.setStart(e,t),S.setEnd(e,t)}}return e}function C(){function e(e){for(var t=P[e?"firstChild":"lastChild"];t&&1!=t.nodeType;)t=t[e?"nextSibling":"previousSibling"];return t===B}function t(){var e=P.parentNode;return"LI"==e.nodeName?e:P}var n=P.parentNode.nodeName;/^(OL|UL|LI)$/.test(n)&&(F="LI"),M=F?v(F):a.create("BR"),e(!0)&&e()?"LI"==n?a.insertAfter(M,t()):a.replace(M,P):e(!0)?"LI"==n?(a.insertAfter(M,t()),M.appendChild(a.doc.createTextNode(" ")),M.appendChild(P)):P.parentNode.insertBefore(M,P):e()?(a.insertAfter(M,t()),p(M)):(P=t(),k=S.cloneRange(),k.setStartAfter(B),k.setEndAfter(P),H=k.extractContents(),"LI"==F&&"LI"==H.firstChild.nodeName?(M=H.firstChild,a.insertAfter(H,P)):(a.insertAfter(H,P),a.insertAfter(M,P))),a.remove(B),m(M),c.add()}function x(){for(var t=new e(R,B),n;n=t.next();)if(d[n.nodeName.toLowerCase()]||n.length>0)return!0}function w(){var e,t,n;R&&3==R.nodeType&&A>=R.nodeValue.length&&(r||x()||(e=a.create("br"),S.insertNode(e),S.setStartAfter(e),S.setEndAfter(e),t=!0)),e=a.create("br"),S.insertNode(e),r&&"PRE"==O&&(!D||8>D)&&e.parentNode.insertBefore(a.doc.createTextNode("\r"),e),n=a.create("span",{},"&nbsp;"),e.parentNode.insertBefore(n,e),s.scrollIntoView(n),a.remove(n),t?(S.setStartBefore(e),S.setEndBefore(e)):(S.setStartAfter(e),S.setEndAfter(e)),s.setRng(S),c.add()}function _(e){do 3===e.nodeType&&(e.nodeValue=e.nodeValue.replace(/^[\r\n]+/,"")),e=e.firstChild;while(e)}function N(e){var t=a.getRoot(),n,r;for(n=e;n!==t&&"false"!==a.getContentEditable(n);)"true"===a.getContentEditable(n)&&(r=n),n=n.parentNode;return n!==t?r:t}function E(e){var t;r||(e.normalize(),t=e.lastChild,(!t||/^(left|right)$/gi.test(a.getStyle(t,"float",!0)))&&a.add(e,"br"))}var S,k,T,R,A,B,D,L,M,H,P,O,I,F,z;if(S=s.getRng(!0),!o.isDefaultPrevented()){if(!S.collapsed)return void i.execCommand("Delete");if(new t(a).normalize(S),R=S.startContainer,A=S.startOffset,F=(l.force_p_newlines?"p":"")||l.forced_root_block,F=F?F.toUpperCase():"",D=a.doc.documentMode,L=o.shiftKey,1==R.nodeType&&R.hasChildNodes()&&(z=A>R.childNodes.length-1,R=R.childNodes[Math.min(A,R.childNodes.length-1)]||R,A=z&&3==R.nodeType?R.nodeValue.length:0),T=N(R)){if(c.beforeChange(),!a.isBlock(T)&&T!=a.getRoot())return void((!F||L)&&w());if((F&&!L||!F&&L)&&(R=b(R,A)),B=a.getParent(R,a.isBlock),P=B?a.getParent(B.parentNode,a.isBlock):null,O=B?B.nodeName.toUpperCase():"",I=P?P.nodeName.toUpperCase():"","LI"!=I||o.ctrlKey||(B=P,O=I),"LI"==O){if(!F&&L)return void w();if(a.isEmpty(B))return void C()}if("PRE"==O&&l.br_in_pre!==!1){if(!L)return void w()}else if(!F&&!L&&"LI"!=O||F&&L)return void w();F&&B===i.getBody()||(F=F||"P",y()?(M=/^(H[1-6]|PRE|FIGURE)$/.test(O)&&"HGROUP"!=I?v(F):v(),l.end_container_on_empty_block&&f(P)&&a.isEmpty(B)?M=a.split(P,B):a.insertAfter(M,B),m(M)):y(!0)?(M=B.parentNode.insertBefore(v(),B),p(M),m(B)):(k=S.cloneRange(),k.setEndAfter(B),H=k.extractContents(),_(H),M=H.firstChild,a.insertAfter(H,B),h(M),E(B),m(M)),a.setAttrib(M,"id",""),i.fire("NewBlock",{newBlock:M}),c.add())}}}var a=i.dom,s=i.selection,l=i.settings,c=i.undoManager,u=i.schema,d=u.getNonEmptyElements();i.on("keydown",function(e){13==e.keyCode&&o(e)!==!1&&e.preventDefault()})}}),r(O,[],function(){return function(e){function t(){var t=i.getStart(),s=e.getBody(),l,c,u,d,f,p,h,m=-16777215,g,v,y,b,C;if(C=n.forced_root_block,t&&1===t.nodeType&&C){for(;t&&t!=s;){if(a[t.nodeName])return;t=t.parentNode}if(l=i.getRng(),l.setStart){c=l.startContainer,u=l.startOffset,d=l.endContainer,f=l.endOffset;try{v=e.getDoc().activeElement===s}catch(x){}}else l.item&&(t=l.item(0),l=e.getDoc().body.createTextRange(),l.moveToElementText(t)),v=l.parentElement().ownerDocument===e.getDoc(),y=l.duplicate(),y.collapse(!0),u=-1*y.move("character",m),y.collapsed||(y=l.duplicate(),y.collapse(!1),f=-1*y.move("character",m)-u);for(t=s.firstChild,b=s.nodeName.toLowerCase();t;)if((3===t.nodeType||1==t.nodeType&&!a[t.nodeName])&&o.isValidChild(b,C.toLowerCase())){if(3===t.nodeType&&0===t.nodeValue.length){h=t,t=t.nextSibling,r.remove(h);continue}p||(p=r.create(C,e.settings.forced_root_block_attrs),t.parentNode.insertBefore(p,t),g=!0),h=t,t=t.nextSibling,p.appendChild(h)}else p=null,t=t.nextSibling;if(g&&v){if(l.setStart)l.setStart(c,u),l.setEnd(d,f),i.setRng(l);else try{l=e.getDoc().body.createTextRange(),l.moveToElementText(s),l.collapse(!0),l.moveStart("character",u),f>0&&l.moveEnd("character",f),l.select()}catch(x){}e.nodeChanged()}}}var n=e.settings,r=e.dom,i=e.selection,o=e.schema,a=o.getBlockElements();n.forced_root_block&&e.on("NodeChange",t)}}),r(I,[S,g,p],function(e,n,r){var i=r.each,o=r.extend,a=r.map,s=r.inArray,l=r.explode,c=n.gecko,u=n.ie,d=!0,f=!1;return function(r){function p(e,t,n){var r;return e=e.toLowerCase(),(r=N.exec[e])?(r(e,t,n),d):f}function h(e){var t;return e=e.toLowerCase(),(t=N.state[e])?t(e):-1}function m(e){var t;return e=e.toLowerCase(),(t=N.value[e])?t(e):f}function g(e,t){t=t||"exec",i(e,function(e,n){i(n.toLowerCase().split(","),function(n){N[t][n]=e})})}function v(e,n,i){return n===t&&(n=f),i===t&&(i=null),r.getDoc().execCommand(e,n,i)}function y(e){return S.match(e)}function b(e,n){S.toggle(e,n?{value:n}:t),r.nodeChanged()}function C(e){k=_.getBookmark(e)}function x(){_.moveToBookmark(k)}var w=r.dom,_=r.selection,N={state:{},exec:{},value:{}},E=r.settings,S=r.formatter,k;o(this,{execCommand:p,queryCommandState:h,queryCommandValue:m,addCommands:g}),g({"mceResetDesignMode,mceBeginUndoLevel":function(){},"mceEndUndoLevel,mceAddUndoLevel":function(){r.undoManager.add()},"Cut,Copy,Paste":function(e){var t=r.getDoc(),i;try{v(e)}catch(o){i=d}if(i||!t.queryCommandSupported(e)){var a=r.translate("Your browser doesn't support direct access to the clipboard. Please use the Ctrl+X/C/V keyboard shortcuts instead.");n.mac&&(a=a.replace(/Ctrl\+/g,"\u2318+")),r.windowManager.alert(a)}},unlink:function(){if(_.isCollapsed()){var e=_.getNode();return void("A"==e.tagName&&r.dom.remove(e,!0))}S.remove("link")},"JustifyLeft,JustifyCenter,JustifyRight,JustifyFull":function(e){var t=e.substring(7);"full"==t&&(t="justify"),i("left,center,right,justify".split(","),function(e){t!=e&&S.remove("align"+e)}),b("align"+t),p("mceRepaint")},"InsertUnorderedList,InsertOrderedList":function(e){var t,n;v(e),t=w.getParent(_.getNode(),"ol,ul"),t&&(n=t.parentNode,/^(H[1-6]|P|ADDRESS|PRE)$/.test(n.nodeName)&&(C(),w.split(n,t),x()))},"Bold,Italic,Underline,Strikethrough,Superscript,Subscript":function(e){b(e)},"ForeColor,HiliteColor,FontName":function(e,t,n){b(e,n)},FontSize:function(e,t,n){var r,i;n>=1&&7>=n&&(i=l(E.font_size_style_values),r=l(E.font_size_classes),n=r?r[n-1]||n:i[n-1]||n),b(e,n)},RemoveFormat:function(e){S.remove(e)},mceBlockQuote:function(){b("blockquote")},FormatBlock:function(e,t,n){return b(n||"p")},mceCleanup:function(){var e=_.getBookmark();r.setContent(r.getContent({cleanup:d}),{cleanup:d}),_.moveToBookmark(e)},mceRemoveNode:function(e,t,n){var i=n||_.getNode();i!=r.getBody()&&(C(),r.dom.remove(i,d),x())},mceSelectNodeDepth:function(e,t,n){var i=0;w.getParent(_.getNode(),function(e){return 1==e.nodeType&&i++==n?(_.select(e),f):void 0},r.getBody())},mceSelectNode:function(e,t,n){_.select(n)},mceInsertContent:function(t,n,i){function o(e){function t(e){return r[e]&&3==r[e].nodeType}var n,r,i;return n=_.getRng(!0),r=n.startContainer,i=n.startOffset,3==r.nodeType&&(i>0?e=e.replace(/^&nbsp;/," "):t("previousSibling")||(e=e.replace(/^ /,"&nbsp;")),i<r.length?e=e.replace(/&nbsp;(<br>|)$/," "):t("nextSibling")||(e=e.replace(/(&nbsp;| )(<br>|)$/,"&nbsp;"))),e}var a,s,l,c,d,f,p,h,m,g,v;/^ | $/.test(i)&&(i=o(i)),a=r.parser,s=new e({},r.schema),v='<span id="mce_marker" data-mce-type="bookmark">&#xFEFF;&#200B;</span>',f={content:i,format:"html",selection:!0},r.fire("BeforeSetContent",f),i=f.content,-1==i.indexOf("{$caret}")&&(i+="{$caret}"),i=i.replace(/\{\$caret\}/,v),h=_.getRng();var y=h.startContainer||(h.parentElement?h.parentElement():null),b=r.getBody();y===b&&_.isCollapsed()&&w.isBlock(b.firstChild)&&w.isEmpty(b.firstChild)&&(h=w.createRng(),h.setStart(b.firstChild,0),h.setEnd(b.firstChild,0),_.setRng(h)),_.isCollapsed()||r.getDoc().execCommand("Delete",!1,null),l=_.getNode();var C={context:l.nodeName.toLowerCase()};if(d=a.parse(i,C),m=d.lastChild,"mce_marker"==m.attr("id"))for(p=m,m=m.prev;m;m=m.walk(!0))if(3==m.type||!w.isBlock(m.name)){m.parent.insert(p,m,"br"===m.name);break}if(C.invalid){for(_.setContent(v),l=_.getNode(),c=r.getBody(),9==l.nodeType?l=m=c:m=l;m!==c;)l=m,m=m.parentNode;i=l==c?c.innerHTML:w.getOuterHTML(l),i=s.serialize(a.parse(i.replace(/<span (id="mce_marker"|id=mce_marker).+?<\/span>/i,function(){return s.serialize(d)}))),l==c?w.setHTML(c,i):w.setOuterHTML(l,i)}else i=s.serialize(d),m=l.firstChild,g=l.lastChild,!m||m===g&&"BR"===m.nodeName?w.setHTML(l,i):_.setContent(i);p=w.get("mce_marker"),_.scrollIntoView(p),h=w.createRng(),m=p.previousSibling,m&&3==m.nodeType?(h.setStart(m,m.nodeValue.length),u||(g=p.nextSibling,g&&3==g.nodeType&&(m.appendData(g.data),g.parentNode.removeChild(g)))):(h.setStartBefore(p),h.setEndBefore(p)),w.remove(p),_.setRng(h),r.fire("SetContent",f),r.addVisual()},mceInsertRawHTML:function(e,t,n){_.setContent("tiny_mce_marker"),r.setContent(r.getContent().replace(/tiny_mce_marker/g,function(){return n}))},mceToggleFormat:function(e,t,n){b(n)},mceSetContent:function(e,t,n){r.setContent(n)},"Indent,Outdent":function(e){var t,n,o;t=E.indentation,n=/[a-z%]+$/i.exec(t),t=parseInt(t,10),h("InsertUnorderedList")||h("InsertOrderedList")?v(e):(E.forced_root_block||w.getParent(_.getNode(),w.isBlock)||S.apply("div"),i(_.getSelectedBlocks(),function(i){if("LI"!=i.nodeName){var a=r.getParam("indent_use_margin",!1)?"margin":"padding";a+="rtl"==w.getStyle(i,"direction",!0)?"Right":"Left","outdent"==e?(o=Math.max(0,parseInt(i.style[a]||0,10)-t),w.setStyle(i,a,o?o+n:"")):(o=parseInt(i.style[a]||0,10)+t+n,w.setStyle(i,a,o))}}))},mceRepaint:function(){if(c)try{C(d),_.getSel()&&_.getSel().selectAllChildren(r.getBody()),_.collapse(d),x()}catch(e){}},InsertHorizontalRule:function(){r.execCommand("mceInsertContent",!1,"<hr />")},mceToggleVisualAid:function(){r.hasVisual=!r.hasVisual,r.addVisual()},mceReplaceContent:function(e,t,n){r.execCommand("mceInsertContent",!1,n.replace(/\{\$selection\}/g,_.getContent({format:"text"})))},mceInsertLink:function(e,t,n){var r;"string"==typeof n&&(n={href:n}),r=w.getParent(_.getNode(),"a"),n.href=n.href.replace(" ","%20"),r&&n.href||S.remove("link"),n.href&&S.apply("link",n,r)},selectAll:function(){var e=w.getRoot(),t;_.getRng().setStart?(t=w.createRng(),t.setStart(e,0),t.setEnd(e,e.childNodes.length),_.setRng(t)):(t=_.getRng(),t.item||(t.moveToElementText(e),t.select()))},"delete":function(){v("Delete");var e=r.getBody();w.isEmpty(e)&&(r.setContent(""),e.firstChild&&w.isBlock(e.firstChild)?r.selection.setCursorLocation(e.firstChild,0):r.selection.setCursorLocation(e,0))},mceNewDocument:function(){r.setContent("")}}),g({"JustifyLeft,JustifyCenter,JustifyRight,JustifyFull":function(e){var t="align"+e.substring(7),n=_.isCollapsed()?[w.getParent(_.getNode(),w.isBlock)]:_.getSelectedBlocks(),r=a(n,function(e){return!!S.matchNode(e,t)});return-1!==s(r,d)},"Bold,Italic,Underline,Strikethrough,Superscript,Subscript":function(e){return y(e)},mceBlockQuote:function(){return y("blockquote")},Outdent:function(){var e;if(E.inline_styles){if((e=w.getParent(_.getStart(),w.isBlock))&&parseInt(e.style.paddingLeft,10)>0)return d;if((e=w.getParent(_.getEnd(),w.isBlock))&&parseInt(e.style.paddingLeft,10)>0)return d
+}return h("InsertUnorderedList")||h("InsertOrderedList")||!E.inline_styles&&!!w.getParent(_.getNode(),"BLOCKQUOTE")},"InsertUnorderedList,InsertOrderedList":function(e){var t=w.getParent(_.getNode(),"ul,ol");return t&&("insertunorderedlist"===e&&"UL"===t.tagName||"insertorderedlist"===e&&"OL"===t.tagName)}},"state"),g({"FontSize,FontName":function(e){var t=0,n;return(n=w.getParent(_.getNode(),"span"))&&(t="fontsize"==e?n.style.fontSize:n.style.fontFamily.replace(/, /g,",").replace(/[\'\"]/g,"").toLowerCase()),t}},"value"),g({Undo:function(){r.undoManager.undo()},Redo:function(){r.undoManager.redo()}})}}),r(F,[p],function(e){function t(e,i){var o=this,a,s;if(e=r(e),i=o.settings=i||{},/^([\w\-]+):([^\/]{2})/i.test(e)||/^\s*#/.test(e))return void(o.source=e);var l=0===e.indexOf("//");0!==e.indexOf("/")||l||(e=(i.base_uri?i.base_uri.protocol||"http":"http")+"://mce_host"+e),/^[\w\-]*:?\/\//.test(e)||(s=i.base_uri?i.base_uri.path:new t(location.href).directory,e=""===i.base_uri.protocol?"//mce_host"+o.toAbsPath(s,e):(i.base_uri&&i.base_uri.protocol||"http")+"://mce_host"+o.toAbsPath(s,e)),e=e.replace(/@@/g,"(mce_at)"),e=/^(?:(?![^:@]+:[^:@\/]*@)([^:\/?#.]+):)?(?:\/\/)?((?:(([^:@\/]*):?([^:@\/]*))?@)?([^:\/?#]*)(?::(\d*))?)(((\/(?:[^?#](?![^?#\/]*\.[^?#\/.]+(?:[?#]|$)))*\/?)?([^?#\/]*))(?:\?([^#]*))?(?:#(.*))?)/.exec(e),n(["source","protocol","authority","userInfo","user","password","host","port","relative","path","directory","file","query","anchor"],function(t,n){var r=e[n];r&&(r=r.replace(/\(mce_at\)/g,"@@")),o[t]=r}),a=i.base_uri,a&&(o.protocol||(o.protocol=a.protocol),o.userInfo||(o.userInfo=a.userInfo),o.port||"mce_host"!==o.host||(o.port=a.port),o.host&&"mce_host"!==o.host||(o.host=a.host),o.source=""),l&&(o.protocol="")}var n=e.each,r=e.trim,i={ftp:21,http:80,https:443,mailto:25};return t.prototype={setPath:function(e){var t=this;e=/^(.*?)\/?(\w+)?$/.exec(e),t.path=e[0],t.directory=e[1],t.file=e[2],t.source="",t.getURI()},toRelative:function(e){var n=this,r;if("./"===e)return e;if(e=new t(e,{base_uri:n}),"mce_host"!=e.host&&n.host!=e.host&&e.host||n.port!=e.port||n.protocol!=e.protocol&&""!==e.protocol)return e.getURI();var i=n.getURI(),o=e.getURI();return i==o||"/"==i.charAt(i.length-1)&&i.substr(0,i.length-1)==o?i:(r=n.toRelPath(n.path,e.path),e.query&&(r+="?"+e.query),e.anchor&&(r+="#"+e.anchor),r)},toAbsolute:function(e,n){return e=new t(e,{base_uri:this}),e.getURI(n&&this.isSameOrigin(e))},isSameOrigin:function(e){if(this.host==e.host&&this.protocol==e.protocol){if(this.port==e.port)return!0;var t=i[this.protocol];if(t&&(this.port||t)==(e.port||t))return!0}return!1},toRelPath:function(e,t){var n,r=0,i="",o,a;if(e=e.substring(0,e.lastIndexOf("/")),e=e.split("/"),n=t.split("/"),e.length>=n.length)for(o=0,a=e.length;a>o;o++)if(o>=n.length||e[o]!=n[o]){r=o+1;break}if(e.length<n.length)for(o=0,a=n.length;a>o;o++)if(o>=e.length||e[o]!=n[o]){r=o+1;break}if(1===r)return t;for(o=0,a=e.length-(r-1);a>o;o++)i+="../";for(o=r-1,a=n.length;a>o;o++)i+=o!=r-1?"/"+n[o]:n[o];return i},toAbsPath:function(e,t){var r,i=0,o=[],a,s;for(a=/\/$/.test(t)?"/":"",e=e.split("/"),t=t.split("/"),n(e,function(e){e&&o.push(e)}),e=o,r=t.length-1,o=[];r>=0;r--)0!==t[r].length&&"."!==t[r]&&(".."!==t[r]?i>0?i--:o.push(t[r]):i++);return r=e.length-i,s=0>=r?o.reverse().join("/"):e.slice(0,r).join("/")+"/"+o.reverse().join("/"),0!==s.indexOf("/")&&(s="/"+s),a&&s.lastIndexOf("/")!==s.length-1&&(s+=a),s},getURI:function(e){var t,n=this;return(!n.source||e)&&(t="",e||(t+=n.protocol?n.protocol+"://":"//",n.userInfo&&(t+=n.userInfo+"@"),n.host&&(t+=n.host),n.port&&(t+=":"+n.port)),n.path&&(t+=n.path),n.query&&(t+="?"+n.query),n.anchor&&(t+="#"+n.anchor),n.source=t),n.source}},t}),r(z,[p],function(e){function t(){}var n=e.each,r=e.extend,i,o;return t.extend=i=function(e){function t(){var e,t,n,r=this;if(!o&&(r.init&&r.init.apply(r,arguments),t=r.Mixins))for(e=t.length;e--;)n=t[e],n.init&&n.init.apply(r,arguments)}function a(){return this}function s(e,t){return function(){var n=this,r=n._super,i;return n._super=c[e],i=t.apply(n,arguments),n._super=r,i}}var l=this,c=l.prototype,u,d,f;o=!0,u=new l,o=!1,e.Mixins&&(n(e.Mixins,function(t){t=t;for(var n in t)"init"!==n&&(e[n]=t[n])}),c.Mixins&&(e.Mixins=c.Mixins.concat(e.Mixins))),e.Methods&&n(e.Methods.split(","),function(t){e[t]=a}),e.Properties&&n(e.Properties.split(","),function(t){var n="_"+t;e[t]=function(e){var t=this,r;return e!==r?(t[n]=e,t):t[n]}}),e.Statics&&n(e.Statics,function(e,n){t[n]=e}),e.Defaults&&c.Defaults&&(e.Defaults=r({},c.Defaults,e.Defaults));for(d in e)f=e[d],u[d]="function"==typeof f&&c[d]?s(d,f):f;return t.prototype=u,t.constructor=t,t.extend=i,t},t}),r(W,[p],function(e){function t(e){function t(){return!1}function n(){return!0}function r(r,i){var o,a,s,u;if(r=r.toLowerCase(),i=i||{},i.type=r,i.target||(i.target=l),i.preventDefault||(i.preventDefault=function(){i.isDefaultPrevented=n},i.stopPropagation=function(){i.isPropagationStopped=n},i.stopImmediatePropagation=function(){i.isImmediatePropagationStopped=n},i.isDefaultPrevented=t,i.isPropagationStopped=t,i.isImmediatePropagationStopped=t),e.beforeFire&&e.beforeFire(i),o=c[r])for(a=0,s=o.length;s>a;a++){if(o[a]=u=o[a],i.isImmediatePropagationStopped())return i.stopPropagation(),i;if(u.call(l,i)===!1)return i.preventDefault(),i}return i}function i(e,n,r){var i,o,a;if(n===!1&&(n=t),n)for(o=e.toLowerCase().split(" "),a=o.length;a--;)e=o[a],i=c[e],i||(i=c[e]=[],u(e,!0)),r?i.unshift(n):i.push(n);return s}function o(e,t){var n,r,i,o,a;if(e)for(o=e.toLowerCase().split(" "),n=o.length;n--;){if(e=o[n],r=c[e],!e){for(i in c)u(i,!1),delete c[i];return s}if(r){if(t)for(a=r.length;a--;)r[a]===t&&r.splice(a,1);else r.length=0;r.length||(u(e,!1),delete c[e])}}else{for(e in c)u(e,!1);c={}}return s}function a(e){return e=e.toLowerCase(),!(!c[e]||0===c[e].length)}var s=this,l,c={},u;e=e||{},l=e.scope||s,u=e.toggleEvent||t,s.fire=r,s.on=i,s.off=o,s.has=a}var n=e.makeMap("focus blur focusin focusout click dblclick mousedown mouseup mousemove mouseover beforepaste paste cut copy selectionchange mouseout mouseenter mouseleave wheel keydown keypress keyup input contextmenu dragstart dragend dragover draggesture dragdrop drop drag submit"," ");return t.isNative=function(e){return!!n[e.toLowerCase()]},t}),r(V,[z],function(e){function t(e){for(var t=[],n=e.length,r;n--;)r=e[n],r.__checked||(t.push(r),r.__checked=1);for(n=t.length;n--;)delete t[n].__checked;return t}var n=/^([\w\\*]+)?(?:#([\w\\]+))?(?:\.([\w\\\.]+))?(?:\[\@?([\w\\]+)([\^\$\*!~]?=)([\w\\]+)\])?(?:\:(.+))?/i,r=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^\[\]]*\]|['"][^'"]*['"]|[^\[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g,i=/^\s*|\s*$/g,o,a=e.extend({init:function(e){function t(e){return e?(e=e.toLowerCase(),function(t){return"*"===e||t.type===e}):void 0}function o(e){return e?function(t){return t._name===e}:void 0}function a(e){return e?(e=e.split("."),function(t){for(var n=e.length;n--;)if(!t.hasClass(e[n]))return!1;return!0}):void 0}function s(e,t,n){return e?function(r){var i=r[e]?r[e]():"";return t?"="===t?i===n:"*="===t?i.indexOf(n)>=0:"~="===t?(" "+i+" ").indexOf(" "+n+" ")>=0:"!="===t?i!=n:"^="===t?0===i.indexOf(n):"$="===t?i.substr(i.length-n.length)===n:!1:!!n}:void 0}function l(e){var t;return e?(e=/(?:not\((.+)\))|(.+)/i.exec(e),e[1]?(t=u(e[1],[]),function(e){return!d(e,t)}):(e=e[2],function(t,n,r){return"first"===e?0===n:"last"===e?n===r-1:"even"===e?n%2===0:"odd"===e?n%2===1:t[e]?t[e]():!1})):void 0}function c(e,r,c){function u(e){e&&r.push(e)}var d;return d=n.exec(e.replace(i,"")),u(t(d[1])),u(o(d[2])),u(a(d[3])),u(s(d[4],d[5],d[6])),u(l(d[7])),r.psuedo=!!d[7],r.direct=c,r}function u(e,t){var n=[],i,o,a;do if(r.exec(""),o=r.exec(e),o&&(e=o[3],n.push(o[1]),o[2])){i=o[3];break}while(o);for(i&&u(i,t),e=[],a=0;a<n.length;a++)">"!=n[a]&&e.push(c(n[a],[],">"===n[a-1]));return t.push(e),t}var d=this.match;this._selectors=u(e,[])},match:function(e,t){var n,r,i,o,a,s,l,c,u,d,f,p,h;for(t=t||this._selectors,n=0,r=t.length;r>n;n++){for(a=t[n],o=a.length,h=e,p=0,i=o-1;i>=0;i--)for(c=a[i];h;){if(c.psuedo)for(f=h.parent().items(),u=d=f.length;u--&&f[u]!==h;);for(s=0,l=c.length;l>s;s++)if(!c[s](h,u,d)){s=l+1;break}if(s===l){p++;break}if(i===o-1)break;h=h.parent()}if(p===o)return!0}return!1},find:function(e){function n(e,t,i){var o,a,s,l,c,u=t[i];for(o=0,a=e.length;a>o;o++){for(c=e[o],s=0,l=u.length;l>s;s++)if(!u[s](c,o,a)){s=l+1;break}if(s===l)i==t.length-1?r.push(c):c.items&&n(c.items(),t,i+1);else if(u.direct)return;c.items&&n(c.items(),t,i)}}var r=[],i,s,l=this._selectors;if(e.items){for(i=0,s=l.length;s>i;i++)n(e.items(),l[i],0);s>1&&(r=t(r))}return o||(o=a.Collection),new o(r)}});return a}),r(U,[p,V,z],function(e,t,n){var r,i,o=Array.prototype.push,a=Array.prototype.slice;return i={length:0,init:function(e){e&&this.add(e)},add:function(t){var n=this;return e.isArray(t)?o.apply(n,t):t instanceof r?n.add(t.toArray()):o.call(n,t),n},set:function(e){var t=this,n=t.length,r;for(t.length=0,t.add(e),r=t.length;n>r;r++)delete t[r];return t},filter:function(e){var n=this,i,o,a=[],s,l;for("string"==typeof e?(e=new t(e),l=function(t){return e.match(t)}):l=e,i=0,o=n.length;o>i;i++)s=n[i],l(s)&&a.push(s);return new r(a)},slice:function(){return new r(a.apply(this,arguments))},eq:function(e){return-1===e?this.slice(e):this.slice(e,+e+1)},each:function(t){return e.each(this,t),this},toArray:function(){return e.toArray(this)},indexOf:function(e){for(var t=this,n=t.length;n--&&t[n]!==e;);return n},reverse:function(){return new r(e.toArray(this).reverse())},hasClass:function(e){return this[0]?this[0].hasClass(e):!1},prop:function(e,t){var n=this,r,i;return t!==r?(n.each(function(n){n[e]&&n[e](t)}),n):(i=n[0],i&&i[e]?i[e]():void 0)},exec:function(t){var n=this,r=e.toArray(arguments).slice(1);return n.each(function(e){e[t]&&e[t].apply(e,r)}),n},remove:function(){for(var e=this.length;e--;)this[e].remove();return this}},e.each("fire on off show hide addClass removeClass append prepend before after reflow".split(" "),function(t){i[t]=function(){var n=e.toArray(arguments);return this.each(function(e){t in e&&e[t].apply(e,n)}),this}}),e.each("text name disabled active selected checked visible parent value data".split(" "),function(e){i[e]=function(t){return this.prop(e,t)}}),r=n.extend(i),t.Collection=r,r}),r(q,[p,y],function(e,t){return{id:function(){return t.DOM.uniqueId()},createFragment:function(e){return t.DOM.createFragment(e)},getWindowSize:function(){return t.DOM.getViewPort()},getSize:function(e){var t,n;if(e.getBoundingClientRect){var r=e.getBoundingClientRect();t=Math.max(r.width||r.right-r.left,e.offsetWidth),n=Math.max(r.height||r.bottom-r.bottom,e.offsetHeight)}else t=e.offsetWidth,n=e.offsetHeight;return{width:t,height:n}},getPos:function(e,n){return t.DOM.getPos(e,n)},getViewPort:function(e){return t.DOM.getViewPort(e)},get:function(e){return document.getElementById(e)},addClass:function(e,n){return t.DOM.addClass(e,n)},removeClass:function(e,n){return t.DOM.removeClass(e,n)},hasClass:function(e,n){return t.DOM.hasClass(e,n)},toggleClass:function(e,n,r){return t.DOM.toggleClass(e,n,r)},css:function(e,n,r){return t.DOM.setStyle(e,n,r)},on:function(e,n,r,i){return t.DOM.bind(e,n,r,i)},off:function(e,n,r){return t.DOM.unbind(e,n,r)},fire:function(e,n,r){return t.DOM.fire(e,n,r)},innerHtml:function(e,n){t.DOM.setHTML(e,n)}}}),r($,[z,p,W,U,q],function(e,t,n,r,i){function o(e){return e._eventDispatcher||(e._eventDispatcher=new n({scope:e,toggleEvent:function(t,r){r&&n.isNative(t)&&(e._nativeEvents||(e._nativeEvents={}),e._nativeEvents[t]=!0,e._rendered&&e.bindPendingEvents())}})),e._eventDispatcher}var a={},s="onmousewheel"in document,l=!1,c="mce-",u=e.extend({Statics:{elementIdCache:a,classPrefix:c},isRtl:function(){return u.rtl},classPrefix:c,init:function(e){var n=this,r,o;if(n.settings=e=t.extend({},n.Defaults,e),n._id=e.id||i.id(),n._text=n._name="",n._width=n._height=0,n._aria={role:e.role},r=e.classes)for(r=r.split(" "),r.map={},o=r.length;o--;)r.map[r[o]]=!0;n._classes=r||[],n.visible(!0),t.each("title text width height name classes visible disabled active value".split(" "),function(t){var r=e[t],i;r!==i?n[t](r):n["_"+t]===i&&(n["_"+t]=!1)}),n.on("click",function(){return n.disabled()?!1:void 0}),e.classes&&t.each(e.classes.split(" "),function(e){n.addClass(e)}),n.settings=e,n._borderBox=n.parseBox(e.border),n._paddingBox=n.parseBox(e.padding),n._marginBox=n.parseBox(e.margin),e.hidden&&n.hide()},Properties:"parent,title,text,width,height,disabled,active,name,value",Methods:"renderHtml",getContainerElm:function(){return document.body},getParentCtrl:function(e){for(var t,n=this.getRoot().controlIdLookup;e&&n&&!(t=n[e.id]);)e=e.parentNode;return t},parseBox:function(e){var t,n=10;if(e)return"number"==typeof e?(e=e||0,{top:e,left:e,bottom:e,right:e}):(e=e.split(" "),t=e.length,1===t?e[1]=e[2]=e[3]=e[0]:2===t?(e[2]=e[0],e[3]=e[1]):3===t&&(e[3]=e[1]),{top:parseInt(e[0],n)||0,right:parseInt(e[1],n)||0,bottom:parseInt(e[2],n)||0,left:parseInt(e[3],n)||0})},borderBox:function(){return this._borderBox},paddingBox:function(){return this._paddingBox},marginBox:function(){return this._marginBox},measureBox:function(e,t){function n(t){var n=document.defaultView;return n?(t=t.replace(/[A-Z]/g,function(e){return"-"+e}),n.getComputedStyle(e,null).getPropertyValue(t)):e.currentStyle[t]}function r(e){var t=parseFloat(n(e),10);return isNaN(t)?0:t}return{top:r(t+"TopWidth"),right:r(t+"RightWidth"),bottom:r(t+"BottomWidth"),left:r(t+"LeftWidth")}},initLayoutRect:function(){var e=this,t=e.settings,n,r,o=e.getEl(),a,s,l,c,u,d,f,p;n=e._borderBox=e._borderBox||e.measureBox(o,"border"),e._paddingBox=e._paddingBox||e.measureBox(o,"padding"),e._marginBox=e._marginBox||e.measureBox(o,"margin"),p=i.getSize(o),d=t.minWidth,f=t.minHeight,l=d||p.width,c=f||p.height,a=t.width,s=t.height,u=t.autoResize,u="undefined"!=typeof u?u:!a&&!s,a=a||l,s=s||c;var h=n.left+n.right,m=n.top+n.bottom,g=t.maxWidth||65535,v=t.maxHeight||65535;return e._layoutRect=r={x:t.x||0,y:t.y||0,w:a,h:s,deltaW:h,deltaH:m,contentW:a-h,contentH:s-m,innerW:a-h,innerH:s-m,startMinWidth:d||0,startMinHeight:f||0,minW:Math.min(l,g),minH:Math.min(c,v),maxW:g,maxH:v,autoResize:u,scrollW:0},e._lastLayoutRect={},r},layoutRect:function(e){var t=this,n=t._layoutRect,r,i,o,a,s,l;return n||(n=t.initLayoutRect()),e?(o=n.deltaW,a=n.deltaH,e.x!==s&&(n.x=e.x),e.y!==s&&(n.y=e.y),e.minW!==s&&(n.minW=e.minW),e.minH!==s&&(n.minH=e.minH),i=e.w,i!==s&&(i=i<n.minW?n.minW:i,i=i>n.maxW?n.maxW:i,n.w=i,n.innerW=i-o),i=e.h,i!==s&&(i=i<n.minH?n.minH:i,i=i>n.maxH?n.maxH:i,n.h=i,n.innerH=i-a),i=e.innerW,i!==s&&(i=i<n.minW-o?n.minW-o:i,i=i>n.maxW-o?n.maxW-o:i,n.innerW=i,n.w=i+o),i=e.innerH,i!==s&&(i=i<n.minH-a?n.minH-a:i,i=i>n.maxH-a?n.maxH-a:i,n.innerH=i,n.h=i+a),e.contentW!==s&&(n.contentW=e.contentW),e.contentH!==s&&(n.contentH=e.contentH),r=t._lastLayoutRect,(r.x!==n.x||r.y!==n.y||r.w!==n.w||r.h!==n.h)&&(l=u.repaintControls,l&&l.map&&!l.map[t._id]&&(l.push(t),l.map[t._id]=!0),r.x=n.x,r.y=n.y,r.w=n.w,r.h=n.h),t):n},repaint:function(){var e=this,t,n,r,i,o=0,a=0,s,l;l=document.createRange?function(e){return e}:Math.round,t=e.getEl().style,r=e._layoutRect,s=e._lastRepaintRect||{},i=e._borderBox,o=i.left+i.right,a=i.top+i.bottom,r.x!==s.x&&(t.left=l(r.x)+"px",s.x=r.x),r.y!==s.y&&(t.top=l(r.y)+"px",s.y=r.y),r.w!==s.w&&(t.width=l(r.w-o)+"px",s.w=r.w),r.h!==s.h&&(t.height=l(r.h-a)+"px",s.h=r.h),e._hasBody&&r.innerW!==s.innerW&&(n=e.getEl("body").style,n.width=l(r.innerW)+"px",s.innerW=r.innerW),e._hasBody&&r.innerH!==s.innerH&&(n=n||e.getEl("body").style,n.height=l(r.innerH)+"px",s.innerH=r.innerH),e._lastRepaintRect=s,e.fire("repaint",{},!1)},on:function(e,t){function n(e){var t,n;return"string"!=typeof e?e:function(i){return t||r.parentsAndSelf().each(function(r){var i=r.settings.callbacks;return i&&(t=i[e])?(n=r,!1):void 0}),t.call(n,i)}}var r=this;return o(r).on(e,n(t)),r},off:function(e,t){return o(this).off(e,t),this},fire:function(e,t,n){var r=this;if(t=t||{},t.control||(t.control=r),t=o(r).fire(e,t),n!==!1&&r.parent)for(var i=r.parent();i&&!t.isPropagationStopped();)i.fire(e,t,!1),i=i.parent();return t},hasEventListeners:function(e){return o(this).has(e)},parents:function(e){var t=this,n,i=new r;for(n=t.parent();n;n=n.parent())i.add(n);return e&&(i=i.filter(e)),i},parentsAndSelf:function(e){return new r(this).add(this.parents(e))},next:function(){var e=this.parent().items();return e[e.indexOf(this)+1]},prev:function(){var e=this.parent().items();return e[e.indexOf(this)-1]},findCommonAncestor:function(e,t){for(var n;e;){for(n=t;n&&e!=n;)n=n.parent();if(e==n)break;e=e.parent()}return e},hasClass:function(e,t){var n=this._classes[t||"control"];return e=this.classPrefix+e,n&&!!n.map[e]},addClass:function(e,t){var n=this,r,i;return e=this.classPrefix+e,r=n._classes[t||"control"],r||(r=[],r.map={},n._classes[t||"control"]=r),r.map[e]||(r.map[e]=e,r.push(e),n._rendered&&(i=n.getEl(t),i&&(i.className=r.join(" ")))),n},removeClass:function(e,t){var n=this,r,i,o;if(e=this.classPrefix+e,r=n._classes[t||"control"],r&&r.map[e])for(delete r.map[e],i=r.length;i--;)r[i]===e&&r.splice(i,1);return n._rendered&&(o=n.getEl(t),o&&(o.className=r.join(" "))),n},toggleClass:function(e,t,n){var r=this;return t?r.addClass(e,n):r.removeClass(e,n),r},classes:function(e){var t=this._classes[e||"control"];return t?t.join(" "):""},innerHtml:function(e){return i.innerHtml(this.getEl(),e),this},getEl:function(e,t){var n,r=e?this._id+"-"+e:this._id;return n=a[r]=(t===!0?null:a[r])||i.get(r)},visible:function(e){var t=this,n;return"undefined"!=typeof e?(t._visible!==e&&(t._rendered&&(t.getEl().style.display=e?"":"none"),t._visible=e,n=t.parent(),n&&(n._lastRect=null),t.fire(e?"show":"hide")),t):t._visible},show:function(){return this.visible(!0)},hide:function(){return this.visible(!1)},focus:function(){try{this.getEl().focus()}catch(e){}return this},blur:function(){return this.getEl().blur(),this},aria:function(e,t){var n=this,r=n.getEl(n.ariaTarget);return"undefined"==typeof t?n._aria[e]:(n._aria[e]=t,n._rendered&&r.setAttribute("role"==e?e:"aria-"+e,t),n)},encode:function(e,t){return t!==!1&&(e=this.translate(e)),(e||"").replace(/[&<>"]/g,function(e){return"&#"+e.charCodeAt(0)+";"})},translate:function(e){return u.translate?u.translate(e):e},before:function(e){var t=this,n=t.parent();return n&&n.insert(e,n.items().indexOf(t),!0),t},after:function(e){var t=this,n=t.parent();return n&&n.insert(e,n.items().indexOf(t)),t},remove:function(){var e=this,t=e.getEl(),n=e.parent(),r,o;if(e.items){var s=e.items().toArray();for(o=s.length;o--;)s[o].remove()}n&&n.items&&(r=[],n.items().each(function(t){t!==e&&r.push(t)}),n.items().set(r),n._lastRect=null),e._eventsRoot&&e._eventsRoot==e&&i.off(t);var l=e.getRoot().controlIdLookup;if(l&&delete l[e._id],delete a[e._id],t&&t.parentNode){var c=t.getElementsByTagName("*");for(o=c.length;o--;)delete a[c[o].id];t.parentNode.removeChild(t)}return e._rendered=!1,e},renderBefore:function(e){var t=this;return e.parentNode.insertBefore(i.createFragment(t.renderHtml()),e),t.postRender(),t},renderTo:function(e){var t=this;return e=e||t.getContainerElm(),e.appendChild(i.createFragment(t.renderHtml())),t.postRender(),t},postRender:function(){var e=this,t=e.settings,n,r,o,a,s;for(a in t)0===a.indexOf("on")&&e.on(a.substr(2),t[a]);if(e._eventsRoot){for(o=e.parent();!s&&o;o=o.parent())s=o._eventsRoot;if(s)for(a in s._nativeEvents)e._nativeEvents[a]=!0}e.bindPendingEvents(),t.style&&(n=e.getEl(),n&&(n.setAttribute("style",t.style),n.style.cssText=t.style)),e._visible||i.css(e.getEl(),"display","none"),e.settings.border&&(r=e.borderBox(),i.css(e.getEl(),{"border-top-width":r.top,"border-right-width":r.right,"border-bottom-width":r.bottom,"border-left-width":r.left}));var l=e.getRoot();l.controlIdLookup||(l.controlIdLookup={}),l.controlIdLookup[e._id]=e;for(var c in e._aria)e.aria(c,e._aria[c]);e.fire("postrender",{},!1)},scrollIntoView:function(e){function t(e,t){var n,r,i=e;for(n=r=0;i&&i!=t&&i.nodeType;)n+=i.offsetLeft||0,r+=i.offsetTop||0,i=i.offsetParent;return{x:n,y:r}}var n=this.getEl(),r=n.parentNode,i,o,a,s,l,c,u=t(n,r);return i=u.x,o=u.y,a=n.offsetWidth,s=n.offsetHeight,l=r.clientWidth,c=r.clientHeight,"end"==e?(i-=l-a,o-=c-s):"center"==e&&(i-=l/2-a/2,o-=c/2-s/2),r.scrollLeft=i,r.scrollTop=o,this},bindPendingEvents:function(){function e(e){var t=o.getParentCtrl(e.target);t&&t.fire(e.type,e)}function t(){var e=d._lastHoverCtrl;e&&(e.fire("mouseleave",{target:e.getEl()}),e.parents().each(function(e){e.fire("mouseleave",{target:e.getEl()})}),d._lastHoverCtrl=null)}function n(e){var t=o.getParentCtrl(e.target),n=d._lastHoverCtrl,r=0,i,a,s;if(t!==n){if(d._lastHoverCtrl=t,a=t.parents().toArray().reverse(),a.push(t),n){for(s=n.parents().toArray().reverse(),s.push(n),r=0;r<s.length&&a[r]===s[r];r++);for(i=s.length-1;i>=r;i--)n=s[i],n.fire("mouseleave",{target:n.getEl()})}for(i=r;i<a.length;i++)t=a[i],t.fire("mouseenter",{target:t.getEl()})}}function r(e){e.preventDefault(),"mousewheel"==e.type?(e.deltaY=-1/40*e.wheelDelta,e.wheelDeltaX&&(e.deltaX=-1/40*e.wheelDeltaX)):(e.deltaX=0,e.deltaY=e.detail),e=o.fire("wheel",e)}var o=this,a,c,u,d,f,p;if(o._rendered=!0,f=o._nativeEvents){for(u=o.parents().toArray(),u.unshift(o),a=0,c=u.length;!d&&c>a;a++)d=u[a]._eventsRoot;for(d||(d=u[u.length-1]||o),o._eventsRoot=d,c=a,a=0;c>a;a++)u[a]._eventsRoot=d;var h=d._delegates;h||(h=d._delegates={});for(p in f){if(!f)return!1;"wheel"!==p||l?("mouseenter"===p||"mouseleave"===p?d._hasMouseEnter||(i.on(d.getEl(),"mouseleave",t),i.on(d.getEl(),"mouseover",n),d._hasMouseEnter=1):h[p]||(i.on(d.getEl(),p,e),h[p]=!0),f[p]=!1):s?i.on(o.getEl(),"mousewheel",r):i.on(o.getEl(),"DOMMouseScroll",r)}}},getRoot:function(){for(var e=this,t,n=[];e;){if(e.rootControl){t=e.rootControl;break}n.push(e),t=e,e=e.parent()}t||(t=this);for(var r=n.length;r--;)n[r].rootControl=t;return t},reflow:function(){return this.repaint(),this}});return u}),r(j,[],function(){var e={},t;return{add:function(t,n){e[t.toLowerCase()]=n},has:function(t){return!!e[t.toLowerCase()]},create:function(n,r){var i,o,a;if(!t){a=tinymce.ui;for(o in a)e[o.toLowerCase()]=a[o];t=!0}if("string"==typeof n?(r=r||{},r.type=n):(r=n,n=r.type),n=n.toLowerCase(),i=e[n],!i)throw new Error("Could not find control by type: "+n);return i=new i(r),i.type=n,i}}}),r(K,[],function(){return function(e){function t(e){return e=e||b,e&&e.getAttribute("role")}function n(e){for(var n,r=e||b;r=r.parentNode;)if(n=t(r))return n}function r(e){var t=b;return t?t.getAttribute("aria-"+e):void 0}function i(e){var t=e.tagName.toUpperCase();return"INPUT"==t||"TEXTAREA"==t}function o(e){return i(e)&&!e.hidden?!0:/^(button|menuitem|checkbox|tab|menuitemcheckbox|option|gridcell)$/.test(t(e))?!0:!1}function a(e){function t(e){if(1==e.nodeType&&"none"!=e.style.display){o(e)&&n.push(e);for(var r=0;r<e.childNodes.length;r++)t(e.childNodes[r])}}var n=[];return t(e||y.getEl()),n}function s(e){var t,n;e=e||C,n=e.parents().toArray(),n.unshift(e);for(var r=0;r<n.length&&(t=n[r],!t.settings.ariaRoot);r++);return t}function l(e){var t=s(e),n=a(t.getEl());t.settings.ariaRemember&&"lastAriaIndex"in t?c(t.lastAriaIndex,n):c(0,n)}function c(e,t){return 0>e?e=t.length-1:e>=t.length&&(e=0),t[e]&&t[e].focus(),e}function u(e,t){var n=-1,r=s();t=t||a(r.getEl());for(var i=0;i<t.length;i++)t[i]===b&&(n=i);n+=e,r.lastAriaIndex=c(n,t)}function d(){var e=n();"tablist"==e?u(-1,a(b.parentNode)):C.parent().submenu?g():u(-1)}function f(){var e=t(),i=n();"tablist"==i?u(1,a(b.parentNode)):"menuitem"==e&&"menu"==i&&r("haspopup")?v():u(1)}function p(){u(-1)}function h(){var e=t(),i=n();"menuitem"==e&&"menubar"==i?v():"button"==e&&r("haspopup")?v({key:"down"}):u(1)}function m(e){var t=n();if("tablist"==t){var r=a(C.getEl("body"))[0];r&&r.focus()}else u(e.shiftKey?-1:1)}function g(){C.fire("cancel")}function v(e){e=e||{},C.fire("click",{target:b,aria:e})}var y=e.root,b,C;return b=document.activeElement,C=y.getParentCtrl(b),y.on("keydown",function(e){function t(e,t){i(b)||t(e)!==!1&&e.preventDefault()}if(!e.isDefaultPrevented())switch(e.keyCode){case 37:t(e,d);break;case 39:t(e,f);break;case 38:t(e,p);break;case 40:t(e,h);break;case 27:g();break;case 14:case 13:case 32:t(e,v);break;case 9:m(e)!==!1&&e.preventDefault()}}),y.on("focusin",function(e){b=e.target,C=e.control}),{focusFirst:l}}}),r(G,[$,U,V,j,K,p,q],function(e,t,n,r,i,o,a){var s={};return e.extend({layout:"",innerClass:"container-inner",init:function(e){var n=this;n._super(e),e=n.settings,n._fixed=e.fixed,n._items=new t,n.isRtl()&&n.addClass("rtl"),n.addClass("container"),n.addClass("container-body","body"),e.containerCls&&n.addClass(e.containerCls),n._layout=r.create((e.layout||n.layout)+"layout"),n.settings.items&&n.add(n.settings.items),n._hasBody=!0},items:function(){return this._items},find:function(e){return e=s[e]=s[e]||new n(e),e.find(this)},add:function(e){var t=this;return t.items().add(t.create(e)).parent(t),t},focus:function(e){var t=this,n,r,i;return e&&(r=t.keyboardNav||t.parents().eq(-1)[0].keyboardNav)?void r.focusFirst(t):(i=t.find("*"),t.statusbar&&i.add(t.statusbar.items()),i.each(function(e){return e.settings.autofocus?(n=null,!1):void(e.canFocus&&(n=n||e))}),n&&n.focus(),t)},replace:function(e,t){for(var n,r=this.items(),i=r.length;i--;)if(r[i]===e){r[i]=t;break}i>=0&&(n=t.getEl(),n&&n.parentNode.removeChild(n),n=e.getEl(),n&&n.parentNode.removeChild(n)),t.parent(this)},create:function(t){var n=this,i,a=[];return o.isArray(t)||(t=[t]),o.each(t,function(t){t&&(t instanceof e||("string"==typeof t&&(t={type:t}),i=o.extend({},n.settings.defaults,t),t.type=i.type=i.type||t.type||n.settings.defaultType||(i.defaults?i.defaults.type:null),t=r.create(i)),a.push(t))}),a},renderNew:function(){var e=this;return e.items().each(function(t,n){var r,i;t.parent(e),t._rendered||(r=e.getEl("body"),i=a.createFragment(t.renderHtml()),r.hasChildNodes()&&n<=r.childNodes.length-1?r.insertBefore(i,r.childNodes[n]):r.appendChild(i),t.postRender())}),e._layout.applyClasses(e),e._lastRect=null,e},append:function(e){return this.add(e).renderNew()},prepend:function(e){var t=this;return t.items().set(t.create(e).concat(t.items().toArray())),t.renderNew()},insert:function(e,t,n){var r=this,i,o,a;return e=r.create(e),i=r.items(),!n&&t<i.length-1&&(t+=1),t>=0&&t<i.length&&(o=i.slice(0,t).toArray(),a=i.slice(t).toArray(),i.set(o.concat(e,a))),r.renderNew()},fromJSON:function(e){var t=this;for(var n in e)t.find("#"+n).value(e[n]);return t},toJSON:function(){var e=this,t={};return e.find("*").each(function(e){var n=e.name(),r=e.value();n&&"undefined"!=typeof r&&(t[n]=r)}),t},preRender:function(){},renderHtml:function(){var e=this,t=e._layout,n=this.settings.role;return e.preRender(),t.preRender(e),'<div id="'+e._id+'" class="'+e.classes()+'"'+(n?' role="'+this.settings.role+'"':"")+'><div id="'+e._id+'-body" class="'+e.classes("body")+'">'+(e.settings.html||"")+t.renderHtml(e)+"</div></div>"},postRender:function(){var e=this,t;return e.items().exec("postRender"),e._super(),e._layout.postRender(e),e._rendered=!0,e.settings.style&&a.css(e.getEl(),e.settings.style),e.settings.border&&(t=e.borderBox(),a.css(e.getEl(),{"border-top-width":t.top,"border-right-width":t.right,"border-bottom-width":t.bottom,"border-left-width":t.left})),e.parent()||(e.keyboardNav=new i({root:e})),e},initLayoutRect:function(){var e=this,t=e._super();return e._layout.recalc(e),t},recalc:function(){var e=this,t=e._layoutRect,n=e._lastRect;return n&&n.w==t.w&&n.h==t.h?void 0:(e._layout.recalc(e),t=e.layoutRect(),e._lastRect={x:t.x,y:t.y,w:t.w,h:t.h},!0)},reflow:function(){var t;if(this.visible()){for(e.repaintControls=[],e.repaintControls.map={},this.recalc(),t=e.repaintControls.length;t--;)e.repaintControls[t].repaint();"flow"!==this.settings.layout&&"stack"!==this.settings.layout&&this.repaint(),e.repaintControls=[]}return this}})}),r(Y,[q],function(e){function t(){var e=document,t,n,r,i,o,a,s,l,c=Math.max;return t=e.documentElement,n=e.body,r=c(t.scrollWidth,n.scrollWidth),i=c(t.clientWidth,n.clientWidth),o=c(t.offsetWidth,n.offsetWidth),a=c(t.scrollHeight,n.scrollHeight),s=c(t.clientHeight,n.clientHeight),l=c(t.offsetHeight,n.offsetHeight),{width:o>r?i:r,height:l>a?s:a}}return function(n,r){function i(){return a.getElementById(r.handle||n)}var o,a=document,s,l,c,u,d,f;r=r||{},l=function(n){var l=t(),p,h;n.preventDefault(),s=n.button,p=i(),d=n.screenX,f=n.screenY,h=window.getComputedStyle?window.getComputedStyle(p,null).getPropertyValue("cursor"):p.runtimeStyle.cursor,o=a.createElement("div"),e.css(o,{position:"absolute",top:0,left:0,width:l.width,height:l.height,zIndex:2147483647,opacity:1e-4,background:"red",cursor:h}),a.body.appendChild(o),e.on(a,"mousemove",u),e.on(a,"mouseup",c),r.start(n)},u=function(e){return e.button!==s?c(e):(e.deltaX=e.screenX-d,e.deltaY=e.screenY-f,e.preventDefault(),void r.drag(e))},c=function(t){e.off(a,"mousemove",u),e.off(a,"mouseup",c),o.parentNode.removeChild(o),r.stop&&r.stop(t)},this.destroy=function(){e.off(i())},e.on(i(),"mousedown",l)}}),r(X,[q,Y],function(e,t){return{init:function(){var e=this;e.on("repaint",e.renderScroll)},renderScroll:function(){function n(){function t(t,a,s,l,c,u){var d,f,p,h,m,g,v,y,b;if(f=i.getEl("scroll"+t)){if(y=a.toLowerCase(),b=s.toLowerCase(),i.getEl("absend")&&e.css(i.getEl("absend"),y,i.layoutRect()[l]-1),!c)return void e.css(f,"display","none");e.css(f,"display","block"),d=i.getEl("body"),p=i.getEl("scroll"+t+"t"),h=d["client"+s]-2*o,h-=n&&r?f["client"+u]:0,m=d["scroll"+s],g=h/m,v={},v[y]=d["offset"+a]+o,v[b]=h,e.css(f,v),v={},v[y]=d["scroll"+a]*g,v[b]=h*g,e.css(p,v)}}var n,r,a;a=i.getEl("body"),n=a.scrollWidth>a.clientWidth,r=a.scrollHeight>a.clientHeight,t("h","Left","Width","contentW",n,"Height"),t("v","Top","Height","contentH",r,"Width")}function r(){function n(n,r,a,s,l){var c,u=i._id+"-scroll"+n,d=i.classPrefix;i.getEl().appendChild(e.createFragment('<div id="'+u+'" class="'+d+"scrollbar "+d+"scrollbar-"+n+'"><div id="'+u+'t" class="'+d+'scrollbar-thumb"></div></div>')),i.draghelper=new t(u+"t",{start:function(){c=i.getEl("body")["scroll"+r],e.addClass(e.get(u),d+"active")},drag:function(e){var t,u,d,f,p=i.layoutRect();u=p.contentW>p.innerW,d=p.contentH>p.innerH,f=i.getEl("body")["client"+a]-2*o,f-=u&&d?i.getEl("scroll"+n)["client"+l]:0,t=f/i.getEl("body")["scroll"+a],i.getEl("body")["scroll"+r]=c+e["delta"+s]/t},stop:function(){e.removeClass(e.get(u),d+"active")}})}i.addClass("scroll"),n("v","Top","Height","Y","Width"),n("h","Left","Width","X","Height")}var i=this,o=2;i.settings.autoScroll&&(i._hasScroll||(i._hasScroll=!0,r(),i.on("wheel",function(e){var t=i.getEl("body");t.scrollLeft+=10*(e.deltaX||0),t.scrollTop+=10*e.deltaY,n()}),e.on(i.getEl("body"),"scroll",n)),n())}}}),r(J,[G,X],function(e,t){return e.extend({Defaults:{layout:"fit",containerCls:"panel"},Mixins:[t],renderHtml:function(){var e=this,t=e._layout,n=e.settings.html;return e.preRender(),t.preRender(e),"undefined"==typeof n?n='<div id="'+e._id+'-body" class="'+e.classes("body")+'">'+t.renderHtml(e)+"</div>":("function"==typeof n&&(n=n.call(e)),e._hasBody=!1),'<div id="'+e._id+'" class="'+e.classes()+'" hidefocus="1" tabindex="-1" role="group">'+(e._preBodyHtml||"")+n+"</div>"}})}),r(Q,[q],function(e){function t(t,n,r){var i,o,a,s,l,c,u,d,f,p;return f=e.getViewPort(),o=e.getPos(n),a=o.x,s=o.y,t._fixed&&(a-=f.x,s-=f.y),i=t.getEl(),p=e.getSize(i),l=p.width,c=p.height,p=e.getSize(n),u=p.width,d=p.height,r=(r||"").split(""),"b"===r[0]&&(s+=d),"r"===r[1]&&(a+=u),"c"===r[0]&&(s+=Math.round(d/2)),"c"===r[1]&&(a+=Math.round(u/2)),"b"===r[3]&&(s-=c),"r"===r[4]&&(a-=l),"c"===r[3]&&(s-=Math.round(c/2)),"c"===r[4]&&(a-=Math.round(l/2)),{x:a,y:s,w:l,h:c}}return{testMoveRel:function(n,r){for(var i=e.getViewPort(),o=0;o<r.length;o++){var a=t(this,n,r[o]);if(this._fixed){if(a.x>0&&a.x+a.w<i.w&&a.y>0&&a.y+a.h<i.h)return r[o]}else if(a.x>i.x&&a.x+a.w<i.w+i.x&&a.y>i.y&&a.y+a.h<i.h+i.y)return r[o]}return r[0]},moveRel:function(e,n){"string"!=typeof n&&(n=this.testMoveRel(e,n));
+var r=t(this,e,n);return this.moveTo(r.x,r.y)},moveBy:function(e,t){var n=this,r=n.layoutRect();return n.moveTo(r.x+e,r.y+t),n},moveTo:function(t,n){function r(e,t,n){return 0>e?0:e+n>t?(e=t-n,0>e?0:e):e}var i=this;if(i.settings.constrainToViewport){var o=e.getViewPort(window),a=i.layoutRect();t=r(t,o.w+o.x,a.w),n=r(n,o.h+o.y,a.h)}return i._rendered?i.layoutRect({x:t,y:n}).repaint():(i.settings.x=t,i.settings.y=n),i.fire("move",{x:t,y:n}),i}}}),r(Z,[q],function(e){return{resizeToContent:function(){this._layoutRect.autoResize=!0,this._lastRect=null,this.reflow()},resizeTo:function(t,n){if(1>=t||1>=n){var r=e.getWindowSize();t=1>=t?t*r.w:t,n=1>=n?n*r.h:n}return this._layoutRect.autoResize=!1,this.layoutRect({minW:t,minH:n,w:t,h:n}).reflow()},resizeBy:function(e,t){var n=this,r=n.layoutRect();return n.resizeTo(r.w+e,r.h+t)}}}),r(et,[J,Q,Z,q],function(e,t,n,r){function i(e){var t;for(t=s.length;t--;)s[t]===e&&s.splice(t,1);for(t=l.length;t--;)l[t]===e&&l.splice(t,1)}var o,a,s=[],l=[],c,u=e.extend({Mixins:[t,n],init:function(e){function t(){var e,t=u.zIndex||65535,n;if(l.length)for(e=0;e<l.length;e++)l[e].modal&&(t++,n=l[e]),l[e].getEl().style.zIndex=t,l[e].zIndex=t,t++;var i=document.getElementById(d.classPrefix+"modal-block");n?r.css(i,"z-index",n.zIndex-1):i&&(i.parentNode.removeChild(i),c=!1),u.currentZIndex=t}function n(e,t){for(;e;){if(e==t)return!0;e=e.parent()}}function i(e){function t(t,n){for(var r,i=0;i<s.length;i++)if(s[i]!=e)for(r=s[i].parent();r&&(r=r.parent());)r==e&&s[i].fixed(t).moveBy(0,n).repaint()}var n=r.getViewPort().y;e.settings.autofix&&(e._fixed?e._autoFixY>n&&(e.fixed(!1).layoutRect({y:e._autoFixY}).repaint(),t(!1,e._autoFixY-n)):(e._autoFixY=e.layoutRect().y,e._autoFixY<n&&(e.fixed(!0).layoutRect({y:0}).repaint(),t(!0,n-e._autoFixY))))}var d=this;d._super(e),d._eventsRoot=d,d.addClass("floatpanel"),e.autohide&&(o||(o=function(e){for(var t=s.length;t--;){var r=s[t],i=r.getParentCtrl(e.target);if(r.settings.autohide){if(i&&(n(i,r)||r.parent()===i))continue;e=r.fire("autohide",{target:e.target}),e.isDefaultPrevented()||r.hide()}}},r.on(document,"click",o)),s.push(d)),e.autofix&&(a||(a=function(){var e;for(e=s.length;e--;)i(s[e])},r.on(window,"scroll",a)),d.on("move",function(){i(this)})),d.on("postrender show",function(e){if(e.control==d){var n,i=d.classPrefix;d.modal&&!c&&(n=r.createFragment('<div id="'+i+'modal-block" class="'+i+"reset "+i+'fade"></div>'),n=n.firstChild,d.getContainerElm().appendChild(n),setTimeout(function(){r.addClass(n,i+"in"),r.addClass(d.getEl(),i+"in")},0),c=!0),l.push(d),t()}}),d.on("close hide",function(e){if(e.control==d){for(var n=l.length;n--;)l[n]===d&&l.splice(n,1);t()}}),d.on("show",function(){d.parents().each(function(e){return e._fixed?(d.fixed(!0),!1):void 0})}),e.popover&&(d._preBodyHtml='<div class="'+d.classPrefix+'arrow"></div>',d.addClass("popover").addClass("bottom").addClass(d.isRtl()?"end":"start"))},fixed:function(e){var t=this;if(t._fixed!=e){if(t._rendered){var n=r.getViewPort();e?t.layoutRect().y-=n.y:t.layoutRect().y+=n.y}t.toggleClass("fixed",e),t._fixed=e}return t},show:function(){var e=this,t,n=e._super();for(t=s.length;t--&&s[t]!==e;);return-1===t&&s.push(e),n},hide:function(){return i(this),this._super()},hideAll:function(){u.hideAll()},close:function(){var e=this;return e.fire("close"),e.remove()},remove:function(){i(this),this._super()},postRender:function(){var e=this;return e.settings.bodyRole&&this.getEl("body").setAttribute("role",e.settings.bodyRole),e._super()}});return u.hideAll=function(){for(var e=s.length;e--;){var t=s[e];t&&t.settings.autohide&&(t.hide(),s.splice(e,1))}},u}),r(tt,[et,J,q,Y],function(e,t,n,r){var i=e.extend({modal:!0,Defaults:{border:1,layout:"flex",containerCls:"panel",role:"dialog",callbacks:{submit:function(){this.fire("submit",{data:this.toJSON()})},close:function(){this.close()}}},init:function(e){var n=this;n._super(e),n.isRtl()&&n.addClass("rtl"),n.addClass("window"),n._fixed=!0,e.buttons&&(n.statusbar=new t({layout:"flex",border:"1 0 0 0",spacing:3,padding:10,align:"center",pack:n.isRtl()?"start":"end",defaults:{type:"button"},items:e.buttons}),n.statusbar.addClass("foot"),n.statusbar.parent(n)),n.on("click",function(e){-1!=e.target.className.indexOf(n.classPrefix+"close")&&n.close()}),n.on("cancel",function(){n.close()}),n.aria("describedby",n.describedBy||n._id+"-none"),n.aria("label",e.title),n._fullscreen=!1},recalc:function(){var e=this,t=e.statusbar,r,i,o,a;e._fullscreen&&(e.layoutRect(n.getWindowSize()),e.layoutRect().contentH=e.layoutRect().innerH),e._super(),r=e.layoutRect(),e.settings.title&&!e._fullscreen&&(i=r.headerW,i>r.w&&(o=r.x-Math.max(0,i/2),e.layoutRect({w:i,x:o}),a=!0)),t&&(t.layoutRect({w:e.layoutRect().innerW}).recalc(),i=t.layoutRect().minW+r.deltaW,i>r.w&&(o=r.x-Math.max(0,i-r.w),e.layoutRect({w:i,x:o}),a=!0)),a&&e.recalc()},initLayoutRect:function(){var e=this,t=e._super(),r=0,i;if(e.settings.title&&!e._fullscreen){i=e.getEl("head");var o=n.getSize(i);t.headerW=o.width,t.headerH=o.height,r+=t.headerH}e.statusbar&&(r+=e.statusbar.layoutRect().h),t.deltaH+=r,t.minH+=r,t.h+=r;var a=n.getWindowSize();return t.x=Math.max(0,a.w/2-t.w/2),t.y=Math.max(0,a.h/2-t.h/2),t},renderHtml:function(){var e=this,t=e._layout,n=e._id,r=e.classPrefix,i=e.settings,o="",a="",s=i.html;return e.preRender(),t.preRender(e),i.title&&(o='<div id="'+n+'-head" class="'+r+'window-head"><div id="'+n+'-title" class="'+r+'title">'+e.encode(i.title)+'</div><button type="button" class="'+r+'close" aria-hidden="true">\xd7</button><div id="'+n+'-dragh" class="'+r+'dragh"></div></div>'),i.url&&(s='<iframe src="'+i.url+'" tabindex="-1"></iframe>'),"undefined"==typeof s&&(s=t.renderHtml(e)),e.statusbar&&(a=e.statusbar.renderHtml()),'<div id="'+n+'" class="'+e.classes()+'" hidefocus="1"><div class="'+e.classPrefix+'reset" role="application">'+o+'<div id="'+n+'-body" class="'+e.classes("body")+'">'+s+"</div>"+a+"</div></div>"},fullscreen:function(e){var t=this,r=document.documentElement,i,o=t.classPrefix,a;if(e!=t._fullscreen)if(n.on(window,"resize",function(){var e;if(t._fullscreen)if(i)t._timer||(t._timer=setTimeout(function(){var e=n.getWindowSize();t.moveTo(0,0).resizeTo(e.w,e.h),t._timer=0},50));else{e=(new Date).getTime();var r=n.getWindowSize();t.moveTo(0,0).resizeTo(r.w,r.h),(new Date).getTime()-e>50&&(i=!0)}}),a=t.layoutRect(),t._fullscreen=e,e){t._initial={x:a.x,y:a.y,w:a.w,h:a.h},t._borderBox=t.parseBox("0"),t.getEl("head").style.display="none",a.deltaH-=a.headerH+2,n.addClass(r,o+"fullscreen"),n.addClass(document.body,o+"fullscreen"),t.addClass("fullscreen");var s=n.getWindowSize();t.moveTo(0,0).resizeTo(s.w,s.h)}else t._borderBox=t.parseBox(t.settings.border),t.getEl("head").style.display="",a.deltaH+=a.headerH,n.removeClass(r,o+"fullscreen"),n.removeClass(document.body,o+"fullscreen"),t.removeClass("fullscreen"),t.moveTo(t._initial.x,t._initial.y).resizeTo(t._initial.w,t._initial.h);return t.reflow()},postRender:function(){var e=this,t;setTimeout(function(){e.addClass("in")},0),e._super(),e.statusbar&&e.statusbar.postRender(),e.focus(),this.dragHelper=new r(e._id+"-dragh",{start:function(){t={x:e.layoutRect().x,y:e.layoutRect().y}},drag:function(n){e.moveTo(t.x+n.deltaX,t.y+n.deltaY)}}),e.on("submit",function(t){t.isDefaultPrevented()||e.close()})},submit:function(){return this.fire("submit",{data:this.toJSON()})},remove:function(){var e=this,t=e.classPrefix;e.dragHelper.destroy(),e._super(),e.statusbar&&this.statusbar.remove(),e._fullscreen&&(n.removeClass(document.documentElement,t+"fullscreen"),n.removeClass(document.body,t+"fullscreen"))},getContentWindow:function(){var e=this.getEl().getElementsByTagName("iframe")[0];return e?e.contentWindow:null}});return i}),r(nt,[tt],function(e){var t=e.extend({init:function(e){e={border:1,padding:20,layout:"flex",pack:"center",align:"center",containerCls:"panel",autoScroll:!0,buttons:{type:"button",text:"Ok",action:"ok"},items:{type:"label",multiline:!0,maxWidth:500,maxHeight:200}},this._super(e)},Statics:{OK:1,OK_CANCEL:2,YES_NO:3,YES_NO_CANCEL:4,msgBox:function(n){var r,i=n.callback||function(){};switch(n.buttons){case t.OK_CANCEL:r=[{type:"button",text:"Ok",subtype:"primary",onClick:function(e){e.control.parents()[1].close(),i(!0)}},{type:"button",text:"Cancel",onClick:function(e){e.control.parents()[1].close(),i(!1)}}];break;case t.YES_NO:r=[{type:"button",text:"Ok",subtype:"primary",onClick:function(e){e.control.parents()[1].close(),i(!0)}}];break;case t.YES_NO_CANCEL:r=[{type:"button",text:"Ok",subtype:"primary",onClick:function(e){e.control.parents()[1].close()}}];break;default:r=[{type:"button",text:"Ok",subtype:"primary",onClick:function(e){e.control.parents()[1].close(),i(!0)}}]}return new e({padding:20,x:n.x,y:n.y,minWidth:300,minHeight:100,layout:"flex",pack:"center",align:"center",buttons:r,title:n.title,role:"alertdialog",items:{type:"label",multiline:!0,maxWidth:500,maxHeight:200,text:n.text},onPostRender:function(){this.aria("describedby",this.items()[0]._id)},onClose:n.onClose,onCancel:function(){i(!1)}}).renderTo(document.body).reflow()},alert:function(e,n){return"string"==typeof e&&(e={text:e}),e.callback=n,t.msgBox(e)},confirm:function(e,n){return"string"==typeof e&&(e={text:e}),e.callback=n,e.buttons=t.OK_CANCEL,t.msgBox(e)}}});return t}),r(rt,[tt,nt],function(e,t){return function(n){function r(){return o.length?o[o.length-1]:void 0}var i=this,o=[];i.windows=o,i.open=function(t,r){var i;return n.editorManager.activeEditor=n,t.title=t.title||" ",t.url=t.url||t.file,t.url&&(t.width=parseInt(t.width||320,10),t.height=parseInt(t.height||240,10)),t.body&&(t.items={defaults:t.defaults,type:t.bodyType||"form",items:t.body}),t.url||t.buttons||(t.buttons=[{text:"Ok",subtype:"primary",onclick:function(){i.find("form")[0].submit()}},{text:"Cancel",onclick:function(){i.close()}}]),i=new e(t),o.push(i),i.on("close",function(){for(var e=o.length;e--;)o[e]===i&&o.splice(e,1);n.focus()}),t.data&&i.on("postRender",function(){this.find("*").each(function(e){var n=e.name();n in t.data&&e.value(t.data[n])})}),i.features=t||{},i.params=r||{},n.nodeChanged(),i.renderTo().reflow()},i.alert=function(e,r,i){t.alert(e,function(){r?r.call(i||this):n.focus()})},i.confirm=function(e,n,r){t.confirm(e,function(e){n.call(r||this,e)})},i.close=function(){r()&&r().close()},i.getParams=function(){return r()?r().params:null},i.setParams=function(e){r()&&(r().params=e)},i.getWindows=function(){return o}}}),r(it,[R,B,x,m,g,p],function(e,t,n,r,i,o){return function(a){function s(e,t){try{a.getDoc().execCommand(e,!1,t)}catch(n){}}function l(){var e=a.getDoc().documentMode;return e?e:6}function c(e){return e.isDefaultPrevented()}function u(){function t(e){var t=new i(function(){});o.each(a.getBody().getElementsByTagName("*"),function(e){"SPAN"==e.tagName&&e.setAttribute("mce-data-marked",1),!e.hasAttribute("data-mce-style")&&e.hasAttribute("style")&&a.dom.setAttrib(e,"style",e.getAttribute("style"))}),t.observe(a.getDoc(),{childList:!0,attributes:!0,subtree:!0,attributeFilter:["style"]}),a.getDoc().execCommand(e?"ForwardDelete":"Delete",!1,null);var n=a.selection.getRng(),r=n.startContainer.parentNode;o.each(t.takeRecords(),function(e){if(q.isChildOf(e.target,a.getBody())){if("style"==e.attributeName){var t=e.target.getAttribute("data-mce-style");t?e.target.setAttribute("style",t):e.target.removeAttribute("style")}o.each(e.addedNodes,function(e){if("SPAN"==e.nodeName&&!e.getAttribute("mce-data-marked")){var t,i;e==r&&(t=n.startOffset,i=e.firstChild),q.remove(e,!0),i&&(n.setStart(i,t),n.setEnd(i,t),a.selection.setRng(n))}})}}),t.disconnect(),o.each(a.dom.select("span[mce-data-marked]"),function(e){e.removeAttribute("mce-data-marked")})}var n=a.getDoc(),r="data:text/mce-internal,",i=window.MutationObserver,s,l;i||(s=!0,i=function(){function e(e){var t=e.relatedNode||e.target;n.push({target:t,addedNodes:[t]})}function t(e){var t=e.relatedNode||e.target;n.push({target:t,attributeName:e.attrName})}var n=[],r;this.observe=function(n){r=n,r.addEventListener("DOMSubtreeModified",e,!1),r.addEventListener("DOMNodeInsertedIntoDocument",e,!1),r.addEventListener("DOMNodeInserted",e,!1),r.addEventListener("DOMAttrModified",t,!1)},this.disconnect=function(){r.removeEventListener("DOMSubtreeModified",e,!1),r.removeEventListener("DOMNodeInsertedIntoDocument",e,!1),r.removeEventListener("DOMNodeInserted",e,!1),r.removeEventListener("DOMAttrModified",t,!1)},this.takeRecords=function(){return n}}),a.on("keydown",function(n){var r=n.keyCode==U,i=e.metaKeyPressed(n);if(!c(n)&&(r||n.keyCode==V)){var o=a.selection.getRng(),s=o.startContainer,l=o.startOffset;if(!i&&o.collapsed&&3==s.nodeType&&(r?l<s.data.length:l>0))return;n.preventDefault(),i&&a.selection.getSel().modify("extend",r?"forward":"backward","word"),t(r)}}),a.on("keypress",function(n){c(n)||$.isCollapsed()||!n.charCode||e.metaKeyPressed(n)||(n.preventDefault(),t(!0),a.selection.setContent(String.fromCharCode(n.charCode)))}),a.addCommand("Delete",function(){t()}),a.addCommand("ForwardDelete",function(){t(!0)}),s||(a.on("dragstart",function(e){var t;a.selection.isCollapsed()&&"IMG"==e.target.tagName&&$.select(e.target),l=$.getRng(),t=a.selection.getContent(),t.length>0&&e.dataTransfer.setData("URL","data:text/mce-internal,"+escape(t))}),a.on("drop",function(e){if(!c(e)){var i=e.dataTransfer.getData("URL");if(!i||-1==i.indexOf(r)||!n.caretRangeFromPoint)return;i=unescape(i.substr(r.length)),n.caretRangeFromPoint&&(e.preventDefault(),window.setTimeout(function(){var r=n.caretRangeFromPoint(e.x,e.y);l&&($.setRng(l),l=null),t(),$.setRng(r),a.insertContent(i)},0))}}),a.on("cut",function(e){!c(e)&&e.clipboardData&&(e.preventDefault(),e.clipboardData.clearData(),e.clipboardData.setData("text/html",a.selection.getContent()),e.clipboardData.setData("text/plain",a.selection.getContent({format:"text"})),t(!0))}))}function d(){function e(e){var t=q.create("body"),n=e.cloneContents();return t.appendChild(n),$.serializer.serialize(t,{format:"html"})}function n(n){if(!n.setStart){if(n.item)return!1;var r=n.duplicate();return r.moveToElementText(a.getBody()),t.compareRanges(n,r)}var i=e(n),o=q.createRng();o.selectNode(a.getBody());var s=e(o);return i===s}a.on("keydown",function(e){var t=e.keyCode,r,i;if(!c(e)&&(t==U||t==V)){if(r=a.selection.isCollapsed(),i=a.getBody(),r&&!q.isEmpty(i))return;if(!r&&!n(a.selection.getRng()))return;e.preventDefault(),a.setContent(""),i.firstChild&&q.isBlock(i.firstChild)?a.selection.setCursorLocation(i.firstChild,0):a.selection.setCursorLocation(i,0),a.nodeChanged()}})}function f(){a.on("keydown",function(t){!c(t)&&65==t.keyCode&&e.metaKeyPressed(t)&&(t.preventDefault(),a.execCommand("SelectAll"))})}function p(){a.settings.content_editable||(q.bind(a.getDoc(),"focusin",function(){$.setRng($.getRng())}),q.bind(a.getDoc(),"mousedown",function(e){e.target==a.getDoc().documentElement&&(a.getBody().focus(),$.setRng($.getRng()))}))}function h(){a.on("keydown",function(e){if(!c(e)&&e.keyCode===V&&$.isCollapsed()&&0===$.getRng(!0).startOffset){var t=$.getNode(),n=t.previousSibling;if("HR"==t.nodeName)return q.remove(t),void e.preventDefault();n&&n.nodeName&&"hr"===n.nodeName.toLowerCase()&&(q.remove(n),e.preventDefault())}})}function m(){window.Range.prototype.getClientRects||a.on("mousedown",function(e){if(!c(e)&&"HTML"===e.target.nodeName){var t=a.getBody();t.blur(),setTimeout(function(){t.focus()},0)}})}function g(){a.on("click",function(e){e=e.target,/^(IMG|HR)$/.test(e.nodeName)&&$.getSel().setBaseAndExtent(e,0,e,1),"A"==e.nodeName&&q.hasClass(e,"mce-item-anchor")&&$.select(e),a.nodeChanged()})}function v(){function e(){var e=q.getAttribs($.getStart().cloneNode(!1));return function(){var t=$.getStart();t!==a.getBody()&&(q.setAttrib(t,"style",null),W(e,function(e){t.setAttributeNode(e.cloneNode(!0))}))}}function t(){return!$.isCollapsed()&&q.getParent($.getStart(),q.isBlock)!=q.getParent($.getEnd(),q.isBlock)}a.on("keypress",function(n){var r;return c(n)||8!=n.keyCode&&46!=n.keyCode||!t()?void 0:(r=e(),a.getDoc().execCommand("delete",!1,null),r(),n.preventDefault(),!1)}),q.bind(a.getDoc(),"cut",function(n){var r;!c(n)&&t()&&(r=e(),setTimeout(function(){r()},0))})}function y(){var e,n;a.on("selectionchange",function(){n&&(clearTimeout(n),n=0),n=window.setTimeout(function(){if(!a.removed){var n=$.getRng();e&&t.compareRanges(n,e)||(a.nodeChanged(),e=n)}},50)})}function b(){document.body.setAttribute("role","application")}function C(){a.on("keydown",function(e){if(!c(e)&&e.keyCode===V&&$.isCollapsed()&&0===$.getRng(!0).startOffset){var t=$.getNode().previousSibling;if(t&&t.nodeName&&"table"===t.nodeName.toLowerCase())return e.preventDefault(),!1}})}function x(){l()>7||(s("RespectVisibilityInDesign",!0),a.contentStyles.push(".mceHideBrInPre pre br {display: none}"),q.addClass(a.getBody(),"mceHideBrInPre"),K.addNodeFilter("pre",function(e){for(var t=e.length,r,i,o,a;t--;)for(r=e[t].getAll("br"),i=r.length;i--;)o=r[i],a=o.prev,a&&3===a.type&&"\n"!=a.value.charAt(a.value-1)?a.value+="\n":o.parent.insert(new n("#text",3),o,!0).value="\n"}),G.addNodeFilter("pre",function(e){for(var t=e.length,n,r,i,o;t--;)for(n=e[t].getAll("br"),r=n.length;r--;)i=n[r],o=i.prev,o&&3==o.type&&(o.value=o.value.replace(/\r?\n$/,""))}))}function w(){q.bind(a.getBody(),"mouseup",function(){var e,t=$.getNode();"IMG"==t.nodeName&&((e=q.getStyle(t,"width"))&&(q.setAttrib(t,"width",e.replace(/[^0-9%]+/g,"")),q.setStyle(t,"width","")),(e=q.getStyle(t,"height"))&&(q.setAttrib(t,"height",e.replace(/[^0-9%]+/g,"")),q.setStyle(t,"height","")))})}function _(){a.on("keydown",function(t){var n,r,i,o,s;if(!c(t)&&t.keyCode==e.BACKSPACE&&(n=$.getRng(),r=n.startContainer,i=n.startOffset,o=q.getRoot(),s=r,n.collapsed&&0===i)){for(;s&&s.parentNode&&s.parentNode.firstChild==s&&s.parentNode!=o;)s=s.parentNode;"BLOCKQUOTE"===s.tagName&&(a.formatter.toggle("blockquote",null,s),n=q.createRng(),n.setStart(r,0),n.setEnd(r,0),$.setRng(n))}})}function N(){function e(){a._refreshContentEditable(),s("StyleWithCSS",!1),s("enableInlineTableEditing",!1),j.object_resizing||s("enableObjectResizing",!1)}j.readonly||a.on("BeforeExecCommand MouseDown",e)}function E(){function e(){W(q.select("a"),function(e){var t=e.parentNode,n=q.getRoot();if(t.lastChild===e){for(;t&&!q.isBlock(t);){if(t.parentNode.lastChild!==t||t===n)return;t=t.parentNode}q.add(t,"br",{"data-mce-bogus":1})}})}a.on("SetContent ExecCommand",function(t){("setcontent"==t.type||"mceInsertLink"===t.command)&&e()})}function S(){j.forced_root_block&&a.on("init",function(){s("DefaultParagraphSeparator",j.forced_root_block)})}function k(){a.on("Undo Redo SetContent",function(e){e.initial||a.execCommand("mceRepaint")})}function T(){a.on("keydown",function(e){var t;c(e)||e.keyCode!=V||(t=a.getDoc().selection.createRange(),t&&t.item&&(e.preventDefault(),a.undoManager.beforeChange(),q.remove(t.item(0)),a.undoManager.add()))})}function R(){var e;l()>=10&&(e="",W("p div h1 h2 h3 h4 h5 h6".split(" "),function(t,n){e+=(n>0?",":"")+t+":empty"}),a.contentStyles.push(e+"{padding-right: 1px !important}"))}function A(){l()<9&&(K.addNodeFilter("noscript",function(e){for(var t=e.length,n,r;t--;)n=e[t],r=n.firstChild,r&&n.attr("data-mce-innertext",r.value)}),G.addNodeFilter("noscript",function(e){for(var t=e.length,i,o,a;t--;)i=e[t],o=e[t].firstChild,o?o.value=r.decode(o.value):(a=i.attributes.map["data-mce-innertext"],a&&(i.attr("data-mce-innertext",null),o=new n("#text",3),o.value=a,o.raw=!0,i.append(o)))}))}function B(){function e(e,t){var n=i.createTextRange();try{n.moveToPoint(e,t)}catch(r){n=null}return n}function t(t){var r;t.button?(r=e(t.x,t.y),r&&(r.compareEndPoints("StartToStart",a)>0?r.setEndPoint("StartToStart",a):r.setEndPoint("EndToEnd",a),r.select())):n()}function n(){var e=r.selection.createRange();a&&!e.item&&0===e.compareEndPoints("StartToEnd",e)&&a.select(),q.unbind(r,"mouseup",n),q.unbind(r,"mousemove",t),a=o=0}var r=q.doc,i=r.body,o,a,s;r.documentElement.unselectable=!0,q.bind(r,"mousedown contextmenu",function(i){if("HTML"===i.target.nodeName){if(o&&n(),s=r.documentElement,s.scrollHeight>s.clientHeight)return;o=1,a=e(i.x,i.y),a&&(q.bind(r,"mouseup",n),q.bind(r,"mousemove",t),q.getRoot().focus(),a.select())}})}function D(){a.on("keyup focusin mouseup",function(t){65==t.keyCode&&e.metaKeyPressed(t)||$.normalize()},!0)}function L(){a.contentStyles.push("img:-moz-broken {-moz-force-broken-image-icon:1;min-width:24px;min-height:24px}")}function M(){a.inline||a.on("keydown",function(){document.activeElement==document.body&&a.getWin().focus()})}function H(){a.inline||(a.contentStyles.push("body {min-height: 150px}"),a.on("click",function(e){"HTML"==e.target.nodeName&&(a.getBody().focus(),a.selection.normalize(),a.nodeChanged())}))}function P(){i.mac&&a.on("keydown",function(t){!e.metaKeyPressed(t)||37!=t.keyCode&&39!=t.keyCode||(t.preventDefault(),a.selection.getSel().modify("move",37==t.keyCode?"backward":"forward","word"))})}function O(){s("AutoUrlDetect",!1)}function I(){a.inline||a.on("focus blur beforegetcontent",function(){var e=a.dom.create("br");a.getBody().appendChild(e),e.parentNode.removeChild(e)},!0)}function F(){a.on("click",function(e){var t=e.target;do if("A"===t.tagName)return void e.preventDefault();while(t=t.parentNode)}),a.contentStyles.push(".mce-content-body {-webkit-touch-callout: none}")}function z(){a.on("init",function(){a.dom.bind(a.getBody(),"submit",function(e){e.preventDefault()})})}var W=o.each,V=e.BACKSPACE,U=e.DELETE,q=a.dom,$=a.selection,j=a.settings,K=a.parser,G=a.serializer,Y=i.gecko,X=i.ie,J=i.webkit;C(),_(),d(),D(),J&&(u(),p(),g(),S(),z(),i.iOS?(y(),M(),H(),F()):f()),X&&i.ie<11&&(h(),b(),x(),w(),T(),R(),A(),B()),i.ie>=11&&(H(),I()),i.ie&&(f(),O()),Y&&(h(),m(),v(),N(),E(),k(),L(),P())}}),r(ot,[W],function(e){function t(t){return t._eventDispatcher||(t._eventDispatcher=new e({scope:t,toggleEvent:function(n,r){e.isNative(n)&&t.toggleNativeEvent&&t.toggleNativeEvent(n,r)}})),t._eventDispatcher}return{fire:function(e,n,r){var i=this;if(i.removed&&"remove"!==e)return n;if(n=t(i).fire(e,n,r),r!==!1&&i.parent)for(var o=i.parent();o&&!n.isPropagationStopped();)o.fire(e,n,!1),o=o.parent();return n},on:function(e,n,r){return t(this).on(e,n,r)},off:function(e,n){return t(this).off(e,n)},hasEventListeners:function(e){return t(this).has(e)}}}),r(at,[ot,y,p],function(e,t,n){function r(e,t){return"selectionchange"==t?e.getDoc():!e.inline&&/^mouse|click|contextmenu|drop/.test(t)?e.getDoc():e.getBody()}function i(e,t){var n=e.settings.event_root,i=e.editorManager,a=i.eventRootElm||r(e,t);if(n){if(i.rootEvents||(i.rootEvents={},i.on("RemoveEditor",function(){i.activeEditor||(o.unbind(a),delete i.rootEvents)})),i.rootEvents[t])return;a==e.getBody()&&(a=o.select(n)[0],i.eventRootElm=a),i.rootEvents[t]=!0,o.bind(a,t,function(e){for(var n=e.target,r=i.editors,a=r.length;a--;){var s=r[a].getBody();(s===n||o.isChildOf(n,s))&&(r[a].hidden||r[a].fire(t,e))}})}else e.dom.bind(a,t,function(n){e.hidden||e.fire(t,n)})}var o=t.DOM,a={bindPendingEventDelegates:function(){var e=this;n.each(e._pendingNativeEvents,function(t){i(e,t)})},toggleNativeEvent:function(e,t){var n=this;n.settings.readonly||"focus"!=e&&"blur"!=e&&(t?n.initialized?i(n,e):n._pendingNativeEvents?n._pendingNativeEvents.push(e):n._pendingNativeEvents=[e]:n.initialized&&n.dom.unbind(r(n,e),e))}};return a=n.extend({},e,a)}),r(st,[p,g],function(e,t){var n=e.each,r=e.explode,i={f9:120,f10:121,f11:122};return function(o){var a=this,s={};o.on("keyup keypress keydown",function(e){(e.altKey||e.ctrlKey||e.metaKey)&&n(s,function(n){var r=t.mac?e.metaKey:e.ctrlKey;if(n.ctrl==r&&n.alt==e.altKey&&n.shift==e.shiftKey)return e.keyCode==n.keyCode||e.charCode&&e.charCode==n.charCode?(e.preventDefault(),"keydown"==e.type&&n.func.call(n.scope),!0):void 0})}),a.add=function(t,a,l,c){var u;return u=l,"string"==typeof l?l=function(){o.execCommand(u,!1,null)}:e.isArray(u)&&(l=function(){o.execCommand(u[0],u[1],u[2])}),n(r(t.toLowerCase()),function(e){var t={func:l,scope:c||o,desc:o.translate(a),alt:!1,ctrl:!1,shift:!1};n(r(e,"+"),function(e){switch(e){case"alt":case"ctrl":case"shift":t[e]=!0;break;default:t.charCode=e.charCodeAt(0),t.keyCode=i[e]||e.toUpperCase().charCodeAt(0)}}),s[(t.ctrl?"ctrl":"")+","+(t.alt?"alt":"")+","+(t.shift?"shift":"")+","+t.keyCode]=t}),!0}}}),r(lt,[y,C,x,k,S,D,M,H,P,O,I,F,b,l,rt,w,N,it,g,p,at,st],function(e,n,r,i,o,a,s,l,c,u,d,f,p,h,m,g,v,y,b,C,x,w){function _(e,t,r){var i=this,o,a;o=i.documentBaseUrl=r.documentBaseURL,a=r.baseURI,i.settings=t=k({id:e,theme:"modern",delta_width:0,delta_height:0,popup_css:"",plugins:"",document_base_url:o,add_form_submit_trigger:!0,submit_patch:!0,add_unload_trigger:!0,convert_urls:!0,relative_urls:!0,remove_script_host:!0,object_resizing:!0,doctype:"<!DOCTYPE html>",visual:!0,font_size_style_values:"xx-small,x-small,small,medium,large,x-large,xx-large",font_size_legacy_values:"xx-small,small,medium,large,x-large,xx-large,300%",forced_root_block:"p",hidden_input:!0,padd_empty_editor:!0,render_ui:!0,indentation:"30px",inline_styles:!0,convert_fonts_to_spans:!0,indent:"simple",indent_before:"p,h1,h2,h3,h4,h5,h6,blockquote,div,title,style,pre,script,td,ul,li,area,table,thead,tfoot,tbody,tr,section,article,hgroup,aside,figure,option,optgroup,datalist",indent_after:"p,h1,h2,h3,h4,h5,h6,blockquote,div,title,style,pre,script,td,ul,li,area,table,thead,tfoot,tbody,tr,section,article,hgroup,aside,figure,option,optgroup,datalist",validate:!0,entity_encoding:"named",url_converter:i.convertURL,url_converter_scope:i,ie7_compat:!0},t),n.language=t.language||"en",n.languageLoad=t.language_load,n.baseURL=r.baseURL,i.id=t.id=e,i.isNotDirty=!0,i.plugins={},i.documentBaseURI=new f(t.document_base_url||o,{base_uri:a}),i.baseURI=a,i.contentCSS=[],i.contentStyles=[],i.shortcuts=new w(i),i.execCommands={},i.queryStateCommands={},i.queryValueCommands={},i.loadedCSS={},i.suffix=r.suffix,i.editorManager=r,i.inline=t.inline,r.fire("SetupEditor",i),i.execCallback("setup",i)}var N=e.DOM,E=n.ThemeManager,S=n.PluginManager,k=C.extend,T=C.each,R=C.explode,A=C.inArray,B=C.trim,D=C.resolve,L=h.Event,M=b.gecko,H=b.ie;return _.prototype={render:function(){function e(){N.unbind(window,"ready",e),n.render()}function t(){var e=p.ScriptLoader;if(r.language&&"en"!=r.language&&!r.language_url&&(r.language_url=n.editorManager.baseURL+"/langs/"+r.language+".js"),r.language_url&&e.add(r.language_url),r.theme&&"function"!=typeof r.theme&&"-"!=r.theme.charAt(0)&&!E.urls[r.theme]){var t=r.theme_url;t=t?n.documentBaseURI.toAbsolute(t):"themes/"+r.theme+"/theme"+o+".js",E.load(r.theme,t)}C.isArray(r.plugins)&&(r.plugins=r.plugins.join(" ")),T(r.external_plugins,function(e,t){S.load(t,e),r.plugins+=" "+t}),T(r.plugins.split(/[ ,]/),function(e){if(e=B(e),e&&!S.urls[e])if("-"==e.charAt(0)){e=e.substr(1,e.length);var t=S.dependencies(e);T(t,function(e){var t={prefix:"plugins/",resource:e,suffix:"/plugin"+o+".js"};e=S.createUrl(t,e),S.load(e.resource,e)})}else S.load(e,{prefix:"plugins/",resource:e,suffix:"/plugin"+o+".js"})}),e.loadQueue(function(){n.removed||n.init()})}var n=this,r=n.settings,i=n.id,o=n.suffix;if(!L.domLoaded)return void N.bind(window,"ready",e);if(n.getElement()&&b.contentEditable){r.inline?n.inline=!0:(n.orgVisibility=n.getElement().style.visibility,n.getElement().style.visibility="hidden");var a=n.getElement().form||N.getParent(i,"form");a&&(n.formElement=a,r.hidden_input&&!/TEXTAREA|INPUT/i.test(n.getElement().nodeName)&&(N.insertAfter(N.create("input",{type:"hidden",name:i}),i),n.hasHiddenInput=!0),n.formEventDelegate=function(e){n.fire(e.type,e)},N.bind(a,"submit reset",n.formEventDelegate),n.on("reset",function(){n.setContent(n.startContent,{format:"raw"})}),!r.submit_patch||a.submit.nodeType||a.submit.length||a._mceOldSubmit||(a._mceOldSubmit=a.submit,a.submit=function(){return n.editorManager.triggerSave(),n.isNotDirty=!0,a._mceOldSubmit(a)})),n.windowManager=new m(n),"xml"==r.encoding&&n.on("GetContent",function(e){e.save&&(e.content=N.encode(e.content))}),r.add_form_submit_trigger&&n.on("submit",function(){n.initialized&&n.save()}),r.add_unload_trigger&&(n._beforeUnload=function(){!n.initialized||n.destroyed||n.isHidden()||n.save({format:"raw",no_events:!0,set_dirty:!1})},n.editorManager.on("BeforeUnload",n._beforeUnload)),t()}},init:function(){function e(n){var r=S.get(n),i,o;i=S.urls[n]||t.documentBaseUrl.replace(/\/$/,""),n=B(n),r&&-1===A(m,n)&&(T(S.dependencies(n),function(t){e(t)}),o=new r(t,i),t.plugins[n]=o,o.init&&(o.init(t,i),m.push(n)))}var t=this,n=t.settings,r=t.getElement(),i,o,a,s,l,c,u,d,f,p,h,m=[];if(t.rtl=this.editorManager.i18n.rtl,t.editorManager.add(t),n.aria_label=n.aria_label||N.getAttrib(r,"aria-label",t.getLang("aria.rich_text_area")),n.theme&&("function"!=typeof n.theme?(n.theme=n.theme.replace(/-/,""),c=E.get(n.theme),t.theme=new c(t,E.urls[n.theme]),t.theme.init&&t.theme.init(t,E.urls[n.theme]||t.documentBaseUrl.replace(/\/$/,""))):t.theme=n.theme),T(n.plugins.replace(/\-/g,"").split(/[ ,]/),e),n.render_ui&&t.theme&&(t.orgDisplay=r.style.display,"function"!=typeof n.theme?(i=n.width||r.style.width||r.offsetWidth,o=n.height||r.style.height||r.offsetHeight,a=n.min_height||100,p=/^[0-9\.]+(|px)$/i,p.test(""+i)&&(i=Math.max(parseInt(i,10),100)),p.test(""+o)&&(o=Math.max(parseInt(o,10),a)),l=t.theme.renderUI({targetNode:r,width:i,height:o,deltaWidth:n.delta_width,deltaHeight:n.delta_height}),n.content_editable||(N.setStyles(l.sizeContainer||l.editorContainer,{wi2dth:i,h2eight:o}),o=(l.iframeHeight||o)+("number"==typeof o?l.deltaHeight||0:""),a>o&&(o=a))):(l=n.theme(t,r),l.editorContainer.nodeType&&(l.editorContainer=l.editorContainer.id=l.editorContainer.id||t.id+"_parent"),l.iframeContainer.nodeType&&(l.iframeContainer=l.iframeContainer.id=l.iframeContainer.id||t.id+"_iframecontainer"),o=l.iframeHeight||r.offsetHeight),t.editorContainer=l.editorContainer),n.content_css&&T(R(n.content_css),function(e){t.contentCSS.push(t.documentBaseURI.toAbsolute(e))}),n.content_style&&t.contentStyles.push(n.content_style),n.content_editable)return r=s=l=null,t.initContentBody();for(t.iframeHTML=n.doctype+"<html><head>",n.document_base_url!=t.documentBaseUrl&&(t.iframeHTML+='<base href="'+t.documentBaseURI.getURI()+'" />'),!b.caretAfter&&n.ie7_compat&&(t.iframeHTML+='<meta http-equiv="X-UA-Compatible" content="IE=7" />'),t.iframeHTML+='<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />',h=0;h<t.contentCSS.length;h++){var g=t.contentCSS[h];t.iframeHTML+='<link type="text/css" rel="stylesheet" href="'+g+'" />',t.loadedCSS[g]=!0}d=n.body_id||"tinymce",-1!=d.indexOf("=")&&(d=t.getParam("body_id","","hash"),d=d[t.id]||d),f=n.body_class||"",-1!=f.indexOf("=")&&(f=t.getParam("body_class","","hash"),f=f[t.id]||""),t.iframeHTML+='</head><body id="'+d+'" class="mce-content-body '+f+'" onload="window.parent.tinymce.get(\''+t.id+"').fire('load');\"><br></body></html>";var v='javascript:(function(){document.open();document.domain="'+document.domain+'";var ed = window.parent.tinymce.get("'+t.id+'");document.write(ed.iframeHTML);document.close();ed.initContentBody(true);})()';if(document.domain!=location.hostname&&(u=v),s=N.add(l.iframeContainer,"iframe",{id:t.id+"_ifr",src:u||'javascript:""',frameBorder:"0",allowTransparency:"true",title:t.editorManager.translate("Rich Text Area. Press ALT-F9 for menu. Press ALT-F10 for toolbar. Press ALT-0 for help"),style:{width:"100%",height:o,display:"block"}}),H)try{t.getDoc()}catch(y){s.src=u=v}t.contentAreaContainer=l.iframeContainer,l.editorContainer&&(N.get(l.editorContainer).style.display=t.orgDisplay),N.get(t.id).style.display="none",N.setAttrib(t.id,"aria-hidden",!0),u||t.initContentBody(),r=s=l=null},initContentBody:function(t){var n=this,o=n.settings,f=N.get(n.id),p=n.getDoc(),h,m;o.inline||(n.getElement().style.visibility=n.orgVisibility),t||o.content_editable||(p.open(),p.write(n.iframeHTML),p.close()),o.content_editable&&(n.on("remove",function(){var e=this.getBody();N.removeClass(e,"mce-content-body"),N.removeClass(e,"mce-edit-focus"),N.setAttrib(e,"contentEditable",null)}),N.addClass(f,"mce-content-body"),n.contentDocument=p=o.content_document||document,n.contentWindow=o.content_window||window,n.bodyElement=f,o.content_document=o.content_window=null,o.root_name=f.nodeName.toLowerCase()),h=n.getBody(),h.disabled=!0,o.readonly||(n.inline&&"static"==N.getStyle(h,"position",!0)&&(h.style.position="relative"),h.contentEditable=n.getParam("content_editable_state",!0)),h.disabled=!1,n.schema=new g(o),n.dom=new e(p,{keep_values:!0,url_converter:n.convertURL,url_converter_scope:n,hex_colors:o.force_hex_style_colors,class_filter:o.class_filter,update_styles:!0,root_element:o.content_editable?n.id:null,collect:o.content_editable,schema:n.schema,onSetAttrib:function(e){n.fire("SetAttrib",e)
+}}),n.parser=new v(o,n.schema),n.parser.addAttributeFilter("src,href,style,tabindex",function(e,t){for(var r=e.length,i,o=n.dom,a,s;r--;)i=e[r],a=i.attr(t),s="data-mce-"+t,i.attributes.map[s]||("style"===t?i.attr(s,o.serializeStyle(o.parseStyle(a),i.name)):"tabindex"===t?(i.attr(s,a),i.attr(t,null)):i.attr(s,n.convertURL(a,t,i.name)))}),n.parser.addNodeFilter("script",function(e){for(var t=e.length,n;t--;)n=e[t],n.attr("type","mce-"+(n.attr("type")||"text/javascript"))}),n.parser.addNodeFilter("#cdata",function(e){for(var t=e.length,n;t--;)n=e[t],n.type=8,n.name="#comment",n.value="[CDATA["+n.value+"]]"}),n.parser.addNodeFilter("p,h1,h2,h3,h4,h5,h6,div",function(e){for(var t=e.length,i,o=n.schema.getNonEmptyElements();t--;)i=e[t],i.isEmpty(o)&&(i.empty().append(new r("br",1)).shortEnded=!0)}),n.serializer=new i(o,n),n.selection=new a(n.dom,n.getWin(),n.serializer,n),n.formatter=new s(n),n.undoManager=new l(n),n.forceBlocks=new u(n),n.enterKey=new c(n),n.editorCommands=new d(n),n.fire("PreInit"),o.browser_spellcheck||o.gecko_spellcheck||(p.body.spellcheck=!1,N.setAttrib(h,"spellcheck","false")),n.fire("PostRender"),n.quirks=y(n),o.directionality&&(h.dir=o.directionality),o.nowrap&&(h.style.whiteSpace="nowrap"),o.protect&&n.on("BeforeSetContent",function(e){T(o.protect,function(t){e.content=e.content.replace(t,function(e){return"<!--mce:protected "+escape(e)+"-->"})})}),n.on("SetContent",function(){n.addVisual(n.getBody())}),o.padd_empty_editor&&n.on("PostProcess",function(e){e.content=e.content.replace(/^(<p[^>]*>(&nbsp;|&#160;|\s|\u00a0|)<\/p>[\r\n]*|<br \/>[\r\n]*)$/,"")}),n.load({initial:!0,format:"html"}),n.startContent=n.getContent({format:"raw"}),n.initialized=!0,n.bindPendingEventDelegates(),n.fire("init"),n.focus(!0),n.nodeChanged({initial:!0}),n.execCallback("init_instance_callback",n),n.contentStyles.length>0&&(m="",T(n.contentStyles,function(e){m+=e+"\r\n"}),n.dom.addStyle(m)),T(n.contentCSS,function(e){n.loadedCSS[e]||(n.dom.loadCSS(e),n.loadedCSS[e]=!0)}),o.auto_focus&&setTimeout(function(){var e=n.editorManager.get(o.auto_focus);e.selection.select(e.getBody(),1),e.selection.collapse(1),e.getBody().focus(),e.getWin().focus()},100),f=p=h=null},focus:function(e){var t,n=this,r=n.selection,i=n.settings.content_editable,o,a,s=n.getDoc(),l;if(!e){if(o=r.getRng(),o.item&&(a=o.item(0)),n._refreshContentEditable(),i||(b.opera||n.getBody().focus(),n.getWin().focus()),M||i){if(l=n.getBody(),l.setActive)try{l.setActive()}catch(c){l.focus()}else l.focus();i&&r.normalize()}a&&a.ownerDocument==s&&(o=s.body.createControlRange(),o.addElement(a),o.select())}n.editorManager.activeEditor!=n&&((t=n.editorManager.activeEditor)&&t.fire("deactivate",{relatedTarget:n}),n.fire("activate",{relatedTarget:t})),n.editorManager.activeEditor=n},execCallback:function(e){var t=this,n=t.settings[e],r;if(n)return t.callbackLookup&&(r=t.callbackLookup[e])&&(n=r.func,r=r.scope),"string"==typeof n&&(r=n.replace(/\.\w+$/,""),r=r?D(r):0,n=D(n),t.callbackLookup=t.callbackLookup||{},t.callbackLookup[e]={func:n,scope:r}),n.apply(r||t,Array.prototype.slice.call(arguments,1))},translate:function(e){var t=this.settings.language||"en",n=this.editorManager.i18n;return e?n.data[t+"."+e]||e.replace(/\{\#([^\}]+)\}/g,function(e,r){return n.data[t+"."+r]||"{#"+r+"}"}):""},getLang:function(e,n){return this.editorManager.i18n.data[(this.settings.language||"en")+"."+e]||(n!==t?n:"{#"+e+"}")},getParam:function(e,t,n){var r=e in this.settings?this.settings[e]:t,i;return"hash"===n?(i={},"string"==typeof r?T(r.split(r.indexOf("=")>0?/[;,](?![^=;,]*(?:[;,]|$))/:","),function(e){e=e.split("="),i[B(e[0])]=B(e.length>1?e[1]:e)}):i=r,i):r},nodeChanged:function(){var e=this,t=e.selection,n,r,i;!e.initialized||e.settings.disable_nodechange||e.settings.readonly||(i=e.getBody(),n=t.getStart()||i,n=H&&n.ownerDocument!=e.getDoc()?e.getBody():n,"IMG"==n.nodeName&&t.isCollapsed()&&(n=n.parentNode),r=[],e.dom.getParent(n,function(e){return e===i?!0:void r.push(e)}),e.fire("NodeChange",{element:n,parents:r}))},addButton:function(e,t){var n=this;t.cmd&&(t.onclick=function(){n.execCommand(t.cmd)}),t.text||t.icon||(t.icon=e),n.buttons=n.buttons||{},t.tooltip=t.tooltip||t.title,n.buttons[e]=t},addMenuItem:function(e,t){var n=this;t.cmd&&(t.onclick=function(){n.execCommand(t.cmd)}),n.menuItems=n.menuItems||{},n.menuItems[e]=t},addCommand:function(e,t,n){this.execCommands[e]={func:t,scope:n||this}},addQueryStateHandler:function(e,t,n){this.queryStateCommands[e]={func:t,scope:n||this}},addQueryValueHandler:function(e,t,n){this.queryValueCommands[e]={func:t,scope:n||this}},addShortcut:function(e,t,n,r){this.shortcuts.add(e,t,n,r)},execCommand:function(e,t,n,r){var i=this,o=0,a;return/^(mceAddUndoLevel|mceEndUndoLevel|mceBeginUndoLevel|mceRepaint)$/.test(e)||r&&r.skip_focus||i.focus(),r=k({},r),r=i.fire("BeforeExecCommand",{command:e,ui:t,value:n}),r.isDefaultPrevented()?!1:(a=i.execCommands[e])&&a.func.call(a.scope,t,n)!==!0?(i.fire("ExecCommand",{command:e,ui:t,value:n}),!0):(T(i.plugins,function(r){return r.execCommand&&r.execCommand(e,t,n)?(i.fire("ExecCommand",{command:e,ui:t,value:n}),o=!0,!1):void 0}),o?o:i.theme&&i.theme.execCommand&&i.theme.execCommand(e,t,n)?(i.fire("ExecCommand",{command:e,ui:t,value:n}),!0):i.editorCommands.execCommand(e,t,n)?(i.fire("ExecCommand",{command:e,ui:t,value:n}),!0):(i.getDoc().execCommand(e,t,n),void i.fire("ExecCommand",{command:e,ui:t,value:n})))},queryCommandState:function(e){var t=this,n,r;if(!t._isHidden()){if((n=t.queryStateCommands[e])&&(r=n.func.call(n.scope),r!==!0))return r;if(r=t.editorCommands.queryCommandState(e),-1!==r)return r;try{return t.getDoc().queryCommandState(e)}catch(i){}}},queryCommandValue:function(e){var n=this,r,i;if(!n._isHidden()){if((r=n.queryValueCommands[e])&&(i=r.func.call(r.scope),i!==!0))return i;if(i=n.editorCommands.queryCommandValue(e),i!==t)return i;try{return n.getDoc().queryCommandValue(e)}catch(o){}}},show:function(){var e=this;e.hidden&&(e.hidden=!1,e.inline?e.getBody().contentEditable=!0:(N.show(e.getContainer()),N.hide(e.id)),e.load(),e.fire("show"))},hide:function(){var e=this,t=e.getDoc();e.hidden||(e.hidden=!0,H&&t&&!e.inline&&t.execCommand("SelectAll"),e.save(),e.inline?(e.getBody().contentEditable=!1,e==e.editorManager.focusedEditor&&(e.editorManager.focusedEditor=null)):(N.hide(e.getContainer()),N.setStyle(e.id,"display",e.orgDisplay)),e.fire("hide"))},isHidden:function(){return!!this.hidden},setProgressState:function(e,t){this.fire("ProgressState",{state:e,time:t})},load:function(e){var n=this,r=n.getElement(),i;return r?(e=e||{},e.load=!0,i=n.setContent(r.value!==t?r.value:r.innerHTML,e),e.element=r,e.no_events||n.fire("LoadContent",e),e.element=r=null,i):void 0},save:function(e){var t=this,n=t.getElement(),r,i;if(n&&t.initialized)return e=e||{},e.save=!0,e.element=n,r=e.content=t.getContent(e),e.no_events||t.fire("SaveContent",e),r=e.content,/TEXTAREA|INPUT/i.test(n.nodeName)?n.value=r:(t.inline||(n.innerHTML=r),(i=N.getParent(t.id,"form"))&&T(i.elements,function(e){return e.name==t.id?(e.value=r,!1):void 0})),e.element=n=null,e.set_dirty!==!1&&(t.isNotDirty=!0),r},setContent:function(e,t){var n=this,r=n.getBody(),i;return t=t||{},t.format=t.format||"html",t.set=!0,t.content=e,t.no_events||n.fire("BeforeSetContent",t),e=t.content,0===e.length||/^\s+$/.test(e)?(i=n.settings.forced_root_block,i&&n.schema.isValidChild(r.nodeName.toLowerCase(),i.toLowerCase())?(e=H&&11>H?"":'<br data-mce-bogus="1">',e=n.dom.createHTML(i,n.settings.forced_root_block_attrs,e)):H||(e='<br data-mce-bogus="1">'),r.innerHTML=e,n.fire("SetContent",t)):("raw"!==t.format&&(e=new o({},n.schema).serialize(n.parser.parse(e,{isRootContent:!0}))),t.content=B(e),n.dom.setHTML(r,t.content),t.no_events||n.fire("SetContent",t)),t.content},getContent:function(e){var t=this,n,r=t.getBody();return e=e||{},e.format=e.format||"html",e.get=!0,e.getInner=!0,e.no_events||t.fire("BeforeGetContent",e),n="raw"==e.format?r.innerHTML:"text"==e.format?r.innerText||r.textContent:t.serializer.serialize(r,e),e.content="text"!=e.format?B(n):n,e.no_events||t.fire("GetContent",e),e.content},insertContent:function(e){this.execCommand("mceInsertContent",!1,e)},isDirty:function(){return!this.isNotDirty},getContainer:function(){var e=this;return e.container||(e.container=N.get(e.editorContainer||e.id+"_parent")),e.container},getContentAreaContainer:function(){return this.contentAreaContainer},getElement:function(){return N.get(this.settings.content_element||this.id)},getWin:function(){var e=this,t;return e.contentWindow||(t=N.get(e.id+"_ifr"),t&&(e.contentWindow=t.contentWindow)),e.contentWindow},getDoc:function(){var e=this,t;return e.contentDocument||(t=e.getWin(),t&&(e.contentDocument=t.document)),e.contentDocument},getBody:function(){return this.bodyElement||this.getDoc().body},convertURL:function(e,t,n){var r=this,i=r.settings;return i.urlconverter_callback?r.execCallback("urlconverter_callback",e,n,!0,t):!i.convert_urls||n&&"LINK"==n.nodeName||0===e.indexOf("file:")||0===e.length?e:i.relative_urls?r.documentBaseURI.toRelative(e):e=r.documentBaseURI.toAbsolute(e,i.remove_script_host)},addVisual:function(e){var n=this,r=n.settings,i=n.dom,o;e=e||n.getBody(),n.hasVisual===t&&(n.hasVisual=r.visual),T(i.select("table,a",e),function(e){var t;switch(e.nodeName){case"TABLE":return o=r.visual_table_class||"mce-item-table",t=i.getAttrib(e,"border"),void(t&&"0"!=t||(n.hasVisual?i.addClass(e,o):i.removeClass(e,o)));case"A":return void(i.getAttrib(e,"href",!1)||(t=i.getAttrib(e,"name")||e.id,o=r.visual_anchor_class||"mce-item-anchor",t&&(n.hasVisual?i.addClass(e,o):i.removeClass(e,o))))}}),n.fire("VisualAid",{element:e,hasVisual:n.hasVisual})},remove:function(){var e=this;if(!e.removed){e.removed=1,e.save(),e.hasHiddenInput&&N.remove(e.getElement().nextSibling),e.inline||(H&&10>H&&e.getDoc().execCommand("SelectAll",!1,null),N.setStyle(e.id,"display",e.orgDisplay),e.getBody().onload=null,L.unbind(e.getWin()),L.unbind(e.getDoc()));var t=e.getContainer();L.unbind(e.getBody()),L.unbind(t),e.fire("remove"),e.editorManager.remove(e),N.remove(t),e.destroy()}},destroy:function(e){var t=this,n;if(!t.destroyed){if(!e&&!t.removed)return void t.remove();e&&M&&(L.unbind(t.getDoc()),L.unbind(t.getWin()),L.unbind(t.getBody())),e||(t.editorManager.off("beforeunload",t._beforeUnload),t.theme&&t.theme.destroy&&t.theme.destroy(),t.selection.destroy(),t.dom.destroy()),n=t.formElement,n&&(n._mceOldSubmit&&(n.submit=n._mceOldSubmit,n._mceOldSubmit=null),N.unbind(n,"submit reset",t.formEventDelegate)),t.contentAreaContainer=t.formElement=t.container=t.editorContainer=null,t.settings.content_element=t.bodyElement=t.contentDocument=t.contentWindow=null,t.selection&&(t.selection=t.selection.win=t.selection.dom=t.selection.dom.doc=null),t.destroyed=1}},_refreshContentEditable:function(){var e=this,t,n;e._isHidden()&&(t=e.getBody(),n=t.parentNode,n.removeChild(t),n.appendChild(t),t.focus())},_isHidden:function(){var e;return M?(e=this.selection.getSel(),!e||!e.rangeCount||0===e.rangeCount):0}},k(_.prototype,x),_}),r(ct,[],function(){var e={};return{rtl:!1,add:function(t,n){for(var r in n)e[r]=n[r];this.rtl=this.rtl||"rtl"===e._dir},translate:function(t){if("undefined"==typeof t)return t;if("string"!=typeof t&&t.raw)return t.raw;if(t.push){var n=t.slice(1);t=(e[t[0]]||t[0]).replace(/\{([^\}]+)\}/g,function(e,t){return n[t]})}return e[t]||t},data:e}}),r(ut,[y,g],function(e,t){function n(e){function s(){try{return document.activeElement}catch(e){return document.body}}function l(e,t){if(t&&t.startContainer){if(!e.isChildOf(t.startContainer,e.getRoot())||!e.isChildOf(t.endContainer,e.getRoot()))return;return{startContainer:t.startContainer,startOffset:t.startOffset,endContainer:t.endContainer,endOffset:t.endOffset}}return t}function c(e,t){var n;return t.startContainer?(n=e.getDoc().createRange(),n.setStart(t.startContainer,t.startOffset),n.setEnd(t.endContainer,t.endOffset)):n=t,n}function u(e){return!!a.getParent(e,n.isEditorUIElement)}function d(n){var d=n.editor;d.on("init",function(){(d.inline||t.ie)&&(d.on("nodechange keyup",function(){var e=document.activeElement;e&&e.id==d.id+"_ifr"&&(e=d.getBody()),d.dom.isChildOf(e,d.getBody())&&(d.lastRng=d.selection.getRng())}),t.webkit&&!r&&(r=function(){var t=e.activeEditor;if(t&&t.selection){var n=t.selection.getRng();n&&!n.collapsed&&(d.lastRng=n)}},a.bind(document,"selectionchange",r)))}),d.on("setcontent",function(){d.lastRng=null}),d.on("mousedown",function(){d.selection.lastFocusBookmark=null}),d.on("focusin",function(){var t=e.focusedEditor;d.selection.lastFocusBookmark&&(d.selection.setRng(c(d,d.selection.lastFocusBookmark)),d.selection.lastFocusBookmark=null),t!=d&&(t&&t.fire("blur",{focusedEditor:d}),e.activeEditor=d,e.focusedEditor=d,d.fire("focus",{blurredEditor:t}),d.focus(!0)),d.lastRng=null}),d.on("focusout",function(){window.setTimeout(function(){var t=e.focusedEditor;u(s())||t!=d||(d.fire("blur",{focusedEditor:null}),e.focusedEditor=null,d.selection&&(d.selection.lastFocusBookmark=null))},0)}),i||(i=function(t){var n=e.activeEditor;n&&t.target.ownerDocument==document&&(n.selection&&(n.selection.lastFocusBookmark=l(n.dom,n.lastRng)),u(t.target)||e.focusedEditor!=n||(n.fire("blur",{focusedEditor:null}),e.focusedEditor=null))},a.bind(document,"focusin",i)),d.inline&&!o&&(o=function(t){var n=e.activeEditor;if(n.inline&&!n.dom.isChildOf(t.target,n.getBody())){var r=n.selection.getRng();r.collapsed||(n.lastRng=r)}},a.bind(document,"mouseup",o))}function f(t){e.focusedEditor==t.editor&&(e.focusedEditor=null),e.activeEditor||(a.unbind(document,"selectionchange",r),a.unbind(document,"focusin",i),a.unbind(document,"mouseup",o),r=i=o=null)}e.on("AddEditor",d),e.on("RemoveEditor",f)}var r,i,o,a=e.DOM;return n.isEditorUIElement=function(e){return-1!==e.className.toString().indexOf("mce-")},n}),r(dt,[lt,y,F,g,p,ot,ct,ut],function(e,t,n,r,i,o,a,s){function l(e){var t=g.editors,n;delete t[e.id];for(var r=0;r<t.length;r++)if(t[r]==e){t.splice(r,1),n=!0;break}return g.activeEditor==e&&(g.activeEditor=t[0]),g.focusedEditor==e&&(g.focusedEditor=null),n}function c(e){return e&&!(e.getContainer()||e.getBody()).parentNode&&(l(e),e.destroy(!0),e=null),e}var u=t.DOM,d=i.explode,f=i.each,p=i.extend,h=0,m,g;return g={majorVersion:"4",minorVersion:"0.26",releaseDate:"2014-05-06",editors:[],i18n:a,activeEditor:null,setup:function(){var e=this,t,r,i="",o,a;if(r=document.location.href.replace(/[\?#].*$/,"").replace(/[\/\\][^\/]+$/,""),/[\/\\]$/.test(r)||(r+="/"),o=window.tinymce||window.tinyMCEPreInit)t=o.base||o.baseURL,i=o.suffix;else{for(var l=document.getElementsByTagName("script"),c=0;c<l.length;c++)if(a=l[c].src,/tinymce(\.full|\.jquery|)(\.min|\.dev|)\.js/.test(a)){-1!=a.indexOf(".min")&&(i=".min"),t=a.substring(0,a.lastIndexOf("/"));break}!t&&document.currentScript&&(a=document.currentScript.src,-1!=a.indexOf(".min")&&(i=".min"),t=a.substring(0,a.lastIndexOf("/")))}e.baseURL=new n(r).toAbsolute(t),e.documentBaseURL=r,e.baseURI=new n(e.baseURL),e.suffix=i,e.focusManager=new s(e)},init:function(t){function n(e){var t=e.id;return t||(t=e.name,t=t&&!u.get(t)?e.name:u.uniqueId(),e.setAttribute("id",t)),t}function r(t,n){if(!c(s.get(t))){var r=new e(t,n,s);l.push(r),r.render()}}function i(e,t,n){var r=e[t];if(r)return r.apply(n||this,Array.prototype.slice.call(arguments,2))}function o(e,t){return t.constructor===RegExp?t.test(e.className):u.hasClass(e,t)}function a(){var c,g;if(u.unbind(window,"ready",a),i(t,"onpageload"),t.types)return void f(t.types,function(e){f(u.select(e.selector),function(i){r(n(i),p({},t,e))})});if(t.selector)return void f(u.select(t.selector),function(e){r(n(e),t)});switch(t.mode){case"exact":c=t.elements||"",c.length>0&&f(d(c),function(n){u.get(n)?(m=new e(n,t,s),l.push(m),m.render()):f(document.forms,function(e){f(e.elements,function(e){e.name===n&&(n="mce_editor_"+h++,u.setAttrib(e,"id",n),r(n,t))})})});break;case"textareas":case"specific_textareas":f(u.select("textarea"),function(e){t.editor_deselector&&o(e,t.editor_deselector)||(!t.editor_selector||o(e,t.editor_selector))&&r(n(e),t)})}t.oninit&&(c=g=0,f(l,function(e){g++,e.initialized?c++:e.on("init",function(){c++,c==g&&i(t,"oninit")}),c==g&&i(t,"oninit")}))}var s=this,l=[],m;s.settings=t,u.bind(window,"ready",a)},get:function(e){return arguments.length?e in this.editors?this.editors[e]:null:this.editors},add:function(e){var t=this,n=t.editors;return n[e.id]=e,n.push(e),t.activeEditor=e,t.fire("AddEditor",{editor:e}),m||(m=function(){t.fire("BeforeUnload")},u.bind(window,"beforeunload",m)),e},createEditor:function(t,n){return this.add(new e(t,n,this))},remove:function(e){var t=this,n,r=t.editors,i;{if(e)return"string"==typeof e?(e=e.selector||e,void f(u.select(e),function(e){t.remove(r[e.id])})):(i=e,r[i.id]?(l(i)&&t.fire("RemoveEditor",{editor:i}),r.length||u.unbind(window,"beforeunload",m),i.remove(),i):null);for(n=r.length-1;n>=0;n--)t.remove(r[n])}},execCommand:function(t,n,r){var i=this,o=i.get(r);switch(t){case"mceAddEditor":return i.get(r)||new e(r,i.settings,i).render(),!0;case"mceRemoveEditor":return o&&o.remove(),!0;case"mceToggleEditor":return o?(o.isHidden()?o.show():o.hide(),!0):(i.execCommand("mceAddEditor",0,r),!0)}return i.activeEditor?i.activeEditor.execCommand(t,n,r):!1},triggerSave:function(){f(this.editors,function(e){e.save()})},addI18n:function(e,t){a.add(e,t)},translate:function(e){return a.translate(e)}},p(g,o),g.setup(),window.tinymce=window.tinyMCE=g,g}),r(ft,[dt,p],function(e,t){var n=t.each,r=t.explode;e.on("AddEditor",function(e){var t=e.editor;t.on("preInit",function(){function e(e,t){n(t,function(t,n){t&&s.setStyle(e,n,t)}),s.rename(e,"span")}function i(e){s=t.dom,l.convert_fonts_to_spans&&n(s.select("font,u,strike",e.node),function(e){o[e.nodeName.toLowerCase()](s,e)})}var o,a,s,l=t.settings;l.inline_styles&&(a=r(l.font_size_legacy_values),o={font:function(t,n){e(n,{backgroundColor:n.style.backgroundColor,color:n.color,fontFamily:n.face,fontSize:a[parseInt(n.size,10)-1]})},u:function(t,n){e(n,{textDecoration:"underline"})},strike:function(t,n){e(n,{textDecoration:"line-through"})}},t.on("PreProcess SetContent",i))})})}),r(pt,[],function(){return{send:function(e){function t(){!e.async||4==n.readyState||r++>1e4?(e.success&&1e4>r&&200==n.status?e.success.call(e.success_scope,""+n.responseText,n,e):e.error&&e.error.call(e.error_scope,r>1e4?"TIMED_OUT":"GENERAL",n,e),n=null):setTimeout(t,10)}var n,r=0;if(e.scope=e.scope||this,e.success_scope=e.success_scope||e.scope,e.error_scope=e.error_scope||e.scope,e.async=e.async===!1?!1:!0,e.data=e.data||"",n=new XMLHttpRequest){if(n.overrideMimeType&&n.overrideMimeType(e.content_type),n.open(e.type||(e.data?"POST":"GET"),e.url,e.async),e.content_type&&n.setRequestHeader("Content-Type",e.content_type),n.setRequestHeader("X-Requested-With","XMLHttpRequest"),n.send(e.data),!e.async)return t();setTimeout(t,10)}}}}),r(ht,[],function(){function e(t,n){var r,i,o,a;if(n=n||'"',null===t)return"null";if(o=typeof t,"string"==o)return i="\bb	t\nn\ff\rr\"\"''\\\\",n+t.replace(/([\u0080-\uFFFF\x00-\x1f\"\'\\])/g,function(e,t){return'"'===n&&"'"===e?e:(r=i.indexOf(t),r+1?"\\"+i.charAt(r+1):(e=t.charCodeAt().toString(16),"\\u"+"0000".substring(e.length)+e))})+n;if("object"==o){if(t.hasOwnProperty&&"[object Array]"===Object.prototype.toString.call(t)){for(r=0,i="[";r<t.length;r++)i+=(r>0?",":"")+e(t[r],n);return i+"]"}i="{";for(a in t)t.hasOwnProperty(a)&&(i+="function"!=typeof t[a]?(i.length>1?","+n:n)+a+n+":"+e(t[a],n):"");return i+"}"}return""+t}return{serialize:e,parse:function(e){try{return window[String.fromCharCode(101)+"val"]("("+e+")")}catch(t){}}}}),r(mt,[ht,pt,p],function(e,t,n){function r(e){this.settings=i({},e),this.count=0}var i=n.extend;return r.sendRPC=function(e){return(new r).send(e)},r.prototype={send:function(n){var r=n.error,o=n.success;n=i(this.settings,n),n.success=function(t,i){t=e.parse(t),"undefined"==typeof t&&(t={error:"JSON Parse error."}),t.error?r.call(n.error_scope||n.scope,t.error,i):o.call(n.success_scope||n.scope,t.result)},n.error=function(e,t){r&&r.call(n.error_scope||n.scope,e,t)},n.data=e.serialize({id:n.id||"c"+this.count++,method:n.method,params:n.params}),n.content_type="application/json",t.send(n)}},r}),r(gt,[y],function(e){return{callbacks:{},count:0,send:function(n){var r=this,i=e.DOM,o=n.count!==t?n.count:r.count,a="tinymce_jsonp_"+o;r.callbacks[o]=function(e){i.remove(a),delete r.callbacks[o],n.callback(e)},i.add(i.doc.body,"script",{id:a,src:n.url,type:"text/javascript"}),r.count++}}}),r(vt,[],function(){function e(){s=[];for(var e in a)s.push(e);i.length=s.length}function n(){function n(e){var n,r;return r=e!==t?u+e:i.indexOf(",",u),-1===r||r>i.length?null:(n=i.substring(u,r),u=r+1,n)}var r,i,s,u=0;if(a={},c){o.load(l),i=o.getAttribute(l)||"";do{var d=n();if(null===d)break;if(r=n(parseInt(d,32)||0),null!==r){if(d=n(),null===d)break;s=n(parseInt(d,32)||0),r&&(a[r]=s)}}while(null!==r);e()}}function r(){var t,n="";if(c){for(var r in a)t=a[r],n+=(n?",":"")+r.length.toString(32)+","+r+","+t.length.toString(32)+","+t;o.setAttribute(l,n);try{o.save(l)}catch(i){}e()}}var i,o,a,s,l,c;try{if(window.localStorage)return localStorage}catch(u){}return l="tinymce",o=document.documentElement,c=!!o.addBehavior,c&&o.addBehavior("#default#userData"),i={key:function(e){return s[e]},getItem:function(e){return e in a?a[e]:null},setItem:function(e,t){a[e]=""+t,r()},removeItem:function(e){delete a[e],r()},clear:function(){a={},r()}},n(),i}),r(yt,[y,l,b,C,p,g],function(e,t,n,r,i,o){var a=window.tinymce;return a.DOM=e.DOM,a.ScriptLoader=n.ScriptLoader,a.PluginManager=r.PluginManager,a.ThemeManager=r.ThemeManager,a.dom=a.dom||{},a.dom.Event=t.Event,i.each(i,function(e,t){a[t]=e}),i.each("isOpera isWebKit isIE isGecko isMac".split(" "),function(e){a[e]=o[e.substr(2).toLowerCase()]}),{}}),r(bt,[z,p],function(e,t){return e.extend({Defaults:{firstControlClass:"first",lastControlClass:"last"},init:function(e){this.settings=t.extend({},this.Defaults,e)},preRender:function(e){e.addClass(this.settings.containerClass,"body")},applyClasses:function(e){var t=this,n=t.settings,r,i,o;r=e.items().filter(":visible"),i=n.firstControlClass,o=n.lastControlClass,r.each(function(e){e.removeClass(i).removeClass(o),n.controlClass&&e.addClass(n.controlClass)}),r.eq(0).addClass(i),r.eq(-1).addClass(o)},renderHtml:function(e){var t=this,n=t.settings,r,i="";return r=e.items(),r.eq(0).addClass(n.firstControlClass),r.eq(-1).addClass(n.lastControlClass),r.each(function(e){n.controlClass&&e.addClass(n.controlClass),i+=e.renderHtml()}),i},recalc:function(){},postRender:function(){}})}),r(Ct,[bt],function(e){return e.extend({Defaults:{containerClass:"abs-layout",controlClass:"abs-layout-item"},recalc:function(e){e.items().filter(":visible").each(function(e){var t=e.settings;e.layoutRect({x:t.x,y:t.y,w:t.w,h:t.h}),e.recalc&&e.recalc()})},renderHtml:function(e){return'<div id="'+e._id+'-absend" class="'+e.classPrefix+'abs-end"></div>'+this._super(e)}})}),r(xt,[$,Q],function(e,t){return e.extend({Mixins:[t],Defaults:{classes:"widget tooltip tooltip-n"},text:function(e){var t=this;return"undefined"!=typeof e?(t._value=e,t._rendered&&(t.getEl().lastChild.innerHTML=t.encode(e)),t):t._value},renderHtml:function(){var e=this,t=e.classPrefix;return'<div id="'+e._id+'" class="'+e.classes()+'" role="presentation"><div class="'+t+'tooltip-arrow"></div><div class="'+t+'tooltip-inner">'+e.encode(e._text)+"</div></div>"},repaint:function(){var e=this,t,n;t=e.getEl().style,n=e._layoutRect,t.left=n.x+"px",t.top=n.y+"px",t.zIndex=131070}})}),r(wt,[$,xt],function(e,t){var n,r=e.extend({init:function(e){var t=this;t._super(e),e=t.settings,t.canFocus=!0,e.tooltip&&r.tooltips!==!1&&(t.on("mouseenter",function(n){var r=t.tooltip().moveTo(-65535);if(n.control==t){var i=r.text(e.tooltip).show().testMoveRel(t.getEl(),["bc-tc","bc-tl","bc-tr"]);r.toggleClass("tooltip-n","bc-tc"==i),r.toggleClass("tooltip-nw","bc-tl"==i),r.toggleClass("tooltip-ne","bc-tr"==i),r.moveRel(t.getEl(),i)}else r.hide()}),t.on("mouseleave mousedown click",function(){t.tooltip().hide()})),t.aria("label",e.ariaLabel||e.tooltip)},tooltip:function(){return n||(n=new t({type:"tooltip"}),n.renderTo()),n},active:function(e){var t=this,n;return e!==n&&(t.aria("pressed",e),t.toggleClass("active",e)),t._super(e)},disabled:function(e){var t=this,n;return e!==n&&(t.aria("disabled",e),t.toggleClass("disabled",e)),t._super(e)},postRender:function(){var e=this,t=e.settings;e._rendered=!0,e._super(),e.parent()||!t.width&&!t.height||(e.initLayoutRect(),e.repaint()),t.autofocus&&e.focus()},remove:function(){this._super(),n&&(n.remove(),n=null)}});return r}),r(_t,[wt],function(e){return e.extend({Defaults:{classes:"widget btn",role:"button"},init:function(e){var t=this,n;t.on("click mousedown",function(e){e.preventDefault()}),t._super(e),n=e.size,e.subtype&&t.addClass(e.subtype),n&&t.addClass("btn-"+n)},icon:function(e){var t=this,n=t.classPrefix;if("undefined"==typeof e)return t.settings.icon;if(t.settings.icon=e,e=e?n+"ico "+n+"i-"+t.settings.icon:"",t._rendered){var r=t.getEl().firstChild,i=r.getElementsByTagName("i")[0];e?(i&&i==r.firstChild||(i=document.createElement("i"),r.insertBefore(i,r.firstChild)),i.className=e):i&&r.removeChild(i),t.text(t._text)}return t},repaint:function(){var e=this.getEl().firstChild.style;e.width=e.height="100%",this._super()},text:function(e){var t=this;if(t._rendered){var n=t.getEl().lastChild.lastChild;n&&(n.data=t.translate(e))}return t._super(e)},renderHtml:function(){var e=this,t=e._id,n=e.classPrefix,r=e.settings.icon,i;return i=e.settings.image,i?(r="none","string"!=typeof i&&(i=window.getSelection?i[0]:i[1]),i=" style=\"background-image: url('"+i+"')\""):i="",r=e.settings.icon?n+"ico "+n+"i-"+r:"",'<div id="'+t+'" class="'+e.classes()+'" tabindex="-1" aria-labelledby="'+t+'"><button role="presentation" type="button" tabindex="-1">'+(r?'<i class="'+r+'"'+i+"></i>":"")+(e._text?(r?"\xa0":"")+e.encode(e._text):"")+"</button></div>"}})}),r(Nt,[G],function(e){return e.extend({Defaults:{defaultType:"button",role:"group"},renderHtml:function(){var e=this,t=e._layout;return e.addClass("btn-group"),e.preRender(),t.preRender(e),'<div id="'+e._id+'" class="'+e.classes()+'"><div id="'+e._id+'-body">'+(e.settings.html||"")+t.renderHtml(e)+"</div></div>"}})}),r(Et,[wt],function(e){return e.extend({Defaults:{classes:"checkbox",role:"checkbox",checked:!1},init:function(e){var t=this;t._super(e),t.on("click mousedown",function(e){e.preventDefault()}),t.on("click",function(e){e.preventDefault(),t.disabled()||t.checked(!t.checked())}),t.checked(t.settings.checked)},checked:function(e){var t=this;return"undefined"!=typeof e?(e?t.addClass("checked"):t.removeClass("checked"),t._checked=e,t.aria("checked",e),t):t._checked},value:function(e){return this.checked(e)},renderHtml:function(){var e=this,t=e._id,n=e.classPrefix;return'<div id="'+t+'" class="'+e.classes()+'" unselectable="on" aria-labelledby="'+t+'-al" tabindex="-1"><i class="'+n+"ico "+n+'i-checkbox"></i><span id="'+t+'-al" class="'+n+'label">'+e.encode(e._text)+"</span></div>"}})}),r(St,[_t,et],function(e,t){return e.extend({showPanel:function(){var e=this,n=e.settings;if(e.active(!0),e.panel)e.panel.show();else{var r=n.panel;r.type&&(r={layout:"grid",items:r}),r.role=r.role||"dialog",r.popover=!0,r.autohide=!0,r.ariaRoot=!0,e.panel=new t(r).on("hide",function(){e.active(!1)}).on("cancel",function(t){t.stopPropagation(),e.focus(),e.hidePanel()}).parent(e).renderTo(e.getContainerElm()),e.panel.fire("show"),e.panel.reflow()}e.panel.moveRel(e.getEl(),n.popoverAlign||(e.isRtl()?["bc-tr","bc-tc"]:["bc-tl","bc-tc"]))},hidePanel:function(){var e=this;e.panel&&e.panel.hide()},postRender:function(){var e=this;return e.aria("haspopup",!0),e.on("click",function(t){t.control===e&&(e.panel&&e.panel.visible()?e.hidePanel():(e.showPanel(),e.panel.focus(!!t.aria)))}),e._super()}})}),r(kt,[St,y],function(e,t){var n=t.DOM;return e.extend({init:function(e){this._super(e),this.addClass("colorbutton")},color:function(e){return e?(this._color=e,this.getEl("preview").style.backgroundColor=e,this):this._color},renderHtml:function(){var e=this,t=e._id,n=e.classPrefix,r=e.settings.icon?n+"ico "+n+"i-"+e.settings.icon:"",i=e.settings.image?" style=\"background-image: url('"+e.settings.image+"')\"":"";return'<div id="'+t+'" class="'+e.classes()+'" role="button" tabindex="-1" aria-haspopup="true"><button role="presentation" hidefocus="1" type="button" tabindex="-1">'+(r?'<i class="'+r+'"'+i+"></i>":"")+'<span id="'+t+'-preview" class="'+n+'preview"></span>'+(e._text?(r?" ":"")+e._text:"")+'</button><button type="button" class="'+n+'open" hidefocus="1" tabindex="-1"> <i class="'+n+'caret"></i></button></div>'},postRender:function(){var e=this,t=e.settings.onclick;return e.on("click",function(r){r.aria&&"down"==r.aria.key||r.control!=e||n.getParent(r.target,"."+e.classPrefix+"open")||(r.stopImmediatePropagation(),t.call(e,r))}),delete e.settings.onclick,e._super()}})}),r(Tt,[wt,j,q],function(e,t,n){return e.extend({init:function(e){var t=this;t._super(e),t.addClass("combobox"),t.subinput=!0,t.ariaTarget="inp",e=t.settings,e.menu=e.menu||e.values,e.menu&&(e.icon="caret"),t.on("click",function(n){for(var r=n.target,i=t.getEl();r&&r!=i;)r.id&&-1!=r.id.indexOf("-open")&&(t.fire("action"),e.menu&&(t.showMenu(),n.aria&&t.menu.items()[0].focus())),r=r.parentNode}),t.on("keydown",function(e){"INPUT"==e.target.nodeName&&13==e.keyCode&&t.parents().reverse().each(function(n){return e.preventDefault(),t.fire("change"),n.hasEventListeners("submit")&&n.toJSON?(n.fire("submit",{data:n.toJSON()}),!1):void 0})}),e.placeholder&&(t.addClass("placeholder"),t.on("focusin",function(){t._hasOnChange||(n.on(t.getEl("inp"),"change",function(){t.fire("change")}),t._hasOnChange=!0),t.hasClass("placeholder")&&(t.getEl("inp").value="",t.removeClass("placeholder"))}),t.on("focusout",function(){0===t.value().length&&(t.getEl("inp").value=e.placeholder,t.addClass("placeholder"))}))},showMenu:function(){var e=this,n=e.settings,r;e.menu||(r=n.menu||[],r.length?r={type:"menu",items:r}:r.type=r.type||"menu",e.menu=t.create(r).parent(e).renderTo(e.getContainerElm()),e.fire("createmenu"),e.menu.reflow(),e.menu.on("cancel",function(t){t.control===e.menu&&e.focus()}),e.menu.on("show hide",function(t){t.control.items().each(function(t){t.active(t.value()==e.value())})}).fire("show"),e.menu.on("select",function(t){e.value(t.control.value())}),e.on("focusin",function(t){"INPUT"==t.target.tagName.toUpperCase()&&e.menu.hide()}),e.aria("expanded",!0)),e.menu.show(),e.menu.layoutRect({w:e.layoutRect().w}),e.menu.moveRel(e.getEl(),e.isRtl()?["br-tr","tr-br"]:["bl-tl","tl-bl"])},value:function(e){var t=this;return"undefined"!=typeof e?(t._value=e,t.removeClass("placeholder"),t._rendered&&(t.getEl("inp").value=e),t):t._rendered?(e=t.getEl("inp").value,e!=t.settings.placeholder?e:""):t._value},disabled:function(e){var t=this;return t._rendered&&"undefined"!=typeof e&&(t.getEl("inp").disabled=e),t._super(e)},focus:function(){this.getEl("inp").focus()},repaint:function(){var e=this,t=e.getEl(),r=e.getEl("open"),i=e.layoutRect(),o,a;o=r?i.w-n.getSize(r).width-10:i.w-10;var s=document;return s.all&&(!s.documentMode||s.documentMode<=8)&&(a=e.layoutRect().h-2+"px"),n.css(t.firstChild,{width:o,lineHeight:a}),e._super(),e},postRender:function(){var e=this;return n.on(this.getEl("inp"),"change",function(){e.fire("change")}),e._super()},remove:function(){n.off(this.getEl("inp")),this._super()},renderHtml:function(){var e=this,t=e._id,n=e.settings,r=e.classPrefix,i=n.value||n.placeholder||"",o,a,s="",l="";return"spellcheck"in n&&(l+=' spellcheck="'+n.spellcheck+'"'),n.maxLength&&(l+=' maxlength="'+n.maxLength+'"'),n.size&&(l+=' size="'+n.size+'"'),n.subtype&&(l+=' type="'+n.subtype+'"'),e.disabled()&&(l+=' disabled="disabled"'),o=n.icon,o&&"caret"!=o&&(o=r+"ico "+r+"i-"+n.icon),a=e._text,(o||a)&&(s='<div id="'+t+'-open" class="'+r+"btn "+r+'open" tabIndex="-1" role="button"><button id="'+t+'-action" type="button" hidefocus="1" tabindex="-1">'+("caret"!=o?'<i class="'+o+'"></i>':'<i class="'+r+'caret"></i>')+(a?(o?" ":"")+a:"")+"</button></div>",e.addClass("has-open")),'<div id="'+t+'" class="'+e.classes()+'"><input id="'+t+'-inp" class="'+r+"textbox "+r+'placeholder" value="'+i+'" hidefocus="1"'+l+" />"+s+"</div>"
+}})}),r(Rt,[wt],function(e){return e.extend({init:function(e){var t=this;e.delimiter||(e.delimiter="\xbb"),t._super(e),t.addClass("path"),t.canFocus=!0,t.on("click",function(e){var n,r=e.target;(n=r.getAttribute("data-index"))&&t.fire("select",{value:t.data()[n],index:n})})},focus:function(){var e=this;return e.getEl().firstChild.focus(),e},data:function(e){var t=this;return"undefined"!=typeof e?(t._data=e,t.update(),t):t._data},update:function(){this.innerHtml(this._getPathHtml())},postRender:function(){var e=this;e._super(),e.data(e.settings.data)},renderHtml:function(){var e=this;return'<div id="'+e._id+'" class="'+e.classes()+'">'+e._getPathHtml()+"</div>"},_getPathHtml:function(){var e=this,t=e._data||[],n,r,i="",o=e.classPrefix;for(n=0,r=t.length;r>n;n++)i+=(n>0?'<div class="'+o+'divider" aria-hidden="true"> '+e.settings.delimiter+" </div>":"")+'<div role="button" class="'+o+"path-item"+(n==r-1?" "+o+"last":"")+'" data-index="'+n+'" tabindex="-1" id="'+e._id+"-"+n+'" aria-level="'+n+'">'+t[n].name+"</div>";return i||(i='<div class="'+o+'path-item">\xa0</div>'),i}})}),r(At,[Rt,dt],function(e,t){return e.extend({postRender:function(){function e(e){if(1===e.nodeType){if("BR"==e.nodeName||e.getAttribute("data-mce-bogus"))return!0;if("bookmark"===e.getAttribute("data-mce-type"))return!0}return!1}var n=this,r=t.activeEditor;return n.on("select",function(t){var n=[],i,o=r.getBody();for(r.focus(),i=r.selection.getStart();i&&i!=o;)e(i)||n.push(i),i=i.parentNode;r.selection.select(n[n.length-1-t.index]),r.nodeChanged()}),r.on("nodeChange",function(t){for(var i=[],o=t.parents,a=o.length;a--;)if(1==o[a].nodeType&&!e(o[a])){var s=r.fire("ResolveName",{name:o[a].nodeName.toLowerCase(),target:o[a]});i.push({name:s.name})}n.data(i)}),n._super()}})}),r(Bt,[G],function(e){return e.extend({Defaults:{layout:"flex",align:"center",defaults:{flex:1}},renderHtml:function(){var e=this,t=e._layout,n=e.classPrefix;return e.addClass("formitem"),t.preRender(e),'<div id="'+e._id+'" class="'+e.classes()+'" hidefocus="1" tabindex="-1">'+(e.settings.title?'<div id="'+e._id+'-title" class="'+n+'title">'+e.settings.title+"</div>":"")+'<div id="'+e._id+'-body" class="'+e.classes("body")+'">'+(e.settings.html||"")+t.renderHtml(e)+"</div></div>"}})}),r(Dt,[G,Bt],function(e,t){return e.extend({Defaults:{containerCls:"form",layout:"flex",direction:"column",align:"stretch",flex:1,padding:20,labelGap:30,spacing:10,callbacks:{submit:function(){this.submit()}}},preRender:function(){var e=this,n=e.items();n.each(function(n){var r,i=n.settings.label;i&&(r=new t({layout:"flex",autoResize:"overflow",defaults:{flex:1},items:[{type:"label",id:n._id+"-l",text:i,flex:0,forId:n._id,disabled:n.disabled()}]}),r.type="formitem",n.aria("labelledby",n._id+"-l"),"undefined"==typeof n.settings.flex&&(n.settings.flex=1),e.replace(n,r),r.add(n))})},recalcLabels:function(){var e=this,t=0,n=[],r,i;if(e.settings.labelGapCalc!==!1)for(e.items().filter("formitem").each(function(e){var r=e.items()[0],i=r.getEl().clientWidth;t=i>t?i:t,n.push(r)}),i=e.settings.labelGap||0,r=n.length;r--;)n[r].settings.minWidth=t+i},visible:function(e){var t=this._super(e);return e===!0&&this._rendered&&this.recalcLabels(),t},submit:function(){return this.fire("submit",{data:this.toJSON()})},postRender:function(){var e=this;e._super(),e.recalcLabels(),e.fromJSON(e.settings.data)}})}),r(Lt,[Dt],function(e){return e.extend({Defaults:{containerCls:"fieldset",layout:"flex",direction:"column",align:"stretch",flex:1,padding:"25 15 5 15",labelGap:30,spacing:10,border:1},renderHtml:function(){var e=this,t=e._layout,n=e.classPrefix;return e.preRender(),t.preRender(e),'<fieldset id="'+e._id+'" class="'+e.classes()+'" hidefocus="1" tabindex="-1">'+(e.settings.title?'<legend id="'+e._id+'-title" class="'+n+'fieldset-title">'+e.settings.title+"</legend>":"")+'<div id="'+e._id+'-body" class="'+e.classes("body")+'">'+(e.settings.html||"")+t.renderHtml(e)+"</div></fieldset>"}})}),r(Mt,[Tt],function(e){return e.extend({init:function(e){var t=this,n=tinymce.activeEditor,r;e.spellcheck=!1,r=n.settings.file_browser_callback,r&&(e.icon="browse",e.onaction=function(){r(t.getEl("inp").id,t.getEl("inp").value,e.filetype,window)}),t._super(e)}})}),r(Ht,[Ct],function(e){return e.extend({recalc:function(e){var t=e.layoutRect(),n=e.paddingBox();e.items().filter(":visible").each(function(e){e.layoutRect({x:n.left,y:n.top,w:t.innerW-n.right-n.left,h:t.innerH-n.top-n.bottom}),e.recalc&&e.recalc()})}})}),r(Pt,[Ct],function(e){return e.extend({recalc:function(e){var t,n,r,i,o,a,s,l,c,u,d,f,p,h,m,g,v=[],y,b,C,x,w,_,N,E,S,k,T,R,A,B,D,L,M,H,P,O,I,F,z=Math.max,W=Math.min;for(r=e.items().filter(":visible"),i=e.layoutRect(),o=e._paddingBox,a=e.settings,f=e.isRtl()?a.direction||"row-reversed":a.direction,s=a.align,l=e.isRtl()?a.pack||"end":a.pack,c=a.spacing||0,("row-reversed"==f||"column-reverse"==f)&&(r=r.set(r.toArray().reverse()),f=f.split("-")[0]),"column"==f?(S="y",N="h",E="minH",k="maxH",R="innerH",T="top",A="deltaH",B="contentH",P="left",M="w",D="x",L="innerW",H="minW",O="right",I="deltaW",F="contentW"):(S="x",N="w",E="minW",k="maxW",R="innerW",T="left",A="deltaW",B="contentW",P="top",M="h",D="y",L="innerH",H="minH",O="bottom",I="deltaH",F="contentH"),d=i[R]-o[T]-o[T],_=u=0,t=0,n=r.length;n>t;t++)p=r[t],h=p.layoutRect(),m=p.settings,g=m.flex,d-=n-1>t?c:0,g>0&&(u+=g,h[k]&&v.push(p),h.flex=g),d-=h[E],y=o[P]+h[H]+o[O],y>_&&(_=y);if(x={},x[E]=0>d?i[E]-d+i[A]:i[R]-d+i[A],x[H]=_+i[I],x[B]=i[R]-d,x[F]=_,x.minW=W(x.minW,i.maxW),x.minH=W(x.minH,i.maxH),x.minW=z(x.minW,i.startMinWidth),x.minH=z(x.minH,i.startMinHeight),!i.autoResize||x.minW==i.minW&&x.minH==i.minH){for(C=d/u,t=0,n=v.length;n>t;t++)p=v[t],h=p.layoutRect(),b=h[k],y=h[E]+h.flex*C,y>b?(d-=h[k]-h[E],u-=h.flex,h.flex=0,h.maxFlexSize=b):h.maxFlexSize=0;for(C=d/u,w=o[T],x={},0===u&&("end"==l?w=d+o[T]:"center"==l?(w=Math.round(i[R]/2-(i[R]-d)/2)+o[T],0>w&&(w=o[T])):"justify"==l&&(w=o[T],c=Math.floor(d/(r.length-1)))),x[D]=o[P],t=0,n=r.length;n>t;t++)p=r[t],h=p.layoutRect(),y=h.maxFlexSize||h[E],"center"===s?x[D]=Math.round(i[L]/2-h[M]/2):"stretch"===s?(x[M]=z(h[H]||0,i[L]-o[P]-o[O]),x[D]=o[P]):"end"===s&&(x[D]=i[L]-h[M]-o.top),h.flex>0&&(y+=h.flex*C),x[N]=y,x[S]=w,p.layoutRect(x),p.recalc&&p.recalc(),w+=y+c}else if(x.w=x.minW,x.h=x.minH,e.layoutRect(x),this.recalc(e),null===e._lastRect){var V=e.parent();V&&(V._lastRect=null,V.recalc())}}})}),r(Ot,[bt],function(e){return e.extend({Defaults:{containerClass:"flow-layout",controlClass:"flow-layout-item",endClass:"break"},recalc:function(e){e.items().filter(":visible").each(function(e){e.recalc&&e.recalc()})}})}),r(It,[$,wt,et,p,dt,g],function(e,t,n,r,i,o){function a(e){function t(t,n){return function(){var r=this;e.on("nodeChange",function(i){var o=e.formatter,a=null;s(i.parents,function(e){return s(t,function(t){return n?o.matchNode(e,n,{value:t.value})&&(a=t.value):o.matchNode(e,t.value)&&(a=t.value),a?!1:void 0}),a?!1:void 0}),r.value(a)})}}function r(e){e=e.replace(/;$/,"").split(";");for(var t=e.length;t--;)e[t]=e[t].split("=");return e}function i(){function t(e){var n=[];if(e)return s(e,function(e){var o={text:e.title,icon:e.icon};if(e.items)o.menu=t(e.items);else{var a=e.format||"custom"+r++;e.format||(e.name=a,i.push(e)),o.format=a}n.push(o)}),n}function n(){var n;return n=t(e.settings.style_formats_merge?e.settings.style_formats?o.concat(e.settings.style_formats):o:e.settings.style_formats||o)}var r=0,i=[],o=[{title:"Headings",items:[{title:"Heading 1",format:"h1"},{title:"Heading 2",format:"h2"},{title:"Heading 3",format:"h3"},{title:"Heading 4",format:"h4"},{title:"Heading 5",format:"h5"},{title:"Heading 6",format:"h6"}]},{title:"Inline",items:[{title:"Bold",icon:"bold",format:"bold"},{title:"Italic",icon:"italic",format:"italic"},{title:"Underline",icon:"underline",format:"underline"},{title:"Strikethrough",icon:"strikethrough",format:"strikethrough"},{title:"Superscript",icon:"superscript",format:"superscript"},{title:"Subscript",icon:"subscript",format:"subscript"},{title:"Code",icon:"code",format:"code"}]},{title:"Blocks",items:[{title:"Paragraph",format:"p"},{title:"Blockquote",format:"blockquote"},{title:"Div",format:"div"},{title:"Pre",format:"pre"}]},{title:"Alignment",items:[{title:"Left",icon:"alignleft",format:"alignleft"},{title:"Center",icon:"aligncenter",format:"aligncenter"},{title:"Right",icon:"alignright",format:"alignright"},{title:"Justify",icon:"alignjustify",format:"alignjustify"}]}];return e.on("init",function(){s(i,function(t){e.formatter.register(t.name,t)})}),{type:"menu",items:n(),onPostRender:function(t){e.fire("renderFormatsMenu",{control:t.control})},itemDefaults:{preview:!0,textStyle:function(){return this.settings.format?e.formatter.getCssText(this.settings.format):void 0},onPostRender:function(){var t=this,n=this.settings.format;n&&t.parent().on("show",function(){t.disabled(!e.formatter.canApply(n)),t.active(e.formatter.match(n))})},onclick:function(){this.settings.format&&d(this.settings.format)}}}}function o(){return e.undoManager?e.undoManager.hasUndo():!1}function a(){return e.undoManager?e.undoManager.hasRedo():!1}function l(){var t=this;t.disabled(!o()),e.on("Undo Redo AddUndo TypingUndo",function(){t.disabled(!o())})}function c(){var t=this;t.disabled(!a()),e.on("Undo Redo AddUndo TypingUndo",function(){t.disabled(!a())})}function u(){var t=this;e.on("VisualAid",function(e){t.active(e.hasVisual)}),t.active(e.hasVisual)}function d(t){t.control&&(t=t.control.value()),t&&e.execCommand("mceToggleFormat",!1,t)}var f;f=i(),s({bold:"Bold",italic:"Italic",underline:"Underline",strikethrough:"Strikethrough",subscript:"Subscript",superscript:"Superscript"},function(t,n){e.addButton(n,{tooltip:t,onPostRender:function(){var t=this;e.formatter?e.formatter.formatChanged(n,function(e){t.active(e)}):e.on("init",function(){e.formatter.formatChanged(n,function(e){t.active(e)})})},onclick:function(){d(n)}})}),s({outdent:["Decrease indent","Outdent"],indent:["Increase indent","Indent"],cut:["Cut","Cut"],copy:["Copy","Copy"],paste:["Paste","Paste"],help:["Help","mceHelp"],selectall:["Select all","SelectAll"],hr:["Insert horizontal rule","InsertHorizontalRule"],removeformat:["Clear formatting","RemoveFormat"],visualaid:["Visual aids","mceToggleVisualAid"],newdocument:["New document","mceNewDocument"]},function(t,n){e.addButton(n,{tooltip:t[0],cmd:t[1]})}),s({blockquote:["Blockquote","mceBlockQuote"],numlist:["Numbered list","InsertOrderedList"],bullist:["Bullet list","InsertUnorderedList"],subscript:["Subscript","Subscript"],superscript:["Superscript","Superscript"],alignleft:["Align left","JustifyLeft"],aligncenter:["Align center","JustifyCenter"],alignright:["Align right","JustifyRight"],alignjustify:["Justify","JustifyFull"]},function(t,n){e.addButton(n,{tooltip:t[0],cmd:t[1],onPostRender:function(){var t=this;e.formatter?e.formatter.formatChanged(n,function(e){t.active(e)}):e.on("init",function(){e.formatter.formatChanged(n,function(e){t.active(e)})})}})}),e.addButton("undo",{tooltip:"Undo",onPostRender:l,cmd:"undo"}),e.addButton("redo",{tooltip:"Redo",onPostRender:c,cmd:"redo"}),e.addMenuItem("newdocument",{text:"New document",shortcut:"Ctrl+N",icon:"newdocument",cmd:"mceNewDocument"}),e.addMenuItem("undo",{text:"Undo",icon:"undo",shortcut:"Ctrl+Z",onPostRender:l,cmd:"undo"}),e.addMenuItem("redo",{text:"Redo",icon:"redo",shortcut:"Ctrl+Y",onPostRender:c,cmd:"redo"}),e.addMenuItem("visualaid",{text:"Visual aids",selectable:!0,onPostRender:u,cmd:"mceToggleVisualAid"}),s({cut:["Cut","Cut","Ctrl+X"],copy:["Copy","Copy","Ctrl+C"],paste:["Paste","Paste","Ctrl+V"],selectall:["Select all","SelectAll","Ctrl+A"],bold:["Bold","Bold","Ctrl+B"],italic:["Italic","Italic","Ctrl+I"],underline:["Underline","Underline"],strikethrough:["Strikethrough","Strikethrough"],subscript:["Subscript","Subscript"],superscript:["Superscript","Superscript"],removeformat:["Clear formatting","RemoveFormat"]},function(t,n){e.addMenuItem(n,{text:t[0],icon:n,shortcut:t[2],cmd:t[1]})}),e.on("mousedown",function(){n.hideAll()}),e.addButton("styleselect",{type:"menubutton",text:"Formats",menu:f}),e.addButton("formatselect",function(){var n=[],i=r(e.settings.block_formats||"Paragraph=p;Address=address;Pre=pre;Heading 1=h1;Heading 2=h2;Heading 3=h3;Heading 4=h4;Heading 5=h5;Heading 6=h6");return s(i,function(t){n.push({text:t[0],value:t[1],textStyle:function(){return e.formatter.getCssText(t[1])}})}),{type:"listbox",text:i[0][0],values:n,fixedWidth:!0,onselect:d,onPostRender:t(n)}}),e.addButton("fontselect",function(){var n="Andale Mono=andale mono,times;Arial=arial,helvetica,sans-serif;Arial Black=arial black,avant garde;Book Antiqua=book antiqua,palatino;Comic Sans MS=comic sans ms,sans-serif;Courier New=courier new,courier;Georgia=georgia,palatino;Helvetica=helvetica;Impact=impact,chicago;Symbol=symbol;Tahoma=tahoma,arial,helvetica,sans-serif;Terminal=terminal,monaco;Times New Roman=times new roman,times;Trebuchet MS=trebuchet ms,geneva;Verdana=verdana,geneva;Webdings=webdings;Wingdings=wingdings,zapf dingbats",i=[],o=r(e.settings.font_formats||n);return s(o,function(e){i.push({text:{raw:e[0]},value:e[1],textStyle:-1==e[1].indexOf("dings")?"font-family:"+e[1]:""})}),{type:"listbox",text:"Font Family",tooltip:"Font Family",values:i,fixedWidth:!0,onPostRender:t(i,"fontname"),onselect:function(t){t.control.settings.value&&e.execCommand("FontName",!1,t.control.settings.value)}}}),e.addButton("fontsizeselect",function(){var n=[],r="8pt 10pt 12pt 14pt 18pt 24pt 36pt",i=e.settings.fontsize_formats||r;return s(i.split(" "),function(e){n.push({text:e,value:e})}),{type:"listbox",text:"Font Sizes",tooltip:"Font Sizes",values:n,fixedWidth:!0,onPostRender:t(n,"fontsize"),onclick:function(t){t.control.settings.value&&e.execCommand("FontSize",!1,t.control.settings.value)}}}),e.addMenuItem("formats",{text:"Formats",menu:f})}var s=r.each;i.on("AddEditor",function(t){t.editor.rtl&&(e.rtl=!0),a(t.editor)}),e.translate=function(e){return i.translate(e)},t.tooltips=!o.iOS}),r(Ft,[Ct],function(e){return e.extend({recalc:function(e){var t=e.settings,n,r,i,o,a,s,l,c,u,d,f,p,h,m,g,v,y,b,C,x,w,_,N=[],E=[],S,k,T,R;for(t=e.settings,i=e.items().filter(":visible"),o=e.layoutRect(),r=t.columns||Math.ceil(Math.sqrt(i.length)),n=Math.ceil(i.length/r),y=t.spacingH||t.spacing||0,b=t.spacingV||t.spacing||0,C=t.alignH||t.align,x=t.alignV||t.align,g=e._paddingBox,C&&"string"==typeof C&&(C=[C]),x&&"string"==typeof x&&(x=[x]),d=0;r>d;d++)N.push(0);for(f=0;n>f;f++)E.push(0);for(f=0;n>f;f++)for(d=0;r>d&&(u=i[f*r+d],u);d++)c=u.layoutRect(),S=c.minW,k=c.minH,N[d]=S>N[d]?S:N[d],E[f]=k>E[f]?k:E[f];for(T=o.innerW-g.left-g.right,w=0,d=0;r>d;d++)w+=N[d]+(d>0?y:0),T-=(d>0?y:0)+N[d];for(R=o.innerH-g.top-g.bottom,_=0,f=0;n>f;f++)_+=E[f]+(f>0?b:0),R-=(f>0?b:0)+E[f];if(w+=g.left+g.right,_+=g.top+g.bottom,l={},l.minW=w+(o.w-o.innerW),l.minH=_+(o.h-o.innerH),l.contentW=l.minW-o.deltaW,l.contentH=l.minH-o.deltaH,l.minW=Math.min(l.minW,o.maxW),l.minH=Math.min(l.minH,o.maxH),l.minW=Math.max(l.minW,o.startMinWidth),l.minH=Math.max(l.minH,o.startMinHeight),!o.autoResize||l.minW==o.minW&&l.minH==o.minH){o.autoResize&&(l=e.layoutRect(l),l.contentW=l.minW-o.deltaW,l.contentH=l.minH-o.deltaH);var A;A="start"==t.packV?0:R>0?Math.floor(R/n):0;var B=0,D=t.flexWidths;if(D)for(d=0;d<D.length;d++)B+=D[d];else B=r;var L=T/B;for(d=0;r>d;d++)N[d]+=D?D[d]*L:L;for(h=g.top,f=0;n>f;f++){for(p=g.left,s=E[f]+A,d=0;r>d&&(u=i[f*r+d],u);d++)m=u.settings,c=u.layoutRect(),a=Math.max(N[d],c.startMinWidth),c.x=p,c.y=h,v=m.alignH||(C?C[d]||C[0]:null),"center"==v?c.x=p+a/2-c.w/2:"right"==v?c.x=p+a-c.w:"stretch"==v&&(c.w=a),v=m.alignV||(x?x[d]||x[0]:null),"center"==v?c.y=h+s/2-c.h/2:"bottom"==v?c.y=h+s-c.h:"stretch"==v&&(c.h=s),u.layoutRect(c),p+=a+y,u.recalc&&u.recalc();h+=s+b}}else if(l.w=l.minW,l.h=l.minH,e.layoutRect(l),this.recalc(e),null===e._lastRect){var M=e.parent();M&&(M._lastRect=null,M.recalc())}}})}),r(zt,[wt],function(e){return e.extend({renderHtml:function(){var e=this;return e.addClass("iframe"),e.canFocus=!1,'<iframe id="'+e._id+'" class="'+e.classes()+'" tabindex="-1" src="'+(e.settings.url||"javascript:''")+'" frameborder="0"></iframe>'},src:function(e){this.getEl().src=e},html:function(e,t){var n=this,r=this.getEl().contentWindow.document.body;return r?(r.innerHTML=e,t&&t()):setTimeout(function(){n.html(e)},0),this}})}),r(Wt,[wt,q],function(e,t){return e.extend({init:function(e){var t=this;t._super(e),t.addClass("widget"),t.addClass("label"),t.canFocus=!1,e.multiline&&t.addClass("autoscroll"),e.strong&&t.addClass("strong")},initLayoutRect:function(){var e=this,n=e._super();if(e.settings.multiline){var r=t.getSize(e.getEl());r.width>n.maxW&&(n.minW=n.maxW,e.addClass("multiline")),e.getEl().style.width=n.minW+"px",n.startMinH=n.h=n.minH=Math.min(n.maxH,t.getSize(e.getEl()).height)}return n},repaint:function(){var e=this;return e.settings.multiline||(e.getEl().style.lineHeight=e.layoutRect().h+"px"),e._super()},text:function(e){var t=this;return t._rendered&&e&&this.innerHtml(t.encode(e)),t._super(e)},renderHtml:function(){var e=this,t=e.settings.forId;return'<label id="'+e._id+'" class="'+e.classes()+'"'+(t?' for="'+t+'"':"")+">"+e.encode(e._text)+"</label>"}})}),r(Vt,[G],function(e){return e.extend({Defaults:{role:"toolbar",layout:"flow"},init:function(e){var t=this;t._super(e),t.addClass("toolbar")},postRender:function(){var e=this;return e.items().addClass("toolbar-item"),e._super()}})}),r(Ut,[Vt],function(e){return e.extend({Defaults:{role:"menubar",containerCls:"menubar",ariaRoot:!0,defaults:{type:"menubutton"}}})}),r(qt,[_t,j,Ut],function(e,t,n){function r(e,t){for(;e;){if(t===e)return!0;e=e.parentNode}return!1}var i=e.extend({init:function(e){var t=this;t._renderOpen=!0,t._super(e),t.addClass("menubtn"),e.fixedWidth&&t.addClass("fixed-width"),t.aria("haspopup",!0),t.hasPopup=!0},showMenu:function(){var e=this,n=e.settings,r;return e.menu&&e.menu.visible()?e.hideMenu():(e.menu||(r=n.menu||[],r.length?r={type:"menu",items:r}:r.type=r.type||"menu",e.menu=t.create(r).parent(e).renderTo(),e.fire("createmenu"),e.menu.reflow(),e.menu.on("cancel",function(t){t.control.parent()===e.menu&&(t.stopPropagation(),e.focus(),e.hideMenu())}),e.menu.on("select",function(){e.focus()}),e.menu.on("show hide",function(t){t.control==e.menu&&e.activeMenu("show"==t.type),e.aria("expanded","show"==t.type)}).fire("show")),e.menu.show(),e.menu.layoutRect({w:e.layoutRect().w}),void e.menu.moveRel(e.getEl(),e.isRtl()?["br-tr","tr-br"]:["bl-tl","tl-bl"]))},hideMenu:function(){var e=this;e.menu&&(e.menu.items().each(function(e){e.hideMenu&&e.hideMenu()}),e.menu.hide())},activeMenu:function(e){this.toggleClass("active",e)},renderHtml:function(){var e=this,t=e._id,r=e.classPrefix,i=e.settings.icon?r+"ico "+r+"i-"+e.settings.icon:"";return e.aria("role",e.parent()instanceof n?"menuitem":"button"),'<div id="'+t+'" class="'+e.classes()+'" tabindex="-1" aria-labelledby="'+t+'"><button id="'+t+'-open" role="presentation" type="button" tabindex="-1">'+(i?'<i class="'+i+'"></i>':"")+"<span>"+(e._text?(i?"\xa0":"")+e.encode(e._text):"")+'</span> <i class="'+r+'caret"></i></button></div>'},postRender:function(){var e=this;return e.on("click",function(t){t.control===e&&r(t.target,e.getEl())&&(e.showMenu(),t.aria&&e.menu.items()[0].focus())}),e.on("mouseenter",function(t){var n=t.control,r=e.parent(),o;n&&r&&n instanceof i&&n.parent()==r&&(r.items().filter("MenuButton").each(function(e){e.hideMenu&&e!=n&&(e.menu&&e.menu.visible()&&(o=!0),e.hideMenu())}),o&&(n.focus(),n.showMenu()))}),e._super()},text:function(e){var t=this,n,r;if(t._rendered)for(r=t.getEl("open").getElementsByTagName("span"),n=0;n<r.length;n++)r[n].innerHTML=(t.settings.icon&&e?"\xa0":"")+t.encode(e);return this._super(e)},remove:function(){this._super(),this.menu&&this.menu.remove()}});return i}),r($t,[qt],function(e){return e.extend({init:function(e){var t=this,n,r,i,o,a;if(t._values=n=e.values,n){for(r=0;r<n.length;r++)if(i=n[r].selected||e.value===n[r].value){o=o||n[r].text,t._value=n[r].value;break}!i&&n.length>0&&(o=n[0].text,t._value=n[0].value),e.menu=n}e.text=e.text||o||n[0].text,t._super(e),t.addClass("listbox"),t.on("select",function(n){var r=n.control;a&&(n.lastControl=a),e.multiple?r.active(!r.active()):t.value(n.control.settings.value),a=r})},value:function(e){function t(e,n){e.items().each(function(e){r=e.value()===n,r&&(i=i||e.text()),e.active(r),e.menu&&t(e.menu,n)})}var n=this,r,i,o,a;if("undefined"!=typeof e){if(n.menu)t(n.menu,e);else for(o=n.settings.menu,a=0;a<o.length;a++)r=o[a].value==e,r&&(i=i||o[a].text),o[a].active=r;n.text(i||this.settings.text)}return n._super(e)}})}),r(jt,[wt,j,g],function(e,t,n){return e.extend({Defaults:{border:0,role:"menuitem"},init:function(e){var t=this;t.hasPopup=!0,t._super(e),e=t.settings,t.addClass("menu-item"),e.menu&&t.addClass("menu-item-expand"),e.preview&&t.addClass("menu-item-preview"),("-"===t._text||"|"===t._text)&&(t.addClass("menu-item-sep"),t.aria("role","separator"),t._text="-"),e.selectable&&(t.aria("role","menuitemcheckbox"),t.addClass("menu-item-checkbox"),e.icon="selected"),e.preview||e.selectable||t.addClass("menu-item-normal"),t.on("mousedown",function(e){e.preventDefault()}),e.menu&&!e.ariaHideMenu&&t.aria("haspopup",!0)},hasMenus:function(){return!!this.settings.menu},showMenu:function(){var e=this,n=e.settings,r,i=e.parent();if(i.items().each(function(t){t!==e&&t.hideMenu()}),n.menu){r=e.menu,r?r.show():(r=n.menu,r.length?r={type:"menu",items:r}:r.type=r.type||"menu",i.settings.itemDefaults&&(r.itemDefaults=i.settings.itemDefaults),r=e.menu=t.create(r).parent(e).renderTo(),r.reflow(),r.fire("show"),r.on("cancel",function(t){t.stopPropagation(),e.focus(),r.hide()}),r.on("hide",function(t){t.control===r&&e.removeClass("selected")}),r.submenu=!0),r._parentMenu=i,r.addClass("menu-sub");var o=r.testMoveRel(e.getEl(),e.isRtl()?["tl-tr","bl-br","tr-tl","br-bl"]:["tr-tl","br-bl","tl-tr","bl-br"]);r.moveRel(e.getEl(),o),r.rel=o,o="menu-sub-"+o,r.removeClass(r._lastRel),r.addClass(o),r._lastRel=o,e.addClass("selected"),e.aria("expanded",!0)}},hideMenu:function(){var e=this;return e.menu&&(e.menu.items().each(function(e){e.hideMenu&&e.hideMenu()}),e.menu.hide(),e.aria("expanded",!1)),e},renderHtml:function(){var e=this,t=e._id,r=e.settings,i=e.classPrefix,o=e.encode(e._text),a=e.settings.icon,s="",l=r.shortcut;return a&&e.parent().addClass("menu-has-icons"),r.image&&(a="none",s=" style=\"background-image: url('"+r.image+"')\""),l&&n.mac&&(l=l.replace(/ctrl\+alt\+/i,"&#x2325;&#x2318;"),l=l.replace(/ctrl\+/i,"&#x2318;"),l=l.replace(/alt\+/i,"&#x2325;"),l=l.replace(/shift\+/i,"&#x21E7;")),a=i+"ico "+i+"i-"+(e.settings.icon||"none"),'<div id="'+t+'" class="'+e.classes()+'" tabindex="-1">'+("-"!==o?'<i class="'+a+'"'+s+"></i>\xa0":"")+("-"!==o?'<span id="'+t+'-text" class="'+i+'text">'+o+"</span>":"")+(l?'<div id="'+t+'-shortcut" class="'+i+'menu-shortcut">'+l+"</div>":"")+(r.menu?'<div class="'+i+'caret"></div>':"")+"</div>"},postRender:function(){var e=this,t=e.settings,n=t.textStyle;if("function"==typeof n&&(n=n.call(this)),n){var r=e.getEl("text");r&&r.setAttribute("style",n)}return e.on("mouseenter click",function(n){n.control===e&&(t.menu||"click"!==n.type?(e.showMenu(),n.aria&&e.menu.focus(!0)):(e.fire("select"),e.parent().hideAll()))}),e._super(),e},active:function(e){return"undefined"!=typeof e&&this.aria("checked",e),this._super(e)},remove:function(){this._super(),this.menu&&this.menu.remove()}})}),r(Kt,[et,jt,p],function(e,t,n){var r=e.extend({Defaults:{defaultType:"menuitem",border:1,layout:"stack",role:"application",bodyRole:"menu",ariaRoot:!0},init:function(e){var t=this;if(e.autohide=!0,e.constrainToViewport=!0,e.itemDefaults)for(var r=e.items,i=r.length;i--;)r[i]=n.extend({},e.itemDefaults,r[i]);t._super(e),t.addClass("menu")},repaint:function(){return this.toggleClass("menu-align",!0),this._super(),this.getEl().style.height="",this.getEl("body").style.height="",this},cancel:function(){var e=this;e.hideAll(),e.fire("select")},hideAll:function(){var e=this;return this.find("menuitem").exec("hideMenu"),e._super()},preRender:function(){var e=this;return e.items().each(function(t){var n=t.settings;return n.icon||n.selectable?(e._hasIcons=!0,!1):void 0}),e._super()}});return r}),r(Gt,[Et],function(e){return e.extend({Defaults:{classes:"radio",role:"radio"}})}),r(Yt,[wt,Y],function(e,t){return e.extend({renderHtml:function(){var e=this,t=e.classPrefix;return e.addClass("resizehandle"),"both"==e.settings.direction&&e.addClass("resizehandle-both"),e.canFocus=!1,'<div id="'+e._id+'" class="'+e.classes()+'"><i class="'+t+"ico "+t+'i-resize"></i></div>'},postRender:function(){var e=this;e._super(),e.resizeDragHelper=new t(this._id,{start:function(){e.fire("ResizeStart")},drag:function(t){"both"!=e.settings.direction&&(t.deltaX=0),e.fire("Resize",t)},stop:function(){e.fire("ResizeEnd")}})},remove:function(){return this.resizeDragHelper&&this.resizeDragHelper.destroy(),this._super()}})}),r(Xt,[wt],function(e){return e.extend({renderHtml:function(){var e=this;return e.addClass("spacer"),e.canFocus=!1,'<div id="'+e._id+'" class="'+e.classes()+'"></div>'}})}),r(Jt,[qt,q],function(e,t){return e.extend({Defaults:{classes:"widget btn splitbtn",role:"button"},repaint:function(){var e=this,n=e.getEl(),r=e.layoutRect(),i,o;return e._super(),i=n.firstChild,o=n.lastChild,t.css(i,{width:r.w-t.getSize(o).width,height:r.h-2}),t.css(o,{height:r.h-2}),e},activeMenu:function(e){var n=this;t.toggleClass(n.getEl().lastChild,n.classPrefix+"active",e)},renderHtml:function(){var e=this,t=e._id,n=e.classPrefix,r=e.settings.icon?n+"ico "+n+"i-"+e.settings.icon:"";return'<div id="'+t+'" class="'+e.classes()+'" role="button" tabindex="-1"><button type="button" hidefocus="1" tabindex="-1">'+(r?'<i class="'+r+'"></i>':"")+(e._text?(r?" ":"")+e._text:"")+'</button><button type="button" class="'+n+'open" hidefocus="1" tabindex="-1">'+(e._menuBtnText?(r?"\xa0":"")+e._menuBtnText:"")+' <i class="'+n+'caret"></i></button></div>'},postRender:function(){var e=this,t=e.settings.onclick;return e.on("click",function(e){var n=e.target;if(e.control==this)for(;n;){if(e.aria&&"down"!=e.aria.key||"BUTTON"==n.nodeName&&-1==n.className.indexOf("open"))return e.stopImmediatePropagation(),void t.call(this,e);n=n.parentNode}}),delete e.settings.onclick,e._super()}})}),r(Qt,[Ot],function(e){return e.extend({Defaults:{containerClass:"stack-layout",controlClass:"stack-layout-item",endClass:"break"}})}),r(Zt,[J,q],function(e,t){return e.extend({lastIdx:0,Defaults:{layout:"absolute",defaults:{type:"panel"}},activateTab:function(e){var n;this.activeTabId&&(n=this.getEl(this.activeTabId),t.removeClass(n,this.classPrefix+"active"),n.setAttribute("aria-selected","false")),this.activeTabId="t"+e,n=this.getEl("t"+e),n.setAttribute("aria-selected","true"),t.addClass(n,this.classPrefix+"active"),e!=this.lastIdx&&(this.items()[this.lastIdx].hide(),this.lastIdx=e),this.items()[e].show().fire("showtab"),this.reflow()},renderHtml:function(){var e=this,t=e._layout,n="",r=e.classPrefix;return e.preRender(),t.preRender(e),e.items().each(function(t,i){var o=e._id+"-t"+i;t.aria("role","tabpanel"),t.aria("labelledby",o),n+='<div id="'+o+'" class="'+r+'tab" unselectable="on" role="tab" aria-controls="'+t._id+'" aria-selected="false" tabIndex="-1">'+e.encode(t.settings.title)+"</div>"}),'<div id="'+e._id+'" class="'+e.classes()+'" hidefocus="1" tabindex="-1"><div id="'+e._id+'-head" class="'+r+'tabs" role="tablist">'+n+'</div><div id="'+e._id+'-body" class="'+e.classes("body")+'">'+t.renderHtml(e)+"</div></div>"},postRender:function(){var e=this;e._super(),e.settings.activeTab=e.settings.activeTab||0,e.activateTab(e.settings.activeTab),this.on("click",function(t){var n=t.target.parentNode;if(t.target.parentNode.id==e._id+"-head")for(var r=n.childNodes.length;r--;)n.childNodes[r]==t.target&&e.activateTab(r)})},initLayoutRect:function(){var e=this,n,r,i;r=t.getSize(e.getEl("head")).width,r=0>r?0:r,i=0,e.items().each(function(t,n){r=Math.max(r,t.layoutRect().minW),i=Math.max(i,t.layoutRect().minH),e.settings.activeTab!=n&&t.hide()}),e.items().each(function(e){e.settings.x=0,e.settings.y=0,e.settings.w=r,e.settings.h=i,e.layoutRect({x:0,y:0,w:r,h:i})});var o=t.getSize(e.getEl("head")).height;return e.settings.minWidth=r,e.settings.minHeight=i+o,n=e._super(),n.deltaH+=o,n.innerH=n.h-n.deltaH,n}})}),r(en,[wt,q],function(e,t){return e.extend({init:function(e){var t=this;t._super(e),t._value=e.value||"",t.addClass("textbox"),e.multiline?t.addClass("multiline"):t.on("keydown",function(e){13==e.keyCode&&t.parents().reverse().each(function(t){return e.preventDefault(),t.hasEventListeners("submit")&&t.toJSON?(t.fire("submit",{data:t.toJSON()}),!1):void 0})})},disabled:function(e){var t=this;return t._rendered&&"undefined"!=typeof e&&(t.getEl().disabled=e),t._super(e)},value:function(e){var t=this;return"undefined"!=typeof e?(t._value=e,t._rendered&&(t.getEl().value=e),t):t._rendered?t.getEl().value:t._value},repaint:function(){var e=this,t,n,r,i=0,o=0,a;t=e.getEl().style,n=e._layoutRect,a=e._lastRepaintRect||{};var s=document;return!e.settings.multiline&&s.all&&(!s.documentMode||s.documentMode<=8)&&(t.lineHeight=n.h-o+"px"),r=e._borderBox,i=r.left+r.right+8,o=r.top+r.bottom+(e.settings.multiline?8:0),n.x!==a.x&&(t.left=n.x+"px",a.x=n.x),n.y!==a.y&&(t.top=n.y+"px",a.y=n.y),n.w!==a.w&&(t.width=n.w-i+"px",a.w=n.w),n.h!==a.h&&(t.height=n.h-o+"px",a.h=n.h),e._lastRepaintRect=a,e.fire("repaint",{},!1),e},renderHtml:function(){var e=this,t=e._id,n=e.settings,r=e.encode(e._value,!1),i="";return"spellcheck"in n&&(i+=' spellcheck="'+n.spellcheck+'"'),n.maxLength&&(i+=' maxlength="'+n.maxLength+'"'),n.size&&(i+=' size="'+n.size+'"'),n.subtype&&(i+=' type="'+n.subtype+'"'),e.disabled()&&(i+=' disabled="disabled"'),n.multiline?'<textarea id="'+t+'" class="'+e.classes()+'" '+(n.rows?' rows="'+n.rows+'"':"")+' hidefocus="1"'+i+">"+r+"</textarea>":'<input id="'+t+'" class="'+e.classes()+'" value="'+r+'" hidefocus="1"'+i+" />"},postRender:function(){var e=this;return t.on(e.getEl(),"change",function(t){e.fire("change",t)}),e._super()},remove:function(){t.off(this.getEl()),this._super()}})}),r(tn,[q,$],function(e,t){return function(n,r){var i=this,o,a=t.classPrefix;i.show=function(t){return i.hide(),o=!0,window.setTimeout(function(){o&&n.appendChild(e.createFragment('<div class="'+a+"throbber"+(r?" "+a+"throbber-inline":"")+'"></div>'))},t||0),i},i.hide=function(){var e=n.lastChild;return e&&-1!=e.className.indexOf("throbber")&&e.parentNode.removeChild(e),o=!1,i}}}),a([l,c,u,d,f,p,h,m,g,v,y,b,C,x,w,_,N,E,S,k,T,R,A,B,D,L,M,H,P,O,I,F,z,W,V,U,q,$,j,K,G,Y,X,J,Q,Z,et,tt,nt,rt,it,ot,at,st,lt,ct,ut,dt,ft,pt,ht,mt,gt,vt,yt,bt,Ct,xt,wt,_t,Nt,Et,St,kt,Tt,Rt,At,Bt,Dt,Lt,Mt,Ht,Pt,Ot,It,Ft,zt,Wt,Vt,Ut,qt,$t,jt,Kt,Gt,Yt,Xt,Jt,Qt,Zt,en,tn])}(this);tinymce.PluginManager.add("advlist",function(t){function e(t,e){var n=[];return tinymce.each(e.split(/[ ,]/),function(t){n.push({text:t.replace(/\-/g," ").replace(/\b\w/g,function(t){return t.toUpperCase()}),data:"default"==t?"":t})}),n}function n(e,n){var o,l=t.dom,a=t.selection;o=l.getParent(a.getNode(),"ol,ul"),o&&o.nodeName==e&&n!==!1||t.execCommand("UL"==e?"InsertUnorderedList":"InsertOrderedList"),n=n===!1?i[e]:n,i[e]=n,o=l.getParent(a.getNode(),"ol,ul"),o&&(l.setStyle(o,"listStyleType",n),o.removeAttribute("data-mce-style")),t.focus()}function o(e){var n=t.dom.getStyle(t.dom.getParent(t.selection.getNode(),"ol,ul"),"listStyleType")||"";e.control.items().each(function(t){t.active(t.settings.data===n)})}var l,a,i={};l=e("OL",t.getParam("advlist_number_styles","default,lower-alpha,lower-greek,lower-roman,upper-alpha,upper-roman")),a=e("UL",t.getParam("advlist_bullet_styles","default,circle,disc,square")),t.addButton("numlist",{type:"splitbutton",tooltip:"Numbered list",menu:l,onshow:o,onselect:function(t){n("OL",t.control.settings.data)},onclick:function(){n("OL",!1)}}),t.addButton("bullist",{type:"splitbutton",tooltip:"Bullet list",menu:a,onshow:o,onselect:function(t){n("UL",t.control.settings.data)},onclick:function(){n("UL",!1)}})});tinymce.PluginManager.add("anchor",function(n){function e(){var e=n.selection.getNode();n.windowManager.open({title:"Anchor",body:{type:"textbox",name:"name",size:40,label:"Name",value:e.name||e.id},onsubmit:function(e){n.execCommand("mceInsertContent",!1,n.dom.createHTML("a",{id:e.data.name}))}})}n.addButton("anchor",{icon:"anchor",tooltip:"Anchor",onclick:e,stateSelector:"a:not([href])"}),n.addMenuItem("anchor",{icon:"anchor",text:"Anchor",context:"insert",onclick:e})});tinymce.PluginManager.add("autolink",function(t){function n(t){o(t,-1,"(",!0)}function e(t){o(t,0,"",!0)}function i(t){o(t,-1,"",!1)}function o(t,n,e){function i(t,n){if(0>n&&(n=0),3==t.nodeType){var e=t.data.length;n>e&&(n=e)}return n}function o(t,n){f.setStart(t,i(t,n))}function r(t,n){f.setEnd(t,i(t,n))}var f,d,a,s,c,l,u,g,h;if(f=t.selection.getRng(!0).cloneRange(),f.startOffset<5){if(g=f.endContainer.previousSibling,!g){if(!f.endContainer.firstChild||!f.endContainer.firstChild.nextSibling)return;g=f.endContainer.firstChild.nextSibling}if(h=g.length,o(g,h),r(g,h),f.endOffset<5)return;d=f.endOffset,s=g}else{if(s=f.endContainer,3!=s.nodeType&&s.firstChild){for(;3!=s.nodeType&&s.firstChild;)s=s.firstChild;3==s.nodeType&&(o(s,0),r(s,s.nodeValue.length))}d=1==f.endOffset?2:f.endOffset-1-n}a=d;do o(s,d>=2?d-2:0),r(s,d>=1?d-1:0),d-=1;while(" "!=f.toString()&&""!==f.toString()&&160!=f.toString().charCodeAt(0)&&d-2>=0&&f.toString()!=e);f.toString()==e||160==f.toString().charCodeAt(0)?(o(s,d),r(s,a),d+=1):0===f.startOffset?(o(s,0),r(s,a)):(o(s,d),r(s,a)),l=f.toString(),"."==l.charAt(l.length-1)&&r(s,a-1),l=f.toString(),u=l.match(/^(https?:\/\/|ssh:\/\/|ftp:\/\/|file:\/|www\.|(?:mailto:)?[A-Z0-9._%+\-]+@)(.+)$/i),u&&("www."==u[1]?u[1]="http://www.":/@$/.test(u[1])&&!/^mailto:/.test(u[1])&&(u[1]="mailto:"+u[1]),c=t.selection.getBookmark(),t.selection.setRng(f),t.execCommand("createlink",!1,u[1]+u[2]),t.selection.moveToBookmark(c),t.nodeChanged())}var r;return t.on("keydown",function(n){return 13==n.keyCode?i(t):void 0}),tinymce.Env.ie?void t.on("focus",function(){if(!r){r=!0;try{t.execCommand("AutoUrlDetect",!1,!0)}catch(n){}}}):(t.on("keypress",function(e){return 41==e.keyCode?n(t):void 0}),void t.on("keyup",function(n){return 32==n.keyCode?e(t):void 0}))});tinymce.PluginManager.add("autoresize",function(e){function t(){return e.plugins.fullscreen&&e.plugins.fullscreen.isFullscreen()}function i(n){var s,r,g,u,l,m,h,d,f=tinymce.DOM;if(r=e.getDoc()){if(g=r.body,u=r.documentElement,l=o.autoresize_min_height,!g||n&&"setcontent"===n.type&&n.initial||t())return void(g&&u&&(g.style.overflowY="auto",u.style.overflowY="auto"));h=e.dom.getStyle(g,"margin-top",!0),d=e.dom.getStyle(g,"margin-bottom",!0),m=g.offsetHeight+parseInt(h,10)+parseInt(d,10),(isNaN(m)||0>=m)&&(m=tinymce.Env.ie?g.scrollHeight:tinymce.Env.webkit&&0===g.clientHeight?0:g.offsetHeight),m>o.autoresize_min_height&&(l=m),o.autoresize_max_height&&m>o.autoresize_max_height?(l=o.autoresize_max_height,g.style.overflowY="auto",u.style.overflowY="auto"):(g.style.overflowY="hidden",u.style.overflowY="hidden",g.scrollTop=0),l!==a&&(s=l-a,f.setStyle(f.get(e.id+"_ifr"),"height",l+"px"),a=l,tinymce.isWebKit&&0>s&&i(n))}}function n(e,t,o){setTimeout(function(){i({}),e--?n(e,t,o):o&&o()},t)}var o=e.settings,a=0;e.settings.inline||(o.autoresize_min_height=parseInt(e.getParam("autoresize_min_height",e.getElement().offsetHeight),10),o.autoresize_max_height=parseInt(e.getParam("autoresize_max_height",0),10),e.on("init",function(){var t=e.getParam("autoresize_overflow_padding",1);e.dom.setStyles(e.getBody(),{paddingBottom:e.getParam("autoresize_bottom_margin",50),paddingLeft:t,paddingRight:t})}),e.on("nodechange setcontent keyup FullscreenStateChanged",i),e.getParam("autoresize_on_init",!0)&&e.on("init",function(){n(20,100,function(){n(5,1e3)})}),e.addCommand("mceAutoResize",i))});tinymce.PluginManager.add("autosave",function(e){function t(e,t){var n={s:1e3,m:6e4};return e=/^(\d+)([ms]?)$/.exec(""+(e||t)),(e[2]?n[e[2]]:1)*parseInt(e,10)}function n(){var e=parseInt(l.getItem(d+"time"),10)||0;return(new Date).getTime()-e>v.autosave_retention?(a(!1),!1):!0}function a(t){l.removeItem(d+"draft"),l.removeItem(d+"time"),t!==!1&&e.fire("RemoveDraft")}function r(){!c()&&e.isDirty()&&(l.setItem(d+"draft",e.getContent({format:"raw",no_events:!0})),l.setItem(d+"time",(new Date).getTime()),e.fire("StoreDraft"))}function o(){n()&&(e.setContent(l.getItem(d+"draft"),{format:"raw"}),e.fire("RestoreDraft"))}function i(){m||(setInterval(function(){e.removed||r()},v.autosave_interval),m=!0)}function s(){var t=this;t.disabled(!n()),e.on("StoreDraft RestoreDraft RemoveDraft",function(){t.disabled(!n())}),i()}function u(){e.undoManager.beforeChange(),o(),a(),e.undoManager.add()}function f(){var e;return tinymce.each(tinymce.editors,function(t){t.plugins.autosave&&t.plugins.autosave.storeDraft(),!e&&t.isDirty()&&t.getParam("autosave_ask_before_unload",!0)&&(e=t.translate("You have unsaved changes are you sure you want to navigate away?"))}),e}function c(t){var n=e.settings.forced_root_block;return t=tinymce.trim("undefined"==typeof t?e.getBody().innerHTML:t),""===t||new RegExp("^<"+n+"[^>]*>(( |&nbsp;|[ 	]|<br[^>]*>)+?|)</"+n+">|<br>$","i").test(t)}var d,m,v=e.settings,l=tinymce.util.LocalStorage;d=v.autosave_prefix||"tinymce-autosave-{path}{query}-{id}-",d=d.replace(/\{path\}/g,document.location.pathname),d=d.replace(/\{query\}/g,document.location.search),d=d.replace(/\{id\}/g,e.id),v.autosave_interval=t(v.autosave_interval,"30s"),v.autosave_retention=t(v.autosave_retention,"20m"),e.addButton("restoredraft",{title:"Restore last draft",onclick:u,onPostRender:s}),e.addMenuItem("restoredraft",{text:"Restore last draft",onclick:u,onPostRender:s,context:"file"}),e.settings.autosave_restore_when_empty!==!1&&(e.on("init",function(){n()&&c()&&o()}),e.on("saveContent",function(){a()})),window.onbeforeunload=f,this.hasDraft=n,this.storeDraft=r,this.restoreDraft=o,this.removeDraft=a,this.isEmpty=c});!function(){tinymce.create("tinymce.plugins.BBCodePlugin",{init:function(o){var e=this,t=o.getParam("bbcode_dialect","punbb").toLowerCase();o.on("beforeSetContent",function(o){o.content=e["_"+t+"_bbcode2html"](o.content)}),o.on("postProcess",function(o){o.set&&(o.content=e["_"+t+"_bbcode2html"](o.content)),o.get&&(o.content=e["_"+t+"_html2bbcode"](o.content))})},getInfo:function(){return{longname:"BBCode Plugin",author:"Moxiecode Systems AB",authorurl:"http://www.tinymce.com",infourl:"http://www.tinymce.com/wiki.php/Plugin:bbcode"}},_punbb_html2bbcode:function(o){function e(e,t){o=o.replace(e,t)}return o=tinymce.trim(o),e(/<a.*?href=\"(.*?)\".*?>(.*?)<\/a>/gi,"[url=$1]$2[/url]"),e(/<font.*?color=\"(.*?)\".*?class=\"codeStyle\".*?>(.*?)<\/font>/gi,"[code][color=$1]$2[/color][/code]"),e(/<font.*?color=\"(.*?)\".*?class=\"quoteStyle\".*?>(.*?)<\/font>/gi,"[quote][color=$1]$2[/color][/quote]"),e(/<font.*?class=\"codeStyle\".*?color=\"(.*?)\".*?>(.*?)<\/font>/gi,"[code][color=$1]$2[/color][/code]"),e(/<font.*?class=\"quoteStyle\".*?color=\"(.*?)\".*?>(.*?)<\/font>/gi,"[quote][color=$1]$2[/color][/quote]"),e(/<span style=\"color: ?(.*?);\">(.*?)<\/span>/gi,"[color=$1]$2[/color]"),e(/<font.*?color=\"(.*?)\".*?>(.*?)<\/font>/gi,"[color=$1]$2[/color]"),e(/<span style=\"font-size:(.*?);\">(.*?)<\/span>/gi,"[size=$1]$2[/size]"),e(/<font>(.*?)<\/font>/gi,"$1"),e(/<img.*?src=\"(.*?)\".*?\/>/gi,"[img]$1[/img]"),e(/<span class=\"codeStyle\">(.*?)<\/span>/gi,"[code]$1[/code]"),e(/<span class=\"quoteStyle\">(.*?)<\/span>/gi,"[quote]$1[/quote]"),e(/<strong class=\"codeStyle\">(.*?)<\/strong>/gi,"[code][b]$1[/b][/code]"),e(/<strong class=\"quoteStyle\">(.*?)<\/strong>/gi,"[quote][b]$1[/b][/quote]"),e(/<em class=\"codeStyle\">(.*?)<\/em>/gi,"[code][i]$1[/i][/code]"),e(/<em class=\"quoteStyle\">(.*?)<\/em>/gi,"[quote][i]$1[/i][/quote]"),e(/<u class=\"codeStyle\">(.*?)<\/u>/gi,"[code][u]$1[/u][/code]"),e(/<u class=\"quoteStyle\">(.*?)<\/u>/gi,"[quote][u]$1[/u][/quote]"),e(/<\/(strong|b)>/gi,"[/b]"),e(/<(strong|b)>/gi,"[b]"),e(/<\/(em|i)>/gi,"[/i]"),e(/<(em|i)>/gi,"[i]"),e(/<\/u>/gi,"[/u]"),e(/<span style=\"text-decoration: ?underline;\">(.*?)<\/span>/gi,"[u]$1[/u]"),e(/<u>/gi,"[u]"),e(/<blockquote[^>]*>/gi,"[quote]"),e(/<\/blockquote>/gi,"[/quote]"),e(/<br \/>/gi,"\n"),e(/<br\/>/gi,"\n"),e(/<br>/gi,"\n"),e(/<p>/gi,""),e(/<\/p>/gi,"\n"),e(/&nbsp;|\u00a0/gi," "),e(/&quot;/gi,'"'),e(/&lt;/gi,"<"),e(/&gt;/gi,">"),e(/&amp;/gi,"&"),o},_punbb_bbcode2html:function(o){function e(e,t){o=o.replace(e,t)}return o=tinymce.trim(o),e(/\n/gi,"<br />"),e(/\[b\]/gi,"<strong>"),e(/\[\/b\]/gi,"</strong>"),e(/\[i\]/gi,"<em>"),e(/\[\/i\]/gi,"</em>"),e(/\[u\]/gi,"<u>"),e(/\[\/u\]/gi,"</u>"),e(/\[url=([^\]]+)\](.*?)\[\/url\]/gi,'<a href="$1">$2</a>'),e(/\[url\](.*?)\[\/url\]/gi,'<a href="$1">$1</a>'),e(/\[img\](.*?)\[\/img\]/gi,'<img src="$1" />'),e(/\[color=(.*?)\](.*?)\[\/color\]/gi,'<font color="$1">$2</font>'),e(/\[code\](.*?)\[\/code\]/gi,'<span class="codeStyle">$1</span>&nbsp;'),e(/\[quote.*?\](.*?)\[\/quote\]/gi,'<span class="quoteStyle">$1</span>&nbsp;'),o}}),tinymce.PluginManager.add("bbcode",tinymce.plugins.BBCodePlugin)}();tinymce.PluginManager.add("charmap",function(e){function a(){function a(e){for(;e;){if("TD"==e.nodeName)return e;e=e.parentNode}}var t,r,o,n;t='<table role="presentation" cellspacing="0" class="mce-charmap"><tbody>';var l=25;for(o=0;10>o;o++){for(t+="<tr>",r=0;l>r;r++){var s=i[o*l+r];t+='<td title="'+s[1]+'"><div tabindex="-1" title="'+s[1]+'" role="button">'+(s?String.fromCharCode(parseInt(s[0],10)):"&nbsp;")+"</div></td>"}t+="</tr>"}t+="</tbody></table>";var c={type:"container",html:t,onclick:function(a){var i=a.target;"TD"==i.tagName&&(i=i.firstChild),"DIV"==i.tagName&&(e.execCommand("mceInsertContent",!1,i.firstChild.data),a.ctrlKey||n.close())},onmouseover:function(e){var i=a(e.target);i&&n.find("#preview").text(i.firstChild.firstChild.data)}};n=e.windowManager.open({title:"Special character",spacing:10,padding:10,items:[c,{type:"label",name:"preview",text:" ",style:"font-size: 40px; text-align: center",border:1,minWidth:100,minHeight:80}],buttons:[{text:"Close",onclick:function(){n.close()}}]})}var i=[["160","no-break space"],["38","ampersand"],["34","quotation mark"],["162","cent sign"],["8364","euro sign"],["163","pound sign"],["165","yen sign"],["169","copyright sign"],["174","registered sign"],["8482","trade mark sign"],["8240","per mille sign"],["181","micro sign"],["183","middle dot"],["8226","bullet"],["8230","three dot leader"],["8242","minutes / feet"],["8243","seconds / inches"],["167","section sign"],["182","paragraph sign"],["223","sharp s / ess-zed"],["8249","single left-pointing angle quotation mark"],["8250","single right-pointing angle quotation mark"],["171","left pointing guillemet"],["187","right pointing guillemet"],["8216","left single quotation mark"],["8217","right single quotation mark"],["8220","left double quotation mark"],["8221","right double quotation mark"],["8218","single low-9 quotation mark"],["8222","double low-9 quotation mark"],["60","less-than sign"],["62","greater-than sign"],["8804","less-than or equal to"],["8805","greater-than or equal to"],["8211","en dash"],["8212","em dash"],["175","macron"],["8254","overline"],["164","currency sign"],["166","broken bar"],["168","diaeresis"],["161","inverted exclamation mark"],["191","turned question mark"],["710","circumflex accent"],["732","small tilde"],["176","degree sign"],["8722","minus sign"],["177","plus-minus sign"],["247","division sign"],["8260","fraction slash"],["215","multiplication sign"],["185","superscript one"],["178","superscript two"],["179","superscript three"],["188","fraction one quarter"],["189","fraction one half"],["190","fraction three quarters"],["402","function / florin"],["8747","integral"],["8721","n-ary sumation"],["8734","infinity"],["8730","square root"],["8764","similar to"],["8773","approximately equal to"],["8776","almost equal to"],["8800","not equal to"],["8801","identical to"],["8712","element of"],["8713","not an element of"],["8715","contains as member"],["8719","n-ary product"],["8743","logical and"],["8744","logical or"],["172","not sign"],["8745","intersection"],["8746","union"],["8706","partial differential"],["8704","for all"],["8707","there exists"],["8709","diameter"],["8711","backward difference"],["8727","asterisk operator"],["8733","proportional to"],["8736","angle"],["180","acute accent"],["184","cedilla"],["170","feminine ordinal indicator"],["186","masculine ordinal indicator"],["8224","dagger"],["8225","double dagger"],["192","A - grave"],["193","A - acute"],["194","A - circumflex"],["195","A - tilde"],["196","A - diaeresis"],["197","A - ring above"],["198","ligature AE"],["199","C - cedilla"],["200","E - grave"],["201","E - acute"],["202","E - circumflex"],["203","E - diaeresis"],["204","I - grave"],["205","I - acute"],["206","I - circumflex"],["207","I - diaeresis"],["208","ETH"],["209","N - tilde"],["210","O - grave"],["211","O - acute"],["212","O - circumflex"],["213","O - tilde"],["214","O - diaeresis"],["216","O - slash"],["338","ligature OE"],["352","S - caron"],["217","U - grave"],["218","U - acute"],["219","U - circumflex"],["220","U - diaeresis"],["221","Y - acute"],["376","Y - diaeresis"],["222","THORN"],["224","a - grave"],["225","a - acute"],["226","a - circumflex"],["227","a - tilde"],["228","a - diaeresis"],["229","a - ring above"],["230","ligature ae"],["231","c - cedilla"],["232","e - grave"],["233","e - acute"],["234","e - circumflex"],["235","e - diaeresis"],["236","i - grave"],["237","i - acute"],["238","i - circumflex"],["239","i - diaeresis"],["240","eth"],["241","n - tilde"],["242","o - grave"],["243","o - acute"],["244","o - circumflex"],["245","o - tilde"],["246","o - diaeresis"],["248","o slash"],["339","ligature oe"],["353","s - caron"],["249","u - grave"],["250","u - acute"],["251","u - circumflex"],["252","u - diaeresis"],["253","y - acute"],["254","thorn"],["255","y - diaeresis"],["913","Alpha"],["914","Beta"],["915","Gamma"],["916","Delta"],["917","Epsilon"],["918","Zeta"],["919","Eta"],["920","Theta"],["921","Iota"],["922","Kappa"],["923","Lambda"],["924","Mu"],["925","Nu"],["926","Xi"],["927","Omicron"],["928","Pi"],["929","Rho"],["931","Sigma"],["932","Tau"],["933","Upsilon"],["934","Phi"],["935","Chi"],["936","Psi"],["937","Omega"],["945","alpha"],["946","beta"],["947","gamma"],["948","delta"],["949","epsilon"],["950","zeta"],["951","eta"],["952","theta"],["953","iota"],["954","kappa"],["955","lambda"],["956","mu"],["957","nu"],["958","xi"],["959","omicron"],["960","pi"],["961","rho"],["962","final sigma"],["963","sigma"],["964","tau"],["965","upsilon"],["966","phi"],["967","chi"],["968","psi"],["969","omega"],["8501","alef symbol"],["982","pi symbol"],["8476","real part symbol"],["978","upsilon - hook symbol"],["8472","Weierstrass p"],["8465","imaginary part"],["8592","leftwards arrow"],["8593","upwards arrow"],["8594","rightwards arrow"],["8595","downwards arrow"],["8596","left right arrow"],["8629","carriage return"],["8656","leftwards double arrow"],["8657","upwards double arrow"],["8658","rightwards double arrow"],["8659","downwards double arrow"],["8660","left right double arrow"],["8756","therefore"],["8834","subset of"],["8835","superset of"],["8836","not a subset of"],["8838","subset of or equal to"],["8839","superset of or equal to"],["8853","circled plus"],["8855","circled times"],["8869","perpendicular"],["8901","dot operator"],["8968","left ceiling"],["8969","right ceiling"],["8970","left floor"],["8971","right floor"],["9001","left-pointing angle bracket"],["9002","right-pointing angle bracket"],["9674","lozenge"],["9824","black spade suit"],["9827","black club suit"],["9829","black heart suit"],["9830","black diamond suit"],["8194","en space"],["8195","em space"],["8201","thin space"],["8204","zero width non-joiner"],["8205","zero width joiner"],["8206","left-to-right mark"],["8207","right-to-left mark"],["173","soft hyphen"]];e.addButton("charmap",{icon:"charmap",tooltip:"Special character",onclick:a}),e.addMenuItem("charmap",{icon:"charmap",text:"Special character",onclick:a,context:"insert"})});tinymce.PluginManager.add("code",function(e){function o(){e.windowManager.open({title:"Source code",body:{type:"textbox",name:"code",multiline:!0,minWidth:e.getParam("code_dialog_width",600),minHeight:e.getParam("code_dialog_height",Math.min(tinymce.DOM.getViewPort().h-200,500)),value:e.getContent({source_view:!0}),spellcheck:!1,style:"direction: ltr; text-align: left"},onSubmit:function(o){e.focus(),e.undoManager.transact(function(){e.setContent(o.data.code)}),e.selection.setCursorLocation(),e.nodeChanged()}})}e.addCommand("mceCodeEditor",o),e.addButton("code",{icon:"code",tooltip:"Source code",onclick:o}),e.addMenuItem("code",{icon:"code",text:"Source code",context:"tools",onclick:o})});tinymce.PluginManager.add("contextmenu",function(e){var n,t=e.settings.contextmenu_never_use_native;e.on("contextmenu",function(i){var o;if(!i.ctrlKey||t){if(i.preventDefault(),o=e.settings.contextmenu||"link image inserttable | cell row column deletetable",n)n.show();else{var c=[];tinymce.each(o.split(/[ ,]/),function(n){var t=e.menuItems[n];"|"==n&&(t={text:n}),t&&(t.shortcut="",c.push(t))});for(var a=0;a<c.length;a++)"|"==c[a].text&&(0===a||a==c.length-1)&&c.splice(a,1);n=new tinymce.ui.Menu({items:c,context:"contextmenu"}).addClass("contextmenu").renderTo(),e.on("remove",function(){n.remove(),n=null})}var l={x:i.pageX,y:i.pageY};e.inline||(l=tinymce.DOM.getPos(e.getContentAreaContainer()),l.x+=i.clientX,l.y+=i.clientY),n.moveTo(l.x,l.y)}})});tinymce.PluginManager.add("directionality",function(t){function e(e){var i,n=t.dom,r=t.selection.getSelectedBlocks();r.length&&(i=n.getAttrib(r[0],"dir"),tinymce.each(r,function(t){n.getParent(t.parentNode,"*[dir='"+e+"']",n.getRoot())||(i!=e?n.setAttrib(t,"dir",e):n.setAttrib(t,"dir",null))}),t.nodeChanged())}function i(t){var e=[];return tinymce.each("h1 h2 h3 h4 h5 h6 div p".split(" "),function(i){e.push(i+"[dir="+t+"]")}),e.join(",")}t.addCommand("mceDirectionLTR",function(){e("ltr")}),t.addCommand("mceDirectionRTL",function(){e("rtl")}),t.addButton("ltr",{title:"Left to right",cmd:"mceDirectionLTR",stateSelector:i("ltr")}),t.addButton("rtl",{title:"Right to left",cmd:"mceDirectionRTL",stateSelector:i("rtl")})});tinymce.PluginManager.add("emoticons",function(t,e){function a(){var t;return t='<table role="list" class="mce-grid">',tinymce.each(i,function(a){t+="<tr>",tinymce.each(a,function(a){var i=e+"/img/smiley-"+a+".gif";t+='<td><a href="#" data-mce-url="'+i+'" data-mce-alt="'+a+'" tabindex="-1" role="option" aria-label="'+a+'"><img src="'+i+'" style="width: 18px; height: 18px" role="presentation" /></a></td>'}),t+="</tr>"}),t+="</table>"}var i=[["cool","cry","embarassed","foot-in-mouth"],["frown","innocent","kiss","laughing"],["money-mouth","sealed","smile","surprised"],["tongue-out","undecided","wink","yell"]];t.addButton("emoticons",{type:"panelbutton",panel:{role:"application",autohide:!0,html:a,onclick:function(e){var a=t.dom.getParent(e.target,"a");a&&(t.insertContent('<img src="'+a.getAttribute("data-mce-url")+'" alt="'+a.getAttribute("data-mce-alt")+'" />'),this.hide())}},tooltip:"Emoticons"})});tinymce.PluginManager.add("fullpage",function(e){function t(){var t=n();e.windowManager.open({title:"Document properties",data:t,defaults:{type:"textbox",size:40},body:[{name:"title",label:"Title"},{name:"keywords",label:"Keywords"},{name:"description",label:"Description"},{name:"robots",label:"Robots"},{name:"author",label:"Author"},{name:"docencoding",label:"Encoding"}],onSubmit:function(e){l(tinymce.extend(t,e.data))}})}function n(){function t(e,t){var n=e.attr(t);return n||""}var n,l,a=i(),r={};return r.fontface=e.getParam("fullpage_default_fontface",""),r.fontsize=e.getParam("fullpage_default_fontsize",""),n=a.firstChild,7==n.type&&(r.xml_pi=!0,l=/encoding="([^"]+)"/.exec(n.value),l&&(r.docencoding=l[1])),n=a.getAll("#doctype")[0],n&&(r.doctype="<!DOCTYPE"+n.value+">"),n=a.getAll("title")[0],n&&n.firstChild&&(r.title=n.firstChild.value),s(a.getAll("meta"),function(e){var t,n=e.attr("name"),l=e.attr("http-equiv");n?r[n.toLowerCase()]=e.attr("content"):"Content-Type"==l&&(t=/charset\s*=\s*(.*)\s*/gi.exec(e.attr("content")),t&&(r.docencoding=t[1]))}),n=a.getAll("html")[0],n&&(r.langcode=t(n,"lang")||t(n,"xml:lang")),r.stylesheets=[],tinymce.each(a.getAll("link"),function(e){"stylesheet"==e.attr("rel")&&r.stylesheets.push(e.attr("href"))}),n=a.getAll("body")[0],n&&(r.langdir=t(n,"dir"),r.style=t(n,"style"),r.visited_color=t(n,"vlink"),r.link_color=t(n,"link"),r.active_color=t(n,"alink")),r}function l(t){function n(e,t,n){e.attr(t,n?n:void 0)}function l(e){r.firstChild?r.insert(e,r.firstChild):r.append(e)}var a,r,o,c,u,f=e.dom;a=i(),r=a.getAll("head")[0],r||(c=a.getAll("html")[0],r=new m("head",1),c.firstChild?c.insert(r,c.firstChild,!0):c.append(r)),c=a.firstChild,t.xml_pi?(u='version="1.0"',t.docencoding&&(u+=' encoding="'+t.docencoding+'"'),7!=c.type&&(c=new m("xml",7),a.insert(c,a.firstChild,!0)),c.value=u):c&&7==c.type&&c.remove(),c=a.getAll("#doctype")[0],t.doctype?(c||(c=new m("#doctype",10),t.xml_pi?a.insert(c,a.firstChild):l(c)),c.value=t.doctype.substring(9,t.doctype.length-1)):c&&c.remove(),c=null,s(a.getAll("meta"),function(e){"Content-Type"==e.attr("http-equiv")&&(c=e)}),t.docencoding?(c||(c=new m("meta",1),c.attr("http-equiv","Content-Type"),c.shortEnded=!0,l(c)),c.attr("content","text/html; charset="+t.docencoding)):c.remove(),c=a.getAll("title")[0],t.title?(c?c.empty():(c=new m("title",1),l(c)),c.append(new m("#text",3)).value=t.title):c&&c.remove(),s("keywords,description,author,copyright,robots".split(","),function(e){var n,i,r=a.getAll("meta"),o=t[e];for(n=0;n<r.length;n++)if(i=r[n],i.attr("name")==e)return void(o?i.attr("content",o):i.remove());o&&(c=new m("meta",1),c.attr("name",e),c.attr("content",o),c.shortEnded=!0,l(c))});var g={};tinymce.each(a.getAll("link"),function(e){"stylesheet"==e.attr("rel")&&(g[e.attr("href")]=e)}),tinymce.each(t.stylesheets,function(e){g[e]||(c=new m("link",1),c.attr({rel:"stylesheet",text:"text/css",href:e}),c.shortEnded=!0,l(c)),delete g[e]}),tinymce.each(g,function(e){e.remove()}),c=a.getAll("body")[0],c&&(n(c,"dir",t.langdir),n(c,"style",t.style),n(c,"vlink",t.visited_color),n(c,"link",t.link_color),n(c,"alink",t.active_color),f.setAttribs(e.getBody(),{style:t.style,dir:t.dir,vLink:t.visited_color,link:t.link_color,aLink:t.active_color})),c=a.getAll("html")[0],c&&(n(c,"lang",t.langcode),n(c,"xml:lang",t.langcode)),r.firstChild||r.remove(),o=new tinymce.html.Serializer({validate:!1,indent:!0,apply_source_formatting:!0,indent_before:"head,html,body,meta,title,script,link,style",indent_after:"head,html,body,meta,title,script,link,style"}).serialize(a),d=o.substring(0,o.indexOf("</body>"))}function i(){return new tinymce.html.DomParser({validate:!1,root_name:"#document"}).parse(d)}function a(t){function n(e){return e.replace(/<\/?[A-Z]+/g,function(e){return e.toLowerCase()})}var l,a,o,m,u=t.content,f="",g=e.dom;if(!t.selection&&!("raw"==t.format&&d||t.source_view&&e.getParam("fullpage_hide_in_source_view"))){u=u.replace(/<(\/?)BODY/gi,"<$1body"),l=u.indexOf("<body"),-1!=l?(l=u.indexOf(">",l),d=n(u.substring(0,l+1)),a=u.indexOf("</body",l),-1==a&&(a=u.length),t.content=u.substring(l+1,a),c=n(u.substring(a))):(d=r(),c="\n</body>\n</html>"),o=i(),s(o.getAll("style"),function(e){e.firstChild&&(f+=e.firstChild.value)}),m=o.getAll("body")[0],m&&g.setAttribs(e.getBody(),{style:m.attr("style")||"",dir:m.attr("dir")||"",vLink:m.attr("vlink")||"",link:m.attr("link")||"",aLink:m.attr("alink")||""}),g.remove("fullpage_styles");var y=e.getDoc().getElementsByTagName("head")[0];f&&(g.add(y,"style",{id:"fullpage_styles"},f),m=g.get("fullpage_styles"),m.styleSheet&&(m.styleSheet.cssText=f));var h={};tinymce.each(y.getElementsByTagName("link"),function(e){"stylesheet"==e.rel&&e.getAttribute("data-mce-fullpage")&&(h[e.href]=e)}),tinymce.each(o.getAll("link"),function(e){var t=e.attr("href");h[t]||"stylesheet"!=e.attr("rel")||g.add(y,"link",{rel:"stylesheet",text:"text/css",href:t,"data-mce-fullpage":"1"}),delete h[t]}),tinymce.each(h,function(e){e.parentNode.removeChild(e)})}}function r(){var t,n="",l="";return e.getParam("fullpage_default_xml_pi")&&(n+='<?xml version="1.0" encoding="'+e.getParam("fullpage_default_encoding","ISO-8859-1")+'" ?>\n'),n+=e.getParam("fullpage_default_doctype","<!DOCTYPE html>"),n+="\n<html>\n<head>\n",(t=e.getParam("fullpage_default_title"))&&(n+="<title>"+t+"</title>\n"),(t=e.getParam("fullpage_default_encoding"))&&(n+='<meta http-equiv="Content-Type" content="text/html; charset='+t+'" />\n'),(t=e.getParam("fullpage_default_font_family"))&&(l+="font-family: "+t+";"),(t=e.getParam("fullpage_default_font_size"))&&(l+="font-size: "+t+";"),(t=e.getParam("fullpage_default_text_color"))&&(l+="color: "+t+";"),n+="</head>\n<body"+(l?' style="'+l+'"':"")+">\n"}function o(t){t.selection||t.source_view&&e.getParam("fullpage_hide_in_source_view")||(t.content=tinymce.trim(d)+"\n"+tinymce.trim(t.content)+"\n"+tinymce.trim(c))}var d,c,s=tinymce.each,m=tinymce.html.Node;e.addCommand("mceFullPageProperties",t),e.addButton("fullpage",{title:"Document properties",cmd:"mceFullPageProperties"}),e.addMenuItem("fullpage",{text:"Document properties",cmd:"mceFullPageProperties",context:"file"}),e.on("BeforeSetContent",a),e.on("GetContent",o)});tinymce.PluginManager.add("fullscreen",function(e){function t(){var e,t,n=window,i=document,l=i.body;return l.offsetWidth&&(e=l.offsetWidth,t=l.offsetHeight),n.innerWidth&&n.innerHeight&&(e=n.innerWidth,t=n.innerHeight),{w:e,h:t}}function n(){function n(){d.setStyle(a,"height",t().h-(h.clientHeight-a.clientHeight))}var u,h,a,f,m=document.body,g=document.documentElement;s=!s,h=e.getContainer(),u=h.style,a=e.getContentAreaContainer().firstChild,f=a.style,s?(i=f.width,l=f.height,f.width=f.height="100%",c=u.width,o=u.height,u.width=u.height="",d.addClass(m,"mce-fullscreen"),d.addClass(g,"mce-fullscreen"),d.addClass(h,"mce-fullscreen"),d.bind(window,"resize",n),n(),r=n):(f.width=i,f.height=l,c&&(u.width=c),o&&(u.height=o),d.removeClass(m,"mce-fullscreen"),d.removeClass(g,"mce-fullscreen"),d.removeClass(h,"mce-fullscreen"),d.unbind(window,"resize",r)),e.fire("FullscreenStateChanged",{state:s})}var i,l,r,c,o,s=!1,d=tinymce.DOM;return e.settings.inline?void 0:(e.on("init",function(){e.addShortcut("Ctrl+Alt+F","",n)}),e.on("remove",function(){r&&d.unbind(window,"resize",r)}),e.addCommand("mceFullScreen",n),e.addMenuItem("fullscreen",{text:"Fullscreen",shortcut:"Ctrl+Alt+F",selectable:!0,onClick:n,onPostRender:function(){var t=this;e.on("FullscreenStateChanged",function(e){t.active(e.state)})},context:"view"}),e.addButton("fullscreen",{tooltip:"Fullscreen",shortcut:"Ctrl+Alt+F",onClick:n,onPostRender:function(){var t=this;e.on("FullscreenStateChanged",function(e){t.active(e.state)})}}),{isFullscreen:function(){return s}})});tinymce.PluginManager.add("hr",function(n){n.addCommand("InsertHorizontalRule",function(){n.execCommand("mceInsertContent",!1,"<hr />")}),n.addButton("hr",{icon:"hr",tooltip:"Horizontal line",cmd:"InsertHorizontalRule"}),n.addMenuItem("hr",{icon:"hr",text:"Horizontal line",cmd:"InsertHorizontalRule",context:"insert"})});tinymce.PluginManager.add("image",function(e){function t(e,t){function i(e,i){n.parentNode&&n.parentNode.removeChild(n),t({width:e,height:i})}var n=document.createElement("img");n.onload=function(){i(n.clientWidth,n.clientHeight)},n.onerror=function(){i()};var a=n.style;a.visibility="hidden",a.position="fixed",a.bottom=a.left=0,a.width=a.height="auto",document.body.appendChild(n),n.src=e}function i(t){return tinymce.each(t,function(t){t.textStyle=function(){return e.formatter.getCssText({inline:"img",classes:[t.value]})}}),t}function n(t){return function(){var i=e.settings.image_list;"string"==typeof i?tinymce.util.XHR.send({url:i,success:function(e){t(tinymce.util.JSON.parse(e))}}):"function"==typeof i?i(t):t(i)}}function a(n){function a(t,i,n){var a,l=[];return tinymce.each(e.settings[t]||n,function(e){var t={text:e.text||e.title,value:e.value};l.push(t),(f[i]===e.value||!a&&e.selected)&&(a=t)}),a&&!f[i]&&(f[i]=a.value,a.selected=!0),l}function l(){var t=[{text:"None",value:""}];return tinymce.each(n,function(i){t.push({text:i.text||i.title,value:e.convertURL(i.value||i.url,"src"),menu:i.menu})}),t}function o(){var e,t,i,n;e=u.find("#width")[0],t=u.find("#height")[0],i=e.value(),n=t.value(),u.find("#constrain")[0].checked()&&g&&h&&i&&n&&(g!=i?(n=Math.round(i/g*n),t.value(n)):(i=Math.round(n/h*i),e.value(i))),g=i,h=n}function s(){function t(t){function i(){t.onload=t.onerror=null,e.selection.select(t),e.nodeChanged()}t.onload=function(){f.width||f.height||y.setAttribs(t,{width:t.clientWidth,height:t.clientHeight}),i()},t.onerror=i}d(),o(),f=tinymce.extend(f,u.toJSON()),f.alt||(f.alt=""),""===f.width&&(f.width=null),""===f.height&&(f.height=null),f.style||(f.style=null),f={src:f.src,alt:f.alt,width:f.width,height:f.height,style:f.style,"class":f["class"]},f["class"]||delete f["class"],e.undoManager.transact(function(){return f.src?(v?y.setAttribs(v,f):(f.id="__mcenew",e.focus(),e.selection.setContent(y.createHTML("img",f)),v=y.get("__mcenew"),y.setAttrib(v,"id",null)),void t(v)):void(v&&(y.remove(v),e.focus(),e.nodeChanged()))})}function r(e){return e&&(e=e.replace(/px$/,"")),e}function c(){m&&m.value(e.convertURL(this.value(),"src")),t(this.value(),function(e){e.width&&e.height&&(g=e.width,h=e.height,u.find("#width").value(g),u.find("#height").value(h))})}function d(){function t(e){return e.length>0&&/^[0-9]+$/.test(e)&&(e+="px"),e}if(e.settings.image_advtab){var i=u.toJSON(),n=y.parseStyle(i.style);delete n.margin,n["margin-top"]=n["margin-bottom"]=t(i.vspace),n["margin-left"]=n["margin-right"]=t(i.hspace),n["border-width"]=t(i.border),u.find("#style").value(y.serializeStyle(y.parseStyle(y.serializeStyle(n))))}}var u,g,h,m,p,f={},y=e.dom,v=e.selection.getNode();g=y.getAttrib(v,"width"),h=y.getAttrib(v,"height"),"IMG"!=v.nodeName||v.getAttribute("data-mce-object")||v.getAttribute("data-mce-placeholder")?v=null:f={src:y.getAttrib(v,"src"),alt:y.getAttrib(v,"alt"),"class":y.getAttrib(v,"class"),width:g,height:h},n&&(m={type:"listbox",label:"Image list",values:l(),value:f.src&&e.convertURL(f.src,"src"),onselect:function(e){var t=u.find("#alt");(!t.value()||e.lastControl&&t.value()==e.lastControl.text())&&t.value(e.control.text()),u.find("#src").value(e.control.value())},onPostRender:function(){m=this}}),e.settings.image_class_list&&(p={name:"class",type:"listbox",label:"Class",values:i(a("image_class_list","class"))});var b=[{name:"src",type:"filepicker",filetype:"image",label:"Source",autofocus:!0,onchange:c},m];e.settings.image_description!==!1&&b.push({name:"alt",type:"textbox",label:"Image description"}),e.settings.image_dimensions!==!1&&b.push({type:"container",label:"Dimensions",layout:"flex",direction:"row",align:"center",spacing:5,items:[{name:"width",type:"textbox",maxLength:5,size:3,onchange:o,ariaLabel:"Width"},{type:"label",text:"x"},{name:"height",type:"textbox",maxLength:5,size:3,onchange:o,ariaLabel:"Height"},{name:"constrain",type:"checkbox",checked:!0,text:"Constrain proportions"}]}),b.push(p),e.settings.image_advtab?(v&&(f.hspace=r(v.style.marginLeft||v.style.marginRight),f.vspace=r(v.style.marginTop||v.style.marginBottom),f.border=r(v.style.borderWidth),f.style=e.dom.serializeStyle(e.dom.parseStyle(e.dom.getAttrib(v,"style")))),u=e.windowManager.open({title:"Insert/edit image",data:f,bodyType:"tabpanel",body:[{title:"General",type:"form",items:b},{title:"Advanced",type:"form",pack:"start",items:[{label:"Style",name:"style",type:"textbox"},{type:"form",layout:"grid",packV:"start",columns:2,padding:0,alignH:["left","right"],defaults:{type:"textbox",maxWidth:50,onchange:d},items:[{label:"Vertical space",name:"vspace"},{label:"Horizontal space",name:"hspace"},{label:"Border",name:"border"}]}]}],onSubmit:s})):u=e.windowManager.open({title:"Insert/edit image",data:f,body:b,onSubmit:s})}e.addButton("image",{icon:"image",tooltip:"Insert/edit image",onclick:n(a),stateSelector:"img:not([data-mce-object],[data-mce-placeholder])"}),e.addMenuItem("image",{icon:"image",text:"Insert image",onclick:n(a),context:"insert",prependToContext:!0})});tinymce.PluginManager.add("importcss",function(t){function e(t){return"string"==typeof t?function(e){return-1!==e.indexOf(t)}:t instanceof RegExp?function(e){return t.test(e)}:t}function n(e,n){function i(t,e){var c,o=t.href;if(o&&n(o,e)){s(t.imports,function(t){i(t,!0)});try{c=t.cssRules||t.rules}catch(a){}s(c,function(t){t.styleSheet?i(t.styleSheet,!0):t.selectorText&&s(t.selectorText.split(","),function(t){r.push(tinymce.trim(t))})})}}var r=[],c={};s(t.contentCSS,function(t){c[t]=!0}),n||(n=function(t,e){return e||c[t]});try{s(e.styleSheets,function(t){i(t)})}catch(o){}return r}function i(e){var n,i=/^(?:([a-z0-9\-_]+))?(\.[a-z0-9_\-\.]+)$/i.exec(e);if(i){var r=i[1],s=i[2].substr(1).split(".").join(" "),c=tinymce.makeMap("a,img");return i[1]?(n={title:e},t.schema.getTextBlockElements()[r]?n.block=r:t.schema.getBlockElements()[r]||c[r.toLowerCase()]?n.selector=r:n.inline=r):i[2]&&(n={inline:"span",title:e.substr(1),classes:s}),t.settings.importcss_merge_classes!==!1?n.classes=s:n.attributes={"class":s},n}}var r=this,s=tinymce.each;t.on("renderFormatsMenu",function(c){var o=t.settings,a={},l=o.importcss_selector_converter||i,f=e(o.importcss_selector_filter),m=c.control;t.settings.importcss_append||m.items().remove();var u=[];tinymce.each(o.importcss_groups,function(t){t=tinymce.extend({},t),t.filter=e(t.filter),u.push(t)}),s(n(c.doc||t.getDoc(),e(o.importcss_file_filter)),function(e){if(-1===e.indexOf(".mce-")&&!a[e]&&(!f||f(e))){var n,i=l.call(r,e);if(i){var s=i.name||tinymce.DOM.uniqueId();if(u)for(var c=0;c<u.length;c++)if(!u[c].filter||u[c].filter(e)){u[c].item||(u[c].item={text:u[c].title,menu:[]}),n=u[c].item.menu;break}t.formatter.register(s,i);var o=tinymce.extend({},m.settings.itemDefaults,{text:i.title,format:s});n?n.push(o):m.add(o)}a[e]=!0}}),s(u,function(t){m.add(t.item)}),c.control.renderNew()}),r.convertSelectorToFormat=i});tinymce.PluginManager.add("insertdatetime",function(e){function t(t,a){function n(e,t){if(e=""+e,e.length<t)for(var a=0;a<t-e.length;a++)e="0"+e;return e}return a=a||new Date,t=t.replace("%D","%m/%d/%Y"),t=t.replace("%r","%I:%M:%S %p"),t=t.replace("%Y",""+a.getFullYear()),t=t.replace("%y",""+a.getYear()),t=t.replace("%m",n(a.getMonth()+1,2)),t=t.replace("%d",n(a.getDate(),2)),t=t.replace("%H",""+n(a.getHours(),2)),t=t.replace("%M",""+n(a.getMinutes(),2)),t=t.replace("%S",""+n(a.getSeconds(),2)),t=t.replace("%I",""+((a.getHours()+11)%12+1)),t=t.replace("%p",""+(a.getHours()<12?"AM":"PM")),t=t.replace("%B",""+e.translate(m[a.getMonth()])),t=t.replace("%b",""+e.translate(c[a.getMonth()])),t=t.replace("%A",""+e.translate(d[a.getDay()])),t=t.replace("%a",""+e.translate(i[a.getDay()])),t=t.replace("%%","%")}function a(a){var n=t(a);if(e.settings.insertdatetime_element){var r;r=t(/%[HMSIp]/.test(a)?"%Y-%m-%dT%H:%M":"%Y-%m-%d"),n='<time datetime="'+r+'">'+n+"</time>";var i=e.dom.getParent(e.selection.getStart(),"time");if(i)return void e.dom.setOuterHTML(i,n)}e.insertContent(n)}var n,r,i="Sun Mon Tue Wed Thu Fri Sat Sun".split(" "),d="Sunday Monday Tuesday Wednesday Thursday Friday Saturday Sunday".split(" "),c="Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec".split(" "),m="January February March April May June July August September October November December".split(" "),u=[];e.addCommand("mceInsertDate",function(){a(e.getParam("insertdatetime_dateformat",e.translate("%Y-%m-%d")))}),e.addCommand("mceInsertTime",function(){a(e.getParam("insertdatetime_timeformat",e.translate("%H:%M:%S")))}),e.addButton("insertdatetime",{type:"splitbutton",title:"Insert date/time",onclick:function(){a(n||r)},menu:u}),tinymce.each(e.settings.insertdatetime_formats||["%H:%M:%S","%Y-%m-%d","%I:%M:%S %p","%D"],function(e){r||(r=e),u.push({text:t(e),onclick:function(){n=e,a(e)}})}),e.addMenuItem("insertdatetime",{icon:"date",text:"Insert date/time",menu:u,context:"insert"})});!function(e){e.on("AddEditor",function(e){e.editor.settings.inline_styles=!1}),e.PluginManager.add("legacyoutput",function(t){t.on("init",function(){var i="p,h1,h2,h3,h4,h5,h6,td,th,div,ul,ol,li,table,img",n=e.explode(t.settings.font_size_style_values),l=t.schema;t.formatter.register({alignleft:{selector:i,attributes:{align:"left"}},aligncenter:{selector:i,attributes:{align:"center"}},alignright:{selector:i,attributes:{align:"right"}},alignjustify:{selector:i,attributes:{align:"justify"}},bold:[{inline:"b",remove:"all"},{inline:"strong",remove:"all"},{inline:"span",styles:{fontWeight:"bold"}}],italic:[{inline:"i",remove:"all"},{inline:"em",remove:"all"},{inline:"span",styles:{fontStyle:"italic"}}],underline:[{inline:"u",remove:"all"},{inline:"span",styles:{textDecoration:"underline"},exact:!0}],strikethrough:[{inline:"strike",remove:"all"},{inline:"span",styles:{textDecoration:"line-through"},exact:!0}],fontname:{inline:"font",attributes:{face:"%value"}},fontsize:{inline:"font",attributes:{size:function(t){return e.inArray(n,t.value)+1}}},forecolor:{inline:"font",attributes:{color:"%value"}},hilitecolor:{inline:"font",styles:{backgroundColor:"%value"}}}),e.each("b,i,u,strike".split(","),function(e){l.addValidElements(e+"[*]")}),l.getElementRule("font")||l.addValidElements("font[face|size|color|style]"),e.each(i.split(","),function(e){var t=l.getElementRule(e);t&&(t.attributes.align||(t.attributes.align={},t.attributesOrder.push("align")))})})})}(tinymce);tinymce.PluginManager.add("link",function(t){function e(e){return function(){var n=t.settings.link_list;"string"==typeof n?tinymce.util.XHR.send({url:n,success:function(t){e(tinymce.util.JSON.parse(t))}}):"function"==typeof n?n(e):e(n)}}function n(e){function n(t){var e=d.find("#text");(!e.value()||t.lastControl&&e.value()==t.lastControl.text())&&e.value(t.control.text()),d.find("#href").value(t.control.value())}function l(){var n=[{text:"None",value:""}];return tinymce.each(e,function(e){n.push({text:e.text||e.title,value:t.convertURL(e.value||e.url,"href"),menu:e.menu})}),n}function i(e){return tinymce.each(e,function(e){e.textStyle=function(){return t.formatter.getCssText({inline:"a",classes:[e.value]})}}),e}function a(e,n,l){var i,a=[];return tinymce.each(t.settings[e]||l,function(t){var e={text:t.text||t.title,value:t.value};a.push(e),(b[n]===t.value||!i&&t.selected)&&(i=e)}),i&&!b[n]&&(b[n]=i.value,i.selected=!0),a}function r(e){var l=[];return tinymce.each(t.dom.select("a:not([href])"),function(t){var n=t.name||t.id;n&&l.push({text:n,value:"#"+n,selected:-1!=e.indexOf("#"+n)})}),l.length?(l.unshift({text:"None",value:""}),{name:"anchor",type:"listbox",label:"Anchors",values:l,onselect:n}):void 0}function o(){h&&h.value(t.convertURL(this.value(),"href")),!f&&0===b.text.length&&x&&this.parent().parent().find("#text")[0].value(this.value())}function s(t){var e=k.getContent();if(/</.test(e)&&(!/^<a [^>]+>[^<]+<\/a>$/.test(e)||-1==e.indexOf("href=")))return!1;if(t){var n,l=t.childNodes;if(0===l.length)return!1;for(n=l.length-1;n>=0;n--)if(3!=l[n].nodeType)return!1}return!0}var u,c,f,d,x,v,h,g,m,p,y,b={},k=t.selection,w=t.dom;u=k.getNode(),c=w.getParent(u,"a[href]"),x=s(),b.text=f=c?c.innerText||c.textContent:k.getContent({format:"text"}),b.href=c?w.getAttrib(c,"href"):"",b.target=c?w.getAttrib(c,"target"):t.settings.default_link_target||null,b.rel=c?w.getAttrib(c,"rel"):null,b["class"]=c?w.getAttrib(c,"class"):null,b.title=c?w.getAttrib(c,"title"):"",x&&(v={name:"text",type:"textbox",size:40,label:"Text to display",onchange:function(){b.text=this.value()}}),e&&(h={type:"listbox",label:"Link list",values:l(),onselect:n,value:t.convertURL(b.href,"href"),onPostRender:function(){h=this}}),t.settings.target_list!==!1&&(m={name:"target",type:"listbox",label:"Target",values:a("target_list","target",[{text:"None",value:""},{text:"New window",value:"_blank"}])}),t.settings.rel_list&&(g={name:"rel",type:"listbox",label:"Rel",values:a("rel_list","rel",[{text:"None",value:""}])}),t.settings.link_class_list&&(p={name:"class",type:"listbox",label:"Class",values:i(a("link_class_list","class"))}),t.settings.link_title!==!1&&(y={name:"title",type:"textbox",label:"Title",value:b.title}),d=t.windowManager.open({title:"Insert link",data:b,body:[{name:"href",type:"filepicker",filetype:"file",size:40,autofocus:!0,label:"Url",onchange:o,onkeyup:o},v,y,r(b.href),h,g,m,p],onSubmit:function(e){function n(e,n){var l=t.selection.getRng();window.setTimeout(function(){t.windowManager.confirm(e,function(e){t.selection.setRng(l),n(e)})},0)}function l(){var e={href:i,target:b.target?b.target:null,rel:b.rel?b.rel:null,"class":b["class"]?b["class"]:null,title:b.title?b.title:null};c?(t.focus(),x&&b.text!=f&&("innerText"in c?c.innerText=b.text:c.textContent=b.text),w.setAttribs(c,e),k.select(c),t.undoManager.add()):x?t.insertContent(w.createHTML("a",e,w.encode(b.text))):t.execCommand("mceInsertLink",!1,e)}var i;return b=tinymce.extend(b,e.data),(i=b.href)?i.indexOf("@")>0&&-1==i.indexOf("//")&&-1==i.indexOf("mailto:")?void n("The URL you entered seems to be an email address. Do you want to add the required mailto: prefix?",function(t){t&&(i="mailto:"+i),l()}):/^\s*www\./i.test(i)?void n("The URL you entered seems to be an external link. Do you want to add the required http:// prefix?",function(t){t&&(i="http://"+i),l()}):void l():void t.execCommand("unlink")}})}t.addButton("link",{icon:"link",tooltip:"Insert/edit link",shortcut:"Ctrl+K",onclick:e(n),stateSelector:"a[href]"}),t.addButton("unlink",{icon:"unlink",tooltip:"Remove link",cmd:"unlink",stateSelector:"a[href]"}),t.addShortcut("Ctrl+K","",e(n)),this.showDialog=n,t.addMenuItem("link",{icon:"link",text:"Insert link",shortcut:"Ctrl+K",onclick:e(n),stateSelector:"a[href]",context:"insert",prependToContext:!0})});tinymce.PluginManager.add("lists",function(e){function t(e){return e&&/^(OL|UL)$/.test(e.nodeName)}function n(e){return e.parentNode.firstChild==e}function r(e){return e.parentNode.lastChild==e}function o(t){return t&&!!e.schema.getTextBlockElements()[t.nodeName]}function i(e){return e&&"SPAN"===e.nodeName&&"bookmark"===e.getAttribute("data-mce-type")}var a=this;e.on("init",function(){function d(e){function t(t){var r,o,i;o=e[t?"startContainer":"endContainer"],i=e[t?"startOffset":"endOffset"],1==o.nodeType&&(r=b.create("span",{"data-mce-type":"bookmark"}),o.hasChildNodes()?(i=Math.min(i,o.childNodes.length-1),t?o.insertBefore(r,o.childNodes[i]):b.insertAfter(r,o.childNodes[i])):o.appendChild(r),o=r,i=0),n[t?"startContainer":"endContainer"]=o,n[t?"startOffset":"endOffset"]=i}var n={};return t(!0),e.collapsed||t(),n}function s(e){function t(t){function n(e){for(var t=e.parentNode.firstChild,n=0;t;){if(t==e)return n;(1!=t.nodeType||"bookmark"!=t.getAttribute("data-mce-type"))&&n++,t=t.nextSibling}return-1}var r,o,i;r=i=e[t?"startContainer":"endContainer"],o=e[t?"startOffset":"endOffset"],r&&(1==r.nodeType&&(o=n(r),r=r.parentNode,b.remove(i)),e[t?"startContainer":"endContainer"]=r,e[t?"startOffset":"endOffset"]=o)}t(!0),t();var n=b.createRng();n.setStart(e.startContainer,e.startOffset),e.endContainer&&n.setEnd(e.endContainer,e.endOffset),k.setRng(n)}function f(t,n){var r,o,i,a=b.createFragment(),d=e.schema.getBlockElements();if(e.settings.forced_root_block&&(n=n||e.settings.forced_root_block),n&&(o=b.create(n),o.tagName===e.settings.forced_root_block&&b.setAttribs(o,e.settings.forced_root_block_attrs),a.appendChild(o)),t)for(;r=t.firstChild;){var s=r.nodeName;i||"SPAN"==s&&"bookmark"==r.getAttribute("data-mce-type")||(i=!0),d[s]?(a.appendChild(r),o=null):n?(o||(o=b.create(n),a.appendChild(o)),o.appendChild(r)):a.appendChild(r)}return e.settings.forced_root_block?i||tinymce.Env.ie&&!(tinymce.Env.ie>10)||o.appendChild(b.create("br",{"data-mce-bogus":"1"})):a.appendChild(b.create("br")),a}function l(){return tinymce.grep(k.getSelectedBlocks(),function(e){return"LI"==e.nodeName})}function c(e,t,n){var r,o,i=b.select('span[data-mce-type="bookmark"]',e);n=n||f(t),r=b.createRng(),r.setStartAfter(t),r.setEndAfter(e),o=r.extractContents(),b.isEmpty(o)||b.insertAfter(o,e),b.insertAfter(n,e),b.isEmpty(t.parentNode)&&(tinymce.each(i,function(e){t.parentNode.parentNode.insertBefore(e,t.parentNode)}),b.remove(t.parentNode)),b.remove(t)}function p(e){var n,r;if(n=e.nextSibling,n&&t(n)&&n.nodeName==e.nodeName){for(;r=n.firstChild;)e.appendChild(r);b.remove(n)}if(n=e.previousSibling,n&&t(n)&&n.nodeName==e.nodeName){for(;r=n.firstChild;)e.insertBefore(r,e.firstChild);b.remove(n)}}function u(e){tinymce.each(tinymce.grep(b.select("ol,ul",e)),function(e){var n,r=e.parentNode;"LI"==r.nodeName&&r.firstChild==e&&(n=r.previousSibling,n&&"LI"==n.nodeName&&(n.appendChild(e),b.isEmpty(r)&&b.remove(r))),t(r)&&(n=r.previousSibling,n&&"LI"==n.nodeName&&n.appendChild(e))})}function m(e){function o(e){b.isEmpty(e)&&b.remove(e)}var i,a=e.parentNode,d=a.parentNode;return n(e)&&r(e)?("LI"==d.nodeName?(b.insertAfter(e,d),o(d),b.remove(a)):t(d)?b.remove(a,!0):(d.insertBefore(f(e),a),b.remove(a)),!0):n(e)?("LI"==d.nodeName?(b.insertAfter(e,d),e.appendChild(a),o(d)):t(d)?d.insertBefore(e,a):(d.insertBefore(f(e),a),b.remove(e)),!0):r(e)?("LI"==d.nodeName?b.insertAfter(e,d):t(d)?b.insertAfter(e,a):(b.insertAfter(f(e),a),b.remove(e)),!0):("LI"==d.nodeName?(a=d,i=f(e,"LI")):i=t(d)?f(e,"LI"):f(e),c(a,e,i),u(a.parentNode),!0)}function h(e){function n(n,r){var o;if(t(n)){for(;o=e.lastChild.firstChild;)r.appendChild(o);b.remove(n)}}var r,o;return r=e.previousSibling,r&&t(r)?(r.appendChild(e),!0):r&&"LI"==r.nodeName&&t(r.lastChild)?(r.lastChild.appendChild(e),n(e.lastChild,r.lastChild),!0):(r=e.nextSibling,r&&t(r)?(r.insertBefore(e,r.firstChild),!0):r&&"LI"==r.nodeName&&t(e.lastChild)?!1:(r=e.previousSibling,r&&"LI"==r.nodeName?(o=b.create(e.parentNode.nodeName),r.appendChild(o),o.appendChild(e),n(e.lastChild,o),!0):!1))}function v(){var t=l();if(t.length){for(var n=d(k.getRng(!0)),r=0;r<t.length&&(h(t[r])||0!==r);r++);return s(n),e.nodeChanged(),!0}}function C(){var t=l();if(t.length){var n,r,o=d(k.getRng(!0)),i=e.getBody();for(n=t.length;n--;)for(var a=t[n].parentNode;a&&a!=i;){for(r=t.length;r--;)if(t[r]===a){t.splice(n,1);break}a=a.parentNode}for(n=0;n<t.length&&(m(t[n])||0!==n);n++);return s(o),e.nodeChanged(),!0}}function g(n){function r(){function t(e){var t,n;for(t=a[e?"startContainer":"endContainer"],n=a[e?"startOffset":"endOffset"],1==t.nodeType&&(t=t.childNodes[Math.min(n,t.childNodes.length-1)]||t);t.parentNode!=d;){if(o(t))return t;if(/^(TD|TH)$/.test(t.parentNode.nodeName))return t;t=t.parentNode}return t}for(var n,r=[],d=e.getBody(),s=t(!0),f=t(),l=[],c=s;c&&(l.push(c),c!=f);c=c.nextSibling);return tinymce.each(l,function(e){if(o(e))return r.push(e),void(n=null);if(b.isBlock(e)||"BR"==e.nodeName)return"BR"==e.nodeName&&b.remove(e),void(n=null);var t=e.nextSibling;return i(e)&&(o(t)||!t&&e.parentNode==d)?void(n=null):(n||(n=b.create("p"),e.parentNode.insertBefore(n,e),r.push(n)),void n.appendChild(e))}),r}var a=k.getRng(!0),f=d(a),l=r();tinymce.each(l,function(e){var r,o;o=e.previousSibling,o&&t(o)&&o.nodeName==n?(r=o,e=b.rename(e,"LI"),o.appendChild(e)):(r=b.create(n),e.parentNode.insertBefore(r,e),r.appendChild(e),e=b.rename(e,"LI")),p(r)}),s(f)}function N(){var n=d(k.getRng(!0)),r=e.getBody();tinymce.each(l(),function(e){var n,o;if(b.isEmpty(e))return void m(e);for(n=e;n&&n!=r;n=n.parentNode)t(n)&&(o=n);c(o,e)}),s(n)}function y(e){var t=b.getParent(k.getStart(),"OL,UL");if(t)if(t.nodeName==e)N(e);else{var n=d(k.getRng(!0));p(b.rename(t,e)),s(n)}else g(e)}var b=e.dom,k=e.selection;a.backspaceDelete=function(e){function n(e,t){var n=e.startContainer,r=e.startOffset;if(3==n.nodeType&&(t?r<n.data.length:r>0))return n;for(var o=new tinymce.dom.TreeWalker(e.startContainer);n=o[t?"next":"prev"]();)if(3==n.nodeType&&n.data.length>0)return n}function r(e,n){var r,o,i=e.parentNode;for(t(n.lastChild)&&(o=n.lastChild),r=n.lastChild,r&&"BR"==r.nodeName&&e.hasChildNodes()&&b.remove(r);r=e.firstChild;)n.appendChild(r);o&&n.appendChild(o),b.remove(e),b.isEmpty(i)&&b.remove(i)}if(k.isCollapsed()){var o=b.getParent(k.getStart(),"LI");if(o){var i=k.getRng(!0),a=b.getParent(n(i,e),"LI");if(a&&a!=o){var f=d(i);return e?r(a,o):r(o,a),s(f),!0}if(!a&&!e&&N(o.parentNode.nodeName))return!0}}},e.addCommand("Indent",function(){return v()?void 0:!0}),e.addCommand("Outdent",function(){return C()?void 0:!0}),e.addCommand("InsertUnorderedList",function(){y("UL")}),e.addCommand("InsertOrderedList",function(){y("OL")}),e.on("keydown",function(t){9==t.keyCode&&e.dom.getParent(e.selection.getStart(),"LI")&&(t.preventDefault(),t.shiftKey?C():v())})}),e.addButton("indent",{icon:"indent",title:"Increase indent",cmd:"Indent",onPostRender:function(){var t=this;e.on("nodechange",function(){for(var r=e.selection.getSelectedBlocks(),o=!1,i=0,a=r.length;!o&&a>i;i++){var d=r[i].nodeName;o="LI"==d&&n(r[i])||"UL"==d||"OL"==d}t.disabled(o)})}}),e.on("keydown",function(e){e.keyCode==tinymce.util.VK.BACKSPACE?a.backspaceDelete()&&e.preventDefault():e.keyCode==tinymce.util.VK.DELETE&&a.backspaceDelete(!0)&&e.preventDefault()})});tinymce.PluginManager.add("media",function(e,t){function i(e){return-1!=e.indexOf(".mp3")?"audio/mpeg":-1!=e.indexOf(".wav")?"audio/wav":-1!=e.indexOf(".mp4")?"video/mp4":-1!=e.indexOf(".webm")?"video/webm":-1!=e.indexOf(".ogg")?"video/ogg":-1!=e.indexOf(".swf")?"application/x-shockwave-flash":""}function r(t){var i=e.settings.media_scripts;if(i)for(var r=0;r<i.length;r++)if(-1!==t.indexOf(i[r].filter))return i[r]}function o(){function t(e){var t,a,c,s;t=i.find("#width")[0],a=i.find("#height")[0],c=t.value(),s=a.value(),i.find("#constrain")[0].checked()&&r&&o&&c&&s&&(e.control==t?(s=Math.round(c/r*s),a.value(s)):(c=Math.round(s/o*c),t.value(c))),r=c,o=s}var i,r,o,m,u=[{name:"source1",type:"filepicker",filetype:"media",size:40,autofocus:!0,label:"Source"}];e.settings.media_alt_source!==!1&&u.push({name:"source2",type:"filepicker",filetype:"media",size:40,label:"Alternative source"}),e.settings.media_poster!==!1&&u.push({name:"poster",type:"filepicker",filetype:"image",size:40,label:"Poster"}),e.settings.media_dimensions!==!1&&u.push({type:"container",label:"Dimensions",layout:"flex",align:"center",spacing:5,items:[{name:"width",type:"textbox",maxLength:3,size:3,onchange:t},{type:"label",text:"x"},{name:"height",type:"textbox",maxLength:3,size:3,onchange:t},{name:"constrain",type:"checkbox",checked:!0,text:"Constrain proportions"}]}),m=n(e.selection.getNode()),r=m.width,o=m.height,i=e.windowManager.open({title:"Insert/edit video",data:m,bodyType:"tabpanel",body:[{title:"General",type:"form",onShowTab:function(){m=s(this.next().find("#embed").value()),this.fromJSON(m)},items:u},{title:"Embed",type:"panel",layout:"flex",direction:"column",align:"stretch",padding:10,spacing:10,onShowTab:function(){this.find("#embed").value(c(this.parent().toJSON()))},items:[{type:"label",text:"Paste your embed code below:",forId:"mcemediasource"},{id:"mcemediasource",type:"textbox",flex:1,name:"embed",value:a(),multiline:!0,label:"Source"}]}],onSubmit:function(){e.insertContent(c(this.toJSON()))}})}function a(){var t=e.selection.getNode();return t.getAttribute("data-mce-object")?e.selection.getContent():void 0}function c(o){var a="";if(!o.source1&&(tinymce.extend(o,s(o.embed)),!o.source1))return"";if(o.source2||(o.source2=""),o.poster||(o.poster=""),o.source1=e.convertURL(o.source1,"source"),o.source2=e.convertURL(o.source2,"source"),o.source1mime=i(o.source1),o.source2mime=i(o.source2),o.poster=e.convertURL(o.poster,"poster"),o.flashPlayerUrl=e.convertURL(t+"/moxieplayer.swf","movie"),tinymce.each(u,function(e){var t,i,r;if(t=e.regex.exec(o.source1)){for(r=e.url,i=0;t[i];i++)r=r.replace("$"+i,function(){return t[i]});o.source1=r,o.type=e.type,o.width=o.width||e.w,o.height=o.height||e.h}}),o.embed)a=m(o.embed,o,!0);else{var c=r(o.source1);c&&(o.type="script",o.width=c.width,o.height=c.height),o.width=o.width||300,o.height=o.height||150,tinymce.each(o,function(t,i){o[i]=e.dom.encode(t)}),"iframe"==o.type?a+='<iframe src="'+o.source1+'" width="'+o.width+'" height="'+o.height+'"></iframe>':"application/x-shockwave-flash"==o.source1mime?(a+='<object data="'+o.source1+'" width="'+o.width+'" height="'+o.height+'" type="application/x-shockwave-flash">',o.poster&&(a+='<img src="'+o.poster+'" width="'+o.width+'" height="'+o.height+'" />'),a+="</object>"):-1!=o.source1mime.indexOf("audio")?e.settings.audio_template_callback?a=e.settings.audio_template_callback(o):a+='<audio controls="controls" src="'+o.source1+'">'+(o.source2?'\n<source src="'+o.source2+'"'+(o.source2mime?' type="'+o.source2mime+'"':"")+" />\n":"")+"</audio>":"script"==o.type?a+='<script src="'+o.source1+'"></script>':a=e.settings.video_template_callback?e.settings.video_template_callback(o):'<video width="'+o.width+'" height="'+o.height+'"'+(o.poster?' poster="'+o.poster+'"':"")+' controls="controls">\n<source src="'+o.source1+'"'+(o.source1mime?' type="'+o.source1mime+'"':"")+" />\n"+(o.source2?'<source src="'+o.source2+'"'+(o.source2mime?' type="'+o.source2mime+'"':"")+" />\n":"")+"</video>"}return a}function s(e){var t={};return new tinymce.html.SaxParser({validate:!1,allow_conditional_comments:!0,special:"script,noscript",start:function(e,i){if(t.source1||"param"!=e||(t.source1=i.map.movie),("iframe"==e||"object"==e||"embed"==e||"video"==e||"audio"==e)&&(t.type||(t.type=e),t=tinymce.extend(i.map,t)),"script"==e){var o=r(i.map.src);if(!o)return;t={type:"script",source1:i.map.src,width:o.width,height:o.height}}"source"==e&&(t.source1?t.source2||(t.source2=i.map.src):t.source1=i.map.src),"img"!=e||t.poster||(t.poster=i.map.src)}}).parse(e),t.source1=t.source1||t.src||t.data,t.source2=t.source2||"",t.poster=t.poster||"",t}function n(t){return t.getAttribute("data-mce-object")?s(e.serializer.serialize(t,{selection:!0})):{}}function m(e,t,i){function r(e,t){var i,r,o,a;for(i in t)if(o=""+t[i],e.map[i])for(r=e.length;r--;)a=e[r],a.name==i&&(o?(e.map[i]=o,a.value=o):(delete e.map[i],e.splice(r,1)));else o&&(e.push({name:i,value:o}),e.map[i]=o)}var o,a=new tinymce.html.Writer,c=0;return new tinymce.html.SaxParser({validate:!1,allow_conditional_comments:!0,special:"script,noscript",comment:function(e){a.comment(e)},cdata:function(e){a.cdata(e)},text:function(e,t){a.text(e,t)},start:function(e,s,n){switch(e){case"video":case"object":case"embed":case"img":case"iframe":r(s,{width:t.width,height:t.height})}if(i)switch(e){case"video":r(s,{poster:t.poster,src:""}),t.source2&&r(s,{src:""});break;case"iframe":r(s,{src:t.source1});break;case"source":if(c++,2>=c&&(r(s,{src:t["source"+c],type:t["source"+c+"mime"]}),!t["source"+c]))return;break;case"img":if(!t.poster)return;o=!0}a.start(e,s,n)},end:function(e){if("video"==e&&i)for(var s=1;2>=s;s++)if(t["source"+s]){var n=[];n.map={},s>c&&(r(n,{src:t["source"+s],type:t["source"+s+"mime"]}),a.start("source",n,!0))}if(t.poster&&"object"==e&&i&&!o){var m=[];m.map={},r(m,{src:t.poster,width:t.width,height:t.height}),a.start("img",m,!0)}a.end(e)}},new tinymce.html.Schema({})).parse(e),a.getContent()}var u=[{regex:/youtu\.be\/([\w\-.]+)/,type:"iframe",w:425,h:350,url:"//www.youtube.com/embed/$1"},{regex:/youtube\.com(.+)v=([^&]+)/,type:"iframe",w:425,h:350,url:"//www.youtube.com/embed/$2"},{regex:/vimeo\.com\/([0-9]+)/,type:"iframe",w:425,h:350,url:"//player.vimeo.com/video/$1?title=0&byline=0&portrait=0&color=8dc7dc"},{regex:/maps\.google\.([a-z]{2,3})\/maps\/(.+)msid=(.+)/,type:"iframe",w:425,h:350,url:'//maps.google.com/maps/ms?msid=$2&output=embed"'}];e.on("ResolveName",function(e){var t;1==e.target.nodeType&&(t=e.target.getAttribute("data-mce-object"))&&(e.name=t)}),e.on("preInit",function(){var t=e.schema.getSpecialElements();tinymce.each("video audio iframe object".split(" "),function(e){t[e]=new RegExp("</"+e+"[^>]*>","gi")});var i=e.schema.getBoolAttrs();tinymce.each("webkitallowfullscreen mozallowfullscreen allowfullscreen".split(" "),function(e){i[e]={}}),e.parser.addNodeFilter("iframe,video,audio,object,embed,script",function(t,i){for(var o,a,c,s,n,m,u,d,l=t.length;l--;)if(a=t[l],a.parent&&("script"!=a.name||(d=r(a.attr("src"))))){for(c=new tinymce.html.Node("img",1),c.shortEnded=!0,d&&(d.width&&a.attr("width",d.width.toString()),d.height&&a.attr("height",d.height.toString())),m=a.attributes,o=m.length;o--;)s=m[o].name,n=m[o].value,"width"!==s&&"height"!==s&&"style"!==s&&(("data"==s||"src"==s)&&(n=e.convertURL(n,s)),c.attr("data-mce-p-"+s,n));u=a.firstChild&&a.firstChild.value,u&&(c.attr("data-mce-html",escape(u)),c.firstChild=null),c.attr({width:a.attr("width")||"300",height:a.attr("height")||("audio"==i?"30":"150"),style:a.attr("style"),src:tinymce.Env.transparentSrc,"data-mce-object":i,"class":"mce-object mce-object-"+i}),a.replace(c)}}),e.serializer.addAttributeFilter("data-mce-object",function(e,t){for(var i,r,o,a,c,s,n,m=e.length;m--;)if(i=e[m],i.parent){for(n=i.attr(t),r=new tinymce.html.Node(n,1),"audio"!=n&&"script"!=n&&r.attr({width:i.attr("width"),height:i.attr("height")}),r.attr({style:i.attr("style")}),a=i.attributes,o=a.length;o--;){var u=a[o].name;0===u.indexOf("data-mce-p-")&&r.attr(u.substr(11),a[o].value)}"script"==n&&r.attr("type","text/javascript"),c=i.attr("data-mce-html"),c&&(s=new tinymce.html.Node("#text",3),s.raw=!0,s.value=unescape(c),r.append(s)),i.replace(r)}})}),e.on("ObjectSelected",function(e){var t=e.target.getAttribute("data-mce-object");("audio"==t||"script"==t)&&e.preventDefault()}),e.on("objectResized",function(e){var t,i=e.target;i.getAttribute("data-mce-object")&&(t=i.getAttribute("data-mce-html"),t&&(t=unescape(t),i.setAttribute("data-mce-html",escape(m(t,{width:e.width,height:e.height})))))}),e.addButton("media",{tooltip:"Insert/edit video",onclick:o,stateSelector:["img[data-mce-object=video]","img[data-mce-object=iframe]"]}),e.addMenuItem("media",{icon:"media",text:"Insert video",onclick:o,context:"insert",prependToContext:!0})});tinymce.PluginManager.add("nonbreaking",function(n){var e=n.getParam("nonbreaking_force_tab");if(n.addCommand("mceNonBreaking",function(){n.insertContent(n.plugins.visualchars&&n.plugins.visualchars.state?'<span class="mce-nbsp">&nbsp;</span>':"&nbsp;"),n.dom.setAttrib(n.dom.select("span.mce-nbsp"),"data-mce-bogus","1")}),n.addButton("nonbreaking",{title:"Insert nonbreaking space",cmd:"mceNonBreaking"}),n.addMenuItem("nonbreaking",{text:"Nonbreaking space",cmd:"mceNonBreaking",context:"insert"}),e){var a=+e>1?+e:3;n.on("keydown",function(e){if(9==e.keyCode){if(e.shiftKey)return;e.preventDefault();for(var t=0;a>t;t++)n.execCommand("mceNonBreaking")}})}});tinymce.PluginManager.add("noneditable",function(e){function t(e){var t;if(1===e.nodeType){if(t=e.getAttribute(u),t&&"inherit"!==t)return t;if(t=e.contentEditable,"inherit"!==t)return t}return null}function n(e){for(var n;e;){if(n=t(e))return"false"===n?e:null;e=e.parentNode}}function r(){function r(e){for(;e;){if(e.id===g)return e;e=e.parentNode}}function a(e){var t;if(e)for(t=new f(e,e),e=t.current();e;e=t.next())if(3===e.nodeType)return e}function i(n,r){var a,i;return"false"===t(n)&&u.isBlock(n)?void s.select(n):(i=u.createRng(),"true"===t(n)&&(n.firstChild||n.appendChild(e.getDoc().createTextNode(" ")),n=n.firstChild,r=!0),a=u.create("span",{id:g,"data-mce-bogus":!0},m),r?n.parentNode.insertBefore(a,n):u.insertAfter(a,n),i.setStart(a.firstChild,1),i.collapse(!0),s.setRng(i),a)}function o(e){var t,n,i,o;if(e)t=s.getRng(!0),t.setStartBefore(e),t.setEndBefore(e),n=a(e),n&&n.nodeValue.charAt(0)==m&&(n=n.deleteData(0,1)),u.remove(e,!0),s.setRng(t);else for(i=r(s.getStart());(e=u.get(g))&&e!==o;)i!==e&&(n=a(e),n&&n.nodeValue.charAt(0)==m&&(n=n.deleteData(0,1)),u.remove(e,!0)),o=e}function l(){function e(e,n){var r,a,i,o,l;if(r=d.startContainer,a=d.startOffset,3==r.nodeType){if(l=r.nodeValue.length,a>0&&l>a||(n?a==l:0===a))return}else{if(!(a<r.childNodes.length))return n?null:e;var u=!n&&a>0?a-1:a;r=r.childNodes[u],r.hasChildNodes()&&(r=r.firstChild)}for(i=new f(r,e);o=i[n?"prev":"next"]();){if(3===o.nodeType&&o.nodeValue.length>0)return;if("true"===t(o))return o}return e}var r,a,l,d,u;o(),l=s.isCollapsed(),r=n(s.getStart()),a=n(s.getEnd()),(r||a)&&(d=s.getRng(!0),l?(r=r||a,(u=e(r,!0))?i(u,!0):(u=e(r,!1))?i(u,!1):s.select(r)):(d=s.getRng(!0),r&&d.setStartBefore(r),a&&d.setEndAfter(a),s.setRng(d)))}function d(a){function i(e,t){for(;e=e[t?"previousSibling":"nextSibling"];)if(3!==e.nodeType||e.nodeValue.length>0)return e}function d(e,t){s.select(e),s.collapse(t)}function g(a){function i(e){for(var t=d;t;){if(t===e)return;t=t.parentNode}u.remove(e),l()}function o(){var r,o,l=e.schema.getNonEmptyElements();for(o=new tinymce.dom.TreeWalker(d,e.getBody());(r=a?o.prev():o.next())&&!l[r.nodeName.toLowerCase()]&&!(3===r.nodeType&&tinymce.trim(r.nodeValue).length>0);)if("false"===t(r))return i(r),!0;return n(r)?!0:!1}var f,d,c,g;if(s.isCollapsed()){if(f=s.getRng(!0),d=f.startContainer,c=f.startOffset,d=r(d)||d,g=n(d))return i(g),!1;if(3==d.nodeType&&(a?c>0:c<d.nodeValue.length))return!0;if(1==d.nodeType&&(d=d.childNodes[c]||d),o())return!1}return!0}var m,p,v,E,h=a.keyCode;if(v=s.getStart(),E=s.getEnd(),m=n(v)||n(E),m&&(112>h||h>124)&&h!=c.DELETE&&h!=c.BACKSPACE){if((tinymce.isMac?a.metaKey:a.ctrlKey)&&(67==h||88==h||86==h))return;if(a.preventDefault(),h==c.LEFT||h==c.RIGHT){var y=h==c.LEFT;if(e.dom.isBlock(m)){var T=y?m.previousSibling:m.nextSibling,C=new f(T,T),b=y?C.prev():C.next();d(b,!y)}else d(m,y)}}else if(h==c.LEFT||h==c.RIGHT||h==c.BACKSPACE||h==c.DELETE){if(p=r(v)){if(h==c.LEFT||h==c.BACKSPACE)if(m=i(p,!0),m&&"false"===t(m)){if(a.preventDefault(),h!=c.LEFT)return void u.remove(m);d(m,!0)}else o(p);if(h==c.RIGHT||h==c.DELETE)if(m=i(p),m&&"false"===t(m)){if(a.preventDefault(),h!=c.RIGHT)return void u.remove(m);d(m,!1)}else o(p)}if((h==c.BACKSPACE||h==c.DELETE)&&!g(h==c.BACKSPACE))return a.preventDefault(),!1}}var u=e.dom,s=e.selection,g="mce_noneditablecaret",m="";e.on("mousedown",function(n){var r=e.selection.getNode();"false"===t(r)&&r==n.target&&l()}),e.on("mouseup keyup",l),e.on("keydown",d)}function a(t){var n=l.length,r=t.content,a=tinymce.trim(o);if("raw"!=t.format){for(;n--;)r=r.replace(l[n],function(t){var n=arguments,i=n[n.length-2];return i>0&&'"'==r.charAt(i-1)?t:'<span class="'+a+'" data-mce-content="'+e.dom.encode(n[0])+'">'+e.dom.encode("string"==typeof n[1]?n[1]:n[0])+"</span>"});t.content=r}}var i,o,l,f=tinymce.dom.TreeWalker,d="contenteditable",u="data-mce-"+d,c=tinymce.util.VK;i=" "+tinymce.trim(e.getParam("noneditable_editable_class","mceEditable"))+" ",o=" "+tinymce.trim(e.getParam("noneditable_noneditable_class","mceNonEditable"))+" ",l=e.getParam("noneditable_regexp"),l&&!l.length&&(l=[l]),e.on("PreInit",function(){r(),l&&e.on("BeforeSetContent",a),e.parser.addAttributeFilter("class",function(e){for(var t,n,r=e.length;r--;)n=e[r],t=" "+n.attr("class")+" ",-1!==t.indexOf(i)?n.attr(u,"true"):-1!==t.indexOf(o)&&n.attr(u,"false")}),e.serializer.addAttributeFilter(u,function(e){for(var t,n=e.length;n--;)t=e[n],l&&t.attr("data-mce-content")?(t.name="#text",t.type=3,t.raw=!0,t.value=t.attr("data-mce-content")):(t.attr(d,null),t.attr(u,null))}),e.parser.addAttributeFilter(d,function(e){for(var t,n=e.length;n--;)t=e[n],t.attr(u,t.attr(d)),t.attr(d,null)})}),e.on("drop",function(e){n(e.target)&&e.preventDefault()})});tinymce.PluginManager.add("pagebreak",function(e){var a="mce-pagebreak",t=e.getParam("pagebreak_separator","<!-- pagebreak -->"),n=new RegExp(t.replace(/[\?\.\*\[\]\(\)\{\}\+\^\$\:]/g,function(e){return"\\"+e}),"gi"),r='<img src="'+tinymce.Env.transparentSrc+'" class="'+a+'" data-mce-resize="false" />';e.addCommand("mcePageBreak",function(){e.insertContent(e.settings.pagebreak_split_block?"<p>"+r+"</p>":r)}),e.addButton("pagebreak",{title:"Page break",cmd:"mcePageBreak"}),e.addMenuItem("pagebreak",{text:"Page break",icon:"pagebreak",cmd:"mcePageBreak",context:"insert"}),e.on("ResolveName",function(t){"IMG"==t.target.nodeName&&e.dom.hasClass(t.target,a)&&(t.name="pagebreak")}),e.on("click",function(t){t=t.target,"IMG"===t.nodeName&&e.dom.hasClass(t,a)&&e.selection.select(t)}),e.on("BeforeSetContent",function(e){e.content=e.content.replace(n,r)}),e.on("PreInit",function(){e.serializer.addNodeFilter("img",function(a){for(var n,r,c=a.length;c--;)if(n=a[c],r=n.attr("class"),r&&-1!==r.indexOf("mce-pagebreak")){var o=n.parent;if(e.schema.getBlockElements()[o.name]&&e.settings.pagebreak_split_block){o.type=3,o.value=t,o.raw=!0,n.remove();continue}n.type=3,n.value=t,n.raw=!0}})})});!function(e,t){"use strict";function n(e,t){for(var n,i=[],r=0;r<e.length;++r){if(n=s[e[r]]||o(e[r]),!n)throw"module definition dependecy not found: "+e[r];i.push(n)}t.apply(null,i)}function i(e,i,r){if("string"!=typeof e)throw"invalid module definition, module id must be defined and be a string";if(i===t)throw"invalid module definition, dependencies must be specified";if(r===t)throw"invalid module definition, definition function must be specified";n(i,function(){s[e]=r.apply(null,arguments)})}function r(e){return!!s[e]}function o(t){for(var n=e,i=t.split(/[.\/]/),r=0;r<i.length;++r){if(!n[i[r]])return;n=n[i[r]]}return n}function a(n){for(var i=0;i<n.length;i++){for(var r=e,o=n[i],a=o.split(/[.\/]/),l=0;l<a.length-1;++l)r[a[l]]===t&&(r[a[l]]={}),r=r[a[l]];r[a[a.length-1]]=s[o]}}var s={},l="tinymce/pasteplugin/Utils",c="tinymce/util/Tools",d="tinymce/html/DomParser",u="tinymce/html/Schema",f="tinymce/pasteplugin/Clipboard",m="tinymce/Env",p="tinymce/util/VK",g="tinymce/pasteplugin/WordFilter",h="tinymce/html/Serializer",v="tinymce/html/Node",b="tinymce/pasteplugin/Quirks",y="tinymce/pasteplugin/Plugin",x="tinymce/PluginManager";i(l,[c,d,u],function(e,t,n){function i(t,n){return e.each(n,function(e){t=e.constructor==RegExp?t.replace(e,""):t.replace(e[0],e[1])}),t}function r(i){function r(e){var t=e.name,n=e;if("br"===t)return void(s+="\n");if(l[t]&&(s+=" "),c[t])return void(s+=" ");if(3==e.type&&(s+=e.value),!e.shortEnded&&(e=e.firstChild))do r(e);while(e=e.next);d[t]&&n.next&&(s+="\n","p"==t&&(s+="\n"))}var o=new n,a=new t({},o),s="",l=o.getShortEndedElements(),c=e.makeMap("script noscript style textarea video audio iframe object"," "),d=o.getBlockElements();return r(a.parse(i)),s}return{filter:i,innerText:r}}),i(f,[m,p,l],function(e,t,n){return function(i){function r(e){var t,n=i.dom;if(t=i.fire("BeforePastePreProcess",{content:e}),t=i.fire("PastePreProcess",t),e=t.content,!t.isDefaultPrevented()){if(i.hasEventListeners("PastePostProcess")&&!t.isDefaultPrevented()){var r=n.add(i.getBody(),"div",{style:"display:none"},e);t=i.fire("PastePostProcess",{node:r}),n.remove(r),e=t.node.innerHTML}t.isDefaultPrevented()||i.insertContent(e)}}function o(e){e=i.dom.encode(e).replace(/\r\n/g,"\n");var t=i.dom.getParent(i.selection.getStart(),i.dom.isBlock),o=i.settings.forced_root_block,a;o&&(a=i.dom.createHTML(o,i.settings.forced_root_block_attrs),a=a.substr(0,a.length-3)+">"),t&&/^(PRE|DIV)$/.test(t.nodeName)||!o?e=n.filter(e,[[/\n/g,"<br>"]]):(e=n.filter(e,[[/\n\n/g,"</p>"+a],[/^(.*<\/p>)(<p>)$/,a+"$1"],[/\n/g,"<br />"]]),-1!=e.indexOf("<p>")&&(e=a+e)),r(e)}function a(){var t=i.dom,n=i.getBody(),r=i.dom.getViewPort(i.getWin()),o=r.y,a=20,s;if(v=i.selection.getRng(),i.inline&&(s=i.selection.getScrollContainer(),s&&s.scrollTop>0&&(o=s.scrollTop)),v.getClientRects){var l=v.getClientRects();if(l.length)a=o+(l[0].top-t.getPos(n).y);else{a=o;var c=v.startContainer;c&&(3==c.nodeType&&c.parentNode!=n&&(c=c.parentNode),1==c.nodeType&&(a=t.getPos(c,s||n).y))}}h=t.add(i.getBody(),"div",{id:"mcepastebin",contentEditable:!0,"data-mce-bogus":"1",style:"position: absolute; top: "+a+"px;width: 10px; height: 10px; overflow: hidden; opacity: 0"},y),(e.ie||e.gecko)&&t.setStyle(h,"left","rtl"==t.getStyle(n,"direction",!0)?65535:-65535),t.bind(h,"beforedeactivate focusin focusout",function(e){e.stopPropagation()}),h.focus(),i.selection.select(h,!0)}function s(){if(h){for(var e;e=i.dom.get("mcepastebin");)i.dom.remove(e),i.dom.unbind(e);v&&i.selection.setRng(v)}x=!1,h=v=null}function l(){var e=y,t,n;for(t=i.dom.select("div[id=mcepastebin]"),n=t.length;n--;){var r=t[n].innerHTML;e==y&&(e=""),r.length>e.length&&(e=r)}return e}function c(e){var t={};if(e&&e.types){var n=e.getData("Text");n&&n.length>0&&(t["text/plain"]=n);for(var i=0;i<e.types.length;i++){var r=e.types[i];t[r]=e.getData(r)}}return t}function d(e){return c(e.clipboardData||i.getDoc().dataTransfer)}function u(e,t){function n(e){if("image/png"==o[a].type){var t=new FileReader;return t.onload=function(){r('<img src="'+t.result+'">')},t.readAsDataURL(e.getAsFile()),!0}}if(!(!i.settings.paste_data_images||"text/html"in t||"text/plain"in t)&&e.clipboardData){var o=e.clipboardData.items;if(o)for(var a=0;a<o.length;a++)if(n(o[a]))return!0}}function f(e){var t=i.getDoc(),n;if(t.caretPositionFromPoint){var r=t.caretPositionFromPoint(e.clientX,e.clientY);n=t.createRange(),n.setStart(r.offsetNode,r.offset),n.collapse(!0)}else t.caretRangeFromPoint&&(n=t.caretRangeFromPoint(e.clientX,e.clientY));return n}function m(e,t){return t in e&&e[t].length>0}function p(){i.on("keydown",function(n){if(!n.isDefaultPrevented()&&(t.metaKeyPressed(n)&&86==n.keyCode||n.shiftKey&&45==n.keyCode)){if(x=n.shiftKey&&86==n.keyCode,n.stopImmediatePropagation(),b=(new Date).getTime(),e.ie&&x)return n.preventDefault(),void i.fire("paste",{ieFake:!0});s(),a()}}),i.on("paste",function(t){var c=d(t),f=(new Date).getTime()-b<1e3,p="text"==g.pasteFormat||x;return t.isDefaultPrevented()?void s():u(t,c)?void s():(f||t.preventDefault(),!e.ie||f&&!t.ieFake||(a(),i.dom.bind(h,"paste",function(e){e.stopPropagation()}),i.getDoc().execCommand("Paste",!1,null),c["text/html"]=l()),void setTimeout(function(){var e=l();return h&&h.firstChild&&"mcepastebin"===h.firstChild.id&&(p=!0),s(),!p&&f&&e&&e!=y&&(c["text/html"]=e),e!=y&&f||(e=c["text/html"]||c["text/plain"]||y,e!=y)?(!m(c,"text/html")&&m(c,"text/plain")&&(p=!0),void(p?o(c["text/plain"]||n.innerText(e)):r(e))):void(f||i.windowManager.alert("Please use Ctrl+V/Cmd+V keyboard shortcuts to paste contents."))},0))}),i.on("dragstart",function(e){if(e.dataTransfer.types)try{e.dataTransfer.setData("mce-internal",i.selection.getContent())}catch(t){}}),i.on("drop",function(e){var t=f(e);if(t&&!e.isDefaultPrevented()){var n=c(e.dataTransfer),a=n["mce-internal"]||n["text/html"]||n["text/plain"];a&&(e.preventDefault(),i.undoManager.transact(function(){n["mce-internal"]&&i.execCommand("Delete"),i.selection.setRng(t),n["text/html"]?r(a):o(a)}))}})}var g=this,h,v,b=0,y="%MCEPASTEBIN%",x;g.pasteHtml=r,g.pasteText=o,i.on("preInit",function(){p(),i.parser.addNodeFilter("img",function(t){if(!i.settings.paste_data_images)for(var n=t.length;n--;){var r=t[n].attributes.map.src;r&&0===r.indexOf("data:image")&&(t[n].attr("data-mce-object")||r===e.transparentSrc||t[n].remove())}})}),i.on("PreProcess",function(){i.dom.remove(i.dom.get("mcepastebin"))})}}),i(g,[c,d,u,h,v,l],function(e,t,n,i,r,o){function a(e){return/<font face="Times New Roman"|class="?Mso|style="[^"]*\bmso-|style='[^'']*\bmso-|w:WordDocument/i.test(e)||/class="OutlineElement/.test(e)||/id="?docs\-internal\-guid\-/.test(e)}function s(s){var l=s.settings;s.on("BeforePastePreProcess",function(c){function d(e){function t(e,t,a,s){var l=e._listLevel||o;l!=o&&(o>l?n&&(n=n.parent.parent):(i=n,n=null)),n&&n.name==a?n.append(e):(i=i||n,n=new r(a,1),s>1&&n.attr("start",""+s),e.wrap(n)),e.name="li",t.value="";var c=t.next;c&&3==c.type&&(c.value=c.value.replace(/^\u00a0+/,"")),l>o&&i&&i.lastChild.append(n),o=l}for(var n,i,o=1,a=e.getAll("p"),s=0;s<a.length;s++)if(e=a[s],"p"==e.name&&e.firstChild){for(var l="",c=e.firstChild;c&&!(l=c.value);)c=c.firstChild;if(/^\s*[\u2022\u00b7\u00a7\u00d8\u25CF]\s*$/.test(l)){t(e,c,"ul");continue}if(/^\s*\w+\.$/.test(l)){var d=/([0-9])\./.exec(l),u=1;d&&(u=parseInt(d[1],10)),t(e,c,"ol",u);continue}n=null}}function u(t,n){var i={},o=s.dom.parseStyle(n);if("p"===t.name){var a=/mso-list:\w+ \w+([0-9]+)/.exec(n);a&&(t._listLevel=parseInt(a[1],10))}return e.each(o,function(e,n){switch(n){case"horiz-align":n="text-align";break;case"vert-align":n="vertical-align";break;case"font-color":case"mso-foreground":n="color";break;case"mso-background":case"mso-highlight":n="background";break;case"font-weight":case"font-style":return void("normal"!=e&&(i[n]=e));case"mso-element":if(/^(comment|comment-list)$/i.test(e))return void t.remove()}return 0===n.indexOf("mso-comment")?void t.remove():void(0!==n.indexOf("mso-")&&("all"==m||p&&p[n])&&(i[n]=e))}),/(bold)/i.test(i["font-weight"])&&(delete i["font-weight"],t.wrap(new r("b",1))),/(italic)/i.test(i["font-style"])&&(delete i["font-style"],t.wrap(new r("i",1))),i=s.dom.serializeStyle(i,t.name),i?i:null}var f=c.content,m,p;if(m=l.paste_retain_style_properties,m&&(p=e.makeMap(m.split(/[, ]/))),l.paste_enable_default_filters!==!1&&a(c.content)){c.wordContent=!0,f=o.filter(f,[/<!--[\s\S]+?-->/gi,/<(!|script[^>]*>.*?<\/script(?=[>\s])|\/?(\?xml(:\w+)?|img|meta|link|style|\w:\w+)(?=[\s\/>]))[^>]*>/gi,[/<(\/?)s>/gi,"<$1strike>"],[/&nbsp;/gi,"\xa0"],[/<span\s+style\s*=\s*"\s*mso-spacerun\s*:\s*yes\s*;?\s*"\s*>([\s\u00a0]*)<\/span>/gi,function(e,t){return t.length>0?t.replace(/./," ").slice(Math.floor(t.length/2)).split("").join("\xa0"):""}]]);var g=l.paste_word_valid_elements;g||(g="-strong/b,-em/i,-span,-p,-ol,-ul,-li,-h1,-h2,-h3,-h4,-h5,-h6,-p/div,-table[width],-tr,-td[colspan|rowspan|width],-th,-thead,-tfoot,-tbody,-a[href|name],sub,sup,strike,br,del");var h=new n({valid_elements:g,valid_children:"-li[p]"});e.each(h.elements,function(e){e.attributes["class"]||(e.attributes["class"]={},e.attributesOrder.push("class")),e.attributes.style||(e.attributes.style={},e.attributesOrder.push("style"))});var v=new t({},h);v.addAttributeFilter("style",function(e){for(var t=e.length,n;t--;)n=e[t],n.attr("style",u(n,n.attr("style"))),"span"==n.name&&n.parent&&!n.attributes.length&&n.unwrap()}),v.addAttributeFilter("class",function(e){for(var t=e.length,n,i;t--;)n=e[t],i=n.attr("class"),/^(MsoCommentReference|MsoCommentText|msoDel)$/i.test(i)&&n.remove(),n.attr("class",null)}),v.addNodeFilter("del",function(e){for(var t=e.length;t--;)e[t].remove()}),v.addNodeFilter("a",function(e){for(var t=e.length,n,i,r;t--;)if(n=e[t],i=n.attr("href"),r=n.attr("name"),i&&-1!=i.indexOf("#_msocom_"))n.remove();else if(i&&0===i.indexOf("file://")&&(i=i.split("#")[1],i&&(i="#"+i)),i||r){if(r&&!/^_?(?:toc|edn|ftn)/i.test(r)){n.unwrap();continue}n.attr({href:i,name:r})}else n.unwrap()});var b=v.parse(f);d(b),c.content=new i({},h).serialize(b)}})}return s.isWordContent=a,s}),i(b,[m,c,g,l],function(e,t,n,i){return function(r){function o(e){r.on("BeforePastePreProcess",function(t){t.content=e(t.content)})}function a(e){return e=i.filter(e,[/^[\s\S]*<body[^>]*>\s*<!--StartFragment-->|<!--EndFragment-->\s*<\/body[^>]*>[\s\S]*$/g,/<!--StartFragment-->|<!--EndFragment-->/g,[/<span class="Apple-converted-space">\u00a0<\/span>/g,"\xa0"],/<br>$/i])}function s(e){if(!n.isWordContent(e))return e;var o=[];t.each(r.schema.getBlockElements(),function(e,t){o.push(t)});var a=new RegExp("(?:<br>&nbsp;[\\s\\r\\n]+|<br>)*(<\\/?("+o.join("|")+")[^>]*>)(?:<br>&nbsp;[\\s\\r\\n]+|<br>)*","g");return e=i.filter(e,[[a,"$1"]]),e=i.filter(e,[[/<br><br>/g,"<BR><BR>"],[/<br>/g," "],[/<BR><BR>/g,"<br>"]])}function l(e){if(n.isWordContent(e))return e;var t=r.settings.paste_webkit_styles;if(r.settings.paste_remove_styles_if_webkit===!1||"all"==t)return e;if(t&&(t=t.split(/[, ]/)),t){var i=r.dom,o=r.selection.getNode();e=e.replace(/(<[^>]+) style="([^"]*)"([^>]*>)/gi,function(e,n,r,a){var s=i.parseStyle(r,"span"),l={};if("none"===t)return n+a;for(var c=0;c<t.length;c++){var d=s[t[c]],u=i.getStyle(o,t[c],!0);/color/.test(t[c])&&(d=i.toHex(d),u=i.toHex(u)),u!=d&&(l[t[c]]=d)}return l=i.serializeStyle(l,"span"),l?n+' style="'+l+'"'+a:""})}else e=e.replace(/(<[^>]+) style="([^"]*)"([^>]*>)/gi,"$1$3");return e=e.replace(/(<[^>]+) data-mce-style="([^"]+)"([^>]*>)/gi,function(e,t,n,i){return t+' style="'+n+'"'+i})}e.webkit&&(o(l),o(a)),e.ie&&o(s)}}),i(y,[x,f,g,b],function(e,t,n,i){var r;e.add("paste",function(e){function o(){"text"==s.pasteFormat?(this.active(!1),s.pasteFormat="html"):(s.pasteFormat="text",this.active(!0),r||(e.windowManager.alert("Paste is now in plain text mode. Contents will now be pasted as plain text until you toggle this option off."),r=!0))}var a=this,s,l=e.settings;a.clipboard=s=new t(e),a.quirks=new i(e),a.wordFilter=new n(e),e.settings.paste_as_text&&(a.clipboard.pasteFormat="text"),l.paste_preprocess&&e.on("PastePreProcess",function(e){l.paste_preprocess.call(a,a,e)}),l.paste_postprocess&&e.on("PastePostProcess",function(e){l.paste_postprocess.call(a,a,e)}),e.addCommand("mceInsertClipboardContent",function(e,t){t.content&&a.clipboard.pasteHtml(t.content),t.text&&a.clipboard.pasteText(t.text)}),e.paste_block_drop&&e.on("dragend dragover draggesture dragdrop drop drag",function(e){e.preventDefault(),e.stopPropagation()}),e.settings.paste_data_images||e.on("drop",function(e){var t=e.dataTransfer;t&&t.files&&t.files.length>0&&e.preventDefault()}),e.addButton("pastetext",{icon:"pastetext",tooltip:"Paste as text",onclick:o,active:"text"==a.clipboard.pasteFormat}),e.addMenuItem("pastetext",{text:"Paste as text",selectable:!0,active:s.pasteFormat,onclick:o})})}),a([l,f,g,b,y])}(this);tinymce.PluginManager.add("preview",function(e){var t=e.settings,i=!tinymce.Env.ie;e.addCommand("mcePreview",function(){e.windowManager.open({title:"Preview",width:parseInt(e.getParam("plugin_preview_width","650"),10),height:parseInt(e.getParam("plugin_preview_height","500"),10),html:'<iframe src="javascript:\'\'" frameborder="0"'+(i?' sandbox="allow-scripts"':"")+"></iframe>",buttons:{text:"Close",onclick:function(){this.parent().parent().close()}},onPostRender:function(){var n,a="";a+='<base href="'+e.documentBaseURI.getURI()+'">',tinymce.each(e.contentCSS,function(t){a+='<link type="text/css" rel="stylesheet" href="'+e.documentBaseURI.toAbsolute(t)+'">'});var r=t.body_id||"tinymce";-1!=r.indexOf("=")&&(r=e.getParam("body_id","","hash"),r=r[e.id]||r);var d=t.body_class||"";-1!=d.indexOf("=")&&(d=e.getParam("body_class","","hash"),d=d[e.id]||"");var o=e.settings.directionality?' dir="'+e.settings.directionality+'"':"";if(n="<!DOCTYPE html><html><head>"+a+'</head><body id="'+r+'" class="mce-content-body '+d+'"'+o+">"+e.getContent()+"</body></html>",i)this.getEl("body").firstChild.src="data:text/html;charset=utf-8,"+encodeURIComponent(n);else{var s=this.getEl("body").firstChild.contentWindow.document;s.open(),s.write(n),s.close()}}})}),e.addButton("preview",{title:"Preview",cmd:"mcePreview"}),e.addMenuItem("preview",{text:"Preview",cmd:"mcePreview",context:"view"})});tinymce.PluginManager.add("print",function(t){t.addCommand("mcePrint",function(){t.getWin().print()}),t.addButton("print",{title:"Print",cmd:"mcePrint"}),t.addShortcut("Ctrl+P","","mcePrint"),t.addMenuItem("print",{text:"Print",cmd:"mcePrint",icon:"print",shortcut:"Ctrl+P",context:"file"})});tinymce.PluginManager.add("save",function(e){function a(){var a;return a=tinymce.DOM.getParent(e.id,"form"),!e.getParam("save_enablewhendirty",!0)||e.isDirty()?(tinymce.triggerSave(),e.getParam("save_onsavecallback")?void(e.execCallback("save_onsavecallback",e)&&(e.startContent=tinymce.trim(e.getContent({format:"raw"})),e.nodeChanged())):void(a?(e.isNotDirty=!0,(!a.onsubmit||a.onsubmit())&&("function"==typeof a.submit?a.submit():e.windowManager.alert("Error: Form submit field collision.")),e.nodeChanged()):e.windowManager.alert("Error: No form element found."))):void 0}function n(){var a=tinymce.trim(e.startContent);return e.getParam("save_oncancelcallback")?void e.execCallback("save_oncancelcallback",e):(e.setContent(a),e.undoManager.clear(),void e.nodeChanged())}function t(){var a=this;e.on("nodeChange",function(){a.disabled(e.getParam("save_enablewhendirty",!0)&&!e.isDirty())})}e.addCommand("mceSave",a),e.addCommand("mceCancel",n),e.addButton("save",{icon:"save",text:"Save",cmd:"mceSave",disabled:!0,onPostRender:t}),e.addButton("cancel",{text:"Cancel",icon:!1,cmd:"mceCancel",disabled:!0,onPostRender:t}),e.addShortcut("ctrl+s","","mceSave")});!function(){function e(e,t,n,a,r){function i(e,t){if(t=t||0,!e[0])throw"findAndReplaceDOMText cannot handle zero-length matches";var n=e.index;if(t>0){var a=e[t];if(!a)throw"Invalid capture group";n+=e[0].indexOf(a),e[0]=a}return[n,n+e[0].length,[e[0]]]}function d(e){var t;if(3===e.nodeType)return e.data;if(h[e.nodeName]&&!u[e.nodeName])return"";if(t="",(u[e.nodeName]||m[e.nodeName])&&(t+="\n"),e=e.firstChild)do t+=d(e);while(e=e.nextSibling);return t}function o(e,t,n){var a,r,i,d,o=[],l=0,c=e,s=t.shift(),f=0;e:for(;;){if((u[c.nodeName]||m[c.nodeName])&&l++,3===c.nodeType&&(!r&&c.length+l>=s[1]?(r=c,d=s[1]-l):a&&o.push(c),!a&&c.length+l>s[0]&&(a=c,i=s[0]-l),l+=c.length),a&&r){if(c=n({startNode:a,startNodeIndex:i,endNode:r,endNodeIndex:d,innerNodes:o,match:s[2],matchIndex:f}),l-=r.length-d,a=null,r=null,o=[],s=t.shift(),f++,!s)break}else{if((!h[c.nodeName]||u[c.nodeName])&&c.firstChild){c=c.firstChild;continue}if(c.nextSibling){c=c.nextSibling;continue}}for(;;){if(c.nextSibling){c=c.nextSibling;break}if(c.parentNode===e)break e;c=c.parentNode}}}function l(e){var t;if("function"!=typeof e){var n=e.nodeType?e:f.createElement(e);t=function(e,t){var a=n.cloneNode(!1);return a.setAttribute("data-mce-index",t),e&&a.appendChild(f.createTextNode(e)),a}}else t=e;return function(e){var n,a,r,i=e.startNode,d=e.endNode,o=e.matchIndex;if(i===d){var l=i;r=l.parentNode,e.startNodeIndex>0&&(n=f.createTextNode(l.data.substring(0,e.startNodeIndex)),r.insertBefore(n,l));var c=t(e.match[0],o);return r.insertBefore(c,l),e.endNodeIndex<l.length&&(a=f.createTextNode(l.data.substring(e.endNodeIndex)),r.insertBefore(a,l)),l.parentNode.removeChild(l),c}n=f.createTextNode(i.data.substring(0,e.startNodeIndex)),a=f.createTextNode(d.data.substring(e.endNodeIndex));for(var s=t(i.data.substring(e.startNodeIndex),o),u=[],h=0,m=e.innerNodes.length;m>h;++h){var g=e.innerNodes[h],p=t(g.data,o);g.parentNode.replaceChild(p,g),u.push(p)}var x=t(d.data.substring(0,e.endNodeIndex),o);return r=i.parentNode,r.insertBefore(n,i),r.insertBefore(s,i),r.removeChild(i),r=d.parentNode,r.insertBefore(x,d),r.insertBefore(a,d),r.removeChild(d),x}}var c,s,f,u,h,m,g=[],p=0;if(f=t.ownerDocument,u=r.getBlockElements(),h=r.getWhiteSpaceElements(),m=r.getShortEndedElements(),s=d(t)){if(e.global)for(;c=e.exec(s);)g.push(i(c,a));else c=s.match(e),g.push(i(c,a));return g.length&&(p=g.length,o(t,g,l(n))),p}}function t(t){function n(){function e(){r.statusbar.find("#next").disabled(!d(s+1).length),r.statusbar.find("#prev").disabled(!d(s-1).length)}function n(){tinymce.ui.MessageBox.alert("Could not find the specified string.",function(){r.find("#find")[0].focus()})}var a={},r=tinymce.ui.Factory.create({type:"window",layout:"flex",pack:"center",align:"center",onClose:function(){t.focus(),c.done()},onSubmit:function(t){var i,o,l,f;return t.preventDefault(),o=r.find("#case").checked(),f=r.find("#words").checked(),l=r.find("#find").value(),l.length?a.text==l&&a.caseState==o&&a.wholeWord==f?0===d(s+1).length?void n():(c.next(),void e()):(i=c.find(l,o,f),i||n(),r.statusbar.items().slice(1).disabled(0===i),e(),void(a={text:l,caseState:o,wholeWord:f})):(c.done(!1),void r.statusbar.items().slice(1).disabled(!0))},buttons:[{text:"Find",onclick:function(){r.submit()}},{text:"Replace",disabled:!0,onclick:function(){c.replace(r.find("#replace").value())||(r.statusbar.items().slice(1).disabled(!0),s=-1,a={})}},{text:"Replace all",disabled:!0,onclick:function(){c.replace(r.find("#replace").value(),!0,!0),r.statusbar.items().slice(1).disabled(!0),a={}}},{type:"spacer",flex:1},{text:"Prev",name:"prev",disabled:!0,onclick:function(){c.prev(),e()}},{text:"Next",name:"next",disabled:!0,onclick:function(){c.next(),e()}}],title:"Find and replace",items:{type:"form",padding:20,labelGap:30,spacing:10,items:[{type:"textbox",name:"find",size:40,label:"Find",value:t.selection.getNode().src},{type:"textbox",name:"replace",size:40,label:"Replace with"},{type:"checkbox",name:"case",text:"Match case",label:" "},{type:"checkbox",name:"words",text:"Whole words",label:" "}]}}).renderTo().reflow()}function a(e){var t=e.getAttribute("data-mce-index");return"number"==typeof t?""+t:t}function r(n){var a,r;return r=t.dom.create("span",{"data-mce-bogus":1}),r.className="mce-match-marker",a=t.getBody(),c.done(!1),e(n,a,r,!1,t.schema)}function i(e){var t=e.parentNode;e.firstChild&&t.insertBefore(e.firstChild,e),e.parentNode.removeChild(e)}function d(e){var n,r=[];if(n=tinymce.toArray(t.getBody().getElementsByTagName("span")),n.length)for(var i=0;i<n.length;i++){var d=a(n[i]);null!==d&&d.length&&d===e.toString()&&r.push(n[i])}return r}function o(e){var n=s,a=t.dom;e=e!==!1,e?n++:n--,a.removeClass(d(s),"mce-match-marker-selected");var r=d(n);return r.length?(a.addClass(d(n),"mce-match-marker-selected"),t.selection.scrollIntoView(r[0]),n):-1}function l(e){e.parentNode.removeChild(e)}var c=this,s=-1;c.init=function(e){e.addMenuItem("searchreplace",{text:"Find and replace",shortcut:"Ctrl+F",onclick:n,separator:"before",context:"edit"}),e.addButton("searchreplace",{tooltip:"Find and replace",shortcut:"Ctrl+F",onclick:n}),e.addCommand("SearchReplace",n),e.shortcuts.add("Ctrl+F","",n)},c.find=function(e,t,n){e=e.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g,"\\$&"),e=n?"\\b"+e+"\\b":e;var a=r(new RegExp(e,t?"g":"gi"));return a&&(s=-1,s=o(!0)),a},c.next=function(){var e=o(!0);-1!==e&&(s=e)},c.prev=function(){var e=o(!1);-1!==e&&(s=e)},c.replace=function(e,n,r){var o,f,u,h,m,g,p=s;for(n=n!==!1,u=t.getBody(),f=tinymce.toArray(u.getElementsByTagName("span")),o=0;o<f.length;o++){var x=a(f[o]);if(null!==x&&x.length)if(h=m=parseInt(x,10),r||h===s){for(e.length?(f[o].firstChild.nodeValue=e,i(f[o])):l(f[o]);f[++o];)if(h=a(f[o]),null!==x&&x.length){if(h!==m){o--;break}l(f[o])}n&&p--}else m>s&&f[o].setAttribute("data-mce-index",m-1)}return t.undoManager.add(),s=p,n?(g=d(p+1).length>0,c.next()):(g=d(p-1).length>0,c.prev()),!r&&g},c.done=function(e){var n,r,d,o;for(r=tinymce.toArray(t.getBody().getElementsByTagName("span")),n=0;n<r.length;n++){var l=a(r[n]);null!==l&&l.length&&(l===s.toString()&&(d||(d=r[n].firstChild),o=r[n].firstChild),i(r[n]))}if(d&&o){var c=t.dom.createRng();return c.setStart(d,0),c.setEnd(o,o.data.length),e!==!1&&t.selection.setRng(c),c}}}tinymce.PluginManager.add("searchreplace",t)}();!function(e,t){"use strict";function n(e,t){for(var n,o=[],r=0;r<e.length;++r){if(n=l[e[r]]||i(e[r]),!n)throw"module definition dependecy not found: "+e[r];o.push(n)}t.apply(null,o)}function o(e,o,r){if("string"!=typeof e)throw"invalid module definition, module id must be defined and be a string";if(o===t)throw"invalid module definition, dependencies must be specified";if(r===t)throw"invalid module definition, definition function must be specified";n(o,function(){l[e]=r.apply(null,arguments)})}function r(e){return!!l[e]}function i(t){for(var n=e,o=t.split(/[.\/]/),r=0;r<o.length;++r){if(!n[o[r]])return;n=n[o[r]]}return n}function a(n){for(var o=0;o<n.length;o++){for(var r=e,i=n[o],a=i.split(/[.\/]/),s=0;s<a.length-1;++s)r[a[s]]===t&&(r[a[s]]={}),r=r[a[s]];r[a[a.length-1]]=l[i]}}var l={},s="tinymce/spellcheckerplugin/DomTextMatcher",c="tinymce/spellcheckerplugin/Plugin",d="tinymce/PluginManager",u="tinymce/util/Tools",f="tinymce/ui/Menu",m="tinymce/dom/DOMUtils",p="tinymce/util/XHR",g="tinymce/util/URI",h="tinymce/util/JSON";o(s,[],function(){return function(e,t){function n(e,t){if(!e[0])throw"findAndReplaceDOMText cannot handle zero-length matches";return{start:e.index,end:e.index+e[0].length,text:e[0],data:t}}function o(e){var t;if(3===e.nodeType)return e.data;if(P[e.nodeName]&&!S[e.nodeName])return"";if(t="",(S[e.nodeName]||N[e.nodeName])&&(t+="\n"),e=e.firstChild)do t+=o(e);while(e=e.nextSibling);return t}function r(e,t,n){var o,r,i,a,l=[],s=0,c=e,d,u=0;t=t.slice(0),t.sort(function(e,t){return e.start-t.start}),d=t.shift();e:for(;;){if((S[c.nodeName]||N[c.nodeName])&&s++,3===c.nodeType&&(!r&&c.length+s>=d.end?(r=c,a=d.end-s):o&&l.push(c),!o&&c.length+s>d.start&&(o=c,i=d.start-s),s+=c.length),o&&r){if(c=n({startNode:o,startNodeIndex:i,endNode:r,endNodeIndex:a,innerNodes:l,match:d.text,matchIndex:u}),s-=r.length-a,o=null,r=null,l=[],d=t.shift(),u++,!d)break}else{if((!P[c.nodeName]||S[c.nodeName])&&c.firstChild){c=c.firstChild;continue}if(c.nextSibling){c=c.nextSibling;continue}}for(;;){if(c.nextSibling){c=c.nextSibling;break}if(c.parentNode===e)break e;c=c.parentNode}}}function i(e){function t(t,n){var o=w[n];o.stencil||(o.stencil=e(o));var r=o.stencil.cloneNode(!1);return r.setAttribute("data-mce-index",n),t&&r.appendChild(k.doc.createTextNode(t)),r}return function(e){var n,o,r,i=e.startNode,a=e.endNode,l=e.matchIndex,s=k.doc;if(i===a){var c=i;r=c.parentNode,e.startNodeIndex>0&&(n=s.createTextNode(c.data.substring(0,e.startNodeIndex)),r.insertBefore(n,c));var d=t(e.match,l);return r.insertBefore(d,c),e.endNodeIndex<c.length&&(o=s.createTextNode(c.data.substring(e.endNodeIndex)),r.insertBefore(o,c)),c.parentNode.removeChild(c),d}n=s.createTextNode(i.data.substring(0,e.startNodeIndex)),o=s.createTextNode(a.data.substring(e.endNodeIndex));for(var u=t(i.data.substring(e.startNodeIndex),l),f=[],m=0,p=e.innerNodes.length;p>m;++m){var g=e.innerNodes[m],h=t(g.data,l);g.parentNode.replaceChild(h,g),f.push(h)}var v=t(a.data.substring(0,e.endNodeIndex),l);return r=i.parentNode,r.insertBefore(n,i),r.insertBefore(u,i),r.removeChild(i),r=a.parentNode,r.insertBefore(v,a),r.insertBefore(o,a),r.removeChild(a),v}}function a(e){var t=e.parentNode;t.insertBefore(e.firstChild,e),e.parentNode.removeChild(e)}function l(t){var n=e.getElementsByTagName("*"),o=[];t="number"==typeof t?""+t:null;for(var r=0;r<n.length;r++){var i=n[r],a=i.getAttribute("data-mce-index");null!==a&&a.length&&(a===t||null===t)&&o.push(i)}return o}function s(e){for(var t=w.length;t--;)if(w[t]===e)return t;return-1}function c(e){var t=[];return d(function(n,o){e(n,o)&&t.push(n)}),w=t,this}function d(e){for(var t=0,n=w.length;n>t&&e(w[t],t)!==!1;t++);return this}function u(t){return w.length&&r(e,w,i(t)),this}function f(e,t){if(C&&e.global)for(;x=e.exec(C);)w.push(n(x,t));return this}function m(e){var t,n=l(e?s(e):null);for(t=n.length;t--;)a(n[t]);return this}function p(e){return w[e.getAttribute("data-mce-index")]}function g(e){return l(s(e))[0]}function h(e,t,n){return w.push({start:e,end:e+t,text:C.substr(e,t),data:n}),this}function v(e){var n=l(s(e)),o=t.dom.createRng();return o.setStartBefore(n[0]),o.setEndAfter(n[n.length-1]),o}function b(e,n){var o=v(e);return o.deleteContents(),n.length>0&&o.insertNode(t.dom.doc.createTextNode(n)),o}function y(){return w.splice(0,w.length),m(),this}var x,w=[],C,k=t.dom,S,P,N;return S=t.schema.getBlockElements(),P=t.schema.getWhiteSpaceElements(),N=t.schema.getShortEndedElements(),C=o(e),{text:C,matches:w,each:d,filter:c,reset:y,matchFromElement:p,elementFromMatch:g,find:f,add:h,wrap:u,unwrap:m,replace:b,rangeFromMatch:v,indexOf:s}}}),o(c,[s,d,u,f,m,p,g,h],function(e,t,n,o,r,i,a,l){t.add("spellchecker",function(t,s){function c(){return C.textMatcher||(C.textMatcher=new e(t.getBody(),t)),C.textMatcher}function d(e,t){var o=[];return n.each(t,function(e){o.push({selectable:!0,text:e.name,data:e.value})}),o}function u(e){for(var t in e)return!1;return!0}function f(e,i){var a=[],l=k[e];n.each(l,function(e){a.push({text:e,onclick:function(){t.insertContent(t.dom.encode(e)),t.dom.remove(i),g()}})}),a.push.apply(a,[{text:"-"},{text:"Ignore",onclick:function(){h(e,i)}},{text:"Ignore all",onclick:function(){h(e,i,!0)}},{text:"Finish",onclick:v}]),P=new o({items:a,context:"contextmenu",onautohide:function(e){-1!=e.target.className.indexOf("spellchecker")&&e.preventDefault()},onhide:function(){P.remove(),P=null}}),P.renderTo(document.body);var s=r.DOM.getPos(t.getContentAreaContainer()),c=t.dom.getPos(i[0]),d=t.dom.getRoot();"BODY"==d.nodeName?(c.x-=d.ownerDocument.documentElement.scrollLeft||d.scrollLeft,c.y-=d.ownerDocument.documentElement.scrollTop||d.scrollTop):(c.x-=d.scrollLeft,c.y-=d.scrollTop),s.x+=c.x,s.y+=c.y,P.moveTo(s.x,s.y+i[0].offsetHeight)}function m(){return t.getParam("spellchecker_wordchar_pattern")||new RegExp('[^\\s!"#$%&()*+,-./:;<=>?@[\\]^_{|}`\xa7\xa9\xab\xae\xb1\xb6\xb7\xb8\xbb\xbc\xbd\xbe\xbf\xd7\xf7\xa4\u201d\u201c\u201e]+',"g")}function p(){function e(e){return t.setProgressState(!1),u(e)?(t.windowManager.alert("No misspellings found"),void(S=!1)):(k=e,c().find(m()).filter(function(t){return!!e[t.text]}).wrap(function(e){return t.dom.create("span",{"class":"mce-spellchecker-word","data-mce-bogus":1,"data-mce-word":e.text})}),void t.fire("SpellcheckStart"))}function n(e){t.windowManager.alert(e),t.setProgressState(!1),v()}function o(e,t,o){i.send({url:new a(s).toAbsolute(N.spellchecker_rpc_url),type:"post",content_type:"application/x-www-form-urlencoded",data:"text="+encodeURIComponent(t)+"&lang="+N.spellchecker_language,success:function(e){e=l.parse(e),e?e.error?n(e.error):o(e.words):n("Sever response wasn't proper JSON.")},error:function(e,t){n("Spellchecker request error: "+t.status)}})}if(S)return void v();v(),S=!0,t.setProgressState(!0);var r=N.spellchecker_callback||o;r.call(C,"spellcheck",c().text,e,n),t.focus()}function g(){t.dom.select("span.mce-spellchecker-word").length||v()}function h(e,o,r){t.selection.collapse(),r?n.each(t.dom.select("span.mce-spellchecker-word"),function(n){n.getAttribute("data-mce-word")==e&&t.dom.remove(n,!0)}):t.dom.remove(o,!0),g()}function v(){c().reset(),C.textMatcher=null,S&&(S=!1,t.fire("SpellcheckEnd"))}function b(e){var t=e.getAttribute("data-mce-index");return"number"==typeof t?""+t:t}function y(e){var o,r=[];if(o=n.toArray(t.getBody().getElementsByTagName("span")),o.length)for(var i=0;i<o.length;i++){var a=b(o[i]);null!==a&&a.length&&a===e.toString()&&r.push(o[i])}return r}function x(e){var t=N.spellchecker_language;e.control.items().each(function(e){e.active(e.settings.data===t)})}var w,C=this,k,S,P,N=t.settings,R=N.spellchecker_languages||"English=en,Danish=da,Dutch=nl,Finnish=fi,French=fr_FR,German=de,Italian=it,Polish=pl,Portuguese=pt_BR,Spanish=es,Swedish=sv";w=d("Language",n.map(R.split(","),function(e){var t=e.split("=");return{name:t[0],value:t[1]}})),t.on("click",function(e){var n=e.target;if("mce-spellchecker-word"==n.className){e.preventDefault();var o=y(b(n));if(o.length>0){var r=t.dom.createRng();r.setStartBefore(o[0]),r.setEndAfter(o[o.length-1]),t.selection.setRng(r),f(n.getAttribute("data-mce-word"),o)}}}),t.addMenuItem("spellchecker",{text:"Spellcheck",context:"tools",onclick:p,selectable:!0,onPostRender:function(){var e=this;t.on("SpellcheckStart SpellcheckEnd",function(){e.active(S)})}});var T={tooltip:"Spellcheck",onclick:p,onPostRender:function(){var e=this;t.on("SpellcheckStart SpellcheckEnd",function(){e.active(S)})}};w.length>1&&(T.type="splitbutton",T.menu=w,T.onshow=x,T.onselect=function(e){N.spellchecker_language=e.control.settings.data}),t.addButton("spellchecker",T),t.addCommand("mceSpellCheck",p),t.on("remove",function(){P&&(P.remove(),P=null)}),t.on("change",g),this.getTextMatcher=c,this.getWordCharPattern=m,this.getLanguage=function(){return N.spellchecker_language},N.spellchecker_language=N.spellchecker_language||N.language||"en"})}),a([s,c])}(this);tinymce.PluginManager.add("tabfocus",function(e){function n(e){9!==e.keyCode||e.ctrlKey||e.altKey||e.metaKey||e.preventDefault()}function t(n){function t(n){function t(e){return"BODY"===e.nodeName||"hidden"!=e.type&&"none"!=e.style.display&&"hidden"!=e.style.visibility&&t(e.parentNode)}function r(e){return e.tabIndex||"INPUT"==e.nodeName||"TEXTAREA"==e.nodeName}function c(e){return!r(e)&&"-1"!=e.getAttribute("tabindex")&&t(e)}if(u=i.select(":input:enabled,*[tabindex]:not(iframe)"),o(u,function(n,t){return n.id==e.id?(a=t,!1):void 0}),n>0){for(d=a+1;d<u.length;d++)if(c(u[d]))return u[d]}else for(d=a-1;d>=0;d--)if(c(u[d]))return u[d];return null}var a,u,c,d;if(!(9!==n.keyCode||n.ctrlKey||n.altKey||n.metaKey)&&(c=r(e.getParam("tab_focus",e.getParam("tabfocus_elements",":prev,:next"))),1==c.length&&(c[1]=c[0],c[0]=":prev"),u=n.shiftKey?":prev"==c[0]?t(-1):i.get(c[0]):":next"==c[1]?t(1):i.get(c[1]))){var y=tinymce.get(u.id||u.name);u.id&&y?y.focus():window.setTimeout(function(){tinymce.Env.webkit||window.focus(),u.focus()},10),n.preventDefault()}}var i=tinymce.DOM,o=tinymce.each,r=tinymce.explode;e.on("init",function(){e.inline&&tinymce.DOM.setAttrib(e.getBody(),"tabIndex",null)}),e.on("keyup",n),tinymce.Env.gecko?e.on("keypress keydown",t):e.on("keydown",t)});!function(e,t){"use strict";function n(e,t){for(var n,o=[],i=0;i<e.length;++i){if(n=l[e[i]]||r(e[i]),!n)throw"module definition dependecy not found: "+e[i];o.push(n)}t.apply(null,o)}function o(e,o,i){if("string"!=typeof e)throw"invalid module definition, module id must be defined and be a string";if(o===t)throw"invalid module definition, dependencies must be specified";if(i===t)throw"invalid module definition, definition function must be specified";n(o,function(){l[e]=i.apply(null,arguments)})}function i(e){return!!l[e]}function r(t){for(var n=e,o=t.split(/[.\/]/),i=0;i<o.length;++i){if(!n[o[i]])return;n=n[o[i]]}return n}function a(n){for(var o=0;o<n.length;o++){for(var i=e,r=n[o],a=r.split(/[.\/]/),s=0;s<a.length-1;++s)i[a[s]]===t&&(i[a[s]]={}),i=i[a[s]];i[a[a.length-1]]=l[r]}}var l={},s="tinymce/tableplugin/TableGrid",c="tinymce/util/Tools",d="tinymce/Env",u="tinymce/tableplugin/Quirks",f="tinymce/util/VK",m="tinymce/tableplugin/CellSelection",p="tinymce/dom/TreeWalker",g="tinymce/tableplugin/Plugin",h="tinymce/PluginManager";o(s,[c,d],function(e,n){function o(e,t){return parseInt(e.getAttribute(t)||1,10)}var i=e.each;return function(r,a){function l(){var e=0;A=[],i(["thead","tbody","tfoot"],function(t){var n=I.select("> "+t+" tr",a);i(n,function(n,r){r+=e,i(I.select("> td, > th",n),function(e,n){var i,a,l,s;if(A[r])for(;A[r][n];)n++;for(l=o(e,"rowspan"),s=o(e,"colspan"),a=r;r+l>a;a++)for(A[a]||(A[a]=[]),i=n;n+s>i;i++)A[a][i]={part:t,real:a==r&&i==n,elm:e,rowspan:l,colspan:s}})}),e+=n.length})}function s(e,t){return e=e.cloneNode(t),e.removeAttribute("id"),e}function c(e,t){var n;return n=A[t],n?n[e]:void 0}function d(e,t,n){e&&(n=parseInt(n,10),1===n?e.removeAttribute(t,1):e.setAttribute(t,n,1))}function u(e){return e&&(I.hasClass(e.elm,"mce-item-selected")||e==M)}function f(){var e=[];return i(a.rows,function(t){i(t.cells,function(n){return I.hasClass(n,"mce-item-selected")||M&&n==M.elm?(e.push(t),!1):void 0})}),e}function m(){var e=I.createRng();e.setStartAfter(a),e.setEndAfter(a),E.setRng(e),I.remove(a)}function p(t){var o,a={};return r.settings.table_clone_elements!==!1&&(a=e.makeMap((r.settings.table_clone_elements||"strong em b i span font h1 h2 h3 h4 h5 h6 p div").toUpperCase(),/[ ,]/)),e.walk(t,function(e){var r;return 3==e.nodeType?(i(I.getParents(e.parentNode,null,t).reverse(),function(e){a[e.nodeName]&&(e=s(e,!1),o?r&&r.appendChild(e):o=r=e,r=e)}),r&&(r.innerHTML=n.ie?"&nbsp;":'<br data-mce-bogus="1" />'),!1):void 0},"childNodes"),t=s(t,!1),d(t,"rowSpan",1),d(t,"colSpan",1),o?t.appendChild(o):n.ie||(t.innerHTML='<br data-mce-bogus="1" />'),t}function g(){var e=I.createRng(),t;return i(I.select("tr",a),function(e){0===e.cells.length&&I.remove(e)}),0===I.select("tr",a).length?(e.setStartBefore(a),e.setEndBefore(a),E.setRng(e),void I.remove(a)):(i(I.select("thead,tbody,tfoot",a),function(e){0===e.rows.length&&I.remove(e)}),l(),void(B&&(t=A[Math.min(A.length-1,B.y)],t&&(E.select(t[Math.min(t.length-1,B.x)].elm,!0),E.collapse(!0)))))}function h(e,t,n,o){var i,r,a,l,s;for(i=A[t][e].elm.parentNode,a=1;n>=a;a++)if(i=I.getNext(i,"tr")){for(r=e;r>=0;r--)if(s=A[t+a][r].elm,s.parentNode==i){for(l=1;o>=l;l++)I.insertAfter(p(s),s);break}if(-1==r)for(l=1;o>=l;l++)i.insertBefore(p(i.cells[0]),i.cells[0])}}function v(){i(A,function(e,t){i(e,function(e,n){var i,r,a;if(u(e)&&(e=e.elm,i=o(e,"colspan"),r=o(e,"rowspan"),i>1||r>1)){for(d(e,"rowSpan",1),d(e,"colSpan",1),a=0;i-1>a;a++)I.insertAfter(p(e),e);h(n,t,r-1,i)}})})}function b(t,n,o){var r,a,s,f,m,p,h,b,y,w,x;if(t?(r=T(t),a=r.x,s=r.y,f=a+(n-1),m=s+(o-1)):(B=D=null,i(A,function(e,t){i(e,function(e,n){u(e)&&(B||(B={x:n,y:t}),D={x:n,y:t})})}),B&&(a=B.x,s=B.y,f=D.x,m=D.y)),b=c(a,s),y=c(f,m),b&&y&&b.part==y.part){for(v(),l(),b=c(a,s).elm,d(b,"colSpan",f-a+1),d(b,"rowSpan",m-s+1),h=s;m>=h;h++)for(p=a;f>=p;p++)A[h]&&A[h][p]&&(t=A[h][p].elm,t!=b&&(w=e.grep(t.childNodes),i(w,function(e){b.appendChild(e)}),w.length&&(w=e.grep(b.childNodes),x=0,i(w,function(e){"BR"==e.nodeName&&I.getAttrib(e,"data-mce-bogus")&&x++<w.length-1&&b.removeChild(e)})),I.remove(t)));g()}}function y(e){var n,r,a,l,c,f,m,g,h;if(i(A,function(t,o){return i(t,function(t){return u(t)&&(t=t.elm,c=t.parentNode,f=s(c,!1),n=o,e)?!1:void 0}),e?!n:void 0}),n!==t){for(l=0;l<A[0].length;l++)if(A[n][l]&&(r=A[n][l].elm,r!=a)){if(e){if(n>0&&A[n-1][l]&&(g=A[n-1][l].elm,h=o(g,"rowSpan"),h>1)){d(g,"rowSpan",h+1);continue}}else if(h=o(r,"rowspan"),h>1){d(r,"rowSpan",h+1);continue}m=p(r),d(m,"colSpan",r.colSpan),f.appendChild(m),a=r}f.hasChildNodes()&&(e?c.parentNode.insertBefore(f,c):I.insertAfter(f,c))}}function w(e){var t,n;i(A,function(n){return i(n,function(n,o){return u(n)&&(t=o,e)?!1:void 0}),e?!t:void 0}),i(A,function(i,r){var a,l,s;i[t]&&(a=i[t].elm,a!=n&&(s=o(a,"colspan"),l=o(a,"rowspan"),1==s?e?(a.parentNode.insertBefore(p(a),a),h(t,r,l-1,s)):(I.insertAfter(p(a),a),h(t,r,l-1,s)):d(a,"colSpan",a.colSpan+1),n=a))})}function x(){var t=[];i(A,function(n){i(n,function(n,r){u(n)&&-1===e.inArray(t,r)&&(i(A,function(e){var t=e[r].elm,n;n=o(t,"colSpan"),n>1?d(t,"colSpan",n-1):I.remove(t)}),t.push(r))})}),g()}function C(){function e(e){var t,n,r;t=I.getNext(e,"tr"),i(e.cells,function(e){var t=o(e,"rowSpan");t>1&&(d(e,"rowSpan",t-1),n=T(e),h(n.x,n.y,1,1))}),n=T(e.cells[0]),i(A[n.y],function(e){var t;e=e.elm,e!=r&&(t=o(e,"rowSpan"),1>=t?I.remove(e):d(e,"rowSpan",t-1),r=e)})}var t;t=f(),i(t.reverse(),function(t){e(t)}),g()}function P(){var e=f();return I.remove(e),g(),e}function S(){var e=f();return i(e,function(t,n){e[n]=s(t,!0)}),e}function R(e,t){var n=f(),o=n[t?0:n.length-1],r=o.cells.length;e&&(i(A,function(e){var t;return r=0,i(e,function(e){e.real&&(r+=e.colspan),e.elm.parentNode==o&&(t=1)}),t?!1:void 0}),t||e.reverse(),i(e,function(e){var n,i=e.cells.length,a;for(n=0;i>n;n++)a=e.cells[n],d(a,"colSpan",1),d(a,"rowSpan",1);for(n=i;r>n;n++)e.appendChild(p(e.cells[i-1]));for(n=r;i>n;n++)I.remove(e.cells[n]);t?o.parentNode.insertBefore(e,o):I.insertAfter(e,o)}),I.removeClass(I.select("td.mce-item-selected,th.mce-item-selected"),"mce-item-selected"))}function T(e){var t;return i(A,function(n,o){return i(n,function(n,i){return n.elm==e?(t={x:i,y:o},!1):void 0}),!t}),t}function k(e){B=T(e)}function N(){var e,t;return e=t=0,i(A,function(n,o){i(n,function(n,i){var r,a;u(n)&&(n=A[o][i],i>e&&(e=i),o>t&&(t=o),n.real&&(r=n.colspan-1,a=n.rowspan-1,r&&i+r>e&&(e=i+r),a&&o+a>t&&(t=o+a)))})}),{x:e,y:t}}function _(e){var t,n,o,i,r,a,l,s,c,d;if(D=T(e),B&&D){for(t=Math.min(B.x,D.x),n=Math.min(B.y,D.y),o=Math.max(B.x,D.x),i=Math.max(B.y,D.y),r=o,a=i,d=n;a>=d;d++)e=A[d][t],e.real||t-(e.colspan-1)<t&&(t-=e.colspan-1);for(c=t;r>=c;c++)e=A[n][c],e.real||n-(e.rowspan-1)<n&&(n-=e.rowspan-1);for(d=n;i>=d;d++)for(c=t;o>=c;c++)e=A[d][c],e.real&&(l=e.colspan-1,s=e.rowspan-1,l&&c+l>r&&(r=c+l),s&&d+s>a&&(a=d+s));for(I.removeClass(I.select("td.mce-item-selected,th.mce-item-selected"),"mce-item-selected"),d=n;a>=d;d++)for(c=t;r>=c;c++)A[d][c]&&I.addClass(A[d][c].elm,"mce-item-selected")}}var A,B,D,M,E=r.selection,I=E.dom;a=a||I.getParent(E.getStart(),"table"),l(),M=I.getParent(E.getStart(),"th,td"),M&&(B=T(M),D=N(),M=c(B.x,B.y)),e.extend(this,{deleteTable:m,split:v,merge:b,insertRow:y,insertCol:w,deleteCols:x,deleteRows:C,cutRows:P,copyRows:S,pasteRows:R,getPos:T,setStartCell:k,setEndCell:_})}}),o(u,[f,d,c],function(e,t,n){function o(e,t){return parseInt(e.getAttribute(t)||1,10)}var i=n.each;return function(n){function r(){function t(t){function r(e,o){var i=e?"previousSibling":"nextSibling",r=n.dom.getParent(o,"tr"),l=r[i];if(l)return h(n,o,l,e),t.preventDefault(),!0;var d=n.dom.getParent(r,"table"),u=r.parentNode,f=u.nodeName.toLowerCase();if("tbody"===f||f===(e?"tfoot":"thead")){var m=a(e,d,u,"tbody");if(null!==m)return s(e,m,o)}return c(e,r,i,d)}function a(e,t,o,i){var r=n.dom.select(">"+i,t),a=r.indexOf(o);if(e&&0===a||!e&&a===r.length-1)return l(e,t);if(-1===a){var s="thead"===o.tagName.toLowerCase()?0:r.length-1;return r[s]}return r[a+(e?-1:1)]}function l(e,t){var o=e?"thead":"tfoot",i=n.dom.select(">"+o,t);return 0!==i.length?i[0]:null}function s(e,o,i){var r=d(o,e);return r&&h(n,i,r,e),t.preventDefault(),!0}function c(e,o,i,a){var l=a[i];if(l)return u(l),!0;var s=n.dom.getParent(a,"td,th");if(s)return r(e,s,t);var c=d(o,!e);return u(c),t.preventDefault(),!1}function d(e,t){var o=e&&e[t?"lastChild":"firstChild"];return o&&"BR"===o.nodeName?n.dom.getParent(o,"td,th"):o}function u(e){n.selection.setCursorLocation(e,0)}function f(){return y==e.UP||y==e.DOWN}function m(e){var t=e.selection.getNode(),n=e.dom.getParent(t,"tr");return null!==n}function p(e){for(var t=0,n=e;n.previousSibling;)n=n.previousSibling,t+=o(n,"colspan");return t}function g(e,t){var n=0,r=0;return i(e.children,function(e,i){return n+=o(e,"colspan"),r=i,n>t?!1:void 0}),r}function h(e,t,o,i){var r=p(n.dom.getParent(t,"td,th")),a=g(o,r),l=o.childNodes[a],s=d(l,i);u(s||l)}function v(e){var t=n.selection.getNode(),o=n.dom.getParent(t,"td,th"),i=n.dom.getParent(e,"td,th");return o&&o!==i&&b(o,i)}function b(e,t){return n.dom.getParent(e,"TABLE")===n.dom.getParent(t,"TABLE")}var y=t.keyCode;if(f()&&m(n)){var w=n.selection.getNode();setTimeout(function(){v(w)&&r(!t.shiftKey&&y===e.UP,w,t)},0)}}n.on("KeyDown",function(e){t(e)})}function a(){function e(e,t){var n=t.ownerDocument,o=n.createRange(),i;return o.setStartBefore(t),o.setEnd(e.endContainer,e.endOffset),i=n.createElement("body"),i.appendChild(o.cloneContents()),0===i.innerHTML.replace(/<(br|img|object|embed|input|textarea)[^>]*>/gi,"-").replace(/<[^>]+>/g,"").length}n.on("KeyDown",function(t){var o,i,r=n.dom;(37==t.keyCode||38==t.keyCode)&&(o=n.selection.getRng(),i=r.getParent(o.startContainer,"table"),i&&n.getBody().firstChild==i&&e(o,i)&&(o=r.createRng(),o.setStartBefore(i),o.setEndBefore(i),n.selection.setRng(o),t.preventDefault()))})}function l(){n.on("KeyDown SetContent VisualAid",function(){var e;for(e=n.getBody().lastChild;e;e=e.previousSibling)if(3==e.nodeType){if(e.nodeValue.length>0)break}else if(1==e.nodeType&&!e.getAttribute("data-mce-bogus"))break;e&&"TABLE"==e.nodeName&&(n.settings.forced_root_block?n.dom.add(n.getBody(),n.settings.forced_root_block,n.settings.forced_root_block_attrs,t.ie&&t.ie<11?"&nbsp;":'<br data-mce-bogus="1" />'):n.dom.add(n.getBody(),"br",{"data-mce-bogus":"1"}))}),n.on("PreProcess",function(e){var t=e.node.lastChild;t&&("BR"==t.nodeName||1==t.childNodes.length&&("BR"==t.firstChild.nodeName||"\xa0"==t.firstChild.nodeValue))&&t.previousSibling&&"TABLE"==t.previousSibling.nodeName&&n.dom.remove(t)})}function s(){function e(e,t,n,o){var i=3,r=e.dom.getParent(t.startContainer,"TABLE"),a,l,s;return r&&(a=r.parentNode),l=t.startContainer.nodeType==i&&0===t.startOffset&&0===t.endOffset&&o&&("TR"==n.nodeName||n==a),s=("TD"==n.nodeName||"TH"==n.nodeName)&&!o,l||s}function t(){var t=n.selection.getRng(),o=n.selection.getNode(),i=n.dom.getParent(t.startContainer,"TD,TH");if(e(n,t,o,i)){i||(i=o);for(var r=i.lastChild;r.lastChild;)r=r.lastChild;t.setEnd(r,r.nodeValue.length),n.selection.setRng(t)}}n.on("KeyDown",function(){t()}),n.on("MouseDown",function(e){2!=e.button&&t()})}function c(){n.on("keydown",function(t){if((t.keyCode==e.DELETE||t.keyCode==e.BACKSPACE)&&!t.isDefaultPrevented()){var o=n.dom.getParent(n.selection.getStart(),"table");if(o){for(var i=n.dom.select("td,th",o),r=i.length;r--;)if(!n.dom.hasClass(i[r],"mce-item-selected"))return;t.preventDefault(),n.execCommand("mceTableDelete")}}})}c(),t.webkit&&(r(),s()),t.gecko&&(a(),l()),t.ie>10&&(a(),l())}}),o(m,[s,p,c],function(e,t,n){return function(o){function i(){o.getBody().style.webkitUserSelect="",d&&(o.dom.removeClass(o.dom.select("td.mce-item-selected,th.mce-item-selected"),"mce-item-selected"),d=!1)}function r(t){var n,i,r=t.target;if(s&&(l||r!=s)&&("TD"==r.nodeName||"TH"==r.nodeName)){i=a.getParent(r,"table"),i==c&&(l||(l=new e(o,i),l.setStartCell(s),o.getBody().style.webkitUserSelect="none"),l.setEndCell(r),d=!0),n=o.selection.getSel();try{n.removeAllRanges?n.removeAllRanges():n.empty()}catch(u){}t.preventDefault()}}var a=o.dom,l,s,c,d=!0;return o.on("MouseDown",function(e){2!=e.button&&(i(),s=a.getParent(e.target,"td,th"),c=a.getParent(s,"table"))}),o.on("mouseover",r),o.on("remove",function(){a.unbind(o.getDoc(),"mouseover",r)}),o.on("MouseUp",function(){function e(e,o){var r=new t(e,e);do{if(3==e.nodeType&&0!==n.trim(e.nodeValue).length)return void(o?i.setStart(e,0):i.setEnd(e,e.nodeValue.length));if("BR"==e.nodeName)return void(o?i.setStartBefore(e):i.setEndBefore(e))}while(e=o?r.next():r.prev())}var i,r=o.selection,d,u,f,m,p;if(s){if(l&&(o.getBody().style.webkitUserSelect=""),d=a.select("td.mce-item-selected,th.mce-item-selected"),d.length>0){i=a.createRng(),f=d[0],p=d[d.length-1],i.setStartBefore(f),i.setEndAfter(f),e(f,1),u=new t(f,a.getParent(d[0],"table"));do if("TD"==f.nodeName||"TH"==f.nodeName){if(!a.hasClass(f,"mce-item-selected"))break;m=f}while(f=u.next());e(m),r.setRng(i)}o.nodeChanged(),s=l=c=null}}),o.on("KeyUp Drop",function(){i(),s=l=c=null}),{clear:i}}}),o(g,[s,u,m,c,p,d,h],function(e,t,n,o,i,r,a){function l(o){function i(e){return e?e.replace(/px$/,""):""}function a(e){return/^[0-9]+$/.test(e)&&(e+="px"),e}function l(e){s("left center right".split(" "),function(t){o.formatter.remove("align"+t,{},e)})}function c(e){s("top middle bottom".split(" "),function(t){o.formatter.remove("valign"+t,{},e)})}function d(){var e=o.dom,t,n,c,d;t=e.getParent(o.selection.getStart(),"table"),d={width:i(e.getStyle(t,"width")||e.getAttrib(t,"width")),height:i(e.getStyle(t,"height")||e.getAttrib(t,"height")),cellspacing:t?e.getAttrib(t,"cellspacing"):"",cellpadding:t?e.getAttrib(t,"cellpadding"):"",border:t?e.getAttrib(t,"border"):"",caption:!!e.select("caption",t)[0]},s("left center right".split(" "),function(e){o.formatter.matchNode(t,"align"+e)&&(d.align=e)}),t||(n={label:"Cols",name:"cols"},c={label:"Rows",name:"rows"}),o.windowManager.open({title:"Table properties",items:{type:"form",layout:"grid",columns:2,data:d,defaults:{type:"textbox",maxWidth:50},items:[n,c,{label:"Width",name:"width"},{label:"Height",name:"height"},{label:"Cell spacing",name:"cellspacing"},{label:"Cell padding",name:"cellpadding"},{label:"Border",name:"border"},{label:"Caption",name:"caption",type:"checkbox"},{label:"Alignment",minWidth:90,name:"align",type:"listbox",text:"None",maxWidth:null,values:[{text:"None",value:""},{text:"Left",value:"left"},{text:"Center",value:"center"},{text:"Right",value:"right"}]}]},onsubmit:function(){var n=this.toJSON(),i;o.undoManager.transact(function(){t||(t=g(n.cols||1,n.rows||1)),o.dom.setAttribs(t,{cellspacing:n.cellspacing,cellpadding:n.cellpadding,border:n.border}),o.dom.setStyles(t,{width:a(n.width),height:a(n.height)}),i=e.select("caption",t)[0],i&&!n.caption&&e.remove(i),!i&&n.caption&&(i=e.create("caption"),i.innerHTML=r.ie?"\xa0":'<br data-mce-bogus="1"/>',t.insertBefore(i,t.firstChild)),l(t),n.align&&o.formatter.apply("align"+n.align,{},t),o.focus(),o.addVisual()})}})}function u(e,t){o.windowManager.open({title:"Merge cells",body:[{label:"Cols",name:"cols",type:"textbox",size:10},{label:"Rows",name:"rows",type:"textbox",size:10}],onsubmit:function(){var n=this.toJSON();o.undoManager.transact(function(){e.merge(t,n.cols,n.rows)})}})}function f(){var e=o.dom,t,n,r=[];r=o.dom.select("td.mce-item-selected,th.mce-item-selected"),t=o.dom.getParent(o.selection.getStart(),"td,th"),!r.length&&t&&r.push(t),t=t||r[0],t&&(n={width:i(e.getStyle(t,"width")||e.getAttrib(t,"width")),height:i(e.getStyle(t,"height")||e.getAttrib(t,"height")),scope:e.getAttrib(t,"scope")},n.type=t.nodeName.toLowerCase(),s("left center right".split(" "),function(e){o.formatter.matchNode(t,"align"+e)&&(n.align=e)}),s("top middle bottom".split(" "),function(e){o.formatter.matchNode(t,"valign"+e)&&(n.valign=e)}),o.windowManager.open({title:"Cell properties",items:{type:"form",data:n,layout:"grid",columns:2,defaults:{type:"textbox",maxWidth:50},items:[{label:"Width",name:"width"},{label:"Height",name:"height"},{label:"Cell type",name:"type",type:"listbox",text:"None",minWidth:90,maxWidth:null,values:[{text:"Cell",value:"td"},{text:"Header cell",value:"th"}]},{label:"Scope",name:"scope",type:"listbox",text:"None",minWidth:90,maxWidth:null,values:[{text:"None",value:""},{text:"Row",value:"row"},{text:"Column",value:"col"},{text:"Row group",value:"rowgroup"},{text:"Column group",value:"colgroup"}]},{label:"H Align",name:"align",type:"listbox",text:"None",minWidth:90,maxWidth:null,values:[{text:"None",value:""},{text:"Left",value:"left"},{text:"Center",value:"center"},{text:"Right",value:"right"}]},{label:"V Align",name:"valign",type:"listbox",text:"None",minWidth:90,maxWidth:null,values:[{text:"None",value:""},{text:"Top",value:"top"},{text:"Middle",value:"middle"},{text:"Bottom",value:"bottom"}]}]},onsubmit:function(){var t=this.toJSON();o.undoManager.transact(function(){s(r,function(n){o.dom.setAttrib(n,"scope",t.scope),o.dom.setStyles(n,{width:a(t.width),height:a(t.height)}),t.type&&n.nodeName.toLowerCase()!=t.type&&(n=e.rename(n,t.type)),l(n),t.align&&o.formatter.apply("align"+t.align,{},n),c(n),t.valign&&o.formatter.apply("valign"+t.valign,{},n)}),o.focus()})}}))}function m(){var e=o.dom,t,n,r,c,d=[];t=o.dom.getParent(o.selection.getStart(),"table"),n=o.dom.getParent(o.selection.getStart(),"td,th"),s(t.rows,function(t){s(t.cells,function(o){return e.hasClass(o,"mce-item-selected")||o==n?(d.push(t),!1):void 0})}),r=d[0],r&&(c={height:i(e.getStyle(r,"height")||e.getAttrib(r,"height")),scope:e.getAttrib(r,"scope")},c.type=r.parentNode.nodeName.toLowerCase(),s("left center right".split(" "),function(e){o.formatter.matchNode(r,"align"+e)&&(c.align=e)}),o.windowManager.open({title:"Row properties",items:{type:"form",data:c,columns:2,defaults:{type:"textbox"},items:[{type:"listbox",name:"type",label:"Row type",text:"None",maxWidth:null,values:[{text:"Header",value:"thead"},{text:"Body",value:"tbody"},{text:"Footer",value:"tfoot"}]},{type:"listbox",name:"align",label:"Alignment",text:"None",maxWidth:null,values:[{text:"None",value:""},{text:"Left",value:"left"},{text:"Center",value:"center"},{text:"Right",value:"right"}]},{label:"Height",name:"height"}]},onsubmit:function(){var t=this.toJSON(),n,i,r;o.undoManager.transact(function(){var c=t.type;s(d,function(s){o.dom.setAttrib(s,"scope",t.scope),o.dom.setStyles(s,{height:a(t.height)}),c!=s.parentNode.nodeName.toLowerCase()&&(n=e.getParent(s,"table"),i=s.parentNode,r=e.select(c,n)[0],r||(r=e.create(c),n.firstChild?n.insertBefore(r,n.firstChild):n.appendChild(r)),r.appendChild(s),i.hasChildNodes()||e.remove(i)),l(s),t.align&&o.formatter.apply("align"+t.align,{},s)}),o.focus()})}}))}function p(e){return function(){o.execCommand(e)}}function g(e,t){var n,i,a;for(a='<table id="__mce"><tbody>',n=0;t>n;n++){for(a+="<tr>",i=0;e>i;i++)a+="<td>"+(r.ie?" ":"<br>")+"</td>";a+="</tr>"}a+="</tbody></table>",o.insertContent(a);var l=o.dom.get("__mce");return o.dom.setAttrib(l,"id",null),l}function h(e,t){function n(){e.disabled(!o.dom.getParent(o.selection.getStart(),t)),o.selection.selectorChanged(t,function(t){e.disabled(!t)})}o.initialized?n():o.on("init",n)}function v(){h(this,"table")}function b(){h(this,"td,th")}function y(){var e="";e='<table role="grid" class="mce-grid mce-grid-border" aria-readonly="true">';for(var t=0;10>t;t++){e+="<tr>";for(var n=0;10>n;n++)e+='<td role="gridcell" tabindex="-1"><a id="mcegrid'+(10*t+n)+'" href="#" data-mce-x="'+n+'" data-mce-y="'+t+'"></a></td>';e+="</tr>"}return e+="</table>",e+='<div class="mce-text-center" role="presentation">1 x 1</div>'}function w(e,t,n){var i=n.getEl().getElementsByTagName("table")[0],r,a,l,s,c,d=n.isRtl()||"tl-tr"==n.parent().rel;for(i.nextSibling.innerHTML=e+1+" x "+(t+1),d&&(e=9-e),a=0;10>a;a++)for(r=0;10>r;r++)s=i.rows[a].childNodes[r].firstChild,c=(d?r>=e:e>=r)&&t>=a,o.dom.toggleClass(s,"mce-active",c),c&&(l=s);return l.parentNode}var x,C,P=this;o.settings.table_grid===!1?o.addMenuItem("inserttable",{text:"Insert table",icon:"table",context:"table",onclick:d}):o.addMenuItem("inserttable",{text:"Insert table",icon:"table",context:"table",ariaHideMenu:!0,onclick:function(e){e.aria&&(this.parent().hideAll(),e.stopImmediatePropagation(),d())},onshow:function(){w(0,0,this.menu.items()[0])},onhide:function(){var e=this.menu.items()[0].getEl().getElementsByTagName("a");o.dom.removeClass(e,"mce-active"),o.dom.addClass(e[0],"mce-active")},menu:[{type:"container",html:y(),onPostRender:function(){this.lastX=this.lastY=0},onmousemove:function(e){var t=e.target,n,o;"A"==t.tagName.toUpperCase()&&(n=parseInt(t.getAttribute("data-mce-x"),10),o=parseInt(t.getAttribute("data-mce-y"),10),(this.isRtl()||"tl-tr"==this.parent().rel)&&(n=9-n),(n!==this.lastX||o!==this.lastY)&&(w(n,o,e.control),this.lastX=n,this.lastY=o))},onkeydown:function(e){var t=this.lastX,n=this.lastY,o;switch(e.keyCode){case 37:t>0&&(t--,o=!0);break;case 39:o=!0,9>t&&t++;break;case 38:o=!0,n>0&&n--;break;case 40:o=!0,9>n&&n++}o&&(e.preventDefault(),e.stopPropagation(),w(t,n,e.control).focus(),this.lastX=t,this.lastY=n)},onclick:function(e){"A"==e.target.tagName.toUpperCase()&&(e.preventDefault(),e.stopPropagation(),this.parent().cancel(),g(this.lastX+1,this.lastY+1))}}]}),o.addMenuItem("tableprops",{text:"Table properties",context:"table",onPostRender:v,onclick:d}),o.addMenuItem("deletetable",{text:"Delete table",context:"table",onPostRender:v,cmd:"mceTableDelete"}),o.addMenuItem("cell",{separator:"before",text:"Cell",context:"table",menu:[{text:"Cell properties",onclick:p("mceTableCellProps"),onPostRender:b},{text:"Merge cells",onclick:p("mceTableMergeCells"),onPostRender:b},{text:"Split cell",onclick:p("mceTableSplitCells"),onPostRender:b}]}),o.addMenuItem("row",{text:"Row",context:"table",menu:[{text:"Insert row before",onclick:p("mceTableInsertRowBefore"),onPostRender:b},{text:"Insert row after",onclick:p("mceTableInsertRowAfter"),onPostRender:b},{text:"Delete row",onclick:p("mceTableDeleteRow"),onPostRender:b},{text:"Row properties",onclick:p("mceTableRowProps"),onPostRender:b},{text:"-"},{text:"Cut row",onclick:p("mceTableCutRow"),onPostRender:b},{text:"Copy row",onclick:p("mceTableCopyRow"),onPostRender:b},{text:"Paste row before",onclick:p("mceTablePasteRowBefore"),onPostRender:b},{text:"Paste row after",onclick:p("mceTablePasteRowAfter"),onPostRender:b}]}),o.addMenuItem("column",{text:"Column",context:"table",menu:[{text:"Insert column before",onclick:p("mceTableInsertColBefore"),onPostRender:b},{text:"Insert column after",onclick:p("mceTableInsertColAfter"),onPostRender:b},{text:"Delete column",onclick:p("mceTableDeleteCol"),onPostRender:b}]});var S=[];s("inserttable tableprops deletetable | cell row column".split(" "),function(e){S.push("|"==e?{text:"-"}:o.menuItems[e])}),o.addButton("table",{type:"menubutton",title:"Table",menu:S}),r.isIE||o.on("click",function(e){e=e.target,"TABLE"===e.nodeName&&(o.selection.select(e),o.nodeChanged())}),P.quirks=new t(o),o.on("Init",function(){x=o.windowManager,P.cellSelection=new n(o)}),s({mceTableSplitCells:function(e){e.split()},mceTableMergeCells:function(e){var t,n,i;i=o.dom.getParent(o.selection.getStart(),"th,td"),i&&(t=i.rowSpan,n=i.colSpan),o.dom.select("td.mce-item-selected,th.mce-item-selected").length?e.merge():u(e,i)},mceTableInsertRowBefore:function(e){e.insertRow(!0)},mceTableInsertRowAfter:function(e){e.insertRow()},mceTableInsertColBefore:function(e){e.insertCol(!0)},mceTableInsertColAfter:function(e){e.insertCol()},mceTableDeleteCol:function(e){e.deleteCols()},mceTableDeleteRow:function(e){e.deleteRows()},mceTableCutRow:function(e){C=e.cutRows()},mceTableCopyRow:function(e){C=e.copyRows()},mceTablePasteRowBefore:function(e){e.pasteRows(C,!0)},mceTablePasteRowAfter:function(e){e.pasteRows(C)},mceTableDelete:function(e){e.deleteTable()}},function(t,n){o.addCommand(n,function(){var n=new e(o);n&&(t(n),o.execCommand("mceRepaint"),P.cellSelection.clear())})}),s({mceInsertTable:function(){d()},mceTableRowProps:m,mceTableCellProps:f},function(e,t){o.addCommand(t,function(t,n){e(n)})})}var s=o.each;a.add("table",l)}),a([s,u,m,g])}(this);tinymce.PluginManager.add("template",function(e){function t(t){return function(){var a=e.settings.templates;"string"==typeof a?tinymce.util.XHR.send({url:a,success:function(e){t(tinymce.util.JSON.parse(e))}}):t(a)}}function a(t){function a(t){function a(t){if(-1==t.indexOf("<html>")){var a="";tinymce.each(e.contentCSS,function(t){a+='<link type="text/css" rel="stylesheet" href="'+e.documentBaseURI.toAbsolute(t)+'">'}),t="<!DOCTYPE html><html><head>"+a+"</head><body>"+t+"</body></html>"}t=r(t,"template_preview_replace_values");var l=n.find("iframe")[0].getEl().contentWindow.document;l.open(),l.write(t),l.close()}var c=t.control.value();c.url?tinymce.util.XHR.send({url:c.url,success:function(e){l=e,a(l)}}):(l=c.content,a(l)),n.find("#description")[0].text(t.control.value().description)}var n,l,i=[];return t&&0!==t.length?(tinymce.each(t,function(e){i.push({selected:!i.length,text:e.title,value:{url:e.url,content:e.content,description:e.description}})}),n=e.windowManager.open({title:"Insert template",layout:"flex",direction:"column",align:"stretch",padding:15,spacing:10,items:[{type:"form",flex:0,padding:0,items:[{type:"container",label:"Templates",items:{type:"listbox",label:"Templates",name:"template",values:i,onselect:a}}]},{type:"label",name:"description",label:"Description",text:" "},{type:"iframe",flex:1,border:1}],onsubmit:function(){c(!1,l)},width:e.getParam("template_popup_width",600),height:e.getParam("template_popup_height",500)}),void n.find("listbox")[0].fire("select")):void e.windowManager.alert("No templates defined")}function n(t,a){function n(e,t){if(e=""+e,e.length<t)for(var a=0;a<t-e.length;a++)e="0"+e;return e}var l="Sun Mon Tue Wed Thu Fri Sat Sun".split(" "),r="Sunday Monday Tuesday Wednesday Thursday Friday Saturday Sunday".split(" "),c="Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec".split(" "),i="January February March April May June July August September October November December".split(" ");return a=a||new Date,t=t.replace("%D","%m/%d/%Y"),t=t.replace("%r","%I:%M:%S %p"),t=t.replace("%Y",""+a.getFullYear()),t=t.replace("%y",""+a.getYear()),t=t.replace("%m",n(a.getMonth()+1,2)),t=t.replace("%d",n(a.getDate(),2)),t=t.replace("%H",""+n(a.getHours(),2)),t=t.replace("%M",""+n(a.getMinutes(),2)),t=t.replace("%S",""+n(a.getSeconds(),2)),t=t.replace("%I",""+((a.getHours()+11)%12+1)),t=t.replace("%p",""+(a.getHours()<12?"AM":"PM")),t=t.replace("%B",""+e.translate(i[a.getMonth()])),t=t.replace("%b",""+e.translate(c[a.getMonth()])),t=t.replace("%A",""+e.translate(r[a.getDay()])),t=t.replace("%a",""+e.translate(l[a.getDay()])),t=t.replace("%%","%")}function l(t){var a=e.dom,n=e.getParam("template_replace_values");i(a.select("*",t),function(e){i(n,function(t,l){a.hasClass(e,l)&&"function"==typeof n[l]&&n[l](e)})})}function r(t,a){return i(e.getParam(a),function(e,a){"function"!=typeof e&&(t=t.replace(new RegExp("\\{\\$"+a+"\\}","g"),e))}),t}function c(t,a){function c(e,t){return new RegExp("\\b"+t+"\\b","g").test(e.className)}var o,s,p=e.dom,m=e.selection.getContent();a=r(a,"template_replace_values"),o=p.create("div",null,a),s=p.select(".mceTmpl",o),s&&s.length>0&&(o=p.create("div",null),o.appendChild(s[0].cloneNode(!0))),i(p.select("*",o),function(t){c(t,e.getParam("template_cdate_classes","cdate").replace(/\s+/g,"|"))&&(t.innerHTML=n(e.getParam("template_cdate_format",e.getLang("template.cdate_format")))),c(t,e.getParam("template_mdate_classes","mdate").replace(/\s+/g,"|"))&&(t.innerHTML=n(e.getParam("template_mdate_format",e.getLang("template.mdate_format")))),c(t,e.getParam("template_selected_content_classes","selcontent").replace(/\s+/g,"|"))&&(t.innerHTML=m)}),l(o),e.execCommand("mceInsertContent",!1,o.innerHTML),e.addVisual()}var i=tinymce.each;e.addCommand("mceInsertTemplate",c),e.addButton("template",{title:"Insert template",onclick:t(a)}),e.addMenuItem("template",{text:"Insert template",onclick:t(a),context:"insert"}),e.on("PreProcess",function(t){var a=e.dom;i(a.select("div",t.node),function(t){a.hasClass(t,"mceTmpl")&&(i(a.select("*",t),function(t){a.hasClass(t,e.getParam("template_mdate_classes","mdate").replace(/\s+/g,"|"))&&(t.innerHTML=n(e.getParam("template_mdate_format",e.getLang("template.mdate_format"))))}),l(t))})})});tinymce.PluginManager.add("textcolor",function(e){function t(){var t,o,l=[];for(o=e.settings.textcolor_map||["000000","Black","993300","Burnt orange","333300","Dark olive","003300","Dark green","003366","Dark azure","000080","Navy Blue","333399","Indigo","333333","Very dark gray","800000","Maroon","FF6600","Orange","808000","Olive","008000","Green","008080","Teal","0000FF","Blue","666699","Grayish blue","808080","Gray","FF0000","Red","FF9900","Amber","99CC00","Yellow green","339966","Sea green","33CCCC","Turquoise","3366FF","Royal blue","800080","Purple","999999","Medium gray","FF00FF","Magenta","FFCC00","Gold","FFFF00","Yellow","00FF00","Lime","00FFFF","Aqua","00CCFF","Sky blue","993366","Red violet","C0C0C0","Silver","FF99CC","Pink","FFCC99","Peach","FFFF99","Light yellow","CCFFCC","Pale green","CCFFFF","Pale cyan","99CCFF","Light sky blue","CC99FF","Plum","FFFFFF","White"],t=0;t<o.length;t+=2)l.push({text:o[t+1],color:o[t]});return l}function o(){var o,l,r,a,c,i,n,F,d,s=this;for(o=t(),r='<table class="mce-grid mce-grid-border mce-colorbutton-grid" role="list" cellspacing="0"><tbody>',a=o.length-1,c=e.settings.textcolor_rows||5,i=e.settings.textcolor_cols||8,F=0;c>F;F++){for(r+="<tr>",n=0;i>n;n++)d=F*i+n,d>a?r+="<td></td>":(l=o[d],r+='<td><div id="'+s._id+"-"+d+'" data-mce-color="'+l.color+'" role="option" tabIndex="-1" style="'+(l?"background-color: #"+l.color:"")+'" title="'+l.text+'"></div></td>');r+="</tr>"}return r+="</tbody></table>"}function l(t){var o,l=this.parent();(o=t.target.getAttribute("data-mce-color"))&&(this.lastId&&document.getElementById(this.lastId).setAttribute("aria-selected",!1),t.target.setAttribute("aria-selected",!0),this.lastId=t.target.id,l.hidePanel(),o="#"+o,l.color(o),e.execCommand(l.settings.selectcmd,!1,o))}function r(){var t=this;t._color&&e.execCommand(t.settings.selectcmd,!1,t._color)}e.addButton("forecolor",{type:"colorbutton",tooltip:"Text color",selectcmd:"ForeColor",panel:{role:"application",ariaRemember:!0,html:o,onclick:l},onclick:r}),e.addButton("backcolor",{type:"colorbutton",tooltip:"Background color",selectcmd:"HiliteColor",panel:{role:"application",ariaRemember:!0,html:o,onclick:l},onclick:r})});tinymce.PluginManager.add("visualblocks",function(e,s){function o(){var s=this;s.active(a),e.on("VisualBlocks",function(){s.active(e.dom.hasClass(e.getBody(),"mce-visualblocks"))})}var l,t,a;window.NodeList&&(e.addCommand("mceVisualBlocks",function(){var o,c=e.dom;l||(l=c.uniqueId(),o=c.create("link",{id:l,rel:"stylesheet",href:s+"/css/visualblocks.css"}),e.getDoc().getElementsByTagName("head")[0].appendChild(o)),e.on("PreviewFormats AfterPreviewFormats",function(s){a&&c.toggleClass(e.getBody(),"mce-visualblocks","afterpreviewformats"==s.type)}),c.toggleClass(e.getBody(),"mce-visualblocks"),a=e.dom.hasClass(e.getBody(),"mce-visualblocks"),t&&t.active(c.hasClass(e.getBody(),"mce-visualblocks")),e.fire("VisualBlocks")}),e.addButton("visualblocks",{title:"Show blocks",cmd:"mceVisualBlocks",onPostRender:o}),e.addMenuItem("visualblocks",{text:"Show blocks",cmd:"mceVisualBlocks",onPostRender:o,selectable:!0,context:"view",prependToContext:!0}),e.on("init",function(){e.settings.visualblocks_default_state&&e.execCommand("mceVisualBlocks",!1,null,{skip_focus:!0})}),e.on("remove",function(){e.dom.removeClass(e.getBody(),"mce-visualblocks")}))});tinymce.PluginManager.add("visualchars",function(e){function a(a){var t,s,i,r,c,d,l=e.getBody(),m=e.selection;if(n=!n,o.state=n,e.fire("VisualChars",{state:n}),a&&(d=m.getBookmark()),n)for(s=[],tinymce.walk(l,function(e){3==e.nodeType&&e.nodeValue&&-1!=e.nodeValue.indexOf(" ")&&s.push(e)},"childNodes"),i=0;i<s.length;i++){for(r=s[i].nodeValue,r=r.replace(/(\u00a0)/g,'<span data-mce-bogus="1" class="mce-nbsp">$1</span>'),c=e.dom.create("div",null,r);t=c.lastChild;)e.dom.insertAfter(t,s[i]);e.dom.remove(s[i])}else for(s=e.dom.select("span.mce-nbsp",l),i=s.length-1;i>=0;i--)e.dom.remove(s[i],1);m.moveToBookmark(d)}function t(){var a=this;e.on("VisualChars",function(e){a.active(e.state)})}var n,o=this;e.addCommand("mceVisualChars",a),e.addButton("visualchars",{title:"Show invisible characters",cmd:"mceVisualChars",onPostRender:t}),e.addMenuItem("visualchars",{text:"Show invisible characters",cmd:"mceVisualChars",onPostRender:t,selectable:!0,context:"view",prependToContext:!0}),e.on("beforegetcontent",function(e){n&&"raw"!=e.format&&!e.draft&&(n=!0,a(!1))})});tinymce.PluginManager.add("wordcount",function(e){function t(){e.theme.panel.find("#wordcount").text(["Words: {0}",a.getCount()])}var n,o,a=this;n=e.getParam("wordcount_countregex",/[\w\u2019\x27\-\u00C0-\u1FFF]+/g),o=e.getParam("wordcount_cleanregex",/[0-9.(),;:!?%#$?\x27\x22_+=\\\/\-]*/g),e.on("init",function(){var n=e.theme.panel&&e.theme.panel.find("#statusbar")[0];n&&window.setTimeout(function(){n.insert({type:"label",name:"wordcount",text:["Words: {0}",a.getCount()],classes:"wordcount",disabled:e.settings.readonly},0),e.on("setcontent beforeaddundo",t),e.on("keyup",function(e){32==e.keyCode&&t()})},0)}),a.getCount=function(){var t=e.getContent({format:"raw"}),a=0;if(t){t=t.replace(/\.\.\./g," "),t=t.replace(/<.[^<>]*?>/g," ").replace(/&nbsp;|&#160;/gi," "),t=t.replace(/(\w+)(&#?[a-z0-9]+;)+(\w+)/i,"$1$3").replace(/&.+?;/g," "),t=t.replace(o,"");var r=t.match(n);r&&(a=r.length)}return a}});tinymce.ThemeManager.add("modern",function(e){function t(){function t(t){var n,o=[];if(t)return d(t.split(/[ ,]/),function(t){function i(){var i=e.selection;"bullist"==r&&i.selectorChanged("ul > li",function(e,i){for(var n,o=i.parents.length;o--&&(n=i.parents[o].nodeName,"OL"!=n&&"UL"!=n););t.active(e&&"UL"==n)}),"numlist"==r&&i.selectorChanged("ol > li",function(e,i){for(var n,o=i.parents.length;o--&&(n=i.parents[o].nodeName,"OL"!=n&&"UL"!=n););t.active(e&&"OL"==n)}),t.settings.stateSelector&&i.selectorChanged(t.settings.stateSelector,function(e){t.active(e)},!0),t.settings.disabledStateSelector&&i.selectorChanged(t.settings.disabledStateSelector,function(e){t.disabled(e)})}var r;"|"==t?n=null:c.has(t)?(t={type:t},u.toolbar_items_size&&(t.size=u.toolbar_items_size),o.push(t),n=null):(n||(n={type:"buttongroup",items:[]},o.push(n)),e.buttons[t]&&(r=t,t=e.buttons[r],"function"==typeof t&&(t=t()),t.type=t.type||"button",u.toolbar_items_size&&(t.size=u.toolbar_items_size),t=c.create(t),n.items.push(t),e.initialized?i():e.on("init",i)))}),i.push({type:"toolbar",layout:"flow",items:o}),!0}var i=[];if(tinymce.isArray(u.toolbar)){if(0===u.toolbar.length)return;tinymce.each(u.toolbar,function(e,t){u["toolbar"+(t+1)]=e}),delete u.toolbar}for(var n=1;10>n&&t(u["toolbar"+n]);n++);return i.length||u.toolbar===!1||t(u.toolbar||f),i.length?{type:"panel",layout:"stack",classes:"toolbar-grp",ariaRoot:!0,ariaRemember:!0,items:i}:void 0}function i(){function t(t){var i;return"|"==t?{text:"|"}:i=e.menuItems[t]}function i(i){var n,o,r,a,s;if(s=tinymce.makeMap((u.removed_menuitems||"").split(/[ ,]/)),u.menu?(o=u.menu[i],a=!0):o=h[i],o){n={text:o.title},r=[],d((o.items||"").split(/[ ,]/),function(e){var i=t(e);i&&!s[e]&&r.push(t(e))}),a||d(e.menuItems,function(e){e.context==i&&("before"==e.separator&&r.push({text:"|"}),e.prependToContext?r.unshift(e):r.push(e),"after"==e.separator&&r.push({text:"|"}))});for(var l=0;l<r.length;l++)"|"==r[l].text&&(0===l||l==r.length-1)&&r.splice(l,1);if(n.menu=r,!n.menu.length)return null}return n}var n,o=[],r=[];if(u.menu)for(n in u.menu)r.push(n);else for(n in h)r.push(n);for(var a="string"==typeof u.menubar?u.menubar.split(/[ ,]/):r,s=0;s<a.length;s++){var l=a[s];l=i(l),l&&o.push(l)}return o}function n(t){function i(e){var i=t.find(e)[0];i&&i.focus(!0)}e.shortcuts.add("Alt+F9","",function(){i("menubar")}),e.shortcuts.add("Alt+F10","",function(){i("toolbar")}),e.shortcuts.add("Alt+F11","",function(){i("elementpath")}),t.on("cancel",function(){e.focus()})}function o(t,i){function n(e){return{width:e.clientWidth,height:e.clientHeight}}var o,r,a,s;o=e.getContainer(),r=e.getContentAreaContainer().firstChild,a=n(o),s=n(r),null!==t&&(t=Math.max(u.min_width||100,t),t=Math.min(u.max_width||65535,t),m.css(o,"width",t+(a.width-s.width)),m.css(r,"width",t)),i=Math.max(u.min_height||100,i),i=Math.min(u.max_height||65535,i),m.css(r,"height",i),e.fire("ResizeEditor")}function r(t,i){var n=e.getContentAreaContainer();l.resizeTo(n.clientWidth+t,n.clientHeight+i)}function a(o){function r(){if(h&&h.moveRel&&h.visible()&&!h._fixed){var t=e.selection.getScrollContainer(),i=e.getBody(),n=0,o=0;if(t){var r=m.getPos(i),a=m.getPos(t);n=Math.max(0,a.x-r.x),o=Math.max(0,a.y-r.y)}h.fixed(!1).moveRel(i,e.rtl?["tr-br","br-tr"]:["tl-bl","bl-tl"]).moveBy(n,o)}}function a(){h&&(h.show(),r(),m.addClass(e.getBody(),"mce-edit-focus"))}function s(){h&&(h.hide(),m.removeClass(e.getBody(),"mce-edit-focus"))}function d(){return h?void(h.visible()||a()):(h=l.panel=c.create({type:f?"panel":"floatpanel",role:"application",classes:"tinymce tinymce-inline",layout:"flex",direction:"column",align:"stretch",autohide:!1,autofix:!0,fixed:!!f,border:1,items:[u.menubar===!1?null:{type:"menubar",border:"0 0 1 0",items:i()},t()]}),e.fire("BeforeRenderUI"),h.renderTo(f||document.body).reflow(),n(h),a(),e.on("nodeChange",r),e.on("activate",a),e.on("deactivate",s),void e.nodeChanged())}var h,f;return u.fixed_toolbar_container&&(f=m.select(u.fixed_toolbar_container)[0]),u.content_editable=!0,e.on("focus",function(){o.skinUiCss?tinymce.DOM.styleSheetLoader.load(o.skinUiCss,d,d):d()}),e.on("blur hide",s),e.on("remove",function(){h&&(h.remove(),h=null)}),o.skinUiCss&&tinymce.DOM.styleSheetLoader.load(o.skinUiCss),{}}function s(r){var a,s,d;return r.skinUiCss&&tinymce.DOM.loadCSS(r.skinUiCss),a=l.panel=c.create({type:"panel",role:"application",classes:"tinymce",style:"visibility: hidden",layout:"stack",border:1,items:[u.menubar===!1?null:{type:"menubar",border:"0 0 1 0",items:i()},t(),{type:"panel",name:"iframe",layout:"stack",classes:"edit-area",html:"",border:"1 0 0 0"}]}),u.resize!==!1&&(s={type:"resizehandle",direction:u.resize,onResizeStart:function(){var t=e.getContentAreaContainer().firstChild;d={width:t.clientWidth,height:t.clientHeight}},onResize:function(e){"both"==u.resize?o(d.width+e.deltaX,d.height+e.deltaY):o(null,d.height+e.deltaY)}}),u.statusbar!==!1&&a.add({type:"panel",name:"statusbar",classes:"statusbar",layout:"flow",border:"1 0 0 0",ariaRoot:!0,items:[{type:"elementpath"},s]}),u.readonly&&a.find("*").disabled(!0),e.fire("BeforeRenderUI"),a.renderBefore(r.targetNode).reflow(),u.width&&tinymce.DOM.setStyle(a.getEl(),"width",u.width),e.on("remove",function(){a.remove(),a=null}),n(a),{iframeContainer:a.find("#iframe")[0].getEl(),editorContainer:a.getEl()}}var l=this,u=e.settings,c=tinymce.ui.Factory,d=tinymce.each,m=tinymce.DOM,h={file:{title:"File",items:"newdocument"},edit:{title:"Edit",items:"undo redo | cut copy paste pastetext | selectall"},insert:{title:"Insert",items:"|"},view:{title:"View",items:"visualaid |"},format:{title:"Format",items:"bold italic underline strikethrough superscript subscript | formats | removeformat"},table:{title:"Table"},tools:{title:"Tools"}},f="undo redo | styleselect | bold italic | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link image";l.renderUI=function(t){var i=u.skin!==!1?u.skin||"lightgray":!1;if(i){var n=u.skin_url;n=n?e.documentBaseURI.toAbsolute(n):tinymce.baseURL+"/skins/"+i,t.skinUiCss=tinymce.Env.documentMode<=7?n+"/skin.ie7.min.css":n+"/skin.min.css",e.contentCSS.push(n+"/content"+(e.inline?".inline":"")+".min.css")}return e.on("ProgressState",function(e){l.throbber=l.throbber||new tinymce.ui.Throbber(l.panel.getEl("body")),e.state?l.throbber.show(e.time):l.throbber.hide()}),u.inline?a(t):s(t)},l.resizeTo=o,l.resizeBy=r});
\ No newline at end of file
diff --git a/lib/test/data/readOnlyPage.html b/lib/test/data/readOnlyPage.html
index b3f0012..fe3be2b 100644
--- a/lib/test/data/readOnlyPage.html
+++ b/lib/test/data/readOnlyPage.html
@@ -17,6 +17,8 @@
 text area which is not supposed to be cleared</textarea>
 
 <div id="content-editable" contentEditable="true">This is a contentEditable area</div>
+
+<div id="content-editable-blank" contentEditable="true" style="height:50px;"></div>
 </body>
 </html>
 
diff --git a/lib/test/data/rich_text.html b/lib/test/data/rich_text.html
index 8c9a073..a42e43a 100644
--- a/lib/test/data/rich_text.html
+++ b/lib/test/data/rich_text.html
@@ -23,7 +23,8 @@
 
 window.onload = function () {
   // Super dumb browser detection
-  var isIE = window.navigator.userAgent.search('MSIE') != -1;
+  var isIE = window.navigator.userAgent.search('MSIE') != -1
+    || window.navigator.userAgent.search('Trident') != -1;
 
   var editFrame = document.getElementById('editFrame').contentWindow;
   setKeypressHandler(editFrame.document, printEventData);
diff --git a/lib/test/data/screen/screen_frame1.html b/lib/test/data/screen/screen_frame1.html
index d50c21d..35b03ae 100644
--- a/lib/test/data/screen/screen_frame1.html
+++ b/lib/test/data/screen/screen_frame1.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <html><head>
-<title>screen test</title>
+<title>screen frame1</title>
 <script type="text/javascript" src="screen.js"></script>
 <link rel="stylesheet" type="text/css" href="screen.css" />
 </head>
diff --git a/lib/test/data/screen/screen_frame2.html b/lib/test/data/screen/screen_frame2.html
index b66cd70..e6e17e6 100644
--- a/lib/test/data/screen/screen_frame2.html
+++ b/lib/test/data/screen/screen_frame2.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <html><head>
-<title>screen test</title>
+<title>screen frame2</title>
 <script type="text/javascript" src="screen.js"></script>
 <link rel="stylesheet" type="text/css" href="screen.css" />
 </head>
diff --git a/lib/test/data/slowLoadingResourcePage.html b/lib/test/data/slowLoadingResourcePage.html
index e05f954..02796c3 100644
--- a/lib/test/data/slowLoadingResourcePage.html
+++ b/lib/test/data/slowLoadingResourcePage.html
@@ -7,6 +7,6 @@
   too long to respond. Normally these things are loaded in an iframe, which is
       what we're doing here.</p>
 
-  <img src="sleep?time=6"></img>
+  <img src="sleep?time=7"></img>
 </body>
-</html>
\ No newline at end of file
+</html>
diff --git a/lib/test/data/tinymce.html b/lib/test/data/tinymce.html
new file mode 100644
index 0000000..067b66c
--- /dev/null
+++ b/lib/test/data/tinymce.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TinyMCE</title>
+  <script src="js/tinymce.min.js"></script>
+</head>
+<body onload="tinymce.init({selector:'textarea'})">
+<textarea>Initial content</textarea>
+</body>
+</html>
\ No newline at end of file
diff --git a/lib/test/data/transparentUpload.html b/lib/test/data/transparentUpload.html
new file mode 100644
index 0000000..87b02bf
--- /dev/null
+++ b/lib/test/data/transparentUpload.html
@@ -0,0 +1,70 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Upload Form</title>
+  <style>
+    .fileUpload {
+      position: relative;
+      overflow: hidden;
+      margin: 10px;
+	  background-color: #FFFFFF;
+      width: 50px;
+      text-align: center;
+    }
+    .fileUpload input.upload {
+      position: absolute;
+      top: 0;
+      right: 0;
+      margin: 0;
+      padding: 0;
+      font-size: 20px;
+      cursor: pointer;
+      opacity: 0;
+      filter: alpha(opacity=0);
+      height: 100%;
+      text-align: center;
+    }
+  </style>
+  <script>
+      var intervalId;
+      function onTick() {
+          var label = document.getElementById('upload_label');
+          label.innerHTML += '.';
+      }
+
+      function onUploadSubmit() {
+          document.getElementById('upload_target').contentWindow.document.body.
+          innerHTML = '';
+          var label = document.getElementById('upload_label');
+          label.innerHTML = 'Uploading "' + document.forms[0].upload.value + '"';
+          label.style.display = '';
+          intervalId = window.setInterval(onTick, 500);
+          return true;
+      }
+
+      function onUploadDone() {
+          var label = document.getElementById('upload_label');
+          label.style.display = 'none';
+          window.clearInterval(intervalId);
+          return true;
+      }
+  </script>
+</head>
+<body>
+<form action="/common/upload" method="post" name="upload_form"
+      target="upload_target" enctype="multipart/form-data"
+      onsubmit="onUploadSubmit();">
+  <div>
+    <div class="fileUpload">
+      <span>Upload</span>
+      <input id="upload" name="upload" type="file" class="upload" />
+    </div>
+    <div><input id="go" type="submit" value="Go!"/></div>
+  </div>
+  <div id="upload_label" style="display:none"></div>
+  <iframe src="" id="upload_target" name="upload_target"
+          style="width:300px;height:200px">
+  </iframe>
+</form>
+</body>
+</html>
diff --git a/lib/test/fileserver.js b/lib/test/fileserver.js
index a4165df..6a86947 100644
--- a/lib/test/fileserver.js
+++ b/lib/test/fileserver.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -20,18 +22,21 @@ var fs = require('fs'),
     path = require('path'),
     url = require('url');
 
+var express = require('express');
+var multer = require('multer');
+var serveIndex = require('serve-index');
+
 var Server = require('./httpserver').Server,
     resources = require('./resources'),
     promise = require('../..').promise,
     isDevMode = require('../../_base').isDevMode(),
     string = require('../../_base').require('goog.string');
 
-var WEB_ROOT = isDevMode ? '/common/src/web' : '/common';
+var WEB_ROOT = '/common';
 var JS_ROOT = '/javascript';
 
-var baseDirectory = resources.locate('.'),
-    server = new Server(onRequest);
-
+var baseDirectory = resources.locate(isDevMode ? 'common/src/web' : '.');
+var jsDirectory = resources.locate(isDevMode ? 'javascript' : '..');
 
 var Pages = (function() {
   var pages = {};
@@ -58,6 +63,7 @@ var Pages = (function() {
   addPage('documentWrite', 'document_write_in_onload.html');
   addPage('dynamicallyModifiedPage', 'dynamicallyModifiedPage.html');
   addPage('dynamicPage', 'dynamic.html');
+  addPage('echoPage', 'echo');
   addPage('errorsPage', 'errors.html');
   addPage('xhtmlFormPage', 'xhtmlFormPage.xhtml');
   addPage('formPage', 'formPage.html');
@@ -102,93 +108,41 @@ var Pages = (function() {
 
 
 var Path = {
-  BASIC_AUTH: path.join(WEB_ROOT, 'basicAuth'),
-  MANIFEST: path.join(WEB_ROOT, 'manifest'),
-  REDIRECT: path.join(WEB_ROOT, 'redirect'),
-  PAGE: path.join(WEB_ROOT, 'page'),
-  SLEEP: path.join(WEB_ROOT, 'sleep'),
-  UPLOAD: path.join(WEB_ROOT, 'upload')
+  BASIC_AUTH: WEB_ROOT + '/basicAuth',
+  ECHO: WEB_ROOT + '/echo',
+  GENERATED: WEB_ROOT + '/generated',
+  MANIFEST: WEB_ROOT + '/manifest',
+  REDIRECT: WEB_ROOT + '/redirect',
+  PAGE: WEB_ROOT + '/page',
+  SLEEP: WEB_ROOT + '/sleep',
+  UPLOAD: WEB_ROOT + '/upload'
 };
 
-
-/**
- * HTTP request handler.
- * @param {!http.ServerRequest} request The request object.
- * @param {!http.ServerResponse} response The response object.
- */
-function onRequest(request, response) {
-  if (request.method !== 'GET' && request.method !== 'HEAD') {
-    response.writeHead(405, {'Allowed': 'GET,HEAD'});
-    return response.end();
-  }
-
-  var pathname = path.resolve(url.parse(request.url).pathname);
-  if (pathname === '/') {
-    return sendIndex(request, response);
-  }
-
-  if (pathname === '/favicon.ico') {
-    response.writeHead(204);
-    return response.end();
-  }
-
-  switch (pathname) {
-    case Path.BASIC_AUTH: return sendBasicAuth(response);
-    case Path.MANIFEST: return sendManifest(response);
-    case Path.PAGE: return sendInifinitePage(request, response);
-    case Path.REDIRECT: return redirectToResultPage(response);
-    case Path.SLEEP: return sendDelayedResponse(request, response);
-    case Path.UPLOAD: return sendUpload(response);
-  }
-
-  if (string.startsWith(pathname, Path.PAGE + '/')) {
-    return sendInifinitePage(request, response);
-  }
-
-  if ((string.startsWith(pathname, WEB_ROOT) ||
-       string.startsWith(pathname, JS_ROOT)) &&
-      string.endsWith(pathname, '.appcache')) {
-    return sendManifest(response);
-  }
-
-  if (string.startsWith(pathname, WEB_ROOT)) {
-    if (!isDevMode) {
-      pathname = pathname.substring(WEB_ROOT.length);
-    }
-  } else if (string.startsWith(pathname, JS_ROOT)) {
-    if (!isDevMode) {
-      sendSimpleError(response, 404, request.url);
-      return;
-    }
-    pathname = pathname.substring(JS_ROOT);
-  }
-
-  try {
-    var fullPath = resources.locate(pathname);
-  } catch (ex) {
-    fullPath = '';
-  }
-
-  if (fullPath.lastIndexOf(baseDirectory, 0) == -1) {
-    sendSimpleError(response, 404, request.url);
-    return;
-  }
-
-  fs.stat(fullPath, function(err, stats) {
-    if (err) {
-      sendIOError(request, response, err);
-    } else if (stats.isDirectory()) {
-      sendDirectoryListing(request, response, fullPath);
-    } else if (stats.isFile()) {
-      sendFile(request, response, fullPath);
-    } else {
-      sendSimpleError(response, 404, request.url);
-    }
-  });
+var app = express();
+
+app.get('/', sendIndex)
+.get('/favicon.ico', function(req, res) {
+  res.writeHead(204);
+  res.end();
+})
+.use(JS_ROOT, serveIndex(jsDirectory), express.static(jsDirectory))
+.post(Path.UPLOAD, handleUpload)
+.use(WEB_ROOT, serveIndex(baseDirectory), express.static(baseDirectory))
+.get(Path.ECHO, sendEcho)
+.get(Path.PAGE, sendInifinitePage)
+.get(Path.PAGE + '/*', sendInifinitePage)
+.get(Path.REDIRECT, redirectToResultPage)
+.get(Path.SLEEP, sendDelayedResponse)
+
+if (isDevMode) {
+  var closureDir = resources.locate('third_party/closure/goog');
+  app.use('/third_party/closure/goog',
+      serveIndex(closureDir), express.static(closureDir));
 }
+var server = new Server(app);
 
 
-function redirectToResultPage(response) {
+function redirectToResultPage(_, response) {
   response.writeHead(303, {
     Location: Pages.resultPage
   });
@@ -197,23 +151,21 @@ function redirectToResultPage(response) {
 
 
 function sendInifinitePage(request, response) {
-  setTimeout(function() {
-    var pathname = url.parse(request.url).pathname;
-    var lastIndex = pathname.lastIndexOf('/');
-    var pageNumber =
-        (lastIndex == -1 ? 'Unknown' : pathname.substring(lastIndex + 1));
-    var body = [
-      '<!DOCTYPE html>',
-      '<title>Page', pageNumber, '</title>',
-      'Page number <span id="pageNumber">', pageNumber, '</span>',
-      '<p><a href="../xhtmlTest.html" target="_top">top</a>'
-    ].join('');
-    response.writeHead(200, {
-      'Content-Length': Buffer.byteLength(body, 'utf8'),
-      'Content-Type': 'text/html; charset=utf-8'
-    });
-    response.end(body);
-  }, 500);
+  var pathname = url.parse(request.url).pathname;
+  var lastIndex = pathname.lastIndexOf('/');
+  var pageNumber =
+      (lastIndex == -1 ? 'Unknown' : pathname.substring(lastIndex + 1));
+  var body = [
+    '<!DOCTYPE html>',
+    '<title>Page', pageNumber, '</title>',
+    'Page number <span id="pageNumber">', pageNumber, '</span>',
+    '<p><a href="../xhtmlTest.html" target="_top">top</a>'
+  ].join('');
+  response.writeHead(200, {
+    'Content-Length': Buffer.byteLength(body, 'utf8'),
+    'Content-Type': 'text/html; charset=utf-8'
+  });
+  response.end(body);
 }
 
 
@@ -222,7 +174,7 @@ function sendDelayedResponse(request, response) {
   var query = url.parse(request.url).query || '';
   var match = query.match(/\btime=(\d+)/);
   if (match) {
-    duration = parseInt(match[1]);
+    duration = parseInt(match[1], 10);
   }
 
   setTimeout(function() {
@@ -243,74 +195,36 @@ function sendDelayedResponse(request, response) {
 }
 
 
-/**
- * Sends an error in response to an I/O operation.
- * @param {!http.ServerRequest} request The request object.
- * @param {!http.ServerResponse} response The response object.
- * @param {!Error} err The I/O error.
- */
-function sendIOError(request, response, err) {
-  var code = 500;
-  if (err.code === 'ENOENT') {
-    code = 404;
-  } else if (err.code === 'EACCES') {
-    code = 403;
-  }
-  sendSimpleError(response, code, request.url);
-}
-
-
-/**
- * Sends a simple error message to the client and instructs it to close the
- * connection.
- * @param {!http.ServerResponse} response The response to populate.
- * @param {number} code The numeric HTTP code to send.
- * @param {string} message The error message.
- */
-function sendSimpleError(response, code, message) {
-  response.writeHead(code, {
-    'Content-Type': 'text/html; charset=utf-8',
-    'Connection': 'close'
-  });
-  response.end(
-      '<!DOCTYPE html><h1>' + code + ' ' + http.STATUS_CODES[code] +
-      '</h1><hr/>' + message);
+function handleUpload(request, response, next) {
+  multer({
+    inMemory: true,
+    onFileUploadComplete: function(file) {
+      response.writeHead(200);
+      response.write(file.buffer);
+      response.end('<script>window.top.window.onUploadDone();</script>');
+    }
+  })(request, response, function() {});
 }
 
 
-var MimeType = {
-  'css': 'text/css',
-  'gif': 'image/gif',
-  'html': 'text/html',
-  'js': 'application/javascript',
-  'png': 'image/png',
-  'svg': 'image/svg+xml',
-  'txt': 'text/plain',
-  'xhtml': 'application/xhtml+xml',
-  'xsl': 'application/xml',
-  'xml': 'application/xml'
-};
-
-
-/**
- * Responds to a request for an individual file.
- * @param {!http.ServerRequest} request The request object.
- * @param {!http.ServerResponse} response The response object.
- * @param {string} filePath Path to the file to return.
- */
-function sendFile(request, response, filePath) {
-  fs.readFile(filePath, function(err, buffer) {
-    if (err) {
-      sendIOError(request, response, err);
-      return;
-    }
-    var index = filePath.lastIndexOf('.');
-    var type = MimeType[index < 0 ? '' : filePath.substring(index + 1)];
-    var headers = {'Content-Length': buffer.length};
-    if (type) headers['Content-Type'] = type;
-    response.writeHead(200, headers);
-    response.end(buffer);
+function sendEcho(request, response) {
+  var body = [
+    '<!DOCTYPE html>',
+    '<title>Echo</title>',
+    '<div class="request">',
+    request.method, ' ', request.url, ' ', 'HTTP/', request.httpVersion,
+    '</div>'
+  ];
+  for (var name in request.headers) {
+    body.push('<div class="header ', name , '">',
+        name, ': ', request.headers[name], '</div>');
+  }
+  body = body.join('');
+  response.writeHead(200, {
+    'Content-Length': Buffer.byteLength(body, 'utf8'),
+    'Content-Type': 'text/html; charset=utf-8'
   });
+  response.end(body);
 }
 
 
@@ -350,69 +264,6 @@ function sendIndex(request, response) {
 }
 
 
-/**
- * Responds to a request for a directory listing.
- * @param {!http.ServerRequest} request The request object.
- * @param {!http.ServerResponse} response The response object.
- * @param {string} dirPath Path to the directory to generate a listing for.
- */
-function sendDirectoryListing(request, response, dirPath) {
-  var pathname = url.parse(request.url).pathname;
-
-  var host = request.headers.host;
-  if (!host) {
-    host = server.host();
-  }
-
-  var requestUrl = ['http://' + host + pathname].join('');
-  if (requestUrl[requestUrl.length - 1] !== '/') {
-    response.writeHead(303, {'Location': requestUrl + '/'});
-    return response.end();
-  }
-
-  fs.readdir(dirPath, function(err, files) {
-    if (err) {
-      sendIOError(request, response, err);
-      return;
-    }
-
-    var data = ['<!DOCTYPE html><h1>', pathname, '</h1><hr/><ul>'];
-    if (pathname !== '/') {
-      data.push(createListEntry('../'));
-    }
-    processNextFile();
-
-    function processNextFile() {
-      var file = files.shift();
-      if (file) {
-        fs.stat(path.join(dirPath, file), function(err, stats) {
-          if (err) {
-            sendIOError(request, response, err);
-            return;
-          }
-
-          data.push(createListEntry(
-              stats.isDirectory() ? file + '/' : file));
-          processNextFile();
-        });
-      } else {
-        data = new Buffer(data.join(''), 'utf-8');
-        response.writeHead(200, {
-          'Content-Type': 'text/html; charset=utf-8',
-          'Content-Length': data.length
-        });
-        response.end(data);
-      }
-    }
-
-    function createListEntry(path) {
-      var url = requestUrl + path;
-      return ['<li><a href="', url, '">', path, '</a>'].join('');
-    }
-  });
-}
-
-
 // PUBLIC application
 
 
@@ -451,7 +302,11 @@ exports.url = server.url.bind(server);
  * @throws {Error} If the server is not running.
  */
 exports.whereIs = function(filePath) {
-  return server.url(path.join(WEB_ROOT, filePath));
+  filePath = filePath.replace(/\\/g, '/');
+  if (!string.startsWith(filePath, '/')) {
+    filePath = '/' + filePath;
+  }
+  return server.url(WEB_ROOT + filePath);
 };
 
 
diff --git a/lib/test/httpserver.js b/lib/test/httpserver.js
index e75298e..55b1255 100644
--- a/lib/test/httpserver.js
+++ b/lib/test/httpserver.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -19,7 +21,8 @@ var assert = require('assert'),
     http = require('http'),
     url = require('url');
 
-var portprober = require('../../net/portprober'),
+var net = require('../../net'),
+    portprober = require('../../net/portprober'),
     promise = require('../..').promise;
 
 
@@ -51,6 +54,8 @@ var Server = function(requestHandler) {
    *     with the server host when it has fully started.
    */
   this.start = function(opt_port) {
+    assert(typeof opt_port !== 'function',
+           "start invoked with function, not port (mocha callback)?");
     var port = opt_port || portprober.findFreePort('localhost');
     return promise.when(port, function(port) {
       return promise.checkedNodeCall(
@@ -88,8 +93,8 @@ var Server = function(requestHandler) {
    * @throws {Error} If the server is not running.
    */
   this.host = function() {
-    var addr = this.address();
-    return addr.address + ':' + addr.port;
+    return net.getLoopbackAddress() + ':' +
+        this.address().port;
   };
 
   /**
@@ -103,7 +108,7 @@ var Server = function(requestHandler) {
     var pathname = opt_pathname || '';
     return url.format({
       protocol: 'http',
-      hostname: addr.address,
+      hostname: net.getLoopbackAddress(),
       port: addr.port,
       pathname: pathname
     });
diff --git a/lib/test/index.js b/lib/test/index.js
index f328bee..2693a96 100644
--- a/lib/test/index.js
+++ b/lib/test/index.js
@@ -1,74 +1,102 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
 var assert = require('assert');
 
-var webdriver = require('../..'),
+var build = require('./build'),
+    webdriver = require('../..'),
     flow = webdriver.promise.controlFlow(),
+    _base = require('../../_base'),
+    remote = require('../../remote'),
     testing = require('../../testing'),
-    fileserver = require('./fileserver'),
-    seleniumserver = require('./seleniumserver');
-
-
-var Browser = {
-  ANDROID: 'android',
-  CHROME: 'chrome',
-  IE: 'internet explorer',
-  // Shorthand for IPAD && IPHONE when using the browsers predciate.
-  IOS: 'iOS',
-  IPAD: 'iPad',
-  IPHONE: 'iPhone',
-  FIREFOX: 'firefox',
-  OPERA: 'opera',
-  PHANTOMJS: 'phantomjs',
-  SAFARI: 'safari',
-
-  // Browsers that should always be tested via the java Selenium server.
-  REMOTE_CHROME: 'remote.chrome',
-  REMOTE_PHANTOMJS: 'remote.phantomjs'
-};
+    fileserver = require('./fileserver');
 
 
 /**
  * Browsers with native support.
- * @type {!Array.<string>}
+ * @type {!Array.<webdriver.Browser>}
  */
 var NATIVE_BROWSERS = [
-  Browser.CHROME,
-  Browser.PHANTOMJS
+  webdriver.Browser.CHROME,
+  webdriver.Browser.FIREFOX,
+  webdriver.Browser.IE,
+  webdriver.Browser.OPERA,
+  webdriver.Browser.PHANTOM_JS,
+  webdriver.Browser.SAFARI
 ];
 
 
+var serverJar = process.env['SELENIUM_SERVER_JAR'];
+var remoteUrl = process.env['SELENIUM_REMOTE_URL'];
+var useLoopback = process.env['SELENIUM_USE_LOOP_BACK'] == '1';
+var startServer = !!serverJar && !remoteUrl;
+var nativeRun = !serverJar && !remoteUrl;
+
+
 var browsersToTest = (function() {
-  var browsers = process.env['SELENIUM_BROWSER'] || Browser.CHROME;
-  browsers = browsers.split(',');
+  var permitRemoteBrowsers = !!remoteUrl || !!serverJar;
+  var permitUnknownBrowsers = !nativeRun;
+  var browsers = process.env['SELENIUM_BROWSER'] || webdriver.Browser.FIREFOX;
+
+  browsers = browsers.split(',').map(function(browser) {
+    var parts = browser.split(/:/);
+    if (parts[0] === 'ie') {
+      parts[0] = webdriver.Browser.IE;
+    }
+    return parts.join(':');
+  });
   browsers.forEach(function(browser) {
-    if (browser === Browser.IOS) {
-      throw Error('Invalid browser name: ' + browser);
+    var parts = browser.split(/:/, 3);
+    if (parts[0] === 'ie') {
+      parts[0] = webdriver.Browser.IE;
+    }
+
+    if (NATIVE_BROWSERS.indexOf(parts[0]) == -1 && !permitRemoteBrowsers) {
+      throw Error('Browser ' + parts[0] + ' requires a WebDriver server and ' +
+          'neither the SELENIUM_REMOTE_URL nor the SELENIUM_SERVER_JAR ' +
+          'environment variables have been set.');
     }
 
-    for (var name in Browser) {
-      if (Browser.hasOwnProperty(name) && Browser[name] === browser) {
-        return;
+    var recognized = false;
+    for (var prop in webdriver.Browser) {
+      if (webdriver.Browser.hasOwnProperty(prop) &&
+          webdriver.Browser[prop] === parts[0]) {
+        recognized = true;
+        break;
       }
     }
 
-    throw Error('Unrecognized browser: ' + browser);
+    if (!recognized && !permitUnknownBrowsers) {
+      throw Error('Unrecognized browser: ' + browser);
+    }
   });
+
+  console.log('Running tests against [' + browsers.join(',') + ']');
+  if (remoteUrl) {
+    console.log('Using remote server ' + remoteUrl);
+  } else if (serverJar) {
+    console.log('Using standalone Selenium server ' + serverJar);
+    if (useLoopback) {
+      console.log('Running tests using loopback address')
+    }
+  }
+
   return browsers;
 })();
 
@@ -81,10 +109,7 @@ var browsersToTest = (function() {
  */
 function browsers(currentBrowser, browsersToIgnore) {
   return function() {
-    var checkIos =
-        currentBrowser === Browser.IPAD || currentBrowser === Browser.IPHONE;
-    return browsersToIgnore.indexOf(currentBrowser) != -1 ||
-        (checkIos && browsersToIgnore.indexOf(Browser.IOS) != -1);
+    return browsersToIgnore.indexOf(currentBrowser) != -1;
   };
 }
 
@@ -96,80 +121,38 @@ function browsers(currentBrowser, browsersToIgnore) {
  */
 function TestEnvironment(browserName, server) {
   var name = browserName;
-  if (name.lastIndexOf('remote.', 0) == 0) {
-    name = name.substring('remote.'.length);
-  }
-
-  var autoCreate = true;
-  this.__defineGetter__(
-      'autoCreateDriver', function() { return autoCreate; });
-  this.__defineSetter__(
-      'autoCreateDriver', function(auto) { autoCreate = auto; });
 
-  this.__defineGetter__('browser', function() { return name; });
+  this.currentBrowser = function() {
+    return browserName;
+  };
 
-  var driver;
-  this.__defineGetter__('driver', function() { return driver; });
+  this.isRemote = function() {
+    return server || remoteUrl;
+  };
 
   this.browsers = function(var_args) {
     var browsersToIgnore = Array.prototype.slice.apply(arguments, [0]);
-    var remoteVariants = [];
-    browsersToIgnore.forEach(function(browser) {
-      if (browser.lastIndexOf('remote.', 0) === 0) {
-        remoteVariants.push(browser.substring('remote.'.length));
-      }
-    });
-    browsersToIgnore = browsersToIgnore.concat(remoteVariants);
     return browsers(browserName, browsersToIgnore);
   };
 
   this.builder = function() {
-    assert.ok(!driver, 'Can only have one driver at a time');
     var builder = new webdriver.Builder();
     var realBuild = builder.build;
 
     builder.build = function() {
-      builder.getCapabilities().
-          set(webdriver.Capability.BROWSER_NAME, name);
-
+      var parts = browserName.split(/:/, 3);
+      builder.forBrowser(parts[0], parts[1], parts[2]);
       if (server) {
         builder.usingServer(server.address());
+      } else if (remoteUrl) {
+        builder.usingServer(remoteUrl);
       }
-      return driver = realBuild.call(builder);
+      builder.disableEnvironmentOverrides();
+      return realBuild.call(builder);
     };
 
     return builder;
   };
-
-  this.createDriver = function() {
-    if (!driver) {
-      driver = this.builder().build();
-    }
-    return driver;
-  };
-
-  this.refreshDriver = function() {
-    if (driver) {
-      driver.quit();
-      driver = null;
-    }
-    this.createDriver();
-  };
-
-  this.dispose = function() {
-    if (driver) {
-      driver.quit();
-      driver = null;
-    }
-  };
-
-  this.waitForTitleToBe = function(expected) {
-    driver.wait(function() {
-      return driver.getTitle().then(function(title) {
-        return title === expected;
-      });
-    }, 5000, 'Waiting for title to be ' + expected);
-  };
 }
 
 
@@ -193,43 +176,52 @@ function suite(fn, opt_options) {
     // Filter out browser specific tests when that browser is not currently
     // selected for testing.
     browsers = browsers.filter(function(browser) {
-      if (browsersToTest.indexOf(browser) != -1) {
-        return true;
-      }
-      return browsersToTest.indexOf(
-          browser.substring('remote.'.length)) != -1;
+      return browsersToTest.indexOf(browser) != -1;
     });
   } else {
     browsers = browsersToTest;
   }
 
   try {
-    browsers.forEach(function(browser) {
 
+    // Server is only started if required for a specific config.
+    testing.after(function() {
+      if (seleniumServer) {
+        return seleniumServer.stop();
+      }
+    });
+
+    browsers.forEach(function(browser) {
       testing.describe('[' + browser + ']', function() {
-        var serverToUse = null;
 
-        if (NATIVE_BROWSERS.indexOf(browser) == -1) {
-          serverToUse = seleniumServer;
-          if (!serverToUse) {
-            serverToUse = seleniumServer = new seleniumserver.Server();
+        if (_base.isDevMode() && nativeRun) {
+          if (browser === webdriver.Browser.FIREFOX) {
+            testing.before(function() {
+              return build.of('//javascript/firefox-driver:webdriver')
+                  .onlyOnce().go();
+            });
+          } else if (browser === webdriver.Browser.SAFARI) {
+            testing.before(function() {
+              return build.of('//javascript/safari-driver:client')
+                  .onlyOnce().go();
+            });
           }
-          testing.before(seleniumServer.start.bind(seleniumServer, 60 * 1000));
         }
 
-        var env = new TestEnvironment(browser, serverToUse);
+        var serverToUse = null;
 
-        testing.beforeEach(function() {
-          if (env.autoCreateDriver) {
-            env.createDriver();
+        if (!!serverJar && !remoteUrl) {
+          if (!(serverToUse = seleniumServer)) {
+            serverToUse = seleniumServer = new remote.SeleniumServer(
+                serverJar, {loopback: useLoopback});
           }
-        });
 
-        testing.after(function() {
-          env.dispose();
-        });
-
-        fn(env);
+          testing.before(function() {
+            this.timeout(0);
+            return seleniumServer.start(60 * 1000);
+          });
+        }
+        fn(new TestEnvironment(browser, serverToUse));
       });
     });
   } finally {
@@ -240,18 +232,17 @@ function suite(fn, opt_options) {
 
 // GLOBAL TEST SETUP
 
+testing.before(function() {
+   // Do not pass register fileserver.start directly with testing.before,
+   // as start takes an optional port, which before assumes is an async
+   // callback.
+   return fileserver.start();
+});
 
-testing.before(fileserver.start);
-testing.after(fileserver.stop);
-
-// Server is only started if required for a specific config.
 testing.after(function() {
-  if (seleniumServer) {
-    seleniumServer.stop();
-  }
+   return fileserver.stop();
 });
 
-
 // PUBLIC API
 
 
@@ -263,6 +254,5 @@ exports.beforeEach = testing.beforeEach;
 exports.it = testing.it;
 exports.ignore = testing.ignore;
 
-exports.Browser = Browser;
 exports.Pages = fileserver.Pages;
 exports.whereIs = fileserver.whereIs;
diff --git a/lib/test/resources.js b/lib/test/resources.js
index 2f95828..ccd0eeb 100644
--- a/lib/test/resources.js
+++ b/lib/test/resources.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
diff --git a/lib/test/seleniumserver.js b/lib/test/seleniumserver.js
index 932a02a..7925972 100644
--- a/lib/test/seleniumserver.js
+++ b/lib/test/seleniumserver.js
@@ -17,6 +17,7 @@
 
 var assert = require('assert'),
     fs = require('fs'),
+    path = require('path'),
     util = require('util');
 
 var promise = require('../..').promise,
@@ -25,8 +26,8 @@ var promise = require('../..').promise,
     build = require('./build');
 
 
-var DEV_MODE_JAR_PATH =
-    'build/java/server/src/org/openqa/grid/selenium/selenium-standalone.jar';
+var DEV_MODE_JAR_PATH = path.join(__dirname, '../../../../..',
+    'build/java/server/src/org/openqa/grid/selenium/selenium-standalone.jar');
 var SELENIUM_SERVER_JAR_ENV = 'SELENIUM_SERVER_JAR';
 var PROD_MODE_JAR_PATH = process.env[SELENIUM_SERVER_JAR_ENV];
 
@@ -59,7 +60,8 @@ function getProdModeJarPath() {
 function Server() {
   var jarPath = isDevMode ? DEV_MODE_JAR_PATH : getProdModeJarPath();
   RemoteServer.call(this, jarPath, {
-    port: 0
+    port: 0,
+    stdio: 'inherit'
   });
 }
 util.inherits(Server, RemoteServer);
diff --git a/lib/webdriver/abstractbuilder.js b/lib/webdriver/abstractbuilder.js
index f535f47..274f81a 100644
--- a/lib/webdriver/abstractbuilder.js
+++ b/lib/webdriver/abstractbuilder.js
@@ -114,6 +114,19 @@ webdriver.AbstractBuilder.prototype.getCapabilities = function() {
 };
 
 
+/**
+ * Sets the logging preferences for the created session. Preferences may be
+ * changed by repeated calls, or by calling {@link #withCapabilities}.
+ * @param {!(webdriver.logging.Preferences|Object.<string, string>)} prefs The
+ *     desired logging preferences.
+ * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.
+ */
+webdriver.AbstractBuilder.prototype.setLoggingPreferences = function(prefs) {
+  this.capabilities_.set(webdriver.Capability.LOGGING_PREFS, prefs);
+  return this;
+};
+
+
 /**
  * Builds a new {@link webdriver.WebDriver} instance using this builder's
  * current configuration.
diff --git a/lib/webdriver/actionsequence.js b/lib/webdriver/actionsequence.js
index cd42979..28106ac 100644
--- a/lib/webdriver/actionsequence.js
+++ b/lib/webdriver/actionsequence.js
@@ -1,17 +1,19 @@
-// Copyright 2012 Selenium comitters
-// Copyright 2012 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 goog.provide('webdriver.ActionSequence');
 
@@ -27,15 +29,15 @@ goog.require('webdriver.Key');
  * Class for defining sequences of complex user interactions. Each sequence
  * will not be executed until {@link #perform} is called.
  *
- * <p>Example:<pre><code>
- *   new webdriver.ActionSequence(driver).
- *       keyDown(webdriver.Key.SHIFT).
- *       click(element1).
- *       click(element2).
- *       dragAndDrop(element3, element4).
- *       keyUp(webdriver.Key.SHIFT).
- *       perform();
- * </pre></code>
+ * Example:
+ *
+ *     new webdriver.ActionSequence(driver).
+ *         keyDown(webdriver.Key.SHIFT).
+ *         click(element1).
+ *         click(element2).
+ *         dragAndDrop(element3, element4).
+ *         keyUp(webdriver.Key.SHIFT).
+ *         perform();
  *
  * @param {!webdriver.WebDriver} driver The driver instance to use.
  * @constructor
@@ -103,13 +105,7 @@ webdriver.ActionSequence.prototype.mouseMove = function(location, opt_offset) {
   if (goog.isNumber(location.x)) {
     setOffset(/** @type {{x: number, y: number}} */(location));
   } else {
-    // The interactions API expect the element ID to be encoded as a simple
-    // string, not the usual JSON object.
-    var id = /** @type {!webdriver.WebElement} */ (location).toWireValue().
-        then(function(value) {
-          return value['ELEMENT'];
-        });
-    command.setParameter('element', id);
+    command.setParameter('element', location.getRawId());
     if (opt_offset) {
       setOffset(opt_offset);
     }
@@ -167,12 +163,13 @@ webdriver.ActionSequence.prototype.scheduleMouseAction_ = function(
  * sequence or another. The behavior for out-of-order events (e.g. mouseDown,
  * click) is undefined.
  *
- * <p>If an element is provided, the mouse will first be moved to the center
+ * If an element is provided, the mouse will first be moved to the center
  * of that element. This is equivalent to:
- * <pre><code>sequence.mouseMove(element).mouseDown()</code></pre>
  *
- * <p>Warning: this method currently only supports the left mouse button. See
- * http://code.google.com/p/selenium/issues/detail?id=4047
+ *     sequence.mouseMove(element).mouseDown()
+ *
+ * Warning: this method currently only supports the left mouse button. See
+ * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).
  *
  * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either
  *     the element to interact with or the button to click with.
@@ -194,12 +191,13 @@ webdriver.ActionSequence.prototype.mouseDown = function(opt_elementOrButton,
  * Releases a mouse button. Behavior is undefined for calling this function
  * without a previous call to {@link #mouseDown}.
  *
- * <p>If an element is provided, the mouse will first be moved to the center
+ * If an element is provided, the mouse will first be moved to the center
  * of that element. This is equivalent to:
- * <pre><code>sequence.mouseMove(element).mouseUp()</code></pre>
  *
- * <p>Warning: this method currently only supports the left mouse button. See
- * http://code.google.com/p/selenium/issues/detail?id=4047
+ *     sequence.mouseMove(element).mouseUp()
+ *
+ * Warning: this method currently only supports the left mouse button. See
+ * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).
  *
  * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either
  *     the element to interact with or the button to click with.
@@ -234,9 +232,10 @@ webdriver.ActionSequence.prototype.dragAndDrop = function(element, location) {
 /**
  * Clicks a mouse button.
  *
- * <p>If an element is provided, the mouse will first be moved to the center
+ * If an element is provided, the mouse will first be moved to the center
  * of that element. This is equivalent to:
- * <pre><code>sequence.mouseMove(element).click()</code></pre>
+ *
+ *     sequence.mouseMove(element).click()
  *
  * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either
  *     the element to interact with or the button to click with.
@@ -257,12 +256,13 @@ webdriver.ActionSequence.prototype.click = function(opt_elementOrButton,
 /**
  * Double-clicks a mouse button.
  *
- * <p>If an element is provided, the mouse will first be moved to the center of
+ * If an element is provided, the mouse will first be moved to the center of
  * that element. This is equivalent to:
- * <pre><code>sequence.mouseMove(element).doubleClick()</code></pre>
  *
- * <p>Warning: this method currently only supports the left mouse button. See
- * http://code.google.com/p/selenium/issues/detail?id=4047
+ *     sequence.mouseMove(element).doubleClick()
+ *
+ * Warning: this method currently only supports the left mouse button. See
+ * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).
  *
  * @param {(webdriver.WebElement|webdriver.Button)=} opt_elementOrButton Either
  *     the element to interact with or the button to click with.
diff --git a/lib/webdriver/builder.js b/lib/webdriver/builder.js
index 28d1721..f67368d 100644
--- a/lib/webdriver/builder.js
+++ b/lib/webdriver/builder.js
@@ -1,70 +1,145 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 goog.provide('webdriver.Builder');
 
+goog.require('goog.Uri');
 goog.require('goog.userAgent');
-goog.require('webdriver.AbstractBuilder');
+goog.require('webdriver.Capabilities');
 goog.require('webdriver.FirefoxDomExecutor');
 goog.require('webdriver.WebDriver');
 goog.require('webdriver.http.CorsClient');
 goog.require('webdriver.http.Executor');
 goog.require('webdriver.http.XhrClient');
-goog.require('webdriver.process');
 
 
 
 /**
+ * Creates new {@code webdriver.WebDriver} clients for use in a browser
+ * environment. Upon instantiation, each Builder will configure itself based
+ * on the following query parameters:
+ * <dl>
+ *   <dt>wdurl
+ *   <dd>Defines the WebDriver server to send commands to. If this is a
+ *       relative URL, the builder will use the standard WebDriver wire
+ *       protocol and a {@link webdriver.http.XhrClient}. Otherwise, it will
+ *       use a {@link webdriver.http.CorsClient}; this only works when
+ *       connecting to an instance of the Java Selenium server. The server URL
+ *       may be changed using {@code #usingServer}.
+ *
+ *   <dt>wdsid
+ *   <dd>Defines the session to connect to. If omitted, will request a new
+ *       session from the server.
+ * </dl>
+ *
+ * @param {Window=} opt_window The window to extract query parameters from.
  * @constructor
- * @extends {webdriver.AbstractBuilder}
+ * @final
+ * @struct
  */
-webdriver.Builder = function() {
-  goog.base(this);
-
-  /**
-   * ID of an existing WebDriver session that new clients should use.
-   * Initialized from the value of the
-   * {@link webdriver.AbstractBuilder.SESSION_ID_ENV} environment variable, but
-   * may be overridden using
-   * {@link webdriver.AbstractBuilder#usingSession}.
-   * @private {string}
-   */
+webdriver.Builder = function(opt_window) {
+  var win = opt_window || window;
+  var data = new goog.Uri(win.location).getQueryData();
+
+  /** @private {string} */
+  this.serverUrl_ =
+      /** @type {string} */ (data.get(webdriver.Builder.SERVER_URL_PARAM,
+      webdriver.Builder.DEFAULT_SERVER_URL)).replace(/\/$/, "");
+
+  /** @private {string} */
   this.sessionId_ =
-      webdriver.process.getEnv(webdriver.Builder.SESSION_ID_ENV);
+      /** @type {string} */ (data.get(webdriver.Builder.SESSION_ID_PARAM));
+
+  /** @private {boolean} */
+  this.useBrowserCors_ =
+      /** @type {boolean} */ (data.containsKey(webdriver.Builder.USE_BROWSER_CORS));
+
+  /** @private {!webdriver.Capabilities} */
+  this.capabilities_ = new webdriver.Capabilities();
 };
-goog.inherits(webdriver.Builder, webdriver.AbstractBuilder);
 
 
 /**
- * Environment variable that defines the session ID of an existing WebDriver
- * session to use when creating clients. If set, all new Builder instances will
- * default to creating clients that use this session. To create a new session,
- * use {@code #useExistingSession(boolean)}. The use of this environment
- * variable requires that {@link webdriver.AbstractBuilder.SERVER_URL_ENV} also
- * be set.
+ * Query parameter that defines which session to connect to.
+ * @type {string}
+ * @const
+ */
+webdriver.Builder.SESSION_ID_PARAM = 'wdsid';
+
+
+/**
+ * Query parameter that defines the URL of the remote server to connect to.
+ * @type {string}
+ * @const
+ */
+webdriver.Builder.SERVER_URL_PARAM = 'wdurl';
+
+
+/**
+ * The default server URL to use.
+ * @type {string}
+ * @const
+ */
+webdriver.Builder.DEFAULT_SERVER_URL = 'http://localhost:4444/wd/hub';
+
+
+/**
+ * Query parameter that defines whether browser CORS support should be used,
+ * if available.
  * @type {string}
  * @const
- * @see webdriver.process.getEnv
  */
-webdriver.Builder.SESSION_ID_ENV = 'wdsid';
+webdriver.Builder.USE_BROWSER_CORS = 'wdcors';
+
+
+/**
+ * Configures the WebDriver to use browser's CORS, if available.
+ * @return {!webdriver.Builder} This Builder instance for chain calling.
+ */
+webdriver.Builder.prototype.useBrowserCors = function() {
+  this.useBrowserCors_ = true;
+  return this;
+};
+
+/**
+ * Configures which WebDriver server should be used for new sessions.
+ * @param {string} url URL of the server to use.
+ * @return {!webdriver.Builder} This Builder instance for chain calling.
+ */
+webdriver.Builder.prototype.usingServer = function(url) {
+  this.serverUrl_ = url.replace(/\/$/, "");
+  return this;
+};
+
+
+/**
+ * @return {string} The URL of the WebDriver server this instance is configured
+ *     to use.
+ */
+webdriver.Builder.prototype.getServerUrl = function() {
+  return this.serverUrl_;
+};
 
 
 /**
  * Configures the builder to create a client that will use an existing WebDriver
  * session.
  * @param {string} id The existing session ID to use.
- * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.
+ * @return {!webdriver.Builder} This Builder instance for chain calling.
  */
 webdriver.Builder.prototype.usingSession = function(id) {
   this.sessionId_ = id;
@@ -82,7 +157,22 @@ webdriver.Builder.prototype.getSession = function() {
 
 
 /**
- * @override
+ * Sets the desired capabilities when requesting a new session. This will
+ * overwrite any previously set desired capabilities.
+ * @param {!(Object|webdriver.Capabilities)} capabilities The desired
+ *     capabilities for a new session.
+ * @return {!webdriver.Builder} This Builder instance for chain calling.
+ */
+webdriver.Builder.prototype.withCapabilities = function(capabilities) {
+  this.capabilities_ = new webdriver.Capabilities(capabilities);
+  return this;
+};
+
+
+/**
+ * Builds a new {@link webdriver.WebDriver} instance using this builder's
+ * current configuration.
+ * @return {!webdriver.WebDriver} A new WebDriver client.
  */
 webdriver.Builder.prototype.build = function() {
   if (goog.userAgent.GECKO && document.readyState != 'complete') {
@@ -93,12 +183,13 @@ webdriver.Builder.prototype.build = function() {
 
   if (webdriver.FirefoxDomExecutor.isAvailable()) {
     executor = new webdriver.FirefoxDomExecutor();
-    return webdriver.WebDriver.createSession(executor, this.getCapabilities());
+    return webdriver.WebDriver.createSession(executor, this.capabilities_);
   } else {
-    var url = this.getServerUrl() ||
-        webdriver.AbstractBuilder.DEFAULT_SERVER_URL;
+    var url = this.serverUrl_;
     var client;
-    if (url[0] == '/') {
+    if (this.useBrowserCors_ && webdriver.http.CorsClient.isAvailable()) {
+      client = new webdriver.http.XhrClient(url);
+    } else if (url[0] == '/') {
       var origin = window.location.origin ||
           (window.location.protocol + '//' + window.location.host);
       client = new webdriver.http.XhrClient(origin + url);
@@ -107,11 +198,10 @@ webdriver.Builder.prototype.build = function() {
     }
     executor = new webdriver.http.Executor(client);
 
-    if (this.getSession()) {
-      return webdriver.WebDriver.attachToSession(executor, this.getSession());
+    if (this.sessionId_) {
+      return webdriver.WebDriver.attachToSession(executor, this.sessionId_);
     } else {
-      throw new Error('Unable to create a new client for this browser. The ' +
-          'WebDriver session ID has not been defined.');
+      return webdriver.WebDriver.createSession(executor, this.capabilities_);
     }
   }
 };
diff --git a/lib/webdriver/button.js b/lib/webdriver/button.js
index aedb0b3..d45a8dd 100644
--- a/lib/webdriver/button.js
+++ b/lib/webdriver/button.js
@@ -1,17 +1,19 @@
-// Copyright 2012 Selenium comitters
-// Copyright 2012 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 goog.provide('webdriver.Button');
 
diff --git a/lib/webdriver/capabilities.js b/lib/webdriver/capabilities.js
index 783322a..874ca65 100644
--- a/lib/webdriver/capabilities.js
+++ b/lib/webdriver/capabilities.js
@@ -1,16 +1,19 @@
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Defines the webdriver.Capabilities class.
@@ -19,6 +22,10 @@
 goog.provide('webdriver.Browser');
 goog.provide('webdriver.Capabilities');
 goog.provide('webdriver.Capability');
+goog.provide('webdriver.ProxyConfig');
+
+goog.require('webdriver.Serializable');
+goog.require('webdriver.logging');
 
 
 
@@ -30,6 +37,7 @@ webdriver.Browser = {
   ANDROID: 'android',
   CHROME: 'chrome',
   FIREFOX: 'firefox',
+  IE: 'internet explorer',
   INTERNET_EXPLORER: 'internet explorer',
   IPAD: 'iPad',
   IPHONE: 'iPhone',
@@ -41,6 +49,23 @@ webdriver.Browser = {
 
 
 
+/**
+ * Describes how a proxy should be configured for a WebDriver session.
+ * Proxy configuration object, as defined by the WebDriver wire protocol.
+ * @typedef {(
+ *     {proxyType: string}|
+ *     {proxyType: string,
+ *      proxyAutoconfigUrl: string}|
+ *     {proxyType: string,
+ *      ftpProxy: string,
+ *      httpProxy: string,
+ *      sslProxy: string,
+ *      noProxy: string})}
+ */
+webdriver.ProxyConfig;
+
+
+
 /**
  * Common webdriver capability keys.
  * @enum {string}
@@ -50,8 +75,7 @@ webdriver.Capability = {
   /**
    * Indicates whether a driver should accept all SSL certs by default. This
    * capability only applies when requesting a new session. To query whether
-   * a driver can handle insecure SSL certs, see
-   * {@link webdriver.Capability.SECURE_SSL}.
+   * a driver can handle insecure SSL certs, see {@link #SECURE_SSL}.
    */
   ACCEPT_SSL_CERTS: 'acceptSslCerts',
 
@@ -62,10 +86,24 @@ webdriver.Capability = {
    */
   BROWSER_NAME: 'browserName',
 
+  /**
+   * New Capability, which describes the browser name for supporting
+   * testing on BrowserStack
+  */
+  BROWSER: 'browser',
+
+  /**
+   * Defines how elements should be scrolled into the viewport for interaction.
+   * This capability will be set to zero (0) if elements are aligned with the
+   * top of the viewport, or one (1) if aligned with the bottom. The default
+   * behavior is to align with the top of the viewport.
+   */
+  ELEMENT_SCROLL_BEHAVIOR: 'elementScrollBehavior',
+
   /**
    * Whether the driver is capable of handling modal alerts (e.g. alert,
    * confirm, prompt). To define how a driver <i>should</i> handle alerts,
-   * use {@link webdriver.Capability.UNEXPECTED_ALERT_BEHAVIOR}.
+   * use {@link #UNEXPECTED_ALERT_BEHAVIOR}.
    */
   HANDLES_ALERTS: 'handlesAlerts',
 
@@ -74,6 +112,11 @@ webdriver.Capability = {
    */
   LOGGING_PREFS: 'loggingPrefs',
 
+  /**
+   * Whether this session generates native events when simulating user input.
+   */
+  NATIVE_EVENTS: 'nativeEvents',
+
   /**
    * Describes the platform the browser is running on. Will be one of
    * ANDROID, IOS, LINUX, MAC, UNIX, or WINDOWS. When <i>requesting</i> a
@@ -93,19 +136,13 @@ webdriver.Capability = {
   /**
    * Whether a driver is only capable of handling secure SSL certs. To request
    * that a driver accept insecure SSL certs by default, use
-   * {@link webdriver.Capability.ACCEPT_SSL_CERTS}.
+   * {@link #ACCEPT_SSL_CERTS}.
    */
   SECURE_SSL: 'secureSsl',
 
   /** Whether the driver supports manipulating the app cache. */
   SUPPORTS_APPLICATION_CACHE: 'applicationCacheEnabled',
 
-  /**
-   * Whether the driver supports controlling the browser's internet
-   * connectivity.
-   */
-  SUPPORTS_BROWSER_CONNECTION: 'browserConnectionEnabled',
-
   /** Whether the driver supports locating elements with CSS selectors. */
   SUPPORTS_CSS_SELECTORS: 'cssSelectorsEnabled',
 
@@ -134,16 +171,19 @@ webdriver.Capability = {
  * @param {(webdriver.Capabilities|Object)=} opt_other Another set of
  *     capabilities to merge into this instance.
  * @constructor
+ * @extends {webdriver.Serializable.<!Object.<string, ?>>}
  */
 webdriver.Capabilities = function(opt_other) {
+  webdriver.Serializable.call(this);
 
-  /** @private {!Object} */
+  /** @private {!Object.<string, ?>} */
   this.caps_ = {};
 
   if (opt_other) {
     this.merge(opt_other);
   }
 };
+goog.inherits(webdriver.Capabilities, webdriver.Serializable);
 
 
 /**
@@ -214,7 +254,6 @@ webdriver.Capabilities.opera = function() {
       set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.OPERA);
 };
 
-
 /**
  * @return {!webdriver.Capabilities} A basic set of capabilities for
  *     PhantomJS.
@@ -254,8 +293,12 @@ webdriver.Capabilities.htmlunitwithjs = function() {
 };
 
 
-/** @return {!Object} The JSON representation of this instance. */
-webdriver.Capabilities.prototype.toJSON = function() {
+/**
+ * @return {!Object.<string, ?>} The JSON representation of this instance. Note,
+ *    the returned object may contain nested promises that are promised values.
+ * @override
+ */
+webdriver.Capabilities.prototype.serialize = function() {
   return this.caps_;
 };
 
@@ -316,3 +359,59 @@ webdriver.Capabilities.prototype.get = function(key) {
 webdriver.Capabilities.prototype.has = function(key) {
   return !!this.get(key);
 };
+
+
+/**
+ * Sets the logging preferences. Preferences may be specified as a
+ * {@link webdriver.logging.Preferences} instance, or a as a map of log-type to
+ * log-level.
+ * @param {!(webdriver.logging.Preferences|Object.<string, string>)} prefs The
+ *     logging preferences.
+ * @return {!webdriver.Capabilities} A self reference.
+ */
+webdriver.Capabilities.prototype.setLoggingPrefs = function(prefs) {
+  return this.set(webdriver.Capability.LOGGING_PREFS, prefs);
+};
+
+
+/**
+ * Sets the proxy configuration for this instance.
+ * @param {webdriver.ProxyConfig} proxy The desired proxy configuration.
+ * @return {!webdriver.Capabilities} A self reference.
+ */
+webdriver.Capabilities.prototype.setProxy = function(proxy) {
+  return this.set(webdriver.Capability.PROXY, proxy);
+};
+
+
+/**
+ * Sets whether native events should be used.
+ * @param {boolean} enabled Whether to enable native events.
+ * @return {!webdriver.Capabilities} A self reference.
+ */
+webdriver.Capabilities.prototype.setEnableNativeEvents = function(enabled) {
+  return this.set(webdriver.Capability.NATIVE_EVENTS, enabled);
+};
+
+
+/**
+ * Sets how elements should be scrolled into view for interaction.
+ * @param {number} behavior The desired scroll behavior: either 0 to align with
+ *     the top of the viewport or 1 to align with the bottom.
+ * @return {!webdriver.Capabilities} A self reference.
+ */
+webdriver.Capabilities.prototype.setScrollBehavior = function(behavior) {
+  return this.set(webdriver.Capability.ELEMENT_SCROLL_BEHAVIOR, behavior);
+};
+
+
+/**
+ * Sets the default action to take with an unexpected alert before returning
+ * an error.
+ * @param {string} behavior The desired behavior; should be "accept", "dismiss",
+ *     or "ignore". Defaults to "dismiss".
+ * @return {!webdriver.Capabilities} A self reference.
+ */
+webdriver.Capabilities.prototype.setAlertBehavior = function(behavior) {
+  return this.set(webdriver.Capability.UNEXPECTED_ALERT_BEHAVIOR, behavior);
+};
diff --git a/lib/webdriver/command.js b/lib/webdriver/command.js
index 5c3d95a..f501179 100644
--- a/lib/webdriver/command.js
+++ b/lib/webdriver/command.js
@@ -1,16 +1,19 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Contains several classes for handling commands.
@@ -199,9 +202,9 @@ webdriver.CommandName = {
   // optional for these commands.
   CLICK: 'mouseClick',
   DOUBLE_CLICK: 'mouseDoubleClick',
-  MOUSE_DOWN: 'mouseDown',
-  MOUSE_UP: 'mouseUp',
-  MOVE_TO: 'mouseMove',
+  MOUSE_DOWN: 'mouseButtonDown',
+  MOUSE_UP: 'mouseButtonUp',
+  MOVE_TO: 'mouseMoveTo',
   SEND_KEYS_TO_ACTIVE_ELEMENT: 'sendKeysToActiveElement',
 
   // These belong to the Advanced Touch API
@@ -216,13 +219,16 @@ webdriver.CommandName = {
 
   GET_AVAILABLE_LOG_TYPES: 'getAvailableLogTypes',
   GET_LOG: 'getLog',
-  GET_SESSION_LOGS: 'getSessionLogs'
+  GET_SESSION_LOGS: 'getSessionLogs',
+
+  // Non-standard commands used by the standalone Selenium server.
+  UPLOAD_FILE: 'uploadFile'
 };
 
 
 
 /**
- * Handles the execution of {@code webdriver.Command} objects.
+ * Handles the execution of WebDriver {@link webdriver.Command commands}.
  * @interface
  */
 webdriver.CommandExecutor = function() {};
diff --git a/lib/webdriver/events.js b/lib/webdriver/events.js
index a420163..cad3bac 100644
--- a/lib/webdriver/events.js
+++ b/lib/webdriver/events.js
@@ -1,16 +1,19 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview A light weight event system modeled after Node's EventEmitter.
diff --git a/lib/webdriver/firefoxdomexecutor.js b/lib/webdriver/firefoxdomexecutor.js
index b581f67..397cbaf 100644
--- a/lib/webdriver/firefoxdomexecutor.js
+++ b/lib/webdriver/firefoxdomexecutor.js
@@ -1,23 +1,26 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 goog.provide('webdriver.FirefoxDomExecutor');
 
 goog.require('bot.response');
-goog.require('goog.json');
 goog.require('goog.userAgent.product');
 goog.require('webdriver.Command');
+goog.require('webdriver.CommandExecutor');
 goog.require('webdriver.CommandName');
 
 
@@ -113,12 +116,9 @@ webdriver.FirefoxDomExecutor.prototype.execute = function(command, callback) {
       command.getName() != webdriver.CommandName.SWITCH_TO_FRAME) {
     parameters['id'] = parameters['id']['ELEMENT'];
   }
-
-  var json = goog.json.serialize({
+  var json = JSON.stringify({
     'name': command.getName(),
-    'sessionId': {
-      'value': parameters['sessionId']
-    },
+    'sessionId': parameters['sessionId'],
     'parameters': parameters
   });
   this.docElement_.setAttribute(
@@ -155,7 +155,7 @@ webdriver.FirefoxDomExecutor.prototype.onResponse_ = function() {
 
   try {
     var response = bot.response.checkResponse(
-        /** @type {!bot.response.ResponseObject} */ (goog.json.parse(json)));
+        /** @type {!bot.response.ResponseObject} */ (JSON.parse(json)));
   } catch (ex) {
     command.callback(ex);
     return;
diff --git a/lib/webdriver/http/corsclient.js b/lib/webdriver/http/corsclient.js
index b0ea15a..262106b 100644
--- a/lib/webdriver/http/corsclient.js
+++ b/lib/webdriver/http/corsclient.js
@@ -1,20 +1,23 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 goog.provide('webdriver.http.CorsClient');
 
-goog.require('goog.json');
+goog.require('webdriver.http.Client');
 goog.require('webdriver.http.Response');
 
 
@@ -47,10 +50,10 @@ goog.require('webdriver.http.Response');
  *     This limitation appears to be intentional and is documented in WebKit's
  *     Layout tests:
  *     //LayoutTests/http/tests/xmlhttprequest/access-control-and-redirects.html
- *   <li>If the server does not return a 2xx response, IE and Opera's
- *     implementations will fire the XDomainRequest/XMLHttpRequest object's
+ *   <li>If the server does not return a 2xx response, IE
+ *     implementation will fire the XDomainRequest/XMLHttpRequest object's
  *     onerror handler, but without the corresponding response text returned by
- *     the server. This renders IE and Opera incapable of handling command
+ *     the server. This renders IE incapable of handling command
  *     failures in the standard JSON protocol.
  * </ul>
  *
@@ -58,7 +61,7 @@ goog.require('webdriver.http.Response');
  * @constructor
  * @implements {webdriver.http.Client}
  * @see <a href="http://www.w3.org/TR/cors/">CORS Spec</a>
- * @see <a href="http://code.google.com/p/selenium/wiki/JsonWireProtocol">
+ * @see <a href="https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol">
  *     JSON wire protocol</a>
  */
 webdriver.http.CorsClient = function(url) {
@@ -119,7 +122,7 @@ webdriver.http.CorsClient.prototype.send = function(request, callback) {
     // optimized away by the compiler, which leaves us where we were before.
     xhr.onprogress = xhr.ontimeout = function() {};
 
-    xhr.send(goog.json.serialize({
+    xhr.send(JSON.stringify({
       'method': request.method,
       'path': request.path,
       'data': request.data
diff --git a/lib/webdriver/http/http.js b/lib/webdriver/http/http.js
index 3adff37..ab0d1bd 100644
--- a/lib/webdriver/http/http.js
+++ b/lib/webdriver/http/http.js
@@ -1,16 +1,19 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Defines a {@code webdriver.CommandExecutor} that communicates
@@ -24,9 +27,10 @@ goog.provide('webdriver.http.Response');
 
 goog.require('bot.ErrorCode');
 goog.require('goog.array');
-goog.require('goog.json');
+goog.require('webdriver.CommandExecutor');
 goog.require('webdriver.CommandName');
-goog.require('webdriver.promise.Deferred');
+goog.require('webdriver.logging');
+goog.require('webdriver.promise');
 
 
 
@@ -41,9 +45,9 @@ webdriver.http.Client = function() {
 /**
  * Sends a request to the server. If an error occurs while sending the request,
  * such as a failure to connect to the server, the provided callback will be
- * invoked with a non-null {@code Error} describing the error. Otherwise, when
+ * invoked with a non-null {@link Error} describing the error. Otherwise, when
  * the server's response has been received, the callback will be invoked with a
- * null Error and non-null {@code webdriver.http.Response} object.
+ * null Error and non-null {@link webdriver.http.Response} object.
  *
  * @param {!webdriver.http.Request} request The request to send.
  * @param {function(Error, !webdriver.http.Response=)} callback the function to
@@ -69,12 +73,43 @@ webdriver.http.Executor = function(client) {
    * @private {!webdriver.http.Client}
    */
   this.client_ = client;
+
+  /**
+   * @private {!Object<{method:string, path:string}>}
+   */
+  this.customCommands_ = {};
+
+  /**
+   * @private {!webdriver.logging.Logger}
+   */
+  this.log_ = webdriver.logging.getLogger('webdriver.http.Executor');
+};
+
+
+/**
+ * Defines a new command for use with this executor. When a command is sent,
+ * the {@code path} will be preprocessed using the command's parameters; any
+ * path segments prefixed with ":" will be replaced by the parameter of the
+ * same name. For example, given "/person/:name" and the parameters
+ * "{name: 'Bob'}", the final command path will be "/person/Bob".
+ *
+ * @param {string} name The command name.
+ * @param {string} method The HTTP method to use when sending this command.
+ * @param {string} path The path to send the command to, relative to
+ *     the WebDriver server's command root and of the form
+ *     "/path/:variable/segment".
+ */
+webdriver.http.Executor.prototype.defineCommand = function(
+    name, method, path) {
+  this.customCommands_[name] = {method: method, path: path};
 };
 
 
 /** @override */
 webdriver.http.Executor.prototype.execute = function(command, callback) {
-  var resource = webdriver.http.Executor.COMMAND_MAP_[command.getName()];
+  var resource =
+      this.customCommands_[command.getName()] ||
+      webdriver.http.Executor.COMMAND_MAP_[command.getName()];
   if (!resource) {
     throw new Error('Unrecognized command: ' + command.getName());
   }
@@ -84,13 +119,22 @@ webdriver.http.Executor.prototype.execute = function(command, callback) {
   var request = new webdriver.http.Request(resource.method, path, parameters);
   request.headers['connection'] = command.getName() == 'quit'? 'close' : 'keep-alive';
 
+  var log = this.log_;
+  log.finer(function() {
+    return '>>>\n' + request;
+  });
+
   this.client_.send(request, function(e, response) {
     var responseObj;
     if (!e) {
+      log.finer(function() {
+        return '<<<\n' + response;
+      });
       try {
         responseObj = webdriver.http.Executor.parseHttpResponse_(
             /** @type {!webdriver.http.Response} */ (response));
       } catch (ex) {
+        log.warning('Error parsing response', ex);
         e = ex;
       }
     }
@@ -145,7 +189,7 @@ webdriver.http.Executor.buildPath_ = function(path, parameters) {
  */
 webdriver.http.Executor.parseHttpResponse_ = function(httpResponse) {
   try {
-    return /** @type {!bot.response.ResponseObject} */ (goog.json.parse(
+    return /** @type {!bot.response.ResponseObject} */ (JSON.parse(
         httpResponse.body));
   } catch (ex) {
     // Whoops, looks like the server sent us a malformed response. We'll need
@@ -280,6 +324,22 @@ webdriver.http.Executor.COMMAND_MAP_ = (function() {
       put(webdriver.CommandName.MOVE_TO, post('/session/:sessionId/moveto')).
       put(webdriver.CommandName.SEND_KEYS_TO_ACTIVE_ELEMENT,
           post('/session/:sessionId/keys')).
+      put(webdriver.CommandName.TOUCH_SINGLE_TAP,
+          post('/session/:sessionId/touch/click')).
+      put(webdriver.CommandName.TOUCH_DOUBLE_TAP,
+          post('/session/:sessionId/touch/doubleclick')).
+      put(webdriver.CommandName.TOUCH_DOWN,
+          post('/session/:sessionId/touch/down')).
+      put(webdriver.CommandName.TOUCH_UP,
+          post('/session/:sessionId/touch/up')).
+      put(webdriver.CommandName.TOUCH_MOVE,
+          post('/session/:sessionId/touch/move')).
+      put(webdriver.CommandName.TOUCH_SCROLL,
+          post('/session/:sessionId/touch/scroll')).
+      put(webdriver.CommandName.TOUCH_LONG_PRESS,
+          post('/session/:sessionId/touch/longclick')).
+      put(webdriver.CommandName.TOUCH_FLICK,
+          post('/session/:sessionId/touch/flick')).
       put(webdriver.CommandName.ACCEPT_ALERT,
           post('/session/:sessionId/accept_alert')).
       put(webdriver.CommandName.DISMISS_ALERT,
@@ -292,6 +352,7 @@ webdriver.http.Executor.COMMAND_MAP_ = (function() {
       put(webdriver.CommandName.GET_AVAILABLE_LOG_TYPES,
           get('/session/:sessionId/log/types')).
       put(webdriver.CommandName.GET_SESSION_LOGS, post('/logs')).
+      put(webdriver.CommandName.UPLOAD_FILE, post('/session/:sessionId/file')).
       build();
 
   /** @constructor */
@@ -334,7 +395,7 @@ webdriver.http.headersToString_ = function(headers) {
 /**
  * Describes a partial HTTP request. This class is a "partial" request and only
  * defines the path on the server to send a request to. It is each
- * {@code webdriver.http.Client}'s responsibility to build the full URL for the
+ * {@link webdriver.http.Client}'s responsibility to build the full URL for the
  * final request.
  * @param {string} method The HTTP method to use for the request.
  * @param {string} path Path on the server to send the request to.
@@ -375,7 +436,7 @@ webdriver.http.Request.prototype.toString = function() {
     this.method + ' ' + this.path + ' HTTP/1.1',
     webdriver.http.headersToString_(this.headers),
     '',
-    goog.json.serialize(this.data)
+    JSON.stringify(this.data)
   ].join('\n');
 };
 
@@ -415,8 +476,8 @@ webdriver.http.Response = function(status, headers, body) {
 
 
 /**
- * Builds a {@code webdriver.http.Response} from a {@code XMLHttpRequest} or
- * {@code XDomainRequest} response object.
+ * Builds a {@link webdriver.http.Response} from a {@link XMLHttpRequest} or
+ * {@link XDomainRequest} response object.
  * @param {!(XDomainRequest|XMLHttpRequest)} xhr The request to parse.
  * @return {!webdriver.http.Response} The parsed response.
  */
diff --git a/lib/webdriver/http/xhrclient.js b/lib/webdriver/http/xhrclient.js
index 4f69fc3..58c69a3 100644
--- a/lib/webdriver/http/xhrclient.js
+++ b/lib/webdriver/http/xhrclient.js
@@ -1,23 +1,26 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /** @fileoverview A XHR client. */
 
 goog.provide('webdriver.http.XhrClient');
 
-goog.require('goog.json');
 goog.require('goog.net.XmlHttp');
+goog.require('webdriver.http.Client');
 goog.require('webdriver.http.Response');
 
 
@@ -57,7 +60,7 @@ webdriver.http.XhrClient.prototype.send = function(request, callback) {
       xhr.setRequestHeader(header, request.headers[header] + '');
     }
 
-    xhr.send(goog.json.serialize(request.data));
+    xhr.send(JSON.stringify(request.data));
   } catch (ex) {
     callback(ex);
   }
diff --git a/lib/webdriver/key.js b/lib/webdriver/key.js
index e231581..af8ba61 100644
--- a/lib/webdriver/key.js
+++ b/lib/webdriver/key.js
@@ -1,16 +1,19 @@
-// Copyright 2012 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 goog.provide('webdriver.Key');
 
diff --git a/lib/webdriver/locators.js b/lib/webdriver/locators.js
index 8d993d8..fde52e9 100644
--- a/lib/webdriver/locators.js
+++ b/lib/webdriver/locators.js
@@ -1,16 +1,19 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Factory methods for the supported locator strategies.
@@ -73,14 +76,13 @@ goog.exportSymbol('By', webdriver.By);
 /**
  * Short-hand expressions for the primary element locator strategies.
  * For example the following two statements are equivalent:
- * <code><pre>
- * var e1 = driver.findElement(webdriver.By.id('foo'));
- * var e2 = driver.findElement({id: 'foo'});
- * </pre></code>
  *
- * <p>Care should be taken when using JavaScript minifiers (such as the
+ *     var e1 = driver.findElement(webdriver.By.id('foo'));
+ *     var e2 = driver.findElement({id: 'foo'});
+ *
+ * Care should be taken when using JavaScript minifiers (such as the
  * Closure compiler), as locator hashes will always be parsed using
- * the un-obfuscated properties listed below.
+ * the un-obfuscated properties listed.
  *
  * @typedef {(
  *     {className: string}|
@@ -111,7 +113,7 @@ webdriver.By.className = webdriver.Locator.factory_('class name');
 /**
  * Locates elements using a CSS selector. For browsers that do not support
  * CSS selectors, WebDriver implementations may return an
- * {@link bot.Error.State.INVALID_SELECTOR invalid selector} error. An
+ * {@linkplain bot.Error.State.INVALID_SELECTOR invalid selector} error. An
  * implementation may, however, emulate the CSS selector API.
  *
  * @param {string} selector The CSS selector to use.
@@ -131,7 +133,7 @@ webdriver.By.id = webdriver.Locator.factory_('id');
 
 
 /**
- * Locates link elements whose {@link webdriver.WebElement#getText visible
+ * Locates link elements whose {@linkplain webdriver.WebElement#getText visible
  * text} matches the given string.
  *
  * @param {string} text The link text to search for.
@@ -142,7 +144,7 @@ webdriver.By.linkText = webdriver.Locator.factory_('link text');
 
 /**
  * Locates an elements by evaluating a
- * {@link webdriver.WebDriver#executeScript JavaScript expression}.
+ * {@linkplain webdriver.WebDriver#executeScript JavaScript expression}.
  * The result of this expression must be an element or list of elements.
  *
  * @param {!(string|Function)} script The script to execute.
@@ -168,7 +170,7 @@ webdriver.By.name = webdriver.Locator.factory_('name');
 
 
 /**
- * Locates link elements whose {@link webdriver.WebElement#getText visible
+ * Locates link elements whose {@linkplain webdriver.WebElement#getText visible
  * text} contains the given substring.
  *
  * @param {string} text The substring to check for in a link's visible text.
@@ -180,7 +182,9 @@ webdriver.By.partialLinkText = webdriver.Locator.factory_(
 
 /**
  * Locates elements with a given tag name. The returned locator is
- * equivalent to using the {@code getElementsByTagName} DOM function.
+ * equivalent to using the
+ * [getElementsByTagName](https://developer.mozilla.org/en-US/docs/Web/API/Element.getElementsByTagName)
+ * DOM function.
  *
  * @param {string} text The substring to check for in a link's visible text.
  * @return {!webdriver.Locator} The new locator.
diff --git a/lib/webdriver/logging.js b/lib/webdriver/logging.js
index 775f758..985cee8 100644
--- a/lib/webdriver/logging.js
+++ b/lib/webdriver/logging.js
@@ -1,49 +1,176 @@
-// Copyright 2013 Selenium comitters
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Defines WebDriver's logging system. The logging system is
+ * broken into major components: local and remote logging.
+ *
+ * The local logging API, which is anchored by the
+ * {@link webdriver.logging.Logger Logger} class, is similar to Java's
+ * logging API. Loggers, retrieved by {@link webdriver.logging.getLogger}, use
+ * hierarchical, dot-delimited namespaces
+ * (e.g. "" > "webdriver" > "webdriver.logging"). Recorded log messages are
+ * represented by the {@link webdriver.logging.LogRecord LogRecord} class. You
+ * can capture log records by
+ * {@linkplain webdriver.logging.Logger#addHandler attaching} a handler function
+ * to the desired logger. For convenience, you can quickly enable logging to
+ * the console by simply calling
+ * {@link webdriver.logging.installConsoleHandler()}.
+ *
+ * The [remote logging API](https://github.com/SeleniumHQ/selenium/wiki/Logging)
+ * allows you to retrieve logs from a remote WebDriver server. This API uses the
+ * {@link Preferences} class to define desired log levels prior to create a
+ * WebDriver session:
+ *
+ *     var prefs = new webdriver.logging.Preferences();
+ *     prefs.setLevel(webdriver.logging.Type.BROWSER,
+ *                    webdriver.logging.Level.DEBUG);
+ *
+ *     var caps = webdriver.Capabilities.chrome();
+ *     caps.setLoggingPrefs(prefs);
+ *     // ...
+ *
+ * Remote log entries are represented by the {@link Entry} class and may be
+ * retrieved via {@link webdriver.WebDriver.Logs}:
+ *
+ *     driver.manage().logs().get(webdriver.logging.Type.BROWSER)
+ *         .then(function(entries) {
+ *            entries.forEach(function(entry) {
+ *              console.log('[%s] %s', entry.level.name, entry.message);
+ *            });
+ *         });
+ *
+ * **NOTE:** Only a few browsers support the remote logging API (notably
+ * Firefox and Chrome). Firefox supports basic logging functionality, while
+ * Chrome exposes robust
+ * [performance logging](https://sites.google.com/a/chromium.org/chromedriver/logging)
+ * options. Remote logging is still considered a non-standard feature, and the
+ * APIs exposed by this module for it are non-frozen. Once logging is officially
+ * defined by the [W3C WebDriver spec](http://www.w3.org/TR/webdriver/), this
+ * module will be updated to use a consistent API for local and remote logging.
+ */
+
+goog.module('webdriver.logging');
+goog.module.declareLegacyNamespace();
+
+var LogManager = goog.require('goog.debug.LogManager');
+var LogRecord = goog.require('goog.debug.LogRecord');
+var Logger = goog.require('goog.debug.Logger');
+var Objects = goog.require('goog.object');
+var padNumber = goog.require('goog.string').padNumber;
+
 
-goog.provide('webdriver.logging');
-goog.provide('webdriver.logging.Preferences');
+/** @const */
+exports.LogRecord = LogRecord;
 
-goog.require('goog.object');
+
+/** @const */
+exports.Logger = Logger;
+
+
+/** @const */
+exports.Level = Logger.Level;
 
 
 /**
- * Log level names from WebDriver's JSON wire protocol.
- * @enum {string}
+ * DEBUG is a message level for debugging messages and has the same log level
+ * as the {@link Logger.Level.CONFIG} message level.
+ * @const {!Logger.Level}
+ */
+Logger.Level.DEBUG = new Logger.Level('DEBUG', Logger.Level.CONFIG.value);
+
+
+/**
+ * Finds a named logger.
+ *
+ * @param {string=} opt_name The dot-delimited logger name, such as
+ *     "webdriver.logging.Logger". Defaults to the name of the root logger.
+ * @return {!Logger} The named logger.
+ */
+function getLogger(opt_name) {
+  return LogManager.getLogger(opt_name || Logger.ROOT_LOGGER_NAME);
+}
+exports.getLogger = getLogger;
+
+
+/**
+ * Logs all messages to the Console API.
+ */
+function consoleHandler(record) {
+  if (typeof console === 'undefined' || !console) {
+    return;
+  }
+  record = /** @type {!LogRecord} */(record);
+  var timestamp = new Date(record.getMillis());
+  var msg =
+      '[' + timestamp.getUTCFullYear() + '-' +
+      padNumber(timestamp.getUTCMonth() + 1, 2) + '-' +
+      padNumber(timestamp.getUTCDate(), 2) + 'T' +
+      padNumber(timestamp.getUTCHours(), 2) + ':' +
+      padNumber(timestamp.getUTCMinutes(), 2) + ':' +
+      padNumber(timestamp.getUTCSeconds(), 2) + 'Z]' +
+      '[' + record.getLevel().name + ']' +
+      '[' + record.getLoggerName() + '] ' +
+      record.getMessage();
+
+  var level = record.getLevel().value;
+  if (level >= Logger.Level.SEVERE.value) {
+    console.error(msg);
+  } else if (level >= Logger.Level.WARNING.value) {
+    console.warn(msg);
+  } else {
+    console.log(msg);
+  }
+}
+
+
+/**
+ * Adds the console handler to the given logger. The console handler will log
+ * all messages using the JavaScript Console API.
+ *
+ * @param {Logger=} opt_logger The logger to add the handler to; defaults
+ *     to the root logger.
+ * @see exports.removeConsoleHandler
  */
-webdriver.logging.LevelName = {
-  ALL: 'ALL',
-  DEBUG: 'DEBUG',
-  INFO: 'INFO',
-  WARNING: 'WARNING',
-  SEVERE: 'SEVERE',
-  OFF: 'OFF'
+exports.addConsoleHandler = function(opt_logger) {
+  var logger = opt_logger || getLogger();
+  logger.addHandler(consoleHandler);
 };
 
 
 /**
- * Logging levels.
- * @enum {{value: number, name: webdriver.logging.LevelName}}
+ * Installs the console log handler on the root logger.
+ * @see exports.addConsoleHandler
  */
-webdriver.logging.Level = {
-  ALL: {value: Number.MIN_VALUE, name: webdriver.logging.LevelName.ALL},
-  DEBUG: {value: 700, name: webdriver.logging.LevelName.DEBUG},
-  INFO: {value: 800, name: webdriver.logging.LevelName.INFO},
-  WARNING: {value: 900, name: webdriver.logging.LevelName.WARNING},
-  SEVERE: {value: 1000, name: webdriver.logging.LevelName.SEVERE},
-  OFF: {value: Number.MAX_VALUE, name: webdriver.logging.LevelName.OFF}
+exports.installConsoleHandler = function() {
+  exports.addConsoleHandler();
+};
+
+
+/**
+ * Removes the console log handler from the given logger.
+ *
+ * @param {Logger=} opt_logger The logger to remove the handler from; defaults
+ *     to the root logger.
+ * @see exports.addConsoleHandler
+ */
+exports.removeConsoleHandler = function(opt_logger) {
+  var logger = opt_logger || getLogger();
+  logger.removeHandler(consoleHandler);
 };
 
 
@@ -53,23 +180,58 @@ webdriver.logging.Level = {
  * will be returned.
  * @param {(number|string)} nameOrValue The log level name, or value, to
  *     convert .
- * @return {!webdriver.logging.Level} The converted level.
+ * @return {!Logger.Level} The converted level.
  */
-webdriver.logging.getLevel = function(nameOrValue) {
-  var predicate = goog.isString(nameOrValue) ?
-      function(val) { return val.name === nameOrValue; } :
-      function(val) { return val.value === nameOrValue; };
+function getLevel(nameOrValue) {
+  // DEBUG is not a predefined Closure log level, but maps to CONFIG. Since
+  // DEBUG is a predefined level for the WebDriver protocol, we prefer it over
+  // CONFIG.
+  if ('DEBUG' === nameOrValue || Logger.Level.DEBUG.value === nameOrValue) {
+    return Logger.Level.DEBUG;
+  } else if (goog.isString(nameOrValue)) {
+    return Logger.Level.getPredefinedLevel(/** @type {string} */(nameOrValue))
+        || Logger.Level.ALL;
+  } else {
+    return Logger.Level.getPredefinedLevelByValue(
+        /** @type {number} */(nameOrValue)) || Logger.Level.ALL;
+  }
+}
+exports.getLevel = getLevel;
 
-  return goog.object.findValue(webdriver.logging.Level, predicate) ||
-      webdriver.logging.Level.ALL;
-};
+
+/**
+ * Normalizes a {@link Logger.Level} to one of the distinct values recognized
+ * by WebDriver's wire protocol.
+ * @param {!Logger.Level} level The input level.
+ * @return {!Logger.Level} The normalized level.
+ */
+function normalizeLevel(level) {
+  if (level.value <= Logger.Level.ALL.value) {          // ALL is 0.
+    return Logger.Level.ALL;
+
+  } else if (level.value === Logger.Level.OFF.value) {  // OFF is Infinity
+    return Logger.Level.OFF;
+
+  } else if (level.value < Logger.Level.INFO.value) {
+    return Logger.Level.DEBUG;
+
+  } else if (level.value < Logger.Level.WARNING.value) {
+    return Logger.Level.INFO;
+
+  } else if (level.value < Logger.Level.SEVERE.value) {
+    return Logger.Level.WARNING;
+
+  } else {
+    return Logger.Level.SEVERE;
+  }
+}
 
 
 /**
  * Common log types.
  * @enum {string}
  */
-webdriver.logging.Type = {
+var Type = {
   /** Logs originating from the browser. */
   BROWSER: 'browser',
   /** Logs from a WebDriver client. */
@@ -81,78 +243,105 @@ webdriver.logging.Type = {
   /** Logs from the remote server. */
   SERVER: 'server'
 };
+exports.Type = Type;
 
 
 /**
- * A hash describing log preferences.
- * @typedef {Object.<webdriver.logging.Type, webdriver.logging.LevelName>}
+ * Describes the log preferences for a WebDriver session.
+ * @final
  */
-webdriver.logging.Preferences;
+var Preferences = goog.defineClass(null, {
+  /** @constructor */
+  constructor: function() {
+    /** @private {!Object.<string, Logger.Level>} */
+    this.prefs_ = {};
+  },
+
+  /**
+   * Sets the desired logging level for a particular log type.
+   * @param {(string|Type)} type The log type.
+   * @param {!Logger.Level} level The desired log level.
+   */
+  setLevel: function(type, level) {
+    this.prefs_[type] = normalizeLevel(level);
+  },
+
+  /**
+   * Converts this instance to its JSON representation.
+   * @return {!Object.<string, string>} The JSON representation of this set of
+   *     preferences.
+   */
+  toJSON: function() {
+    var obj = {};
+    for (var type in this.prefs_) {
+      if (this.prefs_.hasOwnProperty(type)) {
+        obj[type] = this.prefs_[type].name;
+      }
+    }
+    return obj;
+  }
+});
+exports.Preferences = Preferences;
 
 
 /**
- * A single log entry.
- * @param {(!webdriver.logging.Level|string)} level The entry level.
- * @param {string} message The log message.
- * @param {number=} opt_timestamp The time this entry was generated, in
- *     milliseconds since 0:00:00, January 1, 1970 UTC. If omitted, the
- *     current time will be used.
- * @param {string=} opt_type The log type, if known.
- * @constructor
+ * A single log entry recorded by a WebDriver component, such as a remote
+ * WebDriver server.
+ * @final
  */
-webdriver.logging.Entry = function(level, message, opt_timestamp, opt_type) {
+var Entry = goog.defineClass(null, {
+  /**
+   * @param {(!Logger.Level|string)} level The entry level.
+   * @param {string} message The log message.
+   * @param {number=} opt_timestamp The time this entry was generated, in
+   *     milliseconds since 0:00:00, January 1, 1970 UTC. If omitted, the
+   *     current time will be used.
+   * @param {string=} opt_type The log type, if known.
+   * @constructor
+   */
+  constructor: function(level, message, opt_timestamp, opt_type) {
 
-  /** @type {!webdriver.logging.Level} */
-  this.level =
-      goog.isString(level) ? webdriver.logging.getLevel(level) : level;
+    /** @type {!Logger.Level} */
+    this.level = goog.isString(level) ? getLevel(level) : level;
 
-  /** @type {string} */
-  this.message = message;
+    /** @type {string} */
+    this.message = message;
 
-  /** @type {number} */
-  this.timestamp = goog.isNumber(opt_timestamp) ? opt_timestamp : goog.now();
+    /** @type {number} */
+    this.timestamp = goog.isNumber(opt_timestamp) ? opt_timestamp : goog.now();
 
-  /** @type {string} */
-  this.type = opt_type || '';
-};
+    /** @type {string} */
+    this.type = opt_type || '';
+  },
 
+  statics: {
+    /**
+     * Converts a {@link goog.debug.LogRecord} into a
+     * {@link webdriver.logging.Entry}.
+     * @param {!goog.debug.LogRecord} logRecord The record to convert.
+     * @param {string=} opt_type The log type.
+     * @return {!Entry} The converted entry.
+     */
+    fromClosureLogRecord: function(logRecord, opt_type) {
+      return new Entry(
+          normalizeLevel(/** @type {!Logger.Level} */(logRecord.getLevel())),
+          '[' + logRecord.getLoggerName() + '] ' + logRecord.getMessage(),
+          logRecord.getMillis(),
+          opt_type);
+    }
+  },
 
-/**
- * @return {{level: string, message: string, timestamp: number,
- *           type: string}} The JSON representation of this entry.
- */
-webdriver.logging.Entry.prototype.toJSON = function() {
-  return {
-    'level': this.level.name,
-    'message': this.message,
-    'timestamp': this.timestamp,
-    'type': this.type
-  };
-};
-
-
-/**
- * Converts a {@link goog.debug.LogRecord} into a
- * {@link webdriver.logging.Entry}.
- * @param {!goog.debug.LogRecord} logRecord The record to convert.
- * @param {string=} opt_type The log type.
- * @return {!webdriver.logging.Entry} The converted entry.
- */
-webdriver.logging.Entry.fromClosureLogRecord = function(logRecord, opt_type) {
-  var closureLevel = logRecord.getLevel();
-  var level = webdriver.logging.Level.SEVERE;
-
-  if (closureLevel.value <= webdriver.logging.Level.DEBUG.value) {
-    level = webdriver.logging.Level.DEBUG;
-  } else if (closureLevel.value <= webdriver.logging.Level.INFO.value) {
-    level = webdriver.logging.Level.INFO;
-  } else if (closureLevel.value <= webdriver.logging.Level.WARNING.value) {
-    level = webdriver.logging.Level.WARNING;
+  /**
+   * @return {{level: string, message: string, timestamp: number,
+   *           type: string}} The JSON representation of this entry.
+   */
+  toJSON: function() {
+    return {
+      'level': this.level.name,
+      'message': this.message,
+      'timestamp': this.timestamp,
+      'type': this.type
+    };
   }
-
-  return new webdriver.logging.Entry(
-      level,
-      '[' + logRecord.getLoggerName() + '] ' + logRecord.getMessage(),
-      logRecord.getMillis(),
-      opt_type);
-};
+});
+exports.Entry = Entry;
diff --git a/lib/webdriver/promise.js b/lib/webdriver/promise.js
index 59dc609..9347ef1 100644
--- a/lib/webdriver/promise.js
+++ b/lib/webdriver/promise.js
@@ -1,16 +1,19 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @license Portions of this code are from the Dojo toolkit, received under the
@@ -41,534 +44,1386 @@
  */
 
 /**
- * @fileoverview A promise implementation based on the CommonJS promise/A and
- * promise/B proposals. For more information, see
- * http://wiki.commonjs.org/wiki/Promises.
+ * @fileoverview
+ * The promise module is centered around the
+ * {@linkplain webdriver.promise.ControlFlow ControlFlow}, a class that
+ * coordinates the execution of asynchronous tasks. The ControlFlow allows users
+ * to focus on the imperative commands for their script without worrying about
+ * chaining together every single asynchronous action, which can be tedious and
+ * verbose. APIs may be layered on top of the control flow to read as if they
+ * were synchronous. For instance, the core
+ * {@linkplain webdriver.WebDriver WebDriver} API is built on top of the
+ * control flow, allowing users to write
+ *
+ *     driver.get('http://www.google.com/ncr');
+ *     driver.findElement({name: 'q'}).sendKeys('webdriver');
+ *     driver.findElement({name: 'btnGn'}).click();
+ *
+ * instead of
+ *
+ *     driver.get('http://www.google.com/ncr')
+ *     .then(function() {
+ *       return driver.findElement({name: 'q'});
+ *     })
+ *     .then(function(q) {
+ *       return q.sendKeys('webdriver');
+ *     })
+ *     .then(function() {
+ *       return driver.findElement({name: 'btnG'});
+ *     })
+ *     .then(function(btnG) {
+ *       return btnG.click();
+ *     });
+ *
+ * ## Tasks and Task Queues
+ *
+ * The control flow is based on the concept of tasks and task queues. Tasks are
+ * functions that define the basic unit of work for the control flow to execute.
+ * Each task is scheduled via
+ * {@link webdriver.promise.ControlFlow#execute() ControlFlow#execute()}, which
+ * will return a {@link webdriver.promise.Promise Promise} that will be resolved
+ * with the task's result.
+ *
+ * A task queue contains all of the tasks scheduled within a single turn of the
+ * [JavaScript event loop][JSEL]. The control flow will create a new task queue
+ * the first time a task is scheduled within an event loop.
+ *
+ *     var flow = promise.controlFlow();
+ *     flow.execute(foo);       // Creates a new task queue and inserts foo.
+ *     flow.execute(bar);       // Inserts bar into the same queue as foo.
+ *     setTimeout(function() {
+ *       flow.execute(baz);     // Creates a new task queue and inserts baz.
+ *     }, 0);
+ *
+ * Whenever the control flow creates a new task queue, it will automatically
+ * begin executing tasks in the next available turn of the event loop. This
+ * execution is scheduled using a "micro-task" timer, such as a (native)
+ * `Promise.then()` callback.
+ *
+ *     setTimeout(() => console.log('a'));
+ *     Promise.resolve().then(() => console.log('b'));  // A native promise.
+ *     flow.execute(() => console.log('c'));
+ *     Promise.resolve().then(() => console.log('d'));
+ *     setTimeout(() => console.log('fin'));
+ *     // b
+ *     // c
+ *     // d
+ *     // a
+ *     // fin
+ *
+ * In the example above, b/c/d is logged before a/fin because native promises
+ * and this module use "micro-task" timers, which have a higher priority than
+ * "macro-tasks" like `setTimeout`.
+ *
+ * ## Task Execution
+ *
+ * Upon creating a task queue, and whenever an exisiting queue completes a task,
+ * the control flow will schedule a micro-task timer to process any scheduled
+ * tasks. This ensures no task is ever started within the same turn of the
+ * JavaScript event loop in which it was scheduled, nor is a task ever started
+ * within the same turn that another finishes.
+ *
+ * When the execution timer fires, a single task will be dequeued and executed.
+ * There are several important events that may occur while executing a task
+ * function:
+ *
+ * 1. A new task queue is created by a call to
+ *    {@link webdriver.promise.ControlFlow#execute ControlFlow#execute()}. Any
+ *    tasks scheduled within this task queue are considered subtasks of the
+ *    current task.
+ * 2. The task function throws an error. Any scheduled tasks are immediately
+ *    discarded and the task's promised result (previously returned by
+ *    {@link webdriver.promise.ControlFlow#execute ControlFlow#execute()}) is
+ *    immediately rejected with the thrown error.
+ * 3. The task function returns sucessfully.
+ *
+ * If a task function created a new task queue, the control flow will wait for
+ * that queue to complete before processing the task result. If the queue
+ * completes without error, the flow will settle the task's promise with the
+ * value originaly returned by the task function. On the other hand, if the task
+ * queue termintes with an error, the task's promise will be rejected with that
+ * error.
+ *
+ *     flow.execute(function() {
+ *       flow.execute(() => console.log('a'));
+ *       flow.execute(() => console.log('b'));
+ *     });
+ *     flow.execute(() => console.log('c'));
+ *     // a
+ *     // b
+ *     // c
+ *
+ * ## Promise Integration
+ *
+ * In addition to the {@link webdriver.promise.ControlFlow ControlFlow} class,
+ * the promise module also exports a [Promise/A+]
+ * {@linkplain webdriver.promise.Promise implementation} that is deeply
+ * integrated with the ControlFlow. First and foremost, each promise
+ * {@linkplain webdriver.promise.Promise#then() callback} is scheduled with the
+ * control flow as a task. As a result, each callback is invoked in its own turn
+ * of the JavaScript event loop with its own task queue. If any tasks are
+ * scheduled within a callback, the callback's promised result will not be
+ * settled until the task queue has completed.
+ *
+ *     promise.fulfilled().then(function() {
+ *       flow.execute(function() {
+ *         console.log('b');
+ *       });
+ *     }).then(() => console.log('a'));
+ *     // b
+ *     // a
+ *
+ * ### Scheduling Promise Callbacks <a id="scheduling_callbacks"></a>
+ *
+ * How callbacks are scheduled in the control flow depends on when they are
+ * attached to the promise. Callbacks attached to a _previously_ resolved
+ * promise are immediately enqueued as subtasks of the currently running task.
+ *
+ *     var p = promise.fulfilled();
+ *     flow.execute(function() {
+ *       flow.execute(() => console.log('A'));
+ *       p.then(      () => console.log('B'));
+ *       flow.execute(() => console.log('C'));
+ *       p.then(      () => console.log('D'));
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // A
+ *     // B
+ *     // C
+ *     // D
+ *     // fin
+ *
+ * When a promise is resolved while a task function is on the call stack, any
+ * callbacks also registered in that stack frame are scheduled as if the promise
+ * were already resolved:
+ *
+ *     var d = promise.defer();
+ *     flow.execute(function() {
+ *       flow.execute(  () => console.log('A'));
+ *       d.promise.then(() => console.log('B'));
+ *       flow.execute(  () => console.log('C'));
+ *       d.promise.then(() => console.log('D'));
+ *
+ *       d.fulfill();
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // A
+ *     // B
+ *     // C
+ *     // D
+ *     // fin
+ *
+ * If a promise is resolved while a task function is on the call stack, any
+ * previously registered callbacks (i.e. attached while the task was _not_ on
+ * the call stack), act as _interrupts_ and are inserted at the front of the
+ * task queue. If multiple promises are fulfilled, their interrupts are enqueued
+ * in the order the promises are resolved.
+ *
+ *     var d1 = promise.defer();
+ *     d1.promise.then(() => console.log('A'));
+ *
+ *     var d2 = promise.defer();
+ *     d2.promise.then(() => console.log('B'));
+ *
+ *     flow.execute(function() {
+ *       flow.execute(() => console.log('C'));
+ *       flow.execute(() => console.log('D'));
+ *       d1.fulfill();
+ *       d2.fulfill();
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // A
+ *     // B
+ *     // C
+ *     // D
+ *     // fin
+ *
+ * Within a task function (or callback), each step of a promise chain acts as
+ * an interrupt on the task queue:
+ *
+ *     var d = promise.defer();
+ *     flow.execute(function() {
+ *       d.promise.
+ *           then(() => console.log('A')).
+ *           then(() => console.log('B')).
+ *           then(() => console.log('C')).
+ *           then(() => console.log('D'));
+ *
+ *       flow.execute(() => console.log('E'));
+ *       d.fulfill();
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // A
+ *     // B
+ *     // C
+ *     // D
+ *     // E
+ *     // fin
+ *
+ * If there are multiple promise chains derived from a single promise, they are
+ * processed in the order created:
+ *
+ *     var d = promise.defer();
+ *     flow.execute(function() {
+ *       var chain = d.promise.then(() => console.log('A'));
+ *
+ *       chain.then(() => console.log('B')).
+ *           then(() => console.log('C'));
+ *
+ *       chain.then(() => console.log('D')).
+ *           then(() => console.log('E'));
+ *
+ *       flow.execute(() => console.log('F'));
+ *
+ *       d.fulfill();
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // A
+ *     // B
+ *     // C
+ *     // D
+ *     // E
+ *     // F
+ *     // fin
+ *
+ * Even though a subtask's promised result will never resolve while the task
+ * function is on the stack, it will be treated as a promise resolved within the
+ * task. In all other scenarios, a task's promise behaves just like a normal
+ * promise. In the sample below, `C/D` is loggged before `B` because the
+ * resolution of `subtask1` interrupts the flow of the enclosing task. Within
+ * the final subtask, `E/F` is logged in order because `subtask1` is a resolved
+ * promise when that task runs.
+ *
+ *     flow.execute(function() {
+ *       var subtask1 = flow.execute(() => console.log('A'));
+ *       var subtask2 = flow.execute(() => console.log('B'));
+ *
+ *       subtask1.then(() => console.log('C'));
+ *       subtask1.then(() => console.log('D'));
+ *
+ *       flow.execute(function() {
+ *         flow.execute(() => console.log('E'));
+ *         subtask1.then(() => console.log('F'));
+ *       });
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // A
+ *     // C
+ *     // D
+ *     // B
+ *     // E
+ *     // F
+ *     // fin
+ *
+ * __Note__: while the ControlFlow will wait for
+ * {@linkplain webdriver.promise.ControlFlow#execute tasks} and
+ * {@linkplain webdriver.promise.Promise#then callbacks} to complete, it
+ * _will not_ wait for unresolved promises created within a task:
+ *
+ *     flow.execute(function() {
+ *       var p = new promise.Promise(function(fulfill) {
+ *         setTimeout(fulfill, 100);
+ *       });
+ *
+ *       p.then(() => console.log('promise resolved!'));
+ *
+ *     }).then(function() {
+ *       console.log('task complete!');
+ *     });
+ *     // task complete!
+ *     // promise resolved!
+ *
+ * Finally, consider the following:
+ *
+ *     var d = promise.defer();
+ *     d.promise.then(() => console.log('A'));
+ *     d.promise.then(() => console.log('B'));
+ *
+ *     flow.execute(function() {
+ *       flow.execute(  () => console.log('C'));
+ *       d.promise.then(() => console.log('D'));
+ *
+ *       flow.execute(  () => console.log('E'));
+ *       d.promise.then(() => console.log('F'));
+ *
+ *       d.fulfill();
+ *
+ *       flow.execute(  () => console.log('G'));
+ *       d.promise.then(() => console.log('H'));
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // A
+ *     // B
+ *     // C
+ *     // D
+ *     // E
+ *     // F
+ *     // G
+ *     // H
+ *     // fin
+ *
+ * In this example, callbacks are registered on `d.promise` both before and
+ * during the invocation of the task function. When `d.fulfill()` is called,
+ * the callbacks registered before the task (`A` & `B`) are registered as
+ * interrupts. The remaining callbacks were all attached within the task and
+ * are scheduled in the flow as standard tasks.
+ *
+ * ## Generator Support
+ *
+ * [Generators][GF] may be scheduled as tasks within a control flow or attached
+ * as callbacks to a promise. Each time the generator yields a promise, the
+ * control flow will wait for that promise to settle before executing the next
+ * iteration of the generator. The yielded promise's fulfilled value will be
+ * passed back into the generator:
+ *
+ *     flow.execute(function* () {
+ *       var d = promise.defer();
+ *
+ *       setTimeout(() => console.log('...waiting...'), 25);
+ *       setTimeout(() => d.fulfill(123), 50);
+ *
+ *       console.log('start: ' + Date.now());
+ *
+ *       var value = yield d.promise;
+ *       console.log('mid: %d; value = %d', Date.now(), value);
+ *
+ *       yield promise.delayed(10);
+ *       console.log('end: ' + Date.now());
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // start: 0
+ *     // ...waiting...
+ *     // mid: 50; value = 123
+ *     // end: 60
+ *     // fin
+ *
+ * Yielding the result of a promise chain will wait for the entire chain to
+ * complete:
+ *
+ *     promise.fulfilled().then(function* () {
+ *       console.log('start: ' + Date.now());
+ *
+ *       var value = yield flow.
+ *           execute(() => console.log('A')).
+ *           then(   () => console.log('B')).
+ *           then(   () => 123);
+ *
+ *       console.log('mid: %s; value = %d', Date.now(), value);
+ *
+ *       yield flow.execute(() => console.log('C'));
+ *     }).then(function() {
+ *       console.log('fin');
+ *     });
+ *     // start: 0
+ *     // A
+ *     // B
+ *     // mid: 2; value = 123
+ *     // C
+ *     // fin
+ *
+ * Yielding a _rejected_ promise will cause the rejected value to be thrown
+ * within the generator function:
+ *
+ *     flow.execute(function* () {
+ *       console.log('start: ' + Date.now());
+ *       try {
+ *         yield promise.delayed(10).then(function() {
+ *           throw Error('boom');
+ *         });
+ *       } catch (ex) {
+ *         console.log('caught time: ' + Date.now());
+ *         console.log(ex.message);
+ *       }
+ *     });
+ *     // start: 0
+ *     // caught time: 10
+ *     // boom
+ *
+ * # Error Handling
+ *
+ * ES6 promises do not require users to handle a promise rejections. This can
+ * result in subtle bugs as the rejections are silently "swallowed" by the
+ * Promise class.
+ *
+ *     Promise.reject(Error('boom'));
+ *     // ... *crickets* ...
+ *
+ * Selenium's {@link webdriver.promise promise} module, on the other hand,
+ * requires that every rejection be explicitly handled. When a
+ * {@linkplain webdriver.promise.Promise Promise} is rejected and no callbacks
+ * are defined on that promise, it is considered an _unhandled rejection_ and
+ * reproted to the active task queue. If the rejection remains unhandled after
+ * a single turn of the [event loop][JSEL] (scheduled with a micro-task), it
+ * will propagate up the stack.
+ *
+ * ## Error Propagation
+ *
+ * If an unhandled rejection occurs within a task function, that task's promised
+ * result is rejected and all remaining subtasks are discarded:
+ *
+ *     flow.execute(function() {
+ *       // No callbacks registered on promise -> unhandled rejection
+ *       promise.rejected(Error('boom'));
+ *       flow.execute(function() { console.log('this will never run'); });
+ *     }).thenCatch(function(e) {
+ *       console.log(e.message);
+ *     });
+ *     // boom
+ *
+ * The promised results for discarded tasks are silently rejected with a
+ * cancellation error and existing callback chains will never fire.
+ *
+ *     flow.execute(function() {
+ *       promise.rejected(Error('boom'));
+ *       flow.execute(function() { console.log('a'); }).
+ *           then(function() { console.log('b'); });
+ *     }).thenCatch(function(e) {
+ *       console.log(e.message);
+ *     });
+ *     // boom
+ *
+ * An unhandled rejection takes precedence over a task function's returned
+ * result, even if that value is another promise:
+ *
+ *     flow.execute(function() {
+ *       promise.rejected(Error('boom'));
+ *       return flow.execute(someOtherTask);
+ *     }).thenCatch(function(e) {
+ *       console.log(e.message);
+ *     });
+ *     // boom
+ *
+ * If there are multiple unhandled rejections within a task, they are packaged
+ * in a {@link webdriver.promise.MultipleUnhandledRejectionError
+ * MultipleUnhandledRejectionError}, which has an `errors` property that is a
+ * `Set` of the recorded unhandled rejections:
+ *
+ *     flow.execute(function() {
+ *       promise.rejected(Error('boom1'));
+ *       promise.rejected(Error('boom2'));
+ *     }).thenCatch(function(ex) {
+ *       console.log(ex instanceof promise.MultipleUnhandledRejectionError);
+ *       for (var e of ex.errors) {
+ *         console.log(e.message);
+ *       }
+ *     });
+ *     // boom1
+ *     // boom2
+ *
+ * When a subtask is discarded due to an unreported rejection in its parent
+ * frame, the existing callbacks on that task will never settle and the
+ * callbacks will not be invoked. If a new callback is attached ot the subtask
+ * _after_ it has been discarded, it is handled the same as adding a callback
+ * to a cancelled promise: the error-callback path is invoked. This behavior is
+ * intended to handle cases where the user saves a reference to a task promise,
+ * as illustrated below.
+ *
+ *     var subTask;
+ *     flow.execute(function() {
+ *       promise.rejected(Error('boom'));
+ *       subTask = flow.execute(function() {});
+ *     }).thenCatch(function(e) {
+ *       console.log(e.message);
+ *     }).then(function() {
+ *       return subTask.then(
+ *           () => console.log('subtask success!'),
+ *           (e) => console.log('subtask failed:\n' + e));
+ *     });
+ *     // boom
+ *     // subtask failed:
+ *     // DiscardedTaskError: Task was discarded due to a previous failure: boom
+ *
+ * When a subtask fails, its promised result is treated the same as any other
+ * promise: it must be handled within one turn of the rejection or the unhandled
+ * rejection is propagated to the parent task. This means users can catch errors
+ * from complex flows from the top level task:
+ *
+ *     flow.execute(function() {
+ *       flow.execute(function() {
+ *         flow.execute(function() {
+ *           throw Error('fail!');
+ *         });
+ *       });
+ *     }).thenCatch(function(e) {
+ *       console.log(e.message);
+ *     });
+ *     // fail!
+ *
+ * ## Unhandled Rejection Events
+ *
+ * When an unhandled rejection propagates to the root of the control flow, the
+ * flow will emit an __uncaughtException__ event. If no listeners are registered
+ * on the flow, the error will be rethrown to the global error handler: an
+ * __uncaughtException__ event from the
+ * [`process`](https://nodejs.org/api/process.html) object in node, or
+ * `window.onerror` when running in a browser.
+ *
+ * Bottom line: you __*must*__ handle rejected promises.
+ *
+ * # Promise/A+ Compatibility
+ *
+ * This `promise` module is compliant with the [Promise/A+][] specification
+ * except for sections `2.2.6.1` and `2.2.6.2`:
+ *
+ * >
+ * > - `then` may be called multiple times on the same promise.
+ * >    - If/when `promise` is fulfilled, all respective `onFulfilled` callbacks
+ * >      must execute in the order of their originating calls to `then`.
+ * >    - If/when `promise` is rejected, all respective `onRejected` callbacks
+ * >      must execute in the order of their originating calls to `then`.
+ * >
+ *
+ * Specifically, the conformance tests contains the following scenario (for
+ * brevity, only the fulfillment version is shown):
+ *
+ *     var p1 = Promise.resolve();
+ *     p1.then(function() {
+ *       console.log('A');
+ *       p1.then(() => console.log('B'));
+ *     });
+ *     p1.then(() => console.log('C'));
+ *     // A
+ *     // C
+ *     // B
+ *
+ * Since the [ControlFlow](#scheduling_callbacks) executes promise callbacks as
+ * tasks, with this module, the result would be
+ *
+ *     var p2 = promise.fulfilled();
+ *     p2.then(function() {
+ *       console.log('A');
+ *       p2.then(() => console.log('B');
+ *     });
+ *     p2.then(() => console.log('C'));
+ *     // A
+ *     // B
+ *     // C
+ *
+ * [JSEL]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop
+ * [GF]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*
+ * [Promise/A+]: https://promisesaplus.com/
  */
 
-goog.provide('webdriver.promise');
-goog.provide('webdriver.promise.ControlFlow');
-goog.provide('webdriver.promise.ControlFlow.Timer');
-goog.provide('webdriver.promise.Deferred');
-goog.provide('webdriver.promise.Promise');
+goog.module('webdriver.promise');
+goog.module.declareLegacyNamespace();
 
-goog.require('goog.array');
-goog.require('goog.debug.Error');
-goog.require('goog.object');
-goog.require('webdriver.EventEmitter');
-goog.require('webdriver.stacktrace.Snapshot');
+var Arrays = goog.require('goog.array');
+var asserts = goog.require('goog.asserts');
+var asyncRun = goog.require('goog.async.run');
+var throwException = goog.require('goog.async.throwException');
+var DebugError = goog.require('goog.debug.Error');
+var log = goog.require('goog.log');
+var Objects = goog.require('goog.object');
+var EventEmitter = goog.require('webdriver.EventEmitter');
+var stacktrace = goog.require('webdriver.stacktrace');
 
 
 
 /**
- * Represents the eventual value of a completed operation. Each promise may be
- * in one of three states: pending, resolved, or rejected. Each promise starts
- * in the pending state and may make a single transition to either a
- * fulfilled or failed state.
- *
- * <p/>This class is based on the Promise/A proposal from CommonJS. Additional
- * functions are provided for API compatibility with Dojo Deferred objects.
- *
- * @constructor
- * @see http://wiki.commonjs.org/wiki/Promises/A
+ * @define {boolean} Whether to append traces of {@code then} to rejection
+ *     errors.
  */
-webdriver.promise.Promise = function() {
-};
-
+goog.define('webdriver.promise.LONG_STACK_TRACES', false);
 
-/**
- * Cancels the computation of this promise's value, rejecting the promise in the
- * process.
- * @param {*} reason The reason this promise is being cancelled. If not an
- *     {@code Error}, one will be created using the value's string
- *     representation.
- */
-webdriver.promise.Promise.prototype.cancel = function(reason) {
-  throw new TypeError('Unimplemented function: "cancel"');
-};
+/** @const */
+var promise = exports;
 
 
-/** @return {boolean} Whether this promise's value is still being computed. */
-webdriver.promise.Promise.prototype.isPending = function() {
-  throw new TypeError('Unimplemented function: "isPending"');
-};
+/** @const */
+var LOG = log.getLogger('webdriver.promise');
 
 
 /**
- * Registers listeners for when this instance is resolved. This function most
- * overridden by subtypes.
- *
- * @param {Function=} opt_callback The function to call if this promise is
- *     successfully resolved. The function should expect a single argument: the
- *     promise's resolved value.
- * @param {Function=} opt_errback The function to call if this promise is
- *     rejected. The function should expect a single argument: the rejection
- *     reason.
- * @return {!webdriver.promise.Promise} A new promise which will be resolved
- *     with the result of the invoked callback.
+ * @param {number} level What level of verbosity to log with.
+ * @param {(string|function(this: T): string)} loggable The message to log.
+ * @param {T=} opt_self The object in whose context to run the loggable
+ *     function.
+ * @template T
  */
-webdriver.promise.Promise.prototype.then = function(
-    opt_callback, opt_errback) {
-  throw new TypeError('Unimplemented function: "then"');
-};
+function vlog(level, loggable, opt_self) {
+  var logLevel = log.Level.FINE;
+  if (level > 1) {
+    logLevel = log.Level.FINEST;
+  } else if (level > 0) {
+    logLevel = log.Level.FINER;
+  }
+
+  if (typeof loggable === 'function') {
+    loggable = loggable.bind(opt_self);
+  }
+
+  log.log(LOG, logLevel, loggable);
+}
 
 
 /**
- * Registers a listener for when this promise is rejected. This is synonymous
- * with the {@code catch} clause in a synchronous API:
- * <pre><code>
- *   // Synchronous API:
- *   try {
- *     doSynchronousWork();
- *   } catch (ex) {
- *     console.error(ex);
- *   }
- *
- *   // Asynchronous promise API:
- *   doAsynchronousWork().thenCatch(function(ex) {
- *     console.error(ex);
- *   });
- * </code></pre>
- *
- * @param {!Function} errback The function to call if this promise is
- *     rejected. The function should expect a single argument: the rejection
- *     reason.
- * @return {!webdriver.promise.Promise} A new promise which will be resolved
- *     with the result of the invoked callback.
+ * Generates an error to capture the current stack trace.
+ * @param {string} name Error name for this stack trace.
+ * @param {string} msg Message to record.
+ * @param {!Function} topFn The function that should appear at the top of the
+ *     stack; only applicable in V8.
+ * @return {!Error} The generated error.
  */
-webdriver.promise.Promise.prototype.thenCatch = function(errback) {
-  return this.then(null, errback);
+promise.captureStackTrace = function(name, msg, topFn) {
+  var e = Error(msg);
+  e.name = name;
+  if (Error.captureStackTrace) {
+    Error.captureStackTrace(e, topFn);
+  } else {
+    var stack = stacktrace.getStack(e);
+    e.stack = e.toString();
+    if (stack) {
+      e.stack += '\n' + stack;
+    }
+  }
+  return e;
 };
 
 
 /**
- * Registers a listener to invoke when this promise is resolved, regardless
- * of whether the promise's value was successfully computed. This function
- * is synonymous with the {@code finally} clause in a synchronous API:
- * <pre><code>
- *   // Synchronous API:
- *   try {
- *     doSynchronousWork();
- *   } finally {
- *     cleanUp();
- *   }
- *
- *   // Asynchronous promise API:
- *   doAsynchronousWork().thenFinally(cleanUp);
- * </code></pre>
- *
- * <b>Note:</b> similar to the {@code finally} clause, if the registered
- * callback returns a rejected promise or throws an error, it will silently
- * replace the rejection error (if any) from this promise:
- * <pre><code>
- *   try {
- *     throw Error('one');
- *   } finally {
- *     throw Error('two');  // Hides Error: one
- *   }
- *
- *   webdriver.promise.rejected(Error('one'))
- *       .thenFinally(function() {
- *         throw Error('two');  // Hides Error: one
- *       });
- * </code></pre>
- *
+ * Error used when the computation of a promise is cancelled.
  *
- * @param callback
- * @returns {!webdriver.promise.Promise}
+ * @unrestricted
  */
-webdriver.promise.Promise.prototype.thenFinally = function(callback) {
-  return this.then(callback, callback);
-};
+promise.CancellationError = goog.defineClass(DebugError, {
+  /**
+   * @param {string=} opt_msg The cancellation message.
+   */
+  constructor: function(opt_msg) {
+    promise.CancellationError.base(this, 'constructor', opt_msg);
+
+    /** @override */
+    this.name = 'CancellationError';
+
+    /** @private {boolean} */
+    this.silent_ = false;
+  },
+
+  statics: {
+    /**
+     * Wraps the given error in a CancellationError.
+     *
+     * @param {*} error The error to wrap.
+     * @param {string=} opt_msg The prefix message to use.
+     * @return {!promise.CancellationError} A cancellation error.
+     */
+    wrap: function(error, opt_msg) {
+      var message;
+      if (error instanceof promise.CancellationError) {
+        return new promise.CancellationError(
+            opt_msg ? (opt_msg + ': ' + error.message) : error.message);
+      } else if (opt_msg) {
+        message = opt_msg;
+        if (error) {
+          message += ': ' + error;
+        }
+        return new promise.CancellationError(message);
+      }
+      if (error) {
+        message = error + '';
+      }
+      return new promise.CancellationError(message);
+    }
+  }
+});
 
 
 /**
- * Registers a function to be invoked when this promise is successfully
- * resolved. This function is provided for backwards compatibility with the
- * Dojo Deferred API.
- *
- * @param {Function} callback The function to call if this promise is
- *     successfully resolved. The function should expect a single argument: the
- *     promise's resolved value.
- * @param {!Object=} opt_self The object which |this| should refer to when the
- *     function is invoked.
- * @return {!webdriver.promise.Promise} A new promise which will be resolved
- *     with the result of the invoked callback.
- * @deprecated Use {@link #then()} instead.
+ * Error used to cancel tasks when a control flow is reset.
+ * @unrestricted
+ * @final
  */
-webdriver.promise.Promise.prototype.addCallback = function(callback, opt_self) {
-  return this.then(goog.bind(callback, opt_self));
-};
+var FlowResetError = goog.defineClass(promise.CancellationError, {
+  constructor: function() {
+    FlowResetError.base(this, 'constructor', 'ControlFlow was reset');
+
+    /** @override */
+    this.name = 'FlowResetError';
+
+    this.silent_ = true;
+  }
+});
 
 
 /**
- * Registers a function to be invoked when this promise is rejected.
- * This function is provided for backwards compatibility with the
- * Dojo Deferred API.
- *
- * @param {Function} errback The function to call if this promise is
- *     rejected. The function should expect a single argument: the rejection
- *     reason.
- * @param {!Object=} opt_self The object which |this| should refer to when the
- *     function is invoked.
- * @return {!webdriver.promise.Promise} A new promise which will be resolved
- *     with the result of the invoked callback.
- * @deprecated Use {@link #thenCatch()} instead.
+ * Error used to cancel tasks that have been discarded due to an uncaught error
+ * reported earlier in the control flow.
+ * @unrestricted
+ * @final
  */
-webdriver.promise.Promise.prototype.addErrback = function(errback, opt_self) {
-  return this.thenCatch(goog.bind(errback, opt_self));
-};
+var DiscardedTaskError = goog.defineClass(promise.CancellationError, {
+  /** @param {*} error The original error. */
+  constructor: function(error) {
+    if (error instanceof DiscardedTaskError) {
+      return /** @type {!DiscardedTaskError} */(error);
+    }
+
+    var msg = '';
+    if (error) {
+      msg = ': ' + (typeof error.message === 'string' ? error.message : error);
+    }
+
+    DiscardedTaskError.base(this, 'constructor',
+        'Task was discarded due to a previous failure' + msg);
+
+    /** @override */
+    this.name = 'DiscardedTaskError';
+    this.silent_ = true;
+  }
+});
 
 
 /**
- * Registers a function to be invoked when this promise is either rejected or
- * resolved. This function is provided for backwards compatibility with the
- * Dojo Deferred API.
- *
- * @param {Function} callback The function to call when this promise is
- *     either resolved or rejected. The function should expect a single
- *     argument: the resolved value or rejection error.
- * @param {!Object=} opt_self The object which |this| should refer to when the
- *     function is invoked.
- * @return {!webdriver.promise.Promise} A new promise which will be resolved
- *     with the result of the invoked callback.
- * @deprecated Use {@link #thenFinally()} instead.
+ * Error used when there are multiple unhandled promise rejections detected
+ * within a task or callback.
+ *
+ * @unrestricted
+ * @final
  */
-webdriver.promise.Promise.prototype.addBoth = function(callback, opt_self) {
-  return this.thenFinally(goog.bind(callback, opt_self));
-};
+promise.MultipleUnhandledRejectionError = goog.defineClass(DebugError, {
+  /**
+   * @param {!(Set<*>)} errors The errors to report.
+   */
+  constructor: function(errors) {
+    promise.MultipleUnhandledRejectionError.base(
+        this, 'constructor', 'Multiple unhandled promise rejections reported');
+
+    /** @override */
+    this.name = 'MultipleUnhandledRejectionError';
+
+    /** @type {!Set<*>} */
+    this.errors = errors;
+  }
+});
 
 
 /**
- * An alias for {@code webdriver.promise.Promise.prototype.then} that permits
- * the scope of the invoked function to be specified. This function is provided
- * for backwards compatibility with the Dojo Deferred API.
- *
- * @param {Function} callback The function to call if this promise is
- *     successfully resolved. The function should expect a single argument: the
- *     promise's resolved value.
- * @param {Function} errback The function to call if this promise is
- *     rejected. The function should expect a single argument: the rejection
- *     reason.
- * @param {!Object=} opt_self The object which |this| should refer to when the
- *     function is invoked.
- * @return {!webdriver.promise.Promise} A new promise which will be resolved
- *     with the result of the invoked callback.
- * @deprecated Use {@link #then()} instead.
+ * Property used to flag constructor's as implementing the Thenable interface
+ * for runtime type checking.
+ * @type {string}
+ * @const
  */
-webdriver.promise.Promise.prototype.addCallbacks = function(
-    callback, errback, opt_self) {
-  return this.then(goog.bind(callback, opt_self),
-      goog.bind(errback, opt_self));
-};
-
+var IMPLEMENTED_BY_PROP = '$webdriver_Thenable';
 
 
 /**
- * Represents a value that will be resolved at some point in the future. This
- * class represents the protected "producer" half of a Promise - each Deferred
- * has a {@code promise} property that may be returned to consumers for
- * registering callbacks, reserving the ability to resolve the deferred to the
- * producer.
- *
- * <p>If this Deferred is rejected and there are no listeners registered before
- * the next turn of the event loop, the rejection will be passed to the
- * {@link webdriver.promise.ControlFlow} as an unhandled failure.
+ * Thenable is a promise-like object with a {@code then} method which may be
+ * used to schedule callbacks on a promised value.
  *
- * <p>If this Deferred is cancelled, the cancellation reason will be forward to
- * the Deferred's canceller function (if provided). The canceller may return a
- * truth-y value to override the reason provided for rejection.
- *
- * @param {Function=} opt_canceller Function to call when cancelling the
- *     computation of this instance's value.
- * @param {webdriver.promise.ControlFlow=} opt_flow The control flow
- *     this instance was created under. This should only be provided during
- *     unit tests.
- * @constructor
- * @extends {webdriver.promise.Promise}
+ * @interface
+ * @extends {IThenable<T>}
+ * @template T
  */
-webdriver.promise.Deferred = function(opt_canceller, opt_flow) {
-  /* NOTE: This class's implementation diverges from the prototypical style
-   * used in the rest of the atoms library. This was done intentionally to
-   * protect the internal Deferred state from consumers, as outlined by
-   *     http://wiki.commonjs.org/wiki/Promises
-   */
-  goog.base(this);
-
-  var flow = opt_flow || webdriver.promise.controlFlow();
+promise.Thenable = goog.defineClass(null, {
+  statics: {
+    /**
+     * Adds a property to a class prototype to allow runtime checks of whether
+     * instances of that class implement the Thenable interface. This function
+     * will also ensure the prototype's {@code then} function is exported from
+     * compiled code.
+     * @param {function(new: promise.Thenable, ...?)} ctor The
+     *     constructor whose prototype to modify.
+     */
+    addImplementation: function(ctor) {
+      // Based on goog.promise.Thenable.isImplementation.
+      ctor.prototype['then'] = ctor.prototype.then;
+      try {
+        // Old IE7 does not support defineProperty; IE8 only supports it for
+        // DOM elements.
+        Object.defineProperty(
+          ctor.prototype,
+          IMPLEMENTED_BY_PROP,
+          {'value': true, 'enumerable': false});
+      } catch (ex) {
+        ctor.prototype[IMPLEMENTED_BY_PROP] = true;
+      }
+    },
+
+    /**
+     * Checks if an object has been tagged for implementing the Thenable
+     * interface as defined by
+     * {@link webdriver.promise.Thenable.addImplementation}.
+     * @param {*} object The object to test.
+     * @return {boolean} Whether the object is an implementation of the Thenable
+     *     interface.
+     */
+    isImplementation: function(object) {
+      // Based on goog.promise.Thenable.isImplementation.
+      if (!object) {
+        return false;
+      }
+      try {
+        return !!object[IMPLEMENTED_BY_PROP];
+      } catch (e) {
+        return false;  // Property access seems to be forbidden.
+      }
+    }
+  },
 
   /**
-   * The listeners registered with this Deferred. Each element in the list will
-   * be a 3-tuple of the callback function, errback function, and the
-   * corresponding deferred object.
-   * @type {!Array.<!webdriver.promise.Deferred.Listener_>}
+   * Cancels the computation of this promise's value, rejecting the promise in
+   * the process. This method is a no-op if the promise has already been
+   * resolved.
+   *
+   * @param {(string|promise.CancellationError)=} opt_reason The reason this
+   *     promise is being cancelled.
    */
-  var listeners = [];
+  cancel: function(opt_reason) {},
 
-  /**
-   * Whether this Deferred's resolution was ever handled by a listener.
-   * If the Deferred is rejected and its value is not handled by a listener
-   * before the next turn of the event loop, the error will be passed to the
-   * global error handler.
-   * @type {boolean}
-   */
-  var handled = false;
+  /** @return {boolean} Whether this promise's value is still being computed. */
+  isPending: function() {},
 
   /**
-   * Key for the timeout used to delay reproting an unhandled rejection to the
-   * parent {@link webdriver.promise.ControlFlow}.
-   * @type {?number}
+   * Registers listeners for when this instance is resolved.
+   *
+   * @param {?(function(T): (R|IThenable<R>))=} opt_callback The
+   *     function to call if this promise is successfully resolved. The function
+   *     should expect a single argument: the promise's resolved value.
+   * @param {?(function(*): (R|IThenable<R>))=} opt_errback
+   *     The function to call if this promise is rejected. The function should
+   *     expect a single argument: the rejection reason.
+   * @return {!promise.Promise<R>} A new promise which will be
+   *     resolved with the result of the invoked callback.
+   * @template R
    */
-  var pendingRejectionKey = null;
+  then: function(opt_callback, opt_errback) {},
 
   /**
-   * This Deferred's current state.
-   * @type {!webdriver.promise.Deferred.State_}
+   * Registers a listener for when this promise is rejected. This is synonymous
+   * with the {@code catch} clause in a synchronous API:
+   *
+   *     // Synchronous API:
+   *     try {
+   *       doSynchronousWork();
+   *     } catch (ex) {
+   *       console.error(ex);
+   *     }
+   *
+   *     // Asynchronous promise API:
+   *     doAsynchronousWork().thenCatch(function(ex) {
+   *       console.error(ex);
+   *     });
+   *
+   * @param {function(*): (R|IThenable<R>)} errback The
+   *     function to call if this promise is rejected. The function should
+   *     expect a single argument: the rejection reason.
+   * @return {!promise.Promise<R>} A new promise which will be
+   *     resolved with the result of the invoked callback.
+   * @template R
    */
-  var state = webdriver.promise.Deferred.State_.PENDING;
+  thenCatch: function(errback) {},
 
   /**
-   * This Deferred's resolved value; set when the state transitions from
-   * {@code webdriver.promise.Deferred.State_.PENDING}.
-   * @type {*}
+   * Registers a listener to invoke when this promise is resolved, regardless
+   * of whether the promise's value was successfully computed. This function
+   * is synonymous with the {@code finally} clause in a synchronous API:
+   *
+   *     // Synchronous API:
+   *     try {
+   *       doSynchronousWork();
+   *     } finally {
+   *       cleanUp();
+   *     }
+   *
+   *     // Asynchronous promise API:
+   *     doAsynchronousWork().thenFinally(cleanUp);
+   *
+   * __Note:__ similar to the {@code finally} clause, if the registered
+   * callback returns a rejected promise or throws an error, it will silently
+   * replace the rejection error (if any) from this promise:
+   *
+   *     try {
+   *       throw Error('one');
+   *     } finally {
+   *       throw Error('two');  // Hides Error: one
+   *     }
+   *
+   *     promise.rejected(Error('one'))
+   *         .thenFinally(function() {
+   *           throw Error('two');  // Hides Error: one
+   *         });
+   *
+   * @param {function(): (R|IThenable<R>)} callback The function
+   *     to call when this promise is resolved.
+   * @return {!promise.Promise<R>} A promise that will be fulfilled
+   *     with the callback result.
+   * @template R
    */
-  var value;
+  thenFinally: function(callback) {}
+});
 
-  /** @return {boolean} Whether this promise's value is still pending. */
-  function isPending() {
-    return state == webdriver.promise.Deferred.State_.PENDING;
-  }
 
-  /**
-   * Removes all of the listeners previously registered on this deferred.
-   * @throws {Error} If this deferred has already been resolved.
-   */
-  function removeAll() {
-    listeners = [];
-  }
 
+/**
+ * @enum {string}
+ */
+var PromiseState = {
+  PENDING: 'pending',
+  BLOCKED: 'blocked',
+  REJECTED: 'rejected',
+  FULFILLED: 'fulfilled'
+};
+
+
+/**
+ * Internal symbol used to store a cancellation handler for
+ * {@link promise.Promise} objects. This is an internal implementation detail
+ * used by the {@link TaskQueue} class to monitor for when a promise is
+ * cancelled without generating an extra promise via then().
+ */
+var CANCEL_HANDLER_SYMBOL = Symbol('on cancel');
+
+
+/**
+ * Represents the eventual value of a completed operation. Each promise may be
+ * in one of three states: pending, fulfilled, or rejected. Each promise starts
+ * in the pending state and may make a single transition to either a
+ * fulfilled or rejected state, at which point the promise is considered
+ * resolved.
+ *
+ * @implements {promise.Thenable<T>}
+ * @template T
+ * @see http://promises-aplus.github.io/promises-spec/
+ * @unrestricted  // For using CANCEL_HANDLER_SYMBOL.
+ */
+promise.Promise = goog.defineClass(null, {
   /**
-   * Resolves this deferred. If the new value is a promise, this function will
-   * wait for it to be resolved before notifying the registered listeners.
-   * @param {!webdriver.promise.Deferred.State_} newState The deferred's new
-   *     state.
-   * @param {*} newValue The deferred's new value.
+   * @param {function(
+   *           function((T|IThenable<T>|Thenable)=),
+   *           function(*=))} resolver
+   *     Function that is invoked immediately to begin computation of this
+   *     promise's value. The function should accept a pair of callback
+   *     functions, one for fulfilling the promise and another for rejecting it.
+   * @param {promise.ControlFlow=} opt_flow The control flow
+   *     this instance was created under. Defaults to the currently active flow.
    */
-  function resolve(newState, newValue) {
-    if (webdriver.promise.Deferred.State_.PENDING !== state) {
-      return;
+  constructor: function(resolver, opt_flow) {
+    goog.getUid(this);
+
+    /** @private {!promise.ControlFlow} */
+    this.flow_ = opt_flow || promise.controlFlow();
+
+    /** @private {Error} */
+    this.stack_ = null;
+    if (promise.LONG_STACK_TRACES) {
+      this.stack_ = promise.captureStackTrace(
+        'Promise', 'new', promise.Promise);
     }
 
-    state = webdriver.promise.Deferred.State_.BLOCKED;
+    /** @private {promise.Promise<?>} */
+    this.parent_ = null;
 
-    if (webdriver.promise.isPromise(newValue) && newValue !== self) {
-      var onFulfill = goog.partial(notifyAll, newState);
-      var onReject = goog.partial(
-          notifyAll, webdriver.promise.Deferred.State_.REJECTED);
-      if (newValue instanceof webdriver.promise.Deferred) {
-        newValue.then(onFulfill, onReject);
-      } else {
-        webdriver.promise.asap(newValue, onFulfill, onReject);
-      }
+    /** @private {Array<!Task>} */
+    this.callbacks_ = null;
 
-    } else {
-      notifyAll(newState, newValue);
+    /** @private {PromiseState} */
+    this.state_ = PromiseState.PENDING;
+
+    /** @private {boolean} */
+    this.handled_ = false;
+
+    /** @private {*} */
+    this.value_ = undefined;
+
+    /** @private {TaskQueue} */
+    this.queue_ = null;
+
+    /** @private {(function(promise.CancellationError)|null)} */
+    this[CANCEL_HANDLER_SYMBOL] = null;
+
+    try {
+      var self = this;
+      resolver(function(value) {
+        self.resolve_(PromiseState.FULFILLED, value);
+      }, function(reason) {
+        self.resolve_(PromiseState.REJECTED, reason);
+      });
+    } catch (ex) {
+      this.resolve_(PromiseState.REJECTED, ex);
     }
-  }
+  },
+
+  /** @override */
+  toString: function() {
+    return 'Promise::' + goog.getUid(this) +
+      ' {[[PromiseStatus]]: "' + this.state_ + '"}';
+  },
 
   /**
-   * Notifies all of the listeners registered with this Deferred that its state
-   * has changed.
-   * @param {!webdriver.promise.Deferred.State_} newState The deferred's new
-   *     state.
-   * @param {*} newValue The deferred's new value.
+   * Resolves this promise. If the new value is itself a promise, this function
+   * will wait for it to be resolved before notifying the registered listeners.
+   * @param {PromiseState} newState The promise's new state.
+   * @param {*} newValue The promise's new value.
+   * @throws {TypeError} If {@code newValue === this}.
+   * @private
    */
-  function notifyAll(newState, newValue) {
-    if (newState === webdriver.promise.Deferred.State_.REJECTED &&
-        // We cannot check instanceof Error since the object may have been
-        // created in a different JS context.
-        goog.isObject(newValue) && goog.isString(newValue.message)) {
-      newValue = flow.annotateError(/** @type {!Error} */(newValue));
+  resolve_: function(newState, newValue) {
+    if (PromiseState.PENDING !== this.state_) {
+      return;
+    }
+
+    if (newValue === this) {
+      // See promise a+, 2.3.1
+      // http://promises-aplus.github.io/promises-spec/#point-48
+      newValue = new TypeError('A promise may not resolve to itself');
+      newState = PromiseState.REJECTED;
     }
 
-    state = newState;
-    value = newValue;
-    while (listeners.length) {
-      notify(listeners.shift());
+    this.parent_ = null;
+    this.state_ = PromiseState.BLOCKED;
+
+    if (newState !== PromiseState.REJECTED) {
+      if (promise.Thenable.isImplementation(newValue)) {
+        // 2.3.2
+        newValue = /** @type {!promise.Thenable} */(newValue);
+        newValue.then(
+            this.unblockAndResolve_.bind(this, PromiseState.FULFILLED),
+            this.unblockAndResolve_.bind(this, PromiseState.REJECTED));
+        return;
+
+      } else if (goog.isObject(newValue)) {
+        // 2.3.3
+
+        try {
+          // 2.3.3.1
+          var then = newValue['then'];
+        } catch (e) {
+          // 2.3.3.2
+          this.state_ = PromiseState.REJECTED;
+          this.value_ = e;
+          this.scheduleNotifications_();
+          return;
+        }
+
+        // NB: goog.isFunction is loose and will accept instanceof Function.
+        if (typeof then === 'function') {
+          // 2.3.3.3
+          this.invokeThen_(newValue, then);
+          return;
+        }
+      }
     }
 
-    if (!handled && state == webdriver.promise.Deferred.State_.REJECTED) {
-      pendingRejectionKey = propagateError(value);
+    if (newState === PromiseState.REJECTED &&
+        isError(newValue) && newValue.stack && this.stack_) {
+      newValue.stack += '\nFrom: ' + (this.stack_.stack || this.stack_);
     }
-  }
 
-  /**
-   * Propagates an unhandled rejection to the parent ControlFlow in a
-   * future turn of the JavaScript event loop.
-   * @param {*} error The error value to report.
-   * @return {number} The key for the registered timeout.
-   */
-  function propagateError(error) {
-    flow.pendingRejections_ += 1;
-    return flow.timer.setTimeout(function() {
-      flow.pendingRejections_ -= 1;
-      flow.abortFrame_(error);
-    }, 0);
-  }
+    // 2.3.3.4 and 2.3.4
+    this.state_ = newState;
+    this.value_ = newValue;
+    this.scheduleNotifications_();
+  },
 
   /**
-   * Notifies a single listener of this Deferred's change in state.
-   * @param {!webdriver.promise.Deferred.Listener_} listener The listener to
-   *     notify.
+   * Invokes a thenable's "then" method according to 2.3.3.3 of the promise
+   * A+ spec.
+   * @param {!Object} x The thenable object.
+   * @param {!Function} then The "then" function to invoke.
+   * @private
    */
-  function notify(listener) {
-    var func = state == webdriver.promise.Deferred.State_.RESOLVED ?
-        listener.callback : listener.errback;
-    if (func) {
-      flow.runInNewFrame_(goog.partial(func, value),
-          listener.fulfill, listener.reject);
-    } else if (state == webdriver.promise.Deferred.State_.REJECTED) {
-      listener.reject(value);
-    } else {
-      listener.fulfill(value);
+  invokeThen_: function(x, then) {
+    var called = false;
+    var self = this;
+
+    var resolvePromise = function(value) {
+      if (!called) {  // 2.3.3.3.3
+        called = true;
+        // 2.3.3.3.1
+        self.unblockAndResolve_(PromiseState.FULFILLED, value);
+      }
+    };
+
+    var rejectPromise = function(reason) {
+      if (!called) {  // 2.3.3.3.3
+        called = true;
+        // 2.3.3.3.2
+        self.unblockAndResolve_(PromiseState.REJECTED, reason);
+      }
+    };
+
+    try {
+      // 2.3.3.3
+      then.call(x, resolvePromise, rejectPromise);
+    } catch (e) {
+      // 2.3.3.3.4.2
+      rejectPromise(e);
     }
-  }
+  },
 
   /**
-   * The consumer promise for this instance. Provides protected access to the
-   * callback registering functions.
-   * @type {!webdriver.promise.Promise}
+   * @param {PromiseState} newState The promise's new state.
+   * @param {*} newValue The promise's new value.
+   * @private
    */
-  var promise = new webdriver.promise.Promise();
+  unblockAndResolve_: function(newState, newValue) {
+    if (this.state_ === PromiseState.BLOCKED) {
+      this.state_ = PromiseState.PENDING;
+      this.resolve_(newState, newValue);
+    }
+  },
 
   /**
-   * Registers a callback on this Deferred.
-   * @param {Function=} opt_callback The callback.
-   * @param {Function=} opt_errback The errback.
-   * @return {!webdriver.promise.Promise} A new promise representing the result
-   *     of the callback.
-   * @see webdriver.promise.Promise#then
+   * @private
    */
-  function then(opt_callback, opt_errback) {
-    // Avoid unnecessary allocations if we weren't given any callback functions.
-    if (!opt_callback && !opt_errback) {
-      return promise;
-    }
-
-    // The moment a listener is registered, we consider this deferred to be
-    // handled; the callback must handle any rejection errors.
-    handled = true;
-    if (pendingRejectionKey) {
-      flow.pendingRejections_ -= 1;
-      flow.timer.clearTimeout(pendingRejectionKey);
-    }
-
-    var deferred = new webdriver.promise.Deferred(cancel, flow);
-    var listener = {
-      callback: opt_callback,
-      errback: opt_errback,
-      fulfill: deferred.fulfill,
-      reject: deferred.reject
-    };
+  scheduleNotifications_: function() {
+    vlog(2, () => this + ' scheduling notifications', this);
+
+    this[CANCEL_HANDLER_SYMBOL] = null;
+    if (this.value_ instanceof promise.CancellationError
+        && this.value_.silent_) {
+      this.callbacks_ = null;
+    }
+
+    if (!this.queue_) {
+      this.queue_ = this.flow_.getActiveQueue_();
+    }
+
+    if (!this.handled_ &&
+        this.state_ === PromiseState.REJECTED &&
+        !(this.value_ instanceof promise.CancellationError)) {
+      this.queue_.addUnhandledRejection(this);
+    }
+    this.queue_.scheduleCallbacks(this);
+  },
 
-    if (state == webdriver.promise.Deferred.State_.PENDING ||
-        state == webdriver.promise.Deferred.State_.BLOCKED) {
-      listeners.push(listener);
+  /** @override */
+  cancel: function(opt_reason) {
+    if (!canCancel(this)) {
+      return;
+    }
+
+    if (this.parent_ && canCancel(this.parent_)) {
+      this.parent_.cancel(opt_reason);
     } else {
-      notify(listener);
+      var reason = promise.CancellationError.wrap(opt_reason);
+      if (this[CANCEL_HANDLER_SYMBOL]) {
+        this[CANCEL_HANDLER_SYMBOL](reason);
+        this[CANCEL_HANDLER_SYMBOL] = null;
+      }
+
+      if (this.state_ === PromiseState.BLOCKED) {
+        this.unblockAndResolve_(PromiseState.REJECTED, reason);
+      } else {
+        this.resolve_(PromiseState.REJECTED, reason);
+      }
     }
 
-    return deferred.promise;
-  }
+    function canCancel(promise) {
+      return promise.state_ === PromiseState.PENDING
+          || promise.state_ === PromiseState.BLOCKED;
+    }
+  },
+
+  /** @override */
+  isPending: function() {
+    return this.state_ === PromiseState.PENDING;
+  },
+
+  /** @override */
+  then: function(opt_callback, opt_errback) {
+    return this.addCallback_(
+        opt_callback, opt_errback, 'then', promise.Promise.prototype.then);
+  },
+
+  /** @override */
+  thenCatch: function(errback) {
+    return this.addCallback_(
+        null, errback, 'thenCatch', promise.Promise.prototype.thenCatch);
+  },
 
-  var self = this;
+  /** @override */
+  thenFinally: function(callback) {
+    var error;
+    var mustThrow = false;
+    return this.then(function() {
+      return callback();
+    }, function(err) {
+      error = err;
+      mustThrow = true;
+      return callback();
+    }).then(function() {
+      if (mustThrow) {
+        throw error;
+      }
+    });
+  },
 
   /**
-   * Resolves this promise with the given value. If the value is itself a
-   * promise and not a reference to this deferred, this instance will wait for
-   * it before resolving.
-   * @param {*=} opt_value The resolved value.
+   * Registers a new callback with this promise
+   * @param {(function(T): (R|IThenable<R>)|null|undefined)} callback The
+   *    fulfillment callback.
+   * @param {(function(*): (R|IThenable<R>)|null|undefined)} errback The
+   *    rejection callback.
+   * @param {string} name The callback name.
+   * @param {!Function} fn The function to use as the top of the stack when
+   *     recording the callback's creation point.
+   * @return {!promise.Promise<R>} A new promise which will be resolved with the
+   *     esult of the invoked callback.
+   * @template R
+   * @private
    */
-  function fulfill(opt_value) {
-    resolve(webdriver.promise.Deferred.State_.RESOLVED, opt_value);
-  }
+  addCallback_: function(callback, errback, name, fn) {
+    if (!goog.isFunction(callback) && !goog.isFunction(errback)) {
+      return this;
+    }
+
+    this.handled_ = true;
+    if (this.queue_) {
+      this.queue_.clearUnhandledRejection(this);
+    }
+
+    var cb = new Task(
+        this.flow_,
+        this.invokeCallback_.bind(this, callback, errback),
+        name,
+        promise.LONG_STACK_TRACES ? {name: 'Promise', top: fn} : undefined);
+    cb.promise.parent_ = this;
+
+    if (this.state_ !== PromiseState.PENDING &&
+        this.state_ !== PromiseState.BLOCKED) {
+      this.flow_.getActiveQueue_().enqueue(cb);
+    } else {
+      if (!this.callbacks_) {
+        this.callbacks_ = [];
+      }
+      this.callbacks_.push(cb);
+      cb.isVolatile = true;
+      this.flow_.getActiveQueue_().enqueue(cb);
+    }
+
+    return cb.promise;
+  },
 
   /**
-   * Rejects this promise. If the error is itself a promise, this instance will
-   * be chained to it and be rejected with the error's resolved value.
-   * @param {*=} opt_error The rejection reason, typically either a
-   *     {@code Error} or a {@code string}.
+   * Invokes a callback function attached to this promise.
+   * @param {(function(T): (R|IThenable<R>)|null|undefined)} callback The
+   *    fulfillment callback.
+   * @param {(function(*): (R|IThenable<R>)|null|undefined)} errback The
+   *    rejection callback.
+   * @template R
+   * @private
    */
-  function reject(opt_error) {
-    resolve(webdriver.promise.Deferred.State_.REJECTED, opt_error);
+  invokeCallback_: function(callback, errback) {
+    var callbackFn = callback;
+    if (this.state_ === PromiseState.REJECTED) {
+      callbackFn = errback;
+    }
+
+    if (goog.isFunction(callbackFn)) {
+      if (promise.isGenerator(callbackFn)) {
+        return promise.consume(callbackFn, null, this.value_);
+      }
+      return callbackFn(this.value_);
+    } else if (this.state_ === PromiseState.REJECTED) {
+      throw this.value_;
+    } else {
+      return this.value_;
+    }
   }
+});
+promise.Thenable.addImplementation(promise.Promise);
+
 
+/**
+ * Represents a value that will be resolved at some point in the future. This
+ * class represents the protected "producer" half of a Promise - each Deferred
+ * has a {@code promise} property that may be returned to consumers for
+ * registering callbacks, reserving the ability to resolve the deferred to the
+ * producer.
+ *
+ * If this Deferred is rejected and there are no listeners registered before
+ * the next turn of the event loop, the rejection will be passed to the
+ * {@link webdriver.promise.ControlFlow} as an unhandled failure.
+ *
+ * @implements {promise.Thenable<T>}
+ * @template T
+ */
+promise.Deferred = goog.defineClass(null, {
   /**
-   * Attempts to cancel the computation of this instance's value. This attempt
-   * will silently fail if this instance has already resolved.
-   * @param {*=} opt_reason The reason for cancelling this promise.
+   * @param {promise.ControlFlow=} opt_flow The control flow this instance was
+   *     created under. This should only be provided during unit tests.
    */
-  function cancel(opt_reason) {
-    if (!isPending()) {
-      return;
-    }
+  constructor: function(opt_flow) {
+    var fulfill, reject;
 
-    if (opt_canceller) {
-      opt_reason = opt_canceller(opt_reason) || opt_reason;
-    }
+    /** @type {!promise.Promise<T>} */
+    this.promise = new promise.Promise(function(f, r) {
+      fulfill = f;
+      reject = r;
+    }, opt_flow);
 
-    reject(opt_reason);
-  }
+    var self = this;
+    var checkNotSelf = function(value) {
+      if (value === self) {
+        throw new TypeError('May not resolve a Deferred with itself');
+      }
+    };
 
-  this.promise = promise;
-  this.promise.then = this.then = then;
-  this.promise.cancel = this.cancel = cancel;
-  this.promise.isPending = this.isPending = isPending;
-  this.fulfill = fulfill;
-  this.reject = this.errback = reject;
-
-  // Only expose this function to our internal classes.
-  // TODO: find a cleaner way of handling this.
-  if (this instanceof webdriver.promise.Task_) {
-    this.removeAll = removeAll;
-  }
+    /**
+     * Resolves this deferred with the given value. It is safe to call this as a
+     * normal function (with no bound "this").
+     * @param {(T|IThenable<T>|Thenable)=} opt_value The fulfilled value.
+     */
+    this.fulfill = function(opt_value) {
+      checkNotSelf(opt_value);
+      fulfill(opt_value);
+    };
 
-  // Export symbols necessary for the contract on this object to work in
-  // compiled mode.
-  goog.exportProperty(this, 'then', this.then);
-  goog.exportProperty(this, 'cancel', cancel);
-  goog.exportProperty(this, 'fulfill', fulfill);
-  goog.exportProperty(this, 'reject', reject);
-  goog.exportProperty(this, 'isPending', isPending);
-  goog.exportProperty(this, 'promise', this.promise);
-  goog.exportProperty(this.promise, 'then', this.then);
-  goog.exportProperty(this.promise, 'cancel', cancel);
-  goog.exportProperty(this.promise, 'isPending', isPending);
-};
-goog.inherits(webdriver.promise.Deferred, webdriver.promise.Promise);
+    /**
+     * Rejects this promise with the given reason. It is safe to call this as a
+     * normal function (with no bound "this").
+     * @param {*=} opt_reason The rejection reason.
+     */
+    this.reject = function(opt_reason) {
+      checkNotSelf(opt_reason);
+      reject(opt_reason);
+    };
+  },
 
+  /** @override */
+  isPending: function() {
+    return this.promise.isPending();
+  },
 
-/**
- * Type definition for a listener registered on a Deferred object.
- * @typedef {{callback:(Function|undefined),
- *            errback:(Function|undefined),
- *            fulfill: function(*), reject: function(*)}}
- * @private
- */
-webdriver.promise.Deferred.Listener_;
+  /** @override */
+  cancel: function(opt_reason) {
+    this.promise.cancel(opt_reason);
+  },
+
+  /**
+   * @override
+   * @deprecated Use {@code then} from the promise property directly.
+   */
+  then: function(opt_cb, opt_eb) {
+    return this.promise.then(opt_cb, opt_eb);
+  },
 
+  /**
+   * @override
+   * @deprecated Use {@code thenCatch} from the promise property directly.
+   */
+  thenCatch: function(opt_eb) {
+    return this.promise.thenCatch(opt_eb);
+  },
 
-/**
- * The three states a {@link webdriver.promise.Deferred} object may be in.
- * @enum {number}
- * @private
- */
-webdriver.promise.Deferred.State_ = {
-  REJECTED: -1,
-  PENDING: 0,
-  BLOCKED: 1,
-  RESOLVED: 2
-};
+  /**
+   * @override
+   * @deprecated Use {@code thenFinally} from the promise property directly.
+   */
+  thenFinally: function(opt_cb) {
+    return this.promise.thenFinally(opt_cb);
+  }
+});
+promise.Thenable.addImplementation(promise.Deferred);
 
 
 /**
@@ -576,16 +1431,15 @@ webdriver.promise.Deferred.State_ = {
  * instanceof check since the value may originate from another context.
  * @param {*} value The value to test.
  * @return {boolean} Whether the value is an error.
- * @private
  */
-webdriver.promise.isError_ = function(value) {
+function isError(value) {
   return value instanceof Error ||
       goog.isObject(value) &&
-      (Object.prototype.toString.call(value) === '[object Error]' ||
+      (goog.isString(value.message) ||
        // A special test for goog.testing.JsUnitException.
        value.isJsUnitException);
 
-};
+}
 
 
 /**
@@ -595,11 +1449,13 @@ webdriver.promise.isError_ = function(value) {
  * @param {*} value The value to test.
  * @return {boolean} Whether the value is a promise.
  */
-webdriver.promise.isPromise = function(value) {
+promise.isPromise = function(value) {
   return !!value && goog.isObject(value) &&
       // Use array notation so the Closure compiler does not obfuscate away our
-      // contract.
-      goog.isFunction(value['then']);
+      // contract. Use typeof rather than goog.isFunction because
+      // goog.isFunction accepts instanceof Function, which the promise spec
+      // does not.
+      typeof value['then'] === 'function';
 };
 
 
@@ -607,42 +1463,46 @@ webdriver.promise.isPromise = function(value) {
  * Creates a promise that will be resolved at a set time in the future.
  * @param {number} ms The amount of time, in milliseconds, to wait before
  *     resolving the promise.
- * @return {!webdriver.promise.Promise} The promise.
+ * @return {!promise.Promise} The promise.
  */
-webdriver.promise.delayed = function(ms) {
-  var timer = webdriver.promise.controlFlow().timer;
+promise.delayed = function(ms) {
   var key;
-  var deferred = new webdriver.promise.Deferred(function() {
-    timer.clearTimeout(key);
+  return new promise.Promise(function(fulfill) {
+    key = setTimeout(function() {
+      key = null;
+      fulfill();
+    }, ms);
+  }).thenCatch(function(e) {
+    clearTimeout(key);
+    key = null;
+    throw e;
   });
-  key = timer.setTimeout(deferred.fulfill, ms);
-  return deferred.promise;
 };
 
 
 /**
  * Creates a new deferred object.
- * @param {Function=} opt_canceller Function to call when cancelling the
- *     computation of this instance's value.
- * @return {!webdriver.promise.Deferred} The new deferred object.
+ * @return {!promise.Deferred<T>} The new deferred object.
+ * @template T
  */
-webdriver.promise.defer = function(opt_canceller) {
-  return new webdriver.promise.Deferred(opt_canceller);
+promise.defer = function() {
+  return new promise.Deferred();
 };
 
 
 /**
  * Creates a promise that has been resolved with the given value.
- * @param {*=} opt_value The resolved value.
- * @return {!webdriver.promise.Promise} The resolved promise.
+ * @param {T=} opt_value The resolved value.
+ * @return {!promise.Promise<T>} The resolved promise.
+ * @template T
  */
-webdriver.promise.fulfilled = function(opt_value) {
-  if (opt_value instanceof webdriver.promise.Promise) {
+promise.fulfilled = function(opt_value) {
+  if (opt_value instanceof promise.Promise) {
     return opt_value;
   }
-  var deferred = new webdriver.promise.Deferred();
-  deferred.fulfill(opt_value);
-  return deferred.promise;
+  return new promise.Promise(function(fulfill) {
+    fulfill(opt_value);
+  });
 };
 
 
@@ -650,37 +1510,42 @@ webdriver.promise.fulfilled = function(opt_value) {
  * Creates a promise that has been rejected with the given reason.
  * @param {*=} opt_reason The rejection reason; may be any value, but is
  *     usually an Error or a string.
- * @return {!webdriver.promise.Promise} The rejected promise.
+ * @return {!promise.Promise<T>} The rejected promise.
+ * @template T
  */
-webdriver.promise.rejected = function(opt_reason) {
-  var deferred = new webdriver.promise.Deferred();
-  deferred.reject(opt_reason);
-  return deferred.promise;
+promise.rejected = function(opt_reason) {
+  if (opt_reason instanceof promise.Promise) {
+    return opt_reason;
+  }
+  return new promise.Promise(function(_, reject) {
+    reject(opt_reason);
+  });
 };
 
 
 /**
- * Wraps a function that is assumed to be a node-style callback as its final
- * argument. This callback takes two arguments: an error value (which will be
+ * Wraps a function that expects a node-style callback as its final
+ * argument. This callback expects two arguments: an error value (which will be
  * null if the call succeeded), and the success value as the second argument.
- * If the call fails, the returned promise will be rejected, otherwise it will
- * be resolved with the result.
+ * The callback will the resolve or reject the returned promise, based on its arguments.
  * @param {!Function} fn The function to wrap.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
+ * @param {...?} var_args The arguments to apply to the function, excluding the
+ *     final callback.
+ * @return {!promise.Promise} A promise that will be resolved with the
  *     result of the provided function's callback.
  */
-webdriver.promise.checkedNodeCall = function(fn) {
-  var deferred = new webdriver.promise.Deferred(function() {
-    throw Error('This Deferred may not be cancelled');
+promise.checkedNodeCall = function(fn, var_args) {
+  var args = Arrays.slice(arguments, 1);
+  return new promise.Promise(function(fulfill, reject) {
+    try {
+      args.push(function(error, value) {
+        error ? reject(error) : fulfill(value);
+      });
+      fn.apply(undefined, args);
+    } catch (ex) {
+      reject(ex);
+    }
   });
-  try {
-    fn(function(error, value) {
-      error ? deferred.reject(error) : deferred.fulfill(value);
-    });
-  } catch (ex) {
-    deferred.reject(ex);
-  }
-  return deferred.promise;
 };
 
 
@@ -693,18 +1558,16 @@ webdriver.promise.checkedNodeCall = function(fn) {
  *     resolved successfully.
  * @param {Function=} opt_errback The function to call when the value is
  *     rejected.
- * @return {!webdriver.promise.Promise} A new promise.
+ * @return {!promise.Promise} A new promise.
  */
-webdriver.promise.when = function(value, opt_callback, opt_errback) {
-  if (value instanceof webdriver.promise.Promise) {
+promise.when = function(value, opt_callback, opt_errback) {
+  if (promise.Thenable.isImplementation(value)) {
     return value.then(opt_callback, opt_errback);
   }
 
-  var deferred = new webdriver.promise.Deferred();
-
-  webdriver.promise.asap(value, deferred.fulfill, deferred.reject);
-
-  return deferred.then(opt_callback, opt_errback);
+  return new promise.Promise(function(fulfill, reject) {
+    promise.asap(value, fulfill, reject);
+  }).then(opt_callback, opt_errback);
 };
 
 
@@ -718,8 +1581,8 @@ webdriver.promise.when = function(value, opt_callback, opt_errback) {
  * @param {Function=} opt_errback The function to call when the value is
  *     rejected.
  */
-webdriver.promise.asap = function(value, callback, opt_errback) {
-  if (webdriver.promise.isPromise(value)) {
+promise.asap = function(value, callback, opt_errback) {
+  if (promise.isPromise(value)) {
     value.then(callback, opt_errback);
 
   // Maybe a Dojo-like deferred object?
@@ -740,38 +1603,37 @@ webdriver.promise.asap = function(value, callback, opt_errback) {
  * input array's promises are rejected, the returned promise will be rejected
  * with the same reason.
  *
- * @param {!Array.<(T|!webdriver.promise.Promise.<T>)>} arr An array of
+ * @param {!Array<(T|!promise.Promise<T>)>} arr An array of
  *     promises to wait on.
- * @return {!webdriver.promise.Promise.<!Array.<T>>} A promise that is
+ * @return {!promise.Promise<!Array<T>>} A promise that is
  *     fulfilled with an array containing the fulfilled values of the
  *     input array, or rejected with the same reason as the first
  *     rejected value.
  * @template T
  */
-webdriver.promise.all = function(arr) {
-  var n = arr.length;
-  if (!n) {
-    return webdriver.promise.fulfilled([]);
-  }
-
-  var toFulfill = n;
-  var result = webdriver.promise.defer();
-  var values = [];
+promise.all = function(arr) {
+  return new promise.Promise(function(fulfill, reject) {
+    var n = arr.length;
+    var values = [];
 
-  var onFulfill = function(index, value) {
-    values[index] = value;
-    toFulfill--;
-    if (toFulfill == 0) {
-      result.fulfill(values);
+    if (!n) {
+      fulfill(values);
+      return;
     }
-  };
 
-  for (var i = 0; i < n; ++i) {
-    webdriver.promise.asap(
-        arr[i], goog.partial(onFulfill, i), result.reject);
-  }
+    var toFulfill = n;
+    var onFulfilled = function(index, value) {
+      values[index] = value;
+      toFulfill--;
+      if (toFulfill == 0) {
+        fulfill(values);
+      }
+    };
 
-  return result.promise;
+    for (var i = 0; i < n; ++i) {
+      promise.asap(arr[i], goog.partial(onFulfilled, i), reject);
+    }
+  });
 };
 
 
@@ -780,27 +1642,53 @@ webdriver.promise.all = function(arr) {
  * new array, which is used as the fulfillment value of the promise returned
  * by this function.
  *
- * <p>If the return value of the mapping function is a promise, this function
+ * If the return value of the mapping function is a promise, this function
  * will wait for it to be fulfilled before inserting it into the new array.
  *
- * <p>If the mapping function throws or returns a rejected promise, the
+ * If the mapping function throws or returns a rejected promise, the
  * promise returned by this function will be rejected with the same reason.
  * Only the first failure will be reported; all subsequent errors will be
  * silently ignored.
  *
- * @param {!(Array.<TYPE>|webdriver.promise.Promise.<!Array.<TYPE>>)} arr The
+ * @param {!(Array<TYPE>|promise.Promise<!Array<TYPE>>)} arr The
  *     array to iterator over, or a promise that will resolve to said array.
- * @param {function(this: SELF, TYPE, number, !Array.<TYPE>): ?} fn The
+ * @param {function(this: SELF, TYPE, number, !Array<TYPE>): ?} fn The
  *     function to call for each element in the array. This function should
  *     expect three arguments (the element, the index, and the array itself.
  * @param {SELF=} opt_self The object to be used as the value of 'this' within
  *     {@code fn}.
  * @template TYPE, SELF
  */
-webdriver.promise.map = function(arr, fn, opt_self) {
-  return webdriver.promise.when(arr, function(arr) {
-    var result = goog.array.map(arr, fn, opt_self);
-    return webdriver.promise.all(result);
+promise.map = function(arr, fn, opt_self) {
+  return promise.fulfilled(arr).then(function(v) {
+    goog.asserts.assertNumber(v.length, 'not an array like value');
+    var arr = /** @type {!Array} */(v);
+    return new promise.Promise(function(fulfill, reject) {
+      var n = arr.length;
+      var values = new Array(n);
+      (function processNext(i) {
+        for (; i < n; i++) {
+          if (i in arr) {
+            break;
+          }
+        }
+        if (i >= n) {
+          fulfill(values);
+          return;
+        }
+        try {
+          promise.asap(
+              fn.call(opt_self, arr[i], i, /** @type {!Array} */(arr)),
+              function(value) {
+                values[i] = value;
+                processNext(i + 1);
+              },
+              reject);
+        } catch (ex) {
+          reject(ex);
+        }
+      })(0);
+    });
   });
 };
 
@@ -809,31 +1697,55 @@ webdriver.promise.map = function(arr, fn, opt_self) {
  * Calls a function for each element in an array, and if the function returns
  * true adds the element to a new array.
  *
- * <p>If the return value of the filter function is a promise, this function
+ * If the return value of the filter function is a promise, this function
  * will wait for it to be fulfilled before determining whether to insert the
  * element into the new array.
  *
- * <p>If the filter function throws or returns a rejected promise, the promise
+ * If the filter function throws or returns a rejected promise, the promise
  * returned by this function will be rejected with the same reason. Only the
  * first failure will be reported; all subsequent errors will be silently
  * ignored.
  *
- * @param {!(Array.<TYPE>|webdriver.promise.Promise.<!Array.<TYPE>>)} arr The
+ * @param {!(Array<TYPE>|promise.Promise<!Array<TYPE>>)} arr The
  *     array to iterator over, or a promise that will resolve to said array.
- * @param {function(this: SELF, TYPE, number, !Array.<TYPE>): (
- *             boolean|webdriver.promise.Promise.<boolean>)} fn The function
+ * @param {function(this: SELF, TYPE, number, !Array<TYPE>): (
+ *             boolean|promise.Promise<boolean>)} fn The function
  *     to call for each element in the array.
  * @param {SELF=} opt_self The object to be used as the value of 'this' within
  *     {@code fn}.
  * @template TYPE, SELF
  */
-webdriver.promise.filter = function(arr, fn, opt_self) {
-  return webdriver.promise.when(arr, function(arr) {
-    var originalValues = goog.array.clone(arr);
-    return webdriver.promise.map(arr, fn, opt_self).then(function(include) {
-      return goog.array.filter(originalValues, function(value, index) {
-        return include[index];
-      });
+promise.filter = function(arr, fn, opt_self) {
+  return promise.fulfilled(arr).then(function(v) {
+    goog.asserts.assertNumber(v.length, 'not an array like value');
+    var arr = /** @type {!Array} */(v);
+    return new promise.Promise(function(fulfill, reject) {
+      var n = arr.length;
+      var values = [];
+      var valuesLength = 0;
+      (function processNext(i) {
+        for (; i < n; i++) {
+          if (i in arr) {
+            break;
+          }
+        }
+        if (i >= n) {
+          fulfill(values);
+          return;
+        }
+        try {
+          var value = arr[i];
+          var include = fn.call(opt_self, value, i, /** @type {!Array} */(arr));
+          promise.asap(include, function(include) {
+            if (include) {
+              values[valuesLength++] = value;
+            }
+            processNext(i + 1);
+            }, reject);
+        } catch (ex) {
+          reject(ex);
+        }
+      })(0);
     });
   });
 };
@@ -849,45 +1761,42 @@ webdriver.promise.filter = function(arr, fn, opt_self) {
  *
  * Warning: This function makes no checks against objects that contain
  * cyclical references:
- * <pre><code>
- *   var value = {};
- *   value['self'] = value;
- *   webdriver.promise.fullyResolved(value);  // Stack overflow.
- * </code></pre>
+ *
+ *     var value = {};
+ *     value['self'] = value;
+ *     promise.fullyResolved(value);  // Stack overflow.
  *
  * @param {*} value The value to fully resolve.
- * @return {!webdriver.promise.Promise} A promise for a fully resolved version
+ * @return {!promise.Promise} A promise for a fully resolved version
  *     of the input value.
  */
-webdriver.promise.fullyResolved = function(value) {
-  if (webdriver.promise.isPromise(value)) {
-    return webdriver.promise.when(value, webdriver.promise.fullyResolveValue_);
+promise.fullyResolved = function(value) {
+  if (promise.isPromise(value)) {
+    return promise.when(value, fullyResolveValue);
   }
-  return webdriver.promise.fullyResolveValue_(value);
+  return fullyResolveValue(value);
 };
 
 
 /**
  * @param {*} value The value to fully resolve. If a promise, assumed to
  *     already be resolved.
- * @return {!webdriver.promise.Promise} A promise for a fully resolved version
+ * @return {!promise.Promise} A promise for a fully resolved version
  *     of the input value.
- * @private
  */
-webdriver.promise.fullyResolveValue_ = function(value) {
+ function fullyResolveValue(value) {
   switch (goog.typeOf(value)) {
     case 'array':
-      return webdriver.promise.fullyResolveKeys_(
-          /** @type {!Array} */ (value));
+      return fullyResolveKeys(/** @type {!Array} */ (value));
 
     case 'object':
-      if (webdriver.promise.isPromise(value)) {
+      if (promise.isPromise(value)) {
         // We get here when the original input value is a promise that
         // resolves to itself. When the user provides us with such a promise,
         // trust that it counts as a "fully resolved" value and return it.
         // Of course, since it's already a promise, we can just return it
         // to the user instead of wrapping it in another promise.
-        return /** @type {!webdriver.promise.Promise} */ (value);
+        return /** @type {!promise.Promise} */ (value);
       }
 
       if (goog.isNumber(value.nodeType) &&
@@ -895,76 +1804,72 @@ webdriver.promise.fullyResolveValue_ = function(value) {
           goog.isNumber(value.ownerDocument.nodeType)) {
         // DOM node; return early to avoid infinite recursion. Should we
         // only support objects with a certain level of nesting?
-        return webdriver.promise.fulfilled(value);
+        return promise.fulfilled(value);
       }
 
-      return webdriver.promise.fullyResolveKeys_(
-          /** @type {!Object} */ (value));
+      return fullyResolveKeys(/** @type {!Object} */ (value));
 
     default:  // boolean, function, null, number, string, undefined
-      return webdriver.promise.fulfilled(value);
+      return promise.fulfilled(value);
   }
-};
+}
 
 
 /**
  * @param {!(Array|Object)} obj the object to resolve.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
+ * @return {!promise.Promise} A promise that will be resolved with the
  *     input object once all of its values have been fully resolved.
- * @private
  */
-webdriver.promise.fullyResolveKeys_ = function(obj) {
+ function fullyResolveKeys(obj) {
   var isArray = goog.isArray(obj);
-  var numKeys = isArray ? obj.length : goog.object.getCount(obj);
+  var numKeys = isArray ? obj.length : Objects.getCount(obj);
   if (!numKeys) {
-    return webdriver.promise.fulfilled(obj);
+    return promise.fulfilled(obj);
   }
 
   var numResolved = 0;
-  var deferred = new webdriver.promise.Deferred();
-
-  // In pre-IE9, goog.array.forEach will not iterate properly over arrays
-  // containing undefined values because "index in array" returns false
-  // when array[index] === undefined (even for x = [undefined, 1]). To get
-  // around this, we need to use our own forEach implementation.
-  // DO NOT REMOVE THIS UNTIL WE NO LONGER SUPPORT IE8. This cannot be
-  // reproduced in IE9 by changing the browser/document modes, it requires an
-  // actual pre-IE9 browser.  Yay, IE!
-  var forEachKey = !isArray ? goog.object.forEach : function(arr, fn) {
-    var n = arr.length;
-    for (var i = 0; i < n; ++i) {
-      fn.call(null, arr[i], i, arr);
-    }
-  };
-
-  forEachKey(obj, function(partialValue, key) {
-    var type = goog.typeOf(partialValue);
-    if (type != 'array' && type != 'object') {
-      maybeResolveValue();
-      return;
-    }
+  return new promise.Promise(function(fulfill, reject) {
+    // In pre-IE9, goog.array.forEach will not iterate properly over arrays
+    // containing undefined values because "index in array" returns false
+    // when array[index] === undefined (even for x = [undefined, 1]). To get
+    // around this, we need to use our own forEach implementation.
+    // DO NOT REMOVE THIS UNTIL WE NO LONGER SUPPORT IE8. This cannot be
+    // reproduced in IE9 by changing the browser/document modes, it requires an
+    // actual pre-IE9 browser.  Yay, IE!
+    var forEachKey = !isArray ? Objects.forEach : function(arr, fn) {
+      var n = arr.length;
+      for (var i = 0; i < n; ++i) {
+        fn.call(null, arr[i], i, arr);
+      }
+    };
 
-    webdriver.promise.fullyResolved(partialValue).then(
-        function(resolvedValue) {
-          obj[key] = resolvedValue;
-          maybeResolveValue();
-        },
-        deferred.reject);
-  });
+    forEachKey(obj, function(partialValue, key) {
+      var type = goog.typeOf(partialValue);
+      if (type != 'array' && type != 'object') {
+        maybeResolveValue();
+        return;
+      }
 
-  return deferred.promise;
+      promise.fullyResolved(partialValue).then(
+          function(resolvedValue) {
+            obj[key] = resolvedValue;
+            maybeResolveValue();
+          },
+          reject);
+    });
 
-  function maybeResolveValue() {
-    if (++numResolved == numKeys) {
-      deferred.fulfill(obj);
+    function maybeResolveValue() {
+      if (++numResolved == numKeys) {
+        fulfill(obj);
+      }
     }
-  }
-};
+  });
+}
 
 
 //////////////////////////////////////////////////////////////////////////////
 //
-//  webdriver.promise.ControlFlow
+//  promise.ControlFlow
 //
 //////////////////////////////////////////////////////////////////////////////
 
@@ -976,1078 +1881,1024 @@ webdriver.promise.fullyResolveKeys_ = function(obj) {
  * the ordered scheduled, starting each task only once those before it have
  * completed.
  *
- * <p>Each task scheduled within this flow may return a
+ * Each task scheduled within this flow may return a
  * {@link webdriver.promise.Promise} to indicate it is an asynchronous
  * operation. The ControlFlow will wait for such promises to be resolved before
  * marking the task as completed.
  *
- * <p>Tasks and each callback registered on a {@link webdriver.promise.Deferred}
+ * Tasks and each callback registered on a {@link webdriver.promise.Promise}
  * will be run in their own ControlFlow frame.  Any tasks scheduled within a
- * frame will have priority over previously scheduled tasks. Furthermore, if
- * any of the tasks in the frame fails, the remainder of the tasks in that frame
- * will be discarded and the failure will be propagated to the user through the
+ * frame will take priority over previously scheduled tasks. Furthermore, if any
+ * of the tasks in the frame fail, the remainder of the tasks in that frame will
+ * be discarded and the failure will be propagated to the user through the
  * callback/task's promised result.
  *
- * <p>Each time a ControlFlow empties its task queue, it will fire an
- * {@link webdriver.promise.ControlFlow.EventType.IDLE} event. Conversely,
+ * Each time a ControlFlow empties its task queue, it will fire an
+ * {@link webdriver.promise.ControlFlow.EventType.IDLE IDLE} event. Conversely,
  * whenever the flow terminates due to an unhandled error, it will remove all
  * remaining tasks in its queue and fire an
- * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION} event. If
- * there are no listeners registered with the flow, the error will be
- * rethrown to the global error handler.
- *
- * @param {webdriver.promise.ControlFlow.Timer=} opt_timer The timer object
- *     to use. Should only be set for testing.
- * @constructor
- * @extends {webdriver.EventEmitter}
- */
-webdriver.promise.ControlFlow = function(opt_timer) {
-  webdriver.EventEmitter.call(this);
+ * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION
+ * UNCAUGHT_EXCEPTION} event. If there are no listeners registered with the
+ * flow, the error will be rethrown to the global error handler.
+ *
+ * Refer to the {@link webdriver.promise} module documentation for a detailed
+ * explanation of how the ControlFlow coordinates task execution.
+ *
+ * @final
+ */
+promise.ControlFlow = goog.defineClass(EventEmitter, {
+  // TODO: remove this empty comment when the compiler properly handles
+  // goog.defineClass with a missing constructor comment.
+  /** @constructor */
+  constructor: function() {
+    promise.ControlFlow.base(this, 'constructor');
+
+    /** @private {boolean} */
+    this.propagateUnhandledRejections_ = true;
+
+    /** @private {TaskQueue} */
+    this.activeQueue_ = null;
+
+    /** @private {Set<TaskQueue>} */
+    this.taskQueues_ = null;
+
+    /**
+     * Micro task that controls shutting down the control flow. Upon shut down,
+     * the flow will emit an
+     * {@link webdriver.promise.ControlFlow.EventType.IDLE} event. Idle events
+     * always follow a brief timeout in order to catch latent errors from the
+     * last completed task. If this task had a callback registered, but no
+     * errback, and the task fails, the unhandled failure would not be reported
+     * by the promise system until the next turn of the event loop:
+     *
+     *   // Schedule 1 task that fails.
+     *   var result = promise.controlFlow().schedule('example',
+     *       function() { return promise.rejected('failed'); });
+     *   // Set a callback on the result. This delays reporting the unhandled
+     *   // failure for 1 turn of the event loop.
+     *   result.then(goog.nullFunction);
+     *
+     * @private {MicroTask}
+     */
+    this.shutdownTask_ = null;
+
+    /**
+     * ID for a long running interval used to keep a Node.js process running
+     * while a control flow's event loop is still working. This is a cheap hack
+     * required since JS events are only scheduled to run when there is
+     * _actually_ something to run. When a control flow is waiting on a task,
+     * there will be nothing in the JS event loop and the process would
+     * terminate without this.
+     *
+     * @private {?number}
+     */
+    this.hold_ = null;
+  },
 
   /**
-   * The timer used by this instance.
-   * @type {webdriver.promise.ControlFlow.Timer}
+   * Returns a string representation of this control flow, which is its current
+   * {@link #getSchedule() schedule}, sans task stack traces.
+   * @return {string} The string representation of this contorl flow.
+   * @override
    */
-  this.timer = opt_timer || webdriver.promise.ControlFlow.defaultTimer;
+  toString: function() {
+    return this.getSchedule();
+  },
 
   /**
-   * A list of recent tasks. Each time a new task is started, or a frame is
-   * completed, the previously recorded task is removed from this list. If
-   * there are multiple tasks, task N+1 is considered a sub-task of task
-   * N.
-   * @private {!Array.<!webdriver.promise.Task_>}
+   * Sets whether any unhandled rejections should propagate up through the
+   * control flow stack and cause rejections within parent tasks. If error
+   * propagation is disabled, tasks will not be aborted when an unhandled
+   * promise rejection is detected, but the rejection _will_ trigger an
+   * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION}
+   * event.
+   *
+   * The default behavior is to propagate all unhandled rejections. _The use
+   * of this option is highly discouraged._
+   *
+   * @param {boolean} propagate whether to propagate errors.
    */
-  this.history_ = [];
-};
-goog.inherits(webdriver.promise.ControlFlow, webdriver.EventEmitter);
-
-
-/**
- * @typedef {{clearInterval: function(number),
- *            clearTimeout: function(number),
- *            setInterval: function(!Function, number): number,
- *            setTimeout: function(!Function, number): number}}
- */
-webdriver.promise.ControlFlow.Timer;
-
-
-/**
- * The default timer object, which uses the global timer functions.
- * @type {webdriver.promise.ControlFlow.Timer}
- */
-webdriver.promise.ControlFlow.defaultTimer = (function() {
-  // The default timer functions may be defined as free variables for the
-  // current context, so do not reference them using "window" or
-  // "goog.global".  Also, we must invoke them in a closure, and not using
-  // bind(), so we do not get "TypeError: Illegal invocation" (WebKit) or
-  // "Invalid calling object" (IE) errors.
-  return {
-    clearInterval: wrap(clearInterval),
-    clearTimeout: wrap(clearTimeout),
-    setInterval: wrap(setInterval),
-    setTimeout: wrap(setTimeout)
-  };
-
-  function wrap(fn) {
-    return function() {
-      // Cannot use .call() or .apply() since we do not know which variable
-      // the function is bound to, and using the wrong one will generate
-      // an error.
-      return fn(arguments[0], arguments[1]);
-    };
-  }
-})();
-
-
-/**
- * Events that may be emitted by an {@link webdriver.promise.ControlFlow}.
- * @enum {string}
- */
-webdriver.promise.ControlFlow.EventType = {
-
-  /** Emitted when all tasks have been successfully executed. */
-  IDLE: 'idle',
-
-  /** Emitted whenever a new task has been scheduled. */
-  SCHEDULE_TASK: 'scheduleTask',
+  setPropagateUnhandledRejections: function(propagate) {
+    this.propagateUnhandledRejections_ = propagate;
+  },
 
   /**
-   * Emitted whenever a control flow aborts due to an unhandled promise
-   * rejection. This event will be emitted along with the offending rejection
-   * reason. Upon emitting this event, the control flow will empty its task
-   * queue and revert to its initial state.
+   * @return {boolean} Whether this flow is currently idle.
    */
-  UNCAUGHT_EXCEPTION: 'uncaughtException'
-};
-
-
-/**
- * How often, in milliseconds, the event loop should run.
- * @type {number}
- * @const
- */
-webdriver.promise.ControlFlow.EVENT_LOOP_FREQUENCY = 10;
-
-
-/**
- * Tracks the active execution frame for this instance. Lazily initialized
- * when the first task is scheduled.
- * @private {webdriver.promise.Frame_}
- */
-webdriver.promise.ControlFlow.prototype.activeFrame_ = null;
-
-
-/**
- * A reference to the frame in which new tasks should be scheduled. If
- * {@code null}, tasks will be scheduled within the active frame. When forcing
- * a function to run in the context of a new frame, this pointer is used to
- * ensure tasks are scheduled within the newly created frame, even though it
- * won't be active yet.
- * @private {webdriver.promise.Frame_}
- * @see {#runInNewFrame_}
- */
-webdriver.promise.ControlFlow.prototype.schedulingFrame_ = null;
-
-
-/**
- * Timeout ID set when the flow is about to shutdown without any errors
- * being detected. Upon shutting down, the flow will emit an
- * {@link webdriver.promise.ControlFlow.EventType.IDLE} event. Idle events
- * always follow a brief timeout in order to catch latent errors from the last
- * completed task. If this task had a callback registered, but no errback, and
- * the task fails, the unhandled failure would not be reported by the promise
- * system until the next turn of the event loop:
- *
- *   // Schedule 1 task that fails.
- *   var result = webriver.promise.controlFlow().schedule('example',
- *       function() { return webdriver.promise.rejected('failed'); });
- *   // Set a callback on the result. This delays reporting the unhandled
- *   // failure for 1 turn of the event loop.
- *   result.then(goog.nullFunction);
- *
- * @private {?number}
- */
-webdriver.promise.ControlFlow.prototype.shutdownId_ = null;
-
-
-/**
- * Interval ID for this instance's event loop.
- * @private {?number}
- */
-webdriver.promise.ControlFlow.prototype.eventLoopId_ = null;
-
-
-/**
- * The number of "pending" promise rejections.
- *
- * <p>Each time a promise is rejected and is not handled by a listener, it will
- * schedule a 0-based timeout to check if it is still unrejected in the next
- * turn of the JS-event loop. This allows listeners to attach to, and handle,
- * the rejected promise at any point in same turn of the event loop that the
- * promise was rejected.
- *
- * <p>When this flow's own event loop triggers, it will not run if there
- * are any outstanding promise rejections. This allows unhandled promises to
- * be reported before a new task is started, ensuring the error is reported to
- * the current task queue.
- *
- * @private {number}
- */
-webdriver.promise.ControlFlow.prototype.pendingRejections_ = 0;
-
-
-/**
- * The number of aborted frames since the last time a task was executed or a
- * frame completed successfully.
- * @private {number}
- */
-webdriver.promise.ControlFlow.prototype.numAbortedFrames_ = 0;
-
-
-/**
- * Resets this instance, clearing its queue and removing all event listeners.
- */
-webdriver.promise.ControlFlow.prototype.reset = function() {
-  this.activeFrame_ = null;
-  this.clearHistory();
-  this.removeAllListeners();
-  this.cancelShutdown_();
-  this.cancelEventLoop_();
-};
-
-
-/**
- * Returns a summary of the recent task activity for this instance. This
- * includes the most recently completed task, as well as any parent tasks. In
- * the returned summary, the task at index N is considered a sub-task of the
- * task at index N+1.
- * @return {!Array.<string>} A summary of this instance's recent task
- *     activity.
- */
-webdriver.promise.ControlFlow.prototype.getHistory = function() {
-  var pendingTasks = [];
-  var currentFrame = this.activeFrame_;
-  while (currentFrame) {
-    var task = currentFrame.getPendingTask();
-    if (task) {
-      pendingTasks.push(task);
-    }
-    // A frame's parent node will always be another frame.
-    currentFrame =
-        /** @type {webdriver.promise.Frame_} */ (currentFrame.getParent());
-  }
-
-  var fullHistory = goog.array.concat(this.history_, pendingTasks);
-  return goog.array.map(fullHistory, function(task) {
-    return task.toString();
-  });
-};
-
-
-/** Clears this instance's task history. */
-webdriver.promise.ControlFlow.prototype.clearHistory = function() {
-  this.history_ = [];
-};
-
-
-/**
- * Removes a completed task from this instance's history record. If any
- * tasks remain from aborted frames, those will be removed as well.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.trimHistory_ = function() {
-  if (this.numAbortedFrames_) {
-    goog.array.splice(this.history_,
-        this.history_.length - this.numAbortedFrames_,
-        this.numAbortedFrames_);
-    this.numAbortedFrames_ = 0;
-  }
-  this.history_.pop();
-};
-
-
-/**
- * Property used to track whether an error has been annotated by
- * {@link webdriver.promise.ControlFlow#annotateError}.
- * @private {string}
- * @const
- */
-webdriver.promise.ControlFlow.ANNOTATION_PROPERTY_ =
-    'webdriver_promise_error_';
-
-
-/**
- * Appends a summary of this instance's recent task history to the given
- * error's stack trace. This function will also ensure the error's stack trace
- * is in canonical form.
- * @param {!(Error|goog.testing.JsUnitException)} e The error to annotate.
- * @return {!(Error|goog.testing.JsUnitException)} The annotated error.
- */
-webdriver.promise.ControlFlow.prototype.annotateError = function(e) {
-  if (!!e[webdriver.promise.ControlFlow.ANNOTATION_PROPERTY_]) {
-    return e;
-  }
-
-  var history = this.getHistory();
-  if (history.length) {
-    e = webdriver.stacktrace.format(e);
-
-    /** @type {!Error} */(e).stack += [
-      '\n==== async task ====\n',
-      history.join('\n==== async task ====\n')
-    ].join('');
-
-    e[webdriver.promise.ControlFlow.ANNOTATION_PROPERTY_] = true;
-  }
-
-  return e;
-};
-
-
-/**
- * @return {string} The scheduled tasks still pending with this instance.
- */
-webdriver.promise.ControlFlow.prototype.getSchedule = function() {
-  return this.activeFrame_ ? this.activeFrame_.getRoot().toString() : '[]';
-};
-
-
-/**
- * Schedules a task for execution. If there is nothing currently in the
- * queue, the task will be executed in the next turn of the event loop.
- *
- * @param {!Function} fn The function to call to start the task. If the
- *     function returns a {@link webdriver.promise.Promise}, this instance
- *     will wait for it to be resolved before starting the next task.
- * @param {string=} opt_description A description of the task.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with
- *     the result of the action.
- */
-webdriver.promise.ControlFlow.prototype.execute = function(
-    fn, opt_description) {
-  this.cancelShutdown_();
-
-  if (!this.activeFrame_) {
-    this.activeFrame_ = new webdriver.promise.Frame_(this);
-  }
-
-  // Trim an extra frame off the generated stack trace for the call to this
-  // function.
-  var snapshot = new webdriver.stacktrace.Snapshot(1);
-  var task = new webdriver.promise.Task_(
-      this, fn, opt_description || '', snapshot);
-  var scheduleIn = this.schedulingFrame_ || this.activeFrame_;
-  scheduleIn.addChild(task);
-
-  this.emit(webdriver.promise.ControlFlow.EventType.SCHEDULE_TASK);
-
-  this.scheduleEventLoopStart_();
-  return task.promise;
-};
-
+  isIdle: function() {
+    return !this.shutdownTask_ && (!this.taskQueues_ || !this.taskQueues_.size);
+  },
 
-/**
- * Inserts a {@code setTimeout} into the command queue. This is equivalent to
- * a thread sleep in a synchronous programming language.
- *
- * @param {number} ms The timeout delay, in milliseconds.
- * @param {string=} opt_description A description to accompany the timeout.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with
- *     the result of the action.
- */
-webdriver.promise.ControlFlow.prototype.timeout = function(
-    ms, opt_description) {
-  return this.execute(function() {
-    return webdriver.promise.delayed(ms);
-  }, opt_description);
-};
+  /**
+   * Resets this instance, clearing its queue and removing all event listeners.
+   */
+  reset: function() {
+    this.cancelQueues_(new FlowResetError);
+    this.emit(promise.ControlFlow.EventType.RESET);
+    this.removeAllListeners();
+    this.cancelShutdown_();
+  },
 
+  /**
+   * Generates an annotated string describing the internal state of this control
+   * flow, including the currently executing as well as pending tasks. If
+   * {@code opt_includeStackTraces === true}, the string will include the
+   * stack trace from when each task was scheduled.
+   * @param {string=} opt_includeStackTraces Whether to include the stack traces
+   *     from when each task was scheduled. Defaults to false.
+   * @return {string} String representation of this flow's internal state.
+   */
+  getSchedule: function(opt_includeStackTraces) {
+    var ret = 'ControlFlow::' + goog.getUid(this);
+    var activeQueue = this.activeQueue_;
+    if (!this.taskQueues_ || !this.taskQueues_.size) {
+      return ret;
+    }
+    var childIndent = '| ';
+    for (var q of this.taskQueues_) {
+      ret += '\n' + printQ(q, childIndent);
+    }
+    return ret;
 
-/**
- * Schedules a task that shall wait for a condition to hold. Each condition
- * function may return any value, but it will always be evaluated as a boolean.
- *
- * <p>Condition functions may schedule sub-tasks with this instance, however,
- * their execution time will be factored into whether a wait has timed out.
- *
- * <p>In the event a condition returns a Promise, the polling loop will wait for
- * it to be resolved before evaluating whether the condition has been satisfied.
- * The resolution time for a promise is factored into whether a wait has timed
- * out.
- *
- * <p>If the condition function throws, or returns a rejected promise, the
- * wait task will fail.
- *
- * @param {!Function} condition The condition function to poll.
- * @param {number} timeout How long to wait, in milliseconds, for the condition
- *     to hold before timing out.
- * @param {string=} opt_message An optional error message to include if the
- *     wait times out; defaults to the empty string.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     condition has been satisified. The promise shall be rejected if the wait
- *     times out waiting for the condition.
- */
-webdriver.promise.ControlFlow.prototype.wait = function(
-    condition, timeout, opt_message) {
-  var sleep = Math.min(timeout, 100);
-  var self = this;
-
-  return this.execute(function() {
-    var startTime = goog.now();
-    var waitResult = new webdriver.promise.Deferred();
-    var waitFrame = self.activeFrame_;
-    waitFrame.isWaiting = true;
-    pollCondition();
-    return waitResult.promise;
-
-    function pollCondition() {
-      self.runInNewFrame_(condition, function(value) {
-        var elapsed = goog.now() - startTime;
-        if (!!value) {
-          waitFrame.isWaiting = false;
-          waitResult.fulfill(value);
-        } else if (elapsed >= timeout) {
-          waitResult.reject(new Error((opt_message ? opt_message + '\n' : '') +
-              'Wait timed out after ' + elapsed + 'ms'));
+    function printQ(q, indent) {
+      var ret = q.toString();
+      if (q === activeQueue) {
+        ret = '(active) ' + ret;
+      }
+      var prefix = indent + childIndent;
+      if (q.pending_) {
+        if (q.pending_.q.state_ !== TaskQueueState.FINISHED) {
+          ret += '\n' + prefix + '(pending) ' + q.pending_.task;
+          ret += '\n' + printQ(q.pending_.q, prefix + childIndent);
         } else {
-          self.timer.setTimeout(pollCondition, sleep);
+          ret += '\n' + prefix + '(blocked) ' + q.pending_.task;
         }
-      }, waitResult.reject, true);
+      }
+      if (q.interrupts_) {
+        q.interrupts_.forEach((task) => {
+          ret += '\n' + prefix + task;
+        });
+      }
+      if (q.tasks_) {
+        q.tasks_.forEach((task) => ret += printTask(task, '\n' + prefix));
+      }
+      return indent + ret;
     }
-  }, opt_message);
-};
-
-
-/**
- * Schedules a task that will wait for another promise to resolve.  The resolved
- * promise's value will be returned as the task result.
- * @param {!webdriver.promise.Promise} promise The promise to wait on.
- * @return {!webdriver.promise.Promise} A promise that will resolve when the
- *     task has completed.
- */
-webdriver.promise.ControlFlow.prototype.await = function(promise) {
-  return this.execute(function() {
-    return promise;
-  });
-};
-
-
-/**
- * Schedules the interval for this instance's event loop, if necessary.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.scheduleEventLoopStart_ = function() {
-  if (!this.eventLoopId_) {
-    this.eventLoopId_ = this.timer.setInterval(
-        goog.bind(this.runEventLoop_, this),
-        webdriver.promise.ControlFlow.EVENT_LOOP_FREQUENCY);
-  }
-};
-
-
-/**
- * Cancels the event loop, if necessary.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.cancelEventLoop_ = function() {
-  if (this.eventLoopId_) {
-    this.timer.clearInterval(this.eventLoopId_);
-    this.eventLoopId_ = null;
-  }
-};
-
-
-/**
- * Executes the next task for the current frame. If the current frame has no
- * more tasks, the frame's result will be resolved, returning control to the
- * frame's creator. This will terminate the flow if the completed frame was at
- * the top of the stack.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.runEventLoop_ = function() {
-  // If we get here and there are pending promise rejections, then those
-  // promises are queued up to run as soon as this (JS) event loop terminates.
-  // Short-circuit our loop to give those promises a chance to run. Otherwise,
-  // we might start a new task only to have it fail because of one of these
-  // pending rejections.
-  if (this.pendingRejections_) {
-    return;
-  }
 
-  // If the flow aborts due to an unhandled exception after we've scheduled
-  // another turn of the execution loop, we can end up in here with no tasks
-  // left. This is OK, just quietly return.
-  if (!this.activeFrame_) {
-    this.commenceShutdown_();
-    return;
-  }
-
-  var task;
-  if (this.activeFrame_.getPendingTask() || !(task = this.getNextTask_())) {
-    // Either the current frame is blocked on a pending task, or we don't have
-    // a task to finish because we've completed a frame. When completing a
-    // frame, we must abort the event loop to allow the frame's promise's
-    // callbacks to execute.
-    return;
-  }
-
-  var activeFrame = this.activeFrame_;
-  activeFrame.setPendingTask(task);
-  var markTaskComplete = goog.bind(function() {
-    this.history_.push(/** @type {!webdriver.promise.Task_} */ (task));
-    activeFrame.setPendingTask(null);
-  }, this);
-
-  this.trimHistory_();
-  var self = this;
-  this.runInNewFrame_(task.execute, function(result) {
-    markTaskComplete();
-    task.fulfill(result);
-  }, function(error) {
-    markTaskComplete();
-
-    if (!webdriver.promise.isError_(error) &&
-        !webdriver.promise.isPromise(error)) {
-      error = Error(error);
+    function printTask(task, prefix) {
+      var ret = prefix + task;
+      if (opt_includeStackTraces && task.promise.stack_) {
+        ret += prefix + childIndent
+            + (task.promise.stack_.stack || task.promise.stack_)
+                  .replace(/\n/g, prefix);
+      }
+      return ret;
     }
+  },
 
-    task.reject(self.annotateError(/** @type {!Error} */ (error)));
-  }, true);
-};
-
+  /**
+   * Returns the currently actively task queue for this flow. If there is no
+   * active queue, one will be created.
+   * @return {!TaskQueue} the currently active task queue for this flow.
+   * @private
+   */
+  getActiveQueue_: function() {
+    if (this.activeQueue_) {
+      return this.activeQueue_;
+    }
 
-/**
- * @return {webdriver.promise.Task_} The next task to execute, or
- *     {@code null} if a frame was resolved.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.getNextTask_ = function() {
-  var firstChild = this.activeFrame_.getFirstChild();
-  if (!firstChild) {
-    if (!this.activeFrame_.isWaiting) {
-      this.resolveFrame_(this.activeFrame_);
+    this.activeQueue_ = new TaskQueue(this);
+    if (!this.taskQueues_) {
+      this.taskQueues_ = new Set();
     }
-    return null;
-  }
+    this.taskQueues_.add(this.activeQueue_);
+    this.activeQueue_
+        .once('end', this.onQueueEnd_, this)
+        .once('error', this.onQueueError_, this);
 
-  if (firstChild instanceof webdriver.promise.Frame_) {
-    this.activeFrame_ = firstChild;
-    return this.getNextTask_();
-  }
+    asyncRun(() => this.activeQueue_ = null, this);
+    this.activeQueue_.start();
+    return this.activeQueue_;
+  },
 
-  firstChild.getParent().removeChild(firstChild);
-  return firstChild;
-};
+  /**
+   * Schedules a task for execution. If there is nothing currently in the
+   * queue, the task will be executed in the next turn of the event loop. If
+   * the task function is a generator, the task will be executed using
+   * {@link webdriver.promise.consume}.
+   *
+   * @param {function(): (T|promise.Promise<T>)} fn The function to
+   *     call to start the task. If the function returns a
+   *     {@link webdriver.promise.Promise}, this instance will wait for it to be
+   *     resolved before starting the next task.
+   * @param {string=} opt_description A description of the task.
+   * @return {!promise.Promise<T>} A promise that will be resolved
+   *     with the result of the action.
+   * @template T
+   */
+  execute: function(fn, opt_description) {
+    if (promise.isGenerator(fn)) {
+      fn = goog.partial(promise.consume, fn);
+    }
 
+    if (!this.hold_) {
+      var holdIntervalMs = 2147483647;  // 2^31-1; max timer length for Node.js
+      this.hold_ = setInterval(goog.nullFunction, holdIntervalMs);
+    }
 
-/**
- * @param {!webdriver.promise.Frame_} frame The frame to resolve.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.resolveFrame_ = function(frame) {
-  if (this.activeFrame_ === frame) {
-    // Frame parent is always another frame, but the compiler is not smart
-    // enough to recognize this.
-    this.activeFrame_ =
-        /** @type {webdriver.promise.Frame_} */ (frame.getParent());
-  }
+    var task = new Task(
+        this, fn, opt_description || '<anonymous>',
+        {name: 'Task', top: promise.ControlFlow.prototype.execute});
 
-  if (frame.getParent()) {
-    frame.getParent().removeChild(frame);
-  }
-  this.trimHistory_();
-  frame.fulfill();
+    var q = this.getActiveQueue_();
+    q.enqueue(task);
+    this.emit(promise.ControlFlow.EventType.SCHEDULE_TASK, task.description);
+    return task.promise;
+  },
 
-  if (!this.activeFrame_) {
-    this.commenceShutdown_();
-  }
-};
+  /**
+   * Inserts a {@code setTimeout} into the command queue. This is equivalent to
+   * a thread sleep in a synchronous programming language.
+   *
+   * @param {number} ms The timeout delay, in milliseconds.
+   * @param {string=} opt_description A description to accompany the timeout.
+   * @return {!promise.Promise} A promise that will be resolved with
+   *     the result of the action.
+   */
+  timeout: function(ms, opt_description) {
+    return this.execute(function() {
+      return promise.delayed(ms);
+    }, opt_description);
+  },
 
+  /**
+   * Schedules a task that shall wait for a condition to hold. Each condition
+   * function may return any value, but it will always be evaluated as a
+   * boolean.
+   *
+   * Condition functions may schedule sub-tasks with this instance, however,
+   * their execution time will be factored into whether a wait has timed out.
+   *
+   * In the event a condition returns a Promise, the polling loop will wait for
+   * it to be resolved before evaluating whether the condition has been
+   * satisfied. The resolution time for a promise is factored into whether a
+   * wait has timed out.
+   *
+   * If the condition function throws, or returns a rejected promise, the
+   * wait task will fail.
+   *
+   * If the condition is defined as a promise, the flow will wait for it to
+   * settle. If the timeout expires before the promise settles, the promise
+   * returned by this function will be rejected.
+   *
+   * If this function is invoked with `timeout === 0`, or the timeout is
+   * omitted, the flow will wait indefinitely for the condition to be satisfied.
+   *
+   * @param {(!promise.Promise<T>|function())} condition The condition to poll,
+   *     or a promise to wait on.
+   * @param {number=} opt_timeout How long to wait, in milliseconds, for the
+   *     condition to hold before timing out. If omitted, the flow will wait
+   *     indefinitely.
+   * @param {string=} opt_message An optional error message to include if the
+   *     wait times out; defaults to the empty string.
+   * @return {!promise.Promise<T>} A promise that will be fulfilled
+   *     when the condition has been satisified. The promise shall be rejected
+   *     if the wait times out waiting for the condition.
+   * @throws {TypeError} If condition is not a function or promise or if timeout
+   *     is not a number >= 0.
+   * @template T
+   */
+  wait: function(condition, opt_timeout, opt_message) {
+    var timeout = opt_timeout || 0;
+    if (!goog.isNumber(timeout) || timeout < 0) {
+      throw TypeError('timeout must be a number >= 0: ' + timeout);
+    }
 
-/**
- * Aborts the current frame. The frame, and all of the tasks scheduled within it
- * will be discarded. If this instance does not have an active frame, it will
- * immediately terminate all execution.
- * @param {*} error The reason the frame is being aborted; typically either
- *     an Error or string.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.abortFrame_ = function(error) {
-  // Annotate the error value if it is Error-like.
-  if (webdriver.promise.isError_(error)) {
-    this.annotateError(/** @type {!Error} */ (error));
-  }
-  this.numAbortedFrames_++;
+    if (promise.isPromise(condition)) {
+      return this.execute(function() {
+        if (!timeout) {
+          return condition;
+        }
+        return new promise.Promise(function(fulfill, reject) {
+          var start = goog.now();
+          var timer = setTimeout(function() {
+            timer = null;
+            reject(Error((opt_message ? opt_message + '\n' : '') +
+                         'Timed out waiting for promise to resolve after ' +
+                         (goog.now() - start) + 'ms'));
+          }, timeout);
+
+          /** @type {Thenable} */(condition).then(
+            function(value) {
+              timer && clearTimeout(timer);
+              fulfill(value);
+            },
+            function(error) {
+              timer && clearTimeout(timer);
+              reject(error);
+            });
+        });
+      }, opt_message || '<anonymous wait: promise resolution>');
+    }
 
-  if (!this.activeFrame_) {
-    this.abortNow_(error);
-    return;
-  }
+    if (!goog.isFunction(condition)) {
+      throw TypeError('Invalid condition; must be a function or promise: ' +
+                      goog.typeOf(condition));
+    }
 
-  // Frame parent is always another frame, but the compiler is not smart
-  // enough to recognize this.
-  var parent = /** @type {webdriver.promise.Frame_} */ (
-      this.activeFrame_.getParent());
-  if (parent) {
-    parent.removeChild(this.activeFrame_);
-  }
+    if (promise.isGenerator(condition)) {
+      condition = goog.partial(promise.consume, condition);
+    }
 
-  var frame = this.activeFrame_;
-  this.activeFrame_ = parent;
-  frame.reject(error);
-};
+    var self = this;
+    return this.execute(function() {
+      var startTime = goog.now();
+      return new promise.Promise(function(fulfill, reject) {
+        pollCondition();
+
+        function pollCondition() {
+          var conditionFn = /** @type {function()} */(condition);
+          self.execute(conditionFn).then(function(value) {
+            var elapsed = goog.now() - startTime;
+            if (!!value) {
+              fulfill(value);
+            } else if (timeout && elapsed >= timeout) {
+              reject(new Error((opt_message ? opt_message + '\n' : '') +
+                               'Wait timed out after ' + elapsed + 'ms'));
+            } else {
+              // Do not use asyncRun here because we need a non-micro yield
+              // here so the UI thread is given a chance when running in a
+              // browser.
+              setTimeout(pollCondition, 0);
+            }
+          }, reject);
+        }
+      });
+    }, opt_message || '<anonymous wait>');
+  },
 
+  /**
+   * Executes a function in the next available turn of the JavaScript event
+   * loop. This ensures the function runs with its own task queue and any
+   * scheduled tasks will run in "parallel" to those scheduled in the current
+   * function.
+   *
+   *     flow.execute(() => console.log('a'));
+   *     flow.execute(() => console.log('b'));
+   *     flow.execute(() => console.log('c'));
+   *     flow.async(() => {
+   *        flow.execute(() => console.log('d'));
+   *        flow.execute(() => console.log('e'));
+   *     });
+   *     flow.async(() => {
+   *        flow.execute(() => console.log('f'));
+   *        flow.execute(() => console.log('g'));
+   *     });
+   *     flow.once('idle', () => console.log('fin'));
+   *     // a
+   *     // d
+   *     // f
+   *     // b
+   *     // e
+   *     // g
+   *     // c
+   *     // fin
+   *
+   * If the function itself throws, the error will be treated the same as an
+   * unhandled rejection within the control flow.
+   *
+   * __NOTE__: This function is considered _unstable_.
+   *
+   * @param {!Function} fn The function to execute.
+   * @param {Object=} opt_self The object in whose context to run the function.
+   * @param {...*} var_args Any arguments to pass to the function.
+   */
+  async: function(fn, opt_self, var_args) {
+    asyncRun(function() {
+      // Clear any lingering queues, forces getActiveQueue_ to create a new one.
+      this.activeQueue_ = null;
+      var q = this.getActiveQueue_();
+      try {
+        q.execute_(fn.bind(opt_self, var_args));
+      } catch (ex) {
+        var cancellationError = promise.CancellationError.wrap(ex,
+            'Function passed to ControlFlow.async() threw');
+        cancellationError.silent_ = true;
+        q.abort_(cancellationError);
+      } finally {
+        this.activeQueue_ = null;
+      }
+    }, this);
+  },
 
-/**
- * Executes a function in a new frame. If the function does not schedule any new
- * tasks, the frame will be discarded and the function's result returned
- * immediately. Otherwise, a promise will be returned. This promise will be
- * resolved with the function's result once all of the tasks scheduled within
- * the function have been completed. If the function's frame is aborted, the
- * returned promise will be rejected.
- *
- * @param {!Function} fn The function to execute.
- * @param {function(*)} callback The function to call with a successful result.
- * @param {function(*)} errback The function to call if there is an error.
- * @param {boolean=} opt_activate Whether the active frame should be updated to
- *     the newly created frame so tasks are treated as sub-tasks.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.runInNewFrame_ = function(
-    fn, callback, errback, opt_activate) {
-  var newFrame = new webdriver.promise.Frame_(this),
-      self = this,
-      oldFrame = this.activeFrame_;
-
-  try {
-    if (!this.activeFrame_) {
-      this.activeFrame_ = newFrame;
-    } else {
-      this.activeFrame_.addChild(newFrame);
+  /**
+   * Event handler for when a task queue is exhausted. This starts the shutdown
+   * sequence for this instance if there are no remaining task queues: after
+   * one turn of the event loop, this object will emit the
+   * {@link webdriver.promise.ControlFlow.EventType.IDLE IDLE} event to signal
+   * listeners that it has completed. During this wait, if another task is
+   * scheduled, the shutdown will be aborted.
+   *
+   * @param {!TaskQueue} q the completed task queue.
+   * @private
+   */
+  onQueueEnd_: function(q) {
+    if (!this.taskQueues_) {
+      return;
     }
+    this.taskQueues_.delete(q);
 
-    // Activate the new frame to force tasks to be treated as sub-tasks of
-    // the parent frame.
-    if (opt_activate) {
-      this.activeFrame_ = newFrame;
-    }
+    vlog(1, () => q + ' has finished');
+    vlog(1, () => this.taskQueues_.size + ' queues remain\n' + this, this);
 
-    try {
-      this.schedulingFrame_ = newFrame;
-      webdriver.promise.pushFlow_(this);
-      var result = fn();
-    } finally {
-      webdriver.promise.popFlow_();
-      this.schedulingFrame_ = null;
+    if (!this.taskQueues_.size) {
+      asserts.assert(!this.shutdownTask_, 'Already have a shutdown task??');
+      this.shutdownTask_ = new MicroTask(this.shutdown_, this);
     }
-    newFrame.lockFrame();
+  },
 
-    // If there was nothing scheduled in the new frame we can discard the
-    // frame and return immediately.
-    if (!newFrame.children_.length) {
-      removeNewFrame();
-      webdriver.promise.asap(result, callback, errback);
-      return;
+  /**
+   * Event handler for when a task queue terminates with an error. This triggers
+   * the cancellation of all other task queues and a
+   * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION} event.
+   * If there are no error event listeners registered with this instance, the
+   * error will be rethrown to the global error handler.
+   *
+   * @param {*} error the error that caused the task queue to terminate.
+   * @param {!TaskQueue} q the task queue.
+   * @private
+   */
+  onQueueError_: function(error, q) {
+    if (this.taskQueues_) {
+      this.taskQueues_.delete(q);
     }
+    this.cancelQueues_(promise.CancellationError.wrap(
+        error, 'There was an uncaught error in the control flow'));
+    this.cancelShutdown_();
+    this.cancelHold_();
+
+    var listeners = this.listeners(
+      promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);
+    if (!listeners.length) {
+      throwException(error);
+    } else {
+      this.reportUncaughtException_(error);
+    }
+  },
 
-    newFrame.then(function() {
-      webdriver.promise.asap(result, callback, errback);
-    }, function(e) {
-      if (result instanceof webdriver.promise.Promise && result.isPending()) {
-        result.cancel(e);
-        e = result;
+  /**
+   * Cancels all remaining task queues.
+   * @param {!promise.CancellationError} reason The cancellation reason.
+   * @private
+   */
+  cancelQueues_: function(reason) {
+    reason.silent_ = true;
+    if (this.taskQueues_) {
+      for (var q of this.taskQueues_) {
+        q.removeAllListeners();
+        q.abort_(reason);
       }
-      errback(e);
-    });
-  } catch (ex) {
-    removeNewFrame(new webdriver.promise.CanceledTaskError_(ex));
-    errback(ex);
-  }
+      this.taskQueues_.clear();
+      this.taskQueues_ = null;
+    }
+  },
 
   /**
-   * @param {webdriver.promise.CanceledTaskError_=} opt_err If provided, the
-   *     error that triggered the removal of this frame.
+   * Reports an uncaught exception using a
+   * {@link webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION} event.
+   *
+   * @param {*} e the error to report.
+   * @private
    */
-  function removeNewFrame(opt_err) {
-    var parent = newFrame.getParent();
-    if (parent) {
-      parent.removeChild(newFrame);
+  reportUncaughtException_: function(e) {
+    this.emit(promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION, e);
+  },
+
+  /** @private */
+  cancelHold_: function() {
+    if (this.hold_) {
+      clearInterval(this.hold_);
+      this.hold_ = null;
     }
+  },
+
+  /** @private */
+  shutdown_: function() {
+    vlog(1, () => 'Going idle: ' + this);
+    this.cancelHold_();
+    this.shutdownTask_ = null;
+    this.emit(promise.ControlFlow.EventType.IDLE);
+  },
 
-    if (opt_err) {
-      newFrame.cancelRemainingTasks(opt_err);
+  /**
+   * Cancels the shutdown sequence if it is currently scheduled.
+   * @private
+   */
+  cancelShutdown_: function() {
+    if (this.shutdownTask_) {
+      this.shutdownTask_.cancel();
+      this.shutdownTask_ = null;
     }
-    self.activeFrame_ = oldFrame;
   }
-};
+});
 
 
 /**
- * Commences the shutdown sequence for this instance. After one turn of the
- * event loop, this object will emit the
- * {@link webdriver.promise.ControlFlow.EventType.IDLE} event to signal
- * listeners that it has completed. During this wait, if another task is
- * scheduled, the shutdown will be aborted.
- * @private
+ * Events that may be emitted by an {@link webdriver.promise.ControlFlow}.
+ * @enum {string}
  */
-webdriver.promise.ControlFlow.prototype.commenceShutdown_ = function() {
-  if (!this.shutdownId_) {
-    // Go ahead and stop the event loop now.  If we're in here, then there are
-    // no more frames with tasks to execute. If we waited to cancel the event
-    // loop in our timeout below, the event loop could trigger *before* the
-    // timeout, generating an error from there being no frames.
-    // If #execute is called before the timeout below fires, it will cancel
-    // the timeout and restart the event loop.
-    this.cancelEventLoop_();
+promise.ControlFlow.EventType = {
 
-    var self = this;
-    self.shutdownId_ = self.timer.setTimeout(function() {
-      self.shutdownId_ = null;
-      self.emit(webdriver.promise.ControlFlow.EventType.IDLE);
-    }, 0);
-  }
-};
+  /** Emitted when all tasks have been successfully executed. */
+  IDLE: 'idle',
 
+  /** Emitted when a ControlFlow has been reset. */
+  RESET: 'reset',
 
-/**
- * Cancels the shutdown sequence if it is currently scheduled.
- * @private
- */
-webdriver.promise.ControlFlow.prototype.cancelShutdown_ = function() {
-  if (this.shutdownId_) {
-    this.timer.clearTimeout(this.shutdownId_);
-    this.shutdownId_ = null;
-  }
+  /** Emitted whenever a new task has been scheduled. */
+  SCHEDULE_TASK: 'scheduleTask',
+
+  /**
+   * Emitted whenever a control flow aborts due to an unhandled promise
+   * rejection. This event will be emitted along with the offending rejection
+   * reason. Upon emitting this event, the control flow will empty its task
+   * queue and revert to its initial state.
+   */
+  UNCAUGHT_EXCEPTION: 'uncaughtException'
 };
 
 
 /**
- * Aborts this flow, abandoning all remaining tasks. If there are
- * listeners registered, an {@code UNCAUGHT_EXCEPTION} will be emitted with the
- * offending {@code error}, otherwise, the {@code error} will be rethrown to the
- * global error handler.
- * @param {*} error Object describing the error that caused the flow to
- *     abort; usually either an Error or string value.
- * @private
+ * Wraps a function to execute as a cancellable micro task.
+ * @final
  */
-webdriver.promise.ControlFlow.prototype.abortNow_ = function(error) {
-  this.activeFrame_ = null;
-  this.cancelShutdown_();
-  this.cancelEventLoop_();
-
-  var listeners = this.listeners(
-      webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);
-  if (!listeners.length) {
-    this.timer.setTimeout(function() {
-      throw error;
-    }, 0);
-  } else {
-    this.emit(webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,
-        error);
-  }
-};
+var MicroTask = goog.defineClass(null, {
+  /**
+   * @param {function(this: THIS)} fn The function to run as a micro task.
+   * @param {THIS=} opt_scope The scope to run the function in.
+   * @template THIS
+   */
+  constructor: function(fn, opt_scope) {
+    /** @private {boolean} */
+    this.cancelled_ = false;
+    asyncRun(function() {
+      if (!this.cancelled_) {
+        fn.call(opt_scope);
+      }
+    }, this);
+  },
 
+  /**
+   * Cancels the execution of this task. Note: this will not prevent the task
+   * timer from firing, just the invocation of the wrapped function.
+   */
+  cancel: function() {
+    this.cancelled_ = true;
+  }
+});
 
 
 /**
- * A single node in an {@link webdriver.promise.ControlFlow}'s task tree.
- * @param {!webdriver.promise.ControlFlow} flow The flow this instance belongs
- *     to.
- * @constructor
- * @extends {webdriver.promise.Deferred}
- * @private
+ * A task to be executed by a {@link webdriver.promise.ControlFlow}.
+ *
+ * @final
  */
-webdriver.promise.Node_ = function(flow) {
-  webdriver.promise.Deferred.call(this, null, flow);
-};
-goog.inherits(webdriver.promise.Node_, webdriver.promise.Deferred);
+var Task = goog.defineClass(promise.Deferred, {
+  /**
+   * @param {!promise.ControlFlow} flow The flow this instances belongs
+   *     to.
+   * @param {function(): (T|!promise.Promise<T>)} fn The function to
+   *     call when the task executes. If it returns a
+   *     {@link webdriver.promise.Promise}, the flow will wait for it to be
+   *     resolved before starting the next task.
+   * @param {string} description A description of the task for debugging.
+   * @param {{name: string, top: !Function}=} opt_stackOptions Options to use
+   *     when capturing the stacktrace for when this task was created.
+   * @constructor
+   * @extends {promise.Deferred<T>}
+   * @template T
+   */
+  constructor: function(flow, fn, description, opt_stackOptions) {
+    Task.base(this, 'constructor', flow);
 
+    /** @type {function(): (T|!promise.Promise<T>)} */
+    this.execute = fn;
 
-/**
- * This node's parent.
- * @private {webdriver.promise.Node_}
- */
-webdriver.promise.Node_.prototype.parent_ = null;
+    /** @type {string} */
+    this.description = description;
 
+    /** @type {TaskQueue} */
+    this.queue = null;
 
-/** @return {webdriver.promise.Node_} This node's parent. */
-webdriver.promise.Node_.prototype.getParent = function() {
-  return this.parent_;
-};
+    /**
+     * Whether this task is volatile. Volatile tasks may be registered in a
+     * a task queue, but will be dropped on the next turn of the JS event loop
+     * if still marked volatile.
+     * @type {boolean}
+     */
+    this.isVolatile = false;
 
+    if (opt_stackOptions) {
+      this.promise.stack_ = promise.captureStackTrace(
+          opt_stackOptions.name, this.description, opt_stackOptions.top);
+    }
+  },
 
-/**
- * @param {webdriver.promise.Node_} parent This node's new parent.
- */
-webdriver.promise.Node_.prototype.setParent = function(parent) {
-  this.parent_ = parent;
-};
+  /** @override */
+  toString: function() {
+    return 'Task::' + goog.getUid(this) + '<' + this.description + '>';
+  }
+});
 
 
-/**
- * @return {!webdriver.promise.Node_} The root of this node's tree.
- */
-webdriver.promise.Node_.prototype.getRoot = function() {
-  var root = this;
-  while (root.parent_) {
-    root = root.parent_;
-  }
-  return root;
+/** @enum {string} */
+var TaskQueueState = {
+  NEW: 'new',
+  STARTED: 'started',
+  FINISHED: 'finished'
 };
 
 
-
 /**
- * An execution frame within a {@link webdriver.promise.ControlFlow}.  Each
- * frame represents the execution context for either a
- * {@link webdriver.promise.Task_} or a callback on a
- * {@link webdriver.promise.Deferred}.
- *
- * <p>Each frame may contain sub-frames.  If child N is a sub-frame, then the
- * items queued within it are given priority over child N+1.
- *
- * @param {!webdriver.promise.ControlFlow} flow The flow this instance belongs
- *     to.
- * @constructor
- * @extends {webdriver.promise.Node_}
- * @private
+ * @final
  */
-webdriver.promise.Frame_ = function(flow) {
-  webdriver.promise.Node_.call(this, flow);
+var TaskQueue = goog.defineClass(EventEmitter, {
+  /** @param {!promise.ControlFlow} flow . */
+  constructor: function(flow) {
+    TaskQueue.base(this, 'constructor');
+    goog.getUid(this);
 
-  var reject = goog.bind(this.reject, this);
-  var cancelRemainingTasks = goog.bind(this.cancelRemainingTasks, this);
+    /** @private {string} */
+    this.name_ = 'TaskQueue::' + goog.getUid(this);
 
-  /** @override */
-  this.reject = function(e) {
-    cancelRemainingTasks(new webdriver.promise.CanceledTaskError_(e));
-    reject(e);
-  };
+    /** @private {!promise.ControlFlow} */
+    this.flow_ = flow;
 
-  /**
-   * @private {!Array.<!(webdriver.promise.Frame_|webdriver.promise.Task_)>}
-   */
-  this.children_ = [];
-};
-goog.inherits(webdriver.promise.Frame_, webdriver.promise.Node_);
+    /** @private {!Array<!Task>} */
+    this.tasks_ = [];
 
+    /** @private {Array<!Task>} */
+    this.volatileTasks_ = null;
 
-/**
- * The task currently being executed within this frame.
- * @private {webdriver.promise.Task_}
- */
-webdriver.promise.Frame_.prototype.pendingTask_ = null;
+    /** @private {Array<!Task>} */
+    this.interrupts_ = null;
 
+    /** @private {({task: !Task, q: !TaskQueue}|null)} */
+    this.pending_ = null;
 
-/**
- * Whether this frame is active. A frame is considered active once one of its
- * descendants has been removed for execution.
- *
- * Adding a sub-frame as a child to an active frame is an indication that
- * a callback to a {@link webdriver.promise.Deferred} is being invoked and any
- * tasks scheduled within it should have priority over previously scheduled
- * tasks:
- * <code><pre>
- *   var flow = webdriver.promise.controlFlow();
- *   flow.execute('start here', goog.nullFunction).then(function() {
- *     flow.execute('this should execute 2nd', goog.nullFunction);
- *   });
- *   flow.execute('this should execute last', goog.nullFunction);
- * </pre></code>
- *
- * @private {boolean}
- */
-webdriver.promise.Frame_.prototype.isActive_ = false;
+    /** @private {TaskQueueState} */
+    this.state_ = TaskQueueState.NEW;
 
+    /** @private {!Set<!webdriver.promise.Promise>} */
+    this.unhandledRejections_ = new Set();
+  },
 
-/**
- * Whether this frame is currently locked. A locked frame represents a callback
- * or task function which has run to completion and scheduled all of its tasks.
- *
- * <p>Once a frame becomes {@link #isActive_ active}, any new frames which are
- * added represent callbacks on a {@link webdriver.promise.Deferred}, whose
- * tasks must be given priority over previously scheduled tasks.
- *
- * @private {boolean}
- */
-webdriver.promise.Frame_.prototype.isLocked_ = false;
+  /** @override */
+  toString: function() {
+    return 'TaskQueue::' + goog.getUid(this);
+  },
 
+  /**
+   * @param {!webdriver.promise.Promise} promise .
+   */
+  addUnhandledRejection: function(promise) {
+    // TODO: node 4.0.0+
+    vlog(2, () => this + ' registering unhandled rejection: ' + promise, this);
+    this.unhandledRejections_.add(promise);
+  },
 
-/**
- * A reference to the last node inserted in this frame.
- * @private {webdriver.promise.Node_}
- */
-webdriver.promise.Frame_.prototype.lastInsertedChild_ = null;
+  /**
+   * @param {!webdriver.promise.Promise} promise .
+   */
+  clearUnhandledRejection: function(promise) {
+    var deleted = this.unhandledRejections_.delete(promise);
+    if (deleted) {
+      // TODO: node 4.0.0+
+      vlog(2, () => this + ' clearing unhandled rejection: ' + promise, this);
+    }
+  },
 
+  /**
+   * Enqueues a new task for execution.
+   * @param {!Task} task The task to enqueue.
+   * @throws {Error} If this instance has already started execution.
+   */
+  enqueue: function(task) {
+    if (this.state_ !== TaskQueueState.NEW) {
+      throw Error('TaskQueue has started: ' + this);
+    }
 
-/**
- * Marks all of the tasks that are descendants of this frame in the execution
- * tree as cancelled. This is necessary for callbacks scheduled asynchronous.
- * For example:
- *
- *     var someResult;
- *     webdriver.promise.createFlow(function(flow) {
- *       someResult = flow.execute(function() {});
- *       throw Error();
- *     }).addErrback(function(err) {
- *       console.log('flow failed: ' + err);
- *       someResult.then(function() {
- *         console.log('task succeeded!');
- *       }, function(err) {
- *         console.log('task failed! ' + err);
- *       });
- *     });
- *     // flow failed: Error: boom
- *     // task failed! CanceledTaskError: Task discarded due to a previous
- *     // task failure: Error: boom
- *
- * @param {!webdriver.promise.CanceledTaskError_} error The cancellation
- *     error.
- */
-webdriver.promise.Frame_.prototype.cancelRemainingTasks = function(error) {
-  goog.array.forEach(this.children_, function(child) {
-    if (child instanceof webdriver.promise.Frame_) {
-      child.cancelRemainingTasks(error);
-    } else {
-      // None of the previously registered listeners should be notified that
-      // the task is being canceled, however, we need at least one errback
-      // to prevent the cancellation from bubbling up.
-      child.removeAll();
-      child.thenCatch(goog.nullFunction);
-      child.cancel(error);
+    if (task.queue) {
+      throw Error('Task is already scheduled in another queue');
     }
-  });
-};
 
+    if (task.isVolatile) {
+      this.volatileTasks_ = this.volatileTasks_ || [];
+      this.volatileTasks_.push(task);
+    }
 
-/**
- * @return {webdriver.promise.Task_} The task currently executing
- *     within this frame, if any.
- */
-webdriver.promise.Frame_.prototype.getPendingTask = function() {
-  return this.pendingTask_;
-};
+    this.tasks_.push(task);
+    task.queue = this;
+    task.promise[CANCEL_HANDLER_SYMBOL] =
+        this.onTaskCancelled_.bind(this, task);
 
+    vlog(1, () => this + '.enqueue(' + task + ')', this);
+    vlog(2, () => this.flow_.toString(), this);
+  },
 
-/**
- * @param {webdriver.promise.Task_} task The task currently
- *     executing within this frame, if any.
- */
-webdriver.promise.Frame_.prototype.setPendingTask = function(task) {
-  this.pendingTask_ = task;
-};
+  /**
+   * Schedules the callbacks registered on the given promise in this queue.
+   *
+   * @param {!promise.Promise} promise the promise whose callbacks should be
+   *     registered as interrupts in this task queue.
+   * @throws {Error} if this queue has already finished.
+   */
+  scheduleCallbacks: function(promise) {
+    if (this.state_ === TaskQueueState.FINISHED) {
+      throw new Error('cannot interrupt a finished q(' + this + ')');
+    }
+
+    if (this.pending_ && this.pending_.task.promise === promise) {
+      this.pending_.task.promise.queue_ = null;
+      this.pending_ = null;
+      asyncRun(this.executeNext_, this);
+    }
 
+    if (!promise.callbacks_) {
+      return;
+    }
+    promise.callbacks_.forEach(function(cb) {
+      cb.promise[CANCEL_HANDLER_SYMBOL] =
+        this.onTaskCancelled_.bind(this, cb);
 
-/** Locks this frame. */
-webdriver.promise.Frame_.prototype.lockFrame = function() {
-  this.isLocked_ = true;
-};
+      cb.isVolatile = false;
+      if (cb.queue === this && this.tasks_.indexOf(cb) !== -1) {
+        return;
+      }
 
+      if (cb.queue) {
+        cb.queue.dropTask_(cb);
+      }
 
-/**
- * Adds a new node to this frame.
- * @param {!(webdriver.promise.Frame_|webdriver.promise.Task_)} node
- *     The node to insert.
- */
-webdriver.promise.Frame_.prototype.addChild = function(node) {
-  if (this.lastInsertedChild_ &&
-      this.lastInsertedChild_ instanceof webdriver.promise.Frame_ &&
-      !this.lastInsertedChild_.isLocked_) {
-    this.lastInsertedChild_.addChild(node);
-    return;
-  }
+      cb.queue = this;
+      if (!this.interrupts_) {
+        this.interrupts_ = [];
+      }
+      this.interrupts_.push(cb);
+    }, this);
+    promise.callbacks_ = null;
+    vlog(2, () => this + ' interrupted\n' + this.flow_, this);
+  },
+
+  /**
+   * Starts executing tasks in this queue. Once called, no further tasks may
+   * be {@linkplain #enqueue() enqueued} with this instance.
+   *
+   * @throws {Error} if this queue has already been started.
+   */
+  start: function() {
+    if (this.state_ !== TaskQueueState.NEW) {
+      throw new Error('TaskQueue has already started');
+    }
+    // Always asynchronously execute next, even if there doesn't look like
+    // there is anything in the queue. This will catch pending unhandled
+    // rejections that were registered before start was called.
+    asyncRun(this.executeNext_, this);
+  },
 
-  node.setParent(this);
+  /**
+   * Aborts this task queue. If there are any scheduled tasks, they are silently
+   * cancelled and discarded (their callbacks will never fire). If this queue
+   * has a _pending_ task, the abortion error is used to cancel that task.
+   * Otherwise, this queue will emit an error event.
+   *
+   * @param {*} error The abortion reason.
+   * @private
+   */
+  abort_: function(error) {
+    var cancellation;
 
-  if (this.isActive_ && node instanceof webdriver.promise.Frame_) {
-    var index = 0;
-    if (this.lastInsertedChild_ instanceof
-        webdriver.promise.Frame_) {
-      index = goog.array.indexOf(this.children_, this.lastInsertedChild_) + 1;
+    if (error instanceof FlowResetError) {
+      cancellation = error;
+    } else {
+      cancellation = new DiscardedTaskError(error);
     }
-    goog.array.insertAt(this.children_, node, index);
-    this.lastInsertedChild_ = node;
-    return;
-  }
 
-  this.lastInsertedChild_ = node;
-  this.children_.push(node);
-};
+    if (this.interrupts_ && this.interrupts_.length) {
+      this.interrupts_.forEach((t) => t.reject(cancellation));
+      this.interrupts_ = [];
+    }
 
+    if (this.tasks_ && this.tasks_.length) {
+      this.tasks_.forEach((t) => t.reject(cancellation));
+      this.tasks_ = [];
+    }
 
-/**
- * @return {(webdriver.promise.Frame_|webdriver.promise.Task_)} This frame's
- *     fist child.
- */
-webdriver.promise.Frame_.prototype.getFirstChild = function() {
-  this.isActive_ = true;
-  this.lastInsertedChild_ = null;
-  return this.children_[0];
-};
+    if (this.pending_) {
+      vlog(2, () => this + '.abort(); cancelling pending task', this);
+      this.pending_.task.cancel(
+          /** @type {!webdriver.promise.CancellationError} */(error));
 
+    } else {
+      vlog(2, () => this + '.abort(); emitting error event', this);
+      this.emit('error', error, this);
+    }
+  },
 
-/**
- * Removes a child from this frame.
- * @param {!(webdriver.promise.Frame_|webdriver.promise.Task_)} child
- *     The child to remove.
- */
-webdriver.promise.Frame_.prototype.removeChild = function(child) {
-  var index = goog.array.indexOf(this.children_, child);
-  child.setParent(null);
-  goog.array.removeAt(this.children_, index);
-  if (this.lastInsertedChild_ === child) {
-    this.lastInsertedChild_ = null;
-  }
-};
+  /** @private */
+  executeNext_: function() {
+    if (this.state_ === TaskQueueState.FINISHED) {
+      return;
+    }
+    this.state_ = TaskQueueState.STARTED;
+    this.dropVolatileTasks_();
 
+    if (this.pending_ != null || this.processUnhandledRejections_()) {
+      return;
+    }
 
-/** @override */
-webdriver.promise.Frame_.prototype.toString = function() {
-  return '[' + goog.array.map(this.children_, function(child) {
-    return child.toString();
-  }).join(', ') + ']';
-};
+    var task;
+    do {
+      task = this.getNextTask_();
+    } while (task && !task.promise.isPending());
+
+    if (!task) {
+      this.state_ = TaskQueueState.FINISHED;
+      this.tasks_ = [];
+      this.interrupts_ = null;
+      vlog(2, () => this + '.emit(end)', this);
+      this.emit('end', this);
+      return;
+    }
 
+    var self = this;
+    var subQ = new TaskQueue(this.flow_);
+    subQ.once('end', () => self.onTaskComplete_(result))
+        .once('error', (e) => self.onTaskFailure_(result, e));
+    vlog(2, () => self + ' created ' + subQ + ' for ' + task);
 
+    var result = undefined;
+    try {
+      this.pending_ = {task: task, q: subQ};
+      task.promise.queue_ = this;
+      result = subQ.execute_(task.execute);
+      subQ.start();
+    } catch (ex) {
+      subQ.abort_(ex);
+    }
+  },
 
-/**
- * A task to be executed by a {@link webdriver.promise.ControlFlow}.
- *
- * @param {!webdriver.promise.ControlFlow} flow The flow this instances belongs
- *     to.
- * @param {!Function} fn The function to call when the task executes. If it
- *     returns a {@code webdriver.promise.Promise}, the flow will wait
- *     for it to be resolved before starting the next task.
- * @param {string} description A description of the task for debugging.
- * @param {!webdriver.stacktrace.Snapshot} snapshot A snapshot of the stack
- *     when this task was scheduled.
- * @constructor
- * @extends {webdriver.promise.Node_}
- * @private
- */
-webdriver.promise.Task_ = function(flow, fn, description, snapshot) {
-  webdriver.promise.Node_.call(this, flow);
 
   /**
-   * Executes this task.
-   * @type {!Function}
+   * @param {!Function} fn .
+   * @return {T} .
+   * @template T
+   * @private
    */
-  this.execute = fn;
+  execute_: function(fn) {
+    try {
+      activeFlows.push(this.flow_);
+      this.flow_.activeQueue_ = this;
+      return fn();
+    } finally {
+      this.flow_.activeQueue_ = null;
+      this.dropVolatileTasks_();
+      activeFlows.pop();
+    }
+  },
 
-  /** @private {string} */
-  this.description_ = description;
+  /**
+   * Process any unhandled rejections registered with this task queue. If there
+   * is a rejection, this queue will be aborted with the rejection error. If
+   * there are multiple rejections registered, this queue will be aborted with
+   * a {@link promise.MultipleUnhandledRejectionError}.
+   * @return {boolean} whether there was an unhandled rejection.
+   * @private
+   */
+  processUnhandledRejections_: function() {
+    if (!this.unhandledRejections_.size) {
+      return false;
+    }
 
-  /** @private {!webdriver.stacktrace.Snapshot} */
-  this.snapshot_ = snapshot;
-};
-goog.inherits(webdriver.promise.Task_, webdriver.promise.Node_);
+    var errors = new Set();
+    for (var rejection of this.unhandledRejections_) {
+      errors.add(rejection.value_);
+    }
+    this.unhandledRejections_.clear();
 
+    var errorToReport = errors.size === 1
+        ? errors.values().next().value
+        : new promise.MultipleUnhandledRejectionError(errors);
 
-/** @return {string} This task's description. */
-webdriver.promise.Task_.prototype.getDescription = function() {
-  return this.description_;
-};
+    vlog(1, () => this + ' aborting due to unhandled rejections', this);
+    if (this.flow_.propagateUnhandledRejections_) {
+      this.abort_(errorToReport);
+      return true;
+    } else {
+      vlog(1, 'error propagation disabled; reporting to control flow');
+      this.flow_.reportUncaughtException_(errorToReport);
+      return false;
+    }
+  },
 
+  /**
+   * Drops any volatile tasks scheduled within this task queue.
+   * @private
+   */
+  dropVolatileTasks_: function() {
+    if (!this.volatileTasks_) {
+      return;
+    }
+    for (var task of this.volatileTasks_) {
+      if (task.isVolatile) {
+        vlog(2, () => this + ' dropping volatile task ' + task, this);
+        this.dropTask_(task);
+      }
+    }
+    this.volatileTasks_ = null;
+  },
 
-/** @override */
-webdriver.promise.Task_.prototype.toString = function() {
-  var stack = this.snapshot_.getStacktrace();
-  var ret = this.description_;
-  if (stack.length) {
-    if (this.description_) {
-      ret += '\n';
+  /**
+   * @param {!Task} task The task to drop.
+   * @private
+   */
+  dropTask_: function(task) {
+    var index;
+    if (this.interrupts_) {
+      index = this.interrupts_.indexOf(task);
+      if (index != -1) {
+        task.queue = null;
+        this.interrupts_.splice(index, 1);
+        return;
+      }
     }
-    ret += stack.join('\n');
-  }
-  return ret;
-};
 
+    index = this.tasks_.indexOf(task);
+    if (index != -1) {
+      task.queue = null;
+      this.tasks_.splice(index, 1);
+    }
+  },
 
+  /**
+   * @param {!Task} task The task that was cancelled.
+   * @param {!promise.CancellationError} reason The cancellation reason.
+   * @private
+   */
+  onTaskCancelled_: function(task, reason) {
+    if (this.pending_ && this.pending_.task === task) {
+      this.pending_.q.abort_(reason);
+    } else {
+      this.dropTask_(task);
+    }
+  },
 
-/**
- * Special error used to signal when a task is canceled because a previous
- * task in the same frame failed.
- * @param {*} err The error that caused the task cancellation.
- * @constructor
- * @extends {goog.debug.Error}
- * @private
- */
-webdriver.promise.CanceledTaskError_ = function(err) {
-  goog.base(this, 'Task discarded due to a previous task failure: ' + err);
-};
-goog.inherits(webdriver.promise.CanceledTaskError_, goog.debug.Error);
+  /**
+   * @param {*} value the value originally returned by the task function.
+   * @private
+   */
+  onTaskComplete_: function(value) {
+    if (this.pending_) {
+      this.pending_.task.fulfill(value);
+    }
+  },
 
+  /**
+   * @param {*} taskFnResult the value originally returned by the task function.
+   * @param {*} error the error that caused the task function to terminate.
+   * @private
+   */
+  onTaskFailure_: function(taskFnResult, error) {
+    if (promise.Thenable.isImplementation(taskFnResult)) {
+      taskFnResult.cancel(promise.CancellationError.wrap(error));
+    }
+    this.pending_.task.reject(error);
+  },
 
-/** @override */
-webdriver.promise.CanceledTaskError_.prototype.name = 'CanceledTaskError';
+  /**
+   * @return {(Task|undefined)} the next task scheduled within this queue,
+   *     if any.
+   * @private
+   */
+  getNextTask_: function() {
+    var task = undefined;
+    if (this.interrupts_) {
+      task = this.interrupts_.shift();
+    }
+    if (!task && this.tasks_) {
+      task = this.tasks_.shift();
+    }
+    return task;
+  }
+});
 
 
 
 /**
  * The default flow to use if no others are active.
- * @private {!webdriver.promise.ControlFlow}
+ * @type {!promise.ControlFlow}
  */
-webdriver.promise.defaultFlow_ = new webdriver.promise.ControlFlow();
+var defaultFlow = new promise.ControlFlow();
 
 
 /**
@@ -2055,46 +2906,30 @@ webdriver.promise.defaultFlow_ = new webdriver.promise.ControlFlow();
  * commands. When there are multiple flows on the stack, the flow at index N
  * represents a callback triggered within a task owned by the flow at index
  * N-1.
- * @private {!Array.<!webdriver.promise.ControlFlow>}
+ * @type {!Array<!promise.ControlFlow>}
  */
-webdriver.promise.activeFlows_ = [];
+var activeFlows = [];
 
 
 /**
  * Changes the default flow to use when no others are active.
- * @param {!webdriver.promise.ControlFlow} flow The new default flow.
+ * @param {!promise.ControlFlow} flow The new default flow.
  * @throws {Error} If the default flow is not currently active.
  */
-webdriver.promise.setDefaultFlow = function(flow) {
-  if (webdriver.promise.activeFlows_.length) {
+promise.setDefaultFlow = function(flow) {
+  if (activeFlows.length) {
     throw Error('You may only change the default flow while it is active');
   }
-  webdriver.promise.defaultFlow_ = flow;
-};
-
-
-/**
- * @return {!webdriver.promise.ControlFlow} The currently active control flow.
- */
-webdriver.promise.controlFlow = function() {
-  return /** @type {!webdriver.promise.ControlFlow} */ (
-      goog.array.peek(webdriver.promise.activeFlows_) ||
-      webdriver.promise.defaultFlow_);
+  defaultFlow = flow;
 };
 
 
 /**
- * @param {!webdriver.promise.ControlFlow} flow The new flow.
- * @private
+ * @return {!promise.ControlFlow} The currently active control flow.
  */
-webdriver.promise.pushFlow_ = function(flow) {
-  webdriver.promise.activeFlows_.push(flow);
-};
-
-
-/** @private */
-webdriver.promise.popFlow_ = function() {
-  webdriver.promise.activeFlows_.pop();
+promise.controlFlow = function() {
+  return /** @type {!promise.ControlFlow} */ (
+      Arrays.peek(activeFlows) || defaultFlow);
 };
 
 
@@ -2102,15 +2937,107 @@ webdriver.promise.popFlow_ = function() {
  * Creates a new control flow. The provided callback will be invoked as the
  * first task within the new flow, with the flow as its sole argument. Returns
  * a promise that resolves to the callback result.
- * @param {function(!webdriver.promise.ControlFlow)} callback The entry point
+ * @param {function(!promise.ControlFlow)} callback The entry point
  *     to the newly created flow.
- * @return {!webdriver.promise.Promise} A promise that resolves to the callback
+ * @return {!promise.Promise} A promise that resolves to the callback
  *     result.
  */
-webdriver.promise.createFlow = function(callback) {
-  var flow = new webdriver.promise.ControlFlow(
-      webdriver.promise.defaultFlow_.timer);
+promise.createFlow = function(callback) {
+  var flow = new promise.ControlFlow;
   return flow.execute(function() {
     return callback(flow);
   });
 };
+
+
+/**
+ * Tests is a function is a generator.
+ * @param {!Function} fn The function to test.
+ * @return {boolean} Whether the function is a generator.
+ */
+promise.isGenerator = function(fn) {
+  return fn.constructor.name === 'GeneratorFunction';
+};
+
+
+/**
+ * Consumes a {@code GeneratorFunction}. Each time the generator yields a
+ * promise, this function will wait for it to be fulfilled before feeding the
+ * fulfilled value back into {@code next}. Likewise, if a yielded promise is
+ * rejected, the rejection error will be passed to {@code throw}.
+ *
+ * __Example 1:__ the Fibonacci Sequence.
+ *
+ *     promise.consume(function* fibonacci() {
+ *       var n1 = 1, n2 = 1;
+ *       for (var i = 0; i < 4; ++i) {
+ *         var tmp = yield n1 + n2;
+ *         n1 = n2;
+ *         n2 = tmp;
+ *       }
+ *       return n1 + n2;
+ *     }).then(function(result) {
+ *       console.log(result);  // 13
+ *     });
+ *
+ * __Example 2:__ a generator that throws.
+ *
+ *     promise.consume(function* () {
+ *       yield promise.delayed(250).then(function() {
+ *         throw Error('boom');
+ *       });
+ *     }).thenCatch(function(e) {
+ *       console.log(e.toString());  // Error: boom
+ *     });
+ *
+ * @param {!Function} generatorFn The generator function to execute.
+ * @param {Object=} opt_self The object to use as "this" when invoking the
+ *     initial generator.
+ * @param {...*} var_args Any arguments to pass to the initial generator.
+ * @return {!promise.Promise<?>} A promise that will resolve to the
+ *     generator's final result.
+ * @throws {TypeError} If the given function is not a generator.
+ */
+promise.consume = function(generatorFn, opt_self, var_args) {
+  if (!promise.isGenerator(generatorFn)) {
+    throw new TypeError('Input is not a GeneratorFunction: ' +
+        generatorFn.constructor.name);
+  }
+
+  var deferred = promise.defer();
+  var generator = generatorFn.apply(opt_self, Arrays.slice(arguments, 2));
+  callNext();
+  return deferred.promise;
+
+  /** @param {*=} opt_value . */
+  function callNext(opt_value) {
+    pump(generator.next, opt_value);
+  }
+
+  /** @param {*=} opt_error . */
+  function callThrow(opt_error) {
+    // Dictionary lookup required because Closure compiler's built-in
+    // externs does not include GeneratorFunction.prototype.throw.
+    pump(generator['throw'], opt_error);
+  }
+
+  function pump(fn, opt_arg) {
+    if (!deferred.isPending()) {
+      return;  // Defererd was cancelled; silently abort.
+    }
+
+    try {
+      var result = fn.call(generator, opt_arg);
+    } catch (ex) {
+      deferred.reject(ex);
+      return;
+    }
+
+    if (result.done) {
+      deferred.fulfill(result.value);
+      return;
+    }
+
+    promise.asap(result.value, callNext, callThrow);
+  }
+};
diff --git a/lib/webdriver/serializable.js b/lib/webdriver/serializable.js
new file mode 100644
index 0000000..16db027
--- /dev/null
+++ b/lib/webdriver/serializable.js
@@ -0,0 +1,41 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.provide('webdriver.Serializable');
+
+
+
+/**
+ * Defines an object that can be asynchronously serialized to its WebDriver
+ * wire representation.
+ *
+ * @constructor
+ * @template T
+ */
+webdriver.Serializable = function() {};
+
+
+/**
+ * Returns either this instance's serialized represention, if immediately
+ * available, or a promise for its serialized representation. This function is
+ * conceptually equivalent to objects that have a {@code toJSON()} property,
+ * except the serialize() result may be a promise or an object containing a
+ * promise (which are not directly JSON friendly).
+ *
+ * @return {!(T|IThenable.<!T>)} This instance's serialized wire format.
+ */
+webdriver.Serializable.prototype.serialize = goog.abstractMethod;
diff --git a/lib/webdriver/session.js b/lib/webdriver/session.js
index 03d3219..1550226 100644
--- a/lib/webdriver/session.js
+++ b/lib/webdriver/session.js
@@ -1,16 +1,19 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 goog.provide('webdriver.Session');
 
diff --git a/lib/webdriver/stacktrace.js b/lib/webdriver/stacktrace.js
index a0cec8f..3b34435 100644
--- a/lib/webdriver/stacktrace.js
+++ b/lib/webdriver/stacktrace.js
@@ -1,18 +1,19 @@
-// Copyright 2009 The Closure Library Authors. All Rights Reserved.
-// Copyright 2012 Selenium comitters
-// Copyright 2012 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS-IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Tools for parsing and pretty printing error stack traces. This
@@ -60,11 +61,10 @@ webdriver.stacktrace.Snapshot = function(opt_slice) {
   }
 
   /**
-   * The error's stacktrace.  This must be accessed immediately to ensure Opera
-   * computes the context correctly.
+   * The error's stacktrace.
    * @private {string}
    */
-  this.stack_ = webdriver.stacktrace.getStack_(error);
+  this.stack_ = webdriver.stacktrace.getStack(error);
 };
 
 
@@ -353,7 +353,9 @@ webdriver.stacktrace.V8_LOCATION_PATTERN_ = ' (?:\\((.*)\\)|(.*))';
  * @private {!RegExp}
  * @const
  */
-webdriver.stacktrace.V8_STACK_FRAME_REGEXP_ = new RegExp('^    at' +
+webdriver.stacktrace.V8_STACK_FRAME_REGEXP_ = new RegExp('^\\s+at' +
+    // Prevent intersections with IE10 stack frame regex.
+    '(?! (?:Anonymous function|Global code|eval code) )' +
     '(?:' + webdriver.stacktrace.V8_FUNCTION_CALL_PATTERN_ + ')?' +
     webdriver.stacktrace.V8_LOCATION_PATTERN_ + '$');
 
@@ -390,49 +392,18 @@ webdriver.stacktrace.FIREFOX_STACK_FRAME_REGEXP_ = new RegExp('^' +
     '(?::0|' + webdriver.stacktrace.URL_PATTERN_ + ')$');
 
 
-/**
- * RegExp pattern for an anonymous function call in an Opera stack frame.
- * Creates 2 (optional) submatches: the context object and function name.
- * @private {string}
- * @const
- */
-webdriver.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ =
-    '<anonymous function(?:\\: ' +
-    webdriver.stacktrace.QUALIFIED_NAME_PATTERN_ + ')?>';
-
-
-/**
- * RegExp pattern for a function call in an Opera stack frame.
- * Creates 3 (optional) submatches: the function name (if not anonymous),
- * the aliased context object and the function name (if anonymous).
- * @private {string}
- * @const
- */
-webdriver.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ =
-    '(?:(?:(' + webdriver.stacktrace.IDENTIFIER_PATTERN_ + ')|' +
-    webdriver.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ +
-    ')(?:\\(.*\\)))?@';
-
-
-/**
- * Regular expression for parsing on stack frame in Opera 11.68+
- * @private {!RegExp}
- * @const
- */
-webdriver.stacktrace.OPERA_STACK_FRAME_REGEXP_ = new RegExp('^' +
-    webdriver.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ +
-    webdriver.stacktrace.URL_PATTERN_ + '?$');
-
-
 /**
  * RegExp pattern for function call in a Chakra (IE) stack trace. This
- * expression allows for identifiers like 'Anonymous function', 'eval code',
- * and 'Global code'.
+ * expression creates 2 submatches on the (optional) context and function name,
+ * matching identifiers like 'foo.Bar.prototype.baz', 'Anonymous function',
+ * 'eval code', and 'Global code'.
  * @private {string}
  * @const
  */
-webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_ = '(' +
-    webdriver.stacktrace.IDENTIFIER_PATTERN_ + '(?:\\s+\\w+)*)';
+webdriver.stacktrace.CHAKRA_FUNCTION_CALL_PATTERN_ =
+    '(?:(' + webdriver.stacktrace.IDENTIFIER_PATTERN_ +
+    '(?:\\.' + webdriver.stacktrace.IDENTIFIER_PATTERN_ + ')*)\\.)?' +
+    '(' + webdriver.stacktrace.IDENTIFIER_PATTERN_ + '(?:\\s+\\w+)*)';
 
 
 /**
@@ -511,14 +482,9 @@ webdriver.stacktrace.parseStackFrame_ = function(frameStr) {
     return new webdriver.stacktrace.Frame('', m[1], '', m[2]);
   }
 
-  m = frameStr.match(webdriver.stacktrace.OPERA_STACK_FRAME_REGEXP_);
-  if (m) {
-    return new webdriver.stacktrace.Frame(m[2], m[1] || m[3], '', m[4]);
-  }
-
   m = frameStr.match(webdriver.stacktrace.CHAKRA_STACK_FRAME_REGEXP_);
   if (m) {
-    return new webdriver.stacktrace.Frame('', m[1], '', m[2]);
+    return new webdriver.stacktrace.Frame(m[1], m[2], '', m[3]);
   }
 
   if (frameStr == webdriver.stacktrace.UNKNOWN_CLOSURE_FRAME_ ||
@@ -562,11 +528,13 @@ webdriver.stacktrace.parseLongFirefoxFrame_ = function(frameStr) {
  * V8 prepends the string representation of an error to its stack trace.
  * This function trims the string so that the stack trace can be parsed
  * consistently with the other JS engines.
- * @param {!(Error|goog.testing.JsUnitException)} error The error.
+ * @param {(Error|goog.testing.JsUnitException)} error The error.
  * @return {string} The stack trace string.
- * @private
  */
-webdriver.stacktrace.getStack_ = function(error) {
+webdriver.stacktrace.getStack = function(error) {
+  if (!error) {
+    return '';
+  }
   var stack = error.stack || error.stackTrace || '';
   var errorStr = error + '\n';
   if (goog.string.startsWith(stack, errorStr)) {
@@ -582,9 +550,21 @@ webdriver.stacktrace.getStack_ = function(error) {
  * @return {!(Error|goog.testing.JsUnitException)} The formatted error.
  */
 webdriver.stacktrace.format = function(error) {
-  var stack = webdriver.stacktrace.getStack_(error);
+  var stack = webdriver.stacktrace.getStack(error);
   var frames = webdriver.stacktrace.parse_(stack);
 
+  // If the original stack is in an unexpected format, our formatted stack
+  // trace will be a bunch of "    at <anonymous>" lines. If this is the case,
+  // just return the error unmodified to avoid losing information. This is
+  // necessary since the user may have defined a custom stack formatter in
+  // V8 via Error.prepareStackTrace. See issue 7994.
+  var isAnonymousFrame = function(frame) {
+    return frame.toString() === '    at <anonymous>';
+  };
+  if (frames.length && goog.array.every(frames, isAnonymousFrame)) {
+    return error;
+  }
+
   // Older versions of IE simply return [object Error] for toString(), so
   // only use that as a last resort.
   var errorStr = '';
@@ -622,12 +602,7 @@ webdriver.stacktrace.parse_ = function(stack) {
     // The first two frames will be:
     //   webdriver.stacktrace.Snapshot()
     //   webdriver.stacktrace.get()
-    // In the case of Opera, sometimes an extra frame is injected in the next
-    // frame with a reported line number of zero. The next line detects that
-    // case and skips that frame.
-    if (!(goog.userAgent.OPERA && i == 2 && frame.getLine() == 0)) {
-      frames.push(frame || webdriver.stacktrace.ANONYMOUS_FRAME_);
-    }
+    frames.push(frame || webdriver.stacktrace.ANONYMOUS_FRAME_);
   }
   return frames;
 };
diff --git a/lib/webdriver/test/builder_test.js b/lib/webdriver/test/builder_test.js
new file mode 100644
index 0000000..be88026
--- /dev/null
+++ b/lib/webdriver/test/builder_test.js
@@ -0,0 +1,53 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.Builder');
+
+
+
+function testInitializeSessionIdFromQueryString_notSet() {
+  var builder = new webdriver.Builder({
+    location: '/somelocation'
+  });
+  assertUndefined(builder.getSession());
+}
+
+
+function testInitializeSessionIdfromQueryString_set() {
+  var builder = new webdriver.Builder({
+    location: '/somelocation?wdsid=foo'
+  });
+  assertEquals('foo', builder.getSession());
+}
+
+
+function testInitializeServerUrlFromQueryString_notSet() {
+  var builder = new webdriver.Builder({
+    location: '/somelocation'
+  });
+  assertEquals(webdriver.Builder.DEFAULT_SERVER_URL,
+      builder.getServerUrl());
+}
+
+
+function testInitializeServerUrlFromQueryString_set() {
+  var builder = new webdriver.Builder({
+    location: '/somelocation?wdurl=http://www.example.com'
+  });
+  assertEquals('http://www.example.com', builder.getServerUrl());
+}
diff --git a/lib/webdriver/test/capabilities_test.js b/lib/webdriver/test/capabilities_test.js
new file mode 100644
index 0000000..2278f1f
--- /dev/null
+++ b/lib/webdriver/test/capabilities_test.js
@@ -0,0 +1,72 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.Capabilities');
+
+function testSettingAndUnsettingACapability() {
+  var caps = new webdriver.Capabilities();
+  assertNull(caps.get('foo'));
+
+  caps.set('foo', 'bar');
+  assertEquals('bar', caps.get('foo'));
+
+  caps.set('foo', null);
+  assertNull(caps.get('foo'));
+}
+
+
+function testCheckingIfACapabilityIsSet() {
+  var caps = new webdriver.Capabilities();
+  assertFalse(caps.has('foo'));
+  assertNull(caps.get('foo'));
+
+  caps.set('foo', 'bar');
+  assertTrue(caps.has('foo'));
+
+  caps.set('foo', true);
+  assertTrue(caps.has('foo'));
+
+  caps.set('foo', false);
+  assertFalse(caps.has('foo'));
+  assertFalse(caps.get('foo'));
+
+  caps.set('foo', null);
+  assertFalse(caps.has('foo'));
+  assertNull(caps.get('foo'));
+}
+
+
+function testMergingCapabilities() {
+  var caps1 = new webdriver.Capabilities().
+      set('foo', 'bar').
+      set('color', 'red');
+
+  var caps2 = new webdriver.Capabilities().
+      set('color', 'green');
+
+  assertEquals('bar', caps1.get('foo'));
+  assertEquals('red', caps1.get('color'));
+  assertEquals('green', caps2.get('color'));
+  assertNull(caps2.get('foo'));
+
+  caps2.merge(caps1);
+  assertEquals('bar', caps1.get('foo'));
+  assertEquals('red', caps1.get('color'));
+  assertEquals('bar', caps2.get('foo'));
+  assertEquals('red', caps2.get('color'));
+}
diff --git a/lib/webdriver/test/events_test.js b/lib/webdriver/test/events_test.js
new file mode 100644
index 0000000..41a86de
--- /dev/null
+++ b/lib/webdriver/test/events_test.js
@@ -0,0 +1,203 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.EventEmitter');
+
+function testEmittingWhenNothingIsRegistered() {
+  var emitter = new webdriver.EventEmitter();
+  emitter.emit('foo');
+  // Ok if no errors are thrown.
+}
+
+function testPassesArgsToListenersOnEmit() {
+  var emitter = new webdriver.EventEmitter();
+  var now = goog.now();
+
+  var messages = [];
+  emitter.addListener('foo', function(arg) { messages.push(arg); });
+
+  emitter.emit('foo', now);
+  assertEquals(1, messages.length);
+  assertEquals(now, messages[0]);
+
+  emitter.emit('foo', now + 15);
+  assertEquals(2, messages.length);
+  assertEquals(now, messages[0]);
+  assertEquals(now + 15, messages[1]);
+}
+
+function testAddingListeners() {
+  var emitter = new webdriver.EventEmitter();
+  var count = 0;
+  emitter.addListener('foo', function() { count++; });
+  emitter.addListener('foo', function() { count++; });
+  emitter.addListener('foo', function() { count++; });
+  emitter.emit('foo');
+  assertEquals(3, count);
+}
+
+function testAddingOneShotListeners() {
+  var emitter = new webdriver.EventEmitter();
+  var count = 0;
+  emitter.once('foo', function() { count++; });
+  emitter.once('foo', function() { count++; });
+  emitter.once('foo', function() { count++; });
+
+  emitter.emit('foo');
+  assertEquals(3, count);
+
+  emitter.emit('foo');
+  assertEquals(3, count);
+}
+
+function testCanOnlyAddAListenerConfigOnce() {
+  var emitter = new webdriver.EventEmitter();
+  var count = 0;
+  function onFoo() { count++; }
+
+  emitter.on('foo', onFoo);
+  emitter.on('foo', onFoo);
+
+  emitter.emit('foo');
+  assertEquals(1, count);
+
+  emitter.emit('foo');
+  assertEquals(2, count);
+}
+
+function testAddingListenersWithCustomScope() {
+  var obj = {
+    count: 0,
+    inc: function() {
+      this.count++;
+    }
+  };
+  var emitter = new webdriver.EventEmitter();
+  emitter.addListener('foo', obj.inc, obj);
+
+  emitter.emit('foo');
+  assertEquals(1, obj.count);
+
+  emitter.emit('foo');
+  assertEquals(2, obj.count);
+
+  emitter.once('bar', obj.inc, obj);
+  emitter.emit('bar');
+  assertEquals(3, obj.count);
+
+  emitter.emit('bar');
+  assertEquals(3, obj.count);
+}
+
+function testRemovingListeners() {
+  var emitter = new webdriver.EventEmitter();
+  var count = 0;
+  emitter.addListener('foo', function() { count++; });
+  emitter.addListener('foo', function() { count++; });
+
+  var toRemove = function() { count++; };
+  emitter.addListener('foo', toRemove);
+
+  emitter.emit('foo');
+  assertEquals(3, count);
+
+  emitter.removeListener('foo', toRemove);
+  emitter.emit('foo');
+  assertEquals(5, count);
+}
+
+function testRemovingAllListeners() {
+  var emitter = new webdriver.EventEmitter();
+  var count = 0;
+  emitter.addListener('foo', function() { count++; });
+  emitter.addListener('foo', function() { count++; });
+  emitter.addListener('foo', function() { count++; });
+
+  emitter.emit('foo');
+  assertEquals(3, count);
+
+  emitter.removeAllListeners('foo');
+
+  emitter.emit('foo');
+  assertEquals(3, count);
+}
+
+function testRemovingAbsolutelyAllListeners() {
+  var emitter = new webdriver.EventEmitter();
+  var messages = [];
+  emitter.addListener('foo', function() { messages.push('foo'); });
+  emitter.addListener('bar', function() { messages.push('bar'); });
+
+  emitter.emit('foo');
+  assertArrayEquals(['foo'], messages);
+
+  emitter.emit('bar');
+  assertArrayEquals(['foo', 'bar'], messages);
+
+  emitter.emit('bar');
+  emitter.emit('foo');
+  assertArrayEquals(['foo', 'bar', 'bar', 'foo'], messages);
+
+  emitter.removeAllListeners();
+  assertArrayEquals(['foo', 'bar', 'bar', 'foo'], messages);
+}
+
+function testListenerThatRemovesItself() {
+  var emitter = new webdriver.EventEmitter();
+  emitter.on('foo', listener);
+  emitter.emit('foo');
+
+  function listener() {
+    emitter.removeListener('foo', listener);
+  }
+}
+
+function testListenerThatRemovesItself_whenThereAreMultipleListeners() {
+  var emitter = new webdriver.EventEmitter();
+  var messages = [];
+  emitter.on('foo', one);
+  emitter.on('foo', two);
+  emitter.emit('foo');
+  assertArrayEquals(['one', 'two'], messages);
+
+  function one() {
+    messages.push('one');
+    emitter.removeListener('foo', one);
+  }
+
+  function two() {
+    messages.push('two');
+  }
+}
+
+function testListenerAddsAnotherForTheSameEventType() {
+  var emitter = new webdriver.EventEmitter();
+  var messages = [];
+  emitter.on('foo', one);
+  emitter.emit('foo');
+  assertArrayEquals(['one', 'two'], messages);
+
+  function one() {
+    messages.push('one');
+    emitter.on('foo', two);
+  }
+
+  function two() {
+    messages.push('two');
+  }
+}
diff --git a/lib/webdriver/test/http/corsclient_test.js b/lib/webdriver/test/http/corsclient_test.js
new file mode 100644
index 0000000..6289b24
--- /dev/null
+++ b/lib/webdriver/test/http/corsclient_test.js
@@ -0,0 +1,151 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.MockControl');
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.http.CorsClient');
+goog.require('webdriver.http.Request');
+goog.require('webdriver.test.testutil');
+
+// Alias for readability.
+var callbackHelper = webdriver.test.testutil.callbackHelper;
+
+function FakeXhr() {}
+FakeXhr.prototype.status = 200;
+FakeXhr.prototype.responseText = '';
+FakeXhr.prototype.withCredentials = false;
+FakeXhr.prototype.open = function() {};
+FakeXhr.prototype.send = function() {};
+FakeXhr.prototype.setRequestHeader = function() {};
+
+var URL = 'http://localhost:4444/wd/hub';
+var REQUEST = new webdriver.http.Request('GET', '/foo');
+
+var control = new goog.testing.MockControl();
+var stubs = new goog.testing.PropertyReplacer();
+var mockClient, mockXhr;
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+function setUp() {
+  mockClient = control.createStrictMock(webdriver.http.Client);
+  mockXhr = control.createStrictMock(FakeXhr);
+  mockXhr.status = 200;
+  mockXhr.responseText = '';
+  mockXhr.withCredentials = false;
+  setXhr(mockXhr);
+}
+
+function tearDown() {
+  control.$tearDown();
+  stubs.reset();
+}
+
+function setXhr(value) {
+  stubs.set(goog.global, 'XMLHttpRequest', function() {
+    return value;
+  });
+  setXdr();
+}
+
+function setXdr(opt_value) {
+  stubs.set(goog.global, 'XDomainRequest', opt_value);
+}
+
+function expectRequest(mockXhr) {
+  mockXhr.open('POST', URL + '/xdrpc', true);
+  return mockXhr.send(JSON.stringify({
+    'method': REQUEST.method,
+    'path': REQUEST.path,
+    'data': REQUEST.data
+  }));
+}
+
+function testDetectsWhenCorsIsAvailable() {
+  setXhr(undefined);
+  assertFalse(webdriver.http.CorsClient.isAvailable());
+  setXhr();
+  assertFalse(webdriver.http.CorsClient.isAvailable());
+  setXhr({withCredentials: null});
+  assertFalse(webdriver.http.CorsClient.isAvailable());
+  setXhr({withCredentials: true});
+  assertTrue(webdriver.http.CorsClient.isAvailable());
+  setXhr();
+  setXdr(goog.nullFunction);
+  assertTrue(webdriver.http.CorsClient.isAvailable());
+}
+
+function testCorsClient_whenUnableToSendARequest() {
+  expectRequest(mockXhr).$does(function() {
+    mockXhr.onerror();
+  });
+  control.$replayAll();
+
+  var callback;
+  new webdriver.http.CorsClient(URL).send(REQUEST,
+      callback = callbackHelper(function(error) {
+        assertNotNullNorUndefined(error);
+        assertEquals(1, arguments.length);
+      }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
+
+function testCorsClient_handlesResponsesWithNoHeaders() {
+  expectRequest(mockXhr).$does(function() {
+    mockXhr.status = 200;
+    mockXhr.responseText = '';
+    mockXhr.onload();
+  });
+  control.$replayAll();
+
+  var callback;
+  new webdriver.http.CorsClient(URL).send(REQUEST,
+      callback = callbackHelper(function(e, response) {
+        assertNull(e);
+        assertEquals(200, response.status);
+        assertEquals('', response.body);
+
+        webdriver.test.testutil.assertObjectEquals({}, response.headers);
+      }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
+
+function testCorsClient_stripsNullCharactersFromResponseBody() {
+  expectRequest(mockXhr).$does(function() {
+    mockXhr.status = 200;
+    mockXhr.responseText = '\x00foo\x00\x00bar\x00';
+    mockXhr.onload();
+  });
+  control.$replayAll();
+
+  var callback;
+  new webdriver.http.CorsClient(URL).send(REQUEST,
+      callback = callbackHelper(function(e, response) {
+        assertNull(e);
+        assertEquals(200, response.status);
+        assertEquals('foobar', response.body);
+        webdriver.test.testutil.assertObjectEquals({}, response.headers);
+      }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
diff --git a/lib/webdriver/test/http/http_test.js b/lib/webdriver/test/http/http_test.js
new file mode 100644
index 0000000..1b37ca3
--- /dev/null
+++ b/lib/webdriver/test/http/http_test.js
@@ -0,0 +1,428 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('bot.ErrorCode');
+goog.require('goog.Uri');
+goog.require('goog.testing.MockControl');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.Command');
+goog.require('webdriver.http.Client');
+goog.require('webdriver.http.Executor');
+goog.require('webdriver.promise');
+goog.require('webdriver.test.testutil');
+
+// Alias for readability.
+var callbackHelper = webdriver.test.testutil.callbackHelper;
+
+var control = new goog.testing.MockControl();
+var mockClient, executor, onCallback, onErrback;
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+function setUp() {
+  mockClient = control.createStrictMock(webdriver.http.Client);
+
+  executor = new webdriver.http.Executor(mockClient);
+}
+
+function tearDown() {
+  control.$tearDown();
+}
+
+function assertSuccess() {
+  onErrback.assertNotCalled('Did not expect errback');
+  onCallback.assertCalled('Expected callback');
+}
+
+function assertFailure() {
+  onCallback.assertNotCalled('Did not expect callback');
+  onErrback.assertCalled('Expected errback');
+}
+
+function headersToString(headers) {
+  var str = [];
+  for (var key in headers) {
+    str.push(key + ': ' + headers[key]);
+  }
+  return str.join('\n');
+}
+
+function expectRequest(method, path, data, headers) {
+  var description = method + ' ' + path + '\n' + headersToString(headers) +
+                    '\n' + JSON.stringify(data);
+
+  return mockClient.send(new goog.testing.mockmatchers.ArgumentMatcher(
+      function(request) {
+        assertEquals('wrong method', method, request.method);
+        assertEquals('wrong path', path + '', request.path);
+        webdriver.test.testutil.assertObjectEquals(data, request.data);
+        assertNull(
+            'Wrong headers for request:\n' + description +
+            '\n    Actual headers were:\n' + headersToString(request.headers),
+            goog.testing.asserts.findDifferences(headers, request.headers));
+        return true;
+      }, description),
+      goog.testing.mockmatchers.isFunction);
+}
+
+function response(status, headers, body) {
+  return new webdriver.http.Response(status, headers, body);
+}
+
+function respondsWith(error, opt_response) {
+  return function(request, callback) {
+    callback(error, opt_response);
+  };
+}
+
+///////////////////////////////////////////////////////////////////////////////
+//
+//  Tests
+//
+///////////////////////////////////////////////////////////////////////////////
+
+function testBuildPath() {
+  var parameters = {'sessionId':'foo', 'url':'http://www.google.com'};
+  var finalPath = webdriver.http.Executor.buildPath_(
+      '/session/:sessionId/url', parameters);
+  assertEquals('/session/foo/url', finalPath);
+  webdriver.test.testutil.assertObjectEquals({'url':'http://www.google.com'},
+      parameters);
+}
+
+function testBuildPath_withWebElement() {
+  var parameters = {'sessionId':'foo', 'id': {}};
+  parameters['id']['ELEMENT'] = 'bar';
+
+  var finalPath = webdriver.http.Executor.buildPath_(
+      '/session/:sessionId/element/:id/click', parameters);
+  assertEquals('/session/foo/element/bar/click', finalPath);
+  webdriver.test.testutil.assertObjectEquals({}, parameters);
+}
+
+function testBuildPath_throwsIfMissingParameter() {
+  assertThrows(goog.partial(webdriver.http.Executor.buildPath_,
+      '/session/:sessionId', {}));
+
+  assertThrows(goog.partial(webdriver.http.Executor.buildPath_,
+      '/session/:sessionId/element/:id', {'sessionId': 'foo'}));
+}
+
+function testBuildPath_doesNotMatchOnSegmentsThatDoNotStartWithColon() {
+  assertEquals('/session/foo:bar/baz',
+      webdriver.http.Executor.buildPath_('/session/foo:bar/baz', {}));
+}
+
+function testExecute_rejectsUnrecognisedCommands() {
+  assertThrows(goog.bind(executor.execute, executor,
+      new webdriver.Command('fake-command-name'), goog.nullFunction));
+}
+
+/**
+ * @param {!webdriver.Command} command The command to send.
+ * @param {!Function=} opt_onSuccess The function to check the response with.
+ */
+function assertSendsSuccessfully(command, opt_onSuccess) {
+  var callback;
+  executor.execute(command, callback = callbackHelper(function(e, response) {
+    assertNull(e);
+    assertNotNullNorUndefined(response);
+    if (opt_onSuccess) {
+      opt_onSuccess(response);
+    }
+  }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
+
+/**
+ * @param {!webdriver.Command} command The command to send.
+ * @param {!Function=} opt_onError The function to check the error with.
+ */
+function assertFailsToSend(command, opt_onError) {
+  var callback;
+  executor.execute(command, callback = callbackHelper(function(e, response) {
+    assertNotNullNorUndefined(e);
+    assertUndefined(response);
+    if (opt_onError) {
+      opt_onError(e);
+    }
+  }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
+
+function testExecute_clientFailsToSendRequest() {
+  var error = new Error('boom');
+  expectRequest('POST', '/session', {}, {
+    'Accept': 'application/json; charset=utf-8'
+  }).
+  $does(respondsWith(error));
+  control.$replayAll();
+
+  assertFailsToSend(new webdriver.Command(webdriver.CommandName.NEW_SESSION),
+      function(e) {
+        assertEquals(error, e);
+      });
+}
+
+function testExecute_commandWithNoUrlParameters() {
+  expectRequest('POST', '/session', {}, {
+    'Accept': 'application/json; charset=utf-8'
+  }).
+  $does(respondsWith(null, response(200, {}, '')));
+  control.$replayAll();
+
+  assertSendsSuccessfully(
+      new webdriver.Command(webdriver.CommandName.NEW_SESSION));
+}
+
+function testExecute_rejectsCommandsMissingUrlParameters() {
+  var command =
+      new webdriver.Command(webdriver.CommandName.FIND_CHILD_ELEMENT).
+          setParameter('sessionId', 's123').
+          // Let this be missing: setParameter('id', {'ELEMENT': 'e456'}).
+          setParameter('using', 'id').
+          setParameter('value', 'foo');
+
+  control.$replayAll();
+  assertThrows(goog.bind(executor.execute, executor, command));
+  control.$verifyAll();
+}
+
+function testExecute_replacesUrlParametersWithCommandParameters() {
+  var command =
+      new webdriver.Command(webdriver.CommandName.GET).
+          setParameter('sessionId', 's123').
+          setParameter('url', 'http://www.google.com');
+
+  expectRequest('POST', '/session/s123/url',
+      {'url': 'http://www.google.com'},
+      {'Accept': 'application/json; charset=utf-8'}).
+      $does(respondsWith(null, response(200, {}, '')));
+  control.$replayAll();
+
+  assertSendsSuccessfully(command);
+}
+
+function testExecute_returnsParsedJsonResponse() {
+  var responseObj = {
+    'status': bot.ErrorCode.SUCCESS,
+    'value': 'http://www.google.com'
+  };
+  var command = new webdriver.Command(webdriver.CommandName.GET_CURRENT_URL).
+      setParameter('sessionId', 's123');
+
+  expectRequest('GET', '/session/s123/url', {}, {
+    'Accept': 'application/json; charset=utf-8'
+  }).$does(respondsWith(null,
+      response(200, {'Content-Type': 'application/json'},
+          JSON.stringify(responseObj))));
+  control.$replayAll();
+
+  assertSendsSuccessfully(command, function(response) {
+    webdriver.test.testutil.assertObjectEquals(responseObj, response);
+  });
+}
+
+function testExecute_returnsSuccessFor2xxWithBodyAsValueWhenNotJson() {
+  var command = new webdriver.Command(webdriver.CommandName.GET_CURRENT_URL).
+      setParameter('sessionId', 's123');
+
+  expectRequest('GET', '/session/s123/url', {}, {
+    'Accept': 'application/json; charset=utf-8'
+  }).$does(respondsWith(null,
+      response(200, {}, 'hello, world\r\ngoodbye, world!')));
+  control.$replayAll();
+
+  assertSendsSuccessfully(command, function(response) {
+    webdriver.test.testutil.assertObjectEquals({
+      'status': bot.ErrorCode.SUCCESS,
+      'value': 'hello, world\ngoodbye, world!'
+    }, response);
+  });
+}
+
+function testExecute_returnsSuccessFor2xxInvalidJsonBody() {
+  var invalidJson = '[';
+  expectRequest('POST', '/session', {}, {
+    'Accept': 'application/json; charset=utf-8'
+  }).
+  $does(respondsWith(null, response(200, {
+    'Content-Type': 'application/json'
+  }, invalidJson)));
+  control.$replayAll();
+
+  assertSendsSuccessfully(
+      new webdriver.Command(webdriver.CommandName.NEW_SESSION),
+      function(response) {
+        webdriver.test.testutil.assertObjectEquals({
+          'status': bot.ErrorCode.SUCCESS,
+          'value': invalidJson
+        }, response);
+      });
+}
+
+function testExecute_returnsUnknownCommandFor404WithBodyAsValueWhenNotJson() {
+  var command = new webdriver.Command(webdriver.CommandName.GET_CURRENT_URL).
+      setParameter('sessionId', 's123');
+
+  expectRequest('GET', '/session/s123/url', {}, {
+    'Accept': 'application/json; charset=utf-8'
+  }).$does(respondsWith(null,
+      response(404, {}, 'hello, world\r\ngoodbye, world!')));
+  control.$replayAll();
+
+  assertSendsSuccessfully(command, function(response) {
+    webdriver.test.testutil.assertObjectEquals({
+      'status': bot.ErrorCode.UNKNOWN_COMMAND,
+      'value': 'hello, world\ngoodbye, world!'
+    }, response);
+  });
+}
+
+function testExecute_returnsUnknownErrorForGenericErrorCodeWithBodyAsValueWhenNotJson() {
+  var command = new webdriver.Command(webdriver.CommandName.GET_CURRENT_URL).
+      setParameter('sessionId', 's123');
+
+  expectRequest('GET', '/session/s123/url', {}, {
+    'Accept': 'application/json; charset=utf-8'
+  }).$does(respondsWith(null,
+      response(500, {}, 'hello, world\r\ngoodbye, world!')));
+  control.$replayAll();
+
+  assertSendsSuccessfully(command, function(response) {
+    webdriver.test.testutil.assertObjectEquals({
+      'status': bot.ErrorCode.UNKNOWN_ERROR,
+      'value': 'hello, world\ngoodbye, world!'
+    }, response);
+  });
+}
+
+function testExecute_attemptsToParseBodyWhenNoContentTypeSpecified() {
+  var responseObj = {
+    'status': bot.ErrorCode.SUCCESS,
+    'value': 'http://www.google.com'
+  };
+  var command = new webdriver.Command(webdriver.CommandName.GET_CURRENT_URL).
+      setParameter('sessionId', 's123');
+
+  expectRequest('GET', '/session/s123/url', {}, {
+    'Accept': 'application/json; charset=utf-8'
+  }).$does(respondsWith(null,
+      response(200, {}, JSON.stringify(responseObj))));
+  control.$replayAll();
+
+  assertSendsSuccessfully(command, function(response) {
+    webdriver.test.testutil.assertObjectEquals(responseObj, response);
+  });
+}
+
+function testCanDefineNewCommands() {
+  executor.defineCommand('greet', 'GET', '/person/:name');
+
+  var command = new webdriver.Command('greet').
+      setParameter('name', 'Bob');
+
+  expectRequest('GET', '/person/Bob', {},
+      {'Accept': 'application/json; charset=utf-8'}).
+      $does(respondsWith(null, response(200, {}, '')));
+  control.$replayAll();
+
+  assertSendsSuccessfully(command);
+}
+
+function testCanRedefineStandardCommands() {
+  executor.defineCommand(webdriver.CommandName.GO_BACK,
+      'POST', '/custom/back');
+
+  var command = new webdriver.Command(webdriver.CommandName.GO_BACK).
+      setParameter('times', 3);
+
+  expectRequest('POST', '/custom/back',
+      {'times': 3},
+      {'Accept': 'application/json; charset=utf-8'}).
+      $does(respondsWith(null, response(200, {}, '')));
+  control.$replayAll();
+
+  assertSendsSuccessfully(command);
+}
+
+function FakeXmlHttpRequest(headers, status, responseText) {
+  return {
+    getAllResponseHeaders: function() { return headers; },
+    status: status,
+    responseText: responseText
+  };
+}
+
+function testXmlHttpRequestToHttpResponse_parseHeaders_windows() {
+  var response = webdriver.http.Response.fromXmlHttpRequest(
+      FakeXmlHttpRequest([
+        'a:b',
+        'c: d',
+        'e :f',
+        'g : h'
+      ].join('\r\n'), 200, ''));
+  assertEquals(200, response.status);
+  assertEquals('', response.body);
+
+  webdriver.test.testutil.assertObjectEquals({
+    'a': 'b',
+    'c': 'd',
+    'e': 'f',
+    'g': 'h'
+  }, response.headers);
+}
+
+function testXmlHttpRequestToHttpResponse_parseHeaders_unix() {
+  var response = webdriver.http.Response.fromXmlHttpRequest(
+      FakeXmlHttpRequest([
+        'a:b',
+        'c: d',
+        'e :f',
+        'g : h'
+      ].join('\n'), 200, ''));
+  assertEquals(200, response.status);
+  assertEquals('', response.body);
+
+  webdriver.test.testutil.assertObjectEquals({
+    'a': 'b',
+    'c': 'd',
+    'e': 'f',
+    'g': 'h'
+  }, response.headers);
+}
+
+function testXmlHttpRequestToHttpResponse_noHeaders() {
+  var response = webdriver.http.Response.fromXmlHttpRequest(
+      FakeXmlHttpRequest('', 200, ''));
+  assertEquals(200, response.status);
+  assertEquals('', response.body);
+  webdriver.test.testutil.assertObjectEquals({}, response.headers);
+}
+
+function testXmlHttpRequestToHttpResponse_stripsNullCharactersFromBody() {
+  var response = webdriver.http.Response.fromXmlHttpRequest(
+      FakeXmlHttpRequest('', 200, '\x00\0foo\x00\x00bar\x00\0'));
+  assertEquals(200, response.status);
+  assertEquals('foobar', response.body);
+  webdriver.test.testutil.assertObjectEquals({}, response.headers);
+}
diff --git a/lib/webdriver/test/http/xhrclient_test.js b/lib/webdriver/test/http/xhrclient_test.js
new file mode 100644
index 0000000..9f2c3db
--- /dev/null
+++ b/lib/webdriver/test/http/xhrclient_test.js
@@ -0,0 +1,196 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.MockControl');
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.http.Request');
+goog.require('webdriver.http.XhrClient');
+goog.require('webdriver.promise');
+goog.require('webdriver.test.testutil');
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+// Alias for readability.
+var callbackHelper = webdriver.test.testutil.callbackHelper;
+
+function FakeXhr() {}
+FakeXhr.prototype.status = 200;
+FakeXhr.prototype.responseText = '';
+FakeXhr.prototype.open = function() {};
+FakeXhr.prototype.send = function() {};
+FakeXhr.prototype.getAllResponseHeaders = function() {};
+FakeXhr.prototype.setRequestHeader = function() {};
+
+var URL = 'http://localhost:4444/wd/hub';
+var REQUEST = new webdriver.http.Request('GET', '/foo');
+
+var control = new goog.testing.MockControl();
+var stubs = new goog.testing.PropertyReplacer();
+var mockClient, mockXhr;
+
+function setUp() {
+  mockClient = control.createStrictMock(webdriver.http.Client);
+  mockXhr = control.createStrictMock(FakeXhr);
+  stubs.set(goog.global, 'XMLHttpRequest', function() {
+    return mockXhr;
+  });
+}
+
+function tearDown() {
+  control.$tearDown();
+  stubs.reset();
+}
+
+function setXhr(value) {
+  stubs.set(goog.global, 'XMLHttpRequest', value);
+}
+
+function expectRequest(mockXhr) {
+  mockXhr.open(REQUEST.method, URL + REQUEST.path, true);
+  for (var header in REQUEST.headers) {
+    mockXhr.setRequestHeader(header, REQUEST.headers[header]);
+  }
+  return mockXhr.send(JSON.stringify(REQUEST.data));
+}
+
+function testXhrClient_whenUnableToSendARequest() {
+  expectRequest(mockXhr).$does(function() {
+    mockXhr.onerror();
+  });
+  control.$replayAll();
+
+  var callback;
+  new webdriver.http.XhrClient(URL).send(REQUEST,
+      callback = callbackHelper(function(error) {
+        assertNotNullNorUndefined(error);
+        assertEquals(1, arguments.length);
+      }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
+
+function testXhrClient_parsesResponseHeaders_windows() {
+  expectRequest(mockXhr).$does(function() {
+    mockXhr.status = 200;
+    mockXhr.responseText = '';
+    mockXhr.onload();
+  });
+  mockXhr.getAllResponseHeaders().$returns([
+    'a:b',
+    'c: d',
+    'e :f',
+    'g : h'
+  ].join('\r\n'));
+  control.$replayAll();
+
+  var callback;
+  new webdriver.http.XhrClient(URL).send(REQUEST,
+      callback = callbackHelper(function(e, response) {
+        assertNull(e);
+
+        assertEquals(200, response.status);
+        assertEquals('', response.body);
+
+        webdriver.test.testutil.assertObjectEquals({
+          'a': 'b',
+          'c': 'd',
+          'e': 'f',
+          'g': 'h'
+        }, response.headers);
+      }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
+
+function testXhrClient_parsesResponseHeaders_unix() {
+  expectRequest(mockXhr).$does(function() {
+    mockXhr.status = 200;
+    mockXhr.responseText = '';
+    mockXhr.onload();
+  });
+  mockXhr.getAllResponseHeaders().$returns([
+    'a:b',
+    'c: d',
+    'e :f',
+    'g : h'
+  ].join('\n'));
+  control.$replayAll();
+
+  var callback;
+  new webdriver.http.XhrClient(URL).send(REQUEST,
+      callback = callbackHelper(function(e, response) {
+        assertNull(e);
+        assertEquals(200, response.status);
+        assertEquals('', response.body);
+
+        webdriver.test.testutil.assertObjectEquals({
+          'a': 'b',
+          'c': 'd',
+          'e': 'f',
+          'g': 'h'
+        }, response.headers);
+      }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
+
+function testXhrClient_handlesResponsesWithNoHeaders() {
+  expectRequest(mockXhr).$does(function() {
+    mockXhr.status = 200;
+    mockXhr.responseText = '';
+    mockXhr.onload();
+  });
+  mockXhr.getAllResponseHeaders().$returns('');
+  control.$replayAll();
+
+  var callback;
+  new webdriver.http.XhrClient(URL).send(REQUEST,
+      callback = callbackHelper(function(e, response) {
+        assertNull(e);
+        assertEquals(200, response.status);
+        assertEquals('', response.body);
+
+        webdriver.test.testutil.assertObjectEquals({}, response.headers);
+      }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
+
+function testXhrClient_stripsNullCharactersFromResponseBody() {
+  expectRequest(mockXhr).$does(function() {
+    mockXhr.status = 200;
+    mockXhr.responseText = '\x00foo\x00\x00bar\x00';
+    mockXhr.onload();
+  });
+  mockXhr.getAllResponseHeaders().$returns('');
+  control.$replayAll();
+
+  var callback;
+  new webdriver.http.XhrClient(URL).send(REQUEST,
+      callback = callbackHelper(function(e, response) {
+        assertNull(e);
+        assertEquals(200, response.status);
+        assertEquals('foobar', response.body);
+        webdriver.test.testutil.assertObjectEquals({}, response.headers);
+      }));
+  callback.assertCalled();
+  control.$verifyAll();
+}
diff --git a/lib/webdriver/test/locators_test.js b/lib/webdriver/test/locators_test.js
new file mode 100644
index 0000000..21e6479
--- /dev/null
+++ b/lib/webdriver/test/locators_test.js
@@ -0,0 +1,59 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.By');
+goog.require('webdriver.Locator');
+goog.require('webdriver.Locator.Strategy');
+goog.require('webdriver.test.testutil');
+
+// By is exported by webdriver.By, but IDEs don't recognize
+// goog.exportSymbol. Explicitly define it here to make the
+// IDE stop complaining.
+var By = webdriver.By;
+
+var TARGET = 'some-value';
+
+function testCheckLocator() {
+  function assertLocatorTypeAndTarget(expectedLocator, locator) {
+    assertEquals('Wrong type', expectedLocator.using, locator.using);
+    assertEquals('Wrong target', expectedLocator.value, locator.value);
+  }
+
+
+  for (var prop in webdriver.Locator.Strategy) {
+    var obj = {};
+    obj[prop] = TARGET;
+    assertLocatorTypeAndTarget(
+        webdriver.Locator.Strategy[prop](TARGET),
+        webdriver.Locator.checkLocator(obj));
+    assertLocatorTypeAndTarget(
+        webdriver.Locator.Strategy[prop](TARGET),
+        webdriver.Locator.checkLocator(By[prop](TARGET)));
+  }
+
+  assertEquals(
+      'Should accept custom locator functions',
+      goog.nullFunction,
+      webdriver.Locator.checkLocator(goog.nullFunction));
+}
+
+function testToString() {
+  assertEquals('By.id("foo")', By.id('foo').toString());
+  assertEquals('By.className("foo")', By.className('foo').toString());
+  assertEquals('By.linkText("foo")', By.linkText('foo').toString());
+}
diff --git a/lib/webdriver/test/logging_test.js b/lib/webdriver/test/logging_test.js
new file mode 100644
index 0000000..bb542f9
--- /dev/null
+++ b/lib/webdriver/test/logging_test.js
@@ -0,0 +1,85 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.debug.LogRecord');
+goog.require('goog.debug.Logger');
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.logging');
+
+function convert(level, msg, name, time) {
+  var recordIn = new webdriver.logging.LogRecord(level, msg, name, time);
+  return webdriver.logging.Entry.fromClosureLogRecord(recordIn);
+}
+
+function checkRecord(record, level, msg, time) {
+  assertEquals('wrong level', level.value, record.level.value);
+  assertEquals('wrong message', msg, record.message);
+  assertEquals('wrong time', time, record.timestamp);
+}
+
+function testPreferencesToJSON() {
+  var prefs = new webdriver.logging.Preferences();
+  assertObjectEquals({}, prefs.toJSON());
+
+  prefs.setLevel('foo', webdriver.logging.Level.DEBUG);
+  assertObjectEquals({'foo': 'DEBUG'}, prefs.toJSON());
+
+  prefs.setLevel('bar', webdriver.logging.Level.OFF);
+  prefs.setLevel('baz', webdriver.logging.Level.WARNING);
+  assertObjectEquals(
+      {'foo': 'DEBUG', 'bar': 'OFF', 'baz': 'WARNING'},
+      prefs.toJSON());
+
+  // CONFIG should always map to DEBUG.
+  prefs.setLevel('quux', webdriver.logging.Level.CONFIG);
+  assertObjectEquals(
+      {'foo': 'DEBUG', 'bar': 'OFF', 'baz': 'WARNING', 'quux': 'DEBUG'},
+      prefs.toJSON());
+
+  prefs.setLevel('quot', webdriver.logging.Level.ALL);
+  assertObjectEquals(
+      {'foo': 'DEBUG', 'bar': 'OFF', 'baz': 'WARNING', 'quux': 'DEBUG',
+       'quot': 'ALL'},
+      prefs.toJSON());
+}
+
+function testConvertingLogRecords() {
+  checkRecord(
+      convert(goog.debug.Logger.Level.SHOUT, 'foo bar', 'the.name', 1234),
+      webdriver.logging.Level.SEVERE, '[the.name] foo bar', 1234);
+  checkRecord(
+      convert(goog.debug.Logger.Level.SEVERE, 'foo bar', 'the.name', 1234),
+      webdriver.logging.Level.SEVERE, '[the.name] foo bar', 1234);
+  checkRecord(
+      convert(goog.debug.Logger.Level.WARNING, 'foo bar', 'the.name', 1234),
+      webdriver.logging.Level.WARNING, '[the.name] foo bar', 1234);
+  checkRecord(
+      convert(goog.debug.Logger.Level.INFO, 'foo bar', 'the.name', 1234),
+      webdriver.logging.Level.INFO, '[the.name] foo bar', 1234);
+  checkRecord(
+      convert(goog.debug.Logger.Level.CONFIG, 'foo bar', 'the.name', 1234),
+      webdriver.logging.Level.DEBUG, '[the.name] foo bar', 1234);
+  checkRecord(
+      convert(goog.debug.Logger.Level.FINE, 'foo bar', 'the.name', 1234),
+      webdriver.logging.Level.DEBUG, '[the.name] foo bar', 1234);
+  checkRecord(
+      convert(goog.debug.Logger.Level.FINER, 'foo bar', 'the.name', 1234),
+      webdriver.logging.Level.DEBUG, '[the.name] foo bar', 1234);
+  checkRecord(
+      convert(goog.debug.Logger.Level.FINEST, 'foo bar', 'the.name', 1234),
+      webdriver.logging.Level.DEBUG, '[the.name] foo bar', 1234);
+}
diff --git a/lib/webdriver/test/process_test.js b/lib/webdriver/test/process_test.js
new file mode 100644
index 0000000..c8f7bf6
--- /dev/null
+++ b/lib/webdriver/test/process_test.js
@@ -0,0 +1,72 @@
+// Copyright 2014 Software Freedom Conservancy. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.process');
+goog.require('webdriver.test.testutil');
+
+var stubs = new goog.testing.PropertyReplacer();
+
+function tearDown() {
+  stubs.reset();
+}
+
+function initProcess(windowObject) {
+  stubs.set(webdriver.process, 'PROCESS_',
+      webdriver.process.initBrowserProcess_(windowObject));
+}
+
+function testInitializesEnvironmentVariablesFromLocation() {
+  initProcess({location: '?a&b=123&c=456&c=789'});
+  assertEquals('', webdriver.process.getEnv('a'));
+  assertEquals('123', webdriver.process.getEnv('b'));
+  assertEquals('["456","789"]', webdriver.process.getEnv('c'));
+  assertUndefined(webdriver.process.getEnv('not-there'));
+}
+
+function testSettingEnvironmentVariables() {
+  initProcess({});
+  assertUndefined(webdriver.process.getEnv('foo'));
+  webdriver.process.setEnv('foo', 'bar');
+  assertEquals('bar', webdriver.process.getEnv('foo'));
+}
+
+function testCoercesNewEnvironmentVariablesToAString() {
+  initProcess({});
+  assertUndefined(webdriver.process.getEnv('foo'));
+  webdriver.process.setEnv('foo', goog.nullFunction);
+  assertEquals(goog.nullFunction + '', webdriver.process.getEnv('foo'));
+
+  assertUndefined(webdriver.process.getEnv('bar'));
+  webdriver.process.setEnv('bar', 123);
+  assertEquals('123', webdriver.process.getEnv('bar'));
+}
+
+function testCanUnsetEnvironmentVariables() {
+  initProcess({});
+  assertUndefined(webdriver.process.getEnv('foo'));
+
+  webdriver.process.setEnv('foo', 'one');
+  assertEquals('one', webdriver.process.getEnv('foo'));
+
+  webdriver.process.setEnv('foo');
+  assertUndefined(webdriver.process.getEnv('foo'));
+
+  webdriver.process.setEnv('foo', 'two');
+  assertEquals('two', webdriver.process.getEnv('foo'));
+
+  webdriver.process.setEnv('foo', null);
+  assertUndefined(webdriver.process.getEnv('foo'));
+}
diff --git a/lib/webdriver/test/promise_error_test.js b/lib/webdriver/test/promise_error_test.js
new file mode 100644
index 0000000..ef2060b
--- /dev/null
+++ b/lib/webdriver/test/promise_error_test.js
@@ -0,0 +1,892 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Contains tests against promise error handling. Many tests use
+ * goog.Promise to control test termination independent of webdriver.promise
+ * (and notably webdriver.promise.ControlFlow).
+ */
+
+'use strict';
+
+goog.require('goog.Promise');
+goog.require('goog.async.run');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('goog.userAgent.product');
+goog.require('webdriver.promise');
+goog.require('webdriver.test.testutil');
+
+
+
+var StubError = webdriver.test.testutil.StubError,
+    throwStubError = webdriver.test.testutil.throwStubError,
+    assertIsStubError = webdriver.test.testutil.assertIsStubError;
+
+
+var flow, uncaughtExceptions;
+
+
+function longStackTracesAreBroken() {
+  // Safari 8.0 is "Safari/538.35.8" in the user agent.
+  return goog.userAgent.product.SAFARI &&
+      !goog.userAgent.isVersionOrHigher(538);
+}
+
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+
+function setUp() {
+  flow = webdriver.promise.controlFlow();
+  uncaughtExceptions = [];
+  flow.on('uncaughtException', onUncaughtException);
+}
+
+
+function tearDown() {
+  return waitForIdle(flow).then(function() {
+    assertArrayEquals('There were uncaught exceptions',
+        [], uncaughtExceptions);
+    flow.reset();
+  });
+}
+
+
+function onUncaughtException(e) {
+  uncaughtExceptions.push(e);
+}
+
+
+function waitForAbort(opt_flow, opt_n) {
+  var n = opt_n || 1;
+  var theFlow = opt_flow || flow;
+  theFlow.removeAllListeners(
+      webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);
+  return new goog.Promise(function(fulfill, reject) {
+    theFlow.once('idle', function() {
+      reject(Error('expected flow to report an unhandled error'));
+    });
+
+    var errors = [];
+    theFlow.on('uncaughtException', onError);
+    function onError(e) {
+      errors.push(e);
+      if (errors.length === n) {
+        theFlow.removeListener('uncaughtException', onError);
+        fulfill(n === 1 ? errors[0] : errors);
+      }
+    }
+  });
+}
+
+
+function waitForIdle(opt_flow) {
+  var theFlow = opt_flow || flow;
+  return new goog.Promise(function(fulfill, reject) {
+    if (theFlow.isIdle()) {
+      fulfill();
+      return;
+    }
+    theFlow.once('idle', fulfill);
+    theFlow.once('uncaughtException', reject);
+  });
+}
+
+
+function testRejectedPromiseTriggersErrorCallback() {
+  return webdriver.promise.rejected(new StubError).
+      then(fail, assertIsStubError);
+}
+
+
+function testCallbackThrowsTriggersSubsequentErrorCallback_fulfilledPromise() {
+  return webdriver.promise.fulfilled().
+      then(throwStubError).
+      then(fail, assertIsStubError);
+}
+
+
+function testCallbackThrowsTriggersSubsequentErrorCallback_rejectedPromise() {
+  var e = Error('not the droids you are looking for');
+  return webdriver.promise.rejected(e).
+      then(fail, throwStubError).
+      then(fail, assertIsStubError);
+}
+
+
+function
+testCallbackReturnsRejectedPromiseTriggersSubsequentErrback_fulfilled() {
+  return webdriver.promise.fulfilled().then(function() {
+    return webdriver.promise.rejected(new StubError);
+  }).then(fail, assertIsStubError);
+}
+
+
+function
+testCallbackReturnsRejectedPromiseTriggersSubsequentErrback_rejected() {
+  var e = Error('not the droids you are looking for');
+  return webdriver.promise.rejected(e).
+      then(fail, function() {
+        return webdriver.promise.rejected(new StubError);
+      }).
+      then(fail, assertIsStubError);
+}
+
+
+function testReportsUnhandledRejectionsThroughTheControlFlow() {
+  webdriver.promise.rejected(new StubError);
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testMultipleUnhandledRejectionsOutsideATask_reportedInOrderOccurred() {
+  var e1 = Error('error 1');
+  var e2 = Error('error 2');
+
+  webdriver.promise.rejected(e1);
+  webdriver.promise.rejected(e2);
+
+  return waitForAbort(flow).then(function(error) {
+    assertTrue(
+        error instanceof webdriver.promise.MultipleUnhandledRejectionError);
+    // TODO: switch to Array.from when we drop node 0.12.x
+    var errors = [];
+    for (var e of error.errors) {
+      errors.push(e);
+    }
+    assertArrayEquals([e1, e2], errors);
+  });
+}
+
+
+function testDoesNotReportUnhandledErrorIfHandlerAddedBeforeNextTick() {
+  var promise = webdriver.promise.rejected(new StubError);
+  promise.then(fail, assertIsStubError);
+  return waitForIdle();
+}
+
+
+function testDoesNotReportUnhandledErrorIfHandlerAddedAsyncBeforeReport() {
+  var called = false;
+  return new goog.Promise(function(fulfill, reject) {
+    var promise;
+    goog.async.run(function() {
+      promise.then(fail, function(e) {
+        called = true;
+        assertIsStubError(e);
+      });
+      waitForIdle().then(fulfill, reject);
+    });
+    promise = webdriver.promise.rejected(new StubError);
+  }).then(function() {
+    assertTrue(called);
+  })
+}
+
+
+function testTaskThrows() {
+  return flow.execute(throwStubError).then(fail, assertIsStubError);
+}
+
+
+function testTaskReturnsRejectedPromise() {
+  return flow.execute(function() {
+    return webdriver.promise.rejected(new StubError)
+  }).then(fail, assertIsStubError);
+}
+
+
+function testTaskHasUnhandledRejection() {
+  return flow.execute(function() {
+    webdriver.promise.rejected(new StubError)
+  }).then(fail, assertIsStubError);
+}
+
+
+function testTaskFails_returnedPromiseIsUnhandled() {
+  flow.execute(throwStubError);
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testTaskHasUnhandledRejection_cancelsRemainingSubTasks() {
+  var seen = [];
+  flow.execute(function() {
+    webdriver.promise.rejected(new StubError);
+
+    flow.execute(() => seen.push('a'))
+        .then(() => seen.push('b'), (e) => seen.push(e));
+    flow.execute(() => seen.push('c'))
+        .then(() => seen.push('b'), (e) => seen.push(e));
+  });
+
+  return waitForAbort()
+      .then(assertIsStubError)
+      .then(() => assertArrayEquals([], seen));
+}
+
+
+function testSubTaskFails_caughtByParentTask() {
+  return flow.execute(function() {
+    flow.execute(throwStubError);
+  }).then(fail, assertIsStubError);
+}
+
+
+function testSubTaskFails_uncaughtErrorBubblesUpToFlow() {
+  flow.execute(function() {
+    flow.execute(throwStubError);
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testSubTasilFails_cancelsRemainingSubTasks() {
+  var seen = [];
+  flow.execute(function() {
+    flow.execute(() => webdriver.promise.rejected(new StubError));
+    flow.execute(() => seen.push('a'))
+        .then(() => seen.push('b'), (e) => seen.push(e));
+    flow.execute(() => seen.push('c'))
+        .then(() => seen.push('b'), (e) => seen.push(e));
+  });
+
+  return waitForAbort()
+      .then(assertIsStubError)
+      .then(() => assertArrayEquals([], seen));
+}
+
+
+function testNestedTaskFails_returnsUpToParent() {
+  return flow.execute(function() {
+    return flow.execute(function() {
+      return flow.execute(throwStubError);
+    });
+  }).then(fail, assertIsStubError);
+}
+
+
+function testNestedTaskFails_uncaughtErrorBubblesUp_taskThrows() {
+  flow.execute(function() {
+    flow.execute(function() {
+      flow.execute(throwStubError);
+    });
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testNestedTaskFails_uncaughtErrorBubblesUp_taskThrows_caughtAtRoot() {
+  flow.execute(function() {
+    flow.execute(function() {
+      flow.execute(throwStubError);
+    });
+  }).then(fail, assertIsStubError);
+  return waitForIdle();
+}
+
+
+function testNestedTaskFails_uncaughtErrorBubblesUp_promise() {
+  flow.execute(function() {
+    flow.execute(function() {
+      flow.execute(function() {
+        webdriver.promise.rejected(new StubError);
+      });
+    });
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testNestedTaskFails_uncaughtErrorBubblesUp_promise_caughtAtRoot() {
+  flow.execute(function() {
+    flow.execute(function() {
+      webdriver.promise.rejected(new StubError);
+    });
+  }).then(fail, assertIsStubError);
+  return waitForIdle();
+}
+
+
+function testNestedTaskFails_mixtureOfHangingAndFreeSubTasks() {
+  flow.execute(function() {
+    return flow.execute(function() {
+      flow.execute(throwStubError);
+    });
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testTaskReturnsPromiseLikeObjectThatInvokesErrback() {
+  return flow.execute(function() {
+    return {
+      'then': function(_, errback) {
+        errback('abc123');
+      }
+    };
+  }).then(fail, function(value) {
+    assertEquals('abc123', value);
+  });
+}
+
+
+function testWaitConditionThrows_waitFailureIsCaught() {
+  return flow.wait(throwStubError, 50).then(fail, assertIsStubError);
+}
+
+
+function testWaitConditionThrows_waitFailureIsNotCaught() {
+  flow.wait(throwStubError, 50);
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testWaitConditionReturnsRejectedPromise_waitFailureIsCaught() {
+  return flow.wait(function() {
+    return webdriver.promise.rejected(new StubError);
+  }, 50).then(fail, assertIsStubError);
+}
+
+
+function testWaitConditionReturnsRejectedPromise_waitFailureIsNotCaught() {
+  flow.wait(function() {
+    return webdriver.promise.rejected(new StubError);
+  }, 50);
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testWaitConditionHasUnhandledPromiseRejection_waitFailureCaught() {
+  return flow.wait(function() {
+    webdriver.promise.rejected(new StubError);
+  }, 50).then(fail, assertIsStubError);
+}
+
+
+function testWaitConditionHasUnhandledPromiseRejection_waitFailureNotCaught() {
+  flow.wait(function() {
+    webdriver.promise.rejected(new StubError);
+  }, 50);
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testWaitConditionHasSubTaskFailure_caughtByWait() {
+  return flow.wait(function() {
+    flow.execute(function() {
+      flow.execute(throwStubError);
+    });
+  }, 50).then(fail, assertIsStubError);
+}
+
+
+function testWaitConditionHasSubTaskFailure_notCaughtByWait() {
+  flow.wait(function() {
+    flow.execute(function() {
+      flow.execute(throwStubError);
+    });
+  }, 50);
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testErrbackMayThrowANewError_startWithNormalPromise() {
+  var error = Error('an error');
+  return webdriver.promise.rejected(error).
+      thenCatch(function(e) {
+        assertEquals(e, error);
+        throw new StubError;
+      }).
+      thenCatch(assertIsStubError);
+}
+
+
+function testErrbackMayThrowANewError_startWithTaskResult() {
+  var error = Error('an error');
+  return flow.execute(function() {
+    throw error;
+  }).
+  thenCatch(function(e) {
+    assertEquals(e, error);
+    throw new StubError;
+  }).
+  thenCatch(assertIsStubError);
+}
+
+
+function testErrbackMayThrowANewError_uncaught_startWithNormalPromise() {
+  var error = Error('an error');
+  webdriver.promise.rejected(error).
+      thenCatch(function(e) {
+        assertEquals(e, error);
+        throw new StubError;
+      });
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testErrbackMayThrowANewError_uncaught_startWithTaskResult() {
+  var error = Error('an error');
+  flow.execute(function() {
+    throw error;
+  }).
+  thenCatch(function(e) {
+    assertEquals(e, error);
+    throw new StubError;
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testThrownPromiseIsHandledSameAsReturningPromise_promiseIsFulfilled() {
+  return webdriver.promise.fulfilled().then(function() {
+    throw webdriver.promise.fulfilled(1234);
+  }).then(function(value) {
+    assertEquals(1234, value);
+  });
+}
+
+
+function testTaskThrowsPromise_promiseWasFulfiled() {
+  var toThrow = webdriver.promise.fulfilled(1234);
+  flow.execute(function() {
+    throw toThrow;
+  }).then(fail, function(value) {
+    assertEquals(toThrow, value);
+    return toThrow;
+  }).then(function(value) {
+    assertEquals(1234, value);
+  });
+  return waitForIdle();
+}
+
+
+function testTaskThrowsPromise_promiseWasRejected() {
+  var toThrow = webdriver.promise.rejected(new StubError);
+  toThrow.thenCatch(goog.nullFunction);  // For tearDown.
+  flow.execute(function() {
+    throw toThrow;
+  }).then(fail, function(e) {
+    assertEquals(toThrow, e);
+    return e;
+  }).then(fail, assertIsStubError);
+  return waitForIdle();
+}
+
+
+function testFailsTaskIfThereIsAnUnhandledErrorWhileWaitingOnTaskResult() {
+  var d = webdriver.promise.defer();
+  flow.execute(function() {
+    webdriver.promise.rejected(new StubError);
+    return d.promise;
+  }).then(fail, assertIsStubError);
+
+  return waitForIdle().then(function() {
+    return d.promise;
+  }).then(fail, function(e) {
+    assertEquals('CancellationError: StubError', e.toString());
+  });
+}
+
+
+function testFailsParentTaskIfAsyncScheduledTaskFails() {
+  var d = webdriver.promise.defer();
+  flow.execute(function() {
+    flow.execute(throwStubError);
+    return d.promise;
+  }).then(fail, assertIsStubError);
+
+  return waitForIdle().then(function() {
+    return d.promise;
+  }).then(fail, function(e) {
+    assertEquals('CancellationError: StubError', e.toString());
+  });
+}
+
+
+function testLongStackTraces_alwaysIncludesTaskStacksInFailures() {
+  if (longStackTracesAreBroken()) {
+    return;
+  }
+
+  webdriver.promise.LONG_STACK_TRACES = false;
+  flow.execute(function() {
+    flow.execute(function() {
+      flow.execute(throwStubError, 'throw error');
+    }, 'two');
+  }, 'three').
+  then(fail, function(e) {
+    assertIsStubError(e);
+    if (!goog.isString(e.stack)) {
+      return;
+    }
+    var messages = goog.array.filter(
+        webdriver.stacktrace.getStack(e).split(/\n/), function(line, index) {
+          return /^From: /.test(line);
+        });
+    assertArrayEquals([
+      'From: Task: throw error',
+      'From: Task: two',
+      'From: Task: three'
+    ], messages);
+  });
+  return waitForIdle();
+}
+
+
+function testLongStackTraces_doesNotIncludeCompletedTasks() {
+  if (longStackTracesAreBroken()) {
+    return;
+  }
+
+  flow.execute(goog.nullFunction, 'succeeds');
+  flow.execute(throwStubError, 'kaboom').then(fail, function(e) {
+    assertIsStubError(e);
+    if (!goog.isString(e.stack)) {
+      return;
+    }
+    var messages = goog.array.filter(
+        webdriver.stacktrace.getStack(e).split(/\n/), function(line, index) {
+          return /^From: /.test(line);
+        });
+    assertArrayEquals(['From: Task: kaboom'], messages);
+  });
+  return waitForIdle();
+}
+
+
+function testLongStackTraces_doesNotIncludePromiseChainWhenDisabled() {
+  if (longStackTracesAreBroken()) {
+    return;
+  }
+
+  webdriver.promise.LONG_STACK_TRACES = false;
+  flow.execute(function() {
+    flow.execute(function() {
+      return webdriver.promise.fulfilled().
+          then(goog.nullFunction).
+          then(goog.nullFunction).
+          then(throwStubError);
+    }, 'eventually fails');
+  }, 'start').
+  then(fail, function(e) {
+    assertIsStubError(e);
+    if (!goog.isString(e.stack)) {
+      return;
+    }
+    var messages = goog.array.filter(
+        webdriver.stacktrace.getStack(e).split(/\n/), function(line, index) {
+          return /^From: /.test(line);
+        });
+    assertArrayEquals([
+      'From: Task: eventually fails',
+      'From: Task: start'
+    ], messages);
+  });
+  return waitForIdle();
+}
+
+
+function testLongStackTraces_includesPromiseChainWhenEnabled() {
+  if (longStackTracesAreBroken()) {
+    return;
+  }
+
+  webdriver.promise.LONG_STACK_TRACES = true;
+  flow.execute(function() {
+    flow.execute(function() {
+      return webdriver.promise.fulfilled().
+          then(goog.nullFunction).
+          then(goog.nullFunction).
+          then(throwStubError);
+    }, 'eventually fails');
+  }, 'start').
+  then(fail, function(e) {
+    assertIsStubError(e);
+    if (!goog.isString(e.stack)) {
+      return;
+    }
+    var messages = goog.array.filter(
+        webdriver.stacktrace.getStack(e).split(/\n/), function(line, index) {
+          return /^From: /.test(line);
+        });
+    assertArrayEquals([
+      'From: Promise: then',
+      'From: Task: eventually fails',
+      'From: Task: start'
+    ], messages);
+  });
+  return waitForIdle();
+}
+
+
+function testFrameCancelsRemainingTasks_onUnhandledTaskFailure() {
+  var run = false;
+  return flow.execute(function() {
+    flow.execute(throwStubError);
+    flow.execute(function() { run = true; });
+  }).then(fail, function(e) {
+    assertIsStubError(e);
+    assertFalse(run);
+  });
+}
+
+
+function testFrameCancelsRemainingTasks_onUnhandledPromiseRejection() {
+  var run = false;
+  return flow.execute(function() {
+    webdriver.promise.rejected(new StubError);
+    flow.execute(function() { run = true; });
+  }).then(fail, function(e) {
+    assertIsStubError(e);
+    assertFalse(run);
+  });
+}
+
+
+function testRegisteredTaskCallbacksAreDroppedWhenTaskIsCancelled_return() {
+  var seen = [];
+  return flow.execute(function() {
+    flow.execute(throwStubError);
+
+    flow.execute(function() {
+      seen.push(1);
+    }).then(function() {
+      seen.push(2);
+    }, function() {
+      seen.push(3);
+    });
+  }).then(fail, function(e) {
+    assertIsStubError(e);
+    assertArrayEquals([], seen);
+  });
+}
+
+
+function testRegisteredTaskCallbacksAreDroppedWhenTaskIsCancelled_withReturn() {
+  var seen = [];
+  return flow.execute(function() {
+    flow.execute(throwStubError);
+
+    return flow.execute(function() {
+      seen.push(1);
+    }).then(function() {
+      seen.push(2);
+    }, function() {
+      seen.push(3);
+    });
+  }).then(fail, function(e) {
+    assertIsStubError(e);
+    assertArrayEquals([], seen);
+  });
+}
+
+
+function testTasksWithinACallbackAreDroppedIfContainingTaskIsAborted() {
+  var seen = [];
+  return flow.execute(function() {
+    flow.execute(throwStubError);
+
+    // None of the callbacks on this promise should execute because the
+    // task failure above is never handled, causing the containing task to
+    // abort.
+    webdriver.promise.fulfilled().then(function() {
+      seen.push(1);
+      return flow.execute(function() {
+        seen.push(2);
+      });
+    }).thenFinally(function() {
+      seen.push(3);
+    });
+
+  }).then(fail, function(e) {
+    assertIsStubError(e);
+    assertArrayEquals([], seen);
+  });
+}
+
+
+function testTaskIsCancelledAfterWaitTimeout() {
+  var seen = [];
+  return flow.execute(function() {
+    flow.wait(function() {
+      return webdriver.promise.delayed(50);
+    }, 5);
+
+    return flow.execute(function() {
+      seen.push(1);
+    }).then(function() {
+      seen.push(2);
+    }, function() {
+      seen.push(3);
+    });
+  }).then(fail, function() {
+    assertArrayEquals([], seen);
+  });
+}
+
+
+function
+testTaskCallbacksGetCancellationErrorIfRegisteredAfterTaskIsCancelled_1() {
+  var task;
+  flow.execute(function() {
+    flow.execute(throwStubError);
+    task = flow.execute(goog.nullFunction);
+  }).then(fail, assertIsStubError);
+  return waitForIdle().then(function() {
+    return task.then(fail, function(e) {
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+    });
+  });
+}
+
+
+function
+testTaskCallbacksGetCancellationErrorIfRegisteredAfterTaskIsCancelled_2() {
+  var seen = [];
+
+  var task;
+  flow.execute(function() {
+    flow.execute(throwStubError);
+    task = flow.execute(goog.nullFunction);
+
+    task.then(() => seen.push(1))
+        .then(() => seen.push(2));
+    task.then(() => seen.push(3))
+        .then(() => seen.push(4));
+
+  }).then(fail, assertIsStubError);
+
+  return waitForIdle().then(function() {
+    return task.then(fail, function(e) {
+      seen.push(5);
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+    });
+  }).then(() => assertArrayEquals([5], seen));
+}
+
+
+function testUnhandledRejectionInParallelTaskQueue() {
+  var seen = [];
+  function schedule(name) {
+    return flow.execute(() => seen.push(name), name);
+  }
+
+  flow.async(function() {
+    schedule('a.1');
+    flow.execute(throwStubError, 'a.2 (throws)');
+  });
+
+  var b3;
+  flow.async(function() {
+    schedule('b.1');
+    schedule('b.2');
+    b3 = schedule('b.3');
+  });
+
+  var c3;
+  flow.async(function() {
+    schedule('c.1');
+    schedule('c.2');
+    c3 = schedule('c.3');
+  });
+
+  function assertWasCancelled(p) {
+    return p.then(fail, function(e) {
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+    });
+  }
+
+  return waitForAbort()
+    .then(function() {
+      assertArrayEquals(['a.1', 'b.1', 'c.1', 'b.2', 'c.2'], seen);
+      assertFalse(b3.isPending());
+      assertFalse(c3.isPending());
+    })
+    .then(() => assertWasCancelled(b3))
+    .then(() => assertWasCancelled(c3));
+}
+
+
+function testErrorsInAsyncFunctionsAreReportedAsUnhandledRejection() {
+  flow.removeAllListeners();  // For tearDown.
+
+  var task;
+  return new Promise(function(fulfill) {
+    flow.once('uncaughtException', fulfill);
+    flow.async(function() {
+      task = flow.execute(function() {});
+      throw Error('boom');
+    });
+  }).then(function(error) {
+    assertTrue(error instanceof webdriver.promise.CancellationError);
+    assertFalse(task.isPending());
+    return task.thenCatch(function(error) {
+      assertTrue(error instanceof webdriver.promise.CancellationError);
+    });
+  });
+}
+
+
+function testDoesNotWaitForValuesThrownFromCallbacksToBeResolved_1() {
+  var p1 = webdriver.promise.fulfilled();
+  var reason = webdriver.promise.fulfilled('should not see me');
+  return p1.then(function() {
+    throw reason;
+  }).then(fail, function(e) {
+    assertEquals(reason, e);
+  });
+}
+
+
+function testDoesNotWaitForValuesThrownFromCallbacksToBeResolved_2() {
+  var p1 = webdriver.promise.fulfilled();
+  var reason = webdriver.promise.rejected('should not see me');
+  reason.thenCatch(goog.nullFunction);  // For tearDown.
+  return p1.then(function() {
+    throw reason;
+  }).then(fail, function(e) {
+    assertEquals(reason, e);
+  });
+}
+
+
+function testDoesNotWaitForValuesThrownFromCallbacksToBeResolved_3() {
+  var p1 = webdriver.promise.fulfilled();
+  var reason = webdriver.promise.defer();
+  setTimeout(() => reason.fulfill('should not see me'), 100);
+  return p1.then(function() {
+    throw reason.promise;
+  }).then(fail, function(e) {
+    assertEquals(reason.promise, e);
+  });
+}
+
+
+function testDoesNotWaitForValuesThrownFromCallbacksToBeResolved_4() {
+  var p1 = webdriver.promise.fulfilled();
+  var reason = {then: function() {}};  // A thenable like object.
+  return p1.then(function() {
+    throw reason;
+  }).then(fail, function(e) {
+    assertEquals(reason, e);
+  });
+}
diff --git a/lib/webdriver/test/promise_flow_test.js b/lib/webdriver/test/promise_flow_test.js
new file mode 100644
index 0000000..cdf39d4
--- /dev/null
+++ b/lib/webdriver/test/promise_flow_test.js
@@ -0,0 +1,2314 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.array');
+goog.require('goog.string');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.promise');
+goog.require('webdriver.stacktrace.Snapshot');
+goog.require('webdriver.stacktrace');
+goog.require('webdriver.test.testutil');
+
+// Aliases for readability.
+var StubError = webdriver.test.testutil.StubError,
+    throwStubError = webdriver.test.testutil.throwStubError,
+    assertIsStubError = webdriver.test.testutil.assertIsStubError,
+    assertingMessages = webdriver.test.testutil.assertingMessages,
+    callbackHelper = webdriver.test.testutil.callbackHelper,
+    callbackPair = webdriver.test.testutil.callbackPair;
+
+var flow, flowHistory, uncaughtExceptions;
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+
+function setUp() {
+  webdriver.promise.LONG_STACK_TRACES = false;
+  flow = new webdriver.promise.ControlFlow();
+  webdriver.promise.setDefaultFlow(flow);
+  webdriver.test.testutil.messages = [];
+  flowHistory = [];
+
+  uncaughtExceptions = [];
+  flow.on(webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,
+          onUncaughtException);
+}
+
+
+function tearDown() {
+  flow.removeAllListeners(
+      webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);
+  assertArrayEquals('There were uncaught exceptions', [], uncaughtExceptions);
+  flow.reset();
+  webdriver.promise.LONG_STACK_TRACES = false;
+}
+
+
+function onUncaughtException(e) {
+  uncaughtExceptions.push(e);
+}
+
+
+function waitForAbort(opt_flow) {
+  var theFlow = opt_flow || flow;
+  theFlow.removeAllListeners(
+      webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);
+  return new goog.Promise(function(fulfill, reject) {
+    theFlow.once(webdriver.promise.ControlFlow.EventType.IDLE, function() {
+      reject(Error('expected flow to report an unhandled error'));
+    });
+    theFlow.once(
+        webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,
+        fulfill);
+  });
+}
+
+
+function waitForIdle(opt_flow) {
+  var theFlow = opt_flow || flow;
+  return new goog.Promise(function(fulfill, reject) {
+    theFlow.once(webdriver.promise.ControlFlow.EventType.IDLE, fulfill);
+    theFlow.once(
+        webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION, reject);
+  });
+}
+
+function timeout(ms) {
+  return new goog.Promise(function(fulfill) {
+    setTimeout(fulfill, ms);
+  });
+}
+
+
+function schedule(msg, opt_return) {
+  return scheduleAction(msg, function() {
+    return opt_return;
+  });
+}
+
+/**
+ * @param {string} value The value to push.
+ * @param {webdriver.promise.Promise=} opt_taskPromise Promise to return from
+ *     the task.
+ * @return {!webdriver.promise.Promise} The result.
+ */
+function schedulePush(value, opt_taskPromise) {
+  return scheduleAction(value, function() {
+    webdriver.test.testutil.messages.push(value);
+    return opt_taskPromise;
+  });
+}
+
+/**
+ * @param {string} msg Debug message.
+ * @param {!Function} actionFn The function.
+ * @return {!webdriver.promise.Promise} The function result.
+ */
+function scheduleAction(msg, actionFn) {
+  return webdriver.promise.controlFlow().execute(function() {
+    flowHistory.push(msg);
+    return actionFn();
+  }, msg);
+}
+
+/**
+ * @param {!Function} condition The condition function.
+ * @param {number=} opt_timeout The timeout.
+ * @param {string=} opt_message Optional message.
+ * @return {!webdriver.promise.Promise} The wait result.
+ */
+function scheduleWait(condition, opt_timeout, opt_message) {
+  var msg = opt_message || '';
+  // It's not possible to hook into when the wait itself is scheduled, so
+  // we record each iteration of the wait loop.
+  var count = 0;
+  return webdriver.promise.controlFlow().wait(function() {
+    flowHistory.push((count++) + ': ' + msg);
+    return condition();
+  }, opt_timeout, msg);
+}
+
+
+function assertFlowHistory(var_args) {
+  var expected = goog.array.slice(arguments, 0);
+  assertArrayEquals(expected, flowHistory);
+}
+
+
+function testScheduling_aSimpleFunction() {
+  schedule('go');
+  return waitForIdle().then(function() {
+    assertFlowHistory('go');
+  });
+}
+
+
+function testScheduling_aSimpleFunctionWithANonPromiseReturnValue() {
+  schedule('go', 123).then(function(value) {
+    assertEquals(123, value);
+  });
+  return waitForIdle().then(function() {
+    assertFlowHistory('go');
+  });
+}
+
+
+function testScheduling_aSimpleSequence() {
+  schedule('a');
+  schedule('b');
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testScheduling_invokesCallbacksWhenTaskIsDone() {
+  var d = new webdriver.promise.Deferred();
+  var called = false;
+  var done = schedule('a', d.promise).then(function(value) {
+    called = true;
+    assertEquals(123, value);
+  });
+  return timeout(5).then(function() {
+    assertFalse(called);
+    d.fulfill(123);
+    return done;
+  }).
+  then(waitForIdle).
+  then(function() {
+    assertFlowHistory('a');
+  });
+}
+
+
+function testScheduling_blocksUntilPromiseReturnedByTaskIsResolved() {
+  var done = webdriver.promise.defer();
+  schedulePush('a', done.promise);
+  schedulePush('b');
+  setTimeout(function() {
+    done.fulfill();
+    webdriver.test.testutil.messages.push('c');
+  }, 25);
+  return waitForIdle().then(assertingMessages('a', 'c', 'b'));
+}
+
+
+function testScheduling_waitsForReturnedPromisesToResolve() {
+  var d1 = new webdriver.promise.Deferred();
+  var d2 = new webdriver.promise.Deferred();
+
+  var callback;
+  schedule('a', d1.promise).then(callback = callbackHelper(function(value) {
+    assertEquals('fluffy bunny', value);
+  }));
+
+  return timeout(5).then(function() {
+    callback.assertNotCalled('d1 not resolved yet');
+    d1.fulfill(d2);
+    return timeout(5);
+  }).then(function() {
+    callback.assertNotCalled('d2 not resolved yet');
+    d2.fulfill('fluffy bunny');
+    return waitForIdle();
+  }).then(function() {
+    callback.assertCalled('d2 has been resolved');
+    assertFlowHistory('a');
+  });
+}
+
+
+function testScheduling_executesTasksInAFutureTurnAfterTheyAreScheduled() {
+  var count = 0;
+  function incr() { count++; }
+
+  scheduleAction('', incr);
+  assertEquals(0, count);
+  return waitForIdle().then(function() {
+    assertEquals(1, count);
+  });
+}
+
+
+function testScheduling_executesOneTaskPerTurnOfTheEventLoop() {
+  var order = [];
+  function go() {
+    order.push(order.length / 2);
+    goog.async.run(function() {
+      order.push('-');
+    });
+  }
+
+  scheduleAction('', go);
+  scheduleAction('', go);
+  return waitForIdle().then(function() {
+    assertArrayEquals([0, '-', 1, '-'], order);
+  })
+}
+
+
+function testScheduling_firstScheduledTaskIsWithinACallback() {
+  webdriver.promise.fulfilled().then(function() {
+    schedule('a');
+    schedule('b');
+    schedule('c');
+  }).then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+  return waitForIdle();
+}
+
+
+function testScheduling_newTasksAddedWhileWaitingOnTaskReturnedPromise1() {
+  scheduleAction('a', function() {
+    var d = webdriver.promise.defer();
+    setTimeout(function() {
+      schedule('c');
+      d.fulfill();
+    }, 10);
+    return d.promise;
+  });
+  schedule('b');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testScheduling_newTasksAddedWhileWaitingOnTaskReturnedPromise2() {
+  scheduleAction('a', function() {
+    var d = webdriver.promise.defer();
+    setTimeout(function() {
+      schedule('c');
+      goog.async.run(d.fulfill);
+    }, 10);
+    return d.promise;
+  });
+  schedule('b');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'c', 'b');
+  });
+}
+
+
+function testFraming_callbacksRunInANewFrame() {
+  schedule('a').then(function() {
+    schedule('c');
+  });
+  schedule('b');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'c', 'b');
+  });
+}
+
+
+function testFraming_lotsOfNesting() {
+  schedule('a').then(function() {
+    schedule('c').then(function() {
+      schedule('e').then(function() {
+        schedule('g');
+      });
+      schedule('f');
+    });
+    schedule('d');
+  });
+  schedule('b');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'c', 'e', 'g', 'f', 'd', 'b');
+  });
+}
+
+
+function testFrame_callbackReturnsPromiseThatDependsOnATask_1() {
+  schedule('a').then(function() {
+    schedule('b');
+    return webdriver.promise.delayed(5).then(function() {
+      return schedule('c');
+    });
+  });
+  schedule('d');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd');
+  });
+}
+
+
+function testFrame_callbackReturnsPromiseThatDependsOnATask_2() {
+  schedule('a').then(function() {
+    schedule('b');
+    return webdriver.promise.delayed(5).
+        then(function() { return webdriver.promise.delayed(5) }).
+        then(function() { return webdriver.promise.delayed(5) }).
+        then(function() { return webdriver.promise.delayed(5) }).
+        then(function() { return schedule('c'); });
+  });
+  schedule('d');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd');
+  });
+}
+
+
+function testFraming_eachCallbackWaitsForAllScheduledTasksToComplete() {
+  schedule('a').
+      then(function() {
+        schedule('b');
+        schedule('c');
+      }).
+      then(function() {
+        schedule('d');
+      });
+  schedule('e');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd', 'e');
+  });
+}
+
+
+function testFraming_eachCallbackWaitsForReturnTasksToComplete() {
+  schedule('a').
+      then(function() {
+        schedule('b');
+        return schedule('c');
+      }).
+      then(function() {
+        schedule('d');
+      });
+  schedule('e');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd', 'e');
+  });
+}
+
+
+function testFraming_callbacksOnAResolvedPromiseInsertIntoTheCurrentFlow() {
+  webdriver.promise.fulfilled().then(function() {
+    schedule('b');
+  });
+  schedule('a');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('b', 'a');
+  });
+}
+
+
+function testFraming_callbacksInterruptTheFlowWhenPromiseIsResolved() {
+  schedule('a').then(function() {
+    schedule('c');
+  });
+  schedule('b');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'c', 'b');
+  });
+}
+
+
+function testFraming_allCallbacksInAFrameAreScheduledWhenPromiseIsResolved() {
+  var a = schedule('a');
+  a.then(function() { schedule('b'); });
+  schedule('c');
+  a.then(function() { schedule('d'); });
+  schedule('e');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'd', 'c', 'e');
+  });
+}
+
+
+function testFraming_tasksScheduledInInActiveFrameDoNotGetPrecedence() {
+  var d = webdriver.promise.fulfilled();
+  schedule('a');
+  schedule('b');
+  d.then(function() { schedule('c'); });
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testFraming_tasksScheduledInAFrameGetPrecedence_1() {
+  var a = schedule('a');
+  schedule('b').then(function() {
+    a.then(function() {
+      schedule('c');
+      schedule('d');
+    });
+    var e = schedule('e');
+    a.then(function() {
+      schedule('f');
+      e.then(function() {
+        schedule('g');
+      });
+      schedule('h');
+    });
+    schedule('i');
+  });
+  schedule('j');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j');
+  });
+}
+
+
+function testErrorHandling_thrownErrorsArePassedToTaskErrback() {
+  scheduleAction('function that throws', throwStubError).
+      then(fail, assertIsStubError);
+  return waitForIdle();
+}
+
+
+function testErrorHandling_thrownErrorsPropagateThroughPromiseChain() {
+  scheduleAction('function that throws', throwStubError).
+      then(fail).
+      then(fail, assertIsStubError);
+  return waitForIdle();
+}
+
+
+function testErrorHandling_catchesErrorsFromFailedTasksInAFrame() {
+  schedule('a').then(function() {
+    schedule('b');
+    scheduleAction('function that throws', throwStubError);
+  }).
+  then(fail, assertIsStubError);
+  return waitForIdle();
+}
+
+
+function testErrorHandling_abortsIfOnlyTaskReturnsAnUnhandledRejection() {
+  scheduleAction('function that returns rejected promise', function() {
+    return webdriver.promise.rejected(new StubError);
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testErrorHandling_abortsIfThereIsAnUnhandledRejection() {
+  webdriver.promise.rejected(new StubError);
+  schedule('this should not run');
+  return waitForAbort().
+      then(assertIsStubError).
+      then(function() {
+        assertFlowHistory(/* none */);
+      });
+}
+
+
+function testErrorHandling_abortsSequenceIfATaskFails() {
+  schedule('a');
+  schedule('b');
+  scheduleAction('c', throwStubError);
+  schedule('d');  // Should never execute.
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(function() {
+        assertFlowHistory('a', 'b', 'c');
+      });
+}
+
+
+function testErrorHandling_abortsFromUnhandledFramedTaskFailures_1() {
+  schedule('outer task').then(function() {
+    scheduleAction('inner task', throwStubError);
+  });
+  schedule('this should not run');
+  return waitForAbort().
+      then(assertIsStubError).
+      then(function() {
+        assertFlowHistory('outer task', 'inner task');
+      });
+}
+
+
+function testErrorHandling_abortsFromUnhandledFramedTaskFailures_2() {
+  schedule('a').then(function() {
+    schedule('b').then(function() {
+      scheduleAction('c', throwStubError);
+      // This should not execute.
+      schedule('d');
+    });
+  });
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(function() {
+        assertFlowHistory('a', 'b', 'c');
+      });
+}
+
+
+function testErrorHandling_abortsWhenErrorBubblesUpFromFullyResolvingAnObject() {
+  var callback = callbackHelper(function() {
+    return webdriver.promise.rejected('rejected 2');
+  });
+
+  scheduleAction('', function() {
+    var obj = {'foo': webdriver.promise.rejected(new StubError)};
+    return webdriver.promise.fullyResolved(obj).then(callback);
+  });
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(callback.assertNotCalled);
+}
+
+
+function testErrorHandling_abortsWhenErrorBubblesUpFromFullyResolvingAnObject_withCallback() {
+  var callback1 = callbackHelper(function() {
+    return webdriver.promise.rejected('rejected 2');
+  });
+  var callback2 = callbackHelper();
+
+  scheduleAction('', function() {
+    var obj = {'foo': webdriver.promise.rejected(new StubError)};
+    return webdriver.promise.fullyResolved(obj).then(callback1);
+  }).then(callback2);
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(callback1.assertNotCalled).
+      then(callback2.assertNotCalled);
+}
+
+
+function testErrorHandling_canCatchErrorsFromNestedTasks() {
+  var errback;
+  schedule('a').
+      then(function() {
+        return scheduleAction('b', throwStubError);
+      }).
+      thenCatch(errback = callbackHelper(assertIsStubError));
+  return waitForIdle().then(errback.assertCalled);
+}
+
+
+function testErrorHandling_nestedCommandFailuresCanBeCaughtAndSuppressed() {
+  var errback;
+  schedule('a').then(function() {
+    return schedule('b').then(function() {
+      return schedule('c').then(function() {
+        throw new StubError;
+      });
+    });
+  }).thenCatch(errback = callbackHelper(assertIsStubError));
+  schedule('d');
+  return waitForIdle().
+      then(errback.assertCalled).
+      then(function() {
+        assertFlowHistory('a', 'b', 'c', 'd');
+      });
+}
+
+
+function testErrorHandling_aTaskWithAnUnhandledPromiseRejection() {
+  schedule('a');
+  scheduleAction('sub-tasks', function() {
+    webdriver.promise.rejected(new StubError);
+  });
+  schedule('should never run');
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(function() {
+        assertFlowHistory('a', 'sub-tasks');
+      });
+}
+
+function testErrorHandling_aTaskThatReutrnsARejectedPromise() {
+  schedule('a');
+  scheduleAction('sub-tasks', function() {
+    return webdriver.promise.rejected(new StubError);
+  });
+  schedule('should never run');
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(function() {
+        assertFlowHistory('a', 'sub-tasks');
+      });
+}
+
+
+function testErrorHandling_discardsSubtasksIfTaskThrows() {
+  var pair = callbackPair(null, assertIsStubError);
+  scheduleAction('a', function() {
+    schedule('b');
+    schedule('c');
+    throwStubError();
+  }).then(pair.callback, pair.errback);
+  schedule('d');
+
+  return waitForIdle().
+      then(pair.assertErrback).
+      then(function() {
+        assertFlowHistory('a', 'd');
+      });
+}
+
+
+function testErrorHandling_discardsRemainingSubtasksIfASubtaskFails() {
+  var pair = callbackPair(null, assertIsStubError);
+  scheduleAction('a', function() {
+    schedule('b');
+    scheduleAction('c', throwStubError);
+    schedule('d');
+  }).then(pair.callback, pair.errback);
+  schedule('e');
+
+  return waitForIdle().
+      then(pair.assertErrback).
+      then(function() {
+        assertFlowHistory('a', 'b', 'c', 'e');
+      });
+}
+
+
+function testTryFinally_happyPath() {
+  /* Model:
+     try {
+       doFoo();
+       doBar();
+     } finally {
+       doBaz();
+     }
+   */
+  schedulePush('foo').
+      then(goog.partial(schedulePush, 'bar')).
+      thenFinally(goog.partial(schedulePush, 'baz'));
+  return waitForIdle().then(assertingMessages('foo', 'bar', 'baz'));
+}
+
+
+function testTryFinally_firstTryFails() {
+  /* Model:
+     try {
+       doFoo();
+       doBar();
+     } finally {
+       doBaz();
+     }
+   */
+
+  scheduleAction('doFoo and throw', function() {
+    webdriver.test.testutil.messages.push('foo');
+    throw new StubError;
+  }).
+  then(function() { schedulePush('bar'); }).
+  thenFinally(function() { schedulePush('baz'); });
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(assertingMessages('foo', 'baz'));
+}
+
+
+function testTryFinally_secondTryFails() {
+  /* Model:
+     try {
+       doFoo();
+       doBar();
+     } finally {
+       doBaz();
+     }
+   */
+
+  schedulePush('foo').
+      then(function() {
+        return scheduleAction('doBar and throw', function() {
+          webdriver.test.testutil.messages.push('bar');
+          throw new StubError;
+        });
+      }).
+      thenFinally(function() {
+        return schedulePush('baz');
+      });
+  return waitForAbort().
+      then(assertIsStubError).
+      then(assertingMessages('foo', 'bar', 'baz'));
+}
+
+
+function testTaskCallbacksInterruptFlow() {
+  schedule('a').then(function() {
+    schedule('b');
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function
+testTaskCallbacksInterruptFlow_taskDependsOnImmediatelyFulfilledPromise() {
+  scheduleAction('a', function() {
+    return webdriver.promise.fulfilled();
+  }).then(function() {
+    schedule('b');
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testTaskCallbacksInterruptFlow_taskDependsOnPreviouslyFulfilledPromise() {
+  var promise = webdriver.promise.fulfilled(123);
+  scheduleAction('a', function() {
+    return promise;
+  }).then(function(value) {
+    assertEquals(123, value);
+    schedule('b');
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testTaskCallbacksInterruptFlow_taskDependsOnAsyncPromise() {
+  scheduleAction('a', function() {
+    return webdriver.promise.delayed(25);
+  }).then(function() {
+    schedule('b');
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testPromiseChainedToTaskInterruptFlow() {
+  schedule('a').then(function() {
+    return webdriver.promise.fulfilled();
+  }).then(function() {
+    return webdriver.promise.fulfilled();
+  }).then(function() {
+    schedule('b');
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testNestedTaskCallbacksInterruptFlowWhenResolved() {
+  schedule('a').then(function() {
+    schedule('b').then(function() {
+      schedule('c');
+    });
+  });
+  schedule('d');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd');
+  });
+}
+
+
+function testDelayedNesting_1() {
+  var a = schedule('a');
+  schedule('b').then(function() {
+    a.then(function() { schedule('c'); });
+    schedule('d');
+  });
+  schedule('e');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd', 'e');
+  });
+}
+
+
+function testDelayedNesting_2() {
+  var a = schedule('a');
+  schedule('b').then(function() {
+    a.then(function() { schedule('c'); });
+    schedule('d');
+    a.then(function() { schedule('e'); });
+  });
+  schedule('f');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd', 'e', 'f');
+  });
+}
+
+
+function testDelayedNesting_3() {
+  var a = schedule('a');
+  schedule('b').then(function() {
+    a.then(function() { schedule('c'); });
+    a.then(function() { schedule('d'); });
+  });
+  schedule('e');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd', 'e');
+  });
+}
+
+
+function testDelayedNesting_4() {
+  var a = schedule('a');
+  schedule('b').then(function() {
+    a.then(function() { schedule('c'); }).then(function() {
+      schedule('d');
+    });
+    a.then(function() { schedule('e'); });
+  });
+  schedule('f');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd', 'e', 'f');
+  });
+}
+
+
+function testDelayedNesting_5() {
+  var a = schedule('a');
+  schedule('b').then(function() {
+    var c;
+    a.then(function() { c = schedule('c'); }).then(function() {
+      schedule('d');
+      a.then(function() { schedule('e'); });
+      c.then(function() { schedule('f'); });
+      schedule('g');
+    });
+    a.then(function() { schedule('h'); });
+  });
+  schedule('i');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i');
+  });
+}
+
+
+function testWaiting_onAConditionThatIsAlwaysTrue() {
+  scheduleWait(function() { return true;}, 0, 'waiting on true');
+  return waitForIdle().then(function() {
+    assertFlowHistory('0: waiting on true');
+  });
+}
+
+
+function testWaiting_aSimpleCountingCondition() {
+  var count = 0;
+  scheduleWait(function() {
+    return ++count == 3;
+  }, 100, 'counting to 3');
+
+  return waitForIdle().then(function() {
+    assertEquals(3, count);
+  });
+}
+
+
+function testWaiting_aConditionThatReturnsAPromise() {
+  var d = new webdriver.promise.Deferred();
+  var count = 0;
+
+  scheduleWait(function() {
+    count += 1;
+    return d.promise;
+  }, 0, 'waiting for promise');
+
+  return timeout(50).then(function() {
+    assertEquals(1, count);
+    d.fulfill(123);
+    return waitForIdle();
+  });
+}
+
+
+function testWaiting_aConditionThatReturnsAPromise_2() {
+  var count = 0;
+  scheduleWait(function() {
+    return webdriver.promise.fulfilled(++count == 3);
+  }, 100, 'waiting for promise');
+
+  return waitForIdle().then(function() {
+    assertEquals(3, count);
+  });
+}
+
+
+function testWaiting_aConditionThatReturnsATaskResult() {
+  var count = 0;
+  scheduleWait(function() {
+    return scheduleAction('increment count', function() {
+      return ++count == 3;
+    });
+  }, 100, 'counting to 3');
+  schedule('post wait');
+
+  return waitForIdle().then(function() {
+    assertEquals(3, count);
+    assertFlowHistory(
+        '0: counting to 3', 'increment count',
+        '1: counting to 3', 'increment count',
+        '2: counting to 3', 'increment count',
+        'post wait');
+  });
+}
+
+
+function testWaiting_conditionContainsASubtask() {
+  var count = 0;
+  scheduleWait(function() {
+    schedule('sub task');
+    return ++count == 3;
+  }, 100, 'counting to 3');
+  schedule('post wait');
+
+  return waitForIdle().then(function() {
+    assertEquals(3, count);
+    assertFlowHistory(
+        '0: counting to 3', 'sub task',
+        '1: counting to 3', 'sub task',
+        '2: counting to 3', 'sub task',
+        'post wait');
+  });
+}
+
+
+function testWaiting_cancelsWaitIfScheduledTaskFails() {
+  var pair = callbackPair(null, assertIsStubError);
+  scheduleWait(function() {
+    scheduleAction('boom', throwStubError);
+    schedule('this should not run');
+    return true;
+  }, 100, 'waiting to go boom').then(pair.callback, pair.errback);
+  schedule('post wait');
+
+  return waitForIdle().
+      then(pair.assertErrback).
+      then(function() {
+        assertFlowHistory(
+            '0: waiting to go boom', 'boom',
+            'post wait');
+      });
+}
+
+
+function testWaiting_failsIfConditionThrows() {
+  var callbacks = callbackPair(null, assertIsStubError);
+  scheduleWait(throwStubError, 0, 'goes boom').
+      then(callbacks.callback, callbacks.errback);
+  schedule('post wait');
+
+  return waitForIdle().
+      then(callbacks.assertErrback).
+      then(function() {
+        assertFlowHistory('0: goes boom', 'post wait');
+      });
+}
+
+
+function testWaiting_failsIfConditionReturnsARejectedPromise() {
+  var callbacks = callbackPair(null, assertIsStubError);
+  scheduleWait(function() {
+    return webdriver.promise.rejected(new StubError);
+  }, 0, 'goes boom').then(callbacks.callback, callbacks.errback);
+  schedule('post wait');
+
+  return waitForIdle().
+      then(callbacks.assertErrback).
+      then(function() {
+        assertFlowHistory('0: goes boom', 'post wait');
+      });
+}
+
+
+function testWaiting_failsIfConditionHasUnhandledRejection() {
+  var callbacks = callbackPair(null, assertIsStubError);
+  scheduleWait(function() {
+    webdriver.promise.controlFlow().execute(throwStubError);
+  }, 0, 'goes boom').then(callbacks.callback, callbacks.errback);
+  schedule('post wait');
+
+  return waitForIdle().
+      then(callbacks.assertErrback).
+      then(function() {
+        assertFlowHistory('0: goes boom', 'post wait');
+      });
+}
+
+
+function testWaiting_failsIfConditionHasAFailedSubtask() {
+  var callbacks = callbackPair(null, assertIsStubError);
+  var count = 0;
+  scheduleWait(function() {
+    scheduleAction('maybe throw', function() {
+      if (++count == 2) {
+        throw new StubError;
+      }
+    });
+  }, 100, 'waiting').then(callbacks.callback, callbacks.errback);
+  schedule('post wait');
+
+  return waitForIdle().then(function() {
+    assertEquals(2, count);
+    assertFlowHistory(
+        '0: waiting', 'maybe throw',
+        '1: waiting', 'maybe throw',
+        'post wait');
+  });
+}
+
+
+function testWaiting_pollingLoopWaitsForAllScheduledTasksInCondition() {
+  var count = 0;
+  scheduleWait(function() {
+    scheduleAction('increment count', function() { ++count; });
+    return count >= 3;
+  }, 100, 'counting to 3');
+  schedule('post wait');
+
+  return waitForIdle().then(function() {
+    assertEquals(4, count);
+    assertFlowHistory(
+        '0: counting to 3', 'increment count',
+        '1: counting to 3', 'increment count',
+        '2: counting to 3', 'increment count',
+        '3: counting to 3', 'increment count',
+        'post wait');
+  });
+}
+
+
+function testWaiting_waitsForeverOnAZeroTimeout() {
+  var done = false;
+  setTimeout(function() {
+    done = true;
+  }, 150);
+  var waitResult = scheduleWait(function() {
+    return done;
+  }, 0);
+
+  return timeout(75).then(function() {
+    assertFalse(done);
+    return timeout(100);
+  }).then(function() {
+    assertTrue(done);
+    return waitResult;
+  });
+}
+
+
+function testWaiting_waitsForeverIfTimeoutOmitted() {
+  var done = false;
+  setTimeout(function() {
+    done = true;
+  }, 150);
+  var waitResult = scheduleWait(function() {
+    return done;
+  });
+
+  return timeout(75).then(function() {
+    assertFalse(done);
+    return timeout(100);
+  }).then(function() {
+    assertTrue(done);
+    return waitResult;
+  });
+}
+
+
+function testWaiting_timesOut_nonZeroTimeout() {
+  var count = 0;
+  scheduleWait(function() {
+    count += 1;
+    var ms = count === 2 ? 65 : 5;
+    return webdriver.promise.delayed(ms).then(function() {
+      return false;
+    });
+  }, 60, 'counting to 3');
+  return waitForAbort().then(function(e) {
+    switch (count) {
+      case 1:
+        assertFlowHistory('0: counting to 3');
+        break;
+      case 2:
+        assertFlowHistory('0: counting to 3', '1: counting to 3');
+        break;
+      default:
+        fail('unexpected polling count: ' + count);
+    }
+    assertRegExp(/^counting to 3\nWait timed out after \d+ms$/, e.message);
+  });
+}
+
+
+function testWaiting_shouldFailIfConditionReturnsARejectedPromise() {
+  scheduleWait(function() {
+    return webdriver.promise.rejected(new StubError);
+  }, 100, 'returns rejected promise on first pass');
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testWaiting_scheduleWithIntermittentWaits() {
+  schedule('a');
+  scheduleWait(function() { return true; }, 0, 'wait 1');
+  schedule('b');
+  scheduleWait(function() { return true; }, 0, 'wait 2');
+  schedule('c');
+  scheduleWait(function() { return true; }, 0, 'wait 3');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', '0: wait 1', 'b', '0: wait 2', 'c', '0: wait 3');
+  });
+}
+
+
+function testWaiting_scheduleWithIntermittentAndNestedWaits() {
+  schedule('a');
+  scheduleWait(function() { return true; }, 0, 'wait 1').
+      then(function() {
+        schedule('d');
+        scheduleWait(function() { return true; }, 0, 'wait 2');
+        schedule('e');
+      });
+  schedule('b');
+  scheduleWait(function() { return true; }, 0, 'wait 3');
+  schedule('c');
+  scheduleWait(function() { return true; }, 0, 'wait 4');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory(
+        'a', '0: wait 1', 'd', '0: wait 2', 'e', 'b', '0: wait 3', 'c',
+        '0: wait 4');
+  });
+}
+
+
+function testWait_requiresConditionToBeAPromiseOrFunction() {
+  assertThrows(function() {
+    flow.wait(1234, 0);
+  });
+  flow.wait(function() { return true;}, 0);
+  flow.wait(webdriver.promise.fulfilled(), 0);
+  return waitForIdle();
+}
+
+
+function testWait_promiseThatDoesNotResolveBeforeTimeout() {
+  var d = webdriver.promise.defer();
+  flow.wait(d.promise, 5).then(fail, function(e) {
+    assertRegExp(/Timed out waiting for promise to resolve after \d+ms/,
+        e.message);
+  });
+  return waitForIdle().then(function() {
+    assertTrue('Promise should not be cancelled', d.promise.isPending());
+  });
+}
+
+
+function testWait_unboundedWaitOnPromiseResolution() {
+  var messages = [];
+  var d = webdriver.promise.defer();
+  var waitResult = flow.wait(d.promise).then(function(value) {
+    messages.push('b');
+    assertEquals(1234, value);
+  });
+  setTimeout(function() {
+    messages.push('a');
+  }, 5);
+
+  webdriver.promise.delayed(10).then(function() {
+    assertArrayEquals(['a'], messages);
+    assertTrue(waitResult.isPending());
+    d.fulfill(1234);
+    return waitResult;
+  }).then(function() {
+    assertArrayEquals(['a', 'b'], messages);
+  });
+
+  return waitForIdle();
+}
+
+
+function testSubtasks() {
+  schedule('a');
+  scheduleAction('sub-tasks', function() {
+    schedule('c');
+    schedule('d');
+  });
+  schedule('b');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'sub-tasks', 'c', 'd', 'b');
+  });
+}
+
+
+function testSubtasks_nesting() {
+  schedule('a');
+  scheduleAction('sub-tasks', function() {
+    schedule('b');
+    scheduleAction('sub-sub-tasks', function() {
+      schedule('c');
+      schedule('d');
+    });
+    schedule('e');
+  });
+  schedule('f');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory(
+        'a', 'sub-tasks', 'b', 'sub-sub-tasks', 'c', 'd', 'e', 'f');
+  });
+}
+
+
+function testSubtasks_taskReturnsSubTaskResult_1() {
+  schedule('a');
+  scheduleAction('sub-tasks', function() {
+    return schedule('c');
+  });
+  schedule('b');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'sub-tasks', 'c', 'b');
+  });
+}
+
+
+function testSubtasks_taskReturnsSubTaskResult_2() {
+  var callback;
+  schedule('a');
+  schedule('sub-tasks', webdriver.promise.fulfilled(123)).
+      then(callback = callbackHelper(function(value) {
+        assertEquals(123, value);
+      }));
+  schedule('b');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'sub-tasks','b');
+    callback.assertCalled();
+  });
+}
+
+
+function testSubtasks_taskReturnsPromiseThatDependsOnSubtask_1() {
+  scheduleAction('a', function() {
+    return webdriver.promise.delayed(10).then(function() {
+      schedule('b');
+    });
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testSubtasks_taskReturnsPromiseThatDependsOnSubtask_2() {
+  scheduleAction('a', function() {
+    return webdriver.promise.fulfilled().then(function() {
+      schedule('b');
+    });
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testSubtasks_taskReturnsPromiseThatDependsOnSubtask_3() {
+  scheduleAction('a', function() {
+    return webdriver.promise.delayed(10).then(function() {
+      return schedule('b');
+    });
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testSubtasks_taskReturnsPromiseThatDependsOnSubtask_4() {
+  scheduleAction('a', function() {
+    return webdriver.promise.delayed(5).then(function() {
+      return webdriver.promise.delayed(5).then(function() {
+        return schedule('b');
+      });
+    });
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testSubtasks_taskReturnsPromiseThatDependsOnSubtask_5() {
+  scheduleAction('a', function() {
+    return webdriver.promise.delayed(5).then(function() {
+      return webdriver.promise.delayed(5).then(function() {
+        return webdriver.promise.delayed(5).then(function() {
+          return webdriver.promise.delayed(5).then(function() {
+            return schedule('b');
+          });
+        });
+      });
+    });
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+
+function testSubtasks_taskReturnsPromiseThatDependsOnSubtask_6() {
+  scheduleAction('a', function() {
+    return webdriver.promise.delayed(5).
+        then(function() { return webdriver.promise.delayed(5) }).
+        then(function() { return webdriver.promise.delayed(5) }).
+        then(function() { return webdriver.promise.delayed(5) }).
+        then(function() { return schedule('b'); });
+  });
+  schedule('c');
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'b', 'c');
+  });
+}
+
+function testSubtasks_subTaskFails_1() {
+  schedule('a');
+  scheduleAction('sub-tasks', function() {
+    scheduleAction('sub-task that fails', throwStubError);
+  });
+  schedule('should never execute');
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(function() {
+        assertFlowHistory('a', 'sub-tasks', 'sub-task that fails');
+      });
+}
+
+
+function testSubtasks_subTaskFails_2() {
+  schedule('a');
+  scheduleAction('sub-tasks', function() {
+    return webdriver.promise.rejected(new StubError);
+  });
+  schedule('should never execute');
+
+  return waitForAbort().
+      then(assertIsStubError).
+      then(function() {
+        assertFlowHistory('a', 'sub-tasks');
+      });
+}
+
+
+function testSubtasks_subTaskFails_3() {
+  var callbacks = callbackPair(null, assertIsStubError);
+
+  schedule('a');
+  scheduleAction('sub-tasks', function() {
+    return webdriver.promise.rejected(new StubError);
+  }).then(callbacks.callback, callbacks.errback);
+  schedule('b');
+
+  return waitForIdle().
+      then(function() {
+        assertFlowHistory('a', 'sub-tasks', 'b');
+        callbacks.assertErrback();
+      });
+}
+
+
+function testEventLoopWaitsOnPendingPromiseRejections_oneRejection() {
+  var d = new webdriver.promise.Deferred;
+  scheduleAction('one', function() {
+    return d.promise;
+  });
+  scheduleAction('two', goog.nullFunction);
+
+  return timeout(50).then(function() {
+    assertFlowHistory('one');
+    d.reject(new StubError);
+    return waitForAbort();
+  }).
+  then(assertIsStubError).
+  then(function() {
+    assertFlowHistory('one');
+  });
+}
+
+
+function testEventLoopWaitsOnPendingPromiseRejections_multipleRejections() {
+  var once = Error('once');
+  var twice = Error('twice');
+
+  scheduleAction('one', function() {
+    webdriver.promise.rejected(once);
+    webdriver.promise.rejected(twice);
+  });
+  var twoResult = scheduleAction('two', goog.nullFunction);
+
+  flow.removeAllListeners(
+      webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);
+  return new goog.Promise(function(fulfill, reject) {
+    setTimeout(function() {
+      reject(Error('Should have reported the two errors by now'));
+    }, 50);
+    flow.on(
+        webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,
+        fulfill);
+  }).then(function(e) {
+    assertTrue(e instanceof webdriver.promise.MultipleUnhandledRejectionError);
+    // TODO: switch to Array.from when we drop node 0.12.x
+    var errors = [];
+    for (var e2 of e.errors) {
+      errors.push(e2);
+    }
+    assertArrayEquals([once, twice], errors);
+    assertFlowHistory('one');
+    assertFalse('Did not cancel the second task', twoResult.isPending());
+  });
+}
+
+function testCancelsPromiseReturnedByCallbackIfFrameFails_promiseCallback() {
+  var chainPair = callbackPair(null, assertIsStubError);
+  var deferredPair = callbackPair(null, function(e) {
+    assertEquals('callback result should be cancelled',
+        'CancellationError: StubError',
+        e.toString());
+  });
+
+  var d = new webdriver.promise.Deferred();
+  d.then(deferredPair.callback, deferredPair.errback);
+
+  webdriver.promise.fulfilled().
+      then(function() {
+        scheduleAction('boom', throwStubError);
+        schedule('this should not run');
+        return d.promise;
+      }).
+      then(chainPair.callback, chainPair.errback);
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('boom');
+    chainPair.assertErrback('chain errback not invoked');
+    deferredPair.assertErrback('deferred errback not invoked');
+  });
+}
+
+function testCancelsPromiseReturnedByCallbackIfFrameFails_taskCallback() {
+  var chainPair = callbackPair(null, assertIsStubError);
+  var deferredPair = callbackPair(null, function(e) {
+    assertEquals('callback result should be cancelled',
+        'CancellationError: StubError',
+        e.toString());
+  });
+
+  var d = new webdriver.promise.Deferred();
+  d.then(deferredPair.callback, deferredPair.errback);
+
+  schedule('a').
+      then(function() {
+        scheduleAction('boom', throwStubError);
+        schedule('this should not run');
+        return d.promise;
+      }).
+      then(chainPair.callback, chainPair.errback);
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'boom');
+    chainPair.assertErrback('chain errback not invoked');
+    deferredPair.assertErrback('deferred errback not invoked');
+  });
+}
+
+function testMaintainsOrderInCallbacksWhenATaskReturnsAPromise() {
+  schedule('__start__', webdriver.promise.fulfilled()).
+      then(function() {
+        webdriver.test.testutil.messages.push('a');
+        schedulePush('b');
+        webdriver.test.testutil.messages.push('c');
+      }).
+      then(function() {
+        webdriver.test.testutil.messages.push('d');
+      });
+  schedulePush('e');
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('__start__', 'b', 'e');
+    webdriver.test.testutil.assertMessages('a', 'c', 'b', 'd', 'e');
+  });
+}
+
+
+function assertFlowIs(flow) {
+  assertEquals(flow, webdriver.promise.controlFlow());
+}
+
+function testOwningFlowIsActivatedForExecutingTasks() {
+  var defaultFlow = webdriver.promise.controlFlow();
+  var order = [];
+
+  webdriver.promise.createFlow(function(flow) {
+    assertFlowIs(flow);
+    order.push(0);
+
+    defaultFlow.execute(function() {
+      assertFlowIs(defaultFlow);
+      order.push(1);
+    });
+  });
+
+  return waitForIdle().then(function() {
+    assertFlowIs(defaultFlow);
+    assertArrayEquals([0, 1], order);
+  });
+}
+
+function testCreateFlowReturnsPromisePairedWithCreatedFlow() {
+  return new goog.Promise(function(fulfill, reject) {
+    var newFlow;
+    webdriver.promise.createFlow(function(flow) {
+      newFlow = flow;
+      assertFlowIs(newFlow);
+    }).then(function() {
+      assertFlowIs(newFlow);
+      waitForIdle(newFlow).then(fulfill, reject);
+    });
+  });
+}
+
+function testDeferredFactoriesCreateForActiveFlow_defaultFlow() {
+  var e = Error();
+  var defaultFlow = webdriver.promise.controlFlow();
+  webdriver.promise.fulfilled().then(function() {
+    assertFlowIs(defaultFlow);
+  });
+  webdriver.promise.rejected(e).then(null, function(err) {
+    assertEquals(e, err);
+    assertFlowIs(defaultFlow);
+  });
+  webdriver.promise.defer().then(function() {
+    assertFlowIs(defaultFlow);
+  });
+
+  return waitForIdle();
+}
+
+
+function testDeferredFactoriesCreateForActiveFlow_newFlow() {
+  var e = Error();
+  var newFlow = new webdriver.promise.ControlFlow;
+  newFlow.execute(function() {
+    webdriver.promise.fulfilled().then(function() {
+      assertFlowIs(newFlow);
+    });
+
+    webdriver.promise.rejected(e).then(null, function(err) {
+      assertEquals(e, err);
+      assertFlowIs(newFlow);
+    });
+
+    webdriver.promise.defer().then(function() {
+      assertFlowIs(newFlow);
+    });
+  }).then(function() {
+    assertFlowIs(newFlow);
+  });
+
+  return waitForIdle(newFlow);
+}
+
+function testFlowsSynchronizeWithThemselvesNotEachOther() {
+  var defaultFlow = webdriver.promise.controlFlow();
+  schedulePush('a', 'a');
+  webdriver.promise.controlFlow().timeout(250);
+  schedulePush('b', 'b');
+
+  webdriver.promise.createFlow(function() {
+    schedulePush('c', 'c');
+    schedulePush('d', 'd');
+  });
+
+  return waitForIdle().then(function() {
+    webdriver.test.testutil.assertMessages('a', 'c', 'd', 'b');
+  });
+}
+
+function testUnhandledErrorsAreReportedToTheOwningFlow() {
+  var error1 = Error('e1');
+  var error2 = Error('e2');
+
+  var defaultFlow = webdriver.promise.controlFlow();
+  defaultFlow.removeAllListeners('uncaughtException');
+
+  var flow1Error = goog.Promise.withResolver();
+  flow1Error.promise.then(function(value) {
+    assertEquals(error2, value);
+  });
+
+  var flow2Error = goog.Promise.withResolver();
+  flow2Error.promise.then(function(value) {
+    assertEquals(error1, value);
+  });
+
+  webdriver.promise.createFlow(function(flow) {
+    flow.once('uncaughtException', flow2Error.resolve);
+    webdriver.promise.rejected(error1);
+
+    defaultFlow.once('uncaughtException', flow1Error.resolve);
+    defaultFlow.execute(function() {
+      webdriver.promise.rejected(error2);
+    });
+  });
+
+  return goog.Promise.all([flow1Error.promise, flow2Error.promise]);
+}
+
+function testCanSynchronizeFlowsByReturningPromiseFromOneToAnother() {
+  var flow1 = new webdriver.promise.ControlFlow;
+  var flow1Done = goog.Promise.withResolver();
+  flow1.once('idle', flow1Done.resolve);
+  flow1.once('uncaughtException', flow1Done.reject);
+
+  var flow2 = new webdriver.promise.ControlFlow;
+  var flow2Done = goog.Promise.withResolver();
+  flow2.once('idle', flow2Done.resolve);
+  flow2.once('uncaughtException', flow2Done.reject);
+
+  flow1.execute(function() {
+    schedulePush('a', 'a');
+    return webdriver.promise.delayed(25);
+  }, 'start flow 1');
+
+  flow2.execute(function() {
+    schedulePush('b', 'b');
+    schedulePush('c', 'c');
+    flow2.execute(function() {
+      return flow1.execute(function() {
+        schedulePush('d', 'd');
+      }, 'flow 1 task');
+    }, 'inject flow1 result into flow2');
+    schedulePush('e', 'e');
+  }, 'start flow 2');
+
+  return goog.Promise.all([flow1Done.promise, flow2Done.promise]).
+      then(function() {
+        webdriver.test.testutil.assertMessages('a', 'b', 'c', 'd', 'e');
+      });
+}
+
+function testFramesWaitToCompleteForPendingRejections() {
+  return new goog.Promise(function(fulfill, reject) {
+
+    webdriver.promise.controlFlow().execute(function() {
+      webdriver.promise.rejected(new StubError);
+    }).then(fulfill, reject);
+
+  }).
+  then(goog.partial(fail, 'expected to fail'), assertIsStubError).
+  then(waitForIdle);
+}
+
+function testSynchronizeErrorsPropagateToOuterFlow() {
+  var outerFlow = new webdriver.promise.ControlFlow;
+  var innerFlow = new webdriver.promise.ControlFlow;
+
+  var block = goog.Promise.withResolver();
+  innerFlow.execute(function() {
+    return block.promise;
+  }, 'block inner flow');
+
+  outerFlow.execute(function() {
+    block.resolve();
+    return innerFlow.execute(function() {
+      webdriver.promise.rejected(new StubError);
+    }, 'trigger unhandled rejection error');
+  }, 'run test');
+
+  return goog.Promise.all([
+    waitForIdle(innerFlow),
+    waitForAbort(outerFlow).then(assertIsStubError)
+  ]);
+}
+
+function testFailsIfErrbackThrows() {
+  webdriver.promise.rejected('').then(null, throwStubError);
+  return waitForAbort().then(assertIsStubError);
+}
+
+function testFailsIfCallbackReturnsRejectedPromise() {
+  webdriver.promise.fulfilled().then(function() {
+    return webdriver.promise.rejected(new StubError);
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+function testAbortsFrameIfTaskFails() {
+  webdriver.promise.fulfilled().then(function() {
+    webdriver.promise.controlFlow().execute(throwStubError);
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+function testAbortsFramePromisedChainedFromTaskIsNotHandled() {
+  webdriver.promise.fulfilled().then(function() {
+    webdriver.promise.controlFlow().execute(goog.nullFunction).
+        then(throwStubError);
+  });
+  return waitForAbort().then(assertIsStubError);
+}
+
+function testTrapsChainedUnhandledRejectionsWithinAFrame() {
+  var pair = callbackPair(null, assertIsStubError);
+  webdriver.promise.fulfilled().then(function() {
+    webdriver.promise.controlFlow().execute(goog.nullFunction).
+        then(throwStubError);
+  }).then(pair.callback, pair.errback);
+
+  return waitForIdle().then(pair.assertErrback);
+}
+
+
+function testCancelsRemainingTasksIfFrameThrowsDuringScheduling() {
+  var task1, task2;
+  var pair = callbackPair(null, assertIsStubError);
+  var flow = webdriver.promise.controlFlow();
+  flow.execute(function() {
+    task1 = flow.execute(goog.nullFunction);
+    task2 = flow.execute(goog.nullFunction);
+    throw new StubError;
+  }).then(pair.callback, pair.errback);
+
+  return waitForIdle().
+      then(pair.assertErrback).
+      then(function() {
+        assertFalse(task1.isPending());
+        pair = callbackPair();
+        return task1.then(pair.callback, pair.errback);
+      }).
+      then(function() {
+        pair.assertErrback();
+        assertFalse(task2.isPending());
+        pair = callbackPair();
+        return task2.then(pair.callback, pair.errback);
+      }).
+      then(function() {
+        pair.assertErrback();
+      });
+}
+
+function testCancelsRemainingTasksInFrameIfATaskFails() {
+  var task;
+  var pair = callbackPair(null, assertIsStubError);
+  var flow = webdriver.promise.controlFlow();
+  flow.execute(function() {
+    flow.execute(throwStubError);
+    task = flow.execute(goog.nullFunction);
+  }).then(pair.callback, pair.errback);
+
+  return waitForIdle().then(pair.assertErrback).then(function() {
+    assertFalse(task.isPending());
+    pair = callbackPair();
+    task.then(pair.callback, pair.errback);
+  }).then(function() {
+    pair.assertErrback();
+  });
+}
+
+function testDoesNotModifyRejectionErrorIfPromiseNotInsideAFlow() {
+  var error = Error('original message');
+  var originalStack = error.stack;
+  var originalStr = error.toString();
+
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+    assertEquals('original message', e.message);
+    assertEquals(originalStack, e.stack);
+    assertEquals(originalStr, e.toString());
+  });
+
+  webdriver.promise.rejected(error).then(pair.callback, pair.errback);
+  return waitForIdle().then(pair.assertErrback);
+}
+
+
+/** See https://github.com/SeleniumHQ/selenium/issues/444 */
+function testMaintainsOrderWithPromiseChainsCreatedWithinAForeach_1() {
+  var messages = [];
+  flow.execute(function() {
+    return webdriver.promise.fulfilled(['a', 'b', 'c', 'd']);
+  }, 'start').then(function(steps) {
+    steps.forEach(function(step) {
+      webdriver.promise.fulfilled(step)
+      .then(function() {
+        messages.push(step + '.1');
+      }).then(function() {
+        messages.push(step + '.2');
+      });
+    })
+  });
+  return waitForIdle().then(function() {
+    assertArrayEquals(
+        ['a.1', 'a.2', 'b.1', 'b.2', 'c.1', 'c.2', 'd.1', 'd.2'],
+        messages);
+  });
+}
+
+
+/** See https://github.com/SeleniumHQ/selenium/issues/444 */
+function testMaintainsOrderWithPromiseChainsCreatedWithinAForeach_2() {
+  var messages = [];
+  flow.execute(function() {
+    return webdriver.promise.fulfilled(['a', 'b', 'c', 'd']);
+  }, 'start').then(function(steps) {
+    steps.forEach(function(step) {
+      webdriver.promise.fulfilled(step)
+      .then(function() {
+        messages.push(step + '.1');
+      }).then(function() {
+        flow.execute(function() {}, step + '.2').then(function() {
+          messages.push(step + '.2');
+        });
+      });
+    })
+  });
+  return waitForIdle().then(function() {
+    assertArrayEquals(
+        ['a.1', 'a.2', 'b.1', 'b.2', 'c.1', 'c.2', 'd.1', 'd.2'],
+        messages);
+  });
+}
+
+
+/** See https://github.com/SeleniumHQ/selenium/issues/444 */
+function testMaintainsOrderWithPromiseChainsCreatedWithinAForeach_3() {
+  var messages = [];
+  flow.execute(function() {
+    return webdriver.promise.fulfilled(['a', 'b', 'c', 'd']);
+  }, 'start').then(function(steps) {
+    steps.forEach(function(step) {
+      webdriver.promise.fulfilled(step)
+      .then(function(){})
+      .then(function() {
+        messages.push(step + '.1');
+        return flow.execute(function() {}, step + '.1');
+      }).then(function() {
+        flow.execute(function() {}, step + '.2').then(function(text) {
+          messages.push(step + '.2');
+        });
+      });
+    })
+  });
+  return waitForIdle().then(function() {
+    assertArrayEquals(
+        ['a.1', 'a.2', 'b.1', 'b.2', 'c.1', 'c.2', 'd.1', 'd.2'],
+        messages);
+  });
+}
+
+/** See https://github.com/SeleniumHQ/selenium/issues/363 */
+function
+testTasksScheduledInASeparateTurnOfTheEventLoopGetASeparateTaskQueue_1() {
+  scheduleAction('a', () => webdriver.promise.delayed(10));
+  schedule('b');
+  setTimeout(() => schedule('c'), 0);
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'c', 'b');
+  });
+}
+
+
+/** See https://github.com/SeleniumHQ/selenium/issues/363 */
+function
+testTasksScheduledInASeparateTurnOfTheEventLoopGetASeparateTaskQueue_2() {
+  scheduleAction('a', () => webdriver.promise.delayed(10));
+  schedule('b');
+  schedule('c');
+  setTimeout(function() {
+    schedule('d');
+    scheduleAction('e', () => webdriver.promise.delayed(10));
+    schedule('f');
+  }, 0);
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'd', 'e', 'b', 'c', 'f');
+  });
+}
+
+
+/** See https://github.com/SeleniumHQ/selenium/issues/363 */
+function testCanSynchronizeTasksFromAdjacentTaskQueues() {
+  var task1 = scheduleAction('a', () => webdriver.promise.delayed(10));
+  schedule('b');
+  setTimeout(function() {
+    scheduleAction('c', () => task1);
+    schedule('d');
+  }, 0);
+
+  return waitForIdle().then(function() {
+    assertFlowHistory('a', 'c', 'd', 'b');
+  });
+}
+
+
+function testCancellingAScheduledTask_1() {
+  var called = false;
+  var task1 = scheduleAction('a', () => called = true);
+  task1.cancel('no soup for you');
+
+  return waitForIdle().then(function() {
+    assertFalse(called);
+    assertFlowHistory();
+    return task1.thenCatch(function(e) {
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+      assertEquals('no soup for you', e.message);
+    });
+  });
+}
+
+
+function testCancellingAScheduledTask_2() {
+  schedule('a');
+  var called = false;
+  var task2 = scheduleAction('b', () => called = true);
+  schedule('c');
+
+  task2.cancel('no soup for you');
+
+  return waitForIdle().then(function() {
+    assertFalse(called);
+    assertFlowHistory('a', 'c');
+    return task2.thenCatch(function(e) {
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+      assertEquals('no soup for you', e.message);
+    });
+  });
+}
+
+
+function testCancellingAScheduledTask_3() {
+  var called = false;
+  var task = scheduleAction('a', () => called = true);
+  task.cancel(new StubError);
+
+  return waitForIdle().then(function() {
+    assertFalse(called);
+    assertFlowHistory();
+    return task.thenCatch(function(e) {
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+    });
+  });
+}
+
+
+function testCancellingAScheduledTask_4() {
+  var seen = [];
+  var task = scheduleAction('a', () => seen.push(1))
+      .then(() => seen.push(2))
+      .then(() => seen.push(3))
+      .then(() => seen.push(4))
+      .then(() => seen.push(5));
+  task.cancel(new StubError);
+
+  return waitForIdle().then(function() {
+    assertArrayEquals([], seen);
+    assertFlowHistory();
+    return task.thenCatch(function(e) {
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+    });
+  });
+}
+
+
+function testCancellingAScheduledTask_fromWithinAnExecutingTask() {
+  var called = false;
+  var task;
+  scheduleAction('a', function() {
+    task.cancel('no soup for you');
+  });
+  task = scheduleAction('b', () => called = true);
+  schedule('c');
+
+  return waitForIdle().then(function() {
+    assertFalse(called);
+    assertFlowHistory('a', 'c');
+    return task.thenCatch(function(e) {
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+      assertEquals('no soup for you', e.message);
+    });
+  });
+}
+
+
+function testCancellingAPendingTask() {
+  var order = [];
+  var unresolved = webdriver.promise.defer();
+
+  var innerTask;
+  var outerTask = scheduleAction('a', function() {
+    order.push(1);
+
+    // Schedule a task that will never finish.
+    innerTask = scheduleAction('a.1', function() {
+      return unresolved.promise;
+    });
+
+    innerTask.thenCatch(function(e) {
+      order.push(2);
+      assertTrue(e instanceof webdriver.promise.CancellationError);
+      assertEquals('no soup for you', e.message);
+    });
+  });
+  schedule('b');
+
+  outerTask.thenCatch(function(e) {
+    order.push(3);
+    assertTrue(e instanceof webdriver.promise.CancellationError);
+    assertEquals('no soup for you', e.message);
+  });
+
+  unresolved.promise.thenCatch(function(e) {
+    order.push(4);
+  });
+
+  return timeout(10).then(function() {
+    assertArrayEquals([1], order);
+    assertTrue(unresolved.promise.isPending());
+
+    outerTask.cancel('no soup for you');
+    return waitForIdle();
+  }).then(function() {
+    assertFlowHistory('a', 'a.1', 'b');
+    assertArrayEquals([1, 4, 2, 3], order);
+  });
+}
+
+
+function testCancellingAPendingPromiseCallback() {
+  var called = false;
+
+  var root = webdriver.promise.fulfilled();
+  root.then(function() {
+    cb2.cancel('no soup for you');
+  });
+
+  var cb2 = root.then(fail, fail);  // These callbacks should never be called.
+  cb2.then(fail, function(e) {
+    called = true;
+    assertTrue(e instanceof webdriver.promise.CancellationError);
+    assertEquals('no soup for you', e.message);
+  });
+
+  return waitForIdle().then(function() {
+    assertTrue(called);
+  });
+}
+
+
+function testResetFlow_1() {
+  var called = 0;
+  var task = flow.execute(() => called++);
+  task.thenFinally(() => called++);
+
+  return new Promise(function(fulfill) {
+    flow.once('reset', fulfill);
+    flow.reset();
+
+  }).then(function() {
+    assertEquals(0, called);
+    assertFalse(task.isPending());
+    return task;
+
+  }).then(fail, function(e) {
+    assertTrue(e instanceof webdriver.promise.CancellationError);
+    assertEquals('ControlFlow was reset', e.message);
+  });
+}
+
+
+function testResetFlow_2() {
+  var called = 0;
+  var task1 = flow.execute(() => called++);
+  task1.thenFinally(() => called++);
+
+  var task2 = flow.execute(() => called++);
+  task2.thenFinally(() => called++);
+
+  var task3 = flow.execute(() => called++);
+  task3.thenFinally(() => called++);
+
+  return new Promise(function(fulfill) {
+    flow.once('reset', fulfill);
+    flow.reset();
+
+  }).then(function() {
+    assertEquals(0, called);
+    assertFalse(task1.isPending());
+    assertFalse(task2.isPending());
+    assertFalse(task3.isPending());
+  });
+}
+
+
+function testPromiseFulfilledInsideTask_1() {
+  var order = [];
+
+  flow.execute(function() {
+    var d = webdriver.promise.defer();
+
+    d.promise.then(() => order.push('a'));
+    d.promise.then(() => order.push('b'));
+    d.promise.then(() => order.push('c'));
+    d.fulfill();
+
+    flow.execute(() => order.push('d'));
+
+  }).then(() => order.push('fin'));
+
+  return waitForIdle().then(function() {
+    assertArrayEquals(['a', 'b', 'c', 'd', 'fin'], order);
+  });
+}
+
+
+function testPromiseFulfilledInsideTask_2() {
+  var order = [];
+
+  flow.execute(function() {
+    flow.execute(() => order.push('a'));
+    flow.execute(() => order.push('b'));
+
+    var d = webdriver.promise.defer();
+    d.promise.then(() => order.push('c'));
+    d.promise.then(() => order.push('d'));
+    d.fulfill();
+
+    flow.execute(() => order.push('e'));
+
+  }).then(() => order.push('fin'));
+
+  return waitForIdle().then(function() {
+    assertArrayEquals(['a', 'b', 'c', 'd', 'e', 'fin'], order);
+  });
+}
+
+
+function testPromiseFulfilledInsideTask_3() {
+  var order = [];
+  var d = webdriver.promise.defer();
+  d.promise.then(() => order.push('c'));
+  d.promise.then(() => order.push('d'));
+
+  flow.execute(function() {
+    flow.execute(() => order.push('a'));
+    flow.execute(() => order.push('b'));
+
+    d.promise.then(() => order.push('e'));
+    d.fulfill();
+
+    flow.execute(() => order.push('f'));
+
+  }).then(() => order.push('fin'));
+
+  return waitForIdle().then(function() {
+    assertArrayEquals(['c', 'd', 'a', 'b', 'e', 'f', 'fin'], order);
+  });
+}
+
+
+function testPromiseFulfilledInsideTask_4() {
+  var order = [];
+  var d = webdriver.promise.defer();
+  d.promise.then(() => order.push('a'));
+  d.promise.then(() => order.push('b'));
+
+  flow.execute(function() {
+    flow.execute(function() {
+      order.push('c');
+      flow.execute(() => order.push('d'));
+      d.promise.then(() => order.push('e'));
+    });
+    flow.execute(() => order.push('f'));
+
+    d.promise.then(() => order.push('g'));
+    d.fulfill();
+
+    flow.execute(() => order.push('h'));
+
+  }).then(() => order.push('fin'));
+
+  return waitForIdle().then(function() {
+    assertArrayEquals(['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'fin'], order);
+  });
+}
+
+
+function testSettledPromiseCallbacksInsideATask_1() {
+  var order = [];
+  var p = webdriver.promise.fulfilled();
+
+  flow.execute(function() {
+    flow.execute(() => order.push('a'));
+    p.then(() => order.push('b'));
+    flow.execute(() => order.push('c'));
+    p.then(() => order.push('d'));
+  }).then(() => order.push('fin'));
+
+  return waitForIdle().then(function() {
+    assertArrayEquals(['a', 'b', 'c', 'd', 'fin'], order);
+  });
+}
+
+function testSettledPromiseCallbacksInsideATask_2() {
+  var order = [];
+
+  flow.execute(function() {
+    flow.execute(() => order.push('a'))
+        .then(   () => order.push('c'));
+    flow.execute(() => order.push('b'));
+  }).then(() => order.push('fin'));
+
+  return waitForIdle().then(function() {
+    assertArrayEquals(['a', 'c', 'b', 'fin'], order);
+  });
+}
diff --git a/lib/webdriver/test/promise_generator_test.js b/lib/webdriver/test/promise_generator_test.js
new file mode 100644
index 0000000..708f4cd
--- /dev/null
+++ b/lib/webdriver/test/promise_generator_test.js
@@ -0,0 +1,323 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.provide('webdriver.test.promise.generator.test');
+goog.setTestOnly('webdriver.test.promise.generator.test');
+
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.promise');
+
+
+function testRequiresInputsToBeGeneratorFunctions() {
+  var thrown = assertThrows(function() {
+    webdriver.promise.consume(function() {});
+  });
+  assertTrue(thrown instanceof TypeError);
+}
+
+
+function testBasicGenerator() {
+  var values = [];
+  return webdriver.promise.consume(function* () {
+    var i = 0;
+    while (i < 4) {
+      i = yield i + 1;
+      values.push(i);
+    }
+  }).then(function() {
+    assertArrayEquals([1, 2, 3, 4], values);
+  });
+}
+
+
+function testPromiseYieldingGenerator() {
+  var values = [];
+  return webdriver.promise.consume(function* () {
+    var i = 0;
+    while (i < 4) {
+      // Test that things are actually async here.
+      setTimeout(function() {
+        values.push(i * 2);
+      }, 10);
+
+      yield webdriver.promise.delayed(10).then(function() {
+        values.push(i++);
+      });
+    }
+  }).then(function() {
+    assertArrayEquals([0, 0, 2, 1, 4, 2, 6, 3], values);
+  });
+}
+
+
+function testAssignmentsToYieldedPromisesGetFulfilledValue() {
+  return webdriver.promise.consume(function* () {
+    var p = webdriver.promise.fulfilled(2);
+    var x = yield p;
+    assertEquals(2, x);
+  });
+}
+
+
+function testCanCancelPromiseGenerator() {
+  var values = [];
+  var p = webdriver.promise.consume(function* () {
+    var i = 0;
+    while (i < 3) {
+      yield webdriver.promise.delayed(100).then(function() {
+        values.push(i++);
+      });
+    }
+  });
+  return webdriver.promise.delayed(75).then(function() {
+    p.cancel();
+    return p.thenCatch(function() {
+      return webdriver.promise.delayed(300);
+    });
+  }).then(function() {
+    assertArrayEquals([0], values);
+  });
+}
+
+
+function testFinalReturnValueIsUsedAsFulfillmentValue() {
+  return webdriver.promise.consume(function* () {
+    yield 1;
+    yield 2;
+    return 3;
+  }).then(function(value) {
+    assertEquals(3, value);
+  });
+}
+
+
+function testRejectionsAreThrownWithinGenerator() {
+  var values = [];
+  return webdriver.promise.consume(function* () {
+    values.push('a');
+    var e = Error('stub error');
+    try {
+      yield webdriver.promise.rejected(e);
+      values.push('b');
+    } catch (ex) {
+      assertEquals(e, ex);
+      values.push('c');
+    }
+    values.push('d');
+  }).then(function() {
+    assertArrayEquals(['a', 'c', 'd'], values);
+  });
+}
+
+
+function testUnhandledRejectionsAbortGenerator() {
+  var values = [];
+  var e = Error('stub error');
+  return webdriver.promise.consume(function* () {
+    values.push(1);
+    yield webdriver.promise.rejected(e);
+    values.push(2);
+  }).thenCatch(function() {
+    assertArrayEquals([1], values);
+  });
+}
+
+
+function testYieldsWaitForPromises() {
+  var values = [];
+  var d = webdriver.promise.defer();
+
+  setTimeout(function() {
+    assertArrayEquals([1], values);
+    d.fulfill(2);
+  }, 100);
+
+  return webdriver.promise.consume(function* () {
+    values.push(1);
+    values.push((yield d.promise), 3);
+  }).then(function() {
+    assertArrayEquals([1, 2, 3], values);
+  });
+}
+
+
+function testCanSpecifyGeneratorScope() {
+  return webdriver.promise.consume(function* () {
+    return this.name;
+  }, {name: 'Bob'}).then(function(value) {
+    assertEquals('Bob', value);
+  });
+}
+
+
+function testCanSpecifyGeneratorArgs() {
+  return webdriver.promise.consume(function* (a, b) {
+    assertEquals('red', a);
+    assertEquals('apples', b);
+  }, null, 'red', 'apples');
+}
+
+
+function testExecuteGeneratorInAFlow() {
+  var promises = [
+      webdriver.promise.defer(),
+      webdriver.promise.defer()
+  ];
+  var values = [];
+
+  setTimeout(function() {
+    assertArrayEquals([], values);
+    promises[0].fulfill(1);
+  }, 100);
+
+  setTimeout(function() {
+    assertArrayEquals([1], values);
+    promises[1].fulfill(2);
+  }, 200);
+
+  return webdriver.promise.controlFlow().execute(function* () {
+    values.push(yield promises[0].promise);
+    values.push(yield promises[1].promise);
+    values.push('fin');
+  }).then(function() {
+    assertArrayEquals([1, 2, 'fin'], values);
+  });
+}
+
+
+function testNestedGeneratorsInAFlow() {
+  var flow = webdriver.promise.controlFlow();
+  return flow.execute(function* () {
+    var x = yield flow.execute(function() {
+      return webdriver.promise.delayed(10).then(function() {
+        return 1;
+      });
+    });
+
+    var y = yield flow.execute(function() {
+      return 2;
+    });
+
+    return x + y;
+  }).then(function(value) {
+    assertEquals(3, value);
+  });
+}
+
+
+function testFlowWaitOnGenerator() {
+  var values = [];
+  return webdriver.promise.controlFlow().wait(function* () {
+    yield values.push(1);
+    values.push(yield webdriver.promise.delayed(10).then(function() {
+      return 2;
+    }));
+    yield values.push(3);
+    return values.length === 6;
+  }, 250).then(function() {
+    assertArrayEquals([1, 2, 3, 1, 2, 3], values);
+  });
+}
+
+
+function testFlowWaitingOnGeneratorTimesOut() {
+  var values = [];
+  return webdriver.promise.controlFlow().wait(function* () {
+    var i = 0;
+    while (i < 3) {
+      yield webdriver.promise.delayed(100).then(function() {
+        values.push(i++);
+      });
+    }
+  }, 75).thenCatch(function() {
+    assertArrayEquals('Should complete one loop of wait condition',
+        [0, 1, 2], values);
+  });
+}
+
+
+function testGeneratorAsPromiseCallback_1() {
+  var promises = [
+    webdriver.promise.defer(),
+    webdriver.promise.defer()
+  ];
+  var values = [];
+
+  setTimeout(function() {
+    promises[0].fulfill(1);
+  }, 50);
+
+  setTimeout(function() {
+    promises[1].fulfill(2);
+  }, 100);
+
+  return webdriver.promise.fulfilled().then(function*() {
+    values.push(yield promises[0].promise);
+    values.push(yield promises[1].promise);
+    values.push('fin');
+  }).then(function() {
+    assertArrayEquals([1, 2, 'fin'], values);
+  });
+}
+
+
+function testGeneratorAsPromiseCallback_2() {
+  var promises = [
+    webdriver.promise.defer(),
+    webdriver.promise.defer()
+  ];
+  var values = [];
+
+  setTimeout(function() {
+    promises[0].fulfill(1);
+  }, 50);
+
+  setTimeout(function() {
+    promises[1].fulfill(2);
+  }, 100);
+
+  return webdriver.promise.fulfilled(3).then(function*(value) {
+    var p1 = yield promises[0].promise;
+    var p2 = yield promises[1].promise;
+    values.push(value + p1);
+    values.push(value + p2);
+    values.push('fin');
+  }).then(function() {
+    assertArrayEquals([4, 5, 'fin'], values);
+  });
+}
+
+function testGeneratorAsPromiseCallback_3() {
+  var d = webdriver.promise.defer();
+  var e = Error('stub');
+
+  setTimeout(function() {
+    d.reject(e);
+  }, 50);
+
+  return webdriver.promise.fulfilled().then(function*() {
+    var threw = false;
+    try {
+      yield d.promise;
+    } catch (ex) {
+      threw = true;
+      assertEquals(e, ex);
+    }
+    assertTrue(threw);
+  });
+}
+
diff --git a/lib/webdriver/test/promise_test.js b/lib/webdriver/test/promise_test.js
new file mode 100644
index 0000000..cfea256
--- /dev/null
+++ b/lib/webdriver/test/promise_test.js
@@ -0,0 +1,2012 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.MockClock');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.promise');
+goog.require('webdriver.stacktrace');
+goog.require('webdriver.test.testutil');
+
+
+// Aliases for readability.
+var assertIsPromise = webdriver.test.testutil.assertIsPromise,
+    assertNotPromise = webdriver.test.testutil.assertNotPromise,
+    callbackHelper = webdriver.test.testutil.callbackHelper,
+    callbackPair = webdriver.test.testutil.callbackPair,
+    assertIsStubError = webdriver.test.testutil.assertIsStubError,
+    throwStubError = webdriver.test.testutil.throwStubError,
+    StubError = webdriver.test.testutil.StubError;
+
+var app, clock, uncaughtExceptions;
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+
+function setUp() {
+  webdriver.promise.LONG_STACK_TRACES = false;
+  clock = new goog.testing.MockClock(true);
+  uncaughtExceptions = [];
+
+  app = webdriver.promise.controlFlow();
+  app.on(webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,
+         goog.bind(uncaughtExceptions.push, uncaughtExceptions));
+}
+
+
+function tearDown() {
+  clock.tick(Infinity);
+  clock.dispose();
+  app.reset();
+  webdriver.promise.setDefaultFlow(new webdriver.promise.ControlFlow);
+  assertArrayEquals(
+      'Did not expect any uncaught exceptions', [], uncaughtExceptions);
+  webdriver.promise.LONG_STACK_TRACES = false;
+}
+
+
+function createRejectedPromise(reason) {
+  var p = webdriver.promise.rejected(reason);
+  p.thenCatch(goog.nullFunction);
+  return p;
+}
+
+
+function testCanDetectPromiseLikeObjects() {
+  assertIsPromise(new webdriver.promise.Promise(function(fulfill) {
+    fulfill();
+  }));
+  assertIsPromise(new webdriver.promise.Deferred());
+  assertIsPromise(new webdriver.promise.Deferred().promise);
+  assertIsPromise({then:function() {}});
+
+  assertNotPromise(undefined);
+  assertNotPromise(null);
+  assertNotPromise('');
+  assertNotPromise(true);
+  assertNotPromise(false);
+  assertNotPromise(1);
+  assertNotPromise({});
+  assertNotPromise({then:1});
+  assertNotPromise({then:true});
+  assertNotPromise({then:''});
+}
+
+
+function testSimpleResolveScenario() {
+  var callback = callbackHelper(function(value) {
+    assertEquals(123, value);
+  });
+
+  var deferred = webdriver.promise.defer();
+  deferred.promise.then(callback);
+
+  callback.assertNotCalled();
+  deferred.fulfill(123);
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testRegisteringACallbackPostResolution() {
+  var callback, deferred = new webdriver.promise.Deferred();
+
+  deferred.then((callback = callbackHelper(function(value) {
+    assertEquals(123, value);
+  })));
+  deferred.fulfill(123);
+  clock.tick();
+  callback.assertCalled();
+
+  deferred.then((callback = callbackHelper(function(value) {
+    assertEquals(123, value);
+  })));
+  callback.assertNotCalled();
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testRegisterACallbackViaDeferredPromise() {
+  var callback, deferred = new webdriver.promise.Deferred();
+
+  deferred.promise.then((callback = callbackHelper(function(value) {
+    assertEquals(123, value);
+  })));
+  deferred.fulfill(123);
+  clock.tick();
+  callback.assertCalled();
+
+  deferred.promise.then((callback = callbackHelper(function(value) {
+    assertEquals(123, value);
+  })));
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testTwoStepResolvedChain() {
+  var callback, start = new webdriver.promise.Deferred();
+
+  var next = start.then((callback = callbackHelper(function(value) {
+    assertEquals(123, value);
+    return value + 1;
+  })));
+
+  assertIsPromise(next);
+
+  callback.assertNotCalled();
+  start.fulfill(123);
+  clock.tick();
+  callback.assertCalled();
+
+  next.then((callback = callbackHelper(function(value) {
+    assertEquals(124, value);
+  })));
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testCanResolveOnlyOnce_resolved() {
+  var deferred = new webdriver.promise.Deferred();
+  deferred.fulfill(1);
+  deferred.fulfill(2);
+  deferred.reject(3);
+
+  var callback;
+  deferred.then(callback = callbackHelper(function(value) {
+    assertEquals(1, value);
+  }));
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testCanResolveOnlyOnce_rejected() {
+  var deferred = new webdriver.promise.Deferred();
+  deferred.reject(new StubError);
+  deferred.fulfill(1);
+  deferred.reject(2);
+
+  var callback;
+  deferred.then(null, callback = callbackHelper(assertIsStubError));
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testIfFulfilledWithOtherPromiseCannotChangeValueWhileWaiting() {
+  var deferred = webdriver.promise.defer();
+  var other = webdriver.promise.defer();
+
+  deferred.fulfill(other.promise);
+  deferred.fulfill('different value');
+
+  var callback = callbackHelper(function(value) {
+    assertEquals(123, value);
+  });
+
+  deferred.then(callback);
+  callback.assertNotCalled();
+
+  other.fulfill(123);
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testOnlyGoesDownListenerPath_resolved() {
+  var callback = callbackHelper();
+  var errback = callbackHelper();
+
+  webdriver.promise.fulfilled().then(callback, errback);
+  clock.tick();
+  callback.assertCalled();
+  errback.assertNotCalled();
+}
+
+
+function testOnlyGoesDownListenerPath_rejected() {
+  var callback = callbackHelper();
+  var errback = callbackHelper();
+
+  webdriver.promise.rejected().then(callback, errback);
+  clock.tick();
+  callback.assertNotCalled();
+  errback.assertCalled();
+}
+
+
+function testCatchingAndSuppressingRejectionErrors() {
+  var errback = callbackHelper(assertIsStubError);
+  var callback = callbackHelper(function() {
+    assertUndefined(arguments[0]);
+  });
+
+  webdriver.promise.rejected(new StubError).
+      thenCatch(errback).
+      then(callback);
+  clock.tick();
+  errback.assertCalled();
+  callback.assertCalled();
+}
+
+
+function testThrowingNewRejectionErrors() {
+  var errback1 = callbackHelper(assertIsStubError);
+  var error2 = Error('hi');
+  var errback2 = callbackHelper(function(error) {
+    assertEquals(error2, error);
+  });
+
+  webdriver.promise.rejected(new StubError).
+      thenCatch(function(error) {
+        errback1(error);
+        throw error2;
+      }).
+      thenCatch(errback2);
+  clock.tick();
+  errback1.assertCalled();
+  errback2.assertCalled();
+}
+
+
+function testThenFinally_nonFailingCallbackDoesNotSuppressOriginalError() {
+  var done = callbackHelper(assertIsStubError);
+  webdriver.promise.rejected(new StubError).
+      thenFinally(goog.nullFunction).
+      thenCatch(done);
+  clock.tick();
+  done.assertCalled();
+}
+
+
+function testThenFinally_failingCallbackSuppressesOriginalError() {
+  var done = callbackHelper(assertIsStubError);
+  webdriver.promise.rejected(new Error('original')).
+      thenFinally(throwStubError).
+      thenCatch(done);
+  clock.tick();
+  done.assertCalled();
+}
+
+
+function testThenFinally_callbackThrowsAfterFulfilledPromise() {
+  var done = callbackHelper(assertIsStubError);
+  webdriver.promise.fulfilled().
+      thenFinally(throwStubError).
+      thenCatch(done);
+  clock.tick();
+  done.assertCalled();
+}
+
+
+function testThenFinally_callbackReturnsRejectedPromise() {
+  var done = callbackHelper(assertIsStubError);
+  webdriver.promise.fulfilled().
+      thenFinally(function() {
+        return webdriver.promise.rejected(new StubError);
+      }).
+      thenCatch(done);
+  clock.tick();
+  done.assertCalled();
+}
+
+
+function testChainingThen_AllResolved() {
+  var callbacks = [
+    callbackHelper(function(value) {
+      assertEquals(128, value);
+      return value * 2;
+    }),
+    callbackHelper(function(value) {
+      assertEquals(256, value);
+      return value * 2;
+    }),
+    callbackHelper(function(value) {
+      assertEquals(512, value);
+    })
+  ];
+
+  var deferred = new webdriver.promise.Deferred();
+  deferred.
+      then(callbacks[0]).
+      then(callbacks[1]).
+      then(callbacks[2]);
+
+  callbacks[0].assertNotCalled();
+  callbacks[1].assertNotCalled();
+  callbacks[2].assertNotCalled();
+
+  deferred.fulfill(128);
+
+  clock.tick();
+  callbacks[0].assertCalled();
+  callbacks[1].assertCalled();
+  callbacks[2].assertCalled();
+}
+
+
+function testWhen_ReturnsAResolvedPromiseIfGivenANonPromiseValue() {
+  var ret = webdriver.promise.when('abc');
+  assertIsPromise(ret);
+
+  var callback;
+  ret.then(callback = callbackHelper(function (value) {
+    assertEquals('abc', value);
+  }));
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testWhen_PassesRawErrorsToCallbacks() {
+  var error = new Error('boo!'), callback;
+  webdriver.promise.when(error, callback = callbackHelper(function(value) {
+    assertEquals(error, value);
+  }));
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testWhen_WaitsForValueToBeResolvedBeforeInvokingCallback() {
+  var d = new webdriver.promise.Deferred(), callback;
+  webdriver.promise.when(d, callback = callbackHelper(function(value) {
+    assertEquals('hi', value);
+  }));
+  callback.assertNotCalled();
+  d.fulfill('hi');
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testWhen_canCancelReturnedPromise() {
+  var callbacks = callbackPair(null, function(e) {
+    assertTrue(e instanceof webdriver.promise.CancellationError);
+    assertEquals('just because', e.message);
+  });
+
+  var promiseLike = {
+    then: function(cb, eb) {
+      this.callback = cb;
+      this.errback = eb;
+    }
+  };
+
+  var promise = webdriver.promise.when(promiseLike,
+      callbacks.callback, callbacks.errback);
+
+  assertTrue(promise.isPending());
+  promise.cancel('just because');
+  clock.tick();
+  callbacks.assertErrback();
+
+  // The following should have no effect.
+  promiseLike.callback();
+  promiseLike.errback();
+}
+
+
+function testFiresUncaughtExceptionEventIfRejectionNeverHandled() {
+  webdriver.promise.rejected(new StubError);
+  var handler = callbackHelper(assertIsStubError);
+
+  // so tearDown() doesn't throw
+  app.removeAllListeners();
+  app.on(webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION, handler);
+  clock.tick();
+  handler.assertCalled();
+}
+
+
+function testWaitsIfCallbackReturnsAPromiseObject() {
+  var callback1, callback2;
+  var callback1Return = new webdriver.promise.Deferred();
+
+  webdriver.promise.fulfilled('hi').
+      then(callback1 = callbackHelper(function(value) {
+        assertEquals('hi', value);
+        return callback1Return;
+      })).
+      then(callback2 = callbackHelper(function(value) {
+        assertEquals('bye', value);
+      }));
+
+  clock.tick();
+  callback1.assertCalled();
+  callback2.assertNotCalled();
+  callback1Return.fulfill('bye');
+  clock.tick();
+  callback2.assertCalled();
+}
+
+
+function testWaitsIfCallbackReturnsAPromiseLikeObject() {
+  var callback1, callback2;
+  var callback1Return = {
+    then: function(callback) {
+      this.callback = callback;
+    },
+    fulfill: function(value) {
+      this.callback(value);
+    }
+  };
+
+  webdriver.promise.fulfilled('hi').
+      then(callback1 = callbackHelper(function(value) {
+        assertEquals('hi', value);
+        return callback1Return;
+      })).
+      then(callback2 = callbackHelper(function(value) {
+        assertEquals('bye', value);
+      }));
+
+  clock.tick();
+  callback1.assertCalled();
+  callback2.assertNotCalled();
+  callback1Return.fulfill('bye');
+  clock.tick();
+  callback2.assertCalled();
+}
+
+
+function testResolvingAPromiseWithAnotherPromiseCreatesAChain_ourPromise() {
+  var d1 = new webdriver.promise.Deferred();
+  var d2 = new webdriver.promise.Deferred();
+  var callback1, callback2;
+
+  d1.then(callback1 = callbackHelper(function(value) {
+    assertEquals(4, value);
+  }));
+
+  var d2promise = d2.then(callback2 = callbackHelper(function(value) {
+    assertEquals(2, value);
+    return value * 2;
+  }));
+
+  callback1.assertNotCalled();
+  callback2.assertNotCalled();
+
+  d2.fulfill(2);
+  clock.tick();
+  callback1.assertNotCalled();
+  callback2.assertCalled();
+
+  d1.fulfill(d2promise);
+  clock.tick();
+  callback1.assertCalled();
+  callback2.assertCalled();
+}
+
+
+function testResolvingAPromiseWithAnotherPromiseCreatesAChain_otherPromise() {
+  var d = new webdriver.promise.Deferred(), callback;
+  d.then(callback = callbackHelper(function(value) {
+    assertEquals(4, value);
+  }));
+
+  var otherPromise = {
+    then: function(callback) {
+      this.callback = callback;
+    },
+    fulfill: function(value) {
+      this.callback(value);
+    }
+  };
+
+  callback.assertNotCalled();
+  d.fulfill(otherPromise);
+  otherPromise.fulfill(4);
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testRejectForcesValueToAnError_errorInstance() {
+  var d = webdriver.promise.defer();
+  var callback = callbackHelper(assertIsStubError);
+
+  d.thenCatch(callback);
+  d.reject(new StubError);
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testRejectForcesValueToAnError_errorSubTypeInstance() {
+  var d = webdriver.promise.defer();
+  var e = new TypeError('hi');
+  var callback = callbackHelper(function(actual) {
+    assertEquals(e, actual);
+  });
+
+  d.thenCatch(callback);
+  d.reject(e);
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testRejectForcesValueToAnError_customErrorInstance() {
+  var d = webdriver.promise.defer();
+  var e = new goog.debug.Error('hi there');
+  var callback = callbackHelper(function(actual) {
+    assertEquals(e, actual);
+  });
+
+  d.thenCatch(callback);
+  d.reject(e);
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testRejectForcesValueToAnError_errorLike() {
+  var d = webdriver.promise.defer();
+  var e = {message: 'yolo'};
+  var callback = callbackHelper(function(actual) {
+    assertEquals(e, actual);
+  });
+
+  d.thenCatch(callback);
+  d.reject(e);
+  clock.tick();
+  callback.assertCalled();
+}
+
+
+function testRejectingAPromiseWithAnotherPromise_ourPromise() {
+  var d1 = new webdriver.promise.Deferred();
+  var d2 = new webdriver.promise.Deferred();
+  var pair1 = callbackPair(assertIsStubError, null);
+  var pair2 = callbackPair(function(value) {
+    assertEquals(2, value);
+    return new StubError;
+  });
+
+  d1.then(fail, function(e) {
+    assertEquals(d2promise, e);
+    return d2promise;
+  }).then(pair1.callback, pair1.errback);
+
+  var d2promise = d2.then(pair2.callback, pair2.errback);
+
+  pair1.assertNeither();
+  pair2.assertNeither();
+
+  d2.fulfill(2);
+  clock.tick();
+  pair1.assertNeither();
+  pair2.assertCallback();
+
+  d1.reject(d2promise);
+  clock.tick();
+  pair1.assertCallback();
+}
+
+
+function testRejectingAPromiseWithAnotherPromise_otherPromise() {
+  var otherPromise = {
+    then: function(callback) {
+      this.callback = callback;
+    },
+    fulfill: function(value) {
+      this.callback(value);
+    }
+  };
+
+  var pair = callbackPair(null, assertIsStubError);
+  var d = new webdriver.promise.Deferred();
+  d.promise.then(fail, function(e) {
+    assertEquals(otherPromise, e);
+    return otherPromise;
+  }).then(pair.callback, pair.errback);
+
+  d.reject(otherPromise);
+  clock.tick();
+  pair.assertNeither();
+
+  otherPromise.fulfill(new StubError);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testResolvingADeferredWithAnotherCopiesTheResolvedValue() {
+  var d1 = new webdriver.promise.Deferred();
+  var d2 = new webdriver.promise.Deferred();
+  var callback1, callback2;
+
+  d1.then(callback1 = callbackHelper(function(value) {
+    assertEquals(2, value);
+  }));
+
+  d2.then(callback2 = callbackHelper(function(value) {
+    assertEquals(2, value);
+    return 4;
+  }));
+
+  d1.fulfill(d2);
+  clock.tick();
+  callback1.assertNotCalled();
+  callback2.assertNotCalled();
+
+  d2.fulfill(2);
+  clock.tick();
+  callback1.assertCalled();
+  callback2.assertCalled();
+}
+
+
+function testCannotResolveAPromiseWithItself_fulfill() {
+  var pair = callbackPair(null, function(e) {
+    assertTrue(e instanceof TypeError);
+  });
+
+  var f, p = new webdriver.promise.Promise(function(fulfill) {
+    f = fulfill;
+  });
+  p.then(pair.callback, pair.errback);
+  f(p);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testCannotResolveAPromiseWithItself_reject() {
+  var pair = callbackPair(null, function(e) {
+    assertTrue(e instanceof TypeError);
+  });
+
+  var r, p = new webdriver.promise.Promise(function(_, reject) {
+    r = reject;
+  });
+  p.then(pair.callback, pair.errback);
+  r(p);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testCannotResolveADeferredWithItself() {
+  var deferred = new webdriver.promise.Deferred();
+  assertThrows(goog.bind(deferred.fulfill, deferred, deferred));
+  assertThrows(goog.bind(deferred.reject, deferred, deferred));
+}
+
+
+function testSkipsNullPointsInPromiseChain_callbacks() {
+  var errback1, errback2, callback;
+  webdriver.promise.fulfilled('hi').
+      thenCatch(errback1 = callbackHelper()).
+      thenCatch(errback2 = callbackHelper()).
+      then(callback = callbackHelper(function(value) {
+        assertEquals('hi', value);
+      }));
+
+  clock.tick();
+  errback1.assertNotCalled();
+  errback2.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testSkipsNullPointsInPromiseChain_errbacks() {
+  var errback1, errback2, callback;
+  webdriver.promise.fulfilled('hi').
+      thenCatch(errback1 = callbackHelper()).
+      thenCatch(errback2 = callbackHelper()).
+      then(callback = callbackHelper(function(value) {
+        assertEquals('hi', value);
+      }));
+
+  clock.tick();
+  errback1.assertNotCalled();
+  errback2.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_primitives() {
+  function runTest(value) {
+    var callback, errback;
+    webdriver.promise.fullyResolved(value).then(
+        callback = callbackHelper(function(resolved) {
+          assertEquals(value, resolved);
+        }),
+        errback = callbackHelper());
+
+    clock.tick();
+    errback.assertNotCalled(
+        'Did not expect errback to be called for: ' + value);
+    callback.assertCalled('Expected callback to be called for: ' + value);
+  }
+
+  runTest(true);
+  runTest(goog.nullFunction);
+  runTest(null);
+  runTest(123);
+  runTest('foo bar');
+  runTest(undefined);
+}
+
+
+function testFullyResolved_arrayOfPrimitives() {
+  var array = [true, goog.nullFunction, null, 123, '', undefined, 1];
+  var callbacks = callbackPair(function(resolved) {
+    assertEquals(array, resolved);
+    assertArrayEquals([true, goog.nullFunction, null, 123, '', undefined, 1],
+        resolved);
+  });
+
+  webdriver.promise.fullyResolved(array).then(
+      callbacks.callback, callbacks.errback);
+
+  clock.tick();
+  callbacks.assertCallback();
+}
+
+function testFullyResolved_nestedArrayOfPrimitives() {
+  var array = [true, [goog.nullFunction, null, 123], '', undefined];
+  var callback, errback;
+  webdriver.promise.fullyResolved(array).then(
+      callback = callbackHelper(function(resolved) {
+        assertEquals(array, resolved);
+        assertArrayEquals([true, [goog.nullFunction, null, 123], '', undefined],
+            resolved);
+        assertArrayEquals([goog.nullFunction, null, 123], resolved[1]);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_arrayWithPromisedPrimitive() {
+  var callback, errback;
+  webdriver.promise.fullyResolved([webdriver.promise.fulfilled(123)]).then(
+      callback = callbackHelper(function(resolved) {
+        assertArrayEquals([123], resolved);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_promiseResolvesToPrimitive() {
+  var promise = webdriver.promise.fulfilled(123);
+  var callback, errback;
+  webdriver.promise.fullyResolved(promise).then(
+      callback = callbackHelper(function(resolved) {
+        assertEquals(123, resolved);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_promiseResolvesToArray() {
+  var array = [true, [goog.nullFunction, null, 123], '', undefined];
+  var promise = webdriver.promise.fulfilled(array);
+  var callback, errback;
+
+  var result = webdriver.promise.fullyResolved(promise);
+  result.then(
+      callback = callbackHelper(function(resolved) {
+        assertEquals(array, resolved);
+        assertArrayEquals([true, [goog.nullFunction, null, 123], '', undefined],
+            resolved);
+        assertArrayEquals([goog.nullFunction, null, 123], resolved[1]);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_promiseResolvesToArrayWithPromises() {
+  var nestedPromise = webdriver.promise.fulfilled(123);
+  var promise = webdriver.promise.fulfilled([true, nestedPromise]);
+
+  var callback, errback;
+  webdriver.promise.fullyResolved(promise).then(
+      callback = callbackHelper(function(resolved) {
+        assertArrayEquals([true, 123], resolved);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_rejectsIfArrayPromiseRejects() {
+  var nestedPromise = createRejectedPromise(new StubError);
+  var promise = webdriver.promise.fulfilled([true, nestedPromise]);
+
+  var pair = callbackPair(null, assertIsStubError);
+  webdriver.promise.fullyResolved(promise).then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testFullyResolved_rejectsOnFirstArrayRejection() {
+  var e1 = new Error('foo');
+  var e2 = new Error('bar');
+  var promise = webdriver.promise.fulfilled([
+    createRejectedPromise(e1),
+    createRejectedPromise(e2)
+  ]);
+
+  var pair = callbackPair(null, function(error) {
+    assertEquals(e1, error);
+  });
+  webdriver.promise.fullyResolved(promise).then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testFullyResolved_rejectsIfNestedArrayPromiseRejects() {
+  var promise = webdriver.promise.fulfilled([
+    webdriver.promise.fulfilled([
+      createRejectedPromise(new StubError)
+    ])
+  ]);
+
+  var pair = callbackPair(null, assertIsStubError);
+  webdriver.promise.fullyResolved(promise).then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testFullyResolved_simpleHash() {
+  var hash = {'a': 123};
+
+  var callback, errback;
+  webdriver.promise.fullyResolved(hash).then(
+      callback = callbackHelper(function(resolved) {
+        assertEquals(hash, resolved);
+        webdriver.test.testutil.assertObjectEquals({'a': 123}, resolved);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_nestedHash() {
+  var nestedHash = {'foo':'bar'};
+  var hash = {'a': 123, 'b': nestedHash};
+
+  var callback, errback;
+  webdriver.promise.fullyResolved(hash).then(
+      callback = callbackHelper(function(resolved) {
+        assertEquals(hash, resolved);
+        webdriver.test.testutil.assertObjectEquals(
+            {'a': 123, 'b': {'foo': 'bar'}}, resolved);
+        webdriver.test.testutil.assertObjectEquals(nestedHash, resolved['b']);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_promiseResolvesToSimpleHash() {
+  var hash = {'a': 123};
+  var promise = webdriver.promise.fulfilled(hash);
+
+  var callback, errback;
+  webdriver.promise.fullyResolved(promise).then(
+      callback = callbackHelper(function(resolved) {
+        webdriver.test.testutil.assertObjectEquals(hash, resolved);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_promiseResolvesToNestedHash() {
+  var nestedHash = {'foo':'bar'};
+  var hash = {'a': 123, 'b': nestedHash};
+  var promise = webdriver.promise.fulfilled(hash);
+
+  var callback, errback;
+  webdriver.promise.fullyResolved(promise).then(
+      callback = callbackHelper(function(resolved) {
+        webdriver.test.testutil.assertObjectEquals(hash, resolved);
+        webdriver.test.testutil.assertObjectEquals(nestedHash, resolved['b']);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_promiseResolvesToHashWithPromises() {
+  var promise = webdriver.promise.fulfilled({
+      'a': webdriver.promise.fulfilled(123)
+  });
+
+  var callback, errback;
+  webdriver.promise.fullyResolved(promise).then(
+      callback = callbackHelper(function(resolved) {
+        webdriver.test.testutil.assertObjectEquals({'a': 123}, resolved);
+      }),
+      errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_rejectsIfHashPromiseRejects() {
+  var promise = webdriver.promise.fulfilled({
+      'a': createRejectedPromise(new StubError)
+  });
+
+  var pair = callbackPair(null, assertIsStubError);
+  webdriver.promise.fullyResolved(promise).then(
+    pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+function testFullyResolved_rejectsIfNestedHashPromiseRejects() {
+  var promise = webdriver.promise.fulfilled({
+      'a': {'b': createRejectedPromise(new StubError)}
+  });
+
+  var pair = callbackPair(null, assertIsStubError);
+  webdriver.promise.fullyResolved(promise).then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testFullyResolved_instantiatedObject() {
+  function Foo() {
+    this.bar = 'baz';
+  }
+  var foo = new Foo;
+
+  var callback, errback;
+  webdriver.promise.fullyResolved(foo).then(
+    callback = callbackHelper(function(resolvedFoo) {
+      assertEquals(foo, resolvedFoo);
+      assertTrue(resolvedFoo instanceof Foo);
+      webdriver.test.testutil.assertObjectEquals(new Foo, resolvedFoo);
+    }),
+    errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_withEmptyArray() {
+  var callback, errback;
+  webdriver.promise.fullyResolved([]).then(
+    callback = callbackHelper(function(resolved) {
+      assertArrayEquals([], resolved);
+    }),
+    errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_withEmptyHash() {
+  var callback, errback;
+  webdriver.promise.fullyResolved({}).then(
+    callback = callbackHelper(function(resolved) {
+      webdriver.test.testutil.assertObjectEquals({}, resolved);
+    }),
+    errback = callbackHelper());
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_arrayWithPromisedHash() {
+  var obj = {'foo': 'bar'};
+  var promise = webdriver.promise.fulfilled(obj);
+  var array = [promise];
+
+  var callback, errback;
+  webdriver.promise.fullyResolved(array).then(
+      callback = callbackHelper(function(resolved) {
+        webdriver.test.testutil.assertObjectEquals(resolved, [obj]);
+      }),
+      errback = callbackHelper());
+
+
+  clock.tick();
+  errback.assertNotCalled();
+  callback.assertCalled();
+}
+
+
+function testFullyResolved_aDomElement() {
+  var e = document.createElement('div');
+  var callbacks = callbackPair(function(resolved) {
+    assertEquals(e, resolved);
+  });
+
+  webdriver.promise.fullyResolved(e).
+      then(callbacks.callback, callbacks.errback);
+
+  clock.tick();
+  callbacks.assertCallback();
+}
+
+
+function testCallbackChain_nonSplit() {
+  var stage1 = callbackPair(),
+      stage2 = callbackPair(),
+      stage3 = callbackPair();
+
+  webdriver.promise.rejected('foo').
+      then(stage1.callback, stage1.errback).
+      then(stage2.callback, stage2.errback).
+      then(stage3.callback, stage3.errback);
+
+  clock.tick();
+  stage1.assertErrback('Wrong function for stage 1');
+  stage2.assertCallback('Wrong function for stage 2');
+  stage3.assertCallback('Wrong function for final stage');
+}
+
+
+function testCallbackChain_split() {
+  var stage1 = callbackPair(),
+      stage2 = callbackPair(),
+      stage3 = callbackPair();
+
+  webdriver.promise.rejected('foo').
+      then(stage1.callback).
+      thenCatch(stage1.errback).
+      then(stage2.callback).
+      thenCatch(stage2.errback).
+      then(stage3.callback, stage3.errback);
+
+  clock.tick();
+  stage1.assertErrback('Wrong function for stage 1');
+  stage2.assertCallback('Wrong function for stage 2');
+  stage3.assertCallback('Wrong function for final stage');
+}
+
+
+function testCheckedNodeCall_functionThrows() {
+  var error = new Error('boom');
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+  });
+
+  webdriver.promise.checkedNodeCall(function() {
+    throw error;
+  }).then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testCheckedNodeCall_functionReturnsAnError() {
+  var error = new Error('boom');
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+  });
+  webdriver.promise.checkedNodeCall(function(callback) {
+    callback(error);
+  }).then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testCheckedNodeCall_functionReturnsSuccess() {
+  var success = 'success!';
+  var pair = callbackPair(function(value) {
+    assertEquals(success, value);
+  });
+  webdriver.promise.checkedNodeCall(function(callback) {
+    callback(null, success);
+  }).then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testCheckedNodeCall_functionReturnsAndThrows() {
+  var error = new Error('boom');
+  var error2 = new Error('boom again');
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+  });
+  webdriver.promise.checkedNodeCall(function(callback) {
+    callback(error);
+    throw error2;
+  }).then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testCheckedNodeCall_functionThrowsAndReturns() {
+  var error = new Error('boom');
+  var error2 = new Error('boom again');
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error2, e);
+  });
+  webdriver.promise.checkedNodeCall(function(callback) {
+    setTimeout(goog.partial(callback, error), 10);
+    throw error2;
+  }).then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+  pair.reset();
+  clock.tick(Infinity);
+  pair.assertNeither();
+}
+
+
+function testCancel_passesTheCancellationReasonToReject() {
+  var pair = callbackPair(null, function(e) {
+    assertTrue(e instanceof webdriver.promise.CancellationError);
+    assertEquals('because i said so', e.message);
+  });
+  var d = new webdriver.promise.Deferred();
+  d.then(pair.callback, pair.errback);
+  d.cancel('because i said so');
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testCancel_canCancelADeferredFromAChainedPromise() {
+  var pair1 = callbackPair(null, function(e) {
+    assertTrue(e instanceof webdriver.promise.CancellationError);
+    assertEquals('because i said so', e.message);
+  });
+  var pair2 = callbackPair();
+
+  var d = new webdriver.promise.Deferred();
+  var p = d.then(pair1.callback, pair1.errback);
+  p.then(pair2.callback, pair2.errback);
+
+  p.cancel('because i said so');
+  clock.tick();
+  pair1.assertErrback('The first errback should have fired.');
+  pair2.assertCallback();
+}
+
+
+function testCancel_canCancelATimeout() {
+  var pair = callbackPair(null, function(e) {
+    assertTrue(e instanceof webdriver.promise.CancellationError);
+  });
+  var p = webdriver.promise.delayed(250).
+      then(pair.callback, pair.errback);
+  p.cancel();
+  clock.tick();
+  pair.assertErrback();
+  clock.tick(250);  // Just to make sure nothing happens.
+  pair.assertErrback();
+}
+
+
+function testCancel_cancelIsANoopOnceAPromiseHasBeenFulfilled() {
+  var p = webdriver.promise.fulfilled(123);
+  p.cancel();
+
+  var pair = callbackPair(goog.partial(assertEquals, 123));
+  p.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testCancel_cancelIsANoopOnceAPromiseHasBeenRejected() {
+  var p = webdriver.promise.rejected(new StubError);
+  p.cancel();
+
+  var pair = callbackPair(null, assertIsStubError);
+  p.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testCancel_noopCancelTriggeredOnCallbackOfResolvedPromise() {
+  var d = webdriver.promise.defer();
+  var p = d.promise.then();
+
+  d.fulfill();
+  p.cancel();  // This should not throw.
+}
+
+
+function testCallbackRegistersAnotherListener_callbacksConfiguredPreResolve() {
+  var messages = [];
+  var d = new webdriver.promise.Deferred();
+  d.promise.then(function() {
+    messages.push('a');
+    d.promise.then(function() {
+      messages.push('c');
+    });
+  });
+  d.promise.then(function() {
+    messages.push('b');
+  });
+  d.fulfill();
+  clock.tick();
+  assertArrayEquals(['a', 'c', 'b'], messages);
+}
+
+
+function testCallbackRegistersAnotherListener_callbacksConfiguredPostResolve() {
+  var messages = [];
+  var p = webdriver.promise.fulfilled();
+  p.then(function() {
+    messages.push('a');
+    p.then(function() {
+      messages.push('c');
+    });
+  });
+  p.then(function() {
+    messages.push('b');
+  });
+  clock.tick();
+  assertArrayEquals(['a', 'c', 'b'], messages);
+}
+
+
+function testCallbackRegistersAnotherListener_recursive() {
+  var order = [];
+  var promise = webdriver.promise.fulfilled();
+
+  promise.then(function() {
+    push();
+    promise.then(push);
+  }).then(function() {
+    push();
+  });
+
+  assertArrayEquals([], order);
+  clock.tick();
+  assertArrayEquals([0, 1, 2], order);
+
+  function push() {
+    order.push(order.length);
+  }
+}
+
+
+function testCallbackRegistersAnotherListener_recursiveCallbacks_many() {
+  var messages = [];
+  var start = 97;  // 'a'
+
+  var p = webdriver.promise.fulfilled();
+  p.then(push).then(function() {
+    messages.push('done');
+  });
+
+  function push() {
+    messages.push(String.fromCharCode(start++));
+    if (start != 101) {  // 'd'
+      p.then(push);
+    }
+  }
+
+  clock.tick();
+  assertArrayEquals(['a', 'b', 'c', 'd', 'done'], messages);
+}
+
+
+function testThenReturnsOwnPromiseIfNoCallbacksWereGiven() {
+  var deferred = new webdriver.promise.Deferred();
+  assertEquals(deferred.promise, deferred.promise.then());
+  assertEquals(deferred.promise, webdriver.promise.when(deferred.promise));
+}
+
+
+function testIsStillConsideredUnHandledIfNoCallbacksWereGivenOnCallsToThen() {
+  webdriver.promise.rejected(new StubError).then();
+  var handler = callbackHelper(assertIsStubError);
+
+  // so tearDown() doesn't throw
+  app.removeAllListeners();
+  app.on(webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION, handler);
+  clock.tick();
+  handler.assertCalled();
+}
+
+function testResolvedReturnsInputValueIfItIsAPromise() {
+  var input = webdriver.promise.fulfilled('a');
+  var output = webdriver.promise.fulfilled(input);
+  assertEquals(input, output);
+}
+
+
+function testADeferredsParentControlFlowIsActiveForCallbacks() {
+  var defaultFlow = webdriver.promise.controlFlow();
+
+  var flow1 = new webdriver.promise.ControlFlow();
+  var d = new webdriver.promise.Deferred(flow1);
+  d.fulfill();
+
+  var flow2 = new webdriver.promise.ControlFlow();
+  var d2 = new webdriver.promise.Deferred(flow2);
+  d2.fulfill();
+
+  assertIsFlow(defaultFlow);
+
+  var callbacks = callbackPair();
+  d.promise.then(assertIsFlow(flow1)).
+      then(assertIsFlow(flow1)).
+      then(function() {
+        return d2.promise.then(assertIsFlow(flow2));
+      }).
+      then(assertIsFlow(flow1)).
+      then(callbacks.callback, callbacks.errback);
+
+  clock.tick();
+  callbacks.assertCallback();
+  assertIsFlow(defaultFlow);
+
+  function assertIsFlow(flow) {
+    return function() {
+      assertEquals(flow, webdriver.promise.controlFlow());
+    };
+  }
+}
+
+
+function testPromiseAll_emptyArray() {
+  var pair = callbackPair(function(value) {
+    assertArrayEquals([], value);
+  });
+
+  webdriver.promise.all([]).then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testPromiseAll() {
+  var a = [
+      0, 1,
+      webdriver.promise.defer(),
+      webdriver.promise.defer(),
+      4, 5, 6
+  ];
+  delete a[5];
+
+  var pair = callbackPair(function(value) {
+    var expected = [0, 1, 2, 3, 4, 5, 6];
+    delete expected[5];
+    assertArrayEquals(expected, value);
+  });
+
+  webdriver.promise.all(a).then(pair.callback, pair.errback);
+  pair.assertNeither();
+
+  a[2].fulfill(2);
+  pair.assertNeither();
+
+  a[3].fulfill(3);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testPromiseAll_usesFirstRejection() {
+  var a = [
+    webdriver.promise.defer(),
+    webdriver.promise.defer()
+  ];
+
+  var pair = callbackPair(null, assertIsStubError);
+
+  webdriver.promise.all(a).then(pair.callback, pair.errback);
+  pair.assertNeither();
+
+  a[1].reject(new StubError);
+  clock.tick();
+  pair.assertErrback();
+
+  a[0].reject(Error('ignored'));
+  clock.tick(Infinity);
+}
+
+
+function testMappingAnArray() {
+  var a = [1, 2, 3];
+  var result = webdriver.promise.map(a, function(value, index, a2) {
+    assertEquals(a, a2);
+    assertEquals('not a number', 'number', typeof index);
+    return value + 1;
+  });
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals([2, 3, 4], value);
+  });
+
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testMappingAnArray_omitsDeleted() {
+  var a = [0, 1, 2, 3, 4, 5, 6];
+  delete a[1];
+  delete a[3];
+  delete a[4];
+  delete a[6];
+
+  var result = webdriver.promise.map(a, function(value) {
+    return value * value;
+  });
+
+  var expected = [0, 1, 4, 9, 16, 25, 36];
+  delete expected[1];
+  delete expected[3];
+  delete expected[4];
+  delete expected[6];
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals(expected, value);
+  });
+
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testMappingAnArray_emptyArray() {
+  var result = webdriver.promise.map([], function(value) {
+    return value + 1;
+  });
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals([], value);
+  });
+
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testMappingAnArray_inputIsPromise() {
+  var input = webdriver.promise.defer();
+  var result = webdriver.promise.map(input, function(value) {
+    return value + 1;
+  });
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals([2, 3, 4], value);
+  });
+
+  result.then(pair.callback, pair.errback);
+  pair.assertNeither();
+  input.fulfill([1, 2, 3]);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testMappingAnArray_waitsForFunctionResultToResolve() {
+  var innerResults = [
+    webdriver.promise.defer(),
+    webdriver.promise.defer()
+  ];
+
+  var result = webdriver.promise.map([1, 2], function(value, index) {
+    return innerResults[index].promise;
+  });
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals(['a', 'b'], value);
+  });
+
+  result.then(pair.callback, pair.errback);
+  pair.assertNeither();
+
+  innerResults[0].fulfill('a');
+  clock.tick();
+  pair.assertNeither();
+
+  innerResults[1].fulfill('b');
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testMappingAnArray_rejectsPromiseIfFunctionThrows() {
+  var result = webdriver.promise.map([1], throwStubError);
+  var pair = callbackPair(null, assertIsStubError);
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testMappingAnArray_rejectsPromiseIfFunctionReturnsRejectedPromise() {
+  var result = webdriver.promise.map([1], function() {
+    return webdriver.promise.rejected(new StubError);
+  });
+
+  var pair = callbackPair(null, assertIsStubError);
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testMappingAnArray_stopsCallingFunctionIfPreviousIterationFailed() {
+  var count = 0;
+  var result = webdriver.promise.map([1, 2, 3, 4], function() {
+    count++;
+    if (count == 3) {
+      throw new StubError;
+    }
+  });
+
+  var pair = callbackPair(null, assertIsStubError);
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+  assertEquals(3, count);
+}
+
+
+function testMappingAnArray_rejectsWithFirstRejectedPromise() {
+  var innerResult = [
+      webdriver.promise.fulfilled(),
+      createRejectedPromise(new StubError),
+      createRejectedPromise(Error('should be ignored'))
+  ];
+  var count = 0;
+  var result = webdriver.promise.map([1, 2, 3, 4], function(value, index) {
+    count += 1;
+    return innerResult[index];
+  });
+
+  var pair = callbackPair(null, assertIsStubError);
+  result.then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+  assertEquals(2, count);
+}
+
+
+function testMappingAnArray_preservesOrderWhenMapReturnsPromise() {
+  var deferreds = [
+    webdriver.promise.defer(),
+    webdriver.promise.defer(),
+    webdriver.promise.defer(),
+    webdriver.promise.defer()
+  ];
+  var result = webdriver.promise.map(deferreds, function(value) {
+    return value.promise;
+  });
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals([0, 1, 2, 3], value);
+  });
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertNeither();
+
+  goog.array.forEachRight(deferreds, function(d, i) {
+    d.fulfill(i);
+  });
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testFilteringAnArray() {
+  var a = [0, 1, 2, 3];
+  var result = webdriver.promise.filter(a, function(val, index, a2) {
+    assertEquals(a, a2);
+    assertEquals('not a number', 'number', typeof index);
+    return val > 1;
+  });
+
+  var pair = callbackPair(function(val) {
+    assertArrayEquals([2, 3], val);
+  });
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testFilteringAnArray_omitsDeleted() {
+  var a = [0, 1, 2, 3, 4, 5, 6];
+  delete a[3];
+  delete a[4];
+
+  var result = webdriver.promise.filter(a, function(value) {
+    return value > 1 && value < 6;
+  });
+
+  var pair = callbackPair(function(val) {
+    assertArrayEquals([2, 5], val);
+  });
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testFilteringAnArray_preservesInputs() {
+  var a = [0, 1, 2, 3];
+
+  var result = webdriver.promise.filter(a, function(value, i, a2) {
+    assertEquals(a, a2);
+    // Even if a function modifies the input array, the original value
+    // should be inserted into the new array.
+    a2[i] = a2[i] - 1;
+    return a2[i] >= 1;
+  });
+
+  var pair = callbackPair(function(val) {
+    assertArrayEquals([2, 3], val);
+  });
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testFilteringAnArray_inputIsPromise() {
+  var input = webdriver.promise.defer();
+  var result = webdriver.promise.filter(input, function(value) {
+    return value > 1 && value < 3;
+  });
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals([2], value);
+  });
+
+  result.then(pair.callback, pair.errback);
+  pair.assertNeither();
+  input.fulfill([1, 2, 3]);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testFilteringAnArray_waitsForFunctionResultToResolve() {
+  var innerResults = [
+    webdriver.promise.defer(),
+    webdriver.promise.defer()
+  ];
+
+  var result = webdriver.promise.filter([1, 2], function(value, index) {
+    return innerResults[index].promise;
+  });
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals([2], value);
+  });
+
+  result.then(pair.callback, pair.errback);
+  pair.assertNeither();
+
+  innerResults[0].fulfill(false);
+  clock.tick();
+  pair.assertNeither();
+
+  innerResults[1].fulfill(true);
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testFilteringAnArray_rejectsPromiseIfFunctionReturnsRejectedPromise() {
+  var result = webdriver.promise.filter([1], function() {
+    return webdriver.promise.rejected(new StubError);
+  });
+
+  var pair = callbackPair(null, assertIsStubError);
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testFilteringAnArray_stopsCallingFunctionIfPreviousIterationFailed() {
+  var count = 0;
+  var result = webdriver.promise.filter([1, 2, 3, 4], function() {
+    count++;
+    if (count == 3) {
+      throw new StubError;
+    }
+  });
+
+  var pair = callbackPair(null, assertIsStubError);
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+  assertEquals(3, count);
+}
+
+
+function testFilteringAnArray_rejectsWithFirstRejectedPromise() {
+  var innerResult = [
+    webdriver.promise.fulfilled(),
+    createRejectedPromise(new StubError),
+    createRejectedPromise(Error('should be ignored'))
+  ];
+  var result = webdriver.promise.filter([1, 2, 3, 4], function(value, index) {
+    assertTrue(index < innerResult.length);
+    return innerResult[index];
+  });
+
+  var pair = callbackPair(null, assertIsStubError);
+  result.then(pair.callback, pair.errback);
+  pair.assertNeither();
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testFilteringAnArray_preservesOrderWhenFilterReturnsPromise() {
+  var deferreds = [
+    webdriver.promise.defer(),
+    webdriver.promise.defer(),
+    webdriver.promise.defer(),
+    webdriver.promise.defer()
+  ];
+  var result = webdriver.promise.filter([0, 1, 2, 3], function(value, index) {
+    return deferreds[index].promise;
+  });
+
+  var pair = callbackPair(function(value) {
+    assertArrayEquals([1, 2], value);
+  });
+  result.then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertNeither();
+
+  goog.array.forEachRight(deferreds, function(d, i) {
+    d.fulfill(i > 0 && i < 3);
+  });
+  clock.tick();
+  pair.assertCallback();
+}
+
+
+function testAddThenableImplementation() {
+  function tmp() {}
+  assertFalse(webdriver.promise.Thenable.isImplementation(new tmp()));
+  webdriver.promise.Thenable.addImplementation(tmp);
+  assertTrue(webdriver.promise.Thenable.isImplementation(new tmp()));
+}
+
+
+function testLongStackTraces_doesNotAppendStackIfFeatureDisabled() {
+  webdriver.promise.LONG_STACK_TRACES = false;
+
+  var error = Error('hello');
+  var originalStack = error.stack;
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+    assertEquals(originalStack, e.stack);
+  });
+  webdriver.promise.rejected(error).
+      then(fail).
+      then(fail).
+      then(fail).
+      then(pair.callback, pair.errback);
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function getStackMessages(error) {
+  var stack = webdriver.stacktrace.getStack(error);
+  return goog.array.filter(stack.split(/\n/), function(line) {
+    return /^From: /.test(line);
+  });
+}
+
+
+function testLongStackTraces_appendsInitialPromiseCreation_resolverThrows() {
+  webdriver.promise.LONG_STACK_TRACES = true;
+
+  var error = Error('hello');
+  var originalStack = '(placeholder; will be overwritten later)';
+
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+    if (!goog.isString(originalStack)) {
+      return;
+    }
+    assertNotEquals(originalStack, e.stack);
+    assertTrue('should start with original stack',
+        goog.string.startsWith(e.stack, originalStack));
+    assertArrayEquals(['From: Promise: new'], getStackMessages(e));
+  });
+
+  new webdriver.promise.Promise(function() {
+    try {
+      throw error;
+    } catch (e) {
+      originalStack = e.stack;
+      throw e;
+    }
+  }).then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testLongStackTraces_appendsInitialPromiseCreation_rejectCalled() {
+  webdriver.promise.LONG_STACK_TRACES = true;
+
+  var error = Error('hello');
+  var originalStack = error.stack;
+
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+    if (!goog.isString(originalStack)) {
+      return;
+    }
+    assertNotEquals(originalStack, e.stack);
+    assertTrue('should start with original stack',
+        goog.string.startsWith(e.stack, originalStack));
+    assertArrayEquals(['From: Promise: new'], getStackMessages(e));
+  });
+
+  new webdriver.promise.Promise(function(_, reject) {
+    reject(error);
+  }).then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testLongStackTraces_appendsEachStepToRejectionError() {
+  webdriver.promise.LONG_STACK_TRACES = true;
+
+  var error = Error('hello');
+  var originalStack = '(placeholder; will be overwritten later)';
+
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+    if (!goog.isString(originalStack)) {
+      return;
+    }
+    assertNotEquals(originalStack, e.stack);
+    assertTrue('should start with original stack',
+        goog.string.startsWith(e.stack, originalStack));
+    assertArrayEquals([
+      'From: Promise: new',
+      'From: Promise: then',
+      'From: Promise: thenCatch',
+      'From: Promise: then',
+      'From: Promise: thenCatch',
+    ], getStackMessages(e));
+  });
+
+  new webdriver.promise.Promise(function() {
+    try {
+      throw error;
+    } catch (e) {
+      originalStack = e.stack;
+      throw e;
+    }
+  }).
+  then(fail).
+  thenCatch(function(e) { throw e; }).
+  then(fail).
+  thenCatch(function(e) { throw e; }).
+  then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
+
+
+function testLongStackTraces_errorOccursInCallbackChain() {
+  webdriver.promise.LONG_STACK_TRACES = true;
+
+  var error = Error('hello');
+  var originalStack = '(placeholder; will be overwritten later)';
+
+  var pair = callbackPair(null, function(e) {
+    assertEquals(error, e);
+    if (!goog.isString(originalStack)) {
+      return;
+    }
+    assertNotEquals(originalStack, e.stack);
+    assertTrue('should start with original stack',
+        goog.string.startsWith(e.stack, originalStack));
+    assertArrayEquals([
+      'From: Promise: then',
+      'From: Promise: thenCatch',
+    ], getStackMessages(e));
+  });
+
+  webdriver.promise.fulfilled().
+      then(goog.nullFunction).
+      then(goog.nullFunction).
+      then(function() {
+        try {
+          throw error;
+        } catch (e) {
+          originalStack = e.stack;
+          throw e;
+        }
+      }).
+      thenCatch(function(e) { throw e; }).
+      then(pair.callback, pair.errback);
+
+  clock.tick();
+  pair.assertErrback();
+}
diff --git a/lib/webdriver/test/stacktrace_test.js b/lib/webdriver/test/stacktrace_test.js
new file mode 100644
index 0000000..8dd4d92
--- /dev/null
+++ b/lib/webdriver/test/stacktrace_test.js
@@ -0,0 +1,480 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('bot.Error');
+goog.require('bot.ErrorCode');
+goog.require('goog.string');
+goog.require('goog.testing.JsUnitException');
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.StrictMock');
+goog.require('goog.testing.jsunit');
+goog.require('goog.testing.stacktrace');
+goog.require('webdriver.stacktrace');
+goog.require('webdriver.test.testutil');
+
+var stubs;
+
+function setUpPage() {
+  stubs = new goog.testing.PropertyReplacer();
+}
+
+function tearDown() {
+  stubs.reset();
+}
+
+
+function assertStackFrame(message, frameOrFrameString, expectedFrame) {
+  var frame = frameOrFrameString;
+  if (goog.isString(frame)) {
+    frame = webdriver.stacktrace.parseStackFrame_(frame);
+    assertNotNull(message + '\nunable to parse frame: ' + frameOrFrameString,
+        frame);
+  }
+  var diff = [];
+  for (var prop in expectedFrame) {
+    if (goog.isString(expectedFrame[prop]) &&
+        frame[prop] !== expectedFrame[prop]) {
+      diff.push([
+        prop, ': <', expectedFrame[prop], '> !== <', frame[prop], '>'
+      ].join(''));
+    }
+  }
+  if (diff.length) {
+    fail(message +
+        '\nfor:      <' + frameOrFrameString + '>' +
+        '\nexpected: <' + expectedFrame + '>' +
+        '\nbut was:  <' + frame + '>' +
+        '\n    ' +
+        diff.join('\n    '));
+  }
+}
+
+function assertFrame(frame, file, line) {
+  // Normalize path for when run through Node.js on Windows.
+  var url = frame.getUrl().replace(/\\/g, '/');
+  assertContains('/' + file, url);
+  assertEquals(line, frame.getLine());
+}
+
+function testGetStacktraceFromFile() {
+  if (!webdriver.stacktrace.BROWSER_SUPPORTED) {
+    return false;
+  }
+
+  var stacktrace = webdriver.test.testutil.getStackTrace();
+  assertFrame(stacktrace[0], 'testutil.js', 50);
+  assertFrame(stacktrace[1], 'stacktrace_test.js', 78);
+}
+
+function testGetStacktraceWithUrlOnLine() {
+  if (!webdriver.stacktrace.BROWSER_SUPPORTED) {
+    return false;
+  }
+
+  // The url argument is intentionally ignored here.
+  function getStacktraceWithUrlArgument(url) {
+    return webdriver.stacktrace.get();
+  }
+
+  var stacktrace = getStacktraceWithUrlArgument('http://www.google.com');
+  assertFrame(stacktrace[0], 'stacktrace_test.js', 90);
+
+  stacktrace = getStacktraceWithUrlArgument('http://www.google.com/search');
+  assertFrame(stacktrace[0], 'stacktrace_test.js', 90);
+}
+
+function testParseStackFrameInV8() {
+  assertStackFrame('exception name only (node v0.8)',
+      '    at Error (unknown source)',
+      new webdriver.stacktrace.Frame('', 'Error', '', 'unknown source'));
+
+  assertStackFrame('exception name only (chrome v22)',
+      '    at Error (<anonymous>)',
+      new webdriver.stacktrace.Frame('', 'Error', '', '<anonymous>'));
+
+  assertStackFrame('context object + function name + url',
+      '    at Object.assert (file:///.../asserts.js:29:10)',
+      new webdriver.stacktrace.Frame('Object', 'assert', '',
+          'file:///.../asserts.js:29:10'));
+
+  assertStackFrame('context object + function name + file',
+      '    at Object.assert (asserts.js:29:10)',
+      new webdriver.stacktrace.Frame('Object', 'assert', '',
+          'asserts.js:29:10'));
+
+  assertStackFrame('context object + anonymous function + file',
+      '    at Interface.<anonymous> (repl.js:182:12)',
+      new webdriver.stacktrace.Frame('Interface', '<anonymous>', '',
+          'repl.js:182:12'));
+
+  assertStackFrame('url only',
+      '    at http://www.example.com/jsunit.js:117:13',
+      new webdriver.stacktrace.Frame('', '', '',
+          'http://www.example.com/jsunit.js:117:13'));
+
+  assertStackFrame('file only',
+      '    at repl:1:57',
+      new webdriver.stacktrace.Frame('', '', '', 'repl:1:57'));
+
+  assertStackFrame('function alias',
+      '    at [object Object].exec [as execute] (file:///foo)',
+      new webdriver.stacktrace.Frame('[object Object]', 'exec',
+          'execute', 'file:///foo'));
+
+  assertStackFrame('constructor call',
+      '    at new Class (file:///foo)',
+      new webdriver.stacktrace.Frame('new ', 'Class', '', 'file:///foo'));
+
+  assertStackFrame('object property constructor call',
+      '    at new [object Object].foo (repl:1:2)',
+      new webdriver.stacktrace.Frame('new [object Object]', 'foo', '',
+          'repl:1:2'));
+
+  assertStackFrame('namespaced constructor call',
+      '    at new foo.bar.Class (foo:1:2)',
+      new webdriver.stacktrace.Frame('new foo.bar', 'Class', '', 'foo:1:2'));
+
+  assertStackFrame('anonymous constructor call',
+      '    at new <anonymous> (file:///foo)',
+      new webdriver.stacktrace.Frame('new ', '<anonymous>', '',
+          'file:///foo'));
+
+  assertStackFrame('native function call',
+      '    at Array.forEach (native)',
+      new webdriver.stacktrace.Frame('Array', 'forEach', '', 'native'));
+
+  assertStackFrame('eval',
+      '    at foo (eval at file://bar)',
+      new webdriver.stacktrace.Frame('', 'foo', '', 'eval at file://bar'));
+
+  assertStackFrame('nested anonymous eval',
+      '    at eval (eval at <anonymous> (unknown source), <anonymous>:2:7)',
+      new webdriver.stacktrace.Frame('', 'eval', '',
+          'eval at <anonymous> (unknown source), <anonymous>:2:7'));
+
+  assertStackFrame('Url containing parentheses',
+      '    at Object.assert (http://bar:4000/bar.js?value=(a):150:3)',
+      new webdriver.stacktrace.Frame('Object', 'assert', '',
+          'http://bar:4000/bar.js?value=(a):150:3'));
+
+  assertStackFrame('Frame with non-standard leading whitespace (issue 7994)',
+      '  at module.exports.runCucumber (/local/dir/path)',
+      new webdriver.stacktrace.Frame('module.exports', 'runCucumber', '',
+          '/local/dir/path'));
+}
+
+function testParseClosureCanonicalStackFrame() {
+  assertStackFrame('unknown frame', '> (unknown)',
+      webdriver.stacktrace.ANONYMOUS_FRAME_);
+  assertStackFrame('anonymous frame', '> anonymous',
+      webdriver.stacktrace.ANONYMOUS_FRAME_);
+
+  assertStackFrame('name only', '> foo',
+      new webdriver.stacktrace.Frame('', 'foo', '', ''));
+
+  assertStackFrame('name and path', '> foo at http://x:123',
+      new webdriver.stacktrace.Frame('', 'foo', '', 'http://x:123'));
+
+  assertStackFrame('anonymous function with path',
+      '> anonymous at file:///x/y/z',
+      new webdriver.stacktrace.Frame('', 'anonymous', '', 'file:///x/y/z'));
+
+  assertStackFrame('anonymous function with v8 path',
+      '> anonymous at /x/y/z:12:34',
+      new webdriver.stacktrace.Frame('', 'anonymous', '', '/x/y/z:12:34'));
+
+  assertStackFrame('context and name only',
+      '> foo.bar', new webdriver.stacktrace.Frame('foo', 'bar', '', ''));
+
+  assertStackFrame('name and alias',
+      '> foo [as bar]', new webdriver.stacktrace.Frame('', 'foo', 'bar', ''));
+
+  assertStackFrame('context, name, and alias',
+      '> foo.bar [as baz]',
+      new webdriver.stacktrace.Frame('foo', 'bar', 'baz', ''));
+
+  assertStackFrame('path only', '> http://x:123',
+      new webdriver.stacktrace.Frame('', '', '', 'http://x:123'));
+
+  assertStackFrame('name and arguments',
+      '> foo(arguments)', new webdriver.stacktrace.Frame('', 'foo', '', ''));
+
+  assertStackFrame('full frame',
+      '> foo.bar(123, "abc") [as baz] at http://x:123',
+      new webdriver.stacktrace.Frame('foo', 'bar', 'baz', 'http://x:123'));
+
+  assertStackFrame('name and url with sub-domain',
+      '> foo at http://x.y.z:80/path:1:2',
+      new webdriver.stacktrace.Frame('', 'foo', '',
+          'http://x.y.z:80/path:1:2'));
+
+  assertStackFrame('name and url with sub-domain',
+      '> foo.bar.baz at http://x.y.z:80/path:1:2',
+      new webdriver.stacktrace.Frame('foo.bar', 'baz', '',
+          'http://x.y.z:80/path:1:2'));
+}
+
+// All test strings are parsed with the conventional and long
+// frame algorithms.
+function testParseStackFrameInFirefox() {
+  var frameString = 'Error("Assertion failed")@:0';
+  var frame = webdriver.stacktrace.parseStackFrame_(frameString);
+  var expected = new webdriver.stacktrace.Frame('', 'Error', '', '');
+  assertObjectEquals('function name + arguments', expected, frame);
+
+  frame = webdriver.stacktrace.parseLongFirefoxFrame_(frameString);
+  assertObjectEquals('function name + arguments', expected, frame);
+
+  frameString = '()@file:///foo:42';
+  frame = webdriver.stacktrace.parseStackFrame_(frameString);
+  expected = new webdriver.stacktrace.Frame('', '', '', 'file:///foo:42');
+  assertObjectEquals('anonymous function', expected, frame);
+
+  frame = webdriver.stacktrace.parseLongFirefoxFrame_(frameString);
+  assertObjectEquals('anonymous function', expected, frame);
+
+  frameString = '@javascript:alert(0)';
+  frame = webdriver.stacktrace.parseStackFrame_(frameString);
+  expected = new webdriver.stacktrace.Frame('', '', '', 'javascript:alert(0)');
+  assertObjectEquals('anonymous function', expected, frame);
+
+  frame = webdriver.stacktrace.parseLongFirefoxFrame_(frameString);
+  assertObjectEquals('anonymous function', expected, frame);
+}
+
+function testStringRepresentation() {
+  var frame = new webdriver.stacktrace.Frame('window', 'foo', 'bar',
+      'http://x?a=1&b=2:1');
+  assertEquals('    at window.foo [as bar] (http://x?a=1&b=2:1)',
+      frame.toString());
+
+  frame = new webdriver.stacktrace.Frame('', 'Error', '', '');
+  assertEquals('    at Error (<anonymous>)', frame.toString());
+
+  assertEquals('    at <anonymous>',
+      webdriver.stacktrace.ANONYMOUS_FRAME_.toString());
+
+  frame = new webdriver.stacktrace.Frame('', '', '', 'http://x:123');
+  assertEquals('    at http://x:123', frame.toString());
+
+  frame = new webdriver.stacktrace.Frame('foo', 'bar', '', 'http://x:123');
+  assertEquals('    at foo.bar (http://x:123)', frame.toString());
+
+  frame = new webdriver.stacktrace.Frame('new ', 'Foo', '', 'http://x:123');
+  assertEquals('    at new Foo (http://x:123)', frame.toString());
+
+  frame = new webdriver.stacktrace.Frame('new foo', 'Bar', '', '');
+  assertEquals('    at new foo.Bar (<anonymous>)', frame.toString());
+}
+
+// Create a stack trace string with one modest record and one long record,
+// Verify that all frames are parsed. The length of the long arg is set
+// to blow Firefox 3x's stack if put through a RegExp.
+function testParsingLongStackTrace() {
+  var longArg = goog.string.buildString(
+      '(', goog.string.repeat('x', 1000000), ')');
+  var stackTrace = goog.string.buildString(
+      'shortFrame()@:0\n',
+      'longFrame',
+      longArg,
+      '@http://google.com/somescript:0\n');
+  var frames = webdriver.stacktrace.parse_(stackTrace);
+  assertEquals('number of returned frames', 2, frames.length);
+  var expected = new webdriver.stacktrace.Frame('', 'shortFrame', '', '');
+  assertStackFrame('short frame', frames[0], expected);
+
+  expected = new webdriver.stacktrace.Frame(
+      '', 'longFrame', '', 'http://google.com/somescript:0');
+  assertStackFrame('exception name only', frames[1], expected);
+}
+
+function testRemovesV8MessageHeaderBeforeParsingStack() {
+  var stack =
+        '    at Color.red (http://x:1234)\n' +
+        '    at Foo.bar (http://y:5678)';
+
+  var frames = webdriver.stacktrace.parse_(stack);
+  assertEquals(2, frames.length);
+  assertEquals('    at Color.red (http://x:1234)', frames[0].toString());
+  assertEquals('    at Foo.bar (http://y:5678)', frames[1].toString());
+}
+
+function testCanParseClosureJsUnitExceptions() {
+  stubs.set(goog.testing.stacktrace, 'get', function() {
+    return '> Color.red at http://x:1234\n' +
+           '> Foo.bar at http://y:5678';
+  });
+
+  var error = new goog.testing.JsUnitException('stub');
+  stubs.reset();
+
+  var frames = webdriver.stacktrace.parse_(error.stackTrace);
+  assertEquals(2, frames.length);
+  assertEquals('    at Color.red (http://x:1234)', frames[0].toString());
+  assertEquals('    at Foo.bar (http://y:5678)', frames[1].toString());
+}
+
+function testFormattingAV8StyleError() {
+  var errorStub = {
+    name: 'Error',
+    message: 'foo',
+    toString: function() { return 'Error: foo'; },
+    stack:
+        'Error: foo\n' +
+        '    at Color.red (http://x:1234)\n' +
+        '    at Foo.bar (http://y:5678)'
+  };
+
+  var ret = webdriver.stacktrace.format(errorStub);
+  assertEquals(errorStub, ret);
+  assertEquals([
+    'Error: foo',
+    '    at Color.red (http://x:1234)',
+    '    at Foo.bar (http://y:5678)'
+  ].join('\n'), ret.stack);
+}
+
+function testFormattingAFirefoxStyleError() {
+  var errorStub = {
+    name: 'Error',
+    message: 'boom',
+    toString: function() { return 'Error: boom'; },
+    stack:
+        'foo@file:///foo/foo.js:1\n' +
+        '@file:///bar/bar.js:1'
+  };
+
+  var ret = webdriver.stacktrace.format(errorStub);
+  assertEquals(errorStub, ret);
+  assertEquals([
+    'Error: boom',
+    '    at foo (file:///foo/foo.js:1)',
+    '    at file:///bar/bar.js:1'
+  ].join('\n'), ret.stack);
+}
+
+function testInsertsAnAnonymousFrameWhenUnableToParse() {
+  var errorStub = {
+    name: 'Error',
+    message: 'boom',
+    toString: function() { return 'Error: boom'; },
+    stack:
+        'foo@file:///foo/foo.js:1\n' +
+        'this is unparsable garbage\n' +
+        '@file:///bar/bar.js:1'
+  };
+
+  var ret = webdriver.stacktrace.format(errorStub);
+  assertEquals(errorStub, ret);
+  assertEquals([
+    'Error: boom',
+    '    at foo (file:///foo/foo.js:1)',
+    '    at <anonymous>',
+    '    at file:///bar/bar.js:1'
+  ].join('\n'), ret.stack);
+}
+
+function testFormattingBotErrors() {
+  var error = new bot.Error(bot.ErrorCode.NO_SUCH_ELEMENT, 'boom');
+  var expectedStack = [
+    'NoSuchElementError: boom',
+    '    at Color.red (http://x:1234)',
+    '    at Foo.bar (http://y:5678)'
+  ].join('\n');
+  error.stack = expectedStack;
+
+  var ret = webdriver.stacktrace.format(error);
+  assertEquals(ret, error);
+  assertEquals(expectedStack, error.stack);
+}
+
+function testFormatsUsingNameAndMessageIfAvailable() {
+  var ret = webdriver.stacktrace.format({
+    name: 'TypeError',
+    message: 'boom'
+  });
+  assertEquals('TypeError: boom\n', ret.stack);
+
+  ret = webdriver.stacktrace.format({
+    message: 'boom'
+  });
+  assertEquals('boom\n', ret.stack);
+
+  ret = webdriver.stacktrace.format({
+    toString: function() {
+      return 'Hello world'
+    }
+  });
+  assertEquals('Hello world\n', ret.stack);
+
+  ret = webdriver.stacktrace.format({
+    name: 'TypeError',
+    message: 'boom',
+    toString: function() {
+      return 'Should not use this'
+    }
+  });
+  assertEquals('TypeError: boom\n', ret.stack);
+}
+
+function testDoesNotFormatErrorIfOriginalStacktraceIsInAnUnexpectedFormat() {
+  var error = Error('testing');
+  var stack = error.stack = [
+    'Error: testing',
+    '..> at Color.red (http://x:1234)',
+    '..> at Foo.bar (http://y:5678)'
+  ].join('\n');
+
+  var ret = webdriver.stacktrace.format(error);
+  assertEquals(ret, error);
+  assertEquals(stack, error.stack);
+}
+
+function testParseStackFrameInIE10() {
+  assertStackFrame('name and path',
+      '   at foo (http://bar:4000/bar.js:150:3)',
+      new webdriver.stacktrace.Frame('', 'foo', '',
+          'http://bar:4000/bar.js:150:3'));
+
+  assertStackFrame('Anonymous function',
+      '   at Anonymous function (http://bar:4000/bar.js:150:3)',
+      new webdriver.stacktrace.Frame('', 'Anonymous function', '',
+          'http://bar:4000/bar.js:150:3'));
+
+  assertStackFrame('Global code',
+      '   at Global code (http://bar:4000/bar.js:150:3)',
+      new webdriver.stacktrace.Frame('', 'Global code', '',
+          'http://bar:4000/bar.js:150:3'));
+
+  assertStackFrame('eval code',
+      '   at foo (eval code:150:3)',
+      new webdriver.stacktrace.Frame('', 'foo', '', 'eval code:150:3'));
+
+  assertStackFrame('nested eval',
+      '   at eval code (eval code:150:3)',
+      new webdriver.stacktrace.Frame('', 'eval code', '', 'eval code:150:3'));
+
+  assertStackFrame('Url containing parentheses',
+      '   at foo (http://bar:4000/bar.js?value=(a):150:3)',
+      new webdriver.stacktrace.Frame('', 'foo', '',
+          'http://bar:4000/bar.js?value=(a):150:3'));
+
+  assertStackFrame('Url ending with parentheses',
+      '   at foo (http://bar:4000/bar.js?a=))',
+      new webdriver.stacktrace.Frame('', 'foo', '',
+          'http://bar:4000/bar.js?a=)'));
+}
diff --git a/lib/webdriver/test/test_bootstrap.js b/lib/webdriver/test/test_bootstrap.js
new file mode 100644
index 0000000..e429377
--- /dev/null
+++ b/lib/webdriver/test/test_bootstrap.js
@@ -0,0 +1,67 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Bootstrap file that loads all of the WebDriver scripts in the
+ * correct order. Once loaded, pages can use {@code goog.require} statements
+ * from Google Closure to load additional files as needed.
+ *
+ * Example Usage:
+ *
+ * <html>
+ *   <head>
+ *     <script src="test_bootstrap.js"></script>
+ *     <script>
+ *       goog.require('goog.debug.Logger');
+ *     </script>
+ *     <script>
+ *       window.onload = function() {
+ *         goog.debug.Logger.getLogger('').info(
+ *             'The page has finished loading');
+ *       };
+ *     </script>
+ *   </head>
+ *   <body></body>
+ * </html>
+ */
+
+(function() {
+  var scripts = document.getElementsByTagName('script');
+  var directoryPath = './';
+  var thisFile = 'test_bootstrap.js';
+
+  for (var i = 0; i < scripts.length; i++) {
+    var src = scripts[i].src;
+    var len = src.length;
+    if (src.substr(len - thisFile.length) == thisFile) {
+      directoryPath = src.substr(0, len - thisFile.length);
+      break;
+    }
+  }
+
+  // All of the files to load. Files are specified in the order they must be
+  // loaded, NOT alphabetical order.
+  var files = [
+    '../../../third_party/closure/goog/base.js',
+    '../../deps.js'
+  ];
+
+  for (var j = 0; j < files.length; j++) {
+    document.write('<script type="text/javascript" src="' +
+        directoryPath + files[j] + '"></script>');
+  }
+})();
diff --git a/lib/webdriver/test/testing/asserts_test.js b/lib/webdriver/test/testing/asserts_test.js
new file mode 100644
index 0000000..c5e0681
--- /dev/null
+++ b/lib/webdriver/test/testing/asserts_test.js
@@ -0,0 +1,117 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.test.testutil');
+goog.require('webdriver.testing.assert');
+goog.require('webdriver.testing.asserts');
+
+var assert = webdriver.testing.assert;
+var result;
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+
+function setUp() {
+  result = webdriver.test.testutil.callbackPair();
+}
+
+
+function testAssertion_nonPromiseValue_valueMatches() {
+  assert('foo').equalTo('foo');
+  // OK if it does not throw.
+}
+
+
+function testAssertion_nonPromiseValue_notValueMatches() {
+  var a = assert('foo');
+  assertThrows(goog.bind(a.equalTo, a, 'bar'));
+}
+
+
+function testAssertion_promiseValue_valueMatches() {
+  return assert(webdriver.promise.fulfilled('foo')).equalTo('foo');
+}
+
+
+function testAssertion_promiseValue_notValueMatches() {
+  var d = new webdriver.promise.Deferred();
+  return assert(webdriver.promise.fulfilled('bar')).equalTo('foo').
+      then(fail, goog.nullFunction);
+}
+
+
+function testAssertion_promiseValue_promiseRejected() {
+  var err = Error();
+  return assert(webdriver.promise.rejected(err)).equalTo('foo').
+      then(fail, function(e) {
+        assertEquals(err, e);
+      });
+}
+
+
+function testAssertion_decoration() {
+  assert('foo').is.equalTo('foo');
+  // Ok if no throws.
+}
+
+
+function testAssertion_negation() {
+  var a = assert('false');
+
+  a.not.equalTo('bar');  // OK if this does not throw.
+  a.is.not.equalTo('bar');  // OK if this does not throw.
+
+  var notA = a.not;
+  assertThrows(goog.bind(notA.equalTo, notA, 123));
+
+  notA = a.is.not;
+  assertThrows(goog.bind(notA.equalTo, notA, 123));
+}
+
+
+function testApplyMatcher_nonPromiseValue_valueMatches() {
+  return assertThat('foo', equals('foo'));
+}
+
+
+function testApplyMatcher_nonPromiseValue_notValueMatches() {
+  return assertThat('foo', equals('bar')).then(fail, goog.nullFunction);
+}
+
+
+function testApplyMatcher_promiseValue_valueMatches() {
+  return assertThat(webdriver.promise.fulfilled('foo'), equals('foo'));
+}
+
+
+function testApplyMatcher_promiseValue_notValueMatches() {
+  return assertThat(webdriver.promise.fulfilled('bar'), equals('foo')).
+      then(fail, goog.nullFunction);
+}
+
+
+function testApplyMatcher_promiseValue_promiseRejected() {
+  var err = Error();
+  return assertThat(webdriver.promise.rejected(err), equals('foo')).
+      then(fail, function(e) {
+        assertEquals(err, e);
+      });
+}
diff --git a/lib/webdriver/test/testing/client_test.js b/lib/webdriver/test/testing/client_test.js
new file mode 100644
index 0000000..f1179ba
--- /dev/null
+++ b/lib/webdriver/test/testing/client_test.js
@@ -0,0 +1,88 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.MockControl');
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.testing.Client');
+
+var FAKE_WINDOW = {
+  location: {
+    pathname: '/foo/bar/baz'
+  }
+};
+
+function FakeXhr() {}
+FakeXhr.prototype.open = goog.nullFunction;
+FakeXhr.prototype.send = goog.nullFunction;
+
+var stubs = new goog.testing.PropertyReplacer;
+var control = new goog.testing.MockControl;
+var mockXhr;
+var client;
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+function setUp() {
+  client = new webdriver.testing.Client(FAKE_WINDOW);
+  mockXhr = control.createStrictMock(FakeXhr);
+  stubs.set(goog.net, 'XmlHttp', function() {
+    return mockXhr;
+  });
+}
+
+function tearDown() {
+  stubs.reset();
+  control.$tearDown();
+}
+
+function expectToSendEvent(type, data) {
+  mockXhr.open('POST', '/testevent', true);
+  mockXhr.send(JSON.stringify({
+    'id': '/foo/bar/baz',
+    'type': type,
+    'data': data
+  }));
+  control.$replayAll();
+}
+
+function testSendInitEvent() {
+  expectToSendEvent('INIT', {});
+  client.sendInitEvent();
+  control.$verifyAll();
+}
+
+function testSendResultsEvent() {
+  expectToSendEvent('RESULTS', {
+    'isSuccess': false,
+    'report': 'boom'
+  });
+  client.sendResultsEvent(false, 'boom');
+  control.$verifyAll();
+}
+
+function testSendScreenshotEvent() {
+  expectToSendEvent('SCREENSHOT', {
+    'name': 'ss01',
+    'data': '12412412asdfasf'
+  });
+  client.sendScreenshotEvent('12412412asdfasf', 'ss01');
+  control.$verifyAll();
+}
diff --git a/lib/webdriver/test/testing/flowtester_test.js b/lib/webdriver/test/testing/flowtester_test.js
new file mode 100644
index 0000000..cad21c9
--- /dev/null
+++ b/lib/webdriver/test/testing/flowtester_test.js
@@ -0,0 +1,204 @@
+// Copyright 2014 Software Freedom Conservancy. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.require('goog.testing.MockControl');
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.promise');
+goog.require('webdriver.testing.Clock');
+goog.require('webdriver.testing.promise.FlowTester');
+
+var FAKE_TIMER = {
+  clearInterval: goog.nullFunction,
+  clearTimeout: goog.nullFunction,
+  setInterval: goog.nullFunction,
+  setTimeout: goog.nullFunction
+};
+
+var originalDefaultFlow = webdriver.promise.controlFlow();
+var originalCreateFlow = webdriver.promise.createFlow;
+
+var control, mockClock;
+
+var flowTester;
+
+function setUp() {
+  control = new goog.testing.MockControl();
+  mockClock = control.createStrictMock(webdriver.testing.Clock);
+  flowTester = new webdriver.testing.promise.FlowTester(
+      mockClock, FAKE_TIMER);
+}
+
+function tearDown() {
+  control.$tearDown();
+  flowTester.dispose();
+  assertEquals(originalDefaultFlow, webdriver.promise.controlFlow());
+  assertEquals(originalCreateFlow, webdriver.promise.createFlow);
+}
+
+function testTurnEventLoopAdvancesClockByEventLoopFrequency() {
+  mockClock.tick(webdriver.promise.ControlFlow.EVENT_LOOP_FREQUENCY);
+  control.$replayAll();
+
+  flowTester.turnEventLoop();
+  control.$verifyAll();
+}
+
+function captureNewFlow() {
+  webdriver.promise.createFlow();
+  return goog.array.peek(flowTester.allFlows_).flow;
+}
+
+function emitIdle(flow) {
+  flow.emit(webdriver.promise.ControlFlow.EventType.IDLE);
+}
+
+function emitTask(flow) {
+  flow.emit(webdriver.promise.ControlFlow.EventType.SCHEDULE_TASK);
+}
+
+function emitError(flow, error) {
+  flow.emit(webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,
+            error);
+}
+
+function testVerifySuccess_aSingleFlow() {
+  var verifySuccess = goog.bind(flowTester.verifySuccess, flowTester);
+  var flow = webdriver.promise.controlFlow();
+
+  assertNotThrows('Flow has done nothing yet', verifySuccess);
+
+  emitTask(flow);
+  assertThrows('Flow is not idle', verifySuccess);
+
+  emitIdle(flow);
+  assertNotThrows('Flow went idle', verifySuccess);
+
+  emitError(flow, Error());
+  assertThrows('Flow had an error', verifySuccess);
+
+  emitIdle(flow);
+  assertThrows('Flow previously had an error', verifySuccess);
+}
+
+function testVerifySuccess_multipleFlows() {
+  var verifySuccess = goog.bind(flowTester.verifySuccess, flowTester);
+
+  var flow0 = webdriver.promise.controlFlow();
+  assertNotThrows('default throw is idle', verifySuccess);
+
+  var flow1 = captureNewFlow();
+  assertThrows('New flows start busy', verifySuccess);
+
+  emitIdle(flow1);
+  assertNotThrows(verifySuccess);
+
+  assertThrows('Target flow not found', goog.partial(verifySuccess, {}));
+
+  emitError(flow1, Error());
+  assertThrows(verifySuccess);
+
+  assertNotThrows(
+      'The designated flow is idle and has no errors!',
+      goog.partial(verifySuccess, flow0));
+}
+
+function testVerifyFailure() {
+  var verifyFailure = goog.bind(flowTester.verifyFailure, flowTester);
+  var flow0 = webdriver.promise.controlFlow();
+
+  assertThrows('No failures', verifyFailure);
+
+  emitError(flow0, Error());
+  assertThrows('Target flow not found', goog.partial(verifyFailure, {}));
+  assertNotThrows(verifyFailure);
+  assertNotThrows(goog.partial(verifyFailure, flow0));
+
+  emitError(flow0, Error());
+  assertThrows('multiple failures', verifyFailure);
+}
+
+function testVerifyFailure_multipleFlows() {
+  var verifyFailure = goog.bind(flowTester.verifyFailure, flowTester);
+
+  var flow0 = webdriver.promise.controlFlow();
+  var flow1 = captureNewFlow();
+
+  emitIdle(flow0);
+  emitIdle(flow1);
+  assertThrows(verifyFailure);
+
+  emitError(flow0, Error());
+  assertNotThrows(verifyFailure);
+  assertNotThrows(goog.partial(verifyFailure, flow0));
+  assertThrows(goog.partial(verifyFailure, flow1));
+
+  emitError(flow1, Error());
+  assertNotThrows(verifyFailure);
+  assertNotThrows(goog.partial(verifyFailure, flow0));
+  assertNotThrows(goog.partial(verifyFailure, flow1));
+}
+
+function testGetFailure() {
+  var getFailure = goog.bind(flowTester.getFailure, flowTester);
+
+  var flow0 = webdriver.promise.controlFlow();
+  var flow1 = captureNewFlow();
+
+  emitIdle(flow0);
+  emitIdle(flow1);
+  assertThrows(getFailure);
+
+  var error0 = Error();
+  emitError(flow0, error0);
+  assertEquals(error0, getFailure());
+  assertThrows(goog.partial(getFailure, flow1));
+
+  var error1 = Error();
+  emitError(flow1, error1);
+  assertThrows(getFailure);
+  assertEquals(error0, getFailure(flow0));
+  assertEquals(error1, getFailure(flow1));
+}
+
+function testAssertStillRunning() {
+  var assertStillRunning = goog.bind(
+      flowTester.assertStillRunning, flowTester);
+
+  var flow0 = webdriver.promise.controlFlow();
+  var flow1 = captureNewFlow();
+
+  assertThrows(assertStillRunning);
+  assertThrows(goog.partial(assertStillRunning, flow0));
+  assertNotThrows(goog.partial(assertStillRunning, flow1));
+
+  emitIdle(flow1);
+  assertThrows(assertStillRunning);
+  assertThrows(goog.partial(assertStillRunning, flow0));
+  assertThrows(goog.partial(assertStillRunning, flow1));
+
+  emitTask(flow0);
+  assertThrows(assertStillRunning);
+  assertNotThrows(goog.partial(assertStillRunning, flow0));
+  assertThrows(goog.partial(assertStillRunning, flow1));
+
+  emitTask(flow1);
+  assertNotThrows(assertStillRunning);
+  assertNotThrows(goog.partial(assertStillRunning, flow0));
+  assertNotThrows(goog.partial(assertStillRunning, flow1));
+
+  emitError(flow0, Error());
+  assertThrows(assertStillRunning);
+  assertThrows(goog.partial(assertStillRunning, flow0));
+  assertNotThrows(goog.partial(assertStillRunning, flow1));
+}
diff --git a/lib/webdriver/test/testing/testcase_test.js b/lib/webdriver/test/testing/testcase_test.js
new file mode 100644
index 0000000..51b54d1
--- /dev/null
+++ b/lib/webdriver/test/testing/testcase_test.js
@@ -0,0 +1,229 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.Promise');
+goog.require('goog.testing.MockControl');
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.mockmatchers');
+goog.require('goog.testing.jsunit');
+goog.require('goog.testing.recordFunction');
+goog.require('goog.userAgent');
+goog.require('webdriver.test.testutil');
+goog.require('webdriver.testing.TestCase');
+
+
+// Aliases for readability.
+var IGNORE_ARGUMENT = goog.testing.mockmatchers.ignoreArgument,
+    IS_ARRAY_ARGUMENT = goog.testing.mockmatchers.isArray,
+    StubError = webdriver.test.testutil.StubError,
+    throwStubError = webdriver.test.testutil.throwStubError,
+    assertIsStubError = webdriver.test.testutil.assertIsStubError;
+
+var control = new goog.testing.MockControl();
+var mockTestCase, testStub, mockOnComplete, mockOnError, uncaughtExceptions;
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+
+function setUp() {
+  // Use one master mock so we can assert execution order.
+  mockTestCase = control.createStrictMock({
+    setUp: goog.nullFunction,
+    testFn: goog.nullFunction,
+    tearDown: goog.nullFunction,
+    onComplete: goog.nullFunction,
+    onError: goog.nullFunction
+  }, true);
+
+  mockOnComplete = goog.bind(mockTestCase.onComplete, mockTestCase);
+  mockOnError = goog.bind(mockTestCase.onError, mockTestCase);
+
+  testStub = {
+    name: 'testStub',
+    scope: mockTestCase,
+    ref: mockTestCase.testFn
+  };
+
+  webdriver.test.testutil.messages = [];
+  uncaughtExceptions = [];
+
+  webdriver.promise.controlFlow().
+      on('uncaughtExceptions', onUncaughtException);
+}
+
+function tearDown() {
+  var flow = webdriver.promise.controlFlow();
+  return new goog.Promise(function(fulfill) {
+    flow.execute(goog.nullFunction);  // Flush.
+    flow.once('idle', fulfill);
+  }).then(function() {
+    assertArrayEquals('There were uncaught exceptions',
+        [], uncaughtExceptions);
+    control.$tearDown();
+    flow.reset();
+  });
+}
+
+function onUncaughtException(e) {
+  uncaughtExceptions.push(e);
+}
+
+function schedule(msg, opt_fn) {
+  var fn = opt_fn || goog.nullFunction;
+  return webdriver.promise.controlFlow().execute(fn, msg);
+}
+
+function runTest() {
+  return webdriver.testing.TestCase.prototype.runSingleTest_.
+      call(mockTestCase, testStub, mockOnError).
+      then(mockOnComplete);
+}
+
+function testExecutesTheBasicTestFlow() {
+  mockTestCase.setUp();
+  mockTestCase.testFn();
+  mockTestCase.tearDown();
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testExecutingAHappyTestWithScheduledActions() {
+  mockTestCase.setUp().$does(function() { schedule('a'); });
+  mockTestCase.testFn().$does(function() { schedule('b'); });
+  mockTestCase.tearDown().$does(function() { schedule('c'); });
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testShouldSkipTestFnIfSetupThrows() {
+  var e = Error();
+  mockTestCase.setUp().$does(function() { throw e; });
+  mockOnError(e);
+  mockTestCase.tearDown();
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testShouldSkipTestFnIfSetupActionFails_1() {
+  var e = Error();
+  mockTestCase.setUp().$does(function() {
+    schedule('an explosion', function() { throw e; });
+  });
+  mockOnError(e);
+  mockTestCase.tearDown();
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testShouldSkipTestFnIfSetupActionFails_2() {
+  var e = Error();
+  mockTestCase.setUp().$does(function() {
+    schedule('an explosion', function() { throw e; });
+  });
+  mockOnError(e);
+  mockTestCase.tearDown();
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testShouldSkipTestFnIfNestedSetupActionFails() {
+  var e = Error();
+  mockTestCase.setUp().$does(function() {
+    schedule('a', goog.nullFunction).then(function() {
+      schedule('b', function() { throw e; });
+    });
+  });
+  mockOnError(e);
+  mockTestCase.tearDown();
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testRunsAllTasksForEachPhaseBeforeTheNextPhase() {
+  webdriver.test.testutil.messages = [];
+  mockTestCase.setUp().$does(function() { schedule('a'); });
+  mockTestCase.testFn().$does(function() { schedule('b'); });
+  mockTestCase.tearDown().$does(function() { schedule('c'); });
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testRecordsErrorsFromTestFnBeforeTearDown() {
+  var e = Error();
+  mockTestCase.setUp();
+  mockTestCase.testFn().$does(function() { throw e; });
+  mockOnError(e);
+  mockTestCase.tearDown();
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testRecordsErrorsFromTearDown() {
+  var e = Error();
+  mockTestCase.setUp();
+  mockTestCase.testFn();
+  mockTestCase.tearDown().$does(function() { throw e; });
+  mockOnError(e);
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testErrorFromSetUpAndTearDown() {
+  var e1 = Error();
+  var e2 = Error();
+  mockTestCase.setUp().$does(function() { throw e1; });
+  mockOnError(e1);
+  mockTestCase.tearDown().$does(function() { throw e2; });
+  mockOnError(e2);
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
+
+function testErrorFromTestFnAndTearDown() {
+  var e1 = Error(), e2 = Error();
+  mockTestCase.setUp();
+  mockTestCase.testFn().$does(function() { throw e1; });
+  mockOnError(e1);
+  mockTestCase.tearDown().$does(function() { throw e2; });
+  mockOnError(e2);
+  mockOnComplete(IGNORE_ARGUMENT);
+  control.$replayAll();
+
+  return runTest();
+}
diff --git a/lib/webdriver/test/testutil.js b/lib/webdriver/test/testutil.js
new file mode 100644
index 0000000..2cf02a5
--- /dev/null
+++ b/lib/webdriver/test/testutil.js
@@ -0,0 +1,209 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.provide('webdriver.test.testutil');
+goog.provide('webdriver.test.testutil.StubError');
+
+goog.require('goog.array');
+goog.require('goog.debug.Error');
+goog.require('goog.string');
+goog.require('goog.testing.recordFunction');
+goog.require('webdriver.stacktrace');
+
+
+
+/**
+ * A custom error used for testing.
+ * @param {string=} opt_msg The error message to use.
+ * @constructor
+ * @extends {goog.debug.Error}
+ * @final
+ */
+webdriver.test.testutil.StubError = function(opt_msg) {
+  webdriver.test.testutil.StubError.base(this, 'constructor', opt_msg);
+};
+goog.inherits(webdriver.test.testutil.StubError, goog.debug.Error);
+
+
+/** @override */
+webdriver.test.testutil.StubError.prototype.name = 'StubError';
+
+
+/** @type {Array.<!string>} */
+webdriver.test.testutil.messages = [];
+
+webdriver.test.testutil.getStackTrace = function() {
+  return webdriver.stacktrace.get();
+};
+
+webdriver.test.testutil.throwStubError = function() {
+  throw new webdriver.test.testutil.StubError;
+};
+
+webdriver.test.testutil.assertIsStubError = function(error) {
+  assertTrue(error + ' is not an instanceof StubError',
+      error instanceof webdriver.test.testutil.StubError);
+};
+
+
+/**
+ * Asserts the contents of the {@link webdriver.test.testutil.messages} array
+ * are as expected.
+ * @param {...*} var_args The expected contents.
+ */
+webdriver.test.testutil.assertMessages = function(var_args) {
+  var args = Array.prototype.slice.call(arguments, 0);
+  assertArrayEquals(args, webdriver.test.testutil.messages);
+};
+
+
+/**
+ * Wraps a call to {@link webdriver.test.testutil.assertMessages} so it can
+ * be passed as a callback.
+ * @param {...*} var_args The expected contents.
+ * @return {!Function} The wrapped function.
+ */
+webdriver.test.testutil.assertingMessages = function(var_args) {
+  var args = goog.array.slice(arguments, 0);
+  return function() {
+    return webdriver.test.testutil.assertMessages.apply(null, args);
+  };
+};
+
+
+/**
+ * Asserts an object is a promise.
+ * @param {*} obj The object to check.
+ */
+webdriver.test.testutil.assertIsPromise = function(obj) {
+  assertTrue('Value is not a promise: ' + goog.typeOf(obj),
+      webdriver.promise.isPromise(obj));
+};
+
+
+/**
+ * Asserts an object is not a promise.
+ * @param {*} obj The object to check.
+ */
+webdriver.test.testutil.assertNotPromise = function(obj) {
+  assertFalse(webdriver.promise.isPromise(obj));
+};
+
+/**
+ * Wraps a function. The wrapped function will have several utility functions:
+ * <ul>
+ * <li>assertCalled: Asserts that the function was called.
+ * <li>assertNotCalled: Asserts that the function was not called.
+ * </ul>
+ * @param {Function=} opt_fn The function to wrap; defaults to
+ *     goog.nullFunction.
+ * @return {!Function} The wrapped function.
+ * @see goog.testing.recordFunction
+ */
+webdriver.test.testutil.callbackHelper = function(opt_fn) {
+  var callback = goog.testing.recordFunction(opt_fn);
+
+  callback.getExpectedCallCountMessage = function(n, opt_prefix, opt_noJoin) {
+    var message = [];
+    if (opt_prefix) message.push(opt_prefix);
+
+    var calls = callback.getCalls();
+    message.push(
+        'Expected to be called ' + n + ' times.',
+        '  was called ' + calls.length + ' times:');
+    goog.array.forEach(calls, function(call) {
+      var e = call.getError();
+      if (e) {
+        throw e;
+      }
+    });
+    return opt_noJoin ? message : message.join('\n');
+  };
+
+  callback.assertCalled = function(opt_message) {
+    assertEquals(callback.getExpectedCallCountMessage(1, opt_message),
+        1, callback.getCallCount());
+  };
+
+  callback.assertNotCalled = function(opt_message) {
+    assertEquals(callback.getExpectedCallCountMessage(0, opt_message),
+        0, callback.getCallCount());
+  };
+
+  return callback;
+};
+
+
+/**
+ * Creates a utility for managing a pair of callbacks, capable of asserting only
+ * one of the pair was ever called.
+ *
+ * @param {Function=} opt_callback The callback to manage.
+ * @param {Function=} opt_errback The errback to manage.
+ */
+webdriver.test.testutil.callbackPair = function(opt_callback, opt_errback) {
+  var pair = {
+    callback: webdriver.test.testutil.callbackHelper(opt_callback),
+    errback: webdriver.test.testutil.callbackHelper(opt_errback)
+  };
+
+  /** @param {string=} opt_message Optional failure message. */
+  pair.assertEither = function(opt_message) {
+    if (!pair.callback.getCallCount() &&
+        !pair.errback.getCallCount()) {
+      var message = ['Neither callback nor errback has been called'];
+      if (opt_message) goog.array.insertAt(message, opt_message);
+      fail(message.join('\n'));
+    }
+  };
+
+  /** @param {string=} opt_message Optional failure message. */
+  pair.assertNeither = function(opt_message) {
+    var message = (opt_message || '') + 'Did not expect callback or errback';
+    pair.callback.assertNotCalled(message);
+    pair.errback.assertNotCalled(message);
+  };
+
+  /** @param {string=} opt_message Optional failure message. */
+  pair.assertCallback = function(opt_message) {
+    var message = opt_message ? (opt_message + ': ') : '';
+    pair.errback.assertNotCalled(message + 'Expected callback, not errback');
+    pair.callback.assertCalled(message + 'Callback not called');
+  };
+
+  /** @param {string=} opt_message Optional failure message. */
+  pair.assertErrback = function(opt_message) {
+    var message = opt_message ? (opt_message + ': ') : '';
+    pair.callback.assertNotCalled(message + 'Expected errback, not callback');
+    pair.errback.assertCalled(message + 'Errback not called');
+  };
+
+  pair.reset = function() {
+    pair.callback.reset();
+    pair.errback.reset();
+  };
+
+  return pair;
+};
+
+
+webdriver.test.testutil.assertObjectEquals = function(expected, actual) {
+  assertObjectEquals(
+      'Expected: ' + JSON.stringify(expected) + '\n' +
+      'Actual:   ' + JSON.stringify(actual),
+      expected, actual);
+};
diff --git a/lib/webdriver/test/testutil_test.js b/lib/webdriver/test/testutil_test.js
new file mode 100644
index 0000000..af55b32
--- /dev/null
+++ b/lib/webdriver/test/testutil_test.js
@@ -0,0 +1,104 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.test.testutil');
+
+// Aliases for readability.
+var callbackHelper = webdriver.test.testutil.callbackHelper,
+    callbackPair = webdriver.test.testutil.callbackPair;
+
+function testCallbackHelper_functionCalled() {
+  var callback = callbackHelper();
+  callback();
+  assertNotThrows(callback.assertCalled);
+  assertThrows(callback.assertNotCalled);
+}
+
+function testCallbackHelper_functionCalledMoreThanOnce() {
+  var callback = callbackHelper();
+  callback();
+  callback(123, 'abc');
+  assertThrows(callback.assertCalled);
+  assertThrows(callback.assertNotCalled);
+}
+
+function testCallbackHelper_functionNotCalled() {
+  var callback = callbackHelper();
+  assertNotThrows(callback.assertNotCalled);
+  assertThrows(callback.assertCalled);
+}
+
+function testCallbackHelper_wrappedFunctionIsCalled() {
+  var count = 0;
+  var callback = callbackHelper(function() {
+    count += 1;
+  });
+  callback();
+  assertNotThrows(callback.assertCalled);
+  assertThrows(callback.assertNotCalled);
+  assertEquals(1, count);
+}
+
+function testCallbackPair_callbackExpected() {
+  var pair = callbackPair();
+  assertThrows(pair.assertCallback);
+  pair.callback();
+  assertNotThrows(pair.assertCallback);
+  pair.errback();
+  assertThrows(pair.assertCallback);
+
+  pair.reset();
+  pair.callback();
+  assertNotThrows(pair.assertCallback);
+  pair.callback();
+  assertThrows('Should expect to be called only once',
+      pair.assertCallback);
+}
+
+function testCallbackPair_errbackExpected() {
+  var pair = callbackPair();
+  assertThrows(pair.assertErrback);
+  pair.errback();
+  assertNotThrows(pair.assertErrback);
+  pair.callback();
+  assertThrows(pair.assertErrback);
+}
+
+function testCallbackPair_eitherExpected() {
+  var pair = callbackPair();
+  assertThrows(pair.assertEither);
+  pair.errback();
+  assertNotThrows(pair.assertEither);
+  pair.reset();
+  pair.callback();
+  assertNotThrows(pair.assertEither);
+  pair.errback();
+  assertNotThrows(pair.assertEither);
+}
+
+function testCallbackPair_neitherExpected() {
+  var pair = callbackPair();
+  assertNotThrows(pair.assertNeither);
+  pair.errback();
+  assertThrows(pair.assertNeither);
+  pair.reset();
+  pair.callback();
+  assertThrows(pair.assertNeither);
+  pair.errback();
+  assertThrows(pair.assertNeither);
+}
diff --git a/lib/webdriver/test/until_test.js b/lib/webdriver/test/until_test.js
new file mode 100644
index 0000000..e4af619
--- /dev/null
+++ b/lib/webdriver/test/until_test.js
@@ -0,0 +1,411 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.provide('webdriver.test.until_test');
+goog.setTestOnly('webdriver.test.until_test');
+
+goog.require('bot.Error');
+goog.require('bot.ErrorCode');
+goog.require('bot.response');
+goog.require('goog.array');
+goog.require('goog.string');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.By');
+goog.require('webdriver.CommandName');
+goog.require('webdriver.WebDriver');
+goog.require('webdriver.WebElement');
+goog.require('webdriver.WebElementPromise');
+goog.require('webdriver.until');
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+
+var By = webdriver.By;
+var until = webdriver.until;
+var CommandName = webdriver.CommandName;
+
+var driver, executor;
+
+var TestExecutor = function() {
+  this.handlers_ = {};
+};
+
+
+TestExecutor.prototype.on = function(cmd, handler) {
+  this.handlers_[cmd] = handler;
+  return this;
+};
+
+
+TestExecutor.prototype.execute = function(cmd, callback) {
+  if (!this.handlers_[cmd.getName()]) {
+    throw Error('Unsupported command: ' + cmd.getName());
+  }
+  this.handlers_[cmd.getName()](cmd, callback);
+};
+
+
+function setUp() {
+  executor = new TestExecutor();
+  driver = new webdriver.WebDriver('session-id', executor);
+}
+
+
+function testUntilAbleToSwitchToFrame_failsFastForNonSwitchErrors() {
+  var e = Error('boom');
+  executor.on(CommandName.SWITCH_TO_FRAME, function(cmd, callback) {
+    callback(e);
+  });
+
+  return driver.wait(until.ableToSwitchToFrame(0), 100)
+      .then(fail, function(e2) {
+        assertEquals(e, e2);
+      });
+}
+
+
+function testUntilAbleToSwitchToFrame_byIndex() {
+  executor.on(CommandName.SWITCH_TO_FRAME, function(cmd, callback) {
+    callback(null, {status: bot.ErrorCode.SUCCESS});
+  });
+
+  return driver.wait(until.ableToSwitchToFrame(0), 100);
+}
+
+
+function testUntilAbleToSwitchToFrame_byWebElement() {
+  executor.on(CommandName.SWITCH_TO_FRAME, function(cmd, callback) {
+    callback(null, {status: bot.ErrorCode.SUCCESS});
+  });
+
+  var el = new webdriver.WebElement(driver, {ELEMENT: 1234});
+  return driver.wait(until.ableToSwitchToFrame(el), 100);
+}
+
+
+function testUntilAbleToSwitchToFrame_byWebElementPromise() {
+  executor.on(CommandName.SWITCH_TO_FRAME, function(cmd, callback) {
+    callback(null, {status: bot.ErrorCode.SUCCESS});
+  });
+
+  var el = new webdriver.WebElementPromise(driver,
+      webdriver.promise.fulfilled(
+          new webdriver.WebElement(driver, {ELEMENT: 1234})));
+  return driver.wait(until.ableToSwitchToFrame(el), 100);
+}
+
+
+function testUntilAbleToSwitchToFrame_byLocator() {
+  executor.on(CommandName.FIND_ELEMENTS, function(cmd, callback) {
+    callback(null, {
+      status: bot.ErrorCode.SUCCESS,
+      value: [{ELEMENT: 1234}]
+    });
+  }).on(CommandName.SWITCH_TO_FRAME, function(cmd, callback) {
+    callback(null, {status: bot.ErrorCode.SUCCESS});
+  });
+
+  return driver.wait(until.ableToSwitchToFrame(By.id('foo')), 100);
+}
+
+
+function testUntilAbleToSwitchToFrame_byLocator_elementNotInitiallyFound() {
+  var foundResponses = [[], [], [{ELEMENT: 1234}]];
+  executor.on(CommandName.FIND_ELEMENTS, function(cmd, callback) {
+    callback(null, {
+      status: bot.ErrorCode.SUCCESS,
+      value: foundResponses.shift()
+    });
+  }).on(CommandName.SWITCH_TO_FRAME, function(cmd, callback) {
+    callback(null, {status: bot.ErrorCode.SUCCESS});
+  });
+
+  return driver.wait(until.ableToSwitchToFrame(By.id('foo')), 2000)
+      .then(function() {
+        assertEquals(0, foundResponses.length);
+      });
+}
+
+
+function testUntilAbleToSwitchToFrame_timesOutIfNeverAbletoSwitchFrames() {
+  var count = 0;
+  executor.on(CommandName.SWITCH_TO_FRAME, function(cmd, callback) {
+    count += 1;
+    callback(null, {status: bot.ErrorCode.NO_SUCH_FRAME});
+  });
+
+  return driver.wait(until.ableToSwitchToFrame(0), 100).then(fail, function(e) {
+    assertTrue(count > 0);
+    assertTrue('Wrong message: ' + e.message, goog.string.startsWith(
+        e.message, 'Waiting to be able to switch to frame'));
+  });
+}
+
+
+function testUntilAlertIsPresent_failsFastForNonAlertSwitchErrors() {
+  return driver.wait(until.alertIsPresent(), 100).then(fail, function(e) {
+    assertEquals(
+        'Unsupported command: ' + CommandName.GET_ALERT_TEXT, e.message);
+  });
+}
+
+
+function testUntilAlertIsPresent() {
+  var count = 0;
+  executor.on(CommandName.GET_ALERT_TEXT, function(cmd, callback) {
+    if (count++ < 3) {
+      callback(null, {status: bot.ErrorCode.NO_SUCH_ALERT});
+    } else {
+      callback(null, {status: bot.ErrorCode.SUCCESS});
+    }
+  }).on(CommandName.DISMISS_ALERT, function(cmd, callback) {
+    callback(null, {status: bot.ErrorCode.SUCCESS});
+  });
+
+  return driver.wait(until.alertIsPresent(), 1000).then(function(alert) {
+    assertEquals(4, count);
+    return alert.dismiss();
+  });
+}
+
+
+function testUntilTitleIs() {
+  var titles = ['foo', 'bar', 'baz'];
+  executor.on(CommandName.GET_TITLE, function(cmd, callback) {
+    callback(null, bot.response.createResponse(titles.shift()));
+  });
+
+  return driver.wait(until.titleIs('bar'), 3000).then(function() {
+    assertArrayEquals(['baz'], titles);
+  });
+}
+
+
+function testUntilTitleContains() {
+  var titles = ['foo', 'froogle', 'google'];
+  executor.on(CommandName.GET_TITLE, function(cmd, callback) {
+    callback(null, bot.response.createResponse(titles.shift()));
+  });
+
+  return driver.wait(until.titleContains('oogle'), 3000).then(function() {
+    assertArrayEquals(['google'], titles);
+  });
+}
+
+
+function testUntilTitleMatches() {
+  var titles = ['foo', 'froogle', 'aaaabc', 'aabbbc', 'google'];
+  executor.on(CommandName.GET_TITLE, function(cmd, callback) {
+    callback(null, bot.response.createResponse(titles.shift()));
+  });
+
+  return driver.wait(until.titleMatches(/^a{2,3}b+c$/), 3000).then(function() {
+    assertArrayEquals(['google'], titles);
+  });
+}
+
+
+function testUntilElementLocated() {
+  var responses = [[], [{ELEMENT: 'abc123'}, {ELEMENT: 'foo'}], ['end']];
+  executor.on(CommandName.FIND_ELEMENTS, function(cmd, callback) {
+    callback(null, bot.response.createResponse(responses.shift()));
+  });
+
+  return driver.wait(until.elementLocated(By.id('quux')), 2000)
+      .then(function(el) {
+        return el.getId();
+      }).then(function(id) {
+        assertArrayEquals([['end']], responses);
+        assertEquals('abc123', id['ELEMENT']);
+      });
+}
+
+function runNoElementFoundTest(locator, locatorStr) {
+  executor.on(CommandName.FIND_ELEMENTS, function(cmd, callback) {
+    callback(null, bot.response.createResponse([]));
+  });
+
+  function expectedFailure() {
+    fail('expected condition to timeout');
+  }
+
+  return driver.wait(until.elementLocated(locator), 100)
+      .then(expectedFailure, function(error) {
+        var expected = 'Waiting for element to be located ' + locatorStr;
+        var lines = error.message.split(/\n/, 2);
+        assertEquals(expected, lines[0]);
+        assertRegExp(/^Wait timed out after \d+ms$/, lines[1]);
+      });
+}
+
+function testUntilElementLocated_elementNeverFound_byLocator() {
+  return runNoElementFoundTest(By.id('quux'), 'By.id("quux")');
+}
+
+function testUntilElementLocated_elementNeverFound_byHash() {
+  return runNoElementFoundTest({id: 'quux'}, 'By.id("quux")');
+}
+
+function testUntilElementLocated_elementNeverFound_byFunction() {
+  return runNoElementFoundTest(goog.nullFunction, 'by function()');
+}
+
+function testUntilElementsLocated() {
+  var responses = [[], [{ELEMENT: 'abc123'}, {ELEMENT: 'foo'}], ['end']];
+  executor.on(CommandName.FIND_ELEMENTS, function(cmd, callback) {
+    callback(null, bot.response.createResponse(responses.shift()));
+  });
+
+  return driver.wait(until.elementsLocated(By.id('quux')), 2000)
+      .then(function(els) {
+        return webdriver.promise.all(goog.array.map(els, function(el) {
+          return el.getId();
+        }));
+      }).then(function(ids) {
+        assertArrayEquals([['end']], responses);
+        assertEquals(2, ids.length);
+        assertEquals('abc123', ids[0]['ELEMENT']);
+        assertEquals('foo', ids[1]['ELEMENT']);
+      });
+}
+
+function runNoElementsFoundTest(locator, locatorStr) {
+  executor.on(CommandName.FIND_ELEMENTS, function(cmd, callback) {
+    callback(null, bot.response.createResponse([]));
+  });
+
+  function expectedFailure() {
+    fail('expected condition to timeout');
+  }
+
+  return driver.wait(until.elementsLocated(locator), 100)
+      .then(expectedFailure, function(error) {
+        var expected =
+            'Waiting for at least one element to be located ' + locatorStr;
+        var lines = error.message.split(/\n/, 2);
+        assertEquals(expected, lines[0]);
+        assertRegExp(/^Wait timed out after \d+ms$/, lines[1]);
+      });
+}
+
+function testUntilElementsLocated_noElementsEverFound_byLocator() {
+  return runNoElementsFoundTest(By.id('quux'), 'By.id("quux")');
+}
+
+function testUntilElementsLocated_noElementsEverFound_byHash() {
+  return runNoElementsFoundTest({id: 'quux'}, 'By.id("quux")');
+}
+
+function testUntilElementsLocated_noElementsEverFound_byFunction() {
+  return runNoElementsFoundTest(goog.nullFunction, 'by function()');
+}
+
+function testUntilStalenessOf() {
+  var responses = [
+    bot.response.createResponse('body'),
+    bot.response.createResponse('body'),
+    bot.response.createResponse('body'),
+    bot.response.createErrorResponse(
+        new bot.Error(bot.ErrorCode.STALE_ELEMENT_REFERENCE, 'now stale')),
+    ['end']
+  ];
+  executor.on(CommandName.GET_ELEMENT_TAG_NAME, function(cmd, callback) {
+    callback(null, responses.shift());
+  });
+
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return driver.wait(until.stalenessOf(el), 2000).then(function() {
+    assertArrayEquals([['end']], responses);
+  });
+}
+
+function runElementStateTest(predicate, command, responses) {
+  assertTrue(responses.length > 1);
+
+  responses = goog.array.concat(responses, ['end']);
+  executor.on(command, function(cmd, callback) {
+    callback(null, bot.response.createResponse(responses.shift()));
+  });
+  return driver.wait(predicate, 2000).then(function() {
+    assertArrayEquals(['end'], responses);
+  });
+}
+
+function testUntilElementIsVisible() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementIsVisible(el),
+      CommandName.IS_ELEMENT_DISPLAYED, [false, false, true]);
+}
+
+
+function testUntilElementIsNotVisible() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementIsNotVisible(el),
+      CommandName.IS_ELEMENT_DISPLAYED, [true, true, false]);
+}
+
+
+function testUntilElementIsEnabled() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementIsEnabled(el),
+      CommandName.IS_ELEMENT_ENABLED, [false, false, true]);
+}
+
+
+function testUntilElementIsDisabled() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementIsDisabled(el),
+      CommandName.IS_ELEMENT_ENABLED, [true, true, false]);
+}
+
+
+function testUntilElementIsSelected() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementIsSelected(el),
+      CommandName.IS_ELEMENT_SELECTED, [false, false, true]);
+}
+
+
+function testUntilElementIsNotSelected() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementIsNotSelected(el),
+      CommandName.IS_ELEMENT_SELECTED, [true, true, false]);
+}
+
+
+function testUntilElementTextIs() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementTextIs(el, 'foobar'),
+      CommandName.GET_ELEMENT_TEXT, ['foo', 'fooba', 'foobar']);
+}
+
+
+function testUntilElementTextContains() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementTextContains(el, 'bar'),
+      CommandName.GET_ELEMENT_TEXT, ['foo', 'foobaz', 'foobarbaz']);
+}
+
+
+function testUntilElementTextMatches() {
+  var el = new webdriver.WebElement(driver, {ELEMENT: 'foo'});
+  return runElementStateTest(until.elementTextMatches(el, /fo+bar{3}/),
+      CommandName.GET_ELEMENT_TEXT, ['foo', 'foobar', 'fooobarrr']);
+}
diff --git a/lib/webdriver/test/webdriver_generator_test.js b/lib/webdriver/test/webdriver_generator_test.js
new file mode 100644
index 0000000..7b04ea4
--- /dev/null
+++ b/lib/webdriver/test/webdriver_generator_test.js
@@ -0,0 +1,92 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.provide('webdriver.test.WebDriver.generator.test');
+goog.setTestOnly('webdriver.test.WebDriver.generator.test');
+
+goog.require('goog.testing.jsunit');
+goog.require('webdriver.Session');
+goog.require('webdriver.WebDriver');
+
+
+var driver;
+
+function setUp() {
+  driver = new webdriver.WebDriver(
+      new webdriver.Session('test-session', {}),
+      new ExplodingExecutor());
+}
+
+
+function testCanUseGeneratorsWithWebDriverCall() {
+  return driver.call(function* () {
+    var x = yield webdriver.promise.fulfilled(1);
+    var y = yield webdriver.promise.fulfilled(2);
+    return x + y;
+  }).then(function(value) {
+    assertEquals(3, value);
+  });
+}
+
+
+function testCanDefineScopeOnGeneratorCall() {
+  return driver.call(function* () {
+    var x = yield webdriver.promise.fulfilled(1);
+    return this.name + x;
+  }, {name: 'Bob'}).then(function(value) {
+    assertEquals('Bob1', value);
+  });
+}
+
+
+function testCanSpecifyArgsOnGeneratorCall() {
+  return driver.call(function* (a, b) {
+    var x = yield webdriver.promise.fulfilled(1);
+    var y = yield webdriver.promise.fulfilled(2);
+    return [x + y, a, b];
+  }, null, 'abc', 123).then(function(value) {
+    assertArrayEquals([3, 'abc', 123], value);
+  });
+}
+
+
+function testCanUseGeneratorWithWebDriverWait() {
+  var values = [];
+  return driver.wait(function* () {
+    yield values.push(1);
+    values.push(yield webdriver.promise.delayed(10).then(function() {
+      return 2;
+    }));
+    yield values.push(3);
+    return values.length === 6;
+  }, 250).then(function() {
+    assertArrayEquals([1, 2, 3, 1, 2, 3], values);
+  });
+}
+
+
+/**
+ * @constructor
+ * @implements {webdriver.CommandExecutor}
+ */
+function ExplodingExecutor() {}
+
+
+/** @override */
+ExplodingExecutor.prototype.execute = function(command, cb) {
+  cb(Error('Unsupported operation'));
+};
diff --git a/lib/webdriver/test/webdriver_test.js b/lib/webdriver/test/webdriver_test.js
new file mode 100644
index 0000000..7602f60
--- /dev/null
+++ b/lib/webdriver/test/webdriver_test.js
@@ -0,0 +1,2369 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.require('bot.ErrorCode');
+goog.require('goog.Promise');
+goog.require('goog.functions');
+goog.require('goog.testing.PropertyReplacer');
+goog.require('goog.testing.MockControl');
+goog.require('goog.testing.jsunit');
+goog.require('goog.userAgent');
+goog.require('webdriver.Capabilities');
+goog.require('webdriver.Command');
+goog.require('webdriver.CommandExecutor');
+goog.require('webdriver.CommandName');
+goog.require('webdriver.FileDetector');
+goog.require('webdriver.WebDriver');
+goog.require('webdriver.Serializable');
+goog.require('webdriver.Session');
+goog.require('webdriver.logging');
+goog.require('webdriver.promise');
+goog.require('webdriver.test.testutil');
+
+var SESSION_ID = 'test_session_id';
+
+var STUB_DRIVER = {
+  controlFlow: goog.nullFunction
+};
+
+// Alias some long names that interfere with test readability.
+var CName = webdriver.CommandName,
+    ECode = bot.ErrorCode,
+    StubError = webdriver.test.testutil.StubError,
+    throwStubError = webdriver.test.testutil.throwStubError,
+    assertIsStubError = webdriver.test.testutil.assertIsStubError;
+
+// By is exported by webdriver.By, but IDEs don't recognize
+// goog.exportSymbol. Explicitly define it here to make the
+// IDE stop complaining.
+var By = webdriver.By;
+
+var driver;
+var flow;
+var mockControl;
+var uncaughtExceptions;
+
+function shouldRunTests() {
+  return !goog.userAgent.IE || goog.userAgent.isVersionOrHigher(10);
+}
+
+
+function setUp() {
+  mockControl = new goog.testing.MockControl();
+  flow = webdriver.promise.controlFlow();
+  uncaughtExceptions = [];
+  flow.on('uncaughtException', onUncaughtException);
+}
+
+
+function tearDown() {
+  return waitForIdle(flow).then(function() {
+    mockControl.$verifyAll();
+    mockControl.$tearDown();
+
+    assertArrayEquals('There were uncaught exceptions',
+        [], uncaughtExceptions);
+    flow.reset();
+  });
+}
+
+
+function onUncaughtException(e) {
+  uncaughtExceptions.push(e);
+}
+
+
+function waitForIdle(opt_flow) {
+  var theFlow = opt_flow || flow;
+  return new goog.Promise(function(fulfill, reject) {
+    if (theFlow.isIdle()) {
+      fulfill();
+      return;
+    }
+    theFlow.once('idle', fulfill);
+    theFlow.once('uncaughtException', reject);
+  });
+}
+
+
+function waitForAbort(opt_flow, opt_n) {
+  var n = opt_n || 1;
+  var theFlow = opt_flow || flow;
+  theFlow.removeAllListeners(
+      webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION);
+  return new goog.Promise(function(fulfill, reject) {
+    theFlow.once('idle', function() {
+      reject(Error('expected flow to report an unhandled error'));
+    });
+
+    var errors = [];
+    theFlow.on('uncaughtException', onError);
+    function onError(e) {
+      errors.push(e);
+      if (errors.length === n) {
+        theFlow.removeListener('uncaughtException', onError);
+        fulfill(n === 1 ? errors[0] : errors);
+      }
+    }
+  });
+}
+
+
+function expectedError(code, message) {
+  return function(e) {
+    assertEquals('Wrong error message', message, e.message);
+    assertEquals('Wrong error code', code, e.code);
+  };
+}
+
+
+function createCommandMatcher(commandName, parameters) {
+  return new goog.testing.mockmatchers.ArgumentMatcher(function(actual) {
+    assertEquals('wrong name', commandName, actual.getName());
+    var differences = goog.testing.asserts.findDifferences(
+        parameters, actual.getParameters());
+    assertNull(
+        'Wrong parameters for "' + commandName + '"' +
+            '\n    Expected: ' + JSON.stringify(parameters) +
+            '\n    Actual: ' + JSON.stringify(actual.getParameters()),
+        differences);
+    return true;
+  }, commandName + '(' + JSON.stringify(parameters) + ')');
+}
+
+
+TestHelper = function() {
+  this.executor = mockControl.createStrictMock(webdriver.CommandExecutor);
+};
+
+
+TestHelper.prototype.expect = function(commandName, opt_parameters) {
+  return new TestHelper.Command(this, commandName, opt_parameters);
+};
+
+
+TestHelper.prototype.replayAll = function() {
+  mockControl.$replayAll();
+  return this;
+};
+
+
+TestHelper.Command = function(testHelper, commandName, opt_parameters) {
+  this.helper_ = testHelper;
+  this.name_ = commandName;
+  this.toDo_ = null;
+  this.anyTimes_ = false;
+  this.times_ = 0;
+  this.sessionId_ = SESSION_ID;
+  this.withParameters(opt_parameters || {});
+};
+
+
+TestHelper.Command.prototype.withParameters = function(parameters) {
+  this.parameters_ = parameters;
+  if (this.name_ !== CName.NEW_SESSION) {
+    this.parameters_['sessionId'] = this.sessionId_;
+  }
+  return this;
+};
+
+
+TestHelper.Command.prototype.buildExpectation_ = function() {
+  var commandMatcher = createCommandMatcher(this.name_, this.parameters_);
+  assertNotNull(this.toDo_);
+  var expectation = this.helper_.executor.
+      execute(commandMatcher, goog.testing.mockmatchers.isFunction).
+      $does(this.toDo_);
+  if (this.anyTimes_) {
+    assertEquals(0, this.times_);
+    expectation.$anyTimes();
+  }
+  if (this.times_) {
+    assertFalse(this.anyTimes_);
+    expectation.$times(this.times_);
+  }
+};
+
+
+TestHelper.Command.prototype.andReturn = function(code, opt_value) {
+  this.toDo_ = function(command, callback) {
+    callback(null, {
+      'status': code,
+      'sessionId': {
+        'value': SESSION_ID
+      },
+      'value': goog.isDef(opt_value) ? opt_value : null
+    });
+  };
+  return this;
+};
+
+
+TestHelper.Command.prototype.anyTimes = function() {
+  this.anyTimes_ = true;
+  return this;
+};
+
+
+TestHelper.Command.prototype.times = function(n) {
+  this.times_ = n;
+  return this;
+};
+
+
+TestHelper.Command.prototype.andReturnSuccess = function(opt_returnValue) {
+  return this.andReturn(ECode.SUCCESS, opt_returnValue);
+};
+
+
+TestHelper.Command.prototype.andReturnError = function(errCode, opt_value) {
+  return this.andReturn(errCode, opt_value);
+};
+
+
+TestHelper.Command.prototype.replayAll = function() {
+  if (!this.toDo_) {
+    this.andReturnSuccess(null);
+  }
+  this.buildExpectation_();
+  return this.helper_.replayAll();
+};
+
+
+TestHelper.Command.prototype.expect = function(name, opt_parameters) {
+  if (!this.toDo_) {
+    this.andReturnSuccess(null);
+  }
+  this.buildExpectation_();
+  return this.helper_.expect(name, opt_parameters);
+};
+
+
+/**
+ * @param {!(webdriver.Session|webdriver.promise.Promise)=} opt_session The
+ *     session to use.
+ * @return {!webdriver.WebDriver} A new driver instance.
+ */
+TestHelper.prototype.createDriver = function(opt_session) {
+  var session = opt_session || new webdriver.Session(SESSION_ID, {});
+  return new webdriver.WebDriver(session, this.executor);
+};
+
+
+//////////////////////////////////////////////////////////////////////////////
+//
+//    Tests
+//
+//////////////////////////////////////////////////////////////////////////////
+
+function testAttachToSession_sessionIsAvailable() {
+  var testHelper = new TestHelper().
+      expect(CName.DESCRIBE_SESSION).
+      withParameters({'sessionId': SESSION_ID}).
+      andReturnSuccess({'browserName': 'firefox'}).
+      replayAll();
+
+  var driver = webdriver.WebDriver.attachToSession(testHelper.executor,
+      SESSION_ID);
+  return driver.getSession().then(function(session) {
+    webdriver.test.testutil.assertObjectEquals({
+      'value':'test_session_id'
+    }, session.getId());
+    assertEquals('firefox', session.getCapability('browserName'));
+  });
+}
+
+
+function testAttachToSession_failsToGetSessionInfo() {
+  var testHelper = new TestHelper().
+      expect(CName.DESCRIBE_SESSION).
+      withParameters({'sessionId': SESSION_ID}).
+      andReturnError(ECode.UNKNOWN_ERROR, {'message': 'boom'}).
+      replayAll();
+
+  var driver = webdriver.WebDriver.attachToSession(testHelper.executor,
+      SESSION_ID);
+  return driver.getSession().then(fail, function(e) {
+    assertEquals(bot.ErrorCode.UNKNOWN_ERROR, e.code);
+    assertEquals('boom', e.message);
+  });
+}
+
+
+function testAttachToSession_usesActiveFlowByDefault() {
+  var testHelper = new TestHelper().
+      expect(CName.DESCRIBE_SESSION).
+      withParameters({'sessionId': SESSION_ID}).
+      andReturnSuccess({}).
+      replayAll();
+
+  var driver = webdriver.WebDriver.attachToSession(testHelper.executor,
+      SESSION_ID);
+  assertEquals(driver.controlFlow(), webdriver.promise.controlFlow());
+
+  return waitForIdle(driver.controlFlow());
+}
+
+
+function testAttachToSession_canAttachInCustomFlow() {
+  var testHelper = new TestHelper().
+      expect(CName.DESCRIBE_SESSION).
+      withParameters({'sessionId': SESSION_ID}).
+      andReturnSuccess({}).
+      replayAll();
+
+  var otherFlow = new webdriver.promise.ControlFlow();
+  var driver = webdriver.WebDriver.attachToSession(
+      testHelper.executor, SESSION_ID, otherFlow);
+  assertEquals(otherFlow, driver.controlFlow());
+  assertNotEquals(otherFlow, webdriver.promise.controlFlow());
+
+  return waitForIdle(otherFlow);
+}
+
+
+function testCreateSession_happyPathWithCapabilitiesHashObject() {
+  var testHelper = new TestHelper().
+      expect(CName.NEW_SESSION).
+      withParameters({
+        'desiredCapabilities': {'browserName': 'firefox'}
+      }).
+      andReturnSuccess({'browserName': 'firefox'}).
+      replayAll();
+
+  var driver = webdriver.WebDriver.createSession(testHelper.executor, {
+    'browserName': 'firefox'
+  });
+  return driver.getSession().then(function(session) {
+    webdriver.test.testutil.assertObjectEquals({
+      'value':'test_session_id'
+    }, session.getId());
+    assertEquals('firefox', session.getCapability('browserName'));
+  });
+}
+
+
+function testCreateSession_happyPathWithCapabilitiesInstance() {
+  var testHelper = new TestHelper().
+      expect(CName.NEW_SESSION).
+      withParameters({
+        'desiredCapabilities': {'browserName': 'firefox'}
+      }).
+      andReturnSuccess({'browserName': 'firefox'}).
+      replayAll();
+
+  var driver = webdriver.WebDriver.createSession(
+      testHelper.executor, webdriver.Capabilities.firefox());
+  return driver.getSession().then(function(session) {
+    webdriver.test.testutil.assertObjectEquals({
+      'value':'test_session_id'
+    }, session.getId());
+    assertEquals('firefox', session.getCapability('browserName'));
+  });
+}
+
+
+function testCreateSession_failsToCreateSession() {
+  var testHelper = new TestHelper().
+      expect(CName.NEW_SESSION).
+      withParameters({
+        'desiredCapabilities': {'browserName': 'firefox'}
+      }).
+      andReturnError(ECode.UNKNOWN_ERROR, {'message': 'boom'}).
+      replayAll();
+
+  var driver = webdriver.WebDriver.createSession(testHelper.executor, {
+    'browserName': 'firefox'
+  });
+  return driver.getSession().then(fail, function(e) {
+    assertEquals(bot.ErrorCode.UNKNOWN_ERROR, e.code);
+    assertEquals('boom', e.message);
+  });
+}
+
+
+function testCreateSession_usesActiveFlowByDefault() {
+  var testHelper = new TestHelper().
+      expect(CName.NEW_SESSION).
+      withParameters({'desiredCapabilities': {}}).
+      andReturnSuccess({}).
+      replayAll();
+
+  var driver = webdriver.WebDriver.createSession(testHelper.executor, {});
+  assertEquals(webdriver.promise.controlFlow(), driver.controlFlow());
+
+  return waitForIdle(driver.controlFlow());
+}
+
+
+function testCreateSession_canCreateInCustomFlow() {
+  var testHelper = new TestHelper().
+      expect(CName.NEW_SESSION).
+      withParameters({'desiredCapabilities': {}}).
+      andReturnSuccess({}).
+      replayAll();
+
+  var otherFlow = new webdriver.promise.ControlFlow(goog.global);
+  var driver = webdriver.WebDriver.createSession(
+      testHelper.executor, {}, otherFlow);
+  assertEquals(otherFlow, driver.controlFlow());
+  assertNotEquals(otherFlow, webdriver.promise.controlFlow());
+
+  return waitForIdle(otherFlow);
+}
+
+
+function testToWireValue_function() {
+  var fn = function() { return 'foo'; };
+  return webdriver.WebDriver.toWireValue_(fn).then(function(value) {
+    assertEquals(fn + '', value);
+  });
+}
+
+
+function testToWireValue_date() {
+  if (goog.userAgent.IE) {
+    return;  // Because IE...
+  }
+  return webdriver.WebDriver.toWireValue_(new Date(605728511546)).
+      then(function(value) {
+        assertEquals('1989-03-12T17:55:11.546Z', value);
+      });
+}
+
+
+function testToWireValue_simpleObject() {
+  var expected = {'sessionId': 'foo'};
+  return webdriver.WebDriver.toWireValue_({
+    'sessionId': new webdriver.Session('foo', {})
+  }).then(function(actual) {
+    webdriver.test.testutil.assertObjectEquals(expected, actual);
+  });
+}
+
+
+function testToWireValue_nestedObject() {
+  var expected = {'sessionId': {'value': 'foo'}};
+  return webdriver.WebDriver.toWireValue_({
+    'sessionId': {
+      'value': new webdriver.Session('foo', {})
+    }
+  }).then(function(actual) {
+    webdriver.test.testutil.assertObjectEquals(expected, actual);
+  });
+}
+
+
+function testToWireValue_capabilities() {
+  var prefs = new webdriver.logging.Preferences();
+  prefs.setLevel(webdriver.logging.Type.BROWSER,
+      webdriver.logging.Level.DEBUG);
+
+  var caps = webdriver.Capabilities.chrome();
+  caps.set(webdriver.Capability.LOGGING_PREFS, prefs);
+
+  return webdriver.WebDriver.toWireValue_(caps).then(function(actual) {
+    webdriver.test.testutil.assertObjectEquals({
+      'browserName': 'chrome',
+      'loggingPrefs': {
+        'browser': 'DEBUG'
+      }
+    }, actual);
+  });
+}
+
+
+function testToWireValue_webElement() {
+  var expected = {};
+  expected[webdriver.WebElement.ELEMENT_KEY] = 'fefifofum';
+
+  var element = new webdriver.WebElement(STUB_DRIVER, expected);
+  return webdriver.WebDriver.toWireValue_(element).then(function(actual) {
+    webdriver.test.testutil.assertObjectEquals(expected, actual);
+  });
+}
+
+
+function testToWireValue_webElementPromise() {
+  var expected = {};
+  expected[webdriver.WebElement.ELEMENT_KEY] = 'fefifofum';
+
+  var element = new webdriver.WebElement(STUB_DRIVER, expected);
+  var elementPromise = new webdriver.WebElementPromise(STUB_DRIVER,
+      webdriver.promise.fulfilled(element));
+  return webdriver.WebDriver.toWireValue_(elementPromise).
+      then(function(actual) {
+        webdriver.test.testutil.assertObjectEquals(expected, actual);
+      });
+}
+
+
+function testToWireValue_domElement() {
+  assertThrows(
+      goog.partial(webdriver.WebDriver.toWireValue_, document.body));
+}
+
+
+function testToWireValue_serializableObject() {
+  /**
+   * @constructor
+   * @extends {webdriver.Serializable}
+   */
+  var CustomSerializable = function () {
+    webdriver.Serializable.call(this);
+  };
+  goog.inherits(CustomSerializable, webdriver.Serializable);
+
+  /** @override */
+  CustomSerializable.prototype.serialize = function() {
+    return webdriver.promise.fulfilled({
+      name: webdriver.promise.fulfilled('bob'),
+      age: 30
+    });
+  };
+
+  var obj = new CustomSerializable();
+  return webdriver.WebDriver.toWireValue_(obj).
+      then(function(actual) {
+        webdriver.test.testutil.assertObjectEquals(
+            {name: 'bob', age: 30}, actual);
+      });
+}
+
+
+function testToWireValue_simpleArray() {
+  var expected = ['foo'];
+  return webdriver.WebDriver.toWireValue_([new webdriver.Session('foo', {})]).
+      then(function(actual) {
+        assertArrayEquals(expected, actual);
+      });
+}
+
+
+function testToWireValue_arrayWithWebElement() {
+  var elementJson = {};
+  elementJson[webdriver.WebElement.ELEMENT_KEY] = 'fefifofum';
+
+  var element = new webdriver.WebElement(STUB_DRIVER, elementJson);
+  return webdriver.WebDriver.toWireValue_([element]).
+      then(function(actual) {
+        assertTrue(goog.isArray(actual));
+        assertEquals(1, actual.length);
+        webdriver.test.testutil.assertObjectEquals(elementJson, actual[0]);
+      });
+}
+
+
+function testToWireValue_arrayWithWebElementPromise() {
+  var elementJson = {};
+  elementJson[webdriver.WebElement.ELEMENT_KEY] = 'fefifofum';
+
+  var element = new webdriver.WebElement(STUB_DRIVER, elementJson);
+  var elementPromise = new webdriver.WebElementPromise(STUB_DRIVER,
+      webdriver.promise.fulfilled(element));
+
+  return webdriver.WebDriver.toWireValue_([elementPromise]).
+      then(function(actual) {
+        assertTrue(goog.isArray(actual));
+        assertEquals(1, actual.length);
+        webdriver.test.testutil.assertObjectEquals(elementJson, actual[0]);
+      });
+}
+
+
+function testToWireValue_complexArray() {
+  var elementJson = {};
+  elementJson[webdriver.WebElement.ELEMENT_KEY] = 'fefifofum';
+  var expected = ['abc', 123, true, elementJson, [123, {'foo': 'bar'}]];
+
+  var element = new webdriver.WebElement(STUB_DRIVER, elementJson);
+  var input = ['abc', 123, true, element, [123, {'foo': 'bar'}]];
+  return webdriver.WebDriver.toWireValue_(input).
+      then(function(actual) {
+        webdriver.test.testutil.assertObjectEquals(expected, actual);
+      });
+}
+
+
+function testToWireValue_arrayWithNestedPromises() {
+  return webdriver.WebDriver.toWireValue_([
+    'abc',
+    webdriver.promise.fulfilled([
+      123,
+     webdriver.promise.fulfilled(true)
+    ])
+  ]).then(function(actual) {
+    assertEquals(2, actual.length);
+    assertEquals('abc', actual[0]);
+    assertArrayEquals([123, true], actual[1]);
+  });
+}
+
+
+function testToWireValue_complexHash() {
+  var elementJson = {};
+  elementJson[webdriver.WebElement.ELEMENT_KEY] = 'fefifofum';
+  var expected = {
+    'script': 'return 1',
+    'args': ['abc', 123, true, elementJson, [123, {'foo': 'bar'}]],
+    'sessionId': 'foo'
+  };
+
+  var element = new webdriver.WebElement(STUB_DRIVER, elementJson);
+  var parameters = {
+    'script': 'return 1',
+    'args':['abc', 123, true, element, [123, {'foo': 'bar'}]],
+    'sessionId': new webdriver.Session('foo', {})
+  };
+
+  return webdriver.WebDriver.toWireValue_(parameters).
+      then(function(actual) {
+        webdriver.test.testutil.assertObjectEquals(expected, actual);
+      });
+}
+
+
+function testFromWireValue_primitives() {
+  assertEquals(1, webdriver.WebDriver.fromWireValue_({}, 1));
+  assertEquals('', webdriver.WebDriver.fromWireValue_({}, ''));
+  assertEquals(true, webdriver.WebDriver.fromWireValue_({}, true));
+
+  assertUndefined(webdriver.WebDriver.fromWireValue_({}, undefined));
+  assertNull(webdriver.WebDriver.fromWireValue_({}, null));
+}
+
+
+function testFromWireValue_webElements() {
+  var json = {};
+  json[webdriver.WebElement.ELEMENT_KEY] = 'foo';
+
+  var element = webdriver.WebDriver.fromWireValue_(STUB_DRIVER, json);
+  assertEquals(STUB_DRIVER, element.getDriver());
+
+  return element.getId().then(function(id) {
+    webdriver.test.testutil.assertObjectEquals(json, id);
+  });
+}
+
+
+function testFromWireValue_simpleObject() {
+  var json = {'sessionId': 'foo'};
+  var out = webdriver.WebDriver.fromWireValue_({}, json);
+  webdriver.test.testutil.assertObjectEquals(json, out);
+}
+
+
+function testFromWireValue_nestedObject() {
+  var json = {'foo': {'bar': 123}};
+  var out = webdriver.WebDriver.fromWireValue_({}, json);
+  webdriver.test.testutil.assertObjectEquals(json, out);
+}
+
+
+function testFromWireValue_array() {
+  var json = [{'foo': {'bar': 123}}];
+  var out = webdriver.WebDriver.fromWireValue_({}, json);
+  webdriver.test.testutil.assertObjectEquals(json, out);
+}
+
+
+function testFromWireValue_passesThroughFunctionProperties() {
+  var json = [{'foo': {'bar': 123}, 'func': goog.nullFunction}];
+  var out = webdriver.WebDriver.fromWireValue_({}, json);
+  webdriver.test.testutil.assertObjectEquals(json, out);
+}
+
+
+function testDoesNotExecuteCommandIfSessionDoesNotResolve() {
+  var session = webdriver.promise.rejected(new StubError);
+  var testHelper = new TestHelper().replayAll();
+  testHelper.createDriver(session).getTitle();
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testCommandReturnValuesArePassedToFirstCallback() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).andReturnSuccess('Google Search').
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.getTitle().then(function(title) {
+    assertEquals('Google Search', title);
+  });
+}
+
+
+function testStopsCommandExecutionWhenAnErrorOccurs() {
+  var testHelper = new TestHelper().
+      expect(CName.SWITCH_TO_WINDOW).
+      withParameters({'name': 'foo'}).
+      andReturnError(ECode.NO_SUCH_WINDOW, {'message': 'window not found'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.switchTo().window('foo');
+  driver.getTitle();  // mock should blow if this gets executed
+
+  return waitForAbort().
+      then(expectedError(ECode.NO_SUCH_WINDOW, 'window not found'));
+}
+
+
+function testCanSuppressCommandFailures() {
+  var testHelper = new TestHelper().
+      expect(CName.SWITCH_TO_WINDOW).
+          withParameters({'name': 'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message': 'window not found'}).
+      expect(CName.GET_TITLE).
+          andReturnSuccess('Google Search').
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.switchTo().window('foo').thenCatch(function(e) {
+    assertEquals(ECode.NO_SUCH_WINDOW, e.code);
+    assertEquals('window not found', e.message);
+  });
+  driver.getTitle();
+  return waitForIdle();
+}
+
+
+function testErrorsPropagateUpToTheRunningApplication() {
+  var testHelper = new TestHelper().
+      expect(CName.SWITCH_TO_WINDOW).
+          withParameters({'name':'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message': 'window not found'}).
+      replayAll();
+
+  testHelper.createDriver().switchTo().window('foo');
+  return waitForAbort().
+      then(expectedError(ECode.NO_SUCH_WINDOW, 'window not found'));
+}
+
+
+function testErrbacksThatReturnErrorsStillSwitchToCallbackChain() {
+  var testHelper = new TestHelper().
+      expect(CName.SWITCH_TO_WINDOW).
+          withParameters({'name':'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message':'window not found'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.switchTo().window('foo').
+      thenCatch(function() { return new StubError; });
+      then(assertIsStubError);
+}
+
+
+function testErrbacksThrownCanOverrideOriginalError() {
+  var testHelper = new TestHelper().
+      expect(CName.SWITCH_TO_WINDOW, {'name': 'foo'}).
+      andReturnError(ECode.NO_SUCH_WINDOW, {'message':'window not found'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.switchTo().window('foo').thenCatch(throwStubError);
+
+  return waitForAbort().then(assertIsStubError);
+}
+
+
+function testCannotScheduleCommandsIfTheSessionIdHasBeenDeleted() {
+  var testHelper = new TestHelper().replayAll();
+  var driver = testHelper.createDriver();
+  delete driver.session_;
+  assertThrows(goog.bind(driver.get, driver, 'http://www.google.com'));
+}
+
+
+function testDeletesSessionIdAfterQuitting() {
+  var driver;
+  var testHelper = new TestHelper().
+      expect(CName.QUIT).
+      replayAll();
+
+  driver = testHelper.createDriver();
+  return driver.quit().then(function() {
+    assertUndefined('Session ID should have been deleted', driver.session_);
+  });
+}
+
+
+function testReportsErrorWhenExecutingCommandsAfterExecutingAQuit() {
+  var testHelper = new TestHelper().
+      expect(CName.QUIT).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.quit();
+  driver.get('http://www.google.com');
+  return waitForAbort().
+      then(expectedError(undefined,
+          'This driver instance does not have a valid session ID ' +
+          '(did you call WebDriver.quit()?) and may no longer be used.'));
+}
+
+
+function testCallbackCommandsExecuteBeforeNextCommand() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_CURRENT_URL).
+      expect(CName.GET, {'url': 'http://www.google.com'}).
+      expect(CName.CLOSE).
+      expect(CName.GET_TITLE).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.getCurrentUrl().then(function() {
+    driver.get('http://www.google.com').then(function() {
+      driver.close();
+    });
+  });
+  driver.getTitle();
+
+  return waitForIdle();
+}
+
+
+function testEachCallbackFrameRunsToCompletionBeforeTheNext() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+      expect(CName.GET_CURRENT_URL).
+      expect(CName.GET_CURRENT_WINDOW_HANDLE).
+      expect(CName.CLOSE).
+      expect(CName.QUIT).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.getTitle().
+      // Everything in this callback...
+      then(function() {
+        driver.getCurrentUrl();
+        driver.getWindowHandle();
+      }).
+      // ...should execute before everything in this callback.
+      then(function() {
+        driver.close();
+      });
+  // This should execute after everything above
+  driver.quit();
+
+  return waitForIdle();
+}
+
+
+function testNestedCommandFailuresBubbleUpToGlobalHandlerIfUnsuppressed() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+      expect(CName.SWITCH_TO_WINDOW, {'name': 'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message':'window not found'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.getTitle().then(function() {
+    driver.switchTo().window('foo');
+  });
+
+  return waitForAbort().
+      then(expectedError(ECode.NO_SUCH_WINDOW, 'window not found'));
+}
+
+
+function testNestedCommandFailuresCanBeSuppressWhenTheyOccur() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+      expect(CName.SWITCH_TO_WINDOW, {'name':'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message':'window not found'}).
+      expect(CName.CLOSE).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.getTitle().then(function() {
+    driver.switchTo().window('foo').thenCatch(goog.nullFunction);
+  });
+  driver.close();
+
+  return waitForIdle();
+}
+
+
+function testNestedCommandFailuresBubbleUpThroughTheFrameStack() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+      expect(CName.SWITCH_TO_WINDOW, {'name':'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message':'window not found'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.getTitle().
+      then(function() {
+        return driver.switchTo().window('foo');
+      }).
+      thenCatch(function(e) {
+        assertEquals(ECode.NO_SUCH_WINDOW, e.code);
+        assertEquals('window not found', e.message);
+      });
+
+  return waitForIdle();
+}
+
+
+function testNestedCommandFailuresCanBeCaughtAndSuppressed() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+      expect(CName.GET_CURRENT_URL).
+      expect(CName.SWITCH_TO_WINDOW, {'name':'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message':'window not found'}).
+      expect(CName.CLOSE).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.getTitle().then(function() {
+    driver.getCurrentUrl().
+        then(function() {
+          return driver.switchTo().window('foo');
+        }).
+        thenCatch(goog.nullFunction);
+    driver.close();
+  });
+
+  return waitForIdle();
+}
+
+
+function testReturningADeferredResultFromACallback() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+      expect(CName.GET_CURRENT_URL).
+          andReturnSuccess('http://www.google.com').
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.getTitle().
+      then(function() {
+        return driver.getCurrentUrl();
+      }).
+      then(function(value) {
+        assertEquals('http://www.google.com', value);
+      });
+  return waitForIdle();
+}
+
+
+function testReturningADeferredResultFromAnErrbackSuppressesTheError() {
+  var count = 0;
+  var testHelper = new TestHelper().
+      expect(CName.SWITCH_TO_WINDOW, {'name':'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message':'window not found'}).
+      expect(CName.GET_CURRENT_URL).
+          andReturnSuccess('http://www.google.com').
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.switchTo().window('foo').
+      thenCatch(function(e) {
+        assertEquals(ECode.NO_SUCH_WINDOW, e.code);
+        assertEquals('window not found', e.message);
+        count += 1;
+        return driver.getCurrentUrl();
+      }).
+      then(function(url) {
+        count += 1;
+        assertEquals('http://www.google.com', url);
+      });
+  return waitForIdle().then(function() {
+    assertEquals(2, count);
+  });
+}
+
+
+function testExecutingACustomFunctionThatReturnsANonDeferred() {
+  var testHelper = new TestHelper().replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.call(goog.functions.constant('abc123')).then(function(value) {
+    assertEquals('abc123', value);
+  });
+}
+
+
+function testExecutionOrderwithCustomFunctions() {
+  var msg = [];
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).andReturnSuccess('cheese ').
+      expect(CName.GET_CURRENT_URL).andReturnSuccess('tasty').
+      replayAll();
+
+  var driver = testHelper.createDriver();
+
+  var pushMsg = goog.bind(msg.push, msg);
+  driver.getTitle().then(pushMsg);
+  driver.call(goog.functions.constant('is ')).then(pushMsg);
+  driver.getCurrentUrl().then(pushMsg);
+  driver.call(goog.functions.constant('!')).then(pushMsg);
+
+  return waitForIdle().then(function() {
+    assertEquals('cheese is tasty!', msg.join(''));
+  });
+}
+
+
+function testPassingArgumentsToACustomFunction() {
+  var testHelper = new TestHelper().replayAll();
+
+  var add = function(a, b) {
+    return a + b;
+  };
+  var driver = testHelper.createDriver();
+  return driver.call(add, null, 1, 2).then(function(value) {
+    assertEquals(3, value);
+  });
+}
+
+function testPassingPromisedArgumentsToACustomFunction() {
+  var testHelper = new TestHelper().replayAll();
+
+  var promisedArg = webdriver.promise.fulfilled(2);
+  var add = function(a, b) {
+    return a + b;
+  };
+  var driver = testHelper.createDriver();
+  return driver.call(add, null, 1, promisedArg).then(function(value) {
+    assertEquals(3, value);
+  });
+}
+
+function testPassingArgumentsAndScopeToACustomFunction() {
+  function Foo(name) {
+    this.name = name;
+  }
+  Foo.prototype.getName = function() {
+    return this.name;
+  };
+  var foo = new Foo('foo');
+
+  var testHelper = new TestHelper().replayAll();
+  var driver = testHelper.createDriver();
+  return driver.call(foo.getName, foo).then(function(value) {
+    assertEquals('foo', value);
+  });
+}
+
+
+function testExecutingACustomFunctionThatThrowsAnError() {
+  var testHelper = new TestHelper().replayAll();
+  var driver = testHelper.createDriver();
+  return driver.call(goog.functions.error('bam!')).then(fail, function(e) {
+    assertTrue(e instanceof Error);
+    assertEquals('bam!', e.message);
+  });
+}
+
+
+function testExecutingACustomFunctionThatSchedulesCommands() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+      expect(CName.CLOSE).
+      expect(CName.QUIT).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.call(function() {
+    driver.getTitle();
+    driver.close();
+  });
+  driver.quit();
+  return waitForIdle();
+}
+
+
+function testExecutingAFunctionThatReturnsATaskResultAfterSchedulingAnother() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+          andReturnSuccess('Google Search').
+      expect(CName.CLOSE).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.call(function() {
+    var title = driver.getTitle();
+    driver.close();
+    return title;
+  }).then(function(title) {
+    assertEquals('Google Search', title);
+  });
+}
+
+
+function testExecutingACustomFunctionWhoseNestedCommandFails() {
+  var testHelper = new TestHelper().
+      expect(CName.SWITCH_TO_WINDOW, {'name': 'foo'}).
+          andReturnError(ECode.NO_SUCH_WINDOW, {'message':'window not found'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.call(function() {
+    return driver.switchTo().window('foo');
+  }).then(fail, function(e) {
+    assertEquals(ECode.NO_SUCH_WINDOW, e.code);
+    assertEquals('window not found', e.message);
+  });
+}
+
+
+function testCustomFunctionDoesNotCompleteUntilReturnedPromiseIsResolved() {
+  var testHelper = new TestHelper().replayAll();
+
+  var order = [];
+  var driver = testHelper.createDriver();
+
+  var d = webdriver.promise.defer();
+  d.promise.then(function() {
+    order.push('b');
+  });
+
+  driver.call(function() {
+    order.push('a');
+    return d.promise;
+  });
+  driver.call(function() {
+    order.push('c');
+  });
+
+  // timeout to ensure the first function starts its execution before we
+  // trigger d's callbacks.
+  webdriver.promise.delayed(0).then(function() {
+    assertArrayEquals(['a'], order);
+    d.fulfill();
+  });
+  return waitForIdle().then(function() {
+    assertArrayEquals(['a', 'b', 'c'], order);
+  });
+}
+
+
+function testNestedFunctionCommandExecutionOrder() {
+  var msg = [];
+  var testHelper = new TestHelper().replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.call(msg.push, msg, 'a');
+  driver.call(function() {
+    driver.call(msg.push, msg, 'c');
+    driver.call(function() {
+      driver.call(msg.push, msg, 'e');
+      driver.call(msg.push, msg, 'f');
+    });
+    driver.call(msg.push, msg, 'd');
+  });
+  driver.call(msg.push, msg, 'b');
+  return waitForIdle().then(function() {
+    assertEquals('acefdb', msg.join(''));
+  });
+}
+
+
+function testExecutingNestedFunctionCommands() {
+  var msg = [];
+  var testHelper = new TestHelper().replayAll();
+  var driver = testHelper.createDriver();
+  var pushMsg = goog.bind(msg.push, msg);
+  driver.call(goog.functions.constant('cheese ')).then(pushMsg);
+  driver.call(function() {
+    driver.call(goog.functions.constant('is ')).then(pushMsg);
+    driver.call(goog.functions.constant('tasty')).then(pushMsg);
+  });
+  driver.call(goog.functions.constant('!')).then(pushMsg);
+  return waitForIdle().then(function() {
+    assertEquals('cheese is tasty!', msg.join(''));
+  });
+}
+
+
+function testReturnValuesFromNestedFunctionCommands() {
+  var testHelper = new TestHelper().replayAll();
+  var driver = testHelper.createDriver();
+  return driver.call(function() {
+    return driver.call(function() {
+      return driver.call(goog.functions.constant('foobar'));
+    });
+  }).then(function(value) {
+    assertEquals('foobar', value);
+  });
+}
+
+
+function testExecutingANormalCommandAfterNestedCommandsThatReturnsAnAction() {
+  var msg = [];
+  var testHelper = new TestHelper().
+      expect(CName.CLOSE).
+      replayAll();
+  var driver = testHelper.createDriver();
+  driver.call(function() {
+    return driver.call(function() {
+      msg.push('a');
+      return driver.call(goog.functions.constant('foobar'));
+    });
+  });
+  driver.close().then(function() {
+    msg.push('b');
+  });
+  return waitForIdle().then(function() {
+    assertEquals('ab', msg.join(''));
+  });
+}
+
+
+function testNestedCommandErrorsBubbleUp_caught() {
+  var testHelper = new TestHelper().replayAll();
+  var driver = testHelper.createDriver();
+  var result = driver.call(function() {
+    return driver.call(function() {
+      return driver.call(goog.functions.error('bam!'));
+    });
+  }).then(fail, expectedError(undefined, 'bam!'));
+  return goog.Promise.all([waitForIdle(), result]);
+}
+
+
+function testNestedCommandErrorsBubbleUp_uncaught() {
+  var testHelper = new TestHelper().replayAll();
+  var driver = testHelper.createDriver();
+  driver.call(function() {
+    return driver.call(function() {
+      return driver.call(goog.functions.error('bam!'));
+    });
+  });
+  return waitForAbort().then(expectedError(undefined, 'bam!'));
+}
+
+
+function testExecutingNestedCustomFunctionsThatSchedulesCommands() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).
+      expect(CName.CLOSE).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.call(function() {
+    driver.call(function() {
+      driver.getTitle();
+    });
+    driver.close();
+  });
+  return waitForIdle();
+}
+
+
+function testExecutingACustomFunctionThatReturnsADeferredAction() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_TITLE).andReturnSuccess('Google').
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.call(function() {
+    return driver.getTitle();
+  }).then(function(title) {
+    assertEquals('Google', title);
+  });
+  return waitForIdle();
+}
+
+function testWebElementPromise_resolvesWhenUnderlyingElementDoes() {
+  var el = new webdriver.WebElement(STUB_DRIVER, {'ELEMENT': 'foo'});
+  var promise = webdriver.promise.fulfilled(el);
+  return new webdriver.WebElementPromise(STUB_DRIVER, promise).
+      then(function(e) {
+        assertEquals(e, el);
+      });
+}
+
+function testWebElement_resolvesBeforeCallbacksOnWireValueTrigger() {
+  var el = new webdriver.promise.Deferred();
+
+  var element = new webdriver.WebElementPromise(STUB_DRIVER, el.promise);
+  var messages = [];
+
+  element.then(function() {
+    messages.push('element resolved');
+  });
+  element.getId().then(function() {
+    messages.push('wire value resolved');
+  });
+
+  assertArrayEquals([], messages);
+  el.fulfill(new webdriver.WebElement(STUB_DRIVER, {'ELEMENT': 'foo'}));
+  return waitForIdle().then(function() {
+    assertArrayEquals([
+      'element resolved',
+      'wire value resolved'
+    ], messages);
+  });
+}
+
+function testWebElement_isRejectedIfUnderlyingIdIsRejected() {
+  var element = new webdriver.WebElementPromise(
+      STUB_DRIVER, webdriver.promise.rejected(new StubError));
+  return element.then(fail, assertIsStubError);
+}
+
+
+function testExecuteScript_nullReturnValue() {
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return document.body;',
+            'args': []
+          }).
+          andReturnSuccess(null).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.executeScript('return document.body;').then(function(result) {
+    assertNull(result);
+  });
+}
+
+
+function testExecuteScript_primitiveReturnValue() {
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return document.body;',
+            'args': []
+          }).
+          andReturnSuccess(123).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.executeScript('return document.body;').then(function(result) {
+    assertEquals(123, result);
+  });
+}
+
+
+function testExecuteScript_webElementReturnValue() {
+  var json = {};
+  json[webdriver.WebElement.ELEMENT_KEY] = 'foo';
+
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return document.body;',
+            'args': []
+          }).
+          andReturnSuccess(json).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.executeScript('return document.body;').
+      then(function(webelement) {
+        return webdriver.promise.when(webelement.id_, function(id) {
+          webdriver.test.testutil.assertObjectEquals(id, json);
+        });
+      });
+}
+
+
+function testExecuteScript_arrayReturnValue() {
+  var json = [{}];
+  json[0][webdriver.WebElement.ELEMENT_KEY] = 'foo';
+
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return document.body;',
+            'args': []
+          }).
+          andReturnSuccess(json).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.executeScript('return document.body;').
+      then(function(array) {
+        return webdriver.promise.when(array[0].id_, function(id) {
+          webdriver.test.testutil.assertObjectEquals(id, json[0]);
+        });
+      });
+}
+
+
+function testExecuteScript_objectReturnValue() {
+  var json = {'foo':{}};
+  json['foo'][webdriver.WebElement.ELEMENT_KEY] = 'foo';
+
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return document.body;',
+            'args': []
+          }).
+          andReturnSuccess(json).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var callback;
+  return driver.executeScript('return document.body;').
+      then(function(obj) {
+        return webdriver.promise.when(obj['foo'].id_, function(id) {
+          webdriver.test.testutil.assertObjectEquals(id, json['foo']);
+        });
+      });
+}
+
+
+function testExecuteScript_scriptAsFunction() {
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return (' + goog.nullFunction +
+                      ').apply(null, arguments);',
+            'args': []
+          }).
+          andReturnSuccess(null).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.executeScript(goog.nullFunction);
+}
+
+
+function testExecuteScript_simpleArgumentConversion() {
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return 1;',
+            'args': ['abc', 123, true, [123, {'foo': 'bar'}]]
+          }).
+          andReturnSuccess(null).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.executeScript(
+      'return 1;', 'abc', 123, true, [123, {'foo': 'bar'}]);
+}
+
+
+function testExecuteScript_webElementArgumentConversion() {
+  var elementJson = {};
+  elementJson[webdriver.WebElement.ELEMENT_KEY] = 'fefifofum';
+
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return 1;',
+            'args': [elementJson]
+          }).
+          andReturnSuccess(null).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.executeScript('return 1;',
+      new webdriver.WebElement(driver, elementJson));
+}
+
+
+function testExecuteScript_webElementPromiseArgumentConversion() {
+  var elementJson = {'ELEMENT':'bar'};
+
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+          andReturnSuccess(elementJson).
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return 1;',
+            'args': [elementJson]
+          }).
+          andReturnSuccess(null).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = driver.findElement(By.id('foo'));
+  return driver.executeScript('return 1;', element);
+}
+
+
+function testExecuteScript_argumentConversion() {
+  var elementJson = {};
+  elementJson[webdriver.WebElement.ELEMENT_KEY] = 'fefifofum';
+
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'return 1;',
+            'args': ['abc', 123, true, elementJson, [123, {'foo': 'bar'}]]
+          }).
+          andReturnSuccess(null).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = new webdriver.WebElement(driver, elementJson);
+  return driver.executeScript('return 1;',
+      'abc', 123, true, element, [123, {'foo': 'bar'}]);
+}
+
+
+function testExecuteScript_scriptReturnsAnError() {
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT).
+          withParameters({
+            'script': 'throw Error(arguments[0]);',
+            'args': ['bam']
+          }).
+          andReturnError(ECode.UNKNOWN_ERROR, {'message':'bam'}).
+      replayAll();
+  var driver = testHelper.createDriver();
+  return driver.executeScript('throw Error(arguments[0]);', 'bam').
+      then(fail, expectedError(ECode.UNKNOWN_ERROR, 'bam'));
+}
+
+
+function testExecuteScript_failsIfArgumentIsARejectedPromise() {
+  var testHelper = new TestHelper().replayAll();
+
+  var arg = webdriver.promise.rejected(new StubError);
+  arg.thenCatch(goog.nullFunction);  // Suppress default handler.
+
+  var driver = testHelper.createDriver();
+  return driver.executeScript(goog.nullFunction, arg).
+      then(fail, assertIsStubError);
+}
+
+
+function testExecuteAsyncScript_failsIfArgumentIsARejectedPromise() {
+  var testHelper = new TestHelper().replayAll();
+
+  var arg = webdriver.promise.rejected(new StubError);
+  arg.thenCatch(goog.nullFunction);  // Suppress default handler.
+
+  var driver = testHelper.createDriver();
+  return driver.executeAsyncScript(goog.nullFunction, arg).
+      then(fail, assertIsStubError);
+}
+
+
+function testFindElement_elementNotFound() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+      andReturnError(ECode.NO_SUCH_ELEMENT, {
+          'message':'Unable to find element'
+      }).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = driver.findElement(By.id('foo'));
+  element.click();  // This should never execute.
+  return waitForAbort().then(
+      expectedError(ECode.NO_SUCH_ELEMENT, 'Unable to find element'));
+}
+
+
+function testFindElement_elementNotFoundInACallback() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+      andReturnError(
+          ECode.NO_SUCH_ELEMENT, {'message':'Unable to find element'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  webdriver.promise.fulfilled().then(function() {
+    var element = driver.findElement(By.id('foo'));
+    return element.click();  // Should not execute.
+  });
+  return waitForAbort().then(
+      expectedError(ECode.NO_SUCH_ELEMENT, 'Unable to find element'));
+}
+
+
+function testFindElement_elementFound() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+          andReturnSuccess({'ELEMENT':'bar'}).
+      expect(CName.CLICK_ELEMENT, {'id':{'ELEMENT':'bar'}}).
+          andReturnSuccess().
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = driver.findElement(By.id('foo'));
+  element.click();
+  return waitForIdle();
+}
+
+
+function testFindElement_canUseElementInCallback() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+          andReturnSuccess({'ELEMENT':'bar'}).
+      expect(CName.CLICK_ELEMENT, {'id':{'ELEMENT':'bar'}}).
+          andReturnSuccess().
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.findElement(By.id('foo')).then(function(element) {
+    element.click();
+  });
+  return waitForIdle();
+}
+
+
+function testFindElement_byJs() {
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {
+        'script': 'return document.body',
+        'args': []
+      }).
+      andReturnSuccess({'ELEMENT':'bar'}).
+      expect(CName.CLICK_ELEMENT, {'id':{'ELEMENT':'bar'}}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = driver.findElement(By.js('return document.body'));
+  element.click();  // just to make sure
+  return waitForIdle();
+}
+
+
+function testFindElement_byJs_returnsNonWebElementValue() {
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {'script': 'return 123', 'args': []}).
+      andReturnSuccess(123).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = driver.findElement(By.js('return 123'));
+  element.click();  // Should not execute.
+  return waitForAbort().then(function(e) {
+    assertEquals(
+        'Not the expected error message',
+        'Custom locator did not return a WebElement', e.message);
+  });
+}
+
+
+function testFindElement_byJs_canPassArguments() {
+  var script = 'return document.getElementsByTagName(arguments[0]);';
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {
+        'script': script,
+        'args': ['div']
+      }).
+      andReturnSuccess({'ELEMENT':'one'}).
+      replayAll();
+  var driver = testHelper.createDriver();
+  driver.findElement(By.js(script, 'div'));
+  return waitForIdle();
+}
+
+
+function testFindElement_customLocator() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENTS, {'using':'tag name', 'value':'a'}).
+      andReturnSuccess([{'ELEMENT':'foo'}, {'ELEMENT':'bar'}]).
+      expect(CName.CLICK_ELEMENT, {'id':{'ELEMENT':'foo'}}).
+      andReturnSuccess().
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = driver.findElement(function(d) {
+    assertEquals(driver, d);
+    return d.findElements(By.tagName('a'));
+  });
+  element.click();
+  return waitForIdle();
+}
+
+
+function testFindElement_customLocatorThrowsIfResultIsNotAWebElement() {
+  var testHelper = new TestHelper().replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.findElement(function() {
+    return 1;
+  });
+  return waitForAbort().then(function(e) {
+    assertEquals(
+        'Not the expected error message',
+        'Custom locator did not return a WebElement', e.message);
+  });
+}
+
+
+function testIsElementPresent_elementNotFound() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENTS, {'using':'id', 'value':'foo'}).
+      andReturnSuccess([]).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.isElementPresent(By.id('foo')).then(assertFalse);
+}
+
+
+function testIsElementPresent_elementFound() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENTS, {'using':'id', 'value':'foo'}).
+      andReturnSuccess([{'ELEMENT':'bar'}]).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.isElementPresent(By.id('foo')).then(assertTrue);
+}
+
+
+function testIsElementPresent_letsErrorsPropagate() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENTS, {'using':'id', 'value':'foo'}).
+      andReturnError(ECode.UNKNOWN_ERROR, {'message':'There is no spoon'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.isElementPresent(By.id('foo'));
+  return waitForAbort().then(
+      expectedError(ECode.UNKNOWN_ERROR, 'There is no spoon'));
+}
+
+
+function testIsElementPresent_byJs() {
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {'script': 'return 123', 'args': []}).
+      andReturnSuccess([{'ELEMENT':'bar'}]).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.isElementPresent(By.js('return 123')).then(assertTrue);
+}
+
+
+function testIsElementPresent_byJs_canPassScriptArguments() {
+  var script = 'return document.getElementsByTagName(arguments[0]);';
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {
+        'script': script,
+        'args': ['div']
+      }).
+      andReturnSuccess({'ELEMENT':'one'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.isElementPresent(By.js(script, 'div'));
+  return waitForIdle();
+}
+
+
+function testFindElements() {
+  var json = [
+      {'ELEMENT':'foo'},
+      {'ELEMENT':'bar'},
+      {'ELEMENT':'baz'}
+  ];
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENTS, {'using':'tag name', 'value':'a'}).
+      andReturnSuccess(json).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.findElements(By.tagName('a')).then(function(elements) {
+    assertEquals(3, elements.length);
+
+    var callbacks = new Array(3);
+    assertTypeAndId(0);
+    assertTypeAndId(1);
+    assertTypeAndId(2);
+
+    return webdriver.promise.all(callbacks);
+
+    function assertTypeAndId(index) {
+      assertTrue('Not a WebElement at index ' + index,
+          elements[index] instanceof webdriver.WebElement);
+      callbacks[index] = elements[index].getId().then(function(id) {
+        webdriver.test.testutil.assertObjectEquals(json[index], id);
+      });
+    }
+  });
+}
+
+
+function testFindElements_byJs() {
+  var json = [
+      {'ELEMENT':'foo'},
+      {'ELEMENT':'bar'},
+      {'ELEMENT':'baz'}
+  ];
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {
+        'script': 'return document.getElementsByTagName("div");',
+        'args': []
+      }).
+      andReturnSuccess(json).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+
+  return driver.
+      findElements(By.js('return document.getElementsByTagName("div");')).
+      then(function(elements) {
+        var callbacks = new Array(3);
+        assertEquals(3, elements.length);
+
+        assertTypeAndId(0);
+        assertTypeAndId(1);
+        assertTypeAndId(2);
+        return webdriver.promise.all(callbacks);
+
+        function assertTypeAndId(index) {
+          assertTrue('Not a WebElement at index ' + index,
+              elements[index] instanceof webdriver.WebElement);
+          callbacks[index] = elements[index].getId().then(function(id) {
+            webdriver.test.testutil.assertObjectEquals(json[index], id);
+          });
+        }
+      });
+}
+
+
+function testFindElements_byJs_filtersOutNonWebElementResponses() {
+  var json = [
+      {'ELEMENT':'foo'},
+      123,
+      'a',
+      false,
+      {'ELEMENT':'bar'},
+      {'not a web element': 1},
+      {'ELEMENT':'baz'}
+  ];
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {
+        'script': 'return document.getElementsByTagName("div");',
+        'args': []
+      }).
+      andReturnSuccess(json).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.findElements(By.js('return document.getElementsByTagName("div");')).
+      then(function(elements) {
+        assertEquals(3, elements.length);
+        var callbacks = new Array(3);
+        assertTypeAndId(0, 0);
+        assertTypeAndId(1, 4);
+        assertTypeAndId(2, 6);
+        return webdriver.promise.all(callbacks);
+
+        function assertTypeAndId(index, jsonIndex) {
+          assertTrue('Not a WebElement at index ' + index,
+              elements[index] instanceof webdriver.WebElement);
+          callbacks[index] = elements[index].getId().then(function(id) {
+            webdriver.test.testutil.assertObjectEquals(json[jsonIndex], id);
+          });
+        }
+      });
+  return waitForIdle();
+}
+
+
+function testFindElements_byJs_convertsSingleWebElementResponseToArray() {
+  var json = {'ELEMENT':'foo'};
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {
+        'script': 'return document.getElementsByTagName("div");',
+        'args': []
+      }).
+      andReturnSuccess(json).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.
+      findElements(By.js('return document.getElementsByTagName("div");')).
+      then(function(elements) {
+        assertEquals(1, elements.length);
+        assertTrue(elements[0] instanceof webdriver.WebElement);
+        return elements[0].getId().then(function(id) {
+          webdriver.test.testutil.assertObjectEquals(json, id);
+        });
+      });
+}
+
+
+function testFindElements_byJs_canPassScriptArguments() {
+  var script = 'return document.getElementsByTagName(arguments[0]);';
+  var testHelper = new TestHelper().
+      expect(CName.EXECUTE_SCRIPT, {
+        'script': script,
+        'args': ['div']
+      }).
+      andReturnSuccess([{'ELEMENT':'one'}, {'ELEMENT':'two'}]).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.findElements(By.js(script, 'div'));
+  return waitForIdle();
+}
+
+
+function testSendKeysConvertsVarArgsIntoStrings_simpleArgs() {
+  var testHelper = new TestHelper().
+      expect(CName.SEND_KEYS_TO_ELEMENT, {'id':{'ELEMENT':'one'},
+                                          'value':['1','2','abc','3']}).
+          andReturnSuccess().
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = new webdriver.WebElement(driver, {'ELEMENT': 'one'});
+  element.sendKeys(1, 2, 'abc', 3);
+  return waitForIdle();
+}
+
+
+function testSendKeysConvertsVarArgsIntoStrings_promisedArgs() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+          andReturnSuccess({'ELEMENT':'one'}).
+      expect(CName.SEND_KEYS_TO_ELEMENT, {'id':{'ELEMENT':'one'},
+                                          'value':['abc', '123', 'def']}).
+          andReturnSuccess().
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = driver.findElement(By.id('foo'));
+  element.sendKeys(
+      webdriver.promise.fulfilled('abc'), 123,
+      webdriver.promise.fulfilled('def'));
+  return waitForIdle();
+}
+
+
+function testSendKeysWithAFileDetector() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+          andReturnSuccess({'ELEMENT':'one'}).
+      expect(CName.SEND_KEYS_TO_ELEMENT, {'id':{'ELEMENT':'one'},
+                                          'value':['modified/path']}).
+          andReturnSuccess().
+      replayAll();
+
+  var driver = testHelper.createDriver();
+
+  var mockDetector = mockControl.createStrictMock(webdriver.FileDetector);
+  mockDetector.handleFile(driver, 'original/path').
+      $returns(webdriver.promise.fulfilled('modified/path'));
+  mockDetector.$replay();
+
+  driver.setFileDetector(mockDetector);
+
+  var element = driver.findElement(By.id('foo'));
+  element.sendKeys('original/', 'path');
+}
+
+function testElementEquality_isReflexive() {
+  var a = new webdriver.WebElement(STUB_DRIVER, 'foo');
+  return webdriver.WebElement.equals(a, a).then(assertTrue);
+}
+
+function testElementEquals_doesNotSendRpcIfElementsHaveSameId() {
+  var a = new webdriver.WebElement(STUB_DRIVER, 'foo'),
+      b = new webdriver.WebElement(STUB_DRIVER, 'foo'),
+      c = new webdriver.WebElement(STUB_DRIVER, 'foo');
+  return webdriver.promise.all([
+    webdriver.WebElement.equals(a, b).then(
+        goog.partial(assertTrue, 'a should == b!')),
+    webdriver.WebElement.equals(b, a).then(
+        goog.partial(assertTrue, 'symmetry check failed')),
+    webdriver.WebElement.equals(a, c).then(
+        goog.partial(assertTrue, 'a should == c!')),
+    webdriver.WebElement.equals(b, c).then(
+        goog.partial(assertTrue, 'transitive check failed'))
+  ]);
+}
+
+function testElementEquals_sendsRpcIfElementsHaveDifferentIds() {
+  var id1 = {'ELEMENT':'foo'};
+  var id2 = {'ELEMENT':'bar'};
+  var testHelper = new TestHelper().
+      expect(CName.ELEMENT_EQUALS, {'id':id1, 'other':id2}).
+      andReturnSuccess(true).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  var a = new webdriver.WebElement(driver, id1),
+      b = new webdriver.WebElement(driver, id2);
+  return webdriver.WebElement.equals(a, b).then(assertTrue);
+}
+
+
+function testElementEquals_failsIfAnInputElementCouldNotBeFound() {
+  var testHelper = new TestHelper().replayAll();
+
+  var id = webdriver.promise.rejected(new StubError);
+  id.thenCatch(goog.nullFunction);  // Suppress default handler.
+
+  var driver = testHelper.createDriver();
+  var a = new webdriver.WebElement(driver, {'ELEMENT': 'foo'});
+  var b = new webdriver.WebElementPromise(driver, id);
+
+  return webdriver.WebElement.equals(a, b).then(fail, assertIsStubError);
+}
+
+
+function testWaiting_waitSucceeds() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENTS, {'using':'id', 'value':'foo'}).
+          andReturnSuccess([]).
+          times(2).
+      expect(CName.FIND_ELEMENTS, {'using':'id', 'value':'foo'}).
+          andReturnSuccess([{'ELEMENT':'bar'}]).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.wait(function() {
+    return driver.isElementPresent(By.id('foo'));
+  }, 200);
+  return waitForIdle();
+}
+
+
+function testWaiting_waitTimesout_timeoutCaught() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENTS, {'using':'id', 'value':'foo'}).
+          andReturnSuccess([]).
+          anyTimes().
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.wait(function() {
+    return driver.isElementPresent(By.id('foo'));
+  }, 25).then(fail, function(e) {
+    assertEquals('Wait timed out after ',
+        e.message.substring(0, 'Wait timed out after '.length));
+  });
+}
+
+
+function testWaiting_waitTimesout_timeoutNotCaught() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENTS, {'using':'id', 'value':'foo'}).
+          andReturnSuccess([]).
+          anyTimes().
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  driver.wait(function() {
+    return driver.isElementPresent(By.id('foo'));
+  }, 25);
+  return waitForAbort().then(function(e) {
+    assertEquals('Wait timed out after ',
+        e.message.substring(0, 'Wait timed out after '.length));
+  });
+}
+
+function testInterceptsAndTransformsUnhandledAlertErrors() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+      andReturnError(ECode.UNEXPECTED_ALERT_OPEN, {
+        'message': 'boom',
+        'alert': {'text': 'hello'}
+      }).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.findElement(By.id('foo')).then(fail, function(e) {
+    assertTrue(e instanceof webdriver.UnhandledAlertError);
+    assertEquals('hello', e.getAlertText());
+  });
+}
+
+function
+testUnhandledAlertErrors_usesEmptyStringIfAlertTextOmittedFromResponse() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+      andReturnError(ECode.UNEXPECTED_ALERT_OPEN, {'message': 'boom'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.findElement(By.id('foo')).then(fail, function(e) {
+    assertTrue(e instanceof webdriver.UnhandledAlertError);
+    assertEquals('', e.getAlertText());
+  });
+}
+
+function testAlertHandleResolvesWhenPromisedTextResolves() {
+  var promise = new webdriver.promise.Deferred();
+
+  var alert = new webdriver.AlertPromise(STUB_DRIVER, promise);
+  assertTrue(alert.isPending());
+
+  promise.fulfill(new webdriver.Alert(STUB_DRIVER, 'foo'));
+  return alert.getText().then(function(text) {
+    assertEquals('foo', text);
+  });
+}
+
+
+function testWebElementsBelongToSameFlowAsParentDriver() {
+  var testHelper = new TestHelper()
+      .expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'})
+      .andReturnSuccess({'ELEMENT': 'abc123'})
+      .replayAll();
+
+  var driver = testHelper.createDriver();
+  var otherFlow = new webdriver.promise.ControlFlow();
+  otherFlow.execute(function() {
+    driver.findElement({id: 'foo'}).then(function() {
+      assertEquals(
+          'WebElement should belong to the same flow as its parent driver',
+          driver.controlFlow(), webdriver.promise.controlFlow());
+    });
+  });
+
+  assertNotEquals(otherFlow, driver.controlFlow);
+  return goog.Promise.all([
+    waitForIdle(otherFlow),
+    waitForIdle(driver.controlFlow())
+  ]);
+}
+
+
+function testSwitchToAlertThatIsNotPresent() {
+  var testHelper = new TestHelper()
+      .expect(CName.GET_ALERT_TEXT)
+      .andReturnError(ECode.NO_SUCH_ALERT, {'message': 'no alert'})
+      .replayAll();
+
+  var driver = testHelper.createDriver();
+  var alert = driver.switchTo().alert();
+  alert.dismiss();  // Should never execute.
+  return waitForAbort().then(expectedError(ECode.NO_SUCH_ALERT, 'no alert'));
+}
+
+
+function testAlertsBelongToSameFlowAsParentDriver() {
+  var testHelper = new TestHelper()
+      .expect(CName.GET_ALERT_TEXT).andReturnSuccess('hello')
+      .replayAll();
+
+  var driver = testHelper.createDriver();
+  var otherFlow = new webdriver.promise.ControlFlow();
+  otherFlow.execute(function() {
+    driver.switchTo().alert().then(function() {
+      assertEquals(
+          'Alert should belong to the same flow as its parent driver',
+          driver.controlFlow(), webdriver.promise.controlFlow());
+    });
+  });
+
+  assertNotEquals(otherFlow, driver.controlFlow);
+  return goog.Promise.all([
+    waitForIdle(otherFlow),
+    waitForIdle(driver.controlFlow())
+  ]);
+}
+
+function testFetchingLogs() {
+  var testHelper = new TestHelper().
+      expect(CName.GET_LOG, {'type': 'browser'}).
+      andReturnSuccess([
+        new webdriver.logging.Entry(
+            webdriver.logging.Level.INFO, 'hello', 1234),
+        {'level': 'DEBUG', 'message': 'abc123', 'timestamp': 5678}
+      ]).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.manage().logs().get('browser').then(function(entries) {
+    assertEquals(2, entries.length);
+
+    assertTrue(entries[0] instanceof webdriver.logging.Entry);
+    assertEquals(webdriver.logging.Level.INFO.value, entries[0].level.value);
+    assertEquals('hello', entries[0].message);
+    assertEquals(1234, entries[0].timestamp);
+
+    assertTrue(entries[1] instanceof webdriver.logging.Entry);
+    assertEquals(webdriver.logging.Level.DEBUG.value, entries[1].level.value);
+    assertEquals('abc123', entries[1].message);
+    assertEquals(5678, entries[1].timestamp);
+  });
+}
+
+
+function testCommandsFailIfInitialSessionCreationFailed() {
+  var testHelper = new TestHelper().replayAll();
+
+  var session = webdriver.promise.rejected(new StubError);
+
+  var driver = testHelper.createDriver(session);
+  var navigateResult = driver.get('some-url').then(fail, assertIsStubError);
+  var quitResult = driver.quit().then(fail, assertIsStubError);
+
+  return waitForIdle().then(function() {
+    return webdriver.promise.all(navigateResult, quitResult);
+  });
+}
+
+
+function testWebElementCommandsFailIfInitialDriverCreationFailed() {
+  var testHelper = new TestHelper().replayAll();
+
+  var session = webdriver.promise.rejected(new StubError);
+
+  var driver = testHelper.createDriver(session);
+  return driver.findElement(By.id('foo')).click().
+      then(fail, assertIsStubError);
+}
+
+
+function testWebElementCommansFailIfElementCouldNotBeFound() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+          andReturnError(ECode.NO_SUCH_ELEMENT,
+                         {'message':'Unable to find element'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.findElement(By.id('foo')).click().
+      then(fail,
+            expectedError(ECode.NO_SUCH_ELEMENT, 'Unable to find element'));
+}
+
+
+function testCannotFindChildElementsIfParentCouldNotBeFound() {
+  var testHelper = new TestHelper().
+      expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'}).
+      andReturnError(ECode.NO_SUCH_ELEMENT,
+                     {'message':'Unable to find element'}).
+      replayAll();
+
+  var driver = testHelper.createDriver();
+  return driver.findElement(By.id('foo'))
+      .findElement(By.id('bar'))
+      .findElement(By.id('baz'))
+      .then(fail,
+            expectedError(ECode.NO_SUCH_ELEMENT, 'Unable to find element'));
+}
+
+
+function testActionSequenceFailsIfInitialDriverCreationFailed() {
+  var testHelper = new TestHelper().replayAll();
+
+  var session = webdriver.promise.rejected(new StubError);
+
+  // Suppress the default error handler so we can verify it propagates
+  // to the perform() call below.
+  session.thenCatch(goog.nullFunction);
+
+  return testHelper.createDriver(session).
+      actions().
+      mouseDown().
+      mouseUp().
+      perform().
+      thenCatch(assertIsStubError);
+}
+
+
+function testActionSequence_mouseMove_noElement() {
+  var testHelper = new TestHelper()
+      .expect(CName.MOVE_TO, {'xoffset': 0, 'yoffset': 125})
+      .andReturnSuccess()
+      .replayAll();
+
+  return testHelper.createDriver().
+      actions().
+      mouseMove({x: 0, y: 125}).
+      perform();
+}
+
+
+function testActionSequence_mouseMove_element() {
+  var testHelper = new TestHelper()
+      .expect(CName.FIND_ELEMENT, {'using':'id', 'value':'foo'})
+          .andReturnSuccess({'ELEMENT': 'abc123'})
+      .expect(
+          CName.MOVE_TO, {'element': 'abc123', 'xoffset': 0, 'yoffset': 125})
+          .andReturnSuccess()
+      .replayAll();
+
+  var driver = testHelper.createDriver();
+  var element = driver.findElement(By.id('foo'));
+  return driver.actions()
+      .mouseMove(element, {x: 0, y: 125})
+      .perform();
+}
+
+
+function testActionSequence_mouseDown() {
+  var testHelper = new TestHelper()
+      .expect(CName.MOUSE_DOWN, {'button': webdriver.Button.LEFT})
+          .andReturnSuccess()
+      .replayAll();
+
+  return testHelper.createDriver().
+      actions().
+      mouseDown().
+      perform();
+}
+
+
+function testActionSequence() {
+  var testHelper = new TestHelper()
+      .expect(CName.FIND_ELEMENT, {'using':'id', 'value':'a'})
+          .andReturnSuccess({'ELEMENT': 'id1'})
+      .expect(CName.FIND_ELEMENT, {'using':'id', 'value':'b'})
+          .andReturnSuccess({'ELEMENT': 'id2'})
+      .expect(CName.SEND_KEYS_TO_ACTIVE_ELEMENT,
+          {'value': [webdriver.Key.SHIFT]})
+          .andReturnSuccess()
+      .expect(CName.MOVE_TO, {'element': 'id1'})
+          .andReturnSuccess()
+      .expect(CName.CLICK, {'button': webdriver.Button.LEFT})
+          .andReturnSuccess()
+      .expect(CName.MOVE_TO, {'element': 'id2'})
+          .andReturnSuccess()
+      .expect(CName.CLICK, {'button': webdriver.Button.LEFT})
+          .andReturnSuccess()
+      .replayAll();
+
+  var driver = testHelper.createDriver();
+  var element1 = driver.findElement(By.id('a'));
+  var element2 = driver.findElement(By.id('b'));
+
+  return driver.actions()
+      .keyDown(webdriver.Key.SHIFT)
+      .click(element1)
+      .click(element2)
+      .perform();
+}
+
+
+function testAlertCommandsFailIfAlertNotPresent() {
+  var testHelper = new TestHelper()
+      .expect(CName.GET_ALERT_TEXT)
+          .andReturnError(ECode.NO_SUCH_ALERT, {'message': 'no alert'})
+      .replayAll();
+
+  var driver = testHelper.createDriver();
+  var alert = driver.switchTo().alert();
+
+  var expectError = expectedError(ECode.NO_SUCH_ALERT, 'no alert');
+  var callbacks = [];
+  for (var key in webdriver.Alert.prototype) {
+    if (webdriver.Alert.prototype.hasOwnProperty(key)) {
+      callbacks.push(key, alert[key].call(alert).thenCatch(expectError));
+    }
+  }
+
+  return waitForIdle().then(function() {
+    return webdriver.promise.all(callbacks);
+  });
+}
diff --git a/lib/webdriver/testing/asserts.js b/lib/webdriver/testing/asserts.js
index bbe979d..b8ba02f 100644
--- a/lib/webdriver/testing/asserts.js
+++ b/lib/webdriver/testing/asserts.js
@@ -1,16 +1,19 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Assertions and expectation utilities for use in WebDriver test
@@ -373,7 +376,7 @@ webdriver.testing.Assertion.prototype.isFalse = function() {
  * @extends {webdriver.testing.Assertion}
  */
 webdriver.testing.NegatedAssertion = function(value) {
-  goog.base(this, value);
+  webdriver.testing.NegatedAssertion.base(this, 'constructor', value);
   this.value = value;
 };
 goog.inherits(
@@ -384,11 +387,10 @@ goog.inherits(
 webdriver.testing.NegatedAssertion.prototype.apply = function(
     matcher, opt_message) {
   matcher = new goog.labs.testing.IsNotMatcher(matcher);
-  return goog.base(this, 'apply', matcher, opt_message);
+  return webdriver.testing.NegatedAssertion.base(this, 'apply', matcher,
+                                                 opt_message);
 };
 
-
-
 /**
  * Creates a new assertion.
  * @param {*} value The value to perform an assertion on.
diff --git a/lib/webdriver/testing/client.js b/lib/webdriver/testing/client.js
new file mode 100644
index 0000000..ff13842
--- /dev/null
+++ b/lib/webdriver/testing/client.js
@@ -0,0 +1,179 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.provide('webdriver.testing.Client');
+
+goog.require('goog.json');
+goog.require('goog.net.XmlHttp');
+
+
+
+/**
+ * The client responsible for publishing test events to the server. Each event
+ * will be published using a POST {@link goog.net.XmlHttp} request. The body of
+ * each request will be a JSON object with the following fields:
+ * <ul>
+ *   <li>id: An identifier for this client, derived from the window
+ *       locations' pathname.
+ *   <li>type: The type of event.
+ *   <li>data: A JSONObject whose contents will be specific to each event type.
+ * </ul>
+ *
+ * @param {Window=} opt_win The window to pull the path name from for this
+ *     client. Defaults to the current window.
+ * @param {string=} opt_url The URL to publish test events to. Defaults to
+ *     {@link webdriver.testing.Client.DEFAULT_URL}.
+ * @constructor
+ */
+webdriver.testing.Client = function(opt_win, opt_url) {
+
+  /** @private {string} */
+  this.id_ = (opt_win || window).location.pathname;
+
+  /** @private {string} */
+  this.url_ = opt_url || webdriver.testing.Client.DEFAULT_URL;
+};
+
+
+/**
+ * Default URL to publish test events to.
+ * @type {string}
+ * @const
+ */
+webdriver.testing.Client.DEFAULT_URL = '/testevent';
+
+
+/**
+ * The types of events that may be published by a TestClient to the server.
+ * @enum {string}
+ * @private
+ */
+webdriver.testing.Client.EventType_ = {
+
+  /** Sent to signal that a test suite has been fully initialized. */
+  INIT: 'INIT',
+
+  /**
+   * Sent when starting a new test.  The data object will have the following
+   * fields:
+   *  - name: The name of the test.
+   */
+  START_TEST: 'START_TEST',
+
+  /**
+   * Sent when an error has occurred. The data object will have the following
+   * fields:
+   *  - message: The error message.
+   */
+  ERROR: 'ERROR',
+
+  /**
+   * Sent when all tests have completed. The data object will have the following
+   * fields:
+   *  - isSuccess: Whether the tests succeeded.
+   *  - report: A flat log for the test suite.
+   */
+  RESULTS: 'RESULTS',
+
+  /**
+   * Sent when there is a screenshot for the server to record. The included data
+   * object will have two fields:
+   *  - name: A debug label for the screenshot.
+   *  - data: The PNG screenshot as a base64 string.
+   */
+  SCREENSHOT: 'SCREENSHOT'
+};
+
+
+/**
+ * Sends a simple message to the server, notifying it that the test runner has
+ * been initialized.
+ */
+webdriver.testing.Client.prototype.sendInitEvent = function() {
+  this.sendEvent_(webdriver.testing.Client.EventType_.INIT);
+};
+
+
+/**
+ * Sends an error event.
+ * @param {string} message The error message.
+ */
+webdriver.testing.Client.prototype.sendErrorEvent = function(message) {
+  this.sendEvent_(webdriver.testing.Client.EventType_.ERROR, {
+    'message': message
+  });
+};
+
+
+/**
+ * Sends an event indicating that a new test has started.
+ * @param {string} name The name of the test.
+ */
+webdriver.testing.Client.prototype.sendTestStartedEvent = function(name) {
+  this.sendEvent_(webdriver.testing.Client.EventType_.START_TEST, {
+    'name': name
+  });
+};
+
+
+/**
+ * Sends an event to the server indicating that tests have completed.
+ * @param {boolean} isSuccess Whether the tests finished successfully.
+ * @param {string} report The test log.
+ */
+webdriver.testing.Client.prototype.sendResultsEvent = function(isSuccess,
+    report) {
+  this.sendEvent_(webdriver.testing.Client.EventType_.RESULTS, {
+    'isSuccess': isSuccess,
+    'report': report
+  });
+};
+
+
+/**
+* Sends a screenshot to be recorded by the server.
+* @param {string} data The PNG screenshot as a base64 string.
+* @param {string=} opt_name A debug label for the screenshot; if omitted, the
+*     server will generate a random name.
+*/
+webdriver.testing.Client.prototype.sendScreenshotEvent = function(data,
+    opt_name) {
+  this.sendEvent_(webdriver.testing.Client.EventType_.SCREENSHOT, {
+    'name': opt_name,
+    'data': data
+  });
+};
+
+
+/**
+* Sends an event to the server.
+* @param {string} type The type of event to send.
+* @param {!Object=} opt_data JSON data object to send with the event, if any.
+* @private
+*/
+webdriver.testing.Client.prototype.sendEvent_ = function(type, opt_data) {
+  var payload = goog.json.serialize({
+    'id': this.id_,
+    'type': type,
+    'data': opt_data || {}
+  });
+
+  var xhr = new goog.net.XmlHttp;
+  xhr.open('POST', this.url_, true);
+  xhr.send(payload);
+  // TODO: Log if the event was not sent properly.
+};
diff --git a/lib/webdriver/testing/flowtester.js b/lib/webdriver/testing/flowtester.js
new file mode 100644
index 0000000..db9ffff
--- /dev/null
+++ b/lib/webdriver/testing/flowtester.js
@@ -0,0 +1,372 @@
+// Copyright 2013 Software Freedom Conservancy. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+goog.provide('webdriver.testing.Clock');
+goog.provide('webdriver.testing.promise.FlowTester');
+
+goog.require('goog.array');
+goog.require('webdriver.promise.ControlFlow');
+
+
+
+/**
+ * Describes an object that can be used to advance the clock and trigger
+ * timeouts registered on the global timing functions.
+ * @interface
+ */
+webdriver.testing.Clock = function() {};
+
+
+/**
+ * Advances the clock.
+ * @param {number=} opt_ms The number of milliseconds to advance the clock by.
+ *     Defaults to 1 ms.
+ */
+webdriver.testing.Clock.prototype.tick = function(opt_ms) {};
+
+
+
+/**
+ * Utility for writing unit tests against a
+ * {@link webdriver.promise.ControlFlow}. This class assumes the global
+ * timeout functions (e.g. setTimeout) have been replaced with test doubles.
+ * These doubles should allow registered timeouts to be triggered by
+ * calling {@code clock.tick()}.
+ * @param {!webdriver.testing.Clock} clock The fake clock to use.
+ * @param {{clearInterval: function(number),
+ *          clearTimeout: function(number),
+ *          setInterval: function(!Function, number): number,
+ *          setTimeout: function(!Function, number): number}} timer
+ *     The timer object to use for the application under test.
+ * @constructor
+ * @implements {goog.disposable.IDisposable}
+ */
+webdriver.testing.promise.FlowTester = function(clock, timer) {
+
+  var self = this;
+
+  /** @private {!webdriver.testing.Clock} */
+  this.clock_ = clock;
+
+  /**
+   * @private {!Array.<{isIdle: boolean,
+   *                    errors: !Array.<!Error>,
+   *                    flow: !webdriver.promise.ControlFlow}>}
+   */
+  this.allFlows_ = [];
+
+  /** @private {!webdriver.promise.ControlFlow} */
+  this.flow_ = createFlow();
+
+  /** @private {!webdriver.promise.ControlFlow} */
+  this.originalFlow_ = webdriver.promise.controlFlow();
+  webdriver.promise.setDefaultFlow(this.flow_);
+
+  /**
+   * @private {function(function(!webdriver.promise.ControlFlow)):
+   *               !webdriver.promise.Promise}
+   */
+  this.originalCreateFlow_ = webdriver.promise.createFlow;
+
+  /**
+   * @param {function(!webdriver.promise.ControlFlow)} callback The entry point
+   *     to the newly created flow.
+   * @return {!webdriver.promise.Promise} .
+   */
+  webdriver.promise.createFlow = function(callback) {
+    var flow = createFlow();
+    return flow.execute(function() {
+      return callback(flow);
+    });
+  };
+
+  function createFlow() {
+    var record = {
+      isIdle: true,
+      errors: [],
+      flow: new webdriver.promise.ControlFlow(timer).
+          on(webdriver.promise.ControlFlow.EventType.IDLE, function() {
+            record.isIdle = true;
+          }).
+          on(webdriver.promise.ControlFlow.EventType.SCHEDULE_TASK, function() {
+            record.isIdle = false;
+          }).
+          on(webdriver.promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,
+             function(e) {
+               record.isIdle = true;
+               record.errors.push(e);
+             })
+    };
+    self.allFlows_.push(record);
+    return record.flow;
+  }
+};
+
+
+/** @private {boolean} */
+webdriver.testing.promise.FlowTester.prototype.isDisposed_ = false;
+
+
+/** @override */
+webdriver.testing.promise.FlowTester.prototype.isDisposed = function() {
+  return this.isDisposed_;
+};
+
+
+/**
+ * Disposes of this instance, restoring the default control flow object.
+ * @override
+ */
+webdriver.testing.promise.FlowTester.prototype.dispose = function() {
+  if (!this.isDisposed_) {
+    goog.array.forEach(this.allFlows_, function(record) {
+      record.flow.reset();
+    });
+    webdriver.promise.setDefaultFlow(this.originalFlow_);
+    webdriver.promise.createFlow = this.originalCreateFlow_;
+    this.isDisposed_ = true;
+  }
+};
+
+
+/**
+ * @param {!Array} messages The array to join into a single error message.
+ * @throws {Error} An error with a message formatted from {@code messages}.
+ * @private
+ */
+webdriver.testing.promise.FlowTester.prototype.throwWithMessages_ = function(
+    messages) {
+  throw Error(messages.join('\n--------\n') + '\n === done ===');
+};
+
+
+/**
+ * Verifies that all created flows are idle and completed without any errors.
+ * If a specific flow object is provided, will only check that flow.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The specific flow to check.
+ *     If not specified, will verify against all flows.
+ */
+webdriver.testing.promise.FlowTester.prototype.verifySuccess = function(
+    opt_flow) {
+  var messages = [];
+  var foundFlow = false;
+
+  goog.array.forEach(this.allFlows_, function(record, index) {
+    if (!opt_flow || opt_flow === record.flow) {
+      foundFlow = true;
+      if (record.errors.length) {
+        messages = goog.array.concat(
+            messages, 'Uncaught errors for flow #' + index,
+            goog.array.map(record.errors, function(error) {
+              if (!error) {
+                error = error + '';
+              }
+              return error.stack || error.message || String(error);
+            }));
+      }
+
+      if (!record.isIdle) {
+        messages.push('Flow #' + index + ' is not idle');
+      }
+    }
+  });
+
+  if (opt_flow && !foundFlow) {
+    messages.push('Specified flow not found!');
+  }
+
+  if (messages.length) {
+    this.throwWithMessages_(messages);
+  }
+};
+
+
+/**
+ * Verifies that all flows are idle and at least one reported a single failure.
+ * If a specific flow object is provided, will only check that flow.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The flow expected to have
+ *     generated the error.
+ */
+webdriver.testing.promise.FlowTester.prototype.verifyFailure = function(
+    opt_flow) {
+  var messages = [];
+  var foundFlow = false;
+  var foundAFailure = false;
+
+  goog.array.forEach(this.allFlows_, function(record, index) {
+    if (!opt_flow || opt_flow === record.flow) {
+      foundFlow = true;
+
+      if (!record.isIdle) {
+        messages.push('Flow #' + index + ' is not idle');
+      }
+
+      if (record.errors.length) {
+        foundAFailure = true;
+
+        if (record.errors.length > 1) {
+          messages = goog.array.concat(
+              messages, 'Flow #' + index + ' had multiple errors: ',
+              record.errors);
+        }
+      }
+
+    }
+  });
+
+  if (opt_flow && !foundFlow) {
+    messages.push('Specified flow not found!');
+  }
+
+  if (!foundAFailure) {
+    messages.push('No failures found!');
+  }
+
+  if (messages.length) {
+    this.throwWithMessages_(messages);
+  }
+};
+
+
+/**
+ * @param {webdriver.promise.ControlFlow=} opt_flow The specific control flow
+ *     to check. If not specified, will implicitly verify there was a single
+ *     error across all flows.
+ * @return {Error} The error reported by the application.
+ * @throws {Error} If the application is not finished, or did not report
+ *     exactly one error.
+ */
+webdriver.testing.promise.FlowTester.prototype.getFailure = function(
+    opt_flow) {
+  this.verifyFailure(opt_flow);
+
+  var errors = [];
+  goog.array.forEach(this.allFlows_, function(record) {
+    if (!opt_flow || opt_flow === record.flow) {
+      errors = goog.array.concat(errors, record.errors);
+    }
+  });
+
+  if (errors.length > 1) {
+    this.throwWithMessages_(goog.array.concat(
+        'There was more than one failure', errors));
+  }
+
+  return errors[0];
+};
+
+
+/**
+ * Advances the clock so the {@link webdriver.promise.ControlFlow}'s event
+ * loop will run once.
+ */
+webdriver.testing.promise.FlowTester.prototype.turnEventLoop = function() {
+  this.clock_.tick(webdriver.promise.ControlFlow.EVENT_LOOP_FREQUENCY);
+};
+
+
+/**
+ * @param {webdriver.promise.ControlFlow=} opt_flow The specific flow to check.
+ *     If not specified, will verify all flows are still running.
+ * @throws {Error} If the application is not running.
+ */
+webdriver.testing.promise.FlowTester.prototype.assertStillRunning = function(
+    opt_flow) {
+  var messages = [];
+  var foundFlow = false;
+
+  goog.array.forEach(this.allFlows_, function(record, index) {
+    if (!opt_flow || opt_flow === record.flow) {
+      foundFlow = true;
+      if (record.isIdle) {
+        messages.push('Flow #' + index + ' is idle');
+      }
+
+      if (record.errors.length) {
+        messages = goog.array.concat(
+            messages, 'Uncaught errors for flow #' + index, record.errors);
+      }
+    }
+  });
+
+  if (opt_flow && !foundFlow) {
+    messages.push('Specified flow not found!');
+  }
+
+  if (messages.length) {
+    this.throwWithMessages_(messages);
+  }
+};
+
+
+/**
+ * Runs the application, turning its event loop until it is expected to have
+ * shutdown (as indicated by having no more frames, or no frames with pending
+ * tasks).
+ */
+webdriver.testing.promise.FlowTester.prototype.run = function() {
+  var flow = this.flow_;
+  var self = this;
+  var done = false;
+  var shouldBeDone = false;
+
+  while (!done) {
+    this.turnEventLoop();
+    if (shouldBeDone) {
+      assertIsDone();
+    } else {
+      determineIfShouldBeDone();
+    }
+
+    // If the event loop generated an unhandled promise, it won't be reported
+    // until one more turn of the JS event loop, so we need to tick the
+    // clock once more. This is necessary for our tests to simulate a real
+    // JS environment.
+    this.clock_.tick();
+  }
+
+  function assertIsDone() {
+    // Shutdown is done in one extra turn of the event loop.
+    self.clock_.tick();
+    done = goog.array.every(self.allFlows_, function(record) {
+      return record.isIdle;
+    });
+
+    if (!done) {
+      goog.array.forEach(self.allFlows_, function(record) {
+        if (record.flow.activeFrame_) {
+          // Not done yet, but there are no frames left.  This can happen if the
+          // very first scheduled task was scheduled inside of a promise
+          // callback. Turn the event loop one more time; the flow should detect
+          // that it is now finished and start the shutdown procedure.  Don't
+          // recurse here since we could go into an infinite loop if the flow is
+          // broken.
+          self.turnEventLoop();
+          self.clock_.tick();
+        }
+      });
+    }
+
+    if (!done) {
+      throw Error('Should be done now: ' + flow.getSchedule());
+    }
+  }
+
+  function determineIfShouldBeDone() {
+    shouldBeDone = flow === webdriver.promise.controlFlow() &&
+        goog.array.every(self.allFlows_, function(record) {
+          return !record.flow.activeFrame_;
+        });
+  }
+};
diff --git a/lib/webdriver/testing/jsunit.js b/lib/webdriver/testing/jsunit.js
new file mode 100644
index 0000000..bfb1365
--- /dev/null
+++ b/lib/webdriver/testing/jsunit.js
@@ -0,0 +1,363 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview File to include for turning any HTML file page into a WebDriver
+ * JSUnit test suite by configuring an onload listener to the body that will
+ * instantiate and start the test runner.
+ */
+
+goog.provide('webdriver.testing.jsunit');
+goog.provide('webdriver.testing.jsunit.TestRunner');
+
+goog.require('goog.testing.TestRunner');
+goog.require('webdriver.testing.Client');
+goog.require('webdriver.testing.TestCase');
+
+
+
+/**
+ * Constructs a test runner.
+ * @param {!webdriver.testing.Client} client .
+ * @constructor
+ * @extends {goog.testing.TestRunner}
+ */
+webdriver.testing.jsunit.TestRunner = function(client) {
+  goog.base(this);
+
+  /** @private {!webdriver.testing.Client} */
+  this.client_ = client;
+};
+goog.inherits(webdriver.testing.jsunit.TestRunner, goog.testing.TestRunner);
+
+
+/**
+ * Element created in the document to add test results to.
+ * @private {Element}
+ */
+webdriver.testing.jsunit.TestRunner.prototype.logEl_ = null;
+
+
+/**
+ * DOM element used to stored screenshots. Screenshots are stored in the DOM to
+ * avoid exhausting JS stack-space.
+ * @private {Element}
+ */
+webdriver.testing.jsunit.TestRunner.prototype.screenshotCacheEl_ = null;
+
+
+/** @override */
+webdriver.testing.jsunit.TestRunner.prototype.initialize = function(testCase) {
+  goog.base(this, 'initialize', testCase);
+  this.screenshotCacheEl_ = document.createElement('div');
+  document.body.appendChild(this.screenshotCacheEl_);
+  this.screenshotCacheEl_.style.display = 'none';
+};
+
+
+/** @override */
+webdriver.testing.jsunit.TestRunner.prototype.execute = function() {
+  if (!this.testCase) {
+    throw Error('The test runner must be initialized with a test case before ' +
+                'execute can be called.');
+  }
+  this.screenshotCacheEl_.innerHTML = '';
+  this.client_.sendInitEvent();
+  this.testCase.setCompletedCallback(goog.bind(this.onComplete_, this));
+  this.testCase.runTests();
+};
+
+
+/**
+ * Writes a nicely formatted log out to the document. Overrides
+ * {@link goog.testing.TestRunner#writeLog} to handle writing screenshots to the
+ *     log.
+ * @param {string} log The string to write.
+ * @override
+ */
+webdriver.testing.jsunit.TestRunner.prototype.writeLog = function(log) {
+  var lines = log.split('\n');
+  for (var i = 0; i < lines.length; i++) {
+    var line = lines[i];
+    var color;
+    var isFailOrError = /FAILED/.test(line) || /ERROR/.test(line);
+    var isScreenshot = / \[SCREENSHOT\] /.test(line);
+    if (/PASSED/.test(line)) {
+      color = 'darkgreen';
+    } else if (isFailOrError) {
+      color = 'darkred';
+    } else if (isScreenshot) {
+      color = 'darkblue';
+    } else {
+      color = '#333';
+    }
+
+    var div = document.createElement('div');
+    if (line.substr(0, 2) == '> ') {
+      // The stack trace may contain links so it has to be interpreted as HTML.
+      div.innerHTML = line;
+    } else {
+      div.appendChild(document.createTextNode(line));
+    }
+
+    if (isFailOrError) {
+      var testNameMatch = /(\S+) (\[[^\]]*] )?: (FAILED|ERROR)/.exec(line);
+      if (testNameMatch) {
+        // Build a URL to run the test individually.  If this test was already
+        // part of another subset test, we need to overwrite the old runTests
+        // query parameter.  We also need to do this without bringing in any
+        // extra dependencies, otherwise we could mask missing dependency bugs.
+        var newSearch = 'runTests=' + testNameMatch[1];
+        var search = window.location.search;
+        if (search) {
+          var oldTests = /runTests=([^&]*)/.exec(search);
+          if (oldTests) {
+            newSearch = search.substr(0, oldTests.index) +
+                        newSearch +
+                        search.substr(oldTests.index + oldTests[0].length);
+          } else {
+            newSearch = search + '&' + newSearch;
+          }
+        } else {
+          newSearch = '?' + newSearch;
+        }
+        var href = window.location.href;
+        var hash = window.location.hash;
+        if (hash && hash.charAt(0) != '#') {
+          hash = '#' + hash;
+        }
+        href = href.split('#')[0].split('?')[0] + newSearch + hash;
+
+        // Add the link.
+        var a = document.createElement('A');
+        a.innerHTML = '(run individually)';
+        a.style.fontSize = '0.8em';
+        a.href = href;
+        div.appendChild(document.createTextNode(' '));
+        div.appendChild(a);
+      }
+    }
+
+    if (isScreenshot && this.screenshotCacheEl_.childNodes.length) {
+      var nextScreenshot = this.screenshotCacheEl_.childNodes[0];
+      this.screenshotCacheEl_.removeChild(nextScreenshot);
+
+      a = document.createElement('A');
+      a.style.fontSize = '0.8em';
+      a.href = 'javascript:void(0);';
+      a.onclick = goog.partial(toggleVisibility, a, nextScreenshot);
+      toggleVisibility(a, nextScreenshot);
+      div.appendChild(document.createTextNode(' '));
+      div.appendChild(a);
+    }
+
+    div.style.color = color;
+    div.style.font = 'normal 100% monospace';
+
+    try {
+      div.style.whiteSpace = 'pre-wrap';
+    } catch (e) {
+      // NOTE(user): IE raises an exception when assigning to pre-wrap.
+      // Thankfully, it doesn't collapse whitespace when using monospace fonts,
+      // so it will display correctly if we ignore the exception.
+    }
+
+    if (i < 2) {
+      div.style.fontWeight = 'bold';
+    }
+    this.logEl_.appendChild(div);
+
+    if (nextScreenshot) {
+      a = document.createElement('A');
+      // Accessing the |src| property in IE sometimes results in an
+      // "Invalid pointer" error, which indicates it has been garbage
+      // collected. This does not occur when using getAttribute.
+      a.href = nextScreenshot.getAttribute('src');
+      a.target = '_blank';
+      a.appendChild(nextScreenshot);
+      this.logEl_.appendChild(a);
+      nextScreenshot = null;
+    }
+  }
+
+  function toggleVisibility(link, img) {
+    if (img.style.display === 'none') {
+      img.style.display = '';
+      link.innerHTML = '(hide screenshot)';
+    } else {
+      img.style.display = 'none';
+      link.innerHTML = '(view screenshot)';
+    }
+  }
+};
+
+
+/**
+ * Copied from goog.testing.TestRunner.prototype.onComplete_, which has private
+ * visibility.
+ * @private
+ */
+webdriver.testing.jsunit.TestRunner.prototype.onComplete_ = function() {
+  var log = this.testCase.getReport(true);
+  if (this.errors.length > 0) {
+    log += '\n' + this.errors.join('\n');
+  }
+
+  if (!this.logEl_) {
+    this.logEl_ = document.createElement('div');
+    document.body.appendChild(this.logEl_);
+  }
+
+  // Remove all children from the log element.
+  var logEl = this.logEl_;
+  while (logEl.firstChild) {
+    logEl.removeChild(logEl.firstChild);
+  }
+
+  this.writeLog(log);
+  this.client_.sendResultsEvent(this.isSuccess(), this.getReport(true));
+};
+
+
+/**
+ * Takes a screenshot. In addition to saving the screenshot for viewing in the
+ * HTML logs, the screenshot will also be saved using
+ * @param {!webdriver.WebDriver} driver The driver to take the screenshot with.
+ * @param {string=} opt_label An optional debug label to identify the screenshot
+ *     with.
+ * @return {!webdriver.promise.Promise} A promise that will be resolved to the
+ *     screenshot as a base-64 encoded PNG.
+ */
+webdriver.testing.jsunit.TestRunner.prototype.takeScreenshot = function(
+    driver, opt_label) {
+  if (!this.isInitialized()) {
+    throw Error(
+        'The test runner must be initialized before it may be used to' +
+        ' take screenshots');
+  }
+
+  var client = this.client_;
+  var testCase = this.testCase;
+  var screenshotCache = this.screenshotCacheEl_;
+  return driver.takeScreenshot().then(function(png) {
+    client.sendScreenshotEvent(png, opt_label);
+
+    var img = document.createElement('img');
+    img.src = 'data:image/png;base64,' + png;
+    img.style.border = '1px solid black';
+    img.style.maxWidth = '500px';
+    screenshotCache.appendChild(img);
+
+    if (testCase) {
+      testCase.saveMessage('[SCREENSHOT] ' + (opt_label || '<Not Labeled>'));
+    }
+    return png;
+  });
+};
+
+
+/**
+ * Sends a base64 encoded PNG image to the server to be saved in the test
+ * outputs.
+ * @param {string} data The base64 encoded PNG image to be sent to the server.
+ * @param {string=} opt_label An optional debug label to identify the
+ *     screenshot with.
+ */
+webdriver.testing.jsunit.TestRunner.prototype.saveImage = function(
+    data, opt_label) {
+  if (!this.isInitialized()) {
+    throw Error(
+        'The test runner must be initialized before it may be used to' +
+        ' save images');
+  }
+
+  this.client_.sendScreenshotEvent(data, opt_label);
+
+  var img = document.createElement('img');
+  img.src = 'data:image/png;base64,' + data;
+  img.style.border = '1px solid black';
+  img.style.maxWidth = '500px';
+  this.screenshotCacheEl_.appendChild(img);
+
+  if (this.testCase) {
+    this.testCase.saveMessage('[SCREENSHOT] ' + (opt_label || '<Not Labeled>'));
+  }
+};
+
+
+(function() {
+  var client = new webdriver.testing.Client();
+  var tr = new webdriver.testing.jsunit.TestRunner(client);
+
+  // Export our test runner so it can be accessed by Selenium/WebDriver. This
+  // will only work if webdriver.WebDriver is using a pure-JavaScript
+  // webdriver.CommandExecutor. Otherwise, the JS-client could change the
+  // driver's focus to another window or frame and the Java/Python-client
+  // wouldn't be able to access this object.
+  goog.exportSymbol('G_testRunner', tr);
+  goog.exportSymbol('G_testRunner.initialize', tr.initialize);
+  goog.exportSymbol('G_testRunner.isInitialized', tr.isInitialized);
+  goog.exportSymbol('G_testRunner.isFinished', tr.isFinished);
+  goog.exportSymbol('G_testRunner.isSuccess', tr.isSuccess);
+  goog.exportSymbol('G_testRunner.getReport', tr.getReport);
+  goog.exportSymbol('G_testRunner.getRunTime', tr.getRunTime);
+  goog.exportSymbol('G_testRunner.getNumFilesLoaded', tr.getNumFilesLoaded);
+  goog.exportSymbol('G_testRunner.setStrict', tr.setStrict);
+  goog.exportSymbol('G_testRunner.logTestFailure', tr.logTestFailure);
+
+  // Export debug as a global function for JSUnit compatibility.  This just
+  // calls log on the current test case.
+  if (!goog.global['debug']) {
+    goog.exportSymbol('debug', goog.bind(tr.log, tr));
+  }
+
+  // Add an error handler to report errors that may occur during
+  // initialization of the page.
+  var onerror = window.onerror;
+  window.onerror = function(error, url, line) {
+    // Call any existing onerror handlers.
+    if (onerror) {
+      onerror(error, url, line);
+    }
+    if (typeof error == 'object') {
+      // Webkit started passing an event object as the only argument to
+      // window.onerror.  It doesn't contain an error message, url or line
+      // number.  We therefore log as much info as we can.
+      if (error.target && error.target.tagName == 'SCRIPT') {
+        tr.logError('UNKNOWN ERROR: Script ' + error.target.src);
+      } else {
+        tr.logError('UNKNOWN ERROR: No error information available.');
+      }
+    } else {
+      tr.logError('JS ERROR: ' + error + '\nURL: ' + url + '\nLine: ' + line);
+    }
+  };
+
+  var onload = window.onload;
+  window.onload = function() {
+    // Call any existing onload handlers.
+    if (onload) {
+      onload();
+    }
+
+    var testCase = new webdriver.testing.TestCase(client, document.title);
+    testCase.autoDiscoverTests();
+
+    tr.initialize(testCase);
+    tr.execute();
+  };
+})();
diff --git a/lib/webdriver/testing/testcase.js b/lib/webdriver/testing/testcase.js
new file mode 100644
index 0000000..8c2bc32
--- /dev/null
+++ b/lib/webdriver/testing/testcase.js
@@ -0,0 +1,168 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Defines a special test case that runs each test inside of a
+ * {@code webdriver.Application}. This allows each phase to schedule
+ * asynchronous actions that run to completion before the next phase of the
+ * test.
+ *
+ * This file requires the global {@code G_testRunner} to be initialized before
+ * use. This can be accomplished by also importing
+ * {@link webdriver.testing.jsunit}. This namespace is not required by default
+ * to improve interoperability with other namespaces that may initialize
+ * G_testRunner.
+ */
+
+goog.provide('webdriver.testing.TestCase');
+
+goog.require('goog.testing.TestCase');
+goog.require('webdriver.promise');
+/** @suppress {extraRequire} Imported for user convenience. */
+goog.require('webdriver.testing.asserts');
+
+
+
+/**
+ * Constructs a test case that synchronizes each test case with the singleton
+ * {@code webdriver.promise.ControlFlow}.
+ *
+ * @param {!webdriver.testing.Client} client The test client to use for
+ *     reporting test results.
+ * @param {string=} opt_name The name of the test case, defaults to
+ *     'Untitled Test Case'.
+ * @constructor
+ * @extends {goog.testing.TestCase}
+ */
+webdriver.testing.TestCase = function(client, opt_name) {
+  goog.base(this, opt_name);
+
+  /** @private {!webdriver.testing.Client} */
+  this.client_ = client;
+};
+goog.inherits(webdriver.testing.TestCase, goog.testing.TestCase);
+
+
+/**
+ * Executes the next test inside its own {@code webdriver.Application}.
+ * @override
+ */
+webdriver.testing.TestCase.prototype.cycleTests = function() {
+  var test = this.next();
+  if (!test) {
+    this.finalize();
+    return;
+  }
+
+  goog.testing.TestCase.currentTestName = test.name;
+  this.result_.runCount++;
+  this.log('Running test: ' + test.name);
+  this.client_.sendTestStartedEvent(test.name);
+
+  var self = this;
+  var hadError = false;
+  var app = webdriver.promise.controlFlow();
+
+  this.runSingleTest_(test, onError).then(function() {
+    hadError || self.doSuccess(test);
+    self.timeout(function() {
+      self.cycleTests();
+    }, 100);
+  });
+
+  function onError(e) {
+    hadError = true;
+    self.doError(test, e);
+    // Note: result_ is a @protected field but still uses the trailing
+    // underscore.
+    var err = self.result_.errors[self.result_.errors.length - 1];
+    self.client_.sendErrorEvent(err.toString());
+  }
+};
+
+
+/** @override */
+webdriver.testing.TestCase.prototype.logError = function(name, opt_e) {
+  var errMsg = null;
+  var stack = null;
+  if (opt_e) {
+    this.log(opt_e);
+    if (goog.isString(opt_e)) {
+      errMsg = opt_e;
+    } else {
+      errMsg = opt_e.toString();
+      stack = opt_e.stack.substring(errMsg.length + 1);
+    }
+  } else {
+    errMsg = 'An unknown error occurred';
+  }
+  var err = new goog.testing.TestCase.Error(name, errMsg, stack);
+
+  // Avoid double logging.
+  if (!opt_e || !opt_e['isJsUnitException'] ||
+      !opt_e['loggedJsUnitException']) {
+    this.saveMessage(err.toString());
+  }
+
+  if (opt_e && opt_e['isJsUnitException']) {
+    opt_e['loggedJsUnitException'] = true;
+  }
+
+  return err;
+};
+
+
+/**
+ * Executes a single test, scheduling each phase with the global application.
+ * Each phase will wait for the application to go idle before moving on to the
+ * next test phase.  This function models the follow basic test flow:
+ *
+ *   try {
+ *     this.setUp.call(test.scope);
+ *     test.ref.call(test.scope);
+ *   } catch (ex) {
+ *     onError(ex);
+ *   } finally {
+ *     try {
+ *       this.tearDown.call(test.scope);
+ *     } catch (e) {
+ *       onError(e);
+ *     }
+ *   }
+ *
+ * @param {!goog.testing.TestCase.Test} test The test to run.
+ * @param {function(*)} onError The function to call each time an error is
+ *     detected.
+ * @return {!webdriver.promise.Promise} A promise that will be resolved when the
+ *     test has finished running.
+ * @private
+ */
+webdriver.testing.TestCase.prototype.runSingleTest_ = function(test, onError) {
+  var flow = webdriver.promise.controlFlow();
+
+  return execute(test.name + '.setUp()', this.setUp)().
+      then(execute(test.name + '()', test.ref)).
+      thenCatch(onError).
+      then(execute(test.name + '.tearDown()', this.tearDown)).
+      thenCatch(onError);
+
+  function execute(description, fn) {
+    return function() {
+      return flow.execute(goog.bind(fn, test.scope), description);
+    }
+  }
+};
diff --git a/lib/webdriver/testing/window.js b/lib/webdriver/testing/window.js
new file mode 100644
index 0000000..dd56733
--- /dev/null
+++ b/lib/webdriver/testing/window.js
@@ -0,0 +1,244 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview A utility class for working with test windows.
+ */
+
+goog.provide('webdriver.testing.Window');
+
+goog.require('goog.string');
+goog.require('webdriver.promise');
+
+
+
+/**
+ * Class for managing a window.
+ *
+ * This class is implemented as a promise so consumers may register
+ * callbacks on it to handle situations where the window fails to open.
+ *
+ * For example:
+ *
+ *     var testWindow = webdriver.testing.Window.create(driver);
+ *     // Throw a custom error when the window fails to open.
+ *     testWindow.thenCatch(function(e) {
+ *       throw Error('Failed to open test window: ' + e);
+ *     });
+ *
+ * @param {!webdriver.WebDriver} driver The driver to use.
+ * @param {(string|!webdriver.promise.Promise)} handle Either the managed
+ *     window's handle, or a promise that will resolve to it.
+ * @param {(Window|webdriver.promise.Promise)=} opt_window The raw window
+ *     object, if available.
+ * @constructor
+ * @extends {webdriver.promise.Promise}
+ */
+webdriver.testing.Window = function(driver, handle, opt_window) {
+  webdriver.promise.Promise.call(this, function(fulfill, reject) {
+    handle.then(fulfill, reject);
+  });
+
+  /** @private {!webdriver.WebDriver} */
+  this.driver_ = driver;
+
+  /** @private {!webdriver.promise.Promise} */
+  this.handle_ = webdriver.promise.when(handle);
+
+  /** @private {!webdriver.promise.Promise} */
+  this.window_ = webdriver.promise.when(opt_window);
+};
+goog.inherits(webdriver.testing.Window, webdriver.promise.Promise);
+
+
+/**
+ * Default amount of time, in milliseconds, to wait for a new window to open.
+ * @type {number}
+ * @const
+ */
+webdriver.testing.Window.DEFAULT_OPEN_TIMEOUT = 2000;
+
+
+/**
+ * Window running this script. Lazily initialized the first time it is requested
+ * from {@link webdriver.testing.Window.findWindow}.
+ * @private {webdriver.testing.Window}
+ */
+webdriver.testing.Window.currentWindow_ = null;
+
+
+/**
+ * Opens and focuses on a new window.
+ *
+ * @param {!webdriver.WebDriver} driver The driver to use.
+ * @param {?{width: number, height: number}=} opt_size The desired size for
+ *     the new window.
+ * @param {number=} opt_timeout How long, in milliseconds, to wait for the new
+ *     window to open. Defaults to
+ *     {@link webdriver.testing.Window.DEFAULT_OPEN_TIMEOUT}.
+ * @return {!webdriver.testing.Window} The new window.
+ */
+webdriver.testing.Window.create = function(driver, opt_size, opt_timeout) {
+  var windowPromise = webdriver.promise.defer();
+  var handle = driver.call(function() {
+    var features = [
+      'location=yes',
+      'titlebar=yes'
+    ];
+
+    if (opt_size) {
+      features.push(
+          'width=' + opt_size.width,
+          'height=' + opt_size.height);
+    }
+
+    var name = goog.string.getRandomString();
+    windowPromise.fulfill(window.open('', name, features.join(',')));
+
+    driver.wait(function() {
+      return driver.switchTo().window(name).then(
+          function() { return true; },
+          function() { return false; });
+    }, opt_timeout || webdriver.testing.Window.DEFAULT_OPEN_TIMEOUT);
+    return driver.getWindowHandle();
+  });
+
+  return new webdriver.testing.Window(driver, handle, windowPromise);
+};
+
+
+/**
+ * Changes focus to the topmost window for the provided DOM window.
+ *
+ * @param {!webdriver.WebDriver} driver The driver to use.
+ * @param {Window=} opt_window The window to search for. Defaults to the window
+ *     running this script.
+ * @return {!webdriver.testing.Window} The located window.
+ */
+webdriver.testing.Window.focusOnWindow = function(driver, opt_window) {
+  var name = goog.string.getRandomString();
+  var win = opt_window ? opt_window.top : window;
+
+  var ret;
+  if (win === window && webdriver.testing.Window.currentWindow_) {
+    ret = webdriver.testing.Window.currentWindow_;
+    webdriver.testing.Window.currentWindow_.focus();
+  } else {
+    win.name = name;
+    ret = new webdriver.testing.Window(driver,
+        driver.switchTo().window(name).
+            then(goog.bind(driver.getWindowHandle, driver)),
+        win);
+    if (win === window) {
+      webdriver.testing.Window.currentWindow_ = ret;
+    }
+  }
+  return ret;
+};
+
+
+/** @override */
+webdriver.testing.Window.prototype.cancel = function() {
+  return this.handle_.cancel();
+};
+
+
+/**
+ * Focuses the wrapped driver on the window managed by this class.
+ * @return {!webdriver.promise.Promise} A promise that will be resolved
+ *     when this command has completed.
+ */
+webdriver.testing.Window.prototype.focus = function() {
+  return this.driver_.switchTo().window(this.handle_);
+};
+
+
+/**
+ * Focuses on and closes the managed window. The driver <em>must</em> be
+ * focused on another window before issuing any further commands.
+ * @return {!webdriver.promise.Promise} A promise that will be resolved
+ *     when this command has completed.
+ */
+webdriver.testing.Window.prototype.close = function() {
+  var self = this;
+  return this.window_.then(function(win) {
+    if (win) {
+      win.close();
+    } else {
+      return self.focus().then(goog.bind(self.driver_.close, self.driver_));
+    }
+  });
+};
+
+
+/**
+ * Retrieves the current size of this window.
+ * @return {!webdriver.promise.Promise} A promise that resolves to the size of
+ *     this window as a {width:number, height:number} object.
+ */
+webdriver.testing.Window.prototype.getSize = function() {
+  var driver = this.driver_;
+  return this.focus().then(function() {
+    return driver.manage().window().getSize();
+  });
+};
+
+
+/**
+ * Sets the size of this window.
+ * @param {number} width The desired width, in pixels.
+ * @param {number} height The desired height, in pixels.
+ * @return {!webdriver.promise.Promise} A promise that resolves when the
+ *     command has completed.
+ */
+webdriver.testing.Window.prototype.setSize = function(width, height) {
+  var driver = this.driver_;
+  return this.focus().then(function() {
+    return driver.manage().window().setSize(width, height);
+  });
+};
+
+
+/**
+ * Retrieves the current position of this window, in pixels relative to the
+ * upper left corner of the screen.
+ * @return {!webdriver.promise.Promise} A promise that resolves to the
+ *     position of this window as a {x:number, y:number} object.
+ */
+webdriver.testing.Window.prototype.getPosition = function() {
+  var driver = this.driver_;
+  return this.focus().then(function() {
+    return driver.manage().window().getPosition();
+  });
+};
+
+
+/**
+ * Repositions this window.
+ * @param {number} x The desired horizontal position, in pixels from the left
+ *     side of the screen.
+ * @param {number} y The desired vertical position, in pixels from the top
+ *     of the screen.
+ * @return {!webdriver.promise.Promise} A promise that resolves when the
+ *     command has completed.
+ */
+webdriver.testing.Window.prototype.setPosition = function(x, y) {
+  var driver = this.driver_;
+  return this.focus().then(function() {
+    return driver.manage().window().setPosition(x, y);
+  });
+};
diff --git a/lib/webdriver/touchsequence.js b/lib/webdriver/touchsequence.js
new file mode 100644
index 0000000..a5b302d
--- /dev/null
+++ b/lib/webdriver/touchsequence.js
@@ -0,0 +1,248 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+goog.provide('webdriver.TouchSequence');
+
+goog.require('goog.array');
+goog.require('webdriver.Command');
+goog.require('webdriver.CommandName');
+
+
+
+/**
+ * Class for defining sequences of user touch interactions. Each sequence
+ * will not be executed until {@link #perform} is called.
+ *
+ * Example:
+ *
+ *     new webdriver.TouchSequence(driver).
+ *         tapAndHold({x: 0, y: 0}).
+ *         move({x: 3, y: 4}).
+ *         release({x: 10, y: 10}).
+ *         perform();
+ *
+ * @param {!webdriver.WebDriver} driver The driver instance to use.
+ * @constructor
+ */
+webdriver.TouchSequence = function(driver) {
+
+  /** @private {!webdriver.WebDriver} */
+  this.driver_ = driver;
+
+  /** @private {!Array<{description: string, command: !webdriver.Command}>} */
+  this.touchActions_ = [];
+};
+
+
+/**
+ * Schedules an action to be executed each time {@link #perform} is called on
+ * this instance.
+ * @param {string} description A description of the command.
+ * @param {!webdriver.Command} command The command.
+ * @private
+ */
+webdriver.TouchSequence.prototype.schedule_ = function(description, command) {
+  this.touchActions_.push({
+    description: description,
+    command: command
+  });
+};
+
+
+/**
+ * Executes this action sequence.
+ * @return {!webdriver.promise.Promise} A promise that will be resolved once
+ *     this sequence has completed.
+ */
+webdriver.TouchSequence.prototype.perform = function() {
+  // Make a protected copy of the scheduled actions. This will protect against
+  // users defining additional commands before this sequence is actually
+  // executed.
+  var actions = goog.array.clone(this.touchActions_);
+  var driver = this.driver_;
+  return driver.controlFlow().execute(function() {
+    goog.array.forEach(actions, function(action) {
+      driver.schedule(action.command, action.description);
+    });
+  }, 'TouchSequence.perform');
+};
+
+
+/**
+ * Taps an element.
+ *
+ * @param {!webdriver.WebElement} elem The element to tap.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.tap = function(elem) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_SINGLE_TAP).
+      setParameter('element', elem.getRawId());
+
+  this.schedule_('tap', command);
+  return this;
+};
+
+
+/**
+ * Double taps an element.
+ *
+ * @param {!webdriver.WebElement} elem The element to double tap.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.doubleTap = function(elem) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_DOUBLE_TAP).
+      setParameter('element', elem.getRawId());
+
+  this.schedule_('doubleTap', command);
+  return this;
+};
+
+
+/**
+ * Long press on an element.
+ *
+ * @param {!webdriver.WebElement} elem The element to long press.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.longPress = function(elem) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_LONG_PRESS).
+      setParameter('element', elem.getRawId());
+
+  this.schedule_('longPress', command);
+  return this;
+};
+
+
+/**
+ * Touch down at the given location.
+ *
+ * @param {{x: number, y: number}} location The location to touch down at.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.tapAndHold = function(location) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_DOWN).
+      setParameter('x', location.x).
+      setParameter('y', location.y);
+
+  this.schedule_('tapAndHold', command);
+  return this;
+};
+
+
+/**
+ * Move a held {@linkplain #tapAndHold touch} to the specified location.
+ *
+ * @param {{x: number, y: number}} location The location to move to.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.move = function(location) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_MOVE).
+      setParameter('x', location.x).
+      setParameter('y', location.y);
+
+  this.schedule_('move', command);
+  return this;
+};
+
+
+/**
+ * Release a held {@linkplain #tapAndHold touch} at the specified location.
+ *
+ * @param {{x: number, y: number}} location The location to release at.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.release = function(location) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_UP).
+      setParameter('x', location.x).
+      setParameter('y', location.y);
+
+  this.schedule_('release', command);
+  return this;
+};
+
+
+/**
+ * Scrolls the touch screen by the given offset.
+ *
+ * @param {{x: number, y: number}} offset The offset to scroll to.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.scroll = function(offset) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_SCROLL).
+      setParameter('xoffset', offset.x).
+      setParameter('yoffset', offset.y);
+
+  this.schedule_('scroll', command);
+  return this;
+};
+
+
+/**
+ * Scrolls the touch screen, starting on `elem` and moving by the specified
+ * offset.
+ *
+ * @param {!webdriver.WebElement} elem The element where scroll starts.
+ * @param {{x: number, y: number}} offset The offset to scroll to.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.scrollFromElement = function(elem, offset) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_SCROLL).
+      setParameter('element', elem.getRawId()).
+      setParameter('xoffset', offset.x).
+      setParameter('yoffset', offset.y);
+
+  this.schedule_('scrollFromElement', command);
+  return this;
+};
+
+
+/**
+ * Flick, starting anywhere on the screen, at speed xspeed and yspeed.
+ *
+ * @param {{xspeed: number, yspeed: number}} speed The speed to flick in each
+       direction, in pixels per second.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.flick = function(speed) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_FLICK).
+      setParameter('xspeed', speed.xspeed).
+      setParameter('yspeed', speed.yspeed);
+
+  this.schedule_('flick', command);
+  return this;
+};
+
+
+/**
+ * Flick starting at elem and moving by x and y at specified speed.
+ *
+ * @param {!webdriver.WebElement} elem The element where flick starts.
+ * @param {{x: number, y: number}} offset The offset to flick to.
+ * @param {number} speed The speed to flick at in pixels per second.
+ * @return {!webdriver.TouchSequence} A self reference.
+ */
+webdriver.TouchSequence.prototype.flickElement = function(elem, offset, speed) {
+  var command = new webdriver.Command(webdriver.CommandName.TOUCH_FLICK).
+      setParameter('element', elem.getRawId()).
+      setParameter('xoffset', offset.x).
+      setParameter('yoffset', offset.y).
+      setParameter('speed', speed);
+
+  this.schedule_('flickElement', command);
+  return this;
+};
+
diff --git a/lib/webdriver/until.js b/lib/webdriver/until.js
new file mode 100644
index 0000000..03d24bb
--- /dev/null
+++ b/lib/webdriver/until.js
@@ -0,0 +1,412 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Defines common conditions for use with
+ * {@link webdriver.WebDriver#wait WebDriver wait}.
+ *
+ * Sample usage:
+ *
+ *     driver.get('http://www.google.com/ncr');
+ *
+ *     var query = driver.wait(until.elementLocated(By.name('q')));
+ *     query.sendKeys('webdriver\n');
+ *
+ *     driver.wait(until.titleIs('webdriver - Google Search'));
+ *
+ * To define a custom condition, simply call WebDriver.wait with a function
+ * that will eventually return a truthy-value (neither null, undefined, false,
+ * 0, or the empty string):
+ *
+ *     driver.wait(function() {
+ *       return driver.getTitle().then(function(title) {
+ *         return title === 'webdriver - Google Search';
+ *       });
+ *     }, 1000);
+ */
+
+goog.provide('webdriver.until');
+
+goog.require('bot.ErrorCode');
+goog.require('goog.array');
+goog.require('goog.string');
+goog.require('webdriver.Locator');
+
+
+
+goog.scope(function() {
+
+var until = webdriver.until;
+
+
+/**
+ * Defines a condition to
+ * @param {string} message A descriptive error message. Should complete the
+ *     sentence "Waiting [...]"
+ * @param {function(!webdriver.WebDriver): OUT} fn The condition function to
+ *     evaluate on each iteration of the wait loop.
+ * @constructor
+ * @struct
+ * @final
+ * @template OUT
+ */
+until.Condition = function(message, fn) {
+  /** @private {string} */
+  this.description_ = 'Waiting ' + message;
+
+  /** @type {function(!webdriver.WebDriver): OUT} */
+  this.fn = fn;
+};
+
+
+/** @return {string} A description of this condition. */
+until.Condition.prototype.description = function() {
+  return this.description_;
+};
+
+
+/**
+ * Creates a condition that will wait until the input driver is able to switch
+ * to the designated frame. The target frame may be specified as
+ *
+ * 1. a numeric index into
+ *     [window.frames](https://developer.mozilla.org/en-US/docs/Web/API/Window.frames)
+ *     for the currently selected frame.
+ * 2. a {@link webdriver.WebElement}, which must reference a FRAME or IFRAME
+ *     element on the current page.
+ * 3. a locator which may be used to first locate a FRAME or IFRAME on the
+ *     current page before attempting to switch to it.
+ *
+ * Upon successful resolution of this condition, the driver will be left
+ * focused on the new frame.
+ *
+ * @param {!(number|webdriver.WebElement|
+ *           webdriver.Locator|webdriver.By.Hash|
+ *           function(!webdriver.WebDriver): !webdriver.WebElement)} frame
+ *     The frame identifier.
+ * @return {!until.Condition.<boolean>} A new condition.
+ */
+until.ableToSwitchToFrame = function(frame) {
+  var condition;
+  if (goog.isNumber(frame) || frame instanceof webdriver.WebElement) {
+    condition = attemptToSwitchFrames;
+  } else {
+    condition = function(driver) {
+      var locator =
+          /** @type {!(webdriver.Locator|webdriver.By.Hash|Function)} */(frame);
+      return driver.findElements(locator).then(function(els) {
+        if (els.length) {
+          return attemptToSwitchFrames(driver, els[0]);
+        }
+      });
+    };
+  }
+
+  return new until.Condition('to be able to switch to frame', condition);
+
+  function attemptToSwitchFrames(driver, frame) {
+    return driver.switchTo().frame(frame).then(
+        function() { return true; },
+        function(e) {
+          if (e && e.code !== bot.ErrorCode.NO_SUCH_FRAME) {
+            throw e;
+          }
+        });
+  }
+};
+
+
+/**
+ * Creates a condition that waits for an alert to be opened. Upon success, the
+ * returned promise will be fulfilled with the handle for the opened alert.
+ *
+ * @return {!until.Condition.<!webdriver.Alert>} The new condition.
+ */
+until.alertIsPresent = function() {
+  return new until.Condition('for alert to be present', function(driver) {
+    return driver.switchTo().alert().thenCatch(function(e) {
+      if (e && e.code !== bot.ErrorCode.NO_SUCH_ALERT) {
+        throw e;
+      }
+    });
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the current page's title to match the
+ * given value.
+ *
+ * @param {string} title The expected page title.
+ * @return {!until.Condition.<boolean>} The new condition.
+ */
+until.titleIs = function(title) {
+  return new until.Condition(
+      'for title to be ' + goog.string.quote(title),
+      function(driver) {
+        return driver.getTitle().then(function(t) {
+          return t === title;
+        });
+      });
+};
+
+
+/**
+ * Creates a condition that will wait for the current page's title to contain
+ * the given substring.
+ *
+ * @param {string} substr The substring that should be present in the page
+ *     title.
+ * @return {!until.Condition.<boolean>} The new condition.
+ */
+until.titleContains = function(substr) {
+  return new until.Condition(
+      'for title to contain ' + goog.string.quote(substr),
+      function(driver) {
+        return driver.getTitle().then(function(title) {
+          return title.indexOf(substr) !== -1;
+        });
+      });
+};
+
+
+/**
+ * Creates a condition that will wait for the current page's title to match the
+ * given regular expression.
+ *
+ * @param {!RegExp} regex The regular expression to test against.
+ * @return {!until.Condition.<boolean>} The new condition.
+ */
+until.titleMatches = function(regex) {
+  return new until.Condition('for title to match ' + regex, function(driver) {
+    return driver.getTitle().then(function(title) {
+      return regex.test(title);
+    });
+  });
+};
+
+
+/**
+ * Creates a condition that will loop until an element is
+ * {@link webdriver.WebDriver#findElement found} with the given locator.
+ *
+ * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The locator
+ *     to use.
+ * @return {!until.Condition.<!webdriver.WebElement>} The new condition.
+ */
+until.elementLocated = function(locator) {
+  locator = webdriver.Locator.checkLocator(locator);
+  var locatorStr = goog.isFunction(locator) ? 'by function()' : locator + '';
+  return new until.Condition('for element to be located ' + locatorStr,
+      function(driver) {
+        return driver.findElements(locator).then(function(elements) {
+          return elements[0];
+        });
+      });
+};
+
+
+/**
+ * Creates a condition that will loop until at least one element is
+ * {@link webdriver.WebDriver#findElement found} with the given locator.
+ *
+ * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The locator
+ *     to use.
+ * @return {!until.Condition.<!Array.<!webdriver.WebElement>>} The new
+ *     condition.
+ */
+until.elementsLocated = function(locator) {
+  locator = webdriver.Locator.checkLocator(locator);
+  var locatorStr = goog.isFunction(locator) ? 'by function()' : locator + '';
+  return new until.Condition(
+      'for at least one element to be located ' + locatorStr,
+      function(driver) {
+        return driver.findElements(locator).then(function(elements) {
+          return elements.length > 0 ? elements : null;
+        });
+      });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element to become stale. An
+ * element is considered stale once it is removed from the DOM, or a new page
+ * has loaded.
+ *
+ * @param {!webdriver.WebElement} element The element that should become stale.
+ * @return {!until.Condition.<boolean>} The new condition.
+ */
+until.stalenessOf = function(element) {
+  return new until.Condition('element to become stale', function() {
+    return element.getTagName().then(
+        function() { return false; },
+        function(e) {
+          if (e.code === bot.ErrorCode.STALE_ELEMENT_REFERENCE) {
+            return true;
+          }
+          throw e;
+        });
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element to become visible.
+ *
+ * @param {!webdriver.WebElement} element The element to test.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#isDisplayed
+ */
+until.elementIsVisible = function(element) {
+  return new until.Condition('until element is visible', function() {
+    return element.isDisplayed();
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element to be in the DOM,
+ * yet not visible to the user.
+ *
+ * @param {!webdriver.WebElement} element The element to test.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#isDisplayed
+ */
+until.elementIsNotVisible = function(element) {
+  return new until.Condition('until element is not visible', function() {
+    return element.isDisplayed().then(function(v) {
+      return !v;
+    });
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element to be enabled.
+ *
+ * @param {!webdriver.WebElement} element The element to test.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#isEnabled
+ */
+until.elementIsEnabled = function(element) {
+  return new until.Condition('until element is enabled', function() {
+    return element.isEnabled();
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element to be disabled.
+ *
+ * @param {!webdriver.WebElement} element The element to test.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#isEnabled
+ */
+until.elementIsDisabled = function(element) {
+  return new until.Condition('until element is disabled', function() {
+    return element.isEnabled().then(function(v) {
+      return !v;
+    });
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element to be selected.
+ * @param {!webdriver.WebElement} element The element to test.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#isSelected
+ */
+until.elementIsSelected = function(element) {
+  return new until.Condition('until element is selected', function() {
+    return element.isSelected();
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element to be deselected.
+ *
+ * @param {!webdriver.WebElement} element The element to test.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#isSelected
+ */
+until.elementIsNotSelected = function(element) {
+  return new until.Condition('until element is not selected', function() {
+    return element.isSelected().then(function(v) {
+      return !v;
+    });
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element's
+ * {@link webdriver.WebDriver#getText visible text} to match the given
+ * {@code text} exactly.
+ *
+ * @param {!webdriver.WebElement} element The element to test.
+ * @param {string} text The expected text.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#getText
+ */
+until.elementTextIs = function(element, text) {
+  return new until.Condition('until element text is', function() {
+    return element.getText().then(function(t) {
+      return t === text;
+    });
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element's
+ * {@link webdriver.WebDriver#getText visible text} to contain the given
+ * substring.
+ *
+ * @param {!webdriver.WebElement} element The element to test.
+ * @param {string} substr The substring to search for.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#getText
+ */
+until.elementTextContains = function(element, substr) {
+  return new until.Condition('until element text contains', function() {
+    return element.getText().then(function(t) {
+      return t.indexOf(substr) != -1;
+    });
+  });
+};
+
+
+/**
+ * Creates a condition that will wait for the given element's
+ * {@link webdriver.WebDriver#getText visible text} to match a regular
+ * expression.
+ *
+ * @param {!webdriver.WebElement} element The element to test.
+ * @param {!RegExp} regex The regular expression to test against.
+ * @return {!until.Condition.<boolean>} The new condition.
+ * @see webdriver.WebDriver#getText
+ */
+until.elementTextMatches = function(element, regex) {
+  return new until.Condition('until element text matches', function() {
+    return element.getText().then(function(t) {
+      return regex.test(t);
+    });
+  });
+};
+});  // goog.scope
diff --git a/lib/webdriver/webdriver.js b/lib/webdriver/webdriver.js
index f666fb3..fd78032 100644
--- a/lib/webdriver/webdriver.js
+++ b/lib/webdriver/webdriver.js
@@ -1,25 +1,31 @@
-// Copyright 2011 Software Freedom Conservancy. All Rights Reserved.
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview The heart of the WebDriver JavaScript API.
  */
 
 goog.provide('webdriver.Alert');
+goog.provide('webdriver.AlertPromise');
+goog.provide('webdriver.FileDetector');
 goog.provide('webdriver.UnhandledAlertError');
 goog.provide('webdriver.WebDriver');
 goog.provide('webdriver.WebElement');
+goog.provide('webdriver.WebElementPromise');
 
 goog.require('bot.Error');
 goog.require('bot.ErrorCode');
@@ -31,9 +37,12 @@ goog.require('webdriver.Command');
 goog.require('webdriver.CommandName');
 goog.require('webdriver.Key');
 goog.require('webdriver.Locator');
+goog.require('webdriver.Serializable');
 goog.require('webdriver.Session');
+goog.require('webdriver.TouchSequence');
 goog.require('webdriver.logging');
 goog.require('webdriver.promise');
+goog.require('webdriver.until');
 
 
 //////////////////////////////////////////////////////////////////////////////
@@ -52,16 +61,15 @@ goog.require('webdriver.promise');
  * object to manipulate the command result or catch an expected error. Any
  * commands scheduled with a callback are considered sub-commands and will
  * execute before the next command in the current frame. For example:
- * <pre><code>
- *   var message = [];
- *   driver.call(message.push, message, 'a').then(function() {
- *     driver.call(message.push, message, 'b');
- *   });
- *   driver.call(message.push, message, 'c');
- *   driver.call(function() {
- *     alert('message is abc? ' + (message.join('') == 'abc'));
- *   });
- * </code></pre>
+ *
+ *     var message = [];
+ *     driver.call(message.push, message, 'a').then(function() {
+ *       driver.call(message.push, message, 'b');
+ *     });
+ *     driver.call(message.push, message, 'c');
+ *     driver.call(function() {
+ *       alert('message is abc? ' + (message.join('') == 'abc'));
+ *     });
  *
  * @param {!(webdriver.Session|webdriver.promise.Promise)} session Either a
  *     known session or a promise that will be resolved to a session.
@@ -81,6 +89,9 @@ webdriver.WebDriver = function(session, executor, opt_flow) {
 
   /** @private {!webdriver.promise.ControlFlow} */
   this.flow_ = opt_flow || webdriver.promise.controlFlow();
+
+  /** @private {webdriver.FileDetector} */
+  this.fileDetector_ = null;
 };
 
 
@@ -89,13 +100,17 @@ webdriver.WebDriver = function(session, executor, opt_flow) {
  * @param {!webdriver.CommandExecutor} executor Command executor to use when
  *     querying for session details.
  * @param {string} sessionId ID of the session to attach to.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The control flow all driver
+ *     commands should execute under. Defaults to the
+ *     {@link webdriver.promise.controlFlow() currently active}  control flow.
  * @return {!webdriver.WebDriver} A new client for the specified session.
  */
-webdriver.WebDriver.attachToSession = function(executor, sessionId) {
+webdriver.WebDriver.attachToSession = function(executor, sessionId, opt_flow) {
   return webdriver.WebDriver.acquireSession_(executor,
       new webdriver.Command(webdriver.CommandName.DESCRIBE_SESSION).
           setParameter('sessionId', sessionId),
-      'WebDriver.attachToSession()');
+      'WebDriver.attachToSession()',
+      opt_flow);
 };
 
 
@@ -105,13 +120,19 @@ webdriver.WebDriver.attachToSession = function(executor, sessionId) {
  *     session with.
  * @param {!webdriver.Capabilities} desiredCapabilities The desired
  *     capabilities for the new session.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The control flow all driver
+ *     commands should execute under, including the initial session creation.
+ *     Defaults to the {@link webdriver.promise.controlFlow() currently active}
+ *     control flow.
  * @return {!webdriver.WebDriver} The driver for the newly created session.
  */
-webdriver.WebDriver.createSession = function(executor, desiredCapabilities) {
+webdriver.WebDriver.createSession = function(
+    executor, desiredCapabilities, opt_flow) {
   return webdriver.WebDriver.acquireSession_(executor,
       new webdriver.Command(webdriver.CommandName.NEW_SESSION).
           setParameter('desiredCapabilities', desiredCapabilities),
-      'WebDriver.createSession()');
+      'WebDriver.createSession()',
+      opt_flow);
 };
 
 
@@ -124,11 +145,16 @@ webdriver.WebDriver.createSession = function(executor, desiredCapabilities) {
  * @param {!webdriver.Command} command The command to send to fetch the session
  *     details.
  * @param {string} description A descriptive debug label for this action.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The control flow all driver
+ *     commands should execute under. Defaults to the
+ *     {@link webdriver.promise.controlFlow() currently active} control flow.
  * @return {!webdriver.WebDriver} A new WebDriver client for the session.
  * @private
  */
-webdriver.WebDriver.acquireSession_ = function(executor, command, description) {
-  var session = webdriver.promise.controlFlow().execute(function() {
+webdriver.WebDriver.acquireSession_ = function(
+    executor, command, description, opt_flow) {
+  var flow = opt_flow || webdriver.promise.controlFlow();
+  var session = flow.execute(function() {
     return webdriver.WebDriver.executeCommand_(executor, command).
         then(function(response) {
           bot.response.checkResponse(response);
@@ -136,7 +162,7 @@ webdriver.WebDriver.acquireSession_ = function(executor, command, description) {
               response['value']);
         });
   }, description);
-  return new webdriver.WebDriver(session, executor);
+  return new webdriver.WebDriver(session, executor, flow);
 };
 
 
@@ -144,48 +170,101 @@ webdriver.WebDriver.acquireSession_ = function(executor, command, description) {
  * Converts an object to its JSON representation in the WebDriver wire protocol.
  * When converting values of type object, the following steps will be taken:
  * <ol>
- * <li>if the object provides a "toWireValue" function, the return value will
- *     be returned in its fully resolved state (e.g. this function may return
- *     promise values)</li>
- * <li>if the object provides a "toJSON" function, the return value of this
- *     function will be returned</li>
+ * <li>if the object is a WebElement, the return value will be the element's
+ *     server ID
+ * <li>if the object is a Serializable, its
+ *     {@link webdriver.Serializable#serialize} function will be invoked and
+ *     this algorithm will recursively be applied to the result
+ * <li>if the object provides a "toJSON" function, this algorithm will
+ *     recursively be applied to the result of that function
  * <li>otherwise, the value of each key will be recursively converted according
- *     to the rules above.</li>
+ *     to the rules above.
  * </ol>
  *
  * @param {*} obj The object to convert.
- * @return {!webdriver.promise.Promise} A promise that will resolve to the
+ * @return {!webdriver.promise.Promise.<?>} A promise that will resolve to the
  *     input value's JSON representation.
  * @private
- * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol
  */
 webdriver.WebDriver.toWireValue_ = function(obj) {
-  switch (goog.typeOf(obj)) {
-    case 'array':
-      return webdriver.promise.fullyResolved(
-          goog.array.map(/** @type {!Array} */ (obj),
-              webdriver.WebDriver.toWireValue_));
-    case 'object':
-      if (goog.isFunction(obj.toWireValue)) {
-        return webdriver.promise.fullyResolved(obj.toWireValue());
+  if (webdriver.promise.isPromise(obj)) {
+    return obj.then(webdriver.WebDriver.toWireValue_);
+  }
+  return webdriver.promise.fulfilled(convertValue(obj));
+
+  function convertValue(value) {
+    switch (goog.typeOf(value)) {
+      case 'array':
+        return convertKeys(value, true);
+      case 'object':
+        // NB: WebElement is a Serializable, but we know its serialized form
+        // is a promise for its wire format. This is a micro optimization to
+        // avoid creating extra promises by recursing on the promised id.
+        if (value instanceof webdriver.WebElement) {
+          return value.getId();
+        }
+        if (value instanceof webdriver.Serializable) {
+          return webdriver.WebDriver.toWireValue_(value.serialize());
+        }
+        if (goog.isFunction(value.toJSON)) {
+          return webdriver.WebDriver.toWireValue_(value.toJSON());
+        }
+        if (goog.isNumber(value.nodeType) && goog.isString(value.nodeName)) {
+          throw new TypeError(
+              'Invalid argument type: ' + value.nodeName +
+              '(' + value.nodeType + ')');
+        }
+        return convertKeys(value, false);
+      case 'function':
+        return '' + value;
+      case 'undefined':
+        return null;
+      default:
+        return value;
+    }
+  }
+
+  function convertKeys(obj, isArray) {
+    var numKeys = isArray ? obj.length : goog.object.getCount(obj);
+    var ret = isArray ? new Array(numKeys) : {};
+    if (!numKeys) {
+      return webdriver.promise.fulfilled(ret);
+    }
+
+    var numResolved = 0;
+    var done = webdriver.promise.defer();
+
+    // forEach will stop iteration at undefined, where we want to convert
+    // these to null and keep iterating.
+    var forEachKey = !isArray ? goog.object.forEach : function(arr, fn) {
+      var n = arr.length;
+      for (var i = 0; i < n; i++) {
+        fn(arr[i], i);
       }
-      if (goog.isFunction(obj.toJSON)) {
-        return webdriver.promise.fulfilled(obj.toJSON());
+    };
+
+    forEachKey(obj, function(value, key) {
+      if (webdriver.promise.isPromise(value)) {
+        value.then(webdriver.WebDriver.toWireValue_).
+            then(setValue, done.reject);
+      } else {
+        webdriver.promise.asap(convertValue(value), setValue, done.reject);
       }
-      if (goog.isNumber(obj.nodeType) && goog.isString(obj.nodeName)) {
-        throw Error([
-          'Invalid argument type: ', obj.nodeName, '(', obj.nodeType, ')'
-        ].join(''));
+
+      function setValue(value) {
+        ret[key] = value;
+        maybeFulfill();
+      }
+    });
+
+    return done.promise;
+
+    function maybeFulfill() {
+      if (++numResolved === numKeys) {
+        done.fulfill(ret);
       }
-      return webdriver.promise.fullyResolved(
-          goog.object.map(/** @type {!Object} */ (obj),
-              webdriver.WebDriver.toWireValue_));
-    case 'function':
-      return webdriver.promise.fulfilled('' + obj);
-    case 'undefined':
-      return webdriver.promise.fulfilled(null);
-    default:
-      return webdriver.promise.fulfilled(obj);
+    }
   }
 };
 
@@ -200,7 +279,7 @@ webdriver.WebDriver.toWireValue_ = function(obj) {
  *     parent of any unwrapped {@code webdriver.WebElement} values.
  * @param {*} value The value to convert.
  * @return {*} The converted value.
- * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol
  * @private
  */
 webdriver.WebDriver.fromWireValue_ = function(driver, value) {
@@ -209,8 +288,7 @@ webdriver.WebDriver.fromWireValue_ = function(driver, value) {
         goog.partial(webdriver.WebDriver.fromWireValue_, driver));
   } else if (value && goog.isObject(value) && !goog.isFunction(value)) {
     if (webdriver.WebElement.ELEMENT_KEY in value) {
-      value = new webdriver.WebElement(driver,
-          value[webdriver.WebElement.ELEMENT_KEY]);
+      value = new webdriver.WebElement(driver, value);
     } else {
       value = goog.object.map(/**@type {!Object}*/ (value),
           goog.partial(webdriver.WebDriver.fromWireValue_, driver));
@@ -230,8 +308,7 @@ webdriver.WebDriver.fromWireValue_ = function(driver, value) {
  * @private
  */
 webdriver.WebDriver.executeCommand_ = function(executor, command) {
-  return webdriver.promise.fullyResolved(command.getParameters()).
-      then(webdriver.WebDriver.toWireValue_).
+  return webdriver.WebDriver.toWireValue_(command.getParameters()).
       then(function(parameters) {
         command.setParameters(parameters);
         return webdriver.promise.checkedNodeCall(
@@ -254,8 +331,9 @@ webdriver.WebDriver.prototype.controlFlow = function() {
  * {@code webdriver.CommandExecutor}.
  * @param {!webdriver.Command} command The command to schedule.
  * @param {string} description A description of the command for debugging.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with
- *     the command result.
+ * @return {!webdriver.promise.Promise.<T>} A promise that will be resolved
+ *     with the command result.
+ * @template T
  */
 webdriver.WebDriver.prototype.schedule = function(command, description) {
   var self = this;
@@ -263,22 +341,47 @@ webdriver.WebDriver.prototype.schedule = function(command, description) {
   checkHasNotQuit();
   command.setParameter('sessionId', this.session_);
 
+  // If any of the command parameters are rejected promises, those
+  // rejections may be reported as unhandled before the control flow
+  // attempts to execute the command. To ensure parameters errors
+  // propagate through the command itself, we resolve all of the
+  // command parameters now, but suppress any errors until the ControlFlow
+  // actually executes the command. This addresses scenarios like catching
+  // an element not found error in:
+  //
+  //     driver.findElement(By.id('foo')).click().thenCatch(function(e) {
+  //       if (e.code === bot.ErrorCode.NO_SUCH_ELEMENT) {
+  //         // Do something.
+  //       }
+  //     });
+  var prepCommand = webdriver.WebDriver.toWireValue_(command.getParameters());
+  prepCommand.thenCatch(goog.nullFunction);
+
   var flow = this.flow_;
+  var executor = this.executor_;
   return flow.execute(function() {
     // A call to WebDriver.quit() may have been scheduled in the same event
     // loop as this |command|, which would prevent us from detecting that the
     // driver has quit above.  Therefore, we need to make another quick check.
     // We still check above so we can fail as early as possible.
     checkHasNotQuit();
-    return webdriver.WebDriver.executeCommand_(self.executor_, command);
+
+    // Retrieve resolved command parameters; any previously suppressed errors
+    // will now propagate up through the control flow as part of the command
+    // execution.
+    return prepCommand.then(function(parameters) {
+      command.setParameters(parameters);
+      return webdriver.promise.checkedNodeCall(
+          goog.bind(executor.execute, executor, command));
+    });
   }, description).then(function(response) {
     try {
       bot.response.checkResponse(response);
     } catch (ex) {
       var value = response['value'];
-      if (ex.code === bot.ErrorCode.MODAL_DIALOG_OPENED) {
+      if (ex.code === bot.ErrorCode.UNEXPECTED_ALERT_OPEN) {
         var text = value && value['alert'] ? value['alert']['text'] : '';
-        throw new webdriver.UnhandledAlertError(ex.message,
+        throw new webdriver.UnhandledAlertError(ex.message, text,
             new webdriver.Alert(self, text));
       }
       throw ex;
@@ -296,13 +399,24 @@ webdriver.WebDriver.prototype.schedule = function(command, description) {
 };
 
 
+/**
+ * Sets the {@linkplain webdriver.FileDetector file detector} that should be
+ * used with this instance.
+ * @param {webdriver.FileDetector} detector The detector to use or {@code null}.
+ */
+webdriver.WebDriver.prototype.setFileDetector = function(detector) {
+  this.fileDetector_ = detector;
+};
+
+
 // ----------------------------------------------------------------------------
 // Client command functions:
 // ----------------------------------------------------------------------------
 
 
 /**
- * @return {!webdriver.promise.Promise} A promise for this client's session.
+ * @return {!webdriver.promise.Promise.<!webdriver.Session>} A promise for this
+ *     client's session.
  */
 webdriver.WebDriver.prototype.getSession = function() {
   return webdriver.promise.when(this.session_);
@@ -310,8 +424,8 @@ webdriver.WebDriver.prototype.getSession = function() {
 
 
 /**
- * @return {!webdriver.promise.Promise} A promise that will resolve with the
- *     this instance's capabilities.
+ * @return {!webdriver.promise.Promise.<!webdriver.Capabilities>} A promise
+ *     that will resolve with the this instance's capabilities.
  */
 webdriver.WebDriver.prototype.getCapabilities = function() {
   return webdriver.promise.when(this.session_, function(session) {
@@ -324,8 +438,8 @@ webdriver.WebDriver.prototype.getCapabilities = function() {
  * Schedules a command to quit the current session. After calling quit, this
  * instance will be invalidated and may no longer be used to issue commands
  * against the browser.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     the command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the command has completed.
  */
 webdriver.WebDriver.prototype.quit = function() {
   var result = this.schedule(
@@ -343,13 +457,13 @@ webdriver.WebDriver.prototype.quit = function() {
  * Creates a new action sequence using this driver. The sequence will not be
  * scheduled for execution until {@link webdriver.ActionSequence#perform} is
  * called. Example:
- * <pre><code>
- *   driver.actions().
- *       mouseDown(element1).
- *       mouseMove(element2).
- *       mouseUp().
- *       perform();
- * </code></pre>
+ *
+ *     driver.actions().
+ *         mouseDown(element1).
+ *         mouseMove(element2).
+ *         mouseUp().
+ *         perform();
+ *
  * @return {!webdriver.ActionSequence} A new action sequence for this instance.
  */
 webdriver.WebDriver.prototype.actions = function() {
@@ -357,6 +471,23 @@ webdriver.WebDriver.prototype.actions = function() {
 };
 
 
+/**
+ * Creates a new touch sequence using this driver. The sequence will not be
+ * scheduled for execution until {@link webdriver.TouchSequence#perform} is
+ * called. Example:
+ *
+ *     driver.touchActions().
+ *         tap(element1).
+ *         doubleTap(element2).
+ *         perform();
+ *
+ * @return {!webdriver.TouchSequence} A new touch sequence for this instance.
+ */
+webdriver.WebDriver.prototype.touchActions = function() {
+  return new webdriver.TouchSequence(this);
+};
+
+
 /**
  * Schedules a command to execute JavaScript in the context of the currently
  * selected frame or window. The script fragment will be executed as the body
@@ -379,29 +510,30 @@ webdriver.WebDriver.prototype.actions = function() {
  * If the script has a return value (i.e. if the script contains a return
  * statement), then the following steps will be taken for resolving this
  * functions return value:
- * <ul>
- * <li>For a HTML element, the value will resolve to a
- *     {@code webdriver.WebElement}</li>
- * <li>Null and undefined return values will resolve to null</li>
- * <li>Booleans, numbers, and strings will resolve as is</li>
- * <li>Functions will resolve to their string representation</li>
- * <li>For arrays and objects, each member item will be converted according to
- *     the rules above</li>
- * </ul>
+ *
+ * - For a HTML element, the value will resolve to a
+ *     {@link webdriver.WebElement}
+ * - Null and undefined return values will resolve to null</li>
+ * - Booleans, numbers, and strings will resolve as is</li>
+ * - Functions will resolve to their string representation</li>
+ * - For arrays and objects, each member item will be converted according to
+ *     the rules above
  *
  * @param {!(string|Function)} script The script to execute.
  * @param {...*} var_args The arguments to pass to the script.
- * @return {!webdriver.promise.Promise} A promise that will resolve to the
+ * @return {!webdriver.promise.Promise.<T>} A promise that will resolve to the
  *    scripts return value.
+ * @template T
  */
 webdriver.WebDriver.prototype.executeScript = function(script, var_args) {
   if (goog.isFunction(script)) {
     script = 'return (' + script + ').apply(null, arguments);';
   }
+  var args = arguments.length > 1 ? goog.array.slice(arguments, 1) : [];
   return this.schedule(
       new webdriver.Command(webdriver.CommandName.EXECUTE_SCRIPT).
           setParameter('script', script).
-          setParameter('args', goog.array.slice(arguments, 1)),
+          setParameter('args', args),
       'WebDriver.executeScript()');
 };
 
@@ -419,71 +551,68 @@ webdriver.WebDriver.prototype.executeScript = function(script, var_args) {
  * Arrays and objects may also be used as script arguments as long as each item
  * adheres to the types previously mentioned.
  *
- * Unlike executing synchronous JavaScript with
- * {@code webdriver.WebDriver.prototype.executeScript}, scripts executed with
- * this function must explicitly signal they are finished by invoking the
- * provided callback. This callback will always be injected into the
- * executed function as the last argument, and thus may be referenced with
- * {@code arguments[arguments.length - 1]}. The following steps will be taken
- * for resolving this functions return value against the first argument to the
- * script's callback function:
- * <ul>
- * <li>For a HTML element, the value will resolve to a
- *     {@code webdriver.WebElement}</li>
- * <li>Null and undefined return values will resolve to null</li>
- * <li>Booleans, numbers, and strings will resolve as is</li>
- * <li>Functions will resolve to their string representation</li>
- * <li>For arrays and objects, each member item will be converted according to
- *     the rules above</li>
- * </ul>
- *
- * Example #1: Performing a sleep that is synchronized with the currently
+ * Unlike executing synchronous JavaScript with {@link #executeScript},
+ * scripts executed with this function must explicitly signal they are finished
+ * by invoking the provided callback. This callback will always be injected
+ * into the executed function as the last argument, and thus may be referenced
+ * with {@code arguments[arguments.length - 1]}. The following steps will be
+ * taken for resolving this functions return value against the first argument
+ * to the script's callback function:
+ *
+ * - For a HTML element, the value will resolve to a
+ *     {@link webdriver.WebElement}
+ * - Null and undefined return values will resolve to null
+ * - Booleans, numbers, and strings will resolve as is
+ * - Functions will resolve to their string representation
+ * - For arrays and objects, each member item will be converted according to
+ *     the rules above
+ *
+ * __Example #1:__ Performing a sleep that is synchronized with the currently
  * selected window:
- * <code><pre>
- * var start = new Date().getTime();
- * driver.executeAsyncScript(
- *     'window.setTimeout(arguments[arguments.length - 1], 500);').
- *     then(function() {
- *       console.log('Elapsed time: ' + (new Date().getTime() - start) + ' ms');
- *     });
- * </pre></code>
- *
- * Example #2: Synchronizing a test with an AJAX application:
- * <code><pre>
- * var button = driver.findElement(By.id('compose-button'));
- * button.click();
- * driver.executeAsyncScript(
- *     'var callback = arguments[arguments.length - 1];' +
- *     'mailClient.getComposeWindowWidget().onload(callback);');
- * driver.switchTo().frame('composeWidget');
- * driver.findElement(By.id('to')).sendKEys('dog@example.com');
- * </pre></code>
- *
- * Example #3: Injecting a XMLHttpRequest and waiting for the result. In this
- * example, the inject script is specified with a function literal. When using
- * this format, the function is converted to a string for injection, so it
+ *
+ *     var start = new Date().getTime();
+ *     driver.executeAsyncScript(
+ *         'window.setTimeout(arguments[arguments.length - 1], 500);').
+ *         then(function() {
+ *           console.log(
+ *               'Elapsed time: ' + (new Date().getTime() - start) + ' ms');
+ *         });
+ *
+ * __Example #2:__ Synchronizing a test with an AJAX application:
+ *
+ *     var button = driver.findElement(By.id('compose-button'));
+ *     button.click();
+ *     driver.executeAsyncScript(
+ *         'var callback = arguments[arguments.length - 1];' +
+ *         'mailClient.getComposeWindowWidget().onload(callback);');
+ *     driver.switchTo().frame('composeWidget');
+ *     driver.findElement(By.id('to')).sendKeys('dog@example.com');
+ *
+ * __Example #3:__ Injecting a XMLHttpRequest and waiting for the result. In
+ * this example, the inject script is specified with a function literal. When
+ * using this format, the function is converted to a string for injection, so it
  * should not reference any symbols not defined in the scope of the page under
  * test.
- * <code><pre>
- * driver.executeAsyncScript(function() {
- *   var callback = arguments[arguments.length - 1];
- *   var xhr = new XMLHttpRequest();
- *   xhr.open("GET", "/resource/data.json", true);
- *   xhr.onreadystatechange = function() {
- *     if (xhr.readyState == 4) {
- *       callback(xhr.resposneText);
- *     }
- *   }
- *   xhr.send('');
- * }).then(function(str) {
- *   console.log(JSON.parse(str)['food']);
- * });
- * </pre></code>
+ *
+ *     driver.executeAsyncScript(function() {
+ *       var callback = arguments[arguments.length - 1];
+ *       var xhr = new XMLHttpRequest();
+ *       xhr.open("GET", "/resource/data.json", true);
+ *       xhr.onreadystatechange = function() {
+ *         if (xhr.readyState == 4) {
+ *           callback(xhr.responseText);
+ *         }
+ *       }
+ *       xhr.send('');
+ *     }).then(function(str) {
+ *       console.log(JSON.parse(str)['food']);
+ *     });
  *
  * @param {!(string|Function)} script The script to execute.
  * @param {...*} var_args The arguments to pass to the script.
- * @return {!webdriver.promise.Promise} A promise that will resolve to the
+ * @return {!webdriver.promise.Promise.<T>} A promise that will resolve to the
  *    scripts return value.
+ * @template T
  */
 webdriver.WebDriver.prototype.executeAsyncScript = function(script, var_args) {
   if (goog.isFunction(script)) {
@@ -499,17 +628,23 @@ webdriver.WebDriver.prototype.executeAsyncScript = function(script, var_args) {
 
 /**
  * Schedules a command to execute a custom function.
- * @param {!Function} fn The function to execute.
+ * @param {function(...): (T|webdriver.promise.Promise.<T>)} fn The function to
+ *     execute.
  * @param {Object=} opt_scope The object in whose scope to execute the function.
  * @param {...*} var_args Any arguments to pass to the function.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     function's result.
+ * @return {!webdriver.promise.Promise.<T>} A promise that will be resolved'
+ *     with the function's result.
+ * @template T
  */
 webdriver.WebDriver.prototype.call = function(fn, opt_scope, var_args) {
   var args = goog.array.slice(arguments, 2);
   var flow = this.flow_;
   return flow.execute(function() {
     return webdriver.promise.fullyResolved(args).then(function(args) {
+      if (webdriver.promise.isGenerator(fn)) {
+        args.unshift(fn, opt_scope);
+        return webdriver.promise.consume.apply(null, args);
+      }
       return fn.apply(opt_scope, args);
     });
   }, 'WebDriver.call(' + (fn.name || 'function') + ')');
@@ -517,26 +652,81 @@ webdriver.WebDriver.prototype.call = function(fn, opt_scope, var_args) {
 
 
 /**
- * Schedules a command to wait for a condition to hold, as defined by some
- * user supplied function. If any errors occur while evaluating the wait, they
- * will be allowed to propagate.
- * @param {function():boolean} fn The function to evaluate as a wait condition.
- * @param {number} timeout How long to wait for the condition to be true.
+ * Schedules a command to wait for a condition to hold. The condition may be
+ * specified by a {@link webdriver.until.Condition}, as a custom function, or
+ * as a {@link webdriver.promise.Promise}.
+ *
+ * For a {@link webdriver.until.Condition} or function, the wait will repeatedly
+ * evaluate the condition until it returns a truthy value. If any errors occur
+ * while evaluating the condition, they will be allowed to propagate. In the
+ * event a condition returns a {@link webdriver.promise.Promise promise}, the
+ * polling loop will wait for it to be resolved and use the resolved value for
+ * whether the condition has been satisified. Note the resolution time for
+ * a promise is factored into whether a wait has timed out.
+ *
+ * *Example:* waiting up to 10 seconds for an element to be present and visible
+ * on the page.
+ *
+ *     var button = driver.wait(until.elementLocated(By.id('foo')), 10000);
+ *     button.click();
+ *
+ * This function may also be used to block the command flow on the resolution
+ * of a {@link webdriver.promise.Promise promise}. When given a promise, the
+ * command will simply wait for its resolution before completing. A timeout may
+ * be provided to fail the command if the promise does not resolve before the
+ * timeout expires.
+ *
+ * *Example:* Suppose you have a function, `startTestServer`, that returns a
+ * promise for when a server is ready for requests. You can block a `WebDriver`
+ * client on this promise with:
+ *
+ *     var started = startTestServer();
+ *     driver.wait(started, 5 * 1000, 'Server should start within 5 seconds');
+ *     driver.get(getServerUrl());
+ *
+ * @param {!(webdriver.promise.Promise<T>|
+ *           webdriver.until.Condition<T>|
+ *           function(!webdriver.WebDriver): T)} condition The condition to
+ *     wait on, defined as a promise, condition object, or  a function to
+ *     evaluate as a condition.
+ * @param {number=} opt_timeout How long to wait for the condition to be true.
  * @param {string=} opt_message An optional message to use if the wait times
  *     out.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     wait condition has been satisfied.
- */
-webdriver.WebDriver.prototype.wait = function(fn, timeout, opt_message) {
-  return this.flow_.wait(fn, timeout, opt_message);
+ * @return {!webdriver.promise.Promise<T>} A promise that will be fulfilled
+ *     with the first truthy value returned by the condition function, or
+ *     rejected if the condition times out.
+ * @template T
+ */
+webdriver.WebDriver.prototype.wait = function(
+    condition, opt_timeout, opt_message) {
+  if (webdriver.promise.isPromise(condition)) {
+    return this.flow_.wait(
+        /** @type {!webdriver.promise.Promise} */(condition),
+        opt_timeout, opt_message);
+  }
+
+  var message = opt_message;
+  var fn = /** @type {!Function} */(condition);
+  if (condition instanceof webdriver.until.Condition) {
+    message = message || condition.description();
+    fn = condition.fn;
+  }
+
+  var driver = this;
+  return this.flow_.wait(function() {
+    if (webdriver.promise.isGenerator(fn)) {
+      return webdriver.promise.consume(fn, null, [driver]);
+    }
+    return fn(driver);
+  }, opt_timeout, message);
 };
 
 
 /**
  * Schedules a command to make the driver sleep for the given amount of time.
  * @param {number} ms The amount of time, in milliseconds, to sleep.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     sleep has finished.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the sleep has finished.
  */
 webdriver.WebDriver.prototype.sleep = function(ms) {
   return this.flow_.timeout(ms, 'WebDriver.sleep(' + ms + ')');
@@ -545,8 +735,8 @@ webdriver.WebDriver.prototype.sleep = function(ms) {
 
 /**
  * Schedules a command to retrieve they current window handle.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     current window handle.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the current window handle.
  */
 webdriver.WebDriver.prototype.getWindowHandle = function() {
   return this.schedule(
@@ -557,8 +747,8 @@ webdriver.WebDriver.prototype.getWindowHandle = function() {
 
 /**
  * Schedules a command to retrieve the current list of available window handles.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with an
- *     array of window handles.
+ * @return {!webdriver.promise.Promise.<!Array.<string>>} A promise that will
+ *     be resolved with an array of window handles.
  */
 webdriver.WebDriver.prototype.getAllWindowHandles = function() {
   return this.schedule(
@@ -572,8 +762,8 @@ webdriver.WebDriver.prototype.getAllWindowHandles = function() {
  * returned is a representation of the underlying DOM: do not expect it to be
  * formatted or escaped in the same way as the response sent from the web
  * server.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     current page source.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the current page source.
  */
 webdriver.WebDriver.prototype.getPageSource = function() {
   return this.schedule(
@@ -584,8 +774,8 @@ webdriver.WebDriver.prototype.getPageSource = function() {
 
 /**
  * Schedules a command to close the current window.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     this command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when this command has completed.
  */
 webdriver.WebDriver.prototype.close = function() {
   return this.schedule(new webdriver.Command(webdriver.CommandName.CLOSE),
@@ -596,8 +786,8 @@ webdriver.WebDriver.prototype.close = function() {
 /**
  * Schedules a command to navigate to the given URL.
  * @param {string} url The fully qualified URL to open.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     document has finished loading.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the document has finished loading.
  */
 webdriver.WebDriver.prototype.get = function(url) {
   return this.navigate().to(url);
@@ -606,8 +796,8 @@ webdriver.WebDriver.prototype.get = function(url) {
 
 /**
  * Schedules a command to retrieve the URL of the current page.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     current URL.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the current URL.
  */
 webdriver.WebDriver.prototype.getCurrentUrl = function() {
   return this.schedule(
@@ -618,8 +808,8 @@ webdriver.WebDriver.prototype.getCurrentUrl = function() {
 
 /**
  * Schedules a command to retrieve the current page's title.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     current page's title.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the current page's title.
  */
 webdriver.WebDriver.prototype.getTitle = function() {
   return this.schedule(new webdriver.Command(webdriver.CommandName.GET_TITLE),
@@ -635,33 +825,31 @@ webdriver.WebDriver.prototype.getTitle = function() {
  * that the element is present on the page. To test whether an element is
  * present on the page, use {@link #isElementPresent} instead.
  *
- * <p>The search criteria for an element may be defined using one of the
+ * The search criteria for an element may be defined using one of the
  * factories in the {@link webdriver.By} namespace, or as a short-hand
  * {@link webdriver.By.Hash} object. For example, the following two statements
  * are equivalent:
- * <code><pre>
- * var e1 = driver.findElement(By.id('foo'));
- * var e2 = driver.findElement({id:'foo'});
- * </pre></code>
  *
- * <p>You may also provide a custom locator function, which takes as input
+ *     var e1 = driver.findElement(By.id('foo'));
+ *     var e2 = driver.findElement({id:'foo'});
+ *
+ * You may also provide a custom locator function, which takes as input
  * this WebDriver instance and returns a {@link webdriver.WebElement}, or a
  * promise that will resolve to a WebElement. For example, to find the first
  * visible link on a page, you could write:
- * <code><pre>
- * var link = driver.findElement(firstVisibleLink);
- *
- * function firstVisibleLink(driver) {
- *   var links = driver.findElements(By.tagName('a'));
- *   return webdriver.promise.filter(links, function(link) {
- *     return links.isDisplayed();
- *   }).then(function(visibleLinks) {
- *     return visibleLinks[0];
- *   });
- * }
- * </pre></code>
- *
- * <p>When running in the browser, a WebDriver cannot manipulate DOM elements
+ *
+ *     var link = driver.findElement(firstVisibleLink);
+ *
+ *     function firstVisibleLink(driver) {
+ *       var links = driver.findElements(By.tagName('a'));
+ *       return webdriver.promise.filter(links, function(link) {
+ *         return links.isDisplayed();
+ *       }).then(function(visibleLinks) {
+ *         return visibleLinks[0];
+ *       });
+ *     }
+ *
+ * When running in the browser, a WebDriver cannot manipulate DOM elements
  * directly; it may do so only through a {@link webdriver.WebElement} reference.
  * This function may be used to generate a WebElement from a DOM element. A
  * reference to the DOM element will be stored in a known location and this
@@ -680,15 +868,14 @@ webdriver.WebDriver.prototype.findElement = function(locator) {
   var id;
   if ('nodeType' in locator && 'ownerDocument' in locator) {
     var element = /** @type {!Element} */ (locator);
-    id = this.findDomElement_(element).
-        then(function(elements) {
-          if (!elements.length) {
-            throw new bot.Error(bot.ErrorCode.NO_SUCH_ELEMENT,
-                'Unable to locate element. Is WebDriver focused on its ' +
-                    'ownerDocument\'s frame?');
-          }
-          return elements[0];
-        });
+    id = this.findDomElement_(element).then(function(element) {
+      if (!element) {
+        throw new bot.Error(bot.ErrorCode.NO_SUCH_ELEMENT,
+            'Unable to locate element. Is WebDriver focused on its ' +
+                'ownerDocument\'s frame?');
+      }
+      return element;
+    });
   } else {
     locator = webdriver.Locator.checkLocator(locator);
     if (goog.isFunction(locator)) {
@@ -700,7 +887,7 @@ webdriver.WebDriver.prototype.findElement = function(locator) {
       id = this.schedule(command, 'WebDriver.findElement(' + locator + ')');
     }
   }
-  return new webdriver.WebElement(this, id);
+  return new webdriver.WebElementPromise(this, id);
 };
 
 
@@ -735,8 +922,9 @@ webdriver.WebDriver.prototype.findElementInternal_ = function(
  * ownerDocument's window+frame.
 
  * @param {!Element} element The element to locate.
- * @return {!webdriver.promise.Promise} A promise that will be resolved
- *     with the located WebElement.
+ * @return {!webdriver.promise.Promise.<webdriver.WebElement>} A promise that
+ *     will be fulfilled with the located element, or null if the element
+ *     could not be found.
  * @private
  */
 webdriver.WebDriver.prototype.findDomElement_ = function(element) {
@@ -758,26 +946,22 @@ webdriver.WebDriver.prototype.findDomElement_ = function(element) {
 
     var element = store[id];
     if (!element || element[id] !== id) {
-      return [];
+      return null;
     }
-    return [element];
+    return element;
   }
 
-  return this.executeScript(lookupElement, id).
-      then(function(value) {
-        cleanUp();
-        if (value.length && !(value[0] instanceof webdriver.WebElement)) {
-          throw new Error('JS locator script result was not a WebElement');
-        }
-        return value;
-      }, cleanUp);
+  /** @type {!webdriver.promise.Promise.<webdriver.WebElement>} */
+  var foundElement = this.executeScript(lookupElement, id);
+  foundElement.thenFinally(cleanUp);
+  return foundElement;
 };
 
 
 /**
  * Schedules a command to test if an element is present on the page.
  *
- * <p>If given a DOM element, this function will check if it belongs to the
+ * If given a DOM element, this function will check if it belongs to the
  * document the driver is currently focused on. Otherwise, the function will
  * test if at least one element can be found with the given search criteria.
  *
@@ -788,13 +972,14 @@ webdriver.WebDriver.prototype.findDomElement_ = function(element) {
  *     with whether the element is present on the page.
  */
 webdriver.WebDriver.prototype.isElementPresent = function(locatorOrElement) {
-  var findElement =
-      ('nodeType' in locatorOrElement && 'ownerDocument' in locatorOrElement) ?
-          this.findDomElement_(/** @type {!Element} */ (locatorOrElement)) :
-          this.findElements.apply(this, arguments);
-  return findElement.then(function(result) {
-    return !!result.length;
-  });
+  if ('nodeType' in locatorOrElement && 'ownerDocument' in locatorOrElement) {
+    return this.findDomElement_(/** @type {!Element} */ (locatorOrElement)).
+        then(function(result) { return !!result; });
+  } else {
+    return this.findElements.apply(this, arguments).then(function(result) {
+      return !!result.length;
+    });
+  }
 };
 
 
@@ -855,8 +1040,8 @@ webdriver.WebDriver.prototype.findElementsInternal_ = function(
  *   <li>The screenshot of the entire display containing the browser
  * </ol>
  *
- * @return {!webdriver.promise.Promise} A promise that will be resolved to the
- *     screenshot as a base-64 encoded PNG.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved to the screenshot as a base-64 encoded PNG.
  */
 webdriver.WebDriver.prototype.takeScreenshot = function() {
   return this.schedule(new webdriver.Command(webdriver.CommandName.SCREENSHOT),
@@ -907,8 +1092,8 @@ webdriver.WebDriver.Navigation = function(driver) {
 /**
  * Schedules a command to navigate to a new URL.
  * @param {string} url The URL to navigate to.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     URL has been loaded.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the URL has been loaded.
  */
 webdriver.WebDriver.Navigation.prototype.to = function(url) {
   return this.driver_.schedule(
@@ -920,8 +1105,8 @@ webdriver.WebDriver.Navigation.prototype.to = function(url) {
 
 /**
  * Schedules a command to move backwards in the browser history.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     navigation event has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the navigation event has completed.
  */
 webdriver.WebDriver.Navigation.prototype.back = function() {
   return this.driver_.schedule(
@@ -932,8 +1117,8 @@ webdriver.WebDriver.Navigation.prototype.back = function() {
 
 /**
  * Schedules a command to move forwards in the browser history.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     navigation event has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the navigation event has completed.
  */
 webdriver.WebDriver.Navigation.prototype.forward = function() {
   return this.driver_.schedule(
@@ -944,8 +1129,8 @@ webdriver.WebDriver.Navigation.prototype.forward = function() {
 
 /**
  * Schedules a command to refresh the current page.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     navigation event has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the navigation event has completed.
  */
 webdriver.WebDriver.Navigation.prototype.refresh = function() {
   return this.driver_.schedule(
@@ -967,6 +1152,21 @@ webdriver.WebDriver.Options = function(driver) {
 };
 
 
+/**
+ * A JSON description of a browser cookie.
+ * @typedef {{
+ *     name: string,
+ *     value: string,
+ *     path: (string|undefined),
+ *     domain: (string|undefined),
+ *     secure: (boolean|undefined),
+ *     expiry: (number|undefined)
+ * }}
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object
+ */
+webdriver.WebDriver.Options.Cookie;
+
+
 /**
  * Schedules a command to add a cookie.
  * @param {string} name The cookie name.
@@ -976,8 +1176,8 @@ webdriver.WebDriver.Options = function(driver) {
  * @param {boolean=} opt_isSecure Whether the cookie is secure.
  * @param {(number|!Date)=} opt_expiry When the cookie expires. If specified as
  *     a number, should be in milliseconds since midnight, January 1, 1970 UTC.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     cookie has been added to the page.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the cookie has been added to the page.
  */
 webdriver.WebDriver.Options.prototype.addCookie = function(
     name, value, opt_path, opt_domain, opt_isSecure, opt_expiry) {
@@ -1026,8 +1226,8 @@ webdriver.WebDriver.Options.prototype.addCookie = function(
 
 /**
  * Schedules a command to delete all cookies visible to the current page.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when all
- *     cookies have been deleted.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when all cookies have been deleted.
  */
 webdriver.WebDriver.Options.prototype.deleteAllCookies = function() {
   return this.driver_.schedule(
@@ -1041,8 +1241,8 @@ webdriver.WebDriver.Options.prototype.deleteAllCookies = function() {
  * a no-op if there is no cookie with the given name visible to the current
  * page.
  * @param {string} name The name of the cookie to delete.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     cookie has been deleted.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the cookie has been deleted.
  */
 webdriver.WebDriver.Options.prototype.deleteCookie = function(name) {
   return this.driver_.schedule(
@@ -1056,9 +1256,10 @@ webdriver.WebDriver.Options.prototype.deleteCookie = function(name) {
  * Schedules a command to retrieve all cookies visible to the current page.
  * Each cookie will be returned as a JSON object as described by the WebDriver
  * wire protocol.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     cookies visible to the current page.
- * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object
+ * @return {!webdriver.promise.Promise.<
+ *     !Array.<webdriver.WebDriver.Options.Cookie>>} A promise that will be
+ *     resolved with the cookies visible to the current page.
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object
  */
 webdriver.WebDriver.Options.prototype.getCookies = function() {
   return this.driver_.schedule(
@@ -1072,9 +1273,10 @@ webdriver.WebDriver.Options.prototype.getCookies = function() {
  * if there is no such cookie. The cookie will be returned as a JSON object as
  * described by the WebDriver wire protocol.
  * @param {string} name The name of the cookie to retrieve.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     named cookie, or {@code null} if there is no such cookie.
- * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object
+ * @return {!webdriver.promise.Promise.<?webdriver.WebDriver.Options.Cookie>} A
+ *     promise that will be resolved with the named cookie, or {@code null}
+ *     if there is no such cookie.
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object
  */
 webdriver.WebDriver.Options.prototype.getCookie = function(name) {
   return this.getCookies().then(function(cookies) {
@@ -1128,23 +1330,23 @@ webdriver.WebDriver.Timeouts = function(driver) {
 /**
  * Specifies the amount of time the driver should wait when searching for an
  * element if it is not immediately present.
- * <p/>
+ *
  * When searching for a single element, the driver should poll the page
  * until the element has been found, or this timeout expires before failing
- * with a {@code bot.ErrorCode.NO_SUCH_ELEMENT} error. When searching
+ * with a {@link bot.ErrorCode.NO_SUCH_ELEMENT} error. When searching
  * for multiple elements, the driver should poll the page until at least one
  * element has been found or this timeout has expired.
- * <p/>
+ *
  * Setting the wait timeout to 0 (its default value), disables implicit
  * waiting.
- * <p/>
+ *
  * Increasing the implicit wait timeout should be used judiciously as it
  * will have an adverse effect on test run time, especially when used with
  * slower location strategies like XPath.
  *
  * @param {number} ms The amount of time to wait, in milliseconds.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     implicit wait timeout has been set.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the implicit wait timeout has been set.
  */
 webdriver.WebDriver.Timeouts.prototype.implicitlyWait = function(ms) {
   return this.driver_.schedule(
@@ -1160,8 +1362,8 @@ webdriver.WebDriver.Timeouts.prototype.implicitlyWait = function(ms) {
  * equal to 0, the script will be allowed to run indefinitely.
  *
  * @param {number} ms The amount of time to wait, in milliseconds.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     script timeout has been set.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the script timeout has been set.
  */
 webdriver.WebDriver.Timeouts.prototype.setScriptTimeout = function(ms) {
   return this.driver_.schedule(
@@ -1175,8 +1377,8 @@ webdriver.WebDriver.Timeouts.prototype.setScriptTimeout = function(ms) {
  * Sets the amount of time to wait for a page load to complete before returning
  * an error.  If the timeout is negative, page loads may be indefinite.
  * @param {number} ms The amount of time to wait, in milliseconds.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     the timeout has been set.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the timeout has been set.
  */
 webdriver.WebDriver.Timeouts.prototype.pageLoadTimeout = function(ms) {
   return this.driver_.schedule(
@@ -1203,8 +1405,9 @@ webdriver.WebDriver.Window = function(driver) {
 /**
  * Retrieves the window's current position, relative to the top left corner of
  * the screen.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     window's position in the form of a {x:number, y:number} object literal.
+ * @return {!webdriver.promise.Promise.<{x: number, y: number}>} A promise that
+ *     will be resolved with the window's position in the form of a
+ *     {x:number, y:number} object literal.
  */
 webdriver.WebDriver.Window.prototype.getPosition = function() {
   return this.driver_.schedule(
@@ -1220,8 +1423,8 @@ webdriver.WebDriver.Window.prototype.getPosition = function() {
  *     of the screen.
  * @param {number} y The desired vertical position, relative to the top of the
  *     of the screen.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the command has completed.
  */
 webdriver.WebDriver.Window.prototype.setPosition = function(x, y) {
   return this.driver_.schedule(
@@ -1235,9 +1438,9 @@ webdriver.WebDriver.Window.prototype.setPosition = function(x, y) {
 
 /**
  * Retrieves the window's current size.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     window's size in the form of a {width:number, height:number} object
- *     literal.
+ * @return {!webdriver.promise.Promise.<{width: number, height: number}>} A
+ *     promise that will be resolved with the window's size in the form of a
+ *     {width:number, height:number} object literal.
  */
 webdriver.WebDriver.Window.prototype.getSize = function() {
   return this.driver_.schedule(
@@ -1251,8 +1454,8 @@ webdriver.WebDriver.Window.prototype.getSize = function() {
  * Resizes the current window.
  * @param {number} width The desired window width.
  * @param {number} height The desired window height.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the command has completed.
  */
 webdriver.WebDriver.Window.prototype.setSize = function(width, height) {
   return this.driver_.schedule(
@@ -1266,8 +1469,8 @@ webdriver.WebDriver.Window.prototype.setSize = function(width, height) {
 
 /**
  * Maximizes the current window.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the command has completed.
  */
 webdriver.WebDriver.Window.prototype.maximize = function() {
   return this.driver_.schedule(
@@ -1292,11 +1495,10 @@ webdriver.WebDriver.Logs = function(driver) {
 /**
  * Fetches available log entries for the given type.
  *
- * <p/>Note that log buffers are reset after each call, meaning that
- * available log entries correspond to those entries not yet returned for a
- * given log type. In practice, this means that this call will return the
- * available log entries since the last call, or from the start of the
- * session.
+ * Note that log buffers are reset after each call, meaning that available
+ * log entries correspond to those entries not yet returned for a given log
+ * type. In practice, this means that this call will return the available log
+ * entries since the last call, or from the start of the session.
  *
  * @param {!webdriver.logging.Type} type The desired log type.
  * @return {!webdriver.promise.Promise.<!Array.<!webdriver.logging.Entry>>} A
@@ -1312,7 +1514,8 @@ webdriver.WebDriver.Logs.prototype.get = function(type) {
         return goog.array.map(entries, function(entry) {
           if (!(entry instanceof webdriver.logging.Entry)) {
             return new webdriver.logging.Entry(
-                entry['level'], entry['message'], entry['timestamp']);
+                entry['level'], entry['message'], entry['timestamp'],
+                entry['type']);
           }
           return entry;
         });
@@ -1349,21 +1552,21 @@ webdriver.WebDriver.TargetLocator = function(driver) {
  * Schedules a command retrieve the {@code document.activeElement} element on
  * the current document, or {@code document.body} if activeElement is not
  * available.
- * @return {!webdriver.WebElement} The active element.
+ * @return {!webdriver.WebElementPromise} The active element.
  */
 webdriver.WebDriver.TargetLocator.prototype.activeElement = function() {
   var id = this.driver_.schedule(
       new webdriver.Command(webdriver.CommandName.GET_ACTIVE_ELEMENT),
       'WebDriver.switchTo().activeElement()');
-  return new webdriver.WebElement(this.driver_, id);
+  return new webdriver.WebElementPromise(this.driver_, id);
 };
 
 
 /**
  * Schedules a command to switch focus of all future commands to the first frame
  * on the page.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     driver has changed focus to the default content.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the driver has changed focus to the default content.
  */
 webdriver.WebDriver.TargetLocator.prototype.defaultContent = function() {
   return this.driver_.schedule(
@@ -1376,20 +1579,22 @@ webdriver.WebDriver.TargetLocator.prototype.defaultContent = function() {
 /**
  * Schedules a command to switch the focus of all future commands to another
  * frame on the page.
- * <p/>
+ *
  * If the frame is specified by a number, the command will switch to the frame
- * by its (zero-based) index into the {@code window.frames} collection.
- * <p/>
+ * by its (zero-based) index into
+ * [window.frames](https://developer.mozilla.org/en-US/docs/Web/API/Window.frames).
+ *
  * If the frame is specified by a string, the command will select the frame by
  * its name or ID. To select sub-frames, simply separate the frame names/IDs by
  * dots. As an example, "main.child" will select the frame with the name "main"
  * and then its child "child".
- * <p/>
+ *
  * If the specified frame can not be found, the deferred result will errback
- * with a {@code bot.ErrorCode.NO_SUCH_FRAME} error.
+ * with a {@link bot.ErrorCode.NO_SUCH_FRAME} error.
+ *
  * @param {string|number} nameOrIndex The frame locator.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     driver has changed focus to the specified frame.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the driver has changed focus to the specified frame.
  */
 webdriver.WebDriver.TargetLocator.prototype.frame = function(nameOrIndex) {
   return this.driver_.schedule(
@@ -1402,14 +1607,15 @@ webdriver.WebDriver.TargetLocator.prototype.frame = function(nameOrIndex) {
 /**
  * Schedules a command to switch the focus of all future commands to another
  * window. Windows may be specified by their {@code window.name} attribute or
- * by its handle (as returned by {@code webdriver.WebDriver#getWindowHandles}).
- * <p/>
+ * by its handle (as returned by {@link webdriver.WebDriver#getWindowHandles}).
+ *
  * If the specificed window can not be found, the deferred result will errback
- * with a {@code bot.ErrorCode.NO_SUCH_WINDOW} error.
+ * with a {@link bot.ErrorCode.NO_SUCH_WINDOW} error.
+ *
  * @param {string} nameOrHandle The name or window handle of the window to
  *     switch focus to.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when the
- *     driver has changed focus to the specified window.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the driver has changed focus to the specified window.
  */
 webdriver.WebDriver.TargetLocator.prototype.window = function(nameOrHandle) {
   return this.driver_.schedule(
@@ -1421,15 +1627,18 @@ webdriver.WebDriver.TargetLocator.prototype.window = function(nameOrHandle) {
 
 /**
  * Schedules a command to change focus to the active alert dialog. This command
- * will return a {@link bot.ErrorCode.NO_MODAL_DIALOG_OPEN} error if a modal
- * dialog is not currently open.
- * @return {!webdriver.Alert} The open alert.
+ * will return a {@link bot.ErrorCode.NO_SUCH_ALERT} error if an alert dialog
+ * is not currently open.
+ * @return {!webdriver.AlertPromise} The open alert.
  */
 webdriver.WebDriver.TargetLocator.prototype.alert = function() {
   var text = this.driver_.schedule(
       new webdriver.Command(webdriver.CommandName.GET_ALERT_TEXT),
       'WebDriver.switchTo().alert()');
-  return new webdriver.Alert(this.driver_, text);
+  var driver = this.driver_;
+  return new webdriver.AlertPromise(driver, text.then(function(text) {
+    return new webdriver.Alert(driver, text);
+  }));
 };
 
 
@@ -1467,75 +1676,52 @@ webdriver.Key.chord = function(var_args) {
 
 /**
  * Represents a DOM element. WebElements can be found by searching from the
- * document root using a {@code webdriver.WebDriver} instance, or by searching
- * under another {@code webdriver.WebElement}:
- * <pre><code>
- *   driver.get('http://www.google.com');
- *   var searchForm = driver.findElement(By.tagName('form'));
- *   var searchBox = searchForm.findElement(By.name('q'));
- *   searchBox.sendKeys('webdriver');
- * </code></pre>
+ * document root using a {@link webdriver.WebDriver} instance, or by searching
+ * under another WebElement:
+ *
+ *     driver.get('http://www.google.com');
+ *     var searchForm = driver.findElement(By.tagName('form'));
+ *     var searchBox = searchForm.findElement(By.name('q'));
+ *     searchBox.sendKeys('webdriver');
  *
  * The WebElement is implemented as a promise for compatibility with the promise
  * API. It will always resolve itself when its internal state has been fully
  * resolved and commands may be issued against the element. This can be used to
  * catch errors when an element cannot be located on the page:
- * <pre><code>
- *   driver.findElement(By.id('not-there')).then(function(element) {
- *     alert('Found an element that was not expected to be there!');
- *   }, function(error) {
- *     alert('The element was not found, as expected');
- *   });
- * </code></pre>
+ *
+ *     driver.findElement(By.id('not-there')).then(function(element) {
+ *       alert('Found an element that was not expected to be there!');
+ *     }, function(error) {
+ *       alert('The element was not found, as expected');
+ *     });
  *
  * @param {!webdriver.WebDriver} driver The parent WebDriver instance for this
  *     element.
- * @param {!(string|webdriver.promise.Promise)} id Either the opaque ID for the
- *     underlying DOM element assigned by the server, or a promise that will
- *     resolve to that ID or another WebElement.
+ * @param {!(webdriver.promise.Promise.<webdriver.WebElement.Id>|
+ *           webdriver.WebElement.Id)} id The server-assigned opaque ID for the
+ *     underlying DOM element.
  * @constructor
- * @extends {webdriver.promise.Deferred}
+ * @extends {webdriver.Serializable.<webdriver.WebElement.Id>}
  */
 webdriver.WebElement = function(driver, id) {
-  webdriver.promise.Deferred.call(this, null, driver.controlFlow());
+  webdriver.Serializable.call(this);
 
-  /**
-   * The parent WebDriver instance for this element.
-   * @private {!webdriver.WebDriver}
-   */
+  /** @private {!webdriver.WebDriver} */
   this.driver_ = driver;
 
-  // This class is responsible for resolving itself; delete the resolve and
-  // reject methods so they may not be accessed by consumers of this class.
-  var fulfill = goog.partial(this.fulfill, this);
-  var reject = this.reject;
-  delete this.promise;
-  delete this.fulfill;
-  delete this.reject;
-
-  /**
-   * A promise that resolves to the JSON representation of this WebElement's
-   * ID, as defined by the WebDriver wire protocol.
-   * @private {!webdriver.promise.Promise}
-   * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol
-   */
-  this.id_ = webdriver.promise.when(id, function(id) {
-    if (id instanceof webdriver.WebElement) {
-      return id.id_;
-    } else if (goog.isDef(id[webdriver.WebElement.ELEMENT_KEY])) {
-      return id;
-    }
+  /** @private {!webdriver.promise.Promise.<webdriver.WebElement.Id>} */
+  this.id_ = id instanceof webdriver.promise.Promise ?
+      id : webdriver.promise.fulfilled(id);
+};
+goog.inherits(webdriver.WebElement, webdriver.Serializable);
 
-    var json = {};
-    json[webdriver.WebElement.ELEMENT_KEY] = id;
-    return json;
-  });
 
-  // This WebElement should not be resolved until its ID has been
-  // fully resolved.
-  this.id_.then(fulfill, reject);
-};
-goog.inherits(webdriver.WebElement, webdriver.promise.Deferred);
+/**
+ * Wire protocol definition of a WebElement ID.
+ * @typedef {{ELEMENT: string}}
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol
+ */
+webdriver.WebElement.Id;
 
 
 /**
@@ -1551,14 +1737,15 @@ webdriver.WebElement.ELEMENT_KEY = 'ELEMENT';
  * Compares to WebElements for equality.
  * @param {!webdriver.WebElement} a A WebElement.
  * @param {!webdriver.WebElement} b A WebElement.
- * @return {!webdriver.promise.Promise} A promise that will be resolved to
- *     whether the two WebElements are equal.
+ * @return {!webdriver.promise.Promise.<boolean>} A promise that will be
+ *     resolved to whether the two WebElements are equal.
  */
 webdriver.WebElement.equals = function(a, b) {
   if (a == b) {
     return webdriver.promise.fulfilled(true);
   }
-  return webdriver.promise.fullyResolved([a.id_, b.id_]).then(function(ids) {
+  var ids = [a.getId(), b.getId()];
+  return webdriver.promise.all(ids).then(function(ids) {
     // If the two element's have the same ID, they should be considered
     // equal. Otherwise, they may still be equivalent, but we'll need to
     // ask the server to check for us.
@@ -1567,10 +1754,10 @@ webdriver.WebElement.equals = function(a, b) {
       return true;
     }
 
-    var command = new webdriver.Command(
-        webdriver.CommandName.ELEMENT_EQUALS);
-    command.setParameter('other', b);
-    return a.schedule_(command, 'webdriver.WebElement.equals()');
+    var command = new webdriver.Command(webdriver.CommandName.ELEMENT_EQUALS);
+    command.setParameter('id', ids[0]);
+    command.setParameter('other', ids[1]);
+    return a.driver_.schedule(command, 'webdriver.WebElement.equals()');
   });
 };
 
@@ -1584,65 +1771,84 @@ webdriver.WebElement.prototype.getDriver = function() {
 
 
 /**
- * @return {!webdriver.promise.Promise} A promise that resolves to this
- *     element's JSON representation as defined by the WebDriver wire protocol.
- * @see http://code.google.com/p/selenium/wiki/JsonWireProtocol
+ * @return {!webdriver.promise.Promise.<webdriver.WebElement.Id>} A promise
+ *     that resolves to this element's JSON representation as defined by the
+ *     WebDriver wire protocol.
+ * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol
  */
-webdriver.WebElement.prototype.toWireValue = function() {
+webdriver.WebElement.prototype.getId = function() {
   return this.id_;
 };
 
 
+/**
+ * Returns the raw ID string ID for this element.
+ * @return {!webdriver.promise.Promise<string>} A promise that resolves to this
+ *     element's raw ID as a string value.
+ * @package
+ */
+webdriver.WebElement.prototype.getRawId = function() {
+  return this.getId().then(function(value) {
+    return value['ELEMENT'];
+  });
+};
+
+
+/** @override */
+webdriver.WebElement.prototype.serialize = function() {
+  return this.getId();
+};
+
+
 /**
  * Schedules a command that targets this element with the parent WebDriver
  * instance. Will ensure this element's ID is included in the command parameters
  * under the "id" key.
  * @param {!webdriver.Command} command The command to schedule.
  * @param {string} description A description of the command for debugging.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with
- *     the command result.
+ * @return {!webdriver.promise.Promise.<T>} A promise that will be resolved
+ *     with the command result.
+ * @template T
  * @see webdriver.WebDriver.prototype.schedule
  * @private
  */
 webdriver.WebElement.prototype.schedule_ = function(command, description) {
-  command.setParameter('id', this.id_);
+  command.setParameter('id', this.getId());
   return this.driver_.schedule(command, description);
 };
 
 
 /**
  * Schedule a command to find a descendant of this element. If the element
- * cannot be found, a {@code bot.ErrorCode.NO_SUCH_ELEMENT} result will
+ * cannot be found, a {@link bot.ErrorCode.NO_SUCH_ELEMENT} result will
  * be returned by the driver. Unlike other commands, this error cannot be
  * suppressed. In other words, scheduling a command to find an element doubles
  * as an assert that the element is present on the page. To test whether an
- * element is present on the page, use {@code #isElementPresent} instead.
+ * element is present on the page, use {@link #isElementPresent} instead.
  *
- * <p>The search criteria for an element may be defined using one of the
+ * The search criteria for an element may be defined using one of the
  * factories in the {@link webdriver.By} namespace, or as a short-hand
  * {@link webdriver.By.Hash} object. For example, the following two statements
  * are equivalent:
- * <code><pre>
- * var e1 = element.findElement(By.id('foo'));
- * var e2 = element.findElement({id:'foo'});
- * </pre></code>
  *
- * <p>You may also provide a custom locator function, which takes as input
+ *     var e1 = element.findElement(By.id('foo'));
+ *     var e2 = element.findElement({id:'foo'});
+ *
+ * You may also provide a custom locator function, which takes as input
  * this WebDriver instance and returns a {@link webdriver.WebElement}, or a
  * promise that will resolve to a WebElement. For example, to find the first
  * visible link on a page, you could write:
- * <code><pre>
- * var link = element.findElement(firstVisibleLink);
- *
- * function firstVisibleLink(element) {
- *   var links = element.findElements(By.tagName('a'));
- *   return webdriver.promise.filter(links, function(link) {
- *     return links.isDisplayed();
- *   }).then(function(visibleLinks) {
- *     return visibleLinks[0];
- *   });
- * }
- * </pre></code>
+ *
+ *     var link = element.findElement(firstVisibleLink);
+ *
+ *     function firstVisibleLink(element) {
+ *       var links = element.findElements(By.tagName('a'));
+ *       return webdriver.promise.filter(links, function(link) {
+ *         return links.isDisplayed();
+ *       }).then(function(visibleLinks) {
+ *         return visibleLinks[0];
+ *       });
+ *     }
  *
  * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The
  *     locator strategy to use when searching for the element.
@@ -1662,7 +1868,7 @@ webdriver.WebElement.prototype.findElement = function(locator) {
         setParameter('value', locator.value);
     id = this.schedule_(command, 'WebElement.findElement(' + locator + ')');
   }
-  return new webdriver.WebElement(this.driver_, id);
+  return new webdriver.WebElementPromise(this.driver_, id);
 };
 
 
@@ -1707,8 +1913,8 @@ webdriver.WebElement.prototype.findElements = function(locator) {
 
 /**
  * Schedules a command to click on this element.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     the click command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the click command has completed.
  */
 webdriver.WebElement.prototype.click = function() {
   return this.schedule_(
@@ -1720,64 +1926,93 @@ webdriver.WebElement.prototype.click = function() {
 /**
  * Schedules a command to type a sequence on the DOM element represented by this
  * instance.
- * <p/>
+ *
  * Modifier keys (SHIFT, CONTROL, ALT, META) are stateful; once a modifier is
  * processed in the keysequence, that key state is toggled until one of the
  * following occurs:
- * <ul>
- * <li>The modifier key is encountered again in the sequence. At this point the
- * state of the key is toggled (along with the appropriate keyup/down events).
- * </li>
- * <li>The {@code webdriver.Key.NULL} key is encountered in the sequence. When
- * this key is encountered, all modifier keys current in the down state are
- * released (with accompanying keyup events). The NULL key can be used to
- * simulate common keyboard shortcuts:
- * <code><pre>
- *     element.sendKeys("text was",
- *                      webdriver.Key.CONTROL, "a", webdriver.Key.NULL,
- *                      "now text is");
- *     // Alternatively:
- *     element.sendKeys("text was",
- *                      webdriver.Key.chord(webdriver.Key.CONTROL, "a"),
- *                      "now text is");
- * </pre></code></li>
- * <li>The end of the keysequence is encountered. When there are no more keys
- * to type, all depressed modifier keys are released (with accompanying keyup
- * events).
- * </li>
- * </ul>
- * <strong>Note:</strong> On browsers where native keyboard events are not yet
- * supported (e.g. Firefox on OS X), key events will be synthesized. Special
+ *
+ * - The modifier key is encountered again in the sequence. At this point the
+ *   state of the key is toggled (along with the appropriate keyup/down events).
+ * - The {@link webdriver.Key.NULL} key is encountered in the sequence. When
+ *   this key is encountered, all modifier keys current in the down state are
+ *   released (with accompanying keyup events). The NULL key can be used to
+ *   simulate common keyboard shortcuts:
+ *
+ *         element.sendKeys("text was",
+ *                          webdriver.Key.CONTROL, "a", webdriver.Key.NULL,
+ *                          "now text is");
+ *         // Alternatively:
+ *         element.sendKeys("text was",
+ *                          webdriver.Key.chord(webdriver.Key.CONTROL, "a"),
+ *                          "now text is");
+ *
+ * - The end of the keysequence is encountered. When there are no more keys
+ *   to type, all depressed modifier keys are released (with accompanying keyup
+ *   events).
+ *
+ * If this element is a file input ({@code <input type="file">}), the
+ * specified key sequence should specify the path to the file to attach to
+ * the element. This is analgous to the user clicking "Browse..." and entering
+ * the path into the file select dialog.
+ *
+ *     var form = driver.findElement(By.css('form'));
+ *     var element = form.findElement(By.css('input[type=file]'));
+ *     element.sendKeys('/path/to/file.txt');
+ *     form.submit();
+ *
+ * For uploads to function correctly, the entered path must reference a file
+ * on the _browser's_ machine, not the local machine running this script. When
+ * running against a remote Selenium server, a {@link webdriver.FileDetector}
+ * may be used to transparently copy files to the remote machine before
+ * attempting to upload them in the browser.
+ *
+ * __Note:__ On browsers where native keyboard events are not supported
+ * (e.g. Firefox on OS X), key events will be synthesized. Special
  * punctionation keys will be synthesized according to a standard QWERTY en-us
  * keyboard layout.
  *
- * @param {...string} var_args The sequence of keys to
- *     type. All arguments will be joined into a single sequence (var_args is
- *     permitted for convenience).
- * @return {!webdriver.promise.Promise} A promise that will be resolved when all
- *     keys have been typed.
+ * @param {...(string|!webdriver.promise.Promise<string>)} var_args The sequence
+ *     of keys to type. All arguments will be joined into a single sequence.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when all keys have been typed.
  */
 webdriver.WebElement.prototype.sendKeys = function(var_args) {
   // Coerce every argument to a string. This protects us from users that
   // ignore the jsdoc and give us a number (which ends up causing problems on
   // the server, which requires strings).
-  var keys = webdriver.promise.fullyResolved(goog.array.slice(arguments, 0)).
-      then(function(args) {
-        return goog.array.map(goog.array.slice(args, 0), function(key) {
-          return key + '';
-        });
+  var keys = webdriver.promise.all(goog.array.slice(arguments, 0)).
+      then(function(keys) {
+        return goog.array.map(keys, String);
       });
-  return this.schedule_(
-      new webdriver.Command(webdriver.CommandName.SEND_KEYS_TO_ELEMENT).
-          setParameter('value', keys),
-      'WebElement.sendKeys(' + keys + ')');
+  if (!this.driver_.fileDetector_) {
+    return this.schedule_(
+        new webdriver.Command(webdriver.CommandName.SEND_KEYS_TO_ELEMENT).
+            setParameter('value', keys),
+        'WebElement.sendKeys()');
+  }
+
+  // Suppress unhandled rejection errors until the flow executes the command.
+  keys.thenCatch(goog.nullFunction);
+
+  var element = this;
+  return this.driver_.flow_.execute(function() {
+    return keys.then(function(keys) {
+      return element.driver_.fileDetector_
+          .handleFile(element.driver_, keys.join(''));
+    }).then(function(keys) {
+      return element.schedule_(
+          new webdriver.Command(webdriver.CommandName.SEND_KEYS_TO_ELEMENT).
+              setParameter('value', [keys]),
+          'WebElement.sendKeys()');
+    });
+  }, 'WebElement.sendKeys()');
 };
 
 
 /**
  * Schedules a command to query for the tag/node name of this element.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     element's tag name.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the element's tag name.
  */
 webdriver.WebElement.prototype.getTagName = function() {
   return this.schedule_(
@@ -1792,14 +2027,14 @@ webdriver.WebElement.prototype.getTagName = function() {
  * its parent, the parent will be queried for its value.  Where possible, color
  * values will be converted to their hex representation (e.g. #00ff00 instead of
  * rgb(0, 255, 0)).
- * <p/>
- * <em>Warning:</em> the value returned will be as the browser interprets it, so
+ *
+ * _Warning:_ the value returned will be as the browser interprets it, so
  * it may be tricky to form a proper assertion.
  *
  * @param {string} cssStyleProperty The name of the CSS style property to look
  *     up.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     requested CSS value.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the requested CSS value.
  */
 webdriver.WebElement.prototype.getCssValue = function(cssStyleProperty) {
   var name = webdriver.CommandName.GET_ELEMENT_VALUE_OF_CSS_PROPERTY;
@@ -1821,23 +2056,23 @@ webdriver.WebElement.prototype.getCssValue = function(cssStyleProperty) {
  * text representation with a trailing semi-colon. The following are deemed to
  * be "boolean" attributes and will return either "true" or null:
  *
- * <p>async, autofocus, autoplay, checked, compact, complete, controls, declare,
+ * async, autofocus, autoplay, checked, compact, complete, controls, declare,
  * defaultchecked, defaultselected, defer, disabled, draggable, ended,
  * formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope,
  * loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open,
  * paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
  * selected, spellcheck, truespeed, willvalidate
  *
- * <p>Finally, the following commonly mis-capitalized attribute/property names
+ * Finally, the following commonly mis-capitalized attribute/property names
  * are evaluated as expected:
- * <ul>
- *   <li>"class"
- *   <li>"readonly"
- * </ul>
+ *
+ * - "class"
+ * - "readonly"
+ *
  * @param {string} attributeName The name of the attribute to query.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     attribute's value. The returned value will always be either a string or
- *     null.
+ * @return {!webdriver.promise.Promise.<?string>} A promise that will be
+ *     resolved with the attribute's value. The returned value will always be
+ *     either a string or null.
  */
 webdriver.WebElement.prototype.getAttribute = function(attributeName) {
   return this.schedule_(
@@ -1850,8 +2085,8 @@ webdriver.WebElement.prototype.getAttribute = function(attributeName) {
 /**
  * Get the visible (i.e. not hidden by CSS) innerText of this element, including
  * sub-elements, without any leading or trailing whitespace.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     element's visible text.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the element's visible text.
  */
 webdriver.WebElement.prototype.getText = function() {
   return this.schedule_(
@@ -1863,8 +2098,9 @@ webdriver.WebElement.prototype.getText = function() {
 /**
  * Schedules a command to compute the size of this element's bounding box, in
  * pixels.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     element's size as a {@code {width:number, height:number}} object.
+ * @return {!webdriver.promise.Promise.<{width: number, height: number}>} A
+ *     promise that will be resolved with the element's size as a
+ *     {@code {width:number, height:number}} object.
  */
 webdriver.WebElement.prototype.getSize = function() {
   return this.schedule_(
@@ -1875,8 +2111,9 @@ webdriver.WebElement.prototype.getSize = function() {
 
 /**
  * Schedules a command to compute the location of this element in page space.
- * @return {!webdriver.promise.Promise} A promise that will be resolved to the
- *     element's location as a {@code {x:number, y:number}} object.
+ * @return {!webdriver.promise.Promise.<{x: number, y: number}>} A promise that
+ *     will be resolved to the element's location as a
+ *     {@code {x:number, y:number}} object.
  */
 webdriver.WebElement.prototype.getLocation = function() {
   return this.schedule_(
@@ -1888,8 +2125,8 @@ webdriver.WebElement.prototype.getLocation = function() {
 /**
  * Schedules a command to query whether the DOM element represented by this
  * instance is enabled, as dicted by the {@code disabled} attribute.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with
- *     whether this element is currently enabled.
+ * @return {!webdriver.promise.Promise.<boolean>} A promise that will be
+ *     resolved with whether this element is currently enabled.
  */
 webdriver.WebElement.prototype.isEnabled = function() {
   return this.schedule_(
@@ -1900,8 +2137,8 @@ webdriver.WebElement.prototype.isEnabled = function() {
 
 /**
  * Schedules a command to query whether this element is selected.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with
- *     whether this element is currently selected.
+ * @return {!webdriver.promise.Promise.<boolean>} A promise that will be
+ *     resolved with whether this element is currently selected.
  */
 webdriver.WebElement.prototype.isSelected = function() {
   return this.schedule_(
@@ -1914,8 +2151,8 @@ webdriver.WebElement.prototype.isSelected = function() {
  * Schedules a command to submit the form containing this element (or this
  * element if it is a FORM element). This command is a no-op if the element is
  * not contained in a form.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     the form has been submitted.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the form has been submitted.
  */
 webdriver.WebElement.prototype.submit = function() {
   return this.schedule_(
@@ -1928,8 +2165,8 @@ webdriver.WebElement.prototype.submit = function() {
  * Schedules a command to clear the {@code value} of this element. This command
  * has no effect if the underlying DOM element is neither a text INPUT element
  * nor a TEXTAREA element.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     the element has been cleared.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when the element has been cleared.
  */
 webdriver.WebElement.prototype.clear = function() {
   return this.schedule_(
@@ -1940,8 +2177,8 @@ webdriver.WebElement.prototype.clear = function() {
 
 /**
  * Schedules a command to test whether this element is currently displayed.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with
- *     whether this element is currently visible on the page.
+ * @return {!webdriver.promise.Promise.<boolean>} A promise that will be
+ *     resolved with whether this element is currently visible on the page.
  */
 webdriver.WebElement.prototype.isDisplayed = function() {
   return this.schedule_(
@@ -1952,8 +2189,8 @@ webdriver.WebElement.prototype.isDisplayed = function() {
 
 /**
  * Schedules a command to retrieve the outer HTML of this element.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with
- *     the element's outer HTML.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the element's outer HTML.
  */
 webdriver.WebElement.prototype.getOuterHtml = function() {
   return this.driver_.executeScript(function() {
@@ -1971,8 +2208,8 @@ webdriver.WebElement.prototype.getOuterHtml = function() {
 
 /**
  * Schedules a command to retrieve the inner HTML of this element.
- * @return {!webdriver.promise.Promise} A promise that will be resolved with the
- *     element's inner HTML.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved with the element's inner HTML.
  */
 webdriver.WebElement.prototype.getInnerHtml = function() {
   return this.driver_.executeScript('return arguments[0].innerHTML', this);
@@ -1980,6 +2217,59 @@ webdriver.WebElement.prototype.getInnerHtml = function() {
 
 
 
+/**
+ * WebElementPromise is a promise that will be fulfilled with a WebElement.
+ * This serves as a forward proxy on WebElement, allowing calls to be
+ * scheduled without directly on this instance before the underlying
+ * WebElement has been fulfilled. In other words, the following two statements
+ * are equivalent:
+ *
+ *     driver.findElement({id: 'my-button'}).click();
+ *     driver.findElement({id: 'my-button'}).then(function(el) {
+ *       return el.click();
+ *     });
+ *
+ * @param {!webdriver.WebDriver} driver The parent WebDriver instance for this
+ *     element.
+ * @param {!webdriver.promise.Promise.<!webdriver.WebElement>} el A promise
+ *     that will resolve to the promised element.
+ * @constructor
+ * @extends {webdriver.WebElement}
+ * @implements {webdriver.promise.Thenable.<!webdriver.WebElement>}
+ * @final
+ */
+webdriver.WebElementPromise = function(driver, el) {
+  webdriver.WebElement.call(this, driver, {'ELEMENT': 'unused'});
+
+  /** @override */
+  this.cancel = goog.bind(el.cancel, el);
+
+  /** @override */
+  this.isPending = goog.bind(el.isPending, el);
+
+  /** @override */
+  this.then = goog.bind(el.then, el);
+
+  /** @override */
+  this.thenCatch = goog.bind(el.thenCatch, el);
+
+  /** @override */
+  this.thenFinally = goog.bind(el.thenFinally, el);
+
+  /**
+   * Defers returning the element ID until the wrapped WebElement has been
+   * resolved.
+   * @override
+   */
+  this.getId = function() {
+    return el.then(function(el) {
+      return el.getId();
+    });
+  };
+};
+goog.inherits(webdriver.WebElementPromise, webdriver.WebElement);
+
+
 /**
  * Represents a modal dialog such as {@code alert}, {@code confirm}, or
  * {@code prompt}. Provides functions to retrieve the message displayed with
@@ -1987,40 +2277,23 @@ webdriver.WebElement.prototype.getInnerHtml = function() {
  * case of {@code prompt}).
  * @param {!webdriver.WebDriver} driver The driver controlling the browser this
  *     alert is attached to.
- * @param {!(string|webdriver.promise.Promise)} text Either the message text
- *     displayed with this alert, or a promise that will be resolved to said
- *     text.
+ * @param {string} text The message text displayed with this alert.
  * @constructor
- * @extends {webdriver.promise.Deferred}
  */
 webdriver.Alert = function(driver, text) {
-  goog.base(this, null, driver.controlFlow());
-
   /** @private {!webdriver.WebDriver} */
   this.driver_ = driver;
 
-  // This class is responsible for resolving itself; delete the resolve and
-  // reject methods so they may not be accessed by consumers of this class.
-  var fulfill = goog.partial(this.fulfill, this);
-  var reject = this.reject;
-  delete this.promise;
-  delete this.fulfill;
-  delete this.reject;
-
-  /** @private {!webdriver.promise.Promise} */
+  /** @private {!webdriver.promise.Promise.<string>} */
   this.text_ = webdriver.promise.when(text);
-
-  // Make sure this instance is resolved when its displayed text is.
-  this.text_.then(fulfill, reject);
 };
-goog.inherits(webdriver.Alert, webdriver.promise.Deferred);
 
 
 /**
  * Retrieves the message text displayed with this alert. For instance, if the
  * alert were opened with alert("hello"), then this would return "hello".
- * @return {!webdriver.promise.Promise} A promise that will be resolved to the
- *     text displayed with this alert.
+ * @return {!webdriver.promise.Promise.<string>} A promise that will be
+ *     resolved to the text displayed with this alert.
  */
 webdriver.Alert.prototype.getText = function() {
   return this.text_;
@@ -2029,8 +2302,8 @@ webdriver.Alert.prototype.getText = function() {
 
 /**
  * Accepts this alert.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     this command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when this command has completed.
  */
 webdriver.Alert.prototype.accept = function() {
   return this.driver_.schedule(
@@ -2041,8 +2314,8 @@ webdriver.Alert.prototype.accept = function() {
 
 /**
  * Dismisses this alert.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     this command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when this command has completed.
  */
 webdriver.Alert.prototype.dismiss = function() {
   return this.driver_.schedule(
@@ -2056,8 +2329,8 @@ webdriver.Alert.prototype.dismiss = function() {
  * the underlying alert does not support response text (e.g. window.alert and
  * window.confirm).
  * @param {string} text The text to set.
- * @return {!webdriver.promise.Promise} A promise that will be resolved when
- *     this command has completed.
+ * @return {!webdriver.promise.Promise.<void>} A promise that will be resolved
+ *     when this command has completed.
  */
 webdriver.Alert.prototype.sendKeys = function(text) {
   return this.driver_.schedule(
@@ -2068,16 +2341,103 @@ webdriver.Alert.prototype.sendKeys = function(text) {
 
 
 
+/**
+ * AlertPromise is a promise that will be fulfilled with an Alert. This promise
+ * serves as a forward proxy on an Alert, allowing calls to be scheduled
+ * directly on this instance before the underlying Alert has been fulfilled. In
+ * other words, the following two statements are equivalent:
+ *
+ *     driver.switchTo().alert().dismiss();
+ *     driver.switchTo().alert().then(function(alert) {
+ *       return alert.dismiss();
+ *     });
+ *
+ * @param {!webdriver.WebDriver} driver The driver controlling the browser this
+ *     alert is attached to.
+ * @param {!webdriver.promise.Thenable.<!webdriver.Alert>} alert A thenable
+ *     that will be fulfilled with the promised alert.
+ * @constructor
+ * @extends {webdriver.Alert}
+ * @implements {webdriver.promise.Thenable.<!webdriver.Alert>}
+ * @final
+ */
+webdriver.AlertPromise = function(driver, alert) {
+  webdriver.Alert.call(this, driver, 'unused');
+
+  /** @override */
+  this.cancel = goog.bind(alert.cancel, alert);
+
+  /** @override */
+  this.isPending = goog.bind(alert.isPending, alert);
+
+  /** @override */
+  this.then = goog.bind(alert.then, alert);
+
+  /** @override */
+  this.thenCatch = goog.bind(alert.thenCatch, alert);
+
+  /** @override */
+  this.thenFinally = goog.bind(alert.thenFinally, alert);
+
+  /**
+   * Defer returning text until the promised alert has been resolved.
+   * @override
+   */
+  this.getText = function() {
+    return alert.then(function(alert) {
+      return alert.getText();
+    });
+  };
+
+  /**
+   * Defers action until the alert has been located.
+   * @override
+   */
+  this.accept = function() {
+    return alert.then(function(alert) {
+      return alert.accept();
+    });
+  };
+
+  /**
+   * Defers action until the alert has been located.
+   * @override
+   */
+  this.dismiss = function() {
+    return alert.then(function(alert) {
+      return alert.dismiss();
+    });
+  };
+
+  /**
+   * Defers action until the alert has been located.
+   * @override
+   */
+  this.sendKeys = function(text) {
+    return alert.then(function(alert) {
+      return alert.sendKeys(text);
+    });
+  };
+};
+goog.inherits(webdriver.AlertPromise, webdriver.Alert);
+
+
+
 /**
  * An error returned to indicate that there is an unhandled modal dialog on the
  * current page.
  * @param {string} message The error message.
+ * @param {string} text The text displayed with the unhandled alert.
  * @param {!webdriver.Alert} alert The alert handle.
  * @constructor
  * @extends {bot.Error}
  */
-webdriver.UnhandledAlertError = function(message, alert) {
-  goog.base(this, bot.ErrorCode.MODAL_DIALOG_OPENED, message);
+webdriver.UnhandledAlertError = function(message, text, alert) {
+  webdriver.UnhandledAlertError.base(
+      this, 'constructor', bot.ErrorCode.UNEXPECTED_ALERT_OPEN, message);
+
+  /** @private {string} */
+  this.text_ = text;
 
   /** @private {!webdriver.Alert} */
   this.alert_ = alert;
@@ -2086,8 +2446,47 @@ goog.inherits(webdriver.UnhandledAlertError, bot.Error);
 
 
 /**
- * @return {!webdriver.Alert} The open alert.
+ * @return {string} The text displayed with the unhandled alert.
  */
-webdriver.UnhandledAlertError.prototype.getAlert = function() {
-  return this.alert_;
+webdriver.UnhandledAlertError.prototype.getAlertText = function() {
+  return this.text_;
 };
+
+
+
+/**
+ * Used with {@link webdriver.WebElement#sendKeys WebElement#sendKeys} on file
+ * input elements ({@code <input type="file">}) to detect when the entered key
+ * sequence defines the path to a file.
+ *
+ * By default, {@linkplain webdriver.WebElement WebElement's} will enter all
+ * key sequences exactly as entered. You may set a
+ * {@linkplain webdriver.WebDriver#setFileDetector file detector} on the parent
+ * WebDriver instance to define custom behavior for handling file elements. Of
+ * particular note is the {@link selenium-webdriver/remote.FileDetector}, which
+ * should be used when running against a remote
+ * [Selenium Server](http://docs.seleniumhq.org/download/).
+ */
+webdriver.FileDetector = goog.defineClass(null, {
+  /** @constructor */
+  constructor: function() {},
+
+  /**
+   * Handles the file specified by the given path, preparing it for use with
+   * the current browser. If the path does not refer to a valid file, it will
+   * be returned unchanged, otherwisee a path suitable for use with the current
+   * browser will be returned.
+   *
+   * This default implementation is a no-op. Subtypes may override this
+   * function for custom tailored file handling.
+   *
+   * @param {!webdriver.WebDriver} driver The driver for the current browser.
+   * @param {string} path The path to process.
+   * @return {!webdriver.promise.Promise<string>} A promise for the processed
+   *     file path.
+   * @package
+   */
+  handleFile: function(driver, path) {
+    return webdriver.promise.fulfilled(path);
+  }
+});
diff --git a/net/index.js b/net/index.js
index 801ec28..4142ebc 100644
--- a/net/index.js
+++ b/net/index.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -41,7 +43,8 @@ function getAddress(loopback, opt_family) {
 
   var interfaces;
   if (loopback) {
-    interfaces = [getLoInterface()];
+    var lo = getLoInterface();
+    interfaces = lo ? [lo] : null;
   }
   interfaces = interfaces || os.networkInterfaces();
   for (var key in interfaces) {
diff --git a/net/portprober.js b/net/portprober.js
index ee57f12..5181167 100644
--- a/net/portprober.js
+++ b/net/portprober.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -60,7 +62,7 @@ function findSystemPortRange() {
 /**
  * Executes a command and returns its output if it succeeds.
  * @param {string} cmd The command to execute.
- * @return {!webdriver.promise.Promise<string>} A promise that will resolve
+ * @return {!webdriver.promise.Promise.<string>} A promise that will resolve
  *     with the command's stdout data.
  */
 function execute(cmd) {
@@ -78,7 +80,7 @@ function execute(cmd) {
 
 /**
  * Computes the ephemeral port range for a Unix-like system.
- * @return {!webdriver.promise.Promise<{min: number, max: number}>} A promise
+ * @return {!webdriver.promise.Promise.<{min: number, max: number}>} A promise
  *     that will resolve with the ephemeral port range on the current system.
  */
 function findUnixPortRange() {
@@ -105,7 +107,7 @@ function findUnixPortRange() {
 
 /**
  * Computes the ephemeral port range for a Windows system.
- * @return {!webdriver.promise.Promise<{min: number, max: number}>} A promise
+ * @return {!webdriver.promise.Promise.<{min: number, max: number}>} A promise
  *     that will resolve with the ephemeral port range on the current system.
  */
 function findWindowsPortRange() {
diff --git a/opera.js b/opera.js
new file mode 100644
index 0000000..e2579c2
--- /dev/null
+++ b/opera.js
@@ -0,0 +1,499 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Defines a {@linkplain Driver WebDriver} client for the
+ * Opera web browser (v26+). Before using this module, you must download the
+ * latest OperaDriver
+ * [release](https://github.com/operasoftware/operachromiumdriver/releases) and
+ * ensure it can be found on your system 
+ * [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29).
+ *
+ * There are three primary classes exported by this module:
+ *
+ * 1. {@linkplain ServiceBuilder}: configures the
+ *     {@link selenium-webdriver/remote.DriverService remote.DriverService}
+ *     that manages the
+ *     [OperaDriver](https://github.com/operasoftware/operachromiumdriver)
+ *     child process.
+ *
+ * 2. {@linkplain Options}: defines configuration options for each new Opera
+ *     session, such as which {@linkplain Options#setProxy proxy} to use,
+ *     what {@linkplain Options#addExtensions extensions} to install, or
+ *     what {@linkplain Options#addArguments command-line switches} to use when
+ *     starting the browser.
+ *
+ * 3. {@linkplain Driver}: the WebDriver client; each new instance will control
+ *     a unique browser session with a clean user profile (unless otherwise
+ *     configured through the {@link Options} class).
+ *
+ * By default, every Opera session will use a single driver service, which is
+ * started the first time a {@link Driver} instance is created and terminated
+ * when this process exits. The default service will inherit its environment
+ * from the current process and direct all output to /dev/null. You may obtain
+ * a handle to this default service using
+ * {@link #getDefaultService getDefaultService()} and change its configuration
+ * with {@link #setDefaultService setDefaultService()}.
+ *
+ * You may also create a {@link Driver} with its own driver service. This is
+ * useful if you need to capture the server's log output for a specific session:
+ *
+ *     var opera = require('selenium-webdriver/opera');
+ *
+ *     var service = new opera.ServiceBuilder()
+ *         .loggingTo('/my/log/file.txt')
+ *         .enableVerboseLogging()
+ *         .build();
+ *
+ *     var options = new opera.Options();
+ *     // configure browser options ...
+ *
+ *     var driver = new opera.Driver(options, service);
+ *
+ * Users should only instantiate the {@link Driver} class directly when they
+ * need a custom driver service configuration (as shown above). For normal
+ * operation, users should start Opera using the
+ * {@link selenium-webdriver.Builder}.
+ */
+
+'use strict';
+
+var fs = require('fs'),
+    util = require('util');
+
+var webdriver = require('./index'),
+    executors = require('./executors'),
+    io = require('./io'),
+    portprober = require('./net/portprober'),
+    remote = require('./remote');
+
+
+/**
+ * Name of the OperaDriver executable.
+ * @type {string}
+ * @const
+ */
+var OPERADRIVER_EXE =
+    process.platform === 'win32' ? 'operadriver.exe' : 'operadriver';
+
+
+/**
+ * Creates {@link remote.DriverService} instances that manages an
+ * [OperaDriver](https://github.com/operasoftware/operachromiumdriver)
+ * server in a child process.
+ *
+ * @param {string=} opt_exe Path to the server executable to use. If omitted,
+ *     the builder will attempt to locate the operadriver on the current
+ *     PATH.
+ * @throws {Error} If provided executable does not exist, or the operadriver
+ *     cannot be found on the PATH.
+ * @constructor
+ */
+var ServiceBuilder = function(opt_exe) {
+  /** @private {string} */
+  this.exe_ = opt_exe || io.findInPath(OPERADRIVER_EXE, true);
+  if (!this.exe_) {
+    throw Error(
+        'The OperaDriver could not be found on the current PATH. Please ' +
+        'download the latest version of the OperaDriver from ' +
+        'https://github.com/operasoftware/operachromiumdriver/releases and ' +
+        'ensure it can be found on your PATH.');
+  }
+
+  if (!fs.existsSync(this.exe_)) {
+    throw Error('File does not exist: ' + this.exe_);
+  }
+
+  /** @private {!Array.<string>} */
+  this.args_ = [];
+  this.stdio_ = 'ignore';
+};
+
+
+/** @private {number} */
+ServiceBuilder.prototype.port_ = 0;
+
+
+/** @private {(string|!Array.<string|number|!Stream|null|undefined>)} */
+ServiceBuilder.prototype.stdio_ = 'ignore';
+
+
+/** @private {Object.<string, string>} */
+ServiceBuilder.prototype.env_ = null;
+
+
+/**
+ * Sets the port to start the OperaDriver on.
+ * @param {number} port The port to use, or 0 for any free port.
+ * @return {!ServiceBuilder} A self reference.
+ * @throws {Error} If the port is invalid.
+ */
+ServiceBuilder.prototype.usingPort = function(port) {
+  if (port < 0) {
+    throw Error('port must be >= 0: ' + port);
+  }
+  this.port_ = port;
+  return this;
+};
+
+
+/**
+ * Sets the path of the log file the driver should log to. If a log file is
+ * not specified, the driver will log to stderr.
+ * @param {string} path Path of the log file to use.
+ * @return {!ServiceBuilder} A self reference.
+ */
+ServiceBuilder.prototype.loggingTo = function(path) {
+  this.args_.push('--log-path=' + path);
+  return this;
+};
+
+
+/**
+ * Enables verbose logging.
+ * @return {!ServiceBuilder} A self reference.
+ */
+ServiceBuilder.prototype.enableVerboseLogging = function() {
+  this.args_.push('--verbose');
+  return this;
+};
+
+
+/**
+ * Silence sthe drivers output.
+ * @return {!ServiceBuilder} A self reference.
+ */
+ServiceBuilder.prototype.silent = function() {
+  this.args_.push('--silent');
+  return this;
+};
+
+
+/**
+ * Defines the stdio configuration for the driver service. See
+ * {@code child_process.spawn} for more information.
+ * @param {(string|!Array.<string|number|!Stream|null|undefined>)} config The
+ *     configuration to use.
+ * @return {!ServiceBuilder} A self reference.
+ */
+ServiceBuilder.prototype.setStdio = function(config) {
+  this.stdio_ = config;
+  return this;
+};
+
+
+/**
+ * Defines the environment to start the server under. This settings will be
+ * inherited by every browser session started by the server.
+ * @param {!Object.<string, string>} env The environment to use.
+ * @return {!ServiceBuilder} A self reference.
+ */
+ServiceBuilder.prototype.withEnvironment = function(env) {
+  this.env_ = env;
+  return this;
+};
+
+
+/**
+ * Creates a new DriverService using this instance's current configuration.
+ * @return {remote.DriverService} A new driver service using this instance's
+ *     current configuration.
+ * @throws {Error} If the driver exectuable was not specified and a default
+ *     could not be found on the current PATH.
+ */
+ServiceBuilder.prototype.build = function() {
+  var port = this.port_ || portprober.findFreePort();
+  var args = this.args_.concat();  // Defensive copy.
+
+  return new remote.DriverService(this.exe_, {
+    loopback: true,
+    port: port,
+    args: webdriver.promise.when(port, function(port) {
+      return args.concat('--port=' + port);
+    }),
+    env: this.env_,
+    stdio: this.stdio_
+  });
+};
+
+
+/** @type {remote.DriverService} */
+var defaultService = null;
+
+
+/**
+ * Sets the default service to use for new OperaDriver instances.
+ * @param {!remote.DriverService} service The service to use.
+ * @throws {Error} If the default service is currently running.
+ */
+function setDefaultService(service) {
+  if (defaultService && defaultService.isRunning()) {
+    throw Error(
+        'The previously configured OperaDriver service is still running. ' +
+        'You must shut it down before you may adjust its configuration.');
+  }
+  defaultService = service;
+}
+
+
+/**
+ * Returns the default OperaDriver service. If such a service has not been
+ * configured, one will be constructed using the default configuration for
+ * a OperaDriver executable found on the system PATH.
+ * @return {!remote.DriverService} The default OperaDriver service.
+ */
+function getDefaultService() {
+  if (!defaultService) {
+    defaultService = new ServiceBuilder().build();
+  }
+  return defaultService;
+}
+
+
+/**
+ * @type {string}
+ * @const
+ */
+var OPTIONS_CAPABILITY_KEY = 'chromeOptions';
+
+
+/**
+ * Class for managing {@link Driver OperaDriver} specific options.
+ * @constructor
+ * @extends {webdriver.Serializable}
+ */
+var Options = function() {
+  webdriver.Serializable.call(this);
+
+  /** @private {!Array.<string>} */
+  this.args_ = [];
+
+  /** @private {!Array.<(string|!Buffer)>} */
+  this.extensions_ = [];
+};
+util.inherits(Options, webdriver.Serializable);
+
+
+/**
+ * Extracts the OperaDriver specific options from the given capabilities
+ * object.
+ * @param {!webdriver.Capabilities} capabilities The capabilities object.
+ * @return {!Options} The OperaDriver options.
+ */
+Options.fromCapabilities = function(capabilities) {
+  var options;
+  var o = capabilities.get(OPTIONS_CAPABILITY_KEY);
+  if (o instanceof Options) {
+    options = o;
+  } else if (o) {
+    options.
+        addArguments(o.args || []).
+        addExtensions(o.extensions || []).
+        setOperaBinaryPath(o.binary);
+  } else {
+    options = new Options;
+  }
+
+  if (capabilities.has(webdriver.Capability.PROXY)) {
+    options.setProxy(capabilities.get(webdriver.Capability.PROXY));
+  }
+
+  if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {
+    options.setLoggingPrefs(
+        capabilities.get(webdriver.Capability.LOGGING_PREFS));
+  }
+
+  return options;
+};
+
+
+/**
+ * Add additional command line arguments to use when launching the Opera
+ * browser.  Each argument may be specified with or without the "--" prefix
+ * (e.g. "--foo" and "foo"). Arguments with an associated value should be
+ * delimited by an "=": "foo=bar".
+ * @param {...(string|!Array.<string>)} var_args The arguments to add.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.addArguments = function(var_args) {
+  this.args_ = this.args_.concat.apply(this.args_, arguments);
+  return this;
+};
+
+
+/**
+ * Add additional extensions to install when launching Opera. Each extension
+ * should be specified as the path to the packed CRX file, or a Buffer for an
+ * extension.
+ * @param {...(string|!Buffer|!Array.<(string|!Buffer)>)} var_args The
+ *     extensions to add.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.addExtensions = function(var_args) {
+  this.extensions_ = this.extensions_.concat.apply(
+      this.extensions_, arguments);
+  return this;
+};
+
+
+/**
+ * Sets the path to the Opera binary to use. On Mac OS X, this path should
+ * reference the actual Opera executable, not just the application binary. The
+ * binary path be absolute or relative to the operadriver server executable, but
+ * it must exist on the machine that will launch Opera.
+ *
+ * @param {string} path The path to the Opera binary to use.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setOperaBinaryPath = function(path) {
+  this.binary_ = path;
+  return this;
+};
+
+
+/**
+ * Sets the logging preferences for the new session.
+ * @param {!webdriver.logging.Preferences} prefs The logging preferences.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setLoggingPrefs = function(prefs) {
+  this.logPrefs_ = prefs;
+  return this;
+};
+
+
+/**
+ * Sets the proxy settings for the new session.
+ * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setProxy = function(proxy) {
+  this.proxy_ = proxy;
+  return this;
+};
+
+
+/**
+ * Converts this options instance to a {@link webdriver.Capabilities} object.
+ * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge
+ *     these options into, if any.
+ * @return {!webdriver.Capabilities} The capabilities.
+ */
+Options.prototype.toCapabilities = function(opt_capabilities) {
+  var capabilities = opt_capabilities || webdriver.Capabilities.opera();
+  capabilities.
+      set(webdriver.Capability.PROXY, this.proxy_).
+      set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_).
+      set(OPTIONS_CAPABILITY_KEY, this);
+  return capabilities;
+};
+
+
+/**
+ * Converts this instance to its JSON wire protocol representation. Note this
+ * function is an implementation not intended for general use.
+ * @return {{args: !Array.<string>,
+ *           binary: (string|undefined),
+ *           detach: boolean,
+ *           extensions: !Array.<(string|!webdriver.promise.Promise.<string>))>,
+ *           localState: (Object|undefined),
+ *           logPath: (string|undefined),
+ *           prefs: (Object|undefined)}} The JSON wire protocol representation
+ *     of this instance.
+ * @override
+ */
+Options.prototype.serialize = function() {
+  var json = {
+    args: this.args_,
+    extensions: this.extensions_.map(function(extension) {
+      if (Buffer.isBuffer(extension)) {
+        return extension.toString('base64');
+      }
+      return webdriver.promise.checkedNodeCall(
+          fs.readFile, extension, 'base64');
+    })
+  };
+  if (this.binary_) {
+    json.binary = this.binary_;
+  }
+  if (this.logFile_) {
+    json.logPath = this.logFile_;
+  }
+  if (this.prefs_) {
+    json.prefs = this.prefs_;
+  }
+
+  return json;
+};
+
+
+/**
+ * Creates a new WebDriver client for Opera.
+ *
+ * @param {(webdriver.Capabilities|Options)=} opt_config The configuration
+ *     options.
+ * @param {remote.DriverService=} opt_service The session to use; will use
+ *     the {@link getDefaultService default service} by default.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or
+ *     {@code null} to use the currently active flow.
+ * @constructor
+ * @extends {webdriver.WebDriver}
+ */
+var Driver = function(opt_config, opt_service, opt_flow) {
+  var service = opt_service || getDefaultService();
+  var executor = executors.createExecutor(service.start());
+
+  var capabilities =
+      opt_config instanceof Options ? opt_config.toCapabilities() :
+      (opt_config || webdriver.Capabilities.opera());
+
+  // On Linux, the OperaDriver does not look for Opera on the PATH, so we
+  // must explicitly find it. See: operachromiumdriver #9.
+  if (process.platform === 'linux') {
+    var options = Options.fromCapabilities(capabilities);
+    if (!options.binary_) {
+      options.setOperaBinaryPath(io.findInPath('opera', true));
+    }
+    capabilities = options.toCapabilities(capabilities);
+  }
+
+  var driver = webdriver.WebDriver.createSession(
+      executor, capabilities, opt_flow);
+
+  webdriver.WebDriver.call(
+      this, driver.getSession(), executor, driver.controlFlow());
+};
+util.inherits(Driver, webdriver.WebDriver);
+
+
+/**
+ * This function is a no-op as file detectors are not supported by this
+ * implementation.
+ * @override
+ */
+Driver.prototype.setFileDetector = function() {
+};
+
+
+// PUBLIC API
+
+
+exports.Driver = Driver;
+exports.Options = Options;
+exports.ServiceBuilder = ServiceBuilder;
+exports.getDefaultService = getDefaultService;
+exports.setDefaultService = setDefaultService;
diff --git a/package.json b/package.json
index f2e2a65..13df439 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,8 @@
 {
   "name": "browserstack-webdriver",
-  "version": "2.41.1",
-  "description": "BrowserStack WebDriver JavaScript bindings with keep alive support",
+  "version": "2.48.0",
+  "description": "Browserstack Webdriver Javascript bindings with keep alive support",
+  "license": "Apache-2.0",
   "keywords": [
     "automation",
     "selenium",
@@ -19,23 +20,24 @@
     "url": "https://github.com/browserstack/selenium-webdriver-nodejs"
   },
   "engines": {
-    "node": ">= 0.8.x"
+    "node": ">= 0.12.x"
+  },
+  "dependencies": {
+    "adm-zip": "0.4.4",
+    "rimraf": "^2.2.8",
+    "tmp": "0.0.24",
+    "ws": "^0.8.0",
+    "xml2js": "0.4.4",
+    "keep-alive-agent": "*"
   },
   "devDependencies": {
-    "mocha": "~1.10.0"
+    "express": "^4.11.2",
+    "mocha": ">= 1.21.x",
+    "multer": "^0.1.7",
+    "promises-aplus-tests": "^2.1.0",
+    "serve-index": "^1.6.1"
   },
   "scripts": {
-    "test": "node_modules/mocha/bin/mocha -R list --recursive test"
-  },
-  "readme": "# browserstack-webdriver\n\n## Installation\n\nInstall the latest published version using `npm`:\n\n    npm install browserstack-webdriver\n\nIn addition to the npm package, you will to download the WebDriver\nimplementations you wish to utilize. As of 2.34.0, `browserstack-webdriver`\nnatively supports the [ChromeDriver](http://chromedriver.storage.googleapis.com/index.html).\nSimply download a copy and make sure it can be found on your `PATH`. The other\ndrivers (e.g. Firefox, Internet Explorer, and Safari), still require the\n[standalone Selenium server](http://selenium-release.storage.googleapis.com/index.html).\n\n### Running the tests\n\nTo run the tests, you will need to download a copy of the\n[ChromeDriver](http://chromedriver.storage.googleapis.com/index.html) and make\nsure it can be found on your `PATH`.\n\n    npm test browserstack-webdriver\n\nTo run the tests against multiple browsers, download the\n[Selenium server](http://selenium-release.storage.googleapis.com/index.html) and\nspecify its location through the `SELENIUM_SERVER_JAR` environment variable.\nYou can use the `SELENIUM_BROWSER` environment variable to define a\ncomma-separated list of browsers you wish to test against. For example:\n\n    export SELENIUM_SERVER_JAR=path/to/selenium-server-standalone-2.33.0.jar\n    SELENIUM_BROWSER=chrome,firefox npm test browserstack-webdriver\n\n## Usage\n\n\n    var webdriver = require('browserstack-webdriver');\n\n    var driver = new webdriver.Builder().\n        withCapabilities(webdriver.Capabilities.chrome()).\n        build();\n\n    driver.get('http://www.google.com');\n    driver.findElement(webdriver.By.name('q')).sendKeys('webdriver');\n    driver.findElement(webdriver.By.name('btnG')).click();\n    driver.wait(function() {\n      return driver.getTitle().then(function(title) {\n        return title === 'webdriver - Google Search';\n      });\n    }, 1000);\n\n    driver.quit();\n\n## Documentation\n\nFull documentation is available on the [Selenium project wiki](http://code.google.com/p/selenium/wiki/WebDriverJs \"User guide\").\n\n## Issues\n\nPlease report any issues using the [Selenium issue tracker](https://code.google.com/p/selenium/issues/list).\n\n## License\n\nCopyright 2009-2014 Software Freedom Conservancy\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n     http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n",
-  "readmeFilename": "README.md",
-  "_id": "browserstack-webdriver@2.41.0",
-  "dist": {
-    "shasum": "d59dd6297c13b821711bdd8775afa7dffef78ef4"
-  },
-  "_from": "browserstack-webdriver@",
-  "_resolved": "https://registry.npmjs.org/browserstack-webdriver/-/browserstack-webdriver-2.41.0.tgz",
-  "dependencies" : {
-    "keep-alive-agent": "*"
+    "test": "node_modules/.bin/mocha --harmony -t 600000 --recursive test"
   }
 }
diff --git a/phantomjs.js b/phantomjs.js
index bee3572..b0cf1a4 100644
--- a/phantomjs.js
+++ b/phantomjs.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -19,8 +21,8 @@ var fs = require('fs'),
     util = require('util');
 
 var webdriver = require('./index'),
-    LogLevel = webdriver.logging.LevelName,
     executors = require('./executors'),
+    http = require('./http'),
     io = require('./io'),
     portprober = require('./net/portprober'),
     remote = require('./remote');
@@ -59,6 +61,15 @@ var CLI_ARGS_CAPABILITY = 'phantomjs.cli.args';
 var DEFAULT_LOG_FILE = 'phantomjsdriver.log';
 
 
+/**
+ * Custom command names supported by PhantomJS.
+ * @enum {string}
+ */
+var Command = {
+  EXECUTE_PHANTOM_SCRIPT: 'executePhantomScript'
+};
+
+
 /**
  * Finds the PhantomJS executable.
  * @param {string=} opt_exe Path to the executable to use.
@@ -85,30 +96,57 @@ function findExecutable(opt_exe) {
 
 /**
  * Maps WebDriver logging level name to those recognised by PhantomJS.
- * @type {!Object.<webdriver.logging.LevelName, string>}
+ * @type {!Object.<string, string>}
  * @const
  */
 var WEBDRIVER_TO_PHANTOMJS_LEVEL = (function() {
   var map = {};
-  map[LogLevel.ALL] = map[LogLevel.DEBUG] = 'DEBUG';
-  map[LogLevel.INFO] = 'INFO';
-  map[LogLevel.WARNING] = 'WARN';
-  map[LogLevel.SEVERE] = map[LogLevel.OFF] = 'ERROR';
+  map[webdriver.logging.Level.ALL.name] = 'DEBUG';
+  map[webdriver.logging.Level.DEBUG.name] = 'DEBUG';
+  map[webdriver.logging.Level.INFO.name] = 'INFO';
+  map[webdriver.logging.Level.WARNING.name] = 'WARN';
+  map[webdriver.logging.Level.SEVERE.name] = 'ERROR';
   return map;
 })();
 
 
 /**
- * Creates a new PhantomJS WebDriver client.
+ * Creates a command executor with support for PhantomJS' custom commands.
+ * @param {!webdriver.promise.Promise<string>} url The server's URL.
+ * @return {!webdriver.CommandExecutor} The new command executor.
+ */
+function createExecutor(url) {
+  return new executors.DeferredExecutor(url.then(function(url) {
+    var client = new http.HttpClient(url);
+    var executor = new http.Executor(client);
+
+    executor.defineCommand(
+        Command.EXECUTE_PHANTOM_SCRIPT,
+        'POST', '/session/:sessionId/phantom/execute');
+
+    return executor;
+  }));
+}
+
+/**
+ * Creates a new WebDriver client for PhantomJS.
+ *
  * @param {webdriver.Capabilities=} opt_capabilities The desired capabilities.
- * @return {!webdriver.WebDriver} A new WebDriver instance.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or
+ *     {@code null} to use the currently active flow.
+ * @constructor
+ * @extends {webdriver.WebDriver}
  */
-function createDriver(opt_capabilities) {
+var Driver = function(opt_capabilities, opt_flow) {
   var capabilities = opt_capabilities || webdriver.Capabilities.phantomjs();
   var exe = findExecutable(capabilities.get(BINARY_PATH_CAPABILITY));
   var args = ['--webdriver-logfile=' + DEFAULT_LOG_FILE];
 
   var logPrefs = capabilities.get(webdriver.Capability.LOGGING_PREFS);
+  if (logPrefs instanceof webdriver.logging.Preferences) {
+    logPrefs = logPrefs.toJSON();
+  }
+
   if (logPrefs && logPrefs[webdriver.logging.Type.DRIVER]) {
     var level = WEBDRIVER_TO_PHANTOMJS_LEVEL[
         logPrefs[webdriver.logging.Type.DRIVER]];
@@ -148,17 +186,80 @@ function createDriver(opt_capabilities) {
     })
   });
 
-  var executor = executors.createExecutor(service.start());
-  var driver = webdriver.WebDriver.createSession(executor, capabilities);
-  var boundQuit = driver.quit.bind(driver);
-  driver.quit = function() {
+  var executor = createExecutor(service.start());
+  var driver = webdriver.WebDriver.createSession(
+      executor, capabilities, opt_flow);
+
+  webdriver.WebDriver.call(
+      this, driver.getSession(), executor, driver.controlFlow());
+
+  var boundQuit = this.quit.bind(this);
+
+  /** @override */
+  this.quit = function() {
     return boundQuit().thenFinally(service.kill.bind(service));
   };
-  return driver;
-}
+};
+util.inherits(Driver, webdriver.WebDriver);
 
 
-// PUBLIC API
+/**
+ * This function is a no-op as file detectors are not supported by this
+ * implementation.
+ * @override
+ */
+Driver.prototype.setFileDetector = function() {
+};
+
 
+/**
+ * Executes a PhantomJS fragment. This method is similar to
+ * {@link #executeScript}, except it exposes the
+ * <a href="http://phantomjs.org/api/">PhantomJS API</a> to the injected
+ * script.
+ *
+ * <p>The injected script will execute in the context of PhantomJS's
+ * {@code page} variable. If a page has not been loaded before calling this
+ * method, one will be created.</p>
+ *
+ * <p>Be sure to wrap callback definitions in a try/catch block, as failures
+ * may cause future WebDriver calls to fail.</p>
+ *
+ * <p>Certain callbacks are used by GhostDriver (the PhantomJS WebDriver
+ * implementation) and overriding these may cause the script to fail. It is
+ * recommended that you check for existing callbacks before defining your own.
+ * </p>
+ *
+ * As with {@link #executeScript}, the injected script may be defined as
+ * a string for an anonymous function body (e.g. "return 123;"), or as a
+ * function. If a function is provided, it will be decompiled to its original
+ * source. Note that injecting functions is provided as a convenience to
+ * simplify defining complex scripts. Care must be taken that the function
+ * only references variables that will be defined in the page's scope and
+ * that the function does not override {@code Function.prototype.toString}
+ * (overriding toString() will interfere with how the function is
+ * decompiled.
+ *
+ * @param {(string|!Function)} script The script to execute.
+ * @param {...*} var_args The arguments to pass to the script.
+ * @return {!webdriver.promise.Promise<T>} A promise that resolve to the
+ *     script's return value.
+ * @template T
+ */
+Driver.prototype.executePhantomJS = function(script, args) {
+  if (typeof script === 'function') {
+    script = 'return (' + script + ').apply(this, arguments);';
+  }
+  var args = arguments.length > 1
+      ? Array.prototype.slice.call(arguments, 1) : [];
+  return this.schedule(
+      new webdriver.Command(Command.EXECUTE_PHANTOM_SCRIPT)
+          .setParameter('script', script)
+          .setParameter('args', args),
+      'Driver.executePhantomJS()');
+};
+
+
+// PUBLIC API
 
-exports.createDriver = createDriver;
+exports.Driver = Driver;
diff --git a/phantomjsdriver.log b/phantomjsdriver.log
deleted file mode 100644
index 7c32424..0000000
--- a/phantomjsdriver.log
+++ /dev/null
@@ -1,34 +0,0 @@
-[INFO  - 2014-03-28T16:52:45.192Z] GhostDriver - Main - running on port 40413
-[INFO  - 2014-03-28T16:52:45.244Z] Session [62a32f40-b699-11e3-9b9a-37c865d8e725] - page.settings - {"XSSAuditingEnabled":false,"javascriptCanCloseWindows":true,"javascriptCanOpenWindows":true,"javascriptEnabled":true,"loadImages":true,"localToRemoteUrlAccessEnabled":false,"userAgent":"Mozilla/5.0 (Unknown; Linux x86_64) AppleWebKit/534.34 (KHTML, like Gecko) PhantomJS/1.9.7 Safari/534.34","webSecurityEnabled":true}
-[INFO  - 2014-03-28T16:52:45.244Z] Session [62a32f40-b699-11e3-9b9a-37c865d8e725] - page.customHeaders:  - {}
-[INFO  - 2014-03-28T16:52:45.244Z] Session [62a32f40-b699-11e3-9b9a-37c865d8e725] - Session.negotiatedCapabilities - {"browserName":"phantomjs","version":"1.9.7","driverName":"ghostdriver","driverVersion":"1.1.0","platform":"linux-unknown-64bit","javascriptEnabled":true,"takesScreenshot":true,"handlesAlerts":false,"databaseEnabled":false,"locationContextEnabled":false,"applicationCacheEnabled":false,"browserConnectionEnabled":false,"cssSelectorsEnabled":true,"webStorageEnabled":false,"rotatable":false,"acceptSslCerts":false,"nativeEvents":true,"proxy":{"proxyType":"direct"}}
-[INFO  - 2014-03-28T16:52:45.244Z] SessionManagerReqHand - _postNewSessionCommand - New Session Created: 62a32f40-b699-11e3-9b9a-37c865d8e725
-[INFO  - 2014-03-28T16:52:52.718Z] GhostDriver - Main - running on port 36577
-[INFO  - 2014-03-28T16:52:52.759Z] Session [671dbae0-b699-11e3-9b78-c337d2fb87e4] - page.settings - {"XSSAuditingEnabled":false,"javascriptCanCloseWindows":true,"javascriptCanOpenWindows":true,"javascriptEnabled":true,"loadImages":true,"localToRemoteUrlAccessEnabled":false,"userAgent":"Mozilla/5.0 (Unknown; Linux x86_64) AppleWebKit/534.34 (KHTML, like Gecko) PhantomJS/1.9.7 Safari/534.34","webSecurityEnabled":true}
-[INFO  - 2014-03-28T16:52:52.759Z] Session [671dbae0-b699-11e3-9b78-c337d2fb87e4] - page.customHeaders:  - {}
-[INFO  - 2014-03-28T16:52:52.759Z] Session [671dbae0-b699-11e3-9b78-c337d2fb87e4] - Session.negotiatedCapabilities - {"browserName":"phantomjs","version":"1.9.7","driverName":"ghostdriver","driverVersion":"1.1.0","platform":"linux-unknown-64bit","javascriptEnabled":true,"takesScreenshot":true,"handlesAlerts":false,"databaseEnabled":false,"locationContextEnabled":false,"applicationCacheEnabled":false,"browserConnectionEnabled":false,"cssSelectorsEnabled":true,"webStorageEnabled":false,"rotatable":false,"acceptSslCerts":false,"nativeEvents":true,"proxy":{"proxyType":"direct"}}
-[INFO  - 2014-03-28T16:52:52.759Z] SessionManagerReqHand - _postNewSessionCommand - New Session Created: 671dbae0-b699-11e3-9b78-c337d2fb87e4
-[ERROR - 2014-03-28T16:52:53.640Z] WebElementLocator - _handleLocateCommand - Element(s) NOT Found: GAVE UP. Search Stop Time: 1396025573627
-[ERROR - 2014-03-28T16:52:56.439Z] WebElementLocator - _handleLocateCommand - Element(s) NOT Found: GAVE UP. Search Stop Time: 1396025576431
-[ERROR - 2014-03-28T16:52:56.881Z] WebElementLocator - _handleLocateCommand - Element(s) NOT Found: GAVE UP. Search Stop Time: 1396025576875
-[ERROR - 2014-03-28T16:52:57.221Z] WebElementLocator - _handleLocateCommand - Element(s) NOT Found: GAVE UP. Search Stop Time: 1396025577164
-[INFO  - 2014-03-28T16:52:59.078Z] GhostDriver - Main - running on port 50797
-[INFO  - 2014-03-28T16:52:59.112Z] Session [6ae74600-b699-11e3-a324-653123da115f] - page.settings - {"XSSAuditingEnabled":false,"javascriptCanCloseWindows":true,"javascriptCanOpenWindows":true,"javascriptEnabled":true,"loadImages":true,"localToRemoteUrlAccessEnabled":false,"userAgent":"Mozilla/5.0 (Unknown; Linux x86_64) AppleWebKit/534.34 (KHTML, like Gecko) PhantomJS/1.9.7 Safari/534.34","webSecurityEnabled":true}
-[INFO  - 2014-03-28T16:52:59.112Z] Session [6ae74600-b699-11e3-a324-653123da115f] - page.customHeaders:  - {}
-[INFO  - 2014-03-28T16:52:59.113Z] Session [6ae74600-b699-11e3-a324-653123da115f] - Session.negotiatedCapabilities - {"browserName":"phantomjs","version":"1.9.7","driverName":"ghostdriver","driverVersion":"1.1.0","platform":"linux-unknown-64bit","javascriptEnabled":true,"takesScreenshot":true,"handlesAlerts":false,"databaseEnabled":false,"locationContextEnabled":false,"applicationCacheEnabled":false,"browserConnectionEnabled":false,"cssSelectorsEnabled":true,"webStorageEnabled":false,"rotatable":false,"acceptSslCerts":false,"nativeEvents":true,"proxy":{"proxyType":"direct"}}
-[INFO  - 2014-03-28T16:52:59.113Z] SessionManagerReqHand - _postNewSessionCommand - New Session Created: 6ae74600-b699-11e3-a324-653123da115f
-[INFO  - 2014-03-28T16:53:01.703Z] GhostDriver - Main - running on port 33436
-[INFO  - 2014-03-28T16:53:01.748Z] Session [6c797ec0-b699-11e3-9707-815ca604fa62] - page.settings - {"XSSAuditingEnabled":false,"javascriptCanCloseWindows":true,"javascriptCanOpenWindows":true,"javascriptEnabled":true,"loadImages":true,"localToRemoteUrlAccessEnabled":false,"userAgent":"Mozilla/5.0 (Unknown; Linux x86_64) AppleWebKit/534.34 (KHTML, like Gecko) PhantomJS/1.9.7 Safari/534.34","webSecurityEnabled":true}
-[INFO  - 2014-03-28T16:53:01.748Z] Session [6c797ec0-b699-11e3-9707-815ca604fa62] - page.customHeaders:  - {}
-[INFO  - 2014-03-28T16:53:01.748Z] Session [6c797ec0-b699-11e3-9707-815ca604fa62] - Session.negotiatedCapabilities - {"browserName":"phantomjs","version":"1.9.7","driverName":"ghostdriver","driverVersion":"1.1.0","platform":"linux-unknown-64bit","javascriptEnabled":true,"takesScreenshot":true,"handlesAlerts":false,"databaseEnabled":false,"locationContextEnabled":false,"applicationCacheEnabled":false,"browserConnectionEnabled":false,"cssSelectorsEnabled":true,"webStorageEnabled":false,"rotatable":false,"acceptSslCerts":false,"nativeEvents":true,"proxy":{"proxyType":"direct"}}
-[INFO  - 2014-03-28T16:53:01.749Z] SessionManagerReqHand - _postNewSessionCommand - New Session Created: 6c797ec0-b699-11e3-9707-815ca604fa62
-[INFO  - 2014-03-28T16:53:02.488Z] GhostDriver - Main - running on port 59129
-[INFO  - 2014-03-28T16:53:02.524Z] Session [6cf08380-b699-11e3-b737-ff38291f8e79] - page.settings - {"XSSAuditingEnabled":false,"javascriptCanCloseWindows":true,"javascriptCanOpenWindows":true,"javascriptEnabled":true,"loadImages":true,"localToRemoteUrlAccessEnabled":false,"userAgent":"Mozilla/5.0 (Unknown; Linux x86_64) AppleWebKit/534.34 (KHTML, like Gecko) PhantomJS/1.9.7 Safari/534.34","webSecurityEnabled":true}
-[INFO  - 2014-03-28T16:53:02.524Z] Session [6cf08380-b699-11e3-b737-ff38291f8e79] - page.customHeaders:  - {}
-[INFO  - 2014-03-28T16:53:02.524Z] Session [6cf08380-b699-11e3-b737-ff38291f8e79] - Session.negotiatedCapabilities - {"browserName":"phantomjs","version":"1.9.7","driverName":"ghostdriver","driverVersion":"1.1.0","platform":"linux-unknown-64bit","javascriptEnabled":true,"takesScreenshot":true,"handlesAlerts":false,"databaseEnabled":false,"locationContextEnabled":false,"applicationCacheEnabled":false,"browserConnectionEnabled":false,"cssSelectorsEnabled":true,"webStorageEnabled":false,"rotatable":false,"acceptSslCerts":false,"nativeEvents":true,"proxy":{"proxyType":"direct"}}
-[INFO  - 2014-03-28T16:53:02.524Z] SessionManagerReqHand - _postNewSessionCommand - New Session Created: 6cf08380-b699-11e3-b737-ff38291f8e79
-[INFO  - 2014-03-28T16:53:02.886Z] GhostDriver - Main - running on port 46548
-[INFO  - 2014-03-28T16:53:02.909Z] Session [6d2b69a0-b699-11e3-9a0c-fba94821bfd4] - page.settings - {"XSSAuditingEnabled":false,"javascriptCanCloseWindows":true,"javascriptCanOpenWindows":true,"javascriptEnabled":true,"loadImages":true,"localToRemoteUrlAccessEnabled":false,"userAgent":"Mozilla/5.0 (Unknown; Linux x86_64) AppleWebKit/534.34 (KHTML, like Gecko) PhantomJS/1.9.7 Safari/534.34","webSecurityEnabled":true}
-[INFO  - 2014-03-28T16:53:02.909Z] Session [6d2b69a0-b699-11e3-9a0c-fba94821bfd4] - page.customHeaders:  - {}
-[INFO  - 2014-03-28T16:53:02.909Z] Session [6d2b69a0-b699-11e3-9a0c-fba94821bfd4] - Session.negotiatedCapabilities - {"browserName":"phantomjs","version":"1.9.7","driverName":"ghostdriver","driverVersion":"1.1.0","platform":"linux-unknown-64bit","javascriptEnabled":true,"takesScreenshot":true,"handlesAlerts":false,"databaseEnabled":false,"locationContextEnabled":false,"applicationCacheEnabled":false,"browserConnectionEnabled":false,"cssSelectorsEnabled":true,"webStorageEnabled":false,"rotatable":false,"acceptSslCerts":false,"nativeEvents":true,"proxy":{"proxyType":"direct"}}
-[INFO  - 2014-03-28T16:53:02.909Z] SessionManagerReqHand - _postNewSessionCommand - New Session Created: 6d2b69a0-b699-11e3-9a0c-fba94821bfd4
diff --git a/proxy.js b/proxy.js
index 0341346..ba478f2 100644
--- a/proxy.js
+++ b/proxy.js
@@ -1,28 +1,30 @@
-// Copyright 2013 Selenium committers
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Defines functions for configuring a webdriver proxy:
- * <pre><code>
- * var webdriver = require('selenium-webdriver'),
- *     proxy = require('selenium-webdriver/proxy');
  *
- * var driver = new webdriver.Builder()
- *     .withCapabilities(webdriver.Capabilities.chrome())
- *     .setProxy(proxy.manual({http: 'host:1234'}))
- *     .build();
- * </code></pre>
+ *     var webdriver = require('selenium-webdriver'),
+ *         proxy = require('selenium-webdriver/proxy');
+ *
+ *     var driver = new webdriver.Builder()
+ *         .withCapabilities(webdriver.Capabilities.chrome())
+ *         .setProxy(proxy.manual({http: 'host:1234'}))
+ *         .build();
  */
 
 'use strict';
@@ -30,28 +32,13 @@
 var util = require('util');
 
 
-/**
- * Proxy configuration object, as defined by the WebDriver wire protocol.
- * @typedef {(
- *     {proxyType: string}|
- *     {proxyType: string,
- *      proxyAutoconfigUrl: string}|
- *     {proxyType: string,
- *      ftpProxy: string,
- *      httpProxy: string,
- *      sslProxy: string,
- *      noProxy: string})}
- */
-var ProxyConfig;
-
-
 
 // PUBLIC API
 
 
 /**
  * Configures WebDriver to bypass all browser proxies.
- * @return {!ProxyConfig} A new proxy configuration object.
+ * @return {!webdriver.ProxyConfig} A new proxy configuration object.
  */
 exports.direct = function() {
   return {proxyType: 'direct'};
@@ -61,14 +48,13 @@ exports.direct = function() {
 /**
  * Manually configures the browser proxy.  The following options are
  * supported:
- * <ul>
- * <li>{@code ftp}: Proxy host to use for FTP requests
- * <li>{@code http}: Proxy host to use for HTTP requests
- * <li>{@code https}: Proxy host to use for HTTPS requests
- * <li>{@code bypass}: A list of hosts requests should directly connect to,
+ *
+ * - `ftp`: Proxy host to use for FTP requests
+ * - `http`: Proxy host to use for HTTP requests
+ * - `https`: Proxy host to use for HTTPS requests
+ * - `bypass`: A list of hosts requests should directly connect to,
  *     bypassing any other proxies for that request. May be specified as a
  *     comma separated string, or a list of strings.
- * </ul>
  *
  * Behavior is undefined for FTP, HTTP, and HTTPS requests if the
  * corresponding key is omitted from the configuration options.
@@ -78,7 +64,7 @@ exports.direct = function() {
  *          https: (string|undefined),
  *          bypass: (string|!Array.<string>|undefined)}} options Proxy
  *     configuration options.
- * @return {!ProxyConfig} A new proxy configuration object.
+ * @return {!webdriver.ProxyConfig} A new proxy configuration object.
  */
 exports.manual = function(options) {
   return {
@@ -96,7 +82,7 @@ exports.manual = function(options) {
  * Configures WebDriver to configure the browser proxy using the PAC file at
  * the given URL.
  * @param {string} url URL for the PAC proxy to use.
- * @return {!ProxyConfig} A new proxy configuration object.
+ * @return {!webdriver.ProxyConfig} A new proxy configuration object.
  */
 exports.pac = function(url) {
   return {
@@ -108,7 +94,7 @@ exports.pac = function(url) {
 
 /**
  * Configures WebDriver to use the current system's proxy.
- * @return {!ProxyConfig} A new proxy configuration object.
+ * @return {!webdriver.ProxyConfig} A new proxy configuration object.
  */
 exports.system = function() {
   return {proxyType: 'system'};
diff --git a/remote/index.js b/remote/index.js
index 8c45f8e..3ac756b 100644
--- a/remote/index.js
+++ b/remote/index.js
@@ -1,27 +1,34 @@
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
-var spawn = require('child_process').spawn,
-    os = require('os'),
+var AdmZip = require('adm-zip'),
+    AdmConstants = require('adm-zip/util/constants'),
+    fs = require('fs'),
     path = require('path'),
     url = require('url'),
     util = require('util');
 
-var promise = require('../').promise,
+var _base = require('../_base'),
+    webdriver = require('../'),
+    promise = require('../').promise,
     httpUtil = require('../http/util'),
+    exec = require('../io/exec'),
     net = require('../net'),
     portprober = require('../net/portprober');
 
@@ -29,23 +36,23 @@ var promise = require('../').promise,
 
 /**
  * Configuration options for a DriverService instance.
- * <ul>
- * <li>{@code port} - The port to start the server on (must be > 0). If the
- *     port is provided as a promise, the service will wait for the promise to
- *     resolve before starting.
- * <li>{@code args} - The arguments to pass to the service. If a promise is
- *     provided, the service will wait for it to resolve before starting.
- * <li>{@code path} - The base path on the server for the WebDriver wire
- *     protocol (e.g. '/wd/hub'). Defaults to '/'.
- * <li>{@code env} - The environment variables that should be visible to the
- *     server process. Defaults to inheriting the current process's
- *     environment.
- * <li>{@code stdio} - IO configuration for the spawned server process. For
- *     more information, refer to the documentation of
- *     {@code child_process.spawn}.
- * </ul>
+ *
+ * - `loopback` - Whether the service should only be accessed on this host's
+ *     loopback address.
+ * - `port` - The port to start the server on (must be > 0). If the port is
+ *     provided as a promise, the service will wait for the promise to resolve
+ *     before starting.
+ * - `args` - The arguments to pass to the service. If a promise is provided,
+ *     the service will wait for it to resolve before starting.
+ * - `path` - The base path on the server for the WebDriver wire protocol
+ *     (e.g. '/wd/hub'). Defaults to '/'.
+ * - `env` - The environment variables that should be visible to the server
+ *     process. Defaults to inheriting the current process's environment.
+ * - `stdio` - IO configuration for the spawned server process. For more
+ *     information, refer to the documentation of `child_process.spawn`.
  *
  * @typedef {{
+ *   loopback: (boolean|undefined),
  *   port: (number|!webdriver.promise.Promise.<number>),
  *   args: !(Array.<string>|webdriver.promise.Promise.<!Array.<string>>),
  *   path: (string|undefined),
@@ -59,10 +66,10 @@ var ServiceOptions;
 /**
  * Manages the life and death of a native executable WebDriver server.
  *
- * <p>It is expected that the driver server implements the
- * <a href="http://code.google.com/p/selenium/wiki/JsonWireProtocol">WebDriver
- * Wire Protocol</a>. Furthermore, the managed server should support multiple
- * concurrent sessions, so that this class may be reused for multiple clients.
+ * It is expected that the driver server implements the
+ * https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol.
+ * Furthermore, the managed server should support multiple concurrent sessions,
+ * so that this class may be reused for multiple clients.
  *
  * @param {string} executable Path to the executable to run.
  * @param {!ServiceOptions} options Configuration options for the service.
@@ -73,6 +80,9 @@ function DriverService(executable, options) {
   /** @private {string} */
   this.executable_ = executable;
 
+  /** @private {boolean} */
+  this.loopbackOnly_ = !!options.loopback;
+
   /** @private {(number|!webdriver.promise.Promise.<number>)} */
   this.port_ = options.port;
 
@@ -89,6 +99,21 @@ function DriverService(executable, options) {
 
   /** @private {(string|!Array.<string|number|!Stream|null|undefined>)} */
   this.stdio_ = options.stdio || 'ignore';
+
+  /**
+   * A promise for the managed subprocess, or null if the server has not been
+   * started yet. This promise will never be rejected.
+   * @private {promise.Promise.<!exec.Command>}
+   */
+  this.command_ = null;
+
+  /**
+   * Promise that resolves to the server's address or null if the server has
+   * not been started. This promise will be rejected if the server terminates
+   * before it starts accepting WebDriver requests.
+   * @private {promise.Promise.<string>}
+   */
+  this.address_ = null;
 }
 
 
@@ -100,26 +125,6 @@ function DriverService(executable, options) {
 DriverService.DEFAULT_START_TIMEOUT_MS = 30 * 1000;
 
 
-/** @private {child_process.ChildProcess} */
-DriverService.prototype.process_ = null;
-
-
-/**
- * Promise that resolves to the server's address or null if the server has not
- * been started.
- * @private {webdriver.promise.Promise.<string>}
- */
-DriverService.prototype.address_ = null;
-
-
-/**
- * Promise that tracks the status of shutting down the server, or null if the
- * server is not currently shutting down.
- * @private {webdriver.promise.Promise}
- */
-DriverService.prototype.shutdownHook_ = null;
-
-
 /**
  * @return {!webdriver.promise.Promise.<string>} A promise that resolves to
  *    the server's address.
@@ -134,6 +139,8 @@ DriverService.prototype.address = function() {
 
 
 /**
+ * Returns whether the underlying process is still running. This does not take
+ * into account whether the process is in the process of shutting down.
  * @return {boolean} Whether the underlying service process is running.
  */
 DriverService.prototype.isRunning = function() {
@@ -145,7 +152,7 @@ DriverService.prototype.isRunning = function() {
  * Starts the server if it is not already running.
  * @param {number=} opt_timeoutMs How long to wait, in milliseconds, for the
  *     server to start accepting requests. Defaults to 30 seconds.
- * @return {!webdriver.promise.Promise.<string>} A promise that will resolve
+ * @return {!promise.Promise.<string>} A promise that will resolve
  *     to the server's base URL when it has started accepting requests. If the
  *     timeout expires before the server has started, the promise will be
  *     rejected.
@@ -158,56 +165,53 @@ DriverService.prototype.start = function(opt_timeoutMs) {
   var timeout = opt_timeoutMs || DriverService.DEFAULT_START_TIMEOUT_MS;
 
   var self = this;
+  this.command_ = promise.defer();
   this.address_ = promise.defer();
   this.address_.fulfill(promise.when(this.port_, function(port) {
     if (port <= 0) {
       throw Error('Port must be > 0: ' + port);
     }
     return promise.when(self.args_, function(args) {
-      self.process_ = spawn(self.executable_, args, {
+      var command = exec(self.executable_, {
+        args: args,
         env: self.env_,
         stdio: self.stdio_
-      }).once('exit', onServerExit);
+      });
+
+      self.command_.fulfill(command);
 
-      // This process should not wait on the spawned child, however, we do
-      // want to ensure the child is killed when this process exits.
-      self.process_.unref();
-      process.once('exit', killServer);
+      var earlyTermination = command.result().then(function(result) {
+        var error = result.code == null ?
+            Error('Server was killed with ' + result.signal) :
+            Error('Server terminated early with status ' + result.code);
+        self.address_.reject(error);
+        self.address_ = null;
+        self.command_ = null;
+        throw error;
+      });
 
       var serverUrl = url.format({
         protocol: 'http',
-        hostname: net.getAddress() || net.getLoopbackAddress(),
+        hostname: !self.loopbackOnly_ && net.getAddress() ||
+            net.getLoopbackAddress(),
         port: port,
         pathname: self.path_
       });
 
-      return httpUtil.waitForServer(serverUrl, timeout).then(function() {
+      return new promise.Promise(function(fulfill, reject) {
+        var ready = httpUtil.waitForServer(serverUrl, timeout)
+            .then(fulfill, reject);
+        earlyTermination.thenCatch(function(e) {
+          ready.cancel(e);
+          reject(Error(e.message));
+        });
+      }).then(function() {
         return serverUrl;
       });
     });
   }));
 
   return this.address_;
-
-  function onServerExit(code, signal) {
-    self.address_.reject(code == null ?
-        Error('Server was killed with ' + signal) :
-        Error('Server exited with ' + code));
-
-    if (self.shutdownHook_) {
-      self.shutdownHook_.fulfill();
-    }
-
-    self.shutdownHook_ = null;
-    self.address_ = null;
-    self.process_ = null;
-    process.removeListener('exit', killServer);
-  }
-
-  function killServer() {
-    process.removeListener('exit', killServer);
-    self.process_ && self.process_.kill('SIGTERM');
-  }
 };
 
 
@@ -219,26 +223,12 @@ DriverService.prototype.start = function(opt_timeoutMs) {
  *     the server has been stopped.
  */
 DriverService.prototype.kill = function() {
-  if (!this.address_) {
+  if (!this.address_ || !this.command_) {
     return promise.fulfilled();  // Not currently running.
   }
-
-  if (!this.shutdownHook_) {
-    // No process: still starting; wait on address.
-    // Otherwise, kill the process now. Exit handler will resolve the
-    // shutdown hook.
-    if (this.process_) {
-      this.shutdownHook_ = promise.defer();
-      this.process_.kill('SIGTERM');
-    } else {
-      var self = this;
-      this.shutdownHook_ = this.address_.thenFinally(function() {
-        self.process_ && self.process_.kill('SIGTERM');
-      });
-    }
-  }
-
-  return this.shutdownHook_;
+  return this.command_.then(function(command) {
+    command.kill('SIGTERM');
+  });
 };
 
 
@@ -255,18 +245,28 @@ DriverService.prototype.stop = function() {
 
 
 /**
- * Manages the life and death of the Selenium standalone server. The server
- * may be obtained from http://selenium-release.storage.googleapis.com/index.html.
+ * Manages the life and death of the
+ * <a href="http://selenium-release.storage.googleapis.com/index.html">
+ * standalone Selenium server</a>.
+ *
  * @param {string} jar Path to the Selenium server jar.
- * @param {!SeleniumServer.Options} options Configuration options for the
+ * @param {SeleniumServer.Options=} opt_options Configuration options for the
  *     server.
- * @throws {Error} If an invalid port is specified.
+ * @throws {Error} If the path to the Selenium jar is not specified or if an
+ *     invalid port is specified.
  * @constructor
  * @extends {DriverService}
  */
-function SeleniumServer(jar, options) {
-  if (options.port < 0)
+function SeleniumServer(jar, opt_options) {
+  if (!jar) {
+    throw Error('Path to the Selenium jar not specified');
+  }
+
+  var options = opt_options || {};
+
+  if (options.port < 0) {
     throw Error('Port must be >= 0: ' + options.port);
+  }
 
   var port = options.port || portprober.findFreePort();
   var args = promise.when(options.jvmArgs || [], function(jvmArgs) {
@@ -278,6 +278,7 @@ function SeleniumServer(jar, options) {
   });
 
   DriverService.call(this, 'java', {
+    loopback: options.loopback,
     port: port,
     args: args,
     path: '/wd/hub',
@@ -290,23 +291,23 @@ util.inherits(SeleniumServer, DriverService);
 
 /**
  * Options for the Selenium server:
- * <ul>
- * <li>{@code port} - The port to start the server on (must be > 0). If the
- *     port is provided as a promise, the service will wait for the promise to
- *     resolve before starting.
- * <li>{@code args} - The arguments to pass to the service. If a promise is
- *     provided, the service will wait for it to resolve before starting.
- * <li>{@code jvmArgs} - The arguments to pass to the JVM. If a promise is
- *     provided, the service will wait for it to resolve before starting.
- * <li>{@code env} - The environment variables that should be visible to the
- *     server process. Defaults to inheriting the current process's
- *     environment.
- * <li>{@code stdio} - IO configuration for the spawned server process. For
- *     more information, refer to the documentation of
- *     {@code child_process.spawn}.
- * </ul>
+ *
+ * - `loopback` - Whether the server should only be accessed on this host's
+ *     loopback address.
+ * - `port` - The port to start the server on (must be > 0). If the port is
+ *     provided as a promise, the service will wait for the promise to resolve
+ *     before starting.
+ * - `args` - The arguments to pass to the service. If a promise is provided,
+ *     the service will wait for it to resolve before starting.
+ * - `jvmArgs` - The arguments to pass to the JVM. If a promise is provided,
+ *     the service will wait for it to resolve before starting.
+ * - `env` - The environment variables that should be visible to the server
+ *     process. Defaults to inheriting the current process's environment.
+ * - `stdio` - IO configuration for the spawned server process. For more
+ *     information, refer to the documentation of `child_process.spawn`.
  *
  * @typedef {{
+ *   loopback: (boolean|undefined),
  *   port: (number|!webdriver.promise.Promise.<number>),
  *   args: !(Array.<string>|webdriver.promise.Promise.<!Array.<string>>),
  *   jvmArgs: (!Array.<string>|
@@ -319,7 +320,54 @@ util.inherits(SeleniumServer, DriverService);
 SeleniumServer.Options;
 
 
+
+/**
+ * A {@link webdriver.FileDetector} that may be used when running
+ * against a remote
+ * [Selenium server](http://selenium-release.storage.googleapis.com/index.html).
+ *
+ * When a file path on the local machine running this script is entered with
+ * {@link webdriver.WebElement#sendKeys WebElement#sendKeys}, this file detector
+ * will transfer the specified file to the Selenium server's host; the sendKeys
+ * command will be updated to use the transfered file's path.
+ *
+ * __Note:__ This class depends on a non-standard command supported on the
+ * Java Selenium server. The file detector will fail if used with a server that
+ * only supports standard WebDriver commands (such as the ChromeDriver).
+ *
+ * @constructor
+ * @extends {webdriver.FileDetector}
+ * @final
+ */
+var FileDetector = function() {};
+util.inherits(webdriver.FileDetector, FileDetector);
+
+
+/** @override */
+FileDetector.prototype.handleFile = function(driver, filePath) {
+  return promise.checkedNodeCall(fs.stat, filePath).then(function(stats) {
+    if (stats.isDirectory()) {
+      throw TypeError('Uploading directories is not supported: ' + filePath);
+    }
+
+    var zip = new AdmZip();
+    zip.addLocalFile(filePath);
+    zip.getEntries()[0].header.method = AdmConstants.STORED;
+
+    var command = new webdriver.Command(webdriver.CommandName.UPLOAD_FILE)
+        .setParameter('file', zip.toBuffer().toString('base64'));
+    return driver.schedule(command,
+        'remote.FileDetector.handleFile(' + filePath + ')');
+  }, function(err) {
+    if (err.code === 'ENOENT') {
+      return filePath;  // Not a file; return original input.
+    }
+    throw err;
+  });
+};
+
 // PUBLIC API
 
 exports.DriverService = DriverService;
+exports.FileDetector = FileDetector;
 exports.SeleniumServer = SeleniumServer;
diff --git a/safari.js b/safari.js
new file mode 100644
index 0000000..d6780df
--- /dev/null
+++ b/safari.js
@@ -0,0 +1,538 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+/**
+ * @fileoverview Defines a WebDriver client for Safari. Before using this
+ * module, you must install the
+ * [latest version](http://selenium-release.storage.googleapis.com/index.html)
+ * of the SafariDriver browser extension; using Safari for normal browsing is
+ * not recommended once the extension has been installed. You can, and should,
+ * disable the extension when the browser is not being used with WebDriver.
+ */
+
+'use strict';
+
+var events = require('events');
+var fs = require('fs');
+var http = require('http');
+var path = require('path');
+var url = require('url');
+var util = require('util');
+var ws = require('ws');
+
+var webdriver = require('./');
+var promise = webdriver.promise;
+var _base = require('./_base');
+var io = require('./io');
+var exec = require('./io/exec');
+var portprober = require('./net/portprober');
+
+
+/** @const */
+var CLIENT_PATH = _base.isDevMode()
+    ? path.join(__dirname,
+        '../../../build/javascript/safari-driver/client.js')
+    : path.join(__dirname, 'lib/safari/client.js');
+
+
+/** @const */
+var LIBRARY_DIR = process.platform === 'darwin'
+    ? path.join('/Users', process.env['USER'], 'Library/Safari')
+    : path.join(process.env['APPDATA'], 'Apple Computer', 'Safari');
+
+
+/** @const */
+var SESSION_DATA_FILES = (function() {
+  if (process.platform === 'darwin') {
+    var libraryDir = path.join('/Users', process.env['USER'], 'Library');
+    return [
+      path.join(libraryDir, 'Caches/com.apple.Safari/Cache.db'),
+      path.join(libraryDir, 'Cookies/Cookies.binarycookies'),
+      path.join(libraryDir, 'Cookies/Cookies.plist'),
+      path.join(libraryDir, 'Safari/History.plist'),
+      path.join(libraryDir, 'Safari/LastSession.plist'),
+      path.join(libraryDir, 'Safari/LocalStorage'),
+      path.join(libraryDir, 'Safari/Databases')
+    ];
+  } else if (process.platform === 'win32') {
+    var appDataDir = path.join(process.env['APPDATA'],
+        'Apple Computer', 'Safari');
+    var localDataDir = path.join(process.env['LOCALAPPDATA'],
+        'Apple Computer', 'Safari');
+    return [
+      path.join(appDataDir, 'History.plist'),
+      path.join(appDataDir, 'LastSession.plist'),
+      path.join(appDataDir, 'Cookies/Cookies.plist'),
+      path.join(appDataDir, 'Cookies/Cookies.binarycookies'),
+      path.join(localDataDir, 'Cache.db'),
+      path.join(localDataDir, 'Databases'),
+      path.join(localDataDir, 'LocalStorage')
+    ];
+  } else {
+    return [];
+  }
+})();
+
+
+/** @typedef {{port: number, address: string, family: string}} */
+var Host;
+
+
+/**
+ * A basic HTTP/WebSocket server used to communicate with the SafariDriver
+ * browser extension.
+ * @constructor
+ * @extends {events.EventEmitter}
+ */
+var Server = function() {
+  events.EventEmitter.call(this);
+
+  var server = http.createServer(function(req, res) {
+    if (req.url === '/favicon.ico') {
+      res.writeHead(204);
+      res.end();
+      return;
+    }
+
+    var query = url.parse(req.url).query || '';
+    if (query.indexOf('url=') == -1) {
+      var address = server.address()
+      var host = address.address + ':' + address.port;
+      res.writeHead(302, {'Location': 'http://' + host + '?url=ws://' + host});
+      res.end();
+    }
+
+    fs.readFile(CLIENT_PATH, 'utf8', function(err, data) {
+      if (err) {
+        res.writeHead(500, {'Content-Type': 'text/plain'});
+        res.end(err.stack);
+        return;
+      }
+      var content = '<!DOCTYPE html><body><script>' + data + '</script>';
+      res.writeHead(200, {
+        'Content-Type': 'text/html; charset=utf-8',
+        'Content-Length': Buffer.byteLength(content, 'utf8'),
+      });
+      res.end(content);
+    });
+  });
+
+  var wss = new ws.Server({server: server});
+  wss.on('connection', this.emit.bind(this, 'connection'));
+
+  /**
+   * Starts the server on a random port.
+   * @return {!webdriver.promise.Promise<Host>} A promise that will resolve
+   *     with the server host when it has fully started.
+   */
+  this.start = function() {
+    if (server.address()) {
+      return promise.fulfilled(server.address());
+    }
+    return portprober.findFreePort('localhost').then(function(port) {
+      return promise.checkedNodeCall(
+          server.listen.bind(server, port, 'localhost'));
+    }).then(function() {
+      return server.address();
+    });
+  };
+
+  /**
+   * Stops the server.
+   * @return {!webdriver.promise.Promise} A promise that will resolve when the
+   *     server has closed all connections.
+   */
+  this.stop = function() {
+    return new promise.Promise(function(fulfill) {
+      server.close(fulfill);
+    });
+  };
+
+  /**
+   * @return {Host} This server's host info.
+   * @throws {Error} If the server is not running.
+   */
+  this.address = function() {
+    var addr = server.address();
+    if (!addr) {
+      throw Error('There server is not running!');
+    }
+    return addr;
+  };
+};
+util.inherits(Server, events.EventEmitter);
+
+
+/**
+ * @return {!promise.Promise<string>} A promise that will resolve with the path
+ *     to Safari on the current system.
+ */
+function findSafariExecutable() {
+  switch (process.platform) {
+    case 'darwin':
+      return promise.fulfilled(
+          '/Applications/Safari.app/Contents/MacOS/Safari');
+
+    case 'win32':
+      var files = [
+        process.env['PROGRAMFILES'] || '\\Program Files',
+        process.env['PROGRAMFILES(X86)'] || '\\Program Files (x86)'
+      ].map(function(prefix) {
+        return path.join(prefix, 'Safari\\Safari.exe');
+      });
+      return io.exists(files[0]).then(function(exists) {
+        return exists ? files[0] : io.exists(files[1]).then(function(exists) {
+          if (exists) {
+            return files[1];
+          }
+          throw Error('Unable to find Safari on the current system');
+        });
+      });
+
+    default:
+      return promise.rejected(
+          Error('Safari is not supported on the current platform: ' +
+              process.platform));
+  }
+}
+
+
+/**
+ * @param {string} url The URL to connect to.
+ * @return {!promise.Promise<string>} A promise for the path to a file that
+ *     Safari can open on start-up to trigger a new connection to the WebSocket
+ *     server.
+ */
+function createConnectFile(url) {
+  return io.tmpFile({postfix: '.html'}).then(function(f) {
+    var writeFile =  promise.checkedNodeCall(fs.writeFile,
+        f,
+        '<!DOCTYPE html><script>window.location = "' + url + '";</script>',
+        {encoding: 'utf8'});
+    return writeFile.then(function() {
+      return f;
+    });
+  });
+}
+
+
+/**
+ * Deletes all session data files if so desired.
+ * @param {!Object} desiredCapabilities .
+ * @return {!Array<promise.Promise>} A list of promises for the deleted files.
+ */
+function cleanSession(desiredCapabilities) {
+  if (!desiredCapabilities) {
+    return [];
+  }
+  var options = desiredCapabilities[OPTIONS_CAPABILITY_KEY];
+  if (!options) {
+    return [];
+  }
+  if (!options['cleanSession']) {
+    return [];
+  }
+  return SESSION_DATA_FILES.map(function(file) {
+    return io.unlink(file);
+  });
+}
+
+
+/**
+ * @constructor
+ * @implements {webdriver.CommandExecutor}
+ */
+var CommandExecutor = function() {
+  /** @private {Server} */
+  this.server_ = null;
+
+  /** @private {ws.WebSocket} */
+  this.socket_ = null;
+
+  /** @private {promise.Promise.<!exec.Command>} */
+  this.safari_ = null;
+};
+
+
+/** @override */
+CommandExecutor.prototype.execute = function(command, callback) {
+  var safariCommand = JSON.stringify({
+    'origin': 'webdriver',
+    'type': 'command',
+    'command': {
+      'id': _base.require('goog.string').getRandomString(),
+      'name': command.getName(),
+      'parameters': command.getParameters()
+    }
+  });
+  var self = this;
+
+  switch (command.getName()) {
+    case webdriver.CommandName.NEW_SESSION:
+      this.startSafari_(command).then(sendCommand, callback);
+      break;
+
+    case webdriver.CommandName.QUIT:
+      this.destroySession_().then(function() {
+        callback(null, _base.require('bot.response').createResponse(null));
+      }, callback);
+      break;
+
+    default:
+      sendCommand();
+      break;
+  }
+
+  function sendCommand() {
+    new promise.Promise(function(fulfill, reject) {
+      // TODO: support reconnecting with the extension.
+      if (!self.socket_) {
+        self.destroySession_().thenFinally(function() {
+          reject(Error('The connection to the SafariDriver was closed'));
+        });
+        return;
+      }
+
+      self.socket_.send(safariCommand, function(err) {
+        if (err) {
+          reject(err);
+          return;
+        }
+      });
+
+      self.socket_.once('message', function(data) {
+        try {
+          data = JSON.parse(data);
+        } catch (ex) {
+          reject(Error('Failed to parse driver message: ' + data));
+          return;
+        }
+        fulfill(data['response']);
+      });
+
+    }).then(function(value) {
+      callback(null, value);
+    }, callback);
+  }
+};
+
+
+/**
+ * @param {!webdriver.Command} command .
+ * @private
+ */
+CommandExecutor.prototype.startSafari_ = function(command) {
+  this.server_ = new Server();
+
+  this.safari_ = this.server_.start().then(function(address) {
+    var tasks = cleanSession(command.getParameters()['desiredCapabilities']);
+    tasks.push(
+      findSafariExecutable(),
+      createConnectFile(
+          'http://' + address.address + ':' + address.port));
+    return promise.all(tasks).then(function(tasks) {
+      var exe = tasks[tasks.length - 2];
+      var html = tasks[tasks.length - 1];
+      return exec(exe, {args: [html]});
+    });
+  });
+
+  var connected = promise.defer();
+  var self = this;
+  var start = Date.now();
+  var timer = setTimeout(function() {
+    connected.reject(Error(
+      'Failed to connect to the SafariDriver after ' + (Date.now() - start) +
+      ' ms; Have you installed the latest extension from ' +
+      'http://selenium-release.storage.googleapis.com/index.html?'));
+  }, 10 * 1000);
+  this.server_.once('connection', function(socket) {
+    clearTimeout(timer);
+    self.socket_ = socket;
+    socket.once('close', function() {
+      self.socket_ = null;
+    });
+    connected.fulfill();
+  });
+  return connected.promise;
+};
+
+
+/**
+ * Destroys the active session by stopping the WebSocket server and killing the
+ * Safari subprocess.
+ * @private
+ */
+CommandExecutor.prototype.destroySession_ = function() {
+  var tasks = [];
+  if (this.server_) {
+    tasks.push(this.server_.stop());
+  }
+  if (this.safari_) {
+    tasks.push(this.safari_.then(function(safari) {
+      safari.kill();
+      return safari.result();
+    }));
+  }
+  var self = this;
+  return promise.all(tasks).thenFinally(function() {
+    self.server_ = null;
+    self.socket_ = null;
+    self.safari_ = null;
+  });
+};
+
+
+/** @const */
+var OPTIONS_CAPABILITY_KEY = 'safari.options';
+
+
+
+/**
+ * Configuration options specific to the {@link Driver SafariDriver}.
+ * @constructor
+ * @extends {webdriver.Serializable}
+ */
+var Options = function() {
+  webdriver.Serializable.call(this);
+
+  /** @private {Object<string, *>} */
+  this.options_ = null;
+
+  /** @private {webdriver.logging.Preferences} */
+  this.logPrefs_ = null;
+};
+util.inherits(Options, webdriver.Serializable);
+
+
+/**
+ * Extracts the SafariDriver specific options from the given capabilities
+ * object.
+ * @param {!webdriver.Capabilities} capabilities The capabilities object.
+ * @return {!Options} The ChromeDriver options.
+ */
+Options.fromCapabilities = function(capabilities) {
+  var options = new Options();
+
+  var o = capabilities.get(OPTIONS_CAPABILITY_KEY);
+  if (o instanceof Options) {
+    options = o;
+  } else if (o) {
+    options.setCleanSession(o.cleanSession);
+  }
+
+  if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {
+    options.setLoggingPrefs(
+        capabilities.get(webdriver.Capability.LOGGING_PREFS));
+  }
+
+  return options;
+};
+
+
+/**
+ * Sets whether to force Safari to start with a clean session. Enabling this
+ * option will cause all global browser data to be deleted.
+ * @param {boolean} clean Whether to make sure the session has no cookies,
+ *     cache entries, local storage, or databases.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setCleanSession = function(clean) {
+  if (!this.options_) {
+    this.options_ = {};
+  }
+  this.options_['cleanSession'] = clean;
+  return this;
+};
+
+
+/**
+ * Sets the logging preferences for the new session.
+ * @param {!webdriver.logging.Preferences} prefs The logging preferences.
+ * @return {!Options} A self reference.
+ */
+Options.prototype.setLoggingPrefs = function(prefs) {
+  this.logPrefs_ = prefs;
+  return this;
+};
+
+
+/**
+ * Converts this options instance to a {@link webdriver.Capabilities} object.
+ * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge
+ *     these options into, if any.
+ * @return {!webdriver.Capabilities} The capabilities.
+ */
+Options.prototype.toCapabilities = function(opt_capabilities) {
+  var capabilities = opt_capabilities || webdriver.Capabilities.safari();
+  if (this.logPrefs_) {
+    capabilities.set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_);
+  }
+  if (this.options_) {
+    capabilities.set(OPTIONS_CAPABILITY_KEY, this);
+  }
+  return capabilities;
+};
+
+
+/**
+ * Converts this instance to its JSON wire protocol representation. Note this
+ * function is an implementation detail not intended for general use.
+ * @return {!Object<string, *>} The JSON wire protocol representation of this
+ *     instance.
+ * @override
+ */
+Options.prototype.serialize = function() {
+  return this.options_ || {};
+};
+
+
+
+/**
+ * A WebDriver client for Safari. This class should never be instantiated
+ * directly; instead, use the {@link selenium-webdriver.Builder}:
+ *
+ *     var driver = new Builder()
+ *         .forBrowser('safari')
+ *         .build();
+ *
+ * @param {(Options|webdriver.Capabilities)=} opt_config The configuration
+ *     options for the new session.
+ * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to create
+ *     the driver under.
+ * @constructor
+ * @extends {webdriver.WebDriver}
+ */
+var Driver = function(opt_config, opt_flow) {
+  var executor = new CommandExecutor();
+  var capabilities =
+      opt_config instanceof Options ? opt_config.toCapabilities() :
+      (opt_config || webdriver.Capabilities.safari());
+
+  var driver = webdriver.WebDriver.createSession(
+      executor, capabilities, opt_flow);
+  webdriver.WebDriver.call(
+      this, driver.getSession(), executor, driver.controlFlow());
+};
+util.inherits(Driver, webdriver.WebDriver);
+
+
+// Public API
+
+
+exports.Driver = Driver;
+exports.Options = Options;
diff --git a/test/_base_test.js b/test/_base_test.js
new file mode 100644
index 0000000..8765153
--- /dev/null
+++ b/test/_base_test.js
@@ -0,0 +1,129 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+var assert = require('assert'),
+    fs = require('fs'),
+    path = require('path');
+
+var base = require('../_base');
+
+describe('Context', function() {
+  it('does not pollute the global scope', function() {
+    assert.equal('undefined', typeof goog);
+
+    var context = new base.Context();
+    assert.equal('undefined', typeof goog);
+    assert.equal('object', typeof context.closure.goog);
+
+    context.closure.goog.require('goog.array');
+    assert.equal('undefined', typeof goog);
+    assert.equal('object', typeof context.closure.goog.array);
+  });
+});
+
+
+function haveGenerators() {
+  try {
+    // Test for generator support.
+    new Function('function* x() {}');
+    return true;
+  } catch (ex) {
+    return false;
+  }
+}
+
+
+function runClosureTest(file) {
+  var name = path.basename(file);
+  name = name.substring(0, name.length - '.js'.length);
+
+  // Generator tests will fail to parse in ES5, so mark those tests as
+  // pending under ES5.
+  if (name.indexOf('_generator_') != -1 && !haveGenerators()) {
+    it(name);
+    return;
+  }
+
+  describe(name, function() {
+    var context = new base.Context(true);
+    context.closure.document.title = name;
+    if (process.env.VERBOSE == '1') {
+      context.closure.goog.require('webdriver.logging');
+      context.closure.goog.module.get('webdriver.logging')
+          .installConsoleHandler();
+    } else {
+      // Null out console so everything loads silently.
+      context.closure.console = null;
+    }
+    context.closure.CLOSURE_IMPORT_SCRIPT(file);
+
+    var tc = context.closure.G_testRunner.testCase;
+    if (!tc) {
+      tc = new context.closure.goog.testing.TestCase(name);
+      tc.autoDiscoverTests();
+    }
+
+    var shouldRunTests = tc.shouldRunTests();
+    var allTests = tc.getTests();
+    allTests.forEach(function(test) {
+      if (!shouldRunTests) {
+        it(test.name);
+        return;
+      }
+
+      it(test.name, function(done) {
+        tc.setTests([test]);
+        tc.setCompletedCallback(function() {
+          if (tc.isSuccess()) {
+            return done();
+          }
+          var results = tc.getTestResults();
+          done(Error('\n' + Object.keys(results).map(function(name) {
+            var msg =
+                [name + ': ' + (results[name].length ? 'FAILED' : 'PASSED')];
+            if (results[name].length) {
+              msg = msg.concat(results[name]);
+            }
+            return msg.join('\n');
+          }).join('\n')));
+        });
+        tc.runTests();
+      });
+    });
+  });
+}
+
+
+function findTests(dir) {
+  fs.readdirSync(dir).forEach(function(name) {
+    var file = path.join(dir, name);
+
+    var stat = fs.statSync(file);
+    if (stat.isDirectory() && name !== 'atoms' && name !== 'e2e') {
+      findTests(file);
+      return;
+    }
+
+    var l = file.length - '_test.js'.length;
+    if (l >= 0 && file.indexOf('_test.js', l) == l) {
+      runClosureTest(file);
+    }
+  });
+}
+
+findTests(path.join(
+    __dirname, base.isDevMode() ? '../../..' : '../lib', 'webdriver/test'));
diff --git a/test/actions_test.js b/test/actions_test.js
new file mode 100644
index 0000000..8d6794a
--- /dev/null
+++ b/test/actions_test.js
@@ -0,0 +1,53 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var Browser = require('..').Browser,
+    By = require('..').By,
+    until = require('..').until,
+    test = require('../lib/test'),
+    fileServer = require('../lib/test/fileserver');
+
+
+test.suite(function(env) {
+  var driver;
+  test.beforeEach(function() { driver = env.builder().build(); });
+  test.afterEach(function() { driver.quit(); });
+
+  test.ignore(env.browsers(Browser.PHANTOM_JS, Browser.SAFARI)).
+  describe('WebDriver.actions()', function() {
+
+    test.it('can move to and click element in an iframe', function() {
+      driver.get(fileServer.whereIs('click_tests/click_in_iframe.html'));
+
+      driver.wait(until.elementLocated(By.id('ifr')), 5000)
+          .then(function(frame) {
+            driver.switchTo().frame(frame);
+          });
+
+      var link = driver.findElement(By.id('link'));
+      driver.actions()
+          .mouseMove(link)
+          .click()
+          .perform();
+
+      driver.wait(until.titleIs('Submitted Successfully!'), 5000);
+    });
+
+  });
+});
diff --git a/test/chrome/options_test.js b/test/chrome/options_test.js
index 2398ddf..980f2a9 100644
--- a/test/chrome/options_test.js
+++ b/test/chrome/options_test.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -44,47 +46,51 @@ describe('chrome.Options', function() {
     });
 
     it('should rebuild options from wire representation', function() {
+      var expectedExtension = fs.readFileSync(__filename, 'base64');
       var caps = webdriver.Capabilities.chrome().set('chromeOptions', {
         args: ['a', 'b'],
-        extensions: [1, 2],
+        extensions: [__filename],
         binary: 'binaryPath',
-        logFile: 'logFilePath',
+        logPath: 'logFilePath',
         detach: true,
         localState: 'localStateValue',
         prefs: 'prefsValue'
       });
 
       var options = chrome.Options.fromCapabilities(caps);
-
-      assert(options.args_.length).equalTo(2);
-      assert(options.args_[0]).equalTo('a');
-      assert(options.args_[1]).equalTo('b');
-      assert(options.extensions_.length).equalTo(2);
-      assert(options.extensions_[0]).equalTo(1);
-      assert(options.extensions_[1]).equalTo(2);
-      assert(options.binary_).equalTo('binaryPath');
-      assert(options.logFile_).equalTo('logFilePath');
-      assert(options.detach_).equalTo(true);
-      assert(options.localState_).equalTo('localStateValue');
-      assert(options.prefs_).equalTo('prefsValue');
+      var json = options.serialize();
+
+      assert(json.args.length).equalTo(2);
+      assert(json.args[0]).equalTo('a');
+      assert(json.args[1]).equalTo('b');
+      assert(json.extensions.length).equalTo(1);
+      assert(json.extensions[0]).equalTo(expectedExtension);
+      assert(json.binary).equalTo('binaryPath');
+      assert(json.logPath).equalTo('logFilePath');
+      assert(json.detach).equalTo(true);
+      assert(json.localState).equalTo('localStateValue');
+      assert(json.prefs).equalTo('prefsValue');
     });
 
     it('should rebuild options from incomplete wire representation',
         function() {
           var caps = webdriver.Capabilities.chrome().set('chromeOptions', {
-            logFile: 'logFilePath'
+            logPath: 'logFilePath'
           });
 
           var options = chrome.Options.fromCapabilities(caps);
-          var json = options.toJSON();
-
-          assert(json.args.length).equalTo(0);
+          var json = options.serialize();
+          assert(json.args).isUndefined();
           assert(json.binary).isUndefined();
-          assert(json.detach).isFalse();
-          assert(json.extensions.length).equalTo(0);
+          assert(json.detach).isUndefined();
+          assert(json.excludeSwitches).isUndefined();
+          assert(json.extensions).isUndefined();
           assert(json.localState).isUndefined();
-          assert(json.logFile).equalTo('logFilePath');
+          assert(json.logPath).equalTo('logFilePath');
           assert(json.prefs).isUndefined();
+          assert(json.minidumpPath).isUndefined();
+          assert(json.mobileEmulation).isUndefined();
+          assert(json.perfLoggingPrefs).isUndefined();
         });
 
     it('should extract supported WebDriver capabilities', function() {
@@ -103,26 +109,28 @@ describe('chrome.Options', function() {
   describe('addArguments', function() {
     it('takes var_args', function() {
       var options = new chrome.Options();
-      assert(options.args_.length).equalTo(0);
+      assert(options.serialize().args).isUndefined();
 
       options.addArguments('a', 'b');
-      assert(options.args_.length).equalTo(2);
-      assert(options.args_[0]).equalTo('a');
-      assert(options.args_[1]).equalTo('b');
+      var json = options.serialize();
+      assert(json.args.length).equalTo(2);
+      assert(json.args[0]).equalTo('a');
+      assert(json.args[1]).equalTo('b');
     });
 
     it('flattens input arrays', function() {
       var options = new chrome.Options();
-      assert(options.args_.length).equalTo(0);
+      assert(options.serialize().args).isUndefined();
 
       options.addArguments(['a', 'b'], 'c', [1, 2], 3);
-      assert(options.args_.length).equalTo(6);
-      assert(options.args_[0]).equalTo('a');
-      assert(options.args_[1]).equalTo('b');
-      assert(options.args_[2]).equalTo('c');
-      assert(options.args_[3]).equalTo(1);
-      assert(options.args_[4]).equalTo(2);
-      assert(options.args_[5]).equalTo(3);
+      var json = options.serialize();
+      assert(json.args.length).equalTo(6);
+      assert(json.args[0]).equalTo('a');
+      assert(json.args[1]).equalTo('b');
+      assert(json.args[2]).equalTo('c');
+      assert(json.args[3]).equalTo(1);
+      assert(json.args[4]).equalTo(2);
+      assert(json.args[5]).equalTo(3);
     });
   });
 
@@ -152,10 +160,10 @@ describe('chrome.Options', function() {
     });
   });
 
-  describe('toJSON', function() {
+  describe('serialize', function() {
     it('base64 encodes extensions', function() {
       var expected = fs.readFileSync(__filename, 'base64');
-      var wire = new chrome.Options().addExtensions(__filename).toJSON();
+      var wire = new chrome.Options().addExtensions(__filename).serialize();
       assert(wire.extensions.length).equalTo(1);
       assert(wire.extensions[0]).equalTo(expected);
     });
@@ -181,7 +189,7 @@ describe('chrome.Options', function() {
       var proxyPrefs = {};
       var loggingPrefs = {};
       var options = new chrome.Options().
-          setLoggingPreferences(loggingPrefs).
+          setLoggingPrefs(loggingPrefs).
           setProxy(proxyPrefs);
 
       var caps = options.toCapabilities();
@@ -192,14 +200,18 @@ describe('chrome.Options', function() {
 });
 
 test.suite(function(env) {
-  env.autoCreateDriver = false;
+  var driver;
+
+  test.afterEach(function() {
+    driver.quit();
+  });
 
-  describe('options', function() {
+  describe('Chrome options', function() {
     test.it('can start Chrome with custom args', function() {
       var options = new chrome.Options().
           addArguments('user-agent=foo;bar');
 
-      var driver = env.builder().
+      driver = env.builder().
           setChromeOptions(options).
           build();
 
diff --git a/test/chrome/service_test.js b/test/chrome/service_test.js
new file mode 100644
index 0000000..0e0209e
--- /dev/null
+++ b/test/chrome/service_test.js
@@ -0,0 +1,45 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var webdriver = require('../..'),
+    chrome = require('../../chrome'),
+    assert = require('../../testing/assert');
+
+var test = require('../../lib/test');
+
+
+test.suite(function(env) {
+  describe('chromedriver', function() {
+    var service;
+    test.afterEach(function() {
+      if (service) {
+        return service.kill();
+      }
+    });
+
+    test.it('can be started on a custom path', function() {
+      service = new chrome.ServiceBuilder()
+          .setUrlBasePath('/foo/bar/baz')
+          .build();
+      return service.start().then(function(url) {
+        assert(url).endsWith('/foo/bar/baz');
+      });
+    });
+  });
+}, {browsers: ['chrome']});
\ No newline at end of file
diff --git a/test/cookie_test.js b/test/cookie_test.js
index 700e424..fe4c839 100644
--- a/test/cookie_test.js
+++ b/test/cookie_test.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -20,13 +22,20 @@ var assert = require('assert'),
 
 var test = require('../lib/test'),
     fileserver = require('../lib/test/fileserver'),
-    Browser = test.Browser,
+    Browser = require('..').Browser,
     Pages = test.Pages;
 
 
 test.suite(function(env) {
   var driver;
-  beforeEach(function() { driver = env.driver; });
+
+  test.before(function() {
+    driver = env.builder().build();
+  });
+
+  test.after(function() {
+    driver.quit();
+  });
 
   test.ignore(env.browsers(Browser.SAFARI)).  // Cookie handling is broken.
   describe('Cookie Management;', function() {
@@ -56,7 +65,7 @@ test.suite(function(env) {
       assertHasCookies(cookie1, cookie2);
     });
 
-    test.ignore(env.browsers(Browser.OPERA)).
+    test.ignore(env.browsers(Browser.IE)).
     it('only returns cookies visible to the current page', function() {
       var cookie1 = createCookieSpec();
       var cookie2 = createCookieSpec();
@@ -141,8 +150,7 @@ test.suite(function(env) {
       assertHasCookies();
     });
 
-    test.ignore(env.browsers(
-        Browser.ANDROID, Browser.FIREFOX, Browser.IE, Browser.OPERA)).
+    test.ignore(env.browsers(Browser.ANDROID, Browser.FIREFOX, Browser.IE)).
     it('should retain cookie expiry', function() {
       var cookie = createCookieSpec();
       var expirationDelay = 5 * 1000;
diff --git a/test/element_finding_test.js b/test/element_finding_test.js
index d1e95f9..02fc8c8 100644
--- a/test/element_finding_test.js
+++ b/test/element_finding_test.js
@@ -1,36 +1,45 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
 var fail = require('assert').fail;
 
-var By = require('..').By,
+var Browser = require('..').Browser,
+    By = require('..').By,
     error = require('..').error,
+    until = require('..').until,
     test = require('../lib/test'),
     assert = require('../testing/assert'),
-    Browser = test.Browser,
     Pages = test.Pages;
 
 
 test.suite(function(env) {
-  var browsers = env.browsers,
-      waitForTitleToBe = env.waitForTitleToBe;
+  var browsers = env.browsers;
 
   var driver;
-  beforeEach(function() { driver = env.driver; });
+
+  test.before(function() {
+    driver = env.builder().build();
+  });
+
+  test.after(function() {
+    driver.quit();
+  });
 
   describe('finding elements', function() {
 
@@ -40,14 +49,14 @@ test.suite(function(env) {
           driver.get(Pages.formPage);
           driver.get(Pages.xhtmlTestPage);
           driver.findElement(By.linkText('click me')).click();
-          waitForTitleToBe('We Arrive Here');
+          driver.wait(until.titleIs('We Arrive Here'), 5000);
         });
 
     describe('By.id()', function() {
       test.it('should work', function() {
         driver.get(Pages.xhtmlTestPage);
         driver.findElement(By.id('linkId')).click();
-        waitForTitleToBe('We Arrive Here');
+        driver.wait(until.titleIs('We Arrive Here'), 5000);
       });
 
       test.it('should fail if ID not present on page', function() {
@@ -58,9 +67,9 @@ test.suite(function(env) {
             });
       });
 
-      test.ignore(browsers(Browser.ANDROID)).it(
-          'should find multiple elements by ID even though that ' +
-              'is malformed HTML',
+      test.it(
+          'should find multiple elements by ID even though that is ' +
+              'malformed HTML',
           function() {
             driver.get(Pages.nestedPage);
             driver.findElements(By.id('2')).then(function(elements) {
@@ -73,14 +82,14 @@ test.suite(function(env) {
       test.it('should be able to click on link identified by text', function() {
         driver.get(Pages.xhtmlTestPage);
         driver.findElement(By.linkText('click me')).click();
-        waitForTitleToBe('We Arrive Here');
+        driver.wait(until.titleIs('We Arrive Here'), 5000);
       });
 
       test.it(
         'should be able to find elements by partial link text', function() {
           driver.get(Pages.xhtmlTestPage);
           driver.findElement(By.partialLinkText('ick me')).click();
-          waitForTitleToBe('We Arrive Here');
+          driver.wait(until.titleIs('We Arrive Here'), 5000);
         });
 
       test.it('should work when link text contains equals sign', function() {
@@ -143,8 +152,7 @@ test.suite(function(env) {
                 });
           });
 
-      test.ignore(browsers(Browser.OPERA)).
-      it('works on XHTML pages', function() {
+      test.it('works on XHTML pages', function() {
         driver.get(test.whereIs('actualXhtmlPage.xhtml'));
 
         var el = driver.findElement(By.linkText('Foo'));
diff --git a/test/execute_script_test.js b/test/execute_script_test.js
new file mode 100644
index 0000000..caf8ddc
--- /dev/null
+++ b/test/execute_script_test.js
@@ -0,0 +1,322 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var path = require('path');
+
+var webdriver = require('..'),
+    Browser = webdriver.Browser,
+    By = webdriver.By,
+    assert = require('../testing/assert'),
+    test = require('../lib/test');
+
+
+test.suite(function(env) {
+  var driver;
+
+  test.before(function() {
+    driver = env.builder().build();
+  });
+
+  test.after(function() {
+    driver.quit();
+  });
+
+  test.beforeEach(function() {
+    driver.get(test.Pages.echoPage);
+  });
+
+  describe('executeScript;', function() {
+    var shouldHaveFailed = new Error('Should have failed');
+
+    test.it('fails if script throws', function() {
+      execute('throw new Error("boom")')
+          .then(function() { throw shoudlHaveFailed; })
+          .thenCatch(function(e) {
+            // The java WebDriver server adds a bunch of crap to error messages.
+            // Error message will just be "JavaScript error" for IE.
+            assert(e.message).matches(/.*(JavaScript error|boom).*/);
+          });
+    });
+
+    test.it('fails if script does not parse', function() {
+      execute('throw function\\*')
+          .then(function() { throw shoudlHaveFailed; })
+          .thenCatch(function(e) {
+            assert(e).not.equalTo(shouldHaveFailed);
+          });
+    });
+
+    describe('scripts;', function() {
+      test.it('do not pollute the global scope', function() {
+        execute('var x = 1;');
+        assert(execute('return typeof x;')).equalTo('undefined');
+      });
+
+      test.it('can set global variables', function() {
+        execute('window.x = 1234;');
+        assert(execute('return x;')).equalTo(1234);
+      });
+
+      test.it('may be defined as a function expression', function() {
+        assert(execute(function() {
+          return 1234 + 'abc';
+        })).equalTo('1234abc');
+      });
+    });
+
+    describe('return values;', function() {
+
+      test.it('returns undefined as null', function() {
+        assert(execute('var x; return x;')).isNull();
+      });
+
+      test.it('can return null', function() {
+        assert(execute('return null;')).isNull();
+      });
+
+      test.it('can return numbers', function() {
+        assert(execute('return 1234')).equalTo(1234);
+        assert(execute('return 3.1456')).equalTo(3.1456);
+      });
+
+      test.it('can return strings', function() {
+        assert(execute('return "hello"')).equalTo('hello');
+      });
+
+      test.it('can return booleans', function() {
+        assert(execute('return true')).equalTo(true);
+        assert(execute('return false')).equalTo(false);
+      });
+
+      test.it('can return an array of primitives', function() {
+        execute('var x; return [1, false, null, 3.14, x]')
+            .then(verifyJson([1, false, null, 3.14, null]));
+      });
+
+      test.it('can return nested arrays', function() {
+        execute('return [[1, 2, [3]]]')
+            .then(verifyJson([[1, 2, [3]]]));
+      });
+
+      test.ignore(env.browsers(Browser.IE, Browser.SAFARI)).
+      it('can return empty object literal', function() {
+        execute('return {}').then(verifyJson({}));
+      });
+
+      test.it('can return object literals', function() {
+        execute('return {a: 1, b: false, c: null}').then(function(result) {
+          verifyJson(['a', 'b', 'c'])(Object.keys(result).sort());
+          assert(result.a).equalTo(1);
+          assert(result.b).equalTo(false);
+          assert(result.c).isNull();
+        });
+      });
+
+      test.it('can return complex object literals', function() {
+        execute('return {a:{b: "hello"}}').then(verifyJson({a:{b: 'hello'}}));
+      });
+
+      test.it('can return dom elements as web elements', function() {
+        execute('return document.querySelector(".header.host")')
+            .then(function(result) {
+              assert(result).instanceOf(webdriver.WebElement);
+              assert(result.getText()).startsWith('host: ');
+            });
+      });
+
+      test.it('can return array of dom elements', function() {
+        execute('var nodes = document.querySelectorAll(".request,.host");' +
+                'return [nodes[0], nodes[1]];')
+            .then(function(result) {
+              assert(result.length).equalTo(2);
+
+              assert(result[0]).instanceOf(webdriver.WebElement);
+              assert(result[0].getText()).startsWith('GET ');
+
+              assert(result[1]).instanceOf(webdriver.WebElement);
+              assert(result[1].getText()).startsWith('host: ');
+            });
+      });
+
+      test.it('can return a NodeList as an array of web elements', function() {
+        execute('return document.querySelectorAll(".request,.host");')
+            .then(function(result) {
+              assert(result.length).equalTo(2);
+
+              assert(result[0]).instanceOf(webdriver.WebElement);
+              assert(result[0].getText()).startsWith('GET ');
+
+              assert(result[1]).instanceOf(webdriver.WebElement);
+              assert(result[1].getText()).startsWith('host: ');
+            });
+      });
+
+      test.it('can return object literal with element property', function() {
+        execute('return {a: document.body}').then(function(result) {
+          assert(result.a).instanceOf(webdriver.WebElement);
+          assert(result.a.getTagName()).equalTo('body');
+        });
+      });
+    });
+
+    describe('parameters;', function() {
+      test.it('can pass numeric arguments', function() {
+        assert(execute('return arguments[0]', 12)).equalTo(12);
+        assert(execute('return arguments[0]', 3.14)).equalTo(3.14);
+      });
+
+      test.it('can pass boolean arguments', function() {
+        assert(execute('return arguments[0]', true)).equalTo(true);
+        assert(execute('return arguments[0]', false)).equalTo(false);
+      });
+
+      test.it('can pass string arguments', function() {
+        assert(execute('return arguments[0]', 'hi')).equalTo('hi');
+      });
+
+      test.it('can pass null arguments', function() {
+        assert(execute('return arguments[0] === null', null)).equalTo(true);
+        assert(execute('return arguments[0]', null)).equalTo(null);
+      });
+
+      test.it('passes undefined as a null argument', function() {
+        var x;
+        assert(execute('return arguments[0] === null', x)).equalTo(true);
+        assert(execute('return arguments[0]', x)).equalTo(null);
+      });
+
+      test.it('can pass multiple arguments', function() {
+        assert(execute('return arguments.length')).equalTo(0);
+        assert(execute('return arguments.length', 1, 'a', false)).equalTo(3);
+      });
+
+      test.it('can return arguments object as array', function() {
+        execute('return arguments', 1, 'a', false).then(function(val) {
+          assert(val.length).equalTo(3);
+          assert(val[0]).equalTo(1);
+          assert(val[1]).equalTo('a');
+          assert(val[2]).equalTo(false);
+        });
+      });
+
+      test.it('can pass object literal', function() {
+        execute(
+            'return [typeof arguments[0], arguments[0].a]', {a: 'hello'})
+            .then(function(result) {
+              assert(result[0]).equalTo('object');
+              assert(result[1]).equalTo('hello');
+            });
+      });
+
+      test.it('WebElement arguments are passed as DOM elements', function() {
+        var el = driver.findElement(By.tagName('div'));
+        assert(execute('return arguments[0].tagName.toLowerCase();', el))
+            .equalTo('div');
+      });
+
+      test.it('can pass array containing object literals', function() {
+        execute('return arguments[0]', [{color: "red"}]).then(function(result) {
+          assert(result.length).equalTo(1);
+          assert(result[0].color).equalTo('red');
+        });
+      });
+
+      test.it('does not modify object literal parameters', function() {
+        var input = {color: 'red'};
+        execute('return arguments[0];', input).then(verifyJson(input));
+      });
+    });
+
+    // See https://code.google.com/p/selenium/issues/detail?id=8223.
+    describe('issue 8223;', function() {
+      describe('using for..in loops;', function() {
+        test.it('can return array built from for-loop index', function() {
+          execute(function() {
+            var ret = [];
+            for (var i = 0; i < 3; i++) {
+              ret.push(i);
+            }
+            return ret;
+          }).then(verifyJson[0, 1, 2]);
+        });
+
+        test.it('can copy input array contents', function() {
+          execute(function(input) {
+            var ret = [];
+            for (var i in input) {
+              ret.push(input[i]);
+            }
+            return ret;
+          }, ['fa', 'fe', 'fi']).then(verifyJson(['fa', 'fe', 'fi']));
+        });
+
+        test.it('can iterate over input object keys', function() {
+          execute(function(thing) {
+            var ret = [];
+            for (var w in thing.words) {
+              ret.push(thing.words[w].word);
+            }
+            return ret;
+          }, {words: [{word: 'fa'}, {word: 'fe'}, {word: 'fi'}]})
+          .then(verifyJson(['fa', 'fe', 'fi']));
+        });
+
+        describe('recursive functions;', function() {
+          test.it('can build array from input', function() {
+            var input = ['fa', 'fe', 'fi'];
+            execute(function(thearray) {
+              var ret = [];
+              function build_response(thearray, ret) {
+                ret.push(thearray.shift());
+                return (!thearray.length && ret
+                    || build_response(thearray, ret));
+              }
+              return build_response(thearray, ret);
+            }, input).then(verifyJson(input));
+          });
+
+          test.it('can build array from elements in object', function() {
+            var input = {words: [{word: 'fa'}, {word: 'fe'}, {word: 'fi'}]};
+            execute(function(thing) {
+              var ret = [];
+              function build_response(thing, ret) {
+                var item = thing.words.shift();
+                ret.push(item.word);
+                return (!thing.words.length && ret
+                    || build_response(thing, ret));
+              }
+              return build_response(thing, ret);
+            }, input).then(verifyJson(['fa', 'fe', 'fi']));
+          });
+        });
+      });
+    });
+
+  });
+
+  function verifyJson(expected) {
+    return function(actual) {
+      assert(JSON.stringify(actual)).equalTo(JSON.stringify(expected));
+    };
+  }
+
+  function execute() {
+    return driver.executeScript.apply(driver, arguments);
+  }
+});
diff --git a/test/fingerprint_test.js b/test/fingerprint_test.js
new file mode 100644
index 0000000..5a64494
--- /dev/null
+++ b/test/fingerprint_test.js
@@ -0,0 +1,57 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var assert = require('../testing/assert'),
+    test = require('../lib/test'),
+    Pages = test.Pages;
+
+
+test.suite(function(env) {
+  var browsers = env.browsers;
+
+  var driver;
+  test.before(function() {
+    driver = env.builder().build();
+  });
+
+  test.after(function() {
+    driver.quit();
+  });
+
+  describe('fingerprinting', function() {
+    test.it('it should fingerprint the navigator object', function() {
+      driver.get(Pages.simpleTestPage);
+      assert(driver.executeScript('return navigator.webdriver')).equalTo(true);
+    });
+
+    test.it('fingerprint must not be writable', function() {
+      driver.get(Pages.simpleTestPage);
+      assert(driver.executeScript(
+          'navigator.webdriver = "ohai"; return navigator.webdriver'))
+          .equalTo(true);
+    });
+
+    test.it('leaves fingerprint on svg pages', function() {
+      driver.get(Pages.svgPage);
+      assert(driver.executeScript('return navigator.webdriver')).equalTo(true);
+    });
+  });
+
+// Currently only implemented in firefox.
+}, {browsers: ['firefox']});
diff --git a/test/firefox/extension_test.js b/test/firefox/extension_test.js
new file mode 100644
index 0000000..50936f7
--- /dev/null
+++ b/test/firefox/extension_test.js
@@ -0,0 +1,96 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var AdmZip = require('adm-zip'),
+    assert = require('assert'),
+    crypto = require('crypto'),
+    fs = require('fs'),
+    path = require('path');
+
+var extension = require('../../firefox/extension'),
+    io = require('../../io'),
+    it = require('../../testing').it;
+
+
+var JETPACK_EXTENSION = path.join(__dirname,
+    '../../lib/test/data/firefox/jetpack-sample.xpi');
+var NORMAL_EXTENSION = path.join(__dirname,
+    '../../lib/test/data/firefox/sample.xpi');
+
+var JETPACK_EXTENSION_ID = 'jid1-EaXX7k0wwiZR7w@jetpack';
+var NORMAL_EXTENSION_ID = 'sample@seleniumhq.org';
+
+
+describe('extension', function() {
+  it('can install a jetpack xpi file', function() {
+    return io.tmpDir().then(function(dir) {
+      return extension.install(JETPACK_EXTENSION, dir).then(function(id) {
+        assert.equal(JETPACK_EXTENSION_ID, id);
+        var file = path.join(dir, id + '.xpi');
+        assert.ok(fs.existsSync(file), 'no such file: ' + file);
+        assert.ok(!fs.statSync(file).isDirectory());
+
+        var copiedSha1 = crypto.createHash('sha1')
+            .update(fs.readFileSync(file))
+            .digest('hex');
+
+        var goldenSha1 = crypto.createHash('sha1')
+            .update(fs.readFileSync(JETPACK_EXTENSION))
+            .digest('hex');
+
+        assert.equal(copiedSha1, goldenSha1);
+      });
+    });
+  });
+
+  it('can install a normal xpi file', function() {
+    return io.tmpDir().then(function(dir) {
+      return extension.install(NORMAL_EXTENSION, dir).then(function(id) {
+        assert.equal(NORMAL_EXTENSION_ID, id);
+
+        var file = path.join(dir, NORMAL_EXTENSION_ID);
+        assert.ok(fs.statSync(file).isDirectory());
+
+        assert.ok(fs.existsSync(path.join(file, 'chrome.manifest')));
+        assert.ok(fs.existsSync(path.join(file, 'content/overlay.xul')));
+        assert.ok(fs.existsSync(path.join(file, 'content/overlay.js')));
+        assert.ok(fs.existsSync(path.join(file, 'install.rdf')));
+      });
+    });
+  });
+
+  it('can install an extension from a directory', function() {
+    return io.tmpDir().then(function(srcDir) {
+      var buf = fs.readFileSync(NORMAL_EXTENSION);
+      new AdmZip(buf).extractAllTo(srcDir, true);
+      return io.tmpDir().then(function(dstDir) {
+        return extension.install(srcDir, dstDir).then(function(id) {
+          assert.equal(NORMAL_EXTENSION_ID, id);
+
+          var dir = path.join(dstDir, NORMAL_EXTENSION_ID);
+
+          assert.ok(fs.existsSync(path.join(dir, 'chrome.manifest')));
+          assert.ok(fs.existsSync(path.join(dir, 'content/overlay.xul')));
+          assert.ok(fs.existsSync(path.join(dir, 'content/overlay.js')));
+          assert.ok(fs.existsSync(path.join(dir, 'install.rdf')));
+        });
+      });
+    });
+  });
+});
diff --git a/test/firefox/firefox_test.js b/test/firefox/firefox_test.js
new file mode 100644
index 0000000..0a32940
--- /dev/null
+++ b/test/firefox/firefox_test.js
@@ -0,0 +1,183 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var path = require('path');
+
+var firefox = require('../../firefox'),
+    io = require('../../io'),
+    test = require('../../lib/test'),
+    assert = require('../../testing/assert');
+
+
+var JETPACK_EXTENSION = path.join(__dirname,
+    '../../lib/test/data/firefox/jetpack-sample.xpi');
+var NORMAL_EXTENSION = path.join(__dirname,
+    '../../lib/test/data/firefox/sample.xpi');
+
+
+test.suite(function(env) {
+  describe('firefox', function() {
+    describe('Options', function() {
+      var driver;
+
+      test.beforeEach(function() {
+        driver = null;
+      });
+
+      test.afterEach(function() {
+        if (driver) {
+          driver.quit();
+        }
+      });
+
+      test.it('can start Firefox with custom preferences', function() {
+        var profile = new firefox.Profile();
+        profile.setPreference('general.useragent.override', 'foo;bar');
+
+        var options = new firefox.Options().setProfile(profile);
+
+        driver = env.builder().
+            setFirefoxOptions(options).
+            build();
+
+        driver.get('data:text/html,<html><div>content</div></html>');
+
+        var userAgent = driver.executeScript(
+            'return window.navigator.userAgent');
+        assert(userAgent).equalTo('foo;bar');
+      });
+
+      test.it('can start Firefox with a jetpack extension', function() {
+        var profile = new firefox.Profile();
+        profile.addExtension(JETPACK_EXTENSION);
+
+        var options = new firefox.Options().setProfile(profile);
+
+        driver = env.builder().
+            setFirefoxOptions(options).
+            build();
+
+        loadJetpackPage(driver,
+            'data:text/html;charset=UTF-8,<html><div>content</div></html>');
+        assert(driver.findElement({id: 'jetpack-sample-banner'}).getText())
+            .equalTo('Hello, world!');
+      });
+
+      test.it('can start Firefox with a normal extension', function() {
+        var profile = new firefox.Profile();
+        profile.addExtension(NORMAL_EXTENSION);
+
+        var options = new firefox.Options().setProfile(profile);
+
+        driver = env.builder().
+            setFirefoxOptions(options).
+            build();
+
+        driver.get('data:text/html,<html><div>content</div></html>');
+        assert(driver.findElement({id: 'sample-extension-footer'}).getText())
+            .equalTo('Goodbye');
+      });
+
+      test.it('can start Firefox with multiple extensions', function() {
+        var profile = new firefox.Profile();
+        profile.addExtension(JETPACK_EXTENSION);
+        profile.addExtension(NORMAL_EXTENSION);
+
+        var options = new firefox.Options().setProfile(profile);
+
+        driver = env.builder().
+            setFirefoxOptions(options).
+            build();
+
+        loadJetpackPage(driver,
+            'data:text/html;charset=UTF-8,<html><div>content</div></html>');
+        assert(driver.findElement({id: 'jetpack-sample-banner'}).getText())
+            .equalTo('Hello, world!');
+        assert(driver.findElement({id: 'sample-extension-footer'}).getText())
+            .equalTo('Goodbye');
+      });
+
+      function loadJetpackPage(driver, url) {
+        // On linux the jetpack extension does not always run the first time
+        // we load a page. If this happens, just reload the page (a simple
+        // refresh doesn't appear to work).
+        driver.wait(function() {
+          driver.get(url);
+          return driver.isElementPresent({id: 'jetpack-sample-banner'});
+        }, 3000);
+      }
+    });
+
+    describe('profile management', function() {
+      var driver;
+
+      test.beforeEach(function() {
+        driver = null;
+      });
+
+      test.afterEach(function() {
+        if (driver) {
+          driver.quit();
+        }
+      });
+
+      test.ignore(env.isRemote).
+      it('deletes the temp profile on quit', function() {
+        driver = env.builder().build();
+
+        var profilePath = driver.call(function() {
+          var path = driver.profilePath_;
+          assert(io.exists(path)).isTrue();
+          return path;
+        });
+
+        return driver.quit().then(function() {
+          driver = null;
+          return profilePath;
+        }).then(function(path) {
+          assert(io.exists(path)).isFalse();
+        });
+      });
+    });
+
+    describe('binary management', function() {
+      var driver1, driver2;
+
+      test.ignore(env.isRemote).
+      it('can start multiple sessions with single binary instance', function() {
+        var options = new firefox.Options().setBinary(new firefox.Binary);
+        env.builder().setFirefoxOptions(options);
+        driver1 = env.builder().build();
+        driver2 = env.builder().build();
+        // Ok if this doesn't fail.
+      });
+
+      test.afterEach(function() {
+        if (driver1) {
+          driver1.quit();
+        }
+
+        if (driver2) {
+          driver2.quit();
+        }
+      });
+    });
+
+  });
+}, {browsers: ['firefox']});
diff --git a/test/firefox/profile_test.js b/test/firefox/profile_test.js
new file mode 100644
index 0000000..feaa42f
--- /dev/null
+++ b/test/firefox/profile_test.js
@@ -0,0 +1,187 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var AdmZip = require('adm-zip'),
+    assert = require('assert'),
+    fs = require('fs'),
+    path = require('path');
+
+var promise = require('../..').promise,
+    Profile = require('../../firefox/profile').Profile,
+    decode = require('../../firefox/profile').decode,
+    loadUserPrefs = require('../../firefox/profile').loadUserPrefs,
+    io = require('../../io'),
+    it = require('../../testing').it;
+
+
+var JETPACK_EXTENSION = path.join(__dirname,
+    '../../lib/test/data/firefox/jetpack-sample.xpi');
+var NORMAL_EXTENSION = path.join(__dirname,
+    '../../lib/test/data/firefox/sample.xpi');
+
+var JETPACK_EXTENSION_ID = 'jid1-EaXX7k0wwiZR7w@jetpack.xpi';
+var NORMAL_EXTENSION_ID = 'sample@seleniumhq.org';
+var WEBDRIVER_EXTENSION_ID = 'fxdriver@googlecode.com';
+
+
+
+describe('Profile', function() {
+  describe('setPreference', function() {
+    it('allows setting custom properties', function() {
+      var profile = new Profile();
+      assert.equal(undefined, profile.getPreference('foo'));
+
+      profile.setPreference('foo', 'bar');
+      assert.equal('bar', profile.getPreference('foo'));
+    });
+
+    it('allows overriding mutable properties', function() {
+      var profile = new Profile();
+      assert.equal('about:blank', profile.getPreference('browser.newtab.url'));
+
+      profile.setPreference('browser.newtab.url', 'http://www.example.com');
+      assert.equal('http://www.example.com',
+          profile.getPreference('browser.newtab.url'));
+    });
+
+    it('throws if setting a frozen preference', function() {
+      var profile = new Profile();
+      assert.throws(function() {
+        profile.setPreference('app.update.auto', true);
+      });
+    });
+  });
+
+  describe('writeToDisk', function() {
+    it('copies template directory recursively', function() {
+      var templateDir;
+      return io.tmpDir().then(function(td) {
+        templateDir = td;
+        var foo = path.join(templateDir, 'foo');
+        fs.writeFileSync(foo, 'Hello, world');
+
+        var bar = path.join(templateDir, 'subfolder/bar');
+        fs.mkdirSync(path.dirname(bar));
+        fs.writeFileSync(bar, 'Goodbye, world!');
+
+        return new Profile(templateDir).writeToDisk();
+      }).then(function(profileDir) {
+        assert.notEqual(profileDir, templateDir);
+
+        assert.equal('Hello, world',
+            fs.readFileSync(path.join(profileDir, 'foo')));
+        assert.equal('Goodbye, world!',
+            fs.readFileSync(path.join(profileDir, 'subfolder/bar')));
+      });
+    });
+
+    it('does not copy lock files', function() {
+      return io.tmpDir().then(function(dir) {
+        fs.writeFileSync(path.join(dir, 'parent.lock'), 'lock');
+        fs.writeFileSync(path.join(dir, 'lock'), 'lock');
+        fs.writeFileSync(path.join(dir, '.parentlock'), 'lock');
+        return new Profile(dir).writeToDisk();
+      }).then(function(dir) {
+        assert.ok(fs.existsSync(dir));
+        assert.ok(!fs.existsSync(path.join(dir, 'parent.lock')));
+        assert.ok(!fs.existsSync(path.join(dir, 'lock')));
+        assert.ok(!fs.existsSync(path.join(dir, '.parentlock')));
+      });
+    });
+
+    describe('user.js', function() {
+
+      it('writes defaults', function() {
+        return new Profile().writeToDisk().then(function(dir) {
+          return loadUserPrefs(path.join(dir, 'user.js'));
+        }).then(function(prefs) {
+          // Just check a few.
+          assert.equal(false, prefs['app.update.auto']);
+          assert.equal(true, prefs['browser.EULA.override']);
+          assert.equal(false, prefs['extensions.update.enabled']);
+          assert.equal('about:blank', prefs['browser.newtab.url']);
+          assert.equal(30, prefs['dom.max_script_run_time']);
+        });
+      });
+
+      it('merges template user.js into preferences', function() {
+        return io.tmpDir().then(function(dir) {
+          fs.writeFileSync(path.join(dir, 'user.js'), [
+            'user_pref("browser.newtab.url", "http://www.example.com")',
+            'user_pref("dom.max_script_run_time", 1234)'
+          ].join('\n'));
+
+          return new Profile(dir).writeToDisk();
+        }).then(function(profile) {
+          return loadUserPrefs(path.join(profile, 'user.js'));
+        }).then(function(prefs) {
+          assert.equal('http://www.example.com', prefs['browser.newtab.url']);
+          assert.equal(1234, prefs['dom.max_script_run_time']);
+        });
+      });
+
+      it('ignores frozen preferences when merging template user.js',
+        function() {
+          return io.tmpDir().then(function(dir) {
+            fs.writeFileSync(path.join(dir, 'user.js'),
+                'user_pref("app.update.auto", true)');
+            return new Profile(dir).writeToDisk();
+          }).then(function(profile) {
+            return loadUserPrefs(path.join(profile, 'user.js'));
+          }).then(function(prefs) {
+            assert.equal(false, prefs['app.update.auto']);
+          });
+        });
+    });
+
+    describe('extensions', function() {
+      it('are copied into new profile directory', function() {
+        var profile = new Profile();
+        profile.addExtension(JETPACK_EXTENSION);
+        profile.addExtension(NORMAL_EXTENSION);
+
+        return profile.writeToDisk().then(function(dir) {
+          dir = path.join(dir, 'extensions');
+          assert.ok(fs.existsSync(path.join(dir, JETPACK_EXTENSION_ID)));
+          assert.ok(fs.existsSync(path.join(dir, NORMAL_EXTENSION_ID)));
+          assert.ok(fs.existsSync(path.join(dir, WEBDRIVER_EXTENSION_ID)));
+        });
+      });
+    });
+  });
+
+  describe('encode', function() {
+    it('excludes the bundled WebDriver extension', function() {
+      return new Profile().encode().then(function(data) {
+        return decode(data);
+      }).then(function(dir) {
+        assert.ok(fs.existsSync(path.join(dir, 'user.js')));
+        assert.ok(fs.existsSync(path.join(dir, 'extensions')));
+        return loadUserPrefs(path.join(dir, 'user.js'));
+      }).then(function(prefs) {
+        // Just check a few.
+        assert.equal(false, prefs['app.update.auto']);
+        assert.equal(true, prefs['browser.EULA.override']);
+        assert.equal(false, prefs['extensions.update.enabled']);
+        assert.equal('about:blank', prefs['browser.newtab.url']);
+        assert.equal(30, prefs['dom.max_script_run_time']);
+      });
+    });
+  });
+});
diff --git a/test/http/http_test.js b/test/http/http_test.js
new file mode 100644
index 0000000..6298967
--- /dev/null
+++ b/test/http/http_test.js
@@ -0,0 +1,181 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+var assert = require('assert');
+var http = require('http');
+var url = require('url');
+
+var HttpClient = require('../../http').HttpClient;
+var HttpRequest = require('../../_base').require('webdriver.http.Request');
+var Server = require('../../lib/test/httpserver').Server;
+var promise = require('../..').promise;
+var test = require('../../lib/test');
+
+describe('HttpClient', function() {
+  this.timeout(4 * 1000);
+
+  var server = new Server(function(req, res) {
+    if (req.method == 'GET' && req.url == '/echo') {
+      res.writeHead(200, req.headers);
+      res.end();
+
+    } else if (req.method == 'GET' && req.url == '/redirect') {
+      res.writeHead(303, {'Location': server.url('/hello')});
+      res.end();
+
+    } else if (req.method == 'GET' && req.url == '/hello') {
+      res.writeHead(200, {'content-type': 'text/plain'});
+      res.end('hello, world!');
+
+    } else if (req.method == 'GET' && req.url == '/badredirect') {
+      res.writeHead(303, {});
+      res.end();
+
+    } else if (req.method == 'GET' && req.url == '/protected') {
+      var denyAccess = function() {
+        res.writeHead(401, {'WWW-Authenticate': 'Basic realm="test"'});
+        res.end('Access denied');
+      };
+
+      var basicAuthRegExp = /^\s*basic\s+([a-z0-9\-\._~\+\/]+)=*\s*$/i
+      var auth = req.headers.authorization;
+      var match = basicAuthRegExp.exec(auth || '');
+      if (!match) {
+        denyAccess();
+        return;
+      }
+
+      var userNameAndPass = new Buffer(match[1], 'base64').toString();
+      var parts = userNameAndPass.split(':', 2);
+      if (parts[0] !== 'genie' && parts[1] !== 'bottle') {
+        denyAccess();
+        return;
+      }
+
+      res.writeHead(200, {'content-type': 'text/plain'});
+      res.end('Access granted!');
+
+    } else if (req.method == 'GET' && req.url == '/proxy') {
+      res.writeHead(200, req.headers);
+      res.end();
+
+    } else if (req.method == 'GET' && req.url == '/proxy/redirect') {
+      res.writeHead(303, {'Location': '/proxy'});
+      res.end();
+
+    } else {
+      res.writeHead(404, {});
+      res.end();
+    }
+  });
+
+  test.before(function() {
+    return server.start();
+  });
+
+  test.after(function() {
+    return server.stop();
+  });
+
+  test.it('can send a basic HTTP request', function() {
+    var request = new HttpRequest('GET', '/echo');
+    request.headers['Foo'] = 'Bar';
+
+    var agent = new http.Agent();
+    agent.maxSockets = 1;  // Only making 1 request.
+
+    var client = new HttpClient(server.url(), agent);
+    return promise.checkedNodeCall(client.send.bind(client, request))
+        .then(function(response) {
+          assert.equal(200, response.status);
+          assert.equal(
+            'application/json; charset=utf-8', response.headers['accept']);
+          assert.equal('Bar', response.headers['foo']);
+          assert.equal('0', response.headers['content-length']);
+          assert.equal('keep-alive', response.headers['connection']);
+          assert.equal(server.host(), response.headers['host']);
+        });
+  });
+
+  test.it('can use basic auth', function() {
+    var parsed = url.parse(server.url());
+    parsed.auth = 'genie:bottle';
+
+    var client = new HttpClient(url.format(parsed));
+    var request = new HttpRequest('GET', '/protected');
+    return promise.checkedNodeCall(client.send.bind(client, request))
+      .then(function(response) {
+        assert.equal(200, response.status);
+        assert.equal('text/plain', response.headers['content-type']);
+        assert.equal('Access granted!', response.body);
+      });
+  });
+
+  test.it('fails requests missing required basic auth', function() {
+    var client = new HttpClient(server.url());
+    var request = new HttpRequest('GET', '/protected');
+    return promise.checkedNodeCall(client.send.bind(client, request))
+      .then(function(response) {
+              assert.equal(401, response.status);
+              assert.equal('Access denied', response.body);
+            });
+  });
+
+  test.it('automatically follows redirects', function() {
+    var request = new HttpRequest('GET', '/redirect');
+    var client = new HttpClient(server.url());
+    return promise.checkedNodeCall(client.send.bind(client, request))
+        .then(function(response) {
+          assert.equal(200, response.status);
+          assert.equal('text/plain', response.headers['content-type']);
+          assert.equal('hello, world!', response.body);
+        });
+  });
+
+  test.it('handles malformed redirect responses', function() {
+    var request = new HttpRequest('GET', '/badredirect');
+    var client = new HttpClient(server.url());
+    return promise.checkedNodeCall(client.send.bind(client, request))
+        .thenCatch(function(err) {
+          assert.ok(/Failed to parse "Location"/.test(err.message),
+              'Not the expected error: ' + err.message);
+        });
+  });
+
+  test.it('proxies requests through the webdriver proxy', function() {
+    var request = new HttpRequest('GET', '/proxy');
+    var client = new HttpClient(
+        'http://another.server.com', undefined, server.url());
+    return promise.checkedNodeCall(client.send.bind(client, request))
+        .then(function(response) {
+           assert.equal(200, response.status);
+           assert.equal('another.server.com', response.headers['host']);
+        });
+  });
+
+  test.it(
+      'proxies requests through the webdriver proxy on redirect', function() {
+    var request = new HttpRequest('GET', '/proxy/redirect');
+    var client = new HttpClient(
+        'http://another.server.com', undefined, server.url());
+    return promise.checkedNodeCall(client.send.bind(client, request))
+        .then(function(response) {
+          assert.equal(200, response.status);
+          assert.equal('another.server.com', response.headers['host']);
+        });
+  });
+});
diff --git a/test/http/util_test.js b/test/http/util_test.js
index 37835b4..4876297 100644
--- a/test/http/util_test.js
+++ b/test/http/util_test.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -125,12 +127,12 @@ describe('selenium-webdriver/http/util', function() {
       var isReady =  util.waitForServer(baseUrl, 200).
           then(function() { done('Did not expect to succeed'); }).
           then(null, function(e) {
-            assert.equal(err, e);
+            assert.equal('cancelled!', e.message);
           }).
           then(function() { done(); }, done);
 
       setTimeout(function() {
-        isReady.cancel(err);
+        isReady.cancel('cancelled!');
       }, 50);
     });
   });
@@ -165,16 +167,15 @@ describe('selenium-webdriver/http/util', function() {
 
     it('can cancel wait', function(done) {
       responseCode = 404;
-      var err = Error('cancelled!');
       var isReady =  util.waitForUrl(baseUrl, 200).
           then(function() { done('Did not expect to succeed'); }).
           then(null, function(e) {
-            assert.equal(err, e);
+            assert.equal('cancelled!', e.message);
           }).
           then(function() { done(); }, done);
 
       setTimeout(function() {
-        isReady.cancel(err);
+        isReady.cancel('cancelled!');
       }, 50);
     });
   });
diff --git a/test/io_test.js b/test/io_test.js
new file mode 100644
index 0000000..2fe4475
--- /dev/null
+++ b/test/io_test.js
@@ -0,0 +1,227 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var assert = require('assert'),
+    fs = require('fs'),
+    path = require('path'),
+    tmp = require('tmp');
+
+var io = require('../io'),
+    before = require('../testing').before,
+    beforeEach = require('../testing').beforeEach,
+    it = require('../testing').it;
+
+
+describe('io', function() {
+  describe('copy', function() {
+    var tmpDir;
+
+    before(function() {
+      return io.tmpDir().then(function(d) {
+        tmpDir = d;
+
+        fs.writeFileSync(path.join(d, 'foo'), 'Hello, world');
+        fs.symlinkSync(path.join(d, 'foo'), path.join(d, 'symlinked-foo'));
+      });
+    });
+
+    it('can copy one file to another', function() {
+      return io.tmpFile().then(function(f) {
+        return io.copy(path.join(tmpDir, 'foo'), f).then(function(p) {
+          assert.equal(p, f);
+          assert.equal('Hello, world', fs.readFileSync(p));
+        });
+      });
+    });
+
+    it('can copy symlink to destination', function() {
+      return io.tmpFile().then(function(f) {
+        return io.copy(path.join(tmpDir, 'symlinked-foo'), f).then(function(p) {
+          assert.equal(p, f);
+          assert.equal('Hello, world', fs.readFileSync(p));
+        });
+      });
+    });
+
+    it('fails if given a directory as a source', function() {
+      return io.tmpFile().then(function(f) {
+        return io.copy(tmpDir, f);
+      }).then(function() {
+        throw Error('Should have failed with a type error');
+      }, function() {
+        // Do nothing; expected.
+      });
+    });
+  });
+
+  describe('copyDir', function() {
+    it('copies recursively', function() {
+      return io.tmpDir().then(function(dir) {
+        fs.writeFileSync(path.join(dir, 'file1'), 'hello');
+        fs.mkdirSync(path.join(dir, 'sub'));
+        fs.mkdirSync(path.join(dir, 'sub/folder'));
+        fs.writeFileSync(path.join(dir, 'sub/folder/file2'), 'goodbye');
+
+        return io.tmpDir().then(function(dst) {
+          return io.copyDir(dir, dst).then(function(ret) {
+            assert.equal(dst, ret);
+
+            assert.equal('hello',
+              fs.readFileSync(path.join(dst, 'file1')));
+            assert.equal('goodbye',
+              fs.readFileSync(path.join(dst, 'sub/folder/file2')));
+          });
+        });
+      });
+    });
+
+    it('creates destination dir if necessary', function() {
+      return io.tmpDir().then(function(srcDir) {
+        fs.writeFileSync(path.join(srcDir, 'foo'), 'hi');
+        return io.tmpDir().then(function(dstDir) {
+          return io.copyDir(srcDir, path.join(dstDir, 'sub'));
+        });
+      }).then(function(p) {
+        assert.equal('sub', path.basename(p));
+        assert.equal('hi', fs.readFileSync(path.join(p, 'foo')));
+      });
+    });
+
+    it('supports regex exclusion filter', function() {
+      return io.tmpDir().then(function(src) {
+        fs.writeFileSync(path.join(src, 'foo'), 'a');
+        fs.writeFileSync(path.join(src, 'bar'), 'b');
+        fs.writeFileSync(path.join(src, 'baz'), 'c');
+        fs.mkdirSync(path.join(src, 'sub'));
+        fs.writeFileSync(path.join(src, 'sub/quux'), 'd');
+        fs.writeFileSync(path.join(src, 'sub/quot'), 'e');
+
+        return io.tmpDir().then(function(dst) {
+          return io.copyDir(src, dst, /(bar|quux)/);
+        });
+      }).then(function(dir) {
+        assert.equal('a', fs.readFileSync(path.join(dir, 'foo')));
+        assert.equal('c', fs.readFileSync(path.join(dir, 'baz')));
+        assert.equal('e', fs.readFileSync(path.join(dir, 'sub/quot')));
+
+        assert.ok(!fs.existsSync(path.join(dir, 'bar')));
+        assert.ok(!fs.existsSync(path.join(dir, 'sub/quux')));
+      });
+    });
+
+    it('supports exclusion filter function', function() {
+      return io.tmpDir().then(function(src) {
+        fs.writeFileSync(path.join(src, 'foo'), 'a');
+        fs.writeFileSync(path.join(src, 'bar'), 'b');
+        fs.writeFileSync(path.join(src, 'baz'), 'c');
+        fs.mkdirSync(path.join(src, 'sub'));
+        fs.writeFileSync(path.join(src, 'sub/quux'), 'd');
+        fs.writeFileSync(path.join(src, 'sub/quot'), 'e');
+
+        return io.tmpDir().then(function(dst) {
+          return io.copyDir(src, dst, function(f) {
+            return f !== path.join(src, 'foo')
+                && f !== path.join(src, 'sub/quot');
+          });
+        });
+      }).then(function(dir) {
+        assert.equal('b', fs.readFileSync(path.join(dir, 'bar')));
+        assert.equal('c', fs.readFileSync(path.join(dir, 'baz')));
+        assert.equal('d', fs.readFileSync(path.join(dir, 'sub/quux')));
+
+        assert.ok(!fs.existsSync(path.join(dir, 'foo')));
+        assert.ok(!fs.existsSync(path.join(dir, 'sub/quot')));
+      });
+    });
+  });
+
+  describe('exists', function() {
+    var dir;
+
+    before(function() {
+      return io.tmpDir().then(function(d) {
+        dir = d;
+      });
+    });
+
+    it('works for directories', function() {
+      return io.exists(dir).then(assert.ok);
+    });
+
+    it('works for files', function() {
+      var file = path.join(dir, 'foo');
+      fs.writeFileSync(file, '');
+      return io.exists(file).then(assert.ok);
+    });
+
+    it('does not return a rejected promise if file does not exist', function() {
+      return io.exists(path.join(dir, 'not-there')).then(function(exists) {
+        assert.ok(!exists);
+      });
+    });
+  });
+
+  describe('unlink', function() {
+    var dir;
+
+    before(function() {
+      return io.tmpDir().then(function(d) {
+        dir = d;
+      });
+    });
+
+    it('silently succeeds if the path does not exist', function() {
+      return io.unlink(path.join(dir, 'not-there'));
+    });
+
+    it('deletes files', function() {
+      var file = path.join(dir, 'foo');
+      fs.writeFileSync(file, '');
+      return io.exists(file).then(assert.ok).then(function() {
+        return io.unlink(file);
+      }).then(function() {
+        return io.exists(file);
+      }).then(function(exists) {
+        return assert.ok(!exists);
+      });
+    });
+  });
+
+  describe('rmDir', function() {
+    it('succeeds if the designated directory does not exist', function() {
+      return io.tmpDir().then(function(d) {
+        return io.rmDir(path.join(d, 'i/do/not/exist'));
+      });
+    });
+
+    it('deletes recursively', function() {
+      return io.tmpDir().then(function(dir) {
+        fs.writeFileSync(path.join(dir, 'file1'), 'hello');
+        fs.mkdirSync(path.join(dir, 'sub'));
+        fs.mkdirSync(path.join(dir, 'sub/folder'));
+        fs.writeFileSync(path.join(dir, 'sub/folder/file2'), 'goodbye');
+
+        return io.rmDir(dir).then(function() {
+          assert.ok(!fs.existsSync(dir));
+          assert.ok(!fs.existsSync(path.join(dir, 'sub/folder/file2')));
+        });
+      });
+    });
+  });
+});
diff --git a/test/logging_test.js b/test/logging_test.js
new file mode 100644
index 0000000..fb8cdb2
--- /dev/null
+++ b/test/logging_test.js
@@ -0,0 +1,167 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var Browser = require('..').Browser,
+    By = require('..').By,
+    logging = require('..').logging,
+    assert = require('../testing/assert'),
+    test = require('../lib/test');
+
+test.suite(function(env) {
+  // Logging API has numerous issues with PhantomJS:
+  //   - does not support adjusting log levels for type "browser".
+  //   - does not return proper log level for "browser" messages.
+  //   - does not delete logs after retrieval
+  // Logging API is not supported in IE.
+  // Tests depend on opening data URLs, which is broken in Safari (issue 7586)
+  test.ignore(env.browsers(Browser.PHANTOM_JS, Browser.IE, Browser.SAFARI)).
+  describe('logging', function() {
+    var driver;
+
+    test.beforeEach(function() {
+      driver = null;
+    });
+
+    test.afterEach(function() {
+      if (driver) {
+        driver.quit();
+      }
+    });
+
+    test.it('can be disabled', function() {
+      var prefs = new logging.Preferences();
+      prefs.setLevel(logging.Type.BROWSER, logging.Level.OFF);
+
+      driver = env.builder()
+          .setLoggingPrefs(prefs)
+          .build();
+
+      driver.get(dataUrl(
+          '<!DOCTYPE html><script>',
+          'console.info("hello");',
+          'console.warn("this is a warning");',
+          'console.error("and this is an error");',
+          '</script>'));
+      driver.manage().logs().get(logging.Type.BROWSER).then(function(entries) {
+        assert(entries.length).equalTo(0);
+      });
+    });
+
+    // Firefox does not capture JS error console log messages.
+    test.ignore(env.browsers(Browser.FIREFOX)).
+    it('can be turned down', function() {
+      var prefs = new logging.Preferences();
+      prefs.setLevel(logging.Type.BROWSER, logging.Level.SEVERE);
+
+      driver = env.builder()
+          .setLoggingPrefs(prefs)
+          .build();
+
+      driver.get(dataUrl(
+          '<!DOCTYPE html><script>',
+          'console.info("hello");',
+          'console.warn("this is a warning");',
+          'console.error("and this is an error");',
+          '</script>'));
+      driver.manage().logs().get(logging.Type.BROWSER).then(function(entries) {
+        assert(entries.length).equalTo(1);
+        assert(entries[0].level.name).equalTo('SEVERE');
+        assert(entries[0].message).endsWith('and this is an error');
+      });
+    });
+
+    // Firefox does not capture JS error console log messages.
+    test.ignore(env.browsers(Browser.FIREFOX)).
+    it('can be made verbose', function() {
+      var prefs = new logging.Preferences();
+      prefs.setLevel(logging.Type.BROWSER, logging.Level.DEBUG);
+
+      driver = env.builder()
+          .setLoggingPrefs(prefs)
+          .build();
+
+      driver.get(dataUrl(
+          '<!DOCTYPE html><script>',
+          'console.debug("hello");',
+          'console.warn("this is a warning");',
+          'console.error("and this is an error");',
+          '</script>'));
+      driver.manage().logs().get(logging.Type.BROWSER).then(function(entries) {
+        assert(entries.length).equalTo(3);
+        assert(entries[0].level.name).equalTo('DEBUG');
+        assert(entries[0].message).endsWith('hello');
+
+        assert(entries[1].level.name).equalTo('WARNING');
+        assert(entries[1].message).endsWith('this is a warning');
+
+        assert(entries[2].level.name).equalTo('SEVERE');
+        assert(entries[2].message).endsWith('and this is an error');
+      });
+    });
+
+    // Firefox does not capture JS error console log messages.
+    test.ignore(env.browsers(Browser.FIREFOX)).
+    it('clears records after retrieval', function() {
+      var prefs = new logging.Preferences();
+      prefs.setLevel(logging.Type.BROWSER, logging.Level.DEBUG);
+
+      driver = env.builder()
+          .setLoggingPrefs(prefs)
+          .build();
+
+      driver.get(dataUrl(
+          '<!DOCTYPE html><script>',
+          'console.debug("hello");',
+          'console.warn("this is a warning");',
+          'console.error("and this is an error");',
+          '</script>'));
+      driver.manage().logs().get(logging.Type.BROWSER).then(function(entries) {
+        assert(entries.length).equalTo(3);
+      });
+      driver.manage().logs().get(logging.Type.BROWSER).then(function(entries) {
+        assert(entries.length).equalTo(0);
+      });
+    });
+
+    test.it('does not mix log types', function() {
+      var prefs = new logging.Preferences();
+      prefs.setLevel(logging.Type.BROWSER, logging.Level.DEBUG);
+      prefs.setLevel(logging.Type.DRIVER, logging.Level.SEVERE);
+
+      driver = env.builder()
+          .setLoggingPrefs(prefs)
+          .build();
+
+      driver.get(dataUrl(
+          '<!DOCTYPE html><script>',
+          'console.debug("hello");',
+          'console.warn("this is a warning");',
+          'console.error("and this is an error");',
+          '</script>'));
+      driver.manage().logs().get(logging.Type.DRIVER).then(function(entries) {
+        assert(entries.length).equalTo(0);
+      });
+    });
+  });
+
+  function dataUrl(var_args) {
+    return 'data:text/html,'
+        + Array.prototype.slice.call(arguments, 0).join('');
+  }
+});
diff --git a/test/net/portprober_test.js b/test/net/portprober_test.js
index ae58cb6..03a2f7a 100644
--- a/test/net/portprober_test.js
+++ b/test/net/portprober_test.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
diff --git a/test/page_loading_test.js b/test/page_loading_test.js
index 812faae..df67d76 100644
--- a/test/page_loading_test.js
+++ b/test/page_loading_test.js
@@ -1,34 +1,42 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
-var By = require('..').By,
+var Browser = require('..').Browser,
+    By = require('..').By,
     ErrorCode = require('..').error.ErrorCode,
+    until = require('..').until,
     assert = require('../testing/assert'),
     test = require('../lib/test'),
-    Browser = test.Browser,
     Pages = test.Pages;
 
 
 test.suite(function(env) {
-  var browsers = env.browsers,
-      waitForTitleToBe = env.waitForTitleToBe;
+  var browsers = env.browsers;
 
   var driver;
-  beforeEach(function() { driver = env.driver; });
+  test.before(function() {
+    driver = env.builder().build();
+  });
+
+  test.after(function() {
+    driver.quit();
+  });
 
   test.it('should wait for document to be loaded', function() {
     driver.get(Pages.simpleTestPage);
@@ -41,8 +49,7 @@ test.suite(function(env) {
     assert(driver.getTitle()).equalTo('We Arrive Here');
   });
 
-  test.ignore(browsers(Browser.ANDROID)).it('should follow meta redirects',
-      function() {
+  test.it('should follow meta redirects', function() {
     driver.get(Pages.metaRedirectPage);
     assert(driver.getTitle()).equalTo('We Arrive Here');
   });
@@ -53,7 +60,7 @@ test.suite(function(env) {
     driver.findElement(By.id('id1'));
   });
 
-  test.ignore(browsers(Browser.ANDROID, Browser.IOS)).
+  test.ignore(browsers(Browser.IPAD, Browser.IPHONE)).
   it('should wait for all frames to load in a frameset', function() {
     driver.get(Pages.framesetPage);
     driver.switchTo().frame(0);
@@ -69,12 +76,12 @@ test.suite(function(env) {
     });
   });
 
-  test.ignore(browsers(Browser.ANDROID, Browser.SAFARI)).
+  test.ignore(browsers(Browser.SAFARI)).
   it('should be able to navigate back in browser history', function() {
     driver.get(Pages.formPage);
 
     driver.findElement(By.id('imageButton')).click();
-    waitForTitleToBe('We Arrive Here');
+    driver.wait(until.titleIs('We Arrive Here'), 5000);
 
     driver.navigate().back();
     assert(driver.getTitle()).equalTo('We Leave From Here');
@@ -85,27 +92,29 @@ test.suite(function(env) {
     driver.get(Pages.xhtmlTestPage);
 
     driver.findElement(By.name('sameWindow')).click();
-    waitForTitleToBe('This page has iframes');
+    driver.wait(until.titleIs('This page has iframes'), 5000);
 
     driver.navigate().back();
     assert(driver.getTitle()).equalTo('XHTML Test Page');
   });
 
-  test.ignore(browsers(Browser.ANDROID, Browser.SAFARI)).
+  test.ignore(browsers(Browser.SAFARI)).
   it('should be able to navigate forwards in browser history', function() {
     driver.get(Pages.formPage);
 
     driver.findElement(By.id('imageButton')).click();
-    waitForTitleToBe('We Arrive Here');
+    driver.wait(until.titleIs('We Arrive Here'), 5000);
 
     driver.navigate().back();
-    waitForTitleToBe('We Leave From Here');
+    driver.wait(until.titleIs('We Leave From Here'), 5000);
 
     driver.navigate().forward();
-    waitForTitleToBe('We Arrive Here');
+    driver.wait(until.titleIs('We Arrive Here'), 5000);
   });
 
-  test.it('should be able to refresh a page', function() {
+  // PhantomJS 2.0 does not properly reload pages on refresh.
+  test.ignore(browsers(Browser.PHANTOM_JS)).
+  it('should be able to refresh a page', function() {
     driver.get(Pages.xhtmlTestPage);
 
     driver.navigate().refresh();
@@ -123,12 +132,12 @@ test.suite(function(env) {
 
   // Only implemented in Firefox.
   test.ignore(browsers(
-      Browser.ANDROID,
       Browser.CHROME,
       Browser.IE,
-      Browser.IOS,
+      Browser.IPAD,
+      Browser.IPHONE,
       Browser.OPERA,
-      Browser.PHANTOMJS,
+      Browser.PHANTOM_JS,
       Browser.SAFARI)).
   it('should timeout if page load timeout is set', function() {
     driver.call(function() {
@@ -137,7 +146,12 @@ test.suite(function(env) {
           then(function() {
             throw Error('Should have timed out on page load');
           }, function(e) {
-            assert(e.code).equalTo(ErrorCode.SCRIPT_TIMEOUT);
+            // The FirefoxDriver returns TIMEOUT directly, where as the
+            // java server returns SCRIPT_TIMEOUT (bug?).
+            if (e.code !== ErrorCode.SCRIPT_TIMEOUT &&
+                e.code !== ErrorCode.TIMEOUT) {
+              throw Error('Unexpected error response: ' + e);
+            }
           });
     }).then(resetPageLoad, function(err) {
       resetPageLoad().thenFinally(function() {
diff --git a/test/phantomjs/execute_phantomjs_test.js b/test/phantomjs/execute_phantomjs_test.js
new file mode 100644
index 0000000..22a9a22
--- /dev/null
+++ b/test/phantomjs/execute_phantomjs_test.js
@@ -0,0 +1,73 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var assert = require('assert');
+var path = require('path');
+var test = require('../../lib/test');
+
+test.suite(function(env) {
+  var driver;
+
+  test.before(function() {
+    driver = env.builder().build();
+  });
+
+  test.after(function() {
+    driver.quit();
+  });
+
+  var testPageUrl =
+      'data:text/html,<html><h1>' + path.basename(__filename) + '</h1></html>';
+
+  test.beforeEach(function() {
+    driver.get(testPageUrl);
+  });
+
+  describe('phantomjs.Driver', function() {
+    describe('#executePhantomJS()', function() {
+
+      test.it('can execute scripts using PhantomJS API', function() {
+        return driver.executePhantomJS('return this.url;').then(function(url) {
+          assert.equal(testPageUrl, decodeURIComponent(url));
+        });
+      });
+
+      test.it('can execute scripts as functions', function() {
+        driver.executePhantomJS(function(a, b) {
+          return a + b;
+        }, 1, 2).then(function(result) {
+          assert.equal(3, result);
+        });
+      });
+
+      test.it('can manipulate the current page', function() {
+        driver.manage().addCookie('foo', 'bar');
+        driver.manage().getCookie('foo').then(function(cookie) {
+          assert.equal('bar', cookie.value);
+        });
+        driver.executePhantomJS(function() {
+          this.clearCookies();
+        });
+        driver.manage().getCookie('foo').then(function(cookie) {
+          assert.equal(null, cookie);
+        });
+      });
+    });
+  });
+}, {browsers: ['phantomjs']});
diff --git a/test/promise_aplus_test.js b/test/promise_aplus_test.js
new file mode 100644
index 0000000..1f59fdd
--- /dev/null
+++ b/test/promise_aplus_test.js
@@ -0,0 +1,83 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+describe('Promises/A+ Compliance Tests', function() {
+  var promise = require('../_base').require('webdriver.promise');
+
+  // The promise spec does not define behavior for unhandled rejections and
+  // assumes they are effectively swallowed. This is not the case with our
+  // implementation, so we have to disable error propagation to test that the
+  // rest of our behavior is compliant.
+  // We run the tests with a separate instance of the control flow to ensure
+  // disablign error propagation does not impact other tests.
+  var flow = new promise.ControlFlow();
+  flow.setPropagateUnhandledRejections(false);
+
+  function startsWith(str, prefix) {
+    return str.indexOf(prefix) === 0;
+  }
+
+  function endsWith(str, suffix) {
+    let len = str.length - suffix.length;
+    return len >= 0 && str.indexOf(suffix, len) === len;
+  }
+
+  // Skip the tests in 2.2.6.1/2. We are not compliant in these scenarios.
+  var realDescribe = global.describe;
+  global.describe = function(name, fn) {
+    realDescribe(name, function() {
+      var prefix = 'Promises/A+ Compliance Tests 2.2.6: '
+          + '`then` may be called multiple times on the same promise.';
+      var suffix = 'even when one handler is added inside another handler';
+      if (startsWith(this.fullTitle(), prefix)
+          && endsWith(this.fullTitle(), suffix)) {
+        var realSpecify = global.specify;
+        try {
+          global.specify = function(name) {
+            realSpecify(name);
+          };
+          fn();
+        } finally {
+          global.specify = realSpecify;
+        }
+      } else {
+        fn();
+      }
+    });
+  };
+
+  require('promises-aplus-tests').mocha({
+    resolved: function(value) {
+      return new promise.Promise((fulfill) => fulfill(value), flow);
+    },
+    rejected: function(error) {
+      return new promise.Promise((_, reject) => reject(error), flow);
+    },
+    deferred: function() {
+      var d = new promise.Deferred(flow);
+      return {
+        resolve: d.fulfill,
+        reject: d.reject,
+        promise: d.promise
+      };
+    }
+  });
+
+  global.describe = realDescribe;
+});
diff --git a/test/proxy_test.js b/test/proxy_test.js
index 89d66dd..b7a894f 100644
--- a/test/proxy_test.js
+++ b/test/proxy_test.js
@@ -1,35 +1,35 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
 var http = require('http'),
     url = require('url');
 
-var promise = require('..').promise,
+var Browser = require('..').Browser,
+    promise = require('..').promise,
     proxy = require('../proxy'),
     assert = require('../testing/assert'),
     test = require('../lib/test'),
     Server = require('../lib/test/httpserver').Server,
-    Browser = test.Browser,
     Pages = test.Pages;
 
 
 test.suite(function(env) {
-  env.autoCreateDriver = false;
-
   function writeResponse(res, body, encoding, contentType) {
     res.writeHead(200, {
       'Content-Length': Buffer.byteLength(body, encoding),
@@ -78,23 +78,35 @@ test.suite(function(env) {
     ].join(''), 'utf8', 'text/html; charset=UTF-8');
   });
 
-  test.before(proxyServer.start.bind(proxyServer));
-  test.before(helloServer.start.bind(helloServer));
-  test.before(goodbyeServer.start.bind(helloServer));
+  // Cannot pass start directly to mocha's before, as mocha will interpret the optional
+  // port parameter as an async callback parameter.
+  function mkStartFunc(server) {
+    return function() {
+      return server.start();
+    };
+  }
+
+
+  test.before(mkStartFunc(proxyServer));
+  test.before(mkStartFunc(helloServer));
+  test.before(mkStartFunc(goodbyeServer));
 
   test.after(proxyServer.stop.bind(proxyServer));
   test.after(helloServer.stop.bind(helloServer));
   test.after(goodbyeServer.stop.bind(goodbyeServer));
 
-  test.afterEach(env.dispose.bind(env));
+  var driver;
+  test.beforeEach(function() { driver = null; });
+  test.afterEach(function() { driver && driver.quit(); });
 
-  test.ignore(env.browsers(Browser.SAFARI)).  // Proxy support not implemented.
+  // Proxy support not implemented.
+  test.ignore(env.browsers(Browser.IE, Browser.OPERA, Browser.SAFARI)).
   describe('manual proxy settings', function() {
     // phantomjs 1.9.1 in webdriver mode does not appear to respect proxy
     // settings.
-    test.ignore(env.browsers(Browser.PHANTOMJS)).
+    test.ignore(env.browsers(Browser.PHANTOM_JS)).
     it('can configure HTTP proxy host', function() {
-      var driver = env.builder().
+      driver = env.builder().
           setProxy(proxy.manual({
             http: proxyServer.host()
           })).
@@ -107,9 +119,9 @@ test.suite(function(env) {
     });
 
     // PhantomJS does not support bypassing the proxy for individual hosts.
-    test.ignore(env.browsers(Browser.PHANTOMJS)).
+    test.ignore(env.browsers(Browser.PHANTOM_JS)).
     it('can bypass proxy for specific hosts', function() {
-      var driver = env.builder().
+      driver = env.builder().
           setProxy(proxy.manual({
             http: proxyServer.host(),
             bypass: helloServer.host()
@@ -132,10 +144,11 @@ test.suite(function(env) {
 
   // PhantomJS does not support PAC file proxy configuration.
   // Safari does not support proxies.
-  test.ignore(env.browsers(Browser.PHANTOMJS, Browser.SAFARI)).
+  test.ignore(env.browsers(
+      Browser.IE, Browser.OPERA, Browser.PHANTOM_JS, Browser.SAFARI)).
   describe('pac proxy settings', function() {
     test.it('can configure proxy through PAC file', function() {
-      var driver = env.builder().
+      driver = env.builder().
           setProxy(proxy.pac(proxyServer.url('/proxy.pac'))).
           build();
 
diff --git a/test/remote_test.js b/test/remote_test.js
new file mode 100644
index 0000000..c103d81
--- /dev/null
+++ b/test/remote_test.js
@@ -0,0 +1,72 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+var assert = require('assert');
+
+var promise = require('../').promise;
+var remote = require('../remote');
+
+describe('DriverService', function() {
+  describe('start()', function() {
+    var service;
+
+    beforeEach(function() {
+      service = new remote.DriverService(process.execPath, {
+        port: 1234,
+        args: ['-e', 'process.exit(1)']
+      });
+    });
+
+    afterEach(function(done) {
+      service.kill().thenFinally(function() {
+        done();
+      });
+    });
+
+    it('fails if child-process dies', function(done) {
+      this.timeout(1000);
+      service.start(500)
+      .then(expectFailure.bind(null, done), verifyFailure.bind(null, done));
+    });
+
+    it('failures propagate through control flow if child-process dies',
+      function(done) {
+        this.timeout(1000);
+
+        promise.controlFlow().execute(function() {
+          promise.controlFlow().execute(function() {
+            return service.start(500);
+          });
+        })
+        .then(expectFailure.bind(null, done), verifyFailure.bind(null, done));
+      });
+
+    function verifyFailure(done, e) {
+      try {
+        assert.ok(!(e instanceof promise.CancellationError));
+        assert.equal('Server terminated early with status 1', e.message);
+        done();
+      } catch (ex) {
+        done(ex);
+      }
+    }
+
+    function expectFailure(done) {
+      done(Error('expected to fail'));
+    }
+  });
+});
diff --git a/test/stale_element_test.js b/test/stale_element_test.js
index 81dacc7..5a9fa6f 100644
--- a/test/stale_element_test.js
+++ b/test/stale_element_test.js
@@ -1,33 +1,37 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
 var fail = require('assert').fail;
 
-var By = require('..').By,
+var Browser = require('..').Browser,
+    By = require('..').By,
     error = require('..').error,
+    until = require('..').until,
     assert = require('../testing/assert'),
     test = require('../lib/test'),
-    Browser = test.Browser,
     Pages = test.Pages;
 
 
 test.suite(function(env) {
   var driver;
-  beforeEach(function() { driver = env.driver; });
+  test.before(function() { driver = env.builder().build(); });
+  test.after(function() { driver.quit(); });
 
   test.it(
       'dynamically removing elements from the DOM trigger a ' +
@@ -39,16 +43,7 @@ test.suite(function(env) {
         assert(toBeDeleted.isDisplayed()).isTrue();
 
         driver.findElement(By.id('delete')).click();
-        driver.wait(function() {
-          return toBeDeleted.isDisplayed().
-              then(function() { return false; }).
-              then(null, function(e) {
-                if (e.code === error.ErrorCode.STALE_ELEMENT_REFERENCE) {
-                  return true;
-                }
-                throw e;
-              });
-       }, 5000, 'Element should be stale at this point');
+        driver.wait(until.stalenessOf(toBeDeleted), 5000);
       });
 
   test.it('an element found in a different frame is stale', function() {
diff --git a/test/tag_name_test.js b/test/tag_name_test.js
index c4f1672..d5e18a9 100644
--- a/test/tag_name_test.js
+++ b/test/tag_name_test.js
@@ -1,17 +1,19 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
@@ -21,9 +23,12 @@ var By = require('..').By,
 
 
 test.suite(function(env) {
+  var driver;
+  test.after(function() { driver.quit(); });
+
   test.it('should return lower case tag name', function() {
-    env.driver.get(test.Pages.formPage);
-    assert(env.driver.findElement(By.id('cheese')).getTagName()).
-        equalTo('input');
+    driver = env.builder().build();
+    driver.get(test.Pages.formPage);
+    assert(driver.findElement(By.id('cheese')).getTagName()).equalTo('input');
   });
 });
diff --git a/test/testing/index_test.js b/test/testing/index_test.js
index bcd1d69..7a4b265 100644
--- a/test/testing/index_test.js
+++ b/test/testing/index_test.js
@@ -1,21 +1,24 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
 var assert = require('assert');
+var promise = require('../..').promise;
 
 var test = require('../../testing');
 
@@ -38,4 +41,140 @@ describe('Mocha Integration', function() {
     test.it('', function() { this.x = 2; });
     afterEach(function() { assert.equal(this.x, 2); });
   });
+
+  describe('timeout handling', function() {
+    describe('it does not reset the control flow on a non-timeout', function() {
+      var flowReset = false;
+
+      beforeEach(function() {
+        flowReset = false;
+        promise.controlFlow().once(
+            promise.ControlFlow.EventType.RESET, onreset);
+      });
+
+      test.it('', function() {
+        this.timeout(100);
+        return promise.delayed(50);
+      });
+
+      afterEach(function() {
+        assert.ok(!flowReset);
+        promise.controlFlow().removeListener(
+            promise.ControlFlow.EventType.RESET, onreset);
+      });
+
+      function onreset() {
+        flowReset = true;
+      }
+    });
+
+    describe('it resets the control flow after a timeout' ,function() {
+      var timeoutErr, flowReset;
+
+      beforeEach(function() {
+        flowReset = false;
+        promise.controlFlow().once(
+            promise.ControlFlow.EventType.RESET, onreset);
+      });
+
+      test.it('', function() {
+        var callback = this.runnable().callback;
+        var test = this;
+        this.runnable().callback = function(err) {
+          timeoutErr = err;
+          // Reset our timeout to 0 so Mocha does not fail the test.
+          test.timeout(0);
+          // When we invoke the real callback, do not pass along the error so
+          // Mocha does not fail the test.
+          return callback.call(this);
+        };
+
+        test.timeout(50);
+        return promise.defer().promise;
+      });
+
+      afterEach(function() {
+        promise.controlFlow().removeListener(
+            promise.ControlFlow.EventType.RESET, onreset);
+        assert.ok(flowReset, 'control flow was not reset after a timeout');
+      });
+
+      function onreset() {
+        flowReset = true;
+      }
+    });
+  });
+});
+
+describe('Mocha async "done" support', function() {
+   this.timeout(2*1000);
+
+   var waited = false;
+   var DELAY = 100; // ms enough to notice
+
+   // Each test asynchronously sets waited to true, so clear/check waited
+   // before/after:
+   beforeEach(function() {
+      waited = false;
+   });
+
+   afterEach(function() {
+      assert.strictEqual(waited, true);
+   });
+
+   // --- First, vanilla mocha "it" should support the "done" callback correctly.
+
+   // This 'it' should block until 'done' is invoked
+   it('vanilla delayed', function(done) {
+      setTimeout(function delayedVanillaTimeout() {
+         waited = true;
+         done();
+      }, DELAY);
+   });
+
+   // --- Now with the webdriver wrappers for 'it' should support the "done" callback:
+
+   test.it('delayed', function(done) {
+      assert(done);
+      assert.strictEqual(typeof done, 'function');
+      //console.log(done.name);
+      //console.log(done.toString());
+      setTimeout(function delayedTimeoutCallback() {
+         waited = true;
+         done();
+      }, DELAY);
+   });
+
+   // --- And test that the webdriver wrapper for 'it' works with a returned promise, too:
+
+   test.it('delayed by promise', function() {
+      var defer = promise.defer();
+      setTimeout(function delayedPromiseCallback() {
+         waited = true;
+         defer.fulfill('ignored');
+      });
+      return defer.promise;
+   });
+
+});
+
+describe('ControlFlow and "done" work together', function() {
+   var flow, order;
+   before(function() {
+      order = [];
+      flow = promise.controlFlow();
+      flow.execute(function() { order.push(1); });
+   });
+
+   test.it('control flow updates and async done', function(done) {
+      flow.execute(function() { order.push(2); });
+      flow.execute(function() { order.push(3); }).then(function() {
+         order.push(4);
+      });
+      done();
+   })
+
+   after(function() {
+      assert.deepEqual([1, 2, 3, 4], order);
+   })
 });
diff --git a/test/upload_test.js b/test/upload_test.js
new file mode 100644
index 0000000..f7fd907
--- /dev/null
+++ b/test/upload_test.js
@@ -0,0 +1,85 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+'use strict';
+
+var fs = require('fs');
+
+var Browser = require('..').Browser,
+    By = require('..').By,
+    until = require('..').until,
+    io = require('../io'),
+    remote = require('../remote'),
+    assert = require('../testing/assert'),
+    test = require('../lib/test'),
+    Pages = test.Pages;
+
+test.suite(function(env) {
+  var LOREM_IPSUM_TEXT = 'lorem ipsum dolor sit amet';
+  var FILE_HTML = '<!DOCTYPE html><div>' + LOREM_IPSUM_TEXT + '</div>';
+
+  var fp;
+  test.before(function() {
+    return fp = io.tmpFile().then(function(fp) {
+      fs.writeFileSync(fp, FILE_HTML);
+      return fp;
+    });
+  })
+
+  var driver;
+  test.before(function() {
+    driver = env.builder().build();
+  });
+
+  test.after(function() {
+    if (driver) {
+      driver.quit();
+    }
+  });
+
+  test.ignore(env.browsers(
+      Browser.IPAD,
+      Browser.IPHONE,
+      // Uploads broken in PhantomJS 2.0.
+      // See https://github.com/ariya/phantomjs/issues/12506
+      Browser.PHANTOM_JS,
+      Browser.SAFARI)).
+  it('can upload files', function() {
+    driver.setFileDetector(new remote.FileDetector);
+
+    driver.get(Pages.uploadPage);
+
+    var fp = driver.call(function() {
+      return io.tmpFile().then(function(fp) {
+        fs.writeFileSync(fp, FILE_HTML);
+        return fp;
+      });
+    });
+
+    driver.findElement(By.id('upload')).sendKeys(fp);
+    driver.findElement(By.id('go')).submit();
+
+    // Uploading files across a network may take a while, even if they're small.
+    var label = driver.findElement(By.id('upload_label'));
+    driver.wait(until.elementIsNotVisible(label),
+        10 * 1000, 'File took longer than 10 seconds to upload!');
+
+    driver.switchTo().frame('upload_target');
+    assert(driver.findElement(By.css('body')).getText())
+        .equalTo(LOREM_IPSUM_TEXT);
+  });
+});
diff --git a/test/window_test.js b/test/window_test.js
index 2abd10e..959c9dc 100644
--- a/test/window_test.js
+++ b/test/window_test.js
@@ -1,29 +1,34 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 'use strict';
 
-var assert = require('../testing/assert'),
-    test = require('../lib/test'),
-    Browser = test.Browser;
+var Browser = require('..').Browser,
+    assert = require('../testing/assert'),
+    test = require('../lib/test');
 
 
 test.suite(function(env) {
   var driver;
-  beforeEach(function() {
-    driver = env.driver;
+
+  test.before(function() { driver = env.builder().build(); });
+  test.after(function() { driver.quit(); });
+
+  test.beforeEach(function() {
     driver.switchTo().defaultContent();
   });
 
@@ -49,13 +54,20 @@ test.suite(function(env) {
       driver.manage().window().setPosition(position.x + 10, position.y + 10);
 
       // For phantomjs, setPosition is a no-op and the "window" stays at (0, 0)
-      if (env.browser === Browser.PHANTOMJS) {
+      if (env.currentBrowser() === Browser.PHANTOM_JS) {
         driver.manage().window().getPosition().then(function(position) {
           assert(position.x).equalTo(0);
           assert(position.y).equalTo(0);
         });
       } else {
-        driver.wait(forPositionToBe(position.x + 10, position.y + 10), 1000);
+        var dx = position.x + 10;
+        var dy = position.y + 10;
+        // On OSX, Safari position's the window relative to below the menubar
+        // at the top of the screen, which is 23 pixels tall.
+        if (env.currentBrowser() === Browser.SAFARI &&
+            process.platform === 'darwin') {
+          dy += 23;
+        }
       }
     });
   });
@@ -68,13 +80,21 @@ test.suite(function(env) {
       driver.manage().window().setPosition(position.x + 10, position.y + 10);
 
       // For phantomjs, setPosition is a no-op and the "window" stays at (0, 0)
-      if (env.browser === Browser.PHANTOMJS) {
+      if (env.currentBrowser() === Browser.PHANTOM_JS) {
         driver.manage().window().getPosition().then(function(position) {
           assert(position.x).equalTo(0);
           assert(position.y).equalTo(0);
         });
       } else {
-        driver.wait(forPositionToBe(position.x + 10, position.y + 10), 1000);
+        var dx = position.x + 10;
+        var dy = position.y + 10;
+        // On OSX, Safari position's the window relative to below the menubar
+        // at the top of the screen, which is 23 pixels tall.
+        if (env.currentBrowser() === Browser.SAFARI &&
+            process.platform === 'darwin') {
+          dy += 23;
+        }
+        driver.wait(forPositionToBe(dx, dy), 1000);
       }
     });
   });
@@ -83,7 +103,7 @@ test.suite(function(env) {
     driver.manage().window().getSize().then(function(size) {
       driver.manage().window().setSize(size.width + dx, size.height + dy);
       driver.wait(forSizeToBe(size.width + dx, size.height + dy), 1000);
-    })
+    });
   }
 
   function forSizeToBe(w, h) {
@@ -100,7 +120,8 @@ test.suite(function(env) {
         return position.x === x &&
             // On OSX, the window height may be bumped down 22px for the top
             // status bar.
-           (position.y >= y && position.y <= (y + 22));
+            // On Linux, Opera's window position will be off by 28px.
+           (position.y >= y && position.y <= (y + 28));
       });
     };
   }
diff --git a/testing/assert.js b/testing/assert.js
index 80fcda3..a4d729b 100644
--- a/testing/assert.js
+++ b/testing/assert.js
@@ -1,35 +1,35 @@
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Defines a library that simplifies writing assertions against
  * promised values.
  *
- * <blockquote>
- * <hr>
- * <b>NOTE:</b> This module is considered experimental and is subject to
- * change, or removal, at any time!
- * <hr>
- * </blockquote>
+ * > <hr>
+ * > __NOTE:__ This module is considered experimental and is subject to
+ * > change, or removal, at any time!
+ * > <hr>
  *
  * Sample usage:
- * <pre><code>
- * var driver = new webdriver.Builder().build();
- * driver.get('http://www.google.com');
  *
- * assert(driver.getTitle()).equalTo('Google');
- * </code></pre>
+ *     var driver = new webdriver.Builder().build();
+ *     driver.get('http://www.google.com');
+ *
+ *     assert(driver.getTitle()).equalTo('Google');
  */
 
 var base = require('../_base'),
@@ -39,5 +39,23 @@ var base = require('../_base'),
 // PUBLIC API
 
 
-/** @type {webdriver.testing.assert.} */
-module.exports = assert;
+/**
+ * Creates a new assertion.
+ * @param {*} value The value to perform an assertion on.
+ * @return {!webdriver.testing.Assertion} The new assertion.
+ */
+module.exports = function(value) {
+  return assert(value);
+};
+
+
+/**
+ * Registers a new assertion to expose from the
+ * {@link webdriver.testing.Assertion} prototype.
+ * @param {string} name The assertion name.
+ * @param {(function(new: goog.labs.testing.Matcher, *)|
+ *          {matches: function(*): boolean,
+ *           describe: function(): string})} matcherTemplate Either the
+ *     matcher constructor to use, or an object literal defining a matcher.
+ */
+module.exports.register = assert.register;
diff --git a/testing/index.js b/testing/index.js
index 12ac341..2a1c4cf 100644
--- a/testing/index.js
+++ b/testing/index.js
@@ -1,85 +1,73 @@
-// Copyright 2013 Selenium committers
-// Copyright 2013 Software Freedom Conservancy
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
 //
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-//     You may obtain a copy of the License at
+//   http://www.apache.org/licenses/LICENSE-2.0
 //
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
 
 /**
  * @fileoverview Provides wrappers around the following global functions from
- * <a href="http://visionmedia.github.io/mocha/">Mocha's BDD interface</a>:
- * <ul>
- *   <li>after
- *   <li>afterEach
- *   <li>before
- *   <li>beforeEach
- *   <li>it
- *   <li>it.only
- *   <li>it.skip
- *   <li>xit
- * </ul>
+ * [Mocha's BDD interface](https://github.com/mochajs/mocha):
  *
- * <p>The provided wrappers leverage the webdriver.promise.ControlFlow to
- * simplify writing asynchronous tests:
- * <pre><code>
- * var webdriver = require('selenium-webdriver'),
- *     remote = require('selenium-webdriver/remote'),
- *     test = require('selenium-webdriver/testing');
+ * - after
+ * - afterEach
+ * - before
+ * - beforeEach
+ * - it
+ * - it.only
+ * - it.skip
+ * - xit
  *
- * test.describe('Google Search', function() {
- *   var driver, server;
+ * The provided wrappers leverage the {@link webdriver.promise.ControlFlow}
+ * to simplify writing asynchronous tests:
  *
- *   test.before(function() {
- *     server = new remote.SeleniumServer({
- *       jar: 'path/to/selenium-server-standalone.jar'
- *     });
- *     server.start();
+ *     var By = require('selenium-webdriver').By,
+ *         until = require('selenium-webdriver').until,
+ *         firefox = require('selenium-webdriver/firefox'),
+ *         test = require('selenium-webdriver/testing');
  *
- *     driver = new webdriver.Builder().
- *         withCapabilities({'browserName': 'firefox'}).
- *         usingServer(server.address()).
- *         build();
- *   });
+ *     test.describe('Google Search', function() {
+ *       var driver;
  *
- *   test.after(function() {
- *     driver.quit();
- *     server.stop();
- *   });
+ *       test.before(function() {
+ *         driver = new firefox.Driver();
+ *       });
  *
- *   test.it('should append query to title', function() {
- *     driver.get('http://www.google.com');
- *     driver.findElement(webdriver.By.name('q')).sendKeys('webdriver');
- *     driver.findElement(webdriver.By.name('btnG')).click();
- *     driver.wait(function() {
- *       return driver.getTitle().then(function(title) {
- *         return 'webdriver - Google Search' === title;
+ *       test.after(function() {
+ *         driver.quit();
  *       });
- *     }, 1000, 'Waiting for title to update');
- *   });
- * });
- * </code></pre>
  *
- * <p>You may conditionally suppress a test function using the exported
+ *       test.it('should append query to title', function() {
+ *         driver.get('http://www.google.com/ncr');
+ *         driver.findElement(By.name('q')).sendKeys('webdriver');
+ *         driver.findElement(By.name('btnG')).click();
+ *         driver.wait(until.titleIs('webdriver - Google Search'), 1000);
+ *       });
+ *     });
+ *
+ * You may conditionally suppress a test function using the exported
  * "ignore" function. If the provided predicate returns true, the attached
  * test case will be skipped:
- * <pre><code>
- *   test.ignore(maybe()).it('is flaky', function() {
- *     if (Math.random() < 0.5) throw Error();
- *   });
  *
- *   function maybe() { return Math.random() < 0.5; }
- * </code></pre>
+ *     test.ignore(maybe()).it('is flaky', function() {
+ *       if (Math.random() < 0.5) throw Error();
+ *     });
+ *
+ *     function maybe() { return Math.random() < 0.5; }
  */
 
-var flow = require('..').promise.controlFlow();
+var promise = require('..').promise;
+var flow = promise.controlFlow();
 
 
 /**
@@ -103,32 +91,67 @@ function seal(fn) {
  */
 function wrapped(globalFn) {
   return function() {
-    switch (arguments.length) {
-      case 1:
-        globalFn(asyncTestFn(arguments[0]));
-        break;
-
-      case 2:
-        globalFn(arguments[0], asyncTestFn(arguments[1]));
-        break;
-
-      default:
-        throw Error('Invalid # arguments: ' + arguments.length);
+    if (arguments.length === 1) {
+      return globalFn(makeAsyncTestFn(arguments[0]));
+    }
+    else if (arguments.length === 2) {
+      return globalFn(arguments[0], makeAsyncTestFn(arguments[1]));
+    }
+    else {
+      throw Error('Invalid # arguments: ' + arguments.length);
     }
   };
+}
 
-  function asyncTestFn(fn) {
-    return function(done) {
-      this.timeout(0);
-      var timeout = this.timeout;
-      this.timeout = undefined;  // Do not let tests change the timeout.
-      try {
-        flow.execute(fn.bind(this)).then(seal(done), done);
-      } finally {
-        this.timeout = timeout;
-      }
+/**
+ * Make a wrapper to invoke caller's test function, fn.  Run the test function
+ * within a ControlFlow.
+ *
+ * Should preserve the semantics of Mocha's Runnable.prototype.run (See
+ * https://github.com/mochajs/mocha/blob/master/lib/runnable.js#L192)
+ *
+ * @param {Function} fn
+ * @return {Function}
+ */
+function makeAsyncTestFn(fn) {
+  var async = fn.length > 0; // if test function expects a callback, its "async"
+
+  var ret = function(done) {
+    var runnable = this.runnable();
+    var mochaCallback = runnable.callback;
+    runnable.callback = function() {
+      flow.reset();
+      return mochaCallback.apply(this, arguments);
     };
-  }
+
+    var testFn = fn.bind(this);
+    flow.execute(function controlFlowExecute() {
+      return new promise.Promise(function(fulfill, reject) {
+        if (async) {
+          // If testFn is async (it expects a done callback), resolve the promise of this
+          // test whenever that callback says to.  Any promises returned from testFn are
+          // ignored.
+          testFn(function testFnDoneCallback(err) {
+            if (err) {
+              reject(err);
+            } else {
+              fulfill();
+            }
+          });
+        } else {
+          // Without a callback, testFn can return a promise, or it will
+          // be assumed to have completed synchronously
+          fulfill(testFn());
+        }
+      }, flow);
+    }, runnable.fullTitle()).then(seal(done), done);
+  };
+
+  ret.toString = function() {
+    return fn.toString();
+  };
+
+  return ret;
 }